sinapse-ai 1.12.2 → 1.13.0

package/packages/installer/src/wizard/questions.js

@@ -1,15 +1,15 @@
 /**
  * Wizard Questions Definitions
  *
- * Modular question system for SINAPSE installation wizard
- * Questions from Stories 1.3-1.6 will be added here
+ * Modular question system for SINAPSE installation wizard.
+ * Only the questions actually asked by the live 2-step wizard remain here
+ * (language + LLM). IDE selection helper is kept for the IDE selector module.
  *
  * @module wizard/questions
  */
 
 const { colors } = require('../utils/sinapse-colors');
-const { createInquirerValidator, validateProjectType } = require('./validators');
-const { t, getLanguageChoices, setLanguage: _setLanguage } = require('./i18n');
+const { t, getLanguageChoices } = require('./i18n');
 
 /**
  * Get language selection question (first question)
@@ -21,33 +21,7 @@ function getLanguageQuestion() {
     name: 'language',
     message: '🌐 Language:',
     choices: getLanguageChoices(),
-    default: 'en',
-  };
-}
-
-/**
- * Get user profile question (Story 10.2 - Epic 10: User Profile System)
- * @deprecated No longer asked interactively. Kept for backward compatibility.
- * @returns {Object} Inquirer question object
- */
-function getUserProfileQuestion() {
-  return {
-    type: 'list',
-    name: 'userProfile',
-    message: colors.primary(t('userProfileQuestion')),
-    choices: [
-      {
-        name:
-          colors.highlight(`🚀 ${t('modoAssistido')}`) +
-          colors.dim(` (${t('recommended')})`),
-        value: 'bob',
-      },
-      {
-        name: `⚙️  ${t('modoAvancado')}`,
-        value: 'advanced',
-      },
-    ],
-    default: 0,
+    default: 'pt',
   };
 }
 
@@ -80,32 +54,6 @@ function getLLMQuestion() {
   };
 }
 
-/**
- * Get project type question (Story 1.3)
- * @deprecated Project type is now auto-detected. Kept for backward compat.
- *
- * @returns {Object} Inquirer question object
- */
-function getProjectTypeQuestion() {
-  return {
-    type: 'list',
-    name: 'projectType',
-    message: colors.primary(t('projectTypeQuestion')),
-    choices: [
-      {
-        name: colors.highlight(t('greenfield')) + colors.dim(` (${t('greenfieldDesc')})`),
-        value: 'greenfield',
-      },
-      {
-        name: t('brownfield') + colors.dim(` (${t('brownfieldDesc')})`),
-        value: 'brownfield',
-      },
-    ],
-    default: 0,
-    validate: createInquirerValidator(validateProjectType),
-  };
-}
-
 /**
  * Get IDE selection questions (Story 1.4)
  *
@@ -116,319 +64,8 @@ function getIDEQuestions() {
   return [getIDESelectionQuestion()];
 }
 
-/**
- * Get package manager selection question (Story 1.7)
- *
- * @param {string} detectedPM - Auto-detected package manager
- * @returns {Object} Inquirer question object
- */
-function getPackageManagerQuestion(detectedPM = 'npm') {
-  return {
-    type: 'list',
-    name: 'packageManager',
-    message: colors.primary('Which package manager should be used?'),
-    choices: [
-      {
-        name: detectedPM === 'npm' ? colors.highlight('npm') + colors.dim(' (detected)') : 'npm',
-        value: 'npm',
-      },
-      {
-        name: detectedPM === 'yarn' ? colors.highlight('yarn') + colors.dim(' (detected)') : 'yarn',
-        value: 'yarn',
-      },
-      {
-        name: detectedPM === 'pnpm' ? colors.highlight('pnpm') + colors.dim(' (detected)') : 'pnpm',
-        value: 'pnpm',
-      },
-      {
-        name: detectedPM === 'bun' ? colors.highlight('bun') + colors.dim(' (detected)') : 'bun',
-        value: 'bun',
-      },
-    ],
-    default: ['npm', 'yarn', 'pnpm', 'bun'].indexOf(detectedPM) || 0,
-  };
-}
-
-/**
- * Get MCP selection questions (Story 1.5 / 1.8 Integration)
- *
- * @returns {Object[]} Array of inquirer question objects
- */
-function getMCPQuestions() {
-  return [
-    {
-      type: 'checkbox',
-      name: 'selectedMCPs',
-      message: colors.primary('Select MCPs to install (project-level):'),
-      choices: [
-        {
-          name:
-            colors.highlight('Browser (Puppeteer)') + colors.dim(' - Web automation and testing'),
-          value: 'browser',
-          checked: true,
-        },
-        {
-          name: colors.highlight('Context7') + colors.dim(' - Library documentation search'),
-          value: 'context7',
-          checked: true,
-        },
-        {
-          name: colors.highlight('Exa') + colors.dim(' - Advanced web search'),
-          value: 'exa',
-          checked: true,
-        },
-        {
-          name: colors.highlight('Desktop Commander') + colors.dim(' - File system access'),
-          value: 'desktop-commander',
-          checked: true,
-        },
-      ],
-      validate: () => {
-        // Allow empty selection (user can skip MCP installation)
-        return true;
-      },
-    },
-    // Note: API keys are configured later via sinapse-orqx or directly in .env
-  ];
-}
-
-/**
- * Get environment configuration questions (Story 1.6)
- *
- * DESIGN NOTE: Environment configuration uses its own prompt system
- * via @clack/prompts in packages/installer/src/config/configure-environment.js
- *
- * API key prompts are NOT part of wizard questions to keep the
- * environment module self-contained and testable independently.
- *
- * The wizard calls configureEnvironment() directly after IDE selection
- * in src/wizard/index.js (Task 1.6.7)
- *
- * @returns {Object[]} Empty array - prompts handled in environment module
- */
-function getEnvironmentQuestions() {
-  // Environment config prompts handled in configure-environment.js
-  // No wizard questions needed for this story
-  return [];
-}
-
-/**
- * Get Squad selection questions
- *
- * Available squads for v4.0:
- * - squad-creator: Tools to create custom squads
- * - etl: ETL pipeline for knowledge base creation
- *
- * Note: This function is currently DISABLED. Squad selection is handled
- * directly in sinapse-init.js using the squads/ directory.
- *
- * @returns {Object[]} Array of inquirer question objects
- * @deprecated Use squads/ directory directly in sinapse-init.js
- */
-function getSquadQuestions() {
-  return [
-    {
-      type: 'checkbox',
-      name: 'selectedSquads',
-      message: colors.primary('Select Squads to install (optional):'),
-      choices: [
-        {
-          name:
-            colors.highlight('squad-creator') +
-            colors.dim(' - Tools to create custom squads'),
-          value: 'squad-creator',
-          checked: false,
-        },
-        {
-          name: colors.highlight('etl') + colors.dim(' - ETL pipeline for knowledge base creation'),
-          value: 'etl',
-          checked: false,
-        },
-      ],
-      validate: () => {
-        // Allow empty selection (user can skip squad installation)
-        return true;
-      },
-    },
-  ];
-}
-
-/**
- * Get Tech Preset selection question
- *
- * Tech presets provide pre-configured architecture patterns and standards
- * for different technology stacks.
- *
- * @returns {Object[]} Array of inquirer question objects
- */
-function getTechPresetQuestion() {
-  return [
-    {
-      type: 'list',
-      name: 'selectedTechPreset',
-      message: colors.primary('Select a Tech Preset for architecture patterns:'),
-      choices: [
-        {
-          name:
-            colors.highlight('nextjs-react') +
-            colors.dim(' - Next.js 16+, React, TypeScript, Tailwind, Zustand'),
-          value: 'nextjs-react',
-        },
-        {
-          name: colors.highlight('go') + colors.dim(' - Go services and microservices'),
-          value: 'go',
-        },
-        {
-          name: colors.highlight('java') + colors.dim(' - Java 21+ with Spring Boot'),
-          value: 'java',
-        },
-        {
-          name: colors.highlight('rust') + colors.dim(' - High-reliability Rust services'),
-          value: 'rust',
-        },
-        {
-          name: colors.highlight('csharp') + colors.dim(' - .NET 9+ ASP.NET Core services'),
-          value: 'csharp',
-        },
-        {
-          name: colors.highlight('php') + colors.dim(' - PHP 8.3+ with Laravel'),
-          value: 'php',
-        },
-        {
-          name: 'None' + colors.dim(' - Let SINAPSE decide based on project'),
-          value: 'none',
-        },
-      ],
-      default: 0,
-    },
-  ];
-}
-
-/**
- * Build complete question sequence
- * Allows conditional questions based on previous answers
- *
- * @param {Object} context - Context with previous answers
- * @returns {Object[]} Array of questions
- */
-function buildQuestionSequence(_context = {}) {
-  const questions = [];
-
-  // Language selection (first question)
-  questions.push(getLanguageQuestion());
-
-  // Story 1.2: Project type is auto-detected (question removed from flow)
-
-  // Story 1.4: IDE Selection
-  questions.push(...getIDEQuestions());
-
-  // Story 1.5/1.8: MCP Selection
-  // DISABLED: MCPs are advanced config that can confuse beginners
-  // TODO: Remove entirely in future version - each project has unique MCP needs
-  // questions.push(...getMCPQuestions());
-
-  // Squad Selection - DISABLED: Handled directly in sinapse-init.js
-  // TODO: Consider removing getSquadQuestions() entirely in future version
-  // questions.push(...getSquadQuestions());
-
-  // Tech Preset Selection
-  questions.push(...getTechPresetQuestion());
-
-  // Story 1.7: Package Manager - Auto-detected (no question needed)
-  // The wizard will auto-detect and use the appropriate package manager
-  // See detectPackageManager() in dependency-installer.js
-
-  // Story 1.6: Environment Configuration
-  // Note: Env config prompts handled directly in configureEnvironment()
-  // See src/wizard/index.js integration (after IDE config step)
-
-  // Future: Conditional questions based on projectType
-  // if (context.projectType === 'greenfield') { ... }
-
-  return questions;
-}
-
-/**
- * Story 10.47 — Grounding questions (vault / design system / brand)
- *
- * Each helper returns a single inquirer `input` question. An empty answer
- * means "skip" — the corresponding grounding section stays disabled and the
- * shipped hook is a no-op. Suffixed instruction in the message reinforces
- * that skipping activates the high-quality fallback.
- */
-
-function getVaultGroundingQuestion() {
-  return {
-    type: 'input',
-    name: 'vaultPath',
-    message: '📚 Vault de notas markdown — caminho absoluto, ou Enter pra pular:',
-    default: '',
-    filter: (value) => (typeof value === 'string' ? value.trim() : ''),
-  };
-}
-
-function getDesignSystemGroundingQuestion() {
-  return {
-    type: 'input',
-    name: 'designSystemPath',
-    message: '🎨 Design system / source-of-truth visual — caminho absoluto, ou Enter pra pular:',
-    default: '',
-    filter: (value) => (typeof value === 'string' ? value.trim() : ''),
-  };
-}
-
-function getBrandGroundingQuestion() {
-  return {
-    type: 'input',
-    name: 'brandbookPath',
-    message: '🪪 Brandbook do projeto — caminho absoluto, ou Enter pra pular:',
-    default: '',
-    filter: (value) => (typeof value === 'string' ? value.trim() : ''),
-  };
-}
-
-function getGroundingQuestions() {
-  return [
-    getVaultGroundingQuestion(),
-    getDesignSystemGroundingQuestion(),
-    getBrandGroundingQuestion(),
-  ];
-}
-
-/**
- * Get question by ID
- * Useful for testing individual questions
- *
- * @param {string} questionId - Question identifier
- * @returns {Object|null} Question object or null if not found
- */
-function getQuestionById(questionId) {
-  const questionMap = {
-    projectType: getProjectTypeQuestion(),
-    // Future questions will be added here
-  };
-
-  return questionMap[questionId] || null;
-}
-
 module.exports = {
   getLanguageQuestion,
-  getUserProfileQuestion,
   getLLMQuestion,
-  getProjectTypeQuestion,
   getIDEQuestions,
-  getMCPQuestions,
-  getSquadQuestions,
-  // Backward compat alias (deprecated)
-  getExpansionPackQuestions: getSquadQuestions,
-  getTechPresetQuestion,
-  getEnvironmentQuestions,
-  getPackageManagerQuestion,
-  buildQuestionSequence,
-  getQuestionById,
-  // Story 10.47 — grounding (opt-in BYO)
-  getVaultGroundingQuestion,
-  getDesignSystemGroundingQuestion,
-  getBrandGroundingQuestion,
-  getGroundingQuestions,
 };

package/packages/installer/src/wizard/wizard.js

@@ -152,7 +152,6 @@ async function selectInstallationMode(detected, opts = {}) {
  * @param {string} [summary.language] - Language code (pt/en) or label
  * @param {string|string[]} [summary.ide] - IDE selection
  * @param {string} [summary.targetDir] - Target directory
- * @param {Object} [summary.grounding] - Grounding configuration (vault/DS/brand)
  * @param {Object} [opts]
  * @param {boolean} [opts.assumeYes=false] - Skip the confirmation prompt
  * @returns {Promise<boolean>} true if confirmed (or non-interactive), false to abort
@@ -166,14 +165,6 @@ async function confirmInstallSummary(summary, opts = {}) {
     const ide = Array.isArray(summary.ide) ? summary.ide.join(', ') : summary.ide;
     console.log(`  IDE:       ${ide}`);
   }
-  if (summary.grounding) {
-    const g = summary.grounding;
-    const parts = [];
-    if (g.vault) parts.push('vault');
-    if (g.designSystem) parts.push('design-system');
-    if (g.brand) parts.push('brand');
-    console.log(`  Grounding: ${parts.length ? parts.join(', ') : 'none'}`);
-  }
   console.log('─────────────────────────\n');
 
   if (opts.assumeYes || !isInteractive()) return true;

package/scripts/generate-install-manifest.js

@@ -76,6 +76,12 @@ const EXCLUDE_PATTERNS = [
   /^docs\/template-syntax\.md$/,
   /^docs\/troubleshooting-guide\.md$/,
   /^docs\/session-update-pattern\.md$/,
+  // Agent memory files are L3-mutable (user/agent-edited per project, see
+  // CLAUDE.md L1-L4 boundary). Their hashes churn the committed manifest on
+  // every memory change with no drift-tracking value — the brownfield upgrader
+  // must never overwrite them anyway. Anchored to the canonical nested path so
+  // we don't accidentally exclude anything else named MEMORY.md.
+  /(^|\/)development\/agents\/[^/]+\/MEMORY\.md$/,
   // Gitignored generated files
   /data\/registry-update-log\.jsonl$/,
   /data\/registry-healing-log\.jsonl$/,

package/scripts/validate-changelog-tags.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * Validate Changelog Tags
+ *
+ * Guards against release/version drift: every published git version tag MUST
+ * have a matching `## [x.y.z]` heading in CHANGELOG.md. This catches the failure
+ * mode where semantic-release publishes a version but the CHANGELOG entry was
+ * never committed back to the repo (the root cause of the 1.9.0 -> 1.12.2 drift).
+ *
+ * Usage:
+ *   node scripts/validate-changelog-tags.js
+ *   npm run validate:changelog
+ *
+ * Exit codes:
+ *   0 - Every version tag has a CHANGELOG heading (or git unavailable -> SKIP)
+ *   1 - One or more version tags are missing a CHANGELOG heading
+ */
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..');
+const CHANGELOG_PATH = path.join(ROOT, 'CHANGELOG.md');
+
+// Matches a clean semver core: x.y.z (no pre-release/build suffix).
+const SEMVER_RE = /^\d+\.\d+\.\d+$/;
+
+/**
+ * List git version tags, normalized (leading `v` stripped) and filtered to
+ * clean `x.y.z` semver. Returns null if git is unavailable (offline / no repo).
+ * @returns {string[]|null}
+ */
+function listVersionTags() {
+  let raw;
+  try {
+    raw = execFileSync('git', ['tag', '-l'], { cwd: ROOT, encoding: 'utf8' });
+  } catch {
+    return null; // git not available or not a repo
+  }
+
+  return raw
+    .split('\n')
+    .map((t) => t.trim())
+    .filter(Boolean)
+    .map((t) => t.replace(/^v/, ''))
+    .filter((t) => SEMVER_RE.test(t));
+}
+
+/**
+ * Collect all `## [x.y.z]` headings from CHANGELOG.md.
+ * @returns {Set<string>}
+ */
+function collectChangelogVersions() {
+  const content = fs.readFileSync(CHANGELOG_PATH, 'utf8');
+  const headings = new Set();
+  const re = /^##\s*\[(\d+\.\d+\.\d+)\]/gm;
+  let m;
+  while ((m = re.exec(content)) !== null) {
+    headings.add(m[1]);
+  }
+  return headings;
+}
+
+function main() {
+  const tags = listVersionTags();
+
+  if (tags === null) {
+    console.log('SKIP — git is unavailable; cannot cross-check tags vs CHANGELOG.');
+    process.exit(0);
+  }
+
+  if (!fs.existsSync(CHANGELOG_PATH)) {
+    console.error('FAIL — CHANGELOG.md not found.');
+    process.exit(1);
+  }
+
+  const documented = collectChangelogVersions();
+  const missing = tags.filter((t) => !documented.has(t)).sort();
+
+  if (missing.length > 0) {
+    console.error('FAIL — version tags without a CHANGELOG heading:');
+    for (const v of missing) {
+      console.error(`   - ${v}  (expected "## [${v}]" in CHANGELOG.md)`);
+    }
+    console.error('');
+    console.error('Add the missing entries to CHANGELOG.md before releasing.');
+    process.exit(1);
+  }
+
+  console.log(`OK — all ${tags.length} version tag(s) have a CHANGELOG heading.`);
+  process.exit(0);
+}
+
+main();