voratiq 0.1.0-beta.21 → 0.1.0-beta.23

package/dist/utils/git.js

@@ -20,7 +20,7 @@ export async function assertGitRepository(root) {
         const repoRoot = await getGitRepositoryRoot(root);
         if (repoRoot !== null) {
             // We're in a repo but not at the root
-            throw new GitRepositoryError("Run `voratiq init` from the repository root.", "not_repository_root");
+            throw new GitRepositoryError("Run `voratiq` from the repository root.", "not_repository_root", repoRoot);
         }
         // No git repository exists at all
         throw new GitRepositoryError("No git repository found. Run `git init` or switch to an existing repository.", "no_repository");
@@ -80,8 +80,15 @@ export async function removeWorktree(options) {
         cwd: root,
     });
 }
-export async function gitAddAll(cwd) {
+export async function gitAddAll(cwd, excludedPaths) {
     await runGitCommand(["add", "-A"], { cwd });
+    const existingExcludedPaths = await resolveExistingGitPaths(cwd, excludedPaths);
+    if (existingExcludedPaths.length === 0) {
+        return;
+    }
+    await runGitCommand(["reset", "--quiet", "HEAD", "--", ...existingExcludedPaths], {
+        cwd,
+    });
 }
 export async function gitHasStagedChanges(cwd) {
     const output = await runGitCommand(["diff", "--cached", "--name-only"], {
@@ -146,3 +153,19 @@ function isHeadMissing(error) {
     const isHeadExitCode = code === 128 || code === "128";
     return headMissingMessage || (isHeadExitCode && normalized.includes("head"));
 }
+async function resolveExistingGitPaths(cwd, paths) {
+    if (!paths || paths.length === 0) {
+        return [];
+    }
+    const existing = [];
+    for (const path of paths) {
+        try {
+            await access(join(cwd, path), F_OK);
+            existing.push(path);
+        }
+        catch {
+            // Ignore missing excluded paths so git add works across repos and tests.
+        }
+    }
+    return existing;
+}

package/dist/utils/list-target.d.ts

@@ -0,0 +1,4 @@
+import type { ListJsonTargetRef } from "../contracts/list.js";
+export declare const TARGET_TABLE_PREVIEW_LENGTH = 32;
+export declare function formatTargetDisplay(target: ListJsonTargetRef): string;
+export declare function formatTargetTablePreview(target: ListJsonTargetRef, maxLength?: number): string;

package/dist/utils/list-target.js

@@ -0,0 +1,35 @@
+const TARGET_SEPARATOR = ":";
+const TARGET_ELISION = "...";
+export const TARGET_TABLE_PREVIEW_LENGTH = 32;
+export function formatTargetDisplay(target) {
+    if (target.kind === "file") {
+        return `file:${target.path}`;
+    }
+    if (target.agentId) {
+        return `${target.kind}:${target.sessionId}:${target.agentId}`;
+    }
+    return `${target.kind}:${target.sessionId}`;
+}
+export function formatTargetTablePreview(target, maxLength = TARGET_TABLE_PREVIEW_LENGTH) {
+    const display = formatTargetDisplay(target);
+    return middleElideTargetDisplay(display, maxLength);
+}
+function middleElideTargetDisplay(display, maxLength) {
+    if (display.length <= maxLength) {
+        return display;
+    }
+    if (maxLength <= TARGET_ELISION.length) {
+        return display.slice(0, maxLength);
+    }
+    const separatorIndex = display.indexOf(TARGET_SEPARATOR);
+    const prefixLength = separatorIndex >= 0 ? separatorIndex + 1 : 0;
+    const prefix = display.slice(0, prefixLength);
+    const suffixSource = display.slice(prefixLength);
+    const availableSuffixLength = maxLength - prefix.length - TARGET_ELISION.length;
+    if (availableSuffixLength <= 0) {
+        const prefixBudget = Math.max(0, maxLength - TARGET_ELISION.length);
+        return `${display.slice(0, prefixBudget)}${TARGET_ELISION}`;
+    }
+    const suffix = suffixSource.slice(-availableSuffixLength);
+    return `${prefix}${TARGET_ELISION}${suffix}`;
+}

package/dist/utils/swarm-session-ack.d.ts

@@ -0,0 +1,9 @@
+export declare const VORATIQ_MCP_ACK_PATH_ENV = "VORATIQ_MCP_ACK_PATH";
+export declare const VORATIQ_MCP_ACK_OPERATOR_ENV = "VORATIQ_MCP_ACK_OPERATOR";
+export type SwarmAckOperator = "spec" | "run" | "reduce" | "verify" | "message";
+export type SwarmAckStatus = "queued" | "running" | "succeeded" | "failed" | "unresolved";
+export declare function emitSwarmSessionAcknowledgement(options: {
+    operator: SwarmAckOperator;
+    sessionId: string;
+    status: SwarmAckStatus;
+}): Promise<void>;

package/dist/utils/swarm-session-ack.js

@@ -0,0 +1,17 @@
+import { rename, writeFile } from "node:fs/promises";
+export const VORATIQ_MCP_ACK_PATH_ENV = "VORATIQ_MCP_ACK_PATH";
+export const VORATIQ_MCP_ACK_OPERATOR_ENV = "VORATIQ_MCP_ACK_OPERATOR";
+export async function emitSwarmSessionAcknowledgement(options) {
+    const ackPath = process.env[VORATIQ_MCP_ACK_PATH_ENV];
+    const ackOperator = process.env[VORATIQ_MCP_ACK_OPERATOR_ENV];
+    if (!ackPath || ackOperator !== options.operator) {
+        return;
+    }
+    const tempPath = `${ackPath}.tmp`;
+    await writeFile(tempPath, JSON.stringify({
+        operator: options.operator,
+        sessionId: options.sessionId,
+        status: options.status,
+    }), "utf8");
+    await rename(tempPath, ackPath);
+}

package/dist/utils/terminal.d.ts

@@ -3,3 +3,4 @@ export interface InteractiveShellOptions {
     output?: NodeJS.WriteStream | null;
 }
 export declare function isInteractiveShell(options?: InteractiveShellOptions): boolean;
+export declare function normalizeInteractiveTerm(env: NodeJS.ProcessEnv, options?: InteractiveShellOptions): string | undefined;

package/dist/utils/terminal.js

@@ -1,5 +1,16 @@
+const FALLBACK_INTERACTIVE_TERM = "xterm-256color";
 export function isInteractiveShell(options = {}) {
     const input = options.input ?? process.stdin;
     const output = options.output ?? process.stdout;
     return Boolean(input?.isTTY && output?.isTTY);
 }
+export function normalizeInteractiveTerm(env, options = {}) {
+    if (!isInteractiveShell(options)) {
+        return env.TERM;
+    }
+    const term = env.TERM?.trim();
+    if (!term || term.toLowerCase() === "dumb") {
+        return FALLBACK_INTERACTIVE_TERM;
+    }
+    return env.TERM;
+}

package/dist/workspace/artifact-paths.d.ts

@@ -0,0 +1,55 @@
+import type { ChatArtifactFormat } from "./chat/types.js";
+export declare function getVerificationProgrammaticResultPath(sessionId: string): string;
+export declare function getVerificationRubricResultPath(options: {
+    sessionId: string;
+    verifierId: string;
+    template: string;
+}): string;
+export declare function getVerificationRubricExecutionDirectoryPath(options: {
+    sessionId: string;
+    verifierId: string;
+    template: string;
+}): string;
+export declare function getAgentSessionManifestPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionRuntimeDirectoryPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionStdoutPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionStderrPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionDiffPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionSummaryPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionChatArtifactPath(domain: string, sessionId: string, agentId: string, format: ChatArtifactFormat): string;
+export declare function getAgentSessionSandboxDirectoryPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionSandboxHomePath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentSessionSandboxSettingsPath(domain: string, sessionId: string, agentId: string): string;
+export declare function getAgentManifestPath(runId: string, agentId: string): string;
+export declare function getAgentRuntimeDirectoryPath(runId: string, agentId: string): string;
+export declare function getAgentWorkspaceDirectoryPath(runId: string, agentId: string): string;
+export declare function getAgentContextDirectoryPath(runId: string, agentId: string): string;
+export declare function getAgentArtifactsDirectoryPath(runId: string, agentId: string): string;
+export declare function getAgentStdoutPath(runId: string, agentId: string): string;
+export declare function getAgentStderrPath(runId: string, agentId: string): string;
+export declare function getAgentDiffPath(runId: string, agentId: string): string;
+export declare function getAgentSummaryPath(runId: string, agentId: string): string;
+export declare function getAgentChatArtifactPath(runId: string, agentId: string, format: ChatArtifactFormat): string;
+export interface AgentArtifactsSnapshot {
+    stdoutCaptured?: boolean;
+    stderrCaptured?: boolean;
+    diffCaptured?: boolean;
+    summaryCaptured?: boolean;
+    chatCaptured?: boolean;
+    chatFormat?: ChatArtifactFormat;
+}
+export interface AgentArtifactPaths {
+    stdoutPath?: string;
+    stderrPath?: string;
+    diffPath?: string;
+    summaryPath?: string;
+    chatPath?: string;
+}
+export declare function buildAgentArtifactPaths(options: {
+    runId: string;
+    agentId: string;
+    artifacts?: AgentArtifactsSnapshot | null;
+}): AgentArtifactPaths;
+export declare function getAgentSandboxDirectoryPath(runId: string, agentId: string): string;
+export declare function getAgentSandboxHomePath(runId: string, agentId: string): string;
+export declare function getAgentSandboxSettingsPath(runId: string, agentId: string): string;

package/dist/workspace/artifact-paths.js

@@ -0,0 +1,106 @@
+import { ARTIFACTS_DIRNAME, CHAT_JSON_FILENAME, CHAT_JSONL_FILENAME, DIFF_FILENAME, MANIFEST_FILENAME, PROGRAMMATIC_RESULT_FILENAME, RUNTIME_DIRNAME, SANDBOX_DIRNAME, SANDBOX_SETTINGS_FILENAME, STDERR_FILENAME, STDOUT_FILENAME, SUMMARY_FILENAME, VORATIQ_RUN_DIR, VORATIQ_VERIFICATION_DIR, } from "./constants.js";
+import { assertPathSegment, formatAgentSessionScopedPath, formatSessionScopedPath, } from "./path-formatters.js";
+import { getAgentSessionArtifactsDirectoryPath, getAgentSessionContextDirectoryPath, getAgentSessionWorkspaceDirectoryPath, } from "./session-paths.js";
+export function getVerificationProgrammaticResultPath(sessionId) {
+    return formatSessionScopedPath(VORATIQ_VERIFICATION_DIR, sessionId, "programmatic", ARTIFACTS_DIRNAME, PROGRAMMATIC_RESULT_FILENAME);
+}
+export function getVerificationRubricResultPath(options) {
+    const { sessionId, verifierId, template } = options;
+    const safeTemplate = assertPathSegment("segment", template);
+    return formatAgentSessionScopedPath(VORATIQ_VERIFICATION_DIR, sessionId, verifierId, safeTemplate, ARTIFACTS_DIRNAME, "result.json");
+}
+export function getVerificationRubricExecutionDirectoryPath(options) {
+    const { sessionId, verifierId, template } = options;
+    const safeTemplate = assertPathSegment("segment", template);
+    return formatAgentSessionScopedPath(VORATIQ_VERIFICATION_DIR, sessionId, verifierId, safeTemplate);
+}
+export function getAgentSessionManifestPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, RUNTIME_DIRNAME, MANIFEST_FILENAME);
+}
+export function getAgentSessionRuntimeDirectoryPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, RUNTIME_DIRNAME);
+}
+export function getAgentSessionStdoutPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, ARTIFACTS_DIRNAME, STDOUT_FILENAME);
+}
+export function getAgentSessionStderrPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, ARTIFACTS_DIRNAME, STDERR_FILENAME);
+}
+export function getAgentSessionDiffPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, ARTIFACTS_DIRNAME, DIFF_FILENAME);
+}
+export function getAgentSessionSummaryPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, ARTIFACTS_DIRNAME, SUMMARY_FILENAME);
+}
+export function getAgentSessionChatArtifactPath(domain, sessionId, agentId, format) {
+    const filename = format === "json" ? CHAT_JSON_FILENAME : CHAT_JSONL_FILENAME;
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, ARTIFACTS_DIRNAME, filename);
+}
+export function getAgentSessionSandboxDirectoryPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, SANDBOX_DIRNAME);
+}
+export function getAgentSessionSandboxHomePath(domain, sessionId, agentId) {
+    return getAgentSessionSandboxDirectoryPath(domain, sessionId, agentId);
+}
+export function getAgentSessionSandboxSettingsPath(domain, sessionId, agentId) {
+    return formatAgentSessionScopedPath(domain, sessionId, agentId, RUNTIME_DIRNAME, SANDBOX_SETTINGS_FILENAME);
+}
+export function getAgentManifestPath(runId, agentId) {
+    return getAgentSessionManifestPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentRuntimeDirectoryPath(runId, agentId) {
+    return getAgentSessionRuntimeDirectoryPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentWorkspaceDirectoryPath(runId, agentId) {
+    return getAgentSessionWorkspaceDirectoryPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentContextDirectoryPath(runId, agentId) {
+    return getAgentSessionContextDirectoryPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentArtifactsDirectoryPath(runId, agentId) {
+    return getAgentSessionArtifactsDirectoryPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentStdoutPath(runId, agentId) {
+    return getAgentSessionStdoutPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentStderrPath(runId, agentId) {
+    return getAgentSessionStderrPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentDiffPath(runId, agentId) {
+    return getAgentSessionDiffPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentSummaryPath(runId, agentId) {
+    return getAgentSessionSummaryPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentChatArtifactPath(runId, agentId, format) {
+    return getAgentSessionChatArtifactPath(VORATIQ_RUN_DIR, runId, agentId, format);
+}
+export function buildAgentArtifactPaths(options) {
+    const { runId, agentId, artifacts } = options;
+    const stdoutCaptured = artifacts?.stdoutCaptured ?? true;
+    const stderrCaptured = artifacts?.stderrCaptured ?? true;
+    const diffCaptured = artifacts?.diffCaptured ?? false;
+    const summaryCaptured = artifacts?.summaryCaptured ?? false;
+    const chatCaptured = artifacts?.chatCaptured ?? false;
+    const chatFormat = artifacts?.chatFormat ?? "jsonl";
+    return {
+        stdoutPath: stdoutCaptured ? getAgentStdoutPath(runId, agentId) : undefined,
+        stderrPath: stderrCaptured ? getAgentStderrPath(runId, agentId) : undefined,
+        diffPath: diffCaptured ? getAgentDiffPath(runId, agentId) : undefined,
+        summaryPath: summaryCaptured
+            ? getAgentSummaryPath(runId, agentId)
+            : undefined,
+        chatPath: chatCaptured
+            ? getAgentChatArtifactPath(runId, agentId, chatFormat)
+            : undefined,
+    };
+}
+export function getAgentSandboxDirectoryPath(runId, agentId) {
+    return getAgentSessionSandboxDirectoryPath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentSandboxHomePath(runId, agentId) {
+    return getAgentSessionSandboxHomePath(VORATIQ_RUN_DIR, runId, agentId);
+}
+export function getAgentSandboxSettingsPath(runId, agentId) {
+    return getAgentSessionSandboxSettingsPath(VORATIQ_RUN_DIR, runId, agentId);
+}

package/dist/workspace/chat/artifacts.d.ts

@@ -12,6 +12,7 @@ export interface PreserveChatArtifactsOptions {
     agentRoot: string;
     searchEnv?: NodeJS.ProcessEnv;
     baseline?: ProviderTranscriptBaseline;
+    selectionHint?: ProviderTranscriptSelectionHint;
 }
 export interface ProviderTranscriptSnapshotEntry {
     path: string;
@@ -19,5 +20,11 @@ export interface ProviderTranscriptSnapshotEntry {
     mtimeMs: number;
 }
 export type ProviderTranscriptBaseline = readonly ProviderTranscriptSnapshotEntry[];
+export interface CodexSessionMetaSelectionHint {
+    strategy: "codex-session-meta";
+    cwd: string;
+    minStartedAt?: string;
+}
+export type ProviderTranscriptSelectionHint = CodexSessionMetaSelectionHint;
 export declare function snapshotProviderTranscripts(options: Omit<PreserveChatArtifactsOptions, "baseline">): Promise<ProviderTranscriptBaseline>;
 export declare function preserveProviderChatTranscripts(options: PreserveChatArtifactsOptions): Promise<ChatArtifactCaptureResult>;

package/dist/workspace/chat/artifacts.js

@@ -4,7 +4,7 @@ import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { dirname, relative, resolve } from "node:path";
 import { finished } from "node:stream/promises";
 import { pathExists } from "../../utils/fs.js";
-import { ARTIFACTS_DIRNAME, CHAT_JSON_FILENAME, CHAT_JSONL_FILENAME, } from "../structure.js";
+import { ARTIFACTS_DIRNAME, CHAT_JSON_FILENAME, CHAT_JSONL_FILENAME, } from "../constants.js";
 import { findProviderTranscripts } from "./sources.js";
 export async function snapshotProviderTranscripts(options) {
     const transcriptPaths = await findProviderTranscripts(options.providerId, {
@@ -42,7 +42,20 @@ export async function preserveProviderChatTranscripts(options) {
         };
     }
     const existing = await locateExistingChatArtifact(agentRoot);
-    const selection = selectTranscriptFiles(candidatePaths);
+    let selection;
+    try {
+        selection = await selectTranscriptFiles({
+            providerId,
+            transcriptPaths: candidatePaths,
+            selectionHint: options.selectionHint,
+        });
+    }
+    catch (error) {
+        return {
+            status: "error",
+            error: error instanceof Error ? error : new Error(String(error)),
+        };
+    }
     if (!selection) {
         if (existing !== undefined) {
             return {
@@ -101,10 +114,21 @@ async function locateExistingChatArtifact(agentRoot) {
     }
     return undefined;
 }
-function selectTranscriptFiles(transcriptPaths) {
+async function selectTranscriptFiles(options) {
+    const { providerId, transcriptPaths, selectionHint } = options;
     const jsonlFiles = transcriptPaths.filter((path) => path.toLowerCase().endsWith(".jsonl"));
     if (jsonlFiles.length > 0) {
-        return { format: "jsonl", files: [...jsonlFiles].sort() };
+        const selectedJsonlFiles = await filterJsonlTranscriptFilesByHint({
+            providerId,
+            files: jsonlFiles,
+            selectionHint,
+        });
+        if (selectedJsonlFiles.length > 0) {
+            return { format: "jsonl", files: selectedJsonlFiles };
+        }
+        if (selectionHint) {
+            return undefined;
+        }
     }
     const jsonFiles = transcriptPaths
         .filter((path) => path.toLowerCase().endsWith(".json"))
@@ -114,6 +138,73 @@ function selectTranscriptFiles(transcriptPaths) {
     }
     return undefined;
 }
+async function filterJsonlTranscriptFilesByHint(options) {
+    const sortedFiles = [...options.files].sort();
+    const hint = options.selectionHint;
+    if (!hint) {
+        return sortedFiles;
+    }
+    if (options.providerId !== "codex" ||
+        hint.strategy !== "codex-session-meta") {
+        return sortedFiles;
+    }
+    const matchingFiles = [];
+    for (const file of sortedFiles) {
+        const metadata = await readCodexSessionMetadata(file);
+        if (!metadata) {
+            continue;
+        }
+        if (metadata.cwd !== hint.cwd) {
+            continue;
+        }
+        if (hint.minStartedAt &&
+            metadata.startedAt &&
+            metadata.startedAt < hint.minStartedAt) {
+            continue;
+        }
+        matchingFiles.push(file);
+    }
+    if (matchingFiles.length === 1) {
+        return matchingFiles;
+    }
+    if (matchingFiles.length > 1) {
+        throw new Error(`Ambiguous Codex transcript provenance for cwd \`${hint.cwd}\`: ${matchingFiles.join(", ")}`);
+    }
+    return [];
+}
+async function readCodexSessionMetadata(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    const lines = raw.split(/\r?\n/u);
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        const record = parsed;
+        if (record.type !== "session_meta") {
+            continue;
+        }
+        const payload = record.payload?.payload ?? record.payload;
+        return {
+            cwd: typeof payload?.cwd === "string" ? payload.cwd : undefined,
+            startedAt: typeof payload?.timestamp === "string" ? payload.timestamp : undefined,
+        };
+    }
+    return undefined;
+}
 async function bundleJsonTranscripts(options) {
     const { files, artifactPath, agentRoot, providerId } = options;
     if (files.length === 0) {

package/dist/workspace/chat/native-usage.js

@@ -1,5 +1,5 @@
 import { resolvePath } from "../../utils/path.js";
-import { getAgentSessionChatArtifactPath } from "../structure.js";
+import { getAgentSessionChatArtifactPath } from "../artifact-paths.js";
 import { extractChatUsageFromArtifact } from "./usage-extractor.js";
 export async function extractProviderNativeTokenUsageForSession(options) {
     const { root, domain, sessionId, agentId, provider, modelId, chatCaptured, format, artifactPath, } = options;

package/dist/workspace/chat/sources.d.ts

@@ -1,9 +1,6 @@
-export interface ProviderTranscriptSearchOptions {
+interface ProviderTranscriptSearchOptions {
     agentRoot: string;
     env?: NodeJS.ProcessEnv;
 }
-export type TranscriptLocator = (options: ProviderTranscriptSearchOptions) => Promise<readonly string[]>;
 export declare function findProviderTranscripts(providerId: string, options: ProviderTranscriptSearchOptions): Promise<readonly string[]>;
-export declare function findClaudeTranscripts(options: ProviderTranscriptSearchOptions): Promise<readonly string[]>;
-export declare function findCodexTranscripts(options: ProviderTranscriptSearchOptions): Promise<readonly string[]>;
-export declare function findGeminiTranscripts(options: ProviderTranscriptSearchOptions): Promise<readonly string[]>;
+export {};

package/dist/workspace/chat/sources.js

@@ -1,7 +1,7 @@
 import { readdir } from "node:fs/promises";
 import { isAbsolute, resolve as resolvePath } from "node:path";
 import { isMissing } from "../../utils/fs.js";
-import { SANDBOX_DIRNAME } from "../structure.js";
+import { SANDBOX_DIRNAME } from "../constants.js";
 const locatorMap = {
     claude: findClaudeTranscripts,
     codex: findCodexTranscripts,
@@ -14,19 +14,19 @@ export async function findProviderTranscripts(providerId, options) {
     }
     return locator(options);
 }
-export async function findClaudeTranscripts(options) {
+async function findClaudeTranscripts(options) {
     return await collectFilesFromRoots(resolveClaudeTranscriptRoots(options), {
         extensions: [".jsonl"],
         maxDepth: 2,
     });
 }
-export async function findCodexTranscripts(options) {
+async function findCodexTranscripts(options) {
     return await collectFilesFromRoots(resolveCodexTranscriptRoots(options), {
         extensions: [".jsonl"],
         maxDepth: 6,
     });
 }
-export async function findGeminiTranscripts(options) {
+async function findGeminiTranscripts(options) {
     const transcripts = new Set();
     for (const tmpRoot of resolveGeminiTranscriptRoots(options)) {
         const entries = await safeReadDir(tmpRoot);

package/dist/workspace/constants.d.ts

@@ -0,0 +1,47 @@
+export declare const VORATIQ_DIR = ".voratiq";
+export declare const VORATIQ_SPEC_DIR = "spec";
+export declare const VORATIQ_SPEC_FILE = "spec/index.json";
+export declare const VORATIQ_SPEC_SESSIONS_DIR = "spec/sessions";
+export declare const VORATIQ_RUN_DIR = "run";
+export declare const VORATIQ_RUN_FILE = "run/index.json";
+export declare const VORATIQ_RUN_SESSIONS_DIR = "run/sessions";
+export declare const VORATIQ_REDUCTION_DIR = "reduce";
+export declare const VORATIQ_REDUCTION_FILE = "reduce/index.json";
+export declare const VORATIQ_REDUCTION_SESSIONS_DIR = "reduce/sessions";
+export declare const VORATIQ_VERIFICATION_DIR = "verify";
+export declare const VORATIQ_VERIFICATION_FILE = "verify/index.json";
+export declare const VORATIQ_VERIFICATION_SESSIONS_DIR = "verify/sessions";
+export declare const VORATIQ_VERIFICATION_TEMPLATES_DIR = "verify/templates";
+export declare const VORATIQ_MESSAGE_DIR = "message";
+export declare const VORATIQ_MESSAGE_FILE = "message/index.json";
+export declare const VORATIQ_MESSAGE_SESSIONS_DIR = "message/sessions";
+export declare const VORATIQ_INTERACTIVE_DIR = "interactive";
+export declare const VORATIQ_INTERACTIVE_FILE = "interactive/index.json";
+export declare const VORATIQ_INTERACTIVE_SESSIONS_DIR = "interactive/sessions";
+export declare const VORATIQ_INDEX_FILENAME = "index.json";
+export declare const VORATIQ_HISTORY_LOCK_FILENAME = "history.lock";
+export declare const VORATIQ_SESSIONS_DIRNAME = "sessions";
+export declare const VORATIQ_AGENTS_FILE = "agents.yaml";
+export declare const VORATIQ_VERIFICATION_CONFIG_FILE = "verification.yaml";
+export declare const VORATIQ_ENVIRONMENT_FILE = "environment.yaml";
+export declare const VORATIQ_SANDBOX_FILE = "sandbox.yaml";
+export declare const VORATIQ_ORCHESTRATION_FILE = "orchestration.yaml";
+export declare const VORATIQ_MANAGED_STATE_FILE = "managed-state.json";
+export declare const WORKSPACE_DIRNAME = "workspace";
+export declare const CONTEXT_DIRNAME = "context";
+export declare const STDOUT_FILENAME = "stdout.log";
+export declare const STDERR_FILENAME = "stderr.log";
+export declare const DIFF_FILENAME = "diff.patch";
+export declare const SUMMARY_FILENAME = "summary.txt";
+export declare const CHAT_JSON_FILENAME = "chat.json";
+export declare const CHAT_JSONL_FILENAME = "chat.jsonl";
+export declare const REDUCTION_FILENAME = "reduction.md";
+export declare const REDUCTION_DATA_FILENAME = "reduction.json";
+export declare const MESSAGE_RESPONSE_FILENAME = "response.md";
+export declare const RUNTIME_DIRNAME = "runtime";
+export declare const ARTIFACTS_DIRNAME = "artifacts";
+export declare const MANIFEST_FILENAME = "manifest.json";
+export declare const REDUCTION_ARTIFACT_INFO_FILENAME = "artifact-information.json";
+export declare const SANDBOX_DIRNAME = "sandbox";
+export declare const SANDBOX_SETTINGS_FILENAME = "sandbox.json";
+export declare const PROGRAMMATIC_RESULT_FILENAME = "result.json";

package/dist/workspace/constants.js

@@ -0,0 +1,47 @@
+export const VORATIQ_DIR = ".voratiq";
+export const VORATIQ_SPEC_DIR = "spec";
+export const VORATIQ_SPEC_FILE = "spec/index.json";
+export const VORATIQ_SPEC_SESSIONS_DIR = "spec/sessions";
+export const VORATIQ_RUN_DIR = "run";
+export const VORATIQ_RUN_FILE = "run/index.json";
+export const VORATIQ_RUN_SESSIONS_DIR = "run/sessions";
+export const VORATIQ_REDUCTION_DIR = "reduce";
+export const VORATIQ_REDUCTION_FILE = "reduce/index.json";
+export const VORATIQ_REDUCTION_SESSIONS_DIR = "reduce/sessions";
+export const VORATIQ_VERIFICATION_DIR = "verify";
+export const VORATIQ_VERIFICATION_FILE = "verify/index.json";
+export const VORATIQ_VERIFICATION_SESSIONS_DIR = "verify/sessions";
+export const VORATIQ_VERIFICATION_TEMPLATES_DIR = "verify/templates";
+export const VORATIQ_MESSAGE_DIR = "message";
+export const VORATIQ_MESSAGE_FILE = "message/index.json";
+export const VORATIQ_MESSAGE_SESSIONS_DIR = "message/sessions";
+export const VORATIQ_INTERACTIVE_DIR = "interactive";
+export const VORATIQ_INTERACTIVE_FILE = "interactive/index.json";
+export const VORATIQ_INTERACTIVE_SESSIONS_DIR = "interactive/sessions";
+export const VORATIQ_INDEX_FILENAME = "index.json";
+export const VORATIQ_HISTORY_LOCK_FILENAME = "history.lock";
+export const VORATIQ_SESSIONS_DIRNAME = "sessions";
+export const VORATIQ_AGENTS_FILE = "agents.yaml";
+export const VORATIQ_VERIFICATION_CONFIG_FILE = "verification.yaml";
+export const VORATIQ_ENVIRONMENT_FILE = "environment.yaml";
+export const VORATIQ_SANDBOX_FILE = "sandbox.yaml";
+export const VORATIQ_ORCHESTRATION_FILE = "orchestration.yaml";
+export const VORATIQ_MANAGED_STATE_FILE = "managed-state.json";
+export const WORKSPACE_DIRNAME = "workspace";
+export const CONTEXT_DIRNAME = "context";
+export const STDOUT_FILENAME = "stdout.log";
+export const STDERR_FILENAME = "stderr.log";
+export const DIFF_FILENAME = "diff.patch";
+export const SUMMARY_FILENAME = "summary.txt";
+export const CHAT_JSON_FILENAME = "chat.json";
+export const CHAT_JSONL_FILENAME = "chat.jsonl";
+export const REDUCTION_FILENAME = "reduction.md";
+export const REDUCTION_DATA_FILENAME = "reduction.json";
+export const MESSAGE_RESPONSE_FILENAME = "response.md";
+export const RUNTIME_DIRNAME = "runtime";
+export const ARTIFACTS_DIRNAME = "artifacts";
+export const MANIFEST_FILENAME = "manifest.json";
+export const REDUCTION_ARTIFACT_INFO_FILENAME = "artifact-information.json";
+export const SANDBOX_DIRNAME = "sandbox";
+export const SANDBOX_SETTINGS_FILENAME = "sandbox.json";
+export const PROGRAMMATIC_RESULT_FILENAME = "result.json";

package/dist/workspace/errors.js

@@ -1,6 +1,6 @@
 import { HintedError } from "../utils/errors.js";
 const DEFAULT_WORKSPACE_HINT = [
-    "Run `voratiq init` to configure the workspace.",
+    "Run `voratiq doctor --fix` to repair workspace setup.",
 ];
 export class WorkspaceError extends HintedError {
     constructor(message, detailLines = [], hintLines = DEFAULT_WORKSPACE_HINT) {
@@ -29,7 +29,7 @@ export class WorkspaceWrongTypeEntryError extends WorkspaceError {
 export class WorkspaceNotInitializedError extends WorkspaceError {
     missingEntries;
     constructor(missingEntries) {
-        super("Voratiq workspace is not initialized.", buildMissingEntryDetailLines(missingEntries), ["Run `voratiq init` from the repository root, then retry."]);
+        super("Voratiq workspace is not initialized.", buildMissingEntryDetailLines(missingEntries), ["Run `voratiq doctor --fix` to repair workspace setup."]);
         this.missingEntries = missingEntries;
         this.name = "WorkspaceNotInitializedError";
     }

package/dist/workspace/layout.js

@@ -1,7 +1,9 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
 import { normalizePathForDisplay, resolvePath } from "../utils/path.js";
-import { ARTIFACTS_DIRNAME, CONTEXT_DIRNAME, getAgentSessionArtifactsDirectoryPath, getAgentSessionContextDirectoryPath, getAgentSessionDirectoryPath, getAgentSessionManifestPath, getAgentSessionRuntimeDirectoryPath, getAgentSessionSandboxDirectoryPath, getAgentSessionSandboxHomePath, getAgentSessionSandboxSettingsPath, getAgentSessionStderrPath, getAgentSessionStdoutPath, getAgentSessionWorkspaceDirectoryPath, getRunDirectoryPath, MANIFEST_FILENAME, RUNTIME_DIRNAME, SANDBOX_DIRNAME, SANDBOX_SETTINGS_FILENAME, STDERR_FILENAME, STDOUT_FILENAME, VORATIQ_RUN_DIR, WORKSPACE_DIRNAME, } from "./structure.js";
+import { getAgentSessionManifestPath, getAgentSessionRuntimeDirectoryPath, getAgentSessionSandboxDirectoryPath, getAgentSessionSandboxHomePath, getAgentSessionSandboxSettingsPath, getAgentSessionStderrPath, getAgentSessionStdoutPath, } from "./artifact-paths.js";
+import { ARTIFACTS_DIRNAME, CONTEXT_DIRNAME, MANIFEST_FILENAME, RUNTIME_DIRNAME, SANDBOX_DIRNAME, SANDBOX_SETTINGS_FILENAME, STDERR_FILENAME, STDOUT_FILENAME, VORATIQ_RUN_DIR, WORKSPACE_DIRNAME, } from "./constants.js";
+import { getAgentSessionArtifactsDirectoryPath, getAgentSessionContextDirectoryPath, getAgentSessionDirectoryPath, getAgentSessionWorkspaceDirectoryPath, getRunDirectoryPath, } from "./session-paths.js";
 export function resolveRunWorkspacePaths(root, runId) {
     const relative = normalizePathForDisplay(getRunDirectoryPath(runId));
     const absolute = resolvePath(root, relative);