forgecraft-mcp 1.3.2 → 1.6.1

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

@@ -44,6 +44,15 @@ export interface ProjectToolsConfig {
     /** Layer boundary check. e.g. "npx madge --circular src/" or language-equivalent */
     readonly layercheck?: string;
 }
+/**
+ * Environment tier classification.
+ * - dev: local development
+ * - qae: quality assurance / basic performance testing
+ * - lte: load test environment — ephemeral, anonymized prod-like data
+ * - cae: customer acceptance environment — production hypervisor, may hold PII, tracks PRD version
+ * - prd: production
+ */
+export type EnvironmentClass = "dev" | "qae" | "lte" | "cae" | "prd";
 /**
  * Deployment environment configuration for a single environment.
  */
@@ -54,6 +63,37 @@ export interface DeploymentEnvironmentConfig {
     readonly url?: string;
     /** Health check endpoint path. Defaults to "/health". */
     readonly health?: string;
+    /**
+     * Environment tier classification. Drives which quality gates are activated.
+     * dev | qae | lte | cae | prd
+     */
+    readonly class?: EnvironmentClass;
+    /**
+     * Whether this environment can hold real personally identifiable information.
+     * When true: PII logging gate, data masking gate, and audit logging gate are activated.
+     */
+    readonly containsPii?: boolean;
+    /**
+     * Whether this environment is reachable from the public internet.
+     * When true: security headers gate, WAF gate, and CSP gate are activated.
+     */
+    readonly externallyAccessible?: boolean;
+    /**
+     * Whether changes to this environment require a change control document before deploy.
+     * When true: prd-change-control gate is activated.
+     */
+    readonly underChangeControl?: boolean;
+    /**
+     * Whether this environment is ephemeral (must be created and torn down by IaC).
+     * When true: lte-ephemeral-infra gate is activated.
+     * Always true for class: lte.
+     */
+    readonly ephemeral?: boolean;
+    /**
+     * Email relay tier. "test" environments must not use production relay.
+     * "prod" relay is only permitted in cae and prd environments.
+     */
+    readonly smtpRelay?: "test" | "prod";
 }
 /**
  * Load test parameters — stated before the test runs, not after.
@@ -158,6 +198,32 @@ export interface OutputTargetConfig {
 export declare const OUTPUT_TARGET_CONFIGS: Record<OutputTarget, OutputTargetConfig>;
 /** Default output target when none specified. */
 export declare const DEFAULT_OUTPUT_TARGET: OutputTarget;
+/** A single AI-instruction file detected on disk. */
+export interface SentinelFoundFile {
+    /** Path relative to the repo root (POSIX-style separators). */
+    readonly path: string;
+    /** File size in bytes; for directories, the sum of immediate file sizes. */
+    readonly sizeBytes: number;
+}
+/**
+ * Result of scanning a repo for existing AI behavioral instruction files
+ * (CLAUDE.md, agents.md, .cursor/rules, etc.).
+ *
+ * Used to gate writes to instruction files so forgecraft never silently
+ * overwrites a sentinel a human or another tool already established.
+ *
+ * `recommendation` summarises the safe next action:
+ * - `none-found`     no sentinel exists; safe to write fresh
+ * - `map`            exactly one sentinel exists; map / augment it
+ * - `override-required` multiple sentinels exist; caller must opt in explicitly
+ */
+export interface SentinelDetectionResult {
+    /** All matching files, in canonical priority order. */
+    readonly foundFiles: readonly SentinelFoundFile[];
+    /** Highest-priority file present, or null if none. */
+    readonly primaryFile: string | null;
+    readonly recommendation: "map" | "override-required" | "none-found";
+}
 /**
  * Resolve the full output file path for a target relative to project root.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/shared/types/project.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/shared/types/project.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AACjD,eAAO,MAAM,QAAQ,8UA4BX,CAAC;AAEX,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,6CAA6C;AAC7C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAC/B,MAAM,EACN;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAC3C,CAAC;IACF,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CACtC,MAAM,EACN;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAC3C,CAAC;IACF,QAAQ,CAAC,aAAa,EAAE,SAAS,GAAG,EAAE,CAAC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6GAA6G;IAC7G,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,iCAAiC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,6DAA6D;QAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC;QAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE;YACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;YAC1B,sEAAsE;YACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH,CAAC;CACH;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;CACpC;AAED,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CAClD;AAED,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;AAE9D,yEAAyE;AACzE,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAItC,CAAC;AAIX;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wEAOrB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+GAA+G;IAC/G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAwC1E,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,EAAE,YAAuB,CAAC;AAI5D,qDAAqD;AACrD,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,KAAK,GAAG,mBAAmB,GAAG,YAAY,CAAC;CACrE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,MAAM,CAMR"}

package/dist/shared/types/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/shared/types/project.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW;IACX,WAAW;IACX,YAAY;IACZ,KAAK;IACL,eAAe;IACf,IAAI;IACJ,YAAY;IACZ,SAAS;IACT,MAAM;IACN,UAAU;IACV,eAAe;IACf,MAAM;IACN,QAAQ;IACR,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,WAAW;IACX,OAAO;IACP,MAAM;IACN,cAAc;IACd,oBAAoB;IACpB,wBAAwB;IACxB,YAAY;IACZ,MAAM;IACN,UAAU;IACV,MAAM;CACE,CAAC;AA8IX,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,MAAM;IACN,aAAa;IACb,UAAU;CACF,CAAC;AAEX,wEAAwE;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;CACC,CAAC;AAoBX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,aAAa;KAC3B;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,QAAQ;QACrB,eAAe,EAAE,IAAI;KACtB;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,yBAAyB;QACnC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EAAE,gBAAgB;KAC9B;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,UAAU;KACxB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,OAAO;KACrB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,OAAO;KACrB;CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAiB,QAAQ,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,MAAoB;IAEpB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/shared/types/project.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,WAAW;IACX,WAAW;IACX,YAAY;IACZ,KAAK;IACL,eAAe;IACf,IAAI;IACJ,YAAY;IACZ,SAAS;IACT,MAAM;IACN,UAAU;IACV,eAAe;IACf,MAAM;IACN,QAAQ;IACR,KAAK;IACL,SAAS;IACT,OAAO;IACP,QAAQ;IACR,WAAW;IACX,OAAO;IACP,MAAM;IACN,cAAc;IACd,oBAAoB;IACpB,wBAAwB;IACxB,YAAY;IACZ,MAAM;IACN,UAAU;IACV,MAAM;CACE,CAAC;AAuLX,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,MAAM;IACN,aAAa;IACb,UAAU;CACF,CAAC;AAEX,wEAAwE;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;CACC,CAAC;AAoBX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAA6C;IAC7E,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,aAAa;KAC3B;IACD,MAAM,EAAE;QACN,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,uBAAuB;QACjC,SAAS,EAAE,eAAe;QAC1B,OAAO,EAAE,qBAAqB;QAC9B,WAAW,EAAE,QAAQ;QACrB,eAAe,EAAE,IAAI;KACtB;IACD,OAAO,EAAE;QACP,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,yBAAyB;QACnC,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,wBAAwB;QACjC,WAAW,EAAE,gBAAgB;KAC9B;IACD,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,UAAU;KACxB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,eAAe;QACxB,WAAW,EAAE,OAAO;KACrB;IACD,KAAK,EAAE;QACL,MAAM,EAAE,OAAO;QACf,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,OAAO;KACrB;CACF,CAAC;AAEF,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAiB,QAAQ,CAAC;AAgC5D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAkB,EAClB,MAAoB;IAEpB,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;AAC5C,CAAC"}

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

@@ -3,11 +3,59 @@
  */
 /** GS property name as defined in §4.3 of the experiment design. */
 export type GsProperty = "self-describing" | "bounded" | "verifiable" | "defended" | "auditable" | "composable" | "executable";
+/**
+ * GS maturity tier — five-level adoption model from the Generative Specification white paper.
+ *
+ * Maps to the 14-point GS scoring scale (7 properties × 0–2):
+ *
+ *   Tier 1 — Unstructured  (0–3):  Prompting only. No persistent artifacts, no discipline.
+ *   Tier 2 — Grounded      (4–6):  Has CLAUDE.md or equivalent ground rules. Basic tests.
+ *   Tier 3 — Specified     (7–10): Full spec artifacts — use-cases, ADRs, bounded architecture.
+ *   Tier 4 — Verified      (11–13): Executable tests passing, CI, audit trail, all properties partial+.
+ *   Tier 5 — Orchestrated  (14):   Perfect score across all 7 properties. Full discipline.
+ *
+ * ForgeCraft detects the current tier on every verify run. Projects can declare a
+ * target tier in forgecraft.yaml (gs_maturity_tier_target) to gate PRs below it.
+ */
+export type GsMaturityTier = 1 | 2 | 3 | 4 | 5;
+/** Tier metadata for display and gating. */
+export interface GsMaturityTierInfo {
+    readonly tier: GsMaturityTier;
+    readonly name: "Unstructured" | "Grounded" | "Specified" | "Verified" | "Orchestrated";
+    readonly scoreRange: readonly [number, number];
+    readonly description: string;
+}
+/** Compute maturity tier from a raw GS total score (0–14). */
+export declare function computeMaturityTier(totalScore: number): GsMaturityTierInfo;
+/**
+ * Reference to a calibration anchor file used to justify a score level.
+ * When `provisional` is true the anchor was missing for this property/level pair.
+ */
+export interface AnchorReference {
+    readonly property: GsProperty;
+    readonly level: 0 | 1 | 2;
+    /** Absolute or relative path to the anchor markdown file (when found). */
+    readonly path?: string;
+    /** Title parsed from the anchor file (when found). */
+    readonly title?: string;
+    /** Repo + commit hash being anchored (when found). */
+    readonly anchoredRepo?: string;
+    /** Specific feature being anchored (when found). */
+    readonly feature?: string;
+    /** Why the anchored example sits at this score level (when found). */
+    readonly rationale?: string;
+    /** What would move it to the next level (when found). */
+    readonly nextLevelDelta?: string;
+}
 /** Score (0–2) for a single GS property with supporting evidence. */
 export interface GsPropertyScore {
     readonly property: GsProperty;
     readonly score: 0 | 1 | 2;
     readonly evidence: string[];
+    /** True when no anchor exists for this property/level pair. */
+    readonly provisional?: boolean;
+    /** Calibration anchor referenced for this score, when available. */
+    readonly anchor?: AnchorReference;
 }
 /** Outcome of executing the project's test suite. */
 export interface TestSuiteResult {
@@ -37,7 +85,9 @@ export interface VerifyResult {
     readonly totalScore: number;
     readonly layerViolations: LayerViolation[];
     readonly missingTestFiles: MissingTestFile[];
-    /** True when tests pass AND totalScore ≥ 10. */
+    /** True when tests pass AND totalScore ≥ pass_threshold. */
     readonly overallPass: boolean;
+    /** GS maturity tier computed from totalScore. */
+    readonly maturityTier: GsMaturityTierInfo;
 }
 //# sourceMappingURL=verify.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/shared/types/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,SAAS,GACT,YAAY,GACZ,UAAU,GACV,WAAW,GACX,YAAY,GACZ,YAAY,CAAC;AAEjB,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,eAAe,EAAE,CAAC;IAC3C,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAC7C,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/shared/types/verify.ts"],"names":[],"mappings":"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"}

package/dist/shared/types/verify.js

@@ -1,5 +1,41 @@
 /**
  * GS verification and scoring types: properties, test suite results, and layer violations.
  */
-export {};
+/** Compute maturity tier from a raw GS total score (0–14). */
+export function computeMaturityTier(totalScore) {
+    if (totalScore >= 14)
+        return {
+            tier: 5,
+            name: "Orchestrated",
+            scoreRange: [14, 14],
+            description: "Perfect GS score — all 7 properties at maximum. Full spec-first discipline.",
+        };
+    if (totalScore >= 11)
+        return {
+            tier: 4,
+            name: "Verified",
+            scoreRange: [11, 13],
+            description: "Executable tests passing, CI configured, audit trail present.",
+        };
+    if (totalScore >= 7)
+        return {
+            tier: 3,
+            name: "Specified",
+            scoreRange: [7, 10],
+            description: "Full spec artifacts: use-cases, ADRs, bounded architecture.",
+        };
+    if (totalScore >= 4)
+        return {
+            tier: 2,
+            name: "Grounded",
+            scoreRange: [4, 6],
+            description: "Ground rules established (CLAUDE.md). Basic test coverage.",
+        };
+    return {
+        tier: 1,
+        name: "Unstructured",
+        scoreRange: [0, 3],
+        description: "Prompting only. No persistent spec artifacts.",
+    };
+}
 //# sourceMappingURL=verify.js.map

package/dist/shared/types/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/shared/types/verify.ts"],"names":[],"mappings":"AAAA;;GAEG"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/shared/types/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAyCH,8DAA8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,IAAI,UAAU,IAAI,EAAE;QAClB,OAAO;YACL,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,cAAc;YACpB,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;YACpB,WAAW,EACT,6EAA6E;SAChF,CAAC;IACJ,IAAI,UAAU,IAAI,EAAE;QAClB,OAAO;YACL,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;YACpB,WAAW,EACT,+DAA+D;SAClE,CAAC;IACJ,IAAI,UAAU,IAAI,CAAC;QACjB,OAAO;YACL,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACnB,WAAW,EACT,6DAA6D;SAChE,CAAC;IACJ,IAAI,UAAU,IAAI,CAAC;QACjB,OAAO;YACL,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAClB,WAAW,EAAE,4DAA4D;SAC1E,CAAC;IACJ,OAAO;QACL,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,cAAc;QACpB,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAClB,WAAW,EAAE,+CAA+C;KAC7D,CAAC;AACJ,CAAC"}

package/dist/tools/advise-session-advisor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Advice generation for the session advisor.
+ *
+ * Converts a ProjectSignals snapshot into a prioritised list of
+ * AdviceItems, then formats them as human-readable markdown.
+ * Plain-English first — GS vocabulary only when the project is configured.
+ */
+import type { ProjectSignals } from "./advise-session-signals.js";
+export interface AdviceItem {
+    readonly priority: "critical" | "high" | "medium" | "low";
+    readonly message: string;
+    readonly action?: string;
+}
+export declare function buildAdviceItems(signals: ProjectSignals, maxItems: number): AdviceItem[];
+export declare function formatAdvice(items: AdviceItem[], recentActivity: string | null): string;
+//# sourceMappingURL=advise-session-advisor.d.ts.map

package/dist/tools/advise-session-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-session-advisor.d.ts","sourceRoot":"","sources":["../../src/tools/advise-session-advisor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAwED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,CAWd;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EAAE,EACnB,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,MAAM,CAaR"}

package/dist/tools/advise-session-advisor.js

@@ -0,0 +1,89 @@
+/**
+ * Advice generation for the session advisor.
+ *
+ * Converts a ProjectSignals snapshot into a prioritised list of
+ * AdviceItems, then formats them as human-readable markdown.
+ * Plain-English first — GS vocabulary only when the project is configured.
+ */
+// ── Priority labels ───────────────────────────────────────────────────
+const LABEL = {
+    critical: "[CRITICAL]",
+    high: "[HIGH]",
+    medium: "[MEDIUM]",
+    low: "[LOW]",
+};
+// ── Advice rules ─────────────────────────────────────────────────────
+function violationItems(signals) {
+    return signals.topViolations.map((msg) => ({
+        priority: "critical",
+        message: `Gate violation: ${msg}`,
+    }));
+}
+function constitutionItem(signals) {
+    if (signals.hasConstitution)
+        return null;
+    return {
+        priority: "high",
+        message: "No AI rules file found (CLAUDE.md / .clinerules / .windsurfrules / copilot-instructions.md / CONVENTIONS.md) — the assistant has no project rules to follow.",
+        action: 'Run forgecraft_actions { action: "setup_project" } to generate the right file for your agent.',
+    };
+}
+function testItem(signals) {
+    if (!signals.hasSourceCode || signals.hasTests)
+        return null;
+    return {
+        priority: "high",
+        message: "No test directory found — bugs accumulate silently without a test suite.",
+        action: "Add a tests/ directory and write at least one test before the next commit.",
+    };
+}
+function schemaItem(signals) {
+    if (!signals.hasSourceCode || signals.hasSchema)
+        return null;
+    return {
+        priority: "medium",
+        message: "No schema artifact found — the system vocabulary (API, DB, events) is implicit.",
+        action: "Add openapi.yaml, prisma/schema.prisma, or docs/schemas/ to make contracts explicit.",
+    };
+}
+function specItem(signals) {
+    if (signals.hasSpec)
+        return null;
+    return {
+        priority: "medium",
+        message: "No spec or PRD found — intent exists only in contributor heads.",
+        action: "Add docs/specs/PRD.md describing what the project does and why.",
+    };
+}
+function greenItem() {
+    return {
+        priority: "low",
+        message: "Project looks healthy — no missing artifacts or active gate violations detected.",
+    };
+}
+// ── Public API ───────────────────────────────────────────────────────
+export function buildAdviceItems(signals, maxItems) {
+    const candidates = [
+        ...violationItems(signals),
+        constitutionItem(signals),
+        testItem(signals),
+        schemaItem(signals),
+        specItem(signals),
+    ].filter((i) => i !== null);
+    if (candidates.length === 0)
+        return [greenItem()];
+    return candidates.slice(0, maxItems);
+}
+export function formatAdvice(items, recentActivity) {
+    const lines = ["## Session Advisor", ""];
+    if (recentActivity) {
+        lines.push(`**Last commit:** ${recentActivity}`, "");
+    }
+    for (const item of items) {
+        lines.push(`${LABEL[item.priority]} ${item.message}`);
+        if (item.action)
+            lines.push(`  → ${item.action}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=advise-session-advisor.js.map

package/dist/tools/advise-session-advisor.js.map

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

package/dist/tools/advise-session-signals.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Project signal reader for the session advisor.
+ *
+ * Reads filesystem state and active gate violations to produce a
+ * ProjectSignals snapshot. Intentionally fast — no git subprocess,
+ * no cascade execution. Used both by the MCP action and the shell hook.
+ */
+export interface ProjectSignals {
+    readonly hasConfig: boolean;
+    readonly hasConstitution: boolean;
+    readonly hasSpec: boolean;
+    readonly hasAdrs: boolean;
+    readonly hasTests: boolean;
+    readonly hasSchema: boolean;
+    readonly hasSourceCode: boolean;
+    readonly activeViolationCount: number;
+    readonly topViolations: readonly string[];
+    readonly recentActivity: string | null;
+}
+export declare function readProjectSignals(projectDir: string): ProjectSignals;
+//# sourceMappingURL=advise-session-signals.d.ts.map

package/dist/tools/advise-session-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-session-signals.d.ts","sourceRoot":"","sources":["../../src/tools/advise-session-signals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AA6FD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAcrE"}

package/dist/tools/advise-session-signals.js

@@ -0,0 +1,113 @@
+/**
+ * Project signal reader for the session advisor.
+ *
+ * Reads filesystem state and active gate violations to produce a
+ * ProjectSignals snapshot. Intentionally fast — no git subprocess,
+ * no cascade execution. Used both by the MCP action and the shell hook.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { readViolationsFile } from "./gate-violations.js";
+// ── Constants ────────────────────────────────────────────────────────
+const SCHEMA_PATHS = [
+    "openapi.yaml",
+    "openapi.yml",
+    "openapi.json",
+    "api-spec.yaml",
+    "api-spec.yml",
+    "api-spec.json",
+    "schema.graphql",
+    "prisma/schema.prisma",
+    "docs/schema.md",
+    "docs/schemas",
+    "src/schema",
+    "src/schemas",
+    "schemas",
+    "database/schema.sql",
+    "db/schema.sql",
+    "db/schema.rb",
+];
+const TEST_DIRS = ["tests", "test", "spec", "__tests__"];
+const SOURCE_FILES = [
+    "package.json",
+    "pyproject.toml",
+    "setup.py",
+    "Cargo.toml",
+    "go.mod",
+];
+const CONSTITUTION_PATHS = [
+    "CLAUDE.md", // Claude Code
+    ".cursor/rules/project-standards.mdc", // Cursor
+    ".github/copilot-instructions.md", // GitHub Copilot
+    ".windsurfrules", // Windsurf
+    ".clinerules", // Cline
+    "CONVENTIONS.md", // Aider
+];
+const SPEC_PATHS = [
+    "docs/specs/PRD.md",
+    "docs/specs/spec.md",
+    "docs/PRD.md",
+    "docs/spec.md",
+    "SPEC.md",
+    "README.md",
+];
+// ── Readers ──────────────────────────────────────────────────────────
+function hasAny(dir, paths) {
+    return paths.some((p) => existsSync(join(dir, p)));
+}
+function hasAdrFiles(dir) {
+    const adrCandidates = [
+        join(dir, "docs", "adrs", "active"),
+        join(dir, "docs", "adrs"),
+    ];
+    for (const adrsDir of adrCandidates) {
+        if (!existsSync(adrsDir))
+            continue;
+        try {
+            const found = readdirSync(adrsDir).some((f) => f.endsWith(".md"));
+            if (found)
+                return true;
+        }
+        catch {
+            // ignore and try next candidate
+        }
+    }
+    return false;
+}
+function readRecentActivity(dir) {
+    try {
+        const subject = execSync("git log --oneline -1 --format=%s", {
+            cwd: dir,
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 2000,
+        })
+            .toString()
+            .trim();
+        return subject.length > 0 ? subject : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readActiveViolations(dir) {
+    const all = readViolationsFile(dir);
+    return all.map((v) => v.message).filter((m) => m.length > 0);
+}
+// ── Public API ───────────────────────────────────────────────────────
+export function readProjectSignals(projectDir) {
+    const violations = readActiveViolations(projectDir);
+    return {
+        hasConfig: existsSync(join(projectDir, "forgecraft.yaml")),
+        hasConstitution: hasAny(projectDir, CONSTITUTION_PATHS),
+        hasSpec: hasAny(projectDir, SPEC_PATHS),
+        hasAdrs: hasAdrFiles(projectDir),
+        hasTests: TEST_DIRS.some((d) => existsSync(join(projectDir, d))),
+        hasSchema: hasAny(projectDir, SCHEMA_PATHS),
+        hasSourceCode: hasAny(projectDir, SOURCE_FILES),
+        activeViolationCount: violations.length,
+        topViolations: violations.slice(0, 3),
+        recentActivity: readRecentActivity(projectDir),
+    };
+}
+//# sourceMappingURL=advise-session-signals.js.map

package/dist/tools/advise-session-signals.js.map

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

package/dist/tools/advise-session.d.ts

@@ -0,0 +1,22 @@
+/**
+ * advise_session — session-start advisor.
+ *
+ * Reads project signals (artifacts, violations, recent git activity) and
+ * returns a short advisory the LLM surfaces to the user at session start.
+ * Works on any project — GS configuration is not required.
+ */
+import { z } from "zod";
+import type { ToolResult } from "../shared/types.js";
+export declare const adviseSessionSchema: z.ZodObject<{
+    project_dir: z.ZodString;
+    max_items: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    project_dir: string;
+    max_items?: number | undefined;
+}, {
+    project_dir: string;
+    max_items?: number | undefined;
+}>;
+export type AdviseSessionInput = z.infer<typeof adviseSessionSchema>;
+export declare function adviseSessionHandler(args: AdviseSessionInput): Promise<ToolResult>;
+//# sourceMappingURL=advise-session.d.ts.map

package/dist/tools/advise-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-session.d.ts","sourceRoot":"","sources":["../../src/tools/advise-session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMrD,eAAO,MAAM,mBAAmB;;;;;;;;;EAY9B,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIrE,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/tools/advise-session.js

@@ -0,0 +1,31 @@
+/**
+ * advise_session — session-start advisor.
+ *
+ * Reads project signals (artifacts, violations, recent git activity) and
+ * returns a short advisory the LLM surfaces to the user at session start.
+ * Works on any project — GS configuration is not required.
+ */
+import { z } from "zod";
+import { readProjectSignals } from "./advise-session-signals.js";
+import { buildAdviceItems, formatAdvice } from "./advise-session-advisor.js";
+// ── Schema ────────────────────────────────────────────────────────────
+export const adviseSessionSchema = z.object({
+    project_dir: z.string().describe("Absolute path to the project root."),
+    max_items: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe("Maximum advice items to return. Default: 5. " +
+        "Agent-agnostic: works with Claude Code, Cursor, Cline, Windsurf, Copilot, Aider — any MCP-capable client."),
+});
+// ── Handler ───────────────────────────────────────────────────────────
+export async function adviseSessionHandler(args) {
+    const { project_dir, max_items = 5 } = args;
+    const signals = readProjectSignals(project_dir);
+    const items = buildAdviceItems(signals, max_items);
+    const text = formatAdvice(items, signals.recentActivity);
+    return { content: [{ type: "text", text }] };
+}
+//# sourceMappingURL=advise-session.js.map

package/dist/tools/advise-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advise-session.js","sourceRoot":"","sources":["../../src/tools/advise-session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE7E,yEAAyE;AAEzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACtE,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CACP,8CAA8C;QAC5C,2GAA2G,CAC9G;CACJ,CAAC,CAAC;AAIH,yEAAyE;AAEzE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAwB;IAExB,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAC5C,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/tools/change-request.d.ts

@@ -0,0 +1,53 @@
+/**
+ * change_request and list_changes handlers.
+ *
+ * change_request: Opens a formal change record in .forgecraft/changes/<slug>.yaml.
+ * Captures intent, auto-detects affected artifacts, and lists gates that must pass.
+ *
+ * list_changes: Surfaces open/implementing/blocked changes with staleness flags.
+ */
+import type { ToolResult } from "../shared/types.js";
+export type ChangeType = "spec-change" | "breaking-api" | "adr-supersession" | "gate-change" | "dependency-update";
+export type ChangeStatus = "open" | "implementing" | "blocked" | "verified" | "closed";
+export interface ChangeRecord {
+    readonly id: string;
+    readonly title: string;
+    readonly status: ChangeStatus;
+    readonly type: ChangeType;
+    readonly created: string;
+    readonly description: string;
+    readonly breaking: boolean;
+    readonly breaking_details?: string;
+    readonly affected_artifacts: string[];
+    readonly supersedes_adr?: string;
+    readonly required_gates: string[];
+    readonly blocked_reason?: string;
+    readonly verified_at?: string;
+    readonly closed_at?: string;
+}
+export interface ChangeRequestInput {
+    readonly project_dir: string;
+    readonly title: string;
+    readonly description: string;
+    readonly type: ChangeType;
+    readonly breaking?: boolean;
+    readonly breaking_details?: string;
+    readonly supersedes_adr?: string;
+    readonly affected_artifacts?: string[];
+}
+export interface ListChangesInput {
+    readonly project_dir: string;
+    readonly status?: ChangeStatus | "all";
+}
+export declare function slugify(title: string, date: string): string;
+export declare function detectAffectedArtifacts(projectDir: string, title: string, description: string, type: ChangeType): string[];
+export declare function detectRequiredGates(projectDir: string, type: ChangeType, breaking: boolean): string[];
+export declare function serializeChangeRecord(record: ChangeRecord): string;
+export declare function parseChangeRecord(content: string, id: string): ChangeRecord | null;
+export declare function changesDir(projectDir: string): string;
+export declare function loadAllChanges(projectDir: string): ChangeRecord[];
+/** Returns changes in implementing status — used by close_cycle gate. */
+export declare function getImplementingChanges(projectDir: string): ChangeRecord[];
+export declare function changeRequestHandler(args: ChangeRequestInput): Promise<ToolResult>;
+export declare function listChangesHandler(args: ListChangesInput): Promise<ToolResult>;
+//# sourceMappingURL=change-request.d.ts.map

package/dist/tools/change-request.d.ts.map

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