@cluesmith/codev 1.6.1 → 2.0.0-rc.1

package/dist/commands/pcheck/index.js

@@ -0,0 +1,249 @@
+/**
+ * codev pcheck - Protocol Check command
+ *
+ * Evaluate declarative protocol checks defined in checks.yaml files.
+ * Supports semantic (LLM-based) evaluation for human-written content.
+ */
+import chalk from 'chalk';
+import { loadChecksFile, detectProtocol, listChecksAndGates, getAvailableProtocols } from './parser.js';
+import { evaluateCheck } from './evaluator.js';
+/**
+ * Print a check result with colored status
+ */
+function printCheckResult(result) {
+    const icon = result.pass
+        ? chalk.green('✓')
+        : chalk.red('✗');
+    const cached = result.cached ? chalk.dim(' (cached)') : '';
+    const duration = result.duration_ms ? chalk.dim(` ${result.duration_ms}ms`) : '';
+    console.log(`${icon} ${result.id.padEnd(28)} ${result.description}${cached}${duration}`);
+}
+/**
+ * Print detailed reasoning if verbose mode
+ */
+function printReasoning(result, verbose) {
+    if (verbose && result.reasoning) {
+        const lines = result.reasoning.split('\n');
+        for (const line of lines) {
+            console.log(chalk.dim(`   ${line}`));
+        }
+    }
+}
+/**
+ * Evaluate a gate, including resolving nested gates
+ */
+async function evaluateGate(gateId, checksFile, context, evaluated = new Set()) {
+    const gate = checksFile.gates[gateId];
+    if (!gate) {
+        return {
+            id: gateId,
+            pass: false,
+            description: 'Unknown gate',
+            checks: [],
+            guidance: `Gate '${gateId}' not found`,
+        };
+    }
+    const results = [];
+    let allPass = true;
+    for (const itemId of gate.all) {
+        // Check if this is a gate reference
+        if (checksFile.gates[itemId]) {
+            // Prevent infinite recursion
+            if (evaluated.has(itemId)) {
+                continue;
+            }
+            evaluated.add(itemId);
+            // Recursively evaluate the nested gate
+            const nestedResult = await evaluateGate(itemId, checksFile, context, evaluated);
+            results.push(...nestedResult.checks);
+            allPass = allPass && nestedResult.pass;
+        }
+        else if (checksFile.checks[itemId]) {
+            // It's a check
+            const check = checksFile.checks[itemId];
+            const result = await evaluateCheck(itemId, check, { project: context.project, verbose: context.verbose }, !context.noCache);
+            results.push(result);
+            allPass = allPass && result.pass;
+        }
+        else {
+            // Unknown item
+            results.push({
+                id: itemId,
+                pass: false,
+                description: 'Unknown check or gate',
+                reasoning: `'${itemId}' not found in checks or gates`,
+            });
+            allPass = false;
+        }
+    }
+    // Determine guidance
+    const guidance = allPass
+        ? gate.guidance?.pass?.replace(/\{project\}/g, context.project)
+        : gate.guidance?.fail?.replace(/\{project\}/g, context.project);
+    return {
+        id: gateId,
+        pass: allPass,
+        description: gate.description,
+        checks: results,
+        guidance,
+    };
+}
+/**
+ * Determine the next action based on current gate states
+ */
+async function determineNextAction(checksFile, context) {
+    // Evaluate gates in order of progression
+    const gateOrder = ['spec_ready', 'plan_ready', 'pr_ready'];
+    const gateStatus = new Map();
+    for (const gateId of gateOrder) {
+        if (checksFile.gates[gateId]) {
+            const result = await evaluateGate(gateId, checksFile, context);
+            gateStatus.set(gateId, result.pass);
+            // If this gate fails, provide guidance
+            if (!result.pass) {
+                // Find the first failing check
+                const failingCheck = result.checks.find(c => !c.pass);
+                if (failingCheck) {
+                    const check = checksFile.checks[failingCheck.id];
+                    if (check) {
+                        return formatNextAction(gateId, failingCheck, check, context);
+                    }
+                }
+                return result.guidance ?? 'Fix failing checks';
+            }
+        }
+    }
+    return 'All gates pass! Ready to proceed.';
+}
+/**
+ * Format a detailed next action message
+ */
+function formatNextAction(gateId, failingCheck, check, context) {
+    let action = `Current state: `;
+    // Show gate status
+    const gateOrder = ['spec_ready', 'plan_ready', 'pr_ready'];
+    const statusParts = [];
+    for (const g of gateOrder) {
+        if (g === gateId) {
+            statusParts.push(`${g} ✗`);
+            break;
+        }
+        else {
+            statusParts.push(`${g} ✓`);
+        }
+    }
+    action += statusParts.join(', ') + '\n\n';
+    action += `Next action: ${failingCheck.description}\n`;
+    // Provide specific guidance based on check type
+    if (check.type === 'file_exists') {
+        const pattern = check.pattern.replace(/\{project\}/g, context.project);
+        action += `  Create: ${pattern}\n`;
+    }
+    else if (check.type === 'llm_check') {
+        const file = check.file ?? check.files?.[0] ?? '';
+        const pattern = file.replace(/\{project\}/g, context.project);
+        action += `  Edit: ${pattern}\n`;
+        action += `  Ensure: ${check.question}\n`;
+    }
+    else if (check.type === 'command') {
+        action += `  Run: ${check.run}\n`;
+        action += `  Fix any issues and retry\n`;
+    }
+    return action;
+}
+/**
+ * List all available checks and gates
+ */
+function handleList(protocol) {
+    const { checks, gates } = listChecksAndGates(protocol);
+    console.log(`Protocol: ${chalk.cyan(protocol)}\n`);
+    console.log(chalk.bold('Checks:'));
+    for (const [id, desc] of Object.entries(checks)) {
+        console.log(`  ${id.padEnd(28)} ${chalk.dim(desc)}`);
+    }
+    console.log('');
+    console.log(chalk.bold('Gates:'));
+    for (const [id, desc] of Object.entries(gates)) {
+        console.log(`  ${id.padEnd(28)} ${chalk.dim(desc)}`);
+    }
+}
+/**
+ * Main pcheck command
+ */
+export async function pcheck(target, options) {
+    // Handle --list
+    if (options.list || target === 'list') {
+        const protocol = options.protocol ?? 'spider';
+        handleList(protocol);
+        return 0;
+    }
+    // Require project for check operations
+    if (!options.project) {
+        console.error(chalk.red('Error: --project is required'));
+        console.error('Usage: codev pcheck <gate> --project <id>');
+        return 1;
+    }
+    // Detect or use specified protocol
+    const protocol = options.protocol ?? detectProtocol(options.project);
+    // Load checks file
+    const checksFile = loadChecksFile(protocol);
+    if (!checksFile) {
+        console.error(chalk.red(`Error: No checks.yaml found for protocol '${protocol}'`));
+        console.error(`Available protocols: ${getAvailableProtocols().join(', ')}`);
+        return 1;
+    }
+    const context = {
+        project: options.project,
+        verbose: options.verbose,
+        noCache: options.noCache,
+    };
+    // Handle --next
+    if (options.next) {
+        const nextAction = await determineNextAction(checksFile, context);
+        console.log(nextAction);
+        return 0;
+    }
+    // Evaluate specific gate or check
+    if (!target) {
+        console.error(chalk.red('Error: Specify a gate or check to evaluate'));
+        console.error('Usage: codev pcheck <gate> --project <id>');
+        console.error('   or: codev pcheck --list');
+        console.error('   or: codev pcheck --next --project <id>');
+        return 1;
+    }
+    // Check if target is a gate or individual check
+    if (checksFile.gates[target]) {
+        const result = await evaluateGate(target, checksFile, context);
+        console.log(`Checking gate: ${chalk.cyan(target)} (${result.description})\n`);
+        for (const checkResult of result.checks) {
+            printCheckResult(checkResult);
+            printReasoning(checkResult, !!options.verbose);
+        }
+        console.log('');
+        if (result.pass) {
+            console.log(chalk.green('PASSED') + `: All checks passed`);
+        }
+        else {
+            const failCount = result.checks.filter(c => !c.pass).length;
+            console.log(chalk.red('BLOCKED') + `: ${failCount} check${failCount > 1 ? 's' : ''} failed`);
+        }
+        if (result.guidance) {
+            console.log(`\nGuidance: ${result.guidance}`);
+        }
+        return result.pass ? 0 : 1;
+    }
+    else if (checksFile.checks[target]) {
+        // Individual check
+        const check = checksFile.checks[target];
+        const result = await evaluateCheck(target, check, context, !options.noCache);
+        printCheckResult(result);
+        printReasoning(result, true); // Always show reasoning for individual checks
+        return result.pass ? 0 : 1;
+    }
+    else {
+        console.error(chalk.red(`Error: Unknown gate or check '${target}'`));
+        console.error(`Run 'codev pcheck --list' to see available checks and gates`);
+        return 1;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/pcheck/index.js.map

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

package/dist/commands/pcheck/parser.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Parser for checks.yaml protocol definition files
+ */
+import type { ChecksFile, Check, EvaluationContext } from './types.js';
+/**
+ * Load a checks.yaml file from a protocol directory
+ */
+export declare function loadChecksFile(protocol: string): ChecksFile | null;
+/**
+ * Detect the protocol for a given project
+ * Looks at the spec file to determine which protocol to use
+ */
+export declare function detectProtocol(projectId: string): string;
+/**
+ * Expand a pattern with context variables
+ * Replaces {project} with the actual project ID
+ */
+export declare function expandPattern(pattern: string, context: EvaluationContext): string;
+/**
+ * Find the actual file matching a pattern
+ */
+export declare function resolveFile(pattern: string, context: EvaluationContext): string | null;
+/**
+ * Resolve all files for a check
+ * Handles both single file and files array
+ */
+export declare function resolveFiles(check: Check, context: EvaluationContext): string[];
+/**
+ * Get all available protocols with checks.yaml files
+ */
+export declare function getAvailableProtocols(): string[];
+/**
+ * List all checks and gates in a protocol
+ */
+export declare function listChecksAndGates(protocol: string): {
+    checks: Record<string, string>;
+    gates: Record<string, string>;
+};
+//# sourceMappingURL=parser.d.ts.map

package/dist/commands/pcheck/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/commands/pcheck/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAQ,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAgB7E;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA2BlE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAwBxD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAItF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAW/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAiChD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAiBtH"}

package/dist/commands/pcheck/parser.js

@@ -0,0 +1,155 @@
+/**
+ * Parser for checks.yaml protocol definition files
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { glob } from 'glob';
+/**
+ * Find the codev directory in the current project
+ */
+function findCodevDir(startDir = process.cwd()) {
+    let dir = startDir;
+    while (dir !== '/') {
+        if (existsSync(join(dir, 'codev'))) {
+            return join(dir, 'codev');
+        }
+        dir = dirname(dir);
+    }
+    return null;
+}
+/**
+ * Load a checks.yaml file from a protocol directory
+ */
+export function loadChecksFile(protocol) {
+    const codevDir = findCodevDir();
+    if (!codevDir) {
+        return null;
+    }
+    // Try both codev/protocols/ and codev-skeleton/protocols/
+    const possiblePaths = [
+        join(codevDir, 'protocols', protocol, 'checks.yaml'),
+        join(dirname(codevDir), 'codev-skeleton', 'protocols', protocol, 'checks.yaml'),
+    ];
+    for (const checksPath of possiblePaths) {
+        if (existsSync(checksPath)) {
+            const content = readFileSync(checksPath, 'utf-8');
+            const parsed = parseYaml(content);
+            // Validate structure
+            if (!parsed.checks || !parsed.gates) {
+                throw new Error(`Invalid checks.yaml: missing 'checks' or 'gates' section in ${checksPath}`);
+            }
+            return parsed;
+        }
+    }
+    return null;
+}
+/**
+ * Detect the protocol for a given project
+ * Looks at the spec file to determine which protocol to use
+ */
+export function detectProtocol(projectId) {
+    const codevDir = findCodevDir();
+    if (!codevDir) {
+        return 'spider'; // Default
+    }
+    // Try to find the spec file
+    const specPattern = join(codevDir, 'specs', `${projectId}-*.md`);
+    const specFiles = glob.sync(specPattern);
+    if (specFiles.length === 0) {
+        return 'spider'; // Default
+    }
+    // Read the spec and look for protocol declaration
+    const specContent = readFileSync(specFiles[0], 'utf-8');
+    // Look for **Protocol**: TICK/SPIDER/BUGFIX pattern
+    const protocolMatch = specContent.match(/\*\*Protocol\*\*:\s*(\w+)/i);
+    if (protocolMatch) {
+        return protocolMatch[1].toLowerCase();
+    }
+    return 'spider'; // Default
+}
+/**
+ * Expand a pattern with context variables
+ * Replaces {project} with the actual project ID
+ */
+export function expandPattern(pattern, context) {
+    return pattern.replace(/\{project\}/g, context.project);
+}
+/**
+ * Find the actual file matching a pattern
+ */
+export function resolveFile(pattern, context) {
+    const expanded = expandPattern(pattern, context);
+    const matches = glob.sync(expanded);
+    return matches.length > 0 ? matches[0] : null;
+}
+/**
+ * Resolve all files for a check
+ * Handles both single file and files array
+ */
+export function resolveFiles(check, context) {
+    if (check.type === 'llm_check') {
+        if (check.files) {
+            return check.files.map(f => expandPattern(f, context));
+        }
+        else if (check.file) {
+            return [expandPattern(check.file, context)];
+        }
+    }
+    else if (check.type === 'file_exists' || check.type === 'file_not_exists') {
+        return [expandPattern(check.pattern, context)];
+    }
+    return [];
+}
+/**
+ * Get all available protocols with checks.yaml files
+ */
+export function getAvailableProtocols() {
+    const codevDir = findCodevDir();
+    if (!codevDir) {
+        return [];
+    }
+    const protocols = [];
+    // Check codev/protocols/
+    const protocolsDir = join(codevDir, 'protocols');
+    if (existsSync(protocolsDir)) {
+        const entries = glob.sync(join(protocolsDir, '*/checks.yaml'));
+        for (const entry of entries) {
+            const protocol = dirname(entry).split('/').pop();
+            if (protocol) {
+                protocols.push(protocol);
+            }
+        }
+    }
+    // Check codev-skeleton/protocols/
+    const skeletonDir = join(dirname(codevDir), 'codev-skeleton', 'protocols');
+    if (existsSync(skeletonDir)) {
+        const entries = glob.sync(join(skeletonDir, '*/checks.yaml'));
+        for (const entry of entries) {
+            const protocol = dirname(entry).split('/').pop();
+            if (protocol && !protocols.includes(protocol)) {
+                protocols.push(protocol);
+            }
+        }
+    }
+    return protocols;
+}
+/**
+ * List all checks and gates in a protocol
+ */
+export function listChecksAndGates(protocol) {
+    const checksFile = loadChecksFile(protocol);
+    if (!checksFile) {
+        return { checks: {}, gates: {} };
+    }
+    const checks = {};
+    for (const [id, check] of Object.entries(checksFile.checks)) {
+        checks[id] = check.description;
+    }
+    const gates = {};
+    for (const [id, gate] of Object.entries(checksFile.gates)) {
+        gates[id] = gate.description;
+    }
+    return { checks, gates };
+}
+//# sourceMappingURL=parser.js.map

package/dist/commands/pcheck/parser.js.map

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

package/dist/commands/pcheck/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Type definitions for pcheck - Protocol Check command
+ */
+export type CheckType = 'file_exists' | 'file_not_exists' | 'llm_check' | 'command';
+export interface BaseCheck {
+    type: CheckType;
+    description: string;
+}
+export interface FileExistsCheck extends BaseCheck {
+    type: 'file_exists';
+    pattern: string;
+}
+export interface FileNotExistsCheck extends BaseCheck {
+    type: 'file_not_exists';
+    pattern: string;
+}
+export interface LlmCheck extends BaseCheck {
+    type: 'llm_check';
+    file?: string;
+    files?: string[];
+    question: string;
+    expect?: boolean;
+}
+export interface CommandCheck extends BaseCheck {
+    type: 'command';
+    run: string;
+    exit_code?: number;
+    stdout?: string;
+}
+export type Check = FileExistsCheck | FileNotExistsCheck | LlmCheck | CommandCheck;
+export interface Gate {
+    description: string;
+    all: string[];
+    guidance?: {
+        pass: string;
+        fail: string;
+    };
+}
+export interface ChecksFile {
+    checks: Record<string, Check>;
+    gates: Record<string, Gate>;
+}
+export interface CheckResult {
+    id: string;
+    pass: boolean;
+    description: string;
+    reasoning?: string;
+    cached?: boolean;
+    duration_ms?: number;
+}
+export interface GateResult {
+    id: string;
+    pass: boolean;
+    description: string;
+    checks: CheckResult[];
+    guidance?: string;
+}
+export interface EvaluationContext {
+    project: string;
+    protocol?: string;
+    verbose?: boolean;
+}
+export interface CacheEntry {
+    checkId: string;
+    contentHash: string;
+    pass: boolean;
+    reasoning?: string;
+    timestamp: number;
+}
+export interface CacheFile {
+    version: number;
+    entries: Record<string, CacheEntry>;
+}
+export interface PcheckOptions {
+    project?: string;
+    list?: boolean;
+    next?: boolean;
+    protocol?: string;
+    verbose?: boolean;
+    noCache?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/pcheck/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/pcheck/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAAC;AAGpF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,kBAAmB,SAAQ,SAAS;IACnD,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,QAAS,SAAQ,SAAS;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAGD,MAAM,WAAW,YAAa,SAAQ,SAAS;IAC7C,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,MAAM,KAAK,GAAG,eAAe,GAAG,kBAAkB,GAAG,QAAQ,GAAG,YAAY,CAAC;AAGnF,MAAM,WAAW,IAAI;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAGD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;CAC7B;AAGD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAGD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACrC;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/commands/pcheck/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for pcheck - Protocol Check command
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/pcheck/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/pcheck/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/commands/porch/checks.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Defense Checks
+ *
+ * Runs build/test commands defined in protocol phases.
+ * Supports retry logic and configurable failure behavior.
+ */
+import type { Check, Phase } from './types.js';
+/**
+ * Result of a single check
+ */
+export interface CheckResult {
+    name: string;
+    success: boolean;
+    output: string;
+    error?: string;
+    attempts: number;
+    duration: number;
+}
+/**
+ * Result of running all checks for a phase
+ */
+export interface ChecksResult {
+    success: boolean;
+    checks: CheckResult[];
+    returnTo?: string;
+}
+/**
+ * Run all checks for a phase
+ */
+export declare function runPhaseChecks(phase: Phase, options?: {
+    cwd?: string;
+    dryRun?: boolean;
+}): Promise<ChecksResult>;
+/**
+ * Create default checks for common phases
+ */
+export declare function getDefaultChecks(phaseName: string): Record<string, Check>;
+/**
+ * Format check results for display
+ */
+export declare function formatCheckResults(results: ChecksResult): string;
+//# sourceMappingURL=checks.d.ts.map

package/dist/commands/porch/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../src/commands/porch/checks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+HD;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,GACL,OAAO,CAAC,YAAY,CAAC,CA6CvB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAqBzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAuBhE"}