keepgreen 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0
+
+First release.
+
+- `keepgreen explore`: looks at your app (playwright-e2e-mcp `inspect-page`), reads which tests already exist, asks your AI for the most important user flows with no test, and writes a test for each with AutoHeal's `cover`. A test is kept only if it passes the new-test guard (real assertions, no fakes, skips or fixed waits) and runs green several times in a row. One spend cap covers the whole run.
+- `keepgreen heal`: AutoHeal's local `fix` (run the tests, fix what broke, leave the changes for review).
+- `keepgreen init`: writes `.keepgreen.yml`, the explore workflow (read-only explore job + publish job that only accepts new test files) and AutoHeal's heal workflow.
+- `keepgreen doctor`, `keepgreen autoheal <command>`, `keepgreen check-patch`.
+- GitHub Action (`xsignon-secure/keepgreen@v0.1.0`) and a Docker Compose bundle for the self-hosted history server and AutoHeal dashboard.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XSignOn
+
+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

@@ -1,3 +1,157 @@
-# Temporary Holding Version
+# KeepGreen
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Your AI test agent that writes, fixes and keeps your end-to-end tests green.**
+
+KeepGreen is free and MIT licensed. It runs on your own CI runner or laptop with your own AI key
+(Anthropic, OpenAI or any OpenAI-compatible endpoint, including local models). There is no
+KeepGreen server, no account and no telemetry. You pay only your AI provider, and one spend cap
+covers every run.
+
+It combines two XSignOn projects into one agent:
+
+- [playwright-e2e-mcp](https://github.com/xsignon-secure/E2E) is the toolbox. It opens pages,
+  finds stable locators, runs tests and reads failures.
+- [AutoHeal](https://github.com/xsignon-secure/AutoHeal-AI) is the guarded fixer and test writer,
+  with its anti-cheat guard and stability proof.
+
+| Recipe | What it does | Command |
+| --- | --- | --- |
+| **Explore** | Looks at your app, picks the most important user flows that have **no test yet**, and writes a test for each. A test is kept only if it makes real assertions and passes every run (5 by default). | `npx keepgreen explore` |
+| **Heal** | Runs your tests, finds what broke, fixes it and proves the fix. App bugs are reported, not "fixed". | `npx keepgreen heal` (local) · AutoHeal workflow (CI) |
+
+Works with Playwright Test and pytest-playwright. Healing also covers Cypress and WebdriverIO.
+
+## Quick start (your machine)
+
+```bash
+npm install -D keepgreen              # or use npx keepgreen ... without installing
+export ANTHROPIC_API_KEY=sk-ant-...   # your own key
+npx keepgreen init                    # writes .keepgreen.yml + workflows, checks your setup
+npx keepgreen explore --url http://localhost:3000
+```
+
+Explore prints a table of the flows it tried and which tests it kept. New files are named
+`tests/keepgreen-<flow>.spec.ts`. Review them with `git diff` and commit the ones you like.
+
+Try it without writing anything first:
+
+```bash
+npx keepgreen explore --url http://localhost:3000 --dry-run   # plan only: shows the flows it would test
+```
+
+Let KeepGreen start your app:
+
+```bash
+npx keepgreen explore --start-command "npm run dev" --start-url http://localhost:3000
+```
+
+Fix broken tests:
+
+```bash
+npx keepgreen heal          # = AutoHeal's `autoheal fix`; changes stay in your working tree for review
+```
+
+## In GitHub Actions
+
+`npx keepgreen init` writes two workflows:
+
+- **`.github/workflows/keepgreen-explore.yml`** runs from *Actions > KeepGreen explore > Run
+  workflow*, or weekly if you uncomment the schedule. It opens **one PR** with the new tests that
+  passed. It has two jobs. The explore job runs the AI-written tests with a read-only token. The
+  publish job accepts the result only if it just adds test files, then opens the PR.
+- **`.github/workflows/autoheal.yml`** is written by AutoHeal's own `init`. It runs after your
+  test workflow fails and opens a fix PR.
+
+Then:
+
+1. Add `ANTHROPIC_API_KEY` as a repository secret. For OpenAI, add `OPENAI_API_KEY` and a
+   repository variable `AUTOHEAL_MODEL`.
+2. Go to *Settings > Actions > General > Workflow permissions* and tick "Allow GitHub Actions to
+   create and approve pull requests".
+3. Make the explore job's install steps match your test workflow (Node or Python, browsers,
+   services).
+
+You can also use the action directly:
+
+```yaml
+- uses: xsignon-secure/keepgreen@v0.1.0
+  with:
+    url: http://localhost:3000
+    anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+# leaves keepgreen-out/ (report.md, summary.json, new-tests.patch); output `written` = tests kept
+```
+
+## Settings
+
+`.keepgreen.yml` at the repo root. Command-line flags override it.
+
+```yaml
+url: http://localhost:3000        # the running app, or:
+# start-command: npm run dev
+# start-url: http://localhost:3000
+pages:                            # extra pages to look at when choosing flows
+  - /login
+  - /pricing
+max-flows: 3                      # new tests per explore run (1-10)
+max-usd: 3                        # AI spend cap for one explore run
+runs: 5                           # passing runs in a row a new test needs (2-20)
+framework: auto                   # auto | playwright | pytest | cypress | webdriverio
+```
+
+AI settings use AutoHeal's variables:
+
+| Variable | Meaning |
+| --- | --- |
+| `ANTHROPIC_API_KEY` | Use Anthropic (default model `claude-opus-5-5`) |
+| `OPENAI_API_KEY` + `AUTOHEAL_MODEL` | Use OpenAI |
+| `AUTOHEAL_BASE_URL` + `AUTOHEAL_MODEL` | Any OpenAI-compatible endpoint, e.g. Ollama at `http://localhost:11434/v1` |
+| `AUTOHEAL_EFFORT` | Anthropic effort: `low` … `max` (default `medium`) |
+| `AUTOHEAL_PRICE_IN` / `AUTOHEAL_PRICE_OUT` | USD per 1M tokens, for models without a listed price |
+
+## How explore works
+
+1. **Look.** It opens your app's start page and every path in `pages:` with playwright-e2e-mcp's
+   `inspect-page`, which lists the interactive elements and their locators.
+2. **Plan.** It reads the titles of your existing tests and asks your AI for the most important
+   user flows that have no test yet. Flows that pay money, send email or delete data are skipped.
+3. **Write.** For each flow, AutoHeal's `cover` explores the pages, checks every locator, and
+   writes one test in your project's own style.
+4. **Prove.** The new-test guard rejects tests that cannot fail, or that use skips, faked network
+   answers, fixed waits, forced clicks or retries. The test must then pass every run in a row.
+   Anything less is thrown away.
+
+One `max-usd` cap covers the whole run. Each flow gets an even share of what is left, so money one
+flow saves goes to the next.
+
+## All commands
+
+```
+keepgreen init [--force] [--dry-run]
+keepgreen doctor
+keepgreen explore [--url <app>] [--start-command <cmd> --start-url <url>] [--pages /a,/b]
+                  [--max-flows 3] [--max-usd 3] [--runs 5] [--dry-run] [--out <dir>]
+keepgreen heal [AutoHeal fix options]
+keepgreen autoheal <command> [...]      # any AutoHeal command: learn, metrics, dashboard, ...
+keepgreen check-patch <file>            # CI publish step
+keepgreen --version
+```
+
+## Self-host bundle (optional)
+
+KeepGreen needs no server. If you want **test history across all CI runs** (flaky ranking, the
+commit where a test went bad) and **AutoHeal's dashboard** (fixes, blocked cheats, AI spend),
+[`selfhost/`](selfhost/) starts both servers with one command:
+
+```bash
+cd selfhost && sh make-env.sh your-org/your-repo && docker compose up -d --build
+```
+
+## Security
+
+See [SECURITY.md](SECURITY.md). In short: your key goes only to your AI provider, AI-written tests
+never run with a write token or your AI key, the publish step only accepts new test files, and
+every change arrives as a PR for a person to review.
+
+## License
+
+MIT. Free for any use, with no paid tier.

package/SECURITY.md

@@ -0,0 +1,41 @@
+# Security
+
+KeepGreen runs an AI model against your app and your tests, so it is built on the assumption that
+the model can be wrong or manipulated. Text on a page or in a test file could try to instruct it;
+every prompt marks such text as data.
+
+## What protects you
+
+- **Your key, your runner.** KeepGreen has no server, no account and no telemetry. The only
+  network calls go to the AI provider you choose, your own app, and (in CI) GitHub to open the PR.
+- **Two jobs in CI.** The explore job, where AI-written tests run, has a read-only token and
+  checks out with `persist-credentials: false`. It uploads the new tests as a patch. The publish
+  job never runs your project's code. `keepgreen check-patch` accepts the patch only if it just
+  **adds** plain test files (`*.spec.ts`, `*.test.js`, `*.cy.ts`, `test_*.py`, ...): no changes
+  to existing files, no deletes, renames, mode changes or binary data, nothing under hidden
+  folders such as `.github/`, nothing in `node_modules`, at most 10 files. Then git applies it
+  with hooks off and the PR is opened.
+- **Secrets stay out of test runs.** New tests, and an app started with `start-command`, run in a
+  child process without the AI key or any GitHub / Actions token (AutoHeal's scrubbed engine
+  environment).
+- **New-test guard.** AutoHeal's `scanNewTest` rejects tests without real assertions, or with
+  skips, faked network answers (`page.route`), injected scripts, fixed waits, `force: true`,
+  extra retries or timeouts, file, environment or network access. A test must then pass every
+  one of `runs` runs in a row. The scans are pattern based, so every test still arrives as a PR
+  for a person to review.
+- **Pages stay on your app.** Planning only opens the app URL and the paths you list in
+  `pages:`; `cover` only opens pages on the same origin.
+- **Spend cap.** One `max-usd` limit covers a whole explore run (planning plus every flow).
+
+## Your part
+
+- Use an AI key with a spend limit; it is present in the explore job.
+- Run explore on your own branches only. The template runs on `workflow_dispatch` and an
+  optional schedule, never on pull requests from forks.
+- Review every KeepGreen PR like any other change.
+- For the self-host bundle, put the servers behind HTTPS and keep `.env` out of git.
+
+## Reporting a vulnerability
+
+Please use GitHub's private vulnerability reporting on this repository
+(Security > Report a vulnerability). Do not open a public issue.

package/action.yml

@@ -0,0 +1,102 @@
+name: KeepGreen explore
+description: Free, self-hosted AI test agent. Finds important user flows with no test and writes Playwright tests for them, with your own AI key.
+author: xsignon-secure
+branding:
+  icon: check-circle
+  color: green
+
+# Runs `keepgreen explore` and leaves keepgreen-out/ (report.md, summary.json,
+# new-tests.patch) for an upload step. It opens no PR itself: the template's
+# publish job does that with a separate, write-only step. See
+# templates/keepgreen-explore.yml.
+
+inputs:
+  url:
+    description: App URL to explore (blank = url in .keepgreen.yml)
+    required: false
+    default: ""
+  start-command:
+    description: Command that starts your app (with start-url)
+    required: false
+    default: ""
+  start-url:
+    description: Address to wait for after start-command
+    required: false
+    default: ""
+  max-flows:
+    description: New tests to try (1-10; blank = .keepgreen.yml or 3)
+    required: false
+    default: ""
+  max-usd:
+    description: AI spend cap for the run in USD (blank = .keepgreen.yml or 3)
+    required: false
+    default: ""
+  runs:
+    description: Passing runs in a row a new test needs (blank = .keepgreen.yml or 5)
+    required: false
+    default: ""
+  anthropic-api-key:
+    description: Anthropic API key
+    required: false
+    default: ""
+  openai-api-key:
+    description: OpenAI API key (also set model)
+    required: false
+    default: ""
+  model:
+    description: Model id (optional for Anthropic)
+    required: false
+    default: ""
+  working-directory:
+    description: Project folder
+    required: false
+    default: "."
+  version:
+    description: keepgreen version from npm
+    required: false
+    default: "0.1.0"
+
+outputs:
+  written:
+    description: Number of new tests kept
+    value: ${{ steps.run.outputs.written }}
+
+runs:
+  using: composite
+  steps:
+    - id: run
+      shell: bash
+      working-directory: ${{ inputs.working-directory }}
+      env:
+        ANTHROPIC_API_KEY: ${{ inputs.anthropic-api-key }}
+        OPENAI_API_KEY: ${{ inputs.openai-api-key }}
+        AUTOHEAL_MODEL: ${{ inputs.model }}
+        KG_VERSION: ${{ inputs.version }}
+        KG_URL: ${{ inputs.url }}
+        KG_START_COMMAND: ${{ inputs.start-command }}
+        KG_START_URL: ${{ inputs.start-url }}
+        KG_MAX_FLOWS: ${{ inputs.max-flows }}
+        KG_MAX_USD: ${{ inputs.max-usd }}
+        KG_RUNS: ${{ inputs.runs }}
+        OUT: ${{ github.workspace }}/keepgreen-out
+      run: |
+        [ -n "$ANTHROPIC_API_KEY" ] || unset ANTHROPIC_API_KEY
+        [ -n "$OPENAI_API_KEY" ] || unset OPENAI_API_KEY
+        [ -n "$AUTOHEAL_MODEL" ] || unset AUTOHEAL_MODEL
+        if ! [[ "$KG_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then echo "::error::version must be like 1.2.3"; exit 2; fi
+        args=(explore --out "$OUT")
+        [ -n "$KG_URL" ] && args+=(--url "$KG_URL")
+        [ -n "$KG_START_COMMAND" ] && args+=(--start-command "$KG_START_COMMAND")
+        [ -n "$KG_START_URL" ] && args+=(--start-url "$KG_START_URL")
+        [ -n "$KG_MAX_FLOWS" ] && args+=(--max-flows "$KG_MAX_FLOWS")
+        [ -n "$KG_MAX_USD" ] && args+=(--max-usd "$KG_MAX_USD")
+        [ -n "$KG_RUNS" ] && args+=(--runs "$KG_RUNS")
+        set +e
+        npx -y "keepgreen@$KG_VERSION" "${args[@]}"
+        code=$?
+        set -e
+        written=0
+        [ -f "$OUT/summary.json" ] && written="$(node -p 'require(process.env.OUT + "/summary.json").written.length')"
+        echo "written=$written" >> "$GITHUB_OUTPUT"
+        # 1 = ran fine but kept no test; that is not a failed job.
+        if [ "$code" -gt 1 ] || { [ "$code" -eq 1 ] && [ ! -f "$OUT/summary.json" ]; }; then exit "$code"; fi

package/dist/cli.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * keepgreen: one command for the whole agent.
+ *   explore  writes new tests (KeepGreen's own recipe, built on AutoHeal's cover)
+ *   heal     fixes broken tests on your machine (AutoHeal's `fix`)
+ *   init     writes .keepgreen.yml, the explore workflow and AutoHeal's heal workflow
+ *   doctor   checks the setup
+ */
+export declare const USAGE: string;
+/** Path of AutoHeal's CLI inside the installed xsignon-autoheal package. */
+export declare function autohealCli(): string;
+export declare function main(argv: string[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+/**
+ * keepgreen: one command for the whole agent.
+ *   explore  writes new tests (KeepGreen's own recipe, built on AutoHeal's cover)
+ *   heal     fixes broken tests on your machine (AutoHeal's `fix`)
+ *   init     writes .keepgreen.yml, the explore workflow and AutoHeal's heal workflow
+ *   doctor   checks the setup
+ */
+import { spawnSync } from 'node:child_process';
+import { realpathSync } from 'node:fs';
+import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { parseArgs } from 'node:util';
+import { ConfigError, CypressTools, McpTools, WdioTools, checkAppUrl, cover, frameworkSetting, isCypressProject, isPytestProject, isWdioProject, priceFor, providerFromEnv, startApp, } from 'xsignon-autoheal';
+import { ConfigFileError, loadConfigFile, resolveConfig } from './config.js';
+import { existingTitles, explore, exploreReport } from './explore.js';
+import { init } from './init.js';
+import { newFilesPatch } from './newfiles.js';
+import { checkPatch } from './patch.js';
+import { VERSION } from './version.js';
+export const USAGE = `keepgreen ${VERSION}: free, self-hosted AI test agent. It writes new end-to-end tests
+for your app and fixes the ones that break, with your own AI key (Anthropic, OpenAI or any
+OpenAI-compatible endpoint). Built on playwright-e2e-mcp and AutoHeal. MIT, no account, no telemetry.
+
+  keepgreen init [--force] [--dry-run]
+        write .keepgreen.yml, the explore workflow and AutoHeal's heal workflow (GitHub Actions)
+  keepgreen doctor
+        check this project and machine
+  keepgreen explore [--url <app>] [--start-command <cmd> --start-url <url>] [--pages /a,/b]
+                    [--max-flows 3] [--max-usd 3] [--runs 5] [--dry-run] [--out <dir>]
+        find important user flows with no test yet and write a test for each; a test is kept
+        only if it makes real assertions and passes --runs times in a row
+  keepgreen heal [AutoHeal fix options]
+        run your tests, fix what broke, leave the changes for you to review
+  keepgreen autoheal <command> [...]
+        run any AutoHeal command (heal, publish, learn, metrics, dashboard, ...)
+  keepgreen check-patch <file>
+        CI publish step: accept a patch only if it just adds test files
+  keepgreen --version
+
+Settings come from .keepgreen.yml; flags win. The AI key comes from ANTHROPIC_API_KEY,
+OPENAI_API_KEY (+ AUTOHEAL_MODEL) or AUTOHEAL_BASE_URL (+ AUTOHEAL_MODEL).
+`;
+const log = (line) => process.stderr.write(`[keepgreen] ${line}\n`);
+/** Path of AutoHeal's CLI inside the installed xsignon-autoheal package. */
+export function autohealCli() {
+    const entry = fileURLToPath(import.meta.resolve('xsignon-autoheal'));
+    return path.join(path.dirname(entry), 'cli.js');
+}
+function runAutoheal(args) {
+    const r = spawnSync(process.execPath, [autohealCli(), ...args], { stdio: 'inherit' });
+    if (r.error)
+        throw r.error;
+    return r.status ?? 1;
+}
+async function detectFramework(root, value) {
+    let setting;
+    try {
+        setting = frameworkSetting(value ?? process.env.AUTOHEAL_FRAMEWORK);
+    }
+    catch (error) {
+        throw new ConfigError(error instanceof Error ? error.message : String(error));
+    }
+    if (setting !== 'auto')
+        return setting;
+    if (await isWdioProject(root))
+        return 'webdriverio';
+    if (await isCypressProject(root))
+        return 'cypress';
+    return (await isPytestProject(root)) ? 'pytest' : 'playwright';
+}
+async function cmdExplore(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            url: { type: 'string' },
+            'start-command': { type: 'string' },
+            'start-url': { type: 'string' },
+            pages: { type: 'string' },
+            'max-flows': { type: 'string' },
+            'max-usd': { type: 'string' },
+            runs: { type: 'string' },
+            framework: { type: 'string' },
+            project: { type: 'string' },
+            out: { type: 'string' },
+            'dry-run': { type: 'boolean' },
+        },
+        strict: true,
+    });
+    const projectRoot = path.resolve(values.project ?? '.');
+    const { project: _p, out: _o, 'dry-run': _d, ...flags } = values;
+    const config = resolveConfig(await loadConfigFile(projectRoot), flags);
+    const env = process.env;
+    const provider = providerFromEnv(env);
+    if (!provider)
+        throw new ConfigError('keepgreen explore needs an AI key: set ANTHROPIC_API_KEY, OPENAI_API_KEY (and AUTOHEAL_MODEL) or AUTOHEAL_BASE_URL.');
+    const framework = await detectFramework(projectRoot, config.framework);
+    let app = null;
+    let appUrl = config.url;
+    let engine = null;
+    let runner = null;
+    try {
+        if (config.startCommand) {
+            const url = config.startUrl ?? config.url;
+            if (!url)
+                throw new ConfigError('start-command needs start-url: the address to wait for.');
+            // startApp gives your app the tests' scrubbed environment: no AI key, no CI tokens.
+            app = await startApp({ command: config.startCommand, url, cwd: projectRoot, sandbox: null, log });
+            appUrl = app.url;
+        }
+        if (!appUrl)
+            throw new ConfigError('Tell KeepGreen where your app runs: --url http://localhost:3000, or url: in .keepgreen.yml (or start-command + start-url).');
+        checkAppUrl(appUrl);
+        log(`KeepGreen ${VERSION}: exploring ${appUrl} (${framework}, ${provider.name} ${provider.model}, limit $${config.maxUsd})`);
+        engine = await McpTools.start(projectRoot);
+        runner = framework === 'cypress' ? new CypressTools(projectRoot, { log }) : framework === 'webdriverio' ? new WdioTools(projectRoot, { log }) : engine;
+        const result = await explore({
+            projectRoot,
+            provider,
+            engine,
+            runner,
+            appUrl,
+            pages: config.pages,
+            existing: await existingTitles(projectRoot),
+            maxFlows: config.maxFlows,
+            maxUsd: config.maxUsd,
+            runs: config.runs,
+            price: priceFor(provider.model, env),
+            framework,
+            cover,
+            log,
+            dryRun: values['dry-run'] === true,
+        });
+        const report = exploreReport(result, config.runs);
+        process.stdout.write(`\n${report}\n`);
+        const written = result.results.filter((r) => r.result.status === 'written').map((r) => r.result.file);
+        if (values.out) {
+            const out = path.resolve(values.out);
+            await mkdir(out, { recursive: true });
+            await writeFile(path.join(out, 'report.md'), `${report}\n`);
+            await writeFile(path.join(out, 'summary.json'), `${JSON.stringify({ version: VERSION, written, flows: result.flows, usd: result.usd }, null, 2)}\n`);
+            await writeFile(path.join(out, 'new-tests.patch'), await newFilesPatch(projectRoot, written));
+            log(`Wrote ${path.relative(process.cwd(), out) || '.'}/report.md, summary.json and new-tests.patch`);
+        }
+        if (env.GITHUB_STEP_SUMMARY)
+            await appendFile(env.GITHUB_STEP_SUMMARY, `${report}\n`).catch(() => undefined);
+        return values['dry-run'] || written.length ? 0 : 1;
+    }
+    finally {
+        if (runner && runner !== engine)
+            await runner.close().catch(() => undefined);
+        await engine?.close();
+        await app?.stop().catch(() => undefined);
+    }
+}
+async function cmdInit(argv) {
+    const { values } = parseArgs({ args: argv, options: { project: { type: 'string' }, force: { type: 'boolean' }, 'dry-run': { type: 'boolean' } }, strict: true });
+    const root = path.resolve(values.project ?? '.');
+    const dryRun = values['dry-run'] === true;
+    const r = await init(root, { force: values.force === true, dryRun });
+    const out = [`KeepGreen ${VERSION}`, ''];
+    for (const w of r.written)
+        out.push(`${dryRun ? 'would write' : 'wrote'}   ${w}`);
+    for (const w of r.skipped)
+        out.push(`kept    ${w} (exists; --force to overwrite)`);
+    out.push('', 'Now AutoHeal sets up healing:', '');
+    process.stdout.write(out.join('\n'));
+    const code = runAutoheal(['init', '--ci', 'github', '--project', root, ...(values.force ? ['--force'] : []), ...(dryRun ? ['--dry-run'] : [])]);
+    process.stdout.write([
+        '',
+        'For KeepGreen explore, also:',
+        '  1. Set url: in .keepgreen.yml (or start-command + start-url) so KeepGreen can reach your app.',
+        '  2. Add ANTHROPIC_API_KEY (or OPENAI_API_KEY + the AUTOHEAL_MODEL variable) as a repository secret.',
+        '  3. Settings > Actions > General: allow GitHub Actions to create pull requests.',
+        '  4. Run it: Actions > KeepGreen explore > Run workflow (or `npx keepgreen explore` on your machine).',
+        '',
+    ].join('\n'));
+    return code;
+}
+async function cmdDoctor(argv) {
+    const { values } = parseArgs({ args: argv, options: { project: { type: 'string' } }, strict: true });
+    const root = path.resolve(values.project ?? '.');
+    const lines = [`KeepGreen ${VERSION} doctor`, ''];
+    let failed = false;
+    try {
+        const config = resolveConfig(await loadConfigFile(root), {});
+        const target = config.startCommand ? `start-command "${config.startCommand}" then ${config.startUrl ?? config.url ?? '(no start-url!)'}` : (config.url ?? null);
+        lines.push(target ? `ok    explore target: ${target}` : 'warn  no url in .keepgreen.yml: pass --url to keepgreen explore');
+        if (config.startCommand && !(config.startUrl ?? config.url))
+            failed = true;
+    }
+    catch (error) {
+        failed = true;
+        lines.push(`fail  .keepgreen.yml: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    lines.push('', 'AutoHeal checks (keys, framework, CI):', '');
+    process.stdout.write(lines.join('\n'));
+    const code = runAutoheal(['doctor', '--project', root]);
+    return failed ? 1 : code;
+}
+async function cmdCheckPatch(argv) {
+    const file = argv[0];
+    if (!file || argv.length > 1)
+        throw new ConfigError('Usage: keepgreen check-patch <file>');
+    const result = checkPatch(await readFile(file, 'utf8'));
+    if (result.ok) {
+        process.stdout.write(`${result.files.join('\n')}\n`);
+        return 0;
+    }
+    log(result.files.length || result.problems.length ? `Patch refused:\n  ${(result.problems.length ? result.problems : ['no files']).join('\n  ')}` : 'Patch is empty.');
+    return 1;
+}
+export async function main(argv) {
+    const [command, ...rest] = argv;
+    try {
+        if (!command || command === 'help' || command === '--help' || command === '-h') {
+            process.stdout.write(USAGE);
+            return command ? 0 : 2;
+        }
+        if (command === '--version' || command === '-v' || command === 'version') {
+            process.stdout.write(`${VERSION}\n`);
+            return 0;
+        }
+        if (command === 'explore')
+            return await cmdExplore(rest);
+        if (command === 'heal')
+            return runAutoheal(['fix', ...rest]);
+        if (command === 'autoheal')
+            return runAutoheal(rest);
+        if (command === 'init')
+            return await cmdInit(rest);
+        if (command === 'doctor')
+            return await cmdDoctor(rest);
+        if (command === 'check-patch')
+            return await cmdCheckPatch(rest);
+        process.stderr.write(`Unknown command "${command}".\n\n${USAGE}`);
+        return 2;
+    }
+    catch (error) {
+        if (error instanceof ConfigError || error instanceof ConfigFileError || error.code?.startsWith('ERR_PARSE_ARGS')) {
+            log(error.message);
+            return 2;
+        }
+        log(error instanceof Error ? (error.stack ?? error.message) : String(error));
+        return 1;
+    }
+}
+const invoked = process.argv[1] ? pathToFileURL(realpathSync(process.argv[1])).href : '';
+if (invoked === import.meta.url) {
+    main(process.argv.slice(2)).then((code) => {
+        process.exitCode = code;
+    });
+}
+//# 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/config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `.keepgreen.yml`: the one settings file. It is a small, flat YAML subset
+ * (key: value lines, and `pages:` as a list of `- /path` lines), so it needs
+ * no YAML library. Command-line flags win over the file.
+ *
+ *   url: http://localhost:3000        # the running app to explore
+ *   start-command: npm run dev        # or: start it for me
+ *   start-url: http://localhost:3000  # address to wait for after start-command
+ *   pages:                            # extra pages to look at when planning
+ *     - /login
+ *     - /pricing
+ *   max-flows: 3                      # new tests per explore run
+ *   max-usd: 3                        # AI spend cap for one explore run
+ *   runs: 5                           # passing runs in a row a new test needs
+ *   framework: auto                   # auto | playwright | pytest | cypress | webdriverio
+ */
+export declare const CONFIG_FILE = ".keepgreen.yml";
+export interface KeepGreenConfig {
+    url?: string;
+    startCommand?: string;
+    startUrl?: string;
+    pages: string[];
+    maxFlows: number;
+    maxUsd: number;
+    runs: number;
+    framework?: string;
+}
+export declare const DEFAULTS: KeepGreenConfig;
+export declare class ConfigFileError extends Error {
+    constructor(message: string);
+}
+export declare function parseConfig(text: string): Record<string, string | string[]>;
+/** Merges defaults, the file and flags (flags win), and checks the values. */
+export declare function resolveConfig(file: Record<string, string | string[]>, flags: Record<string, string | undefined>): KeepGreenConfig;
+export declare function loadConfigFile(projectRoot: string): Promise<Record<string, string | string[]>>;