@senior-skills/cli 1.0.0

package/dist/commands/system.js

@@ -0,0 +1,170 @@
+import { AgentSkillsError, DiagnoseSystem, ErrorCode, ExitCode, detectAgents, } from '@senior-skills/core';
+import { inferKind } from '@senior-skills/node';
+import { glyph, heading, info, json, out, plural, style, success, table, warn } from "../ui.js";
+export async function runDoctor(ctx, options) {
+    const report = await new DiagnoseSystem(ctx).execute({
+        ...(options.offline === undefined ? {} : { offline: options.offline }),
+    });
+    if (options.json === true) {
+        json(report);
+        return report.ok ? ExitCode.OK : ExitCode.FAILURE;
+    }
+    render(report);
+    return report.ok ? ExitCode.OK : ExitCode.FAILURE;
+}
+function render(report) {
+    out();
+    out(style.bold('Senior Skills Doctor'));
+    for (const section of report.sections) {
+        out();
+        out(`${style.bold(section.title)}`);
+        for (const check of section.checks) {
+            out(`  ${marker(check.status)} ${check.title}${check.detail === undefined ? '' : `  ${style.dim(check.detail)}`}`);
+            for (const note of check.notes ?? [])
+                out(`      ${style.dim(note)}`);
+            if (check.hint !== undefined)
+                out(`      ${style.cyan(check.hint)}`);
+        }
+    }
+    out();
+    if (report.ok && report.warnings === 0) {
+        success('Everything looks good.');
+    }
+    else if (report.ok) {
+        warn(`${plural(report.warnings, 'warning')} — nothing is broken.`);
+    }
+    else {
+        out(`${style.red(glyph.fail)} ${plural(report.failures, 'problem')} found.`);
+    }
+    out();
+}
+function marker(status) {
+    switch (status) {
+        case 'ok':
+            return style.green(glyph.ok);
+        case 'warn':
+            return style.yellow(glyph.warn);
+        case 'fail':
+            return style.red(glyph.fail);
+        default:
+            return style.dim(glyph.skip);
+    }
+}
+/**
+ * `senior-skills agents` — what detection found, without the rest of doctor's output.
+ * Answers "does this machine have Codex?" directly, which is the question people actually ask.
+ */
+export async function runAgents(ctx, options) {
+    const detections = await detectAgents(ctx);
+    if (options.json === true) {
+        json(detections);
+        return;
+    }
+    heading('Detecting agents...');
+    for (const detection of detections) {
+        const adapter = ctx.agents.find(detection.agentId);
+        const label = adapter?.displayName ?? detection.agentId;
+        if (detection.installed) {
+            out(`${style.green(glyph.ok)} ${label} detected`);
+        }
+        else if (detection.strength === 'weak') {
+            out(`${style.yellow(glyph.warn)} ${label} — weak evidence only`);
+        }
+        else {
+            out(`${style.dim(glyph.skip)} ${style.dim(`${label} not detected`)}`);
+        }
+        for (const evidence of detection.evidence) {
+            out(`    ${style.dim(`${evidence.kind}: ${evidence.detail}`)}`);
+        }
+    }
+    const anyInstalled = detections.some((detection) => detection.installed);
+    out();
+    if (!anyInstalled) {
+        out('No supported coding agents detected.');
+        out();
+        out('Supported agents:');
+        for (const adapter of ctx.agents.all())
+            out(`- ${adapter.displayName}`);
+        out();
+        out('Use --agent to explicitly select an agent.');
+        out();
+    }
+}
+export async function runRegistryList(ctx, options) {
+    const registries = ctx.config.registries;
+    if (options.json === true) {
+        json(registries);
+        return;
+    }
+    if (registries.length === 0) {
+        heading('No registries configured');
+        info('senior-skills registry add official https://github.com/robsonkades/senior-skills.git');
+        return;
+    }
+    heading('Registries');
+    out(`  ${style.dim('Earlier entries take precedence: the first registry publishing a name owns it.')}`);
+    out();
+    table(registries.map((registry, index) => [
+        style.dim(`${index + 1}.`),
+        style.bold(registry.name),
+        registry.kind,
+        registry.url + (registry.ref === undefined ? '' : `#${registry.ref}`),
+        registry.trusted ? '' : style.yellow('untrusted'),
+    ]));
+    out();
+}
+export async function runRegistryAdd(ctx, store, name, url, options) {
+    const config = await store.load();
+    if (config.registries.some((registry) => registry.name === name)) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_DUPLICATE, `A registry named "${name}" already exists`, {
+            hints: [`senior-skills registry remove ${name}   then add it again`],
+            data: { name },
+        });
+    }
+    const entry = {
+        name,
+        url,
+        kind: inferKind(options.kind, url),
+        trusted: options.untrusted !== true,
+        ...(options.ref === undefined ? {} : { ref: options.ref }),
+    };
+    // Precedence is list order, so where a registry lands is a real decision, not cosmetics.
+    const registries = options.first === true ? [entry, ...config.registries] : [...config.registries, entry];
+    await store.save({ ...config, registries });
+    if (options.json === true) {
+        json({ added: entry, registries });
+        return;
+    }
+    success(`Added registry "${name}" (${entry.kind})`);
+    out(`  ${style.dim(url)}`);
+    out(`  ${style.dim(options.first === true
+        ? 'Placed first: it now takes precedence over every other registry.'
+        : 'Placed last: existing registries keep precedence for names they already publish.')}`);
+    if (!entry.trusted)
+        out(`  ${style.yellow('Marked untrusted; doctor will flag it.')}`);
+    out();
+    info(`Config: ${store.location()}`);
+    void ctx;
+}
+export async function runRegistryRemove(store, name, options) {
+    const config = await store.load();
+    const registries = config.registries.filter((registry) => registry.name !== name);
+    if (registries.length === config.registries.length) {
+        throw new AgentSkillsError(ErrorCode.REGISTRY_NOT_FOUND, `No registry named "${name}"`, {
+            details: ['', 'Configured:', ...config.registries.map((registry) => `  ${registry.name}`)],
+            hints: ['senior-skills registry list'],
+            data: { name },
+        });
+    }
+    await store.save({ ...config, registries });
+    if (options.json === true) {
+        json({ removed: name, registries });
+        return;
+    }
+    success(`Removed registry "${name}"`);
+    if (registries.length === 0) {
+        out();
+        warn('No registries are configured; install and search will not find anything.');
+    }
+}
+//# sourceMappingURL=system.js.map

package/dist/commands/system.js.map

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

package/dist/container.d.ts

@@ -0,0 +1,29 @@
+import { type AgentSkillsConfig, type ApplicationContext, type Hasher } from '@senior-skills/core';
+import { FileConfigStore } from '@senior-skills/node';
+import type { LogLevel } from '@senior-skills/core';
+import type { NotificationServices } from './update-notifications.ts';
+export declare const TOOL_NAME = "@senior-skills/cli";
+export interface ContainerOptions {
+    readonly logLevel?: LogLevel;
+    readonly allowInsecure?: boolean;
+    readonly version: string;
+}
+export interface Container {
+    readonly ctx: ApplicationContext;
+    readonly hasher: Hasher;
+    readonly configStore: FileConfigStore;
+    readonly config: AgentSkillsConfig;
+    readonly notifications: NotificationServices;
+}
+/**
+ * The composition root.
+ *
+ * This is the only place in the project where a concrete class is chosen. Every layer above
+ * receives interfaces, which is what makes "swap the registry", "swap the filesystem" and
+ * "add an agent" true statements rather than aspirations.
+ *
+ * Registering a third-party adapter is one more `.register(...)` call here — or, once a
+ * plugin loader exists, a line of configuration that ends up doing exactly this.
+ */
+export declare function createContainer(options: ContainerOptions): Promise<Container>;
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAEvB,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAEL,eAAe,EAYhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,eAAO,MAAM,SAAS,uBAAuB,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;CAC9C;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqGnF"}

package/dist/container.js

@@ -0,0 +1,101 @@
+import { AgentCatalog, ApplySkillUpdates, CheckUpdates, } from '@senior-skills/core';
+import { ClaudeCodeAdapter } from '@senior-skills/adapter-claude';
+import { CodexAdapter } from '@senior-skills/adapter-codex';
+import { AtomicInstaller, SafeExtractor } from '@senior-skills/installer';
+import { DefaultRegistryFactory, RegistryFederation } from '@senior-skills/registry';
+import { ConsoleLogger, FileConfigStore, NodeArchiveReader, NodeCommandRunner, NodeEnvironment, NodeFileSystem, NodeHasher, NodeHttpClient, SystemClock, cacheHome, FileUpdateStateStore, NpmToolUpdater, NodeSelectionPrompt, } from '@senior-skills/node';
+import { fileURLToPath } from 'node:url';
+export const TOOL_NAME = '@senior-skills/cli';
+/**
+ * The composition root.
+ *
+ * This is the only place in the project where a concrete class is chosen. Every layer above
+ * receives interfaces, which is what makes "swap the registry", "swap the filesystem" and
+ * "add an agent" true statements rather than aspirations.
+ *
+ * Registering a third-party adapter is one more `.register(...)` call here — or, once a
+ * plugin loader exists, a line of configuration that ends up doing exactly this.
+ */
+export async function createContainer(options) {
+    const toolVersion = `${TOOL_NAME}@${options.version}`;
+    const fs = new NodeFileSystem();
+    const env = new NodeEnvironment();
+    const clock = new SystemClock();
+    const hasher = new NodeHasher();
+    const commands = new NodeCommandRunner();
+    const logger = new ConsoleLogger(options.logLevel ?? 'info');
+    const http = new NodeHttpClient(`senior-skills/${options.version}`, options.allowInsecure === true);
+    const configStore = new FileConfigStore(fs, env);
+    const config = await configStore.load();
+    const agents = new AgentCatalog().register(new ClaudeCodeAdapter()).register(new CodexAdapter());
+    const extractor = new SafeExtractor(new NodeArchiveReader());
+    const registryFactory = new DefaultRegistryFactory({
+        fs,
+        hasher,
+        http,
+        commands,
+        clock,
+        logger,
+        extractor,
+        cacheDir: cacheHome(fs, env),
+        ttlSeconds: config.cache.ttlSeconds,
+    });
+    const registry = new RegistryFederation(config.registries.map((entry) => registryFactory.create(entry)));
+    const installer = new AtomicInstaller({ fs, hasher, clock, logger, toolVersion });
+    const ctx = {
+        agents,
+        registry,
+        installer,
+        fs,
+        env,
+        commands,
+        clock,
+        logger,
+        config,
+        toolVersion,
+    };
+    const tool = new NpmToolUpdater({
+        fs,
+        env,
+        commands,
+        http,
+        packageDirectory: fileURLToPath(new URL('../', import.meta.url)),
+        nodeExecutable: process.execPath,
+    });
+    // Notification traffic has a short deadline and never launches credential prompts.
+    // Its drivers share the normal registry cache, but installs keep their usual timeouts.
+    const notificationFactory = new DefaultRegistryFactory({
+        fs,
+        hasher,
+        clock,
+        logger,
+        extractor,
+        cacheDir: cacheHome(fs, env),
+        ttlSeconds: config.cache.ttlSeconds,
+        http: { get: (url, request) => http.get(url, { ...request, timeoutMs: 2000 }) },
+        commands: {
+            which: (command) => commands.which(command),
+            run: (command, args, request) => commands.run(command, args, {
+                ...request,
+                timeoutMs: 2000,
+                env: { ...request?.env, GIT_TERMINAL_PROMPT: '0', GCM_INTERACTIVE: 'never' },
+            }),
+        },
+    });
+    const notificationRegistry = new RegistryFederation(config.registries.map((entry) => notificationFactory.create(entry)));
+    const notifications = {
+        check: new CheckUpdates({ ...ctx, registry: notificationRegistry }, tool, new FileUpdateStateStore(fs, env)),
+        apply: new ApplySkillUpdates(ctx),
+        tool,
+        prompt: new NodeSelectionPrompt(),
+        logger,
+    };
+    return {
+        ctx,
+        hasher,
+        configStore,
+        config,
+        notifications,
+    };
+}
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `@senior-skills/cli` — the command-line interface and the composition root.
+ *
+ * Importable so that tests (and any embedding tool) can drive the CLI in-process rather than
+ * shelling out.
+ */
+export { VERSION, run } from './cli.ts';
+export { createContainer, TOOL_NAME, type Container, type ContainerOptions } from './container.ts';
+export { collect, resolveScope, type GlobalOptions } from './options.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * `@senior-skills/cli` — the command-line interface and the composition root.
+ *
+ * Importable so that tests (and any embedding tool) can drive the CLI in-process rather than
+ * shelling out.
+ */
+export { VERSION, run } from "./cli.js";
+export { createContainer, TOOL_NAME } from "./container.js";
+export { collect, resolveScope } from "./options.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAyC,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAsB,MAAM,cAAc,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,25 @@
+import { type ApplicationContext, type InstallScope } from '@senior-skills/core';
+export interface GlobalOptions {
+    readonly agent?: readonly string[];
+    readonly global?: boolean;
+    readonly project?: boolean;
+    readonly projectRoot?: string;
+    readonly registry?: string;
+    readonly dryRun?: boolean;
+    readonly json?: boolean;
+    readonly verbose?: boolean;
+    readonly quiet?: boolean;
+    readonly updateCheck?: boolean;
+}
+/**
+ * Decides between global and project scope.
+ *
+ * The default is deliberately contextual: inside a directory that already has a `skills.lock`
+ * or an agent project directory, `install` almost always means "for this project", and making
+ * the user type `--project` every time would be a papercut. Everywhere else the default is
+ * global. Passing both flags is a usage error rather than a silent precedence rule.
+ */
+export declare function resolveScope(ctx: ApplicationContext, options: GlobalOptions): Promise<InstallScope>;
+/** Commander collects repeatable options through this. */
+export declare function collect(value: string, previous?: readonly string[]): readonly string[];
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,kBAAkB,EACvB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAiBvB;AAED,0DAA0D;AAC1D,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,GAAG,SAAS,MAAM,EAAE,CAQ1F"}

package/dist/options.js

@@ -0,0 +1,39 @@
+import { AgentSkillsError, ErrorCode, findProjectRoot, } from '@senior-skills/core';
+/**
+ * Decides between global and project scope.
+ *
+ * The default is deliberately contextual: inside a directory that already has a `skills.lock`
+ * or an agent project directory, `install` almost always means "for this project", and making
+ * the user type `--project` every time would be a papercut. Everywhere else the default is
+ * global. Passing both flags is a usage error rather than a silent precedence rule.
+ */
+export async function resolveScope(ctx, options) {
+    if (options.global === true && options.project === true) {
+        throw new AgentSkillsError(ErrorCode.USAGE, 'Cannot use --global and --project together', {
+            hints: ['Pick one: --global installs for your user, --project installs into this repository'],
+        });
+    }
+    if (options.global === true)
+        return 'global';
+    if (options.project === true || options.projectRoot !== undefined)
+        return 'project';
+    const projectRoot = await findProjectRoot(ctx.fs, ctx.env.cwd(), ctx.env.homeDir());
+    if (projectRoot === undefined)
+        return 'global';
+    for (const marker of ['skills.lock', '.claude/skills', '.agents/skills']) {
+        if (await ctx.fs.exists(ctx.fs.join(projectRoot, ...marker.split('/'))))
+            return 'project';
+    }
+    return 'global';
+}
+/** Commander collects repeatable options through this. */
+export function collect(value, previous = []) {
+    return [
+        ...previous,
+        ...value
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean),
+    ];
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,eAAe,GAGhB,MAAM,qBAAqB,CAAC;AAe7B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAuB,EACvB,OAAsB;IAEtB,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACxD,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,KAAK,EAAE,4CAA4C,EAAE;YACxF,KAAK,EAAE,CAAC,oFAAoF,CAAC;SAC9F,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEpF,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACpF,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAE/C,KAAK,MAAM,MAAM,IAAI,CAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,EAAE,CAAC;QACzE,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;IAC5F,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,WAA8B,EAAE;IACrE,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,KAAK;aACL,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,OAAO,CAAC;KACnB,CAAC;AACJ,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,42 @@
+import { type ValidationIssue } from '@senior-skills/core';
+export declare function configureUi(options: {
+    color?: boolean;
+    quiet?: boolean;
+}): void;
+export declare const style: {
+    bold: (value: string) => string;
+    dim: (value: string) => string;
+    green: (value: string) => string;
+    yellow: (value: string) => string;
+    red: (value: string) => string;
+    cyan: (value: string) => string;
+    magenta: (value: string) => string;
+};
+export declare const glyph: {
+    ok: string;
+    warn: string;
+    fail: string;
+    skip: string;
+    arrow: string;
+    bullet: string;
+};
+export declare function out(line?: string): void;
+/** Always printed, even under `--quiet`: this is the answer the user asked for. */
+export declare function result(line?: string): void;
+export declare function json(value: unknown): void;
+export declare function heading(text: string): void;
+export declare function success(text: string): void;
+export declare function warn(text: string): void;
+export declare function info(text: string): void;
+/**
+ * Renders an error as headline, cause, and next action.
+ *
+ * Every failure in this tool is supposed to leave the user knowing what to do next, so the
+ * `Try:` block is part of the format rather than an optional extra.
+ */
+export declare function renderError(error: unknown, verbose: boolean): void;
+export declare function renderIssues(issues: readonly ValidationIssue[]): void;
+/** Left-aligned columns. Simpler and more predictable than wrapping in a narrow terminal. */
+export declare function table(rows: readonly (readonly string[])[], indent?: string): void;
+export declare function plural(count: number, singular: string, pluralForm?: string): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAa/E,wBAAgB,WAAW,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAG/E;AAMD,eAAO,MAAM,KAAK;kBACF,MAAM;iBACP,MAAM;mBACJ,MAAM;oBACL,MAAM;iBACT,MAAM;kBACL,MAAM;qBACH,MAAM;CACxB,CAAC;AAKF,eAAO,MAAM,KAAK;;;;;;;CAOjB,CAAC;AAEF,wBAAgB,GAAG,CAAC,IAAI,SAAK,GAAG,IAAI,CAEnC;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,IAAI,SAAK,GAAG,IAAI,CAEtC;AAED,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEzC;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAiClE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAarE;AAED,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,SAAO,GAAG,IAAI,CAoB/E;AAQD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAiB,GAAG,MAAM,CAE3F"}

package/dist/ui.js

@@ -0,0 +1,136 @@
+import colors from 'picocolors';
+import { isAgentSkillsError } from '@senior-skills/core';
+/**
+ * Terminal presentation.
+ *
+ * Kept apart from the commands so that every command can be read as "call a service, hand the
+ * result to a renderer" — and so `--json` is a different renderer rather than a branch
+ * threaded through business logic.
+ */
+let colorEnabled = true;
+let quiet = false;
+export function configureUi(options) {
+    if (options.color !== undefined)
+        colorEnabled = options.color;
+    if (options.quiet !== undefined)
+        quiet = options.quiet;
+}
+function paint(fn, value) {
+    return colorEnabled ? fn(value) : value;
+}
+export const style = {
+    bold: (value) => paint(colors.bold, value),
+    dim: (value) => paint(colors.dim, value),
+    green: (value) => paint(colors.green, value),
+    yellow: (value) => paint(colors.yellow, value),
+    red: (value) => paint(colors.red, value),
+    cyan: (value) => paint(colors.cyan, value),
+    magenta: (value) => paint(colors.magenta, value),
+};
+// ASCII fallbacks: Windows consoles in legacy code pages render box-drawing glyphs as noise.
+const unicode = process.platform !== 'win32' || process.env['WT_SESSION'] !== undefined;
+export const glyph = {
+    ok: unicode ? '✓' : '+',
+    warn: unicode ? '!' : '!',
+    fail: unicode ? '✗' : 'x',
+    skip: unicode ? '-' : '-',
+    arrow: unicode ? '→' : '->',
+    bullet: unicode ? '•' : '*',
+};
+export function out(line = '') {
+    if (!quiet)
+        process.stdout.write(`${line}\n`);
+}
+/** Always printed, even under `--quiet`: this is the answer the user asked for. */
+export function result(line = '') {
+    process.stdout.write(`${line}\n`);
+}
+export function json(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export function heading(text) {
+    out();
+    out(style.bold(text));
+    out();
+}
+export function success(text) {
+    out(`${style.green(glyph.ok)} ${text}`);
+}
+export function warn(text) {
+    out(`${style.yellow(glyph.warn)} ${text}`);
+}
+export function info(text) {
+    out(`${style.dim(glyph.bullet)} ${text}`);
+}
+/**
+ * Renders an error as headline, cause, and next action.
+ *
+ * Every failure in this tool is supposed to leave the user knowing what to do next, so the
+ * `Try:` block is part of the format rather than an optional extra.
+ */
+export function renderError(error, verbose) {
+    const stream = process.stderr;
+    if (!isAgentSkillsError(error)) {
+        stream.write(`${style.red('error')}  ${error instanceof Error ? error.message : String(error)}\n`);
+        if (verbose && error instanceof Error && error.stack !== undefined) {
+            stream.write(`\n${style.dim(error.stack)}\n`);
+        }
+        return;
+    }
+    stream.write(`\n${style.red('error')}  ${style.bold(error.message)}\n`);
+    if (error.details.length > 0) {
+        stream.write('\n');
+        for (const line of error.details)
+            stream.write(`  ${line}\n`);
+    }
+    if (error.hints.length > 0) {
+        stream.write(`\n  ${style.bold('Try:')}\n`);
+        for (const hint of error.hints)
+            stream.write(`    ${style.cyan(hint)}\n`);
+    }
+    stream.write(`\n  ${style.dim(`code: ${error.code}`)}\n\n`);
+    if (verbose && error.cause !== undefined) {
+        stream.write(`${style.dim('caused by:')}\n`);
+        stream.write(`${style.dim(String(error.cause instanceof Error ? (error.cause.stack ?? error.cause.message) : error.cause))}\n\n`);
+    }
+}
+export function renderIssues(issues) {
+    for (const issue of issues) {
+        const marker = issue.severity === 'error'
+            ? style.red(glyph.fail)
+            : issue.severity === 'warning'
+                ? style.yellow(glyph.warn)
+                : style.dim(glyph.bullet);
+        out(`  ${marker} ${style.bold(issue.at)}  ${issue.message}`);
+        if (issue.hint !== undefined)
+            out(`      ${style.dim(issue.hint)}`);
+        out(`      ${style.dim(issue.rule)}`);
+    }
+}
+/** Left-aligned columns. Simpler and more predictable than wrapping in a narrow terminal. */
+export function table(rows, indent = '  ') {
+    if (rows.length === 0)
+        return;
+    const widths = [];
+    for (const row of rows) {
+        row.forEach((cell, index) => {
+            widths[index] = Math.max(widths[index] ?? 0, stripAnsi(cell).length);
+        });
+    }
+    for (const row of rows) {
+        const line = row
+            .map((cell, index) => index === row.length - 1
+            ? cell
+            : cell + ' '.repeat((widths[index] ?? 0) - stripAnsi(cell).length))
+            .join('  ');
+        out(indent + line.trimEnd());
+    }
+}
+const ANSI_PATTERN = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, 'g');
+function stripAnsi(value) {
+    return value.replace(ANSI_PATTERN, '');
+}
+export function plural(count, singular, pluralForm = `${singular}s`) {
+    return `${count} ${count === 1 ? singular : pluralForm}`;
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

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

package/dist/update-notifications.d.ts

@@ -0,0 +1,19 @@
+import { type ApplySkillUpdates, type CheckUpdates, type SelectionPrompt, type ToolUpdater, type Logger } from '@senior-skills/core';
+import type { GlobalOptions } from './options.ts';
+export interface NotificationServices {
+    readonly check: Pick<CheckUpdates, 'execute' | 'dismiss' | 'remindLater'>;
+    readonly apply: Pick<ApplySkillUpdates, 'execute'>;
+    readonly tool: ToolUpdater;
+    readonly prompt: SelectionPrompt;
+    readonly logger: Logger;
+}
+export declare function shouldCheckUpdates(command: string, options: GlobalOptions & {
+    offline?: boolean;
+}, terminal: {
+    stdin: boolean;
+    stdout: boolean;
+    stderr: boolean;
+}, env: Readonly<Record<string, string | undefined>>): boolean;
+/** Returns true after replacing the CLI, so the old process stops before running a command. */
+export declare function showUpdateNotifications(services: NotificationServices, command: string, options: GlobalOptions, write?: (message: string) => void): Promise<boolean>;
+//# sourceMappingURL=update-notifications.d.ts.map