spiracha 1.5.0 → 2.0.0

package/apps/ui/src/lib/package-metadata.ts

@@ -0,0 +1,16 @@
+import packageJsonRaw from '../../../../package.json?raw';
+
+type PackageMetadata = {
+    homepage: string;
+    version: string;
+};
+
+const parsePackageMetadata = (): PackageMetadata => {
+    const packageJson = JSON.parse(packageJsonRaw) as Partial<PackageMetadata>;
+    return {
+        homepage: typeof packageJson.homepage === 'string' ? packageJson.homepage : '',
+        version: typeof packageJson.version === 'string' ? packageJson.version : '0.0.0',
+    };
+};
+
+export const packageMetadata = parsePackageMetadata();

package/apps/ui/src/lib/path-utils.ts

@@ -0,0 +1,13 @@
+import { applyPathTransforms as applySharedPathTransforms } from '@spiracha/lib/path-transforms';
+import type { Settings } from './settings-store';
+
+export const applyPathTransforms = (
+    text: string,
+    settings: Pick<Settings, 'convertToProjectRoot' | 'redactUsername'>,
+    projectPath: string | null,
+) => {
+    return applySharedPathTransforms(text, {
+        ...settings,
+        projectPath,
+    });
+};

package/apps/ui/src/lib/qoder-queries.ts

@@ -0,0 +1,22 @@
+import { queryOptions } from '@tanstack/react-query';
+import { getQoderSessionDetailFn, listQoderSessionsFn, listQoderWorkspacesFn } from './qoder-server';
+
+export const qoderWorkspacesQueryOptions = () =>
+    queryOptions({
+        queryFn: () => listQoderWorkspacesFn(),
+        queryKey: ['qoder-workspaces'],
+    });
+
+export const qoderSessionsQueryOptions = (workspaceKey: string | null) =>
+    queryOptions({
+        enabled: workspaceKey !== null,
+        queryFn: () => listQoderSessionsFn({ data: { workspaceKey: workspaceKey ?? '' } }),
+        queryKey: ['qoder-sessions', workspaceKey ?? 'none'],
+    });
+
+export const qoderSessionDetailQueryOptions = (sessionId: string | null) =>
+    queryOptions({
+        enabled: sessionId !== null,
+        queryFn: () => getQoderSessionDetailFn({ data: { sessionId: sessionId ?? '' } }),
+        queryKey: ['qoder-session', sessionId ?? 'none'],
+    });

package/apps/ui/src/lib/qoder-server.ts

@@ -0,0 +1,79 @@
+import { createServerFn } from '@tanstack/react-start';
+import { z } from 'zod';
+import { renderSourceSessionDownload } from './source-session-export-server';
+
+const workspaceSchema = z.object({
+    workspaceKey: z.string().min(1),
+});
+
+const sessionSchema = z.object({
+    sessionId: z.string().min(1),
+});
+
+const exportSessionSchema = z.object({
+    includeCommentary: z.boolean().default(true),
+    includeMetadata: z.boolean().default(true),
+    includeTools: z.boolean().default(true),
+    outputFormat: z.enum(['md', 'txt']).default('md'),
+    sessionId: z.string().min(1),
+    zipArchive: z.boolean().default(false),
+});
+
+export const listQoderWorkspacesFn = createServerFn({ method: 'GET' }).handler(async () => {
+    const { listQoderWorkspaceGroups } = await import('@spiracha/lib/qoder-db');
+    return listQoderWorkspaceGroups();
+});
+
+export const listQoderSessionsFn = createServerFn({ method: 'GET' })
+    .validator(workspaceSchema)
+    .handler(async ({ data }) => {
+        const { listQoderSessionsForGroup } = await import('@spiracha/lib/qoder-db');
+        return listQoderSessionsForGroup(data.workspaceKey);
+    });
+
+const loadQoderSessionTranscript = async (sessionId: string) => {
+    const { readQoderSessionTranscript, resolveQoderGlobalStateDb, resolveQoderWorkspaceStorageDir } = await import(
+        '@spiracha/lib/qoder-db'
+    );
+    const transcript = await readQoderSessionTranscript(
+        resolveQoderGlobalStateDb(),
+        resolveQoderWorkspaceStorageDir(),
+        sessionId,
+    );
+    if (!transcript) {
+        throw new Error(`Qoder session not found: ${sessionId}`);
+    }
+
+    return transcript;
+};
+
+export const getQoderSessionDetailFn = createServerFn({ method: 'GET' })
+    .validator(sessionSchema)
+    .handler(async ({ data }) => {
+        return loadQoderSessionTranscript(data.sessionId);
+    });
+
+export const exportQoderSessionFn = createServerFn({ method: 'POST' })
+    .validator(exportSessionSchema)
+    .handler(async ({ data }) => {
+        const { renderQoderTranscript } = await import('@spiracha/lib/qoder-transcript');
+        const transcript = await loadQoderSessionTranscript(data.sessionId);
+        const content = renderQoderTranscript(transcript, {
+            includeCommentary: data.includeCommentary,
+            includeMetadata: data.includeMetadata,
+            includeTools: data.includeTools,
+            outputFormat: data.outputFormat,
+        });
+
+        if (!content) {
+            throw new Error(`Qoder session has no exportable content: ${data.sessionId}`);
+        }
+
+        return renderSourceSessionDownload({
+            content,
+            fallbackBaseName: 'qoder-session',
+            fileBaseName: transcript.session.title || transcript.session.sessionId,
+            outputFormat: data.outputFormat,
+            zipArchive: data.zipArchive,
+        });
+    });

package/apps/ui/src/lib/qoder-transcript-events.ts

@@ -0,0 +1,139 @@
+import type { ThreadEvent, ThreadTranscriptStats } from '@spiracha/lib/codex-browser-types';
+import type {
+    QoderSessionTranscript,
+    QoderTranscriptEntry,
+    QoderTranscriptPart,
+} from '@spiracha/lib/qoder-exporter-types';
+import { getFinalQoderAssistantMessageEntryIds, getQoderMessagePhase } from '@spiracha/lib/qoder-transcript-phase';
+import type { JsonValue } from '@spiracha/lib/shared';
+import { getThreadTranscriptStats } from './thread-transcript-stats';
+
+const buildRaw = (
+    entry: QoderTranscriptEntry,
+    part: QoderTranscriptPart,
+    eventType: string,
+): Record<string, JsonValue> => ({
+    entryId: entry.entryId,
+    eventType,
+    requestId: entry.requestId,
+    role: entry.role,
+    source: 'qoder_local_history',
+    type: part.type,
+    ...part.raw,
+});
+
+const buildMessageEvent = (
+    transcript: QoderSessionTranscript,
+    entry: QoderTranscriptEntry,
+    part: QoderTranscriptPart,
+    sequence: number,
+    text: string,
+    phase: Extract<ThreadEvent, { kind: 'message' }>['phase'],
+): ThreadEvent => ({
+    isHiddenByDefault: entry.role !== 'assistant' && entry.role !== 'user',
+    kind: 'message',
+    memoryCitation: null,
+    model: transcript.session.model ?? 'Qoder',
+    phase,
+    raw: buildRaw(entry, part, 'message'),
+    role: entry.role,
+    sequence,
+    text,
+    timestamp: entry.timestamp,
+    variant: entry.role === 'user' ? 'user_message' : entry.role === 'assistant' ? 'agent_message' : 'message',
+});
+
+const getPartString = (part: QoderTranscriptPart, key: string): string | null => {
+    const value = part.raw[key];
+    return typeof value === 'string' && value.trim() ? value : null;
+};
+
+const buildToolCallEvent = (
+    transcript: QoderSessionTranscript,
+    entry: QoderTranscriptEntry,
+    part: QoderTranscriptPart,
+    sequence: number,
+    command: string,
+): ThreadEvent => ({
+    argumentsParseFailed: false,
+    argumentsText: command,
+    callId: entry.entryId,
+    command,
+    kind: 'tool_call',
+    name: getPartString(part, 'toolName') ?? 'qoder_file_operation',
+    raw: buildRaw(entry, part, 'tool_call'),
+    sequence,
+    timestamp: entry.timestamp,
+    workdir: transcript.session.worktree,
+});
+
+const buildToolOutputEvent = (
+    entry: QoderTranscriptEntry,
+    part: QoderTranscriptPart,
+    sequence: number,
+    outputText: string,
+): ThreadEvent => ({
+    callId: getPartString(part, 'toolCallId'),
+    exitCode: null,
+    kind: 'tool_output',
+    outputText,
+    raw: buildRaw(entry, part, 'tool_output'),
+    sequence,
+    summary: outputText,
+    timestamp: entry.timestamp,
+    wallTime: null,
+});
+
+const partToEvents = (
+    transcript: QoderSessionTranscript,
+    entry: QoderTranscriptEntry,
+    part: QoderTranscriptPart,
+    sequence: number,
+    finalAssistantMessageEntryIds: Set<string>,
+): ThreadEvent[] => {
+    if (entry.entryType === 'tool_call' && part.type === 'text') {
+        const command = part.text?.trim();
+        return command ? [buildToolCallEvent(transcript, entry, part, sequence, command)] : [];
+    }
+
+    if (entry.entryType === 'tool_output' && part.type === 'text') {
+        const outputText = part.text?.trim();
+        return outputText ? [buildToolOutputEvent(entry, part, sequence, outputText)] : [];
+    }
+
+    if (part.type === 'text') {
+        const text = part.text?.trim();
+        return text
+            ? [
+                  buildMessageEvent(
+                      transcript,
+                      entry,
+                      part,
+                      sequence,
+                      text,
+                      getQoderMessagePhase(entry, finalAssistantMessageEntryIds),
+                  ),
+              ]
+            : [];
+    }
+
+    return [];
+};
+
+export const qoderTranscriptToThreadEvents = (transcript: QoderSessionTranscript): ThreadEvent[] => {
+    const events: ThreadEvent[] = [];
+    const finalAssistantMessageEntryIds = getFinalQoderAssistantMessageEntryIds(transcript.entries);
+    let sequence = 0;
+
+    for (const entry of transcript.entries) {
+        for (const part of entry.parts) {
+            events.push(...partToEvents(transcript, entry, part, sequence, finalAssistantMessageEntryIds));
+            sequence += 1;
+        }
+    }
+    return events;
+};
+
+export const getQoderThreadTranscriptStats = (events: ThreadEvent[]): ThreadTranscriptStats => {
+    return getThreadTranscriptStats(events);
+};

package/apps/ui/src/lib/route-search.ts

@@ -0,0 +1,68 @@
+export type TextQuerySearch = {
+    q?: string;
+};
+
+export type AnalyticsSearch = {
+    project?: string;
+};
+
+type SearchRecord = Record<string, unknown>;
+
+const asNonBlankString = (value: unknown) => {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+
+export const parseTextQuerySearch = (search: SearchRecord): TextQuerySearch => {
+    const q = asNonBlankString(search.q);
+    return q ? { q } : {};
+};
+
+export const parseAnalyticsSearch = (search: SearchRecord): AnalyticsSearch => {
+    const project = asNonBlankString(search.project);
+    return project ? { project } : {};
+};
+
+export const withTextQuerySearch = (current: SearchRecord, query: string): SearchRecord & TextQuerySearch => {
+    const next = { ...current };
+    const q = asNonBlankString(query);
+    if (q) {
+        next.q = q;
+    } else {
+        delete next.q;
+    }
+
+    return next as SearchRecord & TextQuerySearch;
+};
+
+export const withAnalyticsProjectSearch = (
+    current: SearchRecord,
+    project: string | null,
+): SearchRecord & AnalyticsSearch => {
+    const next = { ...current };
+    const trimmedProject = asNonBlankString(project);
+    if (trimmedProject) {
+        next.project = trimmedProject;
+    } else {
+        delete next.project;
+    }
+
+    return next as SearchRecord & AnalyticsSearch;
+};
+
+const ALL_PROJECTS_SELECT_VALUE = '__all__';
+const PROJECT_SELECT_PREFIX = 'project:';
+
+export const encodeAnalyticsProjectSelectValue = (project: string | null) => {
+    return project ? `${PROJECT_SELECT_PREFIX}${project}` : ALL_PROJECTS_SELECT_VALUE;
+};
+
+export const decodeAnalyticsProjectSelectValue = (value: string) => {
+    return value === ALL_PROJECTS_SELECT_VALUE || !value.startsWith(PROJECT_SELECT_PREFIX)
+        ? null
+        : value.slice(PROJECT_SELECT_PREFIX.length);
+};

package/apps/ui/src/lib/settings-store.tsx

@@ -0,0 +1,59 @@
+import type { ReactNode } from 'react';
+import { createContext, useContext, useEffect, useState } from 'react';
+
+export type Settings = {
+    convertToProjectRoot: boolean;
+    redactUsername: boolean;
+};
+
+type SettingsContextValue = {
+    settings: Settings;
+    updateSetting: <K extends keyof Settings>(key: K, value: Settings[K]) => void;
+};
+
+const STORAGE_KEY = 'spiracha-settings';
+
+const defaultSettings: Settings = {
+    convertToProjectRoot: false,
+    redactUsername: false,
+};
+
+const SettingsContext = createContext<SettingsContextValue>({
+    settings: defaultSettings,
+    updateSetting: () => {},
+});
+
+const loadSettings = (): Settings => {
+    if (typeof window === 'undefined') {
+        return defaultSettings;
+    }
+    try {
+        const stored = window.localStorage.getItem(STORAGE_KEY);
+        return stored ? { ...defaultSettings, ...(JSON.parse(stored) as Partial<Settings>) } : defaultSettings;
+    } catch {
+        return defaultSettings;
+    }
+};
+
+export function SettingsProvider({ children }: { children: ReactNode }) {
+    const [settings, setSettings] = useState<Settings>(defaultSettings);
+
+    // Load from localStorage on mount (client only — avoids SSR hydration mismatch)
+    useEffect(() => {
+        setSettings(loadSettings());
+    }, []);
+
+    const updateSetting = <K extends keyof Settings>(key: K, value: Settings[K]) => {
+        setSettings((prev) => {
+            const next = { ...prev, [key]: value };
+            try {
+                localStorage.setItem(STORAGE_KEY, JSON.stringify(next));
+            } catch {}
+            return next;
+        });
+    };
+
+    return <SettingsContext.Provider value={{ settings, updateSetting }}>{children}</SettingsContext.Provider>;
+}
+
+export const useSettings = () => useContext(SettingsContext);

package/apps/ui/src/lib/source-session-export-server.ts

@@ -0,0 +1,56 @@
+import { randomUUID } from 'node:crypto';
+import { mkdtemp, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { getExportMimeType, sanitizeExportFileName, zipExportDirectory } from '@spiracha/lib/ui-export-archive';
+import { buildUiExportDownloadUrl, ensureUiExportDir } from '@spiracha/lib/ui-export-files';
+
+type ExportFormat = 'md' | 'txt';
+
+type RenderSourceSessionDownloadOptions = {
+    content: string;
+    fallbackBaseName: string;
+    fileBaseName: string;
+    outputFormat: ExportFormat;
+    zipArchive: boolean;
+};
+
+export const toSafeSourceExportName = (value: string, fallback: string) => {
+    return sanitizeExportFileName(value) || fallback;
+};
+
+export const renderSourceSessionDownload = async ({
+    content,
+    fallbackBaseName,
+    fileBaseName,
+    outputFormat,
+    zipArchive,
+}: RenderSourceSessionDownloadOptions) => {
+    const safeBaseName = toSafeSourceExportName(fileBaseName, fallbackBaseName);
+    if (!zipArchive) {
+        return {
+            content,
+            fileName: `${safeBaseName}.${outputFormat}`,
+            mimeType: getExportMimeType(outputFormat),
+            mode: 'download' as const,
+        };
+    }
+
+    const exportDir = await ensureUiExportDir();
+    const workspaceDir = await mkdtemp(path.join(os.tmpdir(), `${safeBaseName}-`));
+    const zipPath = path.join(exportDir, `${safeBaseName}-${randomUUID()}.zip`);
+
+    try {
+        await Bun.write(path.join(workspaceDir, `${safeBaseName}.${outputFormat}`), content);
+        await zipExportDirectory(workspaceDir, zipPath);
+    } finally {
+        await rm(workspaceDir, { force: true, recursive: true });
+    }
+
+    return {
+        downloadUrl: buildUiExportDownloadUrl(zipPath),
+        fileName: `${safeBaseName}.zip`,
+        mimeType: 'application/zip',
+        mode: 'download_url' as const,
+    };
+};

package/apps/ui/src/lib/text-filter.ts

@@ -0,0 +1,22 @@
+type SearchValue = boolean | number | string | null | undefined;
+
+const normalizeSearchToken = (value: string) => value.trim().toLowerCase();
+
+export const tokenizeSearchQuery = (query: string): string[] => {
+    const normalized = normalizeSearchToken(query);
+    return normalized ? normalized.split(/\s+/u).filter(Boolean) : [];
+};
+
+export const matchesTextQuery = (query: string, values: SearchValue[]): boolean => {
+    const tokens = tokenizeSearchQuery(query);
+    if (tokens.length === 0) {
+        return true;
+    }
+
+    const haystack = values
+        .filter((value) => value !== null && value !== undefined)
+        .map((value) => String(value).toLowerCase())
+        .join('\n');
+
+    return tokens.every((token) => haystack.includes(token));
+};

package/apps/ui/src/lib/thread-id.ts

@@ -0,0 +1,3 @@
+const THREAD_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+
+export const isCodexThreadId = (value: string) => THREAD_ID_PATTERN.test(value);

package/apps/ui/src/lib/thread-transcript-stats.ts

@@ -0,0 +1,57 @@
+import type { ThreadEvent, ThreadTranscriptStats } from '@spiracha/lib/codex-browser-types';
+
+const EXEC_TOOL_NAMES = new Set(['bash', 'exec', 'execute', 'execute_command', 'run_command', 'shell', 'terminal']);
+
+const isExecToolName = (name: string | null | undefined): boolean => {
+    return EXEC_TOOL_NAMES.has((name ?? '').trim().toLowerCase());
+};
+
+const updateMessageStats = (stats: ThreadTranscriptStats, event: Extract<ThreadEvent, { kind: 'message' }>) => {
+    stats.messageCount += 1;
+    if (event.role === 'assistant') {
+        stats.assistantMessageCount += 1;
+    }
+    if (event.role === 'user') {
+        stats.userMessageCount += 1;
+    }
+    if (event.phase === 'commentary') {
+        stats.commentaryCount += 1;
+    }
+    if (event.phase === 'final_answer') {
+        stats.finalAnswerCount += 1;
+    }
+};
+
+export const getThreadTranscriptStats = (events: ThreadEvent[]): ThreadTranscriptStats => {
+    const stats: ThreadTranscriptStats = {
+        assistantMessageCount: 0,
+        commentaryCount: 0,
+        execCommandCount: 0,
+        finalAnswerCount: 0,
+        messageCount: 0,
+        toolCallCount: 0,
+        toolOutputCount: 0,
+        userMessageCount: 0,
+        webSearchEventCount: 0,
+    };
+
+    for (const event of events) {
+        if (event.kind === 'message') {
+            updateMessageStats(stats, event);
+        }
+        if (event.kind === 'tool_call') {
+            stats.toolCallCount += 1;
+            if (isExecToolName(event.name)) {
+                stats.execCommandCount += 1;
+            }
+        }
+        if (event.kind === 'tool_output') {
+            stats.toolOutputCount += 1;
+        }
+        if (event.kind === 'web_search') {
+            stats.webSearchEventCount += 1;
+        }
+    }
+
+    return stats;
+};

package/apps/ui/src/lib/utils.ts

@@ -0,0 +1,7 @@
+import type { ClassValue } from 'clsx';
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+    return twMerge(clsx(inputs));
+}