fastrmemory 0.3.0 → 0.4.0

package/package.json

@@ -1,107 +1,108 @@
-{
-  "name": "fastrmemory",
-  "version": "0.3.0",
-  "mcpName": "io.github.atifjubaer/fastrmemory",
-  "description": "High-Performance Cognitive Agent Memory Engine with Bi-Temporal SQLite and Official MCP v2",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/atifjubaer/fastrmemory.git"
-  },
-  "homepage": "https://github.com/atifjubaer/fastrmemory#readme",
-  "bugs": {
-    "url": "https://github.com/atifjubaer/fastrmemory/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "dist",
-    "dist-ui",
-    "skills",
-    ".claude-plugin",
-    ".cursor",
-    "server.json",
-    "llms-install.md"
-  ],
-  "bin": {
-    "fastrmemory": "dist/bin/fastr.js",
-    "fastr": "dist/bin/fastr.js"
-  },
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "exports": {
-    ".": "./dist/src/index.js",
-    "./mcp": "./dist/src/mcp/server.js"
-  },
-  "engines": {
-    "node": ">=22.16.0"
-  },
-  "scripts": {
-    "prepare": "npm run build:core",
-    "prepublishOnly": "npm run build:core && npm test && npm run check:dist-ui && npm run check:package",
-    "build:core": "tsc",
-    "build:ui": "npm --prefix ui run build && node scripts/build-dist-ui-manifest.mjs",
-    "build:extension": "tsc -p extensions/vscode",
-    "build": "npm run build:core && npm run build:ui",
-    "build:all": "npm run build && npm run build:extension",
-    "watch": "tsc --watch",
-    "test": "vitest run",
-    "test:isolation": "vitest run tests/isolation.test.ts",
-    "smoke:gemini": "npm run build:core && node scripts/smoke-gemini.mjs",
-    "smoke:copilot": "npm run build:core && node scripts/smoke-copilot.mjs",
-    "smoke:opencode": "npm run build:core && node scripts/smoke-opencode.mjs",
-    "test:crash": "node scripts/crash-test.mjs",
-    "check:skills": "node scripts/check-skills.mjs",
-    "check:dist-ui": "node scripts/check-dist-ui.mjs",
-    "check:package": "node scripts/check-package.mjs",
-    "check:docs": "node scripts/check-docs.mjs",
-    "check:hygiene": "tsx scripts/check-hygiene.ts",
-    "check:crash": "node scripts/check-crash-evidence.mjs",
-    "bench": "tsx scripts/eval-bench.ts --split all --embeddings minilm --out bench/results/minilm.json",
-    "bench:hash": "tsx scripts/eval-bench.ts --split all --embeddings hash --out bench/results/hash.json",
-    "bench:legacy": "tsx scripts/capture-bench.ts",
-    "bench:public": "tsx scripts/eval-public.ts",
-    "bench:external": "tsx scripts/eval-external.ts",
-    "bench:verify": "node scripts/check-bench.mjs",
-    "verify:replay": "tsx scripts/verify-replay.ts",
-    "check:ci": "npm run test && npm run test:isolation && npm run check:skills && npm run check:dist-ui && npm run check:package && npm run check:query-plans && npm run check:recall-latency && npm run check:install-size && npm run verify:replay && npm run check:hygiene && npm run check:docs && npm run check:crash && npm run bench:verify",
-    "start": "node dist/bin/fastr.js",
-    "check:query-plans": "tsx scripts/check-query-plans.ts",
-    "check:recall-latency": "tsx scripts/check-recall-latency.ts",
-    "check:install-size": "node scripts/check-install-size.mjs"
-  },
-  "keywords": [
-    "ai",
-    "agent",
-    "memory",
-    "mcp",
-    "sqlite",
-    "bitemporal",
-    "claude-code",
-    "cursor"
-  ],
-  "author": "Fastrsoft",
-  "license": "Apache-2.0",
-  "dependencies": {
-    "@modelcontextprotocol/server": "^2.3.1",
-    "commander": "^13.1.0",
-    "zod": "^4.6.7"
-  },
-  "peerDependencies": {
-    "@huggingface/transformers": "^3.8.1"
-  },
-  "peerDependenciesMeta": {
-    "@huggingface/transformers": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@huggingface/transformers": "^3.8.1",
-    "@types/node": "^24.0.0",
-    "minisearch": "7.2.0",
-    "tsx": "^4.20.0",
-    "typescript": "^5.8.0",
-    "vitest": "^3.0.0"
-  }
-}
+{
+  "name": "fastrmemory",
+  "version": "0.4.0",
+  "mcpName": "io.github.atifjubaer/fastrmemory",
+  "description": "High-Performance Cognitive Agent Memory Engine with Bi-Temporal SQLite and Official MCP v2",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/atifjubaer/fastrmemory.git"
+  },
+  "homepage": "https://github.com/atifjubaer/fastrmemory#readme",
+  "bugs": {
+    "url": "https://github.com/atifjubaer/fastrmemory/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "dist-ui",
+    "bin/fastr-guard.mjs",
+    "skills",
+    ".claude-plugin",
+    ".cursor",
+    "server.json",
+    "llms-install.md"
+  ],
+  "bin": {
+    "fastrmemory": "bin/fastr-guard.mjs",
+    "fastr": "bin/fastr-guard.mjs"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./mcp": "./dist/src/mcp/server.js"
+  },
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "scripts": {
+    "prepare": "npm run build:core",
+    "prepublishOnly": "npm run build:core && npm test && npm run check:dist-ui && npm run check:package",
+    "build:core": "tsc",
+    "build:ui": "npm --prefix ui run build && node scripts/build-dist-ui-manifest.mjs",
+    "build:extension": "tsc -p extensions/vscode",
+    "build": "npm run build:core && npm run build:ui",
+    "build:all": "npm run build && npm run build:extension",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:isolation": "vitest run tests/isolation.test.ts",
+    "smoke:gemini": "npm run build:core && node scripts/smoke-gemini.mjs",
+    "smoke:copilot": "npm run build:core && node scripts/smoke-copilot.mjs",
+    "smoke:opencode": "npm run build:core && node scripts/smoke-opencode.mjs",
+    "test:crash": "node scripts/crash-test.mjs",
+    "check:skills": "node scripts/check-skills.mjs",
+    "check:dist-ui": "node scripts/check-dist-ui.mjs",
+    "check:package": "node scripts/check-package.mjs",
+    "check:docs": "node scripts/check-docs.mjs",
+    "check:hygiene": "tsx scripts/check-hygiene.ts",
+    "check:crash": "node scripts/check-crash-evidence.mjs",
+    "bench": "tsx scripts/eval-bench.ts --split all --embeddings minilm --out bench/results/minilm.json",
+    "bench:hash": "tsx scripts/eval-bench.ts --split all --embeddings hash --out bench/results/hash.json",
+    "bench:legacy": "tsx scripts/capture-bench.ts",
+    "bench:public": "tsx scripts/eval-public.ts",
+    "bench:external": "tsx scripts/eval-external.ts",
+    "bench:verify": "node scripts/check-bench.mjs",
+    "verify:replay": "tsx scripts/verify-replay.ts",
+    "check:ci": "npm run test && npm run test:isolation && npm run check:skills && npm run check:dist-ui && npm run check:package && npm run check:query-plans && npm run check:recall-latency && npm run check:install-size && npm run verify:replay && npm run check:hygiene && npm run check:docs && npm run check:crash && npm run bench:verify",
+    "start": "node bin/fastr-guard.mjs",
+    "check:query-plans": "tsx scripts/check-query-plans.ts",
+    "check:recall-latency": "tsx scripts/check-recall-latency.ts",
+    "check:install-size": "node scripts/check-install-size.mjs"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "memory",
+    "mcp",
+    "sqlite",
+    "bitemporal",
+    "claude-code",
+    "cursor"
+  ],
+  "author": "Fastrsoft",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.3.1",
+    "commander": "^13.1.0",
+    "zod": "^4.6.7"
+  },
+  "peerDependencies": {
+    "@huggingface/transformers": "^3.8.1"
+  },
+  "peerDependenciesMeta": {
+    "@huggingface/transformers": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@huggingface/transformers": "^3.8.1",
+    "@types/node": "^24.0.0",
+    "minisearch": "7.2.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  }
+}

package/server.json

@@ -1,28 +1,28 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
-  "name": "io.github.atifjubaer/fastrmemory",
-  "title": "FastrMemory",
-  "description": "Local-first cognitive agent memory with bi-temporal SQLite, replayable history, and triple-stream retrieval.",
-  "version": "0.3.0",
-  "websiteUrl": "https://github.com/atifjubaer/fastrmemory",
-  "repository": {
-    "url": "https://github.com/atifjubaer/fastrmemory",
-    "source": "github"
-  },
-  "packages": [
-    {
-      "registryType": "npm",
-      "registryBaseUrl": "https://registry.npmjs.org",
-      "identifier": "fastrmemory",
-      "transport": {
-        "type": "stdio"
-      },
-      "packageArguments": [
-        {
-          "type": "positional",
-          "value": "mcp"
-        }
-      ]
-    }
-  ]
-}
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.atifjubaer/fastrmemory",
+  "title": "FastrMemory",
+  "description": "Local-first cognitive agent memory with bi-temporal SQLite, replayable history, and triple-stream retrieval.",
+  "version": "0.4.0",
+  "websiteUrl": "https://github.com/atifjubaer/fastrmemory",
+  "repository": {
+    "url": "https://github.com/atifjubaer/fastrmemory",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "fastrmemory",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        }
+      ]
+    }
+  ]
+}

package/skills/fastr-compress/SKILL.md

@@ -1,33 +1,33 @@
----
-name: fastr-compress
-description: Use when a markdown file, PR description, or block of context is too long for the token budget you need to fit it into, or the user asks to shrink a doc. Compresses prose while preserving headings, code blocks, and links; always preview first.
----
-
-# FastrMemory: Token Compression
-
-## When to use
-- A doc or context payload exceeds the budget you need it to fit.
-- The user asks to compact a long markdown file.
-
-Do not use it on source code or on files where exact wording matters (licences, legal text, changelogs).
-
-## Steps
-1. **Preview savings** without touching disk:
-   ```js
-   fastr_compress({ filePath: "docs/guide.md", dryRun: true })
-   ```
-
-2. **Compress the file** (writes `<file>.original.md` as a backup):
-   ```js
-   fastr_compress({ filePath: "docs/guide.md", dryRun: false })
-   ```
-
-3. **Or compress text in memory** (nothing written to disk; output is returned):
-   ```js
-   fastr_compress({ content: "# Title\n\nLong conversational text...", dryRun: false })
-   ```
-
-## Guarantees to verify
-- ATX headings, fenced code blocks, URLs, and markdown links are kept intact.
-- Filler phrases, duplicate list items, and extra blank lines are removed.
-- Review any warnings in the result; restore from the `.original.md` backup if meaning was lost.
+---
+name: fastr-compress
+description: Use when a markdown file, PR description, or block of context is too long for the token budget you need to fit it into, or the user asks to shrink a doc. Compresses prose while preserving headings, code blocks, and links; always preview first.
+---
+
+# FastrMemory: Token Compression
+
+## When to use
+- A doc or context payload exceeds the budget you need it to fit.
+- The user asks to compact a long markdown file.
+
+Do not use it on source code or on files where exact wording matters (licences, legal text, changelogs).
+
+## Steps
+1. **Preview savings** without touching disk:
+   ```js
+   fastr_compress({ filePath: "docs/guide.md", dryRun: true })
+   ```
+
+2. **Compress the file** (writes `<file>.original.md` as a backup):
+   ```js
+   fastr_compress({ filePath: "docs/guide.md", dryRun: false })
+   ```
+
+3. **Or compress text in memory** (nothing written to disk; output is returned):
+   ```js
+   fastr_compress({ content: "# Title\n\nLong conversational text...", dryRun: false })
+   ```
+
+## Guarantees to verify
+- ATX headings, fenced code blocks, URLs, and markdown links are kept intact.
+- Filler phrases, duplicate list items, and extra blank lines are removed.
+- Review any warnings in the result; restore from the `.original.md` backup if meaning was lost.

package/skills/fastr-curate/SKILL.md

@@ -1,62 +1,62 @@
----
-name: fastr-curate
-description: Use when you learn something durable worth keeping (a new convention, an architectural decision, a user preference), when recalled memories contradict each other, or when memory needs cleanup. Dedupes before storing, records or supersedes rules, resolves conflicts, and snapshots memory before risky bulk changes.
----
-
-# FastrMemory: Curate Project Memory
-
-## When to use
-- The user states a preference or guideline, or you settle an architectural decision.
-- Two recalled memories give opposing instructions.
-- A refactor or migration invalidates existing rules.
-- You are about to make many memory changes and want a restore point.
-
-## 1. Dedupe, then remember
-Always search first:
-```js
-fastr_recall({ query: "test runner convention", budgetTokens: 800 })
-```
-- Same rule exists and is right: rate it, do not store again.
-- Exists but outdated: supersede it (step 2).
-- Nothing relevant: store it.
-```js
-fastr_remember({
-  kind: "decision",
-  module: "api",
-  title: "Validate request bodies with zod at the route boundary",
-  content: "Every route parses input with a zod schema before calling services. Services assume valid input.",
-  files: ["src/api/routes.ts"],
-  symbols: ["registerRoutes"],
-  verified: false
-})
-```
-`kind` is one of `rule`, `decision`, `error_trap`, `workflow`. Leave `verified: false` (staging) until tests confirm it; use `scope: "global"` only for organisation-wide rules; `pinned: true` sparingly.
-
-## 2. Supersede instead of duplicating
-```js
-fastr_supersede({
-  oldMemoryId: "mem_jest01",
-  newTitle: "Use Vitest, not Jest",
-  newContent: "Vitest runs ESM natively; Jest config was removed.",
-  reason: "ESM migration"
-})
-```
-
-## 3. Resolve contradictions
-```js
-fastr_conflicts({ status: "open" })
-fastr_resolve({ conflictId: 4, keepId: "mem_vitest2", forgetLoser: true, reason: "Jest removed in v0.1" })
-```
-`forgetLoser: false` only weakens the loser's score; use it when both may still apply.
-
-## 4. Score usefulness
-```js
-fastr_feedback({ memoryId: "mem_vitest2", outcome: "good", note: "Prevented adding Jest config" })
-```
-
-## 5. Snapshot before bulk changes, roll back if needed
-```js
-fastr_snapshot({ tag: "pre-auth-cleanup", description: "Before consolidating auth rules" })
-fastr_rollback({ snapshotId: "snap_xxxx" })
-```
-Audit what changed with `fastr_timeline({ module: "auth", limit: 25 })`.
+---
+name: fastr-curate
+description: Use when you learn something durable worth keeping (a new convention, an architectural decision, a user preference), when recalled memories contradict each other, or when memory needs cleanup. Dedupes before storing, records or supersedes rules, resolves conflicts, and snapshots memory before risky bulk changes.
+---
+
+# FastrMemory: Curate Project Memory
+
+## When to use
+- The user states a preference or guideline, or you settle an architectural decision.
+- Two recalled memories give opposing instructions.
+- A refactor or migration invalidates existing rules.
+- You are about to make many memory changes and want a restore point.
+
+## 1. Dedupe, then remember
+Always search first:
+```js
+fastr_recall({ query: "test runner convention", budgetTokens: 800 })
+```
+- Same rule exists and is right: rate it, do not store again.
+- Exists but outdated: supersede it (step 2).
+- Nothing relevant: store it.
+```js
+fastr_remember({
+  kind: "decision",
+  module: "api",
+  title: "Validate request bodies with zod at the route boundary",
+  content: "Every route parses input with a zod schema before calling services. Services assume valid input.",
+  files: ["src/api/routes.ts"],
+  symbols: ["registerRoutes"],
+  verified: false
+})
+```
+`kind` is one of `rule`, `decision`, `error_trap`, `workflow`. Leave `verified: false` (staging) until tests confirm it; use `scope: "global"` only for organisation-wide rules; `pinned: true` sparingly.
+
+## 2. Supersede instead of duplicating
+```js
+fastr_supersede({
+  oldMemoryId: "mem_jest01",
+  newTitle: "Use Vitest, not Jest",
+  newContent: "Vitest runs ESM natively; Jest config was removed.",
+  reason: "ESM migration"
+})
+```
+
+## 3. Resolve contradictions
+```js
+fastr_conflicts({ status: "open" })
+fastr_resolve({ conflictId: 4, keepId: "mem_vitest2", forgetLoser: true, reason: "Jest removed in v0.1" })
+```
+`forgetLoser: false` only weakens the loser's score; use it when both may still apply.
+
+## 4. Score usefulness
+```js
+fastr_feedback({ memoryId: "mem_vitest2", outcome: "good", note: "Prevented adding Jest config" })
+```
+
+## 5. Snapshot before bulk changes, roll back if needed
+```js
+fastr_snapshot({ tag: "pre-auth-cleanup", description: "Before consolidating auth rules" })
+fastr_rollback({ snapshotId: "snap_xxxx" })
+```
+Audit what changed with `fastr_timeline({ module: "auth", limit: 25 })`.

package/skills/fastr-dag/SKILL.md

@@ -1,47 +1,47 @@
----
-name: fastr-dag
-description: Use when work splits into several dependent steps, when multiple agents share one task list, or when you need to know what to work on next. Builds a task DAG with dependencies and conflicts, claims the next unblocked action, and marks progress.
----
-
-# FastrMemory: Multi-Agent Action DAG
-
-## When to use
-- A plan has steps that depend on each other.
-- Several agents or sessions work the same backlog and must not collide.
-- You finished an action and need the next one.
-
-## 1. Create actions with dependencies
-```js
-fastr_action_create({
-  title: "Add v2 schema migration",
-  description: "Migration plus rollback; tests in tests/schema.test.ts",
-  priority: 8
-})
-fastr_action_create({
-  title: "Implement JWT auth guard",
-  description: "Guard in src/auth/guard.ts using the v2 users table",
-  priority: 6,
-  requires: ["act_schema"],
-  conflictsWith: ["act_auth_refactor"],
-  assignedTo: "claude-code"
-})
-```
-`priority` runs 1 (lowest) to 10 (highest). Use the IDs returned by earlier calls in `requires` / `conflictsWith`.
-
-## 2. See what is unblocked
-```js
-fastr_frontier({})
-```
-
-## 3. Claim the next action atomically
-```js
-fastr_next({ agentId: "claude-code" })
-```
-This marks the highest-priority unblocked action `active` for that agent.
-
-## 4. Update status as you go
-```js
-fastr_action_update({ id: "act_xxxx", status: "done", crystallizedInto: "mem_8f2a1c" })
-fastr_action_update({ id: "act_yyyy", status: "blocked" })
-```
-Statuses: `pending`, `active`, `done`, `blocked`, `cancelled`. Marking `done` unblocks dependents; set `crystallizedInto` to the memory that captured the lesson, if any.
+---
+name: fastr-dag
+description: Use when work splits into several dependent steps, when multiple agents share one task list, or when you need to know what to work on next. Builds a task DAG with dependencies and conflicts, claims the next unblocked action, and marks progress.
+---
+
+# FastrMemory: Multi-Agent Action DAG
+
+## When to use
+- A plan has steps that depend on each other.
+- Several agents or sessions work the same backlog and must not collide.
+- You finished an action and need the next one.
+
+## 1. Create actions with dependencies
+```js
+fastr_action_create({
+  title: "Add v2 schema migration",
+  description: "Migration plus rollback; tests in tests/schema.test.ts",
+  priority: 8
+})
+fastr_action_create({
+  title: "Implement JWT auth guard",
+  description: "Guard in src/auth/guard.ts using the v2 users table",
+  priority: 6,
+  requires: ["act_schema"],
+  conflictsWith: ["act_auth_refactor"],
+  assignedTo: "claude-code"
+})
+```
+`priority` runs 1 (lowest) to 10 (highest). Use the IDs returned by earlier calls in `requires` / `conflictsWith`.
+
+## 2. See what is unblocked
+```js
+fastr_frontier({})
+```
+
+## 3. Claim the next action atomically
+```js
+fastr_next({ agentId: "claude-code" })
+```
+This marks the highest-priority unblocked action `active` for that agent.
+
+## 4. Update status as you go
+```js
+fastr_action_update({ id: "act_xxxx", status: "done", crystallizedInto: "mem_8f2a1c" })
+fastr_action_update({ id: "act_yyyy", status: "blocked" })
+```
+Statuses: `pending`, `active`, `done`, `blocked`, `cancelled`. Marking `done` unblocks dependents; set `crystallizedInto` to the memory that captured the lesson, if any.

package/skills/fastr-doctor/SKILL.md

@@ -1,39 +1,39 @@
----
-name: fastr-doctor
-description: Use when FastrMemory searches miss memories you just stored, recall is slow or erroring, the action frontier looks stuck, or the user asks to check or repair the memory database. Diagnoses first, previews repairs, then heals.
----
-
-# FastrMemory: Diagnose and Heal
-
-## When to use
-- `fastr_recall` does not find a memory that `fastr_timeline` shows exists.
-- Recall or status calls are slow, or report database errors.
-- Actions stay blocked although their prerequisites are done.
-
-## Steps
-1. **Diagnose (read-only)**:
-   ```js
-   fastr_diagnose({})
-   ```
-   Checks SQLite integrity, FTS5 index consistency, orphaned file links, action DAG edges, and journal mode.
-
-2. **Preview repairs**:
-   ```js
-   fastr_heal({ dryRun: true })
-   ```
-
-3. **Apply repairs** once the preview looks right:
-   ```js
-   fastr_heal({ dryRun: false })
-   ```
-   Rebuilds the FTS5 index, prunes orphaned links, unblocks stale DAG edges, and checkpoints the WAL.
-
-4. **Confirm**:
-   ```js
-   fastr_status({})
-   ```
-
-## Rules
-- Always diagnose before healing and report what was found.
-- If issues remain that are not fixable, tell the user; do not delete `.fastr/` files by hand.
-- CLI equivalents: `fastrmemory diagnose`, `fastrmemory heal`.
+---
+name: fastr-doctor
+description: Use when FastrMemory searches miss memories you just stored, recall is slow or erroring, the action frontier looks stuck, or the user asks to check or repair the memory database. Diagnoses first, previews repairs, then heals.
+---
+
+# FastrMemory: Diagnose and Heal
+
+## When to use
+- `fastr_recall` does not find a memory that `fastr_timeline` shows exists.
+- Recall or status calls are slow, or report database errors.
+- Actions stay blocked although their prerequisites are done.
+
+## Steps
+1. **Diagnose (read-only)**:
+   ```js
+   fastr_diagnose({})
+   ```
+   Checks SQLite integrity, FTS5 index consistency, orphaned file links, action DAG edges, and journal mode.
+
+2. **Preview repairs**:
+   ```js
+   fastr_heal({ dryRun: true })
+   ```
+
+3. **Apply repairs** once the preview looks right:
+   ```js
+   fastr_heal({ dryRun: false })
+   ```
+   Rebuilds the FTS5 index, prunes orphaned links, unblocks stale DAG edges, and checkpoints the WAL.
+
+4. **Confirm**:
+   ```js
+   fastr_status({})
+   ```
+
+## Rules
+- Always diagnose before healing and report what was found.
+- If issues remain that are not fixable, tell the user; do not delete `.fastr/` files by hand.
+- CLI equivalents: `fastrmemory diagnose`, `fastrmemory heal`.