flurryx-code-memory 0.5.1__tar.gz → 0.6.0__tar.gz

{flurryx_code_memory-0.5.1 → flurryx_code_memory-0.6.0}/CHANGELOG.md

@@ -8,6 +8,125 @@ when the repo grows.
 This file complements `git log`: commits explain mechanics, this file
 explains intent.
 
+## [0.6.0] — 2026-06-04
+
+Release theme: **Dart joins the graph, and `this.field.method()` resolves
+across languages**. The extractor gains a ninth language and the
+receiver-type tier — previously TypeScript-only — now narrows method
+calls in C#, PHP, and Dart too.
+
+### Added — Dart / Flutter language support
+
+**What:** `.dart` files are now parsed. Symbols cover classes, mixins,
+enums, extensions, typedefs, top-level functions, methods,
+getters/setters, and constructors (with parameter arity); imports and
+re-exports surface their URI (`package:…`, `dart:…`, relative); calls and
+type references (inheritance, field/parameter/return types, generic
+arguments) are extracted. Dart's grammar differs structurally from the
+other languages — function names follow the return type inside
+`function_signature`, calls are a `selector` + `argument_part` chain
+rather than a single call-expression node, and import URIs are nested
+under `configurable_uri > uri` — so each needed dedicated handling.
+Node-type names that collide with TypeScript (`function_signature`,
+`declaration`, …) are gated on `lang == "dart"` so TS output is
+unchanged.
+
+**Reason:** Flutter/Dart codebases were a blind spot — every `.dart`
+file was skipped at `lang_for`, so half of a mobile + backend stack had
+no graph topology, leaving retrieval to dense vectors alone.
+
+### Added — Cross-language receiver-type inference (C#, PHP, Dart)
+
+**What:** the `this.<field>.<method>()` narrowing that let the resolver
+disambiguate a call against the methods of the field's declared type now
+works beyond TypeScript. The class-scope stack is language-aware: C#
+reads fields, properties, and C# 12 primary-constructor parameters and
+resolves both `_repo.Get()` and `this.Bar.Save()`; PHP reads properties
+and PHP 8 constructor promotion and resolves `$this->repo->m()`; Dart
+reads typed fields and resolves `repo.m()` / `this.repo.m()`. A shared
+`_bare_type_name` reduces qualified / generic / nullable types to the
+bare identifier the resolver matches on, dropping primitives.
+
+**Reason:** the resolver's receiver tier is language-agnostic — it
+matches a bare type name against files defining that symbol — but the
+extractor only ever emitted `receiver_type` for TS. On C#/PHP/Dart, a
+method call like `byId` collapsed to a bare identifier that the resolver
+could never narrow against the dozens of same-named methods elsewhere in
+the codebase. Emitting the inferred receiver type fixes that with no
+resolver changes.
+
+## [0.5.3] — 2026-06-04
+
+Release theme: **git operations never block on credentials**. The
+snapshot store talked to `origin` with plain `git fetch` / `git push`
+and nothing to suppress interactive auth. On any HTTPS remote without
+cached credentials that froze the MCP server at boot and re-prompted on
+every `code-memory status` and watcher tick.
+
+### Fixed — Interactive git credential prompts froze the MCP server
+
+**What:** every best-effort / read git call in `SnapshotStore` (`fetch`,
+listing, the snapshot existence check) now runs with
+`GIT_TERMINAL_PROMPT=0`, `GIT_SSH_COMMAND=ssh -oBatchMode=yes`, and an
+empty `-c credential.helper=` so it fails fast instead of blocking. Only
+the explicit publish path (`push` during `snapshot publish` / `gc`) opts
+back into credentials via `allow_credentials=True`, so opted-in remotes
+still authenticate.
+
+**Reason:** `GIT_TERMINAL_PROMPT=0` alone was not enough — a configured
+credential helper such as Git Credential Manager is a separate program
+git still launches, and it pops its own dialog. The MCP bootstrap runs a
+synchronous `sync_repo(trigger="mcp-boot")` with `fetch=True`; on an
+auth-required remote that `git fetch` hung waiting for a password the
+stdio server could never supply, so OpenCode reported the server as not
+running. The watcher's per-quiet-period sync and `code-memory status`
+hit the same wall. Resetting the helper list makes git return in ~0.1s
+(no remote snapshots) instead of waiting on a human.
+
+## [0.5.2] — 2026-05-30
+
+Release theme: **the watcher stops leaking**. A diagnosis of runaway RAM
+turned up dozens of orphaned `code-memory watch` daemons — one permanent
+launchd agent per directory any MCP server had ever booted in, including
+throwaway per-session dirs. This release stops the bleed and self-heals
+the cruft. Also lands semantic dedupe for near-duplicate user claims.
+
+### Fixed — Unbounded launchd watcher accumulation
+
+**What:** `ensure_autostart()` no longer registers a persistent OS agent
+for ephemeral / per-session directories (`~/.claude/homunculus/*`,
+`.cursor/worktrees/*`, `plugins/cache/*`); the session-scoped in-process
+watcher still covers them. `LaunchdAdapter.prune_stale()` (run on every
+MCP bootstrap) boots out and removes agents whose `WorkingDirectory` is
+gone or ephemeral.
+
+**Reason:** each MCP boot registered a `KeepAlive` + `RunAtLoad` agent for
+its cwd. Ephemeral session dirs got permanent watchers that survived kill
+(launchd relaunched them) and reboot, piling up dozens of daemons and the
+RAM/CPU they pin. `prune_stale` is launchd-only for now; systemd/schtasks
+GC is a follow-up.
+
+### Fixed — Graceful watcher teardown on MCP shutdown
+
+**What:** the MCP server registers `atexit` + `SIGTERM` handlers that call
+`Watcher.stop()`.
+
+**Reason:** the in-process watcher ran as a daemon thread with no clean
+stop, so an in-flight debounced sync was dropped and the watchdog Observer
+never joined cleanly on exit.
+
+### Added — Semantic dedupe of near-duplicate claims
+
+**What:** `ClaimsIndexer` collapses a new claim into the closest open claim
+when cosine similarity is `>= CLAIMS_SEMANTIC_DEDUP_THRESHOLD` (default
+0.90), ahead of the SQL write.
+
+**Reason:** exact (subject, predicate, object) dedupe missed paraphrases
+("project uses flurryx" / "project depends-on flurryx"), so semantically
+identical claims were stored three times. Best-effort — embedder/backend
+errors fall through to the existing SQL-level dedupe; set `>= 1.0` to
+disable.
+
 ## [0.3.0] — 2026-05-26
 
 Release theme: **the claim loop closes**. v0.2.0 shipped the storage

{flurryx_code_memory-0.5.1 → flurryx_code_memory-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flurryx-code-memory
-Version: 0.5.1
+Version: 0.6.0
 Summary: Local lightweight memory layer for coding agents: FalkorDB + Qdrant + Ollama (BGE-M3) + tree-sitter
 Requires-Python: >=3.11
 Requires-Dist: anyio>=4.4

{flurryx_code_memory-0.5.1 → flurryx_code_memory-0.6.0}/README.md

@@ -199,6 +199,10 @@ claude mcp add code-memory --scope user \
 # 5. OpenCode plugin
 npm i -g code-memory-opencode
 code-memory-opencode-install
+
+# 6. Cursor plugin (requires repo cloned; package release pending)
+git clone https://github.com/fmflurry/code-memory ~/.code-memory/repo
+~/.code-memory/repo/plugins/cursor/install.sh
 ```
 
 </details>
@@ -206,7 +210,7 @@ code-memory-opencode-install
 <details>
 <summary><strong>MCP-only (lightest, ~10 s)</strong></summary>
 
-Just the Claude Code MCP server — no auto-retrieve / auto-record hooks, no Docker, no Ollama. Useful when FalkorDB + Qdrant already run elsewhere, or you only want the `codememory_*` tools by hand.
+Just the Claude Code MCP server — no auto-learn / auto-record hooks, no Docker, no Ollama. Useful when FalkorDB + Qdrant already run elsewhere, or you only want the `codememory_*` tools by hand.
 
 ```bash
 claude mcp add code-memory \
@@ -1341,45 +1345,55 @@ uvx --from git+https://github.com/dev/code-memory code-memory-mcp
 ### Harness plugins
 
 The MCP server above exposes manual tools. The **harness plugins** make
-the same backend **ambient** — auto-retrieving a Context Pack on every
-substantive user prompt, auto-reingesting on every `Write` / `Edit`, and
-recording sessions as episodes when the agent stops. The plugins are
-optional and live alongside the MCP server; install both for the best
-experience.
-
-| Plugin                                          | Hook model                                                                    |
-| ----------------------------------------------- | ----------------------------------------------------------------------------- |
-| [`plugins/opencode`](plugins/opencode/README.md)    | Bun-loaded TypeScript module; uses `chat.message`, `experimental.chat.system.transform`, `tool.execute.after`, `session.idle`. |
-| [`plugins/claude-code`](plugins/claude-code/README.md) | Plain Node scripts wired via `hooks.json`; uses `SessionStart`, `UserPromptSubmit`, `PostToolUse` (`Write`/`Edit`/`MultiEdit`), `Stop`. |
-
-Both plugins:
-
-- Detect substantive code intent (trivial follow-ups skip retrieval).
-- Dedup the same query within 60 s.
+the same backend **ambient** — steering the agent toward the index
+before grep / read / shell, auto-reingesting on every `Write` / `Edit`,
+recording sessions as episodes when the agent stops, and nudging on
+durable user assertions. The plugins are optional and live alongside
+the MCP server; install whichever your agent harness uses.
+
+| Plugin                                                 | Hook model                                                                                                                                                                                              |
+| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [`plugins/opencode`](plugins/opencode/README.md)       | Bun-loaded TypeScript module; uses `chat.message`, `experimental.chat.system.transform`, `tool.execute.after`, `session.idle`.                                                                          |
+| [`plugins/claude-code`](plugins/claude-code/README.md) | Plain Node scripts wired via `hooks.json`; uses `SessionStart`, `UserPromptSubmit`, `PostToolUse` (`Write`/`Edit`/`MultiEdit`), `Stop`.                                                                  |
+| [`plugins/cursor`](plugins/cursor/README.md)           | Plain Node scripts wired via `hooks.json`; uses `sessionStart`, `beforeSubmitPrompt`, `preToolUse`, `beforeMCPExecution`, `postToolUse`, `afterFileEdit`, `preCompact`, `stop`, `sessionEnd`. |
+
+All three plugins:
+
+- Steer the agent toward `codememory_retrieve` via a one-shot gate
+  nudge before grep / read / shell (never blocks).
 - Debounce the cross-file resolver (~1.5 s after the last write) so a
   20-file refactor collapses to exactly one resolver run.
 - Run a one-shot git-delta ingest at session start to catch
   out-of-band edits (vim, IDE, `git pull`).
 - Record the session as an episode on idle / stop with the first user
-  message + `git diff` as the patch.
+  message + `git diff` as the patch. The Cursor plugin additionally
+  records on `preCompact`, catching state before context compaction.
 - **Detect durable user assertions on every prompt** — preferences
   (`I love X`), decisions (`we use X`), rejections (`don't use Y`),
   ownership (`Alice owns billing`), location (`auth lives at apps/api`)
-  — and inject an in-system-prompt nudge that demands the agent call
+  — and inject an in-prompt nudge that demands the agent call
   `codememory_assert_claim` *before* answering. The nudge is
   polarity-flipped: asserting is the default, skipping requires a
   one-line written justification. See
-  [`plugins/claude-code/scripts/lib/claim-intent.js`](plugins/claude-code/scripts/lib/claim-intent.js)
-  and [`plugins/opencode/src/code-memory-lib/claim-intent.ts`](plugins/opencode/src/code-memory-lib/claim-intent.ts)
-  for the regex patterns and nudge template — they are kept in lockstep.
+  [`plugins/claude-code/scripts/lib/claim-intent.js`](plugins/claude-code/scripts/lib/claim-intent.js),
+  [`plugins/opencode/src/code-memory-lib/claim-intent.ts`](plugins/opencode/src/code-memory-lib/claim-intent.ts),
+  and [`plugins/cursor/scripts/lib/claim-intent.js`](plugins/cursor/scripts/lib/claim-intent.js)
+  for the regex patterns and nudge template — kept in lockstep.
+
+> Cursor caveat: `beforeSubmitPrompt` cannot inject context, so the
+> Cursor plugin stashes the claim nudge on `beforeSubmitPrompt` and
+> drains it on the first `postToolUse` of the turn. If the reply uses
+> no tools, the nudge does not surface for that turn — uncommon in
+> substantive sessions.
 
 Install via the top-level installer:
 
 ```bash
-./scripts/install.sh --plugins=all                       # both, global
-./scripts/install.sh --plugins=claudecode                # Claude Code only
-./scripts/install.sh --plugins=opencode,claudecode       # both, csv form
-./scripts/install.sh --plugins=all --plugins-scope=project   # ./.opencode and ./.claude
+./scripts/install.sh --plugins=all                            # all three, global
+./scripts/install.sh --plugins=claudecode                     # Claude Code only
+./scripts/install.sh --plugins=cursor                         # Cursor only
+./scripts/install.sh --plugins=opencode,claudecode,cursor     # csv form
+./scripts/install.sh --plugins=all --plugins-scope=project    # ./.opencode, ./.claude, ./.cursor
 ```
 
 Or install a single plugin directly without re-running the backend
@@ -1390,6 +1404,8 @@ installer:
 ./plugins/claude-code/install.sh     # registers a local Claude Code
                                      # marketplace at the repo root and runs
                                      # `claude plugin install code-memory@code-memory`
+./plugins/cursor/install.sh          # ~/.cursor/hooks.json + mcp.json
+                                     # (add --scope project for ./.cursor/)
 ```
 
 > **Claude Code only:** symlinking the plugin into `~/.claude/plugins/`
@@ -1744,7 +1760,7 @@ See `CHANGELOG.md` for the design rationale.
 - [x] `.gitignore`-aware walker that skips minified bundles + generated junk
 - [x] Resolved call / import edges (bind `CALLS` / `IMPORTS` to real nodes)
 - [x] Lightweight rerank (entrypoint / generated boost, idle-episode filter)
-- [x] Harness plugins for OpenCode and Claude Code (auto-retrieve + auto-learn)
+- [x] Harness plugins for OpenCode and Claude Code (steering + auto-learn)
 - [x] `code-memory reset` CLI + auto-purge on `ingest --full`
 - [x] File-watcher daemon for live re-ingest (cross-platform via `watchdog`)
 - [x] Team-shared snapshots (orphan branch, content-addressed, model-aware verify)
@@ -1756,6 +1772,7 @@ See `CHANGELOG.md` for the design rationale.
 - [x] `code-memory vacuum --before <sha>` / `--older-than` / `--all` (tombstone GC)
 - [x] MCP tools: `codememory_drift`, `codememory_at_sha`, `codememory_callers_at_sha`
 - [x] .NET ecosystem (C#, Razor, VB.NET, F#)
+- [x] Dart / Flutter (classes, mixins, enums, extensions, typedefs, imports/exports, calls, type refs)
 - [ ] More languages (Rust, Go, Java)
 - [ ] Cursor hook recipe
 - [ ] PyPI release (drops the `--from git+…` from the `uvx` install)

flurryx_code_memory-0.6.0/install.ps1

@@ -0,0 +1,369 @@
+<#
+.SYNOPSIS
+  code-memory zero-clone installer (Windows PowerShell).
+
+.DESCRIPTION
+  No `git clone` required. Installs the `code-memory` CLI via `uv`, drops
+  infra files into $HOME\.code-memory\, waits for Docker + Ollama,
+  pulls the bge-m3 embedding model (and optionally gemma2:9b for claim
+  extraction), and wires up the Claude Code plugin + MCP server.
+  Optionally installs the OpenCode plugin from npm.
+
+  Interactive by default. Pass -Yes to accept defaults; pass any -No*
+  switch to skip a step; pass -NonInteractive to refuse all prompts.
+
+  One-liner (interactive):
+    irm https://raw.githubusercontent.com/fmflurry/code-memory/main/install.ps1 | iex
+
+  Contributors hacking on the repo should still `git clone` and run
+  `scripts/install.ps1` instead.
+
+.PARAMETER Yes
+  Accept default for every prompt (Claude=Y, OpenCode=N, claims=N).
+
+.PARAMETER NonInteractive
+  Refuse all prompts; use defaults (same as -Yes but without confirmation).
+
+.PARAMETER NoDocker
+  Skip starting FalkorDB + Qdrant via docker compose.
+
+.PARAMETER NoOllama
+  Skip pulling bge-m3.
+
+.PARAMETER NoClaude
+  Skip Claude Code marketplace + plugin registration.
+
+.PARAMETER NoOpencode
+  Skip OpenCode plugin install from npm.
+
+.PARAMETER NoMcp
+  Skip MCP server registration with Claude Code.
+
+.PARAMETER NoClaims
+  Skip pulling gemma2:9b for claim extraction.
+
+.PARAMETER WithClaims
+  Force-pull gemma2:9b without prompting.
+
+.EXAMPLE
+  irm https://raw.githubusercontent.com/fmflurry/code-memory/main/install.ps1 | iex
+
+.EXAMPLE
+  # Download then run with flags:
+  iwr https://raw.githubusercontent.com/fmflurry/code-memory/main/install.ps1 -OutFile install.ps1
+  ./install.ps1 -NoOpencode -NoOllama
+#>
+
+[CmdletBinding()]
+param(
+  [switch]$Yes,
+  [switch]$NonInteractive,
+  [switch]$NoDocker,
+  [switch]$NoOllama,
+  [switch]$NoClaude,
+  [switch]$NoOpencode,
+  [switch]$NoMcp,
+  [switch]$NoClaims,
+  [switch]$WithClaims
+)
+
+$ErrorActionPreference = 'Stop'
+
+$RepoUrl  = if ($env:CODEMEMORY_REPO_URL)  { $env:CODEMEMORY_REPO_URL }  else { 'https://github.com/fmflurry/code-memory' }
+$RawUrl   = if ($env:CODEMEMORY_RAW_URL)   { $env:CODEMEMORY_RAW_URL }   else { 'https://raw.githubusercontent.com/fmflurry/code-memory/main' }
+$HomeDir  = if ($env:CODEMEMORY_HOME)      { $env:CODEMEMORY_HOME }      else { Join-Path $HOME '.code-memory' }
+$NpmPkg   = if ($env:CODEMEMORY_OPENCODE_PKG) { $env:CODEMEMORY_OPENCODE_PKG } else { 'code-memory-opencode' }
+
+function Step($msg) { Write-Host "`n==> $msg" -ForegroundColor Cyan }
+function Ok($msg)   { Write-Host "[ok]   $msg" -ForegroundColor Green }
+function Warn($msg) { Write-Host "[warn] $msg" -ForegroundColor Yellow }
+function Err($msg)  { Write-Host "[err]  $msg" -ForegroundColor Red }
+function Dim($msg)  { Write-Host "  $msg" -ForegroundColor DarkGray }
+function Test-Cmd($name) { return [bool](Get-Command $name -ErrorAction SilentlyContinue) }
+
+function Test-Interactive() {
+  if ($NonInteractive) { return $false }
+  # Read-Host targets console host. When invoked via `irm | iex`, the
+  # console host is still attached, so prompts work even though stdin is
+  # the script body.
+  try {
+    return [Environment]::UserInteractive -and ($Host.Name -ne 'Default Host')
+  } catch { return $false }
+}
+
+# Returns $true for yes, $false for no.
+function Ask-YesNo([string]$Prompt, [string]$Default = 'Y') {
+  $hint = if ($Default -match '^[Yy]') { '[Y/n]' } else { '[y/N]' }
+  $defaultYes = $Default -match '^[Yy]'
+  if ($Yes -or -not (Test-Interactive)) { return $defaultYes }
+  Write-Host "? $Prompt $hint " -ForegroundColor Yellow -NoNewline
+  $ans = Read-Host
+  if ([string]::IsNullOrWhiteSpace($ans)) { return $defaultYes }
+  return ($ans -match '^[Yy]')
+}
+
+# Waits until a CLI is on PATH. Returns $true if present, $false if user skipped.
+function Wait-ForCmd([string]$Cmd, [string]$Label, [string]$Url) {
+  while (-not (Test-Cmd $Cmd)) {
+    Warn "$Label not found."
+    Dim "Install from: $Url"
+    if (-not (Test-Interactive)) {
+      Warn "non-interactive: skipping $Label"
+      return $false
+    }
+    Write-Host "? Press Enter once installed (or type 'skip' to skip): " -ForegroundColor Yellow -NoNewline
+    $ans = Read-Host
+    if ($ans -eq 'skip') { return $false }
+    # Refresh PATH from machine + user so newly installed tools show up
+    # without restarting the shell.
+    $env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine') + ';' + `
+                [System.Environment]::GetEnvironmentVariable('Path','User')
+  }
+  return $true
+}
+
+# ---------- 1. uv ----------
+Step "Ensuring uv is installed"
+if (Test-Cmd 'uv') {
+  Ok "uv $(uv --version 2>$null)"
+} else {
+  # Run uv installer in a child powershell so its `exit` cannot tear down
+  # the parent session (especially when this script itself was launched via
+  # `irm | iex`).
+  $uvInstaller = Join-Path ([System.IO.Path]::GetTempPath()) ("uv-install-{0}.ps1" -f ([guid]::NewGuid()))
+  $prevEAP = $ErrorActionPreference
+  $ErrorActionPreference = 'Continue'
+  try {
+    Invoke-WebRequest -Uri 'https://astral.sh/uv/install.ps1' -OutFile $uvInstaller -UseBasicParsing
+    $psExe = (Get-Process -Id $PID).Path
+    if (-not $psExe) { $psExe = 'powershell.exe' }
+    & $psExe -NoProfile -ExecutionPolicy Bypass -File $uvInstaller
+    $uvExit = $LASTEXITCODE
+    if ($uvExit -ne 0) { throw "uv installer exited with code $uvExit" }
+  } catch {
+    Err "Failed to install uv: $($_.Exception.Message)"
+    Err "Install manually:  winget install --id=astral-sh.uv -e   then re-run."
+    exit 3
+  } finally {
+    Remove-Item $uvInstaller -ErrorAction SilentlyContinue
+    $ErrorActionPreference = $prevEAP
+  }
+  $env:Path = "$HOME\.local\bin;$HOME\.cargo\bin;$env:Path"
+  if (-not (Test-Cmd 'uv')) {
+    Err "uv installed but not on PATH; re-open shell and re-run."
+    exit 3
+  }
+  Ok "uv installed"
+}
+
+# ---------- 2. code-memory CLI ----------
+Step "Installing code-memory CLI"
+& uv tool install --force --from "git+$RepoUrl" flurryx-code-memory
+if ($LASTEXITCODE -ne 0) { Err "uv tool install failed"; exit 1 }
+$cliPath = (Get-Command code-memory -ErrorAction SilentlyContinue)
+Ok "code-memory CLI: $($cliPath.Source)"
+
+# ---------- 3. side files ----------
+Step "Writing infra files to $HomeDir"
+New-Item -ItemType Directory -Force -Path (Join-Path $HomeDir 'docker') | Out-Null
+Invoke-WebRequest -Uri "$RawUrl/docker/docker-compose.yml" -OutFile (Join-Path $HomeDir 'docker/docker-compose.yml') -UseBasicParsing
+Ok "wrote $HomeDir\docker\docker-compose.yml"
+$envFile = Join-Path $HomeDir '.env'
+if (-not (Test-Path $envFile)) {
+  Invoke-WebRequest -Uri "$RawUrl/.env.example" -OutFile $envFile -UseBasicParsing
+  Ok "wrote $envFile (from .env.example)"
+} else {
+  Ok ".env already present (not overwritten)"
+}
+
+# ---------- 4. docker ----------
+$doDocker = -not $NoDocker
+if ($doDocker -and -not $Yes -and (Test-Interactive)) {
+  $doDocker = Ask-YesNo "Start FalkorDB + Qdrant via Docker?" "Y"
+}
+if ($doDocker) {
+  Step "Starting FalkorDB + Qdrant"
+  if (Wait-ForCmd 'docker' 'Docker Desktop' 'https://www.docker.com/products/docker-desktop') {
+    # ensure daemon up
+    & docker info *>$null
+    if ($LASTEXITCODE -ne 0) {
+      Warn "Docker CLI present but daemon not running. Start Docker Desktop."
+      if (Test-Interactive) {
+        Write-Host "? Press Enter once the daemon is up (or 'skip'): " -ForegroundColor Yellow -NoNewline
+        $ans = Read-Host
+        if ($ans -eq 'skip') { $doDocker = $false }
+      }
+    }
+    if ($doDocker) {
+      & docker compose -f (Join-Path $HomeDir 'docker/docker-compose.yml') --project-directory $HomeDir up -d
+      if ($LASTEXITCODE -ne 0) {
+        Warn "docker compose up failed"
+      } else {
+        Ok "containers up"
+        Dim "FalkorDB browser: http://localhost:3000"
+        Dim "Qdrant dashboard: http://localhost:6333/dashboard"
+      }
+    }
+  } else {
+    Warn "docker step skipped"
+  }
+} else {
+  Warn "docker step skipped"
+}
+
+# ---------- 5. ollama ----------
+$doOllama = -not $NoOllama
+if ($doOllama -and -not $Yes -and (Test-Interactive)) {
+  $doOllama = Ask-YesNo "Pull embedding model via Ollama?" "Y"
+}
+if ($doOllama) {
+  Step "Embedding model (bge-m3)"
+  if (Wait-ForCmd 'ollama' 'Ollama' 'https://ollama.com/download/windows') {
+    & ollama list 2>$null | Out-Null
+    if ($LASTEXITCODE -ne 0) {
+      try { Start-Process -FilePath 'ollama' -ArgumentList 'serve' -WindowStyle Hidden -ErrorAction Stop } catch {}
+      for ($i = 0; $i -lt 30; $i++) {
+        Start-Sleep -Seconds 1
+        & ollama list 2>$null | Out-Null
+        if ($LASTEXITCODE -eq 0) { break }
+      }
+    }
+    $models = (& ollama list 2>$null) -join "`n"
+    if ($models -match '(?m)^bge-m3(\s|:)') {
+      Ok "bge-m3 already present"
+    } else {
+      & ollama pull bge-m3
+      if ($LASTEXITCODE -eq 0) { Ok "bge-m3 pulled" } else { Warn "ollama pull bge-m3 returned exit $LASTEXITCODE" }
+    }
+
+    # optional gemma2:9b for claim extraction
+    $doClaims = $false
+    if ($WithClaims) {
+      $doClaims = $true
+    } elseif (-not $NoClaims) {
+      $doClaims = Ask-YesNo "Also pull gemma2:9b for user-claim extraction (~5.4 GB)?" "N"
+    }
+    if ($doClaims) {
+      $models2 = (& ollama list 2>$null) -join "`n"
+      if ($models2 -match '(?m)^gemma2:9b\s') {
+        Ok "gemma2:9b already present"
+      } else {
+        & ollama pull gemma2:9b
+        if ($LASTEXITCODE -eq 0) { Ok "gemma2:9b pulled" } else { Warn "ollama pull gemma2:9b returned exit $LASTEXITCODE" }
+      }
+    }
+  } else {
+    Warn "ollama step skipped"
+  }
+} else {
+  Warn "ollama step skipped"
+}
+
+# ---------- 6. Claude Code ----------
+$doClaude = -not $NoClaude
+if ($doClaude -and -not $Yes -and (Test-Interactive)) {
+  $doClaude = Ask-YesNo "Install Claude Code plugin + MCP?" "Y"
+}
+if ($doClaude) {
+  if (-not (Test-Cmd 'claude')) {
+    Step "Installing Claude Code CLI"
+    $claudeInstaller = Join-Path ([System.IO.Path]::GetTempPath()) ("claude-install-{0}.ps1" -f ([guid]::NewGuid()))
+    $prevEAP = $ErrorActionPreference
+    $ErrorActionPreference = 'Continue'
+    try {
+      Invoke-WebRequest -Uri 'https://claude.ai/install.ps1' -OutFile $claudeInstaller -UseBasicParsing
+      $psExe = (Get-Process -Id $PID).Path
+      if (-not $psExe) { $psExe = 'powershell.exe' }
+      & $psExe -NoProfile -ExecutionPolicy Bypass -File $claudeInstaller
+      if ($LASTEXITCODE -ne 0) { Warn "claude installer exited with code $LASTEXITCODE" }
+    } catch {
+      Warn "claude install failed: $($_.Exception.Message)"
+    } finally {
+      Remove-Item $claudeInstaller -ErrorAction SilentlyContinue
+      $ErrorActionPreference = $prevEAP
+    }
+    # Refresh PATH from machine + user so the freshly installed claude shim is visible.
+    $env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine') + ';' + `
+                [System.Environment]::GetEnvironmentVariable('Path','User') + ';' + `
+                "$HOME\.local\bin"
+  }
+  if (-not (Test-Cmd 'claude')) {
+    Warn "claude CLI still not found after install attempt — skipping Claude Code plugin"
+    Dim "Install manually: https://docs.anthropic.com/claude/docs/claude-code"
+  } else {
+    Step "Registering Claude Code plugin + MCP"
+    & claude plugin marketplace add $RepoUrl 2>$null
+    if ($LASTEXITCODE -ne 0) { Warn "marketplace add failed (may already be registered)" }
+
+    $pluginList = & claude plugin list 2>$null
+    if ($pluginList -match 'code-memory@code-memory') {
+      Ok "plugin already installed"
+    } else {
+      & claude plugin install code-memory@code-memory --scope user
+      if ($LASTEXITCODE -eq 0) { Ok "plugin installed" } else { Warn "plugin install failed" }
+    }
+
+    if (-not $NoMcp) {
+      $mcpList = & claude mcp list 2>$null
+      if ($mcpList -match '(?m)^\s*code-memory\s') {
+        Ok "MCP already registered"
+      } else {
+        & claude mcp add code-memory `
+          --scope user `
+          -e CODE_MEMORY_PROJECT=auto `
+          -- uvx --from "git+$RepoUrl" code-memory-mcp
+        if ($LASTEXITCODE -eq 0) { Ok "MCP registered (restart Claude Code to pick it up)" }
+        else { Warn "claude mcp add failed; see README §MCP server" }
+      }
+    }
+  }
+} else {
+  Warn "Claude Code step skipped"
+}
+
+# ---------- 7. OpenCode ----------
+$doOpencode = -not $NoOpencode -and ($Yes -or $false)
+# OpenCode defaults to N — only prompt if not explicitly skipped.
+if (-not $NoOpencode -and -not $Yes -and (Test-Interactive)) {
+  $doOpencode = Ask-YesNo "Install OpenCode plugin (npm global)?" "N"
+} elseif ($Yes) {
+  $doOpencode = $false  # -Yes accepts the default (N) for OpenCode
+}
+if ($doOpencode) {
+  Step "Installing OpenCode plugin"
+  if (-not (Test-Cmd 'npm')) {
+    Warn "npm not found — skipping. Install Node.js, then: npm i -g $NpmPkg ; code-memory-opencode-install"
+  } else {
+    & npm i -g $NpmPkg
+    if ($LASTEXITCODE -ne 0) {
+      Warn "npm install failed"
+    } elseif (Test-Cmd 'code-memory-opencode-install') {
+      & code-memory-opencode-install
+    } else {
+      Warn "$NpmPkg installed but code-memory-opencode-install not on PATH"
+      Warn "Add npm global bin to PATH (npm bin -g) and re-run: code-memory-opencode-install"
+    }
+  }
+} else {
+  Warn "OpenCode step skipped"
+}
+
+# ---------- done ----------
+Step "Done"
+@"
+
+  Side files:    $HomeDir\
+  CLI:           $(if ($cliPath) { $cliPath.Source } else { 'code-memory (not on PATH)' })
+
+  Ingest a repo:
+    code-memory ingest C:\path\to\repo
+
+  Query:
+    code-memory retrieve "where is the auth middleware?"
+
+  Browse:
+    FalkorDB  http://localhost:3000
+    Qdrant    http://localhost:6333/dashboard
+
+  Edit defaults: $HomeDir\.env
+"@ | Write-Host