@lumenflow/mcp 3.2.0 → 3.2.2

package/dist/mcp-constants.js

@@ -0,0 +1,197 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @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',
+    CLOUD_CONNECT: 'cloud:connect',
+    ONBOARD: 'onboard',
+    LUMENFLOW_ONBOARD: 'lumenflow-onboard',
+    WORKSPACE_INIT: 'workspace:init',
+    // -- 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/resources.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Resource definition
+ */
+export interface ResourceDefinition {
+    /** Static resource URI (for fixed resources) */
+    uri?: string;
+    /** URI template (for parameterized resources) */
+    uriTemplate?: string;
+    /** Resource name */
+    name: string;
+    /** Resource description */
+    description: string;
+    /** MIME type of the resource content */
+    mimeType: string;
+    /** Fetch the resource content */
+    fetch: (uri: string, options?: {
+        projectRoot?: string;
+    }) => Promise<ResourceResult>;
+}
+/**
+ * Resource result
+ */
+export interface ResourceResult {
+    success: boolean;
+    content?: string;
+    error?: string;
+}
+/**
+ * context - Current LumenFlow context
+ */
+export declare const contextResource: ResourceDefinition;
+/**
+ * wu/{id} - WU specification by ID
+ */
+export declare const wuResource: ResourceDefinition;
+/**
+ * backlog - Current backlog state
+ * Reads the backlog.md file directly (generated by LumenFlow CLI)
+ */
+export declare const backlogResource: ResourceDefinition;
+/**
+ * All static resources (fixed URIs)
+ */
+export declare const staticResources: ResourceDefinition[];
+/**
+ * All resource templates (parameterized URIs)
+ */
+export declare const resourceTemplates: ResourceDefinition[];
+/**
+ * All resources
+ */
+export declare const allResources: ResourceDefinition[];
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACrF;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,kBAuB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,kBAsCxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,kBAyB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,kBAAkB,EAAuC,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,EAAiB,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,kBAAkB,EAA+C,CAAC"}

package/dist/resources.js

@@ -0,0 +1,131 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file resources.ts
+ * @description MCP resource implementations for LumenFlow
+ *
+ * WU-1412: Resources available: context, wu/{id}, backlog
+ *
+ * Resources provide read access to LumenFlow data via URI patterns.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { runCliCommand } from './cli-runner.js';
+// Lazy load core module for context
+let coreModule = null;
+async function getCore() {
+    if (!coreModule) {
+        coreModule = await import('@lumenflow/core');
+    }
+    return coreModule;
+}
+/**
+ * context - Current LumenFlow context
+ */
+export const contextResource = {
+    uri: 'lumenflow://context',
+    name: 'LumenFlow Context',
+    description: 'Current LumenFlow context including location, git state, and active WU',
+    mimeType: 'application/json',
+    async fetch(_uri, options) {
+        try {
+            const core = await getCore();
+            const context = await core.computeWuContext({
+                cwd: options?.projectRoot,
+            });
+            return {
+                success: true,
+                content: JSON.stringify(context, null, 2),
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    },
+};
+/**
+ * wu/{id} - WU specification by ID
+ */
+export const wuResource = {
+    uriTemplate: 'lumenflow://wu/{id}',
+    name: 'Work Unit',
+    description: 'Work Unit specification by ID',
+    mimeType: 'application/json',
+    async fetch(uri, options) {
+        try {
+            // Extract ID from URI: lumenflow://wu/WU-1412 -> WU-1412
+            const match = /^lumenflow:\/\/wu\/(.+)$/.exec(uri);
+            if (!match) {
+                return { success: false, error: 'Invalid WU URI format' };
+            }
+            const id = match[1] ?? '';
+            // Use CLI to get WU status (includes full WU context)
+            const result = await runCliCommand('wu:status', ['--id', id, '--json'], {
+                projectRoot: options?.projectRoot,
+            });
+            if (result.success) {
+                return {
+                    success: true,
+                    content: result.stdout,
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    error: result.stderr || result.error?.message || 'Failed to get WU',
+                };
+            }
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    },
+};
+/**
+ * backlog - Current backlog state
+ * Reads the backlog.md file directly (generated by LumenFlow CLI)
+ */
+export const backlogResource = {
+    uri: 'lumenflow://backlog',
+    name: 'Backlog',
+    description: 'Current LumenFlow backlog with all WUs grouped by status',
+    mimeType: 'text/markdown',
+    async fetch(_uri, options) {
+        try {
+            const projectRoot = options?.projectRoot || process.cwd();
+            // Security: path is constructed from known static segments, not user input
+            const backlogPath = path.join(projectRoot, 'docs', '04-operations', 'tasks', 'backlog.md');
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            const content = await fs.readFile(backlogPath, 'utf-8');
+            return {
+                success: true,
+                content,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+        }
+    },
+};
+/**
+ * All static resources (fixed URIs)
+ */
+export const staticResources = [contextResource, backlogResource];
+/**
+ * All resource templates (parameterized URIs)
+ */
+export const resourceTemplates = [wuResource];
+/**
+ * All resources
+ */
+export const allResources = [...staticResources, ...resourceTemplates];
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.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":"AAIA,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,28 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+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,iCAAiC;AACjC,yCAAyC;AAEzC,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,26 @@
+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,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,36 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @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.
+ */
+import { MS_PER_DAY } from '@lumenflow/core/constants/duration-constants';
+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: MS_PER_DAY,
+    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,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAE1E,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,UAAU;IACtB,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":"AAKA,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"}