@iconsulting-dev/forgekit 1.6.2 → 1.7.0

package/README.md

@@ -90,8 +90,9 @@ mon-projet/
 ├── frontend/                # Angular 21 / PrimeNG 21
 ├── docker-compose.yml       # PostgreSQL 17 + pgAdmin (+ service api si FastAPI)
 ├── .github/workflows/       # CI GitHub Actions
-├── CLAUDE.md                # Conventions Claude Code
-├── .claude/settings.json    # Permissions Claude Code
+├── CLAUDE.md                # Conventions, workflow routing, constitution ref
+├── .claude/                 # Hooks, hookify guards, skills, settings
+├── .specify/memory/         # Constitution architecturale
 ├── .gitignore
 └── README.md
 ```
@@ -196,9 +197,35 @@ frontend/src/app/
 
 ### Claude Code
 
-Génère automatiquement :
-- **`CLAUDE.md`** — Conventions du projet, commandes, structure, workflow speckit
-- **`.claude/settings.json`** — Permissions préconfigurées selon le backend choisi
+Génère automatiquement une configuration complète et prête à l'emploi :
+
+```
+mon-projet/
+├── CLAUDE.md                          # Workflow routing, TDD rules, constitution ref
+├── .claudeignore                      # Fichiers exclus du contexte Claude
+├── .claude/
+│   ├── settings.json                  # Permissions + hooks (SessionStart, PreToolUse, PreCompact)
+│   ├── hooks/
+│   │   ├── pre-bash.sh               # Guard bash (ex: bloque npm install hors frontend/)
+│   │   └── session-start.sh          # Auto-charge la constitution au démarrage
+│   ├── hookify.block-dangerous-rm.local.md   # Bloque rm -rf
+│   ├── hookify.block-force-push.local.md     # Bloque git push --force
+│   ├── hookify.block-no-verify.local.md      # Bloque --no-verify
+│   ├── hookify.stop-verify-tests.local.md    # Rappel TDD à la fin de session
+│   ├── hookify.warn-console-log.local.md     # Avertit sur console.log
+│   ├── hookify.warn-env-edit.local.md        # Avertit sur édition .env
+│   ├── hookify.warn-no-test-before-commit.local.md  # Rappel tests avant commit
+│   ├── hookify.warn-todo-fixme.local.md      # Avertit sur TODO/FIXME
+│   └── skills/                        # Skills copiés selon le stack
+│       ├── applying-angular-conventions/SKILL.md   # si frontend Angular
+│       ├── applying-python-conventions/SKILL.md    # si backend FastAPI
+│       └── applying-java-conventions/SKILL.md      # si backend Spring Boot
+└── .specify/
+    └── memory/
+        └── constitution.md            # Constitution architecturale (auto-chargée)
+```
+
+Les skills sont copiés depuis `~/.claude/skills/` selon le stack sélectionné — chaque dev qui clone le projet dispose des mêmes conventions.
 
 ## Versions dynamiques
 
@@ -232,7 +259,7 @@ src/
 │   ├── fastapi/                 # FastAPI (8 templates)
 │   ├── frontend/                # Angular (21 templates)
 │   ├── docker/                  # Docker Compose
-│   ├── claude-code/             # CLAUDE.md + settings.json
+│   ├── claude-code/             # CLAUDE.md, settings.json, hooks, hookify, specify
 │   ├── ci/                      # GitHub Actions
 │   └── root/                    # README + .gitignore
 ├── utils/

package/dist/generators/claude-code/__tests__/claude-code.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-code.test.d.ts.map

package/dist/generators/claude-code/__tests__/claude-code.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.test.d.ts","sourceRoot":"","sources":["../../../../src/generators/claude-code/__tests__/claude-code.test.ts"],"names":[],"mappings":""}

package/dist/generators/claude-code/__tests__/claude-code.test.js

@@ -0,0 +1,116 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs-extra";
+import path from "node:path";
+import os from "node:os";
+import { generateClaudeCode } from "../index.js";
+// Fake global skills dir — seeded in beforeEach, used in skill tests
+let fakeSkillsDir;
+const baseConfig = {
+    name: "test-project",
+    groupId: "com.example",
+    description: "Test",
+    backendType: null,
+    frontend: false,
+    flyway: false,
+    openapi: false,
+    auth: false,
+    mapstruct: false,
+    uiFramework: "none",
+    primeNGPreset: "Aura",
+    ngrx: false,
+    docker: false,
+    ci: false,
+    claudeCode: true,
+    gitInit: false,
+};
+const baseVersions = {
+    springBoot: "3.4.0",
+    springDoc: "2.8.0",
+    mapstruct: "1.6.3",
+    angular: "19.0.0",
+    primeng: "19.0.0",
+    primeuixThemes: "2.0.3",
+    primeicons: "7.0.0",
+    primeflex: "3.3.1",
+    ngrxSignals: "19.0.0",
+    rxjs: "7.8.0",
+    zoneJs: "0.15.0",
+    typescript: "5.6.0",
+    tailwind: "4.0.0",
+};
+describe("ClaudeCodeGenerator", () => {
+    let tmpDir;
+    beforeEach(async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "forgekit-test-"));
+        fakeSkillsDir = path.join(tmpDir, "fake-skills");
+        for (const skill of [
+            "applying-angular-conventions",
+            "applying-python-conventions",
+            "applying-java-conventions",
+        ]) {
+            await fs.ensureDir(path.join(fakeSkillsDir, skill));
+            await fs.writeFile(path.join(fakeSkillsDir, skill, "SKILL.md"), `# ${skill}`);
+        }
+    });
+    afterEach(async () => {
+        await fs.remove(tmpDir);
+    });
+    it("generates hooks directory with scripts", async () => {
+        await generateClaudeCode(tmpDir, baseConfig, baseVersions);
+        expect(await fs.pathExists(path.join(tmpDir, ".claude", "hooks", "pre-bash.sh"))).toBe(true);
+        expect(await fs.pathExists(path.join(tmpDir, ".claude", "hooks", "session-start.sh"))).toBe(true);
+    });
+    it("makes hook scripts executable", async () => {
+        await generateClaudeCode(tmpDir, baseConfig, baseVersions);
+        const stat = await fs.stat(path.join(tmpDir, ".claude", "hooks", "pre-bash.sh"));
+        expect(stat.mode & 0o100).toBeTruthy();
+    });
+    it("generates hookify guard files", async () => {
+        await generateClaudeCode(tmpDir, baseConfig, baseVersions);
+        const hookifyFiles = [
+            "block-dangerous-rm.local.md",
+            "block-force-push.local.md",
+            "block-no-verify.local.md",
+            "stop-verify-tests.local.md",
+            "warn-console-log.local.md",
+            "warn-env-edit.local.md",
+            "warn-no-test-before-commit.local.md",
+            "warn-todo-fixme.local.md",
+        ];
+        for (const f of hookifyFiles) {
+            expect(await fs.pathExists(path.join(tmpDir, ".claude", `hookify.${f}`))).toBe(true);
+        }
+    });
+    it("generates .specify/memory/constitution.md", async () => {
+        await generateClaudeCode(tmpDir, baseConfig, baseVersions);
+        expect(await fs.pathExists(path.join(tmpDir, ".specify", "memory", "constitution.md"))).toBe(true);
+    });
+    it("settings.json contains hooks configuration", async () => {
+        await generateClaudeCode(tmpDir, baseConfig, baseVersions);
+        const settings = await fs.readJson(path.join(tmpDir, ".claude", "settings.json"));
+        expect(settings.hooks).toBeDefined();
+        expect(settings.hooks.SessionStart).toBeDefined();
+        expect(settings.hooks.PreToolUse).toBeDefined();
+        expect(settings.hooks.PreCompact).toBeDefined();
+    });
+    it("generates angular skill when frontend is enabled", async () => {
+        const config = { ...baseConfig, frontend: true };
+        await generateClaudeCode(tmpDir, config, baseVersions, fakeSkillsDir);
+        expect(await fs.pathExists(path.join(tmpDir, ".claude", "skills", "applying-angular-conventions", "SKILL.md"))).toBe(true);
+    });
+    it("generates python skill when fastapi backend", async () => {
+        const config = { ...baseConfig, backendType: "fastapi" };
+        await generateClaudeCode(tmpDir, config, baseVersions, fakeSkillsDir);
+        expect(await fs.pathExists(path.join(tmpDir, ".claude", "skills", "applying-python-conventions", "SKILL.md"))).toBe(true);
+    });
+    it("generates java skill when spring-boot backend", async () => {
+        const config = { ...baseConfig, backendType: "spring-boot" };
+        await generateClaudeCode(tmpDir, config, baseVersions, fakeSkillsDir);
+        expect(await fs.pathExists(path.join(tmpDir, ".claude", "skills", "applying-java-conventions", "SKILL.md"))).toBe(true);
+    });
+    it("generates no stack skills when claude-only (no backend, no frontend)", async () => {
+        await generateClaudeCode(tmpDir, baseConfig, baseVersions, fakeSkillsDir);
+        expect(await fs.pathExists(path.join(tmpDir, ".claude", "skills"))).toBe(false);
+    });
+});
+//# sourceMappingURL=claude-code.test.js.map

package/dist/generators/claude-code/__tests__/claude-code.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.test.js","sourceRoot":"","sources":["../../../../src/generators/claude-code/__tests__/claude-code.test.ts"],"names":[],"mappings":"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"}

package/dist/generators/claude-code/index.d.ts

@@ -1,4 +1,4 @@
 import type { ProjectConfig } from "../../types.js";
 import type { ResolvedVersions } from "../../versions.js";
-export declare function generateClaudeCode(projectDir: string, config: ProjectConfig, versions: ResolvedVersions): Promise<void>;
+export declare function generateClaudeCode(projectDir: string, config: ProjectConfig, versions: ResolvedVersions, globalSkillsBase?: string): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/generators/claude-code/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/claude-code/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAwG1D,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAGf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/claude-code/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAkM1D,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/generators/claude-code/index.js

@@ -1,12 +1,16 @@
 import path from "node:path";
+import os from "node:os";
 import fs from "fs-extra";
-import { renderAndWrite } from "../../utils/template-engine.js";
+import { renderAndWrite, TEMPLATES_DIR } from "../../utils/template-engine.js";
 import { BaseGenerator } from "../base-generator.js";
 class ClaudeCodeGenerator extends BaseGenerator {
     versions;
-    constructor(projectDir, config, versions) {
+    globalSkillsBase;
+    constructor(projectDir, config, versions, globalSkillsBase) {
         super(projectDir, config);
         this.versions = versions;
+        this.globalSkillsBase =
+            globalSkillsBase ?? path.join(os.homedir(), ".claude", "skills");
     }
     async generate() {
         const claudeDir = path.join(this.projectDir, ".claude");
@@ -15,6 +19,9 @@ class ClaudeCodeGenerator extends BaseGenerator {
         const springBoot = this.config.backendType === "spring-boot";
         const fastapi = this.config.backendType === "fastapi";
         const backend = this.config.backendType !== null;
+        const hooksDir = path.join(claudeDir, "hooks");
+        await fs.ensureDir(hooksDir);
+        await fs.ensureDir(path.join(this.projectDir, ".specify", "memory"));
         const data = {
             name: this.config.name,
             description: this.config.description,
@@ -28,12 +35,58 @@ class ClaudeCodeGenerator extends BaseGenerator {
             auth: this.config.auth,
             versions: this.versions,
             allowedCommands,
+            claudeDir: ".claude",
         };
+        // Static hookify files (no templating needed)
+        const staticHookifyFiles = [
+            "block-dangerous-rm.local.md",
+            "block-force-push.local.md",
+            "block-no-verify.local.md",
+            "warn-console-log.local.md",
+            "warn-env-edit.local.md",
+            "warn-todo-fixme.local.md",
+        ];
         await Promise.all([
+            // Existing files
             renderAndWrite("claude-code/CLAUDE.md.hbs", path.join(this.projectDir, "CLAUDE.md"), data),
             renderAndWrite("claude-code/settings.json.hbs", path.join(claudeDir, "settings.json"), data),
             renderAndWrite("claude-code/claudeignore.hbs", path.join(this.projectDir, ".claudeignore"), data),
+            // Hook scripts (templated, then chmod)
+            renderAndWrite("claude-code/hooks/pre-bash.sh.hbs", path.join(hooksDir, "pre-bash.sh"), data, { mode: 0o755 }),
+            renderAndWrite("claude-code/hooks/session-start.sh.hbs", path.join(hooksDir, "session-start.sh"), data, { mode: 0o755 }),
+            // Templated hookify files
+            renderAndWrite("claude-code/hookify/stop-verify-tests.local.md.hbs", path.join(claudeDir, "hookify.stop-verify-tests.local.md"), data),
+            renderAndWrite("claude-code/hookify/warn-no-test-before-commit.local.md.hbs", path.join(claudeDir, "hookify.warn-no-test-before-commit.local.md"), data),
+            // .specify constitution
+            renderAndWrite("claude-code/specify/constitution.md.hbs", path.join(this.projectDir, ".specify", "memory", "constitution.md"), data),
+            // Static hookify files
+            ...staticHookifyFiles.map((f) => fs.copy(path.join(TEMPLATES_DIR, "claude-code", "hookify", f), path.join(claudeDir, `hookify.${f}`))),
         ]);
+        await this.generateSkills();
+    }
+    async generateSkills() {
+        const globalSkillsBase = this.globalSkillsBase;
+        const skillsToGenerate = [
+            { name: "applying-angular-conventions", condition: this.config.frontend },
+            {
+                name: "applying-python-conventions",
+                condition: this.config.backendType === "fastapi",
+            },
+            {
+                name: "applying-java-conventions",
+                condition: this.config.backendType === "spring-boot",
+            },
+        ];
+        for (const { name, condition } of skillsToGenerate) {
+            if (!condition)
+                continue;
+            const src = path.join(globalSkillsBase, name, "SKILL.md");
+            const dest = path.join(this.projectDir, ".claude", "skills", name, "SKILL.md");
+            if (await fs.pathExists(src)) {
+                await fs.ensureDir(path.dirname(dest));
+                await fs.copy(src, dest);
+            }
+        }
     }
     buildAllowedCommands() {
         const commands = [];
@@ -54,8 +107,8 @@ class ClaudeCodeGenerator extends BaseGenerator {
         return commands;
     }
 }
-export async function generateClaudeCode(projectDir, config, versions) {
-    const generator = new ClaudeCodeGenerator(projectDir, config, versions);
+export async function generateClaudeCode(projectDir, config, versions, globalSkillsBase) {
+    const generator = new ClaudeCodeGenerator(projectDir, config, versions, globalSkillsBase);
     await generator.generate();
 }
 //# sourceMappingURL=index.js.map

package/dist/generators/claude-code/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/claude-code/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/claude-code/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/claude-code/CLAUDE.md.hbs

@@ -18,6 +18,20 @@
 └── README.md
 ```
 
+## Workflow Routing (mandatory)
+
+| Scenario | Action |
+|---|---|
+| New feature / non-trivial change | `/speckit.workflow` |
+| Small fix (1-2 lines, docs-only) | Direct edit, no spec |
+| Bug | Apply `superpowers:systematic-debugging` |
+| UI component | Apply `frontend-design:frontend-design` skill |
+| Commit / PR | Use `commit-commands:commit-push-pr` skill |
+
+## Architecture Constitution
+
+Read `.specify/memory/constitution.md` before any architectural decision. It is auto-loaded at session start.
+
 {{#if springBoot}}
 ## Backend — Spring Boot {{versions.springBoot}}
 
@@ -90,15 +104,6 @@ docker compose down             # Stop services
 - **pgAdmin:** localhost:5050 (admin@admin.com / admin)
 
 {{/if}}
-## Workflow
-
-| Scenario | Action |
-|---|---|
-| New feature | `/speckit.workflow` — routes automatiquement (fast track ou full workflow spec→PR) |
-| Bug | Describe to Claude → apply `superpowers:systematic-debugging` |
-| UI component | Apply `frontend-design:frontend-design` skill |
-| Commit / PR | Use `commit-commands:commit-push-pr` skill |
-
 ## TDD
 
 Write the failing test first — no implementation code before a red test.

package/dist/templates/claude-code/hookify/block-dangerous-rm.local.md

@@ -0,0 +1,11 @@
+---
+name: block-dangerous-rm
+enabled: true
+event: bash
+pattern: rm\s+(-rf|-fr)
+action: block
+---
+
+⚠️ **Commande rm -rf détectée**
+
+Cette commande peut supprimer des fichiers de façon irréversible. Vérifie bien le chemin avant de continuer.

package/dist/templates/claude-code/hookify/block-force-push.local.md

@@ -0,0 +1,11 @@
+---
+name: block-force-push
+enabled: true
+event: bash
+pattern: git\s+push\s+.*--force(?!-with-lease)|git\s+push\s+.*\s-f\b
+action: block
+---
+
+🚫 **git push --force bloqué**
+
+Le force push est interdit sur ce projet. Utilise `--force-with-lease` si tu sais ce que tu fais, ou ouvre une PR à la place.

package/dist/templates/claude-code/hookify/block-no-verify.local.md

@@ -0,0 +1,11 @@
+---
+name: block-no-verify
+enabled: true
+event: bash
+pattern: --no-verify
+action: block
+---
+
+🚫 **--no-verify bloqué**
+
+Le bypass des hooks de commit est interdit. Les tests et le lint doivent passer avant tout commit.

package/dist/templates/claude-code/hookify/stop-verify-tests.local.md.hbs

@@ -0,0 +1,21 @@
+---
+name: stop-verify-tests
+enabled: true
+event: stop
+pattern: .*
+action: warn
+---
+
+⚠️ **Avant de terminer — TDD check**
+
+As-tu :
+- [ ] Lancé les tests et vérifié qu'ils passent ?
+{{#if fastapi}}  - `cd backend && .venv/bin/pytest tests/ -v`
+{{/if}}{{#if springBoot}}  - `cd backend && ./mvnw test`
+{{/if}}{{#if frontend}}  - `cd frontend && npm test -- --watch=false`
+{{/if}}- [ ] Lancé le lint ?
+{{#if fastapi}}  - `cd backend && .venv/bin/ruff check .`
+{{/if}}{{#if springBoot}}  - `cd backend && ./mvnw checkstyle:check` (if configured)
+{{/if}}{{#if frontend}}  - `cd frontend && npm run lint`
+{{/if}}
+Iron law : aucun commit sans tests verts.

package/dist/templates/claude-code/hookify/warn-console-log.local.md

@@ -0,0 +1,11 @@
+---
+name: warn-console-log
+enabled: true
+event: file
+pattern: console\.log\(
+action: warn
+---
+
+⚠️ **console.log detected**
+
+You're about to add a `console.log` statement. Make sure this is intentional and not a debug leftover.

package/dist/templates/claude-code/hookify/warn-env-edit.local.md

@@ -0,0 +1,11 @@
+---
+name: warn-env-edit
+enabled: true
+event: file
+pattern: (^|/)\.env(\.|$)
+action: warn
+---
+
+⚠️ **Fichier .env détecté**
+
+Tu es sur le point de modifier un fichier d'environnement. Assure-toi de ne pas committer de secrets — utilise `.env.example` pour les valeurs de référence.

package/dist/templates/claude-code/hookify/warn-no-test-before-commit.local.md.hbs

@@ -0,0 +1,18 @@
+---
+name: warn-no-test-before-commit
+enabled: true
+event: bash
+pattern: git\s+commit
+action: warn
+---
+
+⚠️ **Commit détecté — tests lancés ?**
+
+Avant de committer, confirme :
+{{#if fastapi}}- [ ] `cd backend && .venv/bin/pytest tests/ -v` → vert
+{{/if}}{{#if springBoot}}- [ ] `cd backend && ./mvnw test` → vert
+{{/if}}{{#if frontend}}- [ ] `cd frontend && npm test -- --watch=false` → vert
+{{/if}}{{#if fastapi}}- [ ] `cd backend && .venv/bin/ruff check .` → propre
+{{/if}}{{#if frontend}}- [ ] `cd frontend && npm run lint` → propre
+{{/if}}
+Iron law : aucun commit sans tests verts.

package/dist/templates/claude-code/hookify/warn-todo-fixme.local.md

@@ -0,0 +1,11 @@
+---
+name: warn-todo-fixme
+enabled: true
+event: file
+pattern: TODO|FIXME
+action: warn
+---
+
+⚠️ **TODO / FIXME détecté**
+
+Tu ajoutes un marqueur TODO ou FIXME. Assure-toi qu'il ne sera pas oublié avant de committer.

package/dist/templates/claude-code/hooks/pre-bash.sh.hbs

@@ -0,0 +1,36 @@
+#!/bin/bash
+# Hook: PreToolUse (Bash) — {{name}} project guards.
+# Exit 2 = block | Exit 0 = allow
+
+COMMAND=$(jq -r '.tool_input.command // ""')
+
+# Strip heredoc bodies so patterns don't match inside commit messages.
+COMMAND_STRIPPED=$(echo "$COMMAND" | awk '
+  /<</ {
+    tmp = $0
+    gsub(/^.*<<'"'"'?/, "", tmp)
+    gsub(/[^A-Za-z_0-9].*$/, "", tmp)
+    delim = tmp
+    in_hd = 1; print; next
+  }
+  in_hd { if ($0 == delim) in_hd = 0; next }
+  { print }
+')
+{{#if frontend}}
+
+# Block: npm install / uninstall outside frontend/
+if echo "$COMMAND_STRIPPED" | grep -qE '(^|[;&|[:space:]])npm[[:space:]]+(install|i|uninstall|un)(\s|$)'; then
+  current_dir=$(pwd)
+  in_frontend=0
+  if echo "$current_dir" | grep -qE '/frontend(/|$)'; then
+    in_frontend=1
+  fi
+  if echo "$COMMAND_STRIPPED" | grep -qE '(^|[;&|[:space:]])cd[[:space:]]+([^;&|]*\/)?frontend([[:space:]]|$|/)'; then
+    in_frontend=1
+  fi
+  if [ "$in_frontend" -eq 0 ]; then
+    echo "BLOCKED: 'npm install' is only allowed inside frontend/. Run: cd frontend && npm install" >&2
+    exit 2
+  fi
+fi
+{{/if}}

package/dist/templates/claude-code/hooks/session-start.sh.hbs

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Hook: SessionStart (once: true) — loads project constitution into context once per session.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null)"
+if [ -z "$REPO_ROOT" ]; then
+  exit 0
+fi
+CONSTITUTION="$REPO_ROOT/.specify/memory/constitution.md"
+
+if [ -f "$CONSTITUTION" ]; then
+  echo "=== {{name}} Architecture Constitution (auto-loaded) ==="
+  cat "$CONSTITUTION"
+  echo "=== End Constitution ==="
+fi

package/dist/templates/claude-code/settings.json.hbs

@@ -2,9 +2,52 @@
   "permissions": {
     "allow": [
 {{#each allowedCommands}}
-      "{{this}}"{{#unless @last}},{{/unless}}
+      "{{this}}",
 {{/each}}
+      "Bash(.specify/scripts/bash/*)",
+      "Bash(git commit*)",
+      "Bash(gh *)",
+      "Skill(commit-commands:commit)",
+      "Skill(commit-commands:commit:*)",
+      "Skill(commit-commands:commit-push-pr)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:resources.anthropic.com)"
+    ]
+  },
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{claudeDir}}/hooks/session-start.sh",
+            "once": true
+          }
+        ]
+      }
     ],
-    "defaultMode": "dontAsk"
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{claudeDir}}/hooks/pre-bash.sh"
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo 'Compaction: KEEP: file diffs, failing test errors, architecture decisions from constitution.md. DROP: passing test output, startup logs, install output, resolved discussions.'"
+          }
+        ]
+      }
+    ]
   }
 }

package/dist/templates/claude-code/specify/constitution.md.hbs

@@ -0,0 +1,31 @@
+# {{name}} — Architecture Constitution
+
+> Auto-loaded at session start via `.claude/hooks/session-start.sh`.
+> Edit this file to document hard architectural constraints for your project.
+
+## Core Principles
+
+### I. [Your first principle]
+
+Describe a non-negotiable architectural rule here. Example: "All data access MUST go through the repository layer. Direct DB queries in controllers are forbidden."
+
+### II. [Your second principle]
+
+...
+
+## Scope
+
+### In Scope
+- [Feature A]
+- [Feature B]
+
+### Out of Scope
+- [Feature C — why excluded]
+
+## Key Decisions
+
+Document architectural decisions here as they are made (or link to DECISIONS.md).
+
+| # | Decision | Rationale |
+|---|----------|-----------|
+| 1 | Example: PostgreSQL over SQLite | Production-grade from day 1 |

package/dist/utils/template-engine.d.ts

@@ -1,3 +1,4 @@
+export declare const TEMPLATES_DIR: string;
 export declare function renderTemplate(templatePath: string, data: Record<string, unknown>): string;
 export declare function renderAndWrite(templatePath: string, outputPath: string, data: Record<string, unknown>, options?: {
     mode?: number;

package/dist/utils/template-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAWA,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAKR;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"template-engine.d.ts","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,aAAa,QAA0C,CAAC;AAIrE,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAKR;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/utils/template-engine.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-const TEMPLATES_DIR = path.join(__dirname, "..", "templates");
+export const TEMPLATES_DIR = path.join(__dirname, "..", "templates");
 Handlebars.registerHelper("lowerCase", (str) => str.toLowerCase());
 export function renderTemplate(templatePath, data) {
     const fullPath = path.join(TEMPLATES_DIR, templatePath);

package/dist/utils/template-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAE9D,UAAU,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AAE3E,MAAM,UAAU,cAAc,CAC5B,YAAoB,EACpB,IAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAoB,EACpB,UAAkB,EAClB,IAA6B,EAC7B,OAA2B;IAE3B,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}
+{"version":3,"file":"template-engine.js","sourceRoot":"","sources":["../../src/utils/template-engine.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAErE,UAAU,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AAE3E,MAAM,UAAU,cAAc,CAC5B,YAAoB,EACpB,IAA6B;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,YAAoB,EACpB,UAAkB,EAClB,IAA6B,EAC7B,OAA2B;IAE3B,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iconsulting-dev/forgekit",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "description": "CLI de scaffolding full-stack pour projets Spring Boot + Angular",
   "type": "module",
   "bin": {