@authorbot/schemas 0.1.37 → 0.1.39

package/CHANGELOG.md

@@ -9,6 +9,33 @@ Every published package shares this version. A tag builds, tests, and publishes
 all of them together, so `@authorbot/cli@0.1.15` and `@authorbot/api@0.1.15` are
 always the same commit.
 
+## 0.1.38
+
+- **Authorbot now has a complete local authoring mode.** `authorbot dev` runs
+  the real API and browser UI against a managed branch and persistent Git
+  worktree, with private SQLite state outside the book repository. It needs no
+  Cloudflare account or GitHub connection, and needs no network after the
+  packages are installed. Companion commands report status, print the private
+  starter agent environment, reset operational state without touching Git,
+  open a draft book pull request, and remove only worktrees Git can prove are
+  safe to clean up.
+- **Local editing follows the repository instead of fighting it.** API reads
+  are pinned to committed `HEAD`, while the preview can show direct editor
+  saves immediately. API writes pause while the worktree is dirty or on the
+  wrong branch, and resume after an explicit forward-moving author commit.
+  Local maintainer sign-in uses a one-use bootstrap link, book-specific
+  cookies, a stable `local:` identity, and a private full-editor starter token.
+- **The local browser loop is fast enough for Authorbot development.**
+  Astro/Vite serves the only browser origin and proxies the private loopback
+  API. Book and UI changes reload without throwing away SQLite or tokens, the
+  local toolbar reports branch and projection state, and a pending reload
+  waits when a form or editor has unsaved input. Backend source edits still
+  require restarting `authorbot dev`.
+- Local authoring uses Node's built-in SQLite instead of a native module.
+  Authorbot's CLI and local runtime now require Node 22.13 or newer. Cloudflare
+  remains the hosted production runtime. This release has no book-format
+  migration and no new D1 migration.
+
 ## 0.1.37
 
 - **Cloudflare D1 can now apply the Phase 3B capability backfill.** The 0.1.36

package/dist/decision.d.ts

@@ -17,6 +17,7 @@ export declare const decisionSchema: z.ZodObject<{
     schema: z.ZodLiteral<"authorbot.decision/v1">;
     id: z.ZodString;
     source_annotation_id: z.ZodString;
+    source_reply_id: z.ZodOptional<z.ZodString>;
     rule: z.ZodString;
     rule_version: z.ZodNumber;
     metrics: z.ZodRecord<z.ZodString, z.ZodNumber>;

package/dist/decision.js

@@ -17,6 +17,8 @@ export const decisionSchema = z.strictObject({
     schema: z.literal("authorbot.decision/v1"),
     id: uuidv7Schema,
     source_annotation_id: uuidv7Schema,
+    /** Present when this decision promotes one reply, not the whole annotation. */
+    source_reply_id: uuidv7Schema.optional(),
     rule: z.string().min(1),
     // `rule_version: 0` is reserved for maintainer force-create decisions
     // (contract §4); rule crossings use versions >= 1.

package/dist/json-schemas.d.ts

@@ -274,6 +274,7 @@ export declare const artifactSchemas: {
         schema: z.ZodLiteral<"authorbot.decision/v1">;
         id: z.ZodString;
         source_annotation_id: z.ZodString;
+        source_reply_id: z.ZodOptional<z.ZodString>;
         rule: z.ZodString;
         rule_version: z.ZodNumber;
         metrics: z.ZodRecord<z.ZodString, z.ZodNumber>;
@@ -309,6 +310,7 @@ export declare const artifactSchemas: {
             cancelled: "cancelled";
         }>;
         source_annotation_id: z.ZodOptional<z.ZodString>;
+        source_reply_id: z.ZodOptional<z.ZodString>;
         chapter_id: z.ZodOptional<z.ZodString>;
         base_revision: z.ZodOptional<z.ZodNumber>;
         priority: z.ZodEnum<{

package/dist/primitives.d.ts

@@ -5,8 +5,8 @@ import { z } from "zod";
 /** 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"];
+/** Actor reference namespaces (contract section 2 plus portable local auth). */
+export declare const ACTOR_NAMESPACES: readonly ["github", "agent", "local", "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-]*";
@@ -28,8 +28,9 @@ 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.
+ * `[A-Za-z0-9][A-Za-z0-9._-]*` (covers GitHub logins, agent names, portable
+ * local identities, and system components) and rejects whitespace, colons,
+ * and leading punctuation.
  */
 export declare const actorRefSchema: z.ZodString;
 export type ActorRef = z.infer<typeof actorRefSchema>;

package/dist/primitives.js

@@ -16,8 +16,8 @@ export const NODE_KINDS = [
     "concept",
     "rule",
 ];
-/** Actor reference namespaces (contract section 2). */
-export const ACTOR_NAMESPACES = ["github", "agent", "system"];
+/** Actor reference namespaces (contract section 2 plus portable local auth). */
+export const ACTOR_NAMESPACES = ["github", "agent", "local", "system"];
 /** Slug source pattern: `[a-z0-9][a-z0-9-]*` (contract section 2). */
 export const SLUG_PATTERN = "[a-z0-9][a-z0-9-]*";
 /**
@@ -45,8 +45,9 @@ export function nodeIdOf(kind) {
 /**
  * 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.
+ * `[A-Za-z0-9][A-Za-z0-9._-]*` (covers GitHub logins, agent names, portable
+ * local identities, and system components) and rejects whitespace, colons,
+ * and leading punctuation.
  */
 export const actorRefSchema = z
     .string()

package/dist/work-item.d.ts

@@ -61,6 +61,7 @@ export declare const workItemSchema: z.ZodObject<{
         cancelled: "cancelled";
     }>;
     source_annotation_id: z.ZodOptional<z.ZodString>;
+    source_reply_id: z.ZodOptional<z.ZodString>;
     chapter_id: z.ZodOptional<z.ZodString>;
     base_revision: z.ZodOptional<z.ZodNumber>;
     priority: z.ZodEnum<{

package/dist/work-item.js

@@ -39,6 +39,7 @@ export const workItemSchema = z.strictObject({
     type: workItemTypeSchema,
     status: workItemStatusSchema,
     source_annotation_id: uuidv7Schema.optional(),
+    source_reply_id: uuidv7Schema.optional(),
     chapter_id: uuidv7Schema.optional(),
     base_revision: z.number().int().min(1).optional(),
     priority: workItemPrioritySchema,

package/json/annotation.schema.json

@@ -31,7 +31,7 @@
         },
         "author": {
           "type": "string",
-          "pattern": "^(?:github|agent|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
+          "pattern": "^(?:github|agent|local|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
         },
         "status": {
           "type": "string",
@@ -156,7 +156,7 @@
         },
         "author": {
           "type": "string",
-          "pattern": "^(?:github|agent|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
+          "pattern": "^(?:github|agent|local|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
         },
         "status": {
           "type": "string",
@@ -237,7 +237,7 @@
         },
         "author": {
           "type": "string",
-          "pattern": "^(?:github|agent|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
+          "pattern": "^(?:github|agent|local|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
         },
         "status": {
           "type": "string",

package/json/attribution.schema.json

@@ -24,7 +24,7 @@
           },
           "actor": {
             "type": "string",
-            "pattern": "^(?:github|agent|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
+            "pattern": "^(?:github|agent|local|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
           },
           "work_item_id": {
             "type": "string",

package/json/chapter.schema.json

@@ -48,7 +48,7 @@
         "properties": {
           "actor": {
             "type": "string",
-            "pattern": "^(?:github|agent|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
+            "pattern": "^(?:github|agent|local|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
           },
           "name": {
             "type": "string",

package/json/decision.schema.json

@@ -15,6 +15,10 @@
       "type": "string",
       "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
     },
+    "source_reply_id": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+    },
     "rule": {
       "type": "string",
       "minLength": 1

package/json/reply.schema.json

@@ -21,7 +21,7 @@
     },
     "author": {
       "type": "string",
-      "pattern": "^(?:github|agent|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
+      "pattern": "^(?:github|agent|local|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
     },
     "status": {
       "type": "string",

package/json/work-item.schema.json

@@ -39,6 +39,10 @@
       "type": "string",
       "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
     },
+    "source_reply_id": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+    },
     "chapter_id": {
       "type": "string",
       "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
@@ -58,7 +62,7 @@
     },
     "created_by": {
       "type": "string",
-      "pattern": "^(?:github|agent|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
+      "pattern": "^(?:github|agent|local|system):[A-Za-z0-9][A-Za-z0-9._-]*$"
     },
     "created_at": {
       "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@authorbot/schemas",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "description": "Zod v4 schemas, inferred TypeScript types, and generated JSON Schemas for Authorbot book-repository artifacts (Phase 0 contract section 4)",
   "keywords": [
     "authorbot",