sinapse-ai 7.4.6 → 7.5.0

package/.sinapse-ai/data/registry-update-log.jsonl

@@ -535,3 +535,19 @@
 {"timestamp":"2026-03-26T01:16:16.894Z","action":"unlink","path":".sinapse-ai/product/templates/ide-rules/gemini-rules.md","trigger":"watcher"}
 {"timestamp":"2026-03-27T03:02:17.627Z","action":"change","path":".sinapse-ai/development/agents/sinapse-orqx.md","trigger":"watcher"}
 {"timestamp":"2026-03-27T03:02:28.546Z","action":"change","path":".sinapse-ai/development/agents/sinapse-orqx.md","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.064Z","action":"add","path":".sinapse-ai/core/doctor/checks/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.066Z","action":"change","path":".sinapse-ai/core/doctor/checks/index.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.066Z","action":"change","path":".sinapse-ai/core/doctor/index.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.067Z","action":"add","path":".sinapse-ai/core/health-check/checks/project/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.067Z","action":"change","path":".sinapse-ai/core/health-check/checks/project/index.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.067Z","action":"change","path":".sinapse-ai/development/tasks/dev-develop-story.md","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.068Z","action":"change","path":".sinapse-ai/development/tasks/health-check.yaml","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:29.068Z","action":"change","path":".sinapse-ai/product/templates/ide-rules/claude-rules.md","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.950Z","action":"add","path":".sinapse-ai/core/doctor/checks/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.951Z","action":"change","path":".sinapse-ai/core/doctor/checks/index.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.951Z","action":"change","path":".sinapse-ai/core/doctor/index.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.952Z","action":"add","path":".sinapse-ai/core/health-check/checks/project/constitution-consistency.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.952Z","action":"change","path":".sinapse-ai/core/health-check/checks/project/index.js","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.953Z","action":"change","path":".sinapse-ai/development/tasks/dev-develop-story.md","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.953Z","action":"change","path":".sinapse-ai/development/tasks/health-check.yaml","trigger":"watcher"}
+{"timestamp":"2026-03-30T18:05:54.953Z","action":"change","path":".sinapse-ai/product/templates/ide-rules/claude-rules.md","trigger":"watcher"}

package/.sinapse-ai/development/tasks/dev-develop-story.md

@@ -93,29 +93,37 @@ atomic_layer: Organism
 > **Reference:** Constitution Articles I, III
 > **Enforcement:** Automatic validation before execution
 
-### Gate 1: Story-Driven Development (Article III)
+### Gate 1: Documentation-First Development (Article III — NON-NEGOTIABLE)
 
 ```yaml
 constitutional_gate:
   article: III
-  name: Story-Driven Development
+  name: Documentation-First Development
   severity: BLOCK
 
   validation:
     - Story file MUST exist at docs/stories/{storyId}/story.yaml
-    - Story MUST have status != "Draft" (Ready, In Progress, or Done)
+    - Story MUST have status >= "Ready" (validated by @product-lead)
     - Story MUST have acceptance criteria defined
+    - Story MUST have scope (IN/OUT) documented
     - Story MUST have at least one task/subtask
+    - Pipeline Epic → Story → Validation MUST be completed before implementation
 
   on_violation:
     action: BLOCK
     message: |
-      CONSTITUTIONAL VIOLATION: Article III - Story-Driven Development
-      Cannot develop without a valid story.
+      CONSTITUTIONAL VIOLATION: Article III - Documentation-First Development (NON-NEGOTIABLE)
+      Cannot develop without a validated story.
 
       Issue: {violation_details}
 
-      Resolution: Create or update story via @sprint-lead *draft or @product-lead *create-story
+      This is NON-NEGOTIABLE. The documentation pipeline MUST be completed first:
+      1. Epic must exist → @project-lead *create-epic
+      2. Story must be drafted → @sprint-lead *draft
+      3. Story must be validated → @product-lead *validate
+      4. Only then can implementation begin
+
+      Resolution: Follow the pipeline above. No shortcuts allowed.
 ```
 
 ### Gate 2: CLI First (Article I)

package/.sinapse-ai/development/tasks/health-check.yaml

@@ -130,7 +130,7 @@ governance_map:
 
   entity-registry:
     article: "III"
-    article_name: "Story-Driven Development"
+    article_name: "Documentation-First Development"
     governance_note: "Code intelligence registry for entity-aware development"
     remediation: "sinapse doctor --fix"
 
@@ -166,7 +166,7 @@ governance_map:
 
   code-intel:
     article: "III"
-    article_name: "Story-Driven Development"
+    article_name: "Documentation-First Development"
     governance_note: "Code intelligence for entity-aware development workflows"
     remediation: "sinapse doctor --fix"
 

package/.sinapse-ai/development/templates/chrome-brain/knowledge-base/claude-in-chrome.md

@@ -0,0 +1,62 @@
+# claude-in-chrome — Chrome Extension for Visual Browser Interaction
+
+> Manual install required. This extension cannot be auto-installed via CLI.
+
+---
+
+## What It Does
+
+claude-in-chrome is a Chrome extension that acts as an MCP server directly from
+within Chrome. It exposes browser automation tools via a local WebSocket, enabling
+screen-level visual interaction (computer use) as a fallback when CDP and Playwright
+cannot handle a task (e.g., complex visual layouts, canvas elements, iframes).
+
+---
+
+## Installation
+
+1. Open Chrome and navigate to the Chrome Web Store
+2. Search for "claude-in-chrome" or visit:
+   https://chromewebstore.google.com/detail/claude-in-chrome
+3. Click "Add to Chrome" and confirm
+4. The extension icon should appear in the Chrome toolbar
+5. Click the extension icon and follow the setup wizard
+
+---
+
+## MCP Configuration
+
+The extension manages its own MCP registration automatically after install.
+**Do NOT** manually add a "claude-in-chrome" entry to ~/.claude.json.
+
+If the extension is installed and Chrome is running with debug port 9222,
+claude-in-chrome tools will be available to Claude Code automatically.
+
+---
+
+## When to Use
+
+| Scenario | Use claude-in-chrome? |
+|----------|----------------------|
+| CDP tools handle the task | No — use chrome-devtools-mcp |
+| Playwright can scrape/interact | No — use dev-browser |
+| Complex visual layout, canvas, WebGL | Yes |
+| Cross-origin iframe interaction | Maybe — try CDP Input events first |
+| Screen coordinate-based interaction | Yes |
+
+**Priority:** CDP > dev-browser > claude-in-chrome (visual fallback only)
+
+---
+
+## Troubleshooting
+
+- **Extension not showing tools:** Ensure Chrome is running with --remote-debugging-port=9222
+- **Tools timeout:** Restart Chrome via chrome-debug script, then reload extension
+- **Extension disabled:** Check chrome://extensions and re-enable
+
+---
+
+## Reference
+
+- Master KB: ~/.sinapse/sinapse/knowledge-base/chrome-brain.md
+- Chrome Brain auto-activation rule: ~/.sinapse/.claude/rules/chrome-brain-autoload.md

package/.sinapse-ai/install-manifest.yaml

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 7.4.6
-generated_at: "2026-03-29T05:05:29.249Z"
+version: 7.5.0
+generated_at: "2026-03-30T18:06:06.639Z"
 generator: scripts/generate-install-manifest.js
-file_count: 1101
+file_count: 1104
 files:
   - path: cli/commands/config/index.js
     hash: sha256:66f111eceef0f60fa0a8904add783b615d55b01d5fe36408623c3dd828e702f6
@@ -300,6 +300,10 @@ files:
     hash: sha256:5a8b983ffe7cc31a8145c5067298badbb6c445a5ccf66e300bca0269312869df
     type: core
     size: 1724
+  - path: core/doctor/checks/constitution-consistency.js
+    hash: sha256:659489ab7c353f4b69473e72b046e43ada1342acdc017398cb6a0b60ffb0ef5b
+    type: core
+    size: 3083
   - path: core/doctor/checks/core-config.js
     hash: sha256:5424528eefbc2f19213b30d00dcd96128acefdbb289c25712be844f0fbddb963
     type: core
@@ -325,9 +329,9 @@ files:
     type: core
     size: 2159
   - path: core/doctor/checks/index.js
-    hash: sha256:67334b98927b9d581c262527a5af1b332e0c7b46822724b176f21a87817c5e23
+    hash: sha256:46c492327d3aa9e704ee098c43fad1fd884edfb96620d15f51e6f54699f1ea39
     type: core
-    size: 1193
+    size: 1418
   - path: core/doctor/checks/node-version.js
     hash: sha256:37812997bb9611c4245477b9444c2b7899b37d06850a616f43706a8c79bc6f04
     type: core
@@ -361,9 +365,9 @@ files:
     type: core
     size: 1460
   - path: core/doctor/index.js
-    hash: sha256:d663eb70b661440144219a7525f9652a9abfbe2ebb40b61a900c27d5074b5f80
+    hash: sha256:e63be0d9a3a974c74232b89a99f13340dc85e65d420806a9d783c127b90eee90
     type: core
-    size: 2536
+    size: 2604
   - path: core/elicitation/agent-elicitation.js
     hash: sha256:ef13ebff1375279e7b8f0f0bbd3699a0d201f9a67127efa64c4142159a26f417
     type: elicitation
@@ -564,6 +568,10 @@ files:
     hash: sha256:9e5f0d8e0a14704842f9958d43f2adf04b84757700284364ea486950d88ab2a8
     type: core
     size: 4733
+  - path: core/health-check/checks/project/constitution-consistency.js
+    hash: sha256:55cd12c67c7dfbd35dc25db20b35b94fa4e8e5104488dacf6fc4834be73eb767
+    type: core
+    size: 5883
   - path: core/health-check/checks/project/dependencies.js
     hash: sha256:a8f4d9fcadf5dc3274d8ed0605af6f25d6554b1a9b0d3e66c63d8ea4569c95b9
     type: core
@@ -573,9 +581,9 @@ files:
     type: core
     size: 4028
   - path: core/health-check/checks/project/index.js
-    hash: sha256:8564c4ead12e52e157874c7a5875af9ecfcf5a8ec195d51341d7d6f191b58932
+    hash: sha256:0fc2732f18f9a853b6d750362836a4472c9921bf3b4e203c9855165fd31a7e88
     type: core
-    size: 945
+    size: 1053
   - path: core/health-check/checks/project/node-version.js
     hash: sha256:386432f5277ae72b741074c518e8230e2b527e6ac0691a994f4bc3e1fac19516
     type: core
@@ -1217,9 +1225,9 @@ files:
     type: data
     size: 9586
   - path: data/entity-registry.yaml
-    hash: sha256:b57be94586adc273f3f57905c2a430ecc9e0135b1101dd076b8b53829b01855f
+    hash: sha256:0ef926d7947a2e9a9b95e20a7309f9910b0ba2004bf18c9472d71bdc2b5fa9c9
     type: data
-    size: 511377
+    size: 512364
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
@@ -1993,9 +2001,9 @@ files:
     type: task
     size: 11063
   - path: development/tasks/dev-develop-story.md
-    hash: sha256:41875f2ea2864b0f6b7632e62cf3a5102a1a2f4a975e49a68642066d21dc7235
+    hash: sha256:9e6c42e99c06367930615ecc87b7e126907965bacf321d324d69e74356980ef1
     type: task
-    size: 27426
+    size: 27889
   - path: development/tasks/dev-improve-code-quality.md
     hash: sha256:e781d52e3ae4b5b63204a1b1adf51dd4c653eafa3413e5250199ff9abd9403cb
     type: task
@@ -2097,9 +2105,9 @@ files:
     type: task
     size: 3608
   - path: development/tasks/health-check.yaml
-    hash: sha256:9bcc8da001b81499fb9af29877d14c06f38680774703a5c2ca6274e3dfcb6a15
+    hash: sha256:eba22298ddc94793d654be4d4082e767cd4a9157f7b7bce54ab3496cd189b43e
     type: task
-    size: 8124
+    size: 8138
   - path: development/tasks/ids-governor.md
     hash: sha256:dc904c8e0a71084f5be8980910dd096a2cff6f974c2d78f404a6a2aeabd9f81e
     type: task
@@ -2564,6 +2572,10 @@ files:
     hash: sha256:ed47917601edfe48153290ea57b3d367220ceba6b976e7222c2451af6b4a6566
     type: template
     size: 5923
+  - path: development/templates/chrome-brain/knowledge-base/claude-in-chrome.md
+    hash: sha256:b91572e0ddf072f21546a8ee7b910c692e052ba87dc3a6eb829fe049d28180c2
+    type: template
+    size: 2048
   - path: development/templates/chrome-brain/rules/chrome-brain-autoload.md
     hash: sha256:a3079e8e30f252f4a0da766b930bccc15d0288c3012482c0ad4901ccba27bc5d
     type: template
@@ -3905,9 +3917,9 @@ files:
     type: template
     size: 3691
   - path: product/templates/ide-rules/claude-rules.md
-    hash: sha256:161dca71bac7ecf6187232b9964c0889c3728afd2332967640e4eea4631668a2
+    hash: sha256:ffdaf95cccaba6355368ca2e3ba2d2675e2661c52a91adaeb5cc265dca894f5a
     type: template
-    size: 12910
+    size: 13296
   - path: product/templates/ide-rules/codex-rules.md
     hash: sha256:601ffec5e24ff5e247c25e4d61728167503722acc817a1b30fbd695182bed1bc
     type: template

package/.sinapse-ai/product/templates/ide-rules/claude-rules.md

@@ -21,10 +21,12 @@ O SINAPSE possui uma **Constitution formal** com princípios inegociáveis e gat
 |--------|-----------|------------|
 | I | CLI First | NON-NEGOTIABLE |
 | II | Agent Authority | NON-NEGOTIABLE |
-| III | Story-Driven Development | MUST |
+| III | Documentation-First Development | NON-NEGOTIABLE |
 | IV | No Invention | MUST |
 | V | Quality First | MUST |
 | VI | Absolute Imports | SHOULD |
+| VII | Ecosystem Metrics Accuracy | NON-NEGOTIABLE |
+| VIII | Mandatory Delegation | NON-NEGOTIABLE |
 
 **Gates automáticos bloqueiam violações.** Consulte a Constitution para detalhes completos.
 <!-- SINAPSE-MANAGED-END: constitution -->
@@ -73,11 +75,13 @@ When an agent is active:
 
 ## Development Methodology
 
-### Story-Driven Development
-1. **Work from stories** - All development starts with a story in `docs/stories/`
-2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
-3. **Track changes** - Maintain the File List section in the story
-4. **Follow criteria** - Implement exactly what the acceptance criteria specify
+### Documentation-First Development (NON-NEGOTIABLE)
+1. **Documentation pipeline is AUTOMATIC** - Every briefing triggers: Epic → Story → Validation → Implementation
+2. **No code without validated story** - Story must be in `docs/stories/` with status >= Ready
+3. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
+4. **Track changes** - Maintain the File List section in the story
+5. **Follow criteria** - Implement exactly what the acceptance criteria specify
+6. **Delegation is mandatory** - Orchestrators NEVER execute domain work, they ALWAYS delegate to specialists
 
 ### Code Standards
 - Write clean, self-documenting code

package/README.en.md

@@ -22,7 +22,7 @@ SINAPSE AI is not another chatbot. It is an orchestration system where each agen
 - **18 squad orchestrators (orqx)** ready to activate from the terminal
 - **175 specialized agents** with their own knowledge bases
 - **Complete workflows** for planning, development, QA and deploy
-- **Story-Driven Development** with automatic progress tracking
+- **Documentation-First Development** with automatic epic, story and validation pipeline
 - **Multi-IDE support**: Claude Code and Codex CLI
 
 ### Architecture: CLI First
@@ -166,14 +166,16 @@ SINAPSE comes with 12 core agents for the complete development cycle:
 
 ---
 
-## Story-Driven Development
+## Documentation-First Development
 
-All SINAPSE development follows stories:
+All SINAPSE development follows the automatic documentation pipeline (NON-NEGOTIABLE):
 
-1. **Stories in** `docs/stories/` with clear acceptance criteria
-2. **Progress tracked** via checkboxes `[ ]` > `[x]`
-3. **File List** kept updated in the story
-4. **Quality gates** run automatically before merge
+1. **Epic defined** for each initiative
+2. **Stories in** `docs/stories/` with clear acceptance criteria
+3. **Validation** by @product-lead before any code
+4. **Progress tracked** via checkboxes `[ ]` > `[x]`
+5. **File List** kept updated in the story
+6. **Quality gates** run automatically before merge
 
 ---
 
@@ -205,7 +207,7 @@ SINAPSE works on both IDEs. Both support most features with different approaches
 | **18 squads with 175 agents** | YES | YES | Identical on both |
 | **Knowledge bases per squad** | YES | YES | Identical on both |
 | **Tasks and workflows** | YES | YES | Identical on both |
-| **Story-Driven Development** | YES | YES | Identical on both |
+| **Documentation-First Development** | YES | YES | Identical on both |
 | **Agent commands (`*help`, `*task`)** | YES | YES | Identical on both |
 | **Squad awareness auto-routing** | YES | YES | Identical on both |
 | **NSN Mode (Never Say Never)** | YES | YES | Global rule on both |

package/README.md

@@ -22,7 +22,7 @@ O SINAPSE AI nao e mais um chatbot. E um sistema de orquestracao onde cada agent
 - **18 orquestradores de squad (orqx)** prontos para ativar direto no terminal
 - **175 agentes especializados** com knowledge bases proprias
 - **Workflows completos** de planejamento, desenvolvimento, QA e deploy
-- **Story-Driven Development** com rastreamento automatico de progresso
+- **Documentation-First Development** com pipeline automatico de epics, stories e validacao
 - **Compatibilidade multi-IDE**: Claude Code e Codex CLI
 
 ### Arquitetura: CLI First
@@ -191,14 +191,16 @@ O SINAPSE vem com 12 agentes core para o ciclo completo de desenvolvimento:
 
 ---
 
-## Story-Driven Development
+## Documentation-First Development
 
-Todo desenvolvimento no SINAPSE segue stories:
+Todo desenvolvimento no SINAPSE segue o pipeline de documentacao automatico (NON-NEGOTIABLE):
 
-1. **Stories em** `docs/stories/` com acceptance criteria claros
-2. **Progresso rastreado** via checkboxes `[ ]` > `[x]`
-3. **File List** mantida atualizada na story
-4. **Quality gates** automaticos antes de merge
+1. **Epic definida** para cada iniciativa
+2. **Stories em** `docs/stories/` com acceptance criteria claros
+3. **Validacao** por @product-lead antes de qualquer codigo
+4. **Progresso rastreado** via checkboxes `[ ]` > `[x]`
+5. **File List** mantida atualizada na story
+6. **Quality gates** automaticos antes de merge
 
 ---
 
@@ -230,7 +232,7 @@ O SINAPSE funciona em ambas as IDEs. Ambas suportam a maioria das funcionalidade
 | **18 squads com 175 agentes** | SIM | SIM | Identico em ambas |
 | **Knowledge bases por squad** | SIM | SIM | Identico em ambas |
 | **Tasks e workflows** | SIM | SIM | Identico em ambas |
-| **Story-Driven Development** | SIM | SIM | Identico em ambas |
+| **Documentation-First Development** | SIM | SIM | Identico em ambas |
 | **Agent commands (`*help`, `*task`)** | SIM | SIM | Identico em ambas |
 | **Squad awareness auto-routing** | SIM | SIM | Identico em ambas |
 | **NSN Mode (Never Say Never)** | SIM | SIM | Regra global em ambas |