forgecraft-mcp 1.4.0 → 1.7.0

package/dist/tools/layer-status.d.ts

@@ -0,0 +1,126 @@
+/**
+ * layer_status tool handler.
+ *
+ * Reports L1–L4 completion per use case by reading docs/use-cases.md
+ * and scanning for harness probes, infra config, and monitoring artifacts.
+ * Works on any project with docs/use-cases.md — does not require forgecraft.yaml.
+ */
+import { z } from "zod";
+import type { ToolResult } from "../shared/types.js";
+import { type L1GateViolation } from "./layer-status-gates.js";
+export type { L1GateViolation };
+export interface HarnessRunSummary {
+    readonly probeFilesFound: number;
+    readonly lastRunTimestamp: string | null;
+}
+/**
+ * Check tests/harness/ and .forgecraft/harness-run.json for probe file count
+ * and last run timestamp.
+ */
+export declare function buildHarnessRunSummary(projectDir: string): HarnessRunSummary;
+export declare const layerStatusSchema: z.ZodObject<{
+    project_dir: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    project_dir: string;
+}, {
+    project_dir: string;
+}>;
+export type LayerStatusInput = z.infer<typeof layerStatusSchema>;
+export interface UcRecord {
+    readonly id: string;
+    readonly title: string;
+}
+export interface UcL1Status extends UcRecord {
+    readonly documented: true;
+    readonly testsFound: boolean;
+}
+export interface UcL2Status extends UcRecord {
+    readonly hasProbe: boolean;
+    readonly probeTypes: ReadonlyArray<string>;
+    /** true if tests/harness/uc-NNN-happy.* exists */
+    readonly hasHappyProbe: boolean;
+    /** count of tests/harness/uc-NNN-error-*.* files */
+    readonly errorProbeCount: number;
+    /** last run status from harness-run.json, or null if not run */
+    readonly lastRunStatus: string | null;
+}
+export type L3Status = "not-started" | "partial" | "complete";
+export type L4Status = "not-started" | "partial" | "complete";
+export interface LayerReport {
+    readonly projectName: string;
+    readonly projectDir?: string;
+    readonly generatedAt: string;
+    readonly ucs: ReadonlyArray<UcRecord>;
+    readonly l1: ReadonlyArray<UcL1Status>;
+    readonly l2: ReadonlyArray<UcL2Status>;
+    readonly l3: L3Status;
+    readonly l3Checks: Readonly<Record<string, boolean>>;
+    readonly l4: L4Status;
+    readonly l4Checks: Readonly<Record<string, boolean>>;
+    /** Active L1 gate violations detected from .forgecraft/gates/active/ */
+    readonly l1GateViolations: ReadonlyArray<L1GateViolation>;
+    /** Evidence from .forgecraft/env-probe-run.json, or null if not run */
+    readonly envProbeEvidence: {
+        passed: number;
+        failed: number;
+        timestamp: string;
+    } | null;
+    /** Evidence from .forgecraft/slo-probe-run.json, or null if not run */
+    readonly sloProbeEvidence: {
+        passed: number;
+        failed: number;
+        timestamp: string;
+    } | null;
+}
+/**
+ * Parse use case records from docs/use-cases.md content.
+ * Extracts UC-NNN id and title from `## UC-NNN: Title` headers.
+ */
+export declare function parseUseCases(content: string): UcRecord[];
+/**
+ * Build L1 status for all parsed use cases.
+ * L1 = UC is documented. Test coverage is surfaced as a sub-check.
+ */
+export declare function buildL1Status(projectDir: string, ucs: ReadonlyArray<UcRecord>): UcL1Status[];
+/**
+ * Build L2 status for all use cases.
+ * L2 = .forgecraft/harness/uc-NNN.yaml exists.
+ */
+export declare function buildL2Status(projectDir: string, ucs: ReadonlyArray<UcRecord>): UcL2Status[];
+/**
+ * Evaluate L3 (environment/infrastructure) readiness.
+ */
+export declare function buildL3Status(projectDir: string): {
+    status: L3Status;
+    checks: Record<string, boolean>;
+    envProbeEvidence: {
+        passed: number;
+        failed: number;
+        timestamp: string;
+    } | null;
+};
+/**
+ * Evaluate L4 (self-monitoring/drift detection) readiness.
+ */
+export declare function buildL4Status(projectDir: string): {
+    status: L4Status;
+    checks: Record<string, boolean>;
+    sloProbeEvidence: {
+        passed: number;
+        failed: number;
+        timestamp: string;
+    } | null;
+};
+export declare function buildLayerReport(projectDir: string): LayerReport;
+/**
+ * Format a LayerReport as a human-readable markdown block.
+ */
+export declare function formatLayerReport(report: LayerReport): string;
+/**
+ * Handler for the layer_status action.
+ *
+ * @param args - Validated input with project_dir
+ * @returns MCP-style tool result with formatted layer report
+ */
+export declare function layerStatusHandler(args: LayerStatusInput): Promise<ToolResult>;
+//# sourceMappingURL=layer-status.d.ts.map

package/dist/tools/layer-status.d.ts.map

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