@open-agent-toolkit/cli 0.0.10 → 0.0.16

package/assets/skills/oat-project-complete/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-complete
-version: 1.3.3
+version: 1.3.4
 description: Use when all implementation work is finished and the project is ready to close. Marks the OAT project lifecycle as complete.
 disable-model-invocation: true
 user-invocable: true
@@ -300,35 +300,30 @@ The archive-side effects in this step are CLI-owned. Follow the canonical behavi
 
 ```bash
 ARCHIVED_ROOT=".oat/projects/archived"
-MAIN_WORKTREE_PATH=$(git worktree list --porcelain 2>/dev/null | awk '
-  /^worktree / { wt=$2 }
-  /^branch refs\\/heads\\/main$/ { print wt; exit }
-')
-MAIN_REPO_ARCHIVE=""
-if [[ -n "$MAIN_WORKTREE_PATH" ]]; then
-  MAIN_REPO_ARCHIVE="${MAIN_WORKTREE_PATH}/.oat/projects/archived"
-fi
+PRIMARY_REPO_ARCHIVE=""
 LOCAL_ARCHIVED_ROOT=".oat/projects/archived"
-USE_MAIN_REPO_ARCHIVE="false"
+USE_PRIMARY_REPO_ARCHIVE="false"
 
-# Heuristic: if this checkout is a worktree and the main repo archive parent exists,
-# use the main repo archive as the canonical archive destination.
+# Heuristic: if this checkout is a worktree and the primary repo archive parent
+# exists, use that durable archive path as the canonical archive destination.
 if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
   GIT_COMMON_DIR=$(git rev-parse --git-common-dir 2>/dev/null || true)
   GIT_DIR=$(git rev-parse --git-dir 2>/dev/null || true)
   if [[ -n "$GIT_COMMON_DIR" && -n "$GIT_DIR" && "$GIT_COMMON_DIR" != "$GIT_DIR" ]]; then
-    if [[ -d "$(dirname "$MAIN_REPO_ARCHIVE")" ]]; then
-      USE_MAIN_REPO_ARCHIVE="true"
-      ARCHIVED_ROOT="$MAIN_REPO_ARCHIVE"
+    PRIMARY_REPO_ROOT=$(cd "$(dirname "$GIT_COMMON_DIR")" && pwd)
+    PRIMARY_REPO_ARCHIVE="${PRIMARY_REPO_ROOT}/.oat/projects/archived"
+    if [[ -d "$(dirname "$PRIMARY_REPO_ARCHIVE")" ]]; then
+      USE_PRIMARY_REPO_ARCHIVE="true"
+      ARCHIVED_ROOT="$PRIMARY_REPO_ARCHIVE"
     else
-      echo "Warning: Running in a worktree, but main repo archive path is unavailable: $MAIN_REPO_ARCHIVE"
+      echo "Warning: Running in a worktree, but the primary repo archive path is unavailable: $PRIMARY_REPO_ARCHIVE"
       echo "A worktree-local archive may be deleted when the worktree is removed and is not a durable archive."
       echo "Require explicit confirmation before proceeding with local-only archive."
     fi
   fi
 fi
 
-if [[ "$USE_MAIN_REPO_ARCHIVE" != "true" ]]; then
+if [[ "$USE_PRIMARY_REPO_ARCHIVE" != "true" ]]; then
   ARCHIVED_ROOT="$LOCAL_ARCHIVED_ROOT"
 fi
 
@@ -354,10 +349,10 @@ echo "Project archived to $ARCHIVE_PATH"
 
 **Worktree durability guard (required):**
 
-- If running in a worktree and `MAIN_REPO_ARCHIVE` is unavailable, do not silently continue with a local-only archive.
-- Ask the user explicitly: "Main repo archive path is unavailable, so this archive may be lost when the worktree is deleted. Continue with local-only archive anyway?"
+- If running in a worktree and the primary repo archive path is unavailable, do not silently continue with a local-only archive.
+- Ask the user explicitly: "Primary repo archive path is unavailable, so this archive may be lost when the worktree is deleted. Continue with local-only archive anyway?"
 - If the user declines, skip archiving and continue the completion flow without archive.
-- If your repository does not use `main` as the default branch, use `git worktree list --porcelain` to identify the primary worktree path by another stable rule (for example the non-ephemeral root checkout), then append `/.oat/projects/archived`.
+- Resolve the durable repo root from `git rev-parse --git-common-dir` and `git rev-parse --git-dir`, matching the CLI helper in `packages/cli/src/commands/project/archive/archive-utils.ts`. Do not rely on a `main` checkout or default-branch naming.
 
 **Git handling after archive:**
 
@@ -376,16 +371,14 @@ If running from a git worktree, the primary repo archive directory is the canoni
 Reference path:
 
 ```bash
-MAIN_WORKTREE_PATH=$(git worktree list --porcelain | awk '
-  /^worktree / { wt=$2 }
-  /^branch refs\\/heads\\/main$/ { print wt; exit }
-')
-MAIN_REPO_ARCHIVE="${MAIN_WORKTREE_PATH}/.oat/projects/archived"
+GIT_COMMON_DIR=$(git rev-parse --git-common-dir)
+PRIMARY_REPO_ROOT=$(cd "$(dirname "$GIT_COMMON_DIR")" && pwd)
+PRIMARY_REPO_ARCHIVE="${PRIMARY_REPO_ROOT}/.oat/projects/archived"
 ```
 
 Guidance:
 
-- In a worktree, prefer moving directly to `MAIN_REPO_ARCHIVE` instead of archiving locally and copying later.
+- In a worktree, prefer moving directly to `PRIMARY_REPO_ARCHIVE` instead of archiving locally and copying later.
 - Do not treat the worktree-local archive as durable.
 - If forced to use a local-only archive, warn and require explicit user confirmation.
 - Do not hardcode user-specific absolute paths.

package/assets/skills/oat-project-document/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-document
-version: 1.0.0
+version: 1.0.1
 description: Run when implementation is complete and documentation needs updating. Analyzes project artifacts to produce documentation update recommendations, then applies approved changes before project completion.
 argument-hint: '[project-path] [--auto]'
 disable-model-invocation: true
@@ -222,7 +222,7 @@ Scan the repository for all documentation and instruction surfaces.
 
 4. **Reference files:**
    - Check `.oat/repo/reference/` directory
-   - Read: `current-state.md`, `backlog.md`, `roadmap.md`, `decision-record.md` (whichever exist)
+   - Read: `current-state.md`, `backlog/index.md`, `backlog/completed.md`, `roadmap.md`, `decision-record.md`, and relevant `backlog/items/*.md` files as needed (whichever exist)
 
 **3b. Instruction surfaces (secondary — strong signals only):**
 

package/dist/app/create-program.js

@@ -1,7 +1,7 @@
 import { Command, Option } from 'commander';
 const PROGRAM_NAME = 'oat';
 const PROGRAM_DESCRIPTION = 'Open Agent Toolkit CLI for provider interoperability';
-const PROGRAM_VERSION = '0.0.7';
+const PROGRAM_VERSION = '0.0.16';
 const SCOPE_CHOICES = ['project', 'user', 'all'];
 export function createProgram() {
     return new Command()

package/dist/commands/docs/init/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAE5C,OAAO,EAIL,KAAK,uBAAuB,EAI7B,MAAM,mBAAmB,CAAC;AAa3B,UAAU,oBAAoB;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAC;IAC9E,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,WAAW,EAAE,CACX,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,qBAAqB,EAAE,CACrB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AA+CD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAc7E;AAyDD,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,OAAO,CAgCT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAE5C,OAAO,EAIL,KAAK,uBAAuB,EAI7B,MAAM,mBAAmB,CAAC;AAa3B,UAAU,oBAAoB;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAC;IAC9E,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,WAAW,EAAE,CACX,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,qBAAqB,EAAE,CACrB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AA+CD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAc7E;AAyDD,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,OAAO,CAsCT"}

package/dist/commands/docs/init/index.js

@@ -117,6 +117,10 @@ export function createDocsInitCommand(overrides = {}) {
         .addOption(new Option('--app-name <name>', 'Docs app name'))
         .addOption(new Option('--target-dir <path>', 'Target directory for the docs app'))
         .addOption(new Option('--description <text>', 'Site description'))
+        .addOption(new Option('--lint <mode>', 'Markdown lint mode').choices([
+        'none',
+        'markdownlint-cli2',
+    ]))
         .addOption(new Option('--format <mode>', 'Markdown format mode').choices([
         'oxfmt',
         'none',

package/dist/commands/docs/init/resolve-options.d.ts

@@ -1,7 +1,7 @@
 import type { PromptContext, SelectChoice } from '../../shared/shared.prompts.js';
 export type DocsRepoShape = 'monorepo' | 'single-package';
 export type DocsFramework = 'fumadocs' | 'mkdocs';
-export type DocsLintMode = 'none';
+export type DocsLintMode = 'none' | 'markdownlint-cli2';
 export type DocsFormatMode = 'oxfmt' | 'none';
 export interface DocsInitResolvedOptions {
     repoRoot: string;

package/dist/commands/docs/init/resolve-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-options.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/resolve-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACb,MAAM,iCAAiC,CAAC;AAGzC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAgBD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,GACvB,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,CAMR;AAoBD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAE/D;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CA+EzC;AAED,eAAO,MAAM,oCAAoC,EAAE,yBAOlD,CAAC"}
+{"version":3,"file":"resolve-options.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/resolve-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACb,MAAM,iCAAiC,CAAC;AAGzC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,mBAAmB,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAiBD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,GACvB,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,CAMR;AAoBD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAE/D;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CA+EzC;AAED,eAAO,MAAM,oCAAoC,EAAE,yBAOlD,CAAC"}

package/dist/commands/docs/init/resolve-options.js

@@ -6,6 +6,7 @@ const FRAMEWORK_CHOICES = [
 ];
 const LINT_CHOICES = [
     { label: 'none', value: 'none' },
+    { label: 'markdownlint-cli2', value: 'markdownlint-cli2' },
 ];
 const FORMAT_CHOICES = [
     { label: 'oxfmt', value: 'oxfmt' },

package/dist/commands/docs/init/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAGV,uBAAuB,EAExB,MAAM,mBAAmB,CAAC;AA+E3B,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,sBAAsB,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAWD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAsCD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAiID,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoChC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/scaffold.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,KAAK,EAGV,uBAAuB,EAExB,MAAM,mBAAmB,CAAC;AA+E3B,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,sBAAsB,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAWD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAsCD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAYxB;AA4ID,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoChC"}

package/dist/commands/docs/init/scaffold.js

@@ -71,7 +71,7 @@ const OAT_DEP_PACKAGES = [
     'docs-theme',
     'docs-transforms',
 ];
-const DEFAULT_OAT_PUBLISHED_VERSION = '0.0.8';
+const DEFAULT_OAT_PUBLISHED_VERSION = '0.0.16';
 const PUBLIC_PACKAGE_VERSIONS_FILE = 'public-package-versions.json';
 export async function detectIsOatRepo(repoRoot) {
     for (const pkg of OAT_DEP_PACKAGES) {
@@ -126,6 +126,9 @@ function humanizeAppName(appName) {
 }
 function buildDevDependencies(lint, format) {
     const entries = [];
+    if (lint === 'markdownlint-cli2') {
+        entries.push('    "markdownlint-cli2": "^0.13.0"');
+    }
     if (format === 'oxfmt') {
         entries.push('    "oxfmt": "^0.36.0"');
     }
@@ -133,6 +136,9 @@ function buildDevDependencies(lint, format) {
 }
 function buildFumaDevDependencies(lint, format) {
     const entries = [];
+    if (lint === 'markdownlint-cli2') {
+        entries.push('    "markdownlint-cli2": "^0.13.0"');
+    }
     if (format === 'oxfmt') {
         entries.push('    "oxfmt": "^0.36.0"');
     }
@@ -161,7 +167,9 @@ function renderTemplate(template, options, depContext) {
         '{{PACKAGE_NAME}}': options.appName,
         '{{SITE_NAME}}': siteName,
         '{{SITE_DESCRIPTION}}': options.siteDescription,
-        '{{DOCS_LINT_SCRIPT}}': "echo 'docs lint disabled'",
+        '{{DOCS_LINT_SCRIPT}}': options.lint === 'markdownlint-cli2'
+            ? "markdownlint-cli2 'docs/**/*.md'"
+            : "echo 'docs lint disabled'",
         '{{DOCS_FORMAT_SCRIPT}}': options.format === 'oxfmt'
             ? "oxfmt 'docs/**/*.md'"
             : "echo 'docs formatting disabled'",

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,qBAAqB,IAAI,OAAO,CAI/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/internal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,qBAAqB,IAAI,OAAO,CAK/C"}

package/dist/commands/internal/index.js

@@ -1,7 +1,9 @@
 import { Command } from 'commander';
 import { createValidateOatSkillsCommand } from './validate-oat-skills.js';
+import { createValidateSkillVersionBumpsCommand } from './validate-skill-version-bumps.js';
 export function createInternalCommand() {
     return new Command('internal')
         .description('Internal OAT maintenance commands')
-        .addCommand(createValidateOatSkillsCommand());
+        .addCommand(createValidateOatSkillsCommand())
+        .addCommand(createValidateSkillVersionBumpsCommand());
 }

package/dist/commands/internal/validate-oat-skills.d.ts

@@ -1,9 +1,9 @@
 import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
-import { type ValidateOatSkillsResult } from '../../validation/index.js';
+import { type ValidateOatSkillsOptions, type ValidateOatSkillsResult } from '../../validation/index.js';
 import { Command } from 'commander';
 interface ValidateOatSkillsDependencies {
     buildCommandContext: (options: GlobalOptions) => CommandContext;
-    validateOatSkills: (repoRoot: string) => Promise<ValidateOatSkillsResult>;
+    validateOatSkills: (repoRoot: string, options?: ValidateOatSkillsOptions) => Promise<ValidateOatSkillsResult>;
 }
 export declare function createValidateOatSkillsCommand(overrides?: Partial<ValidateOatSkillsDependencies>): Command;
 export {};

package/dist/commands/internal/validate-oat-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-oat-skills.d.ts","sourceRoot":"","sources":["../../../src/commands/internal/validate-oat-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,6BAA6B;IACrC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC3E;AAiED,wBAAgB,8BAA8B,CAC5C,SAAS,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACrD,OAAO,CAcT"}
+{"version":3,"file":"validate-oat-skills.d.ts","sourceRoot":"","sources":["../../../src/commands/internal/validate-oat-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,6BAA6B;IACrC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,iBAAiB,EAAE,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,wBAAwB,KAC/B,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACvC;AAkED,wBAAgB,8BAA8B,CAC5C,SAAS,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACrD,OAAO,CAkBT"}

package/dist/commands/internal/validate-oat-skills.js

@@ -21,9 +21,9 @@ function reportFindings(context, result) {
     }
     context.logger.error('\nFix the issues above, then re-run: pnpm oat:validate-skills');
 }
-async function runValidateOatSkills(context, dependencies) {
+async function runValidateOatSkills(context, options, dependencies) {
     try {
-        const result = await dependencies.validateOatSkills(context.cwd);
+        const result = await dependencies.validateOatSkills(context.cwd, options);
         if (result.findings.length > 0) {
             reportFindings(context, result);
             process.exitCode = 1;
@@ -59,8 +59,9 @@ export function createValidateOatSkillsCommand(overrides = {}) {
     };
     return new Command('validate-oat-skills')
         .description('Validate required structure of oat-* workflow skills')
-        .action(async (_options, command) => {
+        .option('--base-ref <ref>', 'Also require changed canonical skills to bump version relative to this git ref')
+        .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
-        await runValidateOatSkills(context, dependencies);
+        await runValidateOatSkills(context, options, dependencies);
     });
 }

package/dist/commands/internal/validate-skill-version-bumps.d.ts

@@ -0,0 +1,10 @@
+import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
+import { type ValidateChangedSkillVersionBumpsOptions, type ValidateChangedSkillVersionBumpsResult } from '../../validation/index.js';
+import { Command } from 'commander';
+interface ValidateSkillVersionBumpsDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    validateChangedSkillVersionBumps: (repoRoot: string, options: ValidateChangedSkillVersionBumpsOptions) => Promise<ValidateChangedSkillVersionBumpsResult>;
+}
+export declare function createValidateSkillVersionBumpsCommand(overrides?: Partial<ValidateSkillVersionBumpsDependencies>): Command;
+export {};
+//# sourceMappingURL=validate-skill-version-bumps.d.ts.map

package/dist/commands/internal/validate-skill-version-bumps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-skill-version-bumps.d.ts","sourceRoot":"","sources":["../../../src/commands/internal/validate-skill-version-bumps.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,uCAAuC,EAC5C,KAAK,sCAAsC,EAC5C,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,qCAAqC;IAC7C,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gCAAgC,EAAE,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uCAAuC,KAC7C,OAAO,CAAC,sCAAsC,CAAC,CAAC;CACtD;AA8ED,wBAAgB,sCAAsC,CACpD,SAAS,GAAE,OAAO,CAAC,qCAAqC,CAAM,GAC7D,OAAO,CAyBT"}

package/dist/commands/internal/validate-skill-version-bumps.js

@@ -0,0 +1,74 @@
+import { buildCommandContext, } from '../../app/command-context.js';
+import { readGlobalOptions } from '../shared/shared.utils.js';
+import { validateChangedSkillVersionBumps as defaultValidateChangedSkillVersionBumps, } from '../../validation/index.js';
+import { Command } from 'commander';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    validateChangedSkillVersionBumps: defaultValidateChangedSkillVersionBumps,
+};
+function reportFindings(context, baseRef, result) {
+    if (context.json) {
+        context.logger.json({
+            status: 'failed',
+            baseRef,
+            validatedSkillCount: result.validatedSkillCount,
+            findings: result.findings,
+        });
+        return;
+    }
+    context.logger.error('Canonical skill version validation failed:\n');
+    for (const finding of result.findings) {
+        context.logger.error(`- ${finding.file}: ${finding.message}`);
+    }
+    context.logger.error(`\nFix the issues above, then re-run: oat internal validate-skill-version-bumps --base-ref ${baseRef}`);
+}
+async function runValidateSkillVersionBumps(context, options, dependencies) {
+    try {
+        const result = await dependencies.validateChangedSkillVersionBumps(context.cwd, options);
+        if (result.findings.length > 0) {
+            reportFindings(context, options.baseRef, result);
+            process.exitCode = 1;
+            return;
+        }
+        if (context.json) {
+            context.logger.json({
+                status: 'ok',
+                baseRef: options.baseRef,
+                validatedSkillCount: result.validatedSkillCount,
+                findings: result.findings,
+            });
+        }
+        else {
+            if (result.validatedSkillCount === 0) {
+                context.logger.info(`OK: 0 canonical skills changed relative to ${options.baseRef} - nothing to validate`);
+            }
+            else {
+                context.logger.info(`OK: validated ${result.validatedSkillCount} changed canonical skill version bump checks against ${options.baseRef}`);
+            }
+        }
+        process.exitCode = 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (context.json) {
+            context.logger.json({ status: 'error', message });
+        }
+        else {
+            context.logger.error(message);
+        }
+        process.exitCode = 2;
+    }
+}
+export function createValidateSkillVersionBumpsCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('validate-skill-version-bumps')
+        .description('Validate that changed canonical skills bump version relative to a git base ref')
+        .requiredOption('--base-ref <ref>', 'Git ref used as the comparison base for changed canonical skills')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runValidateSkillVersionBumps(context, options, dependencies);
+    });
+}

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.16';
 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.16",
   "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"
   }
-}
+}