@exaudeus/workrail 3.11.2 → 3.12.0

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

@@ -1,7 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleV2ListWorkflows = handleV2ListWorkflows;
 exports.handleV2InspectWorkflow = handleV2InspectWorkflow;
+const path_1 = __importDefault(require("path"));
 const neverthrow_1 = require("neverthrow");
 const types_js_1 = require("../types.js");
 const error_mapper_js_1 = require("../error-mapper.js");
@@ -29,7 +33,7 @@ async function handleV2ListWorkflows(input, ctx) {
         return rememberedRootRecordsResult;
     const rememberedRootRecords = rememberedRootRecordsResult;
     const { crypto, pinnedStore } = guard.ctx.v2;
-    const workflowReader = (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
+    const readerResult = (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
         workspacePath: input.workspacePath,
         resolvedRootUris: guard.ctx.v2.resolvedRootUris,
     })
@@ -39,7 +43,9 @@ async function handleV2ListWorkflows(input, ctx) {
             resolvedRootUris: guard.ctx.v2.resolvedRootUris,
             rememberedRootsStore: guard.ctx.v2.rememberedRootsStore,
         })
-        : ctx.workflowService;
+        : { reader: ctx.workflowService, stalePaths: [] };
+    const workflowReader = readerResult.reader;
+    const stalePaths = readerResult.stalePaths;
     return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(workflowReader.listWorkflowSummaries(), TIMEOUT_MS, 'list_workflows'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err))
         .andThen((summaries) => neverthrow_1.ResultAsync.combine(summaries.map((s) => neverthrow_1.ResultAsync.fromPromise(buildV2WorkflowListItem({
         summary: s,
@@ -48,11 +54,30 @@ async function handleV2ListWorkflows(input, ctx) {
         crypto,
         pinnedStore,
     }), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)))))
-        .map((compiled) => {
-        const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
-            workflows: compiled.sort((a, b) => a.workflowId.localeCompare(b.workflowId)),
+        .andThen((compiled) => {
+        if (!input.includeSources) {
+            const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
+                workflows: compiled.sort((a, b) => a.workflowId.localeCompare(b.workflowId)),
+                ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
+            });
+            return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
+        }
+        if (!(0, workflow_source_visibility_js_1.isCompositeWorkflowReader)(workflowReader)) {
+            const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
+                workflows: compiled.sort((a, b) => a.workflowId.localeCompare(b.workflowId)),
+                ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
+                sources: [],
+            });
+            return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
+        }
+        return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(buildSourceCatalog(workflowReader, rememberedRootRecords), TIMEOUT_MS, 'list_workflow_sources'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)).map((sources) => {
+            const payload = output_schemas_js_1.V2WorkflowListOutputSchema.parse({
+                workflows: compiled.sort((a, b) => a.workflowId.localeCompare(b.workflowId)),
+                ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
+                sources,
+            });
+            return (0, types_js_1.success)(payload);
         });
-        return (0, types_js_1.success)(payload);
     })
         .match((result) => Promise.resolve(result), (err) => Promise.resolve(err));
 }
@@ -68,7 +93,7 @@ async function handleV2InspectWorkflow(input, ctx) {
         return rememberedRootRecordsResult;
     const rememberedRootRecords = rememberedRootRecordsResult;
     const { crypto, pinnedStore } = guard.ctx.v2;
-    const workflowReader = (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
+    const readerResult = (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
         workspacePath: input.workspacePath,
         resolvedRootUris: guard.ctx.v2.resolvedRootUris,
     })
@@ -78,7 +103,9 @@ async function handleV2InspectWorkflow(input, ctx) {
             resolvedRootUris: guard.ctx.v2.resolvedRootUris,
             rememberedRootsStore: guard.ctx.v2.rememberedRootsStore,
         })
-        : ctx.workflowService;
+        : { reader: ctx.workflowService, stalePaths: [] };
+    const workflowReader = readerResult.reader;
+    const stalePaths = readerResult.stalePaths;
     return neverthrow_1.ResultAsync.fromPromise((0, with_timeout_js_1.withTimeout)(workflowReader.getWorkflowById(input.workflowId), TIMEOUT_MS, 'inspect_workflow'), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err))
         .andThen((workflow) => {
         if (!workflow) {
@@ -113,6 +140,7 @@ async function handleV2InspectWorkflow(input, ctx) {
                 mode: input.mode,
                 compiled: body,
                 ...(visibility ? { visibility } : {}),
+                ...(stalePaths.length > 0 ? { staleRoots: [...stalePaths] } : {}),
                 ...(references != null && references.length > 0 ? { references } : {}),
             });
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
@@ -181,3 +209,90 @@ async function buildV2WorkflowListItem(options) {
         visibility,
     };
 }
+async function buildSourceCatalog(workflowReader, rememberedRootRecords) {
+    const instances = workflowReader.getStorageInstances();
+    const seenIds = new Set();
+    const sourceEntryDataReversed = [];
+    for (let i = instances.length - 1; i >= 0; i--) {
+        const instance = instances[i];
+        const summaries = await instance.listWorkflowSummaries();
+        const allIds = summaries.map((s) => s.id);
+        const effectiveIds = allIds.filter((id) => !seenIds.has(id));
+        for (const id of allIds)
+            seenIds.add(id);
+        sourceEntryDataReversed.push({ source: instance.source, allIds, effectiveIds });
+    }
+    const sourceEntryData = sourceEntryDataReversed.reverse();
+    return sourceEntryData.map((data) => deriveSourceCatalogEntry({ ...data, rememberedRootRecords, sourceEntryData }));
+}
+function deriveSourceCatalogEntry(options) {
+    const { source, allIds, effectiveIds, rememberedRootRecords, sourceEntryData } = options;
+    const total = allIds.length;
+    const effective = effectiveIds.length;
+    const shadowed = total - effective;
+    const sourceKey = deriveSourceKey(source);
+    const displayName = deriveDisplayName(source);
+    switch (source.kind) {
+        case 'bundled':
+            return { sourceKey, category: 'built_in', source: { kind: source.kind, displayName }, sourceMode: 'built_in', effectiveWorkflowCount: effective, totalWorkflowCount: total, shadowedWorkflowCount: shadowed };
+        case 'user':
+            return { sourceKey, category: 'personal', source: { kind: source.kind, displayName }, sourceMode: 'personal', effectiveWorkflowCount: effective, totalWorkflowCount: total, shadowedWorkflowCount: shadowed };
+        case 'project': {
+            const thisIds = new Set(allIds);
+            const hasMigrationOverlap = sourceEntryData.some((e) => {
+                if (e.source === source || e.source.kind !== 'custom')
+                    return false;
+                const rootedSharing = deriveRootedSharingForPath(e.source.directoryPath, rememberedRootRecords);
+                return rootedSharing != null && e.allIds.some((id) => thisIds.has(id));
+            });
+            const migration = hasMigrationOverlap
+                ? { preferredSource: 'rooted_sharing', currentSource: 'legacy_project', reason: 'legacy_project_precedence', summary: 'Project-scoped ./workflows currently overrides rooted .workrail/workflows during migration. Prefer rooted sharing for new team-shared workflows.' }
+                : undefined;
+            return { sourceKey, category: 'legacy_project', source: { kind: source.kind, displayName }, sourceMode: 'legacy_project', effectiveWorkflowCount: effective, totalWorkflowCount: total, shadowedWorkflowCount: shadowed, ...(migration ? { migration } : {}) };
+        }
+        case 'custom': {
+            const rootedSharing = deriveRootedSharingForPath(source.directoryPath, rememberedRootRecords);
+            const category = rootedSharing ? 'rooted_sharing' : 'external';
+            const sourceMode = rootedSharing ? 'rooted_sharing' : 'live_directory';
+            return { sourceKey, category, source: { kind: source.kind, displayName }, sourceMode, effectiveWorkflowCount: effective, totalWorkflowCount: total, shadowedWorkflowCount: shadowed, ...(rootedSharing ? { rootedSharing } : {}) };
+        }
+        case 'git':
+        case 'remote':
+        case 'plugin':
+            return { sourceKey, category: 'external', source: { kind: source.kind, displayName }, sourceMode: 'live_directory', effectiveWorkflowCount: effective, totalWorkflowCount: total, shadowedWorkflowCount: shadowed };
+    }
+}
+function deriveSourceKey(source) {
+    switch (source.kind) {
+        case 'bundled': return 'built_in';
+        case 'user': return `user:${source.directoryPath}`;
+        case 'project': return `project:${source.directoryPath}`;
+        case 'custom': return `custom:${source.directoryPath}`;
+        case 'git': return `git:${source.repositoryUrl}`;
+        case 'remote': return `remote:${source.registryUrl}`;
+        case 'plugin': return `plugin:${source.pluginName}`;
+    }
+}
+function deriveDisplayName(source) {
+    switch (source.kind) {
+        case 'bundled': return 'Built-in';
+        case 'user': return 'User Library';
+        case 'project': return 'Project';
+        case 'custom': return source.label ?? path_1.default.basename(source.directoryPath);
+        case 'git': return source.repositoryUrl;
+        case 'remote': return source.registryUrl;
+        case 'plugin': return source.pluginName;
+    }
+}
+function deriveRootedSharingForPath(sourcePath, rememberedRoots) {
+    const resolved = path_1.default.resolve(sourcePath);
+    for (const record of rememberedRoots) {
+        const rootPath = path_1.default.resolve(record.path);
+        const relative = path_1.default.relative(rootPath, resolved);
+        const isUnderRoot = relative.length === 0 || (!relative.startsWith('..') && !path_1.default.isAbsolute(relative));
+        if (!isUnderRoot)
+            continue;
+        return { kind: 'remembered_root', rootPath, groupLabel: (0, workflow_source_visibility_js_1.deriveGroupLabel)(rootPath, resolved) };
+    }
+    return undefined;
+}