@raidiant/notifai 11.7.1 → 12.0.0-beta.11

package/dist/skill-source/notifai/references/writing-examples.md

@@ -1,56 +0,0 @@
-# Writing examples
-
-Examples for the shipped `titles`, `content`, and `acknowledgements` guidance.
-The effective guidance printed by `notifai guidance` always wins over them.
-
-## Titles
-
-Good:
-
-- `Users can now create accounts` — the capability, not the process behind it
-- `Password reset emails aren't sending` — the failure as the user experiences it
-- `Refund rollout awaits provider recovery` — what is stuck, not machinery
-- `Found why checkout was flaky` — the finding they were waiting on
-- `3 orders didn't import and need review` — a count that earns its place
-  because acting on it is theirs to do
-
-Bad:
-
-- `All 42 tests passed` — machinery; say what work is done
-- `Adversarial review found 3 issues` — process report; say what it means for
-  what ships
-- `Migration 0007 failed` — internal identifier; say what the user lost
-- `Task complete` / `Build failed` / `Need input` — no substance, and the
-  kind restated
-- `Exit code 1` — mechanics, not meaning
-
-## Content
-
-Work finished:
-
-> Account creation works end to end now: sign-up, email verification, and
-> login are live on staging.
->
-> Next I'll start on password reset unless you want something else first.
-
-Work failed:
-
-> The new pricing page isn't live. The deploy failed and I rolled it back, so
-> the site still shows the old page — nothing is broken for users.
->
-> The blocker is on my side and I'm fixing it; I'll retry and confirm when the
-> page is up. Nothing needed from you.
-
-Blocked:
-
-> The refund flow is built, but the production rollout is waiting for the
-> payment provider to recover. I am monitoring it and will resume automatically.
->
-> There is nothing for you to answer; I will confirm when it is live.
-
-## Acknowledgements
-
-- A note: `Switching the migration to staging; I'll rerun it there.`
-- An edit after irreversible work: `The email already went out with Monday;
-  sending a correction for Friday now.` — say what already happened; never
-  imply it was undone.

package/dist/sound-ref.d.ts

@@ -1,23 +0,0 @@
-/**
- * What `--sound` and the saved `sound` key accept: shipped semantic names,
- * the CLI silent spelling, an Account custom sound id, or a custom display name.
- */
-export declare function isCliSoundRef(value: string): boolean;
-export declare function unknownSoundMessage(sound: string): string;
-/** Shipped names plus the CLI silent spelling, with User-facing labels. */
-export declare const SHIPPED_SOUND_LISTING: readonly [{
-    readonly ref: "default";
-    readonly name: "Device default";
-}, {
-    readonly ref: "done";
-    readonly name: "completion chime";
-}, {
-    readonly ref: "attention";
-    readonly name: "attention tone";
-}, {
-    readonly ref: "alert";
-    readonly name: "most insistent tone";
-}, {
-    readonly ref: "none";
-    readonly name: "silent";
-}];

package/dist/sound-ref.js

@@ -1,28 +0,0 @@
-import { CLI_SOUNDS, SOUND_NAME_MAX_LENGTH, SOUND_REF_MAX_LENGTH, isCustomSoundId, } from '@raidiant/notifai-protocol';
-/**
- * What `--sound` and the saved `sound` key accept: shipped semantic names,
- * the CLI silent spelling, an Account custom sound id, or a custom display name.
- */
-export function isCliSoundRef(value) {
-    if (CLI_SOUNDS.includes(value))
-        return true;
-    if (value.length < 1 || value.length > SOUND_REF_MAX_LENGTH)
-        return false;
-    if (isCustomSoundId(value))
-        return true;
-    const trimmed = value.trim();
-    return trimmed.length >= 1 && trimmed.length <= SOUND_NAME_MAX_LENGTH;
-}
-export function unknownSoundMessage(sound) {
-    return (`Unknown sound "${sound}" — use a shipped name (${CLI_SOUNDS.join(', ')}), ` +
-        'a custom sound id, or a custom sound name. Run `notifai sounds` to list what this Account can play.');
-}
-/** Shipped names plus the CLI silent spelling, with User-facing labels. */
-export const SHIPPED_SOUND_LISTING = [
-    { ref: 'default', name: 'Device default' },
-    { ref: 'done', name: 'completion chime' },
-    { ref: 'attention', name: 'attention tone' },
-    { ref: 'alert', name: 'most insistent tone' },
-    { ref: 'none', name: 'silent' },
-];
-//# sourceMappingURL=sound-ref.js.map

package/dist/sound-ref.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sound-ref.js","sourceRoot":"","sources":["../src/sound-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,4BAA4B,CAAA;AAEnC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAK,UAAgC,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAClE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,oBAAoB;QAAE,OAAO,KAAK,CAAA;IACzE,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,qBAAqB,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,CACL,kBAAkB,KAAK,2BAA2B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;QAC5E,qGAAqG,CACtG,CAAA;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC1C,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE;IACzC,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAC5C,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE;IAC7C,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;CACvB,CAAA"}

package/dist/ui/banner.d.ts

@@ -1,22 +0,0 @@
-export type BannerSize = 'block' | 'ascii' | 'word';
-export declare function bannerSize(columns?: number): BannerSize;
-/** The wordmark as rendered lines, gradient included. */
-export declare function bannerLines(columns?: number): string[];
-/**
- * Reveal the wordmark one row at a time.
- *
- * Deliberately brief and deliberately skippable: this runs before someone can
- * do anything, so it may not become a wait. It is skipped entirely when output
- * is not a TTY, when `NOTIFAI_NO_ANIMATION` is set, and under `CI`.
- */
-export declare function printBanner(options?: {
-    animate?: boolean;
-    env?: NodeJS.ProcessEnv;
-    write?: (line: string) => void;
-}): Promise<void>;
-/**
- * One line of orientation under the wordmark — and it must stay one line.
- * Wrapped onto two it stops reading as a subtitle and starts reading as the
- * first paragraph of something, so a narrow terminal gets the version alone.
- */
-export declare function tagline(version: string, columns?: number): string;

package/dist/ui/banner.js

@@ -1,87 +0,0 @@
-/**
- * The wordmark shown when a human opens the interactive app.
- *
- * Three tiers, chosen by what the terminal can actually render rather than by
- * what looks best in a screenshot: box-drawing blocks when the terminal is wide
- * and Unicode-capable, a pure-ASCII form that survives anywhere, and a plain
- * word when neither fits. A banner that wraps is worse than no banner, so the
- * width check is not optional.
- *
- * The art is embedded rather than rendered at run time. It is one fixed word
- * that will never change, and shipping a font engine to redraw a constant on
- * every launch would cost every install — including the agents that never see
- * it — for no benefit.
- */
-import { gradientBlock, style, terminalWidth, unicode } from './theme.js';
-/** ANSI Shadow. 50 columns, 6 rows. */
-const BLOCK = [
-    '███╗   ██╗ ██████╗ ████████╗██╗███████╗ █████╗ ██╗',
-    '████╗  ██║██╔═══██╗╚══██╔══╝██║██╔════╝██╔══██╗██║',
-    '██╔██╗ ██║██║   ██║   ██║   ██║█████╗  ███████║██║',
-    '██║╚██╗██║██║   ██║   ██║   ██║██╔══╝  ██╔══██║██║',
-    '██║ ╚████║╚██████╔╝   ██║   ██║██║     ██║  ██║██║',
-    '╚═╝  ╚═══╝ ╚═════╝    ╚═╝   ╚═╝╚═╝     ╚═╝  ╚═╝╚═╝',
-];
-/** Pure ASCII. 34 columns, 4 rows — safe on any terminal, any code page. */
-const ASCII = [
-    '  _  _  ___ _____ ___ ___ _   ___ ',
-    ' | \\| |/ _ \\_   _|_ _| __/_\\ |_ _|',
-    ' | .` | (_) || |  | || _/ _ \\ | | ',
-    ' |_|\\_|\\___/ |_| |___|_/_/ \\_\\___|',
-];
-export function bannerSize(columns = terminalWidth()) {
-    if (unicode && columns >= 54)
-        return 'block';
-    if (columns >= 38)
-        return 'ascii';
-    return 'word';
-}
-/** The wordmark as rendered lines, gradient included. */
-export function bannerLines(columns = terminalWidth()) {
-    switch (bannerSize(columns)) {
-        case 'block':
-            return gradientBlock(BLOCK);
-        case 'ascii':
-            return gradientBlock(ASCII);
-        case 'word':
-            return gradientBlock(['N O T I F A I']);
-    }
-}
-/**
- * Reveal the wordmark one row at a time.
- *
- * Deliberately brief and deliberately skippable: this runs before someone can
- * do anything, so it may not become a wait. It is skipped entirely when output
- * is not a TTY, when `NOTIFAI_NO_ANIMATION` is set, and under `CI`.
- */
-export async function printBanner(options = {}) {
-    const env = options.env ?? process.env;
-    const write = options.write ?? ((line) => process.stdout.write(`${line}\n`));
-    const lines = bannerLines();
-    const animate = options.animate !== false &&
-        process.stdout.isTTY === true &&
-        (env['NOTIFAI_NO_ANIMATION'] ?? '') === '' &&
-        (env['CI'] ?? '') === '';
-    write('');
-    for (const line of lines) {
-        // Two columns, matching the tagline and the status card beneath it. Flush
-        // left, the wordmark reads as a separate thing sitting above the app.
-        write(`  ${line}`);
-        if (animate)
-            await new Promise((resolve) => setTimeout(resolve, 26));
-    }
-    write('');
-}
-/**
- * One line of orientation under the wordmark — and it must stay one line.
- * Wrapped onto two it stops reading as a subtitle and starts reading as the
- * first paragraph of something, so a narrow terminal gets the version alone.
- */
-export function tagline(version, columns = terminalWidth()) {
-    const full = 'Native notifications for agents and local programs';
-    // Two leading columns of indent, two trailing for the version.
-    return columns >= full.length + 12
-        ? `${style.dim(full)}  ${style.dim(`v${version}`)}`
-        : style.dim(`v${version}`);
-}
-//# sourceMappingURL=banner.js.map

package/dist/ui/banner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzE,uCAAuC;AACvC,MAAM,KAAK,GAAG;IACZ,oDAAoD;IACpD,oDAAoD;IACpD,oDAAoD;IACpD,oDAAoD;IACpD,oDAAoD;IACpD,oDAAoD;CACrD,CAAA;AAED,4EAA4E;AAC5E,MAAM,KAAK,GAAG;IACZ,oCAAoC;IACpC,uCAAuC;IACvC,qCAAqC;IACrC,wCAAwC;CACzC,CAAA;AAID,MAAM,UAAU,UAAU,CAAC,OAAO,GAAG,aAAa,EAAE;IAClD,IAAI,OAAO,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,OAAO,CAAA;IAC5C,IAAI,OAAO,IAAI,EAAE;QAAE,OAAO,OAAO,CAAA;IACjC,OAAO,MAAM,CAAA;AACf,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,OAAO,GAAG,aAAa,EAAE;IACnD,QAAQ,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,KAAK,OAAO;YACV,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;QAC7B,KAAK,OAAO;YACV,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;QAC7B,KAAK,MAAM;YACT,OAAO,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAA;IAC3C,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAA0F,EAAE;IAE5F,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAA;IACpF,MAAM,KAAK,GAAG,WAAW,EAAE,CAAA;IAC3B,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,KAAK,KAAK;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;QAC7B,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE;QAC1C,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAA;IAE1B,KAAK,CAAC,EAAE,CAAC,CAAA;IACT,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,0EAA0E;QAC1E,sEAAsE;QACtE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;QAClB,IAAI,OAAO;YAAE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;IACtE,CAAC;IACD,KAAK,CAAC,EAAE,CAAC,CAAA;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,OAAO,GAAG,aAAa,EAAE;IAChE,MAAM,IAAI,GAAG,oDAAoD,CAAA;IACjE,+DAA+D;IAC/D,OAAO,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;QAChC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE;QACnD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,OAAO,EAAE,CAAC,CAAA;AAC9B,CAAC"}

package/dist/ui/config-view.d.ts

@@ -1,30 +0,0 @@
-/**
- * Rendering for the configuration surfaces a person reads.
- *
- * The agent-facing shapes are untouched and live elsewhere: `--json` is the
- * contract, and the flat `key = value` form stays exactly as it was for
- * anything that is not a terminal. What is new is only what a human sees.
- */
-import { type CliConfig, type ConfigKey } from '../config.js';
-/**
- * The full settings listing, grouped and explained.
- *
- * Each key gets its name (what you type), its value (what is in force), where
- * that value came from, and one line on what it does. The name leads rather
- * than the friendly label because the next thing a reader does with it is type
- * it into `config set`.
- */
-export declare function renderConfigList(config: CliConfig, options?: {
-    showAdvanced?: boolean;
-}): string[];
-/**
- * Everything about one key, for someone who has asked about it specifically.
- *
- * This is the payoff of the listing above staying terse: the reader arrives
- * here already knowing which key they care about, so the full paragraph, the
- * legal values, and the layer the current value came from can all be spent on
- * that one key.
- */
-export declare function renderConfigExplain(key: ConfigKey, config: CliConfig): string[];
-/** The flat form, unchanged, for anything that is not a person at a terminal. */
-export declare function renderConfigPlain(config: CliConfig, explain: boolean): string[];

package/dist/ui/config-view.js

@@ -1,108 +0,0 @@
-/**
- * Rendering for the configuration surfaces a person reads.
- *
- * The agent-facing shapes are untouched and live elsewhere: `--json` is the
- * contract, and the flat `key = value` form stays exactly as it was for
- * anything that is not a terminal. What is new is only what a human sees.
- */
-import { CONFIG_KEYS } from '../config.js';
-import { CONFIG_GROUPS, acceptedValues, configInfo, configKeysByGroup, describeSource, formatValue, } from '../config-schema.js';
-import { glyph, pad, style, terminalWidth, wrap } from './theme.js';
-/**
- * The full settings listing, grouped and explained.
- *
- * Each key gets its name (what you type), its value (what is in force), where
- * that value came from, and one line on what it does. The name leads rather
- * than the friendly label because the next thing a reader does with it is type
- * it into `config set`.
- */
-export function renderConfigList(config, options = {}) {
-    const columns = terminalWidth();
-    const lines = [];
-    const nameWidth = Math.max(...CONFIG_KEYS.map((key) => key.length));
-    const SUMMARY_INDENT = '      ';
-    for (const group of CONFIG_GROUPS) {
-        const keys = configKeysByGroup(group.id).filter((info) => options.showAdvanced === true || info.advanced !== true);
-        if (keys.length === 0)
-            continue;
-        lines.push('');
-        lines.push(style.heading(group.title));
-        for (const line of wrap(group.blurb, columns - 2))
-            lines.push(style.dim(`  ${line}`));
-        lines.push('');
-        for (const info of keys) {
-            const entry = config[info.key];
-            const source = describeSource(entry.source);
-            const value = formatValue(info.key, entry.value);
-            const isSet = source.label !== 'default';
-            // The provenance mark is only drawn when there is provenance to show;
-            // an empty dim segment still emits escape codes, so a `trimEnd` on the
-            // finished string cannot remove it.
-            const provenance = isSet ? `  ${style.dim(`${glyph.bullet} ${source.label}`)}` : '';
-            lines.push(`  ${style.code(pad(info.key, nameWidth))}  ` +
-                `${isSet ? style.value(value) : style.unset(value)}${provenance}`);
-            for (const line of wrap(info.summary, columns - SUMMARY_INDENT.length)) {
-                lines.push(style.dim(`${SUMMARY_INDENT}${line}`));
-            }
-        }
-    }
-    lines.push('');
-    const command = 'notifai config explain <key>';
-    const help = `${glyph.arrow} ${command} for what one of these means and how to change it.`;
-    for (const line of wrap(help, columns)) {
-        lines.push(style.dim(line.replace(command, style.code(command))));
-    }
-    return lines;
-}
-/**
- * Everything about one key, for someone who has asked about it specifically.
- *
- * This is the payoff of the listing above staying terse: the reader arrives
- * here already knowing which key they care about, so the full paragraph, the
- * legal values, and the layer the current value came from can all be spent on
- * that one key.
- */
-export function renderConfigExplain(key, config) {
-    const info = configInfo(key);
-    const entry = config[key];
-    const source = describeSource(entry.source);
-    const columns = terminalWidth();
-    const lines = [];
-    lines.push('');
-    lines.push(`${style.code(key)}  ${style.dim(glyph.bullet)}  ${style.heading(info.label)}`);
-    lines.push('');
-    for (const paragraph of info.detail.split('\n\n')) {
-        for (const line of wrap(paragraph, columns - 2))
-            lines.push(`  ${line}`);
-        lines.push('');
-    }
-    const valueLabel = formatValue(key, entry.value);
-    lines.push(`  ${style.dim(pad('Now', 10))}${style.value(valueLabel)}  ${style.dim(`${glyph.bullet} ${source.label}`)}`);
-    if (source.path !== null)
-        lines.push(`  ${style.dim(pad('', 10))}${style.dim(source.path)}`);
-    lines.push(`  ${style.dim(pad('Accepts', 10))}${acceptedValues(key)}`);
-    if (info.choices !== undefined && info.choiceHints !== undefined) {
-        lines.push('');
-        for (const choice of info.choices) {
-            const hint = info.choiceHints[choice];
-            lines.push(`  ${style.dim(pad('', 10))}${style.code(pad(choice, 14))}${style.dim(hint ?? '')}`.trimEnd());
-        }
-    }
-    lines.push('');
-    const example = info.example ?? (info.choices?.[0] ?? 'value');
-    lines.push(`  ${style.dim('Change it')} ${style.code(`notifai config set ${key} ${example}`)}`);
-    if (entry.source !== 'default' && entry.source !== 'flag') {
-        lines.push(`  ${style.dim('Inherit it')} ${style.code(`notifai config unset ${key}`)}`);
-    }
-    lines.push('');
-    return lines;
-}
-/** The flat form, unchanged, for anything that is not a person at a terminal. */
-export function renderConfigPlain(config, explain) {
-    return CONFIG_KEYS.map((key) => {
-        const entry = config[key];
-        const provenance = explain ? `  [${entry.source}]` : '';
-        return `${key} = ${JSON.stringify(entry.value)}${provenance}`;
-    });
-}
-//# sourceMappingURL=config-view.js.map

package/dist/ui/config-view.js.map

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

package/dist/ui/help.d.ts

@@ -1,44 +0,0 @@
-/**
- * Help that answers "what can I do here", not "what strings does argv accept".
- *
- * The old help listed seventeen commands in one flat column, with the one a new
- * user needs (`init`) sitting between a platform capability dump and
- * an entry point marked "Internal:". Everything was equally prominent, which is
- * the same as nothing being prominent.
- *
- * Grouping and colour are Commander's own (`commandsGroup`, `optionsGroup`, and
- * the `styleX` hooks it calls when the output has colours); this module only
- * supplies the palette and the group vocabulary. Commander turns its styling
- * off by itself when the output is not a terminal, so piped help stays plain
- * without a second code path.
- */
-import { type HelpConfiguration } from 'commander';
-/**
- * Group headings, in the order a reader meets them.
- *
- * Ordering is by who needs it and when: first run, then daily use, then the
- * commands agents drive, then the things touched once or never. Commander
- * renders groups in first-use order, so these constants are also the layout.
- */
-export declare const GROUP: {
-    readonly start: "Getting started:";
-    readonly daily: "Everyday:";
-    readonly agent: "For agents and scripts:";
-    readonly advanced: "Account and wiring:";
-};
-/** Option groups for `send`, which carries thirty flags. */
-export declare const SEND_GROUP: {
-    readonly content: "What it says:";
-    readonly routing: "Where it goes:";
-    readonly presentation: "How it arrives:";
-    readonly reply: "Asking for an answer:";
-    readonly advanced: "Advanced:";
-};
-export declare const helpConfiguration: HelpConfiguration;
-/**
- * Footer for the root help.
- *
- * First-run is `notifai init`. The interactive app is what a human opens
- * later, once setup is no longer the thing in the way.
- */
-export declare function rootHelpFooter(): string;

package/dist/ui/help.js

@@ -1,107 +0,0 @@
-/**
- * Help that answers "what can I do here", not "what strings does argv accept".
- *
- * The old help listed seventeen commands in one flat column, with the one a new
- * user needs (`init`) sitting between a platform capability dump and
- * an entry point marked "Internal:". Everything was equally prominent, which is
- * the same as nothing being prominent.
- *
- * Grouping and colour are Commander's own (`commandsGroup`, `optionsGroup`, and
- * the `styleX` hooks it calls when the output has colours); this module only
- * supplies the palette and the group vocabulary. Commander turns its styling
- * off by itself when the output is not a terminal, so piped help stays plain
- * without a second code path.
- */
-import { Help } from 'commander';
-import { glyph, style } from './theme.js';
-/**
- * Group headings, in the order a reader meets them.
- *
- * Ordering is by who needs it and when: first run, then daily use, then the
- * commands agents drive, then the things touched once or never. Commander
- * renders groups in first-use order, so these constants are also the layout.
- */
-export const GROUP = {
-    start: 'Getting started:',
-    daily: 'Everyday:',
-    agent: 'For agents and scripts:',
-    advanced: 'Account and wiring:',
-};
-/** Option groups for `send`, which carries thirty flags. */
-export const SEND_GROUP = {
-    content: 'What it says:',
-    routing: 'Where it goes:',
-    presentation: 'How it arrives:',
-    reply: 'Asking for an answer:',
-    advanced: 'Advanced:',
-};
-/** Group order, independent of the order commands happen to be registered in. */
-const GROUP_ORDER = [
-    GROUP.start,
-    GROUP.daily,
-    GROUP.agent,
-    GROUP.advanced,
-];
-function groupRank(heading) {
-    const index = GROUP_ORDER.indexOf(heading);
-    // Anything not named above keeps its position relative to its peers, because
-    // the sort is stable — which is what lets the same override run over option
-    // groups without needing to know their headings.
-    return index === -1 ? GROUP_ORDER.length : index;
-}
-export const helpConfiguration = {
-    // Groups already carry the intended order; alphabetising would scatter the
-    // dependency between `login` and everything that needs a credential.
-    sortSubcommands: false,
-    sortOptions: false,
-    showGlobalOptions: false,
-    /**
-     * Commander seeds group order from the raw registration order, which ties
-     * how the help reads to where a `program.command(…)` block happens to sit in
-     * the file — move one and the help silently reorders. Sorting the finished
-     * grouping makes `GROUP_ORDER` the single place that decision is made.
-     *
-     * The same override runs over option groups, whose headings are not in
-     * `GROUP_ORDER` at all. They all rank equal, and `sort` is stable, so they
-     * keep the order they were declared in.
-     */
-    groupItems(unsortedItems, visibleItems, getGroup) {
-        // `.call` cannot carry the method's own generic through, so the signature
-        // is restated once here instead of widening every caller to
-        // `Command | Option`.
-        const base = Help.prototype.groupItems;
-        const grouped = base.call(this, unsortedItems, visibleItems, getGroup);
-        return new Map([...grouped.entries()].sort((a, b) => groupRank(a[0]) - groupRank(b[0])));
-    },
-    styleTitle: (title) => style.heading(title),
-    styleCommandText: (text) => style.accent(text),
-    styleSubcommandTerm: (text) => style.code(text),
-    styleOptionTerm: (text) => style.code(text),
-    styleArgumentTerm: (text) => style.code(text),
-    styleDescriptionText: (text) => text,
-    styleUsage: (text) => text,
-};
-/**
- * Footer for the root help.
- *
- * First-run is `notifai init`. The interactive app is what a human opens
- * later, once setup is no longer the thing in the way.
- */
-export function rootHelpFooter() {
-    const lines = [
-        '',
-        style.heading('Start here'),
-        `  ${style.code('notifai init')}         ${style.dim(`${glyph.arrow} set this project up, step by step`)}`,
-        `  ${style.code('notifai')}              ${style.dim(`${glyph.arrow} after setup: status, settings, devices, test sends`)}`,
-        '',
-        style.heading('First call, for an agent'),
-        `  ${style.code('notifai send --kind done --title "All 42 tests passed" --body "Finished in 3m 10s. Next: review the release candidate."')}`,
-        `  ${style.code('notifai ask "Deploy migration 0007 to production?" --choice Deploy --choice Hold')}`,
-        `  ${style.dim(`${glyph.arrow} ${style.code('ask')} needs question routing installed; ${style.code('notifai doctor --json')} says whether it is.`)}`,
-        '',
-        style.dim(`Every command takes ${style.code('--help')}. Where a command has machine-readable output it takes ${style.code('--json')}.`),
-        style.dim(`Settings are explained by ${style.code('notifai config show')} and ${style.code('notifai config explain <key>')}.`),
-    ];
-    return lines.join('\n');
-}
-//# sourceMappingURL=help.js.map

package/dist/ui/help.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/ui/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,IAAI,EAAqD,MAAM,WAAW,CAAA;AACnF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,kBAAkB;IACzB,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,qBAAqB;CACvB,CAAA;AAEV,4DAA4D;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,gBAAgB;IACzB,YAAY,EAAE,iBAAiB;IAC/B,KAAK,EAAE,uBAAuB;IAC9B,QAAQ,EAAE,WAAW;CACb,CAAA;AAEV,iFAAiF;AACjF,MAAM,WAAW,GAAsB;IACrC,KAAK,CAAC,KAAK;IACX,KAAK,CAAC,KAAK;IACX,KAAK,CAAC,KAAK;IACX,KAAK,CAAC,QAAQ;CACf,CAAA;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1C,6EAA6E;IAC7E,4EAA4E;IAC5E,iDAAiD;IACjD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAA;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,2EAA2E;IAC3E,qEAAqE;IACrE,eAAe,EAAE,KAAK;IACtB,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,KAAK;IAExB;;;;;;;;;OASG;IACH,UAAU,CAER,aAAkB,EAClB,YAAiB,EACjB,QAA6B;QAE7B,0EAA0E;QAC1E,4DAA4D;QAC5D,sBAAsB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAKP,CAAA;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;QACtE,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1F,CAAC;IAED,UAAU,EAAE,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3D,gBAAgB,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9D,mBAAmB,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC/D,eAAe,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3D,iBAAiB,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7D,oBAAoB,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI;IACpD,UAAU,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI;CAC3C,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAC3B,KAAK,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,oCAAoC,CAAC,EAAE;QAC1G,KAAK,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,iBAAiB,KAAK,CAAC,GAAG,CAClD,GAAG,KAAK,CAAC,KAAK,qDAAqD,CACpE,EAAE;QACH,EAAE;QACF,KAAK,CAAC,OAAO,CAAC,0BAA0B,CAAC;QACzC,KAAK,KAAK,CAAC,IAAI,CAAC,yHAAyH,CAAC,EAAE;QAC5I,KAAK,KAAK,CAAC,IAAI,CAAC,kFAAkF,CAAC,EAAE;QACrG,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,sCAAsC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,EAAE;QACpJ,EAAE;QACF,KAAK,CAAC,GAAG,CACP,uBAAuB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,0DAA0D,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAC7H;QACD,KAAK,CAAC,GAAG,CAAC,6BAA6B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,GAAG,CAAC;KAC/H,CAAA;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/ui/theme.d.ts

@@ -1,90 +0,0 @@
-/** True when the terminal can render the box-drawing and status glyphs below. */
-export declare const unicode: boolean;
-/**
- * Brand ramp, shared with the companion app icon: pink → coral → rose →
- * magenta. Used for the wordmark and for accenting the surfaces a human sees.
- */
-export declare const BRAND_RAMP: readonly ["#FF9EC0", "#FF816B", "#EC5A73", "#B84E93"];
-/**
- * Paint each line of a block so the gradient runs left-to-right across the
- * whole block rather than restarting per line. The wordmark is one image, and
- * per-line gradients make it read as several.
- */
-export declare function gradientBlock(lines: readonly string[], ramp?: readonly string[]): string[];
-export declare const style: {
-    /** A heading that opens a section. */
-    readonly heading: (text: string) => string;
-    /** The brand voice — command names, the product name, the selected thing. */
-    readonly accent: (text: string) => string;
-    /** Secondary text: hints, provenance, units, defaults. */
-    readonly dim: (text: string) => string;
-    /** Something the reader can type. */
-    readonly code: (text: string) => string;
-    readonly ok: (text: string) => string;
-    readonly warn: (text: string) => string;
-    readonly bad: (text: string) => string;
-    /** A value as it currently stands. */
-    readonly value: (text: string) => string;
-    /** A value that is not set, or is inherited rather than chosen. */
-    readonly unset: (text: string) => string;
-};
-/**
- * Status marks. The glyph and the colour say the same thing twice on purpose;
- * either alone is enough to read the line.
- */
-export declare const glyph: {
-    readonly ok: "*" | "●";
-    readonly warn: "!" | "▲";
-    readonly bad: "✕" | "x";
-    readonly pending: "○" | "o";
-    readonly bullet: "-" | "•";
-    readonly arrow: "→" | "->";
-    readonly chevron: "›" | ">";
-    readonly bar: "|" | "│";
-};
-export type Tone = 'ok' | 'warn' | 'bad' | 'pending';
-/** A coloured glyph for a tone; the caller supplies the words. */
-export declare function mark(tone: Tone): string;
-/** Visible width, ignoring ANSI escapes, for alignment maths. */
-export declare function width(text: string): number;
-/** Pad to `size` using visible width, so colour never breaks a column. */
-export declare function pad(text: string, size: number): string;
-/**
- * Usable terminal width: the real one, capped so paragraphs do not run to 200
- * characters on a maximised window.
- *
- * No lower clamp. Raising a narrow terminal to a comfortable minimum sounds
- * harmless and is not — every box drawn to that invented width overflows the
- * real one and wraps, which looks far worse than a cramped box that fits.
- */
-export declare function terminalWidth(fallback?: number): number;
-/**
- * A titled box around `rows`.
- *
- * Hand-drawn rather than delegated, because the obvious library call sizes
- * itself from `process.stdout.columns` and divides by it — a pty that reports
- * zero columns (some CI runners, some `script` invocations) makes the padding
- * negative and throws, taking the whole screen down with it. A status card is
- * decoration; it may degrade, but it must never be what crashes the app.
- *
- * Rows are measured with `width`, so colour inside them does not skew the
- * border, and anything too wide for the terminal is clipped rather than
- * wrapped — a status line that wraps stops being a status line.
- */
-export declare function card(title: string, rows: readonly string[], columns?: number): string[];
-/**
- * Truncate to a visible width, carrying escape sequences through untouched.
- *
- * Counting only printable characters is the whole point: slicing a coloured
- * string by `String.length` cuts through an escape sequence and spills raw
- * `[38;2` into the terminal.
- */
-export declare function clip(text: string, limit: number): string;
-/**
- * Wrap `text` to `columns`, returning bare lines.
- *
- * Indentation is the caller's, deliberately: an earlier version indented
- * continuation lines itself, callers indented every line as well, and each
- * wrapped paragraph stepped further right down the page.
- */
-export declare function wrap(text: string, columns: number): string[];