@agent-arc-status/reference 0.3.0

package/dist/validate.js

@@ -0,0 +1,327 @@
+/**
+ * Runtime validator for arc.status events.
+ *
+ * Mirrors the JSON Schema in `spec/schema.json` but is hand-rolled so the
+ * reference implementation ships with zero runtime dependencies. For users
+ * who want canonical-schema validation, `spec/schema.json` is also published
+ * and works with any standard JSON Schema validator (e.g. ajv).
+ */
+import { ARC_STATUS_PHASES, } from "./types.js";
+/**
+ * Canonical RFC 3339 grammar for `sent_at`, kept as a string so it can be
+ * shared byte-for-byte with `spec/schema.json`'s `sent_at.pattern`. The
+ * equivalence test asserts the two are identical, preventing future drift.
+ *
+ * It bounds month (01–12), day (01–31), hour (00–23), minute/second (00–59),
+ * and the UTC offset (≤ ±14:00); fractional seconds are optional (1–9 digits).
+ * It rejects leap seconds (`:60`), lowercase `t`/`z`, and the space separator.
+ * Per-month calendar validity (e.g. Feb 30) cannot be expressed portably in a
+ * regex and is enforced by `isValidCalendarDate` below.
+ */
+export const RFC3339_PATTERN = "^\\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(\\.\\d{1,9})?(Z|[+-](0\\d|1[0-4]):[0-5]\\d)$";
+const RFC3339_RE = new RegExp(RFC3339_PATTERN);
+const PROTOCOL_VERSION_RE = /^\d+\.\d+(\.\d+)?$/;
+/**
+ * The fields the Protocol defines. Any other key is a conformance violation
+ * unless it is an `x_`-prefixed application extension (spec §3.2). Mirrors the
+ * schema's `additionalProperties:false` + `patternProperties:{"^x_":{}}`.
+ */
+const KNOWN_KEYS = new Set([
+    "arc_id",
+    "phase",
+    "title",
+    "body",
+    "step",
+    "total",
+    "eta_minutes",
+    "sent_at",
+    "arc_kind",
+    "protocol_version",
+]);
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPhase(value) {
+    return (typeof value === "string" &&
+        ARC_STATUS_PHASES.includes(value));
+}
+/**
+ * The RFC 3339 grammar admits day 01–31 for every month; this rejects the
+ * calendar-impossible combinations the regex cannot (e.g. 2026-02-30,
+ * 2026-04-31) by round-tripping the date components through `Date.UTC` and
+ * checking nothing rolled over (Feb 30 → Mar 2). Assumes the string already
+ * matched `RFC3339_RE`, so the slices are well-formed.
+ */
+function isValidCalendarDate(ts) {
+    const year = Number(ts.slice(0, 4));
+    const month = Number(ts.slice(5, 7));
+    const day = Number(ts.slice(8, 10));
+    const probe = new Date(Date.UTC(year, month - 1, day));
+    return (probe.getUTCFullYear() === year &&
+        probe.getUTCMonth() + 1 === month &&
+        probe.getUTCDate() === day);
+}
+/**
+ * Validate a candidate event against the Protocol's wire-format rules.
+ *
+ * This checks structural conformance only: required fields present, types
+ * correct, enums respected, numeric bounds satisfied, timestamp parseable.
+ *
+ * It does NOT validate phase-ordering rules across a sequence of events;
+ * see `validateSequence` for that.
+ */
+export function validate(candidate) {
+    const issues = [];
+    if (!isPlainObject(candidate)) {
+        return {
+            ok: false,
+            issues: [{ path: "", message: "event must be a JSON object" }],
+        };
+    }
+    const e = candidate;
+    // unknown fields: only x_-prefixed extensions are permitted (spec §3.2)
+    for (const key of Object.keys(e)) {
+        if (!KNOWN_KEYS.has(key) && !key.startsWith("x_")) {
+            issues.push({
+                path: key,
+                message: "unknown field; only x_-prefixed extensions are permitted",
+            });
+        }
+    }
+    // arc_id
+    if (typeof e.arc_id !== "string") {
+        issues.push({ path: "arc_id", message: "must be a string" });
+    }
+    else if (e.arc_id.length < 1 || e.arc_id.length > 128) {
+        issues.push({
+            path: "arc_id",
+            message: "must be between 1 and 128 characters",
+        });
+    }
+    // phase
+    if (!isPhase(e.phase)) {
+        issues.push({
+            path: "phase",
+            message: `must be one of: ${ARC_STATUS_PHASES.join(", ")}`,
+        });
+    }
+    // title
+    if (typeof e.title !== "string") {
+        issues.push({ path: "title", message: "must be a string" });
+    }
+    else if (e.title.length < 1 || e.title.length > 200) {
+        issues.push({
+            path: "title",
+            message: "must be between 1 and 200 characters",
+        });
+    }
+    else if (e.title.includes("\n")) {
+        issues.push({
+            path: "title",
+            message: "should not contain newlines (use body for multi-line content)",
+        });
+    }
+    // sent_at
+    if (typeof e.sent_at !== "string") {
+        issues.push({ path: "sent_at", message: "must be a string" });
+    }
+    else if (!RFC3339_RE.test(e.sent_at)) {
+        issues.push({
+            path: "sent_at",
+            message: "must be an RFC 3339 timestamp (canonical: YYYY-MM-DDTHH:MM:SS[.fff]Z)",
+        });
+    }
+    else if (!isValidCalendarDate(e.sent_at)) {
+        issues.push({ path: "sent_at", message: "is not a valid calendar date" });
+    }
+    // body
+    if (e.body !== undefined) {
+        if (typeof e.body !== "string") {
+            issues.push({ path: "body", message: "must be a string when present" });
+        }
+        else if (e.body.length > 32000) {
+            issues.push({ path: "body", message: "must be ≤ 32000 characters" });
+        }
+    }
+    // step
+    if (e.step !== undefined) {
+        if (typeof e.step !== "number" || !Number.isInteger(e.step) || e.step < 1) {
+            issues.push({ path: "step", message: "must be an integer ≥ 1" });
+        }
+    }
+    // total
+    if (e.total !== undefined) {
+        if (typeof e.total !== "number" ||
+            !Number.isInteger(e.total) ||
+            e.total < 1) {
+            issues.push({ path: "total", message: "must be an integer ≥ 1" });
+        }
+    }
+    // step ≤ total
+    if (typeof e.step === "number" &&
+        typeof e.total === "number" &&
+        Number.isInteger(e.step) &&
+        Number.isInteger(e.total) &&
+        e.step > e.total) {
+        issues.push({
+            path: "step",
+            message: "must be ≤ total when both are present",
+        });
+    }
+    // eta_minutes
+    if (e.eta_minutes !== undefined) {
+        if (typeof e.eta_minutes !== "number" || e.eta_minutes < 0) {
+            issues.push({
+                path: "eta_minutes",
+                message: "must be a number ≥ 0",
+            });
+        }
+    }
+    // arc_kind
+    if (e.arc_kind !== undefined) {
+        if (typeof e.arc_kind !== "string") {
+            issues.push({ path: "arc_kind", message: "must be a string when present" });
+        }
+        else if (e.arc_kind.length > 64) {
+            issues.push({ path: "arc_kind", message: "must be ≤ 64 characters" });
+        }
+    }
+    // protocol_version
+    if (e.protocol_version !== undefined) {
+        if (typeof e.protocol_version !== "string") {
+            issues.push({
+                path: "protocol_version",
+                message: "must be a string when present",
+            });
+        }
+        else if (!PROTOCOL_VERSION_RE.test(e.protocol_version)) {
+            issues.push({
+                path: "protocol_version",
+                message: "must match <major>.<minor>(.<patch>)?",
+            });
+        }
+    }
+    if (issues.length > 0) {
+        return { ok: false, issues };
+    }
+    return { ok: true, event: e };
+}
+/**
+ * Validate phase-ordering for a sequence of events belonging to a single arc.
+ *
+ * Enforces §4.5–§4.6 of the spec:
+ *   - exactly one `started`, at the beginning
+ *   - the last event is a terminal (`done` or terminal `blocked`), unless
+ *     `options.partial` is set (in-flight prefix)
+ *   - at most one `done`, and no events after it
+ *   - after `blocked`, the next event is `milestone` (resume), `done`, or
+ *     end-of-arc; `started`, `heartbeat`, and a second consecutive `blocked`
+ *     are illegal
+ *   - (optional) `sent_at` is non-decreasing when `checkMonotonicSentAt` is set
+ *
+ * Does NOT re-validate individual events; call `validate` first if needed.
+ */
+export function validateSequence(events, options = {}) {
+    const issues = [];
+    if (events.length === 0) {
+        return { ok: true, issues };
+    }
+    // arc_id consistency
+    const arcId = events[0]?.arc_id;
+    for (let i = 1; i < events.length; i++) {
+        if (events[i]?.arc_id !== arcId) {
+            issues.push({
+                index: i,
+                message: `arc_id mismatch: expected ${arcId}, got ${events[i]?.arc_id}`,
+            });
+        }
+    }
+    // first event must be started
+    if (events[0]?.phase !== "started") {
+        issues.push({
+            index: 0,
+            message: "first event in an arc must be phase=started",
+        });
+    }
+    // exactly one started, exactly one done (or arc may terminate in blocked)
+    let startedCount = 0;
+    let doneCount = 0;
+    let sawDoneAt = null;
+    for (let i = 0; i < events.length; i++) {
+        const phase = events[i]?.phase;
+        if (phase === "started")
+            startedCount++;
+        if (phase === "done") {
+            doneCount++;
+            if (sawDoneAt === null)
+                sawDoneAt = i;
+        }
+    }
+    if (startedCount !== 1) {
+        issues.push({
+            index: 0,
+            message: `arc must contain exactly one started event, found ${startedCount}`,
+        });
+    }
+    if (doneCount > 1) {
+        issues.push({
+            index: 0,
+            message: `arc must contain at most one done event, found ${doneCount}`,
+        });
+    }
+    if (sawDoneAt !== null && sawDoneAt !== events.length - 1) {
+        issues.push({
+            index: sawDoneAt,
+            message: "no events may follow a done event",
+        });
+    }
+    // after blocked, next non-blocked phase must be milestone or done
+    for (let i = 0; i < events.length - 1; i++) {
+        if (events[i]?.phase === "blocked") {
+            const next = events[i + 1]?.phase;
+            if (next === "started") {
+                issues.push({
+                    index: i + 1,
+                    message: "started cannot follow blocked",
+                });
+            }
+            if (next === "heartbeat") {
+                issues.push({
+                    index: i + 1,
+                    message: "blocked must be followed by milestone (resume), done (resolve), or end-of-arc; heartbeat is not a legal resume signal",
+                });
+            }
+            if (next === "blocked") {
+                issues.push({
+                    index: i + 1,
+                    message: "consecutive blocked events are not allowed; emit a milestone (resume) before re-blocking (§4.5)",
+                });
+            }
+        }
+    }
+    // last event must be a terminal for a complete arc (§4.6)
+    if (!options.partial) {
+        const lastPhase = events[events.length - 1]?.phase;
+        if (lastPhase !== "done" && lastPhase !== "blocked") {
+            issues.push({
+                index: events.length - 1,
+                message: "a complete arc must end in a terminal event (done or terminal blocked); pass { partial: true } to validate an in-flight prefix",
+            });
+        }
+    }
+    // optional: sent_at non-decreasing in emission order (off by default; §7.5)
+    if (options.checkMonotonicSentAt) {
+        for (let i = 1; i < events.length; i++) {
+            const prev = Date.parse(events[i - 1]?.sent_at ?? "");
+            const cur = Date.parse(events[i]?.sent_at ?? "");
+            if (!Number.isNaN(prev) && !Number.isNaN(cur) && cur < prev) {
+                issues.push({
+                    index: i,
+                    message: "sent_at decreased from the previous event; not allowed when checkMonotonicSentAt is set",
+                });
+            }
+        }
+    }
+    return { ok: issues.length === 0, issues };
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@agent-arc-status/reference",
+  "version": "0.3.0",
+  "description": "Reference implementation of the Agent Arc Status Protocol: types, parser, validator, renderer, cadence, state, and delegation-tree tooling. Zero runtime dependencies.",
+  "license": "MIT",
+  "author": "Joe Fisher",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/joethefisher/agent-arc-status.git",
+    "directory": "packages/reference"
+  },
+  "homepage": "https://github.com/joethefisher/agent-arc-status#readme",
+  "bugs": "https://github.com/joethefisher/agent-arc-status/issues",
+  "keywords": [
+    "agent",
+    "agents",
+    "ai",
+    "llm",
+    "observability",
+    "progress",
+    "webhook",
+    "arc-status"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}