aios-core 4.0.0 → 4.0.2

package/.aios-core/core/synapse/scripts/generate-constitution.js

@@ -0,0 +1,204 @@
+/**
+ * Constitution Generator
+ *
+ * Reads .aios-core/constitution.md and generates .synapse/constitution
+ * in KEY=VALUE format for the SYNAPSE Context Engine L0 layer.
+ *
+ * Usage: node .aios-core/core/synapse/scripts/generate-constitution.js
+ *
+ * @module core/synapse/scripts/generate-constitution
+ * @version 1.0.0
+ * @created Story SYN-8 - Domain Content Files
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Roman numeral to Arabic number map (I-X)
+ */
+const ROMAN_TO_ARABIC = {
+  'I': 1, 'II': 2, 'III': 3, 'IV': 4, 'V': 5,
+  'VI': 6, 'VII': 7, 'VIII': 8, 'IX': 9, 'X': 10,
+};
+
+/**
+ * Clean markdown formatting from text
+ * Removes backticks and trims whitespace
+ *
+ * @param {string} text - Text with possible markdown formatting
+ * @returns {string} Cleaned text
+ */
+function cleanText(text) {
+  return text.replace(/`/g, '').trim();
+}
+
+/**
+ * Parse constitution.md and extract articles with their rules
+ *
+ * @param {string} content - Raw markdown content of constitution.md
+ * @returns {Array<{number: number, roman: string, title: string, severity: string, rules: string[]}>}
+ */
+function parseConstitution(content) {
+  if (!content || typeof content !== 'string') {
+    return [];
+  }
+
+  const articles = [];
+
+  // Match article headers: ### I. Title (SEVERITY)
+  const articleRegex = /^### ([IVXLC]+)\.\s+(.+?)\s*\(([^)]+)\)\s*$/gm;
+
+  let match;
+  const articlePositions = [];
+
+  while ((match = articleRegex.exec(content)) !== null) {
+    articlePositions.push({
+      roman: match[1],
+      title: match[2].trim(),
+      severity: match[3].trim(),
+      startIndex: match.index,
+    });
+  }
+
+  for (let i = 0; i < articlePositions.length; i++) {
+    const start = articlePositions[i].startIndex;
+    const end = i + 1 < articlePositions.length
+      ? articlePositions[i + 1].startIndex
+      : content.indexOf('## Governance', start) !== -1
+        ? content.indexOf('## Governance', start)
+        : content.length;
+
+    const articleContent = content.substring(start, end);
+    const rules = extractRules(articleContent);
+
+    const num = ROMAN_TO_ARABIC[articlePositions[i].roman];
+    if (!num) {
+      continue;
+    }
+
+    articles.push({
+      number: num,
+      roman: articlePositions[i].roman,
+      title: articlePositions[i].title,
+      severity: articlePositions[i].severity,
+      rules,
+    });
+  }
+
+  return articles;
+}
+
+/**
+ * Extract rules from article content
+ * Matches bullet points starting with MUST:, MUST NOT:, SHOULD:, SHOULD NOT:, EXCEPTION:
+ *
+ * @param {string} articleContent - Markdown content of a single article
+ * @returns {string[]} Array of rule strings
+ */
+function extractRules(articleContent) {
+  const rules = [];
+  const lines = articleContent.split('\n');
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    const ruleMatch = trimmed.match(/^-\s+(MUST(?:\s+NOT)?|SHOULD(?:\s+NOT)?|EXCEPTION):\s+(.+)$/);
+    if (ruleMatch) {
+      rules.push(`${ruleMatch[1]}: ${cleanText(ruleMatch[2])}`);
+    }
+  }
+
+  return rules;
+}
+
+/**
+ * Generate KEY=VALUE constitution content from parsed articles
+ *
+ * @param {Array<{number: number, roman: string, title: string, severity: string, rules: string[]}>} articles
+ * @returns {string} KEY=VALUE formatted content
+ */
+function generateConstitution(articles) {
+  const lines = [
+    '# SYNAPSE Constitution Domain (L0)',
+    '# Auto-generated from .aios-core/constitution.md',
+    '# DO NOT EDIT MANUALLY — re-run generate-constitution.js',
+    '',
+  ];
+
+  for (const article of articles) {
+    lines.push(`# Article ${article.roman}: ${article.title} (${article.severity})`);
+
+    // Rule 0: title + severity summary
+    lines.push(`CONSTITUTION_RULE_ART${article.number}_0=${article.title} (${article.severity})`);
+
+    // Subsequent rules from bullet points
+    for (let i = 0; i < article.rules.length; i++) {
+      lines.push(`CONSTITUTION_RULE_ART${article.number}_${i + 1}=${article.rules[i]}`);
+    }
+
+    lines.push('');
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Main entry point: read constitution.md, generate .synapse/constitution
+ *
+ * @param {object} [options] - Override paths for testing
+ * @param {string} [options.projectRoot] - Project root directory
+ * @param {string} [options.constitutionPath] - Path to constitution.md
+ * @param {string} [options.outputPath] - Path to output file
+ * @returns {{success: boolean, articles?: number, rules?: number, outputPath?: string, error?: string}}
+ */
+function main(options = {}) {
+  const projectRoot = options.projectRoot || path.resolve(__dirname, '..', '..', '..', '..');
+  const constitutionPath = options.constitutionPath || path.join(projectRoot, '.aios-core', 'constitution.md');
+  const outputPath = options.outputPath || path.join(projectRoot, '.synapse', 'constitution');
+
+  // Read source
+  let content;
+  try {
+    content = fs.readFileSync(constitutionPath, 'utf8');
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      console.error(`Constitution not found: ${constitutionPath}`);
+      process.exitCode = 1;
+      return { success: false, error: 'Constitution file not found' };
+    }
+    throw error;
+  }
+
+  // Parse articles
+  const articles = parseConstitution(content);
+
+  if (articles.length === 0) {
+    console.error('No articles found in constitution.md');
+    process.exitCode = 1;
+    return { success: false, error: 'No articles found' };
+  }
+
+  // Generate output
+  const output = generateConstitution(articles);
+
+  // Ensure output directory exists
+  const outputDir = path.dirname(outputPath);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+
+  // Write output (idempotent — overwrites cleanly)
+  fs.writeFileSync(outputPath, output, 'utf8');
+
+  const totalRules = articles.reduce((sum, a) => sum + a.rules.length + 1, 0);
+  console.log(`Constitution generated: ${articles.length} articles, ${totalRules} rules`);
+
+  return { success: true, articles: articles.length, rules: totalRules, outputPath };
+}
+
+// Run if called directly
+if (require.main === module) {
+  main();
+}
+
+module.exports = { parseConstitution, extractRules, generateConstitution, cleanText, main, ROMAN_TO_ARABIC };

package/.aios-core/core/synapse/utils/tokens.js

@@ -0,0 +1,25 @@
+/**
+ * SYNAPSE Token Utilities
+ *
+ * Shared token estimation used by formatter and memory bridge.
+ *
+ * @module core/synapse/utils/tokens
+ * @version 1.0.0
+ * @created Story SYN-10 - Pro Memory Bridge (extracted from formatter.js)
+ */
+
+'use strict';
+
+/**
+ * Estimate the number of tokens from a string.
+ *
+ * Uses the proven heuristic: tokens ~ string.length / 4
+ *
+ * @param {string} text - Text to estimate
+ * @returns {number} Estimated token count
+ */
+function estimateTokens(text) {
+  return Math.ceil((text || '').length / 4);
+}
+
+module.exports = { estimateTokens };

package/.aios-core/data/aios-kb.md

@@ -82,7 +82,7 @@ AIOS transforms you into a "Vibe CEO" - directing a team of specialized AI agent
 
 #### Option 2: IDE Integration
 
-**Best for**: Cursor, Claude Code, Windsurf, Trae, Cline, Roo Code, Github Copilot users
+**Best for**: Cursor, Claude Code, Windsurf, Cline, Roo Code, Gemini CLI, Github Copilot users
 
 ```bash
 # Interactive installation (recommended)
@@ -96,7 +96,6 @@ npx @synkra/aios-core install
   - **Cursor**: Native AI integration
   - **Claude Code**: Anthropic's official IDE
   - **Windsurf**: Built-in AI capabilities
-  - **Trae**: Built-in AI capabilities
   - **Cline**: VS Code extension with AI features
   - **Roo Code**: Web-based IDE with agent support
   - **GitHub Copilot**: VS Code extension with AI peer programming assistant
@@ -299,13 +298,12 @@ You are the "Vibe CEO" - thinking like a CEO with unlimited resources and a sing
 - **Claude Code**: `/agent-name` (e.g., `/aios-master`)
 - **Cursor**: `@agent-name` (e.g., `@aios-master`)
 - **Windsurf**: `@agent-name` (e.g., `@aios-master`)
-- **Trae**: `@agent-name` (e.g., `@aios-master`)
 - **Roo Code**: Select mode from mode selector (e.g., `aios-master`)
 - **GitHub Copilot**: Open the Chat view (`⌃⌘I` on Mac, `Ctrl+Alt+I` on Windows/Linux) and select **Agent** from the chat mode selector.
 
 **Chat Management Guidelines**:
 
-- **Claude Code, Cursor, Windsurf, Trae**: Start new chats when switching agents
+- **Claude Code, Cursor, Windsurf**: Start new chats when switching agents
 - **Roo Code**: Switch modes within the same conversation
 
 **Common Task Commands**:

package/.aios-core/data/entity-registry.yaml

@@ -1,7 +1,7 @@
 metadata:
   version: 1.0.0
-  lastUpdated: '2026-02-11T02:17:11.048Z'
-  entityCount: 484
+  lastUpdated: '2026-02-12T13:07:01.327Z'
+  entityCount: 487
   checksumAlgorithm: sha256
 entities:
   tasks:
@@ -6432,7 +6432,6 @@ entities:
         - check
       usedBy:
         - check-registry
-        - engine
         - console
         - json
         - markdown
@@ -6501,18 +6500,20 @@ entities:
     engine:
       path: .aios-core/core/health-check/engine.js
       type: module
-      purpose: Entity at .aios-core\core\health-check\engine.js
+      purpose: Entity at .aios-core\core\synapse\engine.js
       keywords:
         - engine
       usedBy: []
       dependencies:
-        - base-check
+        - context-tracker
+        - formatter
+        - memory-bridge
       adaptability:
         score: 0.4
         constraints: []
         extensionPoints: []
-      checksum: sha256:4388d1c988d3789c6e8626c265ebb6811c56a69cda4e1e0bf92a340bf08542b8
-      lastVerified: '2026-02-08T13:33:24.335Z'
+      checksum: sha256:90572bd719491e1f57bc43cb29179ad8de34db9d752fff54bf8638d9fcf22bc7
+      lastVerified: '2026-02-12T13:07:01.326Z'
     ideation-engine:
       path: .aios-core/core/ideation/ideation-engine.js
       type: module
@@ -8430,7 +8431,8 @@ entities:
       keywords:
         - context
         - tracker
-      usedBy: []
+      usedBy:
+        - engine
       dependencies: []
       adaptability:
         score: 0.4
@@ -8438,6 +8440,57 @@ entities:
         extensionPoints: []
       checksum: sha256:3b09f8323fab171e3aaa7a3a079b6cd65f6fd5775e661c24c295a4775cb31a68
       lastVerified: '2026-02-11T02:17:11.045Z'
+    memory-bridge:
+      path: .aios-core/core/synapse/memory/memory-bridge.js
+      type: module
+      purpose: Entity at .aios-core\core\synapse\memory\memory-bridge.js
+      keywords:
+        - memory
+        - bridge
+      usedBy:
+        - engine
+      dependencies:
+        - tokens
+        - feature-gate
+        - synapse-memory-provider
+      adaptability:
+        score: 0.4
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:5f039ad6aa1ab15250efbb2eb20346b95ba545c6d9c270ee7abf96e18930db1e
+      lastVerified: '2026-02-12T13:07:01.327Z'
+    formatter:
+      path: .aios-core/core/synapse/output/formatter.js
+      type: module
+      purpose: Entity at .aios-core\core\synapse\output\formatter.js
+      keywords:
+        - formatter
+      usedBy:
+        - engine
+      dependencies:
+        - tokens
+      adaptability:
+        score: 0.4
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:fe4f6c2f6091defb6af66dad71db0640f919b983111087f8cc5821e3d44ca864
+      lastVerified: '2026-02-12T12:53:14.531Z'
+    tokens:
+      path: .aios-core/core/synapse/utils/tokens.js
+      type: module
+      purpose: Entity at .aios-core\core\synapse\utils\tokens.js
+      keywords:
+        - tokens
+      usedBy:
+        - memory-bridge
+        - formatter
+      dependencies: []
+      adaptability:
+        score: 0.4
+        constraints: []
+        extensionPoints: []
+      checksum: sha256:3b927daec51d0a791f3fe4ef9aafc362773450e7cf50eb4b6d8ae9011d70df9a
+      lastVerified: '2026-02-12T12:53:14.532Z'
   agents:
     aios-master:
       path: .aios-core/development/agents/aios-master.md

package/.aios-core/development/scripts/unified-activation-pipeline.js

@@ -49,7 +49,15 @@ const { PermissionMode } = require('../../core/permissions');
 const GreetingPreferenceManager = require('./greeting-preference-manager');
 const ContextDetector = require('../../core/session/context-detector');
 const WorkflowNavigator = require('./workflow-navigator');
-const { isProAvailable, loadProModule } = require('../../../bin/utils/pro-detector');
+// BUG-1 fix (INS-1): Graceful degradation when pro-detector is not available
+// In installed projects, bin/utils/pro-detector.js does not exist
+let isProAvailable, loadProModule;
+try {
+  ({ isProAvailable, loadProModule } = require('../../../bin/utils/pro-detector'));
+} catch {
+  isProAvailable = () => false;
+  loadProModule = () => null;
+}
 
 /**
  * ACT-11: Loader importance tiers with per-tier timeout budgets.

package/.aios-core/framework-config.yaml

@@ -13,7 +13,7 @@
 # --- Metadata (framework portion) ---
 metadata:
   name: "Synkra AIOS"
-  framework_version: "3.12.0"
+  framework_version: "4.0.0"
 
 markdownExploder: true
 

package/.aios-core/install-manifest.yaml

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 4.0.0
-generated_at: "2026-02-11T18:08:18.624Z"
+version: 4.0.2
+generated_at: "2026-02-13T01:40:56.998Z"
 generator: scripts/generate-install-manifest.js
-file_count: 968
+file_count: 971
 files:
   - path: cli/commands/config/index.js
     hash: sha256:ebcad2ce3807eda29dcddff76d7a95ddc9b7fa160df21fd608f94b802237e862
@@ -101,9 +101,9 @@ files:
     type: cli
     size: 12322
   - path: cli/commands/pro/index.js
-    hash: sha256:d686da33f3a9ac2a77dd590ef0cd6ae27734898a2023781134f54fee38abf4a8
+    hash: sha256:9afa5f4574b5c35f22ddac27fa5fd2b3ba21dce54eb793547a21414081787cc6
     type: cli
-    size: 21790
+    size: 19767
   - path: cli/commands/qa/index.js
     hash: sha256:ff9c3669e31319d5e7be9b42a45f8ef7b9525ed2094e320000bc06cdd0625ca7
     type: cli
@@ -853,13 +853,13 @@ files:
     type: core
     size: 5581
   - path: core/synapse/domain/domain-loader.js
-    hash: sha256:30f7a1810b0bf931efa95e819e26baa4f995b847cc4f4488be1532355b63930a
+    hash: sha256:af788f9da956b89eef1e5eb4ef4efdf05ca758c8969a2c375f568119495ebc05
     type: core
-    size: 8124
+    size: 8122
   - path: core/synapse/engine.js
-    hash: sha256:0421993986b813d176f9b136c13b5123219309493af27aa796d51ec0206a8763
+    hash: sha256:90572bd719491e1f57bc43cb29179ad8de34db9d752fff54bf8638d9fcf22bc7
     type: core
-    size: 9858
+    size: 10410
   - path: core/synapse/layers/l0-constitution.js
     hash: sha256:2123a6a44915aaac2a6bbd26c67c285c9d1e12b50fe42a8ada668306b07d1c4a
     type: core
@@ -896,10 +896,18 @@ files:
     hash: sha256:73cb0e5b4bada80d8e256009004679e483792077fac4358c6466cd77136f79fa
     type: core
     size: 2881
+  - path: core/synapse/memory/memory-bridge.js
+    hash: sha256:5f039ad6aa1ab15250efbb2eb20346b95ba545c6d9c270ee7abf96e18930db1e
+    type: core
+    size: 6771
   - path: core/synapse/output/formatter.js
-    hash: sha256:b29c7be4f3806a1234ed58ea1bb7ca66bfbb1417445f016b96a78bc332e72f6e
+    hash: sha256:fe4f6c2f6091defb6af66dad71db0640f919b983111087f8cc5821e3d44ca864
     type: core
-    size: 15688
+    size: 16418
+  - path: core/synapse/scripts/generate-constitution.js
+    hash: sha256:65405d3e4ee080d19a25fb8967e159360a289e773c15253a351ee163b469e877
+    type: script
+    size: 6160
   - path: core/synapse/session/session-manager.js
     hash: sha256:6127c2ef1c6db83cfd5796443789964a8da72635b23b367fb351592c070d05dd
     type: core
@@ -908,6 +916,10 @@ files:
     hash: sha256:bf8cf93c1a16295e7de055bee292e2778a152b6e7d6c648dbc054a4b04dffc10
     type: core
     size: 1464
+  - path: core/synapse/utils/tokens.js
+    hash: sha256:3b927daec51d0a791f3fe4ef9aafc362773450e7cf50eb4b6d8ae9011d70df9a
+    type: core
+    size: 573
   - path: core/ui/index.js
     hash: sha256:e2ead179c646b8f36046134c631c24f35a151dbf5a1e95c0e4311bf1652abe12
     type: core
@@ -937,13 +949,13 @@ files:
     type: data
     size: 10965
   - path: data/aios-kb.md
-    hash: sha256:21138a86582b713c2106973907bbf4a5ce4e3192dadd832122ac9c6294d0efb1
+    hash: sha256:c3596f743ba36a99618ab32ab0a5b3c2419ca91128fb79a66e44ebbf7474806f
     type: data
-    size: 34868
+    size: 34780
   - path: data/entity-registry.yaml
-    hash: sha256:3a2e08c260f59b2ca6da398ed94a86ff10326e969655d9356314585e93a04702
+    hash: sha256:c02059828c5708815bf6ac1cb3664c2898ecfff06f9d47413fe68caf1fa969ae
     type: data
-    size: 277558
+    size: 279148
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
@@ -1293,9 +1305,9 @@ files:
     type: script
     size: 17607
   - path: development/scripts/unified-activation-pipeline.js
-    hash: sha256:11c9a7f19044ed38df9e47d26feb1ba5346efd15bd4ec856c871722386575f1b
+    hash: sha256:c3a42ca88075291e67531301a5788d2f6e0e19dee20cde940e7b0c48e9bcade8
     type: script
-    size: 25058
+    size: 25316
   - path: development/scripts/usage-tracker.js
     hash: sha256:b3079713787de7c6ac38a742255861f04e8359ef1b227836040920a64b7e8aac
     type: script
@@ -3065,9 +3077,9 @@ files:
     type: monitor
     size: 818
   - path: package.json
-    hash: sha256:9998a56094f4a308c534d4dd9b29721ef50aabc0c50633763f5c1ac7b7f3da48
+    hash: sha256:dff580c83cc1554c75162c9cabb711b5cd85e679c9c8f4968ee74499e99de0c0
     type: other
-    size: 2378
+    size: 2401
   - path: product/checklists/accessibility-wcag-checklist.md
     hash: sha256:56126182b25e9b7bdde43f75315e33167eb49b1f9a9cb0e9a37bc068af40aeab
     type: checklist
@@ -3801,9 +3813,9 @@ files:
     type: script
     size: 1708
   - path: user-guide.md
-    hash: sha256:abcef62ecd991d311ef2b1858ae14aeed76e7e9d3579fab73760936926c57553
+    hash: sha256:a6c60f9781589f7e9e87ff1b488cdd842f6e1b03a74b71695cdfe14a0a5589c8
     type: documentation
-    size: 38581
+    size: 38582
   - path: workflow-intelligence/__tests__/confidence-scorer.test.js
     hash: sha256:237216842d3eb710ae33f3aba6c7b2a6a353cccc1dea6d4b927d8d063d9cb635
     type: workflow-intelligence

package/.aios-core/lib/build.json

@@ -0,0 +1 @@
+{"built": true}

package/.aios-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aios-fullstack/core",
-  "version": "4.31.0",
+  "version": "4.31.1",
   "description": "AIOS-FullStack Core - Meta-agent and component generation system",
   "main": "index.js",
   "module": "index.esm.js",
@@ -39,6 +39,7 @@
     "inquirer": "^8.2.6",
     "validator": "^13.15.15",
     "diff": "^5.2.0",
+    "execa": "^5.1.1",
     "highlight.js": "^11.9.0"
   },
   "peerDependencies": {

package/.aios-core/user-guide.md

@@ -59,7 +59,7 @@ npx @aios/fullstack install
   ◉ Claude Code (.claude/commands/)
   ◉ Cursor (.cursor/rules/)
   ◯ Windsurf (.windsurf/rules.md)
-  ◯ Trae (.trae/agents/)
+  ◯ Gemini CLI (.gemini/)
 
 📝 Sharding Preferences:
   ◯ Single file (all in one document)

package/.claude/CLAUDE.md

@@ -70,16 +70,15 @@ CLI First → Observability Second → UI Third
 aios-core/
 ├── .aios-core/              # Core do framework
 │   ├── core/                # Módulos principais (orchestration, memory, etc.)
-│   ├── development/         # Agents, tasks, templates, checklists
-│   └── scripts/             # Utilitários e scripts
-├── apps/
-│   └── dashboard/           # Dashboard Next.js (Observability + UI)
+│   ├── data/                # Knowledge base, entity registry
+│   ├── development/         # Agents, tasks, templates, checklists, scripts
+│   └── infrastructure/      # CI/CD templates, scripts
 ├── bin/                     # CLI executables (aios-init.js, aios.js)
-├── src/                     # Source code
 ├── docs/                    # Documentação
 │   └── stories/             # Development stories (active/, completed/)
-├── squads/                  # Expansion packs
 ├── packages/                # Shared packages
+├── pro/                     # Pro submodule (proprietary)
+├── squads/                  # Squad expansions
 └── tests/                   # Testes
 ```
 
@@ -114,11 +113,11 @@ Use prefixo `*` para comandos:
 
 | Agente | Diretórios Principais |
 |--------|----------------------|
-| `@dev` | `src/`, `packages/`, `.aios-core/core/` |
+| `@dev` | `packages/`, `.aios-core/core/`, `bin/` |
 | `@architect` | `docs/architecture/`, system design |
 | `@data-engineer` | `packages/db/`, migrations, schema |
 | `@qa` | `tests/`, `*.test.js`, quality gates |
-| `@po` | `docs/stories/`, epics, requirements |
+| `@po` | Stories, epics, requirements |
 | `@devops` | `.github/`, CI/CD, git operations |
 
 ---
@@ -313,5 +312,5 @@ tail -f .aios/logs/agent.log
 
 ---
 
-*Synkra AIOS Claude Code Configuration v3.0*
+*Synkra AIOS Claude Code Configuration v4.0*
 *CLI First | Observability Second | UI Third*