forgecraft-mcp 1.2.0 → 1.4.0

package/dist/tools/scaffold-spec-stubs.js

@@ -7,20 +7,20 @@
  */
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
-export const USE_CASES_STUB = `<!-- UNFILLED: Use Cases -->
-# Use Cases
-
-## UC-01: [Name]
-**Actor**: <!-- FILL: who? -->
-**Precondition**: <!-- FILL: what must be true before? -->
-**Steps**: <!-- FILL: numbered steps -->
-**Success**: <!-- FILL: what changed? -->
-
-## UC-02: [Name]
-<!-- FILL -->
-
-## UC-03: [Name]
-<!-- FILL -->
+export const USE_CASES_STUB = `<!-- UNFILLED: Use Cases -->
+# Use Cases
+
+## UC-01: [Name]
+**Actor**: <!-- FILL: who? -->
+**Precondition**: <!-- FILL: what must be true before? -->
+**Steps**: <!-- FILL: numbered steps -->
+**Success**: <!-- FILL: what changed? -->
+
+## UC-02: [Name]
+<!-- FILL -->
+
+## UC-03: [Name]
+<!-- FILL -->
 `;
 /**
  * Build the UNFILLED stub content for docs/diagrams/c4-context.md.
@@ -29,16 +29,16 @@ export const USE_CASES_STUB = `<!-- UNFILLED: Use Cases -->
  * @returns Stub content with UNFILLED markers
  */
 export function buildC4ContextStub(projectName) {
-    return `<!-- UNFILLED: C4 Context Diagram -->
-<!-- Run \`forgecraft generate_diagram\` to auto-generate from your spec -->
-# System Context Diagram
-\`\`\`mermaid
-C4Context
-  title System Context: ${projectName}
-  Person(user, "User", "<!-- FILL: Who uses the system? -->")
-  System(system, "${projectName}", "<!-- FILL: What does the system do in one sentence? -->")
-  Rel(user, system, "<!-- FILL: Primary interaction -->")
-\`\`\`
+    return `<!-- UNFILLED: C4 Context Diagram -->
+<!-- Run \`forgecraft generate_diagram\` to auto-generate from your spec -->
+# System Context Diagram
+\`\`\`mermaid
+C4Context
+  title System Context: ${projectName}
+  Person(user, "User", "<!-- FILL: Who uses the system? -->")
+  System(system, "${projectName}", "<!-- FILL: What does the system do in one sentence? -->")
+  Rel(user, system, "<!-- FILL: Primary interaction -->")
+\`\`\`
 `;
 }
 /**
@@ -51,32 +51,32 @@ C4Context
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildSequenceDiagramStub(feature) {
-    return `<!-- UNFILLED: Sequence Diagram — ${feature} -->
-<!-- Replace participant labels and messages with real actors and contracts -->
-# Sequence Diagram: ${feature}
-
-\`\`\`mermaid
-sequenceDiagram
-    participant Client as <!-- FILL: initiating actor, e.g. Browser / CLI / Service -->
-    participant API as <!-- FILL: entry-point service, e.g. API Gateway -->
-    participant Service as <!-- FILL: domain service, e.g. AuthService -->
-    participant Store as <!-- FILL: persistence layer, e.g. Database -->
-
-    Note over Client,Store: <!-- FILL: describe the primary flow in one sentence -->
-
-    Client->>API: <!-- FILL: request, e.g. POST /login {credentials} -->
-    API->>Service: <!-- FILL: delegate, e.g. authenticate(credentials) -->
-    Service->>Store: <!-- FILL: query, e.g. findUserByEmail(email) -->
-    Store-->>Service: <!-- FILL: result, e.g. User | null -->
-
-    alt <!-- FILL: failure case, e.g. User not found or wrong password -->
-        Service-->>API: <!-- FILL: error response, e.g. AuthError -->
-        API-->>Client: <!-- FILL: HTTP error, e.g. 401 Unauthorized -->
-    else <!-- FILL: success case -->
-        Service-->>API: <!-- FILL: success result, e.g. JWT token -->
-        API-->>Client: <!-- FILL: HTTP success, e.g. 200 OK {token} -->
-    end
-\`\`\`
+    return `<!-- UNFILLED: Sequence Diagram — ${feature} -->
+<!-- Replace participant labels and messages with real actors and contracts -->
+# Sequence Diagram: ${feature}
+
+\`\`\`mermaid
+sequenceDiagram
+    participant Client as <!-- FILL: initiating actor, e.g. Browser / CLI / Service -->
+    participant API as <!-- FILL: entry-point service, e.g. API Gateway -->
+    participant Service as <!-- FILL: domain service, e.g. AuthService -->
+    participant Store as <!-- FILL: persistence layer, e.g. Database -->
+
+    Note over Client,Store: <!-- FILL: describe the primary flow in one sentence -->
+
+    Client->>API: <!-- FILL: request, e.g. POST /login {credentials} -->
+    API->>Service: <!-- FILL: delegate, e.g. authenticate(credentials) -->
+    Service->>Store: <!-- FILL: query, e.g. findUserByEmail(email) -->
+    Store-->>Service: <!-- FILL: result, e.g. User | null -->
+
+    alt <!-- FILL: failure case, e.g. User not found or wrong password -->
+        Service-->>API: <!-- FILL: error response, e.g. AuthError -->
+        API-->>Client: <!-- FILL: HTTP error, e.g. 401 Unauthorized -->
+    else <!-- FILL: success case -->
+        Service-->>API: <!-- FILL: success result, e.g. JWT token -->
+        API-->>Client: <!-- FILL: HTTP success, e.g. 200 OK {token} -->
+    end
+\`\`\`
 `;
 }
 /**
@@ -90,30 +90,30 @@ sequenceDiagram
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildStateMachineDiagramStub(entityName) {
-    return `<!-- UNFILLED: State Machine — ${entityName} -->
-<!-- Replace state names (Draft, Pending, Active, etc.) and transition labels -->
-<!-- with the actual lifecycle states of your domain entity.               -->
-# State Machine: ${entityName}
-
-\`\`\`mermaid
-stateDiagram-v2
-    [*] --> Draft
-
-    Draft --> Pending: submit()
-    Pending --> Active: approve()
-    Pending --> Rejected: reject()
-    Active --> Completed: complete()
-    Active --> Cancelled: cancel()
-
-    Completed --> [*]
-    Rejected --> [*]
-    Cancelled --> [*]
-
-    note right of Active
-        FILL: add invariant or constraint
-        e.g. "requires valid payment method"
-    end note
-\`\`\`
+    return `<!-- UNFILLED: State Machine — ${entityName} -->
+<!-- Replace state names (Draft, Pending, Active, etc.) and transition labels -->
+<!-- with the actual lifecycle states of your domain entity.               -->
+# State Machine: ${entityName}
+
+\`\`\`mermaid
+stateDiagram-v2
+    [*] --> Draft
+
+    Draft --> Pending: submit()
+    Pending --> Active: approve()
+    Pending --> Rejected: reject()
+    Active --> Completed: complete()
+    Active --> Cancelled: cancel()
+
+    Completed --> [*]
+    Rejected --> [*]
+    Cancelled --> [*]
+
+    note right of Active
+        FILL: add invariant or constraint
+        e.g. "requires valid payment method"
+    end note
+\`\`\`
 `;
 }
 /**
@@ -126,29 +126,29 @@ stateDiagram-v2
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildFlowDiagramStub(ucName) {
-    return `<!-- UNFILLED: Flow Diagram — ${ucName} -->
-<!-- Replace node labels and edge conditions with real user journey steps -->
-# Flow: ${ucName}
-
-\`\`\`mermaid
-flowchart TD
-    Start([<!-- FILL: trigger, e.g. User opens registration page -->])
-
-    Start --> Input[<!-- FILL: first action, e.g. Fill in name, email, password -->]
-    Input --> Validate{<!-- FILL: validation check, e.g. All fields valid? -->}
-
-    Validate -->|<!-- FILL: failure label, e.g. Invalid -->| Error[<!-- FILL: error action, e.g. Show validation errors -->]
-    Error --> Input
-
-    Validate -->|<!-- FILL: success label, e.g. Valid -->| Process[<!-- FILL: main action, e.g. Create account -->]
-    Process --> Check{<!-- FILL: guard check, e.g. Email already exists? -->}
-
-    Check -->|<!-- FILL: conflict label, e.g. Yes -->| Conflict[<!-- FILL: conflict action, e.g. Show duplicate email error -->]
-    Conflict --> End([<!-- FILL: exit label, e.g. User corrects email -->])
-
-    Check -->|<!-- FILL: proceed label, e.g. No -->| Success[<!-- FILL: success action, e.g. Send confirmation email -->]
-    Success --> End
-\`\`\`
+    return `<!-- UNFILLED: Flow Diagram — ${ucName} -->
+<!-- Replace node labels and edge conditions with real user journey steps -->
+# Flow: ${ucName}
+
+\`\`\`mermaid
+flowchart TD
+    Start([<!-- FILL: trigger, e.g. User opens registration page -->])
+
+    Start --> Input[<!-- FILL: first action, e.g. Fill in name, email, password -->]
+    Input --> Validate{<!-- FILL: validation check, e.g. All fields valid? -->}
+
+    Validate -->|<!-- FILL: failure label, e.g. Invalid -->| Error[<!-- FILL: error action, e.g. Show validation errors -->]
+    Error --> Input
+
+    Validate -->|<!-- FILL: success label, e.g. Valid -->| Process[<!-- FILL: main action, e.g. Create account -->]
+    Process --> Check{<!-- FILL: guard check, e.g. Email already exists? -->}
+
+    Check -->|<!-- FILL: conflict label, e.g. Yes -->| Conflict[<!-- FILL: conflict action, e.g. Show duplicate email error -->]
+    Conflict --> End([<!-- FILL: exit label, e.g. User corrects email -->])
+
+    Check -->|<!-- FILL: proceed label, e.g. No -->| Success[<!-- FILL: success action, e.g. Send confirmation email -->]
+    Success --> End
+\`\`\`
 `;
 }
 /**
@@ -161,24 +161,24 @@ flowchart TD
  * @returns Stub content with UNFILLED markers and structural Mermaid syntax
  */
 export function buildC4ContainerStub(projectName) {
-    return `<!-- UNFILLED: C4 Container Diagram -->
-<!-- Replace container labels, technology fields, and relations with your stack -->
-# Container Diagram — ${projectName}
-
-\`\`\`mermaid
-C4Container
-    title Container Diagram: ${projectName}
-
-    Person(user, "<!-- FILL: actor name -->", "<!-- FILL: actor description -->")
-
-    Container(web, "<!-- FILL: frontend name, e.g. Web Application -->", "<!-- FILL: technology, e.g. React -->", "<!-- FILL: responsibility -->")
-    Container(api, "<!-- FILL: backend name, e.g. API Server -->", "<!-- FILL: technology, e.g. Node.js / Express -->", "<!-- FILL: responsibility -->")
-    Container(db, "<!-- FILL: database name, e.g. Primary Database -->", "<!-- FILL: technology, e.g. PostgreSQL -->", "<!-- FILL: responsibility -->")
-
-    Rel(user, web, "<!-- FILL: interaction, e.g. Uses -->", "<!-- FILL: protocol, e.g. HTTPS -->")
-    Rel(web, api, "<!-- FILL: call, e.g. API calls -->", "<!-- FILL: protocol, e.g. REST / JSON -->")
-    Rel(api, db, "<!-- FILL: query, e.g. Reads and writes -->", "<!-- FILL: protocol, e.g. SQL -->")
-\`\`\`
+    return `<!-- UNFILLED: C4 Container Diagram -->
+<!-- Replace container labels, technology fields, and relations with your stack -->
+# Container Diagram — ${projectName}
+
+\`\`\`mermaid
+C4Container
+    title Container Diagram: ${projectName}
+
+    Person(user, "<!-- FILL: actor name -->", "<!-- FILL: actor description -->")
+
+    Container(web, "<!-- FILL: frontend name, e.g. Web Application -->", "<!-- FILL: technology, e.g. React -->", "<!-- FILL: responsibility -->")
+    Container(api, "<!-- FILL: backend name, e.g. API Server -->", "<!-- FILL: technology, e.g. Node.js / Express -->", "<!-- FILL: responsibility -->")
+    Container(db, "<!-- FILL: database name, e.g. Primary Database -->", "<!-- FILL: technology, e.g. PostgreSQL -->", "<!-- FILL: responsibility -->")
+
+    Rel(user, web, "<!-- FILL: interaction, e.g. Uses -->", "<!-- FILL: protocol, e.g. HTTPS -->")
+    Rel(web, api, "<!-- FILL: call, e.g. API calls -->", "<!-- FILL: protocol, e.g. REST / JSON -->")
+    Rel(api, db, "<!-- FILL: query, e.g. Reads and writes -->", "<!-- FILL: protocol, e.g. SQL -->")
+\`\`\`
 `;
 }
 /**

package/dist/tools/scaffold-templates.js

@@ -1,76 +1,76 @@
 /**
  * scaffold-templates: Static template strings and render functions for scaffold_project.
  */
-export const PROJECT_SPECIFIC_TEMPLATE = `# Project-Specific Rules
-<!-- This file is owned by YOU. ForgeCraft will never overwrite it. -->
-<!-- Add project-specific rules, framework choices, conventions, and corrections here. -->
-<!-- The sentinel CLAUDE.md links here so any AI reading your project can find it. -->
-
-## Framework & Stack Choices
-<!-- e.g. We use Prisma for ORM. Deploy target is Railway. Python 3.11+. -->
-
-## Custom Corrections Log
-<!-- Log AI corrections so the pattern isn't repeated. -->
-<!-- Format: - YYYY-MM-DD: [description of correction] -->
-
-## Project-Specific Gates
-<!-- Add quality rules specific to this project that don't belong in universal standards. -->
+export const PROJECT_SPECIFIC_TEMPLATE = `# Project-Specific Rules
+<!-- This file is owned by YOU. ForgeCraft will never overwrite it. -->
+<!-- Add project-specific rules, framework choices, conventions, and corrections here. -->
+<!-- The sentinel CLAUDE.md links here so any AI reading your project can find it. -->
+
+## Framework & Stack Choices
+<!-- e.g. We use Prisma for ORM. Deploy target is Railway. Python 3.11+. -->
+
+## Custom Corrections Log
+<!-- Log AI corrections so the pattern isn't repeated. -->
+<!-- Format: - YYYY-MM-DD: [description of correction] -->
+
+## Project-Specific Gates
+<!-- Add quality rules specific to this project that don't belong in universal standards. -->
 `;
 export const EXCEPTIONS_TEMPLATE = JSON.stringify({
     version: "1",
     _comment: "Hook false-positive exceptions. Add entries here to prevent rediscovering the same false positive each session. Each entry: {id, hook, pattern, reason, addedAt, addedBy, adr?}",
     exceptions: [],
 }, null, 2) + "\n";
-export const PROJECT_GATES_TEMPLATE = `version: "1"
-# Project-specific quality gates.
-# Gates you discover while working that should be enforced for this project.
-# Set generalizable: true + fill in evidence to contribute to the community registry.
-# See: https://github.com/jghiringhelli/quality-gates/issues/new?template=quality-gate-proposal.md
-gates: []
+export const PROJECT_GATES_TEMPLATE = `version: "1"
+# Project-specific quality gates.
+# Gates you discover while working that should be enforced for this project.
+# Set generalizable: true + fill in evidence to contribute to the community registry.
+# See: https://github.com/jghiringhelli/quality-gates/issues/new?template=quality-gate-proposal.md
+gates: []
 `;
-export const SMOKE_TESTS_README = `# Smoke Tests
-
-Generated by ForgeCraft scaffold. Fill in the critical paths from your tech spec.
-
-## What smoke tests cover
-- Every API entry point that serves real users
-- Every critical user journey end-to-end
-- Every DB migration (verify schema applied correctly)
-- Every external integration handshake
-
-## Format
-Use the tool configured in forgecraft.yaml deployment.testing.smokeTool (or default to HTTP assertions).
-All smoke tests must complete in < 60 seconds total.
-
-## Running
-See forgecraft.yaml tools.test or your project's test runner.
-Results are written to .forgecraft/reports/smoke-latest.json.
-
-## Required before deployment
-All smoke tests must pass against staging before any production deploy.
-See verification.yaml deployment-gates phase.
+export const SMOKE_TESTS_README = `# Smoke Tests
+
+Generated by ForgeCraft scaffold. Fill in the critical paths from your tech spec.
+
+## What smoke tests cover
+- Every API entry point that serves real users
+- Every critical user journey end-to-end
+- Every DB migration (verify schema applied correctly)
+- Every external integration handshake
+
+## Format
+Use the tool configured in forgecraft.yaml deployment.testing.smokeTool (or default to HTTP assertions).
+All smoke tests must complete in < 60 seconds total.
+
+## Running
+See forgecraft.yaml tools.test or your project's test runner.
+Results are written to .forgecraft/reports/smoke-latest.json.
+
+## Required before deployment
+All smoke tests must pass against staging before any production deploy.
+See verification.yaml deployment-gates phase.
 `;
-export const LOAD_TESTS_README = `# Load Tests
-
-Generated by ForgeCraft scaffold. Fill in the parameters from your tech spec.
-
-## Parameters (fill in from forgecraft.yaml deployment.testing.load)
-- Concurrent users: [TODO: concurrentUsers from forgecraft.yaml]
-- Target RPS: [TODO: targetRps from forgecraft.yaml]
-- p99 ceiling: [TODO: p99CeilingMs ms]
-- Duration: [TODO: durationSeconds seconds minimum]
-
-## When these parameters are missing
-Deploying without stated load test parameters is full deployment with manual monitoring.
-The paper requires: parameters named in spec BEFORE the test runs, not after.
-Add them to forgecraft.yaml deployment.testing.load before running.
-
-## Tool
-Use the tool configured in forgecraft.yaml deployment.testing.load.tool (k6, Artillery, Locust, etc.)
-Results are written to .forgecraft/reports/load-latest.json.
-
-## Required before pre-release
-See verification.yaml pre-release-hardening phase, load-test step.
+export const LOAD_TESTS_README = `# Load Tests
+
+Generated by ForgeCraft scaffold. Fill in the parameters from your tech spec.
+
+## Parameters (fill in from forgecraft.yaml deployment.testing.load)
+- Concurrent users: [TODO: concurrentUsers from forgecraft.yaml]
+- Target RPS: [TODO: targetRps from forgecraft.yaml]
+- p99 ceiling: [TODO: p99CeilingMs ms]
+- Duration: [TODO: durationSeconds seconds minimum]
+
+## When these parameters are missing
+Deploying without stated load test parameters is full deployment with manual monitoring.
+The paper requires: parameters named in spec BEFORE the test runs, not after.
+Add them to forgecraft.yaml deployment.testing.load before running.
+
+## Tool
+Use the tool configured in forgecraft.yaml deployment.testing.load.tool (k6, Artillery, Locust, etc.)
+Results are written to .forgecraft/reports/load-latest.json.
+
+## Required before pre-release
+See verification.yaml pre-release-hardening phase, load-test step.
 `;
 /**
  * Render the bootstrap README for docs/adrs/.

package/dist/tools/session-prompt-builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-prompt-builders.d.ts","sourceRoot":"","sources":["../../src/tools/session-prompt-builders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWxD,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAID,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,kDAAkD,CAAC;AAWtF;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAU3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA2B/D;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CA2BrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAQtE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CASvF;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA6B3D"}
+{"version":3,"file":"session-prompt-builders.d.ts","sourceRoot":"","sources":["../../src/tools/session-prompt-builders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWxD,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAID,8DAA8D;AAC9D,eAAO,MAAM,sBAAsB,kDACc,CAAC;AAelD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAY3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqC/D;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAyCrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,CAQtE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,GACtB,aAAa,GAAG,IAAI,CActB;AAID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAuC3D"}

package/dist/tools/session-prompt-builders.js

@@ -13,8 +13,12 @@ import { buildContextLoadBlock, buildTddGateSection, buildContextRetrievalSectio
 /** Primary-use text shown for the forgecraft server entry. */
 export const FORGECRAFT_PRIMARY_USE = "check_cascade, generate_session_prompt, audit";
 const CONSTITUTION_PATHS = [
-    "CLAUDE.md", "AGENTS.md", ".github/copilot-instructions.md",
-    ".cursor/rules", ".windsurfrules", ".clinerules",
+    "CLAUDE.md",
+    "AGENTS.md",
+    ".github/copilot-instructions.md",
+    ".cursor/rules",
+    ".windsurfrules",
+    ".clinerules",
 ];
 const ADR_DIRS = ["docs/adrs", "docs/adr"];
 // ── MCP Tools Section ────────────────────────────────────────────────
@@ -34,7 +38,9 @@ export function loadMcpServerDescriptions() {
         for (const server of parsed.servers ?? [])
             map.set(server.name, server);
     }
-    catch { /* Return empty map */ }
+    catch {
+        /* Return empty map */
+    }
     return map;
 }
 /**
@@ -66,7 +72,9 @@ export function buildMcpToolsSection(projectDir) {
             : (descriptions.get(name)?.description ?? "MCP server");
         lines.push(`- **${name}** — ${primaryUse}`);
     }
-    return `## Active MCP Tools\n\nThese tools are available in this session. Use them:\n` + lines.join("\n") + "\n\n";
+    return (`## Active MCP Tools\n\nThese tools are available in this session. Use them:\n` +
+        lines.join("\n") +
+        "\n\n");
 }
 // ── Artifact Discovery ───────────────────────────────────────────────
 /**
@@ -97,8 +105,17 @@ export function discoverArtifacts(projectDir) {
         existsSync(join(projectDir, "docs/UseCases.md"));
     const activeGateDir = join(projectDir, ".forgecraft/gates/project/active");
     const activeGateCount = existsSync(activeGateDir)
-        ? readdirSync(activeGateDir).filter((f) => f.endsWith(".yaml")).length : 0;
-    return { constitutionPath, statusExists, adrCount, adrDir, diagramsExist, useCasesExist, activeGateCount };
+        ? readdirSync(activeGateDir).filter((f) => f.endsWith(".yaml")).length
+        : 0;
+    return {
+        constitutionPath,
+        statusExists,
+        adrCount,
+        adrDir,
+        diagramsExist,
+        useCasesExist,
+        activeGateCount,
+    };
 }
 /**
  * Extract the last meaningful section of Status.md for context.
@@ -141,7 +158,12 @@ export function buildRoadmapItemAmbiguity(itemDescription) {
         field: "roadmap_item",
         understood_as: `Interpreting '${itemDescription}' as its most common literal meaning`,
         understood_example: `I scoped the session prompt to: ${itemDescription} (minimal implementation)`,
-        alternatives: [{ label: "If broader scope intended", action: `Include related concerns: error handling, integration tests, ADR for architectural decisions` }],
+        alternatives: [
+            {
+                label: "If broader scope intended",
+                action: `Include related concerns: error handling, integration tests, ADR for architectural decisions`,
+            },
+        ],
         resolution_hint: `Pass a more specific item_description, e.g. 'Add JWT authentication with email/password login, bcrypt hashing, and a /auth/refresh endpoint'`,
     };
 }
@@ -153,15 +175,17 @@ export function buildRoadmapItemAmbiguity(itemDescription) {
  * @returns Complete, ready-to-paste session prompt
  */
 export function buildPrompt(input) {
-    const { projectDir, itemDescription, sessionType, scopeNote, acceptanceCriteria, artifacts, statusSummary } = input;
+    const { projectDir, itemDescription, sessionType, scopeNote, acceptanceCriteria, artifacts, statusSummary, } = input;
     const contextLoadBlock = buildContextLoadBlock(artifacts);
-    const scopeBlock = scopeNote ? `\n## Out of Scope\nDo NOT touch: ${scopeNote}\n` : "";
+    const scopeBlock = scopeNote
+        ? `\n## Out of Scope\nDo NOT touch: ${scopeNote}\n`
+        : "";
     const criteriaLines = acceptanceCriteria.map((c) => `- [ ] ${c}`).join("\n");
     const conventionalType = sessionType === "fix" ? "fix" : sessionType;
     let prompt = `# Session Prompt — Bound\n\n> Generated by ForgeCraft \`generate_session_prompt\`. Load context, then issue this prompt.\n\n---\n\n`;
     prompt += `## Context Load Order\n\nLoad these artifacts **before** issuing the implementation prompt:\n\n${contextLoadBlock}\n`;
     if (statusSummary) {
-        prompt += `## Current State (from Status.md)\n\n\`\`\`\n${statusSummary}\n\`\`\`\n\n`;
+        prompt += statusSummary + "\n\n";
     }
     prompt += `---\n\n## Implementation Prompt\n\n*(Paste everything below this line to the AI assistant)*\n\n---\n\n`;
     prompt += `### Task\n\n${itemDescription}\n\n`;

package/dist/tools/session-prompt-builders.js.map

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

package/dist/tools/setup-artifact-writers.d.ts

@@ -3,6 +3,23 @@
  */
 import type { CascadeDecision } from "../shared/types.js";
 import { deriveDefaultCascadeDecisions } from "./cascade-defaults.js";
+/**
+ * Result of a pre-flight git environment check.
+ *
+ * - `repo`    — a `.git` directory exists; all good.
+ * - `no-repo` — git is installed but no repository exists yet; ForgeCraft will init one.
+ * - `no-git`  — git binary not found; user must install git before setup can proceed.
+ */
+export type GitStatus = "repo" | "no-repo" | "no-git";
+/**
+ * Check whether a git repository and the git binary are present.
+ *
+ * Does NOT modify the filesystem. Safe to call at any time.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @returns Current git status for the directory
+ */
+export declare function checkGitStatus(projectDir: string): GitStatus;
 /**
  * Initialise a git repository in projectDir if one does not already exist.
  * Falls back gracefully when git is not installed.
@@ -60,6 +77,19 @@ export declare function writePrd(projectDir: string, projectName: string, aiFiel
  */
 export declare function writeUseCases(projectDir: string, projectName: string, aiFields: AiExtractedFields, _specContent: string | null): boolean;
 export { deriveDefaultCascadeDecisions };
+/**
+ * Write docs/sample-outcome.md — a stub for the first real deliverable of
+ * a generative tool. Created when Phase 2 receives tool_sample_split = "tool_and_sample".
+ *
+ * The AI assistant should fill in the sections from the creative content
+ * described in the spec (the book, song, game, artwork, etc.).
+ * Never overwrites an existing file.
+ *
+ * @param projectDir - Project root
+ * @param toolName - Name of the core generative tool
+ * @returns True if the file was written
+ */
+export declare function writeSampleOutcome(projectDir: string, toolName: string): boolean;
 /**
  * Load cascade decisions from forgecraft.yaml (convenience re-used in writers).
  */

package/dist/tools/setup-artifact-writers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-artifact-writers.d.ts","sourceRoot":"","sources":["../../src/tools/setup-artifact-writers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAItE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAwBtD;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,eAAe,EAAE,EAC5B,aAAa,CAAC,EAAE,OAAO,EACvB,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CAkBT;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAcpE;AAID,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAMT;AAgBD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAMT;AAgBD,OAAO,EAAE,6BAA6B,EAAE,CAAC;AAEzC;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,IAAI,CAUzF"}
+{"version":3,"file":"setup-artifact-writers.d.ts","sourceRoot":"","sources":["../../src/tools/setup-artifact-writers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAItE;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAQ5D;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAwBtD;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,eAAe,EAAE,EAC5B,aAAa,CAAC,EAAE,OAAO,EACvB,UAAU,CAAC,EAAE,OAAO,GACnB,OAAO,CA8BT;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAwBpE;AAID,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAMT;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,iBAAiB,EAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAUT;AAuDD,OAAO,EAAE,6BAA6B,EAAE,CAAC;AAIzC;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CA4CT;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,GACjB,eAAe,EAAE,GAAG,IAAI,CAY1B"}