@deskwork/core 0.9.5

package/dist/review/handlers.d.ts

@@ -0,0 +1,55 @@
+/**
+ * HTTP-shape handlers for the review pipeline. Astro API routes in
+ * plugins/deskwork/studio/ call these directly; the handlers return
+ * { status, body } results that routes serialize as JSON.
+ *
+ * Ported from audiocontrol.org's scripts/lib/editorial-review/handlers.ts.
+ * Site validation now checks against config.sites rather than a hardcoded
+ * SITES array, and the longform blog file path uses resolveBlogFilePath
+ * (which honors the site's blogFilenameTemplate config).
+ */
+import type { DeskworkConfig } from '../config.ts';
+import { type HandlerResult } from './result.ts';
+export type { HandlerResult } from './result.ts';
+export { handleStartLongform, handleStartShortform } from './start-handlers.ts';
+export declare function handleAnnotate(projectRoot: string, config: DeskworkConfig, body: unknown): HandlerResult;
+export declare function handleListAnnotations(projectRoot: string, config: DeskworkConfig, query: {
+    workflowId: string | null;
+    version: string | null;
+}): HandlerResult;
+export declare function handleDecision(projectRoot: string, config: DeskworkConfig, body: unknown): HandlerResult;
+/**
+ * Return a workflow plus its full version history. The client looks up
+ * by one of (in priority order):
+ *   1. Workflow id — exact match on `DraftWorkflowItem.id`.
+ *   2. `entryId` — stable calendar-entry UUID; join survives slug renames.
+ *      Preferred over slug when available.
+ *   3. (site, slug) — legacy lookup, still supported for workflows that
+ *      have no entryId stamped.
+ *
+ * All lookups can additionally filter by (contentKind, platform, channel).
+ */
+export declare function handleGetWorkflow(projectRoot: string, config: DeskworkConfig, query: {
+    id: string | null;
+    entryId?: string | null;
+    site: string | null;
+    slug: string | null;
+    contentKind: string | null;
+    platform: string | null;
+    channel: string | null;
+}): HandlerResult;
+/**
+ * Operator edit-mode submission. Writes disk first (SSOT invariant),
+ * then appends a DraftVersion + edit annotation with the server-computed
+ * diff.
+ */
+export declare function handleCreateVersion(projectRoot: string, config: DeskworkConfig, body: unknown): HandlerResult;
+/**
+ * Minimal line-level diff. `-` / `+` prefixed lines for removed/added
+ * content, `=` for unchanged. Paired with `applyLineDiff` the operation
+ * is reversible.
+ */
+export declare function lineDiff(a: string, b: string): string;
+/** Apply a line-diff (as produced by `lineDiff`) to reconstruct the after-text. */
+export declare function applyLineDiff(diff: string): string;
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/review/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAanD,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE1D,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAUhF,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,GACZ,aAAa,CAgGf;AAED,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,aAAa,CAWf;AAOD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,GACZ,aAAa,CAaf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE;IACL,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,GACA,aAAa,CAoDf;AAQD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,GACZ,aAAa,CAyDf;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBrD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/dist/review/handlers.js

@@ -0,0 +1,307 @@
+/**
+ * HTTP-shape handlers for the review pipeline. Astro API routes in
+ * plugins/deskwork/studio/ call these directly; the handlers return
+ * { status, body } results that routes serialize as JSON.
+ *
+ * Ported from audiocontrol.org's scripts/lib/editorial-review/handlers.ts.
+ * Site validation now checks against config.sites rather than a hardcoded
+ * SITES array, and the longform blog file path uses resolveBlogFilePath
+ * (which honors the site's blogFilenameTemplate config).
+ */
+import { existsSync, writeFileSync } from 'node:fs';
+import { appendAnnotation, appendVersion, mintAnnotation, readAnnotations, readVersions, readWorkflow, readWorkflows, transitionState, } from "./pipeline.js";
+import { workflowFilePath } from "./start-handlers.js";
+import { err, ok } from "./result.js";
+export { handleStartLongform, handleStartShortform } from "./start-handlers.js";
+export function handleAnnotate(projectRoot, config, body) {
+    if (!body || typeof body !== 'object')
+        return err(400, 'expected JSON object body');
+    const draft = body;
+    if (!draft.type)
+        return err(400, 'type is required');
+    if (!draft.workflowId)
+        return err(400, 'workflowId is required');
+    const workflow = readWorkflow(projectRoot, config, draft.workflowId);
+    if (!workflow)
+        return err(404, `unknown workflow: ${draft.workflowId}`);
+    switch (draft.type) {
+        case 'comment': {
+            const d = draft;
+            if (typeof d.version !== 'number')
+                return err(400, 'comment.version is required');
+            if (!d.range || typeof d.range.start !== 'number' || typeof d.range.end !== 'number') {
+                return err(400, 'comment.range with numeric start/end is required');
+            }
+            if (typeof d.text !== 'string')
+                return err(400, 'comment.text is required');
+            const annotation = mintAnnotation({
+                type: 'comment',
+                workflowId: draft.workflowId,
+                version: d.version,
+                range: d.range,
+                text: d.text,
+                ...(d.category !== undefined ? { category: d.category } : {}),
+                ...(typeof d.anchor === 'string' ? { anchor: d.anchor } : {}),
+            });
+            appendAnnotation(projectRoot, config, annotation);
+            return ok({ annotation });
+        }
+        case 'edit': {
+            const d = draft;
+            if (typeof d.beforeVersion !== 'number')
+                return err(400, 'edit.beforeVersion is required');
+            if (typeof d.afterMarkdown !== 'string')
+                return err(400, 'edit.afterMarkdown is required');
+            if (typeof d.diff !== 'string')
+                return err(400, 'edit.diff is required');
+            const annotation = mintAnnotation({
+                type: 'edit',
+                workflowId: draft.workflowId,
+                beforeVersion: d.beforeVersion,
+                afterMarkdown: d.afterMarkdown,
+                diff: d.diff,
+            });
+            appendAnnotation(projectRoot, config, annotation);
+            return ok({ annotation });
+        }
+        case 'approve':
+        case 'reject': {
+            const d = draft;
+            if (typeof d.version !== 'number')
+                return err(400, `${draft.type}.version is required`);
+            const annotation = mintAnnotation({
+                type: draft.type,
+                workflowId: draft.workflowId,
+                version: d.version,
+                ...(draft.type === 'reject' && 'reason' in d ? { reason: d.reason } : {}),
+            });
+            appendAnnotation(projectRoot, config, annotation);
+            return ok({ annotation });
+        }
+        case 'resolve': {
+            const d = draft;
+            if (typeof d.commentId !== 'string' || d.commentId.length === 0) {
+                return err(400, 'resolve.commentId is required');
+            }
+            const resolved = typeof d.resolved === 'boolean' ? d.resolved : true;
+            const annotation = mintAnnotation({
+                type: 'resolve',
+                workflowId: draft.workflowId,
+                commentId: d.commentId,
+                resolved,
+            });
+            appendAnnotation(projectRoot, config, annotation);
+            return ok({ annotation });
+        }
+        case 'address': {
+            const d = draft;
+            if (typeof d.commentId !== 'string' || d.commentId.length === 0) {
+                return err(400, 'address.commentId is required');
+            }
+            if (typeof d.version !== 'number')
+                return err(400, 'address.version is required');
+            if (d.disposition !== 'addressed' && d.disposition !== 'deferred' && d.disposition !== 'wontfix') {
+                return err(400, "address.disposition must be 'addressed' | 'deferred' | 'wontfix'");
+            }
+            const annotation = mintAnnotation({
+                type: 'address',
+                workflowId: draft.workflowId,
+                commentId: d.commentId,
+                version: d.version,
+                disposition: d.disposition,
+                ...(typeof d.reason === 'string' ? { reason: d.reason } : {}),
+            });
+            appendAnnotation(projectRoot, config, annotation);
+            return ok({ annotation });
+        }
+        default:
+            return err(400, `unknown annotation type: ${String(draft.type)}`);
+    }
+}
+export function handleListAnnotations(projectRoot, config, query) {
+    if (!query.workflowId)
+        return err(400, 'workflowId query param is required');
+    const version = query.version !== null && query.version !== undefined
+        ? parseInt(query.version, 10)
+        : undefined;
+    if (version !== undefined && Number.isNaN(version)) {
+        return err(400, 'version must be a number');
+    }
+    const annotations = readAnnotations(projectRoot, config, query.workflowId, version);
+    return ok({ annotations });
+}
+export function handleDecision(projectRoot, config, body) {
+    if (!body || typeof body !== 'object')
+        return err(400, 'expected JSON object body');
+    const d = body;
+    if (!d.workflowId)
+        return err(400, 'workflowId is required');
+    if (!d.to)
+        return err(400, 'to is required');
+    try {
+        const updated = transitionState(projectRoot, config, d.workflowId, d.to);
+        return ok({ workflow: updated });
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        const status = message.startsWith('Unknown workflow') ? 404 : 409;
+        return err(status, message);
+    }
+}
+/**
+ * Return a workflow plus its full version history. The client looks up
+ * by one of (in priority order):
+ *   1. Workflow id — exact match on `DraftWorkflowItem.id`.
+ *   2. `entryId` — stable calendar-entry UUID; join survives slug renames.
+ *      Preferred over slug when available.
+ *   3. (site, slug) — legacy lookup, still supported for workflows that
+ *      have no entryId stamped.
+ *
+ * All lookups can additionally filter by (contentKind, platform, channel).
+ */
+export function handleGetWorkflow(projectRoot, config, query) {
+    if (query.id) {
+        const workflow = readWorkflow(projectRoot, config, query.id);
+        if (!workflow)
+            return err(404, `unknown workflow id: ${query.id}`);
+        return ok({
+            workflow,
+            versions: readVersions(projectRoot, config, workflow.id),
+        });
+    }
+    if (!query.entryId && (!query.site || !query.slug)) {
+        return err(400, 'either id, entryId, or (site & slug) query params are required');
+    }
+    if (query.site && !(query.site in config.sites)) {
+        const known = Object.keys(config.sites).join(', ');
+        return err(400, `unknown site: ${query.site}. Configured: ${known}`);
+    }
+    const contentKind = (query.contentKind ?? 'longform');
+    const candidates = readWorkflows(projectRoot, config).filter((w) => {
+        // Stable-identity join when entryId is present on both sides;
+        // fall back to (site, slug) for legacy workflows. Always still
+        // filter by contentKind + platform + channel to keep scope.
+        const identityMatch = query.entryId && w.entryId
+            ? w.entryId === query.entryId
+            : query.site && query.slug
+                ? w.site === query.site && w.slug === query.slug
+                : false;
+        return (identityMatch &&
+            w.contentKind === contentKind &&
+            (w.platform ?? null) === (query.platform ?? null) &&
+            (w.channel ?? null) === (query.channel ?? null));
+    });
+    if (candidates.length === 0) {
+        const key = query.entryId
+            ? `entryId=${query.entryId}`
+            : `${query.site ?? '?'}/${query.slug ?? '?'}`;
+        return err(404, `no workflow for ${key} (${contentKind})`);
+    }
+    // Prefer active over terminal; within each tier, prefer most-recently created.
+    const isTerminal = (s) => s === 'applied' || s === 'cancelled';
+    const match = [...candidates].sort((a, b) => {
+        const aTerm = isTerminal(a.state) ? 1 : 0;
+        const bTerm = isTerminal(b.state) ? 1 : 0;
+        if (aTerm !== bTerm)
+            return aTerm - bTerm;
+        return b.createdAt.localeCompare(a.createdAt);
+    })[0];
+    return ok({ workflow: match, versions: readVersions(projectRoot, config, match.id) });
+}
+/**
+ * Operator edit-mode submission. Writes disk first (SSOT invariant),
+ * then appends a DraftVersion + edit annotation with the server-computed
+ * diff.
+ */
+export function handleCreateVersion(projectRoot, config, body) {
+    if (!body || typeof body !== 'object')
+        return err(400, 'expected JSON object body');
+    const d = body;
+    if (!d.workflowId)
+        return err(400, 'workflowId is required');
+    if (typeof d.beforeVersion !== 'number')
+        return err(400, 'beforeVersion is required');
+    if (typeof d.afterMarkdown !== 'string')
+        return err(400, 'afterMarkdown is required');
+    const workflow = readWorkflow(projectRoot, config, d.workflowId);
+    if (!workflow)
+        return err(404, `unknown workflow: ${d.workflowId}`);
+    const versions = readVersions(projectRoot, config, d.workflowId);
+    const before = versions.find((v) => v.version === d.beforeVersion);
+    if (!before)
+        return err(404, `unknown beforeVersion: ${d.beforeVersion}`);
+    if (before.markdown === d.afterMarkdown) {
+        return err(400, 'afterMarkdown is identical to beforeVersion — no edit to record');
+    }
+    const diff = lineDiff(before.markdown, d.afterMarkdown);
+    // SSOT: the markdown file on disk IS the article. Write disk first,
+    // then snapshot to the journal. All content kinds (longform, outline,
+    // shortform) are disk-backed — Phase 21a removed the shortform special
+    // case so the studio's save/iterate/approve handlers see one shape.
+    //
+    // Resolve via the content index first (so writingcontrol-shaped layouts
+    // where slug != fs path work), with template fallback for legacy
+    // / pre-doctor cases. For shortform, the path goes through
+    // resolveShortformFilePath (entry-dir + scrapbook/shortform/<…>.md).
+    const targetFile = workflowFilePath(projectRoot, config, workflow);
+    if (targetFile === undefined || !existsSync(targetFile)) {
+        const shown = targetFile ?? '(unresolved)';
+        if (workflow.contentKind === 'shortform') {
+            return err(500, `cannot save: shortform file missing at ${shown}. ` +
+                `Run /deskwork:shortform-start to scaffold the file before saving edits.`);
+        }
+        return err(500, `cannot save: blog file missing at ${shown}. ` +
+            `Scaffold the post with /deskwork:outline before saving edits.`);
+    }
+    writeFileSync(targetFile, d.afterMarkdown, 'utf-8');
+    const version = appendVersion(projectRoot, config, d.workflowId, d.afterMarkdown, 'operator');
+    const annotation = mintAnnotation({
+        type: 'edit',
+        workflowId: d.workflowId,
+        beforeVersion: d.beforeVersion,
+        afterMarkdown: d.afterMarkdown,
+        diff,
+    });
+    appendAnnotation(projectRoot, config, annotation);
+    return ok({ version, annotation });
+}
+/**
+ * Minimal line-level diff. `-` / `+` prefixed lines for removed/added
+ * content, `=` for unchanged. Paired with `applyLineDiff` the operation
+ * is reversible.
+ */
+export function lineDiff(a, b) {
+    const aLines = a.split('\n');
+    const bLines = b.split('\n');
+    const out = [];
+    const n = Math.max(aLines.length, bLines.length);
+    for (let i = 0; i < n; i++) {
+        const aLine = aLines[i];
+        const bLine = bLines[i];
+        if (aLine === bLine) {
+            if (aLine !== undefined)
+                out.push(`= ${aLine}`);
+        }
+        else {
+            if (aLine !== undefined)
+                out.push(`- ${aLine}`);
+            if (bLine !== undefined)
+                out.push(`+ ${bLine}`);
+        }
+    }
+    return out.join('\n');
+}
+/** Apply a line-diff (as produced by `lineDiff`) to reconstruct the after-text. */
+export function applyLineDiff(diff) {
+    const out = [];
+    for (const line of diff.split('\n')) {
+        if (line.startsWith('= '))
+            out.push(line.slice(2));
+        else if (line.startsWith('+ '))
+            out.push(line.slice(2));
+        else if (line === '=' || line === '+')
+            out.push('');
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=handlers.js.map

package/dist/review/handlers.js.map

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

package/dist/review/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Barrel export for the review pipeline. Skills, bin/ helpers, and the
+ * studio Astro routes all import from here.
+ */
+export * from './types.ts';
+export * from './pipeline.ts';
+export * from './handlers.ts';
+export * from './start-handlers.ts';
+export * from './workflow-paths.ts';
+export * from './report.ts';
+export * from './render.ts';
+export { envelopeFor, unwrap, synthesizeHistoryId } from './journal-mappers.ts';
+export type { JournaledHistoryEntry } from './journal-mappers.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/review/index.js

@@ -0,0 +1,13 @@
+/**
+ * Barrel export for the review pipeline. Skills, bin/ helpers, and the
+ * studio Astro routes all import from here.
+ */
+export * from "./types.js";
+export * from "./pipeline.js";
+export * from "./handlers.js";
+export * from "./start-handlers.js";
+export * from "./workflow-paths.js";
+export * from "./report.js";
+export * from "./render.js";
+export { envelopeFor, unwrap, synthesizeHistoryId } from "./journal-mappers.js";
+//# sourceMappingURL=index.js.map

package/dist/review/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/review/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/review/journal-mappers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * journal-mappers.ts — adapt DraftHistoryEntry variants to the shared
+ * journal storage contract (one file per record, each with `id` +
+ * `timestamp`).
+ *
+ * The history event union doesn't carry a uniform id/timestamp shape
+ * (variants are discriminated by `kind`). To route each event into its
+ * own journal file we wrap it in an envelope keyed by a deterministic id
+ * synthesized from the event's payload. Readers unwrap the envelope
+ * before returning DraftHistoryEntry[] to the rest of the codebase.
+ */
+import type { DraftHistoryEntry } from './types.ts';
+/** Storage wrapper for history events. */
+export interface JournaledHistoryEntry {
+    id: string;
+    timestamp: string;
+    entry: DraftHistoryEntry;
+}
+/**
+ * Synthesize a deterministic id for a history event. The same event maps
+ * to the same filename every time, so re-emitting an equivalent event
+ * overwrites in place rather than duplicating.
+ *
+ * Rules:
+ *   - workflow-created: `created-<workflowId>` (one per workflow)
+ *   - workflow-state:   `state-<workflowId>-<normalized-timestamp>`
+ *   - version:          `version-<workflowId>-v<n>`
+ *   - annotation:       the annotation's own id
+ */
+export declare function synthesizeHistoryId(entry: DraftHistoryEntry): string;
+/** Wrap a history event in its journal envelope. */
+export declare function envelopeFor(entry: DraftHistoryEntry): JournaledHistoryEntry;
+/** Unwrap an envelope back to the original history event. */
+export declare function unwrap(env: JournaledHistoryEntry): DraftHistoryEntry;
+//# sourceMappingURL=journal-mappers.d.ts.map

package/dist/review/journal-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-mappers.d.ts","sourceRoot":"","sources":["../../src/review/journal-mappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAWpE;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,qBAAqB,CAM3E;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,GAAG,EAAE,qBAAqB,GAAG,iBAAiB,CAEpE"}

package/dist/review/journal-mappers.js

@@ -0,0 +1,48 @@
+/**
+ * journal-mappers.ts — adapt DraftHistoryEntry variants to the shared
+ * journal storage contract (one file per record, each with `id` +
+ * `timestamp`).
+ *
+ * The history event union doesn't carry a uniform id/timestamp shape
+ * (variants are discriminated by `kind`). To route each event into its
+ * own journal file we wrap it in an envelope keyed by a deterministic id
+ * synthesized from the event's payload. Readers unwrap the envelope
+ * before returning DraftHistoryEntry[] to the rest of the codebase.
+ */
+import { normalizeTimestamp } from "../journal.js";
+/**
+ * Synthesize a deterministic id for a history event. The same event maps
+ * to the same filename every time, so re-emitting an equivalent event
+ * overwrites in place rather than duplicating.
+ *
+ * Rules:
+ *   - workflow-created: `created-<workflowId>` (one per workflow)
+ *   - workflow-state:   `state-<workflowId>-<normalized-timestamp>`
+ *   - version:          `version-<workflowId>-v<n>`
+ *   - annotation:       the annotation's own id
+ */
+export function synthesizeHistoryId(entry) {
+    switch (entry.kind) {
+        case 'workflow-created':
+            return `created-${entry.workflow.id}`;
+        case 'workflow-state':
+            return `state-${entry.workflowId}-${normalizeTimestamp(entry.at)}`;
+        case 'version':
+            return `version-${entry.workflowId}-v${entry.version.version}`;
+        case 'annotation':
+            return entry.annotation.id;
+    }
+}
+/** Wrap a history event in its journal envelope. */
+export function envelopeFor(entry) {
+    return {
+        id: synthesizeHistoryId(entry),
+        timestamp: entry.at,
+        entry,
+    };
+}
+/** Unwrap an envelope back to the original history event. */
+export function unwrap(env) {
+    return env.entry;
+}
+//# sourceMappingURL=journal-mappers.js.map

package/dist/review/journal-mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-mappers.js","sourceRoot":"","sources":["../../src/review/journal-mappers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,kBAAkB;YACrB,OAAO,WAAW,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACxC,KAAK,gBAAgB;YACnB,OAAO,SAAS,KAAK,CAAC,UAAU,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;QACrE,KAAK,SAAS;YACZ,OAAO,WAAW,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACjE,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,OAAO;QACL,EAAE,EAAE,mBAAmB,CAAC,KAAK,CAAC;QAC9B,SAAS,EAAE,KAAK,CAAC,EAAE;QACnB,KAAK;KACN,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,MAAM,CAAC,GAA0B;IAC/C,OAAO,GAAG,CAAC,KAAK,CAAC;AACnB,CAAC"}

package/dist/review/pipeline.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 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 type { Platform } from '../types.ts';
+import type { DeskworkConfig } from '../config.ts';
+import { type ContentKind, type DraftAnnotation, type DraftHistoryEntry, type DraftVersion, type DraftWorkflowItem, type DraftWorkflowState, type OriginatedBy } from './types.ts';
+/** Absolute path to the review journal root for a project. */
+export declare function reviewJournalRoot(projectRoot: string, config: DeskworkConfig): string;
+/** Path to the pipeline journal (one file per workflow). */
+export declare function pipelinePath(projectRoot: string, config: DeskworkConfig): string;
+/** Path to the history journal (one file per event). */
+export declare function historyPath(projectRoot: string, config: DeskworkConfig): string;
+/**
+ * Read every workflow (one record per id by construction — state transitions
+ * overwrite the existing file in place).
+ */
+export declare function readWorkflows(projectRoot: string, config: DeskworkConfig): DraftWorkflowItem[];
+/** Read the full history log, oldest first. */
+export declare function readHistory(projectRoot: string, config: DeskworkConfig): DraftHistoryEntry[];
+export declare function readWorkflow(projectRoot: string, config: DeskworkConfig, id: string): DraftWorkflowItem | null;
+export interface CreateWorkflowParams {
+    /**
+     * Stable UUID of the target calendar entry. Preferred over `slug` as
+     * the natural key so renames don't split a single entry's workflow
+     * history across two keys. Optional for callers that haven't migrated
+     * yet; when present, it replaces the (site, slug) match in idempotent
+     * lookup.
+     */
+    entryId?: string;
+    site: string;
+    slug: string;
+    contentKind: ContentKind;
+    platform?: Platform;
+    channel?: string;
+    initialMarkdown: string;
+    initialOriginatedBy?: OriginatedBy;
+}
+/**
+ * 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 declare function createWorkflow(projectRoot: string, config: DeskworkConfig, params: CreateWorkflowParams): DraftWorkflowItem;
+/** List workflows in non-terminal states; optionally scoped to a site. */
+export declare function listOpen(projectRoot: string, config: DeskworkConfig, site?: string): DraftWorkflowItem[];
+/**
+ * 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 declare function transitionState(projectRoot: string, config: DeskworkConfig, workflowId: string, to: DraftWorkflowState): DraftWorkflowItem;
+/**
+ * Append a new version. Increments currentVersion on the workflow.
+ * Does not transition state — callers combine with transitionState().
+ */
+export declare function appendVersion(projectRoot: string, config: DeskworkConfig, workflowId: string, markdown: string, originatedBy: OriginatedBy): DraftVersion;
+/** Append an annotation to history. Does not transition state. */
+export declare function appendAnnotation(projectRoot: string, config: DeskworkConfig, annotation: DraftAnnotation): void;
+export declare function readVersions(projectRoot: string, config: DeskworkConfig, workflowId: string): DraftVersion[];
+/**
+ * Annotations for a workflow, optionally filtered to a specific version.
+ * comment/approve/reject match by `version`; edit matches by `beforeVersion`.
+ */
+export declare function readAnnotations(projectRoot: string, config: DeskworkConfig, workflowId: string, version?: number): DraftAnnotation[];
+/** Mint an annotation with a server-assigned id and timestamp. */
+export declare function mintAnnotation<T extends Omit<DraftAnnotation, 'id' | 'createdAt'>>(partial: T): T & {
+    id: string;
+    createdAt: string;
+};
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/review/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAMnD,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAMpB,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACrB,MAAM,CAER;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAEhF;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAE/E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACrB,iBAAiB,EAAE,CAIrB;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACrB,iBAAiB,EAAE,CAKrB;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,MAAM,GACT,iBAAiB,GAAG,IAAI,CAE1B;AAwBD,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,YAAY,CAAC;CACpC;AAiCD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,oBAAoB,GAC3B,iBAAiB,CAwCnB;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,CAAC,EAAE,MAAM,GACZ,iBAAiB,EAAE,CAOrB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,kBAAkB,GACrB,iBAAiB,CAmBnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,YAAY,GACzB,YAAY,CAuBd;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,eAAe,GAC1B,IAAI,CAMN;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,YAAY,EAAE,CAQhB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,eAAe,EAAE,CAkBnB;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAC5B,CAAC,SAAS,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,WAAW,CAAC,EACnD,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAMnD"}