@warren-dean/code-kit 0.12.2 → 0.14.0

package/hooks/mod/loop.mjs

@@ -75,7 +75,7 @@ export function leadPrompt(step, { cli = 'code-kit' } = {}) {
   // MQ-2: the head of the merge queue, where the lead merges within the delegated rules.
   if (step.step === 'merge')
     return ids.length
-      ? `Merge ${ids[0]}, next in the merge queue: run node "${cli}" queue merge --delegated. It verifies the branch against the base as it is now, and sends it back to its lane if it conflicts or fails.`
+      ? `Merge ${ids[0]}, next in the merge queue: run node "${cli}" queue merge --delegated. It verifies the branch against the base as it is now, and sends it back to its lane if it conflicts or fails; a branch that moved after its review leaves the queue for you to review again.`
       : null;
   // SETUP-2: the base has no rules yet; the lead puts the approved ones there, then merges as usual.
   if (step.step === 'rules')
@@ -148,3 +148,77 @@ export function restartPrompt({ type, id, story, minutes }) {
 /** The message a quiet agent gets (LOOP-3). */
 export const nudgeText = (minutes) =>
   `No tool call for ${minutes} minutes: report where you are, or carry on.`;
+
+/** LOOP-11: what a lead turn left the build at, as the loop reads the lead's reply. */
+export const OUTCOMES = new Set(['done', 'started', 'needs-person', 'blocked']);
+const ANSWER_SHOWN = 4000;
+
+/**
+ * LOOP-11: the side call that reads the lead's last reply before the loop prompts it again: over the
+ * lead's own conversation (so it knows the whole exchange), with the reply itself for a call that
+ * can't fork. `prompt` is the loop's own prompt for that turn, or null when the person started it.
+ */
+export function outcomePrompt({ prompt = null, answer = '' }) {
+  const reply = String(answer ?? '').trim();
+  const shown =
+    reply.length > ANSWER_SHOWN ? `${reply.slice(0, ANSWER_SHOWN)}\n[… cut short]` : reply;
+  return [
+    prompt
+      ? `code-kit's lead loop prompted you: "${prompt}"`
+      : "The person prompted you, and code-kit's lead loop is about to prompt you with the build's next step.",
+    `Your reply ended your turn. It read:\n"""\n${shown}\n"""`,
+    'Say where that reply left things, so the loop knows whether to prompt you again. Answer with one JSON object and nothing else:',
+    '{"outcome": "done" | "started" | "needs-person" | "blocked", "question": "…", "options": [{"label": "…", "effect": "…"}], "reason": "…"}',
+    '- done: you finished what was asked, or there was nothing to do.',
+    '- started: you started work that carries on without you, such as lane agents.',
+    "- needs-person: you asked the person something, or wait on their answer, approval or feedback before you go on. question: what you wait on, as one question; options: 2 to 4 answers they could give (a label of at most five words, and what it does), or [] when it's theirs to put in words.",
+    "- blocked: you didn't take the step, for a reason no answer from the person settles now. reason: why, in a sentence.",
+  ].join('\n');
+}
+
+/**
+ * LOOP-11: the side call's answer: { outcome, question, options: [{ label, effect }], reason }, or
+ * null when it isn't one (the loop then goes on as before).
+ */
+export function readOutcome(text) {
+  const raw = String(text ?? '');
+  const json = raw.slice(raw.indexOf('{'), raw.lastIndexOf('}') + 1);
+  let parsed;
+  try {
+    parsed = JSON.parse(json);
+  } catch {
+    return null;
+  }
+  if (!parsed || !OUTCOMES.has(parsed.outcome)) return null;
+  const words = (s, n) =>
+    typeof s === 'string' && s.trim() ? s.replace(/\s+/g, ' ').trim().slice(0, n) : null;
+  const options = (Array.isArray(parsed.options) ? parsed.options : [])
+    .map((o) => ({ label: words(o?.label, 40), effect: words(o?.effect, 200) }))
+    .filter((o) => o.label)
+    .slice(0, 4);
+  return {
+    outcome: parsed.outcome,
+    question: words(parsed.question, 400),
+    options: options.length >= 2 ? options : [],
+    reason: words(parsed.reason, 300),
+  };
+}
+
+/**
+ * LOOP-12: a design is made with the person, so the loop hands a design story to the lead once; while
+ * the stories `next` names have all been handed over, it leaves them to the person and the lead.
+ */
+export const designHandedOver = (step, handed) =>
+  step?.step === 'design' &&
+  (step.args ?? '')
+    .split(/\s+/)
+    .filter(Boolean)
+    .every((id) => handed.has(id));
+
+/** LOOP-11: the lead's prompt with the person's answer to what it waited on. */
+export const answeredPrompt = (question, answer) => {
+  const said = /[.!?]$/.test(answer) ? answer : `${answer}.`;
+  return question
+    ? `The person answered what you asked ("${question}"): ${said} Carry on with it.`
+    : `The person says: ${said} Carry on with it.`;
+};

package/hooks/mod/mission.mjs

@@ -50,7 +50,7 @@ export function missionLines({
 }) {
   if (state?.kind !== 'ok') return [];
   const working = state.lanes.filter((l) => l.name !== 'lead' && l.active && live[l.name]);
-  const loopOn = Boolean(loop?.started) && !['off', 'stopped'].includes(loop?.state);
+  const loopOn = Boolean(loop?.started) && !['off', 'stopped', 'elsewhere'].includes(loop?.state);
   if (!leadBusy && !working.length && !loopOn) return [];
   const rows = [];
   const goal = goalOf(state.stories);
@@ -64,25 +64,29 @@ export function missionLines({
     ? `lead ${live.lead?.tool ? `at work: ${live.lead.tool}` : 'at work'}`
     : 'lead idle';
   const loopWord =
-    loop?.state === 'paused'
-      ? 'loop paused'
-      : loop?.state === 'off'
-        ? 'loop off'
-        : loop?.state === 'done'
-          ? 'milestone done'
-          : loopOn
-            ? `loop ${loop.autonomy === 'propose' ? 'proposing' : 'on'}${loop.last ? ` · last: ${loop.last}` : ''}`
-            : null;
+    loop?.state === 'elsewhere'
+      ? 'loop in another session'
+      : loop?.state === 'paused'
+        ? 'loop paused'
+        : loop?.state === 'off'
+          ? 'loop off'
+          : loop?.state === 'done'
+            ? 'milestone done'
+            : loopOn
+              ? `loop ${loop.autonomy === 'propose' ? 'proposing' : 'on'}${loop.last ? ` · last: ${loop.last}` : ''}`
+              : null;
   rows.push({
     kind: 'now',
     label: 'now',
     text: [lead, loopWord].filter(Boolean).join(' · '),
     actions:
-      loop?.state === 'paused'
-        ? [{ id: 'resume', label: 'Resume' }]
-        : loopOn && loop?.state === 'running'
-          ? [{ id: 'pause', label: 'Pause' }]
-          : [],
+      loop?.state === 'elsewhere'
+        ? [{ id: 'leadHere', label: 'Lead from here' }]
+        : loop?.state === 'paused'
+          ? [{ id: 'resume', label: 'Resume' }]
+          : loopOn && loop?.state === 'running'
+            ? [{ id: 'pause', label: 'Pause' }]
+            : [],
   });
   const next = nextText(nextStep);
   if (next && loop?.state !== 'done') rows.push({ kind: 'next', label: 'next', text: next });

package/hooks/mod/panes.mjs

@@ -1357,7 +1357,17 @@ export function decisionsTab(cards, ui, { Box, Text, Button }, on) {
     paddingX: 1,
     rowGap: 0,
     children: [
-      text(card.headline, { bold: true, wrap: 'wrap' }),
+      text(
+        card.kind === 'brief'
+          ? 'An open question in your brief'
+          : card.kind === 'question'
+            ? 'A question from the lead'
+            : card.headline,
+        { bold: true, wrap: 'wrap' },
+      ),
+      ...(card.details ?? []).map((d) =>
+        row(d.label, d.value, d.label === 'Question' ? { bold: true } : {}),
+      ),
       ...(card.asked ? [row('You asked for', card.asked)] : []),
       ...(card.story
         ? [