Repository navigation
Description
Goal and version policy
Deliver a dependable IPv4 inventory-to-draw.io workflow, bounded discovery, honest topology confidence, and a reproducible installation/release process. “1.0” denotes product readiness requested by the maintainer: the current manifest is already 1.3.0. Choose the next compatible semantic version during release preparation; never renumber backwards.
Reviewed source: 4a027ff72eda979b4ce62a798671aaa1cdc80e43. Static review of module, wizard, tests, manifest, and CI. The latest five existing GitHub CI runs passed, but PowerShell is unavailable locally and new runtime tests were not run. This is a roadmap, not release certification.
Phase 1 — Correctness and bounded discovery (release blockers)
- Wizard overwrites the diagram with the inventory JSON when -OutputPath does not end in .drawio #9 Prevent inventory output from overwriting the diagram.
- P1: Select the scan interface from the default route and allow explicit selection #15 Select a coherent interface, subnet, and gateway.
- P1: Bound reverse DNS work in the discovery wizard #16 Bound wizard DNS resolution.
- P1: Resolve SNMP credential maps by longest matching prefix before Default #17 Make SNMP credential selection deterministic.
- P1: Validate inventory addresses and declare the supported network model #18 Validate inventories and state the IPv4 contract.
Phase 2 — Trustworthy diagrams and tests (release blockers)
- Emit draw.io tooltips and preserve tri-state reachability in text and styling #10 Emit real tooltips and consistent tri-state status.
- P1: Size diagram containers to fit their nodes and verify rendered output #19 Fit diagram layout to inventory size.
- P1: Keep heuristic SNMP links distinct from verified physical topology #20 Distinguish heuristic links from verified neighbors.
- No functional tests for Get-LocalARPTable or Invoke-PortScan, and Get-LocalARPTable swallows every error #13 Exercise ARP parsing and real loopback port scanning, with observable failures.
Phase 3 — Installation and release evidence (release blockers)
- P1: Add a reproducible release-candidate workflow and packaged-module smoke tests #21 Pass packaged-module smoke tests and record release-candidate evidence; depends on phases 1 and 2.
- Tag releases v1.1.0 through v1.3.0 and stop calling the Gallery listing unpublished #11 Reconcile published versions, source provenance, and installation instructions. Verify Gallery package/source correspondence before creating historical tags; a version-bump commit alone is insufficient evidence of package contents.
- Fold WHERE-TO-SAVE-FILES.txt into README and fix the two stale layout trees #12 Consolidate and verify documentation.
Follow-up enrichment
- Get-MACVendor ships a 31-prefix OUI table but documents a built-in OUI database #14 Expand optional OUI data and join MAC/vendor information into discovery. A full registry is not a release blocker if the bundled sample limitation and Unknown results are clearly documented before release.
- Defer IPv6 discovery, complete LLDP/CDP table decoding, and SNMPv3 implementation; describe the supported subset and limitations accurately. Avoid expanding scope into a GUI or continuous monitoring for this milestone.
Exit gate
All blocker issues closed with acceptance evidence, three-OS checks green for the candidate, clean isolated package installation succeeds, and representative diagrams verified in draw.io. Record source commit and package hash in the release record. Issue creation authorizes planning only; no package publication or tag changes performed by this review.
Start with #9, followed by #15 and #16. Estimates should be added by implementers after choosing test seams; do not treat this list as a delivery-date promise.
Activity
jacobyoby commentedon Sep 8, 2026
Cross-referencing a second review pass filed at 08:15 before this roadmap was noticed. Three of its issues duplicated roadmap items and have been closed: #25 and #26 into #18, #29 into #21 (two unique points from #29 preserved as a comment there).
Four survive and are not yet placed in a phase:
Phase 1 or 2 candidates (correctness):
$false. This is the data-model prerequisite for Emit draw.io tooltips and preserve tri-state reachability in text and styling #10's tri-state rendering.Non-blocking follow-up:
#nvalues now collide with real issues in this tracker.All of the above are now on the 1.0 milestone alongside the roadmap issues.
jacobyoby commentedon Sep 8, 2026
Roadmap progress: #9 is implemented in PR #23; all three Pester jobs and PSScriptAnalyzer passed. #15 is implemented in stacked PR #33, based on PR #23 to keep the overlapping wizard-test insertion focused. PR #33 will receive normal main-target CI after #23 lands and its base is retargeted. Neither PR has been merged.
jacobyoby commentedon Sep 8, 2026
A competitive review against the maintained landscape (NetDisco, LibreNMS, NetBox, Scanopy, Auvik, Domotz, Lansweeper, Device42, nmap, drawthe.net) produced eight more issues, split by whether they block product readiness.
Added to the 1.0 milestone, because they are defects in documented behaviour rather than new scope:
Compare-NetworkScansworkflow truncates its own input. README tells users to pipe throughConvertTo-Jsonwith no-Depth, so Nodes and Edges serialise as type names. The module already uses-Depth 10elsewhere. The diff feature has never worked through its documented path.Install-Module NetDiagram-PStherefore yields primitives and no scanner. This overlaps P1: Add a reproducible release-candidate workflow and packaged-module smoke tests #21's "installation-compatible wizard entry point or clearly document its separate source requirement" and the two branches are mutually exclusive, so P1: Add a reproducible release-candidate workflow and packaged-module smoke tests #21 should settle which one before either starts.Deferred to a new Interop milestone, post-1.0: #36 nmap XML as an inventory source, #37 Mermaid export, #38 NetBox bulk-import CSV, #39 BRIDGE-MIB forwarding tables for layer 2 edges where LLDP and CDP are silent, #40 IPv6 throughout, #41 node inventory CSV. #40 matches this roadmap's existing decision to defer IPv6.
Landscape finding worth recording. The "zero-infrastructure scan to an editable draw.io file" position is occupied but abandoned: nmapper (Python, 5 commits, unlicensed) and PsDrawIO (14,353 Gallery downloads, last shipped May 2021, PowerShell 5) both did it. Every maintained rival needs a server plus database or a paid collector, and none emits native .drawio. The unclaimed position is therefore "maintained, cross-platform, interoperable", which is what the Interop milestone targets.
Explicit non-goals from the same review, recorded so they can be declined quickly: no daemon, database or polling loop, no monitoring or live map, no web UI, no CMDB, no OS fingerprinting, no credentialed SSH or WMI enrichment. LibreNMS, Scanopy, NetBox, nmap and Faddom each win those decisively.
jacobyoby commentedon Sep 8, 2026
Roadmap progress: #16 is implemented in stacked PR #42 on #33. It routes wizard reverse DNS through the bounded async resolver, preserves fallback hostnames, and adds deterministic timeout/fault tests without public DNS. Local
git diff --checkpassed; runtime CI awaits the stacked branch sequence.jacobyoby commentedon Sep 8, 2026
Roadmap progress: #17 is implemented in independent PR #45. Credential selection now validates IPv4 CIDRs, uses longest-prefix matching, reserves Default for unmatched addresses, documents missing-secret behavior, and includes six deterministic precedence/validation tests.
git diff --checkpassed; four GitHub Actions checks are pending.jacobyoby commentedon Sep 8, 2026
Roadmap progress: #18 is implemented in independent PR #46. Import now enforces documented IPv4-only collection and entry shapes, rejects duplicate device addresses, normalizes CIDR host bits, preserves valid empty inventories, and reports indexed errors. Seven offline fixture tests were added.
git diff --checkpassed; GitHub Actions is pending.jacobyoby commentedon Sep 8, 2026
Roadmap progress: #10 is implemented in independent PR #47 using draw.io UserObject metadata with preserved node/edge IDs and consistent Reachable, Unreachable, and Unknown styling. XML regression coverage includes untested routers and switches.
git diff --checkpassed; CI is pending. Interactive hover verification remains explicitly unverified and required before merge.jacobyoby commentedon Sep 8, 2026
Roadmap progress: #19 is implemented in independent PR #48. Containers now size from child counts, later rows start below the tallest prior row, and unmatched nodes start below the actual container grid. Tests cover 0, 1, 16, 17, and 50 nodes plus multi-subnet and unmatched-node non-overlap.
git diff --checkpassed; runtime CI and interactive draw.io inspection remain pending.jacobyoby commentedon Sep 8, 2026
Roadmap progress: #20 is implemented in independent PR #49. The parser now accepts only typed address values, emits provisional
L2-SNMP-Heuristicconfidence, keeps verified links distinct during merging, and renders hints as dashed amber. Offline tests cover distractor strings, typed/hex addresses, self/unknown/malformed values, merge confidence, and exported styling. CI is pending.jacobyoby commentedon Sep 8, 2026
Roadmap progress: #13 is implemented in independent PR #50. ARP parsing is now pure and fixture-tested for macOS and Linux; missing tools, command failures, and recognized malformed lines terminate clearly. A mock-free loopback TcpListener test covers open/closed ports and banner capture. CI is pending.
jacobyoby commentedon Sep 8, 2026
Roadmap progress: #12 is implemented in docs-only PR #51. README now contains the single tracked-file layout and cross-platform workspace/data-handling guidance; AGENTS.md points to it; duplicate STRUCTURE.md and WHERE-TO-SAVE-FILES.txt are removed.
git diff --checkpassed, with only historical changelog references remaining.jacobyoby commentedon Sep 8, 2026
Roadmap maintenance: #23 merged. Closed stacked PR #33 could not be reopened, so #15 is now current-main PR #52. The #16 branch was rebased on that updated #15 branch; existing PR #42 remains the focused DNS follow-up. No roadmap code was merged by this loop.
jacobyoby commentedon Sep 9, 2026
All 12 P1 blockers closed with evidence on ca52296: #9 wizard path, #15 interface, #16 DNS, #17 cred precedence, #18 IPv4, #10 tooltips, #19 layout, #20 heuristic, #13 ARP, #21 smoke (3-OS 102 tests), #11 Gallery/tags, #12 docs. Plus extra #27 overwrite guard and #34 topology persistence. CI 34305289412 green (102 Pester + smoke + lint). Exit gate met — clean isolated install and offline fixtures verified.