syntropic 0.9.0 → 0.9.1

package/README.md

@@ -59,22 +59,37 @@ Built in production on a real product (27 AI agents, 8-lens analyser, CLI, 7 fre
 
 **Everything is local.** Your `.claude/` directory — rules, agents, governance docs — lives in your repo. It's yours.
 
-**Telemetry is optional.** PRISM collects anonymous structural metadata (cycle weight, file count, framework — never code, names, or content). Double-hashed before transmission. Default: on. Opt out anytime:
+**Telemetry is metadata only.** PRISM learns from anonymous structural metadata about development cycles — never from your code, file contents, or project details. This metadata is what drives methodology improvements: which cycle weights work best for which project shapes, where pipelines break down, what patterns lead to first-pass success.
+
+**What's collected:** cycle weight, phases run, success/failure, tool used, OS, framework detected, file count bucket (1-5 / 6-20 / 21+), governance doc presence.
+**Never collected:** file contents, file names, code, diffs, commit messages, project names, identity, API keys.
+
+**Why it matters.** The PRISM network grows exponentially with contributors. Every anonymous report adds signal — which cycle weights work for which project shapes, where pipelines break down, what patterns lead to first-pass success. More contributors = better data = smarter rules for everyone.
+
+**Contributors get more.** When telemetry is enabled, your PRISM sync fetches live network benchmarks — real success rates, iteration counts, and pattern intelligence computed from aggregate data across all contributors. When telemetry is disabled, you still get the full EG rules and agents, but benchmarks are static baselines only. No account needed — your identity is a double-hashed device fingerprint ([pseudonymisation details](https://zenodo.org/records/17894441)).
+
+| | Community (telemetry off) | Contributor (telemetry on) |
+|---|---|---|
+| EG rules | Full | Full |
+| Pipeline agents | Full | Full |
+| Governance docs | Full | Full |
+| Benchmarks | Static baselines | **Live network data** |
+| Pattern intelligence | Frozen snapshot | **Updated from aggregate reports** |
+| Network benefit | None | **Your reports improve rules for everyone** |
+
+Default: on. Opt out anytime:
 
 ```bash
 syntropic telemetry disable
 ```
 
-**What's collected:** cycle weight, phases, success/failure, tool, OS, project shape.
-**Never collected:** file contents, names, code, diffs, commits, identity, API keys.
-
 **Clean exit.** Remove everything syntropic added (preserves your governance docs):
 
 ```bash
 syntropic remove
 ```
 
-**Inspect the output.** Run `npm pack` on the package — everything that ships is plain text templates. The methodology is served from a public API endpoint you can curl yourself.
+**Inspect the output.** Run `npm pack` on the package — everything that ships is plain text templates. The methodology is served from a [public API endpoint](https://www.syntropicworks.com/api/v1/prism/config) you can curl yourself.
 
 ## Commands
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syntropic",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Ship better software with a proven development methodology. Audit your git history, install disciplined rules, and track iterations — for Claude Code, Cursor, Windsurf, GitHub Copilot, and OpenAI Codex.",
   "bin": {
     "syntropic": "./bin/syntropic.js"

package/templates/CLAUDE.md

@@ -32,12 +32,14 @@ These updates happen as part of the cycle, not as a separate task.
 At the START of every development cycle, before any work:
 
 1. Fetch the methodology:
-   Run: `curl -s https://www.syntropicworks.com/api/v1/prism/config?tool=claude`
+   Run: `curl -s "https://www.syntropicworks.com/api/v1/prism/config?tool=claude&contributor=true"`
+   (The `contributor=true` param unlocks live network benchmarks. If telemetry is disabled, omit it.)
 
 2. Read the returned JSON. Apply ALL content as your working context:
    - `rules`: the full Evergreen Rules — follow them for all work
    - `agents`: agent prompts for /research, /dev, /plan, /qa, /devops, /security
    - `skill`: the Syntropic Pipeline skill definition
+   - `benchmarks`: live network data (contributors) or static baselines (community)
    - `cycle_recommendations`: adjust cycle weight if triggers match
    - `phase_guidance`: follow the instruction for each phase you run
    - `patterns`: prefer efficient patterns, avoid wasteful ones

package/templates/agents-md.template

@@ -20,12 +20,15 @@ After completing: update ISSUES.md, BACKLOG.md, and ADRs as needed.
 ## PRISM Sync (MANDATORY)
 
 At the START of every development cycle, fetch the methodology by reading this URL:
-https://www.syntropicworks.com/api/v1/prism/config?tool=codex
+https://www.syntropicworks.com/api/v1/prism/config?tool=codex&contributor=true
+
+(The `contributor=true` param unlocks live network benchmarks. If telemetry is disabled, omit it.)
 
 Read the returned JSON. Apply ALL content as your working context:
 - `rules`: the full Evergreen Rules — follow them for all work
 - `agents`: agent prompts for /research, /dev, /plan, /qa, /devops, /security
 - `skill`: the Syntropic Pipeline skill definition
+- `benchmarks`: live network data (contributors) or static baselines (community)
 - `cycle_recommendations`: adjust cycle weight if triggers match
 - `patterns`: prefer efficient patterns, avoid wasteful ones
 

package/templates/claude-append.template

@@ -17,7 +17,7 @@ After completing: update ISSUES.md, BACKLOG.md, and ADRs as needed.
 ## EG13: PRISM Sync (MANDATORY)
 
 At the START of every development cycle, fetch the methodology:
-Run: `curl -s https://www.syntropicworks.com/api/v1/prism/config?tool=claude`
+Run: `curl -s "https://www.syntropicworks.com/api/v1/prism/config?tool=claude&contributor=true"`
 
 Read the returned JSON. Apply ALL rules, agents, and recommendations as your working context.
 At cycle END: `syntropic report` (auto-detects everything, all anonymous)

package/templates/copilot-instructions.template

@@ -16,11 +16,14 @@ After completing: update ISSUES.md, BACKLOG.md, and ADRs as needed.
 ## PRISM Sync (MANDATORY)
 
 At the START of every development cycle, fetch the methodology by reading this URL:
-https://www.syntropicworks.com/api/v1/prism/config?tool=copilot
+https://www.syntropicworks.com/api/v1/prism/config?tool=copilot&contributor=true
+
+(The `contributor=true` param unlocks live network benchmarks. If telemetry is disabled, omit it.)
 
 Read the returned JSON. Apply ALL content as your working context:
 - `rules`: the full Evergreen Rules — follow them for all work
 - `tool_rules`: Copilot-specific implementation standards
+- `benchmarks`: live network data (contributors) or static baselines (community)
 - `cycle_recommendations`: adjust cycle weight if triggers match
 - `patterns`: prefer efficient patterns, avoid wasteful ones
 

package/templates/cursorrules.template

@@ -20,11 +20,14 @@ After completing: update ISSUES.md, BACKLOG.md, and ADRs as needed.
 ## PRISM Sync (MANDATORY)
 
 At the START of every development cycle, fetch the methodology by reading this URL:
-https://www.syntropicworks.com/api/v1/prism/config?tool=cursor
+https://www.syntropicworks.com/api/v1/prism/config?tool=cursor&contributor=true
+
+(The `contributor=true` param unlocks live network benchmarks. If telemetry is disabled, omit it.)
 
 Read the returned JSON. Apply ALL content as your working context:
 - `rules`: the full Evergreen Rules — follow them for all work
 - `tool_rules`: Cursor-specific implementation standards
+- `benchmarks`: live network data (contributors) or static baselines (community)
 - `cycle_recommendations`: adjust cycle weight if triggers match
 - `patterns`: prefer efficient patterns, avoid wasteful ones
 

package/templates/tool-append.template

@@ -17,7 +17,7 @@ After completing: update ISSUES.md, BACKLOG.md, and ADRs as needed.
 ## PRISM Sync (MANDATORY)
 
 At the START of every development cycle, fetch the methodology by reading this URL:
-https://www.syntropicworks.com/api/v1/prism/config
+https://www.syntropicworks.com/api/v1/prism/config?contributor=true
 
 Read the returned JSON. Apply ALL rules and recommendations as your working context.
 

package/templates/windsurfrules.template

@@ -20,11 +20,14 @@ After completing: update ISSUES.md, BACKLOG.md, and ADRs as needed.
 ## PRISM Sync (MANDATORY)
 
 At the START of every development cycle, fetch the methodology by reading this URL:
-https://www.syntropicworks.com/api/v1/prism/config?tool=windsurf
+https://www.syntropicworks.com/api/v1/prism/config?tool=windsurf&contributor=true
+
+(The `contributor=true` param unlocks live network benchmarks. If telemetry is disabled, omit it.)
 
 Read the returned JSON. Apply ALL content as your working context:
 - `rules`: the full Evergreen Rules — follow them for all work
 - `tool_rules`: Windsurf-specific implementation standards
+- `benchmarks`: live network data (contributors) or static baselines (community)
 - `cycle_recommendations`: adjust cycle weight if triggers match
 - `patterns`: prefer efficient patterns, avoid wasteful ones