forgecraft-mcp 1.3.2 → 1.6.1

package/dist/tools/verify.js

@@ -16,6 +16,7 @@ import { scoreGsProperties, findDirectDbCallsInRoutes, findMissingTestFiles, } f
 import { analyzeProject } from "../analyzers/package-json.js";
 import { loadUserOverrides } from "../registry/loader.js";
 import { formatReport } from "./verify-formatter.js";
+import { computeMaturityTier } from "../shared/types.js";
 // ── Schema ─────────────────────────────────────────────────────────────
 export const verifySchema = z.object({
     project_dir: z
@@ -56,6 +57,7 @@ export async function verifyHandler(args) {
     const propertyScores = scoreGsProperties(projectDir, testSuite.passed, layerViolations, missingTestFiles);
     const totalScore = propertyScores.reduce((sum, p) => sum + p.score, 0);
     const overallPass = testSuite.passed && totalScore >= args.pass_threshold;
+    const maturityTier = computeMaturityTier(totalScore);
     const result = {
         testSuite,
         propertyScores,
@@ -63,6 +65,7 @@ export async function verifyHandler(args) {
         layerViolations,
         missingTestFiles,
         overallPass,
+        maturityTier,
     };
     const report = formatReport(result, args.pass_threshold);
     const driftWarning = detectTagDrift(projectDir);

package/dist/tools/verify.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgecraft-mcp",
-  "version": "1.3.2",
+  "version": "1.6.1",
   "mcpName": "io.github.jghiringhelli/forgecraft",
   "description": "CLI + MCP sentinel for engineering standards — SOLID, testing, architecture, CI/CD — auto-tailored to your stack. Minimal MCP footprint (~200 tokens) via CLI-first design.",
   "type": "module",
@@ -19,11 +19,17 @@
     "test:mutation": "stryker run",
     "test:mutation:ci": "stryker run --reporters progress,clear-text",
     "test:mutation:sentinel": "stryker run stryker.sentinel.json",
+    "test:mutation:brownfield": "stryker run stryker.brownfield.json",
     "lint": "eslint src/",
+    "ship": "bash scripts/ship.sh",
+    "protect": "bash scripts/protect-branch.sh",
+    "audit:tests": "node scripts/audit-tests.cjs",
+    "post-results": "node scripts/post-results.cjs",
     "clean": "rimraf dist",
     "prepare": "node -e \"if(require('fs').existsSync('.git')&&require('fs').existsSync('scripts/setup-hooks.sh')){require('child_process').execSync('bash scripts/setup-hooks.sh',{stdio:'inherit'})}\"",
     "prepublishOnly": "npm run clean && npm run build",
-    "export:taxonomy": "npx ts-node --esm scripts/export-taxonomy.ts"
+    "export:taxonomy": "npx ts-node --esm scripts/export-taxonomy.ts",
+    "docs:generate": "typedoc"
   },
   "keywords": [
     "mcp",
@@ -70,6 +76,8 @@
     "zod": "^3.24.2"
   },
   "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
     "@stryker-mutator/core": "^9.6.0",
     "@stryker-mutator/vitest-runner": "^9.6.0",
     "@types/express": "^5.0.6",
@@ -83,6 +91,7 @@
     "express": "^5.2.1",
     "rimraf": "^6.0.1",
     "supertest": "^7.2.2",
+    "typedoc": "^0.28.19",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5"
   }

package/templates/api/harness/uc-template.hurl

@@ -0,0 +1,20 @@
+# L2 Harness: {{uc_id}} — {{uc_title}}
+# Actor: {{actor}}
+# Precondition: {{precondition}}
+# Postcondition: {{postcondition}}
+#
+# This is a behavioral harness probe. A failure is a specification violation.
+# Implement the main flow steps from the use case below.
+
+# Step 1: [precondition setup if needed]
+# POST http://{{host}}/api/auth/login
+# ...
+
+# Step 2: [primary action]
+# TODO: implement UC main flow as HTTP sequence
+GET http://{{host}}/api/endpoint
+Authorization: Bearer {{token}}
+
+HTTP 200
+[Asserts]
+# jsonpath "$.field" == "expected_value"

package/templates/docs-manifest.yaml

@@ -0,0 +1,224 @@
+# docs-manifest.yaml — canonical schema for the GS document taxonomy
+#
+# This file is the SINGLE SOURCE OF TRUTH for the document layout that all
+# Pragmaworks GS-aware tools (forgecraft, chronicle, chronicle-team) honor.
+# Projects do NOT copy this file. They write their own ./docs/manifest.yaml
+# which references this canonical schema and overrides paths where needed.
+#
+# Canonical location:
+#   github.com/jghiringhelli/forgecraft-mcp/templates/docs-manifest.yaml
+#   (also reachable via the forgecraft npm package)
+#
+# A project's docs/manifest.yaml LOOKS LIKE:
+#
+#     schema_source: forgecraft@1.5.0/templates/docs-manifest.yaml
+#     project:
+#       name: my-app
+#       type: api
+#     overrides:
+#       documents.specs.path: docs/product/      # legacy layout, mapped in
+#       documents.use_cases.path: docs/uc/
+#
+# Tools resolve paths in this order:
+#   1. project's docs/manifest.yaml `overrides:` block (highest priority)
+#   2. project's docs/manifest.yaml top-level fields
+#   3. this canonical schema's defaults
+#
+# That is what "back-compat" means here: the canonical layout is the default;
+# legacy projects map their existing files into the schema via overrides.
+
+version: 1
+
+# ── Project metadata ─────────────────────────────────────────────────────
+project:
+  name: <required>           # human-readable project name
+  type: <required>           # library | cli | api | service | app | tool
+  release_phase: greenfield  # greenfield | brownfield | maintenance
+
+# ── Document types and their canonical locations ─────────────────────────
+# Each entry defines:
+#   path        — where files live (or active_path/done_path for archived types)
+#   pattern     — glob applied for discovery
+#   required_on — conventional-commit types that MUST touch a file in this slot
+#   archive_when (optional) — when files move from active_path to done_path
+documents:
+
+  # SPECS — what we are building (product/use-case-driven specs)
+  specs:
+    path: docs/specs/
+    pattern: "*.md"
+    required_on: [feat, refactor]
+    description: >
+      Product-level specs. One per feature or major capability.
+      Answers: what does the user do, what outcome do they want, what is in/out of scope?
+
+  # ADRs — architectural decision records (how we build, with rationale)
+  adrs:
+    active_path: docs/adrs/active/
+    done_path: docs/adrs/done/
+    pattern: "ADR-*.md"
+    required_on: []          # encouraged on feat/refactor when a decision is made
+    archive_when: superseded
+    description: >
+      Architectural Decision Records. One file per decision (e.g. ADR-0007-pick-postgres.md).
+      Active = currently in force. Done = superseded or rolled back, kept for history.
+
+  # USE CASES — actor + action + outcome (executable scenarios)
+  use_cases:
+    path: docs/use-cases/
+    pattern: "UC-*.md"
+    required_on: [feat]
+    description: >
+      Executable use cases. Each one: actor, preconditions, steps, expected outcome.
+      These bind specs to harness/tests.
+
+  # ROADMAPS — planned/active/done work items
+  roadmaps:
+    active_path: docs/roadmaps/active/
+    done_path: docs/roadmaps/done/
+    pattern: "RM-*.md"
+    required_on: []          # roadmap items are pulled from tickets/issues, not commits
+    archive_when: implemented
+    description: >
+      Roadmap items. One file per planned chunk of work (e.g. RM-0042-add-oauth.md).
+      Active = open. Done = shipped (kept for history and changelog generation).
+
+  # SCHEMAS — diagrams, data schemas, API schemas
+  schemas:
+    path: docs/schemas/
+    pattern: "*.{md,mmd,json,yaml}"
+    required_on: [feat]
+    description: >
+      Mermaid diagrams (.mmd or fenced .md), JSON Schema, OpenAPI specs, ER diagrams.
+      Required when data model or API surface changes.
+
+  # DECISIONS — lightweight bug-fix or operational decisions
+  decisions:
+    path: docs/decisions/
+    pattern: "*.md"
+    required_on: []          # optional even on fix; encouraged when behavior is intentionally redefined
+    description: >
+      One-pager rationale for non-architectural decisions: bug-fix interpretations,
+      operational tweaks, "we chose X over Y because Z" notes that don't warrant a full ADR.
+      Filename pattern: YYYY-MM-DD-slug.md.
+
+  # CONTRACTS — behavioral contracts (what the system promises)
+  contracts:
+    path: docs/contracts/
+    pattern: "*.{md,yaml}"
+    required_on: []
+    description: >
+      Behavioral contracts. NFRs, SLOs, API contracts, error semantics.
+      Often referenced from specs and ADRs.
+
+  # SESSION PROMPTS — bound to roadmap items (forgecraft + chronicle convention)
+  session_prompts:
+    path: docs/session-prompts/
+    pattern: "RM-*.md"
+    required_on: []
+    description: >
+      Per-roadmap-item prompts that drive AI sessions. One per RM-* item.
+      Generated by forgecraft propose_session, executed by chronicle.
+
+# ── Cascade rules — which commit types require which doc updates ─────────
+# These are enforced by:
+#   - .claude/hooks/pre-commit-doc-cascade.sh (local, advisory)
+#   - .github/workflows/validate-pr.yml       (CI, blocking when severity=error)
+#
+# Severity:
+#   error    — blocks commit/PR
+#   warning  — emits a notice; does not block
+#   info     — logs only
+cascade:
+  feat:
+    required: [specs]
+    encouraged: [use_cases, schemas, adrs]
+    severity: warning            # bump to error once a project's baseline is clean
+
+  fix:
+    required: []                 # no doc requirement; regression test is mandatory (see human_judgment)
+    encouraged: [decisions]
+    require_regression_test: true
+    severity: warning
+
+  refactor:
+    required: []
+    encouraged: [adrs, decisions]
+    severity: info
+
+  perf:
+    required: []
+    encouraged: [decisions, schemas]
+    severity: info
+
+  docs:
+    required: []
+    encouraged: []
+    severity: info
+
+  test:
+    required: []
+    encouraged: []
+    severity: info
+
+  chore:
+    required: []
+    encouraged: []
+    severity: info
+
+  ci:
+    required: []
+    encouraged: []
+    severity: info
+
+  revert:
+    required: []
+    encouraged: [decisions]
+    severity: info
+
+# ── Anti-drift — public API surface enforcement ─────────────────────────
+# When the public surface changes (exports, public types, CLI flags, MCP tool
+# schemas), a spec or ADR touch is required regardless of commit type.
+api_surface:
+  detect:
+    typescript:
+      exports_glob: "src/**/index.ts"
+      public_types_glob: "src/types/**/*.ts"
+    cli:
+      flags_glob: "src/cli/**/*.ts"
+    mcp:
+      tools_glob: "src/tools/**/*.ts"
+  on_change_require: [specs, adrs]
+  severity: warning
+
+# ── Human-judgment gate — "no untested or unreviewed code to prod" ──────
+human_judgment:
+  protected_branches: [main, develop]
+  require_review: true
+  min_reviewers: 1               # set 0 for solo mode (still requires PR + checks)
+  require_tests_pass: true       # CI must show tests green
+  require_human_ack: true        # at least one human comment/approval on the PR
+  block_ai_only_merge: true      # disallow merge when only the PR author has interacted
+
+# ── Recording layers — three-tier memory contract ───────────────────────
+# This block is informational. It documents how project / individual / team
+# memory split across tools, so each tool knows its lane.
+recording:
+  project:
+    owner: forgecraft
+    surface: docs/* + .forgecraft/* + .claude/hooks/*
+    scope: cascade docs, gates, hooks, harness contracts
+  individual:
+    owner: chronicle
+    surface: ~/.chronicle/ (per-user memory store)
+    scope: prompt history, decisions, findings, developer habits, work style
+  team:
+    owner: chronicle-team
+    surface: shared DB (Railway) + dashboard
+    scope: shared memory, prompt analytics, ticket integration, workload split (axon)
+
+# ── Brownfield ingestion settings ───────────────────────────────────────
+brownfield:
+  scanner: pragmaworks-cli       # external tool, not embedded
+  override_file: docs/manifest.yaml    # generated/edited during ingestion
+  report_path: reports/brownfield-audit.md

package/templates/game/harness/uc-template.sim.ts

@@ -0,0 +1,29 @@
+/**
+ * L2 Harness: {{uc_id}} — {{uc_title}}
+ *
+ * Headless simulation probe — verifies behavioral invariants without rendering.
+ * Runs the use case scenario through the game engine in headless mode.
+ * Failure = specification violation.
+ */
+
+// TODO: Import your game engine / simulation module
+// import { GameEngine } from '../../src/engine';
+
+async function runProbe(): Promise<void> {
+  // Set up precondition: {{precondition}}
+  // const engine = new GameEngine({ headless: true });
+
+  // Execute main flow: {{main_flow_summary}}
+
+  // Assert postcondition: {{postcondition}}
+  // if (!engine.state.matches(expectedState)) {
+  //   throw new Error(`UC postcondition violated: ${engine.state}`);
+  // }
+
+  throw new Error("Not implemented: add simulation scenario for {{uc_id}}");
+}
+
+runProbe().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/templates/universal/claude-md-blocks/layer-navigation.md

@@ -0,0 +1,20 @@
+## Layer Navigation Protocol
+
+ForgeCraft tracks automation depth across four active layers. Before beginning
+implementation work, call `layer_status` to understand the current state.
+
+| Layer | What it means | How to advance |
+|---|---|---|
+| **L1 Blueprint** | Use case documented + implementation + tests | Write formal UC, implement, add tests |
+| **L2 Harness** | Use case has executable probe in `.forgecraft/harness/` | Create `uc-NNN.yaml` with probe definitions |
+| **L3 Environment** | All infra state derivable from spec | Add CI, Dockerfile, env schema to spec |
+| **L4 Monitoring** | Runtime drift evaluated against spec | Add health probes, drift detection config |
+
+**Layer completion is a spec gap, not a todo list.** A missing L2 probe is not
+something to schedule — it is an incomplete grammar. The gate fires until the probe exists.
+
+**L2 probe types available**: `mcp_call`, `playwright`, `api_call`, `db_query`,
+`file_system`, `headless_sim`
+
+**To add a probe**: create `.forgecraft/harness/uc-NNN.yaml` following the format
+in any existing probe file. One probe is enough to move a UC from ❌ to ✅.

package/templates/universal/claude-md-blocks/nfr-contracts.md

@@ -0,0 +1,22 @@
+## Non-Functional Requirement Contracts
+
+Declare SLA and throughput obligations as measurable assertions.
+Aspirations ("should be fast") are not contracts. Each row is machine-checkable.
+
+<!-- Fill in actual values before pre-release. -->
+
+| Operation | P99 Latency | Max Latency | Throughput | Notes |
+|---|---|---|---|---|
+| [Primary read] | ≤ __ms | ≤ __ms | __ RPS | |
+| [Primary write] | ≤ __ms | ≤ __ms | __ RPS | |
+| [Background job] | — | ≤ __s | — | Async |
+
+## Availability
+- Uptime SLA: __% (e.g., 99.9%)
+- Max planned downtime per month: __ minutes
+
+## Correctness Constraints
+- [List idempotency, determinism, or monotonicity requirements]
+
+**Verification**: Load tests in `tests/harness/` must assert these bounds.
+Gate: `nfr-contracts-required` fires until this file has measurable values.