@ttfw/envoi 1.0.0

package/dist/lib/history.js

@@ -0,0 +1,236 @@
+/**
+ * History management utilities for preserving tick run artifacts.
+ *
+ * Each tick's artifacts (report.json, report.md, diff.patch, verify.log) are
+ * preserved in history/<run_id>/ to enable debugging and audit trails.
+ */
+import { mkdir, readdir, open, rename, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { atomicWriteJson, AtomicFsError } from './fs.js';
+import { resolveInWorkspace } from './paths.js';
+/**
+ * Gets the full path to the history directory for a specific run.
+ *
+ * @param config - Envoi configuration
+ * @param runId - Run ID
+ * @returns Full path to the run's history directory
+ */
+function getHistoryRunPath(config, runId) {
+    const historyDir = resolveInWorkspace(config.workspace_dir, config.history.dir);
+    return join(historyDir, runId);
+}
+/**
+ * Atomically writes text content to a file.
+ *
+ * Uses the write-tmp-fsync-rename pattern to ensure crash-safe writes.
+ *
+ * @param filePath - Path to write the file
+ * @param content - Text content to write
+ * @throws {AtomicFsError} If the write operation fails
+ */
+async function atomicWriteText(filePath, content) {
+    const tmpPath = `${filePath}.tmp`;
+    let fileHandle = null;
+    try {
+        // Ensure content ends with newline
+        const normalizedContent = content.endsWith('\n') ? content : content + '\n';
+        // Open file for writing, create if doesn't exist, truncate if exists
+        fileHandle = await open(tmpPath, 'w');
+        // Write the content
+        await fileHandle.writeFile(normalizedContent, 'utf-8');
+        // fsync to ensure data is flushed to disk
+        await fileHandle.sync();
+        // Close before rename
+        await fileHandle.close();
+        fileHandle = null;
+        // Atomic rename (POSIX guarantees atomicity)
+        await rename(tmpPath, filePath);
+    }
+    catch (error) {
+        // Attempt to clean up the tmp file on error
+        if (fileHandle) {
+            try {
+                await fileHandle.close();
+            }
+            catch {
+                // Ignore close errors during cleanup
+            }
+        }
+        try {
+            await unlink(tmpPath);
+        }
+        catch {
+            // Ignore unlink errors - file may not exist
+        }
+        throw new AtomicFsError(`Failed to atomically write text to ${filePath}: ${error instanceof Error ? error.message : String(error)}`, filePath, error instanceof Error ? error : undefined);
+    }
+}
+/**
+ * Creates the history snapshot directory for a run.
+ *
+ * @param runId - Run ID
+ * @param config - Envoi configuration
+ * @returns Promise that resolves when directory is created
+ * @throws {Error} If directory creation fails
+ */
+export async function createHistorySnapshot(runId, config) {
+    const runPath = getHistoryRunPath(config, runId);
+    await mkdir(runPath, { recursive: true });
+}
+/**
+ * Writes an artifact file to the history directory for a run.
+ *
+ * @param runId - Run ID
+ * @param filename - Name of the artifact file (e.g., 'report.json', 'diff.patch')
+ * @param content - Content to write (string for text files, object for JSON)
+ * @param config - Envoi configuration
+ * @returns Promise that resolves when write completes
+ * @throws {Error} If the write operation fails
+ */
+export async function writeHistoryArtifact(runId, filename, content, config) {
+    const runPath = getHistoryRunPath(config, runId);
+    const filePath = join(runPath, filename);
+    if (typeof content === 'object') {
+        await atomicWriteJson(filePath, content);
+    }
+    else {
+        await atomicWriteText(filePath, content);
+    }
+}
+/**
+ * Creates a complete history snapshot for a tick run.
+ *
+ * Saves all artifacts (meta.json, report.json, report.md, and optionally
+ * diff.patch and verify.log) to history/<run_id>/.
+ *
+ * @param runId - Run ID
+ * @param report - Report data
+ * @param markdown - Markdown rendering of the report
+ * @param diffPatch - Optional diff patch content
+ * @param verifyLog - Optional verification log content
+ * @param config - Envoi configuration
+ * @returns Promise that resolves when all artifacts are saved
+ * @throws {Error} If any write operation fails
+ */
+export async function snapshotRun(runId, report, markdown, diffPatch, verifyLog, config) {
+    // Create the history directory
+    await createHistorySnapshot(runId, config);
+    // Create meta.json with run metadata
+    const meta = {
+        run_id: runId,
+        created_at: report.ended_at,
+        verdict: report.verdict,
+        code: report.code,
+    };
+    await writeHistoryArtifact(runId, 'meta.json', meta, config);
+    // Write report.json (full report data)
+    await writeHistoryArtifact(runId, 'report.json', report, config);
+    // Write report.md (markdown rendering)
+    await writeHistoryArtifact(runId, 'report.md', markdown, config);
+    // Write optional diff.patch if provided and enabled
+    if (diffPatch !== null && diffPatch !== undefined && config.history.include_diff_patch) {
+        await writeHistoryArtifact(runId, 'diff.patch', diffPatch, config);
+    }
+    // Write optional verify.log if provided and enabled
+    if (verifyLog !== null && verifyLog !== undefined && config.history.include_verify_log) {
+        await writeHistoryArtifact(runId, 'verify.log', verifyLog, config);
+    }
+}
+/**
+ * Persists builder failure artifacts to history for debugging.
+ *
+ * Writes raw stdout, stderr (if available), and error info to
+ * history/<run_id>/ for post-mortem analysis.
+ *
+ * @param runId - Run ID
+ * @param stdout - Raw stdout from builder invocation
+ * @param stderr - Raw stderr from builder invocation (may be null)
+ * @param errorInfo - Structured error information
+ * @param config - Envoi configuration
+ * @returns Promise that resolves when all artifacts are saved
+ * @throws {Error} If any write operation fails
+ */
+export async function persistBuilderFailure(runId, stdout, stderr, errorInfo, config) {
+    // Ensure history directory exists
+    await createHistorySnapshot(runId, config);
+    // Write raw stdout
+    await writeHistoryArtifact(runId, 'builder.stdout.raw.txt', stdout, config);
+    // Write raw stderr if available
+    if (stderr !== null && stderr.length > 0) {
+        await writeHistoryArtifact(runId, 'builder.stderr.raw.txt', stderr, config);
+    }
+    // Write structured error info
+    await writeHistoryArtifact(runId, 'builder.error.json', errorInfo, config);
+}
+/** Maximum size for stdout/stderr artifacts (200KB) */
+const MAX_OUTPUT_SIZE = 200 * 1024;
+/**
+ * Truncates content to max size with marker.
+ */
+function truncateWithMarker(content, maxSize) {
+    if (content.length <= maxSize) {
+        return content;
+    }
+    return content.slice(0, maxSize - 12) + '\n[truncated]';
+}
+/**
+ * Persists orchestrator failure artifacts to history for debugging.
+ *
+ * Writes stdout, stderr, extracted JSON, schema errors, and meta to
+ * history/<run_id>/orchestrator/ for post-mortem analysis.
+ *
+ * @param runId - Run ID
+ * @param stdout - Raw stdout from orchestrator invocation
+ * @param stderr - Raw stderr from orchestrator invocation
+ * @param extractedJson - Extracted JSON candidate if extraction succeeded
+ * @param schemaErrors - Ajv errors array when validation fails
+ * @param meta - Invocation metadata
+ * @param config - Envoi configuration
+ * @returns Promise that resolves when all artifacts are saved
+ * @throws {Error} If any write operation fails
+ */
+export async function persistOrchestratorFailure(runId, stdout, stderr, extractedJson, schemaErrors, meta, config) {
+    // Create orchestrator subdirectory under run history
+    const orchestratorPath = join(config.workspace_dir, config.history.dir, runId, 'orchestrator');
+    await mkdir(orchestratorPath, { recursive: true });
+    // Helper to write to orchestrator subdir
+    const writeArtifact = async (filename, content) => {
+        const filePath = join(orchestratorPath, filename);
+        if (typeof content === 'object') {
+            await atomicWriteJson(filePath, content);
+        }
+        else {
+            await atomicWriteText(filePath, content);
+        }
+    };
+    // Write stdout.txt (truncated to 200KB)
+    await writeArtifact('stdout.txt', truncateWithMarker(stdout, MAX_OUTPUT_SIZE));
+    // Write stderr.txt (truncated, create even if empty)
+    await writeArtifact('stderr.txt', truncateWithMarker(stderr || '', MAX_OUTPUT_SIZE));
+    // Write extracted.json if extraction succeeded
+    if (extractedJson !== null && extractedJson !== undefined) {
+        await writeArtifact('extracted.json', extractedJson);
+    }
+    // Write schema_error.json if validation failed
+    if (schemaErrors !== null && schemaErrors.length > 0) {
+        await writeArtifact('schema_error.json', schemaErrors);
+    }
+    // Write meta.json
+    await writeArtifact('meta.json', meta);
+}
+export async function getHistoryCount(config) {
+    const historyPath = resolveInWorkspace(config.workspace_dir, config.history.dir);
+    try {
+        const entries = await readdir(historyPath, { withFileTypes: true });
+        // Count only directories (each run_id is a directory)
+        return entries.filter((entry) => entry.isDirectory()).length;
+    }
+    catch (error) {
+        // If directory doesn't exist, return 0
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return 0;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/lib/history.js.map

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

package/dist/lib/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Envoi library utilities.
+ *
+ * This module exports all public utilities for the Envoi project.
+ */
+export { atomicWriteJson, atomicReadJson, cleanupTmpFiles, AtomicFsError, } from './fs.js';
+export { loadConfig, findConfigFile, validateConfig, ConfigError, CONFIG_FILE_NAME, } from './config.js';
+export { getBootId, isPidRunning, isLockStale, acquireLock, releaseLock, LockHeldError, } from './lock.js';
+export { isGitRepo, isWorktreeClean, getHeadCommit, getDiffFiles, getUntrackedFiles, getCurrentBranch, stashPilotFiles, popPilotStash, } from './git.js';
+export { runPreflight } from './preflight.js';
+export { generateRunId, createInitialState, transitionPhase, addError, setTask, setBuilderResult, appendStopHistory, clearForcePatch, setForcePatch, updateTaskFingerprint, recordTaskFailure, resetFailureStreak, appendVerifyHistory, incrementRetryCount, recordTransportStall, resetRetryState, } from './state.js';
+export { buildClaudeArgs, parseClaudeResponse, invokeClaudeCode, } from './claude.js';
+export { loadSchema, validateWithSchema, type ValidationResult, } from './schema.js';
+export { getTouchedTracked, getTouchedUntracked, getDiffStats, analyzeDiff, checkDiffLimits, formatBlastRadius, type DiffAnalysis, type DiffLimitCheckResult, } from './diff.js';
+export { matchesGlob, checkScopeViolations, SCOPE_VIOLATION_FORBIDDEN, SCOPE_VIOLATION_OUTSIDE_ALLOWED, NEW_FILE_FORBIDDEN, LOCKFILE_CHANGE_FORBIDDEN, type ScopeCheckResult, type ScopeViolation, } from './scope.js';
+export { interpolateArgs, executeVerification, runVerifications, validateParam, validateVerificationParams, type VerificationRun, type ParamValidationError, type ParamValidationResult, } from './verify.js';
+export { rollbackTracked, removeUntrackedPaths, rollback, rollbackToCommit, verifyCleanWorktree, type RollbackResult, type RollbackResultNew, } from './rollback.js';
+export { generateRunId as generateReportRunId, buildReport, writeReport, renderReportMarkdown, writeReportMarkdown, type TickReportData, } from './report.js';
+export { createHistorySnapshot, writeHistoryArtifact, snapshotRun, getHistoryCount, } from './history.js';
+export { buildBlockedData, writeBlocked, } from './blocked.js';
+export { invokeReviewer, parseReviewerOutput, checkReviewerAuth, } from './reviewer.js';
+export { checkHighRiskGlobs, checkDiffFraction, checkRepeatedStops, computeRiskFlags, shouldTriggerReviewer, type StopHistoryEntry, } from './risk.js';
+export { runReviewerIfNeeded, handleReviewerDecision, type ReviewerFlowContext, type ReviewerFlowResult, } from './reviewer-flow.js';
+export { checkCodexCli, type ReviewerDoctorResult, } from './doctor.js';
+export { canonicalizeTask, computeFingerprint, } from './fingerprint.js';
+export { checkBranchMatch, checkFingerprintMatch, checkWorktreeClean, runGuardrailPreflight, classifyVerifyResult, shouldEscalate, checkMergeEligibility, type GuardrailState, type PreflightResult as GuardrailPreflightResult, type VerifyResultType, type VerifyClassification, type EscalationDecision, type MergeEligibility, type MergeEligibilityReport, } from './guardrails.js';
+export { isTransportStall, createTransportStallError, invokeWithStallDetection, normalizeTransportError, isTransportStallError, type StallDetectionResult, type InvokeResult, type NormalizedError, } from './transport.js';
+export { handleTransportStall, checkAndHandleStall, formatStallResult, getRetryAction, computeRetryDecision, computeDegradedSettings, applyDegradedConfig, extractDegradationInputs, getDegradedConfigIfNeeded, canRetry, formatRetryDecision, getRecoveryPrompt, buildPromptWithRecovery, shouldResetRetryState, updateStateForOutcome, handleTickSuccess, handleTickStop, handleTickStall, MAX_RETRY_ATTEMPTS, RECOVERY_PROMPT, type StallHandlingResult, type StallHandlingOptions, type RetryAction, type DegradedSettings, type RetryDecision, type TickOutcome, } from './tick.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

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

package/dist/lib/index.js

@@ -0,0 +1,29 @@
+/**
+ * Envoi library utilities.
+ *
+ * This module exports all public utilities for the Envoi project.
+ */
+export { atomicWriteJson, atomicReadJson, cleanupTmpFiles, AtomicFsError, } from './fs.js';
+export { loadConfig, findConfigFile, validateConfig, ConfigError, CONFIG_FILE_NAME, } from './config.js';
+export { getBootId, isPidRunning, isLockStale, acquireLock, releaseLock, LockHeldError, } from './lock.js';
+export { isGitRepo, isWorktreeClean, getHeadCommit, getDiffFiles, getUntrackedFiles, getCurrentBranch, stashPilotFiles, popPilotStash, } from './git.js';
+export { runPreflight } from './preflight.js';
+export { generateRunId, createInitialState, transitionPhase, addError, setTask, setBuilderResult, appendStopHistory, clearForcePatch, setForcePatch, updateTaskFingerprint, recordTaskFailure, resetFailureStreak, appendVerifyHistory, incrementRetryCount, recordTransportStall, resetRetryState, } from './state.js';
+export { buildClaudeArgs, parseClaudeResponse, invokeClaudeCode, } from './claude.js';
+export { loadSchema, validateWithSchema, } from './schema.js';
+export { getTouchedTracked, getTouchedUntracked, getDiffStats, analyzeDiff, checkDiffLimits, formatBlastRadius, } from './diff.js';
+export { matchesGlob, checkScopeViolations, SCOPE_VIOLATION_FORBIDDEN, SCOPE_VIOLATION_OUTSIDE_ALLOWED, NEW_FILE_FORBIDDEN, LOCKFILE_CHANGE_FORBIDDEN, } from './scope.js';
+export { interpolateArgs, executeVerification, runVerifications, validateParam, validateVerificationParams, } from './verify.js';
+export { rollbackTracked, removeUntrackedPaths, rollback, rollbackToCommit, verifyCleanWorktree, } from './rollback.js';
+export { generateRunId as generateReportRunId, buildReport, writeReport, renderReportMarkdown, writeReportMarkdown, } from './report.js';
+export { createHistorySnapshot, writeHistoryArtifact, snapshotRun, getHistoryCount, } from './history.js';
+export { buildBlockedData, writeBlocked, } from './blocked.js';
+export { invokeReviewer, parseReviewerOutput, checkReviewerAuth, } from './reviewer.js';
+export { checkHighRiskGlobs, checkDiffFraction, checkRepeatedStops, computeRiskFlags, shouldTriggerReviewer, } from './risk.js';
+export { runReviewerIfNeeded, handleReviewerDecision, } from './reviewer-flow.js';
+export { checkCodexCli, } from './doctor.js';
+export { canonicalizeTask, computeFingerprint, } from './fingerprint.js';
+export { checkBranchMatch, checkFingerprintMatch, checkWorktreeClean, runGuardrailPreflight, classifyVerifyResult, shouldEscalate, checkMergeEligibility, } from './guardrails.js';
+export { isTransportStall, createTransportStallError, invokeWithStallDetection, normalizeTransportError, isTransportStallError, } from './transport.js';
+export { handleTransportStall, checkAndHandleStall, formatStallResult, getRetryAction, computeRetryDecision, computeDegradedSettings, applyDegradedConfig, extractDegradationInputs, getDegradedConfigIfNeeded, canRetry, formatRetryDecision, getRecoveryPrompt, buildPromptWithRecovery, shouldResetRetryState, updateStateForOutcome, handleTickSuccess, handleTickStop, handleTickStall, MAX_RETRY_ATTEMPTS, RECOVERY_PROMPT, } from './tick.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

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

package/dist/lib/json-extract.d.ts

@@ -0,0 +1,42 @@
+/**
+ * JSON extraction utilities for parsing LLM output.
+ *
+ * Handles common LLM output patterns:
+ * - Preamble text before JSON
+ * - Markdown code fences (```json ... ```)
+ * - Multiple JSON objects (takes first valid)
+ *
+ * @see F001, F002 in tests/lib/F001-json-extract.test.ts
+ */
+/**
+ * Result of JSON extraction attempt.
+ */
+export interface JsonExtractResult<T = unknown> {
+    /** Whether extraction succeeded */
+    success: boolean;
+    /** Parsed JSON data (null if failed) */
+    data: T | null;
+    /** Error message if failed */
+    error: string | null;
+    /** How the JSON was extracted: 'direct' | 'fence' | 'search' */
+    method: 'direct' | 'fence' | 'search' | null;
+}
+/**
+ * Attempts to extract JSON from text that may have preamble or code fences.
+ *
+ * Extraction strategies (in order):
+ * 1. Direct parse: Try JSON.parse on the entire string
+ * 2. Fence extraction: Look for ```json ... ``` blocks
+ * 3. Brace search: Find first { and matching } for object, or [ and ] for array
+ *
+ * @param text - Raw text that may contain JSON
+ * @returns Extraction result with parsed data or error
+ */
+export declare function extractJson<T = unknown>(text: string): JsonExtractResult<T>;
+/**
+ * Strict JSON extraction - only accepts direct parse.
+ *
+ * For cases where we need exact JSON output with no preamble.
+ */
+export declare function extractJsonStrict<T = unknown>(text: string): JsonExtractResult<T>;
+//# sourceMappingURL=json-extract.d.ts.map

package/dist/lib/json-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-extract.d.ts","sourceRoot":"","sources":["../../src/lib/json-extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,gEAAgE;IAChE,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CA6B3E;AA+ID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAajF"}

package/dist/lib/json-extract.js

@@ -0,0 +1,201 @@
+/**
+ * JSON extraction utilities for parsing LLM output.
+ *
+ * Handles common LLM output patterns:
+ * - Preamble text before JSON
+ * - Markdown code fences (```json ... ```)
+ * - Multiple JSON objects (takes first valid)
+ *
+ * @see F001, F002 in tests/lib/F001-json-extract.test.ts
+ */
+/**
+ * Attempts to extract JSON from text that may have preamble or code fences.
+ *
+ * Extraction strategies (in order):
+ * 1. Direct parse: Try JSON.parse on the entire string
+ * 2. Fence extraction: Look for ```json ... ``` blocks
+ * 3. Brace search: Find first { and matching } for object, or [ and ] for array
+ *
+ * @param text - Raw text that may contain JSON
+ * @returns Extraction result with parsed data or error
+ */
+export function extractJson(text) {
+    const trimmed = text.trim();
+    // Strategy 1: Direct parse
+    try {
+        const data = JSON.parse(trimmed);
+        return { success: true, data, error: null, method: 'direct' };
+    }
+    catch {
+        // Continue to next strategy
+    }
+    // Strategy 2: Extract from code fence
+    const fenceResult = extractFromFence(trimmed);
+    if (fenceResult.success) {
+        return fenceResult;
+    }
+    // Strategy 3: Search for JSON object or array
+    const searchResult = extractByBraceSearch(trimmed);
+    if (searchResult.success) {
+        return searchResult;
+    }
+    return {
+        success: false,
+        data: null,
+        error: `Failed to extract JSON from text. Tried direct parse, fence extraction, and brace search.`,
+        method: null,
+    };
+}
+/**
+ * Extracts JSON from markdown code fences.
+ *
+ * Supports:
+ * - ```json ... ```
+ * - ``` ... ``` (no language specifier)
+ *
+ * Takes the first valid JSON found in any fence.
+ */
+function extractFromFence(text) {
+    // Match ```json ... ``` or ``` ... ```
+    // Using non-greedy match and handling nested backticks
+    const fenceRegex = /```(?:json)?\s*\n?([\s\S]*?)\n?```/g;
+    let match;
+    while ((match = fenceRegex.exec(text)) !== null) {
+        const content = match[1].trim();
+        if (!content)
+            continue;
+        try {
+            const data = JSON.parse(content);
+            return { success: true, data, error: null, method: 'fence' };
+        }
+        catch {
+            // Try next fence
+            continue;
+        }
+    }
+    return {
+        success: false,
+        data: null,
+        error: 'No valid JSON found in code fences',
+        method: null,
+    };
+}
+/**
+ * Searches for JSON by finding balanced braces.
+ *
+ * Finds the first { or [ and its matching closing brace,
+ * respecting string escaping and nesting.
+ */
+function extractByBraceSearch(text) {
+    // Find first { or [
+    const objectStart = text.indexOf('{');
+    const arrayStart = text.indexOf('[');
+    let start;
+    let openChar;
+    let closeChar;
+    if (objectStart === -1 && arrayStart === -1) {
+        return {
+            success: false,
+            data: null,
+            error: 'No JSON object or array found',
+            method: null,
+        };
+    }
+    if (objectStart === -1) {
+        start = arrayStart;
+        openChar = '[';
+        closeChar = ']';
+    }
+    else if (arrayStart === -1) {
+        start = objectStart;
+        openChar = '{';
+        closeChar = '}';
+    }
+    else {
+        // Take whichever comes first
+        if (objectStart < arrayStart) {
+            start = objectStart;
+            openChar = '{';
+            closeChar = '}';
+        }
+        else {
+            start = arrayStart;
+            openChar = '[';
+            closeChar = ']';
+        }
+    }
+    // Find matching close brace
+    let depth = 0;
+    let inString = false;
+    let escapeNext = false;
+    let end = -1;
+    for (let i = start; i < text.length; i++) {
+        const char = text[i];
+        if (escapeNext) {
+            escapeNext = false;
+            continue;
+        }
+        if (char === '\\' && inString) {
+            escapeNext = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === openChar) {
+            depth++;
+        }
+        else if (char === closeChar) {
+            depth--;
+            if (depth === 0) {
+                end = i;
+                break;
+            }
+        }
+    }
+    if (end === -1) {
+        return {
+            success: false,
+            data: null,
+            error: 'Unbalanced braces in JSON',
+            method: null,
+        };
+    }
+    const jsonStr = text.slice(start, end + 1);
+    try {
+        const data = JSON.parse(jsonStr);
+        return { success: true, data, error: null, method: 'search' };
+    }
+    catch (e) {
+        return {
+            success: false,
+            data: null,
+            error: `Found JSON-like structure but parse failed: ${e instanceof Error ? e.message : String(e)}`,
+            method: null,
+        };
+    }
+}
+/**
+ * Strict JSON extraction - only accepts direct parse.
+ *
+ * For cases where we need exact JSON output with no preamble.
+ */
+export function extractJsonStrict(text) {
+    const trimmed = text.trim();
+    try {
+        const data = JSON.parse(trimmed);
+        return { success: true, data, error: null, method: 'direct' };
+    }
+    catch (e) {
+        return {
+            success: false,
+            data: null,
+            error: `JSON parse failed: ${e instanceof Error ? e.message : String(e)}`,
+            method: null,
+        };
+    }
+}
+//# sourceMappingURL=json-extract.js.map

package/dist/lib/json-extract.js.map

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