@miller-tech/uap 1.0.0

package/dist/cli/completion-gates.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Completion Gates - Programmatic enforcement of mandatory checks
+ *
+ * The UAP protocol defines 3 mandatory gates that must pass before
+ * any task can be considered "done":
+ *
+ * 1. OUTPUT_EXISTS - Verifiable output was produced (files changed, tests written, etc.)
+ * 2. CONSTRAINTS_MET - All constraints from the task specification are satisfied
+ * 3. TESTS_PASS - Relevant tests pass (or no tests were broken)
+ *
+ * This module provides runtime enforcement of these gates.
+ */
+export interface GateResult {
+    gate: string;
+    passed: boolean;
+    message: string;
+    details?: string;
+}
+export interface CompletionReport {
+    allPassed: boolean;
+    gates: GateResult[];
+    timestamp: string;
+}
+/**
+ * Gate 1: Verify that output exists.
+ * Checks that there are staged or unstaged changes in git,
+ * indicating work was actually done.
+ */
+export declare function checkOutputExists(projectDir: string): GateResult;
+/**
+ * Gate 2: Verify constraints are met.
+ * Checks that TypeScript compiles without errors and linting passes.
+ */
+export declare function checkConstraintsMet(projectDir: string): GateResult;
+/**
+ * Gate 3: Verify tests pass.
+ * Runs the project test suite and checks for failures.
+ */
+export declare function checkTestsPass(projectDir: string): GateResult;
+/**
+ * Run all completion gates and produce a report.
+ */
+export declare function runCompletionGates(projectDir: string, options?: {
+    skipTests?: boolean;
+    skipTypeCheck?: boolean;
+}): CompletionReport;
+/**
+ * Format a completion report for terminal output.
+ */
+export declare function formatCompletionReport(report: CompletionReport): string;
+//# sourceMappingURL=completion-gates.d.ts.map

package/dist/cli/completion-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-gates.d.ts","sourceRoot":"","sources":["../../src/cli/completion-gates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAkDhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CA0BlE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAoC7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACA,gBAAgB,CAiClB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA0BvE"}

package/dist/cli/completion-gates.js

@@ -0,0 +1,201 @@
+/**
+ * Completion Gates - Programmatic enforcement of mandatory checks
+ *
+ * The UAP protocol defines 3 mandatory gates that must pass before
+ * any task can be considered "done":
+ *
+ * 1. OUTPUT_EXISTS - Verifiable output was produced (files changed, tests written, etc.)
+ * 2. CONSTRAINTS_MET - All constraints from the task specification are satisfied
+ * 3. TESTS_PASS - Relevant tests pass (or no tests were broken)
+ *
+ * This module provides runtime enforcement of these gates.
+ */
+import { execSync } from 'child_process';
+import { existsSync } from 'fs';
+/**
+ * Gate 1: Verify that output exists.
+ * Checks that there are staged or unstaged changes in git,
+ * indicating work was actually done.
+ */
+export function checkOutputExists(projectDir) {
+    try {
+        const status = execSync('git status --porcelain', {
+            cwd: projectDir,
+            encoding: 'utf-8',
+            timeout: 10000,
+        }).trim();
+        if (status.length > 0) {
+            const changedFiles = status.split('\n').length;
+            return {
+                gate: 'OUTPUT_EXISTS',
+                passed: true,
+                message: `${changedFiles} file(s) changed`,
+                details: status,
+            };
+        }
+        // Check if there are new commits not yet pushed
+        try {
+            const unpushed = execSync('git log @{u}..HEAD --oneline 2>/dev/null || echo ""', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+                timeout: 10000,
+            }).trim();
+            if (unpushed.length > 0) {
+                return {
+                    gate: 'OUTPUT_EXISTS',
+                    passed: true,
+                    message: 'Unpushed commits found',
+                    details: unpushed,
+                };
+            }
+        }
+        catch {
+            // No upstream tracking, ignore
+        }
+        return {
+            gate: 'OUTPUT_EXISTS',
+            passed: false,
+            message: 'No changes detected - no output was produced',
+        };
+    }
+    catch (error) {
+        return {
+            gate: 'OUTPUT_EXISTS',
+            passed: false,
+            message: `Could not check git status: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Gate 2: Verify constraints are met.
+ * Checks that TypeScript compiles without errors and linting passes.
+ */
+export function checkConstraintsMet(projectDir) {
+    // Check TypeScript compilation
+    try {
+        execSync('npx tsc --noEmit 2>&1', {
+            cwd: projectDir,
+            encoding: 'utf-8',
+            timeout: 60000,
+        });
+    }
+    catch (error) {
+        const stderr = error instanceof Error && 'stderr' in error
+            ? String(error.stderr)
+            : String(error);
+        return {
+            gate: 'CONSTRAINTS_MET',
+            passed: false,
+            message: 'TypeScript compilation failed',
+            details: stderr.slice(0, 500),
+        };
+    }
+    return {
+        gate: 'CONSTRAINTS_MET',
+        passed: true,
+        message: 'TypeScript compilation passed',
+    };
+}
+/**
+ * Gate 3: Verify tests pass.
+ * Runs the project test suite and checks for failures.
+ */
+export function checkTestsPass(projectDir) {
+    // Check if package.json has a test script
+    const pkgPath = `${projectDir}/package.json`;
+    if (!existsSync(pkgPath)) {
+        return {
+            gate: 'TESTS_PASS',
+            passed: true,
+            message: 'No package.json found - skipping test gate',
+        };
+    }
+    try {
+        const output = execSync('npm test 2>&1', {
+            cwd: projectDir,
+            encoding: 'utf-8',
+            timeout: 120000,
+        });
+        return {
+            gate: 'TESTS_PASS',
+            passed: true,
+            message: 'All tests passed',
+            details: output.slice(-300),
+        };
+    }
+    catch (error) {
+        const output = error instanceof Error && 'stdout' in error
+            ? String(error.stdout)
+            : String(error);
+        return {
+            gate: 'TESTS_PASS',
+            passed: false,
+            message: 'Tests failed',
+            details: output.slice(-500),
+        };
+    }
+}
+/**
+ * Run all completion gates and produce a report.
+ */
+export function runCompletionGates(projectDir, options) {
+    const gates = [];
+    // Gate 1: Output exists
+    gates.push(checkOutputExists(projectDir));
+    // Gate 2: Constraints met (TypeScript compilation)
+    if (options?.skipTypeCheck) {
+        gates.push({
+            gate: 'CONSTRAINTS_MET',
+            passed: true,
+            message: 'Skipped (--skip-typecheck)',
+        });
+    }
+    else {
+        gates.push(checkConstraintsMet(projectDir));
+    }
+    // Gate 3: Tests pass
+    if (options?.skipTests) {
+        gates.push({
+            gate: 'TESTS_PASS',
+            passed: true,
+            message: 'Skipped (--skip-tests)',
+        });
+    }
+    else {
+        gates.push(checkTestsPass(projectDir));
+    }
+    return {
+        allPassed: gates.every((g) => g.passed),
+        gates,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Format a completion report for terminal output.
+ */
+export function formatCompletionReport(report) {
+    const lines = [];
+    lines.push('=== Completion Gates Report ===');
+    lines.push('');
+    for (const gate of report.gates) {
+        const icon = gate.passed ? 'PASS' : 'FAIL';
+        lines.push(`[${icon}] ${gate.gate}: ${gate.message}`);
+        if (gate.details && !gate.passed) {
+            const detailLines = gate.details.split('\n').slice(0, 5);
+            for (const dl of detailLines) {
+                lines.push(`       ${dl}`);
+            }
+        }
+    }
+    lines.push('');
+    if (report.allPassed) {
+        lines.push('All gates passed - work is complete.');
+    }
+    else {
+        const failed = report.gates.filter((g) => !g.passed).map((g) => g.gate);
+        lines.push(`BLOCKED: ${failed.join(', ')} gate(s) failed.`);
+        lines.push('Fix the issues above before marking work as done.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=completion-gates.js.map

package/dist/cli/completion-gates.js.map

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

package/dist/cli/compliance.d.ts

@@ -0,0 +1,8 @@
+type ComplianceAction = 'check' | 'audit' | 'fix';
+interface ComplianceOptions {
+    verbose?: boolean;
+    fix?: boolean;
+}
+export declare function complianceCommand(action: ComplianceAction, options?: ComplianceOptions): Promise<void>;
+export {};
+//# sourceMappingURL=compliance.d.ts.map

package/dist/cli/compliance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../../src/cli/compliance.ts"],"names":[],"mappings":"AAcA,KAAK,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAElD,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AASD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAcf"}