@deskwork/core 0.15.0 → 0.17.0

package/dist/scrapbook/listing.js.map

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

package/dist/scrapbook/paths.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Scrapbook path resolvers.
+ *
+ * Public surface (entry-aware family — refactor-proof):
+ *   - `scrapbookDirAtPath(projectRoot, config, site, relPath)` — resolve
+ *     a scrapbook dir for an arbitrary fs-relative path under the site's
+ *     content directory.
+ *   - `scrapbookDirForEntry(projectRoot, config, site, entry, index)` —
+ *     the canonical resolver. Looks up the entry's bound file via the
+ *     content index when the entry has an id; falls back to the private
+ *     slug-template path internally for legacy / pre-sidecar entries.
+ *   - `scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts)` — resolve
+ *     a filename inside an already-resolved scrapbook dir, with
+ *     traversal protection.
+ *
+ * Private (internal — no longer exported from `@deskwork/core/scrapbook`):
+ *   - `_scrapbookDirSlug(projectRoot, config, site, slug)` — resolve a
+ *     scrapbook dir by slug-template addressing
+ *     (`<contentDir>/<slug>/scrapbook`). Used as the fallback inside
+ *     `scrapbookDirForEntry` when an entry has no id binding yet, and
+ *     by other internal helpers in the scrapbook module family that
+ *     accept a slug. The legacy public name `scrapbookDir` was removed
+ *     in #192 because it gave callers a way to write to the wrong path
+ *     for entries whose on-disk file diverges from the slug template.
+ *   - `_scrapbookFilePathSlug(projectRoot, config, site, slug, filename, opts)`
+ *     — resolve a filename via the slug-template path. Used internally
+ *     by the legacy slug-keyed read helpers (`readScrapbookFile`,
+ *     `listScrapbook`, `countScrapbook`).
+ *
+ * The private helpers are not re-exported from the barrel
+ * (`packages/core/src/scrapbook.ts`) and are not in
+ * `package.json#exports["./scrapbook"]`. External callers must go
+ * through `scrapbookDirForEntry` (entry-aware) or `scrapbookDirAtPath`
+ * (path-aware).
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { ContentIndex } from '../content-index.ts';
+import { type ScrapbookLocation } from './types.ts';
+/**
+ * INTERNAL — slug-template scrapbook dir resolver.
+ *
+ * Resolves to `<contentDir>/<slug>/scrapbook`. Used as the fallback
+ * inside `scrapbookDirForEntry` when an entry has no id binding yet,
+ * and by the legacy slug-keyed read helpers
+ * (`readScrapbookFile`, `listScrapbook`, `countScrapbook`).
+ *
+ * NOT exported publicly post-#192 — see file-level docstring.
+ */
+export declare function _scrapbookDirSlug(projectRoot: string, config: DeskworkConfig, site: string, slug: string): string;
+/**
+ * INTERNAL — slug-template scrapbook file path.
+ *
+ * NOT exported publicly post-#192. Mirrors `scrapbookFilePathAtDir`
+ * but takes a slug instead of a pre-resolved dir.
+ */
+export declare function _scrapbookFilePathSlug(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, opts?: ScrapbookLocation): string;
+/**
+ * Resolve the scrapbook directory for an arbitrary path under the site's
+ * content directory. Used by Phase 19c+ callers (e.g. the studio) that
+ * already know the fs-relative path of an organizational or tracked node
+ * and don't want to re-derive it through the slug regex. The path may
+ * contain `/` segments; no `..` or absolute paths allowed.
+ *
+ * Path-shape validation matches `assertSlug` since the on-disk layout
+ * is the same shape — kebab-case segments separated by `/`. Different
+ * helper, same constraint.
+ */
+export declare function scrapbookDirAtPath(projectRoot: string, config: DeskworkConfig, site: string, relPath: string): string;
+/**
+ * Resolve the scrapbook directory for a tracked calendar entry.
+ *
+ * This is the canonical public scrapbook-dir resolver post-#192. Callers
+ * that previously reached for `scrapbookDir(slug)` go through this
+ * helper instead — pass `{ slug }` (id optional) and the resolver will
+ * still walk the right path.
+ *
+ * Derives the scrapbook location from the parent directory of the
+ * entry's content file (located via `findEntryFile`, which prefers the
+ * frontmatter-id index over the slug template). Falls back to the
+ * private slug-template helper (`_scrapbookDirSlug`) for entries that
+ * haven't been bound to frontmatter yet (pre-doctor state) — the
+ * fallback is internal and the operator never sees a different code
+ * path.
+ *
+ * Refactor-proof: when the operator renames an entry's directory on
+ * disk, the next request rebuilds the index and the scrapbook now
+ * lives at the new path automatically.
+ *
+ * @param entry Calendar entry — `id` preferred (Phase 19+); `slug` is
+ *              used both as the legacy fallback and to locate the
+ *              `<dirname>/scrapbook/` when the entry has no id yet.
+ * @param index Optional pre-built index (per-request memoization). When
+ *              omitted, this function builds one.
+ */
+export declare function scrapbookDirForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
+    id?: string;
+    slug: string;
+}, index?: ContentIndex): 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).
+ *
+ * Security guards:
+ *   - `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;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/scrapbook/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMnE;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,MAAM,CAMR;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,MAAM,CAIR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAClC,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,CAoBR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,MAAM,CAUR"}

package/dist/scrapbook/paths.js

@@ -0,0 +1,149 @@
+/**
+ * Scrapbook path resolvers.
+ *
+ * Public surface (entry-aware family — refactor-proof):
+ *   - `scrapbookDirAtPath(projectRoot, config, site, relPath)` — resolve
+ *     a scrapbook dir for an arbitrary fs-relative path under the site's
+ *     content directory.
+ *   - `scrapbookDirForEntry(projectRoot, config, site, entry, index)` —
+ *     the canonical resolver. Looks up the entry's bound file via the
+ *     content index when the entry has an id; falls back to the private
+ *     slug-template path internally for legacy / pre-sidecar entries.
+ *   - `scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts)` — resolve
+ *     a filename inside an already-resolved scrapbook dir, with
+ *     traversal protection.
+ *
+ * Private (internal — no longer exported from `@deskwork/core/scrapbook`):
+ *   - `_scrapbookDirSlug(projectRoot, config, site, slug)` — resolve a
+ *     scrapbook dir by slug-template addressing
+ *     (`<contentDir>/<slug>/scrapbook`). Used as the fallback inside
+ *     `scrapbookDirForEntry` when an entry has no id binding yet, and
+ *     by other internal helpers in the scrapbook module family that
+ *     accept a slug. The legacy public name `scrapbookDir` was removed
+ *     in #192 because it gave callers a way to write to the wrong path
+ *     for entries whose on-disk file diverges from the slug template.
+ *   - `_scrapbookFilePathSlug(projectRoot, config, site, slug, filename, opts)`
+ *     — resolve a filename via the slug-template path. Used internally
+ *     by the legacy slug-keyed read helpers (`readScrapbookFile`,
+ *     `listScrapbook`, `countScrapbook`).
+ *
+ * The private helpers are not re-exported from the barrel
+ * (`packages/core/src/scrapbook.ts`) and are not in
+ * `package.json#exports["./scrapbook"]`. External callers must go
+ * through `scrapbookDirForEntry` (entry-aware) or `scrapbookDirAtPath`
+ * (path-aware).
+ */
+import { dirname, join, resolve } from 'node:path';
+import { findEntryFile, resolveBlogPostDir, resolveContentDir, } from "../paths.js";
+import { assertFilename, assertSlug } from "./validation.js";
+import { SECRET_SUBDIR } from "./types.js";
+// ---------------------------------------------------------------------------
+// Private — slug-template (used as fallback inside the entry-aware family)
+// ---------------------------------------------------------------------------
+/**
+ * INTERNAL — slug-template scrapbook dir resolver.
+ *
+ * Resolves to `<contentDir>/<slug>/scrapbook`. Used as the fallback
+ * inside `scrapbookDirForEntry` when an entry has no id binding yet,
+ * and by the legacy slug-keyed read helpers
+ * (`readScrapbookFile`, `listScrapbook`, `countScrapbook`).
+ *
+ * NOT exported publicly post-#192 — see file-level docstring.
+ */
+export function _scrapbookDirSlug(projectRoot, config, site, slug) {
+    assertSlug(slug);
+    const articleDir = resolveBlogPostDir(projectRoot, config, site, slug);
+    return join(articleDir, 'scrapbook');
+}
+/**
+ * INTERNAL — slug-template scrapbook file path.
+ *
+ * NOT exported publicly post-#192. Mirrors `scrapbookFilePathAtDir`
+ * but takes a slug instead of a pre-resolved dir.
+ */
+export function _scrapbookFilePathSlug(projectRoot, config, site, slug, filename, opts = {}) {
+    return scrapbookFilePathAtDir(_scrapbookDirSlug(projectRoot, config, site, slug), filename, opts);
+}
+// ---------------------------------------------------------------------------
+// Public — path-driven + entry-aware resolvers
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the scrapbook directory for an arbitrary path under the site's
+ * content directory. Used by Phase 19c+ callers (e.g. the studio) that
+ * already know the fs-relative path of an organizational or tracked node
+ * and don't want to re-derive it through the slug regex. The path may
+ * contain `/` segments; no `..` or absolute paths allowed.
+ *
+ * Path-shape validation matches `assertSlug` since the on-disk layout
+ * is the same shape — kebab-case segments separated by `/`. Different
+ * helper, same constraint.
+ */
+export function scrapbookDirAtPath(projectRoot, config, site, relPath) {
+    assertSlug(relPath);
+    const articleDir = join(resolveContentDir(projectRoot, config, site), relPath);
+    return join(articleDir, 'scrapbook');
+}
+/**
+ * Resolve the scrapbook directory for a tracked calendar entry.
+ *
+ * This is the canonical public scrapbook-dir resolver post-#192. Callers
+ * that previously reached for `scrapbookDir(slug)` go through this
+ * helper instead — pass `{ slug }` (id optional) and the resolver will
+ * still walk the right path.
+ *
+ * Derives the scrapbook location from the parent directory of the
+ * entry's content file (located via `findEntryFile`, which prefers the
+ * frontmatter-id index over the slug template). Falls back to the
+ * private slug-template helper (`_scrapbookDirSlug`) for entries that
+ * haven't been bound to frontmatter yet (pre-doctor state) — the
+ * fallback is internal and the operator never sees a different code
+ * path.
+ *
+ * Refactor-proof: when the operator renames an entry's directory on
+ * disk, the next request rebuilds the index and the scrapbook now
+ * lives at the new path automatically.
+ *
+ * @param entry Calendar entry — `id` preferred (Phase 19+); `slug` is
+ *              used both as the legacy fallback and to locate the
+ *              `<dirname>/scrapbook/` when the entry has no id yet.
+ * @param index Optional pre-built index (per-request memoization). When
+ *              omitted, this function builds one.
+ */
+export function scrapbookDirForEntry(projectRoot, config, site, entry, index) {
+    const entryId = entry.id ?? '';
+    const file = findEntryFile(projectRoot, config, site, entryId, index, 
+    // Legacy fallback ON — we want a usable path even for pre-doctor entries.
+    { slug: entry.slug });
+    if (file === undefined) {
+        // No id binding AND no template fallback resolved (template should
+        // always resolve since it's just slug substitution; this branch is
+        // defensive for empty slugs / future template variants).
+        throw new Error(`Cannot resolve scrapbook dir: entry has no id binding and no template fallback (slug="${entry.slug}")`);
+    }
+    return join(dirname(file), 'scrapbook');
+}
+/**
+ * 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).
+ *
+ * Security guards:
+ *   - `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 function scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts = {}) {
+    assertFilename(filename);
+    const target = opts.secret ? join(scrapbookDirAbs, SECRET_SUBDIR) : scrapbookDirAbs;
+    const abs = resolve(target, filename);
+    if (!abs.startsWith(scrapbookDirAbs + '/') && abs !== scrapbookDirAbs) {
+        throw new Error(`resolved path escapes scrapbook dir: "${filename}" → ${abs}`);
+    }
+    return abs;
+}
+//# sourceMappingURL=paths.js.map

package/dist/scrapbook/paths.js.map

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

package/dist/scrapbook/read.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Read primitives — return file metadata + content as a Buffer.
+ *
+ * Three addressing modes match the listing/path module:
+ *   - `readScrapbookFile` — slug-template (legacy public; uses the
+ *     private `_scrapbookDirSlug` internally).
+ *   - `readScrapbookFileAtDir` — already-resolved scrapbook dir.
+ *   - `readScrapbookFileForEntry` — entry-aware via
+ *     `scrapbookDirForEntry`; the binary endpoint
+ *     `/api/dev/scrapbook-file?entryId=...` uses this so projects whose
+ *     feature-doc layout doesn't match the kebab-case slug template
+ *     can still serve scrapbook assets.
+ *
+ * Same security guards as the writes via `scrapbookFilePathAtDir`.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { ContentIndex } from '../content-index.ts';
+import type { ScrapbookItemKind, ScrapbookLocation } from './types.ts';
+interface ReadResult {
+    name: string;
+    kind: ScrapbookItemKind;
+    size: number;
+    mtime: string;
+    content: Buffer;
+}
+export declare function readScrapbookFile(projectRoot: string, config: DeskworkConfig, site: string, slug: string, filename: string, opts?: ScrapbookLocation): ReadResult;
+/**
+ * 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): ReadResult;
+/**
+ * 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.
+ */
+export declare function readScrapbookFileForEntry(projectRoot: string, config: DeskworkConfig, site: string, entry: {
+    id?: string;
+    slug: string;
+}, filename: string, opts?: ScrapbookLocation, index?: ContentIndex): ReadResult;
+export {};
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/scrapbook/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEvE,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,UAAU,CAMZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,GAC3B,UAAU,CAaZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,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,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,iBAAsB,EAC5B,KAAK,CAAC,EAAE,YAAY,GACnB,UAAU,CAMZ"}

package/dist/scrapbook/read.js

@@ -0,0 +1,62 @@
+/**
+ * Read primitives — return file metadata + content as a Buffer.
+ *
+ * Three addressing modes match the listing/path module:
+ *   - `readScrapbookFile` — slug-template (legacy public; uses the
+ *     private `_scrapbookDirSlug` internally).
+ *   - `readScrapbookFileAtDir` — already-resolved scrapbook dir.
+ *   - `readScrapbookFileForEntry` — entry-aware via
+ *     `scrapbookDirForEntry`; the binary endpoint
+ *     `/api/dev/scrapbook-file?entryId=...` uses this so projects whose
+ *     feature-doc layout doesn't match the kebab-case slug template
+ *     can still serve scrapbook assets.
+ *
+ * Same security guards as the writes via `scrapbookFilePathAtDir`.
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { _scrapbookDirSlug, scrapbookDirForEntry, scrapbookFilePathAtDir, } from "./paths.js";
+import { classify } from "./validation.js";
+export function readScrapbookFile(projectRoot, config, site, slug, filename, opts = {}) {
+    return readScrapbookFileAtDir(_scrapbookDirSlug(projectRoot, config, site, slug), filename, opts);
+}
+/**
+ * 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 function readScrapbookFileAtDir(scrapbookDirAbs, filename, opts = {}) {
+    const abs = scrapbookFilePathAtDir(scrapbookDirAbs, filename, opts);
+    if (!existsSync(abs))
+        throw new Error(`not found: ${filename}`);
+    const st = statSync(abs);
+    if (!st.isFile())
+        throw new Error(`not a file: ${filename}`);
+    const content = readFileSync(abs);
+    return {
+        name: filename,
+        kind: classify(filename),
+        size: st.size,
+        mtime: st.mtime.toISOString(),
+        content,
+    };
+}
+/**
+ * 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.
+ */
+export function readScrapbookFileForEntry(projectRoot, config, site, entry, filename, opts = {}, index) {
+    return readScrapbookFileAtDir(scrapbookDirForEntry(projectRoot, config, site, entry, index), filename, opts);
+}
+//# sourceMappingURL=read.js.map

package/dist/scrapbook/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/scrapbook/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG7D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAW3C,MAAM,UAAU,iBAAiB,CAC/B,WAAmB,EACnB,MAAsB,EACtB,IAAY,EACZ,IAAY,EACZ,QAAgB,EAChB,OAA0B,EAAE;IAE5B,OAAO,sBAAsB,CAC3B,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,EAClD,QAAQ,EACR,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,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,cAAc,QAAQ,EAAE,CAAC,CAAC;IAChE,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAClC,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;QAC7B,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAmB,EACnB,MAAsB,EACtB,IAAY,EACZ,KAAoC,EACpC,QAAgB,EAChB,OAA0B,EAAE,EAC5B,KAAoB;IAEpB,OAAO,sBAAsB,CAC3B,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAC7D,QAAQ,EACR,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/scrapbook/seed.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Scrapbook seed helpers — scaffolding written at plan time so every
+ * Planned article gets a scrapbook home with a templated README.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { ScrapbookItem } from './types.ts';
+/**
+ * Seed a scrapbook's `README.md` at plan time. Idempotent — if the
+ * README already exists, returns null without touching it. Used by
+ * the plan skill so every Planned article gets a scrapbook home with
+ * a template that names the article and invites receipts.
+ *
+ * Slug-keyed because plan-time callers operate against a freshly-
+ * minted calendar entry whose on-disk file may not yet exist; the
+ * slug-template path is the only stable address available at that
+ * stage. Routes through the private slug-template helpers internally.
+ */
+export declare function seedScrapbookReadme(projectRoot: string, config: DeskworkConfig, site: string, slug: string, title: string): ScrapbookItem | null;
+//# sourceMappingURL=seed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/scrapbook/seed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,aAAa,GAAG,IAAI,CAgCtB"}

package/dist/scrapbook/seed.js

@@ -0,0 +1,46 @@
+/**
+ * Scrapbook seed helpers — scaffolding written at plan time so every
+ * Planned article gets a scrapbook home with a templated README.
+ */
+import { existsSync } from 'node:fs';
+import { _createScrapbookMarkdownSlug } from "./crud-slug.js";
+import { _scrapbookFilePathSlug } from "./paths.js";
+/**
+ * Seed a scrapbook's `README.md` at plan time. Idempotent — if the
+ * README already exists, returns null without touching it. Used by
+ * the plan skill so every Planned article gets a scrapbook home with
+ * a template that names the article and invites receipts.
+ *
+ * Slug-keyed because plan-time callers operate against a freshly-
+ * minted calendar entry whose on-disk file may not yet exist; the
+ * slug-template path is the only stable address available at that
+ * stage. Routes through the private slug-template helpers internally.
+ */
+export function seedScrapbookReadme(projectRoot, config, site, slug, title) {
+    const abs = _scrapbookFilePathSlug(projectRoot, config, site, slug, 'README.md');
+    if (existsSync(abs))
+        return null;
+    const now = new Date().toISOString().slice(0, 10);
+    const body = [
+        `# Scrapbook — ${title}`,
+        '',
+        `Planned ${now}. Working notes, research, receipts, and references`,
+        `for the \`${slug}\` dispatch. Committed to git alongside the article;`,
+        'not baked to the public site.',
+        '',
+        '## Receipts',
+        '',
+        '- ',
+        '',
+        '## Notes',
+        '',
+        '- ',
+        '',
+        '## References',
+        '',
+        '- ',
+        '',
+    ].join('\n');
+    return _createScrapbookMarkdownSlug(projectRoot, config, site, slug, 'README.md', body);
+}
+//# sourceMappingURL=seed.js.map

package/dist/scrapbook/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/scrapbook/seed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,MAAsB,EACtB,IAAY,EACZ,IAAY,EACZ,KAAa;IAEb,MAAM,GAAG,GAAG,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACjF,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG;QACX,iBAAiB,KAAK,EAAE;QACxB,EAAE;QACF,WAAW,GAAG,qDAAqD;QACnE,aAAa,IAAI,sDAAsD;QACvE,+BAA+B;QAC/B,EAAE;QACF,aAAa;QACb,EAAE;QACF,IAAI;QACJ,EAAE;QACF,UAAU;QACV,EAAE;QACF,IAAI;QACJ,EAAE;QACF,eAAe;QACf,EAAE;QACF,IAAI;QACJ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,4BAA4B,CACjC,WAAW,EACX,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/scrapbook/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Scrapbook public types — value-level shapes shared by every helper in
+ * the scrapbook module family.
+ *
+ * Split out of the legacy monolithic `scrapbook.ts` per #202 (file-size
+ * cap) so callers can import just the type surface without pulling in
+ * the fs-touching primitives.
+ */
+/** Type buckets for scrapbook entries — keyed by extension via `classify`. */
+export type ScrapbookItemKind = 'md' | 'json' | 'js' | 'img' | 'txt' | 'other';
+export interface ScrapbookItem {
+    name: string;
+    kind: ScrapbookItemKind;
+    size: number;
+    mtime: string;
+}
+export interface ScrapbookSummary {
+    site: string;
+    /**
+     * The scrapbook's location identifier — a slug for entries tied to a
+     * calendar row, or any directory path within `contentDir` for
+     * scrapbooks that hang off purely organizational nodes (e.g. an
+     * intermediate project directory that isn't itself a calendar entry).
+     */
+    slug: string;
+    dir: string;
+    exists: boolean;
+    /** Files at the top of `scrapbook/` (public/published-side notes). */
+    items: ScrapbookItem[];
+    /**
+     * Files inside `scrapbook/secret/` — never to be published. Operators
+     * can drop research, drafts, or sensitive notes here knowing the host
+     * project's content collection patterns won't pick them up.
+     */
+    secretItems: ScrapbookItem[];
+}
+/** Options that select between the public scrapbook root and `secret/`. */
+export interface ScrapbookLocation {
+    /** When true, the file lives under `scrapbook/secret/`. Default: false. */
+    secret?: boolean;
+}
+/** Well-known subdirectory name for editorially-private scrapbook items. */
+export declare const SECRET_SUBDIR = "secret";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scrapbook/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,MAAM,GACN,IAAI,GACJ,KAAK,GACL,KAAK,GACL,OAAO,CAAC;AAEZ,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB;;;;OAIG;IACH,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,4EAA4E;AAC5E,eAAO,MAAM,aAAa,WAAW,CAAC"}

package/dist/scrapbook/types.js

@@ -0,0 +1,11 @@
+/**
+ * Scrapbook public types — value-level shapes shared by every helper in
+ * the scrapbook module family.
+ *
+ * Split out of the legacy monolithic `scrapbook.ts` per #202 (file-size
+ * cap) so callers can import just the type surface without pulling in
+ * the fs-touching primitives.
+ */
+/** Well-known subdirectory name for editorially-private scrapbook items. */
+export const SECRET_SUBDIR = 'secret';
+//# sourceMappingURL=types.js.map

package/dist/scrapbook/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scrapbook/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6CH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC"}

package/dist/scrapbook/validation.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Scrapbook validation + classification helpers.
+ *
+ * Slug + filename validation runs at every fs entry point; a `..` or
+ * absolute path that slips through here would let a malicious request
+ * read or write outside the scrapbook tree. The route layer relies on
+ * these helpers for traversal protection.
+ */
+import type { ScrapbookItemKind } from './types.ts';
+/**
+ * A single slug segment — kebab-case lowercase. Used both for flat
+ * slugs and as the building block of hierarchical paths.
+ */
+declare const SLUG_SEGMENT_RE: RegExp;
+export declare function assertSlug(slug: string): void;
+/**
+ * Split a hierarchical slug into its segments. Each segment is a
+ * standalone kebab-case identifier.
+ */
+export declare function slugSegments(slug: string): string[];
+/**
+ * True if a slug refers to a nested entry (has at least one `/`).
+ */
+export declare function isNestedSlug(slug: string): boolean;
+export { SLUG_SEGMENT_RE };
+export declare function assertFilename(name: string): void;
+export declare function classify(filename: string): ScrapbookItemKind;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/scrapbook/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD;;;GAGG;AACH,QAAA,MAAM,eAAe,QAAyB,CAAC;AAW/C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAID,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBjD;AAMD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA6B5D"}