greprag 0.6.1 → 0.7.0

package/dist/project-anchor.js

@@ -44,6 +44,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeGitDerivedProjectId = computeGitDerivedProjectId;
 exports.readAnchor = readAnchor;
 exports.ensureGlobalAnchor = ensureGlobalAnchor;
 exports.ensureAnchor = ensureAnchor;
@@ -51,6 +52,7 @@ const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const crypto = __importStar(require("crypto"));
 const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
 const ANCHOR_DIR = '.claude';
 const ANCHOR_FILE = 'project.json';
 /** Walk up from cwd looking for an existing .claude/project.json.
@@ -91,6 +93,41 @@ function isEphemeralCwd(cwd) {
         return true; // macOS
     return false;
 }
+/** Derive a stable project_id from the git repository's root commit SHA.
+ *  Returns null when the cwd isn't inside a git repo or the repo has no
+ *  commits yet (newly `git init`-ed, no first commit).
+ *
+ *  The root commit is *permanently stable* per project — it doesn't change
+ *  across clones, worktrees, machines, or directory renames, and it survives
+ *  anchor-file deletion. Disjoint histories (unrelated-histories merge) are
+ *  handled by sorting all root SHAs alphabetically and concatenating before
+ *  hashing — same algorithm everywhere produces the same UUID. */
+function computeGitDerivedProjectId(workingDir) {
+    try {
+        // Multiple root commits possible (history merged from disjoint roots).
+        // We sort alphabetically for determinism across machines.
+        const out = (0, child_process_1.execSync)('git rev-list --max-parents=0 HEAD', {
+            cwd: workingDir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const roots = out.trim().split(/\s+/).filter(Boolean).sort();
+        if (roots.length === 0)
+            return null;
+        const hash = crypto.createHash('sha256').update(roots.join('\n')).digest('hex');
+        // UUID v4-shape, deterministic (matches the deterministicProjectId format).
+        return [
+            hash.slice(0, 8),
+            hash.slice(8, 12),
+            '4' + hash.slice(13, 16), // version 4 nibble
+            '8' + hash.slice(17, 20), // variant nibble
+            hash.slice(20, 32),
+        ].join('-');
+    }
+    catch {
+        return null;
+    }
+}
 /** Hash a working directory into a stable UUID. Used when no anchor file
  *  exists yet — keeps turns flowing without forcing init first. */
 function deterministicProjectId(workingDir) {
@@ -105,78 +142,113 @@ function deterministicProjectId(workingDir) {
         hash.slice(20, 32),
     ].join('-');
 }
-/** Try to read a JSON anchor file at a specific path. Returns null if absent or invalid.
- *  Flags default to true if absent. The agent can flip them per-project. */
-function tryReadAnchorFile(filePath) {
+/** Read a `.claude/project.json` and return its parsed contents. Returns null
+ *  if the file is missing, unreadable, or invalid JSON. Identity fields stay
+ *  optional; settings always come back with their defaults applied. */
+function tryReadAnchorFileContents(filePath) {
     try {
         const raw = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-        if (raw.project_id && raw.project_name) {
-            const notifyRaw = raw.inbox_notify;
-            const inboxNotify = notifyRaw === 'off' || notifyRaw === 'session_start_only'
-                ? notifyRaw
-                : 'every_turn';
-            return {
-                projectId: raw.project_id,
-                projectName: raw.project_name,
-                initialized: true,
-                anchorPath: filePath,
-                created: raw.created,
-                memoryCapture: raw.memory_capture !== false, // default true
-                sessionStartRecap: raw.session_start_recap !== false, // default true
-                inboxNotify,
-            };
-        }
+        const notifyRaw = raw.inbox_notify;
+        const inboxNotify = notifyRaw === 'off' || notifyRaw === 'session_start_only'
+            ? notifyRaw
+            : 'every_turn';
+        return {
+            projectId: raw.project_id,
+            projectName: raw.project_name,
+            created: raw.created,
+            memoryCapture: raw.memory_capture !== false,
+            sessionStartRecap: raw.session_start_recap !== false,
+            inboxNotify,
+        };
     }
     catch {
-        // Fall through.
+        return null;
     }
-    return null;
 }
 /** Read the project anchor for a given cwd. Read-only.
  *
- *  Priority:
- *  (1) walk-up finds a repo-level .claude/project.json → use it.
- *  (2) cwd is an ephemeral session path (Cowork) AND ~/.claude/project.json
- *      exists → use the global anchor (so memory accumulates across sessions
- *      whose cwd would otherwise hash differently each time).
- *  (3) Deterministic per-path UUID fallback — stable for any consistent cwd.
+ *  4-level cascade (v0.7+):
+ *  (1) `.claude/project.json` with explicit `project_id` → file-based identity
+ *      (legacy / explicit override). Settings come from the file too.
+ *  (2) Git repo with at least one commit → derive UUID from the root commit
+ *      SHA. Stable across clones, worktrees, machines, file deletions. If a
+ *      settings-only file exists nearby, layer its settings on top.
+ *  (3) Ephemeral cwd (Cowork session paths, /tmp/, etc.) + ~/.claude/project.json
+ *      exists → use the global anchor.
+ *  (4) Deterministic path-hash fallback. The only source that returns
+ *      `initialized: false` — the hook emits a setup warning so the user
+ *      knows to `git init` or `greprag init`.
  *
- *  Crucial: a normal project living under the home dir (e.g. C:/tm-book or
- *  /home/user/projects/foo) without its own .claude/project.json gets the
- *  deterministic hash. The global anchor must NEVER capture it.
+ *  Settings (memoryCapture, sessionStartRecap, inboxNotify) come from a
+ *  repo-level `.claude/project.json` when one exists, regardless of which
+ *  identity level resolved. A file with no `project_id` carries settings
+ *  only — identity flows through git derivation.
  *
  *  // adr: adr/project-anchor.md
  */
 function readAnchor(cwd) {
-    // 1. Walk up from cwd looking for a repo-level .claude/project.json
-    //    (findExistingAnchor skips the home global anchor).
-    const existing = findExistingAnchor(cwd);
-    if (existing) {
-        const anchor = tryReadAnchorFile(existing);
-        if (anchor)
-            return anchor;
+    const existingPath = findExistingAnchor(cwd);
+    const fileContents = existingPath ? tryReadAnchorFileContents(existingPath) : null;
+    // 1. File with explicit project_id → legacy/override identity.
+    if (existingPath && fileContents && fileContents.projectId && fileContents.projectName) {
+        return {
+            projectId: fileContents.projectId,
+            projectName: fileContents.projectName,
+            initialized: true,
+            source: 'file',
+            anchorPath: existingPath,
+            created: fileContents.created,
+            memoryCapture: fileContents.memoryCapture,
+            sessionStartRecap: fileContents.sessionStartRecap,
+            inboxNotify: fileContents.inboxNotify,
+        };
     }
-    // 2. Ephemeral session path — Cowork and friends. The global anchor exists
-    //    specifically to give these a stable bucket since their cwd changes
-    //    every session.
+    // 2. Git-derived identity — stable per-project, no file needed.
+    const gitId = computeGitDerivedProjectId(cwd);
+    if (gitId) {
+        const root = path.resolve(cwd);
+        return {
+            projectId: gitId,
+            projectName: fileContents?.projectName || path.basename(root).toLowerCase(),
+            initialized: true,
+            source: 'git',
+            anchorPath: existingPath || path.join(root, ANCHOR_DIR, ANCHOR_FILE),
+            created: fileContents?.created,
+            memoryCapture: fileContents?.memoryCapture ?? true,
+            sessionStartRecap: fileContents?.sessionStartRecap ?? true,
+            inboxNotify: fileContents?.inboxNotify ?? 'every_turn',
+        };
+    }
+    // 3. Ephemeral cwd + global anchor — Cowork and similar agent runners.
     if (isEphemeralCwd(cwd)) {
         const globalAnchorPath = path.join(os.homedir(), ANCHOR_DIR, ANCHOR_FILE);
-        if (fs.existsSync(globalAnchorPath)) {
-            const anchor = tryReadAnchorFile(globalAnchorPath);
-            if (anchor)
-                return { ...anchor, anchorPath: globalAnchorPath };
+        const globalContents = tryReadAnchorFileContents(globalAnchorPath);
+        if (globalContents && globalContents.projectId && globalContents.projectName) {
+            return {
+                projectId: globalContents.projectId,
+                projectName: globalContents.projectName,
+                initialized: true,
+                source: 'global',
+                anchorPath: globalAnchorPath,
+                created: globalContents.created,
+                memoryCapture: globalContents.memoryCapture,
+                sessionStartRecap: globalContents.sessionStartRecap,
+                inboxNotify: globalContents.inboxNotify,
+            };
         }
     }
-    // 3. Fallback: deterministic per-path UUID + basename as name.
+    // 4. Path-hash fallback — only source that flags `initialized: false`.
     const root = path.resolve(cwd);
     return {
         projectId: deterministicProjectId(root),
-        projectName: path.basename(root).toLowerCase(),
+        projectName: fileContents?.projectName || path.basename(root).toLowerCase(),
         initialized: false,
-        anchorPath: path.join(root, ANCHOR_DIR, ANCHOR_FILE),
-        memoryCapture: true,
-        sessionStartRecap: true,
-        inboxNotify: 'every_turn',
+        source: 'hash',
+        anchorPath: existingPath || path.join(root, ANCHOR_DIR, ANCHOR_FILE),
+        created: fileContents?.created,
+        memoryCapture: fileContents?.memoryCapture ?? true,
+        sessionStartRecap: fileContents?.sessionStartRecap ?? true,
+        inboxNotify: fileContents?.inboxNotify ?? 'every_turn',
     };
 }
 /** Create (or return existing) ~/.claude/project.json.
@@ -184,11 +256,21 @@ function readAnchor(cwd) {
 function ensureGlobalAnchor(projectName) {
     const globalAnchorDir = path.join(os.homedir(), ANCHOR_DIR);
     const globalAnchorPath = path.join(globalAnchorDir, ANCHOR_FILE);
-    // Return existing if valid.
     if (fs.existsSync(globalAnchorPath)) {
-        const anchor = tryReadAnchorFile(globalAnchorPath);
-        if (anchor)
-            return anchor;
+        const contents = tryReadAnchorFileContents(globalAnchorPath);
+        if (contents && contents.projectId && contents.projectName) {
+            return {
+                projectId: contents.projectId,
+                projectName: contents.projectName,
+                initialized: true,
+                source: 'global',
+                anchorPath: globalAnchorPath,
+                created: contents.created,
+                memoryCapture: contents.memoryCapture,
+                sessionStartRecap: contents.sessionStartRecap,
+                inboxNotify: contents.inboxNotify,
+            };
+        }
     }
     if (!fs.existsSync(globalAnchorDir)) {
         fs.mkdirSync(globalAnchorDir, { recursive: true });
@@ -203,6 +285,7 @@ function ensureGlobalAnchor(projectName) {
         projectId: newAnchor.project_id,
         projectName: newAnchor.project_name,
         initialized: true,
+        source: 'global',
         anchorPath: globalAnchorPath,
         created: newAnchor.created,
         memoryCapture: true,
@@ -210,37 +293,75 @@ function ensureGlobalAnchor(projectName) {
         inboxNotify: 'every_turn',
     };
 }
-/** Ensure an anchor exists at <cwd>/.claude/project.json. Generates UUID + writes
- *  the file if absent. Returns the resolved anchor (initialized=true on return).
- *  Called by `greprag init`.
+/** Ensure an anchor exists at <cwd>/.claude/project.json. Behavior depends on
+ *  whether the cwd is inside a git repo with commits:
  *
- *  Does NOT treat the global anchor (~/.claude/project.json) as an existing repo
- *  anchor — init should always create a proper per-repo file. */
+ *   - Git repo with commits: writes settings only (no `project_id` field).
+ *     Identity flows through git derivation — no random UUID stored, so the
+ *     file can be deleted without orphaning history. Returns the resolved
+ *     anchor (source='git').
+ *
+ *   - No git or no commits: writes a random `project_id` to the file (legacy
+ *     behavior). User gets a stable per-path identity until they `git init`
+ *     + commit, at which point they can run `greprag doctor` to migrate.
+ *
+ *  Called by `greprag init`. Idempotent — if a repo-level anchor already
+ *  exists, returns it unchanged.
+ *
+ *  Never treats the global anchor as an existing repo anchor. */
 function ensureAnchor(cwd, projectName) {
     const globalAnchorPath = path.join(os.homedir(), ANCHOR_DIR, ANCHOR_FILE);
     const existing = findExistingAnchor(cwd);
-    // Short-circuit only for a real repo anchor, not the global catch-all.
     if (existing && existing !== globalAnchorPath) {
         return readAnchor(cwd);
     }
     const root = path.resolve(cwd);
     const anchorDir = path.join(root, ANCHOR_DIR);
     const anchorPath = path.join(anchorDir, ANCHOR_FILE);
+    const resolvedName = (projectName || path.basename(root)).toLowerCase();
+    const created = new Date().toISOString();
     if (!fs.existsSync(anchorDir)) {
         fs.mkdirSync(anchorDir, { recursive: true });
     }
+    const gitId = computeGitDerivedProjectId(cwd);
+    if (gitId) {
+        // Git repo with commits — write settings-only file, identity from git.
+        const fileBody = {
+            project_name: resolvedName,
+            created,
+            memory_capture: true,
+            session_start_recap: true,
+            inbox_notify: 'every_turn',
+        };
+        fs.writeFileSync(anchorPath, JSON.stringify(fileBody, null, 2) + '\n');
+        return {
+            projectId: gitId,
+            projectName: resolvedName,
+            initialized: true,
+            source: 'git',
+            anchorPath,
+            created,
+            memoryCapture: true,
+            sessionStartRecap: true,
+            inboxNotify: 'every_turn',
+        };
+    }
+    // No git or no commits — write a random project_id (legacy path). The
+    // hook's drift detector will surface a migration prompt once the project
+    // does get a first commit (doctor consolidates old random UUID → git UUID).
     const newAnchor = {
         project_id: crypto.randomUUID(),
-        project_name: (projectName || path.basename(root)).toLowerCase(),
-        created: new Date().toISOString(),
+        project_name: resolvedName,
+        created,
     };
     fs.writeFileSync(anchorPath, JSON.stringify(newAnchor, null, 2) + '\n');
     return {
         projectId: newAnchor.project_id,
         projectName: newAnchor.project_name,
         initialized: true,
+        source: 'file',
         anchorPath,
-        created: newAnchor.created,
+        created,
         memoryCapture: true,
         sessionStartRecap: true,
         inboxNotify: 'every_turn',

package/dist/project-anchor.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "greprag",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "GrepRAG — agent memory for Claude Code. 2-command setup.",
   "main": "dist/index.js",
   "bin": {

package/skill/SKILL.md

@@ -182,6 +182,29 @@ Address formats (all valid):
 
 Auto-read semantics: any message returned by `greprag inbox` (without `--all`) is marked read in the same call. Once read, it stops appearing in notifications. TTL deletes read messages after 14 days. Use `keep` to extend before expiry.
 
+## Step 5c — Health & repair (when memory looks wrong)
+
+Triggers: user says "memory looks empty", "I'm missing my history", "fix greprag here", "are there orphans", "consolidate my project IDs"; or `greprag status` reports identity drift; or the session-start recap printed a "[GrepRAG memory: identity drift detected ...]" line.
+
+```bash
+greprag doctor
+```
+
+What it does:
+1. Reads the current project's identity (project_id + which cascade level resolved it — file / git-derived / global / path-hash)
+2. Computes what the git-derived UUID *would* be (if in a git repo with commits)
+3. Queries the API for sibling project_ids under the same profile name (these are the orphans — usually from old anchor files lost to gitignore or a hash-fallback period before init)
+4. Presents the findings and offers actions:
+   - **Migrate to git-derived UUID** (recommended when there's drift) — moves current + orphan rows onto the git-derived ID and strips `project_id` from `.claude/project.json` so identity flows from git history going forward
+   - **Consolidate orphans into current UUID** — keeps the current identity but pulls orphan rows in
+   - **Dry-run** — runs the recommended action through the API with `dry_run: true` so the user sees exactly what would change before committing
+
+Flags:
+- `--inspect` — diagnose only, no prompts (good for "tell me what's wrong here")
+- `--yes` / `-y` — non-interactive; picks the recommended action and runs it
+
+Repair is fully tenant-scoped via the API — `greprag doctor` only ever touches rows under the caller's tenant, and the merge runs in a transaction so a partial failure rolls back cleanly.
+
 ## Step 6 — Briefing (when everything is configured)
 
 ```bash