cclaw-cli 7.7.1 → 8.1.0

package/dist/internal/slice-commit.js

@@ -1,619 +0,0 @@
-import { execFile } from "node:child_process";
-import path from "node:path";
-import { promisify } from "node:util";
-import { readConfig, resolveLockfileTwinPolicy, resolveTddCommitMode, resolveTddIsolationMode, resolveTddWorktreeRoot } from "../config.js";
-import { readDelegationLedger } from "../delegation.js";
-import { exists } from "../fs-utils.js";
-import { loadStackAdapter } from "../stack-detection.js";
-import { cleanupWorktree, commitAndMergeBack, createSliceWorktree, WorktreeMergeConflictError, WorktreeUnsupportedError } from "../worktree-manager.js";
-const execFileAsync = promisify(execFile);
-function parseCsv(raw) {
-    return raw
-        .split(",")
-        .map((value) => value.trim())
-        .filter((value) => value.length > 0);
-}
-function normalizePathLike(value) {
-    const slashes = value.replace(/\\/gu, "/");
-    const withoutDot = slashes.replace(/^\.\//u, "");
-    return withoutDot.replace(/\/+$/u, "");
-}
-function parseSliceCommitArgs(tokens) {
-    let sliceId = "";
-    let spanId = "";
-    let taskId;
-    let title;
-    let runId;
-    let worktreePath;
-    const claimedPaths = [];
-    let prepareWorktree = false;
-    let json = false;
-    let quiet = false;
-    for (let i = 0; i < tokens.length; i += 1) {
-        const token = tokens[i];
-        const next = tokens[i + 1];
-        const valueFrom = (flag) => {
-            if (token.startsWith(`${flag}=`))
-                return token.slice(flag.length + 1);
-            if (token === flag && next && !next.startsWith("--")) {
-                i += 1;
-                return next;
-            }
-            throw new Error(`${flag} requires a value.`);
-        };
-        if (token === "--json") {
-            json = true;
-            continue;
-        }
-        if (token === "--quiet") {
-            quiet = true;
-            continue;
-        }
-        if (token === "--prepare-worktree") {
-            prepareWorktree = true;
-            continue;
-        }
-        if (token.startsWith("--slice=") || token === "--slice") {
-            sliceId = valueFrom("--slice").trim();
-            continue;
-        }
-        if (token.startsWith("--span-id=") || token === "--span-id") {
-            spanId = valueFrom("--span-id").trim();
-            continue;
-        }
-        if (token.startsWith("--task-id=") || token === "--task-id") {
-            taskId = valueFrom("--task-id").trim();
-            continue;
-        }
-        if (token.startsWith("--title=") || token === "--title") {
-            title = valueFrom("--title").trim();
-            continue;
-        }
-        if (token.startsWith("--run-id=") || token === "--run-id") {
-            runId = valueFrom("--run-id").trim();
-            continue;
-        }
-        if (token.startsWith("--worktree-path=") || token === "--worktree-path") {
-            const resolved = valueFrom("--worktree-path").trim();
-            if (resolved.length > 0) {
-                worktreePath = resolved;
-            }
-            continue;
-        }
-        if (token.startsWith("--claimed-paths=") || token === "--claimed-paths") {
-            claimedPaths.push(...parseCsv(valueFrom("--claimed-paths")));
-            continue;
-        }
-        if (token.startsWith("--claimed-path=") || token === "--claimed-path") {
-            const one = valueFrom("--claimed-path").trim();
-            if (one.length > 0)
-                claimedPaths.push(one);
-            continue;
-        }
-        throw new Error(`Unknown flag for internal slice-commit: ${token}`);
-    }
-    if (sliceId.length === 0) {
-        throw new Error("internal slice-commit requires --slice=<S-N>.");
-    }
-    if (spanId.length === 0) {
-        throw new Error("internal slice-commit requires --span-id=<span-id>.");
-    }
-    return {
-        sliceId,
-        spanId,
-        taskId,
-        title,
-        runId,
-        worktreePath,
-        claimedPaths,
-        prepareWorktree,
-        json,
-        quiet
-    };
-}
-function output(io, args, payload, channel = "stdout") {
-    if (args.quiet && channel === "stdout")
-        return;
-    const writer = channel === "stdout" ? io.stdout : io.stderr;
-    if (args.json) {
-        writer.write(`${JSON.stringify(payload)}\n`);
-        return;
-    }
-    const message = typeof payload.message === "string"
-        ? payload.message
-        : JSON.stringify(payload);
-    writer.write(`${message}\n`);
-}
-function parsePorcelainPaths(raw) {
-    const out = [];
-    for (const line of raw.split(/\r?\n/gu)) {
-        const trimmed = line.trimEnd();
-        if (trimmed.length < 4)
-            continue;
-        // porcelain line shape: XY<space><path>
-        const status = trimmed.slice(0, 2);
-        if (status === "??") {
-            const p = normalizePathLike(trimmed.slice(3).trim());
-            if (p.length > 0)
-                out.push(p);
-            continue;
-        }
-        let p = trimmed.slice(3).trim();
-        const renameIdx = p.indexOf(" -> ");
-        if (renameIdx >= 0) {
-            p = p.slice(renameIdx + 4);
-        }
-        p = normalizePathLike(p.replace(/^"/u, "").replace(/"$/u, ""));
-        if (p.length > 0)
-            out.push(p);
-    }
-    return [...new Set(out)];
-}
-async function gitChangedPaths(cwd) {
-    const { stdout: statusRaw } = await execFileAsync("git", ["status", "--porcelain", "-uall"], {
-        cwd
-    });
-    return parsePorcelainPaths(statusRaw);
-}
-function matchesClaimedPath(changedPath, claimedPaths) {
-    const changed = normalizePathLike(changedPath);
-    return claimedPaths.some((rawClaimed) => {
-        const claimed = normalizePathLike(rawClaimed);
-        if (claimed.length === 0)
-            return false;
-        if (changed === claimed)
-            return true;
-        return changed.startsWith(`${claimed}/`);
-    });
-}
-/**
- * 7.6.0 — match a candidate path against a stack-adapter glob pattern.
- *
- * Adapter globs are intentionally simple: literal paths (`Cargo.toml`),
- * recursive prefix (`**\/Cargo.toml`), or single-level wildcard
- * (`*.csproj`). We translate those shapes here without pulling in a
- * full glob library so the slice-commit hook stays dependency-light.
- */
-function matchesAdapterGlob(candidate, glob) {
-    const normalizedCandidate = normalizePathLike(candidate);
-    const normalizedGlob = normalizePathLike(glob);
-    if (normalizedGlob.length === 0)
-        return false;
-    if (normalizedGlob.includes("**")) {
-        // `**/foo` → match either `foo` at root or any nested `foo`.
-        if (normalizedGlob.startsWith("**/")) {
-            const tail = normalizedGlob.slice(3);
-            if (tail === normalizedCandidate)
-                return true;
-            return normalizedCandidate.endsWith(`/${tail}`);
-        }
-        // Generic ** in the middle: collapse to suffix match for simplicity.
-        const tail = normalizedGlob.split("**/").pop() ?? "";
-        return tail.length > 0 && normalizedCandidate.endsWith(tail);
-    }
-    if (normalizedGlob.includes("*")) {
-        // Single-segment wildcard like `*.csproj`. Convert to a basic regex.
-        const regexSrc = normalizedGlob
-            .split("/")
-            .map((segment) => segment
-            .replace(/[.+?^${}()|[\]\\]/gu, "\\$&")
-            .replace(/\*/gu, "[^/]*"))
-            .join("/");
-        return new RegExp(`^${regexSrc}$`, "u").test(normalizedCandidate);
-    }
-    return normalizedGlob === normalizedCandidate;
-}
-/**
- * Find lockfile twins whose manifestGlob matches at least one claimed
- * path. The returned twins are the candidates whose lockfileGlob we
- * should auto-include / auto-revert when they drift.
- */
-function activeLockfileTwins(adapter, claimedPaths) {
-    if (adapter.lockfileTwins.length === 0)
-        return [];
-    const active = [];
-    for (const twin of adapter.lockfileTwins) {
-        const claimedManifest = claimedPaths.some((claimed) => matchesAdapterGlob(claimed, twin.manifestGlob));
-        if (claimedManifest)
-            active.push(twin);
-    }
-    return active;
-}
-/**
- * Partition a candidate path: `is it a lockfile twin we should
- * auto-handle?`. Returns the twin entry that matches, or null.
- */
-function findMatchingLockfileTwin(changedPath, twins) {
-    for (const twin of twins) {
-        if (matchesAdapterGlob(changedPath, twin.lockfileGlob)) {
-            return twin;
-        }
-    }
-    return null;
-}
-async function resolveClaimedPathsFromLedger(projectRoot, args) {
-    const ledger = await readDelegationLedger(projectRoot);
-    const matches = ledger.entries.filter((entry) => entry.stage === "tdd" &&
-        entry.agent === "slice-builder" &&
-        entry.sliceId === args.sliceId &&
-        entry.spanId === args.spanId &&
-        (!args.runId || entry.runId === args.runId) &&
-        Array.isArray(entry.claimedPaths) &&
-        entry.claimedPaths.length > 0);
-    matches.sort((a, b) => {
-        const aTs = a.ts ?? a.startTs ?? "";
-        const bTs = b.ts ?? b.startTs ?? "";
-        return aTs < bTs ? 1 : aTs > bTs ? -1 : 0;
-    });
-    const fromLedger = matches[0]?.claimedPaths ?? [];
-    return [...new Set(fromLedger.map((p) => normalizePathLike(p)).filter((p) => p.length > 0))];
-}
-export async function runSliceCommitCommand(projectRoot, tokens, io) {
-    let args;
-    try {
-        args = parseSliceCommitArgs(tokens);
-    }
-    catch (err) {
-        io.stderr.write(`cclaw internal slice-commit: ${err instanceof Error ? err.message : String(err)}\n`);
-        return 1;
-    }
-    const config = await readConfig(projectRoot).catch(() => null);
-    const commitMode = resolveTddCommitMode(config);
-    const isolationMode = resolveTddIsolationMode(config);
-    const worktreeRoot = resolveTddWorktreeRoot(config);
-    const lockfileTwinPolicy = resolveLockfileTwinPolicy(config);
-    const stackAdapter = await loadStackAdapter(projectRoot);
-    const gitPresent = await exists(path.join(projectRoot, ".git"));
-    if (args.prepareWorktree) {
-        if (!gitPresent) {
-            output(io, args, {
-                ok: true,
-                skipped: true,
-                reason: "no-git",
-                message: "slice-worktree skipped: .git is missing"
-            });
-            return 0;
-        }
-        if (isolationMode === "in-place") {
-            output(io, args, {
-                ok: true,
-                skipped: true,
-                reason: "isolation-in-place",
-                isolationMode,
-                message: "slice-worktree skipped: tdd.isolationMode=in-place"
-            });
-            return 0;
-        }
-        try {
-            const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], { cwd: projectRoot });
-            const prepared = await createSliceWorktree(args.sliceId, stdout.trim(), args.claimedPaths, {
-                projectRoot,
-                worktreeRoot
-            });
-            output(io, args, {
-                ok: true,
-                prepared: true,
-                sliceId: args.sliceId,
-                spanId: args.spanId,
-                worktreePath: prepared.path,
-                baseRef: prepared.ref
-            });
-            return 0;
-        }
-        catch (error) {
-            if (error instanceof WorktreeUnsupportedError) {
-                output(io, args, {
-                    ok: true,
-                    skipped: true,
-                    reason: "worktree-unavailable",
-                    degradedCommitMode: "agent-required",
-                    message: error.message
-                });
-                return 0;
-            }
-            output(io, args, {
-                ok: false,
-                errorCode: "worktree_prepare_failed",
-                details: {
-                    message: error instanceof Error ? error.message : String(error)
-                },
-                message: `worktree_prepare_failed: ${error instanceof Error ? error.message : String(error)}`
-            }, "stderr");
-            return 1;
-        }
-    }
-    if (commitMode !== "managed-per-slice") {
-        output(io, args, {
-            ok: true,
-            skipped: true,
-            reason: "commit-mode-not-managed",
-            commitMode,
-            message: `slice-commit skipped: commitMode=${commitMode}`
-        });
-        return 0;
-    }
-    if (!gitPresent) {
-        output(io, args, {
-            ok: true,
-            skipped: true,
-            reason: "no-git",
-            message: "slice-commit skipped: .git is missing"
-        });
-        return 0;
-    }
-    const claimedPaths = args.claimedPaths.length > 0
-        ? [...new Set(args.claimedPaths.map((p) => normalizePathLike(p)).filter((p) => p.length > 0))]
-        : await resolveClaimedPathsFromLedger(projectRoot, args);
-    if (claimedPaths.length === 0) {
-        output(io, args, {
-            ok: false,
-            errorCode: "slice_commit_claimed_paths_missing",
-            details: {
-                sliceId: args.sliceId,
-                spanId: args.spanId
-            },
-            message: `slice_commit_claimed_paths_missing: no claimed paths for ${args.sliceId}/${args.spanId}`
-        }, "stderr");
-        return 2;
-    }
-    let managedWorktreePath = null;
-    let activeCwd = projectRoot;
-    let degradedToInPlace = false;
-    const requestedWorktreePath = typeof args.worktreePath === "string" && args.worktreePath.trim().length > 0
-        ? path.resolve(projectRoot, args.worktreePath.trim())
-        : null;
-    if (requestedWorktreePath && await exists(requestedWorktreePath)) {
-        managedWorktreePath = requestedWorktreePath;
-        activeCwd = requestedWorktreePath;
-    }
-    else if (isolationMode !== "in-place") {
-        try {
-            const { stdout } = await execFileAsync("git", ["rev-parse", "HEAD"], { cwd: projectRoot });
-            const prepared = await createSliceWorktree(args.sliceId, stdout.trim(), claimedPaths, {
-                projectRoot,
-                worktreeRoot
-            });
-            managedWorktreePath = prepared.path;
-            activeCwd = prepared.path;
-        }
-        catch (error) {
-            if (error instanceof WorktreeUnsupportedError) {
-                output(io, args, {
-                    ok: true,
-                    skipped: true,
-                    reason: "worktree-unavailable",
-                    degradedCommitMode: "agent-required",
-                    message: error.message
-                });
-                return 0;
-            }
-            output(io, args, {
-                ok: false,
-                errorCode: "worktree_prepare_failed",
-                details: {
-                    message: error instanceof Error ? error.message : String(error)
-                },
-                message: `worktree_prepare_failed: ${error instanceof Error ? error.message : String(error)}`
-            }, "stderr");
-            return 1;
-        }
-    }
-    const cleanupManagedWorktree = async () => {
-        if (!managedWorktreePath)
-            return;
-        await cleanupWorktree(managedWorktreePath, { projectRoot }).catch(() => undefined);
-    };
-    let changedPaths = await gitChangedPaths(activeCwd);
-    if (changedPaths.length === 0 && managedWorktreePath && activeCwd !== projectRoot) {
-        const rootChangedPaths = await gitChangedPaths(projectRoot);
-        if (rootChangedPaths.length > 0) {
-            activeCwd = projectRoot;
-            changedPaths = rootChangedPaths;
-            degradedToInPlace = true;
-        }
-    }
-    if (changedPaths.length === 0) {
-        await cleanupManagedWorktree();
-        output(io, args, {
-            ok: true,
-            skipped: true,
-            reason: "no-changes",
-            message: `slice-commit skipped: no working-tree changes for ${args.sliceId}`
-        });
-        return 0;
-    }
-    const initialDrift = changedPaths.filter((p) => !matchesClaimedPath(p, claimedPaths));
-    const twinsForCommit = activeLockfileTwins(stackAdapter, claimedPaths);
-    // 7.6.0 — split drift into "lockfile twin drift" (handle per policy)
-    // vs "true drift" (always rejected).
-    const lockfileTwinDrift = [];
-    const trueDrift = [];
-    for (const driftPath of initialDrift) {
-        const twin = findMatchingLockfileTwin(driftPath, twinsForCommit);
-        if (twin) {
-            lockfileTwinDrift.push({ path: driftPath, twin });
-        }
-        else {
-            trueDrift.push(driftPath);
-        }
-    }
-    // Report a separate true-drift error when there is actual non-twin
-    // drift, regardless of policy: the operator's claim should still
-    // cover everything they changed.
-    if (trueDrift.length > 0) {
-        output(io, args, {
-            ok: false,
-            errorCode: "slice_commit_path_drift",
-            details: {
-                sliceId: args.sliceId,
-                spanId: args.spanId,
-                claimedPaths,
-                driftPaths: trueDrift
-            },
-            message: `slice_commit_path_drift: ${trueDrift.join(", ")}`
-        }, "stderr");
-        return 2;
-    }
-    // strict-fence: lockfile twins still count as drift.
-    if (lockfileTwinDrift.length > 0 && lockfileTwinPolicy === "strict-fence") {
-        const driftPaths = lockfileTwinDrift.map((entry) => entry.path);
-        output(io, args, {
-            ok: false,
-            errorCode: "slice_commit_path_drift",
-            details: {
-                sliceId: args.sliceId,
-                spanId: args.spanId,
-                claimedPaths,
-                driftPaths,
-                lockfileTwinPolicy,
-                stackAdapterId: stackAdapter.id
-            },
-            message: `slice_commit_path_drift: ${driftPaths.join(", ")} (lockfileTwinPolicy=strict-fence)`
-        }, "stderr");
-        return 2;
-    }
-    // auto-revert: restore the lockfile, then exclude from changed set.
-    const revertedTwinPaths = [];
-    if (lockfileTwinDrift.length > 0 && lockfileTwinPolicy === "auto-revert") {
-        for (const entry of lockfileTwinDrift) {
-            try {
-                await execFileAsync("git", ["restore", "--", entry.path], { cwd: activeCwd });
-                revertedTwinPaths.push(entry.path);
-            }
-            catch {
-                // Fall through; if restore fails the drift will reappear in the
-                // recomputed status and we'll reject as drift.
-            }
-        }
-        changedPaths = await gitChangedPaths(activeCwd);
-        const remainingDrift = changedPaths.filter((p) => !matchesClaimedPath(p, claimedPaths));
-        if (remainingDrift.length > 0) {
-            output(io, args, {
-                ok: false,
-                errorCode: "slice_commit_path_drift",
-                details: {
-                    sliceId: args.sliceId,
-                    spanId: args.spanId,
-                    claimedPaths,
-                    driftPaths: remainingDrift,
-                    lockfileTwinPolicy,
-                    stackAdapterId: stackAdapter.id
-                },
-                message: `slice_commit_path_drift: ${remainingDrift.join(", ")}`
-            }, "stderr");
-            return 2;
-        }
-    }
-    // auto-include: add the twin path(s) to the effective claim so the
-    // commit picks them up. We don't mutate the persisted claim — only
-    // the in-memory list used for the upcoming `git add`.
-    const effectiveCommitPaths = [...claimedPaths];
-    const includedTwinPaths = [];
-    if (lockfileTwinDrift.length > 0 && lockfileTwinPolicy === "auto-include") {
-        for (const entry of lockfileTwinDrift) {
-            if (!effectiveCommitPaths.includes(entry.path)) {
-                effectiveCommitPaths.push(entry.path);
-            }
-            includedTwinPaths.push(entry.path);
-        }
-    }
-    const changedInClaim = changedPaths.filter((p) => matchesClaimedPath(p, claimedPaths) ||
-        (lockfileTwinPolicy === "auto-include" &&
-            findMatchingLockfileTwin(p, twinsForCommit) !== null));
-    if (changedInClaim.length === 0) {
-        await cleanupManagedWorktree();
-        output(io, args, {
-            ok: true,
-            skipped: true,
-            reason: "claimed-paths-unchanged",
-            message: `slice-commit skipped: no changes within claimed paths for ${args.sliceId}`
-        });
-        return 0;
-    }
-    try {
-        await execFileAsync("git", ["add", "--", ...effectiveCommitPaths], {
-            cwd: activeCwd
-        });
-        const taskPart = args.taskId && args.taskId.length > 0 ? args.taskId : "task";
-        const titlePart = args.title && args.title.length > 0 ? args.title : "slice update";
-        const header = `${args.sliceId}/${taskPart}: ${titlePart}`;
-        const body = [
-            `span-id: ${args.spanId}`,
-            `run-id: ${args.runId ?? "unknown"}`,
-            "phase-cycle: red->green->refactor->doc"
-        ].join("\n");
-        await execFileAsync("git", ["commit", "-m", header, "-m", body], {
-            cwd: activeCwd
-        });
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        if (/nothing to commit/iu.test(message)) {
-            await cleanupManagedWorktree();
-            output(io, args, {
-                ok: true,
-                skipped: true,
-                reason: "nothing-to-commit",
-                message: `slice-commit skipped: nothing to commit for ${args.sliceId}`
-            });
-            return 0;
-        }
-        output(io, args, {
-            ok: false,
-            errorCode: "slice_commit_failed",
-            details: { message },
-            message: `slice_commit_failed: ${message}`
-        }, "stderr");
-        return 1;
-    }
-    const { stdout: shaStdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
-        cwd: activeCwd
-    });
-    let commitSha = shaStdout.trim();
-    if (managedWorktreePath && activeCwd !== projectRoot) {
-        try {
-            const merged = await commitAndMergeBack(activeCwd, `merge ${args.sliceId}`, { projectRoot });
-            commitSha = merged.commitSha;
-        }
-        catch (error) {
-            if (error instanceof WorktreeMergeConflictError) {
-                output(io, args, {
-                    ok: false,
-                    errorCode: "worktree_merge_conflict",
-                    details: {
-                        sliceId: args.sliceId,
-                        spanId: args.spanId,
-                        worktreePath: activeCwd,
-                        message: error.message
-                    },
-                    message: error.message
-                }, "stderr");
-                return 2;
-            }
-            output(io, args, {
-                ok: false,
-                errorCode: "slice_commit_failed",
-                details: { message: error instanceof Error ? error.message : String(error) },
-                message: `slice_commit_failed: ${error instanceof Error ? error.message : String(error)}`
-            }, "stderr");
-            return 1;
-        }
-    }
-    await cleanupManagedWorktree();
-    output(io, args, {
-        ok: true,
-        commitSha,
-        sliceId: args.sliceId,
-        spanId: args.spanId,
-        claimedPaths,
-        changedPaths: changedInClaim,
-        worktreePath: managedWorktreePath ?? undefined,
-        degradedToInPlace: degradedToInPlace || undefined,
-        lockfileTwinPolicy,
-        lockfileTwinsIncluded: includedTwinPaths.length > 0 ? includedTwinPaths : undefined,
-        lockfileTwinsReverted: revertedTwinPaths.length > 0 ? revertedTwinPaths : undefined,
-        stackAdapterId: stackAdapter.id,
-        message: `slice commit created for ${args.sliceId}: ${commitSha}`
-    });
-    return 0;
-}

package/dist/internal/tdd-loop-status.d.ts

@@ -1,14 +0,0 @@
-import type { Writable } from "node:stream";
-import { type RalphLoopStatus } from "../tdd-cycle.js";
-interface InternalIo {
-    stdout: Writable;
-    stderr: Writable;
-}
-/**
- * Produces a one-line "Ralph Loop: iter=X, slices=Y, acClosed=Z, redOpen=..."
- * summary — suitable for bootstrap surfaces where the user
- * just needs a progress indicator, not the full slice breakdown.
- */
-export declare function formatRalphLoopStatusLine(status: RalphLoopStatus): string;
-export declare function runTddLoopStatusCommand(projectRoot: string, argv: string[], io: InternalIo): Promise<number>;
-export {};

package/dist/internal/tdd-loop-status.js

@@ -1,68 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { RUNTIME_ROOT } from "../constants.js";
-import { writeFileSafe } from "../fs-utils.js";
-import { readFlowState } from "../runs.js";
-import { computeRalphLoopStatus, parseTddCycleLog } from "../tdd-cycle.js";
-function parseArgs(tokens) {
-    const args = { json: false, quiet: false, write: true };
-    for (const token of tokens) {
-        if (token === "--json")
-            args.json = true;
-        else if (token === "--quiet")
-            args.quiet = true;
-        else if (token === "--no-write")
-            args.write = false;
-        else if (token === "--write")
-            args.write = true;
-        else
-            throw new Error(`Unknown tdd-loop-status flag: ${token}`);
-    }
-    return args;
-}
-function stateDir(projectRoot) {
-    return path.join(projectRoot, RUNTIME_ROOT, "state");
-}
-async function readCycleLog(projectRoot) {
-    const filePath = path.join(stateDir(projectRoot), "tdd-cycle-log.jsonl");
-    try {
-        return await fs.readFile(filePath, "utf8");
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return "";
-        throw err;
-    }
-}
-/**
- * Produces a one-line "Ralph Loop: iter=X, slices=Y, acClosed=Z, redOpen=..."
- * summary — suitable for bootstrap surfaces where the user
- * just needs a progress indicator, not the full slice breakdown.
- */
-export function formatRalphLoopStatusLine(status) {
-    const redOpen = status.redOpenSlices.length > 0
-        ? status.redOpenSlices.join(",")
-        : "none";
-    return `Ralph Loop: iter=${status.loopIteration}, slices=${status.sliceCount}, acClosed=${status.acClosed.length}, redOpen=${redOpen}`;
-}
-export async function runTddLoopStatusCommand(projectRoot, argv, io) {
-    const args = parseArgs(argv);
-    const flow = await readFlowState(projectRoot).catch(() => null);
-    const runId = flow?.activeRunId ?? "active";
-    const text = await readCycleLog(projectRoot);
-    const entries = parseTddCycleLog(text);
-    const status = computeRalphLoopStatus(entries, { runId });
-    if (args.write) {
-        const target = path.join(stateDir(projectRoot), "ralph-loop.json");
-        await writeFileSafe(target, `${JSON.stringify(status, null, 2)}\n`);
-    }
-    if (!args.quiet) {
-        if (args.json) {
-            io.stdout.write(`${JSON.stringify(status, null, 2)}\n`);
-        }
-        else {
-            io.stdout.write(`${formatRalphLoopStatusLine(status)}\n`);
-        }
-    }
-    return 0;
-}