sinapse-ai 1.24.0 → 1.25.0

package/docs/framework/react-bits/text-animations.md

@@ -0,0 +1,41 @@
+# React Bits - TextAnimations
+
+> Snapshot oficial: `3acbd54115330a42e39f63dda2d4859e998b6684` (2026-07-14T17:21:39+03:00). Total nesta categoria: **23**.
+
+Cada item abaixo aponta para a documentacao e para o codigo TypeScript/CSS oficial fixado no commit pesquisado.
+
+| Componente                                                                                                                                                                                                                     | O que faz                                                                       | Dependencias                      | Props publicas                                                                                                                                                                                                                                                                                                            | Variantes                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
+| [ASCIIText](https://reactbits.dev/text-animations/ascii-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ASCIIText))                         | Renders text with an animated ASCII background for a retro feel.                | `three@^0.180.0`                  | `text`, `enableWaves`, `asciiFontSize`, `textFontSize`, `planeBaseHeight`, `textColor`, `strokeColor`                                                                                                                                                                                                                     | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [BlurText](https://reactbits.dev/text-animations/blur-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/BlurText))                            | Text starts blurred then crisply resolves for a soft-focus reveal effect.       | `motion@^12.23.12`                | `text`, `animateBy`, `direction`, `delay`, `stepDuration`, `threshold`, `rootMargin`, `onAnimationComplete`                                                                                                                                                                                                               | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [CircularText](https://reactbits.dev/text-animations/circular-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/CircularText))                | Layouts characters around a circle with optional rotation animation.            | `motion@^12.23.12`                | `text`, `spinDuration`, `onHover`, `className`                                                                                                                                                                                                                                                                            | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [CountUp](https://reactbits.dev/text-animations/count-up) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/CountUp))                               | Animated number counter supporting formatting and decimals.                     | `motion@^12.23.12`                | `to`, `from`, `direction`, `delay`, `duration`, `className`, `startWhen`, `separator`, `onStart`, `onEnd`                                                                                                                                                                                                                 | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [CurvedLoop](https://reactbits.dev/text-animations/curved-loop) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/CurvedLoop))                      | Flowing looping text path along a customizable curve with drag interaction.     | `none`                            | `marqueeText`, `speed`, `className`, `curveAmount`, `direction`, `interactive`                                                                                                                                                                                                                                            | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [DecryptedText](https://reactbits.dev/text-animations/decrypted-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/DecryptedText))             | Hacker-style decryption cycling random glyphs until resolving to real text.     | `motion@^12.23.12`                | `text`, `speed`, `maxIterations`, `sequential`, `revealDirection`, `useOriginalCharsOnly`, `className`, `parentClassName`, `encryptedClassName`, `animateOn`, `clickMode`                                                                                                                                                 | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [FallingText](https://reactbits.dev/text-animations/falling-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/FallingText))                   | Characters fall with gravity + bounce creating a playful entrance.              | `matter-js@^0.20.0`               | `text`, `highlightWords`, `highlightClass`, `trigger`, `backgroundColor`, `wireframes`, `gravity`, `mouseConstraintStiffness`, `fontSize`, `wordSpacing`                                                                                                                                                                  | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [FuzzyText](https://reactbits.dev/text-animations/fuzzy-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/FuzzyText))                         | Vibrating fuzzy text with controllable hover intensity.                         | `none`                            | `children`, `fontSize`, `fontWeight`, `fontFamily`, `color`, `enableHover`, `baseIntensity`, `hoverIntensity`, `fuzzRange`, `fps`, `direction`, `transitionDuration`, `clickEffect`, `glitchMode`, `glitchInterval`, `glitchDuration`, `gradient`, `letterSpacing`, `className`                                           | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [GlitchText](https://reactbits.dev/text-animations/glitch-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/GlitchText))                      | RGB split and distortion glitch effect with jitter effects.                     | `none`                            | `children`, `speed`, `enableShadows`, `enableOnHover`, `className`                                                                                                                                                                                                                                                        | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [GradientText](https://reactbits.dev/text-animations/gradient-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/GradientText))                | Animated gradient sweep across live text with speed and color control.          | `motion@^12.23.12`                | `children`, `className`, `colors`, `animationSpeed`, `direction`, `pauseOnHover`, `yoyo`, `showBorder`                                                                                                                                                                                                                    | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [RotatingText](https://reactbits.dev/text-animations/rotating-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/RotatingText))                | Cycles through multiple phrases with 3D rotate / flip transitions.              | `motion@^12.23.12`                | `texts`, `rotationInterval`, `initial`, `animate`, `exit`, `animatePresenceMode`, `animatePresenceInitial`, `staggerDuration`, `staggerFrom`, `transition`, `loop`, `auto`, `splitBy`, `onNext`, `mainClassName`, `splitLevelClassName`, `elementLevelClassName`                                                          | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrambledText](https://reactbits.dev/text-animations/scrambled-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrambledText))             | Detects cursor position and applies a distortion effect to text.                | `gsap@^3.13.0`                    | `radius`, `duration`, `speed`, `scrambleChars`, `children`, `className`, `style`                                                                                                                                                                                                                                          | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrollFloat](https://reactbits.dev/text-animations/scroll-float) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrollFloat))                   | Text gently floats / parallax shifts on scroll.                                 | `gsap@^3.13.0`                    | `children`, `scrollContainerRef`, `containerClassName`, `textClassName`, `animationDuration`, `ease`, `scrollStart`, `scrollEnd`, `stagger`                                                                                                                                                                               | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrollReveal](https://reactbits.dev/text-animations/scroll-reveal) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrollReveal))                | Text gently unblurs and reveals on scroll.                                      | `gsap@^3.13.0`                    | `children`, `scrollContainerRef`, `enableBlur`, `baseOpacity`, `baseRotation`, `blurStrength`, `containerClassName`, `textClassName`, `rotationEnd`, `wordAnimationEnd`                                                                                                                                                   | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ScrollVelocity](https://reactbits.dev/text-animations/scroll-velocity) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ScrollVelocity))          | Text marquee animatio - speed and distortion scale with user's scroll velocity. | `motion@^12.23.12`                | `scrollContainerRef`, `texts`, `velocity`, `className`, `damping`, `stiffness`, `numCopies`, `velocityMapping`, `parallaxClassName`, `scrollerClassName`, `parallaxStyle`, `scrollerStyle`                                                                                                                                | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [ShinyText](https://reactbits.dev/text-animations/shiny-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/ShinyText))                         | Metallic sheen sweeps across text producing a reflective highlight.             | `motion@^12.23.12`                | `text`, `color`, `shineColor`, `speed`, `delay`, `spread`, `yoyo`, `pauseOnHover`, `direction`, `disabled`, `className`                                                                                                                                                                                                   | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [Shuffle](https://reactbits.dev/text-animations/shuffle) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/Shuffle))                                | Animated text reveal where characters shuffle before settling.                  | `gsap@^3.13.0 @gsap/react@^2.1.2` | `text`, `className`, `style`, `shuffleDirection`, `duration`, `maxDelay`, `ease`, `threshold`, `rootMargin`, `tag`, `textAlign`, `onShuffleComplete`, `shuffleTimes`, `animationMode`, `loop`, `loopDelay`, `stagger`, `scrambleCharset`, `colorFrom`, `colorTo`, `triggerOnce`, `respectReducedMotion`, `triggerOnHover` | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [SplitText](https://reactbits.dev/text-animations/split-text) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/SplitText))                         | Splits text into characters / words for staggered entrance animation.           | `gsap@^3.13.0 @gsap/react@^2.1.2` | `tag`, `text`, `className`, `delay`, `duration`, `ease`, `splitType`, `from`, `to`, `threshold`, `rootMargin`, `textAlign`, `onLetterAnimationComplete`                                                                                                                                                                   | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TextCursor](https://reactbits.dev/text-animations/text-cursor) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TextCursor))                      | Make any text element follow your cursor, leaving a trail of copies behind it.  | `motion@^12.23.12`                | `text`, `spacing`, `followMouseDirection`, `randomFloat`, `exitDuration`, `removalInterval`, `maxPoints`                                                                                                                                                                                                                  | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TextPressure](https://reactbits.dev/text-animations/text-pressure) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TextPressure))                | Characters scale / warp interactively based on pointer pressure zone.           | `none`                            | `text`, `fontFamily`, `fontUrl`, `flex`, `scale`, `alpha`, `stroke`, `width`, `weight`, `italic`, `textColor`, `strokeColor`, `className`, `minFontSize`                                                                                                                                                                  | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TextType](https://reactbits.dev/text-animations/text-type) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TextType))                            | Typewriter effect with blinking cursor and adjustable typing cadence.           | `gsap@^3.13.0`                    | `text`, `as`, `typingSpeed`, `initialDelay`, `pauseDuration`, `deletingSpeed`, `loop`, `className`, `showCursor`, `hideCursorWhileTyping`, `cursorCharacter`, `cursorBlinkDuration`, `cursorClassName`, `textColors`, `variableSpeed`, `onSentenceComplete`, `startOnVisible`, `reverseMode`                              | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [TrueFocus](https://reactbits.dev/text-animations/true-focus) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/TrueFocus))                         | Applies dynamic blur / clarity based over a series of words in order.           | `motion@^12.23.12`                | `sentence`, `separator`, `manualMode`, `blurAmount`, `borderColor`, `glowColor`, `animationDuration`, `pauseBetweenAnimations`                                                                                                                                                                                            | JS-CSS, JS-TW, TS-CSS, TS-TW |
+| [VariableProximity](https://reactbits.dev/text-animations/variable-proximity) ([fonte](https://github.com/DavidHDev/react-bits/tree/3acbd54115330a42e39f63dda2d4859e998b6684/src/ts-default/TextAnimations/VariableProximity)) | Letter styling changes continuously with pointer distance mapping.              | `motion@^12.23.12`                | `label`, `fromFontVariationSettings`, `toFontVariationSettings`, `containerRef`, `radius`, `falloff`                                                                                                                                                                                                                      | JS-CSS, JS-TW, TS-CSS, TS-TW |
+
+## Comandos por componente
+
+Substituir `<Component>` pelo nome exato da primeira coluna:
+
+```bash
+npx shadcn@latest add @react-bits/<Component>-TS-TW
+npx shadcn@latest add https://reactbits.dev/r/<Component>-TS-TW
+npx jsrepo@latest add https://reactbits.dev/r/<Component>-TS-TW
+```

package/docs/framework/software-engineering-applicability.md

@@ -0,0 +1,31 @@
+# Software Engineering Applicability
+
+SINAPSE does not execute all 275 documented engineering workflows for every
+change. It selects an applicable subset from project type, affected surfaces,
+change kind, data classes, deployment target, reversibility and risk.
+
+The Phase 0/1 contract is implemented in
+`packages/engineering-applicability/index.js`. It is deterministic,
+provider-neutral and advisory. Claude Code and Codex receive the exact same
+canonical decision; their adapters may change presentation only.
+
+## Mandatory baseline
+
+Until the protected workflow templates are evolved through framework
+governance, agents must apply these minimum obligations even where a legacy YAML
+marks a review optional:
+
+- every implementation requires a Ready story/spec, traceability and QA;
+- brownfield changes require characterization tests and an incremental change
+  strategy before implementation;
+- frontend work requires design-system grounding and visual validation at
+  desktop and mobile sizes;
+- exposed frontend/API work requires application-security review;
+- database changes require schema, migration, rollback and access-control review;
+- high security, privacy or availability risk adds the respective specialist
+  review;
+- irreversible actions require an explicit human checkpoint;
+- push, PR, release and deploy remain exclusive to DevOps authority.
+
+The advisory engine does not itself block, execute, verify evidence or waive a
+gate. Those capabilities require later stories in the applicability epic.

package/docs/getting-started.md

@@ -11,7 +11,7 @@
 ## Instalação em 1 comando
 
 ```bash
-npx sinapse-ai install
+npx sinapse-ai@latest install
 ```
 
 O wizard detecta seu ambiente, escolhe IDE (Claude Code ou Codex), instala os 17 squads e configura os hooks essenciais automaticamente.
@@ -48,8 +48,12 @@ No prompt do Claude Code ou Codex:
 
 ## Reinstalar / atualizar
 
+Use sempre `@latest` para evitar uma versao antiga mantida no cache do `npx`.
+Em instalacoes globais, execute `npm install -g sinapse-ai@latest` antes de
+`sinapse-ai update`.
+
 ```bash
-npx sinapse-ai install --reconfigure   # reconfigura tudo
+npx sinapse-ai@latest install --reconfigure   # reconfigura tudo
 npx sinapse-ai update                  # atualiza versão sem perder customizações
 npx sinapse-ai uninstall               # remove tudo
 ```

package/docs/installation/README.md

@@ -38,13 +38,13 @@ This directory contains comprehensive installation and setup documentation for S
 ### New Installation
 
 ```bash
-npx sinapse-ai install
+npx sinapse-ai@latest install
 ```
 
 ### Upgrading
 
 ```bash
-npx sinapse-ai install --force-upgrade
+npx sinapse-ai@latest update
 ```
 
 ### Having Issues?

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "sinapse-ai",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "SINAPSE AI: Framework de orquestracao de IA — 17 squads, 172 agentes especializados",
   "bin": {
     "sinapse": "bin/sinapse.js",
     "sinapse-ai": "bin/cli.js",
-    "sinapse-delegate": "bin/sinapse-delegate.js"
+    "sinapse-delegate": "bin/sinapse-delegate.js",
+    "sinapse-codex": ".codex/scripts/sinapse-codex.js"
   },
   "main": ".sinapse-ai/index.js",
   "module": ".sinapse-ai/index.esm.js",
@@ -32,6 +33,10 @@
     ".claude/CLAUDE.md",
     ".claude/rules/",
     ".claude/hooks/",
+    ".claude/agents/",
+    ".claude/skills/",
+    ".claude/skill-manifest.json",
+    "!.claude/agents/coderabbit-reviewer.md",
     ".codex/catalog.json",
     ".codex/command-registry.json",
     ".codex/delegation-matrix.json",
@@ -40,10 +45,14 @@
     ".codex/handoff-packet.template.json",
     ".codex/delegation-parity.json",
     ".codex/instructions.md",
+    ".codex/config.toml",
+    ".codex/hooks.json",
+    ".codex/hooks/",
     ".codex/agents/",
     ".codex/scripts/",
     ".codex/skills/",
     ".codex/tasks/",
+    ".agents/skills/",
     "AGENTS.md",
     "squads/squad-*/**",
     "squads/claude-code-mastery/**",
@@ -108,12 +117,16 @@
     "sync:ide:validate": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js validate",
     "sync:ide:check": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js validate --strict",
     "sync:ide:claude": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js sync --ide claude-code",
-    "sync:ide:codex": "node .sinapse-ai/infrastructure/scripts/sync-codex-local-first.js",
+    "sync:ide:codex": "node .sinapse-ai/infrastructure/scripts/sync-codex-local-first.js && node .codex/scripts/sync-codex-native.js",
+    "sync:providers": "node scripts/sync-provider-adapters.js",
     "validate:claude-sync": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js validate --ide claude-code --strict",
     "validate:claude-integration": "node .sinapse-ai/infrastructure/scripts/validate-claude-integration.js",
+    "validate:providers": "node scripts/validate-provider-adapters.js",
+    "validate:engineering-applicability": "jest tests/unit/engineering-applicability.test.js --runInBand",
     "validate:squad-schema": "node scripts/validate-squad-yaml.js",
     "validate:squad-schema:strict": "node scripts/validate-squad-yaml.js --strict",
-    "validate:codex-sync": "node .sinapse-ai/infrastructure/scripts/validate-codex-sync.js",
+    "validate:codex-sync": "node .sinapse-ai/infrastructure/scripts/validate-codex-sync.js && node .codex/scripts/validate-codex-native.js",
+    "validate:codex-native": "node .codex/scripts/validate-codex-native.js",
     "validate:codex-integration": "node .sinapse-ai/infrastructure/scripts/validate-codex-integration.js",
     "validate:codex-commands": "node .sinapse-ai/infrastructure/scripts/validate-codex-command-registry.js",
     "validate:codex-delegation": "node .sinapse-ai/infrastructure/scripts/validate-codex-delegation.js",
@@ -167,7 +180,6 @@
     "execa": "^5.1.1",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.3.2",
-    "glob": "^10.4.4",
     "handlebars": "^4.7.8",
     "inquirer": "^8.2.6",
     "js-yaml": "^4.2.0",
@@ -219,6 +231,7 @@
     "@typescript-eslint/parser": "^8.46.2",
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "eslint": "^9.38.0",
+    "glob": "^10.4.4",
     "husky": "^9.1.7",
     "jest": "^30.2.0",
     "lint-staged": "^16.1.1",

package/packages/engineering-applicability/fixtures.json

@@ -0,0 +1,52 @@
+{
+  "greenfield-web-low": {
+    "schemaVersion": "1.0.0",
+    "projectType": "greenfield",
+    "surfaces": ["frontend", "api"],
+    "changeKind": "feature",
+    "dataClasses": ["public"],
+    "deploymentTargets": ["web", "cloud"],
+    "reversibility": "reversible",
+    "risk": { "security": "low", "privacy": "low", "availability": "low" }
+  },
+  "greenfield-data-high": {
+    "schemaVersion": "1.0.0",
+    "projectType": "greenfield",
+    "surfaces": ["database", "api"],
+    "changeKind": "feature",
+    "dataClasses": ["personal"],
+    "deploymentTargets": ["cloud"],
+    "reversibility": "conditional",
+    "risk": { "security": "high", "privacy": "high", "availability": "medium" }
+  },
+  "brownfield-ui-low": {
+    "schemaVersion": "1.0.0",
+    "projectType": "brownfield",
+    "surfaces": ["frontend"],
+    "changeKind": "fix",
+    "dataClasses": ["public"],
+    "deploymentTargets": ["web"],
+    "reversibility": "reversible",
+    "risk": { "security": "low", "privacy": "low", "availability": "low" }
+  },
+  "brownfield-service-high": {
+    "schemaVersion": "1.0.0",
+    "projectType": "brownfield",
+    "surfaces": ["api", "database"],
+    "changeKind": "migration",
+    "dataClasses": ["personal"],
+    "deploymentTargets": ["cloud"],
+    "reversibility": "irreversible",
+    "risk": { "security": "high", "privacy": "high", "availability": "high" }
+  },
+  "unknown-surface": {
+    "schemaVersion": "1.0.0",
+    "projectType": "brownfield",
+    "surfaces": ["quantum-ui"],
+    "changeKind": "feature",
+    "dataClasses": ["public"],
+    "deploymentTargets": ["cloud"],
+    "reversibility": "reversible",
+    "risk": { "security": "low", "privacy": "low", "availability": "low" }
+  }
+}

package/packages/engineering-applicability/index.js

@@ -0,0 +1,150 @@
+'use strict';
+
+const crypto = require('crypto');
+
+const SCHEMA_VERSION = '1.0.0';
+const ENUMS = Object.freeze({
+  projectType: ['brownfield', 'greenfield'],
+  surfaces: ['api', 'database', 'frontend'],
+  changeKind: ['feature', 'fix', 'infrastructure', 'migration', 'release'],
+  dataClasses: ['confidential', 'personal', 'public', 'restricted'],
+  deploymentTargets: ['cloud', 'edge', 'mobile', 'on-premise', 'web'],
+  reversibility: ['conditional', 'irreversible', 'reversible'],
+  risk: ['critical', 'high', 'low', 'medium'],
+});
+
+const SOURCES = Object.freeze({
+  lifecycle: ['constitution:III', 'engineering-audit:project-workflows'],
+  appsec: ['domain:29', 'constitution:X'],
+  design: ['domain:43', 'engineering-audit:greenfield-ui'],
+  legacy: ['domain:08', 'engineering-audit:brownfield'],
+  privacy: ['domain:36', 'constitution:X'],
+  availability: ['domain:10', 'constitution:V'],
+});
+
+function stable(value) {
+  if (Array.isArray(value)) return value.map(stable);
+  if (!value || typeof value !== 'object') return value;
+  return Object.fromEntries(Object.keys(value).sort().map((key) => [key, stable(value[key])]));
+}
+
+function digest(value) {
+  return `sha256:${crypto.createHash('sha256').update(JSON.stringify(stable(value))).digest('hex')}`;
+}
+
+function uniqueSorted(values) {
+  return [...new Set(Array.isArray(values) ? values : [])].sort();
+}
+
+function normalizeInput(input = {}) {
+  const unknown = [];
+  const normalized = {
+    schemaVersion: input.schemaVersion,
+    projectType: input.projectType,
+    surfaces: uniqueSorted(input.surfaces),
+    changeKind: input.changeKind,
+    dataClasses: uniqueSorted(input.dataClasses),
+    deploymentTargets: uniqueSorted(input.deploymentTargets),
+    reversibility: input.reversibility,
+    risk: {
+      availability: input.risk?.availability,
+      privacy: input.risk?.privacy,
+      security: input.risk?.security,
+    },
+  };
+
+  if (normalized.schemaVersion !== SCHEMA_VERSION) unknown.push({ field: 'schemaVersion', value: normalized.schemaVersion, reasonCode: 'UNSUPPORTED_SCHEMA' });
+  for (const field of ['projectType', 'changeKind', 'reversibility']) {
+    if (!ENUMS[field].includes(normalized[field])) unknown.push({ field, value: normalized[field], reasonCode: 'UNKNOWN_SIGNAL' });
+  }
+  for (const field of ['surfaces', 'dataClasses', 'deploymentTargets']) {
+    for (const value of normalized[field]) {
+      if (!ENUMS[field].includes(value)) unknown.push({ field, value, reasonCode: 'UNKNOWN_SIGNAL' });
+    }
+  }
+  for (const field of ['availability', 'privacy', 'security']) {
+    if (!ENUMS.risk.includes(normalized.risk[field])) unknown.push({ field: `risk.${field}`, value: normalized.risk[field], reasonCode: 'UNKNOWN_SIGNAL' });
+  }
+
+  return { normalized: stable(normalized), unknown: unknown.sort((a, b) => `${a.field}:${a.value}`.localeCompare(`${b.field}:${b.value}`)) };
+}
+
+function obligation(id, reasonCode, sourceRefs, severity = 'advisory') {
+  return { id, reasonCodes: [reasonCode], severity, sourceRefs: [...sourceRefs].sort() };
+}
+
+function decideApplicability(input) {
+  const { normalized, unknown } = normalizeInput(input);
+  const inputDigest = digest(normalized);
+  if (unknown.length) {
+    const body = {
+      schemaVersion: SCHEMA_VERSION,
+      mode: 'advisory',
+      status: 'unknown-signal',
+      inputDigest,
+      normalized,
+      selected: [],
+      excluded: [],
+      unknown,
+      humanCheckpoints: [{ id: 'classify-unknown-signal', reasonCodes: [...new Set(unknown.map((item) => item.reasonCode))].sort() }],
+    };
+    const decisionDigest = digest(body);
+    return { ...body, decisionId: `ap_${decisionDigest.slice(7, 23)}`, decisionDigest };
+  }
+
+  const selected = [
+    obligation('story-spec-readiness', 'LIFECYCLE_REQUIRED', SOURCES.lifecycle),
+    obligation('quality-assurance', 'QUALITY_REQUIRED', SOURCES.lifecycle),
+    obligation('requirements-traceability', 'NO_INVENTION', SOURCES.lifecycle),
+  ];
+  const excluded = [];
+  const surfaces = new Set(normalized.surfaces);
+  const riskRank = { low: 0, medium: 1, high: 2, critical: 3 };
+
+  if (surfaces.has('frontend')) selected.push(obligation('design-system-grounding', 'SURFACE_FRONTEND', SOURCES.design));
+  else excluded.push(obligation('design-system-grounding', 'SURFACE_ABSENT', SOURCES.design));
+
+  if (surfaces.has('frontend') || surfaces.has('api')) selected.push(obligation('application-security', 'EXPOSED_APPLICATION_SURFACE', SOURCES.appsec));
+  else excluded.push(obligation('application-security', 'SURFACE_ABSENT', SOURCES.appsec));
+
+  if (surfaces.has('database')) selected.push(obligation('database-safety', 'SURFACE_DATABASE', SOURCES.appsec));
+  else excluded.push(obligation('database-safety', 'SURFACE_ABSENT', SOURCES.appsec));
+
+  if (normalized.projectType === 'brownfield') {
+    selected.push(obligation('characterization-baseline', 'PROJECT_BROWNFIELD', SOURCES.legacy));
+    selected.push(obligation('incremental-change-strategy', 'PROJECT_BROWNFIELD', SOURCES.legacy));
+  } else {
+    excluded.push(obligation('characterization-baseline', 'PROJECT_GREENFIELD', SOURCES.legacy));
+    excluded.push(obligation('incremental-change-strategy', 'PROJECT_GREENFIELD', SOURCES.legacy));
+  }
+
+  if (riskRank[normalized.risk.security] >= 2) selected.push(obligation('threat-model', 'SECURITY_HIGH', SOURCES.appsec));
+  if (riskRank[normalized.risk.privacy] >= 2 || normalized.dataClasses.includes('personal')) selected.push(obligation('privacy-impact-assessment', 'PRIVACY_ELEVATED', SOURCES.privacy));
+  if (riskRank[normalized.risk.availability] >= 2) selected.push(obligation('availability-plan', 'AVAILABILITY_HIGH', SOURCES.availability));
+
+  const humanCheckpoints = [];
+  if (normalized.reversibility === 'irreversible') humanCheckpoints.push({ id: 'irreversible-action-approval', reasonCodes: ['IRREVERSIBLE_CHANGE'] });
+
+  selected.sort((a, b) => a.id.localeCompare(b.id));
+  excluded.sort((a, b) => a.id.localeCompare(b.id));
+  const body = {
+    schemaVersion: SCHEMA_VERSION,
+    mode: 'advisory',
+    status: humanCheckpoints.length ? 'human-checkpoint' : 'advisory',
+    inputDigest,
+    normalized,
+    selected,
+    excluded,
+    unknown: [],
+    humanCheckpoints,
+  };
+  const decisionDigest = digest(body);
+  return { ...body, decisionId: `ap_${decisionDigest.slice(7, 23)}`, decisionDigest };
+}
+
+function renderForProvider(provider, decision) {
+  if (!['claude-code', 'codex'].includes(provider)) throw new Error(`Unsupported provider: ${provider}`);
+  return { provider, mode: 'advisory', blocking: false, executedWorkflows: [], verifiedEvidence: [], decision };
+}
+
+module.exports = { SCHEMA_VERSION, ENUMS, normalizeInput, decideApplicability, renderForProvider, digest };

package/packages/installer/src/installer/sinapse-ai-installer.js

@@ -58,6 +58,10 @@ const ROOT_FILES_TO_COPY = [
   'working-in-the-brownfield.md',
 ];
 
+/** Project-local Codex payloads copied only when Codex support is selected. */
+const CODEX_TOP_LEVEL_DIRS = ['.agents', '.codex'];
+const CLAUDE_SUPPORT_DIRS = ['.claude/hooks', '.claude/rules'];
+
 /**
  * Replace {root} placeholder in file content
  * @param {string} content - File content
@@ -116,6 +120,7 @@ async function generateVersionJson(options) {
     version,
     installedFiles,
     mode = 'project-development',
+    providers = [],
   } = options;
 
   const fileHashes = await generateFileHashes(targetSinapseCore, installedFiles);
@@ -124,6 +129,7 @@ async function generateVersionJson(options) {
     version,
     installedAt: new Date().toISOString(),
     mode,
+    providers: [...new Set(providers)].sort(),
     fileHashes,
     customized: [],
   };
@@ -156,6 +162,19 @@ function isUserOwnedL3(destPath) {
   return false;
 }
 
+function isUserOwnedCodexConfig(destPath) {
+  const norm = String(destPath).replace(/\\/g, '/');
+  if (norm.endsWith('/.codex/config.toml') || norm.endsWith('/.codex/hooks.json')) return true;
+  if (/\/\.agents\/skills\/[^/]+\/SKILL\.md$/.test(norm)) {
+    const compatibilityPath = destPath.replace(
+      `${path.sep}.agents${path.sep}skills${path.sep}`,
+      `${path.sep}.codex${path.sep}skills${path.sep}`,
+    );
+    if (!fs.existsSync(destPath) && fs.existsSync(compatibilityPath)) return true;
+  }
+  return /\/(?:\.codex|\.agents)\/skills\/[^/]+\/SKILL\.md$/.test(norm);
+}
+
 async function copyFileWithRootReplacement(sourcePath, destPath, replaceRoot = true, preserveExisting = null) {
   try {
     // Preserve user-owned L3 files (core-config.yaml, agent MEMORY.md) when they
@@ -232,6 +251,43 @@ async function copyDirectoryWithRootReplacement(sourceDir, destDir, onProgress =
   return copiedFiles;
 }
 
+async function deliverClaudeNativeAdapters(pkgRoot, targetDir, options = {}) {
+  const overwriteManaged = options.overwriteManaged === true;
+  const delivered = { agents: [], skills: [], manifest: null };
+  const sourceAgents = path.join(pkgRoot, '.claude', 'agents');
+  if (await fs.pathExists(sourceAgents)) {
+    for (const file of (await fs.readdir(sourceAgents)).filter((name) => /^sinapse-.+\.md$/.test(name))) {
+      const destination = path.join(targetDir, '.claude', 'agents', file);
+      if (!overwriteManaged && await fs.pathExists(destination)) continue;
+      if (await copyFileWithRootReplacement(path.join(sourceAgents, file), destination, true)) {
+        delivered.agents.push(path.join('.claude', 'agents', file));
+      }
+    }
+  }
+
+  const sourceSkills = path.join(pkgRoot, '.claude', 'skills');
+  if (await fs.pathExists(sourceSkills)) {
+    const entries = await fs.readdir(sourceSkills, { withFileTypes: true });
+    for (const entry of entries.filter((item) => item.isDirectory())) {
+      const source = path.join(sourceSkills, entry.name, 'SKILL.md');
+      if (!await fs.pathExists(source)) continue;
+      const relativePath = path.join('.claude', 'skills', entry.name, 'SKILL.md');
+      const destination = path.join(targetDir, relativePath);
+      if (!overwriteManaged && await fs.pathExists(destination)) continue;
+      if (await copyFileWithRootReplacement(source, destination, true)) delivered.skills.push(relativePath);
+    }
+  }
+  const manifestSource = path.join(pkgRoot, '.claude', 'skill-manifest.json');
+  if (await fs.pathExists(manifestSource)) {
+    const relativePath = path.join('.claude', 'skill-manifest.json');
+    const destination = path.join(targetDir, relativePath);
+    if ((overwriteManaged || !await fs.pathExists(destination)) && await copyFileWithRootReplacement(manifestSource, destination, true)) {
+      delivered.manifest = relativePath;
+    }
+  }
+  return delivered;
+}
+
 /**
  * Codex CLI context files that live at the package ROOT (not under .codex/ or
  * .sinapse-ai/), so the directory-copy loops never reach them. AGENTS.md is the
@@ -278,6 +334,8 @@ async function installSinapseCore(options = {}) {
     targetDir = process.cwd(),
     onProgress = null,
     includeCodex = false,
+    includeClaude = false,
+    overwriteManagedAdapters = false,
   } = options;
 
   const result = {
@@ -349,19 +407,42 @@ async function installSinapseCore(options = {}) {
     //              regenerated from squads/ + core by sync-codex-local-first.js.
     const pkgRoot = path.dirname(sourceDir);
     const topLevelDirs = ['squads'];
-    if (includeCodex) topLevelDirs.push('.codex');
+    if (includeCodex) topLevelDirs.push(...CODEX_TOP_LEVEL_DIRS);
+    if (includeClaude) topLevelDirs.push(...CLAUDE_SUPPORT_DIRS);
     for (const dirName of topLevelDirs) {
       const src = path.join(pkgRoot, dirName);
       const dest = path.join(targetDir, dirName);
       if (await fs.pathExists(src)) {
         spinner.text = `Copying ${dirName}...`;
-        const copied = await copyDirectoryWithRootReplacement(src, dest, onProgress);
+        const preserveExisting = dirName === '.codex' || dirName === '.agents'
+          ? isUserOwnedCodexConfig
+          : null;
+        const copied = await copyDirectoryWithRootReplacement(
+          src,
+          dest,
+          onProgress,
+          preserveExisting,
+        );
         result.installedFiles.push(...copied.map((f) => path.join(dirName, f)));
         if (dirName === '.codex') result.codexInstalledFiles = copied.length;
+        if (dirName === '.agents') result.codexNativeSkillFiles = copied.length;
         if (dirName === 'squads') result.squadsInstalledFiles = copied.length;
       }
     }
 
+    if (includeClaude) {
+      const claude = await deliverClaudeNativeAdapters(pkgRoot, targetDir, { overwriteManaged: overwriteManagedAdapters });
+      result.claudeNativeAgentFiles = claude.agents.length;
+      result.claudeNativeSkillFiles = claude.skills.length;
+      result.installedFiles.push(...claude.agents, ...claude.skills);
+      if (claude.manifest) result.installedFiles.push(claude.manifest);
+      const claudeContextSource = path.join(pkgRoot, '.claude', 'CLAUDE.md');
+      const claudeContextDest = path.join(targetDir, '.claude', 'CLAUDE.md');
+      if (await fs.pathExists(claudeContextSource) && await copyFileWithRootReplacement(claudeContextSource, claudeContextDest, true)) {
+        result.installedFiles.push(path.join('.claude', 'CLAUDE.md'));
+      }
+    }
+
     // AGENTS.md is the Codex CLI's default context file (Imperator greeting +
     // the full agent roster). It lives at the package ROOT (not under .codex/ or
     // .sinapse-ai/), so neither loop above reaches it. Without it, a Codex user's
@@ -399,6 +480,7 @@ async function installSinapseCore(options = {}) {
       version: packageVersion,
       installedFiles: result.installedFiles,
       mode: 'project-development',
+      providers: [includeClaude && 'claude-code', includeCodex && 'codex'].filter(Boolean),
     });
     result.versionInfo = versionInfo;
 
@@ -523,7 +605,10 @@ module.exports = {
   generateVersionJson,
   generateFileHashes,
   deliverCodexRootFiles,
+  deliverClaudeNativeAdapters,
   FOLDERS_TO_COPY,
   ROOT_FILES_TO_COPY,
   CODEX_ROOT_FILES,
+  CODEX_TOP_LEVEL_DIRS,
+  CLAUDE_SUPPORT_DIRS,
 };