@open-agent-toolkit/cli 0.2.20 → 0.2.21

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

@@ -1,6 +1,6 @@
 ---
 name: oat-project-implement
-version: 2.1.9
+version: 2.2.0
 description: Use when plan.md is ready for execution. Dispatches one phase implementer per phase, owns independent phase review and bounded fix routing, and supports plan-declared worktree-isolated parallel phases.
 oat_gateable: true
 argument-hint: '[--retry-limit <N>] [--dry-run]'

package/assets/skills/oat-project-implement/references/completion-and-closeout.md

@@ -751,7 +751,13 @@ Before generating, inspect the active project's explainer runs. A fresh `project
 Resolve recap intent through `oat-explainer-kit`. When `OAT_AUTONOMOUS=1` and no fresh recap exists, attempt `project-recap` exactly once; missing or stale persisted intent cannot suppress this autonomous attempt. Interactive mode honors the adapter's resolved persisted or workflow intent.
 
 Invoke the `oat-explainer-kit` adapter first, then run its shared tracked-run finalizer in `dedicated` mode for a successful build. Use the adapter result and finalizer result as returned; do not improvise commits, durability evidence, or reruns. Outcomes `failed` and `built-not-durable` are recorded warnings, never blockers for final HiLL approval, completion reporting, or later PR steps.
-Supply the provider-neutral critic callback (or validated critic module entry point for JSON/CLI invocation) on every federated adapter run.
+For an adapter invocation, construct exactly one brief-aware,
+provider-neutral author seam using
+`oat-explainer-kit/references/author-callback.md`. In-process callers pass
+`author`; JSON/CLI callers pass a validated `authorModulePath`. Supply it
+alongside the existing `critic` callback (or validated
+`criticModulePath`), and always invoke this implementation-tail recap with
+`mode: unattended`.
 
 Always include the selected or attempted recap's outcome and run path in the
 implementation completion report. If `summary.md` exists, append or refresh its

package/assets/skills/oat-wave-execute/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-wave-execute
-version: 1.7.1
+version: 1.8.0
 description: Use when executing a wave of external implementation plans as a wrapper OAT project — scaffolding, drift refresh, parallel worktree groups, briefs, gates, merge choreography, and closeout.
 argument-hint: '<wave-id> [plan-names...] (e.g. wave-2 http-listener-before-indexing ...)'
 disable-model-invocation: false
@@ -411,24 +411,17 @@ exactly:
 `schemaVersion, generatedAt, mode, freshnessPolicy, sources, claims, unresolvedClaims, overrides`.
 
 The caller also owns CONTENT AUTHORING, exactly as it owns critic execution and
-fact-base synthesis: the kit's pipeline validates structure and fact
-consistency, but nothing in it owns prose quality. An unattended recap run
-without a caller-supplied authoring path emits raw federated artifact text as
-deck prose (stoa W6 live evidence, run-19af6e55: implementation.md pasted
-verbatim, frontmatter included, tables flattened to run-on prose — every
-automated gate passed it). The explainer-kit now enforces this seam: every
-unattended run requires exactly one provider-neutral author seam — in-process
-callers supply an `author(request)` callback; JSON/CLI callers supply
-`authorModulePath` naming a module with an `author` function export. The core
-invokes it once per recipe artifact with an `explainer-kit.author-request/v1`
-document and expects an `explainer-kit.author-result/v1` reply; runs fail if
-the author is absent, returns an invalid result, or copies excessive verbatim
-source text. Recap callers MUST satisfy that seam by authoring content from
-the synthesized fact base plus the recipe outline (LLM-authored from
-summary/synthesis material, as the operator-approved W6 rebuild demonstrates)
-or NOT run the unattended build, recording the skip disposition per the
-optional-step rule. Callbacks and module paths never enter the persisted run
-request.
+fact-base synthesis: the kit validates structure and fact consistency, but
+nothing in it owns prose quality. Every recap run requires exactly one
+provider-neutral author seam — in-process callers supply an `author(request)`
+callback; JSON/CLI callers supply `authorModulePath` naming a module with an
+`author` function export. The core invokes it for every floor and accepted
+expansion artifact with `author-request/v2`: the artifact brief is inlined,
+the fact base is attached, and artistic requests include the resolved theme
+and hash-pinned shell. Authors may propose only recipe-declared expansion
+profiles and return `author-result/v2`; runs fail on absent or invalid author
+results or excessive verbatim source copying. Callbacks and module paths never
+enter persisted run requests.
 
 The mechanical caller constructs an `explainer-kit.run-request/v1` document whose
 required keys are exactly:

package/assets/skills/oat-wave-program/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-wave-program
-version: 1.3.1
+version: 1.4.0
 description: Use when decomposing a corpus of external implementation plans into an ordered wave program — coverage inventory, dependency mapping, wave composition, and the durable execution-program artifact that oat-wave-execute consumes and updates.
 argument-hint: '[new|refresh|wave-close <wave-id>] (default: refresh against the current artifact)'
 disable-model-invocation: false
@@ -136,18 +136,17 @@ required keys are exactly:
 `schemaVersion, generatedAt, mode, freshnessPolicy, sources, claims, unresolvedClaims, overrides`.
 
 The caller also owns CONTENT AUTHORING, exactly as it owns critic execution and
-fact-base synthesis: the kit's pipeline validates structure and fact
-consistency, but nothing in it owns prose quality. An unattended recap run
-without a caller-supplied authoring path emits raw federated artifact text as
-deck prose (stoa W6 live evidence, run-19af6e55: implementation.md pasted
-verbatim, frontmatter included, tables flattened to run-on prose — every
-automated gate passed it). Until the explainer-kit ships its authoring seam (a
-caller-supplied author callback / `authorModulePath`, pending upstream),
-wave-close/program-close recap callers MUST either author the content document
-from the synthesized fact base plus the recipe outline (LLM-authored from
-summary/synthesis material, as the operator-approved W6 rebuild demonstrates)
-or NOT run the unattended build, recording the skip disposition per the
-optional-step rule.
+fact-base synthesis: the kit validates structure and fact consistency, but
+nothing in it owns prose quality. Every recap run requires exactly one
+provider-neutral author seam — in-process callers supply an `author(request)`
+callback; JSON/CLI callers supply `authorModulePath` naming a module with an
+`author` function export. The core invokes it for every floor and accepted
+expansion artifact with `author-request/v2`: the artifact brief is inlined,
+the fact base is attached, and artistic requests include the resolved theme
+and hash-pinned shell. Authors may propose only recipe-declared expansion
+profiles and return `author-result/v2`; runs fail on absent or invalid author
+results or excessive verbatim source copying. Callbacks and module paths never
+enter persisted run requests.
 
 The mechanical caller constructs an `explainer-kit.run-request/v1` document whose
 required keys are exactly:

package/package.json

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

package/assets/skills/explainer-kit/schemas/author-request.schema.json

@@ -1,85 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "explainer-kit.author-request/v1",
-  "title": "AuthorRequestV1",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "schemaVersion",
-    "run",
-    "recipe",
-    "artifact",
-    "narrativeOutline",
-    "factBase",
-    "discovery"
-  ],
-  "properties": {
-    "schemaVersion": { "const": "explainer-kit.author-request/v1" },
-    "run": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["runId", "slug"],
-      "properties": {
-        "runId": { "type": "string", "minLength": 1 },
-        "slug": {
-          "type": "string",
-          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
-        }
-      }
-    },
-    "recipe": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "version", "requiredNarrative"],
-      "properties": {
-        "id": { "type": "string", "minLength": 1 },
-        "version": { "type": "string", "minLength": 1 },
-        "requiredNarrative": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 },
-          "minItems": 1,
-          "uniqueItems": true
-        }
-      }
-    },
-    "artifact": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "type"],
-      "properties": {
-        "id": { "type": "string", "minLength": 1 },
-        "type": { "enum": ["hub", "diagram", "explainer", "deck", "catalog"] }
-      }
-    },
-    "narrativeOutline": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["id", "title"],
-        "properties": {
-          "id": { "type": "string", "minLength": 1 },
-          "title": { "type": "string", "minLength": 1 }
-        }
-      },
-      "minItems": 1,
-      "uniqueItems": true
-    },
-    "factBase": { "$ref": "explainer-kit.fact-base/v1" },
-    "discovery": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["rounds", "findings", "reason"],
-      "properties": {
-        "rounds": { "type": "integer", "minimum": 0 },
-        "findings": {
-          "type": "array",
-          "items": { "type": "string", "minLength": 1 }
-        },
-        "reason": {
-          "enum": ["not-requested", "two-empty-rounds", "hard-maximum"]
-        }
-      }
-    }
-  }
-}

package/assets/skills/explainer-kit/schemas/author-result.schema.json

@@ -1,65 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "explainer-kit.author-result/v1",
-  "title": "AuthorResultV1",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "artifactId", "content", "provenance"],
-  "properties": {
-    "schemaVersion": { "const": "explainer-kit.author-result/v1" },
-    "artifactId": { "type": "string", "minLength": 1 },
-    "content": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["title", "description", "sections"],
-      "properties": {
-        "title": { "type": "string", "minLength": 1 },
-        "description": { "type": "string", "minLength": 1 },
-        "eyebrow": { "type": "string", "minLength": 1 },
-        "footer": { "type": "string", "minLength": 1 },
-        "sections": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["id", "title", "prose"],
-            "properties": {
-              "id": { "type": "string", "minLength": 1 },
-              "title": { "type": "string", "minLength": 1 },
-              "prose": { "type": "string", "minLength": 1 }
-            }
-          },
-          "minItems": 1,
-          "uniqueItems": true
-        },
-        "artifactLinks": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "additionalProperties": false,
-            "required": ["id", "type", "label"],
-            "properties": {
-              "id": { "type": "string", "minLength": 1 },
-              "type": {
-                "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
-              },
-              "label": { "type": "string", "minLength": 1 }
-            }
-          },
-          "uniqueItems": true
-        }
-      }
-    },
-    "provenance": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["authorId", "generatedAt"],
-      "properties": {
-        "authorId": { "type": "string", "minLength": 1 },
-        "generatedAt": { "type": "string", "format": "date-time" },
-        "method": { "type": "string", "minLength": 1 },
-        "model": { "type": "string", "minLength": 1 }
-      }
-    }
-  }
-}