@deskwork/core 0.10.1 → 0.11.0

package/dist/schema/annotation.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export declare const AnnotationSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"comment">;
+    range: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        start: number;
+        end: number;
+    }, {
+        start: number;
+        end: number;
+    }>;
+    text: z.ZodString;
+    category: z.ZodOptional<z.ZodString>;
+    anchor: z.ZodOptional<z.ZodString>;
+    disposition: z.ZodOptional<z.ZodEnum<["addressed", "deferred", "wontfix"]>>;
+    dispositionReason: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: "comment";
+    createdAt: string;
+    range: {
+        start: number;
+        end: number;
+    };
+    text: string;
+    anchor?: string | undefined;
+    category?: string | undefined;
+    disposition?: "addressed" | "deferred" | "wontfix" | undefined;
+    dispositionReason?: string | undefined;
+}, {
+    id: string;
+    type: "comment";
+    createdAt: string;
+    range: {
+        start: number;
+        end: number;
+    };
+    text: string;
+    anchor?: string | undefined;
+    category?: string | undefined;
+    disposition?: "addressed" | "deferred" | "wontfix" | undefined;
+    dispositionReason?: string | undefined;
+}>;
+export type Annotation = z.infer<typeof AnnotationSchema>;
+//# sourceMappingURL=annotation.d.ts.map

package/dist/schema/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/schema/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/schema/annotation.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const AnnotationSchema = z.object({
+    id: z.string().uuid(),
+    type: z.literal('comment'),
+    range: z.object({ start: z.number().int().nonnegative(), end: z.number().int().nonnegative() }),
+    text: z.string(),
+    category: z.string().optional(),
+    anchor: z.string().optional(),
+    disposition: z.enum(['addressed', 'deferred', 'wontfix']).optional(),
+    dispositionReason: z.string().optional(),
+    createdAt: z.string().datetime(),
+});
+//# sourceMappingURL=annotation.js.map

package/dist/schema/annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.js","sourceRoot":"","sources":["../../src/schema/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;IAC/F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/schema/entry.d.ts

@@ -0,0 +1,57 @@
+export type Stage = 'Ideas' | 'Planned' | 'Outlining' | 'Drafting' | 'Final' | 'Published' | 'Blocked' | 'Cancelled';
+export type ReviewState = 'in-review' | 'iterating' | 'approved';
+export declare function isLinearPipelineStage(s: Stage): boolean;
+export declare function isOffPipelineStage(s: Stage): boolean;
+export declare function nextStage(s: Stage): Stage | null;
+import { z } from 'zod';
+export declare const EntrySchema: z.ZodObject<{
+    uuid: z.ZodString;
+    slug: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodArray<z.ZodString, "many">;
+    source: z.ZodString;
+    currentStage: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+    priorStage: z.ZodOptional<z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>>;
+    iterationByStage: z.ZodRecord<z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>, z.ZodNumber>;
+    reviewState: z.ZodOptional<z.ZodEnum<["in-review", "iterating", "approved"]>>;
+    targetVersion: z.ZodOptional<z.ZodString>;
+    datePublished: z.ZodOptional<z.ZodString>;
+    shortformWorkflows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    slug: string;
+    title: string;
+    uuid: string;
+    keywords: string[];
+    createdAt: string;
+    currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled", number>>;
+    updatedAt: string;
+    description?: string | undefined;
+    datePublished?: string | undefined;
+    priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
+    reviewState?: "in-review" | "iterating" | "approved" | undefined;
+    targetVersion?: string | undefined;
+    shortformWorkflows?: Record<string, string> | undefined;
+}, {
+    source: string;
+    slug: string;
+    title: string;
+    uuid: string;
+    keywords: string[];
+    createdAt: string;
+    currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled", number>>;
+    updatedAt: string;
+    description?: string | undefined;
+    datePublished?: string | undefined;
+    priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
+    reviewState?: "in-review" | "iterating" | "approved" | undefined;
+    targetVersion?: string | undefined;
+    shortformWorkflows?: Record<string, string> | undefined;
+}>;
+export type Entry = z.infer<typeof EntrySchema>;
+//# sourceMappingURL=entry.d.ts.map

package/dist/schema/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/schema/entry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GACb,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GACtE,SAAS,GAAG,WAAW,CAAC;AAE5B,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAKjE,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAEvD;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAEpD;AAaD,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAEhD;AAED,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/schema/entry.js

@@ -0,0 +1,47 @@
+const LINEAR_PIPELINE = ['Ideas', 'Planned', 'Outlining', 'Drafting', 'Final', 'Published'];
+const OFF_PIPELINE = ['Blocked', 'Cancelled'];
+export function isLinearPipelineStage(s) {
+    return LINEAR_PIPELINE.includes(s);
+}
+export function isOffPipelineStage(s) {
+    return OFF_PIPELINE.includes(s);
+}
+const SUCCESSOR = {
+    Ideas: 'Planned',
+    Planned: 'Outlining',
+    Outlining: 'Drafting',
+    Drafting: 'Final',
+    Final: null, // publish, not approve
+    Published: null,
+    Blocked: null,
+    Cancelled: null,
+};
+export function nextStage(s) {
+    return SUCCESSOR[s];
+}
+import { z } from 'zod';
+const StageEnum = z.enum(['Ideas', 'Planned', 'Outlining', 'Drafting', 'Final', 'Published', 'Blocked', 'Cancelled']);
+const ReviewStateEnum = z.enum(['in-review', 'iterating', 'approved']);
+export const EntrySchema = z.object({
+    // Identity
+    uuid: z.string().uuid(),
+    slug: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    keywords: z.array(z.string()),
+    source: z.string(),
+    // Pipeline state
+    currentStage: StageEnum,
+    priorStage: StageEnum.optional(),
+    iterationByStage: z.record(StageEnum, z.number().int().nonnegative()),
+    reviewState: ReviewStateEnum.optional(),
+    // Editorial
+    targetVersion: z.string().optional(),
+    datePublished: z.string().datetime().optional(),
+    // Distribution (deferred — shortform model)
+    shortformWorkflows: z.record(z.string(), z.string()).optional(),
+    // Timestamps
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+});
+//# sourceMappingURL=entry.js.map

package/dist/schema/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../src/schema/entry.ts"],"names":[],"mappings":"AAMA,MAAM,eAAe,GAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AACvH,MAAM,YAAY,GAAqB,CAAC,SAAS,EAAE,WAAW,CAAU,CAAC;AAEzE,MAAM,UAAU,qBAAqB,CAAC,CAAQ;IAC5C,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAQ;IACzC,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,SAAS,GAAgC;IAC7C,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,WAAW;IACpB,SAAS,EAAE,UAAU;IACrB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,IAAI,EAAS,uBAAuB;IAC3C,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,CAAQ;IAChC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AACtH,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,WAAW;IACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAElB,iBAAiB;IACjB,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,SAAS,CAAC,QAAQ,EAAE;IAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IACrE,WAAW,EAAE,eAAe,CAAC,QAAQ,EAAE;IAEvC,YAAY;IACZ,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE/C,4CAA4C;IAC5C,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE/D,aAAa;IACb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC"}

package/dist/schema/journal-events.d.ts

@@ -0,0 +1,275 @@
+import { z } from 'zod';
+export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"entry-created">;
+    at: z.ZodString;
+    entryId: z.ZodString;
+    entry: z.ZodObject<{
+        uuid: z.ZodString;
+        slug: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        keywords: z.ZodArray<z.ZodString, "many">;
+        source: z.ZodString;
+        currentStage: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+        priorStage: z.ZodOptional<z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>>;
+        iterationByStage: z.ZodRecord<z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>, z.ZodNumber>;
+        reviewState: z.ZodOptional<z.ZodEnum<["in-review", "iterating", "approved"]>>;
+        targetVersion: z.ZodOptional<z.ZodString>;
+        datePublished: z.ZodOptional<z.ZodString>;
+        shortformWorkflows: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        slug: string;
+        title: string;
+        uuid: string;
+        keywords: string[];
+        createdAt: string;
+        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled", number>>;
+        updatedAt: string;
+        description?: string | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
+        reviewState?: "in-review" | "iterating" | "approved" | undefined;
+        targetVersion?: string | undefined;
+        shortformWorkflows?: Record<string, string> | undefined;
+    }, {
+        source: string;
+        slug: string;
+        title: string;
+        uuid: string;
+        keywords: string[];
+        createdAt: string;
+        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled", number>>;
+        updatedAt: string;
+        description?: string | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
+        reviewState?: "in-review" | "iterating" | "approved" | undefined;
+        targetVersion?: string | undefined;
+        shortformWorkflows?: Record<string, string> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    entryId: string;
+    entry: {
+        source: string;
+        slug: string;
+        title: string;
+        uuid: string;
+        keywords: string[];
+        createdAt: string;
+        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled", number>>;
+        updatedAt: string;
+        description?: string | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
+        reviewState?: "in-review" | "iterating" | "approved" | undefined;
+        targetVersion?: string | undefined;
+        shortformWorkflows?: Record<string, string> | undefined;
+    };
+    kind: "entry-created";
+}, {
+    at: string;
+    entryId: string;
+    entry: {
+        source: string;
+        slug: string;
+        title: string;
+        uuid: string;
+        keywords: string[];
+        createdAt: string;
+        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled", number>>;
+        updatedAt: string;
+        description?: string | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
+        reviewState?: "in-review" | "iterating" | "approved" | undefined;
+        targetVersion?: string | undefined;
+        shortformWorkflows?: Record<string, string> | undefined;
+    };
+    kind: "entry-created";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"entry-ingested">;
+    at: z.ZodString;
+    entryId: z.ZodString;
+    sourcePath: z.ZodString;
+    targetStage: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    entryId: string;
+    kind: "entry-ingested";
+    sourcePath: string;
+    targetStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+}, {
+    at: string;
+    entryId: string;
+    kind: "entry-ingested";
+    sourcePath: string;
+    targetStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"iteration">;
+    at: z.ZodString;
+    entryId: z.ZodString;
+    stage: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+    version: z.ZodNumber;
+    markdown: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    version: number;
+    entryId: string;
+    markdown: string;
+    kind: "iteration";
+}, {
+    at: string;
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    version: number;
+    entryId: string;
+    markdown: string;
+    kind: "iteration";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"annotation">;
+    at: z.ZodString;
+    entryId: z.ZodString;
+    stage: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+    version: z.ZodNumber;
+    annotation: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"comment">;
+        range: z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            start: number;
+            end: number;
+        }, {
+            start: number;
+            end: number;
+        }>;
+        text: z.ZodString;
+        category: z.ZodOptional<z.ZodString>;
+        anchor: z.ZodOptional<z.ZodString>;
+        disposition: z.ZodOptional<z.ZodEnum<["addressed", "deferred", "wontfix"]>>;
+        dispositionReason: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: "comment";
+        createdAt: string;
+        range: {
+            start: number;
+            end: number;
+        };
+        text: string;
+        anchor?: string | undefined;
+        category?: string | undefined;
+        disposition?: "addressed" | "deferred" | "wontfix" | undefined;
+        dispositionReason?: string | undefined;
+    }, {
+        id: string;
+        type: "comment";
+        createdAt: string;
+        range: {
+            start: number;
+            end: number;
+        };
+        text: string;
+        anchor?: string | undefined;
+        category?: string | undefined;
+        disposition?: "addressed" | "deferred" | "wontfix" | undefined;
+        dispositionReason?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    version: number;
+    annotation: {
+        id: string;
+        type: "comment";
+        createdAt: string;
+        range: {
+            start: number;
+            end: number;
+        };
+        text: string;
+        anchor?: string | undefined;
+        category?: string | undefined;
+        disposition?: "addressed" | "deferred" | "wontfix" | undefined;
+        dispositionReason?: string | undefined;
+    };
+    entryId: string;
+    kind: "annotation";
+}, {
+    at: string;
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    version: number;
+    annotation: {
+        id: string;
+        type: "comment";
+        createdAt: string;
+        range: {
+            start: number;
+            end: number;
+        };
+        text: string;
+        anchor?: string | undefined;
+        category?: string | undefined;
+        disposition?: "addressed" | "deferred" | "wontfix" | undefined;
+        dispositionReason?: string | undefined;
+    };
+    entryId: string;
+    kind: "annotation";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"review-state-change">;
+    at: z.ZodString;
+    entryId: z.ZodString;
+    stage: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+    from: z.ZodNullable<z.ZodEnum<["in-review", "iterating", "approved"]>>;
+    to: z.ZodNullable<z.ZodEnum<["in-review", "iterating", "approved"]>>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    from: "in-review" | "iterating" | "approved" | null;
+    to: "in-review" | "iterating" | "approved" | null;
+    entryId: string;
+    kind: "review-state-change";
+}, {
+    at: string;
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    from: "in-review" | "iterating" | "approved" | null;
+    to: "in-review" | "iterating" | "approved" | null;
+    entryId: string;
+    kind: "review-state-change";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"stage-transition">;
+    at: z.ZodString;
+    entryId: z.ZodString;
+    from: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+    to: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
+    reason: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    from: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    to: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    entryId: string;
+    kind: "stage-transition";
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    at: string;
+    from: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    to: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    entryId: string;
+    kind: "stage-transition";
+    reason?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}>]>;
+export type JournalEvent = z.infer<typeof JournalEventSchema>;
+//# sourceMappingURL=journal-events.d.ts.map

package/dist/schema/journal-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-events.d.ts","sourceRoot":"","sources":["../../src/schema/journal-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2DxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/schema/journal-events.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { EntrySchema } from "./entry.js";
+import { AnnotationSchema } from "./annotation.js";
+const StageEnum = z.enum(['Ideas', 'Planned', 'Outlining', 'Drafting', 'Final', 'Published', 'Blocked', 'Cancelled']);
+const ReviewStateEnum = z.enum(['in-review', 'iterating', 'approved']);
+const EntryCreatedEvent = z.object({
+    kind: z.literal('entry-created'),
+    at: z.string().datetime(),
+    entryId: z.string().uuid(),
+    entry: EntrySchema,
+});
+const EntryIngestedEvent = z.object({
+    kind: z.literal('entry-ingested'),
+    at: z.string().datetime(),
+    entryId: z.string().uuid(),
+    sourcePath: z.string(),
+    targetStage: StageEnum,
+});
+const IterationEvent = z.object({
+    kind: z.literal('iteration'),
+    at: z.string().datetime(),
+    entryId: z.string().uuid(),
+    stage: StageEnum,
+    version: z.number().int().positive(),
+    markdown: z.string(),
+});
+const AnnotationEvent = z.object({
+    kind: z.literal('annotation'),
+    at: z.string().datetime(),
+    entryId: z.string().uuid(),
+    stage: StageEnum,
+    version: z.number().int().positive(),
+    annotation: AnnotationSchema,
+});
+const ReviewStateChangeEvent = z.object({
+    kind: z.literal('review-state-change'),
+    at: z.string().datetime(),
+    entryId: z.string().uuid(),
+    stage: StageEnum,
+    from: ReviewStateEnum.nullable(),
+    to: ReviewStateEnum.nullable(),
+});
+const StageTransitionEvent = z.object({
+    kind: z.literal('stage-transition'),
+    at: z.string().datetime(),
+    entryId: z.string().uuid(),
+    from: StageEnum,
+    to: StageEnum,
+    reason: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+export const JournalEventSchema = z.discriminatedUnion('kind', [
+    EntryCreatedEvent,
+    EntryIngestedEvent,
+    IterationEvent,
+    AnnotationEvent,
+    ReviewStateChangeEvent,
+    StageTransitionEvent,
+]);
+//# sourceMappingURL=journal-events.js.map

package/dist/schema/journal-events.js.map

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

package/dist/sidecar/index.d.ts

@@ -0,0 +1,6 @@
+export * from './paths.ts';
+export * from './read.ts';
+export * from './read-all.ts';
+export * from './write.ts';
+export * from './lookup.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/sidecar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sidecar/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/sidecar/index.js

@@ -0,0 +1,6 @@
+export * from "./paths.js";
+export * from "./read.js";
+export * from "./read-all.js";
+export * from "./write.js";
+export * from "./lookup.js";
+//# sourceMappingURL=index.js.map

package/dist/sidecar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sidecar/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/sidecar/lookup.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveEntryUuid(projectRoot: string, input: string): Promise<string>;
+//# sourceMappingURL=lookup.d.ts.map

package/dist/sidecar/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/sidecar/lookup.ts"],"names":[],"mappings":"AAOA,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB1F"}

package/dist/sidecar/lookup.js

@@ -0,0 +1,30 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { sidecarsDir } from "./paths.js";
+import { EntrySchema } from "../schema/entry.js";
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export async function resolveEntryUuid(projectRoot, input) {
+    if (UUID_RE.test(input))
+        return input;
+    const dir = sidecarsDir(projectRoot);
+    let names;
+    try {
+        names = await readdir(dir);
+    }
+    catch {
+        throw new Error(`slug '${input}' not found (no sidecars)`);
+    }
+    for (const name of names.filter(n => n.endsWith('.json'))) {
+        const raw = await readFile(join(dir, name), 'utf8');
+        try {
+            const parsed = EntrySchema.safeParse(JSON.parse(raw));
+            if (parsed.success && parsed.data.slug === input)
+                return parsed.data.uuid;
+        }
+        catch {
+            /* skip malformed sidecars */
+        }
+    }
+    throw new Error(`slug '${input}' not found`);
+}
+//# sourceMappingURL=lookup.js.map

package/dist/sidecar/lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/sidecar/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,KAAa;IACvE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,2BAA2B,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,aAAa,CAAC,CAAC;AAC/C,CAAC"}

package/dist/sidecar/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function sidecarPath(projectRoot: string, uuid: string): string;
+export declare function sidecarsDir(projectRoot: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/sidecar/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/sidecar/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/sidecar/paths.js

@@ -0,0 +1,8 @@
+import { join } from 'node:path';
+export function sidecarPath(projectRoot, uuid) {
+    return join(projectRoot, '.deskwork', 'entries', `${uuid}.json`);
+}
+export function sidecarsDir(projectRoot) {
+    return join(projectRoot, '.deskwork', 'entries');
+}
+//# sourceMappingURL=paths.js.map

package/dist/sidecar/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/sidecar/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,IAAY;IAC3D,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AACnD,CAAC"}

package/dist/sidecar/read-all.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Read every sidecar under `<projectRoot>/.deskwork/entries/*.json`.
+ *
+ * Used by surfaces that need to enumerate all entries (the studio
+ * dashboard, doctor cross-entry checks, doctor calendar regeneration).
+ * Malformed JSON or schema-invalid sidecars throw — silently skipping
+ * would mask the very corruption doctor is meant to catch.
+ *
+ * Returns entries in undefined order. Callers that care about ordering
+ * (the dashboard groups by stage and sorts by slug) sort downstream.
+ */
+import { type Entry } from '../schema/entry.ts';
+export declare function readAllSidecars(projectRoot: string): Promise<Entry[]>;
+//# sourceMappingURL=read-all.d.ts.map

package/dist/sidecar/read-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-all.d.ts","sourceRoot":"","sources":["../../src/sidecar/read-all.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG7D,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CA6B3E"}