@putervision/agent-reasoning-mcp 0.1.1

package/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing to PuterVision
+
+We welcome contributions! Please make sure that all PRs pass tests and formatting checks:
+
+```bash
+npm run ci
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PuterVision
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PROJECT_INSTRUCTIONS_TEMPLATE.md

@@ -0,0 +1,9 @@
+# Agent Instructions for agent-reasoning-mcp
+
+This project uses `@putervision/agent-reasoning-mcp` for strategic BDI reasoning.
+
+## Mandatory Workflow
+1. **Goals**: Call `set_goal(create)` before beginning complex work.
+2. **Evaluation**: Call `evaluate_situation(snapshot)` to score trade-offs against active utility weights.
+3. **Intentions**: Dispatch execution directives with `manage_intentions(create)` for runtime execution.
+4. **Replanning**: If blocked, call `replan(blocker)` to generate fallback DAGs.

package/README.md

@@ -0,0 +1,95 @@
+# @putervision/agent-reasoning-mcp
+
+[![npm version](https://img.shields.io/npm/v/@putervision/agent-reasoning-mcp.svg)](https://www.npmjs.com/package/@putervision/agent-reasoning-mcp)
+[![CI](https://github.com/putervision/agent-reasoning-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/putervision/agent-reasoning-mcp/actions/workflows/ci.yml)
+[![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+> **Strategic BDI Reasoning, Multi-Attribute Expected Utility Theory & Decision Intelligence for Autonomous AI Agents**
+
+`@putervision/agent-reasoning-mcp` is a formal Model Context Protocol (MCP) server that provides strategic belief-desire-intention (BDI) reasoning, hierarchical goal decomposition, multi-attribute expected utility calculation (\(E[U] = \sum w_i u_i\)), exponential belief decay, quantitative risk evaluation, and reactive replanning across multi-modal memory bridges.
+
+🌐 **Official Documentation**: [putervision.com](https://putervision.com) • [Interactive Web Docs](docs/index.html)
+
+---
+
+## ⚡ 15-Second Quick Start
+
+```bash
+# 1. Initialize reasoning database & seed default utility profiles
+npx @putervision/agent-reasoning-mcp init
+
+# 2. Run health diagnostics and Merkle audit checks
+npx @putervision/agent-reasoning-mcp doctor
+
+# 3. Inspect active goals, intentions, and belief states
+npx @putervision/agent-reasoning-mcp inspect
+```
+
+---
+
+## 🛠️ 10 Core MCP Tools
+
+| Tool | Actions | Purpose |
+|------|---------|---------|
+| `set_goal` | `create`, `update`, `decompose`, `get`, `list`, `abandon` | Manage goal hierarchy, task DAGs, and success criteria |
+| `evaluate_situation` | `snapshot`, `quick` | Score and rank candidate actions from environment snapshots |
+| `replan` | `blocker`, `event`, `full` | Adaptively reconstruct subgoals upon obstacles and abort stale intentions |
+| `assess_risk` | `action`, `plan`, `compare` | Quantitative threat and risk calculation across candidate actions |
+| `query_knowledge` | `search`, `patterns`, `similar_situations` | Search learned heuristics, tactical knowledge, and past decision patterns |
+| `set_utility_weights` | `configure`, `get`, `list`, `activate` | Configure utility weights (aggression, caution, greed, efficiency, exploration) |
+| `get_decision_trace` | `latest`, `get`, `list`, `explain` | Explainable chain-of-thought rationale and latency telemetry |
+| `manage_beliefs` | `update`, `query`, `expire`, `reconcile` | Structured belief state with exponential confidence decay ($C = C_0 e^{-\lambda t}$) |
+| `manage_intentions` | `create`, `dispatch`, `get`, `list`, `cancel`, `resolve` | Wire contract directives queue for runtime execution engines |
+| `manage_reasoning_db` | `stats`, `audit`, `snapshot`, `restore` | Reasoning database statistics, SHA-256 Merkle audit, and snapshot rollback |
+
+---
+
+## 🏛️ PuterVision Pentad Multi-Modal Ecosystem
+
+`agent-reasoning-mcp` coordinates the closed-loop **PuterVision Super-Loop**:
+- 🧠 **`agent-reasoning-mcp`**: Decides *what* to do (BDI Strategic Reasoning, Utility Theory, Replanning)
+- ⚡ **`behavior-mcp`**: Executes *how* to act at ~60Hz in browser runtimes
+- 📊 **`state-memory-mcp`**: Durable workflow memory, tasks, blockers, decisions
+- 👁️ **`vision-memory-mcp`**: Perceptual caching, visual grounding, video timelines
+- 🌐 **`world-model-mcp`**: 3D/2D spatial layout, entity permanence, collision simulation
+
+---
+
+## 📚 Deep Documentation Guides
+
+- 📖 **[Formal API Reference](docs/api-reference.md)**: Full parameter tables, type definitions, and tool schemas.
+- 💡 **[Core Architecture & Concepts](docs/concepts.md)**: BDI model, utility formulation, and belief decay dynamics.
+- 🖥️ **[CLI Usage Guide](docs/cli-usage.md)**: Complete CLI command reference (`init`, `doctor`, `inspect`, `run`).
+- 💾 **[Database Schema](docs/database-schema.md)**: SQLite table structures, indexes, and Merkle audit ledger.
+- ⚙️ **[Configuration Reference](docs/configuration.md)**: `.agent-reasoning-mcp.json` parameters and environment variables.
+
+---
+
+## 🔗 Client Configuration
+
+Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "agent-reasoning-mcp": {
+      "command": "agent-reasoning-mcp",
+      "args": ["run"]
+    }
+  }
+}
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+# Run full unit and integration test suite across 16 test files (68 tests)
+npm test
+```
+
+---
+
+## 📄 License
+MIT © PuterVision

package/SECURITY.md

@@ -0,0 +1,11 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.1.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it via private security advisory on GitHub or email security@putervision.org. Please do not open public issues for security vulnerabilities.

package/dist/chunk-2UKYRERH.js

@@ -0,0 +1,403 @@
+import {
+  KnowledgeEngine,
+  UtilityProfileEngine,
+  verifyEventChain
+} from "./chunk-6CYLIFQX.js";
+import {
+  getDb,
+  getProjectSlug,
+  logger,
+  registerProject,
+  resolveProjectRoot
+} from "./chunk-F4TEZ2TS.js";
+
+// src/cli/init.ts
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+
+// src/cli/templates.ts
+function getAgentsMdTemplate(projectSlug = "default") {
+  return `<!-- agent-reasoning-mcp:start -->
+# Strategic Agent Reasoning (agent-reasoning-mcp)
+
+This project uses \`agent-reasoning-mcp\` with project slug "${projectSlug}" to manage goals, decompose complex tasks, evaluate situational trade-offs, and track decision rationale.
+
+## Mandatory Reasoning Workflow
+1. **Start of planning**: Call \`set_goal(action: "create", title: "...")\` to establish high-level objectives.
+2. **Decomposition**: Call \`set_goal(action: "decompose", parent_id: "...", subgoals: [...])\` to break down into actionable steps.
+3. **Situational Trade-offs**: Call \`evaluate_situation(action: "snapshot", snapshot: {...})\` before selecting high-stakes actions.
+4. **Utility Configuration**: Tune agent priorities with \`set_utility_weights(action: "configure", weights: {...})\`.
+5. **Intention Dispatch**: Create execution directives with \`manage_intentions(action: "create", ...)\` for the runtime engine.
+6. **Reactive Replanning**: If an unexpected blocker occurs, invoke \`replan(action: "blocker", goal_id: "...", blocker_description: "...")\`.
+
+## 10 Core MCP Tools
+- \`set_goal\`: Manage goal hierarchy and task DAGs.
+- \`evaluate_situation\`: Score and rank candidate actions from environment snapshots.
+- \`replan\`: Adaptively reconstruct subgoals upon obstacles.
+- \`assess_risk\`: Quantitative threat and risk calculation.
+- \`query_knowledge\`: Search heuristics and past decision patterns.
+- \`set_utility_weights\`: Configure utility weights (aggression, caution, greed, exploration).
+- \`get_decision_trace\`: Explainable chain-of-thought rationale playback.
+- \`manage_beliefs\`: Structured belief state with exponential confidence decay.
+- \`manage_intentions\`: Wire contract directives queue for runtime execution.
+- \`manage_reasoning_db\`: Snapshots, diagnostics, and SHA-256 Merkle audit verification.
+<!-- agent-reasoning-mcp:end -->
+`;
+}
+function getInstructionsTemplate(projectSlug) {
+  return getAgentsMdTemplate(projectSlug);
+}
+function getGlobalRulesTemplate(projectSlug) {
+  return `<!-- agent-reasoning-mcp:start -->
+# Strategic Agent Reasoning (agent-reasoning-mcp)
+
+This project uses agent-reasoning-mcp with project slug "${projectSlug}" for BDI decision intelligence.
+ALWAYS evaluate situation snapshots against active utility weights before taking high-stakes actions.
+
+## Mandatory Workflow
+1. **Goals**: Call \`set_goal\` to track objectives.
+2. **Evaluation**: Call \`evaluate_situation\` for candidate action scoring.
+3. **Intentions**: Dispatch execution directives via \`manage_intentions\`.
+4. **Replanning**: Call \`replan\` when blocked.
+<!-- agent-reasoning-mcp:end -->
+`;
+}
+function getMcpConfigCursor(projectSlug) {
+  return {
+    mcpServers: {
+      "agent-reasoning-mcp": {
+        command: "agent-reasoning-mcp",
+        args: ["run"],
+        env: {
+          REASONING_PROJECT: projectSlug
+        }
+      }
+    }
+  };
+}
+function getMcpConfigVscode(projectSlug) {
+  return {
+    servers: {
+      "agent-reasoning-mcp": {
+        type: "stdio",
+        command: "agent-reasoning-mcp",
+        args: ["run"],
+        env: {
+          REASONING_PROJECT: projectSlug
+        }
+      }
+    }
+  };
+}
+function getMcpConfigAntigravity() {
+  return {
+    mcpServers: {
+      "agent-reasoning-mcp": {
+        command: "agent-reasoning-mcp",
+        args: ["run"]
+      }
+    }
+  };
+}
+function getSkillTemplate(projectSlug) {
+  return `---
+name: agent-reasoning-mcp
+description: Teaches the agent to use the Strategic Agent Reasoning MCP server for BDI goals, utility scoring, risk evaluation, and replanning.
+---
+
+# Strategic Agent Reasoning (agent-reasoning-mcp)
+
+This skill provides step-by-step guidance and operational patterns for interacting with \`@putervision/agent-reasoning-mcp\` with project slug \`"${projectSlug}"\`.
+
+---
+
+## 1. Role in the PuterVision Pentad
+- **Workflow State** (\`state-memory-mcp\`): Persistent task DAGs, decisions, milestones, and blockers.
+- **Perception** (\`vision-memory-mcp\`): Visual layout caching, screenshots, and visual specifications.
+- **Spatial World** (\`world-model-mcp\`): Persistent 3D/2D coordinates, bounding boxes, and topological relations.
+- **Strategic Reasoning** (\`agent-reasoning-mcp\`): BDI goal decomposition, multi-attribute expected utility calculation, belief decay, risk assessment, and replanning.
+- **Tactical Execution** (\`behavior-mcp\`): Deterministic ~60Hz browser behavior tree execution and reactive preemption.
+
+---
+
+## 2. Core Operational Sequence
+1. **Initialize Objectives**: Call \`set_goal\` with \`action: "create"\` to define top-level goals and \`action: "decompose"\` to establish subgoals.
+2. **Configure Utility Profile**: Tune agent priorities using \`set_utility_weights\` (aggression, caution, greed, exploration).
+3. **Situational Trade-off Scoring**: Call \`evaluate_situation\` with \`action: "snapshot"\` to rank candidate actions using Pareto utility theory.
+4. **Intention Dispatch**: Translate chosen action into an execution directive via \`manage_intentions\`.
+5. **Reactive Replanning**: If an unexpected obstacle or blocker emerges, invoke \`replan\`.
+
+---
+
+## 3. Complete 10 Consolidated MCP Tools Reference
+
+| Tool Name | Key Actions | Key Parameters | Description |
+|---|---|---|---|
+| \`set_goal\` | \`create\`, \`update\`, \`get\`, \`list\`, \`decompose\`, \`archive\` | \`title\`, \`description\`, \`priority\`, \`parent_id\`, \`subgoals\` | Hierarchical BDI goal management and task DAG decomposition. |
+| \`evaluate_situation\` | \`snapshot\`, \`quick\` | \`snapshot\`, \`candidates\`, \`utility_profile\` | Multi-attribute utility evaluation ranking candidate actions from environment state. |
+| \`replan\` | \`blocker\`, \`recovery\`, \`alternative\` | \`goal_id\`, \`blocker_description\`, \`strategy\` | Adaptive DAG reconstruction and alternative path discovery upon obstacles. |
+| \`assess_risk\` | \`assess\`, \`matrix\` | \`hazards\`, \`tolerance\`, \`mitigations\` | Quantitative threat matrix and probabilistic risk scoring. |
+| \`query_knowledge\` | \`search\`, \`lookup\`, \`heuristics\` | \`query\`, \`category\`, \`tags\` | Knowledge retrieval of past decision heuristics and domain heuristics. |
+| \`set_utility_weights\` | \`configure\`, \`get\`, \`list\`, \`profile\` | \`name\`, \`weights\` (aggression, caution, greed, exploration) | Utility weight tuning and personality profile management. |
+| \`get_decision_trace\` | \`get\`, \`list\`, \`explain\` | \`trace_id\`, \`limit\` | Explainable chain-of-thought rationale playback and auditing. |
+| \`manage_beliefs\` | \`set\`, \`get\`, \`decay\`, \`list\` | \`key\`, \`value\`, \`confidence\`, \`decay_rate\` | Structured belief state with temporal exponential confidence decay. |
+| \`manage_intentions\` | \`create\`, \`get\`, \`list\`, \`dispatch\`, \`cancel\` | \`goal_id\`, \`behavior_name\`, \`parameters\` | Execution directives queue connecting strategic plans to runtime engines. |
+| \`manage_reasoning_db\` | \`stats\`, \`audit\`, \`snapshot\`, \`restore\`, \`prune\` | \`action\`, \`name\`, \`description\` | Database diagnostics, snapshots, and SHA-256 Merkle audit verification. |
+`;
+}
+
+// src/cli/init.ts
+function upsertInstructionBlock(content, newBlock, startMarker = "<!-- agent-reasoning-mcp:start -->", endMarker = "<!-- agent-reasoning-mcp:end -->") {
+  const startIndex = content.indexOf(startMarker);
+  const endIndex = content.indexOf(endMarker);
+  if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
+    const before = content.substring(0, startIndex);
+    const after = content.substring(endIndex + endMarker.length);
+    const existingBlock = content.substring(startIndex, endIndex + endMarker.length);
+    if (existingBlock.trim() === newBlock.trim()) {
+      return { updatedContent: content, status: "unchanged" };
+    }
+    return { updatedContent: `${before}${newBlock.trim()}${after}`, status: "updated" };
+  }
+  const separator = content.endsWith("\n") ? "\n" : "\n\n";
+  return { updatedContent: `${content}${separator}${newBlock.trim()}
+`, status: "appended" };
+}
+function mergeMcpConfig(root, relativePath, label, template, serversKey) {
+  const filePath = path.join(root, relativePath);
+  const dir = path.dirname(filePath);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  if (fs.existsSync(filePath)) {
+    try {
+      const raw = fs.readFileSync(filePath, "utf-8");
+      const existing = JSON.parse(raw);
+      if (existing[serversKey]?.["agent-reasoning-mcp"]) {
+        return;
+      }
+      if (!existing[serversKey]) existing[serversKey] = {};
+      existing[serversKey]["agent-reasoning-mcp"] = template[serversKey]["agent-reasoning-mcp"];
+      fs.writeFileSync(filePath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+    } catch {
+      fs.writeFileSync(filePath, JSON.stringify(template, null, 2) + "\n", "utf-8");
+    }
+  } else {
+    fs.writeFileSync(filePath, JSON.stringify(template, null, 2) + "\n", "utf-8");
+  }
+}
+function runInit(options = {}) {
+  const cwd = options.cwd || process.cwd();
+  const root = options.project ? resolveProjectRoot(options.project, cwd) : path.resolve(cwd);
+  const slug = options.project ? getProjectSlug(options.project, cwd) : getProjectSlug(void 0, root);
+  console.log("\n\u{1F9E0} Initializing agent-reasoning-mcp...\n");
+  registerProject(slug, root);
+  console.log(`   \u{1F4C1} Registered project "${slug}" in global registry (${root})`);
+  const dataDir = path.join(root, ".agent-reasoning-mcp", slug);
+  if (!fs.existsSync(dataDir)) {
+    fs.mkdirSync(dataDir, { recursive: true, mode: 448 });
+  }
+  console.log(`   \u{1F4E6} Created local storage directory: .agent-reasoning-mcp/${slug}`);
+  const gitignorePath = path.join(root, ".gitignore");
+  const ignoreEntry = ".agent-reasoning-mcp";
+  if (fs.existsSync(gitignorePath)) {
+    const content = fs.readFileSync(gitignorePath, "utf-8");
+    if (!content.includes(ignoreEntry)) {
+      fs.appendFileSync(gitignorePath, `
+${ignoreEntry}
+`, "utf-8");
+      console.log(`   \u{1F6E1}\uFE0F  Updated .gitignore (${ignoreEntry})`);
+    }
+  }
+  const instructions = getInstructionsTemplate(slug);
+  const targets = [
+    ".agents/AGENTS.md",
+    "CLAUDE.md",
+    ".windsurfrules",
+    ".cursor/rules/agent-reasoning-mcp.mdc",
+    ".gemini/instructions.md",
+    ".vscode/instructions.md",
+    ".github/copilot-instructions.md"
+  ];
+  console.log("   \u{1F4DD} Scaffolding agent instruction contracts:");
+  for (const t of targets) {
+    const fullPath = path.join(root, t);
+    const dir = path.dirname(fullPath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    if (fs.existsSync(fullPath)) {
+      const content = fs.readFileSync(fullPath, "utf-8");
+      const { updatedContent, status } = upsertInstructionBlock(content, instructions);
+      fs.writeFileSync(fullPath, updatedContent, "utf-8");
+      console.log(`      - ${t} (${status})`);
+    } else {
+      fs.writeFileSync(fullPath, instructions.trim() + "\n", "utf-8");
+      console.log(`      - ${t} (created)`);
+    }
+  }
+  const skillContent = getSkillTemplate(slug);
+  const localSkillDir = path.join(root, ".agents/skills/agent-reasoning-mcp");
+  if (!fs.existsSync(localSkillDir)) fs.mkdirSync(localSkillDir, { recursive: true });
+  fs.writeFileSync(path.join(localSkillDir, "SKILL.md"), skillContent, "utf-8");
+  const homedir2 = os.homedir();
+  const globalSkillDir = path.join(homedir2, ".gemini/config/skills/agent-reasoning-mcp");
+  try {
+    if (!fs.existsSync(globalSkillDir)) fs.mkdirSync(globalSkillDir, { recursive: true });
+    fs.writeFileSync(path.join(globalSkillDir, "SKILL.md"), skillContent, "utf-8");
+  } catch {
+  }
+  console.log("   \u{1F9E0} Installed Antigravity agent skill at: .agents/skills/agent-reasoning-mcp");
+  mergeMcpConfig(root, ".cursor/mcp.json", "Cursor", getMcpConfigCursor(slug), "mcpServers");
+  mergeMcpConfig(root, ".vscode/mcp.json", "VS Code", getMcpConfigVscode(slug), "servers");
+  const windsurfDir = path.join(root, ".windsurf");
+  if (fs.existsSync(windsurfDir)) {
+    mergeMcpConfig(root, ".windsurf/mcp.json", "Windsurf", getMcpConfigCursor(slug), "mcpServers");
+  }
+  const claudeDir = process.platform === "darwin" ? path.join(homedir2, "Library", "Application Support", "Claude") : process.platform === "win32" ? path.join(process.env.APPDATA || path.join(homedir2, "AppData", "Roaming"), "Claude") : path.join(homedir2, ".config", "Claude");
+  if (fs.existsSync(claudeDir)) {
+    mergeMcpConfig(
+      claudeDir,
+      "claude_desktop_config.json",
+      "Claude Desktop",
+      getMcpConfigCursor(slug),
+      "mcpServers"
+    );
+  }
+  const globalMcpConfig = path.join(homedir2, ".gemini/config/mcp_config.json");
+  try {
+    if (fs.existsSync(path.dirname(globalMcpConfig))) {
+      mergeMcpConfig(
+        homedir2,
+        ".gemini/config/mcp_config.json",
+        "Antigravity",
+        getMcpConfigAntigravity(),
+        "mcpServers"
+      );
+    }
+    const geminiConfigJson = path.join(homedir2, ".gemini/config/config.json");
+    if (fs.existsSync(geminiConfigJson)) {
+      try {
+        const raw = fs.readFileSync(geminiConfigJson, "utf-8");
+        const data = JSON.parse(raw);
+        if (data.userSettings?.globalPermissionGrants?.allow) {
+          let updated = false;
+          for (const perm of ["command(agent-reasoning-mcp)"]) {
+            if (!data.userSettings.globalPermissionGrants.allow.includes(perm)) {
+              data.userSettings.globalPermissionGrants.allow.push(perm);
+              updated = true;
+            }
+          }
+          if (updated) {
+            fs.writeFileSync(geminiConfigJson, JSON.stringify(data, null, 2) + "\n", "utf-8");
+            console.log(
+              "      \u2705 Google Antigravity (config.json) \u2014 granted command(agent-reasoning-mcp)"
+            );
+          }
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+  console.log(
+    "   \u{1F50C} Configured IDE MCP Servers (Cursor, VS Code, Windsurf, Claude Desktop, Antigravity)"
+  );
+  const globalTargets = [
+    { path: path.join(homedir2, ".cursorrules"), label: "Global Cursor Rules (~/.cursorrules)" },
+    {
+      path: path.join(homedir2, ".gemini/GEMINI.md"),
+      label: "Global Gemini Rules (~/.gemini/GEMINI.md)"
+    }
+  ];
+  const globalRulesText = getGlobalRulesTemplate(slug);
+  for (const target of globalTargets) {
+    if (target.path.includes(".gemini") && !fs.existsSync(path.dirname(target.path))) {
+      continue;
+    }
+    if (fs.existsSync(target.path)) {
+      const content = fs.readFileSync(target.path, "utf-8");
+      const { updatedContent, status } = upsertInstructionBlock(content, globalRulesText);
+      if (status !== "unchanged") {
+        fs.writeFileSync(target.path, updatedContent, "utf-8");
+        console.log(`      \u2705 ${target.label} \u2014 ${status} rules`);
+      }
+    } else {
+      fs.writeFileSync(target.path, globalRulesText, "utf-8");
+      console.log(`      \u2705 ${target.label} \u2014 created`);
+    }
+  }
+  const db = getDb(slug, root);
+  console.log("   \u{1F4BE} Initialized SQLite database with WAL mode & SHA-256 Merkle audit chain");
+  const profiles = UtilityProfileEngine.listProfiles(db, slug);
+  if (profiles.length <= 1) {
+    UtilityProfileEngine.configureProfile(db, {
+      project: slug,
+      name: "aggressive",
+      description: "High combat and threat engagement bias",
+      weights: {
+        aggression: 0.9,
+        caution: 0.2,
+        greed: 0.5,
+        efficiency: 0.8,
+        exploration: 0.6,
+        cooperation: 0.4
+      }
+    });
+    UtilityProfileEngine.configureProfile(db, {
+      project: slug,
+      name: "cautious",
+      description: "High defense and risk aversion bias",
+      weights: {
+        aggression: 0.1,
+        caution: 0.95,
+        greed: 0.3,
+        efficiency: 0.7,
+        exploration: 0.4,
+        cooperation: 0.8
+      }
+    });
+    console.log("   \u{1F331} Seeded standard utility scoring profiles (balanced, aggressive, cautious)");
+  }
+  const seededPatterns = KnowledgeEngine.seedDefaultPatterns(db, slug);
+  if (seededPatterns > 0) {
+    console.log(`   \u{1F331} Seeded ${seededPatterns} tactical gaming & navigation knowledge patterns`);
+  }
+  const audit = verifyEventChain(db, slug);
+  console.log(
+    `   \u{1F50D} Audited cryptographic event ledger: ${audit.valid ? "\u2705 Unbroken SHA-256 chain" : "\u26A0\uFE0F Verification anomaly"}`
+  );
+  console.log(`
+\u2728 agent-reasoning-mcp initialized successfully for "${slug}"!`);
+  console.log('   Run "agent-reasoning-mcp doctor" to verify runtime health.');
+  console.log('   Run "agent-reasoning-mcp inspect" to view goals, beliefs, and traces.\n');
+}
+async function runAutoInit(root, projectSlug) {
+  const originalLog = console.log;
+  console.log = (...args) => console.error(...args);
+  try {
+    runInit({ project: projectSlug, cwd: root });
+  } catch (err) {
+    logger.warn(`Auto-init skipped: ${err.message}`);
+  } finally {
+    console.log = originalLog;
+  }
+}
+async function runInitGlobal() {
+  const { getRegistry } = await import("./db-EL7JURVI.js");
+  const registry = getRegistry();
+  const entries = Object.entries(registry);
+  console.log(`Running global init across ${entries.length} registered project(s)...`);
+  for (const [slug, projectRoot] of entries) {
+    if (fs.existsSync(projectRoot)) {
+      console.log(`  - ${slug}: ${projectRoot}`);
+      runInit({ project: slug, cwd: projectRoot });
+    }
+  }
+  console.log("Global init complete.");
+}
+
+export {
+  upsertInstructionBlock,
+  runInit,
+  runAutoInit,
+  runInitGlobal
+};
+//# sourceMappingURL=chunk-2UKYRERH.js.map

package/dist/chunk-2UKYRERH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/init.ts","../src/cli/templates.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { logger } from '../utils/logger.js';\nimport {\n  getAgentsMdTemplate,\n  getInstructionsTemplate,\n  getGlobalRulesTemplate,\n  getMcpConfigCursor,\n  getMcpConfigVscode,\n  getMcpConfigAntigravity,\n  getSkillTemplate,\n} from './templates.js';\nimport { registerProject, resolveProjectRoot, getProjectSlug, getDb } from '../engine/db.js';\nimport { UtilityProfileEngine } from '../engine/personality.js';\nimport { KnowledgeEngine } from '../engine/knowledge.js';\nimport { verifyEventChain } from '../engine/events.js';\n\nexport function upsertInstructionBlock(\n  content: string,\n  newBlock: string,\n  startMarker = '<!-- agent-reasoning-mcp:start -->',\n  endMarker = '<!-- agent-reasoning-mcp:end -->'\n): { updatedContent: string; status: 'updated' | 'appended' | 'unchanged' } {\n  const startIndex = content.indexOf(startMarker);\n  const endIndex = content.indexOf(endMarker);\n\n  if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {\n    const before = content.substring(0, startIndex);\n    const after = content.substring(endIndex + endMarker.length);\n    const existingBlock = content.substring(startIndex, endIndex + endMarker.length);\n    if (existingBlock.trim() === newBlock.trim()) {\n      return { updatedContent: content, status: 'unchanged' };\n    }\n    return { updatedContent: `${before}${newBlock.trim()}${after}`, status: 'updated' };\n  }\n\n  const separator = content.endsWith('\\n') ? '\\n' : '\\n\\n';\n  return { updatedContent: `${content}${separator}${newBlock.trim()}\\n`, status: 'appended' };\n}\n\nfunction mergeMcpConfig(\n  root: string,\n  relativePath: string,\n  label: string,\n  template: Record<string, any>,\n  serversKey: string\n): void {\n  const filePath = path.join(root, relativePath);\n  const dir = path.dirname(filePath);\n  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });\n\n  if (fs.existsSync(filePath)) {\n    try {\n      const raw = fs.readFileSync(filePath, 'utf-8');\n      const existing = JSON.parse(raw);\n      if (existing[serversKey]?.['agent-reasoning-mcp']) {\n        return;\n      }\n      if (!existing[serversKey]) existing[serversKey] = {};\n      existing[serversKey]['agent-reasoning-mcp'] = template[serversKey]['agent-reasoning-mcp'];\n      fs.writeFileSync(filePath, JSON.stringify(existing, null, 2) + '\\n', 'utf-8');\n    } catch {\n      fs.writeFileSync(filePath, JSON.stringify(template, null, 2) + '\\n', 'utf-8');\n    }\n  } else {\n    fs.writeFileSync(filePath, JSON.stringify(template, null, 2) + '\\n', 'utf-8');\n  }\n}\n\nexport function runInit(options: { project?: string; cwd?: string } = {}): void {\n  const cwd = options.cwd || process.cwd();\n  const root = options.project ? resolveProjectRoot(options.project, cwd) : path.resolve(cwd);\n  const slug = options.project\n    ? getProjectSlug(options.project, cwd)\n    : getProjectSlug(undefined, root);\n\n  console.log('\\n🧠 Initializing agent-reasoning-mcp...\\n');\n\n  // 1. Register project in global registry\n  registerProject(slug, root);\n  console.log(`   📁 Registered project \"${slug}\" in global registry (${root})`);\n\n  // 2. Create local storage directory\n  const dataDir = path.join(root, '.agent-reasoning-mcp', slug);\n  if (!fs.existsSync(dataDir)) {\n    fs.mkdirSync(dataDir, { recursive: true, mode: 0o700 });\n  }\n  console.log(`   📦 Created local storage directory: .agent-reasoning-mcp/${slug}`);\n\n  // 3. Update .gitignore\n  const gitignorePath = path.join(root, '.gitignore');\n  const ignoreEntry = '.agent-reasoning-mcp';\n  if (fs.existsSync(gitignorePath)) {\n    const content = fs.readFileSync(gitignorePath, 'utf-8');\n    if (!content.includes(ignoreEntry)) {\n      fs.appendFileSync(gitignorePath, `\\n${ignoreEntry}\\n`, 'utf-8');\n      console.log(`   🛡️  Updated .gitignore (${ignoreEntry})`);\n    }\n  }\n\n  // 4. Scaffold Agent Instructions\n  const instructions = getInstructionsTemplate(slug);\n  const targets = [\n    '.agents/AGENTS.md',\n    'CLAUDE.md',\n    '.windsurfrules',\n    '.cursor/rules/agent-reasoning-mcp.mdc',\n    '.gemini/instructions.md',\n    '.vscode/instructions.md',\n    '.github/copilot-instructions.md',\n  ];\n\n  console.log('   📝 Scaffolding agent instruction contracts:');\n  for (const t of targets) {\n    const fullPath = path.join(root, t);\n    const dir = path.dirname(fullPath);\n    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });\n\n    if (fs.existsSync(fullPath)) {\n      const content = fs.readFileSync(fullPath, 'utf-8');\n      const { updatedContent, status } = upsertInstructionBlock(content, instructions);\n      fs.writeFileSync(fullPath, updatedContent, 'utf-8');\n      console.log(`      - ${t} (${status})`);\n    } else {\n      fs.writeFileSync(fullPath, instructions.trim() + '\\n', 'utf-8');\n      console.log(`      - ${t} (created)`);\n    }\n  }\n\n  // 5. Scaffold Antigravity Skill\n  const skillContent = getSkillTemplate(slug);\n  const localSkillDir = path.join(root, '.agents/skills/agent-reasoning-mcp');\n  if (!fs.existsSync(localSkillDir)) fs.mkdirSync(localSkillDir, { recursive: true });\n  fs.writeFileSync(path.join(localSkillDir, 'SKILL.md'), skillContent, 'utf-8');\n\n  const homedir = os.homedir();\n  const globalSkillDir = path.join(homedir, '.gemini/config/skills/agent-reasoning-mcp');\n  try {\n    if (!fs.existsSync(globalSkillDir)) fs.mkdirSync(globalSkillDir, { recursive: true });\n    fs.writeFileSync(path.join(globalSkillDir, 'SKILL.md'), skillContent, 'utf-8');\n  } catch {}\n  console.log('   🧠 Installed Antigravity agent skill at: .agents/skills/agent-reasoning-mcp');\n\n  // 6. Merge IDE MCP Configurations\n  mergeMcpConfig(root, '.cursor/mcp.json', 'Cursor', getMcpConfigCursor(slug), 'mcpServers');\n  mergeMcpConfig(root, '.vscode/mcp.json', 'VS Code', getMcpConfigVscode(slug), 'servers');\n\n  const windsurfDir = path.join(root, '.windsurf');\n  if (fs.existsSync(windsurfDir)) {\n    mergeMcpConfig(root, '.windsurf/mcp.json', 'Windsurf', getMcpConfigCursor(slug), 'mcpServers');\n  }\n\n  const claudeDir =\n    process.platform === 'darwin'\n      ? path.join(homedir, 'Library', 'Application Support', 'Claude')\n      : process.platform === 'win32'\n        ? path.join(process.env.APPDATA || path.join(homedir, 'AppData', 'Roaming'), 'Claude')\n        : path.join(homedir, '.config', 'Claude');\n\n  if (fs.existsSync(claudeDir)) {\n    mergeMcpConfig(\n      claudeDir,\n      'claude_desktop_config.json',\n      'Claude Desktop',\n      getMcpConfigCursor(slug),\n      'mcpServers'\n    );\n  }\n\n  const globalMcpConfig = path.join(homedir, '.gemini/config/mcp_config.json');\n  try {\n    if (fs.existsSync(path.dirname(globalMcpConfig))) {\n      mergeMcpConfig(\n        homedir,\n        '.gemini/config/mcp_config.json',\n        'Antigravity',\n        getMcpConfigAntigravity(),\n        'mcpServers'\n      );\n    }\n\n    const geminiConfigJson = path.join(homedir, '.gemini/config/config.json');\n    if (fs.existsSync(geminiConfigJson)) {\n      try {\n        const raw = fs.readFileSync(geminiConfigJson, 'utf-8');\n        const data = JSON.parse(raw);\n        if (data.userSettings?.globalPermissionGrants?.allow) {\n          let updated = false;\n          for (const perm of ['command(agent-reasoning-mcp)']) {\n            if (!data.userSettings.globalPermissionGrants.allow.includes(perm)) {\n              data.userSettings.globalPermissionGrants.allow.push(perm);\n              updated = true;\n            }\n          }\n          if (updated) {\n            fs.writeFileSync(geminiConfigJson, JSON.stringify(data, null, 2) + '\\n', 'utf-8');\n            console.log(\n              '      ✅ Google Antigravity (config.json) — granted command(agent-reasoning-mcp)'\n            );\n          }\n        }\n      } catch {}\n    }\n  } catch {}\n  console.log(\n    '   🔌 Configured IDE MCP Servers (Cursor, VS Code, Windsurf, Claude Desktop, Antigravity)'\n  );\n\n  // Global Rules\n  const globalTargets = [\n    { path: path.join(homedir, '.cursorrules'), label: 'Global Cursor Rules (~/.cursorrules)' },\n    {\n      path: path.join(homedir, '.gemini/GEMINI.md'),\n      label: 'Global Gemini Rules (~/.gemini/GEMINI.md)',\n    },\n  ];\n  const globalRulesText = getGlobalRulesTemplate(slug);\n  for (const target of globalTargets) {\n    if (target.path.includes('.gemini') && !fs.existsSync(path.dirname(target.path))) {\n      continue;\n    }\n    if (fs.existsSync(target.path)) {\n      const content = fs.readFileSync(target.path, 'utf-8');\n      const { updatedContent, status } = upsertInstructionBlock(content, globalRulesText);\n      if (status !== 'unchanged') {\n        fs.writeFileSync(target.path, updatedContent, 'utf-8');\n        console.log(`      ✅ ${target.label} — ${status} rules`);\n      }\n    } else {\n      fs.writeFileSync(target.path, globalRulesText, 'utf-8');\n      console.log(`      ✅ ${target.label} — created`);\n    }\n  }\n\n  // 7. Initialize Database and seed defaults\n  const db = getDb(slug, root);\n  console.log('   💾 Initialized SQLite database with WAL mode & SHA-256 Merkle audit chain');\n\n  // Seed default utility profiles if empty\n  const profiles = UtilityProfileEngine.listProfiles(db, slug);\n  if (profiles.length <= 1) {\n    UtilityProfileEngine.configureProfile(db, {\n      project: slug,\n      name: 'aggressive',\n      description: 'High combat and threat engagement bias',\n      weights: {\n        aggression: 0.9,\n        caution: 0.2,\n        greed: 0.5,\n        efficiency: 0.8,\n        exploration: 0.6,\n        cooperation: 0.4,\n      },\n    });\n    UtilityProfileEngine.configureProfile(db, {\n      project: slug,\n      name: 'cautious',\n      description: 'High defense and risk aversion bias',\n      weights: {\n        aggression: 0.1,\n        caution: 0.95,\n        greed: 0.3,\n        efficiency: 0.7,\n        exploration: 0.4,\n        cooperation: 0.8,\n      },\n    });\n    console.log('   🌱 Seeded standard utility scoring profiles (balanced, aggressive, cautious)');\n  }\n\n  const seededPatterns = KnowledgeEngine.seedDefaultPatterns(db, slug);\n  if (seededPatterns > 0) {\n    console.log(`   🌱 Seeded ${seededPatterns} tactical gaming & navigation knowledge patterns`);\n  }\n\n  // 8. Health Audit\n  const audit = verifyEventChain(db, slug);\n  console.log(\n    `   🔍 Audited cryptographic event ledger: ${audit.valid ? '✅ Unbroken SHA-256 chain' : '⚠️ Verification anomaly'}`\n  );\n\n  console.log(`\\n✨ agent-reasoning-mcp initialized successfully for \"${slug}\"!`);\n  console.log('   Run \"agent-reasoning-mcp doctor\" to verify runtime health.');\n  console.log('   Run \"agent-reasoning-mcp inspect\" to view goals, beliefs, and traces.\\n');\n}\n\nexport async function runAutoInit(root?: string, projectSlug?: string): Promise<void> {\n  const originalLog = console.log;\n  console.log = (...args) => console.error(...args);\n  try {\n    runInit({ project: projectSlug, cwd: root });\n  } catch (err: any) {\n    logger.warn(`Auto-init skipped: ${err.message}`);\n  } finally {\n    console.log = originalLog;\n  }\n}\n\nexport async function runInitGlobal(): Promise<void> {\n  const { getRegistry } = await import('../engine/db.js');\n  const registry = getRegistry();\n  const entries = Object.entries(registry);\n  console.log(`Running global init across ${entries.length} registered project(s)...`);\n\n  for (const [slug, projectRoot] of entries) {\n    if (fs.existsSync(projectRoot)) {\n      console.log(`  - ${slug}: ${projectRoot}`);\n      runInit({ project: slug, cwd: projectRoot });\n    }\n  }\n  console.log('Global init complete.');\n}\n","export function getAgentsMdTemplate(projectSlug = 'default'): string {\n  return `<!-- agent-reasoning-mcp:start -->\n# Strategic Agent Reasoning (agent-reasoning-mcp)\n\nThis project uses \\`agent-reasoning-mcp\\` with project slug \"${projectSlug}\" to manage goals, decompose complex tasks, evaluate situational trade-offs, and track decision rationale.\n\n## Mandatory Reasoning Workflow\n1. **Start of planning**: Call \\`set_goal(action: \"create\", title: \"...\")\\` to establish high-level objectives.\n2. **Decomposition**: Call \\`set_goal(action: \"decompose\", parent_id: \"...\", subgoals: [...])\\` to break down into actionable steps.\n3. **Situational Trade-offs**: Call \\`evaluate_situation(action: \"snapshot\", snapshot: {...})\\` before selecting high-stakes actions.\n4. **Utility Configuration**: Tune agent priorities with \\`set_utility_weights(action: \"configure\", weights: {...})\\`.\n5. **Intention Dispatch**: Create execution directives with \\`manage_intentions(action: \"create\", ...)\\` for the runtime engine.\n6. **Reactive Replanning**: If an unexpected blocker occurs, invoke \\`replan(action: \"blocker\", goal_id: \"...\", blocker_description: \"...\")\\`.\n\n## 10 Core MCP Tools\n- \\`set_goal\\`: Manage goal hierarchy and task DAGs.\n- \\`evaluate_situation\\`: Score and rank candidate actions from environment snapshots.\n- \\`replan\\`: Adaptively reconstruct subgoals upon obstacles.\n- \\`assess_risk\\`: Quantitative threat and risk calculation.\n- \\`query_knowledge\\`: Search heuristics and past decision patterns.\n- \\`set_utility_weights\\`: Configure utility weights (aggression, caution, greed, exploration).\n- \\`get_decision_trace\\`: Explainable chain-of-thought rationale playback.\n- \\`manage_beliefs\\`: Structured belief state with exponential confidence decay.\n- \\`manage_intentions\\`: Wire contract directives queue for runtime execution.\n- \\`manage_reasoning_db\\`: Snapshots, diagnostics, and SHA-256 Merkle audit verification.\n<!-- agent-reasoning-mcp:end -->\n`;\n}\n\nexport function getInstructionsTemplate(projectSlug: string): string {\n  return getAgentsMdTemplate(projectSlug);\n}\n\nexport function getGlobalRulesTemplate(projectSlug: string): string {\n  return `<!-- agent-reasoning-mcp:start -->\n# Strategic Agent Reasoning (agent-reasoning-mcp)\n\nThis project uses agent-reasoning-mcp with project slug \"${projectSlug}\" for BDI decision intelligence.\nALWAYS evaluate situation snapshots against active utility weights before taking high-stakes actions.\n\n## Mandatory Workflow\n1. **Goals**: Call \\`set_goal\\` to track objectives.\n2. **Evaluation**: Call \\`evaluate_situation\\` for candidate action scoring.\n3. **Intentions**: Dispatch execution directives via \\`manage_intentions\\`.\n4. **Replanning**: Call \\`replan\\` when blocked.\n<!-- agent-reasoning-mcp:end -->\n`;\n}\n\nexport function getMcpConfigCursor(projectSlug: string): Record<string, unknown> {\n  return {\n    mcpServers: {\n      'agent-reasoning-mcp': {\n        command: 'agent-reasoning-mcp',\n        args: ['run'],\n        env: {\n          REASONING_PROJECT: projectSlug,\n        },\n      },\n    },\n  };\n}\n\nexport function getMcpConfigVscode(projectSlug: string): Record<string, unknown> {\n  return {\n    servers: {\n      'agent-reasoning-mcp': {\n        type: 'stdio',\n        command: 'agent-reasoning-mcp',\n        args: ['run'],\n        env: {\n          REASONING_PROJECT: projectSlug,\n        },\n      },\n    },\n  };\n}\n\nexport function getMcpConfigAntigravity(): Record<string, unknown> {\n  return {\n    mcpServers: {\n      'agent-reasoning-mcp': {\n        command: 'agent-reasoning-mcp',\n        args: ['run'],\n      },\n    },\n  };\n}\n\nexport function getSkillTemplate(projectSlug: string): string {\n  return `---\nname: agent-reasoning-mcp\ndescription: Teaches the agent to use the Strategic Agent Reasoning MCP server for BDI goals, utility scoring, risk evaluation, and replanning.\n---\n\n# Strategic Agent Reasoning (agent-reasoning-mcp)\n\nThis skill provides step-by-step guidance and operational patterns for interacting with \\`@putervision/agent-reasoning-mcp\\` with project slug \\`\"${projectSlug}\"\\`.\n\n---\n\n## 1. Role in the PuterVision Pentad\n- **Workflow State** (\\`state-memory-mcp\\`): Persistent task DAGs, decisions, milestones, and blockers.\n- **Perception** (\\`vision-memory-mcp\\`): Visual layout caching, screenshots, and visual specifications.\n- **Spatial World** (\\`world-model-mcp\\`): Persistent 3D/2D coordinates, bounding boxes, and topological relations.\n- **Strategic Reasoning** (\\`agent-reasoning-mcp\\`): BDI goal decomposition, multi-attribute expected utility calculation, belief decay, risk assessment, and replanning.\n- **Tactical Execution** (\\`behavior-mcp\\`): Deterministic ~60Hz browser behavior tree execution and reactive preemption.\n\n---\n\n## 2. Core Operational Sequence\n1. **Initialize Objectives**: Call \\`set_goal\\` with \\`action: \"create\"\\` to define top-level goals and \\`action: \"decompose\"\\` to establish subgoals.\n2. **Configure Utility Profile**: Tune agent priorities using \\`set_utility_weights\\` (aggression, caution, greed, exploration).\n3. **Situational Trade-off Scoring**: Call \\`evaluate_situation\\` with \\`action: \"snapshot\"\\` to rank candidate actions using Pareto utility theory.\n4. **Intention Dispatch**: Translate chosen action into an execution directive via \\`manage_intentions\\`.\n5. **Reactive Replanning**: If an unexpected obstacle or blocker emerges, invoke \\`replan\\`.\n\n---\n\n## 3. Complete 10 Consolidated MCP Tools Reference\n\n| Tool Name | Key Actions | Key Parameters | Description |\n|---|---|---|---|\n| \\`set_goal\\` | \\`create\\`, \\`update\\`, \\`get\\`, \\`list\\`, \\`decompose\\`, \\`archive\\` | \\`title\\`, \\`description\\`, \\`priority\\`, \\`parent_id\\`, \\`subgoals\\` | Hierarchical BDI goal management and task DAG decomposition. |\n| \\`evaluate_situation\\` | \\`snapshot\\`, \\`quick\\` | \\`snapshot\\`, \\`candidates\\`, \\`utility_profile\\` | Multi-attribute utility evaluation ranking candidate actions from environment state. |\n| \\`replan\\` | \\`blocker\\`, \\`recovery\\`, \\`alternative\\` | \\`goal_id\\`, \\`blocker_description\\`, \\`strategy\\` | Adaptive DAG reconstruction and alternative path discovery upon obstacles. |\n| \\`assess_risk\\` | \\`assess\\`, \\`matrix\\` | \\`hazards\\`, \\`tolerance\\`, \\`mitigations\\` | Quantitative threat matrix and probabilistic risk scoring. |\n| \\`query_knowledge\\` | \\`search\\`, \\`lookup\\`, \\`heuristics\\` | \\`query\\`, \\`category\\`, \\`tags\\` | Knowledge retrieval of past decision heuristics and domain heuristics. |\n| \\`set_utility_weights\\` | \\`configure\\`, \\`get\\`, \\`list\\`, \\`profile\\` | \\`name\\`, \\`weights\\` (aggression, caution, greed, exploration) | Utility weight tuning and personality profile management. |\n| \\`get_decision_trace\\` | \\`get\\`, \\`list\\`, \\`explain\\` | \\`trace_id\\`, \\`limit\\` | Explainable chain-of-thought rationale playback and auditing. |\n| \\`manage_beliefs\\` | \\`set\\`, \\`get\\`, \\`decay\\`, \\`list\\` | \\`key\\`, \\`value\\`, \\`confidence\\`, \\`decay_rate\\` | Structured belief state with temporal exponential confidence decay. |\n| \\`manage_intentions\\` | \\`create\\`, \\`get\\`, \\`list\\`, \\`dispatch\\`, \\`cancel\\` | \\`goal_id\\`, \\`behavior_name\\`, \\`parameters\\` | Execution directives queue connecting strategic plans to runtime engines. |\n| \\`manage_reasoning_db\\` | \\`stats\\`, \\`audit\\`, \\`snapshot\\`, \\`restore\\`, \\`prune\\` | \\`action\\`, \\`name\\`, \\`description\\` | Database diagnostics, snapshots, and SHA-256 Merkle audit verification. |\n`;\n}\n"],"mappings":"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","names":["homedir"]}