@nodetool-ai/cli 0.7.0-rc.23 → 0.8.2

package/dist/commands/__tests__/timeline-render-completeness.test.js

@@ -0,0 +1,117 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it, vi } from "vitest";
+import { Command } from "commander";
+import { registerTimelineRenderCommand, runTimelineRender } from "../timeline-render.js";
+const incompleteRenderer = async ({ outPath, writeFrame }) => {
+    if (writeFrame) {
+        await writeFrame(0, new Uint8Array(16 * 16 * 4));
+    }
+    else {
+        await writeFile(outPath, "retained incomplete artifact");
+    }
+    return {
+        totalFrames: 1,
+        skippedClips: ["missing-clip"],
+        fontsUnavailable: [],
+        complete: false,
+        diagnostics: [
+            {
+                clipId: "missing-clip",
+                startMs: 0,
+                endMs: 1000,
+                reason: "missing_asset",
+                detail: "No current asset is available."
+            }
+        ]
+    };
+};
+describe("timeline export completeness", () => {
+    it("preserves missing-content diagnostics in preview results", async () => {
+        const directory = await mkdtemp(path.join(os.tmpdir(), "timeline-completeness-"));
+        try {
+            const input = path.join(directory, "timeline.json");
+            await writeFile(input, JSON.stringify({
+                name: "Missing content",
+                width: 16,
+                height: 16,
+                fps: 30,
+                durationMs: 1000,
+                document: { tracks: [], clips: [], markers: [] }
+            }));
+            const diagnostics = [
+                {
+                    clipId: "missing-clip",
+                    startMs: 0,
+                    endMs: 1000,
+                    reason: "missing_asset",
+                    detail: "No current asset is available."
+                }
+            ];
+            const result = await runTimelineRender(input, { out: path.join(directory, "stills"), stills: true, frames: "0" }, async () => null, async () => ({
+                totalFrames: 1,
+                skippedClips: ["missing-clip"],
+                fontsUnavailable: [],
+                complete: false,
+                diagnostics
+            }));
+            expect(result).toMatchObject({
+                complete: false,
+                diagnostics,
+                skippedClips: ["missing-clip"]
+            });
+        }
+        finally {
+            await rm(directory, { recursive: true, force: true });
+        }
+    });
+    it.each([
+        { stills: false, exitCode: 1 },
+        { stills: true, exitCode: 0 }
+    ])("reports incomplete content with stills=$stills and exit=$exitCode", async ({ stills, exitCode }) => {
+        const directory = await mkdtemp(path.join(os.tmpdir(), "timeline-completeness-command-"));
+        const exit = vi
+            .spyOn(process, "exit")
+            .mockImplementation(() => undefined);
+        const log = vi.spyOn(console, "log").mockImplementation(() => { });
+        const error = vi.spyOn(console, "error").mockImplementation(() => { });
+        try {
+            const input = path.join(directory, "timeline.json");
+            await writeFile(input, JSON.stringify({
+                name: "Missing content",
+                width: 16,
+                height: 16,
+                fps: 30,
+                durationMs: 1000,
+                document: { tracks: [], clips: [], markers: [] }
+            }));
+            const command = new Command();
+            registerTimelineRenderCommand(command, async () => async () => null, incompleteRenderer);
+            await command.parseAsync([
+                "render",
+                input,
+                "--out",
+                path.join(directory, stills ? "stills" : "frames.zip"),
+                "--format",
+                "png_sequence",
+                "--frames",
+                "0",
+                "--json",
+                ...(stills ? ["--stills"] : [])
+            ], { from: "user" });
+            expect(exit).toHaveBeenCalledExactlyOnceWith(exitCode);
+            expect(JSON.parse(String(log.mock.calls[0][0]))).toMatchObject({
+                complete: false,
+                diagnostics: [{ clipId: "missing-clip", reason: "missing_asset" }]
+            });
+        }
+        finally {
+            exit.mockRestore();
+            log.mockRestore();
+            error.mockRestore();
+            await rm(directory, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=timeline-render-completeness.test.js.map

package/dist/commands/__tests__/timeline-render-completeness.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-render-completeness.test.js","sourceRoot":"","sources":["../../../src/commands/__tests__/timeline-render-completeness.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,kBAAkB,GACtB,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;IAChC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,UAAU,CAAC,CAAC,EAAE,IAAI,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO;QACL,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC,cAAc,CAAC;QAC9B,gBAAgB,EAAE,EAAE;QACpB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE;YACX;gBACE,MAAM,EAAE,cAAc;gBACtB,OAAO,EAAE,CAAC;gBACV,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,eAAe;gBACvB,MAAM,EAAE,gCAAgC;aACzC;SACF;KACF,CAAC;AACJ,CAAC,CAAC;AAEJ,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,SAAS,GAAG,MAAM,OAAO,CAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CACjD,CAAC;QACF,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YACpD,MAAM,SAAS,CACb,KAAK,EACL,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,iBAAiB;gBACvB,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,EAAE;gBACV,GAAG,EAAE,EAAE;gBACP,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;aACjD,CAAC,CACH,CAAC;YACF,MAAM,WAAW,GAAG;gBAClB;oBACE,MAAM,EAAE,cAAc;oBACtB,OAAO,EAAE,CAAC;oBACV,KAAK,EAAE,IAAI;oBACX,MAAM,EAAE,eAAwB;oBAChC,MAAM,EAAE,gCAAgC;iBACzC;aACF,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,KAAK,EACL,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAClE,KAAK,IAAI,EAAE,CAAC,IAAI,EAChB,KAAK,IAAI,EAAE,CAAC,CAAC;gBACX,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,CAAC,cAAc,CAAC;gBAC9B,gBAAgB,EAAE,EAAE;gBACpB,QAAQ,EAAE,KAAK;gBACf,WAAW;aACZ,CAAC,CACH,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC;gBAC3B,QAAQ,EAAE,KAAK;gBACf,WAAW;gBACX,YAAY,EAAE,CAAC,cAAc,CAAC;aAC/B,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,IAAI,CAAC;QACN,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE;QAC9B,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;KAC9B,CAAC,CACA,mEAAmE,EACnE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7B,MAAM,SAAS,GAAG,MAAM,OAAO,CAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gCAAgC,CAAC,CACzD,CAAC;QACF,MAAM,IAAI,GAAG,EAAE;aACZ,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC;aACtB,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YACpD,MAAM,SAAS,CACb,KAAK,EACL,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,iBAAiB;gBACvB,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,EAAE;gBACV,GAAG,EAAE,EAAE;gBACP,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;aACjD,CAAC,CACH,CAAC;YACF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;YAC9B,6BAA6B,CAC3B,OAAO,EACP,KAAK,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,EAC5B,kBAAkB,CACnB,CAAC;YACF,MAAM,OAAO,CAAC,UAAU,CACtB;gBACE,QAAQ;gBACR,KAAK;gBACL,OAAO;gBACP,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;gBACtD,UAAU;gBACV,cAAc;gBACd,UAAU;gBACV,GAAG;gBACH,QAAQ;gBACR,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAChC,EACD,EAAE,IAAI,EAAE,MAAM,EAAE,CACjB,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,CAAC,+BAA+B,CAAC,QAAQ,CAAC,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;gBAC7D,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;aACnE,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,GAAG,CAAC,WAAW,EAAE,CAAC;YAClB,KAAK,CAAC,WAAW,EAAE,CAAC;YACpB,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/commands/__tests__/timeline-render.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timeline-render.test.d.ts.map

package/dist/commands/__tests__/timeline-render.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-render.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/timeline-render.test.ts"],"names":[],"mappings":""}

package/dist/commands/__tests__/timeline-render.test.js

@@ -0,0 +1,115 @@
+import { describe, expect, it } from "vitest";
+import { parseCoverageFrames, parseFrameSpec, selectClipSubset } from "../timeline-render.js";
+describe("parseFrameSpec", () => {
+    it("reads indices and inclusive ranges into sorted unique frames", () => {
+        expect(parseFrameSpec("290, 175,5-7,6", 450)).toEqual([5, 6, 7, 175, 290]);
+    });
+    it("accepts the last frame and refuses the one after it", () => {
+        expect(parseFrameSpec("449", 450)).toEqual([449]);
+        expect(() => parseFrameSpec("440-450", 450)).toThrow(/frames 0-449/);
+    });
+    it.each(["abc", "5-", "-5", "1.5", "3-1"])("refuses %j", (spec) => {
+        expect(() => parseFrameSpec(spec, 450)).toThrow();
+    });
+    it("refuses an empty selection", () => {
+        expect(() => parseFrameSpec(" , ", 450)).toThrow(/empty/);
+    });
+});
+describe("selectClipSubset", () => {
+    const clips = [
+        { id: "S1", name: "S1", mediaType: "group" },
+        { id: "g3", name: "streaks", mediaType: "group", parentId: "S1" },
+        { id: "s4", name: "streak-far", parentId: "g3" },
+        { id: "s6", name: "streak-mid", parentId: "g3" },
+        { id: "t11", name: "word-0", parentId: "S1" },
+        { id: "t15", name: "text", parentId: "S1" },
+        {
+            id: "t16",
+            name: "text",
+            parentId: "S1",
+            matte: { sourceClipId: "m1", mode: "alpha" }
+        },
+        { id: "M", name: "mattes", mediaType: "group" },
+        { id: "m1", name: "wipe", parentId: "M" },
+        { id: "other", name: "other" }
+    ];
+    const ids = (list) => list.map((c) => c.id);
+    it("keeps a clip and its ancestor groups but not its siblings", () => {
+        expect(ids(selectClipSubset(clips, "s4"))).toEqual(["S1", "g3", "s4"]);
+    });
+    it("matches names, every clip that shares one, and ids in one list", () => {
+        expect(ids(selectClipSubset(clips, "streak-mid, word-0"))).toEqual([
+            "S1",
+            "g3",
+            "s6",
+            "t11"
+        ]);
+        expect(ids(selectClipSubset(clips, "text"))).toEqual([
+            "S1",
+            "t15",
+            "t16",
+            "M",
+            "m1"
+        ]);
+    });
+    it("keeps the children of a selected group", () => {
+        expect(ids(selectClipSubset(clips, "streaks"))).toEqual([
+            "S1",
+            "g3",
+            "s4",
+            "s6"
+        ]);
+    });
+    it("keeps a matte source clip and that source's ancestors", () => {
+        expect(ids(selectClipSubset(clips, "t16"))).toEqual([
+            "S1",
+            "t16",
+            "M",
+            "m1"
+        ]);
+    });
+    it("names every token that matches no clip", () => {
+        expect(() => selectClipSubset(clips, "s4,nope,also-nope")).toThrow(/"nope", "also-nope"/);
+    });
+    it("refuses an empty list", () => {
+        expect(() => selectClipSubset(clips, " , ")).toThrow(/empty/);
+    });
+});
+describe("parseCoverageFrames", () => {
+    const builder = [
+        "#!/usr/bin/env tsx",
+        "// Kite builder.",
+        "//",
+        "// | Feature | Clip | Frame |",
+        "// |---|---|---|",
+        "// | Slow push-in | `street` (S1) | 40 |",
+        "// | Music | `drums` | — |",
+        "// | Logo reveal | `logo` | 412 |",
+        "// | Chart | `chart` | 40 |",
+        "",
+        "// | Not | leading | 999 |",
+        "import x from 'y';",
+        "// | Late | table | 7 |"
+    ].join("\n");
+    it("reads the Frame column of the table in the leading comment", () => {
+        const { frames, skipped } = parseCoverageFrames(builder);
+        expect(frames).toEqual([40, 412, 40]);
+        expect(skipped).toEqual([{ row: "Music | `drums`", value: "—" }]);
+    });
+    it("reads a table inside a leading block comment", () => {
+        const source = [
+            "/**",
+            " * | Feature | Frame |",
+            " * | --- | --- |",
+            " * | Push | 12 |",
+            " */",
+            "export {};"
+        ].join("\n");
+        expect(parseCoverageFrames(source).frames).toEqual([12]);
+    });
+    it("refuses a file whose leading comment has no Frame table", () => {
+        expect(() => parseCoverageFrames("// | A | B |\n// |---|---|\n// | 1 | 2 |\nexport {};")).toThrow(/Frame/);
+        expect(() => parseCoverageFrames("export {};\n// | A | Frame |\n// |---|---|\n// | x | 1 |")).toThrow(/Frame/);
+    });
+});
+//# sourceMappingURL=timeline-render.test.js.map

package/dist/commands/__tests__/timeline-render.test.js.map

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

package/dist/commands/__tests__/timeline-score.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timeline-score.test.d.ts.map

package/dist/commands/__tests__/timeline-score.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-score.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/timeline-score.test.ts"],"names":[],"mappings":""}

package/dist/commands/__tests__/timeline-score.test.js

@@ -0,0 +1,100 @@
+import { describe, expect, it } from "vitest";
+import { evenlySpacedFrames, renderTimelineScore } from "../timeline-score.js";
+const metric = (overrides) => ({
+    metric: "animationsPerSecond",
+    value: 1,
+    referenceMedian: 1,
+    ratio: 1,
+    credit: 1,
+    ...overrides
+});
+const result = (overrides = {}) => ({
+    score: 80,
+    rawScore: 80,
+    penalty: 0,
+    metrics: {
+        clipCount: 2,
+        visibleSeconds: 2,
+        animationsPerSecond: 1,
+        keyframesPerSecond: 1,
+        distinctAnimatedProperties: 1,
+        distinctEffectTypes: 1,
+        featureFlagsUsed: 1,
+        styleTracks: 1,
+        textAnimators: 1,
+        authoredTransitions: 1,
+        sceneCount: 1
+    },
+    metricScores: [metric({})],
+    reference: { entries: [{ slug: "kite", metrics: {} }], median: {} },
+    showcaseWarnings: [],
+    showcaseWarningCodeCounts: {},
+    validation: { ok: true, errors: [], warnings: [] },
+    ...overrides
+});
+describe("evenlySpacedFrames", () => {
+    it("spans first to last frame inclusive, deduped and sorted", () => {
+        expect(evenlySpacedFrames(100, 5)).toEqual([0, 25, 50, 74, 99]);
+    });
+    it("never asks for more frames than the timeline has", () => {
+        expect(evenlySpacedFrames(3, 12)).toEqual([0, 1, 2]);
+    });
+    it("returns frame 0 for a single-frame or empty timeline", () => {
+        expect(evenlySpacedFrames(1, 12)).toEqual([0]);
+        expect(evenlySpacedFrames(0, 12)).toEqual([0]);
+    });
+});
+describe("renderTimelineScore", () => {
+    it("reports the score, penalty and reference band", () => {
+        const lines = renderTimelineScore(result());
+        expect(lines[0]).toContain("80.0/100");
+        expect(lines[0]).toContain("raw 80.0");
+        expect(lines.find((l) => l.includes("Reference band"))).toContain("kite");
+    });
+    it("lists showcase warnings when present, penalizing once per distinct code", () => {
+        const lines = renderTimelineScore(result({
+            score: 65,
+            rawScore: 75,
+            penalty: 10,
+            showcaseWarnings: [
+                {
+                    severity: "warning",
+                    code: "showcase_text_collision",
+                    message: "text overlaps text 1"
+                },
+                {
+                    severity: "warning",
+                    code: "showcase_text_collision",
+                    message: "text overlaps text 2"
+                },
+                {
+                    severity: "warning",
+                    code: "showcase_camera_missing",
+                    message: "no camera moves the scene"
+                }
+            ],
+            showcaseWarningCodeCounts: {
+                showcase_text_collision: 2,
+                showcase_camera_missing: 1
+            }
+        }));
+        expect(lines[0]).toContain("65.0/100");
+        expect(lines[0]).toContain("-10 for 2 distinct showcase warning code(s)");
+        expect(lines.some((l) => l.includes("showcase_text_collision ×2"))).toBe(true);
+        expect(lines.some((l) => l.includes("showcase_camera_missing ×1"))).toBe(true);
+        expect(lines.some((l) => l.includes("[showcase_text_collision] text overlaps text 1"))).toBe(true);
+    });
+    it("flags a document that failed validation", () => {
+        const lines = renderTimelineScore(result({
+            validation: {
+                ok: false,
+                errors: [
+                    { severity: "error", code: "schema_invalid", message: "bad" }
+                ],
+                warnings: []
+            }
+        }));
+        expect(lines.some((l) => l.includes("1 validation error"))).toBe(true);
+    });
+});
+//# sourceMappingURL=timeline-score.test.js.map

package/dist/commands/__tests__/timeline-score.test.js.map

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

package/dist/commands/affected.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `nodetool affected` — map changed files to the workspaces that need checking.
+ *
+ * With no file arguments it reads the working-tree changes from git. Prints the
+ * affected packages and the minimal build/test commands; `--json` for tooling.
+ */
+import type { Command } from "commander";
+export declare function registerAffectedCommand(program: Command): void;
+//# sourceMappingURL=affected.d.ts.map

package/dist/commands/affected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"affected.d.ts","sourceRoot":"","sources":["../../src/commands/affected.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwG9D"}

package/dist/commands/affected.js

@@ -0,0 +1,122 @@
+import { computeAffected, EXTRA_WORKSPACE_PATHS, TOP_LEVEL_WORKSPACES } from "../affected/affected.js";
+export function registerAffectedCommand(program) {
+    program
+        .command("affected [files...]")
+        .description("Map changed files (or git working-tree changes) to the workspaces that must be rebuilt/tested")
+        .option("--base <ref>", "Compare against a git ref (e.g. main) instead of the working tree")
+        .option("--json", "Print the result as JSON")
+        .action(async (files, opts) => {
+        try {
+            const { readFileSync, readdirSync, existsSync } = await import("node:fs");
+            const { join, resolve, dirname } = await import("node:path");
+            const { fileURLToPath } = await import("node:url");
+            const { execSync } = await import("node:child_process");
+            const here = dirname(fileURLToPath(import.meta.url));
+            // dist layout: packages/cli/dist/commands → repo root is four up.
+            const repoRoot = resolve(here, "..", "..", "..", "..");
+            // Workspaces come from the root package.json, not from a scan of
+            // packages/ — `reliability/harness` is a workspace too, and scanning
+            // one directory reported every change under it as belonging to no
+            // workspace at all.
+            const rootPkg = JSON.parse(readFileSync(join(repoRoot, "package.json"), "utf8"));
+            const topLevel = new Set(TOP_LEVEL_WORKSPACES);
+            const dirs = [];
+            for (const entry of rootPkg.workspaces ?? []) {
+                const pattern = entry.replace(/\/$/, "");
+                if (!pattern.endsWith("/*")) {
+                    dirs.push(pattern);
+                    continue;
+                }
+                const parent = pattern.slice(0, -2);
+                if (!existsSync(join(repoRoot, parent)))
+                    continue;
+                for (const child of readdirSync(join(repoRoot, parent), {
+                    withFileTypes: true
+                })) {
+                    if (child.isDirectory())
+                        dirs.push(`${parent}/${child.name}`);
+                }
+            }
+            const packages = [];
+            for (const dir of dirs) {
+                // web/electron get their own command shape in computeAffected.
+                if (topLevel.has(dir))
+                    continue;
+                const pkgJsonPath = join(repoRoot, dir, "package.json");
+                if (!existsSync(pkgJsonPath))
+                    continue;
+                try {
+                    const pkg = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+                    if (!pkg.name)
+                        continue;
+                    const allDeps = {
+                        ...(pkg.dependencies ?? {}),
+                        ...(pkg.devDependencies ?? {})
+                    };
+                    packages.push({
+                        name: pkg.name,
+                        dir,
+                        internalDeps: Object.keys(allDeps).filter((d) => d.startsWith("@nodetool-ai/")),
+                        ownedPaths: [...(EXTRA_WORKSPACE_PATHS[pkg.name] ?? [])]
+                    });
+                }
+                catch {
+                    // A malformed package.json shouldn't abort the whole mapping.
+                }
+            }
+            let changedFiles = files;
+            if (changedFiles.length === 0) {
+                const cmd = opts.base
+                    ? `git diff --name-only ${opts.base}...HEAD`
+                    : "git status --porcelain";
+                const out = execSync(cmd, { cwd: repoRoot, encoding: "utf8" });
+                changedFiles = opts.base
+                    ? out.split("\n").map((l) => l.trim()).filter(Boolean)
+                    : out
+                        .split("\n")
+                        .map((l) => l.slice(3).trim())
+                        .filter(Boolean);
+            }
+            const result = computeAffected(changedFiles, packages);
+            if (opts.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                printAffected(result, changedFiles.length);
+            }
+        }
+        catch (e) {
+            console.error(String(e));
+            process.exit(1);
+        }
+    });
+}
+function printAffected(result, fileCount) {
+    if (fileCount === 0) {
+        console.log("\nNo changed files detected.");
+        return;
+    }
+    console.log(`\n${result.affected.length} affected workspace(s) from ${fileCount} changed file(s):`);
+    for (const name of result.affected) {
+        const tag = result.changed.includes(name) ? "changed" : "dependent";
+        const build = result.needsBuild.includes(name) ? " (rebuild)" : "";
+        console.log(`  ${tag.padEnd(9)} ${name}${build}`);
+    }
+    if (result.unmatched.length > 0) {
+        console.log(`\n${result.unmatched.length} file(s) outside any workspace:`);
+        for (const f of result.unmatched.slice(0, 10))
+            console.log(`  ${f}`);
+        if (result.unmatched.length > 10) {
+            console.log(`  …and ${result.unmatched.length - 10} more`);
+        }
+    }
+    if (result.commands.length > 0) {
+        console.log("\nSuggested commands:");
+        for (const cmd of result.commands)
+            console.log(`  ${cmd}`);
+    }
+    else {
+        console.log("\nNo workspace commands needed.");
+    }
+}
+//# sourceMappingURL=affected.js.map

package/dist/commands/affected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affected.js","sourceRoot":"","sources":["../../src/commands/affected.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EAGrB,MAAM,yBAAyB,CAAC;AAOjC,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CACV,+FAA+F,CAChG;SACA,MAAM,CACL,cAAc,EACd,mEAAmE,CACpE;SACA,MAAM,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,KAAe,EAAE,IAAwB,EAAE,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAC5D,SAAS,CACV,CAAC;YACF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAC7D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAExD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,kEAAkE;YAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAEvD,iEAAiE;YACjE,qEAAqE;YACrE,kEAAkE;YAClE,oBAAoB;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CACxB,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACxB,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,oBAAoB,CAAC,CAAC;YACvD,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;gBAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACzC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACnB,SAAS;gBACX,CAAC;gBACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAAE,SAAS;gBAClD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACtD,aAAa,EAAE,IAAI;iBACpB,CAAC,EAAE,CAAC;oBACH,IAAI,KAAK,CAAC,WAAW,EAAE;wBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAkB,EAAE,CAAC;YACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,+DAA+D;gBAC/D,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAChC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;gBACxD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;oBAAE,SAAS;gBACvC,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAIvD,CAAC;oBACF,IAAI,CAAC,GAAG,CAAC,IAAI;wBAAE,SAAS;oBACxB,MAAM,OAAO,GAAG;wBACd,GAAG,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;wBAC3B,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;qBAC/B,CAAC;oBACF,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,GAAG;wBACH,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,CAC9B;wBACD,UAAU,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;qBACzD,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,8DAA8D;gBAChE,CAAC;YACH,CAAC;YAED,IAAI,YAAY,GAAG,KAAK,CAAC;YACzB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI;oBACnB,CAAC,CAAC,wBAAwB,IAAI,CAAC,IAAI,SAAS;oBAC5C,CAAC,CAAC,wBAAwB,CAAC;gBAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC/D,YAAY,GAAG,IAAI,CAAC,IAAI;oBACtB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBACtD,CAAC,CAAC,GAAG;yBACA,KAAK,CAAC,IAAI,CAAC;yBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBAC7B,MAAM,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YAED,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAEvD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,aAAa,CAAC,MAAsB,EAAE,SAAiB;IAC9D,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CACT,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,+BAA+B,SAAS,mBAAmB,CACvF,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;QACpE,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,MAAM,iCAAiC,CAAC,CAAC;QAC3E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC;AACH,CAAC"}

package/dist/commands/agent.d.ts

@@ -1,11 +1,33 @@
 /**
- * `nodetool agent` — load YAML agent configs and run them with full trace output.
+ * `nodetool agent` — run one CodeAct turn over the default toolbelt, with full
+ * trace output.
+ *
+ * The loop is the chat's loop: the belt is assembled by `buildCliAgentBelt`
+ * and the turn by `createCliCodeActTurn`, both shared with `--stdin` chat, so
+ * the provider is offered `execute_code` and the toolbelt lives in the sandbox.
+ * `create_plan` and `execute_plan` are on the belt, so an objective that wants
+ * a plan gets one and the `planning_update` / `task_update` events stream.
  *
  * Subcommands:
- *   nodetool agent run <yaml-file> [--objective "..."] [--mode loop|plan|multi-agent]
- *   nodetool agent test <yaml-file>     # validate config + dry list of tools/provider
- *   nodetool agent list <dir>           # list YAML configs in a directory
+ *   nodetool agent run --objective "..."   # objective may also come from stdin
+ *   nodetool agent diagnose <job_id>       # aggregate a failed run into a report
  */
 import { Command } from "commander";
+export interface RunOptions {
+    objective?: string;
+    provider?: string;
+    model?: string;
+    workspace?: string;
+    maxIterations?: string;
+    permissionMode?: string;
+    /** `--cost-cap <usd>`; `0` lifts the cap. Defaults to the agent settings. */
+    costCap?: string;
+    /** `--timeout <s>`; `0` leaves the run no time. Defaults to the settings. */
+    timeout?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+/** Exit code for the process: 0 when the turn finished without an error. */
+export declare function runAgentCommand(opts: RunOptions): Promise<number>;
 export declare function registerAgentCommands(program: Command): void;
 //# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwmBpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6C5D"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6JpC,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAcD,4EAA4E;AAC5E,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA+NvE;AAgJD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+D5D"}