memtrace 1.1.0 → 1.1.2

package/installer/dist/transformers/claude.d.ts

@@ -5,10 +5,12 @@ import { Transformer, TransformResult } from './types.js';
  * Each skill becomes a directory with SKILL.md inside skills/<skill-name>/
  */
 export declare function transformForClaude(skill: Skill): TransformResult[];
+export declare function findCanonicalPluginCacheDirAt(cacheRoot: string, canonicalVersion: string): string | null;
 /**
  * Fallback cache directory when the CLI install didn't create one.
  */
 export declare function getClaudePluginCacheDir(): string;
+export declare function copyBundledPluginAssetsAt(cacheDir: string, sourcePluginDir?: string): void;
 export interface SettingsMutationResult {
     registered: boolean;
     backupPath?: string;

package/installer/dist/transformers/claude.js

@@ -1,6 +1,8 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { fileURLToPath } from 'url';
+import { copyCanonicalPluginAssets, copyCanonicalPluginManifest, readCanonicalPluginVersion, } from '../../plugin-assets/index.js';
 import { execCommand, commandExists } from '../utils.js';
 import { safeReadJson, writeJsonAtomic } from '../fs-safe.js';
 import { LEGACY_MCP_SERVER_NAME, MEMTRACE_MCP_ENV, removeLegacyMcpServer, } from './shared.js';
@@ -9,6 +11,7 @@ const MARKETPLACE_NAME = 'memtrace';
 const MARKETPLACE_REPO = 'syncable-dev/memtrace-public';
 const MARKETPLACE_GIT_URL = `https://github.com/${MARKETPLACE_REPO}.git`;
 const PLUGIN_KEY = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+const BUNDLED_PLUGIN_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'plugins', PLUGIN_NAME);
 const MARKETPLACE_SETTING_KEYS = [
     MARKETPLACE_NAME,
     'syncable-dev-memtrace',
@@ -111,21 +114,24 @@ function getPluginCacheRoot() {
  */
 function findCliInstalledCacheDir() {
     const root = getPluginCacheRoot();
-    if (!fs.existsSync(root))
+    const canonicalVersion = readCanonicalPluginVersion(BUNDLED_PLUGIN_DIR);
+    return findCanonicalPluginCacheDirAt(root, canonicalVersion);
+}
+export function findCanonicalPluginCacheDirAt(cacheRoot, canonicalVersion) {
+    const canonicalCacheDir = path.join(cacheRoot, canonicalVersion);
+    if (!fs.existsSync(canonicalCacheDir))
         return null;
-    for (const entry of fs.readdirSync(root)) {
-        const dir = path.join(root, entry);
-        if (!fs.statSync(dir).isDirectory())
-            continue;
-        return dir;
-    }
-    return null;
+    return fs.statSync(canonicalCacheDir).isDirectory() ? canonicalCacheDir : null;
 }
 /**
  * Fallback cache directory when the CLI install didn't create one.
  */
 export function getClaudePluginCacheDir() {
-    return path.join(getPluginCacheRoot(), '0.0.0');
+    return path.join(getPluginCacheRoot(), readCanonicalPluginVersion(BUNDLED_PLUGIN_DIR));
+}
+export function copyBundledPluginAssetsAt(cacheDir, sourcePluginDir = BUNDLED_PLUGIN_DIR) {
+    copyCanonicalPluginAssets(sourcePluginDir, cacheDir);
+    copyCanonicalPluginManifest(sourcePluginDir, cacheDir);
 }
 // ────────────────────────────────────────────────────────────────────────────
 // Installation strategy (in priority order):
@@ -171,28 +177,6 @@ async function tryClaudeCliInstall() {
         return false;
     }
 }
-/**
- * Write the plugin.json manifest inside the cache directory.
- */
-function writePluginManifest(cacheDir) {
-    const manifestDir = path.join(cacheDir, '.claude-plugin');
-    fs.mkdirSync(manifestDir, { recursive: true });
-    const version = path.basename(cacheDir);
-    const manifest = {
-        name: PLUGIN_NAME,
-        description: 'Memtrace skills for codebase exploration, code search, relationship analysis, temporal evolution, blast radius impact, code quality, graph algorithms, API topology, and multi-step workflows.',
-        version,
-        author: {
-            name: 'Syncable',
-            email: 'support@memtrace.io',
-        },
-        homepage: 'https://memtrace.io',
-        repository: `https://github.com/${MARKETPLACE_REPO}`,
-        license: 'SEE LICENSE IN LICENSE',
-        keywords: ['memtrace', 'code-intelligence', 'knowledge-graph', 'mcp', 'temporal-analysis'],
-    };
-    fs.writeFileSync(path.join(manifestDir, 'plugin.json'), JSON.stringify(manifest, null, 2));
-}
 /**
  * Merge-add the memtrace MCP server into a Claude settings.json file.
  * Never overwrites a malformed file — backs it up and returns registered=false.
@@ -520,7 +504,8 @@ export async function installClaudePlugin(skills, memtraceBinaryPath) {
             }
         }
     }
-    // Step 5: Write skills
+    // Step 5: Write plugin assets and skills
+    copyBundledPluginAssetsAt(cacheDir);
     const skillsDir = path.join(cacheDir, 'skills');
     if (fs.existsSync(skillsDir)) {
         fs.rmSync(skillsDir, { recursive: true });
@@ -533,7 +518,6 @@ export async function installClaudePlugin(skills, memtraceBinaryPath) {
             fs.writeFileSync(fullPath, content);
         }
     }
-    writePluginManifest(cacheDir);
     enablePluginInSettings();
     // Step 6: Register MCP server
     await registerMcpServer(memtraceBinaryPath);

package/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memtrace-skills",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Memtrace skills for AI coding agents — codebase exploration, temporal evolution, impact analysis, and more.",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
     "dist/",
     "skills/",
     "plugins/",
+    "plugin-assets/",
     "README.md"
   ],
   "scripts": {

package/installer/plugin-assets/index.d.ts

@@ -0,0 +1,19 @@
+export const PLUGIN_ASSET_PATHS: readonly ['commands', 'README.md'];
+export const PLUGIN_MANIFEST_PATH: string;
+export const LEGACY_PLUGIN_ASSET_PATHS: readonly [
+  'hooks',
+  'MEMTRACE.md',
+  'INSTALLABLE-DIRECTIVE.md',
+];
+
+export function copyCanonicalPluginAssets(
+  sourcePluginDir: string,
+  destinationPluginDir: string,
+): void;
+
+export function copyCanonicalPluginManifest(
+  sourcePluginDir: string,
+  destinationPluginDir: string,
+): void;
+
+export function readCanonicalPluginVersion(sourcePluginDir: string): string;

package/installer/plugin-assets/index.js

@@ -0,0 +1,51 @@
+import fs from 'fs';
+import path from 'path';
+
+export const PLUGIN_ASSET_PATHS = Object.freeze(['commands', 'README.md']);
+export const PLUGIN_MANIFEST_PATH = path.join('.claude-plugin', 'plugin.json');
+export const LEGACY_PLUGIN_ASSET_PATHS = Object.freeze([
+  'hooks',
+  'MEMTRACE.md',
+  'INSTALLABLE-DIRECTIVE.md',
+]);
+
+export function copyCanonicalPluginAssets(sourcePluginDir, destinationPluginDir) {
+  removeLegacyPluginAssets(destinationPluginDir);
+  for (const relativePath of PLUGIN_ASSET_PATHS) {
+    copyRequiredAsset(sourcePluginDir, destinationPluginDir, relativePath);
+  }
+}
+
+function removeLegacyPluginAssets(destinationPluginDir) {
+  for (const relativePath of LEGACY_PLUGIN_ASSET_PATHS) {
+    fs.rmSync(path.join(destinationPluginDir, relativePath), {
+      recursive: true,
+      force: true,
+    });
+  }
+}
+
+export function copyCanonicalPluginManifest(sourcePluginDir, destinationPluginDir) {
+  copyRequiredAsset(sourcePluginDir, destinationPluginDir, PLUGIN_MANIFEST_PATH);
+}
+
+export function readCanonicalPluginVersion(sourcePluginDir) {
+  const manifestPath = path.join(sourcePluginDir, PLUGIN_MANIFEST_PATH);
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+  if (typeof manifest.version !== 'string' || manifest.version.length === 0) {
+    throw new Error(`Canonical plugin manifest has no version: ${manifestPath}`);
+  }
+  return manifest.version;
+}
+
+function copyRequiredAsset(sourcePluginDir, destinationPluginDir, relativePath) {
+  const sourcePath = path.join(sourcePluginDir, relativePath);
+  if (!fs.existsSync(sourcePath)) {
+    throw new Error(`Missing canonical plugin asset: ${sourcePath}`);
+  }
+
+  const destinationPath = path.join(destinationPluginDir, relativePath);
+  fs.rmSync(destinationPath, { recursive: true, force: true });
+  fs.mkdirSync(path.dirname(destinationPath), { recursive: true });
+  fs.cpSync(sourcePath, destinationPath, { recursive: true });
+}

package/installer/plugins/memtrace-skills/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "memtrace-skills",
+  "description": "Memtrace skills for codebase exploration, code search, relationship analysis, temporal evolution, blast radius impact, code quality, graph algorithms, API topology, GitHub PR code review, multi-agent fleet coordination (branch-scoped intents, conflict classification, and agent-judged Class C resolution), and multi-step workflows for change impact, incident investigation, refactoring, session continuity, co-change analysis, and episode replay, Cortex decision memory (decision recall, provenance, intent verification), session bookends (daily briefing, hotspots, self-audit), and single-symbol pre-edit preflight checks.",
+  "version": "0.4.0",
+  "author": {
+    "name": "Syncable",
+    "email": "support@syncable.dev"
+  },
+  "homepage": "https://memtrace.io",
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "memtrace",
+    "code-intelligence",
+    "knowledge-graph",
+    "mcp",
+    "temporal-analysis",
+    "blast-radius",
+    "refactoring",
+    "architecture",
+    "multi-agent",
+    "fleet-coordination"
+  ]
+}

package/installer/plugins/memtrace-skills/README.md

@@ -0,0 +1,16 @@
+# Memtrace skills plugin
+
+`skills/` is the workflow source of truth. `commands/` contains manual
+shortcuts only.
+
+| Shortcut | Delegated workflow |
+| --- | --- |
+| `/memtrace-skills:mt-onboard` | `memtrace-codebase-exploration` |
+| `/memtrace-skills:mt-impact` | `memtrace-impact` |
+| `/memtrace-skills:mt-preflight` | `memtrace-preflight` |
+| `/memtrace-skills:mt-recall` | `memtrace-decision-memory` |
+
+Plugin-root documentation is not ambient Claude context. The consented npm
+setup manages `~/.claude/MEMTRACE.md`. Native Rail owns discovery enforcement:
+use `memtrace rail enable nudge|rail|strict` or `memtrace rail disable`. This
+plugin deliberately ships no second shell hook.

package/installer/plugins/memtrace-skills/commands/mt-impact.md

@@ -0,0 +1,10 @@
+---
+description: Shortcut to the canonical Memtrace impact analysis skill
+argument-hint: "<symbol> [repo_id]"
+disable-model-invocation: true
+---
+
+Use the `Skill` tool to invoke `memtrace-skills:memtrace-impact` exactly once,
+passing `$ARGUMENTS` unchanged. Treat that skill as the sole source of truth for
+repository resolution, current MCP schemas, safety rules, and output. Do not
+call MCP tools before loading it or reproduce its workflow here.

package/installer/plugins/memtrace-skills/commands/mt-onboard.md

@@ -0,0 +1,10 @@
+---
+description: Shortcut to the canonical Memtrace codebase exploration skill
+argument-hint: "[repo_id]"
+disable-model-invocation: true
+---
+
+Use the `Skill` tool to invoke `memtrace-skills:memtrace-codebase-exploration`
+exactly once, passing `$ARGUMENTS` unchanged. Treat that skill as the sole source
+of truth for repository resolution, current MCP schemas, safety rules, and
+output. Do not call MCP tools before loading it or reproduce its workflow here.

package/installer/plugins/memtrace-skills/commands/mt-preflight.md

@@ -0,0 +1,10 @@
+---
+description: Shortcut to the canonical Memtrace preflight skill
+argument-hint: "<symbol> [repo_id]"
+disable-model-invocation: true
+---
+
+Use the `Skill` tool to invoke `memtrace-skills:memtrace-preflight` exactly once,
+passing `$ARGUMENTS` unchanged. Treat that skill as the sole source of truth for
+repository resolution, current MCP schemas, safety rules, and output. Do not
+call MCP tools before loading it or reproduce its workflow here.

package/installer/plugins/memtrace-skills/commands/mt-recall.md

@@ -0,0 +1,10 @@
+---
+description: Shortcut to the canonical Memtrace decision-memory skill
+argument-hint: "<query>"
+disable-model-invocation: true
+---
+
+Use the `Skill` tool to invoke `memtrace-skills:memtrace-decision-memory`
+exactly once, passing `$ARGUMENTS` unchanged. Treat that skill as the sole source
+of truth for repository resolution, current MCP schemas, safety rules, and
+output. Do not call MCP tools before loading it or reproduce its workflow here.

package/lib/claude-integration.js

@@ -59,6 +59,11 @@ match: \`mcp__memtrace__get_symbol_context\` for callers/callees,
 \`mcp__memtrace__get_evolution\` for history. Read source ONLY at the
 exact spans Memtrace returned, with a few lines of context.
 
+Before modifying an existing symbol, call
+\`mcp__memtrace__preflight_check\`. Before deleting, refactoring, or
+contradicting odd-looking code, call \`mcp__memtrace__recall_decision\`
+to check recorded decisions, bans, and conventions.
+
 \`Read\` / \`Grep\` / \`Glob\` remain correct ONLY for:
 
 - Config files (\`.env\`, \`package.json\`, README, raw JSON/YAML/TOML)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memtrace",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Code intelligence graph — MCP server + AI agent skills + visualization UI",
   "keywords": [
     "mcp",
@@ -40,12 +40,12 @@
     "fs-extra": "^11.0.0"
   },
   "optionalDependencies": {
-    "@memtrace/darwin-arm64": "1.1.0",
-    "@memtrace/linux-x64": "1.1.0",
-    "@memtrace/linux-arm64": "1.1.0",
-    "@memtrace/win32-x64": "1.1.0",
-    "@memtrace/linux-x64-noavx2": "1.1.0",
-    "@memtrace/win32-x64-noavx2": "1.1.0"
+    "@memtrace/darwin-arm64": "1.1.2",
+    "@memtrace/linux-x64": "1.1.2",
+    "@memtrace/linux-arm64": "1.1.2",
+    "@memtrace/win32-x64": "1.1.2",
+    "@memtrace/linux-x64-noavx2": "1.1.2",
+    "@memtrace/win32-x64-noavx2": "1.1.2"
   },
   "engines": {
     "node": ">=18"