@authorbot/schemas 0.1.0

package/dist/json-schemas.d.ts

@@ -0,0 +1,455 @@
+import { z } from "zod";
+/** All artifact schemas keyed by the JSON Schema output file basename. */
+export declare const artifactSchemas: {
+    readonly book: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.book/v1">;
+        id: z.ZodString;
+        title: z.ZodString;
+        slug: z.ZodString;
+        language: z.ZodString;
+        license: z.ZodOptional<z.ZodString>;
+        repository: z.ZodOptional<z.ZodObject<{
+            default_branch: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        content: z.ZodOptional<z.ZodObject<{
+            chapters_glob: z.ZodOptional<z.ZodString>;
+            raw_html: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        planning: z.ZodOptional<z.ZodObject<{
+            method: z.ZodOptional<z.ZodString>;
+            outline: z.ZodOptional<z.ZodString>;
+            timeline: z.ZodOptional<z.ZodString>;
+            characters_glob: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        publication: z.ZodOptional<z.ZodObject<{
+            chapter_url: z.ZodOptional<z.ZodString>;
+            api_url: z.ZodOptional<z.ZodString>;
+            show_revision: z.ZodOptional<z.ZodBoolean>;
+            show_attribution: z.ZodOptional<z.ZodBoolean>;
+            show_public_annotations: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        collaboration: z.ZodOptional<z.ZodObject<{
+            annotation_policy: z.ZodOptional<z.ZodEnum<{
+                open: "open";
+                "approval-gated": "approval-gated";
+                "collaborators-only": "collaborators-only";
+                locked: "locked";
+            }>>;
+        }, z.core.$strict>>;
+        governance: z.ZodOptional<z.ZodObject<{
+            rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                version: z.ZodNumber;
+                trigger: z.ZodOptional<z.ZodEnum<{
+                    vote_changed: "vote_changed";
+                }>>;
+                when: z.ZodUnion<readonly [z.ZodObject<{
+                    all: z.ZodArray<z.ZodObject<{
+                        metric: z.ZodString;
+                        operator: z.ZodEnum<{
+                            gte: "gte";
+                            gt: "gt";
+                            lte: "lte";
+                            lt: "lt";
+                            eq: "eq";
+                            neq: "neq";
+                        }>;
+                        value: z.ZodNumber;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    any: z.ZodArray<z.ZodObject<{
+                        metric: z.ZodString;
+                        operator: z.ZodEnum<{
+                            gte: "gte";
+                            gt: "gt";
+                            lte: "lte";
+                            lt: "lt";
+                            eq: "eq";
+                            neq: "neq";
+                        }>;
+                        value: z.ZodNumber;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>]>;
+                action: z.ZodObject<{
+                    type: z.ZodLiteral<"create_work_item">;
+                    work_type: z.ZodEnum<{
+                        revise_range: "revise_range";
+                        revise_block: "revise_block";
+                        revise_chapter: "revise_chapter";
+                        write_chapter: "write_chapter";
+                        resolve_conflict: "resolve_conflict";
+                        planning: "planning";
+                    }>;
+                }, z.core.$strict>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly chapter: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.chapter/v1">;
+        id: z.ZodString;
+        slug: z.ZodString;
+        title: z.ZodString;
+        order: z.ZodNumber;
+        status: z.ZodEnum<{
+            draft: "draft";
+            proposed: "proposed";
+            published: "published";
+            archived: "archived";
+        }>;
+        revision: z.ZodNumber;
+        published_at: z.ZodOptional<z.ZodString>;
+        authors: z.ZodArray<z.ZodObject<{
+            actor: z.ZodString;
+        }, z.core.$strict>>;
+        summary: z.ZodOptional<z.ZodString>;
+        timeline_refs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        character_refs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    readonly "story-graph": z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.story-graph/v1">;
+        nodes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"chapter">;
+            chapter_id: z.ZodString;
+            status: z.ZodOptional<z.ZodEnum<{
+                draft: "draft";
+                proposed: "proposed";
+                published: "published";
+                archived: "archived";
+            }>>;
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            parent: z.ZodOptional<z.ZodString>;
+            order: z.ZodNumber;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                premise: "premise";
+                arc: "arc";
+                part: "part";
+                scene: "scene";
+                beat: "beat";
+                custom: "custom";
+            }>;
+            goal: z.ZodOptional<z.ZodString>;
+            conflict: z.ZodOptional<z.ZodString>;
+            outcome: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+            parent: z.ZodOptional<z.ZodString>;
+            order: z.ZodNumber;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>], "type">>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            type: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+    readonly timeline: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.timeline/v1">;
+        calendar: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+            epoch_label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        events: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            sort_key: z.ZodNumber;
+            display_time: z.ZodString;
+            title: z.ZodString;
+            participants: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            locations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            chapter_refs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            facts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly character: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.character/v1">;
+        id: z.ZodString;
+        name: z.ZodString;
+        aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        summary: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly annotation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        scope: z.ZodLiteral<"range">;
+        target: z.ZodObject<{
+            blockId: z.ZodString;
+            textPosition: z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+            }, z.core.$strict>;
+            textQuote: z.ZodObject<{
+                exact: z.ZodString;
+                prefix: z.ZodOptional<z.ZodString>;
+                suffix: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        schema: z.ZodLiteral<"authorbot.annotation/v1">;
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            comment: "comment";
+            suggestion: "suggestion";
+        }>;
+        chapter_id: z.ZodString;
+        chapter_revision: z.ZodNumber;
+        author: z.ZodString;
+        status: z.ZodEnum<{
+            open: "open";
+            work_item_created: "work_item_created";
+            accepted: "accepted";
+            resolved: "resolved";
+            rejected: "rejected";
+            withdrawn: "withdrawn";
+            superseded: "superseded";
+            orphaned: "orphaned";
+            needs_reanchor: "needs_reanchor";
+        }>;
+        created_at: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        scope: z.ZodLiteral<"block">;
+        target: z.ZodObject<{
+            blockId: z.ZodString;
+        }, z.core.$strict>;
+        schema: z.ZodLiteral<"authorbot.annotation/v1">;
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            comment: "comment";
+            suggestion: "suggestion";
+        }>;
+        chapter_id: z.ZodString;
+        chapter_revision: z.ZodNumber;
+        author: z.ZodString;
+        status: z.ZodEnum<{
+            open: "open";
+            work_item_created: "work_item_created";
+            accepted: "accepted";
+            resolved: "resolved";
+            rejected: "rejected";
+            withdrawn: "withdrawn";
+            superseded: "superseded";
+            orphaned: "orphaned";
+            needs_reanchor: "needs_reanchor";
+        }>;
+        created_at: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        scope: z.ZodLiteral<"chapter">;
+        schema: z.ZodLiteral<"authorbot.annotation/v1">;
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            comment: "comment";
+            suggestion: "suggestion";
+        }>;
+        chapter_id: z.ZodString;
+        chapter_revision: z.ZodNumber;
+        author: z.ZodString;
+        status: z.ZodEnum<{
+            open: "open";
+            work_item_created: "work_item_created";
+            accepted: "accepted";
+            resolved: "resolved";
+            rejected: "rejected";
+            withdrawn: "withdrawn";
+            superseded: "superseded";
+            orphaned: "orphaned";
+            needs_reanchor: "needs_reanchor";
+        }>;
+        created_at: z.ZodString;
+    }, z.core.$strict>], "scope">;
+    readonly reply: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.reply/v1">;
+        id: z.ZodString;
+        annotation_id: z.ZodString;
+        parent_reply_id: z.ZodOptional<z.ZodString>;
+        author: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly decision: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.decision/v1">;
+        id: z.ZodString;
+        source_annotation_id: z.ZodString;
+        rule: z.ZodString;
+        rule_version: z.ZodNumber;
+        metrics: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        result: z.ZodEnum<{
+            rejected: "rejected";
+            create_work_item: "create_work_item";
+            support_changed: "support_changed";
+            overridden: "overridden";
+        }>;
+        work_item_id: z.ZodOptional<z.ZodString>;
+        effective_at: z.ZodString;
+        override_reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly "work-item": z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.work-item/v1">;
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            revise_range: "revise_range";
+            revise_block: "revise_block";
+            revise_chapter: "revise_chapter";
+            write_chapter: "write_chapter";
+            resolve_conflict: "resolve_conflict";
+            planning: "planning";
+        }>;
+        status: z.ZodEnum<{
+            ready: "ready";
+            leased: "leased";
+            submitted: "submitted";
+            applying: "applying";
+            completed: "completed";
+            conflict: "conflict";
+            failed: "failed";
+            cancelled: "cancelled";
+        }>;
+        source_annotation_id: z.ZodOptional<z.ZodString>;
+        chapter_id: z.ZodOptional<z.ZodString>;
+        base_revision: z.ZodOptional<z.ZodNumber>;
+        priority: z.ZodEnum<{
+            low: "low";
+            normal: "normal";
+            high: "high";
+        }>;
+        created_by: z.ZodString;
+        created_at: z.ZodString;
+    }, z.core.$strict>;
+    readonly attribution: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.attribution/v1">;
+        chapter_id: z.ZodString;
+        entries: z.ZodArray<z.ZodObject<{
+            revision: z.ZodNumber;
+            actor: z.ZodString;
+            work_item_id: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly release: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.release/v1">;
+        id: z.ZodString;
+        created_at: z.ZodString;
+        chapters: z.ZodArray<z.ZodObject<{
+            chapter_id: z.ZodString;
+            revision: z.ZodNumber;
+        }, z.core.$strict>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly instance: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.instance/v1">;
+        project: z.ZodOptional<z.ZodObject<{
+            book_config_path: z.ZodOptional<z.ZodString>;
+            default_branch: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        access: z.ZodOptional<z.ZodObject<{
+            public_read: z.ZodOptional<z.ZodBoolean>;
+            public_annotations: z.ZodOptional<z.ZodBoolean>;
+            writes_require_membership: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        annotations: z.ZodOptional<z.ZodObject<{
+            context_characters: z.ZodOptional<z.ZodNumber>;
+            range_scope: z.ZodOptional<z.ZodEnum<{
+                single_block: "single_block";
+            }>>;
+            allow_range_comments: z.ZodOptional<z.ZodBoolean>;
+            allow_chapter_comments: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        votes: z.ZodOptional<z.ZodObject<{
+            values: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                approve: "approve";
+                reject: "reject";
+                abstain: "abstain";
+            }>>>;
+            export: z.ZodOptional<z.ZodEnum<{
+                aggregate: "aggregate";
+                named: "named";
+                pseudonymous: "pseudonymous";
+            }>>;
+        }, z.core.$strict>>;
+        rules: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            version: z.ZodNumber;
+            trigger: z.ZodOptional<z.ZodEnum<{
+                vote_changed: "vote_changed";
+            }>>;
+            when: z.ZodUnion<readonly [z.ZodObject<{
+                all: z.ZodArray<z.ZodObject<{
+                    metric: z.ZodString;
+                    operator: z.ZodEnum<{
+                        gte: "gte";
+                        gt: "gt";
+                        lte: "lte";
+                        lt: "lt";
+                        eq: "eq";
+                        neq: "neq";
+                    }>;
+                    value: z.ZodNumber;
+                }, z.core.$strict>>;
+            }, z.core.$strict>, z.ZodObject<{
+                any: z.ZodArray<z.ZodObject<{
+                    metric: z.ZodString;
+                    operator: z.ZodEnum<{
+                        gte: "gte";
+                        gt: "gt";
+                        lte: "lte";
+                        lt: "lt";
+                        eq: "eq";
+                        neq: "neq";
+                    }>;
+                    value: z.ZodNumber;
+                }, z.core.$strict>>;
+            }, z.core.$strict>]>;
+            action: z.ZodObject<{
+                type: z.ZodLiteral<"create_work_item">;
+                work_type: z.ZodEnum<{
+                    revise_range: "revise_range";
+                    revise_block: "revise_block";
+                    revise_chapter: "revise_chapter";
+                    write_chapter: "write_chapter";
+                    resolve_conflict: "resolve_conflict";
+                    planning: "planning";
+                }>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>>;
+        leases: z.ZodOptional<z.ZodObject<{
+            duration: z.ZodOptional<z.ZodString>;
+            renewal_prompt_before: z.ZodOptional<z.ZodString>;
+            renewal_duration: z.ZodOptional<z.ZodString>;
+            maximum_total_duration: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        publishing: z.ZodOptional<z.ZodObject<{
+            collaboration_data: z.ZodOptional<z.ZodEnum<{
+                dynamic: "dynamic";
+                static: "static";
+            }>>;
+            static_snapshot_on_release: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly build: z.ZodObject<{
+        schema: z.ZodLiteral<"authorbot.build/v1">;
+        commit: z.ZodNullable<z.ZodString>;
+        built_at: z.ZodString;
+        publisher_version: z.ZodString;
+        base_url: z.ZodOptional<z.ZodString>;
+        chapters: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            slug: z.ZodString;
+            revision: z.ZodNumber;
+            title: z.ZodString;
+            status: z.ZodEnum<{
+                draft: "draft";
+                proposed: "proposed";
+                published: "published";
+                archived: "archived";
+            }>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+};
+export type ArtifactName = keyof typeof artifactSchemas;
+/** Schema discriminator IDs (contract section 4 table). */
+export declare const SCHEMA_IDS: Record<ArtifactName, string>;
+/**
+ * Generate the draft 2020-12 JSON Schema document for every artifact, keyed
+ * by output file basename (`<name>.schema.json`). `$id` is the artifact's
+ * schema discriminator.
+ */
+export declare function buildJsonSchemas(): Record<ArtifactName, Record<string, unknown>>;
+//# sourceMappingURL=json-schemas.d.ts.map

package/dist/json-schemas.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { annotationSchema, replySchema } from "./annotation.js";
+import { attributionSchema } from "./attribution.js";
+import { bookConfigSchema } from "./book.js";
+import { buildManifestSchema } from "./build.js";
+import { chapterFrontmatterSchema } from "./chapter.js";
+import { characterSchema } from "./character.js";
+import { decisionSchema } from "./decision.js";
+import { instanceConfigSchema } from "./instance.js";
+import { releaseSchema } from "./release.js";
+import { storyGraphSchema } from "./story-graph.js";
+import { timelineSchema } from "./timeline.js";
+import { workItemSchema } from "./work-item.js";
+/** All artifact schemas keyed by the JSON Schema output file basename. */
+export const artifactSchemas = {
+    book: bookConfigSchema,
+    chapter: chapterFrontmatterSchema,
+    "story-graph": storyGraphSchema,
+    timeline: timelineSchema,
+    character: characterSchema,
+    annotation: annotationSchema,
+    reply: replySchema,
+    decision: decisionSchema,
+    "work-item": workItemSchema,
+    attribution: attributionSchema,
+    release: releaseSchema,
+    instance: instanceConfigSchema,
+    build: buildManifestSchema,
+};
+/** Schema discriminator IDs (contract section 4 table). */
+export const SCHEMA_IDS = {
+    book: "authorbot.book/v1",
+    chapter: "authorbot.chapter/v1",
+    "story-graph": "authorbot.story-graph/v1",
+    timeline: "authorbot.timeline/v1",
+    character: "authorbot.character/v1",
+    annotation: "authorbot.annotation/v1",
+    reply: "authorbot.reply/v1",
+    decision: "authorbot.decision/v1",
+    "work-item": "authorbot.work-item/v1",
+    attribution: "authorbot.attribution/v1",
+    release: "authorbot.release/v1",
+    instance: "authorbot.instance/v1",
+    build: "authorbot.build/v1",
+};
+/**
+ * Generate the draft 2020-12 JSON Schema document for every artifact, keyed
+ * by output file basename (`<name>.schema.json`). `$id` is the artifact's
+ * schema discriminator.
+ */
+export function buildJsonSchemas() {
+    const out = {};
+    for (const name of Object.keys(artifactSchemas)) {
+        const generated = z.toJSONSchema(artifactSchemas[name], {
+            target: "draft-2020-12",
+        });
+        out[name] = { $id: SCHEMA_IDS[name], ...generated };
+    }
+    return out;
+}
+//# sourceMappingURL=json-schemas.js.map

package/dist/primitives.d.ts

@@ -0,0 +1,58 @@
+import { z } from "zod";
+/**
+ * Shared identifier and reference primitives (Phase 0 contract section 2).
+ */
+/** Story node / timeline / bible ID kinds (contract section 2). */
+export declare const NODE_KINDS: readonly ["premise", "arc", "part", "chapter", "scene", "beat", "event", "character", "location", "concept", "rule"];
+export type NodeKind = (typeof NODE_KINDS)[number];
+/** Actor reference namespaces (contract section 2). */
+export declare const ACTOR_NAMESPACES: readonly ["github", "agent", "system"];
+export type ActorNamespace = (typeof ACTOR_NAMESPACES)[number];
+/** Slug source pattern: `[a-z0-9][a-z0-9-]*` (contract section 2). */
+export declare const SLUG_PATTERN = "[a-z0-9][a-z0-9-]*";
+/**
+ * Lowercase UUIDv7 (contract section 2): version nibble must be `7`, variant
+ * nibble must be RFC 4122 (`8`, `9`, `a`, or `b`).
+ */
+export declare const UUIDV7_REGEX: RegExp;
+export declare const uuidv7Schema: z.ZodString;
+export type UuidV7 = z.infer<typeof uuidv7Schema>;
+/** Path-traversal-safe slug (contract section 2). */
+export declare const slugSchema: z.ZodString;
+export type Slug = z.infer<typeof slugSchema>;
+/** `<kind>:<slug>` node ID for any known kind (contract section 2). */
+export declare const nodeIdSchema: z.ZodString;
+export type NodeId = z.infer<typeof nodeIdSchema>;
+/** `<kind>:<slug>` node ID restricted to one specific kind. */
+export declare function nodeIdOf<K extends NodeKind>(kind: K): z.ZodString;
+/**
+ * Actor reference `<namespace>:<identifier>` (contract section 2).
+ * The identifier charset is not pinned by the contract; this package accepts
+ * `[A-Za-z0-9][A-Za-z0-9._-]*` (covers GitHub logins, agent names, and system
+ * components) and rejects whitespace, colons, and leading punctuation.
+ */
+export declare const actorRefSchema: z.ZodString;
+export type ActorRef = z.infer<typeof actorRefSchema>;
+/**
+ * RFC 3339 UTC timestamp (contract section 2), e.g. `2026-07-19T18:00:00Z`.
+ * Seconds are mandatory, fractional seconds optional, offset must be `Z`.
+ * Field ranges (month 01-12, day 01-31, hour 00-23, leap second 60) are
+ * enforced by the pattern so the schema stays fully JSON-Schema representable.
+ */
+export declare const RFC3339_UTC_REGEX: RegExp;
+/**
+ * Stricter than the generated JSON Schema: the `.refine` below rejects
+ * calendar-invalid dates (e.g. `2026-02-30`) and misplaced leap seconds,
+ * while `z.toJSONSchema` emits only the pattern (refinements are not
+ * JSON-Schema representable).
+ */
+export declare const timestampSchema: z.ZodString;
+export type Timestamp = z.infer<typeof timestampSchema>;
+/** ISO 8601 duration, e.g. `PT30M` (design section 25 lease settings). */
+export declare const ISO8601_DURATION_REGEX: RegExp;
+export declare const isoDurationSchema: z.ZodString;
+export type IsoDuration = z.infer<typeof isoDurationSchema>;
+/** Git commit SHA (abbreviated 7 chars up to SHA-256 64 chars). */
+export declare const commitShaSchema: z.ZodString;
+export type CommitSha = z.infer<typeof commitShaSchema>;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.js

@@ -0,0 +1,101 @@
+import { z } from "zod";
+/**
+ * Shared identifier and reference primitives (Phase 0 contract section 2).
+ */
+/** Story node / timeline / bible ID kinds (contract section 2). */
+export const NODE_KINDS = [
+    "premise",
+    "arc",
+    "part",
+    "chapter",
+    "scene",
+    "beat",
+    "event",
+    "character",
+    "location",
+    "concept",
+    "rule",
+];
+/** Actor reference namespaces (contract section 2). */
+export const ACTOR_NAMESPACES = ["github", "agent", "system"];
+/** Slug source pattern: `[a-z0-9][a-z0-9-]*` (contract section 2). */
+export const SLUG_PATTERN = "[a-z0-9][a-z0-9-]*";
+/**
+ * Lowercase UUIDv7 (contract section 2): version nibble must be `7`, variant
+ * nibble must be RFC 4122 (`8`, `9`, `a`, or `b`).
+ */
+export const UUIDV7_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+export const uuidv7Schema = z
+    .string()
+    .regex(UUIDV7_REGEX, "must be a lowercase UUIDv7 (version nibble 7)");
+/** Path-traversal-safe slug (contract section 2). */
+export const slugSchema = z
+    .string()
+    .regex(new RegExp(`^${SLUG_PATTERN}$`), "must match [a-z0-9][a-z0-9-]*");
+/** `<kind>:<slug>` node ID for any known kind (contract section 2). */
+export const nodeIdSchema = z
+    .string()
+    .regex(new RegExp(`^(?:${NODE_KINDS.join("|")}):${SLUG_PATTERN}$`), `must be <kind>:<slug> with kind one of ${NODE_KINDS.join("|")}`);
+/** `<kind>:<slug>` node ID restricted to one specific kind. */
+export function nodeIdOf(kind) {
+    return z
+        .string()
+        .regex(new RegExp(`^${kind}:${SLUG_PATTERN}$`), `must be a "${kind}:<slug>" id`);
+}
+/**
+ * Actor reference `<namespace>:<identifier>` (contract section 2).
+ * The identifier charset is not pinned by the contract; this package accepts
+ * `[A-Za-z0-9][A-Za-z0-9._-]*` (covers GitHub logins, agent names, and system
+ * components) and rejects whitespace, colons, and leading punctuation.
+ */
+export const actorRefSchema = z
+    .string()
+    .regex(new RegExp(`^(?:${ACTOR_NAMESPACES.join("|")}):[A-Za-z0-9][A-Za-z0-9._-]*$`), `must be <namespace>:<identifier> with namespace one of ${ACTOR_NAMESPACES.join("|")}`);
+/**
+ * RFC 3339 UTC timestamp (contract section 2), e.g. `2026-07-19T18:00:00Z`.
+ * Seconds are mandatory, fractional seconds optional, offset must be `Z`.
+ * Field ranges (month 01-12, day 01-31, hour 00-23, leap second 60) are
+ * enforced by the pattern so the schema stays fully JSON-Schema representable.
+ */
+export const RFC3339_UTC_REGEX = /^\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|60)(?:\.\d{1,9})?Z$/;
+const DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+/**
+ * Calendar rules the pattern cannot express (RFC 3339 section 5.7): the
+ * day-of-month must exist for the month/year, and second `60` is only legal
+ * at a leap-second instant (`23:59:60` UTC). Assumes the pattern already
+ * matched; safe on arbitrary strings.
+ */
+function isCalendarValid(value) {
+    const year = Number(value.slice(0, 4));
+    const month = Number(value.slice(5, 7));
+    const day = Number(value.slice(8, 10));
+    const isLeapYear = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    const maxDay = month === 2 && isLeapYear ? 29 : (DAYS_IN_MONTH[month - 1] ?? 0);
+    if (day > maxDay) {
+        return false;
+    }
+    if (value.slice(17, 19) === "60" && value.slice(11, 16) !== "23:59") {
+        return false;
+    }
+    return true;
+}
+/**
+ * Stricter than the generated JSON Schema: the `.refine` below rejects
+ * calendar-invalid dates (e.g. `2026-02-30`) and misplaced leap seconds,
+ * while `z.toJSONSchema` emits only the pattern (refinements are not
+ * JSON-Schema representable).
+ */
+export const timestampSchema = z
+    .string()
+    .regex(RFC3339_UTC_REGEX, "must be an RFC 3339 UTC timestamp like 2026-07-19T18:00:00Z")
+    .refine(isCalendarValid, "must be a real calendar date/time (RFC 3339)");
+/** ISO 8601 duration, e.g. `PT30M` (design section 25 lease settings). */
+export const ISO8601_DURATION_REGEX = /^P(?!$)(?:\d+Y)?(?:\d+M)?(?:\d+W)?(?:\d+D)?(?:T(?=\d)(?:\d+H)?(?:\d+M)?(?:\d+(?:\.\d+)?S)?)?$/;
+export const isoDurationSchema = z
+    .string()
+    .regex(ISO8601_DURATION_REGEX, "must be an ISO 8601 duration like PT30M");
+/** Git commit SHA (abbreviated 7 chars up to SHA-256 64 chars). */
+export const commitShaSchema = z
+    .string()
+    .regex(/^[0-9a-f]{7,64}$/, "must be a lowercase hex commit SHA");
+//# sourceMappingURL=primitives.js.map