persnally 2.0.3 → 2.1.0

package/build/src/cli.js

@@ -8,7 +8,7 @@ import { existsSync, rmSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { applyApiKey, configPath, loadConfig, saveConfig } from "./config.js";
-import { CLIENTS, connectAll, connectClient } from "./connect.js";
+import { CLIENTS, connectAll, connectClient, installClaudeCodeHook } from "./connect.js";
 import { runConsolidation } from "./consolidate.js";
 import { chooseExtractor } from "./llm.js";
 import { CATEGORIES, clearScope, loadScopes, setScope } from "./permissions.js";
@@ -19,6 +19,7 @@ import { extractClaudeEvents, parseClaudeExport } from "./importers/claude.js";
 import { DEFAULT_TRANSCRIPTS_DIR, extractClaudeCodeEvents, parseClaudeCodeTranscripts, } from "./importers/claude-code.js";
 import { gitEvents, scanRepos } from "./importers/git.js";
 import { autostartInstalled, installAutostart, LOG_FILE, removeAutostart, removePidFile, runningPid, startDetached, stopDaemon, writePidFile, } from "./lifecycle.js";
+import { newEvent } from "./events.js";
 import { renderProfile, synthesizeProfile } from "./profile.js";
 import { DEFAULT_DB_PATH, EventStore } from "./store.js";
 const USAGE = `persnallyd ${VERSION} — so every AI finally knows you
@@ -36,6 +37,7 @@ Usage:
   persnallyd profile                Synthesize your profile from the store
   persnallyd consolidate            Reflect now: refresh decay, add behavior patterns, re-synthesize
   persnallyd show [topics|events|profile]   Show topics (default), recent events, or the profile
+  persnallyd context [--full]       Emit profile + interests for AI injection (records a context read)
   persnallyd forget <topic>         Hard-delete a topic and everything derived from it
   persnallyd forget --all           Delete all data
   persnallyd forget --batch <id>    Undo one import batch
@@ -150,9 +152,19 @@ async function main() {
             }
             store.close();
             // 6. AI clients
-            for (const { client, file } of connectAll()) {
+            const connections = connectAll();
+            for (const { client, file } of connections) {
                 console.log(file ? `✓ Connected ${client}` : `· ${client} not installed — skipped`);
             }
+            if (connections.some((r) => r.client === "claude-code" && r.file)) {
+                try {
+                    installClaudeCodeHook();
+                    console.log("✓ Context hook installed (injects on every Claude Code session)");
+                }
+                catch (e) {
+                    console.error(`· Context hook skipped: ${e instanceof Error ? e.message : e}`);
+                }
+            }
             console.log(`\nDone${imported ? ` — ${imported} events imported` : ""}. Dashboard: http://127.0.0.1:${port}`);
             if (process.platform === "darwin" && process.stdout.isTTY) {
                 try {
@@ -197,6 +209,15 @@ async function main() {
             for (const { client, file } of results) {
                 console.log(file ? `Connected ${client} (${file})` : `${client} not installed — skipped`);
             }
+            // Claude Code also gets a SessionStart hook so every session injects context automatically.
+            if (results.some((r) => r.client === "claude-code" && r.file)) {
+                try {
+                    console.log(`Installed Claude Code context hook (${installClaudeCodeHook()})`);
+                }
+                catch (e) {
+                    console.error(`Context hook not installed: ${e instanceof Error ? e.message : e}`);
+                }
+            }
             return;
         }
         case "config": {
@@ -304,6 +325,50 @@ async function main() {
             store.close();
             return;
         }
+        case "context": {
+            // Serving path for the SessionStart hook: emit profile + interests for
+            // injection AND record the read, so hook injections count toward the
+            // context-reads metric exactly like the MCP persnally_context tool. `show`
+            // stays side-effect-free so manual inspection never inflates the metric.
+            const full = args.includes("--full");
+            const hook = args.includes("--hook");
+            const store = new EventStore();
+            const profile = store.getProfile();
+            const topics = store.topics(full ? 25 : 12);
+            if (!profile && !topics.length) {
+                store.close();
+                return;
+            }
+            const out = [];
+            let items = topics.length;
+            if (profile) {
+                out.push("# About the user", profile.headline, "");
+                const sections = full ? profile.sections : profile.sections.slice(0, 3);
+                items += sections.length;
+                for (const s of sections)
+                    out.push(`## ${s.title}`, s.body, "");
+            }
+            if (topics.length) {
+                out.push("# Current interests (decay-weighted)");
+                for (const t of topics) {
+                    out.push(`- ${t.topic} (${t.category}, ${t.dominant_intent}, weight ${t.weight.toFixed(2)})`);
+                }
+            }
+            // Recording must never break the injection itself (mirrors MCP recordRead).
+            try {
+                store.append([newEvent("context.read", "cli", { scope: full ? "full" : "brief", client_purpose: hook ? "session-start hook" : "cli context read", items }, { kind: "local", surface: "cli" })]);
+            }
+            catch (e) {
+                console.error("persnally: context.read not recorded:", e instanceof Error ? e.message : e);
+            }
+            store.close();
+            const rendered = out.join("\n");
+            // --hook emits the SessionStart envelope itself, so the installed hook needs no jq.
+            console.log(hook
+                ? JSON.stringify({ hookSpecificOutput: { hookEventName: "SessionStart", additionalContext: rendered } })
+                : rendered);
+            return;
+        }
         case "forget": {
             const store = new EventStore();
             if (args[0] === "--all") {

package/build/src/connect.d.ts

@@ -7,6 +7,13 @@ export type Client = (typeof CLIENTS)[number];
 export declare function mcpServerPath(): string;
 /** Returns the config file written, or null when the client isn't installed. */
 export declare function connectClient(client: Client): string | null;
+/**
+ * Installs (or upgrades) the Persnally SessionStart hook in Claude Code's user
+ * settings so every session injects the user's context. Merges into existing
+ * settings, leaves other tools' hooks untouched, and is idempotent: a prior
+ * Persnally entry (including the old `show topics` form) is replaced, not duplicated.
+ */
+export declare function installClaudeCodeHook(): string;
 export declare function connectAll(): {
     client: Client;
     file: string | null;

package/build/src/connect.js

@@ -2,10 +2,17 @@
  * Writes the Persnally MCP server into AI clients' configs.
  * Only touches clients that are actually installed; merges, never clobbers.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 export const CLIENTS = ["claude-code", "claude-desktop", "cursor"];
+/** Write JSON via temp file + rename: a crash mid-write can't corrupt the user's config. */
+function writeJsonAtomic(file, cfg) {
+    mkdirSync(dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify(cfg, null, 2) + "\n");
+    renameSync(tmp, file);
+}
 function configPathFor(client) {
     const home = homedir();
     switch (client) {
@@ -50,8 +57,36 @@ export function connectClient(client) {
     }
     const servers = (cfg.mcpServers ??= {});
     servers.persnally = { command: "node", args: [mcpServerPath()] };
-    mkdirSync(dirname(file), { recursive: true });
-    writeFileSync(file, JSON.stringify(cfg, null, 2) + "\n");
+    writeJsonAtomic(file, cfg);
+    return file;
+}
+// The hook self-renders the SessionStart envelope (`context --hook`), so no jq dependency.
+const SESSION_START_COMMAND = "persnallyd context --hook 2>/dev/null";
+/**
+ * Installs (or upgrades) the Persnally SessionStart hook in Claude Code's user
+ * settings so every session injects the user's context. Merges into existing
+ * settings, leaves other tools' hooks untouched, and is idempotent: a prior
+ * Persnally entry (including the old `show topics` form) is replaced, not duplicated.
+ */
+export function installClaudeCodeHook() {
+    const file = join(homedir(), ".claude", "settings.json");
+    let cfg = {};
+    if (existsSync(file)) {
+        try {
+            cfg = JSON.parse(readFileSync(file, "utf-8"));
+        }
+        catch {
+            throw new Error(`${file} is not valid JSON — fix it, then run \`persnallyd connect claude-code\` again`);
+        }
+    }
+    const hooks = (cfg.hooks ??= {});
+    const existing = Array.isArray(hooks.SessionStart) ? hooks.SessionStart : [];
+    const others = existing.filter((g) => !g.hooks?.some((h) => /persnall/i.test(h.command ?? "")));
+    others.push({
+        hooks: [{ type: "command", command: SESSION_START_COMMAND, timeout: 10, statusMessage: "Loading your Persnally context…" }],
+    });
+    hooks.SessionStart = others;
+    writeJsonAtomic(file, cfg);
     return file;
 }
 export function connectAll() {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "persnally",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "license": "FSL-1.1-MIT",
-  "description": "The context engine for you — local-first, across every AI. So every AI finally knows you.",
+  "description": "Your own context engine — local-first, across every AI. So every AI finally knows you.",
   "type": "module",
   "bin": {
     "persnally": "build/src/cli.js",