changebook 0.3.1 → 0.3.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -1
- package/dist/sync.js +6 -0
- package/package.json +1 -1
- package/server.json +8 -2
package/README.md
CHANGED
|
@@ -7,7 +7,24 @@ codebase, plus a CLI that feeds that memory from any terminal: sign in,
|
|
|
7
7
|
analyze uncommitted changes, sync the product map. All MCP tools are
|
|
8
8
|
read-only, and Row Level Security scopes every query to the signed-in user.
|
|
9
9
|
|
|
10
|
-
##
|
|
10
|
+
## Two ways to run it
|
|
11
|
+
|
|
12
|
+
**Local (npm):** the CLI runs the MCP server on stdio — no server to host, works
|
|
13
|
+
offline against your account. See Quick start below.
|
|
14
|
+
|
|
15
|
+
**Hosted (HTTP, no install):** point any client at the hosted endpoint with a
|
|
16
|
+
Personal Access Token — nothing to install, just a URL:
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
claude mcp add --transport http changebook \
|
|
20
|
+
https://mcp.changebook.app \
|
|
21
|
+
--header "Authorization: Bearer <your-PAT>"
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Generate the PAT in the web app (Account → Access tokens). The token is
|
|
25
|
+
SHA-256-hashed server-side and revocable; every query is scoped to your account.
|
|
26
|
+
|
|
27
|
+
## Quick start (local)
|
|
11
28
|
|
|
12
29
|
```bash
|
|
13
30
|
npx changebook init # login (browser) + register in Claude Code/Codex + sync
|
package/dist/sync.js
CHANGED
|
@@ -81,6 +81,12 @@ export function buildSection(rows, changes, alerts = []) {
|
|
|
81
81
|
"",
|
|
82
82
|
"Este proyecto tiene memoria en ChangeBook. Antes de explorar código a mano, orienta con las tools MCP: `atlas_modules` (mapa), `atlas_recent_changes` (historia), `atlas_module_detail` (detalle + diffs).",
|
|
83
83
|
"",
|
|
84
|
+
// La instrucción de escritura vive AQUÍ y no en la doc de la tool: los
|
|
85
|
+
// agentes obedecen lo que el workspace les dice, no lo que una tool
|
|
86
|
+
// disponible insinúa (lección 2026-07-17: un agente con la tool conectada
|
|
87
|
+
// hizo 3 PRs y no registró ninguno hasta que se lo pidieron).
|
|
88
|
+
"Tras cada commit, registra el cambio con la tool MCP `atlas_record_change`: pásale el diff (`git show HEAD`), `commit_hash`, `committed_at` y SIEMPRE `summary` (2-5 frases tuyas sobre qué cambió y por qué — abarata mucho el análisis). Reenviar un commit ya registrado es un no-op gratuito.",
|
|
89
|
+
"",
|
|
84
90
|
];
|
|
85
91
|
if (modules.length === 0) {
|
|
86
92
|
return [
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "changebook",
|
|
3
|
-
"version": "0.3.
|
|
3
|
+
"version": "0.3.2",
|
|
4
4
|
"mcpName": "io.github.raulbr90/changebook",
|
|
5
5
|
"description": "ChangeBook for coding agents: MCP server (product memory for Claude Code/Codex) + CLI to sign in, analyze changes and sync the product map.",
|
|
6
6
|
"type": "module",
|
package/server.json
CHANGED
|
@@ -2,14 +2,20 @@
|
|
|
2
2
|
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
3
|
"name": "io.github.raulbr90/changebook",
|
|
4
4
|
"description": "Query your product's living memory: module map + analyzed change history. Read-only MCP tools.",
|
|
5
|
-
"version": "0.3.
|
|
5
|
+
"version": "0.3.3",
|
|
6
6
|
"websiteUrl": "https://changebook.dev",
|
|
7
|
+
"remotes": [
|
|
8
|
+
{
|
|
9
|
+
"type": "streamable-http",
|
|
10
|
+
"url": "https://mcp.changebook.app"
|
|
11
|
+
}
|
|
12
|
+
],
|
|
7
13
|
"packages": [
|
|
8
14
|
{
|
|
9
15
|
"registryType": "npm",
|
|
10
16
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
11
17
|
"identifier": "changebook",
|
|
12
|
-
"version": "0.3.
|
|
18
|
+
"version": "0.3.2",
|
|
13
19
|
"transport": {
|
|
14
20
|
"type": "stdio"
|
|
15
21
|
}
|