memorix 1.2.2 → 1.2.4

package/docs/dev-log/progress.txt

@@ -4,15 +4,66 @@
 > older notes when they conflict.
 
 ## Current State
-- Phase: 1.2.2 memory-control-plane admission and visibility implementation
-- Branch: `codex/1.2.2-memory-control-plane`
-- Last updated: 2026-07-25
-- Released baseline: `memorix@1.2.1`, tag `v1.2.1`, `origin/main` at
-  `1b5bf7f`.
-- Goal: make the 1.2 multi-dimensional evidence layer behave as one bounded,
-  explainable control plane. A task Workset, hook handoff, lifecycle refresh,
-  and provider capability result must share evidence qualification, delivery
-  budgets, and privacy-safe receipts.
+- Phase: 1.2.4 persistent memory delivery release candidate
+- Branch: `codex/1.2.4-persistent-memory-delivery`
+- Last updated: 2026-07-26
+- Released baseline: `memorix@1.2.3`, tag `v1.2.3`, `origin/main` at
+  `03ceb6d`.
+- Goal: make the existing persistent memory layer deliver useful prior work
+  naturally across MCP and CLI without turning ordinary tasks into historical
+  context dumps.
+
+## 1.2.4 Persistent Memory Delivery
+- Continuation is now a bounded delivery projection over existing sessions and
+  durable observations, not a second handoff database. `TaskWorkset` keeps its
+  task lens (`bugfix`, `feature`, and so on) while independently recognizing a
+  continuation request.
+- A continuation Workset includes at most the latest meaningful completed
+  session summary plus three readable durable memory anchors. Each item is
+  visible in the existing `ContextReceipt`; ordinary tasks do not receive it.
+- `memorix resume "<task>"` is the CLI-equivalent continuation entry. The
+  existing MCP `memorix_project_context` receives the same behavior from the
+  user's task text, so the micro MCP profile stays at seven tools.
+- Setup-generated rules now use a single fallback call when MCP is genuinely
+  unavailable: `memorix resume` for prior work or `memorix context` for new
+  work. They explicitly forbid help probing, command enumeration, and broad
+  search loops before the first brief.
+- The visibility reader is carried into continuation retrieval, preserving
+  project aliases while failing closed for other agents' personal memory.
+- Continuation text preserves whole technical identifiers instead of emitting a
+  misleading partial token. MCP Project Context also establishes a short-lived
+  delivery boundary: a follow-up search/detail request does not re-send an
+  already represented record unless the caller names a missing fact or the user
+  explicitly asks for the underlying detail.
+- A read-only or "do not modify files" Autopilot task blocks `memorix_store`
+  by default. The only override is an explicit user request to persist a
+  record, represented by `overrideReadOnly: true`.
+- A real Codex user-path smoke, in a fresh Git fixture seeded only through the
+  public CLI, made one natural-language continuation request. Codex received
+  the bounded brief, used one specific Context Pack expansion, was stopped
+  from re-reading already-covered memory, made no `memorix_store` write, and
+  returned the correct read-only next step.
+- Completed local gates: TypeScript check, production build, focused
+  continuation/hook/CLI regressions, and the full suite (`237` files / `2677`
+  tests). A fresh packed install with optional native dependencies omitted used
+  Node SQLite to persist the same `memorix.db`; CLI resume retained
+  `AUTH_REFRESH_V2`; the micro MCP package surface exposed exactly seven tools
+  and enforced duplicate-retrieval plus read-only-write boundaries; and an
+  isolated Codex global setup wrote/activated the versioned Personal-marketplace
+  plugin with the matching skill guidance. Pending release gates: CI and
+  publish.
+
+## 1.2.3 Session Context Visibility Hotfix
+- A real installed-package CLI smoke found that a second coordination identity
+  could receive the first identity's personal observation in automatic session
+  context. The root cause was a reader-less core session-context call.
+- `getSessionContext()` now accepts an `ObservationReader`; CLI, MCP, and TUI
+  session entry points pass their resolved caller identity. Alias-backed
+  project-visible records remain readable, while personal/team records fail
+  closed.
+- Graph-neighbor routing is omitted whenever a reader is present because graph
+  relations are not yet visibility-scoped. Core, CLI, MCP, and alias regression
+  tests cover the boundary.
 
 ## 1.1.13 Closeout
 - Codex setup now stamps plugin versions and doctor distinguishes bundle,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "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/plugins/codex/memorix/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "memorix",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "Shared workspace memory for Codex and other AI coding agents.",
   "author": {
     "name": "AVIDS2",

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;
+}

package/src/cli/capability-map.ts

@@ -3,7 +3,7 @@ export const CLI_NATIVE_PARITY: Record<string, string> = Object.freeze({
   memorix_search: 'memorix memory search',
   memorix_detail: 'memorix memory detail',
   memorix_graph_context: 'memorix memory graph-context',
-  memorix_project_context: 'memorix context',
+  memorix_project_context: 'memorix context|resume',
   memorix_context_pack: 'memorix codegraph context-pack',
   memorix_codegraph_status: 'memorix codegraph status',
   memorix_knowledge: 'memorix knowledge init|status|compile|lint|apply|workflow',

package/src/cli/command-guide.ts

@@ -39,7 +39,10 @@ const GUIDES: Record<string, CliCommandGuide> = {
   },
   context: {
     summary: 'Build the bounded task Workset used to resume or begin real work.',
-    usage: ['memorix context --task "continue the release fix" [--refresh auto|always|never]'],
+    usage: [
+      'memorix context "continue the release fix" [--refresh auto|always|never]',
+      'memorix resume "continue the release fix" [--refresh auto|always|never]',
+    ],
   },
   explain: {
     summary: 'Show why a task context contains its current facts and memory evidence.',

package/src/cli/commands/agent-integrations.ts

@@ -776,7 +776,11 @@ function isCurrentGuidance(content: string): boolean {
   return (
     content.includes('Memory Autopilot') &&
     content.includes('Default first step for non-trivial coding work') &&
-    content.includes('memorix_project_context')
+    content.includes('memorix_project_context') &&
+    content.includes('memorix resume') &&
+    content.includes('Continuation fallback is mandatory') &&
+    content.includes('Do not call more Memorix retrieval tools') &&
+    content.includes('read-only work')
   );
 }
 

package/src/cli/commands/audit-list.ts

@@ -1,89 +1,89 @@
-/**
- * CLI Command: memorix audit list
- *
- * List all files written by Memorix (audit trail).
- */
-
-import { defineCommand } from 'citty';
-import * as p from '@clack/prompts';
-
-export default defineCommand({
-  meta: {
-    name: 'list',
-    description: 'List Memorix-written files (audit trail)',
-  },
-  args: {
-    project: {
-      type: 'string',
-      description: 'Filter by project (optional)',
-      required: false,
-    },
-  },
-  run: async ({ args }) => {
-    const { getAllAuditEntries, getProjectId } = await import('../../audit/index.js');
-    const os = await import('node:os');
-    let cwd: string;
-    try {
-      cwd = process.cwd();
-    } catch {
-      cwd = os.homedir();
-      console.log(`[WARN] Could not access current directory, using home: ${cwd}`);
-    }
-
-    p.intro('Memorix Audit Trail');
-
-    const allEntries = await getAllAuditEntries();
-
-    if (allEntries.length === 0) {
-      console.log('No Memorix-written files found.');
-      p.outro('Audit trail is empty.');
-      return;
-    }
-
-    // Filter by project if specified
-    let entries = allEntries;
-    if (args.project) {
-      const targetProjectId = getProjectId(args.project);
-      entries = allEntries.filter((e) => e.projectId === targetProjectId);
-    }
-
-    if (entries.length === 0) {
-      console.log('No Memorix-written files found for this project.');
-      p.outro('Audit trail is empty for this project.');
-      return;
-    }
-
-    // Group by project
-    const byProject: Record<string, Array<{ entry: import('../../audit/index.js').AuditEntry }>> = {};
-    for (const { projectId, entry } of entries) {
-      if (!byProject[projectId]) {
-        byProject[projectId] = [];
-      }
-      byProject[projectId].push({ entry });
-    }
-
-    // Display by project
-    console.log('');
-    for (const [projectId, items] of Object.entries(byProject)) {
-      console.log(`Project: ${projectId}`);
-      console.log('');
-
-      for (const { entry } of items) {
-        const icon = entry.type === 'hook' ? '[HOOK]' : '[TASK]';
-        const agent = entry.agent ? ` (${entry.agent})` : '';
-        console.log(`${icon} ${entry.path}${agent}`);
-        console.log(`   Created: ${entry.createdAt}`);
-        console.log('');
-      }
-    }
-
-    // Summary
-    const hookCount = entries.filter((e) => e.entry.type === 'hook').length;
-    const ruleCount = entries.filter((e) => e.entry.type === 'rule').length;
-    const projectCount = new Set(entries.map((e) => e.projectId)).size;
-
-    p.note(`${projectCount} projects, ${hookCount} hooks, ${ruleCount} rules`);
-
-    p.outro('Audit trail complete.');
-  },
-});
+/**
+ * CLI Command: memorix audit list
+ *
+ * List all files written by Memorix (audit trail).
+ */
+
+import { defineCommand } from 'citty';
+import * as p from '@clack/prompts';
+
+export default defineCommand({
+  meta: {
+    name: 'list',
+    description: 'List Memorix-written files (audit trail)',
+  },
+  args: {
+    project: {
+      type: 'string',
+      description: 'Filter by project (optional)',
+      required: false,
+    },
+  },
+  run: async ({ args }) => {
+    const { getAllAuditEntries, getProjectId } = await import('../../audit/index.js');
+    const os = await import('node:os');
+    let cwd: string;
+    try {
+      cwd = process.cwd();
+    } catch {
+      cwd = os.homedir();
+      console.log(`[WARN] Could not access current directory, using home: ${cwd}`);
+    }
+
+    p.intro('Memorix Audit Trail');
+
+    const allEntries = await getAllAuditEntries();
+
+    if (allEntries.length === 0) {
+      console.log('No Memorix-written files found.');
+      p.outro('Audit trail is empty.');
+      return;
+    }
+
+    // Filter by project if specified
+    let entries = allEntries;
+    if (args.project) {
+      const targetProjectId = getProjectId(args.project);
+      entries = allEntries.filter((e) => e.projectId === targetProjectId);
+    }
+
+    if (entries.length === 0) {
+      console.log('No Memorix-written files found for this project.');
+      p.outro('Audit trail is empty for this project.');
+      return;
+    }
+
+    // Group by project
+    const byProject: Record<string, Array<{ entry: import('../../audit/index.js').AuditEntry }>> = {};
+    for (const { projectId, entry } of entries) {
+      if (!byProject[projectId]) {
+        byProject[projectId] = [];
+      }
+      byProject[projectId].push({ entry });
+    }
+
+    // Display by project
+    console.log('');
+    for (const [projectId, items] of Object.entries(byProject)) {
+      console.log(`Project: ${projectId}`);
+      console.log('');
+
+      for (const { entry } of items) {
+        const icon = entry.type === 'hook' ? '[HOOK]' : '[TASK]';
+        const agent = entry.agent ? ` (${entry.agent})` : '';
+        console.log(`${icon} ${entry.path}${agent}`);
+        console.log(`   Created: ${entry.createdAt}`);
+        console.log('');
+      }
+    }
+
+    // Summary
+    const hookCount = entries.filter((e) => e.entry.type === 'hook').length;
+    const ruleCount = entries.filter((e) => e.entry.type === 'rule').length;
+    const projectCount = new Set(entries.map((e) => e.projectId)).size;
+
+    p.note(`${projectCount} projects, ${hookCount} hooks, ${ruleCount} rules`);
+
+    p.outro('Audit trail complete.');
+  },
+});