@deskwork/cli 0.9.5

package/dist/commands/customize.js

@@ -0,0 +1,176 @@
+/**
+ * deskwork customize — copy a plugin-default file into the project's
+ * `.deskwork/<category>/<name>.ts` so the operator can edit it.
+ *
+ * Phase 23f. Categories:
+ *   - templates  → copies `packages/studio/src/pages/<name>.ts`
+ *   - doctor     → copies `packages/core/src/doctor/rules/<name>.ts`
+ *   - prompts    → reserved (no default-source mapping yet)
+ *
+ * Usage (after the dispatcher injects projectRoot):
+ *   deskwork customize <project-root> <category> <name>
+ *
+ * The command:
+ *   1. Resolves the plugin-default source file via `import.meta.resolve`
+ *      against the published package paths so it works in both
+ *      workspace dev and marketplace install.
+ *   2. Copies the source verbatim into
+ *      `<projectRoot>/.deskwork/<category>/<name>.ts`, creating the
+ *      directory tree as needed.
+ *   3. Refuses if the destination file already exists — clobbering an
+ *      operator's edits would be a bug-factory.
+ *   4. Prints the destination path so the operator can edit.
+ *
+ * Errors:
+ *   - Unknown category → exit 2 with the list of valid categories.
+ *   - `prompts` for now → exit 2 with a "reserved for future use" note.
+ *   - Plugin-default not found → exit 1 with the list of names that DO
+ *     have defaults (best-effort).
+ *   - Destination file already exists → exit 1, refuse to overwrite.
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { fail } from '@deskwork/core/cli-args';
+const VALID_CATEGORIES = ['templates', 'prompts', 'doctor'];
+function isCategory(value) {
+    return VALID_CATEGORIES.includes(value);
+}
+/**
+ * Resolve a node module path via `import.meta.resolve`. Returns the
+ * absolute file path the package's exports map points at, regardless
+ * of whether we're running from the workspace tree or from a
+ * marketplace-installed copy.
+ *
+ * Throws when the package can't be resolved at all (CLI installed in a
+ * broken state). The caller surfaces the error to the operator.
+ */
+function resolvePackageFile(specifier) {
+    try {
+        const url = import.meta.resolve(specifier);
+        return fileURLToPath(url);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`cannot resolve ${specifier} (broken install?): ${reason}`);
+    }
+}
+/**
+ * Resolve a package's root directory by anchoring on its `package.json`
+ * subpath export. Both `@deskwork/core` and `@deskwork/studio` expose
+ * `./package.json` implicitly through Node's package-exports machinery
+ * (or via a dedicated entry — see each package's exports map).
+ *
+ * Returns the absolute directory containing the package.json. From there,
+ * the customize anchor walks into `src/<...>` for the requested file.
+ */
+function resolvePackageRoot(packageName) {
+    const pkgJsonPath = resolvePackageFile(`${packageName}/package.json`);
+    return dirname(pkgJsonPath);
+}
+/**
+ * Find the source-of-truth file for a customize request. Returns an
+ * absolute path or throws. The mapping per category:
+ *
+ *   templates → @deskwork/studio package root, then src/pages/<name>.ts.
+ *   doctor    → @deskwork/core package root, then src/doctor/rules/<name>.ts.
+ *   prompts   → throws (reserved).
+ *
+ * Note: this assumes the published package ships its `src/` tree.
+ * Phase 26b's `files: ["dist", ...]` whitelist drops `src/`, so the
+ * customize command currently works only against workspace-symlinked
+ * packages (the dev path). A follow-up issue tracks shipping the
+ * customize sources alongside dist or vendoring template snapshots.
+ */
+function resolveDefaultSource(category, name) {
+    if (category === 'prompts') {
+        throw new Error('category "prompts" is reserved for future use — no default sources to copy yet');
+    }
+    if (category === 'templates') {
+        const studioRoot = resolvePackageRoot('@deskwork/studio');
+        const candidate = resolve(studioRoot, 'src', 'pages', `${name}.ts`);
+        if (!existsSync(candidate)) {
+            throw new Error(`no built-in template named "${name}". Available templates: ${listAvailable(dirname(candidate))}`);
+        }
+        return candidate;
+    }
+    // doctor
+    const coreRoot = resolvePackageRoot('@deskwork/core');
+    const candidate = resolve(coreRoot, 'src', 'doctor', 'rules', `${name}.ts`);
+    if (!existsSync(candidate)) {
+        throw new Error(`no built-in doctor rule named "${name}". Available rules: ${listAvailable(dirname(candidate))}`);
+    }
+    return candidate;
+}
+/**
+ * Best-effort listing of the available basenames in a directory. Used
+ * to enrich error messages when the operator passes a name that
+ * doesn't match a built-in default.
+ */
+function listAvailable(dir) {
+    if (!existsSync(dir))
+        return '(none — broken install)';
+    const entries = readdirSync(dir)
+        .filter((n) => n.endsWith('.ts'))
+        .map((n) => n.slice(0, -'.ts'.length))
+        .sort();
+    return entries.join(', ');
+}
+/**
+ * Add `@deskwork/studio/server.ts` resolution support. The studio
+ * package's `package.json` lists `bin: { "deskwork-studio": "./src/server.ts" }`
+ * but no top-level `exports.server.ts`. We work around that by
+ * resolving the package root through `package.json#main` if available;
+ * here we cheat and use the studio's own `import.meta` from the
+ * compiled bundle. To keep this implementation simple, we resolve via
+ * the studio package's `package.json` root and then join the source
+ * tree path.
+ *
+ * (This doc-comment reserves the explanation; the actual logic above
+ * uses `@deskwork/studio/server.ts`. Studio's package.json must list
+ * an exports entry for that subpath. If it doesn't yet, resolveDefaultSource
+ * will throw a clear error and the test will catch the omission.)
+ */
+export async function run(argv) {
+    // Argv shape after dispatcher inject:
+    //   [<project-root>, <category>, <name>]
+    if (argv.length !== 3) {
+        fail('Usage: deskwork customize <project-root> <category> <name>\n' +
+            `  category: ${VALID_CATEGORIES.join(' | ')}`, 2);
+    }
+    const [projectRootArg, categoryArg, name] = argv;
+    if (!isCategory(categoryArg)) {
+        fail(`unknown category "${categoryArg}". Valid: ${VALID_CATEGORIES.join(', ')}`, 2);
+    }
+    if (!name || name.includes('/') || name.includes('\\') || name.startsWith('.')) {
+        fail(`name "${name}" must be a plain basename (no slashes, no leading dots)`, 2);
+    }
+    const projectRoot = isAbsolute(projectRootArg)
+        ? projectRootArg
+        : resolve(process.cwd(), projectRootArg);
+    if (!existsSync(projectRoot)) {
+        fail(`project root does not exist: ${projectRoot}`, 1);
+    }
+    let source;
+    try {
+        source = resolveDefaultSource(categoryArg, name);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err), 1);
+    }
+    const destDir = join(projectRoot, '.deskwork', categoryArg);
+    const destFile = join(destDir, `${name}.ts`);
+    if (existsSync(destFile)) {
+        fail(`destination already exists: ${destFile}\n` +
+            '  Refusing to overwrite operator-edited overrides.\n' +
+            '  Move or delete the existing file before re-running.', 1);
+    }
+    mkdirSync(destDir, { recursive: true });
+    copyFileSync(source, destFile);
+    process.stdout.write(`Customized ${categoryArg}/${name}\n`);
+    process.stdout.write(`  source: ${source}\n`);
+    process.stdout.write(`  dest:   ${destFile}\n`);
+    process.stdout.write('  Edit the destination file to customize behavior. The studio\n');
+    process.stdout.write('  loads the override automatically on the next request.\n');
+}
+//# sourceMappingURL=customize.js.map

package/dist/commands/customize.js.map

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

package/dist/commands/distribute.d.ts

@@ -0,0 +1,30 @@
+/**
+ * deskwork distribute — record the URL of a posted shortform.
+ *
+ * Run AFTER the operator has manually posted an approved shortform to
+ * the platform. The helper updates the calendar's distribution record
+ * with the share URL (and optional date / notes) so the dashboard
+ * matrix shows the cell as covered.
+ *
+ * Match precedence (handled inside `updateDistributionUrl`):
+ *   - `entryId` (preferred — survives slug renames)
+ *   - `(slug, platform, channel?)` legacy fallback
+ *
+ * If no record exists yet for the (slug, platform, channel?) tuple, the
+ * helper creates one via `addDistribution`. That call enforces the
+ * Published-stage invariant — non-Published entries cannot have
+ * distribution records, since deskwork doesn't track shares for posts
+ * that haven't shipped yet.
+ *
+ * Usage:
+ *   deskwork distribute <project-root> [--site <slug>]
+ *                       --platform <p> [--channel <c>]
+ *                       --url <posted-url>
+ *                       [--date YYYY-MM-DD] [--notes <text>]
+ *                       <slug>
+ *
+ * Emits a JSON result with the slug, platform, channel (if any), the
+ * recorded URL, the resolved dateShared, and notes (if any).
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=distribute.d.ts.map

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

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

package/dist/commands/distribute.js

@@ -0,0 +1,148 @@
+/**
+ * deskwork distribute — record the URL of a posted shortform.
+ *
+ * Run AFTER the operator has manually posted an approved shortform to
+ * the platform. The helper updates the calendar's distribution record
+ * with the share URL (and optional date / notes) so the dashboard
+ * matrix shows the cell as covered.
+ *
+ * Match precedence (handled inside `updateDistributionUrl`):
+ *   - `entryId` (preferred — survives slug renames)
+ *   - `(slug, platform, channel?)` legacy fallback
+ *
+ * If no record exists yet for the (slug, platform, channel?) tuple, the
+ * helper creates one via `addDistribution`. That call enforces the
+ * Published-stage invariant — non-Published entries cannot have
+ * distribution records, since deskwork doesn't track shares for posts
+ * that haven't shipped yet.
+ *
+ * Usage:
+ *   deskwork distribute <project-root> [--site <slug>]
+ *                       --platform <p> [--channel <c>]
+ *                       --url <posted-url>
+ *                       [--date YYYY-MM-DD] [--notes <text>]
+ *                       <slug>
+ *
+ * Emits a JSON result with the slug, platform, channel (if any), the
+ * recorded URL, the resolved dateShared, and notes (if any).
+ */
+import { readConfig } from '@deskwork/core/config';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { findEntry, findEntryById, updateDistributionUrl, } from '@deskwork/core/calendar-mutations';
+import { resolveSite, resolveCalendarPath } from '@deskwork/core/paths';
+import { isPlatform, PLATFORMS } from '@deskwork/core/types';
+import { absolutize, emit, fail, parseArgs } from '@deskwork/core/cli-args';
+export async function run(argv) {
+    const KNOWN_FLAGS = [
+        'site',
+        'platform',
+        'channel',
+        'url',
+        'date',
+        'notes',
+    ];
+    const SLUG_RE = /^[a-z0-9][a-z0-9-]*(\/[a-z0-9][a-z0-9-]*)*$/;
+    const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork distribute <project-root> [--site <slug>] ' +
+            '--platform <p> [--channel <c>] --url <posted-url> ' +
+            '[--date YYYY-MM-DD] [--notes <text>] <slug>', 2);
+    }
+    const [rootArg, slug] = positional;
+    const projectRoot = absolutize(rootArg);
+    if (!SLUG_RE.test(slug)) {
+        fail(`invalid slug: ${slug} (must match ${SLUG_RE})`);
+    }
+    const platform = flags.platform;
+    if (platform === undefined) {
+        fail(`--platform is required. Must be one of: ${PLATFORMS.join(', ')}.`, 2);
+    }
+    if (!isPlatform(platform)) {
+        fail(`Invalid --platform "${platform}". Must be one of: ${PLATFORMS.join(', ')}.`);
+    }
+    const url = flags.url;
+    if (url === undefined || url === '') {
+        fail('--url is required (the URL of the posted share).', 2);
+    }
+    if (flags.date !== undefined && !DATE_RE.test(flags.date)) {
+        fail(`Invalid --date "${flags.date}". Must match YYYY-MM-DD.`);
+    }
+    const channel = flags.channel;
+    const dateShared = flags.date;
+    const notes = flags.notes;
+    let config;
+    try {
+        config = readConfig(projectRoot);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    let site;
+    try {
+        site = resolveSite(config, flags.site);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    const calendarPath = resolveCalendarPath(projectRoot, config, site);
+    const calendar = readCalendar(calendarPath);
+    // Resolve entryId from the calendar so the distribution record carries
+    // the stable identity. Survives slug renames downstream.
+    const entry = findEntryById(calendar, slug) ?? findEntry(calendar, slug);
+    if (!entry) {
+        const slugs = calendar.entries.map((e) => e.slug).join(', ') || '(none)';
+        fail(`No calendar entry with slug "${slug}" on site "${site}". ` +
+            `Known slugs: ${slugs}.`);
+    }
+    // Pre-flight the Published-stage invariant. The mutation throws the same
+    // way via `addDistribution` when no prior record exists, but we surface
+    // a clearer, action-oriented error here before mutating.
+    const hasPriorRecord = calendar.distributions.some((d) => {
+        if (d.platform !== platform)
+            return false;
+        const channelMatches = channel === undefined ? !d.channel : (d.channel?.toLowerCase() ?? '') === channel.toLowerCase();
+        if (!channelMatches)
+            return false;
+        if (entry.id !== undefined && d.entryId === entry.id)
+            return true;
+        return d.slug === entry.slug;
+    });
+    if (!hasPriorRecord && entry.stage !== 'Published') {
+        fail(`Cannot record distribution for non-Published entry "${entry.slug}" ` +
+            `(current stage: ${entry.stage}). Run /deskwork:publish ${entry.slug} first.`);
+    }
+    let record;
+    try {
+        record = updateDistributionUrl(calendar, {
+            ...(entry.id !== undefined ? { entryId: entry.id } : {}),
+            slug: entry.slug,
+            platform,
+            ...(channel !== undefined ? { channel } : {}),
+        }, url, dateShared, notes);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    writeCalendar(calendarPath, calendar);
+    emit({
+        slug: record.slug,
+        ...(record.entryId !== undefined ? { entryId: record.entryId } : {}),
+        platform: record.platform,
+        ...(record.channel !== undefined ? { channel: record.channel } : {}),
+        url: record.url,
+        dateShared: record.dateShared,
+        ...(record.notes !== undefined ? { notes: record.notes } : {}),
+        site,
+        calendarPath,
+    });
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=distribute.js.map

package/dist/commands/distribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distribute.js","sourceRoot":"","sources":["../../src/commands/distribute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,SAAS,EACT,aAAa,EACb,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,MAAM,WAAW,GAAG;QAClB,MAAM;QACN,UAAU;QACV,SAAS;QACT,KAAK;QACL,MAAM;QACN,OAAO;KACC,CAAC;IACX,MAAM,OAAO,GAAG,6CAA6C,CAAC;IAC9D,MAAM,OAAO,GAAG,qBAAqB,CAAC;IAEtC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;IAEtC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,CACF,4DAA4D;YAC1D,oDAAoD;YACpD,6CAA6C,EAC/C,CAAC,CACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC;IACnC,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAExC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,iBAAiB,IAAI,gBAAgB,OAAO,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,CACF,2CAA2C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAClE,CAAC,CACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,IAAI,CACF,uBAAuB,QAAQ,sBAAsB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7E,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,kDAAkD,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,mBAAmB,KAAK,CAAC,IAAI,2BAA2B,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAE1B,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,YAAY,GAAG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE5C,uEAAuE;IACvE,yDAAyD;IACzD,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;QACzE,IAAI,CACF,gCAAgC,IAAI,cAAc,IAAI,KAAK;YACzD,gBAAgB,KAAK,GAAG,CAC3B,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,wEAAwE;IACxE,yDAAyD;IACzD,MAAM,cAAc,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACvD,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC1C,MAAM,cAAc,GAClB,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;QAClG,IAAI,CAAC,cAAc;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAClE,OAAO,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;IAC/B,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QACnD,IAAI,CACF,uDAAuD,KAAK,CAAC,IAAI,IAAI;YACnE,mBAAmB,KAAK,CAAC,KAAK,4BAA4B,KAAK,CAAC,IAAI,SAAS,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,qBAAqB,CAC5B,QAAQ,EACR;YACE,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ;YACR,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,EACD,GAAG,EACH,UAAU,EACV,KAAK,CACN,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEtC,IAAI,CAAC;QACH,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,IAAI;QACJ,YAAY;KACb,CAAC,CAAC;IAEH,SAAS,KAAK;QACZ,IAAI,CAAC;YACH,OAAO,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

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