Skip to content

Build local-first AttackPath Visualizer foundation - #1

Merged
unalivin merged 43 commits into
mainfrom
arena/65bc6e5a-attackpath-visualizer
Nov 1, 2026
Merged

unalivin merged 43 commits into
mainfrom
arena/65bc6e5a-attackpath-visualizer

Conversation

@unalivin

@unalivin unalivin commented Oct 31, 2026 •

Copy link
Copy Markdown
Owner

Summary

docs/SPECIFICATION.md remains unchanged. This PR remains open and unmerged. Green CI is evidence only for the jobs that ran; it does not prove the complete specification is implemented.

Requirement audit at 481173a

Requirement Status Implementation file / function Proving test Gaps / limits
Product mission partial internal/domain/graph.go (Validate, EnumeratePaths, FindPaths); internal/scoring/scoring.go (Score); internal/service/analysis.go (Analyze, Overview, RenderReport); internal/remediation/rank.go (Rank) TestFindPathsRanksAndExplains; TestScoreReportsExactComponentsForKnownPath; TestImportRankRemediationAndReportsEndToEnd Local typed inventory analysis; no cloud/provider integration or active scanning. 1,000-node performance is not measured.
Project criteria partial internal/repository/store.go; internal/service/service.go; cmd/attackpath-visualizer/main.go TestReplaceGraphPersistsTypedEntitiesEvidenceAndValidationResult; TestImportRankRemediationAndReportsEndToEnd Persistence, migrations, CLI and import-to-report workflow exist. No HTTP API/health endpoint or provider adapter; no benchmark.
Overview partial gui/dashboard.go (overview, chokePoints); internal/service/analysis.go (Overview); tui/tui.go (printOverview) TestImportRankRemediationAndReportsEndToEnd; TestEveryNavigationCategoryBuildsARealScreen Store-backed counts, distributions, top paths, choke points and freshness; manual large-graph and design review outstanding.
Graph partial gui/dashboard.go (graphScreen, graphCanvas, nodeDetails, filteredNodes) TestEveryNavigationCategoryBuildsARealScreen; TestGlobalSearchFindsNodesThroughLinkedFindings Linked entities, evidence, search, zoom and scroll are implemented; grid canvas caps at 160 displayed nodes. 1,000-node usability and accessibility unverified.
Paths implemented and tested internal/domain/graph.go (EnumeratePaths, FindPaths, makePath); internal/domain/path_heap.go; internal/scoring/scoring.go TestFindPathsRanksAndExplains; TestAllPathsDeduplicatesAndReportsBound; TestFindPathsRejectsCyclesAndInvalidLimits Bounded, source-rooted simple path prefixes; not exclusively sink-to-sink routes.
Assets partial internal/domain/graph.go (Asset, Identity, Misconfiguration, Finding, Nodes); internal/repository/store.go; GUI/TUI/CLI inventory views TestValidatesIdentityMisconfigurationAndFindingReferences; TestReplaceGraphPersistsTypedEntitiesEvidenceAndValidationResult Typed assets and identities with findings are stored and displayed; no provider enrichment or virtualized/column-configurable table.
Evidence partial internal/domain/graph.go (Evidence, Edge, Validate); repository persistence; GUI evidence views; internal/reports/reports.go TestValidateRejectsDanglingNodesAndEvidence; TestReplaceGraphPersistsTypedEntitiesEvidenceAndValidationResult; TestReportsIncludeScoreComponentsEvidenceAndCoverage Required edge evidence is shown and persisted; imported evidence is not independently corroborated.
Remediation implemented and tested internal/remediation/rank.go (Rank); internal/service/analysis.go; GUI/TUI/CLI remediation views TestRankPrioritizesChokePointByPathsBrokenAndRisk; TestImportRankRemediationAndReportsEndToEnd Ranking explains affected paths, critical paths and weighted points, but only for bounded enumerated paths.
Imports partial internal/ingestion/json.go (Read); internal/service/service.go (Import); internal/repository/store.go; migrations 003/004 TestReadRejectsMalformedAndOutOfSchemaDocuments; TestReadRejectsOversizedDocumentAndRecordCount; TestImportRejectsInvalidInputWithoutReplacingState Versioned JSON only; no CSV/provider imports.
Reports implemented and tested internal/reports/reports.go (Build, JSON, Markdown); internal/service/analysis.go (RenderReport); GUI/TUI/CLI TestReportsIncludeScoreComponentsEvidenceAndCoverage; TestMarkdownReportHandlesEmptyPathsAndEscapesCells; TestImportRankRemediationAndReportsEndToEnd JSON/Markdown reports are tested; no PDF or external report integrations.
About partial gui/dashboard.go (aboutScreen, previewBugReport); tui/tui.go; internal/meta/meta.go TestAboutLinksStayWithinConfiguredRepository; internal/securitycontact email allow-list test Offline help, diagnostics, repository links and advisory-first contact exist; real OS browser and accessibility behavior unverified.
Settings partial gui/dashboard.go (settingsScreen, notificationRulesDialog); launcher/notifier preferences TestEveryNavigationCategoryBuildsARealScreen; notification rules and install/uninstall tests Backed preferences and controls; window position, column chooser and complete OS-default theme behavior remain incomplete.
Specification section 10 — GUI, build and CI partial .github/workflows/ci.yml; gui/dashboard_test.go; internal/securitycontact/email_test.go Push CI 41332913551 and PR CI 41332919479; TestSoftwareRendererProducesAllScreenImages and email allow-list test Linux screenshot/render and native build checks exist; physical desktop behavior, accessibility and 1,000-node performance unverified. Screenshot is evidence, not proof of full specification completion. Lockfile workflow remains on default branch; disabling it returned HTTP 403.
Specification section 11 — Notifications partial internal/notifications; internal/notifier; internal/repository/notifications.go; GUI/TUI/CLI Existing rules, deduplication, quiet-hour, event and install/uninstall tests; full CI at 3d723fb Delivery code and state tests pass; real OS notification/startup delivery not observed on physical platforms.
Specification section 12 — Release packages partial .github/workflows/beta-release.yml; .github/workflows/release.yml; docs/RELEASING.md; cmd/attackpath-visualizer/FyneApp.toml Beta run 41333355433 passed native package, bundle, icon, checksum, and publication jobs on Linux x64, macOS ARM64, and Windows x64; YAML and bash syntax validation; general CI 41332913551 / 41332919479 Public beta is published and automated package checks pass. Manual archive extraction/install, physical desktop runtime, manual draft workflow dispatch, signing, and notarization remain unverified.
Security reporting contact implemented and tested SECURITY.md; README.md; docs/THREAT_MODEL.md; CODE_OF_CONDUCT.md; GUI/TUI About; internal/meta/meta.go (SecurityAdvisory); internal/securitycontact/email_test.go Repository-wide email allow-list test; TestAboutLinksStayWithinConfiguredRepository Advisory-first policy and exact backup address are in place; no external notification/delivery guarantee is claimed.

Verification at 481173aae28ccc5852f0db1b8c83cd1f9e4fa1e9

  • Push CI 41332913551: passed Linux, macOS, Windows, and Linux race detector.
  • PR CI 41332919479: passed Linux, macOS, Windows, and Linux race detector.
  • Ubuntu ran module metadata/download/verification, formatting, vet, unit/integration tests, CLI/native GUI builds, software-rendered screenshots, vulnerability scan; Windows and macOS ran metadata, formatting, vet, tests, and both builds. macOS runner architecture is checked in the release workflow.
  • Screenshot artifact: attackpath-visualizer-ui-screenshots, ID 13094023151, 1,942,475 bytes (SHA-256 f71f66353549fe16e2eaecc3cbedb3420b13e26338c925c60ed5653d3662d642). No manual screenshot review is claimed; a prior download attempt returned EOF.
  • Local git diff --check, YAML parsing, and bash -n passed. make check cannot run locally because Go/gofmt is unavailable; Go verification is from Actions.

Release status and remaining unverified items

Earlier beta attempts were deleted after their actual failures were addressed: license staging, the missing modernc.org/mathutil v1.6.0 classifier license, go-licenses flag placement, old Fyne toolchain incompatibility, Fyne TOML metadata layout, and the PowerShell icon verifier's incorrect Icon.Save(string) overload. The final tag workflow run 41333355433 at commit 481173aae28ccc5852f0db1b8c83cd1f9e4fa1e9 passed all package jobs and the publish job. The final public prerelease is AttackPath Visualizer v0.1.0-dev.

GitHub reports these published assets and SHA-256 digests:

  • attackpath-visualizer-linux-x64.tar.gz — 14,497,572 bytes — 75f25a740a7ce6c63b2e3cd8334e34eb895d7ce2bc934d106e7796fcfa688bcd
  • attackpath-visualizer-macos-arm64.tar.gz — 13,895,595 bytes — efdb0cc551801247a19e9e8ede6d6d41af3dad7c08fceb5ff6ba4a819704b442
  • attackpath-visualizer-windows-x64.zip — 14,816,152 bytes — 421b710bf04172cad864265a3c7a666a5dc5617babbf56dd9af2662b4fa40e3e
  • SHA256SUMS — 316 bytes — 5bff411d054a7bf3c0299f2b472bd9624d267fe5a98bd1052c94aed7f0056a74

The workflow generated and checked SHA256SUMS before publishing. Automated icon checks passed: Windows executable icon extraction produced a nontrivial .ico, macOS .app/Contents/Resources contained an .icns, and Linux archive contained a PNG or SVG icon. Required documentation/license bundles and the three archives passed their checks. Asset downloads from this environment returned EOF, so package bytes were not manually extracted; package installation, physical desktop launch/accessibility behavior, and notarization are not claimed.

Other specification gaps remain: provider integration, HTTP API, CSV imports, sink-to-sink-only route semantics, measured 1,000-node usability/performance, accessibility, real notification delivery, signing/notarization, and the default-branch lockfile workflow restriction. The email scan of text policy/source surfaces found only the approved backup [email protected]; the three automated checksum commits use GitHub noreply bot identities. Binary fonts were excluded from the text-address scan, as were go.sum and third-party license text. PR #1 remains open and unmerged.

unalivin and others added 30 commits October 31, 2026 18:05
@unalivin
unalivin merged commit 27b291d into main Nov 1, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant