@steipete/summarize 0.9.0 → 0.11.0

package/dist/types/run/slides-render.d.ts

@@ -0,0 +1,30 @@
+import type { SlideImage } from "../slides/types.js";
+export type SlidesRenderMode = "none" | "auto" | "kitty" | "iterm";
+export type InlineProtocol = "none" | "kitty" | "iterm";
+type RenderSlide = Pick<SlideImage, "imagePath" | "index" | "timestamp">;
+export declare function renderSlidesInline({ slides, mode, env, stdout, labelForSlide, }: {
+    slides: RenderSlide[];
+    mode: SlidesRenderMode;
+    env: Record<string, string | undefined>;
+    stdout: NodeJS.WritableStream;
+    labelForSlide?: ((slide: RenderSlide) => string) | null;
+}): Promise<{
+    rendered: number;
+    protocol: InlineProtocol;
+}>;
+export declare function createSlidesInlineRenderer({ mode, env, stdout, }: {
+    mode: SlidesRenderMode;
+    env: Record<string, string | undefined>;
+    stdout: NodeJS.WritableStream;
+}): {
+    protocol: InlineProtocol;
+    renderSlide: (slide: RenderSlide, label?: string | null) => Promise<boolean>;
+    renderSlides: (args: {
+        slides: RenderSlide[];
+        labelForSlide?: ((slide: RenderSlide) => string) | null;
+    }) => Promise<{
+        rendered: number;
+        protocol: InlineProtocol;
+    }>;
+};
+export {};

package/dist/types/run/stdin-temp-file.d.ts

@@ -0,0 +1,9 @@
+export type StdinTempFile = {
+    filePath: string;
+    kind: "text" | "binary";
+    cleanup: () => Promise<void>;
+};
+export declare function createTempFileFromStdin({ stream, maxBytes, }: {
+    stream: NodeJS.ReadableStream;
+    maxBytes?: number;
+}): Promise<StdinTempFile>;

package/dist/types/run/stream-output.d.ts

@@ -1,7 +1,8 @@
-export type StreamOutputMode = 'line' | 'delta';
-export declare function createStreamOutputGate({ stdout, clearProgressForStdout, outputMode, richTty, }: {
+export type StreamOutputMode = "line" | "delta";
+export declare function createStreamOutputGate({ stdout, clearProgressForStdout, restoreProgressAfterStdout, outputMode, richTty, }: {
     stdout: NodeJS.WritableStream;
     clearProgressForStdout: () => void;
+    restoreProgressAfterStdout?: (() => void) | null;
     outputMode: StreamOutputMode;
     richTty: boolean;
 }): {

package/dist/types/run/streaming.d.ts

@@ -1,12 +1,12 @@
-export { mergeStreamingChunk } from '../shared/streaming-merge.js';
+export { mergeStreamingChunk } from "../shared/streaming-merge.js";
 export declare function isGoogleStreamingUnsupportedError(error: unknown): boolean;
 export declare function isStreamingTimeoutError(error: unknown): boolean;
 export declare function canStream({ provider, prompt, transport, }: {
-    provider: 'xai' | 'openai' | 'google' | 'anthropic' | 'zai';
+    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
     prompt: {
         attachments?: Array<{
-            kind: 'text' | 'image' | 'document';
+            kind: "text" | "image" | "document";
         }>;
     };
-    transport: 'cli' | 'native' | 'openrouter';
+    transport: "cli" | "native" | "openrouter";
 }): boolean;

package/dist/types/run/summary-engine.d.ts

@@ -1,15 +1,15 @@
-import type { CliProvider } from '../config.js';
-import { runCliModel } from '../llm/cli.js';
-import type { Prompt } from '../llm/prompt.js';
-import { type StreamOutputMode } from './stream-output.js';
-import { summarizeWithModelId } from './summary-llm.js';
-import type { ModelAttempt, ModelMeta } from './types.js';
+import type { CliProvider } from "../config.js";
+import type { Prompt } from "../llm/prompt.js";
+import type { ModelAttempt, ModelMeta } from "./types.js";
+import { runCliModel } from "../llm/cli.js";
+import { type StreamOutputMode } from "./stream-output.js";
+import { summarizeWithModelId } from "./summary-llm.js";
 export type SummaryEngineDeps = {
     env: Record<string, string | undefined>;
     envForRun: Record<string, string | undefined>;
     stdout: NodeJS.WritableStream;
     stderr: NodeJS.WritableStream;
-    execFileImpl: Parameters<typeof runCliModel>[0]['execFileImpl'];
+    execFileImpl: Parameters<typeof runCliModel>[0]["execFileImpl"];
     timeoutMs: number;
     retries: number;
     streamingEnabled: boolean;
@@ -18,19 +18,20 @@ export type SummaryEngineDeps = {
     verbose: boolean;
     verboseColor: boolean;
     openaiUseChatCompletions: boolean;
-    cliConfigForRun: Parameters<typeof runCliModel>[0]['config'];
+    cliConfigForRun: Parameters<typeof runCliModel>[0]["config"];
     cliAvailability: Partial<Record<CliProvider, boolean>>;
     trackedFetch: typeof fetch;
     resolveMaxOutputTokensForCall: (modelId: string) => Promise<number | null>;
     resolveMaxInputTokensForCall: (modelId: string) => Promise<number | null>;
     llmCalls: Array<{
-        provider: 'xai' | 'openai' | 'google' | 'anthropic' | 'zai' | 'cli';
+        provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "cli";
         model: string;
-        usage: Awaited<ReturnType<typeof summarizeWithModelId>>['usage'] | null;
+        usage: Awaited<ReturnType<typeof summarizeWithModelId>>["usage"] | null;
         costUsd?: number | null;
-        purpose: 'summary' | 'markdown';
+        purpose: "summary" | "markdown";
     }>;
     clearProgressForStdout: () => void;
+    restoreProgressAfterStdout?: (() => void) | null;
     apiKeys: {
         xaiApiKey: string | null;
         openaiApiKey: string | null;
@@ -54,11 +55,19 @@ export type SummaryEngineDeps = {
         xai: string | null;
     };
 };
+export type SummaryStreamHandler = {
+    onChunk: (args: {
+        streamed: string;
+        prevStreamed: string;
+        appended: string;
+    }) => void | Promise<void>;
+    onDone?: ((finalText: string) => void | Promise<void>) | null;
+};
 export declare function createSummaryEngine(deps: SummaryEngineDeps): {
     applyZaiOverrides: (attempt: ModelAttempt) => ModelAttempt;
     envHasKeyFor: (requiredEnv: ModelAttempt["requiredEnv"]) => boolean;
     formatMissingModelError: (attempt: ModelAttempt) => string;
-    runSummaryAttempt: ({ attempt, prompt, allowStreaming, onModelChosen, cli, }: {
+    runSummaryAttempt: ({ attempt, prompt, allowStreaming, onModelChosen, cli, streamHandler, }: {
         attempt: ModelAttempt;
         prompt: Prompt;
         allowStreaming: boolean;
@@ -69,6 +78,7 @@ export declare function createSummaryEngine(deps: SummaryEngineDeps): {
             cwd?: string;
             extraArgsByProvider?: Partial<Record<CliProvider, string[]>>;
         } | null;
+        streamHandler?: SummaryStreamHandler | null;
     }) => Promise<{
         summary: string;
         summaryAlreadyPrinted: boolean;

package/dist/types/run/summary-llm.d.ts

@@ -1,6 +1,6 @@
-import { generateTextWithModelId } from '../llm/generate-text.js';
-import type { parseGatewayStyleModelId } from '../llm/model-id.js';
-import type { Prompt } from '../llm/prompt.js';
+import type { parseGatewayStyleModelId } from "../llm/model-id.js";
+import type { Prompt } from "../llm/prompt.js";
+import { generateTextWithModelId } from "../llm/generate-text.js";
 export declare function resolveModelIdForLlmCall({ parsedModel, apiKeys, fetchImpl, timeoutMs, }: {
     parsedModel: ReturnType<typeof parseGatewayStyleModelId>;
     apiKeys: {
@@ -41,7 +41,7 @@ export declare function summarizeWithModelId({ modelId, prompt, maxOutputTokens,
     }) => void;
 }): Promise<{
     text: string;
-    provider: 'xai' | 'openai' | 'google' | 'anthropic' | 'zai';
+    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
     canonicalModelId: string;
-    usage: Awaited<ReturnType<typeof generateTextWithModelId>>['usage'];
+    usage: Awaited<ReturnType<typeof generateTextWithModelId>>["usage"];
 }>;

package/dist/types/run/transcriber-cli.d.ts

@@ -0,0 +1,8 @@
+type TranscriberCliContext = {
+    normalizedArgv: string[];
+    envForRun: Record<string, string | undefined>;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+};
+export declare function handleTranscriberCliRequest({ normalizedArgv, envForRun, stdout, }: TranscriberCliContext): Promise<boolean>;
+export {};

package/dist/types/run/types.d.ts

@@ -1,7 +1,7 @@
-import type { CliProvider } from '../config.js';
-export type ModelAttemptRequiredEnv = 'XAI_API_KEY' | 'OPENAI_API_KEY' | 'GEMINI_API_KEY' | 'ANTHROPIC_API_KEY' | 'OPENROUTER_API_KEY' | 'Z_AI_API_KEY' | 'CLI_CLAUDE' | 'CLI_CODEX' | 'CLI_GEMINI';
+import type { CliProvider } from "../config.js";
+export type ModelAttemptRequiredEnv = "XAI_API_KEY" | "OPENAI_API_KEY" | "GEMINI_API_KEY" | "ANTHROPIC_API_KEY" | "OPENROUTER_API_KEY" | "Z_AI_API_KEY" | "CLI_CLAUDE" | "CLI_CODEX" | "CLI_GEMINI" | "CLI_AGENT";
 export type ModelAttempt = {
-    transport: 'native' | 'openrouter' | 'cli';
+    transport: "native" | "openrouter" | "cli";
     userModelId: string;
     llmModelId: string | null;
     openrouterProviders: string[] | null;
@@ -14,7 +14,7 @@ export type ModelAttempt = {
     cliModel?: string | null;
 };
 export type ModelMeta = {
-    provider: 'xai' | 'openai' | 'google' | 'anthropic' | 'zai' | 'cli';
+    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "cli";
     canonical: string;
 };
 export type MarkdownModel = {

package/dist/types/run.d.ts

@@ -1 +1 @@
-export { runCli } from './run/runner.js';
+export { runCli } from "./run/runner.js";

package/dist/types/shared/contracts.d.ts

@@ -1,2 +1,2 @@
-export type { SummaryLength } from '@steipete/summarize-core';
-export { SUMMARY_LENGTHS } from '@steipete/summarize-core';
+export type { SummaryLength } from "@steipete/summarize-core";
+export { SUMMARY_LENGTHS } from "@steipete/summarize-core";

package/dist/types/shared/sse-events.d.ts

@@ -1,9 +1,23 @@
+import type { AssistantMessage } from "@mariozechner/pi-ai";
 export type SseMetaData = {
     model: string | null;
     modelLabel: string | null;
     inputSummary: string | null;
     summaryFromCache?: boolean | null;
 };
+export type SseSlidesData = {
+    sourceUrl: string;
+    sourceId: string;
+    sourceKind: string;
+    ocrAvailable: boolean;
+    slides: Array<{
+        index: number;
+        timestamp: number;
+        imageUrl: string;
+        ocrText?: string | null;
+        ocrConfidence?: number | null;
+    }>;
+};
 export type SseMetricsData = {
     elapsedMs: number;
     summary: string;
@@ -12,26 +26,32 @@ export type SseMetricsData = {
     detailsDetailed: string | null;
 };
 export type SseEvent = {
-    event: 'meta';
+    event: "meta";
     data: SseMetaData;
 } | {
-    event: 'status';
+    event: "slides";
+    data: SseSlidesData;
+} | {
+    event: "status";
     data: {
         text: string;
     };
 } | {
-    event: 'chunk';
+    event: "chunk";
     data: {
         text: string;
     };
 } | {
-    event: 'metrics';
+    event: "assistant";
+    data: AssistantMessage;
+} | {
+    event: "metrics";
     data: SseMetricsData;
 } | {
-    event: 'done';
+    event: "done";
     data: Record<string, never>;
 } | {
-    event: 'error';
+    event: "error";
     data: {
         message: string;
     };

package/dist/types/slides/extract.d.ts

@@ -0,0 +1,43 @@
+import type { ExtractedLinkContent, MediaCache } from "../content/index.js";
+import type { SlideSettings } from "./settings.js";
+import type { SlideExtractionResult, SlideImage, SlideSource, SlideSourceKind } from "./types.js";
+type ExtractSlidesArgs = {
+    source: SlideSource;
+    settings: SlideSettings;
+    noCache?: boolean;
+    mediaCache?: MediaCache | null;
+    env: Record<string, string | undefined>;
+    timeoutMs: number;
+    ytDlpPath: string | null;
+    ytDlpCookiesFromBrowser?: string | null;
+    ffmpegPath: string | null;
+    tesseractPath: string | null;
+    hooks?: {
+        onSlideChunk?: (chunk: {
+            slide: SlideImage;
+            meta: {
+                slidesDir: string;
+                sourceUrl: string;
+                sourceId: string;
+                sourceKind: SlideSourceKind;
+                ocrAvailable: boolean;
+            };
+        }) => void;
+        onSlidesTimeline?: ((slides: SlideExtractionResult) => void) | null;
+        onSlidesProgress?: ((text: string) => void) | null;
+        onSlidesLog?: ((message: string) => void) | null;
+    } | null;
+};
+export declare function resolveSlideSource({ url, extracted, }: {
+    url: string;
+    extracted: ExtractedLinkContent;
+}): SlideSource | null;
+export declare function resolveSlideSourceFromUrl(url: string): SlideSource | null;
+export declare function extractSlidesForSource({ source, settings, noCache, mediaCache, env, timeoutMs, ytDlpPath, ytDlpCookiesFromBrowser, ffmpegPath, tesseractPath, hooks, }: ExtractSlidesArgs): Promise<SlideExtractionResult>;
+export declare function parseShowinfoTimestamp(line: string): number | null;
+export declare function resolveExtractedTimestamp({ requested, actual, seekBase, }: {
+    requested: number;
+    actual: number | null;
+    seekBase?: number | null;
+}): number;
+export {};

package/dist/types/slides/index.d.ts

@@ -0,0 +1,5 @@
+export { extractSlidesForSource, parseShowinfoTimestamp, resolveExtractedTimestamp, resolveSlideSource, resolveSlideSourceFromUrl, } from "./extract.js";
+export type { SlideSettings, SlideSettingsInput } from "./settings.js";
+export { resolveSlideSettings } from "./settings.js";
+export { buildSlidesDirId, readSlidesCacheIfValid, resolveSlideImagePath, resolveSlidesDir, serializeSlideImagePath, validateSlidesCache, } from "./store.js";
+export type { SlideAutoTune, SlideExtractionResult, SlideImage, SlideSource, SlideSourceKind, } from "./types.js";

package/dist/types/slides/settings.d.ts

@@ -0,0 +1,20 @@
+export type SlideSettings = {
+    enabled: boolean;
+    ocr: boolean;
+    outputDir: string;
+    sceneThreshold: number;
+    autoTuneThreshold: boolean;
+    maxSlides: number;
+    minDurationSeconds: number;
+};
+export type SlideSettingsInput = {
+    slides?: unknown;
+    slidesOcr?: unknown;
+    slidesDir?: unknown;
+    slidesSceneThreshold?: unknown;
+    slidesSceneThresholdExplicit?: boolean;
+    slidesMax?: unknown;
+    slidesMinDuration?: unknown;
+    cwd: string;
+};
+export declare function resolveSlideSettings(input: SlideSettingsInput): SlideSettings | null;

package/dist/types/slides/store.d.ts

@@ -0,0 +1,15 @@
+import type { SlideSettings } from "./settings.js";
+import type { SlideExtractionResult, SlideSource } from "./types.js";
+export declare function resolveSlidesDir(outputDir: string, sourceId: string): string;
+export declare function buildSlidesDirId(slidesDir: string): string;
+export declare function resolveSlideImagePath(slidesDir: string, imagePath: string): string | null;
+export declare function serializeSlideImagePath(slidesDir: string, imagePath: string): string;
+export declare function validateSlidesCache({ cached, source, settings, }: {
+    cached: SlideExtractionResult;
+    source: SlideSource;
+    settings: SlideSettings;
+}): Promise<SlideExtractionResult | null>;
+export declare function readSlidesCacheIfValid({ source, settings, }: {
+    source: SlideSource;
+    settings: SlideSettings;
+}): Promise<SlideExtractionResult | null>;

package/dist/types/slides/types.d.ts

@@ -0,0 +1,40 @@
+export type SlideSourceKind = "youtube" | "direct";
+export type SlideSource = {
+    url: string;
+    kind: SlideSourceKind;
+    sourceId: string;
+};
+export type SlideImage = {
+    index: number;
+    timestamp: number;
+    imagePath: string;
+    /**
+     * Bump when the underlying image file changes (e.g. thumbnail improvement),
+     * so clients can cache-bust URLs.
+     */
+    imageVersion?: number;
+    ocrText?: string | null;
+    ocrConfidence?: number | null;
+};
+export type SlideAutoTune = {
+    enabled: boolean;
+    chosenThreshold: number;
+    confidence: number;
+    strategy: "hash" | "none";
+};
+export type SlideExtractionResult = {
+    sourceUrl: string;
+    sourceKind: SlideSourceKind;
+    sourceId: string;
+    slidesDir: string;
+    slidesDirId?: string | null;
+    sceneThreshold: number;
+    autoTuneThreshold: boolean;
+    autoTune: SlideAutoTune;
+    maxSlides: number;
+    minSlideDuration: number;
+    ocrRequested: boolean;
+    ocrAvailable: boolean;
+    slides: SlideImage[];
+    warnings: string[];
+};

package/dist/types/tty/osc-progress.d.ts

@@ -1,5 +1,5 @@
-import { createOscProgressController as createOscProgressControllerImpl } from 'osc-progress';
-export type { OscProgressController, OscProgressOptions, OscProgressSupportOptions, OscProgressTerminator, } from 'osc-progress';
-export declare const createOscProgressController: typeof createOscProgressControllerImpl;
-export declare function startOscProgress(options: import('osc-progress').OscProgressOptions): () => void;
-export declare function supportsOscProgress(env: Record<string, string | undefined>, isTty: boolean, options?: import('osc-progress').OscProgressSupportOptions): boolean;
+import type { OscProgressController } from "osc-progress";
+export type { OscProgressController, OscProgressOptions, OscProgressSupportOptions, OscProgressTerminator, } from "osc-progress";
+export declare function createOscProgressController(options: import("osc-progress").OscProgressOptions): OscProgressController;
+export declare function startOscProgress(options: import("osc-progress").OscProgressOptions): () => void;
+export declare function supportsOscProgress(env: Record<string, string | undefined>, isTty: boolean, options?: import("osc-progress").OscProgressSupportOptions): boolean;

package/dist/types/tty/progress/fetch-html.d.ts

@@ -1,10 +1,12 @@
-import type { LinkPreviewProgressEvent } from '@steipete/summarize-core/content';
-import type { OscProgressController } from '../osc-progress.js';
-export declare function createFetchHtmlProgressRenderer({ spinner, oscProgress, }: {
+import type { LinkPreviewProgressEvent } from "@steipete/summarize-core/content";
+import type { OscProgressController } from "../osc-progress.js";
+import type { ThemeRenderer } from "../theme.js";
+export declare function createFetchHtmlProgressRenderer({ spinner, oscProgress, theme, }: {
     spinner: {
         setText: (text: string) => void;
     };
     oscProgress?: OscProgressController | null;
+    theme?: ThemeRenderer | null;
 }): {
     stop: () => void;
     onProgress: (event: LinkPreviewProgressEvent) => void;

package/dist/types/tty/progress/transcript.d.ts

@@ -1,10 +1,12 @@
-import type { LinkPreviewProgressEvent } from '@steipete/summarize-core/content';
-import type { OscProgressController } from '../osc-progress.js';
-export declare function createTranscriptProgressRenderer({ spinner, oscProgress, }: {
+import type { LinkPreviewProgressEvent } from "@steipete/summarize-core/content";
+import type { OscProgressController } from "../osc-progress.js";
+import type { ThemeRenderer } from "../theme.js";
+export declare function createTranscriptProgressRenderer({ spinner, oscProgress, theme, }: {
     spinner: {
         setText: (text: string) => void;
     };
     oscProgress?: OscProgressController | null;
+    theme?: ThemeRenderer | null;
 }): {
     stop: () => void;
     onProgress: (event: LinkPreviewProgressEvent) => void;

package/dist/types/tty/spinner.d.ts

@@ -1,7 +1,9 @@
-export declare function startSpinner({ text, enabled, stream, }: {
+import { type Options as OraOptions } from "ora";
+export declare function startSpinner({ text, enabled, stream, color, }: {
     text: string;
     enabled: boolean;
     stream: NodeJS.WritableStream;
+    color?: OraOptions["color"];
 }): {
     stop: () => void;
     clear: () => void;

package/dist/types/tty/theme.d.ts

@@ -0,0 +1,44 @@
+export declare const CLI_THEME_NAMES: readonly ["aurora", "ember", "moss", "mono"];
+export type CliThemeName = (typeof CLI_THEME_NAMES)[number];
+export type ThemeRole = "heading" | "accent" | "accentStrong" | "muted" | "dim" | "success" | "warning" | "error" | "label" | "value" | "code";
+type ThemePalette = {
+    name: CliThemeName;
+    roles: Record<ThemeRole, string>;
+    spinner: "cyan" | "magenta" | "yellow" | "green" | "gray" | "blue";
+};
+export declare const DEFAULT_CLI_THEME: CliThemeName;
+export declare function listCliThemes(): CliThemeName[];
+export declare function isCliThemeName(value: string): value is CliThemeName;
+export declare function parseCliThemeName(raw: unknown, label: string): CliThemeName | null;
+export declare function resolveThemeNameFromSources({ cli, env, config, fallback, }: {
+    cli?: unknown;
+    env?: unknown;
+    config?: unknown;
+    fallback?: CliThemeName;
+}): CliThemeName;
+export declare function resolveTrueColor(env: Record<string, string | undefined>): boolean;
+type ThemeRendererOptions = {
+    themeName: CliThemeName;
+    enabled: boolean;
+    trueColor: boolean;
+};
+export type ThemeRenderer = {
+    name: CliThemeName;
+    enabled: boolean;
+    trueColor: boolean;
+    palette: ThemePalette;
+    heading: (text: string) => string;
+    accent: (text: string) => string;
+    accentStrong: (text: string) => string;
+    label: (text: string) => string;
+    value: (text: string) => string;
+    muted: (text: string) => string;
+    dim: (text: string) => string;
+    success: (text: string) => string;
+    warning: (text: string) => string;
+    error: (text: string) => string;
+    code: (text: string) => string;
+};
+export declare function createThemeRenderer({ themeName, enabled, trueColor, }: ThemeRendererOptions): ThemeRenderer;
+export declare function resolveThemePalette(themeName: CliThemeName): ThemePalette;
+export {};

package/dist/types/tty/website-progress.d.ts

@@ -1,11 +1,13 @@
-import type { LinkPreviewProgressEvent } from '@steipete/summarize-core/content';
-import type { OscProgressController } from './osc-progress.js';
-export declare function createWebsiteProgress({ enabled, spinner, oscProgress, }: {
+import type { LinkPreviewProgressEvent } from "@steipete/summarize-core/content";
+import type { OscProgressController } from "./osc-progress.js";
+import type { ThemeRenderer } from "./theme.js";
+export declare function createWebsiteProgress({ enabled, spinner, oscProgress, theme, }: {
     enabled: boolean;
     spinner: {
         setText: (text: string) => void;
     };
     oscProgress?: OscProgressController | null;
+    theme?: ThemeRenderer | null;
 }): {
     stop: () => void;
     onProgress: (event: LinkPreviewProgressEvent) => void;

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const FALLBACK_VERSION = "0.9.0";
+export declare const FALLBACK_VERSION = "0.11.0";
 export declare function resolvePackageVersion(importMetaUrl?: string): string;
 export declare function resolveGitSha(importMetaUrl?: string): string | null;
 export declare function formatVersionLine(importMetaUrl?: string): string;

package/docs/README.md

@@ -22,4 +22,4 @@ summary: "Docs index for summarize behaviors and modes."
 
 ## Website
 
-- Static site source: `docs/site/` (GitHub Pages via Actions)
+- Jekyll site source: `docs/` (Markdown → HTML via GitHub Pages Actions)

package/docs/_config.yml

@@ -0,0 +1,26 @@
+title: "summarize"
+description: "Summarize docs"
+markdown: kramdown
+highlighter: rouge
+
+plugins:
+  - jekyll-relative-links
+
+relative_links:
+  enabled: true
+  collections: true
+
+exclude:
+  - site
+
+defaults:
+  - scope:
+      path: ""
+    values:
+      layout: default
+      permalink: /docs/:basename:output_ext
+
+kramdown:
+  input: GFM
+  hard_wrap: false
+  syntax_highlighter: rouge

package/docs/_layouts/default.html

@@ -0,0 +1,60 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <meta name="color-scheme" content="dark light" />
+    {% assign page_title = page.title | default: page.name | default: "Docs" | replace: ".md", "" | replace: "-", " " %}
+    <title>{{ page_title }} — summarize</title>
+    <meta name="description" content="{{ page.summary | default: site.description | escape }}" />
+    <link rel="canonical" href="https://summarize.sh{{ page.url | replace: 'index.html', '' }}" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap"
+      rel="stylesheet"
+    />
+    <link rel="stylesheet" href="/assets/site.css" />
+  </head>
+  <body>
+    <main class="shell">
+      <header class="top">
+        <a class="brand" href="/" aria-label="summarize home">
+          <span class="brand__mark" aria-hidden="true">s</span>
+          <span class="brand__word">summarize</span>
+        </a>
+        <nav class="nav" aria-label="Primary">
+          <a data-nav="home" href="/">Home</a>
+          <a data-nav="docs" href="/docs/index.html">Docs</a>
+          <a href="https://github.com/steipete/summarize">GitHub</a>
+        </nav>
+      </header>
+
+      <section class="docShell">
+        <aside class="side" aria-label="Docs navigation">
+          <h2>Docs</h2>
+          <a href="/docs/index.html">Overview</a>
+          <a href="/docs/chrome-extension.html">Chrome extension</a>
+          <a href="/docs/website.html">Website mode</a>
+          <a href="/docs/youtube.html">YouTube mode</a>
+          <a href="/docs/extract-only.html">Extract</a>
+          <a href="/docs/llm.html">LLM</a>
+          <a href="/docs/openai.html">OpenAI</a>
+          <a href="/docs/firecrawl.html">Firecrawl</a>
+          <a href="/docs/config.html">Config</a>
+        </aside>
+
+        <article class="doc reveal">
+          {{ content }}
+        </article>
+      </section>
+
+      <footer class="footer">
+        <span>summarize — Link → clean text → summary.</span>
+        <span><a href="/docs/index.html">Docs</a> · <a href="https://github.com/steipete/summarize">Repo</a></span>
+      </footer>
+    </main>
+
+    <script type="module" src="/assets/site.js"></script>
+  </body>
+</html>