nfo-cli 0.0.1

package/dist/musicians/message-log.js

@@ -0,0 +1,89 @@
+import { randomUUID } from 'node:crypto';
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { messageLogsDir } from '../config.js';
+function messageLogFile(orchestraId, musicianId) {
+    return join(messageLogsDir(orchestraId), `${musicianId}.jsonl`);
+}
+async function appendEvent(orchestraId, musicianId, event) {
+    const dir = messageLogsDir(orchestraId);
+    await mkdir(dir, { recursive: true });
+    await appendFile(messageLogFile(orchestraId, musicianId), JSON.stringify(event) + '\n', 'utf8');
+}
+async function readEvents(orchestraId, musicianId) {
+    const file = messageLogFile(orchestraId, musicianId);
+    if (!existsSync(file)) {
+        return [];
+    }
+    const raw = await readFile(file, 'utf8');
+    return raw
+        .split('\n')
+        .map((line) => { return line.trim(); })
+        .filter((line) => { return line.length > 0; })
+        .map((line) => { return JSON.parse(line); });
+}
+export async function queueMusicianMessage(orchestraId, musicianId, message) {
+    const createdAt = new Date().toISOString();
+    const messageId = `${Date.now()}-${randomUUID()}`;
+    await appendEvent(orchestraId, musicianId, {
+        type: 'message_queued',
+        message_id: messageId,
+        musician_id: musicianId,
+        message,
+        created_at: createdAt,
+    });
+    return { messageId, createdAt };
+}
+export async function markMusicianMessageDelivered(orchestraId, musicianId, messageId, delivery, deliveredAt = new Date().toISOString()) {
+    await appendEvent(orchestraId, musicianId, {
+        type: 'message_delivered',
+        message_id: messageId,
+        delivered_at: deliveredAt,
+        delivery,
+    });
+}
+export async function listPendingMusicianMessages(orchestraId, musicianId) {
+    const events = await readEvents(orchestraId, musicianId);
+    const pending = new Map();
+    for (const event of events) {
+        if (event.type === 'message_queued') {
+            pending.set(event.message_id, {
+                messageId: event.message_id,
+                musicianId: event.musician_id,
+                message: event.message,
+                createdAt: event.created_at,
+            });
+            continue;
+        }
+        pending.delete(event.message_id);
+    }
+    return [...pending.values()].sort((left, right) => {
+        return left.createdAt.localeCompare(right.createdAt);
+    });
+}
+export async function countPendingMusicianMessages(orchestraId, musicianId) {
+    const pending = await listPendingMusicianMessages(orchestraId, musicianId);
+    return pending.length;
+}
+export function formatQueuedMusicianMessages(messages) {
+    if (messages.length === 0) {
+        return '';
+    }
+    if (messages.length === 1) {
+        return messages[0].message;
+    }
+    const lines = [
+        'NFO queued follow-up messages while you were busy:',
+        '',
+    ];
+    messages.forEach((message, index) => {
+        lines.push(`${index + 1}.`);
+        lines.push(message.message);
+        if (index < messages.length - 1) {
+            lines.push('');
+        }
+    });
+    return lines.join('\n');
+}
+//# sourceMappingURL=message-log.js.map

package/dist/musicians/message-log.js.map

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

package/dist/musicians/message.js

@@ -0,0 +1,54 @@
+import { sendKeys, sessionName } from '../tmux.js';
+import { readState } from '../state.js';
+import { findMusicianStrict } from './lookup.js';
+import { setMusicianStatus, touchMusicianActivity, } from '../state-updaters.js';
+import { countPendingMusicianMessages, formatQueuedMusicianMessages, listPendingMusicianMessages, markMusicianMessageDelivered, queueMusicianMessage, } from './message-log.js';
+async function deliverPendingMessages(orchestraId, musicianId, delivery) {
+    const state = await readState(orchestraId);
+    if (!state) {
+        throw new Error(`Unknown orchestra: ${orchestraId}`);
+    }
+    const musician = findMusicianStrict(state, musicianId);
+    const pending = await listPendingMusicianMessages(orchestraId, musicianId);
+    if (pending.length === 0) {
+        return 0;
+    }
+    const target = `${sessionName(orchestraId)}:${musician.tmux_window_id}`;
+    const message = formatQueuedMusicianMessages(pending);
+    await sendKeys(target, message, true);
+    const deliveredAt = new Date().toISOString();
+    for (const pendingMessage of pending) {
+        await markMusicianMessageDelivered(orchestraId, musicianId, pendingMessage.messageId, delivery, deliveredAt);
+    }
+    await touchMusicianActivity(orchestraId, musicianId, deliveredAt);
+    return pending.length;
+}
+export async function messageMusician(opts) {
+    const state = await readState(opts.orchestraId);
+    if (!state) {
+        throw new Error(`Unknown orchestra: ${opts.orchestraId}`);
+    }
+    const musician = findMusicianStrict(state, opts.musicianId);
+    const queued = await queueMusicianMessage(opts.orchestraId, opts.musicianId, opts.message);
+    if (musician.status === 'idle') {
+        const delivery = (await countPendingMusicianMessages(opts.orchestraId, opts.musicianId)) === 1 ? 'immediate' : 'queued-drain';
+        await deliverPendingMessages(opts.orchestraId, opts.musicianId, delivery);
+        await setMusicianStatus(opts.orchestraId, opts.musicianId, 'working');
+        return {
+            ok: true,
+            delivery: 'immediate',
+            message_id: queued.messageId,
+            pending_messages: 0,
+        };
+    }
+    return {
+        ok: true,
+        delivery: 'queued',
+        message_id: queued.messageId,
+        pending_messages: await countPendingMusicianMessages(opts.orchestraId, opts.musicianId),
+    };
+}
+export async function drainQueuedMusicianMessages(orchestraId, musicianId) {
+    return deliverPendingMessages(orchestraId, musicianId, 'queued-drain');
+}
+//# sourceMappingURL=message.js.map

package/dist/musicians/message.js.map

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

package/dist/musicians/query.js

@@ -0,0 +1,13 @@
+import { capturePane, sessionName } from '../tmux.js';
+import { readState } from '../state.js';
+import { findMusicianStrict } from './lookup.js';
+export async function queryMusician(opts) {
+    const state = await readState(opts.orchestraId);
+    if (!state) {
+        throw new Error(`Unknown orchestra: ${opts.orchestraId}`);
+    }
+    const musician = findMusicianStrict(state, opts.musicianId);
+    const target = `${sessionName(opts.orchestraId)}:${musician.tmux_window_id}`;
+    return capturePane(target, opts.lines ?? 80);
+}
+//# sourceMappingURL=query.js.map

package/dist/musicians/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/musicians/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQjD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC7E,OAAO,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/musicians/spawn.js

@@ -0,0 +1,102 @@
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { execa } from "execa";
+import { addMusician } from "../state-updaters.js";
+import { readState } from "../state.js";
+import { orchestraDir, worktreesDir } from "../config.js";
+import { addWorktree } from "../worktree.js";
+import { claudeFlagsForLevel } from "../permission.js";
+import { respawnPane, sessionName, setPaneOption } from "../tmux.js";
+import { MUSICIAN_ROLE_PROMPT_V1 } from "../prompts/musician-role.js";
+import { buildMusicianInitialPrompt } from "../prompts/tool-discipline.js";
+import { nextMusicianId } from "./ids.js";
+import { buildClaudeCommand } from "../claude-command.js";
+import { writeMusicianMcpConfig } from "../mcp/config.js";
+export async function createMusician(opts) {
+    const state = await readState(opts.orchestraId);
+    if (!state) {
+        throw new Error(`Unknown orchestra: ${opts.orchestraId}`);
+    }
+    const musicianId = nextMusicianId(state);
+    const useWorktree = opts.worktree !== false;
+    let workingDir;
+    let worktreePath = null;
+    let branch = null;
+    if (useWorktree) {
+        worktreePath = join(worktreesDir(opts.orchestraId), musicianId);
+        branch = `nfo/${musicianId}`;
+        await addWorktree({
+            repoRoot: state.project_path,
+            path: worktreePath,
+            branch,
+            baseRef: opts.branchFrom,
+        });
+        workingDir = worktreePath;
+    }
+    else {
+        workingDir = state.project_path;
+    }
+    const promptFile = join(orchestraDir(opts.orchestraId), `musician-${musicianId}-prompt.md`);
+    await writeFile(promptFile, MUSICIAN_ROLE_PROMPT_V1, "utf8");
+    const session = sessionName(opts.orchestraId);
+    const winLabel = `mus-${musicianId}-${sanitiseName(opts.name)}`;
+    const { stdout: tmuxWindowId } = await execa("tmux", [
+        "new-window",
+        "-t",
+        session,
+        "-n",
+        winLabel,
+        "-c",
+        workingDir,
+        "-d",
+        "-P",
+        "-F",
+        "#{window_id}",
+    ]);
+    if (!opts.dryRun) {
+        const mcpConfigPath = await writeMusicianMcpConfig(opts.orchestraId, musicianId);
+        const flags = claudeFlagsForLevel(state.permission_level);
+        const cmd = buildClaudeCommand({
+            flags,
+            mcpConfigPath,
+            promptFile,
+            prompt: buildMusicianInitialPrompt(opts.task),
+            model: opts.model,
+        });
+        await setPaneOption(`${session}:${tmuxWindowId.trim()}`, "remain-on-exit", "on");
+        await respawnPane(`${session}:${tmuxWindowId.trim()}`, cmd);
+    }
+    else {
+        await writeMusicianMcpConfig(opts.orchestraId, musicianId);
+    }
+    const now = new Date().toISOString();
+    await addMusician(opts.orchestraId, {
+        id: musicianId,
+        name: opts.name,
+        task_summary: opts.task.slice(0, 200),
+        status: "working",
+        pending_permission: null,
+        tmux_window_id: tmuxWindowId.trim(),
+        claude_session_id: null,
+        worktree_path: worktreePath,
+        branch,
+        spawned_at: now,
+        last_activity: now,
+        model: opts.model,
+    });
+    return {
+        musician_id: musicianId,
+        worktree_path: worktreePath,
+        branch,
+        tmux_window_id: tmuxWindowId.trim(),
+    };
+}
+function sanitiseName(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 32) || "musician");
+}
+//# sourceMappingURL=spawn.js.map

package/dist/musicians/spawn.js.map

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

package/dist/notes.js

@@ -0,0 +1,32 @@
+import { readFile, writeFile, readdir, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { notesDir } from './config.js';
+function ensureSafeFilename(filename) {
+    if (!filename || /[\/\\]/.test(filename) || filename.includes('..')) {
+        throw new Error(`invalid filename: ${filename}`);
+    }
+}
+export async function noteWrite(orchestraId, filename, content) {
+    ensureSafeFilename(filename);
+    const dir = notesDir(orchestraId);
+    await mkdir(dir, { recursive: true });
+    await writeFile(join(dir, filename), content, 'utf8');
+}
+export async function noteRead(orchestraId, filename) {
+    ensureSafeFilename(filename);
+    const file = join(notesDir(orchestraId), filename);
+    if (!existsSync(file)) {
+        return '';
+    }
+    return readFile(file, 'utf8');
+}
+export async function noteList(orchestraId) {
+    const dir = notesDir(orchestraId);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const entries = await readdir(dir, { withFileTypes: true });
+    return entries.filter((e) => { return e.isFile(); }).map((e) => { return e.name; });
+}
+//# sourceMappingURL=notes.js.map

package/dist/notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.js","sourceRoot":"","sources":["../src/notes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,QAAgB,EAChB,OAAe;IAEf,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB,EAAE,QAAgB;IAClE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB;IAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/notify.js

@@ -0,0 +1,51 @@
+import { execa } from 'execa';
+function defaultBell(text) {
+    process.stdout.write(text);
+}
+async function defaultSpawn(bin, args) {
+    return execa(bin, args);
+}
+function pluralise(count) {
+    if (count === 1) {
+        return '1 musician awaiting permission';
+    }
+    return `${count} musicians awaiting permission`;
+}
+/**
+ * Fire a single notification: ring the terminal bell and (best-effort) spawn
+ * the platform's desktop notifier. All errors are swallowed — a missing
+ * notify-send / osascript / etc. must not break the orchestra.
+ */
+export async function notifyAwaitingPermission(opts) {
+    const bell = opts.bell ?? defaultBell;
+    const spawn = opts.spawn ?? defaultSpawn;
+    const platform = opts.platform ?? process.platform;
+    const message = pluralise(opts.pendingCount);
+    try {
+        bell('\x07');
+    }
+    catch {
+        // Swallow — a broken stdout sink should never abort.
+    }
+    if (platform === 'linux') {
+        try {
+            await spawn('notify-send', ['NFO', message]);
+        }
+        catch {
+            // notify-send may not be installed — best-effort only.
+        }
+        return;
+    }
+    if (platform === 'darwin') {
+        const script = `display notification "${message}" with title "NFO"`;
+        try {
+            await spawn('osascript', ['-e', script]);
+        }
+        catch {
+            // osascript should exist on macOS but swallow defensively.
+        }
+        return;
+    }
+    // Unknown platform (win32, freebsd, etc.) — bell-only.
+}
+//# sourceMappingURL=notify.js.map

package/dist/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAS9B,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,IAAc;IACrD,OAAO,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,KAAK,gCAAgC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAmB;IAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,yBAAyB,OAAO,oBAAoB,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QACD,OAAO;IACT,CAAC;IAED,uDAAuD;AACzD,CAAC"}

package/dist/orchestrator/report-back.js

@@ -0,0 +1,21 @@
+import { sendKeys, sessionName } from '../tmux.js';
+export function formatMusicianDonePrompt(report) {
+    const nextSteps = report.nextSteps?.trim()
+        ? `\nSuggested next steps from the Musician:\n${report.nextSteps.trim()}\n`
+        : '';
+    return `Musician ${report.musicianId} (${report.musicianName}) reported done and is now idle.
+
+Summary:
+${report.summary}
+${nextSteps}
+Resolve this now with an NFO tool call only:
+- If the work is good enough, call dismiss_musician({ musician_id: ${JSON.stringify(report.musicianId)} }).
+- If it needs another pass, call message_musician({ musician_id: ${JSON.stringify(report.musicianId)}, message: "..." }).
+
+Do not leave this Musician idle without either dismissing it or sending the next iteration.
+A plain-text acknowledgement is invalid here.`;
+}
+export async function notifyOrchestratorOfDoneReport(orchestraId, report) {
+    await sendKeys(`${sessionName(orchestraId)}:0`, formatMusicianDonePrompt(report), true);
+}
+//# sourceMappingURL=report-back.js.map

package/dist/orchestrator/report-back.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-back.js","sourceRoot":"","sources":["../../src/orchestrator/report-back.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AASnD,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IACjE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE;QACxC,CAAC,CAAC,8CAA8C,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI;QAC3E,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,YAAY,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC,YAAY;;;EAG5D,MAAM,CAAC,OAAO;EACd,SAAS;;qEAE0D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;mEACnC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC;;;8CAGtD,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,WAAmB,EACnB,MAA0B;IAE1B,MAAM,QAAQ,CAAC,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1F,CAAC"}

package/dist/permission.js

@@ -0,0 +1,26 @@
+export const PERMISSION_LEVELS = ['auto', 'autonomous', 'supervised', 'strict'];
+export function isPermissionLevel(s) {
+    return PERMISSION_LEVELS.includes(s);
+}
+export function claudeFlagsForLevel(level) {
+    switch (level) {
+        case 'auto':
+            // Spec §5.2 + §12.2 open question: exact bypass flag is `--dangerously-skip-permissions`
+            // in current Claude Code releases. If a future release renames it, update here.
+            return ['--dangerously-skip-permissions'];
+        case 'autonomous':
+            return ['--permission-mode', 'acceptEdits'];
+        case 'supervised':
+            return ['--permission-mode', 'default'];
+        case 'strict':
+            return ['--permission-mode', 'plan'];
+    }
+}
+export const AUTO_CONFIRM_PHRASE = 'I understand';
+export const AUTO_WARNING = `⚠ AUTO mode disables all permission checks.
+Musicians can execute arbitrary shell commands, modify files anywhere on
+this system, and access the network without asking. Worktrees limit but
+do not contain risky operations. Use this only in trusted sandboxes or
+when you accept these risks.
+Type "${AUTO_CONFIRM_PHRASE}" to continue.`;
+//# sourceMappingURL=permission.js.map

package/dist/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,CAAU,CAAC;AAGzF,MAAM,UAAU,iBAAiB,CAAC,CAAS;IACzC,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,yFAAyF;YACzF,gFAAgF;YAChF,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAC5C,KAAK,YAAY;YACf,OAAO,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;QAC9C,KAAK,YAAY;YACf,OAAO,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;QAC1C,KAAK,QAAQ;YACX,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;QAKpB,mBAAmB,gBAAgB,CAAC"}

package/dist/project-key.js

@@ -0,0 +1,12 @@
+import { createHash } from 'node:crypto';
+import { basename } from 'node:path';
+export function projectKeyFromPath(absolutePath) {
+    const hash = createHash('sha1').update(absolutePath).digest('hex').slice(0, 10);
+    const name = basename(absolutePath)
+        .toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return `${hash}-${name || 'project'}`;
+}
+//# sourceMappingURL=project-key.js.map

package/dist/project-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-key.js","sourceRoot":"","sources":["../src/project-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC;SAChC,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,GAAG,IAAI,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;AACxC,CAAC"}

package/dist/prompts/musician-role.js

@@ -0,0 +1,22 @@
+import { MUSICIAN_TOOL_DISCIPLINE } from './tool-discipline.js';
+export const MUSICIAN_ROLE_PROMPT_V1 = `You are a Musician in an NFO orchestra.
+
+You were spawned by the Orchestrator with a specific task. The user typing into
+your pane is debugging / observing — usually the user does NOT direct you;
+the Orchestrator does. Treat new user messages as either Orchestrator
+hand-offs or out-of-band human guidance, and use judgment.
+
+Your workspace is a dedicated git worktree, so file edits are isolated from
+other Musicians. When you finish the task you were spawned with, call the
+\`report_done\` MCP tool with a concise summary and optional next steps. After
+that, stay alive while the Orchestrator reviews your report. NFO may batch
+queued follow-up messages and deliver them right after \`report_done\`; if the
+Orchestrator is satisfied, it may dismiss you instead.
+
+${MUSICIAN_TOOL_DISCIPLINE}
+
+You also have the full NFO MCP tool surface (\`spawn_musician\`,
+\`message_musician\`, etc.). Avoid spawning sub-Musicians unless the
+Orchestrator explicitly asks you to. Keep coordination centralised.
+`;
+//# sourceMappingURL=musician-role.js.map

package/dist/prompts/musician-role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"musician-role.js","sourceRoot":"","sources":["../../src/prompts/musician-role.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;EAcrC,wBAAwB;;;;;CAKzB,CAAC"}

package/dist/prompts/orchestrator-role.js

@@ -0,0 +1,62 @@
+import { ORCHESTRATOR_TOOL_DISCIPLINE } from "./tool-discipline.js";
+/**
+ * Phase 2 Orchestrator role addendum. Documents the NFO MCP tool surface.
+ */
+export const ORCHESTRATOR_ROLE_PROMPT_V1 = `You are the Orchestrator of an NFO orchestra.
+
+NFO (NoFluffOrchestra) is a TUI for multi-agent work on the user's repository.
+You coordinate Musicians (other Claude Code agents) via the NFO MCP tools.
+
+Available NFO tools (in addition to your normal Claude Code tools):
+
+  spawn_musician({ name, task, worktree?, branch_from?, model? })
+    Create a Musician with the given task. By default the Musician runs in a
+    fresh git worktree off HEAD. Pass worktree=false for trivially isolated
+    work (e.g., docs-only) that doesn't need an isolated branch. Returns the
+    musician_id. Provide a model to be used by the Musician, otherwise it defaults to sonnet.
+    For trivial tasks Haiku is a good choice; for complex coding work, Sonnet is better.
+
+  message_musician({ musician_id, message })
+    Send a message to a Musician. If the Musician is idle, NFO delivers it
+    immediately. If the Musician is still working, NFO queues it and delivers
+    it automatically on the next idle boundary.
+
+  query_musician({ musician_id, lines? })
+    Read the most recent visible output from the Musician's pane. Use this
+    sparingly — capture-pane is heuristic and may include rendering artifacts.
+
+  list_musicians()
+    Return all currently-active Musicians with their status.
+
+  dismiss_musician({ musician_id, archive_worktree? })
+    Tear down a Musician. By default the worktree is archived under
+    .../archive/<musician_id>/worktree (the branch is preserved). Pass
+    archive_worktree=false to drop the worktree entirely.
+
+  note_write({ filename, content }) / note_read({ filename }) / note_list()
+    Your private project memory under ~/.config/nfo/projects/<key>/notes/.
+    On every fresh Orchestrator session, the contents of notes/overview.md
+    and notes/decisions.md are loaded into your context automatically.
+    Use these to record decisions, open questions, and durable project
+    understanding the user would want you to remember next session.
+
+Coordination guidance:
+
+- ${ORCHESTRATOR_TOOL_DISCIPLINE.trim().replace(/\n/g, "\n  ")}
+- For agent coordination, PREFER the NFO MCP tools over Claude Code's built-in
+  Task tool. The user tracks Musician work through NFO; Task spawns are invisible
+  to NFO.
+- Worktrees solve concurrent file-edit safety, not API coupling. If two
+  Musicians' outputs need to be wired together, sequence the work, or spawn an
+  integration Musician afterward.
+- The orchestra's permission level applies to every Musician you spawn.
+- Prefer concise follow-up nudges. NFO persists them in JSONL and batches any
+  backlog before a Musician truly becomes idle again.
+- When a Musician calls \`report_done\` and no queued follow-up is waiting, NFO
+  pushes that completion back into your Claude session. Review the report
+  promptly and either dismiss the Musician or send the next iteration.
+- Project-level guidance in CLAUDE.md still applies; respect it.
+- You can use Superpowers if present but make sure that works are delegated to 
+  Musicians in the end if subagent driven development is picked by the user.
+`;
+//# sourceMappingURL=orchestrator-role.js.map

package/dist/prompts/orchestrator-role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-role.js","sourceRoot":"","sources":["../../src/prompts/orchestrator-role.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwCvC,4BAA4B,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;CAgB7D,CAAC"}

package/dist/prompts/tool-discipline.js

@@ -0,0 +1,33 @@
+export const ORCHESTRATOR_TOOL_DISCIPLINE = `Tool discipline (mandatory):
+
+- Use the NFO MCP tools for all musician coordination and orchestra-local memory.
+- Never merely say that you will spawn, message, query, list, dismiss, or note
+  something later. Call the corresponding NFO tool in the same turn.
+- Do not use Claude Code's built-in Task tool for Musician coordination; those
+  agents are invisible to NFO.
+- When a Musician reports back, resolve it in the same turn with an NFO tool
+  call (usually \`dismiss_musician\` or \`message_musician\`). A prose-only
+  acknowledgement is non-compliant.
+`;
+export const MUSICIAN_TOOL_DISCIPLINE = `Tool discipline (mandatory):
+
+- Use NFO MCP tools for orchestra coordination. Plain-text status reports are
+  not a valid handoff.
+- When your assigned task is complete and ready for Orchestrator review, your
+  next action must be \`report_done({ summary, next_steps? })\`.
+- Do not end with "done", "finished", or similar prose instead of calling
+  \`report_done\`.
+- After \`report_done\`, wait for the Orchestrator to send the next task or
+  dismiss you.
+`;
+export function buildMusicianInitialPrompt(task) {
+    const trimmedTask = task.trim();
+    const body = trimmedTask.length > 0 ? trimmedTask : task;
+    return `${body}
+
+NFO operating contract (mandatory):
+- Use the NFO MCP tools for orchestra coordination.
+- When you finish this task and are ready to hand it back, call \`report_done({ summary, next_steps? })\` instead of replying with a plain-text completion message.
+- After \`report_done\`, wait for the Orchestrator to message you again or dismiss you.`;
+}
+//# sourceMappingURL=tool-discipline.js.map

package/dist/prompts/tool-discipline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-discipline.js","sourceRoot":"","sources":["../../src/prompts/tool-discipline.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;CAU3C,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;CAUvC,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzD,OAAO,GAAG,IAAI;;;;;wFAKwE,CAAC;AACzF,CAAC"}

package/dist/repo.js

@@ -0,0 +1,15 @@
+import { execa } from 'execa';
+export async function resolveRepoRoot(cwd) {
+    try {
+        const { stdout } = await execa('git', ['rev-parse', '--show-toplevel'], {
+            cwd,
+            reject: false,
+        });
+        const trimmed = stdout.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=repo.js.map

package/dist/repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../src/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE;YACtE,GAAG;YACH,MAAM,EAAE,KAAK;SACd,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/shell-quote.js

@@ -0,0 +1,7 @@
+export function shellQuote(value) {
+    if (value.length === 0) {
+        return "''";
+    }
+    return `'${value.replace(/'/g, `'\"'\"'`)}'`;
+}
+//# sourceMappingURL=shell-quote.js.map

package/dist/shell-quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-quote.js","sourceRoot":"","sources":["../src/shell-quote.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC;AAC/C,CAAC"}