@deskwork/core 0.9.5

package/dist/review/start-handlers.js

@@ -0,0 +1,223 @@
+/**
+ * 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 { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { isPlatform } from "../types.js";
+import { writeFrontmatter } from "../frontmatter.js";
+import { createWorkflow, readWorkflows } from "./pipeline.js";
+import { lookupEntry, resolveLongformFilePath, resolveShortformWorkflowFilePath, } from "./workflow-paths.js";
+import { err, ok } from "./result.js";
+const SLUG_RE = /^[a-z0-9][a-z0-9-]*(\/[a-z0-9][a-z0-9-]*)*$/;
+/**
+ * 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 function handleStartLongform(projectRoot, config, body) {
+    if (!body || typeof body !== 'object')
+        return err(400, 'expected JSON object body');
+    const b = body;
+    if (!b.site)
+        return err(400, 'site is required');
+    if (!(b.site in config.sites)) {
+        const known = Object.keys(config.sites).join(', ');
+        return err(400, `unknown site: ${b.site}. Configured: ${known}`);
+    }
+    if (!b.slug || typeof b.slug !== 'string')
+        return err(400, 'slug is required');
+    if (!SLUG_RE.test(b.slug)) {
+        return err(400, `invalid slug: ${b.slug}. Must match ${SLUG_RE}`);
+    }
+    const callerEntryId = b.entryId !== undefined && b.entryId !== '' ? b.entryId : undefined;
+    const entry = lookupEntry(projectRoot, config, b.site, {
+        ...(callerEntryId !== undefined ? { entryId: callerEntryId } : {}),
+        slug: b.slug,
+    });
+    const entryId = callerEntryId ?? entry?.id;
+    const path = resolveLongformFilePath(projectRoot, config, b.site, b.slug, {
+        ...(entryId !== undefined ? { entryId } : {}),
+        ...(entry !== undefined ? { entry } : {}),
+    });
+    if (!existsSync(path)) {
+        return err(404, `blog draft not found at ${path}`);
+    }
+    const markdown = readFileSync(path, 'utf-8');
+    const before = readWorkflows(projectRoot, config).find((w) => {
+        const identityMatch = entryId && w.entryId
+            ? w.entryId === entryId
+            : w.site === b.site && w.slug === b.slug;
+        return (identityMatch &&
+            w.contentKind === 'longform' &&
+            w.state !== 'applied' &&
+            w.state !== 'cancelled');
+    });
+    const workflow = createWorkflow(projectRoot, config, {
+        site: b.site,
+        slug: b.slug,
+        ...(entryId !== undefined && entryId !== '' ? { entryId } : {}),
+        contentKind: 'longform',
+        initialMarkdown: markdown,
+        initialOriginatedBy: 'agent',
+    });
+    return ok({ workflow, existing: !!before && before.id === workflow.id });
+}
+/**
+ * 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 function handleStartShortform(projectRoot, config, body) {
+    if (!body || typeof body !== 'object')
+        return err(400, 'expected JSON object body');
+    const b = body;
+    if (!b.site)
+        return err(400, 'site is required');
+    if (!(b.site in config.sites)) {
+        const known = Object.keys(config.sites).join(', ');
+        return err(400, `unknown site: ${b.site}. Configured: ${known}`);
+    }
+    if (!b.slug || typeof b.slug !== 'string')
+        return err(400, 'slug is required');
+    if (!SLUG_RE.test(b.slug)) {
+        return err(400, `invalid slug: ${b.slug}. Must match ${SLUG_RE}`);
+    }
+    if (!b.platform)
+        return err(400, 'platform is required');
+    if (!isPlatform(b.platform)) {
+        return err(400, `invalid platform: ${String(b.platform)}`);
+    }
+    const channel = b.channel !== undefined && b.channel !== '' ? b.channel : undefined;
+    const callerEntryId = b.entryId !== undefined && b.entryId !== '' ? b.entryId : undefined;
+    const entry = lookupEntry(projectRoot, config, b.site, {
+        ...(callerEntryId !== undefined ? { entryId: callerEntryId } : {}),
+        slug: b.slug,
+    });
+    if (!entry) {
+        return err(404, `no calendar entry for site=${b.site} slug=${b.slug}`);
+    }
+    const entryId = callerEntryId ?? entry.id;
+    let filePath;
+    try {
+        filePath = resolveShortformWorkflowFilePath(projectRoot, config, b.site, b.slug, b.platform, channel, {
+            ...(entryId !== undefined ? { entryId } : {}),
+            entry,
+        });
+    }
+    catch (e) {
+        return err(400, e instanceof Error ? e.message : String(e));
+    }
+    // The shortform path resolver returns undefined when the entry has no
+    // body file scaffolded yet (no entry-dir to anchor against). Shortform
+    // is decoupled from the lifecycle, so we materialize the directory
+    // tree from the slug-template fallback and proceed.
+    if (filePath === undefined) {
+        const fallback = resolveLongformFilePath(projectRoot, config, b.site, b.slug, { ...(entryId !== undefined ? { entryId } : {}), entry });
+        const entryDir = dirname(fallback);
+        const filename = channel !== undefined ? `${b.platform}-${channel}.md` : `${b.platform}.md`;
+        filePath = `${entryDir}/scrapbook/shortform/${filename}`;
+    }
+    // Scaffold the file when missing. Frontmatter carries the
+    // deskwork-namespaced binding so the studio can render the workflow
+    // off the file content directly.
+    let markdown;
+    if (existsSync(filePath)) {
+        markdown = readFileSync(filePath, 'utf-8');
+    }
+    else {
+        mkdirSync(dirname(filePath), { recursive: true });
+        const initialBody = b.initialMarkdown ?? '';
+        const deskworkMeta = {
+            platform: b.platform,
+        };
+        if (channel !== undefined)
+            deskworkMeta.channel = channel;
+        if (entryId !== undefined && entryId !== '')
+            deskworkMeta.id = entryId;
+        const fmData = {
+            title: entry.title,
+            deskwork: deskworkMeta,
+        };
+        writeFrontmatter(filePath, fmData, initialBody);
+        markdown = initialBody;
+    }
+    // Idempotent on (entryId|site+slug, contentKind, platform, channel).
+    const before = readWorkflows(projectRoot, config).find((w) => {
+        const identityMatch = entryId && w.entryId
+            ? w.entryId === entryId
+            : w.site === b.site && w.slug === b.slug;
+        return (identityMatch &&
+            w.contentKind === 'shortform' &&
+            (w.platform ?? null) === (b.platform ?? null) &&
+            (w.channel ?? null) === (channel ?? null) &&
+            w.state !== 'applied' &&
+            w.state !== 'cancelled');
+    });
+    const workflow = createWorkflow(projectRoot, config, {
+        site: b.site,
+        slug: b.slug,
+        ...(entryId !== undefined && entryId !== '' ? { entryId } : {}),
+        contentKind: 'shortform',
+        platform: b.platform,
+        ...(channel !== undefined ? { channel } : {}),
+        initialMarkdown: markdown,
+        initialOriginatedBy: 'agent',
+    });
+    return ok({
+        workflow,
+        existing: !!before && before.id === workflow.id,
+        filePath,
+    });
+}
+// ---------------------------------------------------------------------------
+// Workflow → file dispatch (used by handleCreateVersion)
+// ---------------------------------------------------------------------------
+/**
+ * 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 function workflowFilePath(projectRoot, config, workflow) {
+    if (workflow.contentKind === 'shortform') {
+        if (workflow.platform === undefined) {
+            throw new Error(`shortform workflow ${JSON.stringify(workflow)} has no platform`);
+        }
+        return resolveShortformWorkflowFilePath(projectRoot, config, workflow.site, workflow.slug, workflow.platform, workflow.channel, {
+            ...(workflow.entryId !== undefined ? { entryId: workflow.entryId } : {}),
+        });
+    }
+    return resolveLongformFilePath(projectRoot, config, workflow.site, workflow.slug, {
+        ...(workflow.entryId !== undefined ? { entryId: workflow.entryId } : {}),
+    });
+}
+//# sourceMappingURL=start-handlers.js.map

package/dist/review/start-handlers.js.map

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

package/dist/review/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Editorial review pipeline — data model.
+ *
+ * Ported from audiocontrol.org's scripts/lib/editorial-review/types.ts.
+ * The `Site` type was replaced with `string` since deskwork makes sites
+ * config-driven rather than a hardcoded enum. Platform stays typed —
+ * it's a bounded set in deskwork's editorial types.
+ *
+ * The review pipeline is a journal-backed workflow system: each post
+ * draft gets a workflow, each iteration produces a new version, and
+ * every event (version, annotation, state transition) is an append-only
+ * history entry. Callers reconstruct state by reading the journal.
+ */
+import type { Platform } from '../types.ts';
+export type DraftWorkflowState = 'open' | 'in-review' | 'iterating' | 'approved' | 'applied' | 'cancelled';
+export type ContentKind = 'longform' | 'shortform' | 'outline';
+export type OriginatedBy = 'agent' | 'operator';
+/**
+ * Annotation category for comments — used by the voice-drift report to
+ * aggregate which skill principles produce the most corrections. `other`
+ * is the catch-all.
+ */
+export type AnnotationCategory = 'voice-drift' | 'missing-receipt' | 'tutorial-framing' | 'saas-vocabulary' | 'fake-authority' | 'structural' | 'other';
+/** Character-offset range against the raw markdown source. */
+export interface DraftRange {
+    start: number;
+    end: number;
+}
+interface AnnotationBase {
+    /** ISO-8601 timestamp when the annotation was recorded. */
+    createdAt: string;
+    /** Workflow the annotation belongs to. */
+    workflowId: string;
+    /** Monotonic id within the workflow (server-assigned). */
+    id: string;
+}
+export interface CommentAnnotation extends AnnotationBase {
+    type: 'comment';
+    /** Draft version the comment was attached to. */
+    version: number;
+    /** Character range against the raw markdown of that version. */
+    range: DraftRange;
+    /** Free-text operator comment. */
+    text: string;
+    /** Optional category for review-report aggregation. */
+    category?: AnnotationCategory;
+    /**
+     * The displayed text the operator selected when making the comment.
+     * Used on later versions to re-locate the anchor via `indexOf`: if the
+     * quote appears exactly once in the new version the comment rebases,
+     * otherwise it renders as unresolved-from-v{N}.
+     */
+    anchor?: string;
+}
+export interface EditAnnotation extends AnnotationBase {
+    type: 'edit';
+    /** Version that was edited (the source of the edit). */
+    beforeVersion: number;
+    /** Full markdown of the new version the edit produced. */
+    afterMarkdown: string;
+    /** Unified diff of afterMarkdown against the beforeVersion's markdown. */
+    diff: string;
+}
+export interface ApproveAnnotation extends AnnotationBase {
+    type: 'approve';
+    /** Version the operator approved. */
+    version: number;
+}
+export interface RejectAnnotation extends AnnotationBase {
+    type: 'reject';
+    /** Version the operator rejected. */
+    version: number;
+    /** Optional reason free-text. */
+    reason?: string;
+}
+/**
+ * Marks a comment annotation as resolved. Emitted separately rather than
+ * mutating the comment because the journal is append-only — readers
+ * reconstruct resolved state by scanning for the most recent resolve
+ * annotation per commentId. `resolved: false` re-opens.
+ */
+export interface ResolveAnnotation extends AnnotationBase {
+    type: 'resolve';
+    commentId: string;
+    resolved: boolean;
+}
+/**
+ * Per-iteration agent disposition for a comment. Written when a new
+ * version addresses (or defers) an operator comment. Latest-wins when
+ * rendering the sidebar badge.
+ */
+export interface AddressAnnotation extends AnnotationBase {
+    type: 'address';
+    commentId: string;
+    /** Version the disposition was recorded against (the just-produced version). */
+    version: number;
+    disposition: 'addressed' | 'deferred' | 'wontfix';
+    reason?: string;
+}
+export type DraftAnnotation = CommentAnnotation | EditAnnotation | ApproveAnnotation | RejectAnnotation | ResolveAnnotation | AddressAnnotation;
+export interface DraftVersion {
+    /** 1-based version number; v1 is the initial draft. */
+    version: number;
+    /** Full raw markdown of this version. */
+    markdown: string;
+    /** ISO-8601 when this version was recorded. */
+    createdAt: string;
+    /** Who produced this version — the agent or the operator (edit mode). */
+    originatedBy: OriginatedBy;
+}
+export interface DraftWorkflowItem {
+    /** Stable UUID for this workflow. */
+    id: string;
+    /**
+     * Stable UUID of the target calendar entry. Preferred join key for
+     * `matchesKey` / `findOpenByKey` — survives slug renames. Optional
+     * for legacy workflows created before entry UUIDs landed; those keep
+     * joining via the slug fallback.
+     */
+    entryId?: string;
+    /** Which site this draft belongs to (deskwork config site slug). */
+    site: string;
+    /** Post slug (blog entry slug for longform; calendar entry slug for shortform). */
+    slug: string;
+    /** longform / shortform / outline. */
+    contentKind: ContentKind;
+    /** For shortform only: which distribution platform. */
+    platform?: Platform;
+    /** For shortform only: channel (e.g. `r/synthdiy`). */
+    channel?: string;
+    /** Current state in the review pipeline. */
+    state: DraftWorkflowState;
+    /** Version number of the most recent DraftVersion for this workflow. */
+    currentVersion: number;
+    /** ISO-8601 when the workflow was first created. */
+    createdAt: string;
+    /** ISO-8601 when last modified (state transition or new version). */
+    updatedAt: string;
+}
+/**
+ * A single entry in the editorial-review history journal. Discriminated by
+ * `kind` so versions, annotations, and workflow transitions interleave in
+ * one stream.
+ */
+export type DraftHistoryEntry = {
+    kind: 'workflow-created';
+    at: string;
+    workflow: DraftWorkflowItem;
+} | {
+    kind: 'workflow-state';
+    at: string;
+    workflowId: string;
+    from: DraftWorkflowState;
+    to: DraftWorkflowState;
+} | {
+    kind: 'version';
+    at: string;
+    workflowId: string;
+    version: DraftVersion;
+} | {
+    kind: 'annotation';
+    at: string;
+    annotation: DraftAnnotation;
+};
+/** Allowed state transitions. All others are invalid. */
+export declare const VALID_TRANSITIONS: Readonly<Record<DraftWorkflowState, readonly DraftWorkflowState[]>>;
+export declare function isValidTransition(from: DraftWorkflowState, to: DraftWorkflowState): boolean;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/review/types.js

@@ -0,0 +1,26 @@
+/**
+ * Editorial review pipeline — data model.
+ *
+ * Ported from audiocontrol.org's scripts/lib/editorial-review/types.ts.
+ * The `Site` type was replaced with `string` since deskwork makes sites
+ * config-driven rather than a hardcoded enum. Platform stays typed —
+ * it's a bounded set in deskwork's editorial types.
+ *
+ * The review pipeline is a journal-backed workflow system: each post
+ * draft gets a workflow, each iteration produces a new version, and
+ * every event (version, annotation, state transition) is an append-only
+ * history entry. Callers reconstruct state by reading the journal.
+ */
+/** Allowed state transitions. All others are invalid. */
+export const VALID_TRANSITIONS = {
+    open: ['in-review', 'cancelled'],
+    'in-review': ['iterating', 'approved', 'cancelled'],
+    iterating: ['in-review', 'cancelled'],
+    approved: ['applied', 'cancelled'],
+    applied: [],
+    cancelled: [],
+};
+export function isValidTransition(from, to) {
+    return VALID_TRANSITIONS[from].includes(to);
+}
+//# sourceMappingURL=types.js.map

package/dist/review/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/review/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoLH,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAE1B;IACF,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IAChC,WAAW,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC;IACnD,SAAS,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;IACrC,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;IAClC,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAC/B,IAAwB,EACxB,EAAsB;IAEtB,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC9C,CAAC"}

package/dist/review/workflow-paths.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Workflow → on-disk markdown file resolution.
+ *
+ * Both `handleStartLongform` and `handleCreateVersion` need to translate a
+ * (site, slug, contentKind, entryId?, platform?, channel?) tuple into an
+ * absolute file path. Pulled out of `handlers.ts` to keep that file under
+ * the 500-line guideline and to give the shortform path resolver a clean
+ * home alongside its longform sibling.
+ *
+ * Resolution rules:
+ *
+ *   - `longform` / `outline`: prefer the content index (so writingcontrol-
+ *     shaped non-template paths work); fall back to the site's
+ *     `blogFilenameTemplate` for legacy / pre-doctor entries.
+ *   - `shortform`: defers to `resolveShortformFilePath` in `paths.ts`,
+ *     which composes the entry directory (via `findEntryFile`) with
+ *     `scrapbook/shortform/<platform>[-<channel>].md`.
+ *
+ * The shortform variant returns `undefined` when the entry has no body file
+ * scaffolded yet — the caller decides whether to create the entry directory
+ * or surface a 404. The longform variant always returns a path because the
+ * slug-template fallback is unconditional for it.
+ */
+import type { DeskworkConfig } from '../config.ts';
+import type { ContentIndex } from '../content-index.ts';
+import type { CalendarEntry, Platform } from '../types.ts';
+/**
+ * Read a calendar entry by id or slug for a given site, returning
+ * `undefined` when the calendar is missing or the entry can't be found.
+ */
+export declare function lookupEntry(projectRoot: string, config: DeskworkConfig, site: string, match: {
+    entryId?: string;
+    slug?: string;
+}): CalendarEntry | undefined;
+/**
+ * Hint bundle accepted by the longform/outline path resolver. Any one of
+ * `entryId`, `entry`, or `index` may be supplied; the resolver fills the
+ * rest in.
+ */
+export interface LongformPathHint {
+    entryId?: string;
+    entry?: CalendarEntry;
+    index?: ContentIndex;
+}
+/**
+ * Resolve the absolute path of the markdown file backing a longform or
+ * outline workflow.
+ *
+ * Precedence:
+ *   1. Content index — when an entry id is known (passed in or derived
+ *      from the workflow's site+slug via the calendar), look up the file
+ *      whose frontmatter `deskwork.id:` matches. Refactor-proof.
+ *   2. Slug-template fallback — when no entry id is available (legacy
+ *      workflow, pre-doctor entry, ad-hoc draft with no calendar record),
+ *      fall back to the site's `blogFilenameTemplate`.
+ *
+ * Always returns a path (the slug-template fallback is unconditional);
+ * callers should `existsSync` if they need existence guarantees.
+ */
+export declare function resolveLongformFilePath(projectRoot: string, config: DeskworkConfig, site: string, slug: string, hint: LongformPathHint): string;
+/**
+ * Resolve the absolute path of the markdown file backing a shortform
+ * workflow. Returns `undefined` when the entry has no body file
+ * scaffolded yet — the entry directory cannot be derived in that case
+ * and the caller decides what to do (create the directory tree, or 404).
+ */
+export declare function resolveShortformWorkflowFilePath(projectRoot: string, config: DeskworkConfig, site: string, slug: string, platform: Platform, channel: string | undefined, hint: LongformPathHint): string | undefined;
+//# sourceMappingURL=workflow-paths.d.ts.map

package/dist/review/workflow-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-paths.d.ts","sourceRoot":"","sources":["../../src/review/workflow-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AASxD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,aAAa,GAAG,SAAS,CAgB3B;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,GACrB,MAAM,CAyBR;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,IAAI,EAAE,gBAAgB,GACrB,MAAM,GAAG,SAAS,CAwBpB"}

package/dist/review/workflow-paths.js

@@ -0,0 +1,112 @@
+/**
+ * Workflow → on-disk markdown file resolution.
+ *
+ * Both `handleStartLongform` and `handleCreateVersion` need to translate a
+ * (site, slug, contentKind, entryId?, platform?, channel?) tuple into an
+ * absolute file path. Pulled out of `handlers.ts` to keep that file under
+ * the 500-line guideline and to give the shortform path resolver a clean
+ * home alongside its longform sibling.
+ *
+ * Resolution rules:
+ *
+ *   - `longform` / `outline`: prefer the content index (so writingcontrol-
+ *     shaped non-template paths work); fall back to the site's
+ *     `blogFilenameTemplate` for legacy / pre-doctor entries.
+ *   - `shortform`: defers to `resolveShortformFilePath` in `paths.ts`,
+ *     which composes the entry directory (via `findEntryFile`) with
+ *     `scrapbook/shortform/<platform>[-<channel>].md`.
+ *
+ * The shortform variant returns `undefined` when the entry has no body file
+ * scaffolded yet — the caller decides whether to create the entry directory
+ * or surface a 404. The longform variant always returns a path because the
+ * slug-template fallback is unconditional for it.
+ */
+import { existsSync } from 'node:fs';
+import { buildContentIndex } from "../content-index.js";
+import { resolveCalendarPath, resolveEntryFilePath, resolveShortformFilePath, } from "../paths.js";
+import { readCalendar } from "../calendar.js";
+import { findEntry, findEntryById } from "../calendar-mutations.js";
+/**
+ * Read a calendar entry by id or slug for a given site, returning
+ * `undefined` when the calendar is missing or the entry can't be found.
+ */
+export function lookupEntry(projectRoot, config, site, match) {
+    try {
+        const calendarPath = resolveCalendarPath(projectRoot, config, site);
+        if (!existsSync(calendarPath))
+            return undefined;
+        const cal = readCalendar(calendarPath);
+        if (match.entryId !== undefined && match.entryId !== '') {
+            const byId = findEntryById(cal, match.entryId);
+            if (byId !== undefined)
+                return byId;
+        }
+        if (match.slug !== undefined && match.slug !== '') {
+            return findEntry(cal, match.slug);
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Resolve the absolute path of the markdown file backing a longform or
+ * outline workflow.
+ *
+ * Precedence:
+ *   1. Content index — when an entry id is known (passed in or derived
+ *      from the workflow's site+slug via the calendar), look up the file
+ *      whose frontmatter `deskwork.id:` matches. Refactor-proof.
+ *   2. Slug-template fallback — when no entry id is available (legacy
+ *      workflow, pre-doctor entry, ad-hoc draft with no calendar record),
+ *      fall back to the site's `blogFilenameTemplate`.
+ *
+ * Always returns a path (the slug-template fallback is unconditional);
+ * callers should `existsSync` if they need existence guarantees.
+ */
+export function resolveLongformFilePath(projectRoot, config, site, slug, hint) {
+    let entry = hint.entry;
+    let entryId = hint.entryId;
+    if (entry === undefined && (entryId === undefined || entryId === '')) {
+        entry = lookupEntry(projectRoot, config, site, { slug });
+        entryId = entry?.id;
+    }
+    else if (entry === undefined && entryId !== undefined) {
+        entry = lookupEntry(projectRoot, config, site, { entryId });
+    }
+    else if (entryId === undefined || entryId === '') {
+        entryId = entry?.id;
+    }
+    // Delegate to the top-level helper — same precedence (id-bound path
+    // first, slug-template fallback). The studio passes a per-request
+    // memoized index; the CLI can let it build per call.
+    const idx = hint.index ?? buildContentIndex(projectRoot, config, site);
+    const slugForFallback = entry?.slug ?? slug;
+    return resolveEntryFilePath(projectRoot, config, site, slugForFallback, entryId, idx);
+}
+/**
+ * Resolve the absolute path of the markdown file backing a shortform
+ * workflow. Returns `undefined` when the entry has no body file
+ * scaffolded yet — the entry directory cannot be derived in that case
+ * and the caller decides what to do (create the directory tree, or 404).
+ */
+export function resolveShortformWorkflowFilePath(projectRoot, config, site, slug, platform, channel, hint) {
+    let entry = hint.entry;
+    let entryId = hint.entryId;
+    if (entry === undefined && (entryId === undefined || entryId === '')) {
+        entry = lookupEntry(projectRoot, config, site, { slug });
+        entryId = entry?.id;
+    }
+    else if (entry === undefined && entryId !== undefined) {
+        entry = lookupEntry(projectRoot, config, site, { entryId });
+    }
+    else if (entryId === undefined || entryId === '') {
+        entryId = entry?.id;
+    }
+    return resolveShortformFilePath(projectRoot, config, site, {
+        ...(entryId !== undefined && entryId !== '' ? { id: entryId } : {}),
+        slug: entry?.slug ?? slug,
+    }, platform, channel, hint.index);
+}
+//# sourceMappingURL=workflow-paths.js.map

package/dist/review/workflow-paths.js.map

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