cfsa-antigravity 2.19.3 → 3.0.0

package/README.md

@@ -10,25 +10,68 @@ A pipeline that turns a raw idea into exhaustively specified, test-driven, produ
 npx cfsa-antigravity init
 ```
 
-This installs the `.agent/` folder, `docs/` structure, and agent config files into your project.
+This launches an interactive picker where you select which agent runtimes to install. Pick one or many -- each runtime is fully standalone.
+
+For CI/CD or non-interactive use, specify runtimes directly:
+
+```bash
+npx cfsa-antigravity init --agent claude,factory
+```
 
 ## CLI
 
 | Command | Description |
 |---------|-------------|
-| `cfsa-antigravity init` | Install the pipeline into your project |
-| `cfsa-antigravity status` | Check installation + unfilled placeholders |
+| `cfsa-antigravity init` | Interactive multi-select runtime installer |
+| `cfsa-antigravity init --agent claude,factory` | Non-interactive install of specific runtimes |
+| `cfsa-antigravity status` | Check all installed runtimes + unfilled placeholders |
 | `cfsa-antigravity init --force` | Overwrite existing installation |
 | `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
+
+Runtimes are auto-detected from the template. Currently shipped:
+
+- **Antigravity** (`.agent/`) -- Antigravity, Cursor, Codex, Gemini CLI
+- **Claude Code** (`.claude/`) -- Standalone Claude Code runtime
+- **Factory Droid** (`.factory/`) -- Standalone Factory Droid runtime
+
+Each runtime is fully standalone with no cross-references. Install any combination side-by-side.
+
+## Unified Project Memory
 
-### ⚠️ Important Note on `.gitignore`
-If you are using AI-powered editors like **Cursor** or **Windsurf**, adding the `.agent/` folder to your `.gitignore` may prevent the IDE from indexing the workflows. This results in slash commands (like `/ideate`, `/create-prd`) not appearing in the chat suggestion dropdown.
+Every install now scaffolds a shared `.memory/` root at the project level. It is intended to be an Obsidian-friendly vault inside the project, not just an internal data folder.
+
+```text
+.memory/
+├── .obsidian/   # vault config so the project memory opens cleanly in Obsidian
+├── raw/         # append-only captures from hooks, sessions, and imports
+├── wiki/        # human-readable compiled memory plus graph-friendly mirrors of docs/plans
+├── 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
+```
+
+The installer also creates `.mcp.json` so supported runtimes can talk to the shared project-local memory daemon through their own MCP clients, and it merges Claude hook entries into `.claude/settings.json` for automatic capture and daemon startup. The daemon writes runtime state into `.memory/runtime/`, and the semantic index writes retrieval artifacts into `.memory/schema/semantic-index.json` plus `.memory/schema/semantic-manifest.json`.
+
+This replaces fragmented runtime-local memory as the canonical project memory layer. Runtime-local memory files remain legacy inputs for migration.
+
+If you are using an editor that indexes agent files for slash commands, do not hide the runtime directory you actually installed.
 
 **Recommended Solution:**
-To keep the `.agent/` folder local (not tracked by Git) while maintaining AI functionality:
-1. Ensure `.agent/` is **NOT** in your project's `.gitignore`.
-2. Instead, add it to your local exclude file: `.git/info/exclude`
+Keep the installed runtime directory out of shared `.gitignore` rules when your tool needs to index it. Prefer `.git/info/exclude` for local-only exclusions.
+
+Examples:
+1. Antigravity install → keep `.agent/` out of `.gitignore`
+2. Codex install → keep `.agent/` out of `.gitignore`
+3. Claude install → keep `.claude/` out of `.gitignore`
+4. Factory install → keep `.factory/` out of `.gitignore`
+5. Use `.git/info/exclude` for local exclusions instead of changing shared ignore rules
    
 ## Get Started
 
@@ -49,9 +92,22 @@ The kit evolves independently of your project. To pull improvements into an exis
 This performs a **semantic merge** — it applies new workflows, skills, and rules from the upstream kit while preserving your project-specific values (tech stack, validation commands, filled placeholders). It will never overwrite your project decisions.
 
 - First sync does a full comparison; subsequent syncs are incremental (commit-scoped)
-- Tracks sync state in `.agent/kit-sync.md` so it knows what changed since last update
+- Tracks sync state in the installed agent runtime (`.agent/kit-sync.md`, `.claude/kit-sync.md`, or `.factory/kit-sync.md`) so it knows what changed since last update
 - Flags any structural migrations needed (e.g., ideation format changes)
 
+## What Init Adds
+
+A fresh `init` now installs:
+- your selected runtime directories (`.agent/`, `.claude/`, `.factory/`)
+- `docs/`
+- shared `.memory/`
+- `.mcp.json` with the `cfsa-memory` server registration
+- merged Claude hooks in `.claude/settings.json` when Claude is installed
+
+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 |