@deskwork/core 0.9.5

package/dist/review/pipeline.js

@@ -0,0 +1,234 @@
+/**
+ * Editorial review pipeline — workflow + version API.
+ *
+ * Ported from audiocontrol.org's scripts/lib/editorial-review/pipeline.ts.
+ * Storage: two journal directories under `<journalDir>/` — a `pipeline/`
+ * dir holding one file per workflow (latest state) and a `history/` dir
+ * holding one file per event (versions, annotations, state transitions).
+ *
+ * The default `journalDir` is `.deskwork/review-journal`. Host projects
+ * migrating from a prior layout can override via the top-level
+ * `reviewJournalDir` config field (e.g. audiocontrol points it at
+ * `journal/editorial` to read existing data).
+ */
+import { randomUUID } from 'node:crypto';
+import { join } from 'node:path';
+import { appendJournal, readJournal } from "../journal.js";
+import { envelopeFor, unwrap, } from "./journal-mappers.js";
+import { isValidTransition, } from "./types.js";
+const DEFAULT_JOURNAL_DIR = '.deskwork/review-journal';
+const PIPELINE_SUBDIR = 'pipeline';
+const HISTORY_SUBDIR = 'history';
+/** Absolute path to the review journal root for a project. */
+export function reviewJournalRoot(projectRoot, config) {
+    return join(projectRoot, config.reviewJournalDir ?? DEFAULT_JOURNAL_DIR);
+}
+/** Path to the pipeline journal (one file per workflow). */
+export function pipelinePath(projectRoot, config) {
+    return join(reviewJournalRoot(projectRoot, config), PIPELINE_SUBDIR);
+}
+/** Path to the history journal (one file per event). */
+export function historyPath(projectRoot, config) {
+    return join(reviewJournalRoot(projectRoot, config), HISTORY_SUBDIR);
+}
+/**
+ * Read every workflow (one record per id by construction — state transitions
+ * overwrite the existing file in place).
+ */
+export function readWorkflows(projectRoot, config) {
+    return readJournal(pipelinePath(projectRoot, config), {
+        timestampField: 'createdAt',
+    });
+}
+/** Read the full history log, oldest first. */
+export function readHistory(projectRoot, config) {
+    const envelopes = readJournal(historyPath(projectRoot, config));
+    return envelopes.map(unwrap);
+}
+export function readWorkflow(projectRoot, config, id) {
+    return readWorkflows(projectRoot, config).find((w) => w.id === id) ?? null;
+}
+function writeWorkflow(projectRoot, config, workflow) {
+    appendJournal(pipelinePath(projectRoot, config), workflow, {
+        idField: 'id',
+        timestampField: 'createdAt',
+    });
+}
+function writeHistory(projectRoot, config, entry) {
+    appendJournal(historyPath(projectRoot, config), envelopeFor(entry), {
+        idField: 'id',
+        timestampField: 'timestamp',
+    });
+}
+function matchesKey(w, k) {
+    // Prefer entryId when both sides have it — stable identity survives
+    // slug renames. Fall back to (site, slug) otherwise so legacy
+    // workflows remain matchable.
+    const idMatch = k.entryId && w.entryId
+        ? w.entryId === k.entryId
+        : w.site === k.site && w.slug === k.slug;
+    return (idMatch &&
+        w.contentKind === k.contentKind &&
+        (w.platform ?? null) === (k.platform ?? null) &&
+        (w.channel ?? null) === (k.channel ?? null));
+}
+function findOpenByKey(projectRoot, config, params) {
+    return (readWorkflows(projectRoot, config).find((w) => matchesKey(w, params) &&
+        w.state !== 'applied' &&
+        w.state !== 'cancelled') ?? null);
+}
+/**
+ * Create a new workflow plus its v1. Idempotent on the natural key
+ * (site, slug, contentKind, platform?, channel?) — if a non-terminal
+ * workflow already exists for that tuple, returns it unchanged.
+ */
+export function createWorkflow(projectRoot, config, params) {
+    const existing = findOpenByKey(projectRoot, config, params);
+    if (existing)
+        return existing;
+    const now = new Date().toISOString();
+    const item = {
+        id: randomUUID(),
+        site: params.site,
+        slug: params.slug,
+        contentKind: params.contentKind,
+        state: 'open',
+        currentVersion: 1,
+        createdAt: now,
+        updatedAt: now,
+    };
+    if (params.entryId !== undefined)
+        item.entryId = params.entryId;
+    if (params.platform !== undefined)
+        item.platform = params.platform;
+    if (params.channel !== undefined)
+        item.channel = params.channel;
+    writeWorkflow(projectRoot, config, item);
+    writeHistory(projectRoot, config, {
+        kind: 'workflow-created',
+        at: now,
+        workflow: item,
+    });
+    const v1 = {
+        version: 1,
+        markdown: params.initialMarkdown,
+        createdAt: now,
+        originatedBy: params.initialOriginatedBy ?? 'agent',
+    };
+    writeHistory(projectRoot, config, {
+        kind: 'version',
+        at: now,
+        workflowId: item.id,
+        version: v1,
+    });
+    return item;
+}
+/** List workflows in non-terminal states; optionally scoped to a site. */
+export function listOpen(projectRoot, config, site) {
+    return readWorkflows(projectRoot, config).filter((w) => w.state !== 'applied' &&
+        w.state !== 'cancelled' &&
+        (!site || w.site === site));
+}
+/**
+ * Transition a workflow to a new state. Validates against VALID_TRANSITIONS
+ * and appends a history event. The workflow's file is overwritten in place.
+ */
+export function transitionState(projectRoot, config, workflowId, to) {
+    const current = readWorkflow(projectRoot, config, workflowId);
+    if (!current)
+        throw new Error(`Unknown workflow: ${workflowId}`);
+    if (!isValidTransition(current.state, to)) {
+        throw new Error(`Invalid transition for workflow ${workflowId}: ${current.state} → ${to}`);
+    }
+    const now = new Date().toISOString();
+    const updated = { ...current, state: to, updatedAt: now };
+    writeWorkflow(projectRoot, config, updated);
+    writeHistory(projectRoot, config, {
+        kind: 'workflow-state',
+        at: now,
+        workflowId,
+        from: current.state,
+        to,
+    });
+    return updated;
+}
+/**
+ * Append a new version. Increments currentVersion on the workflow.
+ * Does not transition state — callers combine with transitionState().
+ */
+export function appendVersion(projectRoot, config, workflowId, markdown, originatedBy) {
+    const current = readWorkflow(projectRoot, config, workflowId);
+    if (!current)
+        throw new Error(`Unknown workflow: ${workflowId}`);
+    const now = new Date().toISOString();
+    const version = {
+        version: current.currentVersion + 1,
+        markdown,
+        createdAt: now,
+        originatedBy,
+    };
+    writeHistory(projectRoot, config, {
+        kind: 'version',
+        at: now,
+        workflowId,
+        version,
+    });
+    const updated = {
+        ...current,
+        currentVersion: version.version,
+        updatedAt: now,
+    };
+    writeWorkflow(projectRoot, config, updated);
+    return version;
+}
+/** Append an annotation to history. Does not transition state. */
+export function appendAnnotation(projectRoot, config, annotation) {
+    writeHistory(projectRoot, config, {
+        kind: 'annotation',
+        at: annotation.createdAt,
+        annotation,
+    });
+}
+export function readVersions(projectRoot, config, workflowId) {
+    const versions = [];
+    for (const entry of readHistory(projectRoot, config)) {
+        if (entry.kind === 'version' && entry.workflowId === workflowId) {
+            versions.push(entry.version);
+        }
+    }
+    return versions.sort((a, b) => a.version - b.version);
+}
+/**
+ * Annotations for a workflow, optionally filtered to a specific version.
+ * comment/approve/reject match by `version`; edit matches by `beforeVersion`.
+ */
+export function readAnnotations(projectRoot, config, workflowId, version) {
+    const anns = [];
+    for (const entry of readHistory(projectRoot, config)) {
+        if (entry.kind !== 'annotation')
+            continue;
+        const a = entry.annotation;
+        if (a.workflowId !== workflowId)
+            continue;
+        if (version === undefined) {
+            anns.push(a);
+            continue;
+        }
+        const matchesVersion = (a.type === 'comment' && a.version === version) ||
+            (a.type === 'approve' && a.version === version) ||
+            (a.type === 'reject' && a.version === version) ||
+            (a.type === 'edit' && a.beforeVersion === version);
+        if (matchesVersion)
+            anns.push(a);
+    }
+    return anns;
+}
+/** Mint an annotation with a server-assigned id and timestamp. */
+export function mintAnnotation(partial) {
+    return {
+        ...partial,
+        id: randomUUID(),
+        createdAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/review/pipeline.js.map

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

package/dist/review/render.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Render a draft's markdown body as HTML for the studio review surface.
+ *
+ * Frontmatter parsing reuses the main lib/frontmatter module so the
+ * shape stays consistent across deskwork. Markdown → HTML uses unified
+ * + remark + rehype; the studio renders the HTML into the same
+ * BlogLayout-equivalent that the published site would use.
+ *
+ * Mirrors the public Astro pipeline: the body's leading `# Title` is
+ * stripped (BlogLayout / review shell renders title from frontmatter,
+ * the body repeat is a print-magazine convention that reads as
+ * throat-clearing on the web) and standalone images are wrapped in
+ * `<figure><figcaption>`. Outline-strip is NOT added here on purpose —
+ * the review surface needs the outline visible for annotate-and-iterate
+ * work.
+ */
+export interface ParsedDraft {
+    /** Frontmatter values. Values are whatever YAML parses them to. */
+    frontmatter: Record<string, unknown>;
+    /** Everything after the closing `---`. */
+    body: string;
+}
+/** Split a draft into its frontmatter and body. */
+export declare function parseDraftFrontmatter(markdown: string): ParsedDraft;
+/** Render a markdown string as HTML. */
+export declare function renderMarkdownToHtml(markdown: string): Promise<string>;
+//# sourceMappingURL=render.d.ts.map

package/dist/review/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/review/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAYH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAGnE;AAED,wCAAwC;AACxC,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5E"}

package/dist/review/render.js

@@ -0,0 +1,42 @@
+/**
+ * Render a draft's markdown body as HTML for the studio review surface.
+ *
+ * Frontmatter parsing reuses the main lib/frontmatter module so the
+ * shape stays consistent across deskwork. Markdown → HTML uses unified
+ * + remark + rehype; the studio renders the HTML into the same
+ * BlogLayout-equivalent that the published site would use.
+ *
+ * Mirrors the public Astro pipeline: the body's leading `# Title` is
+ * stripped (BlogLayout / review shell renders title from frontmatter,
+ * the body repeat is a print-magazine convention that reads as
+ * throat-clearing on the web) and standalone images are wrapped in
+ * `<figure><figcaption>`. Outline-strip is NOT added here on purpose —
+ * the review surface needs the outline visible for annotate-and-iterate
+ * work.
+ */
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkRehype from 'remark-rehype';
+import rehypeStringify from 'rehype-stringify';
+import { parseFrontmatter } from "../frontmatter.js";
+// @ts-expect-error — JS module without a .d.ts; the plugin is plain mdast traversal.
+import remarkImageFigure from '../remark-image-figure.mjs';
+// @ts-expect-error — JS module without a .d.ts; the plugin is plain mdast traversal.
+import remarkStripFirstH1 from '../remark-strip-first-h1.mjs';
+/** Split a draft into its frontmatter and body. */
+export function parseDraftFrontmatter(markdown) {
+    const { data, body } = parseFrontmatter(markdown);
+    return { frontmatter: data, body };
+}
+/** Render a markdown string as HTML. */
+export async function renderMarkdownToHtml(markdown) {
+    const result = await unified()
+        .use(remarkParse)
+        .use(remarkStripFirstH1)
+        .use(remarkImageFigure)
+        .use(remarkRehype)
+        .use(rehypeStringify)
+        .process(markdown);
+    return String(result);
+}
+//# sourceMappingURL=render.js.map

package/dist/review/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/review/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,eAAe,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,qFAAqF;AACrF,OAAO,iBAAiB,MAAM,4BAA4B,CAAC;AAC3D,qFAAqF;AACrF,OAAO,kBAAkB,MAAM,8BAA8B,CAAC;AAS9D,mDAAmD;AACnD,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE;SAC3B,GAAG,CAAC,WAAW,CAAC;SAChB,GAAG,CAAC,kBAAkB,CAAC;SACvB,GAAG,CAAC,iBAAiB,CAAC;SACtB,GAAG,CAAC,YAAY,CAAC;SACjB,GAAG,CAAC,eAAe,CAAC;SACpB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC"}

package/dist/review/report.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Voice-drift feedback signal — aggregate comment annotations across
+ * completed review cycles to surface which voice-skill principles are
+ * catching the most operator corrections. The signal surfaces; revising
+ * voice skills themselves stays human-driven.
+ *
+ * Ported from audiocontrol.org's scripts/lib/editorial-review/report.ts.
+ * Takes `DeskworkConfig` instead of an implicit rootDir-only contract.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { AnnotationCategory } from './types.ts';
+export interface ReportOptions {
+    /** Include only workflows that have reached a terminal state. Default true. */
+    terminalOnly?: boolean;
+    /** Optional site filter. */
+    site?: string;
+}
+export interface CategoryCounts {
+    voiceDrift: number;
+    missingReceipt: number;
+    tutorialFraming: number;
+    saasVocabulary: number;
+    fakeAuthority: number;
+    structural: number;
+    other: number;
+}
+export interface ReportBreakdown {
+    approvedCount: number;
+    cancelledCount: number;
+    totalComments: number;
+    commentsByCategory: CategoryCounts;
+    rejectCount: number;
+}
+export interface ReviewReport {
+    all: ReportBreakdown;
+    bySite: Record<string, ReportBreakdown>;
+    topCategories: Array<{
+        category: AnnotationCategory;
+        count: number;
+    }>;
+}
+/**
+ * Build a voice-drift report from the pipeline + history. Counts only
+ * workflows that reached a terminal state by default — in-flight
+ * workflows don't represent settled signal yet.
+ */
+export declare function buildReport(projectRoot: string, config: DeskworkConfig, opts?: ReportOptions): ReviewReport;
+/** Render a report as plain text for the review-report skill. */
+export declare function renderReport(report: ReviewReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/review/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/review/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,YAAY,CAAC;AAGzE,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,cAAc,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,eAAe,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,aAAa,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,kBAAkB,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AA2DD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,aAAkB,GACvB,YAAY,CAyDd;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAgCzD"}

package/dist/review/report.js

@@ -0,0 +1,164 @@
+/**
+ * Voice-drift feedback signal — aggregate comment annotations across
+ * completed review cycles to surface which voice-skill principles are
+ * catching the most operator corrections. The signal surfaces; revising
+ * voice skills themselves stays human-driven.
+ *
+ * Ported from audiocontrol.org's scripts/lib/editorial-review/report.ts.
+ * Takes `DeskworkConfig` instead of an implicit rootDir-only contract.
+ */
+import { readHistory, readWorkflows } from "./pipeline.js";
+const CATEGORY_KEYS = [
+    'voice-drift',
+    'missing-receipt',
+    'tutorial-framing',
+    'saas-vocabulary',
+    'fake-authority',
+    'structural',
+    'other',
+];
+function emptyCounts() {
+    return {
+        voiceDrift: 0,
+        missingReceipt: 0,
+        tutorialFraming: 0,
+        saasVocabulary: 0,
+        fakeAuthority: 0,
+        structural: 0,
+        other: 0,
+    };
+}
+function emptyBreakdown() {
+    return {
+        approvedCount: 0,
+        cancelledCount: 0,
+        totalComments: 0,
+        commentsByCategory: emptyCounts(),
+        rejectCount: 0,
+    };
+}
+function bump(counts, category) {
+    const key = category ?? 'other';
+    switch (key) {
+        case 'voice-drift':
+            counts.voiceDrift++;
+            break;
+        case 'missing-receipt':
+            counts.missingReceipt++;
+            break;
+        case 'tutorial-framing':
+            counts.tutorialFraming++;
+            break;
+        case 'saas-vocabulary':
+            counts.saasVocabulary++;
+            break;
+        case 'fake-authority':
+            counts.fakeAuthority++;
+            break;
+        case 'structural':
+            counts.structural++;
+            break;
+        default: counts.other++;
+    }
+}
+function categoryValue(counts, cat) {
+    switch (cat) {
+        case 'voice-drift': return counts.voiceDrift;
+        case 'missing-receipt': return counts.missingReceipt;
+        case 'tutorial-framing': return counts.tutorialFraming;
+        case 'saas-vocabulary': return counts.saasVocabulary;
+        case 'fake-authority': return counts.fakeAuthority;
+        case 'structural': return counts.structural;
+        case 'other': return counts.other;
+    }
+}
+/**
+ * Build a voice-drift report from the pipeline + history. Counts only
+ * workflows that reached a terminal state by default — in-flight
+ * workflows don't represent settled signal yet.
+ */
+export function buildReport(projectRoot, config, opts = {}) {
+    const { terminalOnly = true, site } = opts;
+    const workflows = readWorkflows(projectRoot, config).filter((w) => !site || w.site === site);
+    const terminalStates = ['applied', 'cancelled'];
+    const scoped = terminalOnly
+        ? workflows.filter((w) => terminalStates.includes(w.state))
+        : workflows;
+    const workflowIds = new Set(scoped.map((w) => w.id));
+    const all = emptyBreakdown();
+    const bySite = {};
+    for (const w of scoped) {
+        if (w.state === 'applied')
+            all.approvedCount++;
+        if (w.state === 'cancelled')
+            all.cancelledCount++;
+        const b = bySite[w.site] ?? emptyBreakdown();
+        if (w.state === 'applied')
+            b.approvedCount++;
+        if (w.state === 'cancelled')
+            b.cancelledCount++;
+        bySite[w.site] = b;
+    }
+    const workflowSiteById = new Map(scoped.map((w) => [w.id, w.site]));
+    for (const entry of readHistory(projectRoot, config)) {
+        if (entry.kind !== 'annotation')
+            continue;
+        const ann = entry.annotation;
+        if (!workflowIds.has(ann.workflowId))
+            continue;
+        const s = workflowSiteById.get(ann.workflowId);
+        if (ann.type === 'comment') {
+            all.totalComments++;
+            bump(all.commentsByCategory, ann.category);
+            if (s) {
+                const b = bySite[s] ?? emptyBreakdown();
+                b.totalComments++;
+                bump(b.commentsByCategory, ann.category);
+                bySite[s] = b;
+            }
+        }
+        else if (ann.type === 'reject') {
+            all.rejectCount++;
+            if (s) {
+                const b = bySite[s] ?? emptyBreakdown();
+                b.rejectCount++;
+                bySite[s] = b;
+            }
+        }
+    }
+    const topCategories = CATEGORY_KEYS.map((cat) => ({
+        category: cat,
+        count: categoryValue(all.commentsByCategory, cat),
+    })).sort((a, b) => b.count - a.count);
+    return { all, bySite, topCategories };
+}
+/** Render a report as plain text for the review-report skill. */
+export function renderReport(report) {
+    const lines = [];
+    lines.push('Editorial review — voice-drift signal');
+    lines.push('');
+    lines.push(`Scope: ${report.all.approvedCount} approved, ${report.all.cancelledCount} cancelled (${report.all.rejectCount} reject annotations recorded)`);
+    lines.push(`Total comments: ${report.all.totalComments}`);
+    lines.push('');
+    lines.push('Categories (most → least frequent):');
+    for (const { category, count } of report.topCategories) {
+        lines.push(`  ${category.padEnd(18)} ${count}`);
+    }
+    const siteKeys = Object.keys(report.bySite).sort();
+    if (siteKeys.length > 1) {
+        lines.push('');
+        lines.push('Per-site breakdown:');
+        for (const s of siteKeys) {
+            const b = report.bySite[s];
+            lines.push('');
+            lines.push(`  ${s}: ${b.approvedCount} approved, ${b.cancelledCount} cancelled, ${b.totalComments} comments, ${b.rejectCount} rejects`);
+            for (const cat of CATEGORY_KEYS) {
+                const n = categoryValue(b.commentsByCategory, cat);
+                if (n > 0)
+                    lines.push(`    ${cat.padEnd(18)} ${n}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

package/dist/review/report.js.map

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

package/dist/review/result.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Common HTTP-shape result type for review handlers. Pulled out so the
+ * handler modules (`handlers.ts`, `start-handlers.ts`) can share it
+ * without one importing the other.
+ */
+export interface HandlerResult {
+    status: number;
+    body: unknown;
+}
+export declare function err(status: number, message: string): HandlerResult;
+export declare function ok(body: unknown): HandlerResult;
+//# sourceMappingURL=result.d.ts.map

package/dist/review/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/review/result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAElE;AAED,wBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAE/C"}

package/dist/review/result.js

@@ -0,0 +1,12 @@
+/**
+ * Common HTTP-shape result type for review handlers. Pulled out so the
+ * handler modules (`handlers.ts`, `start-handlers.ts`) can share it
+ * without one importing the other.
+ */
+export function err(status, message) {
+    return { status, body: { error: message } };
+}
+export function ok(body) {
+    return { status: 200, body };
+}
+//# sourceMappingURL=result.js.map

package/dist/review/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/review/result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe;IACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,IAAa;IAC9B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/review/start-handlers.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Workflow-creation handlers (longform, shortform). Pulled out of
+ * `handlers.ts` to keep that file under the 500-line guideline.
+ *
+ * Both handlers follow the same shape:
+ *   1. Validate input (site/slug/platform — same SLUG_RE the rest of
+ *      deskwork uses).
+ *   2. Resolve the calendar entry (idem-key for the workflow tuple).
+ *   3. Resolve the on-disk markdown file path. Longform requires the file
+ *      to already exist (scaffolded by /deskwork:outline). Shortform
+ *      scaffolds the file in place when missing — frontmatter carries
+ *      the deskwork-namespaced binding (`deskwork: { id, platform,
+ *      channel? }`), body starts as `initialMarkdown ?? ''`.
+ *   4. Call `createWorkflow` (idempotent on the tuple).
+ *
+ * Phase 21a: shortform IS the same shape as longform — file on disk is
+ * SSOT, journal stores snapshots, the studio's review surface renders
+ * both kinds identically.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import { type Platform } from '../types.ts';
+import { type HandlerResult } from './result.ts';
+/**
+ * Enqueue a longform draft review from the studio dashboard. Reads the
+ * blog post markdown from disk (honoring blogFilenameTemplate) and calls
+ * createWorkflow. Idempotent on (entryId | (site, slug), 'longform').
+ */
+export declare function handleStartLongform(projectRoot: string, config: DeskworkConfig, body: unknown): HandlerResult;
+/**
+ * Enqueue a shortform draft review. Mirrors `handleStartLongform`'s shape:
+ * resolve the calendar entry by slug, compute the shortform file path,
+ * scaffold the file (frontmatter `deskwork: { id, platform, channel? }` +
+ * body) when missing, then `createWorkflow` with `contentKind: 'shortform'`
+ * and v1 mirroring the file body.
+ *
+ * Idempotent: if a workflow already exists for the
+ * (entryId|site+slug, contentKind, platform, channel) tuple,
+ * `createWorkflow` returns it unchanged. If the file already exists on
+ * disk (operator resuming), creation is skipped and the body is read.
+ *
+ * Lifecycle decoupling: shortform is independent of the longform
+ * outline → drafting → published path. If the entry has no body file
+ * yet (Ideas / Planned / Outlining without scaffold), this handler
+ * still works — it creates the entry directory + scrapbook subdirs
+ * before writing the shortform file.
+ */
+export declare function handleStartShortform(projectRoot: string, config: DeskworkConfig, body: unknown): HandlerResult;
+/**
+ * Resolve the on-disk markdown file path for any kind of workflow.
+ * Dispatches on `contentKind`. Returns `undefined` only for shortform when
+ * the entry directory cannot be derived (no entry id and no body file
+ * scaffolded yet).
+ */
+export declare function workflowFilePath(projectRoot: string, config: DeskworkConfig, workflow: {
+    site: string;
+    slug: string;
+    contentKind: 'longform' | 'shortform' | 'outline';
+    entryId?: string;
+    platform?: Platform;
+    channel?: string;
+}): string | undefined;
+//# sourceMappingURL=start-handlers.d.ts.map

package/dist/review/start-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-handlers.d.ts","sourceRoot":"","sources":["../../src/review/start-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQxD,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAW1D;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,GACZ,aAAa,CAoDf;AAiBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,GACZ,aAAa,CAsHf;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,MAAM,GAAG,SAAS,CAsBpB"}