sinapse-ai 1.19.2 → 1.20.0

package/bin/sinapse.js

@@ -11,6 +11,9 @@ const fs = require('fs');
 const os = require('os');
 const { execSync, spawnSync } = require('child_process');
 const { emitDeprecationWarning } = require('./utils/deprecation-warning');
+// Story onda2-p6 — shared, TTY-detection used by `init` to fall back to the
+// wizard's quiet/default path in non-interactive shells (see shouldRunInitQuiet below).
+const { detectInteractiveMode } = require('./lib/detection');
 
 // Story A.2 — unified logger. Levels: error/warn/info/debug.
 // Flags: --verbose, --debug, --quiet, --json. Default level: warn.
@@ -112,6 +115,8 @@ USAGE:
   sinapse validate                    # Validate installation integrity
   sinapse info                        # Show system info
   sinapse doctor                      # Run diagnostics
+  sinapse agents list                 # List all framework agents (roster)
+  sinapse ideate                      # Run self-improvement analyzers (IdeationEngine)
   sinapse telemetry status            # Show telemetry state (disabled by default)
   sinapse telemetry enable            # Opt in to anonymized telemetry
   sinapse telemetry disable           # Opt out of telemetry
@@ -159,8 +164,16 @@ GENERATE & CREATE:
   sinapse create <agent|task|workflow>        # Scaffold a new framework component
 
 ORCHESTRATION:
+  sinapse spec <story-id>                   # Story assistant: generate the REAL spec for one story
+                                             # (stops before plan/build/QA)
+  sinapse plan <story-id>                   # Story assistant: real spec + implementation PLAN
+                                             # (stops before build/QA)
   sinapse orchestrate <story-id>            # Run the autonomous dev pipeline for a story
+  sinapse orchestrate <story-id> --dry-run  # Preview the pipeline (epics + tech stack), no execution
   sinapse orchestrate --status              # Show / --stop / --resume a running pipeline
+                                             # Scope: 1 story per run — sequential multi-story in the
+                                             # same directory is not supported (measured limitation;
+                                             # see docs/epics/epic-orchestration-consolidation/KNOWN-LIMITATIONS.md)
   sinapse route "<brief>"                   # Doc-first routing: type -> workflow -> what's missing
   sinapse build "<brief>"                    # Guided orchestration: RUN the route (--dry-run, --type)
   sinapse mode [explore|ask|auto]           # Show or set the agent permission mode (--cycle)
@@ -704,6 +717,11 @@ async function runUninstall(options = {}) {
   // Optionally remove .sinapse
   if (!keepData) {
     itemsToRemove.push({ path: '.sinapse', description: 'Project data and settings' });
+    // Story onda2-p9 — .synapse/ is the context-engine runtime (generated
+    // constitution + sessions/metrics). Grouped with project data for parity
+    // with .sinapse: removed by default, preserved under --keep-data.
+    // Regenerated automatically by any future `sinapse install`/`init`.
+    itemsToRemove.push({ path: '.synapse', description: 'Context engine runtime (constitution + sessions/metrics)' });
   }
 
   // Check what exists
@@ -836,6 +854,20 @@ async function runUninstall(options = {}) {
     logger.always(`  ✓ Cleaned ${gitignoreResult.lines} SINAPSE entries from .gitignore`);
   }
 
+  // UNINSTALL-GIT-HOOKS (audit AF-20260702 item 1.3) — reset git core.hooksPath
+  // so future commits don't point at the just-removed .sinapse-ai/git-hooks
+  // dir. Reuses the exact helper bin/commands/uninstall.js already ships
+  // (parity fix) instead of duplicating the logic here.
+  const { removeGitHooksConfig } = require('./commands/uninstall');
+  const hooksResult = await removeGitHooksConfig(cwd);
+  if (!quiet) {
+    if (hooksResult.unset) {
+      logger.always('  ✓ Reset git core.hooksPath (was SINAPSE-managed)');
+    } else if (hooksResult.value) {
+      logger.always('  - git core.hooksPath kept (custom, not SINAPSE-managed)');
+    }
+  }
+
   // Summary
   if (!quiet) {
     logger.always('\n✅ SINAPSE has been uninstalled.');
@@ -917,6 +949,26 @@ Examples:
 `);
 }
 
+/**
+ * Resolve whether `sinapse init` should run the wizard in quiet/default mode.
+ *
+ * Story onda2-p6 (bug found in S4): `install` already avoids crashing in a
+ * non-interactive shell because bin/commands/install.js passes `quiet: true`
+ * unconditionally to the wizard (language/LLM are resolved upstream via its
+ * own TTY-safe prompts). `init` had no such fallback — it called the wizard
+ * with no `quiet` flag at all, so a CI runner, piped stdin, or an AI agent
+ * invoking `npx sinapse-ai init` hit the wizard's language+LLM
+ * `inquirer.prompt()` and crashed with `ERR_USE_AFTER_CLOSE`. This mirrors
+ * install's fallback: no TTY -> quiet mode -> wizard uses its own defaults
+ * (pt + claude-code, see packages/installer/src/wizard/index.js).
+ *
+ * @param {boolean} [interactive] - Defaults to the real TTY/env/argv detection.
+ * @returns {boolean} true when the wizard should skip prompts and use defaults
+ */
+function shouldRunInitQuiet(interactive = detectInteractiveMode()) {
+  return !interactive;
+}
+
 async function initProject() {
   // 1. Parse ALL args after 'init'
   const initArgs = args.slice(1);
@@ -1009,6 +1061,9 @@ async function initProject() {
     template,
     skipInstall,
     force: isForce,
+    // Story onda2-p6 — fall back to quiet/default mode without a TTY (see
+    // shouldRunInitQuiet doc comment above for the crash this prevents).
+    quiet: shouldRunInitQuiet(),
   });
 }
 
@@ -1359,6 +1414,29 @@ async function main() {
       // Without this case the most powerful pipeline (executeFullPipeline) was
       // only reachable programmatically — violating Art. I (CLI First).
       try {
+        // Story onda2-p3 (AC2): `--help` answers with usage instead of failing
+        // on a missing story-id — also what `npx sinapse-ai orchestrate --help`
+        // reaches through the canonical binary's delegation.
+        if (args.includes('--help') || args.includes('-h')) {
+          logger.always(`Usage: sinapse orchestrate <story-id> [options]
+
+Runs the autonomous dev pipeline for ONE story: spec -> plan -> build -> QA.
+Scope: 1 story per run (multi-story chaining in the same directory is not
+supported — see docs/epics/epic-orchestration-consolidation/KNOWN-LIMITATIONS.md).
+
+Options:
+  --dry-run     Preview the pipeline (epics + detected tech stack), no execution
+  --epic <N>    Start from a specific epic (3=Spec, 4=Plan/Build, 6=QA)
+  --strict      Fail on any gate failure
+  --status      Show pipeline status for the story
+  --stop        Stop a running pipeline
+  --resume      Resume a stopped pipeline
+
+Related:
+  sinapse spec <story-id>   Real spec only (stops before plan/build/QA)
+  sinapse plan <story-id>   Real spec + plan (stops before build/QA)`);
+          process.exit(0);
+        }
         const orchestration = require('../.sinapse-ai/core/orchestration');
         const epicIdx = args.indexOf('--epic');
         // The story-id is the first positional arg after `orchestrate` — i.e.
@@ -1401,6 +1479,63 @@ async function main() {
       break; // unreachable (both branches process.exit) — satisfies no-fallthrough
     }
 
+    case 'spec':
+    case 'plan': {
+      // Story onda2-p3 (audit AF-20260702 item 2.3) — the hybrid's MEASURED
+      // value (real spec + real plan for ONE story) as first-class commands.
+      // Thin subcommands over the SAME orchestrate pipeline with a phase limit:
+      // `spec` stops after Epic 3; `plan` stops after Epic 4's plan phase —
+      // both stop BEFORE build/QA. No duplicated pipeline.
+      try {
+        if (args.includes('--help') || args.includes('-h')) {
+          logger.always(
+            command === 'spec'
+              ? `Usage: sinapse spec <story-id> [--dry-run]
+
+Generates the REAL specification (spec.md) for one story and stops there —
+no plan, no build, no QA. Same pipeline as \`sinapse orchestrate\`, limited to
+the spec phase. Artifact: docs/stories/<story-id>/spec.md
+
+Next step: sinapse plan <story-id>   (spec + implementation plan)`
+              : `Usage: sinapse plan <story-id> [--dry-run]
+
+Generates the REAL specification AND the implementation plan for one story,
+then stops — no build, no QA. Same pipeline as \`sinapse orchestrate\`, limited
+to the plan phase. Artifacts: docs/stories/<story-id>/spec.md and
+docs/stories/<story-id>/plan/implementation.yaml
+
+Next step: review the plan, then implement (natively or via sinapse orchestrate).`,
+          );
+          process.exit(0);
+        }
+
+        const orchestration = require('../.sinapse-ai/core/orchestration');
+        const storyId = args.slice(1).find((a) => !a.startsWith('--'));
+        const options = {
+          projectRoot: process.cwd(),
+          dryRun: args.includes('--dry-run'),
+          strict: args.includes('--strict'),
+        };
+
+        const result =
+          command === 'spec'
+            ? await orchestration.spec(storyId, options)
+            : await orchestration.plan(storyId, options);
+
+        const exitCode =
+          result && typeof result.exitCode === 'number'
+            ? result.exitCode
+            : result && result.success === false
+              ? 1
+              : 0;
+        process.exit(exitCode);
+      } catch (error) {
+        logger.error(`❌ ${command} command error: ${error.message}`);
+        process.exit(1);
+      }
+      break; // unreachable (both branches process.exit) — satisfies no-fallthrough
+    }
+
     case 'route': {
       // Doc-first routing observability (READ-ONLY) — Art. I (CLI First).
       // Usage: sinapse route "<brief>" [--type <project_type>]
@@ -1518,6 +1653,19 @@ async function main() {
       break; // unreachable (process.exit above) — satisfies no-fallthrough
     }
 
+    case 'agents':
+    case 'ideate': {
+      // `agents`/`ideate` are owned by bin/cli.js (SCHEMA-001 agent roster +
+      // IdeationEngine). Without this, an unknown command here fell through to
+      // launchSinapse and was silently passed as a raw prompt to Claude Code —
+      // same bug class the `ids:*` delegation below already fixes, so it's
+      // fixed the same way (spawnSync into the module that really owns it).
+      const cliBin = path.join(__dirname, 'cli.js');
+      const result = spawnSync(process.execPath, [cliBin, ...args], { stdio: 'inherit' });
+      process.exit(result.status === null ? 1 : result.status);
+      break; // unreachable (process.exit above) — satisfies no-fallthrough
+    }
+
     case undefined:
       // No arguments - launch Claude Code with SINAPSE branding
       launchSinapse([]);
@@ -1547,4 +1695,4 @@ if (require.main === module) {
   });
 }
 
-module.exports = { nodeSatisfies };
+module.exports = { nodeSatisfies, shouldRunInitQuiet };

package/docs/framework/atlas/OPERATING-ATLAS.md

@@ -3,7 +3,7 @@
 > Single, generated map of how the SINAPSE framework works: routing, models,
 > constitution, workflows, agents, squads. Regenerate with `sinapse atlas`.
 > Counts are read from disk (Article VII — always exact).
-> Generated: 2026-06-26T05:56:32.158Z
+> Generated: 2026-07-02T21:47:12.575Z
 
 **At a glance:** 17 squads · 172 agents
 (12 framework + 160 squad) ·
@@ -488,13 +488,13 @@ squad workflows**. The 13 primary framework workflows have detailed docs in
 
 | Orchestrator | Persona | Squad | Role |
 |---|---|---|---|
-| `swarm-orqx` | Nexus | claude-code-mastery | Multi-Agent Systems Architect & Swarm Orchestration Specialist |
+| `swarm-orqx` | Relay | claude-code-mastery | Multi-Agent Systems Architect & Swarm Orchestration Specialist |
 | `snps-orqx` | Imperator | framework | Supreme Orchestrator of all 17 SINAPSE Squads (172 agents) |
 | `animations-orqx` | Kinetic | squad-animations | Animation Squad Orchestrator |
 | `squad-brand` | Meridian | squad-brand | Brand Squad Orchestrator — coordena os 14 agentes especialistas do squad |
 | `squad-cloning` | Helix | squad-cloning | Clone Pipeline Orchestrator — coordena o pipeline completo de clonagem cognitiva |
 | `commercial-orqx` | — | squad-commercial | Revenue Cycle Orchestrator |
-| `squad-content` | Nexus | squad-content | Content Pipeline Orchestrator — coordena todo o fluxo de deteccao, producao, publicacao e analise |
+| `squad-content` | Bulletin | squad-content | Content Pipeline Orchestrator — coordena todo o fluxo de deteccao, producao, publicacao e analise |
 | `squad-copy` | Quill Prime | squad-copy | Copy Squad Orchestrator — coordena os 12 agentes especialistas do squad |
 | `council-orqx` | Zenith | squad-council | Strategic Council Orchestrator & Wisdom Synthesizer |
 | `squad-courses` | Syllabus | squad-courses | Course Project Orchestrator — coordena o ciclo completo de criacao de cursos |

package/docs/framework/atlas/atlas-data.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-06-26T05:56:32.158Z",
+  "generatedAt": "2026-07-02T21:47:12.575Z",
   "counts": {
     "squads": 17,
     "agentsTotal": 172,
@@ -1129,7 +1129,7 @@
     },
     {
       "id": "swarm-orqx",
-      "persona": "Nexus",
+      "persona": "Relay",
       "title": "Swarm Orchestrator & Multi-Agent Architect",
       "role": "Multi-Agent Systems Architect & Swarm Orchestration Specialist",
       "squad": "claude-code-mastery",
@@ -1255,7 +1255,7 @@
     },
     {
       "id": "squad-brand",
-      "persona": "Forge",
+      "persona": "Ember",
       "title": "Creative Asset Engineer",
       "role": "Creative Asset Engineer — cria assets via codigo (SVG, CSS, HTML) e via prompt engineering para APIs generati…",
       "squad": "squad-brand",
@@ -1534,7 +1534,7 @@
     },
     {
       "id": "squad-content",
-      "persona": "Arc",
+      "persona": "Truss",
       "title": "Content Structure & Production Engineer",
       "role": "Content Structure & Production Engineer — projeta Espinha Dorsal, estrutura narrativas e escreve conteudo em …",
       "squad": "squad-content",
@@ -1552,7 +1552,7 @@
     },
     {
       "id": "squad-content",
-      "persona": "Nexus",
+      "persona": "Bulletin",
       "title": "Content Pipeline Orchestrator",
       "role": "Content Pipeline Orchestrator — coordena todo o fluxo de deteccao, producao, publicacao e analise",
       "squad": "squad-content",
@@ -1858,7 +1858,7 @@
     },
     {
       "id": "squad-courses",
-      "persona": "Lens",
+      "persona": "Slate",
       "title": "Video & Audio Production Director",
       "role": "Production Director — planeja gravacao de video/audio: roteiros, shot lists, setup",
       "squad": "squad-courses",