clinkx 0.3.0 → 1.1.0

package/clinkx-workflows/dist/dashboard/progress-report-contract.d.ts

@@ -0,0 +1,446 @@
+import { z } from "zod";
+/**
+ * Producer-side contract for the agent progress report document.
+ *
+ * This is the on-disk shape written by the producer (the progress-report
+ * skill). Field names are snake_case. The dashboard reader projects this
+ * document into the camelCase wire document defined in `contracts.ts`.
+ *
+ * Phase 0 of the dashboard integration owns only this schema, the session-id
+ * grammar, and the fixtures. The independent-section parse and the
+ * snake_case -> camelCase projection live in the reader (Phase 2).
+ */
+export declare const PROGRESS_REPORT_SCHEMA_VERSION: "progress-report-v1";
+/**
+ * Session identifier grammar: an ASCII slug starting alphanumeric, followed
+ * by up to 63 alphanumerics, underscores, or hyphens (64 chars total).
+ */
+export declare const ProgressReportSessionIdSchema: z.ZodString;
+export type ProgressReportSessionId = z.infer<typeof ProgressReportSessionIdSchema>;
+/** Short identifiers: name/role/agent/path/id. */
+export declare const BoundedIdSchema: z.ZodEffects<z.ZodString, string, string>;
+/** Mid-length free text: msg/activity/note. */
+export declare const BoundedMessageSchema: z.ZodEffects<z.ZodString, string, string>;
+/** Long free text: title/goal. */
+export declare const BoundedTitleSchema: z.ZodEffects<z.ZodString, string, string>;
+/**
+ * Absolute filesystem path for session.project_folder. The publisher requires it
+ * absolute (os.path.isabs); the dashboard contract and tolerant reader enforce
+ * the same invariant via the Node host's path.isAbsolute so a relative value is
+ * malformed (rejected wholesale / omitted) rather than silently admitted.
+ */
+export declare const ProjectFolderPathSchema: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+/**
+ * Canonical nonnegative safe-integer: an integer, `>= 0`, and `<=
+ * Number.MAX_SAFE_INTEGER`.
+ *
+ * `.min(0)` (or `.nonnegative()`) alone is NOT sufficient. `Number.MAX_SAFE_INTEGER + 1`
+ * (2^53) is exactly representable as a double, so Zod's `.int()` (`Number.isInteger`)
+ * accepts it and `.nonnegative()` only checks `>= 0` — leaving the browser's
+ * `Number.isSafeInteger` gate with no server-side parity. Capping at
+ * `Number.MAX_SAFE_INTEGER` closes that gap: the producer contract, the tolerant
+ * reader, and the wire/list response schemas all admit exactly the safe
+ * nonnegative integers the client already accepts. The three constraints together
+ * are equivalent to `Number.isSafeInteger(x) && x >= 0` for integers.
+ *
+ * Used for every progress-report nonnegative counter (file `adds`/`dels`, test
+ * `passed`/`failed`/`skipped`, list `agentCount`, `taskCounts.total`/`done`).
+ * Counters that can legitimately be signed are intentionally NOT covered here.
+ */
+export declare const NonnegativeSafeIntegerSchema: z.ZodNumber;
+export declare const StrictRfc3339TimestampSchema: z.ZodEffects<z.ZodString, string, string>;
+export declare const SessionStatusSchema: z.ZodEnum<["running", "paused", "blocked", "done", "failed"]>;
+export declare const AgentStatusSchema: z.ZodEnum<["working", "idle", "blocked", "done"]>;
+export declare const LogKindSchema: z.ZodEnum<["info", "success", "warn", "error"]>;
+export declare const SessionSectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodEffects<z.ZodString, string, string>;
+    goal: z.ZodEffects<z.ZodString, string, string>;
+    status: z.ZodEnum<["running", "paused", "blocked", "done", "failed"]>;
+    started_at: z.ZodEffects<z.ZodString, string, string>;
+    updated_at: z.ZodEffects<z.ZodString, string, string>;
+    project_folder: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+}, "strict", z.ZodTypeAny, {
+    status: "running" | "failed" | "paused" | "blocked" | "done";
+    id: string;
+    updated_at: string;
+    started_at: string;
+    title: string;
+    goal: string;
+    project_folder: string;
+}, {
+    status: "running" | "failed" | "paused" | "blocked" | "done";
+    id: string;
+    updated_at: string;
+    started_at: string;
+    title: string;
+    goal: string;
+    project_folder: string;
+}>;
+export declare const AgentSectionSchema: z.ZodObject<{
+    name: z.ZodEffects<z.ZodString, string, string>;
+    role: z.ZodEffects<z.ZodString, string, string>;
+    status: z.ZodEnum<["working", "idle", "blocked", "done"]>;
+    activity: z.ZodEffects<z.ZodString, string, string>;
+    updated_at: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    status: "idle" | "working" | "blocked" | "done";
+    role: string;
+    name: string;
+    updated_at: string;
+    activity: string;
+}, {
+    status: "idle" | "working" | "blocked" | "done";
+    role: string;
+    name: string;
+    updated_at: string;
+    activity: string;
+}>;
+export declare const TaskSectionSchema: z.ZodObject<{
+    id: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodEffects<z.ZodString, string, string>;
+    status: z.ZodEnum<["pending", "active", "done", "blocked", "failed"]>;
+    agent: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    note: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strict", z.ZodTypeAny, {
+    status: "pending" | "failed" | "blocked" | "done" | "active";
+    id: string;
+    title: string;
+    note?: string | undefined;
+    agent?: string | undefined;
+}, {
+    status: "pending" | "failed" | "blocked" | "done" | "active";
+    id: string;
+    title: string;
+    note?: string | undefined;
+    agent?: string | undefined;
+}>;
+export declare const LogEntrySchema: z.ZodObject<{
+    t: z.ZodEffects<z.ZodString, string, string>;
+    agent: z.ZodEffects<z.ZodString, string, string>;
+    kind: z.ZodEnum<["info", "success", "warn", "error"]>;
+    msg: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    kind: "info" | "error" | "warn" | "success";
+    agent: string;
+    t: string;
+    msg: string;
+}, {
+    kind: "info" | "error" | "warn" | "success";
+    agent: string;
+    t: string;
+    msg: string;
+}>;
+export declare const FileChangeEntrySchema: z.ZodObject<{
+    path: z.ZodEffects<z.ZodString, string, string>;
+    change: z.ZodEnum<["added", "modified", "deleted"]>;
+    adds: z.ZodNumber;
+    dels: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    change: "added" | "modified" | "deleted";
+    adds: number;
+    dels: number;
+}, {
+    path: string;
+    change: "added" | "modified" | "deleted";
+    adds: number;
+    dels: number;
+}>;
+export declare const TestsSectionSchema: z.ZodObject<{
+    passed: z.ZodNumber;
+    failed: z.ZodNumber;
+    skipped: z.ZodNumber;
+    failing: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    last_run: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    failed: number;
+    skipped: number;
+    passed: number;
+    failing: string[];
+    last_run: string;
+}, {
+    failed: number;
+    skipped: number;
+    passed: number;
+    failing: string[];
+    last_run: string;
+}>;
+export declare const BlockerEntrySchema: z.ZodObject<{
+    msg: z.ZodEffects<z.ZodString, string, string>;
+    raised_by: z.ZodEffects<z.ZodString, string, string>;
+    needs_human: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    msg: string;
+    raised_by: string;
+    needs_human: boolean;
+}, {
+    msg: string;
+    raised_by: string;
+    needs_human: boolean;
+}>;
+export declare const DecisionEntrySchema: z.ZodObject<{
+    t: z.ZodEffects<z.ZodString, string, string>;
+    by: z.ZodEffects<z.ZodString, string, string>;
+    msg: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    t: string;
+    msg: string;
+    by: string;
+}, {
+    t: string;
+    msg: string;
+    by: string;
+}>;
+export declare const ProgressReportDocumentSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"progress-report-v1">;
+    session: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodEffects<z.ZodString, string, string>;
+        goal: z.ZodEffects<z.ZodString, string, string>;
+        status: z.ZodEnum<["running", "paused", "blocked", "done", "failed"]>;
+        started_at: z.ZodEffects<z.ZodString, string, string>;
+        updated_at: z.ZodEffects<z.ZodString, string, string>;
+        project_folder: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        id: string;
+        updated_at: string;
+        started_at: string;
+        title: string;
+        goal: string;
+        project_folder: string;
+    }, {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        id: string;
+        updated_at: string;
+        started_at: string;
+        title: string;
+        goal: string;
+        project_folder: string;
+    }>;
+    agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodEffects<z.ZodString, string, string>;
+        role: z.ZodEffects<z.ZodString, string, string>;
+        status: z.ZodEnum<["working", "idle", "blocked", "done"]>;
+        activity: z.ZodEffects<z.ZodString, string, string>;
+        updated_at: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        status: "idle" | "working" | "blocked" | "done";
+        role: string;
+        name: string;
+        updated_at: string;
+        activity: string;
+    }, {
+        status: "idle" | "working" | "blocked" | "done";
+        role: string;
+        name: string;
+        updated_at: string;
+        activity: string;
+    }>, "many">>;
+    tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        title: z.ZodEffects<z.ZodString, string, string>;
+        status: z.ZodEnum<["pending", "active", "done", "blocked", "failed"]>;
+        agent: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        note: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strict", z.ZodTypeAny, {
+        status: "pending" | "failed" | "blocked" | "done" | "active";
+        id: string;
+        title: string;
+        note?: string | undefined;
+        agent?: string | undefined;
+    }, {
+        status: "pending" | "failed" | "blocked" | "done" | "active";
+        id: string;
+        title: string;
+        note?: string | undefined;
+        agent?: string | undefined;
+    }>, "many">>;
+    log: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        t: z.ZodEffects<z.ZodString, string, string>;
+        agent: z.ZodEffects<z.ZodString, string, string>;
+        kind: z.ZodEnum<["info", "success", "warn", "error"]>;
+        msg: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "info" | "error" | "warn" | "success";
+        agent: string;
+        t: string;
+        msg: string;
+    }, {
+        kind: "info" | "error" | "warn" | "success";
+        agent: string;
+        t: string;
+        msg: string;
+    }>, "many">>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodEffects<z.ZodString, string, string>;
+        change: z.ZodEnum<["added", "modified", "deleted"]>;
+        adds: z.ZodNumber;
+        dels: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        change: "added" | "modified" | "deleted";
+        adds: number;
+        dels: number;
+    }, {
+        path: string;
+        change: "added" | "modified" | "deleted";
+        adds: number;
+        dels: number;
+    }>, "many">>;
+    tests: z.ZodOptional<z.ZodObject<{
+        passed: z.ZodNumber;
+        failed: z.ZodNumber;
+        skipped: z.ZodNumber;
+        failing: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        last_run: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        failed: number;
+        skipped: number;
+        passed: number;
+        failing: string[];
+        last_run: string;
+    }, {
+        failed: number;
+        skipped: number;
+        passed: number;
+        failing: string[];
+        last_run: string;
+    }>>;
+    blockers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        msg: z.ZodEffects<z.ZodString, string, string>;
+        raised_by: z.ZodEffects<z.ZodString, string, string>;
+        needs_human: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        msg: string;
+        raised_by: string;
+        needs_human: boolean;
+    }, {
+        msg: string;
+        raised_by: string;
+        needs_human: boolean;
+    }>, "many">>;
+    decisions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        t: z.ZodEffects<z.ZodString, string, string>;
+        by: z.ZodEffects<z.ZodString, string, string>;
+        msg: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        t: string;
+        msg: string;
+        by: string;
+    }, {
+        t: string;
+        msg: string;
+        by: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    schema_version: "progress-report-v1";
+    session: {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        id: string;
+        updated_at: string;
+        started_at: string;
+        title: string;
+        goal: string;
+        project_folder: string;
+    };
+    blockers?: {
+        msg: string;
+        raised_by: string;
+        needs_human: boolean;
+    }[] | undefined;
+    tasks?: {
+        status: "pending" | "failed" | "blocked" | "done" | "active";
+        id: string;
+        title: string;
+        note?: string | undefined;
+        agent?: string | undefined;
+    }[] | undefined;
+    agents?: {
+        status: "idle" | "working" | "blocked" | "done";
+        role: string;
+        name: string;
+        updated_at: string;
+        activity: string;
+    }[] | undefined;
+    log?: {
+        kind: "info" | "error" | "warn" | "success";
+        agent: string;
+        t: string;
+        msg: string;
+    }[] | undefined;
+    files?: {
+        path: string;
+        change: "added" | "modified" | "deleted";
+        adds: number;
+        dels: number;
+    }[] | undefined;
+    tests?: {
+        failed: number;
+        skipped: number;
+        passed: number;
+        failing: string[];
+        last_run: string;
+    } | undefined;
+    decisions?: {
+        t: string;
+        msg: string;
+        by: string;
+    }[] | undefined;
+}, {
+    schema_version: "progress-report-v1";
+    session: {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        id: string;
+        updated_at: string;
+        started_at: string;
+        title: string;
+        goal: string;
+        project_folder: string;
+    };
+    blockers?: {
+        msg: string;
+        raised_by: string;
+        needs_human: boolean;
+    }[] | undefined;
+    tasks?: {
+        status: "pending" | "failed" | "blocked" | "done" | "active";
+        id: string;
+        title: string;
+        note?: string | undefined;
+        agent?: string | undefined;
+    }[] | undefined;
+    agents?: {
+        status: "idle" | "working" | "blocked" | "done";
+        role: string;
+        name: string;
+        updated_at: string;
+        activity: string;
+    }[] | undefined;
+    log?: {
+        kind: "info" | "error" | "warn" | "success";
+        agent: string;
+        t: string;
+        msg: string;
+    }[] | undefined;
+    files?: {
+        path: string;
+        change: "added" | "modified" | "deleted";
+        adds: number;
+        dels: number;
+    }[] | undefined;
+    tests?: {
+        failed: number;
+        skipped: number;
+        passed: number;
+        failing: string[];
+        last_run: string;
+    } | undefined;
+    decisions?: {
+        t: string;
+        msg: string;
+        by: string;
+    }[] | undefined;
+}>;
+export type ProgressReportDocument = z.infer<typeof ProgressReportDocumentSchema>;

package/clinkx-workflows/dist/dashboard/progress-report-contract.js

@@ -0,0 +1,221 @@
+import { isAbsolute } from "node:path";
+import { z } from "zod";
+/**
+ * Producer-side contract for the agent progress report document.
+ *
+ * This is the on-disk shape written by the producer (the progress-report
+ * skill). Field names are snake_case. The dashboard reader projects this
+ * document into the camelCase wire document defined in `contracts.ts`.
+ *
+ * Phase 0 of the dashboard integration owns only this schema, the session-id
+ * grammar, and the fixtures. The independent-section parse and the
+ * snake_case -> camelCase projection live in the reader (Phase 2).
+ */
+export const PROGRESS_REPORT_SCHEMA_VERSION = "progress-report-v1";
+// --- Session identifier grammar (task 0-8) ------------------------------
+/**
+ * Session identifier grammar: an ASCII slug starting alphanumeric, followed
+ * by up to 63 alphanumerics, underscores, or hyphens (64 chars total).
+ */
+export const ProgressReportSessionIdSchema = z
+    .string()
+    .regex(/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/);
+// --- Bounded string primitives (task 0-7) -------------------------------
+/**
+ * Bound a string by Unicode CODE POINTS, not UTF-16 code units (Zod's `.max()`
+ * default). An astral-plane character (e.g. an emoji) is one code point but two
+ * UTF-16 code units. A `.max(N)` code-unit bound would therefore reject an
+ * astral-heavy string before it reaches the producer's N-code-point limit.
+ * Counting code points here keeps the producer contract and tolerant reader on
+ * the same bound as Python's code-point-counting `len()`.
+ *
+ * Allocation-free and early-exiting: the JS string iterator combines each
+ * well-formed surrogate pair into one code point without materializing an array,
+ * and this returns false the instant the count exceeds `max`. A near-cap
+ * malformed string therefore validates in O(max) time and O(1) space instead of
+ * allocating an `Array.from(value)` whose length is the whole string (the
+ * previous implementation). Byte caps are tracked separately and unaffected.
+ */
+function atMostCodePoints(max) {
+    return (value) => {
+        let count = 0;
+        // Iterate code points directly off the string iterator (no array allocation,
+        // no unused loop binding) and stop the instant the bound is exceeded.
+        const codePoints = value[Symbol.iterator]();
+        while (!codePoints.next().done) {
+            count += 1;
+            if (count > max)
+                return false;
+        }
+        return true;
+    };
+}
+/** Short identifiers: name/role/agent/path/id. */
+export const BoundedIdSchema = z
+    .string()
+    .min(1)
+    .refine(atMostCodePoints(256), { message: "must be at most 256 Unicode code points" });
+/** Mid-length free text: msg/activity/note. */
+export const BoundedMessageSchema = z
+    .string()
+    .min(1)
+    .refine(atMostCodePoints(300), { message: "must be at most 300 Unicode code points" });
+/** Long free text: title/goal. */
+export const BoundedTitleSchema = z
+    .string()
+    .min(1)
+    .refine(atMostCodePoints(500), { message: "must be at most 500 Unicode code points" });
+/**
+ * Absolute filesystem path for session.project_folder. The publisher requires it
+ * absolute (os.path.isabs); the dashboard contract and tolerant reader enforce
+ * the same invariant via the Node host's path.isAbsolute so a relative value is
+ * malformed (rejected wholesale / omitted) rather than silently admitted.
+ */
+export const ProjectFolderPathSchema = z
+    .string()
+    .min(1)
+    .refine(atMostCodePoints(500), { message: "must be at most 500 Unicode code points" })
+    .refine(isAbsolute, { message: "session.project_folder must be an absolute path" });
+/**
+ * Canonical nonnegative safe-integer: an integer, `>= 0`, and `<=
+ * Number.MAX_SAFE_INTEGER`.
+ *
+ * `.min(0)` (or `.nonnegative()`) alone is NOT sufficient. `Number.MAX_SAFE_INTEGER + 1`
+ * (2^53) is exactly representable as a double, so Zod's `.int()` (`Number.isInteger`)
+ * accepts it and `.nonnegative()` only checks `>= 0` — leaving the browser's
+ * `Number.isSafeInteger` gate with no server-side parity. Capping at
+ * `Number.MAX_SAFE_INTEGER` closes that gap: the producer contract, the tolerant
+ * reader, and the wire/list response schemas all admit exactly the safe
+ * nonnegative integers the client already accepts. The three constraints together
+ * are equivalent to `Number.isSafeInteger(x) && x >= 0` for integers.
+ *
+ * Used for every progress-report nonnegative counter (file `adds`/`dels`, test
+ * `passed`/`failed`/`skipped`, list `agentCount`, `taskCounts.total`/`done`).
+ * Counters that can legitimately be signed are intentionally NOT covered here.
+ */
+export const NonnegativeSafeIntegerSchema = z
+    .number()
+    .int()
+    .min(0)
+    .max(Number.MAX_SAFE_INTEGER);
+/**
+ * Strict RFC3339 timestamp: uppercase T/Z, a 4-digit calendar year 0001-9999,
+ * real calendar validation, legal UTC-offset bounds, and a finite epoch. Shared
+ * by the producer contract, the tolerant reader, and the progress-report wire
+ * schemas so every layer agrees on what a timestamp means and the list
+ * comparator's `Date.parse` is always defined.
+ *
+ * `z.string().datetime({ offset: true })` already rejects impossible calendar
+ * dates (e.g. `2026-02-30`) but accepts out-of-range offsets such as `+24:00`,
+ * for which `Date.parse` is `NaN`, and the year 0000, whose epoch is finite on
+ * V8 but rejected by Python `datetime` (MINYEAR=1). This refine additionally
+ * bounds the year (0001-9999) and offset (hours 0-23, minutes 0-59) and
+ * requires a finite epoch, matching the publisher's canonical rule.
+ */
+const RFC3339_YEAR_PATTERN = /^(\d{4})-/;
+const RFC3339_OFFSET_PATTERN = /([+-])(\d{2}):(\d{2})$/;
+function isValidRfc3339Instant(value) {
+    const yearMatch = RFC3339_YEAR_PATTERN.exec(value);
+    if (yearMatch === null)
+        return false;
+    const year = Number(yearMatch[1]);
+    if (year < 1 || year > 9999)
+        return false;
+    const match = RFC3339_OFFSET_PATTERN.exec(value);
+    if (match !== null) {
+        const offsetHours = Number(match[2]);
+        const offsetMinutes = Number(match[3]);
+        if (offsetHours > 23 || offsetMinutes > 59)
+            return false;
+    }
+    return Number.isFinite(Date.parse(value));
+}
+export const StrictRfc3339TimestampSchema = z
+    .string()
+    .datetime({ offset: true })
+    .refine(isValidRfc3339Instant, { message: "invalid RFC3339 timestamp" });
+const TimestampSchema = StrictRfc3339TimestampSchema;
+// --- Enum literals (authoritative from SKILL.md) ------------------------
+export const SessionStatusSchema = z.enum([
+    "running",
+    "paused",
+    "blocked",
+    "done",
+    "failed",
+]);
+export const AgentStatusSchema = z.enum(["working", "idle", "blocked", "done"]);
+const TaskStatusSchema = z.enum([
+    "pending",
+    "active",
+    "done",
+    "blocked",
+    "failed",
+]);
+export const LogKindSchema = z.enum(["info", "success", "warn", "error"]);
+const FileChangeSchema = z.enum(["added", "modified", "deleted"]);
+// --- Section schemas (8 sections, 1 required + 7 optional) --------------
+export const SessionSectionSchema = z.object({
+    id: ProgressReportSessionIdSchema,
+    title: BoundedTitleSchema,
+    goal: BoundedTitleSchema,
+    status: SessionStatusSchema,
+    started_at: TimestampSchema,
+    updated_at: TimestampSchema,
+    project_folder: ProjectFolderPathSchema,
+}).strict();
+export const AgentSectionSchema = z.object({
+    name: BoundedIdSchema,
+    role: BoundedIdSchema,
+    status: AgentStatusSchema,
+    activity: BoundedMessageSchema,
+    updated_at: TimestampSchema,
+}).strict();
+export const TaskSectionSchema = z.object({
+    id: BoundedIdSchema,
+    title: BoundedTitleSchema,
+    status: TaskStatusSchema,
+    agent: BoundedIdSchema.optional(),
+    note: BoundedMessageSchema.optional(),
+}).strict();
+export const LogEntrySchema = z.object({
+    t: TimestampSchema,
+    agent: BoundedIdSchema,
+    kind: LogKindSchema,
+    msg: BoundedMessageSchema,
+}).strict();
+export const FileChangeEntrySchema = z.object({
+    path: BoundedIdSchema,
+    change: FileChangeSchema,
+    adds: NonnegativeSafeIntegerSchema,
+    dels: NonnegativeSafeIntegerSchema,
+}).strict();
+export const TestsSectionSchema = z.object({
+    passed: NonnegativeSafeIntegerSchema,
+    failed: NonnegativeSafeIntegerSchema,
+    skipped: NonnegativeSafeIntegerSchema,
+    failing: z.array(BoundedMessageSchema).max(100),
+    last_run: TimestampSchema,
+}).strict();
+export const BlockerEntrySchema = z.object({
+    msg: BoundedMessageSchema,
+    raised_by: BoundedIdSchema,
+    needs_human: z.boolean(),
+}).strict();
+export const DecisionEntrySchema = z.object({
+    t: TimestampSchema,
+    by: BoundedIdSchema,
+    msg: BoundedMessageSchema,
+}).strict();
+// --- Producer document (task 0-1) ---------------------------------------
+export const ProgressReportDocumentSchema = z.object({
+    schema_version: z.literal(PROGRESS_REPORT_SCHEMA_VERSION),
+    session: SessionSectionSchema,
+    agents: z.array(AgentSectionSchema).max(50).optional(),
+    tasks: z.array(TaskSectionSchema).max(200).optional(),
+    log: z.array(LogEntrySchema).max(200).optional(),
+    files: z.array(FileChangeEntrySchema).max(500).optional(),
+    tests: TestsSectionSchema.optional(),
+    blockers: z.array(BlockerEntrySchema).max(50).optional(),
+    decisions: z.array(DecisionEntrySchema).max(100).optional(),
+}).strict();
+//# sourceMappingURL=progress-report-contract.js.map

package/clinkx-workflows/dist/dashboard/progress-report-contract.js.map

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