@deskwork/cli 0.9.5

package/dist/cli.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * deskwork — single dispatch entry for the editorial CLI.
+ *
+ * Each subcommand lives in its own module under ./commands. Subcommands
+ * export `run(argv: string[]): Promise<void>`. They emit JSON to stdout
+ * for success, write to stderr + `process.exit(N)` (via lib/cli.ts:fail)
+ * for failure.
+ *
+ * Usage:
+ *   deskwork <subcommand> [args...]
+ *
+ * Examples:
+ *   deskwork install <project-root> <config-file>
+ *   deskwork add "My First Post" --site main
+ *   deskwork outline draft-me --author "Jane"
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/cli.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+/**
+ * deskwork — single dispatch entry for the editorial CLI.
+ *
+ * Each subcommand lives in its own module under ./commands. Subcommands
+ * export `run(argv: string[]): Promise<void>`. They emit JSON to stdout
+ * for success, write to stderr + `process.exit(N)` (via lib/cli.ts:fail)
+ * for failure.
+ *
+ * Usage:
+ *   deskwork <subcommand> [args...]
+ *
+ * Examples:
+ *   deskwork install <project-root> <config-file>
+ *   deskwork add "My First Post" --site main
+ *   deskwork outline draft-me --author "Jane"
+ */
+const SUBCOMMANDS = {
+    add: () => import("./commands/add.js"),
+    approve: () => import("./commands/approve.js"),
+    customize: () => import("./commands/customize.js"),
+    distribute: () => import("./commands/distribute.js"),
+    doctor: () => import("./commands/doctor.js"),
+    draft: () => import("./commands/draft.js"),
+    ingest: () => import("./commands/ingest.js"),
+    install: () => import("./commands/install.js"),
+    iterate: () => import("./commands/iterate.js"),
+    outline: () => import("./commands/outline.js"),
+    pause: () => import("./commands/pause.js"),
+    plan: () => import("./commands/plan.js"),
+    publish: () => import("./commands/publish.js"),
+    resume: () => import("./commands/resume.js"),
+    'review-cancel': () => import("./commands/review-cancel.js"),
+    'review-help': () => import("./commands/review-help.js"),
+    'review-report': () => import("./commands/review-report.js"),
+    'review-start': () => import("./commands/review-start.js"),
+    'shortform-start': () => import("./commands/shortform-start.js"),
+};
+const subcommand = process.argv[2];
+const rawArgv = process.argv.slice(3);
+if (!subcommand || subcommand === 'help' || subcommand === '--help') {
+    printUsage();
+    process.exit(subcommand ? 0 : 2);
+}
+// Each command treats the first positional as <project-root>. To keep
+// invocations short ("deskwork add 'My Post'" instead of
+// "deskwork add . 'My Post'"), we inject process.cwd() when the user
+// didn't pass an explicit path. The heuristic: the first non-flag arg
+// is path-like only when it starts with `/`, `./`, `../`, or is exactly `.`.
+// Anything else (a title, a slug, a flag) means "no project-root passed".
+const argv = injectProjectRoot(rawArgv);
+const loader = SUBCOMMANDS[subcommand];
+if (!loader) {
+    process.stderr.write(`unknown subcommand: ${subcommand}\n`);
+    process.stderr.write(`Available: ${Object.keys(SUBCOMMANDS).sort().join(', ')}\n`);
+    process.exit(2);
+}
+const mod = await loader();
+await mod.run(argv);
+function injectProjectRoot(args) {
+    const firstPositional = args.find((a) => !a.startsWith('--'));
+    if (firstPositional && pathLike(firstPositional))
+        return args;
+    return [process.cwd(), ...args];
+}
+function pathLike(s) {
+    return s === '.' || s.startsWith('/') || s.startsWith('./') || s.startsWith('../');
+}
+function printUsage() {
+    const out = subcommand ? process.stdout : process.stderr;
+    out.write('Usage: deskwork <subcommand> [args...]\n\n');
+    out.write('Lifecycle:\n');
+    out.write('  install         bootstrap deskwork in a project\n');
+    out.write('  ingest          backfill existing markdown into the calendar\n');
+    out.write('  add             append an idea to the calendar\n');
+    out.write('  plan            move Ideas → Planned with keywords\n');
+    out.write('  outline         scaffold + move Planned → Outlining\n');
+    out.write('  draft           move Outlining → Drafting\n');
+    out.write('  publish         move to Published\n');
+    out.write('  pause           move a non-terminal entry to Paused\n');
+    out.write('  resume          restore a Paused entry to its prior stage\n\n');
+    out.write('Maintenance:\n');
+    out.write('  doctor          audit/repair binding metadata\n');
+    out.write('  customize       copy a plugin default into .deskwork/<category>/<name>.ts\n\n');
+    out.write('Review loop:\n');
+    out.write('  review-start    enqueue a longform draft for review\n');
+    out.write('  shortform-start enqueue a shortform draft for review\n');
+    out.write('  iterate         snapshot agent revision; back to in-review\n');
+    out.write('  approve         finalize an approved workflow\n');
+    out.write('  review-cancel   cancel a workflow\n');
+    out.write('  review-help     list open workflows\n');
+    out.write('  review-report   voice-drift report\n\n');
+    out.write('Distribution:\n');
+    out.write('  distribute      record a posted shortform URL on the calendar\n\n');
+    out.write('Run `deskwork <subcommand>` with no further args to see its usage.\n');
+}
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/add.d.ts

@@ -0,0 +1,13 @@
+/**
+ * deskwork-add — append a new idea to the editorial calendar.
+ *
+ * Usage:
+ *   deskwork-add <project-root> [--site <slug>] [--type blog|youtube|tool]
+ *                [--content-url URL] [--source manual|analytics]
+ *                <title> [description]
+ *
+ * Writes the calendar atomically. Emits a JSON result on stdout:
+ *   { "slug": "...", "stage": "Ideas", "site": "...", "calendarPath": "..." }
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

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

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

package/dist/commands/add.js

@@ -0,0 +1,91 @@
+/**
+ * deskwork-add — append a new idea to the editorial calendar.
+ *
+ * Usage:
+ *   deskwork-add <project-root> [--site <slug>] [--type blog|youtube|tool]
+ *                [--content-url URL] [--source manual|analytics]
+ *                <title> [description]
+ *
+ * Writes the calendar atomically. Emits a JSON result on stdout:
+ *   { "slug": "...", "stage": "Ideas", "site": "...", "calendarPath": "..." }
+ */
+import { readConfig } from '@deskwork/core/config';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { addEntry } from '@deskwork/core/calendar-mutations';
+import { resolveSite, resolveCalendarPath } from '@deskwork/core/paths';
+import { isContentType } from '@deskwork/core/types';
+import { absolutize, emit, fail, parseArgs } from '@deskwork/core/cli-args';
+export async function run(argv) {
+    const KNOWN_FLAGS = ['site', 'type', 'content-url', 'source', 'slug'];
+    const SLUG_RE = /^[a-z0-9][a-z0-9-]*(\/[a-z0-9][a-z0-9-]*)*$/;
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork-add <project-root> [--site <slug>] [--type blog|youtube|tool] ' +
+            '[--content-url URL] [--source manual|analytics] [--slug <path>] ' +
+            '<title> [description]', 2);
+    }
+    if (flags.slug !== undefined && !SLUG_RE.test(flags.slug)) {
+        fail(`--slug must be one or more /-separated kebab-case segments ` +
+            `(got "${flags.slug}")`, 2);
+    }
+    const [rootArg, title, ...rest] = positional;
+    const description = rest.join(' ').trim();
+    const projectRoot = absolutize(rootArg);
+    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);
+    let contentType;
+    if (flags.type !== undefined) {
+        if (!isContentType(flags.type)) {
+            fail(`Invalid --type "${flags.type}". Must be one of: blog, youtube, tool.`);
+        }
+        contentType = flags.type;
+    }
+    let source = 'manual';
+    if (flags.source !== undefined) {
+        if (flags.source !== 'manual' && flags.source !== 'analytics') {
+            fail(`Invalid --source "${flags.source}". Must be "manual" or "analytics".`);
+        }
+        source = flags.source;
+    }
+    const calendar = readCalendar(calendarPath);
+    let entry;
+    try {
+        entry = addEntry(calendar, title, {
+            description,
+            source,
+            ...(contentType !== undefined ? { contentType } : {}),
+            ...(flags['content-url'] !== undefined ? { contentUrl: flags['content-url'] } : {}),
+            ...(flags.slug !== undefined ? { slug: flags.slug } : {}),
+        });
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    writeCalendar(calendarPath, calendar);
+    emit({
+        slug: entry.slug,
+        title: entry.title,
+        stage: entry.stage,
+        description: entry.description,
+        site,
+        calendarPath,
+        contentType: entry.contentType,
+        contentUrl: entry.contentUrl,
+    });
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/approve.d.ts

@@ -0,0 +1,18 @@
+/**
+ * deskwork-approve — terminal write step for the review loop.
+ *
+ * For **longform**, the SSOT invariant says disk is already the approved
+ * content (the studio save handler writes disk first, approve annotation
+ * captures the current version). This helper just transitions the
+ * workflow to 'applied'. If disk has moved on since the approve click,
+ * the helper refuses rather than silently rolling back.
+ *
+ * For **shortform**, the approved markdown is written into the matching
+ * DistributionRecord's `shortform` field in the calendar.
+ *
+ * Usage:
+ *   deskwork-approve <project-root> [--site <slug>] <slug>
+ *   deskwork-approve <project-root> [--site <slug>] <slug> --platform <p> [--channel <c>]
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=approve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../src/commands/approve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6BH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+MvD"}

package/dist/commands/approve.js

@@ -0,0 +1,179 @@
+/**
+ * deskwork-approve — terminal write step for the review loop.
+ *
+ * For **longform**, the SSOT invariant says disk is already the approved
+ * content (the studio save handler writes disk first, approve annotation
+ * captures the current version). This helper just transitions the
+ * workflow to 'applied'. If disk has moved on since the approve click,
+ * the helper refuses rather than silently rolling back.
+ *
+ * For **shortform**, the approved markdown is written into the matching
+ * DistributionRecord's `shortform` field in the calendar.
+ *
+ * Usage:
+ *   deskwork-approve <project-root> [--site <slug>] <slug>
+ *   deskwork-approve <project-root> [--site <slug>] <slug> --platform <p> [--channel <c>]
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { readConfig } from '@deskwork/core/config';
+import { resolveSite, resolveCalendarPath, resolveEntryFilePath, resolveShortformFilePath, } from '@deskwork/core/paths';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { parseFrontmatter } from '@deskwork/core/frontmatter';
+import { handleGetWorkflow, } from '@deskwork/core/review/handlers';
+import { readAnnotations, transitionState, } from '@deskwork/core/review/pipeline';
+import { isPlatform } 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'];
+    const SLUG_RE = /^[a-z0-9][a-z0-9-]*(\/[a-z0-9][a-z0-9-]*)*$/;
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork-approve <project-root> [--site <slug>] <slug> ' +
+            '[--platform <p>] [--channel <c>]', 2);
+    }
+    const [rootArg, slug] = positional;
+    const projectRoot = absolutize(rootArg);
+    if (!SLUG_RE.test(slug)) {
+        fail(`invalid slug: ${slug} (must match ${SLUG_RE})`);
+    }
+    if (flags.platform !== undefined && !isPlatform(flags.platform)) {
+        fail(`Invalid --platform "${flags.platform}".`);
+    }
+    let config;
+    try {
+        config = readConfig(projectRoot);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    const site = resolveSite(config, flags.site);
+    const contentKind = flags.platform ? 'shortform' : 'longform';
+    const fetched = handleGetWorkflow(projectRoot, config, {
+        id: null,
+        site,
+        slug,
+        contentKind,
+        platform: flags.platform ?? null,
+        channel: flags.channel ?? null,
+    });
+    if (fetched.status !== 200 || !isSuccessBody(fetched.body)) {
+        fail(`no ${contentKind} workflow for ${site}/${slug}: ${errorMessage(fetched.body)}`);
+    }
+    const workflow = fetched.body.workflow;
+    const versions = fetched.body.versions;
+    if (workflow.state !== 'approved') {
+        fail(`Workflow state is '${workflow.state}', not 'approved'. ` +
+            `Click Approve in the review UI first (that records which version was approved).`);
+    }
+    const annotations = readAnnotations(projectRoot, config, workflow.id);
+    const approveAnn = latestApprove(annotations);
+    const approvedVersion = approveAnn?.version ?? workflow.currentVersion;
+    if (contentKind === 'longform') {
+        applyLongform(workflow, approvedVersion);
+    }
+    else {
+        applyShortform(workflow, versions, approvedVersion);
+    }
+    function applyLongform(workflow, approvedVersion) {
+        if (approvedVersion !== workflow.currentVersion) {
+            fail(`Approved v${approvedVersion}, but workflow is at v${workflow.currentVersion}. ` +
+                `Disk has moved on since the approve click — re-click Approve on v${workflow.currentVersion} or iterate back.`);
+        }
+        // The workflow already records the stable entry id; prefer it for
+        // path resolution so the UUID-bound file wins over the slug-template
+        // (Issue #67).
+        const blogFile = resolveEntryFilePath(projectRoot, config, site, slug, workflow.entryId);
+        if (!existsSync(blogFile)) {
+            fail(`Blog file missing at ${blogFile}. Nothing to approve against.`);
+        }
+        transitionState(projectRoot, config, workflow.id, 'applied');
+        emit({
+            workflowId: workflow.id,
+            site,
+            slug,
+            contentKind: 'longform',
+            state: 'applied',
+            version: approvedVersion,
+            filePath: blogFile,
+        });
+    }
+    function applyShortform(workflow, _versions, approvedVersion) {
+        if (!flags.platform)
+            fail('--platform is required for shortform workflows');
+        if (!isPlatform(flags.platform))
+            fail(`Invalid --platform "${flags.platform}".`);
+        // Phase 21a: shortform is now disk-backed. Read the on-disk file as
+        // the SSOT — the journal version is just the latest snapshot, but
+        // every save writes to disk first. Strip the frontmatter so the
+        // calendar's `## Shortform Copy` section captures the body only.
+        const filePath = resolveShortformFilePath(projectRoot, config, site, { slug }, flags.platform, flags.channel);
+        if (filePath === undefined || !existsSync(filePath)) {
+            const shown = filePath ?? '(unresolved)';
+            fail(`Shortform file missing at ${shown}. ` +
+                `The file is the SSOT — re-run /deskwork:shortform-start if needed.`);
+        }
+        const fileSrc = readFileSync(filePath, 'utf-8');
+        const approvedMarkdown = parseFrontmatter(fileSrc).body.replace(/^\n+/, '');
+        const calendarPath = resolveCalendarPath(projectRoot, config, site);
+        const cal = readCalendar(calendarPath);
+        const channelLower = flags.channel?.toLowerCase();
+        const match = cal.distributions.find((d) => {
+            if (d.slug !== slug)
+                return false;
+            if (d.platform !== flags.platform)
+                return false;
+            if (channelLower !== undefined) {
+                return (d.channel?.toLowerCase() ?? '') === channelLower;
+            }
+            return !d.channel;
+        });
+        if (!match) {
+            const channelBit = flags.channel ? ` · channel=${flags.channel}` : '';
+            fail(`No distribution record for (slug=${slug}, platform=${flags.platform}${channelBit}). ` +
+                `Create it with /deskwork:distribute first.`);
+        }
+        match.shortform = approvedMarkdown;
+        writeCalendar(calendarPath, cal);
+        transitionState(projectRoot, config, workflow.id, 'applied');
+        emit({
+            workflowId: workflow.id,
+            site,
+            slug,
+            contentKind: 'shortform',
+            state: 'applied',
+            version: approvedVersion,
+            platform: flags.platform,
+            channel: flags.channel,
+            calendarPath,
+            filePath,
+        });
+    }
+    function latestApprove(annotations) {
+        const approves = annotations.filter((a) => a.type === 'approve');
+        if (approves.length === 0)
+            return undefined;
+        return approves.reduce((a, b) => (a.createdAt > b.createdAt ? a : b));
+    }
+    function isSuccessBody(body) {
+        if (typeof body !== 'object' || body === null)
+            return false;
+        return 'workflow' in body && 'versions' in body;
+    }
+    function errorMessage(body) {
+        if (typeof body === 'object' && body !== null) {
+            const value = Reflect.get(body, 'error');
+            if (typeof value === 'string')
+                return value;
+        }
+        return 'unknown error';
+    }
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=approve.js.map

package/dist/commands/approve.js.map

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

package/dist/commands/customize.d.ts

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

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

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