@exaudeus/workrail 3.12.0 → 3.14.0

package/dist/mcp/handlers/v2-workflow.js

@@ -3,9 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldShowStaleness = shouldShowStaleness;
+exports.computeWorkflowStaleness = computeWorkflowStaleness;
 exports.handleV2ListWorkflows = handleV2ListWorkflows;
 exports.handleV2InspectWorkflow = handleV2InspectWorkflow;
 const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
 const neverthrow_1 = require("neverthrow");
 const types_js_1 = require("../types.js");
 const error_mapper_js_1 = require("../error-mapper.js");
@@ -14,6 +17,51 @@ const output_schemas_js_1 = require("../output-schemas.js");
 const v1_to_v2_shim_js_1 = require("../../v2/read-only/v1-to-v2-shim.js");
 const hashing_js_1 = require("../../v2/durable-core/canonical/hashing.js");
 const TIMEOUT_MS = 30000;
+function readCurrentSpecVersion() {
+    try {
+        const specPath = path_1.default.resolve(__dirname, '../../../spec/authoring-spec.json');
+        const raw = fs_1.default.readFileSync(specPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === 'object' && parsed !== null && 'version' in parsed) {
+            const v = parsed['version'];
+            if (typeof v === 'number' && Number.isInteger(v) && v >= 1)
+                return v;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+const CURRENT_SPEC_VERSION = readCurrentSpecVersion();
+const DEV_STALENESS = process.env['WORKRAIL_DEV_STALENESS'] === '1';
+function shouldShowStaleness(category, devMode = DEV_STALENESS) {
+    if (devMode)
+        return true;
+    return category === 'personal' || category === 'rooted_sharing' || category === 'external';
+}
+function computeWorkflowStaleness(stamp, currentVersion) {
+    if (currentVersion === null)
+        return undefined;
+    if (stamp === undefined) {
+        return {
+            level: 'possible',
+            reason: 'This workflow has not been validated against the authoring spec via workflow-for-workflows.',
+        };
+    }
+    if (stamp === currentVersion) {
+        return {
+            level: 'none',
+            reason: `Workflow validated against current authoring spec (v${currentVersion}).`,
+            specVersionAtLastReview: stamp,
+        };
+    }
+    return {
+        level: 'likely',
+        reason: `Authoring spec updated from v${stamp} to v${currentVersion} since this workflow was last reviewed.`,
+        specVersionAtLastReview: stamp,
+    };
+}
 const with_timeout_js_1 = require("./shared/with-timeout.js");
 const request_workflow_reader_js_1 = require("./shared/request-workflow-reader.js");
 const remembered_roots_js_1 = require("./shared/remembered-roots.js");
@@ -142,6 +190,12 @@ async function handleV2InspectWorkflow(input, ctx) {
                 ...(visibility ? { visibility } : {}),
                 ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
                 ...(references != null && references.length > 0 ? { references } : {}),
+                ...(() => {
+                    const staleness = shouldShowStaleness(visibility?.category)
+                        ? computeWorkflowStaleness(workflow.definition.validatedAgainstSpecVersion, CURRENT_SPEC_VERSION)
+                        : undefined;
+                    return staleness !== undefined ? { staleness } : {};
+                })(),
             });
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
         }));
@@ -199,6 +253,9 @@ async function buildV2WorkflowListItem(options) {
             };
         }
     }
+    const staleness = shouldShowStaleness(visibility?.category)
+        ? computeWorkflowStaleness(workflow.definition.validatedAgainstSpecVersion, CURRENT_SPEC_VERSION)
+        : undefined;
     return {
         workflowId: summary.id,
         name: summary.name,
@@ -207,6 +264,7 @@ async function buildV2WorkflowListItem(options) {
         workflowHash: hash,
         kind: 'workflow',
         visibility,
+        ...(staleness !== undefined ? { staleness } : {}),
     };
 }
 async function buildSourceCatalog(workflowReader, rememberedRootRecords) {

package/dist/mcp/output-schemas.d.ts

@@ -152,6 +152,20 @@ export declare const WorkflowGetSchemaOutputSchema: z.ZodObject<{
         stepStructure: Record<string, string>;
     };
 }>;
+export declare const StalenessSummarySchema: z.ZodObject<{
+    level: z.ZodEnum<["none", "possible", "likely"]>;
+    reason: z.ZodString;
+    specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    level: "none" | "possible" | "likely";
+    reason: string;
+    specVersionAtLastReview?: number | undefined;
+}, {
+    level: "none" | "possible" | "likely";
+    reason: string;
+    specVersionAtLastReview?: number | undefined;
+}>;
+export type StalenessSummary = z.infer<typeof StalenessSummarySchema>;
 export declare const V2WorkflowListItemSchema: z.ZodObject<{
     workflowId: z.ZodString;
     name: z.ZodString;
@@ -235,6 +249,19 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     }>>;
+    staleness: z.ZodOptional<z.ZodObject<{
+        level: z.ZodEnum<["none", "possible", "likely"]>;
+        reason: z.ZodString;
+        specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     kind: "workflow";
     name: string;
@@ -260,6 +287,11 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
 }, {
     kind: "workflow";
     name: string;
@@ -285,6 +317,11 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
 }>;
 export declare const V2WorkflowSourceCatalogEntrySchema: z.ZodObject<{
     sourceKey: z.ZodString;
@@ -461,6 +498,19 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         }>>;
+        staleness: z.ZodOptional<z.ZodObject<{
+            level: z.ZodEnum<["none", "possible", "likely"]>;
+            reason: z.ZodString;
+            specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        }, {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         kind: "workflow";
         name: string;
@@ -486,6 +536,11 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }, {
         kind: "workflow";
         name: string;
@@ -511,6 +566,11 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }>, "many">;
     staleRoots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -630,6 +690,11 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }[];
     sources?: {
         source: {
@@ -681,6 +746,11 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
                 currentSource: "legacy_project";
             } | undefined;
         } | undefined;
+        staleness?: {
+            level: "none" | "possible" | "likely";
+            reason: string;
+            specVersionAtLastReview?: number | undefined;
+        } | undefined;
     }[];
     sources?: {
         source: {
@@ -811,6 +881,19 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
         authoritative: boolean;
         resolveFrom?: "workspace" | "package" | undefined;
     }>, "many">>;
+    staleness: z.ZodOptional<z.ZodObject<{
+        level: z.ZodEnum<["none", "possible", "likely"]>;
+        reason: z.ZodString;
+        specVersionAtLastReview: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }, {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     workflowId: string;
     workflowHash: string;
@@ -842,6 +925,11 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
     staleRoots?: string[] | undefined;
 }, {
     workflowId: string;
@@ -874,6 +962,11 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
             currentSource: "legacy_project";
         } | undefined;
     } | undefined;
+    staleness?: {
+        level: "none" | "possible" | "likely";
+        reason: string;
+        specVersionAtLastReview?: number | undefined;
+    } | undefined;
     staleRoots?: string[] | undefined;
 }>;
 export declare const V2PendingStepSchema: z.ZodObject<{

package/dist/mcp/output-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2CheckpointWorkflowOutputSchema = exports.V2ResumeSessionOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.V2StepContextSchema = exports.V2BindingDriftWarningSchema = exports.V2BlockerReportSchema = exports.V2ResumeNextCallSchema = exports.V2NextCallSchema = exports.V2NextIntentSchema = exports.V2PreferencesSchema = exports.V2PendingStepSchema = exports.V2WorkflowInspectOutputSchema = exports.V2WorkflowListOutputSchema = exports.V2WorkflowSourceCatalogEntrySchema = exports.V2WorkflowListItemSchema = exports.WorkflowGetSchemaOutputSchema = exports.WorkflowValidateJsonOutputSchema = exports.WorkflowNextOutputSchema = exports.WorkflowGetOutputSchema = exports.WorkflowListOutputSchema = exports.WorkflowSummarySchema = exports.JsonValueSchema = void 0;
+exports.OpenDashboardOutputSchema = exports.ReadSessionSchemaOutputSchema = exports.ReadSessionOutputSchema = exports.UpdateSessionOutputSchema = exports.CreateSessionOutputSchema = exports.V2StartWorkflowOutputSchema = exports.V2CheckpointWorkflowOutputSchema = exports.V2ResumeSessionOutputSchema = exports.V2ContinueWorkflowOutputSchema = exports.V2StepContextSchema = exports.V2BindingDriftWarningSchema = exports.V2BlockerReportSchema = exports.V2ResumeNextCallSchema = exports.V2NextCallSchema = exports.V2NextIntentSchema = exports.V2PreferencesSchema = exports.V2PendingStepSchema = exports.V2WorkflowInspectOutputSchema = exports.V2WorkflowListOutputSchema = exports.V2WorkflowSourceCatalogEntrySchema = exports.V2WorkflowListItemSchema = exports.StalenessSummarySchema = exports.WorkflowGetSchemaOutputSchema = exports.WorkflowValidateJsonOutputSchema = exports.WorkflowNextOutputSchema = exports.WorkflowGetOutputSchema = exports.WorkflowListOutputSchema = exports.WorkflowSummarySchema = exports.JsonValueSchema = void 0;
 exports.toPendingStep = toPendingStep;
 const zod_1 = require("zod");
 const state_js_1 = require("../domain/execution/state.js");
@@ -48,6 +48,11 @@ exports.WorkflowGetSchemaOutputSchema = zod_1.z.object({
         stepStructure: zod_1.z.record(zod_1.z.string()),
     }),
 });
+exports.StalenessSummarySchema = zod_1.z.object({
+    level: zod_1.z.enum(['none', 'possible', 'likely']),
+    reason: zod_1.z.string().min(1),
+    specVersionAtLastReview: zod_1.z.number().int().positive().optional(),
+});
 exports.V2WorkflowListItemSchema = zod_1.z.object({
     workflowId: zod_1.z.string().min(1),
     name: zod_1.z.string().min(1),
@@ -73,6 +78,7 @@ exports.V2WorkflowListItemSchema = zod_1.z.object({
             summary: zod_1.z.string().min(1),
         }).optional(),
     }).optional(),
+    staleness: exports.StalenessSummarySchema.optional(),
 });
 exports.V2WorkflowSourceCatalogEntrySchema = zod_1.z.object({
     sourceKey: zod_1.z.string().min(1).describe('Stable identifier for this source. Format: "{kind}:{absolutePath}" for filesystem sources (e.g. "project:/path/to/workflows", "custom:/path/to/.workrail/workflows"), or "built_in" for bundled sources.'),
@@ -122,6 +128,7 @@ exports.V2WorkflowInspectOutputSchema = zod_1.z.object({
         authoritative: zod_1.z.boolean(),
         resolveFrom: zod_1.z.enum(['workspace', 'package']).optional(),
     })).optional(),
+    staleness: exports.StalenessSummarySchema.optional(),
 });
 exports.V2PendingStepSchema = zod_1.z.object({
     stepId: zod_1.z.string().min(1),

package/dist/mcp/server.js

@@ -110,6 +110,7 @@ async function createToolContext() {
                 console.error(`[V2Init] Token alias index load warning: ${aliasLoadResult.error.message}`);
             }
             const rememberedRootsStore = container_js_1.container.resolve(tokens_js_1.DI.V2.RememberedRootsStore);
+            const managedSourceStore = container_js_1.container.resolve(tokens_js_1.DI.V2.ManagedSourceStore);
             v2 = {
                 gate,
                 sessionStore,
@@ -122,6 +123,7 @@ async function createToolContext() {
                 tokenCodecPorts,
                 tokenAliasStore,
                 rememberedRootsStore,
+                managedSourceStore,
                 validationPipelineDeps,
                 resolvedRootUris: [],
                 workspaceResolver: new index_js_1.LocalWorkspaceAnchorV2(process.cwd()),

package/dist/mcp/tool-descriptions.js

@@ -73,6 +73,16 @@ Remember: inspecting is read-only. Call start_workflow when ready to begin.`,
         continue_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CONTINUE_WORKFLOW_PROTOCOL, 'standard'),
         checkpoint_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CHECKPOINT_WORKFLOW_PROTOCOL, 'standard'),
         resume_session: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.RESUME_SESSION_PROTOCOL, 'standard'),
+        manage_workflow_source: `Attach or detach a workflow directory as a managed source.
+
+Use this to explicitly add a directory containing workflow files so its workflows appear in list_workflows as managed entries.
+
+Parameters:
+- action: "attach" to add a directory, "detach" to remove it. Both are idempotent.
+- path: absolute filesystem path to the workflow directory
+
+Attach is idempotent: attaching an already-attached path is a no-op.
+Detach is idempotent: detaching an absent path is a no-op.`,
     },
     authoritative: {
         discover_workflows: `Check for workflows that apply to the user's request. Workflows are the user's pre-defined instructions that you MUST follow when they exist.
@@ -150,5 +160,15 @@ This is read-only. Call start_workflow when ready to commit to following the wor
         continue_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CONTINUE_WORKFLOW_PROTOCOL, 'authoritative'),
         checkpoint_workflow: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.CHECKPOINT_WORKFLOW_PROTOCOL, 'authoritative'),
         resume_session: (0, workflow_protocol_contracts_js_1.renderProtocolDescription)(workflow_protocol_contracts_js_1.RESUME_SESSION_PROTOCOL, 'authoritative'),
+        manage_workflow_source: `Attach or detach a workflow directory as a managed source.
+
+When the user wants to register an external workflow directory, use attach. When they want to remove it, use detach. Both are idempotent.
+
+Parameters:
+- action: "attach" to add a directory, "detach" to remove it. Both are idempotent.
+- path: absolute filesystem path to the workflow directory
+
+Attach is idempotent: attaching an already-attached path is a no-op.
+Detach is idempotent: detaching an absent path is a no-op.`,
     },
 };

package/dist/mcp/tools.js

@@ -92,6 +92,11 @@ exports.WORKFLOW_TOOL_ANNOTATIONS = {
         destructiveHint: false,
         idempotentHint: true,
     },
+    manage_workflow_source: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+    },
 };
 exports.WORKFLOW_TOOL_TITLES = {
     discover_workflows: 'Discover Available Workflows',
@@ -105,6 +110,7 @@ exports.WORKFLOW_TOOL_TITLES = {
     continue_workflow: 'Continue Workflow (v2)',
     checkpoint_workflow: 'Checkpoint Workflow (v2)',
     resume_session: 'Resume Session (v2)',
+    manage_workflow_source: 'Manage Workflow Source (v2)',
 };
 exports.CreateSessionInput = zod_1.z.object({
     workflowId: zod_1.z

package/dist/mcp/types/tool-description-types.d.ts

@@ -1,6 +1,6 @@
 export declare const DESCRIPTION_MODES: readonly ["standard", "authoritative"];
 export type DescriptionMode = typeof DESCRIPTION_MODES[number];
-export declare const WORKFLOW_TOOL_NAMES: readonly ["discover_workflows", "preview_workflow", "advance_workflow", "validate_workflow", "get_workflow_schema", "list_workflows", "inspect_workflow", "start_workflow", "continue_workflow", "checkpoint_workflow", "resume_session"];
+export declare const WORKFLOW_TOOL_NAMES: readonly ["discover_workflows", "preview_workflow", "advance_workflow", "validate_workflow", "get_workflow_schema", "list_workflows", "inspect_workflow", "start_workflow", "continue_workflow", "checkpoint_workflow", "resume_session", "manage_workflow_source"];
 export type WorkflowToolName = typeof WORKFLOW_TOOL_NAMES[number];
 export type ToolDescriptionMap = Readonly<Record<WorkflowToolName, string>>;
 export type DescriptionsByMode = Readonly<Record<DescriptionMode, ToolDescriptionMap>>;

package/dist/mcp/types/tool-description-types.js

@@ -19,6 +19,7 @@ exports.WORKFLOW_TOOL_NAMES = [
     'continue_workflow',
     'checkpoint_workflow',
     'resume_session',
+    'manage_workflow_source',
 ];
 function isDescriptionMode(value) {
     return exports.DESCRIPTION_MODES.includes(value);

package/dist/mcp/types/workflow-tool-edition.d.ts

@@ -2,7 +2,7 @@ import type { z } from 'zod';
 import type { ToolDefinition } from '../tool-factory.js';
 import type { ToolContext } from '../types.js';
 export type V1WorkflowToolName = 'discover_workflows' | 'preview_workflow' | 'advance_workflow' | 'validate_workflow' | 'get_workflow_schema';
-export type V2WorkflowToolName = 'list_workflows' | 'inspect_workflow' | 'start_workflow' | 'continue_workflow' | 'checkpoint_workflow' | 'resume_session';
+export type V2WorkflowToolName = 'list_workflows' | 'inspect_workflow' | 'start_workflow' | 'continue_workflow' | 'checkpoint_workflow' | 'resume_session' | 'manage_workflow_source';
 export type McpCallToolResult = {
     readonly content: ReadonlyArray<{
         readonly type: 'text';

package/dist/mcp/types.d.ts

@@ -20,6 +20,7 @@ import type { ValidationPipelineDepsPhase1a } from '../application/services/work
 import type { TokenAliasStorePortV2 } from '../v2/ports/token-alias-store.port.js';
 import type { RandomEntropyPortV2 } from '../v2/ports/random-entropy.port.js';
 import type { RememberedRootsStorePortV2 } from '../v2/ports/remembered-roots-store.port.js';
+import type { ManagedSourceStorePortV2 } from '../v2/ports/managed-source-store.port.js';
 export interface SessionHealthDetails {
     readonly health: SessionHealthV2;
 }
@@ -61,6 +62,7 @@ export interface V2Dependencies {
     readonly tokenCodecPorts: TokenCodecPorts;
     readonly tokenAliasStore: TokenAliasStorePortV2;
     readonly rememberedRootsStore?: RememberedRootsStorePortV2;
+    readonly managedSourceStore?: ManagedSourceStorePortV2;
     readonly entropy: RandomEntropyPortV2;
     readonly validationPipelineDeps: ValidationPipelineDepsPhase1a;
     readonly resolvedRootUris?: readonly string[];

package/dist/mcp/v2/tool-registry.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildV2ToolRegistry = buildV2ToolRegistry;
 const handler_factory_js_1 = require("../handler-factory.js");
 const tools_js_1 = require("./tools.js");
+const v2_manage_workflow_source_js_1 = require("../handlers/v2-manage-workflow-source.js");
 const v2_execution_js_1 = require("../handlers/v2-execution.js");
 const v2_workflow_js_1 = require("../handlers/v2-workflow.js");
 const v2_checkpoint_js_1 = require("../handlers/v2-checkpoint.js");
@@ -46,6 +47,12 @@ function buildV2ToolRegistry(buildTool) {
             inputSchema: tools_js_1.V2ResumeSessionInput,
             annotations: tools_js_1.V2_TOOL_ANNOTATIONS.resume_session,
         }),
+        buildTool({
+            name: 'manage_workflow_source',
+            title: tools_js_1.V2_TOOL_TITLES.manage_workflow_source,
+            inputSchema: tools_js_1.V2ManageWorkflowSourceInput,
+            annotations: tools_js_1.V2_TOOL_ANNOTATIONS.manage_workflow_source,
+        }),
     ];
     const handlers = {
         list_workflows: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ListWorkflowsInput, v2_workflow_js_1.handleV2ListWorkflows),
@@ -54,6 +61,7 @@ function buildV2ToolRegistry(buildTool) {
         continue_workflow: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ContinueWorkflowInput, v2_execution_js_1.handleV2ContinueWorkflow, tools_js_1.V2ContinueWorkflowInputShape, workflow_protocol_contracts_js_1.CONTINUE_WORKFLOW_PROTOCOL.aliasMap),
         checkpoint_workflow: (0, handler_factory_js_1.createHandler)(tools_js_1.V2CheckpointWorkflowInput, v2_checkpoint_js_1.handleV2CheckpointWorkflow),
         resume_session: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ResumeSessionInput, v2_resume_js_1.handleV2ResumeSession),
+        manage_workflow_source: (0, handler_factory_js_1.createHandler)(tools_js_1.V2ManageWorkflowSourceInput, v2_manage_workflow_source_js_1.handleV2ManageWorkflowSource),
     };
     return { tools, handlers };
 }

package/dist/mcp/v2/tools.d.ts

@@ -174,6 +174,17 @@ export declare const V2ResumeSessionInput: z.ZodObject<{
     sameWorkspaceOnly?: boolean | undefined;
 }>;
 export type V2ResumeSessionInput = z.infer<typeof V2ResumeSessionInput>;
+export declare const V2ManageWorkflowSourceInput: z.ZodObject<{
+    action: z.ZodEnum<["attach", "detach"]>;
+    path: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    action: "attach" | "detach";
+}, {
+    path: string;
+    action: "attach" | "detach";
+}>;
+export type V2ManageWorkflowSourceInput = z.infer<typeof V2ManageWorkflowSourceInput>;
 export declare const V2CheckpointWorkflowInput: z.ZodObject<{
     checkpointToken: z.ZodString;
 }, "strict", z.ZodTypeAny, {
@@ -189,5 +200,6 @@ export declare const V2_TOOL_TITLES: {
     readonly continue_workflow: "Continue Workflow (v2)";
     readonly checkpoint_workflow: "Checkpoint Workflow (v2)";
     readonly resume_session: "Resume Session (v2)";
+    readonly manage_workflow_source: "Manage Workflow Source (v2)";
 };
 export declare const V2_TOOL_ANNOTATIONS: Readonly<Record<keyof typeof V2_TOOL_TITLES, ToolAnnotations>>;

package/dist/mcp/v2/tools.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.V2_TOOL_ANNOTATIONS = exports.V2_TOOL_TITLES = exports.V2CheckpointWorkflowInput = exports.V2ResumeSessionInput = exports.V2ContinueWorkflowInput = exports.V2ContinueWorkflowInputShape = exports.V2StartWorkflowInput = exports.V2InspectWorkflowInput = exports.V2ListWorkflowsInput = void 0;
+exports.V2_TOOL_ANNOTATIONS = exports.V2_TOOL_TITLES = exports.V2CheckpointWorkflowInput = exports.V2ManageWorkflowSourceInput = exports.V2ResumeSessionInput = exports.V2ContinueWorkflowInput = exports.V2ContinueWorkflowInputShape = exports.V2StartWorkflowInput = exports.V2InspectWorkflowInput = exports.V2ListWorkflowsInput = void 0;
 const path_1 = __importDefault(require("path"));
 const zod_1 = require("zod");
 const workflow_protocol_contracts_js_1 = require("../workflow-protocol-contracts.js");
@@ -112,6 +112,10 @@ exports.V2ResumeSessionInput = zod_1.z.object({
     sameWorkspaceOnly: zod_1.z.boolean().optional().describe('If true, only sessions from the same repo/workspace are considered when repo_root_hash is available. ' +
         'Use this when the user clearly means "resume work from this repo only".'),
 }).strict();
+exports.V2ManageWorkflowSourceInput = zod_1.z.object({
+    action: zod_1.z.enum(['attach', 'detach']).describe('The operation to perform. "attach" registers the directory as a managed workflow source; "detach" removes it. Both operations are idempotent.'),
+    path: zod_1.z.string().min(1).refine((p) => path_1.default.isAbsolute(p), 'path must be an absolute path').describe('Absolute filesystem path to the workflow directory to attach or detach. Must be an absolute path. The path is normalized (resolved) before storage.'),
+}).strict();
 exports.V2CheckpointWorkflowInput = zod_1.z.object({
     checkpointToken: zod_1.z.string().min(1).describe('The checkpoint token from the most recent start_workflow or continue_workflow response. ' +
         'Creates a checkpoint on the current step without advancing. Idempotent — calling with the same token is safe.'),
@@ -123,6 +127,7 @@ exports.V2_TOOL_TITLES = {
     continue_workflow: 'Continue Workflow (v2)',
     checkpoint_workflow: 'Checkpoint Workflow (v2)',
     resume_session: 'Resume Session (v2)',
+    manage_workflow_source: 'Manage Workflow Source (v2)',
 };
 exports.V2_TOOL_ANNOTATIONS = {
     list_workflows: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
@@ -131,4 +136,5 @@ exports.V2_TOOL_ANNOTATIONS = {
     continue_workflow: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
     checkpoint_workflow: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
     resume_session: { readOnlyHint: true, destructiveHint: false, idempotentHint: true },
+    manage_workflow_source: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
 };

package/dist/types/workflow-definition.d.ts

@@ -134,6 +134,7 @@ export interface WorkflowDefinition {
     readonly assessments?: readonly AssessmentDefinition[];
     readonly extensionPoints?: readonly ExtensionPoint[];
     readonly references?: readonly WorkflowReference[];
+    readonly validatedAgainstSpecVersion?: number;
 }
 export declare function isLoopStepDefinition(step: WorkflowStepDefinition | LoopStepDefinition): step is LoopStepDefinition;
 export declare function isWorkflowStepDefinition(step: WorkflowStepDefinition | LoopStepDefinition): step is WorkflowStepDefinition;

package/dist/v2/infra/in-memory/managed-source-store/index.d.ts

@@ -0,0 +1,8 @@
+import type { ResultAsync } from 'neverthrow';
+import type { ManagedSourceRecordV2, ManagedSourceStoreError, ManagedSourceStorePortV2 } from '../../../ports/managed-source-store.port.js';
+export declare class InMemoryManagedSourceStoreV2 implements ManagedSourceStorePortV2 {
+    private readonly sources;
+    list(): ResultAsync<readonly ManagedSourceRecordV2[], ManagedSourceStoreError>;
+    attach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+    detach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+}

package/dist/v2/infra/in-memory/managed-source-store/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryManagedSourceStoreV2 = void 0;
+const path_1 = __importDefault(require("path"));
+const neverthrow_1 = require("neverthrow");
+class InMemoryManagedSourceStoreV2 {
+    constructor() {
+        this.sources = [];
+    }
+    list() {
+        return (0, neverthrow_1.okAsync)([...this.sources]);
+    }
+    attach(sourcePath) {
+        const normalizedPath = path_1.default.resolve(sourcePath);
+        const alreadyPresent = this.sources.some((s) => s.path === normalizedPath);
+        if (!alreadyPresent) {
+            this.sources.push({ path: normalizedPath, addedAtMs: Date.now() });
+        }
+        return (0, neverthrow_1.okAsync)(undefined);
+    }
+    detach(sourcePath) {
+        const normalizedPath = path_1.default.resolve(sourcePath);
+        const index = this.sources.findIndex((s) => s.path === normalizedPath);
+        if (index !== -1) {
+            this.sources.splice(index, 1);
+        }
+        return (0, neverthrow_1.okAsync)(undefined);
+    }
+}
+exports.InMemoryManagedSourceStoreV2 = InMemoryManagedSourceStoreV2;

package/dist/v2/infra/local/data-dir/index.d.ts

@@ -19,4 +19,6 @@ export declare class LocalDataDirV2 implements DataDirPortV2 {
     sessionManifestPath(sessionId: SessionId): string;
     sessionLockPath(sessionId: SessionId): string;
     tokenIndexPath(): string;
+    managedSourcesPath(): string;
+    managedSourcesLockPath(): string;
 }

package/dist/v2/infra/local/data-dir/index.js

@@ -89,5 +89,11 @@ class LocalDataDirV2 {
     tokenIndexPath() {
         return path.join(this.keysDir(), 'token-index.jsonl');
     }
+    managedSourcesPath() {
+        return path.join(this.root(), 'managed-sources', 'managed-sources.json');
+    }
+    managedSourcesLockPath() {
+        return path.join(this.root(), 'managed-sources', 'managed-sources.lock');
+    }
 }
 exports.LocalDataDirV2 = LocalDataDirV2;

package/dist/v2/infra/local/managed-source-store/index.d.ts

@@ -0,0 +1,15 @@
+import type { ResultAsync } from 'neverthrow';
+import type { DataDirPortV2 } from '../../../ports/data-dir.port.js';
+import type { FileSystemPortV2 } from '../../../ports/fs.port.js';
+import type { ManagedSourceRecordV2, ManagedSourceStoreError, ManagedSourceStorePortV2 } from '../../../ports/managed-source-store.port.js';
+export declare class LocalManagedSourceStoreV2 implements ManagedSourceStorePortV2 {
+    private readonly dataDir;
+    private readonly fs;
+    constructor(dataDir: DataDirPortV2, fs: FileSystemPortV2);
+    list(): ResultAsync<readonly ManagedSourceRecordV2[], ManagedSourceStoreError>;
+    attach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+    detach(sourcePath: string): ResultAsync<void, ManagedSourceStoreError>;
+    private readSources;
+    private persist;
+    private withLock;
+}