aios-core 4.2.6 → 4.2.7

package/.aios-core/infrastructure/scripts/validate-parity.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 'use strict';
 
+const fs = require('fs');
 const path = require('path');
+const yaml = require('js-yaml');
 const { spawnSync } = require('child_process');
 const { validateClaudeIntegration } = require('./validate-claude-integration');
 const { validateCodexIntegration } = require('./validate-codex-integration');
@@ -10,10 +12,16 @@ const { validateCodexSkills } = require('./codex-skills-sync/validate');
 const { validatePaths } = require('./validate-paths');
 
 function parseArgs(argv = process.argv.slice(2)) {
-  const args = new Set(argv);
+  const args = new Set(
+    argv.filter((arg) => !arg.startsWith('--contract=') && !arg.startsWith('--diff=')),
+  );
+  const contractArg = argv.find((arg) => arg.startsWith('--contract='));
+  const diffArg = argv.find((arg) => arg.startsWith('--diff='));
   return {
     quiet: args.has('--quiet') || args.has('-q'),
     json: args.has('--json'),
+    contractPath: contractArg ? contractArg.slice('--contract='.length) : null,
+    diffPath: diffArg ? diffArg.slice('--diff='.length) : null,
   };
 }
 
@@ -31,6 +39,25 @@ function runSyncValidate(ide, projectRoot) {
   };
 }
 
+function getDefaultContractPath(projectRoot = process.cwd()) {
+  return path.join(
+    projectRoot,
+    '.aios-core',
+    'infrastructure',
+    'contracts',
+    'compatibility',
+    'aios-4.0.4.yaml',
+  );
+}
+
+function loadCompatibilityContract(contractPath) {
+  if (!contractPath || !fs.existsSync(contractPath)) {
+    return null;
+  }
+  const raw = fs.readFileSync(contractPath, 'utf8');
+  return yaml.load(raw);
+}
+
 function normalizeResult(input) {
   if (!input || typeof input !== 'object') {
     return { ok: false, errors: ['Validator returned invalid result'], warnings: [] };
@@ -43,6 +70,152 @@ function normalizeResult(input) {
   };
 }
 
+function escapeRegex(value) {
+  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function validateCompatibilityContract(contract, resultById, options = {}) {
+  const violations = [];
+
+  if (!contract || typeof contract !== 'object') {
+    return ['Compatibility contract is missing or invalid'];
+  }
+
+  const matrix = Array.isArray(contract.ide_matrix) ? contract.ide_matrix : [];
+  if (matrix.length === 0) {
+    return ['Compatibility contract ide_matrix is empty'];
+  }
+
+  const docsPath = options.docsPath;
+  if (!docsPath || !fs.existsSync(docsPath)) {
+    violations.push(`Compatibility matrix document not found: ${docsPath || 'undefined'}`);
+    return violations;
+  }
+  const docsContent = fs.readFileSync(docsPath, 'utf8');
+
+  for (const ide of matrix) {
+    const ideName = ide.ide || 'unknown';
+    const displayName = ide.display_name || ideName;
+    const requiredChecks = Array.isArray(ide.required_checks) ? ide.required_checks : [];
+    const expectedStatus = ide.expected_status;
+
+    if (!expectedStatus) {
+      violations.push(`Contract missing expected_status for IDE "${ideName}"`);
+    }
+
+    const rowRegex = new RegExp(
+      `\\|\\s*${escapeRegex(displayName)}\\s*\\|\\s*${escapeRegex(expectedStatus || '')}\\s*\\|`,
+      'i',
+    );
+    if (!rowRegex.test(docsContent)) {
+      violations.push(
+        `Docs matrix mismatch for "${displayName}": expected status "${expectedStatus}" in ${options.docsPathRelative}`,
+      );
+    }
+
+    for (const checkId of requiredChecks) {
+      const checkResult = resultById[checkId];
+      if (!checkResult) {
+        violations.push(`Contract requires unknown check "${checkId}" for IDE "${ideName}"`);
+        continue;
+      }
+      if (!checkResult.ok) {
+        violations.push(`Contract violation for "${ideName}": required check "${checkId}" failed`);
+      }
+    }
+  }
+
+  const globalRequiredChecks = Array.isArray(contract.global_required_checks)
+    ? contract.global_required_checks
+    : [];
+  for (const checkId of globalRequiredChecks) {
+    const checkResult = resultById[checkId];
+    if (!checkResult) {
+      violations.push(`Contract requires unknown global check "${checkId}"`);
+      continue;
+    }
+    if (!checkResult.ok) {
+      violations.push(`Contract violation: global required check "${checkId}" failed`);
+    }
+  }
+
+  return violations;
+}
+
+function sortUnique(values = []) {
+  return [...new Set(values)].sort();
+}
+
+function diffCompatibilityContracts(currentContract, previousContract) {
+  if (!currentContract || !previousContract) {
+    return null;
+  }
+
+  const currentRelease = currentContract.release || null;
+  const previousRelease = previousContract.release || null;
+  const releaseChanged = currentRelease !== previousRelease;
+
+  const currentGlobalChecks = sortUnique(currentContract.global_required_checks || []);
+  const previousGlobalChecks = sortUnique(previousContract.global_required_checks || []);
+  const globalChecksAdded = currentGlobalChecks.filter((item) => !previousGlobalChecks.includes(item));
+  const globalChecksRemoved = previousGlobalChecks.filter((item) => !currentGlobalChecks.includes(item));
+
+  const currentByIde = Object.fromEntries((currentContract.ide_matrix || []).map((item) => [item.ide, item]));
+  const previousByIde = Object.fromEntries((previousContract.ide_matrix || []).map((item) => [item.ide, item]));
+  const ideKeys = sortUnique([...Object.keys(currentByIde), ...Object.keys(previousByIde)]);
+
+  const ideChanges = [];
+  for (const ide of ideKeys) {
+    const current = currentByIde[ide];
+    const previous = previousByIde[ide];
+
+    if (!previous && current) {
+      ideChanges.push({ ide, type: 'added', current });
+      continue;
+    }
+    if (previous && !current) {
+      ideChanges.push({ ide, type: 'removed', previous });
+      continue;
+    }
+
+    const currentStatus = current.expected_status || null;
+    const previousStatus = previous.expected_status || null;
+    const statusChanged = currentStatus !== previousStatus;
+    const currentChecks = sortUnique(current.required_checks || []);
+    const previousChecks = sortUnique(previous.required_checks || []);
+    const checksAdded = currentChecks.filter((item) => !previousChecks.includes(item));
+    const checksRemoved = previousChecks.filter((item) => !currentChecks.includes(item));
+
+    if (statusChanged || checksAdded.length > 0 || checksRemoved.length > 0) {
+      ideChanges.push({
+        ide,
+        type: 'changed',
+        status: { previous: previousStatus, current: currentStatus },
+        required_checks: {
+          added: checksAdded,
+          removed: checksRemoved,
+        },
+      });
+    }
+  }
+
+  return {
+    from_release: previousRelease,
+    to_release: currentRelease,
+    release_changed: releaseChanged,
+    global_required_checks: {
+      added: globalChecksAdded,
+      removed: globalChecksRemoved,
+    },
+    ide_changes: ideChanges,
+    has_changes:
+      releaseChanged
+      || globalChecksAdded.length > 0
+      || globalChecksRemoved.length > 0
+      || ideChanges.length > 0,
+  };
+}
+
 function runParityValidation(options = {}, deps = {}) {
   const projectRoot = options.projectRoot || process.cwd();
   const runSync = deps.runSyncValidate || runSyncValidate;
@@ -51,6 +224,15 @@ function runParityValidation(options = {}, deps = {}) {
   const runGeminiIntegration = deps.validateGeminiIntegration || validateGeminiIntegration;
   const runCodexSkills = deps.validateCodexSkills || validateCodexSkills;
   const runPaths = deps.validatePaths || validatePaths;
+  const resolvedContractPath = options.contractPath
+    ? path.resolve(projectRoot, options.contractPath)
+    : getDefaultContractPath(projectRoot);
+  const loadContract = deps.loadCompatibilityContract || loadCompatibilityContract;
+  const contract = loadContract(resolvedContractPath);
+  const resolvedDiffPath = options.diffPath ? path.resolve(projectRoot, options.diffPath) : null;
+  const previousContract = resolvedDiffPath ? loadContract(resolvedDiffPath) : null;
+  const docsPath = path.join(projectRoot, 'docs', 'ide-integration.md');
+  const docsPathRelative = path.relative(projectRoot, docsPath);
   const checks = [
     { id: 'claude-sync', exec: () => runSync('claude-code', projectRoot) },
     { id: 'claude-integration', exec: () => runClaudeIntegration({ projectRoot }) },
@@ -58,6 +240,9 @@ function runParityValidation(options = {}, deps = {}) {
     { id: 'codex-integration', exec: () => runCodexIntegration({ projectRoot }) },
     { id: 'gemini-sync', exec: () => runSync('gemini', projectRoot) },
     { id: 'gemini-integration', exec: () => runGeminiIntegration({ projectRoot }) },
+    { id: 'cursor-sync', exec: () => runSync('cursor', projectRoot) },
+    { id: 'github-copilot-sync', exec: () => runSync('github-copilot', projectRoot) },
+    { id: 'antigravity-sync', exec: () => runSync('antigravity', projectRoot) },
     { id: 'codex-skills', exec: () => runCodexSkills({ projectRoot, strict: true, quiet: true }) },
     { id: 'paths', exec: () => runPaths({ projectRoot }) },
   ];
@@ -66,15 +251,60 @@ function runParityValidation(options = {}, deps = {}) {
     const normalized = normalizeResult(check.exec());
     return { id: check.id, ...normalized };
   });
+  const resultById = Object.fromEntries(results.map((r) => [r.id, r]));
+  const contractViolations = validateCompatibilityContract(contract, resultById, {
+    docsPath,
+    docsPathRelative,
+  });
+  const contractSummary = contract
+    ? {
+        release: contract.release || null,
+        path: path.relative(projectRoot, resolvedContractPath),
+      }
+    : {
+        release: null,
+        path: path.relative(projectRoot, resolvedContractPath),
+      };
 
   return {
-    ok: results.every((r) => r.ok),
+    ok: results.every((r) => r.ok) && contractViolations.length === 0,
     checks: results,
+    contract: contractSummary,
+    contractDiff: diffCompatibilityContracts(contract, previousContract),
+    contractViolations,
   };
 }
 
 function formatHumanReport(result) {
   const lines = [];
+  if (result.contract && result.contract.release) {
+    lines.push(`Compatibility Contract: ${result.contract.release} (${result.contract.path})`);
+    lines.push('');
+  }
+  if (result.contractDiff) {
+    lines.push(
+      `Contract Diff: ${result.contractDiff.from_release || 'unknown'} -> ${result.contractDiff.to_release || 'unknown'}`,
+    );
+    if (!result.contractDiff.has_changes) {
+      lines.push('- no changes');
+    } else {
+      if (result.contractDiff.release_changed) {
+        lines.push('- release changed');
+      }
+      const globalAdded = result.contractDiff.global_required_checks.added || [];
+      const globalRemoved = result.contractDiff.global_required_checks.removed || [];
+      if (globalAdded.length > 0) {
+        lines.push(`- global checks added: ${globalAdded.join(', ')}`);
+      }
+      if (globalRemoved.length > 0) {
+        lines.push(`- global checks removed: ${globalRemoved.join(', ')}`);
+      }
+      for (const ideChange of result.contractDiff.ide_changes || []) {
+        lines.push(`- ${ideChange.ide}: ${ideChange.type}`);
+      }
+    }
+    lines.push('');
+  }
   for (const check of result.checks) {
     lines.push(`${check.ok ? '✅' : '❌'} ${check.id}`);
     if (check.errors.length > 0) {
@@ -84,6 +314,11 @@ function formatHumanReport(result) {
       lines.push(...check.warnings.map((w) => `⚠️ ${w}`));
     }
   }
+  if (Array.isArray(result.contractViolations) && result.contractViolations.length > 0) {
+    lines.push('');
+    lines.push('❌ Compatibility Contract Violations');
+    lines.push(...result.contractViolations.map((v) => `- ${v}`));
+  }
   lines.push('');
   lines.push(result.ok ? '✅ Parity validation passed' : '❌ Parity validation failed');
   return lines.join('\n');
@@ -116,4 +351,5 @@ module.exports = {
   runParityValidation,
   normalizeResult,
   formatHumanReport,
+  diffCompatibilityContracts,
 };

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

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 4.2.6
-generated_at: "2026-02-16T03:53:42.042Z"
+version: 4.2.7
+generated_at: "2026-02-16T14:10:16.018Z"
 generator: scripts/generate-install-manifest.js
-file_count: 1000
+file_count: 1004
 files:
   - path: cli/commands/config/index.js
     hash: sha256:ebcad2ce3807eda29dcddff76d7a95ddc9b7fa160df21fd608f94b802237e862
@@ -661,13 +661,13 @@ files:
     type: core
     size: 10845
   - path: core/orchestration/context-manager.js
-    hash: sha256:91b4e84f1a6246f9a1c94191a096bf9ee26b668610cc3fe7aec893931f54d241
+    hash: sha256:0dd03e84d0a2ea06165825c5eb7154531337ef98275918119ccd03769af576c3
     type: core
-    size: 7299
+    size: 16842
   - path: core/orchestration/dashboard-integration.js
-    hash: sha256:2099a762e039d7b536b0472231d648a39c34c386d04bdcb1a265c5dd4d261514
+    hash: sha256:fc96589a18302ac91036a52a8f4da2f9a1ba8e3f9dc45a4bacb8a279fc6db39d
     type: core
-    size: 14603
+    size: 15116
   - path: core/orchestration/data-lifecycle-manager.js
     hash: sha256:0d5df61805502204c0a467ae9900c940f869743ee332fa19839c9f9cacfe824d
     type: core
@@ -676,6 +676,10 @@ files:
     hash: sha256:4f342f7fc05f404de2b899358f86143106737b56d6c486c98e988a67d420078b
     type: core
     size: 12310
+  - path: core/orchestration/execution-profile-resolver.js
+    hash: sha256:bb35f1c16c47c9306128c5f3e6c90df3ed91f9358576ea97a59007b74f5e9927
+    type: core
+    size: 2696
   - path: core/orchestration/executor-assignment.js
     hash: sha256:d022d8bc01432958857894bc424e48e42d21287f44fe2e0cacfbdf03b412d33f
     type: core
@@ -717,9 +721,9 @@ files:
     type: core
     size: 35270
   - path: core/orchestration/index.js
-    hash: sha256:a71fc2cf4facd2725d9f330806076424450f7e5eee3dc876aae1fc0335166da7
+    hash: sha256:1d1b5471585647512327e7d5836ad826442b4c9bd588f82729fa455b41fa28b9
     type: core
-    size: 8630
+    size: 8835
   - path: core/orchestration/lock-manager.js
     hash: sha256:7764b9e79444e75577931a561444f1bf950d893004abc39fa8c2476f632bb481
     type: core
@@ -745,13 +749,13 @@ files:
     type: core
     size: 24732
   - path: core/orchestration/skill-dispatcher.js
-    hash: sha256:0a2dcf12cb8b04c26006c57016cf0d651332e60dee09762f88927c216464abde
+    hash: sha256:4a54fec3a3338431d1d9634ebf06f3983d06903570c45d67d0ac15d25c95eb05
     type: core
-    size: 10372
+    size: 10490
   - path: core/orchestration/subagent-prompt-builder.js
-    hash: sha256:3da03371fa4cafa4221299f241acd3c37697b395e29ea0c5c65c81bc13f51326
+    hash: sha256:967cc17e019ae030148b276b6fdc6a698ae5f42a05f20e80484cb87ea81ed7af
     type: core
-    size: 11255
+    size: 11395
   - path: core/orchestration/surface-checker.js
     hash: sha256:92e9d5bea78c3db4940c39f79e537821b36451cd524d69e6b738272aa63c08b6
     type: core
@@ -773,9 +777,9 @@ files:
     type: core
     size: 36350
   - path: core/orchestration/workflow-orchestrator.js
-    hash: sha256:fb89682ea86d33bf8453062f82be0313fbfdf4da42ebf0220dd12dc29238a50a
+    hash: sha256:5d3f14d5f12742ce87c3ae8745f82f4ac9f3df3d1889cf16bfc13743130963f9
     type: core
-    size: 26902
+    size: 30727
   - path: core/permissions/__tests__/permission-mode.test.js
     hash: sha256:87df5f29666a599fb0fec917e0360ae6fa9dd90512f0816ae62fa453dbab7fbb
     type: core
@@ -1033,9 +1037,9 @@ files:
     type: data
     size: 34251
   - path: data/entity-registry.yaml
-    hash: sha256:8d02a5c9e3f219f60059406fffeb843abfdcea1f727b954eb662c6a21ddc17c1
+    hash: sha256:7b9bb3a5354107f9ec29105b5948d5c538e2a3b19d49fa42e2e785e4a767c38b
     type: data
-    size: 297196
+    size: 289966
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
@@ -1125,13 +1129,17 @@ files:
     type: agent
     size: 12076
   - path: development/agents/ux-design-expert.md
-    hash: sha256:5dde817f220f1f452b53026643e267eb027e4a131d1e5fc4bbcf6ebd772da3bb
+    hash: sha256:ae3f98570fa6cbd714ecd0aa2f44c7db005f0469b5bd04191d8da3b133bc65f1
     type: agent
-    size: 18376
+    size: 18377
   - path: development/checklists/agent-quality-gate.md
     hash: sha256:04d1bf12dd4b0b3d10de04c1825efab742e6475087d3ac9d5c86ca7ff8ec9057
     type: checklist
     size: 16148
+  - path: development/checklists/brownfield-compatibility-checklist.md
+    hash: sha256:d07b1f9e2fcb78f62188ef05a6e6f75a94821b6bb297ea67f2e782e260d27f49
+    type: checklist
+    size: 3335
   - path: development/checklists/self-critique-checklist.md
     hash: sha256:869fbc8fbc333ac8eea4eca3ea4ab9ca79917fa5e53735b70d634c85ac6420c8
     type: checklist
@@ -1417,9 +1425,9 @@ files:
     type: script
     size: 9847
   - path: development/scripts/workflow-state-manager.js
-    hash: sha256:56758b8af8b53b74b89b758d84feda85b73ea196704c2969573d183025f052d7
+    hash: sha256:f3573ec1ebd022d31422bf8dcd48df5891f698ab5a9489031bd56e0893087109
     type: script
-    size: 15764
+    size: 20129
   - path: development/scripts/workflow-validator.js
     hash: sha256:cb1c698f39984f128918e8a3a4e5aed254ca445c57b9f99fa183ef14abc0f0dc
     type: script
@@ -1869,9 +1877,9 @@ files:
     type: task
     size: 13356
   - path: development/tasks/next.md
-    hash: sha256:8ba7dc4567c0c7bf7001f0a26650767f72f45442d312daeb0e321ba4605ce429
+    hash: sha256:d9c84f8892367cd8e1bd453dd08876d051bcc368ca9eacf5d2babb26235427fb
     type: task
-    size: 6556
+    size: 7641
   - path: development/tasks/orchestrate-resume.md
     hash: sha256:5da88a904fc9e77d7428344fb83e55f6f4a3cae4f9d21d77092d1c67664c3d86
     type: task
@@ -2472,6 +2480,10 @@ files:
     hash: sha256:e46e4b86e48e22a6f0b7ccb91e7e901bfc779479d4ebc7e776fca6dd4de5b30b
     type: code
     size: 753
+  - path: infrastructure/contracts/compatibility/aios-4.0.4.yaml
+    hash: sha256:e8bea648df5d62a22a979b9d70e3987690db4e19a1ed3beec11d232746297136
+    type: infrastructure
+    size: 1074
   - path: infrastructure/index.js
     hash: sha256:8e05caec57188938d6f348444ad3abce2c06b53bdb46993fb2e8ff81c27fca4c
     type: infrastructure
@@ -2989,9 +3001,9 @@ files:
     type: script
     size: 6692
   - path: infrastructure/scripts/validate-parity.js
-    hash: sha256:1ec3b6c5863b4130a30f3844f9f148e86969011a8e557ca8b8d8f3bd5e96bd83
+    hash: sha256:527948d4a35a85c2f558b261f4b0a921d0482cab979e7dffe988b6fa11b7b2a1
     type: script
-    size: 3929
+    size: 12683
   - path: infrastructure/scripts/validate-paths.js
     hash: sha256:4360d0735ec2c717a97c1670855c5423cf5172005a93c4698b5305ccec48bc2e
     type: script
@@ -3364,6 +3376,10 @@ files:
     hash: sha256:bc1852d15e3a383c7519e5976094de3055c494fdd467acd83137700c900c4c61
     type: template
     size: 14755
+  - path: product/templates/brownfield-risk-report-tmpl.yaml
+    hash: sha256:173adec3131f0924bc7d64c10f54386bb85dcadc14e6ff3fb9bb2f8172caf162
+    type: template
+    size: 12211
   - path: product/templates/changelog-template.md
     hash: sha256:af44d857c9bf8808e89419d1d859557c3c827de143be3c0f36f2a053c9ee9197
     type: template
@@ -3961,9 +3977,9 @@ files:
     type: workflow-intelligence
     size: 8436
   - path: workflow-intelligence/engine/suggestion-engine.js
-    hash: sha256:1283f4a80e4bb00fe22b34822695c282d7a2ca3e2d1394f2923cd57b99a91f32
+    hash: sha256:7e07146e644edc39c5337bfc2f5eee621c39446be40cf303cdf418de97111796
     type: workflow-intelligence
-    size: 19809
+    size: 23441
   - path: workflow-intelligence/engine/wave-analyzer.js
     hash: sha256:0d017b70213584a11cad354d54d442be977b183353e6a5e31cc1de4291d0afb9
     type: workflow-intelligence