claude-blueprint 1.0.0 → 1.0.1

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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "blueprint",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Architecture Decision Records with teeth — lifecycle management, devil's advocate review, architecture evaluation team, post-fix retrospectives, and compliance auditing. All with a cranky senior engineer persona.",
5
5
  "author": {
6
6
  "name": "pragnition"
package/README.md CHANGED
@@ -8,6 +8,19 @@ Architecture Decision Records with teeth. A Claude Code plugin that treats archi
8
8
 
9
9
  Every agent speaks with the voice of a senior engineer who has watched too many "temporary" decisions become permanent load-bearing walls.
10
10
 
11
+ ## Table of Contents
12
+
13
+ - [The Problem Blueprint Solves](#the-problem-blueprint-solves)
14
+ - [Philosophical Foundations](#philosophical-foundations)
15
+ - [How Blueprint Works](#how-blueprint-works)
16
+ - [Commands](#commands)
17
+ - [The Five Dimensions of Architectural Health](#the-five-dimensions-of-architectural-health)
18
+ - [Continuous Governance: Beyond Point-in-Time](#continuous-governance-beyond-point-in-time)
19
+ - [The Retrospective: Closing the Loop](#the-retrospective-closing-the-loop)
20
+ - [Installation](#installation)
21
+ - [Architecture of Blueprint Itself](#architecture-of-blueprint-itself)
22
+ - [Intellectual Heritage](#intellectual-heritage)
23
+
11
24
  ## The Problem Blueprint Solves
12
25
 
13
26
  > "We shape our buildings; thereafter they shape us." — Winston Churchill
@@ -292,14 +305,24 @@ The output is a verdict: **SYSTEMIC** (the fix addressed the root cause, move on
292
305
  ## Installation
293
306
 
294
307
  ```bash
295
- # From source
308
+ # Via Claude Code plugin marketplace (recommended)
309
+ /plugin marketplace add pragnition/claude-plugins
310
+ /plugin install blueprint@pragnition-plugins
311
+
312
+ # Via npm
313
+ npx claude-blueprint install --global
314
+
315
+ # Verify
316
+ npx claude-blueprint verify
317
+ ```
318
+
319
+ Or from source:
320
+
321
+ ```bash
296
322
  cd ~/pragnition/blueprint
297
323
  npm install
298
324
  npm link
299
325
  claude-blueprint install --global
300
-
301
- # Verify
302
- claude-blueprint verify
303
326
  ```
304
327
 
305
328
  The installer deploys 24 commands, 12 agents, and 4 config files to `~/.claude/commands/blueprint/`, and inserts a managed section into `CLAUDE.md` with the command reference.
@@ -102,15 +102,44 @@ Always display this first:
102
102
 
103
103
  ### Step 3: Generate Interactive HTML Dashboard
104
104
 
105
- After the terminal display, generate an interactive HTML file with a visual knowledge
106
- graph and offer to open it:
107
-
108
- ```bash
109
- # Write to a temp file and open
110
- /tmp/blueprint-dashboard-{timestamp}.html
105
+ After the terminal display, generate the dashboard by:
106
+
107
+ 1. Read the template from `assets/dashboard.html` in the blueprint plugin directory
108
+ (find it via: the plugin's install location, or `~/pragnition/blueprint/assets/dashboard.html`)
109
+ 2. Build the `DATA` object from the metrics gathered in Step 1
110
+ 3. Replace the placeholder `__BLUEPRINT_DATA__` in the template with the JSON data
111
+ 4. Write to `/tmp/blueprint-dashboard-{timestamp}.html`
112
+ 5. Open in browser
113
+
114
+ **The DATA object structure:**
115
+
116
+ ```javascript
117
+ {
118
+ generated: "2026-03-30",
119
+ health_score: "ADEQUATE", // STRONG / ADEQUATE / CONCERNING / CRITICAL
120
+ debt_score: 14,
121
+ triggers_met: 1,
122
+ operations: {
123
+ audit: "2026-03-18", // ISO date or null
124
+ evaluation: null,
125
+ retro: "2026-03-27",
126
+ drift: null,
127
+ status: "2026-03-30"
128
+ },
129
+ adrs: [
130
+ { number: "ADR-0001", title: "Use ADRs...", status: "Accepted",
131
+ category: "Process", date: "2026-03-30", severity: "Medium",
132
+ trigger: null, trigger_met: false, debt_score: 0 },
133
+ // ... one entry per ADR
134
+ ],
135
+ edges: [
136
+ { from: "ADR-0003", to: "ADR-0008", type: "DEPENDS_ON" },
137
+ // ... from relationships.toml
138
+ ]
139
+ }
111
140
  ```
112
141
 
113
- **The HTML dashboard includes:**
142
+ **The HTML dashboard includes (4 tabs, matching the wireframe design system):**
114
143
 
115
144
  **Tab 1: Knowledge Graph (main view)**
116
145
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-blueprint",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "type": "module",
5
5
  "description": "Architecture Decision Records with teeth — lifecycle management, devil's advocate review, architecture evaluation team, post-fix retrospectives, and compliance auditing for Claude Code.",
6
6
  "bin": {