forgecraft-mcp 1.4.0 → 1.7.0

package/dist/shared/gs-score-logger.js

@@ -11,12 +11,12 @@ import { appendFileSync, existsSync, mkdirSync, writeFileSync } from "fs";
 import { join } from "path";
 // ── Constants ────────────────────────────────────────────────────────
 const GS_SCORE_FILE = "docs/gs-score.md";
-const GS_SCORE_HEADER = `# GS Score Log
-
-Tracks S_realized and GS property scores per loop.
-
-| date | loop | roadmap_item | s_realized | self-describing | bounded | verifiable | defended | auditable | composable | executable |
-|------|------|--------------|------------|-----------------|---------|-----------|----------|-----------|-----------|-----------|
+const GS_SCORE_HEADER = `# GS Score Log
+
+Tracks S_realized and GS property scores per loop.
+
+| date | loop | roadmap_item | s_realized | self-describing | bounded | verifiable | defended | auditable | composable | executable |
+|------|------|--------------|------------|-----------------|---------|-----------|----------|-----------|-----------|-----------|
 `;
 const GS_PROPERTY_ORDER = [
     "self-describing",

package/dist/shared/hook-installer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Git hook installation and audit utilities.
+ *
+ * Architecture: manifest-driven dispatchers.
+ *
+ *   .git/hooks/<type>       — generic dispatcher, installed once, never changes.
+ *                             Reads the ordered list from .claude/hooks/<type>.list
+ *                             and runs each script in sequence.
+ *
+ *   .claude/hooks/<type>.list — versioned manifest, one script filename per line.
+ *                              add_hook appends here; no re-scaffold needed.
+ *
+ *   .claude/hooks/*.sh      — the actual check scripts.
+ *
+ * Public API:
+ *   auditHookInstallation   — synchronous audit of installation state.
+ *   installGitHooks         — write dispatchers + default manifests.
+ *   appendToHookManifest    — append a script to a manifest (used by add_hook).
+ */
+export interface HookInstallationResult {
+    readonly hasHookSource: boolean;
+    readonly sourceHookCount: number;
+    readonly installedGitHooks: string[];
+    readonly missingGitHooks: string[];
+    readonly allInstalled: boolean;
+    readonly issues: string[];
+}
+export interface HookInstallResult {
+    readonly installed: string[];
+    readonly skipped: string[];
+    readonly notAGitRepo: boolean;
+}
+export declare function auditHookInstallation(projectDir: string): HookInstallationResult;
+/**
+ * Append a script filename to the manifest for a given hook type.
+ * Idempotent — skips if the script is already listed.
+ * Creates the manifest file if it does not exist.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param hookType   - Git hook type (e.g. "pre-commit", "commit-msg")
+ * @param scriptName - Filename to append (e.g. "pre-commit-i18n.sh")
+ * @returns true if appended, false if already present
+ */
+export declare function appendToHookManifest(projectDir: string, hookType: string, scriptName: string): boolean;
+/**
+ * Write .git/hooks/* manifest-driven dispatcher scripts and default
+ * .claude/hooks/<type>.list manifest files.
+ *
+ * Dispatchers: installed once, never need to change again.
+ * Manifests: versioned in .claude/hooks/, updated by add_hook.
+ *
+ * Skips existing hooks/manifests unless force=true.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param force - Overwrite existing git hooks and manifests (default false)
+ */
+export declare function installGitHooks(projectDir: string, force?: boolean): HookInstallResult;
+//# sourceMappingURL=hook-installer.d.ts.map

package/dist/shared/hook-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-installer.d.ts","sourceRoot":"","sources":["../../src/shared/hook-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAcH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAyCD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,sBAAsB,CAmDxB;AA0CD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAyBT;AAwGD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,UAAQ,GACZ,iBAAiB,CA6CnB"}

package/dist/shared/hook-installer.js

@@ -0,0 +1,316 @@
+/**
+ * Git hook installation and audit utilities.
+ *
+ * Architecture: manifest-driven dispatchers.
+ *
+ *   .git/hooks/<type>       — generic dispatcher, installed once, never changes.
+ *                             Reads the ordered list from .claude/hooks/<type>.list
+ *                             and runs each script in sequence.
+ *
+ *   .claude/hooks/<type>.list — versioned manifest, one script filename per line.
+ *                              add_hook appends here; no re-scaffold needed.
+ *
+ *   .claude/hooks/*.sh      — the actual check scripts.
+ *
+ * Public API:
+ *   auditHookInstallation   — synchronous audit of installation state.
+ *   installGitHooks         — write dispatchers + default manifests.
+ *   appendToHookManifest    — append a script to a manifest (used by add_hook).
+ */
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, chmodSync, } from "node:fs";
+import { join } from "node:path";
+// ── Constants ─────────────────────────────────────────────────────────
+const EXPECTED_GIT_HOOKS = [
+    "pre-commit",
+    "commit-msg",
+    "post-commit",
+    "prepare-commit-msg",
+    "pre-push",
+];
+/** Default ordered scripts per hook type. Only scripts that exist are run. */
+const DEFAULT_MANIFEST = {
+    "pre-commit": [
+        "pre-commit-no-temp-files.sh",
+        "pre-commit-secrets.sh",
+        "pre-commit-prod-quality.sh",
+        "pre-commit-branch-check.sh",
+        "pre-commit-format.sh",
+        "pre-commit-compile.sh",
+        "pre-commit-import-cycles.sh",
+        "pre-commit-tdd-check.sh",
+        "pre-commit-test.sh",
+        "pre-commit-coverage.sh",
+        "pre-commit-audit.sh",
+        "pre-commit-doc-cascade.sh",
+    ],
+    "commit-msg": ["commit-msg.sh", "commit-msg-cascade.sh"],
+    "post-commit": [
+        "post-commit-changelog.sh",
+        "post-commit-complexity-baseline.sh",
+    ],
+    "prepare-commit-msg": ["prepare-commit-msg-usecase.sh"],
+    "pre-push": [],
+};
+// ── Audit ─────────────────────────────────────────────────────────────
+export function auditHookInstallation(projectDir) {
+    const hooksSourceDir = join(projectDir, ".claude", "hooks");
+    const gitHooksDir = join(projectDir, ".git", "hooks");
+    const hasHookSource = existsSync(hooksSourceDir);
+    let sourceHookCount = 0;
+    if (hasHookSource) {
+        try {
+            sourceHookCount = readdirSync(hooksSourceDir).filter((f) => f.endsWith(".sh")).length;
+        }
+        catch {
+            sourceHookCount = 0;
+        }
+    }
+    const isGitRepo = existsSync(join(projectDir, ".git"));
+    const installedGitHooks = [];
+    const missingGitHooks = [];
+    if (isGitRepo) {
+        for (const hookType of EXPECTED_GIT_HOOKS) {
+            if (existsSync(join(gitHooksDir, hookType))) {
+                installedGitHooks.push(hookType);
+            }
+            else {
+                missingGitHooks.push(hookType);
+            }
+        }
+    }
+    const issues = [];
+    if (!hasHookSource || sourceHookCount === 0) {
+        issues.push(".claude/hooks/ missing or empty — run forgecraft scaffold first");
+    }
+    else if (!isGitRepo) {
+        issues.push("Not a git repository — hook installation requires git init");
+    }
+    else if (missingGitHooks.length > 0) {
+        issues.push(`Git hooks not installed (${missingGitHooks.join(", ")}) — run: bash scripts/setup-hooks.sh`);
+    }
+    return {
+        hasHookSource,
+        sourceHookCount,
+        installedGitHooks,
+        missingGitHooks,
+        allInstalled: isGitRepo && missingGitHooks.length === 0 && hasHookSource,
+        issues,
+    };
+}
+// ── Manifest helpers ──────────────────────────────────────────────────
+function manifestPath(projectDir, hookType) {
+    return join(projectDir, ".claude", "hooks", `${hookType}.list`);
+}
+function buildManifestContent(hookType, scripts) {
+    return [
+        `# ForgeCraft hook manifest — ${hookType}`,
+        `# One script filename per line. Comments (#) and blank lines are ignored.`,
+        `# Add hooks: forgecraft add_hook — scripts are appended here automatically.`,
+        `# Reorder lines to change execution sequence.`,
+        ``,
+        ...scripts,
+        ``,
+    ].join("\n");
+}
+/**
+ * Write default manifest files to .claude/hooks/<type>.list.
+ * Skips existing manifests unless force=true — preserves user customizations.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param force - Overwrite existing manifest files (default false)
+ */
+function writeHookManifests(projectDir, force = false) {
+    const hooksDir = join(projectDir, ".claude", "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    for (const hookType of EXPECTED_GIT_HOOKS) {
+        const path = manifestPath(projectDir, hookType);
+        if (existsSync(path) && !force)
+            continue;
+        writeFileSync(path, buildManifestContent(hookType, DEFAULT_MANIFEST[hookType]), "utf-8");
+    }
+}
+/**
+ * Append a script filename to the manifest for a given hook type.
+ * Idempotent — skips if the script is already listed.
+ * Creates the manifest file if it does not exist.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param hookType   - Git hook type (e.g. "pre-commit", "commit-msg")
+ * @param scriptName - Filename to append (e.g. "pre-commit-i18n.sh")
+ * @returns true if appended, false if already present
+ */
+export function appendToHookManifest(projectDir, hookType, scriptName) {
+    const path = manifestPath(projectDir, hookType);
+    let existing = "";
+    if (existsSync(path)) {
+        existing = readFileSync(path, "utf-8");
+    }
+    else {
+        // Create fresh manifest for this hook type
+        const defaults = DEFAULT_MANIFEST[hookType] ?? [];
+        existing = buildManifestContent(hookType, defaults);
+    }
+    // Idempotency check — scan non-comment lines
+    const alreadyListed = existing
+        .split("\n")
+        .some((l) => l.trim() === scriptName);
+    if (alreadyListed)
+        return false;
+    // Append before trailing blank line if present, otherwise just append
+    const trimmed = existing.trimEnd();
+    const updated = `${trimmed}\n${scriptName}\n`;
+    mkdirSync(join(projectDir, ".claude", "hooks"), { recursive: true });
+    writeFileSync(path, updated, "utf-8");
+    return true;
+}
+// ── Dispatcher content builders ───────────────────────────────────────
+/**
+ * Generic manifest-reading dispatcher for fail-fast hooks (pre-commit, commit-msg, prepare-commit-msg).
+ * If the script fails (non-zero exit), the hook chain aborts immediately.
+ *
+ * @param hookType   - Hook type (used to locate <hookType>.list)
+ * @param passArgs   - Extra args to forward to each script (e.g. "$1" for commit-msg)
+ */
+function buildManifestDispatcher(hookType, passArgs = "") {
+    const argSuffix = passArgs ? ` ${passArgs}` : "";
+    return [
+        "#!/bin/bash",
+        `# Auto-generated by ForgeCraft — do not edit by hand.`,
+        `# To add a hook: run \`forgecraft add_hook\` or append to .claude/hooks/${hookType}.list`,
+        `HOOKS_DIR="$(git rev-parse --show-toplevel)/.claude/hooks"`,
+        `LIST="$HOOKS_DIR/${hookType}.list"`,
+        "",
+        '[ -f "$LIST" ] || exit 0',
+        'while IFS= read -r hook || [ -n "$hook" ]; do',
+        '  [[ -z "$hook" || "$hook" == \\#* ]] && continue',
+        '  script="$HOOKS_DIR/$hook"',
+        '  [ -f "$script" ] || continue',
+        `  bash "$script"${argSuffix}`,
+        "  rc=$?",
+        "  if [ $rc -ne 0 ]; then",
+        '    echo "❌ Hook failed: $hook (exit $rc)"',
+        "    exit $rc",
+        "  fi",
+        'done < "$LIST"',
+        "exit 0",
+    ].join("\n");
+}
+/**
+ * Generic manifest-reading dispatcher for fire-and-forget hooks (post-commit).
+ * Script failures are ignored — hook chain always continues.
+ */
+function buildPostCommitDispatcher() {
+    return [
+        "#!/bin/bash",
+        "# Auto-generated by ForgeCraft — do not edit by hand.",
+        "# To add a hook: run `forgecraft add_hook` or append to .claude/hooks/post-commit.list",
+        `HOOKS_DIR="$(git rev-parse --show-toplevel)/.claude/hooks"`,
+        `LIST="$HOOKS_DIR/post-commit.list"`,
+        "",
+        '[ -f "$LIST" ] || exit 0',
+        'while IFS= read -r hook || [ -n "$hook" ]; do',
+        '  [[ -z "$hook" || "$hook" == \\#* ]] && continue',
+        '  script="$HOOKS_DIR/$hook"',
+        '  [ -f "$script" ] && bash "$script"',
+        'done < "$LIST"',
+        "exit 0",
+    ].join("\n");
+}
+/**
+ * Pre-push dispatcher: built-in main/master deletion guard + manifest hooks.
+ * stdin is captured once so it can be re-fed to each manifest hook.
+ */
+function buildPrePushDispatcher() {
+    return [
+        "#!/bin/bash",
+        "# Auto-generated by ForgeCraft — do not edit by hand.",
+        "# To add a hook: run `forgecraft add_hook` or append to .claude/hooks/pre-push.list",
+        `HOOKS_DIR="$(git rev-parse --show-toplevel)/.claude/hooks"`,
+        `LIST="$HOOKS_DIR/pre-push.list"`,
+        "",
+        "# Capture stdin so we can re-feed it to each hook",
+        "stdin_content=$(cat)",
+        "",
+        "# Built-in guard: block deletion of main/master on the remote",
+        "while IFS= read -r line; do",
+        "  local_sha=$(echo \"$line\" | awk '{print $2}')",
+        "  remote_ref=$(echo \"$line\" | awk '{print $3}')",
+        '  if [ "$local_sha" = "0000000000000000000000000000000000000000" ]; then',
+        "    if echo \"$remote_ref\" | grep -qE '/(main|master)$'; then",
+        '      echo "❌ Deleting remote main/master branch is blocked."',
+        "      exit 1",
+        "    fi",
+        "  fi",
+        'done <<< "$stdin_content"',
+        "",
+        "# Manifest hooks — stdin is piped in from the captured content",
+        '[ -f "$LIST" ] || exit 0',
+        'while IFS= read -r hook || [ -n "$hook" ]; do',
+        '  [[ -z "$hook" || "$hook" == \\#* ]] && continue',
+        '  script="$HOOKS_DIR/$hook"',
+        '  [ -f "$script" ] || continue',
+        '  echo "$stdin_content" | bash "$script"',
+        "  rc=$?",
+        "  if [ $rc -ne 0 ]; then",
+        '    echo "❌ Hook failed: $hook (exit $rc)"',
+        "    exit $rc",
+        "  fi",
+        'done < "$LIST"',
+        "exit 0",
+    ].join("\n");
+}
+// ── Installer ─────────────────────────────────────────────────────────
+/**
+ * Write .git/hooks/* manifest-driven dispatcher scripts and default
+ * .claude/hooks/<type>.list manifest files.
+ *
+ * Dispatchers: installed once, never need to change again.
+ * Manifests: versioned in .claude/hooks/, updated by add_hook.
+ *
+ * Skips existing hooks/manifests unless force=true.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param force - Overwrite existing git hooks and manifests (default false)
+ */
+export function installGitHooks(projectDir, force = false) {
+    const gitDir = join(projectDir, ".git");
+    if (!existsSync(gitDir)) {
+        return { installed: [], skipped: [], notAGitRepo: true };
+    }
+    const gitHooksDir = join(gitDir, "hooks");
+    mkdirSync(gitHooksDir, { recursive: true });
+    const hooks = [
+        { name: "pre-commit", content: buildManifestDispatcher("pre-commit") },
+        {
+            name: "commit-msg",
+            content: buildManifestDispatcher("commit-msg", '"$1"'),
+        },
+        { name: "post-commit", content: buildPostCommitDispatcher() },
+        {
+            name: "prepare-commit-msg",
+            content: buildManifestDispatcher("prepare-commit-msg", '"$1" "$2"'),
+        },
+        { name: "pre-push", content: buildPrePushDispatcher() },
+    ];
+    const installed = [];
+    const skipped = [];
+    for (const { name, content } of hooks) {
+        const hookPath = join(gitHooksDir, name);
+        if (existsSync(hookPath) && !force) {
+            skipped.push(name);
+            continue;
+        }
+        writeFileSync(hookPath, content, "utf-8");
+        try {
+            chmodSync(hookPath, 0o755);
+        }
+        catch {
+            /* non-fatal on Windows */
+        }
+        installed.push(name);
+    }
+    // Write default manifests — skips existing unless force=true
+    writeHookManifests(projectDir, force);
+    return { installed, skipped, notAGitRepo: false };
+}
+//# sourceMappingURL=hook-installer.js.map

package/dist/shared/hook-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-installer.js","sourceRoot":"","sources":["../../src/shared/hook-installer.ts"],"names":[],"mappings":"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"}

package/dist/shared/project-gates-helpers.d.ts

@@ -3,6 +3,7 @@
  * Exports pure utilities and low-level I/O used by the public gate API.
  */
 import type { ProjectGate, ProjectGatesFile, ToolRequirement } from "./types.js";
+import type { DeploymentEnvironmentConfig } from "./types/project.js";
 export declare const FLAT_FILE = ".forgecraft/project-gates.yaml";
 export declare const GATES_BASE = ".forgecraft/gates";
 export declare const PROJECT_ACTIVE = ".forgecraft/gates/project/active";
@@ -56,4 +57,12 @@ export declare function validateGate(gate: Partial<ProjectGate>): string[];
  * @returns Array of ToolRequirements to use for this gate in this project
  */
 export declare function resolveToolsForLanguage(gate: ProjectGate, language: string): readonly ToolRequirement[];
+/**
+ * Returns gate IDs that should be activated based on environment class properties.
+ * Called by audit and generate_session_prompt to inject environment-driven gates.
+ *
+ * @param environments - Record of environment name → config from forgecraft.yaml
+ * @returns Array of gate IDs that apply given the declared environment properties
+ */
+export declare function getEnvironmentActivatedGateIds(environments: Record<string, DeploymentEnvironmentConfig>): readonly string[];
 //# sourceMappingURL=project-gates-helpers.d.ts.map

package/dist/shared/project-gates-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-gates-helpers.d.ts","sourceRoot":"","sources":["../../src/shared/project-gates-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,SAAS,mCAAmC,CAAC;AAC1D,eAAO,MAAM,UAAU,sBAAsB,CAAC;AAC9C,eAAO,MAAM,cAAc,qCAAiC,CAAC;AAC7D,eAAO,MAAM,gBAAgB,uCAAmC,CAAC;AACjE,eAAO,MAAM,eAAe,sCAAkC,CAAC;AAC/D,eAAO,MAAM,aAAa,+BAA2B,CAAC;AAEtD,eAAO,MAAM,gBAAgB,EAAE,gBAG9B,CAAC;AAIF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAavE;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAUjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAM/D;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAa5E;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE,CAejE;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,GACf,SAAS,eAAe,EAAE,CAc5B"}
+{"version":3,"file":"project-gates-helpers.d.ts","sourceRoot":"","sources":["../../src/shared/project-gates-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAItE,eAAO,MAAM,SAAS,mCAAmC,CAAC;AAC1D,eAAO,MAAM,UAAU,sBAAsB,CAAC;AAC9C,eAAO,MAAM,cAAc,qCAAiC,CAAC;AAC7D,eAAO,MAAM,gBAAgB,uCAAmC,CAAC;AACjE,eAAO,MAAM,eAAe,sCAAkC,CAAC;AAC/D,eAAO,MAAM,aAAa,+BAA2B,CAAC;AAEtD,eAAO,MAAM,gBAAgB,EAAE,gBAG9B,CAAC;AAIF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAavE;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAUjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAM/D;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAa5E;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE,CAejE;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,GACf,SAAS,eAAe,EAAE,CAc5B;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,GACxD,SAAS,MAAM,EAAE,CA6BnB"}

package/dist/shared/project-gates-helpers.js

@@ -147,4 +147,39 @@ export function resolveToolsForLanguage(gate, language) {
     }
     return gate.tools ?? [];
 }
+/**
+ * Returns gate IDs that should be activated based on environment class properties.
+ * Called by audit and generate_session_prompt to inject environment-driven gates.
+ *
+ * @param environments - Record of environment name → config from forgecraft.yaml
+ * @returns Array of gate IDs that apply given the declared environment properties
+ */
+export function getEnvironmentActivatedGateIds(environments) {
+    const activated = new Set();
+    for (const env of Object.values(environments)) {
+        if (env.class === "lte" || env.ephemeral === true) {
+            activated.add("lte-ephemeral-infra");
+            activated.add("lte-anonymized-data");
+        }
+        if (env.class === "cae" || env.class === "prd") {
+            activated.add("no-cross-tier-urls");
+        }
+        if (env.class === "cae") {
+            activated.add("cae-version-parity");
+        }
+        if (env.underChangeControl === true || env.class === "prd") {
+            activated.add("prd-change-control");
+        }
+        if (env.containsPii === true) {
+            activated.add("no-cross-tier-urls");
+        }
+        if (env.smtpRelay === "prod" &&
+            env.class !== "cae" &&
+            env.class !== "prd") {
+            // prod relay used in a non-prod environment — flag it
+            activated.add("no-prod-relay-in-nonprod");
+        }
+    }
+    return Array.from(activated);
+}
 //# sourceMappingURL=project-gates-helpers.js.map

package/dist/shared/project-gates-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-gates-helpers.js","sourceRoot":"","sources":["../../src/shared/project-gates-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-gates-helpers.js","sourceRoot":"","sources":["../../src/shared/project-gates-helpers.ts"],"names":[],"mappings":"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"}

package/dist/shared/types/config.d.ts

@@ -48,6 +48,12 @@ export interface ForgeCraftConfig {
     readonly disabledHooks?: string[];
     /** Additional tags beyond auto-detected ones. */
     readonly additionalTags?: Tag[];
+    /**
+     * Practitioner experience level. Controls verbosity of generated session prompts.
+     * - `novice` (default): full methodology explanations, step-by-step instructions
+     * - `experienced`: compact output — just commit sequence and test command; no methodology teaching
+     */
+    readonly practitioner_level?: "novice" | "experienced";
     /**
      * When true, apply compact post-processing to all generated instruction files:
      * strips explanatory tail clauses from bullet points and deduplicates identical lines.
@@ -66,7 +72,7 @@ export interface ForgeCraftConfig {
     readonly deployment?: ProjectDeploymentConfig;
     /** If true, gates marked generalizable: true are queued for community contribution. */
     readonly contribute_gates?: boolean;
-    /** URL for the remote quality-gates registry. Defaults to the public genspec-dev registry. */
+    /** URL for the remote quality-gates registry. Defaults to the public quality-gates registry. */
     readonly gates_registry_url?: string;
     /** URL for the forgecraft-server API. Used by contribute-gate tool. */
     readonly server_url?: string;

package/dist/shared/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/shared/types/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/shared/types/config.ts"],"names":[],"mappings":"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"}

package/dist/shared/types/gates.d.ts

@@ -69,6 +69,26 @@ export interface ToolRequirement {
     /** If false, gate can run without this tool at reduced coverage */
     readonly required: boolean;
 }
+/**
+ * How a quality gate applies at a specific GS abstraction layer.
+ * Mirrors the MCP tool description model: tells the AI when to activate this
+ * gate and what it contributes to that layer's completeness.
+ */
+export interface GateLayerApplication {
+    /** GS abstraction layer. L1=Blueprint, L2=Harness, L3=Environment, L4=Monitoring */
+    readonly layer: "L1" | "L2" | "L3" | "L4";
+    /**
+     * How this gate applies at this layer — the enforcement mechanism.
+     * What it contributes to the layer's completeness when it passes.
+     * What it reveals as a gap when it fires.
+     */
+    readonly description: string;
+    /**
+     * Trigger condition at this layer — when the gate becomes relevant.
+     * What must be true for this gate to fire or be meaningful here.
+     */
+    readonly when: string;
+}
 /**
  * A quality gate -- a named, evidence-backed check that defends a GS property.
  * Gates live in .forgecraft/gates/project/active|promoted|retired/ or .forgecraft/gates/registry/{tag}/.
@@ -88,6 +108,14 @@ export interface ProjectGate {
      * "environment-hygiene", "state-machine", "concurrency"
      */
     readonly domain: string;
+    /**
+     * GS abstraction layers this gate applies to, with per-layer context.
+     * Absent means the gate is layer-agnostic.
+     * Like MCP tool descriptions: tells the AI when and how to use this gate
+     * at each layer of the automation ladder (L1 Blueprint → L2 Harness →
+     * L3 Environment → L4 Monitoring).
+     */
+    readonly layers?: readonly GateLayerApplication[];
     /**
      * How this gate is implemented:
      * - logic: pure invariant check, no external tools
@@ -160,6 +188,12 @@ export interface ProjectGate {
      * P0: blocking (fail = no deploy), P1: warning (fail = PR comment), P2: advisory
      */
     readonly priority?: "P0" | "P1" | "P2";
+    /**
+     * Project-level severity override. Controls how audit surfaces this gate.
+     * error: blocks; warning: advisory; info: informational only.
+     * When absent, severity is derived from priority (P0→error, P1→warning, P2→info).
+     */
+    readonly severity?: "error" | "warning" | "info";
     /** Minimum tool/framework versions this gate requires. e.g. { "react": "18.0.0" } */
     readonly minVersion?: Readonly<Record<string, string>>;
     /** Maximum tool/framework versions this gate applies to (gate obsolete after this) */

package/dist/shared/types/gates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../../src/shared/types/gates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../../src/shared/types/gates.ts"],"names":[],"mappings":"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"}