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

package/dist/services/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/services/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAON,KAAK,YAAY,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAqB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAGN,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,MAAM,sBAAsB,CAAC;AAI9B,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,YAAY,GAAG,mBAAmB,EAAE,CAGrF;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAEzG;AAyBD;;;GAGG;AACH,wBAAsB,4BAA4B,CACjD,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,iBAAiB,CAAC,CAuC5B;AAWD,mHAAmH;AACnH,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB;AAED,wBAAsB,eAAe,CACpC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,0BAA0B,CAAC,CAKrC;AAED,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,WAAW,CAChC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,qBAAqB,CAAC,CAIhC;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,aAAa,CAAC,CAIxB;AAED,wBAAsB,cAAc,CACnC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,EAC/E,KAAK,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,YAAY,EACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC7E,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/services/registry.js

@@ -0,0 +1,141 @@
+/**
+ * OS service lifecycle — thin facade over the platform backend.
+ *
+ * Catalog identity comes from the runtime (`hq/os-service` descriptors); there
+ * is no private Map or static builtin array. Enumerate with:
+ *   runtime.query('hq/os-service').descriptors()
+ *   runtime.query('hq/os-service').withId(id)
+ *
+ * The backend install needs a resolved absolute `command`. A catalog entry that
+ * names none runs the host's own Vibes CLI: the self-spawn argv the runtime's
+ * host declared (`runtime/host-command`), resolved at use time from the runtime
+ * the caller was handed, never at module load and never guessed from an env
+ * variable or an install path. A host that declared no re-entry refuses.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema, getRuntimeHostCommands, isCapabilityError, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getServiceBackend } from "./backends/index.js";
+import { OsServiceDescriptorSchema, ServiceDescriptorSchema } from "./schemas/service.js";
+const KIND = 'hq/os-service';
+/** Enumerate registered `hq/os-service` catalog descriptors from the runtime. */
+export function listOsServiceDescriptors(runtime) {
+    if (!runtime.hasKind(KIND))
+        return [];
+    return runtime.query(KIND).descriptors();
+}
+/** Lookup one catalog descriptor by id (undefined if unknown). */
+export function getOsServiceDescriptor(runtime, id) {
+    return listOsServiceDescriptors(runtime).find((d) => d.id === id);
+}
+/**
+ * The host's own CLI invocation for a service that names no command: the
+ * self-spawn argv `runtime`'s host declared, its first element as the command
+ * and the rest ahead of the service's own args. A runtime with no host-command
+ * provider refuses `UNAVAILABLE` `host-command-unavailable`; a host that
+ * declared no re-entry refuses through its provider. Neither is caught here.
+ */
+async function hostCliInvocation(runtime, args) {
+    const [command, ...prefix] = (await getRuntimeHostCommands(runtime)).selfSpawnArgv(KIND);
+    return { command, args: [...prefix, ...args] };
+}
+/**
+ * A non-id input is either a concrete install shape (a command already
+ * resolved) or a catalog descriptor (materialised through the host CLI).
+ * Order matters: a catalog entry that names a command materialises as the
+ * install shape, exactly as the command check below always routed it.
+ */
+const ServiceDescriptorInputSchema = z.union([ServiceDescriptorSchema, OsServiceDescriptorSchema]);
+/**
+ * Materialise a catalog descriptor (or inline install shape) into a backend
+ * `ServiceDescriptor` with an absolute command path.
+ */
+export async function materializeServiceDescriptor(runtime, idOrDescriptor) {
+    const asId = z.string().safeParse(idOrDescriptor);
+    if (asId.success) {
+        const catalog = getOsServiceDescriptor(runtime, asId.data);
+        if (!catalog) {
+            const available = listOsServiceDescriptors(runtime)
+                .map((d) => d.id)
+                .join(', ');
+            throw new CapabilityError(`Unknown service id: "${asId.data}". Pass a full descriptor or use a builtin id.` +
+                (available ? ` Available: ${available}` : ''), 'NOT_FOUND', { reason: 'os-service-unknown', details: { id: asId.data } });
+        }
+        return materializeCommand(runtime, catalog);
+    }
+    // Not an id: admit only a service shape. Anything else fails closed with
+    // a fixed typed refusal (never the raw schema error). Admission runs inside
+    // settlement because parsing reads input getters: a throwing getter escapes
+    // safeParse as a raw throw. A getter that refuses typed keeps its identity;
+    // any other acquisition failure maps to the same fixed refusal as ordinary
+    // invalid input.
+    const admitted = settleNow(() => ServiceDescriptorInputSchema.safeParse(idOrDescriptor));
+    if (!admitted.ok) {
+        if (isCapabilityError(admitted.cause))
+            throw admitted.cause;
+        throw new CapabilityError('Service input is neither a service id nor a service descriptor shape', 'INVALID_INPUT', {
+            reason: 'os-service-descriptor-invalid',
+            cause: valueFreeFailure(admitted.cause)
+        });
+    }
+    const asDescriptor = admitted.value;
+    if (!asDescriptor.success) {
+        throw new CapabilityError('Service input is neither a service id nor a service descriptor shape', 'INVALID_INPUT', {
+            reason: 'os-service-descriptor-invalid',
+            cause: valueFreeFailure(CaughtFailureSchema.parse(asDescriptor.error))
+        });
+    }
+    return materializeCommand(runtime, asDescriptor.data);
+}
+async function materializeCommand(runtime, descriptor) {
+    if (descriptor.command)
+        return ServiceDescriptorSchema.parse(descriptor);
+    const invocation = await hostCliInvocation(runtime, descriptor.args ?? []);
+    return ServiceDescriptorSchema.parse({ ...descriptor, ...invocation });
+}
+export async function registerService(runtime, idOrDescriptor) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    await backend.register(descriptor);
+    return { id: descriptor.id, manager: backend.id };
+}
+export async function unregisterService(runtime, idOrDescriptor) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    await backend.unregister(descriptor);
+}
+export async function startService(runtime, idOrDescriptor) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    await backend.start(descriptor);
+}
+export async function stopService(runtime, idOrDescriptor) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    await backend.stop(descriptor);
+}
+/**
+ * Restart a registered service in place (`launchctl kickstart -k` on macOS,
+ * `systemctl --user restart` on Linux). The receipt carries the pid before and
+ * after; `replaced` is false when the OS did not hand out a new main pid.
+ */
+export async function restartService(runtime, idOrDescriptor) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    return backend.restart(descriptor);
+}
+export async function getServiceStatus(runtime, idOrDescriptor) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    return backend.status(descriptor);
+}
+export async function getServiceLogs(runtime, idOrDescriptor, lines) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    return backend.logs(descriptor, lines);
+}
+export async function isServiceRegistered(runtime, idOrDescriptor) {
+    const descriptor = await materializeServiceDescriptor(runtime, idOrDescriptor);
+    const backend = await getServiceBackend(runtime);
+    return backend.isRegistered(descriptor);
+}
+//# sourceMappingURL=registry.js.map

package/dist/services/registry.js.map

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

package/dist/services/schemas/service.d.ts

@@ -0,0 +1,79 @@
+/**
+ * OS Service Schemas
+ *
+ * A service is an OS-registered daemon that survives reboots.
+ * On macOS: LaunchAgent plist in ~/Library/LaunchAgents/
+ * On Linux: systemd user unit in ~/.config/systemd/user/
+ *
+ * Catalog identity lives as `hq/os-service` runtime descriptors — query the
+ * runtime, never a private Map/array. The backend install shape
+ * (`ServiceDescriptor`) requires a resolved absolute `command` path, which is
+ * materialised at install/list time from the host's declared self-spawn argv.
+ */
+import * as z from 'zod/v4';
+export declare const ServiceScopeSchema: z.ZodEnum<{
+    user: "user";
+    system: "system";
+}>;
+/**
+ * Runtime catalog descriptor for a builtin OS service.
+ * Registered under kind `hq/os-service`. Enumerate via:
+ *   runtime.query('hq/os-service').descriptors()
+ *   runtime.query('hq/os-service').withId(id)
+ *
+ * `command` is optional on the catalog entry — when omitted, materialisation
+ * runs the host's own CLI: the self-spawn argv the runtime's host declared
+ * (`runtime/host-command`), resolved at use time, never at module load.
+ */
+export declare const OsServiceDescriptorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"hq/os-service">;
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    command: z.ZodOptional<z.ZodString>;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    keepAlive: z.ZodDefault<z.ZodBoolean>;
+    autoStart: z.ZodDefault<z.ZodBoolean>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        user: "user";
+        system: "system";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Concrete install shape passed to launchd/systemd backends.
+ * `command` is required (absolute path already resolved).
+ */
+export declare const ServiceDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    command: z.ZodString;
+    args: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    env: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    workingDirectory: z.ZodOptional<z.ZodString>;
+    keepAlive: z.ZodDefault<z.ZodBoolean>;
+    autoStart: z.ZodDefault<z.ZodBoolean>;
+    scope: z.ZodDefault<z.ZodEnum<{
+        user: "user";
+        system: "system";
+    }>>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ServiceStatusSchema: z.ZodObject<{
+    id: z.ZodString;
+    registered: z.ZodBoolean;
+    running: z.ZodBoolean;
+    pid: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ServiceScope = z.infer<typeof ServiceScopeSchema>;
+export type OsServiceDescriptor = z.infer<typeof OsServiceDescriptorSchema>;
+export type ServiceDescriptor = z.infer<typeof ServiceDescriptorSchema>;
+export type ServiceStatus = z.infer<typeof ServiceStatusSchema>;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/schemas/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/schemas/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,kBAAkB;;;EAK7B,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;iBAkBpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;iBAqBlC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;iBAM9B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/services/schemas/service.js

@@ -0,0 +1,82 @@
+/**
+ * OS Service Schemas
+ *
+ * A service is an OS-registered daemon that survives reboots.
+ * On macOS: LaunchAgent plist in ~/Library/LaunchAgents/
+ * On Linux: systemd user unit in ~/.config/systemd/user/
+ *
+ * Catalog identity lives as `hq/os-service` runtime descriptors — query the
+ * runtime, never a private Map/array. The backend install shape
+ * (`ServiceDescriptor`) requires a resolved absolute `command` path, which is
+ * materialised at install/list time from the host's declared self-spawn argv.
+ */
+import * as z from 'zod/v4';
+export const ServiceScopeSchema = z.enum([
+    /** Runs as current user (LaunchAgent / systemd --user) */
+    'user',
+    /** Runs as root/system (LaunchDaemon / systemd system) — requires elevated permissions */
+    'system'
+]);
+/**
+ * Runtime catalog descriptor for a builtin OS service.
+ * Registered under kind `hq/os-service`. Enumerate via:
+ *   runtime.query('hq/os-service').descriptors()
+ *   runtime.query('hq/os-service').withId(id)
+ *
+ * `command` is optional on the catalog entry — when omitted, materialisation
+ * runs the host's own CLI: the self-spawn argv the runtime's host declared
+ * (`runtime/host-command`), resolved at use time, never at module load.
+ */
+export const OsServiceDescriptorSchema = z.object({
+    kind: z.literal('hq/os-service'),
+    id: z.string().min(1),
+    name: z.string().min(1),
+    description: z.string().optional(),
+    /** Absolute executable path; omit to resolve at materialisation time */
+    command: z.string().min(1).optional(),
+    args: z.array(z.string()).default([]),
+    env: z.record(z.string(), z.string()).default({}),
+    workingDirectory: z.string().optional(),
+    keepAlive: z.boolean().default(true),
+    autoStart: z.boolean().default(true),
+    scope: ServiceScopeSchema.default('user'),
+    /** Platform-specific reverse-DNS label, e.g. 'com.vibes.pm' */
+    label: z.string().optional(),
+    tags: z.array(z.string()).default([]),
+    enabled: z.boolean().default(true),
+    hardware: z.array(z.string()).optional()
+});
+/**
+ * Concrete install shape passed to launchd/systemd backends.
+ * `command` is required (absolute path already resolved).
+ */
+export const ServiceDescriptorSchema = z.object({
+    /** Unique service ID, e.g. 'vibes-pm', 'vibes-mcp' */
+    id: z.string().min(1),
+    /** Human label */
+    name: z.string().min(1),
+    description: z.string().default(''),
+    /** Executable path (absolute) */
+    command: z.string().min(1),
+    /** Arguments passed to command */
+    args: z.array(z.string()).default([]),
+    /** Environment variables to inject */
+    env: z.record(z.string(), z.string()).default({}),
+    /** Working directory */
+    workingDirectory: z.string().optional(),
+    /** Automatically restart if it crashes */
+    keepAlive: z.boolean().default(true),
+    /** Start immediately when registered (launchctl load -w / systemctl --user enable) */
+    autoStart: z.boolean().default(true),
+    scope: ServiceScopeSchema.default('user'),
+    /** Platform-specific reverse-DNS label, e.g. 'com.vibes.pm' */
+    label: z.string().optional()
+});
+export const ServiceStatusSchema = z.object({
+    id: z.string(),
+    registered: z.boolean(),
+    running: z.boolean(),
+    pid: z.number().optional(),
+    error: z.string().optional()
+});
+//# sourceMappingURL=service.js.map

package/dist/services/schemas/service.js.map

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

package/dist/svelte/report/ReportProblemDialog.svelte

@@ -0,0 +1,205 @@
+<script lang="ts">
+	// "Report a problem": the `hq.report-problem` app-shell utility. Kit renders
+	// the trigger and hands this dialog its open state; the dialog captures the
+	// page through the handed runtime, previews the exact body, and submits it
+	// through the friction client's `report()`.
+	import * as Dialog from '@vibesdotdev/kit/components/ui/dialog';
+	import * as RadioGroup from '@vibesdotdev/kit/components/ui/radio-group';
+	import { Button } from '@vibesdotdev/kit/components/ui/button';
+	import { Textarea } from '@vibesdotdev/kit/components/ui/textarea';
+	import { Label } from '@vibesdotdev/kit/components/ui/label';
+	import { Icon } from '@vibesdotdev/kit/components/icon';
+	import type { AppShellUtilityProps } from '@vibesdotdev/kit/app-shell/utility';
+	import { peekRuntimeSvelteContext } from '@vibesdotdev/surface-sveltekit/svelte';
+	import { getVibesClient } from '@vibesdotdev/kernel/client';
+	import { settleNow, type VibesRuntime } from '@vibesdotdev/kernel';
+	import type { FrictionClient } from '../../client/friction/index.js';
+	import type { FrictionReportCapture } from '../../friction/schemas/report.js';
+	import type { FrictionReportResponse } from '../../friction/schemas/intake.js';
+	import type { FrictionSeverity } from '../../friction/schemas/signal.js';
+	import { buildFrictionReportBody, captureReportContext, type FrictionReportBody } from './capture-context.js';
+	import { DEFAULT_REPORT_SEVERITY, REPORT_SEVERITY_OPTIONS } from './severity.js';
+
+	let {
+		open,
+		onOpenChange,
+		utility,
+		signedIn,
+		error,
+		route
+	}: AppShellUtilityProps = $props();
+
+	const runtimeStore = peekRuntimeSvelteContext();
+
+	let severity = $state<FrictionSeverity>(DEFAULT_REPORT_SEVERITY);
+	let description = $state('');
+	let expected = $state('');
+	let capture = $state<FrictionReportCapture | null>(null);
+	let captureFailure = $state<string | null>(null);
+	let occurrenceId = $state('');
+	let phase = $state<'editing' | 'sending' | 'sent' | 'failed'>('editing');
+	let failure = $state<string | null>(null);
+	let receipt = $state<FrictionReportResponse | null>(null);
+
+	// One body for the preview and the submit: what is shown is what is sent.
+	const body = $derived(capture ? buildFrictionReportBody({ severity, description, expected }, capture, occurrenceId) : null);
+	const preview = $derived(body?.success ? JSON.stringify(body.data, null, 2) : '');
+	const canSend = $derived(phase !== 'sending' && body?.success === true);
+
+	const NO_RUNTIME = 'Reporting is unavailable: no Vibes runtime is ready on this page.';
+
+	function reset(): void {
+		severity = DEFAULT_REPORT_SEVERITY;
+		description = '';
+		expected = '';
+		capture = null;
+		captureFailure = null;
+		phase = 'editing';
+		failure = null;
+		receipt = null;
+		// Fixed when the dialog opens, so a retried submit stays one occurrence and the preview matches.
+		occurrenceId = crypto.randomUUID();
+	}
+
+	async function recapture(runtime: VibesRuntime): Promise<void> {
+		try {
+			capture = await captureReportContext(runtime, { error, route });
+		} catch (cause) {
+			settleNow(() => runtime.diagnostics.error('Report a problem could not capture the page.', { scope: 'hq', plugin: 'hq.svelte.report', error: cause }));
+			captureFailure = cause instanceof Error ? cause.message : 'This page could not be captured.';
+		}
+	}
+
+	let wasOpen = false;
+	$effect(() => {
+		if (open && !wasOpen) {
+			reset();
+			// Kit mounts utilities only inside a ready runtime; a missing one is confirmed absence.
+			const runtime = runtimeStore?.runtime;
+			if (runtime) void recapture(runtime);
+			else captureFailure = NO_RUNTIME;
+		}
+		wasOpen = open;
+	});
+
+	async function send(): Promise<void> {
+		if (!body?.success) return;
+		const runtime = runtimeStore?.runtime;
+		if (!runtime) {
+			failure = NO_RUNTIME;
+			phase = 'failed';
+			return;
+		}
+		phase = 'sending';
+		failure = null;
+		await submit(runtime, body.data);
+	}
+
+	async function submit(runtime: VibesRuntime, report: FrictionReportBody): Promise<void> {
+		try {
+			const reporter = await getVibesClient<FrictionClient>('friction', runtime);
+			receipt = await reporter.report(report);
+			phase = 'sent';
+		} catch (cause) {
+			settleNow(() => runtime.diagnostics.error('Report a problem could not send the report.', { scope: 'hq', plugin: 'hq.svelte.report', error: cause }));
+			failure = cause instanceof Error ? cause.message : 'The report could not be sent.';
+			phase = 'failed';
+		}
+	}
+</script>
+
+<Dialog.Root {open} {onOpenChange}>
+	<Dialog.Content class="flex max-h-[90dvh] flex-col sm:max-w-xl" data-testid="report-problem-dialog">
+		<Dialog.Header>
+			<Dialog.Title>{utility.name}</Dialog.Title>
+			<Dialog.Description>
+				Tell us what went wrong. The details below are sent with your report so we can find it.
+			</Dialog.Description>
+		</Dialog.Header>
+
+		{#if phase === 'sent' && receipt}
+			<div class="flex items-start gap-3 rounded-md border border-border bg-muted/40 p-4" role="status" data-testid="report-sent">
+				<Icon icon="lucide:circle-check" class="mt-0.5 size-5 text-primary" />
+				<div class="space-y-1 text-sm">
+					<p class="font-medium text-foreground">Thanks, your report was sent.</p>
+					<p class="text-muted-foreground">Reference <code class="font-mono">{receipt.id}</code></p>
+				</div>
+			</div>
+			<Dialog.Footer>
+				<Button onclick={() => onOpenChange(false)}>Done</Button>
+			</Dialog.Footer>
+		{:else}
+			<!-- Header and footer stay put; only the body scrolls when the viewport is short. -->
+			<form
+				class="flex min-h-0 min-w-0 flex-1 flex-col gap-4"
+				onsubmit={(event) => { event.preventDefault(); void send(); }}
+			>
+				<div class="-mx-1 min-h-0 flex-1 space-y-5 overflow-y-auto px-1 pb-1" data-testid="report-body">
+					<fieldset class="space-y-2">
+						<legend class="text-sm font-medium text-foreground">How much is this affecting you?</legend>
+						<RadioGroup.Root value={severity} onValueChange={(value) => { severity = value as FrictionSeverity; }} class="gap-2">
+							{#each REPORT_SEVERITY_OPTIONS as option (option.severity)}
+								<label
+									class="flex cursor-pointer items-start gap-3 rounded-md border border-border p-3 transition-colors hover:bg-muted/50 has-[[data-state=checked]]:border-primary has-[[data-state=checked]]:bg-primary/5"
+									data-severity={option.severity}
+								>
+									<RadioGroup.Item value={option.severity} id={`report-severity-${option.severity}`} class="mt-0.5" />
+									<span class="space-y-0.5">
+										<span class="block text-sm font-medium text-foreground">{option.label}</span>
+										<span class="block text-xs text-muted-foreground">{option.hint}</span>
+									</span>
+								</label>
+							{/each}
+						</RadioGroup.Root>
+					</fieldset>
+
+					<div class="space-y-2">
+						<Label for="report-description">What happened?</Label>
+						<Textarea
+							id="report-description"
+							bind:value={description}
+							rows={4}
+							placeholder="Describe what you were doing and what went wrong."
+							required
+						/>
+				</div>
+
+				<div class="space-y-2">
+					<Label for="report-expected">What did you expect? <span class="text-muted-foreground">(optional)</span></Label>
+					<Textarea id="report-expected" bind:value={expected} rows={2} />
+				</div>
+
+				{#if !signedIn}
+					<p class="text-xs text-muted-foreground" data-testid="report-anonymous">
+						You're not signed in, so this report is anonymous.
+					</p>
+				{/if}
+
+				<details class="min-w-0 rounded-md border border-border bg-muted/30" open>
+					<summary class="cursor-pointer px-3 py-2 text-sm font-medium text-foreground">Exactly what will be sent</summary>
+					{#if captureFailure}
+						<p class="px-3 pb-3 text-sm text-destructive" role="alert">{captureFailure}</p>
+					{:else if !capture}
+						<p class="px-3 pb-3 text-sm text-muted-foreground">Capturing this page…</p>
+					{:else if body && !body.success}
+						<p class="px-3 pb-3 text-sm text-muted-foreground">Describe the problem in at least 5 characters to see the report.</p>
+					{:else}
+						<pre class="max-h-56 overflow-auto px-3 pb-3 font-mono text-xs leading-relaxed break-all whitespace-pre-wrap text-muted-foreground" data-testid="report-preview">{preview}</pre>
+					{/if}
+				</details>
+
+				{#if failure}
+					<p class="text-sm text-destructive" role="alert" data-testid="report-failure">{failure}</p>
+				{/if}
+				</div>
+
+				<Dialog.Footer class="shrink-0">
+					<Button type="button" variant="outline" onclick={() => onOpenChange(false)}>Cancel</Button>
+					<Button type="submit" disabled={!canSend}>
+						{phase === 'sending' ? 'Sending…' : phase === 'failed' ? 'Try again' : 'Send report'}
+					</Button>
+				</Dialog.Footer>
+			</form>
+		{/if}
+	</Dialog.Content>
+</Dialog.Root>

package/dist/svelte/report/ReportProblemDialog.svelte.d.ts

@@ -0,0 +1,5 @@
+import type { AppShellUtilityProps } from '@vibesdotdev/kit/app-shell/utility';
+declare const ReportProblemDialog: import("svelte").Component<AppShellUtilityProps, {}, "">;
+type ReportProblemDialog = ReturnType<typeof ReportProblemDialog>;
+export default ReportProblemDialog;
+//# sourceMappingURL=ReportProblemDialog.svelte.d.ts.map

package/dist/svelte/report/ReportProblemDialog.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportProblemDialog.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/report/ReportProblemDialog.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AA+M/E,QAAA,MAAM,mBAAmB,0DAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/svelte/report/capture-context.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Report capture: the page facts a "Report a problem" submit carries, read
+ * through the handed runtime only. Page facts come from the runtime browser
+ * host (`runtime/browser-host` `readPage`), the version from the host fact
+ * `hostVersion`, and recent errors from logging's ring-buffer reader. Nothing
+ * here reads `window`, `document` or `navigator`.
+ *
+ * `buildFrictionReportBody` produces the one parsed body the dialog previews
+ * and submits, so the preview is exactly what is sent.
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type FrictionReportCapture } from '../../friction/schemas/report.ts';
+import { FrictionReportInputSchema } from '../../friction/schemas/intake.ts';
+import type { FrictionSeverity } from '../../friction/schemas/signal.ts';
+import type * as z from 'zod/v4';
+/** The handed runtime surface capture reads: its browser host and host version. */
+export type ReportCaptureRuntime = Pick<RuntimeRef, 'hasKind' | 'query' | 'localEnvironment'>;
+/** The error a Kit error surface hands the utility. */
+export interface ReportSurfaceError {
+    status: number;
+    message?: string;
+}
+/** The page URL without its query or fragment, which may carry tokens or personal data. */
+export declare function stripQueryAndFragment(url: string): string;
+/** Errors older than this are not this page's problem; the ring buffer keeps days of them. */
+export declare const REPORT_ERROR_WINDOW_MS: number;
+/**
+ * A route template for a path when the host hands none: every id-like segment
+ * (numbers, UUIDs, long hex or opaque tokens) and anything carrying `@` or `%`
+ * becomes `[id]`, so reports on different entities group together and the
+ * route never carries an identifier the redactor does not see.
+ */
+export declare function routeTemplateFromPath(pathname: string): string;
+/**
+ * Capture the current page. A host with no page facts refuses
+ * `UNAVAILABLE browser-page-unavailable`; a host with no browser host refuses
+ * `UNAVAILABLE browser-host-unavailable`. On an error surface, the surface's
+ * own error is included even when no boundary recorded it, so a signed-out
+ * visitor's report always carries its error condition.
+ */
+export declare function captureReportContext(runtime: ReportCaptureRuntime, options?: {
+    /** The route template the host hands (SvelteKit `page.route.id`); derived from the path when absent. */
+    route?: string;
+    error?: ReportSurfaceError;
+    now?: () => Date;
+}): Promise<FrictionReportCapture>;
+/** What the reporter typed in the dialog. */
+export interface ReportForm {
+    severity: FrictionSeverity;
+    description: string;
+    expected?: string;
+}
+/** The report body, parsed exactly as `FrictionClient.report()` sends it. */
+export type FrictionReportBody = z.output<typeof FrictionReportInputSchema>;
+/**
+ * The one body the dialog previews and submits. It is parsed through the
+ * intake's own schema, so defaults and trimming are already applied, and a
+ * body the intake would refuse is refused here, before anything is sent.
+ */
+export declare function buildFrictionReportBody(form: ReportForm, capture: FrictionReportCapture, occurrenceId: string): z.ZodSafeParseResult<FrictionReportBody>;
+//# sourceMappingURL=capture-context.d.ts.map

package/dist/svelte/report/capture-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-context.d.ts","sourceRoot":"","sources":["../../../src/svelte/report/capture-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9F,OAAO,EAGN,KAAK,qBAAqB,EAE1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AAEjC,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,kBAAkB,CAAC,CAAC;AAE9F,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AAIrD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D;AAOD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE;IACR,wGAAwG;IACxG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CACZ,GACJ,OAAO,CAAC,qBAAqB,CAAC,CAkChC;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CASxJ"}