@decibelsystems/tools 3.0.0 → 3.1.0

package/dist/transports/mcp.js

@@ -7,13 +7,14 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
 import { log } from '../config.js';
+import { PACKAGE } from '../version.js';
 /**
  * Create an MCP Server wired to the given kernel.
  * Each transport gets its own Server instance (MCP SDK only supports
  * one transport per Server).
  */
 export function createMcpServer(kernel, transport = 'stdio') {
-    const server = new Server({ name: '@decibelsystems/tools', version: '2.0.0' }, { capabilities: { tools: {} } });
+    const server = new Server({ name: PACKAGE.name, version: PACKAGE.version }, { capabilities: { tools: {} } });
     // Define available tools — facades are the public API
     server.setRequestHandler(ListToolsRequestSchema, async (request) => {
         const meta = request.params?._meta;

package/dist/transports/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/transports/mcp.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAC/E,gFAAgF;AAChF,oEAAoE;AACpE,+EAA+E;AAE/E,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGnC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAkB,EAClB,YAA8B,OAAO;IAErC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,OAAO,EAAE,EACnD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;IAEF,sDAAsD;IACtD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACjE,MAAM,IAAI,GAAI,OAAO,CAAC,MAA8C,EAAE,KAA4C,CAAC;QACnH,MAAM,IAAI,GAAI,IAAI,EAAE,UAA2C,IAAI,MAAM,CAAC;QAC1E,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,8CAA8C;IAC9C,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;QAC5B,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAEjD,IAAI,CAAC;YACH,kDAAkD;YAClD,MAAM,IAAI,GAAI,OAAO,CAAC,MAAkC,CAAC,KAA4C,CAAC;YACtG,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;gBACrB,OAAO,EAAE,IAAI,CAAC,OAA6B;gBAC3C,KAAK,EAAE,IAAI,CAAC,KAA2B;gBACvC,YAAY,EAAE,IAAI,CAAC,YAAkC;gBACrD,KAAK,EAAE,IAAI,CAAC,KAA2B;gBACvC,cAAc,EAAE,IAAI,CAAC,cAAoC;gBACzD,OAAO,EAAE,IAAI,CAAC,OAA6B;gBAC3C,SAAS,EAAE,IAAI,CAAC,SAA+B;gBAC/C,uEAAuE;gBACvE,qEAAqE;gBACrE,oCAAoC;gBACpC,SAAS;aACV,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;YAElB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAA+B,EAAE,OAAO,CAAC,CAAC;YACrF,OAAO,MAA+E,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,GAAG,CAAC,iBAAiB,IAAI,GAAG,EAAE,YAAY,CAAC,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;gBAC1E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/transports/mcp.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,5 @@
+export declare const PACKAGE: {
+    version: string;
+    name: string;
+};
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,OAAO;aAVQ,MAAM;UAAQ,MAAM;CAUnB,CAAC"}

package/dist/version.js

@@ -0,0 +1,23 @@
+// ============================================================================
+// The package's own name and version, read once from package.json
+// ============================================================================
+// One place for it. The MCP adapters each hardcoded '2.0.0' in their
+// serverInfo, so every client was told the server was 2.0.0, up to and
+// including 3.0.0. This file sits at dist/version.js, so package.json is one level up in
+// the repo and in the installed package alike.
+// ============================================================================
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+function read() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf-8'));
+        return { version: pkg.version || '0.0.0', name: pkg.name || '@decibelsystems/tools' };
+    }
+    catch {
+        // Unknown, said honestly: never a plausible-looking stale number.
+        return { version: '0.0.0', name: '@decibelsystems/tools' };
+    }
+}
+export const PACKAGE = read();
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kEAAkE;AAClE,+EAA+E;AAC/E,qEAAqE;AACrE,uEAAuE;AACvE,yFAAyF;AACzF,+CAA+C;AAC/C,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,SAAS,IAAI;IACX,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACnH,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,uBAAuB,EAAE,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;QAClE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decibelsystems/tools",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "bin": {
     "decibel-tools": "dist/server.js"
   },
@@ -26,6 +26,7 @@
     "build": "tsc",
     "build:dist": "rm -rf dist && tsc -p tsconfig.build.json",
     "prepack": "npm run build:dist",
+    "postpack": "npm run build",
     "dev": "tsx src/server.ts",
     "start": "node dist/server.js",
     "start:http": "node dist/server.js --http",
@@ -40,11 +41,16 @@
     "test:coverage": "vitest run --coverage",
     "test:quick": "tsx src/test.ts",
     "lint": "tsc --noEmit",
+    "prepare": "git rev-parse --git-dir >/dev/null 2>&1 && git config core.hooksPath .githooks || true",
+    "secrets:scan": "sh scripts/scan-secrets.sh",
+    "test:hooks": "python3 .claude/hooks/test_block_secret_files.py",
     "ext:build": "cd extension && npm run build",
     "ext:watch": "cd extension && npm run watch",
     "ext:package": "cd extension && npm run package",
     "ext:install": "cd extension && npm run install-ext",
-    "test:torture": "vitest run tests/torture --testTimeout=1800000"
+    "test:torture": "vitest run tests/torture --testTimeout=1800000",
+    "test:ci": "vitest run --exclude '**/torture/s4-transports.test.ts'",
+    "test:s4": "vitest run tests/torture/s4-transports.test.ts"
   },
   "keywords": [
     "mcp",
@@ -61,12 +67,14 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "@supabase/supabase-js": "^2.89.0",
     "express": "^5.2.1",
+    "ws": "^8.21.1",
     "yaml": "^2.8.2",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
     "@types/pg": "^8.16.0",
+    "@types/ws": "^8.5.13",
     "@vitest/coverage-v8": "^2.1.0",
     "pg": "^8.16.3",
     "tsx": "^4.7.0",
@@ -75,5 +83,8 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "node-pty": "^1.1.0"
   }
 }

package/templates/AGENT.md

@@ -54,6 +54,9 @@ This project uses **Decibel Tools**—an MCP-based project intelligence system.
 - Signal count increases when the same friction is encountered repeatedly
 - Tools: `friction_log`, `friction_bump`, `friction_list`
 
+### Artifacts (Published Pages)
+- After publishing an artifact, call `artifacts register` with its url and a short title, so the humans can find it again in HQ.
+
 ## Decision Tree
 
 ```

package/templates/CLAUDE-decibel.md

@@ -0,0 +1,11 @@
+<!-- decibel:start -->
+## Decibel Tools — project memory
+
+This project uses Decibel Tools (MCP). **Decibel is the durable memory for this project. Your own session memory is a cache.** It is not visual, it does not survive a crash, and it is not shared with the other people and agents on this project. Anything worth remembering past this session goes into Decibel, not into a scratch file or your memory.
+
+- **Start of session:** `oracle next_actions`, then `roadmap read` to see where the project is and what the current milestone is.
+- **During work:** track tasks with `sentinel create_issue` / `close_issue`. Record *why* with `architect create_adr`. Log recurring pain with `friction log`.
+- **Before stopping:** `learnings append` anything the next session must know. Close what you finished.
+
+Never create manual folders or markdown files for epics, issues, ADRs, proposals, or wishes. Use the tools. Full reference: `templates/AGENT.md` in `@decibelsystems/tools`.
+<!-- decibel:end -->