rickylabs · rickylabs · Jul 11, 2026 · Jul 11, 2026
@@ -0,0 +1,3 @@
+# Context pack
+
+Issue #433 S0 is implemented as a docs-only structural IA reconciliation. Full site verify and explicit redirect/nav/scope checks pass. PLAN-EVAL was owner-waived; separate supervisor slice review/IMPL-EVAL remains external to this implementation lane.
@@ -0,0 +1,6 @@
+# Drift
+
+## D1 — PLAN-EVAL waiver
+
+Owner explicitly waived PLAN-EVAL for this structural S0 slice. The implementation plan and Design checkpoint were recorded before changes.
+
@@ -0,0 +1,30 @@
+# Plan
+
+## Locked decisions
+
+1. Move the 13 one-to-one capability pages byte-for-byte to the proposal targets.
+2. Treat the two fold mappings as redirects to existing pillar indexes; do not merge or rewrite prose in S0.
+3. Generate static HTML redirect documents at all 15 old leaf URLs plus the retired capabilities index URL, using a dedicated Vento layout with canonical, meta-refresh, and JavaScript replacement targets.
+4. Retarget `cap:*`, the three landing cards, and hard-coded internal capability links to canonical pillar URLs while leaving tutorial nav anchors unchanged.
+5. Add minimal titled stubs for CLI/scaffold and MCP and expose them in their pillar nav sections.
+
+## Open decisions
+
+- HTTP 301 at GitHub Pages hosting: safe to defer; the static host cannot emit per-page status codes. Redirect documents preserve URLs client-side and canonical metadata.
+
+## Slices and gates
+
+1. IA + redirects + nav/xrefs/stubs — `deno task verify`, built redirect inspection, grep/nav assertions; docs-site files and run artifacts only.
+
+## Risks
+
+- Stale hard-coded links: mitigate with site verify and a full `/capabilities/` scan.
+- Base-path mistakes: redirect layout uses Lume's `url` filter.
+- Prose churn: verify moved blobs with git rename detection/diff review.
+- Lock churn: compare `deno.lock` before commit.
+
+## Deferred scope
+
+- All prose rewriting/merging, tutorial chapter anchors, framework code, and deployment authoring.
+- JSR audit: N/A, docs-only and no package/plugin public surface changes.
+
@@ -0,0 +1,9 @@
+# Research
+
+- Re-baselined issue #433 and proposal §2.2 against the current clean branch.
+- `docs/site/capabilities/` contains 15 leaf pages plus `index.md`; proposal maps all leaves into the nine pillar folders.
+- `_data/xref.ts` owns all `cap:*` destinations. Three pillar landing cards currently route into `capabilities/`: Background Processing, Data & Persistence, and Observability.
+- No redirect plugin or redirect-frontmatter convention exists in `_config.ts`; static redirect documents are therefore required for GitHub Pages compatibility.
+- The nine pillar nav sections and order are Web Layer, Services & SDK, Background Processing, Durable Workflows, AI & Agents, Data & Persistence, Identity & Access, Orchestration & Runtime, Observability.
+- The two fold mappings target existing canonical pillar indexes. Structural-only scope forbids merging prose, so the old URLs redirect to those indexes and the existing indexes remain canonical.
+
@@ -0,0 +1,10 @@
+# Supervisor
+
+- Run: `docs-433-ia-reconcile--codex`
+- Supervisor: beta-7 Claude session `df71d36c`
+- Implementation lane: WSL Codex, `/home/codex/repos/ns-wt-433`
+- Branch: `docs/433-ia-reconcile-capabilities`
+- Scope: docs-only, `SCOPE-docs`
+- PLAN-EVAL: owner-waived (D1)
+- IMPL-EVAL / slice review: separate supervisor session required
+
@@ -0,0 +1,28 @@
+# Worklog
+
+## Design
+
+- Public surface: canonical pillar URLs, legacy redirect URLs, sidebar navigation, and stable `cap:*` xrefs.
+- Domain vocabulary: 15 legacy capability slugs mapped to canonical pillar paths; nine ordered pillars; two navigable stubs.
+- Ports: Lume page rendering and the existing `url` filter/base-path behavior.
+- Constants: the mapping is locked by proposal §2.2 and represented by redirect frontmatter + xref entries.
+- Commit slices: one structural docs slice, proven by `deno task verify`, redirect inspection, grep, nav/stub assertions, and scope/lock checks.
+- Deferred: prose rewrites/merges, tutorial nav anchors, framework/package/plugin changes.
+- Contributor path: add concepts inside the owning pillar, register stable xrefs in `_data/xref.ts`, and add nav leaves in `_data.ts`.
+
+## Plan gate
+
+- PLAN-EVAL owner-waived; recorded as drift D1 before implementation.
+
+## Evidence
+
+- `deno task verify` in `docs/site`: exit 0; 23,016 internal links across 162 pages resolve; 27 caveat markers across 22 pages resolve.
+- Built redirect inspection: all 15 `/capabilities/<slug>/` documents exist and contain their mapped `/netscript/<pillar>/` canonical/refresh target (`redirects=15 PASS`).
+- `rg 'capabilities/' docs/site/_data.ts docs/site/_data/xref.ts`: no matches.
+- Nine pillar headings remain in the original order; exact `_data.ts` heading lines verified.
+- Stub nav: `/ai/mcp/` and `/orchestration-runtime/cli-scaffold/` both present in `_data.ts`; built pages exist.
+- Scope/lock check: no path under `packages/` or `plugins/`, and no `deno.lock`, appears in the diff (`scope-lock=PASS`).
+
+## Reconcile
+
+- Issue #433 remains open with the expected docs/refactor taxonomy and beta.7 milestone. No PR was opened per owner instruction.
@@ -146,6 +146,7 @@ export const navSections: NavSection[] = [
     label: "AI & Agents",
     items: [
       { href: "/ai/", label: "Overview & Concepts", icon: "O" },
+      { href: "/ai/mcp/", label: "Guide: MCP", icon: "G" },
       { href: "/tutorials/chat/", label: "Quickstart: AI chat", icon: "Q" },
       { href: "/how-to/build-a-durable-chat/", label: "How-To: build a durable chat", icon: "H" },
       { href: "/ai/durable-chat/", label: "Guide: durable chat", icon: "G" },
@@ -187,6 +188,7 @@ export const navSections: NavSection[] = [
     label: "Orchestration & Runtime",
     items: [
       { href: "/orchestration-runtime/", label: "Overview & Concepts", icon: "O" },
+      { href: "/orchestration-runtime/cli-scaffold/", label: "Guide: CLI & scaffold", icon: "G" },
       { href: "/quickstart/", label: "Quickstart: run the workspace", icon: "Q" },
       { href: "/how-to/deno-lsp-code-intelligence/", label: "How-To: Deno LSP intelligence", icon: "H" },
       { href: "/how-to/deploy-local-aspire/", label: "How-To: deploy locally with Aspire", icon: "H" },

@@ -6,7 +6,7 @@
  * and FAILS on an unknown key, so the build doubles as a link checker.
  *
  * Locked key namespaces (OD3):
- *   cap:        capability hub          (cap:services      -> /capabilities/services/)
+ *   cap:        capability hub          (cap:services      -> /services-sdk/services/)
  *   howto:      how-to recipe           (howto:add-a-plugin)
  *   tut:        tutorial chapter/track  (tut:first-workspace)
  *   explain:    explanation essay       (explain:architecture)
@@ -77,22 +77,22 @@ function refEntries(): Record<string, XrefTarget> {
 
 export const xref: Record<string, XrefTarget> = {
   // ─── Capability hubs (cap:) ────────────────────────────────────────────────
-  "cap:services": { href: "/capabilities/services/", label: "Services & contracts" },
-  "cap:background-jobs": { href: "/capabilities/background-jobs/", label: "Background jobs" },
-  "cap:durable-sagas": { href: "/capabilities/durable-sagas/", label: "Durable sagas" },
-  "cap:triggers": { href: "/capabilities/triggers/", label: "Triggers & ingress" },
-  "cap:streams": { href: "/capabilities/streams/", label: "Durable streams" },
-  "cap:database": { href: "/capabilities/database/", label: "Database & Prisma" },
-  "cap:kv-queues-cron": { href: "/capabilities/kv-queues-cron/", label: "KV, queues & cron" },
-  "cap:telemetry": { href: "/capabilities/telemetry/", label: "Telemetry & logging" },
-  "cap:auth": { href: "/capabilities/auth/", label: "Authentication" },
-  "cap:fresh-ui": { href: "/capabilities/fresh-ui/", label: "Fresh UI & design" },
-  "cap:index": { href: "/capabilities/", label: "Capabilities" },
+  "cap:services": { href: "/services-sdk/services/", label: "Services & contracts" },
+  "cap:background-jobs": { href: "/background-processing/workers/", label: "Background jobs" },
+  "cap:durable-sagas": { href: "/durable-workflows/sagas/", label: "Durable sagas" },
+  "cap:triggers": { href: "/durable-workflows/triggers/", label: "Triggers & ingress" },
+  "cap:streams": { href: "/durable-workflows/streams/", label: "Durable streams" },
+  "cap:database": { href: "/data-persistence/database/", label: "Database & Prisma" },
+  "cap:kv-queues-cron": { href: "/data-persistence/kv-queues-cron/", label: "KV, queues & cron" },
+  "cap:telemetry": { href: "/observability/telemetry/", label: "Telemetry & logging" },
+  "cap:auth": { href: "/identity-access/auth/", label: "Authentication" },
+  "cap:fresh-ui": { href: "/web-layer/fresh-ui/", label: "Fresh UI & design" },
+  "cap:index": { href: "/", label: "NetScript" },
   // v3 NEW capability hubs
-  "cap:fresh-framework": { href: "/capabilities/fresh-framework/", label: "Fresh meta-framework" },
-  "cap:sdk": { href: "/capabilities/sdk/", label: "Typed SDK & client" },
-  "cap:polyglot-tasks": { href: "/capabilities/polyglot-tasks/", label: "Polyglot tasks" },
-  "cap:runtime-config": { href: "/capabilities/runtime-config/", label: "Runtime configuration" },
+  "cap:fresh-framework": { href: "/web-layer/", label: "Fresh meta-framework" },
+  "cap:sdk": { href: "/services-sdk/sdk/", label: "Typed SDK & client" },
+  "cap:polyglot-tasks": { href: "/background-processing/polyglot-tasks/", label: "Polyglot tasks" },
+  "cap:runtime-config": { href: "/orchestration-runtime/runtime-config/", label: "Runtime configuration" },
 
   // ─── How-to recipes (howto:) ───────────────────────────────────────────────
   "howto:index": { href: "/how-to/", label: "How-to guides" },

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta http-equiv="refresh" content="0; url={{ redirectTo |> url }}">
+    <link rel="canonical" href="{{ redirectTo |> url }}">
+    <title>Moved</title>
+  </head>
+  <body>
+    <p>This page moved to <a href="{{ redirectTo |> url }}">{{ redirectTo }}</a>.</p>
+    <script>location.replace({{ redirectTo |> url |> JSON.stringify }} + location.search + location.hash);</script>
+  </body>
+</html>
@@ -0,0 +1,9 @@
+---
+layout: layouts/base.vto
+title: MCP
+templateEngine: [vento, md]
+---
+
+# MCP
+
+_Story page forthcoming._
@@ -11,7 +11,7 @@ per-task permissions. Start here when work should run outside the request path b
 durable saga state model.
 
 {{ comp.cardsGrid({ columns: 3, cards: [
-  { eyebrow: "Overview & Concepts", title: "Workers and queues", body: "Worker tasks consume queued work with provider and runtime choices kept inside the leaf.", href: "/capabilities/background-jobs/", icon: "O" },
+  { eyebrow: "Overview & Concepts", title: "Workers and queues", body: "Worker tasks consume queued work with provider and runtime choices kept inside the leaf.", href: "/background-processing/workers/", icon: "O" },
   { eyebrow: "Quickstart", title: "Polyglot transform", body: "Run a task step from the ERP Sync tutorial.", href: "/tutorials/erp-sync/03-polyglot-transform/", icon: "Q" },
   { eyebrow: "How-To", title: "Queue, KV, and cron", body: "Create the queue and scheduler loop used by background work.", href: "/how-to/queue-kv-cron/", icon: "H" },
   { eyebrow: "How-To", title: "Choose a queue provider", body: "Select the provider that fits your local and deployed runtime.", href: "/how-to/choose-a-queue-provider/", icon: "H" },
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# Context pack

		Issue #433 S0 is implemented as a docs-only structural IA reconciliation. Full site verify and explicit redirect/nav/scope checks pass. PLAN-EVAL was owner-waived; separate supervisor slice review/IMPL-EVAL remains external to this implementation lane.