glirastes 0.4.0 → 0.5.0

package/dist/cli/commands/tools/policy.js

@@ -0,0 +1,355 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { canonicalJson, compareCodeUnits } from '../../../codegen/tools/canonical.js';
+import { TOOLS_PATHS } from '../../../codegen/tools/config.js';
+import { ToolContractsFileSchema } from '../../../codegen/tools/files.js';
+import { AppSetupArtifactSchema, ToolRiskClassSchema } from '../../../contracts/index.js';
+import { parseExcludePattern } from '../../../contracts/tool-exclude-pattern.js';
+import { CONTROL_REF, platformMayRelaxConfirmation, resolveToolPolicy, riskTier, ToolPolicyFileSchema, } from '../../../contracts/tool-policy.js';
+import { FoundationDiagnosticError } from '../../../diagnostics/index.js';
+import { writeArtifactSetAtomically } from '../atomic-artifact-write.js';
+import { parseToolArgs, ToolsUsageError } from './args.js';
+import { confirmationLabel } from './format.js';
+import { readToolOutput } from './status.js';
+/**
+ * `glirastes tools policy` (spec 4.2, 4.5): the developer's local overrides
+ * in `.glirastes/tool-policy.json`. Every edit is checked by the same
+ * `resolveToolPolicy` the generator uses before it is written, so the CLI
+ * never writes a policy that refresh would refuse. Agents never run it.
+ */
+export const POLICY_SUBCOMMANDS = {
+    show: { flags: ['--json'], values: ['--root'], positionals: 1 },
+    disable: { flags: [], values: ['--root', '--reason'], positionals: 1 },
+    enable: { flags: [], values: ['--root'], positionals: 1 },
+    confirm: { flags: [], values: ['--root', '--reason'], positionals: 1 },
+    relax: { flags: ['--yes'], values: ['--root', '--reason'], positionals: 1 },
+    raise: { flags: [], values: ['--root', '--reason'], positionals: 2 },
+    roles: { flags: [], values: ['--root', '--reason'], positionals: 2 },
+    describe: { flags: [], values: ['--root'], positionals: 2 },
+    exclude: { flags: [], values: ['--root', '--reason'], positionals: 1 },
+    include: { flags: [], values: ['--root'], positionals: 1 },
+    'exclude-control': { flags: [], values: ['--root', '--reason'], positionals: 1 },
+    'include-control': { flags: [], values: ['--root'], positionals: 1 },
+    accept: { flags: [], values: ['--root'], positionals: 1 },
+    reset: { flags: [], values: ['--root'], positionals: 1 },
+};
+export const POLICY_USAGE = [
+    'Usage: glirastes tools policy show [<tool>] [--json]',
+    '       glirastes tools policy disable|enable|confirm <tool> [--reason <text>]',
+    '       glirastes tools policy relax <tool> --yes [--reason <text>]   (write tools only; delete, financial and external always confirm)',
+    '       glirastes tools policy raise <tool> <safe-read|read-sensitive|write|delete|financial|external> [--reason <text>]',
+    '       glirastes tools policy roles <tool> <role,role|-> [--reason <text>]',
+    '       glirastes tools policy describe <tool> <text|->',
+    '       glirastes tools policy exclude "<METHOD|PAGE|*> /path/**" --reason <text>',
+    '       glirastes tools policy include "<pattern>"',
+    '       glirastes tools policy exclude-control <file>#<setter> --reason <text>   (no client action is proposed for this UI control)',
+    '       glirastes tools policy include-control <file>#<setter>',
+    '       glirastes tools policy accept <tool>    (adopt a lower risk the code now implies)',
+    '       glirastes tools policy reset <tool>     (remove every local entry of the tool)',
+].join('\n');
+async function readPolicy(root) {
+    let raw;
+    try {
+        raw = await readFile(resolve(root, TOOLS_PATHS.policy), 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return ToolPolicyFileSchema.parse({ schemaVersion: 1 });
+        }
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = ToolPolicyFileSchema.safeParse(JSON.parse(raw));
+    }
+    catch {
+        parsed = undefined;
+    }
+    if (!parsed?.success) {
+        throw new FoundationDiagnosticError({
+            code: 'E-POLICY-001',
+            operation: 'tools.policy',
+            message: 'tool-policy.json is not valid; fix it by hand before changing it with the CLI.',
+            remediation: 'repair-tool-policy-file',
+            path: TOOLS_PATHS.policy,
+        });
+    }
+    return parsed.data;
+}
+/** Stable keys and entries sorted, exclusions in the order they were added. */
+function renderPolicy(file) {
+    const sorted = (record) => Object.fromEntries(Object.entries(record)
+        .sort(([left], [right]) => compareCodeUnits(left, right)));
+    return canonicalJson({
+        schemaVersion: 1,
+        tools: sorted(file.tools),
+        exclude: file.exclude,
+        acceptedRisk: sorted(file.acceptedRisk),
+        ...(file.excludeControls?.length ? { excludeControls: file.excludeControls } : {}),
+    });
+}
+async function writePolicy(root, file) {
+    const checked = ToolPolicyFileSchema.safeParse(file);
+    if (!checked.success) {
+        const field = checked.error.issues[0]?.path.map(String).join('.') ?? '';
+        throw new ToolsUsageError(`The change would make tool-policy.json invalid${field ? ` at ${field}` : ''}; nothing was written.`);
+    }
+    await writeArtifactSetAtomically([{ path: resolve(root, TOOLS_PATHS.policy), content: renderPolicy(checked.data) }]);
+}
+async function readTools(root) {
+    const artifact = await readToolOutput(root, TOOLS_PATHS.setupArtifact, AppSetupArtifactSchema, 'tools.policy');
+    const contracts = await readToolOutput(root, TOOLS_PATHS.contracts, ToolContractsFileSchema, 'tools.policy');
+    const byId = new Map(contracts.tools.map((entry) => [entry.toolId, entry]));
+    return artifact.tools.flatMap((tool) => {
+        const entry = byId.get(tool.toolId);
+        if (!entry)
+            return [];
+        const confirmationOrigin = tool.provenance?.policyOrigin?.requiresApproval ?? null;
+        return [{
+                toolId: tool.toolId,
+                stableKey: entry.stableKey,
+                name: tool.name,
+                route: tool.executionKind === 'endpoint' ? `${tool.method} ${tool.path}` : `UI ${tool.actionBindingRef}`,
+                riskClass: tool.riskClass,
+                requiresApproval: tool.requiresApproval,
+                confirmationOrigin,
+                platformMayRelax: tool.requiresApproval
+                    && platformMayRelaxConfirmation(tool.riskClass, confirmationOrigin ?? undefined),
+                enabled: tool.enabled,
+                needsAttention: tool.operationGroup === 'needs_attention',
+                defaults: entry.defaults,
+            }];
+    }).sort((left, right) => compareCodeUnits(left.name, right.name));
+}
+function findTool(tools, name) {
+    if (!name)
+        throw new ToolsUsageError('Name the tool as glirastes tools status prints it.');
+    const tool = tools.find((candidate) => candidate.name === name || candidate.stableKey === name);
+    if (!tool)
+        throw new ToolsUsageError(`Unknown tool ${name}; glirastes tools status lists the names.`);
+    return tool;
+}
+/** Refuses an entry the generator would refuse, before anything is written. */
+function assertResolvable(tool, entry, file) {
+    const accepted = file.acceptedRisk[tool.stableKey];
+    const resolved = resolveToolPolicy({
+        toolId: tool.toolId,
+        defaults: tool.defaults,
+        codeEnabled: !tool.needsAttention,
+        local: entry,
+        ...(accepted ? { acceptedRisk: accepted } : {}),
+        previousEffectiveRiskClass: tool.riskClass,
+    });
+    const error = resolved.errors[0];
+    if (error) {
+        throw new ToolsUsageError(error.reason === 'tier-3-always-requires-approval'
+            ? `${tool.name} is ${tool.riskClass}: delete, financial and external tools always ask first.`
+            : `tool-policy.json would be refused (${error.code} ${error.field}: ${error.reason}); nothing was written.`);
+    }
+}
+function withReason(entry, reason) {
+    return reason === undefined ? entry : { ...entry, reason };
+}
+function compact(entry) {
+    const kept = Object.fromEntries(Object.entries(entry).filter(([, value]) => value !== undefined));
+    const meaningful = Object.keys(kept).filter((key) => key !== 'reason');
+    return meaningful.length > 0 ? kept : undefined;
+}
+function formatShow(tools, file) {
+    const lines = ['Tool policy (effective after the last refresh; local entries from .glirastes/tool-policy.json):'];
+    for (const tool of tools) {
+        const local = file.tools[tool.stableKey];
+        const state = tool.needsAttention ? 'needs attention' : tool.enabled ? 'active' : 'disabled';
+        const confirmation = confirmationLabel({ ...tool, confirmation: tool.requiresApproval });
+        lines.push(`  ${tool.name}  ${tool.route}  ${tool.riskClass}, ${confirmation}, ${state}`
+            + `  (code: ${tool.defaults.riskClass}${tool.defaults.requiresApproval ? ', asks first' : ''})`);
+        if (local)
+            lines.push(`      local: ${JSON.stringify(local)}`);
+        const accepted = file.acceptedRisk[tool.stableKey];
+        if (accepted)
+            lines.push(`      accepted risk: ${accepted.riskClass}`);
+    }
+    for (const exclusion of file.exclude)
+        lines.push(`  excluded: ${exclusion.match}  (${exclusion.reason})`);
+    for (const control of file.excludeControls ?? [])
+        lines.push(`  excluded control: ${control.control}  (${control.reason})`);
+    return lines.join('\n');
+}
+export async function runToolsPolicy(argv, io) {
+    const [subcommand, ...rest] = argv;
+    const spec = subcommand !== undefined && Object.hasOwn(POLICY_SUBCOMMANDS, subcommand) ? POLICY_SUBCOMMANDS[subcommand] : undefined;
+    if (!spec || !subcommand)
+        throw new ToolsUsageError('Choose a tools policy subcommand.');
+    const args = parseToolArgs(rest, spec);
+    const root = resolve(io.cwd, args.values.get('--root') ?? '.');
+    const reason = args.values.get('--reason');
+    const [first, second] = args.positionals;
+    const file = await readPolicy(root);
+    const done = async (next, message) => {
+        await writePolicy(root, next);
+        io.log(`Updated ${TOOLS_PATHS.policy}: ${message}. Run glirastes tools refresh to apply it.`);
+        return 0;
+    };
+    if (subcommand === 'exclude' || subcommand === 'include') {
+        if (!first || !parseExcludePattern(first)) {
+            throw new ToolsUsageError('Write the pattern as "<METHOD|PAGE|*> /path/**", e.g. "POST /api/internal/**".');
+        }
+        if (subcommand === 'exclude') {
+            if (!reason)
+                throw new ToolsUsageError('Say why with --reason; the reason is part of the reviewed policy.');
+            if (file.exclude.some((entry) => entry.match === first))
+                throw new ToolsUsageError(`${first} is already excluded.`);
+            return done({ ...file, exclude: [...file.exclude, { match: first, reason }] }, `${first} is excluded`);
+        }
+        if (!file.exclude.some((entry) => entry.match === first)) {
+            throw new ToolsUsageError(`No exclude entry matches ${first} exactly; glirastes tools policy show lists them.`);
+        }
+        return done({ ...file, exclude: file.exclude.filter((entry) => entry.match !== first) }, `${first} is included again`);
+    }
+    if (subcommand === 'exclude-control' || subcommand === 'include-control') {
+        if (!first || !CONTROL_REF.test(first)) {
+            throw new ToolsUsageError('Name the control as <file>#<setter>, as glirastes tools resolve --print lists it.');
+        }
+        const excludeControls = file.excludeControls ?? [];
+        const listed = excludeControls.some((entry) => entry.control === first);
+        if (subcommand === 'exclude-control') {
+            if (!reason)
+                throw new ToolsUsageError('Say why with --reason; the reason is part of the reviewed policy.');
+            if (listed)
+                throw new ToolsUsageError(`${first} is already excluded.`);
+            return done({ ...file, excludeControls: [...excludeControls, { control: first, reason }] }, `${first} is excluded`);
+        }
+        if (!listed)
+            throw new ToolsUsageError(`No excluded control matches ${first} exactly; glirastes tools policy show lists them.`);
+        return done({ ...file, excludeControls: excludeControls.filter((entry) => entry.control !== first) }, `${first} is included again`);
+    }
+    if (subcommand === 'reset' && first && (Object.hasOwn(file.tools, first) || Object.hasOwn(file.acceptedRisk, first))) {
+        // Orphaned keys have no tool any more; reset still removes them.
+        const { [first]: _tool, ...tools } = file.tools;
+        const { [first]: _risk, ...acceptedRisk } = file.acceptedRisk;
+        return done({ ...file, tools, acceptedRisk }, `every local entry of ${first} is removed`);
+    }
+    const tools = await readTools(root);
+    if (subcommand === 'show') {
+        const selected = first ? [findTool(tools, first)] : tools;
+        if (args.flags.has('--json')) {
+            io.log(JSON.stringify({
+                schemaVersion: 1,
+                tools: selected.map((tool) => ({
+                    name: tool.name,
+                    stableKey: tool.stableKey,
+                    route: tool.route,
+                    effective: {
+                        riskClass: tool.riskClass,
+                        requiresApproval: tool.requiresApproval,
+                        confirmationOrigin: tool.confirmationOrigin,
+                        platformMayRelax: tool.platformMayRelax,
+                        enabled: tool.enabled,
+                    },
+                    code: { riskClass: tool.defaults.riskClass, requiresApproval: tool.defaults.requiresApproval },
+                    local: file.tools[tool.stableKey] ?? null,
+                    acceptedRisk: file.acceptedRisk[tool.stableKey] ?? null,
+                })),
+                exclude: file.exclude,
+                excludeControls: file.excludeControls ?? [],
+            }));
+        }
+        else {
+            io.log(formatShow(selected, file));
+        }
+        return 0;
+    }
+    const tool = findTool(tools, first);
+    const current = file.tools[tool.stableKey] ?? {};
+    const write = async (next, message) => {
+        const entry = next ? compact(next) : undefined;
+        if (entry)
+            assertResolvable(tool, entry, file);
+        const { [tool.stableKey]: _previous, ...others } = file.tools;
+        return done({ ...file, tools: entry ? { ...others, [tool.stableKey]: entry } : others }, message);
+    };
+    switch (subcommand) {
+        case 'disable':
+            return write(withReason({ ...current, enabled: false }, reason), `${tool.name} is disabled`);
+        case 'enable': {
+            if (current.enabled !== false) {
+                throw new ToolsUsageError(`${tool.name} has no local disable; enable only removes one, the code decides whether a tool can run.`);
+            }
+            return write({ ...current, enabled: undefined }, `${tool.name} is no longer disabled locally`);
+        }
+        case 'confirm':
+            // An explicit `true` is a local lock (D16): the report names it
+            // local-policy, so a connected Platform never relaxes it.
+            return write(withReason({ ...current, requiresApproval: true, pin: undefined }, reason), riskTier(tool.riskClass) <= 2
+                ? `${tool.name} asks before it runs, and a connected Platform can no longer switch that off`
+                    + ` (glirastes tools policy reset ${tool.name} lifts the lock)`
+                : `${tool.name} asks before it runs`);
+        case 'relax': {
+            if (!args.flags.has('--yes')) {
+                throw new ToolsUsageError(`Relaxing lets ${tool.name} run without asking; confirm the review with --yes.`);
+            }
+            if (riskTier(tool.riskClass) >= 3) {
+                throw new ToolsUsageError(`${tool.name} is ${tool.riskClass}: delete, financial and external tools always ask first.`);
+            }
+            if (!tool.requiresApproval)
+                throw new ToolsUsageError(`${tool.name} already runs without asking.`);
+            return write(withReason({
+                ...current,
+                requiresApproval: false,
+                pin: { toolId: tool.toolId, atRiskClass: tool.riskClass },
+            }, reason), `${tool.name} runs without asking while it stays ${tool.riskClass} (pinned)`);
+        }
+        case 'raise': {
+            const parsed = ToolRiskClassSchema.exclude(['unknown']).safeParse(second);
+            if (!parsed.success)
+                throw new ToolsUsageError('Name a risk class: safe-read, read-sensitive, write, delete, financial or external.');
+            if (riskTier(parsed.data) <= riskTier(tool.riskClass)) {
+                throw new ToolsUsageError(`${tool.name} is already ${tool.riskClass}; the policy can only raise the risk. A lower code risk is adopted with glirastes tools policy accept.`);
+            }
+            return write(withReason({ ...current, riskClass: parsed.data }, reason), `${tool.name} is ${parsed.data}`);
+        }
+        case 'roles': {
+            if (!second)
+                throw new ToolsUsageError('Name the roles, comma-separated, or - to remove the restriction.');
+            const roles = second === '-' ? [] : [...new Set(second.split(',').map((role) => role.trim()).filter(Boolean))].sort(compareCodeUnits);
+            if (second !== '-' && roles.length === 0)
+                throw new ToolsUsageError('Name at least one role, or - to remove the restriction.');
+            return write(withReason({ ...current, allowedRoles: roles.length > 0 ? roles : undefined }, reason), roles.length > 0 ? `${tool.name} is limited to ${roles.join(', ')}` : `${tool.name} has no local role limit`);
+        }
+        case 'describe': {
+            if (!second)
+                throw new ToolsUsageError('Give the description, or - to remove the local one.');
+            return write({ ...current, description: second === '-' ? undefined : second }, second === '-' ? `${tool.name} uses the description from the code` : `${tool.name} has a local description`);
+        }
+        case 'accept': {
+            const accepted = file.acceptedRisk[tool.stableKey];
+            const resolved = resolveToolPolicy({
+                toolId: tool.toolId,
+                defaults: tool.defaults,
+                codeEnabled: !tool.needsAttention,
+                ...(file.tools[tool.stableKey] ? { local: file.tools[tool.stableKey] } : {}),
+                ...(accepted ? { acceptedRisk: accepted } : {}),
+                previousEffectiveRiskClass: tool.riskClass,
+            });
+            const lower = resolved.warnings.find((warning) => warning.code === 'risk-lower-available');
+            if (!lower?.riskClass) {
+                throw new ToolsUsageError(`${tool.name} has no lower risk to accept. Run glirastes tools refresh after the code change first.`);
+            }
+            return done({
+                ...file,
+                acceptedRisk: { ...file.acceptedRisk, [tool.stableKey]: { riskClass: lower.riskClass, toolId: tool.toolId } },
+            }, `${tool.name} may drop from ${tool.riskClass} to ${lower.riskClass}`);
+        }
+        case 'reset': {
+            if (!Object.hasOwn(file.tools, tool.stableKey) && !Object.hasOwn(file.acceptedRisk, tool.stableKey)) {
+                throw new ToolsUsageError(`${tool.name} has no local entry to reset.`);
+            }
+            const { [tool.stableKey]: _tool, ...others } = file.tools;
+            const { [tool.stableKey]: _risk, ...acceptedRisk } = file.acceptedRisk;
+            return done({ ...file, tools: others, acceptedRisk }, `every local entry of ${tool.name} is removed`);
+        }
+        default:
+            throw new ToolsUsageError('Choose a tools policy subcommand.');
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/cli/commands/tools/policy.js.map

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

package/dist/cli/commands/tools/refresh.d.ts

@@ -0,0 +1,6 @@
+import { type ToolsIo } from './format.js';
+export declare const REFRESH_ARGS: {
+    readonly flags: readonly ["--keep-going", "--json", "--watch"];
+    readonly values: readonly ["--root", "--mode", "--adopt"];
+};
+export declare function runToolsRefresh(argv: ReadonlyArray<string>, io: ToolsIo): Promise<number>;

package/dist/cli/commands/tools/refresh.js

@@ -0,0 +1,87 @@
+import { resolve } from 'node:path';
+import { generatedModulePath, loadToolsConfig } from '../../../codegen/tools/config.js';
+import { isToolsMode, resolveToolsMode } from '../../../codegen/tools/mode.js';
+import { ToolsPipelineFailure } from '../../../codegen/tools/pipeline.js';
+import { isFoundationDiagnosticError } from '../../../diagnostics/index.js';
+import { parseToolArgs, ToolsUsageError } from './args.js';
+import { agentWorkNotes, formatToolsHuman, formatToolsJson } from './format.js';
+import { watchToolsRefresh } from './watch.js';
+export const REFRESH_ARGS = {
+    flags: ['--keep-going', '--json', '--watch'],
+    values: ['--root', '--mode', '--adopt'],
+};
+/** Until Ctrl+C: one refresh per burst of changes; a failing refresh, expected or not, is printed and the watch goes on. */
+async function watchRefresh(root, io) {
+    const config = loadToolsConfig(root);
+    const controller = new AbortController();
+    const stop = () => { controller.abort(); };
+    const signal = io.signal ?? controller.signal;
+    if (!io.signal) {
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    }
+    io.log('Watching the app for tool changes. Stop with Ctrl+C.');
+    try {
+        await watchToolsRefresh({
+            root,
+            generatedModule: generatedModulePath(config),
+            signal,
+            ...(io.watch ? { watch: io.watch } : {}),
+            onError: (error) => {
+                io.error(`The refresh failed unexpectedly, watching goes on: ${error instanceof Error ? error.message : String(error)}`);
+            },
+            run: async () => {
+                try {
+                    const result = await io.runPipeline({ root, mode: 'write', keepGoing: true });
+                    const notes = agentWorkNotes(result);
+                    io.log(notes.length > 0 ? `${formatToolsHuman(result)}\n\n${notes.join('\n')}` : formatToolsHuman(result));
+                }
+                catch (error) {
+                    if (error instanceof ToolsPipelineFailure)
+                        io.log(formatToolsHuman(error.result));
+                    else if (isFoundationDiagnosticError(error))
+                        io.error(`${error.code}: ${error.message}`);
+                    else
+                        throw error;
+                }
+            },
+        });
+    }
+    finally {
+        process.removeListener('SIGINT', stop);
+        process.removeListener('SIGTERM', stop);
+    }
+    return 0;
+}
+export async function runToolsRefresh(argv, io) {
+    const args = parseToolArgs(argv, REFRESH_ARGS);
+    const modeFlag = args.values.get('--mode');
+    if (modeFlag !== undefined && !isToolsMode(modeFlag)) {
+        throw new ToolsUsageError('--mode must be write, frozen or integrity.');
+    }
+    const mode = resolveToolsMode({ ...(modeFlag !== undefined ? { flag: modeFlag } : {}), env: io.env });
+    const root = resolve(io.cwd, args.values.get('--root') ?? '.');
+    if (args.flags.has('--watch')) {
+        if (mode !== 'write')
+            throw new ToolsUsageError('--watch refreshes in write mode only; CI and Docker builds check once.');
+        if (args.flags.has('--json') || args.values.has('--adopt'))
+            throw new ToolsUsageError('--watch cannot be combined with --json or --adopt.');
+        return watchRefresh(root, io);
+    }
+    const keepGoing = args.flags.has('--keep-going') && mode === 'write';
+    const adoptInventoryPath = args.values.get('--adopt');
+    const result = await io.runPipeline({
+        root,
+        mode,
+        ...(keepGoing ? { keepGoing } : {}),
+        ...(adoptInventoryPath ? { adoptInventoryPath } : {}),
+    });
+    if (args.flags.has('--json')) {
+        io.log(formatToolsJson(result));
+        return 0;
+    }
+    const notes = agentWorkNotes(result);
+    io.log(notes.length > 0 ? `${formatToolsHuman(result)}\n\n${notes.join('\n')}` : formatToolsHuman(result));
+    return 0;
+}
+//# sourceMappingURL=refresh.js.map

package/dist/cli/commands/tools/refresh.js.map

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

package/dist/cli/commands/tools/resolve.d.ts

@@ -0,0 +1,10 @@
+import type { ToolsIo } from './format.js';
+export declare const RESOLVE_ARGS: {
+    readonly flags: readonly ["--print", "--json"];
+    readonly values: readonly ["--root"];
+};
+/**
+ * Prints the stage-1 work list for the developer's coding agent. Reads the
+ * code like `tools check` (frozen: never writes, no model, no network).
+ */
+export declare function runToolsResolve(argv: ReadonlyArray<string>, io: ToolsIo): Promise<number>;

package/dist/cli/commands/tools/resolve.js

@@ -0,0 +1,19 @@
+import { resolve } from 'node:path';
+import { buildResolveWorklist } from '../../../codegen/tools/worklist.js';
+import { parseToolArgs, ToolsUsageError } from './args.js';
+export const RESOLVE_ARGS = { flags: ['--print', '--json'], values: ['--root'] };
+/**
+ * Prints the stage-1 work list for the developer's coding agent. Reads the
+ * code like `tools check` (frozen: never writes, no model, no network).
+ */
+export async function runToolsResolve(argv, io) {
+    const args = parseToolArgs(argv, RESOLVE_ARGS);
+    if (!args.flags.has('--print')) {
+        throw new ToolsUsageError('tools resolve prints a work list for your coding agent; Glirastes never runs a model. Use --print.');
+    }
+    const root = resolve(io.cwd, args.values.get('--root') ?? '.');
+    const result = await io.runPipeline({ root, mode: 'frozen', keepGoing: true });
+    io.log(JSON.stringify(buildResolveWorklist(result), null, 2));
+    return 0;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/cli/commands/tools/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../../src/cli/commands/tools/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG3D,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAW,CAAC;AAE1F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAA2B,EAAE,EAAW;IAC5E,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,eAAe,CAAC,oGAAoG,CAAC,CAAC;IAClI,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/E,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/commands/tools/status.d.ts

@@ -0,0 +1,11 @@
+import type { z } from 'zod';
+import { type ToolStatusEntry, type ToolsIo } from './format.js';
+/** A committed generator output, parsed; E-TOOLS-020/021 ask for a refresh. */
+export declare function readToolOutput<T>(root: string, path: string, schema: z.ZodType<T>, operation?: string): Promise<T>;
+/** Local "What can my chat do?" from the committed outputs; no recomputation. */
+export declare function readToolStatus(root: string): Promise<ToolStatusEntry[]>;
+export declare const STATUS_ARGS: {
+    readonly flags: readonly ["--json"];
+    readonly values: readonly ["--root"];
+};
+export declare function runToolsStatus(argv: ReadonlyArray<string>, io: ToolsIo): Promise<number>;

package/dist/cli/commands/tools/status.js

@@ -0,0 +1,76 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { ToolReportFileSchema } from '../../../codegen/tools/artifact.js';
+import { compareCodeUnits } from '../../../codegen/tools/canonical.js';
+import { TOOLS_PATHS } from '../../../codegen/tools/config.js';
+import { AppSetupArtifactSchema } from '../../../contracts/index.js';
+import { platformMayRelaxConfirmation } from '../../../contracts/tool-policy.js';
+import { FoundationDiagnosticError } from '../../../diagnostics/index.js';
+import { parseToolArgs } from './args.js';
+import { formatToolStatus } from './format.js';
+/** A committed generator output, parsed; E-TOOLS-020/021 ask for a refresh. */
+export async function readToolOutput(root, path, schema, operation = 'tools.status') {
+    let raw;
+    try {
+        raw = await readFile(resolve(root, path), 'utf8');
+    }
+    catch {
+        throw new FoundationDiagnosticError({
+            code: 'E-TOOLS-020',
+            operation,
+            message: 'No tool outputs found. Run glirastes tools refresh first.',
+            remediation: 'run-tools-refresh',
+            path,
+        });
+    }
+    let parsed;
+    try {
+        parsed = schema.safeParse(JSON.parse(raw));
+    }
+    catch {
+        parsed = undefined;
+    }
+    if (!parsed?.success) {
+        throw new FoundationDiagnosticError({
+            code: 'E-TOOLS-021',
+            operation,
+            message: 'The tool outputs are invalid. Run glirastes tools refresh.',
+            remediation: 'run-tools-refresh',
+            path,
+        });
+    }
+    return parsed.data;
+}
+/** Local "What can my chat do?" from the committed outputs; no recomputation. */
+export async function readToolStatus(root) {
+    const artifact = await readToolOutput(root, TOOLS_PATHS.setupArtifact, AppSetupArtifactSchema);
+    const report = await readToolOutput(root, TOOLS_PATHS.report, ToolReportFileSchema);
+    const reported = new Map(report.tools.map((tool) => [tool.toolId, tool]));
+    return artifact.tools.map((tool) => {
+        const entry = reported.get(tool.toolId);
+        const confirmationOrigin = tool.provenance?.policyOrigin?.requiresApproval ?? null;
+        return {
+            toolId: tool.toolId,
+            name: tool.name,
+            route: tool.executionKind === 'endpoint' ? `${tool.method} ${tool.path}` : `UI ${tool.actionBindingRef}`,
+            enabled: tool.enabled,
+            needsAttention: tool.operationGroup === 'needs_attention',
+            riskClass: tool.riskClass,
+            confirmation: tool.requiresApproval,
+            confirmationOrigin,
+            platformMayRelax: tool.requiresApproval
+                && platformMayRelaxConfirmation(tool.riskClass, confirmationOrigin ?? undefined),
+            contractSource: entry?.contractSource ?? null,
+            descriptionQuality: entry?.quality.description ?? 'template',
+            schemaQuality: entry?.quality.schema ?? 'none',
+        };
+    }).sort((left, right) => compareCodeUnits(left.name, right.name));
+}
+export const STATUS_ARGS = { flags: ['--json'], values: ['--root'] };
+export async function runToolsStatus(argv, io) {
+    const args = parseToolArgs(argv, STATUS_ARGS);
+    const entries = await readToolStatus(resolve(io.cwd, args.values.get('--root') ?? '.'));
+    io.log(args.flags.has('--json') ? JSON.stringify({ schemaVersion: 1, tools: entries }) : formatToolStatus(entries));
+    return 0;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/tools/status.js.map

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