usesteady 0.1.0-alpha.1

package/dist/src/friction/queue.js

@@ -0,0 +1,179 @@
+// Copyright 2026 Shortgigs LLC. Licensed under the Apache License, Version 2.0.
+/**
+ * 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 Database from "better-sqlite3";
+import { randomUUID } from "node:crypto";
+import { mkdirSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ─── Paths ────────────────────────────────────────────────────────────────────
+const USESTEADY_DIR = join(homedir(), ".usesteady");
+const DB_PATH = join(USESTEADY_DIR, "friction-queue.db");
+// ─── Lazy singleton DB ────────────────────────────────────────────────────────
+let _db = null;
+function db() {
+    if (_db)
+        return _db;
+    if (!existsSync(USESTEADY_DIR))
+        mkdirSync(USESTEADY_DIR, { recursive: true });
+    _db = new Database(DB_PATH);
+    _db.pragma("journal_mode = WAL");
+    _db.pragma("synchronous = NORMAL");
+    _db.exec(`
+    CREATE TABLE IF NOT EXISTS friction_queue (
+      id           TEXT PRIMARY KEY,
+      event_json   TEXT NOT NULL,
+      status       TEXT NOT NULL DEFAULT 'pending',
+      attempts     INTEGER NOT NULL DEFAULT 0,
+      created_at   TEXT NOT NULL,
+      submitted_at TEXT,
+      last_error   TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_status ON friction_queue (status);
+  `);
+    return _db;
+}
+// ─── Serialisation helpers ────────────────────────────────────────────────────
+function rowToEntry(row) {
+    const base = {
+        id: row["id"],
+        event: JSON.parse(row["event_json"]),
+        status: row["status"],
+        attempts: row["attempts"],
+        createdAt: row["created_at"],
+    };
+    return {
+        ...base,
+        ...(row["submitted_at"] ? { submittedAt: row["submitted_at"] } : {}),
+        ...(row["last_error"] ? { lastError: row["last_error"] } : {}),
+    };
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * 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 function enqueue(event) {
+    const id = randomUUID();
+    const now = new Date().toISOString();
+    try {
+        db().prepare(`
+      INSERT INTO friction_queue (id, event_json, status, attempts, created_at)
+      VALUES (?, ?, 'pending', 0, ?)
+    `).run(id, JSON.stringify(event), now);
+    }
+    catch (err) {
+        // Queue write failure must never propagate to the caller — this is a
+        // best-effort side-channel.
+        process.stderr.write(`[friction-queue] enqueue failed: ${String(err)}\n`);
+    }
+    return id;
+}
+/**
+ * Return all entries with the given status.
+ */
+export function listByStatus(status) {
+    try {
+        const rows = db().prepare("SELECT * FROM friction_queue WHERE status = ? ORDER BY created_at ASC").all(status);
+        return rows.map(rowToEntry);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Return pending entries older than `olderThanMs` milliseconds,
+ * up to `limit`. Used by the flush loop to pick retry candidates.
+ */
+export function pendingEntries(limit = 20) {
+    try {
+        const rows = db().prepare(`
+      SELECT * FROM friction_queue
+      WHERE  status = 'pending'
+      ORDER  BY created_at ASC
+      LIMIT  ?
+    `).all(limit);
+        return rows.map(rowToEntry);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Mark an entry as successfully submitted.
+ */
+export function markSubmitted(id) {
+    try {
+        db().prepare(`
+      UPDATE friction_queue
+      SET    status = 'submitted', submitted_at = ?, attempts = attempts + 1
+      WHERE  id = ?
+    `).run(new Date().toISOString(), id);
+    }
+    catch (err) {
+        process.stderr.write(`[friction-queue] markSubmitted failed: ${String(err)}\n`);
+    }
+}
+/**
+ * Record a submission attempt failure. After MAX_ATTEMPTS the entry
+ * is moved to 'failed' so it doesn't clog the retry loop forever.
+ */
+const MAX_ATTEMPTS = 5;
+export function markFailed(id, error) {
+    try {
+        const row = db().prepare("SELECT attempts FROM friction_queue WHERE id = ?").get(id);
+        const nextAttempts = (row?.attempts ?? 0) + 1;
+        const nextStatus = nextAttempts >= MAX_ATTEMPTS ? "failed" : "pending";
+        db().prepare(`
+      UPDATE friction_queue
+      SET    status = ?, attempts = ?, last_error = ?
+      WHERE  id = ?
+    `).run(nextStatus, nextAttempts, error, id);
+    }
+    catch (err) {
+        process.stderr.write(`[friction-queue] markFailed failed: ${String(err)}\n`);
+    }
+}
+/**
+ * Delete submitted entries older than `keepDays` to keep the DB small.
+ */
+export function pruneSubmitted(keepDays = 30) {
+    try {
+        const cutoff = new Date(Date.now() - keepDays * 86_400_000).toISOString();
+        const result = db().prepare(`
+      DELETE FROM friction_queue
+      WHERE  status = 'submitted' AND submitted_at < ?
+    `).run(cutoff);
+        return result.changes;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Total counts by status — useful for CLI status display.
+ */
+export function queueStats() {
+    try {
+        const rows = db().prepare("SELECT status, COUNT(*) AS cnt FROM friction_queue GROUP BY status").all();
+        const stats = { pending: 0, submitted: 0, failed: 0 };
+        for (const r of rows)
+            stats[r.status] = r.cnt;
+        return stats;
+    }
+    catch {
+        return { pending: 0, submitted: 0, failed: 0 };
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/src/friction/queue.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * src/friction/reviewer.ts
+ *
+ * AI-powered friction report classifier.
+ *
+ * Calls Claude claude-haiku-4-5 (cheap, fast) with a structured prompt to decide
+ * whether a submitted friction report represents genuine user friction worth
+ * paying out, or should be rejected (spam, nonsense, gaming the system).
+ *
+ * Uses the Anthropic Messages API directly via fetch — no SDK dependency.
+ * Requires ANTHROPIC_API_KEY in the environment.
+ */
+import type { GitHubIssue } from "./github-issues.js";
+/**
+ * Load ANTHROPIC_API_KEY from multiple locations in priority order:
+ *  1. process.env (already set by caller / CI)
+ *  2. ~/.usesteady/.env  (ops-specific, never committed)
+ *  3. <cwd>/.env.local
+ */
+export declare function loadAnthropicKey(): string | undefined;
+export type ReviewDecision = "approved" | "rejected" | "skip";
+export interface ReviewVerdict {
+    readonly decision: ReviewDecision;
+    readonly reason: string;
+    readonly confidence: number;
+}
+/**
+ * Classify a single GitHub friction issue.
+ * Uses Claude when ANTHROPIC_API_KEY is available; falls back to rule-based
+ * heuristics otherwise (good for demos and offline use).
+ * Returns a ReviewVerdict with decision, reason, and confidence.
+ */
+export declare function classifyReport(issue: GitHubIssue): Promise<ReviewVerdict>;
+/**
+ * Classify a batch of issues, printing progress to stderr.
+ * Returns results in the same order as the input array.
+ */
+export declare function classifyBatch(issues: GitHubIssue[]): Promise<Array<{
+    issue: GitHubIssue;
+    verdict: ReviewVerdict;
+}>>;
+//# sourceMappingURL=reviewer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../../src/friction/reviewer.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAA0B,oBAAoB,CAAC;AAG1E;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAmBrD;AAID,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAI,cAAc,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AA2MD;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CA8B/E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,WAAW,EAAE,GACpB,OAAO,CAAC,KAAK,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC,CAiBhE"}

package/dist/src/friction/reviewer.js

@@ -0,0 +1,269 @@
+// Copyright 2026 Shortgigs LLC. Licensed under the Apache License, Version 2.0.
+/**
+ * src/friction/reviewer.ts
+ *
+ * AI-powered friction report classifier.
+ *
+ * Calls Claude claude-haiku-4-5 (cheap, fast) with a structured prompt to decide
+ * whether a submitted friction report represents genuine user friction worth
+ * paying out, or should be rejected (spam, nonsense, gaming the system).
+ *
+ * Uses the Anthropic Messages API directly via fetch — no SDK dependency.
+ * Requires ANTHROPIC_API_KEY in the environment.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parseIssueContext, parseIssueMetadata } from "./github-issues.js";
+/**
+ * Load ANTHROPIC_API_KEY from multiple locations in priority order:
+ *  1. process.env (already set by caller / CI)
+ *  2. ~/.usesteady/.env  (ops-specific, never committed)
+ *  3. <cwd>/.env.local
+ */
+export function loadAnthropicKey() {
+    if (process.env["ANTHROPIC_API_KEY"])
+        return process.env["ANTHROPIC_API_KEY"];
+    const candidates = [
+        join(homedir(), ".usesteady", ".env"),
+        join(process.cwd(), ".env.local"),
+        join(process.cwd(), ".env"),
+    ];
+    for (const path of candidates) {
+        if (!existsSync(path))
+            continue;
+        const lines = readFileSync(path, "utf-8").split("\n");
+        for (const line of lines) {
+            const m = line.match(/^\s*ANTHROPIC_API_KEY\s*=\s*(.+)\s*$/);
+            if (m?.[1])
+                return m[1].trim().replace(/^["']|["']$/g, "");
+        }
+    }
+    return undefined;
+}
+// ─── Prompt ───────────────────────────────────────────────────────────────────
+const SYSTEM_PROMPT = `\
+You are a senior UX reviewer for UseSteady, a developer workflow tool.
+Your job is to evaluate user-submitted "friction reports" and decide whether
+each one represents genuine user friction that Shortgigs LLC should pay out.
+
+UseSteady is a CLI/UI tool that lets developers run governed, step-by-step
+code changes. Users submit a natural-language task (e.g. "rename Button.tsx
+to PrimaryButton.tsx"), review it before it runs, and approve each step.
+
+The intake system rejects tasks it cannot parse into a supported operation.
+Supported operations are things like: mkdir, create file, rename file, move
+file, delete file, run script. Intentionally vague or multi-scope instructions
+like "fix everything" or "refactor the app" are correctly rejected.
+
+APPROVAL CRITERIA (pay the reporter):
+- The task input is something a reasonable developer would type, expecting it
+  to work (e.g. "update the README", "add a test for login", "fix the linter")
+- The error feedback the user received was unclear or didn't tell them what to
+  do instead
+- The friction was real — the user genuinely didn't know how to proceed
+- Auto-captured failures (kind: workflow-failure) are approved if the task
+  input is natural and the failure note shows skipped_by_intake
+
+REJECTION CRITERIA (do not pay):
+- The task input is obviously nonsensical, a test string, or intentionally
+  designed to trigger an error (e.g. "aaa", "test", "do the thing", "???")
+- The reporter is clearly gaming the system (submitting the same failure
+  repeatedly with trivially invalid inputs)
+- The kind is "server-error" and the error is an infrastructure problem,
+  not a UX friction point
+- The issue looks like a duplicate of another already-approved issue in the
+  same session (same runId prefix)
+
+SKIP (needs human review):
+- Ambiguous cases where you are less than 60% confident
+- Reports where the context is missing or truncated
+
+Respond ONLY with a JSON object (no markdown fences), structured like:
+{
+  "decision": "approved" | "rejected" | "skip",
+  "reason": "one or two sentence explanation",
+  "confidence": 0-100
+}`;
+/**
+ * Strip prompt-injection patterns from reporter-controlled strings before
+ * they are included in the Claude user message.  We remove sequences that
+ * attempt to address the system/assistant role or escape the data boundary.
+ */
+function sanitizeField(raw, maxLen = 300) {
+    if (!raw)
+        return "(none)";
+    return raw
+        .slice(0, maxLen)
+        // Remove instruction-like role markers that could hijack the model.
+        .replace(/\b(ignore|disregard|forget)\b.{0,60}(instruction|above|prior|previous|system|prompt)/gi, "[redacted]")
+        .replace(/<\/?(?:system|assistant|user|instruction)>/gi, "[redacted]")
+        // Strip markdown code fences that might be used to smuggle structured output.
+        .replace(/```[\s\S]*?```/g, "[code-block]")
+        .trim();
+}
+function buildUserMessage(issue) {
+    const ctx = parseIssueContext(issue.body);
+    const meta = parseIssueMetadata(issue.body);
+    // All reporter-controlled fields are sanitized before inclusion.
+    const taskInputs = (ctx.taskInputs ?? []).map(t => sanitizeField(t, 200)).join("; ") || "(none)";
+    const failureNote = sanitizeField(ctx.failureNote);
+    const notes = ctx.notes ? `Reporter notes: ${sanitizeField(ctx.notes)}` : "";
+    const kind = sanitizeField(ctx.kind ?? meta?.["kind"], 50);
+    const phase = sanitizeField(ctx.phase, 50);
+    // Issue title is reporter-controlled too (used as the friction "headline").
+    const title = sanitizeField(issue.title, 200);
+    return [
+        `Issue #${issue.number}: ${title}`,
+        ``,
+        `Kind: ${kind}`,
+        `Phase: ${phase}`,
+        `Task inputs: ${taskInputs}`,
+        `Failure note: ${failureNote}`,
+        notes,
+        `Reporter: @${issue.user.login}`,
+        `Captured: ${meta?.["capturedAt"] ?? issue.created_at}`,
+        `UseSteady version: ${meta?.["usesteadyVersion"] ?? "unknown"}`,
+    ].filter(Boolean).join("\n");
+}
+async function callClaude(userMessage) {
+    const apiKey = loadAnthropicKey();
+    if (!apiKey) {
+        throw new Error("ANTHROPIC_API_KEY is not set.\n" +
+            "  Add it to ~/.usesteady/.env:\n" +
+            "    ANTHROPIC_API_KEY=sk-ant-...\n" +
+            "  Or set it as an environment variable before running.");
+    }
+    const resp = await fetch("https://api.anthropic.com/v1/messages", {
+        method: "POST",
+        headers: {
+            "x-api-key": apiKey,
+            "anthropic-version": "2023-06-01",
+            "content-type": "application/json",
+        },
+        body: JSON.stringify({
+            model: "claude-haiku-4-5",
+            max_tokens: 256,
+            system: SYSTEM_PROMPT,
+            messages: [{ role: "user", content: userMessage }],
+        }),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => resp.statusText);
+        throw new Error(`Anthropic API ${resp.status}: ${text}`);
+    }
+    const data = await resp.json();
+    const text = data.content.find(b => b.type === "text")?.text ?? "";
+    return text.trim();
+}
+// ─── Rule-based fallback ──────────────────────────────────────────────────────
+const JUNK_PATTERNS = [
+    /^(test|aaa+|bbb+|xxx+|zzz+|foo|bar|baz|\?+|\.+|123+|abc)$/i,
+    /^.{1,3}$/, // fewer than 4 chars
+];
+const NATURAL_LANGUAGE_SIGNALS = [
+    /\b(add|create|update|fix|remove|rename|delete|move|refactor|change|install|run|build|generate)\b/i,
+    /\b(file|folder|component|function|class|test|style|config|readme|button|page|route|api)\b/i,
+];
+/**
+ * Rule-based classifier — runs when ANTHROPIC_API_KEY is unavailable.
+ * Deterministic, free, and good enough for obvious cases.
+ */
+function ruleBasedClassify(issue) {
+    const ctx = parseIssueContext(issue.body);
+    const inputs = ctx.taskInputs ?? [];
+    const primaryInput = inputs[0] ?? "";
+    const failureNote = ctx.failureNote ?? "";
+    const kind = ctx.kind ?? "";
+    // Server errors are not UX friction — skip for human review
+    if (kind === "server-error") {
+        return { decision: "skip", reason: "Server errors need manual review.", confidence: 70 };
+    }
+    // Obvious junk inputs — reject
+    for (const pattern of JUNK_PATTERNS) {
+        if (pattern.test(primaryInput.trim())) {
+            return {
+                decision: "rejected",
+                reason: `Task input "${primaryInput}" is too short or pattern-matches known junk.`,
+                confidence: 90,
+            };
+        }
+    }
+    // skipped_by_intake with natural-language input — approve
+    const isSkippedByIntake = failureNote.includes("skipped_by_intake");
+    const looksNatural = NATURAL_LANGUAGE_SIGNALS.some(p => p.test(primaryInput));
+    if (isSkippedByIntake && looksNatural && primaryInput.length > 8) {
+        return {
+            decision: "approved",
+            reason: `Task "${primaryInput}" looks like genuine natural language that intake should handle better.`,
+            confidence: 72,
+        };
+    }
+    if (isSkippedByIntake && primaryInput.length > 8) {
+        return {
+            decision: "skip",
+            reason: `Task "${primaryInput}" — skipped_by_intake but language is ambiguous. Needs human review.`,
+            confidence: 55,
+        };
+    }
+    return {
+        decision: "skip",
+        reason: "Could not determine validity with rule-based classifier. Set ANTHROPIC_API_KEY for AI review.",
+        confidence: 0,
+    };
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Classify a single GitHub friction issue.
+ * Uses Claude when ANTHROPIC_API_KEY is available; falls back to rule-based
+ * heuristics otherwise (good for demos and offline use).
+ * Returns a ReviewVerdict with decision, reason, and confidence.
+ */
+export async function classifyReport(issue) {
+    // Use rule-based fallback when no API key is configured
+    if (!loadAnthropicKey()) {
+        return ruleBasedClassify(issue);
+    }
+    try {
+        const userMessage = buildUserMessage(issue);
+        const raw = await callClaude(userMessage);
+        // Strip any accidental markdown fences
+        const json = raw.replace(/^```(?:json)?\s*/i, "").replace(/```\s*$/, "").trim();
+        const parsed = JSON.parse(json);
+        const decision = ["approved", "rejected", "skip"].includes(parsed.decision)
+            ? parsed.decision
+            : "skip";
+        const reason = typeof parsed.reason === "string" ? parsed.reason : "No reason returned.";
+        const confidence = typeof parsed.confidence === "number"
+            ? Math.max(0, Math.min(100, Math.round(parsed.confidence)))
+            : 50;
+        return { decision, reason, confidence };
+    }
+    catch (err) {
+        return {
+            decision: "skip",
+            reason: `Classifier error: ${String(err)}`,
+            confidence: 0,
+        };
+    }
+}
+/**
+ * Classify a batch of issues, printing progress to stderr.
+ * Returns results in the same order as the input array.
+ */
+export async function classifyBatch(issues) {
+    const results = [];
+    for (let i = 0; i < issues.length; i++) {
+        const issue = issues[i];
+        process.stderr.write(`  Classifying #${issue.number} (${i + 1}/${issues.length})...\r`);
+        const verdict = await classifyReport(issue);
+        results.push({ issue, verdict });
+        // Polite delay to avoid rate limits
+        if (i < issues.length - 1) {
+            await new Promise(r => setTimeout(r, 500));
+        }
+    }
+    process.stderr.write(" ".repeat(60) + "\r"); // clear progress line
+    return results;
+}
+//# sourceMappingURL=reviewer.js.map

package/dist/src/friction/reviewer.js.map

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

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

@@ -0,0 +1,63 @@
+/**
+ * src/friction/types.ts
+ *
+ * Shared types for the friction capture pipeline.
+ *
+ * Design rules:
+ *  - All types are plain data (no methods, no class instances).
+ *  - Nothing here imports from the workflow domain — friction capture
+ *    is a side-channel; it must never block or slow the core path.
+ *  - The admin / payout / collection backend types live in the private
+ *    the private ops repo and are NOT exported from here.
+ */
+export type FrictionKind = "workflow-failure" | "server-error" | "ux-block" | "install-error" | "manual-cli";
+export interface FrictionEvent {
+    readonly kind: FrictionKind;
+    readonly capturedAt: string;
+    readonly usesteadyVersion: string;
+    readonly context: FrictionContext;
+    readonly notes?: string;
+}
+export interface FrictionContext {
+    readonly runId?: string;
+    readonly phase?: string;
+    readonly taskInputs?: readonly string[];
+    readonly failureNote?: string;
+    readonly workspaceRoot?: string;
+    readonly errorMessage?: string;
+    readonly errorStack?: string;
+    readonly route?: string;
+    readonly platform?: string;
+    readonly nodeVersion?: string;
+}
+export type QueueStatus = "pending" | "submitted" | "failed";
+export interface QueueEntry {
+    readonly id: string;
+    readonly event: FrictionEvent;
+    readonly status: QueueStatus;
+    readonly attempts: number;
+    readonly createdAt: string;
+    readonly submittedAt?: string;
+    readonly lastError?: string;
+}
+export interface FrictionReport {
+    readonly id: string;
+    readonly kind: FrictionKind;
+    readonly reporterGitHub?: string;
+    readonly event: FrictionEvent;
+    readonly submittedAt: string;
+}
+export interface AuthToken {
+    readonly githubToken: string;
+    readonly githubLogin: string;
+    readonly githubEmail?: string;
+    readonly obtainedAt: string;
+}
+export interface FrictionConfig {
+    /** GitHub API endpoint for issue creation. Default: Shortgigs collection repo. */
+    readonly frictionEndpoint: string;
+    /** GitHub repo slug for label + issue management. */
+    readonly frictionRepo: string;
+}
+export declare const DEFAULT_FRICTION_CONFIG: FrictionConfig;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/friction/types.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAIH,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,eAAe,GACf,YAAY,CAAC;AAIjB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAc,YAAY,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAQ,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAW,eAAe,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAY,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,KAAK,CAAC,EAAQ,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAQ,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAG,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAGhC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAI,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAS,MAAM,CAAC;IAG/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAID,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAW,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAQ,aAAa,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAO,WAAW,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAK,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAI,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAG,MAAM,CAAC;CAC9B;AAID,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAc,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAY,YAAY,CAAC;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAW,aAAa,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAK,MAAM,CAAC;CACjC;AAID,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAK,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAK,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAI,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAM,MAAM,CAAC;CACjC;AAID,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAM,MAAM,CAAC;CACnC;AAED,eAAO,MAAM,uBAAuB,EAAE,cAGrC,CAAC"}

package/dist/src/friction/types.js

@@ -0,0 +1,18 @@
+// Copyright 2026 Shortgigs LLC. Licensed under the Apache License, Version 2.0.
+/**
+ * src/friction/types.ts
+ *
+ * Shared types for the friction capture pipeline.
+ *
+ * Design rules:
+ *  - All types are plain data (no methods, no class instances).
+ *  - Nothing here imports from the workflow domain — friction capture
+ *    is a side-channel; it must never block or slow the core path.
+ *  - The admin / payout / collection backend types live in the private
+ *    the private ops repo and are NOT exported from here.
+ */
+export const DEFAULT_FRICTION_CONFIG = {
+    frictionEndpoint: "https://api.github.com/repos/<your-org>/<your-friction-repo>/issues",
+    frictionRepo: "<your-org>/<your-friction-repo>",
+};
+//# sourceMappingURL=types.js.map

package/dist/src/friction/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/friction/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF;;;;;;;;;;;GAWG;AAiFH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,gBAAgB,EAAE,qEAAqE;IACvF,YAAY,EAAM,iCAAiC;CACpD,CAAC"}

package/dist/src/history/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Phase 10B: History / Audit — public API.
+ *
+ * ── What this module exports ──────────────────────────────────────────────────
+ *
+ *   Types     — WorkflowHistorySummary, WorkflowAuditRecord, SessionChain, etc.
+ *   Tier 1    — getWorkflowHistories(storeDir)
+ *   Tier 2    — getWorkflowAuditRecord(storeDir, workflowRunId)
+ *   Internals — buildSessionChain (exposed for testing and advanced consumers)
+ *
+ * ── Authority ─────────────────────────────────────────────────────────────────
+ *
+ *   Zero. The history module is entirely read-only.
+ *   It imports from src/ucp/persistence/ only.
+ *   It accepts storeDir strings — never live WorkflowRun objects.
+ *
+ * ── Consumer pattern ──────────────────────────────────────────────────────────
+ *
+ *   // Tier 1 — list all completed/stopped runs (cheap):
+ *   const summaries = getWorkflowHistories(storeDir);
+ *   for (const s of summaries) { ... s.workflowName, s.finalOutcome, s.tasks ... }
+ *
+ *   // Tier 2 — full provenance for one run (expensive):
+ *   const audit = getWorkflowAuditRecord(storeDir, workflowRunId);
+ *   if (audit) {
+ *     for (const t of audit.tasks) {
+ *       if (t.session?.cursorReceipt) { ... }
+ *       if (t.session?.cursorRefused) { ... }
+ *     }
+ *   }
+ *
+ * See: docs/phase-10a-history-audit-design.md — design record
+ *      docs/phase-10b-baseline.md             — implementation freeze
+ */
+export type { HistoryTaskOutcome, WorkflowTaskHistoryEntry, WorkflowHistorySummary, SessionChain, WorkflowTaskAuditEntry, WorkflowAuditRecord, } from "./types.js";
+export { getWorkflowHistories } from "./workflow-history.js";
+export { getWorkflowAuditRecord } from "./workflow-history.js";
+export { buildSessionChain } from "./session-chain.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/history/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAI7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAI/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}