@prismatic-io/lux 0.0.1

package/lib/cli/init.js

@@ -0,0 +1,340 @@
+import { randomUUID } from "node:crypto";
+import { constants, lstat, mkdir, open, realpath, rename, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { z } from "zod";
+const InitOptionsSchema = z
+    .object({
+    cwd: z.string().min(1),
+    force: z.boolean().default(false),
+    experiment: z.boolean().default(false),
+})
+    .strict();
+const InitResultSchema = z
+    .object({
+    created: z.array(z.string()),
+    updated: z.array(z.string()),
+    skipped: z.array(z
+        .object({
+        path: z.string(),
+        reason: z.string(),
+    })
+        .strict()),
+    experiment: z.boolean(),
+})
+    .strict();
+const pathWithin = (root, path) => {
+    const fromRoot = relative(resolve(root), resolve(path));
+    if (fromRoot === "" ||
+        (!isAbsolute(fromRoot) && fromRoot !== ".." && !fromRoot.startsWith(`..${sep}`))) {
+        return fromRoot;
+    }
+    return null;
+};
+const ensureSafeDir = async (root, path) => {
+    const fromRoot = pathWithin(root, path);
+    if (fromRoot === null)
+        throw new Error(`lux init: path escapes project root: ${path}`);
+    let cursor = root;
+    for (const component of fromRoot.split(sep).filter(Boolean)) {
+        cursor = join(cursor, component);
+        try {
+            const info = await lstat(cursor);
+            if (info.isSymbolicLink() || !info.isDirectory()) {
+                throw new Error(`lux init: path component must be a real directory: ${cursor}`);
+            }
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            await mkdir(cursor);
+        }
+    }
+};
+const existingRegularFile = async (path) => {
+    try {
+        const info = await lstat(path);
+        if (info.isSymbolicLink() || !info.isFile()) {
+            throw new Error(`lux init: scaffold target must be a regular file: ${path}`);
+        }
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+};
+const readRegularFile = async (path) => {
+    const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+    try {
+        const info = await handle.stat();
+        if (!info.isFile())
+            throw new Error(`lux init: scaffold target must be a file: ${path}`);
+        return await handle.readFile("utf8");
+    }
+    finally {
+        await handle.close();
+    }
+};
+const atomicReplace = async (path, body) => {
+    const temporary = join(dirname(path), `.${basename(path)}.${randomUUID()}.tmp`);
+    try {
+        await writeFile(temporary, body, { flag: "wx" });
+        await rename(temporary, path);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+};
+const writeIfMissing = async (root, path, body, result, force) => {
+    await ensureSafeDir(root, dirname(path));
+    const exists = await existingRegularFile(path);
+    if (!force && exists) {
+        result.skipped.push({ path, reason: "exists" });
+        return;
+    }
+    if (exists)
+        await atomicReplace(path, body);
+    else
+        await writeFile(path, body, { flag: "wx" });
+    if (exists)
+        result.updated.push(path);
+    else
+        result.created.push(path);
+};
+const appendGitignoreEntry = async (cwd, entry, result) => {
+    const path = join(cwd, ".gitignore");
+    const exists = await existingRegularFile(path);
+    const current = exists ? await readRegularFile(path) : "";
+    if (current.split(/\r?\n/).includes(entry)) {
+        result.skipped.push({ path, reason: "entry already present" });
+        return;
+    }
+    // Preserve the user's exact content while replacing the directory entry
+    // atomically, so symlink/hard-link aliases are never followed.
+    const needsNewline = current !== "" && !current.endsWith("\n");
+    const updated = `${current}${needsNewline ? "\n" : ""}${entry}\n`;
+    if (exists)
+        await atomicReplace(path, updated);
+    else
+        await writeFile(path, updated, { flag: "wx" });
+    if (!exists)
+        result.created.push(path);
+    else
+        result.updated.push(path);
+};
+const luxConfigBody = (withExperiment) => {
+    const subjectRoot = withExperiment ? '  subjectRoot: ".",\n' : "";
+    const profiles = withExperiment ? "  profiles: { starter: {} },\n" : "";
+    const defaultDriver = withExperiment
+        ? `  // Choose one driver before running the scaffold.
+  // defaultDriver: { name: "codex", config: { model: "YOUR_CODEX_MODEL", reasoningEffort: "high" } },
+  // defaultDriver: { name: "claude-code", config: { model: "YOUR_CLAUDE_MODEL", effort: "high" } },
+`
+        : `  // The subprocess command must implement Lux's lux-jsonl protocol.
+  // Replace this entire object when using the built-in Codex or Claude Code driver.
+  defaultDriver: { name: "subprocess", config: { command: "your-agent-cli" } },
+`;
+    return `import type { LuxConfig } from "@prismatic-io/lux";
+
+/**
+ * Lux project configuration. Drivers, answerers, and assertions
+ * register here; \`lux run\` discovers cases under \`casesRoot\`.
+ */
+const config: LuxConfig = {
+  casesRoot: "./cases",
+  fixturesRoot: "./fixtures",
+  runsRoot: "./.lux-runs",
+${subjectRoot}  // Runners default to cheap models and low effort instead of inheriting CLI defaults.
+${defaultDriver}  // Persona answerers and rubric judges default to cheap models and low effort.
+  // Override both explicitly when a stronger harness is worth the added cost:
+  // harness: { provider: "codex", model: "YOUR_HARNESS_MODEL" },
+  defaultAnswerer: "persona",
+${profiles}  // drivers: [/* register drivers here */],
+  // answerers: [/* register answerers here */],
+  // assertions: [/* register custom assertions here */],
+};
+
+export default config;
+`;
+};
+const SAMPLE_CASE_BODY = `import { defineEvalCase } from "@prismatic-io/lux";
+
+/**
+ * A starter case. It inherits defaultDriver from lux.config.ts.
+ * Replace the prompt and persona to match the behavior you need.
+ */
+export default defineEvalCase({
+  id: "hello-world",
+  prompt: "Say hello to the world.",
+  persona: "You are a friendly developer. Keep answers short.",
+  assertions: [
+    { id: "completed", type: "run-succeeded" },
+    // { type: "contains", text: "hello" },
+    // { type: "command-exits-zero", command: "echo done" },
+  ],
+});
+`;
+const EXPERIMENT_SAMPLE_CASE_BODY = `import { defineEvalCase } from "@prismatic-io/lux";
+
+/**
+ * A starter smoke case. It inherits the default driver from lux.config.ts.
+ */
+export default defineEvalCase({
+  id: "hello-world",
+  prompt: "Say hello to the world.",
+  assertions: [{ id: "completed", type: "run-succeeded" }],
+});
+`;
+const README_BODY = `# Lux evals
+
+This directory holds your evaluation cases.
+
+## Layout
+
+- \`lux.config.ts\` — project configuration: default driver/answerer and registered plugins.
+- \`cases/\` — one TypeScript file per eval case. Default-export a \`defineEvalCase({...})\`.
+- \`fixtures/\` — starting state for cases that need pre-staged input.
+- \`.lux-runs/\` — run output, gitignored.
+
+## Setup
+
+Install Lux in the project so authored TypeScript cases can resolve its API:
+
+\`\`\`bash
+npm install --save-dev @prismatic-io/lux
+\`\`\`
+
+## Run cases
+
+\`lux run\` discovers every case under \`casesRoot\` and runs it. Filter by
+name/path substring, by \`--tag\`, or repeat each matched eval with \`--loop\`:
+
+\`\`\`bash
+npm exec -- lux run                       # every discovered case
+npm exec -- lux run hello-world           # cases whose id/path contains "hello-world"
+npm exec -- lux run cases/hello-world.ts  # one file directly
+npm exec -- lux run --tag smoke           # cases tagged "smoke" (meta.tags)
+npm exec -- lux run --loop 5              # run each matched eval 5 times
+\`\`\`
+
+See the [Lux docs](https://github.com/prismatic-io/lux) for the full design.
+`;
+const STARTER_PROMPT_BODY = `# Starter agent instructions
+
+Complete the requested task directly. Prefer deterministic work, use the fewest
+tools needed, and ask a question only when proceeding would be unsafe.
+`;
+const experimentCaseBody = (id, split, task) => `import { defineEvalCase, subjectPath } from "@prismatic-io/lux";
+
+export default defineEvalCase({
+  id: ${JSON.stringify(id)},
+  prompt: [
+    \`Read \${subjectPath("prompts/agent.md")} and follow it as the system instructions.\`,
+    ${JSON.stringify(task)},
+  ].join("\\n\\n"),
+  assertions: [{ id: "completed", type: "run-succeeded" }],
+  meta: { tags: [${JSON.stringify(split)}] },
+});
+`;
+const STARTER_EXPERIMENT_BODY = `import { defineExperiment } from "@prismatic-io/lux";
+
+export default defineExperiment({
+  id: "starter-agent-improvement",
+  subject: {
+    root: "..",
+    mutable: ["prompts/agent.md"],
+  },
+  profiles: ["starter"],
+  splits: {
+    train: { tags: ["train"] },
+    validation: { tags: ["validation"] },
+    test: { tags: ["test"] },
+  },
+  repetitions: { search: 1, promotion: 2 },
+  objectives: {
+    constraints: [
+      { metric: "quality.passRate", min: 1 },
+      { metric: "quality.passRate", min: 1, split: "test" },
+      { metric: "quality.caseRegressions", max: 0 },
+      { metric: "quality.caseRegressions", max: 0, split: "test" },
+    ],
+    minimize: [
+      { metric: "agent.total" },
+      { metric: "interrupts.ask" },
+      { metric: "toolCalls" },
+      { metric: "subject.bytes" },
+    ],
+  },
+  optimizer: {
+    algorithm: "reflective",
+    config: {
+      provider: "claude-code",
+      model: "YOUR_OPTIMIZER_MODEL",
+      reasoningEffort: "low",
+    },
+  },
+  budget: {
+    maxCandidates: 4,
+    patience: 1,
+    maxMetricCalls: 40,
+    maxJudgeCalls: 40,
+    maxProposalCalls: 3,
+    maxTokens: 1_000_000,
+    maxCostUsd: 25,
+    maxUnpricedModelCalls: 25,
+    maxWallTimeMs: 1_800_000,
+  },
+});
+`;
+export const initProject = async (options) => {
+    const parsedOptions = InitOptionsSchema.parse(options);
+    const experiment = parsedOptions.experiment;
+    const result = { created: [], updated: [], skipped: [], experiment };
+    const force = parsedOptions.force;
+    await mkdir(parsedOptions.cwd, { recursive: true });
+    const root = await realpath(parsedOptions.cwd);
+    await writeIfMissing(root, join(root, "lux.config.ts"), luxConfigBody(experiment), result, force);
+    await writeIfMissing(root, join(root, "cases", "hello-world.ts"), experiment ? EXPERIMENT_SAMPLE_CASE_BODY : SAMPLE_CASE_BODY, result, force);
+    await writeIfMissing(root, join(root, "fixtures", ".gitkeep"), "", result, force);
+    // README is the user's to evolve once it exists; `--force` refreshes only
+    // the lux-owned scaffold files, never a hand-edited README.
+    await writeIfMissing(root, join(root, "README.md"), README_BODY, result, false);
+    if (experiment) {
+        await writeIfMissing(root, join(root, "prompts", "agent.md"), STARTER_PROMPT_BODY, result, force);
+        await writeIfMissing(root, join(root, "cases", "experiment-train.ts"), experimentCaseBody("starter/train", "train", "Complete the representative training task and summarize the result."), result, force);
+        await writeIfMissing(root, join(root, "cases", "experiment-validation.ts"), experimentCaseBody("starter/validation", "validation", "Complete an independently designed validation task and summarize the result."), result, force);
+        await writeIfMissing(root, join(root, "cases", "experiment-test.ts"), experimentCaseBody("starter/test", "test", "Complete the final held-out task and summarize the result."), result, force);
+        await writeIfMissing(root, join(root, "experiments", "starter.optimize.ts"), STARTER_EXPERIMENT_BODY, result, force);
+    }
+    await appendGitignoreEntry(root, ".lux-runs/", result);
+    return InitResultSchema.parse(result);
+};
+export const formatInitReport = (result, cwd) => {
+    const rel = (path) => relative(cwd, path) || path;
+    const lines = [];
+    for (const c of result.created)
+        lines.push(`  + ${rel(c)}`);
+    for (const u of result.updated)
+        lines.push(`  ~ ${rel(u)} (updated)`);
+    for (const s of result.skipped)
+        lines.push(`  · ${rel(s.path)} (${s.reason})`);
+    if (result.created.length === 0 && result.updated.length === 0) {
+        lines.push("  (nothing created — use --force to overwrite)");
+    }
+    lines.push("");
+    lines.push("Next steps:");
+    lines.push("  1. Install @prismatic-io/lux in this project if it is not already present.");
+    lines.push("  2. Edit lux.config.ts to choose a driver.");
+    if (result.experiment) {
+        lines.push("  3. Replace the starter prompt and split cases with representative evidence.");
+        lines.push("  4. lux doctor");
+        lines.push("  5. lux optimize experiments/starter.optimize.ts --plan");
+    }
+    else {
+        lines.push("  3. Edit cases/hello-world.ts with a real prompt.");
+        lines.push("  4. lux run");
+    }
+    return lines.join("\n");
+};
+//# sourceMappingURL=init.js.map

package/lib/cli/init.js.map

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

package/lib/cli/program.d.ts

@@ -0,0 +1,22 @@
+import { Command } from "commander";
+import { type DiscoveredCase, type SuiteItem } from "../orchestrator/index.js";
+import { parsePositiveInt, resolveConcurrency } from "./run-options.js";
+export declare const buildProgram: () => Command;
+/**
+ * A case is only a success if it finished cleanly AND nothing graded it as
+ * failing. A run that timed out carrying no assertions grades as `null`, which
+ * must not be mistaken for a pass.
+ */
+declare const isFailure: (outcome: {
+    exitReason: string;
+    casePassed: boolean | null;
+}) => boolean;
+type FilterPartition = {
+    explicit: SuiteItem[];
+    patterns: string[];
+};
+declare const partitionFilters: (filters: string[], cwd: string) => FilterPartition;
+declare const selectSuite: (cases: DiscoveredCase[], { explicit, patterns }: FilterPartition, tags: string[]) => DiscoveredCase[];
+declare const expandLoop: (base: SuiteItem[], loop: number) => SuiteItem[];
+export { expandLoop, isFailure, parsePositiveInt, partitionFilters, resolveConcurrency, selectSuite, };
+//# sourceMappingURL=program.d.ts.map

package/lib/cli/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAwB,MAAM,WAAW,CAAC;AAQ1D,OAAO,EAKL,KAAK,cAAc,EAqCnB,KAAK,SAAS,EAKf,MAAM,0BAA0B,CAAC;AASlC,OAAO,EAIL,gBAAgB,EAIhB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AA4hB1B,eAAO,MAAM,YAAY,QAAO,OAa/B,CAAC;AAkEF;;;;GAIG;AACH,QAAA,MAAM,SAAS,YAAa;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,KAAG,OACnB,CAAC;AAgB/D,KAAK,eAAe,GAAG;IAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAMrE,QAAA,MAAM,gBAAgB,YAAa,MAAM,EAAE,OAAO,MAAM,KAAG,eAe1D,CAAC;AAKF,QAAA,MAAM,WAAW,UACR,cAAc,EAAE,0BACC,eAAe,QACjC,MAAM,EAAE,KACb,cAAc,EAsBhB,CAAC;AAKF,QAAA,MAAM,UAAU,SAAU,SAAS,EAAE,QAAQ,MAAM,KAAG,SAAS,EASrD,CAAC;AAuMX,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,GACZ,CAAC"}