smol-symphony 0.2.0 → 0.3.0

package/dist/src/shell/interp/runlog.js

@@ -0,0 +1,193 @@
+// FCIS rewrite — shell adapter: per-issue JSONL run log (kind: adapter).
+//
+// Implements {@link RunLogStore} from src/types/ports. The central
+// effect-interpreter delegates every RunLogEffect variant here:
+//   open          → createWriteStream(append) keyed by issueId
+//   set_attempt   → stamp future lines with this attempt number
+//   record        → append one stamped JSONL line (ts/issue_id/issue_identifier/attempt)
+//   system        → convenience for a `channel: "system"` line
+//   write_summary → persist the core-computed RunSummary to the sibling *.summary.json
+//   close         → end the underlying stream (idempotent)
+//
+// Ported from the original `src/runlog.ts` (RunLog + openRunLog). Two deliberate
+// shape changes vs. the original:
+//  1. The interpreter hands in the logs-root directory as `filePath`; this adapter
+//     owns the original `<dir>/<sanitizeWorkspaceKey(identifier)>.jsonl` filename
+//     contract itself (so the contract can't drift from the caller). The directory
+//     tree is created on demand and the empty-key guard is preserved as a warn+skip
+//     (the original threw, but this port is fire-and-forget and must never crash
+//     the orchestrator).
+//  2. summarizeRunLog now runs in core; the in-memory lifecycle accumulation +
+//     reduction that the original RunLog did internally is GONE from the shell.
+//     This adapter only PERSISTS the already-computed RunSummary it is handed.
+//
+// Writes are best-effort: a write/serialize/summary failure is logged at warn
+// (once per stream) and swallowed so it can never crash the orchestrator.
+// Streams open in append mode so concurrent processes / restarts append safely.
+import { createWriteStream, mkdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { sanitizeWorkspaceKey } from '../workspace-key.js';
+/**
+ * Default production RunLogStore backed by per-issue JSONL append streams on the
+ * host filesystem. Each method is keyed by `issueId` (the tracker primary key);
+ * the open call also records the filename-safe `identifier` for stamping.
+ */
+export class FsRunLogStore {
+    log;
+    logs = new Map();
+    constructor(log) {
+        this.log = log;
+    }
+    /**
+     * Open (or reopen, append-mode) the run log for an issue. `filePath` is the
+     * interpreter's `<logsRoot>/<identifier>.jsonl`; this adapter owns the original
+     * flat `<logsRoot>/<sanitizeWorkspaceKey(identifier)>.jsonl` filename contract,
+     * so it recovers `logsRoot` and re-derives the sanitized name (an identifier
+     * with separators would otherwise leak spurious subdirs). The directory tree is
+     * created on demand. A non-derivable (empty) key is warned and skipped
+     * (best-effort). Idempotent: a second open for the same issueId ends the prior
+     * stream first.
+     */
+    open(issueId, identifier, filePath) {
+        const key = sanitizeWorkspaceKey(identifier);
+        if (key.length === 0) {
+            this.log.emit('warn', 'runlog open skipped: empty filename key', {
+                issue_id: issueId,
+                issue_identifier: identifier,
+            });
+            return;
+        }
+        const resolved = path.join(logsRootOf(filePath, identifier), `${key}.jsonl`);
+        const existing = this.logs.get(issueId);
+        if (existing) {
+            // Reopen: tear down the prior stream so we don't leak it.
+            try {
+                existing.stream.end();
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        try {
+            mkdirSync(path.dirname(resolved), { recursive: true });
+        }
+        catch (err) {
+            this.log.emit('warn', 'runlog mkdir failed', {
+                issue_id: issueId,
+                issue_identifier: identifier,
+                error: err.message,
+            });
+        }
+        const stream = createWriteStream(resolved, { flags: 'a', encoding: 'utf8' });
+        const entry = { filePath: resolved, identifier, stream, attempt: 0, broken: false };
+        stream.on('error', (err) => {
+            if (!entry.broken) {
+                entry.broken = true;
+                this.log.emit('warn', 'runlog write failed', {
+                    issue_id: issueId,
+                    issue_identifier: identifier,
+                    error: err.message,
+                });
+            }
+        });
+        this.logs.set(issueId, entry);
+    }
+    setAttempt(issueId, attempt) {
+        const entry = this.logs.get(issueId);
+        if (entry)
+            entry.attempt = attempt;
+    }
+    /**
+     * Append one entry. `ts`, `issue_id`, `issue_identifier`, and `attempt` are
+     * stamped automatically and override any same-named field on the entry, so
+     * callers cannot accidentally backdate or mislabel lines (the spread order
+     * intentionally puts the auto-stamped fields LAST so they win). Best-effort.
+     */
+    record(issueId, entry) {
+        const log = this.logs.get(issueId);
+        if (!log || log.broken)
+            return;
+        const stamped = {
+            ...entry,
+            ts: new Date().toISOString(),
+            issue_id: issueId,
+            issue_identifier: log.identifier,
+            attempt: log.attempt,
+        };
+        let line;
+        try {
+            line = JSON.stringify(stamped);
+        }
+        catch (err) {
+            this.log.emit('warn', 'runlog serialize failed', {
+                issue_id: issueId,
+                error: err.message,
+            });
+            return;
+        }
+        try {
+            log.stream.write(line + '\n');
+        }
+        catch {
+            // Stream errors land in the 'error' handler. A synchronous throw here is
+            // unusual but not impossible (invalid stream state); silence it.
+        }
+    }
+    /** Convenience: emit a `channel: "system"` event. */
+    system(issueId, event, fields) {
+        this.record(issueId, { channel: 'system', event, ...(fields ? { fields } : {}) });
+    }
+    /**
+     * Persist the core-computed {@link RunSummary} next to the JSONL log
+     * (`<root>/<key>.summary.json`). Best-effort: a failure is logged at warn and
+     * swallowed (the reflector tolerates a missing summary). Unlike the original
+     * this performs NO reduction — summarizeRunLog already ran in core.
+     */
+    writeSummary(issueId, summary) {
+        const log = this.logs.get(issueId);
+        if (!log)
+            return;
+        try {
+            const summaryPath = log.filePath.replace(/\.jsonl$/, '.summary.json');
+            writeFileSync(summaryPath, JSON.stringify(summary, null, 2) + '\n', 'utf8');
+        }
+        catch (err) {
+            this.log.emit('warn', 'run summary write failed', {
+                issue_id: issueId,
+                issue_identifier: log.identifier,
+                error: err.message,
+            });
+        }
+    }
+    /**
+     * Close the underlying stream and drop it from the map. Idempotent — closing
+     * an unknown / already-closed issueId is a no-op. The original `close()`
+     * returned a Promise that resolved on stream-end; the RunLogStore port is
+     * fire-and-forget (best-effort), so we end the stream without awaiting it.
+     */
+    close(issueId) {
+        const log = this.logs.get(issueId);
+        if (!log)
+            return;
+        this.logs.delete(issueId);
+        if (log.broken)
+            return;
+        try {
+            log.stream.end();
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+// Recover `logsRoot` from the interpreter's `path.join(logsRoot, identifier + '.jsonl')`
+// by stripping the segments that the (unsanitized) identifier + extension contributed.
+// Exact inverse of runlogPathFor; lets us re-flatten an identifier that held separators.
+function logsRootOf(filePath, identifier) {
+    const segments = path.join(`${identifier}.jsonl`).split(path.sep).length;
+    let root = filePath;
+    for (let i = 0; i < segments; i++)
+        root = path.dirname(root);
+    return root;
+}
+//# sourceMappingURL=runlog.js.map

package/dist/src/shell/interp/runlog.js.map

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

package/dist/src/shell/interp/timer.js

@@ -0,0 +1,64 @@
+// FCIS rewrite — timer port (kind: adapter).
+//
+// Node-backed `TimerPort`: the sequencing seam for every `TimerEffect` variant.
+//   • sleep       — pause the calling loop for `ms` (action-retry backoff,
+//                   reaper grace). REF: `await sleep(ms)` call sites.
+//   • setTimer    — register a NAMED one-shot that re-enters the owning reducer
+//                   via `fire` when it expires. REF: `scheduleTick()` (POLL_TIMER)
+//                   + the stall/backstop/retry ticks in src/orchestrator.ts.
+//   • clearTimer  — cancel + forget a named timer. REF: `clearTimeout()`.
+//
+// Fidelity anchors (read-only reference, NOT modified):
+//   • src/orchestrator.ts — scheduleTick / scheduleRetry / onRetryTimer /
+//     detectStalls use bare `setTimeout`/`clearTimeout`; a re-arm for the SAME
+//     handle always clears the prior one first, and a fired one-shot is dropped
+//     from its map BEFORE the callback runs (so a re-arm inside the callback
+//     registers cleanly). This adapter preserves both invariants.
+//   • src/util/clock.ts — wall-clock reading lives behind the `Clock` port
+//     (src/shell/clock.ts), NOT here; timers are purely sequencing.
+//
+// The central effect-interpreter routes the `timer` family to this port
+// (src/shell/effect-interpreter-families.ts); `schedule_retry` is owned by the
+// orchestrator loop's retry scheduler, not this adapter. ZERO decisions live
+// here — delay computation, attempt counting, and breaker tripping are all core.
+//
+// Shell rule: imports from src/types/** ONLY.
+/**
+ * Node-backed `TimerPort`. Holds a registry of live `setTimeout` handles keyed
+ * by the named-timer id so a re-arm (or shutdown clear) can cancel the prior
+ * one-shot. Timers are NOT `unref()`'d: the orchestrator's self-sustaining poll
+ * loop must keep the event loop alive (REF: the bare `setTimeout` in
+ * `scheduleTick`); the shutdown path explicitly clears every named timer.
+ */
+export function createTimerPort() {
+    // One slot per id. A re-arm for an existing id replaces the slot; a fired
+    // one-shot deletes its OWN slot before invoking `fire` so a re-arm inside the
+    // callback (the poll loop's tail-reschedule) is not immediately clobbered.
+    const handles = new Map();
+    function clearTimer(id) {
+        const existing = handles.get(id);
+        if (existing !== undefined) {
+            clearTimeout(existing);
+            handles.delete(id);
+        }
+    }
+    function setTimer(id, ms, fire) {
+        // Replace any prior timer for this id (REF: `if (this.tickTimer)
+        // clearTimeout(...)` / `if (existing) clearTimeout(existing.timer_handle)`).
+        clearTimer(id);
+        const handle = setTimeout(() => {
+            // Drop the slot BEFORE firing so the callback may re-arm the same id.
+            // Guard against a slot already replaced by a racing setTimer in the same
+            // macrotask — only delete if it's still ours.
+            if (handles.get(id) === handle)
+                handles.delete(id);
+            fire();
+        }, Math.max(0, ms));
+        handles.set(id, handle);
+    }
+    // Bare (ref'd) timeout, matching REF's `await sleep(ms)`: the pending sleep
+    // keeps the loop alive until the backoff/grace elapses.
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
+    return { sleep, setTimer, clearTimer };
+}
+//# sourceMappingURL=timer.js.map

package/dist/src/shell/interp/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../../../src/shell/interp/timer.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAC3E,sEAAsE;AACtE,gFAAgF;AAChF,mFAAmF;AACnF,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,wDAAwD;AACxD,0EAA0E;AAC1E,+EAA+E;AAC/E,gFAAgF;AAChF,6EAA6E;AAC7E,kEAAkE;AAClE,2EAA2E;AAC3E,oEAAoE;AACpE,EAAE;AACF,wEAAwE;AACxE,+EAA+E;AAC/E,6EAA6E;AAC7E,iFAAiF;AACjF,EAAE;AACF,8CAA8C;AAI9C;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,0EAA0E;IAC1E,8EAA8E;IAC9E,2EAA2E;IAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEjE,SAAS,UAAU,CAAC,EAAU;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,SAAS,QAAQ,CAAC,EAAU,EAAE,EAAU,EAAE,IAAgB;QACxD,iEAAiE;QACjE,6EAA6E;QAC7E,UAAU,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;YAC7B,sEAAsE;YACtE,yEAAyE;YACzE,8CAA8C;YAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACnD,IAAI,EAAE,CAAC;QACT,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAC5E,wDAAwD;IACxD,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AACzC,CAAC"}

package/dist/src/shell/interp/tracker-disk.js

@@ -0,0 +1,99 @@
+// DiskTrackerPort: direct-disk dashboard reads split out of tracker.ts
+// (kind: adapter). Faithful to src/http-disk.ts (listIssuesFromDisk /
+// readIssueFromDisk). Stateless — no closure deps — so it lives outside the
+// adapter factory. tracker.ts re-exports listIssues/readIssue.
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { lenientFrontMatter } from './tracker-parse.js';
+const nonEmpty = (v) => (typeof v === 'string' && v.length > 0 ? v : null);
+const isDir = async (p) => {
+    try {
+        return (await stat(p)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+};
+async function* iterIssueFiles(trackerRoot) {
+    let entries;
+    try {
+        entries = await readdir(trackerRoot);
+    }
+    catch {
+        return;
+    }
+    for (const stateDir of entries) {
+        const dirPath = path.join(trackerRoot, stateDir);
+        if (!(await isDir(dirPath)))
+            continue;
+        let files;
+        try {
+            files = await readdir(dirPath);
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            if (!f.endsWith('.md'))
+                continue;
+            const filePath = path.join(dirPath, f);
+            let text;
+            try {
+                text = await readFile(filePath, 'utf8');
+            }
+            catch {
+                continue;
+            }
+            yield { stateDir, baseName: f.slice(0, -3), filePath, text };
+        }
+    }
+}
+export async function listIssues(trackerRoot) {
+    const out = [];
+    for await (const file of iterIssueFiles(trackerRoot)) {
+        const { fields } = lenientFrontMatter(file.text);
+        out.push({
+            identifier: nonEmpty(fields['identifier']) ?? file.baseName,
+            state: file.stateDir,
+            title: nonEmpty(fields['title']) ?? file.baseName,
+            proposed_by: nonEmpty(fields['proposed_by']),
+            proposed_at: nonEmpty(fields['proposed_at']),
+        });
+    }
+    out.sort((a, b) => a.identifier.localeCompare(b.identifier));
+    return out;
+}
+export async function readIssue(trackerRoot, identifier) {
+    const target = `${identifier}.md`;
+    // Fast path: try the obvious filename in every state dir before any scan.
+    let entries = [];
+    try {
+        entries = await readdir(trackerRoot);
+    }
+    catch {
+        return null;
+    }
+    for (const stateDir of entries) {
+        const dirPath = path.join(trackerRoot, stateDir);
+        if (!(await isDir(dirPath)))
+            continue;
+        let text;
+        try {
+            text = await readFile(path.join(dirPath, target), 'utf8');
+        }
+        catch {
+            continue;
+        }
+        const { fields, body } = lenientFrontMatter(text);
+        return { identifier, state: stateDir, filePath: path.join(dirPath, target), frontMatter: fields, body };
+    }
+    // Slow path: resolve by front-matter `identifier:` (matches normalize()).
+    for await (const file of iterIssueFiles(trackerRoot)) {
+        const { fields, body } = lenientFrontMatter(file.text);
+        if (nonEmpty(fields['identifier']) !== identifier)
+            continue;
+        return { identifier, state: file.stateDir, filePath: file.filePath, frontMatter: fields, body };
+    }
+    return null;
+}
+//# sourceMappingURL=tracker-disk.js.map

package/dist/src/shell/interp/tracker-disk.js.map

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

package/dist/src/shell/interp/tracker-parse.js

@@ -0,0 +1,71 @@
+// Tracker parsing helpers split out of tracker.ts (kind: adapter).
+//
+// Front-matter DECODE only (needs the `yaml` userland lib, which core may not
+// import). The new-issue YAML RENDER used to live here too but was a duplicate of
+// the pure core serializer `core/issue/file.ts:composeIssueFile`; the write_issue
+// IO now renders via that injected core fn, so the render half is gone.
+// normalize/coerce/idOf are likewise the pure core's job (core/issue/parse.ts),
+// reached via tracker.loadAllIssues + the injected core selectors.
+//
+// Fidelity: mirrors src/util/frontmatter.ts (split).
+import { parse as parseYaml } from 'yaml';
+import { TrackerError } from '../../types/errors.js';
+const isFence = (line) => /^---\s*$/.test(line ?? '');
+function findClosingFence(lines) {
+    for (let i = 1; i < lines.length; i++) {
+        if (isFence(lines[i]))
+            return i;
+    }
+    return -1;
+}
+// The `yaml` lib auto-decodes an ISO-8601 timestamp scalar to a JS `Date`. Core
+// coercers operate over PLAIN DATA only, so normalize any decoded `Date` to its ISO
+// string HERE (the shell decode boundary) — core's `asTimestamp` then only ever
+// sees a `string`. Applies to top-level scalars and array elements (the only shapes
+// front matter uses); behaviour is identical to the old core `instanceof Date`
+// branch (a Date front-matter value still becomes its ISO string).
+function normalizeDates(map) {
+    const out = {};
+    for (const [k, v] of Object.entries(map)) {
+        if (v instanceof Date)
+            out[k] = v.toISOString();
+        else if (Array.isArray(v))
+            out[k] = v.map((x) => (x instanceof Date ? x.toISOString() : x));
+        else
+            out[k] = v;
+    }
+    return out;
+}
+function decodeFields(fmText) {
+    let parsed;
+    try {
+        parsed = fmText.trim().length === 0 ? {} : parseYaml(fmText);
+    }
+    catch (err) {
+        throw new TrackerError('local_issue_parse_error', `failed to parse front matter: ${err.message}`);
+    }
+    if (parsed === null || parsed === undefined)
+        return {};
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new TrackerError('local_issue_parse_error', 'issue front matter must be a map');
+    }
+    return normalizeDates(parsed);
+}
+export function splitFrontMatter(text) {
+    const lines = text.split(/\r?\n/);
+    if (!text.startsWith('---') || !isFence(lines[0]))
+        return { fields: {}, body: text.trim() };
+    const endIdx = findClosingFence(lines);
+    if (endIdx < 0)
+        throw new TrackerError('local_issue_parse_error', 'unterminated YAML front matter');
+    return { fields: decodeFields(lines.slice(1, endIdx).join('\n')), body: lines.slice(endIdx + 1).join('\n').trim() };
+}
+export function lenientFrontMatter(text) {
+    try {
+        return splitFrontMatter(text);
+    }
+    catch {
+        return { fields: {}, body: text.trim() };
+    }
+}
+//# sourceMappingURL=tracker-parse.js.map

package/dist/src/shell/interp/tracker-parse.js.map

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