@deskwork/core 0.14.0 → 0.15.0

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

@@ -21,84 +21,84 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        uuid: string;
+        source: string;
         slug: string;
         title: string;
+        uuid: string;
         keywords: string[];
-        source: string;
-        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
-        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled", number>>;
         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;
-        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled" | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
         reviewState?: "in-review" | "iterating" | "approved" | undefined;
         targetVersion?: string | undefined;
-        datePublished?: string | undefined;
         artifactPath?: string | undefined;
         shortformWorkflows?: Record<string, string> | undefined;
     }, {
-        uuid: string;
+        source: string;
         slug: string;
         title: string;
+        uuid: string;
         keywords: string[];
-        source: string;
-        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
-        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled", number>>;
         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;
-        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled" | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
         reviewState?: "in-review" | "iterating" | "approved" | undefined;
         targetVersion?: string | undefined;
-        datePublished?: string | undefined;
         artifactPath?: string | undefined;
         shortformWorkflows?: Record<string, string> | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    kind: "entry-created";
     at: string;
-    entryId: string;
     entry: {
-        uuid: string;
+        source: string;
         slug: string;
         title: string;
+        uuid: string;
         keywords: string[];
-        source: string;
-        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
-        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled", number>>;
         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;
-        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled" | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
         reviewState?: "in-review" | "iterating" | "approved" | undefined;
         targetVersion?: string | undefined;
-        datePublished?: string | undefined;
         artifactPath?: string | undefined;
         shortformWorkflows?: Record<string, string> | undefined;
     };
-}, {
     kind: "entry-created";
-    at: string;
     entryId: string;
+}, {
+    at: string;
     entry: {
-        uuid: string;
+        source: string;
         slug: string;
         title: string;
+        uuid: string;
         keywords: string[];
-        source: string;
-        currentStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
-        iterationByStage: Partial<Record<"Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled", number>>;
         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;
-        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled" | undefined;
+        datePublished?: string | undefined;
+        priorStage?: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled" | undefined;
         reviewState?: "in-review" | "iterating" | "approved" | undefined;
         targetVersion?: string | undefined;
-        datePublished?: string | undefined;
         artifactPath?: string | undefined;
         shortformWorkflows?: Record<string, string> | undefined;
     };
+    kind: "entry-created";
+    entryId: string;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"entry-ingested">;
     at: z.ZodString;
@@ -106,17 +106,17 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     sourcePath: z.ZodString;
     targetStage: z.ZodEnum<["Ideas", "Planned", "Outlining", "Drafting", "Final", "Published", "Blocked", "Cancelled"]>;
 }, "strip", z.ZodTypeAny, {
-    kind: "entry-ingested";
     at: string;
+    kind: "entry-ingested";
     entryId: string;
     sourcePath: string;
-    targetStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+    targetStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
 }, {
-    kind: "entry-ingested";
     at: string;
+    kind: "entry-ingested";
     entryId: string;
     sourcePath: string;
-    targetStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+    targetStage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"iteration">;
     at: z.ZodString;
@@ -125,18 +125,18 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     version: z.ZodNumber;
     markdown: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    kind: "iteration";
     at: string;
-    entryId: string;
-    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
     version: number;
+    kind: "iteration";
+    entryId: string;
     markdown: string;
 }, {
-    kind: "iteration";
     at: string;
-    entryId: string;
-    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
     version: number;
+    kind: "iteration";
+    entryId: string;
     markdown: string;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"annotation">;
@@ -164,72 +164,72 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         dispositionReason: z.ZodOptional<z.ZodString>;
         createdAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         type: "comment";
         createdAt: string;
-        id: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        category?: string | undefined;
         anchor?: string | undefined;
+        category?: string | undefined;
         disposition?: "addressed" | "deferred" | "wontfix" | undefined;
         dispositionReason?: string | undefined;
     }, {
+        id: string;
         type: "comment";
         createdAt: string;
-        id: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        category?: string | undefined;
         anchor?: string | undefined;
+        category?: string | undefined;
         disposition?: "addressed" | "deferred" | "wontfix" | undefined;
         dispositionReason?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    kind: "annotation";
     at: string;
-    entryId: string;
-    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
     version: number;
     annotation: {
+        id: string;
         type: "comment";
         createdAt: string;
-        id: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        category?: string | undefined;
         anchor?: string | undefined;
+        category?: string | undefined;
         disposition?: "addressed" | "deferred" | "wontfix" | undefined;
         dispositionReason?: string | undefined;
     };
-}, {
     kind: "annotation";
-    at: string;
     entryId: string;
-    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+}, {
+    at: string;
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
     version: number;
     annotation: {
+        id: string;
         type: "comment";
         createdAt: string;
-        id: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        category?: string | undefined;
         anchor?: string | undefined;
+        category?: string | undefined;
         disposition?: "addressed" | "deferred" | "wontfix" | undefined;
         dispositionReason?: string | undefined;
     };
+    kind: "annotation";
+    entryId: string;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"review-state-change">;
     at: z.ZodString;
@@ -238,19 +238,19 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     from: z.ZodNullable<z.ZodEnum<["in-review", "iterating", "approved"]>>;
     to: z.ZodNullable<z.ZodEnum<["in-review", "iterating", "approved"]>>;
 }, "strip", z.ZodTypeAny, {
-    kind: "review-state-change";
     at: string;
-    entryId: string;
-    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    kind: "review-state-change";
     from: "in-review" | "iterating" | "approved" | null;
     to: "in-review" | "iterating" | "approved" | null;
+    entryId: string;
 }, {
-    kind: "review-state-change";
     at: string;
-    entryId: string;
-    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
+    stage: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    kind: "review-state-change";
     from: "in-review" | "iterating" | "approved" | null;
     to: "in-review" | "iterating" | "approved" | null;
+    entryId: string;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"stage-transition">;
     at: z.ZodString;
@@ -260,19 +260,19 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
     reason: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
-    kind: "stage-transition";
     at: string;
+    kind: "stage-transition";
+    from: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    to: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
     entryId: string;
-    from: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
-    to: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
     reason?: string | undefined;
     metadata?: Record<string, unknown> | undefined;
 }, {
-    kind: "stage-transition";
     at: string;
+    kind: "stage-transition";
+    from: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
+    to: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Published" | "Final" | "Blocked" | "Cancelled";
     entryId: string;
-    from: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
-    to: "Ideas" | "Planned" | "Outlining" | "Drafting" | "Final" | "Published" | "Blocked" | "Cancelled";
     reason?: string | undefined;
     metadata?: Record<string, unknown> | undefined;
 }>, z.ZodObject<{
@@ -299,31 +299,31 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         workflowId: z.ZodString;
         id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         type: "comment";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
+        workflowId: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        workflowId: string;
-        category?: "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | "other" | undefined;
         anchor?: string | undefined;
+        category?: "other" | "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | undefined;
     }, {
+        id: string;
         type: "comment";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
+        workflowId: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        workflowId: string;
-        category?: "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | "other" | undefined;
         anchor?: string | undefined;
+        category?: "other" | "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | undefined;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"edit">;
         beforeVersion: z.ZodNumber;
@@ -333,17 +333,17 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         workflowId: z.ZodString;
         id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         type: "edit";
         createdAt: string;
-        id: string;
         workflowId: string;
         beforeVersion: number;
         afterMarkdown: string;
         diff: string;
     }, {
+        id: string;
         type: "edit";
         createdAt: string;
-        id: string;
         workflowId: string;
         beforeVersion: number;
         afterMarkdown: string;
@@ -355,16 +355,16 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         workflowId: z.ZodString;
         id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         type: "approve";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
     }, {
+        id: string;
         type: "approve";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
     }>, z.ZodObject<{
         type: z.ZodLiteral<"reject">;
@@ -374,17 +374,17 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         workflowId: z.ZodString;
         id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         type: "reject";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
         reason?: string | undefined;
     }, {
+        id: string;
         type: "reject";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
         reason?: string | undefined;
     }>, z.ZodObject<{
@@ -395,16 +395,16 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         workflowId: z.ZodString;
         id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         type: "resolve";
         createdAt: string;
-        id: string;
         workflowId: string;
         commentId: string;
         resolved: boolean;
     }, {
+        id: string;
         type: "resolve";
         createdAt: string;
-        id: string;
         workflowId: string;
         commentId: string;
         resolved: boolean;
@@ -418,134 +418,134 @@ export declare const JournalEventSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodO
         workflowId: z.ZodString;
         id: z.ZodString;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         type: "address";
-        createdAt: string;
         version: number;
-        id: string;
-        disposition: "addressed" | "deferred" | "wontfix";
+        createdAt: string;
         workflowId: string;
         commentId: string;
+        disposition: "addressed" | "deferred" | "wontfix";
         reason?: string | undefined;
     }, {
+        id: string;
         type: "address";
-        createdAt: string;
         version: number;
-        id: string;
-        disposition: "addressed" | "deferred" | "wontfix";
+        createdAt: string;
         workflowId: string;
         commentId: string;
+        disposition: "addressed" | "deferred" | "wontfix";
         reason?: string | undefined;
     }>]>;
 }, "strip", z.ZodTypeAny, {
-    kind: "entry-annotation";
     at: string;
-    entryId: string;
     annotation: {
+        id: string;
         type: "comment";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
+        workflowId: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        workflowId: string;
-        category?: "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | "other" | undefined;
         anchor?: string | undefined;
+        category?: "other" | "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | undefined;
     } | {
+        id: string;
         type: "edit";
         createdAt: string;
-        id: string;
         workflowId: string;
         beforeVersion: number;
         afterMarkdown: string;
         diff: string;
     } | {
+        id: string;
         type: "approve";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
     } | {
+        id: string;
         type: "reject";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
         reason?: string | undefined;
     } | {
+        id: string;
         type: "resolve";
         createdAt: string;
-        id: string;
         workflowId: string;
         commentId: string;
         resolved: boolean;
     } | {
+        id: string;
         type: "address";
-        createdAt: string;
         version: number;
-        id: string;
-        disposition: "addressed" | "deferred" | "wontfix";
+        createdAt: string;
         workflowId: string;
         commentId: string;
+        disposition: "addressed" | "deferred" | "wontfix";
         reason?: string | undefined;
     };
-}, {
     kind: "entry-annotation";
-    at: string;
     entryId: string;
+}, {
+    at: string;
     annotation: {
+        id: string;
         type: "comment";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
+        workflowId: string;
         range: {
             start: number;
             end: number;
         };
         text: string;
-        workflowId: string;
-        category?: "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | "other" | undefined;
         anchor?: string | undefined;
+        category?: "other" | "voice-drift" | "missing-receipt" | "tutorial-framing" | "saas-vocabulary" | "fake-authority" | "structural" | undefined;
     } | {
+        id: string;
         type: "edit";
         createdAt: string;
-        id: string;
         workflowId: string;
         beforeVersion: number;
         afterMarkdown: string;
         diff: string;
     } | {
+        id: string;
         type: "approve";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
     } | {
+        id: string;
         type: "reject";
-        createdAt: string;
         version: number;
-        id: string;
+        createdAt: string;
         workflowId: string;
         reason?: string | undefined;
     } | {
+        id: string;
         type: "resolve";
         createdAt: string;
-        id: string;
         workflowId: string;
         commentId: string;
         resolved: boolean;
     } | {
+        id: string;
         type: "address";
-        createdAt: string;
         version: number;
-        id: string;
-        disposition: "addressed" | "deferred" | "wontfix";
+        createdAt: string;
         workflowId: string;
         commentId: string;
+        disposition: "addressed" | "deferred" | "wontfix";
         reason?: string | undefined;
     };
+    kind: "entry-annotation";
+    entryId: string;
 }>]>;
 export type JournalEvent = z.infer<typeof JournalEventSchema>;
 //# sourceMappingURL=journal-events.d.ts.map

package/dist/scrapbook.d.ts

@@ -119,6 +119,23 @@ export interface ScrapbookLocation {
  * `<scrapbook>/secret/<filename>` instead of `<scrapbook>/<filename>`.
  */
 export declare function scrapbookFilePath(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, opts?: ScrapbookLocation): string;
+/**
+ * Resolve a filename inside an already-resolved scrapbook directory.
+ * Mirrors `listScrapbookAtDir` — used by callers that have already
+ * resolved the on-disk dir via `scrapbookDirForEntry` (id-driven) or
+ * `scrapbookDirAtPath` (fs-path-driven) and don't want to re-derive
+ * through the slug template.
+ *
+ * Same security guards as `scrapbookFilePath`:
+ *   - `assertFilename` blocks dotfiles / `..` / absolute paths in the filename
+ *   - the `startsWith(dir + '/')` containment check blocks any traversal
+ *     that slipped through (so `secret/` always sits inside the top-level
+ *     scrapbook dir)
+ *
+ * The slug-shape validator is bypassed because the caller has already
+ * proven the directory exists in the content tree by other means.
+ */
+export declare function scrapbookFilePathAtDir(scrapbookDirAbs: string, filename: string, opts?: ScrapbookLocation): string;
 export declare function classify(filename: string): ScrapbookItemKind;
 /**
  * List the items in a scrapbook, sorted newest-mtime first. Returns
@@ -202,6 +219,49 @@ export declare function readScrapbookFile(projectRoot: string, config: DeskworkC
     mtime: string;
     content: Buffer;
 };
+/**
+ * Read a scrapbook file given the absolute scrapbook directory. Used
+ * by callers that have already resolved the on-disk dir via
+ * `scrapbookDirForEntry` (id-driven) or `scrapbookDirAtPath`
+ * (fs-path-driven) and don't want to re-derive through the slug
+ * template. Mirrors the listing-side primitive `listScrapbookAtDir`.
+ *
+ * Same security guards as `readScrapbookFile` (filename validation +
+ * path-traversal containment) via `scrapbookFilePathAtDir`.
+ */
+export declare function readScrapbookFileAtDir(scrapbookDirAbs: string, filename: string, opts?: ScrapbookLocation): {
+    name: string;
+    kind: ScrapbookItemKind;
+    size: number;
+    mtime: string;
+    content: Buffer;
+};
+/**
+ * Read a scrapbook file for a tracked calendar entry. Mirrors
+ * `listScrapbookForEntry` / `countScrapbookForEntry` — id-driven
+ * resolution via `scrapbookDirForEntry`, slug fallback for pre-bound
+ * entries. Used by the studio's `/api/dev/scrapbook-file?entryId=...`
+ * variant so projects whose feature-doc layout doesn't match the
+ * kebab-case slug template (e.g. `docs/<version>/<status>/<feature>/`)
+ * can still serve scrapbook assets — `scrapbookDirAtPath`'s slug
+ * validator would otherwise reject any path with dots or uppercase
+ * segments.
+ *
+ * Same security guards as the slug-shape variant: `assertFilename`
+ * blocks dotfiles / `..` / absolute paths in the filename; the
+ * `startsWith(dir + '/')` containment check blocks any traversal that
+ * slipped through.
+ */
+export declare function readScrapbookFileForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
+    id?: string;
+    slug: string;
+}, filename: string, opts?: ScrapbookLocation, index?: ContentIndex): {
+    name: string;
+    kind: ScrapbookItemKind;
+    size: number;
+    mtime: string;
+    content: Buffer;
+};
 /**
  * Create a new markdown note in the scrapbook. Creates the scrapbook
  * dir (and `secret/` subdir, if needed) if it doesn't exist. Refuses