@deskwork/core 0.9.5

package/dist/content-tree-fs-walk.js

@@ -0,0 +1,112 @@
+/**
+ * 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 { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveContentDir } from "./paths.js";
+import { parseFrontmatter } from "./frontmatter.js";
+/** Match the index/README basenames the studio recognizes as a node marker. */
+export const INDEX_BASENAMES = new Set([
+    'index.md', 'index.mdx', 'index.markdown',
+]);
+const README_BASENAMES = new Set([
+    'readme.md', 'readme.mdx', 'readme.markdown',
+]);
+/**
+ * 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 const TEMPLATE_INDEX_BASENAMES = [
+    'index.md',
+    'index.mdx',
+    'index.markdown',
+];
+function readTitleFromMarkdown(absPath) {
+    try {
+        const raw = readFileSync(absPath, 'utf-8');
+        const parsed = parseFrontmatter(raw);
+        const t = parsed.data.title;
+        if (typeof t === 'string' && t.trim().length > 0)
+            return t.trim();
+    }
+    catch {
+        // Unreadable / unparseable — fall through.
+    }
+    return null;
+}
+/**
+ * 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 function defaultFsWalk(projectRoot, config, site) {
+    const root = resolveContentDir(projectRoot, config, site);
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    const SKIP = new Set(['scrapbook', 'node_modules', 'dist', '.git']);
+    const visit = (dirAbs, pathSoFar) => {
+        let names;
+        try {
+            names = readdirSync(dirAbs);
+        }
+        catch {
+            return;
+        }
+        let hasIndex = false;
+        let hasReadme = false;
+        let titleSource = null;
+        for (const name of names) {
+            const lower = name.toLowerCase();
+            if (INDEX_BASENAMES.has(lower)) {
+                hasIndex = true;
+                if (titleSource === null)
+                    titleSource = join(dirAbs, name);
+            }
+            else if (README_BASENAMES.has(lower)) {
+                hasReadme = true;
+                // Prefer index.md as the title source when both exist; only
+                // fall back to README when there is no index.
+                if (titleSource === null && !hasIndex)
+                    titleSource = join(dirAbs, name);
+            }
+        }
+        if (pathSoFar !== '') {
+            const title = titleSource ? readTitleFromMarkdown(titleSource) : null;
+            out.push({ slug: pathSoFar, hasIndex, hasReadme, title });
+        }
+        for (const name of names) {
+            if (name.startsWith('.'))
+                continue;
+            if (SKIP.has(name.toLowerCase()))
+                continue;
+            const childAbs = join(dirAbs, name);
+            let childStat;
+            try {
+                childStat = statSync(childAbs);
+            }
+            catch {
+                continue;
+            }
+            if (!childStat.isDirectory())
+                continue;
+            const childPath = pathSoFar === '' ? name : `${pathSoFar}/${name}`;
+            visit(childAbs, childPath);
+        }
+    };
+    visit(root, '');
+    return out;
+}
+//# sourceMappingURL=content-tree-fs-walk.js.map

package/dist/content-tree-fs-walk.js.map

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

package/dist/content-tree-helpers.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Internal helpers for `content-tree.ts`. Path-shape utilities, id-binding
+ * lookups, and the `hasOwnIndex` decision. Extracted to keep the main
+ * tree-assembly module under the project's 500-line guideline.
+ *
+ * No public API here — the tree builder re-exports what callers need.
+ */
+import type { CalendarEntry } from './types.ts';
+import type { ContentIndex } from './content-index.ts';
+/** Last segment of a `/`-separated path. */
+export declare function leafOfPath(path: string): string;
+/** Every prefix path of a `/`-separated path, excluding the path itself. */
+export declare function ancestorsOf(path: string): string[];
+/** First segment of a `/`-separated path. */
+export declare function rootSegment(path: string): string;
+/**
+ * Decide `hasOwnIndex` for a tracked entry.
+ *
+ * Order:
+ *   1. The content index binds the entry to a real file → `true`.
+ *   2. The fs walk found an index/README at this path → `true`.
+ *   3. A template-path file actually exists on disk → `true` (covers
+ *      the pre-bind case where the file is at `<path>/index.md` but
+ *      the walk didn't surface this directory because we synthesized
+ *      it from the calendar — should be rare post-19c).
+ *   4. Calendar-only entry (no fs node, no id binding): default to
+ *      `true` because the host renderer's template implies a file at
+ *      `<path>/index.md`. Pre-19c behavior for ghost entries.
+ */
+export declare function entryHasOwnIndex(contentDir: string, entryPath: string, fsHasIndex: boolean, fsHasReadme: boolean, boundFile: string | undefined, hasFsDir: boolean): boolean;
+/** Return the most-recent ISO mtime across two values, or null when both are null. */
+export declare function pickLatestMtime(a: string | null, b: string | null): string | null;
+/**
+ * If the relative path ends with a recognized index file basename
+ * (`index.md`, `index.mdx`, `index.markdown`), return the parent
+ * directory path. Otherwise return the path unchanged. Used to map
+ * `projects/the-outbound/index.md` (the file) → `projects/the-outbound`
+ * (the tree node).
+ *
+ * Files at flat paths (e.g. `my-flat-post.md`) keep their full path
+ * minus the extension as the node key. This matches today's
+ * audiocontrol shape where the slug is the basename.
+ */
+export declare function stripIndexBasename(relPath: string): string;
+/**
+ * Find the fs path that the content index binds to this entry's id, or
+ * null when the entry has no id or its id isn't in the index.
+ */
+export declare function findIdBoundPath(entry: CalendarEntry, index: ContentIndex): string | null;
+/** Absolute path to the file the index binds to this entry, or undefined. */
+export declare function idBoundFile(entry: CalendarEntry, index: ContentIndex): string | undefined;
+//# sourceMappingURL=content-tree-helpers.d.ts.map

package/dist/content-tree-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tree-helpers.d.ts","sourceRoot":"","sources":["../src/content-tree-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOlD;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,OAAO,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAYT;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,CAAC,EAAE,MAAM,GAAG,IAAI,EAChB,CAAC,EAAE,MAAM,GAAG,IAAI,GACf,MAAM,GAAG,IAAI,CAIf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,YAAY,GAClB,MAAM,GAAG,IAAI,CAQf;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,YAAY,GAClB,MAAM,GAAG,SAAS,CAGpB"}

package/dist/content-tree-helpers.js

@@ -0,0 +1,116 @@
+/**
+ * Internal helpers for `content-tree.ts`. Path-shape utilities, id-binding
+ * lookups, and the `hasOwnIndex` decision. Extracted to keep the main
+ * tree-assembly module under the project's 500-line guideline.
+ *
+ * No public API here — the tree builder re-exports what callers need.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { INDEX_BASENAMES, TEMPLATE_INDEX_BASENAMES, } from "./content-tree-fs-walk.js";
+/** Last segment of a `/`-separated path. */
+export function leafOfPath(path) {
+    const idx = path.lastIndexOf('/');
+    return idx < 0 ? path : path.slice(idx + 1);
+}
+/** Every prefix path of a `/`-separated path, excluding the path itself. */
+export function ancestorsOf(path) {
+    const segments = path.split('/');
+    const out = [];
+    for (let i = 1; i < segments.length; i++) {
+        out.push(segments.slice(0, i).join('/'));
+    }
+    return out;
+}
+/** First segment of a `/`-separated path. */
+export function rootSegment(path) {
+    const idx = path.indexOf('/');
+    return idx < 0 ? path : path.slice(0, idx);
+}
+/**
+ * Decide `hasOwnIndex` for a tracked entry.
+ *
+ * Order:
+ *   1. The content index binds the entry to a real file → `true`.
+ *   2. The fs walk found an index/README at this path → `true`.
+ *   3. A template-path file actually exists on disk → `true` (covers
+ *      the pre-bind case where the file is at `<path>/index.md` but
+ *      the walk didn't surface this directory because we synthesized
+ *      it from the calendar — should be rare post-19c).
+ *   4. Calendar-only entry (no fs node, no id binding): default to
+ *      `true` because the host renderer's template implies a file at
+ *      `<path>/index.md`. Pre-19c behavior for ghost entries.
+ */
+export function entryHasOwnIndex(contentDir, entryPath, fsHasIndex, fsHasReadme, boundFile, hasFsDir) {
+    if (boundFile !== undefined)
+        return true;
+    if (fsHasIndex)
+        return true;
+    if (fsHasReadme)
+        return true;
+    for (const basename of TEMPLATE_INDEX_BASENAMES) {
+        if (existsSync(join(contentDir, entryPath, basename)))
+            return true;
+    }
+    // No fs evidence at all — calendar-only ghost. Assume the host
+    // template (`<path>/index.md`) so detail-panel paths remain
+    // discoverable for entries that haven't been scaffolded yet.
+    if (!hasFsDir)
+        return true;
+    return false;
+}
+/** Return the most-recent ISO mtime across two values, or null when both are null. */
+export function pickLatestMtime(a, b) {
+    if (a === null)
+        return b;
+    if (b === null)
+        return a;
+    return a > b ? a : b;
+}
+/**
+ * If the relative path ends with a recognized index file basename
+ * (`index.md`, `index.mdx`, `index.markdown`), return the parent
+ * directory path. Otherwise return the path unchanged. Used to map
+ * `projects/the-outbound/index.md` (the file) → `projects/the-outbound`
+ * (the tree node).
+ *
+ * Files at flat paths (e.g. `my-flat-post.md`) keep their full path
+ * minus the extension as the node key. This matches today's
+ * audiocontrol shape where the slug is the basename.
+ */
+export function stripIndexBasename(relPath) {
+    const segments = relPath.split('/');
+    const last = segments[segments.length - 1].toLowerCase();
+    if (INDEX_BASENAMES.has(last)) {
+        return segments.slice(0, -1).join('/');
+    }
+    const dotIdx = last.lastIndexOf('.');
+    if (dotIdx > 0) {
+        const stripped = segments.slice(0, -1);
+        stripped.push(last.slice(0, dotIdx));
+        return stripped.join('/');
+    }
+    return relPath;
+}
+/**
+ * Find the fs path that the content index binds to this entry's id, or
+ * null when the entry has no id or its id isn't in the index.
+ */
+export function findIdBoundPath(entry, index) {
+    if (typeof entry.id !== 'string' || entry.id === '')
+        return null;
+    // Reverse-lookup byPath for value === entry.id. Keeps the index
+    // single-source-of-truth without us needing a third map.
+    for (const [path, id] of index.byPath.entries()) {
+        if (id === entry.id)
+            return stripIndexBasename(path);
+    }
+    return null;
+}
+/** Absolute path to the file the index binds to this entry, or undefined. */
+export function idBoundFile(entry, index) {
+    if (typeof entry.id !== 'string' || entry.id === '')
+        return undefined;
+    return index.byId.get(entry.id);
+}
+//# sourceMappingURL=content-tree-helpers.js.map

package/dist/content-tree-helpers.js.map

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

package/dist/content-tree-types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Public types for the bird's-eye content tree (Phase 16d / 19c).
+ *
+ * Extracted from `content-tree.ts` to keep the assembly module under
+ * the project's 500-line guideline. The tree builder re-exports every
+ * symbol from this module so callers continue importing from
+ * `@deskwork/core/content-tree`.
+ */
+import type { CalendarEntry, Stage } from './types.ts';
+import type { ContentIndex } from './content-index.ts';
+import type { FsWalkEntry } from './content-tree-fs-walk.ts';
+/** A node in the content tree. */
+export interface ContentNode {
+    /** Site slug — passed through from the input. */
+    site: string;
+    /**
+     * Fs-relative path under contentDir (e.g. `projects/the-outbound`,
+     * `essays/whats-in-a-name`). The structural key for the tree —
+     * parent/child wiring, URL construction, and node lookup all go
+     * through this field.
+     *
+     * Renamed from `slug` in Phase 19c (#33). For audiocontrol-shaped
+     * flat blogs, this is identical to today's slug (`my-flat-post`);
+     * for hierarchical content collections, this captures the actual
+     * fs hierarchy independent of any host-derived public URL.
+     */
+    path: string;
+    /**
+     * Host-owned public URL slug — populated only when a calendar entry
+     * is overlaid on this node. The studio uses this for the "public
+     * URL: /blog/<slug>" hover hint. Not used internally by deskwork
+     * for routing or path resolution. `undefined` for organizational
+     * nodes and for fs nodes that have no calendar entry.
+     */
+    slug?: string;
+    /**
+     * Absolute path of the markdown file backing this node, when one
+     * is known. Populated from the content index's id-binding (Issue #70)
+     * — the actual on-disk file, not a slug-template ghost. The studio's
+     * "file path" hint reads this to display the real path; renderers
+     * that previously reconstructed `<path>/index.md` from `path` were
+     * showing a path that didn't necessarily exist.
+     *
+     * `undefined` for ghost calendar entries (no fs binding yet) and for
+     * organizational nodes without a tracked calendar entry. Callers
+     * needing a fallback should check `hasOwnIndex` and fall back to
+     * a path constructed from `path`.
+     */
+    filePath?: string;
+    /** Display title. Resolution order: calendar entry title → README/index frontmatter title → leaf path segment. */
+    title: string;
+    /**
+     * Lifecycle stage when the node corresponds to a tracked calendar
+     * entry. `null` for organizational nodes (filesystem-only — no
+     * calendar entry).
+     */
+    lane: Stage | null;
+    /**
+     * Underlying calendar entry, when present. `null` for organizational
+     * filesystem nodes. Distinguishes "tracked / has lane" from
+     * "structural only / no lane".
+     */
+    entry: CalendarEntry | null;
+    /**
+     * True when the node has its own `index.md` / `README.md` on disk.
+     * Used by the UI to pick branch / leaf icons and (for organizational
+     * nodes) to decide whether the detail panel can show a README excerpt.
+     */
+    hasOwnIndex: boolean;
+    /**
+     * True when the node was discovered by the filesystem walk
+     * (independent of whether it has a calendar entry). Pure-calendar
+     * nodes (entry exists, no fs directory) report false here. Used by
+     * the studio detail panel to decide whether organizational README
+     * content is fetchable.
+     */
+    hasFsDir: boolean;
+    /** Items at `<contentDir>/<path>/scrapbook/` (public + secret). */
+    scrapbookCount: number;
+    /**
+     * Most recent mtime across the node's scrapbook items (ISO8601), or
+     * `null` when the scrapbook is empty / absent.
+     */
+    scrapbookMostRecentMtime: string | null;
+    /** Direct children — already sorted in path order. */
+    children: ContentNode[];
+}
+/**
+ * Project-level tree summary returned by `buildContentTree`. Operators
+ * use this both for the per-project drilldown and for the top-level
+ * site cards (counts + lanes derive from the same shape).
+ */
+export interface ContentProject {
+    site: string;
+    /**
+     * First path segment — the project root (e.g. `projects` for
+     * writingcontrol's hierarchical layout, or `my-flat-post` for an
+     * audiocontrol-shaped flat blog). Pre-19c this was "first slug
+     * segment"; post-19c the semantics shift to fs-driven. For flat
+     * layouts the value is unchanged; for hierarchical layouts it now
+     * captures the operator's organizational top-level (e.g. `projects`,
+     * `essays`) rather than a per-entry slug.
+     */
+    rootSlug: string;
+    /**
+     * Display name for the project. When a tracked entry exists at the
+     * root path, its `title` is used; otherwise the README frontmatter
+     * title or the rootSlug verbatim.
+     */
+    title: string;
+    /** Total tracked entries beneath this project (recursive). */
+    trackedCount: number;
+    /** Total tree nodes including organizational nodes (recursive). */
+    totalNodes: number;
+    /** Maximum depth (1 = single root node, 2 = root + leaves, …). */
+    maxDepth: number;
+    /** Sum of scrapbookCount across every node beneath this project. */
+    scrapbookCount: number;
+    /**
+     * Predominant lane across tracked nodes — the most-frequent stage,
+     * tie-broken by the lane order (`STAGES`). `null` when the project
+     * has no tracked entries.
+     */
+    predominantLane: Stage | null;
+    /** The project root node (its descendants live in `.children`). */
+    root: ContentNode;
+}
+/** Build-time options for `buildContentTree`. Test-friendly injection points. */
+export interface BuildOptions {
+    /**
+     * Override scrapbook lookups — useful for tests that don't want to
+     * depend on the real filesystem layout. Defaults to `listScrapbook`
+     * from `@deskwork/core/scrapbook`.
+     */
+    scrapbookLookup?: (site: string, path: string) => {
+        items: {
+            mtime: string;
+        }[];
+        secretItems: {
+            mtime: string;
+        }[];
+    };
+    /**
+     * Override the filesystem walk — used by tests to inject a synthetic
+     * directory shape without writing to disk. Defaults to
+     * `defaultFsWalk` (recursive walk under `resolveContentDir`).
+     */
+    fsWalk?: (site: string) => readonly FsWalkEntry[];
+    /**
+     * Override the content index — used by tests + the studio's
+     * per-request memoization. Defaults to `buildContentIndex` per call.
+     * The index drives the entry-id → fs-path overlay; without it,
+     * calendar entries fall through to the legacy slug-fallback path.
+     */
+    contentIndex?: ContentIndex;
+    /**
+     * Optional logger for the legacy slug-fallback warning. Tests inject
+     * a spy here; production code lets it default to `console.warn`.
+     * Receives one warning per calendar entry whose id wasn't found in
+     * the content index but whose slug matched an fs node.
+     */
+    warn?: (message: string) => void;
+}
+/**
+ * One row of the depth-first flatten — used by the studio's tree
+ * renderer. `depth` starts at 0 for the project root; `isLast` is true
+ * when the node is the last child of its parent (the UI uses it to
+ * truncate tree connector lines).
+ */
+export interface FlatNode {
+    node: ContentNode;
+    depth: number;
+    isLast: boolean;
+}
+//# sourceMappingURL=content-tree-types.d.ts.map

package/dist/content-tree-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tree-types.d.ts","sourceRoot":"","sources":["../src/content-tree-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;OAUG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kHAAkH;IAClH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB;;;;OAIG;IACH,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,sDAAsD;IACtD,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,KACT;QAAE,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,WAAW,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAC;IACtE;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,WAAW,EAAE,CAAC;IAClD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/content-tree-types.js

@@ -0,0 +1,10 @@
+/**
+ * Public types for the bird's-eye content tree (Phase 16d / 19c).
+ *
+ * Extracted from `content-tree.ts` to keep the assembly module under
+ * the project's 500-line guideline. The tree builder re-exports every
+ * symbol from this module so callers continue importing from
+ * `@deskwork/core/content-tree`.
+ */
+export {};
+//# sourceMappingURL=content-tree-types.js.map

package/dist/content-tree-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tree-types.js","sourceRoot":"","sources":["../src/content-tree-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/content-tree.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Bird's-eye content-tree builder (Phase 16d, fs-inverted in v0.6.0 / #24,
+ * fs-keyed in Phase 19c / #33).
+ *
+ * Derives a tree-of-nodes representation from the host project's
+ * filesystem, with the editorial calendar overlaid as a state layer.
+ *
+ *   - The **filesystem walk** is the primary structure source. Every
+ *     directory under `<contentDir>/` becomes a node, keyed by its
+ *     fs-relative path (e.g. `projects/the-outbound`).
+ *   - The **calendar** is the state overlay. A calendar entry whose
+ *     `id` matches an fs node's frontmatter `id:` (via the content
+ *     index) sets the node's lane (its lifecycle stage), display
+ *     title, AND the `slug` display attribute (the entry's
+ *     host-rendering-engine slug, used by the studio for the
+ *     "public URL: /blog/<slug>" hover hint).
+ *
+ * Read-only — never mutates the calendar or the filesystem. Callers
+ * cache the result for the lifetime of a single request unless the
+ * caller knows the underlying data has changed.
+ *
+ * Inversion rationale (#33): pre-19c the tree keyed nodes by **slug**.
+ * This worked for audiocontrol's flat layout where slug == fs path,
+ * but broke for writingcontrol where slug `the-outbound` (the
+ * Astro-derived public URL) is unrelated to the file's path
+ * (`projects/the-outbound/index.md`). The ghost-root bug came from
+ * union-by-slug producing a calendar-only tree at slug
+ * `the-outbound` plus a separate untracked tree under `projects/`
+ * that never merged.
+ *
+ * Now: tree placement is filesystem-driven. Each fs node carries the
+ * relative path (e.g. `projects/the-outbound`). Calendar entries
+ * overlay state onto fs nodes by matching the entry's `id` against
+ * the file's frontmatter `id:` via `buildContentIndex`. Slug stops
+ * being load-bearing structurally and becomes a display attribute.
+ *
+ * Legacy slug-fallback (intentional, for pre-doctor entries): when a
+ * calendar entry's id isn't found in the content index (its file
+ * hasn't been bound to frontmatter yet), the assembly looks for an
+ * fs node whose path equals the entry's slug. If found → overlay
+ * with a one-time warning hinting at `deskwork doctor`. If not found
+ * → place the entry as a ghost node (preserving today's behavior
+ * for entries with neither id-binding nor a path-shaped slug).
+ * This is NOT a "fallback for missing functionality" in the project
+ * rule's sense — it's a deliberate transitional path that the doctor
+ * command resolves operator-side.
+ */
+import type { CalendarEntry } from './types.ts';
+import type { DeskworkConfig } from './config.ts';
+import type { BuildOptions, ContentNode, ContentProject, FlatNode } from './content-tree-types.ts';
+export { defaultFsWalk } from './content-tree-fs-walk.ts';
+export type { FsWalkEntry } from './content-tree-fs-walk.ts';
+export type { BuildOptions, ContentNode, ContentProject, FlatNode, } from './content-tree-types.ts';
+/**
+ * Test-only: clear the legacy slug-fallback warning de-dup set so tests
+ * that exercise warning behavior can do so independently. Not part of the
+ * public API — exposed only because process-level state is awkward to
+ * reset from inside tests without a hook.
+ */
+export declare function __resetLegacyFallbackWarnings(): void;
+/**
+ * Build the content-tree projects for one site. Pure data — no HTML,
+ * no path-style decisions.
+ *
+ * Tree assembly (Phase 19c):
+ *   1. Walk the fs (`fsWalk`) to enumerate every directory under
+ *      contentDir. Each fs entry contributes a candidate node keyed by
+ *      its fs-relative path.
+ *   2. Build the content index (`buildContentIndex`) to map
+ *      `relPath → entryId` based on frontmatter `id:`.
+ *   3. For each fs node with a markdown index/README, look up the
+ *      bound entry id via `index.byPath`, then resolve the calendar
+ *      entry by id. If found → overlay state (lane, title from entry,
+ *      slug as a display attribute).
+ *   4. For calendar entries whose id is NOT in the index (their file
+ *      isn't bound to frontmatter yet — pre-doctor state), do
+ *      legacy slug fallback: look for an fs node whose path equals
+ *      the entry's slug. If found → overlay with a one-time warning.
+ *      If not found → place as a ghost node (today's behavior,
+ *      preserved for backward compat).
+ */
+export declare function buildContentTree(site: string, entries: readonly CalendarEntry[], config: DeskworkConfig, projectRoot: string, options?: BuildOptions): ContentProject[];
+/**
+ * Helper: find the node with the given path under a project tree, or
+ * return null. Used by the studio's node-detail panel.
+ */
+export declare function findNode(project: ContentProject, path: string): ContentNode | null;
+/**
+ * Flatten the tree into a depth-first ordered list. See `FlatNode` in
+ * `content-tree-types.ts` for the row shape.
+ */
+export declare function flattenForRender(root: ContentNode): FlatNode[];
+//# sourceMappingURL=content-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-tree.d.ts","sourceRoot":"","sources":["../src/content-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAclD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,QAAQ,EACT,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,QAAQ,GACT,MAAM,yBAAyB,CAAC;AAkBjC;;;;;GAKG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,YAAiB,GACzB,cAAc,EAAE,CAsOlB;AAgDD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,IAAI,CAUpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,QAAQ,EAAE,CAW9D"}