aios-core 3.2.0 → 3.4.0

package/.aios-core/infrastructure/scripts/ide-sync/validator.js

@@ -0,0 +1,273 @@
+/**
+ * Validator - Verifies IDE sync status
+ * @story 6.19 - IDE Command Auto-Sync System
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const crypto = require('crypto');
+const { getRedirectFilenames } = require('./redirect-generator');
+
+/**
+ * Calculate content hash for comparison
+ * @param {string} content - File content
+ * @returns {string} - SHA256 hash
+ */
+function hashContent(content) {
+  // Normalize line endings for cross-platform consistency
+  const normalized = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+  return crypto.createHash('sha256').update(normalized, 'utf8').digest('hex');
+}
+
+/**
+ * Check if a file exists at target path
+ * @param {string} filePath - Path to check
+ * @returns {boolean} - True if file exists
+ */
+function fileExists(filePath) {
+  return fs.existsSync(filePath);
+}
+
+/**
+ * Read file content if it exists
+ * @param {string} filePath - Path to read
+ * @returns {string|null} - File content or null
+ */
+function readFileIfExists(filePath) {
+  try {
+    if (fs.existsSync(filePath)) {
+      return fs.readFileSync(filePath, 'utf8');
+    }
+  } catch (error) {
+    // Ignore read errors
+  }
+  return null;
+}
+
+/**
+ * Validate sync status for a single IDE
+ * @param {object[]} expectedFiles - Array of {filename, content} expected
+ * @param {string} targetDir - Target directory to check
+ * @param {object} redirectsConfig - Redirects configuration
+ * @returns {object} - Validation result
+ */
+function validateIdeSync(expectedFiles, targetDir, redirectsConfig) {
+  const result = {
+    targetDir,
+    missing: [],
+    drift: [],
+    orphaned: [],
+    synced: [],
+    total: {
+      expected: expectedFiles.length,
+      missing: 0,
+      drift: 0,
+      orphaned: 0,
+      synced: 0,
+    },
+  };
+
+  // Track expected filenames
+  const expectedFilenames = new Set(expectedFiles.map(f => f.filename));
+
+  // Add redirect filenames to expected
+  const redirectFilenames = getRedirectFilenames(redirectsConfig);
+  for (const rf of redirectFilenames) {
+    expectedFilenames.add(rf);
+  }
+
+  // Check each expected file
+  for (const expected of expectedFiles) {
+    const targetPath = path.join(targetDir, expected.filename);
+    const actualContent = readFileIfExists(targetPath);
+
+    if (actualContent === null) {
+      // File is missing
+      result.missing.push({
+        filename: expected.filename,
+        path: targetPath,
+      });
+      result.total.missing++;
+    } else {
+      // Compare content
+      const expectedHash = hashContent(expected.content);
+      const actualHash = hashContent(actualContent);
+
+      if (expectedHash !== actualHash) {
+        // Content differs (drift)
+        result.drift.push({
+          filename: expected.filename,
+          path: targetPath,
+          expectedHash,
+          actualHash,
+        });
+        result.total.drift++;
+      } else {
+        // File is synced
+        result.synced.push({
+          filename: expected.filename,
+          path: targetPath,
+        });
+        result.total.synced++;
+      }
+    }
+  }
+
+  // Check for orphaned files (files in target not in expected)
+  if (fs.existsSync(targetDir)) {
+    try {
+      const actualFiles = fs.readdirSync(targetDir).filter(f => f.endsWith('.md'));
+
+      for (const file of actualFiles) {
+        if (!expectedFilenames.has(file)) {
+          result.orphaned.push({
+            filename: file,
+            path: path.join(targetDir, file),
+          });
+          result.total.orphaned++;
+        }
+      }
+    } catch (error) {
+      // Ignore directory read errors
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Validate sync status for all IDEs
+ * @param {object} ideConfigs - Map of IDE name to {expectedFiles, targetDir}
+ * @param {object} redirectsConfig - Redirects configuration
+ * @returns {object} - Full validation result
+ */
+function validateAllIdes(ideConfigs, redirectsConfig) {
+  const results = {
+    ides: {},
+    summary: {
+      total: 0,
+      synced: 0,
+      missing: 0,
+      drift: 0,
+      orphaned: 0,
+      pass: true,
+    },
+  };
+
+  for (const [ideName, config] of Object.entries(ideConfigs)) {
+    const ideResult = validateIdeSync(
+      config.expectedFiles,
+      config.targetDir,
+      redirectsConfig
+    );
+
+    results.ides[ideName] = ideResult;
+
+    // Update summary
+    results.summary.total += ideResult.total.expected;
+    results.summary.synced += ideResult.total.synced;
+    results.summary.missing += ideResult.total.missing;
+    results.summary.drift += ideResult.total.drift;
+    results.summary.orphaned += ideResult.total.orphaned;
+  }
+
+  // Pass if no missing or drift
+  results.summary.pass =
+    results.summary.missing === 0 && results.summary.drift === 0;
+
+  return results;
+}
+
+/**
+ * Format validation result as report string
+ * @param {object} results - Validation results
+ * @param {boolean} verbose - Include detailed file lists
+ * @returns {string} - Formatted report
+ */
+function formatValidationReport(results, verbose = false) {
+  const lines = [];
+
+  lines.push('# IDE Sync Validation Report');
+  lines.push('');
+
+  // Summary
+  lines.push('## Summary');
+  lines.push('');
+  lines.push(`| Metric | Count |`);
+  lines.push(`|--------|-------|`);
+  lines.push(`| Total Expected | ${results.summary.total} |`);
+  lines.push(`| Synced | ${results.summary.synced} |`);
+  lines.push(`| Missing | ${results.summary.missing} |`);
+  lines.push(`| Drift | ${results.summary.drift} |`);
+  lines.push(`| Orphaned | ${results.summary.orphaned} |`);
+  lines.push('');
+
+  const status = results.summary.pass ? '✅ PASS' : '❌ FAIL';
+  lines.push(`**Status:** ${status}`);
+  lines.push('');
+
+  // Per-IDE details
+  if (verbose) {
+    lines.push('## IDE Details');
+    lines.push('');
+
+    for (const [ideName, ideResult] of Object.entries(results.ides)) {
+      lines.push(`### ${ideName}`);
+      lines.push('');
+      lines.push(`- Target: \`${ideResult.targetDir}\``);
+      lines.push(`- Synced: ${ideResult.total.synced}`);
+      lines.push(`- Missing: ${ideResult.total.missing}`);
+      lines.push(`- Drift: ${ideResult.total.drift}`);
+      lines.push(`- Orphaned: ${ideResult.total.orphaned}`);
+      lines.push('');
+
+      if (ideResult.missing.length > 0) {
+        lines.push('**Missing Files:**');
+        for (const f of ideResult.missing) {
+          lines.push(`- ${f.filename}`);
+        }
+        lines.push('');
+      }
+
+      if (ideResult.drift.length > 0) {
+        lines.push('**Drifted Files:**');
+        for (const f of ideResult.drift) {
+          lines.push(`- ${f.filename}`);
+        }
+        lines.push('');
+      }
+
+      if (ideResult.orphaned.length > 0) {
+        lines.push('**Orphaned Files:**');
+        for (const f of ideResult.orphaned) {
+          lines.push(`- ${f.filename}`);
+        }
+        lines.push('');
+      }
+    }
+  }
+
+  // Fix instructions
+  if (!results.summary.pass) {
+    lines.push('## How to Fix');
+    lines.push('');
+    lines.push('Run the following command to sync IDE files:');
+    lines.push('');
+    lines.push('```bash');
+    lines.push('npm run sync:ide');
+    lines.push('```');
+    lines.push('');
+    lines.push('Then commit the generated files.');
+  }
+
+  return lines.join('\n');
+}
+
+module.exports = {
+  hashContent,
+  fileExists,
+  readFileIfExists,
+  validateIdeSync,
+  validateAllIdes,
+  formatValidationReport,
+};

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

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 3.2.0
-generated_at: "2025-12-22T19:07:31.838Z"
+version: 3.4.0
+generated_at: "2025-12-23T02:05:10.189Z"
 generator: scripts/generate-install-manifest.js
-file_count: 555
+file_count: 564
 files:
   - path: cli/commands/generate/index.js
     hash: sha256:36f8e38ab767fa5478d8dabac548c66dc2c0fc521c216e954ac33fcea0ba597b
@@ -165,9 +165,9 @@ files:
     type: cli
     size: 5907
   - path: core-config.yaml
-    hash: sha256:5af2cf56303f66230e7fb1a106fcdaa10072b88fa3c9185a56d0b2e36c838839
+    hash: sha256:238af11d4bd06c600b65aec6bad627ecd87c1d4c037447bb5aa7befd474ad2f1
     type: config
-    size: 14289
+    size: 15370
   - path: core/config/config-cache.js
     hash: sha256:527a788cbe650aa6b13d1101ebc16419489bfef20b2ee93042f6eb6a51e898e9
     type: core
@@ -1368,6 +1368,42 @@ files:
     hash: sha256:e4354cbceb1d3fe64f0a32b3b69e3f12e55f4a5770412b7cd31f92fe2cf3278c
     type: script
     size: 9735
+  - path: infrastructure/scripts/ide-sync/agent-parser.js
+    hash: sha256:f18531d68ffec3f661b81c528bff0929bac6fa26213f28affbfebb2faca091db
+    type: script
+    size: 7428
+  - path: infrastructure/scripts/ide-sync/index.js
+    hash: sha256:9e792b680a1ed19893d10fe27aa14f2ccf2235004d62f83bd052d2dde75c1aeb
+    type: script
+    size: 12879
+  - path: infrastructure/scripts/ide-sync/redirect-generator.js
+    hash: sha256:658725f2832d331ee83350e620e5a79a499492172fc8f44174749e3471feb77f
+    type: script
+    size: 4518
+  - path: infrastructure/scripts/ide-sync/transformers/antigravity.js
+    hash: sha256:f78399acdc7557f496abcffcd252e722e91f06afe16859b5066882954d9cd23e
+    type: script
+    size: 2687
+  - path: infrastructure/scripts/ide-sync/transformers/claude-code.js
+    hash: sha256:f028bdef022e54a5f70c92fa6d6b0dc0877c2fc87a9f8d2f477b29d09248dab7
+    type: script
+    size: 2225
+  - path: infrastructure/scripts/ide-sync/transformers/cursor.js
+    hash: sha256:957eb51c7c516f2a73ade0be38d25f97b5508f9816067bfe94ed23e7f17be265
+    type: script
+    size: 2321
+  - path: infrastructure/scripts/ide-sync/transformers/trae.js
+    hash: sha256:c3609987ed07d1c4959ef803548cbd224797db117affb8655c30c04ed524967a
+    type: script
+    size: 2895
+  - path: infrastructure/scripts/ide-sync/transformers/windsurf.js
+    hash: sha256:f0c6ad1cbab8618ea41572a4c667e13d471b49794f5508bc4f9184106f260342
+    type: script
+    size: 2636
+  - path: infrastructure/scripts/ide-sync/validator.js
+    hash: sha256:356c78125db7f88d14f4e521808e96593d729291c3d7a1c36cb02f78b4aef8fc
+    type: script
+    size: 7316
   - path: infrastructure/scripts/improvement-engine.js
     hash: sha256:2a132e285295fa9455f94c3b3cc2abf0c38a1dc2faa1197bdbe36d80dc69430c
     type: script

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",
@@ -80,6 +80,12 @@
     "release:test": "semantic-release --dry-run --no-ci || echo 'Config test complete - authentication errors are expected locally'",
     "generate:manifest": "node scripts/generate-install-manifest.js",
     "validate:manifest": "node scripts/validate-manifest.js",
+    "sync:ide": "node .aios-core/infrastructure/scripts/ide-sync/index.js sync",
+    "sync:ide:validate": "node .aios-core/infrastructure/scripts/ide-sync/index.js validate",
+    "sync:ide:check": "node .aios-core/infrastructure/scripts/ide-sync/index.js validate --strict",
+    "sync:ide:cursor": "node .aios-core/infrastructure/scripts/ide-sync/index.js sync --ide cursor",
+    "sync:ide:windsurf": "node .aios-core/infrastructure/scripts/ide-sync/index.js sync --ide windsurf",
+    "sync:ide:trae": "node .aios-core/infrastructure/scripts/ide-sync/index.js sync --ide trae",
     "prepublishOnly": "npm run generate:manifest && npm run validate:manifest",
     "prepare": "echo 'Skipping husky - not needed for NPM publish'"
   },
@@ -156,6 +162,9 @@
     ],
     "*.md": [
       "prettier --write"
+    ],
+    ".aios-core/development/agents/*.md": [
+      "npm run sync:ide"
     ]
   }
 }