@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/application/probe-record/plan.js

@@ -0,0 +1,175 @@
+// The plan binds a shared coordinate to unchanged source documents. It writes
+// per-repository evidence whenever an environment-level edit could overstate it.
+import path from 'node:path';
+import { scanBoundary } from '../../domain/boundary/scan.js';
+import { DevkitError } from '../../domain/errors.js';
+import { MANIFEST_FILES } from '../../domain/manifest/files.js';
+import { loadEnvironments, loadWorkspace } from '../../domain/manifest/loader.js';
+import { setYamlStrings } from '../../domain/manifest/path-editor.js';
+import { coordinateFingerprint, probeScope } from '../../domain/obs/observation.js';
+import { shellLine } from '../../domain/shell.js';
+import { Where } from '../where.js';
+import { findKnownRepo } from '../workspace/inspect.js';
+export async function planProbeRecord(deps, input) {
+    if (!input.probe || !input.env || !input.platform)
+        throw inputRequired(input.repo);
+    const documents = await readDocuments(deps);
+    const [row] = await new Where(deps.workspace, deps.login).execute({
+        ...input,
+        probe: true,
+        previewProbe: true,
+        check: false,
+    });
+    if (!row)
+        throw probeChangedError();
+    const repo = findKnownRepo(deps.workspace, row.repo);
+    assertShared(repo.origin);
+    const template = row.probe_template ?? null;
+    const entry = documents.environments.envs[row.env]?.platforms?.[row.platform];
+    const scope = template && entry
+        ? probeScope({
+            template,
+            vars: {
+                ...documents.environments.platforms[row.platform]?.vars,
+                ...entry.vars,
+                ...repo.obs?.overrides?.[row.platform]?.[row.env]?.vars,
+            },
+            hasRepoOverride: documents.workspace.repos.some((item) => item.obs?.overrides?.[row.platform]?.[row.env] !== undefined) || Object.keys(entry.observations ?? {}).length > 0,
+        })
+        : null;
+    const base = ['envs', row.env, 'platforms', row.platform];
+    const target = scope === 'repository' ? [...base, 'observations', row.repo] : base;
+    const current = scope === 'repository' ? entry?.observations?.[row.repo] : entry;
+    const output = {
+        action: scope ? 'preview' : 'skipped',
+        file: path.join(deps.workspace.ctx.manifestDir, MANIFEST_FILES.environments),
+        scope,
+        path: scope ? target : null,
+        before: current?.confidence ?? null,
+        after: null,
+        note: null,
+        row,
+        written: false,
+        handoff: null,
+    };
+    const plan = { ...documents, output, template, previousNote: current?.note ?? '' };
+    if (scope)
+        validatePreview(deps, plan);
+    return plan;
+}
+function validatePreview(deps, plan) {
+    assertSafeNote(JSON.stringify(plan.output.row.vars));
+    assertSafeNote(plan.previousNote + '\n' + shellLine(plan.template));
+    const preview = setYamlStrings({
+        text: plan.environmentSnapshot.text,
+        values: recordValues(plan, 'verified', plan.previousNote),
+    });
+    validateEdited(deps, plan, preview);
+}
+async function readDocuments(deps) {
+    const root = deps.workspace.ctx.manifestDir;
+    const workspaceSnapshot = await deps.files.read({ root, relative: MANIFEST_FILES.workspace });
+    const environmentSnapshot = await deps.files.read({
+        root,
+        relative: MANIFEST_FILES.environments,
+    });
+    if (workspaceSnapshot.kind !== 'file' ||
+        environmentSnapshot.kind !== 'file' ||
+        workspaceSnapshot.text === null ||
+        environmentSnapshot.text === null)
+        throw new DevkitError('config', 'PROBE_RECORD_FILE_UNSAFE', 'Recording requires regular source manifest files', {
+            nextSteps: [
+                `Replace the symbolic links or missing files under ${root} with the regular manifest documents ${MANIFEST_FILES.workspace} and ${MANIFEST_FILES.environments}.`,
+                'fx manifest validate',
+            ],
+        });
+    const opts = {
+        cliVersion: deps.workspace.cliVersion,
+        providers: deps.workspace.ctx.providers,
+        strict: true,
+        allowInvalid: true,
+    };
+    const workspace = loadWorkspace(workspaceSnapshot.text, opts);
+    if (!workspace.valid || workspace.problems.length)
+        throw invalid();
+    const environments = loadEnvironments(environmentSnapshot.text, opts, {
+        workspace: workspace.doc,
+    });
+    if (!environments.valid || environments.problems.length)
+        throw invalid();
+    if (JSON.stringify(workspace.doc) !==
+        JSON.stringify(deps.workspace.ctx.manifest.workspace.result.doc) ||
+        JSON.stringify(environments.doc) !==
+            JSON.stringify(deps.workspace.ctx.manifest.environments?.result.doc))
+        throw probeChangedError();
+    return {
+        workspaceSnapshot,
+        environmentSnapshot,
+        workspace: workspace.doc,
+        environments: environments.doc,
+    };
+}
+export async function assertProbeSources(deps, plan) {
+    const root = deps.workspace.ctx.manifestDir;
+    for (const [relative, before] of [
+        [MANIFEST_FILES.workspace, plan.workspaceSnapshot],
+        [MANIFEST_FILES.environments, plan.environmentSnapshot],
+    ]) {
+        const current = await deps.files.read({ root, relative });
+        if (current.kind !== before.kind || current.text !== before.text)
+            throw probeChangedError();
+    }
+}
+export function recordValues(plan, confidence, note) {
+    const target = plan.output.path;
+    const values = [
+        { path: [...target, 'confidence'], value: confidence },
+        { path: [...target, 'note'], value: note },
+    ];
+    if (plan.output.scope === 'repository')
+        values.push({
+            path: [...target, 'fingerprint'],
+            value: coordinateFingerprint(plan.output.row),
+        });
+    return values;
+}
+export function validateEdited(deps, plan, text) {
+    const result = loadEnvironments(text, {
+        cliVersion: deps.workspace.cliVersion,
+        providers: deps.workspace.ctx.providers,
+        strict: true,
+        allowInvalid: true,
+    }, { workspace: plan.workspace });
+    if (!result.valid || result.problems.length)
+        throw invalid();
+    return result.doc;
+}
+export function assertSafeNote(text) {
+    if (scanBoundary({ text, policy: 'manifest' }).length)
+        throw new DevkitError('config', 'PROBE_RECORD_SENSITIVE', 'The probe note contains protected content and cannot be recorded', {
+            nextSteps: [
+                'Remove credentials, personal names and email addresses from the probe note, then run the probe again.',
+            ],
+        });
+}
+function inputRequired(repo) {
+    return new DevkitError('usage', 'PROBE_RECORD_INPUT_REQUIRED', 'Recording requires --probe, --env and --platform', {
+        nextSteps: [`fx where ${repo} --env <env> --platform <platform> --probe --record --dry-run`],
+    });
+}
+export function probeChangedError() {
+    return new DevkitError('conflict', 'PROBE_RECORD_CHANGED', 'Source documents or probe inputs changed; the result was not recorded', { nextSteps: ['Review the current source and run the probe again.'] });
+}
+function invalid() {
+    return new DevkitError('config', 'PROBE_RECORD_MANIFEST_INVALID', 'The source manifest must pass schema validation before recording', { nextSteps: ['fx manifest validate', 'Fix the reported problems in the source, then retry.'] });
+}
+function assertShared(origin) {
+    if (origin !== 'shared')
+        throw new DevkitError('usage', 'PROBE_RECORD_SCOPE_INVALID', 'Only shared repository coordinates can be recorded in the manifest', {
+            nextSteps: [
+                'fx repo list',
+                'Record a repository the shared manifest owns; locally added repositories keep their coordinates in personal configuration.',
+            ],
+        });
+}
+//# sourceMappingURL=plan.js.map

package/dist/application/probe-record/plan.js.map

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

package/dist/application/probe-record/types.js

@@ -0,0 +1,4 @@
+// Probe recording separates a conditional plan from the observed result and
+// carries exact source snapshots until its final guarded write.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/application/probe-record/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/application/probe-record/types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gEAAgE"}

package/dist/application/readiness/index.js

@@ -0,0 +1,207 @@
+// Judges a resolved target: coverage and access first, then the tool's own
+// state, then the setup steps that are still pending. A resolved target that is
+// not ready is a verdict with recovery guidance, never an error. Results are
+// remembered per tool, because one command judges many targets.
+import { DevkitError, handoffEnvelope } from '../../domain/errors.js';
+import { undeclaredPlatform } from '../../domain/obs/coordinate.js';
+import { environmentsOf, envNotFound } from '../env/names.js';
+import { buildPlan } from '../login/collect.js';
+import { handoffStep, loginCommand } from '../login/handoff.js';
+import { gaveNoAnswer, Verifier } from '../login/verify.js';
+import { isTrustRequired } from '../safety/trust.js';
+import { ToolCheck } from '../tool/check.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+import { resolveTarget, targetOfBinding } from './resolve.js';
+import { untrusted, versionUnknown } from './verdicts.js';
+export class Readiness {
+    deps;
+    login;
+    toolStates = new Map();
+    pending = new Map();
+    constructor(deps, login) {
+        this.deps = deps;
+        this.login = login;
+    }
+    command(...args) {
+        return workspaceCommand(this.deps, ...args);
+    }
+    resolve(name, env) {
+        return resolveTarget(this.deps, this.login, name, env);
+    }
+    targetOf(binding) {
+        return targetOfBinding(this.deps, this.login, binding);
+    }
+    async judge(target, env) {
+        const coverage = this.coverage(target, env);
+        if (coverage !== undefined)
+            return this.verdict('not_covered', {
+                alternatives: [coverage, this.command('doctor')],
+            });
+        if (env !== null && !this.inScope(env))
+            return this.verdict('no_access', {
+                alternatives: [this.command('env', 'pick', env), this.command('doctor')],
+            });
+        if (target.tool === null)
+            return this.verdict('ready');
+        const state = await this.toolState(target.tool);
+        if (state === 'untrusted')
+            return untrusted(this.deps, this.login, target.tool.name);
+        if (state === 'unknown')
+            return versionUnknown(this.deps, target.tool);
+        if (state !== 'ok')
+            return this.verdict({ outdated: 'outdated_tool', disabled: 'disabled_tool', missing: 'missing_tool' }[state], {
+                handoff: handoffEnvelope({
+                    summary: `${target.tool.name} is ${state}`,
+                    userSteps: [],
+                    command: workspaceCommand(this.deps, 'tool', { disabled: 'show', outdated: 'update', missing: 'install' }[state], target.tool.name),
+                }),
+            });
+        const setupEnv = target.binding !== null && 'platform' in target.binding ? env : null;
+        return this.setupVerdict(target.tool.name, setupEnv);
+    }
+    verdict(status, extra = {}) {
+        return { status, handoff: null, alternatives: [this.command('doctor')], ...extra };
+    }
+    // A step whose check failed is handed over, and outranks a check that could not finish:
+    // nobody is handed a sign-in for the latter, checking again is its only step.
+    async setupVerdict(tool, env) {
+        const pending = await this.pendingSteps(tool, env);
+        if (pending === 'untrusted')
+            return untrusted(this.deps, this.login, tool);
+        if ('problems' in pending)
+            return this.verdict('unconfigured', {
+                handoff: handoffEnvelope({
+                    summary: `Setup cannot be verified: ${pending.problems.join('; ')}`,
+                    userSteps: [],
+                    command: this.command('manifest', 'providers'),
+                    alternatives: [this.command('manifest', 'validate', '--strict')],
+                }),
+            });
+        const { steps, unfinished } = pending;
+        const unknown = unfinished.length === 0 ? {} : { unfinished };
+        if (steps.length > 0)
+            return this.verdict('unconfigured', {
+                ...unknown,
+                handoff: handoffEnvelope({
+                    summary: `${steps.length} setup step${steps.length === 1 ? '' : 's'} not done for ${tool}`,
+                    userSteps: steps.map((item) => handoffStep(item.step, item.pending)),
+                    command: loginCommand(steps.map((item) => item.step), this.deps),
+                }),
+            });
+        if (unfinished.length === 0)
+            return this.verdict('ready');
+        return this.verdict('unknown', {
+            ...unknown,
+            handoff: handoffEnvelope({
+                summary: `Could not finish checking ${unfinished.map((check) => check.id).join(', ')}`,
+                userSteps: [],
+                command: this.command('doctor', '--tool', tool, ...(env === null ? [] : ['--env', env])),
+            }),
+        });
+    }
+    // Why the environment does not cover the target, when it does not.
+    coverage(target, env) {
+        if (env === null || target.binding === null || !('platform' in target.binding))
+            return undefined;
+        const environments = environmentsOf(this.deps.ctx, this.deps.commandShell);
+        const spec = environments.envs[env];
+        if (spec === undefined)
+            throw envNotFound(this.deps, env, Object.keys(environments.envs));
+        const { platform } = target.binding;
+        return spec.platforms?.[platform] === undefined ? undeclaredPlatform(env, platform) : undefined;
+    }
+    inScope(env) {
+        const scope = this.deps.ctx.local.scope?.envs;
+        return scope === undefined || scope.includes(env);
+    }
+    async toolState(tool) {
+        const cached = this.toolStates.get(tool.name);
+        if (cached !== undefined)
+            return cached;
+        const state = this.inspectToolState(tool);
+        this.toolStates.set(tool.name, state);
+        return state;
+    }
+    async inspectToolState(tool) {
+        try {
+            const [status] = await new ToolCheck({
+                run: this.deps.processRun,
+                which: this.deps.processWhich,
+            }).execute({
+                tools: [tool],
+                trust: {
+                    gate: this.login.trust.gate,
+                    workspace: this.deps.ctx.name,
+                    commandShell: this.deps.commandShell,
+                    yes: this.login.trust.yes,
+                    posture: this.login.trust.posture,
+                },
+            });
+            if (status === undefined)
+                return 'unknown';
+            return status.state;
+        }
+        catch (err) {
+            if (isTrustRequired(err))
+                return 'untrusted';
+            if (err instanceof DevkitError)
+                return 'unknown';
+            throw err;
+        }
+    }
+    async pendingSteps(tool, env) {
+        const key = `${tool}\0${env ?? ''}`;
+        const cached = this.pending.get(key);
+        if (cached !== undefined)
+            return cached;
+        const steps = this.inspectPendingSteps(tool, env);
+        this.pending.set(key, steps);
+        return steps;
+    }
+    async inspectPendingSteps(tool, env) {
+        const plan = buildPlan(this.deps, this.login, {
+            tools: [tool],
+            envs: env === null ? undefined : [env],
+            scopeEnvs: this.deps.ctx.local.scope?.envs,
+        });
+        const problems = plan.problems.filter((p) => p.step.startsWith(`${tool}.`));
+        if (problems.length > 0)
+            return { problems: problems.map((p) => p.detail) };
+        const verifier = new Verifier(this.deps, this.login);
+        const steps = [];
+        const unfinished = [];
+        // A step waiting on an unfinished check is as unknown as that check is, whatever
+        // else it waits on.
+        const undone = new Set();
+        const unknown = new Set();
+        for (const step of plan.steps) {
+            if (step.requires.some((id) => unknown.has(id))) {
+                unknown.add(step.id);
+                continue;
+            }
+            const blockedBy = step.requires.find((id) => undone.has(id));
+            if (blockedBy !== undefined) {
+                steps.push({ step, pending: { blockedBy } });
+                undone.add(step.id);
+                continue;
+            }
+            try {
+                const failed = await verifier.verify(step);
+                if (failed.ok)
+                    continue;
+                steps.push({ step, pending: { failed } });
+                undone.add(step.id);
+            }
+            catch (err) {
+                if (isTrustRequired(err))
+                    return 'untrusted';
+                if (!(err instanceof DevkitError) || !gaveNoAnswer(err.code))
+                    throw err;
+                unfinished.push({ id: step.id, code: err.code, message: err.message });
+                unknown.add(step.id);
+            }
+        }
+        return { steps, unfinished };
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/application/readiness/resolve.js

@@ -0,0 +1,147 @@
+// Which capability or tool a name refers to, and which binding serves it. A name
+// that matches nothing, or an environment-scoped capability with more than one
+// binding, is a usage error: the question itself has no single answer.
+import { CAPABILITY_INFO, bindableCapabilities, knownCapability, } from '../../domain/capability.js';
+import { DevkitError } from '../../domain/errors.js';
+import { nearest } from '../../domain/fuzzy.js';
+import { servesCapability, } from '../../domain/manifest/providers.js';
+import { environmentsOf, envNotFound } from '../env/names.js';
+import { toolchainOf } from '../tool/toolchain.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+export function resolveTarget(deps, login, name, env) {
+    const tools = toolchainOf(deps.ctx).tools;
+    const named = knownCapability(name);
+    if (named !== null) {
+        const capability = named;
+        const binding = bindingFor(deps, capability, env);
+        if (binding === null)
+            throw capabilityUnbound(deps, capability, env);
+        const served = toolOf(deps, login, binding);
+        if (served.kind === 'unbound')
+            throw capabilityUnbound(deps, capability, env);
+        if (served.kind === 'unserved')
+            throw providerUnknown(deps, capability, served.provider);
+        if (served.kind === 'undeclared')
+            throw toolUndeclared(deps, capability, served);
+        return { capability, tool: served.kind === 'tool' ? served.tool : null, binding };
+    }
+    const tool = tools.find((t) => t.name === name);
+    if (tool !== undefined)
+        return { capability: null, tool, binding: bindingDriving(deps, login, tool.name, env) };
+    const capabilities = bindableCapabilities();
+    const suggestion = nearest(name, [...capabilities, ...tools.map((t) => t.name)]);
+    throw new DevkitError('not_found', 'CAN_UNKNOWN', `"${name}" is neither a capability nor a tool`, {
+        hint: suggestion === undefined
+            ? `Capabilities: ${capabilities.join(', ')}.`
+            : `Did you mean "${suggestion}"?`,
+        nextSteps: [workspaceCommand(deps, 'can'), workspaceCommand(deps, 'tool', 'list')],
+    });
+}
+export function targetOfBinding(deps, login, binding) {
+    const served = toolOf(deps, login, binding);
+    if (served.kind !== 'tool' && served.kind !== 'toolless')
+        return null;
+    return {
+        capability: knownCapability(binding.capability),
+        tool: served.kind === 'tool' ? served.tool : null,
+        binding,
+    };
+}
+// A family provider is named after its tool; a registered descriptor may say otherwise. A
+// provider fx does not serve can still be one the manifest defines itself, but only where
+// the team declared the tool it is named after — otherwise the id names nothing.
+function toolOf(deps, login, binding) {
+    const provider = binding.provider;
+    if (provider === null)
+        return { kind: 'unbound' };
+    const tools = toolchainOf(deps.ctx).tools;
+    const descriptor = login.describeProvider(provider);
+    if (!servesCapability(descriptor, binding.capability)) {
+        const own = tools.find((t) => t.name === provider && t.declared);
+        return own === undefined ? { kind: 'unserved', provider } : { kind: 'tool', tool: own };
+    }
+    if (descriptor.tools.length === 0)
+        return { kind: 'toolless' };
+    const name = descriptor.tools[0];
+    const tool = tools.find((t) => t.name === name);
+    return tool === undefined ? { kind: 'undeclared', provider, name } : { kind: 'tool', tool };
+}
+function providerUnknown(deps, capability, provider) {
+    const candidates = deps.ctx.providers
+        .filter((candidate) => candidate.capability === capability)
+        .map((candidate) => candidate.id);
+    const suggestion = nearest(provider, candidates);
+    return new DevkitError('config', 'PROVIDER_UNKNOWN', `"${provider}" is not a ${capability} provider this fx knows`, {
+        hint: suggestion === undefined
+            ? `Available: ${candidates.join(', ') || 'none'}. A provider fx does not implement needs a tool of its own name in the manifest tools document.`
+            : `Did you mean "${suggestion}"?`,
+        nextSteps: [workspaceCommand(deps, 'manifest', 'providers')],
+    });
+}
+function capabilityUnbound(deps, capability, env) {
+    return new DevkitError('config', 'CAPABILITY_UNBOUND', `No provider serves ${capability}${env === undefined ? '' : ` in ${env}`}`, {
+        hint: CAPABILITY_INFO[capability].desc,
+        nextSteps: [workspaceCommand(deps, 'manifest', 'providers')],
+    });
+}
+function toolUndeclared(deps, capability, served) {
+    return new DevkitError('config', 'TOOL_UNDECLARED', `${served.name} is not declared in the toolchain`, {
+        hint: `The provider bound to ${capability} is ${served.provider}, and neither the bundled catalog nor the manifest tools document describes ${served.name}.`,
+        nextSteps: [
+            `Describe ${served.name} in the manifest tools document.`,
+            workspaceCommand(deps, 'manifest', 'schema', '--kind', 'tools'),
+            workspaceCommand(deps, 'tool', 'list', '--catalog'),
+        ],
+    });
+}
+// An environment-scoped capability lives on a platform instance; which
+// one is the environment's business, so it needs --env.
+function bindingFor(deps, capability, env) {
+    if (CAPABILITY_INFO[capability].scope !== 'environment')
+        return deps.ctx.bindings.find((b) => b.capability === capability) ?? null;
+    if (env === undefined) {
+        throw new DevkitError('usage', 'ENV_REQUIRED', `${capability} depends on the environment; pass --env`, {
+            hint: 'Environments are listed by `fx env list`.',
+            nextSteps: [
+                workspaceCommand(deps, 'env', 'list'),
+                workspaceCommand(deps, 'can', capability, '--env', '<env>'),
+            ],
+        });
+    }
+    return selectBinding(deps, deps.ctx.platforms.filter((b) => b.capability === capability), env, capability);
+}
+function bindingDriving(deps, login, tool, env) {
+    const drives = (b) => {
+        if (b.provider === null)
+            return false;
+        const descriptor = login.describeProvider(b.provider);
+        return descriptor === undefined ? b.provider === tool : descriptor.tools.includes(tool);
+    };
+    return selectBinding(deps, [...deps.ctx.bindings, ...deps.ctx.platforms].filter(drives), env, tool);
+}
+function selectBinding(deps, candidates, env, name) {
+    let scoped = candidates;
+    if (env !== undefined && candidates.some((binding) => 'platform' in binding)) {
+        const environments = environmentsOf(deps.ctx, deps.commandShell);
+        const spec = environments.envs[env];
+        if (spec === undefined)
+            throw envNotFound(deps, env, Object.keys(environments.envs));
+        const covered = candidates.filter((b) => !('platform' in b) || spec.platforms?.[b.platform] !== undefined);
+        // Retain a single uncovered binding so coverage remains a negative verdict.
+        if (covered.length > 0)
+            scoped = covered;
+    }
+    if (scoped.length > 1) {
+        const names = scoped.map((b) => ('platform' in b ? b.platform : b.capability)).sort();
+        throw new DevkitError('usage', 'CAN_AMBIGUOUS', `${name} matches multiple bindings: ${names.join(', ')}`, {
+            hint: 'Choose a capability and environment with one binding; use where --platform to inspect a specific platform.',
+            nextSteps: [
+                workspaceCommand(deps, 'manifest', 'providers'),
+                workspaceCommand(deps, 'env', 'list'),
+                'fx where --help',
+            ],
+        });
+    }
+    return scoped[0] ?? null;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/application/readiness/resolve.js.map

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

package/dist/application/readiness/types.js

@@ -0,0 +1,4 @@
+// What `can` was asked about and what it concluded. A verdict is never an error:
+// an unready target still answers, with the steps that would make it ready.
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/application/readiness/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,4EAA4E"}

package/dist/application/readiness/verdicts.js

@@ -0,0 +1,42 @@
+// The two verdicts that are mostly guidance: a tool whose version check did not
+// answer, and a tool whose command has not been approved. Both say "unknown",
+// and each names the one thing a person can do about it.
+import { handoffEnvelope } from '../../domain/errors.js';
+import { shellLine } from '../../domain/shell.js';
+import { commandTrustHandoff } from '../safety/trust.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+export function versionUnknown(deps, tool) {
+    const command = workspaceCommand(deps, 'doctor', '--tool', tool.name);
+    const inspect = workspaceCommand(deps, 'tool', 'show', tool.name);
+    const probe = shellLine([tool.binary, ...tool.versionArgs], deps.commandShell);
+    return {
+        status: 'unknown',
+        handoff: handoffEnvelope({
+            summary: `${tool.name} could not pass its version check`,
+            command,
+            userSteps: [
+                {
+                    id: `${tool.name}.version`,
+                    kind: 'manual',
+                    title: 'Diagnose the installed tool before changing authentication',
+                    instructions: `Inspect the executable on PATH and the result of ${probe}. Check startup errors, exit status and version output; this is not evidence of an authentication failure.`,
+                },
+            ],
+        }),
+        alternatives: [inspect, workspaceCommand(deps, 'doctor')],
+    };
+}
+export function untrusted(deps, login, tool) {
+    const handoff = commandTrustHandoff({
+        tool,
+        posture: login.trust.posture,
+        workspace: deps.ctx.name,
+        commandShell: deps.commandShell,
+    });
+    return {
+        status: 'unknown',
+        handoff,
+        alternatives: handoff.alternatives ?? [workspaceCommand(deps, 'doctor')],
+    };
+}
+//# sourceMappingURL=verdicts.js.map

package/dist/application/readiness/verdicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdicts.js","sourceRoot":"","sources":["../../../src/application/readiness/verdicts.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,yDAAyD;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGlD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,MAAM,UAAU,cAAc,CAAC,IAAmB,EAAE,IAAkB;IACpE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC/E,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,eAAe,CAAC;YACvB,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,mCAAmC;YACxD,OAAO;YACP,SAAS,EAAE;gBACT;oBACE,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,UAAU;oBAC1B,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,4DAA4D;oBACnE,YAAY,EAAE,oDAAoD,KAAK,4GAA4G;iBACpL;aACF;SACF,CAAC;QACF,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAmB,EAAE,KAAgB,EAAE,IAAY;IAC3E,MAAM,OAAO,GAAG,mBAAmB,CAAC;QAClC,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO;QAC5B,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;QACxB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KACzE,CAAC;AACJ,CAAC"}