forgecraft-mcp 1.7.0 → 1.8.0

package/dist/tools/contribute-gate.js

@@ -1,5 +1,21 @@
-import { existsSync, readFileSync, writeFileSync } from "fs";
+/**
+ * Gate contribution to the public quality-gates registry.
+ *
+ * Submission mechanism: GitHub issues on jghiringhelli/quality-gates
+ * (there is no ForgeCraft API server — by design).
+ *
+ *   Primary:  `gh issue create` — works when the dev has the GitHub CLI
+ *             installed and authenticated (the common case).
+ *   Fallback: a pre-filled GitHub issue URL written to the pending file —
+ *             one click opens the proposal in the browser, body pre-populated.
+ *
+ * Issue format matches .github/ISSUE_TEMPLATE/quality-gate-proposal.md in
+ * the registry repo (labels: gate-proposal, status:pending-review).
+ */
+import { existsSync, readFileSync, writeFileSync, mkdtempSync, rmSync, } from "fs";
 import { join } from "path";
+import { tmpdir } from "os";
+import { spawnSync } from "child_process";
 import { getContributableGates } from "../shared/project-gates.js";
 /**
  * Validate that a generalizable gate satisfies all five community convergence attributes.
@@ -36,21 +52,18 @@ function validateConvergenceAttributes(gate) {
 }
 const PENDING_CONTRIBUTIONS_FILE = ".forgecraft/pending-contributions.json";
 const SUBMITTED_CONTRIBUTIONS_FILE = ".forgecraft/contributions.json";
-/**
- * Reads the forgecraft.yaml config for contribution settings.
- */
-const DEFAULT_SERVER_URL = "https://api.forgecraft.tools";
+const DEFAULT_REGISTRY_REPO = "jghiringhelli/quality-gates";
+const ISSUE_LABELS = "gate-proposal,status:pending-review";
 function readContributionConfig(projectRoot) {
     const forgecraftPath = join(projectRoot, "forgecraft.yaml");
     if (!existsSync(forgecraftPath)) {
-        return { contributeGates: false, serverUrl: DEFAULT_SERVER_URL };
+        return { contributeGates: false, registryRepo: DEFAULT_REGISTRY_REPO };
     }
     try {
         // Simple parse — avoid importing js-yaml to keep this lightweight
         const raw = readFileSync(forgecraftPath, "utf-8");
         const contributeMatch = raw.match(/contribute_gates:\s*(\S+)/);
-        const serverMatch = raw.match(/server_url:\s*(\S+)/);
-        const apiKeyMatch = raw.match(/api_key:\s*(\S+)/);
+        const repoMatch = raw.match(/registry_repo:\s*(\S+)/);
         const githubMatch = raw.match(/github_user:\s*(\S+)/);
         const val = contributeMatch?.[1];
         const contributeGates = val === "anonymous"
@@ -60,13 +73,12 @@ function readContributionConfig(projectRoot) {
                 : false;
         return {
             contributeGates,
-            serverUrl: serverMatch?.[1] ?? DEFAULT_SERVER_URL,
-            apiKey: apiKeyMatch?.[1],
+            registryRepo: repoMatch?.[1] ?? DEFAULT_REGISTRY_REPO,
             githubUser: githubMatch?.[1],
         };
     }
     catch {
-        return { contributeGates: false, serverUrl: DEFAULT_SERVER_URL };
+        return { contributeGates: false, registryRepo: DEFAULT_REGISTRY_REPO };
     }
 }
 /**
@@ -101,80 +113,182 @@ function recordSubmission(projectRoot, gate) {
     writeFileSync(filePath, JSON.stringify([...existing, gate], null, 2) + "\n", "utf-8");
 }
 /**
- * Submits a gate to the forgecraft-server API or queues it locally.
- *
- * @param gate - The project gate to submit.
- * @param mode - Contribution mode: anonymous or attributed.
- * @param serverUrl - Target API URL.
- * @param githubUser - GitHub username for attributed mode.
- * @param projectType - Optional project type context.
- * @param experimentId - Optional experiment identifier to tag the submission.
- * @returns Submission result with status and optional issue URL.
+ * Build the GitHub issue title for a gate proposal.
+ * Matches the registry's issue template: "[Gate Proposal] <gate-id>".
  */
-async function submitGate(gate, mode, serverUrl, apiKey, githubUser, projectType, experimentId) {
+function buildIssueTitle(gate) {
+    return `[Gate Proposal] ${gate.id}`;
+}
+/**
+ * Build the GitHub issue body matching the registry's
+ * .github/ISSUE_TEMPLATE/quality-gate-proposal.md format.
+ */
+function buildIssueBody(gate, mode, githubUser, experimentId) {
+    const contributor = mode === "attributed" && githubUser ? `@${githubUser}` : "anonymous";
+    const tags = Array.isArray(gate.tags) ? gate.tags.join(" | ") : "UNIVERSAL";
+    return [
+        `## Gate Proposal`,
+        ``,
+        `**Contributor**: ${contributor}`,
+        `**Project type**: ${gate.domain ?? "general"}`,
+        experimentId ? `**Experiment**: ${experimentId}` : ``,
+        ``,
+        `---`,
+        ``,
+        `### Gate Definition`,
+        ``,
+        `**ID**: \`${gate.id}\``,
+        `**Title**: ${gate.title}`,
+        `**Category**: ${gate.domain ?? "other"}`,
+        `**GS Property**: ${gate.gsProperty ?? ""}`,
+        `**Phase**: ${gate.phase ?? "development"}`,
+        `**Hook**: ${gate.hook ?? ""}`,
+        `**Tags**: ${tags}`,
+        ``,
+        `### Description`,
+        gate.description ?? "",
+        ``,
+        `### Check`,
+        "```",
+        gate.check ?? "",
+        "```",
+        ``,
+        `### Pass Criterion`,
+        gate.passCriterion ?? "",
+        ``,
+        `### Evidence`,
+        `> ${(gate.evidence ?? "").replace(/\n/g, "\n> ")}`,
+        ``,
+        `---`,
+        ``,
+        `*Submitted via \`forgecraft-mcp contribute_gate\`. By submitting this proposal,`,
+        `the contributor agrees the gate definition may be published under CC-BY-4.0`,
+        `in the quality-gates registry.*`,
+    ]
+        .filter((line) => line !== undefined)
+        .join("\n");
+}
+/**
+ * Build a pre-filled GitHub "new issue" URL — the no-auth fallback.
+ * One click opens the proposal in the browser with the body pre-populated.
+ * GitHub caps URLs around 8 KB; the body is truncated defensively.
+ */
+function buildFallbackIssueUrl(registryRepo, title, body) {
+    const truncatedBody = body.length > 5500
+        ? body.slice(0, 5500) +
+            "\n\n<!-- truncated — full gate YAML in .forgecraft/gates/active/ -->"
+        : body;
+    const params = new URLSearchParams({
+        title,
+        labels: ISSUE_LABELS,
+        body: truncatedBody,
+    });
+    return `https://github.com/${registryRepo}/issues/new?${params.toString()}`;
+}
+/** Default GhRunner — invokes the real GitHub CLI. Exported for direct testing. */
+export function runGhCli(args) {
+    // Safety net: never create real GitHub issues from a test run.
+    // Tests exercising the success path inject a mock ghRunner instead.
+    if (process.env["VITEST"] || process.env["NODE_ENV"] === "test") {
+        return { ok: false, stdout: "" };
+    }
     try {
-        const headers = {
-            "Content-Type": "application/json",
-        };
-        if (apiKey)
-            headers["Authorization"] = `Bearer ${apiKey}`;
-        const response = await fetch(`${serverUrl}/contribute/gate`, {
-            method: "POST",
-            headers,
-            body: JSON.stringify({
-                gate: {
-                    id: gate.id,
-                    title: gate.title,
-                    description: gate.description,
-                    domain: gate.domain,
-                    gsProperty: gate.gsProperty,
-                    phase: gate.phase,
-                    hook: gate.hook,
-                    check: gate.check,
-                    passCriterion: gate.passCriterion,
-                    tags: gate.tags,
-                    evidence: gate.evidence,
-                    convergenceAttributes: gate.convergenceAttributes,
-                },
-                mode,
-                attribution: mode === "attributed"
-                    ? { github: githubUser, projectType }
-                    : undefined,
-                ...(experimentId ? { experimentId } : {}),
-            }),
-            signal: AbortSignal.timeout(8000),
+        const result = spawnSync("gh", args, {
+            encoding: "utf-8",
+            timeout: 15_000,
+            windowsHide: true,
         });
-        if (!response.ok)
-            return { status: "pending" };
-        const data = (await response.json());
-        return {
-            status: data.status === "submitted" ? "submitted" : "pending",
-            issueUrl: data.issueUrl,
-        };
+        if (result.error || result.status !== 0) {
+            return { ok: false, stdout: result.stdout ?? "" };
+        }
+        return { ok: true, stdout: (result.stdout ?? "").trim() };
+    }
+    catch {
+        return { ok: false, stdout: "" };
+    }
+}
+/**
+ * Submit a gate proposal as a GitHub issue on the registry repo.
+ *
+ * Tries `gh issue create` first (authenticated CLI). On any failure, returns
+ * status "pending" with a pre-filled issue URL the dev can open manually.
+ *
+ * @param gate - The project gate to submit
+ * @param mode - Contribution mode: anonymous or attributed
+ * @param registryRepo - Target repo ("owner/name")
+ * @param githubUser - GitHub username for attributed mode
+ * @param experimentId - Optional experiment identifier
+ * @param ghRunner - Injectable gh CLI runner (tests)
+ * @returns Submission result with status and issue URL
+ */
+function submitGateAsIssue(gate, mode, registryRepo, githubUser, experimentId, ghRunner = runGhCli) {
+    const title = buildIssueTitle(gate);
+    const body = buildIssueBody(gate, mode, githubUser, experimentId);
+    // Primary: gh CLI. --body-file avoids all shell-escaping issues.
+    let bodyDir;
+    try {
+        bodyDir = mkdtempSync(join(tmpdir(), "fc-gate-"));
+        const bodyFile = join(bodyDir, "issue-body.md");
+        writeFileSync(bodyFile, body, "utf-8");
+        const result = ghRunner([
+            "issue",
+            "create",
+            "--repo",
+            registryRepo,
+            "--title",
+            title,
+            "--body-file",
+            bodyFile,
+            "--label",
+            ISSUE_LABELS,
+        ]);
+        if (result.ok) {
+            // gh prints the created issue URL as the last stdout line
+            const url = result.stdout
+                .split("\n")
+                .reverse()
+                .find((l) => l.startsWith("https://"));
+            return { status: "submitted", issueUrl: url };
+        }
     }
     catch {
-        return { status: "pending" };
+        // fall through to URL fallback
+    }
+    finally {
+        if (bodyDir) {
+            try {
+                rmSync(bodyDir, { recursive: true, force: true });
+            }
+            catch {
+                /* temp cleanup is best-effort */
+            }
+        }
     }
+    // Fallback: pre-filled issue URL — dev opens it in the browser.
+    return {
+        status: "pending",
+        issueUrl: buildFallbackIssueUrl(registryRepo, title, body),
+    };
 }
 /**
  * Contributes all generalizable gates from .forgecraft/project-gates.yaml.
  * - Reads contribute_gates setting from forgecraft.yaml
  * - Skips gates already submitted (tracked in .forgecraft/contributions.json)
- * - Calls forgecraft-server API if reachable, otherwise queues locally
- * - Never throws — all failures are recorded as skipped
+ * - Creates a GitHub issue on the registry repo via gh CLI when available,
+ *   otherwise queues a pre-filled issue URL for one-click manual submission
+ * - Never throws — all failures are recorded as skipped or pending
  *
  * @param options - Contribution options including project root and optional overrides.
  * @returns Result containing submitted, skipped gates and optional pending file path.
  */
 export async function contributeGates(options) {
-    const { projectRoot, dryRun = false, experimentId } = options;
+    const { projectRoot, dryRun = false, experimentId, ghRunner } = options;
     const config = readContributionConfig(projectRoot);
     if (!config.contributeGates) {
         return { submitted: [], skipped: [], pendingFile: undefined };
     }
     const mode = config.contributeGates;
-    const serverUrl = options.serverUrl ?? config.serverUrl;
-    const apiKey = options.apiKey ?? config.apiKey;
+    const registryRepo = options.registryRepo ?? config.registryRepo;
     const gates = getContributableGates(projectRoot);
     const alreadySubmitted = getAlreadySubmitted(projectRoot);
     const submitted = [];
@@ -200,12 +314,12 @@ export async function contributeGates(options) {
             submitted.push({ gateId: gate.id, mode, status: "pending" });
             continue;
         }
-        const result = await submitGate(gate, mode, serverUrl, apiKey, config.githubUser, undefined, experimentId);
+        const result = submitGateAsIssue(gate, mode, registryRepo, config.githubUser, experimentId, ghRunner);
         const contributed = { gateId: gate.id, ...result, mode };
         submitted.push(contributed);
         recordSubmission(projectRoot, contributed);
     }
-    // Write pending contributions to file for manual review/retry
+    // Write pending contributions (with their one-click issue URLs) for manual submission
     const pending = submitted.filter((s) => s.status === "pending");
     let pendingFile;
     if (pending.length > 0) {

package/dist/tools/contribute-gate.js.map

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

package/dist/tools/gate-genesis.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Gate genesis — propose new quality gates from observed development friction.
+ *
+ * Two signal sources:
+ *   1. `.forgecraft/gate-violations.jsonl` — the same hook violated repeatedly
+ *      means the team keeps hitting a failure mode worth formalizing.
+ *   2. `.claude/corrections.md` — repeated AI corrections in the same category
+ *      mean an unenforced convention; a gate makes it structural.
+ *
+ * Candidates become DRAFT YAML stubs in `.forgecraft/gates/drafts/` — never
+ * auto-activated (human judgment). When the dev fills in `evidence` and sets
+ * `generalizable: true`, the existing contribute flow takes the gate to the
+ * public registry as a GitHub issue. This completes the community flywheel:
+ * violations → drafts → active gates → registry → installed in other projects.
+ */
+export interface GateCandidate {
+    /** Proposed gate id, e.g. "auto-gate-hardcoded-url". */
+    readonly id: string;
+    readonly source: "violations" | "corrections";
+    /** The hook name or correction category that triggered the proposal. */
+    readonly pattern: string;
+    readonly occurrences: number;
+    /** Up to MAX_EXAMPLES sample messages for the draft's context. */
+    readonly examples: readonly string[];
+}
+/**
+ * Scan violation log + corrections log and return gate candidates for
+ * patterns that repeat above threshold and aren't already covered by an
+ * active or draft gate.
+ *
+ * Never throws — missing or malformed files yield an empty list.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Candidates sorted by occurrence count, highest first
+ */
+export declare function proposeGateCandidates(projectRoot: string): GateCandidate[];
+/**
+ * Write draft gate YAML stubs for the given candidates.
+ * Drafts land in `.forgecraft/gates/drafts/<id>.yaml` — idempotent, never
+ * overwrites, never auto-activates.
+ *
+ * @param projectRoot - Project root directory
+ * @param candidates - Candidates from proposeGateCandidates
+ * @returns Relative paths of draft files written
+ */
+export declare function writeGateDrafts(projectRoot: string, candidates: readonly GateCandidate[]): string[];
+//# sourceMappingURL=gate-genesis.d.ts.map

package/dist/tools/gate-genesis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-genesis.d.ts","sourceRoot":"","sources":["../../src/tools/gate-genesis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmBH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAAC;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AASD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CAO1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,MAAM,EAAE,CAoBV"}

package/dist/tools/gate-genesis.js

@@ -0,0 +1,241 @@
+/**
+ * Gate genesis — propose new quality gates from observed development friction.
+ *
+ * Two signal sources:
+ *   1. `.forgecraft/gate-violations.jsonl` — the same hook violated repeatedly
+ *      means the team keeps hitting a failure mode worth formalizing.
+ *   2. `.claude/corrections.md` — repeated AI corrections in the same category
+ *      mean an unenforced convention; a gate makes it structural.
+ *
+ * Candidates become DRAFT YAML stubs in `.forgecraft/gates/drafts/` — never
+ * auto-activated (human judgment). When the dev fills in `evidence` and sets
+ * `generalizable: true`, the existing contribute flow takes the gate to the
+ * public registry as a GitHub issue. This completes the community flywheel:
+ * violations → drafts → active gates → registry → installed in other projects.
+ */
+import { existsSync, readFileSync, readdirSync, writeFileSync, mkdirSync, } from "fs";
+import { join } from "path";
+import { dump as yamlDump } from "js-yaml";
+/** Minimum repeats before a violation pattern becomes a candidate. */
+const VIOLATION_THRESHOLD = 3;
+/** Minimum repeats before a correction category becomes a candidate. */
+const CORRECTION_THRESHOLD = 2;
+/** Max sample messages carried into the draft for context. */
+const MAX_EXAMPLES = 3;
+/**
+ * Scan violation log + corrections log and return gate candidates for
+ * patterns that repeat above threshold and aren't already covered by an
+ * active or draft gate.
+ *
+ * Never throws — missing or malformed files yield an empty list.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Candidates sorted by occurrence count, highest first
+ */
+export function proposeGateCandidates(projectRoot) {
+    const covered = collectCoveredPatterns(projectRoot);
+    const candidates = [
+        ...candidatesFromViolations(projectRoot, covered),
+        ...candidatesFromCorrections(projectRoot, covered),
+    ];
+    return candidates.sort((a, b) => b.occurrences - a.occurrences);
+}
+/**
+ * Write draft gate YAML stubs for the given candidates.
+ * Drafts land in `.forgecraft/gates/drafts/<id>.yaml` — idempotent, never
+ * overwrites, never auto-activates.
+ *
+ * @param projectRoot - Project root directory
+ * @param candidates - Candidates from proposeGateCandidates
+ * @returns Relative paths of draft files written
+ */
+export function writeGateDrafts(projectRoot, candidates) {
+    const written = [];
+    if (candidates.length === 0)
+        return written;
+    const draftsDir = join(projectRoot, ".forgecraft", "gates", "drafts");
+    for (const candidate of candidates) {
+        const filePath = join(draftsDir, `${candidate.id}.yaml`);
+        if (existsSync(filePath))
+            continue;
+        try {
+            mkdirSync(draftsDir, { recursive: true });
+            writeFileSync(filePath, buildDraftYaml(candidate), "utf-8");
+            written.push(`.forgecraft/gates/drafts/${candidate.id}.yaml`);
+        }
+        catch {
+            // Single draft failure is non-fatal
+        }
+    }
+    return written;
+}
+// ── Signal extraction ─────────────────────────────────────────────────
+function candidatesFromViolations(projectRoot, covered) {
+    const filePath = join(projectRoot, ".forgecraft", "gate-violations.jsonl");
+    if (!existsSync(filePath))
+        return [];
+    const byHook = new Map();
+    try {
+        for (const line of readFileSync(filePath, "utf-8").split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let entry;
+            try {
+                entry = JSON.parse(trimmed);
+            }
+            catch {
+                continue; // skip malformed lines
+            }
+            if (!entry.hook)
+                continue;
+            const messages = byHook.get(entry.hook) ?? [];
+            messages.push(entry.message ?? "");
+            byHook.set(entry.hook, messages);
+        }
+    }
+    catch {
+        return [];
+    }
+    const candidates = [];
+    for (const [hook, messages] of byHook) {
+        if (messages.length < VIOLATION_THRESHOLD)
+            continue;
+        const pattern = normalizePattern(hook);
+        if (covered.has(pattern))
+            continue;
+        candidates.push({
+            id: `auto-gate-${pattern}`,
+            source: "violations",
+            pattern: hook,
+            occurrences: messages.length,
+            examples: dedupe(messages).slice(0, MAX_EXAMPLES),
+        });
+    }
+    return candidates;
+}
+function candidatesFromCorrections(projectRoot, covered) {
+    const filePath = join(projectRoot, ".claude", "corrections.md");
+    if (!existsSync(filePath))
+        return [];
+    // Entry format: YYYY-MM-DD | [category] description
+    const entryPattern = /^\d{4}-\d{2}-\d{2}\s*\|\s*\[([^\]]+)\]\s*(.+)$/;
+    const byCategory = new Map();
+    try {
+        let inComment = false;
+        for (const line of readFileSync(filePath, "utf-8").split("\n")) {
+            // Skip the commented-out examples in the stub
+            if (line.includes("<!--"))
+                inComment = true;
+            if (inComment) {
+                if (line.includes("-->"))
+                    inComment = false;
+                continue;
+            }
+            const match = entryPattern.exec(line.trim());
+            if (!match)
+                continue;
+            const category = match[1].trim().toLowerCase();
+            const entries = byCategory.get(category) ?? [];
+            entries.push(match[2].trim());
+            byCategory.set(category, entries);
+        }
+    }
+    catch {
+        return [];
+    }
+    const candidates = [];
+    for (const [category, entries] of byCategory) {
+        if (entries.length < CORRECTION_THRESHOLD)
+            continue;
+        const pattern = normalizePattern(category);
+        if (covered.has(pattern))
+            continue;
+        candidates.push({
+            id: `auto-gate-${pattern}`,
+            source: "corrections",
+            pattern: category,
+            occurrences: entries.length,
+            examples: dedupe(entries).slice(0, MAX_EXAMPLES),
+        });
+    }
+    return candidates;
+}
+// ── Coverage check ────────────────────────────────────────────────────
+/**
+ * Patterns already covered by an active or draft gate — don't re-propose.
+ * A gate covers a pattern when its id or hook field contains the normalized
+ * pattern string.
+ */
+function collectCoveredPatterns(projectRoot) {
+    const covered = new Set();
+    for (const subdir of ["active", "drafts"]) {
+        const dir = join(projectRoot, ".forgecraft", "gates", subdir);
+        if (!existsSync(dir))
+            continue;
+        try {
+            for (const file of readdirSync(dir)) {
+                if (!file.endsWith(".yaml") && !file.endsWith(".yml"))
+                    continue;
+                // Gate id from filename: auto-gate-<pattern>.yaml or <pattern>.yaml
+                const base = file.replace(/\.(yaml|yml)$/, "");
+                covered.add(normalizePattern(base.replace(/^auto-gate-/, "")));
+                covered.add(normalizePattern(base));
+            }
+        }
+        catch {
+            // Unreadable dir — treat as no coverage
+        }
+    }
+    return covered;
+}
+// ── Draft rendering ───────────────────────────────────────────────────
+function buildDraftYaml(candidate) {
+    const header = [
+        `# DRAFT gate — generated by gate genesis from repeated ${candidate.source}.`,
+        `# Pattern "${candidate.pattern}" occurred ${candidate.occurrences} times.`,
+        `#`,
+        `# To activate: fill in the FILL fields, move this file to`,
+        `# .forgecraft/gates/active/, and set generalizable: true if the gate`,
+        `# would help other projects (close_cycle will then propose it to the`,
+        `# community registry as a GitHub issue).`,
+        ``,
+    ].join("\n");
+    const body = yamlDump({
+        id: candidate.id,
+        title: `<FILL: human-readable title for the ${candidate.pattern} gate>`,
+        description: `Formalizes a repeated ${candidate.source === "violations" ? "hook violation" : "AI correction"}: ${candidate.pattern}`,
+        domain: "<FILL: security | test-quality | api-contract | environment-hygiene | other>",
+        gsProperty: "defended",
+        phase: "development",
+        hook: candidate.source === "violations" ? candidate.pattern : "pre-commit",
+        check: "<FILL: executable step-by-step check — no interpretation required>",
+        passCriterion: "<FILL: binary pass statement>",
+        implementation: "logic",
+        source: "project",
+        status: "draft",
+        // Provenance: "genesis" = the system detected the need from repeated
+        // friction. AI/dev-created gates use "organic" (see Gate Awareness in
+        // .claude/lifecycle.md). Tracked so the registry can distinguish gates
+        // born from observed failure vs. proactive judgment.
+        origin: "genesis",
+        detectedFrom: candidate.source,
+        generalizable: false,
+        evidence: `Observed ${candidate.occurrences}x in this project. Examples: ${candidate.examples.join(" | ")}`,
+        observedExamples: [...candidate.examples],
+    }, { lineWidth: 100, noRefs: true });
+    return header + body;
+}
+// ── Utilities ─────────────────────────────────────────────────────────
+function normalizePattern(raw) {
+    return raw
+        .toLowerCase()
+        .replace(/^pre-commit-|^pre-push-|^post-commit-/, "")
+        .replace(/\.sh$/, "")
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function dedupe(items) {
+    return [...new Set(items.filter((m) => m.trim()))];
+}
+//# sourceMappingURL=gate-genesis.js.map