@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/application/workspace/scope.js

@@ -0,0 +1,89 @@
+// Edit repository and environment scope while preserving dynamic all and explicit selections.
+import { DevkitError } from '../../domain/errors.js';
+import { shellLine } from '../../domain/shell.js';
+import { assertWritable } from '../safety/posture.js';
+import { validateWorkspaceLayer } from './validate-layer.js';
+export function scopeMode(names) {
+    if (names === null || names === undefined)
+        return 'all';
+    return names.length === 0 ? 'none' : 'explicit';
+}
+export async function editScope(deps, edit) {
+    if ((edit.operation === 'all' || edit.operation === 'none') && edit.names.length > 0)
+        throw new DevkitError('usage', 'INPUT_INVALID', 'Names cannot be combined with --all or --none', { nextSteps: [`fx ${edit.key === 'repos' ? 'repo' : 'env'} select --help`] });
+    if (edit.operation === 'replace' && edit.names.length === 0)
+        throw new DevkitError('usage', 'INPUT_REQUIRED', 'Select names, --all, or --none', {
+            nextSteps: [`fx ${edit.key === 'repos' ? 'repo' : 'env'} select --help`],
+        });
+    for (const name of edit.names)
+        if (!edit.universe.includes(name))
+            throw edit.notFound(name);
+    let planned = await planEdit(deps, edit, await deps.localStore.read(deps.ctx.name));
+    if (edit.dryRun || !planned.output.changed)
+        return planned.output;
+    assertWritable(edit.posture, `${edit.key} ${edit.operation}`);
+    await deps.localStore.update(deps.ctx.name, async (current) => {
+        planned = await planEdit(deps, edit, current);
+        return planned.layer;
+    });
+    return { ...planned.output, written: true };
+}
+async function planEdit(deps, edit, local) {
+    const before = local.scope?.[edit.key] ?? null;
+    const next = nextList(before, edit);
+    const plan = {
+        scope: 'workspace',
+        workspace: deps.ctx.name,
+        path: deps.localStore.path(deps.ctx.name),
+        before,
+        after: next.after,
+        before_mode: scopeMode(before),
+        mode: scopeMode(next.after),
+        next_steps: [
+            shellLine([
+                'fx',
+                ...(edit.key === 'repos' ? ['sync'] : ['env', 'list']),
+                '--workspace',
+                deps.ctx.name,
+            ], deps.commandShell),
+        ],
+        changed: next.changed,
+        written: false,
+        ...(next.reason === undefined ? {} : { reason: next.reason }),
+    };
+    const scope = { ...local.scope };
+    if (next.after === null)
+        delete scope[edit.key];
+    else
+        scope[edit.key] = [...next.after];
+    const layer = { ...local, scope };
+    await validateWorkspaceLayer(deps.fs, deps.ctx.root, deps.ctx.manifest.workspace.result.doc, layer, deps.ctx.workspace.repos.find((repo) => repo.origin === 'manifest'));
+    return { output: plan, layer };
+}
+function nextList(before, edit) {
+    if (edit.operation === 'all')
+        return { after: null, changed: before !== null };
+    if (edit.operation === 'replace' || edit.operation === 'none') {
+        const after = edit.operation === 'none' ? [] : [...new Set(edit.names)];
+        return { after, changed: JSON.stringify(before) !== JSON.stringify(after) };
+    }
+    if (edit.operation === 'pick') {
+        if (before === null)
+            return {
+                after: null,
+                changed: false,
+                reason: `every ${edit.key === 'repos' ? 'shared repository' : 'environment'} is already in scope`,
+            };
+        const after = [...new Set([...before, ...edit.names])];
+        return { after, changed: after.length !== before.length };
+    }
+    const base = before ?? edit.universe;
+    const after = base.filter((n) => !edit.names.includes(n));
+    return { after, changed: before === null || after.length !== base.length };
+}
+export function selectOperation(all, none) {
+    if (all)
+        return 'all';
+    return none ? 'none' : 'replace';
+}
+//# sourceMappingURL=scope.js.map

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

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

package/dist/application/workspace/source-preview.js

@@ -0,0 +1,64 @@
+// Inspect and validate rebind candidates while keeping recovery attached to their source.
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { LoadManifest } from '../manifest/load.js';
+import { sourceValidationError } from '../manifest/source-error.js';
+export async function inspectRebindSource(source, input) {
+    let inspection;
+    try {
+        inspection = await source.inspect?.();
+        if (!inspection && source.kind === 'file') {
+            const root = source.description;
+            const nested = await input.fs.exists(path.join(root, 'manifest/workspace.yaml'));
+            if (!nested && !(await input.fs.exists(path.join(root, 'workspace.yaml'))))
+                throw new DevkitError('not_found', 'MANIFEST_SOURCE_INVALID', 'The local source contains no workspace.yaml', { nextSteps: ['fx workspace rebind --help'] });
+            inspection = {
+                root,
+                readText: (relative) => input.fs.readText(path.join(root, nested ? relative : relative.replace(/^manifest\//, ''))),
+            };
+        }
+        if (!inspection)
+            return 'pending_apply';
+        const reader = inspection;
+        await new LoadManifest({
+            readText: (file) => reader.readText(path.relative(reader.root, file).split(path.sep).join('/')),
+        }, input.bundledTools).execute({ dir: reader.root, cliVersion: input.cliVersion, providers: input.providers });
+        return 'validated';
+    }
+    catch (error) {
+        throw rebindSourceError(error, source, input, inspection);
+    }
+}
+export async function materializeRebindSource(source, input, dir) {
+    let materialized = false;
+    try {
+        await source.materialize(dir);
+        materialized = true;
+        await new LoadManifest(input.fs, input.bundledTools).execute({
+            dir,
+            cliVersion: input.cliVersion,
+            providers: input.providers,
+        });
+    }
+    catch (error) {
+        throw rebindSourceError(error, source, input, materialized ? { root: dir } : undefined);
+    }
+}
+function rebindSourceError(error, source, input, inspection) {
+    return sourceValidationError(error, {
+        source,
+        inspected: inspection,
+        retry: [
+            'fx',
+            'workspace',
+            'rebind',
+            input.workspace,
+            '--from',
+            source.description,
+            '--dry-run',
+        ],
+        commandShell: input.commandShell,
+        preservedWorkspace: input.workspace,
+    });
+}
+//# sourceMappingURL=source-preview.js.map

package/dist/application/workspace/source-preview.js.map

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

package/dist/application/workspace/validate-layer.js

@@ -0,0 +1,48 @@
+// Resolve proposed personal layers and reject physical checkout overlap before they are persisted.
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { applyLocal, } from '../../domain/manifest/local.js';
+import { isAtOrInside, windowsPathProblem } from '../../domain/path.js';
+export async function physicalPath(fs, target) {
+    const absolute = path.resolve(target);
+    let ancestor = absolute;
+    while (!(await fs.exists(ancestor))) {
+        const parent = path.dirname(ancestor);
+        if (parent === ancestor)
+            break;
+        ancestor = parent;
+    }
+    return path.resolve(await fs.realpath(ancestor), path.relative(ancestor, absolute));
+}
+export async function validateWorkspaceLayer(fs, root, shared, local, manifestRepo) {
+    const workspace = applyLocal(shared, local);
+    const repos = manifestRepo === undefined || workspace.repos.some((repo) => repo.name === manifestRepo.name)
+        ? workspace.repos
+        : [...workspace.repos, manifestRepo];
+    const physicalRoot = await physicalPath(fs, root);
+    const owners = [];
+    for (const repo of repos) {
+        const resolved = await physicalPath(fs, path.resolve(root, repo.path));
+        const problem = path.sep === '\\' ? windowsPathProblem(resolved) : undefined;
+        if (problem)
+            throw new DevkitError('config', 'LOCAL_INVALID', problem, {
+                nextSteps: [`Give ${repo.name} a checkout path Windows can address, then select it again.`],
+            });
+        if (repo.origin !== 'manifest' && isAtOrInside(physicalRoot, resolved))
+            throw invalid(`${repo.name} would make the workspace root part of its checkout: ${resolved}`);
+        const owner = owners.find((item) => isAtOrInside(resolved, item.path) || isAtOrInside(item.path, resolved));
+        if (owner !== undefined)
+            throw invalid(`${repo.name} and ${owner.name} resolve to overlapping checkouts: ${resolved}`);
+        owners.push({ path: resolved, name: repo.name });
+    }
+    return { ...workspace, repos };
+}
+function invalid(message) {
+    return new DevkitError('config', 'LOCAL_INVALID', message, {
+        hint: 'Repository checkouts must be disjoint and must not contain the workspace root.',
+        nextSteps: [
+            'Keep the previous selection, or remove the conflicting local repository reference before selecting these repositories.',
+        ],
+    });
+}
+//# sourceMappingURL=validate-layer.js.map

package/dist/application/workspace/validate-layer.js.map

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

package/dist/application/workspace-context.js

@@ -0,0 +1,71 @@
+// Resolve a registry identity, shared declarations and personal layer before workspace use.
+import path from 'node:path';
+import { describeManifestRepo } from '../domain/manifest/source-repo.js';
+import { loadManifestContext } from './manifest/context.js';
+import { assertWorkspacePrepared, contextualWorkspaceError } from './workspace/health.js';
+import { resolveWorkspace } from './workspace/resolve.js';
+import { validateWorkspaceLayer } from './workspace/validate-layer.js';
+export class WorkspaceContext {
+    root;
+    name;
+    context;
+    local;
+    workspace;
+    selection;
+    manifest;
+    providers;
+    bindings;
+    platforms;
+    constructor(root, name, context, local, workspace, selection) {
+        this.root = root;
+        this.name = name;
+        this.context = context;
+        this.local = local;
+        this.workspace = workspace;
+        this.selection = selection;
+        this.manifest = context.bundle;
+        this.providers = context.providers;
+        this.bindings = context.bindings;
+        this.platforms = context.platforms;
+    }
+    get manifestDir() {
+        return this.context.dir;
+    }
+    static async preview(root, name, context, local, fs) {
+        const workspace = await validateWorkspaceLayer(fs, root, context.bundle.workspace.result.doc, local);
+        return new WorkspaceContext(root, name, context, local, workspace, 'explicit');
+    }
+    static async locate(input) {
+        const located = await resolveWorkspace(input);
+        await assertWorkspacePrepared(input, located, input.allowMissingRoot);
+        const context = await loadManifestContext({ ...input, dir: located.manifestDir }).catch((error) => {
+            throw contextualWorkspaceError(input, located, error);
+        });
+        const local = await input.localStore.read(located.name);
+        const workspace = await validateWorkspaceLayer(input.fs, located.root, context.bundle.workspace.result.doc, local, await manifestRepoOf(input, located));
+        reportUnmatched(input.reporter, workspace);
+        return new WorkspaceContext(located.root, located.name, context, local, workspace, located.selection);
+    }
+}
+// The manifest checkout is a repository of the workspace when the source is
+// one; an entry of the same name in the manifest wins.
+async function manifestRepoOf(input, located) {
+    const source = (await input.config.read()).workspaces?.[located.name]?.source;
+    if (source === undefined)
+        return undefined;
+    if (!(await input.fs.exists(path.join(located.manifestDir, '.git'))))
+        return undefined;
+    const branch = (await input.git.remoteHead(located.manifestDir, 'upstream')) ?? 'main';
+    return describeManifestRepo(source, located.manifestDir, branch);
+}
+function reportUnmatched(reporter, workspace) {
+    if (workspace.unmatched.length === 0)
+        return;
+    reporter.notice({
+        code: 'LOCAL_OVERRIDE_UNMATCHED',
+        message: `the personal layer names repositories the manifest does not have: ${workspace.unmatched.join(', ')}`,
+        nextSteps: ['fx repo list', 'fx self info'],
+        data: { unmatched: workspace.unmatched },
+    });
+}
+//# sourceMappingURL=workspace-context.js.map

package/dist/application/workspace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-context.js","sourceRoot":"","sources":["../../src/application/workspace-context.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAOzE,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAmC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAWvE,MAAM,OAAO,gBAAgB;IAOhB;IACA;IACA;IACA;IACA;IACA;IAXF,QAAQ,CAAiB;IACzB,SAAS,CAAkB;IAC3B,QAAQ,CAAqB;IAC7B,SAAS,CAA6B;IAE/C,YACW,IAAY,EACZ,IAAY,EACZ,OAAwB,EACxB,KAAiB,EACjB,SAA4B,EAC5B,SAA+B;QAL/B,SAAI,GAAJ,IAAI,CAAQ;QACZ,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAiB;QACxB,UAAK,GAAL,KAAK,CAAY;QACjB,cAAS,GAAT,SAAS,CAAmB;QAC5B,cAAS,GAAT,SAAS,CAAsB;QAExC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,IAAY,EACZ,IAAY,EACZ,OAAwB,EACxB,KAAiB,EACjB,EAAc;QAEd,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAC5C,EAAE,EACF,IAAI,EACJ,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EACnC,KAAK,CACN,CAAC;QACF,OAAO,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAkB;QACpC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CACrF,CAAC,KAAc,EAAE,EAAE;YACjB,MAAM,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC,CACF,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAC5C,KAAK,CAAC,EAAE,EACR,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EACnC,KAAK,EACL,MAAM,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CACrC,CAAC;QACF,eAAe,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC3C,OAAO,IAAI,gBAAgB,CACzB,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,IAAI,EACZ,OAAO,EACP,KAAK,EACL,SAAS,EACT,OAAO,CAAC,SAAS,CAClB,CAAC;IACJ,CAAC;CACF;AAED,4EAA4E;AAC5E,uDAAuD;AACvD,KAAK,UAAU,cAAc,CAC3B,KAAkB,EAClB,OAAgB;IAEhB,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9E,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC;IACvF,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,eAAe,CAAC,QAAkB,EAAE,SAA4B;IACvE,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC7C,QAAQ,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,qEAAqE,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC9G,SAAS,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC;QAC3C,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE;KACzC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/base.js

@@ -0,0 +1,340 @@
+// The command base. It resolves the global flags in a lenient pre-parse so
+// the renderer and posture exist before the command's own strict parse, and
+// it is the single error boundary: whatever escapes a command leaves through
+// the renderer's error contract on stderr and a category exit code.
+import { Command, Errors } from '@oclif/core';
+import { readSettings } from '../application/config/settings.js';
+import { resolveManifestDir } from '../application/manifest/locate.js';
+import { resolvePosture } from '../application/safety/posture.js';
+import { toolchainOf } from '../application/tool/toolchain.js';
+import { beginWorkspaceCommand } from '../application/workspace/command-operation.js';
+import { fxExecutable } from '../composition/bundled.js';
+import { CommandWiring, resolveInputFor } from '../composition/command-wiring.js';
+import { createContainer } from '../composition/container.js';
+import { causeChain } from '../domain/diagnostics.js';
+import { asDevkitError, DevkitError, exitCodeFor } from '../domain/errors.js';
+import { DEFAULT_FORMAT, isFormat } from '../domain/format.js';
+import { resolveCommandShell } from '../domain/shell.js';
+import { globalFlags } from './flags.js';
+import { invocationFormat, UNDECIDED_FORMAT } from './invocation-format.js';
+import { preparationText } from './preparation-view.js';
+import { createRenderer, parseFields, processIo, } from './render/index.js';
+import { reportCommand } from './render/report.js';
+import { SinkReporter } from './reporter.js';
+import { invocation } from './trace.js';
+import { shouldCheckUpdates, updateNotices } from './update-notices.js';
+import { workspaceWriteMode } from './workspace-write-policy.js';
+export class FxCommand extends Command {
+    static baseFlags = globalFlags;
+    container = createContainer(process.env);
+    renderer = createRenderer(UNDECIDED_FORMAT, processIo());
+    reportSink;
+    noInput = false;
+    yes = false;
+    posture = { readOnly: false, source: 'default' };
+    format = DEFAULT_FORMAT;
+    // What the renderer was built with: a command that decides which rows to hand
+    // it reads the same projection settings instead of parsing the flags again.
+    renderOptions = {};
+    commandShell = 'posix';
+    workspaceName;
+    configUser;
+    configAgentList;
+    // Off until init has read the configuration; a command that failed before
+    // then must not go looking upstream.
+    updateCheckOn = false;
+    quietOn = false;
+    located;
+    commandWiring;
+    operationLease;
+    selection;
+    get commandName() {
+        return `fx ${this.commandWords}`.trim();
+    }
+    get commandWords() {
+        return (this.id ?? '').replaceAll(':', ' ');
+    }
+    // Resolve and connect output before acquiring the workspace lease so lock
+    // failures use the requested format and retain diagnostics.
+    async init() {
+        await super.init();
+        const file = await this.container.config.read();
+        // The parse below already rejects an unknown flag, and that error has to read the
+        // way the caller asked.
+        this.renderer = createRenderer(invocationFormat(this.argv, process.env, file), processIo());
+        const spec = this.constructor;
+        const { flags } = await this.parse({ ...spec, baseFlags: globalFlags, strict: false });
+        const settings = readSettings({
+            env: process.env,
+            file,
+            flags: { command_shell: flags['command-shell'], format: flags.format },
+        });
+        this.commandShell = resolveCommandShell(settings.commandShell, process.platform === 'win32');
+        this.configUser = settings.user;
+        this.configAgentList = settings.agents;
+        this.updateCheckOn = settings.updateCheck;
+        const format = settings.format;
+        if (format !== undefined && !isFormat(format)) {
+            throw new DevkitError('config', 'CONFIG_INVALID', `Unknown output format "${format}"`, {
+                hint: `Choose one of: human, json, ndjson.`,
+                nextSteps: ['fx config set format human', 'Unset FX_FORMAT if it supplies this value.'],
+            });
+        }
+        this.format = format ?? DEFAULT_FORMAT;
+        this.renderOptions = {
+            report: reportCommand(this.id),
+            details: flags['details'] === true,
+            fields: parseFields(flags.fields),
+            quiet: flags.quiet,
+            verbose: flags.verbose,
+            noHeader: flags['no-header'],
+            shell: this.commandShell,
+        };
+        this.renderer = createRenderer(this.format, processIo(), this.renderOptions);
+        this.container.diagnostics.connect(this.renderer);
+        this.showWork();
+        this.noInput = flags['no-input'] || !process.stdin.isTTY;
+        this.quietOn = flags.quiet;
+        this.yes = flags.yes;
+        this.workspaceName = flags.workspace;
+        this.posture = resolvePosture({ allowWrites: flags['allow-writes'], env: process.env, file });
+        const mode = workspaceWriteMode(this.id, flags);
+        if (mode !== null && !this.posture.readOnly) {
+            const operation = await beginWorkspaceCommand(this.resolveInput(), this.container.lock, mode === 'source');
+            if (operation) {
+                this.operationLease = operation.lease;
+                this.workspaceName = operation.located.name;
+                this.selection = operation.located.selection;
+            }
+        }
+    }
+    // From here until the command ends, a person watching stderr sees that fx is at work.
+    // It starts before the workspace lease: waiting for another fx is work too.
+    showWork() {
+        const { status } = this.renderer;
+        if (status === undefined)
+            return;
+        this.container.activity.connect(status);
+        status.start(this.commandWords);
+    }
+    get configAgents() {
+        return this.configAgentList;
+    }
+    get user() {
+        return this.configUser;
+    }
+    // One reporter for the whole command. It reads `renderer` per call, because
+    // init replaces the default renderer once the output format is known.
+    get reporter() {
+        this.reportSink ??= new SinkReporter({
+            notice: (notice) => this.renderer.notice(notice),
+            progress: (event) => this.renderer.progress(event),
+        });
+        return this.reportSink;
+    }
+    async renderPreparation(value, exitIncomplete = true) {
+        const bound = this.bindPreparation(value.preparation, fxExecutable());
+        const result = { ...value, preparation: bound };
+        const viewed = this.format === 'human' && !this.renderOptions.fields;
+        if (viewed) {
+            // A person types `fx`; the exact executable matters only where PATH cannot reach it.
+            const spoken = (await this.container.process.which('fx'))
+                ? this.bindPreparation(value.preparation, ['fx'])
+                : bound;
+            this.renderer.text(preparationText({ ...value, preparation: spoken }, {
+                shell: this.commandShell,
+                display: this.renderer.display.out,
+                includeEnvironment: process.env.FX_HOME !== undefined,
+            }));
+            if (this.renderOptions.details || this.renderOptions.verbose)
+                this.renderer.record(result);
+        }
+        else
+            this.renderer.record(result);
+        if (bound.state === 'incomplete' && exitIncomplete) {
+            const error = new DevkitError('incomplete', 'PREPARATION_INCOMPLETE', 'Required workspace preparation is unfinished', {
+                nextSteps: [
+                    bound.next.message,
+                    'Use preparation.next_actions for Agent work; preparation.resume continues after the blockers change.',
+                ],
+            });
+            // The view already told a person watching both streams; anyone else reads the error.
+            const { out, err } = this.renderer.display;
+            if (!(viewed && out.interactive && err.interactive))
+                this.renderer.error(error);
+            invocation.trace?.failed(error);
+            this.exit(exitCodeFor('incomplete'));
+        }
+    }
+    bindPreparation(preparation, executable) {
+        const bind = (action) => this.bindRecoveryAction(action, executable);
+        const bindCheck = (check) => ({
+            ...check,
+            ...(check.actions ? { actions: check.actions.map(bind) } : {}),
+        });
+        return {
+            ...preparation,
+            next_actions: preparation.next_actions.map(bind),
+            resume: preparation.resume ? bind(preparation.resume) : null,
+            blockers: preparation.blockers.map(bindCheck),
+            warnings: preparation.warnings.map(bindCheck),
+            unchecked: preparation.unchecked.map(bindCheck),
+        };
+    }
+    bindRecoveryAction(action, executable) {
+        if (action.argv[0] !== 'fx')
+            return action;
+        return {
+            ...action,
+            argv: [
+                ...executable,
+                ...action.argv.slice(1),
+                ...(this.format === 'human' ? [] : ['--format', this.format]),
+            ],
+            env: this.wiring().recoveryEnv(),
+        };
+    }
+    async workspaceDeps() {
+        return this.wiring().workspaceDeps(await this.workspace());
+    }
+    harnessInput() {
+        return this.wiring().harnessInput();
+    }
+    // Built on first use, after init has settled the invocation it describes.
+    wiring() {
+        this.commandWiring ??= new CommandWiring({
+            container: this.container,
+            resolve: this.resolveInput(),
+            env: process.env,
+            cliVersion: this.config.version,
+            noInput: this.noInput,
+            yes: this.yes,
+            posture: this.posture,
+            commandShell: this.commandShell,
+            reporter: this.reporter,
+            agents: this.configAgentList,
+            user: this.configUser,
+        });
+        return this.commandWiring;
+    }
+    hookDoctorChecks() {
+        return this.wiring().hookDoctorChecks();
+    }
+    loginDeps() {
+        return this.wiring().loginDeps();
+    }
+    initDeps() {
+        return this.wiring().initDeps();
+    }
+    stages(deps, dryRun) {
+        return this.wiring().stages(deps, dryRun);
+    }
+    skillDeps() {
+        return this.wiring().skillDeps();
+    }
+    replacement() {
+        return this.wiring().replacement();
+    }
+    trustGate() {
+        return this.wiring().trustGate();
+    }
+    // Tool commands work outside a workspace too, on the bundled baseline.
+    async toolchain() {
+        try {
+            return toolchainOf(await this.workspace());
+        }
+        catch (err) {
+            if (!(err instanceof DevkitError) || err.code !== 'WORKSPACE_NOT_FOUND')
+                throw err;
+            this.renderer.notice({
+                code: 'TOOLCHAIN_BUNDLED',
+                message: 'not inside a workspace; using the bundled toolchain baseline',
+                nextSteps: ['fx init <dir> --from <source>'],
+            });
+            return this.wiring().bundledToolchain();
+        }
+    }
+    async workspace() {
+        this.located = await this.wiring().locateWorkspace();
+        return this.located;
+    }
+    updateChecks() {
+        return this.wiring().updateChecks();
+    }
+    skipUpdateChecks() {
+        this.updateCheckOn = false;
+    }
+    get updateChecksOn() {
+        return this.updateCheckOn && !this.quietOn;
+    }
+    async fxUpdateInput(options = {}) {
+        const { name } = this.config.pjson;
+        return this.wiring().fxUpdateInput(name, options.resolveRegistry !== false);
+    }
+    async finally(err) {
+        try {
+            await this.operationLease?.release();
+            const gate = { id: this.id, quiet: this.quietOn, enabled: this.updateCheckOn };
+            if (shouldCheckUpdates(gate)) {
+                const notices = await updateNotices(this.updateChecks(), await this.fxUpdateInput(), this.located === undefined
+                    ? undefined
+                    : { workspace: this.located.name, sourceDir: this.located.manifestDir });
+                for (const notice of notices)
+                    this.renderer.notice(notice);
+            }
+        }
+        finally {
+            this.renderer.status?.stop();
+        }
+        return super.finally(err);
+    }
+    manifestDir() {
+        return resolveManifestDir(this.resolveInput());
+    }
+    manifestContext(dir) {
+        return this.wiring().manifestContext(dir);
+    }
+    resolveInput() {
+        return resolveInputFor(this.container, {
+            cwd: process.cwd(),
+            selection: this.selection,
+            name: this.workspaceName,
+            commandShell: this.commandShell,
+            reporter: this.reporter,
+        });
+    }
+    async catch(err) {
+        if (err instanceof Errors.ExitError)
+            throw err;
+        const failure = this.classify(err);
+        invocation.trace?.failed(failure);
+        if (failure.category === 'internal')
+            this.renderer.emit({
+                kind: 'cause',
+                phase: 'error boundary',
+                cause_chain: causeChain(failure),
+            });
+        if (failure.partialResult !== undefined) {
+            if ('preparation' in failure.partialResult)
+                await this.renderPreparation(failure.partialResult, false);
+            else
+                this.renderer.record(failure.partialResult);
+        }
+        this.renderer.error(failure);
+        return this.exit(exitCodeFor(failure.category));
+    }
+    classify(err) {
+        if (err instanceof DevkitError)
+            return err;
+        // Only oclif's own parser throws its CLIError inside a command: a bad
+        // flag, a missing argument, an unexpected one.
+        if (err instanceof Errors.CLIError) {
+            return new DevkitError('usage', 'BAD_FLAG', err.message, {
+                hint: `Check \`${this.commandName} --help\` for the accepted flags and arguments.`,
+                nextSteps: [`${this.commandName} --help`],
+            });
+        }
+        return asDevkitError(err);
+    }
+}
+//# sourceMappingURL=base.js.map