breakaway 1.2.1-main.12 → 1.2.1-main.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "breakaway",
-  "version": "1.2.1-main.12",
+  "version": "1.2.1-main.13",
   "description": "The task board for you and your coding agents: a Cloudflare Worker, its web app, Taskwarrior sync, and the CLI (npx breakaway).",
   "license": "FSL-1.1-Apache-2.0",
   "type": "module",

package/scripts/tasks/cli.js

@@ -143,15 +143,17 @@ export function forceFields(force, by) {
 /**
  * `agents new`: the request that makes a task from a prompt and starts an agent on it. It's the checkout's repository
  * unless `--repo` names another. It always says who asks, so the board refuses an agent's name: only the owner starts one.
+ * With `decision` (`agents new --decision <ID> ["<note>"]`, BRK-110) the board writes the prompt from that answered
+ * decision, in the decision's repository, and the text is the owner's note under it.
  * @param {string} prompt
- * @param {{ repo?: string | null, force?: boolean, by?: string }} [options]
+ * @param {{ repo?: string | null, force?: boolean, by?: string, decision?: string | null }} [options]
  */
-export function generalAgentRequest(prompt, { repo = null, force = false, by } = {}) {
+export function generalAgentRequest(prompt, { repo = null, force = false, by, decision = null } = {}) {
   const text = String(prompt ?? '').trim();
-  if (!text)
+  if (!text && !decision)
     return { error: 'say what the agent should do: npx breakaway agents new "Tidy the docs" [--image <file>]' };
   const body = {
-    prompt: text,
+    ...(decision ? { decision, ...(text ? { note: text } : {}) } : { prompt: text }),
     ...(repo ? { repo } : {}),
     ...(force ? { force: true } : {}),
     ...(by ? { by } : {}),
@@ -161,11 +163,12 @@ export function generalAgentRequest(prompt, { repo = null, force = false, by } =
 
 /**
  * What the CLI says about a general agent's answer: the task and that it started, or why it waits (and whether Force
- * start could skip that).
- * @param {{ task: { wid?: string, short?: string }, run?: { url?: string, agent?: string } | null, waiting?: string | null, forceable?: boolean }} answer
+ * start could skip that), or, from a decision, the open one that already has it.
+ * @param {{ task: { wid?: string, short?: string }, run?: { url?: string, agent?: string } | null, waiting?: string | null, forceable?: boolean, already?: string | null }} answer
  */
-export function generalAgentSummary({ task, run, waiting, forceable }) {
+export function generalAgentSummary({ task, run, waiting, forceable, already }) {
   const id = task.wid ?? task.short;
+  if (!run && already) return `${id} already refines from these answers: ${already}.`;
   if (run) return `Started ${run.agent ? `${run.agent} ` : 'an agent '}on ${id}${run.url ? `: ${run.url}` : ''}`;
   return `Saved ${id}, waiting to start: ${waiting ?? 'no room yet'}.${forceable ? ` Start it now past the board's limits: npx breakaway agents start ${id} --force` : ''}`;
 }

package/scripts/tasks.mjs

@@ -138,6 +138,7 @@ Reading                (list, next, claim, and add work in this checkout's repos
   activity               recent changes, newest first  [--limit <n>]
   agents                 cloud agents: what's running, what's waiting to start
   agents new "<prompt>"  start an agent from a prompt: it makes its own task  [--image <file>]… [--repo <slug>] [--force] (owner)
+  agents new --decision <ref> ["<note>"]   start an agent that brings the work waiting for an answered decision in line with its answers; the board writes its prompt  [--force] (owner)
   agents start <ref>     start a Claude cloud agent on a task  [--note <text>] [--force]
   agents refine <ref>    start an agent that improves a task, not builds it  --note <what to look at or change> [--force]
   agents plan [<plan>]   your Claude plan and what it allows; pro, max5, or max20 picks one (owner) and sets the limits to its defaults
@@ -762,8 +763,11 @@ const commands = {
       return;
     }
     if (sub === 'new') {
+      const decision = typeof opts.decision === 'string' ? opts.decision : null;
       const built = generalAgentRequest(args.slice(1).join(' '), {
-        repo: opts.repo ?? (await checkoutRepo()).slug,
+        // From a decision, the board runs it in the decision's repository unless --repo says otherwise.
+        repo: opts.repo ?? (decision ? null : (await checkoutRepo()).slug),
+        decision,
         force: Boolean(opts.force),
         by: opts.as ?? setting('AGENT'),
       });

package/src/cli-version.js

@@ -4,5 +4,5 @@
  * and how to update it. scripts/tasks/version.test.js fails when the copied files change and this doesn't:
  * so it lives in the board's package (CLD-135) and the CLI imports it from here.
  */
-export const CLI_VERSION = 53;
-export const CLI_FINGERPRINT = '2254d8fb27cd3d52';
+export const CLI_VERSION = 54;
+export const CLI_FINGERPRINT = 'c5c5e4b72de52bfb';

package/src/decision.js

@@ -239,3 +239,75 @@ export function summarize(questions, answers) {
   });
   return `Decided by the owner: ${parts.join('; ')}`;
 }
+
+/** Tags that aren't a feature's (IDEA-28 section 1): the board's own, horizons, and release tags. */
+const NOT_FEATURES = new Set(['agent', 'owner', 'decide', 'idea', 'general']);
+export const featureTags = (tags) =>
+  (tags ?? []).filter((t) => !NOT_FEATURES.has(t) && !t.startsWith('horizon-') && !/^v\d/u.test(t));
+
+/** One answer as words, in full but for a long open answer. */
+function spell(q, answer) {
+  if (!answer) return 'no answer';
+  if (q.type === 'open') return clip(answer.value.trim(), 1500);
+  const label = (id) =>
+    id === 'other' ? `something else: ${answer.other}` : (q.options.find((o) => o.id === id)?.label ?? id);
+  if (q.type === 'choice') return label(answer.value);
+  if (q.type === 'multi') return answer.value.length ? answer.value.map(label).join(', ') : 'none';
+  if (q.type === 'rank') return answer.value.map((id, i) => `${i + 1}. ${label(id)}`).join(', ');
+  if (q.type === 'scale')
+    return `${answer.value} (${q.min}${q.minLabel ? ` ${q.minLabel}` : ''} to ${q.max}${q.maxLabel ? ` ${q.maxLabel}` : ''})`;
+  return String(answer.value);
+}
+
+/** The longest the prompt may be: a task's description. */
+const MAX_BRIEF = 10000;
+
+/**
+ * Refine from the answers (docs/specs/IDEA-30-new-agent.md, section 8): the prompt the board writes for a general
+ * agent that brings the work waiting for an answered decision in line with its answers. `decision` is the decision's
+ * task (its `ref` is its work ID or short ID), `waiting` the open tasks that depend on it, and `note` the owner's,
+ * which goes under the board's prompt. Returns the task's title and description.
+ * @param {{ ref: string, description: string, spec?: string | null, questions: any[], answers: Record<string, any> }} decision
+ * @param {{ ref: string, description: string, tags?: string[], spec?: string | null }[]} waiting
+ * @param {string | null} [note]
+ */
+export function refinePrompt(decision, waiting, note = null) {
+  const title = clip(`Refine from the answers to ${decision.ref}: ${decision.description}`, 200);
+  const questions = decision.questions.flatMap((q, i) => {
+    const answer = decision.answers[q.id];
+    return [
+      `${i + 1}. ${q.prompt.trim()}`,
+      `   Answer: ${spell(q, answer)}`,
+      ...(answer?.comment ? [`   The owner's note: ${answer.comment.trim()}`] : []),
+    ];
+  });
+  const specs = [...new Set([decision.spec, ...waiting.map((t) => t.spec)].filter(Boolean))];
+  const held = waiting.map((t) => {
+    const features = featureTags(t.tags);
+    return `- ${t.ref}: ${t.description}${features.length ? ` (feature: ${features.join(', ')})` : ''}`;
+  });
+  const after = [
+    '',
+    'What to do',
+    `- Change the tasks waiting for ${decision.ref}, and their dependencies, so they match the answers (the cross-task edits a general agent may make, each change noted).`,
+    `- Update ${specs.length ? 'the spec' : 'any spec the tasks link'} to match, in one pull request that closes your own task.`,
+    '- Add the tasks the answers need, filled in and depending on what they wait for.',
+    '- Ask a new decision for anything the answers leave open. Never change these answers: only the owner does.',
+    '- If nothing in the repository needs to change, comment what you changed on the board, task by task, and release your task.',
+    ...(note && String(note).trim() ? ['', 'Note from the owner:', String(note).trim().slice(0, 4000)] : []),
+  ];
+  const intro = `The owner answered the decision on ${decision.ref} (${decision.description}). Bring the work waiting for it in line with the answers.`;
+  const rest = [
+    '',
+    `Waiting for ${decision.ref}`,
+    ...(held.length ? held : ['- Nothing open waits for it: look for tasks and specs the answers change.']),
+    ...(specs.length ? ['', specs.length === 1 ? 'Spec' : 'Specs', ...specs.map((s) => `- ${s}`)] : []),
+    ...after,
+  ].join('\n');
+  // Too long for a description: the answers give way first, since they stay on the decision for the agent to read.
+  const more = `\n… (the rest is on ${decision.ref}: npx breakaway show ${decision.ref})`;
+  const answers = ['', 'Questions and answers', ...questions].join('\n');
+  const room = MAX_BRIEF - intro.length - rest.length - 1;
+  const middle = answers.length <= room ? answers : `${answers.slice(0, Math.max(0, room - more.length))}${more}`;
+  return { title, brief: `${intro}${middle}\n${rest}`.slice(0, MAX_BRIEF) };
+}