@exaudeus/workrail 3.8.2 → 3.9.0

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

@@ -7,6 +7,7 @@ const v2_token_ops_js_1 = require("./v2-token-ops.js");
 const index_js_1 = require("../../v2/durable-core/ids/index.js");
 const resume_session_js_1 = require("../../v2/usecases/resume-session.js");
 const v2_workspace_resolution_js_1 = require("./v2-workspace-resolution.js");
+const remembered_roots_js_1 = require("./shared/remembered-roots.js");
 function anchorValue(anchors, key) {
     const anchor = anchors.find((a) => a.key === key);
     return anchor?.value;
@@ -19,6 +20,9 @@ async function handleV2ResumeSession(input, ctx) {
     if (!v2.sessionSummaryProvider) {
         return (0, types_js_1.errNotRetryable)('INTERNAL_ERROR', 'resume_session requires sessionSummaryProvider port');
     }
+    const rememberedRootFailure = await (0, remembered_roots_js_1.rememberExplicitWorkspaceRoot)(input.workspacePath, v2.rememberedRootsStore);
+    if (rememberedRootFailure)
+        return rememberedRootFailure;
     const anchorsResult = await (0, v2_workspace_resolution_js_1.resolveWorkspaceAnchors)(v2, input.workspacePath);
     const anchors = anchorsResult.isOk() ? anchorsResult.value : [];
     const query = {

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

@@ -12,71 +12,42 @@ const hashing_js_1 = require("../../v2/durable-core/canonical/hashing.js");
 const TIMEOUT_MS = 30000;
 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");
+const workflow_source_visibility_js_1 = require("./shared/workflow-source-visibility.js");
+function isToolErrorResult(value) {
+    return !Array.isArray(value);
+}
 async function handleV2ListWorkflows(input, ctx) {
     const guard = (0, types_js_1.requireV2Context)(ctx);
     if (!guard.ok)
         return guard.error;
+    const rememberedRootFailure = await (0, remembered_roots_js_1.rememberExplicitWorkspaceRoot)(input.workspacePath, guard.ctx.v2.rememberedRootsStore);
+    if (rememberedRootFailure)
+        return rememberedRootFailure;
+    const rememberedRootRecordsResult = await (0, remembered_roots_js_1.listRememberedRootRecords)(guard.ctx.v2.rememberedRootsStore);
+    if (isToolErrorResult(rememberedRootRecordsResult))
+        return rememberedRootRecordsResult;
+    const rememberedRootRecords = rememberedRootRecordsResult;
     const { crypto, pinnedStore } = guard.ctx.v2;
     const workflowReader = (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
         workspacePath: input.workspacePath,
         resolvedRootUris: guard.ctx.v2.resolvedRootUris,
     })
-        ? (0, request_workflow_reader_js_1.createWorkflowReaderForRequest)({
+        ? await (0, request_workflow_reader_js_1.createWorkflowReaderForRequest)({
             featureFlags: ctx.featureFlags,
             workspacePath: input.workspacePath,
             resolvedRootUris: guard.ctx.v2.resolvedRootUris,
+            rememberedRootsStore: guard.ctx.v2.rememberedRootsStore,
         })
         : ctx.workflowService;
     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(workflowReader.getWorkflowById(s.id), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)).andThen((wf) => {
-        if (!wf) {
-            return (0, neverthrow_1.okAsync)({
-                workflowId: s.id,
-                name: s.name,
-                description: s.description,
-                version: s.version,
-                workflowHash: null,
-                kind: 'workflow',
-            });
-        }
-        const snapshot = (0, v1_to_v2_shim_js_1.compileV1WorkflowToV2PreviewSnapshot)(wf);
-        const hashRes = (0, hashing_js_1.workflowHashForCompiledSnapshot)(snapshot, crypto);
-        if (hashRes.isErr()) {
-            return (0, neverthrow_1.okAsync)({
-                workflowId: s.id,
-                name: s.name,
-                description: s.description,
-                version: s.version,
-                workflowHash: null,
-                kind: 'workflow',
-            });
-        }
-        const hash = hashRes.value;
-        return pinnedStore
-            .get(hash)
-            .andThen((existing) => {
-            if (!existing) {
-                return pinnedStore.put(hash, snapshot).map(() => undefined);
-            }
-            return (0, neverthrow_1.okAsync)(undefined);
-        })
-            .map(() => ({
-            workflowId: s.id,
-            name: s.name,
-            description: s.description,
-            version: s.version,
-            workflowHash: hash,
-            kind: 'workflow',
-        }))
-            .orElse(() => (0, neverthrow_1.okAsync)({
-            workflowId: s.id,
-            name: s.name,
-            description: s.description,
-            version: s.version,
-            workflowHash: hash,
-            kind: 'workflow',
-        }));
-    }))))
+        .andThen((summaries) => neverthrow_1.ResultAsync.combine(summaries.map((s) => neverthrow_1.ResultAsync.fromPromise(buildV2WorkflowListItem({
+        summary: s,
+        workflowReader,
+        rememberedRootRecords,
+        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)),
@@ -89,15 +60,23 @@ async function handleV2InspectWorkflow(input, ctx) {
     const guard = (0, types_js_1.requireV2Context)(ctx);
     if (!guard.ok)
         return guard.error;
+    const rememberedRootFailure = await (0, remembered_roots_js_1.rememberExplicitWorkspaceRoot)(input.workspacePath, guard.ctx.v2.rememberedRootsStore);
+    if (rememberedRootFailure)
+        return rememberedRootFailure;
+    const rememberedRootRecordsResult = await (0, remembered_roots_js_1.listRememberedRootRecords)(guard.ctx.v2.rememberedRootsStore);
+    if (isToolErrorResult(rememberedRootRecordsResult))
+        return rememberedRootRecordsResult;
+    const rememberedRootRecords = rememberedRootRecordsResult;
     const { crypto, pinnedStore } = guard.ctx.v2;
     const workflowReader = (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
         workspacePath: input.workspacePath,
         resolvedRootUris: guard.ctx.v2.resolvedRootUris,
     })
-        ? (0, request_workflow_reader_js_1.createWorkflowReaderForRequest)({
+        ? await (0, request_workflow_reader_js_1.createWorkflowReaderForRequest)({
             featureFlags: ctx.featureFlags,
             workspacePath: input.workspacePath,
             resolvedRootUris: guard.ctx.v2.resolvedRootUris,
+            rememberedRootsStore: guard.ctx.v2.rememberedRootsStore,
         })
         : ctx.workflowService;
     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))
@@ -111,7 +90,7 @@ async function handleV2InspectWorkflow(input, ctx) {
             return (0, neverthrow_1.errAsync)((0, types_js_1.errNotRetryable)('INTERNAL_ERROR', 'WorkRail could not compute a content hash for the workflow definition. This is not caused by your input.', { suggestion: (0, v2_execution_helpers_js_1.internalSuggestion)('Retry inspect_workflow.', 'WorkRail has an internal error computing workflow hashes.') }));
         }
         const workflowHash = hashRes.value;
-        return pinnedStore
+        return neverthrow_1.ResultAsync.fromPromise(buildWorkflowVisibility(workflow, workflowReader, rememberedRootRecords), (err) => (0, error_mapper_js_1.mapUnknownErrorToToolError)(err)).andThen((visibility) => pinnedStore
             .get(workflowHash)
             .andThen((existing) => {
             if (!existing) {
@@ -133,10 +112,72 @@ async function handleV2InspectWorkflow(input, ctx) {
                 workflowHash,
                 mode: input.mode,
                 compiled: body,
+                ...(visibility ? { visibility } : {}),
                 ...(references != null && references.length > 0 ? { references } : {}),
             });
             return (0, neverthrow_1.okAsync)((0, types_js_1.success)(payload));
-        });
+        }));
     })
         .match((result) => Promise.resolve(result), (err) => Promise.resolve(err));
 }
+async function buildWorkflowVisibility(workflow, workflowReader, rememberedRootRecords) {
+    const migration = await (0, workflow_source_visibility_js_1.detectWorkflowMigrationGuidance)({
+        workflow,
+        workflowReader: workflowReader,
+        rememberedRoots: rememberedRootRecords,
+    });
+    return (0, workflow_source_visibility_js_1.toWorkflowVisibility)(workflow, rememberedRootRecords, { migration });
+}
+async function buildV2WorkflowListItem(options) {
+    const { summary, workflowReader, rememberedRootRecords, crypto, pinnedStore } = options;
+    const workflow = await workflowReader.getWorkflowById(summary.id);
+    if (!workflow) {
+        return {
+            workflowId: summary.id,
+            name: summary.name,
+            description: summary.description,
+            version: summary.version,
+            workflowHash: null,
+            kind: 'workflow',
+        };
+    }
+    const visibility = await buildWorkflowVisibility(workflow, workflowReader, rememberedRootRecords);
+    const snapshot = (0, v1_to_v2_shim_js_1.compileV1WorkflowToV2PreviewSnapshot)(workflow);
+    const hashRes = (0, hashing_js_1.workflowHashForCompiledSnapshot)(snapshot, crypto);
+    if (hashRes.isErr()) {
+        return {
+            workflowId: summary.id,
+            name: summary.name,
+            description: summary.description,
+            version: summary.version,
+            workflowHash: null,
+            kind: 'workflow',
+            visibility,
+        };
+    }
+    const hash = hashRes.value;
+    const existing = await pinnedStore.get(hash);
+    if (existing.isOk() && !existing.value) {
+        const persisted = await pinnedStore.put(hash, snapshot);
+        if (persisted.isErr()) {
+            return {
+                workflowId: summary.id,
+                name: summary.name,
+                description: summary.description,
+                version: summary.version,
+                workflowHash: hash,
+                kind: 'workflow',
+                visibility,
+            };
+        }
+    }
+    return {
+        workflowId: summary.id,
+        name: summary.name,
+        description: summary.description,
+        version: summary.version,
+        workflowHash: hash,
+        kind: 'workflow',
+        visibility,
+    };
+}

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

@@ -159,6 +159,82 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
     version: z.ZodString;
     kind: z.ZodLiteral<"workflow">;
     workflowHash: z.ZodNullable<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodObject<{
+        category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external"]>;
+        source: z.ZodObject<{
+            kind: z.ZodEnum<["bundled", "user", "project", "custom", "git", "remote", "plugin"]>;
+            displayName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        }, {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        }>;
+        rootedSharing: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"remembered_root">;
+            rootPath: z.ZodString;
+            groupLabel: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        }, {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        }>>;
+        migration: z.ZodOptional<z.ZodObject<{
+            preferredSource: z.ZodLiteral<"rooted_sharing">;
+            currentSource: z.ZodLiteral<"legacy_project">;
+            reason: z.ZodLiteral<"legacy_project_precedence">;
+            summary: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        }, {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }, {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     kind: "workflow";
     name: string;
@@ -166,6 +242,24 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
     version: string;
     workflowId: string;
     workflowHash: string | null;
+    visibility?: {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    } | undefined;
 }, {
     kind: "workflow";
     name: string;
@@ -173,6 +267,24 @@ export declare const V2WorkflowListItemSchema: z.ZodObject<{
     version: string;
     workflowId: string;
     workflowHash: string | null;
+    visibility?: {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    } | undefined;
 }>;
 export declare const V2WorkflowListOutputSchema: z.ZodObject<{
     workflows: z.ZodArray<z.ZodObject<{
@@ -182,6 +294,82 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: z.ZodString;
         kind: z.ZodLiteral<"workflow">;
         workflowHash: z.ZodNullable<z.ZodString>;
+        visibility: z.ZodOptional<z.ZodObject<{
+            category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external"]>;
+            source: z.ZodObject<{
+                kind: z.ZodEnum<["bundled", "user", "project", "custom", "git", "remote", "plugin"]>;
+                displayName: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            }, {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            }>;
+            rootedSharing: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodLiteral<"remembered_root">;
+                rootPath: z.ZodString;
+                groupLabel: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            }, {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            }>>;
+            migration: z.ZodOptional<z.ZodObject<{
+                preferredSource: z.ZodLiteral<"rooted_sharing">;
+                currentSource: z.ZodLiteral<"legacy_project">;
+                reason: z.ZodLiteral<"legacy_project_precedence">;
+                summary: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            }, {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            source: {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            };
+            category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+            rootedSharing?: {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            } | undefined;
+            migration?: {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            } | undefined;
+        }, {
+            source: {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            };
+            category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+            rootedSharing?: {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            } | undefined;
+            migration?: {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            } | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         kind: "workflow";
         name: string;
@@ -189,6 +377,24 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        visibility?: {
+            source: {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            };
+            category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+            rootedSharing?: {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            } | undefined;
+            migration?: {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            } | undefined;
+        } | undefined;
     }, {
         kind: "workflow";
         name: string;
@@ -196,6 +402,24 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        visibility?: {
+            source: {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            };
+            category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+            rootedSharing?: {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            } | undefined;
+            migration?: {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            } | undefined;
+        } | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     workflows: {
@@ -205,6 +429,24 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        visibility?: {
+            source: {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            };
+            category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+            rootedSharing?: {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            } | undefined;
+            migration?: {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            } | undefined;
+        } | undefined;
     }[];
 }, {
     workflows: {
@@ -214,6 +456,24 @@ export declare const V2WorkflowListOutputSchema: z.ZodObject<{
         version: string;
         workflowId: string;
         workflowHash: string | null;
+        visibility?: {
+            source: {
+                kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+                displayName: string;
+            };
+            category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+            rootedSharing?: {
+                kind: "remembered_root";
+                rootPath: string;
+                groupLabel: string;
+            } | undefined;
+            migration?: {
+                reason: "legacy_project_precedence";
+                summary: string;
+                preferredSource: "rooted_sharing";
+                currentSource: "legacy_project";
+            } | undefined;
+        } | undefined;
     }[];
 }>;
 export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
@@ -221,6 +481,82 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
     workflowHash: z.ZodString;
     mode: z.ZodEnum<["metadata", "preview"]>;
     compiled: z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>;
+    visibility: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        category: z.ZodEnum<["built_in", "personal", "legacy_project", "rooted_sharing", "external"]>;
+        source: z.ZodObject<{
+            kind: z.ZodEnum<["bundled", "user", "project", "custom", "git", "remote", "plugin"]>;
+            displayName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        }, {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        }>;
+        rootedSharing: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"remembered_root">;
+            rootPath: z.ZodString;
+            groupLabel: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        }, {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        }>>;
+        migration: z.ZodOptional<z.ZodObject<{
+            preferredSource: z.ZodLiteral<"rooted_sharing">;
+            currentSource: z.ZodLiteral<"legacy_project">;
+            reason: z.ZodLiteral<"legacy_project_precedence">;
+            summary: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        }, {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }, {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    }>>>;
     references: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
@@ -256,6 +592,24 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
         authoritative: boolean;
         resolveFrom?: "workspace" | "package" | undefined;
     }[] | undefined;
+    visibility?: {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    } | undefined;
 }, {
     workflowId: string;
     workflowHash: string;
@@ -269,6 +623,24 @@ export declare const V2WorkflowInspectOutputSchema: z.ZodObject<{
         authoritative: boolean;
         resolveFrom?: "workspace" | "package" | undefined;
     }[] | undefined;
+    visibility?: {
+        source: {
+            kind: "custom" | "bundled" | "user" | "project" | "git" | "remote" | "plugin";
+            displayName: string;
+        };
+        category: "built_in" | "personal" | "legacy_project" | "rooted_sharing" | "external";
+        rootedSharing?: {
+            kind: "remembered_root";
+            rootPath: string;
+            groupLabel: string;
+        } | undefined;
+        migration?: {
+            reason: "legacy_project_precedence";
+            summary: string;
+            preferredSource: "rooted_sharing";
+            currentSource: "legacy_project";
+        } | undefined;
+    } | undefined;
 }>;
 export declare const V2PendingStepSchema: z.ZodObject<{
     stepId: z.ZodString;