markdown-markdown 0.2.0

package/AGENT.md

@@ -0,0 +1,47 @@
+# Agent Guide
+
+This repository is a Vite + React + TypeScript package that ships a Markdown review CLI plus a local browser UI.
+
+For agent-facing usage guidance, use the separate [`markdown-markdown-skill`](https://github.com/zhouchangui/markdown-markdown-skill) repository. Keep this repo focused on the CLI, local web service, and browser experience.
+
+## Project Layout
+
+- `src/App.tsx` is the browser application shell.
+- `src/main.tsx` mounts the React app.
+- `src/cli.ts` is the Node CLI entrypoint.
+- `src/server/` contains the local HTTP runtime and browser launcher.
+- `src/components/` contains UI building blocks such as the sidebar, markdown viewer, inline annotation form, hoverable blocks, and Mermaid rendering.
+- `src/lib/` contains shared helpers.
+- `src/index.ts` exports reusable package APIs.
+- `src/index.css` defines the global styling layer.
+
+## Setup And Run
+
+- Install dependencies with `npm install`.
+- Start local development with `npm run dev`.
+- Build production assets with `npm run build`.
+- Run TypeScript checks with `npm run lint`.
+- Run the test suite with `npm test`.
+- Publish releases through GitHub Actions on `v*` tags; avoid local `npm publish` except for bootstrap or debugging.
+
+## Environment
+
+- Set `GEMINI_API_KEY` in `.env.local` before running features that depend on Gemini.
+- The browser UI falls back to a demo session in Vite dev mode if the local review server is unavailable.
+- If `cloudflared` is present, the CLI opens the review session through a public tunnel; otherwise it uses `localhost`.
+- Use `--cloudflare` to require a tunnel, `--no-cloudflare` to force localhost, `--output <file>` to persist the final JSON, and `--status-file <file>` to emit agent-friendly lifecycle updates.
+- Use `--browser system` if you want the review session to open in the system default browser instead of the compact app-style window.
+
+## Working Rules
+
+- Prefer small, focused edits that fit the existing component structure.
+- Reuse existing utilities and components before introducing new abstractions.
+- Keep TypeScript types aligned with UI changes.
+- Preserve the markdown rendering and annotation flow unless the task explicitly asks to change it.
+- Avoid adding dependencies unless they are clearly required.
+
+## Verification
+
+- For UI or TypeScript changes, run `npm run lint`.
+- For broader changes, also run `npm run build`.
+- For runtime changes, also run `npm test`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zhouchangui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# markdown-markdown
+
+Local Markdown review and annotation CLI.
+
+Point it at a single Markdown file or a directory of Markdown files, make annotations in the browser, then submit once you are done. The command exits and prints a JSON payload that can be handed to an AI system or another automation step.
+
+## Companion Skill
+
+If you want agent instructions for using this CLI, install the separate [`markdown-markdown-skill`](https://github.com/zhouchangui/markdown-markdown-skill) repository. This package stays focused on the CLI and browser runtime.
+
+## Install
+
+```bash
+npm install
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+This produces:
+
+- `dist/cli.js` for the command-line entrypoint
+- `dist/index.js` for shared exports
+- `dist/web/` for the browser UI
+
+## Release
+
+Releases are handled by GitHub Actions. Push a tag that starts with `v` such as `v0.1.1`, and the workflow will build and publish the package to npm.
+
+The workflow uses GitHub Actions trusted publishing, so no npm token needs to be stored in the repository.
+
+## Use
+
+```bash
+npx markdown-markdown ./docs
+```
+
+or
+
+```bash
+npx markdown-markdown ./docs/spec.md
+```
+
+To open the session in the system default browser instead of the compact app-style window, use:
+
+```bash
+npx markdown-markdown --browser system ./docs/spec.md
+```
+
+To force a Cloudflare public URL and fail fast when `cloudflared` is missing:
+
+```bash
+npx markdown-markdown --cloudflare ./docs/spec.md
+```
+
+To force localhost only, even if `cloudflared` is installed:
+
+```bash
+npx markdown-markdown --no-cloudflare ./docs/spec.md
+```
+
+To write the final review JSON and a lightweight lifecycle status file for agents to poll:
+
+```bash
+npx markdown-markdown --output ./out/review.json --status-file ./out/review.status.json ./docs/spec.md
+```
+
+The CLI will:
+
+- discover Markdown files
+- launch a local web session
+- use a public Cloudflare tunnel when `cloudflared` is installed, unless you pass `--no-cloudflare`
+- fail fast with a clear install message when you pass `--cloudflare` but `cloudflared` is missing
+- let you annotate headings, paragraphs, blockquotes, lists, tables, code blocks, images, and horizontal rules
+- submit the annotations and close the browser
+- print the final JSON result to stdout
+- optionally write the final JSON to `--output`
+- optionally write running/completed/failed status snapshots to `--status-file`
+
+## Output
+
+The submitted JSON includes:
+
+- `rootPath`
+- `mode`
+- `files`
+- `annotations`
+- `prompt`
+- `submittedAt`
+
+The `prompt` field is a ready-to-send Markdown summary of the requested changes, grouped by file with short anchor text and line ranges so an AI can locate the target block without extra token cost.
+
+If you use `--status-file`, the agent-friendly lifecycle file will move through:
+
+- `running`
+- `completed`
+- `failed`
+
+That file is the simplest way to know when an asynchronous caller should consider the review finished.
+
+## Development
+
+- `npm run dev` runs the Vite UI in demo mode
+- `npm run lint` runs TypeScript checks
+- `npm test` runs the test suite
+
+If the app cannot reach the local review service during development, it falls back to a built-in demo session so you can still work on the UI.

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import type { BrowserMode, CloudflareMode } from './types.js';
+export interface ParsedCliArgs {
+    targetArg: string | null;
+    browserMode: BrowserMode;
+    cloudflareMode: CloudflareMode;
+    outputPath: string | null;
+    statusPath: string | null;
+    helpRequested: boolean;
+}
+export declare function parseCliArgs(argv: string[]): ParsedCliArgs;
+export declare function isDirectExecutionEntry(argv1: string | undefined, moduleUrl: string): boolean;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;CACxB;AA0BD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAsI1D;AAmMD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAS5F"}

package/dist/cli.js

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+import { existsSync, realpathSync } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildCompletedStatus, buildFailedStatus, buildRunningStatus, writeJsonFile } from './lib/lifecycle.js';
+import { discoverMarkdownFiles } from './server/session.js';
+import { launchBrowser } from './server/browser.js';
+import { hasCloudflaredExecutable, launchCloudflaredTunnel } from './server/tunnel.js';
+import { startReviewRuntime } from './server/runtime.js';
+function resolveRealpath(candidate) {
+    try {
+        return realpathSync(candidate);
+    }
+    catch {
+        return path.resolve(candidate);
+    }
+}
+function printUsage() {
+    console.error([
+        'Usage: markdown-markdown [options] <file-or-directory>',
+        '',
+        'Options:',
+        '  --browser app|system        Browser launch mode (default: app)',
+        '  --cloudflare                Require a Cloudflare tunnel',
+        '  --cloudflare=auto|required|off',
+        '  --no-cloudflare             Force localhost only',
+        '  --output <file>             Write the final review JSON to a file',
+        '  --status-file <file>        Write running/completed status updates to a file',
+    ].join('\n'));
+}
+export function parseCliArgs(argv) {
+    let browserMode = 'app';
+    let cloudflareMode = 'auto';
+    let outputPath = null;
+    let statusPath = null;
+    let targetArg = null;
+    let parsingOptions = true;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (parsingOptions && arg === '--') {
+            parsingOptions = false;
+            continue;
+        }
+        if (parsingOptions && (arg === '--help' || arg === '-h')) {
+            return {
+                targetArg: null,
+                browserMode,
+                cloudflareMode,
+                outputPath,
+                statusPath,
+                helpRequested: true,
+            };
+        }
+        if (parsingOptions && (arg === '--system-browser' || arg === '--browser=system')) {
+            browserMode = 'system';
+            continue;
+        }
+        if (parsingOptions && (arg === '--app-browser' || arg === '--browser=app')) {
+            browserMode = 'app';
+            continue;
+        }
+        if (parsingOptions && arg === '--cloudflare') {
+            cloudflareMode = 'required';
+            continue;
+        }
+        if (parsingOptions && arg === '--no-cloudflare') {
+            cloudflareMode = 'off';
+            continue;
+        }
+        if (parsingOptions && arg.startsWith('--cloudflare=')) {
+            const mode = arg.slice('--cloudflare='.length);
+            if (mode !== 'auto' && mode !== 'required' && mode !== 'off') {
+                throw new Error(`Unsupported cloudflare mode: ${mode}`);
+            }
+            cloudflareMode = mode;
+            continue;
+        }
+        if (parsingOptions && (arg === '--output' || arg === '--output-file')) {
+            const nextValue = argv[index + 1];
+            if (!nextValue) {
+                throw new Error(`Missing value for ${arg}.`);
+            }
+            outputPath = nextValue;
+            index += 1;
+            continue;
+        }
+        if (parsingOptions && (arg.startsWith('--output=') || arg.startsWith('--output-file='))) {
+            const value = arg.includes('=') ? arg.slice(arg.indexOf('=') + 1) : '';
+            if (!value) {
+                throw new Error(`Missing value for ${arg}.`);
+            }
+            outputPath = value;
+            continue;
+        }
+        if (parsingOptions && (arg === '--status-file')) {
+            const nextValue = argv[index + 1];
+            if (!nextValue) {
+                throw new Error(`Missing value for ${arg}.`);
+            }
+            statusPath = nextValue;
+            index += 1;
+            continue;
+        }
+        if (parsingOptions && arg.startsWith('--status-file=')) {
+            const value = arg.slice('--status-file='.length);
+            if (!value) {
+                throw new Error(`Missing value for ${arg}.`);
+            }
+            statusPath = value;
+            continue;
+        }
+        if (parsingOptions && arg === '--browser') {
+            const browserValue = argv[index + 1];
+            if (!browserValue) {
+                throw new Error('Missing value for --browser.');
+            }
+            if (browserValue !== 'app' && browserValue !== 'system') {
+                throw new Error(`Unsupported browser mode: ${browserValue}`);
+            }
+            browserMode = browserValue;
+            index += 1;
+            continue;
+        }
+        if (parsingOptions && arg.startsWith('-')) {
+            throw new Error(`Unknown option: ${arg}`);
+        }
+        if (targetArg === null) {
+            targetArg = arg;
+            continue;
+        }
+        throw new Error(`Unexpected argument: ${arg}`);
+    }
+    return {
+        targetArg,
+        browserMode,
+        cloudflareMode,
+        outputPath,
+        statusPath,
+        helpRequested: false,
+    };
+}
+function resolveStaticDir() {
+    const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        path.join(scriptDir, 'web'),
+        path.join(scriptDir, '..', 'dist', 'web'),
+        path.resolve(process.cwd(), 'dist', 'web'),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+async function writeLifecycleArtifact(filePath, value, label) {
+    if (!filePath) {
+        return;
+    }
+    try {
+        await writeJsonFile(filePath, value);
+    }
+    catch (error) {
+        console.error(`Failed to write ${label} at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function runReviewSession(parsedArgs, targetPath, mode, files, staticDir) {
+    const resolvedOutputPath = parsedArgs.outputPath ? path.resolve(process.cwd(), parsedArgs.outputPath) : null;
+    const resolvedStatusPath = parsedArgs.statusPath ? path.resolve(process.cwd(), parsedArgs.statusPath) : null;
+    const sessionId = randomUUID();
+    const startedAt = new Date().toISOString();
+    const runtime = await startReviewRuntime({
+        rootPath: targetPath,
+        mode,
+        files,
+        staticDir,
+    });
+    let browser = null;
+    let tunnel = null;
+    const shutdown = async () => {
+        await browser?.close();
+        await tunnel?.close();
+        await runtime.close();
+    };
+    const lifecycleContext = {
+        sessionId,
+        rootPath: targetPath,
+        mode,
+        browserMode: parsedArgs.browserMode,
+        cloudflareMode: parsedArgs.cloudflareMode,
+        reviewUrl: runtime.url,
+        publicUrl: null,
+        outputPath: resolvedOutputPath,
+        statusPath: resolvedStatusPath,
+        startedAt,
+    };
+    const handleSignal = async () => {
+        await shutdown();
+        process.exit(130);
+    };
+    const onSigint = () => {
+        void handleSignal();
+    };
+    const onSigterm = () => {
+        void handleSignal();
+    };
+    process.once('SIGINT', onSigint);
+    process.once('SIGTERM', onSigterm);
+    try {
+        if (resolvedOutputPath) {
+            console.error(`Writing final review JSON to: ${resolvedOutputPath}`);
+        }
+        if (resolvedStatusPath) {
+            console.error(`Writing lifecycle status to: ${resolvedStatusPath}`);
+        }
+        if (parsedArgs.cloudflareMode === 'required' && !hasCloudflaredExecutable()) {
+            throw new Error('Cloudflare tunnel was requested, but cloudflared is not installed. Install cloudflared or rerun with --no-cloudflare.');
+        }
+        if (parsedArgs.cloudflareMode !== 'off') {
+            tunnel = await launchCloudflaredTunnel(runtime.url);
+            if (parsedArgs.cloudflareMode === 'required' && !tunnel) {
+                throw new Error('Cloudflare tunnel was requested, but cloudflared could not start. Install cloudflared or rerun with --no-cloudflare.');
+            }
+        }
+        const launchUrl = tunnel?.publicUrl ?? runtime.url;
+        lifecycleContext.reviewUrl = launchUrl;
+        lifecycleContext.publicUrl = tunnel?.publicUrl ?? null;
+        if (tunnel) {
+            console.error(`Cloudflare tunnel active: ${tunnel.publicUrl}`);
+        }
+        else if (parsedArgs.cloudflareMode === 'off') {
+            console.error(`Cloudflare disabled; using local review URL: ${runtime.url}`);
+        }
+        else {
+            console.error(`Using local review URL: ${runtime.url}`);
+        }
+        browser =
+            parsedArgs.browserMode === 'system'
+                ? await launchBrowser(launchUrl, { executableCandidates: [] })
+                : await launchBrowser(launchUrl);
+        await writeLifecycleArtifact(resolvedStatusPath, buildRunningStatus(lifecycleContext), 'status file');
+        const result = await runtime.result;
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        await writeLifecycleArtifact(resolvedOutputPath, result, 'output file');
+        await writeLifecycleArtifact(resolvedStatusPath, buildCompletedStatus(lifecycleContext, result.submittedAt, result.annotations.length), 'status file');
+    }
+    catch (error) {
+        await writeLifecycleArtifact(resolvedStatusPath, buildFailedStatus(lifecycleContext, error instanceof Error ? error.message : String(error)), 'status file');
+        throw error;
+    }
+    finally {
+        process.off('SIGINT', onSigint);
+        process.off('SIGTERM', onSigterm);
+        await shutdown();
+    }
+}
+async function main() {
+    let parsedArgs;
+    try {
+        parsedArgs = parseCliArgs(process.argv.slice(2));
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        printUsage();
+        process.exit(1);
+    }
+    if (parsedArgs.helpRequested) {
+        printUsage();
+        process.exit(0);
+    }
+    if (!parsedArgs.targetArg) {
+        printUsage();
+        process.exit(1);
+    }
+    const targetPath = path.resolve(process.cwd(), parsedArgs.targetArg);
+    const targetStats = await stat(targetPath).catch(() => null);
+    if (!targetStats) {
+        throw new Error(`Target path does not exist: ${targetPath}`);
+    }
+    const mode = targetStats.isFile() ? 'file' : 'directory';
+    const files = await discoverMarkdownFiles(targetPath);
+    if (files.length === 0) {
+        throw new Error(`No markdown files found under: ${targetPath}`);
+    }
+    const staticDir = resolveStaticDir();
+    if (!staticDir) {
+        throw new Error('Build output not found. Run the package build before starting the CLI.');
+    }
+    await runReviewSession(parsedArgs, targetPath, mode, files, staticDir);
+}
+export function isDirectExecutionEntry(argv1, moduleUrl) {
+    if (!argv1) {
+        return false;
+    }
+    const entryPath = resolveRealpath(argv1);
+    const modulePath = resolveRealpath(fileURLToPath(moduleUrl));
+    return entryPath === modulePath;
+}
+const isDirectExecution = isDirectExecutionEntry(process.argv[1], import.meta.url);
+if (isDirectExecution) {
+    void main().catch(async (error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { buildReviewPrompt } from './lib/review.js';
+export { discoverMarkdownFiles } from './server/session.js';
+export type { ReviewPromptInput } from './lib/review.js';
+export type { MarkdownSource } from './server/session.js';
+export type { Annotation, MarkdownFile, ReviewSessionData, ReviewSubmissionPayload, ReviewSubmissionResult, SelectionInfo, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { buildReviewPrompt } from './lib/review.js';
+export { discoverMarkdownFiles } from './server/session.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/lib/lifecycle.d.ts

@@ -0,0 +1,18 @@
+import type { BrowserMode, CloudflareMode, ReviewLifecycleStatus } from '../types.js';
+export interface LifecycleContext {
+    sessionId: string;
+    rootPath: string;
+    mode: 'file' | 'directory';
+    browserMode: BrowserMode;
+    cloudflareMode: CloudflareMode;
+    reviewUrl: string;
+    publicUrl: string | null;
+    outputPath: string | null;
+    statusPath: string | null;
+    startedAt: string;
+}
+export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;
+export declare function buildRunningStatus(context: LifecycleContext): ReviewLifecycleStatus;
+export declare function buildCompletedStatus(context: LifecycleContext, submittedAt: string, annotationCount: number): ReviewLifecycleStatus;
+export declare function buildFailedStatus(context: LifecycleContext, error: string): ReviewLifecycleStatus;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lib/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/lib/lifecycle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,EAA6B,MAAM,aAAa,CAAC;AAEjH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF;AAkBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,qBAAqB,CAOnF;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,qBAAqB,CAUvB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,CASjG"}

package/dist/lib/lifecycle.js

@@ -0,0 +1,48 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+export async function writeJsonFile(filePath, value) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+function buildBaseStatus(context, updatedAt) {
+    return {
+        sessionId: context.sessionId,
+        rootPath: context.rootPath,
+        mode: context.mode,
+        browserMode: context.browserMode,
+        cloudflareMode: context.cloudflareMode,
+        reviewUrl: context.reviewUrl,
+        publicUrl: context.publicUrl,
+        outputPath: context.outputPath,
+        statusPath: context.statusPath,
+        startedAt: context.startedAt,
+        updatedAt,
+    };
+}
+export function buildRunningStatus(context) {
+    const updatedAt = new Date().toISOString();
+    return {
+        ...buildBaseStatus(context, updatedAt),
+        phase: 'running',
+    };
+}
+export function buildCompletedStatus(context, submittedAt, annotationCount) {
+    const completedAt = new Date().toISOString();
+    return {
+        ...buildBaseStatus(context, completedAt),
+        annotationCount,
+        completedAt,
+        phase: 'completed',
+        submittedAt,
+    };
+}
+export function buildFailedStatus(context, error) {
+    const completedAt = new Date().toISOString();
+    return {
+        ...buildBaseStatus(context, completedAt),
+        completedAt,
+        error,
+        phase: 'failed',
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lib/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/lib/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAiB7B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc;IAClE,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,eAAe,CAAC,OAAyB,EAAE,SAAiB;IACnE,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC1D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3C,OAAO;QACL,GAAG,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC;QACtC,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAyB,EACzB,WAAmB,EACnB,eAAuB;IAEvB,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,OAAO;QACL,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC;QACxC,eAAe;QACf,WAAW;QACX,KAAK,EAAE,WAAW;QAClB,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAyB,EAAE,KAAa;IACxE,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,OAAO;QACL,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC;QACxC,WAAW;QACX,KAAK;QACL,KAAK,EAAE,QAAQ;KAChB,CAAC;AACJ,CAAC"}

package/dist/lib/review.d.ts

@@ -0,0 +1,27 @@
+export interface ReviewPromptFile {
+    relativePath: string;
+    id?: string;
+    name?: string;
+    absolutePath?: string;
+    content?: string;
+    lineCount?: number;
+}
+export interface ReviewPromptAnnotation {
+    filePath: string;
+    annotationId?: string;
+    selection: {
+        startLine: number;
+        endLine: number;
+    };
+    selectedText: string;
+    note: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface ReviewPromptInput {
+    rootPath: string;
+    files: ReviewPromptFile[];
+    annotations: ReviewPromptAnnotation[];
+}
+export declare function buildReviewPrompt({ rootPath, files, annotations }: ReviewPromptInput): string;
+//# sourceMappingURL=review.d.ts.map

package/dist/lib/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/lib/review.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,WAAW,EAAE,sBAAsB,EAAE,CAAC;CACvC;AAiID,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,MAAM,CAsC7F"}