@united-workforce/cli 0.1.0

package/dist/__tests__/step-show-json.test.js

@@ -0,0 +1,311 @@
+import { mkdir, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { bootstrap, putSchema } from "@ocas/core";
+import { openStore } from "@ocas/fs";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+import { cmdStepShow } from "../commands/step.js";
+import { formatOutput } from "../format.js";
+import { registerUwfSchemas } from "../schemas.js";
+const TURN_SCHEMA = {
+    title: "test-turn",
+    type: "object",
+    required: ["index", "role", "content"],
+    properties: {
+        index: { type: "integer" },
+        role: { type: "string", enum: ["assistant", "tool"] },
+        content: { type: "string" },
+        toolCalls: {
+            anyOf: [
+                {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        required: ["name", "args"],
+                        properties: {
+                            name: { type: "string" },
+                            args: { type: "string" },
+                        },
+                        additionalProperties: false,
+                    },
+                },
+                { type: "null" },
+            ],
+        },
+    },
+    additionalProperties: false,
+};
+const DETAIL_SCHEMA = {
+    title: "test-detail",
+    type: "object",
+    required: ["turns"],
+    properties: {
+        turns: {
+            type: "array",
+            items: { type: "string", format: "ocas_ref" },
+        },
+    },
+    additionalProperties: false,
+};
+async function setupTest(casDir) {
+    const store = await openStore(casDir);
+    await bootstrap(store);
+    const schemas = await registerUwfSchemas(store);
+    const [turnType, detailType] = await Promise.all([
+        putSchema(store, TURN_SCHEMA),
+        putSchema(store, DETAIL_SCHEMA),
+    ]);
+    return { store, schemas, turnType, detailType };
+}
+async function createTestStep(setup, turnPayloads) {
+    const { store, schemas, turnType, detailType } = setup;
+    // Create turn nodes
+    const turnHashes = [];
+    for (const payload of turnPayloads) {
+        const turnHash = await store.cas.put(turnType, payload);
+        turnHashes.push(turnHash);
+    }
+    // Create detail node
+    const detailHash = await store.cas.put(detailType, { turns: turnHashes });
+    // Create dummy start node
+    const startHash = await store.cas.put(schemas.startNode, {
+        workflow: "0000000000000",
+        prompt: "test prompt",
+        cwd: "/tmp",
+    });
+    // Create dummy output node
+    const outputHash = await store.cas.put(schemas.text, { $status: "done" });
+    // Create step node
+    const stepPayload = {
+        prev: null,
+        start: startHash,
+        role: "test-role",
+        agent: "test-agent",
+        output: outputHash,
+        detail: detailHash,
+        edgePrompt: "",
+        startedAtMs: Date.now(),
+        completedAtMs: Date.now() + 1000,
+        assembledPrompt: null,
+        cwd: "/tmp",
+        usage: null,
+    };
+    return store.cas.put(schemas.stepNode, stepPayload);
+}
+describe("cmdStepShow JSON serialization", () => {
+    let testDir;
+    let casDir;
+    let originalEnv;
+    beforeEach(async () => {
+        testDir = await mkdtemp(join(tmpdir(), "uwf-test-"));
+        casDir = join(testDir, "cas");
+        await mkdir(casDir, { recursive: true });
+        originalEnv = process.env.OCAS_HOME;
+        process.env.OCAS_HOME = casDir;
+    });
+    afterEach(async () => {
+        await rm(testDir, { recursive: true, force: true });
+        if (originalEnv === undefined) {
+            delete process.env.OCAS_HOME;
+        }
+        else {
+            process.env.OCAS_HOME = originalEnv;
+        }
+    });
+    test("escapes newlines in tool call args", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "Running command",
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: "echo 'line1'\necho 'line2'",
+                    },
+                ],
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+        expect(jsonOutput).toContain("\\n");
+        const parsed = JSON.parse(jsonOutput);
+        expect(parsed.turns[0].toolCalls[0].args).toContain("\n");
+    });
+    test("escapes tabs in tool call args", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "",
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: "cat <<EOF\nfield1\tfield2\tfield3\nEOF",
+                    },
+                ],
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+        expect(jsonOutput).toContain("\\t");
+    });
+    test("escapes carriage returns", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "Committing changes",
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: 'git commit -m "First line\r\nSecond line"',
+                    },
+                ],
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+        expect(jsonOutput).toContain("\\r\\n");
+    });
+    test("escapes backslashes and quotes", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "",
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: 'echo "He said \\"hello\\""',
+                    },
+                ],
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+        const parsed = JSON.parse(jsonOutput);
+        expect(parsed.turns).toBeDefined();
+    });
+    test("handles Unicode control characters", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "",
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: "echo '\u0001\u001F'",
+                    },
+                ],
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+    });
+    test("handles nested CAS refs with control characters", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "First turn\nwith newline",
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: "cmd1\nline2",
+                    },
+                ],
+            },
+            {
+                index: 1,
+                role: "assistant",
+                content: "Second turn\twith tab",
+                toolCalls: null,
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+        const parsed = JSON.parse(jsonOutput);
+        expect(parsed.turns).toHaveLength(2);
+    });
+    test("YAML output format is unaffected", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "Running command",
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: "echo 'line1'\necho 'line2'",
+                    },
+                ],
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const yamlOutput = formatOutput(result, "yaml");
+        expect(yamlOutput).toContain("turns:");
+        expect(yamlOutput.length).toBeGreaterThan(0);
+    });
+    test("handles empty and null values", async () => {
+        const setup = await setupTest(casDir);
+        const stepHash = await createTestStep(setup, [
+            {
+                index: 0,
+                role: "assistant",
+                content: "",
+                toolCalls: null,
+            },
+        ]);
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+        const parsed = JSON.parse(jsonOutput);
+        expect(parsed.turns).toBeDefined();
+    });
+    test("handles large step with multiple tool calls", async () => {
+        const setup = await setupTest(casDir);
+        const turns = [];
+        for (let i = 0; i < 25; i++) {
+            turns.push({
+                index: i,
+                role: "assistant",
+                content: `Turn ${i}\nwith newline`,
+                toolCalls: [
+                    {
+                        name: "Bash",
+                        args: `command${i}\nline2\tfield${i}`,
+                    },
+                    {
+                        name: "Read",
+                        args: `/path/to/file${i}`,
+                    },
+                ],
+            });
+        }
+        const stepHash = await createTestStep(setup, turns);
+        const startTime = Date.now();
+        const result = await cmdStepShow(testDir, stepHash);
+        const jsonOutput = formatOutput(result, "json");
+        const duration = Date.now() - startTime;
+        expect(duration).toBeLessThan(2000);
+        expect(() => JSON.parse(jsonOutput)).not.toThrow();
+        const parsed = JSON.parse(jsonOutput);
+        expect(parsed.turns).toHaveLength(25);
+    });
+});
+//# sourceMappingURL=step-show-json.test.js.map

package/dist/__tests__/step-show-json.test.js.map

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

package/dist/__tests__/step-timing.test.d.ts

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

package/dist/__tests__/step-timing.test.d.ts.map

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

package/dist/__tests__/step-timing.test.js

@@ -0,0 +1,345 @@
+import { mkdir, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { bootstrap, putSchema } from "@ocas/core";
+import { openStore } from "@ocas/fs";
+import { STEP_NODE_SCHEMA } from "@united-workforce/protocol";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+import { cmdStepList } from "../commands/step.js";
+import { cmdThreadRead } from "../commands/thread.js";
+import { registerUwfSchemas } from "../schemas.js";
+import { seedThreads } from "./thread-test-helpers.js";
+// ── schemas ──────────────────────────────────────────────────────────────────
+const TURN_SCHEMA = {
+    title: "hermes-turn",
+    type: "object",
+    required: ["index", "role", "content"],
+    properties: {
+        index: { type: "integer" },
+        role: { type: "string" },
+        content: { type: "string" },
+        toolCalls: {
+            anyOf: [
+                { type: "array", items: { type: "object" } },
+                { type: "null" },
+            ],
+        },
+        reasoning: { anyOf: [{ type: "string" }, { type: "null" }] },
+    },
+    additionalProperties: false,
+};
+const DETAIL_SCHEMA = {
+    title: "hermes-detail",
+    type: "object",
+    required: ["sessionId", "model", "duration", "turnCount", "turns"],
+    properties: {
+        sessionId: { type: "string" },
+        model: { type: "string" },
+        duration: { type: "integer" },
+        turnCount: { type: "integer" },
+        turns: {
+            type: "array",
+            items: { type: "string", format: "ocas_ref" },
+        },
+    },
+    additionalProperties: false,
+};
+// ── helpers ──────────────────────────────────────────────────────────────────
+async function registerDetailSchemas(store) {
+    await bootstrap(store);
+    const [turn, detail] = await Promise.all([
+        putSchema(store, TURN_SCHEMA),
+        putSchema(store, DETAIL_SCHEMA),
+    ]);
+    return { turn, detail };
+}
+// ── fixture ──────────────────────────────────────────────────────────────────
+let tmpDir;
+let originalEnv;
+beforeEach(async () => {
+    tmpDir = await mkdtemp(join(tmpdir(), "cli-uwf-step-timing-test-"));
+    originalEnv = process.env.OCAS_HOME;
+    process.env.OCAS_HOME = join(tmpDir, "cas");
+    await mkdir(process.env.OCAS_HOME, { recursive: true });
+});
+afterEach(async () => {
+    await rm(tmpDir, { recursive: true, force: true });
+    if (originalEnv === undefined) {
+        delete process.env.OCAS_HOME;
+    }
+    else {
+        process.env.OCAS_HOME = originalEnv;
+    }
+});
+// ── 1. Protocol types (compile-time) ─────────────────────────────────────────
+describe("protocol types", () => {
+    test("StepRecord has startedAtMs and completedAtMs as required fields", () => {
+        // Type-level test: this block compiles only if fields exist and are number
+        const record = {
+            role: "test",
+            output: "hash1",
+            detail: "hash2",
+            agent: "uwf-test",
+            edgePrompt: "",
+            startedAtMs: 1000,
+            completedAtMs: 2000,
+            assembledPrompt: null,
+            cwd: "/test/path",
+            usage: null,
+        };
+        expect(record.startedAtMs).toBe(1000);
+        expect(record.completedAtMs).toBe(2000);
+    });
+    test("StepEntry has durationMs as required field", () => {
+        const entry = {
+            hash: "hash",
+            role: "test",
+            output: {},
+            detail: "hash2",
+            agent: "uwf-test",
+            timestamp: 123,
+            durationMs: 5000,
+            usage: null,
+        };
+        expect(entry.durationMs).toBe(5000);
+    });
+});
+// ── 2. JSON Schema ───────────────────────────────────────────────────────────
+describe("StepNode JSON schema", () => {
+    test("schema requires startedAtMs and completedAtMs", () => {
+        const required = STEP_NODE_SCHEMA.required;
+        expect(required).toContain("startedAtMs");
+        expect(required).toContain("completedAtMs");
+    });
+    test("schema defines timing fields as integer", () => {
+        const props = STEP_NODE_SCHEMA.properties;
+        expect(props.startedAtMs.type).toBe("integer");
+        expect(props.completedAtMs.type).toBe("integer");
+    });
+    test("StepNode with timing fields passes CAS validation", async () => {
+        const casDir = join(tmpDir, "cas");
+        await mkdir(casDir, { recursive: true });
+        const store = await openStore(casDir);
+        const schemas = await registerUwfSchemas(store);
+        const startHash = await store.cas.put(schemas.startNode, {
+            workflow: "placeholder0000",
+            prompt: "test",
+        });
+        const outputHash = await store.cas.put(schemas.text, "output text");
+        const detailSchemas = await registerDetailSchemas(store);
+        const detailHash = await store.cas.put(detailSchemas.detail, {
+            sessionId: "s1",
+            model: "m1",
+            duration: 100,
+            turnCount: 0,
+            turns: [],
+        });
+        // Should succeed — valid timing fields
+        const hash = await store.cas.put(schemas.stepNode, {
+            start: startHash,
+            prev: null,
+            role: "worker",
+            output: outputHash,
+            detail: detailHash,
+            agent: "uwf-test",
+            edgePrompt: "",
+            startedAtMs: 1000000000000,
+            completedAtMs: 1000000005000,
+            assembledPrompt: null,
+        });
+        expect(hash).toBeTruthy();
+    });
+});
+// ── 3. step list — durationMs computed ───────────────────────────────────────
+describe("step list timing", () => {
+    test("step list includes durationMs = completedAtMs - startedAtMs", async () => {
+        const casDir = join(tmpDir, "cas");
+        await mkdir(casDir, { recursive: true });
+        const store = await openStore(casDir);
+        const schemas = await registerUwfSchemas(store);
+        const detailSchemas = await registerDetailSchemas(store);
+        const workflowHash = await store.cas.put(schemas.workflow, {
+            name: "test-wf",
+            description: "desc",
+            roles: {},
+            graph: {},
+        });
+        const startHash = await store.cas.put(schemas.startNode, {
+            workflow: workflowHash,
+            prompt: "test",
+        });
+        const outputHash = await store.cas.put(schemas.text, "output");
+        const detailHash = await store.cas.put(detailSchemas.detail, {
+            sessionId: "s1",
+            model: "m1",
+            duration: 100,
+            turnCount: 0,
+            turns: [],
+        });
+        const startedAt = 1716600000000;
+        const completedAt = 1716600003500;
+        const stepHash = await store.cas.put(schemas.stepNode, {
+            start: startHash,
+            prev: null,
+            role: "worker",
+            output: outputHash,
+            detail: detailHash,
+            agent: "uwf-test",
+            edgePrompt: "",
+            startedAtMs: startedAt,
+            completedAtMs: completedAt,
+        });
+        const threadId = "01HX2Q3R4S5T6V7W8X9YZ1";
+        await seedThreads(tmpDir, { [threadId]: stepHash });
+        const result = await cmdStepList(tmpDir, threadId);
+        const stepEntries = result.steps.slice(1); // skip start entry
+        expect(stepEntries).toHaveLength(1);
+        const step = stepEntries[0];
+        expect(step.durationMs).toBe(3500);
+    });
+});
+// ── 4. thread read — duration in header ──────────────────────────────────────
+describe("thread read timing", () => {
+    test("thread read header includes Duration", async () => {
+        const casDir = join(tmpDir, "cas");
+        await mkdir(casDir, { recursive: true });
+        const store = await openStore(casDir);
+        const schemas = await registerUwfSchemas(store);
+        const detailSchemas = await registerDetailSchemas(store);
+        const workflowHash = await store.cas.put(schemas.workflow, {
+            name: "test-wf",
+            description: "desc",
+            roles: {
+                worker: {
+                    description: "Worker",
+                    goal: "Do work",
+                    capabilities: [],
+                    procedure: "work",
+                    output: "result",
+                    frontmatter: "placeholder0000",
+                },
+            },
+            graph: {
+                $START: { _: { role: "worker", prompt: "go", location: null } },
+                worker: { done: { role: "$END", prompt: "", location: null } },
+            },
+        });
+        const startHash = await store.cas.put(schemas.startNode, {
+            workflow: workflowHash,
+            prompt: "test task",
+        });
+        const turnHash = await store.cas.put(detailSchemas.turn, {
+            index: 0,
+            role: "assistant",
+            content: "Done.",
+            toolCalls: null,
+            reasoning: null,
+        });
+        const detailHash = await store.cas.put(detailSchemas.detail, {
+            sessionId: "s1",
+            model: "m1",
+            duration: 100,
+            turnCount: 1,
+            turns: [turnHash],
+        });
+        const outputHash = await store.cas.put(schemas.text, "output");
+        const stepHash = await store.cas.put(schemas.stepNode, {
+            start: startHash,
+            prev: null,
+            role: "worker",
+            output: outputHash,
+            detail: detailHash,
+            agent: "uwf-test",
+            edgePrompt: "",
+            startedAtMs: 1716600000000,
+            completedAtMs: 1716600042000,
+        });
+        const threadId = "01HX2Q3R4S5T6V7W8X9YZ3";
+        await seedThreads(tmpDir, { [threadId]: stepHash });
+        const markdown = await cmdThreadRead(tmpDir, threadId, 10000, null, false);
+        expect(markdown).toContain("**Duration:** 42.0s");
+    });
+    test("thread read shows sub-second duration as ms", async () => {
+        const casDir = join(tmpDir, "cas");
+        await mkdir(casDir, { recursive: true });
+        const store = await openStore(casDir);
+        const schemas = await registerUwfSchemas(store);
+        const detailSchemas = await registerDetailSchemas(store);
+        const workflowHash = await store.cas.put(schemas.workflow, {
+            name: "test-wf",
+            description: "desc",
+            roles: {
+                worker: {
+                    description: "Worker",
+                    goal: "Do work",
+                    capabilities: [],
+                    procedure: "work",
+                    output: "result",
+                    frontmatter: "placeholder0000",
+                },
+            },
+            graph: {
+                $START: { _: { role: "worker", prompt: "go", location: null } },
+                worker: { done: { role: "$END", prompt: "", location: null } },
+            },
+        });
+        const startHash = await store.cas.put(schemas.startNode, {
+            workflow: workflowHash,
+            prompt: "test",
+        });
+        const turnHash = await store.cas.put(detailSchemas.turn, {
+            index: 0,
+            role: "assistant",
+            content: "Done.",
+            toolCalls: null,
+            reasoning: null,
+        });
+        const detailHash = await store.cas.put(detailSchemas.detail, {
+            sessionId: "s1",
+            model: "m1",
+            duration: 100,
+            turnCount: 1,
+            turns: [turnHash],
+        });
+        const outputHash = await store.cas.put(schemas.text, "output");
+        const stepHash = await store.cas.put(schemas.stepNode, {
+            start: startHash,
+            prev: null,
+            role: "worker",
+            output: outputHash,
+            detail: detailHash,
+            agent: "uwf-test",
+            edgePrompt: "",
+            startedAtMs: 1716600000000,
+            completedAtMs: 1716600000350,
+        });
+        const threadId = "01HX2Q3R4S5T6V7W8X9YZ4";
+        await seedThreads(tmpDir, { [threadId]: stepHash });
+        const markdown = await cmdThreadRead(tmpDir, threadId, 10000, null, false);
+        expect(markdown).toContain("**Duration:** 350ms");
+    });
+});
+// ── 6. Breaking change — old data without timing fails ───────────────────────
+describe("breaking change", () => {
+    test("StepNode schema rejects payload without timing fields", () => {
+        const required = STEP_NODE_SCHEMA.required;
+        // Both fields must be in the required array
+        expect(required).toContain("startedAtMs");
+        expect(required).toContain("completedAtMs");
+        // Payload without timing fields would fail schema validation
+        // because the schema marks them as required
+        const payloadWithoutTiming = {
+            start: "hash1",
+            prev: null,
+            role: "worker",
+            output: "hash2",
+            detail: "hash3",
+            agent: "uwf-test",
+            edgePrompt: "",
+        };
+        // Verify the payload is missing required fields
+        expect(payloadWithoutTiming).not.toHaveProperty("startedAtMs");
+        expect(payloadWithoutTiming).not.toHaveProperty("completedAtMs");
+    });
+});
+//# sourceMappingURL=step-timing.test.js.map