@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/application/tool/install.js

@@ -0,0 +1,228 @@
+// Plan trusted package-manager operations and retain installation outcomes.
+import { asDevkitError, DevkitError, toEnvelope, withPartialResult, } from '../../domain/errors.js';
+import { commandOrigin, } from '../../domain/toolchain/resolve.js';
+import { assertWritable } from '../safety/posture.js';
+import { recoveryCommand } from '../workspace/guidance.js';
+import { assertToolSelection, selectTools } from './select.js';
+import { probeToolVersion } from './version.js';
+export const TOOL_INSTALL_COLUMNS = [
+    'name',
+    'via',
+    'vector',
+    'ran',
+    'code',
+    'version_after',
+    'error',
+];
+export class ToolInstall {
+    installers;
+    process;
+    audit;
+    constructor(installers, process, audit) {
+        this.installers = installers;
+        this.process = process;
+        this.audit = audit;
+    }
+    async execute(input) {
+        assertToolSelection(input.names, input.all === true);
+        const selected = input.all === true
+            ? await this.selectAll(input)
+            : selectTools(input.tools, input.names, {
+                workspace: input.trust?.workspace,
+                commandShell: input.commandShell,
+            });
+        const plans = [];
+        for (const tool of selected)
+            plans.push(await this.plan(tool, input));
+        if (input.dryRun)
+            return plans.map((plan) => plan.output);
+        if (plans.some((plan) => plan.output.vector !== null)) {
+            const action = input.update ? 'update' : 'install';
+            assertWritable(input.posture, `tool ${action} ${selected.map((tool) => tool.name).join(' ')}`);
+        }
+        if (input.requireInstallTrust) {
+            if (!input.trust)
+                throw new DevkitError('config', 'VECTOR_UNTRUSTED', 'Automatic installation requires workspace command trust', {
+                    nextSteps: [
+                        'Re-run the same command in a terminal and review the install vector.',
+                        `fx tool install ${selected.map((tool) => tool.name).join(' ')}`,
+                    ],
+                });
+            await input.trust.gate.ensureAll({
+                ...input.trust,
+                vectors: plans.flatMap((plan) => plan.output.vector === null
+                    ? []
+                    : [plan.output.vector, [plan.tool.binary, ...plan.tool.versionArgs]]),
+                origin: 'patch',
+                label: 'workspace initialization',
+            });
+        }
+        const results = plans.map((plan) => ({
+            ...plan.output,
+            status: 'not_started',
+        }));
+        for (const [index, plan] of plans.entries()) {
+            try {
+                results[index] = await this.apply(plan, input, (result) => {
+                    results[index] = result;
+                });
+            }
+            catch (error) {
+                const failure = toEnvelope(asDevkitError(error)).error;
+                results[index] = { ...results[index], status: 'failed', error: failure.message, failure };
+                throw withPartialResult(error, { tool_install: results });
+            }
+        }
+        return results;
+    }
+    async plan(tool, input) {
+        const { method, installer } = await this.choose(tool, input);
+        const vector = installer.vector(method.spec ?? tool.name, {
+            registry: method.registry,
+            update: input.update,
+        }) ?? null;
+        return {
+            tool,
+            method,
+            output: {
+                name: tool.name,
+                via: method.via,
+                vector,
+                docs: tool.docs ?? null,
+                ran: false,
+                code: null,
+                version_after: null,
+                status: 'planned',
+            },
+        };
+    }
+    async apply(plan, input, record) {
+        const { tool, output, method } = plan;
+        const { vector } = output;
+        if (vector === null || method.via === 'manual')
+            return { ...output, status: 'skipped' };
+        const entry = await this.startAudit(plan, input, vector);
+        let current = {
+            ...output,
+            ran: true,
+            status: 'not_started',
+            phase: 'install',
+        };
+        let binaryPath = null;
+        const retain = (result) => {
+            current = result;
+            record(result);
+        };
+        retain(current);
+        try {
+            const result = await this.process.run(vector, {
+                diagnostic: { phase: `${tool.name} package install` },
+            });
+            retain({ ...current, code: result.code, status: result.code === 0 ? 'done' : 'failed' });
+            if (result.code !== 0) {
+                retain({ ...current, error: result.stderr.trim() || result.stdout.trim() });
+                return current;
+            }
+            await this.audit.checkpoint(entry, {
+                event: 'installed',
+                code: 0,
+                version_after: null,
+                binary_path: null,
+                failure_code: null,
+            });
+            retain({ ...current, phase: 'version' });
+            binaryPath = (await this.process.which(tool.binary)) ?? null;
+            const version = await this.probe(tool, input.trust);
+            retain({ ...output, ran: true, code: 0, version_after: version ?? null, status: 'done' });
+            return current;
+        }
+        catch (error) {
+            const failure = toEnvelope(asDevkitError(error)).error;
+            retain({ ...current, status: 'failed', failure, error: failure.message });
+            throw error;
+        }
+        finally {
+            // Every path closes the ledger entry: an install that threw still happened.
+            await this.audit.checkpoint(entry, {
+                event: 'finished',
+                code: current.code,
+                version_after: current.version_after,
+                binary_path: binaryPath,
+                failure_code: current.failure?.code ?? null,
+            });
+        }
+    }
+    async startAudit({ tool, method }, input, vector) {
+        if (method.via === 'manual')
+            throw new DevkitError('internal', 'INTERNAL', 'Manual installs cannot execute');
+        return this.audit.start({
+            operation: input.operation ?? (input.update ? 'update' : 'install'),
+            workspace: input.trust?.workspace ?? null,
+            name: tool.name,
+            binary: tool.binary,
+            via: method.via,
+            spec: method.spec ?? tool.name,
+            vector,
+            binary_path_before: (await this.process.which(tool.binary)) ?? null,
+        });
+    }
+    async probe(tool, trust) {
+        const vector = [tool.binary, ...tool.versionArgs];
+        try {
+            if (trust !== undefined && commandOrigin(tool, 'versionArgs') === 'patch') {
+                await trust.gate.ensure({
+                    workspace: trust.workspace,
+                    commandShell: trust.commandShell,
+                    vector,
+                    label: `${tool.name} version check`,
+                    origin: 'patch',
+                    yes: trust.yes,
+                    posture: trust.posture,
+                });
+            }
+            return await probeToolVersion(this.process, tool, { propagateErrors: true });
+        }
+        catch (error) {
+            // The package is already installed: a version command nobody approved leaves the
+            // version unknown, it does not turn the installation into a failure.
+            if (!(error instanceof DevkitError) ||
+                !['VECTOR_UNTRUSTED', 'VECTOR_REJECTED'].includes(error.code))
+                throw error;
+            return undefined;
+        }
+    }
+    async choose(tool, input) {
+        // Declared order is the team's preference; availability on this machine is the
+        // only thing allowed to skip a method.
+        for (const method of tool.install) {
+            const installer = this.installers.find((i) => i.id === method.via);
+            if (installer !== undefined && (await installer.available()))
+                return { method, installer };
+        }
+        const wanted = tool.install.map((m) => m.via).filter((v) => v !== 'manual');
+        throw new DevkitError('config', 'INSTALLER_UNAVAILABLE', `No package manager on this machine can install ${tool.name}: it needs ${wanted.join(' or ') || 'a manual install'}`, {
+            hint: `Install ${wanted[0] ?? 'the tool'} first, or install ${tool.name} by hand${tool.docs === undefined ? '' : ` (${tool.docs})`}.`,
+            nextSteps: [
+                recoveryCommand({ workspace: input.trust?.workspace, commandShell: input.commandShell }, 'tool', 'show', tool.name),
+            ],
+        });
+    }
+    // --all: every enabled tool whose binary is not on PATH. An outdated tool
+    // is a `tool update` decision, not an implicit one.
+    async needing(tools) {
+        const needing = [];
+        for (const tool of tools) {
+            if (!tool.enabled)
+                continue;
+            if ((await this.process.which(tool.binary)) === undefined)
+                needing.push(tool);
+        }
+        return needing;
+    }
+    async selectAll(input) {
+        if (input.update)
+            return input.tools.filter((tool) => tool.enabled);
+        return this.needing(input.tools);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/application/tool/install.js.map

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

package/dist/application/tool/installed.js

@@ -0,0 +1,178 @@
+// Reconcile recorded package operations against every locally registered manifest.
+// PATH presence is observation only; suggestions never authorize package removal.
+import path from 'node:path';
+import { MANIFEST_FILES } from '../../domain/manifest/files.js';
+import { loadEnvironments, loadTools, loadToolsDocument, loadWorkspace, } from '../../domain/manifest/loader.js';
+import { bindPlatforms, bindProviders, } from '../../domain/manifest/providers.js';
+import { hasUnfinishedInstallation, observedInstallationOrigin, } from '../../domain/toolchain/installation-origin.js';
+import { resolveTools } from '../../domain/toolchain/resolve.js';
+import { keyedBinding, keyedPlatform, providerTools, selectToolchain, } from '../../domain/toolchain/select.js';
+export class ToolInstalled {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async execute() {
+        const history = await this.deps.history.read();
+        const requirements = await this.requirements();
+        const packages = new Map();
+        for (const event of history) {
+            const key = JSON.stringify([event.via, event.spec]);
+            const events = packages.get(key) ?? [];
+            events.push(event);
+            packages.set(key, events);
+        }
+        const rows = [];
+        for (const events of packages.values())
+            rows.push(await this.describe(events, requirements));
+        const recordedBinaries = new Set(history.map((event) => event.binary));
+        for (const tool of requirements.known) {
+            if (recordedBinaries.has(tool.binary))
+                continue;
+            recordedBinaries.add(tool.binary);
+            const binaryPath = (await this.deps.process.which(tool.binary)) ?? null;
+            if (binaryPath === null)
+                continue;
+            const requiredBy = [...requirements.tools]
+                .filter(([, tools]) => tools.some((entry) => entry.binary === tool.binary))
+                .map(([name]) => name);
+            rows.push({
+                name: tool.name,
+                binary: tool.binary,
+                binary_path: binaryPath,
+                via: null,
+                spec: null,
+                version_after: null,
+                last_operation: null,
+                last_recorded_at: null,
+                installation_origin: 'external',
+                recorded: false,
+                installed_by: [],
+                required_by: requiredBy,
+                unknown_workspaces: requirements.unknown,
+                state: requiredBy.length > 0 ? 'required' : 'external',
+                uninstall_hint: null,
+            });
+        }
+        return rows.sort((a, b) => a.name.localeCompare(b.name) || (a.spec ?? '').localeCompare(b.spec ?? ''));
+    }
+    async requirements() {
+        const config = await this.deps.config.read();
+        const tools = new Map();
+        const unknown = [];
+        const known = [];
+        for (const name of Object.keys(config.workspaces ?? {}).sort()) {
+            try {
+                const dir = this.deps.manifestDirFor(name);
+                const workspace = await this.deps.fs.readText(path.join(dir, MANIFEST_FILES.workspace));
+                // A missing source is unread requirements, not none.
+                const opts = { cliVersion: this.deps.cliVersion, providers: this.deps.providers };
+                const declarations = loadWorkspace(workspace ?? '', opts);
+                const patch = await this.deps.fs.readText(path.join(dir, MANIFEST_FILES.tools));
+                const loaded = loadTools(this.deps.bundledTools(), patch, {
+                    cliVersion: this.deps.cliVersion,
+                });
+                if (loaded.dropped.length > 0) {
+                    unknown.push(name);
+                    continue;
+                }
+                const resolved = resolveTools(loaded.doc, loaded.provenance, loaded.declared);
+                known.push(...resolved);
+                const selected = await this.selected(dir, declarations.doc, resolved, opts);
+                tools.set(name, selected.filter((tool) => tool.enabled));
+            }
+            catch {
+                unknown.push(name);
+            }
+        }
+        // A catalog tool no workspace selected is still not an unknown package, so read the catalog.
+        const catalog = loadToolsDocument(this.deps.bundledTools(), {
+            cliVersion: this.deps.cliVersion,
+        });
+        if (catalog.valid)
+            known.push(...resolveTools(catalog.doc, {}));
+        return { tools, unknown, known };
+    }
+    // A workspace needs the tools its own bindings reach, which is why the inventory reads its
+    // documents rather than assuming every registered workspace wants the whole catalog.
+    async selected(dir, workspace, resolved, opts) {
+        const text = await this.deps.fs.readText(path.join(dir, MANIFEST_FILES.environments));
+        const environments = text === undefined ? undefined : loadEnvironments(text, opts, { workspace }).doc;
+        const bindings = [
+            ...bindProviders(workspace, opts.providers).map(keyedBinding),
+            ...bindPlatforms(environments, opts.providers).map(keyedPlatform),
+        ];
+        const needed = providerTools(bindings, opts.providers, (tool) => resolved.some((entry) => entry.name === tool && entry.declared));
+        return selectToolchain(resolved, needed).tools;
+    }
+    async describe(events, requirements) {
+        const last = events.at(-1);
+        const success = [...events].reverse().find((event) => event.code === 0);
+        const requiredBy = [...requirements.tools]
+            .filter(([, tools]) => tools.some((tool) => tool.binary === last.binary ||
+            tool.install.some((method) => method.via === last.via && (method.spec ?? tool.name) === last.spec)))
+            .map(([name]) => name);
+        let binaryPath = null;
+        let probeFailed = false;
+        try {
+            binaryPath = (await this.deps.process.which(last.binary)) ?? null;
+        }
+        catch {
+            probeFailed = true;
+        }
+        const state = installationState({
+            success,
+            events,
+            requiredBy,
+            requirements,
+            binaryPath,
+            probeFailed,
+        });
+        return {
+            name: last.name,
+            via: last.via,
+            spec: last.spec,
+            binary: last.binary,
+            binary_path: binaryPath,
+            version_after: success?.version_after ?? null,
+            last_operation: last.operation,
+            last_recorded_at: last.at,
+            installation_origin: observedInstallationOrigin(events, binaryPath),
+            recorded: true,
+            installed_by: [
+                ...new Set(events.flatMap((event) => event.code === 0 && event.workspace !== null ? [event.workspace] : [])),
+            ].sort(),
+            required_by: requiredBy,
+            unknown_workspaces: requirements.unknown,
+            state,
+            uninstall_hint: state === 'unused'
+                ? `No registered workspace needs this recorded package. Review ${last.via} package ${last.spec} for manual removal after checking use outside fx.`
+                : null,
+        };
+    }
+}
+function installationState(input) {
+    if (input.requiredBy.length > 0)
+        return 'required';
+    if (input.requirements.unknown.length > 0 || input.probeFailed)
+        return 'unknown';
+    if (!input.success)
+        return 'unverified';
+    if (hasUnfinishedInstallation(input.events))
+        return 'unknown';
+    if (input.events.some((event) => event.workspace === null))
+        return 'unscoped';
+    if (input.binaryPath === null)
+        return 'not_on_path';
+    if (input.success.binary_path === null)
+        return 'unknown';
+    if (input.binaryPath !== input.success.binary_path)
+        return 'changed';
+    const origin = observedInstallationOrigin(input.events, input.binaryPath);
+    if (origin === 'external')
+        return 'external';
+    if (origin !== 'fx')
+        return 'unknown';
+    return 'unused';
+}
+//# sourceMappingURL=installed.js.map

package/dist/application/tool/installed.js.map

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

package/dist/application/tool/list.js

@@ -0,0 +1,38 @@
+// The toolchain as rows. `source` says why a tool is here at all — a binding derived it,
+// the patch named it, or fx merely knows it; `origin` says who owns its fields, which is
+// what tells a reader why a vector might need trust.
+export const TOOL_COLUMNS = [
+    'name',
+    'source',
+    'required',
+    'enabled',
+    'min_version',
+    'install_via',
+    'origin',
+    'desc',
+];
+export class ToolList {
+    execute(input) {
+        return input.tools.map((tool) => {
+            const source = input.sources.get(tool.name);
+            return {
+                name: tool.name,
+                desc: tool.desc ?? null,
+                required: tool.required,
+                enabled: tool.enabled,
+                min_version: tool.minVersion ?? null,
+                install_via: tool.install[0]?.via ?? null,
+                origin: originOf(tool),
+                source: source?.kind ?? 'catalog',
+                bound_by: source?.boundBy ?? [],
+                setup_steps: tool.setup.length,
+            };
+        });
+    }
+}
+function originOf(tool) {
+    if (tool.patchedFields.length === 0)
+        return 'base';
+    return tool.baseFields.length === 0 ? 'patch' : 'mixed';
+}
+//# sourceMappingURL=list.js.map

package/dist/application/tool/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/application/tool/list.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,yFAAyF;AACzF,qDAAqD;AAkBrD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM;IACN,QAAQ;IACR,UAAU;IACV,SAAS;IACT,aAAa;IACb,aAAa;IACb,QAAQ;IACR,MAAM;CACE,CAAC;AAEX,MAAM,OAAO,QAAQ;IACnB,OAAO,CAAC,KAGP;QACC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;gBACpC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI;gBACzC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;gBACtB,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,SAAS;gBACjC,QAAQ,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE;gBAC/B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;aAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAkB;IAClC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACnD,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAC1D,CAAC"}

package/dist/application/tool/scope.js

@@ -0,0 +1,74 @@
+// Which tools a workspace check covers: the ones it declares, plus the ones the providers
+// active in the selected environments drive.
+import { servesCapability } from '../../domain/manifest/providers.js';
+import { finding } from '../../domain/report.js';
+import { keyedBinding, keyedPlatform, providerTools, } from '../../domain/toolchain/select.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+import { declaredIn, toolchainOf } from './toolchain.js';
+export function workspaceToolScope(ctx, selection, commandShell) {
+    // Selection decides what a check covers by default; naming a tool explicitly may still
+    // reach one fx only knows, which is why the catalog counts as known here.
+    const toolchain = toolchainOf(ctx);
+    const available = toolchain.all;
+    const known = (tool) => available.some((entry) => entry.name === tool);
+    const bindings = activeBindings(ctx, selection);
+    const dependencies = new Set(providerTools(bindings, ctx.providers, declaredIn(available)).keys());
+    const problems = [
+        ...unservedBindings(ctx, bindings, declaredIn(available)).map((binding) => finding('manifest', `provider:${binding.key}`, 'fail', `Provider "${binding.provider}" ${ctx.providers.some((p) => p.id === binding.provider) ? `does not serve ${binding.capability}` : 'is not registered'}; readiness could not be checked.`, {
+            coverage: 'incomplete',
+            fix: workspaceCommand({ ctx, commandShell }, 'manifest', 'providers'),
+            evidence: { provider: binding.provider, capability: binding.capability },
+        })),
+    ];
+    const names = selection.tools ?? [
+        ...new Set([
+            ...toolchain.tools.filter((tool) => tool.required || tool.declared).map((tool) => tool.name),
+            ...dependencies,
+        ]),
+    ];
+    for (const name of names.filter((name) => !known(name)))
+        problems.push(finding('tools', name, 'fail', 'Neither the bundled catalog nor manifest/tools.yaml describes this tool.', {
+            coverage: 'incomplete',
+            fix: workspaceCommand({ ctx, commandShell }, 'tool', 'list', '--catalog'),
+        }));
+    return {
+        names,
+        problems,
+        configuredNames: names.filter(known),
+        covered: available.filter((tool) => names.includes(tool.name)),
+        dependencies,
+        required: new Set([
+            ...(selection.tools ?? []),
+            ...available.filter((tool) => isRequired(tool, dependencies)).map((tool) => tool.name),
+            ...[...dependencies].filter((name) => !known(name)),
+        ]),
+    };
+}
+// A binding fx cannot read: its provider is unregistered and names no tool either, or it is
+// registered under a different capability. Either way nothing can be checked for it.
+function unservedBindings(ctx, bindings, declaresTool) {
+    return bindings.filter((binding) => {
+        if (binding.provider === null || binding.source === 'misplaced')
+            return false;
+        const provider = ctx.providers.find((candidate) => candidate.id === binding.provider);
+        if (servesCapability(provider, binding.capability))
+            return false;
+        return provider !== undefined || !declaresTool(binding.provider);
+    });
+}
+function activeBindings(ctx, selection) {
+    const environments = Object.entries(ctx.manifest.environments?.result.doc.envs ?? {}).filter(([name]) => (selection.envs === undefined || selection.envs.includes(name)) &&
+        (ctx.local.scope?.envs === undefined || ctx.local.scope.envs.includes(name)));
+    return [
+        ...ctx.bindings.map(keyedBinding),
+        ...ctx.platforms
+            .filter((binding) => environments.some(([, env]) => env.platforms?.[binding.platform] !== undefined))
+            .map(keyedPlatform),
+    ];
+}
+function isRequired(tool, dependencies) {
+    return (tool.required ||
+        (tool.enabled && tool.installOnInit === true) ||
+        (dependencies.has(tool.name) && !tool.patchedFields.includes('required')));
+}
+//# sourceMappingURL=scope.js.map

package/dist/application/tool/scope.js.map

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

package/dist/application/tool/select.js

@@ -0,0 +1,28 @@
+// Naming tools on the command line: exact names or a correction, never a
+// silent subset.
+import { DevkitError } from '../../domain/errors.js';
+import { nearest } from '../../domain/fuzzy.js';
+import { recoveryCommand } from '../workspace/guidance.js';
+export function assertToolSelection(names, all) {
+    const named = (names?.length ?? 0) > 0;
+    if (named !== all)
+        return;
+    throw new DevkitError('usage', 'BAD_FLAG', named ? 'Tool names and --all are mutually exclusive' : 'Specify tool names or --all', { nextSteps: ['fx tool install --help', 'fx tool update --help'] });
+}
+export function selectTools(tools, names, context = {}) {
+    if (names === undefined)
+        return [...tools];
+    return names.map((name) => {
+        const tool = tools.find((t) => t.name === name);
+        if (tool !== undefined)
+            return tool;
+        const suggestion = nearest(name, tools.map((t) => t.name));
+        throw new DevkitError('not_found', 'TOOL_UNKNOWN', `No tool named "${name}" in the toolchain`, {
+            hint: suggestion === undefined
+                ? 'A tool joins the toolchain by being driven by a bound provider, or by being named in manifest/tools.yaml.'
+                : `Did you mean "${suggestion}"?`,
+            nextSteps: [recoveryCommand(context, 'tool', 'list', '--catalog')],
+        });
+    });
+}
+//# sourceMappingURL=select.js.map

package/dist/application/tool/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/application/tool/select.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,iBAAiB;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAC;AAEjF,MAAM,UAAU,mBAAmB,CAAC,KAAoC,EAAE,GAAY;IACpF,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO;IAC1B,MAAM,IAAI,WAAW,CACnB,OAAO,EACP,UAAU,EACV,KAAK,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,6BAA6B,EACrF,EAAE,SAAS,EAAE,CAAC,wBAAwB,EAAE,uBAAuB,CAAC,EAAE,CACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAA8B,EAC9B,KAAoC,EACpC,UAA2B,EAAE;IAE7B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,UAAU,GAAG,OAAO,CACxB,IAAI,EACJ,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACzB,CAAC;QACF,MAAM,IAAI,WAAW,CAAC,WAAW,EAAE,cAAc,EAAE,kBAAkB,IAAI,oBAAoB,EAAE;YAC7F,IAAI,EACF,UAAU,KAAK,SAAS;gBACtB,CAAC,CAAC,2GAA2G;gBAC7G,CAAC,CAAC,iBAAiB,UAAU,IAAI;YACrC,SAAS,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;SACnE,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/application/tool/show.js

@@ -0,0 +1,45 @@
+// One tool in full: the resolved entry, why the workspace has it, where each field came
+// from, and which providers depend on it.
+import { selectTools } from './select.js';
+export class ToolShow {
+    execute(input) {
+        const tool = selectTools(input.tools, [input.name], input)[0];
+        const fields = {};
+        for (const key of tool.baseFields)
+            fields[key] = 'base';
+        for (const key of tool.patchedFields)
+            fields[key] = 'patch';
+        return {
+            name: tool.name,
+            binary: tool.binary,
+            desc: tool.desc ?? null,
+            docs: tool.docs ?? null,
+            required: tool.required,
+            enabled: tool.enabled,
+            min_version: tool.minVersion ?? null,
+            install_on_init: tool.installOnInit ?? false,
+            version_args: tool.versionArgs,
+            install: tool.install.map((m) => ({
+                via: m.via,
+                spec: m.spec ?? null,
+                registry: m.registry ?? null,
+            })),
+            skill: tool.skill === undefined
+                ? null
+                : {
+                    command: tool.skill.command,
+                    agent_flag: tool.skill.agentFlag ?? null,
+                    dir_flag: tool.skill.dirFlag ?? null,
+                },
+            auth: tool.auth === undefined
+                ? null
+                : { command: tool.auth.command, docs: tool.auth.docs ?? null },
+            setup_steps: tool.setup.map((s) => ({ id: s.id, kind: s.kind, title: s.title })),
+            fields,
+            source: input.sources.get(tool.name)?.kind ?? 'catalog',
+            bound_by: input.sources.get(tool.name)?.boundBy ?? [],
+            depended_on_by: input.dependants[tool.name] ?? [],
+        };
+    }
+}
+//# sourceMappingURL=show.js.map