@deskwork/core 0.9.5

package/dist/doctor/rules/calendar-uuid-missing.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Rule: calendar-uuid-missing.
+ *
+ * Detection: re-read the calendar markdown from disk and find rows
+ * whose UUID cell is empty or missing. The in-memory parser auto-
+ * backfills missing UUIDs, so the in-context calendar always has ids;
+ * we have to look at the on-disk bytes directly to see what hasn't
+ * been persisted yet.
+ *
+ * Repair: a single calendar write flushes the in-memory backfilled
+ * ids to disk. We read the calendar via `readCalendar` (which assigns
+ * UUIDs in-memory) and call `writeCalendar` to persist them.
+ *
+ * Sibling-relative imports per the project convention.
+ */
+import type { DoctorRule } from '../types.ts';
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=calendar-uuid-missing.d.ts.map

package/dist/doctor/rules/calendar-uuid-missing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-uuid-missing.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/calendar-uuid-missing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAEV,UAAU,EAIX,MAAM,aAAa,CAAC;AAmFrB,QAAA,MAAM,IAAI,EAAE,UA8FX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/calendar-uuid-missing.js

@@ -0,0 +1,176 @@
+/**
+ * Rule: calendar-uuid-missing.
+ *
+ * Detection: re-read the calendar markdown from disk and find rows
+ * whose UUID cell is empty or missing. The in-memory parser auto-
+ * backfills missing UUIDs, so the in-context calendar always has ids;
+ * we have to look at the on-disk bytes directly to see what hasn't
+ * been persisted yet.
+ *
+ * Repair: a single calendar write flushes the in-memory backfilled
+ * ids to disk. We read the calendar via `readCalendar` (which assigns
+ * UUIDs in-memory) and call `writeCalendar` to persist them.
+ *
+ * Sibling-relative imports per the project convention.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolveCalendarPath } from "../../paths.js";
+import { readCalendar, writeCalendar } from "../../calendar.js";
+const RULE_ID = 'calendar-uuid-missing';
+const STAGE_HEADER_RE = /^##\s+(.+)\s*$/;
+/**
+ * Walk the calendar markdown line-by-line, find stage tables, and
+ * report rows whose UUID column is empty/missing.
+ *
+ * Tolerant of column ordering: we identify the UUID column index from
+ * the table header (case-insensitive), then check each data row's
+ * cell at that index.
+ */
+function scanRowsMissingUuid(markdown) {
+    const lines = markdown.split('\n');
+    const rows = [];
+    let currentStage = null;
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const stageMatch = line.match(STAGE_HEADER_RE);
+        if (stageMatch) {
+            const name = stageMatch[1].trim();
+            // Only the lifecycle stage tables; Distribution / Shortform
+            // sections aren't entry rows so we skip their tables here.
+            if (name === 'Distribution' || name === 'Shortform Copy') {
+                currentStage = null;
+            }
+            else {
+                currentStage = name;
+            }
+            i++;
+            continue;
+        }
+        if (line.startsWith('|') && currentStage) {
+            // Table found — first row is the header.
+            const headerCells = parseRow(line);
+            const uuidIdx = headerCells.findIndex((c) => c.trim().toLowerCase() === 'uuid' || c.trim().toLowerCase() === 'id');
+            const slugIdx = headerCells.findIndex((c) => c.trim().toLowerCase() === 'slug');
+            i++;
+            // Optional separator row.
+            if (i < lines.length && /^\|[\s:-]+\|/.test(lines[i]))
+                i++;
+            while (i < lines.length && lines[i].startsWith('|')) {
+                const cells = parseRow(lines[i]);
+                const slug = slugIdx >= 0 ? (cells[slugIdx] ?? '').trim() : '';
+                if (slug) {
+                    const uuidCell = uuidIdx >= 0 ? (cells[uuidIdx] ?? '').trim() : '';
+                    if (!uuidCell) {
+                        rows.push({
+                            slug,
+                            stage: currentStage,
+                            line: i + 1,
+                        });
+                    }
+                }
+                i++;
+            }
+            continue;
+        }
+        i++;
+    }
+    return rows;
+}
+function parseRow(line) {
+    return line.split('|').slice(1, -1).map((c) => c.trim());
+}
+const rule = {
+    id: RULE_ID,
+    label: 'Calendar rows with missing UUIDs (not yet persisted)',
+    async audit(ctx) {
+        const calendarPath = resolveCalendarPath(ctx.projectRoot, ctx.config, ctx.site);
+        if (!existsSync(calendarPath))
+            return [];
+        let raw;
+        try {
+            raw = readFileSync(calendarPath, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const rows = scanRowsMissingUuid(raw);
+        if (rows.length === 0)
+            return [];
+        return [
+            {
+                ruleId: RULE_ID,
+                site: ctx.site,
+                severity: 'warning',
+                message: `${rows.length} calendar row(s) have no UUID on disk; in-memory parser will backfill on next write`,
+                details: {
+                    calendarPath,
+                    rows: rows.map((r) => ({ slug: r.slug, stage: r.stage, line: r.line })),
+                },
+            },
+        ];
+    },
+    async plan(ctx, finding) {
+        const calendarPath = String(finding.details.calendarPath ?? '');
+        if (!calendarPath) {
+            return {
+                kind: 'report-only',
+                finding,
+                reason: 'finding missing calendarPath — re-run audit',
+            };
+        }
+        return {
+            kind: 'apply',
+            finding,
+            summary: `re-write ${calendarPath} so the in-memory backfilled UUIDs land on disk`,
+            payload: { calendarPath, site: ctx.site },
+        };
+    },
+    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 calendarPath = String(plan.payload.calendarPath ?? '');
+        if (!calendarPath) {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'apply payload missing calendarPath',
+                skipReason: 'apply-failed',
+            };
+        }
+        try {
+            // readCalendar populates missing UUIDs in-memory; writeCalendar
+            // flushes the populated calendar back to disk. One round-trip
+            // migrates every row — also true at the call site here.
+            const cal = readCalendar(calendarPath);
+            writeCalendar(calendarPath, cal);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: `failed to re-write calendar: ${reason}`,
+                skipReason: 'apply-failed',
+            };
+        }
+        // Re-read what's now on disk to update the runner's view of
+        // ctx.calendar — though strictly the runner doesn't depend on
+        // it past this point.
+        void ctx;
+        return {
+            finding: plan.finding,
+            applied: true,
+            message: `re-wrote ${calendarPath} with UUIDs populated`,
+            details: { calendarPath },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=calendar-uuid-missing.js.map

package/dist/doctor/rules/calendar-uuid-missing.js.map

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

package/dist/doctor/rules/duplicate-id.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Rule: duplicate-id.
+ *
+ * Audit: more than one file under contentDir claims the same frontmatter
+ * id. The content index reports the byId map keeping only the first
+ * encountered, but byPath records every file. We re-walk byPath grouped
+ * by id and flag any group with > 1 entry.
+ *
+ * Repair: prompt the operator to pick a canonical file; clear the id
+ * from the others. With `--yes`, skip — picking a canonical file is
+ * an editorial decision, not something doctor should default.
+ */
+import type { DoctorContext, DoctorRule } from '../types.ts';
+interface DuplicateGroup {
+    id: string;
+    /** Absolute paths of every file claiming `id`. */
+    files: string[];
+}
+/**
+ * Group `index.byPath` (relPath → uuid) by uuid, return only groups
+ * with more than one file. Caller resolves relative paths against
+ * the site's contentDir to get absolute paths for repair.
+ */
+export declare function findDuplicateGroups(ctx: DoctorContext): DuplicateGroup[];
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=duplicate-id.d.ts.map

package/dist/doctor/rules/duplicate-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-id.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/duplicate-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EAIX,MAAM,aAAa,CAAC;AAyBrB,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,GACjB,cAAc,EAAE,CAgBlB;AAED,QAAA,MAAM,IAAI,EAAE,UA2FX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/doctor/rules/duplicate-id.js

@@ -0,0 +1,157 @@
+/**
+ * Rule: duplicate-id.
+ *
+ * Audit: more than one file under contentDir claims the same frontmatter
+ * id. The content index reports the byId map keeping only the first
+ * encountered, but byPath records every file. We re-walk byPath grouped
+ * by id and flag any group with > 1 entry.
+ *
+ * Repair: prompt the operator to pick a canonical file; clear the id
+ * from the others. With `--yes`, skip — picking a canonical file is
+ * an editorial decision, not something doctor should default.
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { parseFrontmatter, removeFrontmatterPaths } from "../../frontmatter.js";
+import { resolveContentDir } from "../../paths.js";
+const RULE_ID = 'duplicate-id';
+/**
+ * Clear the `deskwork.id` field from a markdown file. Returns true when
+ * the field was present and cleared. Issue #38: scoped to the
+ * namespaced key — top-level `id:` belongs to the operator and is left
+ * alone.
+ */
+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;
+}
+/**
+ * Group `index.byPath` (relPath → uuid) by uuid, return only groups
+ * with more than one file. Caller resolves relative paths against
+ * the site's contentDir to get absolute paths for repair.
+ */
+export function findDuplicateGroups(ctx) {
+    const contentDir = resolveContentDir(ctx.projectRoot, ctx.config, ctx.site);
+    const byUuid = new Map();
+    for (const [relPath, uuid] of ctx.index.byPath) {
+        const abs = join(contentDir, relPath);
+        const list = byUuid.get(uuid);
+        if (list)
+            list.push(abs);
+        else
+            byUuid.set(uuid, [abs]);
+    }
+    const groups = [];
+    for (const [uuid, files] of byUuid) {
+        if (files.length > 1) {
+            groups.push({ id: uuid, files: files.slice().sort() });
+        }
+    }
+    return groups;
+}
+const rule = {
+    id: RULE_ID,
+    label: 'Multiple files share the same frontmatter id',
+    async audit(ctx) {
+        const groups = findDuplicateGroups(ctx);
+        return groups.map((g) => ({
+            ruleId: RULE_ID,
+            site: ctx.site,
+            severity: 'error',
+            message: `id ${g.id} appears in ${g.files.length} files`,
+            details: { entryId: g.id, files: g.files },
+        }));
+    },
+    async plan(ctx, finding) {
+        const rawFiles = finding.details.files;
+        const files = Array.isArray(rawFiles)
+            ? rawFiles.filter((x) => typeof x === 'string')
+            : [];
+        if (files.length < 2) {
+            return {
+                kind: 'report-only',
+                finding,
+                reason: 'duplicate group has fewer than 2 files — re-run audit',
+            };
+        }
+        return {
+            kind: 'prompt',
+            finding,
+            question: `Multiple files claim id ${finding.details.entryId}. Pick the canonical file; the id will be cleared from the others.`,
+            choices: files.map((abs) => ({
+                id: abs,
+                label: relative(ctx.projectRoot, abs),
+                payload: { canonical: abs, others: files.filter((f) => f !== abs) },
+            })),
+        };
+    },
+    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 canonical = String(plan.payload.canonical ?? '');
+        const othersRaw = plan.payload.others;
+        const others = Array.isArray(othersRaw)
+            ? (othersRaw.filter((x) => typeof x === 'string'))
+            : [];
+        if (!canonical || others.length === 0) {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'apply payload missing canonical or others',
+                skipReason: 'apply-failed',
+            };
+        }
+        const cleared = [];
+        const failed = [];
+        for (const abs of others) {
+            try {
+                const changed = clearFrontmatterId(abs);
+                if (changed)
+                    cleared.push(abs);
+            }
+            catch {
+                failed.push(abs);
+            }
+        }
+        if (failed.length > 0) {
+            const partial = cleared.length > 0;
+            return {
+                finding: plan.finding,
+                applied: partial,
+                message: `cleared id from ${cleared.length} file(s); failed on ${failed.length}: ${failed.map((p) => relative(ctx.projectRoot, p)).join(', ')}`,
+                // When we cleared at least one file but some failed, treat as
+                // partial success — the `apply-failed` skip reason only fires
+                // when nothing landed on disk.
+                ...(partial ? {} : { skipReason: 'apply-failed' }),
+                details: { canonical, cleared, failed },
+            };
+        }
+        return {
+            finding: plan.finding,
+            applied: true,
+            message: `cleared id from ${cleared.length} file(s); canonical: ${relative(ctx.projectRoot, canonical)}`,
+            details: { canonical, cleared },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=duplicate-id.js.map

package/dist/doctor/rules/duplicate-id.js.map

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

package/dist/doctor/rules/legacy-top-level-id-migration.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Rule: legacy-top-level-id-migration.
+ *
+ * Issue #38: v0.7.0 / v0.7.1 of deskwork wrote (and read) the calendar
+ * binding key as a top-level `id:` field in frontmatter. Starting in
+ * v0.7.2 the canonical location is `deskwork.id`, scoping the binding
+ * to a `deskwork:` namespace so deskwork doesn't claim the operator's
+ * global keyspace.
+ *
+ * Audit: walk every markdown file under `<contentDir>` and find files
+ * where:
+ *   1. top-level `id:` is present AND its value is a UUID matching a
+ *      calendar entry, AND
+ *   2. `deskwork.id` is NOT present.
+ *
+ * The (1)+(2) conjunction makes the rule idempotent: once a file has
+ * migrated to the namespaced form, it is no longer reported. Files
+ * with a top-level `id:` whose value is NOT a calendar UUID belong to
+ * the operator and are left alone.
+ *
+ * Repair: round-trip-preserving rewrite — add `deskwork.id` with the
+ * old value, remove the top-level `id:`, leave every other byte
+ * untouched. Safe for `--yes` / `--fix=all` mode (clear-and-move with
+ * no editorial decision required).
+ *
+ * Sibling-relative imports per the project convention.
+ */
+import type { DoctorRule } from '../types.ts';
+/**
+ * Apply the migration to a single file:
+ * 1. Add `deskwork.id` with the old value.
+ * 2. Remove the top-level `id:`.
+ *
+ * Both writes use the round-trip-preserving frontmatter API so every
+ * other byte stays put.
+ */
+export declare function migrateLegacyTopLevelId(absPath: string, legacyId: string): void;
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=legacy-top-level-id-migration.d.ts.map

package/dist/doctor/rules/legacy-top-level-id-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-top-level-id-migration.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/legacy-top-level-id-migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAUH,OAAO,KAAK,EAEV,UAAU,EAIX,MAAM,aAAa,CAAC;AAsGrB;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM/E;AAED,QAAA,MAAM,IAAI,EAAE,UAqGX,CAAC;AAEF,eAAe,IAAI,CAAC"}