agentflight 0.5.1 → 0.7.0

package/dist/commands/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/commands/handoff.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA2DD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAgC/B"}

package/dist/commands/handoff.js

@@ -0,0 +1,286 @@
+import { pathExists, writeTextFileSafe } from "../core/fs-safe.js";
+import { compactCommandInText, formatVerificationCountLine } from "../core/output.js";
+import { formatRepoRelativePath, resolveAgentFlightPaths } from "../core/paths.js";
+import { runReplayCommand } from "./replay.js";
+import { runReportCommand } from "./report.js";
+import { runResumeCommand } from "./resume.js";
+import { runStatusCommand } from "./status.js";
+export async function runHandoffCommand(options) {
+    const status = await readHandoffStatus(options);
+    const paths = resolveAgentFlightPaths(options.repoRoot);
+    const artifactPaths = buildHandoffArtifactPaths(paths, status.sessionId);
+    const preserveExistingArtifacts = await shouldPreserveExistingArtifacts(status, artifactPaths);
+    const artifacts = preserveExistingArtifacts
+        ? artifactPaths
+        : await generateReviewArtifacts(options, artifactPaths);
+    const output = renderHandoff({
+        status,
+        handoffPath: formatRepoRelativePath(options.repoRoot, artifacts.sessionHandoffPath),
+        currentHandoffPath: formatRepoRelativePath(options.repoRoot, artifacts.handoffPath),
+        reportPath: formatRepoRelativePath(options.repoRoot, artifacts.reportPath),
+        replayPath: formatRepoRelativePath(options.repoRoot, artifacts.replayPath),
+        resumePath: formatRepoRelativePath(options.repoRoot, artifacts.sessionResumePath),
+        currentResumePath: formatRepoRelativePath(options.repoRoot, artifacts.resumePath)
+    });
+    await writeTextFileSafe(artifactPaths.handoffPath, output, { overwrite: true });
+    if (!preserveExistingArtifacts) {
+        await writeTextFileSafe(artifactPaths.sessionHandoffPath, output, { overwrite: true });
+    }
+    return {
+        output,
+        exitCode: exitsSuccessfully(status.review.readiness) ? 0 : 1,
+        handoffPath: artifactPaths.handoffPath,
+        sessionHandoffPath: artifactPaths.sessionHandoffPath,
+        reportPath: artifacts.reportPath,
+        replayPath: artifacts.replayPath,
+        resumePath: artifacts.resumePath,
+        sessionResumePath: artifacts.sessionResumePath
+    };
+}
+function buildHandoffArtifactPaths(paths, sessionId) {
+    return {
+        handoffPath: paths.currentHandoff,
+        sessionHandoffPath: `${paths.reports}/${sessionId}-handoff.md`,
+        reportPath: `${paths.reports}/${sessionId}-proof.md`,
+        replayPath: `${paths.reports}/${sessionId}-replay.html`,
+        resumePath: paths.currentResumePrompt,
+        sessionResumePath: `${paths.reports}/${sessionId}-resume.md`
+    };
+}
+async function shouldPreserveExistingArtifacts(status, paths) {
+    if (status.review.readiness.state !== "clean_worktree")
+        return false;
+    const checks = await Promise.all([
+        pathExists(paths.sessionHandoffPath),
+        pathExists(paths.reportPath),
+        pathExists(paths.replayPath),
+        pathExists(paths.resumePath),
+        pathExists(paths.sessionResumePath)
+    ]);
+    return checks.every(Boolean);
+}
+async function generateReviewArtifacts(options, artifactPaths) {
+    const report = await runReportCommand({
+        repoRoot: options.repoRoot,
+        changedFiles: options.changedFiles,
+        now: options.now
+    });
+    const replay = await runReplayCommand({
+        repoRoot: options.repoRoot,
+        changedFiles: options.changedFiles,
+        now: options.now
+    });
+    const resume = await runResumeCommand({
+        repoRoot: options.repoRoot,
+        changedFiles: options.changedFiles,
+        now: options.now
+    });
+    return {
+        handoffPath: artifactPaths.handoffPath,
+        sessionHandoffPath: artifactPaths.sessionHandoffPath,
+        reportPath: report.reportPath,
+        replayPath: replay.replayPath,
+        resumePath: resume.resumePath,
+        sessionResumePath: resume.sessionResumePath
+    };
+}
+async function readHandoffStatus(options) {
+    const status = await runStatusCommand({
+        repoRoot: options.repoRoot,
+        changedFiles: options.changedFiles,
+        now: options.now,
+        format: "json"
+    });
+    return parseHandoffStatus(JSON.parse(status.output));
+}
+function renderHandoff(input) {
+    const readiness = input.status.review.readiness;
+    const ready = isReadyForSharing(readiness);
+    const needsFix = needsFixBeforeSharing(readiness);
+    return `AgentFlight handoff
+
+Task:
+${input.status.taskTitle}
+
+Session:
+${input.status.sessionId}
+
+Changed files: ${input.status.changedFileCount}
+Risk: ${input.status.riskLevel}
+
+Readiness: ${readiness.label}
+Reason: ${formatReadinessReason(readiness, input.status.reason)}
+
+Verification:
+${formatVerificationCountLine(input.status.verification)}
+${formatVerificationDetails(input.status.verification.runs, hasUnresolvedFailedVerification(input.status.review.proofGaps))}
+
+Review first:
+${formatReviewFocus(input.status.review.focus.slice(0, 3))}
+
+Proof gaps:
+${formatProofGaps(input.status.review.proofGaps)}
+
+${needsFix ? "Fix before sharing" : "Next action"}:
+${formatNextAction(readiness, input.status.nextAction)}
+
+Open first: ${formatOpenFirstArtifact(ready, input.handoffPath, input.reportPath)}
+
+Artifacts:
+- Handoff: ${input.handoffPath}
+- Current handoff: ${input.currentHandoffPath}
+- Report: ${input.reportPath}
+- Replay: ${input.replayPath}
+- Resume: ${input.resumePath}
+- Current resume: ${input.currentResumePath}
+
+Local only: no upload, no telemetry, no automatic PR comment.
+`;
+}
+function isReadyForSharing(readiness) {
+    return readiness.state === "ready_for_review";
+}
+function exitsSuccessfully(readiness) {
+    return readiness.state === "ready_for_review" || readiness.state === "clean_worktree";
+}
+function formatOpenFirstArtifact(ready, handoffPath, reportPath) {
+    return ready ? `handoff ${handoffPath}` : `report ${reportPath}`;
+}
+function needsFixBeforeSharing(readiness) {
+    return (readiness.state === "blocked_by_failed_verification" ||
+        readiness.state === "needs_verification" ||
+        readiness.state === "not_ready_for_review");
+}
+function hasUnresolvedFailedVerification(gaps) {
+    return gaps.some((gap) => gap.id === "failed-verification");
+}
+function formatReadinessReason(readiness, fallback) {
+    if (readiness.state === "blocked_by_failed_verification") {
+        return "A verification command failed and must be fixed or rerun successfully.";
+    }
+    return compactCommandInText(readiness.reason || fallback, readiness.suggestedCommand);
+}
+function formatNextAction(readiness, fallback) {
+    if (readiness.state === "blocked_by_failed_verification") {
+        return "Fix the failed command, rerun verification, then regenerate this handoff.";
+    }
+    if (readiness.state === "ready_for_review") {
+        return "Share the local handoff packet for scoped review; use report/replay for details.";
+    }
+    return compactCommandInText(readiness.nextAction || fallback, readiness.suggestedCommand);
+}
+function formatVerificationDetails(runs, showFailedExcerpts) {
+    if (runs.length === 0)
+        return "- No verification runs recorded.";
+    const failedExcerpts = runs
+        .filter((run) => run.status === "failed" && run.outputExcerpt)
+        .map((run) => run.outputExcerpt.trim())
+        .filter(Boolean);
+    if (!showFailedExcerpts && failedExcerpts.length > 0) {
+        return "- Historical failed verification excerpts remain in report/replay; no unresolved failed verification remains.";
+    }
+    if (failedExcerpts.length === 0)
+        return "- No failed verification excerpts recorded.";
+    return failedExcerpts
+        .map((excerpt, index) => `Failed verification excerpt${failedExcerpts.length > 1 ? ` ${index + 1}` : ""}:
+${excerpt}`)
+        .join("\n\n");
+}
+function formatReviewFocus(items) {
+    if (items.length === 0)
+        return "- No changed files to review.";
+    return items
+        .map((item) => `${item.rank}. ${item.file}\n   Why: ${item.reasons.join("; ")}\n   Focus: ${item.suggestedReviewerFocus}`)
+        .join("\n");
+}
+function formatProofGaps(gaps) {
+    if (gaps.length === 0)
+        return "- none";
+    return gaps.map(formatProofGap).join("\n");
+}
+function formatProofGap(gap) {
+    if (gap.id === "failed-verification") {
+        return `- ${gap.severity}: A verification command failed and must be fixed or rerun successfully.`;
+    }
+    const message = compactCommandInText(gap.message, gap.suggestedCommand);
+    return `- ${gap.severity}: ${message}`;
+}
+function parseHandoffStatus(payload) {
+    const task = readObject(payload.task);
+    const session = readObject(payload.session);
+    const risk = readObject(payload.risk);
+    const verification = readObject(payload.verification);
+    const review = readObject(payload.review);
+    const readiness = parseReadiness(readObject(review.readiness));
+    return {
+        taskTitle: readString(task.title, "Untitled task"),
+        sessionId: readString(session.id, "unknown"),
+        riskLevel: readString(risk.level, "unknown"),
+        changedFileCount: readNumber(payload.changedFileCount, 0),
+        verification: {
+            passed: readNumber(verification.passed, 0),
+            failed: readNumber(verification.failed, 0),
+            unresolvedFailed: readNumber(verification.unresolvedFailed, readNumber(verification.failed, 0)),
+            resolvedFailed: readNumber(verification.resolvedFailed, 0),
+            runs: readArray(verification.runs).map(parseVerificationRun)
+        },
+        review: {
+            focus: readArray(review.focus).map(parseFocusItem),
+            proofGaps: readArray(review.proofGaps).map(parseProofGap),
+            readiness
+        },
+        reason: readString(payload.reason, readiness.reason),
+        nextAction: readString(payload.nextAction, readiness.nextAction)
+    };
+}
+function parseReadiness(value) {
+    return {
+        state: readString(value.state, "unknown"),
+        label: readString(value.label, "Unknown"),
+        reason: readString(value.reason, "No readiness reason recorded."),
+        nextAction: readString(value.nextAction, "Review the generated AgentFlight artifacts."),
+        ...(typeof value.suggestedCommand === "string"
+            ? { suggestedCommand: value.suggestedCommand }
+            : {})
+    };
+}
+function parseVerificationRun(value) {
+    const run = readObject(value);
+    return {
+        status: readString(run.status, "unknown"),
+        ...(typeof run.outputExcerpt === "string" ? { outputExcerpt: run.outputExcerpt } : {})
+    };
+}
+function parseFocusItem(value) {
+    const item = readObject(value);
+    return {
+        rank: readNumber(item.rank, 0),
+        file: readString(item.file, "unknown"),
+        reasons: readArray(item.reasons).map((reason) => readString(reason, "unknown")),
+        suggestedReviewerFocus: readString(item.suggestedReviewerFocus, "Inspect manually.")
+    };
+}
+function parseProofGap(value) {
+    const gap = readObject(value);
+    return {
+        id: readString(gap.id, "proof-gap"),
+        severity: readString(gap.severity, "info"),
+        message: readString(gap.message, "Proof gap recorded."),
+        ...(typeof gap.suggestedCommand === "string" ? { suggestedCommand: gap.suggestedCommand } : {})
+    };
+}
+function readObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : {};
+}
+function readArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function readString(value, fallback) {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+function readNumber(value, fallback) {
+    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+//# sourceMappingURL=handoff.js.map

package/dist/commands/handoff.js.map

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

package/dist/commands/history.d.ts

@@ -0,0 +1,11 @@
+export interface HistoryCommandOptions {
+    repoRoot: string;
+    limit?: number | undefined;
+    task?: string | undefined;
+    state?: string | undefined;
+}
+export interface HistoryCommandResult {
+    output: string;
+}
+export declare function runHistoryCommand(options: HistoryCommandOptions): Promise<HistoryCommandResult>;
+//# sourceMappingURL=history.d.ts.map

package/dist/commands/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/commands/history.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAc/B"}

package/dist/commands/history.js

@@ -0,0 +1,251 @@
+import { chooseOpenFirstArtifact, readReviewArtifacts } from "../core/artifacts.js";
+import { formatVerificationCountLine } from "../core/output.js";
+import { formatRepoRelativePath } from "../core/paths.js";
+import { listSessionSummaries } from "../core/session.js";
+import { readCurrentSession } from "./status.js";
+export async function runHistoryCommand(options) {
+    const limit = normalizeLimit(options.limit);
+    const filters = normalizeHistoryFilters(options);
+    const history = await listSessionSummaries(options.repoRoot);
+    const currentSessionId = await readCurrentSessionId(options.repoRoot);
+    const sessions = applyHistoryFilters(history.sessions, filters, currentSessionId).slice(0, limit);
+    return {
+        output: `AgentFlight history
+
+${await formatSessions(options.repoRoot, sessions, currentSessionId, filters)}
+${formatSkipped(options.repoRoot, history.skipped)}
+`
+    };
+}
+function normalizeLimit(limit) {
+    if (limit === undefined)
+        return 10;
+    if (!Number.isInteger(limit) || limit < 1) {
+        throw new Error("History limit must be a positive integer.");
+    }
+    return limit;
+}
+const historyStateFilterLabels = [
+    "ready",
+    "blocked",
+    "needs_verification",
+    "unknown",
+    "current"
+];
+const historyStateAliases = new Map([
+    ["ready", "ready"],
+    ["ready_for_review", "ready"],
+    ["blocked", "blocked"],
+    ["blocked_by_failed_verification", "blocked"],
+    ["failed", "blocked"],
+    ["not_ready", "blocked"],
+    ["not_ready_for_review", "blocked"],
+    ["needs", "needs_verification"],
+    ["needs-verification", "needs_verification"],
+    ["needs_verification", "needs_verification"],
+    ["unknown", "unknown"],
+    ["current", "current"]
+]);
+function normalizeHistoryFilters(options) {
+    const rawTask = normalizeOptionalText(options.task);
+    const rawState = normalizeOptionalText(options.state);
+    return {
+        task: rawTask ? rawTask.toLocaleLowerCase() : null,
+        state: rawState ? normalizeHistoryState(rawState) : null,
+        rawTask,
+        rawState
+    };
+}
+function normalizeOptionalText(value) {
+    if (value === undefined)
+        return null;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeHistoryState(value) {
+    const normalized = value
+        .trim()
+        .toLocaleLowerCase()
+        .replace(/[\s-]+/g, "_");
+    const state = historyStateAliases.get(normalized);
+    if (state)
+        return state;
+    throw new Error(`History state filter must be one of: ${historyStateFilterLabels.join(", ")}.`);
+}
+async function readCurrentSessionId(repoRoot) {
+    try {
+        return (await readCurrentSession(repoRoot)).id;
+    }
+    catch {
+        return null;
+    }
+}
+async function formatSessions(repoRoot, sessions, currentSessionId, filters) {
+    if (sessions.length === 0) {
+        return hasHistoryFilters(filters) ? formatEmptyFilteredHistory(filters) : formatEmptyHistory();
+    }
+    const latestSession = sessions[0];
+    if (!latestSession) {
+        return formatEmptyHistory();
+    }
+    const latestAction = await formatLatestAction(repoRoot, latestSession, latestSession.id === currentSessionId, await findPreviousOpenFirstArtifact(repoRoot, sessions.slice(1)));
+    const lines = await Promise.all(sessions.map(async (session) => formatSession(repoRoot, session, session.id === currentSessionId)));
+    return `${formatFilters(filters)}${latestAction}
+
+Recent sessions:
+${lines.join("\n")}`;
+}
+function formatEmptyHistory() {
+    return `No AgentFlight sessions recorded yet.
+
+Next action:
+Run agentflight start --task "Describe the task" to begin a local session.`;
+}
+function formatEmptyFilteredHistory(filters) {
+    return `No AgentFlight sessions matched the history filters.
+
+${formatFilters(filters)}Next action:
+Run agentflight history without filters to list recent local sessions.`;
+}
+async function formatLatestAction(repoRoot, session, isCurrent, previousOpenFirst) {
+    const artifacts = await readReviewArtifacts(repoRoot, session.id);
+    const openFirst = chooseOpenFirstArtifact(session.latestReview?.state, artifacts);
+    const nextAction = isCurrent && openFirst === "none yet" ? formatMissingArtifactNextAction(session) : "";
+    const previousArtifact = isCurrent && openFirst === "none yet" && previousOpenFirst
+        ? `\nPrevious artifact: ${previousOpenFirst}`
+        : "";
+    return `Latest action:
+Open first: ${openFirst}${nextAction}${previousArtifact}
+Recorded readiness: ${formatReadiness(session)}
+Task: ${session.taskTitle}`;
+}
+function formatMissingArtifactNextAction(session) {
+    return hasVerificationEvidence(session)
+        ? "\nNext: run agentflight handoff"
+        : "\nNext: run agentflight verify, then agentflight handoff";
+}
+async function formatSession(repoRoot, session, isCurrent) {
+    const marker = isCurrent ? " [current]" : "";
+    const branch = session.branch ?? "unknown";
+    const artifacts = await readReviewArtifacts(repoRoot, session.id);
+    const header = `- ${formatStartedAt(session.startedAt)}${marker} ${session.taskTitle}
+  ID: ${session.id}
+  Branch: ${branch}${session.dirty ? " (dirty at start)" : ""}`;
+    if (isStartOnlySession(session, isCurrent, artifacts)) {
+        return `${header}
+  Start only: no verification or review artifacts recorded.`;
+    }
+    return `${header}
+  Verification: ${formatVerificationCountLine({
+        passed: session.verificationPassed,
+        failed: session.verificationFailed,
+        unresolvedFailed: session.verificationUnresolvedFailed,
+        resolvedFailed: session.verificationResolvedFailed
+    })}
+  Recorded readiness: ${formatReadiness(session)}
+  Open first: ${chooseOpenFirstArtifact(session.latestReview?.state, artifacts)}
+  Handoff: ${artifacts.handoff}
+  Report: ${artifacts.report}
+  Replay: ${artifacts.replay}
+  Resume: ${artifacts.resume}`;
+}
+function isStartOnlySession(session, isCurrent, artifacts) {
+    if (isCurrent)
+        return false;
+    if (session.latestReview)
+        return false;
+    if (hasVerificationEvidence(session))
+        return false;
+    return !hasReviewArtifact(artifacts);
+}
+function hasVerificationEvidence(session) {
+    const counts = [
+        session.verificationPassed,
+        session.verificationFailed,
+        session.verificationUnresolvedFailed,
+        session.verificationResolvedFailed
+    ];
+    return counts.some((count) => count > 0);
+}
+function hasReviewArtifact(artifacts) {
+    return Object.values(artifacts).some((artifact) => artifact !== "missing");
+}
+function applyHistoryFilters(sessions, filters, currentSessionId) {
+    return sessions
+        .filter((session) => matchesTaskFilter(session, filters.task))
+        .filter((session) => matchesStateFilter(session, filters.state, currentSessionId));
+}
+function matchesTaskFilter(session, taskFilter) {
+    if (!taskFilter)
+        return true;
+    return session.taskTitle.toLocaleLowerCase().includes(taskFilter);
+}
+function matchesStateFilter(session, stateFilter, currentSessionId) {
+    if (!stateFilter)
+        return true;
+    if (stateFilter === "current")
+        return session.id === currentSessionId;
+    if (stateFilter === "unknown")
+        return !session.latestReview || session.latestReview.state === "unknown";
+    if (!session.latestReview)
+        return false;
+    if (stateFilter === "ready")
+        return session.latestReview.state === "ready_for_review";
+    if (stateFilter === "blocked") {
+        return (session.latestReview.state === "blocked_by_failed_verification" ||
+            session.latestReview.state === "not_ready_for_review");
+    }
+    return session.latestReview.state === "needs_verification";
+}
+function hasHistoryFilters(filters) {
+    return Boolean(filters.rawTask || filters.rawState);
+}
+function formatFilters(filters) {
+    if (!hasHistoryFilters(filters))
+        return "";
+    const lines = ["Filters:"];
+    if (filters.rawTask)
+        lines.push(`- Task contains: ${filters.rawTask}`);
+    if (filters.rawState)
+        lines.push(`- State: ${filters.rawState}`);
+    return `${lines.join("\n")}\n\n`;
+}
+function formatReadiness(session) {
+    const review = session.latestReview;
+    if (!review)
+        return "not recorded";
+    return `${review.label} (risk ${review.riskLevel}, ${formatChangedFiles(review.changedFiles)})`;
+}
+async function findPreviousOpenFirstArtifact(repoRoot, sessions) {
+    for (const session of sessions) {
+        const artifacts = await readReviewArtifacts(repoRoot, session.id);
+        const openFirst = chooseOpenFirstArtifact(session.latestReview?.state, artifacts);
+        if (openFirst !== "none yet")
+            return openFirst;
+    }
+    return null;
+}
+function formatChangedFiles(count) {
+    return `${count} changed ${count === 1 ? "file" : "files"}`;
+}
+function formatStartedAt(startedAt) {
+    const date = new Date(startedAt);
+    if (Number.isNaN(date.getTime()))
+        return startedAt;
+    return date.toISOString().replace("T", " ").slice(0, 16);
+}
+function formatSkipped(repoRoot, skipped) {
+    if (skipped.length === 0)
+        return "";
+    const visiblePaths = skipped
+        .map((file) => formatRepoRelativePath(repoRoot, file.path))
+        .sort((left, right) => left.localeCompare(right))
+        .slice(0, 3);
+    const omitted = skipped.length - visiblePaths.length;
+    const omittedLine = omitted > 0
+        ? `\n... ${omitted} more malformed session ${omitted === 1 ? "file" : "files"} omitted.`
+        : "";
+    return `\nSkipped malformed sessions:
+${visiblePaths.map((path) => `- ${path}`).join("\n")}${omittedLine}`;
+}
+//# sourceMappingURL=history.js.map

package/dist/commands/history.js.map

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

package/dist/commands/init.d.ts

@@ -1,6 +1,11 @@
+import type { ToolAdapterResult } from "../types/index.js";
 export interface InitCommandOptions {
     repoRoot: string;
     now?: Date | undefined;
+    tools?: {
+        projscan: ToolAdapterResult;
+        agentloopkit: ToolAdapterResult;
+    } | undefined;
 }
 export interface InitCommandResult {
     output: string;

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyB5F"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,KAAK,CAAC,EACF;QACE,QAAQ,EAAE,iBAAiB,CAAC;QAC5B,YAAY,EAAE,iBAAiB,CAAC;KACjC,GACD,SAAS,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwC5F"}