framework-aidf 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/CHANGELOG.md +174 -0
  2. package/INSTALLATION.md +140 -0
  3. package/LICENSE +21 -0
  4. package/QODER.md +88 -0
  5. package/README.md +142 -2
  6. package/UTILISATION.md +188 -0
  7. package/assets/adapters/qoder/agents/aidf-orchestrator.md +30 -0
  8. package/assets/adapters/qoder/rules/00-core.md +28 -0
  9. package/assets/adapters/qoder/rules/10-security.md +33 -0
  10. package/assets/adapters/qoder/rules/20-context.md +39 -0
  11. package/assets/core/AGENTS.fragment.md +18 -0
  12. package/assets/core/AIDF.md +107 -0
  13. package/assets/docs/APPFLOW.md +66 -0
  14. package/assets/docs/BACKEND.md +71 -0
  15. package/assets/docs/CHANGELOG.md +25 -0
  16. package/assets/docs/CONVENTIONS.md +95 -0
  17. package/assets/docs/DECISIONS.md +60 -0
  18. package/assets/docs/PLAN.md +53 -0
  19. package/assets/docs/PRD.md +88 -0
  20. package/assets/docs/SECURITY.md +94 -0
  21. package/assets/docs/TRD.md +78 -0
  22. package/assets/docs/UI-UX.md +71 -0
  23. package/assets/docs/constitution.md +86 -0
  24. package/assets/hooks/audit.mjs +45 -0
  25. package/assets/hooks/session-context.mjs +53 -0
  26. package/assets/integrations/spec-kit/mapping.yaml +92 -0
  27. package/assets/knowledge/best-practices/testing.md +53 -0
  28. package/assets/knowledge/best-practices/web-dev-baseline.md +39 -0
  29. package/assets/knowledge/rules/api.md +45 -0
  30. package/assets/knowledge/rules/sql.md +44 -0
  31. package/assets/knowledge/rules/typescript.md +50 -0
  32. package/assets/knowledge/security-references/owasp-baseline.md +58 -0
  33. package/assets/registry/activation-map.yaml +83 -0
  34. package/assets/registry/dependencies.yaml +35 -0
  35. package/assets/registry/skills.yaml +541 -0
  36. package/assets/registry/sources.yaml +396 -0
  37. package/assets/schemas/architecture/v1.json +110 -0
  38. package/assets/schemas/constraints/v1.json +93 -0
  39. package/assets/schemas/decision/v1.json +106 -0
  40. package/assets/schemas/discovery/v1.json +91 -0
  41. package/assets/schemas/requirement/v1.json +136 -0
  42. package/assets/schemas/security/threat-model/v1.json +127 -0
  43. package/assets/schemas/test-plan/v1.json +108 -0
  44. package/assets/skills/aidf-architecture-review/SKILL.md +49 -0
  45. package/assets/skills/aidf-backend-implementation/SKILL.md +47 -0
  46. package/assets/skills/aidf-database-design/SKILL.md +48 -0
  47. package/assets/skills/aidf-devops-engineering/SKILL.md +41 -0
  48. package/assets/skills/aidf-documentation-maintenance/SKILL.md +41 -0
  49. package/assets/skills/aidf-frontend-implementation/SKILL.md +44 -0
  50. package/assets/skills/aidf-phase-transition/SKILL.md +48 -0
  51. package/assets/skills/aidf-product-analysis/SKILL.md +47 -0
  52. package/assets/skills/aidf-project-context/SKILL.md +57 -0
  53. package/assets/skills/aidf-requirements-engineering/SKILL.md +52 -0
  54. package/assets/skills/aidf-security-review/SKILL.md +57 -0
  55. package/assets/skills/aidf-testing-validation/SKILL.md +48 -0
  56. package/assets/skills/aidf-ui-ux-implementation/SKILL.md +43 -0
  57. package/assets/workflows/gates.yaml +232 -0
  58. package/assets/workflows/phases.yaml +161 -0
  59. package/bin/aidf.mjs +12 -0
  60. package/demo/run-demo.mjs +97 -0
  61. package/docs/aidf/ADR-001-artefacts-architectur.md +126 -0
  62. package/docs/aidf/ADR-002-requirements-registry.md +145 -0
  63. package/docs/aidf/ADR-003-traceability-chain.md +145 -0
  64. package/docs/aidf/ADR-004-markdown-generation.md +134 -0
  65. package/docs/aidf/ADR-005-validation-and-tests.md +170 -0
  66. package/docs/aidf/ADR-006-cli-commands.md +189 -0
  67. package/docs/aidf/ADR-007-compatibility-and-migration.md +119 -0
  68. package/docs/aidf/ADR-008-schema-versioning.md +115 -0
  69. package/docs/aidf/ADR-009-artefacts-scope.md +84 -0
  70. package/docs/aidf/ARCHITECTURE.md +137 -0
  71. package/docs/aidf/COMPATIBILITY.md +90 -0
  72. package/docs/aidf/DECISIONS.md +200 -0
  73. package/docs/aidf/FRAMEWORK.md +38 -0
  74. package/docs/aidf/IDE-QODER.md +61 -0
  75. package/docs/aidf/INSTALL.md +99 -0
  76. package/docs/aidf/INVENTORY.md +72 -0
  77. package/docs/aidf/L1-ARCHITECTURE-RAPPORT.md +353 -0
  78. package/docs/aidf/LIMITATIONS.md +69 -0
  79. package/docs/aidf/MATRICE-0.1.0-vers-0.2.0.md +155 -0
  80. package/docs/aidf/SECURITY.md +86 -0
  81. package/docs/aidf/SKILLS.md +78 -0
  82. package/docs/aidf/SPECKIT.md +67 -0
  83. package/docs/aidf/USAGE.md +113 -0
  84. package/docs/aidf/VALIDATION.md +55 -0
  85. package/package.json +37 -4
  86. package/src/cli.mjs +148 -0
  87. package/src/commands/artefacts.mjs +129 -0
  88. package/src/commands/config.mjs +130 -0
  89. package/src/commands/context.mjs +55 -0
  90. package/src/commands/decision.mjs +142 -0
  91. package/src/commands/design.mjs +141 -0
  92. package/src/commands/docs.mjs +133 -0
  93. package/src/commands/doctor.mjs +210 -0
  94. package/src/commands/evidence.mjs +178 -0
  95. package/src/commands/install.mjs +154 -0
  96. package/src/commands/release.mjs +214 -0
  97. package/src/commands/requirements.mjs +196 -0
  98. package/src/commands/resources.mjs +181 -0
  99. package/src/commands/scan.mjs +139 -0
  100. package/src/commands/security.mjs +97 -0
  101. package/src/commands/setup.mjs +68 -0
  102. package/src/commands/skills.mjs +204 -0
  103. package/src/commands/speckit.mjs +78 -0
  104. package/src/commands/tests.mjs +81 -0
  105. package/src/commands/traceability.mjs +116 -0
  106. package/src/commands/uninstall.mjs +238 -0
  107. package/src/commands/validate.mjs +84 -0
  108. package/src/commands/workflow.mjs +137 -0
  109. package/src/core/adapters/base.mjs +32 -0
  110. package/src/core/adapters/generic.mjs +70 -0
  111. package/src/core/adapters/index.mjs +24 -0
  112. package/src/core/adapters/opencode.mjs +115 -0
  113. package/src/core/adapters/qoder.mjs +228 -0
  114. package/src/core/artefacts/index.mjs +1 -0
  115. package/src/core/artefacts/validation.mjs +161 -0
  116. package/src/core/bootstrap.mjs +179 -0
  117. package/src/core/config.mjs +123 -0
  118. package/src/core/context.mjs +187 -0
  119. package/src/core/design-engineering/complexity-classifier.mjs +78 -0
  120. package/src/core/design-engineering/engine.mjs +197 -0
  121. package/src/core/design-engineering/fallback/mockups.mjs +221 -0
  122. package/src/core/design-engineering/fallback/wireframes.mjs +114 -0
  123. package/src/core/design-engineering/figma/validators.mjs +178 -0
  124. package/src/core/design-engineering/index.mjs +9 -0
  125. package/src/core/design-engineering/visual-parity/capture.mjs +172 -0
  126. package/src/core/detect.mjs +220 -0
  127. package/src/core/docsgen.mjs +175 -0
  128. package/src/core/evidence.mjs +210 -0
  129. package/src/core/installer.mjs +377 -0
  130. package/src/core/manifest.mjs +53 -0
  131. package/src/core/paths.mjs +94 -0
  132. package/src/core/requirements/index.mjs +13 -0
  133. package/src/core/requirements/registry.mjs +234 -0
  134. package/src/core/resource-inventory.mjs +434 -0
  135. package/src/core/resources.mjs +280 -0
  136. package/src/core/security/threat-model.mjs +235 -0
  137. package/src/core/skills.mjs +353 -0
  138. package/src/core/source-skills.mjs +213 -0
  139. package/src/core/speckit.mjs +195 -0
  140. package/src/core/technology-decision/analyzer-deterministic.mjs +240 -0
  141. package/src/core/technology-decision/engine.mjs +157 -0
  142. package/src/core/technology-decision/generator.mjs +204 -0
  143. package/src/core/technology-decision/index.mjs +17 -0
  144. package/src/core/technology-decision/options/index.mjs +10 -0
  145. package/src/core/testplan.mjs +176 -0
  146. package/src/core/traceability/chain.mjs +488 -0
  147. package/src/core/traceability/index.mjs +12 -0
  148. package/src/core/workflow.mjs +471 -0
  149. package/src/util/args.mjs +69 -0
  150. package/src/util/frontmatter.mjs +26 -0
  151. package/src/util/fsx.mjs +208 -0
  152. package/src/util/logger.mjs +74 -0
  153. package/src/util/text.mjs +66 -0
  154. package/src/util/yaml.mjs +379 -0
package/CHANGELOG.md ADDED
@@ -0,0 +1,174 @@
1
+ # Changelog
2
+
3
+ All notable changes to AIDF are documented here. This project does not use
4
+ conventional commits; each entry names real, verified behaviour changes.
5
+
6
+ ## [0.2.0] — 2026-11-21
7
+
8
+ AIDF 0.2.0 turns the 0.1.0 governance base into a full engineering framework:
9
+ canonical artefacts with traceability, a deterministic technology decision
10
+ engine, design workflows with fallback mockups, resource and third-party
11
+ skill management, an OpenCode adapter with real runtime proof, a STRIDE
12
+ threat-model generator, test planning, generated documentation and a
13
+ release readiness report. Migration from 0.1.0 is additive and tested.
14
+
15
+ ### Added (verified 2026-11-21)
16
+ - Resource Engine v2: `aidf resources inventory|coverage|reconcile` produce a
17
+ file-level sha256 manifest, a licence policy per resource, duplicate-skill
18
+ detection and lock/manifest drift reconciliation. Verified on the real
19
+ `resources/` corpus: 18 resources, 12 533 files, 81 SKILL.md (74 unique
20
+ AVAILABLE, 7 DUPLICATE), 23 secret-like paths skipped.
21
+ - Skills Engine v2: `aidf skills sources|catalog` builds the third-party skill
22
+ catalogue with licence-derived statuses; `aidf skills enable <id>` copies one
23
+ canonical skill into the active adapter directory with an `AIDF-SOURCE.json`
24
+ provenance file; executables and secrets are never copied unless
25
+ `--allow-scripts` is given. Verified by a real copy of `owasp-security`.
26
+ - OpenCode adapter: `aidf install --adapter opencode` writes `AGENTS.md` and
27
+ the 13 built-in skills under `.opencode/skills/`; verification is
28
+ CONTRACT-PROVEN (runtime discovery NOT_PROVEN).
29
+ - Artefact schemas and validation (`src/core/artefacts`, `assets/schemas/`),
30
+ requirements registry and traceability chain (L1-B/L1-C partial).
31
+ - Technology Decision Engine (deterministic analyzer + decision document
32
+ generator; interpretation of trade-offs/risks is delegated to the
33
+ invoking AI agent by design — `analysis.delegation`, no AIDF-owned model).
34
+ - Design Engineering engine (complexity classifier, per-complexity workflows,
35
+ SVG/HTML fallback mockups; Figma integration NOT_PROVEN).
36
+ - Gap matrix: `docs/aidf/MATRICE-0.1.0-vers-0.2.0.md`.
37
+ - CLI commands exposing the L1/L2/L3 engines: `aidf artefacts
38
+ list|show|validate|verify`, `aidf requirements
39
+ list|show|add|update|delete|coverage`, `aidf traceability
40
+ report|verify|missing|broken`, `aidf decision evaluate` (persists a DRAFT
41
+ artefact under `.aidf/artefacts/decisions/`, human approval required) and
42
+ `aidf design classify|run` (writes real SVG/CSS/Markdown fallback outputs).
43
+ - `aidf security analyze|show`: deterministic STRIDE threat model generated
44
+ from project detection (assets, trust boundaries, threats grounded in
45
+ detected surface), persisted as `TM-###` under
46
+ `.aidf/artefacts/security/` with a Markdown report option.
47
+ - `aidf tests plan|coverage`: generates a `TP-###` test-plan artefact (one
48
+ planned case per acceptance criterion, type inferred from wording) and
49
+ reports requirement coverage across planned cases and `TEST-*` artefacts.
50
+ - `aidf docs generate [--check]`: renders canonical artefacts to Markdown
51
+ under `.aidf/docs/generated/` with provenance headers and manual-edit
52
+ divergence detection.
53
+ - `aidf release report [--record] [--strict]`: read-only release readiness
54
+ report aggregating gate evaluations, document statuses, CHANGELOG,
55
+ evidence and artefacts; writes `.aidf/reports/RELEASE-<date>.{json,md}`.
56
+ - Artefact discovery now recurses into subdirectories (`decisions/`,
57
+ `security/`), so nested artefacts appear in `artefacts list`, link
58
+ resolution and traceability; `createLink` writes back to the real path.
59
+ - Migration 0.1.0 → 0.2.0 verified two ways: `tests/migration.test.mjs`
60
+ (legacy fixture upgrades additively, project files preserved, engines
61
+ usable) and a manual run against a real 0.1.0 install copy
62
+ (148 → 198 managed files, 0 conflicts, `doctor` adapter/skills PASS).
63
+ - OpenCode runtime verification (2026-11-21): a real `opencode run` session
64
+ quoted the AIDF instructions and listed the installed skills; `opencode
65
+ debug skill` discovers project skills only inside a git worktree, so
66
+ adapter verification now reports a `git-worktree` check (PARTIAL without
67
+ `.git`).
68
+
69
+ ### Removed
70
+ - `src/core/technology-decision/analyzer-llm.mjs` and the `AI_MODEL` /
71
+ `callLLM` path: AIDF is a governance framework and owns no model. The
72
+ decision document now records `analysis.delegation`
73
+ (`delegatedTo: "invoking-agent"`) so interpretation stays with the AI
74
+ agent that runs the command. Deterministic analysis is unchanged and
75
+ remains the only proven path.
76
+
77
+ ### Fixed (2026-11-21)
78
+ - `getAllArtefactIds` imported `../util/fsx.mjs` from `core/artefacts/`,
79
+ silently resolving no artefact ids and marking every link unresolved.
80
+ - `findMissingLinks` searched link *values* for type names instead of
81
+ resolving targets; it now matches resolved artefact types plus documented
82
+ ID prefixes (`REQ-`, `DES-`, `BACKEND-`, `TEST-`, `EVID-`).
83
+ - `resources inspect` crashed on files larger than 2 GiB (whole-file
84
+ `readFile`): hashing is now capped at 64 MiB with explicit `skipped`
85
+ counters; secret-like paths are never opened.
86
+ - MODULES corpus exclusions extended to media/binaries (ISO, mp4, archives,
87
+ installers) matching its documented course-document scope.
88
+ - Packaging test: GNU tar on Windows treated `C:\…` tarballs as remote hosts;
89
+ `--force-local` and relative paths fix pack/list/extract/pack-install.
90
+ - Adapter registry test updated for the new `opencode` adapter.
91
+
92
+ Test suite: 211/211 PASS (`node --test "tests/**/*.test.mjs"`).
93
+
94
+ ### Fixed
95
+ - npm packaging now ships `INSTALLATION.md`, `UTILISATION.md`, `QODER.md`,
96
+ `CHANGELOG.md` and `demo/`; a packaging test packs, installs, runs
97
+ `--version`, `init` and `doctor` in a temporary prefix.
98
+ - `npm run demo` now runs a real install/doctor/context/gate/resources flow in
99
+ a temporary project; it never prints predefined results.
100
+ - `doc-status` reads the real document frontmatter and fails when it diverges
101
+ from `config.json`; a missing document is `BLOCKED`.
102
+ - A blocking check can no longer be `NOT_APPLICABLE`; a gate with no applicable
103
+ blocking check is `NOT_PROVEN`; a gate with no blocking check must declare
104
+ `applicability: informative` to PASS.
105
+ - `evidence verify` now verifies the whole chain (hashes, `previous` links,
106
+ order, `index.lastHash`, duplicates, missing and unindexed files) and never
107
+ repairs history. `doctor` uses the same verification.
108
+
109
+ ### Added
110
+ - Declared vs authenticated approval: `--human --by` records
111
+ `approval.authenticated: false`; `security.requireAuthenticatedApproval`
112
+ (optional, default false) rejects declared-only approval for human-required
113
+ gates. Existing `approvedBy` is preserved.
114
+ - GitHub Actions CI (syntax, test suite, demo, diagnostics); CI execution is
115
+ `NOT_PROVEN` until the repository is under Git.
116
+ - Tests for config, detect, context, resources, docs, evidence, doctor,
117
+ speckit, packaging, and the new gate/approval semantics. 87 tests pass.
118
+
119
+ ## [0.1.0] — 2026-10-31
120
+
121
+ ### Added
122
+ - Core action engine (`Installer`): `write/copy/mkdir/managed-block/merge-json/
123
+ junction` with manifest ownership, SHA-256 tracking, backups, conflict
124
+ refusal, atomic writes and full dry-run support (`WOULD_*` statuses).
125
+ - Portable install layout: `.aidf/framework` self-contained copy, launcher
126
+ `.aidf/bin/aidf.mjs`, docs/registry/workflows/knowledge/evidence/state, and
127
+ idempotent re-installation.
128
+ - CLI commands with `--json` and the 0/1/2 exit contract: `install`, `init`,
129
+ `update`, `uninstall`, `setup resources`, `resources list|inspect`, `doctor`,
130
+ `scan`, `skills list|validate|show|refresh|link`, `workflow status|enter|exit|
131
+ next|reset`, `validate --list|--phase|--gate`, `evidence list|show|add|
132
+ capture|verify`, `docs list|show|status`, `context --task`, `speckit
133
+ status|init|sync`, `config list|get|set|validate`, `help`, `version`.
134
+ - 11 project document templates with status frontmatter and explicit
135
+ `[TO FILL]` honesty; `aidf docs status` updates frontmatter + manifest.
136
+ - Qoder adapter: 3 rules (00-core, 10-security, 20-context), 13 first-party
137
+ skills, `aidf-orchestrator` agent, optional hooks with redacted audit and
138
+ session context; verifier returning CONTRACT-PROVEN (files) vs NOT_PROVEN
139
+ (runtime UI checks).
140
+ - Generic adapter: AGENTS.md managed block only.
141
+ - Phase workflow (8 phases, 16 gates) with typed checks (`file-exists`,
142
+ `doc-status`, `evidence`, `command`, `previous-gate`, `manual`), command
143
+ execution opt-in (`--allow-exec` or config), shell-free runner rejecting
144
+ shell operators, output captured as evidence.
145
+ - Hash-chained evidence with human approvals (`--by`) and verification tooling.
146
+ - Context assembler with always-on/phase/keyword activation map, caps, and a
147
+ BLOCKED status for contradiction-sensitive documents.
148
+ - Spec Kit integration: status/init/sync; qodercli init; explicit
149
+ `--specify-force` for non-empty projects; copy-with-hash constitution sync
150
+ (CONFLICT never overwrites Spec Kit content); mapping export to
151
+ `.specify/aidf/mapping.md`.
152
+ - Resource registry + lock (`resources.lock.json`) with licence gating:
153
+ unknown licence ⇒ BLOCKED, index-only.
154
+ - 43 tests (unit + CLI end-to-end) passing on Node 24.21.0 / Windows 11 x64.
155
+
156
+ ### Fixed
157
+ - YAML dumper emitted invalid sequence-of-maps (first entry glued to the
158
+ second); roundtrip now verified, including nested arrays and block scalars.
159
+ - `specKitStatus` now detects the real `speckit-*` (hyphen) skill dirs
160
+ generated by specify 1.2.3's qodercli integration.
161
+ - `setup resources` resolution order (project → parent → framework parent →
162
+ framework root) stops installed-copy internal paths (`.aidf/skills`)
163
+ from shadowing real sibling clones.
164
+ - Dry-run installs no longer create `.aidf/logs` (no side effects at all).
165
+ - `Installer.apply` returns only the current batch's results (previously
166
+ accumulated, breaking idempotency reporting in tests).
167
+ - `speckit init` against a non-empty (already installed) project reports
168
+ BLOCKED with an actionable message instead of a raw specify failure.
169
+
170
+ ### Known limitations
171
+ - Qoder rule activation and runtime skill discovery remain manual/human-evidenced
172
+ (by design, not a bug).
173
+ - Spec Kit project-vs-user skill precedence in Qoder docs is contradictory;
174
+ AIDF ignores driver-specific resolution order (project scope only).
@@ -0,0 +1,140 @@
1
+ # AIDF — INSTALLATION (mode d'emploi pas-à-pas)
2
+
3
+ Ce guide décrit l'installation **réelle et vérifiée** d'AIDF dans un projet,
4
+ sa mise à jour et sa désinstallation. Prérequis, options, sorties attendues et
5
+ dépannage inclus.
6
+
7
+ ---
8
+
9
+ ## 1. Prérequis
10
+
11
+ | Prérequis | Détail |
12
+ |---|---|
13
+ | Node.js ≥ 20.11 | Validé sur v24.21.0 (Windows 11). `node --version` doit répondre. |
14
+ | aucun paquet npm | AIDF n'a **aucune dépendance runtime** (vérifié : fonctionne sans `npm install`). |
15
+ | Qoder IDE (optionnel) | Pour l'adaptateur `qoder` : règles/skills/agent/hooks dans `.qoder/`. Sans Qoder, utilisez `--adapter generic` (bloc `AGENTS.md` seulement). |
16
+ | `specify` CLI (optionnel) | Pour l'intégration Spec Kit (`aidf speckit …`) — sinon les gates spec-kit passent en `NOT_APPLICABLE`. |
17
+ | git (optionnel) | Pour des diff d'evidence riches ; sans git, AIDF fonctionne (evidence par liste de fichiers). |
18
+
19
+ ## 2. Installer AIDF dans un projet
20
+
21
+ ### 2.1 Depuis l'intérieur du projet (recommandé)
22
+
23
+ ```powershell
24
+ cd C:\chemin\vers\votre-projet
25
+ node C:\chemin\vers\aidf\bin\aidf.mjs install --adapter qoder --with-hooks
26
+ ```
27
+
28
+ ### 2.2 Depuis l'extérieur (cible explicite)
29
+
30
+ ```powershell
31
+ node C:\chemin\vers\aidf\bin\aidf.mjs install --target C:\projets\mon-projet --adapter qoder --with-hooks
32
+ ```
33
+
34
+ ### 2.3 Sortie attendue (réelle)
35
+
36
+ ```
37
+ [INFO] AIDF install — mon-projet (qoder)
38
+ [INFO] created=135 updated=0 unchanged=0 conflicts=0 failed=0 would=0
39
+ [INFO] Next: node .aidf/bin/aidf.mjs doctor
40
+ ```
41
+
42
+ ### 2.4 Options
43
+
44
+ | Option | Effet |
45
+ |---|---|
46
+ | `--adapter qoder` | Génère règles + 13 skills + agent + (avec hooks) hooks dans `.qoder/` (défaut). |
47
+ | `--adapter generic` | Uniquement le bloc managé `AGENTS.md` (tout IDE compatible AGENTS.md). |
48
+ | `--with-hooks` | Installe aussi `.aidf/hooks/*.mjs` + entrées `SessionStart`/`PostToolUse` dans `.qoder/settings.json` (vos clés/rootSettings conservées). |
49
+ | `--dry-run` | **N'écrit absolument rien** (pas même les logs) ; affiche le plan `WOULD_*`. |
50
+ | `--force` | Ne concerne que les fichiers AIDF déjà présents et modifiés localement (backup automatique dans `.aidf/backups/`). |
51
+ | `--name <nom>` | Nom du projet dans la config. |
52
+
53
+ ### 2.5 Ce qui est préservé (invariants, testés)
54
+
55
+ - Un `AGENTS.md` existant : votre contenu est conservé, le bloc AIDF est
56
+ ajouté entre marqueurs `AIDF:BEGIN/END`.
57
+ - Vos propres règles `.qoder/rules/**` : jamais touchées (seules `aidf-*` sont créées).
58
+ - Un `.qoder/settings.json` existant : fusion **additive** (vos hooks restent).
59
+ - `.env`, `.git`, `node_modules` : ignorés ; **le contenu des secrets n'est jamais lu**.
60
+ - Ré-exécuter `install` : `created=0 updated=0 unchanged=N` (idempotent).
61
+
62
+ ## 3. Après l'installation : vérifier en 4 commandes
63
+
64
+ ```powershell
65
+ node .aidf\bin\aidf.mjs doctor # bilan de santé (attendu : rien de FAIL)
66
+ node .aidf\bin\aidf.mjs scan --record # inventaire + evidence + report SCAN.md
67
+ node .aidf\bin\aidf.mjs skills validate # 13 skills AVAILABLE attendues
68
+ node .aidf\bin\aidf.mjs workflow status # phase courante (intake)
69
+ ```
70
+
71
+ Doctor `--json` donne la même chose en machine-lisible. Les 3 checks
72
+ `runtime-*` de l'adaptateur restent `NOT_PROVEN` tant que l'étape Qoder
73
+ ci-dessous n'a pas été faite par un humain — c'est voulu et documenté.
74
+
75
+ > **IMPORTANT — étape Qoder (3 minutes, une fois par projet)** : suivre les
76
+ > étapes 1→5 de `QODER.md` (ouvrir le projet, `/skills`, Always Apply sur
77
+ > `aidf-00-core` et `aidf-10-security`), puis enregistrer la preuve :
78
+ > `aidf evidence add --type qoder-runtime-activation --human --by "votre_nom"`.
79
+
80
+ ## 4. Mettre à jour
81
+
82
+ Depuis une copie **plus récente** du framework :
83
+
84
+ ```powershell
85
+ node C:\chemin\vers\nouveau-aidf\bin\aidf.mjs update --target C:\projets\mon-projet --adapter qoder --with-hooks
86
+ ```
87
+
88
+ - Seuls les fichiers **managés** sont rafraîchis ; vos documents
89
+ (`.aidf/docs/*`), evidence et état workflow sont préservés.
90
+ - Un fichier managé que vous avez édité → `CONFLICT` (exit 2), contenu
91
+ préservé. Résolution : fusionner à la main, ou `update --force` (backup
92
+ automatique créé d'abord).
93
+ - Idempotence vérifiée : `created=0 updated=14 unchanged=121 conflicts=0`.
94
+
95
+ ## 5. Désinstaller
96
+
97
+ ```powershell
98
+ node .aidf\bin\aidf.mjs uninstall --dry-run # aperçu (rien n'écrit)
99
+ node .aidf\bin\aidf.mjs uninstall --yes # retire tout ce qu'AIDF possède
100
+ node .aidf\bin\aidf.mjs uninstall --yes --keep-data # garde .aidf/docs + evidence
101
+ node .aidf\bin\aidf.mjs uninstall --yes --force # inclut aussi les fichiers managés édités (backup)
102
+ ```
103
+
104
+ Vérifié en réel : sans `--yes` → **refus (exit 1)** ; `AGENTS.md` restauré
105
+ (bloc retiré ; fichier supprimé uniquement s'il ne contenait que le bloc) ;
106
+ vos `existing.md` dans `.qoder/rules/` restent ; les entrées de hooks AIDF
107
+ sont retirées de `.qoder/settings.json` sans toucher au reste ; `.env` intact.
108
+
109
+ ## 6. CI / usage non-interactif
110
+
111
+ Toute commande accepte `--json` et suit le contrat 0/1/2. Exemple :
112
+
113
+ ```powershell
114
+ node .aidf\bin\aidf.mjs doctor --json
115
+ node .aidf\bin\aidf.mjs validate --phase testing --kind exit --allow-exec --json
116
+ ```
117
+
118
+ Pour exécuter des commandes déclarées (tests, build, audit) depuis les gates,
119
+ autorisez une fois dans la config : `aidf config set
120
+ security.allowCommandExecution true` — ou utilisez `--allow-exec` ponctuel.
121
+ C'est shell-free, opérateurs refusés, sortie tronquée et enregistrée.
122
+
123
+ ## 7. Un install par projet
124
+
125
+ AIDF se résout **un root par projet** (marqueur `.aidf/manifest.json`).
126
+ Workspaces multi-projets : installez AIDF dans chaque projet ; le workspace
127
+ lui-même peut être gouverné comme n'importe quel projet (c'est le cas de ce
128
+ dépôt).
129
+
130
+ ## 8. Dépannage installation
131
+
132
+ | Symptôme | Cause | Remède |
133
+ |---|---|---|
134
+ | `AIDF is not initialized …` | Lancement hors projet installé | Lancez dans le projet ou ajoutez `--target <chemin>`. |
135
+ | `… conflicts=1`, exit 2 | Fichier managé édité localement | Fusion manuelle, ou `install/update --force` (backup auto). |
136
+ | Doctor `runtime-* NOT_PROVEN` | Étape UI Qoder non faite | Suivre `QODER.md` puis enregistrer l'evidence humaine. |
137
+ | Doctor `spec-kit NOT_APPLICABLE` | Pas de `.specify/` | Optionnel : `aidf speckit init` (+ `--specify-force` si projet non vide). |
138
+ | Les gates « command » disent BLOCKED | Exécution non autorisée | `--allow-exec` une fois, ou `config set security.allowCommandExecution true`. |
139
+ | `specify init` échoue « not empty » | Projet déjà peuplé (normal) | `aidf speckit init --specify-force` (opt-in explicite, merge vérifié non-destructif). |
140
+ | `skills validate` signale `INCOMPATIBLE` | Frontmatter non conforme (nom >64 / description >1024) | Corriger la SKILL.md source, puis `skills refresh`. |
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AIDF contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/QODER.md ADDED
@@ -0,0 +1,88 @@
1
+ # AIDF — QODER (guide d'intégration de l'IDE)
2
+
3
+ Qoder est le premier adaptateur supporté (`--adapter qoder`). Ce guide
4
+ explique ce qui est installé, **ce qu'un humain doit faire une fois dans
5
+ l'IDE**, et les limites honnêtes.
6
+
7
+ ---
8
+
9
+ ## 1. Ce qu'AIDF installe pour Qoder (vérifié au fichier près)
10
+
11
+ | Emplacement | Contenu |
12
+ |---|---|
13
+ | `AGENTS.md` | Bloc managé `AIDF:BEGIN/END` pointant vers `.aidf/AIDF.md` (contenu utilisateur préservé, restauration à l'uninstall) |
14
+ | `.qoder/rules/aidf-00-core.md` | Règle socle : inspecter avant modifier, statuts, evidence |
15
+ | `.qoder/rules/aidf-10-security.md` | Règle sécurité : secrets jamais lus, exécution opt-in, fichiers protégés |
16
+ | `.qoder/rules/aidf-20-context.md` | Règle contexte : lire `.aidf/state/context/latest.md` avant d'agir |
17
+ | `.qoder/skills/aidf-*/SKILL.md` | 13 skills premières (nom ≤ 64, description ≤ 1024 : contraintes Qoder respectées et testées) |
18
+ | `.qoder/agents/aidf-orchestrator.md` | Agent orchestrateur (outils Read/Grep/Glob/Bash + liste des skills) |
19
+ | `.qoder/settings.json` (option `--with-hooks`) | Entrées `SessionStart` (contexte de session) et `PostToolUse` (audit) **fusionnées** — VOS settings existants sont conservés |
20
+ | `.aidf/hooks/session-context.mjs`, `audit.mjs` | Hooks : rappel de phase / docs bloquées ; audit **métadonnées seulement** (jamais le contenu des fichiers) |
21
+
22
+ Coexistence : les `speckit-*` générés par Spec Kit et vos propres `*.md` de
23
+ règles coexistent sans collision (les fichiers AIDF portent tous le préfixe `aidf-`).
24
+
25
+ ## 2. Activation runtime — 3 étapes HUMAINES (5 minutes, une fois par projet)
26
+
27
+ Ce que le système de fichiers ne peut PAS prouver : que Qoder **charge** les
28
+ règles, découverte les skills et exécute les hooks. D'où le statut
29
+ `NOT_PROVEN` assumé dans `doctor`. Voici la procédure exacte :
30
+
31
+ ### Étape 1 — Découverte des skills
32
+ 1. Ouvrir le projet dans Qoder et attendre la fin de l'indexation.
33
+ 2. Ouvrir la palette/chat et exécuter la commande **`/skills`**.
34
+ 3. Verifier la présence des 13 `aidf-*` (et, si installé, des 10 `speckit-*`).
35
+
36
+ ### Étape 2 — Activation des règles
37
+ 1. Ouvrir **Settings → Rules** dans Qoder.
38
+ 2. Mettre `aidf-00-core` et `aidf-10-security` en **Always Apply**.
39
+ 3. Laisser `aidf-20-context` en `Model Decision` (ou `Specific Files`).
40
+ 4. Le type d'activation est un **réglage UI** de Qoder : il n'est pas encodé
41
+ dans le fichier `.md` (c'est pourquoi le filesystem ne peut pas le prouver).
42
+
43
+ ### Étape 3 — Test des hooks (si `--with-hooks`)
44
+ 1. Redémarrer Qoder (chargement du `SessionStart`).
45
+ 2. Faire une modification minuscule dans un fichier du projet.
46
+ 3. Vérifier qu'une ligne d'audit apparaît dans `.aidf/logs/audit-<date>.jsonl`.
47
+
48
+ ### Enregistrer la preuve (transforme NOT_PROVEN en PROVEN nominatif)
49
+
50
+ ```powershell
51
+ aidf evidence add --type qoder-runtime-activation --human --by "votre_nom" --note "/skills: 13 aidf-*; Always Apply: core + security; audit JSONL reçu"
52
+ ```
53
+
54
+ Après cette evidence, `doctor` reflète l'activation prouvée par un humain
55
+ identifié. Sans cette evidence, aucune commande AIDF ne la simulera — par
56
+ conception.
57
+
58
+ ## 3. Ce que les règles font concrètement pour vous
59
+
60
+ Quand l'IA codeuse travaille dans Qoder :
61
+
62
+ 1. Elle **lit le contexte** (`.aidf/state/context/latest.md`) au démarrage de
63
+ la session (le hook SessionStart y contribue).
64
+ 2. Elle **ne touche pas** : vos fichiers hors manifest, vos secrets, le bloc
65
+ `AIDF:BEGIN/END` de `AGENTS.md`.
66
+ 3. Elle **enregistre** : toute affirmation de test/release passe par les
67
+ gates et l'evidence nominative.
68
+ 4. Elle **sait quoi lire** : les mots-clés de la tâche déclenchent le bon
69
+ ensemble docs/skills (ex. « rgpd/cnil » → SECURITY + security-review).
70
+
71
+ ## 4. Limites documentées (honnêtes)
72
+
73
+ | Limite | Détail | Position AIDF |
74
+ |---|---|---|
75
+ | Type d'activation des règles | Réglage UI, non encodé dans le fichier | Rappel écrit dans la règle ; preuve humaine exigée |
76
+ | Precedence skills projet vs utilisateur | La doc Qoder se contredit (IDE vs CLI) | AIDF installe au niveau **projet** uniquement et ne dépend pas de cet ordre |
77
+ | `.qoder/commands` | Legacy (abandonné par Qoder 1.24+) | Non généré ; les skills sont le mécanisme actuel (vérifié avec Spec Kit qodercli) |
78
+ | Hooks sous environnement Qoder | S'exécutent dans le process de l'IDE | `audit.mjs` ne logue que chemins relatifs + nom d'outil (jamais de contenu) → secret-safe par construction |
79
+ | Runtime Qoder non installé (`qodercli` absent du PATH) | Doctor le signale | L'activation reste une étape humaine dans l'IDE, non automatisable honnêtement |
80
+
81
+ ## 5. Dépannage Qoder
82
+
83
+ | Symptôme | Cause probable | Remède |
84
+ |---|---|---|
85
+ | `/skills` ne montre pas les `aidf-*` | Projet non réindexé / skills hors projet | Réouvrir le projet ; vérifier `.qoder/skills/aidf-*/SKILL.md` présents ; relancer `aidf doctor`. |
86
+ | Les règles « ne s'appliquent pas » | Toujours `Model Decision` | les passer en **Always Apply** (étape 2) puis enregistrer l'evidence. |
87
+ | Pas de fichier `audit-*.jsonl` | Hooks non chargés / install sans `--with-hooks` | Réinstaller avec `--with-hooks`, redémarrer Qoder. |
88
+ | Conflit de hook dans `settings.json` | Édition manuelle hasardeuse | Le merge AIDF est additif ; comparer avec `.aidf/backups/<ts>/` si besoin. |
package/README.md CHANGED
@@ -1,3 +1,143 @@
1
- # Temporary Holding Version
1
+ # AIDF — AI Development Framework
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ **Version 0.2.0** · MIT · Node.js ≥ 20.11 · zéro dépendance runtime
4
+
5
+ > AIDF est une **couche de gouvernance installable** dans un projet : elle
6
+ > encadre le développement assisté par IA (agents, Qoder, Spec Kit) avec des
7
+ > preuves mesurables — pas des promesses.
8
+
9
+ ---
10
+
11
+ ## À quoi ça sert (le problème qu'AIDF résout)
12
+
13
+ Un assistant IA qui code est puissant, mais présente 4 risques réels :
14
+
15
+ | Risque | Sans AIDF | Avec AIDF |
16
+ |---|---|---|
17
+ | **Le faux succès** | « Les tests passent » alors que rien n'a tourné | Un test ne compte que s'il a **réellement** été exécuté et enregistré comme evidence hashée |
18
+ | **L'écrasement silencieux** | L'agent réécrit vos fichiers | Tout fichier écrit est **dans un manifest** (SHA-256) ; vos fichiers ne sont jamais touchés ; toute écriture sur du managé modifié → `CONFLICT`, votre contenu préservé |
19
+ | **Les secrets** | L'agent lit/affiche `.env`, clés… | Politique : **jamais lu, jamais affiché** (noms listés seulement) — vérifié par tests |
20
+ | **La dispersion des règles** | Règles éparpillées, jamais appliquées | Des règles/skills **installées dans l'IDE** (Qoder) + un **sélecteur de contexte** qui choisit quoi lire par tâche |
21
+
22
+ **Utilité en une phrase** : chaque phase (intake → … → release) a des **gates
23
+ exécutable** ; rien ne passe sans preuve enregistrée ; les approbations
24
+ humaines sont nominatives (`--by "prénom"`).
25
+
26
+ ## Ce qu'AIDF fait / ne fait pas
27
+
28
+ **Fait** : installer ~190 fichiers gouvernés dans un projet ; 26 commandes CLI
29
+ (`--json`, exit 0/1/2) dont les moteurs L1–L3 — artefacts canoniques
30
+ (JSON + validation), registre d'exigences, traçabilité exigence→design→
31
+ implémentation→test→preuve, Decision Engine déterministe (interprétation
32
+ déléguée à l'agent hôte), Design Engine (classifieur + mockups SVG/CSS de
33
+ secours), inventaire complet des ressources externes (sha256, licences,
34
+ secrets exclus), catalogue et activation explicite des skills tierces,
35
+ modèle de menace STRIDE, plan de test par critère d'acceptation, génération
36
+ de documentation Markdown avec détection de divergence, et rapport de
37
+ release consolidé ; gérer 8 phases / 16 gates ; chaîner l'evidence
38
+ (SHA-256) ; 13 skills built-in + adaptateurs **Qoder**, **OpenCode**
39
+ (runtime prouvé) et **generic** (AGENTS.md + `.aidf/skills/`) ; intégrer
40
+ GitHub Spec Kit **sans duplication** ; enregistrer des ressources externes
41
+ avec gating de licences.
42
+
43
+ **Ne fait pas** : choisir l'architecture de votre projet ; exécuter des
44
+ commandes sans permission (`--allow-exec` ou config) ; toucher au réseau sans
45
+ autorisation ; lire vos secrets ; se substituer à l'IDE ; publier/pusher.
46
+
47
+ ## Démarrage rapide (3 commandes), résultat réel
48
+
49
+ ```powershell
50
+ # via npm (package framework-aidf) ou depuis un clone/portable
51
+ npx framework-aidf install --target C:\projets\mon-projet --adapter qoder --with-hooks
52
+ # → [INFO] created=~190 updated=0 unchanged=0 conflicts=0 failed=0
53
+
54
+ cd C:\projets\mon-projet
55
+ node .aidf\bin\aidf.mjs doctor # → tout PASS sauf runtime Qoder (NOT_PROVEN, voir QODER.md)
56
+ node .aidf\bin\aidf.mjs context --task "ma première tâche"
57
+ node .aidf\bin\aidf.mjs release report # → bilan de release READY/NOT_READY
58
+ ```
59
+
60
+ Le **premier workflow complet documenté pas-à-pas** (projet TaskFlow, du
61
+ « dicté humain » à la release) est dans `UTILISATION.md` §Exemple réel.
62
+
63
+ ## Les commandes (26 verbes)
64
+
65
+ | Commande | Rôle |
66
+ |---|---|
67
+ | `install` / `init` | Installer la gouvernance dans un projet (identique, idempotent) |
68
+ | `update` | Rafraîchir les fichiers managés (backups auto ; `--force` en cas d'édition locale) |
69
+ | `uninstall` | Retirer AIDF (`--yes` requis ; `--keep-data` garde docs+evidence) |
70
+ | `doctor` | Bilan de santé complet (contrats, manifest, evidence, sécurité) |
71
+ | `scan` | Inventaire du projet (`--record` → report + evidence ; secrets en noms seulement) |
72
+ | `context --task` | Choisir les documents/skills à lire pour une tâche ; `BLOCKED` si contradiction |
73
+ | `workflow status/enter/exit/next` | Avancer **par gates**, jamais en sautant |
74
+ | `validate --gate / --phase` | Évaluer une gate (avec `--allow-exec` pour les commandes) |
75
+ | `evidence add/capture/verify` | Enregistrer/vérifier les preuves (chaîne SHA-256, `--human --by`) |
76
+ | `docs list/show/status/generate` | Les 11 documents projet + statuts ; `generate` rend les artefacts en Markdown (`--check` détecte les éditions manuelles) |
77
+ | `skills list/validate/show/link/refresh/sources/catalog/enable` | Catalogue builtin + skills tierces (licences, doublons, provenance `AIDF-SOURCE.json`) |
78
+ | `config get/set` | Configuration (`commands.*`, `security.*`) |
79
+ | `resources inventory/coverage/reconcile/inspect` | Inventaire sha256 des ressources, politique de licences, dérive lock/manifest |
80
+ | `speckit status/init/sync` | Intégration GitHub Spec Kit (mapping, constitution) |
81
+ | `artefacts list/show/validate/verify` | Artefacts canoniques (exigences, designs, décisions, tests, threat model) |
82
+ | `requirements add/list/show/update/delete/coverage` | Registre d'exigences `REQ-F/NF-###` + couverture |
83
+ | `traceability report/verify/missing/broken` | Chaîne de traçabilité et liens cassés/manquants |
84
+ | `decision evaluate` | Decision Engine déterministe → artefact `decisions/` DRAFT (approbation humaine requise) |
85
+ | `design classify/run` | Classifieur de complexité + workflows de design (mockups SVG/CSS de secours) |
86
+ | `security analyze/show` | Modèle de menace STRIDE `TM-###` généré depuis la détection projet |
87
+ | `tests plan/coverage` | Plan de test `TP-###` (1 cas par critère) + couverture exigence→test |
88
+ | `release report` | Rapport de release READY/NOT_READY (`--record`, `--strict`, `--allow-exec`) |
89
+ | `help`, `version` | Aide et version |
90
+
91
+ Contrat de codes de sortie : **0** succès · **1** échec/refus · **2** conflit/contradiction.
92
+
93
+ ## Vocabulaire de statuts (honnêteté intégrée)
94
+
95
+ - **Documents** : `DRAFT`, `VALIDATED` (exige `--by`), `BLOCKED`, `OUTDATED`, `NOT_APPLICABLE` (exige `--note`).
96
+ - **Gates** : `PASS`, `BLOCKED`, `FAIL`, `NOT_PROVEN`, `NOT_APPLICABLE` — un `NOT_PROVEN` est un état fiable, pas une défaillance.
97
+ - **Skills** : `DISCOVERED` → `VALIDATED` → `REGISTERED` → `AVAILABLE` (`BLOCKED`, `INCOMPATIBLE`).
98
+ - **Rapports** : `PROVEN` (mesuré) · `CONTRACT-PROVEN` (fichiers/contrats) · `NOT_PROVEN` (demande une action humaine) · `BLOCKED` · `NOT_APPLICABLE`.
99
+
100
+ ## Ce qui est installé dans votre projet
101
+
102
+ ```
103
+ AGENTS.md bloc managé (votre contenu préservé)
104
+ .qoder/ règles + 13 skills + agent + hooks (adaptateur qoder)
105
+ .opencode/skills/ 13 skills (adaptateur opencode — runtime prouvé)
106
+ .aidf/skills/ 13 skills (adaptateur generic — tout hôte AGENTS.md)
107
+ .aidf/AIDF.md point d'entrée agent
108
+ .aidf/bin/aidf.mjs lanceur portable
109
+ .aidf/framework/ copie autonome du framework
110
+ .aidf/docs/ 11 documents avec statuts + docs/generated/
111
+ .aidf/artefacts/ exigences, décisions, test-plan, threat-model
112
+ .aidf/registry/ skills, activation-map, dependencies, resources.lock.json
113
+ .aidf/workflows/ phases.yaml + gates.yaml (modifiables projet)
114
+ .aidf/evidence/ preuves chaînées + index
115
+ .aidf/state/, reports/, backups/, logs/
116
+ ```
117
+
118
+ ## Documentation
119
+
120
+ **Guides pratique (français)** : `INSTALLATION.md` · `UTILISATION.md` · `QODER.md`
121
+
122
+ **Références techniques (anglais)**, dans `docs/aidf/` : `ARCHITECTURE.md`,
123
+ `DECISIONS.md` (DEC-001…014), `SKILLS.md`, `SPECKIT.md`, `SECURITY.md`,
124
+ `VALIDATION.md` (les mesures), `LIMITATIONS.md`, `COMPATIBILITY.md`,
125
+ `INVENTORY.md`, `FRAMEWORK.md`.
126
+
127
+ **Journal** : `CHANGELOG.md` (v0.2.0 : moteurs artefacts/requirements/traceability/décision/design, inventaire ressources, skills tierces, adaptateur OpenCode, threat model, test plan, docs generate, release report, migration 0.1.0→0.2.0 prouvée).
128
+
129
+ ## Preuves de qualité (mesurées, pas déclarées)
130
+
131
+ - **212/212 tests** `node --test` (incluant un E2E du CLI : install → doctor →
132
+ scan → skills → context → gate → config → speckit → uninstall).
133
+ - **E2E en situation réelle** : projet TaskFlow gouverné de bout en bout,
134
+ 2 bugs réels détectés/corrigés par les gates, conflit d'édition humain
135
+ traité en exit 2 + backup, Spec Kit installé en merge, 23 evidence
136
+ chaînées vérifiées.
137
+ - Validation détaillée : `docs/aidf/VALIDATION.md`.
138
+
139
+ ## Licence
140
+
141
+ MIT (`LICENSE`). Le corpus de cours privé `MODULES/` de l'auteur **n'est pas
142
+ distribué** (registry index-only, exclusions strictes : `STAGE/**`, `.env*`,
143
+ `*.pem`, `*.crt`, `*.key`, secrets et arborescences de TP).