@open-agent-toolkit/cli 0.1.52 → 0.1.54

package/assets/skills/oat-repo-maintainability-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: oat-repo-maintainability-review
-version: 1.2.0
-description: Use when you need a structured maintainability analysis for a repository or directory target with actionable findings.
+version: 1.3.0
+description: Use when you need a structured maintainability analysis for a repository or directory target with actionable findings and an optional external-plan handoff.
 argument-hint: '[--scope repo|directory] [--target <path>] [--mode auto|tracked|local|inline] [--output <path>] [--focus <areas>] [--analysis-mode full] [--fan-out]'
 disable-model-invocation: true
 user-invocable: true
@@ -42,11 +42,12 @@ Analyze repository maintainability and developer experience using a deterministi
   - ` OAT ▸ REPO MAINTAINABILITY REVIEW`
   - `━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`
 - Print step indicators before major work:
-  - `[1/5] Resolving scope, arguments, and output policy...`
-  - `[2/5] Collecting repository evidence...`
-  - `[3/5] Running dimension analysis (single-agent or multi-agent)...`
-  - `[4/5] Synthesizing findings and scoring...`
-  - `[5/5] Rendering artifact and summary...`
+  - `[1/6] Resolving scope, arguments, and output policy...`
+  - `[2/6] Collecting repository evidence...`
+  - `[3/6] Running dimension analysis (single-agent or multi-agent)...`
+  - `[4/6] Synthesizing findings and scoring...`
+  - `[5/6] Rendering artifact and summary...`
+  - `[6/6] (Optional) Handing selected findings to repo improve...` — only print after the user accepts the offer
 - For long-running fan-out or large scans, print start + completion lines.
 - Print a resolved run-options summary before evidence collection begins.
 
@@ -58,6 +59,7 @@ Analyze repository maintainability and developer experience using a deterministi
 4. Gather evidence across required dimensions.
 5. Synthesize findings into prioritized recommendations.
 6. Render artifact or return inline output.
+7. Offer a scoped external-plan handoff when a file artifact exists.
 
 ### Output Policy Resolution
 
@@ -190,9 +192,22 @@ Final user-facing summary must include:
 - Artifact path (`inline-only` when no file is emitted)
 - Execution mode (`single-agent` or `multi-agent`)
 
+### Optional Repo Improve Handoff
+
+When tracked or local output produced a file artifact, offer one bounded next step after the completion summary:
+
+> Want to turn selected findings from this maintainability review into self-contained external implementation plans with `oat-repo-improve`?
+
+If the user accepts, invoke `oat-repo-improve` in `maintainability-review` mode and pass the exact artifact path. That skill must use this artifact as its candidate source and perform only bounded live-evidence verification; it must not repeat a full repository audit. The user selects which findings become plans.
+
+If output was inline-only, explain that the handoff requires a file-backed review artifact. Offer to render the completed review to the normal tracked/local destination before invoking `oat-repo-improve`; do not silently create it.
+
+The maintainability-review skill never writes external plans itself. `oat-repo-improve` is the sole owner of `.oat/repo/reference/external-plans/` output for this flow.
+
 ## Success Criteria
 
 - Output includes required sections and metadata.
 - Findings include scoring fields and evidence.
 - Result includes now/next/later execution guidance.
 - Required arguments are explicitly resolved before analysis execution.
+- File-backed runs offer an optional, source-scoped `oat-repo-improve maintainability-review <artifact>` handoff without re-auditing the repository.

package/assets/templates/backlog-item.md

@@ -10,6 +10,7 @@ assignee: null
 created: '{ISO 8601 UTC}'
 updated: '{ISO 8601 UTC}'
 associated_issues: []
+external_plans: [] # repo-relative .oat/repo/reference/external-plans/*.md paths
 oat_template: true
 oat_template_name: backlog-item
 ---

package/assets/templates/pjm-agents.md

@@ -60,6 +60,14 @@ doctor` surfaces this drift.
 recent commits against open items: work that shipped without a close-out
 should be closed retroactively with a note.
 
+## External Plan Reverse Links
+
+Backlog item frontmatter may include `external_plans`, a YAML string array of
+repo-relative paths under `.oat/repo/reference/external-plans/`.
+`oat-repo-improve` owns additions to this field after a plan write succeeds.
+Preserve existing links, deduplicate additions, and never link a failed or
+partial write. These are durable source-to-plan references, not project status.
+
 ## Project Kickoff Handoffs
 
 `handoffs/` holds one-shot kickoff prompts — consumable context for turning a

package/assets/templates/reference-agents.md

@@ -9,7 +9,9 @@ This directory owns append-mostly reference material.
 
 - `decisions/` stores file-per-record decisions and the generated decision index.
 - `project-summaries/` stores archived project summaries.
-- `external-plans/` stores imported provider or external plans.
+- `external-plans/` stores imported provider plans and external implementation
+  plans generated by `oat-repo-improve`. Improve owns plan generation; project
+  import optionally normalizes one selected file into an OAT project.
 - Create research, brainstorm, and deck folders on demand when a workflow needs them.
 - Do not put active roadmap, current-state, or backlog records directly under `reference/`.
 

package/dist/commands/init/tools/shared/skill-manifest.d.ts

@@ -11,7 +11,7 @@ export interface PackMetadata {
 }
 export declare const PACK_METADATA: Record<string, PackMetadata>;
 export declare function resolvePackDefaultScope(packName: string): 'user' | 'project';
-export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-provide-remote", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-split", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
+export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-dispatch-subagents", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-provide-remote", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-split", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
 export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-phase-implementer.md", "oat-reviewer.md"];
 export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];
@@ -19,7 +19,7 @@ export declare const IDEA_SKILLS: readonly ["oat-idea-new", "oat-idea-ideate", "
 export declare const CORE_SKILLS: readonly ["oat-docs", "oat-doctor"];
 export declare const DOCS_SKILLS: readonly ["authoring-docs", "oat-agent-instructions-analyze", "oat-agent-instructions-apply", "oat-docs-analyze", "oat-docs-apply", "oat-docs-authoring", "oat-docs-bootstrap"];
 export declare const DOCS_SCRIPTS: readonly ["resolve-tracking.sh"];
-export declare const UTILITY_SKILLS: readonly ["create-agnostic-skill", "oat-repo-maintainability-review", "oat-review-provide", "oat-review-provide-remote", "oat-review-receive", "oat-review-receive-remote"];
+export declare const UTILITY_SKILLS: readonly ["create-agnostic-skill", "oat-dispatch-subagents", "oat-repo-improve", "oat-repo-maintainability-review", "oat-review-provide", "oat-review-provide-remote", "oat-review-receive", "oat-review-receive-remote"];
 export declare const PROJECT_MANAGEMENT_SKILLS: readonly ["oat-pjm-add-backlog-item", "oat-pjm-decision", "oat-pjm-update-repo-reference", "oat-pjm-review-backlog"];
 export declare const PROJECT_MANAGEMENT_TEMPLATES: readonly ["backlog-item.md", "roadmap.md", "current-state.md", "decision.md", "repo-agents.md", "pjm-agents.md", "reference-agents.md"];
 export declare const PROJECT_MANAGEMENT_SCRIPTS: readonly [];

package/dist/commands/init/tools/shared/skill-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,6xBAgClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,iLAQd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,6KAOjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,sHAK5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,yIAQ/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,+zBAiClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,iLAQd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,2NASjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,sHAK5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,yIAQ/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}

package/dist/commands/init/tools/shared/skill-manifest.js

@@ -20,6 +20,7 @@ export const WORKFLOW_SKILLS = [
     'oat-project-clear-active',
     'oat-project-complete',
     'oat-project-design',
+    'oat-project-dispatch-subagents',
     'oat-project-discover',
     'oat-project-document',
     'oat-project-implement',
@@ -90,6 +91,8 @@ export const DOCS_SCRIPTS = ['resolve-tracking.sh'];
 // ── Utility pack ───────────────────────────────────────────────────
 export const UTILITY_SKILLS = [
     'create-agnostic-skill',
+    'oat-dispatch-subagents',
+    'oat-repo-improve',
     'oat-repo-maintainability-review',
     'oat-review-provide',
     'oat-review-provide-remote',

package/package.json

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