cfsa-antigravity 5.0.0 → 6.0.0

package/README.md

@@ -29,7 +29,6 @@ npx cfsa-antigravity init --agent claude,factory
 | `cfsa-antigravity init --dry-run` | Preview what would be installed |
 | `cfsa-antigravity init --path ./dir` | Install into specific directory |
 | `cfsa-antigravity init --memory` | Scaffold unified `.memory/` + MCP integration |
-| `cfsa-antigravity init --migrate-memory` | Scaffold unified memory and import legacy runtime memory |
 
 ### Available runtimes
 
@@ -54,8 +53,7 @@ Every install now scaffolds a shared `.memory/` root at the project level. It is
 ├── schema/      # machine-readable index/chunk artifacts
 ├── mcp-server/  # shared project-local MCP daemon + per-runtime client entrypoints
 ├── runtime/     # daemon pid/state files
-├── hooks/       # Claude hook entrypoints
-└── migrate/     # legacy memory import helpers
+└── hooks/       # Claude hook entrypoints
 ```
 
 The installer ships the shared memory runtime into `.memory/`, including the project-local MCP server under `.memory/mcp-server/`. Tool-specific MCP client config is intentionally **not** managed by the kit — users wire their own `.mcp.json` / editor settings for the tools they actually use. The daemon writes workspace-local runtime state into `.memory/runtime/`, and clients resolve that state before proxying requests so one workspace does not silently talk to another workspace's daemon. The semantic index writes retrieval artifacts into `.memory/schema/semantic-index.json` plus `.memory/schema/semantic-manifest.json`.
@@ -150,10 +148,6 @@ A fresh `init` now installs:
 
 Tool-specific MCP client config (such as `.mcp.json`) is user-managed and documented above.
 
-Use `--migrate-memory` when upgrading an older installation that still has runtime-local memory you want imported into `.memory/`.
-
-If migration finds a knowledge-file destination with different existing contents, it preserves both versions by writing a `.conflict-YYYY-MM-DD.md` sibling file for manual reconciliation.
-
 ## Documentation
 
 | Document | Contents |

package/bin/cli.mjs

@@ -200,7 +200,6 @@ ${c.bold}Init Options:${c.reset}
   --dry-run           Preview what would be copied without making changes
   --quiet             Suppress output (for CI/CD — installs all runtimes)
   --memory            Scaffold unified .memory/ and MCP integration
-  --migrate-memory    Scaffold .memory/ and migrate legacy runtime memory
 
 ${c.bold}Examples:${c.reset}
   ${c.dim}# Interactive — pick which runtimes to install${c.reset}
@@ -225,7 +224,7 @@ ${c.bold}Examples:${c.reset}
 
 // --- Parse Arguments ---
 function parseArgs(args) {
-    const parsed = { command: null, agents: null, force: false, dryRun: false, path: null, quiet: false, memory: false, migrateMemory: false, json: false };
+    const parsed = { command: null, agents: null, force: false, dryRun: false, path: null, quiet: false, memory: false, json: false };
 
     let i = 0;
     while (i < args.length) {
@@ -272,10 +271,6 @@ function parseArgs(args) {
             case "--memory":
                 parsed.memory = true;
                 break;
-            case "--migrate-memory":
-                parsed.memory = true;
-                parsed.migrateMemory = true;
-                break;
             case "--json":
                 parsed.json = true;
                 break;
@@ -424,18 +419,6 @@ function installMemoryScaffold(targetDir, opts) {
     info(`MCP client configuration is user-managed; see the README for tool-specific setup and the initial graph compile step.`);
 }
 
-async function migrateMemory(targetDir) {
-    const migratePath = join(targetDir, ".memory", "migrate", "migrate-legacy.mjs");
-    if (!existsSync(migratePath)) {
-        error("Unified memory migration script not found after scaffold.");
-        exit(1);
-    }
-
-    const migrationModule = await import(pathToFileURL(migratePath).href);
-    const result = migrationModule.migrateLegacyMemory({ projectRoot: targetDir });
-    info(`Migrated legacy memory (${result.migratedCount} item(s))`);
-}
-
 // --- Install runtimes ---
 function installRuntimes(runtimes, targetDir, opts) {
     let totalCopied = 0;
@@ -569,9 +552,6 @@ async function cmdInit(opts) {
     const { totalCopied, totalSkipped } = installRuntimes(selected, targetDir, opts);
 
     installMemoryScaffold(targetDir, opts);
-    if (opts.migrateMemory && !opts.dryRun) {
-        await migrateMemory(targetDir);
-    }
 
     if (!opts.dryRun) {
         const compilePath = join(targetDir, ".memory", "pipeline", "compile.mjs");

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "cfsa-antigravity",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "CFSA Pipeline — Constraint-First Specification Architecture for AI agents. Production-grade from line one.",
   "scripts": {
     "changeset": "changeset",
     "version": "changeset version",
     "prebuild": "./scripts/build-template.sh",
     "build": "./scripts/build-template.sh",
-    "check": "./scripts/check-template-integrity.sh && node ./scripts/check-memory-mcp.mjs && node ./scripts/check-memory-migration.mjs && node ./scripts/check-vault-contract.mjs && node ./scripts/check-e2e-harness.mjs",
+    "check": "./scripts/check-template-integrity.sh && node ./scripts/check-memory-mcp.mjs && node ./scripts/check-vault-contract.mjs && node ./scripts/check-e2e-harness.mjs",
     "prepare": "husky || true"
   },
   "bin": {

package/template/.claude/README.md

@@ -24,8 +24,7 @@ Project root canonical memory / Obsidian vault:
 ├── wiki/                # Compiled patterns, decisions, blockers, and knowledge
 ├── schema/              # Machine-readable retrieval artifacts
 ├── mcp-server/          # Shared memory MCP server
-├── hooks/               # Claude hook entrypoints
-└── migrate/             # Legacy memory import helpers
+└── hooks/               # Claude hook entrypoints
 ```
 
 The `.memory/` directory is the canonical project memory layer and is designed to function as an Obsidian-friendly vault inside the project. `.claude/memory/` exists only for Claude-native bridge guidance and session-specific conventions.

package/template/.codex/README.md

@@ -24,8 +24,7 @@ Project root canonical memory / Obsidian vault:
 ├── wiki/                # Compiled patterns, decisions, blockers, and knowledge
 ├── schema/              # Machine-readable retrieval artifacts
 ├── mcp-server/          # Shared memory MCP server
-├── hooks/               # Optional hook entrypoints
-└── migrate/             # Legacy memory import helpers
+└── hooks/               # Optional hook entrypoints
 ```
 
 The `.memory/` directory is the canonical project memory layer and is designed to function as an Obsidian-friendly vault inside the project.

package/template/.memory/.obsidian/app.json

@@ -7,7 +7,6 @@
   "userIgnoreFilters": [
     "schema/",
     "mcp-server/",
-    "hooks/",
-    "migrate/"
+    "hooks/"
   ]
 }

package/template/.memory/README.md

@@ -7,7 +7,6 @@ Source files for the unified `.memory/` scaffold that `npm run build` copies int
 - `pipeline/progress/` — canonical pipeline progress scaffold shared by all runtimes
 - `mcp-server/` — stdio MCP server exposing memory tools
 - `hooks/` — Claude Code hook entrypoints
-- `migrate/` — legacy memory migration
 - `schema/` — JSON schemas for compiled memory records
 
 ## Extension pattern

package/template/.memory/pipeline/kit-sync.md

@@ -1,9 +1,9 @@
 # Kit Sync State
 
 upstream: https://github.com/RepairYourTech/cfsa-antigravity
-last_synced_commit: f2211e540830f547c1bbd699f3d0f046746e16fe
-last_synced_at: 2026-05-06T14:27:32Z
-kit_version: 5.0.0
+last_synced_commit: ed50ceb28f7722945520e5bda7376fe87040be64
+last_synced_at: 2026-05-06T14:36:37Z
+kit_version: 6.0.0
 installed_runtimes:
   - agents
   - codex

package/template/docs/README.md

@@ -186,24 +186,6 @@ After installing or updating the `.memory` runtime in an existing project:
 3. Verify graph/index artifacts exist under `.memory/schema/` and `.memory/wiki/`.
 4. Open Obsidian at `.memory/`.
 
-If you are upgrading an older project with siloed runtime-local memory, run:
-
-```bash
-npx cfsa-antigravity init --migrate-memory
-```
-
-### Migration conflicts
-
-When migration imports runtime-local knowledge files into `.memory/wiki/knowledge/`, an existing destination with different contents is preserved and a sibling conflict file is written:
-
-```text
-.memory/wiki/knowledge/<name>.conflict-YYYY-MM-DD.md
-```
-
-Resolve conflicts by comparing the imported `.conflict-*.md` file with the canonical target file, merging the content you want to keep, then deleting the conflict file once resolved.
-
-Structured legacy files like old `decisions.md`, `patterns.md`, and `blockers.md` are imported through the raw memory pipeline so compile can preserve them in the unified wiki outputs.
-
 ### Semantic backend
 
 The shared memory system now supports a stronger local semantic mode:

package/template/docs/kit-architecture.md

@@ -45,8 +45,7 @@ The kit ships multiple runtime trees in this repository:
 ├── schema/
 ├── mcp-server/              # shared daemon + per-runtime client entrypoints
 ├── runtime/                 # daemon pid/state files
-├── hooks/
-└── migrate/
+└── hooks/
 ```
 
 `.agents/`, `.codex/`, `.claude/`, and `.factory/` implement the same CFSA pipeline for different agent environments. Codex uses the `.codex/` runtime plus the root `CODEX.md` guidance file. Each runtime owns its own execution assets. Shared project state lives under `.memory/`.

package/template/docs/progress-state-catalog.md

@@ -51,7 +51,6 @@ These paths may appear only as legacy migration source paths.
 
 Old runtime progress paths are intentionally retained in:
 
-- `memory-src/migrate/migrate-legacy.mjs`
 - `docs/kit-architecture.md`
 
 Those references describe migration inputs only. They are not instructions for active workflow state.

package/template/.memory/migrate/README.md

@@ -1,9 +0,0 @@
-# migrate
-
-Legacy memory migration scripts.
-
-## Files
-- `migrate-legacy.mjs` — migrate runtime-local memory into unified `.memory/`
-
-## Conventions
-Migration must be idempotent and preserve provenance.

package/template/.memory/migrate/migrate-legacy.mjs

@@ -1,152 +0,0 @@
-import { existsSync } from "node:fs";
-import { basename, join } from "node:path";
-import { createHash } from "node:crypto";
-import { ensureMemoryScaffold, getFileText, getMemoryRoot, setFileText, slugify } from "../pipeline/utils.mjs";
-import { flushEntry } from "../pipeline/flush.mjs";
-import { compileMemory } from "../pipeline/compile.mjs";
-
-const LEGACY_MAP = [
-  { source: ".claude/memory/patterns.md", target: "wiki/patterns.md" },
-  { source: ".claude/memory/decisions.md", target: "wiki/decisions.md" },
-  { source: ".claude/memory/blockers.md", target: "wiki/blockers.md" },
-  { source: ".claude/progress/memory", targetDir: "wiki/knowledge", runtime: "claude-progress" },
-  { source: ".codex/progress/memory", targetDir: "wiki/knowledge", runtime: "codex-progress" },
-  { source: ".agents/progress/memory", targetDir: "wiki/knowledge", runtime: "agent-progress" },
-  { source: ".factory/memory", targetDir: "wiki/knowledge", runtime: "factory-memory" },
-  { source: ".factory/progress/memory", targetDir: "wiki/knowledge", runtime: "factory-progress" },
-];
-
-function hashText(text) {
-  return createHash("sha256").update(text).digest("hex");
-}
-
-function structuredTypeFromTarget(target) {
-  if (target.includes("patterns.md")) return "pattern";
-  if (target.includes("decisions.md")) return "decision";
-  if (target.includes("blockers.md")) return "blocker";
-  return "knowledge";
-}
-
-function stripMarkdownHeading(text) {
-  return text
-    .split("\n")
-    .filter((line, index) => !(index === 0 && line.startsWith("# ")))
-    .join("\n")
-    .trim();
-}
-
-function importStructuredRecord(mapping, content, memoryRoot, migratedAt) {
-  const normalized = stripMarkdownHeading(content);
-  if (!normalized) {
-    return { status: "skipped", reason: "empty" };
-  }
-
-  const result = flushEntry({
-    type: structuredTypeFromTarget(mapping.target),
-    agent: "migration",
-    source: mapping.source,
-    title: `${structuredTypeFromTarget(mapping.target)} import`,
-    text: normalized,
-    metadata: {
-      migratedAt,
-      legacySource: mapping.source,
-      importMode: "structured-file"
-    },
-    sessionId: "legacy-migration"
-  }, { memoryRoot });
-
-  return { status: "created", destination: result.path };
-}
-
-function writeKnowledgeImport(destination, content, sourceLabel, runtime, migratedAt) {
-  const existingText = getFileText(destination, "");
-  if (existingText.trim() && hashText(existingText) === hashText(content)) {
-    return { status: "skipped", destination, reason: "identical" };
-  }
-
-  if (existingText.trim()) {
-    const conflictDestination = destination.replace(/\.md$/, `.conflict-${migratedAt.slice(0, 10)}.md`);
-    setFileText(conflictDestination, content);
-    return { status: "conflict", destination: conflictDestination, runtime, source: sourceLabel };
-  }
-
-  setFileText(destination, content);
-  return { status: "created", destination, runtime, source: sourceLabel };
-}
-
-export function migrateLegacyMemory(options = {}) {
-  const projectRoot = options.projectRoot ?? process.cwd();
-  const memoryRoot = options.memoryRoot ?? getMemoryRoot(projectRoot);
-  ensureMemoryScaffold(memoryRoot);
-
-  const migrated = [];
-  const skipped = [];
-  const conflicts = [];
-  const migratedAt = new Date().toISOString();
-
-  for (const mapping of LEGACY_MAP) {
-    const absoluteSource = join(projectRoot, mapping.source);
-    if (!existsSync(absoluteSource)) {
-      continue;
-    }
-
-    if (mapping.target) {
-      const content = getFileText(absoluteSource, "");
-      if (!content.trim()) {
-        continue;
-      }
-      const result = importStructuredRecord(mapping, content, memoryRoot, migratedAt);
-      if (result.status === "skipped") {
-        skipped.push({ from: mapping.source, to: mapping.target, reason: result.reason });
-      } else {
-        migrated.push({ from: mapping.source, to: mapping.target, status: result.status });
-      }
-      continue;
-    }
-
-    const entries = ["patterns.md", "decisions.md", "blockers.md"].map((name) => join(absoluteSource, name)).filter((path) => existsSync(path));
-    for (const entryPath of entries) {
-      const text = getFileText(entryPath, "");
-      if (!text.trim()) {
-        continue;
-      }
-      const fileName = `${slugify(mapping.runtime)}-${slugify(basename(entryPath, ".md"))}.md`;
-      const destination = join(memoryRoot, mapping.targetDir, fileName);
-      const sourceLabel = `${mapping.source}/${basename(entryPath)}`;
-      const content = [
-        "---",
-        `source: ${sourceLabel}`,
-        `runtime: ${mapping.runtime}`,
-        `migrated_at: ${migratedAt}`,
-        "---",
-        "",
-        text.trim(),
-        "",
-      ].join("\n");
-      const result = writeKnowledgeImport(destination, content, sourceLabel, mapping.runtime, migratedAt);
-      if (result.status === "skipped") {
-        skipped.push({ from: entryPath, to: destination, reason: result.reason });
-      } else if (result.status === "conflict") {
-        conflicts.push({ from: entryPath, to: result.destination });
-      } else {
-        migrated.push({ from: entryPath, to: destination, status: result.status });
-      }
-    }
-  }
-
-  const compileResult = compileMemory({ projectRoot, memoryRoot });
-  return {
-    ok: true,
-    migratedCount: migrated.length,
-    skippedCount: skipped.length,
-    conflictCount: conflicts.length,
-    migrated,
-    skipped,
-    conflicts,
-    compileResult,
-  };
-}
-
-if (import.meta.url === `file://${process.argv[1]}`) {
-  console.log(JSON.stringify(migrateLegacyMemory(), null, 2));
-}