memorix 1.1.7 → 1.1.8

package/docs/SETUP.md

@@ -104,6 +104,7 @@ memorix --version
 memcode --version
 memorix status
 memorix config path
+memorix doctor agents --agent <agent>
 ```
 
 ---
@@ -124,6 +125,15 @@ To see the current setup matrix:
 memorix setup --list
 ```
 
+If an agent does not naturally see or use Memorix after setup, inspect the integration layer:
+
+```bash
+memorix doctor agents --agent <agent>
+memorix repair agents --agent <agent>
+```
+
+The doctor checks Memorix-owned MCP entries and guidance files for stale command paths, missing `memorix` MCP servers, missing Claude `alwaysLoad`, and outdated Memory Autopilot rules.
+
 ### Option B: manual stdio MCP
 
 ```bash

package/docs/dev-log/progress.txt

@@ -1,42 +1,51 @@
 # Memorix Development Progress
 
 > Current handoff note for new agent sessions. Older package-specific notes may
-> exist under subdirectories; prefer this file for the repository-wide state.
+> exist under subdirectories; prefer this file for repository-wide state.
 
 ## Current State
-- Phase: 1.1.7 task-lensed Memory Autopilot
-- Branch: codex/1.1.7-task-lensed-brief
-- PR: pending
-- Last updated: 2026-07-07
-- Goal: make `memorix_project_context` and `memorix context --task ...` shape the first context packet to the user's actual coding task instead of returning one generic project brief.
+- Phase: 1.1.8 release finalization
+- Branch: main
+- PR: #118 merged
+- Last updated: 2026-07-08
+- Goal: publish 1.1.8 after committing the final Claude local MCP repair and CodeGraph noise-control patch.
 
-## Completed In This Branch
-- Added a deterministic task-lens policy module for `bugfix`, `feature`, `release`, `onboarding`, `refactor`, `docs`, `test`, and `general`.
-- Wired the selected lens into `buildAutoProjectContext`, CLI JSON, MCP prompt/summary/json, and Memory Autopilot formatting.
-- Made Start here ranking lens-aware. Release briefs now surface `CHANGELOG.md`, `package.json`, lockfiles, CI, and README ahead of generic code memory. Onboarding/docs briefs prefer docs and entry points.
-- Added lens-specific verification hints, such as smallest failing repro for bugfix work and build/tests/package smoke for release work.
-- Added noise control for release/onboarding/docs briefs: unrelated current/suspect memory details are hidden while counts and warnings remain visible.
-- Updated generated rules, official skills, and static plugin skills so agents pass the user's actual task into `memorix_project_context` or the CLI fallback.
-- Bumped root and workspace package versions to 1.1.7 and updated `CHANGELOG.md`, README files, API docs, and lockfile.
+## Completed Recently
+- Merged PR #118: `fix(setup): make Memory Autopilot self-checking`.
+- Added `memorix doctor agents` and `memorix repair agents` so users can detect and repair stale agent MCP/rules setup.
+- Strengthened generated agent guidance so `memorix_project_context` is the default first step for non-trivial coding work.
+- Verified main at `8567f5e` after merge; GitHub CI passed before merge.
+- Confirmed local OpenRouter embedding lane resolves to `qwen/qwen3-embedding-8b` without printing secrets.
+- Fixed Claude Code 2.x local MCP repair: doctor/repair now inspect `~/.claude.json` project-private entries and rewrite stale worktree commands to `memorix serve` with `alwaysLoad: true`.
+- Fixed all-scope doctor noise: one healthy local, project, or global scope is enough in all-scope mode unless a stale actionable config is present.
+- Fixed CodeGraph Memory noise: `.tmp`, `.worktrees`, and `.claude/worktrees` are ignored by the lite scan and Autopilot suggested reads.
+- Bumped root and workspace package versions to `1.1.8` and updated lockfile/internal workspace dependencies.
+
+## Current Follow-Up
+- The release patch is implemented and verified locally, but not committed or pushed yet.
+- Two unrelated local changes were temporarily stashed before final verification so they do not enter the release package: `packages/ai/src/models.generated.ts` and `packages/memcode/docs/images/exy.png`.
 
 ## Verification Snapshot
 - `git diff --check`
-- `npx vitest run tests/codegraph/auto-context.test.ts tests/cli/context-command.test.ts tests/integration/tool-profile.test.ts tests/server/context-pack-tool-profile.test.ts tests/hooks/install-uninstall.test.ts tests/hooks/claude-rules-path.test.ts`
+- `npm test -- tests/cli/agent-doctor.test.ts tests/codegraph/lite-provider.test.ts tests/codegraph/project-context.test.ts tests/codegraph/context-pack.test.ts`
 - `npm run lint`
 - `npm run build`
-- `npm pack --dry-run`
 - `npm test`
-- Built CLI smoke: `node .\dist\cli\index.js context --task "fix failing startup smoke" --refresh never`
-- Built CLI smoke: `node .\dist\cli\index.js context --task "prepare 1.1.7 release" --refresh never`
-- Built CLI JSON smoke: `node .\dist\cli\index.js context --task "prepare 1.1.7 release" --refresh never --json`
-- Real MCP SDK smoke: stdio `micro` profile listed 7 tools, exposed `memorix_project_context`, and returned a prompt containing `Task lens: bugfix`.
+- `npm pack --dry-run --json` -> `memorix@1.1.8`, about 14.1 MB packed / 60.3 MB unpacked
+- `node dist/cli/index.js doctor agents --agent claude --scope local`
+- `node dist/cli/index.js doctor agents --agent claude --scope all`
+- `node dist/cli/index.js codegraph refresh --json`
+- `node dist/cli/index.js context --refresh never --task "准备发布 1.1.8：判断当前进度、风险和下一步"`
+- `claude mcp get memorix`
+- `claude mcp list`
+- Claude Code user-style smoke: a short print-mode handoff correctly blocked release because local changes were not committed yet; longer print-mode smoke can still time out.
 
 ## Known UX Notes
-- Claude Code print-mode with `claude-fable-5` and a temporary `--mcp-config` reached tool-use behavior in one run but exceeded the low budget before a final answer; a later full run timed out. Deterministic SDK MCP smoke passes, so this is tracked as CC print-mode/model runtime instability rather than a Memorix MCP failure.
-- The default stdio MCP profile is intentionally compact (`micro`, 7 tools). Use `memorix serve --mode lite|team|full` only when the agent needs the larger surface.
-- Task lenses are local heuristics, not LLM classification. Current code and verification still outrank stored memory.
+- Claude Code print-mode can be slow or fail to finish under budget during full user-style smoke. Use tool traces plus deterministic CLI/MCP smoke to distinguish product failures from model/runtime drift.
+- `memorix context --refresh never --task "<task>"` is fast and stable for first-contact context. `--refresh auto` can take longer on this repository.
+- Current code and release facts outrank stale handoff notes or older dev logs when they conflict.
 
 ## Next Steps
-- Commit and push `codex/1.1.7-task-lensed-brief`.
-- Open the 1.1.7 PR and wait for CI/review.
-- Publish 1.1.7 only after the merged main branch is verified clean.
+- Commit and push the 1.1.8 release patch.
+- Publish `memorix@1.1.8` to npm, then tag and push `v1.1.8`.
+- Restore the temporary local stash after publishing if those local model/image changes are still needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
   "type": "module",
   "sideEffects": false,

package/src/audit/index.ts

@@ -1,156 +1,156 @@
-/**
- * Audit Module - Track Memorix-written files
- *
- * Records all files written by Memorix to distinguish them from
- * project-native files. Provides audit trail for cleanup and rollback.
- */
-
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { homedir } from 'node:os';
-
-function getAuditFilePath(): string {
-  return process.env.MEMORIX_AUDIT_FILE || path.join(homedir(), '.memorix', 'audit.json');
-}
-
-export interface AuditEntry {
-  type: 'hook' | 'rule' | 'other';
-  agent?: string;
-  path: string;
-  createdAt: string;
-}
-
-export interface ProjectAudit {
-  projectRoot: string;
-  installedAt: string;
-  entries: AuditEntry[];
-}
-
-export interface AuditData {
-  version: string;
-  projects: Record<string, ProjectAudit>;
-}
-
-/**
- * Load audit data from disk.
- */
-export async function loadAudit(): Promise<AuditData> {
-  try {
-    const content = await fs.readFile(getAuditFilePath(), 'utf-8');
-    return JSON.parse(content) as AuditData;
-  } catch {
-    // No audit file yet
-    return {
-      version: '1.0.0',
-      projects: {},
-    };
-  }
-}
-
-/**
- * Save audit data to disk.
- */
-export async function saveAudit(data: AuditData): Promise<void> {
-  const auditFile = getAuditFilePath();
-  const dir = path.dirname(auditFile);
-  await fs.mkdir(dir, { recursive: true });
-  await fs.writeFile(auditFile, JSON.stringify(data, null, 2), 'utf-8');
-}
-
-/**
- * Get project ID from project root via .git detection.
- */
-export function getProjectId(projectRoot: string): string {
-  try {
-    const { detectProject } = require('../project/detector.js');
-    const project = detectProject(projectRoot);
-    if (project) return project.id;
-  } catch { /* fallback below */ }
-  const normalized = projectRoot.replace(/\\/g, '/');
-  return `untracked/${normalized}`;
-}
-
-/**
- * Record a file written by Memorix.
- */
-export async function recordFile(
-  projectRoot: string,
-  type: AuditEntry['type'],
-  filePath: string,
-  agent?: string,
-): Promise<void> {
-  const data = await loadAudit();
-  const projectId = getProjectId(projectRoot);
-
-  if (!data.projects[projectId]) {
-    data.projects[projectId] = {
-      projectRoot,
-      installedAt: new Date().toISOString(),
-      entries: [],
-    };
-  }
-
-  // Check if entry already exists
-  const existingIndex = data.projects[projectId].entries.findIndex(
-    (e) => e.path === filePath
-  );
-
-  if (existingIndex === -1) {
-    data.projects[projectId].entries.push({
-      type,
-      agent,
-      path: filePath,
-      createdAt: new Date().toISOString(),
-    });
-  }
-
-  await saveAudit(data);
-}
-
-/**
- * Get all files written by Memorix for a project.
- */
-export async function getProjectFiles(projectRoot: string): Promise<AuditEntry[]> {
-  const data = await loadAudit();
-  const projectId = getProjectId(projectRoot);
-  return data.projects[projectId]?.entries || [];
-}
-
-/**
- * Remove a file from audit (when uninstalled).
- */
-export async function removeFile(projectRoot: string, filePath: string): Promise<void> {
-  const data = await loadAudit();
-  const projectId = getProjectId(projectRoot);
-
-  if (!data.projects[projectId]) return;
-
-  data.projects[projectId].entries = data.projects[projectId].entries.filter(
-    (e) => e.path !== filePath
-  );
-
-  // If no entries left, remove the project
-  if (data.projects[projectId].entries.length === 0) {
-    delete data.projects[projectId];
-  }
-
-  await saveAudit(data);
-}
-
-/**
- * Get all audit entries across all projects.
- */
-export async function getAllAuditEntries(): Promise<
-  Array<{ projectId: string; entry: AuditEntry }>
-> {
-  const data = await loadAudit();
-  const entries: Array<{ projectId: string; entry: AuditEntry }> = [];
-
-  for (const [projectId, project] of Object.entries(data.projects)) {
-    for (const entry of project.entries) {
-      entries.push({ projectId, entry });
-    }
-  }
-
-  return entries;
-}
+/**
+ * Audit Module - Track Memorix-written files
+ *
+ * Records all files written by Memorix to distinguish them from
+ * project-native files. Provides audit trail for cleanup and rollback.
+ */
+
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+
+function getAuditFilePath(): string {
+  return process.env.MEMORIX_AUDIT_FILE || path.join(homedir(), '.memorix', 'audit.json');
+}
+
+export interface AuditEntry {
+  type: 'hook' | 'rule' | 'other';
+  agent?: string;
+  path: string;
+  createdAt: string;
+}
+
+export interface ProjectAudit {
+  projectRoot: string;
+  installedAt: string;
+  entries: AuditEntry[];
+}
+
+export interface AuditData {
+  version: string;
+  projects: Record<string, ProjectAudit>;
+}
+
+/**
+ * Load audit data from disk.
+ */
+export async function loadAudit(): Promise<AuditData> {
+  try {
+    const content = await fs.readFile(getAuditFilePath(), 'utf-8');
+    return JSON.parse(content) as AuditData;
+  } catch {
+    // No audit file yet
+    return {
+      version: '1.0.0',
+      projects: {},
+    };
+  }
+}
+
+/**
+ * Save audit data to disk.
+ */
+export async function saveAudit(data: AuditData): Promise<void> {
+  const auditFile = getAuditFilePath();
+  const dir = path.dirname(auditFile);
+  await fs.mkdir(dir, { recursive: true });
+  await fs.writeFile(auditFile, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+/**
+ * Get project ID from project root via .git detection.
+ */
+export function getProjectId(projectRoot: string): string {
+  try {
+    const { detectProject } = require('../project/detector.js');
+    const project = detectProject(projectRoot);
+    if (project) return project.id;
+  } catch { /* fallback below */ }
+  const normalized = projectRoot.replace(/\\/g, '/');
+  return `untracked/${normalized}`;
+}
+
+/**
+ * Record a file written by Memorix.
+ */
+export async function recordFile(
+  projectRoot: string,
+  type: AuditEntry['type'],
+  filePath: string,
+  agent?: string,
+): Promise<void> {
+  const data = await loadAudit();
+  const projectId = getProjectId(projectRoot);
+
+  if (!data.projects[projectId]) {
+    data.projects[projectId] = {
+      projectRoot,
+      installedAt: new Date().toISOString(),
+      entries: [],
+    };
+  }
+
+  // Check if entry already exists
+  const existingIndex = data.projects[projectId].entries.findIndex(
+    (e) => e.path === filePath
+  );
+
+  if (existingIndex === -1) {
+    data.projects[projectId].entries.push({
+      type,
+      agent,
+      path: filePath,
+      createdAt: new Date().toISOString(),
+    });
+  }
+
+  await saveAudit(data);
+}
+
+/**
+ * Get all files written by Memorix for a project.
+ */
+export async function getProjectFiles(projectRoot: string): Promise<AuditEntry[]> {
+  const data = await loadAudit();
+  const projectId = getProjectId(projectRoot);
+  return data.projects[projectId]?.entries || [];
+}
+
+/**
+ * Remove a file from audit (when uninstalled).
+ */
+export async function removeFile(projectRoot: string, filePath: string): Promise<void> {
+  const data = await loadAudit();
+  const projectId = getProjectId(projectRoot);
+
+  if (!data.projects[projectId]) return;
+
+  data.projects[projectId].entries = data.projects[projectId].entries.filter(
+    (e) => e.path !== filePath
+  );
+
+  // If no entries left, remove the project
+  if (data.projects[projectId].entries.length === 0) {
+    delete data.projects[projectId];
+  }
+
+  await saveAudit(data);
+}
+
+/**
+ * Get all audit entries across all projects.
+ */
+export async function getAllAuditEntries(): Promise<
+  Array<{ projectId: string; entry: AuditEntry }>
+> {
+  const data = await loadAudit();
+  const entries: Array<{ projectId: string; entry: AuditEntry }> = [];
+
+  for (const [projectId, project] of Object.entries(data.projects)) {
+    for (const entry of project.entries) {
+      entries.push({ projectId, entry });
+    }
+  }
+
+  return entries;
+}