@jevitate/cli 0.1.0 → 0.3.0

package/dist/logs-retention.js

@@ -0,0 +1,85 @@
+import { readFileSync, readdirSync, rmSync, rmdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { resolveDataDir } from "./data-dir.js";
+import { clock } from "@jevitate/domain";
+export const DEFAULT_LOGS_RETENTION = { ttlDays: 14, keepLatest: 50 };
+export class LogsConfigError extends Error {
+    code = "E_LOGS_CONFIG";
+}
+/** The `logs` section of the config file; the defaults when the file or section is absent. A malformed value fails closed. */
+export function loadLogsRetention(path = resolveDataDir(["config.json"])) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (e) {
+        if (typeof e === "object" && e !== null && "code" in e && e.code === "ENOENT")
+            return DEFAULT_LOGS_RETENTION;
+        throw new LogsConfigError(`cannot read ${path}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new LogsConfigError(`${path} is not valid JSON`);
+    }
+    const logs = parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed.logs : undefined;
+    if (logs === undefined)
+        return DEFAULT_LOGS_RETENTION;
+    if (logs === null || typeof logs !== "object" || Array.isArray(logs))
+        throw new LogsConfigError(`${path}: "logs" must be an object`);
+    const o = logs;
+    const int = (k) => {
+        const v = o[k];
+        if (v === undefined)
+            return DEFAULT_LOGS_RETENTION[k];
+        if (typeof v !== "number" || !Number.isInteger(v) || v < 0)
+            throw new LogsConfigError(`${path}: logs.${k} must be a non-negative integer, got ${JSON.stringify(v)}`);
+        return v;
+    };
+    return { ttlDays: int("ttlDays"), keepLatest: int("keepLatest") };
+}
+const RUN_KEY = /^([a-z][a-z-]*-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z)/;
+function runsIn(root) {
+    let dates;
+    try {
+        dates = readdirSync(root).filter((d) => /^\d{4}-\d{2}-\d{2}$/.test(d));
+    }
+    catch (e) {
+        if (typeof e === "object" && e !== null && "code" in e && e.code === "ENOENT")
+            return { runs: [], dateDirs: [] };
+        throw e;
+    }
+    const byKey = new Map();
+    for (const date of dates) {
+        for (const name of readdirSync(join(root, date))) {
+            const path = join(root, date, name);
+            const key = `${date}/${RUN_KEY.exec(name)?.[1] ?? name}`;
+            const run = byKey.get(key) ?? { paths: [], mtimeMs: 0 };
+            run.paths.push(path);
+            run.mtimeMs = Math.max(run.mtimeMs, statSync(path).mtimeMs);
+            byKey.set(key, run);
+        }
+    }
+    return { runs: [...byKey].map(([key, r]) => ({ key, ...r })), dateDirs: dates.map((d) => join(root, d)) };
+}
+/** Applies `retention` to the logs under `root`. `dryRun` reports what would go, deleting nothing. */
+export function pruneLogs(root, retention, opts = {}) {
+    const nowMs = opts.nowMs ?? clock.now();
+    const { runs, dateDirs } = runsIn(root);
+    const newestFirst = [...runs].sort((a, b) => b.mtimeMs - a.mtimeMs);
+    const cutoff = nowMs - retention.ttlDays * 86_400_000;
+    const doomed = newestFirst.slice(retention.keepLatest).filter((r) => r.mtimeMs < cutoff);
+    if (opts.dryRun !== true) {
+        for (const r of doomed)
+            for (const p of r.paths)
+                rmSync(p, { recursive: true, force: true });
+        for (const d of dateDirs) {
+            if (readdirSync(d).length === 0)
+                rmdirSync(d);
+        }
+    }
+    return { root, removed: doomed.map((r) => r.key).sort(), keptRuns: runs.length - doomed.length };
+}
+//# sourceMappingURL=logs-retention.js.map

package/dist/logs-retention.js.map

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

package/dist/masked-input.d.ts

@@ -0,0 +1,22 @@
+/**
+ * #269 — masked key entry. The previous prompt muted readline's echo by hooking its private
+ * `_writeToOutput`, but readline's line refresh still moved the cursor and cleared the screen below
+ * it on every keystroke: the instructions printed before the prompt vanished as soon as the user
+ * typed ("flash off too fast to read"), and nothing showed that input was being received.
+ *
+ * This reader never clears anything: the instructions stay on their own line, and each typed (or
+ * pasted) character is echoed as `•` — never the character itself. Backspace erases one mark,
+ * Ctrl-U erases all, Enter finishes, Ctrl-C / Ctrl-D (on an empty entry) cancel. Without a TTY
+ * (piped input) it reads one line and echoes nothing. The value is only ever returned to the
+ * caller; it is never written to `output`.
+ */
+export declare const MASK_CHAR = "\u2022";
+export interface MaskedInput extends NodeJS.ReadableStream {
+    readonly isTTY?: boolean;
+    setRawMode?(mode: boolean): unknown;
+}
+/** Key entry was cancelled (Ctrl-C, Ctrl-D, or the input ended): nothing was entered. */
+export declare class KeyEntryCancelledError extends Error {
+    constructor();
+}
+export declare function readMaskedLine(input: MaskedInput, output: NodeJS.WritableStream, message: string): Promise<string>;

package/dist/masked-input.js

@@ -0,0 +1,99 @@
+/**
+ * #269 — masked key entry. The previous prompt muted readline's echo by hooking its private
+ * `_writeToOutput`, but readline's line refresh still moved the cursor and cleared the screen below
+ * it on every keystroke: the instructions printed before the prompt vanished as soon as the user
+ * typed ("flash off too fast to read"), and nothing showed that input was being received.
+ *
+ * This reader never clears anything: the instructions stay on their own line, and each typed (or
+ * pasted) character is echoed as `•` — never the character itself. Backspace erases one mark,
+ * Ctrl-U erases all, Enter finishes, Ctrl-C / Ctrl-D (on an empty entry) cancel. Without a TTY
+ * (piped input) it reads one line and echoes nothing. The value is only ever returned to the
+ * caller; it is never written to `output`.
+ */
+export const MASK_CHAR = "•";
+/** Key entry was cancelled (Ctrl-C, Ctrl-D, or the input ended): nothing was entered. */
+export class KeyEntryCancelledError extends Error {
+    constructor() {
+        super("key entry cancelled — nothing was stored");
+        this.name = "KeyEntryCancelledError";
+    }
+}
+export function readMaskedLine(input, output, message) {
+    const raw = input.isTTY === true && typeof input.setRawMode === "function";
+    output.write(`${message}\n> `);
+    return new Promise((resolve, reject) => {
+        let value = "";
+        let done = false;
+        const finish = (err) => {
+            if (done)
+                return;
+            done = true;
+            input.removeListener("data", onData);
+            input.removeListener("end", onEnd);
+            if (raw)
+                input.setRawMode?.(false);
+            input.pause();
+            output.write("\n");
+            if (err === null)
+                resolve(value);
+            else
+                reject(err);
+        };
+        const onEnd = () => {
+            // Piped input that ends without a newline still delivers what it held; an empty one is a cancel.
+            if (value.length > 0)
+                finish(null);
+            else
+                finish(new KeyEntryCancelledError());
+        };
+        const onData = (chunk) => {
+            const text = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            // An escape sequence (arrow keys, function keys) is navigation, never part of a key.
+            if (raw && text.startsWith("\u001b"))
+                return;
+            for (const ch of text) {
+                if (ch === "\r" || ch === "\n") {
+                    finish(null);
+                    return;
+                }
+                if (!raw) {
+                    value += ch;
+                    continue;
+                }
+                if (ch === "\u0003") {
+                    finish(new KeyEntryCancelledError());
+                    return;
+                }
+                if (ch === "\u0004") {
+                    if (value.length === 0)
+                        finish(new KeyEntryCancelledError());
+                    else
+                        finish(null);
+                    return;
+                }
+                if (ch === "\u007f" || ch === "\b") {
+                    if (value.length > 0) {
+                        value = [...value].slice(0, -1).join("");
+                        output.write("\b \b");
+                    }
+                    continue;
+                }
+                if (ch === "\u0015") {
+                    output.write("\b \b".repeat([...value].length));
+                    value = "";
+                    continue;
+                }
+                if (ch < " ")
+                    continue; // other control characters
+                value += ch;
+                output.write(MASK_CHAR);
+            }
+        };
+        if (raw)
+            input.setRawMode?.(true);
+        input.on("data", onData);
+        input.on("end", onEnd);
+        input.resume();
+    });
+}
+//# sourceMappingURL=masked-input.js.map

package/dist/masked-input.js.map

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

package/dist/mcp-api.d.ts

@@ -1,6 +1,17 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { type AiGenerateTextArgs, type AiGenerateTextResult } from "@jevitate/mcp-facade";
 import { type CredentialStore, type GenerationPort, type SetupRequiredResult } from "@jevitate/ai-core";
+import type { JudgmentPort, UsageTracker } from "@jevitate/ai-core";
+import type { SelfHealer } from "@jevitate/runtime";
+import type { EmulationSpec } from "@jevitate/playwright";
+import { type RunPolicy } from "@jevitate/domain";
+import { type RunVerifyFixOptions, type VerifyFixReport } from "./verify-fix-api.js";
+import { type BrowserRunOptions } from "./browser-run-options.js";
+import { type ResolvedJourneyEnvironment } from "./environments.js";
+import { type MissionFixtures } from "./mission-fixtures.js";
+import { type ScreenshotsSpec } from "./run-screenshots.js";
+import type { McpCliRunner } from "./mcp-cli-runner.js";
+import { type EngineInfo } from "./engine.js";
 /**
  * The MCP stdio server behind `jevitate mcp`. It exposes ONLY the tools in
  * `@jevitate/mcp-facade`'s `ALLOWED_TOOLS` and structurally CANNOT serve any
@@ -27,12 +38,36 @@ export interface McpTool {
         type: "object";
         properties: Record<string, unknown>;
         required?: string[];
+        additionalProperties?: boolean;
     };
     handler: (args: Record<string, unknown>) => Promise<McpToolResult>;
 }
+/** #255: what an extended `run_journey` call adds — every field resolved and validated by the handler. */
+export interface McpJourneyRunOptions {
+    readonly policy?: RunPolicy;
+    readonly selfHealer?: SelfHealer;
+    readonly environment?: ResolvedJourneyEnvironment;
+    readonly browser?: BrowserRunOptions;
+    readonly emulation?: EmulationSpec;
+    readonly screenshots?: ScreenshotsSpec;
+    readonly fixtures?: (site: string) => MissionFixtures | undefined;
+    /** #303: record and compare each replayed step's action delta (`--action-deltas`). */
+    readonly actionDeltas?: boolean;
+}
+/**
+ * #255: what `verify_fix` hands the runner — the finding (resolved result path + fingerprint) and
+ * the CLI-parity replay options. Operator-only settings (shell hooks, `cmd:` log sources, re-sending
+ * paid/destructive hang writes, redaction literals) are never MCP arguments: targets.json decides.
+ */
+export type McpVerifyFixArgs = Pick<RunVerifyFixOptions, "resultPath" | "fingerprint"> & Partial<Pick<RunVerifyFixOptions, "storageState" | "browser" | "replays" | "invariantFiles" | "fixtureFlags" | "emulation" | "allowEmulationOverride" | "screenshots" | "actionDeltas">>;
 export interface McpApiDeps {
     /** Journeys store directory (`~/.jevitate/journeys` in production). */
     journeysDir: string;
+    /**
+     * The site-policy database (`jevitate site policy set`): `run_journey` is paced, throttled,
+     * budgeted and kept out of quiet hours per the Journey's origin. Absent file = no policy.
+     */
+    sitePolicyDbPath?: string;
     /**
      * Test seam. Defaults to the real promoted-only projection over the
      * journeys store (`@jevitate/mcp-facade`'s `findCapabilities`).
@@ -41,8 +76,37 @@ export interface McpApiDeps {
     /**
      * Test seam. Defaults to `runJourneyProgrammatically` with a fail-closed
      * `safeRunPolicy()` (invariant #5: PUBLISHED-id-only, never inline steps).
+     * `storageState` (#118) is a PATH to a Playwright storageState JSON file — the file is
+     * read only by the server's own browser launch; its contents never enter this handler,
+     * an MCP result, or a log.
+     */
+    runJourney?: (id: string, params: Record<string, string>, storageState?: string, options?: McpJourneyRunOptions) => Promise<unknown>;
+    /**
+     * #255: the directories MCP path arguments (storage states, fixtures, invariants, output dirs)
+     * must resolve inside — default: the project and `~/.jevitate` (mcp-paths.ts).
+     */
+    pathRoots?: readonly string[];
+    /** #255 (`run_journey {env}`): the environments file (default: the repo's `.jevitate/environments.json`). */
+    environmentsFile?: string;
+    /** `~/.jevitate/targets.json` override (environment sessions, verify_fix target config). */
+    targetsConfigPath?: string;
+    /**
+     * #255 (`run_journey {selfHeal: hybrid|full}`): builds the self-heal gateways exactly as the CLI's
+     * `--real`/`--fake-ai` do (`buildExploreGateways`). Absent: a heal mode is refused (setup_required).
+     */
+    selfHealGateways?: (sel: {
+        real: boolean;
+        fakeAi: boolean;
+    }) => Promise<{
+        judge: JudgmentPort;
+        gen: GenerationPort;
+        usage: UsageTracker;
+    }>;
+    /**
+     * #255: the CLI in-process (mcp-cli-runner.ts) — backs every MCP tool that mirrors a CLI command
+     * (mcp-cli-tools.ts). Absent: those tools refuse with `not_configured`.
      */
-    runJourney?: (id: string, params: Record<string, string>) => Promise<unknown>;
+    runCli?: McpCliRunner;
     /**
      * Promoted mission-target store directory (`~/.jevitate/missions/targets` in
      * production — the SAME store `jevitate mission target` writes). Required for
@@ -89,6 +153,32 @@ export interface McpApiDeps {
      * returns a typed `setup_required` result instead of calling the model.
      */
     aiGenerateText?: (args: AiGenerateTextArgs) => Promise<AiGenerateTextResult | SetupRequiredResult>;
+    /**
+     * Directory holding mission artifacts (the logs root in production): the typed
+     * `<id>.result.json` files `get_mission_result` reads. A missing dir is a config refusal.
+     */
+    recordingsDir?: string;
+    /**
+     * Where usability reviews write their artifacts (0.1.0: `~/.jevitate/ux-reports`): a
+     * `usability-<stamp>` result is looked up here after `recordingsDir`.
+     */
+    uxReportsDir?: string;
+    /**
+     * The directories a result id's files may be in, most likely first (production: its dated
+     * `.jevitate/logs/<date>` dir in the project, then `~/.jevitate`, then the 0.1.0 locations).
+     * Replaces `recordingsDir`/`uxReportsDir` for the lookup when given.
+     */
+    resultDirsFor?: (resultId: string) => string[];
+    /**
+     * Test seam. Defaults to `runVerifyFix` over `<recordingsDir>/<id>.result.json`: replays the
+     * finding's repro in a fresh browser (authorized against the mission's own allowlist).
+     */
+    verifyFix?: (args: McpVerifyFixArgs) => Promise<VerifyFixReport>;
+    /**
+     * The serving build's identity (#112) — reported by `initialize` (`serverInfo.version`) and by
+     * `get_site_health`. Defaults to this build's `currentEngineInfo()`.
+     */
+    engine?: EngineInfo;
 }
 /**
  * Builds the served tool descriptors — EXACTLY one per `ALLOWED_TOOLS` entry.