@open-agent-toolkit/cli 0.1.15 → 0.1.16

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.1.15",
-  "docs-config": "0.1.15",
-  "docs-theme": "0.1.15",
-  "docs-transforms": "0.1.15"
+  "cli": "0.1.16",
+  "docs-config": "0.1.16",
+  "docs-theme": "0.1.16",
+  "docs-transforms": "0.1.16"
 }

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

@@ -1,6 +1,6 @@
 ---
 name: oat-project-split
-version: 1.0.0
+version: 1.1.0
 description: Use when a discovery or brainstorm should split one broad scope into coordinated OAT child projects.
 argument-hint: '--plan-file <path>'
 disable-model-invocation: true
@@ -73,10 +73,25 @@ The run command marks the parent `oat_phase: decomposition` and `oat_phase_statu
 
 If a previous split wrote a coordination parent but did not finish all children, the run command resumes from `references/split-plan.json`. Do not reconstruct missing child seed data from slugs alone.
 
+## Children Resume At Discovery (Revalidation Contract)
+
+A split seeds children with inherited context, but that context is only a **starting point**. By the time an agent resumes a child it may be stale, so children must never be treated as discovered, planned, or implementation-ready just because the split wrote their files.
+
+What the run command guarantees, and what reviewers should expect:
+
+- **Child `state.md` routes to discovery.** Each child is written with `oat_phase: discovery` and `oat_phase_status: in_progress`, plus preserved `oat_parent`, `oat_siblings`, and `oat_depends_on` links. Resume, progress, and quick-start all key off `state.md`, so they pick the child back up at discovery — not at plan or implementation.
+- **Child `discovery.md` is in progress with an unmet revalidation gate.** It carries `oat_status: in_progress` and `oat_inherited_context_revalidated: false`, an explicit "Inherited Context Revalidation Gate" section, and language stating that parent-derived scope is a seed, not a final decision. The discovery-completion gate blocks marking discovery complete until `oat_inherited_context_revalidated: true`.
+- **Child discovery is never marked complete during split generation.** Seeding only provides a provisional starting point.
+- **Placeholder `plan.md` cannot be mistaken for a real plan.** The seeded `plan.md` is re-marked as a not-started template (`oat_template: true`, `oat_template_name: plan`). Routing decisions read `state.md` (`oat_phase: discovery`), and `oat-project-next` treats `oat_template: true` as a still-a-template signal, so the placeholder never reads as plan-ready.
+
+A child sitting at `discovery` / `in_progress` after a split is **expected work-in-progress**, not stale bookkeeping. Do not flag it as drift or "skipped discovery" — revalidating inherited context is the next intended step.
+
 ## Success Criteria
 
 - Coordination parent exists and has no `spec.md`, `design.md`, `plan.md`, or `implementation.md`.
 - Parent `state.md` records `oat_kind: coordination`, ordered `oat_children`, and terminal decomposition status.
 - `references/split-plan.json` contains the full `SplitPlanDocument`.
-- Every child has seeded discovery content, parent/sibling/dependency links, and `oat_inherited_context_revalidated: false`.
+- Every child `state.md` records `oat_phase: discovery` and `oat_phase_status: in_progress` so resume/progress/quick-start route it back to discovery.
+- Every child has seeded discovery content, parent/sibling/dependency links, `oat_inherited_context_revalidated: false`, and an explicit revalidation gate; no child discovery is marked complete by the split.
+- Every child `plan.md` is a not-started template placeholder (`oat_template: true`) that never reads as plan-ready.
 - `.oat/config.local.json.activeProject` points at the repo-relative initial child path.

package/dist/projects/split/seed-children.d.ts

@@ -1,6 +1,6 @@
 import type { ChildPlan } from './child-plan.js';
 import type { SplitProjectContext } from './write-parent.js';
-declare const SEEDED_SECTIONS: readonly ["Origin", "Inherited Context", "Child Scope", "Known Dependencies", "Assumptions To Revalidate", "Likely Workflow Mode", "Sibling Projects"];
+declare const SEEDED_SECTIONS: readonly ["Origin", "Inherited Context", "Inherited Context Revalidation Gate", "Child Scope", "Known Dependencies", "Assumptions To Revalidate", "Likely Workflow Mode", "Sibling Projects"];
 export interface SeedChildrenResult {
     childProjectPaths: string[];
 }

package/dist/projects/split/seed-children.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"seed-children.d.ts","sourceRoot":"","sources":["../../../src/projects/split/seed-children.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,QAAA,MAAM,eAAe,wJAQX,CAAC;AAoFX,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,mBAAmB,EAC5B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,OAAO,CAAC,kBAAkB,CAAC,CA4C7B;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"seed-children.d.ts","sourceRoot":"","sources":["../../../src/projects/split/seed-children.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,QAAA,MAAM,eAAe,+LASX,CAAC;AA0GX,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,mBAAmB,EAC5B,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,OAAO,CAAC,kBAAkB,CAAC,CAoD7B;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/projects/split/seed-children.js

@@ -7,6 +7,7 @@ import YAML from 'yaml';
 const SEEDED_SECTIONS = [
     'Origin',
     'Inherited Context',
+    'Inherited Context Revalidation Gate',
     'Child Scope',
     'Known Dependencies',
     'Assumptions To Revalidate',
@@ -53,16 +54,38 @@ function renderSeededDiscovery(plan, child) {
         .map((candidate) => candidate.slug)
         .filter((slug) => slug !== child.slug);
     const sections = [
-        ['Origin', `Split from coordination parent \`${plan.parentSlug}\`.`],
+        [
+            'Origin',
+            `Split from coordination parent \`${plan.parentSlug}\`. This child was seeded by \`oat-project-split\`; it is **not** discovered, planned, or implementation-ready yet and resumes at discovery.`,
+        ],
         [
             'Inherited Context',
-            child.inheritedContext || 'No inherited context provided.',
+            [
+                child.inheritedContext || 'No inherited context provided.',
+                '',
+                '> Provisional seed. This context was inherited from the parent split decision. It is a **starting point, not a final scope decision** — treat every inherited claim as an assumption until it is revalidated below.',
+            ].join('\n'),
+        ],
+        [
+            'Inherited Context Revalidation Gate',
+            [
+                'This project resumes at **discovery**, not planning or implementation. Inherited context may be stale by the time work resumes, so it must be revalidated before this discovery is completed.',
+                '',
+                '- [ ] Re-read the inherited context against the current codebase and sibling progress.',
+                '- [ ] Confirm or correct the child scope, dependencies, and assumptions below.',
+                '- [ ] When revalidation is complete, set `oat_inherited_context_revalidated: true` in this file.',
+                '',
+                'Discovery cannot be marked complete — and planning must not begin — while `oat_inherited_context_revalidated: false`. A child left in this state is expected work-in-progress, not stale bookkeeping.',
+            ].join('\n'),
         ],
         ['Child Scope', child.description ?? child.slug],
         ['Known Dependencies', bulletList(child.knownDependencies)],
         [
             'Assumptions To Revalidate',
-            '- Revalidate inherited context before completing discovery.',
+            [
+                '- Revalidate inherited context before completing discovery.',
+                '- Confirm the child scope still matches reality before generating a plan.',
+            ].join('\n'),
         ],
         ['Likely Workflow Mode', 'quick'],
         ['Sibling Projects', bulletList(siblingSlugs)],
@@ -111,8 +134,16 @@ export async function seedChildren(plan, context, onlySlugs) {
             oat_siblings: siblings,
             oat_depends_on: child.knownDependencies,
         });
+        // Children resume at discovery, so their scaffolded plan.md is a
+        // placeholder only. Re-mark it as a not-started template (the scaffold
+        // strips these markers when rendering) so neither tooling nor agents can
+        // mistake the seed for an active or validated plan; routing keys off
+        // state.md (oat_phase: discovery) and oat-project-next treats
+        // oat_template: true as a still-a-template signal.
         await updateFrontmatter(join(childRoot, 'plan.md'), {
             oat_plan_source: 'quick',
+            oat_template: true,
+            oat_template_name: 'plan',
         });
         await writeFile(join(childRoot, 'discovery.md'), renderSeededDiscovery(plan, child), 'utf8');
         childProjectPaths.push(scaffold.projectPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "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.15"
+    "@open-agent-toolkit/control-plane": "0.1.16"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",