@lumenflow/mcp 2.21.0 → 3.0.0

package/dist/mcp-constants.d.ts

@@ -0,0 +1,173 @@
+/**
+ * @file mcp-constants.ts
+ * @description Typed source-of-truth constants for MCP governed literal families.
+ *
+ * Governed families:
+ * 1. CLI command names — canonical map of all commands dispatched via runCliCommand/executeViaPack
+ * 2. Cross-boundary metadata keys — keys used in ExecutionContext.metadata across modules
+ *
+ * Scoping rule: CLI flags are governed in tools-shared.ts (CliArgs). Only flags
+ * appearing in 3 or more tool definitions are centralized there. Tool-local flags
+ * (< 3 uses) remain as local string literals.
+ *
+ * WU-1851: Initial governance module.
+ */
+/**
+ * Canonical CLI command name constants.
+ *
+ * Every string passed to `runCliCommand()`, `executeViaPack()`, or used in
+ * `fallback.command` MUST reference a value from this object.
+ *
+ * Organized by domain to match tool file groupings.
+ */
+export declare const CliCommands: {
+    readonly WU_STATUS: "wu:status";
+    readonly WU_CREATE: "wu:create";
+    readonly WU_CLAIM: "wu:claim";
+    readonly WU_SANDBOX: "wu:sandbox";
+    readonly WU_DONE: "wu:done";
+    readonly WU_BLOCK: "wu:block";
+    readonly WU_UNBLOCK: "wu:unblock";
+    readonly WU_EDIT: "wu:edit";
+    readonly WU_RELEASE: "wu:release";
+    readonly WU_RECOVER: "wu:recover";
+    readonly WU_REPAIR: "wu:repair";
+    readonly WU_DEPS: "wu:deps";
+    readonly WU_PREP: "wu:prep";
+    readonly WU_PREFLIGHT: "wu:preflight";
+    readonly WU_PRUNE: "wu:prune";
+    readonly WU_DELETE: "wu:delete";
+    readonly WU_CLEANUP: "wu:cleanup";
+    readonly WU_BRIEF: "wu:brief";
+    readonly WU_DELEGATE: "wu:delegate";
+    readonly WU_VALIDATE: "wu:validate";
+    readonly WU_INFER_LANE: "wu:infer-lane";
+    readonly WU_UNLOCK_LANE: "wu:unlock-lane";
+    readonly WU_PROTO: "wu:proto";
+    readonly WU_LIST: "wu:list";
+    readonly GATES: "gates";
+    readonly STATE_BOOTSTRAP: "state:bootstrap";
+    readonly STATE_CLEANUP: "state:cleanup";
+    readonly STATE_DOCTOR: "state:doctor";
+    readonly BACKLOG_PRUNE: "backlog:prune";
+    readonly DOCS_SYNC: "docs:sync";
+    readonly SYNC_TEMPLATES: "sync:templates";
+    readonly LUMENFLOW: "lumenflow";
+    readonly LANE_HEALTH: "lane:health";
+    readonly LANE_SUGGEST: "lane:suggest";
+    readonly SIGNAL_CLEANUP: "signal:cleanup";
+    readonly CONFIG_SET: "config:set";
+    readonly CONFIG_GET: "config:get";
+    readonly FILE_READ: "file:read";
+    readonly FILE_WRITE: "file:write";
+    readonly FILE_EDIT: "file:edit";
+    readonly FILE_DELETE: "file:delete";
+    readonly GIT_STATUS: "git:status";
+    readonly GIT_DIFF: "git:diff";
+    readonly GIT_LOG: "git:log";
+    readonly GIT_BRANCH: "git:branch";
+    readonly INIT_PLAN: "init:plan";
+    readonly PLAN_CREATE: "plan:create";
+    readonly PLAN_EDIT: "plan:edit";
+    readonly PLAN_LINK: "plan:link";
+    readonly PLAN_PROMOTE: "plan:promote";
+    readonly LUMENFLOW_DOCTOR: "lumenflow:doctor";
+    readonly LUMENFLOW_INTEGRATE: "lumenflow:integrate";
+    readonly LUMENFLOW_UPGRADE: "lumenflow:upgrade";
+    readonly LUMENFLOW_RELEASE: "lumenflow:release";
+    readonly LUMENFLOW_VALIDATE: "lumenflow:validate";
+    readonly VALIDATE: "validate";
+    readonly VALIDATE_AGENT_SKILLS: "validate:agent-skills";
+    readonly VALIDATE_AGENT_SYNC: "validate:agent-sync";
+    readonly VALIDATE_BACKLOG_SYNC: "validate:backlog-sync";
+    readonly VALIDATE_SKILLS_SPEC: "validate:skills-spec";
+    readonly INITIATIVE_LIST: "initiative:list";
+    readonly INITIATIVE_STATUS: "initiative:status";
+    readonly INITIATIVE_CREATE: "initiative:create";
+    readonly INITIATIVE_EDIT: "initiative:edit";
+    readonly INITIATIVE_ADD_WU: "initiative:add-wu";
+    readonly INITIATIVE_REMOVE_WU: "initiative:remove-wu";
+    readonly INITIATIVE_BULK_ASSIGN: "initiative:bulk-assign";
+    readonly INITIATIVE_PLAN: "initiative:plan";
+    readonly ORCHESTRATE_INITIATIVE: "orchestrate:initiative";
+    readonly ORCHESTRATE_INIT_STATUS: "orchestrate:init-status";
+    readonly ORCHESTRATE_MONITOR: "orchestrate:monitor";
+    readonly DELEGATION_LIST: "delegation:list";
+    readonly AGENT_SESSION: "agent:session";
+    readonly AGENT_SESSION_END: "agent:session-end";
+    readonly AGENT_LOG_ISSUE: "agent:log-issue";
+    readonly AGENT_ISSUES_QUERY: "agent:issues-query";
+    readonly MEM_INIT: "mem:init";
+    readonly MEM_START: "mem:start";
+    readonly MEM_READY: "mem:ready";
+    readonly MEM_CHECKPOINT: "mem:checkpoint";
+    readonly MEM_CLEANUP: "mem:cleanup";
+    readonly MEM_CONTEXT: "mem:context";
+    readonly MEM_CREATE: "mem:create";
+    readonly MEM_DELETE: "mem:delete";
+    readonly MEM_EXPORT: "mem:export";
+    readonly MEM_INBOX: "mem:inbox";
+    readonly MEM_SIGNAL: "mem:signal";
+    readonly MEM_SUMMARIZE: "mem:summarize";
+    readonly MEM_TRIAGE: "mem:triage";
+    readonly MEM_RECOVER: "mem:recover";
+    readonly CONTEXT_GET: "context:get";
+    readonly FLOW_BOTTLENECKS: "flow:bottlenecks";
+    readonly FLOW_REPORT: "flow:report";
+    readonly METRICS_SNAPSHOT: "metrics:snapshot";
+    readonly LUMENFLOW_METRICS: "lumenflow:metrics";
+    readonly METRICS: "metrics";
+};
+export type CliCommandName = (typeof CliCommands)[keyof typeof CliCommands];
+/**
+ * Metadata key constants used in ExecutionContext.metadata across MCP modules.
+ * These cross module boundaries and must be consistent.
+ */
+export declare const MetadataKeys: {
+    readonly PROJECT_ROOT: "project_root";
+    readonly INVOCATION_MODE: "invocation_mode";
+};
+export type MetadataKey = (typeof MetadataKeys)[keyof typeof MetadataKeys];
+/**
+ * Environment variables used by MCP runtime execution policy.
+ */
+export declare const McpEnvironmentVariables: {
+    readonly MIGRATION_COMPAT_MODE: "LUMENFLOW_MCP_MIGRATION_COMPAT_MODE";
+};
+/**
+ * Compatibility modes for executeViaPack migration fallback behavior.
+ *
+ * - compat: allow temporary CLI fallback for migration-only reasons
+ * - strict: fail closed when runtime cannot serve migration-only tools
+ */
+export declare const MigrationCompatModes: {
+    readonly COMPAT: "compat";
+    readonly STRICT: "strict";
+};
+export type MigrationCompatMode = (typeof MigrationCompatModes)[keyof typeof MigrationCompatModes];
+/**
+ * Canonical migration fallback error codes used by executeViaPack guardrails.
+ */
+export declare const MigrationFallbackErrorCodes: {
+    readonly DISABLED: "MCP_MIGRATION_FALLBACK_DISABLED";
+    readonly EXECUTION_FAILED: "MCP_MIGRATION_FALLBACK_ERROR";
+};
+export type MigrationFallbackErrorCode = (typeof MigrationFallbackErrorCodes)[keyof typeof MigrationFallbackErrorCodes];
+/**
+ * Structured reasons for migration fallback attempts.
+ */
+export declare const MigrationFallbackReasons: {
+    readonly RUNTIME_INIT_FAILED: "runtime_init_failed";
+    readonly RUNTIME_TOOL_NOT_FOUND: "runtime_tool_not_found";
+};
+export type MigrationFallbackReason = (typeof MigrationFallbackReasons)[keyof typeof MigrationFallbackReasons];
+/**
+ * Structured outcomes for migration fallback telemetry events.
+ */
+export declare const MigrationFallbackOutcomes: {
+    readonly SUCCEEDED: "succeeded";
+    readonly FAILED: "failed";
+    readonly BLOCKED: "blocked";
+};
+export type MigrationFallbackOutcome = (typeof MigrationFallbackOutcomes)[keyof typeof MigrationFallbackOutcomes];
+//# sourceMappingURL=mcp-constants.d.ts.map

package/dist/mcp-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-constants.d.ts","sourceRoot":"","sources":["../src/mcp-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Hd,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAM5E;;;GAGG;AACH,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAM3E;;GAEG;AACH,eAAO,MAAM,uBAAuB;;CAE1B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEnG;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;CAG3B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;CAI5B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/mcp-constants.js

@@ -0,0 +1,191 @@
+/**
+ * @file mcp-constants.ts
+ * @description Typed source-of-truth constants for MCP governed literal families.
+ *
+ * Governed families:
+ * 1. CLI command names — canonical map of all commands dispatched via runCliCommand/executeViaPack
+ * 2. Cross-boundary metadata keys — keys used in ExecutionContext.metadata across modules
+ *
+ * Scoping rule: CLI flags are governed in tools-shared.ts (CliArgs). Only flags
+ * appearing in 3 or more tool definitions are centralized there. Tool-local flags
+ * (< 3 uses) remain as local string literals.
+ *
+ * WU-1851: Initial governance module.
+ */
+// ============================================================================
+// CLI Command Names
+// ============================================================================
+/**
+ * Canonical CLI command name constants.
+ *
+ * Every string passed to `runCliCommand()`, `executeViaPack()`, or used in
+ * `fallback.command` MUST reference a value from this object.
+ *
+ * Organized by domain to match tool file groupings.
+ */
+export const CliCommands = {
+    // -- WU lifecycle (wu-tools.ts) --
+    WU_STATUS: 'wu:status',
+    WU_CREATE: 'wu:create',
+    WU_CLAIM: 'wu:claim',
+    WU_SANDBOX: 'wu:sandbox',
+    WU_DONE: 'wu:done',
+    WU_BLOCK: 'wu:block',
+    WU_UNBLOCK: 'wu:unblock',
+    WU_EDIT: 'wu:edit',
+    WU_RELEASE: 'wu:release',
+    WU_RECOVER: 'wu:recover',
+    WU_REPAIR: 'wu:repair',
+    WU_DEPS: 'wu:deps',
+    WU_PREP: 'wu:prep',
+    WU_PREFLIGHT: 'wu:preflight',
+    WU_PRUNE: 'wu:prune',
+    WU_DELETE: 'wu:delete',
+    WU_CLEANUP: 'wu:cleanup',
+    WU_BRIEF: 'wu:brief',
+    WU_DELEGATE: 'wu:delegate',
+    WU_VALIDATE: 'wu:validate',
+    WU_INFER_LANE: 'wu:infer-lane',
+    WU_UNLOCK_LANE: 'wu:unlock-lane',
+    WU_PROTO: 'wu:proto',
+    WU_LIST: 'wu:list',
+    // -- Gates (wu-tools.ts, parity-tools.ts) --
+    GATES: 'gates',
+    // -- State (parity-tools.ts) --
+    STATE_BOOTSTRAP: 'state:bootstrap',
+    STATE_CLEANUP: 'state:cleanup',
+    STATE_DOCTOR: 'state:doctor',
+    // -- Parity (parity-tools.ts) --
+    BACKLOG_PRUNE: 'backlog:prune',
+    DOCS_SYNC: 'docs:sync',
+    SYNC_TEMPLATES: 'sync:templates',
+    LUMENFLOW: 'lumenflow',
+    LANE_HEALTH: 'lane:health',
+    LANE_SUGGEST: 'lane:suggest',
+    SIGNAL_CLEANUP: 'signal:cleanup',
+    CONFIG_SET: 'config:set',
+    CONFIG_GET: 'config:get',
+    // -- File operations (parity-tools.ts) --
+    FILE_READ: 'file:read',
+    FILE_WRITE: 'file:write',
+    FILE_EDIT: 'file:edit',
+    FILE_DELETE: 'file:delete',
+    // -- Git operations (parity-tools.ts) --
+    GIT_STATUS: 'git:status',
+    GIT_DIFF: 'git:diff',
+    GIT_LOG: 'git:log',
+    GIT_BRANCH: 'git:branch',
+    // -- Plan operations (parity-tools.ts) --
+    INIT_PLAN: 'init:plan',
+    PLAN_CREATE: 'plan:create',
+    PLAN_EDIT: 'plan:edit',
+    PLAN_LINK: 'plan:link',
+    PLAN_PROMOTE: 'plan:promote',
+    // -- Setup (setup-tools.ts) --
+    LUMENFLOW_DOCTOR: 'lumenflow:doctor',
+    LUMENFLOW_INTEGRATE: 'lumenflow:integrate',
+    LUMENFLOW_UPGRADE: 'lumenflow:upgrade',
+    LUMENFLOW_RELEASE: 'lumenflow:release',
+    // -- Validation (validation-tools.ts) --
+    LUMENFLOW_VALIDATE: 'lumenflow:validate',
+    VALIDATE: 'validate',
+    VALIDATE_AGENT_SKILLS: 'validate:agent-skills',
+    VALIDATE_AGENT_SYNC: 'validate:agent-sync',
+    VALIDATE_BACKLOG_SYNC: 'validate:backlog-sync',
+    VALIDATE_SKILLS_SPEC: 'validate:skills-spec',
+    // -- Initiatives (initiative-tools.ts) --
+    INITIATIVE_LIST: 'initiative:list',
+    INITIATIVE_STATUS: 'initiative:status',
+    INITIATIVE_CREATE: 'initiative:create',
+    INITIATIVE_EDIT: 'initiative:edit',
+    INITIATIVE_ADD_WU: 'initiative:add-wu',
+    INITIATIVE_REMOVE_WU: 'initiative:remove-wu',
+    INITIATIVE_BULK_ASSIGN: 'initiative:bulk-assign',
+    INITIATIVE_PLAN: 'initiative:plan',
+    // -- Orchestration (orchestration-tools.ts) --
+    ORCHESTRATE_INITIATIVE: 'orchestrate:initiative',
+    ORCHESTRATE_INIT_STATUS: 'orchestrate:init-status',
+    ORCHESTRATE_MONITOR: 'orchestrate:monitor',
+    DELEGATION_LIST: 'delegation:list',
+    // -- Agent (agent-tools.ts) --
+    AGENT_SESSION: 'agent:session',
+    AGENT_SESSION_END: 'agent:session-end',
+    AGENT_LOG_ISSUE: 'agent:log-issue',
+    AGENT_ISSUES_QUERY: 'agent:issues-query',
+    // -- Memory (memory-tools.ts) --
+    MEM_INIT: 'mem:init',
+    MEM_START: 'mem:start',
+    MEM_READY: 'mem:ready',
+    MEM_CHECKPOINT: 'mem:checkpoint',
+    MEM_CLEANUP: 'mem:cleanup',
+    MEM_CONTEXT: 'mem:context',
+    MEM_CREATE: 'mem:create',
+    MEM_DELETE: 'mem:delete',
+    MEM_EXPORT: 'mem:export',
+    MEM_INBOX: 'mem:inbox',
+    MEM_SIGNAL: 'mem:signal',
+    MEM_SUMMARIZE: 'mem:summarize',
+    MEM_TRIAGE: 'mem:triage',
+    MEM_RECOVER: 'mem:recover',
+    // -- Context (context-tools.ts) --
+    CONTEXT_GET: 'context:get',
+    // -- Flow & Metrics (flow-tools.ts) --
+    FLOW_BOTTLENECKS: 'flow:bottlenecks',
+    FLOW_REPORT: 'flow:report',
+    METRICS_SNAPSHOT: 'metrics:snapshot',
+    LUMENFLOW_METRICS: 'lumenflow:metrics',
+    METRICS: 'metrics',
+};
+// ============================================================================
+// Cross-Boundary Metadata Keys
+// ============================================================================
+/**
+ * Metadata key constants used in ExecutionContext.metadata across MCP modules.
+ * These cross module boundaries and must be consistent.
+ */
+export const MetadataKeys = {
+    PROJECT_ROOT: 'project_root',
+    INVOCATION_MODE: 'invocation_mode',
+};
+// ============================================================================
+// Migration Compatibility Guard
+// ============================================================================
+/**
+ * Environment variables used by MCP runtime execution policy.
+ */
+export const McpEnvironmentVariables = {
+    MIGRATION_COMPAT_MODE: 'LUMENFLOW_MCP_MIGRATION_COMPAT_MODE',
+};
+/**
+ * Compatibility modes for executeViaPack migration fallback behavior.
+ *
+ * - compat: allow temporary CLI fallback for migration-only reasons
+ * - strict: fail closed when runtime cannot serve migration-only tools
+ */
+export const MigrationCompatModes = {
+    COMPAT: 'compat',
+    STRICT: 'strict',
+};
+/**
+ * Canonical migration fallback error codes used by executeViaPack guardrails.
+ */
+export const MigrationFallbackErrorCodes = {
+    DISABLED: 'MCP_MIGRATION_FALLBACK_DISABLED',
+    EXECUTION_FAILED: 'MCP_MIGRATION_FALLBACK_ERROR',
+};
+/**
+ * Structured reasons for migration fallback attempts.
+ */
+export const MigrationFallbackReasons = {
+    RUNTIME_INIT_FAILED: 'runtime_init_failed',
+    RUNTIME_TOOL_NOT_FOUND: 'runtime_tool_not_found',
+};
+/**
+ * Structured outcomes for migration fallback telemetry events.
+ */
+export const MigrationFallbackOutcomes = {
+    SUCCEEDED: 'succeeded',
+    FAILED: 'failed',
+    BLOCKED: 'blocked',
+};
+//# sourceMappingURL=mcp-constants.js.map

package/dist/mcp-constants.js.map

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

package/dist/runtime-cache.d.ts

@@ -0,0 +1,7 @@
+import { initializeKernelRuntime } from '@lumenflow/kernel';
+export type RuntimeInstance = Awaited<ReturnType<typeof initializeKernelRuntime>>;
+type RuntimeToolCapabilityResolver = Parameters<typeof initializeKernelRuntime>[0]['toolCapabilityResolver'];
+export declare function resetMcpRuntimeCache(): void;
+export declare function getRuntimeForWorkspace(workspaceRoot: string, toolCapabilityResolver: RuntimeToolCapabilityResolver): Promise<RuntimeInstance>;
+export {};
+//# sourceMappingURL=runtime-cache.d.ts.map

package/dist/runtime-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-cache.d.ts","sourceRoot":"","sources":["../src/runtime-cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAClF,KAAK,6BAA6B,GAAG,UAAU,CAC7C,OAAO,uBAAuB,CAC/B,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;AAI/B,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EACrB,sBAAsB,EAAE,6BAA6B,GACpD,OAAO,CAAC,eAAe,CAAC,CAmB1B"}

package/dist/runtime-cache.js

@@ -0,0 +1,26 @@
+import path from 'node:path';
+import { initializeKernelRuntime } from '@lumenflow/kernel';
+const runtimeCacheByWorkspaceRoot = new Map();
+export function resetMcpRuntimeCache() {
+    runtimeCacheByWorkspaceRoot.clear();
+}
+export async function getRuntimeForWorkspace(workspaceRoot, toolCapabilityResolver) {
+    const normalizedRoot = path.resolve(workspaceRoot);
+    const cachedRuntime = runtimeCacheByWorkspaceRoot.get(normalizedRoot);
+    if (cachedRuntime) {
+        return cachedRuntime;
+    }
+    const runtimePromise = initializeKernelRuntime({
+        workspaceRoot: normalizedRoot,
+        toolCapabilityResolver,
+    });
+    runtimeCacheByWorkspaceRoot.set(normalizedRoot, runtimePromise);
+    try {
+        return await runtimePromise;
+    }
+    catch (cause) {
+        runtimeCacheByWorkspaceRoot.delete(normalizedRoot);
+        throw cause;
+    }
+}
+//# sourceMappingURL=runtime-cache.js.map

package/dist/runtime-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-cache.js","sourceRoot":"","sources":["../src/runtime-cache.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAO5D,MAAM,2BAA2B,GAAG,IAAI,GAAG,EAAoC,CAAC;AAEhF,MAAM,UAAU,oBAAoB;IAClC,2BAA2B,CAAC,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,aAAqB,EACrB,sBAAqD;IAErD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,2BAA2B,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACtE,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,cAAc,GAAG,uBAAuB,CAAC;QAC7C,aAAa,EAAE,cAAc;QAC7B,sBAAsB;KACvB,CAAC,CAAC;IACH,2BAA2B,CAAC,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,OAAO,MAAM,cAAc,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2BAA2B,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACnD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/runtime-tool-resolver.constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file runtime-tool-resolver.constants.ts
+ * @description Canonical literals for in-process runtime tool resolver handlers.
+ *
+ * WU-1801: Consolidates state/signal handler literals so command identifiers,
+ * event kinds, and user-facing messages are defined in one place.
+ */
+export declare const STATE_RUNTIME_EVENT_TYPES: {
+    readonly CLAIM: "claim";
+    readonly COMPLETE: "complete";
+    readonly BLOCK: "block";
+    readonly RELEASE: "release";
+};
+export declare const STATE_RUNTIME_CONSTANTS: {
+    readonly WU_FILE_PREFIX: "WU-";
+    readonly YAML_EXTENSION: ".yaml";
+    readonly DONE_STAMP_EXTENSION: ".done";
+    readonly WU_EVENTS_FILE_NAME: "wu-events.jsonl";
+    readonly STALE_NOTE_TEMPLATE: "Auto-tagged as stale by backlog:prune";
+    readonly STATE_DOCTOR_FIX_REASON: "state:doctor --fix";
+    readonly DEFAULT_STALE_DAYS_IN_PROGRESS: 7;
+    readonly DEFAULT_STALE_DAYS_READY: 30;
+    readonly DEFAULT_ARCHIVE_DAYS: 90;
+    readonly ONE_DAY_MS: number;
+    readonly BOOTSTRAP_BLOCK_REASON: "Bootstrapped from WU YAML (original reason unknown)";
+    readonly UNKNOWN_LANE: "Unknown";
+    readonly UNTITLED_WU: "Untitled";
+};
+export declare const STATE_RUNTIME_MESSAGES: {
+    readonly WU_DIRECTORY_EMPTY_OR_MISSING: "WU directory not found or empty";
+    readonly MUTUALLY_EXCLUSIVE_CLEANUP_FLAGS: "--signals-only, --memory-only, and --events-only are mutually exclusive";
+};
+//# sourceMappingURL=runtime-tool-resolver.constants.d.ts.map

package/dist/runtime-tool-resolver.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tool-resolver.constants.d.ts","sourceRoot":"","sources":["../src/runtime-tool-resolver.constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,yBAAyB;;;;;CAK5B,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;CAc1B,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;CAIzB,CAAC"}

package/dist/runtime-tool-resolver.constants.js

@@ -0,0 +1,33 @@
+/**
+ * @file runtime-tool-resolver.constants.ts
+ * @description Canonical literals for in-process runtime tool resolver handlers.
+ *
+ * WU-1801: Consolidates state/signal handler literals so command identifiers,
+ * event kinds, and user-facing messages are defined in one place.
+ */
+export const STATE_RUNTIME_EVENT_TYPES = {
+    CLAIM: 'claim',
+    COMPLETE: 'complete',
+    BLOCK: 'block',
+    RELEASE: 'release',
+};
+export const STATE_RUNTIME_CONSTANTS = {
+    WU_FILE_PREFIX: 'WU-',
+    YAML_EXTENSION: '.yaml',
+    DONE_STAMP_EXTENSION: '.done',
+    WU_EVENTS_FILE_NAME: 'wu-events.jsonl',
+    STALE_NOTE_TEMPLATE: 'Auto-tagged as stale by backlog:prune',
+    STATE_DOCTOR_FIX_REASON: 'state:doctor --fix',
+    DEFAULT_STALE_DAYS_IN_PROGRESS: 7,
+    DEFAULT_STALE_DAYS_READY: 30,
+    DEFAULT_ARCHIVE_DAYS: 90,
+    ONE_DAY_MS: 24 * 60 * 60 * 1000,
+    BOOTSTRAP_BLOCK_REASON: 'Bootstrapped from WU YAML (original reason unknown)',
+    UNKNOWN_LANE: 'Unknown',
+    UNTITLED_WU: 'Untitled',
+};
+export const STATE_RUNTIME_MESSAGES = {
+    WU_DIRECTORY_EMPTY_OR_MISSING: 'WU directory not found or empty',
+    MUTUALLY_EXCLUSIVE_CLEANUP_FLAGS: '--signals-only, --memory-only, and --events-only are mutually exclusive',
+};
+//# sourceMappingURL=runtime-tool-resolver.constants.js.map

package/dist/runtime-tool-resolver.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tool-resolver.constants.js","sourceRoot":"","sources":["../src/runtime-tool-resolver.constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,cAAc,EAAE,KAAK;IACrB,cAAc,EAAE,OAAO;IACvB,oBAAoB,EAAE,OAAO;IAC7B,mBAAmB,EAAE,iBAAiB;IACtC,mBAAmB,EAAE,uCAAuC;IAC5D,uBAAuB,EAAE,oBAAoB;IAC7C,8BAA8B,EAAE,CAAC;IACjC,wBAAwB,EAAE,EAAE;IAC5B,oBAAoB,EAAE,EAAE;IACxB,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IAC/B,sBAAsB,EAAE,qDAAqD;IAC7E,YAAY,EAAE,SAAS;IACvB,WAAW,EAAE,UAAU;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,6BAA6B,EAAE,iCAAiC;IAChE,gCAAgC,EAC9B,yEAAyE;CACnE,CAAC"}

package/dist/runtime-tool-resolver.d.ts

@@ -0,0 +1,5 @@
+import { type RuntimeToolCapabilityResolver } from '@lumenflow/kernel';
+export declare function isInProcessPackToolRegistered(toolName: string): boolean;
+export declare function listInProcessPackTools(): string[];
+export declare const packToolCapabilityResolver: RuntimeToolCapabilityResolver;
+//# sourceMappingURL=runtime-tool-resolver.d.ts.map

package/dist/runtime-tool-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tool-resolver.d.ts","sourceRoot":"","sources":["../src/runtime-tool-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,6BAA6B,EAEnC,MAAM,mBAAmB,CAAC;AA+kF3B,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAED,eAAO,MAAM,0BAA0B,EAAE,6BAqBxC,CAAC"}