@kynver-app/runtime 0.2.1 → 0.2.8

package/dist/context-preview/chat-memory-preview.d.ts

@@ -0,0 +1,33 @@
+/** Shared with app memory-retrieval.constants — single source for MCP + server preview blocks. */
+export declare const MEMORY_LANE_PREVIEW_CHARS = 160;
+export interface ContextPreviewMemoryItem {
+    slug: string;
+    lane?: string | null;
+    trust?: string | null;
+    contentPreview: string;
+    selectedBecause?: string | null;
+    expansionRoute?: string | null;
+    expandable?: boolean;
+}
+export interface ContextPreviewBlockInput {
+    sectionTitle: string;
+    items: ContextPreviewMemoryItem[];
+    emptyFallback?: string;
+    previewCharsPerItem?: number;
+}
+/** Compact preview block — handles-first, never full memory bodies. */
+export declare function formatContextPreviewMemoryBlock(input: ContextPreviewBlockInput): string;
+export declare function chatMemoriesToPreviewItems(memories: {
+    content: string;
+    similarity?: number;
+}[]): ContextPreviewMemoryItem[];
+/** Legacy chat memory block — flag-invariant (PR1 baseline capture, diagnostics). */
+export declare function buildLegacyChatMemorySection(memories: {
+    content: string;
+    similarity?: number;
+}[]): string;
+/** Shadow chat preview — ignores dark flag (diagnostics / MCP comparison). */
+export declare function buildChatMemoryShadowPreview(memories: {
+    content: string;
+    similarity?: number;
+}[]): string;

package/dist/doctor/local-store-cli.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `kynver doctor local-store [--no-probe]` — report-only in D0: always exits
+ * 0 (no surface consults the store yet, so nothing may gate on this); the
+ * posture lives in the printed report.
+ *
+ * The default openability probe CREATES `local-run-store.sqlite` under the
+ * harness root on a host that never opened it (inert — nothing reads it with
+ * flags off). Pass `--no-probe` to report current lifecycle state without
+ * touching disk.
+ */
+export declare function runLocalStoreDoctorCli(args?: Record<string, unknown>): void;

package/dist/doctor/local-store.d.ts

@@ -0,0 +1,35 @@
+import { type LocalRunStoreLifecycleStatus } from "../local-run-store/store-lifecycle.js";
+import { type LocalRunStoreSurfaceMode } from "../local-run-store/surface-flags.js";
+export interface LocalStoreQuarantineEntry {
+    file: string;
+    mtime: string | null;
+}
+export interface LocalStoreDoctorReport {
+    command: "doctor local-store";
+    contractVersion: 1;
+    harnessRoot: string;
+    store: {
+        state: LocalRunStoreLifecycleStatus["state"];
+        databasePath: string | null;
+        schemaVersion: number | null;
+        recovered: boolean;
+        quarantinedTo: string | null;
+        reason: string | null;
+    };
+    surfaces: Array<{
+        key: string;
+        env: string;
+        milestone: string;
+        mode: LocalRunStoreSurfaceMode;
+        /** env override / server-delivered policy / default off. */
+        source: "env" | "server" | "default";
+    }>;
+    flagWarnings: string[];
+    /** `*.quarantine-*` artifacts under the harness root (offline inspection). */
+    quarantineHistory: LocalStoreQuarantineEntry[];
+}
+export declare function buildLocalStoreDoctorReport(options?: {
+    env?: NodeJS.ProcessEnv;
+    /** Skip the open probe (report current lifecycle state only). */
+    probe?: boolean;
+}): LocalStoreDoctorReport;

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export { cleanupWslCrashDumps, shouldAutoCleanupWslCrashDumps, type WslCrashDump
 export { postJson, type DispatchNextDiskGateShape, type DispatchNextWslHostShape, } from "./callbacks.js";
 export { parseClaudeStream, parseHarnessStream, summarizeEvent, summarizeShellToolCallEvent, } from "./stream.js";
 export { classifyNpmAuditOutcome, classifyShellCommandOutcome, summarizeNpmAuditReport, type NpmAuditSummary, type ShellCommandOutcome, type ShellCommandOutcomeKind, } from "./shell-command-outcome.js";
-export { classifyRepoSearchMeta, diagnoseRepoSearchFailure, extractSearchMeta, extractSearchMetaFromToolLine, formatRepoSearchGuidance, isRgExcludeScopeTarget, isSingleFileSearchTarget, metaToNormalizedRgCommand, normalizeRepoSearchCommand, normalizeRgArgv, type RepoSearchContext, type RepoSearchKind, } from "./repo-search.js";
+export { classifyRepoSearchMeta, diagnoseRepoSearchFailure, extractSearchMeta, extractSearchMetaFromToolLine, formatRepoSearchGuidance, isRgExcludeScopeTarget, isSingleFileSearchTarget, metaToNormalizedRgCommand, normalizeRepoSearchCommand, normalizeRgArgv, shouldTreatRgNoMatchAsSuccess, unwrapShellWrapperCommand, type RepoSearchContext, type RepoSearchKind, } from "./repo-search.js";
 export { parseHeartbeat, isTerminalHeartbeatPhase, terminalFinalResultFromHeartbeat, } from "./heartbeat.js";
 export { buildBoxResourceSnapshotFromGate, formatHeartbeatLine, type RuntimeBoxResourceSnapshot, type RuntimeBoxResourceSnapshotPrEvidence, type HeartbeatLineInput, } from "./box-resource-snapshot.js";
 export { resolveBoxKindFromEnv, defaultBoxId } from "./box-resource-snapshot-shared.js";
@@ -21,6 +21,7 @@ export { assessExitedWorkerSalvage, type ExitedSalvageAssessment, type ExitedSal
 export { persistExitedWorkerHandoffCapture, resolveExitedWorkerFinalResult, type ExitedHandoffCapture, type ExitedHandoffCaptureSource, } from "./exited-worker-handoff-capture.js";
 export { buildPrompt, buildPromptWithReceipt, RUNTIME_PROMPT_ENFORCEMENT, type BuildPromptInput, } from "./prompt.js";
 export { RUNTIME_CONTEXT_BUDGET_RECEIPT_SCHEMA_VERSION, RUNTIME_CONTEXT_BUDGET_RECEIPT_V2_SCHEMA_VERSION, buildContextBudgetReceiptV2, estimateTokensFromChars, finalizeReceiptTotals, isRuntimeContextBudgetReceiptV2, sectionReceiptFromMarkdown, upgradeReceiptToV2, type BuildContextBudgetReceiptV2Input, type ContextBudgetReceiptSurface, type ContextEnvelopeMode, type RuntimeContextActiveStateLookup, type RuntimeContextActiveStateLookupKind, type RuntimeContextActiveStateLookupStatus, type RuntimeContextBudgetReceipt, type RuntimeContextBudgetReceiptSchemaVersion, type RuntimeContextBudgetReceiptV2, type RuntimeContextRehydrationKind, type RuntimeContextRehydrationRoute, type RuntimeContextSection, type RuntimeContextSectionReceipt, type UsefulContextCoverage, } from "./context-budget-receipt.js";
+export { MEMORY_LANE_PREVIEW_CHARS, buildChatMemoryShadowPreview, buildLegacyChatMemorySection, chatMemoriesToPreviewItems, formatContextPreviewMemoryBlock, type ContextPreviewBlockInput, type ContextPreviewMemoryItem, } from "./context-preview/chat-memory-preview.js";
 export { canonicalJsonStringify, computeInstructionBundleVersion, deriveInstructionBundleKeyId, parseRawEd25519Key, isSignedInstructionBundleShape, PINNED_INSTRUCTION_BUNDLE_PUBLIC_KEYS, resolveInstructionBundlePublicKey, verifyInstructionBundleSignatureWithKey, verifySignedInstructionBundle, EMBEDDED_INSTRUCTION_BUNDLE, EMBEDDED_INSTRUCTION_BUNDLE_VERSION, getActiveInstructionBundle, getActiveInstructionBundleSource, getActiveInstructionBundleVersion, setActiveInstructionBundle, resolveInstructionText, resolvePolicyThreshold, resolveBundlePersona, ensureInstructionBundle, instructionBundleCachePath, loadInstructionBundleCache, saveInstructionBundleCache, INSTRUCTION_BUNDLE_REFRESH_TTL_MS, type InstructionBundle, type InstructionBundleContent, type InstructionBundlePersona, type SignedInstructionBundle, type InstructionBundleSource, type InstructionBundleVerifyResult, type EnsureInstructionBundleOptions, type EnsureInstructionBundleResult, } from "./instruction-bundle/index.js";
 export { WORKER_PERSONA_CATALOG, getWorkerPersonaCatalogEntry, getPersonaDispatchLane, getPersonaDefaultRoleLane, isKnownWorkerPersonaSlug, workerPersonaReviewSlugs, workerPersonaLandingSlugs, type WorkerPersonaCatalogEntry, type WorkerPersonaCatalogSlug, type WorkerPersonaDispatchLane, type WorkerPersonaDefaultRoleLane, } from "./worker-persona-catalog.js";
 export { assessPrHandoffRequirement, ensurePrReadyHandoff, extractPrUrlFromText, } from "./pr-handoff/index.js";
@@ -73,7 +74,7 @@ export { runBoundedBuildCheck, assessBuildAdmission, mergeNodeOptionsForBuildChe
 export { assessHeavyVerificationGate, countActiveHeavyVerificationSlots, isHeavyVerificationGateSkipped, listActiveHeavyVerificationSlots, reclaimStaleHeavyVerificationSlots, releaseHeavyVerificationSlot, resolveHeavyVerificationMaxConcurrent, tryAcquireHeavyVerificationSlot, waitForHeavyVerificationSlot, DEFAULT_HEAVY_VERIFICATION_MAX_CONCURRENT, classifyHeavyShellCommand, gateWorkerShellCommand, HEAVY_VERIFICATION_TOKEN_REQUIRED, type HeavyCommandClass, type HeavyCommandClassification, type HeavyVerificationGateVerdict, type HeavyVerificationSlotRecord, type WorkerCommandGateOutcome, type WorkerCommandGateResult, } from "./heavy-verification/index.js";
 export { assessAutoCompleteEligibility, classifyWorkerHealth, getMonitorStatus, listMonitors, runMonitorTick, spawnMonitorSidecar, type AutoCompleteAssessment, type MonitorTickResult, type TaskLeaseSnapshot, type WorkerHealthClass, type WorkerMonitorView, } from "./monitor/index.js";
 export { formatHarnessToolReadable, formatMonitorTickNotice, formatAutoCompleteOutcomeNotice, formatWorkerStatusNotice, formatWorkerCompleteNotice, joinHarnessNotice, type HarnessReadableNotice, type HarnessToolFormatContext, } from "./harness-notice/index.js";
-export { persistPlan, drainPlanOutbox, listOutboxItems, formatPlanOutboxHandoffBlock, extractPlanOutboxFromTask, hashPlanBody, type PersistPlanInput, type PersistPlanResult, type PlanPersistUserStatus, } from "./plan-persist/index.js";
+export { persistPlan, drainPlanOutbox, listOutboxItems, writeOutboxItem, formatPlanOutboxHandoffBlock, extractPlanOutboxFromTask, hashPlanBody, type PersistPlanInput, type PersistPlanResult, type PlanPersistUserStatus, } from "./plan-persist/index.js";
 export { classifyVercelUrl, collectVercelEvidence, evidenceFromGitHubVercelStatus, isDashboardVercelUrl, isInspectableVercelTarget, isVercelStatusContext, pickVercelStatusContext, resolveVercelInspectTarget, type CollectVercelEvidenceInput, type GitHubCommitStatusRow, type VercelEvidenceResult, type VercelEvidenceStatus, } from "./vercel/index.js";
 export { validateJobEnvelope, type LocalCodexJobEnvelope, type LocalCodexJobToolPolicy, type JobEnvelopeValidationError, type JobEnvelopeValidationResult, } from "./byoc/job-envelope.js";
 export { verifyLocalCodexGoldenPath, formatGoldenPathFailureNotice, type GoldenPathCheckCode, type GoldenPathAuditEvidence, type GoldenPathOptions, type GoldenPathResult, } from "./byoc/m6-golden-path.js";
@@ -81,3 +82,4 @@ export { AGENT_RUNTIME_ENVELOPE_SCHEMA_VERSION, AGENT_RUNTIME_ENVELOPE_SCHEMA_VE
 export { evaluateNodeRuntimePolicy, KYNVER_NODE_PATCH_FLOOR, PUBLISHED_NODE_RANGE, PRIVATE_ROOT_NODE_RANGE, type NodeRuntimePolicyStatus, type NodeRuntimePolicyVerdict, } from "./node-runtime-policy.js";
 export { buildRuntimeIdentity, type RuntimeIdentityV1 } from "./runtime-identity.js";
 export { buildNodeRuntimeDoctorReport, type NodeRuntimeDoctorReport } from "./doctor/node-runtime.js";
+export { readJson, writeJson } from "./util.js";