Skip to content

Roadmap: 1.0 product readiness (preserve existing 1.3.x version lineage) #22

Closed

Description

@jacobyoby

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)

Phase 2 — Trustworthy diagrams and tests (release blockers)

Phase 3 — Installation and release evidence (release blockers)

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

  1. added this to the 1.0 milestone on Sep 8, 2026
  2. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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):

    Non-blocking follow-up:

    All of the above are now on the 1.0 milestone alongside the roadmap issues.

  3. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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.

  4. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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:

    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.

  5. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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 --check passed; runtime CI awaits the stacked branch sequence.

  6. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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 --check passed; four GitHub Actions checks are pending.

  7. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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 --check passed; GitHub Actions is pending.

  8. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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 --check passed; CI is pending. Interactive hover verification remains explicitly unverified and required before merge.

  9. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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 --check passed; runtime CI and interactive draw.io inspection remain pending.

  10. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    Roadmap progress: #20 is implemented in independent PR #49. The parser now accepts only typed address values, emits provisional L2-SNMP-Heuristic confidence, 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.

  11. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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.

  12. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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 --check passed, with only historical changelog references remaining.

  13. jacobyoby commented on Sep 8, 2026

    @jacobyoby
    OwnerAuthor

    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.

  14. jacobyoby commented on Sep 9, 2026

    @jacobyoby
    OwnerAuthor

    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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions