@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/application/skill/tool-skills.js

@@ -0,0 +1,195 @@
+// External tools install their own Skills through their own executable. The
+// vector is assembled from tool data, approved before it runs, and a refused
+// approval is a blocked row rather than a failed stage.
+import { asDevkitError, DevkitError, exitCodeFor, toEnvelope } from '../../domain/errors.js';
+import { shellLine } from '../../domain/shell.js';
+import { commandOrigin } from '../../domain/toolchain/resolve.js';
+import { errorEnvelope, stderrReason } from '../../domain/toolchain/stderr.js';
+import { isTrustRequired } from '../safety/trust.js';
+import { applyItem } from './outcome.js';
+import { skillTargets } from './targets.js';
+export async function planTools(deps, skills, input) {
+    const targets = await skillTargets(skills, input.agents);
+    const agents = targets.map((t) => t.agent);
+    if (agents.length === 0)
+        return [];
+    const items = [];
+    for (const tool of input.toolchain ?? []) {
+        if (!tool.enabled || tool.skill === undefined) {
+            items.push(noVector(tool, 'ships no Skill'));
+            continue;
+        }
+        if ((await deps.processWhich(tool.binary)) === undefined &&
+            !(input.dryRun && tool.installOnInit)) {
+            items.push(missingToolSkill(tool));
+            continue;
+        }
+        const flag = tool.skill.agentFlag;
+        if (tool.skill.dirFlag !== undefined && flag === undefined) {
+            const dirs = [...new Set(targets.map((target) => target.dir))];
+            if (dirs.length === 0)
+                items.push(noVector(tool, 'no selected agents'));
+            for (const dir of dirs) {
+                items.push({
+                    tool: tool.name,
+                    vector: [tool.binary, ...tool.skill.command, tool.skill.dirFlag, dir],
+                    code: null,
+                    origin: commandOrigin(tool, 'skill'),
+                });
+            }
+            continue;
+        }
+        const vector = [
+            tool.binary,
+            ...tool.skill.command,
+            ...(flag === undefined ? [] : agents.flatMap((a) => [flag, a])),
+        ];
+        items.push({ tool: tool.name, vector, code: null, origin: commandOrigin(tool, 'skill') });
+    }
+    return items;
+}
+// A companion's Skill command is approved as the team wrote it; the agent or directory
+// fx appends is fx's own choice and asks nothing new. An approval of a whole vector,
+// as earlier versions recorded them, still counts.
+function authoredCommand(toolchain, item) {
+    const tool = toolchain?.find((candidate) => candidate.name === item.tool);
+    if (tool?.skill === undefined)
+        return item.vector;
+    const command = [tool.binary, ...tool.skill.command];
+    if (tool.skill.agentFlag !== undefined)
+        return [...command, tool.skill.agentFlag, '<agent>'];
+    if (tool.skill.dirFlag !== undefined)
+        return [...command, tool.skill.dirFlag, '<agent-skill-directory>'];
+    return command;
+}
+async function isApproved(trust, item, authored) {
+    for (const vector of [authored, item.vector])
+        if (await trust.gate.isTrusted({ workspace: trust.workspace, vector, origin: item.origin }))
+            return true;
+    return false;
+}
+// Background runs never ask: an unapproved vector is dropped silently, because
+// nobody is there to answer the prompt an approval would raise.
+export async function trustedTools(items, toolchain, trust) {
+    const result = [];
+    for (const item of items) {
+        if (!runnable(item) ||
+            item.origin === 'base' ||
+            (trust && (await isApproved(trust, item, authoredCommand(toolchain, item)))))
+            result.push(item);
+        else
+            result.push({ ...item, vector: null, note: 'untrusted' });
+    }
+    return result;
+}
+// Approve executable vectors before running them. A missing approval is a
+// blocked tool row; independent owned local projections can still proceed.
+export async function trustAll(items, toolchain, trust) {
+    if (trust === undefined)
+        return [...items];
+    const approved = [];
+    for (const item of items) {
+        if (!runnable(item)) {
+            approved.push(item);
+            continue;
+        }
+        const command = authoredCommand(toolchain, item);
+        try {
+            if (!(await isApproved(trust, item, command)))
+                await trust.gate.ensure({
+                    tool: item.tool,
+                    workspace: trust.workspace,
+                    vector: command,
+                    label: `${item.tool} skill install`,
+                    origin: item.origin,
+                    yes: trust.yes,
+                    posture: trust.posture,
+                });
+            approved.push(item);
+        }
+        catch (error) {
+            if (!isTrustRequired(error))
+                throw error;
+            const failure = asDevkitError(error);
+            approved.push({
+                ...item,
+                vector: null,
+                code: exitCodeFor(failure.category),
+                note: 'approval required',
+                failure: toEnvelope(failure).error,
+            });
+        }
+    }
+    return approved;
+}
+function runnable(item) {
+    return item.vector !== null;
+}
+export async function runTools(deps, items) {
+    // A tool installs into one directory per agent; its progress is still one start and one end.
+    const pending = new Map();
+    for (const item of items)
+        if (item.vector !== null)
+            pending.set(item.tool, (pending.get(item.tool) ?? 0) + 1);
+    const started = new Set();
+    const failed = new Set();
+    for (const [index, item] of items.entries()) {
+        if (item.vector === null) {
+            items[index] = { ...item, status: 'skipped' };
+            continue;
+        }
+        await applyItem(items, index, async () => {
+            if (!started.has(item.tool))
+                deps.reporter.progress({ id: item.tool, state: 'start', detail: 'Skill installation' });
+            started.add(item.tool);
+            const result = await deps.processRun(item.vector, {
+                diagnostic: { phase: `${item.tool} skill install` },
+            });
+            items[index] = { ...item, code: result.code };
+            if (result.code !== 0) {
+                failed.add(item.tool);
+                items[index] = { ...items[index], ...installFailure(deps, item.tool, result) };
+            }
+            const left = pending.get(item.tool) - 1;
+            pending.set(item.tool, left);
+            if (left === 0)
+                deps.reporter.progress({
+                    id: item.tool,
+                    state: failed.has(item.tool) ? 'fail' : 'done',
+                    detail: 'Skill installation finished',
+                });
+        });
+        if (items[index].code !== 0)
+            items[index] = { ...items[index], status: 'failed' };
+    }
+}
+function installFailure(deps, tool, result) {
+    const diagnostic = result.stderr.trim() || result.stdout.trim();
+    const note = stderrReason(diagnostic, result.code);
+    const failure = errorEnvelope(diagnostic);
+    deps.reporter.notice({
+        code: 'SKILL_INSTALL_FAILED',
+        message: `${tool}: ${note}`,
+        nextSteps: [shellLine(['fx', 'tool', 'show', tool], deps.commandShell)],
+        data: { tool, exit: result.code, ...(failure === undefined ? {} : { failure }) },
+    });
+    return { note, ...(failure === undefined ? {} : { failure }) };
+}
+function noVector(tool, note) {
+    return {
+        tool: tool.name,
+        vector: null,
+        code: null,
+        note,
+        origin: commandOrigin(tool, 'skill'),
+    };
+}
+function missingToolSkill(tool) {
+    return {
+        ...noVector(tool, 'not installed'),
+        failure: toEnvelope(new DevkitError('not_found', 'TOOL_MISSING', `${tool.name} is required to prepare its Skill`, {
+            nextSteps: [`fx tool show ${tool.name}`, `fx tool install ${tool.name} --dry-run`],
+        })).error,
+    };
+}
+//# sourceMappingURL=tool-skills.js.map

package/dist/application/skill/tool-skills.js.map

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

package/dist/application/skill/types.js

@@ -0,0 +1,4 @@
+// The three Skill product lines report one row per item: a linked team Skills
+// directory, a copied fx Skill, or an external tool asked to install its own.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/application/skill/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/application/skill/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E"}

package/dist/application/skill/write-error.js

@@ -0,0 +1,28 @@
+// Identify denied Skill filesystem effects, including errors wrapped by IO ports.
+// Keep other structured failures intact and retain the underlying OS cause.
+import { DevkitError } from '../../domain/errors.js';
+export function skillWriteError(error, target) {
+    let current = error;
+    const seen = new Set();
+    while (typeof current === 'object' && current !== null && !seen.has(current)) {
+        seen.add(current);
+        const cause = current;
+        if (cause.code === 'EPERM' || cause.code === 'EACCES') {
+            const resource = typeof cause.path === 'string' ? cause.path : target;
+            return new DevkitError('permission', 'SKILL_WRITE_DENIED', `Cannot prepare Skill ${target}: ${cause.code} at ${resource}`, {
+                cause: error,
+                retryable: false,
+                hint: 'Global Skill targets and their shared lock can be outside FX_HOME. Preparation remains incomplete until this filesystem access is available.',
+                nextSteps: [
+                    'fx skill show',
+                    'Continue source analysis in the repositories already prepared.',
+                    'To synchronize repositories and guides only: fx sync --only repos,docs --no-refresh-manifest --format json',
+                    `Inspect filesystem access to ${resource}; retry Skill preparation only after access changes.`,
+                ],
+            });
+        }
+        current = cause.cause;
+    }
+    return error;
+}
+//# sourceMappingURL=write-error.js.map

package/dist/application/skill/write-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-error.js","sourceRoot":"","sources":["../../../src/application/skill/write-error.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,4EAA4E;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,MAAc;IAC5D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAChC,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,OAA8D,CAAC;QAC7E,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YACtE,OAAO,IAAI,WAAW,CACpB,YAAY,EACZ,oBAAoB,EACpB,wBAAwB,MAAM,KAAK,KAAK,CAAC,IAAI,OAAO,QAAQ,EAAE,EAC9D;gBACE,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,KAAK;gBAChB,IAAI,EAAE,8IAA8I;gBACpJ,SAAS,EAAE;oBACT,eAAe;oBACf,gEAAgE;oBAChE,4GAA4G;oBAC5G,gCAAgC,QAAQ,sDAAsD;iBAC/F;aACF,CACF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/application/status.js

@@ -0,0 +1,55 @@
+// One row per tracked repository, from the disk state and the manifest alone.
+// `--fetch` refreshes the remote-tracking refs first; without it the position
+// against upstream is as of the last sync.
+import { deriveStatus } from '../domain/workspace/status.js';
+import { pooled } from './pool.js';
+import { assertWritable } from './safety/posture.js';
+import { Tally } from './tally.js';
+import { checkoutDir, inspectDisk, urlsFor } from './workspace/inspect.js';
+export class Status {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async execute(input) {
+        const { activity } = this.deps;
+        const { repos } = this.deps.ctx.workspace;
+        const plan = await Tally.during(activity, 'repos', (tally) => {
+            tally.plan(repos.length);
+            return pooled(repos, input.jobs ?? 4, (repo) => tally.unit(repo.name, async () => {
+                const disk = await inspectDisk(this.deps, repo);
+                return { repo, disk, fetch: planFetch(input.fetch, disk) };
+            }));
+        });
+        const writes = plan.filter((item) => item.fetch === 'planned');
+        if (!input.fetch || input.dryRun || writes.length === 0)
+            return this.rows(input, plan);
+        assertWritable(input.posture, 'status --fetch');
+        return Tally.during(activity, 'fetch', async (tally) => {
+            tally.plan(writes.length);
+            const fetched = [];
+            for (const item of plan)
+                fetched.push(item.fetch === 'planned'
+                    ? await tally.unit(item.repo.name, () => this.fetch(item))
+                    : item);
+            return this.rows(input, fetched);
+        });
+    }
+    async fetch({ repo }) {
+        await this.deps.git.fetch(checkoutDir(this.deps, repo), 'upstream');
+        return { repo, disk: await inspectDisk(this.deps, repo), fetch: 'completed' };
+    }
+    rows(input, plan) {
+        const rows = plan.map((item) => ({
+            ...deriveStatus(item.repo, item.disk, urlsFor(this.deps, item.repo, undefined).upstream),
+            fetch: item.fetch,
+        }));
+        return input.dirtyOnly ? rows.filter((r) => r.uncommitted) : rows;
+    }
+}
+function planFetch(requested, disk) {
+    if (!requested)
+        return 'not_requested';
+    return disk.kind === 'checkout' ? 'planned' : 'not_applicable';
+}
+//# sourceMappingURL=status.js.map

package/dist/application/status.js.map

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

package/dist/application/sync/checks.js

@@ -0,0 +1,82 @@
+// Translate each stage's typed results into preparation evidence at its owning boundary.
+import { preparationCheck, } from '../../domain/preparation.js';
+export function documentChecks(files) {
+    return files.map((file) => preparationCheck(`docs:${file.path}`, file.action === 'foreign' || file.result === 'failed' || file.result === 'not_started'
+        ? 'blocked'
+        : 'ready', file.action === 'foreign' ? 'An existing guide needs replacement approval' : file.result, { resource: file.path, owner: 'user', ...(file.failure ? { failure: file.failure } : {}) }));
+}
+// A person's own go.work stays in charge of their builds; that is worth a warning,
+// not a blocker.
+export function goWorkChecks(output) {
+    const { file } = output;
+    if (file === null)
+        return [];
+    const foreign = file.action === 'foreign';
+    return [
+        preparationCheck(`go:${file.path}`, foreign ? 'blocked' : 'ready', foreign ? 'An existing go.work was not written by fx' : file.result, { resource: file.path, owner: 'user', required: !foreign }),
+    ];
+}
+export function skillChecks(output, requiredTools) {
+    const own = [...output.links, ...output.fx].map((item) => preparationCheck(`skill:${item.path}`, item.action === 'foreign' || item.status === 'failed' || item.status === 'not_started'
+        ? 'blocked'
+        : 'ready', item.action, { resource: item.path, owner: 'user' }));
+    const tools = output.tools.map((item) => preparationCheck(`skill:${item.tool}`, item.failure ||
+        item.note === 'approval required' ||
+        item.status === 'failed' ||
+        (item.code !== null && item.code !== 0)
+        ? 'blocked'
+        : 'ready', item.note ?? item.status ?? 'No companion Skill declared', { resource: item.tool, required: requiredTools.has(item.tool), owner: 'user' }));
+    return [...own, ...tools];
+}
+export function toolChecks(rows, deps) {
+    return rows.map((row) => preparationCheck(`tool:${row.name}`, toolState(row), `${row.name}: ${row.state}${row.min_version ? ` (requires ${row.min_version})` : ''}`, {
+        resource: row.name,
+        required: row.preparation_required,
+        owner: row.state === 'disabled' ? 'maintainer' : 'user',
+        ...(row.failure ? { code: row.failure.code, failure: row.failure } : {}),
+        actions: toolRecovery(row, deps),
+    }));
+}
+function toolState(row) {
+    if (row.state === 'ok')
+        return 'ready';
+    if (row.state === 'disabled' && !row.preparation_required)
+        return 'skipped';
+    if (row.state === 'unknown')
+        return 'unknown';
+    return 'blocked';
+}
+function toolRecovery(row, deps) {
+    if (row.state === 'ok' || (row.state === 'disabled' && !row.preparation_required))
+        return [];
+    const untrusted = row.failure?.code === 'VECTOR_UNTRUSTED';
+    let command = 'show';
+    if (row.state === 'missing')
+        command = 'install';
+    if (row.state === 'outdated')
+        command = 'update';
+    const argv = untrusted
+        ? ['fx', 'doctor', '--tool', row.name, '--workspace', deps.ctx.name, '--yes']
+        : [
+            'fx',
+            'tool',
+            command,
+            row.name,
+            '--workspace',
+            deps.ctx.name,
+            ...(command === 'show' ? [] : ['--dry-run']),
+        ];
+    return [
+        {
+            id: `tool:${row.name}`,
+            description: untrusted
+                ? `Review the exact ${row.name} probe and approve it to continue`
+                : `Inspect ${row.name} preparation`,
+            argv,
+            cwd: deps.ctx.root,
+            actor: 'agent',
+            requires_approval: untrusted,
+        },
+    ];
+}
+//# sourceMappingURL=checks.js.map

package/dist/application/sync/checks.js.map

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

package/dist/application/sync/index.js

@@ -0,0 +1,238 @@
+// Plan repository updates and aggregate repository and resource-stage outcomes.
+import { asDevkitError, toEnvelope, withPartialResult } from '../../domain/errors.js';
+import { preparationCheck, } from '../../domain/preparation.js';
+import { requireUsableManifest } from '../manifest/prepare.js';
+import { pooled } from '../pool.js';
+import { workspacePreparation } from '../preparation.js';
+import { assertWritable } from '../safety/posture.js';
+import { Tally } from '../tally.js';
+import { prepareUpstream } from '../workspace/adopt.js';
+import { checkoutDir } from '../workspace/inspect.js';
+import { planRepositories } from '../workspace/plan.js';
+export class Sync {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async execute(input) {
+        requireUsableManifest(this.deps.ctx.manifest);
+        const wanted = selectedStages(input);
+        const stages = {};
+        const details = {};
+        const checks = [];
+        let items = [];
+        const output = () => ({
+            operation: input.dryRun ? 'preview' : 'apply',
+            preparation: workspacePreparation(this.deps, wanted, checks, input.dryRun, {}, syncRecovery(this.deps, input, wanted)),
+            items,
+            summary: repositorySummary(items),
+            stages,
+            stage_details: details,
+        });
+        const ordered = wanted;
+        for (const [index, stage] of ordered.entries()) {
+            try {
+                if (stage === 'repos') {
+                    items = await this.repos(input);
+                    checks.push(...repositoryChecks(items));
+                    continue;
+                }
+                const run = input.stages?.[stage];
+                if (!run) {
+                    stages[stage] = 'not_implemented';
+                    checks.push(preparationCheck(stage, 'unknown', `The ${stage} stage is unavailable`));
+                    continue;
+                }
+                const result = await run();
+                stages[stage] = result.summary;
+                if (result.details)
+                    details[stage] = result.details;
+                checks.push(...result.checks);
+                if (input.only !== undefined)
+                    checks.push(...(result.operationChecks ?? []));
+            }
+            catch (error) {
+                if (stage === 'repos' && index === 0 && items.length === 0)
+                    throw error;
+                const failure = asDevkitError(error);
+                stages[stage] = { status: 'failed' };
+                details[stage] = { ...failure.partialResult, failure: toEnvelope(failure).error };
+                checks.push(preparationCheck(stage, 'blocked', failure.message, {
+                    code: failure.code,
+                    failure: toEnvelope(failure).error,
+                    required: input.only !== undefined || !['hooks', 'mcp'].includes(stage),
+                }));
+                if (input.only === undefined && ['hooks', 'mcp'].includes(stage))
+                    continue;
+                markPending(ordered.slice(index + 1), stage, stages, checks);
+                throw withPartialResult(error, output());
+            }
+        }
+        return output();
+    }
+    async repos(input) {
+        const items = await Tally.during(this.deps.activity, 'repos', (tally) => this.reconcile(input, tally));
+        const summary = repositorySummary(items);
+        if (summary.failed > 0) {
+            this.deps.reporter.notice({
+                code: 'SYNC_PARTIAL',
+                message: `${summary.failed} repositor${summary.failed === 1 ? 'y' : 'ies'} could not be synced; see the failed rows`,
+                nextSteps: ['fx status', 'fx sync'],
+            });
+        }
+        return items;
+    }
+    // A watcher follows the tally as it moves. A program reads it as a record when each
+    // phase begins, every five seconds after that and once more at the end.
+    async reconcile(input, tally) {
+        const total = this.deps.ctx.workspace.repos.length;
+        const started = Date.now();
+        let phase = 'preflight';
+        const record = () => {
+            const { completed, active } = tally.count;
+            const elapsed = Date.now() - started;
+            this.deps.reporter.progress({
+                id: 'repos',
+                state: 'running',
+                total,
+                completed,
+                elapsed_ms: elapsed,
+                active,
+                phase,
+                detail: `${phase}: ${completed}/${total} complete; ${active.join(', ')}; ${Math.floor(elapsed / 1000)}s elapsed`,
+            });
+        };
+        const enter = (next, units) => {
+            phase = next;
+            tally.enter(phase).plan(units);
+            record();
+        };
+        enter('preflight', total);
+        const heartbeat = setInterval(record, 5000);
+        try {
+            const plan = await planRepositories(this.deps, { jobs: input.jobs, tally });
+            if (input.dryRun)
+                return plan.map((item) => ({ ...item, result: 'planned' }));
+            if (plan.some(needsRepositoryWrite))
+                assertWritable(input.posture, 'sync');
+            const picked = (item) => item.action !== 'skip_unpicked';
+            enter('apply', plan.filter(picked).length);
+            return await pooled(plan, input.jobs, async (item) => picked(item)
+                ? tally.unit(item.name, () => this.apply(item))
+                : { ...item, result: 'skipped' });
+        }
+        finally {
+            clearInterval(heartbeat);
+            record();
+        }
+    }
+    async apply(item) {
+        const { git, reporter } = this.deps;
+        const dir = checkoutDir(this.deps, item);
+        reporter.progress({ id: item.name, state: 'start', detail: item.action });
+        // A remote added before a later step fails is still added; the row says so either way.
+        let added = {};
+        try {
+            if (item.action === 'clone' && item.upstream !== undefined && item.branch !== undefined) {
+                await git.clone({ dir, upstream: item.upstream, origin: item.origin, branch: item.branch });
+                reporter.progress({ id: item.name, state: 'done', detail: 'cloned' });
+                return { ...item, result: 'done' };
+            }
+            if (item.upstream_to_add !== undefined)
+                added = { upstream_added: await prepareUpstream(this.deps, item, dir) };
+            if (item.origin !== undefined) {
+                await git.addRemote(dir, 'origin', item.origin);
+                added = { ...added, origin_added: true };
+            }
+            if (item.fetch)
+                await git.fetch(dir, 'upstream');
+            if (item.action === 'fast_forward' && item.branch !== undefined) {
+                const outcome = await git.fastForward(dir, 'upstream', item.branch);
+                const result = outcome === 'diverged' ? 'skipped' : 'done';
+                reporter.progress({
+                    id: item.name,
+                    state: result === 'done' ? 'done' : 'skip',
+                    detail: outcome,
+                });
+                return { ...item, ...added, result, outcome };
+            }
+            reporter.progress({ id: item.name, state: 'skip', detail: item.reason ?? item.action });
+            return { ...item, ...added, result: 'skipped' };
+        }
+        catch (err) {
+            const failure = toEnvelope(asDevkitError(err)).error;
+            const message = failure.message;
+            reporter.progress({ id: item.name, state: 'fail', detail: message });
+            return { ...item, ...added, result: 'failed', error: message, failure };
+        }
+    }
+}
+function repositorySummary(items) {
+    const count = (result) => items.filter((item) => item.result === result).length;
+    return {
+        done: count('done'),
+        skipped: count('skipped'),
+        failed: count('failed'),
+        unreadable: items.filter((item) => item.action === 'unreadable').length,
+    };
+}
+function repositoryChecks(items) {
+    return items
+        .filter((item) => item.action !== 'skip_unpicked')
+        .map((item) => {
+        const ready = item.result !== 'failed' &&
+            item.outcome !== 'diverged' &&
+            ['clone', 'fast_forward', 'skip_manifest'].includes(item.action);
+        let state = ready ? 'ready' : 'blocked';
+        if (item.result === 'planned')
+            state = 'unknown';
+        return preparationCheck(`repo:${item.name}`, state, item.error ?? item.reason ?? item.result, {
+            resource: item.name,
+            owner: item.action === 'unreadable' ? 'external' : 'user',
+            ...(item.failure ? { failure: item.failure, code: item.failure.code } : {}),
+        });
+    });
+}
+function needsRepositoryWrite(item) {
+    return (item.action === 'clone' ||
+        item.fetch ||
+        item.origin !== undefined ||
+        item.upstream_to_add !== undefined);
+}
+function selectedStages(input) {
+    let requested = input.only ?? ['repos', ...Object.keys(input.stages ?? {})];
+    if (typeof requested === 'string')
+        requested = [requested];
+    const wanted = new Set(requested);
+    return [
+        ...new Set(['services', 'setup', 'repos', ...Object.keys(input.stages ?? {}), ...requested]),
+    ].filter((stage) => wanted.has(stage));
+}
+function syncRecovery(deps, input, stages) {
+    if (input.initializing)
+        return undefined;
+    return {
+        id: 'resume-sync',
+        description: 'Retry the selected synchronization after resolving blockers',
+        argv: [
+            'fx',
+            'sync',
+            '--workspace',
+            deps.ctx.name,
+            '--no-refresh-manifest',
+            ...(input.only === undefined ? [] : ['--only', stages.join(',')]),
+        ],
+        cwd: deps.ctx.root,
+        actor: 'agent',
+        requires_approval: input.dryRun,
+    };
+}
+function markPending(pending, failedStage, stages, checks) {
+    for (const stage of pending) {
+        stages[stage] = { status: 'not_started' };
+        checks.push(preparationCheck(stage, 'blocked', `Not started after ${failedStage} failed`, {
+            required: !['hooks', 'mcp'].includes(stage),
+        }));
+    }
+}
+//# sourceMappingURL=index.js.map