@angelmsger/fx 0.0.0-stage → 0.11.0

package/dist/application/doctor/login.js

@@ -0,0 +1,106 @@
+// The check is the truth: a step a person acknowledged still fails when its
+// check does, and the finding says both.
+import { DevkitError, handoffEnvelope } from '../../domain/errors.js';
+import { buildPlan } from '../login/collect.js';
+import { handoffStep, loginCommand } from '../login/handoff.js';
+import { Verifier } from '../login/verify.js';
+import { noAnswerAction, verifyAction } from '../preparation.js';
+import { commandTrustHandoff, isTrustRequired } from '../safety/trust.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+import { finding } from './types.js';
+export async function checkLogin(deps, login, options, checks) {
+    const plan = buildPlan(deps, login, { ...options, scopeEnvs: deps.ctx.local.scope?.envs });
+    const verifier = new Verifier(deps, login);
+    const acknowledged = deps.ctx.local.setup ?? {};
+    const findings = plan.problems.map((p) => finding('login', p.step, 'warn', `${p.detail} (${p.reason})`, {
+        fix: workspaceCommand(deps, 'login', '--list'),
+        coverage: 'incomplete',
+    }));
+    const pending = new Set();
+    // Checks that gave no answer, and the steps waiting on them: nobody is handed either.
+    const unanswered = new Set();
+    const check = async (step) => {
+        const fix = loginCommand([step], deps);
+        const blocker = blockerOf(step, unanswered) ?? blockerOf(step, pending);
+        if (blocker) {
+            if (unanswered.has(blocker))
+                unanswered.add(step.id);
+            return blockedFinding(step, blocker, deps, unanswered.has(step.id));
+        }
+        try {
+            const verdict = await verifier.verify(step, options.dryRun === undefined ? {} : { dryRun: options.dryRun });
+            if (verdict.ok)
+                return finding('login', step.id, 'ok', verdict.detail);
+            const when = acknowledged[step.id]?.acknowledged;
+            const message = when === undefined
+                ? verdict.detail
+                : `acknowledged on ${when} but the check fails: ${verdict.detail}`;
+            const required = step.required || options.requiredTools?.has(step.tool);
+            return finding('login', step.id, when !== undefined || required ? 'fail' : 'warn', message, {
+                fix,
+                handoff: handoffEnvelope({
+                    summary: step.title,
+                    userSteps: [handoffStep(step, { failed: verdict })],
+                    command: fix,
+                }),
+                ...(verdict.actions ? { actions: verdict.actions } : {}),
+            });
+        }
+        catch (err) {
+            if (!(err instanceof DevkitError))
+                throw err;
+            if (isTrustRequired(err))
+                return trustFinding(step, login, err, deps);
+            unanswered.add(step.id);
+            return unfinishedFinding(step, err, deps);
+        }
+    };
+    checks.plan(plan.steps.length);
+    for (const step of plan.steps) {
+        const found = await checks.unit(step.id, () => check(step));
+        // Whatever keeps a step from passing also withholds the steps that require it.
+        if (found.level !== 'ok')
+            pending.add(step.id);
+        findings.push(found);
+    }
+    return findings;
+}
+// The first prerequisite of a step found in a set. An unanswered one is looked for
+// first: it decides what becomes of the step even beside one that failed outright.
+function blockerOf(step, among) {
+    return step.requires.find((id) => among.has(id));
+}
+function trustFinding(step, login, error, deps) {
+    const handoff = commandTrustHandoff({
+        tool: step.tool,
+        posture: login.trust.posture,
+        workspace: deps.ctx.name,
+        commandShell: deps.commandShell,
+    });
+    return finding('login', step.id, 'warn', error.message, {
+        coverage: 'incomplete',
+        fix: handoff.command,
+        handoff,
+        actions: [verifyAction(deps, step.tool)],
+    });
+}
+// A check that could not run or finish says nothing about sign-in: its tool is the step
+// when that did not start, and checking again is otherwise.
+function unfinishedFinding(step, error, deps) {
+    const recovery = error.code === 'TOOL_MISSING' ? ['tool', 'install'] : ['doctor', '--tool'];
+    return finding('login', step.id, 'warn', error.message, {
+        fix: workspaceCommand(deps, ...recovery, step.tool),
+        coverage: 'incomplete',
+        actions: [noAnswerAction(deps, step, error.code)],
+    });
+}
+// A step behind a check that gave no answer waits for that check, not for a person.
+function blockedFinding(step, blocker, deps, unanswered) {
+    return finding('login', step.id, 'warn', `Blocked by ${blocker}`, {
+        coverage: 'incomplete',
+        ...(unanswered
+            ? { fix: workspaceCommand(deps, 'doctor', '--tool', step.tool), actions: [] }
+            : { fix: loginCommand([step], deps) }),
+    });
+}
+//# sourceMappingURL=login.js.map

package/dist/application/doctor/login.js.map

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

package/dist/application/doctor/manifest.js

@@ -0,0 +1,104 @@
+// Revalidate declarations tolerated during discovery and check generated guides.
+// Missing, stale or foreign required guides block preparation even at warning severity.
+import { DevkitError } from '../../domain/errors.js';
+import { codeHostBinding } from '../../domain/manifest/providers.js';
+import { DeriveDocs } from '../docs/derive.js';
+import { LintManifest } from '../manifest/lint.js';
+import { ValidateManifest } from '../manifest/validate.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+import { NOT_CHECKED } from './self.js';
+import { finding } from './types.js';
+export async function checkManifest(deps, login, bundledTools, upstream) {
+    const input = {
+        dir: deps.ctx.manifest.dir,
+        cliVersion: deps.cliVersion,
+        providers: deps.ctx.providers,
+    };
+    const report = await new ValidateManifest(deps.fs, bundledTools).execute({
+        ...input,
+        strict: false,
+    });
+    const findings = codeHostCoverage(deps);
+    for (const doc of report.documents) {
+        for (const p of doc.problems)
+            findings.push(finding('manifest', `${doc.kind}:${p.path}`, 'fail', p.message, {
+                fix: workspaceCommand(deps, 'manifest', 'validate'),
+            }));
+        for (const d of doc.dropped)
+            findings.push(finding('manifest', `${doc.kind}:${d.name}`, 'fail', `entry skipped: ${d.reason}`, {
+                fix: workspaceCommand(deps, 'manifest', 'validate'),
+            }));
+    }
+    for (const binding of deps.ctx.platforms) {
+        if (binding.source === 'unbound')
+            findings.push(finding('manifest', `environments:platforms.${binding.platform}`, 'fail', 'no provider serves this platform', {
+                fix: workspaceCommand(deps, 'manifest', 'providers'),
+            }));
+    }
+    for (const lint of await new LintManifest(deps.fs, bundledTools, login.describeProvider).execute(input))
+        findings.push(finding('manifest', `${lint.kind}:${lint.path}`, 'warn', `${lint.code}: ${lint.message}`, {
+            fix: workspaceCommand(deps, 'manifest', 'lint'),
+        }));
+    const docs = await checkDocs(deps, login);
+    if (findings.length === 0 && docs.level === 'ok')
+        findings.push(finding('manifest', 'all', 'ok', 'valid, nothing to tidy'));
+    findings.push(docs, await checkUpstream(deps, upstream));
+    return findings;
+}
+async function checkUpstream(deps, check) {
+    if (!check.enabled)
+        return finding('manifest', 'upstream', 'ok', NOT_CHECKED, { coverage: 'not_applicable' });
+    const v = await check.manifest.execute({
+        workspace: deps.ctx.name,
+        sourceDir: deps.ctx.manifestDir,
+        force: true,
+    });
+    if (v.source === 'skipped')
+        return finding('manifest', 'upstream', 'ok', 'the source is not a repository; nothing to check', { coverage: 'not_applicable' });
+    if (v.error !== undefined)
+        return finding('manifest', 'upstream', 'warn', `could not reach upstream: ${v.error}`, {
+            coverage: 'incomplete',
+        });
+    if (v.behind)
+        return finding('manifest', 'upstream', 'warn', 'new commits upstream since the last fx sync', {
+            fix: workspaceCommand(deps, 'sync'),
+        });
+    return finding('manifest', 'upstream', 'ok', 'up to date with upstream');
+}
+async function checkDocs(deps, login) {
+    try {
+        const out = await new DeriveDocs(deps, login).execute({
+            check: true,
+            dryRun: true,
+            posture: { readOnly: true, source: 'default' },
+        });
+        const foreign = out.files.filter((f) => f.action === 'foreign').map((f) => f.path);
+        if (foreign.length > 0)
+            return finding('manifest', 'docs', 'warn', `${foreign.join(', ')} not written by fx`, {
+                required: true,
+                fix: `Move the file aside, then ${workspaceCommand(deps, 'sync', '--only', 'docs')}`,
+            });
+        return finding('manifest', 'docs', 'ok', 'the root AGENTS.md matches the manifest');
+    }
+    catch (err) {
+        if (err instanceof DevkitError && err.code === 'DOCS_REGIONS_INVALID')
+            return finding('manifest', 'docs', 'fail', err.message, {
+                required: true,
+                fix: err.nextSteps[0],
+            });
+        if (!(err instanceof DevkitError) || err.code !== 'DOCS_STALE')
+            throw err;
+        return finding('manifest', 'docs', 'warn', err.message, {
+            required: true,
+            fix: workspaceCommand(deps, 'sync', '--only', 'docs'),
+        });
+    }
+}
+function codeHostCoverage(deps) {
+    if (codeHostBinding(deps.ctx.bindings).provider !== null)
+        return [];
+    return [
+        finding('manifest', 'provider:code-host', 'warn', 'No code-host provider is declared. Git synchronization is available; hosted API readiness is not covered.', { coverage: 'not_applicable', fix: 'fx manifest providers' }),
+    ];
+}
+//# sourceMappingURL=manifest.js.map

package/dist/application/doctor/manifest.js.map

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

package/dist/application/doctor/repos.js

@@ -0,0 +1,36 @@
+// A checkout that is not there or points elsewhere is broken; one with work
+// in progress is merely busy.
+import { Status } from '../status.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+import { finding } from './types.js';
+export async function checkRepos(deps) {
+    const rows = await new Status(deps).execute({ fetch: false, dirtyOnly: false });
+    return rows.map((row) => {
+        if (!row.exists)
+            return finding('repos', row.name, 'fail', 'not cloned', {
+                fix: workspaceCommand(deps, 'sync'),
+            });
+        if (row.branch === null && !row.remotes_ok)
+            return finding('repos', row.name, 'fail', row.note ?? 'not a git checkout', {
+                fix: workspaceCommand(deps, 'repo', 'show', row.name),
+            });
+        if (!row.remotes_ok)
+            return finding('repos', row.name, 'fail', row.note ?? 'upstream remote differs', {
+                fix: workspaceCommand(deps, 'repo', 'show', row.name),
+            });
+        const busy = [];
+        if (row.uncommitted)
+            busy.push('uncommitted changes');
+        if (row.ahead > 0 && row.behind > 0)
+            busy.push(`diverged (${row.ahead} ahead, ${row.behind} behind)`);
+        if (row.branch !== null && row.tracked_branch !== null && row.branch !== row.tracked_branch)
+            busy.push(`on ${row.branch}, tracking ${row.tracked_branch}`);
+        return busy.length === 0
+            ? finding('repos', row.name, 'ok', 'clean, on the tracked branch')
+            : finding('repos', row.name, 'warn', busy.join('; '), {
+                required: row.branch === row.tracked_branch && (row.dirty || (row.ahead > 0 && row.behind > 0)),
+                fix: workspaceCommand(deps, 'repo', 'show', row.name),
+            });
+    });
+}
+//# sourceMappingURL=repos.js.map

package/dist/application/doctor/repos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.js","sourceRoot":"","sources":["../../../src/application/doctor/repos.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8BAA8B;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAmB;IAClD,MAAM,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAChF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,IAAI,CAAC,GAAG,CAAC,MAAM;YACb,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE;gBACtD,GAAG,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC;aACpC,CAAC,CAAC;QACL,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU;YACxC,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,oBAAoB,EAAE;gBAC1E,GAAG,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;aACtD,CAAC,CAAC;QACL,IAAI,CAAC,GAAG,CAAC,UAAU;YACjB,OAAO,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,yBAAyB,EAAE;gBAC/E,GAAG,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;aACtD,CAAC,CAAC;QACL,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,WAAW;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACtD,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,KAAK,WAAW,GAAG,CAAC,MAAM,UAAU,CAAC,CAAC;QACnE,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,cAAc,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,cAAc;YACzF,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,cAAc,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC;YACtB,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,8BAA8B,CAAC;YAClE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAClD,QAAQ,EACN,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,cAAc,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACvF,GAAG,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;aACtD,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/application/doctor/root.js

@@ -0,0 +1,25 @@
+// A stray root entry is clutter, not a broken workspace: it warns and never
+// blocks preparation. Only an unregistered checkout has a command that settles it;
+// where anything else goes is the owner's decision.
+import { WORKBENCH_DIR } from '../../domain/workspace/root-entries.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+import { strayRootEntries } from '../workspace/root-entries.js';
+import { finding } from './types.js';
+const MESSAGE = {
+    checkout: 'checkout not registered with this workspace',
+    directory: `directory outside ${WORKBENCH_DIR}`,
+    file: `file outside ${WORKBENCH_DIR}`,
+    link: `link outside ${WORKBENCH_DIR}`,
+};
+export async function checkRoot(deps, inventory) {
+    const strays = await strayRootEntries(deps, inventory);
+    if (strays.length === 0)
+        return [finding('root', 'entries', 'ok', 'every root entry is accounted for')];
+    return strays.map((entry) => finding('root', entry.name, 'warn', MESSAGE[entry.kind], {
+        required: false,
+        ...(entry.kind === 'checkout'
+            ? { fix: workspaceCommand(deps, 'repo', 'add', entry.name) }
+            : {}),
+    }));
+}
+//# sourceMappingURL=root.js.map

package/dist/application/doctor/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../src/application/doctor/root.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,mFAAmF;AACnF,oDAAoD;AAEpD,OAAO,EAAE,aAAa,EAAsB,MAAM,wCAAwC,CAAC;AAE3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAsB,MAAM,8BAA8B,CAAC;AAEpF,OAAO,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AAEnD,MAAM,OAAO,GAA4C;IACvD,QAAQ,EAAE,6CAA6C;IACvD,SAAS,EAAE,qBAAqB,aAAa,EAAE;IAC/C,IAAI,EAAE,gBAAgB,aAAa,EAAE;IACrC,IAAI,EAAE,gBAAgB,aAAa,EAAE;CACtC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB,EAAE,SAAwB;IAC3E,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QACrB,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,mCAAmC,CAAC,CAAC,CAAC;IACjF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1B,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QACvD,QAAQ,EAAE,KAAK;QACf,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU;YAC3B,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YAC5D,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/application/doctor/self.js

@@ -0,0 +1,41 @@
+// Doctor asks the registry now, not the cache: it is the one place a person
+// comes to learn how things stand at this moment.
+import { handoffEnvelope } from '../../domain/errors.js';
+import { REGISTRY_HANDOFF } from '../self/registry.js';
+import { finding } from './types.js';
+export const NOT_CHECKED = 'not checked (update_check is off)';
+export async function checkSelf(check) {
+    if (!check.enabled)
+        return [
+            finding('self', 'version', 'ok', `${check.self.current}; ${NOT_CHECKED}`, {
+                coverage: 'not_applicable',
+            }),
+        ];
+    const v = await check.fx.execute({ ...check.self, force: true });
+    if (v.registry === null)
+        return [
+            finding('self', 'version', 'warn', 'The distribution registry is not configured for update checks.', { handoff: handoffEnvelope(REGISTRY_HANDOFF), coverage: 'incomplete' }),
+        ];
+    if (v.source === 'skipped')
+        return [
+            finding('self', 'version', 'ok', `${v.current} is a development build; not checked`, {
+                coverage: 'not_applicable',
+            }),
+        ];
+    if (v.error !== undefined)
+        return [
+            finding('self', 'version', 'warn', `could not query the configured registry: ${v.error}`, {
+                coverage: 'incomplete',
+            }),
+        ];
+    if (v.behind)
+        return [
+            finding('self', 'version', 'warn', `${v.current} is behind ${v.latest ?? '?'}`, {
+                fix: 'fx self update --yes',
+            }),
+        ];
+    return [
+        finding('self', 'version', 'ok', `${v.current} is the latest on the configured registry`),
+    ];
+}
+//# sourceMappingURL=self.js.map

package/dist/application/doctor/self.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"self.js","sourceRoot":"","sources":["../../../src/application/doctor/self.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,kDAAkD;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AAEnD,MAAM,CAAC,MAAM,WAAW,GAAG,mCAAmC,CAAC;AAQ/D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAgB;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO;QAChB,OAAO;YACL,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,WAAW,EAAE,EAAE;gBACxE,QAAQ,EAAE,gBAAgB;aAC3B,CAAC;SACH,CAAC;IACJ,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI;QACrB,OAAO;YACL,OAAO,CACL,MAAM,EACN,SAAS,EACT,MAAM,EACN,gEAAgE,EAChE,EAAE,OAAO,EAAE,eAAe,CAAC,gBAAgB,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CACvE;SACF,CAAC;IACJ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;QACxB,OAAO;YACL,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,sCAAsC,EAAE;gBACnF,QAAQ,EAAE,gBAAgB;aAC3B,CAAC;SACH,CAAC;IACJ,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;QACvB,OAAO;YACL,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,4CAA4C,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxF,QAAQ,EAAE,YAAY;aACvB,CAAC;SACH,CAAC;IACJ,IAAI,CAAC,CAAC,MAAM;QACV,OAAO;YACL,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,EAAE;gBAC9E,GAAG,EAAE,sBAAsB;aAC5B,CAAC;SACH,CAAC;IACJ,OAAO;QACL,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,2CAA2C,CAAC;KAC1F,CAAC;AACJ,CAAC"}

package/dist/application/doctor/tools.js

@@ -0,0 +1,105 @@
+// A required tool that is missing or too old breaks the workspace; an
+// optional one only narrows what can be done.
+import { DevkitError } from '../../domain/errors.js';
+import { commandTrustHandoff, isTrustRequired } from '../safety/trust.js';
+import { toolChecks } from '../sync/checks.js';
+import { ToolCheck } from '../tool/check.js';
+import { workspaceCommand } from '../workspace/guidance.js';
+import { finding } from './types.js';
+export async function checkTools(deps, options, checks) {
+    const check = new ToolCheck({ run: deps.processRun, which: deps.processWhich });
+    const tools = options.covered;
+    const findings = [];
+    const trust = { ...options.trust, workspace: deps.ctx.name, commandShell: deps.commandShell };
+    checks.plan(tools.length);
+    for (const tool of tools) {
+        try {
+            const [status] = await checks.unit(tool.name, () => check.execute({
+                tools: [{ ...tool, required: options.required.has(tool.name) }],
+                trust,
+            }));
+            if (status !== undefined)
+                findings.push({
+                    ...fromStatus(status, options.dependencies.has(tool.name), deps),
+                    required: options.required.has(tool.name),
+                    actions: toolChecks([{ ...status, preparation_required: options.required.has(tool.name) }], deps)[0].actions ?? [],
+                    evidence: {
+                        binary: status.binary,
+                        binary_path: status.binary_path ?? null,
+                        state: status.state,
+                        required: status.required,
+                        active_dependency: options.dependencies.has(tool.name),
+                        installed: status.installed,
+                        min_version: status.min_version,
+                    },
+                });
+        }
+        catch (err) {
+            if (!(err instanceof DevkitError))
+                throw err;
+            findings.push(toolCheckFailure(deps, options, tool.name, err));
+        }
+    }
+    return findings;
+}
+function toolCheckFailure(deps, options, name, error) {
+    const required = options.required.has(name);
+    if (!isTrustRequired(error))
+        return finding('tools', name, 'warn', error.message, {
+            coverage: 'incomplete',
+            required,
+            fix: workspaceCommand(deps, 'tool', 'show', name),
+        });
+    const handoff = commandTrustHandoff({
+        tool: name,
+        workspace: deps.ctx.name,
+        posture: options.trust.posture,
+        commandShell: deps.commandShell,
+    });
+    return finding('tools', name, 'warn', error.message, {
+        coverage: 'incomplete',
+        required,
+        fix: handoff.command,
+        handoff,
+        actions: [
+            {
+                id: `approve:${name}`,
+                description: `Review ${name}'s exact probe arguments, then approve the check`,
+                argv: ['fx', 'doctor', '--tool', name, '--workspace', deps.ctx.name, '--yes'],
+                cwd: deps.ctx.root,
+                actor: 'agent',
+                requires_approval: true,
+            },
+        ],
+    });
+}
+function fromStatus(status, activeDependency, deps) {
+    const { name } = status;
+    switch (status.state) {
+        case 'ok':
+            return finding('tools', name, 'ok', `${status.installed} installed`);
+        case 'disabled':
+            return status.required || activeDependency
+                ? finding('tools', name, status.required ? 'fail' : 'warn', status.required
+                    ? 'disabled by the manifest but required by the workspace'
+                    : 'disabled by the manifest but used by an active provider', {
+                    coverage: 'incomplete',
+                    fix: workspaceCommand(deps, 'tool', 'show', name),
+                })
+                : finding('tools', name, 'ok', 'disabled by the manifest; not checked', {
+                    coverage: 'not_applicable',
+                });
+        case 'missing':
+            return finding('tools', name, status.required ? 'fail' : 'warn', 'not installed', {
+                fix: workspaceCommand(deps, 'tool', 'install', name),
+            });
+        case 'outdated':
+            return finding('tools', name, status.required ? 'fail' : 'warn', `${status.installed} installed, ${status.min_version} required`, { fix: workspaceCommand(deps, 'tool', 'update', name) });
+        case 'unknown':
+            return finding('tools', name, 'warn', 'installed but its version could not be read', {
+                coverage: 'incomplete',
+                fix: workspaceCommand(deps, 'tool', 'show', name),
+            });
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/application/doctor/tools.js.map

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

package/dist/application/doctor/types.js

@@ -0,0 +1,15 @@
+// Doctor combines built-in and extension findings with preparation and repair results.
+import { finding as anyFinding } from '../../domain/report.js';
+export const GROUPS = ['repos', 'root', 'tools', 'login', 'agents', 'manifest', 'self'];
+export const DOCTOR_FINDING_COLUMNS = [
+    'group',
+    'level',
+    'coverage',
+    'id',
+    'message',
+    'fix',
+];
+export function finding(group, id, level, message, extra = {}) {
+    return anyFinding(group, id, level, message, extra);
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/application/doctor/types.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAKvF,OAAO,EAAE,OAAO,IAAI,UAAU,EAAqB,MAAM,wBAAwB,CAAC;AAGlF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AAgBjG,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO;IACP,OAAO;IACP,UAAU;IACV,IAAI;IACJ,SAAS;IACT,KAAK;CACG,CAAC;AAEX,MAAM,UAAU,OAAO,CACrB,KAAY,EACZ,EAAU,EACV,KAAuB,EACvB,OAAe,EACf,QAAsB,EAAE;IAExB,OAAO,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC"}

package/dist/application/env/list.js

@@ -0,0 +1,41 @@
+// The declared environments, each marked picked or not. An unset scope means all
+// of them, which is a notice rather than a column left to be misread.
+import { workspaceCommand } from '../workspace/guidance.js';
+import { scopeMode } from '../workspace/scope.js';
+import { environmentsOf } from './names.js';
+export const ENV_COLUMNS = [
+    'name',
+    'label',
+    'picked',
+    'selection_mode',
+    'platforms',
+    'confidence',
+    'note',
+];
+export class EnvList {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    execute() {
+        const doc = environmentsOf(this.deps.ctx, this.deps.commandShell);
+        const picked = this.deps.ctx.local.scope?.envs;
+        if (picked === undefined) {
+            this.deps.reporter.notice({
+                code: 'SCOPE_ENVS_UNSET',
+                message: 'All declared environments are selected, including future additions. Use env select to narrow the scope.',
+                nextSteps: [workspaceCommand(this.deps, 'env', 'select', '<env...>')],
+            });
+        }
+        return Object.entries(doc.envs).map(([name, env]) => ({
+            name,
+            label: env.label ?? null,
+            selection_mode: scopeMode(picked),
+            picked: picked === undefined || picked.includes(name),
+            platforms: Object.keys(env.platforms ?? {}),
+            confidence: env.confidence ?? null,
+            note: env.note ?? null,
+        }));
+    }
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/application/env/list.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,sEAAsE;AAGtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAkB,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAY5C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,OAAO;IACP,QAAQ;IACR,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,MAAM;CACE,CAAC;AAEX,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,OAAO;QACL,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;QAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxB,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EACL,yGAAyG;gBAC3G,SAAS,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;aACtE,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI;YACJ,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;YACxB,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC;YACjC,MAAM,EAAE,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrD,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;YAC3C,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/application/env/names.js

@@ -0,0 +1,19 @@
+// The environments a workspace declares, and the error for one it does not.
+import { DevkitError } from '../../domain/errors.js';
+import { workspaceCommand, workspaceItemNotFound, } from '../workspace/guidance.js';
+export function environmentsOf(ctx, commandShell) {
+    const doc = ctx.manifest.environments?.result.doc;
+    if (doc === undefined) {
+        throw new DevkitError('not_found', 'ENVIRONMENTS_MISSING', 'This workspace has no manifest/environments.yaml', {
+            hint: 'Environments and platforms are declared there; without it there is nothing to list.',
+            nextSteps: [
+                workspaceCommand({ ctx, commandShell }, 'manifest', 'explain', 'envs', '--kind', 'environments'),
+            ],
+        });
+    }
+    return doc;
+}
+export function envNotFound(context, name, known) {
+    return workspaceItemNotFound(context, { kind: 'env', name, known });
+}
+//# sourceMappingURL=names.js.map

package/dist/application/env/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../src/application/env/names.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,EACL,gBAAgB,EAChB,qBAAqB,GAEtB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,UAAU,cAAc,CAAC,GAAqB,EAAE,YAA4B;IAChF,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC;IAClD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,WAAW,CACnB,WAAW,EACX,sBAAsB,EACtB,kDAAkD,EAClD;YACE,IAAI,EAAE,qFAAqF;YAC3F,SAAS,EAAE;gBACT,gBAAgB,CACd,EAAE,GAAG,EAAE,YAAY,EAAE,EACrB,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,cAAc,CACf;aACF;SACF,CACF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,OAA0B,EAC1B,IAAY,EACZ,KAAwB;IAExB,OAAO,qBAAqB,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/application/env/scope.js

@@ -0,0 +1,16 @@
+// The environments half of the personal scope; the edit itself is editScope's.
+import { editScope, } from '../workspace/scope.js';
+import { envNotFound, environmentsOf } from './names.js';
+export function editEnvScope(deps, input, operation) {
+    const known = Object.keys(environmentsOf(deps.ctx, deps.commandShell).envs);
+    return editScope(deps, {
+        key: 'envs',
+        operation,
+        universe: known,
+        names: input.names,
+        dryRun: input.dryRun,
+        posture: input.posture,
+        notFound: (name) => envNotFound(deps, name, known),
+    });
+}
+//# sourceMappingURL=scope.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../src/application/env/scope.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAG/E,OAAO,EACL,SAAS,GAIV,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,UAAU,YAAY,CAC1B,IAAmB,EACnB,KAAqB,EACrB,SAAyB;IAEzB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,SAAS,CAAC,IAAI,EAAE;QACrB,GAAG,EAAE,MAAM;QACX,SAAS;QACT,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC;KACnD,CAAC,CAAC;AACL,CAAC"}

package/dist/application/env/show.js

@@ -0,0 +1,38 @@
+// One environment in full: every platform it declares, with the provider bound
+// to it, the variables that reach it and whatever the manifest said about how
+// well they are known.
+import { envNotFound, environmentsOf } from './names.js';
+export class EnvShow {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    execute(name) {
+        const doc = environmentsOf(this.deps.ctx, this.deps.commandShell);
+        const env = doc.envs[name];
+        if (env === undefined)
+            throw envNotFound(this.deps, name, Object.keys(doc.envs));
+        const picked = this.deps.ctx.local.scope?.envs;
+        return {
+            name,
+            label: env.label ?? null,
+            picked: picked === undefined || picked.includes(name),
+            confidence: env.confidence ?? null,
+            note: env.note ?? null,
+            platforms: Object.entries(env.platforms ?? {}).map(([platform, onEnv]) => {
+                const binding = this.deps.ctx.platforms.find((b) => b.platform === platform);
+                return {
+                    platform,
+                    provider: binding?.provider ?? null,
+                    capability: binding?.capability ?? 'unknown',
+                    // The environment's coordinate: its own variables over the platform's.
+                    vars: { ...doc.platforms[platform]?.vars, ...onEnv.vars },
+                    confidence: onEnv.confidence ?? null,
+                    note: onEnv.note ?? doc.platforms[platform]?.note ?? null,
+                    setup: onEnv.setup ?? null,
+                };
+            }),
+        };
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/application/env/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/application/env/show.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,uBAAuB;AAIvB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBzD,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,OAAO,CAAC,IAAY;QAClB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;QAC/C,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;YACxB,MAAM,EAAE,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACrD,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;YAClC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI;YACtB,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;gBACvE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;gBAC7E,OAAO;oBACL,QAAQ;oBACR,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI;oBACnC,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,SAAS;oBAC5C,uEAAuE;oBACvE,IAAI,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE;oBACzD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;oBACpC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,IAAI;oBACzD,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;iBAC3B,CAAC;YACJ,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}