loreforge 0.1.0-alpha.1

package/dist/cli/main.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { openCore, CoreOpenError, parseRequest, validationDetails } from "../core/index.js";
+import { parseCliArgs, CliValidationError, READ_OPERATIONS } from "./args.js";
+import { readBoundedInput, CliInputError } from "./input.js";
+import { handleSuccessOutput, handleErrorOutput } from "./output.js";
+import { generateInstructions } from "./instructions.js";
+import { resolveHomeDir, doesStateExist } from "./home.js";
+import { resolveInitOptions, runInit } from "./init.js";
+import { detectCodingClis } from "./detect.js";
+import { homedir } from "node:os";
+export function printHelp(stdout = process.stdout, topic) {
+    const helpText = (`Loreforge — shared memory for independent agents.
+
+Usage:
+  lore context  --input <file|-> [--home <dir>] [--json]
+  lore handoff  --input <file|-> [--home <dir>] [--json]
+  lore ask      --input <file|-> [--home <dir>] [--json]
+  lore inbox    --input <file|-> [--home <dir>] [--json]
+  lore <namespace> <verb> --input <file|-> [--home <dir>] [--json]
+  lore instructions show --project <uuid> --agent <agent-id> [--home <dir>]
+  lore init [--agent id[:role]]... [--root <git>] [--name <name>] [--write-rules] [--write-user-rules] [--demo] [--detect|--no-detect] [--home <dir>] [--json]
+  lore detect [--json]
+  lore --help
+
+Everyday:
+  context                 Retrieve formatted context (work or review mode)
+  handoff                 Submit a completed or blocked handoff with git evidence
+  ask                     Ask a task-linked question
+  inbox                   List inbox events for an agent
+
+Other operations:
+  project register        Register a git repository as a project
+  agent register          Register an agent identity
+  task create             Create a task
+  task get                Retrieve task details
+  task list               List tasks
+  task claim              Acquire a 2-hour claim lease on an open task
+  task renew              Extend an active claim lease
+  task release            Release a claim back to open
+  task reopen             Reopen a blocked task after questions are answered
+  task cancel             Cancel a task
+  question answer         Answer a pending question
+  decision record         Record an architectural decision
+  instructions show       Print generic session instruction template
+  init                    Register a repo and agents, optional sample tasks and session rules
+  detect                  List local coding CLIs (PATH + config dirs; does not read keys)
+
+Options:
+  --input <file|->        Path to JSON envelope input file or '-' for stdin (max 64 KiB)
+  --home <dir>            State directory (default: LOREFORGE_HOME or ~/.loreforge/context-v1)
+  --json                  Output exactly one JSON response line on stdout
+  --project <uuid>        Project UUID (for instructions show)
+  --agent <id[:role]>     Agent id, optional :implement|:review|:both (repeatable on init)
+  --root <dir>            Git repository root (init)
+  --name <name>           Project display name (init)
+  --write-rules           Init: write repo AGENTS.md / .grok/rules (not ~/.grok)
+  --write-user-rules      Init: also overwrite ~/.grok/rules and ~/.claude/rules
+  --demo                  Init: create two sample tasks
+  --detect / --no-detect  Init: auto-fill agents from local CLIs (default: detect)
+  --help, -h              Show this help message
+`);
+    stdout.write(helpText);
+}
+/**
+ * Main programmatic CLI runner.
+ * Returns the process exit code.
+ */
+export async function runCli(rawArgs, deps = {}) {
+    const stdout = deps.stdout ?? process.stdout;
+    const stderr = deps.stderr ?? process.stderr;
+    const stdin = deps.stdin ?? process.stdin;
+    const env = deps.env ?? process.env;
+    const openCoreImpl = deps.openCoreFn ?? openCore;
+    // 1. Parse CLI arguments
+    let parsed;
+    try {
+        parsed = parseCliArgs(rawArgs);
+    }
+    catch (err) {
+        if (err instanceof CliValidationError) {
+            return handleErrorOutput({ code: "VALIDATION", message: err.message }, rawArgs.includes("--json"), stdout, stderr);
+        }
+        return handleErrorOutput({ code: "INTERNAL", message: err instanceof Error ? err.message : "Argument parsing error" }, rawArgs.includes("--json"), stdout, stderr);
+    }
+    // 2. Handle Help
+    if (parsed.kind === "help") {
+        printHelp(stdout, parsed.topic);
+        return 0;
+    }
+    if (parsed.kind === "detect") {
+        const found = detectCodingClis({
+            path: env.PATH ?? "",
+            home: env.HOME || homedir(),
+            pathext: env.PATHEXT,
+        });
+        if (parsed.json) {
+            stdout.write(`${JSON.stringify({ schemaVersion: 1, ok: true, data: { clis: found } })}\n`);
+        }
+        else if (found.length === 0) {
+            stdout.write("No known coding CLIs found on PATH or in home config dirs.\n");
+        }
+        else {
+            stdout.write("Local CLIs (not a billing check; auth-file means a login file exists):\n");
+            for (const row of found) {
+                stdout.write(`  ${row.id.padEnd(8)} ${row.evidence.join(", ")}\n`);
+            }
+        }
+        return 0;
+    }
+    if (parsed.kind === "init") {
+        try {
+            const resolved = await resolveInitOptions(parsed, stdin, stdout, env.PWD || process.cwd(), env);
+            const result = await runInit(resolved, env);
+            if (parsed.json) {
+                stdout.write(`${JSON.stringify({ schemaVersion: 1, ok: true, data: result })}\n`);
+            }
+            else {
+                stdout.write(`Project ${result.projectId}\nHome ${result.home}\n`);
+                stdout.write(`Agents ${result.agents.map((a) => `${a.id}:${a.role}`).join(", ")}\n`);
+                if (result.taskIds.length > 0)
+                    stdout.write(`Demo tasks ${result.taskIds.join(", ")}\n`);
+                if (result.filesWritten.length > 0) {
+                    stdout.write("Wrote:\n");
+                    for (const file of result.filesWritten)
+                        stdout.write(`  ${file}\n`);
+                }
+                stdout.write("Open each CLI in the git repo and ask what's next. Do not paste a plan.\n");
+            }
+            return 0;
+        }
+        catch (err) {
+            if (err instanceof CliValidationError) {
+                return handleErrorOutput({ code: "VALIDATION", message: err.message }, parsed.json, stdout, stderr);
+            }
+            return handleErrorOutput({ code: "INTERNAL", message: err instanceof Error ? err.message : "Init failed" }, parsed.json, stdout, stderr);
+        }
+    }
+    // 3. Handle Instructions Show
+    if (parsed.kind === "instructions") {
+        try {
+            const homeDir = resolveHomeDir(parsed.home, env);
+            const text = generateInstructions({
+                projectId: parsed.projectId,
+                agentId: parsed.agentId,
+                homeDir
+            });
+            stdout.write(text + "\n");
+            return 0;
+        }
+        catch (err) {
+            if (err instanceof CliValidationError) {
+                return handleErrorOutput({ code: "VALIDATION", message: err.message }, false, stdout, stderr);
+            }
+            return handleErrorOutput({ code: "INTERNAL", message: err instanceof Error ? err.message : "Instructions error" }, false, stdout, stderr);
+        }
+    }
+    // 4. Handle Operation Command
+    const { operation, inputPath, home: explicitHome, json } = parsed;
+    const home = resolveHomeDir(explicitHome, env);
+    // 4a. Read bounded input (enforcing 64 KiB byte limit, UTF-8, JSON shape)
+    let rawPayload;
+    try {
+        rawPayload = await readBoundedInput(inputPath, stdin);
+    }
+    catch (err) {
+        if (err instanceof CliInputError) {
+            return handleErrorOutput({ code: err.code, message: err.message }, json, stdout, stderr);
+        }
+        return handleErrorOutput({ code: "IO", message: err instanceof Error ? err.message : "Input error" }, json, stdout, stderr);
+    }
+    // 4b. Pure validation via parseRequest before opening state
+    const candidateRequest = {
+        ...rawPayload,
+        operation
+    };
+    let request;
+    try {
+        request = parseRequest(candidateRequest);
+    }
+    catch (err) {
+        const details = err instanceof z.ZodError ? validationDetails(err) : undefined;
+        return handleErrorOutput({
+            code: "VALIDATION",
+            message: "Request validation failed: envelope or payload does not conform to schema",
+            details
+        }, json, stdout, stderr);
+    }
+    // 4c. Missing-state guard for read operations:
+    // Missing state on a read returns NOT_FOUND and must NOT create an empty DB.
+    if (READ_OPERATIONS.has(operation) && !doesStateExist(home)) {
+        return handleErrorOutput({
+            code: "NOT_FOUND",
+            message: `Database state does not exist at ${home}`
+        }, json, stdout, stderr);
+    }
+    // 4d. Open core
+    let core;
+    try {
+        core = openCoreImpl({ home });
+    }
+    catch (err) {
+        if (err instanceof CoreOpenError) {
+            return handleErrorOutput({ code: err.code, message: err.message }, json, stdout, stderr);
+        }
+        return handleErrorOutput({
+            code: "IO",
+            message: err instanceof Error ? err.message : "Failed to open state database"
+        }, json, stdout, stderr);
+    }
+    // 4e. Execute request
+    try {
+        const response = await core.execute(request);
+        if (response.ok) {
+            handleSuccessOutput(operation, response, json, stdout);
+            return 0;
+        }
+        else {
+            return handleErrorOutput(response.error, json, stdout, stderr);
+        }
+    }
+    catch (err) {
+        return handleErrorOutput({
+            code: "INTERNAL",
+            message: err instanceof Error ? err.message : "Unexpected internal execution failure"
+        }, json, stdout, stderr);
+    }
+    finally {
+        try {
+            core.close();
+        }
+        catch {
+            // Ignore errors on closing
+        }
+    }
+}
+// Invoke when executed directly as script
+const isDirectExecution = process.argv[1] &&
+    (process.argv[1] === fileURLToPath(import.meta.url) ||
+        process.argv[1].endsWith("/lore") ||
+        process.argv[1].endsWith("/company") ||
+        process.argv[1].endsWith("/main.ts") ||
+        process.argv[1].endsWith("/main.js"));
+if (isDirectExecution) {
+    runCli(process.argv.slice(2)).then((code) => {
+        process.exit(code);
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/output.js

@@ -0,0 +1,108 @@
+import { renderContext } from "../context/render.js";
+export const ERROR_EXIT_CODES = {
+    VALIDATION: 2,
+    NOT_FOUND: 3,
+    CONFLICT: 4,
+    STALE_CLAIM: 5,
+    BUSY: 6,
+    IO: 7,
+    INTERNAL: 1
+};
+/**
+ * Emits output for a successful operation.
+ */
+export function handleSuccessOutput(operation, response, isJson, stdout = process.stdout) {
+    if (isJson) {
+        stdout.write(JSON.stringify(response) + "\n");
+        return;
+    }
+    const data = response.data;
+    if (operation === "context.get" && data.snapshot) {
+        stdout.write(renderContext(data.snapshot) + "\n");
+        return;
+    }
+    if (operation === "task.claim" && data.task && data.claimToken) {
+        stdout.write(`Task claimed successfully.\n` +
+            `Task ID:     ${data.task.id}\n` +
+            `Status:      ${data.task.status}\n` +
+            `Attempt:     ${data.task.attempt}\n` +
+            `Claim Token: ${data.claimToken}\n` +
+            `Lease Until: ${data.task.leaseUntil ?? "none"}\n`);
+        return;
+    }
+    // Concise human-readable formatting for other operations
+    if (operation === "project.register" && data.project) {
+        stdout.write(`Project registered: ${data.project.name} (${data.project.id})\nRoot: ${data.project.root}\n`);
+        return;
+    }
+    if (operation === "agent.register" && data.agent) {
+        stdout.write(`Agent registered: ${data.agent.displayName} (${data.agent.id})\n`);
+        return;
+    }
+    if (operation === "task.create" && data.task) {
+        stdout.write(`Task created: [${data.task.id}] ${data.task.title} (status: ${data.task.status})\n`);
+        return;
+    }
+    if (operation === "task.get" && data.task) {
+        stdout.write(`Task [${data.task.id}] ${data.task.title}\nStatus: ${data.task.status} | Owner: ${data.task.ownerId ?? "none"}\n`);
+        return;
+    }
+    if (operation === "task.list" && Array.isArray(data.tasks)) {
+        stdout.write(`Tasks (${data.tasks.length} returned, ${data.omittedCount ?? 0} omitted):\n`);
+        for (const t of data.tasks) {
+            stdout.write(`- [${t.id}] ${t.title} (${t.status}, attempt ${t.attempt})\n`);
+        }
+        return;
+    }
+    if (operation === "handoff.submit" && data.task && data.handoff) {
+        stdout.write(`Handoff submitted: Task [${data.task.id}] is now ${data.task.status}.\nOutcome: ${data.handoff.outcome}\n`);
+        return;
+    }
+    if (operation === "question.ask" && data.question) {
+        stdout.write(`Question asked [${data.question.id}] to ${data.question.toAgentId}\n`);
+        return;
+    }
+    if (operation === "question.answer" && data.question) {
+        stdout.write(`Question [${data.question.id}] answered by ${data.question.answer?.actorId ?? "unknown"}\n`);
+        return;
+    }
+    if (operation === "inbox.list" && Array.isArray(data.events)) {
+        stdout.write(`Inbox events (${data.events.length} returned, nextCursor: ${data.nextCursor}, hasMore: ${data.hasMore}):\n`);
+        for (const ev of data.events) {
+            stdout.write(`- [Event ${ev.id}] ${ev.kind} (Task ${ev.taskId}, Question ${ev.questionId})\n`);
+        }
+        return;
+    }
+    if (operation === "decision.record" && data.decision) {
+        stdout.write(`Decision recorded [${data.decision.id}] by ${data.decision.actorId}\n`);
+        return;
+    }
+    // Fallback for renew, release, reopen, cancel
+    if (data.task) {
+        stdout.write(`Task [${data.task.id}] updated to status ${data.task.status}.\n`);
+        return;
+    }
+    stdout.write(`Operation ${operation} succeeded.\n`);
+}
+/**
+ * Emits output for an error response and returns the appropriate process exit code.
+ */
+export function handleErrorOutput(error, isJson, stdout = process.stdout, stderr = process.stderr) {
+    const exitCode = ERROR_EXIT_CODES[error.code] ?? 1;
+    if (isJson) {
+        const jsonEnvelope = {
+            schemaVersion: 1,
+            ok: false,
+            error: {
+                code: error.code || "INTERNAL",
+                message: error.message || "Internal error",
+                details: error.details
+            }
+        };
+        stdout.write(JSON.stringify(jsonEnvelope) + "\n");
+        return exitCode;
+    }
+    stderr.write(`Error [${error.code}]: ${error.message}\n`);
+    return exitCode;
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

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