@deskwork/core 0.9.5

package/dist/doctor/rules/orphan-frontmatter-id.js

@@ -0,0 +1,154 @@
+/**
+ * Rule: orphan-frontmatter-id.
+ *
+ * Audit: every entry in the content index whose id has no matching
+ * calendar entry. The file is bound to "something", but the calendar
+ * doesn't know about it.
+ *
+ * Repair: there are three plausible operator intents — (a) add a
+ * calendar row for the file, (b) clear the orphan id from the file
+ * (un-bind), or (c) leave it alone. Without a way to gather the
+ * intent, the rule reports findings and presents a prompt; with
+ * `--yes`, the safest action is "do nothing" — auto-creating
+ * calendar rows or auto-deleting frontmatter is destructive.
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { relative } from 'node:path';
+import { parseFrontmatter, removeFrontmatterPaths } from "../../frontmatter.js";
+const RULE_ID = 'orphan-frontmatter-id';
+/**
+ * Clear the `deskwork.id` field from a markdown file's frontmatter.
+ * Returns true when the field was present and cleared; false when there
+ * was nothing to clear. Issue #38: scoped to the namespaced key — top-
+ * level `id:` belongs to the operator and is left alone.
+ *
+ * Uses the round-trip-preserving emitter so untouched keys keep their
+ * exact bytes (quoting, comments, ordering). Empty `deskwork:` blocks
+ * are pruned via `removeFrontmatterPaths`.
+ */
+function clearFrontmatterId(absPath) {
+    const raw = readFileSync(absPath, 'utf-8');
+    const { data } = parseFrontmatter(raw);
+    const block = data.deskwork;
+    if (block === undefined || block === null)
+        return false;
+    if (typeof block !== 'object' || Array.isArray(block))
+        return false;
+    const blockObj = block;
+    if (!('id' in blockObj))
+        return false;
+    const updated = removeFrontmatterPaths(raw, [['deskwork', 'id']]);
+    if (updated === raw)
+        return false;
+    writeFileSync(absPath, updated, 'utf-8');
+    return true;
+}
+const rule = {
+    id: RULE_ID,
+    label: 'Files with frontmatter ids that are not in the calendar',
+    async audit(ctx) {
+        const findings = [];
+        const calendarIds = new Set();
+        for (const e of ctx.calendar.entries) {
+            if (e.id)
+                calendarIds.add(e.id);
+        }
+        for (const [id, absPath] of ctx.index.byId) {
+            if (calendarIds.has(id))
+                continue;
+            findings.push({
+                ruleId: RULE_ID,
+                site: ctx.site,
+                severity: 'warning',
+                message: `File ${relative(ctx.projectRoot, absPath)} carries id ${id}, which is not in the calendar`,
+                details: { absolutePath: absPath, entryId: id },
+            });
+        }
+        return findings;
+    },
+    async plan(_ctx, finding) {
+        const absPath = String(finding.details.absolutePath ?? '');
+        const entryId = String(finding.details.entryId ?? '');
+        return {
+            kind: 'prompt',
+            finding,
+            question: `File ${absPath} has id ${entryId} but no calendar entry matches. Pick an action:`,
+            choices: [
+                {
+                    id: 'none',
+                    label: 'leave as-is (default; review manually)',
+                    payload: { action: 'none' },
+                },
+                {
+                    id: 'clear-id',
+                    label: `clear the id from ${absPath} (un-bind the file)`,
+                    payload: { action: 'clear-id', absolutePath: absPath },
+                },
+            ],
+        };
+    },
+    async apply(ctx, plan) {
+        if (plan.kind !== 'apply') {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'plan is not directly appliable; runner should resolve prompt first',
+                skipReason: 'apply-failed',
+            };
+        }
+        const action = String(plan.payload.action ?? '');
+        if (action === 'none') {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'left file unchanged per operator choice',
+                skipReason: 'no-action-needed',
+            };
+        }
+        if (action === 'clear-id') {
+            const absPath = String(plan.payload.absolutePath ?? '');
+            if (!absPath) {
+                return {
+                    finding: plan.finding,
+                    applied: false,
+                    message: 'clear-id apply payload missing absolutePath',
+                    skipReason: 'apply-failed',
+                };
+            }
+            try {
+                const changed = clearFrontmatterId(absPath);
+                if (!changed) {
+                    return {
+                        finding: plan.finding,
+                        applied: false,
+                        message: `no id field in ${relative(ctx.projectRoot, absPath)} to clear`,
+                        skipReason: 'no-action-needed',
+                    };
+                }
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                return {
+                    finding: plan.finding,
+                    applied: false,
+                    message: `failed to clear frontmatter id: ${reason}`,
+                    skipReason: 'apply-failed',
+                };
+            }
+            return {
+                finding: plan.finding,
+                applied: true,
+                message: `cleared id from ${relative(ctx.projectRoot, absPath)}`,
+                details: { absolutePath: absPath },
+            };
+        }
+        return {
+            finding: plan.finding,
+            applied: false,
+            message: `unknown apply action: ${action}`,
+            skipReason: 'apply-failed',
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=orphan-frontmatter-id.js.map

package/dist/doctor/rules/orphan-frontmatter-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-frontmatter-id.js","sourceRoot":"","sources":["../../../src/doctor/rules/orphan-frontmatter-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAShF,MAAM,OAAO,GAAG,uBAAuB,CAAC;AAExC;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpE,MAAM,QAAQ,GAAG,KAAgC,CAAC;IAClD,IAAI,CAAC,CAAC,IAAI,IAAI,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAClC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,yDAAyD;IAEhE,KAAK,CAAC,KAAK,CAAC,GAAkB;QAC5B,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,CAAC,CAAC,EAAE;gBAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YAClC,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,QAAQ,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,eAAe,EAAE,gCAAgC;gBACpG,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAmB,EAAE,OAAgB;QAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO;YACP,QAAQ,EAAE,QAAQ,OAAO,WAAW,OAAO,iDAAiD;YAC5F,OAAO,EAAE;gBACP;oBACE,EAAE,EAAE,MAAM;oBACV,KAAK,EAAE,wCAAwC;oBAC/C,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;iBAC5B;gBACD;oBACE,EAAE,EAAE,UAAU;oBACd,KAAK,EAAE,qBAAqB,OAAO,qBAAqB;oBACxD,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE;iBACvD;aACF;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAkB,EAAE,IAAgB;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,oEAAoE;gBAC7E,UAAU,EAAE,cAAc;aAC3B,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,yCAAyC;gBAClD,UAAU,EAAE,kBAAkB;aAC/B,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,6CAA6C;oBACtD,UAAU,EAAE,cAAc;iBAC3B,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO;wBACL,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,OAAO,EAAE,KAAK;wBACd,OAAO,EAAE,kBAAkB,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,WAAW;wBACxE,UAAU,EAAE,kBAAkB;qBAC/B,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,OAAO;oBACL,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,mCAAmC,MAAM,EAAE;oBACpD,UAAU,EAAE,cAAc;iBAC3B,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,mBAAmB,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE;gBAChE,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE;aACnC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,yBAAyB,MAAM,EAAE;YAC1C,UAAU,EAAE,cAAc;SAC3B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/schema-rejected.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Rule: schema-rejected.
+ *
+ * The host's content collection schema may reject the `id` frontmatter
+ * field that deskwork relies on for the calendar/file binding. We
+ * detect this at *write time* in other code paths (scaffolder, the
+ * other rules' apply()), not by an active probe — running an actual
+ * Astro build inside doctor would be slow and project-specific.
+ *
+ * This rule's audit always returns empty for that reason. The
+ * `printSchemaPatchInstructions` helper is the user-facing surface;
+ * other rules (and the CLI command) call it when they observe an
+ * actual schema rejection. Phase 19b-followup may add an active
+ * probe (write a tmpfile to contentDir, attempt astro check, etc.)
+ * once the integration cost is justified.
+ */
+import type { DoctorRule } from '../types.ts';
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=schema-rejected.d.ts.map

package/dist/doctor/rules/schema-rejected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-rejected.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/schema-rejected.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAEV,UAAU,EAIX,MAAM,aAAa,CAAC;AAIrB,QAAA,MAAM,IAAI,EAAE,UA2BX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/schema-rejected.js

@@ -0,0 +1,44 @@
+/**
+ * Rule: schema-rejected.
+ *
+ * The host's content collection schema may reject the `id` frontmatter
+ * field that deskwork relies on for the calendar/file binding. We
+ * detect this at *write time* in other code paths (scaffolder, the
+ * other rules' apply()), not by an active probe — running an actual
+ * Astro build inside doctor would be slow and project-specific.
+ *
+ * This rule's audit always returns empty for that reason. The
+ * `printSchemaPatchInstructions` helper is the user-facing surface;
+ * other rules (and the CLI command) call it when they observe an
+ * actual schema rejection. Phase 19b-followup may add an active
+ * probe (write a tmpfile to contentDir, attempt astro check, etc.)
+ * once the integration cost is justified.
+ */
+import { printSchemaPatchInstructions } from "../schema-patch.js";
+const RULE_ID = 'schema-rejected';
+const rule = {
+    id: RULE_ID,
+    label: "Host's content schema rejects the `id` frontmatter field",
+    async audit(_ctx) {
+        // Passive — see file header. Other code paths surface schema-patch
+        // instructions when they observe an actual rejection.
+        return [];
+    },
+    async plan(_ctx, finding) {
+        return {
+            kind: 'report-only',
+            finding,
+            reason: printSchemaPatchInstructions(),
+        };
+    },
+    async apply(_ctx, plan) {
+        return {
+            finding: plan.finding,
+            applied: false,
+            message: 'schema-rejected has no automatic repair — operator must patch the host content schema',
+            skipReason: 'schema-rejected',
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=schema-rejected.js.map

package/dist/doctor/rules/schema-rejected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-rejected.js","sourceRoot":"","sources":["../../../src/doctor/rules/schema-rejected.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AASlE,MAAM,OAAO,GAAG,iBAAiB,CAAC;AAElC,MAAM,IAAI,GAAe;IACvB,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,0DAA0D;IAEjE,KAAK,CAAC,KAAK,CAAC,IAAmB;QAC7B,mEAAmE;QACnE,sDAAsD;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAmB,EAAE,OAAgB;QAC9C,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,OAAO;YACP,MAAM,EAAE,4BAA4B,EAAE;SACvC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAmB,EAAE,IAAgB;QAC/C,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,KAAK;YACd,OAAO,EACL,uFAAuF;YACzF,UAAU,EAAE,iBAAiB;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/slug-collision.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Rule: slug-collision.
+ *
+ * Audit: two or more calendar entries share the same slug. With UUID
+ * identity this is no longer a hard error (joins go through id), but
+ * it's still a bug — the host renderer maps URLs by slug, so two
+ * entries claiming the same slug produces duplicate or hidden public
+ * URLs.
+ *
+ * Repair: rename one slug. Doctor doesn't pick which one — that's an
+ * editorial decision (which entry "owns" the public URL). The rule
+ * reports findings; with no interactive UI it returns `report-only`.
+ * `--yes` mode skips.
+ */
+import type { DoctorRule } from '../types.ts';
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=slug-collision.d.ts.map

package/dist/doctor/rules/slug-collision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-collision.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/slug-collision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAEV,UAAU,EAIX,MAAM,aAAa,CAAC;AAyBrB,QAAA,MAAM,IAAI,EAAE,UAiCX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/slug-collision.js

@@ -0,0 +1,65 @@
+/**
+ * Rule: slug-collision.
+ *
+ * Audit: two or more calendar entries share the same slug. With UUID
+ * identity this is no longer a hard error (joins go through id), but
+ * it's still a bug — the host renderer maps URLs by slug, so two
+ * entries claiming the same slug produces duplicate or hidden public
+ * URLs.
+ *
+ * Repair: rename one slug. Doctor doesn't pick which one — that's an
+ * editorial decision (which entry "owns" the public URL). The rule
+ * reports findings; with no interactive UI it returns `report-only`.
+ * `--yes` mode skips.
+ */
+const RULE_ID = 'slug-collision';
+function findCollisions(ctx) {
+    const bySlug = new Map();
+    for (const e of ctx.calendar.entries) {
+        if (!e.slug)
+            continue;
+        const list = bySlug.get(e.slug);
+        if (list)
+            list.push(e.id ?? '');
+        else
+            bySlug.set(e.slug, [e.id ?? '']);
+    }
+    const out = [];
+    for (const [slug, ids] of bySlug) {
+        if (ids.length > 1)
+            out.push({ slug, entryIds: ids });
+    }
+    return out;
+}
+const rule = {
+    id: RULE_ID,
+    label: 'Duplicate slugs in the calendar',
+    async audit(ctx) {
+        return findCollisions(ctx).map((g) => ({
+            ruleId: RULE_ID,
+            site: ctx.site,
+            severity: 'error',
+            message: `slug "${g.slug}" is shared by ${g.entryIds.length} calendar entries`,
+            details: { slug: g.slug, entryIds: g.entryIds },
+        }));
+    },
+    async plan(_ctx, finding) {
+        return {
+            kind: 'report-only',
+            finding,
+            reason: 'pick which entry owns the slug and rename the others via `deskwork rename-slug` ' +
+                '(or hand-edit the calendar). Doctor refuses to choose automatically — slug is ' +
+                'host-public-URL, an editorial decision.',
+        };
+    },
+    async apply(_ctx, plan) {
+        return {
+            finding: plan.finding,
+            applied: false,
+            message: 'slug-collision has no automatic repair (operator must rename)',
+            skipReason: 'editorial-decision',
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=slug-collision.js.map

package/dist/doctor/rules/slug-collision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-collision.js","sourceRoot":"","sources":["../../../src/doctor/rules/slug-collision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAQjC,SAAS,cAAc,CAAC,GAAkB;IACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,SAAS;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;YAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;QACjC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,iCAAiC;IAExC,KAAK,CAAC,KAAK,CAAC,GAAkB;QAC5B,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,SAAS,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,QAAQ,CAAC,MAAM,mBAAmB;YAC9E,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;SAChD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAmB,EAAE,OAAgB;QAC9C,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,OAAO;YACP,MAAM,EACJ,kFAAkF;gBAClF,gFAAgF;gBAChF,yCAAyC;SAC5C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAmB,EAAE,IAAgB;QAC/C,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,+DAA+D;YACxE,UAAU,EAAE,oBAAoB;SACjC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/workflow-stale.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Rule: workflow-stale.
+ *
+ * Audit: a `DraftWorkflowItem` whose `(site, slug)` no longer resolves
+ * to a calendar entry on the workflow's site. Two failure modes:
+ *   - The entry was deleted from the calendar (truly stale).
+ *   - The entry's slug was renamed and the workflow predates the rename.
+ *
+ * Detecting the slug-rename case requires `entryId` on the workflow —
+ * not yet present on legacy records. For now the rule reports only
+ * "no entry found by site+slug" findings and ignores the rename case.
+ *
+ * Repair: clear the stale workflow record from the pipeline journal.
+ * The history journal is append-only and stays untouched (provenance).
+ * `--yes` applies; interactive prompts before deletion.
+ */
+import type { DoctorRule } from '../types.ts';
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=workflow-stale.d.ts.map

package/dist/doctor/rules/workflow-stale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-stale.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/workflow-stale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAEV,UAAU,EAIX,MAAM,aAAa,CAAC;AA6CrB,QAAA,MAAM,IAAI,EAAE,UA+EX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/workflow-stale.js

@@ -0,0 +1,136 @@
+/**
+ * Rule: workflow-stale.
+ *
+ * Audit: a `DraftWorkflowItem` whose `(site, slug)` no longer resolves
+ * to a calendar entry on the workflow's site. Two failure modes:
+ *   - The entry was deleted from the calendar (truly stale).
+ *   - The entry's slug was renamed and the workflow predates the rename.
+ *
+ * Detecting the slug-rename case requires `entryId` on the workflow —
+ * not yet present on legacy records. For now the rule reports only
+ * "no entry found by site+slug" findings and ignores the rename case.
+ *
+ * Repair: clear the stale workflow record from the pipeline journal.
+ * The history journal is append-only and stays untouched (provenance).
+ * `--yes` applies; interactive prompts before deletion.
+ */
+import { unlinkSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { pipelinePath } from "../../review/pipeline.js";
+const RULE_ID = 'workflow-stale';
+function isStale(workflow, ctx) {
+    if (workflow.site !== ctx.site)
+        return false;
+    if (workflow.state === 'applied' || workflow.state === 'cancelled') {
+        return false;
+    }
+    // Prefer entryId match when both sides have it. If the workflow has
+    // an entryId and the calendar doesn't carry that id, the workflow is
+    // stale regardless of slug. If it doesn't, fall back to slug match.
+    if (workflow.entryId) {
+        return !ctx.calendar.entries.some((e) => e.id === workflow.entryId);
+    }
+    return !ctx.calendar.entries.some((e) => e.slug === workflow.slug);
+}
+/**
+ * Find the pipeline-journal file backing a workflow id. Files are
+ * named `<normalizedTimestamp>-<id>.json`; we suffix-match on
+ * `-<id>.json`.
+ */
+function findWorkflowFile(projectRoot, config, workflowId) {
+    const dir = pipelinePath(projectRoot, config);
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    const suffix = `-${workflowId}.json`;
+    for (const name of names) {
+        if (name.endsWith(suffix))
+            return join(dir, name);
+    }
+    return null;
+}
+const rule = {
+    id: RULE_ID,
+    label: 'Workflow records that no longer match a calendar entry',
+    async audit(ctx) {
+        const findings = [];
+        for (const w of ctx.workflows) {
+            if (!isStale(w, ctx))
+                continue;
+            findings.push({
+                ruleId: RULE_ID,
+                site: ctx.site,
+                severity: 'warning',
+                message: `Workflow ${w.id} (slug "${w.slug}", state ${w.state}) has no matching calendar entry`,
+                details: {
+                    workflowId: w.id,
+                    slug: w.slug,
+                    state: w.state,
+                    entryId: w.entryId ?? null,
+                },
+            });
+        }
+        return findings;
+    },
+    async plan(_ctx, finding) {
+        const workflowId = String(finding.details.workflowId ?? '');
+        return {
+            kind: 'apply',
+            finding,
+            summary: `delete pipeline journal entry for workflow ${workflowId} (history journal preserved)`,
+            payload: { workflowId },
+        };
+    },
+    async apply(ctx, plan) {
+        if (plan.kind !== 'apply') {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'plan is not directly appliable; runner should resolve prompt first',
+                skipReason: 'apply-failed',
+            };
+        }
+        const workflowId = String(plan.payload.workflowId ?? '');
+        if (!workflowId) {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'apply payload missing workflowId',
+                skipReason: 'apply-failed',
+            };
+        }
+        const file = findWorkflowFile(ctx.projectRoot, ctx.config, workflowId);
+        if (!file) {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: `no pipeline file found for workflow ${workflowId}`,
+                skipReason: 'apply-failed',
+            };
+        }
+        try {
+            unlinkSync(file);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: `failed to delete ${file}: ${reason}`,
+                skipReason: 'apply-failed',
+            };
+        }
+        return {
+            finding: plan.finding,
+            applied: true,
+            message: `deleted pipeline entry for workflow ${workflowId}`,
+            details: { file, workflowId },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=workflow-stale.js.map

package/dist/doctor/rules/workflow-stale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-stale.js","sourceRoot":"","sources":["../../../src/doctor/rules/workflow-stale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAUxD,MAAM,OAAO,GAAG,gBAAgB,CAAC;AAEjC,SAAS,OAAO,CACd,QAA2B,EAC3B,GAAkB;IAElB,IAAI,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,oEAAoE;IACpE,qEAAqE;IACrE,oEAAoE;IACpE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,WAAmB,EACnB,MAA+B,EAC/B,UAAkB;IAElB,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,UAAU,OAAO,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,wDAAwD;IAE/D,KAAK,CAAC,KAAK,CAAC,GAAkB;QAC5B,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC;gBAAE,SAAS;YAC/B,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,KAAK,kCAAkC;gBAC/F,OAAO,EAAE;oBACP,UAAU,EAAE,CAAC,CAAC,EAAE;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;iBAC3B;aACF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAmB,EAAE,OAAgB;QAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC5D,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO;YACP,OAAO,EAAE,8CAA8C,UAAU,8BAA8B;YAC/F,OAAO,EAAE,EAAE,UAAU,EAAE;SACxB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAkB,EAAE,IAAgB;QAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,oEAAoE;gBAC7E,UAAU,EAAE,cAAc;aAC3B,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,kCAAkC;gBAC3C,UAAU,EAAE,cAAc;aAC3B,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,uCAAuC,UAAU,EAAE;gBAC5D,UAAU,EAAE,cAAc;aAC3B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,OAAO;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,oBAAoB,IAAI,KAAK,MAAM,EAAE;gBAC9C,UAAU,EAAE,cAAc;aAC3B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,uCAAuC,UAAU,EAAE;YAC5D,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/runner.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Doctor runner — orchestrates rule execution.
+ *
+ * The runner owns the per-site setup (read calendar, build content
+ * index, scope workflows) and walks the registered rules in a stable
+ * order. `runAudit` only calls `audit()`; `runRepair` chains audit →
+ * plan → (interaction) → apply.
+ *
+ * Sibling-relative imports per the project convention.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { DoctorInteraction, DoctorReport, DoctorRule } from './types.ts';
+/**
+ * Registry of all rules in the order they run. The order matters: we
+ * detect calendar-uuid-missing first (to flush UUIDs), then run the
+ * frontmatter-id rules (which depend on UUIDs being persisted on
+ * disk to be useful in long-lived data).
+ *
+ * `legacy-top-level-id-migration` (Issue #38) runs BEFORE
+ * `missing-frontmatter-id` so that v0.7.0/v0.7.1-shaped files migrate
+ * to the namespaced form first; on the same run, the
+ * missing-frontmatter-id rule then sees the migrated files as bound
+ * (via `deskwork.id`) and doesn't re-report them.
+ */
+export declare const RULES: ReadonlyArray<DoctorRule>;
+/**
+ * Resolve a CSV/comma-separated `--fix=` argument to rule ids.
+ *
+ * Returns the full list of built-in rule ids for `''` and `'all'`.
+ * Unknown built-in id strings are rejected (exit 2 in the CLI).
+ *
+ * Project rules registered via `<projectRoot>/.deskwork/doctor/*.ts`
+ * (Phase 23f) are selected by passing `'all'`; the runner picks them
+ * up from the merged rule list. Selecting an individual project rule
+ * by id via `--fix=<id>` is not yet supported — file an issue if the
+ * usage emerges.
+ */
+export declare function parseFixArgument(arg: string): string[];
+export interface DoctorRunOptions {
+    projectRoot: string;
+    config: DeskworkConfig;
+    /** Restrict to one site; undefined = run for every site in config. */
+    site?: string;
+    /** Restrict the rule set; undefined = all rules. */
+    ruleIds?: string[];
+}
+/**
+ * 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 declare function runAudit(opts: DoctorRunOptions, interaction: DoctorInteraction): Promise<DoctorReport>;
+/**
+ * Repair: run audit → plan → (consult interaction) → apply. Returns
+ * the audit findings AND the repair results so callers can render
+ * a single report covering both phases.
+ *
+ * For `prompt` plans the runner consults `interaction.pickChoice` to
+ * resolve to an apply payload; for `apply` plans it consults
+ * `interaction.confirmApply`. `report-only` plans never apply.
+ */
+export declare function runRepair(opts: DoctorRunOptions, interaction: DoctorInteraction): Promise<DoctorReport>;
+/**
+ * Pre-built interaction: always confirm `apply` plans, skip `prompt`
+ * plans (no way to choose without a UI). Used by `--yes` mode.
+ *
+ * Exposed for the CLI command to construct.
+ */
+export declare const yesInteraction: DoctorInteraction;
+/**
+ * Pre-built interaction: never apply anything. Used to dry-run a
+ * repair pipeline (prompt resolution + apply both no-op).
+ */
+export declare const declineInteraction: DoctorInteraction;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/doctor/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAUnD,OAAO,KAAK,EAEV,iBAAiB,EACjB,YAAY,EACZ,UAAU,EAIX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,UAAU,CAS3C,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAwED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAavB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,iBAAiB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAoBvB;AAmGD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,iBAU5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAOhC,CAAC"}