diff --git a/.github/workflows/doc-lint-pr-scope.yml b/.github/workflows/doc-lint-pr-scope.yml index 5e88b263..97332e95 100644 --- a/.github/workflows/doc-lint-pr-scope.yml +++ b/.github/workflows/doc-lint-pr-scope.yml @@ -25,7 +25,7 @@ jobs: - name: Setup Node.js uses: actions/setup-node@v4 with: - node-version: '20' + node-version: '24' - name: Install markdownlint-cli run: npm install -g markdownlint-cli@0.39.0 diff --git a/.github/workflows/doc-lint.yml b/.github/workflows/doc-lint.yml index 9f2f2e82..acb798be 100644 --- a/.github/workflows/doc-lint.yml +++ b/.github/workflows/doc-lint.yml @@ -1,8 +1,7 @@ # Doc-Lint CI Workflow — DGAF-Framework (Spine Repo) -# Mirrors sentinel-governance/.github/workflows/doc-lint.yml -# Pattern: P-24 (Canonical Practice Unit) | P-11 (11Q gate 7 — Surface Consistency) -# Owner: Agent Sentinel -# Activated: Session S031 — closes last CI coverage gap in PHDGE ecosystem +# Public/current documentation quality gate. +# Historical and append-only evidence records are governed separately so +# presentation linting does not rewrite or invalidate provenance. name: Doc Lint @@ -25,7 +24,7 @@ on: jobs: markdownlint: - name: Markdown Lint + name: Markdown Lint — Current Surface runs-on: ubuntu-latest steps: - name: Checkout @@ -36,29 +35,35 @@ jobs: - name: Setup Node.js uses: actions/setup-node@v4 with: - node-version: '20' + node-version: '24' - name: Install markdownlint-cli run: npm install -g markdownlint-cli@0.39.0 - - name: Run markdownlint + - name: Run markdownlint on current/public surfaces run: | markdownlint \ --config .markdownlint.yml \ --ignore node_modules \ --ignore CHANGELOG.md \ --ignore SWEEP_LOG.md \ + --ignore SWEEP_LOG/** \ + --ignore references/orchestration-patterns-log.md \ + --ignore docs/evidence/** \ + --ignore docs/archive/** \ + --ignore docs/historical/** \ + --ignore docs/audit/** \ + --ignore docs/experiment/** \ '**/*.md' - # CHANGELOG.md and SWEEP_LOG.md: auto-generated append-format; excluded from lint - # All gate specs, protocols, READMEs, SESSION_ANCHOR, CROSS_REF enforced + # Evidence, archive, historical, audit, experiment, and append-only + # pattern-log records remain subject to their own provenance controls. + # This job protects the reader-facing/current documentation surface. - name: Report summary if: always() run: | echo "## Doc Lint Summary — DGAF-Framework" >> $GITHUB_STEP_SUMMARY echo "- Linter: markdownlint-cli 0.39.0" >> $GITHUB_STEP_SUMMARY - echo "- Config: .markdownlint.yml" >> $GITHUB_STEP_SUMMARY - echo "- Excluded: CHANGELOG.md, SWEEP_LOG.md (append-format auto-generated)" >> $GITHUB_STEP_SUMMARY - echo "- Pattern gates: P-24 (CPU surface consistency) + P-11 gate 7" >> $GITHUB_STEP_SUMMARY - echo "- Owner: Agent Sentinel | Spine repo: DGAF-Framework" >> $GITHUB_STEP_SUMMARY - echo "- Mirror of: sentinel-governance/.github/workflows/doc-lint.yml (S029)" >> $GITHUB_STEP_SUMMARY + echo "- Node.js: 24" >> $GITHUB_STEP_SUMMARY + echo "- Scope: current/public documentation surface" >> $GITHUB_STEP_SUMMARY + echo "- Separate provenance surfaces: evidence, archive, historical, audit, experiment, append-only pattern log" >> $GITHUB_STEP_SUMMARY diff --git a/README.technical.md b/README.technical.md index b0656212..da574b9e 100644 --- a/README.technical.md +++ b/README.technical.md @@ -1,9 +1,7 @@ # DGAF-Framework — Technical & Agent-Facing Reference > **Claim-status boundary:** This document is a technical/project reference, not a certification, validation, regulatory-conformance statement, or efficacy report. Project-local gate names, targets, thresholds, and attestation labels describe internal procedures or historical records unless current claim-specific evidence says otherwise. -> > **Current certification policy:** There is no active DGAF certification program. See [`docs/GOVERNANCE/DGAF_TRADEMARK_AND_CERTIFICATION_POLICY.md`](./docs/GOVERNANCE/DGAF_TRADEMARK_AND_CERTIFICATION_POLICY.md). - > **Audience:** Agent Amethyst, Agent Apogee, Agent COLLEEN, Agent Sentinel, and all ensemble members; engineers integrating with DGAF > **Entry point for:** Gate specs · Pattern registry · Runtime components · Formation protocols · Session open/close procedures > **Compliance/governance entry point:** [`README.governance.md`](./README.governance.md) @@ -13,7 +11,7 @@ ## MDAR Loop — Project Protocol -``` +```text Map → Diagnose → Act → Review ↑ | └────────────────────────┘ @@ -105,7 +103,7 @@ An attestation record is not automatically an independent certification or valid ## Session Open Protocol (COLLEEN — P-02) -``` +```text 1. Read session-state reference → rehydrate open BLGs + priority queue 2. Run .operations/gate_compliance_check.py → surface P-24 gaps 3. Emit session priority queue to Amethyst @@ -120,7 +118,7 @@ Checklist: [`.operations/sweep_session_init.md`](./.operations/sweep_session_ini ## Session Close Protocol (Amethyst — P-06 + P-21) -``` +```text 1. All repo fixes committed 2. SWEEP_LOG.md updated + buoy appended 3. CHANGELOG.md versioned @@ -147,7 +145,7 @@ Formation names and role assignments are project architecture. They do not estab ## Key File Locations -``` +```text DGAF-Framework/ ├── README.md ← Public-facing entry point ├── README.governance.md ← Governance reference diff --git a/repos/3d-visualization-hub/GOVERNANCE.md b/repos/3d-visualization-hub/GOVERNANCE.md index bf370f53..4b9c28d6 100644 --- a/repos/3d-visualization-hub/GOVERNANCE.md +++ b/repos/3d-visualization-hub/GOVERNANCE.md @@ -28,4 +28,6 @@ --- -*φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier* +### Governance signatures + +φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier diff --git a/repos/Acoustic-mesh/GOVERNANCE.md b/repos/Acoustic-mesh/GOVERNANCE.md index fab86d7f..f9b57f61 100644 --- a/repos/Acoustic-mesh/GOVERNANCE.md +++ b/repos/Acoustic-mesh/GOVERNANCE.md @@ -28,4 +28,6 @@ --- -*φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier* +### Governance signatures + +φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier diff --git a/repos/Driftwatch/GOVERNANCE.md b/repos/Driftwatch/GOVERNANCE.md index 1da551dc..c892114d 100644 --- a/repos/Driftwatch/GOVERNANCE.md +++ b/repos/Driftwatch/GOVERNANCE.md @@ -28,4 +28,6 @@ --- -*φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier* +### Governance signatures + +φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier diff --git a/repos/junior-apogee-app/GOVERNANCE.md b/repos/junior-apogee-app/GOVERNANCE.md index b1678229..93626a0f 100644 --- a/repos/junior-apogee-app/GOVERNANCE.md +++ b/repos/junior-apogee-app/GOVERNANCE.md @@ -28,4 +28,6 @@ --- -*φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier* +### Governance signatures + +φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier diff --git a/repos/resumeapex-eval/GOVERNANCE.md b/repos/resumeapex-eval/GOVERNANCE.md index 20723ad3..bba2da62 100644 --- a/repos/resumeapex-eval/GOVERNANCE.md +++ b/repos/resumeapex-eval/GOVERNANCE.md @@ -15,7 +15,7 @@ ## Applicable NDR Patterns | Pattern | Class | Role in this repo | -|---------|-------|-------------------| +|---|---|---| | NDR-133 | BLOCKING-ABSOLUTE | Personal Document Firewall — no PII/resume data to GitHub | | P-30 Apogee-Attestation-Gate | BLOCKING | Final gate before any eval output is promoted | | P-11 11Q Attestation Scoring | BLOCKING | Quantitative scoring for all evaluations | @@ -30,4 +30,6 @@ --- -*φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier* +### Governance signatures + +φ = 1.61818 · Amethyst host · DemiJoule supervisor · Apogee Lens verifier