mindforge-cc 11.9.5 → 11.9.7

package/bin/skills-builder/learn-cli.js

@@ -5,49 +5,61 @@
  */
 'use strict';
 
-const Loader    = require('./source-loader');
+const Loader = require('./source-loader');
 const Generator = require('./skill-generator');
-const Scorer    = require('./skill-scorer');
+const Scorer = require('./skill-scorer');
 const Registrar = require('./skill-registrar');
 
 const ARGS = process.argv.slice(2);
 const SOURCE = ARGS[0];
-const NAME   = ARGS[1] || 'new-skill';
+const NAME = ARGS[1] || 'new-skill';
 
 if (!SOURCE) {
-  console.log('Usage: node bin/skills-builder/learn-cli.js <source-url-or-path> [skill-name]');
+  console.log(
+    'Usage: node bin/skills-builder/learn-cli.js <source-url-or-path> [skill-name]',
+  );
   process.exit(1);
 }
 
 async function main() {
   try {
     console.log(`\n📚 Learning skill: ${NAME} from ${SOURCE}`);
-    
+
     // 1. Load
-    const { content, metadata } = await Loader.load(SOURCE);
-    
+    const { type, content, metadata } = await Loader.load(SOURCE);
+
     // 2. Generate
     const result = await Generator.generate({
       skillName: NAME,
       content,
       sourceMetadata: metadata,
-      sessionId: 'cli-learn'
+      sessionId: 'cli-learn',
     });
-    
+
     // 3. Score
     const scoreResult = Scorer.score(result.skillPath);
     console.log(`\n✅ Skill generated: ${result.skillPath}`);
-    console.log(`⭐ Quality Score: ${scoreResult.quality_score}/100 (${scoreResult.threshold_status})`);
-    
+    console.log(
+      `⭐ Quality Score: ${scoreResult.quality_score}/100 (${scoreResult.threshold_status})`,
+    );
+
     // 4. Register if acceptable
     if (scoreResult.can_register) {
-      Registrar.register(result.skillPath, 'project');
+      Registrar.register({
+        skillName: NAME,
+        skillPath: result.skillPath,
+        tier: 'project',
+        qualityScore: scoreResult.quality_score,
+        sourceType: type,
+        source: SOURCE,
+      });
       console.log('📝 Registered in MANIFEST.md');
     } else {
       console.log('⚠️ Score too low for automatic registration.');
-      scoreResult.improvement_suggestions.forEach(s => console.log(`  - ${s}`));
+      scoreResult.improvement_suggestions.forEach((s) =>
+        console.log(`  - ${s}`),
+      );
     }
-    
   } catch (err) {
     console.error(`\n❌ Error: ${err.message}`);
     process.exit(1);

package/bin/wizard/theme.js

@@ -61,7 +61,7 @@ const Theme = {
    */
   printBrandManifest() {
     console.log(`  ${this.colors.dim('│')}`);
-    console.log(`  ${this.colors.dim('│')}  ${this.colors.magenta('🛡️  SOVEREIGN INTELLIGENCE v8.1.1')} — PQAS & Proactive Homing Enabled`);
+    console.log(`  ${this.colors.dim('│')}  ${this.colors.magenta('🛡️  SOVEREIGN INTELLIGENCE v8.2.0')} — PQAS (simulated) & Proactive Homing`);
     console.log(`  ${this.colors.dim('│')}`);
     console.log(`  ${this.colors.dim('│')}  ${this.colors.bold('THE PLATFORM VISION:')}`);
     console.log(`  ${this.colors.dim('│')}    - Unified Enterprise Agentic Ecosystem`);
@@ -77,7 +77,7 @@ const Theme = {
     console.log(`  ${this.colors.dim('│')}  ${this.colors.cyan('⭐ HELP US GROW:')}`);
     console.log(`  ${this.colors.dim('│')}    - GitHub:  ${this.colors.dim('https://github.com/sairam0424/MindForge')}`);
     console.log(`  ${this.colors.dim('│')}    - Discord: ${this.colors.dim('https://discord.gg/mindforge')}`);
-    console.log(`  ${this.colors.dim('│')}    - Docs:    ${this.colors.dim('https://docs.mindforge.cc')}`);
+    console.log(`  ${this.colors.dim('│')}    - Docs:    ${this.colors.dim('https://github.com/sairam0424/MindForge#documentation')}`);
     console.log(`  ${this.colors.dim('│')}`);
     console.log(`  ${this.colors.dim('—'.repeat(80))}\n`);
   },

package/changelogs/v11.9.6.md

@@ -0,0 +1,135 @@
+# Changelog
+
+## [11.9.6] — 2026-09-20 — The docs stop overselling what the code discloses about itself
+
+Patch release. No new features — this is the release-readiness pass before pointing real
+users at the project for the first time, and it found the same pattern one more time:
+code that honestly labels its own simulated/dormant parts, sitting under docs that hadn't
+caught up. Every fix below was hand-verified against the live source or a real command
+run, not carried over from a prior audit's prose.
+
+### Fixed
+
+**Two real, reproducible bugs**
+
+- **`/mindforge:learn` crashed on every skill that scored high enough to register.**
+  `bin/skills-builder/learn-cli.js` called `skill-registrar.js`'s `register()` with two
+  positional string arguments (`skillPath`, `'project'`); `register()` destructures a
+  single options object, so every call threw inside it, silently swallowed by the CLI's
+  generic catch. A validly-generated `SKILL.md` never reached `MANIFEST.md`, and the CLI
+  reported a bare `❌ Error`. Fixed the call site to pass `{ skillName, skillPath, tier,
+  qualityScore, sourceType, source }`, matching `register()`'s real signature.
+
+- **`bin/browser/browser-daemon.js` printed its own bearer token to stdout** (captured
+  verbatim into the persistent `.planning/browser-daemon.log` by `daemon-manager.js`),
+  and gated only `/evaluate` — `/navigate`, `/click`, `/type`, and `/screenshot` had no
+  auth check at all. The idle-timeout path also called `process.exit(0)` directly,
+  bypassing the token-file cleanup in `shutdown()`. Fixed all three: the startup log now
+  prints only the token's file path, the auth check runs once before dispatch and covers
+  every route but `/status`, and the idle path calls the real `shutdown()`.
+
+**A test with a blind spot for the exact bug it exists to catch**
+
+- `tests/sdk-exports.test.js` guards against any tracked file instructing
+  `require('@mindforge/sdk')` — the unpublished, wrong package name (`sdk/package.json`
+  publishes as `mindforge-sdk`). Its scan used `git ls-files -z '*.md' '*.ts'`, which
+  cannot match `.js` files — so it did not, and could not, catch the live occurrence in
+  `examples/sdk-integration/index.js`. Fixed both: the import, and the pathspec (now also
+  `*.js`/`*.mjs`/`*.cjs`, with `tests/` added to the same "records, not instructions"
+  allowlist as `changelogs/`, since this file's own `WRONG` string literal would otherwise
+  self-flag).
+
+**A dashboard that rendered success while showing nothing**
+
+- Three more panels in `bin/dashboard/frontend/app.js` read response fields their real
+  backing functions in `metrics-aggregator.js` have never produced — the same bug class
+  already fixed once for the avg-quality tile, left unaddressed here. `refreshMemory()`
+  read `data.graph`/`data.count`; the real shape is `{ entries, total }`. `refreshTeam()`
+  called `.map()` on the whole response object; the real shape is `{ active, conflicts }`
+  with `email`/`last_seen`/`current_task` fields, not `user`/`action`/`timestamp`.
+  `drawCharts()` read `state.costs`/`state.quality`, fields `/api/metrics` never returns;
+  the real per-session series is `state.sessions[].cost_usd` /
+  `state.sessions[].quality_score`. All three failed silently behind an empty `catch`, so
+  the panels looked idle rather than broken. Fixed to read the real shapes.
+
+**Two shipped documents that stated the opposite of the code**
+
+- `SECURITY.md` claimed `AUDIT.jsonl` "auto-archives beyond 5000 lines with gzip
+  compression" — that rotation mechanism was removed in an earlier release specifically
+  because truncating the file broke the hash chain (it orphans `previous_hash` pointers to
+  archived entries). The log grows unbounded by design; the doc now says so.
+- `docs/security/SECURITY.md` had drifted into a second, independent copy of this policy
+  with a `5.x.x`/`4.x.x`/`< 4.0.0` support table — years behind the real `11.x` line the
+  root `/SECURITY.md` (the canonical file) documents. Replaced with a pointer to the root
+  file so this can't re-drift.
+
+**A stale Homebrew formula**
+
+- `Formula/mindforge.rb` was pinned to `11.9.3` (url, sha256, and the version-assertion
+  test) — two releases behind, so `brew install mindforge` installed an old build with
+  none of 11.9.4/11.9.5's fixes. Re-pinned to the real published `11.9.5` tarball with its
+  actual sha256 (fetched and hashed directly, not carried over). This is the same drift
+  class the project has hit twice before (11.9.2 shipped with this file and `Dockerfile`
+  four releases behind); `Formula/mindforge.rb` will lag one release again until
+  `node scripts/sync-version.js --fetch-sha` runs after this version publishes — expected,
+  not a regression.
+
+### Changed — a documentation honesty pass
+
+The following describe MindForge's own PQAS (post-quantum crypto), ZTAI (Zero-Trust
+Agentic Identity), and "Pillar"-numbered subsystems as live, unconditional security
+guarantees. They are not: `bin/governance/quantum-crypto.js` and
+`bin/governance/ztai-manager.js` self-label these SIMULATED and gate them off the live
+trust path by default (`SECURITY_TIER_3_SIMULATED = true`), and `SwarmController` /
+`PersonaFactory` / `WaveExecutor` are role names in markdown specs with no backing file —
+a distinction this repo's own `.claude/CLAUDE.md` already draws, just not everywhere yet.
+Rewrote each to match the same "measured, not asserted" tone already used in
+`docs/faq.md` and `docs/troubleshooting.md` and the root README's *What is actually
+enforced* section:
+
+`docs/usp-features.md`, `CODEBASE-MAP.md`, `docs/architecture/README.md`,
+`docs/CAPABILITIES-MANIFEST.md`, `docs/governance-guide.md`,
+`docs/MIND-FORGE-REFERENCE-V6.md`, `docs/INTELLIGENCE-MESH.md`, `docs/PERSONAS.md`,
+`docs/security/threat-model.md`, `docs/security/penetration-test-results.md` (the latter
+two now banner-marked as scoped to an earlier, materially smaller predecessor system, not
+a current assessment — no new pentest content was fabricated to replace them).
+
+**Six reference docs (`docs/registry/*.md`) were stuck at v11.3.1** (six releases behind)
+with command/skill/persona/subagent counts off by 2–9x against the live filesystem, and
+listed 14+ slash commands with no backing file (`/mindforge:quantum-verify`,
+`/mindforge:hindsight`, `/mindforge:harvest`, `/mindforge:self-heal`,
+`/mindforge:swarm-execution`, `/mindforge:identity`, and others) — each individually
+re-verified against `.claude/commands/mindforge/` before being removed or reworded.
+Updated all six to the real, live-verified counts (221 commands, 232+123 skills, 217
+personas, 164 subagents) and pointed each at `docs/commands-reference.md` as the
+canonical source, so staleness here is lower-stakes going forward.
+
+Also corrected: `docs/plugin-installation.md` and `docs/reference(s)/commands.md` (stale
+hand-typed counts), `docs/References/{decimal-phase-calculation,git-integration,
+git-planning-commit}.md` (wrong CLI path — real tool is `.agent/bin/mindforge-tools.cjs`,
+not `.agent/mindforge/bin/...`), `docs/References/model-profile-resolution.md` (dead
+`@`-include path), and a fabricated `"Claude 4.5 Opus"` model-name literal in two docs
+(no such string exists anywhere in `bin/`) replaced with the real "highest-capability
+tier configured" language. Deleted two orphaned scratch files that were never real
+documentation: `docs/testing-current-version.md` (a pre-release scratch file hardcoding
+a personal machine path) and `docs/commands-skills/DISCOVERED_SKILLS.md` (stale output
+from an unrelated external tool referencing a directory that doesn't exist in this repo).
+
+### Changed — discoverability
+
+- Root `README.md`: npm-version/downloads/license/Node-version badges, an "at a glance"
+  capability summary with real counts, and jump links to the existing sections.
+- `package.json`: `description` rewritten from marketing language ("Sovereign Agentic
+  Intelligence Framework... Production-Hardened... (v11)") to concrete, keyword-bearing
+  text; added `ai-agents`, `llm-tools`, `developer-tools`, `mcp-server` to `keywords`.
+
+### Verified
+
+- `npm test`: 137 passed, 0 failed, 3 env-dependent skips (`browser.test.js`,
+  `browser-daemon-auth-live.test.js`, `sre-integration.test.js` — all three require a
+  Chromium daemon/display or git worktree support this sandbox does not have). Verified
+  clean through the real pre-commit hook, not just a standalone run.
+- `node scripts/sync-version.js`: 27 channels synced; `Formula/mindforge.rb` correctly
+  deferred (tarball doesn't exist yet); `plugins/mindforge/.claude-plugin/plugin.json` and
+  `plugins/mindforge/mcp/dist/index.js` rebuilt.
+

package/changelogs/v11.9.7.md

@@ -0,0 +1,35 @@
+# Changelog
+
+## [11.9.7] — 2026-09-20 — The install banner stops contradicting itself
+
+Patch release. Found by actually running the documented install command
+(`npx mindforge-cc@latest --claude --local`) in a clean project instead of stopping at
+`--version` — the check that should have caught the v11.9.6 regressions below before they
+shipped.
+
+### Fixed
+
+**Two real bugs in the install banner itself, both live in every v11.9.6 install**
+
+- **Version self-contradiction.** The top banner (`bin/wizard/theme.js`'s
+  `printBrandManifest()`) hardcoded `SOVEREIGN INTELLIGENCE v8.1.1`, while the install
+  activation line two screens later (`bin/installer-core.js`) prints `v8.2.0` for the same
+  subsystem — one command, two version numbers. Standardized on `v8.2.0`.
+- **False "Enabled" claim.** The same top banner said `PQAS & Proactive Homing Enabled`
+  unconditionally, directly contradicting the accurate disclosure a few lines later in the
+  same run: "available in simulated/experimental mode (inactive by default)". Changed to
+  `PQAS (simulated) & Proactive Homing`. `bin/engine/learning-manager.js` carried the
+  identical string; fixed there too.
+- **Dead docs link.** The banner's `Docs: https://docs.mindforge.cc` fails TLS handshake —
+  DNS resolves but no site was ever deployed there. Repointed to the real, verified-live
+  `https://github.com/sairam0424/MindForge#documentation`.
+
+**Doc regression from the v11.9.6 pass, self-inflicted**
+
+- The persona-count reconciliation in v11.9.6 used a naive
+  `find .mindforge/personas -type f | wc -l` (218), which silently swept in
+  `swarm-templates.json` and `overrides/README.md` — neither is a persona. The installer's
+  own `collectManifestStats()` counts top-level `.md` files only: **216**, matching the
+  preserved 2026-08-16 codebase-index snapshot. Reverted `README.md`,
+  `docs/CAPABILITIES-MANIFEST.md`, `docs/user-guide.md`, `docs/PERSONAS.md`,
+  `docs/registry/PERSONAS.md`, and `docs/registry/README.md`.

package/docs/References/commands.md

@@ -1,6 +1,10 @@
-# MindForge v2.0.0 — Complete Commands Reference
+# MindForge — Common Commands Quick Reference
 
-## All 50+ commands
+This page is a curated subset for quick lookup, not an exhaustive list. MindForge ships
+221 slash commands total — see [docs/commands-reference.md](../commands-reference.md) for
+the complete, verified list.
+
+## Commonly used commands
 
 ### Lifecycle commands (core workflow)
 
@@ -95,13 +99,14 @@
 |---|---|---|---|
 | `/mindforge:help` | `help` | Show all available commands and current project status | |
 
-## Command interface contract (v1.0.0 stable)
+## Command interface contract
 
-As of v1.0.0, the following are part of the stable interface:
-- All 36 command names (new commands require MINOR bump)
-- All flags documented here (new flags require MINOR, removed flags require MAJOR)
+The following are part of the stable interface:
+- Existing command names are not renamed without a MAJOR bump; new commands may land in any release
+- Documented flags are not removed without a MAJOR bump
 - HANDOFF.json and AUDIT.jsonl schemas (additions: MINOR, removals: MAJOR)
-- All 10 core skill `name:` values and trigger lists
 - SDK exported types and functions
 
-See ADR-020 for the complete stability contract.
+Note: `.planning/decisions/ADR-020.md` (previously cited here as the stability contract source)
+is a content-free placeholder stub as of this writing — treat this page, not that ADR, as the
+source of truth for the interface contract until a real ADR replaces it.

package/docs/References/decimal-phase-calculation.md

@@ -6,7 +6,7 @@ Calculate the next decimal phase number for urgent insertions.
 
 ```bash
 # Get next decimal phase after phase 6
-node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal 6
+node ".agent/bin/mindforge-tools.cjs" phase next-decimal 6
 ```
 
 Output:
@@ -32,13 +32,13 @@ With existing decimals:
 ## Extract Values
 
 ```bash
-DECIMAL_PHASE=$(node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --pick next)
-BASE_PHASE=$(node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --pick base_phase)
+DECIMAL_PHASE=$(node ".agent/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --pick next)
+BASE_PHASE=$(node ".agent/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --pick base_phase)
 ```
 
 Or with --raw flag:
 ```bash
-DECIMAL_PHASE=$(node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --raw)
+DECIMAL_PHASE=$(node ".agent/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --raw)
 # Returns just: 06.1
 ```
 
@@ -56,7 +56,7 @@ DECIMAL_PHASE=$(node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decim
 Decimal phase directories use the full decimal number:
 
 ```bash
-SLUG=$(node ".agent/mindforge/bin/mindforge-tools.cjs" generate-slug "$DESCRIPTION" --raw)
+SLUG=$(node ".agent/bin/mindforge-tools.cjs" generate-slug "$DESCRIPTION" --raw)
 PHASE_DIR=".planning/phases/${DECIMAL_PHASE}-${SLUG}"
 mkdir -p "$PHASE_DIR"
 ```

package/docs/References/git-integration.md

@@ -51,7 +51,7 @@ Phases:
 What to commit:
 
 ```bash
-node ".agent/mindforge/bin/mindforge-tools.cjs" commit "docs: initialize [project-name] ([N] phases)" --files .planning/
+node ".agent/bin/mindforge-tools.cjs" commit "docs: initialize [project-name] ([N] phases)" --files .planning/
 ```
 
 </format>
@@ -133,7 +133,7 @@ SUMMARY: .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md
 What to commit:
 
 ```bash
-node ".agent/mindforge/bin/mindforge-tools.cjs" commit "docs({phase}-{plan}): complete [plan-name] plan" --files .planning/phases/XX-name/{phase}-{plan}-PLAN.md .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .planning/STATE.md .planning/ROADMAP.md
+node ".agent/bin/mindforge-tools.cjs" commit "docs({phase}-{plan}): complete [plan-name] plan" --files .planning/phases/XX-name/{phase}-{plan}-PLAN.md .planning/phases/XX-name/{phase}-{plan}-SUMMARY.md .planning/STATE.md .planning/ROADMAP.md
 ```
 
 **Note:** Code files NOT included - already committed per-task.
@@ -153,7 +153,7 @@ Current: [task name]
 What to commit:
 
 ```bash
-node ".agent/mindforge/bin/mindforge-tools.cjs" commit "wip: [phase-name] paused at task [X]/[Y]" --files .planning/
+node ".agent/bin/mindforge-tools.cjs" commit "wip: [phase-name] paused at task [X]/[Y]" --files .planning/
 ```
 
 </format>
@@ -284,7 +284,7 @@ Set `commit_docs: false` so planning docs stay local and are not committed to an
 Instead of the standard `commit` command, use `commit-to-subrepo` when `sub_repos` is configured:
 
 ```bash
-node .agent/mindforge/bin/mindforge-tools.cjs commit-to-subrepo "feat(02-01): add user API" \
+node .agent/bin/mindforge-tools.cjs commit-to-subrepo "feat(02-01): add user API" \
   --files backend/src/api/users.ts backend/src/types/user.ts frontend/src/components/UserForm.tsx
 ```
 

package/docs/References/git-planning-commit.md

@@ -7,7 +7,7 @@ Commit planning artifacts using MindForge-tools CLI, which automatically checks
 Always use `mindforge-tools.cjs commit` for `.planning/` files — it handles `commit_docs` and gitignore checks automatically:
 
 ```bash
-node ".agent/mindforge/bin/mindforge-tools.cjs" commit "docs({scope}): {description}" --files .planning/STATE.md .planning/ROADMAP.md
+node ".agent/bin/mindforge-tools.cjs" commit "docs({scope}): {description}" --files .planning/STATE.md .planning/ROADMAP.md
 ```
 
 The CLI will return `skipped` (with reason) if `commit_docs` is `false` or `.planning/` is gitignored. No manual conditional checks needed.
@@ -17,7 +17,7 @@ The CLI will return `skipped` (with reason) if `commit_docs` is `false` or `.pla
 To fold `.planning/` file changes into the previous commit:
 
 ```bash
-node ".agent/mindforge/bin/mindforge-tools.cjs" commit "" --files .planning/codebase/*.md --amend
+node ".agent/bin/mindforge-tools.cjs" commit "" --files .planning/codebase/*.md --amend
 ```
 
 ## Commit Message Patterns

package/docs/References/model-profile-resolution.md

@@ -12,7 +12,7 @@ Default: `balanced` if not set or config missing.
 
 ## Lookup Table
 
-@.agent/mindforge/references/model-profiles.md
+@docs/References/model-profiles.md
 
 Look up MindForge in the table for the resolved profile. Pass the model parameter to Task calls:
 

package/docs/faq.md

@@ -1,4 +1,4 @@
-# MindForge FAQ (v11.9.5)
+# MindForge FAQ (v11.9.7)
 
 ## Is MindForge tied to Claude only?
 No. MindForge supports Claude Code and Antigravity. Install with `--claude`,
@@ -55,7 +55,7 @@ The `deep-research` workflow was removed before the v11.8.0 release (the superpo
 ## Version & Stability
 
 **Q: What version is current?**
-v11.9.5 — verify with `node bin/mindforge-cli.js --version`
+v11.9.7 — verify with `node bin/mindforge-cli.js --version`
 
 **Q: Is v11.9.0 production-stable?**
 Yes. The IQ200 deep-audit (258 discrete checks across 14 dimensions) shows 258/258 passing. 0 CVEs, 0 test failures, 0 ESLint errors, 0 TypeScript errors.
@@ -80,8 +80,9 @@ Spawn dispatch is not yet implemented in v11.9.0. Use `/mindforge:auto` or `/min
 Tier-3 trust uses in-process key simulation in v11.9.0 — this is intentional and safe. `SECURITY_TIER_3_SIMULATED = true` is the documented v11.x behavior. Hardware TPM/HSM is planned for v12.x.
 
 **Q: What is the test coverage?**
-135 test files: 133 pass, 0 failures, 2 env-dependent skips (`browser.test.js` needs a Chromium
-daemon, `sre-integration.test.js` needs git worktree support and a clean tree).
+140 test files: 137 pass, 0 failures, 3 env-dependent skips (`browser.test.js` and
+`browser-daemon-auth-live.test.js` need a Chromium daemon, `sre-integration.test.js` needs git
+worktree support and a clean tree).
 
 The enforced floor is **30% lines**, gated in CI by the `mindforge-quality` job
 (`npx c8 --check-coverage --lines 30 --exclude 'plugins/**' --exclude 'mcp-server/dist/**'`).

package/docs/getting-started.md

@@ -1,4 +1,4 @@
-# MindForge — Getting Started (v11.9.5)
+# MindForge — Getting Started (v11.9.7)
 
 This guide gets you from zero to a working MindForge project in under five minutes.
 
@@ -48,7 +48,7 @@ Prefer just a slice (e.g. Python agents)? Install a focused pack like `mindforge
 
 ### 3. Standalone MCP server
 
-Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes 7 tools (6 read-only plus 1 guarded write): `mindforge_health`, `mindforge_status`, `mindforge_memory_query`, `mindforge_memory_stats`, `mindforge_memory_find_related`, `mindforge_audit_log`, and `mindforge_memory_remember`.
+Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes 8 tools (6 read-only, 1 guarded write, plus 1 guarded browse proxy): `mindforge_health`, `mindforge_status`, `mindforge_memory_query`, `mindforge_memory_stats`, `mindforge_memory_find_related`, `mindforge_audit_log`, `mindforge_memory_remember`, and `mindforge_browse`.
 
 ```bash
 claude mcp add mindforge -- npx -y mindforge-mcp-server
@@ -114,7 +114,7 @@ Or use slash commands: `/mindforge:wf-code-audit`
 ## Your First 5 Minutes with MindForge
 
 1. **Verify install:** `node bin/mindforge-cli.js health`
-2. **Check version:** `node bin/mindforge-cli.js --version` (should print `11.9.5`)
+2. **Check version:** `node bin/mindforge-cli.js --version` (should print `11.9.7`)
 3. **List workflows:** `node bin/mindforge-cli.js workflow list`
 4. **Run first slash command:** Open Claude Code → `/mindforge:status`
 5. **Onboard your codebase:** Open Claude Code → `/mindforge:wf-onboard-codebase`

package/docs/sdk-reference.md

@@ -14,11 +14,11 @@ import {
 } from 'mindforge-sdk';
 ```
 
-Current SDK version: `11.9.5`
+Current SDK version: `11.9.7`
 
 ---
 
-## SDK Exports (v11.9.5)
+## SDK Exports (v11.9.7)
 
 ```javascript
 const {
@@ -28,7 +28,7 @@ const {
   commands,               // Command registry
   batch,                  // Batch execution
   MindForgeMemory,        // Memory interface
-  VERSION                 // '11.9.5'
+  VERSION                 // '11.9.7'
 } = require('mindforge-sdk');
 // or: import { MindForgeClient, VERSION } from 'mindforge-sdk';
 ```

package/docs/troubleshooting.md

@@ -1,4 +1,4 @@
-# MindForge Troubleshooting (v11.9.5)
+# MindForge Troubleshooting (v11.9.7)
 
 This page lists common issues and fast fixes. If you get stuck, start with
 `/mindforge:health`.

package/docs/user-guide.md

@@ -1,8 +1,8 @@
-# MindForge User Guide (v11.9.5)
+# MindForge User Guide (v11.9.7)
 
 This guide gets you from install to productive, with the minimum needed to run MindForge in a real project.
 
-> **v11.9.5 Stats:** 35 workflows · 221 slash commands · 232 engine skills · 216 personas · 0 CVEs · 258/258 IQ200 checks passing
+> **v11.9.7 Stats:** 35 workflows · 221 slash commands · 232 engine skills · 216 personas · 0 CVEs · 258/258 IQ200 checks passing
 
 ## Prerequisites
 
@@ -44,7 +44,7 @@ mindforge health          # Verify project integrity
 mindforge security-scan   # Run security checks
 mindforge headless        # Run agent in non-interactive mode
 mindforge --verbose ...   # Enable verbose output for debugging
-mindforge --version       # Print installed version (e.g. 11.9.5) and exit 0
+mindforge --version       # Print installed version (e.g. 11.9.7) and exit 0
 ```
 
 Use `--verbose` (or `-v`) on any command for detailed diagnostic output. Use `--version` (or `-V`) to print the installed version and exit.

package/examples/sdk-integration/index.js

@@ -1,4 +1,4 @@
-const { MindForgeClient, MindForgeEventStream } = require('@mindforge/sdk');
+const { MindForgeClient, MindForgeEventStream } = require('mindforge-sdk');
 
 async function main() {
   const client = new MindForgeClient();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mindforge-cc",
-  "version": "11.9.5",
-  "description": "MindForge — Sovereign Agentic Intelligence Framework. Sovereign Stability: Production-Hardened Agentic Intelligence (v11)",
+  "version": "11.9.7",
+  "description": "Agentic intelligence framework for Claude Code and Antigravity: slash commands, subagents, skills, hooks, governance, memory, and cost-aware model routing for AI-driven development.",
   "bin": {
     "mindforge-cc": "bin/install.js",
     "mindforge": "bin/mindforge-cli.js"
@@ -85,7 +85,10 @@
     "wasm-sqlite",
     "zero-native-deps",
     "agent-orchestration",
-    "sovereign-ai"
+    "ai-agents",
+    "llm-tools",
+    "developer-tools",
+    "mcp-server"
   ],
   "author": "sairamugge",
   "license": "MIT",