@deskwork/core 0.45.1 → 0.46.0

package/dist/lanes/scaffold-path.js

@@ -0,0 +1,122 @@
+/**
+ * add-time artifactPath composition (Phase 39c-2b, sub-task b).
+ *
+ * `deskwork add --lane X [--kind markdown] [--layout L]` creates a NEW
+ * entry that has no `artifactPath` yet. This module composes that path
+ * from the lane's add-time `scaffoldDefaults` (the directory), the
+ * requested layout (the on-disk file shape), and the entry's slug, then
+ * the caller stamps the result onto the new entry's sidecar — from which
+ * point it is authoritative (resolution never recomputes it).
+ *
+ * MARKDOWN ONLY (operator decision): `deskwork add` supports only
+ * markdown entries right now — deskwork has no non-markdown materializer,
+ * so a non-markdown entry can't be created. {@link composeAddArtifactPath} therefore throws loudly
+ * for any non-markdown kind rather than composing a path that nothing
+ * can fulfill. The `ArtifactKind` TYPE still carries the other kinds for
+ * graphical-entries; only the add path gates to markdown.
+ *
+ * Per the sites→lanes retirement design (§ "add-time path composition"):
+ *
+ *   directory     ← lane.scaffoldDefaults['markdown']  (FAILS LOUDLY if absent)
+ *   layout        ← --layout flag, else DEFAULT_SCAFFOLD_LAYOUT (index)
+ *   relativePath  ← layoutToContentRelativePath(layout, slug)
+ *   artifactPath  ← posixJoin(directory, relativePath)
+ *
+ * POSIX join (AUDIT-40): `artifactPath` is persisted and string-compared
+ * against the forward-slash paths the rest of the system stores, so the
+ * join uses `node:path/posix` (never `node:path.join`, which yields
+ * backslashes on Windows).
+ *
+ * No fallback: a lane that does not declare a `scaffoldDefaults['markdown']`
+ * entry is an actionable operator error, not a silent default directory
+ * (per the project no-fallbacks rule). The thrown message names the lane
+ * id and how to fix it.
+ */
+import { posix } from 'node:path';
+/**
+ * The default layout used by `deskwork add` when `--layout` is omitted.
+ * `index` reproduces the legacy `{slug}/index.md` template default
+ * byte-for-byte — chosen for zero-behavior-change at the sites→lanes
+ * cutover.
+ *
+ * Per design Decision #12 this is a single GLOBAL default. (The
+ * superseding per-kind Decision #16 was retired alongside the multi-kind
+ * machinery when `add` was gated to markdown-only — a global default is
+ * correct again now that only one kind is supported.)
+ */
+export const DEFAULT_SCAFFOLD_LAYOUT = 'index';
+/**
+ * Map a {@link ScaffoldLayout} + slug to the directory-relative path for
+ * a MARKDOWN artifact (the only kind `deskwork add` scaffolds).
+ */
+export function layoutToContentRelativePath(layout, slug) {
+    switch (layout) {
+        case 'index':
+            return `${slug}/index.md`;
+        case 'readme':
+            return `${slug}/README.md`;
+        case 'flat':
+            return `${slug}.md`;
+    }
+}
+/**
+ * Compose the project-relative `artifactPath` for a NEW markdown entry
+ * being scaffolded into a lane.
+ *
+ * @param lane - The resolved lane config the entry belongs to.
+ * @param kind - The entry's artifact kind. ONLY `markdown` is supported;
+ *   any other kind throws (see module docblock — file creation for
+ *   non-markdown kinds is not implemented).
+ * @param slug - The entry's slug (one or more `/`-separated kebab-case
+ *   segments).
+ * @param layout - The on-disk file shape. When omitted, defaults to
+ *   {@link DEFAULT_SCAFFOLD_LAYOUT} (`index`).
+ * @returns The project-root-relative path to stamp onto the entry's
+ *   sidecar (e.g. `src/content/blog/my-post/index.md`), joined with
+ *   forward slashes (AUDIT-40).
+ * @throws When `kind` is not `markdown`; or when the lane declares no
+ *   `scaffoldDefaults['markdown']` entry.
+ */
+export function composeAddArtifactPath(lane, kind, slug, layout) {
+    if (kind !== 'markdown') {
+        throw new Error(`deskwork add currently supports only markdown entries; artifact kind ` +
+            `"${kind}" is not yet supported because file creation for ` +
+            `non-markdown kinds is not implemented. Use --kind markdown (the ` +
+            `default), or omit --kind.`);
+    }
+    const directory = lane.scaffoldDefaults?.['markdown'];
+    if (directory === undefined) {
+        const declared = lane.scaffoldDefaults
+            ? Object.keys(lane.scaffoldDefaults).sort().join(', ') || '(none)'
+            : '(none)';
+        throw new Error(`Lane "${lane.id}" has no scaffoldDefaults entry for artifact kind ` +
+            `"markdown", so \`deskwork add\` cannot choose where to place the ` +
+            `new file. Add a default directory for markdown to the lane — e.g. ` +
+            `\`deskwork lane <project-root> update ${lane.id} ` +
+            `--scaffold-default markdown=<dir>\`. ` +
+            `Kinds the lane currently defines: ${declared}.`);
+    }
+    const effectiveLayout = layout ?? DEFAULT_SCAFFOLD_LAYOUT;
+    const relativePath = layoutToContentRelativePath(effectiveLayout, slug);
+    // AUDIT-40: POSIX join — persisted paths are forward-slash, compared
+    // string-wise against the rest of the system's stored paths.
+    return posix.join(directory, relativePath);
+}
+/**
+ * Narrow a raw `--layout` flag value to a {@link ScaffoldLayout}.
+ * Returns `undefined` for unrecognized values so the CLI caller can
+ * raise its own argument-shaped error (with the legal list and exit 2).
+ */
+export function parseScaffoldLayout(value) {
+    if (value === 'index' || value === 'readme' || value === 'flat') {
+        return value;
+    }
+    return undefined;
+}
+/** The legal `--layout` values, for error messages. */
+export const SCAFFOLD_LAYOUTS = [
+    'index',
+    'readme',
+    'flat',
+];
+//# sourceMappingURL=scaffold-path.js.map

package/dist/lanes/scaffold-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-path.js","sourceRoot":"","sources":["../../src/lanes/scaffold-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAYlC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmB,OAAO,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAsB,EACtB,IAAY;IAEZ,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,OAAO;YACV,OAAO,GAAG,IAAI,WAAW,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,GAAG,IAAI,YAAY,CAAC;QAC7B,KAAK,MAAM;YACT,OAAO,GAAG,IAAI,KAAK,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAgB,EAChB,IAAkB,EAClB,IAAY,EACZ,MAAuB;IAEvB,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,IAAI,IAAI,mDAAmD;YAC3D,kEAAkE;YAClE,2BAA2B,CAC9B,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,UAAU,CAAC,CAAC;IACtD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB;YACpC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ;YAClE,CAAC,CAAC,QAAQ,CAAC;QACb,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,CAAC,EAAE,oDAAoD;YAClE,mEAAmE;YACnE,oEAAoE;YACpE,yCAAyC,IAAI,CAAC,EAAE,GAAG;YACnD,uCAAuC;YACvC,qCAAqC,QAAQ,GAAG,CACnD,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,IAAI,uBAAuB,CAAC;IAC1D,MAAM,YAAY,GAAG,2BAA2B,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IACxE,qEAAqE;IACrE,6DAA6D;IAC7D,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAChE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,OAAO;IACP,QAAQ;IACR,MAAM;CACP,CAAC"}

package/dist/lanes/types.d.ts

@@ -3,11 +3,14 @@
  * pipeline template.
  *
  * Lanes are the graphical-entries unit of parallel-pipeline tracking
- * (PRD § Lanes). A project hosts one or more lanes; each lane has its
- * own content directory, its own pipeline template, and its own stage
- * vocabulary derived from that template. Entries live inside a single
- * lane; the entry's sidecar carries `lane: <laneId>` to identify
- * membership.
+ * (PRD § Lanes). A project hosts one or more lanes; each lane has a
+ * pipeline template and a stage vocabulary derived from that template.
+ * A lane is a LOGICAL grouping identified by `id` — it carries NO
+ * location of its own. Per the sites→lanes retirement (Phase 39),
+ * location is a property of the ENTRY (`entry.artifactPath`), never the
+ * lane. A lane "spans" whatever directories/filesystems its entries
+ * happen to live in — emergent from the entries, not declared on the
+ * lane. Entries carry `lane: <laneId>` to identify membership.
  *
  * Plugin defaults: there are none. Lanes are project-owned; every lane
  * config lives under `<projectRoot>/.deskwork/lanes/<id>.json`. The
@@ -25,10 +28,19 @@
  *   - `pipelineTemplate` is a non-empty string referencing a
  *     PipelineTemplate id; the loader cross-validates that the
  *     referenced template resolves via `loadPipelineTemplate`.
- *   - `contentDir` is a non-empty path; relative paths are resolved
- *     against the project root by callers, absolute paths are taken
- *     verbatim. Doctor may normalize later; the schema enforces
- *     non-empty only.
+ *   - `host` (optional) — present only when this lane publishes its
+ *     content tree as a website. A lane without a host is fully valid
+ *     (the collection model is renderer-independent). Where the host
+ *     reads land (studio URL formatting) is a downstream concern; the
+ *     schema only records the optional string.
+ *   - `scaffoldDefaults` (optional) — a PARTIAL map from `ArtifactKind`
+ *     to the directory where `/deskwork:add` drops a NEW file of that
+ *     kind. Partial by construction: a lane defines defaults only for
+ *     the kinds its pipeline actually scaffolds (e.g. a single-kind
+ *     map `{ markdown: 'src/content/blog' }` validates). It is a
+ *     convenience default used solely at add-time — NEVER identity,
+ *     NEVER resolution. Unknown keys are rejected because the key
+ *     schema is the `ArtifactKind` enum.
  *
  * The on-disk JSON additionally permits a top-level `"$rationale"`
  * string field as the JSON-with-comments workaround (matching the
@@ -68,25 +80,51 @@ import { z } from 'zod';
  * boundary.
  */
 export declare const LANE_ID_REGEX: RegExp;
+/**
+ * The four artifact kinds the lane-aware entry model recognizes:
+ *   - `markdown`           — a single `.md` file (the legacy editorial
+ *                            artifact shape).
+ *   - `html-mockup`        — a directory containing `index.html` plus
+ *                            optional sibling assets (mockups / design
+ *                            specs / standalone HTML deliverables).
+ *   - `single-file-html`   — a loose `.html` file (not inside an
+ *                            html-mockup directory).
+ *   - `image`              — a raster or vector image file (.png /
+ *                            .jpg / .jpeg / .gif / .webp / .svg).
+ *
+ * Detection: see `./detection.ts` (`detectArtifactKind`).
+ *
+ * Declared ABOVE `LaneConfigSchema` so the schema's `scaffoldDefaults`
+ * record can key off this enum (a `z.record` over the enum is partial
+ * by construction — see the `scaffoldDefaults` field docblock).
+ */
+export declare const ArtifactKindSchema: z.ZodEnum<["markdown", "html-mockup", "single-file-html", "image"]>;
+export type ArtifactKind = z.infer<typeof ArtifactKindSchema>;
 export declare const LaneConfigSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     pipelineTemplate: z.ZodString;
-    contentDir: z.ZodString;
+    host: z.ZodOptional<z.ZodString>;
+    redirectsPath: z.ZodOptional<z.ZodString>;
+    scaffoldDefaults: z.ZodOptional<z.ZodRecord<z.ZodEnum<["markdown", "html-mockup", "single-file-html", "image"]>, z.ZodString>>;
     archivedAt: z.ZodOptional<z.ZodString>;
     $rationale: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     id: string;
-    contentDir: string;
     name: string;
     pipelineTemplate: string;
+    host?: string | undefined;
+    redirectsPath?: string | undefined;
+    scaffoldDefaults?: Partial<Record<"markdown" | "html-mockup" | "single-file-html" | "image", string>> | undefined;
     archivedAt?: string | undefined;
     $rationale?: string | undefined;
 }, {
     id: string;
-    contentDir: string;
     name: string;
     pipelineTemplate: string;
+    host?: string | undefined;
+    redirectsPath?: string | undefined;
+    scaffoldDefaults?: Partial<Record<"markdown" | "html-mockup" | "single-file-html" | "image", string>> | undefined;
     archivedAt?: string | undefined;
     $rationale?: string | undefined;
 }>;
@@ -96,25 +134,10 @@ export declare const LaneConfigSchema: z.ZodObject<{
  * inferred type tracks it without manual duplication.
  *
  * The schema is `.strict()`, so the inferred type lists exactly the
- * declared keys: `id`, `name`, `pipelineTemplate`, `contentDir`,
- * `archivedAt` (optional), `$rationale` (optional). Unknown top-level
- * keys fail parse at the schema layer (AUDIT-20260530-08 fix).
+ * declared keys: `id`, `name`, `pipelineTemplate`, `host` (optional),
+ * `scaffoldDefaults` (optional), `archivedAt` (optional), `$rationale`
+ * (optional). Unknown top-level keys — including the retired
+ * `contentDir` — fail parse at the schema layer (AUDIT-20260530-08 fix).
  */
 export type LaneConfig = z.infer<typeof LaneConfigSchema>;
-/**
- * The four artifact kinds the lane-aware entry model recognizes:
- *   - `markdown`           — a single `.md` file (the legacy editorial
- *                            artifact shape).
- *   - `html-mockup`        — a directory containing `index.html` plus
- *                            optional sibling assets (mockups / design
- *                            specs / standalone HTML deliverables).
- *   - `single-file-html`   — a loose `.html` file (not inside an
- *                            html-mockup directory).
- *   - `image`              — a raster or vector image file (.png /
- *                            .jpg / .jpeg / .gif / .webp / .svg).
- *
- * Detection: see `./detection.ts` (`detectArtifactKind`).
- */
-export declare const ArtifactKindSchema: z.ZodEnum<["markdown", "html-mockup", "single-file-html", "image"]>;
-export type ArtifactKind = z.infer<typeof ArtifactKindSchema>;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lanes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,QAAyB,CAAC;AAEpD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAclB,CAAC;AAEZ;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,qEAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lanes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,QAAyB,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,qEAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqClB,CAAC;AAEZ;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/lanes/types.js

@@ -3,11 +3,14 @@
  * pipeline template.
  *
  * Lanes are the graphical-entries unit of parallel-pipeline tracking
- * (PRD § Lanes). A project hosts one or more lanes; each lane has its
- * own content directory, its own pipeline template, and its own stage
- * vocabulary derived from that template. Entries live inside a single
- * lane; the entry's sidecar carries `lane: <laneId>` to identify
- * membership.
+ * (PRD § Lanes). A project hosts one or more lanes; each lane has a
+ * pipeline template and a stage vocabulary derived from that template.
+ * A lane is a LOGICAL grouping identified by `id` — it carries NO
+ * location of its own. Per the sites→lanes retirement (Phase 39),
+ * location is a property of the ENTRY (`entry.artifactPath`), never the
+ * lane. A lane "spans" whatever directories/filesystems its entries
+ * happen to live in — emergent from the entries, not declared on the
+ * lane. Entries carry `lane: <laneId>` to identify membership.
  *
  * Plugin defaults: there are none. Lanes are project-owned; every lane
  * config lives under `<projectRoot>/.deskwork/lanes/<id>.json`. The
@@ -25,10 +28,19 @@
  *   - `pipelineTemplate` is a non-empty string referencing a
  *     PipelineTemplate id; the loader cross-validates that the
  *     referenced template resolves via `loadPipelineTemplate`.
- *   - `contentDir` is a non-empty path; relative paths are resolved
- *     against the project root by callers, absolute paths are taken
- *     verbatim. Doctor may normalize later; the schema enforces
- *     non-empty only.
+ *   - `host` (optional) — present only when this lane publishes its
+ *     content tree as a website. A lane without a host is fully valid
+ *     (the collection model is renderer-independent). Where the host
+ *     reads land (studio URL formatting) is a downstream concern; the
+ *     schema only records the optional string.
+ *   - `scaffoldDefaults` (optional) — a PARTIAL map from `ArtifactKind`
+ *     to the directory where `/deskwork:add` drops a NEW file of that
+ *     kind. Partial by construction: a lane defines defaults only for
+ *     the kinds its pipeline actually scaffolds (e.g. a single-kind
+ *     map `{ markdown: 'src/content/blog' }` validates). It is a
+ *     convenience default used solely at add-time — NEVER identity,
+ *     NEVER resolution. Unknown keys are rejected because the key
+ *     schema is the `ArtifactKind` enum.
  *
  * The on-disk JSON additionally permits a top-level `"$rationale"`
  * string field as the JSON-with-comments workaround (matching the
@@ -68,18 +80,6 @@ import { z } from 'zod';
  * boundary.
  */
 export const LANE_ID_REGEX = /^[a-z0-9][a-z0-9-]*$/;
-export const LaneConfigSchema = z.object({
-    id: z.string().regex(LANE_ID_REGEX, 'lane id must be kebab-case [a-z0-9-], starting with [a-z0-9]'),
-    name: z.string().min(1, 'name must be a non-empty string'),
-    pipelineTemplate: z.string().min(1, 'pipelineTemplate must be a non-empty string'),
-    contentDir: z.string().min(1, 'contentDir must be a non-empty string'),
-    archivedAt: z.string().datetime().optional(),
-    // Sole explicitly-declared "extra" key — the comments-in-JSON
-    // workaround that mirrors PipelineTemplateSchema (AUDIT-20260530-02).
-    // Declared so `.strict()` admits it; anything else at the top level
-    // is rejected.
-    $rationale: z.string().optional(),
-}).strict();
 /**
  * The four artifact kinds the lane-aware entry model recognizes:
  *   - `markdown`           — a single `.md` file (the legacy editorial
@@ -93,6 +93,10 @@ export const LaneConfigSchema = z.object({
  *                            .jpg / .jpeg / .gif / .webp / .svg).
  *
  * Detection: see `./detection.ts` (`detectArtifactKind`).
+ *
+ * Declared ABOVE `LaneConfigSchema` so the schema's `scaffoldDefaults`
+ * record can key off this enum (a `z.record` over the enum is partial
+ * by construction — see the `scaffoldDefaults` field docblock).
  */
 export const ArtifactKindSchema = z.enum([
     'markdown',
@@ -100,4 +104,39 @@ export const ArtifactKindSchema = z.enum([
     'single-file-html',
     'image',
 ]);
+export const LaneConfigSchema = z.object({
+    id: z.string().regex(LANE_ID_REGEX, 'lane id must be kebab-case [a-z0-9-], starting with [a-z0-9]'),
+    name: z.string().min(1, 'name must be a non-empty string'),
+    pipelineTemplate: z.string().min(1, 'pipelineTemplate must be a non-empty string'),
+    // NOTE: a lane carries NO location. `contentDir` was removed in
+    // Phase 39c (sites→lanes retirement) — location is an ENTRY property
+    // (`entry.artifactPath`). A lane's only location-adjacent field is the
+    // optional add-time `scaffoldDefaults` below, which is never identity
+    // and never used for resolution. Because the schema is `.strict()`, a
+    // legacy on-disk lane carrying `contentDir` now FAILS parse with an
+    // unknown-key error; the doctor migration cleans it.
+    // Optional — present only when this lane publishes to a website.
+    host: z.string().min(1, 'host must be a non-empty string when present').optional(),
+    // Optional — website-publishing metadata, a sibling of `host`. Path
+    // (relative to the project root, or absolute) to a Netlify-style
+    // `_redirects` file; `rename-slug` appends a 301 block here when the
+    // lane is configured to publish to a website. Only meaningful when the
+    // lane publishes a website — a lane without it is fully valid and the
+    // redirect-append step is simply skipped. Re-homed from the retired
+    // `SiteConfig.redirectsPath` in Phase 39c (sites→lanes retirement,
+    // spec Decision #23 — mirrors how `host` re-homed under Decision #2).
+    redirectsPath: z.string().min(1, 'redirectsPath must be a non-empty string when present').optional(),
+    // Optional, PARTIAL-by-construction map from ArtifactKind → scaffold
+    // directory. A single-kind map validates; unknown keys are rejected
+    // because the key schema is the ArtifactKind enum. Used solely at
+    // add-time to choose where a NEW file lands — never identity, never
+    // resolution.
+    scaffoldDefaults: z.record(ArtifactKindSchema, z.string().min(1)).optional(),
+    archivedAt: z.string().datetime().optional(),
+    // Sole explicitly-declared "extra" key — the comments-in-JSON
+    // workaround that mirrors PipelineTemplateSchema (AUDIT-20260530-02).
+    // Declared so `.strict()` admits it; anything else at the top level
+    // is rejected.
+    $rationale: z.string().optional(),
+}).strict();
 //# sourceMappingURL=types.js.map

package/dist/lanes/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lanes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAEpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAClB,aAAa,EACb,8DAA8D,CAC/D;IACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;IAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uCAAuC,CAAC;IACtE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,8DAA8D;IAC9D,sEAAsE;IACtE,oEAAoE;IACpE,eAAe;IACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC;AAcZ;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,UAAU;IACV,aAAa;IACb,kBAAkB;IAClB,OAAO;CACR,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/lanes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,UAAU;IACV,aAAa;IACb,kBAAkB;IAClB,OAAO;CACR,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAClB,aAAa,EACb,8DAA8D,CAC/D;IACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,iCAAiC,CAAC;IAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,6CAA6C,CAAC;IAClF,gEAAgE;IAChE,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,sEAAsE;IACtE,oEAAoE;IACpE,qDAAqD;IACrD,iEAAiE;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,8CAA8C,CAAC,CAAC,QAAQ,EAAE;IAClF,oEAAoE;IACpE,iEAAiE;IACjE,qEAAqE;IACrE,uEAAuE;IACvE,sEAAsE;IACtE,oEAAoE;IACpE,mEAAmE;IACnE,sEAAsE;IACtE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uDAAuD,CAAC,CAAC,QAAQ,EAAE;IACpG,qEAAqE;IACrE,oEAAoE;IACpE,kEAAkE;IAClE,oEAAoE;IACpE,cAAc;IACd,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,8DAA8D;IAC9D,sEAAsE;IACtE,oEAAoE;IACpE,eAAe;IACf,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/outline-split.d.ts

@@ -17,9 +17,8 @@ export interface SplitOutline {
  * prepended to `body`; anything after is appended. Rejoin via
  * `joinOutline`.
  *
- * This mirrors the line-wise logic in `scripts/lib/editorial/
- * body-state.ts` (kept separate so the browser-side bundle
- * doesn't have to drag in the server's fs/path imports).
+ * Kept as a standalone line-wise helper so the browser-side bundle
+ * doesn't have to drag in the server's fs/path imports.
  */
 export declare function splitOutline(md: string): SplitOutline;
 /**

package/dist/outline-split.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outline-split.d.ts","sourceRoot":"","sources":["../src/outline-split.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAgBrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBjE"}
+{"version":3,"file":"outline-split.d.ts","sourceRoot":"","sources":["../src/outline-split.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAgBrD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBjE"}

package/dist/outline-split.js

@@ -26,9 +26,8 @@
  * prepended to `body`; anything after is appended. Rejoin via
  * `joinOutline`.
  *
- * This mirrors the line-wise logic in `scripts/lib/editorial/
- * body-state.ts` (kept separate so the browser-side bundle
- * doesn't have to drag in the server's fs/path imports).
+ * Kept as a standalone line-wise helper so the browser-side bundle
+ * doesn't have to drag in the server's fs/path imports.
  */
 export function splitOutline(md) {
     const lines = md.split('\n');

package/dist/outline-split.js.map

@@ -1 +1 @@
-{"version":3,"file":"outline-split.js","sourceRoot":"","sources":["../src/outline-split.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAeH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,MAAM,GAAG,CAAC,CAAC;YACX,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,2DAA2D;QAC3D,wDAAwD;QACxD,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,OAAO,GAAG,IAAI,GAAG,eAAe,KAAK,cAAc,IAAI,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,2DAA2D;IAC3D,2DAA2D;IAC3D,uCAAuC;IACvC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"outline-split.js","sourceRoot":"","sources":["../src/outline-split.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAeH;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,MAAM,GAAG,CAAC,CAAC;YACX,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,2DAA2D;QAC3D,wDAAwD;QACxD,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxD,OAAO,GAAG,IAAI,GAAG,eAAe,KAAK,cAAc,IAAI,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,2DAA2D;IAC3D,2DAA2D;IAC3D,uCAAuC;IACvC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,EAAE,CAAC;IACf,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/paths.d.ts

@@ -26,7 +26,6 @@
  */
 import type { DeskworkConfig } from './config.ts';
 import type { ContentIndex } from './content-index.ts';
-import type { Platform } from './types.ts';
 /**
  * Resolve a user-supplied site argument to a configured site slug.
  *
@@ -34,26 +33,22 @@ import type { Platform } from './types.ts';
  * An unknown value throws with the list of configured sites.
  */
 export declare function resolveSite(config: DeskworkConfig, site: string | null | undefined): string;
-/** Absolute path to the site's editorial calendar file. */
-export declare function resolveCalendarPath(projectRoot: string, config: DeskworkConfig, site?: string | null): string;
-/** Absolute path to the site's channels file, or undefined when the site declares none. */
-export declare function resolveChannelsPath(projectRoot: string, config: DeskworkConfig, site?: string | null): string | undefined;
-/** Absolute path to the site's blog content directory. */
-export declare function resolveContentDir(projectRoot: string, config: DeskworkConfig, site?: string | null): string;
-/**
- * Bare public hostname for the site (no protocol). Returns `undefined` for
- * collections that aren't published as a website (no `host` configured).
- * Callers needing a non-undefined value for display should fall back to the
- * site slug; callers needing a real URL should throw if undefined.
- */
-export declare function resolveSiteHost(config: DeskworkConfig, site?: string | null): string | undefined;
 /**
- * Canonical public base URL for the site, with trailing slash. Throws when
- * the collection has no `host` configured (i.e. is not published as a
- * website) — callers that need a URL must guarantee the collection is a
- * website-rendered one before calling.
+ * Absolute path to the project's editorial calendar file.
+ *
+ * Phase 39c (sites→lanes retirement) — the calendar is a single,
+ * project-level derived projection from sidecars (spec §"Calendar"). The
+ * legacy per-site `calendarPath` is retired; there is one calendar at
+ * `.deskwork/calendar.md`. The `config`/`site` parameters are retained so
+ * call sites (and the CLI-verb resolution path, scoped to 39c-2b) need
+ * not change in lockstep — the de-parameterization is internal. Both are
+ * intentionally ignored. Closes #234 (divergence), #357 (read-side
+ * validator), #223 (regen flip-flop) per spec §"Inherited calendar-surface
+ * cluster".
  */
-export declare function resolveSiteBaseUrl(config: DeskworkConfig, site?: string | null): string;
+export declare function resolveCalendarPath(projectRoot: string, _config: DeskworkConfig, _site?: string | null): string;
+/** Absolute path to the site's blog content directory. */
+export declare function resolveContentDir(projectRoot: string, config: DeskworkConfig, site?: string | null): string;
 /**
  * Absolute path to the blog post markdown for a given slug.
  *
@@ -112,72 +107,4 @@ export declare function resolveBlogPostDir(projectRoot: string, config: Deskwork
 export declare function findEntryFile(projectRoot: string, config: DeskworkConfig, site: string | null | undefined, entryId: string, index?: ContentIndex, legacyEntryForFallback?: {
     slug: string;
 }): string | undefined;
-/**
- * Resolve the markdown file backing a calendar entry, preferring the
- * UUID frontmatter binding (refactor-proof) and falling back to the
- * site's slug-template only when no binding exists.
- *
- * Equivalent to the studio's `resolveLongformFilePath` but exposed as a
- * top-level helper from `paths.ts` so CLI commands can use it without
- * pulling in `review/` infrastructure. Always returns an absolute path
- * (the slug-template fallback is unconditional); callers should
- * `existsSync` if they need an existence guarantee.
- *
- * Precedence:
- *   1. Content index — when `entryId` is supplied (and non-empty), look
- *      up the file whose frontmatter `deskwork.id:` matches. Refactor-
- *      proof: the binding follows the file regardless of slug rename or
- *      directory relocation.
- *   2. Slug-template fallback — when the index has no record (entry's
- *      file isn't bound to frontmatter yet, e.g. pre-doctor / pre-ingest
- *      state) or no `entryId` was supplied, fall back to
- *      `resolveBlogFilePath(slug)`.
- *
- * @param projectRoot Absolute path to the deskwork project root.
- * @param config Loaded deskwork config.
- * @param site Site slug (or null/undefined for the default site).
- * @param slug Calendar entry slug — used both as the legacy fallback
- *             template input and as a hint for the slug-template fallback.
- * @param entryId Calendar entry's stable UUID. When omitted or empty,
- *                resolution falls straight through to the slug template.
- * @param index Pre-built content index. When omitted, this function
- *              builds one. Pass the per-request memoized index when
- *              calling from the studio; let the CLI build per call.
- */
-export declare function resolveEntryFilePath(projectRoot: string, config: DeskworkConfig, site: string | null | undefined, slug: string, entryId?: string, index?: ContentIndex): string;
-/**
- * Resolve the markdown file path for a shortform draft.
- *
- *   <contentDir>/<entry-dir>/scrapbook/shortform/<platform>[-<channel>].md
- *
- * Platform is the lowercase Platform value. Channel (if present) is appended
- * as `-<channel>`. Channel must validate against the kebab-case regex —
- * deskwork stores channels as kebab-case strings throughout.
- *
- * The entry directory is resolved through `findEntryFile` (id-driven,
- * refactor-proof) with slug-template fallback for legacy entries created
- * pre-doctor. The slug-template fallback is intentional migration logic so
- * pre-bind entries keep working.
- *
- * Forward-compatibility: every reference to the shortform file location
- * goes through this function. Phase 20 (sandbox migration) redirects this
- * single function; everything downstream (handlers, CLI, studio) works
- * unchanged.
- *
- * @param projectRoot Absolute path to the deskwork project root.
- * @param config Loaded deskwork config.
- * @param site Site slug (or null/undefined for the default site).
- * @param entry Calendar entry — `id` preferred, `slug` used both as the
- *              legacy fallback and to identify the entry directory.
- * @param platform Which distribution platform.
- * @param channel Optional sub-channel (e.g. `synthdiy` for r/synthdiy).
- *                Must be kebab-case.
- * @param index Optional pre-built content index (per-request memoization).
- * @returns absolute file path, or undefined when neither the index nor the
- *          slug-template fallback resolves the entry's directory.
- */
-export declare function resolveShortformFilePath(projectRoot: string, config: DeskworkConfig, site: string, entry: {
-    id?: string;
-    slug: string;
-}, platform: Platform, channel?: string, index?: ContentIndex): string | undefined;
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,MAAM,CAYR;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAER;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GACnB,MAAM,CAER;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAOR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,YAAY,EACpB,sBAAsB,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC,MAAM,GAAG,SAAS,CAepB"}