@deskwork/core 0.15.0 → 0.17.0

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

@@ -1 +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;AA4ExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"journal-events.d.ts","sourceRoot":"","sources":["../../src/schema/journal-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4ExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/scrapbook/crud-at-dir.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Entry-aware CRUD primitives — operate on a pre-resolved scrapbook dir.
+ *
+ * The studio's mutation routes resolve the scrapbook directory via
+ * `scrapbookDirForEntry` (entry-id driven; refactor-proof) and then call
+ * these `*AtDir` helpers. Mirrors the listing-side `listScrapbookAtDir` /
+ * `readScrapbookFileAtDir` primitives.
+ *
+ * Same security guards as the slug-shape helpers via
+ * `scrapbookFilePathAtDir`: filename validation + path-traversal
+ * containment.
+ *
+ * This is the public mutation surface post-#192. The slug-template
+ * mutation primitives (`createScrapbookMarkdown`, `saveScrapbookFile`,
+ * `renameScrapbookFile`, `deleteScrapbookFile`, `writeScrapbookUpload`)
+ * were collapsed to private helpers in the same change — external
+ * callers go through these `*AtDir` functions plus a dir resolved by
+ * `scrapbookDirForEntry`.
+ */
+import type { ScrapbookItem, ScrapbookLocation } from './types.ts';
+/**
+ * Create a new markdown note inside an already-resolved scrapbook dir.
+ * Mirrors the legacy `createScrapbookMarkdown` (now private) but takes
+ * the dir directly.
+ */
+export declare function createScrapbookMarkdownAtDir(scrapbookDirAbs: string, filename: string, body: string, opts?: ScrapbookLocation): ScrapbookItem;
+/**
+ * Overwrite an existing file's contents inside an already-resolved scrapbook
+ * dir. Mirrors the legacy `saveScrapbookFile` (now private).
+ */
+export declare function saveScrapbookFileAtDir(scrapbookDirAbs: string, filename: string, body: string | Buffer, opts?: ScrapbookLocation): ScrapbookItem;
+/**
+ * Rename a file inside an already-resolved scrapbook dir. Mirrors the
+ * legacy `renameScrapbookFile` (now private).
+ */
+export declare function renameScrapbookFileAtDir(scrapbookDirAbs: string, oldName: string, newName: string, opts?: ScrapbookLocation): ScrapbookItem;
+/**
+ * Delete a file inside an already-resolved scrapbook dir. Mirrors the
+ * legacy `deleteScrapbookFile` (now private).
+ */
+export declare function deleteScrapbookFileAtDir(scrapbookDirAbs: string, filename: string, opts?: ScrapbookLocation): void;
+/**
+ * Write an uploaded file inside an already-resolved scrapbook dir.
+ * Mirrors the legacy `writeScrapbookUpload` (now private).
+ */
+export declare function writeScrapbookUploadAtDir(scrapbookDirAbs: string, filename: string, content: Buffer, opts?: ScrapbookLocation): ScrapbookItem;
+//# sourceMappingURL=crud-at-dir.d.ts.map

package/dist/scrapbook/crud-at-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-at-dir.d.ts","sourceRoot":"","sources":["../../src/scrapbook/crud-at-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAiBf;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAWf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAef;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAcf"}

package/dist/scrapbook/crud-at-dir.js

@@ -0,0 +1,114 @@
+/**
+ * Entry-aware CRUD primitives — operate on a pre-resolved scrapbook dir.
+ *
+ * The studio's mutation routes resolve the scrapbook directory via
+ * `scrapbookDirForEntry` (entry-id driven; refactor-proof) and then call
+ * these `*AtDir` helpers. Mirrors the listing-side `listScrapbookAtDir` /
+ * `readScrapbookFileAtDir` primitives.
+ *
+ * Same security guards as the slug-shape helpers via
+ * `scrapbookFilePathAtDir`: filename validation + path-traversal
+ * containment.
+ *
+ * This is the public mutation surface post-#192. The slug-template
+ * mutation primitives (`createScrapbookMarkdown`, `saveScrapbookFile`,
+ * `renameScrapbookFile`, `deleteScrapbookFile`, `writeScrapbookUpload`)
+ * were collapsed to private helpers in the same change — external
+ * callers go through these `*AtDir` functions plus a dir resolved by
+ * `scrapbookDirForEntry`.
+ */
+import { existsSync, mkdirSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { scrapbookFilePathAtDir } from "./paths.js";
+import { classify } from "./validation.js";
+/**
+ * Create a new markdown note inside an already-resolved scrapbook dir.
+ * Mirrors the legacy `createScrapbookMarkdown` (now private) but takes
+ * the dir directly.
+ */
+export function createScrapbookMarkdownAtDir(scrapbookDirAbs, filename, body, opts = {}) {
+    if (!filename.endsWith('.md')) {
+        throw new Error(`create endpoint only accepts .md files: "${filename}"`);
+    }
+    const abs = scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts);
+    if (existsSync(abs)) {
+        throw new Error(`file already exists: "${filename}"`);
+    }
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, body, 'utf-8');
+    const st = statSync(abs);
+    return {
+        name: filename,
+        kind: 'md',
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+/**
+ * Overwrite an existing file's contents inside an already-resolved scrapbook
+ * dir. Mirrors the legacy `saveScrapbookFile` (now private).
+ */
+export function saveScrapbookFileAtDir(scrapbookDirAbs, filename, body, opts = {}) {
+    const abs = scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts);
+    if (!existsSync(abs))
+        throw new Error(`file not found: "${filename}"`);
+    writeFileSync(abs, body);
+    const st = statSync(abs);
+    return {
+        name: filename,
+        kind: classify(filename),
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+/**
+ * Rename a file inside an already-resolved scrapbook dir. Mirrors the
+ * legacy `renameScrapbookFile` (now private).
+ */
+export function renameScrapbookFileAtDir(scrapbookDirAbs, oldName, newName, opts = {}) {
+    const oldAbs = scrapbookFilePathAtDir(scrapbookDirAbs, oldName, opts);
+    const newAbs = scrapbookFilePathAtDir(scrapbookDirAbs, newName, opts);
+    if (!existsSync(oldAbs))
+        throw new Error(`file not found: "${oldName}"`);
+    if (existsSync(newAbs) && oldAbs !== newAbs) {
+        throw new Error(`target name already exists: "${newName}"`);
+    }
+    renameSync(oldAbs, newAbs);
+    const st = statSync(newAbs);
+    return {
+        name: newName,
+        kind: classify(newName),
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+/**
+ * Delete a file inside an already-resolved scrapbook dir. Mirrors the
+ * legacy `deleteScrapbookFile` (now private).
+ */
+export function deleteScrapbookFileAtDir(scrapbookDirAbs, filename, opts = {}) {
+    const abs = scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts);
+    if (!existsSync(abs))
+        throw new Error(`file not found: "${filename}"`);
+    rmSync(abs);
+}
+/**
+ * Write an uploaded file inside an already-resolved scrapbook dir.
+ * Mirrors the legacy `writeScrapbookUpload` (now private).
+ */
+export function writeScrapbookUploadAtDir(scrapbookDirAbs, filename, content, opts = {}) {
+    const abs = scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts);
+    if (existsSync(abs)) {
+        throw new Error(`file already exists: "${filename}" — rename first`);
+    }
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+    const st = statSync(abs);
+    return {
+        name: filename,
+        kind: classify(filename),
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+//# sourceMappingURL=crud-at-dir.js.map

package/dist/scrapbook/crud-at-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-at-dir.js","sourceRoot":"","sources":["../../src/scrapbook/crud-at-dir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,EACN,QAAQ,EACR,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,eAAuB,EACvB,QAAgB,EAChB,IAAY,EACZ,OAA0B,EAAE;IAE5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,GAAG,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,GAAG,GAAG,sBAAsB,CAAC,eAAe,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,eAAuB,EACvB,QAAgB,EAChB,IAAqB,EACrB,OAA0B,EAAE;IAE5B,MAAM,GAAG,GAAG,sBAAsB,CAAC,eAAe,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,GAAG,CAAC,CAAC;IACvE,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;QACxB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,eAAuB,EACvB,OAAe,EACf,OAAe,EACf,OAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,sBAAsB,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,sBAAsB,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,GAAG,CAAC,CAAC;IACzE,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,GAAG,CAAC,CAAC;IAC9D,CAAC;IACD,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC;QACvB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,eAAuB,EACvB,QAAgB,EAChB,OAA0B,EAAE;IAE5B,MAAM,GAAG,GAAG,sBAAsB,CAAC,eAAe,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,GAAG,CAAC,CAAC;IACvE,MAAM,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,eAAuB,EACvB,QAAgB,EAChB,OAAe,EACf,OAA0B,EAAE;IAE5B,MAAM,GAAG,GAAG,sBAAsB,CAAC,eAAe,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,kBAAkB,CAAC,CAAC;IACvE,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC;QACxB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE;KAC9B,CAAC;AACJ,CAAC"}

package/dist/scrapbook/crud-slug.d.ts

@@ -0,0 +1,33 @@
+/**
+ * INTERNAL — slug-template CRUD primitives.
+ *
+ * These were the public mutation surface pre-#192 but are now private:
+ * external callers go through the entry-aware `*AtDir` family in
+ * `crud-at-dir.ts` after resolving the dir via `scrapbookDirForEntry`
+ * (or `scrapbookDirAtPath`). This module is the implementation home
+ * for the legacy slug-template path and is re-used inside the scrapbook
+ * module family — `seed.ts` calls these helpers to seed a slug-keyed
+ * README at plan time.
+ *
+ * NOT re-exported from the barrel (`packages/core/src/scrapbook.ts`).
+ *
+ * Same security guards as the entry-aware `*AtDir` family — filename
+ * validation + path-traversal containment via the underlying
+ * `scrapbookFilePathAtDir`.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { ScrapbookItem, ScrapbookLocation } from './types.ts';
+/**
+ * INTERNAL — create a new markdown note in the slug-template scrapbook.
+ * Used by `seed.ts`. Refuses to overwrite existing files.
+ */
+export declare function _createScrapbookMarkdownSlug(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, body: string, opts?: ScrapbookLocation): ScrapbookItem;
+/** INTERNAL — overwrite an existing file's contents (slug-template). */
+export declare function _saveScrapbookFileSlug(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, body: string | Buffer, opts?: ScrapbookLocation): ScrapbookItem;
+/** INTERNAL — rename a file (slug-template). */
+export declare function _renameScrapbookFileSlug(projectRoot: string, config: DeskworkConfig, site: string, slug: string, oldName: string, newName: string, opts?: ScrapbookLocation): ScrapbookItem;
+/** INTERNAL — delete a file (slug-template). */
+export declare function _deleteScrapbookFileSlug(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, opts?: ScrapbookLocation): void;
+/** INTERNAL — write an uploaded file (slug-template). */
+export declare function _writeScrapbookUploadSlug(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, content: Buffer, opts?: ScrapbookLocation): ScrapbookItem;
+//# sourceMappingURL=crud-slug.d.ts.map

package/dist/scrapbook/crud-slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crud-slug.d.ts","sourceRoot":"","sources":["../../src/scrapbook/crud-slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAiBf;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAWf;AAED,gDAAgD;AAChD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAef;AAED,gDAAgD;AAChD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,IAAI,CAIN;AAED,yDAAyD;AACzD,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC3B,aAAa,CAcf"}

package/dist/scrapbook/crud-slug.js

@@ -0,0 +1,99 @@
+/**
+ * INTERNAL — slug-template CRUD primitives.
+ *
+ * These were the public mutation surface pre-#192 but are now private:
+ * external callers go through the entry-aware `*AtDir` family in
+ * `crud-at-dir.ts` after resolving the dir via `scrapbookDirForEntry`
+ * (or `scrapbookDirAtPath`). This module is the implementation home
+ * for the legacy slug-template path and is re-used inside the scrapbook
+ * module family — `seed.ts` calls these helpers to seed a slug-keyed
+ * README at plan time.
+ *
+ * NOT re-exported from the barrel (`packages/core/src/scrapbook.ts`).
+ *
+ * Same security guards as the entry-aware `*AtDir` family — filename
+ * validation + path-traversal containment via the underlying
+ * `scrapbookFilePathAtDir`.
+ */
+import { existsSync, mkdirSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { dirname } from 'node:path';
+import { _scrapbookFilePathSlug } from "./paths.js";
+import { classify } from "./validation.js";
+/**
+ * INTERNAL — create a new markdown note in the slug-template scrapbook.
+ * Used by `seed.ts`. Refuses to overwrite existing files.
+ */
+export function _createScrapbookMarkdownSlug(projectRoot, config, site, slug, filename, body, opts = {}) {
+    if (!filename.endsWith('.md')) {
+        throw new Error(`create endpoint only accepts .md files: "${filename}"`);
+    }
+    const abs = _scrapbookFilePathSlug(projectRoot, config, site, slug, filename, opts);
+    if (existsSync(abs)) {
+        throw new Error(`file already exists: "${filename}"`);
+    }
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, body, 'utf-8');
+    const st = statSync(abs);
+    return {
+        name: filename,
+        kind: 'md',
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+/** INTERNAL — overwrite an existing file's contents (slug-template). */
+export function _saveScrapbookFileSlug(projectRoot, config, site, slug, filename, body, opts = {}) {
+    const abs = _scrapbookFilePathSlug(projectRoot, config, site, slug, filename, opts);
+    if (!existsSync(abs))
+        throw new Error(`file not found: "${filename}"`);
+    writeFileSync(abs, body);
+    const st = statSync(abs);
+    return {
+        name: filename,
+        kind: classify(filename),
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+/** INTERNAL — rename a file (slug-template). */
+export function _renameScrapbookFileSlug(projectRoot, config, site, slug, oldName, newName, opts = {}) {
+    const oldAbs = _scrapbookFilePathSlug(projectRoot, config, site, slug, oldName, opts);
+    const newAbs = _scrapbookFilePathSlug(projectRoot, config, site, slug, newName, opts);
+    if (!existsSync(oldAbs))
+        throw new Error(`file not found: "${oldName}"`);
+    if (existsSync(newAbs) && oldAbs !== newAbs) {
+        throw new Error(`target name already exists: "${newName}"`);
+    }
+    renameSync(oldAbs, newAbs);
+    const st = statSync(newAbs);
+    return {
+        name: newName,
+        kind: classify(newName),
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+/** INTERNAL — delete a file (slug-template). */
+export function _deleteScrapbookFileSlug(projectRoot, config, site, slug, filename, opts = {}) {
+    const abs = _scrapbookFilePathSlug(projectRoot, config, site, slug, filename, opts);
+    if (!existsSync(abs))
+        throw new Error(`file not found: "${filename}"`);
+    rmSync(abs);
+}
+/** INTERNAL — write an uploaded file (slug-template). */
+export function _writeScrapbookUploadSlug(projectRoot, config, site, slug, filename, content, opts = {}) {
+    const abs = _scrapbookFilePathSlug(projectRoot, config, site, slug, filename, opts);
+    if (existsSync(abs)) {
+        throw new Error(`file already exists: "${filename}" — rename first`);
+    }
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+    const st = statSync(abs);
+    return {
+        name: filename,
+        kind: classify(filename),
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+    };
+}
+//# sourceMappingURL=crud-slug.js.map

package/dist/scrapbook/crud-slug.js.map

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

package/dist/scrapbook/format.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Formatting helpers for the studio chip / viewer.
+ *
+ * Pure stringly-typed conversions — no fs, no config — so the studio
+ * client can import these without pulling in the rest of the scrapbook
+ * module family.
+ */
+export declare function formatRelativeTime(iso: string, now?: Date): string;
+export declare function formatSize(bytes: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/scrapbook/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/scrapbook/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAkB9E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD"}

package/dist/scrapbook/format.js

@@ -0,0 +1,41 @@
+/**
+ * Formatting helpers for the studio chip / viewer.
+ *
+ * Pure stringly-typed conversions — no fs, no config — so the studio
+ * client can import these without pulling in the rest of the scrapbook
+ * module family.
+ */
+export function formatRelativeTime(iso, now = new Date()) {
+    const then = new Date(iso).getTime();
+    const diff = now.getTime() - then;
+    if (diff < 0)
+        return 'just now';
+    const s = Math.floor(diff / 1000);
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 48)
+        return `${h}h ago`;
+    const d = Math.floor(h / 24);
+    if (d < 14)
+        return `${d}d ago`;
+    const w = Math.floor(d / 7);
+    if (w < 9)
+        return `${w}w ago`;
+    const months = Math.floor(d / 30);
+    if (months < 18)
+        return `${months}mo ago`;
+    const y = Math.floor(d / 365);
+    return `${y}y ago`;
+}
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=format.js.map

package/dist/scrapbook/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/scrapbook/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,MAAY,IAAI,IAAI,EAAE;IACpE,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;IAClC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE;QAAE,OAAO,GAAG,MAAM,QAAQ,CAAC;IAC1C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC"}

package/dist/scrapbook/listing.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Scrapbook listing + counting helpers.
+ *
+ * Read-only inventory of a scrapbook directory: sorted item lists +
+ * total counts, with a public/secret split.
+ *
+ * Three addressing modes — slug-template (`listScrapbook` /
+ * `countScrapbook`), pre-resolved dir (`listScrapbookAtDir`), and
+ * entry-aware (`listScrapbookForEntry` / `countScrapbookForEntry`).
+ * The slug-template variants stay public because read-side callers
+ * (the studio scrapbook viewer page, the dashboard chip count) operate
+ * on a path key that's structurally a slug; the legacy entry point is
+ * still useful at that boundary. The mutation side (#192) collapsed
+ * to entry-aware only.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { ContentIndex } from '../content-index.ts';
+import { type ScrapbookSummary } from './types.ts';
+/**
+ * List the items in a scrapbook, sorted newest-mtime first. Returns
+ * both public items (top-level files) and secret items (files inside
+ * `scrapbook/secret/`). Subdirectories at the top level OTHER than
+ * `secret/` are ignored — deskwork doesn't recurse into arbitrary
+ * trees inside a scrapbook.
+ */
+export declare function listScrapbook(projectRoot: string, config: DeskworkConfig, site: string, slug: string): ScrapbookSummary;
+/**
+ * List a scrapbook by absolute directory path. Used by callers that
+ * have already resolved the on-disk path via `scrapbookDirForEntry`
+ * (id-driven) or `scrapbookDirAtPath` (fs-path-driven) and don't want
+ * to re-derive through the slug template. The `slug` parameter is only
+ * used to populate the returned summary's identifier field — it does
+ * not influence path resolution.
+ *
+ * Internal primitive shared by `listScrapbook` (slug-based) and
+ * `listScrapbookForEntry` (id-driven).
+ */
+export declare function listScrapbookAtDir(site: string, slug: string, dir: string): ScrapbookSummary;
+/**
+ * List scrapbook items for a tracked calendar entry. Resolves the
+ * scrapbook directory via the content index when available (id binding),
+ * falling back to slug-based addressing for entries that haven't been
+ * bound to frontmatter yet (pre-doctor state).
+ *
+ * Mirrors the shape of `countScrapbookForEntry`. Used by the studio
+ * review-page drawer + content-detail panel so writingcontrol-shape
+ * entries (where the file path diverges from the slug template) list
+ * items at the correct on-disk location.
+ *
+ * @param entry Calendar entry — `id` preferred; `slug` is both the
+ *              legacy fallback and the disambiguator the underlying
+ *              resolver uses when the index is incomplete.
+ * @param index Optional pre-built per-request index. When omitted, the
+ *              resolver builds one on demand.
+ */
+export declare function listScrapbookForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
+    id?: string;
+    slug: string;
+}, index?: ContentIndex): ScrapbookSummary;
+/**
+ * Total item count (public + secret). Used by the studio chip for the
+ * badge — operators want a single "has scrapbook content" signal that
+ * counts everything attached to this entry.
+ *
+ * Slug-based addressing: resolves `<contentDir>/<slug>/scrapbook/`. For
+ * entries whose on-disk path doesn't match the slug template (e.g.
+ * writingcontrol-shape projects where slug `the-outbound` lives at
+ * `projects/the-outbound/index.md`), use `countScrapbookForEntry`
+ * instead — it derives the path from the bound file via the content
+ * index.
+ */
+export declare function countScrapbook(projectRoot: string, config: DeskworkConfig, site: string, slug: string): number;
+/**
+ * Count scrapbook items for a tracked calendar entry. Resolves the
+ * scrapbook directory via the content index when available (id binding),
+ * falling back to slug-based addressing for entries that haven't been
+ * bound to frontmatter yet (pre-doctor state).
+ *
+ * Mirrors the shape of `scrapbookDirForEntry` — same resolver, same
+ * legacy-slug fallback. Used by the studio dashboard chip so writing-
+ * control-shape entries (where the file path diverges from the slug
+ * template) report the correct count.
+ *
+ * @param entry Calendar entry — `id` preferred (Phase 19+); `slug` is
+ *              both the legacy fallback and the disambiguator the
+ *              underlying resolver uses when the index is incomplete.
+ * @param index Optional pre-built per-request index. When omitted, the
+ *              resolver builds one on demand.
+ */
+export declare function countScrapbookForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
+    id?: string;
+    slug: string;
+}, index?: ContentIndex): number;
+//# sourceMappingURL=listing.d.ts.map

package/dist/scrapbook/listing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listing.d.ts","sourceRoot":"","sources":["../../src/scrapbook/listing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAMpB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,gBAAgB,CAGlB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,gBAAgB,CAQlB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACpC,KAAK,CAAC,EAAE,YAAY,GACnB,gBAAgB,CAGlB;AA6CD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACpC,KAAK,CAAC,EAAE,YAAY,GACnB,MAAM,CAOR"}

package/dist/scrapbook/listing.js

@@ -0,0 +1,167 @@
+/**
+ * Scrapbook listing + counting helpers.
+ *
+ * Read-only inventory of a scrapbook directory: sorted item lists +
+ * total counts, with a public/secret split.
+ *
+ * Three addressing modes — slug-template (`listScrapbook` /
+ * `countScrapbook`), pre-resolved dir (`listScrapbookAtDir`), and
+ * entry-aware (`listScrapbookForEntry` / `countScrapbookForEntry`).
+ * The slug-template variants stay public because read-side callers
+ * (the studio scrapbook viewer page, the dashboard chip count) operate
+ * on a path key that's structurally a slug; the legacy entry point is
+ * still useful at that boundary. The mutation side (#192) collapsed
+ * to entry-aware only.
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { _scrapbookDirSlug, scrapbookDirForEntry } from "./paths.js";
+import { classify } from "./validation.js";
+import { SECRET_SUBDIR, } from "./types.js";
+// ---------------------------------------------------------------------------
+// Listing
+// ---------------------------------------------------------------------------
+/**
+ * List the items in a scrapbook, sorted newest-mtime first. Returns
+ * both public items (top-level files) and secret items (files inside
+ * `scrapbook/secret/`). Subdirectories at the top level OTHER than
+ * `secret/` are ignored — deskwork doesn't recurse into arbitrary
+ * trees inside a scrapbook.
+ */
+export function listScrapbook(projectRoot, config, site, slug) {
+    const dir = _scrapbookDirSlug(projectRoot, config, site, slug);
+    return listScrapbookAtDir(site, slug, dir);
+}
+/**
+ * List a scrapbook by absolute directory path. Used by callers that
+ * have already resolved the on-disk path via `scrapbookDirForEntry`
+ * (id-driven) or `scrapbookDirAtPath` (fs-path-driven) and don't want
+ * to re-derive through the slug template. The `slug` parameter is only
+ * used to populate the returned summary's identifier field — it does
+ * not influence path resolution.
+ *
+ * Internal primitive shared by `listScrapbook` (slug-based) and
+ * `listScrapbookForEntry` (id-driven).
+ */
+export function listScrapbookAtDir(site, slug, dir) {
+    if (!existsSync(dir)) {
+        return { site, slug, dir, exists: false, items: [], secretItems: [] };
+    }
+    const items = listFilesInDir(dir);
+    const secretDir = join(dir, SECRET_SUBDIR);
+    const secretItems = existsSync(secretDir) ? listFilesInDir(secretDir) : [];
+    return { site, slug, dir, exists: true, items, secretItems };
+}
+/**
+ * List scrapbook items for a tracked calendar entry. Resolves the
+ * scrapbook directory via the content index when available (id binding),
+ * falling back to slug-based addressing for entries that haven't been
+ * bound to frontmatter yet (pre-doctor state).
+ *
+ * Mirrors the shape of `countScrapbookForEntry`. Used by the studio
+ * review-page drawer + content-detail panel so writingcontrol-shape
+ * entries (where the file path diverges from the slug template) list
+ * items at the correct on-disk location.
+ *
+ * @param entry Calendar entry — `id` preferred; `slug` is both the
+ *              legacy fallback and the disambiguator the underlying
+ *              resolver uses when the index is incomplete.
+ * @param index Optional pre-built per-request index. When omitted, the
+ *              resolver builds one on demand.
+ */
+export function listScrapbookForEntry(projectRoot, config, site, entry, index) {
+    const dir = scrapbookDirForEntry(projectRoot, config, site, entry, index);
+    return listScrapbookAtDir(site, entry.slug, dir);
+}
+/** Internal helper — list files (not subdirs/dotfiles) at a given path. */
+function listFilesInDir(dir) {
+    const items = [];
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+        if (!e.isFile())
+            continue;
+        if (e.name.startsWith('.'))
+            continue;
+        const abs = join(dir, e.name);
+        const st = statSync(abs);
+        items.push({
+            name: e.name,
+            kind: classify(e.name),
+            size: st.size,
+            mtime: st.mtime.toISOString(),
+        });
+    }
+    items.sort((a, b) => b.mtime.localeCompare(a.mtime));
+    return items;
+}
+// ---------------------------------------------------------------------------
+// Counting
+// ---------------------------------------------------------------------------
+/**
+ * Count items inside an absolute scrapbook directory — files at the top
+ * level plus files inside the `secret/` subdirectory. Returns 0 if the
+ * directory doesn't exist; tolerates fs errors so a transient permission
+ * issue or race never crashes the dashboard render. Internal primitive
+ * shared by `countScrapbook` (slug-based) and `countScrapbookForEntry`
+ * (id-driven).
+ */
+function countScrapbookAtDir(dir) {
+    try {
+        if (!existsSync(dir))
+            return 0;
+        const top = listFilesInDir(dir);
+        const secretDir = join(dir, SECRET_SUBDIR);
+        const secret = existsSync(secretDir) ? listFilesInDir(secretDir) : [];
+        return top.length + secret.length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Total item count (public + secret). Used by the studio chip for the
+ * badge — operators want a single "has scrapbook content" signal that
+ * counts everything attached to this entry.
+ *
+ * Slug-based addressing: resolves `<contentDir>/<slug>/scrapbook/`. For
+ * entries whose on-disk path doesn't match the slug template (e.g.
+ * writingcontrol-shape projects where slug `the-outbound` lives at
+ * `projects/the-outbound/index.md`), use `countScrapbookForEntry`
+ * instead — it derives the path from the bound file via the content
+ * index.
+ */
+export function countScrapbook(projectRoot, config, site, slug) {
+    try {
+        const dir = _scrapbookDirSlug(projectRoot, config, site, slug);
+        return countScrapbookAtDir(dir);
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Count scrapbook items for a tracked calendar entry. Resolves the
+ * scrapbook directory via the content index when available (id binding),
+ * falling back to slug-based addressing for entries that haven't been
+ * bound to frontmatter yet (pre-doctor state).
+ *
+ * Mirrors the shape of `scrapbookDirForEntry` — same resolver, same
+ * legacy-slug fallback. Used by the studio dashboard chip so writing-
+ * control-shape entries (where the file path diverges from the slug
+ * template) report the correct count.
+ *
+ * @param entry Calendar entry — `id` preferred (Phase 19+); `slug` is
+ *              both the legacy fallback and the disambiguator the
+ *              underlying resolver uses when the index is incomplete.
+ * @param index Optional pre-built per-request index. When omitted, the
+ *              resolver builds one on demand.
+ */
+export function countScrapbookForEntry(projectRoot, config, site, entry, index) {
+    try {
+        const dir = scrapbookDirForEntry(projectRoot, config, site, entry, index);
+        return countScrapbookAtDir(dir);
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=listing.js.map