@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/application/init/index.js

@@ -0,0 +1,301 @@
+// Materialize, validate and register a workspace before synchronizing its resources.
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { samePath, windowsPathProblem } from '../../domain/path.js';
+import { preparation, preparationScope } from '../../domain/preparation.js';
+import { assertWorkspaceName, assertWorkspaceNames, defaultWorkspaceName, } from '../../domain/workspace/name.js';
+import { LoadManifest } from '../manifest/load.js';
+import { requireUsableManifest } from '../manifest/prepare.js';
+import { RefreshManifest } from '../refresh-manifest.js';
+import { assertWritable } from '../safety/posture.js';
+import { Sync } from '../sync/index.js';
+import { assertNoWorkspaceOperation } from '../workspace/health.js';
+import { withWorkspaceOperation } from '../workspace/operation.js';
+import { assertDistinctWorkspaceRoot } from '../workspace/registry.js';
+import { scopeMode } from '../workspace/scope.js';
+import { WorkspaceContext } from '../workspace-context.js';
+import { initFailure, initializationSourceError, nameTaken, sourceMismatch } from './errors.js';
+import { initialLocalLayer, inspectInitialization, initialPlan } from './preview.js';
+export class Init {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async execute(input) {
+        const preview = await this.plan(input);
+        if (input.dryRun) {
+            const inspection = await input.source
+                .inspect?.(preview.output.plan.manifest_action === 'refresh'
+                ? preview.output.manifest_dir
+                : undefined)
+                .catch((error) => {
+                throw initializationSourceError(this.deps, input, preview.output, undefined, error);
+            });
+            return {
+                ...preview.output,
+                plan: await inspectInitialization(this.deps, input, preview.output, inspection),
+            };
+        }
+        assertWritable(input.posture, `init ${preview.output.root}`);
+        return withWorkspaceOperation(this.deps.lock, preview.output.name, false, async () => {
+            const plan = await this.plan({ ...input, name: preview.output.name });
+            return this.apply(plan, input);
+        });
+    }
+    async identity(input) {
+        const root = path.resolve(input.dir);
+        if (root === path.parse(root).root)
+            throw new DevkitError('usage', 'WORKSPACE_PATH_INVALID', 'Choose a workspace directory below the filesystem root', { nextSteps: ['fx init <workspace-directory> --from <source>'] });
+        const problem = path.sep === '\\' ? windowsPathProblem(root) : undefined;
+        if (problem)
+            throw new DevkitError('usage', 'WORKSPACE_PATH_INVALID', problem, {
+                nextSteps: [`Choose a local workspace directory Windows can address instead of ${root}.`],
+            });
+        const config = await this.deps.config.read();
+        let name = input.name;
+        if (name === undefined) {
+            for (const [registeredName, entry] of Object.entries(config.workspaces ?? {})) {
+                if (await this.sameRoot(entry.root, root)) {
+                    name = registeredName;
+                    break;
+                }
+            }
+        }
+        name ??= defaultWorkspaceName(root, Object.keys(config.workspaces ?? {}));
+        assertWorkspaceName(name);
+        assertWorkspaceNames([...new Set([...Object.keys(config.workspaces ?? {}), name])]);
+        await assertNoWorkspaceOperation(this.deps, {
+            name,
+            manifestDir: this.deps.manifestDirFor(name),
+        });
+        await assertDistinctWorkspaceRoot(config, name, root, this.deps.fs);
+        const existing = config.workspaces?.[name];
+        if (input.resume && existing === undefined)
+            throw new DevkitError('not_found', 'WORKSPACE_NOT_FOUND', `Workspace ${name} is not registered`, { nextSteps: ['fx workspace list'] });
+        if (existing !== undefined && !(await this.sameRoot(existing.root, root)))
+            throw nameTaken(name, root, existing);
+        if (existing?.source !== undefined && existing.source !== input.source.description)
+            throw sourceMismatch(name, existing.source, input.source);
+        return { root, name, config };
+    }
+    async plan(input) {
+        const { root, name, config } = await this.identity(input);
+        const existing = config.workspaces?.[name];
+        const state = await this.dirState(root, existing !== undefined);
+        if (state === 'adopted')
+            await this.warnIfRepository(root);
+        const manifestDir = this.deps.manifestDirFor(name);
+        const refreshed = existing !== undefined &&
+            input.source.refresh !== undefined &&
+            (await this.deps.fs.exists(manifestDir));
+        const local = await this.deps.localStore.read(name);
+        let manifest = refreshed ? 'refreshed' : 'materialized';
+        if (input.resume)
+            manifest = 'kept';
+        return {
+            config,
+            output: {
+                operation: input.dryRun ? 'preview' : 'apply',
+                preparation: preparation({ scope: preparationScope(name), checks: [], preview: true }),
+                root,
+                name,
+                source: input.source.description,
+                manifest_dir: manifestDir,
+                manifest: input.dryRun ? 'not_written' : manifest,
+                adopted: state === 'adopted',
+                registered: existing !== undefined,
+                default_workspace: config.default_workspace === name,
+                sync: null,
+                tool_install: null,
+                written: false,
+                plan: initialPlan(this.deps, input, { name, root, manifestDir, refreshed, config, local }),
+            },
+        };
+    }
+    async apply({ output, config }, input) {
+        let phase = 'manifest';
+        let registered = config.workspaces?.[output.name] !== undefined;
+        let materialized = false;
+        let prepared = null;
+        let toolInstall = null;
+        try {
+            phase = 'validation';
+            output = await this.inspectSource(output, input, false);
+            phase = 'manifest';
+            if (!input.resume)
+                await this.materialize(output, input);
+            materialized = true;
+            phase = 'validation';
+            const bundle = await this.loadSourceManifest(output, input);
+            requireUsableManifest(bundle);
+            output = await this.inspectSource(output, input, true);
+            let local = await initialLocalLayer(this.deps, output.name, output.root, bundle, input.repos);
+            if (output.manifest === 'materialized')
+                await this.deps.settleManifest(output.name, output.manifest_dir);
+            phase = 'registration';
+            await this.register(output, input);
+            registered = true;
+            await this.deps.fs.ensureDir(output.root);
+            if (input.repos !== undefined)
+                local = await this.deps.localStore.update(output.name, (current) => initialLocalLayer(this.deps, output.name, output.root, bundle, input.repos, current));
+            phase = 'tools';
+            const ctx = await this.context(output);
+            prepared = (await this.deps.preview?.(ctx)) ?? null;
+            toolInstall = (await this.deps.installTools?.(ctx)) ?? [];
+            phase = 'sync';
+            const sync = await new Sync(this.deps.workspaceDepsFor(ctx)).execute({
+                initializing: true,
+                dryRun: false,
+                posture: input.posture,
+                jobs: input.jobs,
+                stages: this.deps.stagesFor(ctx),
+            });
+            const done = completedInitialization(output, {
+                sync,
+                toolInstall,
+                prepared,
+                defaultWorkspace: (await this.deps.config.read()).default_workspace,
+                repos: local.scope?.repos,
+            });
+            return done;
+        }
+        catch (error) {
+            throw initFailure(output, error, {
+                phase,
+                registered,
+                materialized,
+                prepared,
+                toolInstall,
+                cwd: path.resolve('.'),
+            });
+        }
+    }
+    async inspectSource(output, input, materialized) {
+        const inspection = materialized
+            ? {
+                root: output.manifest_dir,
+                contents: 'worktree',
+                readText: (file) => this.deps.fs.readText(path.join(output.manifest_dir, file)),
+            }
+            : await input.source.inspect?.(output.plan.manifest_action === 'refresh' ? output.manifest_dir : undefined);
+        if (!inspection)
+            return output;
+        return { ...output, plan: await inspectInitialization(this.deps, input, output, inspection) };
+    }
+    async loadSourceManifest(output, input) {
+        return new LoadManifest(this.deps.fs, this.deps.bundledTools)
+            .execute({
+            dir: output.manifest_dir,
+            cliVersion: this.deps.cliVersion,
+            providers: this.deps.providers,
+        })
+            .catch((error) => {
+            throw initializationSourceError(this.deps, input, output, {
+                root: output.manifest_dir,
+                ...(output.manifest === 'refreshed' ? { contents: 'worktree' } : {}),
+            }, error);
+        });
+    }
+    async materialize(output, input) {
+        if (output.manifest === 'refreshed') {
+            await new RefreshManifest(this.deps.reporter).execute({
+                manifestDir: output.manifest_dir,
+                source: input.source,
+                dryRun: false,
+                posture: input.posture,
+                settle: () => this.deps.settleManifest(output.name, output.manifest_dir),
+            });
+        }
+        else {
+            await input.source.materialize(output.manifest_dir);
+        }
+    }
+    async register(output, input) {
+        await this.deps.config.update(async (current) => {
+            await assertDistinctWorkspaceRoot(current, output.name, output.root, this.deps.fs);
+            const existing = current.workspaces?.[output.name];
+            if (existing && !(await this.sameRoot(existing.root, output.root)))
+                throw nameTaken(output.name, output.root, existing);
+            if (existing?.source !== undefined && existing.source !== output.source)
+                throw sourceMismatch(output.name, existing.source, input.source);
+            return {
+                ...current,
+                default_workspace: current.default_workspace ?? output.name,
+                workspaces: {
+                    ...current.workspaces,
+                    [output.name]: { root: output.root, source: output.source },
+                },
+            };
+        });
+    }
+    async sameRoot(left, right) {
+        return samePath(await this.deps.fs.realpath(left), await this.deps.fs.realpath(right));
+    }
+    context(output) {
+        return WorkspaceContext.locate({
+            cwd: output.root,
+            allowMissingRoot: true,
+            name: output.name,
+            config: this.deps.config,
+            fs: this.deps.fs,
+            git: this.deps.git,
+            localStore: this.deps.localStore,
+            bundledTools: this.deps.bundledTools,
+            providers: this.deps.providers,
+            cliVersion: this.deps.cliVersion,
+            reporter: this.deps.reporter,
+            manifestDirFor: this.deps.manifestDirFor,
+        });
+    }
+    async dirState(root, registered) {
+        if (!(await this.deps.fs.exists(root)))
+            return 'new';
+        if (!(await this.deps.fs.isDirectory(root)))
+            throw new DevkitError('conflict', 'WORKSPACE_PATH_INVALID', `The workspace destination is not a directory: ${root}`, {
+                nextSteps: [
+                    'Choose a directory while preserving the existing file, then retry initialization.',
+                ],
+            });
+        if (registered)
+            return 'registered';
+        if ((await this.deps.fs.readDir(root)).length === 0)
+            return 'empty';
+        return 'adopted';
+    }
+    async warnIfRepository(root) {
+        const top = await this.deps.git.toplevel(root);
+        if (top === undefined)
+            return;
+        if ((await this.deps.fs.realpath(top)) !== (await this.deps.fs.realpath(root)))
+            return;
+        this.deps.reporter.notice({
+            code: 'ROOT_IS_GIT',
+            message: `${root} is itself a git repository; the workspace root should be a plain directory`,
+            nextSteps: [
+                'Preserve this repository; choose a separate plain directory if you need a workspace root.',
+            ],
+        });
+    }
+}
+function completedInitialization(output, result) {
+    const { preparation, ...sync } = result.sync;
+    return {
+        ...output,
+        registered: true,
+        default_workspace: result.defaultWorkspace === output.name,
+        plan: {
+            ...output.plan,
+            source_inspected: true,
+            inspected_source: output.manifest_dir,
+            repositories: result.sync.items,
+            unchecked: [],
+            selection: { mode: scopeMode(result.repos), repos: result.repos ?? null, validated: true },
+        },
+        preparation,
+        sync,
+        tool_install: result.toolInstall,
+        prepared: result.prepared,
+        written: true,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/application/init/index.js.map

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

package/dist/application/init/preview.js

@@ -0,0 +1,181 @@
+// Inspect source, selection and authorized preparation plans without registering or materializing a workspace.
+import path from 'node:path';
+import { DERIVED_GUIDE, isDerived } from '../../domain/docs/derived.js';
+import { completeRegions } from '../../domain/docs/regions.js';
+import { REGIONS } from '../../domain/docs/templates.js';
+import { DevkitError } from '../../domain/errors.js';
+import { bindPlatforms, bindProviders } from '../../domain/manifest/providers.js';
+import { documentPath } from '../docs/rendered.js';
+import { LoadManifest } from '../manifest/load.js';
+import { requireUsableManifest } from '../manifest/prepare.js';
+import { Tally } from '../tally.js';
+import { workspaceToolScope } from '../tool/scope.js';
+import { toolchainOf } from '../tool/toolchain.js';
+import { planRepositories } from '../workspace/plan.js';
+import { scopeMode } from '../workspace/scope.js';
+import { validateWorkspaceLayer } from '../workspace/validate-layer.js';
+import { WorkspaceContext } from '../workspace-context.js';
+import { initializationSourceError } from './errors.js';
+export async function initialLocalLayer(deps, name, root, bundle, repos, current) {
+    const local = current ?? (await deps.localStore.read(name));
+    if (repos === undefined) {
+        await validateWorkspaceLayer(deps.fs, root, bundle.workspace.result.doc, local);
+        return local;
+    }
+    const known = bundle.workspace.result.doc.repos.map((repo) => repo.name);
+    const unknown = repos.filter((repo) => !known.includes(repo));
+    if (unknown.length > 0)
+        throw new DevkitError('not_found', 'REPO_NOT_FOUND', `Unknown shared repositories: ${unknown.join(', ')}`, {
+            nextSteps: [
+                'Preview the source with fx init <dir> --from <source> --dry-run to list repository names.',
+            ],
+        });
+    const next = { ...local, scope: { ...local.scope, repos: [...new Set(repos)] } };
+    await validateWorkspaceLayer(deps.fs, root, bundle.workspace.result.doc, next);
+    return next;
+}
+export async function inspectInitialization(deps, input, output, inspection) {
+    if (inspection === undefined)
+        return output.plan;
+    const bundle = await loadInspectedSource(deps, input, output, inspection);
+    requireUsableManifest(bundle);
+    const local = await initialLocalLayer(deps, output.name, output.root, bundle, input.repos);
+    const context = {
+        dir: output.manifest_dir,
+        bundle,
+        providers: deps.providers,
+        bindings: bindProviders(bundle.workspace.result.doc, deps.providers),
+        platforms: bindPlatforms(bundle.environments?.result.doc, deps.providers),
+    };
+    const ctx = await WorkspaceContext.preview(output.root, output.name, context, local, deps.fs);
+    const workspaceDeps = deps.workspaceDepsFor(ctx);
+    const { guidePlan, guideConflicts } = await inspectGuides(output.root, inspection, workspaceDeps.projections);
+    const setup = await checkedSetupPlan(deps, ctx);
+    const repos = ctx.workspace.repos.length;
+    const repositories = await Tally.during(workspaceDeps.activity, 'repos', (tally) => planRepositories(workspaceDeps, { jobs: input.jobs, remote: false, tally: tally.plan(repos) }));
+    return {
+        ...output.plan,
+        source_inspected: true,
+        inspected_source: inspection.root,
+        selection: {
+            mode: scopeMode(local.scope?.repos),
+            repos: local.scope?.repos ?? null,
+            validated: true,
+        },
+        repositories,
+        resources: await inspectedResources({
+            deps,
+            input,
+            output,
+            ctx,
+            guidePlan,
+            guideConflicts,
+            setup,
+        }),
+        unchecked: [
+            'Remote repository access, branch availability and incoming commits are not queried; repository actions are based on local state.',
+            'Tool installation status, agent selection, service settings, and ownership/conflicts of generated resources are checked during preparation. No command trust is granted by this preview.',
+        ],
+    };
+}
+async function checkedSetupPlan(deps, ctx) {
+    const toolScope = workspaceToolScope(ctx, {});
+    if (toolScope.problems.length)
+        throw new DevkitError('config', 'SETUP_PLAN_INVALID', 'The selected workspace capabilities cannot be prepared', {
+            hint: toolScope.problems.map((problem) => problem.message).join('\n'),
+            nextSteps: ['Correct the named provider or tool declarations in the source, then retry.'],
+        });
+    const setup = await deps.setupPlan?.(ctx);
+    if (setup && setup.problems.length > 0)
+        throw new DevkitError('config', 'SETUP_PLAN_INVALID', 'The declared setup cannot be prepared', {
+            hint: setup.problems.map((problem) => `${problem.step}: ${problem.detail}`).join('\n'),
+            nextSteps: ['Correct the listed setup definitions in the source, then retry initialization.'],
+            partialResult: { problems: setup.problems },
+        });
+    return setup;
+}
+async function inspectGuides(root, inspection, projections) {
+    const guide = await inspection.readText('AGENTS.md');
+    const guidePlan = completeRegions(guide ?? '', Object.fromEntries(REGIONS.map((name) => [name, ''])));
+    const target = path.join(root, DERIVED_GUIDE);
+    const snapshot = await projections.read(documentPath(target));
+    const foreign = snapshot.kind === 'foreign' || (snapshot.text !== null && !isDerived(snapshot.text));
+    return { guidePlan, guideConflicts: foreign ? [target] : [] };
+}
+async function inspectedResources({ deps, input, output, ctx, guidePlan, guideConflicts, setup, }) {
+    const tools = toolchainOf(ctx).tools;
+    return {
+        ...output.plan.resources,
+        guide_regions_to_add: guidePlan.added ?? [],
+        guide_conflicts: guideConflicts.map((file) => ({
+            path: file,
+            action: 'requires_replacement_approval',
+            backup: 'The original is preserved in a unique sibling backup before replacement',
+        })),
+        preparation: input.dryRun ? ((await deps.preview?.(ctx)) ?? null) : null,
+        setup: setup?.steps.map((step) => ({
+            id: step.id,
+            tool: step.tool,
+            phase: step.phase ?? 'manual',
+            title: step.title,
+            action: step.phase === 'prepare' ? 'prepare_if_needed' : 'verify_only',
+            command: step.phase === 'prepare' ? (step.run ?? null) : null,
+            cwd: ctx.root,
+            verify: step.verify,
+            requires: step.requires,
+        })) ?? [],
+        tools: tools
+            .filter((tool) => tool.enabled && tool.installOnInit)
+            .map((tool) => ({
+            name: tool.name,
+            action: 'install_if_missing',
+            scope: 'global',
+            methods: tool.install,
+        })),
+        companion_skills: tools
+            .filter((tool) => tool.enabled && (tool.skill?.command.length ?? 0) > 0)
+            .map((tool) => tool.name),
+        tool_checks: workspaceToolScope(ctx, {})
+            .covered.filter((tool) => tool.enabled)
+            .map((tool) => ({ name: tool.name, command: [tool.binary, ...tool.versionArgs] })),
+        mcp: ctx.manifest.harness?.result.doc.mcp.map((resource) => resource.name) ?? [],
+    };
+}
+async function loadInspectedSource(deps, input, output, inspection) {
+    return new LoadManifest({
+        readText: (file) => inspection.readText(path.relative(output.manifest_dir, file).split(path.sep).join('/')),
+    }, deps.bundledTools)
+        .execute({ dir: output.manifest_dir, cliVersion: deps.cliVersion, providers: deps.providers })
+        .catch((error) => {
+        throw initializationSourceError(deps, input, output, inspection, error);
+    });
+}
+export function initialPlan(deps, input, facts) {
+    const { name, root, manifestDir, refreshed, config, local } = facts;
+    const selection = input.repos ?? local.scope?.repos;
+    let manifestAction = refreshed ? 'refresh' : 'materialize';
+    if (input.resume)
+        manifestAction = 'keep';
+    return {
+        source_inspected: false,
+        inspected_source: null,
+        manifest_action: manifestAction,
+        registration: config.workspaces?.[name] === undefined ? 'register' : 'keep',
+        default_workspace: config.default_workspace === undefined ? 'set' : 'keep',
+        selection: { mode: scopeMode(selection), repos: selection ?? null, validated: false },
+        repositories: null,
+        resources: {
+            manifest: manifestDir,
+            registration: deps.config.path(),
+            personal_selection: input.repos === undefined ? null : deps.localStore.path(name),
+            workspace_guides: root,
+            agent_resources: 'Selected hosts may receive Skills, rules, MCP settings and lifecycle hooks; existing foreign content is preserved.',
+            services: 'Declared public companion settings may be prepared through trusted commands; credentials remain personal.',
+            global_tools: 'Missing enabled tools explicitly marked install_on_init may be installed globally after trust approval.',
+        },
+        unchecked: [
+            'Effective source contents for this invocation have not been determined. Repository names, selection and resource declarations are unverified. A refresh may preserve the current managed checkout. Inspect a local checkout with --from <directory> --dry-run, or initialize to acquire and validate the remote source before repository cloning.',
+        ],
+    };
+}
+//# sourceMappingURL=preview.js.map

package/dist/application/init/preview.js.map

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

package/dist/application/init/setup.js

@@ -0,0 +1,125 @@
+// Initialization and every explicit sync perform local preparation, so a login the
+// person already has is associated without anyone asking for it. Personal sign-in and
+// operator-owned files always remain explicit handoffs.
+import path from 'node:path';
+import { preparationCheck } from '../../domain/preparation.js';
+import { expectedPath } from '../login/handoff.js';
+import { Login } from '../login/run.js';
+import { expandHome, gaveNoAnswer } from '../login/verify.js';
+import { noAnswerAction, resumeAction, verifyAction } from '../preparation.js';
+import { workspaceToolScope } from '../tool/scope.js';
+export async function prepareWorkspaceSetup(deps, login, input) {
+    const scope = workspaceToolScope(deps.ctx, {});
+    const useCase = new Login(deps, login);
+    const plan = await useCase.plan({ tools: scope.configuredNames });
+    const output = await useCase.execute({
+        tools: scope.configuredNames,
+        mode: 'prepare',
+        skipManual: false,
+        dryRun: input.dryRun,
+        noInput: true,
+        posture: input.posture,
+    });
+    const unanswered = unansweredSteps(plan, output.items);
+    return {
+        summary: output.summary,
+        details: { items: output.items, problems: output.problems },
+        checks: [
+            ...output.items.map((item) => {
+                const step = plan.steps.find((step) => step.id === item.id);
+                const ready = item.result === 'verified' || item.result === 'done';
+                const unknown = unanswered.has(item.id);
+                const expected = ready || unknown ? undefined : expectedFile(deps, step, login.home);
+                const detail = `${item.title}: ${item.detail ?? item.result}${expected === undefined ? '' : `; expected ${expected}`}`;
+                const pending = unknown ? 'unknown' : 'blocked';
+                return preparationCheck(`login:${item.id}`, ready ? 'ready' : pending, detail, {
+                    resource: item.id,
+                    required: scope.required.has(item.tool),
+                    owner: unknown || step.phase === 'prepare' ? 'agent' : 'user',
+                    ...(ready
+                        ? {}
+                        : {
+                            actions: item.actions ??
+                                actionsFor(deps, step, login.home, {
+                                    item,
+                                    unknown,
+                                    initializing: input.initializing,
+                                }),
+                        }),
+                    ...(item.failure ? { failure: item.failure, code: item.failure.code } : {}),
+                });
+            }),
+            ...output.problems.map((problem) => preparationCheck(`setup:${problem.step}`, 'blocked', problem.detail, {
+                owner: 'maintainer',
+            })),
+        ],
+    };
+}
+// Steps whose check gave no answer and, the plan listing prerequisites first, the steps
+// that wait on them: as unknown as the check, and nobody's to act on.
+function unansweredSteps(plan, items) {
+    const codes = new Map(items.map((item) => [item.id, item.failure?.code]));
+    const unanswered = new Set();
+    for (const step of plan.steps)
+        if (gaveNoAnswer(codes.get(step.id)) || step.requires.some((id) => unanswered.has(id)))
+            unanswered.add(step.id);
+    return unanswered;
+}
+// A check that gave no answer offers its own recovery; a step waiting on it offers none.
+function actionsFor(deps, step, home, row) {
+    const code = row.item.failure?.code;
+    if (code !== undefined && gaveNoAnswer(code))
+        return [noAnswerAction(deps, step, code)];
+    if (row.unknown)
+        return [];
+    if (step.phase !== 'prepare' && code === 'VECTOR_UNTRUSTED')
+        return [verifyAction(deps, step.tool)];
+    const { initializing, item } = row;
+    return setupActions(deps, step, home, { initializing, handoff: item.handoff });
+}
+// The handoff a finding already carries for a step, with what its check said.
+export function handoffOf(finding, step) {
+    return finding.handoff?.user_steps.find((item) => item.id === step.id);
+}
+function expectedFile(deps, step, home) {
+    const expected = expectedPath(step);
+    return expected === undefined
+        ? undefined
+        : path.resolve(deps.ctx.root, expandHome(expected, home));
+}
+export function setupActions(deps, step, home, options = {}) {
+    const { initializing = false, handoff } = options;
+    const expected = expectedFile(deps, step, home);
+    if (step.phase === 'prepare')
+        return [
+            {
+                ...resumeAction(deps),
+                id: `approve:${step.id}`,
+                description: initializing
+                    ? 'Review the remaining initialization effects and continue this workspace'
+                    : `Repair ${step.tool}'s local preparation and the workspace's managed guides and Skills`,
+                argv: initializing
+                    ? [...resumeAction(deps).argv, '--yes']
+                    : ['fx', 'doctor', '--fix', '--tool', step.tool, '--workspace', deps.ctx.name, '--yes'],
+                requires_approval: true,
+            },
+        ];
+    return [
+        {
+            actor: 'user',
+            id: `login:${step.id}`,
+            description: `${handoff?.instructions ?? step.instructions ?? step.title}${expected === undefined ? '' : ` Expected file: ${expected}.`}`,
+            argv: [
+                'fx',
+                'login',
+                step.tool,
+                '--workspace',
+                deps.ctx.name,
+                ...(step.env ? ['--env', step.env] : []),
+            ],
+            cwd: deps.ctx.root,
+            requires_approval: true,
+        },
+    ];
+}
+//# sourceMappingURL=setup.js.map