sinapse-ai 1.14.0 → 1.16.0

package/.sinapse-ai/data/entity-registry.yaml

@@ -1,7 +1,7 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-06-23T18:12:03.505Z'
-  entityCount: 792
+  lastUpdated: '2026-06-24T15:49:40.486Z'
+  entityCount: 794
   checksumAlgorithm: sha256
   resolutionRate: 100
 entities:
@@ -163,8 +163,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:cb629b45f43c34a8ba7eb4fefd1ed47f151b7ab172f799866b1a266148c89d24
-      lastVerified: '2026-06-23T02:37:28.903Z'
+      checksum: sha256:626521b1e3cdba60377871b0549a36c0da35ea5f57a9174df65273b5797508e2
+      lastVerified: '2026-06-24T05:00:49.158Z'
     local:
       path: bin/commands/local.js
       layer: L1
@@ -407,8 +407,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:3f31509f446942a48eb62f52474823676b9b1572f08c505da70a80dacc7cc352
-      lastVerified: '2026-06-15T01:36:42.607Z'
+      checksum: sha256:46f58aab3365467fc31e44b4e5db321aded90de64aa1f81a96305bd65ad90061
+      lastVerified: '2026-06-24T05:00:49.160Z'
     prompts:
       path: bin/lib/prompts.js
       layer: L1
@@ -452,8 +452,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:5233a7b0ae9828eda7f64d4729f9ebc564793c3ffe38fb74bf4a3d07a6c61608
-      lastVerified: '2026-06-16T17:13:38.683Z'
+      checksum: sha256:05d5dc88053f5d675e58a68f268d53a2f1497eb13ae63ac21f73220ecadcaca4
+      lastVerified: '2026-06-24T05:00:49.161Z'
     squads:
       path: bin/lib/squads.js
       layer: L1
@@ -486,8 +486,6 @@ entities:
         - chrome
         - brain
         - installer
-        - chrome-ensure
-        - (auto-launch)
       usedBy:
         - cli
         - install
@@ -500,8 +498,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:cac4b2b0088124c2e26f8b7bf073160ea0a73bf3942ae2fc6cce80c9707fa27b
-      lastVerified: '2026-06-23T02:37:28.905Z'
+      checksum: sha256:e1186d8324dd01d78a9f17c8a5015e51f661d952d70aa339464097e0f3d1fd97
+      lastVerified: '2026-06-24T13:49:06.202Z'
     env-config:
       path: bin/modules/env-config.js
       layer: L1
@@ -5627,6 +5625,32 @@ entities:
         extensionPoints: []
       checksum: sha256:702907ff987ef8db70bc7dba93aadcf40ba9d080321f8305dad7f9e2de10d1b2
       lastVerified: '2026-06-15T00:26:26.297Z'
+    spec-analyze:
+      path: .sinapse-ai/development/tasks/spec-analyze.md
+      layer: L2
+      type: task
+      purpose: Provar, antes de gastar geração de código, que cada requisito virou task e que nada contradiz a
+      keywords:
+        - spec
+        - analyze
+        - 'pipeline:'
+        - cross-consistency
+      usedBy:
+        - spec-pipeline
+      dependencies:
+        - architect
+      externalDeps: []
+      plannedDeps:
+        - spec
+        - constitution
+        - tasks
+      lifecycle: production
+      adaptability:
+        score: 0.8
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:5a73974cb88ca58274f907416839e8c864a3e35cf832668d3b2c582de3f6b26a
+      lastVerified: '2026-06-24T15:49:40.276Z'
     spec-assess-complexity:
       path: .sinapse-ai/development/tasks/spec-assess-complexity.md
       layer: L2
@@ -5653,6 +5677,29 @@ entities:
         extensionPoints: []
       checksum: sha256:7ef9f00dad98113dcf6c273e0d56333aece4fa892c91fff8935d3c3c552748ae
       lastVerified: '2026-06-15T00:26:26.298Z'
+    spec-clarify:
+      path: .sinapse-ai/development/tasks/spec-clarify.md
+      layer: L2
+      type: task
+      purpose: Desambiguar a especificação ANTES do QA gate e do plano. Roda DEPOIS de `write` (spec escrita)
+      keywords:
+        - spec
+        - clarify
+        - 'pipeline:'
+        - specification
+      usedBy:
+        - spec-pipeline
+      dependencies: []
+      externalDeps: []
+      plannedDeps:
+        - spec
+      lifecycle: production
+      adaptability:
+        score: 0.8
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:e4eee7ea80f146a697433462287aaff138536b148705337f2f32d66d2a83db5c
+      lastVerified: '2026-06-24T15:49:40.277Z'
     spec-critique:
       path: .sinapse-ai/development/tasks/spec-critique.md
       layer: L2
@@ -7420,8 +7467,8 @@ entities:
         score: 0.5
         constraints: []
         extensionPoints: []
-      checksum: sha256:03a71c8a3758864c3d27e4f0865734d986f4259f64af477d9fa4244f8972c7eb
-      lastVerified: '2026-06-15T00:26:26.326Z'
+      checksum: sha256:58207c62ca73c18d9584232bc62ec43ee5f11dc4337d231eee5bf2cc87d15b78
+      lastVerified: '2026-06-24T15:32:36.159Z'
     state-persistence-tmpl:
       path: .sinapse-ai/product/templates/state-persistence-tmpl.yaml
       layer: L2
@@ -13657,6 +13704,7 @@ entities:
         - plan-create-context
         - plan-create-implementation
         - qa-review-build
+        - spec-analyze
         - spec-assess-complexity
         - spec-critique
         - spec-gather-requirements
@@ -15076,7 +15124,9 @@ entities:
         - spec-assess-complexity
         - spec-research-dependencies
         - spec-write-spec
+        - spec-clarify
         - spec-critique
+        - spec-analyze
         - architect
         - analyst
       externalDeps: []
@@ -15088,8 +15138,8 @@ entities:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:890753d02dd6469441fe82a5eba0ecf48a3ac7969cfda3cd888c94cb74695c39
-      lastVerified: '2026-06-15T00:26:26.489Z'
+      checksum: sha256:d0da3844cdf7e71c59a13b22e6c715b23a0ae55337aaa6dfc7248de99bdc6ff4
+      lastVerified: '2026-06-24T15:32:36.251Z'
     story-development-cycle:
       path: .sinapse-ai/development/workflows/story-development-cycle.yaml
       layer: L2

package/.sinapse-ai/development/tasks/spec-analyze.md

@@ -0,0 +1,460 @@
+# Spec Pipeline: Analyze Cross-Consistency
+
+> **Phase:** 7 - Analyze (final, READ-ONLY)
+> **Owner Agent:** @quality-gate
+> **Pipeline:** spec-pipeline
+
+---
+
+## Purpose
+
+Provar, antes de gastar geração de código, que cada requisito virou task e que nada contradiz a
+constituição do projeto. Roda DEPOIS de `plan` (fase final do pipeline) e ANTES do handoff para
+implementação. É um gate **READ-ONLY**: não modifica nenhum arquivo — apenas lê spec ↔ plan ↔ tasks
+↔ constitution, roda 6 passes de detecção e emite uma matriz requisito→task com lacunas e
+inconsistências classificadas por severidade. Qualquer conflito constitucional é automaticamente
+CRITICAL e bloqueia a implementação.
+
+---
+
+## autoClaude
+
+```yaml
+autoClaude:
+  version: '3.0'
+  pipelinePhase: spec-analyze
+
+  elicit: false
+  deterministic: true # Same artifacts = same findings
+  composable: true
+
+  readOnly: true # Contract: never mutate any file
+  selfCritique:
+    required: false
+
+  inputs:
+    - name: storyId
+      type: string
+      required: true
+
+    - name: spec
+      type: file
+      path: docs/stories/{storyId}/spec/spec.md
+      required: true
+
+    - name: plan
+      type: file
+      path: docs/stories/{storyId}/spec/plan.json
+      required: true
+
+    - name: tasks
+      type: file
+      path: docs/stories/{storyId}/spec/tasks.md
+      required: false
+
+    - name: constitution
+      type: file
+      path: .sinapse-ai/constitution.md
+      required: true
+
+  outputs:
+    - name: analyze-report.json
+      type: file
+      path: docs/stories/{storyId}/spec/analyze-report.json
+      schema: analyze-report-schema
+
+  verification:
+    type: gate
+    blocking: true
+    verdict_field: gate
+
+  contextRequirements:
+    projectContext: true
+    filesContext: true
+    implementationPlan: true
+    spec: true
+```
+
+---
+
+## Read-Only Contract
+
+```yaml
+read_only_contract:
+  rule: 'This task MUST NOT modify any file. Findings become recommendations, never auto-fixes.'
+  rationale: 'An audit that edits the artifacts it audits cannot be trusted.'
+  violations:
+    - Editing spec.md / plan.json / tasks.md / constitution.md
+    - Applying "auto-fixes" to resolve findings
+  when_change_needed: 'Recommend the change; adjustment is done by the owner agent in a later pass.'
+```
+
+---
+
+## Detection Passes (6)
+
+Cruze 4 artefatos: `spec.md` (FR-###, SC-###, user stories, edge cases) ↔ `plan.json`
+(arquitetura, data model, fases) ↔ `tasks.md` (IDs, fases, marcador `[P]`, file paths) ↔
+`constitution.md` (princípios MUST/SHOULD).
+
+```yaml
+passes:
+  - id: pass-1
+    name: 'Duplication'
+    detects: 'Near-duplicate requirements; the same behavior specified twice'
+    default_severity: MEDIUM
+
+  - id: pass-2
+    name: 'Ambiguity'
+    detects: 'Vague adjectives (fast/scalable/secure) without a metric; TODO/??? placeholders; open [NEEDS CLARIFICATION] markers'
+    default_severity: HIGH
+
+  - id: pass-3
+    name: 'Underspecification'
+    detects: 'Requirement with no object/outcome; task referencing an undefined file/path'
+    default_severity: HIGH
+
+  - id: pass-4
+    name: 'Constitution Alignment'
+    detects: 'Conflict with a MUST principle; a mandatory constitution section absent'
+    default_severity: CRITICAL # Always
+
+  - id: pass-5
+    name: 'Coverage Gaps'
+    detects: 'Requirement (FR-*) with zero tasks; task with no mapped requirement; Success Criterion (SC-*) with no task'
+    default_severity: HIGH
+
+  - id: pass-6
+    name: 'Inconsistency'
+    detects: 'Terminology drift; entity in plan absent from spec; contradictory task ordering'
+    default_severity: MEDIUM
+```
+
+---
+
+## Severity Rules
+
+```yaml
+severity:
+  levels: [CRITICAL, HIGH, MEDIUM, LOW]
+
+  rules:
+    - 'Constitution conflict (pass-4) is ALWAYS CRITICAL — never downgraded, reinterpreted, or silently ignored.'
+    - 'Coverage gap on a P0/P1 requirement -> escalate to CRITICAL.'
+    - 'Ambiguity / Underspecification default HIGH; cosmetic-only -> LOW.'
+    - 'Duplication / Inconsistency default MEDIUM.'
+
+  max_findings: 50
+```
+
+---
+
+## Output: Findings Table + Metrics
+
+A saída humana é uma tabela de findings seguida do Coverage Summary. O artefato persistido é
+`analyze-report.json` (schema abaixo).
+
+```markdown
+## Analyze Report — {storyId}
+
+| ID  | Category | Severity | Location | Summary | Recommendation |
+| --- | -------- | -------- | -------- | ------- | -------------- |
+| A-1 | Constitution Alignment | CRITICAL | spec.md#3.1 ↔ constitution.md#Art-IV | Spec invents an unsourced feature | Remove or trace to FR-*/research; do not dilute Art. IV |
+| A-2 | Coverage Gaps | HIGH | FR-3 ↔ tasks.md | FR-3 has zero tasks | Add a task covering FR-3 |
+
+### Coverage Summary
+
+- Total Requirements: {n}
+- Total Tasks: {n}
+- Coverage: {covered}/{total} ({pct}%)
+- Ambiguity findings: {n}
+- Duplication findings: {n}
+- CRITICAL count: {n}
+```
+
+---
+
+## Gate
+
+```yaml
+gate:
+  order: 'Run AFTER plan, as the final phase, BEFORE handoff to implementation'
+  blocking: true
+
+  verdict:
+    PASS:
+      condition: 'No CRITICAL findings'
+      next_action: 'Proceed to implementation (@developer *develop)'
+    BLOCKED:
+      condition: 'One or more CRITICAL findings (includes ANY constitution conflict)'
+      next_action: |
+        Resolve CRITICAL findings before /implement by ADJUSTING spec / plan / tasks.
+        A constitution conflict MUST NOT be diluted, reinterpreted, or silently ignored.
+      escalate_to: '@architect'
+```
+
+---
+
+## Execution Flow
+
+### Step 1: Load Artifacts (read-only)
+
+```yaml
+load:
+  action: gather_all_artifacts
+  files:
+    - spec.md (required)
+    - plan.json (required)
+    - tasks.md (optional)
+    - constitution.md (required)
+  guard: 'Open read-only. No write handles.'
+```
+
+### Step 2: Build Requirement→Task Matrix
+
+```yaml
+build_matrix:
+  action: map_requirements_to_tasks
+  process: |
+    1. Extract FR-*, NFR-*, SC-* from spec.md
+    2. Extract task IDs + their referenced requirement from tasks.md
+    3. Build a bidirectional map (requirement <-> tasks)
+```
+
+### Step 3: Run 6 Detection Passes
+
+```yaml
+run_passes:
+  for_each: pass in [Duplication, Ambiguity, Underspecification, Constitution Alignment, Coverage Gaps, Inconsistency]
+  process: |
+    1. Execute detection over the relevant artifact pair(s)
+    2. Record each finding (location, summary)
+    3. Assign severity (constitution conflict ALWAYS CRITICAL)
+    4. Cap total findings at 50
+```
+
+### Step 4: Compute Metrics
+
+```yaml
+metrics:
+  action: compute_coverage
+  fields:
+    - totalRequirements
+    - totalTasks
+    - coveragePct
+    - ambiguityCount
+    - duplicationCount
+    - criticalCount
+```
+
+### Step 5: Emit Report + Verdict
+
+```yaml
+emit:
+  action: write_analyze_report
+  outputs:
+    - findings table (markdown, to user)
+    - analyze-report.json (persisted artifact)
+  verdict: 'BLOCKED if criticalCount > 0, else PASS'
+```
+
+---
+
+## Output Schema
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["storyId", "analyzedAt", "gate", "findings", "metrics"],
+  "properties": {
+    "storyId": { "type": "string" },
+    "analyzedAt": { "type": "string", "format": "date-time" },
+    "analyzedBy": { "type": "string", "default": "@quality-gate" },
+    "readOnly": { "type": "boolean", "const": true },
+    "gate": { "enum": ["PASS", "BLOCKED"] },
+    "gateReason": { "type": "string" },
+    "findings": {
+      "type": "array",
+      "maxItems": 50,
+      "items": {
+        "type": "object",
+        "required": ["id", "category", "severity", "location", "summary", "recommendation"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^A-\\d+$" },
+          "category": {
+            "enum": [
+              "Duplication",
+              "Ambiguity",
+              "Underspecification",
+              "Constitution Alignment",
+              "Coverage Gaps",
+              "Inconsistency"
+            ]
+          },
+          "severity": { "enum": ["CRITICAL", "HIGH", "MEDIUM", "LOW"] },
+          "location": { "type": "string" },
+          "summary": { "type": "string" },
+          "recommendation": { "type": "string" }
+        }
+      }
+    },
+    "metrics": {
+      "type": "object",
+      "required": ["totalRequirements", "totalTasks", "coveragePct", "criticalCount"],
+      "properties": {
+        "totalRequirements": { "type": "integer", "minimum": 0 },
+        "totalTasks": { "type": "integer", "minimum": 0 },
+        "coveragePct": { "type": "number", "minimum": 0, "maximum": 100 },
+        "ambiguityCount": { "type": "integer", "minimum": 0 },
+        "duplicationCount": { "type": "integer", "minimum": 0 },
+        "criticalCount": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}
+```
+
+---
+
+## Integration
+
+### Command Integration (@quality-gate)
+
+```yaml
+command:
+  name: '*analyze-spec'
+  syntax: '*analyze-spec {story-id}'
+  agent: qa
+
+  examples:
+    - '*analyze-spec STORY-42'
+```
+
+### Pipeline Integration
+
+```yaml
+pipeline:
+  phase: analyze
+  previous_phase: plan
+  next_phase: none # Final phase - hands off to implementation (SDC)
+
+  requires:
+    - spec.md
+    - plan.json
+    - constitution.md
+
+  optional:
+    - tasks.md
+
+  gate: true # Blocking gate
+  readOnly: true
+
+  on_verdict:
+    PASS:
+      action: handoff_to_implementation
+    BLOCKED:
+      action: halt
+      escalate_to: '@architect'
+```
+
+---
+
+## Error Handling
+
+```yaml
+errors:
+  - id: missing-spec
+    condition: 'spec.md not found'
+    action: 'Halt - cannot analyze without a spec'
+    blocking: true
+
+  - id: missing-plan
+    condition: 'plan.json not found'
+    action: 'Halt - analyze runs after plan'
+    blocking: true
+
+  - id: missing-tasks
+    condition: 'tasks.md not found'
+    action: 'Run with reduced coverage analysis; flag tasks coverage as UNKNOWN'
+    blocking: false
+
+  - id: missing-constitution
+    condition: 'constitution.md not found'
+    action: 'Halt - constitution alignment pass cannot run'
+    blocking: true
+```
+
+---
+
+## Examples
+
+### Example: BLOCKED on constitution conflict + coverage gap
+
+**Input:** spec.md adds a feature with no FR source; FR-3 has no task.
+
+**Output:**
+
+```json
+{
+  "storyId": "STORY-42",
+  "analyzedBy": "@quality-gate",
+  "readOnly": true,
+  "gate": "BLOCKED",
+  "gateReason": "1 CRITICAL (constitution conflict) + 1 HIGH (coverage gap)",
+  "findings": [
+    {
+      "id": "A-1",
+      "category": "Constitution Alignment",
+      "severity": "CRITICAL",
+      "location": "spec.md#3.1 ↔ constitution.md#Article-IV",
+      "summary": "Spec includes a feature with no FR/research source (No Invention)",
+      "recommendation": "Remove the feature or trace it to a requirement; do not dilute Article IV"
+    },
+    {
+      "id": "A-2",
+      "category": "Coverage Gaps",
+      "severity": "HIGH",
+      "location": "FR-3 ↔ tasks.md",
+      "summary": "FR-3 has zero tasks",
+      "recommendation": "Add at least one task covering FR-3"
+    }
+  ],
+  "metrics": {
+    "totalRequirements": 5,
+    "totalTasks": 7,
+    "coveragePct": 80,
+    "ambiguityCount": 0,
+    "duplicationCount": 0,
+    "criticalCount": 1
+  }
+}
+```
+
+---
+
+## Metadata
+
+```yaml
+metadata:
+  story: '3.7'
+  epic: 'Epic 3 - Spec Pipeline'
+  created: '2026-06-24'
+  author: '@quality-gate (Litmus)'
+  version: '1.0.0'
+  source: 'GitHub Spec Kit — templates/commands/analyze.md'
+  tags:
+    - spec-pipeline
+    - analyze
+    - consistency
+    - constitution
+    - read-only
+    - quality-gate
+```
+
+## Handoff
+next_agent: @developer
+next_command: *develop {story-id}
+condition: Analyze gate is PASS (no CRITICAL findings)
+alternatives:
+  - agent: @architect, command: *analyze-impact, condition: Analyze gate is BLOCKED (CRITICAL findings open)