@detergent-software/conductor 1.0.0-dev.10 → 1.0.0-dev.12

package/build/watchers/linear-queue.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { linearApi } from "./linear-api.js";
+import { spend } from "./source.js";
+const PAGE = 250;
+const OPEN_TYPES = ['backlog', 'unstarted', 'started'];
+const CLOSED_TYPES = new Set(['canceled', 'completed', 'duplicate']);
+const ISSUE_FIELDS = `identifier title priority createdAt state { type } project { name }
+      labels(first: 20) { nodes { name } }
+      inverseRelations(first: 20) { nodes { type issue { identifier } } }`;
+const OPEN_ISSUES = `open: issues(first: ${PAGE}, after: $after, filter: { team: { key: { eq: $team } }, state: { type: { in: ${JSON.stringify(OPEN_TYPES)} } } }) {
+    pageInfo { hasNextPage endCursor }
+    nodes { ${ISSUE_FIELDS} }
+  }`;
+export const QUEUE_QUERY = `query Queue($team: String!, $area: String!, $numbers: [Float!]!, $after: String) {
+  projects(first: ${PAGE}, filter: { accessibleTeams: { some: { key: { eq: $team } } } }) { nodes { name priority sortOrder } }
+  issueLabels(first: ${PAGE}, filter: { parent: { name: { eq: $area } } }) { nodes { name } }
+  ${OPEN_ISSUES}
+  inflight: issues(first: ${PAGE}, includeArchived: true, filter: { team: { key: { eq: $team } }, number: { in: $numbers } }) {
+    nodes { identifier state { type } }
+  }
+}`;
+export const OPEN_PAGE_QUERY = `query OpenPage($team: String!, $after: String) {
+  ${OPEN_ISSUES}
+}`;
+const issueNode = z.object({
+    createdAt: z.string().nullable(),
+    identifier: z.string(),
+    inverseRelations: z.object({ nodes: z.array(z.object({ issue: z.object({ identifier: z.string() }).nullable(), type: z.string() })) }),
+    labels: z.object({ nodes: z.array(z.object({ name: z.string() })) }),
+    priority: z.number().nullable(),
+    project: z.object({ name: z.string() }).nullable(),
+    state: z.object({ type: z.string() }),
+    title: z.string().nullable(),
+});
+const openPage = z.object({
+    nodes: z.array(issueNode),
+    pageInfo: z.object({ endCursor: z.string().nullable(), hasNextPage: z.boolean() }),
+});
+const queueAnswer = z.object({
+    inflight: z.object({ nodes: z.array(z.object({ identifier: z.string(), state: z.object({ type: z.string() }) })) }),
+    issueLabels: z.object({ nodes: z.array(z.object({ name: z.string() })) }),
+    open: openPage,
+    projects: z.object({ nodes: z.array(z.object({ name: z.string(), priority: z.number().nullable(), sortOrder: z.number().nullable() })) }),
+});
+export function linearQueue(options = {}) {
+    const request = linearApi(options);
+    const post = async (query, variables, budget) => {
+        spend(budget);
+        return request(query, variables);
+    };
+    return {
+        read: async (profile, inFlight, budget) => {
+            const { areaLabelGroup, team } = profile.tracker;
+            const numbers = inFlight.map((id) => Number(/^[A-Za-z]+-(\d+)$/.exec(id)?.[1])).filter(Number.isInteger);
+            const first = queueAnswer.parse(await post(QUEUE_QUERY, { after: null, area: areaLabelGroup, numbers, team }, budget));
+            const pages = [];
+            for (let page = first.open; page.pageInfo.hasNextPage;) {
+                page = z.object({ open: openPage }).parse(await post(OPEN_PAGE_QUERY, { after: page.pageInfo.endCursor, team }, budget)).open;
+                pages.push(page);
+            }
+            return snapshotFrom(first, pages);
+        },
+    };
+}
+// The snapshot from the Queue query's answer and any later pages of open items. An item's blockers
+// are the ones still open; an in-flight item the read finds done, canceled or a duplicate is closed.
+export function snapshotFrom(data, pages = []) {
+    const nodes = [data.open, ...pages].flatMap((page) => page.nodes);
+    const open = new Set(nodes.map((n) => n.identifier));
+    const areaLabels = data.issueLabels.nodes.map((l) => l.name);
+    const areas = new Set(areaLabels);
+    return {
+        areaLabels,
+        closed: data.inflight.nodes.filter((n) => CLOSED_TYPES.has(n.state.type)).map((n) => n.identifier),
+        issues: nodes.map((n) => {
+            const labels = n.labels.nodes.map((l) => l.name);
+            return {
+                area: labels.find((l) => areas.has(l)) ?? null,
+                // Linear stores "A blocks B" on A; B sees it as an inverse relation.
+                blockedBy: n.inverseRelations.nodes.flatMap((r) => (r.type === 'blocks' && r.issue && open.has(r.issue.identifier) ? [r.issue.identifier] : [])),
+                createdAt: n.createdAt,
+                id: n.identifier,
+                labels,
+                priority: n.priority,
+                stateType: n.state.type,
+                title: n.title,
+                trackerProject: n.project?.name ?? null,
+            };
+        }),
+        projects: data.projects.nodes,
+    };
+}
+//# sourceMappingURL=linear-queue.js.map

package/build/watchers/linear-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linear-queue.js","sourceRoot":"","sources":["../../src/watchers/linear-queue.ts"],"names":[],"mappings":"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"}

package/build/why.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import {} from "./store.js";
+// `conduct why` (design note, section 9): every action is an event that names the rule behind it,
+// directly (`rule`) or through the event that caused it (`data.cause`). This follows that chain
+// back to the rule, and gives its text as it was when it fired.
+const eventSchema = z.object({
+    at: z.string(),
+    data: z.record(z.string(), z.unknown()),
+    id: z.number(),
+    kind: z.string(),
+    project: z.string().nullable(),
+    rule: z.string().nullable(),
+    subject: z.string().nullable(),
+});
+export const whySchema = z.object({
+    // The event asked about, then each cause before it.
+    chain: z.array(eventSchema),
+    // The rule behind it: its ref, and its text as it fired (or as it is now, when the event didn't
+    // record it). Null when no rule caused it: a worker's own note, Jason's command.
+    rule: z
+        .object({
+        do: z.array(z.string()).nullable(),
+        from: z.enum(['a command', 'the event', 'the rules in force', 'not in force any more']),
+        ref: z.string(),
+        when: z.string().nullable(),
+    })
+        .nullable(),
+});
+const MAX_CHAIN = 10;
+const recorded = z.looseObject({ do: z.array(z.string()).optional(), when: z.string().nullable().optional() });
+export function explain(store, id, rules) {
+    const first = store.getEvent(id);
+    if (!first)
+        return null;
+    const chain = [first];
+    for (let at = first; chain.length < MAX_CHAIN;) {
+        const cause = at.data.cause;
+        const next = typeof cause === 'number' ? store.getEvent(cause) : null;
+        if (!next || chain.some((e) => e.id === next.id))
+            break;
+        chain.push(next);
+        at = next;
+    }
+    const source = chain.find((e) => e.rule !== null);
+    if (!source?.rule)
+        return { chain, rule: null };
+    // An override set by a command names it (`conduct pause`); a rule's ref has a source and a colon.
+    if (!source.rule.includes(':'))
+        return { chain, rule: { do: null, from: 'a command', ref: source.rule, when: null } };
+    // The text as it fired is on the `rule.fired` event, which a `rule.done` names as its cause.
+    for (const e of chain) {
+        const text = e.rule === source.rule ? recorded.safeParse(e.data).data : undefined;
+        if (text?.do !== undefined)
+            return { chain, rule: { do: text.do, from: 'the event', ref: source.rule, when: text.when ?? null } };
+    }
+    const now = rules.find((r) => r.ref === source.rule);
+    return {
+        chain,
+        rule: now
+            ? { do: now.text.do, from: 'the rules in force', ref: now.ref, when: now.text.when }
+            : { do: null, from: 'not in force any more', ref: source.rule, when: null },
+    };
+}
+// `conduct why`: the rule first, then the chain of events from the one asked about back to its cause.
+export function whyLines(why) {
+    const { rule } = why;
+    const lines = rule === null ? ['no rule: nothing in its chain was caused by a rule (a worker, a command, an outside event)']
+        : rule.from === 'a command' ? [`set by \`${rule.ref}\``]
+            : [`${rule.ref}: ${rule.when === null ? '' : `when ${rule.when} → `}${rule.do?.join('; ') ?? '(its text is gone)'}  (from ${rule.from})`];
+    for (const [i, e] of why.chain.entries()) {
+        const detail = ['outcome', 'action', 'error', 'reason', 'by']
+            .flatMap((k) => (typeof e.data[k] === 'string' ? [`${k}: ${String(e.data[k])}`] : []))
+            .join('; ');
+        lines.push(`${i === 0 ? '  ' : '  ← '}#${e.id} ${new Date(e.at).toLocaleString()} ${e.kind}${e.subject ? ` ${e.subject}` : ''}${e.project ? ` (${e.project})` : ''}${e.rule ? ` [${e.rule}]` : ''}${detail ? `: ${detail}` : ''}`);
+    }
+    return lines;
+}
+//# sourceMappingURL=why.js.map

package/build/why.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"why.js","sourceRoot":"","sources":["../src/why.ts"],"names":[],"mappings":"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"}

package/mod/README.md

@@ -1,6 +1,6 @@
 # Conductor mod
 
-A Claude Code plugin (a hooks module) that does the conductor console's plumbing in code, so it costs no tokens: a status line in every session and, in the console (`CONDUCTOR_CONSOLE=1`), the inbox band, the fleet pane, `/conductor` `/inbox` `/approve` `/revise` `/attach` `/notify`, toasts, Remote Control pushes (and the one warning when Remote Control is off), and the one model wake-up for an escalation. What it shows and does is in the conductor README's *Mod* section (`apps/conductor/README.md`).
+A Claude Code plugin (a hooks module) that does the conductor console's plumbing in code, so it costs no tokens: a status line in every session and, in the console (`CONDUCTOR_CONSOLE=1`), the inbox band, the fleet pane, `/conductor` `/inbox` `/approve` `/revise` `/attach` `/notify` `/pause` `/unpause` `/focus-project`, toasts, Remote Control pushes (and the one warning when Remote Control is off), and the one model wake-up for an escalation. What it shows and does is in the conductor README's *Mod* section (`apps/conductor/README.md`).
 
 Install it with the daemon's CLI, which ships this folder:
 

package/mod/hooks/model.ts

@@ -355,17 +355,76 @@ export function notifyArgs(args: string, now: number): { error: string } | { nam
   if (!typed?.[1]) return { error: 'usage: /notify [<profile> [--until <when>]]' };
   const when = typed[2];
   if (when === undefined) return { name: typed[1], until: null };
+  const until = untilOf(when, now);
+  return typeof until === 'string' ? { name: typed[1], until } : until;
+}
+
+const DAYS = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
+
+// `--until <when>` as an ISO time: 17:00 (the next one), tomorrow or a day (local midnight), a date
+// (local midnight), or a date and time, as `conduct` reads them.
+export function untilOf(when: string, now: number): string | { error: string } {
   const clock = /^([01]?\d|2[0-3]):([0-5]\d)$/.exec(when);
-  let at: Date;
+  const lower = when.toLowerCase();
+  const day = DAYS.findIndex((d) => d === lower || d.slice(0, 3) === lower);
+  const at = new Date(now);
   if (clock) {
-    at = new Date(now);
     at.setHours(Number(clock[1]), Number(clock[2]), 0, 0);
     if (at.getTime() <= now) at.setDate(at.getDate() + 1);
+  } else if (lower === 'tomorrow' || day !== -1) {
+    at.setHours(0, 0, 0, 0);
+    at.setDate(at.getDate() + (lower === 'tomorrow' ? 1 : (day - at.getDay() + 7) % 7 || 7));
   } else {
-    at = new Date(/^\d{4}-\d{2}-\d{2}$/.test(when) ? `${when}T00:00` : when);
+    at.setTime(new Date(/^\d{4}-\d{2}-\d{2}$/.test(when) ? `${when}T00:00` : when).getTime());
   }
-  if (Number.isNaN(at.getTime())) return { error: `--until "${when}" is not a time: a local time such as 17:00, or a date and time such as 2026-10-12T09:00` };
-  return { name: typed[1], until: at.toISOString() };
+  if (Number.isNaN(at.getTime())) {
+    return { error: `--until "${when}" is not a time: 17:00, tomorrow, a day such as monday, or a date and time such as 2026-10-12T09:00` };
+  }
+  return at.toISOString();
+}
+
+// `/pause [<project>] [--until <when>]`, `/unpause [<project>]` and `/focus-project <project> [--until
+// <when>]` as POST /overrides' body. A focus with no end lasts until midnight, and puts the
+// project's items first (weight 100).
+export function overrideArgs(command: 'focus' | 'pause' | 'unpause', args: string, now: number): { body: Record<string, unknown> } | { error: string } {
+  const typed = /^(?:([a-z][a-z0-9-]*))?(?:\s*--until\s+(\S+))?$/.exec(args.trim());
+  const usage = { error: command === 'focus' ? 'usage: /focus-project <project> [--until <when>]' : `usage: /${command} [<project>]${command === 'pause' ? ' [--until <when>]' : ''}` };
+  if (!typed) return usage;
+  const [, project, when] = typed;
+  if (command === 'unpause') return when === undefined ? { body: { action: 'unpause', by: 'conductor mod /unpause', ...(project ? { project } : {}) } } : usage;
+  const until = when === undefined ? (command === 'focus' ? untilOf('tomorrow', now) : null) : untilOf(when, now);
+  if (until !== null && typeof until !== 'string') return until;
+  if (command === 'focus') {
+    if (!project) return usage;
+    return { body: { action: 'focus', by: 'conductor mod /focus-project', project, until, weight: 100 } };
+  }
+  return { body: { action: 'pause', by: 'conductor mod /pause', ...(project ? { project } : {}), ...(until === null ? {} : { until }) } };
+}
+
+// POST /overrides' answer as the line to show.
+export function overrideText(command: 'focus' | 'pause' | 'unpause', project: null | string, answer: ApiAnswer, now: number): string {
+  if (answer.status === 404) return 'the running conductor has no overrides: restart it on this build (conduct upgrade)';
+  if (answer.status !== 201) return `not ${command === 'focus' ? 'focused' : `${command}d`}: ${errorOf(answer)}`;
+  const set = isRecord(answer.body) && Array.isArray(answer.body.set) ? answer.body.set.filter(isRecord) : [];
+  const until = typeof set[0]?.until === 'string' ? ` for ${remaining(set[0].until, now)}` : '';
+  const who = project ?? 'every project';
+  if (command === 'pause') return `paused launches in ${who}${until || ' until /unpause'}`;
+  if (command === 'unpause') return `launches in ${who} are no longer paused`;
+  return `${who} goes first${until}`;
+}
+
+// GET /why?item=…'s answer: the rule behind the item's newest action, in one line.
+export function whyText(item: string, answer: ApiAnswer): string {
+  if (answer.status === 404) return 'the running conductor has no conduct why: restart it on this build (conduct upgrade)';
+  if (answer.status !== 200) return `why ${item}: ${errorOf(answer)}`;
+  const first = isRecord(answer.body) && Array.isArray(answer.body.items) ? answer.body.items.find(isRecord) : undefined;
+  if (!first) return `no action on ${item} was caused by a rule`;
+  const rule = isRecord(first.rule) ? first.rule : null;
+  const latest = Array.isArray(first.chain) && isRecord(first.chain[0]) ? first.chain[0] : null;
+  const what = latest && typeof latest.kind === 'string' ? `${latest.kind}: ` : '';
+  if (!rule || typeof rule.ref !== 'string') return `${item}: ${what}no rule`;
+  const text = typeof rule.when === 'string' && Array.isArray(rule.do) ? ` (when ${rule.when} → ${strings(rule.do).join('; ')})` : '';
+  return `${item}: ${what}${rule.ref}${text}`;
 }
 
 // `/notify` with no profile: the profile, quiet hours, Remote Control.

package/mod/hooks/register.tsx

@@ -17,6 +17,8 @@ import {
   inboxText,
   notifyArgs,
   notifyText,
+  overrideArgs,
+  overrideText,
   parseLine,
   profileText,
   projectGroups,
@@ -29,6 +31,7 @@ import {
   spendToday,
   statusText,
   tokens,
+  whyText,
   workerDoing,
 } from './model.ts';
 
@@ -238,6 +241,29 @@ async function answer($: EngineInterface, id: number, body: { action: 'approve'
   }
 }
 
+// `/pause`, `/unpause`, `/focus-project` and the pane's buttons: an override that ends on its own, as
+// `conduct pause|unpause|focus` sets it; the line to show.
+async function override($: EngineInterface, command: 'focus' | 'pause' | 'unpause', args: string): Promise<string> {
+  const now = await $.clock.now();
+  const typed = overrideArgs(command, args, now);
+  if ('error' in typed) return typed.error;
+  try {
+    const project = typeof typed.body.project === 'string' ? typed.body.project : null;
+    return overrideText(command, project, await callApi($, 'POST', '/overrides', typed.body), now);
+  } catch (error) {
+    return error instanceof Error ? error.message : String(error);
+  }
+}
+
+// The rule behind an item's newest action (`conduct why <item>`), in one line.
+async function why($: EngineInterface, item: string): Promise<string> {
+  try {
+    return whyText(item, await callApi($, 'GET', `/why?item=${encodeURIComponent(item)}`));
+  } catch (error) {
+    return error instanceof Error ? error.message : String(error);
+  }
+}
+
 async function attach($: EngineInterface, id: number, name: string): Promise<string> {
   try {
     const result = await callApi($, 'POST', `/workers/${id}/attach`);
@@ -270,6 +296,9 @@ async function registerCommands($: EngineInterface): Promise<void> {
   await $.command.register({ argumentHint: '<item | #id> <what to change>', description: 'Ask for a revised plan (posts revise: … as you)', name: 'revise' });
   await $.command.register({ argumentHint: '<item | worker>', description: 'Wake a parked worker and open it in a tab', name: 'attach' });
   await $.command.register({ argumentHint: '[<profile> [--until <when>]]', description: 'Show or switch the notification profile (default, away, focus …)', name: 'notify' });
+  await $.command.register({ argumentHint: '[<project>] [--until <when>]', description: 'No new launches in a project (every project without one)', name: 'pause' });
+  await $.command.register({ argumentHint: '[<project>]', description: 'Launch again after /pause', name: 'unpause' });
+  await $.command.register({ argumentHint: '<project> [--until <when>]', description: "Put a project's items first (until midnight without --until)", name: 'focus-project' });
 }
 
 export const register: Register = (on) => {
@@ -336,6 +365,10 @@ export const register: Register = (on) => {
     return { text: snap.error ?? notifyText(snap.notify, await $.clock.now()) };
   });
 
+  on('command.run', { command: 'pause' }, async ($, e) => ({ text: await override($, 'pause', e.args) }));
+  on('command.run', { command: 'unpause' }, async ($, e) => ({ text: await override($, 'unpause', e.args) }));
+  on('command.run', { command: 'focus-project' }, async ($, e) => ({ text: await override($, 'focus', e.args) }));
+
   // The band above the prompt, in the console, while the inbox has items. A bare digit typed into
   // an empty prompt presses a band Button, so a plan's approve takes a second press (`y`).
   on('ui.render', { component: 'AbovePrompt' }, async ($, e, next) => {
@@ -472,9 +505,13 @@ export const register: Register = (on) => {
         ))}
         {projectGroups(snap.workers).map((group) => (
           <Box flexDirection="column" key={`project-${group.project}`}>
-            <Text dimColor wrap="truncate">
-              {rule(`${group.project} · ${group.running}/${group.rows.length} running`)}
-            </Text>
+            <Box columnGap={1}>
+              <Text dimColor wrap="truncate">
+                {rule(`${group.project} · ${group.running}/${group.rows.length} running`).slice(0, Math.max(10, e.props.bodyColumns - 18))}
+              </Text>
+              <Button key={`pause-${group.project}`} label="pause" onPress={async () => $.ui.toast(await override($, 'pause', group.project))} />
+              <Button key={`focus-${group.project}`} label="focus" onPress={async () => $.ui.toast(await override($, 'focus', group.project))} />
+            </Box>
             {group.rows.map((w) => (
               <Box flexDirection="column" key={`worker-${w.id}`}>
                 <Button key={`row-${w.id}`} onPress={() => update($, expanded, (name) => (name === w.name ? null : w.name))} plain>
@@ -486,6 +523,7 @@ export const register: Register = (on) => {
                 {open === w.name && (
                   <Box columnGap={2} flexWrap="wrap" marginLeft={2}>
                     <Button key={`attach-${w.id}`} label="attach" onPress={async () => $.ui.toast(await attach($, w.id, w.name))} />
+                    <Button key={`why-${w.id}`} label="why" onPress={async () => $.ui.toast(await why($, w.item))} />
                     <Text dimColor>
                       {w.status}
                       {w.waits.length > 0 ? ` · waits on ${w.waits.join(', ')}` : ''}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@detergent-software/conductor",
-	"version": "1.0.0-dev.10",
+	"version": "1.0.0-dev.12",
 	"description": "Conductor: the local daemon that runs conducted projects' work loops (conduct serve) and its conduct CLI.",
 	"type": "module",
 	"bin": {