agentic-engineering-harness 0.6.4 → 0.6.6

package/dist/main.js

@@ -0,0 +1,266 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import path from "node:path";
+import process from "node:process";
+import { loadProjectConfig } from "./core/config.js";
+import { cancelOperation, executeOperation, startDetachedOperation, waitForOperation } from "./operations/controller.js";
+import { promoteInteractiveOperation } from "./operations/interactive.js";
+import { serveOperationMcp } from "./operations/mcp.js";
+import { loadOperation } from "./operations/state.js";
+import { listManagedPaseoAgents } from "./paseo/runtime.js";
+import { planSelfCheckoutRuntime, resolveStartProjectRoot } from "./runtime/invocation.js";
+import { VERSION } from "./version.js";
+const args = process.argv.slice(2);
+if (args[0] === "start") {
+    const root = resolveStartProjectRoot(args.slice(1));
+    if (await relaunchSelfCheckoutIfNeeded(root))
+        process.exit(process.exitCode ?? 0);
+    console.log(`aehRuntime=${VERSION}`);
+    console.log(`aehEntry=${path.resolve(process.argv[1])}`);
+}
+const promotion = promoteInteractiveOperation(args);
+if (promotion) {
+    console.log(`interactivePromotion=detached-${promotion.kind}`);
+    await runOperationStart(promotion.operationArgv);
+    process.exit(process.exitCode ?? 0);
+}
+if (args[0] === "operation") {
+    await runOperationCommand(args.slice(1));
+    process.exit(process.exitCode ?? 0);
+}
+if (args[0] === "paseo" && args[1] === "agents" && hasOperationFilter(args.slice(2))) {
+    await runOperationAwarePaseoAgents(args.slice(2));
+    process.exit(process.exitCode ?? 0);
+}
+if (args.length === 1 && ["--help", "-h"].includes(args[0]))
+    printControlPlaneHelp();
+await import("./entry.js");
+async function relaunchSelfCheckoutIfNeeded(root) {
+    if (process.env.AEH_SELF_REEXEC === "1")
+        return false;
+    const plan = await planSelfCheckoutRuntime(root, process.argv[1]);
+    if (!plan.shouldRelaunch)
+        return false;
+    if (!plan.localEntryReady) {
+        throw new Error(`AEH source checkout detected at ${root}, but ${plan.localEntry} is not built. ` +
+            "Run 'npm ci && npm run build', then start with 'npm run aeh -- start'. " +
+            "Refusing to create a lead from an external/npm-exec runtime because it can be stale.");
+    }
+    console.log(`aehRuntimeRedirect=${plan.currentEntry} -> ${plan.localEntry}`);
+    const exitCode = await spawnAndWait(process.execPath, [plan.localEntry, ...args], {
+        cwd: root,
+        env: { ...process.env, AEH_SELF_REEXEC: "1" }
+    });
+    process.exitCode = exitCode;
+    return true;
+}
+function spawnAndWait(command, argv, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, argv, { cwd: options.cwd, env: options.env, stdio: "inherit" });
+        child.once("error", reject);
+        child.once("close", (code, signal) => {
+            if (signal)
+                return resolve(1);
+            resolve(code ?? 1);
+        });
+    });
+}
+async function runOperationCommand(argv) {
+    const sub = argv[0];
+    if (sub === "start")
+        return runOperationStart(argv.slice(1));
+    if (sub === "execute")
+        return runOperationExecute(argv.slice(1));
+    if (sub === "status")
+        return runOperationStatus(argv.slice(1));
+    if (sub === "wait")
+        return runOperationWait(argv.slice(1));
+    if (sub === "cancel")
+        return runOperationCancel(argv.slice(1));
+    if (sub === "mcp")
+        return serveOperationMcp();
+    throw new Error("aeh operation requires start, status, wait, cancel, mcp, or internal execute.");
+}
+async function runOperationStart(argv) {
+    const kind = argv[0];
+    if (kind !== "audit" && kind !== "run")
+        throw new Error("aeh operation start requires audit or run.");
+    const parsed = parseFlags(argv.slice(1), new Set(kind === "audit" ? ["file", "domain", "risk", "reviewer"] : ["profile"]), new Set());
+    const subject = parsed.positional[0];
+    if (!subject)
+        throw new Error(`aeh operation start ${kind} requires ${kind === "audit" ? "<request>" : "<taskId>"}.`);
+    if (parsed.positional.length > 2)
+        throw new Error(`aeh operation start ${kind} accepts a subject and at most one project directory.`);
+    const root = path.resolve(parsed.positional[1] ?? ".");
+    await loadProjectConfig(root);
+    const payload = kind === "audit"
+        ? {
+            request: subject,
+            files: parsed.values("file"),
+            domains: parsed.values("domain"),
+            risk: parseRisk(parsed.value("risk")),
+            reviewers: parsed.values("reviewer")
+        }
+        : { taskId: subject, profile: parsed.value("profile") };
+    const record = await startDetachedOperation(root, kind, payload, {
+        nodeExecutable: process.execPath,
+        entryFile: path.resolve(process.argv[1])
+    });
+    printOperation(record, false);
+}
+async function runOperationExecute(argv) {
+    const operationId = argv[0];
+    if (!operationId)
+        throw new Error("aeh operation execute requires <operationId>.");
+    if (argv.length > 2)
+        throw new Error("aeh operation execute accepts <operationId> and at most one project directory.");
+    const root = path.resolve(argv[1] ?? ".");
+    const record = await executeOperation(root, operationId);
+    if (record.status === "FAILED")
+        process.exitCode = 1;
+}
+async function runOperationStatus(argv) {
+    const parsed = parseFlags(argv, new Set(), new Set(["json"]));
+    const operationId = parsed.positional[0];
+    if (!operationId)
+        throw new Error("aeh operation status requires <operationId>.");
+    if (parsed.positional.length > 2)
+        throw new Error("aeh operation status accepts <operationId> and at most one project directory.");
+    printOperation(await loadOperation(path.resolve(parsed.positional[1] ?? "."), operationId), parsed.flag("json"));
+}
+async function runOperationWait(argv) {
+    const parsed = parseFlags(argv, new Set(["timeout"]), new Set(["json"]));
+    const operationId = parsed.positional[0];
+    if (!operationId)
+        throw new Error("aeh operation wait requires <operationId>.");
+    if (parsed.positional.length > 2)
+        throw new Error("aeh operation wait accepts <operationId> and at most one project directory.");
+    const timeoutSeconds = Number(parsed.value("timeout") ?? "1800");
+    if (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0)
+        throw new Error("--timeout must be a positive number of seconds.");
+    const record = await waitForOperation(path.resolve(parsed.positional[1] ?? "."), operationId, timeoutSeconds * 1000);
+    printOperation(record, parsed.flag("json"));
+    if (record.status === "FAILED")
+        process.exitCode = 1;
+    if (record.status === "CANCELLED")
+        process.exitCode = 130;
+}
+async function runOperationCancel(argv) {
+    if (!argv[0])
+        throw new Error("aeh operation cancel requires <operationId>.");
+    if (argv.length > 2)
+        throw new Error("aeh operation cancel accepts <operationId> and at most one project directory.");
+    printOperation(await cancelOperation(path.resolve(argv[1] ?? "."), argv[0]), false);
+}
+async function runOperationAwarePaseoAgents(argv) {
+    const parsed = parseFlags(argv, new Set(["task", "role", "kind", "status", "operation", "operation-kind", "phase"]), new Set(["json"]));
+    if (parsed.positional.length > 1)
+        throw new Error("aeh paseo agents accepts at most one project directory.");
+    const root = path.resolve(parsed.positional[0] ?? ".");
+    const config = await loadProjectConfig(root);
+    const labels = { "aeh.project": config.project.name };
+    for (const [flag, label] of [
+        ["task", "aeh.task"],
+        ["role", "aeh.role"],
+        ["kind", "aeh.kind"],
+        ["operation", "aeh.operation"],
+        ["operation-kind", "aeh.operation.kind"],
+        ["phase", "aeh.operation.phase"]
+    ])
+        if (parsed.value(flag))
+            labels[label] = parsed.value(flag);
+    const requestedStatus = parsed.value("status");
+    const agents = (await listManagedPaseoAgents(root, labels)).filter((agent) => !requestedStatus || agent.status === requestedStatus);
+    const view = agents.map((agent) => ({
+        id: agent.id,
+        status: agent.status ?? "unknown",
+        title: agent.title,
+        workspaceId: agent.workspaceId,
+        role: agent.labels?.["aeh.role"],
+        task: agent.labels?.["aeh.task"],
+        kind: agent.labels?.["aeh.kind"],
+        operation: agent.labels?.["aeh.operation"],
+        operationKind: agent.labels?.["aeh.operation.kind"],
+        phase: agent.labels?.["aeh.operation.phase"],
+        workspaceKind: agent.labels?.["aeh.workspace.kind"],
+        labels: agent.labels
+    }));
+    if (parsed.flag("json")) {
+        console.log(JSON.stringify(view, null, 2));
+        return;
+    }
+    if (!view.length) {
+        console.log("No matching active AEH Paseo agents.");
+        return;
+    }
+    for (const agent of view)
+        console.log(`${agent.status.padEnd(12)} role=${(agent.role ?? "-").padEnd(24)} op=${(agent.operation ?? "-").padEnd(30)} phase=${(agent.phase ?? "-").padEnd(14)} task=${(agent.task ?? "-").padEnd(24)} id=${agent.id}${agent.title ? ` title=${agent.title}` : ""}`);
+}
+function printOperation(record, json) {
+    if (json) {
+        console.log(JSON.stringify(record, null, 2));
+        return;
+    }
+    console.log(`operationId=${record.id}`);
+    console.log(`kind=${record.kind}`);
+    console.log(`status=${record.status}`);
+    console.log(`phase=${record.phase}`);
+    if (record.workspaceId)
+        console.log(`workspaceId=${record.workspaceId}`);
+    if (record.workspaceWarning)
+        console.log(`workspaceWarning=${record.workspaceWarning}`);
+    if (record.error)
+        console.log(`error=${record.error.split("\n", 1)[0]}`);
+    if (record.result)
+        console.log(`result=${JSON.stringify(record.result)}`);
+}
+function printControlPlaneHelp() {
+    console.log("AEH control-plane commands (in addition to the core command tree below):");
+    console.log("  start [directory]                              Start a fresh managed Paseo lead");
+    console.log("  context guard [directory]                     Inspect managed-lead context pressure");
+    console.log("  intent <request> [directory]                  Classify INFORMATIONAL/AUDIT/CHANGE intent");
+    console.log("  audit <request> [directory]                   Synchronous audit compatibility entrypoint");
+    console.log("  operation start audit|run ...                 Start a detached first-class operation");
+    console.log("  operation status|wait|cancel <operationId>    Observe/control a detached operation");
+    console.log("  paseo agents [directory]                      Inspect AEH-managed Paseo agents");
+    console.log("  setup [directory]                             Reconcile the managed engineering toolchain");
+    console.log("  spec prepare|compile ...                      OpenSpec-backed SPEC authoring bridge");
+    console.log("");
+}
+function hasOperationFilter(argv) { return argv.some((value) => value === "--operation" || value === "--operation-kind" || value === "--phase"); }
+function parseRisk(value) { if (!value)
+    return undefined; if (value === "low" || value === "medium" || value === "high")
+    return value; throw new Error(`Invalid risk '${value}'. Use low, medium or high.`); }
+function parseFlags(argv, valueFlags, booleanFlags) {
+    const flags = new Map();
+    const positional = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const token = argv[i];
+        if (!token.startsWith("--")) {
+            positional.push(token);
+            continue;
+        }
+        const name = token.slice(2);
+        if (valueFlags.has(name)) {
+            const next = argv[++i];
+            if (!next || next.startsWith("--"))
+                throw new Error(`--${name} requires a value.`);
+            const list = flags.get(name) ?? [];
+            list.push(next);
+            flags.set(name, list);
+            continue;
+        }
+        if (!booleanFlags.has(name))
+            throw new Error(`Unknown option --${name}.`);
+        const list = flags.get(name) ?? [];
+        list.push(true);
+        flags.set(name, list);
+    }
+    return {
+        positional,
+        flag: (name) => flags.get(name)?.includes(true) ?? false,
+        value: (name) => flags.get(name)?.find((item) => typeof item === "string"),
+        values: (name) => (flags.get(name) ?? []).filter((item) => typeof item === "string")
+    };
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/operations/controller.d.ts

@@ -0,0 +1,17 @@
+import { spawn } from "node:child_process";
+import { runProcess } from "../utils/process.js";
+import { type OperationKind, type OperationPayload, type OperationRecord } from "./state.js";
+export interface StartOperationOptions {
+    nodeExecutable: string;
+    entryFile: string;
+    spawnProcess?: typeof spawn;
+}
+export interface OperationControllerDeps {
+    run?: typeof runProcess;
+}
+export declare function startDetachedOperation(root: string, kind: OperationKind, payload: OperationPayload, options: StartOperationOptions): Promise<OperationRecord>;
+export declare function executeOperation(root: string, operationId: string, deps?: OperationControllerDeps): Promise<OperationRecord>;
+export declare function waitForOperation(root: string, operationId: string, timeoutMs?: number, pollMs?: number): Promise<OperationRecord>;
+export declare function cancelOperation(root: string, operationId: string): Promise<OperationRecord>;
+export declare function createOperationId(kind: OperationKind, seed: string): string;
+export declare function extractWorkspaceId(text: string): string | undefined;

package/dist/operations/controller.js

@@ -0,0 +1,198 @@
+import crypto from "node:crypto";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import process from "node:process";
+import { runAudit } from "../audit/run.js";
+import { loadProjectConfig, loadTaskContract } from "../core/config.js";
+import { runTask } from "../core/run.js";
+import { listManagedPaseoAgents } from "../paseo/runtime.js";
+import { runProcess } from "../utils/process.js";
+import { loadOperation, patchOperation, saveOperation } from "./state.js";
+export async function startDetachedOperation(root, kind, payload, options) {
+    const absoluteRoot = path.resolve(root);
+    const now = new Date().toISOString();
+    const id = createOperationId(kind, JSON.stringify(payload));
+    const record = {
+        version: 1,
+        id,
+        kind,
+        status: "QUEUED",
+        phase: "queued",
+        root: absoluteRoot,
+        payload,
+        createdAt: now,
+        updatedAt: now
+    };
+    await saveOperation(absoluteRoot, record);
+    const spawnProcess = options.spawnProcess ?? spawn;
+    let child;
+    try {
+        child = spawnProcess(options.nodeExecutable, [options.entryFile, "operation", "execute", id, absoluteRoot], {
+            cwd: absoluteRoot,
+            detached: true,
+            stdio: "ignore",
+            env: {
+                ...process.env,
+                AEH_OPERATION_ID: id,
+                AEH_OPERATION_KIND: kind
+            }
+        });
+    }
+    catch (error) {
+        return patchOperation(absoluteRoot, id, { status: "FAILED", phase: "spawn-failed", error: String(error), finishedAt: new Date().toISOString() });
+    }
+    child.unref();
+    return patchOperation(absoluteRoot, id, { pid: child.pid, phase: "dispatched" });
+}
+export async function executeOperation(root, operationId, deps = {}) {
+    const absoluteRoot = path.resolve(root);
+    let record = await loadOperation(absoluteRoot, operationId);
+    if (record.status === "CANCELLED")
+        return record;
+    record = await patchOperation(absoluteRoot, operationId, { status: "RUNNING", phase: "preparing", startedAt: new Date().toISOString(), pid: process.pid, error: undefined });
+    process.env.AEH_OPERATION_ID = record.id;
+    process.env.AEH_OPERATION_KIND = record.kind;
+    const workspace = await ensureOperationWorkspace(absoluteRoot, record, deps.run ?? runProcess);
+    if (workspace.workspaceId) {
+        process.env.AEH_OPERATION_WORKSPACE_ID = workspace.workspaceId;
+        record = await patchOperation(absoluteRoot, operationId, { workspaceId: workspace.workspaceId, workspaceWarning: undefined });
+    }
+    else if (workspace.warning) {
+        record = await patchOperation(absoluteRoot, operationId, { workspaceWarning: workspace.warning });
+    }
+    try {
+        const config = await loadProjectConfig(absoluteRoot);
+        if (record.kind === "audit") {
+            const payload = record.payload;
+            const report = await runAudit(absoluteRoot, config, { ...payload, auditId: record.id });
+            const current = await loadOperation(absoluteRoot, operationId);
+            if (current.status === "CANCELLED")
+                return current;
+            return patchOperation(absoluteRoot, operationId, {
+                status: "SUCCEEDED",
+                phase: "finished",
+                finishedAt: new Date().toISOString(),
+                result: { auditId: report.auditId, status: report.status, productionSafe: report.productionSafe, report: `.harness/audits/${report.auditId}.json` }
+            });
+        }
+        const payload = record.payload;
+        const contract = await loadTaskContract(absoluteRoot, payload.taskId, config);
+        const result = await runTask(absoluteRoot, config, contract, { profile: payload.profile });
+        const current = await loadOperation(absoluteRoot, operationId);
+        if (current.status === "CANCELLED")
+            return current;
+        return patchOperation(absoluteRoot, operationId, {
+            status: result.status === "PASS" ? "SUCCEEDED" : "FAILED",
+            phase: "finished",
+            finishedAt: new Date().toISOString(),
+            result: { taskId: result.taskId, status: result.status, attempts: result.attempts }
+        });
+    }
+    catch (error) {
+        const current = await loadOperation(absoluteRoot, operationId).catch(() => record);
+        if (current.status === "CANCELLED")
+            return current;
+        return patchOperation(absoluteRoot, operationId, { status: "FAILED", phase: "failed", error: error instanceof Error ? error.stack ?? error.message : String(error), finishedAt: new Date().toISOString() });
+    }
+}
+export async function waitForOperation(root, operationId, timeoutMs = 1_800_000, pollMs = 500) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        const record = await loadOperation(root, operationId);
+        if (isTerminal(record.status))
+            return record;
+        if (Date.now() >= deadline)
+            throw new Error(`Timed out waiting for operation ${operationId} after ${timeoutMs}ms.`);
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+    }
+}
+export async function cancelOperation(root, operationId) {
+    const absoluteRoot = path.resolve(root);
+    const record = await loadOperation(absoluteRoot, operationId);
+    if (isTerminal(record.status))
+        return record;
+    const cleanupWarnings = [];
+    if (record.pid && record.pid !== process.pid) {
+        try {
+            process.kill(record.pid, "SIGTERM");
+        }
+        catch (error) {
+            if (!/ESRCH/.test(String(error)))
+                cleanupWarnings.push(`controller: ${String(error)}`);
+        }
+    }
+    try {
+        const agents = await listManagedPaseoAgents(absoluteRoot, { "aeh.operation": operationId });
+        for (const agent of agents) {
+            const stopped = await runProcess(`paseo agent stop ${quote(agent.id)}`, { cwd: absoluteRoot, timeoutMs: 30_000 }).catch((error) => ({ exitCode: 1, stdout: "", stderr: String(error), durationMs: 0 }));
+            if (stopped.exitCode !== 0)
+                cleanupWarnings.push(`agent ${agent.id}: ${stopped.stderr || stopped.stdout || `exit ${stopped.exitCode}`}`);
+        }
+    }
+    catch (error) {
+        cleanupWarnings.push(`agent discovery: ${String(error)}`);
+    }
+    return patchOperation(absoluteRoot, operationId, {
+        status: "CANCELLED",
+        phase: "cancelled",
+        finishedAt: new Date().toISOString(),
+        cleanupWarnings: cleanupWarnings.length ? cleanupWarnings : undefined
+    });
+}
+export function createOperationId(kind, seed) {
+    const stamp = new Date().toISOString().replace(/[-:]/g, "").replace(/\.\d{3}Z$/, "Z");
+    const hash = crypto.createHash("sha256").update(seed).digest("hex").slice(0, 8);
+    return `${kind.toUpperCase()}-${stamp}-${hash}`;
+}
+async function ensureOperationWorkspace(root, record, run) {
+    const title = `AEH ${record.kind.toUpperCase()} · ${record.id}`;
+    const command = `paseo workspace create --isolation local --path ${quote(root)} --title ${quote(title)} --json`;
+    let result;
+    try {
+        result = await run(command, { cwd: root, timeoutMs: 60_000 });
+    }
+    catch (error) {
+        return { warning: `Paseo operation workspace could not be created: ${String(error)}` };
+    }
+    if (result.exitCode !== 0)
+        return { warning: `Paseo operation workspace could not be created: ${result.stderr || result.stdout || `exit ${result.exitCode}`}` };
+    const workspaceId = extractWorkspaceId(result.stdout);
+    return workspaceId ? { workspaceId } : { warning: "Paseo created an operation workspace but AEH could not resolve its id." };
+}
+export function extractWorkspaceId(text) {
+    if (!text.trim())
+        return undefined;
+    try {
+        return findWorkspaceId(JSON.parse(text));
+    }
+    catch {
+        return text.match(/\b(?:workspace(?:Id)?[=: ]+)?(workspace-[A-Za-z0-9._-]+)\b/i)?.[1];
+    }
+}
+function findWorkspaceId(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const id = findWorkspaceId(item);
+            if (id)
+                return id;
+        }
+        return undefined;
+    }
+    const record = value;
+    for (const key of ["workspaceId", "workspace_id", "id"]) {
+        const candidate = record[key];
+        if (typeof candidate === "string" && candidate && (key !== "id" || /workspace/i.test(candidate) || "cwd" in record || "worktreePath" in record || "path" in record))
+            return candidate;
+    }
+    for (const child of Object.values(record)) {
+        const id = findWorkspaceId(child);
+        if (id)
+            return id;
+    }
+    return undefined;
+}
+function isTerminal(status) { return status === "SUCCEEDED" || status === "FAILED" || status === "CANCELLED"; }
+function quote(value) { return `'${value.replaceAll("'", "'\\''")}'`; }
+//# sourceMappingURL=controller.js.map

package/dist/operations/controller.js.map

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

package/dist/operations/interactive.d.ts

@@ -0,0 +1,5 @@
+export interface InteractiveOperationPromotion {
+    kind: "audit" | "run";
+    operationArgv: string[];
+}
+export declare function promoteInteractiveOperation(argv: string[], env?: NodeJS.ProcessEnv): InteractiveOperationPromotion | undefined;

package/dist/operations/interactive.js

@@ -0,0 +1,45 @@
+export function promoteInteractiveOperation(argv, env = process.env) {
+    if (!env.PASEO_AGENT_ID?.trim() || env.AEH_ALLOW_SYNC_INTERACTIVE === "1")
+        return undefined;
+    if (argv[0] === "audit") {
+        return { kind: "audit", operationArgv: ["audit", ...argv.slice(1)] };
+    }
+    if (argv[0] === "run") {
+        return { kind: "run", operationArgv: translateRun(argv.slice(1)) };
+    }
+    return undefined;
+}
+function translateRun(argv) {
+    const positional = [];
+    let profile;
+    for (let index = 0; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === "--profile") {
+            const value = argv[++index];
+            if (!value || value.startsWith("--"))
+                throw new Error("Interactive aeh run --profile requires a value.");
+            profile = value;
+            continue;
+        }
+        if (token.startsWith("--")) {
+            throw new Error(`Managed Paseo leads cannot execute synchronous 'aeh run' option ${token}. ` +
+                "Prepare/import the task first, then use 'aeh operation start run <taskId>'. " +
+                "Set AEH_ALLOW_SYNC_INTERACTIVE=1 only for an explicit compatibility or recovery flow.");
+        }
+        positional.push(token);
+    }
+    const taskId = positional[0];
+    if (!taskId) {
+        throw new Error("Managed Paseo leads cannot execute a synchronous bare 'aeh run'. " +
+            "Use a prepared/sealed task id so AEH can start a detached operation.");
+    }
+    if (positional.length > 2)
+        throw new Error("Interactive aeh run accepts <taskId> and at most one project directory.");
+    const operationArgv = ["run", taskId];
+    if (positional[1])
+        operationArgv.push(positional[1]);
+    if (profile)
+        operationArgv.push("--profile", profile);
+    return operationArgv;
+}
+//# sourceMappingURL=interactive.js.map

package/dist/operations/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../src/operations/interactive.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,2BAA2B,CACzC,IAAc,EACd,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,0BAA0B,KAAK,GAAG;QAAE,OAAO,SAAS,CAAC;IAE5F,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,IAAc;IAClC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,OAA2B,CAAC;IAEhC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACzG,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,mEAAmE,KAAK,IAAI;gBAC5E,8EAA8E;gBAC9E,uFAAuF,CACxF,CAAC;QACJ,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,mEAAmE;YACnE,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAEtH,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtC,IAAI,UAAU,CAAC,CAAC,CAAC;QAAE,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO;QAAE,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/operations/mcp.d.ts

@@ -0,0 +1 @@
+export declare function serveOperationMcp(): Promise<void>;