smol-symphony 0.2.0 → 0.3.1

package/dist/issues.js

@@ -1,178 +0,0 @@
-// File-creation helpers shared between the HTTP dashboard's POST /api/v1/issues handler
-// and the MCP propose_issue tool. Both write a Markdown file with YAML front matter into
-// `<tracker.root>/<state>/<identifier>.md`; this module owns the slug + collision logic
-// and the front-matter serializer so the two callers can't drift.
-//
-// State-of-file shape is the local-tracker contract: see src/trackers/local.ts for the
-// reader side.
-import path from 'node:path';
-import { sanitizeWorkspaceKey } from './util/workspace-key.js';
-import { realClock, isoFromClock } from './util/clock.js';
-import { realIssueFs } from './util/fs-issues.js';
-/**
- * Thrown by `pickHoldingState` when no `holding`-role state is declared. The
- * workflow parser refuses configs without one, so reaching this path implies a
- * programmer error or a hand-mutated config — callers that surface this to
- * agents (the MCP propose_issue tool, the HTTP triage handler) should produce
- * a structured `no_holding_state` error rather than a generic message.
- */
-export class NoHoldingStateError extends Error {
-    constructor() {
-        super('no holding state declared in workflow');
-        this.name = 'NoHoldingStateError';
-    }
-}
-/**
- * First declared `holding` state in declaration order. Shared between the MCP
- * `propose_issue` tool (where new agent-proposed issues land) and the HTTP
- * triage approve/discard handler (where the from-state is implied). Throws
- * `NoHoldingStateError` when no holding state is declared.
- */
-export function pickHoldingState(states) {
-    for (const [name, cfg] of Object.entries(states)) {
-        if (cfg.role === 'holding')
-            return name;
-    }
-    throw new NoHoldingStateError();
-}
-/**
- * Names of every `role: active` state in declaration order. Used by the
- * orchestrator's eligibility/reconciliation paths, the local tracker's
- * candidate filter, and the HTTP dashboard's default-state lookup.
- */
-export function activeStateNames(states) {
-    const out = [];
-    for (const [name, cfg] of Object.entries(states)) {
-        if (cfg.role === 'active')
-            out.push(name);
-    }
-    return out;
-}
-/**
- * Names of every `role: terminal` state in declaration order. Mirror of
- * `activeStateNames` for the terminal role — used by the orchestrator's
- * reconcile/eligibility/cleanup paths and by the local tracker.
- */
-export function terminalStateNames(states) {
-    const out = [];
-    for (const [name, cfg] of Object.entries(states)) {
-        if (cfg.role === 'terminal')
-            out.push(name);
-    }
-    return out;
-}
-// Walk every state directory under `trackerRoot` and return the set of issue identifiers
-// (filename stem) currently present. Used to pick the next free numeric identifier —
-// checking only the target state directory would let a `Done/3.md` silently shadow a
-// freshly created `Todo/3.md` once it moves out of Todo.
-export async function collectExistingIdentifiers(trackerRoot, fs = realIssueFs) {
-    const out = new Set();
-    let entries;
-    try {
-        entries = await fs.readdir(trackerRoot);
-    }
-    catch {
-        return out;
-    }
-    for (const stateDir of entries) {
-        const dirPath = path.join(trackerRoot, stateDir);
-        let st;
-        try {
-            st = await fs.stat(dirPath);
-        }
-        catch {
-            continue;
-        }
-        if (!st.isDirectory())
-            continue;
-        let files;
-        try {
-            files = await fs.readdir(dirPath);
-        }
-        catch {
-            continue;
-        }
-        for (const f of files) {
-            if (f.endsWith('.md'))
-                out.add(f.slice(0, -3));
-        }
-    }
-    return out;
-}
-/**
- * Used by the dashboard form and the MCP propose_issue tool. The local tracker stores
- * issues at `<tracker.root>/<state>/<identifier>.md` with YAML front matter; identifier
- * sanitization re-uses the workspace key rules so the file name is always safe across
- * the rest of the orchestrator.
- */
-export async function writeIssueFile(input) {
-    const fs = input.fs ?? realIssueFs;
-    const stateDir = path.join(input.trackerRoot, input.state);
-    await fs.mkdir(stateDir, { recursive: true });
-    let ident;
-    let filePath;
-    const explicit = (input.identifier ?? '').trim();
-    if (explicit.length > 0) {
-        ident = sanitizeWorkspaceKey(explicit);
-        if (!ident)
-            throw new Error('identifier must contain at least one allowed character');
-        filePath = path.join(stateDir, `${ident}.md`);
-        try {
-            await fs.stat(filePath);
-            throw new Error(`issue ${ident} already exists at ${filePath}`);
-        }
-        catch (err) {
-            if (err.code !== 'ENOENT')
-                throw err;
-        }
-    }
-    else {
-        // No identifier supplied → pick the next free numeric identifier by counting up from 1
-        // until we find a basename that doesn't already exist in any state directory. Title-slug
-        // files from prior cycles are inert here: only numeric basenames consume IDs, so legacy
-        // `add-changelog.md` files coexist with the numeric scheme without claiming a slot.
-        const existing = await collectExistingIdentifiers(input.trackerRoot, fs);
-        let n = 1;
-        while (existing.has(String(n)))
-            n += 1;
-        ident = String(n);
-        filePath = path.join(stateDir, `${ident}.md`);
-    }
-    const now = isoFromClock(input.now ?? realClock);
-    const fm = {
-        id: ident,
-        identifier: ident,
-        title: input.title,
-        created_at: now,
-        updated_at: now,
-    };
-    if (typeof input.priority === 'number')
-        fm.priority = input.priority;
-    if (input.labels && input.labels.length > 0)
-        fm.labels = input.labels;
-    if (input.blocked_by && input.blocked_by.length > 0)
-        fm.blocked_by = input.blocked_by;
-    if (input.extra_front_matter) {
-        for (const [k, v] of Object.entries(input.extra_front_matter)) {
-            fm[k] = v;
-        }
-    }
-    const yamlLines = ['---'];
-    for (const [k, v] of Object.entries(fm)) {
-        if (Array.isArray(v)) {
-            yamlLines.push(`${k}: [${v.map((x) => JSON.stringify(x)).join(', ')}]`);
-        }
-        else if (typeof v === 'string') {
-            yamlLines.push(`${k}: ${JSON.stringify(v)}`);
-        }
-        else {
-            yamlLines.push(`${k}: ${String(v)}`);
-        }
-    }
-    yamlLines.push('---', '');
-    const body = (input.description ?? '').trim();
-    const content = yamlLines.join('\n') + (body.length > 0 ? body + '\n' : '');
-    await fs.writeFile(filePath, content, 'utf8');
-    return { path: filePath, identifier: ident, state: input.state };
-}
-//# sourceMappingURL=issues.js.map

package/dist/issues.js.map

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

package/dist/logging.js

@@ -1,203 +0,0 @@
-// Structured key=value logging per SPEC.md §9.1.
-// Sink failures do not crash the orchestrator (§9.2).
-//
-// Persistent file sink: when `setLogFile(path)` has been called, each emitted
-// line is appended to that file. The on-disk format matches the stderr format
-// (one `key=value ...` line per event) so an agent inspecting logs later sees
-// the same shape. File-sink failures are swallowed (one stderr warning on first
-// failure, then silent) per §9.2 so a full disk or permission error can never
-// crash the orchestrator.
-//
-// Console routing (issue 118): when a file sink is active, structured lines go
-// to the file ONLY — the operator console stays clean and shows just the
-// intentional stdout banner. stderr remains the fallback when no file sink is
-// configured (nothing is silently lost in a no-log-file setup), and
-// `setLogVerbose(true)` (the `--verbose` flag) forces lines back onto stderr
-// alongside the file for interactive debugging.
-import { closeSync, createWriteStream, mkdirSync, openSync } from 'node:fs';
-import path from 'node:path';
-const ENV_LEVEL = (process.env.SYMPHONY_LOG_LEVEL ?? 'info').toLowerCase();
-const LEVEL_RANK = { debug: 10, info: 20, warn: 30, error: 40 };
-let fileSink = null;
-let fileSinkBroken = false;
-let fileSinkPath = null;
-let verbose = false;
-function quote(v) {
-    if (v === null || v === undefined)
-        return '';
-    const s = String(v);
-    return /[\s"=]/.test(s) ? JSON.stringify(s) : s;
-}
-function format(level, msg, fields) {
-    const ts = new Date().toISOString();
-    const parts = [`ts=${ts}`, `level=${level}`, `msg=${quote(msg)}`];
-    for (const [k, v] of Object.entries(fields)) {
-        if (v === undefined)
-            continue;
-        parts.push(`${k}=${quote(v)}`);
-    }
-    return parts.join(' ');
-}
-function writeFileSink(line) {
-    if (!fileSink || fileSinkBroken)
-        return;
-    try {
-        fileSink.write(line);
-    }
-    catch {
-        // Stream errors land in the 'error' handler attached in setLogFile; a
-        // synchronous throw is unusual but not impossible — swallow it.
-    }
-}
-function emit(level, msg, fields = {}) {
-    if (LEVEL_RANK[level] < LEVEL_RANK[ENV_LEVEL])
-        return;
-    const line = format(level, msg, fields) + '\n';
-    // Route to stderr only when no working file sink is capturing the line
-    // (so a no-log-file setup loses nothing) or when --verbose was requested
-    // (interactive debugging). A broken sink counts as inactive so its dropped
-    // writes fall back to stderr rather than vanishing. See issue 118.
-    const fileSinkActive = fileSink !== null && !fileSinkBroken;
-    if (verbose || !fileSinkActive) {
-        try {
-            process.stderr.write(line);
-        }
-        catch {
-            // Spec §9.2: a failed sink must not crash the service.
-        }
-    }
-    writeFileSink(line);
-}
-/**
- * Force structured logs back onto stderr even when a file sink is active. The
- * `--verbose` / `--foreground` flag flips this on for interactive debugging;
- * the default (false) keeps the console clean by routing logs to the file only
- * whenever a sink is configured. Idempotent.
- */
-export function setLogVerbose(on) {
-    verbose = on;
-}
-/**
- * Enable (or replace) the persistent file sink. Pass `null` to close any
- * currently-open file sink and revert to stderr-only.
- *
- * The directory is created on demand. The file is opened synchronously via
- * `openSync` so failures (EISDIR, EACCES, ENOTDIR, ENOSPC) raise before the
- * sink is installed — by the time this returns a non-null path, the file is
- * known to be writable. Open failures do not throw: a single stderr warning
- * is emitted and the function returns `null` so callers can branch without a
- * try/catch. After a successful open, runtime stream errors flip the sink
- * into a broken state (silently dropping further writes) so a mid-run
- * disk-full condition cannot recursively spam stderr.
- *
- * Idempotent for repeated calls with the same path. Returns the absolute path
- * actually opened, or `null` when the sink was disabled or failed to open.
- */
-export function setLogFile(filePath) {
-    if (filePath === null || filePath === '') {
-        void closeLogFile();
-        return null;
-    }
-    const abs = path.resolve(filePath);
-    if (fileSink && fileSinkPath === abs && !fileSinkBroken)
-        return abs;
-    void closeLogFile();
-    let fd;
-    try {
-        mkdirSync(path.dirname(abs), { recursive: true });
-        // Open synchronously so EISDIR / EACCES / ENOTDIR surface here instead of
-        // arriving asynchronously on the stream's 'error' event after setLogFile()
-        // has already returned the path. Passing the fd into createWriteStream
-        // tells Node to reuse it (the stream's close still releases the fd).
-        fd = openSync(abs, 'a');
-    }
-    catch (err) {
-        try {
-            process.stderr.write(format('warn', 'log file sink open failed', { path: abs, error: err.message }) +
-                '\n');
-        }
-        catch {
-            // stderr itself failed; nothing left to do.
-        }
-        fileSink = null;
-        fileSinkPath = null;
-        fileSinkBroken = false;
-        return null;
-    }
-    let stream;
-    try {
-        stream = createWriteStream(abs, { encoding: 'utf8', fd, autoClose: true });
-    }
-    catch (err) {
-        try {
-            closeSync(fd);
-        }
-        catch {
-            // fd already gone; nothing to do.
-        }
-        try {
-            process.stderr.write(format('warn', 'log file sink open failed', { path: abs, error: err.message }) +
-                '\n');
-        }
-        catch {
-            // stderr itself failed; nothing left to do.
-        }
-        fileSink = null;
-        fileSinkPath = null;
-        fileSinkBroken = false;
-        return null;
-    }
-    stream.on('error', (err) => {
-        if (!fileSinkBroken) {
-            fileSinkBroken = true;
-            try {
-                process.stderr.write(format('warn', 'log file sink write failed', { path: abs, error: err.message }) + '\n');
-            }
-            catch {
-                // stderr itself failed; nothing left to do.
-            }
-        }
-    });
-    fileSink = stream;
-    fileSinkPath = abs;
-    fileSinkBroken = false;
-    return abs;
-}
-/**
- * Close the file sink and await the underlying stream's flush. Safe to call
- * repeatedly. Callers that intend to `process.exit()` immediately afterwards
- * MUST await this — `process.exit` does not drain pending WriteStream writes,
- * so the final log lines (including the shutdown banner) would otherwise be
- * lost. Tests that read the file back also await.
- */
-export async function closeLogFile() {
-    const sink = fileSink;
-    fileSink = null;
-    fileSinkPath = null;
-    fileSinkBroken = false;
-    if (!sink)
-        return;
-    await new Promise((resolve) => {
-        try {
-            sink.end(() => resolve());
-        }
-        catch {
-            resolve();
-        }
-    });
-}
-export const log = {
-    debug: (msg, fields) => emit('debug', msg, fields ?? {}),
-    info: (msg, fields) => emit('info', msg, fields ?? {}),
-    warn: (msg, fields) => emit('warn', msg, fields ?? {}),
-    error: (msg, fields) => emit('error', msg, fields ?? {}),
-};
-export function withIssue(ctx) {
-    return {
-        debug: (msg, fields = {}) => log.debug(msg, { ...ctx, ...fields }),
-        info: (msg, fields = {}) => log.info(msg, { ...ctx, ...fields }),
-        warn: (msg, fields = {}) => log.warn(msg, { ...ctx, ...fields }),
-        error: (msg, fields = {}) => log.error(msg, { ...ctx, ...fields }),
-    };
-}
-//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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