comp-gate 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,156 @@
+export type QuestionType = "change_rationale" | "symbol" | "architecture" | "category";
+export type CategoryKey = "changeRationale" | "symbols" | "architecture" | "runtime" | "dataStructures" | "dependencies" | "testing" | "errorHandling" | "apiContracts" | "security" | "performance" | "database" | "machineLearning" | "cybersecurity" | "frontend" | "backend" | "devops" | "mobile" | "dataEngineering";
+export declare const ALL_CATEGORY_KEYS: CategoryKey[];
+export declare const DOMAIN_CATEGORY_KEYS: CategoryKey[];
+export type GradingMode = "semantic" | "keywords";
+export type Difficulty = "easy" | "medium" | "hard";
+export type AlignmentLevel = "low" | "medium" | "high";
+export interface Rubric {
+    requiredTerms: string[];
+    minLength: number;
+    requiredSymbol?: string;
+}
+export interface Question {
+    id: string;
+    type: QuestionType;
+    category: CategoryKey;
+    prompt: string;
+    files: string[];
+    rubric: Rubric;
+}
+export interface Session {
+    diffHash: string;
+    baseRef: string;
+    generatedAt: string;
+    questions: Question[];
+}
+export interface PassFile {
+    diffHash: string;
+    score: number;
+    verifiedAt: string;
+    questionsAnswered: number;
+    headSha?: string;
+    hadUncommitted?: boolean;
+}
+export interface FileChange {
+    path: string;
+    symbols: string[];
+}
+export interface DiffAnalysis {
+    diffHash: string;
+    baseRef: string;
+    rawDiff: string;
+    files: FileChange[];
+}
+export interface VerifyResult {
+    passed: boolean;
+    score: number;
+    total: number;
+    grading: GradingMode;
+    passThreshold?: number;
+    questionScores?: Array<{
+        id: string;
+        prompt: string;
+        accuracy: number;
+        alignment: "low" | "medium" | "high";
+        passed: boolean;
+        userSummary: string;
+        feedback: string;
+    }>;
+    failures: Array<{
+        id: string;
+        prompt: string;
+        missingTerms?: string[];
+        tooShort?: boolean;
+        missingSymbol?: string;
+        feedback?: string;
+        alignment?: string;
+        userSummary?: string;
+        accuracy?: number;
+    }>;
+}
+export interface QuestionJudgment {
+    passed: boolean;
+    accuracy: number;
+    userSummary: string;
+    alignment: "low" | "medium" | "high";
+    feedback: string;
+}
+export interface JudgmentsFile {
+    diffHash: string;
+    gradedAt: string;
+    judgments: Record<string, QuestionJudgment>;
+}
+export interface ReferencesFile {
+    diffHash: string;
+    generatedAt: string;
+    references: Record<string, string>;
+}
+export interface PromptsSection {
+    file: string;
+    bullets: string[];
+}
+export type CategoryFlags = Partial<Record<CategoryKey, boolean>>;
+export interface QuestionsConfig {
+    min: number;
+    max: number;
+}
+export interface TestmeConfig {
+    questions: QuestionsConfig;
+    categories: Record<CategoryKey, boolean>;
+    autoDetect: boolean;
+    domain: string | null;
+    grading: GradingMode;
+    passThreshold: number;
+    minAlignment?: AlignmentLevel;
+    difficulty?: Difficulty;
+    protectedBranches: string[];
+    gateCommits: boolean;
+    gateEnabled: boolean;
+    autoProtectCurrentBranch: boolean;
+    _detected?: Record<string, {
+        confidence: number;
+        reason: string;
+    }>;
+}
+export interface TestmeConfigInput {
+    questions?: Partial<QuestionsConfig>;
+    categories?: CategoryFlags;
+    autoDetect?: boolean;
+    domain?: string | null;
+    grading?: GradingMode;
+    passThreshold?: number;
+    minAlignment?: AlignmentLevel;
+    difficulty?: Difficulty;
+    protectedBranches?: string[];
+    gateCommits?: boolean;
+    gateEnabled?: boolean;
+    autoProtectCurrentBranch?: boolean;
+    _detected?: Record<string, {
+        confidence: number;
+        reason: string;
+    }>;
+}
+export interface GenerateOptions {
+    maxQuestions?: number;
+    minQuestions?: number;
+    categories?: CategoryKey[];
+}
+export interface CategorySuggestion {
+    enabled: boolean;
+    confidence: number;
+    reason: string;
+}
+export interface DetectionResult {
+    suggestedCategories: Partial<Record<CategoryKey, CategorySuggestion>>;
+    domain: string | null;
+}
+export interface QuestionCandidate {
+    category: CategoryKey;
+    type: QuestionType;
+    prompt: string;
+    files: string[];
+    rubric: Rubric;
+    priority: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,31 @@
+export const ALL_CATEGORY_KEYS = [
+    "changeRationale",
+    "symbols",
+    "architecture",
+    "runtime",
+    "dataStructures",
+    "dependencies",
+    "testing",
+    "errorHandling",
+    "apiContracts",
+    "security",
+    "performance",
+    "database",
+    "machineLearning",
+    "cybersecurity",
+    "frontend",
+    "backend",
+    "devops",
+    "mobile",
+    "dataEngineering",
+];
+export const DOMAIN_CATEGORY_KEYS = [
+    "machineLearning",
+    "cybersecurity",
+    "frontend",
+    "backend",
+    "devops",
+    "mobile",
+    "dataEngineering",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,iBAAiB;IACjB,SAAS;IACT,cAAc;IACd,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,SAAS;IACT,eAAe;IACf,cAAc;IACd,UAAU;IACV,aAAa;IACb,UAAU;IACV,iBAAiB;IACjB,eAAe;IACf,UAAU;IACV,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,iBAAiB;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAkB;IACjD,iBAAiB;IACjB,eAAe;IACf,UAAU;IACV,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,iBAAiB;CAClB,CAAC"}

package/dist/verify.d.ts

@@ -0,0 +1,38 @@
+import type { JudgmentsFile, PassFile, Question, ReferencesFile, Session, VerifyResult, AlignmentLevel } from "./types.js";
+export declare function scoreAnswer(answer: string, question: Question): {
+    passed: boolean;
+    missingTerms: string[];
+    tooShort: boolean;
+    missingSymbol?: string;
+};
+export declare function verifyAnswersKeywords(session: Session, answers: Record<string, string>): VerifyResult;
+export declare function normalizeJudgment(judgment: {
+    passed: boolean;
+    accuracy?: number;
+    alignment: "low" | "medium" | "high";
+}): number;
+export declare function isQuestionPassing(judgment: {
+    passed: boolean;
+    accuracy?: number;
+    alignment: "low" | "medium" | "high";
+}, passThreshold: number, minAlignment?: AlignmentLevel): boolean;
+export declare function verifyAnswersSemantic(session: Session, judgments: JudgmentsFile, passThreshold?: number, minAlignment?: AlignmentLevel): VerifyResult;
+export declare function loadSession(): Session;
+export declare function loadAnswers(): Record<string, string>;
+export declare function loadReferences(): ReferencesFile | null;
+export declare function loadJudgments(): JudgmentsFile;
+export declare function writeJudgments(judgments: JudgmentsFile): void;
+export declare function writeReferences(references: ReferencesFile): void;
+export declare function verifySession(cwd: string, branch?: string): VerifyResult;
+export declare function loadPassFile(): PassFile | null;
+export declare function passStillValid(options: {
+    pass: PassFile;
+    currentDiffHash: string;
+    headSha: string;
+    hasUncommitted: boolean;
+    verifiedHeadIsAncestor: boolean;
+}): boolean;
+export declare function evaluatePassValidity(pass: PassFile, cwd: string, branch?: string): boolean;
+export declare function isPassValid(cwd: string, branch?: string): boolean;
+export declare function verifyAnswers(session: Session, answers: Record<string, string>): VerifyResult;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../src/verify.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,OAAO,EACP,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAepB,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG;IAC/D,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAeA;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,YAAY,CAgCd;AAeD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC,GAAG,MAAM,CAMT;AAeD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE;IACR,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtC,EACD,aAAa,EAAE,MAAM,EACrB,YAAY,GAAE,cAAyB,GACtC,OAAO,CAOT;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,aAAa,EACxB,aAAa,SAAK,EAClB,YAAY,GAAE,cAAyB,GACtC,YAAY,CA0Dd;AAED,wBAAgB,WAAW,IAAI,OAAO,CAMrC;AAED,wBAAgB,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMpD;AAED,wBAAgB,cAAc,IAAI,cAAc,GAAG,IAAI,CAMtD;AAED,wBAAgB,aAAa,IAAI,aAAa,CAQ7C;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAG7D;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAGhE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,YAAY,CAqDxE;AAED,wBAAgB,YAAY,IAAI,QAAQ,GAAG,IAAI,CAM9C;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;CACjC,GAAG,OAAO,CA0BV;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,MAAM,SAAS,GACd,OAAO,CAWT;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAS,GAAG,OAAO,CAOjE;AAGD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,YAAY,CAEd"}

package/dist/verify.js

@@ -0,0 +1,254 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { loadConfig } from "./config.js";
+import { analyzeDiff, getHeadSha, hasUncommittedChanges, isGitAncestor } from "./diff.js";
+import { ANSWERS_PATH, JUDGMENTS_PATH, PASS_PATH, REFERENCES_PATH, SESSION_PATH, TESTME_DIR, } from "./paths.js";
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function hasTerm(answer, term) {
+    if (term.includes("/") || term.includes(".")) {
+        return answer.toLowerCase().includes(term.toLowerCase());
+    }
+    const pattern = new RegExp(`\\b${escapeRegex(term)}\\b`, "i");
+    return pattern.test(answer);
+}
+export function scoreAnswer(answer, question) {
+    const trimmed = answer.trim();
+    const missingTerms = question.rubric.requiredTerms.filter((term) => !hasTerm(trimmed, term));
+    const tooShort = trimmed.length < question.rubric.minLength;
+    let missingSymbol;
+    if (question.rubric.requiredSymbol && !hasTerm(trimmed, question.rubric.requiredSymbol)) {
+        missingSymbol = question.rubric.requiredSymbol;
+    }
+    const passed = missingTerms.length === 0 && !tooShort && !missingSymbol;
+    return { passed, missingTerms, tooShort, missingSymbol };
+}
+export function verifyAnswersKeywords(session, answers) {
+    const failures = [];
+    let passedCount = 0;
+    for (const question of session.questions) {
+        const answer = answers[question.id] ?? "";
+        const result = scoreAnswer(answer, question);
+        if (result.passed) {
+            passedCount += 1;
+            continue;
+        }
+        failures.push({
+            id: question.id,
+            prompt: question.prompt,
+            missingTerms: result.missingTerms,
+            tooShort: result.tooShort,
+            missingSymbol: result.missingSymbol,
+        });
+    }
+    const total = session.questions.length;
+    const passed = failures.length === 0 && total > 0;
+    return {
+        passed,
+        score: total === 0 ? 0 : Math.round((passedCount / total) * 100),
+        total,
+        grading: "keywords",
+        failures,
+    };
+}
+const ALIGNMENT_SCORE = {
+    high: 100,
+    medium: 75,
+    low: 0,
+};
+function clampAccuracy(value) {
+    if (Number.isNaN(value)) {
+        return 0;
+    }
+    return Math.min(100, Math.max(0, Math.round(value)));
+}
+export function normalizeJudgment(judgment) {
+    if (judgment.accuracy !== undefined) {
+        return clampAccuracy(judgment.accuracy);
+    }
+    return ALIGNMENT_SCORE[judgment.alignment] ?? 0;
+}
+const ALIGNMENT_RANK = {
+    low: 1,
+    medium: 2,
+    high: 3,
+};
+function alignmentMeetsMinimum(alignment, minAlignment = "medium") {
+    return ALIGNMENT_RANK[alignment] >= ALIGNMENT_RANK[minAlignment];
+}
+export function isQuestionPassing(judgment, passThreshold, minAlignment = "medium") {
+    const accuracy = normalizeJudgment(judgment);
+    return (judgment.passed &&
+        accuracy >= passThreshold &&
+        alignmentMeetsMinimum(judgment.alignment, minAlignment));
+}
+export function verifyAnswersSemantic(session, judgments, passThreshold = 70, minAlignment = "medium") {
+    const failures = [];
+    const questionScores = [];
+    let accuracySum = 0;
+    for (const question of session.questions) {
+        const judgment = judgments.judgments[question.id];
+        if (!judgment) {
+            failures.push({
+                id: question.id,
+                prompt: question.prompt,
+                feedback: "No semantic judgment recorded for this question.",
+            });
+            continue;
+        }
+        const accuracy = normalizeJudgment(judgment);
+        const passed = isQuestionPassing(judgment, passThreshold, minAlignment);
+        questionScores.push({
+            id: question.id,
+            prompt: question.prompt,
+            accuracy,
+            alignment: judgment.alignment,
+            passed,
+            userSummary: judgment.userSummary,
+            feedback: judgment.feedback,
+        });
+        accuracySum += accuracy;
+        if (passed) {
+            continue;
+        }
+        failures.push({
+            id: question.id,
+            prompt: question.prompt,
+            feedback: judgment.feedback,
+            alignment: judgment.alignment,
+            userSummary: judgment.userSummary,
+            accuracy,
+        });
+    }
+    const total = session.questions.length;
+    const passed = failures.length === 0 && total > 0;
+    return {
+        passed,
+        score: total === 0 ? 0 : Math.round(accuracySum / total),
+        total,
+        grading: "semantic",
+        passThreshold,
+        questionScores,
+        failures,
+    };
+}
+export function loadSession() {
+    if (!existsSync(SESSION_PATH)) {
+        throw new Error("No session found. Run `npx comp-gate generate` first.");
+    }
+    return JSON.parse(readFileSync(SESSION_PATH, "utf8"));
+}
+export function loadAnswers() {
+    if (!existsSync(ANSWERS_PATH)) {
+        throw new Error("No answers found. Collect answers in chat first.");
+    }
+    return JSON.parse(readFileSync(ANSWERS_PATH, "utf8"));
+}
+export function loadReferences() {
+    if (!existsSync(REFERENCES_PATH)) {
+        return null;
+    }
+    return JSON.parse(readFileSync(REFERENCES_PATH, "utf8"));
+}
+export function loadJudgments() {
+    if (!existsSync(JUDGMENTS_PATH)) {
+        throw new Error("No judgments found. The agent must grade answers semantically and write .testme/judgments.json before verify.");
+    }
+    return JSON.parse(readFileSync(JUDGMENTS_PATH, "utf8"));
+}
+export function writeJudgments(judgments) {
+    mkdirSync(TESTME_DIR, { recursive: true });
+    writeFileSync(JUDGMENTS_PATH, `${JSON.stringify(judgments, null, 2)}\n`, "utf8");
+}
+export function writeReferences(references) {
+    mkdirSync(TESTME_DIR, { recursive: true });
+    writeFileSync(REFERENCES_PATH, `${JSON.stringify(references, null, 2)}\n`, "utf8");
+}
+export function verifySession(cwd, branch = "main") {
+    const session = loadSession();
+    const answers = loadAnswers();
+    const config = loadConfig(cwd);
+    const current = analyzeDiff(cwd, branch);
+    if (session.diffHash !== current.diffHash) {
+        throw new Error("Session is stale. The diff changed since generate — run `npx comp-gate generate` again.");
+    }
+    const answerIds = new Set(Object.keys(answers));
+    for (const question of session.questions) {
+        if (!answerIds.has(question.id) || !answers[question.id]?.trim()) {
+            throw new Error(`Missing answer for ${question.id}.`);
+        }
+    }
+    let result;
+    if (config.grading === "keywords") {
+        result = verifyAnswersKeywords(session, answers);
+    }
+    else {
+        const judgments = loadJudgments();
+        if (judgments.diffHash !== session.diffHash) {
+            throw new Error("Judgments are stale. Re-grade answers against the current session.");
+        }
+        result = verifyAnswersSemantic(session, judgments, config.passThreshold, config.minAlignment ?? "medium");
+    }
+    if (result.passed) {
+        const pass = {
+            diffHash: session.diffHash,
+            score: result.score,
+            verifiedAt: new Date().toISOString(),
+            questionsAnswered: session.questions.length,
+            headSha: getHeadSha(cwd),
+            hadUncommitted: hasUncommittedChanges(cwd),
+        };
+        mkdirSync(TESTME_DIR, { recursive: true });
+        writeFileSync(PASS_PATH, `${JSON.stringify(pass, null, 2)}\n`, "utf8");
+    }
+    return result;
+}
+export function loadPassFile() {
+    if (!existsSync(PASS_PATH)) {
+        return null;
+    }
+    return JSON.parse(readFileSync(PASS_PATH, "utf8"));
+}
+export function passStillValid(options) {
+    const { pass, currentDiffHash, headSha, hasUncommitted, verifiedHeadIsAncestor } = options;
+    if (pass.diffHash === currentDiffHash) {
+        return true;
+    }
+    if (!pass.headSha) {
+        return false;
+    }
+    if (pass.hadUncommitted &&
+        !hasUncommitted &&
+        headSha !== pass.headSha &&
+        verifiedHeadIsAncestor) {
+        return true;
+    }
+    if (pass.headSha === headSha && !hasUncommitted) {
+        return true;
+    }
+    return false;
+}
+export function evaluatePassValidity(pass, cwd, branch = "main") {
+    const headSha = getHeadSha(cwd);
+    return passStillValid({
+        pass,
+        currentDiffHash: analyzeDiff(cwd, branch).diffHash,
+        headSha,
+        hasUncommitted: hasUncommittedChanges(cwd),
+        verifiedHeadIsAncestor: pass.headSha
+            ? isGitAncestor(pass.headSha, headSha, cwd)
+            : false,
+    });
+}
+export function isPassValid(cwd, branch = "main") {
+    const pass = loadPassFile();
+    if (!pass) {
+        return false;
+    }
+    return evaluatePassValidity(pass, cwd, branch);
+}
+// Backwards-compatible export used in tests
+export function verifyAnswers(session, answers) {
+    return verifyAnswersKeywords(session, answers);
+}
+//# sourceMappingURL=verify.js.map

package/dist/verify.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "comp-gate",
+  "version": "0.1.0",
+  "description": "Comprehension gate for desktop coding agents — block git push to main until you pass a deterministic test",
+  "type": "module",
+  "bin": {
+    "comp-gate": "./dist/cli.js",
+    "testme": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --experimental-vm-modules node_modules/vitest/vitest.mjs run",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ROrmand/comp-gate.git"
+  },
+  "homepage": "https://github.com/ROrmand/comp-gate#readme",
+  "bugs": {
+    "url": "https://github.com/ROrmand/comp-gate/issues"
+  },
+  "keywords": [
+    "cursor",
+    "claude",
+    "windsurf",
+    "agent",
+    "git",
+    "comprehension",
+    "hooks",
+    "pre-push",
+    "pre-commit"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.9"
+  }
+}

package/src/templates/PROMPTS.md

@@ -0,0 +1,6 @@
+# Session Changes
+
+Document what changed during this session. testme uses these bullets to build comprehension rubrics.
+
+## example/path.ts
+- Describe what changed and why