tickmarkr 1.84.0 → 1.86.0

package/dist/tui/ink/studio-app.js

@@ -1,320 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { render, useApp, useInput } from "ink";
-import { useEffect, useRef, useState } from "react";
-import { allAdapters, doctorAgeMs, readDoctor } from "../../adapters/registry.js";
-import { fleetEditableFromConfig, loadConfig } from "../../config/config.js";
-import { loadGraph } from "../../graph/graph.js";
-import { Journal, readAllTelemetry, RUNS_WINDOW, } from "../../run/journal.js";
-import { buildSaveProposal, confirmSave } from "../save.js";
-import { FleetStaging } from "../staging.js";
-import { DiffConfirmationScreen, StudioScreen, } from "./components.js";
-const STATUS = {
-    "task-dispatch": "running", "task-done": "done", "task-failed": "failed",
-    "task-human": "human", "task-approved": "pending",
-};
-const HELP = [
-    "Key bindings",
-    "1-5      switch view",
-    "tab      cycle views",
-    "?        show this help",
-    "esc / q  quit",
-    "u        revert staged changes",
-    "s        save staged changes",
-];
-function loadFleetData(repoRoot) {
-    try {
-        const cfg = loadConfig(repoRoot);
-        const health = readDoctor(repoRoot);
-        if (!health)
-            return undefined;
-        const editable = fleetEditableFromConfig(cfg);
-        const adapters = allAdapters().flatMap((adapter) => {
-            if (!health[adapter.id]?.installed)
-                return [];
-            const models = adapter.channels(cfg).map((channel) => ({
-                model: channel.model,
-                tier: channel.tier,
-                channel: channel.channel,
-            }));
-            return models.length ? [{ adapter: adapter.id, models }] : [];
-        });
-        return {
-            adapters,
-            health,
-            doctorAgeMs: doctorAgeMs(repoRoot),
-            denyAdapters: editable.denyAdapters,
-            denyModels: editable.denyModels,
-            telemetry: readAllTelemetry(repoRoot, RUNS_WINDOW),
-        };
-    }
-    catch {
-        // Best-effort read surface: line-mode commands remain the diagnostic path when config is unavailable.
-        return undefined;
-    }
-}
-function emptyStaging() {
-    return new FleetStaging({
-        denyAdapters: [],
-        denyModels: [],
-        tiers: {},
-        map: {},
-        floors: {},
-    });
-}
-function loadStaging(repoRoot) {
-    try {
-        return new FleetStaging(fleetEditableFromConfig(loadConfig(repoRoot)));
-    }
-    catch {
-        return emptyStaging();
-    }
-}
-const componentView = (id, label, line) => ({ id, label, render: () => [line] });
-const createView = (id, label) => (..._) => componentView(id, label, `${label} view`);
-const createFleetView = createView("fleet", "Fleet"), createRoutingView = createView("routing", "Routing"), createPreviewView = createView("preview", "Preview"), createProfileView = createView("profile", "Profile"), createRunsView = createView("runs", "Runs");
-function defaultViews(repoRoot, staging) {
-    return [
-        createFleetView(loadFleetData(repoRoot), staging),
-        createRoutingView({ repoRoot, staging }),
-        createPreviewView({ cwd: repoRoot }),
-        createProfileView({ repoRoot }),
-        createRunsView(undefined, { repoRoot }),
-    ];
-}
-const emptyGraph = () => ({ version: 1, spec: { source: "prd", paths: [], hash: "" }, tasks: [] });
-function loadRunsData(repoRoot) {
-    const runId = Journal.latestRunId(repoRoot, { withJournal: true }) ?? undefined;
-    let graph = emptyGraph();
-    try {
-        graph = loadGraph(repoRoot);
-    }
-    catch { /* no graph loaded */ }
-    return { runId, events: runId ? Journal.open(repoRoot, runId).read() : [], graph };
-}
-export function foldConsultDossier(data, taskId) {
-    let prompt = 0;
-    const verdicts = data.events.flatMap((event) => {
-        if (event.taskId !== taskId || event.event !== "consult-verdict")
-            return [];
-        const action = event.data.action;
-        if (!["retry", "reroute", "decompose", "human"].includes(action))
-            return [];
-        return [{
-                action,
-                reason: typeof event.data.reason === "string" ? event.data.reason : undefined,
-                prompt: data.prompts?.[taskId]?.[prompt++],
-            }];
-    });
-    return { taskId, verdicts };
-}
-export function buildRunsCockpitTasks(data, nowMs) {
-    return data.graph.tasks.map((task) => {
-        const events = data.events.filter((event) => event.taskId === task.id);
-        const state = [...events].reverse().find((event) => STATUS[event.event]);
-        const status = STATUS[state?.event ?? ""] ?? task.status;
-        const phaseStart = [...events].reverse().find((event) => event.event === "phase-start");
-        const start = phaseStart ?? (state?.event === "task-dispatch" ? state : undefined);
-        const phase = typeof phaseStart?.data.phase === "string" ? phaseStart.data.phase : undefined;
-        const running = status === "running" && start !== undefined;
-        const elapsedMs = running ? Math.max(0, nowMs - Date.parse(start.ts)) : 0;
-        return {
-            id: task.id, status,
-            ...(running ? { phase: phase ?? "worker",
-                elapsed: `${Math.floor(elapsedMs / 1000)}s` } : {}),
-            consultCount: foldConsultDossier(data, task.id).verdicts.length,
-        };
-    });
-}
-function dossierLines(data) {
-    if (!data)
-        return ["d opens consult dossier"];
-    if (!data.verdicts.length)
-        return [`no consult verdicts recorded for ${data.taskId}`];
-    return [`Consult dossier — ${data.taskId}`, "d back", ...data.verdicts.flatMap((verdict, index) => [
-            `❯ ${index + 1}. ${verdict.action}${verdict.reason ? ` — ${verdict.reason}` : ""}`,
-            `  prompt ${index + 1}`,
-            ...(verdict.prompt ?? "(prompt unavailable)").split("\n")
-                .map((line) => `  ${line.replace(/^#{1,6}\s+/, "")}`),
-        ])];
-}
-function runsLines(runId, tasks, cursor) {
-    if (!runId)
-        return ["Runs cockpit", "no run loaded"];
-    return [`Runs cockpit — ${runId}`, "d consult dossier", ...tasks.flatMap((task, index) => [
-            `${index === cursor ? "❯ " : "  "}${task.id} — ${task.status}`,
-            `  ${task.phase ? `${task.phase} · ${task.elapsed}` : "waiting"}${task.consultCount ? ` · ${task.consultCount} consult verdict` : ""}`,
-        ])];
-}
-export function StudioApp({ views: suppliedViews, repoRoot = process.cwd(), globalDir, staging: suppliedStaging, runsData: suppliedRunsData, clock = Date.now, columns = 80, rows = 24, }) {
-    const { exit } = useApp();
-    const stagingRef = useRef(undefined);
-    stagingRef.current ??= suppliedStaging ?? loadStaging(repoRoot);
-    const staging = stagingRef.current;
-    const viewsRef = useRef(undefined);
-    viewsRef.current ??= suppliedViews ?? defaultViews(repoRoot, staging);
-    const views = viewsRef.current;
-    const [active, setActive] = useState(0);
-    const [help, setHelp] = useState(false);
-    const [saveProposal, setSaveProposal] = useState(null);
-    const [notice, setNotice] = useState(null);
-    const [runsData, setRunsData] = useState(() => suppliedRunsData ?? loadRunsData(repoRoot));
-    const [nowMs, setNowMs] = useState(clock);
-    const [dossierOpen, setDossierOpen] = useState(false);
-    const [, repaint] = useState(0);
-    const nativeRuns = suppliedViews === undefined && views[active]?.id === "runs";
-    const runTasks = buildRunsCockpitTasks(runsData, nowMs);
-    const runsCursor = Math.max(0, runTasks.findIndex((task) => task.consultCount > 0));
-    const selectedRunTask = runTasks[runsCursor];
-    const dossier = selectedRunTask ? foldConsultDossier(runsData, selectedRunTask.id) : undefined;
-    useEffect(() => {
-        if (!nativeRuns)
-            return;
-        const timer = setInterval(() => {
-            setNowMs(clock());
-            if (!suppliedRunsData)
-                setRunsData(loadRunsData(repoRoot));
-        }, 250);
-        return () => clearInterval(timer);
-    }, [clock, nativeRuns, repoRoot, suppliedRunsData]);
-    useInput((input, key) => {
-        if (key.escape) {
-            if (help)
-                setHelp(false);
-            else if (saveProposal)
-                setSaveProposal(null);
-            else
-                exit();
-            return;
-        }
-        if (key.ctrl && input === "c") {
-            exit();
-            return;
-        }
-        if (saveProposal) {
-            if (input === "n") {
-                setSaveProposal(null);
-            }
-            else if (input === "t") {
-                const target = saveProposal.target === "repo" ? "global" : "repo";
-                setSaveProposal(buildSaveProposal({
-                    repoRoot,
-                    loaded: staging.loadedState,
-                    staged: staging.current,
-                    target,
-                    globalDir,
-                }));
-            }
-            else if (input === "y") {
-                const result = confirmSave({
-                    repoRoot,
-                    loaded: staging.loadedState,
-                    staged: staging.current,
-                    target: saveProposal.target,
-                    globalDir,
-                });
-                if (result.kind === "written") {
-                    const nextStaging = new FleetStaging(staging.current);
-                    stagingRef.current = nextStaging;
-                    if (!suppliedViews)
-                        viewsRef.current = defaultViews(repoRoot, nextStaging);
-                    setNotice(`wrote ${result.path}`);
-                }
-                else if (result.kind === "refused") {
-                    setNotice(`save refused: ${result.reason}`);
-                }
-                setSaveProposal(null);
-            }
-            return;
-        }
-        if (input === "q") {
-            if (!help)
-                exit();
-            return;
-        }
-        if (input === "?") {
-            setHelp(true);
-            return;
-        }
-        if (help)
-            return;
-        if (nativeRuns && input === "d" && (dossierOpen || selectedRunTask)) {
-            setDossierOpen((open) => !open);
-            return;
-        }
-        if (input === "s") {
-            if (!staging.isDirty) {
-                setNotice("no staged changes");
-            }
-            else {
-                setNotice(null);
-                setSaveProposal(buildSaveProposal({
-                    repoRoot,
-                    loaded: staging.loadedState,
-                    staged: staging.current,
-                    target: "repo",
-                    globalDir,
-                }));
-            }
-            return;
-        }
-        if (input === "u") {
-            staging.revert();
-            setNotice(staging.isDirty ? null : "no staged changes");
-            repaint((revision) => revision + 1);
-            return;
-        }
-        if (key.tab) {
-            setActive((index) => (index + 1) % views.length);
-            setNotice(null);
-            setDossierOpen(false);
-            return;
-        }
-        if (/^[1-9]$/.test(input)) {
-            const index = Number(input) - 1;
-            if (index < views.length) {
-                setActive(index);
-                setNotice(null);
-                setDossierOpen(false);
-            }
-            return;
-        }
-        const name = key.upArrow ? "up" : key.downArrow ? "down" : null;
-        if (name) {
-            views[active]?.key?.(name);
-            repaint((revision) => revision + 1);
-        }
-    });
-    const view = views[active];
-    const lines = help
-        ? HELP
-        : nativeRuns
-            ? dossierOpen
-                ? dossierLines(dossier)
-                : runsLines(runsData.runId, runTasks, runsCursor)
-            : [
-                ...view.render({ cols: columns, rows: Math.max(rows - 2, 1) }),
-                ...(notice ? [notice] : []),
-            ];
-    const count = staging.changeCount;
-    const status = staging.isDirty
-        ? `● ${count} staged change${count === 1 ? "" : "s"}`
-        : "no staged changes";
-    return (_jsx(StudioScreen, { tabs: views.map((candidate) => candidate.label), active: active, lines: lines, status: status, children: saveProposal
-            ? (_jsx(DiffConfirmationScreen, { target: saveProposal.target, targetPath: saveProposal.targetPath, diff: saveProposal.diff, liveRun: saveProposal.liveRun }))
-            : undefined }));
-}
-export async function runStudioInk({ input, output, views, repoRoot, globalDir, staging, runsData, clock, debug = false, }) {
-    const app = render(_jsx(StudioApp, { views: views, repoRoot: repoRoot, globalDir: globalDir, staging: staging, runsData: runsData, clock: clock, columns: output.columns, rows: output.rows }), {
-        stdin: input,
-        stdout: output,
-        exitOnCtrlC: false,
-        patchConsole: false,
-        debug,
-    });
-    try {
-        await app.waitUntilExit();
-    }
-    finally {
-        app.unmount();
-    }
-}

package/dist/tui/save.d.ts

@@ -1,38 +0,0 @@
-import { type FleetEditable } from "../config/config.js";
-export type SaveTarget = "repo" | "global";
-/** Notice surfaced in the save modal whenever a run lock is live. */
-export declare const RELOAD_GUARD_NOTICE = "reload guard: a live run is active; the running daemon will not see these changes until it reloads";
-export type SaveProposal = {
-    target: SaveTarget;
-    targetPath: string;
-    before: string;
-    after: string;
-    diff: string;
-    liveRun: boolean;
-    loadError: string | null;
-};
-export type SaveResult = {
-    kind: "written";
-    path: string;
-} | {
-    kind: "declined";
-} | {
-    kind: "refused";
-    reason: string;
-};
-/** Build the diff-confirm payload for the current staging delta and chosen target. */
-export declare function buildSaveProposal(opts: {
-    repoRoot: string;
-    loaded: FleetEditable;
-    staged: FleetEditable;
-    target: SaveTarget;
-    globalDir?: string;
-}): SaveProposal;
-/** Confirm and execute the write for the chosen target. */
-export declare function confirmSave(opts: {
-    repoRoot: string;
-    loaded: FleetEditable;
-    staged: FleetEditable;
-    target: SaveTarget;
-    globalDir?: string;
-}): SaveResult;

package/dist/tui/save.js

@@ -1,96 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { existsSync, mkdtempSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { dirname, join } from "node:path";
-import { fleetEditableFromConfig, fleetEditableEquals, fleetRepoOverlayFromDelta, globalConfigDir, loadConfigWithMode, readOverlayFile, repoOverlayPath, repoOverlayYaml, unifiedYamlDiff, } from "../config/config.js";
-import { isRunLockLive } from "../run/lock.js";
-/** Notice surfaced in the save modal whenever a run lock is live. */
-export const RELOAD_GUARD_NOTICE = "reload guard: a live run is active; the running daemon will not see these changes until it reloads";
-function overlayPath(repoRoot, target, globalDir) {
-    return target === "repo"
-        ? repoOverlayPath(repoRoot)
-        : join(globalDir ?? globalConfigDir(), "config.yaml");
-}
-function currentOverlayText(path) {
-    return existsSync(path) ? readFileSync(path, "utf8") : "";
-}
-function computeAfterBytes(target, loaded, staged, repoRoot, globalDir) {
-    const path = overlayPath(repoRoot, target, globalDir);
-    const existing = readOverlayFile(path);
-    // Reuse the existing fleet serializer and diff renderer rather than inventing a parallel formatter.
-    const merged = fleetRepoOverlayFromDelta(loaded, staged, existing);
-    return repoOverlayYaml(merged);
-}
-function roundTripError(target, repoRoot, after, staged, globalDir) {
-    try {
-        let effective;
-        if (target === "repo") {
-            effective = loadConfigWithMode(repoRoot, { globalDir, repoOverlayText: after });
-        }
-        else {
-            // Validate a candidate global overlay by loading with it in a scratch globalDir.
-            const scratch = mkdtempSync(join(tmpdir(), "tickmarkr-global-rt-"));
-            try {
-                writeFileSync(join(scratch, "config.yaml"), after);
-                effective = loadConfigWithMode(repoRoot, { globalDir: scratch });
-            }
-            finally {
-                try {
-                    rmSync(scratch, { recursive: true, force: true });
-                }
-                catch { /* best-effort cleanup */ }
-            }
-        }
-        const reparsed = fleetEditableFromConfig(effective.cfg);
-        if (!fleetEditableEquals(reparsed, staged)) {
-            return "round-trip mismatch: the written overlay does not re-parse to the staged state";
-        }
-        return null;
-    }
-    catch (e) {
-        return e.message;
-    }
-}
-/** Build the diff-confirm payload for the current staging delta and chosen target. */
-export function buildSaveProposal(opts) {
-    const path = overlayPath(opts.repoRoot, opts.target, opts.globalDir);
-    const before = currentOverlayText(path);
-    const after = computeAfterBytes(opts.target, opts.loaded, opts.staged, opts.repoRoot, opts.globalDir);
-    const diff = unifiedYamlDiff(before, after, path);
-    const loadError = roundTripError(opts.target, opts.repoRoot, after, opts.staged, opts.globalDir);
-    return {
-        target: opts.target,
-        targetPath: path,
-        before,
-        after,
-        diff,
-        liveRun: isRunLockLive(opts.repoRoot),
-        loadError,
-    };
-}
-function atomicWrite(path, bytes) {
-    const dir = dirname(path);
-    mkdirSync(dir, { recursive: true });
-    // The sibling temp keeps rename(2) on one filesystem: readers see old or new bytes, never a partial overlay.
-    const tmp = join(dir, `.tickmarkr-save-${randomUUID()}.tmp`);
-    try {
-        writeFileSync(tmp, bytes);
-        renameSync(tmp, path);
-    }
-    catch (e) {
-        rmSync(tmp, { force: true }); // a failed rename must not leave a partial candidate behind
-        throw e;
-    }
-}
-/** Confirm and execute the write for the chosen target. */
-export function confirmSave(opts) {
-    const proposal = buildSaveProposal(opts);
-    if (proposal.loadError) {
-        return { kind: "refused", reason: proposal.loadError };
-    }
-    if (proposal.before === proposal.after) {
-        return { kind: "declined" };
-    }
-    atomicWrite(proposal.targetPath, proposal.after);
-    return { kind: "written", path: proposal.targetPath };
-}

package/dist/tui/staging.d.ts

@@ -1,29 +0,0 @@
-import { type FleetEditable } from "../config/config.js";
-/** One in-memory edit to the buffered fleet state. */
-export type FleetEdit = (buffer: FleetEditable) => void;
-/**
- * Staged-changes buffer for the Fleet Studio write path.
- *
- * - The loaded state is captured at construction and never mutated.
- * - Edits apply to an in-memory buffer only.
- * - `revert()` discards the buffer and restores the loaded state.
- * - The delta is computed through the existing `fleetEditableEquals` comparison.
- * - No code path in this module writes to disk.
- */
-export declare class FleetStaging {
-    private readonly loaded;
-    private buffer;
-    constructor(loaded: FleetEditable);
-    /** Read-only snapshot of the originally loaded state. */
-    get loadedState(): FleetEditable;
-    /** Current buffered (possibly edited) state. */
-    get current(): FleetEditable;
-    /** Apply an edit to the buffer. Never touches disk. */
-    apply(edit: FleetEdit): void;
-    /** Discard all buffered edits and restore the loaded state. */
-    revert(): void;
-    /** True when the buffer differs from the loaded state. */
-    get isDirty(): boolean;
-    /** Number of distinct staged changes vs the loaded state. */
-    get changeCount(): number;
-}

package/dist/tui/staging.js

@@ -1,78 +0,0 @@
-import { fleetEditableEquals } from "../config/config.js";
-/**
- * Staged-changes buffer for the Fleet Studio write path.
- *
- * - The loaded state is captured at construction and never mutated.
- * - Edits apply to an in-memory buffer only.
- * - `revert()` discards the buffer and restores the loaded state.
- * - The delta is computed through the existing `fleetEditableEquals` comparison.
- * - No code path in this module writes to disk.
- */
-export class FleetStaging {
-    loaded;
-    buffer;
-    constructor(loaded) {
-        this.loaded = structuredClone(loaded);
-        this.buffer = structuredClone(loaded);
-    }
-    /** Read-only snapshot of the originally loaded state. */
-    get loadedState() {
-        return structuredClone(this.loaded);
-    }
-    /** Current buffered (possibly edited) state. */
-    get current() {
-        return structuredClone(this.buffer);
-    }
-    /** Apply an edit to the buffer. Never touches disk. */
-    apply(edit) {
-        edit(this.buffer);
-    }
-    /** Discard all buffered edits and restore the loaded state. */
-    revert() {
-        this.buffer = structuredClone(this.loaded);
-    }
-    /** True when the buffer differs from the loaded state. */
-    get isDirty() {
-        return !fleetEditableEquals(this.loaded, this.buffer);
-    }
-    /** Number of distinct staged changes vs the loaded state. */
-    get changeCount() {
-        return fleetEditableDeltaCount(this.loaded, this.buffer);
-    }
-}
-/** Count changed leaves using the same equality semantics as `fleetEditableEquals`. */
-function fleetEditableDeltaCount(initial, edited) {
-    let count = 0;
-    if (JSON.stringify(initial.denyAdapters) !== JSON.stringify(edited.denyAdapters)) {
-        count += 1;
-    }
-    if (JSON.stringify(initial.denyModels) !== JSON.stringify(edited.denyModels)) {
-        count += 1;
-    }
-    const mapKeys = new Set([...Object.keys(initial.map), ...Object.keys(edited.map)]);
-    for (const shape of mapKeys) {
-        if (JSON.stringify(initial.map[shape]) !== JSON.stringify(edited.map[shape])) {
-            count += 1;
-        }
-    }
-    const floorKeys = new Set([...Object.keys(initial.floors), ...Object.keys(edited.floors)]);
-    for (const shape of floorKeys) {
-        if (initial.floors[shape] !== edited.floors[shape]) {
-            count += 1;
-        }
-    }
-    const adapterKeys = new Set([...Object.keys(initial.tiers), ...Object.keys(edited.tiers)]);
-    for (const adapter of adapterKeys) {
-        const modelKeys = new Set([
-            ...Object.keys(initial.tiers[adapter] ?? {}),
-            ...Object.keys(edited.tiers[adapter] ?? {}),
-        ]);
-        for (const model of modelKeys) {
-            if (JSON.stringify(initial.tiers[adapter]?.[model]) !==
-                JSON.stringify(edited.tiers[adapter]?.[model])) {
-                count += 1;
-            }
-        }
-    }
-    return count;
-}