@vibesdotdev/hq 0.0.0-stage → 1.0.0-rc.1

package/dist/docs/hq.surfaces.docs.descriptor.js

@@ -0,0 +1,161 @@
+/**
+ * User-flow docs for HQ's fleet and terminal surfaces (Machines, Terminal, Sessions).
+ *
+ * Structurally typed, like the three sibling topics in this directory: this
+ * package does not depend on `@vibesdotdev/docs-contracts`, and the shape is
+ * validated for real against `DocsTopicDescriptorSchema` when the docs build
+ * reads it out of the registry.
+ */
+const hqSurfacesMarkdown = `---
+title: HQ Fleet & Terminal Surfaces
+summary: User flows for Machines, Terminal, and Sessions in HQ
+tags: [hq, fleet, terminal, sessions, machines]
+parent: hq
+order: 10
+id: hq.surfaces
+---
+
+# HQ Fleet & Terminal Surfaces
+
+HQ is the cloud operations layer for always-on AI agents, connected machines,
+and code sessions. The three core operational surfaces are:
+
+- **Machines** (\`/fleet\`) — register and manage the machines HQ can reach
+- **Terminal** (\`/terminal\`) — open a live terminal session on any online machine
+- **Sessions** (\`/sessions\`) — manage cloud and fleet code workspaces
+
+## Machines
+
+### Navigating to Machines
+
+From the sidebar, click **Machines** under Operations. The nav item maps to
+\`/fleet\`.
+
+### Adding your first machine
+
+On the empty state, click **Add your first machine**. This opens a dialog with
+two paths:
+
+1. **Install on a machine you own** — give the machine a name and get a
+   one-line install command. Paste it into a terminal on that machine. HQ polls
+   every 4 seconds and automatically closes the dialog once the machine comes
+   online.
+2. **Connect by address** — for machines that already have the fleet service
+   running, enter the host and port directly. Note: direct-address connections
+   require the local desktop app; use the install flow for cloud-persistent
+   registration.
+
+### Machine status indicators
+
+| Status | Meaning |
+|--------|---------|
+| Online | Machine is reachable and ready |
+| Enrolled, not reachable | Registered but currently unreachable (check your network or restart the fleet service) |
+| Connecting | Awaiting the first connection after enrollment |
+| Unknown | Reachability check pending |
+
+### Removing a machine
+
+Click the trash icon on a machine card, or open the details panel and click
+**Remove**. A confirmation dialog explains what will happen: open terminal
+sessions close, the machine leaves your fleet, and the service on that machine
+stops receiving connections. You can re-add it at any time.
+
+## Terminal
+
+### Navigating to Terminal
+
+Click **Terminal** in the sidebar, or click **Open terminal** on any online
+machine card in Machines.
+
+### Starting a session
+
+The host picker shows all online and enrolled machines. Select a machine,
+optionally set a custom command (default: \`bash\`), and click **Open**. The
+terminal connects over the HQ relay.
+
+### Multi-tab sessions
+
+Once a session is open, click **+** in the tab strip to open another session
+(on the same or a different machine). Each tab is an independent PTY; switching
+tabs detaches and re-attaches the underlying session automatically.
+
+### Reconnect behavior
+
+If the connection drops, a reconnect banner appears. HQ retries up to 8 times
+with exponential back-off. If all retries fail, click **Start a new session**
+to open a fresh connection.
+
+### Session end
+
+When a process exits, the pane shows "Session ended" with the exit code and a
+**Start a new session** button. The other tabs remain live.
+
+## Sessions
+
+### Navigating to Sessions
+
+Click **Sessions** in the sidebar. Sessions lists cloud sandbox workspaces and
+fleet-backed code environments.
+
+### Creating a session
+
+Click **New session**. The dialog lets you choose a host target (cloud sandbox
+or a fleet machine) and optionally bind a repository. Ephemeral sessions are
+cleaned up automatically when you navigate away.
+
+### Session capabilities
+
+- **Snapshot execution** — cloud sandbox sessions. Each command runs
+  independently; no persistent shell between runs. Shown in the transcript view.
+- **Interactive** — fleet-backed sessions with a full PTY. Use the **Open in
+  terminal** button to reach the Terminal view for that session.
+
+### Deleting a session
+
+Click **Delete** in the session detail header. A confirmation dialog warns that
+the workspace and all files inside it will be permanently removed.
+
+## Related
+
+:::card{title="See also"}
+- [\`agents\`](agents) — agent management and execution contracts
+- [\`fleet-pairing\`](fleet-pairing) — local fleet pairing and daemon setup
+:::
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'hq.surfaces',
+    title: 'HQ Fleet & Terminal Surfaces',
+    summary: 'User flows for Machines, Terminal, and Sessions in HQ',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: hqSurfacesMarkdown
+    },
+    parent: 'hq',
+    order: 10,
+    tags: ['hq', 'fleet', 'terminal', 'sessions', 'machines'],
+    surfaces: ['web'],
+    hardware: ['cloud', 'consumer'],
+    enabled: true,
+    man: {
+        name: 'hq.surfaces — Machines, Terminal, and Sessions in HQ',
+        section: 1,
+        synopsis: 'vibes man hq.surfaces',
+        options: [],
+        examples: [
+            {
+                description: 'Open a terminal on a registered machine',
+                command: 'navigate to /terminal?host=<machine-id>'
+            },
+            {
+                description: 'Add a new machine via install command',
+                command: 'navigate to /fleet → Add machine → Install'
+            }
+        ],
+        seeAlso: ['agents', 'fleet-pairing']
+    }
+};
+export default descriptor;
+//# sourceMappingURL=hq.surfaces.docs.descriptor.js.map

package/dist/docs/hq.surfaces.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.surfaces.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/hq.surfaces.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoH1B,CAAC;AAEF,MAAM,UAAU,GAAG;IAClB,IAAI,EAAE,YAAqB;IAC3B,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,8BAA8B;IACrC,OAAO,EAAE,uDAAuD;IAChE,IAAI,EAAE;QACL,IAAI,EAAE,UAAmB;QACzB,UAAU,EAAE,KAAc;QAC1B,MAAM,EAAE,kBAAkB;KAC1B;IACD,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;IACzD,QAAQ,EAAE,CAAC,KAAK,CAAU;IAC1B,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,CAAU;IACxC,OAAO,EAAE,IAAI;IACb,GAAG,EAAE;QACJ,IAAI,EAAE,sDAAsD;QAC5D,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,uBAAuB;QACjC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE;YACT;gBACC,WAAW,EAAE,yCAAyC;gBACtD,OAAO,EAAE,yCAAyC;aAClD;YACD;gBACC,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,4CAA4C;aACrD;SACD;QACD,OAAO,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;KACpC;CACD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/hq.terminal.docs.descriptor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * User-flow docs for the HQ Terminal surface.
+ */
+declare const descriptor: {
+    kind: "docs/topic";
+    id: string;
+    title: string;
+    summary: string;
+    body: {
+        type: "markdown";
+        sourceType: "raw";
+        source: string;
+    };
+    parent: string;
+    order: number;
+    tags: string[];
+    surfaces: readonly ["in-app", "web"];
+    hardware: readonly ["consumer"];
+    enabled: boolean;
+};
+export default descriptor;
+//# sourceMappingURL=hq.terminal.docs.descriptor.d.ts.map

package/dist/docs/hq.terminal.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.terminal.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/hq.terminal.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmEH,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;CAgBf,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/docs/hq.terminal.docs.descriptor.js

@@ -0,0 +1,86 @@
+/**
+ * User-flow docs for the HQ Terminal surface.
+ */
+const markdown = `---
+title: Terminal
+summary: Open interactive terminal sessions on this machine or any connected machine
+tags: [hq, terminal, sessions, pty]
+parent: hq
+order: 20
+---
+
+# Terminal
+
+The Terminal page gives you a full interactive shell — on this Mac, or on any machine you've
+connected through [Machines](hq.machines).
+
+## Opening a session
+
+1. Go to **Terminal** in the sidebar.
+2. Pick a machine from the host picker (defaults to This machine).
+3. Choose or type the shell or command to run.
+4. Click **Open** — the terminal opens immediately.
+
+## Switching between sessions (tabs)
+
+Each open session appears as a tab at the top. Click a tab to switch. The previous session
+keeps running in the background and reattaches when you switch back.
+
+Click **+** to open a new session while keeping the current one running.
+
+## Closing a session
+
+Click the × on a tab to close it. This kills the running shell. If the session has unsaved work
+you'll be prompted to confirm.
+
+## Reconnecting after a network drop
+
+If the connection drops, a yellow banner appears. HQ retries automatically up to 8 times with
+increasing delays. You'll see the attempt count and estimated time until the next retry.
+
+If reconnection fails permanently, click **Start a new session** to open a fresh one.
+
+## Denied commands
+
+Some commands are blocked by safety policies. When a command is denied, the terminal shows a
+readable message explaining which rule fired and where to change it. Contact your administrator
+to adjust the policy if you need access.
+
+## Keyboard shortcuts
+
+Standard terminal shortcuts work as expected: Ctrl-C, Ctrl-D, Ctrl-Z, arrow history, Tab
+completion. The terminal is a full PTY — interactive programs like \`vim\`, \`htop\`, and \`less\`
+all work.
+
+## Remote machines
+
+Select any online machine from the host picker to open a shell there. If no machines are
+connected, the picker shows a link to [Machines](hq.machines) where you can add one.
+
+If a remote machine goes offline mid-session, the reconnect banner appears and the same retry
+logic applies.
+
+## Related topics
+
+- [hq.machines](hq.machines) — connect a machine so it appears in the host picker
+- [hq.sessions](hq.sessions) — longer-lived sessions with workspace browsing
+`;
+const descriptor = {
+    kind: 'docs/topic',
+    id: 'hq.terminal',
+    title: 'Terminal',
+    summary: 'Open interactive terminal sessions on this machine or any connected machine',
+    body: {
+        type: 'markdown',
+        sourceType: 'raw',
+        source: markdown
+    },
+    parent: 'hq',
+    order: 20,
+    tags: ['hq', 'terminal', 'sessions', 'pty'],
+    surfaces: ['in-app', 'web'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=hq.terminal.docs.descriptor.js.map

package/dist/docs/hq.terminal.docs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.terminal.docs.descriptor.js","sourceRoot":"","sources":["../../src/docs/hq.terminal.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+DhB,CAAC;AAEF,MAAM,UAAU,GAAG;IACjB,IAAI,EAAE,YAAqB;IAC3B,EAAE,EAAE,aAAa;IACjB,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,6EAA6E;IACtF,IAAI,EAAE;QACJ,IAAI,EAAE,UAAmB;QACzB,UAAU,EAAE,KAAc;QAC1B,MAAM,EAAE,QAAQ;KACjB;IACD,MAAM,EAAE,IAAI;IACZ,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC;IAC3C,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAU;IACpC,QAAQ,EAAE,CAAC,UAAU,CAAU;IAC/B,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/friction/clusters.d.ts

@@ -0,0 +1,23 @@
+import { type FrictionSignalWithBackend, type ListFrictionSignalsFilter, type FrictionRuntime } from './store.ts';
+import type { FrictionDisposition } from './schemas/disposition.ts';
+export type FrictionClusterBackend = FrictionSignalWithBackend['backend'] | 'mixed';
+export interface FrictionCluster {
+    signatureHash: string;
+    representative: FrictionSignalWithBackend;
+    count: number;
+    firstSeen: string;
+    lastSeen: string;
+    backend: FrictionClusterBackend;
+    latestDisposition?: FrictionDisposition;
+}
+export type LatestDispositionsResolver = (signalIds: readonly string[]) => Promise<Map<string, FrictionDisposition>>;
+/**
+ * Materialize the read-only signature projection on demand. New friction emits
+ * are aggregate rows with occurrence-aware counts; legacy rows remain readable
+ * through the same projection. This combines the projection with the latest
+ * lifecycle disposition without writing a second cluster store.
+ */
+export declare function materializeFrictionClusters(signals: readonly FrictionSignalWithBackend[], resolveLatestDispositions: LatestDispositionsResolver): Promise<FrictionCluster[]>;
+/** Read clusters through the canonical friction store. */
+export declare function listFrictionClusters(runtime: FrictionRuntime, filter?: ListFrictionSignalsFilter): Promise<FrictionCluster[]>;
+//# sourceMappingURL=clusters.d.ts.map

package/dist/friction/clusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusters.d.ts","sourceRoot":"","sources":["../../src/friction/clusters.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;AAEpF,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,yBAAyB,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,sBAAsB,CAAC;IAChC,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;CACxC;AAED,MAAM,MAAM,0BAA0B,GAAG,CACxC,SAAS,EAAE,SAAS,MAAM,EAAE,KACxB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAS/C;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAChD,OAAO,EAAE,SAAS,yBAAyB,EAAE,EAC7C,yBAAyB,EAAE,0BAA0B,GACnD,OAAO,CAAC,eAAe,EAAE,CAAC,CAuD5B;AAED,0DAA0D;AAC1D,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,eAAe,EACxB,MAAM,GAAE,yBAA8B,GACpC,OAAO,CAAC,eAAe,EAAE,CAAC,CAI5B"}

package/dist/friction/clusters.js

@@ -0,0 +1,56 @@
+import { latestDispositionsBySignal, listFrictionSignalsWithBackend } from "./store.js";
+function newestSignal(current, candidate) {
+    return candidate.createdAt > current.createdAt ? candidate : current;
+}
+/**
+ * Materialize the read-only signature projection on demand. New friction emits
+ * are aggregate rows with occurrence-aware counts; legacy rows remain readable
+ * through the same projection. This combines the projection with the latest
+ * lifecycle disposition without writing a second cluster store.
+ */
+export async function materializeFrictionClusters(signals, resolveLatestDispositions) {
+    const grouped = new Map();
+    for (const signal of signals) {
+        const existing = grouped.get(signal.signatureHash);
+        if (existing) {
+            existing.representative = newestSignal(existing.representative, signal);
+            existing.count += 1;
+            existing.firstSeen = signal.createdAt < existing.firstSeen ? signal.createdAt : existing.firstSeen;
+            existing.lastSeen = signal.createdAt > existing.lastSeen ? signal.createdAt : existing.lastSeen;
+            existing.backends.add(signal.backend);
+            existing.signalIds.push(signal.id);
+            continue;
+        }
+        grouped.set(signal.signatureHash, {
+            representative: signal,
+            count: 1,
+            firstSeen: signal.createdAt,
+            lastSeen: signal.createdAt,
+            backends: new Set([signal.backend]),
+            signalIds: [signal.id]
+        });
+    }
+    const latestBySignal = await resolveLatestDispositions(signals.map((signal) => signal.id));
+    return [...grouped.entries()]
+        .map(([signatureHash, cluster]) => {
+        const latestDisposition = cluster.signalIds.reduce((latest, signalId) => {
+            const candidate = latestBySignal.get(signalId);
+            return !candidate || (latest && latest.createdAt >= candidate.createdAt) ? latest : candidate;
+        }, undefined);
+        return {
+            signatureHash,
+            representative: cluster.representative,
+            count: cluster.count,
+            firstSeen: cluster.firstSeen,
+            lastSeen: cluster.lastSeen,
+            backend: cluster.backends.size === 1 ? [...cluster.backends][0] : 'mixed',
+            latestDisposition
+        };
+    })
+        .sort((a, b) => b.lastSeen.localeCompare(a.lastSeen));
+}
+/** Read clusters through the canonical friction store. */
+export async function listFrictionClusters(runtime, filter = {}) {
+    return materializeFrictionClusters(await listFrictionSignalsWithBackend(runtime, filter), (signalIds) => latestDispositionsBySignal(runtime, signalIds));
+}
+//# sourceMappingURL=clusters.js.map

package/dist/friction/clusters.js.map

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

package/dist/friction/fingerprint.d.ts

@@ -0,0 +1,56 @@
+import type { FrictionSignal } from './schemas/signal.ts';
+/**
+ * Fingerprint version 2 deliberately excludes projection/body version and
+ * volatile occurrence provenance. It identifies the causal report, not the
+ * way a host happened to serialize or replay it.
+ */
+export declare const FRICTION_FINGERPRINT_VERSION: 2;
+export interface FrictionFingerprintInput {
+    orgId: string;
+    source: FrictionSignal['source'];
+    surface: string;
+    observed: string;
+    expected?: string;
+    repro?: string;
+}
+/**
+ * Compute the stable, tenant-scoped causal identity for a friction report.
+ * Web Crypto keeps this helper safe for both Bun consumers and workerd.
+ */
+export declare function computeFrictionFingerprint(input: FrictionFingerprintInput): Promise<string>;
+/**
+ * Fingerprint version 3 identifies a reported problem by its typed context
+ * instead of its free text (defect 2: a human report hashed its description,
+ * so two reports of one crash never merged, while the hash still pretended to
+ * dedupe).
+ *
+ * - A report that carries errors is keyed by the crash: org, app, route
+ *   template, and the latest error's normalized message and top stack frame.
+ *   Repeated crashes merge whatever the reporters wrote.
+ * - A report without errors is a distinct human report: it is keyed by its
+ *   first occurrence id, so a retried submit is idempotent but two people's
+ *   reports never merge.
+ *
+ * Signals without report context keep version 2 unchanged, so existing rows
+ * and other emitters keep merging under the `(orgId, fingerprintVersion,
+ * fingerprint)` index.
+ */
+export declare const FRICTION_REPORT_FINGERPRINT_VERSION: 3;
+export type FrictionSignalFingerprintInput = Pick<FrictionSignal, 'id' | 'orgId' | 'source' | 'surface' | 'observed' | 'expected' | 'repro' | 'context' | 'occurrenceId' | 'occurrenceIds'>;
+export interface FrictionSignalFingerprint {
+    version: number;
+    /** The bare digest, also stored as `signatureHash`. */
+    hash: string;
+    /** `v<version>:<hash>`, the stored `fingerprint`. */
+    fingerprint: string;
+}
+/** Volatile tokens (ids, hashes, numbers, quoted values) collapse so one crash has one message. */
+export declare function normalizeErrorMessage(message: string): string;
+/**
+ * The first stack frame, without line/column, query, or content-hashed chunk
+ * names, so one crash keeps one frame across builds of the same source.
+ */
+export declare function topStackFrame(stack: string | undefined): string;
+/** The versioned causal fingerprint of one signal; the one owner every writer uses. */
+export declare function computeFrictionSignalFingerprint(signal: FrictionSignalFingerprintInput): Promise<FrictionSignalFingerprint>;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/friction/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/friction/fingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAMvD,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYjG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mCAAmC,EAAG,CAAU,CAAC;AAE9D,MAAM,MAAM,8BAA8B,GAAG,IAAI,CAChD,cAAc,EACd,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,GAAG,eAAe,CACxH,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAc/D;AAaD,uFAAuF;AACvF,wBAAsB,gCAAgC,CAAC,MAAM,EAAE,8BAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CA0BjI"}

package/dist/friction/fingerprint.js

@@ -0,0 +1,113 @@
+/**
+ * Fingerprint version 2 deliberately excludes projection/body version and
+ * volatile occurrence provenance. It identifies the causal report, not the
+ * way a host happened to serialize or replay it.
+ */
+export const FRICTION_FINGERPRINT_VERSION = 2;
+function normalize(value) {
+    return (value ?? '').toLowerCase().trim().replace(/\s+/g, ' ');
+}
+/**
+ * Compute the stable, tenant-scoped causal identity for a friction report.
+ * Web Crypto keeps this helper safe for both Bun consumers and workerd.
+ */
+export async function computeFrictionFingerprint(input) {
+    const payload = JSON.stringify({
+        version: FRICTION_FINGERPRINT_VERSION,
+        orgId: input.orgId.trim(),
+        source: normalize(input.source),
+        surface: normalize(input.surface),
+        observed: normalize(input.observed),
+        expected: normalize(input.expected),
+        repro: normalize(input.repro)
+    });
+    const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(payload));
+    return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+/**
+ * Fingerprint version 3 identifies a reported problem by its typed context
+ * instead of its free text (defect 2: a human report hashed its description,
+ * so two reports of one crash never merged, while the hash still pretended to
+ * dedupe).
+ *
+ * - A report that carries errors is keyed by the crash: org, app, route
+ *   template, and the latest error's normalized message and top stack frame.
+ *   Repeated crashes merge whatever the reporters wrote.
+ * - A report without errors is a distinct human report: it is keyed by its
+ *   first occurrence id, so a retried submit is idempotent but two people's
+ *   reports never merge.
+ *
+ * Signals without report context keep version 2 unchanged, so existing rows
+ * and other emitters keep merging under the `(orgId, fingerprintVersion,
+ * fingerprint)` index.
+ */
+export const FRICTION_REPORT_FINGERPRINT_VERSION = 3;
+/** Volatile tokens (ids, hashes, numbers, quoted values) collapse so one crash has one message. */
+export function normalizeErrorMessage(message) {
+    return normalize(message)
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/g, '<id>')
+        .replace(/\b[0-9a-f]{8,}\b/g, '<hex>')
+        .replace(/(["'`]).*?\1/g, '<value>')
+        .replace(/\d+/g, '<n>');
+}
+/**
+ * The first stack frame, without line/column, query, or content-hashed chunk
+ * names, so one crash keeps one frame across builds of the same source.
+ */
+export function topStackFrame(stack) {
+    if (!stack)
+        return '';
+    // V8 opens with `Name: message`, which may itself contain `@`; frames start
+    // with `at ` (V8) or hold `fn@url` (Firefox, Safari), which never has a space before `@`.
+    const frame = stack
+        .split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.startsWith('at ') || /^[^\s@]*@\S/.test(line));
+    if (!frame)
+        return '';
+    return frame
+        .replace(/\?[^\s):]*/g, '')
+        .replace(/(:\d+)+(?=\)?$)/, '')
+        .replace(/\.[A-Za-z0-9_-]{6,}(?=\.(?:m?js|ts)\b)/g, '')
+        .toLowerCase();
+}
+function latestError(errors) {
+    let latest = errors[0];
+    for (const error of errors)
+        if (latest && error.at >= latest.at)
+            latest = error;
+    return latest;
+}
+async function sha256(payload) {
+    const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(payload));
+    return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+/** The versioned causal fingerprint of one signal; the one owner every writer uses. */
+export async function computeFrictionSignalFingerprint(signal) {
+    const context = signal.context;
+    if (!context) {
+        const hash = await computeFrictionFingerprint(signal);
+        return { version: FRICTION_FINGERPRINT_VERSION, hash, fingerprint: `v${FRICTION_FINGERPRINT_VERSION}:${hash}` };
+    }
+    const error = latestError(context.errors);
+    const payload = error
+        ? {
+            version: FRICTION_REPORT_FINGERPRINT_VERSION,
+            kind: 'crash',
+            orgId: signal.orgId.trim(),
+            source: normalize(signal.source),
+            app: context.appClientId ?? '',
+            route: normalize(context.route),
+            message: normalizeErrorMessage(error.message),
+            frame: topStackFrame(error.stack)
+        }
+        : {
+            version: FRICTION_REPORT_FINGERPRINT_VERSION,
+            kind: 'report',
+            orgId: signal.orgId.trim(),
+            occurrence: signal.occurrenceIds?.find((id) => id.trim()) ?? (signal.occurrenceId?.trim() || signal.id)
+        };
+    const hash = await sha256(JSON.stringify(payload));
+    return { version: FRICTION_REPORT_FINGERPRINT_VERSION, hash, fingerprint: `v${FRICTION_REPORT_FINGERPRINT_VERSION}:${hash}` };
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/friction/fingerprint.js.map

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

package/dist/friction/friction-dispositions.record.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+export declare const osFrictionDispositionsRecordDescriptor: StorageRecordDescriptorInput;
+export default osFrictionDispositionsRecordDescriptor;
+//# sourceMappingURL=friction-dispositions.record.descriptor.d.ts.map

package/dist/friction/friction-dispositions.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-dispositions.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/friction/friction-dispositions.record.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGxF,eAAO,MAAM,sCAAsC,EAAE,4BAgCpD,CAAC;AAEF,eAAe,sCAAsC,CAAC"}

package/dist/friction/friction-dispositions.record.descriptor.js

@@ -0,0 +1,36 @@
+import { FrictionDispositionSchema } from "./schemas/disposition.js";
+export const osFrictionDispositionsRecordDescriptor = {
+    kind: 'storage/record',
+    id: 'os.friction-dispositions',
+    name: 'OS Friction Dispositions',
+    description: 'Append-only triage and outcome history for OS friction signals',
+    schema: FrictionDispositionSchema,
+    tableName: 'os_friction_dispositions',
+    primaryKey: 'id',
+    relations: {},
+    indexes: [
+        { fields: ['signalId'], unique: false },
+        { fields: ['disposition'], unique: false },
+        { fields: ['createdAt'], unique: false }
+    ],
+    version: 1,
+    timestamps: false,
+    autoId: false,
+    allowedAdapters: ['storage.localdb'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: {
+        'storage.localdb': { dbName: 'os.db', scope: 'global' }
+    },
+    scope: 'global',
+    validateOnWrite: false,
+    validateOnRead: false,
+    versioning: false,
+    audit: false,
+    changeTracking: false,
+    internal: false,
+    softDelete: false,
+    namespace: 'os.friction-dispositions',
+    tags: ['os', 'friction', 'dispositions']
+};
+export default osFrictionDispositionsRecordDescriptor;
+//# sourceMappingURL=friction-dispositions.record.descriptor.js.map

package/dist/friction/friction-dispositions.record.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-dispositions.record.descriptor.js","sourceRoot":"","sources":["../../src/friction/friction-dispositions.record.descriptor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,CAAC,MAAM,sCAAsC,GAAiC;IACnF,IAAI,EAAE,gBAAgB;IACtB,EAAE,EAAE,0BAA0B;IAC9B,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,gEAAgE;IAC7E,MAAM,EAAE,yBAAyB;IACjC,SAAS,EAAE,0BAA0B;IACrC,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE;QACR,EAAE,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;QACvC,EAAE,MAAM,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;QAC1C,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;KACxC;IACD,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,KAAK;IACb,eAAe,EAAE,CAAC,iBAAiB,CAAC;IACpC,cAAc,EAAE,iBAAiB;IACjC,aAAa,EAAE;QACd,iBAAiB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE;KACvD;IACD,KAAK,EAAE,QAAQ;IACf,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,KAAK;IACrB,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,KAAK;IACZ,cAAc,EAAE,KAAK;IACrB,QAAQ,EAAE,KAAK;IACf,UAAU,EAAE,KAAK;IACjB,SAAS,EAAE,0BAA0B;IACrC,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC;CACxC,CAAC;AAEF,eAAe,sCAAsC,CAAC"}

package/dist/friction/friction-signals.record.descriptor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `os.friction-signals` v2 adds the optional typed `context` (a reported
+ * problem's page facts, `schemas/report.ts`). Migration path: the field is
+ * additive and optional, so v1 rows read unchanged under v2. Local rows are
+ * JSON documents (no SQL change); a cloud adapter with explicit columns adds
+ * a nullable `context` JSON column (hq-web D1, P1-5) before writing v2 rows.
+ * Report rows fingerprint as v3 (`fingerprint.ts`); others stay v2.
+ */
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+export declare const osFrictionSignalsRecordDescriptor: StorageRecordDescriptorInput;
+export default osFrictionSignalsRecordDescriptor;
+//# sourceMappingURL=friction-signals.record.descriptor.d.ts.map

package/dist/friction/friction-signals.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-signals.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/friction/friction-signals.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGxF,eAAO,MAAM,iCAAiC,EAAE,4BAiD/C,CAAC;AAEF,eAAe,iCAAiC,CAAC"}