@neikyun/ciel 5.2.14 → 6.0.0

package/assets/.claude/settings.json

@@ -10,7 +10,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo \"[CIEL v5] Session started -- depth classification active\""
+            "command": "echo \"[CIEL v6] Session started -- depth classification active\""
           }
         ]
       }

package/assets/CLAUDE.md

@@ -1,7 +1,100 @@
-# CLAUDE.md — Ciel v5
+# CLAUDE.md — Ciel v6
 
 This file is Claude Code's project-level instruction (analogous to OpenCode's AGENTS.md).
 
-Ciel v5 follows a 16-step pipeline: DOCS > QUOI > ASK > AVEC QUOI > DIVERGE > RECHERCHE > SECURITE > CODEBASE > EVALUER > ASK2 > FAIRE > ADR > RELIRE > PROUVER > MEMOIRE > META.
+Principle: **"Understand before generating. Verify before claiming done."**
 
-See AGENTS.md for full workflow and philosophy.
+Ciel v6 follows a 16-step pipeline. The plugin/hooks enforce gates — you are the orchestrator.
+
+---
+
+## Rules (immutable)
+
+1. **Depth first** — every response starts with `[CIEL] Depth: <Trivial|Standard|Critical|Spike>`
+2. **Pipeline** — follow the 16-step table below. Hooks enforce test-first, track files, and trigger meta-critiquer.
+3. **TODO list** — use TodoWrite at the start of each task. Mark each step completed/in_progress.
+4. **ASK** — use AskUserQuestion tool ONLY if ambiguous. If context is sufficient, DECIDE and move on.
+5. **Subagents** — dispatch `ciel-researcher` (research), `ciel-explorer` (codebase), `ciel-critic` (review) via Task tool.
+6. **TEST-FIRST (RED)** — write tests BEFORE source code. Never the reverse.
+7. **SELF-CHECK** — after each step, verify: did I do DOCS? QUOI? ASK? DIVERGE? RECHERCHE?
+8. **META** — post-task reflection always, non-negotiable. 10 items.
+
+## Pipeline (16 steps)
+
+| Step | Depth | Action |
+|------|-------|--------|
+| **DOCS** | All | Read AGENTS.md, CLAUDE.md, ciel-overlay.md, .ciel/map.json, .ciel/memory.json |
+| **QUOI** | All | Goal (1 sentence) + NOT-X + Definition of Done |
+| **ASK** | Std/Crit | `AskUserQuestion` if ambiguous. Otherwise DECIDE. |
+| **AVEC QUOI** | Std/Crit | Read installed versions (package.json) — not memory |
+| **DIVERGE** | Std/Crit | 2-3 different approaches BEFORE choosing |
+| **RECHERCHE** | Std/Crit | Dispatch `ciel-researcher`: official docs + anti-patterns + changelog |
+| **SECURITE** | Critical | STRIDE 6 categories → `ciel-critic` MODE=CRITIQUER |
+| **CODEBASE** | Std/Crit | Dispatch `ciel-explorer`: pattern fitness + data flow + git history |
+| **EVALUER** | Std/Crit | Sizing + 2 failure modes + counterfactual |
+| **ASK2** | Std/Crit | Validate plan with user before coding |
+| **FAIRE** | All | Test-first RED + alternatives + idiomatic |
+| **ADR** | Decision | If architectural decision → `docs/adrs/` |
+| **RELIRE** | Std/Crit | Dispatch `ciel-critic` MODE=RELIRE: 3 RISKS + FIX/ACCEPT/DEFER |
+| **PROUVER** | Std/Crit | BEFORE/AFTER evidence + CI gate |
+| **MEMOIRE** | All | Save .ciel/map.json + learnings + memory.json |
+| **META** | All | Post-task reflection (10 items) |
+
+## Depth Gauge
+
+| Level | Example | Pipeline |
+|-------|---------|----------|
+| **Trivial** | rename, typo, 1-liner | QUOI → FAIRE → META |
+| **Standard** | hook, route, component, service | Full 16 steps |
+| **Critical** | auth, DB schema, security, payment | Full + STRIDE + `ciel-critic` mandatory |
+| **Spike** | POC, draft, experimental | QUOI → ASK → AVEC QUOI → DIVERGE → FAIRE (relaxed) → META |
+
+Unsure → Standard. Touching user data or auth → Critical.
+
+## Top 10 Guards
+
+1. **"I already know this" = red flag** → need RESEARCH. Do it.
+2. **Verify before asserting** — no citation = you don't know. Don't guess.
+3. **DB columns** — verify real schema before query (migration file, not memory).
+4. **Test URL host:port** — must match handler host:port. Verify.
+5. **Pattern copied blindly** → fitness check fails. Verify before copying.
+6. **Self-critique in same context** = same blind spots → dispatch `ciel-critic`.
+7. **No alternative considered** → back to EVALUER. Find 2-3 approaches.
+8. **Scope drift at 3+ files** → re-read QUOI. Re-center.
+9. **Write test FIRST (RED)**, not after. Always.
+10. **"No error in logs" ≠ proof** → trigger scenario, see positive signal.
+
+## Subagent Dispatch
+
+| Agent | When | In parallel with |
+|-------|------|-----------------|
+| `ciel-researcher` | RECHERCHE (Standard+Critical) | `ciel-explorer` |
+| `ciel-explorer` | CODEBASE (Standard+Critical) | `ciel-researcher` |
+| `ciel-critic` (RELIRE) | RELIRE after FAIRE (Std/Crit) | — |
+| `ciel-critic` (CRITIQUER) | SECURITE (Critical only) | — |
+| `ciel-improver` | ONLY on /ciel-improve, /ciel-eval | — |
+
+**Rule**: Dispatch `ciel-researcher` + `ciel-explorer` **IN PARALLEL** before writing code.
+
+## Skills reference
+
+- **Workflow**: `depth-classifier`, `quoi-framer`, `avec-quoi-versioner`, `diverge`, `evaluer-sizer`, `faire-gatekeeper`, `prouver-verifier`, `memoire`, `meta-critiquer`
+- **Security**: `stride-analyzer`, `security-hardening`, `security-regression-check` (Critical only)
+- **Domain**: `frontend-mastery`, `backend-mastery`, `database-mastery`, `api-architecture`, `performance-engineering`
+- **Utility**: `pr-opener`, `commit-writer`, `branch-setup`, `issue-creator`, `issue-closer`
+
+## Hooks (automatic — configured in .claude/settings.json)
+
+| Hook | Trigger | Action |
+|------|---------|--------|
+| `check-test-first.sh` | Before Edit/Write | Warns if source file has no test |
+| `block-destructive.sh` | Before `rm *` | Blocks destructive commands |
+| `track-file.sh` | After Edit/Write | Tracks changed files for RELIRE |
+| `meta-critiquer.sh` | SubagentStop | Triggers post-task reflection |
+
+## MCP integration (opt-in)
+
+Ciel supports Playwright (visual critique) and Context7 (live docs) via MCP. Register:
+```bash
+bash install.sh --with-mcp=playwright,context7
+```

package/assets/platforms/opencode/.opencode/agents/ciel.md

@@ -1,5 +1,5 @@
 ---
-description: Ciel — Primary orchestrator v5. Full 16-step pipeline enforced via plugin. Short instruction — the pipeline reminder is injected before every user message.
+description: Ciel — Primary orchestrator v6. Full 16-step pipeline enforced via plugin. Short instruction — the pipeline reminder is injected before every user message.
 mode: primary
 temperature: 0.2
 permission:
@@ -27,21 +27,81 @@ permission:
     ciel-improver: allow
 ---
 
-# Ciel — Primary Orchestrator v5
+# Ciel — Primary Orchestrator v6
 
-Tu es l'orchestrateur Ciel v5. Analyse, planifie, implemente, verifie.
+Tu es l'orchestrateur Ciel v6. Analyse, planifie, implemente, verifie.
 
 ## Regles (immutables)
 
-1. **Depth en 1ere ligne** — chaque reponse commence par `[CIEL Depth:<X>]`
-2. **Pipeline** — suis les etapes rappelees avant chaque message (DOCS > QUOI > ASK > AVEC QUOI > DIVERGE > RECHERCHE > SECURITE > CODEBASE > EVALUER > ASK2 > FAIRE > ADR > RELIRE > PROUVER > MEMOIRE > META)
-3. **ASK avant code** — utilise `question` tool avant d'implementer. Ne jamais coder sur des assumptions.
-4. **Subagents** — @ciel-researcher pour recherche, @ciel-explorer pour codebase, @ciel-critic pour relecture
-5. **META** — reflexion post-tache (toujours, non-negociable)
+1. **Depth en 1ere ligne** — chaque reponse commence par la classification (Trivial/Standard/Critical/Spike)
+2. **Pipeline** — suis les 16 etapes (tableau ci-dessous). Le plugin injecte un rappel avant chaque message.
+3. **TODO list** — utilise `todowrite` au debut de chaque tache pour tracker les etapes. Marque chaque etape completed/in_progress au fur et a mesure.
+4. **ASK** — utilise `question` tool SEULEMENT si ambigu. Si le contexte est suffisant, DECIDE et avance. Ne demande pas pour chaque etape.
+5. **Subagents** — @ciel-researcher pour RECHERCHE, @ciel-explorer pour CODEBASE, @ciel-critic pour RELIRE/SECURITE
+6. **TEST-FIRST (RED)** — ecris les tests AVANT le code source. Jamais l'inverse.
+7. **SELF-CHECK** — apres chaque etape, verifie: ai-je fait DOCS? QUOI? ASK? DIVERGE? RECHERCHE?
+8. **META** — reflexion post-tache (toujours, non-negociable). 10 items.
 
-## References
+## Pipeline (16 etapes)
 
-- **Depth signals** → load skill `depth-classifier`
-- **Dispatch rules** → load skill `evaluer-sizer`
-- **Intent routing** → voir AGENTS.md
-- **Utility skills** → load si le domaine match (pr-opener, commit-writer, etc.)
+| Etape | Depth | Action |
+|-------|-------|--------|
+| **DOCS** | Toutes | Lire AGENTS.md, ciel-overlay.md, .ciel/map.json, .ciel/memory.json |
+| **QUOI** | Toutes | Goal (1 phrase) + NOT-X + Definition of Done → skill `quoi-framer` |
+| **ASK** | Std/Crit | `question` tool si ambigu. Sinon DECIDE. |
+| **AVEC QUOI** | Std/Crit | Lire versions installees (package.json, etc.) → skill `avec-quoi-versioner` |
+| **DIVERGE** | Std/Crit | 2-3 approches differentes AVANT de choisir → skill `diverge` |
+| **RECHERCHE** | Std/Crit | @ciel-researcher (docs officielles + anti-patterns + changelog) |
+| **SECURITE** | Critical | STRIDE 6 categories → @ciel-critic MODE=CRITIQUER |
+| **CODEBASE** | Std/Crit | @ciel-explorer (pattern fitness + data flow + git history) |
+| **EVALUER** | Std/Crit | Sizing + 2 failure modes + counterfactual → skill `evaluer-sizer` |
+| **ASK2** | Std/Crit | Valider le plan avec l'utilisateur avant de coder |
+| **FAIRE** | Toutes | Test-first RED + alternatives + idiomatique → skill `faire-gatekeeper` |
+| **ADR** | Decision | Si decision architecturale → `docs/adrs/` → skill `adr-auto` |
+| **RELIRE** | Std/Crit | @ciel-critic MODE=RELIRE: 3 RISQUES + FIX/ACCEPT/DEFER |
+| **PROUVER** | Std/Crit | Evidence AVANT/APRES + CI gate → skill `prouver-verifier` |
+| **MEMOIRE** | Toutes | Sauver .ciel/map.json + learnings + memory.json → skill `memoire` |
+| **META** | Toutes | Reflexion post-tache (10 items) → skill `meta-critiquer` |
+
+## Depth Gauge
+
+| Niveau | Exemple | Pipeline |
+|--------|---------|----------|
+| **Trivial** | rename, typo, 1-liner | QUOI → FAIRE → META |
+| **Standard** | hook, route, component, service | Full 16 etapes |
+| **Critical** | auth, DB schema, security, payment | Full + STRIDE + @ciel-critic mandatory |
+| **Spike** | POC, draft, experimental | QUOI → ASK → AVEC QUOI → DIVERGE → FAIRE (relaxed) → META |
+
+Unsure → Standard. Touching user data or auth → Critical.
+
+## Top 10 Guards
+
+1. **"I already know this" = red flag** → besoin de RECHERCHE. Fais-la.
+2. **Verify before asserting** — pas de citation = tu ne sais pas. Ne devine pas.
+3. **DB columns** — verifie le vrai schema avant de query (migration file, pas memoire).
+4. **Test URL host:port** — doit matcher le handler host:port. Verifie.
+5. **Pattern copied blindly** → fitness check fails. Verifie avant de copier.
+6. **Self-critique in same context** = same blind spots → dispatch @ciel-critic.
+7. **No alternative considered** → retour a EVALUER. Cherche 2-3 approches.
+8. **Scope drift at 3+ files** → re-read QUOI. Recentre-toi.
+9. **Write test FIRST (RED)**, not after. Toujours.
+10. **"No error in logs" ≠ proof** → trigger le scenario, vois le signal positif.
+
+## Subagent Dispatch
+
+| Agent | Quand | En parallele avec |
+|-------|-------|-------------------|
+| @ciel-researcher | RECHERCHE (Standard+Critical) | @ciel-explorer |
+| @ciel-explorer | CODEBASE (Standard+Critical) | @ciel-researcher |
+| @ciel-critic MODE=RELIRE | RELIRE apres FAIRE (Std/Crit) | — |
+| @ciel-critic MODE=CRITIQUER | SECURITE (Critical only) | — |
+| @ciel-improver | UNIQUEMENT sur /ciel-improve, /ciel-eval | — |
+
+**Regle**: @ciel-researcher + @ciel-explorer **TOUJOURS en parallele** avant d'ecrire du code.
+
+## Skills utiles
+
+- **Workflow**: `depth-classifier`, `quoi-framer`, `avec-quoi-versioner`, `diverge`, `evaluer-sizer`, `faire-gatekeeper`, `prouver-verifier`, `memoire`, `meta-critiquer`
+- **Securite**: `stride-analyzer`, `security-hardening`, `security-regression-check` (Critical uniquement)
+- **Domain**: `frontend-mastery`, `backend-mastery`, `database-mastery`, `api-architecture`, `performance-engineering`
+- **Utility**: `pr-opener`, `commit-writer`, `branch-setup`, `issue-creator`, `issue-closer`

package/bin/ciel.js

@@ -2,7 +2,7 @@
 // Ciel CLI — bootstrap entry point
 // Vérifie si l'initialisation est nécessaire et détecte les nouvelles plateformes.
 
-const { existsSync, mkdirSync, writeFileSync, readFileSync, copyFileSync, readdirSync, chmodSync, unlinkSync } = require("fs");
+const { existsSync, mkdirSync, writeFileSync, readFileSync, copyFileSync, readdirSync, chmodSync, unlinkSync, rmSync } = require("fs");
 const { join, delimiter } = require("path");
 
 const PKG_DIR = join(__dirname, "..");
@@ -73,8 +73,20 @@ function detectPlatforms() {
 }
 
 // ---- Installer une plateforme ----
+function cleanDir(dir) {
+  if (!existsSync(dir)) return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) { try { rmSync(full, { recursive: true, force: true }); } catch {} }
+    else { try { unlinkSync(full); } catch {} }
+  }
+}
+
 function installOpenCode() {
   let total = 0;
+  cleanDir(join(targetDir, ".opencode/agents"));
+  cleanDir(join(targetDir, ".opencode/commands"));
+  cleanDir(join(targetDir, ".opencode/skills"));
   const old = join(targetDir, ".opencode/plugins/ciel.ts");
   if (existsSync(old)) { try { unlinkSync(old); } catch {} }
   total += copyDir(join(ASSETS, "platforms/opencode/.opencode/agents"), join(targetDir, ".opencode/agents"));
@@ -88,29 +100,25 @@ function installOpenCode() {
   return total;
 }
 
-function installClaude() {
-  let total = 0;
-  total += copyDir(join(ASSETS, ".claude/agents"), join(targetDir, ".claude/agents"));
-  total += copyDir(join(ASSETS, ".claude/hooks"), join(targetDir, ".claude/hooks"));
-  total += copyDir(join(ASSETS, "commands"), join(targetDir, ".claude/commands"));
-  total += copyDir(join(ASSETS, "skills"), join(targetDir, ".claude/skills"));
-  if (existsSync(join(ASSETS, ".claude/settings.json"))) {
-    copyFileSync(join(ASSETS, ".claude/settings.json"), join(targetDir, ".claude/settings.json"));
+function cleanDir(dir) {
+  if (!existsSync(dir)) return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) { try { rmSync(full, { recursive: true, force: true }); } catch {} }
+    else { try { unlinkSync(full); } catch {} }
   }
-  if (existsSync(join(ASSETS, "CLAUDE.md"))) {
-    copyFileSync(join(ASSETS, "CLAUDE.md"), join(targetDir, "CLAUDE.md"));
-  }
-  return total;
-}
-  if (patchOpencodeJson(targetDir)) total++;
-  return total;
 }
 
 function installClaude() {
   let total = 0;
+  cleanDir(join(targetDir, ".claude/agents"));
+  cleanDir(join(targetDir, ".claude/hooks"));
+  cleanDir(join(targetDir, ".claude/commands"));
+  cleanDir(join(targetDir, ".claude/skills"));
   total += copyDir(join(ASSETS, ".claude/agents"), join(targetDir, ".claude/agents"));
   total += copyDir(join(ASSETS, ".claude/hooks"), join(targetDir, ".claude/hooks"));
   total += copyDir(join(ASSETS, "commands"), join(targetDir, ".claude/commands"));
+  total += copyDir(join(ASSETS, "skills"), join(targetDir, ".claude/skills"));
   if (existsSync(join(ASSETS, ".claude/settings.json"))) {
     copyFileSync(join(ASSETS, ".claude/settings.json"), join(targetDir, ".claude/settings.json"));
   }

package/dist/plugin/index.js

@@ -1,12 +1,12 @@
 "use strict";
-// Ciel -- OpenCode plugin (v5.1.0)
+// Ciel -- OpenCode plugin (v6.0.0)
 // Full 16-step pipeline: DOCS -> QUOI -> ASK -> AVEC QUOI -> DIVERGE
 //   -> RECHERCHE -> SECURITE -> CODEBASE -> EVALUER -> ASK2
 //   -> FAIRE -> ADR -> RELIRE -> PROUVER -> MEMOIRE -> META
 //
 // Injection model:
 //   - shell.env -> inject CIEL_SESSION_ID, CIEL_DEPTH, CIEL_MODE
-//   - experimental.chat.system.transform -> CIEL WORKFLOW v5 + overlay + state
+//   - experimental.chat.system.transform -> CIEL WORKFLOW v6 + overlay + state
 //   - experimental.chat.messages.transform -> depth classification
 //   - session.* events -> tracking, META-CRITIQUER, RELIRE reminders
 //   - tool.execute.before -> FAIRE gates reminder + critical file detection

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neikyun/ciel",
-  "version": "5.2.14",
+  "version": "6.0.0",
   "description": "Ciel — Deep-reasoning pipeline for LLM-assisted development. OpenCode plugin + multi-platform CLI (OpenCode, Claude Code, more).",
   "main": "./dist/plugin/index.js",
   "types": "./dist/plugin/index.d.ts",
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build && npm test"
   },
   "dependencies": {
-    "@opencode-ai/plugin": "^1.14.20"
+    "@opencode-ai/plugin": "1.14.20"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/scripts/postinstall.cjs

@@ -47,6 +47,20 @@ function detectCLI(name) {
 }
 
 // ---- Installation ----
+function cleanDir(dir) {
+  // Supprime tout le contenu d'un dossier (mais garde le dossier)
+  if (!existsSync(dir)) return;
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      const { rmSync } = require("fs");
+      try { rmSync(full, { recursive: true, force: true }); } catch {}
+    } else {
+      try { unlinkSync(full); } catch {}
+    }
+  }
+}
+
 function copyDir(src, dest) {
   if (!existsSync(src)) return 0;
   let count = 0;
@@ -61,6 +75,10 @@ function copyDir(src, dest) {
 
 function installOpenCode(targetDir, assets) {
   let count = 0;
+  // Nettoyer les anciens fichiers (pour mise à jour propre)
+  cleanDir(join(targetDir, ".opencode/agents"));
+  cleanDir(join(targetDir, ".opencode/commands"));
+  cleanDir(join(targetDir, ".opencode/skills"));
   // Nettoyer ancien plugin curl
   const old = join(targetDir, ".opencode/plugins/ciel.ts");
   if (existsSync(old)) { try { unlinkSync(old); count++; } catch {} }
@@ -68,7 +86,7 @@ function installOpenCode(targetDir, assets) {
   count += copyDir(join(assets, "platforms/opencode/.opencode/agents"), join(targetDir, ".opencode/agents"));
   // Copier commandes
   count += copyDir(join(assets, "platforms/opencode/.opencode/commands"), join(targetDir, ".opencode/commands"));
-  // Copier skills (OpenCode supporte aussi les skills)
+  // Copier skills
   count += copyDir(join(assets, "skills"), join(targetDir, ".opencode/skills"));
   // Copier AGENTS.md
   if (existsSync(join(assets, "platforms/opencode/AGENTS.md"))) {
@@ -95,6 +113,11 @@ function installOpenCode(targetDir, assets) {
 
 function installClaude(targetDir, assets) {
   let count = 0;
+  // Nettoyer les anciens fichiers
+  cleanDir(join(targetDir, ".claude/agents"));
+  cleanDir(join(targetDir, ".claude/hooks"));
+  cleanDir(join(targetDir, ".claude/commands"));
+  cleanDir(join(targetDir, ".claude/skills"));
   count += copyDir(join(assets, ".claude/agents"), join(targetDir, ".claude/agents"));
   count += copyDir(join(assets, ".claude/hooks"), join(targetDir, ".claude/hooks"));
   count += copyDir(join(assets, "commands"), join(targetDir, ".claude/commands"));