harnery 0.0.1 → 0.2.0

package/dist/commands/outline.js

@@ -0,0 +1,494 @@
+import { existsSync, readFileSync } from "node:fs";
+import { extname, resolve } from "node:path";
+import * as ts from "typescript";
+import { resolveBinName } from "../core/config.js";
+export function registerOutlineCommand(program, emit) {
+    program
+        .command("outline <file>")
+        .description(`Print the structural skeleton of a code file (imports + top-level decls + line numbers). Supports TS/JS/TSX/JSX (AST), PHP/Python (regex). Use \`${resolveBinName()} toc\` for markdown.`)
+        .option("--json", "Structured JSON envelope")
+        .option("--exports-only", "Only show exported symbols")
+        .option("--no-imports", "Skip the imports summary block")
+        .option("--no-members", "Don't expand class/interface members")
+        .action(async (file, opts) => {
+        try {
+            const result = await runOutline(file, opts);
+            if (opts.json) {
+                emit.config({ format: "json" });
+                emit.data(result);
+                return;
+            }
+            emit.text(`${renderOutline(result, opts)}\n`);
+        }
+        catch (err) {
+            emit.error({ code: "outline_failed", message: err.message });
+            process.exit(1);
+        }
+    });
+}
+async function runOutline(file, opts) {
+    const absPath = resolve(file);
+    if (!existsSync(absPath))
+        throw new Error(`no such file: ${file}`);
+    const content = readFileSync(absPath, "utf8");
+    const total_lines = content.split("\n").length;
+    const ext = extname(absPath).toLowerCase();
+    let language = "";
+    let parsed;
+    if ([".ts", ".tsx", ".js", ".jsx", ".mts", ".cts", ".mjs", ".cjs"].includes(ext)) {
+        language = ext.slice(1);
+        parsed = outlineTypeScript(content, absPath, ext);
+    }
+    else if (ext === ".php") {
+        language = "php";
+        parsed = outlinePhp(content);
+    }
+    else if (ext === ".py") {
+        language = "python";
+        parsed = outlinePython(content);
+    }
+    else if ([".md", ".mdx"].includes(ext)) {
+        throw new Error(`use \`${resolveBinName()} toc ${file}\` for markdown files`);
+    }
+    else {
+        throw new Error(`unsupported file type: ${ext || "(no extension)"} (supported: ts/tsx/js/jsx/php/py)`);
+    }
+    if (opts.exportsOnly) {
+        parsed.symbols = parsed.symbols.filter((s) => s.exported);
+    }
+    return {
+        file,
+        language,
+        total_lines,
+        imports: parsed.imports,
+        symbols: parsed.symbols,
+    };
+}
+function outlineTypeScript(content, path, ext) {
+    const isTsx = ext === ".tsx" || ext === ".jsx";
+    const scriptKind = isTsx ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    const source = ts.createSourceFile(path, content, ts.ScriptTarget.Latest, true, scriptKind);
+    const imports = [];
+    const symbols = [];
+    const lineOf = (node) => source.getLineAndCharacterOfPosition(node.getStart(source)).line + 1;
+    const text = (node) => content.slice(node.getStart(source), node.getEnd()).replace(/\s+/g, " ").trim();
+    const isExported = (node) => {
+        const mods = node.modifiers;
+        return mods?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+    };
+    for (const stmt of source.statements) {
+        if (ts.isImportDeclaration(stmt)) {
+            const moduleSpec = stmt.moduleSpecifier.text;
+            const clause = stmt.importClause;
+            const isTypeOnly = clause?.isTypeOnly ? "type " : "";
+            let what = "";
+            if (clause?.name)
+                what = clause.name.text;
+            if (clause?.namedBindings) {
+                if (ts.isNamespaceImport(clause.namedBindings)) {
+                    what = `${what ? `${what}, ` : ""}* as ${clause.namedBindings.name.text}`;
+                }
+                else {
+                    const names = clause.namedBindings.elements.map((e) => e.name.text).join(", ");
+                    what = `${what ? `${what}, ` : ""}{${names}}`;
+                }
+            }
+            imports.push(`${isTypeOnly}${what || "(side-effect)"} from "${moduleSpec}"`);
+            continue;
+        }
+        const exported = isExported(stmt);
+        if (ts.isFunctionDeclaration(stmt) && stmt.name) {
+            symbols.push({
+                kind: "function",
+                name: stmt.name.text,
+                signature: renderFnSig(stmt, content, source),
+                line: lineOf(stmt),
+                exported,
+            });
+        }
+        else if (ts.isClassDeclaration(stmt) && stmt.name) {
+            const heritage = (stmt.heritageClauses || [])
+                .map((h) => (h.token === ts.SyntaxKind.ExtendsKeyword ? "extends " : "implements ") +
+                h.types.map((t) => text(t.expression)).join(", "))
+                .join(" ");
+            const members = [];
+            for (const member of stmt.members) {
+                if (ts.isMethodDeclaration(member) && member.name) {
+                    members.push({
+                        kind: "method",
+                        name: member.name.text || text(member.name),
+                        signature: renderFnSig(member, content, source),
+                        line: lineOf(member),
+                    });
+                }
+                else if (ts.isConstructorDeclaration(member)) {
+                    members.push({
+                        kind: "method",
+                        name: "constructor",
+                        signature: renderFnSig(member, content, source),
+                        line: lineOf(member),
+                    });
+                }
+                else if (ts.isPropertyDeclaration(member) && member.name) {
+                    members.push({
+                        kind: "property",
+                        name: member.name.text || text(member.name),
+                        signature: member.type ? `: ${text(member.type)}` : "",
+                        line: lineOf(member),
+                    });
+                }
+            }
+            symbols.push({
+                kind: "class",
+                name: stmt.name.text,
+                signature: heritage,
+                line: lineOf(stmt),
+                exported,
+                members,
+            });
+        }
+        else if (ts.isInterfaceDeclaration(stmt)) {
+            const heritage = (stmt.heritageClauses || [])
+                .flatMap((h) => h.types.map((t) => text(t.expression)))
+                .join(", ");
+            const members = [];
+            for (const member of stmt.members) {
+                if (ts.isPropertySignature(member) && member.name) {
+                    members.push({
+                        kind: "property",
+                        name: member.name.text || text(member.name),
+                        signature: member.type ? `: ${text(member.type)}` : "",
+                        line: lineOf(member),
+                    });
+                }
+                else if (ts.isMethodSignature(member) && member.name) {
+                    members.push({
+                        kind: "method",
+                        name: member.name.text || text(member.name),
+                        signature: renderFnSig(member, content, source),
+                        line: lineOf(member),
+                    });
+                }
+            }
+            symbols.push({
+                kind: "interface",
+                name: stmt.name.text,
+                signature: heritage ? `extends ${heritage}` : "",
+                line: lineOf(stmt),
+                exported,
+                members,
+            });
+        }
+        else if (ts.isTypeAliasDeclaration(stmt)) {
+            const sigText = text(stmt.type);
+            symbols.push({
+                kind: "type",
+                name: stmt.name.text,
+                signature: `= ${sigText.slice(0, 80)}${sigText.length > 80 ? "…" : ""}`,
+                line: lineOf(stmt),
+                exported,
+            });
+        }
+        else if (ts.isEnumDeclaration(stmt)) {
+            symbols.push({
+                kind: "enum",
+                name: stmt.name.text,
+                line: lineOf(stmt),
+                exported,
+                members: stmt.members.map((m) => ({
+                    kind: "enumMember",
+                    name: m.name.text || text(m.name),
+                    line: lineOf(m),
+                })),
+            });
+        }
+        else if (ts.isVariableStatement(stmt)) {
+            const flags = stmt.declarationList.flags;
+            const isConst = (flags & ts.NodeFlags.Const) !== 0;
+            const isLet = (flags & ts.NodeFlags.Let) !== 0;
+            const kind = isConst ? "const" : isLet ? "let" : "var";
+            const stmtExported = isExported(stmt);
+            for (const decl of stmt.declarationList.declarations) {
+                if (!ts.isIdentifier(decl.name))
+                    continue;
+                let sig = "";
+                if (decl.type)
+                    sig = `: ${text(decl.type)}`;
+                else if (decl.initializer &&
+                    (ts.isArrowFunction(decl.initializer) || ts.isFunctionExpression(decl.initializer))) {
+                    sig = renderFnSig(decl.initializer, content, source);
+                }
+                symbols.push({
+                    kind,
+                    name: decl.name.text,
+                    signature: sig,
+                    line: lineOf(decl),
+                    exported: stmtExported,
+                });
+            }
+        }
+        else if (ts.isExportDeclaration(stmt)) {
+            if (stmt.exportClause && ts.isNamedExports(stmt.exportClause)) {
+                const names = stmt.exportClause.elements.map((e) => e.name.text).join(", ");
+                const fromText = stmt.moduleSpecifier
+                    ? ` from "${stmt.moduleSpecifier.text}"`
+                    : "";
+                symbols.push({
+                    kind: "re-export",
+                    name: `{${names}}${fromText}`,
+                    line: lineOf(stmt),
+                    exported: true,
+                });
+            }
+            else if (stmt.moduleSpecifier) {
+                symbols.push({
+                    kind: "re-export",
+                    name: `* from "${stmt.moduleSpecifier.text}"`,
+                    line: lineOf(stmt),
+                    exported: true,
+                });
+            }
+        }
+        else if (ts.isModuleDeclaration(stmt) && stmt.name) {
+            symbols.push({
+                kind: "namespace",
+                name: stmt.name.text || text(stmt.name),
+                line: lineOf(stmt),
+                exported,
+            });
+        }
+    }
+    return { imports, symbols };
+}
+function renderFnSig(fn, content, source) {
+    const params = (fn.parameters || [])
+        .map((p) => {
+        const name = ts.isIdentifier(p.name)
+            ? p.name.text
+            : content.slice(p.name.getStart(source), p.name.getEnd());
+        const type = p.type
+            ? content.slice(p.type.getStart(source), p.type.getEnd()).replace(/\s+/g, " ").trim()
+            : "";
+        const optional = p.questionToken ? "?" : "";
+        return type ? `${name}${optional}: ${type}` : `${name}${optional}`;
+    })
+        .join(", ");
+    const ret = fn.type
+        ? `: ${content.slice(fn.type.getStart(source), fn.type.getEnd()).replace(/\s+/g, " ").trim()}`
+        : "";
+    return `(${params})${ret}`;
+}
+function outlinePhp(content) {
+    const lines = content.split("\n");
+    const imports = [];
+    const symbols = [];
+    let currentContainer = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        const trimmed = line.trim();
+        const isIndented = /^[ \t]/.test(line);
+        if (trimmed === "" ||
+            trimmed.startsWith("//") ||
+            trimmed.startsWith("#") ||
+            trimmed.startsWith("*") ||
+            trimmed.startsWith("/*"))
+            continue;
+        const nsMatch = trimmed.match(/^namespace\s+([\w\\]+)\s*;/);
+        if (nsMatch && !isIndented) {
+            symbols.push({ kind: "namespace", name: nsMatch[1], line: lineNum });
+            continue;
+        }
+        const useMatch = trimmed.match(/^use\s+([\w\\]+)(?:\s+as\s+(\w+))?\s*;/);
+        if (useMatch && !isIndented) {
+            imports.push(useMatch[2] ? `${useMatch[1]} as ${useMatch[2]}` : useMatch[1]);
+            continue;
+        }
+        if (!isIndented) {
+            const classMatch = trimmed.match(/^(?:abstract\s+|final\s+)?class\s+(\w+)(?:\s+extends\s+(\w+))?(?:\s+implements\s+([\w,\s]+))?/);
+            if (classMatch) {
+                currentContainer = {
+                    kind: "class",
+                    name: classMatch[1],
+                    signature: [
+                        classMatch[2] ? `extends ${classMatch[2]}` : "",
+                        classMatch[3] ? `implements ${classMatch[3].trim()}` : "",
+                    ]
+                        .filter(Boolean)
+                        .join(" "),
+                    line: lineNum,
+                    members: [],
+                };
+                symbols.push(currentContainer);
+                continue;
+            }
+            const interfaceMatch = trimmed.match(/^interface\s+(\w+)/);
+            if (interfaceMatch) {
+                currentContainer = {
+                    kind: "interface",
+                    name: interfaceMatch[1],
+                    line: lineNum,
+                    members: [],
+                };
+                symbols.push(currentContainer);
+                continue;
+            }
+            const traitMatch = trimmed.match(/^trait\s+(\w+)/);
+            if (traitMatch) {
+                currentContainer = { kind: "trait", name: traitMatch[1], line: lineNum, members: [] };
+                symbols.push(currentContainer);
+                continue;
+            }
+        }
+        const fnMatch = trimmed.match(/^(?:public\s+|private\s+|protected\s+)?(?:static\s+)?function\s+(\w+)\s*\(([^)]*)\)/);
+        if (fnMatch) {
+            const entry = {
+                kind: isIndented && currentContainer ? "method" : "function",
+                name: fnMatch[1],
+                signature: `(${fnMatch[2].trim()})`,
+                line: lineNum,
+            };
+            if (isIndented && currentContainer) {
+                currentContainer.members.push(entry);
+            }
+            else {
+                symbols.push(entry);
+            }
+        }
+    }
+    return { imports, symbols };
+}
+function outlinePython(content) {
+    const lines = content.split("\n");
+    const imports = [];
+    const symbols = [];
+    let currentClass = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        const trimmed = line.trim();
+        const indent = line.match(/^ */)[0].length;
+        if (trimmed === "" || trimmed.startsWith("#"))
+            continue;
+        const importMatch = trimmed.match(/^import\s+(.+)$/);
+        const fromMatch = trimmed.match(/^from\s+(\S+)\s+import\s+(.+)$/);
+        if (importMatch && indent === 0) {
+            imports.push(importMatch[1]);
+            continue;
+        }
+        if (fromMatch && indent === 0) {
+            imports.push(`${fromMatch[2].trim()} from ${fromMatch[1]}`);
+            continue;
+        }
+        const classMatch = trimmed.match(/^class\s+(\w+)(?:\(([^)]*)\))?:/);
+        if (classMatch && indent === 0) {
+            currentClass = {
+                kind: "class",
+                name: classMatch[1],
+                signature: classMatch[2] ? `(${classMatch[2]})` : "",
+                line: lineNum,
+                members: [],
+            };
+            symbols.push(currentClass);
+            continue;
+        }
+        const methodMatch = trimmed.match(/^(?:async\s+)?def\s+(\w+)\s*\(([^)]*)\)/);
+        if (methodMatch) {
+            if (indent === 0) {
+                symbols.push({
+                    kind: "function",
+                    name: methodMatch[1],
+                    signature: `(${methodMatch[2].trim()})`,
+                    line: lineNum,
+                });
+                currentClass = null;
+            }
+            else if (currentClass) {
+                currentClass.members.push({
+                    kind: "method",
+                    name: methodMatch[1],
+                    signature: `(${methodMatch[2].trim()})`,
+                    line: lineNum,
+                });
+            }
+            continue;
+        }
+        if (indent === 0 && trimmed.length > 0 && currentClass) {
+            currentClass = null;
+        }
+    }
+    return { imports, symbols };
+}
+function renderOutline(r, opts) {
+    const lines = [];
+    const symbolCount = r.symbols.length;
+    lines.push(`outline · ${r.file} (${r.language}, ${r.total_lines} lines, ${symbolCount} top-level symbol${symbolCount === 1 ? "" : "s"})`);
+    if (opts.imports !== false && r.imports.length > 0) {
+        lines.push("");
+        if (r.imports.length <= 4) {
+            lines.push(`imports: ${r.imports.join(" · ")}`);
+        }
+        else {
+            lines.push(`imports (${r.imports.length}):`);
+            for (const imp of r.imports)
+                lines.push(`  ${imp}`);
+        }
+    }
+    if (r.symbols.length > 0) {
+        lines.push("");
+        for (const sym of r.symbols) {
+            lines.push(renderSymbol(sym, 0, opts));
+        }
+    }
+    else {
+        lines.push("");
+        lines.push("(no top-level symbols)");
+    }
+    return lines.join("\n");
+}
+function renderSymbol(s, depth, opts) {
+    const indent = "  ".repeat(depth);
+    const lineMark = `L${s.line}`.padEnd(6);
+    const exp = s.exported ? "★ " : "  ";
+    const kindAbbr = kindToAbbr(s.kind);
+    const sig = s.signature ? ` ${s.signature}` : "";
+    const head = `${indent}${exp}${lineMark} ${kindAbbr} ${s.name}${sig}`;
+    if (opts.members !== false && s.members && s.members.length > 0) {
+        return [head, ...s.members.map((m) => renderSymbol(m, depth + 1, opts))].join("\n");
+    }
+    return head;
+}
+function kindToAbbr(kind) {
+    switch (kind) {
+        case "function":
+            return "fn  ";
+        case "class":
+            return "cl  ";
+        case "interface":
+            return "if  ";
+        case "type":
+            return "ty  ";
+        case "const":
+            return "ct  ";
+        case "let":
+            return "let ";
+        case "var":
+            return "var ";
+        case "enum":
+            return "en  ";
+        case "enumMember":
+            return "em  ";
+        case "method":
+            return "mt  ";
+        case "property":
+            return "pr  ";
+        case "namespace":
+            return "ns  ";
+        case "trait":
+            return "tr  ";
+        case "re-export":
+            return "rx  ";
+        default:
+            return kind.slice(0, 4).padEnd(4);
+    }
+}

package/dist/commands/presence.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+/**
+ * `presence`: mobile/office state for agents (~/.claude/presence).
+ *
+ * Uses the injected EmitContext so composed and standalone consumers share
+ * one code path. The state file path is Claude-Code-specific (lives under
+ * ~/.claude/) but the detect/set/clear logic is generic: any agent harness
+ * can adopt the same convention.
+ */
+export declare function registerPresenceCommand(program: Command, emit: EmitContext): void;
+//# sourceMappingURL=presence.d.ts.map

package/dist/commands/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/commands/presence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkBnD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAoFjF"}

package/dist/commands/presence.js

@@ -0,0 +1,123 @@
+import { emitCanonical, normalizeHarness, readHeartbeat, resolveOwner, } from "../core/agents/index.js";
+import { ageSeconds, applyDetection, clearPresence, formatAge, presenceFilePath, readPresence, writePresence, } from "../lib/presence.js";
+/**
+ * `presence`: mobile/office state for agents (~/.claude/presence).
+ *
+ * Uses the injected EmitContext so composed and standalone consumers share
+ * one code path. The state file path is Claude-Code-specific (lives under
+ * ~/.claude/) but the detect/set/clear logic is generic: any agent harness
+ * can adopt the same convention.
+ */
+export function registerPresenceCommand(program, emit) {
+    const cmd = program
+        .command("presence")
+        .description("Mobile/office state for agents (~/.claude/presence)")
+        .action(() => {
+        printStatus(emit);
+    });
+    cmd
+        .command("get")
+        .description('Print just the state ("mobile" / "office"), or full record with --json')
+        .option("--json", "Print the full record as JSON")
+        .action((opts) => {
+        const r = readPresence();
+        if (opts.json) {
+            emit.config({ format: "json" });
+            emit.data({
+                state: r.state,
+                updated_at: r.updated_at,
+                source: r.source,
+                is_default: r.is_default,
+                path: presenceFilePath(),
+            });
+            return;
+        }
+        emit.text(`${r.state}\n`);
+    });
+    cmd
+        .command("set")
+        .argument("<state>", "mobile | office")
+        .description("Set state explicitly (source=cli). Hook auto-detection can still overwrite.")
+        .action((state) => {
+        if (state !== "mobile" && state !== "office") {
+            emit.error({
+                code: "invalid_state",
+                message: `state must be "mobile" or "office" (got: ${JSON.stringify(state)})`,
+            });
+            process.exit(2);
+        }
+        const before = readPresence();
+        writePresence(state, "cli");
+        emitPresenceChange(before.state, state, "cli");
+        printStatus(emit);
+    });
+    cmd
+        .command("clear")
+        .description('Delete the state file (next read returns the default, "office")')
+        .action(() => {
+        const removed = clearPresence();
+        emit.data({
+            ok: true,
+            removed,
+            path: presenceFilePath(),
+        });
+    });
+    cmd
+        .command("detect")
+        .description("Internal: read prompt text from stdin, apply detection rules, update state if signal is clear")
+        .option("--from-stdin", "Read prompt from stdin (the only supported input mode today)")
+        .option("--verbose", "Print the detection result to stderr")
+        .action(async (opts) => {
+        const prompt = await readStdin();
+        if (!prompt) {
+            if (opts.verbose)
+                emit.log("(no input on stdin; skipping)", "info");
+            return;
+        }
+        const result = applyDetection(prompt);
+        if (opts.verbose) {
+            emit.log(JSON.stringify({
+                detected: result.detected,
+                before: result.before,
+                after: result.after,
+                changed: result.changed,
+            }), "info");
+        }
+    });
+}
+function printStatus(emit) {
+    const r = readPresence();
+    emit.data({
+        state: r.state,
+        updated_at: r.updated_at,
+        source: r.source,
+        is_default: r.is_default,
+        age_seconds: r.is_default ? null : ageSeconds(r.updated_at),
+        age_human: r.is_default ? "(default: file missing)" : formatAge(ageSeconds(r.updated_at)),
+        path: presenceFilePath(),
+    });
+}
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return "";
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function emitPresenceChange(from, to, source) {
+    if (from === to)
+        return;
+    const owner = resolveOwner();
+    if (!owner)
+        return;
+    const hb = readHeartbeat(owner);
+    emitCanonical({
+        type: "state.presence_change",
+        owner,
+        session: hb?.session_id ?? owner,
+        harness: normalizeHarness(hb?.platform),
+        data: { from, to, source },
+    });
+}

package/dist/commands/read.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+import type { EmitContext } from "../commander.js";
+/**
+ * `harn read`: extract clean readable markdown from HTML.
+ */
+export declare function registerReadCommand(program: Command, emitParam: EmitContext): void;
+//# sourceMappingURL=read.d.ts.map

package/dist/commands/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/commands/read.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQnD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CAwBlF"}

package/dist/commands/read.js

@@ -0,0 +1,46 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { resolveBinName } from "../core/config.js";
+import { htmlToMarkdown } from "../lib/readability/index.js";
+// Module-scoped emit assigned by registerReadCommand. Same pattern as cookies.ts:
+// the runRead helper closes over this so the .action callback stays concise.
+let emit;
+/**
+ * `harn read`: extract clean readable markdown from HTML.
+ */
+export function registerReadCommand(program, emitParam) {
+    emit = emitParam;
+    program
+        .command("read [html-file]")
+        .description(`Extract clean readable markdown from HTML. Reads from file or stdin (use '-'). Pair with \`${resolveBinName()} fetch\` or \`${resolveBinName()} browse\` for scrape-to-markdown.`)
+        .option("-o, --output <file>", "Write markdown to file instead of stdout")
+        .option("--url <url>", "Base URL: used to resolve relative links")
+        .option("--selector <css>", "Use this CSS selector instead of Readability (fallback when extraction misses content)")
+        .option("--raw", "Output cleaned HTML instead of markdown (debugging)")
+        .option("--max-chars <n>", "Truncate output to N characters (0 = disable)", "100000")
+        .action((htmlFile, opts) => {
+        try {
+            runRead(htmlFile, opts);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            emit.error({ code: "read_error", message: msg });
+            process.exit(1);
+        }
+    });
+}
+function runRead(htmlFile, opts) {
+    const input = htmlFile && htmlFile !== "-" ? readFileSync(htmlFile, "utf-8") : readFileSync(0, "utf-8");
+    const result = htmlToMarkdown(input, {
+        url: opts.url,
+        selector: opts.selector,
+        raw: opts.raw,
+        maxChars: Number.parseInt(opts.maxChars, 10),
+    });
+    if (opts.output) {
+        writeFileSync(opts.output, result.output);
+        emit.file(opts.output, { chars: result.output.length });
+    }
+    else {
+        emit.text(result.output);
+    }
+}