sinapse-ai 1.16.0 → 1.17.0

package/.sinapse-ai/core/orchestration/route-command.js

@@ -0,0 +1,97 @@
+/**
+ * Route Command — read-only doc-first routing observability.
+ *
+ * Renders the deterministic routing decision for a briefing: project type →
+ * workflow → required upstream docs (exist/missing) → doc-first gate verdict.
+ *
+ * Intentionally lightweight: requires ONLY `doc-first-resolver` (fs + constants)
+ * and chalk. It does NOT pull the heavy orchestration index, so it has no side
+ * effects and no agent spawning.
+ *
+ * NOTE: a machine-readable `--json` mode was intentionally deferred — the
+ * framework emits an activation/cleanup summary to stdout on process exit
+ * (the same trailing line seen on `sinapse orchestrate`), which would corrupt
+ * strict JSON output. Programmatic consumers should require `doc-first-resolver`
+ * directly (clean, no side effects) instead of parsing this command's stdout.
+ *
+ * @module core/orchestration/route-command
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const { resolveDocFirstState } = require('./doc-first-resolver');
+
+let chalk;
+try {
+  chalk = require('chalk');
+} catch {
+  const id = (s) => s;
+  chalk = {
+    green: id, red: id, yellow: id, cyan: Object.assign(id, { bold: id }),
+    gray: id, bold: id, dim: id,
+  };
+}
+
+/**
+ * Execute the `route` command.
+ *
+ * @param {string} brief - User briefing (e.g. "criar um site pra X")
+ * @param {Object} [options]
+ * @param {string} [options.projectRoot] - Project root path
+ * @param {string} [options.type] - Explicit project_type override
+ * @returns {Promise<{success:boolean, exitCode:number, state:Object}>}
+ */
+async function route(brief, options = {}) {
+  const projectRoot = options.projectRoot || process.cwd();
+  const state = resolveDocFirstState({ projectRoot, brief, projectType: options.type });
+
+  const ok = (b) => (b ? chalk.green('✓') : chalk.red('✗'));
+  const briefLabel = brief ? `"${brief}"` : '(no brief — using project state only)';
+
+  console.log(chalk.cyan('\n═══════════════════════════════════════════════════════════'));
+  console.log(chalk.cyan.bold('  🧭 SINAPSE Doc-First Routing'));
+  console.log(chalk.cyan('═══════════════════════════════════════════════════════════\n'));
+
+  console.log(`Brief:        ${chalk.gray(briefLabel)}`);
+  console.log(
+    `Project type: ${chalk.bold(state.projectType)}` +
+      (state.classified ? '' : chalk.gray('  (default — not matched from brief)')),
+  );
+  console.log(`Workflow:     ${chalk.bold(state.workflow || 'SDC (no upstream re-doc)')}\n`);
+
+  if (state.artifacts.length) {
+    console.log(chalk.bold('Required upstream documents:'));
+    console.log(chalk.gray('  ┌──────────────────┬────────────────────────────────────┬────────┐'));
+    console.log(chalk.gray('  │ Document         │ Path                               │ Status │'));
+    console.log(chalk.gray('  ├──────────────────┼────────────────────────────────────┼────────┤'));
+    for (const a of state.artifacts) {
+      console.log(`  │ ${a.id.padEnd(16)} │ ${a.path.padEnd(34)} │   ${ok(a.exists)}    │`);
+    }
+    console.log(chalk.gray('  └──────────────────┴────────────────────────────────────┴────────┘\n'));
+  }
+
+  console.log(chalk.bold('Doc-first gate (required before code):'));
+  if (state.isLightType) {
+    console.log(chalk.gray('  (light task — rides on existing project; only a Ready story is required)'));
+    console.log(`  ${ok(state.gate.readyStory)} Story (status >= Ready)`);
+  } else {
+    console.log(`  ${ok(state.gate.prd)} PRD            ${chalk.gray('docs/prd.md')}`);
+    console.log(`  ${ok(state.gate.epic)} Epic           ${chalk.gray('docs/epics/')}`);
+    console.log(`  ${ok(state.gate.readyStory)} Story (Ready)  ${chalk.gray('docs/stories/')}`);
+  }
+
+  console.log('');
+  if (state.gate.satisfied) {
+    console.log(chalk.green.bold('  ✅ GATE SATISFIED — implementation may proceed.\n'));
+  } else {
+    console.log(chalk.red.bold('  🚫 GATE BLOCKED — missing: ' + state.gate.missing.join(', ')));
+    console.log(
+      chalk.gray(`     Run the ${state.workflow || 'SDC'} flow to produce these before any code.\n`),
+    );
+  }
+
+  return { success: true, exitCode: 0, state };
+}
+
+module.exports = { route };

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

@@ -1,7 +1,7 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-06-24T15:49:40.486Z'
-  entityCount: 794
+  lastUpdated: '2026-06-25T14:57:04.344Z'
+  entityCount: 796
   checksumAlgorithm: sha256
   resolutionRate: 100
 entities:
@@ -650,6 +650,7 @@ entities:
         - chrome-brain-installer
         - cli
         - component-generator
+        - route-command
       externalDeps: []
       plannedDeps:
         - logger
@@ -660,8 +661,8 @@ entities:
         score: 0.7
         constraints: []
         extensionPoints: []
-      checksum: sha256:01cae0d9971b1acaec7e62025570cc5a629fe60e91d226fde6818bf359913c78
-      lastVerified: '2026-06-21T05:24:05.627Z'
+      checksum: sha256:5ee1c859ceedbbaa2cea1463677462985f1ce9472963d4b51589bdbfc5302395
+      lastVerified: '2026-06-25T14:57:04.173Z'
     collab-start:
       path: bin/utils/collab-start.js
       layer: L1
@@ -1927,8 +1928,8 @@ entities:
         score: 0.8
         constraints: []
         extensionPoints: []
-      checksum: sha256:86d38d0a9872d7e1e57edb2aa2be1e8a74a9e5ff78b9047ab15bc463fcf1cad6
-      lastVerified: '2026-06-15T00:26:26.247Z'
+      checksum: sha256:c59435108b2a016040bafbcf6bbcf1a9ce3502446871ef5a3af908f38602cbfa
+      lastVerified: '2026-06-25T14:35:16.949Z'
     create-next-story:
       path: .sinapse-ai/development/tasks/create-next-story.md
       layer: L2
@@ -1966,8 +1967,8 @@ entities:
         score: 0.8
         constraints: []
         extensionPoints: []
-      checksum: sha256:8a42add94bb0e1233d6f47203786ff57ec53bac148be37ec6ac3ca2cb3e5e2b8
-      lastVerified: '2026-06-15T00:26:26.248Z'
+      checksum: sha256:5e3d0b592821b1136db7dcfa911ee5080055d76b2f390fe0497e8702b06f330d
+      lastVerified: '2026-06-25T14:35:16.949Z'
     create-service:
       path: .sinapse-ai/development/tasks/create-service.md
       layer: L2
@@ -5751,8 +5752,8 @@ entities:
         score: 0.8
         constraints: []
         extensionPoints: []
-      checksum: sha256:1a1b02926d2fc13d85caf9da0cbc84122cd4ec1e7ec8ec292b4d1cac190c70d3
-      lastVerified: '2026-06-15T00:26:26.299Z'
+      checksum: sha256:7ed12b65fca5657d218fbfaa40c0a05af5d3e14a17a332c089dd1147d7cb1ca9
+      lastVerified: '2026-06-25T14:35:16.977Z'
     spec-research-dependencies:
       path: .sinapse-ai/development/tasks/spec-research-dependencies.md
       layer: L2
@@ -7340,8 +7341,8 @@ entities:
         score: 0.5
         constraints: []
         extensionPoints: []
-      checksum: sha256:cc68f141e09386096f6add62717f63f0b56bb53f315eafcafc4bb649f151d25f
-      lastVerified: '2026-06-15T00:26:26.324Z'
+      checksum: sha256:ae365825677131fc9f5c6762c6a4a036be0737442bcbdb04cdbd4e3e3f547265
+      lastVerified: '2026-06-25T14:35:16.991Z'
     project-brief-tmpl:
       path: .sinapse-ai/product/templates/project-brief-tmpl.yaml
       layer: L2
@@ -11880,6 +11881,28 @@ entities:
         extensionPoints: []
       checksum: sha256:14e91bfefde4f1ee9ecea1e2902bcc43a754719b1572d93f7d2ca357c87c8312
       lastVerified: '2026-06-15T00:26:26.404Z'
+    doc-first-resolver:
+      path: .sinapse-ai/core/orchestration/doc-first-resolver.js
+      layer: L1
+      type: module
+      purpose: Entity at .sinapse-ai\core\orchestration\doc-first-resolver.js
+      keywords:
+        - doc
+        - first
+        - resolver
+      usedBy:
+        - route-command
+      dependencies:
+        - greenfield-handler
+      externalDeps: []
+      plannedDeps: []
+      lifecycle: production
+      adaptability:
+        score: 0.4
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:e3c8c695ef0b4f268a3e02a0d4258fef1ae90aaec0b281ee8c5c5fb3bd475939
+      lastVerified: '2026-06-25T14:57:04.259Z'
     epic-context-accumulator:
       path: .sinapse-ai/core/orchestration/epic-context-accumulator.js
       layer: L1
@@ -12084,6 +12107,7 @@ entities:
         - handler
       usedBy:
         - bob-orchestrator
+        - doc-first-resolver
       dependencies:
         - workflow-executor
         - surface-checker
@@ -12190,6 +12214,27 @@ entities:
         extensionPoints: []
       checksum: sha256:cfbf41b69336548b2fc4179a5513243491ca6eb501de3426f98254f118b074e7
       lastVerified: '2026-06-15T00:26:26.411Z'
+    route-command:
+      path: .sinapse-ai/core/orchestration/route-command.js
+      layer: L1
+      type: module
+      purpose: Entity at .sinapse-ai\core\orchestration\route-command.js
+      keywords:
+        - route
+        - command
+      usedBy:
+        - sinapse
+      dependencies:
+        - doc-first-resolver
+      externalDeps: []
+      plannedDeps: []
+      lifecycle: production
+      adaptability:
+        score: 0.4
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:b7a5aa520936eb819d7b577fd7b15bcee8c7f8e9e147c6fa3db9fd12a493b7f3
+      lastVerified: '2026-06-25T14:57:04.262Z'
     session-state:
       path: .sinapse-ai/core/orchestration/session-state.js
       layer: L1
@@ -15138,8 +15183,8 @@ entities:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:d0da3844cdf7e71c59a13b22e6c715b23a0ae55337aaa6dfc7248de99bdc6ff4
-      lastVerified: '2026-06-24T15:32:36.251Z'
+      checksum: sha256:fc739f0f5ec927ed9daecbd0fc74b68017ed548ce445c40b9b1ecd5f1ff2ff4b
+      lastVerified: '2026-06-25T14:35:17.067Z'
     story-development-cycle:
       path: .sinapse-ai/development/workflows/story-development-cycle.yaml
       layer: L2

package/.sinapse-ai/development/agents/snps-orqx.md

@@ -80,6 +80,15 @@ Caio's runtime test (2026-05-07) showed the framework treating fresh installs as
 > **This step runs AFTER the Initial State Audit, BEFORE the routing decision. No exceptions.**
 > Without it, Imperator routes large-project requests directly to a domain orchestrator and skips the doc-first pipeline (Article III violation).
 
+### Deterministic engine (source of truth — never hand-classify)
+
+The classification below is NOT done by reasoning from memory. It is computed by the **doc-first resolver** (`.sinapse-ai/core/orchestration/doc-first-resolver.js`) — the single source of truth shared by the CLI and the enforcement hook, so the agent and the gate can never drift:
+
+- **Observe the decision** with `sinapse route "<brief>"` — read-only, no side effects. It returns the resolved `projectType`, the required greenfield `workflow`, the upstream `artifacts` (brief → prd → spec → architecture), and whether the doc-first `gate` is already satisfied.
+- **Enforcement is automatic** — the `doc-first-gate.cjs` PreToolUse hook HARD-BLOCKS code writes in a greenfield project until PRD + epic + a `Ready` story exist. The framework repo and existing (brownfield) projects are exempt; escape with `SINAPSE_SKIP_DOCFIRST=1` only when explicitly justified.
+
+Run `sinapse route` first and let its output drive Steps 1–4 below. Steps 1–4 are the human-readable explanation of what the resolver already decided — when prose and resolver disagree, the resolver wins.
+
 After the audit reports the maturity level, classify the request **before** consulting the routing table:
 
 ### Step 1 — Detect intent

package/.sinapse-ai/development/tasks/create-doc.md

@@ -238,7 +238,7 @@ If a YAML Template has not been provided, list all templates from .sinapse-ai/pr
 
 **YOU MUST:**
 
-1. Present section content
+1. Present section content. **If the section content is a list of artifacts (epics, requirements, stories, tasks, risks), render it as a scannable approval table FIRST, following `.sinapse-ai/development/templates/approval-table.md` (verdict header → table → decision prompt). Never report a list as a count or as prose when a table schema fits.**
 2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
 3. **STOP and present numbered options 1-9:**
    - **Option 1:** Always "Proceed to next section"

package/.sinapse-ai/development/tasks/create-next-story.md

@@ -773,9 +773,8 @@ Use the primary agent from "Specialized Agent Assignment" to determine which sel
 - Ensure tasks align with both epic requirements and architecture constraints
 - Update status to "Draft" and save the story file
 - Execute `sinapse-ai/tasks/execute-checklist` `sinapse-ai/checklists/story-draft-checklist`
-- Provide summary to user including:
-  - Story created: `{devStoryLocation}/{epicNum}.{storyNum}.story.md`
-  - Status: Draft
+- Provide summary to user as a scannable **story approval table** per `.sinapse-ai/development/templates/approval-table.md` (Story summary schema: a `| Field | Value |` table + an `| AC# | Criterion | Tasks |` table), not a plain bullet list. The table MUST surface:
+  - Story created (path), Status (Draft), Acceptance count, Tasks count (linked to ACs), Dependencies
   - Key technical components included from architecture docs
   - Any deviations or conflicts noted between epic and architecture
   - Checklist Results

package/.sinapse-ai/development/tasks/spec-gather-requirements.md

@@ -302,6 +302,17 @@ structuring:
 
 ---
 
+### Phase 5: Present for Approval
+
+After structuring `requirements.json`, present the gathered requirements back to the user as
+scannable **approval tables** following `.sinapse-ai/development/templates/approval-table.md`
+(Requirements schema) — one table for Functional (`| ID | Description | Priority | Source |`),
+one for Non-Functional (`| ID | Category | Requirement | Metric/Target |`), and one for
+Constraints when present. Lead with the verdict header (`── REQUIREMENTS REVIEW · {n} item(s) · status: DRAFT ──`).
+Do NOT report only the count (e.g. "8 FR, 3 NFR") — the user must see and approve the actual rows.
+
+---
+
 ## Output Schema
 
 ```json

package/.sinapse-ai/development/templates/approval-table.md

@@ -0,0 +1,106 @@
+# Approval Table — Shared Terminal Presentation Convention
+
+> **Reusable presentation protocol.** Any task that asks the user to review or approve a
+> set of artifacts (requirements, epics, stories, tasks, risks, open questions) MUST render
+> them through this convention BEFORE asking for a decision. This is the single source of
+> truth for "scannable terminal table + verdict", so the experience is identical across
+> PRD, epic, story, and spec flows. Do not duplicate ad-hoc formats per task — reference
+> this file.
+
+## Why this exists
+
+Lists decided during planning (FRs, NFRs, epics, stories) used to be reported as counts or
+prose ("✅ 8 FR, 3 NFR"). That forces the user to open a file to actually review. This
+convention renders the real items as a scannable table the user can approve row by row,
+right in the terminal. Output language follows the project's language (PT-BR for the user
+when applicable); the schemas below are language-agnostic.
+
+## The protocol (3 parts, always in this order)
+
+1. **Verdict header** — one scannable line stating what is being reviewed and the current
+   status. Format:
+   ```
+   ── {ARTIFACT} REVIEW · {n} item(s) · status: {DRAFT|READY|APPROVED|NEEDS REVISION} ──
+   ```
+2. **The table** — render the items using the matching schema below. Keep it scannable:
+   one row per item, truncate long cells to ~60 chars with `…`, never wrap a cell across
+   lines. Use the priority/severity emoji legend when the schema has one.
+3. **The decision prompt** — after the table, ask for the decision in the form the calling
+   task requires (the 1-9 elicitation menu, or a GO / NO-GO, or `[GO] [PAUSE] [REVISE] [ABORT]`).
+   Never ask for approval without showing the table first.
+
+## Standard schemas
+
+Use the schema that matches the artifact. Add/trim columns only when the data genuinely
+requires it — keep the core columns stable so the experience is consistent.
+
+### Requirements (gather / spec)
+```
+| ID    | Description                          | Priority | Source            |
+| ----- | ------------------------------------ | -------- | ----------------- |
+| FR-1  | {functional requirement}             | 🔴 P0    | requirements.json |
+
+| ID    | Category    | Requirement              | Metric / Target   |
+| ----- | ----------- | ------------------------ | ----------------- |
+| NFR-1 | {category}  | {non-functional req}     | {measurable}      |
+
+| ID    | Type     | Constraint               | Impact            |
+| ----- | -------- | ------------------------ | ----------------- |
+| CON-1 | {type}   | {constraint}             | {impact}          |
+```
+
+### Epic list (PRD epic-list approval)
+```
+| #  | Epic                          | Goal (1 line)                         | Stories |
+| -- | ----------------------------- | ------------------------------------- | ------- |
+| 1  | Foundation & Core Infra       | {one-sentence goal}                   | ~{n}    |
+```
+
+### Epic detail — stories within an epic
+```
+| Story | As a … / I want …                 | ACs | Depends on |
+| ----- | --------------------------------- | --- | ---------- |
+| 1.1   | {user} wants {action}             | {n} | —          |
+```
+
+### Story summary (create / validate story)
+```
+| Field        | Value                                            |
+| ------------ | ------------------------------------------------ |
+| Story        | {epicNum}.{storyNum} — {title}                   |
+| Status       | {Draft \| Ready \| InProgress \| Done}           |
+| Acceptance   | {n} criteria                                     |
+| Tasks        | {n} (linked to AC: {list})                       |
+| Dependencies | {list or —}                                      |
+
+| AC# | Criterion                                  | Tasks      |
+| --- | ------------------------------------------ | ---------- |
+| 1   | {given/when/then}                          | T1, T3     |
+```
+
+### Risks & open questions (spec / plan)
+```
+| Risk            | Probability   | Impact        | Mitigation        |
+| --------------- | ------------- | ------------- | ----------------- |
+| {risk}          | 🟢/🟡/🔴      | 🟢/🟡/🔴      | {mitigation}      |
+
+| ID   | Question                  | Blocking | Assigned To |
+| ---- | ------------------------- | -------- | ----------- |
+| OQ-1 | {open question}           | Yes / No | @{agent}    |
+```
+
+## Legends
+
+- **Priority:** 🔴 P0 (must) · 🟠 P1 (should) · 🟡 P2 (could) · 🟢 P3 (won't-now)
+- **Severity / level:** 🔴 High · 🟡 Medium · 🟢 Low
+- **Status glyphs (optional inline):** ✓ done · ● in progress · ○ pending · ✗ blocked
+
+## Rules
+
+- Always render the table for a list ≥ 2 items. For a single item, a compact field table is
+  still preferred over prose.
+- The table is in addition to writing the artifact file — never replace the file, and never
+  replace the table with a count.
+- Keep within terminal width: prefer fewer, tighter columns over a wide table that wraps.
+- When iterating (NEEDS REVISION), re-render the full table with the changed rows marked
+  (prefix the changed cell with `» `), so the user sees what moved.

package/.sinapse-ai/development/workflows/spec-pipeline.yaml

@@ -208,6 +208,7 @@ workflow:
 
       on_success:
         log: "✅ Requirements gathered: {requirements.functional.length} FR, {requirements.nonFunctional.length} NFR"
+        present_table: ".sinapse-ai/development/templates/approval-table.md"  # Render FR/NFR/CON as scannable approval tables, not just the count
         next: assess
 
       on_failure:

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

@@ -7,9 +7,9 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.16.0
+version: 1.17.0
 generator: scripts/generate-install-manifest.js
-file_count: 1152
+file_count: 1163
 files:
   - path: cli/commands/config/index.js
     hash: sha256:bfa83cb1dc111b0b30dd298dc0abc2150b73f939b6cd4458effa8e6d407bc9e2
@@ -195,6 +195,34 @@ files:
     hash: sha256:e3da197727d22d7b95f31cf288faa7810f4806dcc8e448163c154ec9c0755c64
     type: config
     size: 12646
+  - path: core/atlas/atlas-data.js
+    hash: sha256:ab6ef91bd2de1498dbe3892a80b5f18d67624db1fb2da74b0e53f83de902f383
+    type: core
+    size: 11444
+  - path: core/atlas/flows-pt.js
+    hash: sha256:8db1cd79a9b3abbbf666162405bc59b8bf1e81c523d7a2709434d91118f1d5e0
+    type: core
+    size: 11499
+  - path: core/atlas/flows.js
+    hash: sha256:099392b58b9a8e2dfadb7e108949f19420acfde472406a94bd9c21e356615cab
+    type: core
+    size: 11033
+  - path: core/atlas/index.js
+    hash: sha256:ea1e47887854cf348cf29c99c6e5d6218d4e6e709db14a6caa0b289303200363
+    type: core
+    size: 2028
+  - path: core/atlas/render-html.js
+    hash: sha256:d84e928fbaa7f20f4c253758af3af486805683b66027d38d682cc453a5f68a0c
+    type: core
+    size: 11656
+  - path: core/atlas/render-markdown.js
+    hash: sha256:6d379f52785f81a697ed7e7e4a673564492f58fd79ef9a915e22331a3fdde23a
+    type: core
+    size: 12076
+  - path: core/atlas/render-research-card.js
+    hash: sha256:86086e58ea6e3f4a19229f7c755cb4072a8582e8de70e5610c58ea578276204e
+    type: core
+    size: 6069
   - path: core/code-intel/code-intel-client.js
     hash: sha256:65f6c0f2bb639ff3080db3d85660e0b8097e5af7c60dc04f582ef20f42cc9cfc
     type: core
@@ -915,6 +943,10 @@ files:
     hash: sha256:8ef9a6d27f9d1d4145fbbfb8657691582aaf0c348278edd638d55fd139edddd4
     type: core
     size: 28608
+  - path: core/orchestration/build-command.js
+    hash: sha256:b758cfc7c0fad3d0d875460630b9ac7b2c968b82cdec14e9885e0744ee7012d0
+    type: core
+    size: 5236
   - path: core/orchestration/checklist-runner.js
     hash: sha256:9bee322fb2572ef81361a3f695b2855f61d610739c612d8b6317cb1b5d6d84c9
     type: core
@@ -939,6 +971,10 @@ files:
     hash: sha256:14e91bfefde4f1ee9ecea1e2902bcc43a754719b1572d93f7d2ca357c87c8312
     type: core
     size: 10880
+  - path: core/orchestration/doc-first-resolver.js
+    hash: sha256:92a4170f3ed0b6b214608c80e17c8c6b1769a50b849532af4ae34db070a6931f
+    type: core
+    size: 14592
   - path: core/orchestration/epic-context-accumulator.js
     hash: sha256:9f38c7e3b4de7fbcfeae5fe1dc88aa3f0ae38667f1dc1da025519d40b3b9daa9
     type: core
@@ -1011,6 +1047,10 @@ files:
     hash: sha256:cfbf41b69336548b2fc4179a5513243491ca6eb501de3426f98254f118b074e7
     type: core
     size: 27167
+  - path: core/orchestration/route-command.js
+    hash: sha256:b7a5aa520936eb819d7b577fd7b15bcee8c7f8e9e147c6fa3db9fd12a493b7f3
+    type: core
+    size: 4766
   - path: core/orchestration/session-state.js
     hash: sha256:e4591fc968e8c2be07cc4572128415f3459eec75d831ba139d69faf9c7d9cacc
     type: core
@@ -1344,9 +1384,9 @@ files:
     type: data
     size: 9602
   - path: data/entity-registry.yaml
-    hash: sha256:5afcfac2ecfcbda210a85f77a18829c23a0dd80a0be5fc42c5081d419a3ac73b
+    hash: sha256:9f8ab1fd062c3d4ec2f17f1ce664fbceb5a40f356e4be340b1def175595249de
     type: data
-    size: 549348
+    size: 550671
   - path: data/learned-patterns.yaml
     hash: sha256:1a4cd045c087b9dfd7046ff1464a9d2edb85fba77cf0b6fba14f4bb9004c741e
     type: data
@@ -1480,9 +1520,9 @@ files:
     type: agent
     size: 23745
   - path: development/agents/snps-orqx.md
-    hash: sha256:313fd53fcb43bec1a0e0e1dc90867c6a6b3643e08a9a41e32e2fa86e090ce8ae
+    hash: sha256:18a195a4484b1b4b76d6a2fe71669b428e87336293a4c5764bc702249083e101
     type: agent
-    size: 42694
+    size: 43849
   - path: development/agents/sprint-lead.md
     hash: sha256:572289b770cdbb0cff9ae2de4b2d19c38ce814fe978df397aa2794297f562c91
     type: agent
@@ -1980,13 +2020,13 @@ files:
     type: task
     size: 12499
   - path: development/tasks/create-doc.md
-    hash: sha256:86d38d0a9872d7e1e57edb2aa2be1e8a74a9e5ff78b9047ab15bc463fcf1cad6
+    hash: sha256:c59435108b2a016040bafbcf6bbcf1a9ce3502446871ef5a3af908f38602cbfa
     type: task
-    size: 10344
+    size: 10669
   - path: development/tasks/create-next-story.md
-    hash: sha256:8a42add94bb0e1233d6f47203786ff57ec53bac148be37ec6ac3ca2cb3e5e2b8
+    hash: sha256:5e3d0b592821b1136db7dcfa911ee5080055d76b2f390fe0497e8702b06f330d
     type: task
-    size: 30701
+    size: 30945
   - path: development/tasks/create-service.md
     hash: sha256:5ad5920b06934637f8057e53d5acdbb918c71cd7990bfea41177f74b09f82889
     type: task
@@ -2564,9 +2604,9 @@ files:
     type: task
     size: 13643
   - path: development/tasks/spec-gather-requirements.md
-    hash: sha256:1a1b02926d2fc13d85caf9da0cbc84122cd4ec1e7ec8ec292b4d1cac190c70d3
+    hash: sha256:7ed12b65fca5657d218fbfaa40c0a05af5d3e14a17a332c089dd1147d7cb1ca9
     type: task
-    size: 14542
+    size: 15182
   - path: development/tasks/spec-research-dependencies.md
     hash: sha256:28e087134ce19d2c9f3c422604f3414d25bda5f718e0daca7da8c4620f2f62e7
     type: task
@@ -2707,6 +2747,10 @@ files:
     hash: sha256:9887e0f126e9041f70b8809efd0a659a582d08bd2a5fdd14a0e858b84529d76e
     type: template
     size: 1106
+  - path: development/templates/approval-table.md
+    hash: sha256:847bca537a5790ba9e636703cf1e36cb6b3cd9d0b8640cee9689eb1ab136a3b0
+    type: template
+    size: 5172
   - path: development/templates/chrome-brain/knowledge-base/chrome-brain.md
     hash: sha256:4b73f2a5c680aa9260e7c66a0a222a6927a0032784ca803eb309816774a5de84
     type: template
@@ -2996,9 +3040,9 @@ files:
     type: workflow
     size: 2606
   - path: development/workflows/spec-pipeline.yaml
-    hash: sha256:d0da3844cdf7e71c59a13b22e6c715b23a0ae55337aaa6dfc7248de99bdc6ff4
+    hash: sha256:fc739f0f5ec927ed9daecbd0fc74b68017ed548ce445c40b9b1ecd5f1ff2ff4b
     type: workflow
-    size: 28350
+    size: 28497
   - path: development/workflows/story-development-cycle.yaml
     hash: sha256:137fc6d2a7aedb50bbebfa045e877c382399604708ce03477f358f282b76727f
     type: workflow
@@ -4160,9 +4204,9 @@ files:
     type: template
     size: 3243
   - path: product/templates/prd-tmpl.yaml
-    hash: sha256:cc68f141e09386096f6add62717f63f0b56bb53f315eafcafc4bb649f151d25f
+    hash: sha256:ae365825677131fc9f5c6762c6a4a036be0737442bcbdb04cdbd4e3e3f547265
     type: template
-    size: 11954
+    size: 12512
   - path: product/templates/prd-v2.0.hbs
     hash: sha256:efcdadfcd994d02cb04f61de67e4b42156e49b64e9374ad57037e60104297134
     type: template

package/.sinapse-ai/product/templates/prd-tmpl.yaml

@@ -126,7 +126,9 @@ sections:
     title: Epic List
     instruction: |
       Present a high-level list of all epics for user approval. Each epic should have a title and a short (1 sentence) goal statement. This allows the user to review the overall structure before diving into details.
-      
+
+      PRESENTATION: Render the epic list as a scannable approval table per `.sinapse-ai/development/templates/approval-table.md` (Epic list schema: `| # | Epic | Goal (1 line) | Stories |`) BEFORE the 1-9 elicitation menu. Do not present epics as a count or plain prose.
+
       CRITICAL: Epics MUST be logically sequential following agile best practices:
       
       - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
@@ -147,7 +149,9 @@ sections:
     repeatable: true
     instruction: |
       After the epic list is approved, present each epic with all its stories and acceptance criteria as a complete review unit.
-      
+
+      PRESENTATION: For each epic, render its stories as a scannable approval table per `.sinapse-ai/development/templates/approval-table.md` (Epic detail schema: `| Story | As a … / I want … | ACs | Depends on |`) BEFORE the 1-9 elicitation menu, then the expanded goal and per-story detail.
+
       For each epic provide expanded goal (2-3 sentences describing the objective and value all the stories will achieve).
       
       CRITICAL STORY SEQUENCING REQUIREMENTS:

package/CHANGELOG.md

@@ -1,8 +1,24 @@
-## [1.16.0](https://github.com/caioimori/sinapse-ai/compare/1.15.0...1.16.0) (2026-06-25)
+## [1.17.0](https://github.com/caioimori/sinapse-ai/compare/1.16.0...1.17.0) (2026-06-27)
 
 ### Features
 
-* add clarify and analyze gates to Spec Pipeline ([#280](https://github.com/caioimori/sinapse-ai/issues/280)) ([18b643f](https://github.com/caioimori/sinapse-ai/commit/18b643fe6d4038bb5a9967dccdd7b34bf3b9f6cc))
+* **atlas:** complete framework flows — 6 → 12 meta-workflows ([#287](https://github.com/caioimori/sinapse-ai/issues/287)) ([1cfcb21](https://github.com/caioimori/sinapse-ai/commit/1cfcb21343336b287606d2c3c6026dcf5d2ba460))
+* **atlas:** Framework Operating Atlas — self-documenting map (LLM + visual) ([#283](https://github.com/caioimori/sinapse-ai/issues/283)) ([d3e3975](https://github.com/caioimori/sinapse-ai/commit/d3e3975f4a814eb6b658eca310cdb50eb43e722b))
+* **atlas:** framework operating flows — visual meta-workflows of how it works ([#284](https://github.com/caioimori/sinapse-ai/issues/284)) ([2dfef2f](https://github.com/caioimori/sinapse-ai/commit/2dfef2fe4e490dfdb6c59487baa519a94d8e72ae))
+* **atlas:** PT-BR research card — SINAPSE as a case-study card + LOOPS ([#288](https://github.com/caioimori/sinapse-ai/issues/288)) ([834e4f7](https://github.com/caioimori/sinapse-ai/commit/834e4f71cf2782d17f7712e50d104f5449994f72))
+* **doc-first:** routing engine + enforcement gate (Camadas 1+2) ([#282](https://github.com/caioimori/sinapse-ai/issues/282)) ([0f69937](https://github.com/caioimori/sinapse-ai/commit/0f69937933849b3262195f3ca478a61bbd0767cc))
+* **doc-first:** scannable approval tables for PRD/epic/story/spec ([#281](https://github.com/caioimori/sinapse-ai/issues/281)) ([87bba5b](https://github.com/caioimori/sinapse-ai/commit/87bba5b1cf06763a01796d8b157b82fc7e2fb536))
+* **orchestration:** sinapse build — reconnect BobOrchestrator engine to CLI ([#286](https://github.com/caioimori/sinapse-ai/issues/286)) ([c36fa09](https://github.com/caioimori/sinapse-ai/commit/c36fa095ba6a440df3d461413b305fc0e844f021))
+
+### Bug Fixes
+
+* **atlas:** remove personal-vault leak from public framework + harden guard ([#290](https://github.com/caioimori/sinapse-ai/issues/290)) ([647d16b](https://github.com/caioimori/sinapse-ai/commit/647d16bcd8df0490553412f51a3aa724677adf01))
+* **atlas:** research-card LOOPS headings use the site parser format (MF1 — …) ([#289](https://github.com/caioimori/sinapse-ai/issues/289)) ([8363fcb](https://github.com/caioimori/sinapse-ai/commit/8363fcb0a5523270e2914c51b3e9e906f97142cd))
+* **security:** deep sweep — remove residual personal/client leaks + harden guard ([#291](https://github.com/caioimori/sinapse-ai/issues/291)) ([7e82be9](https://github.com/caioimori/sinapse-ai/commit/7e82be9496b616f24b42c3af8e5f433eb729a1a8))
+
+### Documentation
+
+* **orqx:** align Imperator bootstrap prose to doc-first resolver engine ([#285](https://github.com/caioimori/sinapse-ai/issues/285)) ([9f98162](https://github.com/caioimori/sinapse-ai/commit/9f98162b238abf7e4e65c4c6ea91d9bd453aaa1d))
 
 # Changelog