@deskwork/core 0.9.5

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

@@ -0,0 +1,232 @@
+/**
+ * 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 { readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { extname, join, relative } from 'node:path';
+import { resolveContentDir } from "../../paths.js";
+import { parseFrontmatter, removeFrontmatterPaths, updateFrontmatter, } from "../../frontmatter.js";
+const RULE_ID = 'legacy-top-level-id-migration';
+const MARKDOWN_EXTENSIONS = new Set([
+    '.md',
+    '.mdx',
+    '.markdown',
+]);
+const SKIP_DIRS = new Set([
+    'scrapbook',
+    'node_modules',
+    'dist',
+    '.git',
+]);
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function shouldSkipDir(name) {
+    if (name.startsWith('.'))
+        return true;
+    return SKIP_DIRS.has(name.toLowerCase());
+}
+function collectMarkdownFiles(dir) {
+    const out = [];
+    visit(dir);
+    out.sort();
+    return out;
+    function visit(currentDir) {
+        let names;
+        try {
+            names = readdirSync(currentDir);
+        }
+        catch {
+            return;
+        }
+        for (const name of names) {
+            const abs = join(currentDir, name);
+            let st;
+            try {
+                st = statSync(abs);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (shouldSkipDir(name))
+                    continue;
+                visit(abs);
+                continue;
+            }
+            if (!st.isFile())
+                continue;
+            if (MARKDOWN_EXTENSIONS.has(extname(name).toLowerCase())) {
+                out.push(abs);
+            }
+        }
+    }
+}
+/**
+ * Inspect a single file's frontmatter and decide if it qualifies for
+ * migration. The conjunction is strict on purpose:
+ *  - top-level `id:` must be a string AND match the UUID shape
+ *  - that UUID must be present in the calendar (otherwise it isn't
+ *    deskwork's id; it's the operator's)
+ *  - `deskwork.id` must NOT exist (otherwise the file is already on
+ *    the new shape; ignoring leaves the rule idempotent across runs)
+ */
+function classify(absPath, calendarIds) {
+    let parsed;
+    try {
+        parsed = parseFrontmatter(readFileSync(absPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    const topLevelId = parsed.data.id;
+    if (typeof topLevelId !== 'string')
+        return null;
+    const trimmed = topLevelId.trim();
+    if (trimmed === '' || !UUID_RE.test(trimmed))
+        return null;
+    if (!calendarIds.has(trimmed))
+        return null;
+    const block = parsed.data.deskwork;
+    if (block !== undefined && block !== null) {
+        if (typeof block === 'object' && !Array.isArray(block)) {
+            const nestedId = block.id;
+            if (typeof nestedId === 'string' && nestedId.trim() !== '') {
+                return null;
+            }
+        }
+    }
+    return { absolutePath: absPath, legacyId: trimmed };
+}
+/**
+ * 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 function migrateLegacyTopLevelId(absPath, legacyId) {
+    const raw = readFileSync(absPath, 'utf-8');
+    const withDeskwork = updateFrontmatter(raw, { deskwork: { id: legacyId } });
+    const withoutTopLevel = removeFrontmatterPaths(withDeskwork, [['id']]);
+    if (withoutTopLevel === raw)
+        return;
+    writeFileSync(absPath, withoutTopLevel, 'utf-8');
+}
+const rule = {
+    id: RULE_ID,
+    label: 'Frontmatter id at top level should be under `deskwork:` namespace',
+    async audit(ctx) {
+        const contentDir = resolveContentDir(ctx.projectRoot, ctx.config, ctx.site);
+        const calendarIds = new Set();
+        for (const e of ctx.calendar.entries) {
+            if (e.id)
+                calendarIds.add(e.id);
+        }
+        let files;
+        try {
+            files = collectMarkdownFiles(contentDir);
+        }
+        catch {
+            return [];
+        }
+        const findings = [];
+        for (const abs of files) {
+            const hit = classify(abs, calendarIds);
+            if (hit === null)
+                continue;
+            findings.push({
+                ruleId: RULE_ID,
+                site: ctx.site,
+                severity: 'warning',
+                message: `File ${relative(ctx.projectRoot, abs)} has a top-level \`id:\` ` +
+                    `that should be migrated under \`deskwork.id\``,
+                details: {
+                    absolutePath: abs,
+                    legacyId: hit.legacyId,
+                },
+            });
+        }
+        return findings;
+    },
+    async plan(_ctx, finding) {
+        const absPath = String(finding.details.absolutePath ?? '');
+        const legacyId = String(finding.details.legacyId ?? '');
+        if (!absPath || !legacyId) {
+            return {
+                kind: 'report-only',
+                finding,
+                reason: 'finding missing absolutePath or legacyId — re-run audit',
+            };
+        }
+        return {
+            kind: 'apply',
+            finding,
+            summary: `move top-level id ${legacyId} to deskwork.id in ${absPath}`,
+            payload: { absolutePath: absPath, legacyId },
+        };
+    },
+    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 absPath = String(plan.payload.absolutePath ?? '');
+        const legacyId = String(plan.payload.legacyId ?? '');
+        if (!absPath || !legacyId) {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'apply payload missing absolutePath or legacyId',
+                skipReason: 'apply-failed',
+            };
+        }
+        try {
+            migrateLegacyTopLevelId(absPath, legacyId);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: `failed to migrate frontmatter id: ${reason}`,
+                skipReason: 'apply-failed',
+            };
+        }
+        return {
+            finding: plan.finding,
+            applied: true,
+            message: `migrated id ${legacyId} from top-level to deskwork.id in ` +
+                relative(ctx.projectRoot, absPath),
+            details: { absolutePath: absPath, legacyId },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=legacy-top-level-id-migration.js.map

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

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

package/dist/doctor/rules/missing-frontmatter-id.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Rule: missing-frontmatter-id.
+ *
+ * Audit: every calendar entry whose `id` is not a key in `index.byId`
+ * is a finding. The file binding for that entry isn't there yet.
+ *
+ * Repair: search the content tree for candidate files. Three searches,
+ * widening:
+ *   1. The file at the slug-template path (today's behavior — pre-Phase-19
+ *      scaffolds and most Astro flat layouts).
+ *   2. Any file whose frontmatter `title` matches the entry title.
+ *   3. Any file whose basename (without extension) matches the slug.
+ *
+ * If exactly one candidate emerges, the plan is "write `id: <entry.id>`
+ * into <path>". Multiple candidates produce a prompt the operator
+ * resolves; `--yes` mode skips. Zero candidates is reported and skipped
+ * (nothing to repair without operator input — the file may not exist
+ * at all yet).
+ *
+ * Sibling-relative imports per the project convention.
+ */
+import type { CalendarEntry } from '../../types.ts';
+import type { DoctorContext, DoctorRule } from '../types.ts';
+interface CandidateFile {
+    /** Absolute path to the candidate. */
+    absolutePath: string;
+    /** Why this file was considered (for operator-facing labels). */
+    matchReason: 'template-path' | 'title-match' | 'basename-match';
+}
+/**
+ * Search the content tree for files that could be bound to `entry`.
+ * Excludes files already claiming a (different) id — those are not
+ * candidates here; the duplicate-id and orphan rules handle them.
+ */
+export declare function findCandidatesForEntry(projectRoot: string, config: DoctorContext['config'], site: string, entry: CalendarEntry): CandidateFile[];
+/**
+ * Write `deskwork.id: <entryId>` into the markdown file's frontmatter.
+ * Idempotent when the file already carries the same id (no-op write
+ * avoided). Issue #38: writes under the `deskwork:` namespace, not the
+ * global top-level `id:`.
+ */
+export declare function bindFrontmatterId(absPath: string, entryId: string): void;
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=missing-frontmatter-id.d.ts.map

package/dist/doctor/rules/missing-frontmatter-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-frontmatter-id.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/missing-frontmatter-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EAIX,MAAM,aAAa,CAAC;AAOrB,UAAU,aAAa;IACrB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,WAAW,EAAE,eAAe,GAAG,aAAa,GAAG,gBAAgB,CAAC;CACjE;AAuDD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,GACnB,aAAa,EAAE,CAyDjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKxE;AAkBD,QAAA,MAAM,IAAI,EAAE,UAmHX,CAAC;AAEF,eAAe,IAAI,CAAC"}

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

@@ -0,0 +1,283 @@
+/**
+ * Rule: missing-frontmatter-id.
+ *
+ * Audit: every calendar entry whose `id` is not a key in `index.byId`
+ * is a finding. The file binding for that entry isn't there yet.
+ *
+ * Repair: search the content tree for candidate files. Three searches,
+ * widening:
+ *   1. The file at the slug-template path (today's behavior — pre-Phase-19
+ *      scaffolds and most Astro flat layouts).
+ *   2. Any file whose frontmatter `title` matches the entry title.
+ *   3. Any file whose basename (without extension) matches the slug.
+ *
+ * If exactly one candidate emerges, the plan is "write `id: <entry.id>`
+ * into <path>". Multiple candidates produce a prompt the operator
+ * resolves; `--yes` mode skips. Zero candidates is reported and skipped
+ * (nothing to repair without operator input — the file may not exist
+ * at all yet).
+ *
+ * Sibling-relative imports per the project convention.
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { basename, extname, join, relative } from 'node:path';
+import { resolveBlogFilePath, resolveContentDir } from "../../paths.js";
+import { readFrontmatter, updateFrontmatter } from "../../frontmatter.js";
+import { readFileSync, writeFileSync } from 'node:fs';
+const RULE_ID = 'missing-frontmatter-id';
+const MARKDOWN_EXTENSIONS = new Set(['.md', '.mdx', '.markdown']);
+const SKIP_DIRS = new Set(['scrapbook', 'node_modules', 'dist', '.git']);
+function shouldSkipDir(name) {
+    if (name.startsWith('.'))
+        return true;
+    return SKIP_DIRS.has(name.toLowerCase());
+}
+function collectMarkdownFiles(dir) {
+    const out = [];
+    visit(dir);
+    out.sort();
+    return out;
+    function visit(currentDir) {
+        let names;
+        try {
+            names = readdirSync(currentDir);
+        }
+        catch {
+            return;
+        }
+        for (const name of names) {
+            const abs = join(currentDir, name);
+            let st;
+            try {
+                st = statSync(abs);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (shouldSkipDir(name))
+                    continue;
+                visit(abs);
+                continue;
+            }
+            if (!st.isFile())
+                continue;
+            if (MARKDOWN_EXTENSIONS.has(extname(name).toLowerCase())) {
+                out.push(abs);
+            }
+        }
+    }
+}
+function readTitle(absPath) {
+    try {
+        const parsed = readFrontmatter(absPath);
+        const t = parsed.data.title;
+        return typeof t === 'string' ? t : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function basenameNoExt(p) {
+    return basename(p, extname(p));
+}
+/**
+ * Search the content tree for files that could be bound to `entry`.
+ * Excludes files already claiming a (different) id — those are not
+ * candidates here; the duplicate-id and orphan rules handle them.
+ */
+export function findCandidatesForEntry(projectRoot, config, site, entry) {
+    const candidates = [];
+    const seen = new Set();
+    const contentDir = resolveContentDir(projectRoot, config, site);
+    function consider(abs, reason) {
+        if (!existsSync(abs))
+            return;
+        if (seen.has(abs))
+            return;
+        // Skip files whose frontmatter already has a deskwork.id (they
+        // belong to another entry or are duplicates — out of this rule's
+        // scope). Top-level `id:` is the operator's keyspace per Issue #38
+        // and doesn't disqualify a file as a candidate.
+        try {
+            const parsed = readFrontmatter(abs);
+            const existingId = readDeskworkId(parsed.data);
+            if (existingId !== undefined) {
+                return;
+            }
+        }
+        catch {
+            // Unreadable frontmatter — skip; the index already reports it.
+            return;
+        }
+        seen.add(abs);
+        candidates.push({ absolutePath: abs, matchReason: reason });
+    }
+    // 1. Slug-template path.
+    const templatePath = resolveBlogFilePath(projectRoot, config, site, entry.slug);
+    consider(templatePath, 'template-path');
+    // 2. + 3. Walk content tree once, match by title and basename.
+    let files;
+    try {
+        files = collectMarkdownFiles(contentDir);
+    }
+    catch {
+        return candidates;
+    }
+    const slugBasename = entry.slug.split('/').pop() ?? entry.slug;
+    for (const abs of files) {
+        if (seen.has(abs))
+            continue;
+        const title = readTitle(abs);
+        if (title !== undefined && title.trim() === entry.title.trim()) {
+            consider(abs, 'title-match');
+            continue;
+        }
+        const bn = basenameNoExt(abs);
+        if (bn === slugBasename) {
+            consider(abs, 'basename-match');
+        }
+    }
+    return candidates;
+}
+/**
+ * Write `deskwork.id: <entryId>` into the markdown file's frontmatter.
+ * Idempotent when the file already carries the same id (no-op write
+ * avoided). Issue #38: writes under the `deskwork:` namespace, not the
+ * global top-level `id:`.
+ */
+export function bindFrontmatterId(absPath, entryId) {
+    const raw = readFileSync(absPath, 'utf-8');
+    const updated = updateFrontmatter(raw, { deskwork: { id: entryId } });
+    if (updated === raw)
+        return;
+    writeFileSync(absPath, updated, 'utf-8');
+}
+/**
+ * Read `deskwork.id` from frontmatter data. Returns `undefined` when
+ * either the `deskwork` block or the nested `id` is missing or
+ * malformed. Used by candidate filters and the migration rule to keep
+ * the namespaced-key reads consistent across rules.
+ */
+function readDeskworkId(data) {
+    const block = data.deskwork;
+    if (block === undefined || block === null)
+        return undefined;
+    if (typeof block !== 'object' || Array.isArray(block))
+        return undefined;
+    const id = block.id;
+    if (typeof id !== 'string')
+        return undefined;
+    const trimmed = id.trim();
+    return trimmed === '' ? undefined : trimmed;
+}
+const rule = {
+    id: RULE_ID,
+    label: 'Calendar entries with no matching frontmatter id',
+    async audit(ctx) {
+        const findings = [];
+        for (const entry of ctx.calendar.entries) {
+            if (!entry.id) {
+                // Calendar entries without an id are reported by
+                // calendar-uuid-missing instead — keep concerns separate.
+                continue;
+            }
+            if (ctx.index.byId.has(entry.id))
+                continue;
+            findings.push({
+                ruleId: RULE_ID,
+                site: ctx.site,
+                severity: 'warning',
+                message: `Entry "${entry.slug}" (id ${entry.id}) is not bound to any file via frontmatter id`,
+                details: {
+                    entryId: entry.id,
+                    slug: entry.slug,
+                    title: entry.title,
+                    stage: entry.stage,
+                },
+            });
+        }
+        return findings;
+    },
+    async plan(ctx, finding) {
+        const entryId = String(finding.details.entryId ?? '');
+        const entry = ctx.calendar.entries.find((e) => e.id === entryId);
+        if (!entry) {
+            return {
+                kind: 'report-only',
+                finding,
+                reason: `entry id ${entryId} no longer present in calendar — re-run audit`,
+            };
+        }
+        const candidates = findCandidatesForEntry(ctx.projectRoot, ctx.config, ctx.site, entry);
+        const contentDir = resolveContentDir(ctx.projectRoot, ctx.config, ctx.site);
+        if (candidates.length === 0) {
+            return {
+                kind: 'report-only',
+                finding,
+                reason: `no candidate file found under ${contentDir} for slug "${entry.slug}". ` +
+                    'Create the file (e.g. via `deskwork outline`) or move an existing one ' +
+                    'into place, then re-run.',
+            };
+        }
+        if (candidates.length === 1) {
+            const c = candidates[0];
+            return {
+                kind: 'apply',
+                finding,
+                summary: `write \`id: ${entry.id}\` into ${relative(ctx.projectRoot, c.absolutePath)} (${c.matchReason})`,
+                payload: { absolutePath: c.absolutePath, entryId: entry.id },
+            };
+        }
+        return {
+            kind: 'prompt',
+            finding,
+            question: `Multiple candidate files for entry "${entry.slug}" (id ${entry.id}). Which file should carry the id?`,
+            choices: candidates.map((c) => ({
+                id: c.absolutePath,
+                label: `${relative(ctx.projectRoot, c.absolutePath)} (${c.matchReason})`,
+                payload: { absolutePath: c.absolutePath, entryId: entry.id },
+            })),
+        };
+    },
+    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 absPath = String(plan.payload.absolutePath ?? '');
+        const entryId = String(plan.payload.entryId ?? '');
+        if (!absPath || !entryId) {
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: 'apply payload missing absolutePath or entryId',
+                skipReason: 'apply-failed',
+            };
+        }
+        try {
+            bindFrontmatterId(absPath, entryId);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return {
+                finding: plan.finding,
+                applied: false,
+                message: `failed to write frontmatter id: ${reason}`,
+                skipReason: 'apply-failed',
+            };
+        }
+        return {
+            finding: plan.finding,
+            applied: true,
+            message: `wrote id ${entryId} to ${relative(ctx.projectRoot, absPath)}`,
+            details: { absolutePath: absPath, entryId },
+        };
+    },
+};
+export default rule;
+//# sourceMappingURL=missing-frontmatter-id.js.map

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

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

package/dist/doctor/rules/orphan-frontmatter-id.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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 type { DoctorRule } from '../types.ts';
+declare const rule: DoctorRule;
+export default rule;
+//# sourceMappingURL=orphan-frontmatter-id.d.ts.map

package/dist/doctor/rules/orphan-frontmatter-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-frontmatter-id.d.ts","sourceRoot":"","sources":["../../../src/doctor/rules/orphan-frontmatter-id.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAEV,UAAU,EAIX,MAAM,aAAa,CAAC;AA6BrB,QAAA,MAAM,IAAI,EAAE,UA0GX,CAAC;AAEF,eAAe,IAAI,CAAC"}