@kynver-app/runtime 0.1.90 → 0.1.91

package/dist/landing-contract-pr-classify.d.ts

@@ -0,0 +1,4 @@
+import type { TargetPrReconciliation } from "./landing-contract-gate.js";
+export type WorkerReconciliationPrRole = "contract" | "support" | "unrelated";
+export declare function classifyWorkerReconciliationPrRole(prUrl: string, targetPrUrls: readonly string[], entry?: TargetPrReconciliation | null): WorkerReconciliationPrRole;
+export declare function unrelatedWorkerReconciliationPrUrls(reconciliation: readonly TargetPrReconciliation[], targetPrUrls: readonly string[]): string[];

package/dist/memory-cost-package-version-guard-enforce.d.ts

@@ -0,0 +1,10 @@
+import { evaluateMemoryCostPackageVersionGuard, type MemoryCostManagedPackageName, type MemoryCostPackageGuardResult } from "./memory-cost-package-version-guard.js";
+export declare function buildMemoryCostPackageGuardInput(input?: {
+    cwd?: string;
+    repoRoot?: string;
+    selfPackageName?: MemoryCostManagedPackageName;
+    selfVersion?: string;
+}): Promise<Parameters<typeof evaluateMemoryCostPackageVersionGuard>[0]>;
+export declare function evaluateMemoryCostPackageGuardAtStartup(input?: Parameters<typeof buildMemoryCostPackageGuardInput>[0]): Promise<MemoryCostPackageGuardResult>;
+export declare function enforceMemoryCostPackageGuardAtStartup(input?: Parameters<typeof buildMemoryCostPackageGuardInput>[0]): Promise<MemoryCostPackageGuardResult>;
+export declare function shouldEnforceMemoryCostPackageGuardCli(scope?: string, action?: string): boolean;

package/dist/memory-cost-package-version-guard.d.ts

@@ -0,0 +1,49 @@
+/** Minimum versions that ship MARM memory cost controls (PR #1159). */
+export declare const MEMORY_COST_PACKAGE_MIN_VERSIONS: {
+    readonly "@kynver-app/runtime": "0.1.83";
+    readonly "@kynver-app/openclaw-agent-os": "0.1.43";
+    readonly "@kynver-app/mcp-agent-os": "0.3.34";
+};
+export type MemoryCostManagedPackageName = keyof typeof MEMORY_COST_PACKAGE_MIN_VERSIONS;
+export declare const MEMORY_COST_MANAGED_PACKAGES: MemoryCostManagedPackageName[];
+export type MemoryCostVersionSource = "self" | "installed" | "repo" | "unknown";
+export interface MemoryCostPackageVersionCandidate {
+    version: string;
+    source: MemoryCostVersionSource;
+    path?: string;
+}
+export interface MemoryCostPackageGuardRow {
+    packageName: MemoryCostManagedPackageName;
+    displayName: string;
+    minimumVersion: string;
+    effectiveVersion: string | null;
+    effectiveSource: MemoryCostVersionSource;
+    ok: boolean;
+    summary: string;
+    remediation: string[];
+}
+export interface MemoryCostPackageGuardResult {
+    ok: boolean;
+    summary: string;
+    packages: MemoryCostPackageGuardRow[];
+}
+/** Parse `major.minor.patch`; pre-release/build suffixes are ignored. */
+export declare function parseSemverParts(version: string): [number, number, number] | null;
+/** Returns 1 if a > b, -1 if a < b, 0 if equal or either unparsable. */
+export declare function compareSemver(a: string, b: string): number;
+export declare function semverAtLeast(version: string, minimum: string): boolean;
+export declare function probeRepoPackageVersions(input?: {
+    cwd?: string;
+    repoRoot?: string;
+}): Partial<Record<MemoryCostManagedPackageName, MemoryCostPackageVersionCandidate>>;
+export declare function evaluateMemoryCostPackageVersionGuard(input?: {
+    installed?: Partial<Record<MemoryCostManagedPackageName, string | MemoryCostPackageVersionCandidate>>;
+    repo?: Partial<Record<MemoryCostManagedPackageName, string | MemoryCostPackageVersionCandidate>>;
+    self?: Partial<Record<MemoryCostManagedPackageName, string | MemoryCostPackageVersionCandidate>>;
+}): MemoryCostPackageGuardResult;
+export declare class MemoryCostPackageVersionGuardError extends Error {
+    readonly result: MemoryCostPackageGuardResult;
+    constructor(result: MemoryCostPackageGuardResult);
+}
+export declare function assertMemoryCostPackageVersionGuard(input?: Parameters<typeof evaluateMemoryCostPackageVersionGuard>[0]): MemoryCostPackageGuardResult;
+export declare function formatMemoryCostPackageGuardError(result: MemoryCostPackageGuardResult): string;

package/dist/orchestration-enforcement/config.d.ts

@@ -0,0 +1,5 @@
+import type { OrchestrationPolicyMode } from "./types.js";
+/** Resolve orchestration policy mode from env (default off — local fallback preserved). */
+export declare function resolveOrchestrationPolicyMode(env?: NodeJS.ProcessEnv): OrchestrationPolicyMode;
+/** Feature gate for enforce-mode linked AgentTask creation (default false until explicitly on). */
+export declare function isOrchestrationEnforceTasksEnabled(env?: NodeJS.ProcessEnv): boolean;

package/dist/orchestration-enforcement/evaluator.d.ts

@@ -0,0 +1,6 @@
+import type { OrchestrationPolicyEvaluateInput, OrchestrationPolicyEvaluateResult } from "./types.js";
+/**
+ * Evaluate whether a foreground orchestration action should stay local, be
+ * observed (logged bypass), or route through linked harness AgentTask creation.
+ */
+export declare function evaluateOrchestrationPolicy(input: OrchestrationPolicyEvaluateInput, env?: NodeJS.ProcessEnv): OrchestrationPolicyEvaluateResult;

package/dist/orchestration-enforcement/idempotency.d.ts

@@ -0,0 +1,8 @@
+/** Deterministic foreground harness task idempotency key for Hermes/Forge sessions. */
+export declare function buildForegroundHarnessIdempotencyKey(input: {
+    sessionId?: string | null;
+    planId?: string | null;
+    parentTaskId?: string | null;
+    title?: string | null;
+    action?: string | null;
+}): string;

package/dist/orchestration-enforcement/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types.js";
+export * from "./config.js";
+export * from "./idempotency.js";
+export * from "./evaluator.js";

package/dist/orchestration-enforcement/types.d.ts

@@ -0,0 +1,24 @@
+/** Kynver-first foreground orchestration policy — observe before enforce. */
+export declare const ORCHESTRATION_POLICY_MODES: readonly ["off", "observe", "enforce"];
+export type OrchestrationPolicyMode = (typeof ORCHESTRATION_POLICY_MODES)[number];
+export declare const ORCHESTRATION_ACTION_KINDS: readonly ["foreground_harness_spawn", "shell_platform_dispatch"];
+export type OrchestrationActionKind = (typeof ORCHESTRATION_ACTION_KINDS)[number];
+export declare const ORCHESTRATION_POLICY_DECISIONS: readonly ["allow_local", "observe_bypass", "enforce_harness_task"];
+export type OrchestrationPolicyDecision = (typeof ORCHESTRATION_POLICY_DECISIONS)[number];
+export interface OrchestrationPolicyEvaluateInput {
+    action: OrchestrationActionKind;
+    toolName?: string | null;
+    sessionId?: string | null;
+    planId?: string | null;
+    parentTaskId?: string | null;
+    title?: string | null;
+    description?: string | null;
+}
+export interface OrchestrationPolicyEvaluateResult {
+    mode: OrchestrationPolicyMode;
+    decision: OrchestrationPolicyDecision;
+    /** Stable idempotency key when enforce would create a linked harness task. */
+    idempotencyKey: string | null;
+    bypassLogged: boolean;
+    reason: string;
+}

package/dist/prompt.d.ts

@@ -9,6 +9,8 @@ export declare function buildPrompt(input: {
     instructionPolicyMarkdown?: string | null;
     /** Anchored task context-envelope persona block (required when task has personaSlug). */
     personaMarkdown?: string | null;
+    /** Compact task context envelope (non-persona tasks or supplemental). */
+    contextEnvelopeMarkdown?: string | null;
     /** P7 memory-quality trace summary + live-verification nudges (privacy-safe). */
     memoryQualityMarkdown?: string | null;
     /** When set, Haiku/compact models get a shorter harness instruction block. */

package/dist/repo-search.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Normalize and classify repo text-search commands for harness operators and chat agents.
+ *
+ * Codex/OpenClaw often emit `search "pattern" in <scope>` meta that maps poorly to ripgrep
+ * (e.g. `in !node_modules` instead of `-g '!node_modules/**'`, or `in package.json` as a path).
+ */
+export type RepoSearchKind = "not_repo_search" | "bad_scope" | "rg_exclude_syntax" | "no_matches";
+export interface RepoSearchContext {
+    kind: RepoSearchKind;
+    pattern?: string;
+    target?: string;
+}
+export declare function isSingleFileSearchTarget(target: string | undefined): boolean;
+/** `!node_modules` as a path is invalid — ripgrep needs `-g '!node_modules/**'`. */
+export declare function isRgExcludeScopeTarget(target: string | undefined): boolean;
+export declare function normalizeRgArgv(argv: string[]): {
+    argv: string[];
+    changed: boolean;
+};
+export declare function normalizeRepoSearchCommand(command: string): {
+    command: string;
+    changed: boolean;
+};
+export declare function extractSearchMeta(meta: string): {
+    pattern?: string;
+    target?: string;
+};
+export declare function classifyRepoSearchMeta(meta: string): RepoSearchContext;
+export declare function metaToNormalizedRgCommand(meta: string): {
+    command: string;
+    changed: boolean;
+} | null;
+export declare function formatRepoSearchGuidance(ctx: RepoSearchContext): string | null;
+/** Extract `search "…" in …` from a tool-failure line or command string. */
+export declare function extractSearchMetaFromToolLine(line: string): string | null;
+export declare function diagnoseRepoSearchFailure(input: {
+    meta?: string;
+    command?: string;
+    exitCode?: number;
+}): string | null;

package/dist/run-worker-index.d.ts

@@ -0,0 +1,10 @@
+import { type HarnessRunRecord } from "./run-store.js";
+/**
+ * Union of `run.json` worker keys and on-disk worker dirs for one run.
+ *
+ * Watchdog replenishment can spawn workers whose `worker.json` exists before
+ * `run.json` is updated (or when concurrent spawns lose a last-write-wins race).
+ * Finalization, capacity gates, and operator rollups must not treat those
+ * live workers as absent.
+ */
+export declare function listRunWorkerNames(run: HarnessRunRecord): string[];

package/dist/runner-identity.d.ts

@@ -5,6 +5,8 @@ export interface RunnerPresencePayload {
     harnessRepo: string | null;
     runId?: string | null;
 }
+/** True when this host belongs to the Ghost orchestrator pool (not Hermes Forge). */
+export declare function isGhostPoolHost(env?: NodeJS.ProcessEnv): boolean;
 /** Stable runner identity for multi-box AgentOS coordination. */
 export declare function resolveRunnerPresencePayload(input?: {
     runId?: string | null;

package/dist/shell-command-outcome.d.ts

@@ -1,4 +1,4 @@
-export type ShellCommandOutcomeKind = "success" | "audit_findings" | "command_failure";
+export type ShellCommandOutcomeKind = "success" | "audit_findings" | "search_no_matches" | "command_failure";
 export interface NpmAuditSummary {
     total: number;
     critical: number;

package/dist/status.d.ts

@@ -17,6 +17,18 @@ export interface InstructionPolicyEvidenceSnapshot {
     markdownChars?: number;
     injectedAt?: string;
 }
+/** Snapshot of task-anchored context envelope injection at worker spawn. */
+export interface ContextEnvelopeEvidenceSnapshot {
+    anchorTaskId?: string;
+    envelopeGeneratedAt?: string;
+    injectedAt?: string;
+    hasPersonaBlock?: boolean;
+    personaSlug?: string | null;
+    operatingRuleCount?: number;
+    memoryHitCount?: number;
+    markdownChars?: number;
+    source?: "dispatch_injection" | "tool_call";
+}
 /** Snapshot of anchored persona context-envelope injection at worker spawn. */
 export interface PersonaContextEvidenceSnapshot {
     expectedPersonaSlug?: string;
@@ -60,6 +72,7 @@ export interface HarnessWorkerRecord {
     memoryQualityCapture?: HarnessMemoryQualityCaptureSnapshot;
     personaSlug?: string;
     personaEvidence?: PersonaContextEvidenceSnapshot;
+    contextEnvelopeEvidence?: ContextEnvelopeEvidenceSnapshot;
     leaseOwner?: string;
     /** Fencing token from claim — sent on renew/completion when set. */
     leaseToken?: string;

package/dist/supervisor.d.ts

@@ -1,5 +1,5 @@
 import type { HarnessRunRecord } from "./run-store.js";
-import type { HarnessMemoryQualityCaptureSnapshot, HarnessWorkerRecord, InstructionPolicyEvidenceSnapshot, PersonaContextEvidenceSnapshot } from "./status.js";
+import type { ContextEnvelopeEvidenceSnapshot, HarnessMemoryQualityCaptureSnapshot, HarnessWorkerRecord, InstructionPolicyEvidenceSnapshot, PersonaContextEvidenceSnapshot } from "./status.js";
 export interface SpawnWorkerOptions {
     name: string;
     task: string;
@@ -17,6 +17,8 @@ export interface SpawnWorkerOptions {
     personaMarkdown?: string | null;
     personaSlug?: string | null;
     personaEvidence?: PersonaContextEvidenceSnapshot | null;
+    contextEnvelopeMarkdown?: string | null;
+    contextEnvelopeEvidence?: ContextEnvelopeEvidenceSnapshot | null;
     leaseOwner?: string;
     leaseToken?: string;
     dispatched?: boolean;

package/dist/validate.d.ts

@@ -1,5 +1,15 @@
 export declare function validateRunId(runId: string): string;
 export declare function validateWorkerName(name: string): string;
+/**
+ * Require `--run` and `--name` before touching the filesystem. Missing flags used
+ * to become `String(undefined)` → paths under `runs/undefined/workers/undefined`.
+ */
+export declare function resolveWorkerTargetArgs(args: Record<string, string | boolean>): {
+    runId: string;
+    workerName: string;
+};
+/** Require `--run` before loading run.json or building a run board. */
+export declare function resolveRunTargetArg(args: Record<string, string | boolean>): string;
 export declare function validateRepo(repo: string): string;
 export declare function validateOwnedPaths(repoRoot: string, ownedPaths: string[]): string[];
 export declare function validateTailLines(lines: number): number;

package/dist/worker-final-result-embed.d.ts

@@ -0,0 +1 @@
+export declare function extractEmbeddedWorkerFinalResultRecord(value: string): Record<string, unknown> | null;

package/dist/worker-ops.d.ts

@@ -13,8 +13,29 @@ export declare function tryCompleteWorker(args: Record<string, string | boolean>
 }>;
 export declare function completeWorker(args: Record<string, string | boolean>): Promise<void>;
 export declare function workerStatus(args: Record<string, string | boolean>): void;
-export declare function buildRunBoard(runId: string): Record<string, unknown>;
+export declare function workerList(args: Record<string, string | boolean>): void;
+type RunBoardWorker = Record<string, unknown> & {
+    worker: string;
+    status?: string;
+    attention?: string;
+    lifecycleStage?: string | null;
+    lastActivityAt?: string | null;
+};
+interface RunBoard {
+    runId: string;
+    name: string;
+    status: string;
+    repo: string;
+    workerCount: number;
+    needsAttention: string[];
+    workers: RunBoardWorker[];
+    summary?: Record<string, unknown>;
+    controller?: Record<string, unknown>;
+}
+export declare function buildRunBoard(runId: string): RunBoard;
+export declare function buildCompactRunBoard(runId: string): RunBoard;
 export declare function publishHarnessBoardSnapshot(args: Record<string, string | boolean>, source: string): Promise<Record<string, unknown> | null>;
 export declare function runStatus(args: Record<string, string | boolean>): void;
 export declare function tailWorker(args: Record<string, string | boolean>): void;
 export declare function stopWorker(args: Record<string, string | boolean>): void;
+export {};

package/dist/worker-persona-catalog.d.ts

@@ -0,0 +1,24 @@
+export declare const WORKER_PERSONA_DISPATCH_LANES: readonly ["implementation", "review", "landing"];
+export type WorkerPersonaDispatchLane = (typeof WORKER_PERSONA_DISPATCH_LANES)[number];
+export declare const WORKER_PERSONA_DEFAULT_ROLE_LANES: readonly ["plan_author", "implementer", "report_reviewer", "deep_reviewer", "runtime_verifier", "system"];
+export type WorkerPersonaDefaultRoleLane = (typeof WORKER_PERSONA_DEFAULT_ROLE_LANES)[number];
+export interface WorkerPersonaCatalogEntry {
+    slug: string;
+    displayName: string;
+    description: string;
+    /** Harness dispatch lane reserved for this persona (null = orchestration / no dispatch). */
+    dispatchLane: WorkerPersonaDispatchLane | null;
+    /** Default plan progress role when enriching harness tasks. */
+    defaultRoleLane: WorkerPersonaDefaultRoleLane;
+}
+export declare const WORKER_PERSONA_CATALOG: readonly WorkerPersonaCatalogEntry[];
+export type WorkerPersonaCatalogSlug = (typeof WORKER_PERSONA_CATALOG)[number]["slug"];
+export declare function getWorkerPersonaCatalogEntry(slug: string | null | undefined): WorkerPersonaCatalogEntry | null;
+/** Dispatch lane reserved for a persona; null when orchestration-only or unknown. */
+export declare function getPersonaDispatchLane(slug: string | null | undefined): WorkerPersonaDispatchLane | null;
+export declare function getPersonaDefaultRoleLane(slug: string | null | undefined): WorkerPersonaDefaultRoleLane | null;
+export declare function isKnownWorkerPersonaSlug(slug: string | null | undefined): boolean;
+/** Personas whose harness dispatch lane is `review` (derived — do not hardcode slugs). */
+export declare function workerPersonaReviewSlugs(): readonly WorkerPersonaCatalogSlug[];
+/** Personas whose harness dispatch lane is `landing` (derived — do not hardcode slugs). */
+export declare function workerPersonaLandingSlugs(): readonly WorkerPersonaCatalogSlug[];

package/dist/worker-persona-catalog.js

@@ -0,0 +1,138 @@
+// src/worker-persona-catalog.ts
+var WORKER_PERSONA_DISPATCH_LANES = [
+  "implementation",
+  "review",
+  "landing"
+];
+var WORKER_PERSONA_DEFAULT_ROLE_LANES = [
+  "plan_author",
+  "implementer",
+  "report_reviewer",
+  "deep_reviewer",
+  "runtime_verifier",
+  "system"
+];
+var WORKER_PERSONA_CATALOG = [
+  {
+    slug: "ghost",
+    displayName: "Ghost",
+    description: "Orchestration \u2014 coordinates lanes, handoffs, and operator decisions.",
+    dispatchLane: null,
+    defaultRoleLane: "system"
+  },
+  {
+    slug: "astra",
+    displayName: "Astra",
+    description: "Planning \u2014 plan authoring, milestones, and operational flow design.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "plan_author"
+  },
+  {
+    slug: "rhea",
+    displayName: "Rhea",
+    description: "Runtime / control-plane implementation \u2014 harness, dispatch, and AgentOS plumbing.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "implementer"
+  },
+  {
+    slug: "mnemo",
+    displayName: "Mnemo",
+    description: "Memory-quality implementation \u2014 MARM lanes, retrieval hygiene, and consolidation.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "implementer"
+  },
+  {
+    slug: "sentinel",
+    displayName: "Sentinel",
+    description: "Security / privacy implementation and security verification gates.",
+    dispatchLane: "review",
+    defaultRoleLane: "deep_reviewer"
+  },
+  {
+    slug: "pixel",
+    displayName: "Pixel",
+    description: "Frontend \u2014 Command Center UI, dashboards, and client surfaces.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "implementer"
+  },
+  {
+    slug: "schema",
+    displayName: "Schema",
+    description: "Data / migrations \u2014 Prisma schema, seeds, and persistence contracts.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "implementer"
+  },
+  {
+    slug: "atlas",
+    displayName: "Atlas",
+    description: "Infra / reliability \u2014 deploy pipelines, observability, and runtime health.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "runtime_verifier"
+  },
+  {
+    slug: "bridge",
+    displayName: "Bridge",
+    description: "Integrations / MCP \u2014 tool manifests, OpenClaw bridges, and cross-service wiring.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "implementer"
+  },
+  {
+    slug: "catalyst",
+    displayName: "Catalyst",
+    description: "Product / domain \u2014 business rules, domain packs, and feature semantics.",
+    dispatchLane: "implementation",
+    defaultRoleLane: "implementer"
+  },
+  {
+    slug: "lorentz",
+    displayName: "Lorentz",
+    description: "Review / testing \u2014 pre-landing and post-landing verification, report + deep review.",
+    dispatchLane: "review",
+    defaultRoleLane: "report_reviewer"
+  },
+  {
+    slug: "dalton",
+    displayName: "Dalton",
+    description: "Landing / merge execution \u2014 merge-ready PR landing and merge evidence only (no implementation).",
+    dispatchLane: "landing",
+    defaultRoleLane: "implementer"
+  }
+];
+var BY_SLUG = new Map(WORKER_PERSONA_CATALOG.map((entry) => [entry.slug, entry]));
+function getWorkerPersonaCatalogEntry(slug) {
+  if (!slug) return null;
+  const key = slug.trim().toLowerCase();
+  return BY_SLUG.get(key) ?? null;
+}
+function getPersonaDispatchLane(slug) {
+  return getWorkerPersonaCatalogEntry(slug)?.dispatchLane ?? null;
+}
+function getPersonaDefaultRoleLane(slug) {
+  return getWorkerPersonaCatalogEntry(slug)?.defaultRoleLane ?? null;
+}
+function isKnownWorkerPersonaSlug(slug) {
+  if (!slug) return false;
+  return BY_SLUG.has(slug.trim().toLowerCase());
+}
+function workerPersonaReviewSlugs() {
+  return WORKER_PERSONA_CATALOG.filter((entry) => entry.dispatchLane === "review").map(
+    (entry) => entry.slug
+  );
+}
+function workerPersonaLandingSlugs() {
+  return WORKER_PERSONA_CATALOG.filter((entry) => entry.dispatchLane === "landing").map(
+    (entry) => entry.slug
+  );
+}
+export {
+  WORKER_PERSONA_CATALOG,
+  WORKER_PERSONA_DEFAULT_ROLE_LANES,
+  WORKER_PERSONA_DISPATCH_LANES,
+  getPersonaDefaultRoleLane,
+  getPersonaDispatchLane,
+  getWorkerPersonaCatalogEntry,
+  isKnownWorkerPersonaSlug,
+  workerPersonaLandingSlugs,
+  workerPersonaReviewSlugs
+};
+//# sourceMappingURL=worker-persona-catalog.js.map

package/dist/worker-persona-catalog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/worker-persona-catalog.ts"],
+  "sourcesContent": ["// Canonical Command Center worker persona catalog \u2014 single source of truth for\r\n// harness dispatch lanes, default plan role lanes, and persona slug validation.\r\n// AgentOS re-exports this module; do not duplicate lane maps elsewhere.\r\n\r\nexport const WORKER_PERSONA_DISPATCH_LANES = [\r\n  \"implementation\",\r\n  \"review\",\r\n  \"landing\",\r\n] as const;\r\n\r\nexport type WorkerPersonaDispatchLane = (typeof WORKER_PERSONA_DISPATCH_LANES)[number];\r\n\r\nexport const WORKER_PERSONA_DEFAULT_ROLE_LANES = [\r\n  \"plan_author\",\r\n  \"implementer\",\r\n  \"report_reviewer\",\r\n  \"deep_reviewer\",\r\n  \"runtime_verifier\",\r\n  \"system\",\r\n] as const;\r\n\r\nexport type WorkerPersonaDefaultRoleLane = (typeof WORKER_PERSONA_DEFAULT_ROLE_LANES)[number];\r\n\r\nexport interface WorkerPersonaCatalogEntry {\r\n  slug: string;\r\n  displayName: string;\r\n  description: string;\r\n  /** Harness dispatch lane reserved for this persona (null = orchestration / no dispatch). */\r\n  dispatchLane: WorkerPersonaDispatchLane | null;\r\n  /** Default plan progress role when enriching harness tasks. */\r\n  defaultRoleLane: WorkerPersonaDefaultRoleLane;\r\n}\r\n\r\nexport const WORKER_PERSONA_CATALOG: readonly WorkerPersonaCatalogEntry[] = [\r\n  {\r\n    slug: \"ghost\",\r\n    displayName: \"Ghost\",\r\n    description: \"Orchestration \u2014 coordinates lanes, handoffs, and operator decisions.\",\r\n    dispatchLane: null,\r\n    defaultRoleLane: \"system\",\r\n  },\r\n  {\r\n    slug: \"astra\",\r\n    displayName: \"Astra\",\r\n    description: \"Planning \u2014 plan authoring, milestones, and operational flow design.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"plan_author\",\r\n  },\r\n  {\r\n    slug: \"rhea\",\r\n    displayName: \"Rhea\",\r\n    description: \"Runtime / control-plane implementation \u2014 harness, dispatch, and AgentOS plumbing.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"implementer\",\r\n  },\r\n  {\r\n    slug: \"mnemo\",\r\n    displayName: \"Mnemo\",\r\n    description: \"Memory-quality implementation \u2014 MARM lanes, retrieval hygiene, and consolidation.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"implementer\",\r\n  },\r\n  {\r\n    slug: \"sentinel\",\r\n    displayName: \"Sentinel\",\r\n    description: \"Security / privacy implementation and security verification gates.\",\r\n    dispatchLane: \"review\",\r\n    defaultRoleLane: \"deep_reviewer\",\r\n  },\r\n  {\r\n    slug: \"pixel\",\r\n    displayName: \"Pixel\",\r\n    description: \"Frontend \u2014 Command Center UI, dashboards, and client surfaces.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"implementer\",\r\n  },\r\n  {\r\n    slug: \"schema\",\r\n    displayName: \"Schema\",\r\n    description: \"Data / migrations \u2014 Prisma schema, seeds, and persistence contracts.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"implementer\",\r\n  },\r\n  {\r\n    slug: \"atlas\",\r\n    displayName: \"Atlas\",\r\n    description: \"Infra / reliability \u2014 deploy pipelines, observability, and runtime health.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"runtime_verifier\",\r\n  },\r\n  {\r\n    slug: \"bridge\",\r\n    displayName: \"Bridge\",\r\n    description: \"Integrations / MCP \u2014 tool manifests, OpenClaw bridges, and cross-service wiring.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"implementer\",\r\n  },\r\n  {\r\n    slug: \"catalyst\",\r\n    displayName: \"Catalyst\",\r\n    description: \"Product / domain \u2014 business rules, domain packs, and feature semantics.\",\r\n    dispatchLane: \"implementation\",\r\n    defaultRoleLane: \"implementer\",\r\n  },\r\n  {\r\n    slug: \"lorentz\",\r\n    displayName: \"Lorentz\",\r\n    description: \"Review / testing \u2014 pre-landing and post-landing verification, report + deep review.\",\r\n    dispatchLane: \"review\",\r\n    defaultRoleLane: \"report_reviewer\",\r\n  },\r\n  {\r\n    slug: \"dalton\",\r\n    displayName: \"Dalton\",\r\n    description: \"Landing / merge execution \u2014 merge-ready PR landing and merge evidence only (no implementation).\",\r\n    dispatchLane: \"landing\",\r\n    defaultRoleLane: \"implementer\",\r\n  },\r\n] as const;\r\n\r\nexport type WorkerPersonaCatalogSlug = (typeof WORKER_PERSONA_CATALOG)[number][\"slug\"];\r\n\r\nconst BY_SLUG = new Map(WORKER_PERSONA_CATALOG.map((entry) => [entry.slug, entry]));\r\n\r\nexport function getWorkerPersonaCatalogEntry(\r\n  slug: string | null | undefined,\r\n): WorkerPersonaCatalogEntry | null {\r\n  if (!slug) return null;\r\n  const key = slug.trim().toLowerCase();\r\n  return BY_SLUG.get(key) ?? null;\r\n}\r\n\r\n/** Dispatch lane reserved for a persona; null when orchestration-only or unknown. */\r\nexport function getPersonaDispatchLane(\r\n  slug: string | null | undefined,\r\n): WorkerPersonaDispatchLane | null {\r\n  return getWorkerPersonaCatalogEntry(slug)?.dispatchLane ?? null;\r\n}\r\n\r\nexport function getPersonaDefaultRoleLane(\r\n  slug: string | null | undefined,\r\n): WorkerPersonaDefaultRoleLane | null {\r\n  return getWorkerPersonaCatalogEntry(slug)?.defaultRoleLane ?? null;\r\n}\r\n\r\nexport function isKnownWorkerPersonaSlug(slug: string | null | undefined): boolean {\r\n  if (!slug) return false;\r\n  return BY_SLUG.has(slug.trim().toLowerCase());\r\n}\r\n\r\n/** Personas whose harness dispatch lane is `review` (derived \u2014 do not hardcode slugs). */\r\nexport function workerPersonaReviewSlugs(): readonly WorkerPersonaCatalogSlug[] {\r\n  return WORKER_PERSONA_CATALOG.filter((entry) => entry.dispatchLane === \"review\").map(\r\n    (entry) => entry.slug,\r\n  );\r\n}\r\n\r\n/** Personas whose harness dispatch lane is `landing` (derived \u2014 do not hardcode slugs). */\r\nexport function workerPersonaLandingSlugs(): readonly WorkerPersonaCatalogSlug[] {\r\n  return WORKER_PERSONA_CATALOG.filter((entry) => entry.dispatchLane === \"landing\").map(\r\n    (entry) => entry.slug,\r\n  );\r\n}\r\n"],
+  "mappings": ";AAIO,IAAM,gCAAgC;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF;AAIO,IAAM,oCAAoC;AAAA,EAC/C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAcO,IAAM,yBAA+D;AAAA,EAC1E;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,IACb,cAAc;AAAA,IACd,iBAAiB;AAAA,EACnB;AACF;AAIA,IAAM,UAAU,IAAI,IAAI,uBAAuB,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;AAE3E,SAAS,6BACd,MACkC;AAClC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,KAAK,KAAK,EAAE,YAAY;AACpC,SAAO,QAAQ,IAAI,GAAG,KAAK;AAC7B;AAGO,SAAS,uBACd,MACkC;AAClC,SAAO,6BAA6B,IAAI,GAAG,gBAAgB;AAC7D;AAEO,SAAS,0BACd,MACqC;AACrC,SAAO,6BAA6B,IAAI,GAAG,mBAAmB;AAChE;AAEO,SAAS,yBAAyB,MAA0C;AACjF,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,QAAQ,IAAI,KAAK,KAAK,EAAE,YAAY,CAAC;AAC9C;AAGO,SAAS,2BAAgE;AAC9E,SAAO,uBAAuB,OAAO,CAAC,UAAU,MAAM,iBAAiB,QAAQ,EAAE;AAAA,IAC/E,CAAC,UAAU,MAAM;AAAA,EACnB;AACF;AAGO,SAAS,4BAAiE;AAC/E,SAAO,uBAAuB,OAAO,CAAC,UAAU,MAAM,iBAAiB,SAAS,EAAE;AAAA,IAChF,CAAC,UAAU,MAAM;AAAA,EACnB;AACF;",
+  "names": []
+}

package/dist/workspace-runtime-config.d.ts

@@ -1,6 +1,8 @@
 export interface WorkspaceRuntimePreferences {
     maxConcurrentWorkers: number | null;
 }
+export declare function shouldApplyWorkspaceRuntimePreferences(env?: NodeJS.ProcessEnv): boolean;
+export declare function configuredMaxWorkersOverrideForBox(preferences: WorkspaceRuntimePreferences | null | undefined, env?: NodeJS.ProcessEnv): number | undefined;
 /**
  * Pull the Command Center worker cap each pipeline tick so the daemon honors
  * workspace settings without restarting or editing ~/.kynver/config.json.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/runtime",
-  "version": "0.1.90",
+  "version": "0.1.91",
   "description": "Kynver AgentOS local execution runtime and CLI",
   "type": "module",
   "main": "./dist/index.js",