@raidiant/notifai 10.1.7 → 11.0.2

package/dist/commands-hook-diagnostics.d.ts

@@ -0,0 +1,27 @@
+/** User-facing diagnosis and recovery guidance for hook readiness. */
+import { type CommandDeps } from './commands-core.js';
+import { type ActiveHarnessSession } from './commands-harness-context.js';
+import { type Installation } from './install-hooks.js';
+export declare const CODEX_HOOK_APPROVAL_USER_ACTION: {
+    readonly code: "codex_hook_approval_required";
+    readonly harness: "codex";
+    readonly action: "approve_or_enable_notifai_hooks";
+    readonly message: "Open `/hooks` in Codex, approve or enable the Notifai handlers, then tell me when it is done. I will finish setup and verify a fresh session.";
+};
+export declare const CODEX_FRESH_SESSION_USER_ACTION: {
+    readonly code: "codex_fresh_session_required";
+    readonly harness: "codex";
+    readonly action: "start_fresh_codex_session";
+    readonly message: "Start one fresh Codex session, send one prompt in it, then retry the question.";
+};
+export declare const CODEX_STALE_STOP_DEFINITION_PROBLEM = "the exact Codex Agent Session activated before the current Stop definition; Codex can keep the earlier timeout in that session even when the file on disk is current. Start one fresh Codex session, send one prompt in it, then retry";
+export declare const CODEX_STOP_DEFINITION_NOT_SINGULAR_PROBLEM = "the active Codex configuration does not contain exactly one Notifai Stop definition, so no singular turn-end owner can be proven";
+/**
+ * One fail-closed admission gate shared by every active harness route.
+ * Finding a file is not readiness: the exact session, one current definition,
+ * the stable adapter, a long enough Stop owner, and (for Codex) trust must all
+ * be true before `ask` is allowed to create an answerable notification.
+ */
+export declare function activeQuestionRouteProblems(deps: CommandDeps, active: ActiveHarnessSession, installations: Installation[]): string[];
+/** The least disruptive verified way to make each installed adapter run once. */
+export declare function hookActivationAdvice(installations: Installation[]): string;

package/dist/commands-hook-diagnostics.js

@@ -0,0 +1,97 @@
+/** User-facing diagnosis and recovery guidance for hook readiness. */
+import {} from './commands-core.js';
+import {} from './commands-harness-context.js';
+import { stopShapeProblems } from './commands-hook-shape.js';
+import { HERMES_QUESTION_ROUTING_UNAVAILABLE, isHookInstallableHarness, questionRoutingCapability, } from './harnesses.js';
+import { inspectHookAdapter } from './hook-adapter.js';
+import { HOOK_EVENTS } from './hook-events.js';
+import { readSessionState } from './hook-session-state.js';
+import { codexStopDefinitionFingerprint, codexTrustProblems, handlerEvent, } from './install-hooks.js';
+export const CODEX_HOOK_APPROVAL_USER_ACTION = {
+    code: 'codex_hook_approval_required',
+    harness: 'codex',
+    action: 'approve_or_enable_notifai_hooks',
+    message: 'Open `/hooks` in Codex, approve or enable the Notifai handlers, then tell me when it is done. I will finish setup and verify a fresh session.',
+};
+export const CODEX_FRESH_SESSION_USER_ACTION = {
+    code: 'codex_fresh_session_required',
+    harness: 'codex',
+    action: 'start_fresh_codex_session',
+    message: 'Start one fresh Codex session, send one prompt in it, then retry the question.',
+};
+export const CODEX_STALE_STOP_DEFINITION_PROBLEM = 'the exact Codex Agent Session activated before the current Stop definition; Codex can keep the earlier timeout in that session even when the file on disk is current. Start one fresh Codex session, send one prompt in it, then retry';
+export const CODEX_STOP_DEFINITION_NOT_SINGULAR_PROBLEM = 'the active Codex configuration does not contain exactly one Notifai Stop definition, so no singular turn-end owner can be proven';
+/**
+ * One fail-closed admission gate shared by every active harness route.
+ * Finding a file is not readiness: the exact session, one current definition,
+ * the stable adapter, a long enough Stop owner, and (for Codex) trust must all
+ * be true before `ask` is allowed to create an answerable notification.
+ */
+export function activeQuestionRouteProblems(deps, active, installations) {
+    const problems = [];
+    if (active.sessionId === undefined) {
+        problems.push(`the active ${active.label} shell does not expose an exact session id; a project-level last-writer pointer can cross-wire two sessions. Use a blocking \`notifai send --reply\` question`);
+    }
+    const capability = isHookInstallableHarness(active.harness)
+        ? questionRoutingCapability(active.harness, deps.hookPlatform ?? process.platform)
+        : HERMES_QUESTION_ROUTING_UNAVAILABLE;
+    if (capability.stopContinuation === 'unsupported') {
+        problems.push(`${active.label}: ${capability.deliveryContract}`);
+    }
+    const matching = installations.filter((installation) => installation.harness === active.harness);
+    if (matching.length > 1) {
+        problems.push(`${matching.length} ${active.label} definitions are active (${matching.map((entry) => entry.file).join(', ')}); reinstall so exactly one remains`);
+    }
+    for (const installation of matching) {
+        for (const problem of installation.problems ?? []) {
+            problems.push(`${installation.file}: ${problem}`);
+        }
+        for (const handler of installation.handlers) {
+            const event = handlerEvent(handler.command);
+            if (event !== null && !HOOK_EVENTS.includes(event)) {
+                problems.push(`${handler.event} in ${installation.file} names the unsupported event ${event}; reinstall the ${active.label} hooks`);
+            }
+        }
+    }
+    for (const problem of inspectHookAdapter(deps.hookAdapterHome, deps.hookPlatform).problems) {
+        problems.push(problem);
+    }
+    for (const installation of matching)
+        problems.push(...stopShapeProblems(installation, deps.hookPlatform));
+    problems.push(...codexTrustProblems(matching, deps.env));
+    if (active.harness === 'codex' && active.sessionId !== undefined) {
+        const state = readSessionState(active.sessionId, deps.env);
+        const currentFingerprint = codexStopDefinitionFingerprint(matching);
+        if (matching.length === 1 && currentFingerprint === undefined) {
+            problems.push(CODEX_STOP_DEFINITION_NOT_SINGULAR_PROBLEM);
+        }
+        else if (currentFingerprint !== undefined &&
+            state.harness === 'codex' &&
+            state.codex_stop_definition_fingerprint !== currentFingerprint) {
+            problems.push(CODEX_STALE_STOP_DEFINITION_PROBLEM);
+        }
+    }
+    return [...new Set(problems)];
+}
+/** The least disruptive verified way to make each installed adapter run once. */
+export function hookActivationAdvice(installations) {
+    const harnesses = new Set(installations.map((installation) => installation.harness));
+    const advice = [];
+    if (harnesses.has('claude-code')) {
+        advice.push('Claude Code: start one fresh session, send one prompt, then run `notifai doctor`');
+    }
+    if (harnesses.has('cursor')) {
+        advice.push('Cursor: start one fresh conversation, send one prompt, finish its first turn, then run `notifai doctor`');
+    }
+    if (harnesses.has('codex')) {
+        advice.push('Codex: start one fresh session, send one prompt, then run `notifai doctor`; the separate Codex hook trust check says explicitly if `/hooks` needs your attention');
+    }
+    if (harnesses.has('opencode')) {
+        advice.push('OpenCode: restart it, then send one prompt; plugins load at startup, but non-blocking question continuation is intentionally unsupported');
+    }
+    if (harnesses.has('openclaw')) {
+        advice.push('OpenClaw: restart the Gateway, then send one prompt; plugins load at startup, but non-blocking question continuation is intentionally unsupported');
+    }
+    return `${advice.join('. ')}.`;
+}
+//# sourceMappingURL=commands-hook-diagnostics.js.map

package/dist/commands-hook-diagnostics.js.map

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

package/dist/commands-hook-install.d.ts

@@ -0,0 +1,26 @@
+import { type CommandDeps } from './commands-core.js';
+import { type HookInstallableHarness } from './harnesses.js';
+export interface HooksInstallFlags {
+    harness?: string;
+    /** Init owns the final setup result and suppresses per-harness close narration. */
+    narrate?: boolean;
+    /** Test seam; production resolves the running CLI. */
+    execPath?: string;
+    scriptPath?: string;
+}
+/** True when this process is `npx` / `npm exec`, not a global or linked install. */
+export declare function runningViaNpx(env: NodeJS.ProcessEnv, scriptPath: string): boolean;
+export declare function hooksInstallCommand(deps: CommandDeps, flags: HooksInstallFlags): number;
+export declare function hooksUninstallCommand(deps: CommandDeps, flags: HooksInstallFlags): number;
+/**
+ * Remove Notifai's own Project-scoped definitions discoverable from this
+ * Project. Foreign handlers sharing those files are never touched, and a file
+ * Notifai did not write is never deleted.
+ */
+export declare function removeLegacyProjectInstallations(deps: CommandDeps, harness: HookInstallableHarness, scriptPath: string): void;
+/**
+ * Which harnesses to wire. An explicit `--harness` still wins as a singleton.
+ * Otherwise: every detected harness, or a human picker when detection is empty
+ * or names more than one.
+ */
+export declare function pickHarnessesToInstall(deps: CommandDeps, requested?: string): Promise<HookInstallableHarness[] | null>;