@nonameolsson/nightjar 0.0.0-stage → 0.2.0

package/dist/session.d.ts

@@ -0,0 +1,39 @@
+import type { Env } from './git.js';
+export interface SessionRequest {
+    readonly cwd: string;
+    readonly prompt: string;
+    readonly schema: object;
+    readonly tools: readonly string[];
+    readonly settings: object;
+    readonly budgetUsd: number;
+    readonly minutes: number;
+    readonly sessionId: string;
+    readonly resume?: string;
+    readonly model?: string;
+    readonly effort?: string;
+    readonly log: string;
+    readonly allowApiKey: boolean;
+    readonly env: Env;
+    readonly signal?: AbortSignal;
+}
+export type Settled = {
+    readonly kind: 'done';
+    readonly costUsd: number;
+    readonly output: unknown;
+} | {
+    readonly kind: 'stopped';
+    readonly costUsd: number;
+    readonly why: string;
+} | {
+    readonly kind: 'api-key';
+} | {
+    readonly kind: 'rate-limited';
+    readonly resetsAt: number | null;
+};
+export type SessionResult = Settled & {
+    readonly sessionId: string;
+};
+export type Session = (req: SessionRequest) => Promise<SessionResult>;
+export declare function sessionArgs(req: SessionRequest): string[];
+export declare function settle(line: unknown, allowApiKey: boolean): Settled | null;
+export declare function runSession(req: SessionRequest, command?: string): Promise<SessionResult>;

package/dist/session.js

@@ -0,0 +1,144 @@
+// One headless `claude -p` session, run restricted on Nightjar's own settings; every line it prints is kept in its log.
+import { spawn } from 'node:child_process';
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createInterface } from 'node:readline';
+export function sessionArgs(req) {
+    const args = [
+        '-p',
+        req.prompt,
+        '--restricted',
+        '--strict-mcp-config',
+        '--output-format',
+        'stream-json',
+        '--verbose',
+        '--tools',
+        req.tools.join(','),
+        '--settings',
+        JSON.stringify(req.settings),
+        '--json-schema',
+        JSON.stringify(req.schema),
+        '--max-budget-usd',
+        req.budgetUsd.toFixed(2)
+    ];
+    if (req.resume)
+        args.push('--resume', req.resume);
+    else
+        args.push('--session-id', req.sessionId);
+    if (req.model)
+        args.push('--model', req.model);
+    if (req.effort)
+        args.push('--effort', req.effort);
+    return args;
+}
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+// What one stream-json line settles, or null while the session goes on.
+export function settle(line, allowApiKey) {
+    if (!isObject(line))
+        return null;
+    // a key in use bills per token, beside the person's plan, unless --use-api-key chose it
+    if (line.type === 'system' && line.subtype === 'init') {
+        return !allowApiKey && line.apiKeySource !== 'none' ? { kind: 'api-key' } : null;
+    }
+    if (line.type === 'rate_limit_event') {
+        const info = line.rate_limit_info;
+        if (!isObject(info) || info.status !== 'rejected')
+            return null;
+        return {
+            kind: 'rate-limited',
+            resetsAt: typeof info.resetsAt === 'number' ? info.resetsAt : null
+        };
+    }
+    if (line.type !== 'result')
+        return null;
+    const costUsd = typeof line.total_cost_usd === 'number' ? line.total_cost_usd : 0;
+    if (line.subtype === 'error_max_budget_usd') {
+        return { kind: 'stopped', costUsd, why: 'it reached its budget' };
+    }
+    if (line.is_error === true) {
+        return { kind: 'stopped', costUsd, why: `it ended with ${String(line.subtype)}` };
+    }
+    if (!isObject(line.structured_output)) {
+        return { kind: 'stopped', costUsd, why: 'it gave no structured answer' };
+    }
+    return { kind: 'done', costUsd, output: line.structured_output };
+}
+const TAIL = 2000;
+// `command` is the seam a spec swaps for a stand-in.
+export function runSession(req, command = 'claude') {
+    mkdirSync(dirname(req.log), { recursive: true });
+    const log = createWriteStream(req.log, { flags: 'a' });
+    return new Promise((done) => {
+        const child = spawn(command, sessionArgs(req), {
+            cwd: req.cwd,
+            env: req.env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            // its own process group, so a stop also ends every command it started
+            detached: true
+        });
+        const stop = () => {
+            try {
+                if (child.pid !== undefined)
+                    process.kill(-child.pid, 'SIGTERM');
+            }
+            catch {
+                // the group has already ended
+            }
+        };
+        let stderr = '';
+        let settled = null;
+        let finished = false;
+        const end = (outcome) => {
+            if (finished)
+                return;
+            finished = true;
+            clearTimeout(timer);
+            req.signal?.removeEventListener('abort', abort);
+            stop();
+            const result = { ...outcome, sessionId: req.resume ?? req.sessionId };
+            // a log that failed is already closed, and would never call back
+            if (log.errored)
+                done(result);
+            else
+                log.end(() => done(result));
+        };
+        const timer = setTimeout(() => end({ kind: 'stopped', costUsd: 0, why: `it ran past ${String(req.minutes)} minutes` }), req.minutes * 60_000);
+        const abort = () => end({ kind: 'stopped', costUsd: 0, why: 'stopped by a person' });
+        if (req.signal?.aborted)
+            abort();
+        req.signal?.addEventListener('abort', abort, { once: true });
+        child.stderr.on('data', (chunk) => {
+            stderr = (stderr + chunk.toString()).slice(-TAIL);
+        });
+        createInterface({ input: child.stdout }).on('line', (text) => {
+            log.write(`${text}\n`);
+            let line;
+            try {
+                line = JSON.parse(text);
+            }
+            catch {
+                return;
+            }
+            const now = settle(line, req.allowApiKey);
+            if (now === null)
+                return;
+            // the result is not always the last line, so a session that settled is let finish
+            if (now.kind === 'done' || now.kind === 'stopped')
+                settled = now;
+            else
+                end(now);
+        });
+        // a log that cannot be written stops the session; thrown, it would leave the Feature marked as worked on
+        log.on('error', (fault) => end({ kind: 'stopped', costUsd: 0, why: `its log could not be written: ${fault.message}` }));
+        child.on('error', (fault) => end({ kind: 'stopped', costUsd: 0, why: `claude could not start: ${fault.message}` }));
+        child.on('close', (code) => {
+            const last = stderr.trim().split('\n').pop() ?? '';
+            end(settled ?? {
+                kind: 'stopped',
+                costUsd: 0,
+                why: `claude exited with code ${String(code)} and no result${last ? `: ${last}` : ''}`
+            });
+        });
+    });
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/settings.d.ts

@@ -0,0 +1,10 @@
+export declare const BUILD_TOOLS: string[];
+export declare const REVIEW_TOOLS: string[];
+export interface StepExtras {
+    readonly allowedCommands?: readonly string[];
+    readonly allowedTools?: readonly string[];
+    readonly localNetwork?: boolean;
+}
+export declare const stepTools: (extras: StepExtras) => string[];
+export declare function buildSettings(allowed: readonly string[], extras?: StepExtras): object;
+export declare function reviewSettings(): object;

package/dist/settings.js

@@ -0,0 +1,92 @@
+// --restricted keeps the person's own settings out, and dontAsk refuses what is not allowed here: nobody is there to approve it.
+export const BUILD_TOOLS = [
+    'Read',
+    'Edit',
+    'Write',
+    'Glob',
+    'Grep',
+    'Bash',
+    'Skill',
+    'Agent',
+    'TodoWrite'
+];
+// The reviewer only reads: no Edit, no Write, and Bash only for git's read commands.
+export const REVIEW_TOOLS = ['Read', 'Glob', 'Grep', 'Bash'];
+// Deny wins over any allow in Claude Code, so no config can loosen these.
+const DENY = [
+    'Bash(git commit *)',
+    'Bash(git push *)',
+    'Bash(git pull *)',
+    'Bash(git fetch *)',
+    'Bash(git clone *)',
+    'Bash(git reset *)',
+    'Bash(git checkout *)',
+    'Bash(git switch *)',
+    'Bash(git rebase *)',
+    'Bash(git merge *)',
+    'Bash(git stash *)',
+    'Bash(git clean *)',
+    'Bash(git branch *)',
+    'Bash(git worktree *)',
+    'Bash(git remote *)',
+    'Bash(git config *)',
+    'Bash(gh *)',
+    'Bash(curl *)',
+    'Bash(wget *)',
+    'Bash(ssh *)',
+    'Bash(scp *)',
+    'Bash(nc *)',
+    'Read(~/.ssh/**)',
+    'Read(~/.config/**)',
+    'Read(~/.aws/**)',
+    'WebFetch',
+    'WebSearch'
+];
+const READ_GIT = [
+    'Bash(git status)',
+    'Bash(git status *)',
+    'Bash(git diff)',
+    'Bash(git diff *)',
+    'Bash(git log *)',
+    'Bash(git show *)'
+];
+// The sandbox keeps a Step's commands to localhost; it auto-allows nothing, so the allow list still decides.
+const LOCAL_ONLY = {
+    enabled: true,
+    autoAllowBashIfSandboxed: false,
+    network: { allowedDomains: ['localhost', '127.0.0.1'], allowLocalBinding: true }
+};
+export const stepTools = (extras) => [...BUILD_TOOLS, ...(extras.allowedTools ?? [])];
+// `allowed` are factory.json's allowedCommands, as Bash permission patterns.
+export function buildSettings(allowed, extras = {}) {
+    return {
+        permissions: {
+            defaultMode: 'dontAsk',
+            allow: [
+                'Read',
+                'Edit',
+                'Write',
+                'Glob',
+                'Grep',
+                'Skill',
+                'Agent',
+                'TodoWrite',
+                ...(extras.allowedTools ?? []),
+                ...[...allowed, ...(extras.allowedCommands ?? [])].map((command) => `Bash(${command})`),
+                ...READ_GIT
+            ],
+            deny: DENY
+        },
+        ...(extras.localNetwork === true ? { sandbox: LOCAL_ONLY } : {})
+    };
+}
+export function reviewSettings() {
+    return {
+        permissions: {
+            defaultMode: 'dontAsk',
+            allow: ['Read', 'Glob', 'Grep', ...READ_GIT],
+            deny: [...DENY, 'Edit', 'Write']
+        }
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,iIAAiI;AAEjI,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,WAAW;CACX,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7D,0EAA0E;AAC1E,MAAM,IAAI,GAAG;IACZ,oBAAoB;IACpB,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,sBAAsB;IACtB,oBAAoB;IACpB,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,oBAAoB;IACpB,oBAAoB;IACpB,YAAY;IACZ,cAAc;IACd,cAAc;IACd,aAAa;IACb,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;IACjB,UAAU;IACV,WAAW;CACX,CAAC;AAEF,MAAM,QAAQ,GAAG;IAChB,kBAAkB;IAClB,oBAAoB;IACpB,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,kBAAkB;CAClB,CAAC;AASF,6GAA6G;AAC7G,MAAM,UAAU,GAAG;IAClB,OAAO,EAAE,IAAI;IACb,wBAAwB,EAAE,KAAK;IAC/B,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE;CAChF,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAkB,EAAE,EAAE,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;AAElG,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,OAA0B,EAAE,SAAqB,EAAE;IAChF,OAAO;QACN,WAAW,EAAE;YACZ,WAAW,EAAE,SAAS;YACtB,KAAK,EAAE;gBACN,MAAM;gBACN,MAAM;gBACN,OAAO;gBACP,MAAM;gBACN,MAAM;gBACN,OAAO;gBACP,OAAO;gBACP,WAAW;gBACX,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;gBAC9B,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,OAAO,GAAG,CAAC;gBACvF,GAAG,QAAQ;aACX;YACD,IAAI,EAAE,IAAI;SACV;QACD,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC7B,OAAO;QACN,WAAW,EAAE;YACZ,WAAW,EAAE,SAAS;YACtB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;YAC5C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;SAChC;KACD,CAAC;AACH,CAAC"}

package/dist/signals.d.ts

@@ -0,0 +1,5 @@
+export declare const SIGNALS: readonly ["go", "ready", "working", "needsInfo", "human"];
+export type Signal = (typeof SIGNALS)[number];
+export type SignalNames = Readonly<Record<Signal, string>>;
+export declare const DEFAULT_SIGNAL_NAMES: SignalNames;
+export declare const RESERVED_NAMES: readonly ["needs-triage", "wontfix"];

package/dist/signals.js

@@ -0,0 +1,13 @@
+// The Signals (GLOSSARY.md): shown under names a Tracker configures, never as tracker states (docs/adr/0002).
+export const SIGNALS = ['go', 'ready', 'working', 'needsInfo', 'human'];
+// The names factory.json leaves unset: the Go has a mark of its own; the rest match the triage roles.
+export const DEFAULT_SIGNAL_NAMES = {
+    go: 'factory-go',
+    ready: 'ready-for-agent',
+    working: 'agent-working',
+    needsInfo: 'needs-info',
+    human: 'ready-for-human'
+};
+// Triage roles of someone else's process: Nightjar never reads or sets them, so no Signal may take one.
+export const RESERVED_NAMES = ['needs-triage', 'wontfix'];
+//# sourceMappingURL=signals.js.map

package/dist/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../src/signals.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,CAAU,CAAC;AAMjF,sGAAsG;AACtG,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAChD,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,iBAAiB;IACxB,OAAO,EAAE,eAAe;IACxB,SAAS,EAAE,YAAY;IACvB,KAAK,EAAE,iBAAiB;CACxB,CAAC;AAEF,wGAAwG;AACxG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,cAAc,EAAE,SAAS,CAAU,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,4 @@
+import type { Env } from './git.js';
+export type LoadedSkills = (cwd: string, env: Env) => Promise<string[] | null>;
+export declare const loadedSkills: LoadedSkills;
+export declare const isLoaded: (loaded: readonly string[], name: string) => boolean;

package/dist/skills.js

@@ -0,0 +1,51 @@
+// The skills a headless Claude session loads, read off the init line it prints before it asks the model anything.
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+const WAIT_MS = 30_000;
+const strings = (value) => Array.isArray(value) ? value.filter((v) => typeof v === 'string') : [];
+// The session is started as a build starts one and killed at its init line, so it costs nothing.
+export const loadedSkills = (cwd, env) => new Promise((done) => {
+    const child = spawn('claude', [
+        '-p',
+        'Reply with ok.',
+        '--restricted',
+        '--strict-mcp-config',
+        '--output-format',
+        'stream-json',
+        '--verbose',
+        '--tools',
+        'Skill'
+    ], { cwd, env, stdio: ['ignore', 'pipe', 'ignore'], detached: true });
+    let finished = false;
+    const end = (skills) => {
+        if (finished)
+            return;
+        finished = true;
+        clearTimeout(timer);
+        try {
+            if (child.pid !== undefined)
+                process.kill(-child.pid, 'SIGTERM');
+        }
+        catch {
+            // the group has already ended
+        }
+        done(skills);
+    };
+    const timer = setTimeout(() => end(null), WAIT_MS);
+    createInterface({ input: child.stdout }).on('line', (text) => {
+        try {
+            const line = JSON.parse(text);
+            if (line.type === 'system' && line.subtype === 'init') {
+                end([...new Set([...strings(line.skills), ...strings(line.slash_commands)])]);
+            }
+        }
+        catch {
+            // not a JSON line
+        }
+    });
+    child.on('error', () => end(null));
+    child.on('close', () => end(null));
+});
+// Whether `name` is among the loaded skills, bare or under a plugin's prefix.
+export const isLoaded = (loaded, name) => loaded.some((l) => l === name || l.endsWith(`:${name}`));
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAKhD,MAAM,OAAO,GAAG,MAAM,CAAC;AAEvB,MAAM,OAAO,GAAG,CAAC,KAAc,EAAY,EAAE,CAC5C,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAErF,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CACtD,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;IACpB,MAAM,KAAK,GAAG,KAAK,CAClB,QAAQ,EACR;QACC,IAAI;QACJ,gBAAgB;QAChB,cAAc;QACd,qBAAqB;QACrB,iBAAiB;QACjB,aAAa;QACb,WAAW;QACX,SAAS;QACT,OAAO;KACP,EACD,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CACjE,CAAC;IACF,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,MAAuB,EAAE,EAAE;QACvC,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC;YACJ,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACR,8BAA8B;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,CAAC;IACd,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACnD,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAC5D,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;YACzD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;gBACvD,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/E,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,kBAAkB;QACnB,CAAC;IACF,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEJ,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,MAAyB,EAAE,IAAY,EAAE,EAAE,CACnE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC"}

package/dist/status-shape.d.ts

@@ -0,0 +1,53 @@
+export type Doing = {
+    readonly kind: 'idle';
+    readonly nextPollAt: string;
+} | {
+    readonly kind: 'building';
+    readonly feature: string;
+    readonly ticket: string | null;
+    readonly step: 'setup' | 'build' | 'fix' | 'review' | 'step';
+    readonly round: number | null;
+    readonly rounds: number | null;
+    readonly session: string | null;
+    readonly startedAt: string;
+} | {
+    readonly kind: 'paused';
+    readonly why: string;
+    readonly until: string | null;
+} | {
+    readonly kind: 'off';
+};
+export type Happened = {
+    readonly kind: 'built';
+    readonly feature: string;
+    readonly ticket: string;
+} | {
+    readonly kind: 'needs-info';
+    readonly feature: string;
+    readonly ticket: string | null;
+    readonly why: string;
+} | {
+    readonly kind: 'failed';
+    readonly feature: string;
+    readonly why: string;
+} | {
+    readonly kind: 'pull';
+    readonly feature: string;
+    readonly url: string;
+} | {
+    readonly kind: 'stale';
+    readonly commit: string;
+};
+export type Event = Happened & {
+    readonly seq: number;
+    readonly at: string;
+};
+export interface Status {
+    readonly at: string;
+    readonly pid: number;
+    readonly spentTodayUsd: number;
+    readonly dailyUsd: number;
+    readonly doing: Doing;
+    readonly recent: Event[];
+    readonly codeMoved?: string | null;
+}

package/dist/status-shape.js

@@ -0,0 +1,3 @@
+// The shape of .factory/status.json, defined once for the writer and the plugin; types only, so the plugin can import it.
+export {};
+//# sourceMappingURL=status-shape.js.map

package/dist/status-shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-shape.js","sourceRoot":"","sources":["../src/status-shape.ts"],"names":[],"mappings":"AAAA,0HAA0H"}

package/dist/status.d.ts

@@ -0,0 +1,23 @@
+import type { Doing, Happened, Status } from './status-shape.js';
+export type { Doing, Event, Happened, Status } from './status-shape.js';
+export declare const statusPath: (root: string) => string;
+export interface StatusReport {
+    readonly doing: (doing: Doing) => void;
+    readonly happened: (event: Happened) => void;
+}
+export declare function readStatus(path: string): Status | null;
+export declare class StatusFile implements StatusReport {
+    private readonly o;
+    private now;
+    private recent;
+    constructor(o: {
+        readonly path: string;
+        readonly ledger: string;
+        readonly now: () => Date;
+        readonly pid: number;
+        readonly dailyUsd: number;
+    });
+    readonly doing: (doing: Doing) => void;
+    readonly happened: (event: Happened) => void;
+    private write;
+}

package/dist/status.js

@@ -0,0 +1,56 @@
+// .factory/status.json, rewritten at every change, for a status line or toasts to read.
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { z } from 'zod';
+import { spentOn } from './ledger.js';
+export const statusPath = (root) => join(root, '.factory', 'status.json');
+const KEEP = 10;
+const StatusSchema = z.looseObject({
+    recent: z.array(z.looseObject({ seq: z.int() }))
+});
+export function readStatus(path) {
+    try {
+        const value = JSON.parse(readFileSync(path, 'utf8'));
+        return StatusSchema.safeParse(value).success ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+export class StatusFile {
+    o;
+    now = { kind: 'off' };
+    recent;
+    constructor(o) {
+        this.o = o;
+        // the events go on from the last run's, so a reader that saw them does not toast them again
+        this.recent = readStatus(o.path)?.recent ?? [];
+    }
+    doing = (doing) => {
+        this.now = doing;
+        this.write();
+    };
+    happened = (event) => {
+        const seq = (this.recent.at(-1)?.seq ?? 0) + 1;
+        const at = this.o.now().toISOString();
+        this.recent = [...this.recent, { ...event, seq, at }].slice(-KEEP);
+        this.write();
+    };
+    write() {
+        const now = this.o.now();
+        const status = {
+            at: now.toISOString(),
+            pid: this.o.pid,
+            spentTodayUsd: spentOn(this.o.ledger, now),
+            dailyUsd: this.o.dailyUsd,
+            doing: this.now,
+            recent: this.recent,
+            codeMoved: null
+        };
+        mkdirSync(dirname(this.o.path), { recursive: true });
+        const temp = `${this.o.path}.${String(this.o.pid)}.tmp`;
+        writeFileSync(temp, `${JSON.stringify(status, null, '\t')}\n`);
+        renameSync(temp, this.o.path);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

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

package/dist/tracker.d.ts

@@ -0,0 +1,56 @@
+import type { Signal } from './signals.js';
+export type ItemId = string;
+export interface Feature {
+    readonly id: ItemId;
+    readonly title: string;
+    readonly body: string;
+}
+export interface Ticket {
+    readonly id: ItemId;
+    readonly title: string;
+    readonly body: string;
+    readonly open: boolean;
+    readonly signals: readonly Signal[];
+    readonly blockedBy: readonly Blocker[];
+}
+export interface Blocker {
+    readonly id: ItemId;
+    readonly open: boolean;
+}
+export interface Comment {
+    readonly author: string;
+    readonly body: string;
+    readonly at: string;
+    readonly trusted: boolean;
+}
+export interface TicketReference {
+    readonly id: ItemId;
+    readonly text: string;
+}
+export interface Standing {
+    readonly assignees: readonly string[];
+    readonly signals: readonly Signal[];
+}
+export interface Tracker {
+    me(): Promise<string>;
+    assignedFeatures(person: string): Promise<Feature[]>;
+    feature(id: ItemId): Promise<Feature>;
+    standing(id: ItemId): Promise<Standing>;
+    tickets(featureId: ItemId): Promise<Ticket[]>;
+    comments(id: ItemId): Promise<Comment[]>;
+    addSignal(id: ItemId, signal: Signal): Promise<void>;
+    removeSignal(id: ItemId, signal: Signal): Promise<void>;
+    comment(id: ItemId, body: string): Promise<void>;
+    reference(id: ItemId): TicketReference;
+}
+export interface ItemText {
+    readonly title: string;
+    readonly body: string;
+}
+export interface FeatureWriter {
+    createFeature(feature: ItemText): Promise<ItemId>;
+    createTicket(featureId: ItemId, ticket: ItemText): Promise<ItemId>;
+    block(id: ItemId, blocker: ItemId): Promise<void>;
+}
+export declare const FEATURE_WRITER_METHODS: readonly (keyof FeatureWriter)[];
+export declare function canCreate(tracker: Tracker): tracker is Tracker & FeatureWriter;

package/dist/tracker.js

@@ -0,0 +1,12 @@
+// Typed as a record, so a method added to FeatureWriter fails to compile until it is listed here.
+const WRITER_METHODS = {
+    createFeature: true,
+    createTicket: true,
+    block: true
+};
+export const FEATURE_WRITER_METHODS = Object.keys(WRITER_METHODS);
+export function canCreate(tracker) {
+    const methods = tracker;
+    return FEATURE_WRITER_METHODS.every((name) => typeof methods[name] === 'function');
+}
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"AAkFA,kGAAkG;AAClG,MAAM,cAAc,GAAsC;IACzD,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,IAAI;IAClB,KAAK,EAAE,IAAI;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAChD,cAAc,CACsB,CAAC;AAEtC,MAAM,UAAU,SAAS,CAAC,OAAgB;IACzC,MAAM,OAAO,GAAG,OAA6C,CAAC;IAC9D,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;AACpF,CAAC"}

package/dist/workflow.d.ts

@@ -0,0 +1,33 @@
+import type { Config } from './config.js';
+import type { ItemId } from './tracker.js';
+export type WorkflowConfig = NonNullable<Config['workflows']>[string];
+export type StepConfig = WorkflowConfig['steps'][number];
+export type StepPoint = StepConfig['point'];
+export declare function workflowLine(body: string): string | undefined;
+export type Chosen = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'workflow';
+    readonly name: string;
+    readonly workflow: WorkflowConfig;
+} | {
+    readonly kind: 'refused';
+    readonly why: string;
+};
+export interface WorkflowSettings {
+    readonly workflows?: Readonly<Record<string, WorkflowConfig>>;
+    readonly defaultWorkflow?: string;
+    readonly brokenWorkflows?: Readonly<Record<string, string>>;
+}
+export declare function chooseWorkflow(settings: WorkflowSettings, body: string): Chosen;
+export declare const stepKey: (workflow: string, step: string, ticket: ItemId | null) => string;
+export declare function skillsNamed(prompt: string): string[];
+export interface StepReport {
+    readonly step: StepConfig;
+    readonly ticket: ItemId | null;
+    readonly state: 'done' | 'unmet' | 'undone';
+    readonly why?: string;
+    readonly rounds?: number;
+    readonly left: readonly string[];
+}
+export declare function workflowSection(name: string, reports: readonly StepReport[], ref: (id: ItemId) => string): string | null;