@raidiant/notifai 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -8,6 +8,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
 and [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
 
+## [1.1.0](https://github.com/Raidiant-io/notifai/compare/v1.0.1...v1.1.0) (2026-08-13)
+
+
+### Features
+
+* **cli:** support Windows and Linux harness workflows ([779ab6b](https://github.com/Raidiant-io/notifai/commit/779ab6b075900a7a431b809ddcb715fd80836688))
+
+
+### Bug Fixes
+
+* **cli:** cover Windows terminal behavior ([cda7abd](https://github.com/Raidiant-io/notifai/commit/cda7abd134744b2cac44204dd3eb1b20b9038edc))
+* **cli:** isolate Codex hooks and reply routing ([#1](https://github.com/Raidiant-io/notifai/issues/1)) ([d060b6a](https://github.com/Raidiant-io/notifai/commit/d060b6a18b5937d82f74619a6c1bc711243be26c))
+* **cli:** keep Codex hook install on ~/.codex, ignore CODEX_HOME ([3f75f13](https://github.com/Raidiant-io/notifai/commit/3f75f131c24534d3813a336bb72422f78e24a972))
+* **cli:** preserve Codex hook trust on reinstall ([#3](https://github.com/Raidiant-io/notifai/issues/3)) ([5e2c2f4](https://github.com/Raidiant-io/notifai/commit/5e2c2f4d618276573f810a989f41a89ab1053564))
+* **cli:** report observed setup receipts ([99d04bb](https://github.com/Raidiant-io/notifai/commit/99d04bbd487681db3023468fbd88b77a1ba13ceb))
+* **cli:** stabilize Linux portability checks ([1462693](https://github.com/Raidiant-io/notifai/commit/146269306ae3dfc91f3559cce802460d3e058925))
+
 ## [Unreleased]
 
 ## [1.0.1] - 2026-08-13

package/README.md

@@ -56,6 +56,10 @@ For a harness that cannot resume an idle agent turn, `notifai send
 
 ## Agent harnesses
 
+The CLI and managed hook adapters support macOS, Linux, and Windows. Receiving
+still requires the current iPhone or macOS Companion App; native Windows and
+Linux Companion Apps are not shipped yet.
+
 ```sh
 notifai hooks install
 ```
@@ -67,13 +71,19 @@ or add one it did not see. This is what lets an agent's question reach
 your phone without the agent having to cooperate — no question detection,
 no state in a context window that compaction will eat.
 
-Every harness definition calls one stable user-level adapter at
-`~/.notifai/bin/hook-adapter`. Node, package manager, CLI version, checkout,
-XDG directories, and notification preferences are resolved behind it, so
-upgrades and configuration changes do not rewrite trusted hook definitions.
-The first migration may require one Codex `/hooks` approval; later repairs keep
-the same identity. Codex's Stop definition omits its timeout so the host default
-remains authoritative; prompt-submit and session-end retain fixed short limits.
+Every harness definition calls one stable user-level adapter under the account
+home (`~/.notifai/bin/hook-adapter` on macOS/Linux and the corresponding user
+profile path on Windows). Node, package manager, CLI version, checkout,
+configuration directories, and notification preferences are resolved behind
+it, so upgrades and configuration changes do not rewrite trusted hook
+definitions. Windows invokes its JavaScript adapter through the registered Node
+executable; macOS/Linux retain the POSIX adapter and its stable command bytes.
+Claude Code Stop returns immediately into the live inbox route on macOS/Linux;
+on Windows, where upstream exposes no inbox socket, Stop stays open and returns
+the accepted answer through the harness continuation. The first migration may
+require one Codex `/hooks` approval; later repairs keep the same identity.
+Codex's Stop definition omits its timeout so the host default remains
+authoritative; prompt-submit and session-end retain fixed short limits.
 
 `notifai doctor` compares Codex trust on a best-effort basis against Codex's
 current persisted representation. Notifai never writes that trust store;

package/dist/commands.d.ts

@@ -61,6 +61,8 @@ export interface CommandDeps {
     hookAdapterHome?: string;
     /** Test seam; production uses this process's Node and CLI paths. */
     hookInstallTarget?: HookAdapterTarget;
+    /** Test seam; production uses process.platform for adapter format and quoting. */
+    hookPlatform?: NodeJS.Platform;
     /** Test seam; production uses fetch against base_url. */
     clientFactory?: (baseUrl: string, bearer: string | null, options?: ClientOptions) => ApiClient;
     /** Test seam for bounded polling without wall-clock sleeps. */

package/dist/commands.js

@@ -1,5 +1,4 @@
 import { createHash, randomBytes } from 'node:crypto';
-import { spawn } from 'node:child_process';
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, rmSync, unlinkSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -7,7 +6,7 @@ import { parse as parseToml, stringify as stringifyToml } from 'smol-toml';
 import { CAPABILITIES_V1, QUESTION_TEXT_MAX_LENGTH, REPLY_MAX_QUESTIONS, REPLY_MAX_WINDOW_SECONDS, validateDraft, } from '@raidiant/notifai-protocol';
 import { sha256Hex } from '@raidiant/notifai-protocol/node';
 import { ApiCallError, NetworkError, createClient, isRetryableReplyPollError, } from './client.js';
-import { BOOLEAN_CONFIG_KEYS, CONFIG_KEYS, LOG_LEVELS, NUMERIC_CONFIG_KEYS, configBounds, configDefaultValue, findProjectConfigPath, personalProjectConfigPath, globalConfigPath, loadConfig, sessionConfigPath, } from './config.js';
+import { BOOLEAN_CONFIG_KEYS, CONFIG_KEYS, LOG_LEVELS, NUMERIC_CONFIG_KEYS, configBounds, configDefaultValue, findProjectConfigPath, personalProjectConfigPath, globalConfigPath, loadConfig, sessionConfigPath, stateDir, } from './config.js';
 import { acceptedValues, configInfo } from './config-schema.js';
 import { packageVersion, skillsSource } from './release.js';
 import { atomicWriteFileSync } from './atomic-file.js';
@@ -23,6 +22,7 @@ import { codexWakeRoute, inspectCodexResume, } from './codex-wake.js';
 import { inspectHookAdapter, installHookAdapter, isNpxAdapterTarget, } from './hook-adapter.js';
 import { isOurOpencodePlugin, opencodePluginSource, } from './opencode-plugin.js';
 import { CHOICE_USAGE, buildDraft, formatReceipt, parseChoices, receiptExitCode, slugify, } from './send.js';
+import { openUrl } from './platform.js';
 /** The invocation's logger, or one that discards everything. */
 export function log(deps) {
     return deps.logger ?? nullLogger();
@@ -1128,6 +1128,8 @@ function stopWakeRoute(deps, harness, sessionId, cwd) {
     if (sessionId === undefined)
         return undefined;
     if (harness === 'claude-code') {
+        if ((deps.hookPlatform ?? process.platform) === 'win32')
+            return undefined;
         return claudeWakeRoute({
             sessionId,
             cwd,
@@ -1316,7 +1318,7 @@ export function askCommand(deps, question, flags) {
     const { active, contested } = resolveActiveHarness(deps.env, deps.cwd, now);
     let sessionId;
     if (active !== null) {
-        const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+        const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
         const activeInstalled = installations.some((installation) => installation.harness === active.harness);
         if (!activeInstalled) {
             for (const line of diagnoseActiveHarnessSession(active, 'not-installed', installations, contested)) {
@@ -1518,11 +1520,11 @@ function activeQuestionRouteProblems(deps, active, installations) {
             }
         }
     }
-    for (const problem of inspectHookAdapter(deps.hookAdapterHome).problems) {
+    for (const problem of inspectHookAdapter(deps.hookAdapterHome, deps.hookPlatform).problems) {
         problems.push(problem);
     }
     for (const installation of matching)
-        problems.push(...stopShapeProblems(installation));
+        problems.push(...stopShapeProblems(installation, deps.hookPlatform));
     problems.push(...codexTrustProblems(matching, deps.env));
     return [...new Set(problems)];
 }
@@ -1574,7 +1576,7 @@ function diagnoseActiveHarnessSession(active, problem, installations, contested
  * checked after a prompt before assuming that a new session is required.
  */
 function diagnoseMissingSession(deps) {
-    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
     if (installations.length === 0) {
         return [
             'Could not tell which harness session this is: no Notifai hooks are installed for this project.',
@@ -1687,16 +1689,18 @@ export function hooksInstallCommand(deps, flags) {
         return EXIT.usage;
     const adapterTarget = resolveHookAdapterTarget(deps, flags);
     const scriptPath = flags.scriptPath ?? fileHookInstallTarget(adapterTarget)?.scriptPath ?? process.argv[1] ?? 'notifai';
+    const hookPlatform = deps.hookPlatform ?? process.platform;
+    const nodePath = adapterTarget.execPath;
     let adapterPath;
     try {
-        adapterPath = installHookAdapter(adapterTarget, deps.hookAdapterHome).path;
+        adapterPath = installHookAdapter(adapterTarget, deps.hookAdapterHome, hookPlatform).path;
     }
     catch (err) {
         deps.io.err(`Could not prepare the stable hook adapter: ${String(err)}`);
         return EXIT.failed;
     }
     const wantGlobal = flags.global === true;
-    const existing = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome).filter((installation) => installation.harness === harness);
+    const existing = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform).filter((installation) => installation.harness === harness);
     const otherScope = existing.filter((installation) => installation.global !== wantGlobal);
     if (!wantGlobal && otherScope.some((installation) => installation.global)) {
         const globalFile = otherScope.find((installation) => installation.global)?.file;
@@ -1708,13 +1712,15 @@ export function hooksInstallCommand(deps, flags) {
             return EXIT.failed;
         }
     }
-    const file = settingsFile(harness, wantGlobal, deps.cwd, deps.env);
+    const file = settingsFile(harness, wantGlobal, deps.cwd, deps.env, hookPlatform);
     // OpenCode's adapter is a generated plugin module rather than a handler
     // merged into a settings document, so it owns the whole file.
     if (harness === 'opencode') {
         return installOpencodePlugin(deps, file, {
             adapterPath,
             timeoutSeconds: BLOCKING_STOP_TIMEOUT_SECONDS,
+            platform: hookPlatform,
+            nodePath,
         });
     }
     if (harness === 'cursor') {
@@ -1724,6 +1730,8 @@ export function hooksInstallCommand(deps, flags) {
                 const result = mergeCursorHooks(document, buildCursorHookConfig({
                     adapterPath,
                     harness: 'cursor',
+                    platform: hookPlatform,
+                    nodePath,
                 }), scriptPath);
                 applyPlan(file, result.document);
                 return result;
@@ -1745,6 +1753,8 @@ export function hooksInstallCommand(deps, flags) {
             const result = mergeHooks(document, buildHookConfig({
                 adapterPath,
                 harness,
+                platform: hookPlatform,
+                nodePath,
             }), scriptPath);
             applyPlan(file, result.document);
             return result;
@@ -1818,7 +1828,7 @@ export function hooksUninstallCommand(deps, flags) {
     if (!harness)
         return EXIT.usage;
     const scriptPath = flags.scriptPath ?? process.argv[1] ?? 'notifai';
-    const file = settingsFile(harness, flags.global ?? false, deps.cwd, deps.env);
+    const file = settingsFile(harness, flags.global ?? false, deps.cwd, deps.env, deps.hookPlatform);
     if (harness === 'opencode') {
         try {
             return withTargetFileLock(file, () => {
@@ -2515,9 +2525,7 @@ function setupProofPath(deps) {
         // the resolved absolute path is still a stable local identity for it.
     }
     const digest = createHash('sha256').update(projectDir).digest('hex').slice(0, 32);
-    const xdg = deps.env['XDG_STATE_HOME'];
-    const base = xdg && xdg !== '' ? xdg : path.join(os.homedir(), '.local', 'state');
-    return path.join(base, 'notifai', 'setup-proofs', `${digest}.json`);
+    return path.join(stateDir(deps.env), 'setup-proofs', `${digest}.json`);
 }
 function readSetupProof(deps) {
     const file = setupProofPath(deps);
@@ -2816,6 +2824,7 @@ async function runSetupProof(deps) {
             const observed = observedCompanionReceipt(snapshot, proof.device_id);
             if (observed) {
                 spinner?.stop(`Receipt observed from ${observed.delivery.device_name}`);
+                deps.io.out(`Companion Receipt (the app's delivery confirmation) observed from ${observed.delivery.device_name}.`);
                 return 'closed';
             }
             lastError = null;
@@ -3559,7 +3568,7 @@ function remedyLine(state) {
  * is, is each check's own call (`HookCheck`).
  */
 function hookStates(deps) {
-    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
     const active = activeHarnessSession(deps.env, deps.cwd, (deps.now ?? Date.now)());
     const config = loadLoggedConfig(deps, { cwd: deps.cwd, env: deps.env });
     const settings = {
@@ -3647,12 +3656,12 @@ function hookStates(deps) {
  *     hashes into `trusted_hash`, and an untrusted handler is simply not run.
  *   - Everything else blocks its turn and needs a ceiling above the wait.
  */
-function stopShapeProblems(installation) {
+function stopShapeProblems(installation, platform = process.platform) {
     if (installation.harness === 'codex')
         return [];
     const problems = [];
     for (const handler of installation.handlers.filter((entry) => handlerEvent(entry.command) === 'stop')) {
-        if (installation.harness === 'claude-code') {
+        if (installation.harness === 'claude-code' && platform !== 'win32') {
             if (handler.async !== true) {
                 problems.push(`${installation.file} declares a blocking Stop handler; the Claude Code wake route needs \`async: true\` so the turn ends while the waiter runs`);
             }
@@ -3669,7 +3678,7 @@ function stopShapeProblems(installation) {
 }
 function hookChecks(deps) {
     const checks = [];
-    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome);
+    const installations = findInstallations(deps.cwd, deps.env, deps.hookAdapterHome, deps.hookPlatform);
     // Not having hooks is a setup someone chose, not a fault: `send` works
     // without them. A setup that cannot work is what deserves to go red.
     if (installations.length === 0) {
@@ -3766,7 +3775,7 @@ function hookChecks(deps) {
             : `${stale.join('; ')} — rerun \`notifai hooks install\` to drop ${stale.length === 1 ? 'it' : 'them'}`,
     });
     const adapterProblems = installations.flatMap((installation) => (installation.problems ?? []).map((problem) => `${installation.file}: ${problem}`));
-    const sharedAdapter = inspectHookAdapter(deps.hookAdapterHome);
+    const sharedAdapter = inspectHookAdapter(deps.hookAdapterHome, deps.hookPlatform);
     adapterProblems.push(...sharedAdapter.problems);
     if (adapterProblems.length > 0) {
         checks.push({
@@ -3794,7 +3803,7 @@ function hookChecks(deps) {
                 },
             }),
     });
-    const shapeProblems = installations.flatMap((installation) => stopShapeProblems(installation).map((problem) => `${problem} — run \`notifai hooks install --harness ${installation.harness}${installation.global ? ' --global' : ''}\``));
+    const shapeProblems = installations.flatMap((installation) => stopShapeProblems(installation, deps.hookPlatform).map((problem) => `${problem} — run \`notifai hooks install --harness ${installation.harness}${installation.global ? ' --global' : ''}\``));
     checks.push({
         name: 'hooks (stop shape)',
         ok: shapeProblems.length === 0,
@@ -3963,7 +3972,7 @@ function wakeRouteCheck(deps, active, activeInstallations) {
     if (active.harness === 'claude-code') {
         const readiness = inspectClaudeInbox({
             pid: deps.claudeSourcePid ?? claudeSessionPid(deps.env),
-            platform: process.platform,
+            platform: deps.hookPlatform ?? process.platform,
             readDescriptor: deps.claudeWake?.readDescriptor ?? systemClaudeWakeAdapters(deps.env).readDescriptor,
             socketExists: (socketPath) => existsSync(socketPath),
         });
@@ -3978,7 +3987,7 @@ function wakeRouteCheck(deps, active, activeInstallations) {
     }
     if (active.harness === 'codex') {
         const readiness = inspectCodexResume(deps.env, {
-            platform: process.platform,
+            platform: deps.hookPlatform ?? process.platform,
             directoryExists: (directory) => existsSync(directory),
         });
         return {
@@ -4133,24 +4142,7 @@ export function realIo(env = process.env) {
                     return log.error(message);
             }
         },
-        openUrl: (url) => {
-            try {
-                if (process.platform === 'darwin') {
-                    spawn('open', [url], { stdio: 'ignore', detached: true }).unref();
-                }
-                else if (process.platform === 'win32') {
-                    // `start` is a cmd builtin; spawn('start', …) cannot work on Windows.
-                    // Empty title argument keeps URLs with special characters intact.
-                    spawn('cmd', ['/c', 'start', '', url], { stdio: 'ignore', detached: true }).unref();
-                }
-                else {
-                    spawn('xdg-open', [url], { stdio: 'ignore', detached: true }).unref();
-                }
-            }
-            catch {
-                // Browser opening is best-effort; the URL is printed anyway.
-            }
-        },
+        openUrl,
     };
 }
 //# sourceMappingURL=commands.js.map