@raidiant/notifai 0.1.0

package/dist/main.js

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import { Command } from 'commander';
+import { askCommand, authStatusCommand, capabilitiesCommand, closeCommand, configSetCommand, configShowCommand, devicesCommand, doctorCommand, hookRunCommand, hooksInstallCommand, hooksUninstallCommand, initCommand, loginCommand, logoutCommand, realIo, repliesCommand, sendCommand, statusCommand, } from './commands.js';
+import { defaultCredentialStore } from './credentials.js';
+const deps = {
+    io: realIo(),
+    store: defaultCredentialStore(),
+    env: process.env,
+    cwd: process.cwd(),
+};
+/**
+ * Harness hooks deliver their event payload on stdin. Bounded on both time and
+ * size: a wrapper that opens the pipe without writing would otherwise hold the
+ * read until the harness killed the hook, delaying the user's own prompt.
+ */
+async function readStdin(timeoutMs = 2000, maxBytes = 1_000_000) {
+    if (process.stdin.isTTY)
+        return '';
+    return new Promise((resolve) => {
+        const chunks = [];
+        let total = 0;
+        let settled = false;
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            process.stdin.destroy();
+            resolve(Buffer.concat(chunks).toString('utf8'));
+        };
+        const timer = setTimeout(finish, timeoutMs);
+        timer.unref?.();
+        process.stdin.on('data', (chunk) => {
+            total += chunk.length;
+            if (total > maxBytes)
+                return finish();
+            chunks.push(chunk);
+        });
+        process.stdin.on('end', finish);
+        process.stdin.on('error', finish);
+    });
+}
+const program = new Command('notifai')
+    .description('Send native device notifications from agents and local programs')
+    .version('0.1.0');
+program
+    .command('login')
+    .description('Pair this machine with your NotifAI account via browser approval')
+    .option('--name <name>', 'machine name shown in the dashboard (default: hostname)')
+    .option('--base-url <url>', 'NotifAI server URL')
+    .option('--no-open', 'do not open the approval page in a browser')
+    .action(async (opts) => {
+    process.exit(await loginCommand(deps, opts));
+});
+program
+    .command('logout')
+    .description('Remove the stored machine credential')
+    .action(() => {
+    process.exit(logoutCommand(deps));
+});
+const auth = program.command('auth').description('Authentication helpers');
+auth
+    .command('status')
+    .description('Show the stored machine identity')
+    .option('--json', 'machine-readable output')
+    .action((opts) => {
+    process.exit(authStatusCommand(deps, opts));
+});
+program
+    .command('devices')
+    .description('List registered devices and their delivery readiness')
+    .option('--json', 'machine-readable output')
+    .action(async (opts) => {
+    process.exit(await devicesCommand(deps, opts));
+});
+program
+    .command('capabilities')
+    .description('Show a platform capability contract')
+    .option('--platform <platform>', 'platform to describe (default: ios)')
+    .option('--json', 'machine-readable output')
+    .action(async (opts) => {
+    process.exit(await capabilitiesCommand(deps, opts));
+});
+program
+    .command('send')
+    .description('Send a notification')
+    .requiredOption('--title <title>', 'notification title')
+    .requiredOption('--body <body>', 'notification body')
+    .option('--subtitle <subtitle>')
+    .option('--detail <markdown>', 'long-form markdown shown only in the app, never on the banner')
+    .option('--detail-file <path>', 'read --detail from a file (use - for stdin)')
+    .option('--event <event>', 'agent event name, e.g. tests_passed')
+    .option('--kind <kind>', 'what this is: update (default) | done | question (requires --reply)')
+    .option('--project <id>', 'project identifier, e.g. my-app (lazily registered)')
+    .option('--session <id>', 'session identity (env: NOTIFAI_SESSION); presentation varies by surface')
+    .option('--device <id>', 'target a device id (repeatable)', (v, all) => [...all, v], [])
+    .option('--all', 'target all routable devices (overrides configured devices)')
+    .option('--ttl <seconds>', 'delivery window in seconds', (v) => Number(v))
+    .option('--collapse-key <key>', 'replace earlier notifications with the same key')
+    .option('--platform <platform>', 'platform whose optional fields to include (default: ios)')
+    .option('--sound <sound>', 'default | done | attention | alert | none')
+    .option('--badge <n>', 'app badge count', (v) => Number(v))
+    .option('--thread-id <id>', 'group related notifications')
+    .option('--level <level>', 'interruption level: passive | active | time_sensitive')
+    .option('--relevance <score>', '0..1 relevance score', (v) => Number(v))
+    .option('--target-content-id <id>')
+    .option('--data <key=value>', 'custom data (repeatable)', (v, all) => [...all, v], [])
+    .option('--image <path|url|media_id>', 'upload or attach an image')
+    .option('--reply', 'enable the inline reply action and block for the answer')
+    .option('--reply-timeout <seconds>', 'how long to wait for a reply (default: 900)', (v) => Number(v))
+    .option('--reply-window <seconds>', 'how long the server accepts a reply (default: 86400)', (v) => Number(v))
+    .option('--reply-choice <label>', 'with --reply, ask a closed question (2-6 answers); one value splits on commas, or repeat the flag', (v, all) => [...all, v], [])
+    // Kept registered, and always a usage error with --reply, so the caller gets
+    // a message pointing at `ask` instead of "unknown option".
+    .option('--no-block', 'rejected with --reply; use `notifai ask` to ask and end the turn')
+    .option('--wait <seconds>', 'how long to wait for provider outcomes', (v) => Number(v))
+    .option('--no-wait', 'return immediately after acceptance')
+    .option('--idempotency-key <key>', 'safe-retry key (default: random)')
+    .option('--base-url <url>', 'NotifAI server URL')
+    .option('--json', 'print the full submission receipt as JSON')
+    .action(async (opts) => {
+    // commander maps --no-wait onto the same "wait" flag; disentangle.
+    const noWait = opts['wait'] === false;
+    const wait = typeof opts['wait'] === 'number' ? opts['wait'] : undefined;
+    const noBlock = opts['block'] === false;
+    const sendOpts = { ...opts };
+    // Same empty-collector normalisation as `ask`.
+    if (Array.isArray(sendOpts['replyChoice']) && sendOpts['replyChoice'].length === 0) {
+        delete sendOpts['replyChoice'];
+    }
+    delete sendOpts['block'];
+    // Long-form detail is usually a build log or a diff summary, which nobody
+    // wants to shell-escape onto a command line.
+    const detailFile = sendOpts['detailFile'];
+    delete sendOpts['detailFile'];
+    if (typeof detailFile === 'string') {
+        if (sendOpts['detail'] !== undefined) {
+            deps.io.err('Pass either --detail or --detail-file, not both.');
+            process.exit(2);
+        }
+        try {
+            sendOpts['detail'] = readFileSync(detailFile === '-' ? 0 : detailFile, 'utf8');
+        }
+        catch (err) {
+            deps.io.err(`Could not read ${detailFile}: ${String(err)}`);
+            process.exit(2);
+        }
+    }
+    const flags = { ...sendOpts, noWait, noBlock };
+    if (wait === undefined)
+        delete flags.wait;
+    else
+        flags.wait = wait;
+    process.exit(await sendCommand(deps, flags));
+});
+program
+    .command('replies <request_id>')
+    .description('Retrieve replies for a notification request')
+    .option('--wait <seconds>', 'how long to wait for a reply', (v) => Number(v))
+    .option('--after <seq>', 'return replies after this sequence number', (v) => Number(v))
+    .option('--json', 'machine-readable output')
+    .action(async (requestId, opts) => {
+    process.exit(await repliesCommand(deps, requestId, opts));
+});
+program
+    .command('status <request_id>')
+    .description('Show the evidence trail for a notification request')
+    .option('--json', 'machine-readable output')
+    .action(async (requestId, opts) => {
+    process.exit(await statusCommand(deps, requestId, opts));
+});
+program
+    .command('ask <question>')
+    .description('Register a question for the turn-end hook to route under your presence settings')
+    .option('--choice <label>', 'answers to offer instead of free text (2-6); one value splits on commas, or repeat the flag', (v, all) => [...all, v], [])
+    .option('--session <id>', 'session id (default: the session working in this directory, else $NOTIFAI_SESSION)')
+    .action((question, opts) => {
+    // commander's collector defaults to []; an empty list means "not asked".
+    const flags = {
+        ...(opts.session !== undefined ? { session: opts.session } : {}),
+        ...(opts.choice?.length ? { choice: opts.choice } : {}),
+    };
+    process.exit(askCommand(deps, question, flags));
+});
+program
+    .command('close <request_id>')
+    .description('Retire a question so late answers are rejected rather than lost')
+    .action(async (requestId) => {
+    process.exit(await closeCommand(deps, requestId));
+});
+program
+    .command('hook <event>')
+    .description('Internal: run a harness hook (reads hook JSON on stdin)')
+    // Inert, and the point of it is that it is inert: the installed command line
+    // carries a marker that says "NotifAI wrote this" independently of which
+    // checkout wrote it.
+    .option('--owner <name>', 'internal ownership marker')
+    .option('--harness <name>', 'internal harness output adapter')
+    .action(async (event, opts) => {
+    process.exit(await hookRunCommand(deps, event, readStdin, opts.harness === 'cursor' ? 'cursor' : undefined));
+});
+const hooks = program.command('hooks').description('Install harness hooks for registered-question routing');
+hooks
+    .command('install')
+    .description('Wire this harness to route registered questions to your devices')
+    .option('--harness <name>', 'claude-code | codex | cursor | opencode (default: detected; OpenCode cannot resume an idle turn from an answer)')
+    .option('--global', 'install for every project instead of just this one')
+    .action((opts) => {
+    process.exit(hooksInstallCommand(deps, opts));
+});
+hooks
+    .command('uninstall')
+    .description('Remove the hooks this CLI installed')
+    .option('--harness <name>', 'claude-code | codex | cursor | opencode (default: detected)')
+    .option('--global', 'remove the machine-wide install')
+    .action((opts) => {
+    process.exit(hooksUninstallCommand(deps, opts));
+});
+const config = program.command('config').description('Show or change configuration');
+config
+    .command('show')
+    .description('Show the resolved configuration')
+    .option('--explain', 'show where each value comes from')
+    .option('--json', 'machine-readable output')
+    .action((opts) => {
+    process.exit(configShowCommand(deps, opts));
+});
+config
+    .command('set <key> <value>')
+    .description('Set a configuration value (choose a layer interactively; unattended defaults machine-global and requires --yes)')
+    .option('--project', 'write to the shared .notifai/config.toml instead')
+    .option('--local', 'write to personal .notifai/config.local.toml (keep it gitignored)')
+    .option('--session <id>', 'apply only to one session')
+    .option('--yes', 'skip the confirmation gate')
+    .action(async (key, value, opts) => {
+    process.exit(await configSetCommand(deps, key, value, opts));
+});
+program
+    .command('init')
+    .description('Set up NotifAI here, idempotently: sign-in, project id, hooks, device readiness. ' +
+    'Interactive at a human terminal; never prompts otherwise (agents: pass flags)')
+    .option('--project-id <id>', 'project identifier slug (default: derived from the directory name)')
+    .option('--skills', 'reserved: this build has no published agent-skill source and exits with an error')
+    .option('--no-skills', 'suppress the optional agent-skill status line')
+    .option('--hooks', 'install harness hooks for registered-question routing')
+    .option('--no-hooks', 'skip the hooks without being asked')
+    .action(async (opts) => {
+    process.exit(await initCommand(deps, opts));
+});
+program
+    .command('doctor')
+    .description('Audit config, credential, server, contract, device, and hook readiness (no live send)')
+    .option('--json', 'machine-readable output')
+    .action(async (opts) => {
+    process.exit(await doctorCommand(deps, opts));
+});
+await program.parseAsync(process.argv);
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/opencode-plugin.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The OpenCode adapter.
+ *
+ * OpenCode's extension point is a TypeScript/JavaScript plugin module, not a
+ * command hook, so it needs a different adapter rather than a different path
+ * through the existing one. What it is *not* is different logic: the generated
+ * plugin shells out to the same `notifai hook <event>` commands Claude Code and
+ * Codex invoke, and every decision — presence, the grace window, the reply
+ * wait, retirement — stays in one place.
+ *
+ * The three lifecycle joints map onto the same three events. OpenCode exposes
+ * `chat.message` as a direct hook, while session lifecycle notifications arrive
+ * through its generic `event` hook:
+ *
+ *   chat.message   -> user-prompt-submit   (the user is at the keyboard)
+ *   session.idle   -> stop                 (the turn ended; escalate)
+ *   session.deleted -> session-end         (retire local session state)
+ *
+ * Permission prompts deliberately stay in OpenCode. The CLI question flow
+ * only escalates questions explicitly registered with `notifai ask`.
+ */
+/** Marker line; also how an install from another checkout is recognised. */
+export declare const OPENCODE_PLUGIN_MARKER = "// notifai managed opencode plugin";
+/** Filename we own inside whichever plugins directory is being written. */
+export declare const OPENCODE_PLUGIN_FILENAME = "notifai.js";
+export declare function opencodePluginDir(global: boolean, cwd: string, env?: NodeJS.ProcessEnv): string;
+export declare function opencodePluginPath(global: boolean, cwd: string, env?: NodeJS.ProcessEnv): string;
+export interface OpencodePluginOptions {
+    execPath: string;
+    scriptPath: string;
+    /** Child-process lifetime; covers grace, reply wait, and teardown headroom. */
+    timeoutSeconds: number;
+}
+/**
+ * The generated module.
+ *
+ * Written as a string rather than compiled from a source file because it has to
+ * embed the absolute interpreter and script paths — a bare `notifai` on PATH
+ * fails silently under a plugin host the same way it does under a hook shell.
+ *
+ * Everything it does is build the hook envelope OpenCode's event gives it and
+ * hand that to the CLI on stdin. It deliberately fails open: an adapter error
+ * never changes OpenCode's own behavior.
+ */
+export declare function opencodePluginSource(options: OpencodePluginOptions): string;
+/** True when a plugin file on disk is one of ours, whoever installed it. */
+export declare function isOurOpencodePlugin(contents: string): boolean;
+/**
+ * The interpreter and script a generated plugin will actually run.
+ *
+ * A plugin is a module rather than a command line, so which *build* it invokes
+ * is not visible in the way it is for a settings-file handler — it is baked
+ * into the two constants at the top. `doctor` needs it to answer the question
+ * it exists to answer ("are two checkouts both installed?"), and without it
+ * the plugin's own path stands in for the build and every OpenCode install
+ * looks like a second one.
+ *
+ * Returns null for a plugin we did not generate, or one whose constants have
+ * been edited out of recognisable shape.
+ */
+export declare function opencodePluginTarget(contents: string): {
+    exec: string;
+    script: string;
+    current: boolean;
+} | null;

package/dist/opencode-plugin.js

@@ -0,0 +1,181 @@
+import path from 'node:path';
+import { configHome } from './install-hooks.js';
+/**
+ * The OpenCode adapter.
+ *
+ * OpenCode's extension point is a TypeScript/JavaScript plugin module, not a
+ * command hook, so it needs a different adapter rather than a different path
+ * through the existing one. What it is *not* is different logic: the generated
+ * plugin shells out to the same `notifai hook <event>` commands Claude Code and
+ * Codex invoke, and every decision — presence, the grace window, the reply
+ * wait, retirement — stays in one place.
+ *
+ * The three lifecycle joints map onto the same three events. OpenCode exposes
+ * `chat.message` as a direct hook, while session lifecycle notifications arrive
+ * through its generic `event` hook:
+ *
+ *   chat.message   -> user-prompt-submit   (the user is at the keyboard)
+ *   session.idle   -> stop                 (the turn ended; escalate)
+ *   session.deleted -> session-end         (retire local session state)
+ *
+ * Permission prompts deliberately stay in OpenCode. The CLI question flow
+ * only escalates questions explicitly registered with `notifai ask`.
+ */
+/** Marker line; also how an install from another checkout is recognised. */
+export const OPENCODE_PLUGIN_MARKER = '// notifai managed opencode plugin';
+/** Filename we own inside whichever plugins directory is being written. */
+export const OPENCODE_PLUGIN_FILENAME = 'notifai.js';
+/** Bump when an installed generated file must be rewritten to remain functional. */
+const OPENCODE_ADAPTER_VERSION = 2;
+export function opencodePluginDir(global, cwd, env = process.env) {
+    return global
+        ? path.join(configHome(env, 'OPENCODE_CONFIG_DIR', '.config/opencode'), 'plugins')
+        : path.join(cwd, '.opencode', 'plugins');
+}
+export function opencodePluginPath(global, cwd, env = process.env) {
+    return path.join(opencodePluginDir(global, cwd, env), OPENCODE_PLUGIN_FILENAME);
+}
+/**
+ * The generated module.
+ *
+ * Written as a string rather than compiled from a source file because it has to
+ * embed the absolute interpreter and script paths — a bare `notifai` on PATH
+ * fails silently under a plugin host the same way it does under a hook shell.
+ *
+ * Everything it does is build the hook envelope OpenCode's event gives it and
+ * hand that to the CLI on stdin. It deliberately fails open: an adapter error
+ * never changes OpenCode's own behavior.
+ */
+export function opencodePluginSource(options) {
+    const { execPath, scriptPath, timeoutSeconds } = options;
+    return `${OPENCODE_PLUGIN_MARKER}
+// Generated by \`notifai hooks install --harness opencode\`. Edits are lost on
+// the next install; change the CLI instead, which is where the logic lives.
+import { spawn } from "node:child_process"
+
+const EXEC = ${JSON.stringify(execPath)}
+const SCRIPT = ${JSON.stringify(scriptPath)}
+const TIMEOUT_MS = ${timeoutSeconds * 1000}
+const ADAPTER_VERSION = ${OPENCODE_ADAPTER_VERSION}
+
+/**
+ * Runs \`notifai hook <event>\`, feeding it the same JSON envelope the other
+ * harnesses send. Resolves to stdout, or null if anything at all went wrong.
+ */
+function runHook(event, envelope) {
+  return new Promise((resolve) => {
+    let child
+    try {
+      child = spawn(EXEC, [SCRIPT, "hook", event, "--owner", "notifai"], {
+        env: process.env,
+        shell: false,
+        stdio: ["pipe", "pipe", "pipe"],
+      })
+    } catch {
+      resolve(null)
+      return
+    }
+
+    let stdout = ""
+    let settled = false
+    const finish = (value) => {
+      if (settled) return
+      settled = true
+      clearTimeout(timer)
+      resolve(value)
+    }
+    const timer = setTimeout(() => {
+      child.kill("SIGTERM")
+      finish(null)
+    }, TIMEOUT_MS)
+
+    child.stdout?.setEncoding("utf-8")
+    child.stdout?.on("data", (chunk) => {
+      stdout += chunk
+    })
+    // Hook stderr is diagnostics, not plugin output; discard it here.
+    child.stderr?.resume()
+    child.on("error", () => finish(null))
+    child.on("close", () => finish(stdout))
+
+    try {
+      child.stdin?.end(JSON.stringify(envelope))
+    } catch {
+      finish(null)
+    }
+  })
+}
+
+export const NotifAIPlugin = async ({ directory }) => {
+  const cwd = typeof directory === "string" && directory.length > 0 ? directory : process.cwd()
+
+  return {
+    /**
+     * Presence. The user typing is the signal every harness shares, and it is
+     * also what publishes the project -> session pointer \`notifai ask\` reads.
+     */
+    "chat.message": async (input) => {
+      await runHook("user-prompt-submit", {
+        session_id: input?.sessionID ?? input?.info?.sessionID,
+        cwd,
+        hook_event_name: "UserPromptSubmit",
+      })
+    },
+
+    /** Session lifecycle events are delivered through OpenCode's event bus. */
+    event: async ({ event }) => {
+      if (event?.type === "session.idle") {
+        await runHook("stop", {
+          session_id: event?.properties?.sessionID,
+          cwd,
+          hook_event_name: "Stop",
+        })
+      } else if (event?.type === "session.deleted") {
+        await runHook("session-end", {
+          session_id: event?.properties?.info?.id,
+          cwd,
+          hook_event_name: "SessionEnd",
+        })
+      }
+    },
+  }
+}
+`;
+}
+/** True when a plugin file on disk is one of ours, whoever installed it. */
+export function isOurOpencodePlugin(contents) {
+    return contents.includes(OPENCODE_PLUGIN_MARKER);
+}
+/**
+ * The interpreter and script a generated plugin will actually run.
+ *
+ * A plugin is a module rather than a command line, so which *build* it invokes
+ * is not visible in the way it is for a settings-file handler — it is baked
+ * into the two constants at the top. `doctor` needs it to answer the question
+ * it exists to answer ("are two checkouts both installed?"), and without it
+ * the plugin's own path stands in for the build and every OpenCode install
+ * looks like a second one.
+ *
+ * Returns null for a plugin we did not generate, or one whose constants have
+ * been edited out of recognisable shape.
+ */
+export function opencodePluginTarget(contents) {
+    if (!isOurOpencodePlugin(contents))
+        return null;
+    const exec = /^const EXEC = (".*")$/m.exec(contents)?.[1];
+    const script = /^const SCRIPT = (".*")$/m.exec(contents)?.[1];
+    const version = Number(/^const ADAPTER_VERSION = (\d+)$/m.exec(contents)?.[1] ?? 1);
+    if (exec === undefined || script === undefined)
+        return null;
+    try {
+        return {
+            exec: JSON.parse(exec),
+            script: JSON.parse(script),
+            current: version === OPENCODE_ADAPTER_VERSION,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=opencode-plugin.js.map

package/dist/opencode-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-plugin.js","sourceRoot":"","sources":["../src/opencode-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,oCAAoC,CAAA;AAE1E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAY,CAAA;AAEpD,oFAAoF;AACpF,MAAM,wBAAwB,GAAG,CAAC,CAAA;AAElC,MAAM,UAAU,iBAAiB,CAC/B,MAAe,EACf,GAAW,EACX,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,MAAM;QACX,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,qBAAqB,EAAE,kBAAkB,CAAC,EAAE,SAAS,CAAC;QAClF,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAe,EACf,GAAW,EACX,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,wBAAwB,CAAC,CAAA;AACjF,CAAC;AASD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA8B;IACjE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAAA;IACxD,OAAO,GAAG,sBAAsB;;;;;eAKnB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;iBACtB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;qBACtB,cAAc,GAAG,IAAI;0BAChB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFjD,CAAA;AACD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB;IAEhB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/C,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzD,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,kCAAkC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACnF,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAC3D,IAAI,CAAC;QACH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAW;YAChC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAW;YACpC,OAAO,EAAE,OAAO,KAAK,wBAAwB;SAC9C,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/readiness.d.ts

@@ -0,0 +1,87 @@
+/**
+ * What "set up" means, in one place.
+ *
+ * `init` and `doctor` used to each carry their own idea of this — a fixed
+ * five-step script in one, a flat list of checks in the other — which is two
+ * copies of the same knowledge that can disagree, and did: doctor called
+ * missing hooks fine while init offered to install them, and only doctor knew
+ * what a revoked credential looked like.
+ *
+ * So the model lives here and both commands render it. `doctor` shows every
+ * state at once, because a report is what it is for. `init` walks the same
+ * list in order and stops at the first thing standing in the way, because
+ * someone handed five tasks does none of them. An agent gets the same states
+ * through a third renderer that never prompts.
+ *
+ * The ordering is a dependency chain, not a preference: there is no point
+ * asking the server about devices before there is a credential to ask with,
+ * and no point reporting a stale contract to someone who cannot reach the
+ * server at all. Assessment stops descending when a prerequisite is missing
+ * and marks what follows `unknown` rather than guessing.
+ */
+/** Whether the gap can be closed from here, and by whom. */
+export type Remedy = 
+/**
+ * The CLI can do it unattended — no prompt, no human. `command` is how a
+ * reader would ask for it later, for the case where it was declined or
+ * skipped; it is never needed to perform the action.
+ */
+{
+    by: 'cli';
+    summary: string;
+    command?: string;
+}
+/**
+ * A human at this terminal. `interactive` marks the ones the CLI can drive
+ * on their behalf when someone is actually watching — a browser sign-in is
+ * the CLI's to launch but the human's to complete, so an agent must still
+ * treat it as out of reach.
+ */
+ | {
+    by: 'user-here';
+    summary: string;
+    command: string;
+    interactive?: boolean;
+}
+/**
+ * A human somewhere else entirely — phone in hand, app store, permission
+ * dialog. The class the old init could only print a sentence about, and the
+ * one most likely to end an onboarding.
+ */
+ | {
+    by: 'user-elsewhere';
+    summary: string;
+};
+export type StateStatus = 
+/** Satisfied. */
+'ready'
+/** Not satisfied, and it stands in the way. */
+ | 'gap'
+/** Not satisfied, and that is a legitimate choice. */
+ | 'optional-gap'
+/** A prerequisite is missing, so this was never evaluated. */
+ | 'unknown';
+export interface ReadinessState {
+    id: string;
+    /** Human words for what this is, not the field name. */
+    title: string;
+    status: StateStatus;
+    /** The current condition, phrased so it reads under either renderer. */
+    detail: string;
+    remedy?: Remedy;
+}
+export interface Readiness {
+    states: ReadinessState[];
+}
+/** The first thing standing in the way, or null when nothing is. */
+export declare function firstBlocker(readiness: Readiness): ReadinessState | null;
+/**
+ * Ready enough to be useful, which is not the same as every box ticked.
+ *
+ * Hooks and the agent skill are genuinely optional — `send` works without
+ * them — so an install that declined both is finished, not half-done. Saying
+ * otherwise trains people to ignore the summary line.
+ */
+export declare function isReady(readiness: Readiness): boolean;
+/** Everything that could still be done, blocking or not, in dependency order. */
+export declare function openItems(readiness: Readiness): ReadinessState[];

package/dist/readiness.js

@@ -0,0 +1,40 @@
+/**
+ * What "set up" means, in one place.
+ *
+ * `init` and `doctor` used to each carry their own idea of this — a fixed
+ * five-step script in one, a flat list of checks in the other — which is two
+ * copies of the same knowledge that can disagree, and did: doctor called
+ * missing hooks fine while init offered to install them, and only doctor knew
+ * what a revoked credential looked like.
+ *
+ * So the model lives here and both commands render it. `doctor` shows every
+ * state at once, because a report is what it is for. `init` walks the same
+ * list in order and stops at the first thing standing in the way, because
+ * someone handed five tasks does none of them. An agent gets the same states
+ * through a third renderer that never prompts.
+ *
+ * The ordering is a dependency chain, not a preference: there is no point
+ * asking the server about devices before there is a credential to ask with,
+ * and no point reporting a stale contract to someone who cannot reach the
+ * server at all. Assessment stops descending when a prerequisite is missing
+ * and marks what follows `unknown` rather than guessing.
+ */
+/** The first thing standing in the way, or null when nothing is. */
+export function firstBlocker(readiness) {
+    return readiness.states.find((s) => s.status === 'gap') ?? null;
+}
+/**
+ * Ready enough to be useful, which is not the same as every box ticked.
+ *
+ * Hooks and the agent skill are genuinely optional — `send` works without
+ * them — so an install that declined both is finished, not half-done. Saying
+ * otherwise trains people to ignore the summary line.
+ */
+export function isReady(readiness) {
+    return firstBlocker(readiness) === null;
+}
+/** Everything that could still be done, blocking or not, in dependency order. */
+export function openItems(readiness) {
+    return readiness.states.filter((s) => s.status === 'gap' || s.status === 'optional-gap');
+}
+//# sourceMappingURL=readiness.js.map

package/dist/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAgDH,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,SAAoB;IAC/C,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,IAAI,CAAA;AACjE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,SAAoB;IAC1C,OAAO,YAAY,CAAC,SAAS,CAAC,KAAK,IAAI,CAAA;AACzC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,SAAoB;IAC5C,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,cAAc,CAAC,CAAA;AAC1F,CAAC"}