Synchronize agentctl framework completeness documentation

.github/workflows/pages.yml

@@ -15,7 +15,7 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  AGENTCTL_COMMIT: "f3181f93afac7546f01923491f77dabdf26b5ace"
+  AGENTCTL_COMMIT: "736379ed5f49b0dbe1ad79ac4e4ba794e2c73c47"
   NODE_VERSION: "24.4.1"
   PNPM_VERSION: "11.9.0"
   RUST_TOOLCHAIN: "1.88.0"
@@ -31,13 +31,16 @@ jobs:
       - name: Check out Pages source
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event.pull_request.head.sha || github.sha }}
+          persist-credentials: false
           path: site
 
       - name: Check out canonical agentctl source
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: opensourceops/agentctl
           ref: ${{ env.AGENTCTL_COMMIT }}
+          persist-credentials: false
           path: agentctl
 
       - name: Install pinned Node.js
@@ -63,6 +66,20 @@ jobs:
           AGENTCTL_REPO: ${{ github.workspace }}/agentctl
         run: pnpm verify:agentctl
 
+      - name: Upload validated pull-request artifact
+        if: github.event_name == 'pull_request'
+        id: validation_artifact
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: agentctl-pages-validation
+          path: site/_site
+          if-no-files-found: error
+          retention-days: 14
+
+      - name: Record validation artifact digest
+        if: github.event_name == 'pull_request'
+        run: echo "agentctl-pages-validation artifact digest ${{ steps.validation_artifact.outputs.artifact-digest }}" >> "$GITHUB_STEP_SUMMARY"
+
       - name: Configure GitHub Pages
         if: github.event_name != 'pull_request'
         uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0

astro.config.mjs

@@ -59,6 +59,7 @@ export default defineConfig({
             { slug: 'overview', label: 'Overview', badge: 'v1alpha1' },
             { slug: 'why-agentctl', label: 'Why agentctl' },
             { slug: 'concepts/product', label: 'Product definition' },
+            { slug: 'concepts/framework-completeness', label: 'Framework completeness' },
             { slug: 'getting-started/installation', label: 'Installation' },
             { slug: 'getting-started', label: 'Getting started' },
             { slug: 'getting-started/first-agent', label: 'First agent workflow' },
@@ -82,6 +83,7 @@ export default defineConfig({
           items: [
             { slug: 'guides/local-operation', label: 'Local operation' },
             { slug: 'durable-execution', label: 'Resume, replay, retry, and fork' },
+            { slug: 'guides/selective-repair', label: 'Repair a failed workflow' },
             { slug: 'operations/scheduled', label: 'Scheduled execution' },
           ],
         },
@@ -123,6 +125,7 @@ export default defineConfig({
             { slug: 'examples/ci-quality-gate', label: 'CI quality gate' },
             { slug: 'examples/approval-gated', label: 'Approval-gated action' },
             { slug: 'examples/recorded-replay', label: 'Recorded replay' },
+            { slug: 'guides/selective-repair', label: 'Selective workflow repair' },
             { slug: 'examples/provider-portability', label: 'Provider portability' },
           ],
         },
@@ -143,6 +146,9 @@ export default defineConfig({
             { slug: 'reference/compatibility', label: 'Compatibility' },
             { slug: 'reference/migration', label: 'Migrate from TypeScript' },
             { slug: 'reference/limitations', label: 'Limitations' },
+            { slug: 'reference/limitation-burndown', label: 'Limitation burn-down' },
+            { slug: 'reference/completeness-verification', label: 'Completeness verification' },
+            { slug: 'reference/live-framework-verification', label: 'Live framework verification' },
           ],
         },
         {

cspell.json

@@ -20,6 +20,11 @@
     "effectful", "exfiltration", "inspectable", "ledgered", "lockfiles", "misexecutes",
     "msvc", "noninteractive", "nonroot", "oneshot", "proptest", "rustdoc", "sandboxing",
     "schedulable", "Streamable", "subpaths", "TOCTOU", "transactionally", "uncheckpointed",
-    "unpushed", "xtask", "MSRV", "nojekyll", "accDescr"
+    "unpushed", "xtask", "MSRV", "nojekyll", "accDescr", "backpressure", "bubblewrap",
+    "hardlinks", "Microusd", "Millis", "networkless", "pids", "preflighted", "redispatch",
+    "redispatched", "replayable", "Sigstore", "subworkflows", "Unreviewed", "workstreams",
+    "zeroizing", "nonterminal", "Kolkata", "libkrun", "gvproxy", "Workstream",
+    "undispatched", "XPLAT", "roundtrips", "keylessly", "unallowlisted", "embedder",
+    "reindexing", "zeroization", "BURNDOWN"
   ]
 }