@kynver-app/runtime 0.1.90 → 0.1.91

package/dist/completion-ack.d.ts

@@ -6,5 +6,13 @@ export interface CompletionAckFields {
     completionResponse?: unknown;
 }
 export declare function hasCompletionAck(worker: HarnessWorkerRecord): boolean;
+/** True when AgentOS acknowledged completion and the board advanced (or was already terminal). */
+export declare function hasSuccessfulCompletionAck(worker: HarnessWorkerRecord): boolean;
+/**
+ * Finished workers with a prior completion POST that did not advance the board
+ * (rejected route, structural blocker) must be eligible for replay so fresher
+ * `finalResult` evidence can reach AgentOS.
+ */
+export declare function needsCompletionReplay(worker: HarnessWorkerRecord): boolean;
 export declare function persistCompletionAck(worker: HarnessWorkerRecord, runId: string, fields: CompletionAckFields): void;
 export declare function clearCompletionAck(worker: HarnessWorkerRecord, runId: string): void;

package/dist/completion-response.d.ts

@@ -1,5 +1,5 @@
 /** Parsed outcome from POST /harness/completion (AgentOS handleHarnessWorkerCompletion). */
-export type HarnessCompletionRouteOutcome = "review_scheduled" | "review_already_scheduled" | "needs_attention" | "mirror_only" | "task_not_found" | "task_not_harness" | "skipped_terminal_task";
+export type HarnessCompletionRouteOutcome = "review_scheduled" | "review_already_scheduled" | "needs_attention" | "mirror_only" | "task_not_found" | "task_not_harness" | "skipped_terminal_task" | "closed" | "dispatched" | "dispatch_already_done" | "blocked" | "reviewer_no_parent" | "landing_no_parent";
 export interface HarnessCompletionResponseSummary {
     routeOutcome: HarnessCompletionRouteOutcome | null;
     /** True when the board task should have moved into review (or already was). */

package/dist/db-credential-env-paths.d.ts

@@ -0,0 +1,13 @@
+/** Expand a leading `~/` for filesystem use. */
+export declare function expandHomePath(filePath: string): string;
+/**
+ * Candidate `.env` paths for selective production DB key reads.
+ * Order: explicit `KYNVER_ENV_FILE` → walk up from `cwd` → `~/.kynver/.env` →
+ * `defaultRepo` from `~/.kynver/config.json`.
+ */
+export declare function discoverProductionDbEnvFilePaths(options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    /** Injectable for tests; defaults to `os.homedir()`. */
+    homeDir?: string;
+}): string[];

package/dist/db-credential-resolver.d.ts

@@ -29,7 +29,8 @@ export interface ResolveProductionDatabaseOptions {
 export declare function readProductionDbKeysFromEnvFile(envPath: string): Partial<Record<(typeof ENV_FILE_KEYS)[number], string>>;
 /**
  * Resolve a production Prisma `DATABASE_URL` at CLI execution time.
- * Precedence: Neon CLI → explicit process env → selective `.env` keys only.
+ * Precedence: Neon CLI → explicit process env → selective `.env` keys
+ * (`KYNVER_ENV_FILE`, walk-up from cwd, `~/.kynver/.env`, `defaultRepo/.env`).
  */
 export declare function resolveProductionDatabaseUrl(options?: ResolveProductionDatabaseOptions): ResolveProductionDatabaseResult;
 /** Set `process.env.DATABASE_URL` from resolver; logs source + host hint to stderr (no secrets). */

package/dist/default-repo-cli.d.ts

@@ -0,0 +1,20 @@
+import { presentUserConfig } from "./config.js";
+import { formatResolvedDefaultRepo, type ResolvedDefaultRepo } from "./default-repo.js";
+export interface EnsureDefaultRepoResult {
+    ok: boolean;
+    remediated: boolean;
+    alreadyPersisted: boolean;
+    configPath: string;
+    resolved: ReturnType<typeof formatResolvedDefaultRepo> | null;
+    config?: ReturnType<typeof presentUserConfig>;
+    reason?: string;
+    remediation?: string;
+}
+export declare function ensureDefaultRepo(opts?: {
+    cwd?: string;
+}): EnsureDefaultRepoResult;
+export declare function runEnsureDefaultRepoCli(json?: boolean): void;
+export declare function summarizeResolvedDefaultRepo(resolved: ResolvedDefaultRepo | null): {
+    status: "pass" | "warn";
+    remediation?: string;
+};

package/dist/dispatch-claim-release.d.ts

@@ -0,0 +1,17 @@
+export interface ReleaseDispatchClaimInput {
+    baseUrl: string;
+    secret: string;
+    agentOsId: string;
+    taskId: string;
+    leaseOwner: string;
+    failureDetail?: string;
+}
+export interface ReleaseDispatchClaimOutcome {
+    released: boolean;
+    releaseResponse: unknown;
+    httpOk: boolean;
+}
+/**
+ * Hand a dispatch-next lease back to the board when local worker spawn did not start.
+ */
+export declare function releaseDispatchClaimAfterSpawnFailure(input: ReleaseDispatchClaimInput): Promise<ReleaseDispatchClaimOutcome>;

package/dist/dispatch-lane-normalization.d.ts

@@ -0,0 +1,14 @@
+/** Runtime mirror of server dispatch lane normalization (keep in sync). */
+export type DispatchNextLane = "implementation" | "review" | "landing" | "any";
+export type DispatchLaneTaskHints = {
+    title?: string | null;
+    executorRef?: string | null;
+    personaSlug?: string | null;
+    status?: string | null;
+    roleLane?: string | null;
+};
+export declare function roleLaneToDispatchLane(roleLane: string | null | undefined): DispatchNextLane | null;
+export declare function normalizeDispatchNextLaneFilter(raw: string | null | undefined): DispatchNextLane | undefined;
+export declare function inferRoleLaneFromTaskHints(task: DispatchLaneTaskHints): string | null;
+export declare function inferTaskDispatchLane(task: DispatchLaneTaskHints): DispatchNextLane;
+export declare function resolveDispatchNextLaneFilter(raw: string | null | undefined): DispatchNextLane;

package/dist/dispatch.d.ts

@@ -1,5 +1,5 @@
 import { runDirectory } from "./run-store.js";
-import type { HarnessMemoryQualityCaptureSnapshot, InstructionPolicyEvidenceSnapshot, PersonaContextEvidenceSnapshot } from "./status.js";
+import type { ContextEnvelopeEvidenceSnapshot, HarnessMemoryQualityCaptureSnapshot, InstructionPolicyEvidenceSnapshot, PersonaContextEvidenceSnapshot } from "./status.js";
 export declare const DEFAULT_DISPATCH_LEASE_MS: number;
 export interface HarnessWorkerDispatchContext {
     instructionPolicyMarkdown: string | null;
@@ -11,6 +11,9 @@ export interface HarnessWorkerDispatchContext {
     personaSlug: string | null;
     personaEvidence: PersonaContextEvidenceSnapshot | null;
     personaInjectionReady: boolean;
+    contextEnvelopeMarkdown: string | null;
+    contextEnvelopeEvidence: ContextEnvelopeEvidenceSnapshot | null;
+    contextEnvelopeReady: boolean;
 }
 export declare function readHarnessWorkerContext(decision: Record<string, unknown>): HarnessWorkerDispatchContext | null;
 export declare function buildDispatchTaskText(task: Record<string, unknown>, agentOsId: string): string;

package/dist/doctor/doctor.types.d.ts

@@ -22,4 +22,6 @@ export interface RuntimeTakeoverDoctorReport {
         fail: number;
     };
     sections: DoctorSection[];
+    /** Optional remediation actions applied before this report was generated. */
+    notes?: string[];
 }

package/dist/doctor/runtime-takeover-cli.d.ts

@@ -1 +1 @@
-export declare function runRuntimeTakeoverDoctorCli(): void;
+export declare function runRuntimeTakeoverDoctorCli(args?: Record<string, string | boolean>): void;

package/dist/doctor/runtime-takeover-scheduler.d.ts

@@ -22,6 +22,8 @@ export interface RuntimeTakeoverSchedulerContext {
  * Scheduler readiness for runtime takeover.
  *
  * Runner hosts drive dispatch via `kynver daemon` → `pipeline-tick` → `operator/tick`
- * and must not depend on OpenClaw cron. Server/hosted deploys should resolve to QStash.
+ * and must not depend on OpenClaw cron. Server/hosted deploys should resolve to QStash
+ * when configured; otherwise the Kynver-owned `kynver-cron` provider is the fallback
+ * (not the legacy OpenClaw adapter).
  */
 export declare function assessRuntimeTakeoverScheduler(env: RuntimeTakeoverSchedulerEnv, ctx: RuntimeTakeoverSchedulerContext): DoctorCheck;

package/dist/heartbeat-final-result.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Prefer an explicit heartbeat `finalResult`, else structured JSON embedded in
+ * `summary`, else the summary string (legacy contract).
+ */
+export declare function terminalFinalResultFromHeartbeatRow(row: Record<string, unknown>): unknown;

package/dist/heartbeat.d.ts

@@ -4,6 +4,8 @@ export interface ParsedHeartbeat {
     lastHeartbeatAt: string | null;
     lastHeartbeatPhase: string | null;
     lastHeartbeatSummary: string | null;
+    /** Structured finalResult from the terminal `phase: complete` heartbeat line. */
+    terminalFinalResult: unknown;
     heartbeatBlocker: string | null;
     timestampAnomalies: ParsedHeartbeatTimestampAnomaly[];
     lastBoxResourceSnapshot: RuntimeBoxResourceSnapshot | null;
@@ -21,5 +23,5 @@ export declare function isTerminalHeartbeatPhase(phase: string | null | undefine
  * treat the worker's completion heartbeat as a synthetic final result so lifecycle
  * sync, completion replay, and resource gates advance.
  */
-export declare function terminalFinalResultFromHeartbeat(heartbeat: ParsedHeartbeat): string | null;
+export declare function terminalFinalResultFromHeartbeat(heartbeat: ParsedHeartbeat): unknown;
 export declare function parseHeartbeat(file: string): ParsedHeartbeat;

package/dist/index.d.ts

@@ -1,10 +1,13 @@
 export { PACKAGE_VERSION } from "./package-version.js";
+export { MEMORY_COST_PACKAGE_MIN_VERSIONS, MEMORY_COST_MANAGED_PACKAGES, MemoryCostPackageVersionGuardError, assertMemoryCostPackageVersionGuard, compareSemver, evaluateMemoryCostPackageVersionGuard, formatMemoryCostPackageGuardError, probeRepoPackageVersions, semverAtLeast, type MemoryCostManagedPackageName, type MemoryCostPackageGuardResult, type MemoryCostPackageGuardRow, } from "./memory-cost-package-version-guard.js";
+export { buildMemoryCostPackageGuardInput, enforceMemoryCostPackageGuardAtStartup, evaluateMemoryCostPackageGuardAtStartup, shouldEnforceMemoryCostPackageGuardCli, } from "./memory-cost-package-version-guard-enforce.js";
 export { buildDispatchTaskText, dispatchRun, DEFAULT_DISPATCH_LEASE_MS } from "./dispatch.js";
 export { observeRunnerDiskGate } from "./disk-gate.js";
 export { isWslHost, observeWslHostDisk, summarizeWslRecoverySteps, DEFAULT_WSL_HOST_MOUNT, DEFAULT_WSL_HOST_WARN_FREE_BYTES, DEFAULT_WSL_HOST_CRITICAL_FREE_BYTES, type WslHostDiskShape, } from "./wsl-host.js";
 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 { 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";
@@ -14,6 +17,7 @@ export { isEngagementRequiredSkip } from "./fortress-engagement-gate.js";
 export { assessWorkerLandingContract, landingContractAttentionReason, type WorkerLandingContract, type WorkerLandingContractVerdict, type TargetPrReconciliation, } from "./landing-contract-gate.js";
 export { assessExitedWorkerSalvage, type ExitedSalvageAssessment, type ExitedSalvageKind, } from "./exited-salvage.js";
 export { buildPrompt } from "./prompt.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";
 export { normalizeCursorModelAlias, preflightClaudeModel, preflightCodexModel, preflightCursorModel, } from "./providers/model-preflight.js";
 export { CODEX_DEFAULT_MODEL, codexProvider, buildCodexExecArgv } from "./providers/codex.js";
@@ -21,12 +25,14 @@ export { HERMES_OPENAI_CODEX_DEFAULT_MODEL, hermesCodexProvider, buildHermesOpen
 export { classifyOpenAiCodexError, formatCronJobDeliveryFailure, formatOpenAiCodexFailureNotice, redactProviderErrorText, resolveOpenAiCodexRetryBudget, TRANSIENT_OPENAI_CODEX_ERROR_CLASSES, OPENAI_CODEX_PROVIDER, type ClassifiedOpenAiCodexError, type CodexFailureNoticeInput, type OpenAiCodexErrorClass, } from "./providers/openai-codex-resilience.js";
 export * from "./cron/hermes-provider-notice.js";
 export { buildOrchestrationProviderInventory, classifyOrchestrationRisk, compareProviderCandidates, getOrchestrationProviderCapability, listOrchestrationProviderCapabilities, probeClaudeOAuthBinding, probeCodexOAuthBinding, probeCursorOAuthBinding, probeHermesCliAdapter, probeHermesOpenAiCodexBinding, probeOrchestrationProviderBinding, providerCapableForRisk, resolveCodexOrchestrationAdapter, resolveOrchestrationRouting, selectCheapestCapableProvider, sanitizeOrchestrationAudit, orchestrationAuditForWorkerJson, type CodexOrchestrationAdapterStatus, type CodexOrchestrationPath, type HermesCliAdapterStatus, type HermesOpenAiCodexBindingStatus, type OrchestrationAuthSource, type OrchestrationCloudApiCredits, type OrchestrationCostTier, type OrchestrationProviderBindingStatus, type OrchestrationProviderCapability, type OrchestrationProviderId, type OrchestrationProviderInventory, type OrchestrationRiskClass, type OrchestrationRoutingAudit, type OrchestrationRoutingDecision, } from "./orchestration-providers/index.js";
+export { ORCHESTRATION_POLICY_MODES, ORCHESTRATION_ACTION_KINDS, ORCHESTRATION_POLICY_DECISIONS, resolveOrchestrationPolicyMode, isOrchestrationEnforceTasksEnabled, buildForegroundHarnessIdempotencyKey, evaluateOrchestrationPolicy, type OrchestrationPolicyMode, type OrchestrationActionKind, type OrchestrationPolicyDecision, type OrchestrationPolicyEvaluateInput, type OrchestrationPolicyEvaluateResult, } from "./orchestration-enforcement/index.js";
 export { DEFAULT_WORKER_PROVIDER, enforceCursorWorkerProvider, isClaudeFamilyProvider, preferCursorExecutor, resolveConfiguredWorkerProvider, taskAllowsClaudeWorker, type EnforceCursorWorkerProviderInput, } from "./worker-provider-policy.js";
 export { redactHarness } from "./redact.js";
 export { scrubWorkerEnv, scrubClaudeEnv, auditWorkerEnv, listForbiddenWorkerEnvKeys, isForbiddenWorkerEnvKey, FORBIDDEN_WORKER_ENV_KEYS, type WorkerEnvAudit, } from "./worker-env.js";
+export { discoverProductionDbEnvFilePaths, expandHomePath } from "./db-credential-env-paths.js";
 export { applyProductionDatabaseToProcess, readProductionDbKeysFromEnvFile, resolveProductionDatabaseUrl, type DbCredentialResolution, type DbCredentialFailure, type DbCredentialSource, type ResolveProductionDatabaseResult, type ResolveProductionDatabaseOptions, } from "./db-credential-resolver.js";
 export { safeDatabaseUrlHint } from "./db-url-hint.js";
-export { validateRunId, validateWorkerName, validateRepo, validateOwnedPaths, validateTailLines, } from "./validate.js";
+export { validateRunId, validateWorkerName, validateRepo, validateOwnedPaths, validateTailLines, resolveWorkerTargetArgs, resolveRunTargetArg, } from "./validate.js";
 export { spawnWorkerProcess, startWorker } from "./supervisor.js";
 export { createRun, listRuns } from "./worktree.js";
 export { buildRunListRows, listRunsCli, type RunListFinalizeBlockedReason, type RunListRow, type RunListWorkerEvidence, } from "./run-list.js";