@deskwork/core 0.9.5

package/dist/frontmatter.d.ts

@@ -0,0 +1,103 @@
+/**
+ * YAML frontmatter reader/writer for markdown files.
+ *
+ * Deskwork skills that touch blog posts (draft, publish, distribute) need to
+ * read and update frontmatter — e.g. setting `datePublished` when a post
+ * ships, reading `contentUrl` when recording a distribution. This module
+ * wraps the `yaml` library so callers don't have to hand-roll YAML parsing.
+ *
+ * ## Shape
+ *
+ * A file with frontmatter looks like:
+ *
+ * ```markdown
+ * ---
+ * title: My Post
+ * datePublished: 2026-01-15
+ * ---
+ *
+ * # Body
+ * ```
+ *
+ * `parseFrontmatter` splits this into `data` (parsed YAML) and `body` (the
+ * remainder, including the leading newline if present). `stringifyFrontmatter`
+ * is the inverse for callers that need to construct frontmatter from scratch.
+ *
+ * ## Round-trip preservation (Issue #37)
+ *
+ * Naive parse → mutate → stringify normalizes everything: quoting styles
+ * dissolve, comments evaporate, key order shuffles. That bites Astro
+ * schemas that demand string scalars: `datePublished: "2020-10-01"`
+ * round-trips to `datePublished: 2020-10-01` and re-parses as a `Date`,
+ * which `z.string()` rejects.
+ *
+ * `updateFrontmatter` and `writeFrontmatter` use the yaml library's
+ * Document mode (`parseDocument` → mutate AST → `Document.toString()`)
+ * so the only bytes that change are the keys we touched. Existing
+ * quoting, comments, blank lines, and key order are byte-preserved.
+ *
+ * Read-only consumers (`parseFrontmatter`, `readFrontmatter`) still use
+ * the simpler `parse` API since they don't write anything back.
+ */
+/** Frontmatter values come back as whatever YAML parses them to. */
+export type FrontmatterData = Record<string, unknown>;
+export interface ParsedMarkdown {
+    data: FrontmatterData;
+    body: string;
+}
+/** Split a markdown string into its frontmatter data and body. */
+export declare function parseFrontmatter(markdown: string): ParsedMarkdown;
+/**
+ * Build a markdown string from frontmatter data and body.
+ *
+ * The body is joined to the frontmatter with a single newline — callers that
+ * want a blank line between the closing `---` and the body should start their
+ * body with `'\n'`.
+ *
+ * This is for callers that build frontmatter from scratch (e.g. the
+ * scaffolder writing a brand-new file). It does NOT preserve formatting
+ * since there's no existing source to preserve. Callers performing a
+ * read/mutate/write round-trip should use `updateFrontmatter` instead.
+ */
+export declare function stringifyFrontmatter(data: FrontmatterData, body: string): string;
+/**
+ * Merge a patch into a markdown file's frontmatter and return the new contents.
+ *
+ * Round-trip-preserving (Issue #37): edits the existing YAML AST in place
+ * so untouched keys remain byte-identical. Quoting styles, comments, blank
+ * lines, and key order are preserved exactly. Patched keys overwrite
+ * existing values; new keys are appended at the bottom of the map.
+ *
+ * If the file has no frontmatter, one is created with the patch as its
+ * only contents.
+ */
+export declare function updateFrontmatter(markdown: string, patch: FrontmatterData): string;
+/**
+ * Delete keys (or nested key paths) from a markdown file's frontmatter
+ * while preserving every other byte (round-trip-preserving, like
+ * `updateFrontmatter`).
+ *
+ * Each path is an array of string keys describing the descent into
+ * nested mappings, e.g. `['deskwork', 'id']` removes the `id` field
+ * inside the top-level `deskwork:` mapping. Top-level keys can be
+ * passed as a single-element path (`['datePublished']`).
+ *
+ * After a deletion, if the parent collection is left empty AND
+ * `pruneEmptyParents` is true (default), the parent collection is also
+ * removed. Set false to keep the empty container.
+ */
+export declare function removeFrontmatterPaths(markdown: string, paths: ReadonlyArray<ReadonlyArray<string>>, options?: {
+    pruneEmptyParents?: boolean;
+}): string;
+/** Read and parse a markdown file with frontmatter. */
+export declare function readFrontmatter(path: string): ParsedMarkdown;
+/**
+ * Write a markdown file with frontmatter.
+ *
+ * Like `stringifyFrontmatter`, this is for callers that build frontmatter
+ * from scratch (the scaffolder, primarily). For "read existing file →
+ * mutate → write back" flows, prefer reading the file and applying
+ * `updateFrontmatter` so existing formatting is preserved.
+ */
+export declare function writeFrontmatter(path: string, data: FrontmatterData, body: string): void;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAeH,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAsBjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,GACrB,MAAM,CAkBR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAC3C,OAAO,GAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC5C,MAAM,CAkCR;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,GACX,IAAI,CAEN"}

package/dist/frontmatter.js

@@ -0,0 +1,306 @@
+/**
+ * YAML frontmatter reader/writer for markdown files.
+ *
+ * Deskwork skills that touch blog posts (draft, publish, distribute) need to
+ * read and update frontmatter — e.g. setting `datePublished` when a post
+ * ships, reading `contentUrl` when recording a distribution. This module
+ * wraps the `yaml` library so callers don't have to hand-roll YAML parsing.
+ *
+ * ## Shape
+ *
+ * A file with frontmatter looks like:
+ *
+ * ```markdown
+ * ---
+ * title: My Post
+ * datePublished: 2026-01-15
+ * ---
+ *
+ * # Body
+ * ```
+ *
+ * `parseFrontmatter` splits this into `data` (parsed YAML) and `body` (the
+ * remainder, including the leading newline if present). `stringifyFrontmatter`
+ * is the inverse for callers that need to construct frontmatter from scratch.
+ *
+ * ## Round-trip preservation (Issue #37)
+ *
+ * Naive parse → mutate → stringify normalizes everything: quoting styles
+ * dissolve, comments evaporate, key order shuffles. That bites Astro
+ * schemas that demand string scalars: `datePublished: "2020-10-01"`
+ * round-trips to `datePublished: 2020-10-01` and re-parses as a `Date`,
+ * which `z.string()` rejects.
+ *
+ * `updateFrontmatter` and `writeFrontmatter` use the yaml library's
+ * Document mode (`parseDocument` → mutate AST → `Document.toString()`)
+ * so the only bytes that change are the keys we touched. Existing
+ * quoting, comments, blank lines, and key order are byte-preserved.
+ *
+ * Read-only consumers (`parseFrontmatter`, `readFrontmatter`) still use
+ * the simpler `parse` API since they don't write anything back.
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { parse as parseYaml, stringify as stringifyYaml, parseDocument, isMap, isScalar, Scalar, YAMLMap, } from 'yaml';
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
+/** Split a markdown string into its frontmatter data and body. */
+export function parseFrontmatter(markdown) {
+    const match = markdown.match(FRONTMATTER_RE);
+    if (!match) {
+        return { data: {}, body: markdown };
+    }
+    const [, yamlContent, body] = match;
+    let data;
+    try {
+        data = parseYaml(yamlContent);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid YAML frontmatter: ${reason}`);
+    }
+    if (data === null || data === undefined) {
+        return { data: {}, body };
+    }
+    if (typeof data !== 'object' || Array.isArray(data)) {
+        throw new Error(`Invalid frontmatter: expected a YAML mapping at the top level, got ${typeof data}.`);
+    }
+    return { data: toFrontmatterData(data), body };
+}
+/**
+ * Build a markdown string from frontmatter data and body.
+ *
+ * The body is joined to the frontmatter with a single newline — callers that
+ * want a blank line between the closing `---` and the body should start their
+ * body with `'\n'`.
+ *
+ * This is for callers that build frontmatter from scratch (e.g. the
+ * scaffolder writing a brand-new file). It does NOT preserve formatting
+ * since there's no existing source to preserve. Callers performing a
+ * read/mutate/write round-trip should use `updateFrontmatter` instead.
+ */
+export function stringifyFrontmatter(data, body) {
+    const doc = buildDocument(data);
+    return `---\n${doc.toString({ lineWidth: 0 }).replace(/\n$/, '')}\n---\n${body}`;
+}
+/**
+ * Merge a patch into a markdown file's frontmatter and return the new contents.
+ *
+ * Round-trip-preserving (Issue #37): edits the existing YAML AST in place
+ * so untouched keys remain byte-identical. Quoting styles, comments, blank
+ * lines, and key order are preserved exactly. Patched keys overwrite
+ * existing values; new keys are appended at the bottom of the map.
+ *
+ * If the file has no frontmatter, one is created with the patch as its
+ * only contents.
+ */
+export function updateFrontmatter(markdown, patch) {
+    const match = markdown.match(FRONTMATTER_RE);
+    if (!match) {
+        // No existing frontmatter — emit a fresh block. The body becomes
+        // the entire input; we prepend a fresh `---…---` block.
+        return stringifyFrontmatter(patch, markdown);
+    }
+    const [, yamlContent, body] = match;
+    const doc = parseDocument(yamlContent, { keepSourceTokens: false });
+    if (doc.errors.length > 0) {
+        const first = doc.errors[0];
+        throw new Error(`Invalid YAML frontmatter: ${first.message}`);
+    }
+    applyPatchToDocument(doc, patch);
+    // doc.toString() always ends with `\n`; trim it and re-add inside our
+    // delimiters so the on-disk shape stays `---\n<yaml>\n---\n<body>`.
+    const yamlOut = doc.toString({ lineWidth: 0 }).replace(/\n$/, '');
+    return `---\n${yamlOut}\n---\n${body}`;
+}
+/**
+ * Delete keys (or nested key paths) from a markdown file's frontmatter
+ * while preserving every other byte (round-trip-preserving, like
+ * `updateFrontmatter`).
+ *
+ * Each path is an array of string keys describing the descent into
+ * nested mappings, e.g. `['deskwork', 'id']` removes the `id` field
+ * inside the top-level `deskwork:` mapping. Top-level keys can be
+ * passed as a single-element path (`['datePublished']`).
+ *
+ * After a deletion, if the parent collection is left empty AND
+ * `pruneEmptyParents` is true (default), the parent collection is also
+ * removed. Set false to keep the empty container.
+ */
+export function removeFrontmatterPaths(markdown, paths, options = {}) {
+    const match = markdown.match(FRONTMATTER_RE);
+    if (!match)
+        return markdown;
+    const [, yamlContent, body] = match;
+    const doc = parseDocument(yamlContent);
+    if (doc.errors.length > 0) {
+        const first = doc.errors[0];
+        throw new Error(`Invalid YAML frontmatter: ${first.message}`);
+    }
+    const prune = options.pruneEmptyParents ?? true;
+    let mutated = false;
+    for (const path of paths) {
+        if (path.length === 0)
+            continue;
+        if (!doc.hasIn(path))
+            continue;
+        doc.deleteIn(path);
+        mutated = true;
+        if (prune && path.length > 1) {
+            // Walk parents, deleting any that became empty maps.
+            for (let depth = path.length - 1; depth >= 1; depth--) {
+                const parentPath = path.slice(0, depth);
+                const parent = doc.getIn(parentPath, true);
+                if (isMap(parent) && parent.items.length === 0) {
+                    doc.deleteIn(parentPath);
+                }
+                else {
+                    break;
+                }
+            }
+        }
+    }
+    if (!mutated)
+        return markdown;
+    const yamlOut = doc.toString({ lineWidth: 0 }).replace(/\n$/, '');
+    return `---\n${yamlOut}\n---\n${body}`;
+}
+/** Read and parse a markdown file with frontmatter. */
+export function readFrontmatter(path) {
+    return parseFrontmatter(readFileSync(path, 'utf-8'));
+}
+/**
+ * Write a markdown file with frontmatter.
+ *
+ * Like `stringifyFrontmatter`, this is for callers that build frontmatter
+ * from scratch (the scaffolder, primarily). For "read existing file →
+ * mutate → write back" flows, prefer reading the file and applying
+ * `updateFrontmatter` so existing formatting is preserved.
+ */
+export function writeFrontmatter(path, data, body) {
+    writeFileSync(path, stringifyFrontmatter(data, body), 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Internal helpers — Document AST mutation.
+// ---------------------------------------------------------------------------
+/**
+ * Apply a `{key: value}` patch to a parsed YAML Document, mutating the
+ * AST in place. Existing keys keep their quoting style; new keys are
+ * appended at the bottom of the top-level map.
+ *
+ * Nested objects are written via `setIn` so that `{deskwork: {id: …}}`
+ * patches the deeper key without clobbering siblings of `deskwork`.
+ */
+function applyPatchToDocument(doc, patch) {
+    // The frontmatter block must be a mapping. parseFrontmatter validates
+    // this on the read path; for the write path here we treat empty/null
+    // contents as a fresh empty map by setting keys directly through the
+    // Document API (which lazily creates the top-level container).
+    if (doc.contents !== null && !isMap(doc.contents)) {
+        throw new Error('Cannot patch frontmatter: top-level YAML node is not a mapping.');
+    }
+    for (const [key, value] of Object.entries(patch)) {
+        if (isPlainObject(value)) {
+            // Merge into nested map: only keys present in the patch are
+            // overwritten; existing siblings under the same parent stay.
+            mergeNestedObject(doc, [key], value);
+            continue;
+        }
+        if (isMap(doc.contents)) {
+            setScalarPreservingStyle(doc.contents, key, value);
+        }
+        else {
+            doc.set(key, value);
+        }
+    }
+}
+/**
+ * Set a scalar (or array) value on a YAMLMap, preserving the existing
+ * Scalar node's `type` (quoting style) when the key already exists. This
+ * is the round-trip-preservation hook: editing an already-double-quoted
+ * key keeps the double quotes.
+ */
+function setScalarPreservingStyle(map, key, value) {
+    const existing = map.get(key, true);
+    if (isScalar(existing)) {
+        const next = new Scalar(value);
+        if (existing.type !== undefined)
+            next.type = existing.type;
+        map.set(key, next);
+        return;
+    }
+    // No existing key, or the existing value was a collection — let the
+    // library pick the default representation.
+    map.set(key, value);
+}
+/**
+ * Merge a nested-object patch under `path` (e.g. `['deskwork']`) into
+ * the document. If the parent doesn't exist, create it as an empty map
+ * BEFORE descending. If individual keys under the parent collide,
+ * recursively merge so untouched siblings stay put.
+ *
+ * `Document.setIn` does not auto-vivify intermediate collections; it
+ * throws if the parent isn't a YAML collection. We materialize each
+ * level explicitly with `setIn(parentPath, {})` whenever it's missing.
+ */
+function mergeNestedObject(doc, path, value) {
+    // Ensure every prefix of `path` exists as a YAMLMap. setIn does not
+    // auto-vivify intermediate collections; passing a plain `{}` puts a
+    // JS object at the slot (which the next setIn refuses to descend
+    // into). We materialize each missing level explicitly with a real
+    // YAMLMap node so subsequent setIn calls can write into it.
+    for (let depth = 1; depth <= path.length; depth++) {
+        const prefix = path.slice(0, depth);
+        if (!doc.hasIn(prefix)) {
+            doc.setIn(prefix, new YAMLMap(doc.schema));
+        }
+    }
+    for (const [k, v] of Object.entries(value)) {
+        const fullPath = [...path, k];
+        if (isPlainObject(v)) {
+            mergeNestedObject(doc, fullPath, v);
+            continue;
+        }
+        doc.setIn(fullPath, v);
+    }
+}
+/**
+ * Plain-object check used to decide whether a value should be merged
+ * via setIn (preserving sibling keys) or replaced wholesale via set.
+ *
+ * Plain objects are non-null, non-array, prototype-Object values —
+ * Records of unknown.
+ */
+function isPlainObject(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    if (Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/**
+ * Build a fresh Document from plain data. Used by `stringifyFrontmatter`
+ * for write-from-scratch callers. We round-trip the data through
+ * `parseDocument(stringify(...))` rather than constructing nodes by
+ * hand so that block-style output (with proper indentation for nested
+ * collections) is the default — that's the format every existing
+ * scaffold/test asserts on.
+ */
+function buildDocument(data) {
+    const initialYaml = stringifyYaml(data, { lineWidth: 0 });
+    // Empty data renders as `{}\n`; parseDocument handles both shapes.
+    return parseDocument(initialYaml);
+}
+/**
+ * Narrow `unknown` from yaml's `parse` return type to FrontmatterData.
+ * The caller has already asserted the parse result is an object and
+ * not an array; this is the single point that crosses the typing gap
+ * between yaml's `unknown` and our typed surface.
+ */
+function toFrontmatterData(value) {
+    const out = {};
+    for (const k of Object.keys(value)) {
+        out[k] = value[k];
+    }
+    return out;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @deskwork/core — barrel export of every public symbol used across
+ * the cli and studio packages.
+ *
+ * Subpath imports (e.g. `@deskwork/core/calendar`) are also supported
+ * for callers that want to be explicit about which module they pull
+ * from. Both forms resolve to the same source files.
+ */
+export * from './types.ts';
+export * from './config.ts';
+export * from './paths.ts';
+export * from './cli.ts';
+export * from './calendar.ts';
+export * from './calendar-mutations.ts';
+export * from './frontmatter.ts';
+export * from './journal.ts';
+export * from './scaffold.ts';
+export * from './body-state.ts';
+export * from './ingest.ts';
+export * as scrapbook from './scrapbook.ts';
+export * as renameSlug from './rename-slug.ts';
+export * as review from './review/index.ts';
+export * as contentTree from './content-tree.ts';
+export * from './content-index.ts';
+export * as doctor from './doctor/index.ts';
+export * from './overrides.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @deskwork/core — barrel export of every public symbol used across
+ * the cli and studio packages.
+ *
+ * Subpath imports (e.g. `@deskwork/core/calendar`) are also supported
+ * for callers that want to be explicit about which module they pull
+ * from. Both forms resolve to the same source files.
+ */
+export * from "./types.js";
+export * from "./config.js";
+export * from "./paths.js";
+export * from "./cli.js";
+export * from "./calendar.js";
+export * from "./calendar-mutations.js";
+export * from "./frontmatter.js";
+export * from "./journal.js";
+export * from "./scaffold.js";
+export * from "./body-state.js";
+export * from "./ingest.js";
+export * as scrapbook from "./scrapbook.js";
+export * as renameSlug from "./rename-slug.js";
+export * as review from "./review/index.js";
+export * as contentTree from "./content-tree.js";
+export * from "./content-index.js";
+export * as doctor from "./doctor/index.js";
+export * from "./overrides.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,cAAc,gBAAgB,CAAC"}

package/dist/ingest-derive.d.ts

@@ -0,0 +1,79 @@
+/**
+ * ingest-derive.ts — slug / state / date / title derivation for ingest.
+ *
+ * Each `derive*` function takes the file's absolute path, its discovery
+ * root (for path-based slug derivation), the parsed frontmatter, the
+ * effective field-name table, and the operator's options. It returns a
+ * `<thing>Derivation` record that records both the derived value AND
+ * where it came from — the dry-run plan surfaces these sources so the
+ * operator can sanity-check before committing.
+ */
+import { type Stage } from './types.ts';
+import type { FrontmatterData } from './frontmatter.ts';
+/**
+ * Where a derived value came from. `'frontmatter'` is reserved for
+ * values that actually appear in the file's frontmatter — when a field
+ * is absent and we substitute a hardcoded fallback (e.g. defaulting
+ * state to `Ideas` when the frontmatter has no `state:` key), the
+ * source is `'default'`. The dry-run plan surfaces this so the
+ * operator can tell at a glance whether a row reflects the file or
+ * was filled in by the ingest layer.
+ */
+export type DerivationSource = 'frontmatter' | 'path' | 'mtime' | 'today' | 'explicit' | 'default';
+export interface SlugDerivation {
+    value: string;
+    source: DerivationSource;
+    reason?: string;
+}
+export interface StateDerivation {
+    value: Stage | null;
+    source: DerivationSource;
+    rawValue?: string;
+}
+export interface DateDerivation {
+    value: string;
+    source: DerivationSource;
+}
+/**
+ * Canonical state-string normalization. Maps frontmatter values that
+ * editorial projects commonly use onto our six lanes. Anything outside
+ * this table comes back ambiguous — the operator must pass `--state`.
+ */
+export declare const STATE_ALIASES: Record<string, Stage>;
+export interface SlugDeriveInput {
+    filePath: string;
+    root: string;
+    frontmatter: FrontmatterData;
+    fieldName: string;
+    slugFrom: 'frontmatter' | 'path';
+    explicitSlug?: string;
+}
+/**
+ * Derive a slug for a discovered file. Order:
+ *
+ *   1. `explicitSlug` (operator's `--slug`) — wins, marked 'explicit'.
+ *   2. When `slugFrom === 'frontmatter'`, the named frontmatter field
+ *      (default `slug:`) when set; otherwise falls through to path.
+ *   3. Path-based derivation — see `slugFromPath`.
+ */
+export declare function deriveSlug(input: SlugDeriveInput): SlugDerivation;
+export interface StateDeriveInput {
+    frontmatter: FrontmatterData;
+    stateField: string;
+    dateField: string;
+    stateFrom: 'frontmatter' | 'datePublished';
+    explicitState?: Stage;
+    now?: Date;
+}
+export declare function deriveState(input: StateDeriveInput): StateDerivation;
+export interface DateDeriveInput {
+    filePath: string;
+    frontmatter: FrontmatterData;
+    dateField: string;
+    explicitDate?: string;
+    now?: Date;
+}
+export declare function deriveDate(input: DateDeriveInput): DateDerivation;
+export declare function deriveTitle(frontmatter: FrontmatterData, fieldName: string, slug: string): string;
+export declare function deriveDescription(frontmatter: FrontmatterData, fieldName: string): string;
+//# sourceMappingURL=ingest-derive.d.ts.map

package/dist/ingest-derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-derive.d.ts","sourceRoot":"","sources":["../src/ingest-derive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAW,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GACxB,aAAa,GACb,MAAM,GACN,OAAO,GACP,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAKD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAe/C,CAAC;AAMF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CAYjE;AA0HD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,aAAa,GAAG,eAAe,CAAC;IAC3C,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,eAAe,CA+BpE;AAiBD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,CA8BjE;AAMD,wBAAgB,WAAW,CACzB,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,MAAM,CAWR;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,eAAe,EAC5B,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}