@deskwork/core 0.9.5

package/dist/body-state.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Classify whether a scaffolded blog post's body is still the placeholder
+ * or has been replaced with real prose.
+ *
+ * The scaffold produced by `scaffoldBlogPost` writes an H1, optionally a
+ * `## Outline` section, and a `<!-- Write your post here -->` placeholder.
+ * The outline is a legitimate authored artifact during Outlining; its
+ * presence must NOT make the body look written. This helper strips the
+ * outline and classifies what remains:
+ *
+ *   - `missing`     — file does not exist
+ *   - `placeholder` — file exists but body (minus outline) is only the
+ *                     placeholder marker and whitespace
+ *   - `written`     — file exists and prose remains after placeholder + outline
+ *                     are accounted for
+ *
+ * Used by the review/studio surfaces to branch on whether a post has
+ * actually been drafted, not just scaffolded.
+ */
+export type BodyState = 'missing' | 'placeholder' | 'written';
+/** The body-placeholder marker written by scaffoldBlogPost. Exact string. */
+export declare const PLACEHOLDER_MARKER = "<!-- Write your post here -->";
+/**
+ * Classify the body of a scaffolded blog post at `filePath`.
+ */
+export declare function bodyState(filePath: string): BodyState;
+//# sourceMappingURL=body-state.d.ts.map

package/dist/body-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-state.d.ts","sourceRoot":"","sources":["../src/body-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;AAE9D,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,kCAAkC,CAAC;AAoBlE;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAkBrD"}

package/dist/body-state.js

@@ -0,0 +1,62 @@
+/**
+ * Classify whether a scaffolded blog post's body is still the placeholder
+ * or has been replaced with real prose.
+ *
+ * The scaffold produced by `scaffoldBlogPost` writes an H1, optionally a
+ * `## Outline` section, and a `<!-- Write your post here -->` placeholder.
+ * The outline is a legitimate authored artifact during Outlining; its
+ * presence must NOT make the body look written. This helper strips the
+ * outline and classifies what remains:
+ *
+ *   - `missing`     — file does not exist
+ *   - `placeholder` — file exists but body (minus outline) is only the
+ *                     placeholder marker and whitespace
+ *   - `written`     — file exists and prose remains after placeholder + outline
+ *                     are accounted for
+ *
+ * Used by the review/studio surfaces to branch on whether a post has
+ * actually been drafted, not just scaffolded.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+/** The body-placeholder marker written by scaffoldBlogPost. Exact string. */
+export const PLACEHOLDER_MARKER = '<!-- Write your post here -->';
+/**
+ * Strip the `## Outline` section (heading through the next H2 or EOF)
+ * so its content doesn't masquerade as body prose.
+ */
+function stripOutlineSection(body) {
+    const lines = body.split('\n');
+    const startIdx = lines.findIndex((line) => /^##[ \t]+Outline\b/.test(line));
+    if (startIdx < 0)
+        return body;
+    let endIdx = lines.length;
+    for (let i = startIdx + 1; i < lines.length; i++) {
+        if (/^##[ \t]+/.test(lines[i])) {
+            endIdx = i;
+            break;
+        }
+    }
+    return [...lines.slice(0, startIdx), ...lines.slice(endIdx)].join('\n');
+}
+/**
+ * Classify the body of a scaffolded blog post at `filePath`.
+ */
+export function bodyState(filePath) {
+    if (!existsSync(filePath))
+        return 'missing';
+    const content = readFileSync(filePath, 'utf8');
+    // `\r?\n` mirrors `frontmatter.ts`'s FRONTMATTER_RE so files saved
+    // with Windows line endings classify the same way as `\n`-only files.
+    const fmMatch = content.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+    const body = fmMatch ? content.slice(fmMatch[0].length) : content;
+    const withoutH1 = body.replace(/^\s*#[^\n]*\n?/, '');
+    const withoutOutline = stripOutlineSection(withoutH1);
+    const trimmed = withoutOutline.trim();
+    if (trimmed === PLACEHOLDER_MARKER)
+        return 'placeholder';
+    if (trimmed === '')
+        return 'placeholder';
+    const withoutPlaceholder = trimmed.replace(PLACEHOLDER_MARKER, '').trim();
+    return withoutPlaceholder.length > 0 ? 'written' : 'placeholder';
+}
+//# sourceMappingURL=body-state.js.map

package/dist/body-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-state.js","sourceRoot":"","sources":["../src/body-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAInD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,+BAA+B,CAAC;AAElE;;;GAGG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACjD,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,MAAM,GAAG,CAAC,CAAC;YACX,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE/C,mEAAmE;IACnE,sEAAsE;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAElE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,OAAO,KAAK,kBAAkB;QAAE,OAAO,aAAa,CAAC;IACzD,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,aAAa,CAAC;IAEzC,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1E,OAAO,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;AACnE,CAAC"}

package/dist/calendar-mutations.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Pure mutations on an in-memory EditorialCalendar.
+ *
+ * None of these touch disk — callers parse the calendar, mutate, then write
+ * it back. Each mutation validates stage invariants (an entry must be in
+ * Planned to be drafted, etc.) and throws a descriptive Error if violated.
+ */
+import { type CalendarEntry, type ContentType, type DistributionRecord, type EditorialCalendar, type Platform } from './types.ts';
+/** Convert a title to a URL-safe slug. */
+export declare function slugify(title: string): string;
+/** Add a new entry to the Ideas stage. */
+export declare function addEntry(calendar: EditorialCalendar, title: string, opts?: {
+    description?: string;
+    source?: CalendarEntry['source'];
+    contentType?: ContentType;
+    contentUrl?: string;
+    /**
+     * Explicit slug override. Use this to capture hierarchical entries
+     * (e.g. "the-outbound/characters/strivers") whose slug shouldn't be
+     * derived from the title. When omitted, the slug is `slugify(title)`.
+     */
+    slug?: string;
+}): CalendarEntry;
+/**
+ * Find a calendar entry by its stable UUID. Prefer this over `findEntry`
+ * (slug lookup) anywhere the caller has an entry already and wants the
+ * join to survive a future slug rename.
+ */
+export declare function findEntryById(calendar: EditorialCalendar, id: string): CalendarEntry | undefined;
+/** Move an entry to Planned and set target keywords (and optionally topics). */
+export declare function planEntry(calendar: EditorialCalendar, slug: string, keywords: string[], opts?: {
+    topics?: string[];
+}): CalendarEntry;
+/**
+ * Set or clear an entry's `contentUrl`. Used when late-setting a URL on a
+ * youtube or tool entry before publishing. Pass `undefined` to unset.
+ */
+export declare function setContentUrl(calendar: EditorialCalendar, slug: string, url: string | undefined): CalendarEntry;
+/**
+ * Move an entry to Outlining. Precondition: Planned.
+ *
+ * The outline skill scaffolds the blog file (for blog entries) and
+ * advances the entry to this stage; an outline review can happen
+ * before the entry moves on to Drafting.
+ */
+export declare function outlineEntry(calendar: EditorialCalendar, slug: string): CalendarEntry;
+/**
+ * Move an entry to Drafting. Precondition: Outlining (the approved
+ * outline is the handoff into body-drafting). The issueNumber
+ * argument records a previously-created GitHub issue if the caller
+ * opened one; the helper does not call gh itself.
+ */
+export declare function draftEntry(calendar: EditorialCalendar, slug: string, issueNumber?: number): CalendarEntry;
+/**
+ * Move an entry to `Paused`, recording its prior stage so `unpauseEntry`
+ * can restore it. Refuses to pause an already-Paused entry (would lose
+ * the original `pausedFrom`) and refuses to pause a `Published` entry
+ * (terminal; a shipped post can't be "in progress again"). See #27.
+ */
+export declare function pauseEntry(calendar: EditorialCalendar, slug: string): CalendarEntry;
+/**
+ * Restore a `Paused` entry to its `pausedFrom` stage. Throws if the
+ * entry isn't Paused, or if `pausedFrom` is missing (legacy / corrupt
+ * state — operator must move the entry by hand). See #27.
+ */
+export declare function unpauseEntry(calendar: EditorialCalendar, slug: string): CalendarEntry;
+/** Mark an entry Published with the given date (defaults to today). */
+export declare function publishEntry(calendar: EditorialCalendar, slug: string, datePublished?: string): CalendarEntry;
+/** Find an entry by slug. */
+export declare function findEntry(calendar: EditorialCalendar, slug: string): CalendarEntry | undefined;
+/**
+ * CLI-arg friendly lookup: tries `id` first (stable across slug
+ * renames), falls back to `slug`. Use this anywhere an operator-typed
+ * argument might be either form — e.g. `deskwork doctor --entry <X>`.
+ *
+ * Returns `undefined` when neither match. Empty / whitespace-only
+ * input also returns undefined.
+ */
+export declare function findEntryBySlugOrId(calendar: EditorialCalendar, slugOrId: string): CalendarEntry | undefined;
+/**
+ * Append a distribution record for a published post. The referenced entry
+ * must exist and be in the Published stage — we don't record shares for
+ * posts that haven't shipped yet.
+ *
+ * Resolves by entryId when present (stable) or falls back to slug
+ * (legacy callers). On success, stamps entryId onto the record so
+ * downstream joins use the stable identity even if the slug later
+ * changes.
+ *
+ * Phase 21a: `record.url` may be an empty string at creation time. The
+ * shortform flow `addDistribution`s a placeholder record (URL gets filled
+ * in by `updateDistributionUrl` once the operator has posted to the
+ * platform). The DistributionRecord.url type stays `string` — there is
+ * no runtime non-empty check, so the existing surface is unchanged.
+ */
+export declare function addDistribution(calendar: EditorialCalendar, record: DistributionRecord): DistributionRecord;
+/**
+ * Set / update the URL on a distribution record. Used after the operator
+ * has manually posted a shortform to the platform and obtained the share
+ * URL.
+ *
+ * Match precedence: `entryId` (stable) → `(slug, platform, channel?)`
+ * (legacy fallback). When no record exists yet the helper creates one via
+ * `addDistribution` so the URL becomes the first thing recorded for that
+ * distribution.
+ *
+ * Channel comparison is case-insensitive (matches the existing approve
+ * helper's behavior). Pass `channel: undefined` to match a record that
+ * has no channel set.
+ *
+ * Only fields explicitly supplied are written — leaving `notes`
+ * undefined preserves any existing note. `dateShared` defaults to today
+ * (UTC) when omitted, both for new records and as the explicit set when
+ * updating an existing one.
+ *
+ * @returns the updated DistributionRecord (always present after this call).
+ */
+export declare function updateDistributionUrl(calendar: EditorialCalendar, match: {
+    entryId?: string;
+    slug?: string;
+    platform: Platform;
+    channel?: string;
+}, url: string, dateShared?: string, notes?: string): DistributionRecord;
+//# sourceMappingURL=calendar-mutations.d.ts.map

package/dist/calendar-mutations.d.ts.map

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

package/dist/calendar-mutations.js

@@ -0,0 +1,305 @@
+/**
+ * Pure mutations on an in-memory EditorialCalendar.
+ *
+ * None of these touch disk — callers parse the calendar, mutate, then write
+ * it back. Each mutation validates stage invariants (an entry must be in
+ * Planned to be drafted, etc.) and throws a descriptive Error if violated.
+ */
+import { randomUUID } from 'node:crypto';
+import { isPausable, } from "./types.js";
+/** Convert a title to a URL-safe slug. */
+export function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/** Add a new entry to the Ideas stage. */
+export function addEntry(calendar, title, opts) {
+    const slug = opts?.slug ?? slugify(title);
+    const existing = calendar.entries.find((e) => e.slug === slug);
+    if (existing) {
+        throw new Error(`Entry with slug "${slug}" already exists in stage "${existing.stage}"`);
+    }
+    const entry = {
+        id: randomUUID(),
+        slug,
+        title,
+        description: opts?.description ?? '',
+        stage: 'Ideas',
+        targetKeywords: [],
+        source: opts?.source ?? 'manual',
+    };
+    if (opts?.contentType !== undefined)
+        entry.contentType = opts.contentType;
+    if (opts?.contentUrl !== undefined && opts.contentUrl.length > 0) {
+        entry.contentUrl = opts.contentUrl;
+    }
+    calendar.entries.push(entry);
+    return entry;
+}
+/**
+ * Find a calendar entry by its stable UUID. Prefer this over `findEntry`
+ * (slug lookup) anywhere the caller has an entry already and wants the
+ * join to survive a future slug rename.
+ */
+export function findEntryById(calendar, id) {
+    if (!id)
+        return undefined;
+    return calendar.entries.find((e) => e.id === id);
+}
+/** Move an entry to Planned and set target keywords (and optionally topics). */
+export function planEntry(calendar, slug, keywords, opts) {
+    const entry = calendar.entries.find((e) => e.slug === slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with slug: ${slug}`);
+    }
+    if (entry.stage !== 'Ideas') {
+        throw new Error(`Entry "${slug}" is in stage "${entry.stage}" — must be in Ideas to plan`);
+    }
+    entry.stage = 'Planned';
+    entry.targetKeywords = keywords;
+    if (opts?.topics !== undefined && opts.topics.length > 0) {
+        entry.topics = opts.topics;
+    }
+    return entry;
+}
+/**
+ * Set or clear an entry's `contentUrl`. Used when late-setting a URL on a
+ * youtube or tool entry before publishing. Pass `undefined` to unset.
+ */
+export function setContentUrl(calendar, slug, url) {
+    const entry = calendar.entries.find((e) => e.slug === slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with slug: ${slug}`);
+    }
+    if (url === undefined || url.length === 0) {
+        delete entry.contentUrl;
+    }
+    else {
+        entry.contentUrl = url;
+    }
+    return entry;
+}
+/**
+ * Move an entry to Outlining. Precondition: Planned.
+ *
+ * The outline skill scaffolds the blog file (for blog entries) and
+ * advances the entry to this stage; an outline review can happen
+ * before the entry moves on to Drafting.
+ */
+export function outlineEntry(calendar, slug) {
+    const entry = calendar.entries.find((e) => e.slug === slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with slug: ${slug}`);
+    }
+    if (entry.stage !== 'Planned') {
+        throw new Error(`Entry "${slug}" is in stage "${entry.stage}" — must be in Planned to outline`);
+    }
+    entry.stage = 'Outlining';
+    return entry;
+}
+/**
+ * Move an entry to Drafting. Precondition: Outlining (the approved
+ * outline is the handoff into body-drafting). The issueNumber
+ * argument records a previously-created GitHub issue if the caller
+ * opened one; the helper does not call gh itself.
+ */
+export function draftEntry(calendar, slug, issueNumber) {
+    const entry = calendar.entries.find((e) => e.slug === slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with slug: ${slug}`);
+    }
+    if (entry.stage !== 'Outlining') {
+        throw new Error(`Entry "${slug}" is in stage "${entry.stage}" — must be in Outlining to draft`);
+    }
+    entry.stage = 'Drafting';
+    if (issueNumber !== undefined) {
+        entry.issueNumber = issueNumber;
+    }
+    return entry;
+}
+/**
+ * Move an entry to `Paused`, recording its prior stage so `unpauseEntry`
+ * can restore it. Refuses to pause an already-Paused entry (would lose
+ * the original `pausedFrom`) and refuses to pause a `Published` entry
+ * (terminal; a shipped post can't be "in progress again"). See #27.
+ */
+export function pauseEntry(calendar, slug) {
+    const entry = calendar.entries.find((e) => e.slug === slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with slug: ${slug}`);
+    }
+    if (entry.stage === 'Paused') {
+        throw new Error(`Entry "${slug}" is already Paused.`);
+    }
+    if (!isPausable(entry.stage)) {
+        throw new Error(`Entry "${slug}" is in stage "${entry.stage}" — only non-terminal stages (Ideas / Planned / Outlining / Drafting / Review) can be paused.`);
+    }
+    entry.pausedFrom = entry.stage;
+    entry.stage = 'Paused';
+    return entry;
+}
+/**
+ * Restore a `Paused` entry to its `pausedFrom` stage. Throws if the
+ * entry isn't Paused, or if `pausedFrom` is missing (legacy / corrupt
+ * state — operator must move the entry by hand). See #27.
+ */
+export function unpauseEntry(calendar, slug) {
+    const entry = calendar.entries.find((e) => e.slug === slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with slug: ${slug}`);
+    }
+    if (entry.stage !== 'Paused') {
+        throw new Error(`Entry "${slug}" is in stage "${entry.stage}" — only Paused entries can be resumed.`);
+    }
+    if (entry.pausedFrom === undefined) {
+        throw new Error(`Entry "${slug}" is Paused but has no pausedFrom — cannot resume automatically. Edit the calendar by hand to move it back to the right stage.`);
+    }
+    entry.stage = entry.pausedFrom;
+    delete entry.pausedFrom;
+    return entry;
+}
+/** Mark an entry Published with the given date (defaults to today). */
+export function publishEntry(calendar, slug, datePublished) {
+    const entry = calendar.entries.find((e) => e.slug === slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with slug: ${slug}`);
+    }
+    entry.stage = 'Published';
+    entry.datePublished =
+        datePublished ?? new Date().toISOString().slice(0, 10);
+    return entry;
+}
+/** Find an entry by slug. */
+export function findEntry(calendar, slug) {
+    return calendar.entries.find((e) => e.slug === slug);
+}
+/**
+ * CLI-arg friendly lookup: tries `id` first (stable across slug
+ * renames), falls back to `slug`. Use this anywhere an operator-typed
+ * argument might be either form — e.g. `deskwork doctor --entry <X>`.
+ *
+ * Returns `undefined` when neither match. Empty / whitespace-only
+ * input also returns undefined.
+ */
+export function findEntryBySlugOrId(calendar, slugOrId) {
+    if (slugOrId === undefined || slugOrId === null)
+        return undefined;
+    const trimmed = slugOrId.trim();
+    if (trimmed === '')
+        return undefined;
+    return findEntryById(calendar, trimmed) ?? findEntry(calendar, trimmed);
+}
+/**
+ * Append a distribution record for a published post. The referenced entry
+ * must exist and be in the Published stage — we don't record shares for
+ * posts that haven't shipped yet.
+ *
+ * Resolves by entryId when present (stable) or falls back to slug
+ * (legacy callers). On success, stamps entryId onto the record so
+ * downstream joins use the stable identity even if the slug later
+ * changes.
+ *
+ * Phase 21a: `record.url` may be an empty string at creation time. The
+ * shortform flow `addDistribution`s a placeholder record (URL gets filled
+ * in by `updateDistributionUrl` once the operator has posted to the
+ * platform). The DistributionRecord.url type stays `string` — there is
+ * no runtime non-empty check, so the existing surface is unchanged.
+ */
+export function addDistribution(calendar, record) {
+    const entry = (record.entryId && calendar.entries.find((e) => e.id === record.entryId)) ||
+        calendar.entries.find((e) => e.slug === record.slug);
+    if (!entry) {
+        throw new Error(`No calendar entry found with entryId "${record.entryId ?? ''}" or slug "${record.slug}"`);
+    }
+    if (entry.stage !== 'Published') {
+        throw new Error(`Entry "${entry.slug}" is in stage "${entry.stage}" — must be Published to record a distribution`);
+    }
+    if (entry.id !== undefined)
+        record.entryId = entry.id;
+    record.slug = entry.slug;
+    calendar.distributions.push(record);
+    return record;
+}
+/**
+ * Set / update the URL on a distribution record. Used after the operator
+ * has manually posted a shortform to the platform and obtained the share
+ * URL.
+ *
+ * Match precedence: `entryId` (stable) → `(slug, platform, channel?)`
+ * (legacy fallback). When no record exists yet the helper creates one via
+ * `addDistribution` so the URL becomes the first thing recorded for that
+ * distribution.
+ *
+ * Channel comparison is case-insensitive (matches the existing approve
+ * helper's behavior). Pass `channel: undefined` to match a record that
+ * has no channel set.
+ *
+ * Only fields explicitly supplied are written — leaving `notes`
+ * undefined preserves any existing note. `dateShared` defaults to today
+ * (UTC) when omitted, both for new records and as the explicit set when
+ * updating an existing one.
+ *
+ * @returns the updated DistributionRecord (always present after this call).
+ */
+export function updateDistributionUrl(calendar, match, url, dateShared, notes) {
+    if (!match.platform) {
+        throw new Error('updateDistributionUrl: platform is required');
+    }
+    if ((match.entryId === undefined || match.entryId === '') &&
+        (match.slug === undefined || match.slug === '')) {
+        throw new Error('updateDistributionUrl: entryId or slug is required');
+    }
+    const channelKey = match.channel?.toLowerCase();
+    const channelMatches = (recChannel) => {
+        if (channelKey === undefined)
+            return !recChannel;
+        return (recChannel?.toLowerCase() ?? '') === channelKey;
+    };
+    // Match by entryId first (stable across slug renames) then by
+    // (slug, platform, channel?) as the legacy fallback.
+    const existing = calendar.distributions.find((d) => {
+        if (d.platform !== match.platform)
+            return false;
+        if (!channelMatches(d.channel))
+            return false;
+        if (match.entryId !== undefined && match.entryId !== '' && d.entryId === match.entryId) {
+            return true;
+        }
+        if (match.slug !== undefined && match.slug !== '' && d.slug === match.slug) {
+            return true;
+        }
+        return false;
+    });
+    const today = new Date().toISOString().slice(0, 10);
+    if (existing) {
+        existing.url = url;
+        existing.dateShared = dateShared ?? existing.dateShared ?? today;
+        if (notes !== undefined) {
+            existing.notes = notes;
+        }
+        return existing;
+    }
+    // No record yet — fall through to addDistribution so the entry's
+    // Published-stage invariant is enforced and entryId/slug get stamped
+    // from the calendar entry.
+    const slug = match.slug ?? '';
+    const record = {
+        slug,
+        platform: match.platform,
+        url,
+        dateShared: dateShared ?? today,
+    };
+    if (match.entryId !== undefined && match.entryId !== '') {
+        record.entryId = match.entryId;
+    }
+    if (match.channel !== undefined && match.channel !== '') {
+        record.channel = match.channel;
+    }
+    if (notes !== undefined) {
+        record.notes = notes;
+    }
+    return addDistribution(calendar, record);
+}
+//# sourceMappingURL=calendar-mutations.js.map

package/dist/calendar-mutations.js.map

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

package/dist/calendar.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Markdown editorial calendar parser and writer.
+ *
+ * Each site's calendar is a human-readable markdown file with one table per
+ * stage. This module round-trips between that format and the in-memory
+ * EditorialCalendar type.
+ *
+ * ## Markdown format
+ *
+ * ```markdown
+ * # Editorial Calendar
+ *
+ * ## Ideas
+ *
+ * | UUID | Slug | Title | Description | Keywords | Source |
+ * |------|------|-------|-------------|----------|--------|
+ * | abc-123 | my-post | My Post | A post about things | kw1, kw2 | manual |
+ *
+ * ## Planned
+ * ...
+ *
+ * ## Published
+ *
+ * | UUID | Slug | Title | Description | Keywords | Source | Published | Issue |
+ * |------|------|-------|-------------|----------|--------|-----------|-------|
+ * ```
+ *
+ * Optional columns (Topics, Type, URL) are emitted only when any entry uses
+ * them, so a calendar with no cross-posting stays visually simple. Published
+ * entries always include Published and Issue columns. The UUID column is
+ * always emitted at render time — pre-UUID calendars get backfilled lazily
+ * (parser assigns missing UUIDs in-memory; the next write persists them).
+ */
+import { PLATFORMS, STAGES, type EditorialCalendar } from './types.ts';
+/** Parse the editorial calendar markdown file into an EditorialCalendar. */
+export declare function parseCalendar(markdown: string): EditorialCalendar;
+/**
+ * Read and parse the editorial calendar from an absolute path.
+ *
+ * A non-existent file is treated as a logically empty calendar — the user
+ * hasn't written anything yet. Any other error (e.g. unreadable, malformed)
+ * propagates so the operator sees the problem instead of a silently-empty
+ * dashboard.
+ */
+export declare function readCalendar(calendarPath: string): EditorialCalendar;
+/** Render the full editorial calendar as markdown. */
+export declare function renderCalendar(calendar: EditorialCalendar): string;
+/** Write the editorial calendar to an absolute path. */
+export declare function writeCalendar(calendarPath: string, calendar: EditorialCalendar): void;
+/** Render an empty calendar — used by the install skill to seed a new file. */
+export declare function renderEmptyCalendar(): string;
+/** Suppress unused-import warnings for re-exported constants available to callers. */
+export { PLATFORMS, STAGES };
+//# sourceMappingURL=calendar.d.ts.map

package/dist/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,EACL,SAAS,EACT,MAAM,EAQN,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AAsMpB,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAoEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,CAWpE;AAyFD,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAqClE;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,iBAAiB,GAC1B,IAAI,CAEN;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,sFAAsF;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC"}