@aexol/spectral 0.8.0 → 0.8.5

package/dist/server/shutdown.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Graceful shutdown helper for `spectral serve`.
+ *
+ * Why a separate module:
+ *  - The shutdown flag (`shutdownState.isShuttingDown`) is read by the relay
+ *    dispatcher to reject new `client_message` envelopes. Putting it on
+ *    `serve.ts` would create a circular import (dispatcher → serve → relay
+ *    client → …); pulling it out keeps the dependency graph linear.
+ *  - The orchestration is small but has enough edge cases (idempotent on a
+ *    second SIGTERM, bounded wait for in-flight streams, best-effort store
+ *    close) that it's worth one focused unit test.
+ *
+ * Behaviour summary (matches the contract in the Batch 6 brief):
+ *  1. First SIGINT/SIGTERM:
+ *     - Log "Shutting down…" to stderr.
+ *     - Flip `shutdownState.isShuttingDown = true`. From this point on the
+ *       dispatcher refuses new `client_message` frames with an error
+ *       wrapped as a `ws_event` (so the browser sees the rejection on the
+ *       same stream it was using).
+ *     - Wait up to `gracePeriodMs` (default 5_000 ms) for the in-flight
+ *       stream count reported by `inFlightCount()` to drain to 0. Polled
+ *       every 100 ms — any non-zero value indicates an active turn.
+ *     - Close the relay (code 1000, reason "shutdown") and dispose the
+ *       manager. The dispose order matters: relay first so the backend
+ *       sees a clean close before our local state goes; manager second so
+ *       any pi processes get torn down deterministically.
+ *     - Close the SQLite store (best-effort — a failure here just gets
+ *       logged; the process is exiting anyway).
+ *     - Exit with the supplied code (default 0).
+ *  2. Second SIGINT/SIGTERM during the grace period: skip the wait, force
+ *     immediate exit with code 1. We don't want a hung pi process to
+ *     prevent operators from killing the server with a second Ctrl-C.
+ *
+ * The function is intentionally framework-free — it takes plain callbacks
+ * for everything I/O-shaped so the unit test can exercise the orchestration
+ * without spawning a real relay or sqlite handle.
+ */
+/**
+ * Process-wide shutdown flag. Read by the dispatcher to gate new
+ * `client_message` envelopes; written by `gracefulShutdown` (and by tests
+ * via `resetShutdownState`).
+ *
+ * Module-level singleton because there is exactly one server process per
+ * `spectral serve` invocation; co-locating with serve.ts would require
+ * threading the flag through the dispatcher's deps (already a small
+ * object) and risks dispatcher tests carrying serve.ts state.
+ */
+export declare const shutdownState: {
+    isShuttingDown: boolean;
+};
+/**
+ * Reset the singleton flag. Tests use this in `beforeEach` so a previous
+ * test's shutdown doesn't bleed into the next. Production code must NOT
+ * call this — once the process is shutting down, it's shutting down.
+ */
+export declare function resetShutdownState(): void;
+export interface GracefulShutdownOptions {
+    /** Logger; defaults to `console`. Tests inject a noop or a recorder. */
+    logger?: Pick<Console, "log" | "warn" | "error">;
+    /**
+     * Reports in-flight stream count (e.g. `() => manager.activeTurnCount()`).
+     * Polled every 100 ms until it returns 0 or `gracePeriodMs` elapses.
+     * If omitted we skip the wait entirely (treated as "nothing in flight").
+     */
+    inFlightCount?: () => number;
+    /** Close the relay with code 1000 / reason "shutdown". */
+    closeRelay?: () => void | Promise<void>;
+    /** Dispose the SessionStreamManager (kills pi processes). */
+    disposeManager?: () => void | Promise<void>;
+    /** Close the SQLite store. Failures are logged, not rethrown. */
+    closeStore?: () => void;
+    /** Bound on how long to wait for in-flight streams. Default 5_000 ms. */
+    gracePeriodMs?: number;
+    /** Polling interval for the in-flight wait. Default 100 ms. */
+    pollIntervalMs?: number;
+    /** Exit code on a clean first-signal shutdown. Default 0. */
+    exitCode?: number;
+    /**
+     * Override `process.exit` for tests. Not called as a function reference
+     * directly so the test can assert on what was requested without actually
+     * killing vitest.
+     */
+    exitFn?: (code: number) => void;
+    /**
+     * Sleep helper. Tests inject a mock clock; production uses real
+     * `setTimeout`. Resolves after `ms` milliseconds.
+     */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** Test-only: reset the entry counter alongside `shutdownState`. */
+export declare function resetShutdownEntryCount(): void;
+/**
+ * Run the graceful shutdown sequence. Idempotent on the entry-count
+ * dimension: the second concurrent call resolves immediately after
+ * triggering an immediate exit.
+ *
+ * Returns once the supplied `exitFn` has been invoked (or would have been
+ * invoked in production where `process.exit` does not return). Tests can
+ * await it to assert ordering.
+ */
+export declare function gracefulShutdown(opts?: GracefulShutdownOptions): Promise<void>;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/server/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../src/server/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAEpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAaD,oEAAoE;AACpE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CAmGf"}

package/dist/server/storage.d.ts

@@ -0,0 +1,287 @@
+/**
+ * SQLite-backed project/session/message storage for `spectral serve`.
+ *
+ * Two-tier model:
+ *   projects ─< sessions ─< messages
+ *
+ * Single-process, single-file. Using `better-sqlite3` because:
+ *  - Synchronous API is a perfect fit for the per-WS-event write pattern.
+ *  - No connection pool, no callback churn, transactions are trivial.
+ *  - Native module ships prebuilt binaries for every Node version we support.
+ *
+ * Schema migrations:
+ *   We track schema with the `user_version` PRAGMA. When opening a DB whose
+ *   version does not match `SCHEMA_VERSION`, we DROP every known table and
+ *   recreate. This is safe pre-1.0 because the agent UI is local-only and
+ *   the data is conversation history we explicitly opted not to migrate
+ *   for the project-tier rollout. Anything newer (real users with real
+ *   data) needs a proper migration table.
+ *
+ * Foreign keys are enabled so DELETE FROM projects cascades to sessions
+ * cascades to messages. The route layer must still tear down any in-flight
+ * pi streams BEFORE deleting — see `SessionStreamManager.disposeProjectStreams`.
+ *
+ * The repo is intentionally a thin wrapper. We do NOT expose `Database`
+ * itself — callers go through the typed methods so we can swap the backend
+ * later (e.g. if we ever need to colocate with a remote service).
+ */
+import type { ImageAttachment, WireMessage, WireProject, WireSessionDetail, WireSessionSummary } from "./wire.js";
+import type { SupportedMemoryDetails } from "../memory/types.js";
+/** A single message as stored in SQLite. Identical to WireMessage. */
+export type StoredMessage = WireMessage;
+/** Input shape for `appendMessage`. */
+export interface AppendMessageInput {
+    /** Optional override; otherwise a UUID is generated. */
+    id?: string;
+    role: "user" | "assistant" | "system";
+    content: string;
+    /** Already-serialized JSONL of streamed events. Default "". */
+    eventsJsonl?: string;
+    /** Optional override; otherwise Date.now(). */
+    createdAt?: number;
+    /** Base64-encoded images attached to user messages (omitted for assistant/system). */
+    images?: ImageAttachment[];
+}
+export interface CreateSessionInput {
+    /** Owning project. Required — sessions cannot exist standalone. */
+    projectId: string;
+    /** Optional override; otherwise a UUID is generated. */
+    id?: string;
+    /** Optional title; default "New conversation". */
+    title?: string;
+}
+export interface CreateProjectInput {
+    /** Optional override; otherwise a UUID is generated. */
+    id?: string;
+    name: string;
+    /** Absolute, validated filesystem path. */
+    path: string;
+}
+export interface SessionMemorySnapshot {
+    sessionId: string;
+    summary: string;
+    details: SupportedMemoryDetails;
+    coveredSourceCount: number;
+    updatedAt: number;
+}
+export interface UpdateProjectInput {
+    name?: string;
+    /** Already-validated absolute path. */
+    path?: string;
+}
+interface QueueRow {
+    id: string;
+    session_id: string;
+    content: string;
+    position: number;
+    created_at: string;
+}
+export declare class SessionStore {
+    readonly path: string;
+    private db;
+    private closed;
+    private stmtListProjects;
+    private stmtGetProject;
+    private stmtCreateProject;
+    private stmtUpdateProject;
+    private stmtDeleteProject;
+    private stmtListSessionsByProject;
+    private stmtListSessionIdsByProject;
+    private stmtGetSession;
+    private stmtCreateSession;
+    private stmtDeleteSession;
+    private stmtListMessages;
+    private stmtAppendMessage;
+    private stmtDeleteMessage;
+    private stmtDeleteMessagesBySession;
+    private stmtTouchSession;
+    private stmtRenameSession;
+    private stmtSessionWithCount;
+    private stmtGetSessionMemorySnapshot;
+    private stmtUpsertSessionMemorySnapshot;
+    private stmtDeleteSessionMemorySnapshot;
+    private stmtGetSessionModel;
+    private stmtSetSessionModel;
+    private stmtGetSessionReasoningEffort;
+    private stmtSetSessionReasoningEffort;
+    private stmtSetForkCompactSource;
+    private stmtGetForkCompactSource;
+    private stmtInsertProjectObs;
+    private stmtSearchProjectObs;
+    private stmtGetProjectByCwd;
+    private stmtEnqueuePrompt;
+    private stmtGetPromptQueue;
+    private stmtDequeuePrompt;
+    private stmtDeleteQueueItem;
+    private stmtClearSessionQueue;
+    private stmtShiftPositions;
+    constructor(path: string);
+    /** Smoke check: returns the names of the tables in the DB. */
+    listTables(): string[];
+    listProjects(): WireProject[];
+    createProject(input: CreateProjectInput): WireProject;
+    /** Returns null if not found. */
+    getProject(id: string): WireProject | null;
+    /**
+     * Update a project's name and/or path. At least one must be provided.
+     * Returns the updated project, or null if not found. Empty `name` falls
+     * back to "Untitled project" for parity with createProject.
+     */
+    updateProject(id: string, input: UpdateProjectInput): WireProject | null;
+    /**
+     * Delete a project. Cascades to sessions and messages via FK.
+     * Caller MUST tear down any active SessionStream subscribers / pi
+     * processes for sessions in this project BEFORE invoking this.
+     * Returns the list of session ids that belonged to the project (so
+     * the caller can include them in the stream-teardown call).
+     */
+    deleteProject(id: string): {
+        deleted: boolean;
+        sessionIds: string[];
+    };
+    /** Sessions belonging to a single project, newest-first. */
+    listSessionsByProject(projectId: string): WireSessionSummary[];
+    createSession(input: CreateSessionInput): WireSessionSummary;
+    /** Returns null if not found. */
+    getSession(id: string): WireSessionDetail | null;
+    /** Convenience for routes/managers that just need the projectId. */
+    getSessionProjectId(id: string): string | null;
+    getMessages(sessionId: string): StoredMessage[];
+    /**
+     * Append a message and bump the session's updated_at in one transaction.
+     * Throws if the session doesn't exist (FK violation).
+     */
+    /** Delete a message by id. No-op if the message doesn't exist. */
+    deleteMessage(id: string): void;
+    /** Delete all persisted messages for a session. */
+    deleteMessagesBySession(sessionId: string): void;
+    appendMessage(sessionId: string, msg: AppendMessageInput): StoredMessage;
+    /**
+     * Rename a session. Bumps `updated_at`. Returns the updated summary, or
+     * null if the session doesn't exist. Title is trimmed; an empty title falls
+     * back to "New conversation" for parity with createSession().
+     */
+    renameSession(id: string, title: string): WireSessionSummary | null;
+    /** Returns true if a row was deleted. Cascades to messages. */
+    deleteSession(id: string): boolean;
+    getSessionMemorySnapshot(sessionId: string): SessionMemorySnapshot | null;
+    upsertSessionMemorySnapshot(sessionId: string, snapshot: Omit<SessionMemorySnapshot, "sessionId" | "updatedAt">): void;
+    deleteSessionMemorySnapshot(sessionId: string): void;
+    /**
+     * Get the persisted modelId for a session, or null if none was ever set or
+     * the session does not exist. The CLI uses this for cross-restart recovery:
+     * when an envelope arrives WITHOUT a `modelId` but SQLite has a value
+     * persisted from an earlier turn, we apply the persisted value before
+     * forwarding to pi. When neither envelope nor SQLite have a value, we
+     * leave model selection to pi's own settings file (pre-Phase-3 behaviour).
+     */
+    getSessionModel(sessionId: string): string | null;
+    /**
+     * Persist the modelId for a session. Pass `null` to clear. Does NOT bump
+     * `updated_at` — model selection is metadata, not user activity, so it
+     * shouldn't promote a session to the top of the sidebar. Silently no-ops
+     * when the session does not exist (the caller has already validated the
+     * sessionId via attach/getSession in the normal flow).
+     */
+    setSessionModel(sessionId: string, modelId: string | null): void;
+    /**
+     * Get the persisted reasoningEffort for a session, or null if none
+     * was ever set. Returns null for unknown sessions (consistent with
+     * getSessionModel's contract).
+     */
+    getSessionReasoningEffort(sessionId: string): string | null;
+    /**
+     * Persist the reasoningEffort for a session. Pass `null` to clear.
+     * Same semantics as setSessionModel — best-effort metadata, does
+     * not bump `updated_at`.
+     */
+    setSessionReasoningEffort(sessionId: string, effort: string | null): void;
+    /**
+     * Fork a session: create a new session in the same project, copy all
+     * messages from the source, and set the `fork_compact_source_id` flag
+     * so SessionStreamManager compacts the context after the first assistant
+     * turn completes.
+     */
+    forkSession(sourceId: string, opts?: {
+        title?: string;
+        newSessionId?: string;
+    }): WireSessionSummary;
+    /**
+     * Read the fork-compact source id for a session, or null if the session
+     * was not forked or has already been compacted.
+     */
+    getForkCompactSource(sessionId: string): string | null;
+    /**
+     * Clear the fork-compact flag after compaction completes (or fails).
+     * Idempotent-safe.
+     */
+    clearForkCompactSource(sessionId: string): void;
+    /**
+     * Insert multiple project observations in a single transaction.
+     * Uses INSERT OR REPLACE so re-running after the same compaction is idempotent.
+     */
+    insertProjectObservations(projectId: string, sessionId: string, observations: Array<{
+        id: string;
+        content: string;
+        relevance: string;
+    }>, createdAt: number): void;
+    /**
+     * Search project observations by substring match. Returns up to 20 most recent.
+     */
+    searchProjectObservations(projectId: string, query: string, limit?: number): Array<{
+        content: string;
+        relevance: string;
+        createdAt: number;
+        sessionId: string;
+    }>;
+    /**
+     * Look up a project by its absolute filesystem path.
+     * Returns null when no project has been registered for the given path.
+     */
+    getProjectByCwd(cwd: string): string | null;
+    /**
+     * Enqueue a prompt for a session. Returns the created queue item.
+     * Position is auto-assigned as (max existing position + 1).
+     */
+    enqueuePrompt(sessionId: string, content: string): QueueRow;
+    /**
+     * Dequeue (remove and return) the first prompt for a session.
+     * Returns null if the queue is empty.
+     * Renumbers remaining items so positions stay contiguous from 0.
+     */
+    dequeuePrompt(sessionId: string): QueueRow | null;
+    /**
+     * Get the full prompt queue for a session, ordered by position.
+     */
+    getPromptQueue(sessionId: string): QueueRow[];
+    /**
+     * Remove a specific prompt from the queue by id.
+     * Renumbers remaining items so positions stay contiguous.
+     */
+    removePrompt(sessionId: string, itemId: string): void;
+    /**
+     * Clear the entire prompt queue for a session.
+     */
+    clearPromptQueue(sessionId: string): void;
+    close(): void;
+}
+/**
+ * Pre-flight: verify that better-sqlite3 loads and a writable DB can be opened.
+ *
+ * Called before binding the port so a broken native build fails loudly with
+ * a helpful hint instead of crashing later when the first WS connection
+ * arrives.
+ *
+ * Implementation note: we test by opening the *real* target path. Opening a
+ * tmpfile would only verify that the native module loads, not that the
+ * config dir is writable. Since `open()` already creates the file/dir
+ * idempotently, this is safe to call repeatedly.
+ */
+export interface PreflightResult {
+    ok: boolean;
+    /** Human-friendly error message ready to print. Set when ok=false. */
+    error?: string;
+}
+export declare function preflightSqlite(dbPath: string): PreflightResult;
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/server/storage.d.ts.map

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

package/dist/server/title-generator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Session title utilities.
+ *
+ * Pure helpers for title sanitization and default-title detection.
+ * Title generation now happens via the backend GraphQL mutation
+ * `generateSessionTitle`, called from the landing frontend after the
+ * first assistant turn completes. The CLI no longer has its own LLM
+ * pipeline for titles — the landing→backend→CLI REST PATCH flow
+ * handles both the rename and the cross-tab meta publish.
+ */
+export declare const SESSION_TITLE_DEFAULT = "New conversation";
+/** True if `title` looks like the auto-generated default and is fair game. */
+export declare function isDefaultTitle(title: string | null | undefined): boolean;
+/**
+ * Sanitize raw LLM output into a usable session title.
+ * Returns `null` if nothing usable remains.
+ */
+export declare function sanitizeTitle(raw: string): string | null;
+/**
+ * A function that takes a prompt string and returns LLM output text.
+ * Tests inject stubs here; production code no longer uses this type
+ * since the CLI-side auto-title pipeline was removed.
+ */
+export type LlmCall = (prompt: string) => Promise<string>;
+//# sourceMappingURL=title-generator.d.ts.map

package/dist/server/title-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-generator.d.ts","sourceRoot":"","sources":["../../src/server/title-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAGxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoCxD;AAED;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC"}