@deskwork/core 0.45.1 → 0.46.0

package/dist/doctor/runner.js

@@ -9,7 +9,7 @@
  * Sibling-relative imports per the project convention.
  */
 import { readCalendar } from "../calendar.js";
-import { buildContentIndex } from "../content-index.js";
+import { buildContentIndexFromSidecars } from "../content-index.js";
 import { resolveCalendarPath } from "../paths.js";
 import { readWorkflows } from "../review/pipeline.js";
 import orphanFrontmatterId from "./rules/orphan-frontmatter-id.js";
@@ -21,6 +21,7 @@ import calendarUuidMissing from "./rules/calendar-uuid-missing.js";
 import legacyTopLevelIdMigration from "./rules/legacy-top-level-id-migration.js";
 import legacyStageArtifactPath from "./rules/legacy-stage-artifact-path.js";
 import laneConfigMissingTemplate from "./rules/lane-config-missing-template.js";
+import sitesToLanesMigration from "./rules/sites-to-lanes-migration.js";
 import entryLaneMissing from "./rules/entry-lane-missing.js";
 import entryAnchorShape from "./rules/entry-anchor-shape.js";
 import entryAddressReasonMissing from "./rules/entry-address-reason-missing.js";
@@ -40,6 +41,7 @@ export const RULES = [
     calendarUuidMissing,
     legacyTopLevelIdMigration,
     legacyStageArtifactPath,
+    sitesToLanesMigration,
     laneConfigMissingTemplate,
     entryLaneMissing,
     entryAnchorShape,
@@ -79,32 +81,35 @@ export function parseFixArgument(arg) {
     }
     return ids;
 }
-/** Build the per-site context once for a run. */
-function buildContext(opts, site, interaction) {
-    const calendarPath = resolveCalendarPath(opts.projectRoot, opts.config, site);
+/**
+ * The single project scope label. Phase 39c collapsed the doctor's
+ * per-site loop (location is no longer the identifying axis — the
+ * sidecar set is the source of truth) into one project pass. Findings
+ * carry this as their `site` label so existing consumers that group by
+ * `finding.site` still see a stable key.
+ */
+export const PROJECT_SCOPE = 'project';
+/** Build the single project-scoped context for a run. */
+async function buildContext(opts, interaction) {
+    // Phase 39c: the calendar is the single project-level
+    // `.deskwork/calendar.md`; the content index is driven by the sidecar
+    // set (the SSOT), not a configured site `contentDir`. Workflows are no
+    // longer site-filtered — the runner exposes the whole workflow store
+    // and the workflow-stale rule reconciles against the single calendar.
+    const calendarPath = resolveCalendarPath(opts.projectRoot, opts.config);
     const calendar = readCalendar(calendarPath);
-    const index = buildContentIndex(opts.projectRoot, opts.config, site);
-    const allWorkflows = readWorkflows(opts.projectRoot, opts.config);
-    const workflows = allWorkflows.filter((w) => w.site === site);
+    const index = await buildContentIndexFromSidecars(opts.projectRoot);
+    const workflows = readWorkflows(opts.projectRoot, opts.config);
     return {
         projectRoot: opts.projectRoot,
         config: opts.config,
-        site,
+        site: PROJECT_SCOPE,
         calendar,
         index,
         workflows,
         interaction,
     };
 }
-function selectSites(opts) {
-    if (opts.site !== undefined) {
-        if (!(opts.site in opts.config.sites)) {
-            throw new Error(`Unknown site "${opts.site}". Configured sites: ${Object.keys(opts.config.sites).join(', ')}`);
-        }
-        return [opts.site];
-    }
-    return Object.keys(opts.config.sites);
-}
 function selectRules(available, ruleIds) {
     if (ruleIds === undefined)
         return [...available];
@@ -133,24 +138,31 @@ async function buildEffectiveRules(projectRoot) {
     const projectRules = await loadProjectRules(projectRoot);
     return mergeRules(RULES, projectRules);
 }
+/**
+ * Shared setup for both doctor entry points: resolve the effective rule
+ * set (built-ins + project overrides, filtered by `ruleIds`) and build the
+ * run context. `runAudit` and `runRepair` differ only in what they DO with
+ * the rules + ctx, not in how they obtain them.
+ */
+async function prepareRun(opts, interaction) {
+    const available = await buildEffectiveRules(opts.projectRoot);
+    const rules = selectRules(available, opts.ruleIds);
+    const ctx = await buildContext(opts, interaction);
+    return { rules, ctx };
+}
 /**
  * Audit: collect findings without mutating the world. Returns a fully-
  * built report with empty `repairs`. Suitable for pre-commit hooks
  * that just want a non-zero exit code on any finding.
  */
 export async function runAudit(opts, interaction) {
-    const sites = selectSites(opts);
-    const available = await buildEffectiveRules(opts.projectRoot);
-    const rules = selectRules(available, opts.ruleIds);
+    const { rules, ctx } = await prepareRun(opts, interaction);
     const findings = [];
-    for (const site of sites) {
-        const ctx = buildContext(opts, site, interaction);
-        for (const rule of rules) {
-            const out = await rule.audit(ctx);
-            findings.push(...out);
-        }
+    for (const rule of rules) {
+        const out = await rule.audit(ctx);
+        findings.push(...out);
     }
-    return { findings, repairs: [], sites };
+    return { findings, repairs: [], sites: [PROJECT_SCOPE] };
 }
 /**
  * Repair: run audit → plan → (consult interaction) → apply. Returns
@@ -162,24 +174,19 @@ export async function runAudit(opts, interaction) {
  * `interaction.confirmApply`. `report-only` plans never apply.
  */
 export async function runRepair(opts, interaction) {
-    const sites = selectSites(opts);
-    const available = await buildEffectiveRules(opts.projectRoot);
-    const rules = selectRules(available, opts.ruleIds);
+    const { rules, ctx } = await prepareRun(opts, interaction);
     const findings = [];
     const repairs = [];
-    for (const site of sites) {
-        const ctx = buildContext(opts, site, interaction);
-        for (const rule of rules) {
-            const ruleFindings = await rule.audit(ctx);
-            findings.push(...ruleFindings);
-            for (const finding of ruleFindings) {
-                const plan = await rule.plan(ctx, finding);
-                const result = await resolveAndApply(rule, ctx, plan, interaction);
-                repairs.push(result);
-            }
+    for (const rule of rules) {
+        const ruleFindings = await rule.audit(ctx);
+        findings.push(...ruleFindings);
+        for (const finding of ruleFindings) {
+            const plan = await rule.plan(ctx, finding);
+            const result = await resolveAndApply(rule, ctx, plan, interaction);
+            repairs.push(result);
         }
     }
-    return { findings, repairs, sites };
+    return { findings, repairs, sites: [PROJECT_SCOPE] };
 }
 /**
  * Resolve a `prompt` plan via the interaction adapter and apply it.

package/dist/doctor/runner.js.map

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

package/dist/doctor/sites-migration-backfill.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Sites-to-lanes migration backfiller (Phase 39b).
+ *
+ * This is the LAST legitimate use of the slug+stage heuristic (per the
+ * sites→lanes retirement spec §"Migration" step 2). For every entry
+ * lacking `artifactPath`, it derives the artifact location ONCE from the
+ * current resolved location and stamps it onto the sidecar.
+ *
+ * AMBIGUITY-HALT (AUDIT-20260602-03 — the critical guard):
+ *
+ *   The heuristic is the SAME slug+stage search that causes the #394
+ *   multi-site false-positive. When a slug exists under more than one
+ *   legacy `site.contentDir` (or on more than one filesystem), the
+ *   heuristic resolves to MORE THAN ONE candidate file. The migration
+ *   MUST NOT silently stamp one of them — doing so would launder a
+ *   known-ambiguous guess into permanent, trusted `artifactPath` data
+ *   and make the bug undetectable afterward (no more search to flag it).
+ *
+ *   So this backfiller enumerates ALL candidate files across EVERY
+ *   legacy `site.contentDir` for the entry's slug+stage. Only an
+ *   entry with EXACTLY ONE candidate is stamped. An entry with two or
+ *   more candidates is REFUSED: it is reported on `ambiguous[]` with the
+ *   colliding paths, requiring operator disambiguation. An entry with
+ *   zero candidates is reported on `noCandidate[]` (nothing on disk to
+ *   stamp from). Never guess.
+ *
+ * The pre-existing `repair.ts:backfillArtifactPaths` checked exactly one
+ * heuristic path (a single base dir). This widens that to a
+ * multi-candidate search across every legacy contentDir precisely so it
+ * can DETECT the collision it must refuse to launder.
+ *
+ * Sibling-relative imports per the doctor convention.
+ */
+/**
+ * One legacy content base the backfiller searches, paired with the lane
+ * id the migration assigns to entries resolving under it. `laneId` is the
+ * legacy site slug (= the lane id `laneFromSite` creates). Threading the
+ * lane id through the search lets the backfiller stamp BOTH `artifactPath`
+ * AND `lane` on an unambiguously-resolved entry (AUDIT-20260603-12), so a
+ * migrated entry is not left lane-less for `entry-lane-missing` to flag.
+ */
+export interface LaneBase {
+    readonly laneId: string;
+    readonly contentDir: string;
+}
+/** One entry the migration could not stamp because the slug+stage search
+ *  resolved to more than one candidate (the #394 collision). */
+export interface AmbiguousBackfill {
+    readonly entryUuid: string;
+    readonly slug: string;
+    readonly stage: string;
+    /** Project-relative candidate paths — operator must disambiguate. */
+    readonly candidates: readonly string[];
+}
+/** Result of the backfill pass. */
+export interface BackfillResult {
+    /** UUIDs whose sidecar was stamped with a single unambiguous path. */
+    readonly stamped: readonly string[];
+    /** Entries refused because >1 candidate existed (ambiguity-halt). */
+    readonly ambiguous: readonly AmbiguousBackfill[];
+}
+export declare function backfillFromLegacySites(projectRoot: string, bases: readonly LaneBase[]): Promise<BackfillResult>;
+/**
+ * Audit-only variant: enumerate the ambiguity collisions WITHOUT writing
+ * anything. Used by the doctor rule's `audit()` to surface
+ * `migration-ambiguous` findings before any `--fix` mutation. Shares
+ * `planBackfills` with the apply path so the audit and the apply agree on
+ * what is ambiguous by construction.
+ */
+export declare function detectAmbiguousBackfills(projectRoot: string, bases: readonly LaneBase[]): Promise<AmbiguousBackfill[]>;
+//# sourceMappingURL=sites-migration-backfill.d.ts.map

package/dist/doctor/sites-migration-backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sites-migration-backfill.d.ts","sourceRoot":"","sources":["../../src/doctor/sites-migration-backfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAmDH;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAkCD;gEACgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAsDD,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,OAAO,CAAC,cAAc,CAAC,CAmBzB;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,QAAQ,EAAE,GACzB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAS9B"}

package/dist/doctor/sites-migration-backfill.js

@@ -0,0 +1,164 @@
+/**
+ * Sites-to-lanes migration backfiller (Phase 39b).
+ *
+ * This is the LAST legitimate use of the slug+stage heuristic (per the
+ * sites→lanes retirement spec §"Migration" step 2). For every entry
+ * lacking `artifactPath`, it derives the artifact location ONCE from the
+ * current resolved location and stamps it onto the sidecar.
+ *
+ * AMBIGUITY-HALT (AUDIT-20260602-03 — the critical guard):
+ *
+ *   The heuristic is the SAME slug+stage search that causes the #394
+ *   multi-site false-positive. When a slug exists under more than one
+ *   legacy `site.contentDir` (or on more than one filesystem), the
+ *   heuristic resolves to MORE THAN ONE candidate file. The migration
+ *   MUST NOT silently stamp one of them — doing so would launder a
+ *   known-ambiguous guess into permanent, trusted `artifactPath` data
+ *   and make the bug undetectable afterward (no more search to flag it).
+ *
+ *   So this backfiller enumerates ALL candidate files across EVERY
+ *   legacy `site.contentDir` for the entry's slug+stage. Only an
+ *   entry with EXACTLY ONE candidate is stamped. An entry with two or
+ *   more candidates is REFUSED: it is reported on `ambiguous[]` with the
+ *   colliding paths, requiring operator disambiguation. An entry with
+ *   zero candidates is reported on `noCandidate[]` (nothing on disk to
+ *   stamp from). Never guess.
+ *
+ * The pre-existing `repair.ts:backfillArtifactPaths` checked exactly one
+ * heuristic path (a single base dir). This widens that to a
+ * multi-candidate search across every legacy contentDir precisely so it
+ * can DETECT the collision it must refuse to launder.
+ *
+ * Sibling-relative imports per the doctor convention.
+ */
+import { stat } from 'node:fs/promises';
+import { isAbsolute, join, relative } from 'node:path';
+import { sidecarsDir } from "../sidecar/paths.js";
+import { writeSidecar } from "../sidecar/write.js";
+import { readAllSidecars } from "../sidecar/read-all.js";
+/**
+ * Stage-conventional artifact leaf path RELATIVE to a content base dir.
+ * Mirrors the heuristic in `repair.ts` / `validate.ts` but parameterized
+ * over the base dir (each legacy `site.contentDir`) instead of hardcoding
+ * `docs/`. Returns null for stages with no on-disk artifact.
+ *
+ * Path shape per slug+stage:
+ *   - Ideas      → <slug>/scrapbook/idea.md
+ *   - Planned    → <slug>/scrapbook/plan.md
+ *   - Outlining  → <slug>/scrapbook/outline.md
+ *   - Drafting / Final / Published → <slug>/index.md
+ *   - Blocked / Cancelled / other  → null (no editorial-default path)
+ */
+function stageRelativeLeaf(slug, stage) {
+    switch (stage) {
+        case 'Ideas':
+            return join(slug, 'scrapbook', 'idea.md');
+        case 'Planned':
+            return join(slug, 'scrapbook', 'plan.md');
+        case 'Outlining':
+            return join(slug, 'scrapbook', 'outline.md');
+        case 'Drafting':
+        case 'Final':
+        case 'Published':
+            return join(slug, 'index.md');
+        default:
+            return null;
+    }
+}
+async function fileExists(absPath) {
+    return stat(absPath).then((s) => s.isFile(), () => false);
+}
+/** Resolve a legacy contentDir to an absolute path under the project. */
+function contentDirAbs(projectRoot, contentDir) {
+    return isAbsolute(contentDir) ? contentDir : join(projectRoot, contentDir);
+}
+/**
+ * Enumerate EVERY on-disk candidate for an entry's slug+stage across all
+ * legacy content bases. Returns project-relative paths (the form stored on
+ * the sidecar) paired with the owning lane id, de-duplicated by path and
+ * in stable order.
+ */
+async function enumerateCandidates(projectRoot, bases, entry) {
+    const leaf = stageRelativeLeaf(entry.slug, entry.currentStage);
+    if (leaf === null)
+        return [];
+    const seen = new Set();
+    const out = [];
+    for (const base of bases) {
+        const abs = join(contentDirAbs(projectRoot, base.contentDir), leaf);
+        if (!(await fileExists(abs)))
+            continue;
+        const rel = relative(projectRoot, abs);
+        if (seen.has(rel))
+            continue;
+        seen.add(rel);
+        out.push({ path: rel, laneId: base.laneId });
+    }
+    return out;
+}
+/** The shared backfill plan — what would be stamped + what is ambiguous.
+ *  Pure read: enumerates candidates, classifies each entry, writes nothing.
+ *  Both `backfillFromLegacySites` (apply) and `detectAmbiguousBackfills`
+ *  (audit) derive from this, so audit and apply agree by construction. */
+async function planBackfills(projectRoot, bases) {
+    const entries = await readAllSidecars(projectRoot);
+    const toStamp = [];
+    const ambiguous = [];
+    for (const entry of entries) {
+        if (entry.artifactPath !== undefined && entry.artifactPath !== '')
+            continue;
+        const candidates = await enumerateCandidates(projectRoot, bases, entry);
+        if (candidates.length === 0)
+            continue;
+        if (candidates.length > 1) {
+            ambiguous.push({
+                entryUuid: entry.uuid,
+                slug: entry.slug,
+                stage: entry.currentStage,
+                candidates: candidates.map((c) => c.path),
+            });
+            continue;
+        }
+        toStamp.push({ entry, path: candidates[0].path, laneId: candidates[0].laneId });
+    }
+    return { toStamp, ambiguous };
+}
+export async function backfillFromLegacySites(projectRoot, bases) {
+    const { toStamp, ambiguous } = await planBackfills(projectRoot, bases);
+    const stamped = [];
+    for (const { entry, path, laneId } of toStamp) {
+        const updated = {
+            ...entry,
+            artifactPath: path,
+            // Assign the entry to the lane the migration created for its owning
+            // site (AUDIT-20260603-12). Without this, the migrated entry stays
+            // lane-less and `entry-lane-missing` flags it as an error in the
+            // very same `--fix=all` run. Only set when the entry has no lane;
+            // an entry already on a lane keeps its membership.
+            ...(entry.lane === undefined ? { lane: laneId } : {}),
+            updatedAt: new Date().toISOString(),
+        };
+        await writeSidecar(projectRoot, updated);
+        stamped.push(entry.uuid);
+    }
+    return { stamped, ambiguous };
+}
+/**
+ * Audit-only variant: enumerate the ambiguity collisions WITHOUT writing
+ * anything. Used by the doctor rule's `audit()` to surface
+ * `migration-ambiguous` findings before any `--fix` mutation. Shares
+ * `planBackfills` with the apply path so the audit and the apply agree on
+ * what is ambiguous by construction.
+ */
+export async function detectAmbiguousBackfills(projectRoot, bases) {
+    // The sidecars dir may not exist yet; treat absence as "no entries".
+    try {
+        await stat(sidecarsDir(projectRoot));
+    }
+    catch {
+        return [];
+    }
+    const { ambiguous } = await planBackfills(projectRoot, bases);
+    return ambiguous;
+}
+//# sourceMappingURL=sites-migration-backfill.js.map

package/dist/doctor/sites-migration-backfill.js.map

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

package/dist/doctor/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/doctor/validate.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EACJ,QAAQ,GACR,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,WAAW,GACX,uBAAuB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AA4eD,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYhF"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/doctor/validate.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EACJ,QAAQ,GACR,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,WAAW,GACX,uBAAuB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAqcD,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYhF"}

package/dist/doctor/validate.js

@@ -3,6 +3,7 @@ import { join } from 'node:path';
 import { EntrySchema, isLinearPipelineStage, isOffPipelineStage, } from "../schema/entry.js";
 import { extractEntriesForMigration } from "../calendar/parse.js";
 import { readJournalEvents } from "../journal/read.js";
+import { resolveStoredArtifactPath } from "../entry/resolve-artifact.js";
 async function validateSchema(projectRoot) {
     const failures = [];
     const dir = join(projectRoot, '.deskwork', 'entries');
@@ -48,15 +49,11 @@ async function readSidecarUuids(projectRoot) {
 }
 async function validateCalendarSidecar(projectRoot) {
     const failures = [];
-    // NOTE (#232 residual — tracked in #357): this entry-centric
-    // sidecar-consistency check reads the hardcoded `.deskwork/calendar.md`,
-    // NOT the per-site `calendarPath`. regenerate/repair now write the
-    // configured calendar (#232), so for a custom calendarPath this `--check`
-    // reads the wrong file and returns false-clean. Fixing it requires
-    // deciding whether the entry-centric calendar and the per-site
-    // calendarPath are one surface or two (entangled with #234); see #357.
-    // For the default config (calendarPath == .deskwork/calendar.md) the two
-    // coincide and there is no gap.
+    // This entry-centric check reads the single project calendar at
+    // `.deskwork/calendar.md`. Per the sites→lanes retirement spec §"Calendar"
+    // the calendar is a single derived projection (per-site `calendarPath` is
+    // retired); the de-parameterization of regenerate/repair lands in 39c
+    // (#223/#234/#357). This read-side target already matches that endpoint.
     const calendarPath = join(projectRoot, '.deskwork', 'calendar.md');
     let md;
     try {
@@ -138,51 +135,19 @@ async function loadSidecars(projectRoot) {
     return out;
 }
 /**
- * Stage-conventional artifact path. Returns null when a stage does not have a
- * primary on-disk artifact (e.g. Blocked / Cancelled) OR when the stage is
- * outside the editorial pipeline's eight known values (per Phase 3 / Phase
- * 4 — lane-aware path conventions land in the lane code, not in this
- * editorial-specific heuristic).
+ * Resolve the on-disk artifact path for an entry — STORED PATH ONLY
+ * (Phase 39d, sites→lanes retirement).
  *
- * Note: Published shares the Drafting/Final path (`docs/<slug>/index.md`).
- */
-function artifactPathForStage(projectRoot, slug, stage) {
-    switch (stage) {
-        case 'Ideas':
-            return join(projectRoot, 'docs', slug, 'scrapbook', 'idea.md');
-        case 'Planned':
-            return join(projectRoot, 'docs', slug, 'scrapbook', 'plan.md');
-        case 'Outlining':
-            return join(projectRoot, 'docs', slug, 'scrapbook', 'outline.md');
-        case 'Drafting':
-        case 'Final':
-        case 'Published':
-            return join(projectRoot, 'docs', slug, 'index.md');
-        case 'Blocked':
-        case 'Cancelled':
-            return null;
-        default:
-            // Lane-specific or unrecognized stage; no editorial-default path
-            // applies. Phase 4 introduces template-driven path resolution.
-            return null;
-    }
-}
-/**
- * Resolve the on-disk artifact path for an entry.
- *
- * Precedence:
- *   1. entry.artifactPath (when set — see #140 / migration)
- *   2. slug+stage heuristic (`artifactPathForStage`) for entries without
- *      an explicit path. Off-pipeline stages (Blocked / Cancelled) still
- *      return null.
- *
- * Returns null when no artifact is expected for this stage.
+ * Per the spec §"Resolution": `entry.artifactPath` → the file, full
+ * stop. There is no base-searching and no slug+stage heuristic, so the
+ * #394-class multi-site ambiguity cannot recur. An entry that lacks
+ * `artifactPath` resolves to `null` here (callers treat null as "no
+ * artifact to check"); the `missing-artifact-path` rule surfaces the
+ * gap and the 39b migration backfiller (`sites-migration-backfill.ts`)
+ * owns stamping it — the runtime resolver never guesses.
  */
 function resolveArtifactPath(projectRoot, entry) {
-    if (entry.artifactPath) {
-        return join(projectRoot, entry.artifactPath);
-    }
-    return artifactPathForStage(projectRoot, entry.slug, entry.currentStage);
+    return resolveStoredArtifactPath(entry, projectRoot);
 }
 /**
  * Minimal frontmatter `deskwork.stage` extractor.
@@ -326,24 +291,22 @@ async function validateIterationHistory(projectRoot) {
     return failures;
 }
 /**
- * #182 Phase 34 ship-pass — surface entries that lack `artifactPath`
- * but DO have a discoverable file via the slug+stage heuristic.
+ * Surface entries that lack `artifactPath` on a stage that expects an
+ * on-disk artifact.
  *
- * Pre-fix, these entries worked at request time (via the
- * `resolveArtifactPath` heuristic fallback) but the path was
- * re-derived on every read. Stamping `artifactPath` into the sidecar
- * makes the binding explicit + survives slug renames + lets the
- * version-strip / scrapbook / audit layers stop guessing.
+ * Phase 39d (sites→lanes retirement): resolution reads the stored path
+ * ONLY — the runtime no longer derives a path from the slug+stage
+ * heuristic, so this rule no longer SUGGESTS a heuristic location.
+ * It reports the missing field and points the operator at the migration
+ * backfiller, which is the spec-sanctioned LAST use of the heuristic
+ * (`sites-migration-backfill.ts`, 39b). The migration enumerates
+ * candidates across legacy content dirs, halts on ambiguity, and stamps
+ * the unambiguous ones.
  *
  * Returns nothing for entries that:
- *   - Already have artifactPath set (no gap).
- *   - Have a stage with no on-disk artifact (Blocked / Cancelled).
- *   - Have a heuristic path that doesn't exist on disk (file-presence
- *     handles those — backfilling a non-existent path would be
- *     misleading).
- *
- * Repair: write `artifactPath = <heuristic-relative-path>` into the
- * sidecar.
+ *   - Already have a non-empty `artifactPath` (no gap).
+ *   - Are at an off-pipeline stage with no on-disk artifact
+ *     (Blocked / Cancelled) — those legitimately carry no path.
  */
 async function validateMissingArtifactPath(projectRoot) {
     const failures = [];
@@ -351,16 +314,14 @@ async function validateMissingArtifactPath(projectRoot) {
     for (const { entry, path } of sidecars) {
         if (entry.artifactPath !== undefined && entry.artifactPath !== '')
             continue;
-        const heuristic = artifactPathForStage(projectRoot, entry.slug, entry.currentStage);
-        if (!heuristic)
-            continue;
-        if (!(await fileExists(heuristic)))
+        // Off-pipeline stages (Blocked / Cancelled) carry no on-disk
+        // artifact, so a missing artifactPath is expected, not a gap.
+        if (isOffPipelineStage(entry.currentStage))
             continue;
-        // Sidecar lacks artifactPath; the heuristic resolves and the file
-        // exists — this is a backfillable case.
         failures.push({
             category: 'missing-artifact-path',
-            message: `sidecar lacks artifactPath; heuristic resolves to ${heuristic} (run with --fix=all to stamp)`,
+            message: `sidecar lacks artifactPath (currentStage=${entry.currentStage}); ` +
+                `run \`deskwork doctor --fix\` to backfill it from the sites→lanes migration`,
             entryId: entry.uuid,
             path,
         });