@kynver-app/runtime 0.2.0 → 0.2.4

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/daemon-supervision/index.d.ts

@@ -3,3 +3,4 @@ export { buildDaemonSupervisionPolicy, defaultSupervisionOwner, formatSupervisio
 export { applyDaemonSupervisionSetup, defaultSystemdUserUnitPath, isSystemdSupervisionInstalled, supervisionOwnerForDoctor, type DaemonSupervisionSetupResult, } from "./setup.js";
 export { ensureDaemonSupervisionForStart, formatSystemdDelegationGuidance, shouldDelegateStartToSystemd, summarizeSupervisionForStart, type EnsureDaemonSupervisionInput, type EnsureDaemonSupervisionResult, } from "./start.js";
 export { assessDaemonSupervisionChecks, type AssessDaemonSupervisionOptions, type DaemonSupervisionVerifyCheck, } from "./verify.js";
+export { assessSupervisionHealth, type SupervisionHealth } from "./supervision-health.js";

package/dist/daemon-supervision/supervision-health.d.ts

@@ -0,0 +1,20 @@
+import type { KynverUserConfig } from "../config.js";
+import type { DaemonSupervisionOwner } from "./policy.js";
+export interface SupervisionHealthOptions {
+    envFilePath?: string;
+    /** Injectable for tests. */
+    systemdUnitActive?: () => boolean;
+}
+export interface SupervisionHealth {
+    owner: DaemonSupervisionOwner | null;
+    daemonPresentSignal: boolean;
+    systemdUnitInstalled: boolean;
+    systemdUnitActive: boolean;
+    /** True when restart policy is persisted or inferable from a healthy supervised daemon. */
+    effectivelyConfigured: boolean;
+}
+/**
+ * Infer whether a keeper/systemd-owned daemon is already healthy on this host,
+ * so doctor checks avoid stale warnings on upgraded installs.
+ */
+export declare function assessSupervisionHealth(config: KynverUserConfig, options?: SupervisionHealthOptions): SupervisionHealth;

package/dist/daemon-supervision/verify.d.ts

@@ -2,6 +2,7 @@ import type { KynverUserConfig } from "../config.js";
 export interface AssessDaemonSupervisionOptions {
     /** Override for tests; defaults to ~/.kynver/.env */
     envFilePath?: string;
+    systemdUnitActive?: () => boolean;
 }
 export interface DaemonSupervisionVerifyCheck {
     id: string;

package/dist/doctor/github-readiness.d.ts

@@ -0,0 +1,16 @@
+import type { CommandProbeResult } from "./runtime-takeover.probes.js";
+export type GitHubReadinessSource = "env" | "gh-cli" | "missing";
+export interface GitHubReadinessProbe {
+    envGithubToken?: boolean;
+    envGhToken?: boolean;
+    ghAuthToken(): CommandProbeResult;
+}
+export interface GitHubReadinessResult {
+    viable: boolean;
+    source: GitHubReadinessSource;
+    summary: string;
+}
+/**
+ * Read-only GitHub auth probe for doctor checks. Never prints or persists tokens.
+ */
+export declare function probeGitHubReadiness(probe: GitHubReadinessProbe): GitHubReadinessResult;

package/dist/doctor/runtime-takeover-deploy-evidence.d.ts

@@ -0,0 +1,9 @@
+import type { DoctorSection } from "./doctor.types.js";
+import { type GitHubReadinessProbe } from "./github-readiness.js";
+import type { RuntimeTakeoverProbes } from "./runtime-takeover.probes.js";
+/**
+ * Optional deploy-evidence checks for merge-gate / PR handoff workflows.
+ * Core runtime takeover does not require Vercel CLI or VERCEL_TOKEN when GitHub
+ * commit-status evidence is viable.
+ */
+export declare function assessDeployEvidence(probes: RuntimeTakeoverProbes, githubProbe: GitHubReadinessProbe): DoctorSection;

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

@@ -36,5 +36,10 @@ export interface RuntimeTakeoverProbes {
     legacyOpenclawHarnessRoot(): string;
     pathExists(target: string): boolean;
     pathWritable(target: string): boolean;
+    ghAuthToken(): CommandProbeResult;
+    /** When false, GitHub/Vercel deploy-evidence checks are advisory-only skips. */
+    deployEvidenceNeedsGithub?(): boolean;
+    /** Injectable systemd active probe for supervision checks. */
+    systemdDaemonActive?(): boolean;
 }
 export declare const defaultRuntimeTakeoverProbes: RuntimeTakeoverProbes;

package/dist/index.d.ts

@@ -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";