@schilling.mark.a/atdd-guardian 1.0.0

package/dist/services/rule-loader.js

@@ -0,0 +1,91 @@
+/**
+ * Rule Loader Service
+ *
+ * Loads review rules from JSON config files.
+ * Supports loading from a default bundled ruleset
+ * or from a team's custom rules file.
+ */
+import { readFile } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** Path to the bundled default rules */
+const DEFAULT_RULES_PATH = join(__dirname, "..", "rules", "team-standards.json");
+/**
+ * Load rules from a JSON file path.
+ * Falls back to bundled defaults if no path provided.
+ */
+export async function loadRuleSet(customPath) {
+    const rulesPath = customPath ?? DEFAULT_RULES_PATH;
+    try {
+        const raw = await readFile(rulesPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        // Basic validation
+        if (!parsed.rules || !Array.isArray(parsed.rules)) {
+            throw new Error("Rules file must contain a 'rules' array");
+        }
+        for (const rule of parsed.rules) {
+            validateRule(rule);
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            throw new Error(`Rules file not found: ${rulesPath}. ` +
+                `Create a team-standards.json in your project root or specify a path.`);
+        }
+        throw error;
+    }
+}
+/**
+ * Merge multiple rule sets (e.g., base + team overrides).
+ * Later rules with the same ID override earlier ones.
+ */
+export function mergeRuleSets(...sets) {
+    const ruleMap = new Map();
+    for (const set of sets) {
+        for (const rule of set.rules) {
+            ruleMap.set(rule.id, rule);
+        }
+    }
+    return {
+        name: sets.map((s) => s.name).join(" + "),
+        version: sets[sets.length - 1].version,
+        description: "Merged rule set",
+        rules: Array.from(ruleMap.values()),
+    };
+}
+/**
+ * Validate a single rule has required fields.
+ */
+function validateRule(rule) {
+    const r = rule;
+    const required = [
+        "id",
+        "name",
+        "category",
+        "severity",
+        "description",
+        "matchIsViolation",
+        "appliesTo",
+        "suggestion",
+    ];
+    for (const field of required) {
+        if (r[field] === undefined) {
+            throw new Error(`Rule ${r["id"] ?? "unknown"} is missing required field: ${field}`);
+        }
+    }
+    // Validate regex compiles if present
+    if (typeof r["pattern"] === "string") {
+        try {
+            new RegExp(r["pattern"]);
+        }
+        catch {
+            throw new Error(`Rule ${r["id"]} has invalid regex pattern: ${r["pattern"]}`);
+        }
+    }
+}
+//# sourceMappingURL=rule-loader.js.map

package/dist/services/rule-loader.js.map

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

package/dist/services/session-manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Session Manager Service
+ *
+ * Persists the active feature context and workflow state
+ * to .atdd-guardian/session.json in the project root.
+ *
+ * This is what makes the reviewer context-aware:
+ * it knows WHAT story you're working on, WHERE you are
+ * in the ATDD workflow, and WHAT the team decided
+ * architecturally — across multiple tool calls.
+ */
+import type { SessionState, FeatureContext, ReviewHistoryEntry, PdcaEntry, AtddPhase, TestRunResult, TddViolationEntry } from "../types.js";
+/**
+ * Load the current session state, or create a blank one.
+ */
+export declare function loadSession(projectRoot: string): Promise<SessionState>;
+/**
+ * Save session state to disk.
+ */
+export declare function saveSession(projectRoot: string, session: SessionState): Promise<void>;
+/**
+ * Start working on a new feature/story.
+ * Sets the active context and resets review history.
+ */
+export declare function startFeature(projectRoot: string, feature: FeatureContext): Promise<SessionState>;
+/**
+ * Update the current ATDD phase.
+ */
+export declare function advancePhase(projectRoot: string, phase: AtddPhase): Promise<SessionState>;
+/**
+ * Record a review result in the session history.
+ */
+export declare function recordReview(projectRoot: string, entry: ReviewHistoryEntry): Promise<void>;
+/**
+ * Add a PDCA log entry.
+ */
+export declare function addPdcaEntry(projectRoot: string, entry: PdcaEntry): Promise<void>;
+/**
+ * Update acceptance criterion test status.
+ */
+export declare function updateCriterionStatus(projectRoot: string, criterionId: string, testStatus: "no-test" | "red" | "green" | "skipped", testFile?: string): Promise<SessionState>;
+/**
+ * Update expected file status.
+ */
+export declare function updateFileStatus(projectRoot: string, filePath: string, status: "planned" | "created" | "modified" | "reviewed"): Promise<SessionState>;
+/**
+ * Mark a DoD item as complete.
+ */
+export declare function completeDodItem(projectRoot: string, dodId: string): Promise<SessionState>;
+/**
+ * Record a new unit TDD cycle starting in RED state.
+ * Enforces PC-1: unit test must exist before production code.
+ */
+export declare function startUnitCycle(projectRoot: string, criterionId: string, cycle: {
+    unitDescription: string;
+    testFile: string;
+    sourceFile: string;
+}): Promise<{
+    session: SessionState;
+    cycleNumber: number;
+}>;
+/**
+ * Advance a unit cycle's state: red → green → refactored.
+ * Enforces strict sequence.
+ */
+export declare function advanceUnitCycle(projectRoot: string, criterionId: string, cycleNumber: number, targetState: "green" | "refactored" | "abandoned", notes?: string): Promise<SessionState>;
+/**
+ * Record a test execution result in the session.
+ */
+export declare function recordTestRun(projectRoot: string, result: TestRunResult): Promise<void>;
+/**
+ * Log a TDD violation detected by the phase gate.
+ */
+export declare function logViolation(projectRoot: string, entry: TddViolationEntry): Promise<void>;
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/services/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/services/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,SAAS,EAGT,aAAa,EACb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AASrB;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAOvB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CASf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,CAAC,CAMvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,EACnD,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GACtD,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC,CAgBvB;AAID;;;GAGG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE;IACL,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA+BzD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,OAAO,GAAG,YAAY,GAAG,WAAW,EACjD,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CAsDvB;AAID;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC,CAQf;AAID;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/services/session-manager.js

@@ -0,0 +1,244 @@
+/**
+ * Session Manager Service
+ *
+ * Persists the active feature context and workflow state
+ * to .atdd-guardian/session.json in the project root.
+ *
+ * This is what makes the reviewer context-aware:
+ * it knows WHAT story you're working on, WHERE you are
+ * in the ATDD workflow, and WHAT the team decided
+ * architecturally — across multiple tool calls.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+const SESSION_DIR = ".atdd-guardian";
+const SESSION_FILE = "session.json";
+function sessionPath(projectRoot) {
+    return join(projectRoot, SESSION_DIR, SESSION_FILE);
+}
+/**
+ * Load the current session state, or create a blank one.
+ */
+export async function loadSession(projectRoot) {
+    try {
+        const raw = await readFile(sessionPath(projectRoot), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return createBlankSession();
+    }
+}
+/**
+ * Save session state to disk.
+ */
+export async function saveSession(projectRoot, session) {
+    const dir = join(projectRoot, SESSION_DIR);
+    await mkdir(dir, { recursive: true });
+    session.updatedAt = new Date().toISOString();
+    await writeFile(sessionPath(projectRoot), JSON.stringify(session, null, 2), "utf-8");
+}
+/**
+ * Start working on a new feature/story.
+ * Sets the active context and resets review history.
+ */
+export async function startFeature(projectRoot, feature) {
+    const session = await loadSession(projectRoot);
+    session.activeFeature = feature;
+    session.reviewHistory = [];
+    await saveSession(projectRoot, session);
+    return session;
+}
+/**
+ * Update the current ATDD phase.
+ */
+export async function advancePhase(projectRoot, phase) {
+    const session = await loadSession(projectRoot);
+    if (!session.activeFeature) {
+        throw new Error("No active feature. Use start_feature first to set the story context.");
+    }
+    session.activeFeature.currentPhase = phase;
+    await saveSession(projectRoot, session);
+    return session;
+}
+/**
+ * Record a review result in the session history.
+ */
+export async function recordReview(projectRoot, entry) {
+    const session = await loadSession(projectRoot);
+    session.reviewHistory.push(entry);
+    await saveSession(projectRoot, session);
+}
+/**
+ * Add a PDCA log entry.
+ */
+export async function addPdcaEntry(projectRoot, entry) {
+    const session = await loadSession(projectRoot);
+    session.pdcaLog.push(entry);
+    await saveSession(projectRoot, session);
+}
+/**
+ * Update acceptance criterion test status.
+ */
+export async function updateCriterionStatus(projectRoot, criterionId, testStatus, testFile) {
+    const session = await loadSession(projectRoot);
+    if (!session.activeFeature) {
+        throw new Error("No active feature.");
+    }
+    const criterion = session.activeFeature.acceptanceCriteria.find((ac) => ac.id === criterionId);
+    if (!criterion) {
+        throw new Error(`Criterion '${criterionId}' not found. Available: ${session.activeFeature.acceptanceCriteria.map((ac) => ac.id).join(", ")}`);
+    }
+    criterion.testStatus = testStatus;
+    if (testFile)
+        criterion.testFile = testFile;
+    await saveSession(projectRoot, session);
+    return session;
+}
+/**
+ * Update expected file status.
+ */
+export async function updateFileStatus(projectRoot, filePath, status) {
+    const session = await loadSession(projectRoot);
+    if (!session.activeFeature) {
+        throw new Error("No active feature.");
+    }
+    const file = session.activeFeature.expectedFiles.find((f) => f.path === filePath);
+    if (file) {
+        file.status = status;
+    }
+    else {
+        // Auto-add unexpected files
+        session.activeFeature.expectedFiles.push({
+            path: filePath,
+            purpose: "Auto-detected during development",
+            fileType: "other",
+            status,
+        });
+    }
+    await saveSession(projectRoot, session);
+    return session;
+}
+/**
+ * Mark a DoD item as complete.
+ */
+export async function completeDodItem(projectRoot, dodId) {
+    const session = await loadSession(projectRoot);
+    if (!session.activeFeature) {
+        throw new Error("No active feature.");
+    }
+    const item = session.activeFeature.definitionOfDone.find((d) => d.id === dodId);
+    if (!item) {
+        throw new Error(`DoD item '${dodId}' not found.`);
+    }
+    item.completed = true;
+    await saveSession(projectRoot, session);
+    return session;
+}
+// ─── Unit TDD Cycle Tracking ─────────────────────────────────────
+/**
+ * Record a new unit TDD cycle starting in RED state.
+ * Enforces PC-1: unit test must exist before production code.
+ */
+export async function startUnitCycle(projectRoot, criterionId, cycle) {
+    const session = await loadSession(projectRoot);
+    if (!session.activeFeature) {
+        throw new Error("No active feature.");
+    }
+    const ac = session.activeFeature.acceptanceCriteria.find((a) => a.id === criterionId);
+    if (!ac) {
+        throw new Error(`Criterion '${criterionId}' not found. Available: ${session.activeFeature.acceptanceCriteria.map((a) => a.id).join(", ")}`);
+    }
+    const cycleNumber = ac.unitCycles.length + 1;
+    const newCycle = {
+        cycleNumber,
+        unitDescription: cycle.unitDescription,
+        testFile: cycle.testFile,
+        sourceFile: cycle.sourceFile,
+        state: "red",
+        timestamps: {
+            redAt: new Date().toISOString(),
+        },
+    };
+    ac.unitCycles.push(newCycle);
+    await saveSession(projectRoot, session);
+    return { session, cycleNumber };
+}
+/**
+ * Advance a unit cycle's state: red → green → refactored.
+ * Enforces strict sequence.
+ */
+export async function advanceUnitCycle(projectRoot, criterionId, cycleNumber, targetState, notes) {
+    const session = await loadSession(projectRoot);
+    if (!session.activeFeature) {
+        throw new Error("No active feature.");
+    }
+    const ac = session.activeFeature.acceptanceCriteria.find((a) => a.id === criterionId);
+    if (!ac) {
+        throw new Error(`Criterion '${criterionId}' not found.`);
+    }
+    const cycle = ac.unitCycles.find((u) => u.cycleNumber === cycleNumber);
+    if (!cycle) {
+        throw new Error(`Unit cycle #${cycleNumber} not found in ${criterionId}. ` +
+            `Available: ${ac.unitCycles.map((u) => u.cycleNumber).join(", ")}`);
+    }
+    // Enforce state machine: red → green → refactored
+    const validTransitions = {
+        red: ["green", "abandoned"],
+        green: ["refactored", "abandoned"],
+        refactored: [],
+        abandoned: [],
+    };
+    const valid = validTransitions[cycle.state] ?? [];
+    if (!valid.includes(targetState)) {
+        throw new Error(`Cannot transition unit cycle from '${cycle.state}' to '${targetState}'. ` +
+            `Valid transitions: ${valid.join(", ") || "none (cycle is complete)"}.`);
+    }
+    cycle.state = targetState;
+    switch (targetState) {
+        case "green":
+            cycle.timestamps.greenAt = new Date().toISOString();
+            break;
+        case "refactored":
+            cycle.timestamps.refactoredAt = new Date().toISOString();
+            cycle.refactorNotes = notes;
+            break;
+        case "abandoned":
+            cycle.refactorNotes = notes ?? "Abandoned without reason";
+            break;
+    }
+    await saveSession(projectRoot, session);
+    return session;
+}
+// ─── Test Run Recording ──────────────────────────────────────────
+/**
+ * Record a test execution result in the session.
+ */
+export async function recordTestRun(projectRoot, result) {
+    const session = await loadSession(projectRoot);
+    session.testRunHistory.push(result);
+    // Keep last 50 runs to avoid unbounded growth
+    if (session.testRunHistory.length > 50) {
+        session.testRunHistory = session.testRunHistory.slice(-50);
+    }
+    await saveSession(projectRoot, session);
+}
+// ─── Violation Logging ───────────────────────────────────────────
+/**
+ * Log a TDD violation detected by the phase gate.
+ */
+export async function logViolation(projectRoot, entry) {
+    const session = await loadSession(projectRoot);
+    session.violationLog.push(entry);
+    await saveSession(projectRoot, session);
+}
+function createBlankSession() {
+    return {
+        activeFeature: null,
+        reviewHistory: [],
+        pdcaLog: [],
+        testRunHistory: [],
+        violationLog: [],
+        updatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/services/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../src/services/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAajC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AACrC,MAAM,YAAY,GAAG,cAAc,CAAC;AAEpC,SAAS,WAAW,CAAC,WAAmB;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAAqB;IAErB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,SAAS,CACb,WAAW,CAAC,WAAW,CAAC,EACxB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAChC,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,OAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC;IAChC,OAAO,CAAC,aAAa,GAAG,EAAE,CAAC;IAC3B,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,KAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,aAAa,CAAC,YAAY,GAAG,KAAK,CAAC;IAC3C,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,KAAyB;IAEzB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,KAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,WAAmB,EACnB,UAAmD,EACnD,QAAiB;IAEjB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAC7D,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,WAAW,CAC9B,CAAC;IACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,cAAc,WAAW,2BAA2B,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7H,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,UAAU,GAAG,UAAU,CAAC;IAClC,IAAI,QAAQ;QAAE,SAAS,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC5C,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,QAAgB,EAChB,MAAuD;IAEvD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CACnD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAC3B,CAAC;IACF,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,4BAA4B;QAC5B,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC;YACvC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,kCAAkC;YAC3C,QAAQ,EAAE,OAAO;YACjB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,KAAa;IAEb,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,IAAI,CACtD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CACtB,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACtB,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oEAAoE;AAEpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAmB,EACnB,WAAmB,EACnB,KAIC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CACtD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAC5B,CAAC;IACF,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CACb,cAAc,WAAW,2BAA2B,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3H,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAiB;QAC7B,WAAW;QACX,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE;YACV,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAChC;KACF,CAAC;IAEF,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,WAAmB,EACnB,WAAmB,EACnB,WAAiD,EACjD,KAAc;IAEd,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CACtD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAC5B,CAAC;IACF,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,cAAc,WAAW,cAAc,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,eAAe,WAAW,iBAAiB,WAAW,IAAI;YACxD,cAAc,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,MAAM,gBAAgB,GAA6B;QACjD,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;QAC3B,KAAK,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;QAClC,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,EAAE;KACd,CAAC;IAEF,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,sCAAsC,KAAK,CAAC,KAAK,SAAS,WAAW,KAAK;YACxE,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,0BAA0B,GAAG,CAC1E,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,GAAG,WAA6B,CAAC;IAE5C,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,KAAK,CAAC,UAAU,CAAC,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACpD,MAAM;QACR,KAAK,YAAY;YACf,KAAK,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACzD,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;YAC5B,MAAM;QACR,KAAK,WAAW;YACd,KAAK,CAAC,aAAa,GAAG,KAAK,IAAI,0BAA0B,CAAC;YAC1D,MAAM;IACV,CAAC;IAED,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oEAAoE;AAEpE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,MAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,8CAA8C;IAC9C,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACvC,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,oEAAoE;AAEpE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,KAAwB;IAExB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;QACX,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/services/test-runner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Test Runner Service
+ *
+ * Executes test commands and captures structured results.
+ * Implements TI-1 from the ATDD requirements:
+ *   - Support for Playwright at acceptance level
+ *   - Support for unit testing frameworks (Jest, Vitest, etc.)
+ *   - Automated test execution and result capture
+ *
+ * This service runs the actual test commands and parses
+ * their output into structured TestRunResult entries
+ * that feed into the session state and phase gate checks.
+ */
+import type { TestRunResult, AtddPhase } from "../types.js";
+/**
+ * Test commands loaded from a project config file or defaults.
+ * Lives in .atdd-guardian/test-config.json or is provided per-call.
+ */
+export interface TestConfig {
+    /** Command to run all tests */
+    allTests: string;
+    /** Command to run acceptance/e2e tests only */
+    acceptanceTests: string;
+    /** Command to run unit tests only */
+    unitTests: string;
+    /** Command to run a specific test file */
+    singleFilePattern: string;
+    /** Working directory (defaults to project root) */
+    cwd?: string;
+    /** Timeout in milliseconds */
+    timeoutMs?: number;
+}
+/**
+ * Load test config from the project, or return defaults.
+ */
+export declare function loadTestConfig(projectRoot: string): Promise<TestConfig>;
+/**
+ * Run a test command and capture structured results.
+ */
+export declare function runTests(projectRoot: string, testLevel: "acceptance" | "unit" | "all", phase: AtddPhase, options?: {
+    /** Override the command to run */
+    command?: string;
+    /** Specific file to test */
+    testFile?: string;
+    /** Related AC id for traceability */
+    relatedCriterionId?: string;
+    /** Related unit cycle number */
+    relatedUnitCycle?: number;
+    /** Custom config */
+    config?: TestConfig;
+}): Promise<TestRunResult>;
+export declare function formatTestResult(result: TestRunResult): string;
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/services/test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../src/services/test-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAY5D;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD;;GAEG;AACH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CASrB;AAID;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,YAAY,GAAG,MAAM,GAAG,KAAK,EACxC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IACP,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CAChB,GACL,OAAO,CAAC,aAAa,CAAC,CAmGxB;AA+DD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAqB9D"}