@coralai/nps-cli 0.1.0

package/dist/gateway/matrix-gateway.js

@@ -0,0 +1,166 @@
+/**
+ * M5b — MatrixGateway production.
+ *
+ * Direct matrix-js-sdk@41 client (lib decision from M5a). DM-only:
+ *  - encrypted rooms refused with reply
+ *  - multi-participant rooms refused
+ *  - final-only reply (no streaming) per CEO plan rev 5 Q2 resolution
+ *  - typing indicator during agent run
+ *  - basic reconnect on transient errors
+ *
+ * Token revoke is detected via 401 — gateway logs but does NOT crash daemon
+ * (so admin can fix config and `nps daemon stop && start`).
+ */
+import { createClient, RoomEvent } from 'matrix-js-sdk';
+import { getLogger } from '../logger.js';
+export class MatrixGateway {
+    config;
+    pipeline;
+    logger;
+    client;
+    dispatching = false;
+    stopRequested = false;
+    constructor(config, pipeline, logger) {
+        this.config = config;
+        this.pipeline = pipeline;
+        this.logger = logger ?? getLogger('matrix-gateway');
+    }
+    async start() {
+        this.client = createClient({
+            baseUrl: this.config.homeserver,
+            accessToken: this.config.accessToken,
+            userId: this.config.userId,
+        });
+        await new Promise((resolve, reject) => {
+            const onSync = (state) => {
+                if (state === 'PREPARED' || state === 'SYNCING') {
+                    this.client?.removeListener('sync', onSync);
+                    resolve();
+                }
+                else if (state === 'ERROR') {
+                    this.client?.removeListener('sync', onSync);
+                    reject(new Error('sync entered ERROR state — check Matrix token / homeserver'));
+                }
+            };
+            this.client?.on('sync', onSync);
+            void this.client?.startClient({ initialSyncLimit: 5 }).catch(reject);
+            setTimeout(() => reject(new Error('sync timeout after 30s')), 30_000);
+        });
+        this.client?.on(RoomEvent.Timeline, (event, room) => this.onTimeline(event, room));
+        this.logger.info({ homeserver: this.config.homeserver, userId: this.config.userId }, 'matrix gateway connected');
+    }
+    async stop() {
+        this.stopRequested = true;
+        if (this.client) {
+            try {
+                this.client.stopClient();
+            }
+            catch { /* ignore */ }
+            this.client = undefined;
+        }
+        this.logger.info('matrix gateway stopped');
+    }
+    onTimeline(event, room) {
+        if (this.stopRequested || !this.client || !room)
+            return;
+        if (event.getType() !== 'm.room.message')
+            return;
+        // Ignore historic events from initial sync
+        if (event.getTs() < Date.now() - 60_000)
+            return;
+        // Ignore our own messages
+        if (event.getSender() === this.config.userId)
+            return;
+        // Ignore non-text content
+        const content = event.getContent();
+        if (content.msgtype !== 'm.text' || typeof content.body !== 'string')
+            return;
+        void this.handleMessage(event, room);
+    }
+    async handleMessage(event, room) {
+        if (this.dispatching) {
+            // v0.1 single-flight: queue or reject? Plan says single-user, so reject with reply.
+            this.logger.info({ eventId: event.getId(), room: room.roomId }, 'busy with prior turn — replying busy');
+            try {
+                await this.client?.sendTextMessage(room.roomId, '⏳ previous turn still in progress, please wait');
+            }
+            catch { /* ignore */ }
+            return;
+        }
+        // DM-only enforcement
+        const memberCount = room.getJoinedMembers().length;
+        if (memberCount !== 2) {
+            this.logger.info({ room: room.roomId, members: memberCount }, 'refusing non-DM room');
+            try {
+                await this.client?.sendTextMessage(room.roomId, '⛔ nps v0.1 supports direct messages only. Multi-participant rooms are not yet supported.');
+            }
+            catch { /* ignore */ }
+            return;
+        }
+        // Encryption refusal
+        const isEncrypted = !!room.currentState.getStateEvents('m.room.encryption', '');
+        if (isEncrypted) {
+            this.logger.info({ room: room.roomId }, 'refusing encrypted room');
+            try {
+                await this.client?.sendTextMessage(room.roomId, '🔒 nps v0.1 ships with E2EE disabled. Please use an unencrypted DM.');
+            }
+            catch { /* ignore */ }
+            return;
+        }
+        this.dispatching = true;
+        try {
+            const sender = event.getSender();
+            const eventId = event.getId();
+            const text = event.getContent()['body'];
+            if (!sender || !eventId) {
+                this.logger.warn({ eventId, sender }, 'incoming event missing required fields');
+                return;
+            }
+            const incoming = {
+                channelId: room.roomId,
+                eventId,
+                text,
+                sender: `matrix:${sender}`,
+                transport: 'matrix',
+            };
+            const reply = this.makeReplyTarget(room);
+            await this.pipeline.dispatch(incoming, reply);
+        }
+        catch (e) {
+            this.logger.error({ err: e instanceof Error ? e.message : e }, 'dispatch failed');
+        }
+        finally {
+            this.dispatching = false;
+        }
+    }
+    makeReplyTarget(room) {
+        const client = this.client;
+        if (!client) {
+            return { send: async () => { } };
+        }
+        const typingMs = this.config.typingTimeoutMs ?? 20_000;
+        return {
+            startTyping: async () => {
+                try {
+                    await client.sendTyping(room.roomId, true, typingMs);
+                }
+                catch { /* ignore */ }
+            },
+            stopTyping: async () => {
+                try {
+                    await client.sendTyping(room.roomId, false, 0);
+                }
+                catch { /* ignore */ }
+            },
+            send: async (text) => {
+                try {
+                    await client.sendTextMessage(room.roomId, text);
+                }
+                catch (e) {
+                    this.logger.error({ err: e instanceof Error ? e.message : e, room: room.roomId }, 'sendTextMessage failed');
+                }
+            },
+        };
+    }
+}
+//# sourceMappingURL=matrix-gateway.js.map

package/dist/gateway/matrix-gateway.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * M13 — structured logger.
+ *
+ * pino → stdout. Under systemd, journald captures stdout; `journalctl --user -u nps.service`
+ * shows JSON lines. Outside systemd, plain JSON to stdout.
+ *
+ * Module-level child loggers via `getLogger(name)` for namespaced output.
+ */
+import { type Logger } from 'pino';
+declare const rootLogger: Logger<never, boolean>;
+export declare function getLogger(name: string): Logger;
+export { rootLogger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAEzC,QAAA,MAAM,UAAU,wBAId,CAAC;AAEH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/logger.js

@@ -0,0 +1,19 @@
+/**
+ * M13 — structured logger.
+ *
+ * pino → stdout. Under systemd, journald captures stdout; `journalctl --user -u nps.service`
+ * shows JSON lines. Outside systemd, plain JSON to stdout.
+ *
+ * Module-level child loggers via `getLogger(name)` for namespaced output.
+ */
+import { pino } from 'pino';
+const rootLogger = pino({
+    level: process.env['NPS_LOG_LEVEL'] ?? 'info',
+    base: { app: 'nps-cli' },
+    timestamp: pino.stdTimeFunctions.isoTime,
+});
+export function getLogger(name) {
+    return rootLogger.child({ mod: name });
+}
+export { rootLogger };
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAe,MAAM,MAAM,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,MAAM;IAC7C,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;IACxB,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;CACzC,CAAC,CAAC;AAEH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * nps — entrypoint. Routes to src/cli/index.ts.
+ */
+import { runCli } from './cli/index.js';
+void runCli(process.argv).then(code => process.exit(code));
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC"}

package/dist/profile/profile-registry.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter } from 'node:events';
+import type { Logger } from 'pino';
+import type { ProfileConfig } from '../config/schema.js';
+export interface ProfileEntry {
+    name: string;
+    dir: string;
+    config: ProfileConfig;
+}
+export declare class ProfileRegistry extends EventEmitter {
+    private readonly agentsDir;
+    private logger;
+    private profiles;
+    private watcher;
+    constructor(agentsDir: string, logger?: Logger);
+    /** Initial scan + start watcher. */
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Scan once, replacing the entire in-memory map. */
+    private scan;
+    private onFsEvent;
+    list(): ProfileEntry[];
+    get(name: string): ProfileEntry | undefined;
+}
+//# sourceMappingURL=profile-registry.d.ts.map

package/dist/profile/profile-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-registry.d.ts","sourceRoot":"","sources":["../../src/profile/profile-registry.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,qBAAa,eAAgB,SAAQ,YAAY;IAM7C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,OAAO,CAAwB;gBAGpB,SAAS,EAAE,MAAM,EAClC,MAAM,CAAC,EAAE,MAAM;IAMjB,oCAAoC;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,qDAAqD;IACrD,OAAO,CAAC,IAAI;IA4BZ,OAAO,CAAC,SAAS;IAwBjB,IAAI,IAAI,YAAY,EAAE;IAItB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAG5C"}

package/dist/profile/profile-registry.js

@@ -0,0 +1,114 @@
+/**
+ * M2 — ProfileRegistry.
+ *
+ * Scans ~/.nps/agents/ for valid profile directories (containing nps.yaml)
+ * and watches via chokidar for add/remove/edit. Exposes:
+ *   - list(): all current profile names
+ *   - get(name): the loaded ProfileConfig or undefined
+ *   - on('change' | 'added' | 'removed', cb): subscribe to changes
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { EventEmitter } from 'node:events';
+import chokidar from 'chokidar';
+import { getLogger } from '../logger.js';
+import { loadProfileConfig } from '../config/loader.js';
+export class ProfileRegistry extends EventEmitter {
+    agentsDir;
+    logger;
+    profiles = new Map();
+    watcher;
+    constructor(agentsDir, logger) {
+        super();
+        this.agentsDir = agentsDir;
+        this.logger = logger ?? getLogger('profile-registry');
+    }
+    /** Initial scan + start watcher. */
+    async start() {
+        this.scan();
+        if (!existsSync(this.agentsDir)) {
+            this.logger.warn({ agentsDir: this.agentsDir }, 'agents directory does not exist yet — watching parent for creation');
+        }
+        this.watcher = chokidar.watch(this.agentsDir, {
+            ignoreInitial: true,
+            // Watch the nps.yaml file inside each profile dir to detect edits
+            depth: 2,
+            persistent: true,
+        });
+        this.watcher.on('add', path => this.onFsEvent('add', path));
+        this.watcher.on('change', path => this.onFsEvent('change', path));
+        this.watcher.on('unlink', path => this.onFsEvent('unlink', path));
+        this.watcher.on('addDir', path => this.onFsEvent('addDir', path));
+        this.watcher.on('unlinkDir', path => this.onFsEvent('unlinkDir', path));
+        this.logger.info({ agentsDir: this.agentsDir, count: this.profiles.size }, 'profile registry started');
+    }
+    async stop() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = undefined;
+        }
+    }
+    /** Scan once, replacing the entire in-memory map. */
+    scan() {
+        const found = new Map();
+        if (!existsSync(this.agentsDir)) {
+            this.profiles = found;
+            return;
+        }
+        let entries = [];
+        try {
+            entries = readdirSync(this.agentsDir);
+        }
+        catch (e) {
+            this.logger.error({ err: e instanceof Error ? e.message : e }, 'failed to read agents dir');
+            return;
+        }
+        for (const name of entries) {
+            const dir = join(this.agentsDir, name);
+            try {
+                if (!statSync(dir).isDirectory())
+                    continue;
+                const yamlPath = join(dir, 'nps.yaml');
+                if (!existsSync(yamlPath))
+                    continue;
+                const config = loadProfileConfig(yamlPath);
+                found.set(name, { name, dir, config });
+            }
+            catch (e) {
+                this.logger.warn({ profile: name, err: e instanceof Error ? e.message : e }, 'skip invalid profile');
+            }
+        }
+        this.profiles = found;
+    }
+    onFsEvent(event, path) {
+        // Simple strategy: re-scan on any nps.yaml-relevant event. Cheap with <100 profiles.
+        if (!path.includes(this.agentsDir))
+            return;
+        const before = new Set(this.profiles.keys());
+        this.scan();
+        const after = new Set(this.profiles.keys());
+        for (const name of after) {
+            if (!before.has(name)) {
+                this.logger.info({ profile: name, event }, 'profile added');
+                this.emit('added', name, this.profiles.get(name));
+            }
+            else if (event === 'change') {
+                // re-emit change for edits
+                this.emit('change', name, this.profiles.get(name));
+            }
+        }
+        for (const name of before) {
+            if (!after.has(name)) {
+                this.logger.info({ profile: name, event }, 'profile removed');
+                this.emit('removed', name);
+            }
+        }
+    }
+    list() {
+        return Array.from(this.profiles.values());
+    }
+    get(name) {
+        return this.profiles.get(name);
+    }
+}
+//# sourceMappingURL=profile-registry.js.map

package/dist/profile/profile-registry.js.map

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

package/dist/runtime-check.d.ts

@@ -0,0 +1,18 @@
+import type { Logger } from 'pino';
+export interface RuntimeCheckResult {
+    ok: boolean;
+    claude: {
+        ok: boolean;
+        path?: string;
+        version?: string;
+    };
+    shim: {
+        ok: boolean;
+        path?: string;
+        version?: string;
+    };
+}
+export declare function checkRuntime(): RuntimeCheckResult;
+/** Run the boot check and throw an NpsError with actionable guidance if anything is missing. */
+export declare function assertRuntime(logger?: Logger): RuntimeCheckResult;
+//# sourceMappingURL=runtime-check.d.ts.map

package/dist/runtime-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-check.d.ts","sourceRoot":"","sources":["../src/runtime-check.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,IAAI,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAqBD,wBAAgB,YAAY,IAAI,kBAAkB,CAgBjD;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAkBjE"}

package/dist/runtime-check.js

@@ -0,0 +1,62 @@
+/**
+ * M10 — boot-time runtime check.
+ *
+ * Before nps daemon starts, verify:
+ *   - `claude` binary on PATH
+ *   - `claude-agent-acp` shim on PATH
+ *
+ * On miss, print actionable install instructions and exit 1.
+ */
+import { execFileSync } from 'node:child_process';
+import { NpsError } from './errors.js';
+function which(bin) {
+    try {
+        const out = execFileSync('which', [bin], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+        const path = out.trim();
+        return path.length > 0 ? path : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function tryVersion(path, flag = '--version') {
+    try {
+        const out = execFileSync(path, [flag], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 5000 });
+        return out.trim().split('\n')[0];
+    }
+    catch {
+        return undefined;
+    }
+}
+export function checkRuntime() {
+    const claudePath = which('claude');
+    const shimPath = which('claude-agent-acp');
+    return {
+        ok: !!claudePath && !!shimPath,
+        claude: {
+            ok: !!claudePath,
+            ...(claudePath ? { path: claudePath } : {}),
+            ...(claudePath ? { version: tryVersion(claudePath) ?? 'unknown' } : {}),
+        },
+        shim: {
+            ok: !!shimPath,
+            ...(shimPath ? { path: shimPath } : {}),
+            ...(shimPath ? { version: tryVersion(shimPath) ?? 'unknown' } : {}),
+        },
+    };
+}
+/** Run the boot check and throw an NpsError with actionable guidance if anything is missing. */
+export function assertRuntime(logger) {
+    const r = checkRuntime();
+    if (!r.claude.ok) {
+        logger?.error('claude binary missing on PATH');
+        throw new NpsError('CLAUDE_BIN_MISSING', `claude binary not found on PATH. Install Claude Code from https://claude.ai/download or run: npm i -g @anthropic-ai/claude-code`);
+    }
+    if (!r.shim.ok) {
+        logger?.error('claude-agent-acp shim missing on PATH');
+        throw new NpsError('ACP_SHIM_MISSING', `claude-agent-acp shim not found on PATH. Install with: npm i -g @agentclientprotocol/claude-agent-acp`);
+    }
+    logger?.info({ claude: r.claude, shim: r.shim }, 'runtime check passed');
+    return r;
+}
+//# sourceMappingURL=runtime-check.js.map

package/dist/runtime-check.js.map

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

package/dist/session/compat-hash.d.ts

@@ -0,0 +1,21 @@
+export interface CompatHashInputs {
+    /** Profile directory absolute path (contains nps.yaml + CLAUDE.md + .claude/skills/) */
+    profileDir: string;
+    /** Pre-fetched claude binary version (cached at daemon boot) */
+    claudeVersion: string;
+    /** Pre-fetched claude-agent-acp shim version */
+    shimVersion: string;
+    /** @coralai/claude-code-agent npm package version (cached at boot) */
+    agentPkgVersion: string;
+}
+/**
+ * Compute compatHash for a profile state. Throws COMPAT_HASH_FAILED on any
+ * unrecoverable read error (per plan rev 5 — fail-loud, never silently fresh-start).
+ */
+export declare function computeCompatHash(input: CompatHashInputs): string;
+/** Cache claude / claude-agent-acp version once at daemon boot to keep hash stable. */
+export declare function cacheRuntimeVersions(): {
+    claudeVersion: string;
+    shimVersion: string;
+};
+//# sourceMappingURL=compat-hash.d.ts.map

package/dist/session/compat-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat-hash.d.ts","sourceRoot":"","sources":["../../src/session/compat-hash.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA2CjE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,IAAI;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAKrF"}

package/dist/session/compat-hash.js

@@ -0,0 +1,115 @@
+/**
+ * compatHash — per CEO plan rev 5 spec.
+ *
+ * sha256 of canonical-ordered bytes:
+ *   1. profile.yaml (sorted-keys yaml dump, LF EOL)
+ *   2. CLAUDE.md (utf-8, LF EOL)
+ *   3. skills/<name>/SKILL.md, sorted by filename
+ *   4. @coralai/claude-code-agent npm version
+ *   5. claude --version
+ *   6. claude-agent-acp --version
+ *
+ * Each input is bracketed by `\n--SEP--\n` separator.
+ * Missing file → literal "<MISSING>" + path marker.
+ * Workspace contents NOT in hash (intentionally — task layer, not identity).
+ */
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, readdirSync, realpathSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { join } from 'node:path';
+import { stringify as yamlStringify, parse as yamlParse } from 'yaml';
+import { NpsError } from '../errors.js';
+const SEP = '\n--SEP--\n';
+/**
+ * Compute compatHash for a profile state. Throws COMPAT_HASH_FAILED on any
+ * unrecoverable read error (per plan rev 5 — fail-loud, never silently fresh-start).
+ */
+export function computeCompatHash(input) {
+    const buf = [];
+    // 1. profile.yaml — canonicalize via yaml parse → yaml dump (sorted keys via {sortMapEntries})
+    const profileYamlPath = join(input.profileDir, 'nps.yaml');
+    buf.push(canonicalYaml(profileYamlPath));
+    buf.push(SEP);
+    // 2. CLAUDE.md
+    buf.push(readCanonical(join(input.profileDir, 'CLAUDE.md')));
+    buf.push(SEP);
+    // 3. skills/<x>/SKILL.md — sorted filenames
+    const skillsDir = join(input.profileDir, '.claude', 'skills');
+    if (existsSync(skillsDir)) {
+        let names = [];
+        try {
+            names = readdirSync(skillsDir).sort();
+        }
+        catch (e) {
+            throw new NpsError('COMPAT_HASH_FAILED', `failed to list skills dir ${skillsDir}: ${e instanceof Error ? e.message : e}`);
+        }
+        for (const name of names) {
+            const skillFile = join(skillsDir, name, 'SKILL.md');
+            buf.push(`SKILL:${name}\n`);
+            buf.push(readCanonical(skillFile));
+            buf.push(SEP);
+        }
+    }
+    else {
+        buf.push('SKILLS:<MISSING>\n');
+        buf.push(SEP);
+    }
+    // 4. claude-code-agent npm version
+    buf.push(`CCA:${input.agentPkgVersion}`);
+    buf.push(SEP);
+    // 5. claude --version
+    buf.push(`CLAUDE:${input.claudeVersion}`);
+    buf.push(SEP);
+    // 6. claude-agent-acp --version
+    buf.push(`SHIM:${input.shimVersion}`);
+    return createHash('sha256').update(buf.join(''), 'utf8').digest('hex');
+}
+/** Cache claude / claude-agent-acp version once at daemon boot to keep hash stable. */
+export function cacheRuntimeVersions() {
+    return {
+        claudeVersion: cliVersion('claude'),
+        shimVersion: cliVersion('claude-agent-acp'),
+    };
+}
+function cliVersion(bin) {
+    try {
+        const out = execFileSync(bin, ['--version'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 5000,
+        });
+        return out.trim().split('\n')[0] ?? '<unknown>';
+    }
+    catch (e) {
+        throw new NpsError('COMPAT_HASH_FAILED', `failed to fetch ${bin} --version: ${e instanceof Error ? e.message : e}`);
+    }
+}
+/** Read file with LF normalization. On missing file, return "<MISSING>" marker. */
+function readCanonical(filePath) {
+    if (!existsSync(filePath)) {
+        return `<MISSING>:${filePath}`;
+    }
+    try {
+        // Resolve symlinks to target content per plan spec.
+        const real = realpathSync(filePath);
+        const content = readFileSync(real, 'utf8');
+        return content.replace(/\r\n?/g, '\n');
+    }
+    catch (e) {
+        throw new NpsError('COMPAT_HASH_FAILED', `failed to read ${filePath}: ${e instanceof Error ? e.message : e}`);
+    }
+}
+/** Re-emit yaml with sorted keys + LF. Used for profile.yaml canonicalization. */
+function canonicalYaml(filePath) {
+    if (!existsSync(filePath))
+        return `<MISSING>:${filePath}`;
+    try {
+        const raw = readFileSync(filePath, 'utf8');
+        const parsed = yamlParse(raw);
+        return yamlStringify(parsed, { sortMapEntries: true, lineWidth: 0 }).replace(/\r\n?/g, '\n');
+    }
+    catch (e) {
+        throw new NpsError('COMPAT_HASH_FAILED', `failed to canonicalize yaml ${filePath}: ${e instanceof Error ? e.message : e}`);
+    }
+}
+//# sourceMappingURL=compat-hash.js.map

package/dist/session/compat-hash.js.map

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