Files
git.stella-ops.org/docs2/topic-map.md
master bc4318ef97 Add tests for SBOM generation determinism across multiple formats
- Created `StellaOps.TestKit.Tests` project for unit tests related to determinism.
- Implemented `DeterminismManifestTests` to validate deterministic output for canonical bytes and strings, file read/write operations, and error handling for invalid schema versions.
- Added `SbomDeterminismTests` to ensure identical inputs produce consistent SBOMs across SPDX 3.0.1 and CycloneDX 1.6/1.7 formats, including parallel execution tests.
- Updated project references in `StellaOps.Integration.Determinism` to include the new determinism testing library.
2025-12-23 18:56:12 +02:00

382 lines
14 KiB
Markdown

# Topic map (docs to docs2)
This map shows the source areas reviewed to build docs2. It lists directories and anchor docs
rather than every single file.
Product and positioning
- Sources: docs/README.md, docs/overview.md, docs/key-features.md, docs/03_VISION.md,
docs/04_FEATURE_MATRIX.md, docs/05_SYSTEM_REQUIREMENTS_SPEC.md, docs/05_ROADMAP.md
- Docs2: product/overview.md, product/roadmap-and-requirements.md
Market positioning and claims
- Sources: docs/market/*, docs/marketing/*, docs/claims-index.md
- Docs2: product/market-positioning.md, product/claims-and-benchmarks.md
Architecture and system model
- Sources: docs/07_HIGH_LEVEL_ARCHITECTURE.md, docs/high-level-architecture.md,
docs/ARCHITECTURE_DETAILED.md, docs/40_ARCHITECTURE_OVERVIEW.md,
docs/modules/platform/architecture-overview.md, docs/modules/*/architecture.md
- Docs2: architecture/overview.md, architecture/workflows.md, modules/index.md
Advisory alignment
- Sources: docs/architecture/advisory-alignment-report.md
- Docs2: architecture/advisory-alignment.md
Component map
- Sources: docs/technical/architecture/component-map.md
- Docs2: architecture/component-map.md
Ingestion and aggregation (AOC, linksets)
- Sources: docs/ingestion/aggregation-only-contract.md, docs/aoc/*,
docs/advisories/aggregation.md, docs/vex/aggregation.md
- Docs2: ingestion/aggregation-and-linksets.md
AOC guardrails and library
- Sources: docs/aoc/aoc-guardrails.md, docs/aoc/guard-library.md
- Docs2: ingestion/aoc-guardrails.md
AOC linkset backfill
- Sources: docs/concelier/backfill/*
- Docs2: ingestion/backfill.md
Evidence and determinism
- Sources: docs/replay/*, docs/contracts/*, docs/ingestion/*, docs/data/*,
docs/11_DATA_SCHEMAS.md, docs/ARCHITECTURE_DETAILED.md
- Docs2: architecture/evidence-and-trust.md, data-and-schemas.md
Reachability, VEX, unknowns
- Sources: docs/reachability/*, docs/vex/*, docs/signals/*, docs/modules/signals/*,
docs/modules/vex-lens/architecture.md, docs/modules/vexlens/architecture.md
- Docs2: architecture/reachability-vex.md, signals/unknowns.md, signals/uncertainty.md
Reachability lattice and evidence
- Sources: docs/reachability/lattice.md, docs/reachability/evidence-schema.md,
docs/reachability/edge-explainability-schema.md, docs/reachability/runtime-static-union-schema.md
- Docs2: architecture/reachability-lattice.md, architecture/reachability-evidence.md
VEX consensus
- Sources: docs/vex/consensus-overview.md, docs/vex/consensus-json.md
- Docs2: vex/consensus.md
Callgraph schema
- Sources: docs/signals/callgraph-formats.md
- Docs2: signals/callgraph-schema.md
Signal contract mapping
- Sources: docs/architecture/signal-contract-mapping.md
- Docs2: signals/contract-mapping.md
Unknowns ranking
- Sources: docs/signals/unknowns-ranking.md
- Docs2: signals/unknowns-ranking.md
Modules and services
- Sources: docs/modules/* (architecture, README, operations, runbooks)
- Docs2: modules/index.md
Advisory AI
- Sources: docs/advisory-ai/*
- Docs2: advisory-ai/overview.md
Orchestrator detail
- Sources: docs/orchestrator/*
- Docs2: orchestrator/overview.md, orchestrator/architecture.md, orchestrator/api.md,
orchestrator/cli.md, orchestrator/console.md, orchestrator/runbook.md
Orchestrator run ledger
- Sources: docs/orchestrator/run-ledger.md
- Docs2: orchestrator/run-ledger.md
Operations and deployment
- Sources: docs/21_INSTALL_GUIDE.md, docs/deploy/*, docs/install/*,
docs/operations/*, docs/runbooks/*, docs/quickstart.md
- Docs2: operations/quickstart.md, operations/install-deploy.md
Deployment versioning
- Sources: docs/deployment/VERSION_MATRIX.md
- Docs2: operations/deployment-versioning.md
Binary prerequisites
- Sources: docs/ops/binary-prereqs.md
- Docs2: operations/binary-prereqs.md
Runtime readiness
- Sources: docs/runtime/SCANNER_RUNTIME_READINESS.md
- Docs2: operations/runtime-readiness.md
Service SLOs
- Sources: docs/slo/*
- Docs2: operations/slo.md
Air-gap and offline kit
- Sources: docs/24_OFFLINE_KIT.md, docs/10_OFFLINE_KIT.md, docs/airgap/*
- Docs2: operations/airgap.md
Air-gap bundles and runbooks
- Sources: docs/airgap/overview.md, docs/airgap/offline-bundle-format.md, docs/airgap/runbooks/*
- Docs2: operations/airgap-bundles.md, operations/airgap-runbooks.md
Replay and determinism
- Sources: docs/replay/*, docs/runbooks/replay_ops.md, docs/release/promotion-attestations.md
- Docs2: operations/replay-and-determinism.md
Runbooks and incident response
- Sources: docs/runbooks/*, docs/operations/*
- Docs2: operations/runbooks.md, operations/key-rotation.md,
operations/proof-verification.md, operations/score-proofs.md,
operations/reachability.md, operations/trust-lattice.md,
operations/unknowns-queue.md
Notifications
- Sources: docs/notifications/*, docs/modules/notify/*
- Docs2: operations/notifications.md
Notifications details
- Sources: docs/notifications/overview.md, docs/notifications/rules.md,
docs/notifications/channels.md, docs/notifications/templates.md,
docs/notifications/digests.md, docs/notifications/pack-approvals-integration.md
- Docs2: notifications/overview.md, notifications/rules.md, notifications/channels.md,
notifications/templates.md, notifications/digests.md, notifications/pack-approvals.md,
notifications/runbook.md
Router rate limiting
- Sources: docs/router/*
- Docs2: operations/router-rate-limiting.md
Release engineering and CI/DevOps
- Sources: docs/13_RELEASE_ENGINEERING_PLAYBOOK.md, docs/ci/*, docs/devops/*,
docs/release/*, docs/releases/*
- Docs2: release/release-engineering.md, release/promotion-attestations.md,
release/release-notes.md
API and contracts
- Sources: docs/09_API_CLI_REFERENCE.md, docs/api/*, docs/schemas/*,
docs/contracts/*
- Docs2: api/overview.md, api/auth-and-tokens.md, data-and-schemas.md
Policy system
- Sources: docs/policy/*, docs/60_POLICY_TEMPLATES.md
- Docs2: policy/policy-system.md
Contracts and interfaces
- Sources: docs/contracts/*, docs/adr/*, docs/specs/*
- Docs2: contracts-and-interfaces.md
Scanner core contracts
- Sources: docs/scanner-core-contracts.md
- Docs2: contracts/scanner-core.md
Symbols specification
- Sources: docs/specs/SYMBOL_MANIFEST_v1.md, docs/specs/symbols/*
- Docs2: specs/symbols.md
SBOM handling
- Sources: docs/sbom/*
- Docs2: sbom/overview.md
Security, governance, compliance
- Sources: docs/13_SECURITY_POLICY.md, docs/17_SECURITY_HARDENING_GUIDE.md,
docs/11_GOVERNANCE.md, docs/12_CODE_OF_CONDUCT.md, docs/28_LEGAL_COMPLIANCE.md
- Docs2: security-and-governance.md
Regulator threat and evidence model
- Sources: docs/28_LEGAL_COMPLIANCE.md
- Docs2: legal/regulator-threat-evidence.md
Identity, tenancy, and scopes
- Sources: docs/security/authority-scopes.md, docs/security/scopes-and-roles.md,
docs/architecture/console-admin-rbac.md
- Docs2: security/identity-tenancy-and-scopes.md, security/multi-tenancy.md,
security/row-level-security.md
Console admin RBAC
- Sources: docs/architecture/console-admin-rbac.md
- Docs2: security/admin-rbac.md
Crypto profiles and trust
- Sources: docs/security/crypto-profile-configuration.md,
docs/security/trust-and-signing.md, docs/security/crypto-simulation-services.md
- Docs2: security/crypto-and-trust.md
Crypto compliance and licensing
- Sources: docs/security/crypto-compliance.md, docs/legal/crypto-compliance-review.md
- Docs2: security/crypto-compliance.md
Security hardening
- Sources: docs/security/dpop-mtls-rollout.md, docs/security/password-hashing.md,
docs/security/secrets-handling.md, docs/security/rate-limits.md,
docs/security/notifications-hardening.md, docs/security/export-hardening.md
- Docs2: security/operational-hardening.md
Audit events
- Sources: docs/security/audit-events.md
- Docs2: security/audit-events.md
Revocation bundles
- Sources: docs/security/revocation-bundle.md, docs/security/revocation-bundle-example.json
- Docs2: security/revocation-bundles.md
Quota and licensing
- Sources: docs/license-jwt-quota.md, docs/30_QUOTA_ENFORCEMENT_FLOW1.md,
docs/33_333_QUOTA_OVERVIEW.md
- Docs2: security/quota-and-licensing.md
Risk model and scoring
- Sources: docs/risk/*, docs/contracts/risk-scoring.md
- Docs2: security/risk-model.md, risk/overview.md, risk/factors.md, risk/formulas.md,
risk/profiles.md, risk/explainability.md, risk/api.md
Forensics and evidence locker
- Sources: docs/forensics/*, docs/evidence-locker/*, docs/ops/evidence-locker-handoff.md
- Docs2: security/forensics-and-evidence-locker.md, security/evidence-locker-publishing.md
Timeline forensics
- Sources: docs/forensics/timeline.md
- Docs2: security/timeline.md
Provenance and transparency
- Sources: docs/provenance/*, docs/security/trust-and-signing.md,
docs/modules/attestor/*, docs/modules/signer/*
- Docs2: provenance/inline-provenance.md, provenance/attestation-workflow.md,
provenance/rekor-policy.md, provenance/backfill.md
Database and persistence
- Sources: docs/db/*, docs/adr/0001-postgresql-for-control-plane.md
- Docs2: data/persistence.md, data/postgresql-operations.md, data/postgresql-patterns.md
Events and messaging
- Sources: docs/events/*, docs/samples/*
- Docs2: data/events.md
CLI and UI
- Sources: docs/15_UI_GUIDE.md, docs/cli/*, docs/ui/*, docs/console/*, docs/ux/*
- Docs2: cli-ui.md
CLI reference
- Sources: docs/cli/*
- Docs2: cli/overview.md
CLI command guides
- Sources: docs/cli/command-reference.md, docs/cli/crypto-commands.md,
docs/cli/crypto-plugins.md, docs/cli/distribution-matrix.md,
docs/cli/reachability-cli-reference.md, docs/cli/drift-cli.md,
docs/cli/smart-diff-cli.md, docs/cli/triage-cli.md,
docs/cli/unknowns-cli-reference.md, docs/cli/score-proofs-cli-reference.md,
docs/cli/sbomer.md, docs/cli/audit-pack-commands.md,
docs/cli/keyboard-shortcuts.md, docs/cli/troubleshooting.md
- Docs2: cli/commands.md, cli/crypto.md, cli/crypto-plugins.md,
cli/distribution-matrix.md, cli/reachability.md, cli/triage.md,
cli/unknowns.md, cli/score-proofs.md, cli/sbomer.md, cli/audit-pack.md,
cli/keyboard-shortcuts.md, cli/troubleshooting.md
Console shell and navigation
- Sources: docs/ui/console-overview.md, docs/ui/navigation.md
- Docs2: ui/console.md, ui/navigation.md
Console workspaces
- Sources: docs/ui/console.md, docs/ui/findings.md, docs/ui/advisories-and-vex.md,
docs/ui/downloads.md, docs/ui/runs.md, docs/ui/policies.md
- Docs2: ui/aoc-dashboard.md, ui/findings.md, ui/advisories-vex.md, ui/downloads.md,
ui/runs.md, ui/policies.md
Console admin and governance
- Sources: docs/ui/admin.md, docs/console/admin-tenants.md, docs/ui/exception-center.md
- Docs2: ui/admin.md, ui/exception-center.md
Console SBOM and vulnerability exploration
- Sources: docs/ui/sbom-explorer.md, docs/ui/sbom-graph-explorer.md,
docs/ui/vulnerability-explorer.md, docs/ui/reachability-overlays.md
- Docs2: ui/sbom-explorer.md, ui/sbom-graph-explorer.md,
ui/vulnerability-explorer.md, ui/reachability-overlays.md
Console explainers
- Sources: docs/ui/explainers.md
- Docs2: ui/explainers.md
Console air-gap and attestations
- Sources: docs/console/airgap.md, docs/console/attestor-ui.md
- Docs2: ui/airgap.md, ui/attestor.md
Console forensics, observability, and risk
- Sources: docs/console/forensics.md, docs/console/observability.md, docs/console/risk-ui.md
- Docs2: ui/forensics.md, ui/observability.md, ui/risk-ui.md
Console branding and accessibility
- Sources: docs/ui/branding.md, docs/architecture/console-branding.md, docs/accessibility.md
- Docs2: ui/branding.md, ui/accessibility.md
Policy editor UI
- Sources: docs/ui/policy-editor.md, docs/security/policy-governance.md
- Docs2: ui/policy-editor.md
Triage UX
- Sources: docs/ux/TRIAGE_UX_GUIDE.md, docs/ux/TRIAGE_UI_REDUCER_SPEC.md
- Docs2: ui/triage.md
Console security
- Sources: docs/security/console-security.md
- Docs2: security/console-security.md
Approvals and exceptions
- Sources: docs/governance/approvals-and-routing.md, docs/governance/exceptions.md
- Docs2: governance/approvals.md, governance/exceptions.md
Developer and contribution
- Sources: docs/DEVELOPER_ONBOARDING.md, docs/onboarding/*,
docs/10_PLUGIN_SDK_GUIDE.md, docs/18_CODING_STANDARDS.md, docs/contributing/*,
docs/devportal/publishing.md, docs/process/implementor-guidelines.md
- Docs2: developer/onboarding.md, developer/plugin-sdk.md, developer/devportal.md,
developer/implementation-guidelines.md
SDKs and clients
- Sources: docs/sdks/*
- Docs2: sdk/overview.md
Task packs and automation
- Sources: docs/task-packs/*
- Docs2: task-packs.md
Interoperability
- Sources: docs/interop/*
- Docs2: interop/sbom-interop.md, interop/cosign.md
Migration guidance
- Sources: docs/migration/*
- Docs2: migration/overview.md
Vuln Explorer overview
- Sources: docs/vuln/*
- Docs2: vuln-explorer/overview.md
Testing and quality
- Sources: docs/19_TEST_SUITE_OVERVIEW.md, docs/testing/*
- Docs2: testing-and-quality.md, testing/router-chaos.md
Observability and telemetry
- Sources: docs/metrics/*, docs/observability/*, docs/modules/telemetry/*,
docs/technical/observability/*
- Docs2: observability.md, observability-standards.md, observability-logging.md,
observability-tracing.md, observability-metrics-slos.md, observability-telemetry-controls.md,
observability-aoc.md, observability-aggregation.md, observability-policy.md,
observability-ui-telemetry.md, observability-vuln-telemetry.md
Benchmarks and performance
- Sources: docs/benchmarks/*, docs/12_PERFORMANCE_WORKBOOK.md
- Docs2: benchmarks.md
Guides and workflows
- Sources: docs/guides/*, docs/ci/sarif-integration.md, docs/architecture/epss-versioning-clarification.md
- Docs2: guides/compare-workflow.md, guides/epss-integration.md
Examples and fixtures
- Sources: docs/examples/*, docs/samples/*, docs/schemas/*
- Docs2: references/examples-and-fixtures.md
Training and adoption
- Sources: docs/training/*, docs/evaluate/*, docs/faq/*
- Docs2: training-and-adoption.md
Glossary
- Sources: docs/14_GLOSSARY_OF_TERMS.md
- Docs2: glossary.md