@mirnoorata/codexa 0.2.0

package/dist/query/workspace-guidance.js

@@ -0,0 +1,214 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { limitText, uniqueSorted } from "../util.js";
+export async function workspaceGuidancePreview(input) {
+    const workspaceRoot = await findWorkspaceRoot(input.repoRoot);
+    if (!workspaceRoot) {
+        return { lines: [] };
+    }
+    const terms = guidanceTerms(input);
+    if (terms.size === 0) {
+        return { lines: [] };
+    }
+    const files = [
+        { source: "WORKING.md", path: path.join(workspaceRoot, ".codex", "WORKING.md"), maxLines: 320 },
+        { source: "MEMORY.md", path: path.join(workspaceRoot, ".codex", "MEMORY.md"), maxLines: 1200 }
+    ];
+    const warnings = [];
+    const candidates = [];
+    for (const file of files) {
+        const read = await readGuidanceFile(file.path, file.maxLines);
+        if (read.warning) {
+            warnings.push(`${file.source}: ${read.warning}`);
+            continue;
+        }
+        for (const entry of read.lines) {
+            const scored = scoreGuidanceLine(entry.text, file.source, entry.line, terms, input.files ?? [], input.repoRoot);
+            if (scored) {
+                candidates.push(scored);
+            }
+        }
+    }
+    const selected = dedupeGuidanceLines(candidates)
+        .sort((a, b) => b.score - a.score || sourcePriority(a.source) - sourcePriority(b.source) || a.line - b.line)
+        .slice(0, Math.max(0, input.limit));
+    if (selected.length === 0 && warnings.length === 0) {
+        return { lines: [] };
+    }
+    return {
+        lines: selected.map((line) => `- ${line.source}:${line.line}: ${line.text}`),
+        data: {
+            workspaceRoot,
+            files: files.map((file) => path.relative(workspaceRoot, file.path)),
+            lines: selected,
+            warnings
+        }
+    };
+}
+async function findWorkspaceRoot(repoRoot) {
+    let current = path.resolve(repoRoot);
+    while (true) {
+        const codexDir = path.join(current, ".codex");
+        const hasWorking = await exists(path.join(codexDir, "WORKING.md"));
+        const hasMemory = await exists(path.join(codexDir, "MEMORY.md"));
+        if (hasWorking || hasMemory) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readGuidanceFile(filePath, maxLines) {
+    try {
+        const source = await fs.readFile(filePath, "utf8");
+        return {
+            lines: source
+                .split(/\r?\n/u)
+                .slice(0, maxLines)
+                .map((text, index) => ({ line: index + 1, text: text.trim() }))
+                .filter((entry) => entry.text.length > 0)
+        };
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { lines: [] };
+        }
+        return { lines: [], warning: error instanceof Error ? error.message : String(error) };
+    }
+}
+function guidanceTerms(input) {
+    const repoName = path.basename(path.resolve(input.repoRoot));
+    const terms = new Set();
+    addGuidanceTerms(terms, [repoName], false);
+    addGuidanceTerms(terms, [input.task ?? "", input.query ?? ""], true);
+    addGuidanceTerms(terms, [...(input.files ?? []), ...(input.symbols ?? [])], true);
+    return terms;
+}
+function addGuidanceTerms(terms, values, splitPathish) {
+    for (const value of values) {
+        for (const rawTerm of value.toLowerCase().split(/[^a-z0-9_.\/-]+/u)) {
+            const candidates = splitPathish ? pathishTerms(rawTerm) : [rawTerm.trim()];
+            for (const candidate of candidates) {
+                if (candidate.length >= 3 && !STOP_TERMS.has(candidate)) {
+                    terms.add(candidate);
+                }
+            }
+        }
+    }
+}
+function pathishTerms(term) {
+    const stripped = term.trim().replace(/^["'`]+|["'`]+$/gu, "");
+    if (!stripped) {
+        return [];
+    }
+    const parts = stripped.split(/[\/_.-]+/u).filter(Boolean);
+    return uniqueSorted([stripped, ...parts]);
+}
+function scoreGuidanceLine(text, source, line, terms, files, repoRoot) {
+    if (/^#\s*(working|memory)\b/iu.test(text)) {
+        return undefined;
+    }
+    const lower = text.toLowerCase();
+    if (source === "WORKING.md" && containsAbsolutePath(lower) && !lower.includes(path.resolve(repoRoot).toLowerCase())) {
+        return undefined;
+    }
+    const reasons = [];
+    let score = 0;
+    for (const file of files) {
+        const normalized = file.toLowerCase();
+        const base = path.posix.basename(normalized);
+        if (normalized && lower.includes(normalized)) {
+            score += 8;
+            reasons.push(`file ${file}`);
+        }
+        else if (base && lower.includes(base)) {
+            score += 4;
+            reasons.push(`file ${base}`);
+        }
+    }
+    for (const term of terms) {
+        if (lower.includes(term)) {
+            score += term.length >= 8 ? 3 : 1;
+            reasons.push(`term ${term}`);
+        }
+    }
+    if (score <= 0) {
+        return undefined;
+    }
+    if (source === "WORKING.md" && /\b(active|focus|next|repo|task|claim|blocker)\b/u.test(lower)) {
+        score += 2;
+        reasons.push("working-state");
+    }
+    if (source === "MEMORY.md" && /\b(preference|pattern|gotcha|workflow|memory|guidance)\b/u.test(lower)) {
+        score += 2;
+        reasons.push("durable-guidance");
+    }
+    return {
+        source,
+        line,
+        text: limitText(text.replace(/\s+/gu, " "), 220),
+        score,
+        reasons: uniqueSorted(reasons).slice(0, 8)
+    };
+}
+function dedupeGuidanceLines(lines) {
+    const seen = new Set();
+    const deduped = [];
+    for (const line of lines) {
+        const key = `${line.source}:${line.text.toLowerCase()}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        deduped.push(line);
+    }
+    return deduped;
+}
+function sourcePriority(source) {
+    return source === "WORKING.md" ? 0 : 1;
+}
+function containsAbsolutePath(value) {
+    return /(?:^|[\s|`"'(])(?:\/[a-z0-9_.-]+){2,}/u.test(value);
+}
+const STOP_TERMS = new Set([
+    "active",
+    "and",
+    "are",
+    "but",
+    "can",
+    "current",
+    "default",
+    "diff",
+    "does",
+    "for",
+    "from",
+    "how",
+    "into",
+    "need",
+    "other",
+    "repo",
+    "session",
+    "safe",
+    "selected",
+    "task",
+    "test",
+    "tests",
+    "the",
+    "this",
+    "what",
+    "when",
+    "with"
+]);
+//# sourceMappingURL=workspace-guidance.js.map

package/dist/query/workspace-guidance.js.map

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

package/dist/query/worktree-state.d.ts

@@ -0,0 +1,22 @@
+import type { ChangedFileEntry, ChangedSymbol } from "../types.js";
+import type { QuerySession } from "./session.js";
+export interface WorktreeState {
+    entries: ChangedFileEntry[];
+    files: string[];
+    symbols: ChangedSymbol[];
+    knownClean: boolean;
+    degraded: boolean;
+    degradedReasons: string[];
+}
+export declare function getWorktreeState(session: QuerySession, options?: {
+    includeSymbols?: boolean;
+}): Promise<WorktreeState>;
+export declare function worktreeStateGaps(state: WorktreeState): string[];
+export declare function worktreeStateText(state: WorktreeState): string[];
+export declare function compactWorktreeState(state: WorktreeState): {
+    knownClean: boolean;
+    degraded: boolean;
+    dirtyFileCount: number;
+    symbolCount: number;
+    degradedReasons: string[];
+};

package/dist/query/worktree-state.js

@@ -0,0 +1,32 @@
+export async function getWorktreeState(session, options = {}) {
+    const entries = await session.getChangedFileEntries();
+    const symbols = options.includeSymbols === false ? [] : await session.getChangedSymbols();
+    const degradedReasons = [...new Set(session.worktreeDegradationReasons)];
+    return {
+        entries,
+        files: entries.map((entry) => entry.path),
+        symbols,
+        knownClean: entries.length === 0 && symbols.length === 0 && degradedReasons.length === 0,
+        degraded: degradedReasons.length > 0,
+        degradedReasons
+    };
+}
+export function worktreeStateGaps(state) {
+    return state.degraded ? [`worktree state unavailable: ${state.degradedReasons.join("; ")}`] : [];
+}
+export function worktreeStateText(state) {
+    if (!state.degraded) {
+        return [];
+    }
+    return ["", "Worktree state:", `- unknown: ${state.degradedReasons.join("; ")}`];
+}
+export function compactWorktreeState(state) {
+    return {
+        knownClean: state.knownClean,
+        degraded: state.degraded,
+        dirtyFileCount: state.files.length,
+        symbolCount: state.symbols.length,
+        degradedReasons: state.degradedReasons
+    };
+}
+//# sourceMappingURL=worktree-state.js.map

package/dist/query/worktree-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-state.js","sourceRoot":"","sources":["../../src/query/worktree-state.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAqB,EAAE,UAAwC,EAAE;IACtG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,qBAAqB,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAC1F,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACzE,OAAO;QACL,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QACzC,OAAO;QACP,UAAU,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QACxF,QAAQ,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC;QACpC,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,+BAA+B,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,EAAE,EAAE,iBAAiB,EAAE,cAAc,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAoB;IAOvD,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;QAClC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;QACjC,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC,CAAC;AACJ,CAAC"}

package/dist/query/worktree.d.ts

@@ -0,0 +1,16 @@
+import { type CommandResult, type RunCommandOptions } from "../command.js";
+import type { ChangedFileEntry, ChangedSymbol, CodexaIndex } from "../types.js";
+type WorktreeCommandRunner = (command: string, args: string[], options?: RunCommandOptions) => Promise<CommandResult>;
+export interface ChangedFilesResult {
+    entries: ChangedFileEntry[];
+    degradedReason: string | null;
+}
+export interface ChangedSymbolsResult {
+    symbols: ChangedSymbol[];
+    degradedReason: string | null;
+}
+export declare function getChangedFileEntries(repoRoot: string, commandRunner?: WorktreeCommandRunner): Promise<ChangedFilesResult>;
+export declare function getChangedSymbols(repoRoot: string, index: CodexaIndex, commandRunner?: WorktreeCommandRunner): Promise<ChangedSymbolsResult>;
+export declare function formatChangedEntry(entry: ChangedFileEntry): string;
+export declare function isCodexaControlPath(filePath: string): boolean;
+export {};

package/dist/query/worktree.js

@@ -0,0 +1,194 @@
+import path from "node:path";
+import { runCommand } from "../command.js";
+import { normalizePath } from "../util.js";
+const GIT_TIMEOUT_MS = 5_000;
+const GIT_MAX_BUFFER_BYTES = 1024 * 1024;
+export async function getChangedFileEntries(repoRoot, commandRunner = runCommand) {
+    const resolvedRepo = path.resolve(repoRoot);
+    const gitRootResult = await commandRunner("git", ["-C", resolvedRepo, "rev-parse", "--show-toplevel"], {
+        timeoutMs: 2_000,
+        maxBufferBytes: 64 * 1024
+    });
+    if (!gitRootResult.ok) {
+        return { entries: [], degradedReason: commandFailureReason("git rev-parse --show-toplevel", gitRootResult) };
+    }
+    const gitRoot = gitRootResult.stdout.trim();
+    const relativePrefix = normalizePath(path.relative(gitRoot, resolvedRepo));
+    const statusResult = await commandRunner("git", ["-C", resolvedRepo, "status", "--porcelain=v1", "-z", "--untracked-files=all"], {
+        timeoutMs: GIT_TIMEOUT_MS,
+        maxBufferBytes: GIT_MAX_BUFFER_BYTES
+    });
+    if (!statusResult.ok) {
+        return { entries: [], degradedReason: commandFailureReason("git status --porcelain", statusResult) };
+    }
+    const entries = statusResult.stdout.split("\0").filter(Boolean);
+    const files = [];
+    for (let i = 0; i < entries.length; i += 1) {
+        const entry = entries[i];
+        if (!entry || entry.length < 4) {
+            continue;
+        }
+        const status = entry.slice(0, 2);
+        const pathValue = repoRelativeStatusPath(entry.slice(3), relativePrefix);
+        if (!pathValue) {
+            if (status.includes("R") || status.includes("C")) {
+                i += 1;
+            }
+            continue;
+        }
+        if (status.includes("R") || status.includes("C")) {
+            files.push(changedEntry(pathValue, status, repoRelativeStatusPath(entries[i + 1] ?? "", relativePrefix)));
+            i += 1;
+        }
+        else {
+            files.push(changedEntry(pathValue, status));
+        }
+    }
+    return {
+        entries: files.filter((entry) => !isCodexaControlPath(entry.path)).sort((a, b) => a.path.localeCompare(b.path) || a.status.localeCompare(b.status)),
+        degradedReason: null
+    };
+}
+export async function getChangedSymbols(repoRoot, index, commandRunner = runCommand) {
+    const { rangesByPath, degradedReason } = await getChangedRanges(repoRoot, commandRunner);
+    if (rangesByPath.size === 0) {
+        return { symbols: [], degradedReason };
+    }
+    const changed = [];
+    for (const symbol of index.symbols) {
+        if (!symbol.range) {
+            continue;
+        }
+        const ranges = rangesByPath.get(symbol.path);
+        if (!ranges?.length) {
+            continue;
+        }
+        const touched = ranges.filter((range) => rangesIntersect(symbol.range.startLine, symbol.range.endLine, range.startLine, range.endLine));
+        if (touched.length > 0) {
+            changed.push({
+                symbol,
+                changedLines: touched.map((range) => (range.startLine === range.endLine ? String(range.startLine) : `${range.startLine}-${range.endLine}`))
+            });
+        }
+    }
+    return {
+        symbols: changed.sort((a, b) => a.symbol.path.localeCompare(b.symbol.path) ||
+            (a.symbol.range?.startLine ?? 0) - (b.symbol.range?.startLine ?? 0) ||
+            a.symbol.qualifiedName.localeCompare(b.symbol.qualifiedName)),
+        degradedReason
+    };
+}
+export function formatChangedEntry(entry) {
+    const old = entry.oldPath ? ` from ${entry.oldPath}` : "";
+    return `- ${entry.path}: ${entry.kind} (${entry.status.trim() || "worktree"})${old}`;
+}
+function repoRelativeStatusPath(filePath, relativePrefix) {
+    const normalized = normalizePath(filePath);
+    if (!relativePrefix) {
+        return normalized;
+    }
+    if (!(normalized === relativePrefix || normalized.startsWith(`${relativePrefix}/`))) {
+        return undefined;
+    }
+    const relative = normalizePath(path.relative(relativePrefix, normalized));
+    return relative && !relative.startsWith("..") ? relative : undefined;
+}
+function changedEntry(filePath, status, oldPath) {
+    const untracked = status === "??";
+    const staged = !untracked && status[0] !== " " && status[0] !== "?";
+    const worktree = untracked || (status[1] !== " " && status[1] !== "?");
+    return {
+        path: filePath,
+        oldPath,
+        status,
+        kind: changedKind(status),
+        staged,
+        worktree
+    };
+}
+function changedKind(status) {
+    if (status === "??") {
+        return "untracked";
+    }
+    if (status.includes("R")) {
+        return "renamed";
+    }
+    if (status.includes("C")) {
+        return "copied";
+    }
+    if (status.includes("A")) {
+        return "added";
+    }
+    if (status.includes("D")) {
+        return "deleted";
+    }
+    if (status.includes("M")) {
+        return "modified";
+    }
+    return "unknown";
+}
+async function getChangedRanges(repoRoot, commandRunner) {
+    const [worktreeDiff, stagedDiff] = await Promise.all([
+        gitDiff(repoRoot, ["diff", "--unified=0", "--no-ext-diff"], commandRunner),
+        gitDiff(repoRoot, ["diff", "--cached", "--unified=0", "--no-ext-diff"], commandRunner)
+    ]);
+    const degradedReasons = [worktreeDiff.degradedReason, stagedDiff.degradedReason].filter((reason) => Boolean(reason));
+    const combined = [worktreeDiff.stdout, stagedDiff.stdout].filter(Boolean).join("\n");
+    const ranges = new Map();
+    let currentFile = "";
+    for (const line of combined.split(/\r?\n/)) {
+        if (line.startsWith("+++ b/")) {
+            currentFile = normalizePath(line.slice("+++ b/".length));
+            continue;
+        }
+        if (!line.startsWith("@@") || !currentFile || isCodexaControlPath(currentFile)) {
+            continue;
+        }
+        const match = /\+(\d+)(?:,(\d+))?/.exec(line);
+        if (!match) {
+            continue;
+        }
+        const startLine = Number.parseInt(match[1], 10);
+        const span = Number.parseInt(match[2] ?? "1", 10);
+        const endLine = span === 0 ? startLine : startLine + span - 1;
+        const existing = ranges.get(currentFile) ?? [];
+        existing.push({ startLine, endLine });
+        ranges.set(currentFile, existing);
+    }
+    return {
+        rangesByPath: ranges,
+        degradedReason: degradedReasons.length > 0 ? degradedReasons.join("; ") : null
+    };
+}
+async function gitDiff(repoRoot, args, commandRunner) {
+    const result = await commandRunner("git", ["-C", path.resolve(repoRoot), ...args], {
+        timeoutMs: GIT_TIMEOUT_MS,
+        maxBufferBytes: GIT_MAX_BUFFER_BYTES
+    });
+    if (result.ok) {
+        return { stdout: result.stdout, degradedReason: null };
+    }
+    return {
+        stdout: "",
+        degradedReason: commandFailureReason(`git ${args.join(" ")}`, result)
+    };
+}
+function commandFailureReason(label, result) {
+    if (result.timedOut) {
+        return `${label} timed out`;
+    }
+    if (result.truncated) {
+        return `${label} output truncated`;
+    }
+    if (typeof result.exitCode === "number" && result.exitCode !== 0) {
+        return `${label} exited with code ${result.exitCode}`;
+    }
+    return `${label} failed`;
+}
+function rangesIntersect(startA, endA, startB, endB) {
+    return startA <= endB && startB <= endA;
+}
+export function isCodexaControlPath(filePath) {
+    return filePath === ".codex" || filePath.startsWith(".codex/");
+}
+//# sourceMappingURL=worktree.js.map

package/dist/query/worktree.js.map

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

package/dist/query-data.d.ts

@@ -0,0 +1,4 @@
+import type { CodexaQueryData, PostEditReviewData, QueryResultMode } from "./types.js";
+export declare function asCodexaQueryData(value: unknown, inferredMode?: string): CodexaQueryData | undefined;
+export declare function asPostEditReviewData(value: unknown): PostEditReviewData | undefined;
+export declare function queryResultMode(value: unknown): QueryResultMode | undefined;

package/dist/query-data.js

@@ -0,0 +1,112 @@
+const typedCompactionModes = new Set(["context_pack", "task_brief", "focus_brief", "session_context", "change_plan", "post_edit_review", "test_plan"]);
+export function asCodexaQueryData(value, inferredMode) {
+    const record = queryRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const mode = queryResultMode(record.mode) ?? queryResultMode(inferredMode);
+    if (!mode || !typedCompactionModes.has(mode)) {
+        return undefined;
+    }
+    const data = { ...record, mode };
+    switch (mode) {
+        case "context_pack":
+        case "task_brief":
+            return isContextPacketData(data) ? data : undefined;
+        case "focus_brief":
+        case "session_context":
+            return isFocusBriefData(data) ? data : undefined;
+        case "change_plan":
+            return isChangePlanData(data) ? data : undefined;
+        case "post_edit_review":
+            return isPostEditReviewData(data) ? data : undefined;
+        case "test_plan":
+            return isTestPlanData(data) ? data : undefined;
+        default:
+            return undefined;
+    }
+}
+export function asPostEditReviewData(value) {
+    const data = asCodexaQueryData(value, "post_edit_review");
+    return data?.mode === "post_edit_review" ? data : undefined;
+}
+export function queryResultMode(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    return typedCompactionModes.has(value) ? value : undefined;
+}
+function isContextPacketData(value) {
+    return arraysOrUndefined(value, ["focusFiles", "changedFiles", "changedEntries", "changedSymbols", "unindexedChanged", "groups", "tests", "snippets", "contextSources", "nextReads"]);
+}
+function isFocusBriefData(value) {
+    return arraysOrUndefined(value, ["focusFiles", "workflows", "modules", "groups", "tests"]);
+}
+function isChangePlanData(value) {
+    return arraysOrUndefined(value, ["targetCandidates", "steps", "files", "plannedEditTargets", "tests", "recipes", "requiredWorkflowChecks", "requiredDependencyChecks"]);
+}
+function isPostEditReviewData(value) {
+    return arraysOrUndefined(value, [
+        "files",
+        "changedSinceSnapshot",
+        "changedGroups",
+        "resolvedBaselineFiles",
+        "unplannedEditedFiles",
+        "plannedRenames",
+        "unplannedChangedSymbols",
+        "plannedButUntouchedFiles",
+        "symbolDeltas",
+        "modifiedSymbols",
+        "modifiedPublicSymbols",
+        "riskDeltas",
+        "affectedEdges",
+        "affectedTests",
+        "tests",
+        "degradedSnapshotTests",
+        "supersededDegradedSnapshotTests",
+        "testsNotRun",
+        "missedLikelyTests",
+        "ranTests",
+        "ranCommands",
+        "ranCommandReports",
+        "commandEnvelopes",
+        "waivedChecks",
+        "waivers",
+        "verificationCoverage",
+        "verificationLedger",
+        "waivedVerification",
+        "unindexedEditedFiles",
+        "riskEscalations",
+        "workflows",
+        "workflowChecks",
+        "dependencyChecks",
+        "driftReasons",
+        "nextActions",
+        "autoVerifyCandidates",
+        "autoVerifyRunnerEvidence"
+    ]);
+}
+function isTestPlanData(value) {
+    return arraysOrUndefined(value, [
+        "changedFiles",
+        "changedEntries",
+        "changedSymbols",
+        "unindexedChanged",
+        "groups",
+        "tests",
+        "verificationCommands",
+        "verificationCoverage",
+        "verificationCommandPlan",
+        "commandEnvelopes",
+        "verificationLedgerPreview",
+        "verificationLedger",
+        "testsNotRun"
+    ]);
+}
+function arraysOrUndefined(value, keys) {
+    return keys.every((key) => value[key] === undefined || Array.isArray(value[key]));
+}
+function queryRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+//# sourceMappingURL=query-data.js.map

package/dist/query-data.js.map

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