@open-agent-toolkit/cli 0.3.18 → 0.3.20

package/dist/commands/project/validate-plan/validate-plan.d.ts

@@ -1,28 +1,12 @@
-export type FrontmatterResult = {
-    kind: 'ok';
-    data: Record<string, unknown>;
-} | {
-    kind: 'no-frontmatter';
-    data: Record<string, unknown>;
-} | {
-    kind: 'invalid';
-    message: string;
-};
-export declare function parseFrontmatterFromContent(content: string): FrontmatterResult;
+export { parseFrontmatterFromContent, type FrontmatterResult, } from './frontmatter.js';
+export { extractPhaseIds, resolvePlanProfile, validateLitePlan, validatePlanForProfile, type LitePlanValidationResult, type PlanProfile, type ValidationContext, type ValidationIssue, } from './profiles.js';
 export type ValidationResult = {
     valid: true;
 } | {
     valid: false;
     errors: string[];
 };
-export type LitePlanValidationResult = {
-    ok: true;
-} | {
-    ok: false;
-    code: 'lite-multi-phase' | 'lite-parallel-groups' | 'lite-criterion-without-command';
-    message: string;
-};
-export declare function validateLitePlan(planContent: string, workflowMode: string | null | undefined): LitePlanValidationResult;
 export declare function validateParallelGroups(groups: unknown, phaseIds: readonly string[]): ValidationResult;
+/** Task-profile phase ids: unique task-heading phase ids, sorted. */
 export declare function extractPhaseIdsFromPlan(planContent: string): string[];
 //# sourceMappingURL=validate-plan.d.ts.map

package/dist/commands/project/validate-plan/validate-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-plan.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/validate-plan.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GACd,iBAAiB,CAyBnB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvC,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EACA,kBAAkB,GAClB,sBAAsB,GACtB,gCAAgC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAeN,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,wBAAwB,CA8C1B;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,gBAAgB,CAgDlB;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrE"}
+{"version":3,"file":"validate-plan.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/validate-plan.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,2BAA2B,EAC3B,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEvC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,gBAAgB,CAgDlB;AAED,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAErE"}

package/dist/commands/project/validate-plan/validate-plan.js

@@ -1,79 +1,6 @@
-import YAML from 'yaml';
-const FRONTMATTER_PATTERN = /^---\s*\n([\s\S]*?)\n---\s*(?:\n|$)/;
-export function parseFrontmatterFromContent(content) {
-    const match = content.match(FRONTMATTER_PATTERN);
-    if (!match?.[1]) {
-        return { kind: 'no-frontmatter', data: {} };
-    }
-    try {
-        const parsed = YAML.parse(match[1]);
-        if (parsed !== null &&
-            typeof parsed === 'object' &&
-            !Array.isArray(parsed)) {
-            return { kind: 'ok', data: parsed };
-        }
-        return {
-            kind: 'invalid',
-            message: 'Frontmatter did not parse as an object',
-        };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return {
-            kind: 'invalid',
-            message: `Malformed YAML in frontmatter: ${message}`,
-        };
-    }
-}
-function validationCriteria(planContent) {
-    const heading = /^## Validation Criteria[ \t]*$/m.exec(planContent);
-    if (!heading)
-        return null;
-    const bodyStart = heading.index + heading[0].length;
-    const remaining = planContent.slice(bodyStart);
-    const nextHeading = /^##\s+/m.exec(remaining);
-    const body = remaining.slice(0, nextHeading?.index ?? remaining.length);
-    return body
-        .split('\n')
-        .filter((line) => /^\s*-\s+/.test(line))
-        .map((line) => line.replace(/^\s*-\s+(?:\[[ xX]\]\s*)?/, '').trim());
-}
-export function validateLitePlan(planContent, workflowMode) {
-    if (workflowMode !== 'lite') {
-        return { ok: true };
-    }
-    const phaseCount = planContent.match(/^## Phase\b.*$/gm)?.length ?? 0;
-    if (phaseCount !== 1) {
-        return {
-            ok: false,
-            code: 'lite-multi-phase',
-            message: `Lite plans must contain exactly one phase; found ${phaseCount}.`,
-        };
-    }
-    const frontmatter = parseFrontmatterFromContent(planContent);
-    const groups = frontmatter.kind === 'invalid'
-        ? undefined
-        : frontmatter.data['oat_plan_parallel_groups'];
-    if (groups !== undefined &&
-        groups !== null &&
-        !(Array.isArray(groups) && groups.length === 0)) {
-        return {
-            ok: false,
-            code: 'lite-parallel-groups',
-            message: 'Lite plans must declare no parallel groups.',
-        };
-    }
-    const criteria = validationCriteria(planContent);
-    const invalidCriterion = criteria?.find((criterion) => !criterion.startsWith('manual:') && !/`[^`\n]+`/.test(criterion));
-    if (!criteria || criteria.length === 0 || invalidCriterion !== undefined) {
-        return {
-            ok: false,
-            code: 'lite-criterion-without-command',
-            message: 'Every lite Validation Criteria bullet must name a command in backticks or start with manual: after the bullet marker.',
-        };
-    }
-    return { ok: true };
-}
+import { extractPhaseIds } from './profiles.js';
+export { parseFrontmatterFromContent, } from './frontmatter.js';
+export { extractPhaseIds, resolvePlanProfile, validateLitePlan, validatePlanForProfile, } from './profiles.js';
 export function validateParallelGroups(groups, phaseIds) {
     // Missing or empty → valid (sequential execution, no parallelism declared)
     if (groups === undefined || groups === null) {
@@ -116,11 +43,7 @@ export function validateParallelGroups(groups, phaseIds) {
     }
     return errors.length > 0 ? { valid: false, errors } : { valid: true };
 }
+/** Task-profile phase ids: unique task-heading phase ids, sorted. */
 export function extractPhaseIdsFromPlan(planContent) {
-    const matches = planContent.match(/### Task (p\d+)-t\d+/g) ?? [];
-    const ids = matches.map((m) => {
-        const parts = m.split(' ');
-        return parts[2].split('-')[0];
-    });
-    return Array.from(new Set(ids)).sort();
+    return extractPhaseIds(planContent, 'task');
 }

package/dist/commands/shared/frontmatter.d.ts

@@ -24,7 +24,7 @@ export declare const SKILL_GATE_OVERRIDE_SOURCE = "state.md:oat_skill_gate_overr
  * `skills.test.ts` pins this constant against the live `oat_gateable: true`
  * declarations so the two cannot drift apart.
  */
-export declare const GATE_AWARE_SKILLS: readonly ['oat-project-implement', 'oat-project-import-plan', 'oat-project-lite', 'oat-project-plan', 'oat-project-quick-start'];
+export declare const GATE_AWARE_SKILLS: readonly ['oat-project-brief', 'oat-project-goal', 'oat-project-implement', 'oat-project-import-plan', 'oat-project-lite', 'oat-project-plan', 'oat-project-quick-start'];
 export type SkillGateOverrideValue = typeof SKILL_GATE_OVERRIDE_DISABLED;
 export interface ProjectSkillGateOverrides {
     /** False when the key is absent entirely: absence means follow configuration. */

package/dist/commands/shared/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/frontmatter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/frontmatter.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/frontmatter.js

@@ -69,6 +69,8 @@ export const SKILL_GATE_OVERRIDE_SOURCE = `state.md:${SKILL_GATE_OVERRIDE_FIELD}
  * declarations so the two cannot drift apart.
  */
 export const GATE_AWARE_SKILLS = [
+    'oat-project-brief',
+    'oat-project-goal',
     'oat-project-implement',
     'oat-project-import-plan',
     'oat-project-lite',

package/dist/commands/state/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/state/generate.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAmB9E,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA0ID,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC/B,OAAO,CAET;AAomBD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAkF9B"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/state/generate.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAoB9E,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA0ID,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAC/B,OAAO,CAET;AA8rBD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAkF9B"}

package/dist/commands/state/generate.js

@@ -11,7 +11,7 @@ import { resolveProjectsRoot } from '../shared/oat-paths.js';
 import { resolveScopeRoot } from '../shared/project-scope.js';
 import { readOatLocalConfig } from '../../config/oat-config.js';
 import { ensureDir, fileExists } from '../../fs/io.js';
-import { evaluateQuickPlanReadiness, quickPlanNotReadyReason, } from '@open-agent-toolkit/control-plane';
+import { BRIEF_MODES, evaluateQuickPlanReadiness, quickPlanNotReadyReason, } from '@open-agent-toolkit/control-plane';
 import YAML from 'yaml';
 const defaultGit = {
     isGitRepo(root) {
@@ -238,6 +238,34 @@ function calculateStaleness(knowledge, git, repoRoot, today) {
     }
     return result;
 }
+/**
+ * True when the frontmatter workflow mode belongs to the brief mode family.
+ * The dashboard keeps the raw frontmatter string, so it checks membership
+ * against the control plane's registry rather than a local list.
+ */
+function isBriefWorkflow(workflowMode) {
+    return BRIEF_MODES.includes(workflowMode);
+}
+/**
+ * Printed for brief projects in the implement phase, where the router's
+ * brief-unit guard applies. The dashboard reads `state.md` frontmatter only
+ * and never phase-unit progress, so it cannot apply that guard at
+ * `implement:complete`/`pr_open`.
+ */
+const BRIEF_ROUTER_AUTHORITY_NOTE = '> Brief projects count progress in phase-units, which this dashboard does not read. ' +
+    '`oat project status` and `oat-project-next` use the control-plane router, which is the ' +
+    'authority for the brief-unit guard: an unaccepted phase-unit sends the project back to ' +
+    '`oat-project-implement` before any finalization step.';
+/**
+ * Printed for goal projects in the implement phase. Goal routing reads
+ * milestone membership, recovery records, gate carriers, the delivery
+ * registry and phase-unit progress, none of which this dashboard reads.
+ */
+const GOAL_ROUTER_AUTHORITY_NOTE = '> Goal projects route by milestone status, recovery records, gate carriers, the delivery ' +
+    'registry and phase-units, which this dashboard does not read. `oat project status` and ' +
+    '`oat-project-next` use the control-plane router, which is the authority for goal milestone ' +
+    'routing: it scopes implementation to the active milestone and sends review, delivery and ' +
+    'recovery work to its owner.';
 function computeNextStep(project, hasProjects, state) {
     if (project.status === 'not set') {
         if (project.lastPausedProject) {
@@ -283,11 +311,17 @@ function computeNextStep(project, hasProjects, state) {
         // projects whose state.md still lists `spec` in oat_hill_checkpoints route
         // to oat-project-design here so they finish through the consolidated flow
         // rather than being pushed back at the deprecated standalone skill.
+        // Brief modes own their plan phase through the brief entry skill, as the
+        // router's mode-aware current-phase lookup does.
         const phaseSkillMap = {
             discovery: 'oat-project-discover',
             spec: 'oat-project-design',
             design: 'oat-project-design',
-            plan: 'oat-project-plan',
+            plan: state.workflowMode === 'goal'
+                ? 'oat-project-goal'
+                : isBriefWorkflow(state.workflowMode)
+                    ? 'oat-project-brief'
+                    : 'oat-project-plan',
             implement: 'oat-project-implement',
         };
         return {
@@ -366,6 +400,41 @@ function computeNextStep(project, hasProjects, state) {
             step: 'oat-project-lite',
             reason: 'Continue lite planning',
         },
+        // Brief routes mirror the router's BRIEF_ROUTES. Parity with
+        // `recommendSkill` is bounded to these plan-phase states and
+        // `implement:in_progress` (generate.test.ts pins it): this dashboard has no
+        // phase-unit progress, so at `implement:complete`/`pr_open` a brief follows
+        // the shared post-implementation map below and the router, reached through
+        // `oat project status` and `oat-project-next`, is the authority for the
+        // brief-unit guard. The dashboard prints a note saying so.
+        'brief:plan:in_progress': {
+            step: 'oat-project-brief',
+            reason: 'Continue the project brief',
+        },
+        'brief:plan:complete': {
+            step: 'oat-project-implement',
+            reason: 'Start implementation from the approved brief',
+        },
+        'brief:implement:in_progress': {
+            step: 'oat-project-implement',
+            reason: 'Continue implementation',
+        },
+        // Goal plan rows mirror the router's GOAL_ROUTES: the goal entry skill
+        // owns the brief, its milestones and milestone activation. Parity is
+        // bounded like brief's; in the implement phase the router's goal priority
+        // block is the authority and the dashboard prints a note saying so.
+        'goal:plan:in_progress': {
+            step: 'oat-project-goal',
+            reason: 'Continue the goal brief and its milestones',
+        },
+        'goal:plan:complete': {
+            step: 'oat-project-goal',
+            reason: 'Align and activate the first milestone',
+        },
+        'goal:implement:in_progress': {
+            step: 'oat-project-implement',
+            reason: 'Continue implementation',
+        },
     };
     if (routeMap[key])
         return routeMap[key];
@@ -563,6 +632,15 @@ function buildDashboardMarkdown(project, state, knowledge, staleness, nextStep,
     lines.push('');
     lines.push(`**${nextStep.step}** - ${nextStep.reason}`);
     lines.push('');
+    if (project.status === 'active' &&
+        state &&
+        state.phase === 'implement' &&
+        isBriefWorkflow(state.workflowMode)) {
+        lines.push(state.workflowMode === 'goal'
+            ? GOAL_ROUTER_AUTHORITY_NOTE
+            : BRIEF_ROUTER_AUTHORITY_NOTE);
+        lines.push('');
+    }
     lines.push('## Quick Commands');
     lines.push('');
     lines.push('- `oat-project-progress` - Check current status');
@@ -571,6 +649,8 @@ function buildDashboardMarkdown(project, state, knowledge, staleness, nextStep,
     lines.push('- `oat-project-quick-start` - Create a quick workflow project');
     lines.push('- `oat-project-import-plan` - Import an external provider plan');
     lines.push('- `oat-project-lite` - Create a lite workflow project');
+    lines.push('- `oat-project-brief` - Create a brief workflow project');
+    lines.push('- `oat-project-goal` - Create a goal workflow project');
     lines.push('- `oat project open <name>` - Open or resume a project');
     lines.push('- `oat project pause [name]` - Pause active or named project');
     lines.push('- `oat-project-complete` - Mark project complete');

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

@@ -1 +1 @@
-{"version":3,"file":"pack-manifest.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/shared/pack-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACf,CAAC;AAEF,eAAO,MAAM,UAAU,4GASiB,CAAC;AAEzC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAoID,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EA2LlD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAMhE;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,aAAa,GACnB,SAAS,mBAAmB,EAAE,CAGhC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAC9C,MAAM,EAAE,CAQV;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAIlE;AAoJD,wBAAgB,oBAAoB,CAClC,QAAQ,GAAE,SAAS,cAAc,EAAkB,GAClD,IAAI,CAiEN"}
+{"version":3,"file":"pack-manifest.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/shared/pack-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,EACd,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,cAAc,GACf,CAAC;AAEF,eAAO,MAAM,UAAU,4GASiB,CAAC;AAEzC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAsID,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EA6LlD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAMhE;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,IAAI,CAAC,EAAE,aAAa,GACnB,SAAS,mBAAmB,EAAE,CAGhC;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAC9C,MAAM,EAAE,CAQV;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAIlE;AAoJD,wBAAgB,oBAAoB,CAClC,QAAQ,GAAE,SAAS,cAAc,EAAkB,GAClD,IAAI,CAiEN"}

package/dist/commands/tools/shared/pack-manifest.js

@@ -77,6 +77,7 @@ const WORKFLOW_SKILL_NAMES = [
     'oat-cursor-cloud-projects',
     'oat-explainer-kit',
     'oat-project-autonomous',
+    'oat-project-brief',
     'oat-project-capture',
     'oat-project-clear-active',
     'oat-project-complete',
@@ -85,6 +86,7 @@ const WORKFLOW_SKILL_NAMES = [
     'oat-project-dispatch-subagents',
     'oat-project-discover',
     'oat-project-document',
+    'oat-project-goal',
     'oat-project-implement',
     'oat-project-import-plan',
     'oat-project-lite',
@@ -193,7 +195,9 @@ export const PACK_MANIFEST = [
                 'design.md',
                 'plan.md',
                 'plan-lite.md',
+                'plan-brief.md',
                 'implementation.md',
+                'implementation-brief.md',
                 'summary.md',
                 'project-log.md',
                 'project-retro.md',

package/package.json

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