@odla-ai/cli 0.48.4 → 0.49.0

package/README.md

@@ -132,6 +132,7 @@ then read open bugs and recent decisions:
 npx --yes @odla-ai/cli@latest pm project list --app <productId>
 npx --yes @odla-ai/cli@latest pm project add --app <productId> --name "My project"
 npx --yes @odla-ai/cli@latest pm project use <projectId>
+npx --yes @odla-ai/cli@latest pm brief --app <appId> --project <projectId>
 npx --yes @odla-ai/cli@latest pm next --app <appId> --project <projectId>
 npx --yes @odla-ai/cli@latest pm handoff --app <appId>
 npx --yes @odla-ai/cli@latest pm watch --app <appId> --entity task --jsonl
@@ -142,7 +143,11 @@ npx --yes @odla-ai/cli@latest pm goal list --app <appId> --status open
 npx --yes @odla-ai/cli@latest pm decision list --app <appId> --limit 20
 ```
 
-`pm handoff` is the authoritative unresolved-state view: unmet goals, every
+`pm brief` is the bounded agent intake: exact totals, current-principal work,
+the top Ready candidates, only their context goals, and explicit expansion
+commands. `pm next --brief` and `pm handoff --brief` are aliases for that
+projection. `pm handoff` without `--brief` remains the authoritative full
+unresolved-state view: unmet goals, every
 non-done task, and every open or triaged bug. File bugs with actionable context
 (`pm bug add ... --description "reproduction/evidence"`); a title-only bug is
 rejected. When an accepted decision resolves or explicitly retains a bug, link

package/dist/bin.cjs

@@ -1777,6 +1777,7 @@ var init_surface = __esm({
       pm: {
         ...PM_ENTITIES,
         project: { list: {}, add: {}, create: {}, use: {}, set: {} },
+        brief: {},
         handoff: {},
         next: {},
         start: {},
@@ -12439,7 +12440,8 @@ Usage:
   odla-ai pm bug list [--app <id>|--platform-wide] [--status <s>] [--severity <s>] [--goal <id>] [--assignee <id>] [--decision <id>] [--q <text>] [--limit <n>] [--offset <n>] [--json]
   odla-ai pm goal add --app <id> --title <t> [--status <s>] [--proof <text>] [--target <pct>] [--mutation-id <id>] [--json]
   odla-ai pm task add --app <id> --title <t> [--column <backlog|ready|doing|review|done>] [--goal <id>|--alignment-decision <id>] [--assignee <id>] [--description <text>|--body <text>] [--acceptance <text>] [--execution <human|agent|either>] [--due <epoch-ms>] [--mutation-id <id>] [--json]
-  odla-ai pm next --app <id> [--project <id>] [--verbose] [--json]
+  odla-ai pm brief --app <id> [--project <id>] [--json]                 [bounded counts + actionable windows]
+  odla-ai pm next --app <id> [--project <id>] [--brief|--verbose] [--json]
   odla-ai pm start --app <id> [<task-id>] [--goal <id>] [--verbose] [--mutation-id <id>] [--json]   [claims the top Ready task in one call]
   odla-ai pm watch --app <id> [--cursor <cursor>] [--entity goal|task|decision|bug] [--action created|updated|deleted|comment.created|comment.updated] [--state <state>] [--by <principalId>] [--self <principalId>] [--interval <s>] [--timeout <s>] [--json|--jsonl]
   odla-ai pm task ready <id> --expected-revision <n> [--goal <id>|--alignment-decision <id>] [--description <text>|--body <text>] [--acceptance <text>] [--execution <human|agent|either>] [--mutation-id <id>] [--json]
@@ -12461,7 +12463,7 @@ Usage:
   odla-ai pm <goal|task|decision|bug> comments <id> [--json]
   odla-ai pm <goal|task|decision|bug> history <id> [--limit <n>] [--json]
   odla-ai pm <goal|task|decision|bug> rm <id>
-  odla-ai pm handoff --app <id> [--project <id>] [--verbose] [--json]
+  odla-ai pm handoff --app <id> [--project <id>] [--brief|--verbose] [--json]
   odla-ai discuss groups [--json]
   odla-ai discuss list [--app <id>] [--q <text>] [--state open|resolved|all] [--mentions] [--json]
   odla-ai discuss read <topic> [--limit <n> --offset <n>] [--json]
@@ -13797,7 +13799,36 @@ function requireApp(ctx, parsed, command) {
   if (!appId) throw new Error(`pm ${command} needs --app <appId>`);
   return { appId, projectId: stringOpt(parsed.options.project) ?? ctx.projectId };
 }
+function printBriefingSection(ctx, label, entity, section) {
+  ctx.out.log(`${label}: ${section.shown} shown of ${section.total}`);
+  if (!section.records.length) ctx.out.log("- (none)");
+  else for (const record12 of section.records) printRecord(ctx, entity, record12);
+  if (section.truncated) ctx.out.log(`  expand: ${section.expand}`);
+}
+async function pmBrief(ctx, parsed) {
+  const { appId, projectId } = requireApp(ctx, parsed, "brief");
+  const q = new URLSearchParams({ app: appId });
+  if (projectId) q.set("project", projectId);
+  const result = await pmRequest(ctx, "GET", `/briefing?${q}`);
+  emit2(ctx, result, () => {
+    ctx.out.log(`${appId}: bounded PM briefing (read only)`);
+    ctx.out.log(
+      `counts: goals ${result.counts.openGoals}; Ready ${result.counts.ready}; active tasks ${result.counts.activeTasks}; Doing ${result.counts.doing}; yours ${result.counts.currentPrincipal}; bugs ${result.counts.openBugs}`
+    );
+    printBriefingSection(ctx, "your current work", "task", result.currentWork);
+    printBriefingSection(ctx, "top Ready", "task", result.ready);
+    printBriefingSection(ctx, "context goals", "goal", result.goals);
+    printBriefingSection(ctx, "open bugs", "bug", result.openBugs);
+    if (result.counts.doing > 0) {
+      ctx.out.log(`doing expansion: ${result.expansions.doing}`);
+    }
+    ctx.out.log(`next: ${result.next}`);
+    ctx.out.log(`monitor: ${result.monitor}`);
+    ctx.out.log(`full handoff: ${result.expandFull}`);
+  });
+}
 async function pmNext(ctx, parsed) {
+  if (parsed.options.brief === true) return pmBrief(ctx, parsed);
   const { appId, projectId } = requireApp(ctx, parsed, "next");
   const verbose = wantsVerbose(parsed);
   const [goals, tasks] = await Promise.all([
@@ -13834,6 +13865,7 @@ async function pmNext(ctx, parsed) {
   });
 }
 async function pmHandoff(ctx, parsed) {
+  if (parsed.options.brief === true) return pmBrief(ctx, parsed);
   const { appId, projectId } = requireApp(ctx, parsed, "handoff");
   const verbose = wantsVerbose(parsed);
   const [goals, tasks, bugs] = await Promise.all([
@@ -14472,9 +14504,13 @@ async function pmCommand(parsed, deps = {}) {
     rejectWord(["pm", "project"], action3);
   }
   if (word === "next") {
-    assertArgs(parsed, [...COMMON_OPTIONS, "app", "project", "verbose"], 2);
+    assertArgs(parsed, [...COMMON_OPTIONS, "app", "project", "verbose", "brief"], 2);
     return pmNext(await buildContext2(parsed, deps), parsed);
   }
+  if (word === "brief") {
+    assertArgs(parsed, [...COMMON_OPTIONS, "app", "project"], 2);
+    return pmBrief(await buildContext2(parsed, deps), parsed);
+  }
   if (word === "start") {
     assertArgs(parsed, [...COMMON_OPTIONS, "app", "project", "goal", "verbose", "mutation-id"], 3);
     return pmStart(await buildContext2(parsed, deps), parsed);
@@ -14496,7 +14532,7 @@ async function pmCommand(parsed, deps = {}) {
     return pmWatch(await buildContext2(parsed, deps), parsed).then(() => void 0);
   }
   if (word === "handoff") {
-    assertArgs(parsed, [...COMMON_OPTIONS, "app", "project", "verbose"], 2);
+    assertArgs(parsed, [...COMMON_OPTIONS, "app", "project", "verbose", "brief"], 2);
     return pmHandoff(await buildContext2(parsed, deps), parsed);
   }
   const entity = ALIASES[word];