@open-agent-toolkit/cli 0.3.24 → 0.3.25

package/assets/bundle-metadata.json

@@ -1,4 +1,4 @@
 {
   "schemaVersion": 1,
-  "oatVersion": "0.3.24"
+  "oatVersion": "0.3.25"
 }

package/assets/docs/docs-tooling/workflows.md

@@ -364,8 +364,11 @@ method works without private guidance or copied exemplars.
 Existing docs default to analyze → apply of approved recommendations and exit
 before scaffolding. Replacement requires an explicit choice. A second app also
 requires an explicit choice and remains unsupported by the current CLI. This
-selection stage does not persist IA decisions, restructure trees or materialize
-preset scaffolds. Feature and QA validation page templates are a later delivery;
+proposal becomes durable only after approval: bootstrap/apply use `oat decision new`
+and an Information architecture section in the framework docs-app `AGENTS.md`
+or Markdown contributing page, plus the shared `documentation.ia` mirror.
+Authored records stay authoritative; missing/conflicting records become `ask_user`.
+Preset scaffolds and Feature/QA validation page templates are a later delivery;
 the IA Proposal template is available now.
 
 ## oat-docs-analyze
@@ -421,15 +424,16 @@ repair the analysis contract rather than asking apply to fill it in.
 ## oat-docs-apply
 
 **Invocation:** `/oat-docs-apply` after reviewing a docs analysis report.
-The skill loads the newest `.oat/repo/analysis/docs-*.md` report. You cannot
-select an older one, so rerun analysis if the newest report is not the one
-you reviewed. It then builds a recommendation plan and asks you to choose
+Supply the analysis artifact path and approved recommendation IDs. If no path
+is supplied, the skill offers the newest report for confirmation; it never
+silently changes the reviewed input. It builds a recommendation plan and asks you to choose
 `apply all`, `apply interactively` (approve, modify, or skip each item), or
 `discuss` before changing anything.
 
 **Prerequisites:** A recent, complete docs analysis artifact and an unchanged
 compatible target. Recommendations need evidence, confidence, disclosure,
-and concrete link targets where applicable. Apply also needs `jq` for
+stable unique IDs, `approval: explicit | default`, and concrete link targets
+where applicable. Apply also needs `jq` for
 tracking updates, and `gh` only if you want it to open the pull request. No
 active OAT project is required. Missing analysis or a changed target requires a fresh analysis,
 not conventions invented during apply.
@@ -442,9 +446,12 @@ execute those selected actions without broadening the work to every finding.
 
 **Expected output:** Approved changes committed on a new
 `oat/docs-<timestamp>` branch, relevant source/link checks, and declared
-navigation or generated-artifact refreshes. Markdown retains its authored
+navigation or generated-artifact refreshes, plus a structured result listing
+applied, skipped (ID/reason), and failed IDs. Markdown retains its authored
 index and needs no framework build or nav sync; Fumadocs sidebar metadata is
-regenerated from approved Contents changes, never hand-edited. The summary
+regenerated only with recorded `navOwner: nav-sync`. Hand-authored navigation
+gets approved edits and read-only Contents membership/order comparison;
+undeclared ownership becomes `ask_user`. The summary
 reports the applied plan and checks.
 
 **What it does without asking:** Nothing changes until you approve the plan.
@@ -467,6 +474,44 @@ pull request. Rerun analysis if you need a post-apply assessment, and treat
 unapproved recommendations as remaining decisions rather than completed
 work.
 
+## Approval, IA records and restructuring
+
+Every analyze recommendation has a stable ID and `approval: explicit | default`.
+`apply all` covers only non-blocked default content repairs. Docs-package updates,
+restructure blocks and work outside Markdown scope require individual approval
+by ID; unattended runs skip explicit items even when their IDs were supplied,
+with reason `explicit_requires_interactive_approval`. Kickoff consent is not
+approval of every finding. Bootstrap Step 7b uses this same artifact-plus-ID
+handoff, and apply reports unsupported scaffold work as `manual`.
+
+An approved IA record first checks target-repo PJM adoption with `oat pjm doctor
+--json`; absent/partial adoption needs initialization before `oat decision new`.
+The decision and authored section capture tracks, per-track organizing
+principles, placement and verification overlay. Config mirrors the accepted
+record without replacing it. Framework sidebar ownership is independent; Markdown
+creates no docs-root AGENTS file and runs no nav sync.
+
+A `restructure` block records source→destination mappings, both parent Contents
+changes, grep-derived inbound-link rewrites, and old-URL recovery, then lands as
+one exact-path commit per approved block. Retired pages retain a stub/archive
+pointer and parent map update. Next static export cannot use Next config
+redirects; choose an authored stub or verified host recovery, keeping unsupported
+app/host changes manual. Check rewritten relative links/anchors and the old route
+under the real base path; verify according to sidebar ownership and rerun analyze.
+
+Analyze also audits Information Architecture Fit and declared Product, QA,
+consumer and agent coverage. A top-level misroute is High when it blocks normal
+first success/verification, Medium when it causes material detours; cosmetic
+organization stays Low. Missing IA/owner raises `ask_user`.
+
+For framework apps, offline drift compares installed `@open-agent-toolkit/docs-*` packages to the
+running CLI's bundled `public-package-versions.json`, never registry latest.
+Missing installations are unverified. The recommendation includes the exact
+upgrade command. Individual tooling approval permits only docs-app `@open-agent-toolkit/docs-*`
+dependency bumps (and resulting lockfile), the admonition/frontmatter conversions
+already supported by `oat docs migrate`, and build verification. App config,
+routes and package scripts remain manual required changes.
+
 ## Related docs
 
 - [`commands.md`](commands.md)

package/assets/docs/reference/cli-reference.md

@@ -233,7 +233,7 @@ Notable commands introduced in the current CLI surface:
 - `--local` — write to or remove from `.oat/config.local.json` (per-developer repo state, gitignored)
 - `--user` — write to or remove from `~/.oat/config.json` (user-level fallback, applies across all repos)
 
-When no flag is passed, the CLI picks a sensible default per key type: structural keys (`projects.root`, `documentation.*`, etc.) go to shared, state keys (`activeProject`, etc.) go to local, workflow preferences (`workflow.*`) go to local. Pass at most one flag — the command rejects multiple surface flags. `documentation.guidance` is shared by default and also accepts `--user`; use a path/URL string or a JSON string array, not a comma-separated list.
+When no flag is passed, the CLI picks a sensible default per key type: structural keys (`projects.root`, `documentation.*`, etc.) go to shared, state keys (`activeProject`, etc.) go to local, workflow preferences (`workflow.*`) go to local. Pass at most one flag — the command rejects multiple surface flags. `documentation.guidance` is shared by default and also accepts `--user`; use a path/URL string or a JSON string array, not a comma-separated list. `documentation.ia` accepts the [recorded IA JSON shape](configuration.md#shared-repo-config-you-will-touch-most-often) and `documentation.navOwner` accepts `nav-sync` or `hand-authored`; both are shared-only. Unset owner means undeclared, and Markdown ignores it. IA is an atomic value in get/dump, not a set of separately configurable child keys.
 
 Per-key restrictions apply identically to `set` and `unset`: structural keys can only be written at shared scope, most state keys can only be written at local scope (`activeIdea` is the exception — it accepts both local and user), and workflow preference keys accept any non-auto surface. Legacy `autoReviewAtCheckpoints` remains shared-only; prefer `workflow.autoReviewAtHillCheckpoints`.
 

package/assets/docs/reference/configuration.md

@@ -94,6 +94,8 @@ Common keys in `.oat/config.json`:
 - `worktrees.root` — where OAT-managed worktrees live
 - `git.defaultBranch` — base branch fallback for PR workflows
 - `documentation.root`, `documentation.tooling`, `documentation.config` — docs-surface ownership. With tooling `markdown`, root is the literal content directory (including nested `docs`) and `documentation.index` is authored `<root>/index.md`; Markdown adds no framework config. Framework roots retain app/source semantics. Use `oat docs init --framework markdown` or explicit `--adopt` for setup; optional manifests need external output and never change the authored index. See [Documentation path resolution](oat-directory-structure.md#documentation-path-resolution)
+- `documentation.ia` — shared repository-only mirror of the accepted authored IA. Set JSON with required `preset` and repo-relative `decision`, optional `tracks: [{path, principle}]`, and optional `verification: "triad" | "agent-only" | "none"`. The decision record plus Information architecture section in framework docs-app `AGENTS.md` or Markdown contributing page remain authoritative. Use `oat config set documentation.ia '{"preset":"Flat Small","decision":".oat/repo/reference/decisions/DR-example.md","verification":"none"}'`; unset removes the mirror only. Invalid shapes/paths are rejected; neither `--user` nor `--local` is supported.
+- `documentation.navOwner` — shared `nav-sync | hand-authored`, independent of recorded IA, for Fumadocs/MkDocs only. Set with `oat config set documentation.navOwner hand-authored`. Absent is undeclared (`get --json` reports null/default), never implied nav-sync; analyze asks the operator and no automatic regeneration is authorized. Markdown ignores this field. This config support does not change CLI scaffold defaults or explicit nav-sync command behavior.
 - `documentation.guidance` — advisory Markdown IA source paths/URLs, as a string or ordered non-empty string array. Repo config overrides user config; explicit skill input overrides both. Absent values use the installed `authoring-docs` IA reference. Use `oat config set documentation.guidance ./docs/ia/index.md` or `oat config set documentation.guidance '["~/guidance/index.md","https://example.com/docs/index.md"]' --user`. Arrays retain order; commas in paths are literal. `--local` is unsupported. `get --json` reports `shared`, `user`, or `default` provenance; `unset` reveals the next tier. Only locators are stored, with unrelated config fields preserved. Sources stay read-only, external packs have `index.md` and `## Contents`, and local AGENTS/contributing rules remain authoritative. Conflicts become `ask_user`. See [IA selection](../docs-tooling/workflows.md#ia-selection-and-guidance).
 - `documentation.excludes` — a JSON array of globs, relative to the docs directory, that `oat docs generate-index` leaves out of the generated index. `oat config set` takes the list as one comma-separated value (`"a/**,b.md"`) and stores it as an array; repeated `--exclude` flags extend it, and an empty value clears the key
 - `documentation.requireForProjectCompletion` — whether docs sync is a completion gate

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.3.24",
-  "docs-config": "0.3.24",
-  "docs-theme": "0.3.24",
-  "docs-transforms": "0.3.24"
+  "cli": "0.3.25",
+  "docs-config": "0.3.25",
+  "docs-theme": "0.3.25",
+  "docs-transforms": "0.3.25"
 }

package/assets/skills/oat-docs-analyze/SKILL.md

@@ -6,7 +6,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Bash(oat config:*), Bash(oat docs nav sync --check:*), Bash(pnpm:*), Bash(bash:*), Bash(jq:*), Bash(node:*), Bash(mkdir:*), Bash(date:*), Bash(echo:*), Bash(cd:*), Bash(pwd:*), Glob, Grep, AskUserQuestion, Task
 metadata:
-  version: '1.7.0'
+  version: '1.7.1'
 ---
 
 # Docs Analysis
@@ -115,8 +115,9 @@ Use the five axes before presets and show two plausible two-level trees with
 5–8 representative page placements each, page jobs, nearest approved presets
 and tradeoffs. A UI alone does not justify Product/Engineering/QA; size chooses
 depth, not audience. For an existing tree respect AGENTS/contributing authority;
-conflicts are `ask_user`, with both source citations. Propose only: no IA
-persistence, restructure action or scaffold materialization in this stage.
+conflicts are `ask_user`, with both source citations. Analyze remains read-only:
+propose `record-ia` or `restructure` recommendations for apply; never persist
+IA or materialize scaffolds from analysis.
 
 ### Step 0: Resolve Docs Target and Analysis Mode
 
@@ -317,6 +318,37 @@ For each evaluated page or directory:
 In `delta` mode, always evaluate changed docs files plus the nearest parent `index.md` pages.
 In `full` mode, evaluate the whole docs surface.
 
+### Information Architecture Fit
+
+Read the authored IA decision and `## Information architecture` section in the
+docs-app AGENTS.md (Fumadocs/MkDocs) or contributing page (Markdown).
+`documentation.ia` is a repository-only mirror: compare preset, decision path,
+tracks/principles and verification overlay to those authored sources. The
+authored record is authoritative; missing/broken records or contradictory
+mirrors become `ask_user` findings. No recorded IA means `ask_user` to choose
+and record one, not an inferred preset. Keep ordinary contract analysis useful
+while those recommendations are blocked.
+
+In the artifact's **Information Architecture Fit** section, cite whether the
+landing page routes each declared audience, all declared sections exist and are
+reachable, page reader/purpose matches placement, root breadth is usable, and an
+app's docs avoid merely mirroring implementation directories. Review coverage
+only for declared readers: Product features/journeys/screens/states; QA scenario
+tables with seeds and automation references; consumer first-success/task guides;
+agent entrypoints, canonical sources and verification commands. Do not demand
+these tracks from every repository or implement the later P24 source checks.
+
+Top-level IA misroutes a declared audience: `High` when the reader cannot find
+a normal first-success or required verification path; `Medium` when that path
+is reachable but its placement causes material detours/confusion. Cite the
+declared audience, route and concrete reader impact. This rule overrides Low
+organization polish; do not upgrade purely cosmetic differences.
+
+For framework apps read `documentation.navOwner` independently of IA. Missing
+means **undeclared**: issue `ask_user` to choose `nav-sync` or `hand-authored`,
+and run only read-only membership/order comparisons. Never assume nav sync owns
+existing navigation. Markdown ignores navOwner and never runs nav sync.
+
 ### Step 4: Verify Substantive Claims Against Repo Sources
 
 Add a dedicated accuracy verification pass between page-quality assessment and nav/drift checks.
@@ -438,8 +470,8 @@ If a generated root index or manifest exists:
    files, and representative links for each finding.
 5. Prefer source-of-truth fixes over generated-file edits.
 
-If the app is Fumadocs (a `source.config.ts` beside `docs/`), its sidebar comes from
-`docs/**/meta.json` files that `oat docs nav sync` generates from `## Contents`:
+For a Fumadocs app with recorded `navOwner: nav-sync`, compare generated
+`docs/**/meta.json` with authored `## Contents`:
 
 1. Flag a docs directory with an `index.md` but no `meta.json` as a missing
    generated artifact.
@@ -463,6 +495,13 @@ If the app is Fumadocs (a `source.config.ts` beside `docs/`), its sidebar comes
    1 when either exists. The skill grants only this `--check` form; plain
    `oat docs nav sync` writes files and is not part of analysis.
 
+For `hand-authored` or undeclared Fumadocs navigation, compare current meta.json
+membership/order with Contents without assuming strict generator output; do not
+flag rest entries merely because they are hand-authored. Report missing reader
+routes and differences with local ownership evidence; recommend no automatic
+regeneration. For nav-sync-owned MkDocs, use the same explicit-target read-only
+`oat docs nav sync --check --target-dir <docs-app-dir>`.
+
 If `mkdocs.yml` exists:
 
 1. Compare nav entries with the docs tree.
@@ -476,6 +515,53 @@ site nav generation or builds. Lack of `mkdocs.yml`, a generated manifest, or an
 app package is expected, not a migration finding. For other unconfigured surfaces,
 record whether app migration is relevant only when evidence or user intent supports it.
 
+### Offline docs-package drift
+
+For framework apps read their package.json and installed docs packages against
+the running CLI's bundled `assets/public-package-versions.json`, without network.
+Run this skill's production helper after resolving this skill's own directory:
+
+```bash
+node "$SKILL_DIR/scripts/package-drift.mjs" --app "<docs-app-dir>" --cli "$(command -v oat)"
+```
+
+If a package-manager wrapper prevents locating the CLI root, discover the bundle
+from that invoked installation offline. Inspect `command -v oat` and, for a shell
+shim, read its `exec` lines or `cmd-shim-target` comment (for example,
+`sed -n '1,160p' "$(command -v oat)"`). Resolve a relative JavaScript target from
+the shim's directory; do not evaluate copied shell text. Locate that target's
+package root containing `package.json` named `@open-agent-toolkit/cli` and
+`assets/public-package-versions.json`. `pnpm root -g` or `npm root -g` can help
+locate it, but newer pnpm installations may nest it in a hashed directory; use
+the actual shim target, never another checkout's bundle. Bind the inspected paths:
+
+```bash
+OAT_INSTALLED_ENTRY="<absolute JavaScript target from the invoked shim>"
+OAT_INSTALLED_ROOT="<that installed @open-agent-toolkit/cli package root>"
+# Both must equal the invoked oat version; stop if either differs.
+test "$(node "$OAT_INSTALLED_ENTRY" --version)" = "$(oat --version)" &&
+  test "$(node -p 'JSON.parse(require("node:fs").readFileSync(process.argv[1], "utf8")).version' "$OAT_INSTALLED_ROOT/package.json")" = "$(oat --version)" &&
+  node "$SKILL_DIR/scripts/package-drift.mjs" --app "<docs-app-dir>" --versions "$OAT_INSTALLED_ROOT/assets/public-package-versions.json"
+```
+
+Never substitute registry latest or this target repo's package version. Missing
+bundle metadata, missing installed packages, or non-orderable versions (including
+prereleases) mean unverified, never an upgrade. The helper compares stable numeric
+version components: older installed packages are `drift`; equal versions are
+`current`; newer installed packages are `ahead`, with no upgrade command. For
+`ahead`, report that the running CLI is stale and ask the operator to update or
+select the intended CLI installation before re-analysis; do not recommend a docs
+package downgrade. `unverified` also has no package command and needs manual
+verification. Neither status authorizes a tooling update.
+
+The helper reports declared and installed versions, target versions and commands
+for orderable targets. If the app uses a different package manager, translate the
+command to its documented equivalent preserving package, exact target and
+dependency section. Cite the manifest, installed package path, bundle path and
+exact command. Report older-package drift as `tooling-update`, `approval: explicit`;
+describe unsupported scaffold repairs separately as `manual`. Markdown has no
+app-package drift check. This helper reads only and never upgrades anything.
+
 ### Step 7: Severity-Rate Findings
 
 Use these defaults:
@@ -485,6 +571,19 @@ Use these defaults:
 - `Medium`: incomplete `## Contents`, `overview.md` still in use, plugin/contributor guidance gaps, moderate duplication
 - `Low`: polish, wording, or organization improvements
 
+### Recommendation handoff
+
+Give every recommendation a unique stable ID (`R-001`, etc.) and
+`approval: explicit | default`; preserve IDs through review and never reuse a
+retired ID for a different change. `explicit` covers docs-package updates,
+restructure blocks and anything outside the Markdown scope (including authored
+IA decision/config writes). `default` covers ordinary in-scope content repairs.
+Missing evidence, `omit` and `ask_user` remain independent blockers regardless
+of approval class. Capture exact targets and commands; an explicit class is not
+permission to perform unsupported work. Apply's one input is this artifact plus
+a list of approved recommendation IDs. Blanket or unattended approval never
+covers explicit recommendations; apply reports skipped IDs with reasons.
+
 ### Step 8: Write Analysis Artifact
 
 Use `references/analysis-artifact-template.md`.
@@ -506,7 +605,8 @@ Populate the artifact with:
 - Accuracy verification verdicts for repo-checkable claims
 - Content opportunities for missing or thin docs coverage
 - Navigation/drift findings
-- Ordered recommendations
+- Information Architecture Fit and offline package drift
+- Ordered recommendations with stable IDs and approval classes
 - Exact evidence references for each finding and recommendation
 - Confidence for each recommendation
 - Progressive disclosure decisions (`inline`, `link_only`, `omit`, `ask_user`)

package/assets/skills/oat-docs-analyze/references/analysis-artifact-template.md

@@ -27,6 +27,39 @@ oat_analysis_commit: { commitHash }
 
 Do not copy private guidance contents or persist an IA decision from this report.
 
+## Information Architecture Fit
+
+- Authored decision and Information architecture section: {paths/lines or missing}
+- Config mirror: {preset, decision, tracks/principles, verification; agrees/conflicts}
+- Missing IA / conflicting authority: {ask_user recommendation ID or none}
+- Sidebar owner: {nav-sync / hand-authored / undeclared; Markdown: ignored}
+- Undeclared framework owner: {ask_user recommendation ID or none}
+
+| Declared reader/track                                    | Landing route and section reachability | Placement/coverage evidence               | Reader impact                                                  | Severity              |
+| -------------------------------------------------------- | -------------------------------------- | ----------------------------------------- | -------------------------------------------------------------- | --------------------- |
+| {Product / QA / consumer / agent / other declared track} | {exact links}                          | {sources; page purpose; missing coverage} | {blocked first success/verification, material detour, or none} | {High / Medium / N/A} |
+
+Assess root breadth and implementation-directory mirroring using reader evidence.
+Do not invent missing audiences or choose an IA without approval.
+
+## Offline Package Drift
+
+- Bundle metadata: {running CLI public-package-versions.json path or unverified}
+- Docs app manifest: {path; Markdown: not applicable}
+
+| Package                       | Declared / installed                | Bundled   | Status                                 | Exact upgrade command                                                          | Recommendation ID                                       |
+| ----------------------------- | ----------------------------------- | --------- | -------------------------------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------- |
+| {@open-agent-toolkit/docs-\*} | {range / actual version or missing} | {version} | {current / drift / ahead / unverified} | {drift only: helper upgrade command adapted to actual manager; otherwise none} | {drift only: R-NNN; approval: explicit; otherwise none} |
+
+Only older installed packages (`drift`) receive a package-upgrade command and
+stable recommendation ID with `approval: explicit`. `current` needs no tooling
+recommendation, even if the helper emits a reinstall command. For `ahead`, select
+or update the intended CLI installation, then re-analyze; do not recommend a docs
+package downgrade. `unverified` requires manual verification before a package
+recommendation.
+
+Unsupported app config/routes/scripts: {manual changes required; never automatic}.
+
 ## Summary
 
 - **Files evaluated:** {N}
@@ -270,14 +303,18 @@ canonical docs/config/examples.
 
 1. **{Action}** — {rationale}
    - Target: `{path}`
-   - Action Type: {create / update / move / scaffold / sync-nav}
+   - ID: {R-NNN; unique and stable}
+   - approval: {explicit | default}
+   - Action Type: {create / update / move / scaffold / sync-nav / record-ia / restructure / tooling-update / manual}
    - Evidence: {exact refs}
    - Confidence: {high | medium | low}
    - Disclosure: {inline | link_only | omit | ask_user}
    - Link Targets: {path or URL / N/A}
 2. **{Action}** — {rationale}
    - Target: `{path}`
-   - Action Type: {create / update / move / scaffold / sync-nav}
+   - ID: {R-NNN; unique and stable}
+   - approval: {explicit | default}
+   - Action Type: {create / update / move / scaffold / sync-nav / record-ia / restructure / tooling-update / manual}
    - Evidence: {exact refs}
    - Confidence: {high | medium | low}
    - Disclosure: {inline | link_only | omit | ask_user}
@@ -286,6 +323,9 @@ canonical docs/config/examples.
 
 ## Apply Contract
 
+- `oat-docs-apply` input is this artifact path plus approved recommendation IDs.
+- Every recommendation has a unique stable ID and approval: explicit | default.
+- Explicit items need individual approval by ID; blanket/unattended approval skips them and reports the reason.
 - `oat-docs-apply` may only implement recommendations backed by evidence in this artifact.
 - Findings based on contradicted claims must be resolved against cited repo sources before `oat-docs-apply` acts on them.
 - Generated artifacts must not be hand-edited by `oat-docs-apply`. If a

package/assets/skills/oat-docs-analyze/scripts/package-drift.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+// Read-only, offline comparison used by oat-docs-analyze. No package resolution or install.
+import { readFile, realpath } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+
+const shellQuote = (value) =>
+  `'${value.replaceAll("'", String.fromCharCode(39, 92, 39, 39))}'`;
+
+async function versionsForCli(executable) {
+  if (!executable)
+    throw new Error(
+      'Provide --cli with the installed oat executable or --versions with its bundled public-package-versions.json.',
+    );
+  let directory = dirname(await realpath(executable));
+  for (;;) {
+    try {
+      const pkg = JSON.parse(
+        await readFile(join(directory, 'package.json'), 'utf8'),
+      );
+      if (pkg.name === '@open-agent-toolkit/cli')
+        return join(directory, 'assets/public-package-versions.json');
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+    }
+    const parent = dirname(directory);
+    if (parent === directory)
+      throw new Error(
+        'Cannot locate the running CLI bundle through this wrapper; supply --versions from that installed CLI.',
+      );
+    directory = parent;
+  }
+}
+
+try {
+  const { values } = parseArgs({
+    options: {
+      app: { type: 'string' },
+      versions: { type: 'string' },
+      cli: { type: 'string' },
+    },
+  });
+  if (!values.app) throw new Error('Required: --app <docs-app-directory>.');
+  const versionsPath = resolve(
+    values.versions ?? (await versionsForCli(values.cli)),
+  );
+  const versions = JSON.parse(await readFile(versionsPath, 'utf8'));
+  const appPath = resolve(values.app);
+  const manifest = JSON.parse(
+    await readFile(join(appPath, 'package.json'), 'utf8'),
+  );
+  const packages = [];
+  for (const section of [
+    'dependencies',
+    'devDependencies',
+    'optionalDependencies',
+  ]) {
+    for (const [name, declared] of Object.entries(manifest[section] ?? {})) {
+      if (
+        ![
+          '@open-agent-toolkit/docs-config',
+          '@open-agent-toolkit/docs-theme',
+          '@open-agent-toolkit/docs-transforms',
+        ].includes(name)
+      )
+        continue;
+      const bundled = versions[name.slice('@open-agent-toolkit/'.length)];
+      if (
+        typeof bundled !== 'string' ||
+        !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(bundled)
+      )
+        throw new Error(`Missing/invalid bundled version for ${name}.`);
+      // Report installed package bytes when available, not just a declared range.
+      let installed = null;
+      try {
+        const installedManifest = JSON.parse(
+          await readFile(
+            join(appPath, 'node_modules', name, 'package.json'),
+            'utf8',
+          ),
+        );
+        if (typeof installedManifest.version !== 'string')
+          throw new Error(`Invalid installed version for ${name}.`);
+        installed = installedManifest.version;
+      } catch (error) {
+        if (error.code !== 'ENOENT') throw error;
+      }
+      // Only stable numeric releases are orderable here; prereleases and other
+      // package-manager version forms need manual verification, never an upgrade.
+      const stable = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+      let status = 'unverified';
+      if (
+        installed !== null &&
+        stable.test(installed) &&
+        stable.test(bundled)
+      ) {
+        const left = installed.split('.').map(BigInt);
+        const right = bundled.split('.').map(BigInt);
+        const differing = left.findIndex(
+          (part, index) => part !== right[index],
+        );
+        status =
+          differing === -1
+            ? 'current'
+            : left[differing] < right[differing]
+              ? 'drift'
+              : 'ahead';
+      }
+      packages.push({
+        name,
+        section,
+        declared,
+        installed,
+        bundled,
+        status,
+        upgradeCommand:
+          status === 'drift' || status === 'current'
+            ? `pnpm --dir ${shellQuote(appPath)} add${section === 'devDependencies' ? ' --save-dev' : section === 'optionalDependencies' ? ' --save-optional' : ''} ${name}@${bundled}`
+            : null,
+      });
+    }
+  }
+  process.stdout.write(
+    `${JSON.stringify({ versionsPath, appPath, packages }, null, 2)}\n`,
+  );
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = 1;
+}

package/assets/skills/oat-docs-apply/SKILL.md

@@ -5,7 +5,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Edit, Bash(git:*), Bash(gh:*), Bash(oat:*), Bash(pnpm:*), Bash(bash:*), Bash(jq:*), Bash(mkdir:*), Bash(date:*), Bash(echo:*), Bash(cd:*), Bash(pwd:*), Glob, Grep, AskUserQuestion
 metadata:
-  version: '1.4.5'
+  version: '1.4.6'
 ---
 
 # Docs Apply
@@ -33,12 +33,12 @@ Before a parent-branch commit, verify `oat internal commit-paths --help` succeed
 
 - No unapproved documentation changes.
 - No branch creation before the recommendation plan is reviewed.
-- No changes outside the documentation scope except deterministic nav sync and tracking updates.
+- No changes outside the documentation scope except the approved IA record/config mirrors, owner-authorized nav sync, tracking updates, and the individually approved tooling-update carve-out below.
 
 **ALLOWED Activities:**
 
 - Reading analysis artifacts and the current docs surface.
-- Creating or updating docs files and `mkdocs.yml` when approved. Fumadocs `meta.json` files change only through `oat docs nav sync`.
+- Creating or updating docs files and hand-authored navigation when approved. Nav-sync-owned navigation changes only through `oat docs nav sync`; undeclared ownership blocks regeneration.
 - Running `oat docs nav sync` after approved structural changes.
 - Creating branches, commits, and optional PRs.
 
@@ -93,7 +93,13 @@ When executing this skill, provide lightweight progress feedback so the user can
 
 ### Step 0: Intake - Find Analysis Artifact
 
-Locate the most recent docs analysis artifact:
+The one input is an **analysis artifact path plus approved recommendation IDs**.
+Accept an explicitly supplied artifact; when none is supplied, offer the newest
+artifact below and confirm that it is the reviewed input. Never silently switch
+to a newer artifact after approval. IDs identify recommendations within that
+artifact, remain stable through artifact review, and are never reassigned.
+
+Locate a candidate when no artifact path was supplied:
 
 ```bash
 ls -t .oat/repo/analysis/docs-*.md 2>/dev/null | head -1
@@ -103,6 +109,8 @@ If none exists, stop and instruct the user to run `oat-docs-analyze`.
 
 Validate that each recommendation in the artifact includes:
 
+- a unique stable ID (for example `R-001`)
+- `approval: explicit | default`
 - evidence
 - confidence
 - disclosure
@@ -158,9 +166,19 @@ For review-mode and follow-up decisions, use host-aware prompting:
 
 If the user chooses `apply all`:
 
-- confirm the full plan
-- capture any global notes that apply across the whole plan
-- treat all non-blocked recommendations as approved unless the user names exceptions
+- confirm the full plan and capture global notes
+- approve only non-blocked `approval: default` recommendations, excluding named exceptions
+- Blanket approval never approves an `approval: explicit` recommendation.
+- Ask for individual approval by recommendation ID for each explicit item. A
+  restructure block always needs its own approval, including its full map and
+  old-URL plan; approving a different block does not approve it.
+
+In unattended mode, skip every explicit recommendation even when an input list
+names its ID; report `explicit_requires_interactive_approval` in the structured
+result. Never interpret automation configuration or `apply all` as individual
+approval. Missing/unknown approval classes or duplicate/unknown IDs block intake.
+The approved-ID list is captured at this approval step, not inferred from prose.
+An input list alone does not prove individual approval for an explicit item.
 
 If the user chooses `apply interactively`, ask for each recommendation:
 
@@ -174,11 +192,12 @@ If the user chooses `discuss`, answer questions, revise the plan if needed, and
 - `apply interactively`
 - `discuss`
 
-If all recommendations are skipped, stop without changing files.
+If all recommendations are skipped, emit the structured result with reasons and stop without changing files.
 
 Build an `APPLIED_PLAN_DETAILS` block from approved or modified recommendations with:
 
 - recommendation id
+- approval class and individual approval evidence when required
 - action
 - target path
 - disclosure
@@ -216,7 +235,7 @@ locators/provenance into the apply plan; do not silently re-resolve different
 sources. Verify cited inputs still exist and remain read-only outside the repo.
 Local AGENTS/contributing rules stay authoritative; a conflict is `ask_user`
 and blocks that recommendation pending a fresh analysis/user decision. Cite
-sources without copying private contents. This hook adds no restructure action.
+sources without copying private contents.
 
 Before the first approved write, initialize `OWNED_OUTPUT_FILES=()`. Append
 each exact successfully created, modified or removed path at that write,
@@ -235,10 +254,87 @@ For each approved recommendation:
    - `omit` -> do not encode the item in the docs change
    - `ask_user` -> require explicit user confirmation before writing
 
+#### Record an accepted IA
+
+Only an approved `record-ia` recommendation authorizes persistence. Before any
+PJM/decision write run `oat pjm doctor --json` in the target repo and inspect
+`adoption.state`; absent/partial adoption routes to `oat pjm init` before the
+record, never silently writes an unmanaged decision. Read the target's
+`.oat/repo/AGENTS.md`, decision conventions and existing decision index; update
+an existing matching record rather than duplicate it. Create a new record with
+`oat decision new "Documentation information architecture" --status accepted
+--context "<approved evidence>"` and its supported `--decision`/`--consequences` options
+(check `--help`). The command owns index generation; never hand-edit the index.
+
+Write a short `## Information architecture` section with tracks, organizing
+principle per track, placement rules and verification overlay. For Fumadocs and
+MkDocs put it in the docs-app `AGENTS.md`, preserving existing guidance. For
+Markdown put it in the contributing page; create no docs-root `AGENTS.md`.
+Link the decision and authored section reciprocally. They remain authoritative;
+a conflict with config becomes `ask_user`, never a config-driven rewrite.
+
+Mirror the accepted record using shared repo config only:
+`oat config set documentation.ia '<JSON>'`, with exactly `{preset, decision,
+tracks?: [{path, principle}], verification?: 'triad'|'agent-only'|'none'}`.
+`decision` is repo-relative; preserve guidance and unrelated config. For a
+framework surface, separately record the operator's approved sidebar owner via
+`oat config set documentation.navOwner nav-sync` or `hand-authored`. Missing
+ownership stays undeclared and blocks automatic regeneration. Markdown ignores
+navOwner and never runs nav sync. New-scaffold default ownership and preset
+materialization are not implemented by this persistence step.
+
+#### Restructure one approved block
+
+`restructure` requires `approval: explicit` and one individual approval per
+block before any move. Use the apply-plan block: source→destination map, source
+and destination parent Contents edits, grep-derived inbound references (including
+relative links, anchors and assets), exact rewrite list, and old-URL recovery.
+Search the whole repo for each old path/basename with `rg`; resolve relative
+references from their original file and check them again from their new location.
+Keep links to moved headings working. Do not treat search hits in examples or
+unrelated same-name files as automatic rewrites.
+
+Choose recovery supported by the actual deployment: Next static export does
+not support Next config redirects (see [Next static-export unsupported features](https://nextjs.org/docs/app/guides/static-exports#unsupported-features)).
+Use an authored stub at the old route with a relative pointer, or an approved
+archive pointer; a redirect requires verified framework/host support and stays
+manual when it needs app/host config. Never edit `not-found.tsx` through this
+carve-out. Retired pages retain a stub/archive pointer and a parent Contents
+update, never a silent delete. Preserve stub routes in the approved reader map
+where the framework needs them to build.
+
+Apply one block as one exact-path implementation commit; do not combine it with
+another block. Validate all rewritten inbound links and old URLs under the
+actual base path. With `navOwner: nav-sync`, run nav sync then nav sync --check
+with the explicit app target. With `hand-authored`, update approved hand-authored
+navigation and compare membership/order against Contents read-only; never run a
+writing nav sync. With undeclared ownership, report `ask_user` before navigation
+writes. Markdown checks files/Contents/links only. Re-run `oat-docs-analyze`
+after each block, preserving residual findings instead of claiming a clean run.
+
+#### Individually approved tooling update
+
+A `tooling-update` recommendation has `approval: explicit`. Even with individual
+approval, its out-of-Markdown allowance is only these three operations:
+
+1. Bump the docs app's existing `@open-agent-toolkit/docs-*` dependencies to the
+   bundled versions using the artifact's exact upgrade command (preserve dependency
+   section and package manager; include its resulting lockfile only). Never downgrade
+   an installed version: `ahead` or `unverified` requires CLI selection/update or
+   manual verification before re-analysis, not a docs-package tooling update.
+2. Run `oat docs migrate --docs-dir <authored-root> --apply` only for its currently
+   supported admonition conversions and injected frontmatter; inspect the diff.
+3. Run the docs build verifier from the app's existing scripts.
+
+Scaffold changes the CLI cannot make (app config, routes, package scripts) are
+`manual`: report the required change and ID without editing those files. This
+allowance does not permit application dependencies, host settings, arbitrary
+migrations or an app-shell rebuild. Other out-of-scope prohibitions remain.
+
 When approved actions involve docs app creation or nav updates:
 
 - Use `oat docs init` for scaffolding when appropriate.
-- Use `oat docs nav sync` instead of manually editing nav when the CLI helper can generate it. In Fumadocs apps it writes strict `meta.json` files and reports pages no `## Contents` map lists (`unlisted` in `--json`); resolve a reported page through an approved `## Contents` change, never by hand-editing `meta.json`.
+- Use `oat docs nav sync` instead of manually editing nav only when recorded `navOwner: nav-sync` authorizes it. In Fumadocs apps it writes strict `meta.json` files and reports pages no `## Contents` map lists (`unlisted` in `--json`); resolve a reported page through an approved `## Contents` change, never by hand-editing `meta.json`.
 
 Negative rules:
 
@@ -261,7 +357,7 @@ full configured content tree; keep the authored config index unchanged.
 For framework apps, discover actual scripts and run the smallest relevant
 verification set based on what changed; these examples apply only when present:
 
-- `oat docs nav sync`
+- `oat docs nav sync --target-dir <docs-app>` then `--check` only for `nav-sync` ownership; hand-authored/undeclared navigation gets read-only Contents membership/order comparison
 - `pnpm --dir <docs-app> docs:lint` (no-op when no linter is configured)
 - `pnpm --dir <docs-app> docs:format:check`
 - `pnpm --dir <docs-app> docs:build`
@@ -270,7 +366,7 @@ If no docs app exists yet, use file-level verification and confirm the structura
 
 ### Step 6: Commit and PR
 
-Commit the approved changes:
+Commit the approved changes (for restructure, repeat with one retained identity and exact path list per approved block; exclude already committed blocks from any final aggregate commit and skip an empty aggregate):
 
 ```bash
 OWNED_COMMIT_PATHS=("${OWNED_OUTPUT_FILES[@]}")
@@ -344,6 +440,29 @@ PR creation failed. To create manually:
 
 ### Step 7: Update Tracking and Output Summary
 
+Always emit this structured result, including no-op/unattended runs. Each input
+recommendation ID appears in exactly one outcome; failed verification is a
+failure, never an applied success. Unsupported scaffold work is skipped with
+reason `manual` and its required change. Include individual approval evidence
+in the plan, not invented in this result.
+
+```json
+{
+  "analysisArtifact": ".oat/repo/analysis/docs-example.md",
+  "approvedRecommendationIds": ["R-001"],
+  "applied": ["R-001"],
+  "skipped": [
+    { "id": "R-002", "reason": "explicit_requires_interactive_approval" }
+  ],
+  "failed": []
+}
+```
+
+Failed entries use `{ "id": "R-003", "reason": "<verification/error>" }`.
+Report partial writes and stop on a failure; never continue by widening scope.
+
+### Tracking and summary
+
 Update shared tracking:
 
 ```bash

package/assets/skills/oat-docs-apply/references/apply-plan-template.md

@@ -25,7 +25,7 @@ Keep the analysis selection; do not copy private contents or invent missing evid
 
 Review the full recommendation set first, then choose a review mode:
 
-- **apply all** — approve the full set as presented
+- **apply all** — approve non-blocked default items; explicit items require individual approval by ID
 - **apply interactively** — review recommendation by recommendation
 - **discuss** — pause to talk through the plan before approving
 
@@ -41,19 +41,21 @@ blocked pending a fresh analysis rather than guessed.
 
 ## Recommendations
 
-### {N}. {Action}: `{target-path}`
-
-| Field        | Value                                                             |
-| ------------ | ----------------------------------------------------------------- |
-| Action       | {create / update / move / scaffold / sync-nav}                    |
-| Target       | `{target-path}`                                                   |
-| Rationale    | {why this recommendation exists}                                  |
-| Source       | {finding # / contract gap / nav issue}                            |
-| Evidence     | {exact file refs / config / docs that justify the recommendation} |
-| Confidence   | {high / medium / low}                                             |
-| Disclosure   | {inline / link_only / omit / ask_user}                            |
-| Link Targets | {path or URL when link_only; otherwise N/A}                       |
-| Helper       | `oat docs nav sync` / `oat docs init` / `manual edit`             |
+### {R-NNN}. {Action}: `{target-path}`
+
+| Field        | Value                                                                                              |
+| ------------ | -------------------------------------------------------------------------------------------------- |
+| ID           | {R-NNN; stable within the source artifact}                                                         |
+| approval     | {explicit / default; never inferred from blanket consent}                                          |
+| Action       | {create / update / move / scaffold / sync-nav / record-ia / restructure / tooling-update / manual} |
+| Target       | `{target-path}`                                                                                    |
+| Rationale    | {why this recommendation exists}                                                                   |
+| Source       | {finding # / contract gap / nav issue}                                                             |
+| Evidence     | {exact file refs / config / docs that justify the recommendation}                                  |
+| Confidence   | {high / medium / low}                                                                              |
+| Disclosure   | {inline / link_only / omit / ask_user}                                                             |
+| Link Targets | {path or URL when link_only; otherwise N/A}                                                        |
+| Helper       | `oat docs nav sync` / `oat docs init` / `manual edit`                                              |
 
 **Context:** {1-2 sentences}
 
@@ -64,6 +66,29 @@ blocked pending a fresh analysis rather than guessed.
 
 {Repeat for each recommendation}
 
+## Restructure block (one individually approved ID, one exact-path commit)
+
+- ID / individual approval evidence: {R-NNN / operator choice, or pending}
+- Source → destination map: {every moved/retired page}
+- Parent Contents edits: {source and destination indexes}
+- Grep-derived inbound rewrites: {command + referring file:line + old/new link,
+  including anchors/assets and rewritten links inside moved pages}
+- Old-URL strategy: {verified host redirect, authored stub, or archive pointer;
+  static export: no assumed Next redirects}
+- Retired-page recovery: {retained stub/archive pointer + parent Contents entry}
+- Sidebar owner: {nav-sync / hand-authored / undeclared; Markdown: ignored}
+- Verification: {nav-sync write then --check, or read-only membership/order
+  comparison; file/link checks; actual base-path old URL; analyze rerun}
+- Exact owned files and commit identity: {list including both rename sides}
+
+## IA recording / tooling limits
+
+- Record IA: {adoption.state from target pjm doctor; decision command/path;
+  framework AGENTS or Markdown contributing section; shared mirror JSON}
+- Tooling update: {individually approved ID; exact docs-app docs-\* upgrade
+  command; supported migrate conversions; existing build verifier}
+- Unsupported app config/routes/scripts: {manual required changes; no edits}
+
 ## Summary of Actions
 
 | #   | Action                                 | Target   | Disclosure                       | Decision                                                 |
@@ -73,6 +98,25 @@ blocked pending a fresh analysis rather than guessed.
 
 **Total:** {N} approved, {N} modified, {N} skipped
 
+## Structured result
+
+```json
+{
+  "analysisArtifact": "{path}",
+  "approvedRecommendationIds": ["R-001"],
+  "applied": ["R-001"],
+  "skipped": [
+    { "id": "R-002", "reason": "explicit_requires_interactive_approval" }
+  ],
+  "failed": []
+}
+```
+
+Every input ID has exactly one outcome. Unattended explicit items are skipped
+regardless of the supplied ID list. Missing/unknown class or ID blocks intake.
+Use reason `manual` with the required change for unsupported scaffold work;
+failed entries carry an ID and error/verification reason.
+
 ## Proceed?
 
 Confirm to begin applying the approved documentation changes.

package/assets/skills/oat-docs-bootstrap/SKILL.md

@@ -6,7 +6,7 @@ disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
 metadata:
-  version: '1.4.0'
+  version: '1.4.1'
 ---
 
 # Docs Bootstrap
@@ -321,7 +321,7 @@ Resolution options:
     ```
 
 - **`repair`** — Fix the existing setup in place rather than replacing it. Delegate to the docs-analysis pack.
-  - **Allowed mutations (by this sub-procedure):** None directly. The bootstrap skill does not modify existing docs app files. It hands off to `oat-docs-analyze` (read-only audit) and, with user approval, to `oat-docs-apply` (applies approved recommendations).
+  - **Allowed mutations (by this sub-procedure):** None directly. The bootstrap skill does not modify existing docs app files. It hands off to `oat-docs-analyze` (read-only audit), then passes the analysis artifact plus approved recommendation IDs to `oat-docs-apply`; explicit items require individual approval.
   - **Preserved state:** Existing docs app directory, the `documentation` config section, the root `AGENTS.md` `## Documentation` section — all preserved unless analyze surfaces a recommendation and the user approves it via apply.
   - **Stop conditions:**
     - Invoke `oat-docs-analyze` and surface its report to the user. If analyze cannot produce meaningful recommendations (e.g., `documentation.index` points at a missing file, or the app directory is empty), **stop the flow before Scaffold Runner**, report what analyze found, and ask the user whether to escalate to `replace`.
@@ -390,9 +390,19 @@ through `oat-docs-analyze --ia`; it does not return to scaffold afterward.
    `ask_user` with local/external source citations. Non-repo guidance stays read-only
    and private exemplars are never copied. Cite ordered sources in the proposal
    and final summary, including the built-in path when it wins.
-6. Carry the proposal to analyze/apply content kickoff. This stage proposes only:
-   it does not persist an accepted IA, restructure pages or scaffold preset trees.
-   CLI scaffold output remains the existing starter; those capabilities ship later.
+6. Obtain explicit approval of the selected IA before persistence. After setup,
+   use apply's `record-ia` procedure: target-repo `oat pjm doctor --json` and
+   adoption check before `oat decision new`, an Information architecture section
+   in the framework docs-app AGENTS.md or Markdown contributing page, and shared
+   `documentation.ia` mirror. Preserve existing guidance; the authored record is
+   authoritative. If approval/adoption is pending, retain the proposal and report
+   it unrecorded. Do not silently initialize PJM. For an existing surface, hand
+   off an analysis artifact plus approved recommendation IDs to apply, with
+   individual approval for explicit record/restructure/tooling items.
+   This stage does not materialize preset trees or change scaffold/nav defaults.
+   Sidebar ownership is separately chosen for existing framework apps; absent
+   remains undeclared, Markdown ignores it, and no automatic nav generation is
+   authorized by IA approval alone.
 
 ### Step 3: Scaffold Runner
 
@@ -836,7 +846,13 @@ Delegate — do not re-implement analyze/apply logic here.
 
 1. Invoke the `oat-docs-analyze` skill against the scaffolded app. Pass the Inspection Result's `documentation.root` path so analyze targets the right surface. Wait for analyze to complete.
 2. Surface analyze's report to the user in its native form — do not re-summarize. The user reads it, decides which recommendations to approve.
-3. If the user approves any recommendations, invoke the `oat-docs-apply` skill with the approved subset. Wait for apply to complete.
+3. Capture the analysis artifact path and approved recommendation IDs, then
+   invoke `oat-docs-apply` with exactly that input. Preserve every approval class:
+   blanket approval covers only default items; explicit items need individual
+   approval by ID, and unattended runs skip/report them. Wait for apply's
+   structured applied/skipped-with-reason/failed IDs; report partial/manual work.
+   Never pass an unexplained "approved subset" or treat kickoff consent as
+   approval of every recommendation.
 4. Report the outcome back briefly: branch name, PR URL if opened, files changed count.
 
 If analyze produces no recommendations (the scaffold is complete and nothing's missing — unlikely on a fresh scaffold but possible), tell the user and skip apply.
@@ -867,6 +883,8 @@ Location:    {appRoot}
 Framework:   {framework}
 IA guidance: {ordered selected locators + explicit/conversation/shared/user/builtin provenance}
 IA proposal: {candidate recommendation, nearest preset, conflicts or none}
+IA record: {decision + authored section + shared mirror, or pending reason}
+Apply handoff: {artifact path, approved IDs, applied/skipped/failed result or not run}
 Config:      {configPath} (documentation section)
 
 Created:

package/dist/commands/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/config/index.js

@@ -12,7 +12,7 @@ import { normalizeDispatchMatrix, validateDispatchRouteTarget, walkDispatchMatri
 import { formatDispatchNotices, terminalReviewerNoticesForMatrix, } from '../../config/dispatch-notices.js';
 import { dispatchPolicyModeDescription, dispatchPolicyPolicyDescription, managedDispatchPolicyValueList, } from '../../config/dispatch-policy-options.js';
 import { parseJsonConfig } from '../../config/json.js';
-import { DEFAULT_INSTRUCTION_SYNC_STRATEGY, INSTRUCTION_SYNC_STRATEGIES, VALID_DISPATCH_POLICY_MODES, VALID_MANAGED_DISPATCH_POLICIES, MAX_GATE_TIMEOUT_MS, MIN_GATE_TIMEOUT_MS, isValidGateTimeoutMs, isValidProjectLogDigestBound, normalizeWorkflowPostImplementSequence, normalizeDocumentationGuidance, readOatConfig, readOatConfigForDefaultScopeRepair, readOatConfigForDocumentationExcludesRepair, readOatConfigForInstructionPointerExcludesRepair, readOatConfigForInstructionSyncStrategyRepair, readOatConfigWithWarnings, readOatLocalConfig, readUserConfig, writeOatConfig, writeOatLocalConfig, writeUserConfig, VALID_POST_IMPLEMENT_LEGACY_SEQUENCES, } from '../../config/oat-config.js';
+import { DEFAULT_INSTRUCTION_SYNC_STRATEGY, INSTRUCTION_SYNC_STRATEGIES, VALID_DISPATCH_POLICY_MODES, VALID_MANAGED_DISPATCH_POLICIES, MAX_GATE_TIMEOUT_MS, MIN_GATE_TIMEOUT_MS, isValidGateTimeoutMs, isValidProjectLogDigestBound, normalizeWorkflowPostImplementSequence, normalizeDocumentationGuidance, normalizeDocumentationIa, normalizeDocumentationNavOwner, readOatConfig, readOatConfigForDefaultScopeRepair, readOatConfigForDocumentationExcludesRepair, readOatConfigForInstructionPointerExcludesRepair, readOatConfigForInstructionSyncStrategyRepair, readOatConfigWithWarnings, readOatLocalConfig, readUserConfig, writeOatConfig, writeOatLocalConfig, writeUserConfig, VALID_POST_IMPLEMENT_LEGACY_SEQUENCES, } from '../../config/oat-config.js';
 import { getOwnKey, setOwnKey } from '../../config/own-keys.js';
 import { resolveEffectiveConfig, resolveEnvOverride, } from '../../config/resolve.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
@@ -67,6 +67,8 @@ const KEY_ORDER = [
     'archive.awsRegion',
     'autoReviewAtCheckpoints',
     'lastPausedProject',
+    'documentation.ia',
+    'documentation.navOwner',
     'documentation.guidance',
     'documentation.root',
     'documentation.tooling',
@@ -239,6 +241,28 @@ const CONFIG_CATALOG = [
         description: 'Deprecated compatibility alias for workflow.autoReviewAtHillCheckpoints. Prefer `oat config set workflow.autoReviewAtHillCheckpoints <true|false>`.',
         deprecated: { supersededBy: 'workflow.autoReviewAtHillCheckpoints' },
     },
+    {
+        key: 'documentation.ia',
+        group: 'Shared Repo (.oat/config.json)',
+        scope: 'shared repo',
+        file: '.oat/config.json',
+        type: 'JSON object',
+        defaultValue: 'null (no recorded IA)',
+        mutability: 'read/write',
+        owningCommand: 'oat config set documentation.ia <JSON>',
+        description: 'Repository mirror of authored IA: preset, repo-relative decision, optional tracks [{path, principle}] and verification (triad|agent-only|none). Authored records remain authoritative.',
+    },
+    {
+        key: 'documentation.navOwner',
+        group: 'Shared Repo (.oat/config.json)',
+        scope: 'shared repo',
+        file: '.oat/config.json',
+        type: 'nav-sync | hand-authored',
+        defaultValue: 'null (undeclared)',
+        mutability: 'read/write',
+        owningCommand: 'oat config set documentation.navOwner <value>',
+        description: 'Sidebar owner for framework docs only. Unset is undeclared and authorizes no automatic navigation generation. Markdown ignores this key.',
+    },
     {
         key: 'documentation.guidance',
         group: 'Documentation Guidance (shared > user)',
@@ -1784,17 +1808,31 @@ async function listConfigKeys(repoRoot, userConfigDir, dependencies) {
 async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, dependencies, warn) {
     validateSurfaceForKey(key, surface);
     const effectiveSurface = surface === 'auto' ? defaultSurfaceForKey(key) : surface;
-    if (key === 'documentation.guidance') {
+    if (key === 'documentation.guidance' ||
+        key === 'documentation.ia' ||
+        key === 'documentation.navOwner') {
         const configPath = effectiveSurface === 'user'
             ? join(userConfigDir, 'config.json')
             : join(repoRoot, '.oat', 'config.json');
+        const field = key.slice('documentation.'.length);
         const trimmed = rawValue.trim();
-        let guidance;
+        let value;
         try {
-            guidance = normalizeDocumentationGuidance(trimmed.startsWith('[') ? JSON.parse(trimmed) : trimmed, configPath, effectiveSurface === 'user' ? 'user' : 'shared');
+            if (key === 'documentation.ia') {
+                const parsed = JSON.parse(trimmed);
+                if (parsed === null)
+                    throw new Error('Expected an IA JSON object.');
+                value = normalizeDocumentationIa(parsed, configPath);
+            }
+            else {
+                value =
+                    key === 'documentation.navOwner'
+                        ? normalizeDocumentationNavOwner(trimmed, configPath)
+                        : normalizeDocumentationGuidance(trimmed.startsWith('[') ? JSON.parse(trimmed) : trimmed, configPath, effectiveSurface === 'user' ? 'user' : 'shared');
+            }
         }
         catch {
-            throw new Error('Invalid documentation.guidance value: expected a non-empty path/URL string or ordered non-empty string array.');
+            throw new Error(`Invalid ${key} value: ${key === 'documentation.ia' ? 'expected IA JSON with preset, repo-relative decision, optional tracks and verification' : key === 'documentation.navOwner' ? 'expected nav-sync or hand-authored' : 'expected a non-empty path/URL string or ordered non-empty string array'}.`);
         }
         let raw = { version: 1 };
         try {
@@ -1818,18 +1856,18 @@ async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, d
             throw new Error(`Expected a documentation object in ${configPath}`);
         }
         // Patch only the declared input; do not normalize away unrelated or future fields.
-        if (!isDeepStrictEqual(documentation?.guidance, guidance)) {
+        if (!isDeepStrictEqual(documentation?.[field], value)) {
             await dependencies.atomicWriteJson(configPath, {
                 ...raw,
                 documentation: {
                     ...documentation,
-                    guidance,
+                    [field]: value,
                 },
             });
         }
         return {
             key,
-            value: guidance ?? null,
+            value: value ?? null,
             source: effectiveSurface,
         };
     }
@@ -2393,7 +2431,9 @@ async function unsetConfigValue(repoRoot, userConfigDir, key, surface, dependenc
  * runs only when the normalized pass found nothing to remove.
  */
 async function removeFromSurface(repoRoot, userConfigDir, key, effectiveSurface, path, dependencies) {
-    if (key === 'documentation.guidance') {
+    if (key === 'documentation.guidance' ||
+        key === 'documentation.ia' ||
+        key === 'documentation.navOwner') {
         const configPath = effectiveSurface === 'user'
             ? join(userConfigDir, 'config.json')
             : join(repoRoot, '.oat', 'config.json');

package/dist/config/oat-config.d.ts

@@ -23,7 +23,20 @@ export type InstructionSyncStrategy = (typeof INSTRUCTION_SYNC_STRATEGIES)[numbe
  */
 export declare const DEFAULT_INSTRUCTION_SYNC_STRATEGY: InstructionSyncStrategy;
 export declare function isInstructionSyncStrategy(value: unknown): value is InstructionSyncStrategy;
+export interface OatDocumentationIa {
+    preset: string;
+    decision: string;
+    tracks?: Array<{
+        path: string;
+        principle: string;
+    }>;
+    verification?: 'triad' | 'agent-only' | 'none';
+}
 export interface OatDocumentationConfig {
+    /** Repository-only mirror; the authored decision and local guidance own IA. */
+    ia?: OatDocumentationIa;
+    /** Absent is undeclared. Markdown ignores sidebar ownership. */
+    navOwner?: 'nav-sync' | 'hand-authored';
     /** Ordered advisory IA source paths/URLs; selected as a layer, never merged. */
     guidance?: string | string[];
     root?: string;
@@ -370,6 +383,9 @@ export declare function setActiveProject(repoRoot: string, projectRelativePath:
 export declare function clearActiveProject(repoRoot: string, options?: {
     lastPaused?: string;
 }): Promise<void>;
+/** Shared by stored-config reads and the real config command. */
+export declare function normalizeDocumentationIa(value: unknown, configPath: string): OatDocumentationIa | undefined;
+export declare function normalizeDocumentationNavOwner(value: unknown, configPath: string): OatDocumentationConfig['navOwner'];
 /** Validate guidance without reading, fetching or rewriting the referenced inputs. */
 export declare function normalizeDocumentationGuidance(value: unknown, configPath: string, scope?: 'shared' | 'user'): string | string[] | undefined;
 export declare function readUserConfig(userConfigDir: string): Promise<UserConfig>;

package/dist/config/oat-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oat-config.d.ts","sourceRoot":"","sources":["../../src/config/oat-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"oat-config.d.ts","sourceRoot":"","sources":["../../src/config/oat-config.ts"],"names":[],"mappings":"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"}

package/dist/config/oat-config.js

@@ -1062,6 +1062,12 @@ function normalizeOatConfig(parsed, configPath = '.oat/config.json', onWarning)
     }
     if (isRecord(parsed.documentation)) {
         const doc = {};
+        const ia = normalizeDocumentationIa(parsed.documentation.ia, configPath);
+        if (ia !== undefined)
+            doc.ia = ia;
+        const navOwner = normalizeDocumentationNavOwner(parsed.documentation.navOwner, configPath);
+        if (navOwner !== undefined)
+            doc.navOwner = navOwner;
         const guidance = normalizeDocumentationGuidance(parsed.documentation.guidance, configPath);
         if (guidance !== undefined)
             doc.guidance = guidance;
@@ -1540,6 +1546,58 @@ const USER_CONFIG_OWNED_KEYS = new Set([
     'pjm',
     'knownStrays',
 ]);
+/** Shared by stored-config reads and the real config command. */
+export function normalizeDocumentationIa(value, configPath) {
+    if (value === undefined || value === null)
+        return undefined;
+    const nonempty = (entry) => typeof entry === 'string' && entry.trim().length > 0;
+    const repoRelative = (entry) => {
+        if (typeof entry !== 'string')
+            return false;
+        const path = entry.trim();
+        return (nonempty(path) &&
+            !/^(?:[\\/]|[a-zA-Z]:|[a-zA-Z][a-zA-Z+.-]*:)/.test(path) &&
+            !path.split(String.fromCharCode(92)).join('/').split('/').includes('..'));
+    };
+    if (!isRecord(value) ||
+        Object.keys(value).some((key) => !['preset', 'decision', 'tracks', 'verification'].includes(key)) ||
+        !nonempty(value.preset) ||
+        !repoRelative(value.decision) ||
+        (value.verification !== undefined &&
+            !['triad', 'agent-only', 'none'].includes(value.verification)) ||
+        (value.tracks !== undefined &&
+            (!Array.isArray(value.tracks) ||
+                !value.tracks.every((track) => isRecord(track) &&
+                    Object.keys(track).every((key) => ['path', 'principle'].includes(key)) &&
+                    repoRelative(track.path) &&
+                    nonempty(track.principle))))) {
+        throw new Error(`Invalid documentation.ia in ${configPath}: expected { preset, decision (repo-relative path), tracks?: [{ path, principle }], verification?: triad|agent-only|none }. Repair with oat config set documentation.ia '<JSON>' or oat config unset documentation.ia --shared.`);
+    }
+    return {
+        preset: value.preset.trim(),
+        decision: value.decision.trim(),
+        ...(value.tracks !== undefined
+            ? {
+                tracks: value.tracks.map((track) => ({
+                    path: track.path.trim(),
+                    principle: track.principle.trim(),
+                })),
+            }
+            : {}),
+        ...(value.verification !== undefined
+            ? {
+                verification: value.verification,
+            }
+            : {}),
+    };
+}
+export function normalizeDocumentationNavOwner(value, configPath) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (value !== 'nav-sync' && value !== 'hand-authored')
+        throw new Error(`Invalid documentation.navOwner in ${configPath}: expected nav-sync or hand-authored. Repair with oat config set documentation.navOwner <value> or oat config unset documentation.navOwner --shared.`);
+    return value;
+}
 /** Validate guidance without reading, fetching or rewriting the referenced inputs. */
 export function normalizeDocumentationGuidance(value, configPath, scope = 'shared') {
     if (value === undefined || value === null)

package/dist/config/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAGtB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AAgID,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CAAC,cAAc,CAAC,CAgFzB;AAED,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,GAChB,sBAAsB,CAkBxB;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CAEnB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAY5B;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CA0DxC;AAiMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,MAAM,GAAG,SAAS,CAQpB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAGtB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AAkID,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CAAC,cAAc,CAAC,CAgFzB;AAED,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB;;;;OAIG;IACH,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,GAChB,sBAAsB,CAkBxB;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CAEnB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAY5B;AAED,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CA0DxC;AAkMD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,MAAM,GAAG,SAAS,CAQpB"}

package/dist/config/resolve.js

@@ -28,6 +28,8 @@ const DEFAULT_SHARED_CONFIG = {
     },
     documentation: {
         guidance: null,
+        ia: null,
+        navOwner: null,
         root: null,
         tooling: null,
         config: null,
@@ -406,7 +408,8 @@ function flattenConfig(value, prefix = '') {
     return flattened;
 }
 function isAtomicConfigLeaf(key, value) {
-    return (isWorkflowDispatchCandidateLadder(value) ||
+    return (key === 'documentation.ia' ||
+        isWorkflowDispatchCandidateLadder(value) ||
         (key === 'workflow.postImplementSequence' &&
             isWorkflowPostImplementStructuredSequence(value)));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.3.24",
+  "version": "0.3.25",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -35,7 +35,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.3.24"
+    "@open-agent-toolkit/control-plane": "0.3.25"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",