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

package/dist/friction/jobs/friction-clusters.job.descriptor.d.ts

@@ -0,0 +1,71 @@
+import * as z from 'zod/v4';
+export declare const FrictionClusterJobInputSchema: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodObject<{
+        source: z.ZodOptional<z.ZodEnum<{
+            "agent-self-observed": "agent-self-observed";
+            "agent-watched-user": "agent-watched-user";
+            "rum-error": "rum-error";
+            "chat-confusion": "chat-confusion";
+            "incomplete-marker": "incomplete-marker";
+            "user-explicit": "user-explicit";
+            "support-ticket": "support-ticket";
+            "telemetry-signal": "telemetry-signal";
+        }>>;
+        audience: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            agent: "agent";
+            both: "both";
+        }>>;
+        surface: z.ZodOptional<z.ZodString>;
+        since: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const FrictionClusterJobOutputSchema: z.ZodObject<{
+    clusters: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>;
+export type FrictionClusterJobInput = z.infer<typeof FrictionClusterJobInputSchema>;
+declare const _default: {
+    id: string;
+    kind: "workers/job";
+    queue: string;
+    schemas: {
+        input: z.ZodObject<{
+            filter: z.ZodOptional<z.ZodObject<{
+                source: z.ZodOptional<z.ZodEnum<{
+                    "agent-self-observed": "agent-self-observed";
+                    "agent-watched-user": "agent-watched-user";
+                    "rum-error": "rum-error";
+                    "chat-confusion": "chat-confusion";
+                    "incomplete-marker": "incomplete-marker";
+                    "user-explicit": "user-explicit";
+                    "support-ticket": "support-ticket";
+                    "telemetry-signal": "telemetry-signal";
+                }>>;
+                audience: z.ZodOptional<z.ZodEnum<{
+                    user: "user";
+                    agent: "agent";
+                    both: "both";
+                }>>;
+                surface: z.ZodOptional<z.ZodString>;
+                since: z.ZodOptional<z.ZodString>;
+                limit: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        output: z.ZodObject<{
+            clusters: z.ZodArray<z.ZodUnknown>;
+        }, z.core.$strip>;
+    };
+    retries: {
+        maxAttempts: number;
+    };
+    timeout: number;
+    isolation: "subprocess";
+    metadata: {
+        description: string;
+        feature: string;
+    };
+    enabled: boolean;
+};
+export default _default;
+//# sourceMappingURL=friction-clusters.job.descriptor.d.ts.map

package/dist/friction/jobs/friction-clusters.job.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-clusters.job.descriptor.d.ts","sourceRoot":"","sources":["../../../src/friction/jobs/friction-clusters.job.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;iBAUxC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;iBAEzC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEpF,wBAgBE"}

package/dist/friction/jobs/friction-clusters.job.descriptor.js

@@ -0,0 +1,34 @@
+import * as z from 'zod/v4';
+import { FrictionAudienceSchema, FrictionSourceSchema } from "../schemas/signal.js";
+export const FrictionClusterJobInputSchema = z.object({
+    filter: z
+        .object({
+        source: FrictionSourceSchema.optional(),
+        audience: FrictionAudienceSchema.optional(),
+        surface: z.string().optional(),
+        since: z.string().optional(),
+        limit: z.number().int().positive().optional()
+    })
+        .optional()
+});
+export const FrictionClusterJobOutputSchema = z.object({
+    clusters: z.array(z.unknown())
+});
+export default {
+    id: 'hq.friction.cluster',
+    kind: 'workers/job',
+    queue: 'hq-friction',
+    schemas: {
+        input: FrictionClusterJobInputSchema,
+        output: FrictionClusterJobOutputSchema
+    },
+    retries: { maxAttempts: 1 },
+    timeout: 30_000,
+    isolation: 'subprocess',
+    metadata: {
+        description: 'Materialize the read-only friction signature cluster projection.',
+        feature: 'hq-friction'
+    },
+    enabled: true
+};
+//# sourceMappingURL=friction-clusters.job.descriptor.js.map

package/dist/friction/jobs/friction-clusters.job.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-clusters.job.descriptor.js","sourceRoot":"","sources":["../../../src/friction/jobs/friction-clusters.job.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEpF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,EAAE,CAAC;SACP,MAAM,CAAC;QACP,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE;QACvC,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE;QAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;KAC7C,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;CAC9B,CAAC,CAAC;AAIH,eAAe;IACd,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,aAAsB;IAC5B,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE;QACR,KAAK,EAAE,6BAA6B;QACpC,MAAM,EAAE,8BAA8B;KACtC;IACD,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE;IAC3B,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,YAAqB;IAChC,QAAQ,EAAE;QACT,WAAW,EAAE,kEAAkE;QAC/E,OAAO,EAAE,aAAa;KACtB;IACD,OAAO,EAAE,IAAI;CACb,CAAC"}

package/dist/friction/jobs/friction-clusters.job.impl.d.ts

@@ -0,0 +1,22 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { JobDescriptor, JobExecutionContext } from '@vibesdotdev/kernel/kinds';
+import type { FrictionCluster } from '../clusters.ts';
+import { type FrictionClusterJobInput } from './friction-clusters.job.descriptor.ts';
+/**
+ * Materialize friction clusters on the runtime that constructed the job (the
+ * `workers/job` kind hands it `context.runtime`), never the host's default.
+ */
+declare class FrictionClustersJob {
+    readonly descriptor: JobDescriptor;
+    readonly id: string;
+    private readonly runtime;
+    constructor(descriptor: JobDescriptor, context: {
+        runtime?: VibesRuntime;
+    });
+    handle(context: Pick<JobExecutionContext<FrictionClusterJobInput>, 'data'>): Promise<{
+        clusters: FrictionCluster[];
+    }>;
+}
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<typeof FrictionClustersJob>;
+export default _default;
+//# sourceMappingURL=friction-clusters.job.impl.d.ts.map

package/dist/friction/jobs/friction-clusters.job.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-clusters.job.impl.d.ts","sourceRoot":"","sources":["../../../src/friction/jobs/friction-clusters.job.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAiC,KAAK,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEpH;;;GAGG;AACH,cAAM,mBAAmB;IAKvB,QAAQ,CAAC,UAAU,EAAE,aAAa;IAJnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAG7B,UAAU,EAAE,aAAa,EAClC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,YAAY,CAAA;KAAE;IAY9B,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;CAI3H;;AAED,wBAIG"}

package/dist/friction/jobs/friction-clusters.job.impl.js

@@ -0,0 +1,33 @@
+import { CapabilityError, createRuntimeImplementation } from '@vibesdotdev/kernel';
+import { listFrictionClusters } from "../clusters.js";
+import { FrictionClusterJobInputSchema } from "./friction-clusters.job.descriptor.js";
+/**
+ * Materialize friction clusters on the runtime that constructed the job (the
+ * `workers/job` kind hands it `context.runtime`), never the host's default.
+ */
+class FrictionClustersJob {
+    descriptor;
+    id;
+    runtime;
+    constructor(descriptor, context) {
+        this.descriptor = descriptor;
+        this.id = descriptor.id;
+        if (!context?.runtime) {
+            throw new CapabilityError('The friction cluster job was constructed without its runtime.', 'INTERNAL', {
+                reason: 'runtime-invalid',
+                retryable: false
+            });
+        }
+        this.runtime = context.runtime;
+    }
+    async handle(context) {
+        const input = FrictionClusterJobInputSchema.parse(context.data);
+        return { clusters: await listFrictionClusters(this.runtime, input.filter) };
+    }
+}
+export default createRuntimeImplementation({
+    id: 'hq.friction.cluster',
+    kind: 'workers/job',
+    implementation: FrictionClustersJob
+});
+//# sourceMappingURL=friction-clusters.job.impl.js.map

package/dist/friction/jobs/friction-clusters.job.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-clusters.job.impl.js","sourceRoot":"","sources":["../../../src/friction/jobs/friction-clusters.job.impl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAqB,MAAM,qBAAqB,CAAC;AAGtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAgC,MAAM,uCAAuC,CAAC;AAEpH;;;GAGG;AACH,MAAM,mBAAmB;IAKd;IAJD,EAAE,CAAS;IACH,OAAO,CAAe;IAEvC,YACU,UAAyB,EAClC,OAAmC;QAD1B,eAAU,GAAV,UAAU,CAAe;QAGlC,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YACvB,MAAM,IAAI,eAAe,CAAC,+DAA+D,EAAE,UAAU,EAAE;gBACtG,MAAM,EAAE,iBAAiB;gBACzB,SAAS,EAAE,KAAK;aAChB,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAmE;QAC/E,MAAM,KAAK,GAAG,6BAA6B,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7E,CAAC;CACD;AAED,eAAe,2BAA2B,CAAC;IAC1C,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,aAAa;IACnB,cAAc,EAAE,mBAAmB;CACnC,CAAC,CAAC"}

package/dist/friction/promote-input.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Promote-a-signal → work-item create input — the ONE home for the promote
+ * convention (title cap, description body, severity→priority table, tags and
+ * the metadata back-link). Both promote paths consume this so a signal
+ * promotes to the SAME work item no matter which surface fired it:
+ *
+ *  - the CLI command (`cli/friction/hq.friction.promote.impl.ts`)
+ *  - the friction runtime/client's `promoteInput` (`client/friction/index.ts`),
+ *    which the /work-items TUI's "Promote to task" action calls.
+ *
+ * Changing any field here changes the convention for every path at once —
+ * that is the point. Keep it pure: no runtime, no I/O.
+ */
+import type { FrictionSignal } from './schemas/signal.ts';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+export declare const SEVERITY_TO_PRIORITY: {
+    readonly blocker: "urgent";
+    readonly annoyance: "medium";
+    readonly confusion: "medium";
+    readonly 'nice-to-have': "low";
+};
+export interface PromoteWorkItemInput {
+    title: string;
+    description: string;
+    priority: 'low' | 'medium' | 'high' | 'urgent';
+    tags: string[];
+    metadata: {
+        source: 'friction';
+        custom: {
+            frictionSignalId: string;
+            frictionSignatureHash: string;
+            frictionEvidence?: JsonValue;
+        };
+    };
+}
+export declare function buildPromoteWorkItemInput(signal: FrictionSignal): PromoteWorkItemInput;
+//# sourceMappingURL=promote-input.d.ts.map

package/dist/friction/promote-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote-input.d.ts","sourceRoot":"","sources":["../../src/friction/promote-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;CAK4D,CAAC;AAE9F,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE;QACT,MAAM,EAAE,UAAU,CAAC;QACnB,MAAM,EAAE;YACP,gBAAgB,EAAE,MAAM,CAAC;YACzB,qBAAqB,EAAE,MAAM,CAAC;YAC9B,gBAAgB,CAAC,EAAE,SAAS,CAAC;SAC7B,CAAC;KACF,CAAC;CACF;AAsBD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,oBAAoB,CAetF"}

package/dist/friction/promote-input.js

@@ -0,0 +1,58 @@
+/**
+ * Promote-a-signal → work-item create input — the ONE home for the promote
+ * convention (title cap, description body, severity→priority table, tags and
+ * the metadata back-link). Both promote paths consume this so a signal
+ * promotes to the SAME work item no matter which surface fired it:
+ *
+ *  - the CLI command (`cli/friction/hq.friction.promote.impl.ts`)
+ *  - the friction runtime/client's `promoteInput` (`client/friction/index.ts`),
+ *    which the /work-items TUI's "Promote to task" action calls.
+ *
+ * Changing any field here changes the convention for every path at once —
+ * that is the point. Keep it pure: no runtime, no I/O.
+ */
+export const SEVERITY_TO_PRIORITY = {
+    blocker: 'urgent',
+    annoyance: 'medium',
+    confusion: 'medium',
+    'nice-to-have': 'low'
+};
+function buildTitle(signal) {
+    const observed = signal.observed.trim();
+    return observed.length > 120 ? `${observed.slice(0, 117)}…` : observed;
+}
+function buildDescription(signal) {
+    const lines = [
+        `Promoted from friction signal ${signal.id}.`,
+        '',
+        `surface: ${signal.surface}`,
+        `source: ${signal.source}`,
+        `severity: ${signal.severity}`,
+        `observed: ${signal.observed}`
+    ];
+    if (signal.expected)
+        lines.push(`expected: ${signal.expected}`);
+    if (signal.repro)
+        lines.push(`repro: ${signal.repro}`);
+    if (signal.workaround)
+        lines.push(`workaround: ${signal.workaround}`);
+    return lines.join('\n');
+}
+export function buildPromoteWorkItemInput(signal) {
+    const custom = {
+        frictionSignalId: signal.id, frictionSignatureHash: signal.signatureHash
+    };
+    if (signal.evidence !== undefined)
+        custom.frictionEvidence = signal.evidence;
+    return {
+        title: buildTitle(signal),
+        description: buildDescription(signal),
+        priority: SEVERITY_TO_PRIORITY[signal.severity],
+        tags: ['friction'],
+        metadata: {
+            source: 'friction',
+            custom
+        }
+    };
+}
+//# sourceMappingURL=promote-input.js.map

package/dist/friction/promote-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote-input.js","sourceRoot":"","sources":["../../src/friction/promote-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IACnC,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,QAAQ;IACnB,SAAS,EAAE,QAAQ;IACnB,cAAc,EAAE,KAAK;CACuE,CAAC;AAiB9F,SAAS,UAAU,CAAC,MAAsB;IACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;AACxE,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAsB;IAC/C,MAAM,KAAK,GAAG;QACb,iCAAiC,MAAM,CAAC,EAAE,GAAG;QAC7C,EAAE;QACF,YAAY,MAAM,CAAC,OAAO,EAAE;QAC5B,WAAW,MAAM,CAAC,MAAM,EAAE;QAC1B,aAAa,MAAM,CAAC,QAAQ,EAAE;QAC9B,aAAa,MAAM,CAAC,QAAQ,EAAE;KAC9B,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC/D,MAAM,MAAM,GAA+C;QAC1D,gBAAgB,EAAE,MAAM,CAAC,EAAE,EAAE,qBAAqB,EAAE,MAAM,CAAC,aAAa;KACxE,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7E,OAAO;QACN,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC;QACzB,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC;QACrC,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC/C,IAAI,EAAE,CAAC,UAAU,CAAC;QAClB,QAAQ,EAAE;YACT,MAAM,EAAE,UAAU;YAClB,MAAM;SACN;KACD,CAAC;AACH,CAAC"}

package/dist/friction/promotion-visibility.d.ts

@@ -0,0 +1,34 @@
+/** Read-only reverse projection from work-item metadata to friction signals. */
+import * as z from 'zod/v4';
+import { WorkItemMetadataSchema } from '@vibesdotdev/projects/work/schemas/work-item';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+export interface FrictionPromotionSignal {
+    id: string;
+}
+export interface FrictionPromotionWorkItem {
+    id: string;
+    title: string;
+    metadata?: z.infer<typeof WorkItemMetadataSchema>;
+}
+export interface FrictionPromotionWorkStore {
+    listWorkItems(input: {
+        includeCompleted: boolean;
+        includeCancelled: boolean;
+        limit: number;
+        offset: number;
+    }): Promise<{
+        items: Array<{
+            id: string;
+        }>;
+        hasMore: boolean;
+    }>;
+    getWorkItem(id: string): Promise<FrictionPromotionWorkItem | null>;
+}
+/** The runtime the promotion lookup resolves the work store through (and logs on). */
+export type FrictionPromotionRuntime = RuntimeRef & {
+    resolve<T>(kind: string, id: string): Promise<T>;
+};
+export declare function mapPromotedWorkItems<T extends FrictionPromotionWorkItem>(signals: readonly FrictionPromotionSignal[], workItems: readonly T[]): Map<string, T[]>;
+export declare function resolvePromotedWorkItems(runtime: FrictionPromotionRuntime, signals: readonly FrictionPromotionSignal[]): Promise<Map<string, FrictionPromotionWorkItem[]> | null>;
+export declare function formatPromotedWorkItems(workItems: readonly FrictionPromotionWorkItem[]): string;
+//# sourceMappingURL=promotion-visibility.d.ts.map

package/dist/friction/promotion-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-visibility.d.ts","sourceRoot":"","sources":["../../src/friction/promotion-visibility.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACvC,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,yBAAyB;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,0BAA0B;IAC1C,aAAa,CAAC,KAAK,EAAE;QACpB,gBAAgB,EAAE,OAAO,CAAC;QAC1B,gBAAgB,EAAE,OAAO,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAC;CACnE;AAED,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG;IACnD,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACjD,CAAC;AAUF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,yBAAyB,EACvE,OAAO,EAAE,SAAS,uBAAuB,EAAE,EAC3C,SAAS,EAAE,SAAS,CAAC,EAAE,GACrB,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAWlB;AAED,wBAAsB,wBAAwB,CAC7C,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,SAAS,uBAAuB,EAAE,GACzC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,yBAAyB,EAAE,CAAC,GAAG,IAAI,CAAC,CAqB1D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,GAAG,MAAM,CAI/F"}

package/dist/friction/promotion-visibility.js

@@ -0,0 +1,57 @@
+/** Read-only reverse projection from work-item metadata to friction signals. */
+import * as z from 'zod/v4';
+import { WorkItemMetadataSchema } from '@vibesdotdev/projects/work/schemas/work-item';
+const PromotionMetadataSchema = WorkItemMetadataSchema.extend({
+    custom: z.object({ frictionSignalId: z.string().optional() }).loose().optional()
+});
+function frictionSignalIdFromMetadata(metadata) {
+    return PromotionMetadataSchema.optional().parse(metadata)?.custom?.frictionSignalId;
+}
+export function mapPromotedWorkItems(signals, workItems) {
+    const promotions = new Map();
+    const signalIds = new Set(signals.map((signal) => signal.id));
+    for (const workItem of workItems) {
+        const signalId = frictionSignalIdFromMetadata(workItem.metadata);
+        if (!signalId || !signalIds.has(signalId))
+            continue;
+        const matches = promotions.get(signalId);
+        if (matches)
+            matches.push(workItem);
+        else
+            promotions.set(signalId, [workItem]);
+    }
+    return promotions;
+}
+export async function resolvePromotedWorkItems(runtime, signals) {
+    if (signals.length === 0)
+        return new Map();
+    if (!runtime.hasKind('storage/manifest') || runtime.query('storage/manifest').withId('work.items').descriptors().length === 0)
+        return null;
+    {
+        const store = await runtime.resolve('storage/manifest', 'work.items');
+        const workItems = [];
+        let offset = 0;
+        while (true) {
+            const page = await store.listWorkItems({
+                includeCompleted: true,
+                includeCancelled: true,
+                limit: 100,
+                offset
+            });
+            const rows = await Promise.all(page.items.map((item) => store.getWorkItem(item.id)));
+            for (const row of rows)
+                if (row)
+                    workItems.push(row);
+            if (!page.hasMore || page.items.length === 0)
+                break;
+            offset += page.items.length;
+        }
+        return mapPromotedWorkItems(signals, workItems);
+    }
+}
+export function formatPromotedWorkItems(workItems) {
+    return workItems.length === 0
+        ? '—'
+        : workItems.map((workItem) => `${workItem.id.slice(0, 8)} ${workItem.title}`).join(', ');
+}
+//# sourceMappingURL=promotion-visibility.js.map

package/dist/friction/promotion-visibility.js.map

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

package/dist/friction/read.d.ts

@@ -0,0 +1,21 @@
+import { type FrictionRuntime, type ListFrictionSignalsFilter } from './store.ts';
+import type { FrictionDisposition } from './schemas/disposition.ts';
+import type { FrictionSignal } from './schemas/signal.ts';
+/**
+ * Public, read-only friction surface. Consumers use this DTO/helper entrypoint
+ * for types and projections; runtime clients still resolve through the registry.
+ */
+export declare class FrictionReadClient {
+    private readonly runtime;
+    /** Reads through `runtime` (the caller's own), never a default runtime. */
+    constructor(runtime: FrictionRuntime);
+    list(filter?: ListFrictionSignalsFilter): Promise<FrictionSignal[]>;
+    show(id: string): Promise<FrictionSignal | undefined>;
+    latestDispositions(signalIds: readonly string[]): Promise<Map<string, FrictionDisposition>>;
+}
+export { formatPromotedWorkItems, mapPromotedWorkItems, resolvePromotedWorkItems, type FrictionPromotionRuntime, type FrictionPromotionSignal, type FrictionPromotionWorkItem, type FrictionPromotionWorkStore } from './promotion-visibility.ts';
+export type { FrictionCluster, FrictionClusterBackend, LatestDispositionsResolver } from './clusters.ts';
+export type { FrictionDisposition, FrictionDispositionKind } from './schemas/disposition.ts';
+export type { FrictionAudience, FrictionEvidenceLink, FrictionEvidenceLinkKind, FrictionPersonalDataLevel, FrictionSeverity, FrictionSignal, FrictionSource } from './schemas/signal.ts';
+export type { FrictionRuntime, ListFrictionSignalsFilter } from './store.ts';
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/friction/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,kBAAkB;IAElB,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,2EAA2E;gBAC9C,OAAO,EAAE,eAAe;IAE/C,IAAI,CAAC,MAAM,GAAE,yBAA8B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIvE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAIrD,kBAAkB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAGjG;AAED,OAAO,EACN,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACzG,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAC7F,YAAY,EACX,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC"}

package/dist/friction/read.js

@@ -0,0 +1,23 @@
+import { getFrictionSignal, latestDispositionsBySignal, listFrictionSignals } from "./store.js";
+/**
+ * Public, read-only friction surface. Consumers use this DTO/helper entrypoint
+ * for types and projections; runtime clients still resolve through the registry.
+ */
+export class FrictionReadClient {
+    runtime;
+    /** Reads through `runtime` (the caller's own), never a default runtime. */
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async list(filter = {}) {
+        return listFrictionSignals(this.runtime, filter);
+    }
+    async show(id) {
+        return getFrictionSignal(this.runtime, id);
+    }
+    async latestDispositions(signalIds) {
+        return latestDispositionsBySignal(this.runtime, signalIds);
+    }
+}
+export { formatPromotedWorkItems, mapPromotedWorkItems, resolvePromotedWorkItems } from "./promotion-visibility.js";
+//# sourceMappingURL=read.js.map

package/dist/friction/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/friction/read.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,iBAAiB,EACjB,0BAA0B,EAC1B,mBAAmB,EAGnB,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAED;IAD7B,2EAA2E;IAC3E,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAEzD,KAAK,CAAC,IAAI,CAAC,SAAoC,EAAE;QAChD,OAAO,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACpB,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,SAA4B;QACpD,OAAO,0BAA0B,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5D,CAAC;CACD;AAED,OAAO,EACN,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EAKxB,MAAM,2BAA2B,CAAC"}

package/dist/friction/schemas/disposition.d.ts

@@ -0,0 +1,42 @@
+import type { VibesLink } from '@vibesdotdev/shared/schemas';
+import * as z from 'zod/v4';
+export declare const FrictionDispositionLinkSchema: z.ZodObject<{
+    kind: z.ZodString;
+    id: z.ZodString;
+    source: z.ZodString;
+    role: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export declare const FrictionDispositionKindSchema: z.ZodEnum<{
+    duplicate: "duplicate";
+    rejected: "rejected";
+    resolved: "resolved";
+    new: "new";
+    triaged: "triaged";
+    promoted: "promoted";
+}>;
+export declare const FrictionDispositionSchema: z.ZodObject<{
+    id: z.ZodString;
+    signalId: z.ZodString;
+    disposition: z.ZodEnum<{
+        duplicate: "duplicate";
+        rejected: "rejected";
+        resolved: "resolved";
+        new: "new";
+        triaged: "triaged";
+        promoted: "promoted";
+    }>;
+    triagedBy: z.ZodString;
+    note: z.ZodOptional<z.ZodString>;
+    workItemIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    links: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+        source: z.ZodString;
+        role: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type FrictionDispositionKind = z.infer<typeof FrictionDispositionKindSchema>;
+export type FrictionDisposition = z.infer<typeof FrictionDispositionSchema>;
+export type FrictionDispositionLink = VibesLink;
+//# sourceMappingURL=disposition.d.ts.map

package/dist/friction/schemas/disposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposition.d.ts","sourceRoot":"","sources":["../../../src/friction/schemas/disposition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,6BAA6B;;;;;iBAAkB,CAAC;AAC7D,eAAO,MAAM,6BAA6B;;;;;;;EAOxC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBASpC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,SAAS,CAAC"}

package/dist/friction/schemas/disposition.js

@@ -0,0 +1,22 @@
+import { VibesLinkSchema, VibesLinksSchema } from '@vibesdotdev/shared/schemas';
+import * as z from 'zod/v4';
+export const FrictionDispositionLinkSchema = VibesLinkSchema;
+export const FrictionDispositionKindSchema = z.enum([
+    'new',
+    'triaged',
+    'promoted',
+    'duplicate',
+    'resolved',
+    'rejected'
+]);
+export const FrictionDispositionSchema = z.object({
+    id: z.string().min(1),
+    signalId: z.string().min(1),
+    disposition: FrictionDispositionKindSchema,
+    triagedBy: z.string().min(1),
+    note: z.string().min(1).optional(),
+    workItemIds: z.array(z.string().min(1)).default([]),
+    links: VibesLinksSchema.default([]),
+    createdAt: z.string()
+});
+//# sourceMappingURL=disposition.js.map

package/dist/friction/schemas/disposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposition.js","sourceRoot":"","sources":["../../../src/friction/schemas/disposition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEhF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,6BAA6B,GAAG,eAAe,CAAC;AAC7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,IAAI,CAAC;IACnD,KAAK;IACL,SAAS;IACT,UAAU;IACV,WAAW;IACX,UAAU;IACV,UAAU;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,WAAW,EAAE,6BAA6B;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}