@itsthelore/proofkeeper 2026.6.0

package/dist/writeback/proposer.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Propose a `## Verified By` write-back as a human-reviewed pull request —
+ * Proofkeeper Initiative 5.
+ *
+ * The trust boundary is human PR review (ADR-065): Proofkeeper NEVER commits to
+ * the base branch. The proposer reads the target file from the base, builds the
+ * merged content, commits it to a NEW head branch, and opens a pull request
+ * base ← head. That guarantee is structural — there is no code path that writes
+ * to the base branch.
+ *
+ * Repository operations go through an injected {@link RepoGateway}, so there is
+ * no hard GitHub dependency: wire it to Octokit, the `gh` CLI, or a GitHub MCP
+ * client. The mapping is the consumer's choice, exactly like the model adapter.
+ */
+import { type FidelitySummary } from "./comment.js";
+import type { VerificationLink } from "./verified-by.js";
+/** The repository operations the proposer needs. Implement against any backend. */
+export interface RepoGateway {
+    /** Read a file's content at a ref (branch/sha). */
+    getFileContent(path: string, ref: string): Promise<string>;
+    /** Create a new branch from a base ref. */
+    createBranch(name: string, fromRef: string): Promise<void>;
+    /** Commit file content to a branch (never the base — the proposer enforces this). */
+    commitFile(input: {
+        branch: string;
+        path: string;
+        content: string;
+        message: string;
+    }): Promise<void>;
+    /** Open a pull request from `head` into `base`. */
+    openPullRequest(input: {
+        base: string;
+        head: string;
+        title: string;
+        body: string;
+    }): Promise<{
+        url: string;
+        number: number;
+    }>;
+    /** Post an informational comment on a pull request. Never approves or merges. */
+    commentOnPullRequest(input: {
+        number: number;
+        body: string;
+    }): Promise<{
+        url: string;
+    }>;
+    /** List a pull request's comments (id + body), for find-or-update of a marked comment. */
+    listComments(prNumber: number): Promise<{
+        id: number;
+        body: string;
+    }[]>;
+    /** Update a comment's body in place. */
+    updateComment(commentId: number, body: string): Promise<{
+        url: string;
+    }>;
+}
+export interface WriteBackInput {
+    capabilityId: string;
+    targetPath: string;
+    links: VerificationLink[];
+    /** Overrides the proposer's default base branch. */
+    baseBranch?: string;
+    branchPrefix?: string;
+    /** When provided, a confirmation comment with the fidelity result is posted on the PR. */
+    fidelity?: FidelitySummary;
+    /** Readable step summary of the driven flow, shown in the PR body and comment. */
+    steps?: string[];
+    /** The Markdown test plan the model wrote before driving, shown in the PR. */
+    plan?: string;
+}
+export type WriteBackResult = {
+    status: "no-change";
+    reason: string;
+} | {
+    status: "proposed";
+    url: string;
+    number: number;
+    headBranch: string;
+    commentUrl?: string;
+};
+export interface WriteBackProposer {
+    propose(input: WriteBackInput): Promise<WriteBackResult>;
+}
+export interface GitHubWriteBackProposerOptions {
+    /** Base branch PRs target. Defaults to `main`. */
+    baseBranch?: string;
+}
+export declare class GitHubWriteBackProposer implements WriteBackProposer {
+    private readonly gateway;
+    private readonly options;
+    constructor(gateway: RepoGateway, options?: GitHubWriteBackProposerOptions);
+    propose(input: WriteBackInput): Promise<WriteBackResult>;
+}
+//# sourceMappingURL=proposer.d.ts.map

package/dist/writeback/proposer.d.ts.map

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

package/dist/writeback/proposer.js

@@ -0,0 +1,79 @@
+/**
+ * Propose a `## Verified By` write-back as a human-reviewed pull request —
+ * Proofkeeper Initiative 5.
+ *
+ * The trust boundary is human PR review (ADR-065): Proofkeeper NEVER commits to
+ * the base branch. The proposer reads the target file from the base, builds the
+ * merged content, commits it to a NEW head branch, and opens a pull request
+ * base ← head. That guarantee is structural — there is no code path that writes
+ * to the base branch.
+ *
+ * Repository operations go through an injected {@link RepoGateway}, so there is
+ * no hard GitHub dependency: wire it to Octokit, the `gh` CLI, or a GitHub MCP
+ * client. The mapping is the consumer's choice, exactly like the model adapter.
+ */
+import { buildProposal } from "./proposal.js";
+import { renderWriteBackComment, upsertComment, WRITE_BACK_MARKER } from "./comment.js";
+export class GitHubWriteBackProposer {
+    gateway;
+    options;
+    constructor(gateway, options = {}) {
+        this.gateway = gateway;
+        this.options = options;
+    }
+    async propose(input) {
+        const baseBranch = input.baseBranch ?? this.options.baseBranch ?? "main";
+        const originalContent = await this.gateway.getFileContent(input.targetPath, baseBranch);
+        const proposal = buildProposal({
+            capabilityId: input.capabilityId,
+            targetPath: input.targetPath,
+            originalContent,
+            links: input.links,
+            baseBranch,
+            ...(input.branchPrefix !== undefined ? { branchPrefix: input.branchPrefix } : {}),
+            ...(input.steps !== undefined ? { steps: input.steps } : {}),
+            ...(input.plan !== undefined ? { plan: input.plan } : {}),
+        });
+        if (!proposal.changed) {
+            return { status: "no-change", reason: "all proposed links are already present" };
+        }
+        // Commit ONLY to the new head branch, then open a PR. The base is never written.
+        await this.gateway.createBranch(proposal.headBranch, baseBranch);
+        await this.gateway.commitFile({
+            branch: proposal.headBranch,
+            path: input.targetPath,
+            content: proposal.updatedContent,
+            message: proposal.title,
+        });
+        const pr = await this.gateway.openPullRequest({
+            base: baseBranch,
+            head: proposal.headBranch,
+            title: proposal.title,
+            body: proposal.body,
+        });
+        const result = {
+            status: "proposed",
+            url: pr.url,
+            number: pr.number,
+            headBranch: proposal.headBranch,
+        };
+        // Optional confirmation comment carrying the fidelity evidence the PR body
+        // does not. Informational only, and idempotent (one per PR, updated in place).
+        if (input.fidelity) {
+            const comment = await upsertComment(this.gateway, {
+                number: pr.number,
+                marker: WRITE_BACK_MARKER,
+                body: renderWriteBackComment({
+                    capabilityId: input.capabilityId,
+                    links: input.links,
+                    fidelity: input.fidelity,
+                    ...(input.steps !== undefined ? { steps: input.steps } : {}),
+                    ...(input.plan !== undefined ? { plan: input.plan } : {}),
+                }),
+            });
+            result.commentUrl = comment.url;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=proposer.js.map

package/dist/writeback/proposer.js.map

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

package/dist/writeback/verified-by.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The `## Verified By` write-back renderer — Proofkeeper Initiative 5.
+ *
+ * Proofkeeper proposes verification links by rendering the exact section the
+ * engine recognizes (ADR-084): a `## Verified By` heading followed by a list of
+ * external references. The engine treats the entire list-item text as the
+ * reference, so each item is a single **bare** test path — the verifier the
+ * corpus records. The replayable trace is evidence surfaced in the pull request
+ * and committed as an artifact, not a corpus edge. Targets are external
+ * (ADR-084), so the engine emits them with `resolved: false` — expected, not an
+ * error.
+ *
+ * This is PROPOSE-ONLY. The renderer returns Markdown; it never writes into a
+ * corpus. Applying it is a human-reviewed pull request (ADR-065) — the trust
+ * boundary is the reviewer, never Proofkeeper.
+ */
+/** A single verifying reference: a committed test and, optionally, its trace. */
+export interface VerificationLink {
+    /** Path/reference to the committed Playwright test. */
+    test: string;
+    /** Optional path/reference to the replayable trace artifact. */
+    trace?: string;
+}
+/** The heading the engine recognizes as the verified_by section (ADR-084). */
+export declare const VERIFIED_BY_HEADING = "## Verified By";
+/**
+ * Flatten links into their external reference paths — the test and, when
+ * present, the trace — deduplicated, preserving order. These are the bare
+ * targets the engine records (both are external-target references, ADR-084).
+ */
+export declare function verificationRefs(links: VerificationLink[]): string[];
+/**
+ * Render one reference as a `## Verified By` list item: a single bare backticked
+ * path, so the engine's edge target is a clean reference.
+ */
+export declare function renderVerifiedByItem(ref: string): string;
+/**
+ * Render the `## Verified By` section body Proofkeeper proposes for a
+ * capability — the heading plus one bare item per reference (test and trace).
+ *
+ * @throws {Error} when given no links — an empty section is never proposed.
+ */
+export declare function renderVerifiedBySection(links: VerificationLink[]): string;
+/** A proposed write-back: which capability, and the section to add to it. */
+export interface VerifiedByProposal {
+    capabilityId: string;
+    section: string;
+    links: VerificationLink[];
+}
+/**
+ * Build a propose-only write-back for a capability. The result is meant to be
+ * carried into a human-reviewed pull request against the target's Lore corpus —
+ * never written directly.
+ */
+export declare function proposeVerifiedBy(capabilityId: string, links: VerificationLink[]): VerifiedByProposal;
+//# sourceMappingURL=verified-by.d.ts.map

package/dist/writeback/verified-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verified-by.d.ts","sourceRoot":"","sources":["../../src/writeback/verified-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAOpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAKzE;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,gBAAgB,EAAE,GACxB,kBAAkB,CAEpB"}

package/dist/writeback/verified-by.js

@@ -0,0 +1,60 @@
+/**
+ * The `## Verified By` write-back renderer — Proofkeeper Initiative 5.
+ *
+ * Proofkeeper proposes verification links by rendering the exact section the
+ * engine recognizes (ADR-084): a `## Verified By` heading followed by a list of
+ * external references. The engine treats the entire list-item text as the
+ * reference, so each item is a single **bare** test path — the verifier the
+ * corpus records. The replayable trace is evidence surfaced in the pull request
+ * and committed as an artifact, not a corpus edge. Targets are external
+ * (ADR-084), so the engine emits them with `resolved: false` — expected, not an
+ * error.
+ *
+ * This is PROPOSE-ONLY. The renderer returns Markdown; it never writes into a
+ * corpus. Applying it is a human-reviewed pull request (ADR-065) — the trust
+ * boundary is the reviewer, never Proofkeeper.
+ */
+/** The heading the engine recognizes as the verified_by section (ADR-084). */
+export const VERIFIED_BY_HEADING = "## Verified By";
+/**
+ * Flatten links into their external reference paths — the test and, when
+ * present, the trace — deduplicated, preserving order. These are the bare
+ * targets the engine records (both are external-target references, ADR-084).
+ */
+export function verificationRefs(links) {
+    const refs = [];
+    for (const link of links) {
+        refs.push(link.test);
+        if (link.trace)
+            refs.push(link.trace);
+    }
+    return [...new Set(refs)];
+}
+/**
+ * Render one reference as a `## Verified By` list item: a single bare backticked
+ * path, so the engine's edge target is a clean reference.
+ */
+export function renderVerifiedByItem(ref) {
+    return `- \`${ref}\``;
+}
+/**
+ * Render the `## Verified By` section body Proofkeeper proposes for a
+ * capability — the heading plus one bare item per reference (test and trace).
+ *
+ * @throws {Error} when given no links — an empty section is never proposed.
+ */
+export function renderVerifiedBySection(links) {
+    if (links.length === 0) {
+        throw new Error("refusing to render an empty `## Verified By` section");
+    }
+    return [VERIFIED_BY_HEADING, "", ...verificationRefs(links).map(renderVerifiedByItem), ""].join("\n");
+}
+/**
+ * Build a propose-only write-back for a capability. The result is meant to be
+ * carried into a human-reviewed pull request against the target's Lore corpus —
+ * never written directly.
+ */
+export function proposeVerifiedBy(capabilityId, links) {
+    return { capabilityId, section: renderVerifiedBySection(links), links };
+}
+//# sourceMappingURL=verified-by.js.map

package/dist/writeback/verified-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verified-by.js","sourceRoot":"","sources":["../../src/writeback/verified-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO,OAAO,GAAG,IAAI,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAyB;IAC/D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,mBAAmB,EAAE,EAAE,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxG,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,KAAyB;IAEzB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;AAC1E,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@itsthelore/proofkeeper",
+  "version": "2026.6.0",
+  "description": "Lore Proofkeeper — an autonomous QA agent that drives a product, compiles the session into durable Playwright tests, gates them on fidelity, and reports which Lore capabilities are unverified.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "proofkeeper": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "proofkeeper": "node --import tsx ./src/cli.ts"
+  },
+  "keywords": [
+    "lore",
+    "proofkeeper",
+    "playwright",
+    "verification",
+    "qa",
+    "requirements-as-code"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/itsthelore/proofkeeper.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.105.0",
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "@playwright/test": "^1.45.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.40.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  }
+}