@open-agent-toolkit/cli 0.3.18 → 0.3.19

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,24 @@ 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.';
 function computeNextStep(project, hasProjects, state) {
     if (project.status === 'not set') {
         if (project.lastPausedProject) {
@@ -283,11 +301,15 @@ 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: isBriefWorkflow(state.workflowMode)
+                ? 'oat-project-brief'
+                : 'oat-project-plan',
             implement: 'oat-project-implement',
         };
         return {
@@ -366,6 +388,25 @@ 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',
+        },
     };
     if (routeMap[key])
         return routeMap[key];
@@ -563,6 +604,13 @@ 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(BRIEF_ROUTER_AUTHORITY_NOTE);
+        lines.push('');
+    }
     lines.push('## Quick Commands');
     lines.push('');
     lines.push('- `oat-project-progress` - Check current status');
@@ -571,6 +619,7 @@ 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 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;AAqID,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',
@@ -193,7 +194,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.19",
   "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.19"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",