@inventarch/cli 0.0.0-stage → 1.0.0

package/dist/render.js

@@ -0,0 +1,277 @@
+/**
+ * Terminal presentation primitives for the consumer CLI: docs/specs/consumer-cli-contract/README.md §6.
+ * Everything here is pure. The environment is a parameter, so no function reads process.env, process.stdout or a clock.
+ */
+/** §6.4: 80 is the ceiling; below 40 a label/value block drops its value column; below 60 header pairs split. */
+export const MAX_WIDTH = 80;
+export const NARROW_WIDTH = 40;
+export const HEADER_WIDTH = 60;
+/** §6.4: a bare digest field shows 12 hex characters and an explicit ellipsis. */
+export const DIGEST_CHARACTERS = 12;
+const UTF8 = /utf-?8/i;
+const LOCALE_NAMES = ['LC_ALL', 'LC_CTYPE', 'LANG'];
+/** §6.7 colour precedence and §6.3's ASCII rule, resolved from an explicit environment rather than from the process. */
+export function resolveCapabilities(terminal, flags = {}) {
+    const env = terminal.env, force = env['FORCE_COLOR'];
+    const color = env['NO_COLOR'] !== undefined
+        ? false
+        : flags.color === false
+            ? false
+            : flags.json === true
+                ? false
+                : flags.color === true || (force !== undefined && force !== '0')
+                    ? true
+                    : terminal.isTTY && env['TERM'] !== 'dumb';
+    const locales = LOCALE_NAMES.map((name) => env[name]).filter((value) => value !== undefined);
+    const ascii = flags.ascii === true ||
+        env['IA_ASCII'] !== undefined ||
+        (locales.length > 0 && !locales.some((value) => UTF8.test(value)));
+    const columns = terminal.columns;
+    const sized = terminal.isTTY && typeof columns === 'number' && Number.isInteger(columns) && columns > 0;
+    return { color, ascii, width: sized ? Math.min(columns, MAX_WIDTH) : MAX_WIDTH };
+}
+const SGR = { bold: '1', dim: '2', red: '31', yellow: '33', green: '32', cyan: '36' };
+/** §6.1: a styled run is reset at its end and never left open across a newline, so each line is styled on its own. */
+export function style(text, role, color) {
+    if (!color || !role)
+        return text;
+    return text
+        .split('\n')
+        .map((line) => (line === '' ? line : `\u001b[${SGR[role]}m${line}\u001b[0m`))
+        .join('\n');
+}
+const SYMBOLS = {
+    success: { unicode: '✔', ascii: '[ok]', role: 'green' },
+    error: { unicode: '✖', ascii: '[error]', role: 'red' },
+    warning: { unicode: '▲', ascii: '[warn]', role: 'yellow' },
+    unknown: { unicode: '?', ascii: '[?]', role: null },
+    info: { unicode: '•', ascii: '*', role: null },
+    step: { unicode: '→', ascii: '->', role: null },
+    added: { unicode: '+', ascii: '+', role: 'green' },
+    removed: { unicode: '-', ascii: '-', role: null },
+    updated: { unicode: '~', ascii: '~', role: null },
+};
+/** Every symbol is one UTF-16 unit per display column, so length is the declared §6.3 width; no emoji is admitted. */
+export function statusSymbol(name, ascii) {
+    const definition = SYMBOLS[name], text = ascii ? definition.ascii : definition.unicode;
+    return { text, width: text.length, role: definition.role };
+}
+/** One unbreakable run: an identity, path, package id, digest, URL or a command that must stay copy-pasteable. */
+export const atom = (text, role = null, gap = 1) => ({ text, gap, role });
+/** Prose, split at word boundaries; runs of spaces inside the text are preserved as wider gaps. */
+export function words(text, role = null, gap = 1) {
+    const tokens = [];
+    let pending = 0;
+    for (const part of text.split(' ')) {
+        if (part === '') {
+            if (tokens.length > 0)
+                pending += 1;
+            continue;
+        }
+        tokens.push({ text: part, gap: tokens.length === 0 ? gap : pending + 1, role });
+        pending = 0;
+    }
+    return tokens;
+}
+/**
+ * §6.4: words wrap at the effective width; a token is never split, so an over-wide identifier overruns its line whole.
+ * `firstColumn` differs from `column` only where a value starts past its label and then hangs back at rule 3's column.
+ */
+export function wrapTokens(tokens, column, caps, firstColumn = column) {
+    const lines = [];
+    let plain = '', styled = '', open = false;
+    for (const token of tokens) {
+        const text = style(token.text, token.role, caps.color);
+        if (!open) {
+            plain = token.text;
+            styled = text;
+            open = true;
+            continue;
+        }
+        const gap = ' '.repeat(token.gap);
+        if ((lines.length === 0 ? firstColumn : column) + plain.length + gap.length + token.text.length <= caps.width) {
+            plain += gap + token.text;
+            styled += gap + text;
+            continue;
+        }
+        lines.push(styled);
+        plain = token.text;
+        styled = text;
+    }
+    if (open)
+        lines.push(styled);
+    return lines;
+}
+/** §6.4 rule 1. */
+export const indentOf = (depth) => 2 * depth;
+/** The widest symbol of a block, which rule 2 measures the whole block's content column from. */
+export const blockSymbolWidth = (names, ascii) => Math.max(0, ...names.map((name) => (name === undefined ? 0 : statusSymbol(name, ascii).width)));
+/** §6.4 rule 2: `2·d + width + 2`, where width is the block's widest symbol and never less than this row's own. */
+export const contentColumn = (base, symbol, symbolWidth = 0) => base + (symbol === null ? 0 : Math.max(symbolWidth, symbol.width) + 2);
+export const entryColumn = (options, ascii) => contentColumn(options.column ?? indentOf(options.depth ?? 0), options.symbol === undefined ? null : statusSymbol(options.symbol, ascii), options.symbolWidth ?? 0);
+/**
+ * One entry: block indent, the status symbol, two spaces, then its facts. §6.4 rule 3 hangs every continuation —
+ * a wrapped line or a further fact — at the entry's content column.
+ */
+export function entry(facts, options, caps) {
+    const base = options.column ?? indentOf(options.depth ?? 0);
+    const symbol = options.symbol === undefined ? null : statusSymbol(options.symbol, caps.ascii);
+    const column = contentColumn(base, symbol, options.symbolWidth ?? 0);
+    const prefix = ' '.repeat(base) +
+        (symbol === null ? '' : style(symbol.text, symbol.role, caps.color) + ' '.repeat(column - base - symbol.width));
+    const hanging = ' '.repeat(column);
+    const lines = facts.flatMap((fact) => wrapTokens(fact, column, caps));
+    return lines.map((line, index) => (index === 0 ? prefix : hanging) + line);
+}
+/**
+ * §6.4 rule 4: one value column per block at `max(len(label)) + 2`, never shared across a blank line, over the one
+ * content column rule 2 gives the block. A value that wraps hangs at the entry's content column, which is rule 3 and
+ * not the value column. Below 40 columns, or when the padding would leave no room for a value, the block drops the
+ * value column and each field renders as `label  value`.
+ */
+export function fieldRows(fields, options, caps) {
+    const pad = Math.max(0, ...fields.map((field) => field.label.length)) + 2;
+    const base = options.column ?? indentOf(options.depth ?? 0);
+    const symbolWidth = blockSymbolWidth(fields.map((field) => field.symbol), caps.ascii);
+    const column = base + (symbolWidth === 0 ? 0 : symbolWidth + 2);
+    const degraded = caps.width < NARROW_WIDTH || column + pad >= caps.width;
+    return fields.flatMap((field) => {
+        const placement = { ...options, symbol: field.symbol, symbolWidth };
+        const symbol = field.symbol === undefined ? null : statusSymbol(field.symbol, caps.ascii);
+        const prefix = ' '.repeat(base) +
+            (symbol === null ? '' : style(symbol.text, symbol.role, caps.color) + ' '.repeat(column - base - symbol.width));
+        const value = degraded ? [] : wrapTokens(field.value, column, caps, column + pad);
+        const rows = degraded
+            ? entry([
+                [
+                    atom(field.label, null, 0),
+                    ...field.value.map((token, index) => (index === 0 ? { ...token, gap: 2 } : token)),
+                ],
+            ], placement, caps)
+            : value.length === 0
+                ? [prefix + field.label]
+                : value.map((line, index) => (index === 0 ? prefix + field.label.padEnd(pad) : ' '.repeat(column)) + line);
+        return field.action ? [...rows, ...entry([field.action], { column, symbol: 'step' }, caps)] : rows;
+    });
+}
+/** §6.4 rule 5: bold label, two spaces, value; further pairs share the line until the width drops below 60. */
+export function headerLine(label, value, trailing, caps) {
+    const head = style(label, 'bold', caps.color) + '  ' + value;
+    if (caps.width < HEADER_WIDTH)
+        return [head, ...trailing.map((item) => item.text)];
+    let visible = label.length + 2 + value.length, line = head;
+    for (const item of trailing) {
+        const start = Math.max(item.column ?? visible + 4, visible + 4);
+        line += ' '.repeat(start - visible) + item.text;
+        visible = start + item.text.length;
+    }
+    return [line];
+}
+export const sectionLabel = (text, caps) => style(text, 'bold', caps.color);
+/** §6.4 rule 6: exactly one blank line between blocks, never two, and no trailing blank before the process exits. */
+export function document(blocks, options = {}) {
+    const body = blocks
+        .filter((block) => block.length > 0)
+        .map((block) => block.join('\n'))
+        .join('\n\n');
+    if (body === '')
+        return '';
+    return (options.leadingBlank === true ? '\n' : '') + body + '\n';
+}
+/**
+ * One argument of a printed command, quoted only when a space or a quote would split or end it, so an invocation
+ * rebuilt from parsed arguments is the one a reader can paste back.
+ */
+export const quote = (value) => (/[ "]/.test(value) ? JSON.stringify(value) : value);
+/** §6.4: a command is unbreakable prose. The caller chooses the `\` break so every line stays runnable. */
+export function commandFacts(lead, command, tail, column, caps) {
+    const lines = [];
+    let current = '';
+    for (const piece of command.split(' ')) {
+        // The lead is glued to the first word, so the quoted command starts where the quote ends.
+        const candidate = current === '' ? lead + piece : `${current} ${piece}`;
+        if (current !== '' && column + candidate.length + 2 > caps.width) {
+            lines.push(`${current} \\`);
+            current = piece;
+        }
+        else
+            current = candidate;
+    }
+    lines.push(current + tail);
+    return lines.map((line) => [atom(line, null, 0)]);
+}
+const BARE_DIGEST = /^[0-9a-f]+$/i;
+/**
+ * §6.4: only a bare digest field is truncated. A value carrying a path, URL or any other separator is returned whole,
+ * because truncating a digest inside an identifier destroys the identifier.
+ */
+export const truncateDigest = (value, ascii) => value.length > DIGEST_CHARACTERS && BARE_DIGEST.test(value)
+    ? value.slice(0, DIGEST_CHARACTERS) + (ascii ? '...' : '…')
+    : value;
+/**
+ * §6.5: strip what the block already shows. Findings embed `path:line: identity: `; RuntimeError and DbError embed
+ * `code: `; DistributionError embeds nothing. Without this, two of the three families print their code twice.
+ */
+export function stripMessage(message, context) {
+    let text = message;
+    for (const prefix of [context.location, context.identity, context.code]) {
+        if (prefix && text.startsWith(prefix + ': '))
+            text = text.slice(prefix.length + 2);
+    }
+    return text;
+}
+/** §6.5: location, identity, cause, next action, in that order, with nothing interleaved. */
+export function errorBlock(error, options, caps) {
+    const placement = {
+        ...options,
+        symbol: error.severity ?? 'error',
+        ...(error.symbolWidth === undefined ? {} : { symbolWidth: error.symbolWidth }),
+    };
+    const location = error.location === null || error.location === '' ? '(whole workspace)' : error.location;
+    const head = [atom(location, 'cyan', 0)];
+    if (error.check)
+        head.push(atom(error.check, null, 2));
+    const facts = [head];
+    if (error.identity)
+        facts.push([atom(error.identity, 'cyan', 0)]);
+    // §6.1 colours a warning code yellow and an error code red; the element order is the same either way.
+    const codeRole = error.severity === 'warning' ? 'yellow' : 'red';
+    facts.push([atom(error.code, codeRole, 0), ...words(stripMessage(error.message, error), null, 2)]);
+    const lines = [...entry(facts, placement, caps)];
+    if (error.next)
+        lines.push(...entry([error.next], { column: entryColumn(placement, caps.ascii), symbol: 'step' }, caps));
+    return lines;
+}
+/**
+ * §6.6: progress lives on the sink the caller supplies, which is stderr — never structured stdout. It is rewritten in
+ * place only on a TTY, degrades to one appended line per phase otherwise, is erased before the result is written, and
+ * never carries the completion: `done` always emits a terminal state line as text.
+ */
+export function createProgress(sink, options) {
+    let pending = false;
+    const clear = () => {
+        if (pending && sink.isTTY)
+            sink.write('\r\u001b[K');
+        pending = false;
+    };
+    return {
+        phase: (text) => {
+            if (!options.enabled)
+                return;
+            if (!sink.isTTY) {
+                sink.write(text + '\n');
+                return;
+            }
+            clear();
+            sink.write(text);
+            pending = true;
+        },
+        clear,
+        done: (text) => {
+            clear();
+            if (options.enabled)
+                sink.write(text + '\n');
+        },
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Opening a workspace for a consumer verb: docs/specs/consumer-cli-contract/README.md §2.0 and §3.
+ *
+ * The open is the one step every workspace verb shares and the one that decides class 3 rather than class 1:
+ * a root that cannot be read produced no finding set, so it is a refusal and never a diagnostic. The service's
+ * own code is carried through unchanged (§4.1); only the next action is the CLI's.
+ */
+import { openWorkspaceSession } from '@inventarch/distribution/services';
+export type Session = ReturnType<typeof openWorkspaceSession>;
+export declare const codeOf: (error: unknown, fallback: string) => string;
+/** §2.5: IA-DB-SOURCE-UNAVAILABLE here means an interrupted installation blocks the read, not a bad path. */
+export declare function openSession(root: string): Session;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAGzE,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAE9D,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,KAAG,MAG5C,CAAC;AAEf,6GAA6G;AAC7G,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAejD"}

package/dist/session.js

@@ -0,0 +1,25 @@
+/**
+ * Opening a workspace for a consumer verb: docs/specs/consumer-cli-contract/README.md §2.0 and §3.
+ *
+ * The open is the one step every workspace verb shares and the one that decides class 3 rather than class 1:
+ * a root that cannot be read produced no finding set, so it is a refusal and never a diagnostic. The service's
+ * own code is carried through unchanged (§4.1); only the next action is the CLI's.
+ */
+import { openWorkspaceSession } from '@inventarch/distribution/services';
+import { Refusal } from './consumer.js';
+export const codeOf = (error, fallback) => error !== null && typeof error === 'object' && 'code' in error && typeof error.code === 'string'
+    ? error.code
+    : fallback;
+/** §2.5: IA-DB-SOURCE-UNAVAILABLE here means an interrupted installation blocks the read, not a bad path. */
+export function openSession(root) {
+    try {
+        return openWorkspaceSession({ root });
+    }
+    catch (error) {
+        const code = codeOf(error, 'IA-DB-ROOT-INVALID');
+        throw new Refusal(code, error instanceof Error ? error.message : String(error), 3, { path: root }, code === 'IA-DB-SOURCE-UNAVAILABLE'
+            ? `An interrupted installation blocks the read. Run "ia-distribution recover --root ${root}".`
+            : 'Pass --root <path> with an existing workspace, or run "ia init" to see what a new one would contain.');
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIxC,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,QAAgB,EAAU,EAAE,CACjE,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;IAC9F,CAAC,CAAC,KAAK,CAAC,IAAI;IACZ,CAAC,CAAC,QAAQ,CAAC;AAEf,6GAA6G;AAC7G,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;QACjD,MAAM,IAAI,OAAO,CACf,IAAI,EACJ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACtD,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,EACd,IAAI,KAAK,0BAA0B;YACjC,CAAC,CAAC,oFAAoF,IAAI,IAAI;YAC9F,CAAC,CAAC,sGAAsG,CAC3G,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/user-host.d.ts

@@ -0,0 +1,59 @@
+import type { PluginFile } from '@inventarch/compliance';
+import type { Channel } from './channel.js';
+import type { ClaudeRunner } from './claude-cli.js';
+import type { Context, Result } from './consumer.js';
+export interface UserHostView {
+    readonly host: 'claude';
+    readonly remove: boolean;
+    readonly home: string;
+    readonly marketplace: string;
+    readonly plugin: {
+        readonly version: string;
+        readonly cli: string;
+        readonly channel: Channel['kind'];
+    };
+    /** The plugin already materialized in the IA home, read from its own metadata; null when absent or unreadable. */
+    readonly installed: {
+        readonly version: string;
+    } | null;
+    /** Whether `claude` can be run. Without it the commands are printed, not run. */
+    readonly claude: boolean;
+    /** Claude CLI argument vectors, in the order apply runs them. */
+    readonly commands: readonly (readonly string[])[];
+    readonly files: readonly PluginFile[];
+}
+/** §6.2 (amended): the digest is of the files rendered with a placeholder version, so it changes whenever the renderer's output does. */
+export declare function buildClaudePlugin(input: {
+    readonly cliVersion: string;
+    readonly channel: Channel;
+    readonly entry: string;
+}): {
+    readonly version: string;
+    readonly files: readonly PluginFile[];
+};
+/** A Claude command as a reader can paste it back. */
+export declare const claudeCommand: (command: readonly string[]) => string;
+/**
+ * §7.1's plan. It reads the IA home and asks `claude` what it lists; it writes nothing. `claude` is first run (the
+ * availability probe) only after every usage check and refusal has passed, so a class-2 invocation does no work
+ * (contract §3). The runner is returned so apply reuses it instead of probing again.
+ */
+export declare function collectUserHost(context: Context, runnerFor?: (env: Readonly<Record<string, string | undefined>>) => ClaudeRunner): {
+    readonly view: UserHostView;
+    readonly runner: ClaudeRunner;
+};
+export interface UserHostApplied {
+    /** `plugin-directory-removed`: a removal without `claude`, so only the directory went and the commands are printed. */
+    readonly status: 'plugin-registered' | 'plugin-materialized' | 'plugin-removed' | 'plugin-directory-removed';
+    /** The Claude commands that ran and exited 0, in order. Empty when `claude` was unavailable. */
+    readonly ran: readonly (readonly string[])[];
+}
+/**
+ * §6.3: materialize, then register through `claude`; removal runs `claude` first and deletes the directory last, so a
+ * failed uninstall leaves the marketplace Claude still points at. A failing command refuses naming itself and the
+ * rerun, and the commands before it have run. A rerun converges: registration repeats two idempotent commands, and
+ * removal asks claude again what is left (§2.3).
+ */
+export declare function applyUserHost(view: UserHostView, runner: ClaudeRunner): UserHostApplied;
+export declare function runUserHost(context: Context): Promise<Result>;
+//# sourceMappingURL=user-host.d.ts.map

package/dist/user-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-host.d.ts","sourceRoot":"","sources":["../src/user-host.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAWzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAMrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;IACvG,kHAAkH;IAClH,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,yIAAyI;AACzI,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,GAAG;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC,CAaA;AAID,sDAAsD;AACtD,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAqD,CAAC;AAEjH;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,SAAS,GAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,KAAK,YAA2B,GAC5F;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CA2ChE;AAiCD,MAAM,WAAW,eAAe;IAC9B,uHAAuH;IACvH,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,qBAAqB,GAAG,gBAAgB,GAAG,0BAA0B,CAAC;IAC7G,gGAAgG;IAChG,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAC9C;AACD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CAyBvF;AAsFD,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BnE"}

package/dist/user-host.js

@@ -0,0 +1,228 @@
+/**
+ * `ia host <host> --user`: docs/specs/host-plugin-distribution/README.md §6.3 (amended, item 5) and §7.1.
+ *
+ * Needs no workspace. Plans by default and writes nothing while planning; `--apply` renders the plugin, swaps it into
+ * the IA home's marketplace directory, then runs Claude's own `claude plugin …` commands. Without `claude` it
+ * materializes and prints the commands. It never reads or edits Claude's settings files. A service refusal keeps its
+ * code and message (contract §4.1) and gains the next action the CLI can supply, as `ia host` does.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { renderClaudePlugin } from '@inventarch/compliance';
+import { hostRow } from '@inventarch/distribution/hosts';
+import { assertIaHomeUsable } from '@inventarch/distribution/ia-home';
+import { MARKETPLACE_DIR, materializeMarketplace, readMaterializedPlugin, removeMarketplace, } from '@inventarch/distribution/plugin-home';
+import { UsageError } from './args.js';
+import { detectChannel, updateInstruction } from './channel.js';
+import { claudeRunner, observeClaude, registrationCommands, removalCommands } from './claude-cli.js';
+import { confirm, Refusal, refusalOf } from './consumer.js';
+import { homeSrcRemedy, hostHome, located } from './home-remedy.js';
+import { blockSymbolWidth, commandFacts, document, entry, headerLine, indentOf, quote, words } from './render.js';
+/** §6.2 (amended): the digest is of the files rendered with a placeholder version, so it changes whenever the renderer's output does. */
+export function buildClaudePlugin(input) {
+    const base = {
+        cliVersion: input.cliVersion,
+        channel: input.channel.kind,
+        entry: input.entry,
+        install: updateInstruction(input.channel),
+    };
+    const draft = renderClaudePlugin({ ...base, version: '0.0.0' });
+    const digest = createHash('sha256')
+        .update(draft.map((file) => `${file.path}\0${file.text}`).join('\0'))
+        .digest('hex');
+    const version = `${input.cliVersion}+${digest.slice(0, 12)}`;
+    return { version, files: renderClaudePlugin({ ...base, version }) };
+}
+/** The rerun a next action names; the only user-level host is Claude. */
+const rerunOf = (remove) => `ia host claude --user${remove ? ' --remove' : ''} --apply`;
+/** A Claude command as a reader can paste it back. */
+export const claudeCommand = (command) => ['claude', ...command].map(quote).join(' ');
+/**
+ * §7.1's plan. It reads the IA home and asks `claude` what it lists; it writes nothing. `claude` is first run (the
+ * availability probe) only after every usage check and refusal has passed, so a class-2 invocation does no work
+ * (contract §3). The runner is returned so apply reuses it instead of probing again.
+ */
+export function collectUserHost(context, runnerFor = claudeRunner) {
+    const { args, host } = context;
+    const name = args.positionals[0] ?? '';
+    // §4: the adapter table decides. Unknown is usage, and so is --root (§7.1); both precede every read.
+    const row = hostRow(name);
+    if (row === undefined)
+        throw new UsageError(`ia host takes claude, codex or cursor; got ${name}`);
+    if (args.value('root') !== undefined)
+        throw new UsageError('--root does not apply with --user; the user-level entry point belongs to no workspace');
+    // §4: a row without a user-level entry point — Codex (partial) and Cursor (planned) — refuses naming the host.
+    if (row.user === 'none')
+        throw new Refusal('IA-DIST-HOST-UNSUPPORTED', `${row.label} has no user-level entry point in this release; nothing was written`, 3, null, 'Run "ia host claude --user".');
+    const home = hostHome(host.env);
+    // Host plugin distribution spec §3: refuse a home that looks like a workspace now, before apply attempts a write.
+    located(null, homeSrcRemedy(home), () => assertIaHomeUsable(home));
+    const channel = detectChannel(host.packageRoot);
+    const plugin = buildClaudePlugin({
+        cliVersion: host.version,
+        channel,
+        entry: resolve(host.packageRoot, 'dist/main.js'),
+    });
+    const marketplace = resolve(home, MARKETPLACE_DIR);
+    const remove = args.flag('remove');
+    const installed = readMaterializedPlugin(home);
+    const runner = runnerFor(host.env);
+    const view = {
+        host: 'claude',
+        remove,
+        home,
+        marketplace,
+        plugin: { version: plugin.version, cli: host.version, channel: channel.kind },
+        installed: installed === null ? null : { version: installed.version },
+        claude: runner.available,
+        // §2.3: registration is idempotent and needs no observation; removal asks claude what exists.
+        commands: remove ? removalCommands(observeClaude(runner)) : registrationCommands(marketplace),
+        files: plugin.files,
+    };
+    return { view, runner };
+}
+/**
+ * A marketplace refusal from `@inventarch/distribution/plugin-home`, its code and message kept, located at the IA home's
+ * `claude` directory (which holds the marketplace and its lock) and given a next action. Anything without an IA-DIST
+ * code is not the service's refusal and passes through unchanged.
+ */
+function marketplaceRefusal(error, view) {
+    const refusal = refusalOf(error);
+    if (!refusal.code.startsWith('IA-DIST-'))
+        return error;
+    const directory = join(view.home, 'claude'), rerun = rerunOf(view.remove);
+    const next = refusal.code === 'IA-DIST-INSTALL-BUSY'
+        ? // Two causes share the code: files held open during a rename, and another run holding the lock.
+            `Wait for any other "ia host --user" run to finish and close Claude Code sessions, editors or terminals using ${directory}; if no run is active, delete ${join(directory, '.lock')}; then rerun "${rerun}".`
+        : refusal.code === 'IA-DIST-RECOVERY-REQUIRED'
+            ? `Rerun "${rerun}".`
+            : refusal.code === 'IA-DIST-PATH-UNSAFE' && existsSync(join(view.home, 'src'))
+                ? homeSrcRemedy(view.home)
+                : refusal.code === 'IA-DIST-INPUT-INVALID'
+                    ? `Check the permissions of ${directory}, then rerun "${rerun}".`
+                    : refusal.next;
+    return new Refusal(refusal.code, refusal.message, 3, refusal.where ?? { path: directory }, next);
+}
+function marketplaceStep(view, run) {
+    try {
+        return run();
+    }
+    catch (error) {
+        throw marketplaceRefusal(error, view);
+    }
+}
+/**
+ * §6.3: materialize, then register through `claude`; removal runs `claude` first and deletes the directory last, so a
+ * failed uninstall leaves the marketplace Claude still points at. A failing command refuses naming itself and the
+ * rerun, and the commands before it have run. A rerun converges: registration repeats two idempotent commands, and
+ * removal asks claude again what is left (§2.3).
+ */
+export function applyUserHost(view, runner) {
+    if (!view.remove)
+        marketplaceStep(view, () => materializeMarketplace(view.home, view.files));
+    const ran = [];
+    if (view.claude)
+        for (const command of view.commands) {
+            const result = runner.run(command);
+            if (result.status !== 0)
+                throw new Refusal('IA-CLI-HOST-COMMAND-FAILED', `${claudeCommand(command)} exited ${result.status ?? 'without a status'}: ${result.output || 'no output'}`, 3, null, `Run "${claudeCommand(command)}" yourself to see why, then rerun "${rerunOf(view.remove)}".`);
+            ran.push([...command]);
+        }
+    if (view.remove)
+        marketplaceStep(view, () => removeMarketplace(view.home));
+    const status = view.remove
+        ? view.claude
+            ? 'plugin-removed'
+            : 'plugin-directory-removed'
+        : view.claude
+            ? 'plugin-registered'
+            : 'plugin-materialized';
+    return { status, ran };
+}
+/** §7.1 `--json`: the plan always, and `applied` only after an apply. The rendered files are not part of it. */
+const envelope = (view, applied) => ({
+    version: 1,
+    command: 'host',
+    user: true,
+    host: view.host,
+    apply: applied !== null,
+    plan: {
+        remove: view.remove,
+        home: view.home,
+        marketplace: view.marketplace,
+        plugin: view.plugin,
+        installed: view.installed,
+        claude: view.claude,
+        commands: view.commands,
+    },
+    ...(applied === null ? {} : { applied }),
+});
+const DONE = {
+    'plugin-registered': 'Registered: the plugin is written and each claude command exited 0. Claude Code loads it at its next session start.',
+    'plugin-materialized': 'Written; not registered with Claude.',
+    'plugin-removed': 'Removed: each claude command exited 0 and the plugin directory is deleted.',
+    'plugin-directory-removed': 'Deleted the plugin directory; not removed from Claude.',
+};
+const unavailable = (view, applied) => applied
+    ? 'claude could not be run: run the claude commands above by hand.'
+    : `claude could not be run: apply ${view.remove ? 'deletes the directory' : 'writes the plugin'}, and the claude commands above must then be run by hand.`;
+/** The content column of a depth-1 step (§6.4 rule 2), so a wrapped command breaks within the width. */
+const STEP_COLUMN = (caps) => indentOf(1) + blockSymbolWidth(['step'], caps.ascii) + 2;
+const summary = (view, context, applied = false) => {
+    const { caps } = context;
+    return [
+        [
+            ...headerLine('Plan', `host claude --user${view.remove ? ' --remove' : ''}`, [], caps),
+            ...headerLine('Home', view.home, [], caps),
+        ],
+        [
+            ...(view.remove
+                ? []
+                : entry([words(`Write the plugin ${view.plugin.version} to ${view.marketplace}`)], { depth: 1, symbol: 'step' }, caps)),
+            ...view.commands.flatMap((command) => entry(commandFacts('', claudeCommand(command), '', STEP_COLUMN(caps), caps), { depth: 1, symbol: 'step' }, caps)),
+            ...(view.remove ? entry([words(`Delete ${view.marketplace}`)], { depth: 1, symbol: 'step' }, caps) : []),
+        ],
+        ...(view.claude ? [] : [entry([words(unavailable(view, applied))], { depth: 1, symbol: 'warning' }, caps)]),
+    ];
+};
+function render(view, applied, context) {
+    const { caps } = context;
+    const [header, ...rest] = summary(view, context, applied !== null);
+    return document([
+        header,
+        applied === null
+            ? entry([words('This is a preview. Nothing has been written.')], { depth: 1 }, caps)
+            : entry([words(DONE[applied.status])], { depth: 1, symbol: 'success' }, caps),
+        ...rest,
+        ...(applied === null
+            ? [
+                entry(commandFacts('Apply with "', `${rerunOf(view.remove)} --yes`, '".', 3, caps), { depth: 0, symbol: 'step' }, caps),
+            ]
+            : []),
+    ], { leadingBlank: true });
+}
+const CONFIRMATION = 'Install the InventArch plugin? [y/N] ';
+const REMOVAL_CONFIRMATION = 'Remove the InventArch plugin? [y/N] ';
+export async function runUserHost(context) {
+    const { args, caps, host, json } = context;
+    const { view, runner } = collectUserHost(context);
+    const done = (applied) => json
+        ? { exitCode: 0, stdout: JSON.stringify(envelope(view, applied)) + '\n', stderr: '' }
+        : { exitCode: 0, stdout: render(view, applied, context), stderr: '' };
+    if (!args.flag('apply'))
+        return done(null);
+    // §2.8 rule 3. Parsing has already refused every --apply whose question cannot be asked or answered.
+    if (!args.flag('yes') &&
+        !(await confirm(host.interaction, document(summary(view, context), { leadingBlank: true }), view.remove ? REMOVAL_CONFIRMATION : CONFIRMATION)))
+        return {
+            exitCode: 0,
+            stdout: document([entry([words('Nothing was applied.')], { depth: 0, symbol: 'info' }, caps)], {
+                leadingBlank: true,
+            }),
+            stderr: '',
+        };
+    host.signal?.throwIfAborted();
+    return done(applyUserHost(view, runner));
+}
+//# sourceMappingURL=user-host.js.map