@open-agent-toolkit/cli 0.0.10 → 0.0.18

package/dist/commands/project/archive/archive-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"archive-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/archive-utils.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,aAAa,EACb,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACX,MAAM,QAAQ,CAAC;AAIhB,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAChD,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,iCAAiC;IACzC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,UAAU,sCAAuC,SAAQ,iCAAiC;IACxF,qBAAqB,CAAC,EAAE,OAAO,qBAAqB,CAAC;IACrD,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,SAAS,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,KACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,cAAc,CAAC;IACvC,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,kCAAkC,6BAA6B,CAAC;AAE7E,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AA8BD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAmBD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CA4BA;AAED,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR;AAqJD,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,iCAAiC,EAC1C,YAAY,GAAE,sCAA2C,GACxD,OAAO,CAAC,gCAAgC,CAAC,CAoG3C;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,EACrC,YAAY,GAAE,iCAAsC,GACnD,OAAO,CAAC,2BAA2B,CAAC,CA0CtC"}

package/dist/commands/project/archive/archive-utils.js

@@ -87,7 +87,38 @@ function resolveGitPath(repoRoot, gitPath) {
         ? normalizedPath
         : join(repoRoot, normalizedPath);
 }
-async function resolveArchiveRepoRoot(repoRoot, dependencies) {
+function isExitCode(error, code) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        Number(error.code) === code);
+}
+async function isGitignoredArchivePath(repoRoot, archiveProjectPath, dependencies) {
+    const execFile = dependencies.gitExecFile ?? execFileAsync;
+    try {
+        await execFile('git', ['check-ignore', '--quiet', '--no-index', archiveProjectPath], {
+            cwd: repoRoot,
+            env: dependencies.env ?? process.env,
+        });
+        return true;
+    }
+    catch (error) {
+        if (isExitCode(error, 1)) {
+            return false;
+        }
+        throw error;
+    }
+}
+async function resolveArchiveRepoRoot(repoRoot, archiveProjectPath, dependencies) {
+    try {
+        const archivePathIsGitignored = await isGitignoredArchivePath(repoRoot, archiveProjectPath, dependencies);
+        if (!archivePathIsGitignored) {
+            return repoRoot;
+        }
+    }
+    catch {
+        return repoRoot;
+    }
     const execFile = dependencies.gitExecFile ?? execFileAsync;
     try {
         const [{ stdout: commonDir }, { stdout: gitDir }] = await Promise.all([
@@ -148,7 +179,8 @@ export async function archiveProjectOnCompletion(options, dependencies = {}) {
     const execFile = dependencies.execFile ?? execFileAsync;
     const timestamp = dependencies.timestamp?.() ?? new Date().toISOString();
     const snapshotName = buildArchiveSnapshotName(options.projectName, timestamp);
-    const archiveRepoRoot = await resolveArchiveRepoRoot(options.repoRoot, dependencies);
+    const archiveProjectPath = resolveLocalArchiveProjectPath(options.projectsRoot, options.projectName);
+    const archiveRepoRoot = await resolveArchiveRepoRoot(options.repoRoot, archiveProjectPath, dependencies);
     const archiveBasePath = resolveCompletionArchivePath(archiveRepoRoot, options.projectsRoot, options.projectName);
     const archivePath = await resolveUniqueArchivePath(archiveBasePath, dependencies);
     await makeDir(dirname(archivePath));

package/dist/manifest/manager.js

@@ -3,7 +3,7 @@ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { CliError } from '../errors/index.js';
 import { ManifestSchema, } from './manifest.types.js';
-const OAT_VERSION = '0.0.7';
+const OAT_VERSION = '0.0.18';
 function formatIssuePath(path) {
     if (path.length === 0) {
         return '(root)';

package/dist/validation/index.d.ts

@@ -1,3 +1,3 @@
-export type { ValidateOatSkillsResult, ValidationFinding } from './skills.js';
-export { validateOatSkills } from './skills.js';
+export type { ValidateChangedSkillVersionBumpsOptions, ValidateChangedSkillVersionBumpsResult, ValidateOatSkillsOptions, ValidateOatSkillsResult, ValidationFinding, } from './skills.js';
+export { validateChangedSkillVersionBumps, validateOatSkills } from './skills.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uCAAuC,EACvC,sCAAsC,EACtC,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,gCAAgC,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/validation/index.js

@@ -1 +1 @@
-export { validateOatSkills } from './skills.js';
+export { validateChangedSkillVersionBumps, validateOatSkills } from './skills.js';

package/dist/validation/skills.d.ts

@@ -6,5 +6,29 @@ export interface ValidateOatSkillsResult {
     validatedSkillCount: number;
     findings: ValidationFinding[];
 }
-export declare function validateOatSkills(repoRoot: string): Promise<ValidateOatSkillsResult>;
+export interface ValidateChangedSkillVersionBumpsOptions {
+    baseRef: string;
+}
+export interface ValidateChangedSkillVersionBumpsResult {
+    validatedSkillCount: number;
+    findings: ValidationFinding[];
+}
+export interface ValidateOatSkillsOptions {
+    baseRef?: string;
+}
+export type ExecFileResult = {
+    stdout: string;
+    stderr: string;
+};
+export type ExecFileLike = (file: string, args: string[], options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}) => Promise<ExecFileResult>;
+interface ValidateOatSkillsDependencies {
+    gitExecFile?: ExecFileLike;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function validateChangedSkillVersionBumps(repoRoot: string, options: ValidateChangedSkillVersionBumpsOptions, dependencies?: ValidateOatSkillsDependencies): Promise<ValidateChangedSkillVersionBumpsResult>;
+export declare function validateOatSkills(repoRoot: string, options?: ValidateOatSkillsOptions, dependencies?: ValidateOatSkillsDependencies): Promise<ValidateOatSkillsResult>;
+export {};
 //# sourceMappingURL=skills.d.ts.map

package/dist/validation/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/validation/skills.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AA0GD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,uBAAuB,CAAC,CA8GlC"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/validation/skills.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAChD,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,UAAU,6BAA6B;IACrC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAgOD,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uCAAuC,EAChD,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,sCAAsC,CAAC,CAoBjD;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,uBAAuB,CAAC,CA6HlC"}

package/dist/validation/skills.js

@@ -1,6 +1,9 @@
+import { execFile as execFileCallback } from 'node:child_process';
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { join } from 'node:path';
+import { promisify } from 'node:util';
 import { getFrontmatterBlock } from '../commands/shared/frontmatter.js';
+const execFileAsync = promisify(execFileCallback);
 async function isDirectory(path) {
     try {
         const s = await stat(path);
@@ -22,6 +25,17 @@ function getFrontmatterScalar(frontmatter, key) {
 function isValidSemver(value) {
     return /^\d+\.\d+\.\d+$/.test(value);
 }
+function compareSemver(left, right) {
+    const leftParts = left.split('.').map(Number);
+    const rightParts = right.split('.').map(Number);
+    for (let index = 0; index < 3; index += 1) {
+        const diff = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+        if (diff !== 0) {
+            return diff;
+        }
+    }
+    return 0;
+}
 function hasProgressIndicatorsSection(content) {
     return /^## Progress Indicators \(User-Facing\)\s*$/m.test(content);
 }
@@ -64,7 +78,83 @@ function validateQuickStartSemantics(skillPath, content, findings) {
         });
     }
 }
-export async function validateOatSkills(repoRoot) {
+async function listChangedSkillFiles(repoRoot, baseRef, dependencies) {
+    const execFile = dependencies.gitExecFile ?? execFileAsync;
+    const { stdout } = await execFile('git', [
+        'diff',
+        '--name-only',
+        '--diff-filter=ACMR',
+        `${baseRef}...HEAD`,
+        '--',
+        '.agents/skills/*/SKILL.md',
+    ], {
+        cwd: repoRoot,
+        env: dependencies.env ?? process.env,
+    });
+    return stdout
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+}
+async function readFileAtGitRef(repoRoot, ref, filePath, dependencies) {
+    const execFile = dependencies.gitExecFile ?? execFileAsync;
+    try {
+        const { stdout } = await execFile('git', ['show', `${ref}:${filePath}`], {
+            cwd: repoRoot,
+            env: dependencies.env ?? process.env,
+        });
+        return stdout;
+    }
+    catch {
+        return null;
+    }
+}
+async function collectChangedSkillVersionBumpFindings(repoRoot, baseRef, changedSkillFiles, findings, dependencies) {
+    for (const relativeSkillPath of changedSkillFiles) {
+        const skillPath = join(repoRoot, relativeSkillPath);
+        const currentContent = await readFile(skillPath, 'utf8');
+        const baseContent = await readFileAtGitRef(repoRoot, baseRef, relativeSkillPath, dependencies);
+        if (baseContent === null || baseContent === currentContent) {
+            continue;
+        }
+        const currentFrontmatter = getFrontmatterBlock(currentContent);
+        const baseFrontmatter = getFrontmatterBlock(baseContent);
+        const currentVersion = currentFrontmatter
+            ? getFrontmatterScalar(currentFrontmatter, 'version')
+            : null;
+        const baseVersion = baseFrontmatter
+            ? getFrontmatterScalar(baseFrontmatter, 'version')
+            : null;
+        if (!currentVersion || !baseVersion) {
+            continue;
+        }
+        if (currentVersion === baseVersion) {
+            findings.push({
+                file: skillPath,
+                message: `Changed canonical skill must bump frontmatter version relative to ${baseRef} (still ${currentVersion})`,
+            });
+            continue;
+        }
+        if (isValidSemver(currentVersion) &&
+            isValidSemver(baseVersion) &&
+            compareSemver(currentVersion, baseVersion) <= 0) {
+            findings.push({
+                file: skillPath,
+                message: `Changed canonical skill version must increase relative to ${baseRef} (base ${baseVersion}, current ${currentVersion})`,
+            });
+        }
+    }
+}
+export async function validateChangedSkillVersionBumps(repoRoot, options, dependencies = {}) {
+    const findings = [];
+    const changedSkillFiles = await listChangedSkillFiles(repoRoot, options.baseRef, dependencies);
+    await collectChangedSkillVersionBumpFindings(repoRoot, options.baseRef, changedSkillFiles, findings, dependencies);
+    return {
+        validatedSkillCount: changedSkillFiles.length,
+        findings,
+    };
+}
+export async function validateOatSkills(repoRoot, options = {}, dependencies = {}) {
     const skillsRoot = join(repoRoot, '.agents', 'skills');
     const findings = [];
     if (!(await isDirectory(skillsRoot))) {
@@ -162,5 +252,9 @@ export async function validateOatSkills(repoRoot) {
             validateQuickStartSemantics(skillPath, content, findings);
         }
     }
+    if (options.baseRef) {
+        const changedSkillFiles = await listChangedSkillFiles(repoRoot, options.baseRef, dependencies);
+        await collectChangedSkillVersionBumpFindings(repoRoot, options.baseRef, changedSkillFiles, findings, dependencies);
+    }
     return { validatedSkillCount: oatSkillDirs.length, findings };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.0.10",
+  "version": "0.0.18",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -25,21 +25,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "bash scripts/bundle-assets.sh && tsc && tsc-alias",
-    "clean": "rm -rf dist",
-    "dev": "tsx watch src/index.ts",
-    "check": "oxlint . && oxfmt --check .",
-    "check:fix": "oxlint --fix . && oxfmt .",
-    "format": "oxfmt --check .",
-    "format:fix": "oxfmt .",
-    "lint": "oxlint .",
-    "lint:fix": "oxlint --fix .",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "type-check": "tsc --noEmit"
-  },
   "dependencies": {
     "@iarna/toml": "2.2.5",
     "@inquirer/prompts": "^8.2.0",
@@ -58,5 +43,20 @@
   },
   "engines": {
     "node": ">=22.17.0"
+  },
+  "scripts": {
+    "build": "bash scripts/bundle-assets.sh && tsc && tsc-alias",
+    "clean": "rm -rf dist",
+    "dev": "tsx watch src/index.ts",
+    "check": "oxlint . && oxfmt --check .",
+    "check:fix": "oxlint --fix . && oxfmt .",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit"
   }
-}
+}

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

@@ -1,211 +0,0 @@
----
-title: CLI Reference
-description: 'Scannable reference for the current OAT CLI surface, with links to the deeper guide pages for each command family.'
----
-
-# CLI Reference
-
-Use this page when you need a quick map of the OAT CLI rather than the full command-by-command docs. It is intentionally shallow: each section points to the guide page that owns the detailed behavior.
-
-The CLI is also a standalone value path. You can use `oat init`, `oat sync`, `oat tools`, docs commands, and repo-analysis commands without adopting the full project workflow.
-
-## Contents
-
-- [Getting Started](getting-started.md) - Bootstrap a repo with `oat init`, guided setup, and initial provider adoption.
-- [Tool Packs](tool-packs.md) - Install, update, inspect, and remove bundled OAT skills and agents.
-- [Documentation Commands](documentation/commands.md) - Docs app scaffolding, migration, index generation, and nav sync.
-- [Provider Sync](provider-sync/index.md) - Sync behavior, provider capabilities, config, and drift management.
-- [Workflow & Projects](workflow/index.md) - Project lifecycle, artifacts, reviews, PR flow, and state-machine docs.
-- [Repository Analysis](workflow/repo-analysis.md) - Detailed `oat repo pr-comments ...` behavior.
-
-## Command Groups
-
-| Command group                                          | What it covers                                                                            | Go deeper                                           |
-| ------------------------------------------------------ | ----------------------------------------------------------------------------------------- | --------------------------------------------------- |
-| `oat init`                                             | Bootstrap canonical OAT directories, sync config, optional hooks, and guided setup.       | [Getting Started](getting-started.md)               |
-| `oat tools ...`                                        | Install, inspect, update, and remove bundled OAT tool packs and assets.                   | [Tool Packs](tool-packs.md)                         |
-| `oat backlog ...`                                      | Generate backlog IDs and rebuild the managed file-backed backlog index.                   | See sections below                                  |
-| `oat config ...`                                       | Inspect resolved config values, update supported keys, and discover config ownership.     | See sections below                                  |
-| `oat docs ...`                                         | Docs app bootstrap, migration, index generation, nav sync, and docs workflow entrypoints. | [Documentation Commands](documentation/commands.md) |
-| `oat status` / `oat sync` / `oat providers ...`        | Provider sync, drift inspection, provider configuration, and adoption behavior.           | [Provider Sync](provider-sync/index.md)             |
-| `oat project ...` / `oat cleanup ...`                  | Project scaffolding, execution mode, and project/artifact cleanup commands.               | [Workflow & Projects](workflow/index.md)            |
-| `oat repo ...`                                         | Repository-level analysis workflows, currently centered on PR comments.                   | [Repository Analysis](workflow/repo-analysis.md)    |
-| `oat state ...` / `oat index ...` / `oat internal ...` | Repo dashboard refresh, repo indexing, and internal validation helpers.                   | See sections below                                  |
-
-## Bootstrap and Setup
-
-### `oat init`
-
-Use `oat init` to establish the canonical OAT directory layout, sync config, provider manifest state, and optional setup hooks.
-
-Key behavior:
-
-- initializes project- or user-scope OAT directories idempotently
-- can detect and adopt provider strays during setup
-- supports guided setup for tool packs, local paths, and provider sync
-- prepares the repo for later `oat status`, `oat sync`, `oat doctor`, and workflow usage
-
-See [Getting Started](getting-started.md) for the full setup flow.
-
-## Tool Management and Local State
-
-### `oat tools ...`
-
-Use the `oat tools` group to manage bundled OAT assets:
-
-- `oat tools list` - list installed tools, versions, pack membership, and update state
-- `oat tools info <name>` - inspect one installed skill or agent
-- `oat tools outdated` - show only assets with available updates
-- `oat tools install` - install bundled packs such as `core`, `docs`, `ideas`, `workflows`, `utility`, `project-management`, or `research`
-- `oat tools update` - update a named tool, a whole pack, or everything
-- `oat tools remove` - remove installed assets
-
-Mutation commands auto-run provider sync unless you pass `--no-sync`.
-
-See [Tool Packs](tool-packs.md) for the pack lifecycle and compatibility notes.
-
-### `oat backlog ...`
-
-Use the `oat backlog` group when you want direct CLI support for the file-backed backlog under `.oat/repo/reference/backlog/`.
-
-- `oat backlog init` - scaffold `.oat/repo/reference/backlog/` with starter files and directories for a fresh repo
-- `oat backlog generate-id <filename>` - generate a unique backlog ID from a filename seed
-- `oat backlog generate-id <filename> --created-at <timestamp>` - generate a reproducible ID for a known creation timestamp
-- `oat backlog regenerate-index` - rebuild the managed backlog index table from item frontmatter
-
-Run `oat backlog init` first when the local backlog scaffold does not exist yet in a fresh repo. This command group is primarily used by the `oat-pjm-*` project-management skills, but it is also available directly when you need to inspect or repair backlog metadata by hand.
-
-### `oat local ...`
-
-`oat local` manages local-only, gitignored paths that still need to follow you between the main repo and worktrees.
-
-Common examples:
-
-- `.oat/ideas/`
-- `.oat/**/reviews/archived/`
-
-Available commands:
-
-- `oat local status` - show whether configured local paths exist and are gitignored
-- `oat local apply` - write the managed `.gitignore` section for configured paths
-- `oat local sync` - copy local paths between the main repo and a worktree
-- `oat local add` / `oat local remove` - maintain the `localPaths` config entries
-
-Use this when you want archived review history or idea scratchpads to persist locally without being committed.
-
-### `oat config ...`
-
-Use `oat config` for repo runtime config inspection and supported key mutation.
-
-- `oat config get <key>` - read one resolved config value
-- `oat config set <key> <value>` - update a supported shared or repo-local key
-- `oat config list` - show the resolved command-surface values with source information
-- `oat config describe` - list supported config surfaces and keys across shared repo, repo-local, user, and sync/provider config
-- `oat config describe <key>` - show file location, scope, default, mutability, and owning command for one key
-
-Archive lifecycle settings live here as shared repo config:
-
-- `archive.s3Uri`
-- `archive.s3SyncOnComplete`
-- `archive.summaryExportPath`
-
-When archive settings are configured, completion uploads dated archive snapshots to S3 and exports dated summary snapshots into the configured summary reference directory.
-
-Use the reference pages for file ownership and schema details:
-
-- [File Locations](../reference/file-locations.md)
-- [`.oat` Directory Structure](../reference/oat-directory-structure.md)
-
-## Instruction Integrity
-
-### `oat instructions`
-
-These commands validate and repair pointer integrity between `AGENTS.md` and sibling `CLAUDE.md` files.
-
-- `oat instructions validate` - read-only integrity check
-- `oat instructions sync` - preview or apply pointer repairs
-
-Use this command group when instruction files drift after manual edits or generated updates.
-
-## Docs Commands
-
-### `oat docs ...`
-
-The docs command group covers:
-
-- `oat docs init` - scaffold a docs app for Fumadocs or MkDocs
-- `oat docs migrate` - convert MkDocs markdown patterns to Fumadocs-friendly markdown
-- `oat docs generate-index` - regenerate the generated app-root docs index
-- `oat docs nav sync` - rebuild MkDocs navigation from `index.md` `## Contents`
-- `oat docs analyze` / `oat docs apply` - CLI entrypoints for the docs workflow skills
-
-See [Documentation Commands](documentation/commands.md) for framework-specific behavior and flags.
-
-## Provider Sync Commands
-
-### `oat status`, `oat sync`, and `oat providers ...`
-
-These commands manage the relationship between canonical OAT assets and provider-specific views.
-
-- `oat status` - inspect sync and drift state
-- `oat sync` - write provider views from canonical assets
-- `oat providers list` / `inspect` / `set` - inspect providers and control enablement
-
-Use [Provider Sync](provider-sync/index.md) for the full model, including scope, manifest, config, and safety behavior.
-
-## Workflow and Project Commands
-
-### `oat project ...`
-
-Project commands are the CLI entrypoint into the OAT lifecycle.
-
-- `oat project new <name>` - create a new project in spec-driven, quick, or import mode
-- `oat project open <name>` - activate an existing project
-- `oat project set-mode <mode>` - switch implementation between `single-thread` and `subagent-driven`
-- `oat project archive sync` - sync the latest dated remote snapshot for each archived project from the configured S3 archive into `.oat/projects/archived/`
-- `oat project archive sync <project-name>` - sync the latest dated remote snapshot for one archived project into `.oat/projects/archived/<project-name>/`
-
-### `oat cleanup ...`
-
-Cleanup commands handle lifecycle drift and stale artifacts:
-
-- `oat cleanup project` - reconcile project pointers and lifecycle state
-- `oat cleanup artifacts` - prune duplicate or stale review/reference artifacts
-
-Use [Workflow & Projects](workflow/index.md) for the full lifecycle map and related docs on artifacts, reviews, PR flow, and state transitions.
-
-## Repository Analysis
-
-### `oat repo ...`
-
-The `oat repo` command group is for repository-wide analysis work rather than single-project execution.
-
-- `oat repo pr-comments collect` - collect merged PR review comments into monthly artifacts
-- `oat repo pr-comments triage-collection` - interactively keep or discard collected comments
-
-See [Repository Analysis](workflow/repo-analysis.md) for the detailed collection, filtering, and triage workflow.
-
-## Repo State and Internal Commands
-
-### Repo state helpers
-
-- `oat state refresh` - rebuild the `.oat/state.md` dashboard for the repo
-- `oat index init` - generate a lightweight `project-index.md` for orientation
-
-### Internal helpers
-
-- `oat internal validate-oat-skills` - validate `oat-*` skill contracts and metadata
-- `oat doctor` - run environment and setup diagnostics, including installed-vs-bundled skill version checks
-
-`oat doctor` is the quickest way to confirm that your runtime, directory structure, and installed OAT assets are healthy before deeper debugging. The `/oat-doctor` skill (installed via the core pack) provides richer diagnostics with check and summary modes, including config explanations sourced from bundled documentation.
-
-## Global Options
-
-Most command groups support these global flags:
-
-| Option            | Description                                                   |
-| ----------------- | ------------------------------------------------------------- |
-| `--json`          | Emit a single JSON document instead of human-readable output. |
-| `--verbose`       | Enable debug-style logging.                                   |
-| `--scope <scope>` | Limit work to `project`, `user`, or `all`.                    |
-| `--cwd <path>`    | Override the working directory for the command.               |

package/assets/docs/guide/documentation/index.md

@@ -1,27 +0,0 @@
----
-title: Documentation
-description: 'Guide to OAT documentation app setup, docs commands, and docs analysis/apply workflows.'
----
-
-# Documentation
-
-Use this section when you are setting up, maintaining, or restructuring a docs surface with OAT.
-
-OAT supports both Fumadocs and MkDocs. In either case, the core contract is the same: each directory gets an `index.md`, and each index owns a `## Contents` section that supports local discovery and generated navigation.
-
-## Contents
-
-- [Quickstart](quickstart.md) - Bootstrap a docs app and adopt the docs workflow in a repo.
-- [Commands](commands.md) - Docs CLI surface for init, migration, index generation, and nav sync.
-- [Workflows](workflows.md) - How the docs CLI helpers pair with `oat-docs-analyze` and `oat-docs-apply`.
-
-## Choose an Entry Point
-
-- Start with [Quickstart](quickstart.md) when you are adding a docs app to a repo.
-- Use [Commands](commands.md) when you already have a docs app and need the exact CLI surface.
-- Use [Workflows](workflows.md) when you want a controlled analyze/apply loop for docs changes instead of manual edits.
-
-## Related Reference
-
-- [Docs Index Contract](../../reference/docs-index-contract.md) - Rules for `index.md` and `## Contents`.
-- [CLI Reference](../cli-reference.md) - Shallow map of the full OAT CLI surface.

package/assets/docs/guide/provider-sync/index.md

@@ -1,65 +0,0 @@
----
-title: Provider Sync
-description: 'User guide for adopting OAT across provider surfaces, managing drift, and syncing canonical assets into provider views.'
----
-
-# Provider Sync
-
-Use this section when you want OAT to project a canonical rules-and-skills layout into provider-specific surfaces such as Claude, Cursor, Copilot, Gemini, or Codex.
-
-Provider sync is a standalone path. You can adopt it without using tracked OAT projects, and then layer workflow artifacts on top later if you need them.
-
-## Contents
-
-- [Scope and Surface](scope-and-surface.md) - Canonical assets, provider views, scopes, and the sync surface area.
-- [Commands](commands.md) - `oat status`, `oat sync`, and `oat providers ...` behavior.
-- [Providers](providers.md) - Provider-specific mappings, capabilities, and path conventions.
-- [Manifest and Drift](manifest-and-drift.md) - How OAT tracks synced state, stray files, and adoption decisions.
-- [Config](config.md) - Provider config model, enablement, and scope semantics.
-
-## What This Section Covers
-
-- canonical assets in `.agents/skills`, `.agents/agents`, and `.agents/rules`
-- derived provider views that should be treated as synced outputs unless explicitly adopted
-- drift detection, stray discovery, and adoption decisions when provider files change
-- command behavior for inspecting sync state, configuring providers, and writing synced output
-
-## Sync Flow
-
-```mermaid
-flowchart LR
-  CANON["Canonical assets\n.agents/ + .oat/"] --> STATUS["oat status"]
-  STATUS --> SYNC["oat sync"]
-  SYNC --> PROVIDERS["Provider views"]
-  PROVIDERS --> DRIFT{"Drift or strays?"}
-  DRIFT -->|No| OK["In sync"]
-  DRIFT -->|Yes| ADOPT["Adopt or reconcile"]
-  ADOPT --> CANON
-```
-
-## Typical Flow
-
-1. Run `oat init` to create canonical OAT directories and base config.
-2. Inspect current state with `oat status`.
-3. Enable or adjust providers with `oat providers ...` as needed.
-4. Run `oat sync` to materialize provider views from canonical assets.
-5. Re-run `oat status` after edits to confirm drift, adoption, or sync needs.
-
-## Canonical Rules and Adoption
-
-Recent OAT changes moved more behavior into canonical rules plus explicit adoption flows. In practice that means:
-
-- treat `.agents/` and `.oat/` content as the source of truth
-- use sync and adoption workflows to pull provider-side edits back into canonical form
-- avoid maintaining long-lived, hand-edited provider copies when the canonical source can own the change
-
-## Related Contributor Docs
-
-- [Hooks and Safety](../../contributing/hooks-and-safety.md) - Operational safety guidance for hooks, mutation commands, and synced changes.
-- [Writing Skills](../../contributing/skills.md) - Contributor guidance when sync behavior depends on skill authoring changes.
-
-## If You Are Trying To...
-
-- operate sync, drift, or provider configuration as a user, stay in this section
-- change hook behavior or understand mutation safety, jump to [Hooks and Safety](../../contributing/hooks-and-safety.md)
-- update canonical skills that later sync into provider views, jump to [Writing Skills](../../contributing/skills.md)

package/assets/docs/guide/workflow/index.md

@@ -1,34 +0,0 @@
----
-title: Workflow & Projects
-description: 'Guide to OAT lifecycle execution, project artifacts, reviews, PR flow, and repo-analysis helpers.'
----
-
-# Workflow & Projects
-
-Use this section when you want tracked, resumable work on top of the base CLI and provider-sync layers.
-
-OAT workflow is optional. The CLI remains useful on its own, but projects add explicit artifacts, stable task IDs, review loops, and resumable implementation state for longer-running work.
-
-## Contents
-
-- [Lifecycle](lifecycle.md) - End-to-end flow from discovery through implementation and completion.
-- [HiLL Checkpoints](hill-checkpoints.md) - Human-in-the-Loop Lifecycle configuration and approval behavior.
-- [Artifacts](artifacts.md) - What lives in `state.md`, `discovery.md`, `plan.md`, `implementation.md`, and related files.
-- [State Machine](state-machine.md) - Lifecycle and review status transitions across a project.
-- [Reviews](reviews.md) - How review request/receive loops work inside OAT projects.
-- [PR Flow](pr-flow.md) - Progress and final PR generation expectations.
-- [Repository Analysis](repo-analysis.md) - Repo-wide PR comment collection and triage workflows.
-
-## Choose the Right Workflow Layer
-
-- Use the CLI only when you want direct commands without tracked artifacts.
-- Use quick mode when the work is bounded and requirements are already clear.
-- Use spec-driven mode when requirements or design decisions need explicit baseline artifacts.
-- Use import mode when a plan already exists outside OAT and you want tracked execution.
-
-## Core Project Concepts
-
-- `state.md` tracks the current phase, task pointer, blockers, and review readiness.
-- `plan.md` owns the stable task sequence and HiLL checkpoint configuration.
-- `implementation.md` records outcomes, verification, and resume notes as work progresses.
-- reviews and PR artifacts provide the quality gate between implementation and merge.