usesteady 0.1.0-alpha.1

package/dist/src/friction/github-auth.js

@@ -0,0 +1,155 @@
+// Copyright 2026 Shortgigs LLC. Licensed under the Apache License, Version 2.0.
+/**
+ * src/friction/github-auth.ts
+ *
+ * GitHub Device Flow OAuth — no browser redirect needed.
+ *
+ * Flow:
+ *  1. POST /login/device/code  → get device_code + user_code + verification_uri
+ *  2. Show user_code to the user; they visit verification_uri and enter it
+ *  3. Poll /login/oauth/access_token until user approves or timeout
+ *  4. Exchange token for GitHub user profile
+ *  5. Store token in ~/.usesteady/auth.json
+ *
+ * Required GitHub OAuth App settings:
+ *   - Client ID: set via USESTEADY_GITHUB_CLIENT_ID env var or ~/.usesteady/config.json
+ *   - Scopes: user:email (read public profile + email)
+ *   - Device flow: enabled in GitHub App / OAuth App settings
+ *
+ * Register a free GitHub OAuth App at:
+ *   https://github.com/settings/developers → "New OAuth App"
+ *   Set Authorization callback URL to: http://localhost (unused for device flow)
+ *   Enable "Device Authorization flow" checkbox
+ */
+import { writeAuth } from "./config.js";
+// ─── GitHub OAuth endpoints ────────────────────────────────────────────────────
+const GITHUB_DEVICE_CODE_URL = "https://github.com/login/device/code";
+const GITHUB_TOKEN_URL = "https://github.com/login/oauth/access_token";
+const GITHUB_USER_URL = "https://api.github.com/user";
+const GITHUB_EMAILS_URL = "https://api.github.com/user/emails";
+// The client ID for the UseSteady GitHub OAuth App.
+// Alpha testers either have this set via env var or it ships in their config.
+function getClientId() {
+    const fromEnv = process.env["USESTEADY_GITHUB_CLIENT_ID"];
+    if (fromEnv)
+        return fromEnv;
+    throw new Error("USESTEADY_GITHUB_CLIENT_ID is not set.\n" +
+        "Set it in your environment or run: usesteady report --setup");
+}
+// ─── Step 1: Request device code ──────────────────────────────────────────────
+async function requestDeviceCode() {
+    const resp = await fetch(GITHUB_DEVICE_CODE_URL, {
+        method: "POST",
+        headers: {
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            client_id: getClientId(),
+            scope: "user:email",
+        }),
+    });
+    if (!resp.ok) {
+        throw new Error(`Device code request failed: ${resp.status} ${resp.statusText}`);
+    }
+    return resp.json();
+}
+// ─── Step 2: Poll for token ───────────────────────────────────────────────────
+async function pollForToken(deviceCode, intervalSec, expiresInSec, onWaiting) {
+    const deadline = Date.now() + expiresInSec * 1000;
+    const intervalMs = Math.max(intervalSec, 5) * 1000;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, intervalMs));
+        const resp = await fetch(GITHUB_TOKEN_URL, {
+            method: "POST",
+            headers: {
+                "Accept": "application/json",
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                client_id: getClientId(),
+                device_code: deviceCode,
+                grant_type: "urn:ietf:params:oauth:grant-type:device_code",
+            }),
+        });
+        const data = await resp.json();
+        if (data.access_token) {
+            return data.access_token;
+        }
+        if (data.error === "authorization_pending") {
+            onWaiting?.();
+            continue;
+        }
+        if (data.error === "slow_down") {
+            await new Promise((r) => setTimeout(r, 5000));
+            continue;
+        }
+        if (data.error === "expired_token") {
+            throw new Error("Device code expired. Run `usesteady report` again.");
+        }
+        if (data.error === "access_denied") {
+            throw new Error("Authorization denied by user.");
+        }
+        throw new Error(`Unexpected error: ${data.error ?? "unknown"} — ${data.error_description ?? ""}`);
+    }
+    throw new Error("Authorization timed out. Run `usesteady report` again.");
+}
+// ─── Step 3: Fetch user profile ───────────────────────────────────────────────
+async function fetchUserProfile(token) {
+    const [userResp, emailsResp] = await Promise.all([
+        fetch(GITHUB_USER_URL, {
+            headers: {
+                "Authorization": `Bearer ${token}`,
+                "Accept": "application/vnd.github+json",
+                "X-GitHub-Api-Version": "2022-11-28",
+                "User-Agent": "usesteady",
+            },
+        }),
+        fetch(GITHUB_EMAILS_URL, {
+            headers: {
+                "Authorization": `Bearer ${token}`,
+                "Accept": "application/vnd.github+json",
+                "X-GitHub-Api-Version": "2022-11-28",
+                "User-Agent": "usesteady",
+            },
+        }),
+    ]);
+    const user = await userResp.json();
+    let email = user.email ?? undefined;
+    if (emailsResp.ok) {
+        const emails = await emailsResp.json();
+        const primary = emails.find((e) => e.primary && e.verified);
+        if (primary)
+            email = primary.email;
+    }
+    return { login: user.login, ...(email ? { email } : {}) };
+}
+// ─── Public: run the full device flow ────────────────────────────────────────
+/**
+ * Run the GitHub device-flow OAuth dance interactively.
+ *
+ * Prints the user code and verification URL to stdout, then polls
+ * until the user approves. Stores the resulting token in
+ * ~/.usesteady/auth.json and returns the AuthToken.
+ *
+ * @param onCode   called with { userCode, verificationUri } when ready to display
+ * @param onWaiting called each poll cycle while waiting for user
+ */
+export async function runDeviceFlow(opts) {
+    const codeResp = await requestDeviceCode();
+    opts?.onCode?.({
+        userCode: codeResp.user_code,
+        verificationUri: codeResp.verification_uri,
+    });
+    const token = await pollForToken(codeResp.device_code, codeResp.interval, codeResp.expires_in, opts?.onWaiting);
+    const { login, email } = await fetchUserProfile(token);
+    const authToken = {
+        githubToken: token,
+        githubLogin: login,
+        obtainedAt: new Date().toISOString(),
+        ...(email ? { githubEmail: email } : {}),
+    };
+    writeAuth(authToken);
+    return authToken;
+}
+//# sourceMappingURL=github-auth.js.map

package/dist/src/friction/github-auth.js.map

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

package/dist/src/friction/github-issues.d.ts

@@ -0,0 +1,51 @@
+/**
+ * src/friction/github-issues.ts
+ *
+ * Thin GitHub REST API client used by the friction admin reviewer.
+ * All operations target the collection repo configured in FrictionConfig.
+ */
+export interface GitHubIssue {
+    readonly number: number;
+    readonly title: string;
+    readonly body: string;
+    readonly html_url: string;
+    readonly state: "open" | "closed";
+    readonly labels: ReadonlyArray<{
+        name: string;
+    }>;
+    readonly user: {
+        login: string;
+    };
+    readonly created_at: string;
+}
+/**
+ * Fetch all open issues labelled `status/pending` from the collection repo.
+ * Pages up to 200 issues (2 pages of 100).
+ */
+export declare function fetchPendingIssues(repo: string, token: string): Promise<GitHubIssue[]>;
+/** Post a comment to an issue. */
+export declare function postComment(repo: string, issueNum: number, body: string, token: string): Promise<void>;
+/**
+ * Remove `removeLabel` from an issue and add `addLabel`.
+ * Silently ignores 404 on remove (label may already be absent).
+ */
+export declare function swapLabel(repo: string, issueNum: number, removeLabel: string, addLabel: string, token: string): Promise<void>;
+/** Close an issue (used when rejecting a friction report). */
+export declare function closeIssue(repo: string, issueNum: number, token: string): Promise<void>;
+/**
+ * Extract the structured metadata JSON block from an issue body.
+ * Returns null if the body doesn't contain a parseable block.
+ */
+export declare function parseIssueMetadata(body: string): Record<string, unknown> | null;
+/**
+ * Extract the plain-text context lines from the issue body.
+ * Returns an object with the human-readable fields.
+ */
+export declare function parseIssueContext(body: string): {
+    kind?: string;
+    taskInputs?: string[];
+    failureNote?: string;
+    phase?: string;
+    notes?: string;
+};
+//# sourceMappingURL=github-issues.d.ts.map

package/dist/src/friction/github-issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-issues.d.ts","sourceRoot":"","sources":["../../../src/friction/github-issues.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAO,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAQ,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAI,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAO,MAAM,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAM,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAQ;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AA4BD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAG,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAYxB;AAID,kCAAkC;AAClC,wBAAsB,WAAW,CAC/B,IAAI,EAAQ,MAAM,EAClB,QAAQ,EAAI,MAAM,EAClB,IAAI,EAAQ,MAAM,EAClB,KAAK,EAAO,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAS,MAAM,EACnB,QAAQ,EAAK,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAK,MAAM,EACnB,KAAK,EAAQ,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAef;AAED,8DAA8D;AAC9D,wBAAsB,UAAU,CAC9B,IAAI,EAAM,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAK,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQ/E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,IAAI,CAAC,EAAS,MAAM,CAAC;IACrB,UAAU,CAAC,EAAG,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAQ,MAAM,CAAC;IACrB,KAAK,CAAC,EAAQ,MAAM,CAAC;CACtB,CA0BA"}

package/dist/src/friction/github-issues.js

@@ -0,0 +1,118 @@
+// Copyright 2026 Shortgigs LLC. Licensed under the Apache License, Version 2.0.
+/**
+ * src/friction/github-issues.ts
+ *
+ * Thin GitHub REST API client used by the friction admin reviewer.
+ * All operations target the collection repo configured in FrictionConfig.
+ */
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function ghHeaders(token) {
+    return {
+        "Authorization": `Bearer ${token}`,
+        "Accept": "application/vnd.github+json",
+        "Content-Type": "application/json",
+        "X-GitHub-Api-Version": "2022-11-28",
+        "User-Agent": "usesteady/friction-reviewer",
+    };
+}
+async function ghFetch(url, token, init = {}) {
+    const resp = await fetch(url, {
+        ...init,
+        headers: { ...ghHeaders(token), ...(init.headers ?? {}) },
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => resp.statusText);
+        throw new Error(`GitHub API ${resp.status} ${resp.url}: ${text}`);
+    }
+    return resp;
+}
+// ─── Read ─────────────────────────────────────────────────────────────────────
+/**
+ * Fetch all open issues labelled `status/pending` from the collection repo.
+ * Pages up to 200 issues (2 pages of 100).
+ */
+export async function fetchPendingIssues(repo, token) {
+    const issues = [];
+    for (let page = 1; page <= 2; page++) {
+        const url = `https://api.github.com/repos/${repo}/issues?labels=status%2Fpending&state=open&per_page=100&page=${page}`;
+        const resp = await ghFetch(url, token);
+        const batch = await resp.json();
+        issues.push(...batch);
+        if (batch.length < 100)
+            break;
+    }
+    return issues;
+}
+// ─── Write ────────────────────────────────────────────────────────────────────
+/** Post a comment to an issue. */
+export async function postComment(repo, issueNum, body, token) {
+    await ghFetch(`https://api.github.com/repos/${repo}/issues/${issueNum}/comments`, token, { method: "POST", body: JSON.stringify({ body }) });
+}
+/**
+ * Remove `removeLabel` from an issue and add `addLabel`.
+ * Silently ignores 404 on remove (label may already be absent).
+ */
+export async function swapLabel(repo, issueNum, removeLabel, addLabel, token) {
+    // Add new label
+    await ghFetch(`https://api.github.com/repos/${repo}/issues/${issueNum}/labels`, token, { method: "POST", body: JSON.stringify({ labels: [addLabel] }) });
+    // Remove old label (ignore 404 if already missing)
+    const delUrl = `https://api.github.com/repos/${repo}/issues/${issueNum}/labels/${encodeURIComponent(removeLabel)}`;
+    const delResp = await fetch(delUrl, { method: "DELETE", headers: ghHeaders(token) });
+    if (!delResp.ok && delResp.status !== 404) {
+        const text = await delResp.text().catch(() => delResp.statusText);
+        throw new Error(`GitHub API ${delResp.status} on label delete: ${text}`);
+    }
+}
+/** Close an issue (used when rejecting a friction report). */
+export async function closeIssue(repo, issueNum, token) {
+    await ghFetch(`https://api.github.com/repos/${repo}/issues/${issueNum}`, token, { method: "PATCH", body: JSON.stringify({ state: "closed", state_reason: "not_planned" }) });
+}
+// ─── Issue body parser ────────────────────────────────────────────────────────
+/**
+ * Extract the structured metadata JSON block from an issue body.
+ * Returns null if the body doesn't contain a parseable block.
+ */
+export function parseIssueMetadata(body) {
+    try {
+        const match = body.match(/```json\s*(\{[\s\S]*?\})\s*```/);
+        if (!match?.[1])
+            return null;
+        return JSON.parse(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract the plain-text context lines from the issue body.
+ * Returns an object with the human-readable fields.
+ */
+export function parseIssueContext(body) {
+    const kindMatch = body.match(/\*\*Type:\*\*\s*(.+)/);
+    const phaseMatch = body.match(/\*\*Phase:\*\*\s*(.+)/);
+    const failMatch = body.match(/\*\*Failure note:\*\*\s*(.+)/);
+    const notesMatch = body.match(/### Notes from reporter\s+\n+([\s\S]+?)\n+###/);
+    // Task inputs: each line after "- **Task inputs:**" that starts with "  - "
+    const taskSection = body.match(/\*\*Task inputs:\*\*\n((?:  - .+\n?)+)/);
+    const taskSection1 = taskSection?.[1];
+    const taskInputs = taskSection1
+        ? taskSection1.split("\n").map(l => l.replace(/^  - /, "").trim()).filter(Boolean)
+        : undefined;
+    const result = {};
+    const kind = kindMatch?.[1]?.trim();
+    const phase = phaseMatch?.[1]?.trim();
+    const failureNote = failMatch?.[1]?.trim();
+    const notes = notesMatch?.[1]?.trim();
+    if (kind !== undefined)
+        result.kind = kind;
+    if (phase !== undefined)
+        result.phase = phase;
+    if (failureNote !== undefined)
+        result.failureNote = failureNote;
+    if (taskInputs !== undefined)
+        result.taskInputs = taskInputs;
+    if (notes !== undefined)
+        result.notes = notes;
+    return result;
+}
+//# sourceMappingURL=github-issues.js.map

package/dist/src/friction/github-issues.js.map

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

package/dist/src/friction/payout-ledger.d.ts

@@ -0,0 +1,45 @@
+/**
+ * src/friction/payout-ledger.ts
+ *
+ * Local SQLite ledger that records every admin decision (approved / rejected)
+ * made against a friction GitHub Issue.
+ *
+ * Approved entries accumulate until a payout batch is triggered.
+ * Rejected entries are kept for audit trail but excluded from payouts.
+ *
+ * DB path: ~/.usesteady/payout-ledger.sqlite
+ */
+export interface PayoutRecord {
+    readonly id: string;
+    readonly githubLogin: string;
+    readonly issueNumber: number;
+    readonly issueUrl: string;
+    readonly verdict: "approved" | "rejected";
+    readonly verdictReason: string;
+    readonly confidence: number;
+    readonly decidedAt: string;
+    readonly paidAt: string | null;
+}
+/** Record an approved or rejected decision. Idempotent on issue_number. */
+export declare function recordDecision(opts: {
+    githubLogin: string;
+    issueNumber: number;
+    issueUrl: string;
+    verdict: "approved" | "rejected";
+    verdictReason: string;
+    confidence: number;
+}): PayoutRecord;
+/** Return all approved, unpaid entries — the pending payout queue. */
+export declare function pendingPayouts(): PayoutRecord[];
+/** Return all entries (for display in `usesteady admin friction payouts`). */
+export declare function allDecisions(limit?: number): PayoutRecord[];
+/** Mark an approved entry as paid (after payment confirmation). */
+export declare function markPaid(id: string): void;
+/** Summary counts for display. */
+export declare function ledgerStats(): {
+    approved: number;
+    rejected: number;
+    paid: number;
+    pendingPayout: number;
+};
+//# sourceMappingURL=payout-ledger.d.ts.map

package/dist/src/friction/payout-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payout-ledger.d.ts","sourceRoot":"","sources":["../../../src/friction/payout-ledger.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAyCH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAa,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAI,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAI,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAO,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAQ,UAAU,GAAG,UAAU,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAK,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAM,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAS,MAAM,GAAG,IAAI,CAAC;CACvC;AA8BD,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,WAAW,EAAI,MAAM,CAAC;IACtB,WAAW,EAAI,MAAM,CAAC;IACtB,QAAQ,EAAO,MAAM,CAAC;IACtB,OAAO,EAAQ,UAAU,GAAG,UAAU,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAK,MAAM,CAAC;CACvB,GAAG,YAAY,CAkBf;AAED,sEAAsE;AACtE,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAO/C;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,SAAM,GAAG,YAAY,EAAE,CAOxD;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,kCAAkC;AAClC,wBAAgB,WAAW,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CASzG"}

package/dist/src/friction/payout-ledger.js

@@ -0,0 +1,111 @@
+// Copyright 2026 Shortgigs LLC. Licensed under the Apache License, Version 2.0.
+/**
+ * src/friction/payout-ledger.ts
+ *
+ * Local SQLite ledger that records every admin decision (approved / rejected)
+ * made against a friction GitHub Issue.
+ *
+ * Approved entries accumulate until a payout batch is triggered.
+ * Rejected entries are kept for audit trail but excluded from payouts.
+ *
+ * DB path: ~/.usesteady/payout-ledger.sqlite
+ */
+import Database from "better-sqlite3";
+import { existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+// ─── Setup ────────────────────────────────────────────────────────────────────
+const USESTEADY_DIR = join(homedir(), ".usesteady");
+const LEDGER_PATH = join(USESTEADY_DIR, "payout-ledger.sqlite");
+function openLedger() {
+    if (!existsSync(USESTEADY_DIR))
+        mkdirSync(USESTEADY_DIR, { recursive: true });
+    const db = new Database(LEDGER_PATH);
+    db.pragma("journal_mode = WAL");
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS payout_ledger (
+      id             TEXT    PRIMARY KEY,
+      github_login   TEXT    NOT NULL,
+      issue_number   INTEGER NOT NULL UNIQUE,
+      issue_url      TEXT    NOT NULL,
+      verdict        TEXT    NOT NULL CHECK(verdict IN ('approved','rejected')),
+      verdict_reason TEXT    NOT NULL,
+      confidence     INTEGER NOT NULL DEFAULT 0,
+      decided_at     TEXT    NOT NULL,
+      paid_at        TEXT    NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_ledger_verdict ON payout_ledger(verdict);
+    CREATE INDEX IF NOT EXISTS idx_ledger_paid    ON payout_ledger(paid_at);
+  `);
+    return db;
+}
+function rowToRecord(row) {
+    return {
+        id: row.id,
+        githubLogin: row.github_login,
+        issueNumber: row.issue_number,
+        issueUrl: row.issue_url,
+        verdict: row.verdict,
+        verdictReason: row.verdict_reason,
+        confidence: row.confidence,
+        decidedAt: row.decided_at,
+        paidAt: row.paid_at ?? null,
+    };
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/** Record an approved or rejected decision. Idempotent on issue_number. */
+export function recordDecision(opts) {
+    const db = openLedger();
+    const id = randomUUID();
+    const now = new Date().toISOString();
+    // INSERT OR IGNORE ensures the UNIQUE(issue_number) constraint is the single
+    // guard against double-payouts, even under concurrent admin runs.
+    db.prepare(`
+    INSERT OR IGNORE INTO payout_ledger
+      (id, github_login, issue_number, issue_url, verdict, verdict_reason, confidence, decided_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(id, opts.githubLogin, opts.issueNumber, opts.issueUrl, opts.verdict, opts.verdictReason, opts.confidence, now);
+    const row = db
+        .prepare("SELECT * FROM payout_ledger WHERE issue_number = ?")
+        .get(opts.issueNumber);
+    db.close();
+    return rowToRecord(row);
+}
+/** Return all approved, unpaid entries — the pending payout queue. */
+export function pendingPayouts() {
+    const db = openLedger();
+    const rows = db
+        .prepare("SELECT * FROM payout_ledger WHERE verdict = 'approved' AND paid_at IS NULL ORDER BY decided_at ASC")
+        .all();
+    db.close();
+    return rows.map(rowToRecord);
+}
+/** Return all entries (for display in `usesteady admin friction payouts`). */
+export function allDecisions(limit = 100) {
+    const db = openLedger();
+    const rows = db
+        .prepare("SELECT * FROM payout_ledger ORDER BY decided_at DESC LIMIT ?")
+        .all(limit);
+    db.close();
+    return rows.map(rowToRecord);
+}
+/** Mark an approved entry as paid (after payment confirmation). */
+export function markPaid(id) {
+    const db = openLedger();
+    const now = new Date().toISOString();
+    db.prepare("UPDATE payout_ledger SET paid_at = ? WHERE id = ? AND verdict = 'approved'").run(now, id);
+    db.close();
+}
+/** Summary counts for display. */
+export function ledgerStats() {
+    const db = openLedger();
+    const total = db.prepare("SELECT verdict, COUNT(*) as n FROM payout_ledger GROUP BY verdict").all();
+    const paid = db.prepare("SELECT COUNT(*) as n FROM payout_ledger WHERE paid_at IS NOT NULL").get().n;
+    db.close();
+    const approved = total.find(r => r.verdict === "approved")?.n ?? 0;
+    const rejected = total.find(r => r.verdict === "rejected")?.n ?? 0;
+    return { approved, rejected, paid, pendingPayout: approved - paid };
+}
+//# sourceMappingURL=payout-ledger.js.map

package/dist/src/friction/payout-ledger.js.map

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

package/dist/src/friction/queue.d.ts

@@ -0,0 +1,42 @@
+/**
+ * src/friction/queue.ts
+ *
+ * SQLite-backed local queue for friction events.
+ *
+ * Events are written here first (synchronously, fire-and-forget),
+ * then flushed to the collection backend asynchronously with retries.
+ * This ensures the core workflow path is never blocked or slowed.
+ *
+ * Storage: ~/.usesteady/friction-queue.db
+ * Schema:  one table — friction_queue
+ */
+import type { QueueEntry, FrictionEvent, QueueStatus } from "./types.js";
+/**
+ * Add a new friction event to the queue.
+ * Called synchronously (no await) from auto-capture hooks so the
+ * core workflow path is never delayed.
+ */
+export declare function enqueue(event: FrictionEvent): string;
+/**
+ * Return all entries with the given status.
+ */
+export declare function listByStatus(status: QueueStatus): QueueEntry[];
+/**
+ * Return pending entries older than `olderThanMs` milliseconds,
+ * up to `limit`. Used by the flush loop to pick retry candidates.
+ */
+export declare function pendingEntries(limit?: number): QueueEntry[];
+/**
+ * Mark an entry as successfully submitted.
+ */
+export declare function markSubmitted(id: string): void;
+export declare function markFailed(id: string, error: string): void;
+/**
+ * Delete submitted entries older than `keepDays` to keep the DB small.
+ */
+export declare function pruneSubmitted(keepDays?: number): number;
+/**
+ * Total counts by status — useful for CLI status display.
+ */
+export declare function queueStats(): Record<QueueStatus, number>;
+//# sourceMappingURL=queue.d.ts.map

package/dist/src/friction/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/friction/queue.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAuDzE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAgBpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE,CAS9D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAK,GAAG,UAAU,EAAE,CAYvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAU9C;AAQD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAiB1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,SAAK,GAAG,MAAM,CAWpD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAYxD"}