sinapse-ai 7.7.3 → 7.7.5

package/.sinapse-ai/infrastructure/scripts/validate-codex-sync.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { loadCodexCatalogConfig } = require('./codex-parity/catalog');
+const { validateCodexCommandRegistry } = require('./validate-codex-command-registry');
+const { validateCodexDelegation } = require('./validate-codex-delegation');
+const { validateCodexIntegration } = require('./validate-codex-integration');
+const { validateCodexSkills } = require('./codex-skills-sync/validate');
+const { validatePaths } = require('./validate-paths');
+
+function parseArgs(argv = process.argv.slice(2)) {
+  const args = new Set(argv);
+  return {
+    quiet: args.has('--quiet') || args.has('-q'),
+    json: args.has('--json'),
+  };
+}
+
+function runLegacyCodexValidate(projectRoot, options = {}) {
+  const args = [
+    path.join('.sinapse-ai', 'infrastructure', 'scripts', 'ide-sync', 'index.js'),
+    'validate',
+    '--ide',
+    'codex',
+    '--strict',
+  ];
+
+  if (options.quiet) args.push('--quiet');
+
+  const result = spawnSync(process.execPath, args, {
+    cwd: projectRoot,
+    encoding: 'utf8',
+  });
+
+  return {
+    ok: result.status === 0,
+    mode: 'canonical',
+    checks: [],
+    errors: result.status === 0 ? [] : ['Legacy Codex sync validation failed'],
+    warnings: [],
+    raw: [result.stdout, result.stderr].filter(Boolean).join('\n').trim(),
+  };
+}
+
+function normalizeCheck(id, input) {
+  return {
+    id,
+    ok: Boolean(input?.ok),
+    errors: Array.isArray(input?.errors) ? input.errors : [],
+    warnings: Array.isArray(input?.warnings) ? input.warnings : [],
+    metrics: input?.metrics || {},
+  };
+}
+
+function validateCodexSync(options = {}, deps = {}) {
+  const projectRoot = options.projectRoot || process.cwd();
+  const config = loadCodexCatalogConfig(projectRoot);
+  const runLegacyValidate = deps.runLegacyCodexValidate || runLegacyCodexValidate;
+  const runCodexCommands = deps.validateCodexCommandRegistry || validateCodexCommandRegistry;
+  const runCodexDelegation = deps.validateCodexDelegation || validateCodexDelegation;
+  const runCodexIntegration = deps.validateCodexIntegration || validateCodexIntegration;
+  const runCodexSkills = deps.validateCodexSkills || validateCodexSkills;
+  const runPaths = deps.validatePaths || validatePaths;
+
+  if (config.catalogMode !== 'expanded') {
+    return runLegacyValidate(projectRoot, options);
+  }
+
+  const catalogPath = path.join(projectRoot, '.codex', 'catalog.json');
+  const checks = [
+    normalizeCheck('codex-integration', runCodexIntegration({ projectRoot, quiet: true })),
+    normalizeCheck('codex-commands', runCodexCommands({ projectRoot, quiet: true })),
+    normalizeCheck('codex-delegation', runCodexDelegation({ projectRoot, quiet: true })),
+    normalizeCheck('codex-skills', runCodexSkills({ projectRoot, strict: true, quiet: true })),
+    normalizeCheck('paths', runPaths({ projectRoot, quiet: true })),
+  ];
+
+  if (!fs.existsSync(catalogPath)) {
+    checks.unshift({
+      id: 'codex-catalog',
+      ok: false,
+      errors: ['Missing Codex catalog file: .codex/catalog.json'],
+      warnings: [],
+      metrics: {},
+    });
+  } else {
+    checks.unshift({
+      id: 'codex-catalog',
+      ok: true,
+      errors: [],
+      warnings: [],
+      metrics: {},
+    });
+  }
+
+  return {
+    ok: checks.every((check) => check.ok),
+    mode: 'expanded',
+    checks,
+    errors: checks.flatMap((check) => check.errors.map((error) => `${check.id}: ${error}`)),
+    warnings: checks.flatMap((check) => check.warnings.map((warning) => `${check.id}: ${warning}`)),
+  };
+}
+
+function formatHumanReport(result) {
+  if (result.mode === 'canonical' && result.raw) {
+    return result.raw;
+  }
+
+  const lines = [
+    result.ok
+      ? 'OK Codex sync validation passed'
+      : `X Codex sync validation failed (${result.errors.length} issue(s))`,
+  ];
+
+  for (const check of result.checks || []) {
+    lines.push(`${check.ok ? 'OK' : 'X'} ${check.id}`);
+    if (check.errors.length > 0) {
+      lines.push(...check.errors.map((error) => `- ${error}`));
+    }
+    if (check.warnings.length > 0) {
+      lines.push(...check.warnings.map((warning) => `! ${warning}`));
+    }
+  }
+
+  return lines.join('\n');
+}
+
+function main() {
+  const args = parseArgs();
+  const result = validateCodexSync(args);
+
+  if (!args.quiet) {
+    if (args.json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      console.log(formatHumanReport(result));
+    }
+  }
+
+  if (!result.ok) {
+    process.exitCode = 1;
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  parseArgs,
+  validateCodexSync,
+  formatHumanReport,
+  runLegacyCodexValidate,
+  normalizeCheck,
+};

package/.sinapse-ai/infrastructure/scripts/validate-parity.js

@@ -6,6 +6,7 @@ const path = require('path');
 const yaml = require('js-yaml');
 const { spawnSync } = require('child_process');
 const { validateClaudeIntegration } = require('./validate-claude-integration');
+const { validateCodexSync } = require('./validate-codex-sync');
 const { validateCodexIntegration } = require('./validate-codex-integration');
 const { validateCodexSkills } = require('./codex-skills-sync/validate');
 const { validatePaths } = require('./validate-paths');
@@ -218,6 +219,7 @@ function diffCompatibilityContracts(currentContract, previousContract) {
 function runParityValidation(options = {}, deps = {}) {
   const projectRoot = options.projectRoot || process.cwd();
   const runSync = deps.runSyncValidate || runSyncValidate;
+  const runCodexSync = deps.validateCodexSync || validateCodexSync;
   const runClaudeIntegration = deps.validateClaudeIntegration || validateClaudeIntegration;
   const runCodexIntegration = deps.validateCodexIntegration || validateCodexIntegration;
   const runCodexSkills = deps.validateCodexSkills || validateCodexSkills;
@@ -234,7 +236,7 @@ function runParityValidation(options = {}, deps = {}) {
   const checks = [
     { id: 'claude-sync', exec: () => runSync('claude-code', projectRoot) },
     { id: 'claude-integration', exec: () => runClaudeIntegration({ projectRoot }) },
-    { id: 'codex-sync', exec: () => runSync('codex', projectRoot) },
+    { id: 'codex-sync', exec: () => runCodexSync({ projectRoot, quiet: true }) },
     { id: 'codex-integration', exec: () => runCodexIntegration({ projectRoot }) },
     { id: 'codex-skills', exec: () => runCodexSkills({ projectRoot, strict: true, quiet: true }) },
     { id: 'paths', exec: () => runPaths({ projectRoot }) },

package/.sinapse-ai/infrastructure/scripts/validate-paths.js

@@ -3,6 +3,10 @@
 
 const fs = require('fs');
 const path = require('path');
+const {
+  loadCodexCatalogConfig,
+  validateSkillActivationPaths,
+} = require('./codex-parity/catalog');
 
 const FORBIDDEN_ABSOLUTE_PATTERNS = [
   /\/Users\/[^\s/'"]+/g,
@@ -54,21 +58,15 @@ function collectAbsolutePathViolations(content, filePath) {
   return errors;
 }
 
-function validateSkillPathConventions(content, filePath) {
-  const errors = [];
-  if (!content.includes('.sinapse-ai/development/agents/')) {
-    errors.push(`${filePath} missing canonical source path ".sinapse-ai/development/agents/"`);
-  }
-  if (!content.includes('.sinapse-ai/development/scripts/generate-greeting.js')) {
-    errors.push(`${filePath} missing canonical greeting script path`);
-  }
-  return errors;
+function validateSkillPathConventions(content, filePath, config) {
+  return validateSkillActivationPaths(content, filePath, config);
 }
 
 function validatePaths(options = {}) {
   const resolved = { ...getDefaultOptions(), ...options };
   const errors = [];
   const checkedFiles = [];
+  const config = loadCodexCatalogConfig(resolved.projectRoot);
 
   const skillFiles = listSkillFiles(resolved.skillsDir);
   const filesToCheck = [...resolved.requiredFiles, ...skillFiles];
@@ -90,7 +88,7 @@ function validatePaths(options = {}) {
     errors.push(...collectAbsolutePathViolations(content, path.relative(resolved.projectRoot, file)));
 
     if (file.endsWith('SKILL.md')) {
-      errors.push(...validateSkillPathConventions(content, path.relative(resolved.projectRoot, file)));
+      errors.push(...validateSkillPathConventions(content, path.relative(resolved.projectRoot, file), config));
     }
   }
 

package/.sinapse-ai/infrastructure/templates/safe-collab/README.md

@@ -2,6 +2,14 @@
 
 Template reutilizavel para configurar colaboracao segura em qualquer projeto.
 
+## Fonte canonica
+
+Para a politica completa e atualizada de colaboracao paralela, use:
+
+- `docs/guides/parallel-collaboration-source-of-truth.md`
+
+Este README explica o template. O documento acima define a regra mestra.
+
 ## Uso rapido
 
 ```bash

package/.sinapse-ai/install-manifest.yaml

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 7.7.3
-generated_at: "2026-04-02T01:44:04.986Z"
+version: 7.7.5
+generated_at: "2026-04-03T00:28:11.575Z"
 generator: scripts/generate-install-manifest.js
-file_count: 1113
+file_count: 1118
 files:
   - path: cli/commands/config/index.js
     hash: sha256:66f111eceef0f60fa0a8904add783b615d55b01d5fe36408623c3dd828e702f6
@@ -189,9 +189,9 @@ files:
     type: cli
     size: 5907
   - path: core-config.yaml
-    hash: sha256:1dfc00cfc993bacb17f683aacdf898b856744a33a76183adab2d1c1896be8b31
+    hash: sha256:fc24a8286b20ec2558c90186e99124b96d26b287ff107b747c2b68b1102e0cc8
     type: config
-    size: 10514
+    size: 10513
   - path: core/code-intel/code-intel-client.js
     hash: sha256:6c9a08a37775acf90397aa079a4ad2c5edcc47f2cfd592b26ae9f3d154d1deb8
     type: core
@@ -1237,9 +1237,9 @@ files:
     type: data
     size: 9586
   - path: data/entity-registry.yaml
-    hash: sha256:17d002e1c7b1dc347bc369fd82b28a931babcb69f16efc9ac76eb484eaacc1a1
+    hash: sha256:e3e57f3070134b76851762a0666b665228f061d3ff37ee513e7b6ae5dcef3b62
     type: data
-    size: 511993
+    size: 515807
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
@@ -3052,14 +3052,18 @@ files:
     hash: sha256:47b3f9044ce9b92b8c486a75da82afc4cc6b49d5d97e722ef5a1938fbf49943a
     type: script
     size: 40744
+  - path: infrastructure/scripts/codex-parity/catalog.js
+    hash: sha256:cfef97860788a119c44cbb18b4249ad538814f99a03b2ca13e66dd74aa8b5242
+    type: script
+    size: 3527
   - path: infrastructure/scripts/codex-skills-sync/index.js
-    hash: sha256:cea7c65175ebf5f1f7d47d0dc536e5889e420e6c137a41acd522be8b69fe6327
+    hash: sha256:9eb2637a4f1f6edeabf358734b14e4c709bed37560f2e40aebf1ea3ef4572c3c
     type: script
-    size: 5268
+    size: 7494
   - path: infrastructure/scripts/codex-skills-sync/validate.js
-    hash: sha256:07c2d17438890bc5bd3f2cc208692ff65f6d1f394390066ff9869e03973c7e2b
+    hash: sha256:1a1301d2e3f558bedf3a1ab2c5c9ee2868a4c253068311d5014987917f367443
     type: script
-    size: 4577
+    size: 5626
   - path: infrastructure/scripts/collect-tool-usage.js
     hash: sha256:510b621078602273fb146eef57d115b08988ea43d03eb5d92192050c13e95efe
     type: script
@@ -3372,6 +3376,10 @@ files:
     hash: sha256:ceb0450fa12fa48f0255bb4565858eb1a97b28c30b98d36cb61d52d72e08b054
     type: script
     size: 22394
+  - path: infrastructure/scripts/sync-codex-local-first.js
+    hash: sha256:ad5245ead7243a39cd5116f44fcf1234ad54b016e365dfefa017764a76f4f3eb
+    type: script
+    size: 4089
   - path: infrastructure/scripts/template-engine.js
     hash: sha256:de1bc8ce51eeabf6f6ec558d35107fbc4843ac76e3361044ba9f47bb6af4f058
     type: script
@@ -3420,22 +3428,34 @@ files:
     hash: sha256:4447fbf8cffdf20b34fad71eb4caf5aec0726f2b8f27cd49cd1bd59d69cdc009
     type: script
     size: 2838
+  - path: infrastructure/scripts/validate-codex-command-registry.js
+    hash: sha256:a37a4c5fc8a4c3a7ce7ba240aeea16abc0a75871751f66eeb84991604ff066bf
+    type: script
+    size: 7266
+  - path: infrastructure/scripts/validate-codex-delegation.js
+    hash: sha256:a71224ad31b3a28bcc26953f75bbd6387686b3b906404c833f52b8dfff306384
+    type: script
+    size: 9532
   - path: infrastructure/scripts/validate-codex-integration.js
-    hash: sha256:01065d27f1c9e002b3985f1b5090cf123369fcf528012c2ec8c4a02df9b3645e
+    hash: sha256:c553cc493ddbfecf41b865f8a1075df56b6500c3b2b315bae8b7e7bcec4db85a
+    type: script
+    size: 4742
+  - path: infrastructure/scripts/validate-codex-sync.js
+    hash: sha256:31bcfc0cdf307e7c14064eaf0ddbf99a14344c21306937c9a7d9cc7ebba260f8
     type: script
-    size: 4127
+    size: 4679
   - path: infrastructure/scripts/validate-output-pattern.js
     hash: sha256:91111d656e8d7b38a20a1bda753e663b74318f75cdab2025c7e0b84c775fc83d
     type: script
     size: 6692
   - path: infrastructure/scripts/validate-parity.js
-    hash: sha256:5cbd1c4458fb3e485872635e2210b3d3406c22381185039ef112db8912887201
+    hash: sha256:284c7715cc65b76579284024bbe5176b9230340d841dbfe79559c8f5844109cb
     type: script
-    size: 12121
+    size: 12266
   - path: infrastructure/scripts/validate-paths.js
-    hash: sha256:f657c32be91ed63e0b82d5b134b143d03174622eba60fb4b556adc570b8c7f5a
+    hash: sha256:942f6de9e621b7331f61dc915db5d24b987b67d1ae3377882330f7013dd214e9
     type: script
-    size: 3779
+    size: 3671
   - path: infrastructure/scripts/validate-user-profile.js
     hash: sha256:0f78a5aebd85b4b0d2a5b0f2d81ccbbbe0f2d25ed1cfcafeb129734852217683
     type: script
@@ -3525,9 +3545,9 @@ files:
     type: template
     size: 338
   - path: infrastructure/templates/safe-collab/README.md
-    hash: sha256:53e1193eaf30b5a4d9a5d2c5f700b22a210515abb661baf2b5ebe056343806fe
+    hash: sha256:0b4f3d0ce9b7111d812917312ae504df976245d902eecfa501f73e7aa0719813
     type: template
-    size: 1958
+    size: 2179
   - path: infrastructure/templates/safe-collab/safe-collaboration-rule.md
     hash: sha256:9631681340fddc314080f9182b76ccfbb1ee3441d92ce181067e76cace960a5e
     type: template

package/.sinapse-ai/project-config.yaml

@@ -70,7 +70,7 @@ github_integration:
         "style/": "style"
         "build/": "build"
       default_type: "feat"
-    auto_assign_reviewers: false
+    auto_assign_reviewers: true
     draft_by_default: false
   semantic_release:
     enabled: true

package/bin/utils/collab-start.js

@@ -0,0 +1,267 @@
+'use strict';
+
+const { execFileSync, execSync } = require('child_process');
+const path = require('path');
+
+function execGit(command) {
+  return execSync(command, {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+  }).trim();
+}
+
+function safeExec(command) {
+  try {
+    return execGit(command);
+  } catch {
+    return '';
+  }
+}
+
+function parseArgs(argv) {
+  const parsed = {
+    adoptCurrent: false,
+    check: false,
+    type: 'feat',
+    owner: null,
+    storyId: null,
+    slug: null,
+  };
+
+  for (const arg of argv) {
+    if (arg === '--adopt-current') {
+      parsed.adoptCurrent = true;
+      continue;
+    }
+    if (arg === '--check') {
+      parsed.check = true;
+      continue;
+    }
+    if (arg.startsWith('--type=')) {
+      parsed.type = arg.split('=')[1] || parsed.type;
+      continue;
+    }
+    if (arg.startsWith('--owner=')) {
+      parsed.owner = arg.split('=')[1] || null;
+      continue;
+    }
+    if (!parsed.storyId) {
+      parsed.storyId = arg;
+      continue;
+    }
+    if (!parsed.slug) {
+      parsed.slug = arg;
+    }
+  }
+
+  return parsed;
+}
+
+function resolveDefaultBranch() {
+  try {
+    const remoteHead = execGit('git symbolic-ref --short refs/remotes/origin/HEAD');
+    return remoteHead.replace(/^origin\//, '');
+  } catch {
+    return 'main';
+  }
+}
+
+function getCurrentBranch() {
+  return execGit('git rev-parse --abbrev-ref HEAD');
+}
+
+function getStatusLines() {
+  const output = safeExec('git status --porcelain');
+  return output ? output.split('\n').filter(Boolean) : [];
+}
+
+function sanitizeSegment(value) {
+  return String(value || '')
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .replace(/-{2,}/g, '-');
+}
+
+function detectOwnerPrefix(explicitOwner) {
+  if (explicitOwner) {
+    return sanitizeSegment(explicitOwner) || 'dev';
+  }
+
+  const rawSignals = [
+    safeExec('git config user.name'),
+    safeExec('git config user.email'),
+    process.env.USERNAME || '',
+    process.env.USER || '',
+  ]
+    .join(' ')
+    .toLowerCase();
+
+  if (/(caio|imori)/.test(rawSignals)) {
+    return 'caio';
+  }
+
+  if (/(matheus|soier|sawyer)/.test(rawSignals)) {
+    return 'soier';
+  }
+
+  return 'dev';
+}
+
+function buildWorkItemSlug(storyId, slug) {
+  const sanitizedStory = sanitizeSegment(storyId);
+  const sanitizedSlug = sanitizeSegment(slug || storyId);
+  if (!sanitizedSlug) {
+    return sanitizedStory;
+  }
+  if (!sanitizedStory) {
+    return sanitizedSlug;
+  }
+  return sanitizedSlug.startsWith(`${sanitizedStory}-`) || sanitizedSlug === sanitizedStory
+    ? sanitizedSlug
+    : `${sanitizedStory}-${sanitizedSlug}`;
+}
+
+function buildBranchName({ owner, type, storyId, slug }) {
+  return `${owner}/${sanitizeSegment(type) || 'feat'}/${buildWorkItemSlug(storyId, slug)}`;
+}
+
+function buildWorktreePath(worktreeKey) {
+  return path.join(process.cwd(), '.sinapse', 'worktrees', worktreeKey);
+}
+
+function ensureReadyDefaultBranch(defaultBranch) {
+  const branchName = getCurrentBranch();
+  const statusLines = getStatusLines();
+
+  if (branchName !== defaultBranch) {
+    throw new Error(
+      `Run collab:start from a clean '${defaultBranch}' checkout. Current branch: '${branchName}'.`,
+    );
+  }
+
+  if (statusLines.length > 0) {
+    throw new Error(
+      `Working tree is dirty on '${defaultBranch}'. Commit or stash your changes before opening a new worktree.`,
+    );
+  }
+}
+
+function ensureOnDefaultBranch(defaultBranch) {
+  const branchName = getCurrentBranch();
+  if (branchName !== defaultBranch) {
+    throw new Error(
+      `Run this command from '${defaultBranch}'. Current branch: '${branchName}'.`,
+    );
+  }
+}
+
+function ensureUpToDate(defaultBranch) {
+  execFileSync('git', ['fetch', 'origin'], {
+    stdio: ['ignore', 'ignore', 'pipe'],
+  });
+
+  const localSha = safeExec(`git rev-parse ${defaultBranch}`);
+  const remoteSha = safeExec(`git rev-parse origin/${defaultBranch}`);
+
+  if (localSha && remoteSha && localSha !== remoteSha) {
+    execFileSync('git', ['pull', '--ff-only', 'origin', defaultBranch], {
+      stdio: 'inherit',
+    });
+  }
+}
+
+function createWorktree({ branchName, defaultBranch, worktreePath }) {
+  execFileSync('git', ['worktree', 'add', worktreePath, '-b', branchName, defaultBranch], {
+    stdio: 'inherit',
+  });
+}
+
+function adoptCurrentWorkspace(branchName) {
+  execFileSync('git', ['checkout', '-b', branchName], {
+    stdio: 'inherit',
+  });
+}
+
+function runCheck() {
+  const defaultBranch = resolveDefaultBranch();
+  const currentBranch = getCurrentBranch();
+  const statusLines = getStatusLines();
+  const owner = detectOwnerPrefix(null);
+
+  console.log(`Default branch: ${defaultBranch}`);
+  console.log(`Current branch: ${currentBranch}`);
+  console.log(`Detected maintainer prefix: ${owner}`);
+  console.log(`Working tree clean: ${statusLines.length === 0 ? 'yes' : 'no'}`);
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.check) {
+    runCheck();
+    return;
+  }
+
+  if (!args.storyId) {
+    console.error(
+      'Usage: npm run collab:start -- <story-id> <slug> [--type=feat] [--owner=caio] [--adopt-current]',
+    );
+    process.exit(1);
+  }
+
+  const defaultBranch = resolveDefaultBranch();
+  const owner = detectOwnerPrefix(args.owner);
+  const branchName = buildBranchName({
+    owner,
+    type: args.type,
+    storyId: args.storyId,
+    slug: args.slug,
+  });
+  const worktreeKey = sanitizeSegment(branchName.replace(/\//g, '-'));
+  const worktreePath = buildWorktreePath(worktreeKey);
+
+  try {
+    if (args.adoptCurrent) {
+      ensureOnDefaultBranch(defaultBranch);
+      adoptCurrentWorkspace(branchName);
+    } else {
+      ensureReadyDefaultBranch(defaultBranch);
+      ensureUpToDate(defaultBranch);
+      createWorktree({ branchName, defaultBranch, worktreePath });
+    }
+  } catch (error) {
+    console.error('');
+    console.error(`collab:start failed: ${error.message}`);
+    console.error('');
+    process.exit(1);
+  }
+
+  console.log('');
+  if (args.adoptCurrent) {
+    console.log('Current workspace adopted into a safe maintainer branch.');
+    console.log(`Branch: ${branchName}`);
+    console.log('');
+    console.log('Continue working in the current directory, now outside main.');
+  } else {
+    console.log('Safe maintainer workspace created.');
+    console.log(`Branch:   ${branchName}`);
+    console.log(`Worktree: ${worktreePath}`);
+    console.log('');
+    console.log(`Next step: cd "${worktreePath}"`);
+  }
+  console.log('');
+}
+
+module.exports = {
+  buildBranchName,
+  buildWorkItemSlug,
+  detectOwnerPrefix,
+  parseArgs,
+  resolveDefaultBranch,
+  sanitizeSegment,
+};
+
+if (require.main === module) {
+  main();
+}