cawdev-cli 1.0.5-beta → 1.0.7-beta

package/runner/split.mjs

@@ -282,6 +282,20 @@ export function isPullRequest(url) {
  *   `view` of the run, which is where the card and the final state come from.
  * @param waiting a word when the session is stopped on a person, else null.
  */
+/**
+ * A dev session that ended FINISHED having committed nothing — R24: IMPLEMENT
+ * stopped on a plan it would not follow, TEST and MEMORY ran on an untouched
+ * branch, and the run finished. "finished" in green with `/pr` offered read
+ * as work done, and `/pr` then said there was nothing to propose. Known only
+ * once the terminal has read the run's commits (`meta.commits`); until then
+ * nothing is claimed either way.
+ */
+export function builtNothing(meta) {
+  const view = meta.view;
+  return Boolean(meta.ended && view?.state === 'FINISHED'
+    && (view.profile ?? 'CODE') === 'CODE' && meta.commits === 0);
+}
+
 export function titleFor(meta, waiting = null) {
   const view = meta.view ?? {};
   const profile = view.profile ?? meta.profile ?? null;
@@ -289,9 +303,10 @@ export function titleFor(meta, waiting = null) {
   const what = view.entryRef
     ? `${view.entryRef} ${view.entryTitle ?? view.label ?? meta.label ?? ''}`.trim()
     : (view.label ?? meta.label ?? 'a session');
-  const state = meta.ended
-    ? String(view.state ?? 'ended').toLowerCase().replace(/_/g, ' ')
-    : meta.state ?? 'running';
+  const state = builtNothing(meta) ? 'finished · nothing built'
+    : meta.ended
+      ? String(view.state ?? 'ended').toLowerCase().replace(/_/g, ' ')
+      : meta.state ?? 'running';
   // What it is and where it stands FIRST: a narrow window clips from the
   // right, and "plan · finished" is what decides what to do next. The project
   // is the window's subtitle, a line of its own, and not in here.
@@ -374,14 +389,15 @@ export function toneFor(meta) {
   if (!state || meta.view?.live) {
     return null;
   }
-  return state === 'FINISHED' ? 'done' : 'stopped';
+  // Finished having built nothing is not done: amber, not green.
+  return state === 'FINISHED' && !builtNothing(meta) ? 'done' : 'stopped';
 }
 
 /**
  * What can be done about a session now — the window's last line. Empty while
  * it runs: the prompt, the answer and the permission keys are the prompt's.
  *
- * A finished PLAN on a card offers its development. A finished session that
+ * A finished PLAN on a card offers its development — `d`, in its place. A finished session that
  * wrote a branch offers the pull request until one is known, then shows it.
  * Every ended window can be closed.
  */
@@ -397,12 +413,17 @@ export function actionsFor(meta) {
     parts.push('continue asked for — back when this machine takes it');
   }
   if (view?.state === 'FINISHED' && view.profile === 'PLAN' && view.entryRef) {
-    parts.push(`/develop starts ${view.entryRef}`);
+    // `d` (or /develop) develops it with the agent that planned it, and the
+    // development's window takes this one's place.
+    parts.push(`d develops ${view.entryRef} here, in place of this plan`);
+    parts.push('/open reads the plan on cawdev');
   }
   if (isPullRequest(view?.prUrl)) {
     parts.push(`PR ${view.prUrl} · /open`);
   } else if (meta.prAsked) {
     parts.push(meta.prAsked === true ? 'pull request asked for…' : meta.prAsked);
+  } else if (builtNothing(meta)) {
+    parts.push(`nothing was committed${view.entryRef ? ` — /new plan ${view.entryRef} to re-plan it` : ''}`);
   } else if (view?.branch && (view.profile ?? 'CODE') === 'CODE' && view.state === 'FINISHED') {
     parts.push('/pr opens the pull request');
   }
@@ -455,6 +476,20 @@ export function isAutoCheckout(path) {
  *   `{ needsProject, projects }` when no `@project` was written — the project
  *   is ALWAYS asked, never guessed — or `{ error }` in words.
  */
+/**
+ * A command line as words — on spaces and tabs, with every line break kept as
+ * a word of its own (`'\n'`). Splitting on all whitespace turned a pasted list
+ * of requirements into one long line; kept here, `wordsText` puts it back.
+ */
+export function commandWords(text) {
+  return String(text).split(/[ \t]+/).flatMap((token) => token.split(/(\n)/)).filter(Boolean);
+}
+
+/** The words of a task back into its text, line breaks where they were. */
+export function wordsText(words) {
+  return words.join(' ').replace(/ *\n */g, '\n').trim();
+}
+
 export function parseNew(words, { projects = [] } = {}) {
   const named = words.find((word) => word.startsWith('@'));
   const rest = words.filter((word) => word !== named && word !== '');
@@ -469,7 +504,7 @@ export function parseNew(words, { projects = [] } = {}) {
   if (slug && projects.length && !projects.includes(slug)) {
     return { error: `this machine does not serve ${slug} — it serves ${projects.join(', ')}` };
   }
-  const text = args.join(' ').trim();
+  const text = wordsText(args);
   if (!text) {
     return { error: kind === 'ask' ? 'ask what? /new ask <question>'
       : `${kind} what? /new ${kind} R3, or /new ${kind} <the task in words>` };
@@ -590,24 +625,25 @@ export function wordWrap(text, width) {
 
 /**
  * The board's columns, in the board's order, and the words the console uses
- * for them. SHIPPED and DECLINED are not columns: they only grow, and the
- * console's own board folds them to a count (R68) for the same reason — so
- * here they are counts beside the project's name.
+ * for them — the work still to be done, which is what somebody at this
+ * terminal acts on. MERGED, SHIPPED and DECLINED are not columns: the work
+ * is over, the three only grow, and the console's own board folds the last
+ * two to a count (R68) for the same reason — so here all three are counts
+ * beside the project's name.
  */
 export const BOARD_COLUMNS = [
   ['CONSIDERING', 'Considering'],
   ['PLANNED', 'Planned'],
   ['IN_DEVELOPMENT', 'In development'],
-  ['MERGED', 'Merged'],
 ];
-const FOLDED = [['SHIPPED', 'shipped'], ['DECLINED', 'declined']];
+const FOLDED = [['MERGED', 'merged'], ['SHIPPED', 'shipped'], ['DECLINED', 'declined']];
 
 /**
- * Which column gives way first when the width runs out: the finished work,
- * then the ideas, then what is ready, and what is being built last of all —
- * the order of how much a person at this terminal is about to act on it.
+ * Which column gives way first when the width runs out: the ideas, then what
+ * is ready, and what is being built last of all — the order of how much a
+ * person at this terminal is about to act on it.
  */
-const GIVES_WAY = ['MERGED', 'CONSIDERING', 'PLANNED', 'IN_DEVELOPMENT'];
+const GIVES_WAY = ['CONSIDERING', 'PLANNED', 'IN_DEVELOPMENT'];
 
 /** Narrower than this, a column's card lines say nothing. */
 export const MIN_COLUMN = 18;
@@ -828,3 +864,60 @@ export function sessionTag(n, meta) {
     : (view.label ?? meta?.label ?? 'a session'), 32);
   return `${n ? `${n} · ` : ''}${type} · ${what}${meta?.projectSlug ? ` — ${meta.projectSlug}` : ''}`;
 }
+
+// --- a card, in the terminal ---------------------------------------------------
+
+/** How many lines of a card's body `/view` prints before pointing at the web. */
+export const CARD_BODY_LINES = 30;
+
+/**
+ * `/view R29`: a card as lines for the transcript — what it is, where it
+ * stands, who has it, its branch and pull request, then its body. Pure, so it
+ * is read at every combination rather than guessed from a live platform.
+ * Only what the card SAYS: an empty field draws no line, because a row of
+ * "none"s is read instead of scanned.
+ *
+ * @param card the platform's RoadmapEntryView (`GET …/roadmap/{ref}`).
+ * @param url the card's page on the console, or null.
+ */
+export function cardLines(card, ink, url = null) {
+  const lines = [];
+  const field = (label, value) => {
+    if (value) lines.push(`   ${ink.muted(label.padEnd(9))} ${value}`);
+  };
+  lines.push(` ${ink.bold(`${card.ref ?? ''} ${card.title ?? ''}`.trim())}`);
+  const kind = card.kind === 'ISSUE'
+    ? `issue${card.severity ? ` · ${String(card.severity).toLowerCase()}` : ''}` : null;
+  field('status', [card.statusDisplay ?? card.status, kind].filter(Boolean).join(' · '));
+  field('section', card.section);
+  field('tags', card.tags?.length ? card.tags.join(', ') : null);
+  field('sprint', card.sprint ? `${card.sprint.ref ?? card.sprint.number} ${card.sprint.name ?? ''}`.trim() : null);
+  const item = card.workItem;
+  field('branch', card.branch ?? item?.branch);
+  field('work', item ? [item.statusDisplay ?? item.status, item.runnerName && `on ${item.runnerName}`]
+    .filter(Boolean).join(' · ') : null);
+  const pr = item?.prUrl ?? card.review?.prUrl;
+  field('pr', isPullRequest(pr) ? pr : null);
+  const run = card.activeRun;
+  field('session', run ? [String(run.state ?? '').toLowerCase().replace(/_/g, ' '),
+    run.runnerName && `on ${run.runnerName}`].filter(Boolean).join(' · ') : null);
+  field('coding', card.codingBy?.email);
+  field('review', card.reviewingBy?.email);
+  field('rejected', card.rejection?.note ? `${card.rejection.note}${card.rejection.decidedByEmail ? ` — ${card.rejection.decidedByEmail}` : ''}` : null);
+  field('merged', card.merge);
+  field('version', card.version);
+  field('declined', card.declinedReason);
+  field('related', card.relatedRefs?.length ? card.relatedRefs.join(', ') : null);
+  field('after', card.after?.length ? card.after.map((each) => each.ref).join(', ') : null);
+  field('web', url);
+  const body = String(card.body ?? '').replace(/\s+$/, '');
+  if (body) {
+    const all = body.split('\n');
+    lines.push('');
+    for (const line of all.slice(0, CARD_BODY_LINES)) lines.push(`   ${line}`);
+    if (all.length > CARD_BODY_LINES) {
+      lines.push(ink.muted(`   … ${all.length - CARD_BODY_LINES} more line(s)${url ? ' — the rest on the web' : ''}`));
+    }
+  }
+  return lines;
+}