inferoa 0.1.0

package/dist/src/cli.js

@@ -0,0 +1,415 @@
+#!/usr/bin/env node
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { loadApp } from "./app.js";
+import { userConfigPath } from "./config/config.js";
+import { DEFAULT_CONFIG } from "./config/defaults.js";
+import { TuiApp } from "./tui/app.js";
+import { EndpointSignals } from "./model/endpoint-signals.js";
+import { SkillRegistry } from "./skills/registry.js";
+import { ToolRegistry } from "./tools/registry.js";
+import { randomId } from "./util/hash.js";
+import { ensureDir } from "./util/fs.js";
+import { fail } from "./util/limit.js";
+import { attachDaemonJob, cancelDaemonJob, daemonStatus, detachDaemonJob, queueDaemonRun, startDaemon, } from "./daemon/supervisor.js";
+import { runFinalAcceptance } from "./validation/acceptance.js";
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    if (parsed.help) {
+        printHelp();
+        return;
+    }
+    if (parsed.debug) {
+        await runDebug(parsed);
+        return;
+    }
+    if (parsed.print) {
+        await runPrint(parsed);
+        return;
+    }
+    const app = await loadApp(parsed);
+    try {
+        await new TuiApp(app, {
+            initialPrompt: parsed.prompt,
+            initialView: parsed.initialView,
+            stateDir: parsed.stateDir,
+            noAnimation: parsed.noAnimation,
+        }).run();
+    }
+    finally {
+        closeApp(app);
+    }
+}
+function closeApp(app) {
+    app.runtime.dispose();
+    app.store.close();
+}
+function parseArgs(argv) {
+    const parsed = {};
+    const prompt = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            parsed.help = true;
+            continue;
+        }
+        if (arg === "--config") {
+            parsed.config = requiredValue(argv, ++i, arg);
+            continue;
+        }
+        if (arg === "--workspace") {
+            parsed.workspace = requiredValue(argv, ++i, arg);
+            continue;
+        }
+        if (arg === "--state-dir") {
+            parsed.stateDir = requiredValue(argv, ++i, arg);
+            continue;
+        }
+        if (arg === "--json") {
+            parsed.json = true;
+            continue;
+        }
+        if (arg === "--print" || arg === "-p") {
+            parsed.print = true;
+            continue;
+        }
+        if (arg === "--no-animation") {
+            parsed.noAnimation = true;
+            continue;
+        }
+        if (arg === "debug") {
+            const rest = argv.slice(i + 1);
+            parsed.json = parsed.json || rest.includes("--json");
+            parsed.debug = rest.filter((item) => item !== "--json");
+            break;
+        }
+        if (arg === "setup" && prompt.length === 0) {
+            parsed.initialView = "setup";
+            continue;
+        }
+        prompt.push(arg, ...argv.slice(i + 1));
+        break;
+    }
+    parsed.prompt = prompt.join(" ").trim() || undefined;
+    return parsed;
+}
+function requiredValue(argv, index, flag) {
+    const value = argv[index];
+    if (!value) {
+        throw new Error(`${flag} requires a value`);
+    }
+    return value;
+}
+function printHelp() {
+    console.log(`Inferoa
+
+Usage:
+  inferoa                         Launch the TUI
+  inferoa "prompt"                Launch the TUI and submit an initial prompt
+  inferoa setup                   Launch the TUI setup wizard
+  inferoa --print "prompt"        Non-interactive print mode
+  inferoa debug <command>         Machine/debug commands
+
+Options:
+  --config <path>                    Config YAML path
+  --workspace <path>                 Workspace root
+  --state-dir <path>                 State directory, defaults to ~/.inferoa
+  --json                             JSON output for debug commands
+  --no-animation                     Disable TUI intro animation
+
+TUI commands:
+  /setup /model /system /skills /cache /context /tools /sessions /jobs
+  /todo /activity /acceptance /help /clear /exit
+  $                                  Open skill catalog
+
+Debug commands:
+  init [--force]                    Write ~/.inferoa/config.yaml
+  setup
+  status
+  sessions
+  tools list
+  tools call <name> [json]
+  events <session> [limit]
+  archive <session>
+  daemon start|status|jobs|run|attach|detach|cancel ...
+  acceptance [--daemon]
+`);
+}
+async function runPrint(options) {
+    if (!options.prompt) {
+        throw new Error("--print requires a prompt");
+    }
+    const app = await loadApp(options);
+    try {
+        const result = await app.runtime.run({
+            prompt: options.prompt,
+            client_id: randomId("print"),
+            onDelta: options.json ? undefined : (text) => process.stdout.write(text),
+        });
+        if (!options.json) {
+            process.stdout.write("\n");
+        }
+        print({
+            session: publicSession(result.session),
+            content: result.content,
+            tool_rounds: result.tool_rounds,
+            tool_calls: result.tool_calls,
+            duration_ms: result.duration_ms,
+            tokens_used: result.tokens_used,
+            goal_report: result.goal_report,
+        }, options.json);
+    }
+    finally {
+        closeApp(app);
+    }
+}
+async function runDebug(options) {
+    const [command, ...rest] = options.debug ?? [];
+    if (!command) {
+        printHelp();
+        return;
+    }
+    switch (command) {
+        case "init":
+            await debugInit(options, rest.includes("--force"));
+            return;
+        case "setup":
+            await debugSetup(options);
+            return;
+        case "status":
+            await debugStatus(options);
+            return;
+        case "sessions":
+            await debugSessions(options);
+            return;
+        case "tools":
+            await debugTools(options, rest);
+            return;
+        case "events":
+            await debugEvents(options, rest);
+            return;
+        case "archive":
+            await debugArchive(options, rest);
+            return;
+        case "daemon":
+            await debugDaemon(options, rest);
+            return;
+        case "acceptance":
+            await debugAcceptance(options, rest);
+            return;
+        default:
+            throw new Error(`Unknown debug command: ${command}`);
+    }
+}
+async function debugInit(options, force) {
+    if (options.stateDir) {
+        process.env.INFEROA_STATE_DIR = options.stateDir;
+    }
+    const target = userConfigPath();
+    await ensureDir(path.dirname(target));
+    try {
+        await fs.access(target);
+        if (!force) {
+            throw new Error(`Config already exists: ${target}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    await fs.writeFile(target, YAML.stringify(DEFAULT_CONFIG), "utf8");
+    console.log(`Wrote ${target}`);
+}
+async function debugSetup(options) {
+    const app = await loadApp(options);
+    try {
+        const signals = new EndpointSignals(app.config);
+        const skills = new SkillRegistry(app.workspace, app.config);
+        print({
+            workspace: { root: app.workspace.root, alias: app.workspace.alias },
+            config_files: app.configFiles,
+            model_setup: redactSecretFields(app.config.model_setup),
+            endpoint_signals: await signals.snapshot(),
+            skills: await skills.discover(),
+        }, options.json);
+    }
+    finally {
+        closeApp(app);
+    }
+}
+async function debugStatus(options) {
+    const app = await loadApp(options);
+    try {
+        print({ ...(await app.runtime.status()), sessions: app.store.listSessions(app.workspace.id).map(publicSession) }, options.json);
+    }
+    finally {
+        closeApp(app);
+    }
+}
+async function debugSessions(options) {
+    const app = await loadApp(options);
+    try {
+        print({
+            workspace: { root: app.workspace.root, alias: app.workspace.alias },
+            sessions: app.store.listSessions(app.workspace.id).map(publicSession),
+        }, options.json);
+    }
+    finally {
+        closeApp(app);
+    }
+}
+async function debugTools(options, rest) {
+    const [subcommand, name, json] = rest;
+    const app = await loadApp(options);
+    try {
+        const registry = new ToolRegistry(app.config, app.workspace, app.store);
+        if (subcommand === "list" || !subcommand) {
+            print({ tools: registry.list() }, options.json);
+            return;
+        }
+        if (subcommand !== "call" || !name) {
+            throw new Error("Usage: inferoa debug tools call <name> [json]");
+        }
+        const session = app.store.createSession(app.workspace, `tool:${name}`);
+        const args = json ? JSON.parse(json) : {};
+        const result = await registry.call({ id: randomId("tc"), name, arguments: args }, {
+            session_id: session.session_id,
+            run_id: randomId("run"),
+        });
+        print({ session: publicSession(session), result }, options.json);
+    }
+    finally {
+        closeApp(app);
+    }
+}
+async function debugEvents(options, rest) {
+    const [sessionPrefix, limit = "50"] = rest;
+    if (!sessionPrefix) {
+        throw new Error("Usage: inferoa debug events <session> [limit]");
+    }
+    const app = await loadApp(options);
+    try {
+        const session = app.store.findSessionByPrefix(app.workspace.id, sessionPrefix);
+        if (!session) {
+            throw new Error(`No session matches ${sessionPrefix}`);
+        }
+        print({ session: publicSession(session), events: app.store.listEvents(session.session_id, Number(limit)) }, options.json);
+    }
+    finally {
+        closeApp(app);
+    }
+}
+async function debugArchive(options, rest) {
+    const [sessionPrefix] = rest;
+    if (!sessionPrefix) {
+        throw new Error("Usage: inferoa debug archive <session>");
+    }
+    const app = await loadApp(options);
+    try {
+        const session = app.store.findSessionByPrefix(app.workspace.id, sessionPrefix);
+        if (!session) {
+            throw new Error(`No session matches ${sessionPrefix}`);
+        }
+        app.store.appendEvent({ session_id: session.session_id, type: "session.archived", data: { reason: "debug archive" } });
+        app.store.updateSession(session.session_id, { status: "archived" });
+        const archived = app.store.getSession(session.session_id);
+        print({ session: archived ? publicSession(archived) : undefined }, options.json);
+    }
+    finally {
+        closeApp(app);
+    }
+}
+async function debugDaemon(options, rest) {
+    const [subcommand, ...args] = rest;
+    switch (subcommand) {
+        case "start":
+            print(await startDaemon({ stateDir: options.stateDir, foreground: args.includes("--foreground") }), options.json);
+            return;
+        case "status":
+            print(await daemonStatus(options.stateDir), options.json);
+            return;
+        case "jobs": {
+            const status = await daemonStatus(options.stateDir);
+            print({ jobs: status.jobs }, options.json);
+            return;
+        }
+        case "run": {
+            const prompt = args.join(" ");
+            const app = await loadApp(options);
+            try {
+                const job = await queueDaemonRun({ stateDir: options.stateDir, workspaceRoot: app.workspace.root, prompt });
+                const status = await startDaemon({ stateDir: options.stateDir });
+                print({ job, daemon: status }, options.json);
+            }
+            finally {
+                closeApp(app);
+            }
+            return;
+        }
+        case "attach":
+            print(await attachDaemonJob(options.stateDir, requiredArg(args, 0, "job"), { follow: args.includes("--follow") }), options.json);
+            return;
+        case "detach":
+            print(await detachDaemonJob(options.stateDir, requiredArg(args, 0, "job")), options.json);
+            return;
+        case "cancel":
+            print(await cancelDaemonJob(options.stateDir, requiredArg(args, 0, "job")), options.json);
+            return;
+        default:
+            throw new Error("Usage: inferoa debug daemon start|status|jobs|run|attach|detach|cancel ...");
+    }
+}
+async function debugAcceptance(options, rest) {
+    const result = await runFinalAcceptance({
+        workspaceRoot: path.resolve(options.workspace ?? process.cwd()),
+        stateDir: options.stateDir,
+        configPath: options.config,
+        daemon: rest.includes("--daemon"),
+    });
+    print(result, options.json);
+    if (!result.ok) {
+        process.exitCode = 1;
+    }
+}
+function requiredArg(args, index, name) {
+    const value = args[index];
+    if (!value) {
+        throw new Error(`Missing ${name}`);
+    }
+    return value;
+}
+function print(value, json = false) {
+    if (json) {
+        console.log(JSON.stringify(value, null, 2));
+        return;
+    }
+    if (typeof value === "string") {
+        console.log(value);
+        return;
+    }
+    console.log(YAML.stringify(value));
+}
+function publicSession(session) {
+    return {
+        session_id: session.session_id,
+        title: session.title,
+        status: session.status,
+        created_at: session.created_at,
+        updated_at: session.updated_at,
+    };
+}
+function redactSecretFields(value) {
+    const output = {};
+    for (const [key, item] of Object.entries(value)) {
+        output[key] = key.includes("api_key") && typeof item === "string" ? "<redacted>" : item;
+    }
+    return output;
+}
+main().catch((error) => {
+    const result = fail("cli_error", error instanceof Error ? error.message : String(error));
+    console.error(result.summary);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/code-intelligence/codegraph-engine.d.ts

@@ -0,0 +1,55 @@
+import type { JsonObject, ToolDefinition, ToolResult, VllmAgentConfig, WorkspaceIdentity } from "../types.js";
+export type ContextEngineState = "off" | "idle" | "indexing" | "syncing" | "ready" | "degraded";
+export interface ContextEngineStatus {
+    provider: "codegraph" | "builtin" | "off";
+    state: ContextEngineState;
+    phase?: string;
+    current?: number;
+    total?: number;
+    files?: number;
+    nodes?: number;
+    edges?: number;
+    watcher?: "active" | "inactive" | "disabled";
+    languages?: string[];
+    frameworks?: string[];
+    error?: string;
+    reason?: string;
+}
+export interface ContextEngineConfig {
+    provider: "auto" | "codegraph" | "builtin" | "off";
+    startup: "welcome" | "lazy" | "manual";
+    require_ready_before_chat: boolean;
+    watch: boolean;
+}
+export type ContextEngineListener = (status: ContextEngineStatus) => void;
+export declare class CodeGraphContextEngine {
+    private readonly config;
+    private readonly workspace;
+    private active;
+    private cg;
+    private catchUp;
+    private readonly listeners;
+    private statusSnapshot;
+    constructor(config: ContextEngineConfig, workspace: WorkspaceIdentity);
+    dispose(): void;
+    enabled(): boolean;
+    handlesTool(name: string): boolean;
+    onStatus(listener: ContextEngineListener): () => void;
+    requireReadyBeforeChat(): boolean;
+    shouldStartOnWelcome(): boolean;
+    status(): ContextEngineStatus;
+    toolDefinitions(): ToolDefinition[];
+    startIndexing(reason: string, options?: {
+        force?: boolean;
+        signal?: AbortSignal;
+    }): Promise<ContextEngineStatus>;
+    waitUntilReady(reason: string, signal?: AbortSignal): Promise<ContextEngineStatus>;
+    callTool(name: string, args: JsonObject, signal?: AbortSignal): Promise<ToolResult>;
+    private runIndexLifecycle;
+    private refreshReadyStatus;
+    private guardProjectPath;
+    private onProgress;
+    private update;
+    private executeNativeTool;
+}
+export declare function normalizeContextEngineConfig(config: VllmAgentConfig): ContextEngineConfig;