@deskwork/core 0.9.5

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,wEAAwE;AACxE,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,cAAc,CAAC;IAC/B,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAqBD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAwE1D;AA+ID,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAoB9D"}

package/dist/config.js

@@ -0,0 +1,216 @@
+/**
+ * deskwork plugin configuration.
+ *
+ * A host project is "installed" by writing a `.deskwork/config.json` at the
+ * project root. The config tells the plugin where content lives, where to
+ * keep the editorial calendar, and which sites the project hosts.
+ *
+ * The schema is intentionally minimal — one version, one set of required
+ * fields per site, no hidden defaults. `parseConfig` validates an unknown
+ * JSON value and returns a typed DeskworkConfig or throws an Error whose
+ * message tells the user which field is wrong.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Current config schema version. Bumped only with a migration path. */
+export const CONFIG_VERSION = 1;
+const ALLOWED_TOP_LEVEL_KEYS = new Set([
+    'version',
+    'sites',
+    'defaultSite',
+    'author',
+    'reviewJournalDir',
+]);
+const REQUIRED_SITE_KEYS = ['contentDir', 'calendarPath'];
+const ALLOWED_SITE_KEYS = new Set([
+    ...REQUIRED_SITE_KEYS,
+    'host',
+    'channelsPath',
+    'blogLayout',
+    'blogFilenameTemplate',
+    'blogInitialState',
+    'blogOutlineSection',
+    'redirectsPath',
+]);
+/** Return the absolute path to `.deskwork/config.json` under a project root. */
+export function configPath(projectRoot) {
+    return join(projectRoot, '.deskwork', 'config.json');
+}
+/**
+ * Validate and normalize an unknown value as a DeskworkConfig.
+ *
+ * Throws an Error with a specific message when the value doesn't match the
+ * schema. On success, returns a fresh typed object — callers can mutate it
+ * without worrying about shared references.
+ */
+export function parseConfig(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Invalid deskwork config: expected a JSON object, got ${describe(value)}.`);
+    }
+    const obj = value;
+    for (const key of Object.keys(obj)) {
+        if (!ALLOWED_TOP_LEVEL_KEYS.has(key)) {
+            throw new Error(`Invalid deskwork config: unknown key "${key}". ` +
+                `Allowed keys: ${[...ALLOWED_TOP_LEVEL_KEYS].join(', ')}.`);
+        }
+    }
+    if (obj.version !== CONFIG_VERSION) {
+        throw new Error(`Invalid deskwork config: expected version ${CONFIG_VERSION}, got ${JSON.stringify(obj.version)}. Run /deskwork:install to regenerate the config.`);
+    }
+    const sitesValue = obj.sites;
+    if (sitesValue === undefined ||
+        sitesValue === null ||
+        typeof sitesValue !== 'object' ||
+        Array.isArray(sitesValue)) {
+        throw new Error(`Invalid deskwork config: "sites" must be an object keyed by site slug.`);
+    }
+    const siteSlugs = Object.keys(sitesValue);
+    if (siteSlugs.length === 0) {
+        throw new Error(`Invalid deskwork config: at least one site must be defined under "sites".`);
+    }
+    const sites = {};
+    for (const slug of siteSlugs) {
+        sites[slug] = parseSiteConfig(slug, sitesValue[slug]);
+    }
+    const defaultSite = resolveDefaultSite(obj.defaultSite, siteSlugs);
+    const config = { version: CONFIG_VERSION, sites, defaultSite };
+    if (obj.author !== undefined) {
+        if (typeof obj.author !== 'string' || obj.author.length === 0) {
+            throw new Error(`Invalid deskwork config: "author" must be a non-empty string when set.`);
+        }
+        config.author = obj.author;
+    }
+    if (obj.reviewJournalDir !== undefined) {
+        if (typeof obj.reviewJournalDir !== 'string' ||
+            obj.reviewJournalDir.length === 0) {
+            throw new Error(`Invalid deskwork config: "reviewJournalDir" must be a non-empty string when set.`);
+        }
+        config.reviewJournalDir = obj.reviewJournalDir;
+    }
+    return config;
+}
+function parseSiteConfig(slug, value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Invalid deskwork config: site "${slug}" must be an object, got ${describe(value)}.`);
+    }
+    const obj = value;
+    for (const key of Object.keys(obj)) {
+        if (!ALLOWED_SITE_KEYS.has(key)) {
+            throw new Error(`Invalid deskwork config: site "${slug}" has unknown key "${key}". ` +
+                `Allowed keys: ${[...ALLOWED_SITE_KEYS].join(', ')}.`);
+        }
+    }
+    for (const key of REQUIRED_SITE_KEYS) {
+        const v = obj[key];
+        if (typeof v !== 'string' || v.length === 0) {
+            throw new Error(`Invalid deskwork config: site "${slug}" is missing required field "${key}" ` +
+                `(must be a non-empty string).`);
+        }
+    }
+    const site = {
+        contentDir: obj.contentDir,
+        calendarPath: obj.calendarPath,
+    };
+    if (obj.host !== undefined) {
+        if (typeof obj.host !== 'string' || obj.host.length === 0) {
+            throw new Error(`Invalid deskwork config: site "${slug}" has invalid "host" ` +
+                `(must be a non-empty string when set).`);
+        }
+        site.host = obj.host;
+    }
+    if (obj.channelsPath !== undefined) {
+        if (typeof obj.channelsPath !== 'string' || obj.channelsPath.length === 0) {
+            throw new Error(`Invalid deskwork config: site "${slug}" has invalid "channelsPath" ` +
+                `(must be a non-empty string when set).`);
+        }
+        site.channelsPath = obj.channelsPath;
+    }
+    if (obj.blogLayout !== undefined) {
+        if (typeof obj.blogLayout !== 'string' || obj.blogLayout.length === 0) {
+            throw new Error(`Invalid deskwork config: site "${slug}" has invalid "blogLayout" ` +
+                `(must be a non-empty string when set).`);
+        }
+        site.blogLayout = obj.blogLayout;
+    }
+    if (obj.blogFilenameTemplate !== undefined) {
+        if (typeof obj.blogFilenameTemplate !== 'string' ||
+            obj.blogFilenameTemplate.length === 0) {
+            throw new Error(`Invalid deskwork config: site "${slug}" has invalid ` +
+                `"blogFilenameTemplate" (must be a non-empty string when set).`);
+        }
+        if (!obj.blogFilenameTemplate.includes('{slug}')) {
+            throw new Error(`Invalid deskwork config: site "${slug}" blogFilenameTemplate ` +
+                `"${obj.blogFilenameTemplate}" must contain the "{slug}" placeholder.`);
+        }
+        site.blogFilenameTemplate = obj.blogFilenameTemplate;
+    }
+    if (obj.blogInitialState !== undefined) {
+        if (typeof obj.blogInitialState !== 'string' ||
+            obj.blogInitialState.length === 0) {
+            throw new Error(`Invalid deskwork config: site "${slug}" has invalid ` +
+                `"blogInitialState" (must be a non-empty string when set).`);
+        }
+        site.blogInitialState = obj.blogInitialState;
+    }
+    if (obj.blogOutlineSection !== undefined) {
+        if (typeof obj.blogOutlineSection !== 'boolean') {
+            throw new Error(`Invalid deskwork config: site "${slug}" has invalid ` +
+                `"blogOutlineSection" (must be a boolean when set).`);
+        }
+        site.blogOutlineSection = obj.blogOutlineSection;
+    }
+    if (obj.redirectsPath !== undefined) {
+        if (typeof obj.redirectsPath !== 'string' || obj.redirectsPath.length === 0) {
+            throw new Error(`Invalid deskwork config: site "${slug}" has invalid "redirectsPath" ` +
+                `(must be a non-empty string when set).`);
+        }
+        site.redirectsPath = obj.redirectsPath;
+    }
+    return site;
+}
+function resolveDefaultSite(value, siteSlugs) {
+    if (value === undefined || value === null) {
+        if (siteSlugs.length === 1)
+            return siteSlugs[0];
+        throw new Error(`Invalid deskwork config: "defaultSite" is required when more than one site is defined. ` +
+            `Configured sites: ${siteSlugs.join(', ')}.`);
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid deskwork config: "defaultSite" must be a string, got ${describe(value)}.`);
+    }
+    if (!siteSlugs.includes(value)) {
+        throw new Error(`Invalid deskwork config: defaultSite "${value}" is not a configured site. ` +
+            `Valid sites: ${siteSlugs.join(', ')}.`);
+    }
+    return value;
+}
+/** Read and parse the deskwork config for a project root. */
+export function readConfig(projectRoot) {
+    const path = configPath(projectRoot);
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf8');
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not read .deskwork/config.json at ${path}: ${reason}. ` +
+            `Run /deskwork:install to create one.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid JSON in ${path}: ${reason}`);
+    }
+    return parseConfig(parsed);
+}
+function describe(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/content-index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Content index — `{uuid → absolute path}` and `{relative path → uuid}`.
+ *
+ * Walks `<contentDir>/` for a configured site, parses every markdown file's
+ * YAML frontmatter, and records the file's `deskwork.id:` field when present
+ * and shaped like a UUID. The result drives id-based file lookups (Phase 19c)
+ * and `deskwork doctor`'s validation rules (Phase 19b).
+ *
+ * Namespace (Issue #38): the binding key lives under a `deskwork:`
+ * namespace in frontmatter (`deskwork.id`), NOT at the top level. Older
+ * v0.7.0/v0.7.1 files with a top-level `id:` are NOT picked up here —
+ * the `legacy-top-level-id-migration` doctor rule surfaces and migrates
+ * those.
+ *
+ * Design notes:
+ * - Pure function: each call walks fresh. Callers that want memoization
+ *   wrap (the studio memoizes per HTTP request; doctor memoizes per run).
+ *   Building the index here means not maintaining a stale-cache invariant.
+ * - Files with no `deskwork.id:` are simply omitted — that's the
+ *   legitimate pre-bind state. `doctor` reports them via the calendar
+ *   join, not by treating "no id" as an error here.
+ * - Files with a malformed `deskwork.id:` go into `invalid` so `doctor`
+ *   can surface them; they don't pollute `byId` / `byPath`.
+ * - On duplicate ids across files, the first encountered (in sorted
+ *   directory walk order) wins `byId`; the second is silently dropped
+ *   from `byId` but its path still appears in `byPath`. The
+ *   `duplicate-id` doctor rule is a separate concern and reads files
+ *   directly when reporting.
+ *
+ * Sibling-relative imports per the project convention — `@/` doesn't
+ * resolve under tsx at runtime in this package's `src/`, only in tests.
+ */
+import type { DeskworkConfig } from './config.ts';
+/** A markdown file whose frontmatter `id:` couldn't be used as an index key. */
+export interface InvalidIndexEntry {
+    /** Absolute path to the offending file. */
+    absolutePath: string;
+    /** Why the file was rejected — surfaced verbatim by doctor. */
+    reason: string;
+}
+/** Result of scanning a site's content directory for id ↔ path bindings. */
+export interface ContentIndex {
+    /**
+     * uuid → absolute path. Maps an entry's id to the file claiming it via
+     * frontmatter `id:`. Studio request-lifecycle and doctor read this to
+     * resolve a calendar entry to its file regardless of slug or path.
+     */
+    byId: Map<string, string>;
+    /**
+     * Relative path (under contentDir) → uuid. Reverse lookup for code
+     * driven by a filesystem walk that needs the entry id for a given
+     * file. Both maps are kept in sync — every byId mapping has a
+     * matching byPath mapping pointing back at the same uuid.
+     */
+    byPath: Map<string, string>;
+    /**
+     * Files that have an `id:` frontmatter but the value isn't a valid
+     * UUID v4-shape. Reported by doctor. Files without any `id:` field
+     * are NOT reported here — they're just absent from the index, which
+     * is the legitimate pre-bind state.
+     */
+    invalid: InvalidIndexEntry[];
+}
+/**
+ * Build a content index for one site. Walks `<contentDir>/`, parses
+ * every markdown file's frontmatter, and binds `id ↔ path` where the
+ * frontmatter declares a valid UUID.
+ *
+ * Returns empty maps when `<contentDir>` doesn't exist (e.g. a freshly
+ * configured site with nothing on disk yet) — the caller can still
+ * proceed; doctor will report calendar entries with no matching files.
+ */
+export declare function buildContentIndex(projectRoot: string, config: DeskworkConfig, site: string): ContentIndex;
+//# sourceMappingURL=content-index.d.ts.map

package/dist/content-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-index.d.ts","sourceRoot":"","sources":["../src/content-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B;;;;;OAKG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAgJD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,YAAY,CAiCd"}

package/dist/content-index.js

@@ -0,0 +1,205 @@
+/**
+ * Content index — `{uuid → absolute path}` and `{relative path → uuid}`.
+ *
+ * Walks `<contentDir>/` for a configured site, parses every markdown file's
+ * YAML frontmatter, and records the file's `deskwork.id:` field when present
+ * and shaped like a UUID. The result drives id-based file lookups (Phase 19c)
+ * and `deskwork doctor`'s validation rules (Phase 19b).
+ *
+ * Namespace (Issue #38): the binding key lives under a `deskwork:`
+ * namespace in frontmatter (`deskwork.id`), NOT at the top level. Older
+ * v0.7.0/v0.7.1 files with a top-level `id:` are NOT picked up here —
+ * the `legacy-top-level-id-migration` doctor rule surfaces and migrates
+ * those.
+ *
+ * Design notes:
+ * - Pure function: each call walks fresh. Callers that want memoization
+ *   wrap (the studio memoizes per HTTP request; doctor memoizes per run).
+ *   Building the index here means not maintaining a stale-cache invariant.
+ * - Files with no `deskwork.id:` are simply omitted — that's the
+ *   legitimate pre-bind state. `doctor` reports them via the calendar
+ *   join, not by treating "no id" as an error here.
+ * - Files with a malformed `deskwork.id:` go into `invalid` so `doctor`
+ *   can surface them; they don't pollute `byId` / `byPath`.
+ * - On duplicate ids across files, the first encountered (in sorted
+ *   directory walk order) wins `byId`; the second is silently dropped
+ *   from `byId` but its path still appears in `byPath`. The
+ *   `duplicate-id` doctor rule is a separate concern and reads files
+ *   directly when reporting.
+ *
+ * Sibling-relative imports per the project convention — `@/` doesn't
+ * resolve under tsx at runtime in this package's `src/`, only in tests.
+ */
+import { readdirSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { resolveContentDir } from "./paths.js";
+import { readFrontmatter } from "./frontmatter.js";
+/** Directory names skipped by the walk. Matched case-insensitively on the leaf. */
+const SKIP_DIRS = new Set([
+    'scrapbook',
+    'node_modules',
+    'dist',
+    '.git',
+]);
+/** Markdown extensions recognized by the walker. */
+const MARKDOWN_EXTENSIONS = new Set([
+    '.md',
+    '.mdx',
+    '.markdown',
+]);
+/**
+ * UUID v4 shape check — 36 chars, lowercase or uppercase hex, hyphens
+ * at positions 8/13/18/23. Permissive on the variant nibbles to
+ * accommodate v4-but-non-canonical values that the rest of the system
+ * already accepts (the parser auto-backfill uses `randomUUID()` which
+ * IS canonical, but we shouldn't reject id values that round-tripped
+ * through other tooling).
+ */
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUuid(value) {
+    return UUID_RE.test(value);
+}
+/** Lowercased extension of a filename, including the leading dot. */
+function extensionOf(name) {
+    const idx = name.lastIndexOf('.');
+    if (idx < 0)
+        return '';
+    return name.slice(idx).toLowerCase();
+}
+/** True when this directory entry name should be skipped during the walk. */
+function shouldSkipDir(name) {
+    if (name.startsWith('.'))
+        return true;
+    return SKIP_DIRS.has(name.toLowerCase());
+}
+/**
+ * Recursively collect markdown file paths under `dir`. Returns a sorted
+ * list (by absolute path) so the walk is deterministic — same input
+ * tree always produces the same maps regardless of OS-level readdir
+ * order.
+ */
+function collectMarkdownFiles(dir) {
+    const out = [];
+    visit(dir);
+    out.sort();
+    return out;
+    function visit(currentDir) {
+        let names;
+        try {
+            names = readdirSync(currentDir);
+        }
+        catch {
+            return;
+        }
+        for (const name of names) {
+            const abs = join(currentDir, name);
+            let st;
+            try {
+                st = statSync(abs);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (shouldSkipDir(name))
+                    continue;
+                visit(abs);
+                continue;
+            }
+            if (!st.isFile())
+                continue;
+            if (MARKDOWN_EXTENSIONS.has(extensionOf(name))) {
+                out.push(abs);
+            }
+        }
+    }
+}
+function readIdFromFrontmatter(absPath) {
+    let parsed;
+    try {
+        parsed = readFrontmatter(absPath);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return { kind: 'invalid', reason: `unreadable frontmatter: ${reason}` };
+    }
+    // Issue #38: read `deskwork.id` only — top-level `id:` belongs to the
+    // operator, not to deskwork. Files with only a top-level id are
+    // surfaced separately by the legacy-top-level-id-migration doctor rule.
+    const deskworkBlock = parsed.data.deskwork;
+    if (deskworkBlock === undefined || deskworkBlock === null) {
+        return { kind: 'absent' };
+    }
+    if (typeof deskworkBlock !== 'object' || Array.isArray(deskworkBlock)) {
+        return {
+            kind: 'invalid',
+            reason: `frontmatter deskwork is ${typeof deskworkBlock}, expected mapping`,
+        };
+    }
+    const raw = deskworkBlock.id;
+    if (raw === undefined)
+        return { kind: 'absent' };
+    if (typeof raw !== 'string') {
+        return {
+            kind: 'invalid',
+            reason: `frontmatter deskwork.id is ${typeof raw}, expected string`,
+        };
+    }
+    const trimmed = raw.trim();
+    if (trimmed === '') {
+        return {
+            kind: 'invalid',
+            reason: 'frontmatter deskwork.id is empty',
+        };
+    }
+    if (!isUuid(trimmed)) {
+        return {
+            kind: 'invalid',
+            reason: `frontmatter deskwork.id "${trimmed}" is not a valid UUID`,
+        };
+    }
+    return { kind: 'valid', id: trimmed };
+}
+/**
+ * Build a content index for one site. Walks `<contentDir>/`, parses
+ * every markdown file's frontmatter, and binds `id ↔ path` where the
+ * frontmatter declares a valid UUID.
+ *
+ * Returns empty maps when `<contentDir>` doesn't exist (e.g. a freshly
+ * configured site with nothing on disk yet) — the caller can still
+ * proceed; doctor will report calendar entries with no matching files.
+ */
+export function buildContentIndex(projectRoot, config, site) {
+    const contentDir = resolveContentDir(projectRoot, config, site);
+    const byId = new Map();
+    const byPath = new Map();
+    const invalid = [];
+    let files;
+    try {
+        files = collectMarkdownFiles(contentDir);
+    }
+    catch {
+        return { byId, byPath, invalid };
+    }
+    for (const abs of files) {
+        const lookup = readIdFromFrontmatter(abs);
+        if (lookup.kind === 'absent')
+            continue;
+        if (lookup.kind === 'invalid') {
+            invalid.push({ absolutePath: abs, reason: lookup.reason });
+            continue;
+        }
+        const rel = relative(contentDir, abs);
+        // First-encountered wins for byId on duplicates. Sorted walk above
+        // gives deterministic "first" — same fixture tree always picks the
+        // same file. byPath records every path so a later fs-walk-driven
+        // caller can still resolve uuid by path even when the duplicate
+        // is the colliding entry.
+        if (!byId.has(lookup.id)) {
+            byId.set(lookup.id, abs);
+        }
+        byPath.set(rel, lookup.id);
+    }
+    return { byId, byPath, invalid };
+}
+//# sourceMappingURL=content-index.js.map

package/dist/content-index.js.map

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

package/dist/content-tree-fs-walk.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Content-tree filesystem walk — pure recursive directory scan.
+ *
+ * Extracted from `content-tree.ts` (Phase 19c) to keep that file under
+ * the project's 500-line guideline. The walk is read-only and produces
+ * one `FsWalkEntry` per directory beneath `<contentDir>` — the input
+ * to the tree assembly's fs-primary inversion.
+ *
+ * No knowledge of the calendar or content index lives here.
+ */
+import type { DeskworkConfig } from './config.ts';
+/**
+ * One row of the filesystem walk: a directory found under contentDir,
+ * plus the on-disk markers (README / index) used to decide whether
+ * it's a candidate organizational node.
+ */
+export interface FsWalkEntry {
+    /**
+     * Fs-relative path from contentDir (e.g. `the-outbound/characters`).
+     * Field name retained as `slug` for backward-compat with existing
+     * test fixtures and external callers; semantically it is now an
+     * "fs path" — kebab-case segments separated by `/`.
+     */
+    slug: string;
+    /** True when the directory has an `index.md` / `index.mdx` file. */
+    hasIndex: boolean;
+    /**
+     * True when the directory has a `README.md` / `README.mdx` file.
+     * Used to surface organizational nodes that aren't part of the
+     * calendar's tracked set.
+     */
+    hasReadme: boolean;
+    /** Title from the README/index frontmatter `title` field, when present. */
+    title: string | null;
+}
+/** Match the index/README basenames the studio recognizes as a node marker. */
+export declare const INDEX_BASENAMES: ReadonlySet<string>;
+/**
+ * Index file basenames the host's default template (`<path>/index.md`)
+ * recognises. Used to decide `hasOwnIndex` for tracked entries when the
+ * content index doesn't bind them to a specific file (pre-doctor state).
+ */
+export declare const TEMPLATE_INDEX_BASENAMES: readonly string[];
+/**
+ * Default filesystem walk — recursively scan a site's contentDir for
+ * directories. Returns one `FsWalkEntry` per directory beneath
+ * contentDir (not contentDir itself). Skips dotfiles and the
+ * conventional non-content names (`scrapbook`, `node_modules`, etc.).
+ *
+ * Per-directory the walk records whether an `index.md` / `README.md`
+ * is present and (when present) reads the frontmatter `title`.
+ */
+export declare function defaultFsWalk(projectRoot: string, config: DeskworkConfig, site: string): FsWalkEntry[];
+//# sourceMappingURL=content-tree-fs-walk.d.ts.map

package/dist/content-tree-fs-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tree-fs-walk.d.ts","sourceRoot":"","sources":["../src/content-tree-fs-walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAE9C,CAAC;AAKH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAIrD,CAAC;AAcF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,WAAW,EAAE,CAkDf"}