@authorbot/schemas 0.1.0

package/dist/release.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+/**
+ * Release manifest `.authorbot/releases/<id>.yml` — `authorbot.release/v1`
+ * (contract section 4). A release pins at least one chapter revision.
+ */
+export declare const releaseSchema: 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>;
+export type Release = z.infer<typeof releaseSchema>;
+//# sourceMappingURL=release.d.ts.map

package/dist/release.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { timestampSchema, uuidv7Schema } from "./primitives.js";
+/**
+ * Release manifest `.authorbot/releases/<id>.yml` — `authorbot.release/v1`
+ * (contract section 4). A release pins at least one chapter revision.
+ */
+export const releaseSchema = z.strictObject({
+    schema: z.literal("authorbot.release/v1"),
+    id: uuidv7Schema,
+    created_at: timestampSchema,
+    chapters: z
+        .array(z.strictObject({
+        chapter_id: uuidv7Schema,
+        revision: z.number().int().min(1),
+    }))
+        .min(1),
+    notes: z.string().optional(),
+});
+//# sourceMappingURL=release.js.map

package/dist/scripts/generate-json-schemas.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generate-json-schemas.d.ts.map

package/dist/scripts/generate-json-schemas.js

@@ -0,0 +1,14 @@
+/**
+ * Build step: write JSON Schemas generated from the Zod schemas to
+ * packages/schemas/json/<name>.schema.json. The generated files are checked
+ * in (contract section 1); a test asserts they stay in sync.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { buildJsonSchemas } from "../json-schemas.js";
+const outDir = fileURLToPath(new URL("../../json/", import.meta.url));
+const documents = buildJsonSchemas();
+await mkdir(outDir, { recursive: true });
+await Promise.all(Object.entries(documents).map(([name, document]) => writeFile(`${outDir}${name}.schema.json`, `${JSON.stringify(document, null, 2)}\n`, "utf8")));
+console.log(`generated ${Object.keys(documents).length} JSON Schemas in ${outDir}`);
+//# sourceMappingURL=generate-json-schemas.js.map

package/dist/story-graph.d.ts

@@ -0,0 +1,132 @@
+import { z } from "zod";
+/** Story graph node types (contract section 4). */
+export declare const STORY_NODE_TYPES: readonly ["premise", "arc", "part", "chapter", "scene", "beat", "custom"];
+export type StoryNodeType = (typeof STORY_NODE_TYPES)[number];
+/** `type: chapter` nodes carry the chapter's UUID (contract section 4). */
+export declare const storyGraphChapterNodeSchema: 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>;
+export type StoryGraphChapterNode = z.infer<typeof storyGraphChapterNodeSchema>;
+/** All non-chapter node types; scene-style fields are optional. */
+export declare const storyGraphStoryNodeSchema: 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>;
+export type StoryGraphStoryNode = z.infer<typeof storyGraphStoryNodeSchema>;
+export declare const storyGraphNodeSchema: 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">;
+export type StoryGraphNode = z.infer<typeof storyGraphNodeSchema>;
+export declare const storyGraphLinkSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    type: z.ZodString;
+}, z.core.$strict>;
+export type StoryGraphLink = z.infer<typeof storyGraphLinkSchema>;
+/**
+ * Story graph `story/outline.yml` — `authorbot.story-graph/v1`
+ * (design section 8.5, contract section 4).
+ */
+export declare const storyGraphSchema: 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>;
+export type StoryGraph = z.infer<typeof storyGraphSchema>;
+//# sourceMappingURL=story-graph.d.ts.map

package/dist/story-graph.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { chapterStatusSchema } from "./chapter.js";
+import { nodeIdSchema, uuidv7Schema } from "./primitives.js";
+/** Story graph node types (contract section 4). */
+export const STORY_NODE_TYPES = [
+    "premise",
+    "arc",
+    "part",
+    "chapter",
+    "scene",
+    "beat",
+    "custom",
+];
+const nodeCommonFields = {
+    id: nodeIdSchema,
+    title: z.string().min(1).optional(),
+    summary: z.string().optional(),
+    parent: nodeIdSchema.optional(),
+    order: z.number(),
+    /** Free-form template tags, e.g. for beat-sheet views (design section 8.5). */
+    tags: z.array(z.string().min(1)).optional(),
+};
+/** `type: chapter` nodes carry the chapter's UUID (contract section 4). */
+export const storyGraphChapterNodeSchema = z.strictObject({
+    ...nodeCommonFields,
+    type: z.literal("chapter"),
+    chapter_id: uuidv7Schema,
+    status: chapterStatusSchema.optional(),
+});
+/** All non-chapter node types; scene-style fields are optional. */
+export const storyGraphStoryNodeSchema = z.strictObject({
+    ...nodeCommonFields,
+    type: z.enum(["premise", "arc", "part", "scene", "beat", "custom"]),
+    goal: z.string().optional(),
+    conflict: z.string().optional(),
+    outcome: z.string().optional(),
+});
+export const storyGraphNodeSchema = z.discriminatedUnion("type", [
+    storyGraphChapterNodeSchema,
+    storyGraphStoryNodeSchema,
+]);
+export const storyGraphLinkSchema = z.strictObject({
+    from: nodeIdSchema,
+    to: nodeIdSchema,
+    type: z.string().min(1),
+});
+/**
+ * Story graph `story/outline.yml` — `authorbot.story-graph/v1`
+ * (design section 8.5, contract section 4).
+ */
+export const storyGraphSchema = z.strictObject({
+    schema: z.literal("authorbot.story-graph/v1"),
+    nodes: z.array(storyGraphNodeSchema),
+    links: z.array(storyGraphLinkSchema).optional(),
+});
+//# sourceMappingURL=story-graph.js.map

package/dist/timeline.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export declare const timelineEventSchema: 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>;
+export type TimelineEvent = z.infer<typeof timelineEventSchema>;
+/**
+ * Timeline `story/timeline.yml` — `authorbot.timeline/v1`
+ * (design section 8.6, contract section 4).
+ */
+export declare const timelineSchema: 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>;
+export type Timeline = z.infer<typeof timelineSchema>;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { nodeIdOf, uuidv7Schema } from "./primitives.js";
+export const timelineEventSchema = z.strictObject({
+    id: nodeIdOf("event"),
+    sort_key: z.number(),
+    display_time: z.string().min(1),
+    title: z.string().min(1),
+    participants: z.array(nodeIdOf("character")).optional(),
+    locations: z.array(nodeIdOf("location")).optional(),
+    chapter_refs: z.array(uuidv7Schema).optional(),
+    facts: z.array(z.string().min(1)).optional(),
+});
+/**
+ * Timeline `story/timeline.yml` — `authorbot.timeline/v1`
+ * (design section 8.6, contract section 4).
+ */
+export const timelineSchema = z.strictObject({
+    schema: z.literal("authorbot.timeline/v1"),
+    calendar: z
+        .strictObject({
+        /** e.g. `absolute`, `relative`, or a custom calendar label. */
+        type: z.string().min(1),
+        epoch_label: z.string().min(1).optional(),
+    })
+        .optional(),
+    events: z.array(timelineEventSchema),
+});
+//# sourceMappingURL=timeline.js.map

package/dist/work-item.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+/** Work item types (contract section 4). */
+export declare const WORK_ITEM_TYPES: readonly ["revise_range", "revise_block", "revise_chapter", "write_chapter", "resolve_conflict", "planning"];
+export declare const workItemTypeSchema: z.ZodEnum<{
+    revise_range: "revise_range";
+    revise_block: "revise_block";
+    revise_chapter: "revise_chapter";
+    write_chapter: "write_chapter";
+    resolve_conflict: "resolve_conflict";
+    planning: "planning";
+}>;
+export type WorkItemType = z.infer<typeof workItemTypeSchema>;
+/** Work item states (contract section 4, design section 9.5). */
+export declare const WORK_ITEM_STATUSES: readonly ["ready", "leased", "submitted", "applying", "completed", "conflict", "failed", "cancelled"];
+export declare const workItemStatusSchema: z.ZodEnum<{
+    ready: "ready";
+    leased: "leased";
+    submitted: "submitted";
+    applying: "applying";
+    completed: "completed";
+    conflict: "conflict";
+    failed: "failed";
+    cancelled: "cancelled";
+}>;
+export type WorkItemStatus = z.infer<typeof workItemStatusSchema>;
+export declare const WORK_ITEM_PRIORITIES: readonly ["low", "normal", "high"];
+export declare const workItemPrioritySchema: z.ZodEnum<{
+    low: "low";
+    normal: "normal";
+    high: "high";
+}>;
+export type WorkItemPriority = z.infer<typeof workItemPrioritySchema>;
+/**
+ * Work item frontmatter `.authorbot/work-items/<id>.md` —
+ * `authorbot.work-item/v1` (design section 13, contract section 4).
+ * Stable paths with status in frontmatter (contract ADR over design 8.1).
+ * `source_annotation_id`, `chapter_id`, and `base_revision` are optional at
+ * the schema level because `write_chapter` and `planning` items may lack
+ * them; per-type reference requirements are validator concerns
+ * (WORK_ITEM_REF_UNRESOLVED). Lease state never appears here (design 13).
+ */
+export declare const workItemSchema: 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>;
+export type WorkItem = z.infer<typeof workItemSchema>;
+//# sourceMappingURL=work-item.d.ts.map

package/dist/work-item.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { actorRefSchema, timestampSchema, uuidv7Schema } from "./primitives.js";
+/** Work item types (contract section 4). */
+export const WORK_ITEM_TYPES = [
+    "revise_range",
+    "revise_block",
+    "revise_chapter",
+    "write_chapter",
+    "resolve_conflict",
+    "planning",
+];
+export const workItemTypeSchema = z.enum(WORK_ITEM_TYPES);
+/** Work item states (contract section 4, design section 9.5). */
+export const WORK_ITEM_STATUSES = [
+    "ready",
+    "leased",
+    "submitted",
+    "applying",
+    "completed",
+    "conflict",
+    "failed",
+    "cancelled",
+];
+export const workItemStatusSchema = z.enum(WORK_ITEM_STATUSES);
+export const WORK_ITEM_PRIORITIES = ["low", "normal", "high"];
+export const workItemPrioritySchema = z.enum(WORK_ITEM_PRIORITIES);
+/**
+ * Work item frontmatter `.authorbot/work-items/<id>.md` —
+ * `authorbot.work-item/v1` (design section 13, contract section 4).
+ * Stable paths with status in frontmatter (contract ADR over design 8.1).
+ * `source_annotation_id`, `chapter_id`, and `base_revision` are optional at
+ * the schema level because `write_chapter` and `planning` items may lack
+ * them; per-type reference requirements are validator concerns
+ * (WORK_ITEM_REF_UNRESOLVED). Lease state never appears here (design 13).
+ */
+export const workItemSchema = z.strictObject({
+    schema: z.literal("authorbot.work-item/v1"),
+    id: uuidv7Schema,
+    type: workItemTypeSchema,
+    status: workItemStatusSchema,
+    source_annotation_id: uuidv7Schema.optional(),
+    chapter_id: uuidv7Schema.optional(),
+    base_revision: z.number().int().min(1).optional(),
+    priority: workItemPrioritySchema,
+    created_by: actorRefSchema,
+    created_at: timestampSchema,
+});
+//# sourceMappingURL=work-item.js.map