nlm-memory 0.4.0

package/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "nlm-memory-ts",
+  "interface": {
+    "displayName": "nlm-memory"
+  },
+  "plugins": [
+    {
+      "name": "nlm-memory",
+      "source": {
+        "source": "local",
+        "path": "./plugin"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_USE"
+      },
+      "category": "Coding"
+    }
+  ]
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Test
+        run: npm test
+
+      - name: Build (server)
+        run: npm run build

package/LICENSE

@@ -0,0 +1,151 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship made available under
+   the License, as indicated by a copyright notice that is included in
+   or attached to the work (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other transformations
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean, as submitted to the Licensor for inclusion
+   in the Work by the copyright owner or by an individual or Legal Entity
+   authorized to submit on behalf of the copyright owner. For the purposes
+   of this definition, "submitted" means any form of electronic, verbal,
+   or written communication sent to the Licensor or its representatives,
+   including but not limited to communication on electronic mailing lists,
+   source code control systems, and issue tracking systems that are managed
+   by, or on behalf of, the Licensor for the purpose of developing the Work,
+   but excluding communication that is conspicuously marked or designated
+   in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any Legal Entity on behalf of
+   whom a Contribution has been received by the Licensor and included
+   within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by the combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a cross-claim
+   or counterclaim in a lawsuit) alleging that the Work or any
+   Contribution embodied within the Work constitutes direct or
+   contributory patent infringement, then any patent licenses granted
+   to You under this License for that Work shall terminate as of the
+   date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or Derivative Works
+       a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, You must include a readable copy of the attribution
+       notices contained within such NOTICE file, in at least one of the
+       following places: within a NOTICE text provided as part of the
+       Derivative Works; within the Source form or documentation, if
+       provided along with the Derivative Works; or, within a display
+       generated by the Derivative Works, if and wherever such third-party
+       notices normally appear. The contents of the NOTICE file are for
+       informational purposes only and do not modify the License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed
+   to in writing, Licensor provides the Work (and each Contributor
+   provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
+   OR CONDITIONS OF ANY KIND, either express or implied, including,
+   without limitation, any warranties or conditions of TITLE,
+   NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+   PURPOSE. You are solely responsible for determining the appropriateness
+   of using or reproducing the Work and assume any risks associated with
+   Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or exemplary damages of any character arising as a result
+   of this License or out of the use or inability to use the Work.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may offer, and charge a fee
+   for, acceptance of support, warranty, indemnity, or other liability
+   obligations and/or rights consistent with this License. However, in
+   accepting such obligations, You may offer such obligations only on
+   Your own behalf and on a sole responsibility basis, not on behalf of
+   any other Contributor, and only if You agree to indemnify, defend,
+   and hold each Contributor harmless for any liability incurred by such
+   Contributor as a result of your accepting any warranty or additional
+   liability.
+
+Copyright 2026 Edward Chalupa

package/README.md

@@ -0,0 +1,119 @@
+# nlm-memory
+
+> Local-first memory OS for AI operators — one corpus across every runtime you use.
+
+`nlm-memory` indexes every session from Claude Code, Codex, OpenCode, Hermes, Aider, and pi into a single searchable store on your machine. Three properties no competitor ships together:
+
+1. **Cross-runtime reach.** Claude Code, Codex, and OpenCode ship today. Hermes, pi, and Aider follow the same adapter pattern. One index, every tool — not one per runtime.
+2. **Editable timeline.** Sessions can be superseded, retired, or marked aborted. Memory is non-linear: patch history retroactively. No other memory layer lets you do this.
+3. **97.2% R@5 baseline.** On a 14-month corpus, keyword recall surfaces the right session in the top 5 on 97.2% of evaluator queries. No fine-tuning, no cloud, no account.
+
+Everything stays on your machine. No telemetry, no account required beyond your classifier of choice.
+
+---
+
+## Requirements
+
+- **Node 20+**
+- **[Ollama](https://ollama.com)** running locally with `nomic-embed-text` pulled:
+  ```sh
+  ollama pull nomic-embed-text
+  ```
+- **A classifier** — [DeepSeek](https://platform.deepseek.com) is recommended (fast, cheap, ~$0.002/session). Set `DEEPSEEK_API_KEY` in `~/.nlm/.env`. Ollama works offline with `NLM_CLASSIFIER=ollama`.
+
+---
+
+## Install
+
+```sh
+npm install -g github:pbmagnet4/nlm-memory-ts
+nlm migrate
+nlm install
+```
+
+`nlm install` writes a macOS LaunchAgent that starts the daemon on login and keeps it running. Open **http://localhost:3940/ui** — done.
+
+To stop or remove:
+```sh
+launchctl stop com.github.pbmagnet4.nlm-memory   # stop without uninstalling
+nlm uninstall                                    # remove the LaunchAgent entirely
+```
+
+---
+
+## Wire to your AI agents (MCP)
+
+Add to `~/.mcp.json` (or your editor's MCP config):
+
+```json
+{
+  "mcpServers": {
+    "nlm-memory": {
+      "command": "node",
+      "args": ["<path-to-global-npm>/lib/node_modules/nlm-memory/dist/cli/nlm.js", "mcp"]
+    }
+  }
+}
+```
+
+Find the path with `npm root -g` — the full path is `$(npm root -g)/nlm-memory/dist/cli/nlm.js`.
+
+Or use the runtime-specific connect commands:
+
+```sh
+nlm connect claude-code      # writes to ~/.mcp.json + installs hooks
+nlm connect codex            # installs as a Codex marketplace plugin
+nlm connect hermes           # writes to ~/.hermes/config.yaml (MCP)
+nlm connect hermes-agent     # installs as a NousResearch Hermes plugin (hooks + MCP)
+```
+
+Once wired, agents can call `recall_sessions` (search past conversations) and `recall_facts` (pull structured facts like decisions and project state) automatically.
+
+---
+
+## What's inside
+
+| Page | What it shows |
+|---|---|
+| **Live** | Sessions being written in real time, recent reads and decisions |
+| **Pulse** | System health — coherence, runtimes, stale entities, recent sessions |
+| **River** | Full session timeline with density controls |
+| **Thread** | Per-entity conversation history |
+| **Search** | Keyword, semantic, or hybrid recall |
+| **Recall** | Adoption telemetry — is the memory system actually being used? |
+| **Settings** | Sources, providers, classifier, data backup/restore |
+
+---
+
+## How it differs from mem0 and graphiti
+
+- **Unit of memory:** whole sessions with extracted markers (decisions, open questions, entities), not individual facts or graph edges.
+- **Audience:** you querying your own past work, not an embedded SDK for app developers.
+- **Cross-runtime:** one corpus across Claude Code, Codex, OpenCode, Hermes, and more. Competitors target one runtime.
+- **Editable timeline:** sessions can be superseded, retired, aborted. No other tool lets you retrofit memory — a record from 6 months ago can be corrected today.
+- **Local-only:** no hosted offering, no telemetry, no vendor dependency.
+
+---
+
+## Development
+
+```sh
+git clone https://github.com/pbmagnet4/nlm-memory-ts
+cd nlm-memory-ts
+npm install        # install dependencies
+npm run build      # compile dist/ — commit the result, it ships in the repo
+npm run dev        # hot-reload daemon
+npm run ui:dev     # hot-reload UI at localhost:5173 (proxies /api to :3940)
+npm test           # unit + integration tests
+npm run typecheck
+```
+
+`dist/` is committed to the repo so `npm install -g github:…` works without a build step on the user's machine. Rebuild and commit `dist/` whenever you change `src/`.
+
+Database lives at `~/.nlm/canonical.sqlite`. Override with `NLM_DB_PATH`.
+
+---
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

package/dist/cli/classify-parity.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `nlm classify-parity` — Phase C parity verification harness.
+ *
+ * Reads N sessions from ~/.nlm/canonical.sqlite (read-only by default),
+ * runs the TS OllamaClient.classify on each body, diffs the result
+ * against the persisted Python classifier output, and prints aggregate
+ * metrics: Jaccard similarity on entities/decisions/open sets, label
+ * exact match rate, summary length delta, schema-failure count.
+ *
+ * Safe: opens the live store in readonly mode. Does not write anything
+ * back. Designed to be run interactively from a terminal during the
+ * Phase C cutover-prep window.
+ */
+export type Provider = "ollama" | "deepseek";
+interface CliOptions {
+    readonly limit: number;
+    readonly dbPath: string;
+    readonly ollamaUrl: string;
+    readonly classifyModel: string;
+    readonly provider: Provider;
+    readonly verbose: boolean;
+}
+interface DiffMetrics {
+    sessionId: string;
+    labelMatch: boolean;
+    labelTs: string;
+    labelPy: string;
+    entityJaccard: number;
+    decisionJaccard: number;
+    openJaccard: number;
+    summaryDeltaChars: number;
+    schemaFailure: boolean;
+    errorMessage?: string;
+}
+export interface ParityReport {
+    attempted: number;
+    succeeded: number;
+    schemaFailures: number;
+    networkFailures: number;
+    labelExactMatchRate: number;
+    meanEntityJaccard: number;
+    meanDecisionJaccard: number;
+    meanOpenJaccard: number;
+    diffs: ReadonlyArray<DiffMetrics>;
+}
+export declare function runParity(opts: CliOptions): Promise<ParityReport>;
+export declare function main(): Promise<void>;
+export {};

package/dist/cli/classify-parity.js

@@ -0,0 +1,182 @@
+/**
+ * `nlm classify-parity` — Phase C parity verification harness.
+ *
+ * Reads N sessions from ~/.nlm/canonical.sqlite (read-only by default),
+ * runs the TS OllamaClient.classify on each body, diffs the result
+ * against the persisted Python classifier output, and prints aggregate
+ * metrics: Jaccard similarity on entities/decisions/open sets, label
+ * exact match rate, summary length delta, schema-failure count.
+ *
+ * Safe: opens the live store in readonly mode. Does not write anything
+ * back. Designed to be run interactively from a terminal during the
+ * Phase C cutover-prep window.
+ */
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import Database from "better-sqlite3";
+import * as sqliteVec from "sqlite-vec";
+import { LLMUnreachableError } from "../ports/llm-client.js";
+import { DeepSeekClient } from "../llm/deepseek-client.js";
+import { OllamaClient, ClassifierSchemaError } from "../llm/ollama-client.js";
+import { autoloadEnv } from "../llm/env-autoload.js";
+function parseArgs(argv) {
+    const flag = (name, fallback) => {
+        const i = argv.indexOf(name);
+        if (i === -1)
+            return fallback;
+        return argv[i + 1] ?? fallback;
+    };
+    const limit = Number.parseInt(flag("--limit", "10") ?? "10", 10);
+    const providerRaw = (flag("--provider", "deepseek") ?? "deepseek").toLowerCase();
+    const provider = providerRaw === "ollama" ? "ollama" : "deepseek";
+    const defaultModel = provider === "deepseek" ? "deepseek-v4-flash" : "phi4-mini:latest";
+    return {
+        limit: Number.isFinite(limit) && limit > 0 ? limit : 10,
+        dbPath: flag("--db", process.env["NLM_DB_PATH"] ?? resolve(homedir(), ".nlm/canonical.sqlite")) ??
+            resolve(homedir(), ".nlm/canonical.sqlite"),
+        ollamaUrl: flag("--ollama", process.env["NLM_OLLAMA_URL"] ?? "http://localhost:11434") ?? "http://localhost:11434",
+        classifyModel: flag("--model", defaultModel) ?? defaultModel,
+        provider,
+        verbose: argv.includes("--verbose"),
+    };
+}
+function buildClient(opts) {
+    if (opts.provider === "deepseek") {
+        autoloadEnv();
+        return new DeepSeekClient({ classifyModel: opts.classifyModel });
+    }
+    return new OllamaClient({ baseUrl: opts.ollamaUrl, classifyModel: opts.classifyModel });
+}
+function jaccard(a, b) {
+    const setA = new Set(a.map((s) => s.toLowerCase().trim()));
+    const setB = new Set(b.map((s) => s.toLowerCase().trim()));
+    if (setA.size === 0 && setB.size === 0)
+        return 1;
+    const inter = new Set([...setA].filter((x) => setB.has(x)));
+    const union = new Set([...setA, ...setB]);
+    return inter.size / union.size;
+}
+export async function runParity(opts) {
+    const db = new Database(opts.dbPath, { readonly: true });
+    sqliteVec.load(db);
+    const rows = db
+        .prepare(`SELECT id, label, summary, body
+       FROM sessions
+       WHERE body IS NOT NULL AND body != ''
+       ORDER BY started_at DESC
+       LIMIT ?`)
+        .all(opts.limit);
+    const persistedById = new Map();
+    for (const r of rows) {
+        const entities = db
+            .prepare("SELECT entity_canonical FROM session_entities WHERE session_id = ?")
+            .all(r.id)
+            .map((x) => x.entity_canonical);
+        const markers = db
+            .prepare("SELECT kind, text FROM markers WHERE session_id = ? ORDER BY position")
+            .all(r.id);
+        persistedById.set(r.id, {
+            label: r.label,
+            summary: r.summary,
+            entities,
+            decisions: markers.filter((m) => m.kind === "decision").map((m) => m.text),
+            open: markers.filter((m) => m.kind === "open").map((m) => m.text),
+        });
+    }
+    db.close();
+    const client = buildClient(opts);
+    const diffs = [];
+    let schemaFailures = 0;
+    let networkFailures = 0;
+    let idx = 0;
+    for (const r of rows) {
+        idx += 1;
+        const py = persistedById.get(r.id);
+        if (!py || !r.body)
+            continue;
+        const t0 = Date.now();
+        try {
+            const ts = await client.classify(r.body);
+            const elapsed = ((Date.now() - t0) / 1000).toFixed(1);
+            const labelMatch = ts.label.toLowerCase().trim() === py.label.toLowerCase().trim();
+            const entJ = jaccard(ts.entities, py.entities);
+            const decJ = jaccard(ts.decisions, py.decisions);
+            const openJ = jaccard(ts.open, py.open);
+            diffs.push({
+                sessionId: r.id,
+                labelMatch,
+                labelTs: ts.label,
+                labelPy: py.label,
+                entityJaccard: entJ,
+                decisionJaccard: decJ,
+                openJaccard: openJ,
+                summaryDeltaChars: ts.summary.length - py.summary.length,
+                schemaFailure: false,
+            });
+            if (opts.verbose) {
+                const tag = labelMatch ? "EQ " : "DIFF";
+                process.stderr.write(`  [${idx}/${rows.length}] ${elapsed}s ${tag} ${r.id}  ent=${entJ.toFixed(2)} dec=${decJ.toFixed(2)} open=${openJ.toFixed(2)}\n`);
+            }
+        }
+        catch (e) {
+            const elapsed = ((Date.now() - t0) / 1000).toFixed(1);
+            const message = e instanceof Error ? e.message : String(e);
+            if (e instanceof ClassifierSchemaError)
+                schemaFailures += 1;
+            else if (e instanceof LLMUnreachableError)
+                networkFailures += 1;
+            diffs.push({
+                sessionId: r.id,
+                labelMatch: false,
+                labelTs: "",
+                labelPy: py.label,
+                entityJaccard: 0,
+                decisionJaccard: 0,
+                openJaccard: 0,
+                summaryDeltaChars: 0,
+                schemaFailure: e instanceof ClassifierSchemaError,
+                errorMessage: message,
+            });
+            if (opts.verbose) {
+                process.stderr.write(`  [${idx}/${rows.length}] ${elapsed}s ERR  ${r.id}  :: ${message}\n`);
+            }
+        }
+    }
+    const successes = diffs.filter((d) => !d.errorMessage);
+    const mean = (xs) => xs.length === 0 ? 0 : Math.round((xs.reduce((a, b) => a + b, 0) / xs.length) * 1000) / 1000;
+    return {
+        attempted: diffs.length,
+        succeeded: successes.length,
+        schemaFailures,
+        networkFailures,
+        labelExactMatchRate: mean(successes.map((d) => (d.labelMatch ? 1 : 0))),
+        meanEntityJaccard: mean(successes.map((d) => d.entityJaccard)),
+        meanDecisionJaccard: mean(successes.map((d) => d.decisionJaccard)),
+        meanOpenJaccard: mean(successes.map((d) => d.openJaccard)),
+        diffs,
+    };
+}
+export async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    console.error(`nlm classify-parity: ${opts.limit} sessions from ${opts.dbPath}`);
+    console.error(`  provider: ${opts.provider}  model: ${opts.classifyModel}` +
+        (opts.provider === "ollama" ? `  ollama: ${opts.ollamaUrl}` : ""));
+    const report = await runParity(opts);
+    console.error("");
+    console.error(`attempted:           ${report.attempted}`);
+    console.error(`succeeded:           ${report.succeeded}`);
+    console.error(`schema failures:     ${report.schemaFailures}`);
+    console.error(`network failures:    ${report.networkFailures}`);
+    console.error(`label exact match:   ${(report.labelExactMatchRate * 100).toFixed(1)}%`);
+    console.error(`mean Jaccard ents:   ${report.meanEntityJaccard.toFixed(3)}`);
+    console.error(`mean Jaccard decs:   ${report.meanDecisionJaccard.toFixed(3)}`);
+    console.error(`mean Jaccard open:   ${report.meanOpenJaccard.toFixed(3)}`);
+}
+const isMain = import.meta.url === `file://${process.argv[1]}`;
+if (isMain) {
+    main().catch((e) => {
+        console.error("classify-parity fatal:", e);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=classify-parity.js.map

package/dist/cli/classify-parity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify-parity.js","sourceRoot":"","sources":["../../src/cli/classify-parity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAqDrD,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,QAAiB,EAAsB,EAAE;QACnE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC;IACjC,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IACjF,MAAM,QAAQ,GAAa,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;IAC5E,MAAM,YAAY,GAAG,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACxF,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACvD,MAAM,EACJ,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,uBAAuB,CAAC,CAAC;YACvF,OAAO,CAAC,OAAO,EAAE,EAAE,uBAAuB,CAAC;QAC7C,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,wBAAwB,CAAC,IAAI,wBAAwB;QAClH,aAAa,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,YAAY;QAC5D,QAAQ;QACR,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAsE;IACzF,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACjC,WAAW,EAAE,CAAC;QACd,OAAO,IAAI,cAAc,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,OAAO,CAAC,CAAwB,EAAE,CAAwB;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAgB;IAC9C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEnB,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;;eAIS,CACV;SACA,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnB,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmC,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,EAAE;aAChB,OAAO,CACN,oEAAoE,CACrE;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;aACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,EAAE;aACf,OAAO,CACN,uEAAuE,CACxE;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACb,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ;YACR,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IACD,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,GAAG,IAAI,CAAC,CAAC;QACT,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,SAAS;QAE7B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YACnF,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,CAAC,CAAC,EAAE;gBACf,UAAU;gBACV,OAAO,EAAE,EAAE,CAAC,KAAK;gBACjB,OAAO,EAAE,EAAE,CAAC,KAAK;gBACjB,aAAa,EAAE,IAAI;gBACnB,eAAe,EAAE,IAAI;gBACrB,WAAW,EAAE,KAAK;gBAClB,iBAAiB,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM;gBACxD,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;gBACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,KAAK,GAAG,IAAI,CAAC,CAAC,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACjI,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,YAAY,qBAAqB;gBAAE,cAAc,IAAI,CAAC,CAAC;iBACvD,IAAI,CAAC,YAAY,mBAAmB;gBAAE,eAAe,IAAI,CAAC,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,CAAC,CAAC,EAAE;gBACf,UAAU,EAAE,KAAK;gBACjB,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,EAAE,CAAC,KAAK;gBACjB,aAAa,EAAE,CAAC;gBAChB,eAAe,EAAE,CAAC;gBAClB,WAAW,EAAE,CAAC;gBACd,iBAAiB,EAAE,CAAC;gBACpB,aAAa,EAAE,CAAC,YAAY,qBAAqB;gBACjD,YAAY,EAAE,OAAO;aACtB,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,UAAU,CAAC,CAAC,EAAE,QAAQ,OAAO,IAAI,CACtE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,EAAyB,EAAU,EAAE,CACjD,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE9F,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,cAAc;QACd,eAAe;QACf,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QAC9D,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QAClE,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC1D,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,kBAAkB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,KAAK,CACX,eAAe,IAAI,CAAC,QAAQ,YAAY,IAAI,CAAC,aAAa,EAAE;QAC1D,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACpE,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IAErC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/D,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxF,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7E,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,IAAI,MAAM,EAAE,CAAC;IACX,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/launchctl-helpers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pure helpers for parsing launchctl interactions.
+ *
+ * Extracted so the string-matching against launchctl's textual output can
+ * be unit-tested. The real launchctl process invocations live in nlm.ts
+ * where they're called.
+ */
+/**
+ * True when launchctl's bootout stderr indicates the agent simply wasn't
+ * loaded — a benign condition during uninstall (we wanted it gone, it's
+ * already gone). Any other error means something we should surface.
+ *
+ * The exact strings come from observed macOS launchctl output across
+ * versions; match case-insensitively because phrasing varies.
+ */
+export declare function isBenignBootoutError(stderr: string): boolean;
+/**
+ * True when the named LaunchAgent label appears in `launchctl list`. This
+ * is the source of truth for "is the agent actually loaded right now" —
+ * more reliable than trusting bootout's exit code, which has been seen to
+ * return zero while leaving the daemon running and to return non-zero
+ * while successfully unloading.
+ *
+ * Injected `runner` keeps this testable without spawning a real process.
+ */
+export declare function isAgentLoaded(label: string, runner?: () => string): boolean;

package/dist/cli/launchctl-helpers.js

@@ -0,0 +1,42 @@
+/**
+ * Pure helpers for parsing launchctl interactions.
+ *
+ * Extracted so the string-matching against launchctl's textual output can
+ * be unit-tested. The real launchctl process invocations live in nlm.ts
+ * where they're called.
+ */
+import { execFileSync } from "node:child_process";
+/**
+ * True when launchctl's bootout stderr indicates the agent simply wasn't
+ * loaded — a benign condition during uninstall (we wanted it gone, it's
+ * already gone). Any other error means something we should surface.
+ *
+ * The exact strings come from observed macOS launchctl output across
+ * versions; match case-insensitively because phrasing varies.
+ */
+export function isBenignBootoutError(stderr) {
+    const s = stderr.toLowerCase();
+    return (s.includes("could not find service") ||
+        s.includes("no such process") ||
+        s.includes("not currently loaded"));
+}
+/**
+ * True when the named LaunchAgent label appears in `launchctl list`. This
+ * is the source of truth for "is the agent actually loaded right now" —
+ * more reliable than trusting bootout's exit code, which has been seen to
+ * return zero while leaving the daemon running and to return non-zero
+ * while successfully unloading.
+ *
+ * Injected `runner` keeps this testable without spawning a real process.
+ */
+export function isAgentLoaded(label, runner = () => execFileSync("launchctl", ["list"], { stdio: "pipe", encoding: "utf8" })) {
+    let out;
+    try {
+        out = runner();
+    }
+    catch {
+        return false;
+    }
+    return out.split("\n").some((line) => line.includes(label));
+}
+//# sourceMappingURL=launchctl-helpers.js.map

package/dist/cli/launchctl-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchctl-helpers.js","sourceRoot":"","sources":["../../src/cli/launchctl-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAC/B,OAAO,CACL,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;QACpC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CACnC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,SAAuB,GAAG,EAAE,CAC1B,YAAY,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAE1E,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9D,CAAC"}

package/dist/cli/nlm.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * nlm — CLI entry point. Composition root for the whole stack.
+ *
+ * This is the one file that knows about every concrete implementation:
+ * SqliteSessionStore (storage), OllamaClient (LLM), Hono (HTTP),
+ * McpServer (MCP). Every other module depends on ports. Swapping a
+ * backend means editing this file, not anything inside core/.
+ *
+ * Subcommands:
+ *   nlm start    — boot HTTP server on $NLM_PORT (default 3940)
+ *   nlm migrate  — run pending migrations against the canonical SQLite
+ *   nlm recall   — one-shot recall query from the shell (debugging)
+ *   nlm mcp      — run as an MCP stdio server (for ~/.mcp.json wiring)
+ *   nlm setup    — interactive first-run wizard (recommended entry point)
+ *   nlm install  — install the macOS LaunchAgent (auto-start on login)
+ *   nlm uninstall — remove the macOS LaunchAgent
+ *   nlm hook install   — add the recall hook to Claude Code (shadow mode)
+ *   nlm hook uninstall — remove the recall hook from Claude Code
+ *   nlm connect claude-code  — write MCP server block to ~/.mcp.json
+ *   nlm connect codex        — install Codex marketplace plugin
+ *   nlm disconnect claude-code — remove MCP block from ~/.mcp.json
+ *   nlm disconnect codex       — remove Codex plugin
+ */
+export {};