@ijfw/install 1.5.6 → 1.6.1

package/docs/GUIDE.md

@@ -232,11 +232,30 @@ Every command ships in three forms: a shell command, a Claude Code slash command
 | Command | Purpose |
 |---------|---------|
 | `ijfw memory checkpoint "<text>"` | Snapshot a decision, pattern, or note to local memory. |
+| `ijfw checkpoint "<text>"` | Top-level shortcut for `ijfw memory checkpoint`. |
 | `ijfw memory search "<query>"` | BM25 ranked search over local memory. Add `--scope all` to search every registered IJFW project. |
 | `ijfw import claude-mem` | Absorb existing claude-mem SQLite memory into IJFW markdown. |
 | `ijfw import claude-mem --all` | Discover projects automatically, import in bulk. |
 | `ijfw import claude-mem --dry-run` | Show what would happen first. |
 
+### Personalize (profile-bus learning)
+
+IJFW can learn your low-sensitivity interaction *style* (verbosity, formality,
+code-vs-prose) locally and — only if you opt in — include a short brief in
+prompts so agents match it. Capture is always local and never includes raw
+text. Injection is **off until you turn it on**.
+
+| Command | Purpose |
+|---------|---------|
+| `ijfw personalize status` | Show the current flags plus a summary of what was inferred. |
+| `ijfw personalize on` | Enable injecting the learned low-sensitivity style brief into prompts. |
+| `ijfw personalize off` | Disable injection. Capture continues locally. |
+| `ijfw personalize forget [pattern]` | Delete inferences (no pattern = forget all). |
+| `ijfw personalize share-sensitive on\|off` | Allow/deny medium+high-sensitivity prefs to allowlisted hosts. Default off. |
+
+Hard override: set `IJFW_PROFILE_KILL=1` to force-disable all injection
+regardless of these settings.
+
 ### Multi-AI Trident
 
 | Command | Purpose |
@@ -521,7 +540,7 @@ Runtime: zero npm dependencies. Tokens: the cross-AI Trident uses your existing
 Yes, and verifiable in your own metrics. Sources: right-model dispatch (a cheaper tier when adequate, the heavyweight when needed), prompt cache discipline, output rules that cut padding, context discipline that stops re-pasting. Typical observed: 25 percent or more output reduction versus unmanaged baseline. The log is in your project.
 
 **Can I turn it off?**
-Yes. `ijfw off` disables the core skill. Each command is isolated. The MCP server can be unregistered per platform. Backups are timestamped. Nothing is sticky.
+Yes. `ijfw off` removes what IJFW added: it unregisters the MCP server across all 15 platforms, deletes IJFW skill/command/context files, and strips IJFW's managed marker regions out of every project `CLAUDE.md` / `AGENTS.md` it ever touched -- your own content in those files is preserved. Every file it edits is backed up with a timestamped `.bak` first. Your memory at `~/.ijfw/memory/` is kept (delete by hand, or `ijfw off --purge` to remove it too). Files it can't prove were IJFW-authored (e.g. hand-edited Aider rules) are left in place and called out so you can remove them yourself.
 
 **What about my existing memory in claude-mem or other tools?**
 `ijfw import claude-mem` round-trips the SQLite store into IJFW markdown. Idempotent. Safe to rerun. `--dry-run` shows what would happen first.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ijfw/install",
-  "version": "1.5.6",
+  "version": "1.6.1",
   "description": "One-command installer for IJFW -- the AI efficiency layer. One install, every AI coding agent, zero config.",
   "type": "module",
   "bin": {
@@ -13,6 +13,8 @@
     "src/install.ps1",
     "docs/GUIDE.md",
     "docs/guide/assets",
+    "templates/aider/**",
+    "templates/pi/**",
     "scripts/pack-hub-extension.js",
     "scripts/hub-extension/**",
     "README.md",
@@ -21,8 +23,9 @@
   ],
   "scripts": {
     "build": "node scripts/build.js",
-    "test": "node --test test.js",
+    "test": "node --test test.js test/uninstall-completeness.test.mjs test/project-write-guard.test.mjs",
     "test:hub-extension": "node --test test/test-pack-hub-extension.js",
+    "test:uninstall-completeness": "node --test test/uninstall-completeness.test.mjs",
     "preflight": "node dist/ijfw.js preflight",
     "pack:check": "npm pack --dry-run",
     "pack:hub-extension": "node scripts/pack-hub-extension.js",

package/src/install.ps1

@@ -282,7 +282,7 @@ function Remove-StalePosixLaunchers {
         $removed++
       }
     } catch {
-      # Best-effort: keep going on locked / inaccessible files.
+      $null = $_  # best-effort: keep going on locked / inaccessible files
     }
   }
   if ($removed -gt 0) {
@@ -323,7 +323,7 @@ function Provision-Plugin {
     }
     Copy-Item $srcItem.FullName $dstItem -Force
     # Preserve source mtime so next install doesn't mistake our copy for a user edit.
-    try { (Get-Item $dstItem -ErrorAction Stop).LastWriteTime = $srcItem.LastWriteTime } catch {}
+    try { (Get-Item $dstItem -ErrorAction Stop).LastWriteTime = $srcItem.LastWriteTime } catch { $null = $_ }
   }
 }
 

package/templates/aider/CONVENTIONS.md

@@ -0,0 +1,54 @@
+# IJFW Conventions for Aider
+
+<!-- Aider MCP support last verified: 2026-05-06 against https://aider.chat/docs/.
+     If Aider adds a native MCP client, regenerate this file and the rules-only
+     section in scripts/install.sh:aider). -->
+
+Aider doesn't have native MCP, so IJFW's memory + cross-audit tools aren't
+available inside Aider sessions. These conventions carry the IJFW spirit
+(disciplined workflow, terse output, no scope creep) into the Aider chat.
+
+## Workflow
+
+- One question at a time. Don't dump multi-step plans before user signs off.
+- Lead with the answer. No restating the question.
+- For multi-file changes, propose the plan in chat FIRST. Wait for user "go".
+
+## Code
+
+- Match existing style. Don't refactor adjacent code that wasn't asked for.
+- No speculative abstractions. Three similar lines beats a premature helper.
+- No error handling for impossible scenarios. Trust internal code.
+- Default to writing no comments. Only add WHEN the WHY is non-obvious.
+
+## Memory + cross-audit
+
+Aider sessions don't see IJFW's persistent memory. After significant work:
+
+- Run `ijfw cross audit <file>` in your terminal to get Trident review.
+- Use `ijfw_memory_store` from Claude/Codex/Gemini sessions to persist
+  decisions Aider makes -- they won't survive otherwise.
+
+## Scope
+
+Stay in the lane the user asked for. If you spot adjacent issues, mention them
+in chat -- don't fix them silently.
+
+## DESIGN picker
+
+If the user asks for a design contract and no `DESIGN.md` exists, suggest one
+of the 12 IJFW curated templates (alphabetical):
+
+bento-grid, brutalist-luxe, cinematic-dark, data-dense-dashboard,
+editorial-warm, glassmorphic, magazine-editorial, maximalist-vibrant,
+neo-swiss-tech, swiss-minimal, terminal-native, warm-organic.
+
+Aider has no MCP client, so it cannot fetch the template body itself. Ask the
+user to run this in any MCP-capable sibling CLI on their machine (Claude Code
+/ Codex / Gemini / Cursor / Windsurf / Copilot / Hermes / Wayland / OpenCode /
+Qwen / Kimi / OpenClaw) and paste the output back into the Aider chat:
+
+    ijfw_memory_recall({ context_hint: "design_template:<name>" })
+
+Once the user pastes the body, Aider writes `DESIGN.md` at the project root
+and picks it up automatically on the next turn.

package/templates/aider/aider.conf.yml

@@ -0,0 +1,23 @@
+# IJFW-shipped Aider config. Aider has no native MCP client (1.1.7 status);
+# this file scaffolds project conventions + auto-loads CONVENTIONS.md so
+# IJFW principles travel into Aider sessions.
+#
+# Edit freely -- IJFW only writes this file if absent.
+
+# Auto-load IJFW conventions on every Aider session.
+read:
+  - ~/CONVENTIONS.md
+
+# Default model -- override per-session with --model or per-project.
+# model: gpt-4o
+# weak-model: gpt-4o-mini
+
+# Auto-commits OFF by default. Aider's auto-commit can produce noisy
+# history; IJFW workflow prefers atomic commits at gate boundaries.
+auto-commits: false
+
+# Show diffs in the chat for transparency.
+show-diffs: true
+
+# Subtree-only -- don't grep the entire monorepo every turn.
+subtree-only: true

package/templates/pi/AGENTS.md

@@ -0,0 +1,55 @@
+# IJFW Conventions for Pi
+
+<!-- Pi MCP support last verified: 2026-05-28 against https://pi.dev/.
+     Pi has no native MCP client (build as extension or skill). When Pi adds
+     native MCP, regenerate this file and consider promoting Pi from
+     rules-only to full-skill tier in installer/src/install-targets-8-14.js
+     and add the MCP wiring path. -->
+
+Pi has no native MCP, so IJFW's memory + cross-audit tools aren't available
+inside Pi sessions out of the box. These conventions carry the IJFW spirit
+(disciplined workflow, terse output, no scope creep, no half-shipping) into
+Pi's terminal harness. Pi loads this file at startup from `~/.pi/agent/`,
+parent directories, and the current working directory -- exactly where IJFW
+installs it.
+
+## Workflow
+
+- One question at a time. Don't dump multi-step plans before the user signs off.
+- Lead with the answer. No restating the question.
+- For multi-file changes, propose the plan in chat FIRST. Wait for the user "go".
+- Terse output. The diff is the deliverable, not your prose about the diff.
+
+## Code
+
+- Match existing style. Don't refactor adjacent code that wasn't asked for.
+- No speculative abstractions. Three similar lines beats a premature helper.
+- No error handling for impossible scenarios. Trust internal code; validate only at system boundaries.
+- Default to writing no comments. Only add when the WHY is non-obvious (a hidden constraint, a subtle invariant, a workaround for a specific bug).
+- Never write multi-paragraph docstrings. One short line max.
+
+## Memory + cross-audit
+
+Pi sessions don't see IJFW's persistent memory by default. After significant work:
+
+- Run `ijfw cross audit <file>` in a separate terminal to get a Trident review across two model families.
+- Use `ijfw_memory_store` from a Claude/Codex/Gemini session (where MCP is native) to persist decisions Pi makes -- they won't survive otherwise.
+- Or build a Pi extension that bridges to the IJFW MCP memory server (`~/.ijfw/mcp-server/src/server.js`). Pi's extension API supports tool registration; the bridge is the cleanest path to native parity.
+
+## Scope
+
+Stay in the lane the user asked for. If you spot adjacent issues, mention them in chat -- don't fix them silently. No drive-by refactors. No backwards-compatibility shims for code that isn't shipped yet.
+
+## DESIGN picker
+
+If the user asks for a design contract and no `DESIGN.md` exists in the project root, suggest one of the 12 IJFW curated templates (alphabetical):
+
+apple-glass, anthropic, bauhaus, brutalist, calm, dark-mode, document, editorial, glassmorphism, minimal, neo-brutalist, terminal
+
+Show 3 options matching the project's vibe; let the user pick. Then write `DESIGN.md` to project root. Every IJFW-connected agent reads the same visual contract -- you keep them consistent.
+
+## Executing actions with care
+
+Carefully consider blast radius before destructive ops. Local edits and tests are safe; check with the user before `rm -rf`, force pushes, dropping tables, sending messages, or anything visible to others or hard to reverse.
+
+When you hit an obstacle, find the root cause rather than bypassing safety checks (no `--no-verify`, no force-push to main). If you encounter unfamiliar state, investigate before deleting -- it may be the user's in-progress work.

package/dist/hub-index-snippet.json

@@ -1,50 +0,0 @@
-{
-  "name": "ijfw",
-  "displayName": "IJFW — AI Efficiency Layer",
-  "version": "1.5.6",
-  "description": "One install, every AI coding agent, zero config. Unifies 16 CLIs under a shared MCP memory layer so context follows you across Claude, Codex, Gemini, Cursor, Windsurf, and 11 more.",
-  "author": "Sean Donahoe",
-  "icon": "assets/ijfw-logo.svg",
-  "dist": {
-    "tarball": "extensions/ijfw-1.5.6.zip",
-    "integrity": "sha512-vm3ot0+GhXYy0/HcStB/xmFjZhSXWG7jzSLuIPe43/Dla8qhyR9gsCwBI/8+RsUJqMXiPgc0GuxrgwW2f5DDWA==",
-    "unpackedSize": 3312
-  },
-  "engines": {
-    "wayland": ">=0.6.0"
-  },
-  "hubs": [
-    "acpAdapters",
-    "mcpServers"
-  ],
-  "contributes": {
-    "acpAdapters": [
-      "claude",
-      "codex",
-      "gemini",
-      "cursor",
-      "windsurf",
-      "copilot",
-      "hermes",
-      "wayland",
-      "aider",
-      "opencode",
-      "qwencode",
-      "cline",
-      "kimicode",
-      "openclaw",
-      "antigravity",
-      "pi"
-    ],
-    "mcpServers": [
-      "ijfw-memory"
-    ]
-  },
-  "tags": [
-    "ai",
-    "coding",
-    "mcp",
-    "memory",
-    "multi-agent"
-  ]
-}