@deskwork/cli 0.9.5

package/dist/commands/doctor.js

@@ -0,0 +1,354 @@
+/**
+ * deskwork doctor — validate and (optionally) repair binding metadata
+ * across the calendar + content tree + workflow store.
+ *
+ * Default mode is audit-only: walk the rules, report findings, exit 0
+ * on a clean tree or 1 if anything was reported. `--fix=<rule>` (or
+ * `--fix=all`) engages repair mode; `--yes` makes repairs non-
+ * interactive (skipping ambiguous cases). `--json` produces machine-
+ * readable output that composes with `jq`.
+ *
+ * Argv shape (after the dispatcher injects projectRoot when needed):
+ *
+ *   <project-root> [flags]
+ *
+ * Flags:
+ *   --site <slug>         Restrict to one site; default = every site.
+ *   --fix <rule|all>      Engage repair mode for the named rule(s).
+ *   --yes                 Non-interactive repair (skip ambiguous).
+ *   --json                Emit JSON instead of human-readable text.
+ *
+ * Exit codes (Issue #44, Phase 22):
+ *   0  Audit clean. OR --fix succeeded for every applicable finding.
+ *      "Applicable" here means: anything that wasn't skipped because
+ *      a prerequisite outside doctor's scope hasn't happened yet (e.g.
+ *      the body file hasn't been scaffolded, so missing-frontmatter-id
+ *      can't bind).
+ *   1  Findings present (audit-only mode). OR --fix encountered real
+ *      follow-ups: ambiguous cases requiring interactive resolution,
+ *      schema rejections needing the operator to patch the host
+ *      schema, editorial decisions, operator declines, or hard
+ *      apply-failures.
+ *   2  Usage / config error.
+ */
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { readConfig } from '@deskwork/core/config';
+import { absolutize, fail, parseArgs } from '@deskwork/core/cli-args';
+import { RULES, parseFixArgument, runAudit, runRepair, yesInteraction, } from '@deskwork/core/doctor';
+const KNOWN_FLAGS = ['site', 'fix'];
+const BOOLEAN_FLAGS = ['yes', 'json'];
+export async function run(argv) {
+    const { positional, flags, booleans } = parseInput(argv);
+    if (positional.length < 1) {
+        fail('Usage: deskwork doctor <project-root> [--site <slug>] [--fix <rule|all>] [--yes] [--json]', 2);
+    }
+    const [rootArg] = positional;
+    const projectRoot = absolutize(rootArg);
+    let config;
+    try {
+        config = readConfig(projectRoot);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err), 2);
+    }
+    if (flags.site !== undefined && !(flags.site in config.sites)) {
+        fail(`Unknown --site "${flags.site}". Configured sites: ${Object.keys(config.sites).join(', ')}`, 2);
+    }
+    let ruleIds;
+    if (flags.fix !== undefined) {
+        const fixArg = flags.fix.trim();
+        // Phase 23f: `--fix all` (and the empty form) leaves `ruleIds`
+        // undefined so the runner picks up project rules registered at
+        // `<projectRoot>/.deskwork/doctor/*.ts` along with the built-ins.
+        // Explicit ids still validate against the built-in set (parseFixArgument
+        // throws on unknown).
+        if (fixArg !== '' && fixArg !== 'all') {
+            try {
+                ruleIds = parseFixArgument(flags.fix);
+            }
+            catch (err) {
+                fail(err instanceof Error ? err.message : String(err), 2);
+            }
+        }
+    }
+    const json = booleans.has('json');
+    const yes = booleans.has('yes');
+    const repairMode = flags.fix !== undefined;
+    const opts = {
+        projectRoot,
+        config,
+        ...(flags.site !== undefined ? { site: flags.site } : {}),
+        ...(ruleIds !== undefined ? { ruleIds } : {}),
+    };
+    let report;
+    if (!repairMode) {
+        // Audit-only — interaction is unused but the type insists on a
+        // value, so we pass yesInteraction (its methods are never invoked
+        // in this mode).
+        report = await runAudit(opts, yesInteraction);
+        emitReport(report, { json, repairMode: false });
+        process.exit(report.findings.length === 0 ? 0 : 1);
+    }
+    if (yes) {
+        report = await runRepair(opts, yesInteraction);
+    }
+    else {
+        const adapter = interactiveAdapter();
+        try {
+            report = await runRepair(opts, adapter.interaction);
+        }
+        finally {
+            adapter.close();
+        }
+    }
+    emitReport(report, { json, repairMode: true });
+    // Exit-code logic (Issue #44):
+    //   - applied → success.
+    //   - skipped because the prerequisite isn't met (e.g. no body file
+    //     yet for missing-frontmatter-id) → success. The operator's
+    //     next action is `/deskwork:outline`, not "look at doctor."
+    //   - skipped because the operator chose "leave as-is" on an orphan
+    //     prompt → success. The operator made a choice; respect it.
+    //   - everything else (ambiguous, schema-rejected, editorial-
+    //     decision, operator-declined, apply-failed) → exit 1. These
+    //     are real follow-ups doctor can't auto-resolve.
+    const realFollowUps = report.repairs.filter((r) => !r.applied && !isExpectedSkip(r.skipReason)).length;
+    process.exit(realFollowUps === 0 ? 0 : 1);
+}
+/**
+ * True for skip reasons that indicate the operator's next move is
+ * outside doctor's scope (run a different command, decline a no-op
+ * choice). The exit-code logic treats these as success in `--fix`
+ * mode so CI can run `doctor --fix=all --yes` and trust exit 0
+ * means "we did everything we could."
+ *
+ * `undefined` defaults to "this is a real follow-up" — older rule
+ * implementations that don't set `skipReason` keep the legacy
+ * exit-1-on-skip behavior.
+ */
+function isExpectedSkip(reason) {
+    return reason === 'prerequisite-missing' || reason === 'no-action-needed';
+}
+function parseInput(argv) {
+    try {
+        return parseArgs(argv, KNOWN_FLAGS, BOOLEAN_FLAGS);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err), 2);
+    }
+}
+function interactiveAdapter() {
+    const rl = createInterface({ input: stdin, output: stdout });
+    const interaction = {
+        async pickChoice(plan) {
+            stdout.write(`\n${plan.question}\n`);
+            plan.choices.forEach((c, i) => {
+                stdout.write(`  ${i + 1}. ${c.label}\n`);
+            });
+            stdout.write(`  s. skip\n`);
+            const answer = (await rl.question('Pick: ')).trim().toLowerCase();
+            if (answer === '' || answer === 's' || answer === 'skip')
+                return undefined;
+            const idx = Number.parseInt(answer, 10);
+            if (Number.isNaN(idx) || idx < 1 || idx > plan.choices.length) {
+                stdout.write(`Unknown choice "${answer}", skipping.\n`);
+                return undefined;
+            }
+            return plan.choices[idx - 1].id;
+        },
+        async confirmApply(plan) {
+            stdout.write(`\nFix: ${plan.summary}\n`);
+            const answer = (await rl.question('Apply? [y/N] ')).trim().toLowerCase();
+            return answer === 'y' || answer === 'yes';
+        },
+    };
+    return {
+        interaction,
+        close() {
+            rl.close();
+        },
+    };
+}
+function emitReport(report, opts) {
+    if (opts.json) {
+        emitJson(report, opts);
+        return;
+    }
+    emitText(report, opts);
+}
+function emitJson(report, opts) {
+    const out = {
+        mode: opts.repairMode ? 'fix' : 'audit',
+        sites: report.sites,
+        rules: RULES.map((r) => r.id),
+        findings: report.findings.map(serializeFinding),
+        repairs: report.repairs.map(serializeRepair),
+    };
+    process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);
+}
+function serializeFinding(f) {
+    return {
+        ruleId: f.ruleId,
+        site: f.site,
+        severity: f.severity,
+        message: f.message,
+        details: f.details,
+    };
+}
+function serializeRepair(r) {
+    return {
+        ruleId: r.finding.ruleId,
+        site: r.finding.site,
+        applied: r.applied,
+        message: r.message,
+        ...(r.skipReason !== undefined ? { skipReason: r.skipReason } : {}),
+        finding: serializeFinding(r.finding),
+        ...(r.details !== undefined ? { details: r.details } : {}),
+    };
+}
+function emitText(report, opts) {
+    if (report.findings.length === 0) {
+        process.stdout.write(`Doctor: clean (no findings across ${report.sites.length} site(s))\n`);
+        return;
+    }
+    const byRule = groupBy(report.findings, (f) => f.ruleId);
+    process.stdout.write(`Doctor: ${report.findings.length} finding(s) across ${report.sites.length} site(s)\n\n`);
+    for (const rule of RULES) {
+        const findings = byRule.get(rule.id);
+        if (!findings || findings.length === 0)
+            continue;
+        process.stdout.write(`[${rule.id}] ${rule.label} (${findings.length})\n`);
+        for (const f of findings) {
+            process.stdout.write(`  - [${f.site}] ${f.message}\n`);
+        }
+        process.stdout.write('\n');
+    }
+    if (opts.repairMode) {
+        emitRepairsGrouped(report);
+        return;
+    }
+    process.stdout.write(`Run \`deskwork doctor --fix=<rule>\` (or \`--fix=all\`) to repair. ` +
+        `Add \`--yes\` for non-interactive mode.\n`);
+}
+/**
+ * Issue #44 — repairs grouped by rule with applied/skipped split and
+ * a per-finding indented bullet list. Replaces the older flat per-line
+ * format that was hard to scan when 28 findings landed in one rule.
+ *
+ * Within each rule:
+ *   - one summary line: "<rule>: N applied, M skipped (<reason hint>)"
+ *   - applied bullets, then skipped bullets grouped by reason
+ *
+ * The skip-reason groups surface the prerequisite-missing case (the
+ * common audiocontrol scenario where 16 entries are waiting on
+ * outline) separately from the ambiguous / editorial-decision /
+ * apply-failed cases that need real operator follow-up.
+ */
+function emitRepairsGrouped(report) {
+    process.stdout.write('Repairs:\n');
+    if (report.repairs.length === 0) {
+        process.stdout.write('  (none)\n');
+        return;
+    }
+    const byRule = groupBy(report.repairs, (r) => r.finding.ruleId);
+    for (const rule of RULES) {
+        const repairs = byRule.get(rule.id);
+        if (!repairs || repairs.length === 0)
+            continue;
+        const applied = repairs.filter((r) => r.applied);
+        const skipped = repairs.filter((r) => !r.applied);
+        const summaryParts = [
+            `${applied.length} applied`,
+            `${skipped.length} skipped`,
+        ];
+        if (skipped.length > 0) {
+            const hint = primarySkipHint(skipped);
+            if (hint !== null)
+                summaryParts[1] += ` (${hint})`;
+        }
+        process.stdout.write(`\n  ${rule.id}: ${summaryParts.join(', ')}\n`);
+        if (applied.length > 0) {
+            process.stdout.write('    applied:\n');
+            for (const r of applied) {
+                process.stdout.write(`      - [${r.finding.site}] ${r.message}\n`);
+            }
+        }
+        if (skipped.length > 0) {
+            const byReason = groupBy(skipped, (r) => r.skipReason ?? 'unknown');
+            for (const [reason, items] of byReason) {
+                process.stdout.write(`    skipped (${reason}):\n`);
+                for (const r of items) {
+                    process.stdout.write(`      - [${r.finding.site}] ${r.message}\n`);
+                }
+            }
+        }
+    }
+    // Aggregated bottom-of-output summary with the new skip-reason
+    // granularity from Issue #44.
+    const totals = aggregateRepairTotals(report.repairs);
+    process.stdout.write('\nSummary:\n');
+    process.stdout.write(`  applied: ${totals.applied}\n`);
+    for (const [reason, count] of totals.skipped) {
+        process.stdout.write(`  skipped (${reason}): ${count}\n`);
+    }
+}
+function aggregateRepairTotals(repairs) {
+    let applied = 0;
+    const counts = new Map();
+    for (const r of repairs) {
+        if (r.applied) {
+            applied++;
+            continue;
+        }
+        const key = r.skipReason ?? 'unknown';
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    }
+    return { applied, skipped: Array.from(counts.entries()) };
+}
+/**
+ * One-line hint for the parenthetical attached to a rule's per-rule
+ * summary line. Returns null when the skip-reason mix is heterogeneous
+ * enough that a single phrase would be misleading; the per-reason
+ * sub-bullets already show the breakdown.
+ */
+function primarySkipHint(skipped) {
+    const reasons = new Set();
+    for (const r of skipped) {
+        reasons.add(r.skipReason ?? 'unknown');
+    }
+    if (reasons.size !== 1)
+        return null;
+    const [only] = reasons;
+    switch (only) {
+        case 'prerequisite-missing':
+            return 'no body file yet — run /deskwork:outline';
+        case 'ambiguous':
+            return 'ambiguous; re-run interactively to choose';
+        case 'editorial-decision':
+            return 'operator must decide';
+        case 'schema-rejected':
+            return 'patch host content schema first';
+        case 'operator-declined':
+            return 'operator declined';
+        case 'apply-failed':
+            return 'apply failed';
+        case 'no-action-needed':
+            return 'no action needed';
+        default:
+            return null;
+    }
+}
+function groupBy(items, key) {
+    const out = new Map();
+    for (const item of items) {
+        const k = key(item);
+        const list = out.get(k);
+        if (list)
+            list.push(item);
+        else
+            out.set(k, [item]);
+    }
+    return out;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/draft.d.ts

@@ -0,0 +1,17 @@
+/**
+ * deskwork-draft — move an Outlining entry to Drafting.
+ *
+ * Blog file scaffolding happens in the outline step (see deskwork-outline).
+ * By the time this helper runs, the blog markdown already exists with an
+ * approved outline. Draft just flips the stage and optionally records a
+ * linked GitHub issue number (Claude invokes `gh issue create` separately
+ * and passes the resulting number via --issue).
+ *
+ * Usage:
+ *   deskwork-draft <project-root> [--site <slug>] [--issue <n>] <slug>
+ *
+ * Emits a JSON result:
+ *   { slug, stage, contentType, issueNumber?, site, calendarPath }
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=draft.d.ts.map

package/dist/commands/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../src/commands/draft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEvD"}

package/dist/commands/draft.js

@@ -0,0 +1,77 @@
+/**
+ * deskwork-draft — move an Outlining entry to Drafting.
+ *
+ * Blog file scaffolding happens in the outline step (see deskwork-outline).
+ * By the time this helper runs, the blog markdown already exists with an
+ * approved outline. Draft just flips the stage and optionally records a
+ * linked GitHub issue number (Claude invokes `gh issue create` separately
+ * and passes the resulting number via --issue).
+ *
+ * Usage:
+ *   deskwork-draft <project-root> [--site <slug>] [--issue <n>] <slug>
+ *
+ * Emits a JSON result:
+ *   { slug, stage, contentType, issueNumber?, site, calendarPath }
+ */
+import { readConfig } from '@deskwork/core/config';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { draftEntry, findEntry } from '@deskwork/core/calendar-mutations';
+import { effectiveContentType } from '@deskwork/core/types';
+import { resolveSite, resolveCalendarPath } from '@deskwork/core/paths';
+import { absolutize, emit, fail, parseArgs } from '@deskwork/core/cli-args';
+export async function run(argv) {
+    const KNOWN_FLAGS = ['site', 'issue'];
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork-draft <project-root> [--site <slug>] [--issue <n>] <slug>', 2);
+    }
+    const [rootArg, slug] = positional;
+    const projectRoot = absolutize(rootArg);
+    let issueNumber;
+    if (flags.issue !== undefined) {
+        const n = parseInt(flags.issue, 10);
+        if (!Number.isFinite(n) || n <= 0) {
+            fail(`Invalid --issue "${flags.issue}". Must be a positive integer.`);
+        }
+        issueNumber = n;
+    }
+    let config;
+    try {
+        config = readConfig(projectRoot);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    const site = resolveSite(config, flags.site);
+    const calendarPath = resolveCalendarPath(projectRoot, config, site);
+    const calendar = readCalendar(calendarPath);
+    const existing = findEntry(calendar, slug);
+    if (!existing) {
+        const outlining = calendar.entries
+            .filter((e) => e.stage === 'Outlining')
+            .map((e) => e.slug)
+            .join(', ') || '(none)';
+        fail(`No calendar entry found with slug "${slug}". Outlining entries: ${outlining}`);
+    }
+    const contentType = effectiveContentType(existing);
+    const updated = draftEntry(calendar, slug, issueNumber);
+    writeCalendar(calendarPath, calendar);
+    emit({
+        slug: updated.slug,
+        title: updated.title,
+        stage: updated.stage,
+        contentType,
+        issueNumber: updated.issueNumber,
+        site,
+        calendarPath,
+    });
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=draft.js.map

package/dist/commands/draft.js.map

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

package/dist/commands/ingest.d.ts

@@ -0,0 +1,43 @@
+/**
+ * deskwork ingest — backfill existing markdown content into the editorial
+ * calendar.
+ *
+ * Discovery is the heavy lifting; this module is the CLI surface around
+ * `discoverIngestCandidates` from @deskwork/core/ingest.
+ *
+ * Argv shape (after the dispatcher injects projectRoot when needed):
+ *
+ *   <project-root> [flags] <path>...
+ *
+ * Flags:
+ *   --site <slug>             Target site (defaults to config.defaultSite)
+ *   --apply                   Commit the plan; default is dry-run
+ *   --json                    Machine-readable plan output
+ *   --force                   Bypass duplicate-slug skip
+ *   --slug-from <where>       'frontmatter' or 'path' (default 'path')
+ *   --state-from <where>      'frontmatter' (default) or 'datePublished'
+ *   --slug <value>            Explicit slug (only with single-file ingest)
+ *   --state <stage>           Explicit stage; wins over derivation
+ *   --date <YYYY-MM-DD>       Explicit ISO date; wins over derivation
+ *   --title-field <name>      Frontmatter field for title (default: title)
+ *   --description-field <n>   Frontmatter field for description
+ *                             (default: description)
+ *   --slug-field <name>       Frontmatter field for slug (default: slug)
+ *   --state-field <name>      Frontmatter field for state (default: state)
+ *   --date-field <name>       Frontmatter field for date (default:
+ *                             datePublished)
+ *
+ * Dry-run output (text mode):
+ *
+ *   Plan: 3 add, 1 skip
+ *
+ *   add  whats-in-a-name             Published  2020-10-01    state:fm date:fm slug:path
+ *   add  the-deskwork-experiment     Published  2026-04-20    state:fm date:fm slug:path
+ *   skip on-revising-in-the-open                              already in calendar
+ *
+ * `--apply` writes calendar rows for non-skipped candidates and appends
+ * a journal entry per ingested file (`event: 'ingest'`) so a future
+ * review-start has provenance to anchor against.
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/commands/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAuCH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4HvD"}