@tiangong-ai/cli 0.0.19 → 0.0.20

package/dist/research/workspace/projects.js

@@ -0,0 +1,230 @@
+import { randomUUID } from "node:crypto";
+import { lstat, readdir } from "node:fs/promises";
+import { basename, join, resolve, sep } from "node:path";
+import { CliError } from "../../errors.js";
+import { RESEARCH_CONTROL_DIRECTORY } from "./constants.js";
+import { appendJournalEvent } from "./journal.js";
+import { ensureDirectory, fileSize, readJsonFile, sha256File, workspacePaths, writeJsonAtomic, } from "./storage.js";
+import { loadWorkspaceConfig, withWorkspaceLock } from "./workspace.js";
+const PROJECT_ID_PATTERN = /^[a-z0-9][a-z0-9-]{2,63}$/;
+export async function initializeProject(root, projectId, question) {
+    validateProjectId(projectId);
+    const normalizedQuestion = question.trim();
+    if (normalizedQuestion.length < 8 || normalizedQuestion.length > 4000) {
+        throw new CliError("Research question must contain 8-4000 characters.", {
+            code: "RESEARCH_QUESTION_INVALID",
+            exitCode: 2,
+        });
+    }
+    return withWorkspaceLock(root, "project.init", async () => {
+        const paths = workspacePaths(root);
+        const projectRoot = join(paths.projects, projectId);
+        const projectPath = join(projectRoot, "project.json");
+        const existing = await lstat(projectRoot).catch(() => undefined);
+        if (existing) {
+            throw new CliError(`Research project already exists: ${projectId}`, {
+                code: "RESEARCH_PROJECT_EXISTS",
+                exitCode: 2,
+            });
+        }
+        const config = await loadWorkspaceConfig(root);
+        const now = new Date().toISOString();
+        const project = {
+            schemaVersion: 1,
+            id: projectId,
+            question: normalizedQuestion,
+            status: "ready",
+            createdAt: now,
+            updatedAt: now,
+            inputs: [],
+            packages: defaultWorkPackages(config),
+            usage: { tokens: 0, costUsd: 0, wallSeconds: 0 },
+        };
+        await Promise.all([
+            ensureDirectory(projectRoot),
+            ensureDirectory(join(projectRoot, "outputs")),
+            ensureDirectory(join(projectRoot, "runs")),
+        ]);
+        await writeJsonAtomic(projectPath, project);
+        await appendJournalEvent(paths.journal, "project.initialized", projectId, {
+            projectId,
+            questionSha256: await hashQuestion(normalizedQuestion),
+        });
+        return project;
+    });
+}
+export async function addProjectInput(root, projectId, inputPath, role) {
+    validateProjectId(projectId);
+    const canonicalInput = resolve(inputPath);
+    if (canonicalInput !== inputPath) {
+        throw new CliError(`Input path must be absolute: ${inputPath}`, {
+            code: "RESEARCH_INPUT_INVALID",
+            exitCode: 2,
+        });
+    }
+    if (canonicalInput.split(sep).includes(RESEARCH_CONTROL_DIRECTORY)) {
+        throw new CliError("Research inputs cannot come from a research control directory.", {
+            code: "RESEARCH_INPUT_INVALID",
+            exitCode: 2,
+        });
+    }
+    const info = await lstat(canonicalInput).catch(() => undefined);
+    if (!info?.isFile() || info.isSymbolicLink()) {
+        throw new CliError(`Research input must be a regular file: ${inputPath}`, {
+            code: "RESEARCH_INPUT_INVALID",
+            exitCode: 2,
+        });
+    }
+    return withWorkspaceLock(root, "project.input.add", async () => {
+        const project = await loadProject(root, projectId);
+        const sha256 = await sha256File(canonicalInput);
+        const existing = project.inputs.find((input) => input.sha256 === sha256 && input.role === role);
+        if (existing)
+            return existing;
+        const input = {
+            id: `${slug(basename(canonicalInput))}-${sha256.slice(0, 12)}`,
+            role,
+            path: canonicalInput,
+            sha256,
+            bytes: await fileSize(canonicalInput),
+            addedAt: new Date().toISOString(),
+        };
+        project.inputs.push(input);
+        project.inputs.sort((left, right) => left.id.localeCompare(right.id));
+        project.updatedAt = new Date().toISOString();
+        await saveProject(root, project);
+        await appendJournalEvent(workspacePaths(root).journal, "project.input.added", projectId, {
+            projectId,
+            inputId: input.id,
+            role,
+            sha256,
+            bytes: input.bytes,
+        });
+        return input;
+    });
+}
+export async function loadProject(root, projectId) {
+    validateProjectId(projectId);
+    const project = await readJsonFile(join(workspacePaths(root).projects, projectId, "project.json"), `Research project ${projectId}`);
+    validateProjectShape(project, projectId);
+    return project;
+}
+export async function listProjects(root) {
+    const entries = await readdir(workspacePaths(root).projects, { withFileTypes: true });
+    const projects = [];
+    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+        if (!entry.isDirectory() || entry.isSymbolicLink())
+            continue;
+        projects.push(await loadProject(root, entry.name));
+    }
+    return projects;
+}
+export async function saveProject(root, project) {
+    validateProjectShape(project, project.id);
+    await writeJsonAtomic(join(workspacePaths(root).projects, project.id, "project.json"), project);
+}
+export function refreshProject(project) {
+    for (const workPackage of project.packages) {
+        if (workPackage.status !== "pending" && workPackage.status !== "retry")
+            continue;
+        const dependenciesComplete = workPackage.dependencies.every((dependency) => project.packages.find((candidate) => candidate.id === dependency)?.status === "complete");
+        if (dependenciesComplete)
+            workPackage.status = "ready";
+    }
+    if (project.packages.some((item) => item.status === "failed"))
+        project.status = "blocked";
+    else if (project.packages.every((item) => item.status === "complete"))
+        project.status = "complete";
+    else if (project.packages.some((item) => item.status === "running"))
+        project.status = "running";
+    else
+        project.status = "ready";
+    project.updatedAt = new Date().toISOString();
+    return project;
+}
+export function nextReadyPackage(project) {
+    refreshProject(project);
+    return project.packages.find((workPackage) => workPackage.status === "ready");
+}
+export function packageById(project, packageId) {
+    const workPackage = project.packages.find((candidate) => candidate.id === packageId);
+    if (!workPackage) {
+        throw new CliError(`Unknown work package ${packageId} in project ${project.id}.`, {
+            code: "RESEARCH_PACKAGE_INVALID",
+            exitCode: 2,
+        });
+    }
+    return workPackage;
+}
+function defaultWorkPackages(config) {
+    const maxAttempts = config.budget.maxAttemptsPerPackage;
+    return [
+        workPackage("discover", "discover", "agent", "producer", [], ["outputs/evidence.json"], maxAttempts),
+        workPackage("analyze", "analyze", "agent", "producer", ["discover"], ["outputs/analysis.json"], maxAttempts),
+        workPackage("synthesize", "synthesize", "agent", "producer", ["analyze"], ["outputs/report.md"], maxAttempts),
+        workPackage("review", "review", "agent", "reviewer", ["synthesize"], ["outputs/review.json"], maxAttempts),
+        workPackage("close", "close", "verify", "mechanical", ["review"], ["outputs/closure.json"], 1),
+    ];
+}
+function workPackage(id, stage, kind, executor, dependencies, expectedOutputs, maxAttempts) {
+    return {
+        id,
+        stage,
+        kind,
+        executor,
+        dependencies,
+        expectedOutputs,
+        status: dependencies.length ? "pending" : "ready",
+        attempts: 0,
+        maxAttempts,
+        lastError: null,
+        startedAt: null,
+        completedAt: null,
+    };
+}
+function validateProjectShape(project, expectedId) {
+    if (project.schemaVersion !== 1 ||
+        project.id !== expectedId ||
+        !PROJECT_ID_PATTERN.test(project.id) ||
+        typeof project.question !== "string" ||
+        !Array.isArray(project.inputs) ||
+        !Array.isArray(project.packages) ||
+        !project.usage ||
+        typeof project.usage.tokens !== "number" ||
+        typeof project.usage.costUsd !== "number" ||
+        typeof project.usage.wallSeconds !== "number") {
+        throw new CliError(`Research project state is invalid: ${expectedId}`, {
+            code: "RESEARCH_PROJECT_INVALID",
+            exitCode: 2,
+        });
+    }
+    const packageIds = new Set(project.packages.map((item) => item.id));
+    if (packageIds.size !== project.packages.length ||
+        project.packages.some((item) => !["agent", "verify"].includes(item.kind) ||
+            !["producer", "reviewer", "mechanical"].includes(item.executor) ||
+            item.dependencies.some((dependency) => !packageIds.has(dependency)) ||
+            item.expectedOutputs.some((path) => !path.startsWith("outputs/")))) {
+        throw new CliError(`Research project work packages are invalid: ${expectedId}`, {
+            code: "RESEARCH_PROJECT_INVALID",
+            exitCode: 2,
+        });
+    }
+}
+function validateProjectId(projectId) {
+    if (!PROJECT_ID_PATTERN.test(projectId)) {
+        throw new CliError("Project ID must contain 3-64 lowercase letters, digits, or hyphens and start with a letter or digit.", { code: "RESEARCH_PROJECT_ID_INVALID", exitCode: 2 });
+    }
+}
+function slug(value) {
+    const result = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 40);
+    return result || randomUUID().slice(0, 8);
+}
+async function hashQuestion(question) {
+    const { createHash } = await import("node:crypto");
+    return createHash("sha256").update(question, "utf8").digest("hex");
+}
+//# sourceMappingURL=projects.js.map

package/dist/research/workspace/projects.js.map

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

package/dist/research/workspace/runtime.d.ts

@@ -0,0 +1,27 @@
+import { type AgentExecutionRequest } from "./executor.js";
+import type { ExecutionResult, ProjectState } from "./types.js";
+export interface RunOptions {
+    maxParallel: number;
+    maxCycles: number;
+    dryRun: boolean;
+    environment: NodeJS.ProcessEnv;
+}
+export type PackageExecutor = (request: AgentExecutionRequest) => Promise<ExecutionResult>;
+export interface WorkspaceRunResult {
+    workspace: string;
+    status: "complete" | "blocked" | "ready" | "dry-run";
+    stopReason: "dry-run" | "all-projects-complete" | "project-blocked" | "cycle-limit" | "no-ready-work" | "no-projects";
+    cycles: number;
+    executed: Array<{
+        projectId: string;
+        packageId: string;
+        status: string;
+    }>;
+    projects: Array<{
+        id: string;
+        status: ProjectState["status"];
+        readyPackage: string | null;
+        usage: ProjectState["usage"];
+    }>;
+}
+export declare function runResearchWorkspace(root: string, options: RunOptions, packageExecutor?: PackageExecutor): Promise<WorkspaceRunResult>;