instagui 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omar
+
+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,144 @@
+# instagui
+
+**Any CLI. Instant GUI. One command.**
+
+Turn any command-line tool into a clean local web form — no config, no code changes to the tool.
+
+<!-- TODO(pre-launch): record and drop the money-demo GIF here.
+     ~10s: `npx instagui ffmpeg` → browser opens → fill a couple fields → Run → output streams.
+     Save as docs/demo.gif and it renders below. -->
+![instagui demo — npx instagui ffmpeg opens a web form, click Run, output streams](docs/demo.gif)
+
+```sh
+npx instagui ffmpeg
+```
+
+That's it. instagui reads the tool's `--help`, turns it into a web form, opens your browser, and
+(when you click **Run**) executes the command locally and streams the output back — while always
+showing you the exact command it will run, so it teaches you the CLI instead of hiding it.
+
+---
+
+## Why
+
+Thousands of powerful CLIs (ffmpeg, pandoc, yt-dlp, curl, imagemagick…) are unfriendly to anyone
+who doesn't live in a terminal — and even experts re-read man pages to recall flag syntax. Tools
+like Gooey require the tool's *author* to change their code. instagui needs nothing from the tool: it
+parses the tool's own `--help` text with AI into a structured schema and renders that as a form.
+
+## Quick start
+
+The three demo tools ship with **bundled schemas**, so they work instantly with **no API key**:
+
+```sh
+npx instagui ffmpeg      # video/audio transcoding
+npx instagui yt-dlp      # download media
+npx instagui pandoc      # convert documents
+```
+
+For any *other* tool, instagui extracts the schema on first run using the Claude API (see
+[How it stays free](#how-it-stays-free)):
+
+```sh
+export ANTHROPIC_API_KEY=sk-ant-...    # POSIX
+$env:ANTHROPIC_API_KEY="sk-ant-..."    # Windows / PowerShell
+npx instagui curl
+```
+
+Get a key at <https://console.anthropic.com>. The first extraction is cached, so every launch
+after that is instant and free.
+
+## How it works
+
+1. **Capture** — run `<tool> --help` (falling back to `-h`, `help`, then the man page), reading
+   both stdout and stderr, under a timeout and size cap so a misbehaving tool can't hang the launch.
+2. **Extract** — send the help text to the Claude API (`claude-haiku-4-5`) and get back a validated
+   JSON schema of the tool's options (name, flag, type, description, enum values, required, grouping)
+   plus positional arguments. Invalid output is retried once, then fails clearly.
+3. **Serve** — render the schema as a single-page form on `http://127.0.0.1`, grouped, with the
+   right control per type (checkbox / dropdown / number / text).
+4. **Preview** — show the exact command as you edit the form, one-click copyable.
+5. **Run** — execute the command with `spawn` (arguments array, never a shell string) and stream
+   stdout/stderr live into the page until it exits.
+
+## How it stays free
+
+instagui resolves a schema in this order, and only the last step costs an API call:
+
+| Precedence | Source | Needs a key? |
+| --- | --- | --- |
+| 1 | `--schema <file>` override you supply | no |
+| 2 | Your cache in `~/.instagui/` (written on first extraction) | no |
+| 3 | Bundled schemas shipped with the package (ffmpeg, yt-dlp, pandoc) | no |
+| 4 | Fresh extraction via the Claude API | **yes** |
+
+So the demo tools are free forever, any tool you've used once is free forever after, and you only
+need a key the first time you point instagui at a brand-new tool. A friendly message tells you exactly
+what to do if a key is needed and missing — you're never dropped into a stack trace.
+
+- `--refresh` re-extracts and overwrites your cache entry.
+- `--schema ./mytool.json` uses a hand-tuned schema and skips capture **and** the AI entirely.
+
+## Usage
+
+```
+instagui <tool>                 resolve <tool>'s Schema and serve the Form (auto-opens the browser)
+instagui <tool> --print         resolve and print the Schema JSON instead of serving
+instagui <tool> --schema <path> use a hand-supplied Schema file (no capture, no AI)
+instagui <tool> --refresh       ignore cache + bundled and re-extract fresh
+instagui <tool> --help-file <p> extract from a captured help-text file
+<tool> --help | instagui <tool> or pipe help text on stdin
+
+  --port <n>     preferred port for the Form server (default 5177; falls back if busy)
+  --no-open      do not auto-open the browser (still prints the URL)
+  --model <id>   extraction model (default: claude-haiku-4-5)
+  -v, --version  print the instagui version
+  -h, --help     show help
+```
+
+## Security / threat model
+
+instagui is a **local, single-user tool**. Be clear-eyed about what it does:
+
+- **It runs commands you compose.** The whole point is to execute a real CLI with the arguments you
+  set in the form. Treat the form like your own terminal — don't run something you wouldn't type.
+- **The exact command is always shown before you Run it.** No hidden arguments; preview is generated
+  from the *same* argument array that Run executes, so what you see is what runs.
+- **Arguments are passed as an array to `spawn`, never concatenated into a shell.** A value
+  containing spaces, quotes, `;`, or `&&` is passed verbatim as a single argument — there is no
+  shell to interpret it, so form input can't inject extra commands.
+- **The server binds `127.0.0.1` only.** It is not reachable from your network.
+- **State-changing requests fail closed.** `POST /run` and `POST /stop` require a matching `Origin`
+  header; a missing or foreign origin is rejected (CSRF protection). Exactly one run at a time, and
+  closing the tab (dropping the stream) kills the child process — no orphans.
+- **Your API key is never logged, echoed, or embedded in any served page.** The only data that
+  leaves your machine is the tool's help text, sent to the Claude API for extraction. No telemetry.
+
+## Contribute a schema
+
+Want a tool to work keyless for everyone, like the demo tools do? Bundled schemas live in
+[`schemas/`](schemas/) and are generated from captured `--help` fixtures:
+
+1. Capture the tool's help into `test/fixtures/<tool>-help.txt`.
+2. Add the tool to `scripts/gen-bundled-schemas.ts`.
+3. Regenerate with your key: `ANTHROPIC_API_KEY=sk-ant-... npx tsx scripts/gen-bundled-schemas.ts`
+   (a hallucination guard + golden check run before anything is written).
+4. Open a PR with the fixture and the generated `schemas/<tool>.json`.
+
+Each generated schema is validated so every flag appears verbatim in the source help text — no
+hallucinated options. See [`schemas/README.md`](schemas/README.md) for provenance details.
+
+## Requirements
+
+- **Node.js ≥ 22**
+- An `ANTHROPIC_API_KEY` only for extracting a tool that isn't bundled or cached.
+
+## Non-goals (v0.1)
+
+Deliberately out of scope to keep it small and sharp: interactive/TUI programs (vim, top, REPLs);
+subcommand trees (flat tools only — `git commit` vs `git push` is v0.2); native file-picker dialogs;
+a hosted version, auth, telemetry, or a plugin system; a local-LLM option (contributions welcome).
+
+## License
+
+MIT © Omar

package/dist/cli/index.js

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+// cli/index.ts — `instagui <tool>` resolves a validated Schema and serves it as a local web Form
+// (Epic 3). `--print` keeps the Epic 1/2 behaviour of emitting the Schema JSON and exiting.
+//
+// Resolution precedence (Epic 2): --schema override > user cache (~/.instagui) > bundled
+// schemas > fresh extraction. Only the extraction tier captures help or calls the AI, and
+// only it needs an API key — so the demo tools, a cache hit, or --schema never prompt for
+// one. A fresh extraction is written back to the user cache so the next run is free.
+//
+// Within extraction, help source precedence is --help-file > piped stdin > live capture.
+// Maps core errors to the exit-code contract (0 ok · 2 known precondition · 1 unexpected).
+import { readFileSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { extractSchema } from '../core/extract.js';
+import { captureHelp } from '../core/capture.js';
+import { resolveSchema } from '../core/resolve.js';
+import { readCache, writeCache } from '../core/cache.js';
+import { readBundled } from '../core/bundled.js';
+import { loadOverrideSchema } from '../core/override.js';
+import { apiKeyOnboardingError } from '../core/onboarding.js';
+import { PreconditionError } from '../core/errors.js';
+import { hasApiKey } from '../shared/config.js';
+import { activeEngineName, ENGINE_ENV } from '../shared/engine.js';
+import { startServer } from '../server/server.js';
+import { openBrowser } from '../server/browser.js';
+const usingClaudeCode = process.env[ENGINE_ENV] === 'claude-code';
+/** Our own version, read from the shipped package.json (works from both dist/ and src/ — the
+ *  relative path to the package root is the same). We parse everyone else's help text; our own
+ *  --version and --help should be exemplary. */
+function readVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+const USAGE = `instagui <tool> — turn a CLI tool into a local web Form. Resolves a validated option
+Schema, serves it as a single-page Form, and (on Run) executes the command and streams output.
+
+Usage:
+  instagui <tool>                        resolve <tool>'s Schema and serve the Form (auto-opens browser)
+  instagui <tool> --print                resolve and print the Schema JSON instead of serving
+  instagui <tool> --schema <path>        use a hand-supplied Schema file (no capture, no AI)
+  instagui <tool> --refresh              ignore cache + bundled and re-extract fresh
+  instagui <tool> --help-file <path>     extract from a captured help-text file
+  <tool> --help | instagui <tool>        or pipe help text on stdin
+
+Resolution precedence: --schema > user cache (~/.instagui) > bundled schemas > fresh extraction.
+The demo tools (ffmpeg, yt-dlp, pandoc) ship bundled Schemas, so they work with no API key.
+
+Options:
+  --print              print the resolved Schema JSON to stdout and exit (no server)
+  --port <n>           preferred port for the Form server (default 5177; falls back if busy)
+  --no-open            do not auto-open the browser (still prints the URL)
+  --schema <path>      use this Schema file directly (top precedence)
+  --refresh            bypass cache + bundled and re-extract, overwriting the cache
+  --help-file <path>   read help text from a file instead of capturing (extraction only)
+  --capture            force live capture (ignore piped stdin)
+  --model <id>         extraction model (default: claude-haiku-4-5)
+  -v, --version        print the instagui version and exit
+  -h, --help           show this message
+
+Examples:
+  instagui ffmpeg                        open a Form for ffmpeg (bundled — no key needed)
+  instagui yt-dlp --no-open              serve without launching a browser; print the URL
+  instagui mytool --print                just resolve and print the Schema as JSON
+  instagui mytool --schema ./mytool.json use a hand-tuned Schema, skip capture + AI
+
+The server binds 127.0.0.1 only. Extraction needs ANTHROPIC_API_KEY (https://console.anthropic.com).
+Exit codes: 0 ok · 2 known failure · 1 unexpected.`;
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return '';
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString('utf8');
+}
+/** Resolve help text by precedence: --help-file > piped stdin > live capture.
+ *  `--capture` forces live capture past the stdin heuristic. */
+async function resolveHelpText(tool, helpFile, forceCapture) {
+    if (helpFile) {
+        return { helpText: readFileSync(helpFile, 'utf8'), source: `file:${helpFile}` };
+    }
+    if (!forceCapture && !process.stdin.isTTY) {
+        return { helpText: await readStdin(), source: 'stdin' };
+    }
+    const { helpText, method } = await captureHelp(tool);
+    return { helpText, source: `capture:${method}` };
+}
+async function main() {
+    const { values, positionals } = parseArgs({
+        allowPositionals: true,
+        options: {
+            schema: { type: 'string' },
+            refresh: { type: 'boolean' },
+            'help-file': { type: 'string' },
+            capture: { type: 'boolean' },
+            model: { type: 'string' },
+            print: { type: 'boolean' },
+            port: { type: 'string' },
+            'no-open': { type: 'boolean' },
+            version: { type: 'boolean', short: 'v' },
+            help: { type: 'boolean', short: 'h' },
+        },
+    });
+    if (values.version) {
+        console.log(readVersion());
+        return 0;
+    }
+    if (values.help || positionals.length === 0) {
+        console.log(USAGE);
+        return values.help ? 0 : 2;
+    }
+    const tool = positionals[0];
+    // The extraction tier: capture help, require a key (unless the dev engine is active), and
+    // run the AI. Only reached when override/cache/bundled all miss (or --refresh is set), so
+    // the key requirement surfaces exactly when it is genuinely needed.
+    const extract = async () => {
+        const { helpText, source } = await resolveHelpText(tool, values['help-file'], values.capture ?? false);
+        console.error(`instagui: help from ${source}`);
+        // captureHelp throws on empty/no-help; only file/stdin can reach here empty.
+        if (helpText.trim().length === 0) {
+            throw new PreconditionError(`No help text provided for "${tool}" (${source}). Pass --help-file <path> or pipe the tool's help output on stdin.`);
+        }
+        if (!usingClaudeCode && !hasApiKey())
+            throw apiKeyOnboardingError();
+        if (usingClaudeCode)
+            console.error(`instagui: using ${activeEngineName()} extraction engine`);
+        const { schema } = await extractSchema(helpText, tool, { model: values.model });
+        return schema;
+    };
+    const result = await resolveSchema({ tool, schemaFile: values.schema, refresh: values.refresh ?? false }, {
+        loadOverride: loadOverrideSchema,
+        readCache: (t) => readCache(t),
+        readBundled: (t) => readBundled(t),
+        extract,
+        writeCache: (t, s) => writeCache(t, s),
+    });
+    console.error(`instagui: schema from ${result.source}`);
+    if (result.cachedTo)
+        console.error(`instagui: cached to ${result.cachedTo}`);
+    // --print keeps the Epic 1/2 behaviour: emit the Schema JSON and exit (no server).
+    if (values.print) {
+        console.log(JSON.stringify(result.schema, null, 2));
+        return 0;
+    }
+    // Default (Epic 3): serve the Schema as a Form and hold the process open until Ctrl-C.
+    let port;
+    if (values.port !== undefined) {
+        port = Number(values.port);
+        if (!Number.isInteger(port) || port < 0 || port > 65535) {
+            throw new PreconditionError(`Invalid --port "${values.port}": expected an integer 0–65535.`);
+        }
+    }
+    const server = await startServer({ schema: result.schema, port });
+    console.error(`instagui: serving ${tool} form at ${server.url}`);
+    console.log(server.url); // the URL on stdout so it's scriptable / copyable
+    if (!values['no-open'])
+        openBrowser(server.url);
+    console.error('instagui: press Ctrl-C to stop.');
+    // Hold the process open; shut the server down cleanly on Ctrl-C.
+    await new Promise((resolve) => {
+        const shutdown = () => {
+            console.error('\ninstagui: shutting down.');
+            server.close().finally(resolve);
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    });
+    return 0;
+}
+main()
+    .then((code) => process.exit(code))
+    .catch((err) => {
+    if (err instanceof PreconditionError) {
+        console.error(`instagui: ${err.message}`);
+        process.exit(err.exitCode);
+    }
+    // Unexpected: stack to stderr only, exit 1.
+    console.error('instagui: unexpected error');
+    console.error(err instanceof Error ? err.stack : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/bundled.js

@@ -0,0 +1,29 @@
+// Story 2.3 — bundled demo schemas. The published package ships a read-only `schemas/`
+// dir so the demo tools (ffmpeg, yt-dlp, pandoc, …) work with NO API key and NO capture:
+// the `npx instagui ffmpeg` magic isn't gated behind getting a key.
+//
+// This tier is READ-ONLY. It sits below the user cache in precedence (cache wins), and a
+// fresh extraction is never written here — it goes to ~/.instagui (see core/cache.ts). So a
+// user who re-extracts a bundled tool gets their own entry going forward while the shipped
+// fallback stays pristine.
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readSchemaFile } from './schema-file.js';
+import { toolKey } from './cache.js';
+/** The packaged schemas/ directory, resolved relative to this module so it works both from
+ *  source (src/core/ → ../../schemas) and from the published tarball (dist/core/ →
+ *  ../../schemas). Injectable in tests. */
+export function bundledDir() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.join(here, '..', '..', 'schemas');
+}
+/**
+ * Load the bundled Schema for `tool`, or null if the tool isn't bundled or the shipped file
+ * is somehow unreadable/invalid (fall through to extraction — never crash a launch). Uses
+ * the same tool-name keying as the user cache so a bundled file matches a cache lookup.
+ */
+export function readBundled(tool, dir = bundledDir()) {
+    const result = readSchemaFile(path.join(dir, `${toolKey(tool)}.json`));
+    return result.ok ? result.schema : null;
+}
+//# sourceMappingURL=bundled.js.map

package/dist/core/bundled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled.js","sourceRoot":"","sources":["../../src/core/bundled.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,yFAAyF;AACzF,oEAAoE;AACpE,EAAE;AACF,yFAAyF;AACzF,4FAA4F;AAC5F,2FAA2F;AAC3F,2BAA2B;AAC3B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC;;2CAE2C;AAC3C,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAc,UAAU,EAAE;IAClE,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC"}

package/dist/core/cache.js

@@ -0,0 +1,41 @@
+// Story 2.1 — the user schema cache in ~/.instagui. A successful extraction is written here,
+// keyed by tool name, so repeat launches load instantly with zero capture and zero API
+// call. This is the WRITE target of the resolution chain; the packaged schemas/ dir
+// (Story 2.3) is a read-only fallback and is never written here.
+//
+// A corrupt or stale cache file must never crash a launch: readCache returns null on any
+// unreadable/invalid file so the resolver falls through to bundled/extraction.
+import { mkdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { instaguiDir } from '../shared/config.js';
+import { readSchemaFile } from './schema-file.js';
+/** Reduce a tool name to a filesystem-safe cache key. Keeps word chars, dot and dash
+ *  (covers "ffmpeg", "yt-dlp", "pandoc"); collapses anything else (path separators, etc.)
+ *  to "_" so a tool name can never escape the cache dir. */
+export function toolKey(tool) {
+    return tool.replace(/[^\w.-]/g, '_');
+}
+/** Absolute path of the cache entry for `tool`. `dir` is injectable for tests. */
+export function cachePath(tool, dir = instaguiDir()) {
+    return path.join(dir, `${toolKey(tool)}.json`);
+}
+/**
+ * Load a cached Schema for `tool`, or null if there is no usable cache entry (absent,
+ * unreadable, non-JSON, or failing Schema.parse). Null means "cache miss" — the caller
+ * falls through to the next resolution tier rather than crashing.
+ */
+export function readCache(tool, dir = instaguiDir()) {
+    const result = readSchemaFile(cachePath(tool, dir));
+    return result.ok ? result.schema : null;
+}
+/**
+ * Persist a validated Schema to the user cache, creating ~/.instagui if needed. Returns the
+ * path written. Overwrites any existing entry (this is how --refresh re-caches).
+ */
+export function writeCache(tool, schema, dir = instaguiDir()) {
+    mkdirSync(dir, { recursive: true });
+    const file = cachePath(tool, dir);
+    writeFileSync(file, `${JSON.stringify(schema, null, 2)}\n`, 'utf8');
+    return file;
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/core/cache.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,uFAAuF;AACvF,oFAAoF;AACpF,iEAAiE;AACjE,EAAE;AACF,yFAAyF;AACzF,+EAA+E;AAC/E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;4DAE4D;AAC5D,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc,WAAW,EAAE;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc,WAAW,EAAE;IACjE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,MAAc,EAAE,MAAc,WAAW,EAAE;IAClF,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/capture.js

@@ -0,0 +1,161 @@
+// core/capture.ts — Story 1.2. Capture a tool's help text via the fallback chain
+// (--help → -h → help → man), reading BOTH stdout and stderr, under a timeout and an
+// output-size cap so a misbehaving tool can't hang the launch. Output feeds the existing
+// extractor unchanged.
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { ToolNotFoundError, NoHelpError } from './errors.js';
+/** Pinned capture limits (PRD §9 / spine). */
+export const DEFAULT_TIMEOUT_MS = 10_000;
+export const DEFAULT_MAX_BYTES = 1_000_000; // 1MB
+const DEFAULT_ARG_SETS = [['--help'], ['-h'], ['help']];
+/** Candidate executable names to try. On Windows, resolve extensionless names against
+ *  common executable extensions (spawn without a shell does not append PATHEXT). */
+function candidates(tool) {
+    if (process.platform !== 'win32')
+        return [tool];
+    if (path.extname(tool))
+        return [tool];
+    return [`${tool}.exe`, `${tool}.com`, tool];
+}
+/** Merge a run's streams into one help-text blob (help may land on either stream). */
+function combine(o) {
+    const parts = [o.stdout, o.stderr].filter((s) => s.trim().length > 0);
+    return parts.join('\n');
+}
+/** Decide whether captured text is real help vs an error about the flag we passed. */
+export function isUsableHelp(text) {
+    const t = text.trim();
+    if (t.length < 20)
+        return false;
+    const firstLine = t.split('\n', 1)[0] ?? '';
+    if (/\b(unknown|unrecognized|invalid|illegal|no such)\b.*\b(option|flag|argument|command)\b/i.test(firstLine)) {
+        return false;
+    }
+    return true;
+}
+/** Remove man's backspace overstrike sequences (bold/underline) so extraction sees
+ *  plain text. */
+export function stripManFormatting(s) {
+    return s.replace(/.\x08/g, '');
+}
+/**
+ * Capture help text for `tool`. Throws ToolNotFoundError if the tool isn't on PATH, or
+ * NoHelpError if every fallback failed to yield usable help. Both surface as clear
+ * messages (exit 2 via PreconditionError) — never a hang.
+ */
+export async function captureHelp(tool, opts = {}) {
+    const run = opts.runner ?? defaultRun;
+    const limits = {
+        timeoutMs: opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        maxBytes: opts.maxBytes ?? DEFAULT_MAX_BYTES,
+    };
+    const argSets = opts.argSets ?? DEFAULT_ARG_SETS;
+    const cmds = candidates(tool);
+    let resolvedCmd = null;
+    let lastReason = '';
+    for (let i = 0; i < argSets.length; i++) {
+        const args = argSets[i];
+        // First probe also resolves which executable name actually runs. If none of the
+        // candidates can be spawned at all, the tool is not on PATH.
+        let outcome;
+        if (resolvedCmd === null) {
+            let resolvedOutcome = null;
+            for (const c of cmds) {
+                const o = await run(c, args, limits);
+                if (o.spawnError?.code === 'ENOENT')
+                    continue;
+                resolvedCmd = c;
+                resolvedOutcome = o;
+                break;
+            }
+            if (resolvedCmd === null || resolvedOutcome === null) {
+                throw new ToolNotFoundError(tool);
+            }
+            outcome = resolvedOutcome;
+        }
+        else {
+            outcome = await run(resolvedCmd, args, limits);
+        }
+        if (outcome.spawnError) {
+            lastReason = `spawn error (${outcome.spawnError.code ?? 'unknown'})`;
+            continue;
+        }
+        if (outcome.timedOut) {
+            lastReason = `timed out after ${limits.timeoutMs}ms`;
+            continue;
+        }
+        const text = combine(outcome);
+        if (isUsableHelp(text)) {
+            return { helpText: text, method: args.join(' ') };
+        }
+        lastReason = outcome.capped
+            ? 'output cap reached before usable help appeared'
+            : `no usable help (exit ${outcome.code})`;
+    }
+    // Last resort: man page.
+    if (opts.tryMan !== false) {
+        const manText = await tryMan(tool, run, limits);
+        if (manText)
+            return { helpText: manText, method: 'man' };
+    }
+    throw new NoHelpError(tool, lastReason || 'all fallbacks failed');
+}
+async function tryMan(tool, run, limits) {
+    const o = await run('man', [tool], {
+        ...limits,
+        env: { ...process.env, MANPAGER: 'cat', PAGER: 'cat', MANWIDTH: '80' },
+    });
+    if (o.spawnError || o.timedOut)
+        return null;
+    const text = stripManFormatting(combine(o)).trim();
+    return isUsableHelp(text) ? text : null;
+}
+/** Real runner: spawn (no shell → args-array only), read both streams into a capped
+ *  buffer, kill on timeout or byte-cap. */
+function defaultRun(cmd, args, limits) {
+    return new Promise((resolve) => {
+        const child = spawn(cmd, args, { env: limits.env ?? process.env, windowsHide: true });
+        const out = [];
+        const err = [];
+        let total = 0;
+        let timedOut = false;
+        let capped = false;
+        let settled = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGKILL');
+        }, limits.timeoutMs);
+        const settle = (code, spawnError) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve({
+                stdout: Buffer.concat(out).toString('utf8'),
+                stderr: Buffer.concat(err).toString('utf8'),
+                code,
+                timedOut,
+                capped,
+                spawnError,
+            });
+        };
+        const append = (sink, chunk) => {
+            const remaining = limits.maxBytes - total;
+            if (remaining <= 0)
+                return;
+            const slice = chunk.length > remaining ? chunk.subarray(0, remaining) : chunk;
+            sink.push(slice);
+            total += slice.length;
+            if (total >= limits.maxBytes) {
+                capped = true;
+                child.kill('SIGKILL');
+            }
+        };
+        child.stdout?.on('data', (c) => append(out, c));
+        child.stderr?.on('data', (c) => append(err, c));
+        child.on('error', (e) => settle(null, e));
+        child.on('close', (code) => settle(code));
+    });
+}
+//# sourceMappingURL=capture.js.map

package/dist/core/capture.js.map

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