@cluesmith/codev 3.3.4 → 3.3.5

package/dist/agent-farm/servers/decisions/splice.js

@@ -0,0 +1,120 @@
+// Ruling splice for the decisions file (Spec 1819).
+//
+// A pure function that writes the owner's ruling into the file's text, or refuses
+// with a specific reason and returns no text. The write route is a thin wrapper
+// around it: read the file, splice, write back only on success.
+//
+// The ruling goes directly after the item's `**Your word:**` line: the word on the
+// very next line; then the comment, after a blank line when a word was written; then
+// a blank line when the line that follows is not already blank. Inserted lines use
+// the file's own line ending, a missing final newline on the Your-word line is
+// supplied, and every other character is preserved in order. The result is
+// re-parsed and must keep the file's structure — anything the explicit checks miss
+// (an option word that is itself a heading or fence, say) is `structure-changed`.
+import { isFenceLine, isHeadingLine, isYourWordLine } from './grammar.js';
+import { parseDecisions } from './parse.js';
+/** Longest comment accepted, in characters, after trimming. */
+export const MAX_COMMENT_LENGTH = 10_000;
+function refuse(code, message) {
+    return { ok: false, code, message };
+}
+/** Refuse a comment line that would add structure: a heading, fence or Your-word line. */
+function checkCommentLines(commentLines) {
+    for (const [n, line] of commentLines.entries()) {
+        const where = `Line ${n + 1} of the comment`;
+        if (isHeadingLine(line))
+            return refuse('comment-heading', `${where} is a markdown heading ("${line.trim()}"); headings end the item.`);
+        if (isFenceLine(line))
+            return refuse('comment-fence', `${where} is a code fence ("${line.trim()}"), which would change how the file parses.`);
+        if (isYourWordLine(line))
+            return refuse('comment-your-word', `${where} starts with **Your word:**, which would give the item a second Your-word line.`);
+    }
+    return null;
+}
+/** Find the request's item in `## Open` and check it can take a ruling now. */
+function checkItem(parsed, request, word) {
+    const { id } = request;
+    if (parsed.problems.includes('open-multiple')) {
+        return refuse('open-multiple', 'The file has more than one ## Open section; the tab cannot tell where items belong, so it writes nothing.');
+    }
+    const matches = parsed.items.filter(item => item.id === id);
+    if (matches.length === 0)
+        return refuse('heading-missing', `Item ${id} is not in ## Open (it may have been ruled or removed).`);
+    if (matches.length > 1)
+        return refuse('heading-duplicate', `Item ${id} appears ${matches.length} times in ## Open; rulings for it go through main.`);
+    const item = matches[0];
+    if (item.yourWordLines.length === 0)
+        return refuse('your-word-missing', `Item ${id} has no **Your word:** line to rule under.`);
+    if (item.yourWordLines.length > 1)
+        return refuse('your-word-multiple', `Item ${id} has ${item.yourWordLines.length} **Your word:** lines; the tab cannot tell which one to rule under.`);
+    if (item.currentRuling !== '')
+        return refuse('already-ruled', `Item ${id} already has text under its **Your word:** line; a change goes through main or a hand edit.`);
+    if (word && !item.options.some(option => option.word === word)) {
+        return refuse('unknown-word', `"${word}" is not an option on item ${id}'s current **Your word:** line.`);
+    }
+    if (item.fingerprint !== request.fingerprint)
+        return refuse('item-changed', `Item ${id} changed since it was shown; review it and submit again.`);
+    return item;
+}
+/**
+ * Check the spliced text kept the file's structure: the same sections, the same items
+ * in the same order, the same options on this item, this item's current ruling equal
+ * to the inserted ruling, and every inserted line plain unfenced content.
+ */
+function verify(before, after, item, ruling, insertedLines) {
+    const sections = (p) => p.lines.filter(l => l.headingLevel === 1 || l.headingLevel === 2).map(l => `${l.headingLevel} ${l.headingText}`).join('\n');
+    const changed = (what) => refuse('structure-changed', `Writing this ruling into item ${item.id} would change ${what}, so nothing was written.`);
+    if (sections(after) !== sections(before) || after.problems.join() !== before.problems.join())
+        return changed("the file's sections");
+    if (after.items.map(i => i.id).join('\n') !== before.items.map(i => i.id).join('\n'))
+        return changed('the list of open items');
+    const afterItem = after.items.find(i => i.headingLine === item.headingLine);
+    if (!afterItem || afterItem.id !== item.id)
+        return changed('the list of open items');
+    if (JSON.stringify(afterItem.options) !== JSON.stringify(item.options))
+        return changed("the item's options");
+    if (afterItem.currentRuling !== ruling)
+        return changed("the item's text after its **Your word:** line");
+    const inserted = after.lines.slice(insertedLines.from, insertedLines.from + insertedLines.count);
+    if (inserted.some(l => l.fenced || l.headingLevel > 0 || l.yourWord))
+        return changed("the file's structure (the ruling would add a heading or fence)");
+    return null;
+}
+/** Apply the owner's ruling to the decisions file's text, or refuse with the reason. */
+export function spliceRuling(text, request) {
+    if (!request.id)
+        return refuse('invalid-request', 'The request names no item.');
+    if (!request.fingerprint)
+        return refuse('invalid-request', 'The request carries no item fingerprint.');
+    const word = request.word ?? '';
+    const comment = (request.comment ?? '').trim();
+    if (!word && !comment)
+        return refuse('empty-ruling', 'Choose an option or write a comment.');
+    if (comment.length > MAX_COMMENT_LENGTH) {
+        return refuse('comment-too-long', `The comment is ${comment.length} characters; the limit is ${MAX_COMMENT_LENGTH}.`);
+    }
+    const commentLines = comment ? comment.split(/\r\n|\r|\n/) : [];
+    const commentRefusal = checkCommentLines(commentLines);
+    if (commentRefusal)
+        return commentRefusal;
+    const before = parseDecisions(text);
+    const item = checkItem(before, request, word);
+    if ('ok' in item)
+        return item;
+    const rulingLines = [...(word ? [word] : []), ...(word && comment ? [''] : []), ...commentLines];
+    const yourWord = before.lines[item.yourWordLines[0]];
+    const following = before.lines[yourWord.index + 1];
+    const newLines = following && following.text.trim() !== '' ? [...rulingLines, ''] : rulingLines;
+    const at = yourWord.end + yourWord.eol.length;
+    const inserted = (yourWord.eol === '' ? before.eol : '') + newLines.map(line => line + before.eol).join('');
+    const result = text.slice(0, at) + inserted + text.slice(at);
+    // The parser's current ruling is LF-joined whatever the file's line ending.
+    const refusal = verify(before, parseDecisions(result), item, rulingLines.join('\n'), {
+        from: yourWord.index + 1,
+        count: newLines.length,
+    });
+    if (refusal)
+        return refusal;
+    return { ok: true, text: result };
+}
+//# sourceMappingURL=splice.js.map

package/dist/agent-farm/servers/decisions/splice.js.map

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

package/dist/agent-farm/servers/decisions/stamp.d.ts

@@ -0,0 +1,4 @@
+import type { DecisionStamp } from '@cluesmith/codev-types';
+/** Resolve a heading stamp to an instant using only the zone written in it. */
+export declare function resolveStamp(raw: string): DecisionStamp;
+//# sourceMappingURL=stamp.d.ts.map

package/dist/agent-farm/servers/decisions/stamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamp.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/servers/decisions/stamp.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA2H5D,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAuCvD"}

package/dist/agent-farm/servers/decisions/stamp.js

@@ -0,0 +1,171 @@
+// Decision heading timestamps (Spec 1819).
+//
+// A stamp is `YYYY-MM-DD h:mm am|pm <ZONE>` or `YYYY-MM-DD HH:mm <ZONE>`. It is
+// resolved to an absolute instant using ONLY the zone written in it — nothing here
+// defaults to, or special-cases, any zone. Anything not in the accepted forms is
+// returned unconverted with a reason, so the tab shows it verbatim.
+//
+// IANA and generic zones are resolved with the runtime's built-in `Intl` time-zone
+// data by offset probing: the wall-clock time is tried against every offset the
+// zone has near that date, and the candidates that round-trip are kept. One means
+// success; none is a spring-forward gap; two is a fall-back fold. Gaps and folds
+// are left unconverted rather than broken by a tie-break rule.
+/** Generic North-American zones: DST follows the stamp's date. */
+const GENERIC_ZONES = {
+    PT: 'America/Los_Angeles',
+    MT: 'America/Denver',
+    CT: 'America/Chicago',
+    ET: 'America/New_York',
+    AKT: 'America/Anchorage',
+    HT: 'Pacific/Honolulu',
+};
+/**
+ * Fixed-offset abbreviations, in minutes east of UTC. `CST` is North-American
+ * Central (China Standard Time is written `+08:00` or `Asia/Shanghai`). Ambiguous
+ * abbreviations (`IST`, `BST`, `AST`, …) are deliberately absent.
+ */
+const FIXED_ZONES = {
+    UTC: 0,
+    GMT: 0,
+    Z: 0,
+    PST: -8 * 60,
+    PDT: -7 * 60,
+    MST: -7 * 60,
+    MDT: -6 * 60,
+    CST: -6 * 60,
+    CDT: -5 * 60,
+    EST: -5 * 60,
+    EDT: -4 * 60,
+    AKST: -9 * 60,
+    AKDT: -8 * 60,
+    HST: -10 * 60,
+    WET: 0,
+    WEST: 1 * 60,
+    CET: 1 * 60,
+    CEST: 2 * 60,
+    EET: 2 * 60,
+    EEST: 3 * 60,
+    MSK: 3 * 60,
+    SGT: 8 * 60,
+    HKT: 8 * 60,
+    JST: 9 * 60,
+    KST: 9 * 60,
+    AEST: 10 * 60,
+    AEDT: 11 * 60,
+    NZST: 12 * 60,
+    NZDT: 13 * 60,
+};
+const STAMP_RE = /^(\d{4})-(\d{2})-(\d{2})\s+(\d{1,2}):(\d{2})(?:\s*(am|pm))?\s+(\S.*?)\s*$/i;
+const OFFSET_RE = /^(?:UTC|GMT)?([+-])(\d{1,2})(?::?(\d{2}))?$/;
+const MINUTE_MS = 60_000;
+const DAY_MS = 24 * 60 * MINUTE_MS;
+function isIanaZone(name) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: name });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseZone(zone) {
+    // Own keys only: `in` would let prototype names (`toString`, `__proto__`, …) through.
+    if (Object.hasOwn(FIXED_ZONES, zone))
+        return { kind: 'fixed', offsetMinutes: FIXED_ZONES[zone] };
+    if (Object.hasOwn(GENERIC_ZONES, zone))
+        return { kind: 'iana', name: GENERIC_ZONES[zone] };
+    const offset = OFFSET_RE.exec(zone);
+    if (offset) {
+        const hours = Number(offset[2]);
+        const minutes = offset[3] ? Number(offset[3]) : 0;
+        if (hours > 14 || minutes > 59)
+            return null;
+        const sign = offset[1] === '-' ? -1 : 1;
+        return { kind: 'fixed', offsetMinutes: sign * (hours * 60 + minutes) };
+    }
+    // IANA names only in Area/Location form, so legacy ids (`EST5EDT`, `IST`, …) are
+    // never accepted through the back door.
+    if (zone.includes('/') && isIanaZone(zone))
+        return { kind: 'iana', name: zone };
+    return null;
+}
+const formatters = new Map();
+function formatterFor(zone) {
+    let f = formatters.get(zone);
+    if (!f) {
+        f = new Intl.DateTimeFormat('en-US', {
+            timeZone: zone,
+            hourCycle: 'h23',
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+        });
+        formatters.set(zone, f);
+    }
+    return f;
+}
+/** The zone's UTC offset, in minutes, at the given instant. */
+function offsetAt(instantMs, zone) {
+    const parts = formatterFor(zone).formatToParts(new Date(instantMs));
+    const get = (type) => Number(parts.find(p => p.type === type).value);
+    const wallMs = Date.UTC(get('year'), get('month') - 1, get('day'), get('hour'), get('minute'));
+    const instantMinute = Math.floor(instantMs / MINUTE_MS) * MINUTE_MS;
+    return Math.round((wallMs - instantMinute) / MINUTE_MS);
+}
+/** All instants whose wall-clock time in `zone` is `wallMs` (as if UTC). */
+function instantsForWallClock(wallMs, zone) {
+    const offsets = new Set([offsetAt(wallMs - DAY_MS, zone), offsetAt(wallMs, zone), offsetAt(wallMs + DAY_MS, zone)]);
+    const instants = new Set();
+    for (const offset of offsets) {
+        const candidate = wallMs - offset * MINUTE_MS;
+        if (offsetAt(candidate, zone) === offset)
+            instants.add(candidate);
+    }
+    return [...instants].sort((a, b) => a - b);
+}
+/** Resolve a heading stamp to an instant using only the zone written in it. */
+export function resolveStamp(raw) {
+    const m = STAMP_RE.exec(raw.trim());
+    if (!m)
+        return { raw, instant: null, unconvertedReason: 'unrecognized-format' };
+    const [, y, mo, d, h, mi, meridiem, zoneText] = m;
+    // `12:10 am` with no zone backtracks to read `am` as the zone; it has none.
+    if (/^(am|pm)$/i.test(zoneText))
+        return { raw, instant: null, unconvertedReason: 'unrecognized-format' };
+    const year = Number(y);
+    const month = Number(mo);
+    const day = Number(d);
+    let hour = Number(h);
+    const minute = Number(mi);
+    if (meridiem) {
+        if (hour < 1 || hour > 12)
+            return { raw, instant: null, unconvertedReason: 'unrecognized-format' };
+        const pm = meridiem.toLowerCase() === 'pm';
+        hour = (hour % 12) + (pm ? 12 : 0);
+    }
+    else if (hour > 23) {
+        return { raw, instant: null, unconvertedReason: 'unrecognized-format' };
+    }
+    if (minute > 59)
+        return { raw, instant: null, unconvertedReason: 'unrecognized-format' };
+    const wallMs = Date.UTC(year, month - 1, day, hour, minute);
+    const check = new Date(wallMs);
+    if (check.getUTCFullYear() !== year || check.getUTCMonth() !== month - 1 || check.getUTCDate() !== day) {
+        return { raw, instant: null, unconvertedReason: 'unrecognized-format' };
+    }
+    const zone = parseZone(zoneText);
+    if (!zone)
+        return { raw, instant: null, unconvertedReason: 'unknown-zone' };
+    if (zone.kind === 'fixed') {
+        return { raw, instant: new Date(wallMs - zone.offsetMinutes * MINUTE_MS).toISOString() };
+    }
+    const instants = instantsForWallClock(wallMs, zone.name);
+    if (instants.length === 0)
+        return { raw, instant: null, unconvertedReason: 'nonexistent-time' };
+    if (instants.length > 1)
+        return { raw, instant: null, unconvertedReason: 'ambiguous-time' };
+    return { raw, instant: new Date(instants[0]).toISOString() };
+}
+//# sourceMappingURL=stamp.js.map

package/dist/agent-farm/servers/decisions/stamp.js.map

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

package/dist/agent-farm/servers/overview.d.ts

@@ -58,6 +58,7 @@ export declare function calculateProgress(parsed: ParsedStatus, workspaceRoot?:
  * Each phase gets an equal share of 100%, with 'verified'/'complete' always = 100.
  */
 export declare function calculateEvenProgress(phase: string, phases: string[]): number;
+/** Human-readable label for the gate the builder is blocked on, or null. */
 export declare function detectBlocked(parsed: ParsedStatus): string | null;
 /**
  * Canonical gate name (e.g. "plan-approval") for the gate the builder is
@@ -69,9 +70,9 @@ export declare function detectBlockedGate(parsed: ParsedStatus): string | null;
  * Detect when the current blocked gate was first requested.
  * Returns the ISO timestamp string or null if not blocked.
  *
- * Iterates `GATE_LABELS` so the gate set lives in exactly one place — sibling
- * to `detectBlocked` / `detectBlockedGate` (#927 removed this function's
- * previously-separate hardcoded array, which was a silent drift hazard).
+ * Shares `findBlockedGate` with `detectBlocked` / `detectBlockedGate` so the
+ * gate set lives in exactly one place (#927 removed a previously-separate
+ * hardcoded array, which was a silent drift hazard).
  */
 export declare function detectBlockedSince(parsed: ParsedStatus): string | null;
 /**

package/dist/agent-farm/servers/overview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/overview.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"overview.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/overview.ts"],"names":[],"mappings":"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"}

package/dist/agent-farm/servers/overview.js

@@ -280,13 +280,17 @@ function loadProtocolPhases(workspaceRoot, protocolName) {
 }
 /**
  * Detect if a builder is blocked on a gate (requested but not approved).
- * Returns a human-readable label or null.
  *
- * The allowlist mirrors the gates emitted by the bundled protocols (SPIR,
- * ASPIR, BUGFIX, AIR, PIR). New protocols that introduce new gate names must
- * register them here, otherwise their gate-pending state is invisible to
- * `OverviewBuilder.blocked` and downstream UIs (VSCode Needs Attention tree,
- * VSCode toast, dashboard NeedsAttentionList, status bar counter).
+ * Generic over gate names (#1777): ANY gate in `status.yaml` with
+ * `status: pending` and a `requested_at` timestamp is a human gate porch is
+ * holding the lane at, so it surfaces on `OverviewBuilder.blocked` and the
+ * downstream UIs (VSCode Agents tree/toast/status bar, dashboard
+ * NeedsAttentionList, Tower hub attention rows) whatever protocol emitted it.
+ * The earlier allowlist made EXPERIMENT's `experiment-complete` (and
+ * MAINTAIN/RESEARCH's gates) invisible.
+ *
+ * `GATE_LABELS` supplies display labels and the scan priority for the bundled
+ * gates; an unlisted gate is still detected, labelled from its own name.
  */
 const GATE_LABELS = {
     'spec-approval': 'spec review',
@@ -299,43 +303,57 @@ const GATE_LABELS = {
     // bar). The `pr` gate stays mapped here too (VSCode depends on it); the
     // dashboard alone excludes `pr` from its gate rows since it renders PR rows.
     'verify-approval': 'verify review',
+    'experiment-complete': 'experiment review',
+    'maintain-complete': 'maintenance review',
+    'scope-approval': 'scope review',
+    'research-complete': 'research review',
 };
-export function detectBlocked(parsed) {
-    for (const [gate, label] of Object.entries(GATE_LABELS)) {
+/** Display label for a gate: the mapped label, else derived from its name. */
+function gateLabel(gate) {
+    return GATE_LABELS[gate] ?? `${gate.replace(/-(approval|complete|review)$/, '').replace(/-/g, ' ')} review`;
+}
+/**
+ * Canonical name of the gate the builder is blocked on, or null. Known gates
+ * are scanned first (preserving their priority order), then any other gate in
+ * `status.yaml` order.
+ */
+function findBlockedGate(parsed) {
+    const gates = new Set([...Object.keys(GATE_LABELS), ...Object.keys(parsed.gates)]);
+    for (const gate of gates) {
         if (parsed.gates[gate] === 'pending' && parsed.gateRequestedAt[gate]) {
-            return label;
+            return gate;
         }
     }
     return null;
 }
+/** Human-readable label for the gate the builder is blocked on, or null. */
+export function detectBlocked(parsed) {
+    const gate = findBlockedGate(parsed);
+    if (!gate)
+        return null;
+    return gateLabel(gate);
+}
 /**
  * Canonical gate name (e.g. "plan-approval") for the gate the builder is
  * blocked on. Sibling to `detectBlocked` which returns the display label.
  * Returns null if the builder isn't blocked.
  */
 export function detectBlockedGate(parsed) {
-    for (const gate of Object.keys(GATE_LABELS)) {
-        if (parsed.gates[gate] === 'pending' && parsed.gateRequestedAt[gate]) {
-            return gate;
-        }
-    }
-    return null;
+    return findBlockedGate(parsed);
 }
 /**
  * Detect when the current blocked gate was first requested.
  * Returns the ISO timestamp string or null if not blocked.
  *
- * Iterates `GATE_LABELS` so the gate set lives in exactly one place — sibling
- * to `detectBlocked` / `detectBlockedGate` (#927 removed this function's
- * previously-separate hardcoded array, which was a silent drift hazard).
+ * Shares `findBlockedGate` with `detectBlocked` / `detectBlockedGate` so the
+ * gate set lives in exactly one place (#927 removed a previously-separate
+ * hardcoded array, which was a silent drift hazard).
  */
 export function detectBlockedSince(parsed) {
-    for (const gate of Object.keys(GATE_LABELS)) {
-        if (parsed.gates[gate] === 'pending' && parsed.gateRequestedAt[gate]) {
-            return parsed.gateRequestedAt[gate];
-        }
-    }
-    return null;
+    const gate = findBlockedGate(parsed);
+    if (!gate)
+        return null;
+    return parsed.gateRequestedAt[gate];
 }
 /**
  * Compute the canonical "PR ready for human review" signal for a builder.
@@ -483,6 +501,15 @@ export function extractProjectIdFromWorktreeName(dirName) {
     const pirMatch = dirName.match(/^pir-(\d+)/);
     if (pirMatch)
         return pirMatch[1];
+    // task-NAvW, worktree-foIg → null (soft mode). Checked before the generic
+    // case below because a short id can be all digits (task-1234).
+    if (/^(task|worktree)-/.test(dirName))
+        return null;
+    // Any other numbered protocol spawn (experiment/maintain/research, #1777):
+    // experiment-1560 → "1560" (porch project dir is 1560-slug, like SPIR).
+    const genericMatch = dirName.match(/^[a-z]+-(\d+)(?:-|$)/);
+    if (genericMatch)
+        return genericMatch[1];
     // Legacy numeric: 0110 or 0110-slug → "0110"
     const numericMatch = dirName.match(/^(\d+)(?:-|$)/);
     if (numericMatch)