@deskwork/cli 0.9.5

package/dist/commands/ingest.js

@@ -0,0 +1,321 @@
+/**
+ * deskwork ingest — backfill existing markdown content into the editorial
+ * calendar.
+ *
+ * Discovery is the heavy lifting; this module is the CLI surface around
+ * `discoverIngestCandidates` from @deskwork/core/ingest.
+ *
+ * Argv shape (after the dispatcher injects projectRoot when needed):
+ *
+ *   <project-root> [flags] <path>...
+ *
+ * Flags:
+ *   --site <slug>             Target site (defaults to config.defaultSite)
+ *   --apply                   Commit the plan; default is dry-run
+ *   --json                    Machine-readable plan output
+ *   --force                   Bypass duplicate-slug skip
+ *   --slug-from <where>       'frontmatter' or 'path' (default 'path')
+ *   --state-from <where>      'frontmatter' (default) or 'datePublished'
+ *   --slug <value>            Explicit slug (only with single-file ingest)
+ *   --state <stage>           Explicit stage; wins over derivation
+ *   --date <YYYY-MM-DD>       Explicit ISO date; wins over derivation
+ *   --title-field <name>      Frontmatter field for title (default: title)
+ *   --description-field <n>   Frontmatter field for description
+ *                             (default: description)
+ *   --slug-field <name>       Frontmatter field for slug (default: slug)
+ *   --state-field <name>      Frontmatter field for state (default: state)
+ *   --date-field <name>       Frontmatter field for date (default:
+ *                             datePublished)
+ *
+ * Dry-run output (text mode):
+ *
+ *   Plan: 3 add, 1 skip
+ *
+ *   add  whats-in-a-name             Published  2020-10-01    state:fm date:fm slug:path
+ *   add  the-deskwork-experiment     Published  2026-04-20    state:fm date:fm slug:path
+ *   skip on-revising-in-the-open                              already in calendar
+ *
+ * `--apply` writes calendar rows for non-skipped candidates and appends
+ * a journal entry per ingested file (`event: 'ingest'`) so a future
+ * review-start has provenance to anchor against.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { readConfig } from '@deskwork/core/config';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { resolveSite, resolveCalendarPath, resolveContentDir } from '@deskwork/core/paths';
+import { isStage } from '@deskwork/core/types';
+import { absolutize, fail, parseArgs } from '@deskwork/core/cli-args';
+import { appendJournal } from '@deskwork/core/journal';
+import { updateFrontmatter } from '@deskwork/core/frontmatter';
+import { candidateToEntry, discoverIngestCandidates, } from '@deskwork/core/ingest';
+const KNOWN_FLAGS = [
+    'site',
+    'slug-from',
+    'state-from',
+    'slug',
+    'state',
+    'date',
+    'title-field',
+    'description-field',
+    'slug-field',
+    'state-field',
+    'date-field',
+];
+const BOOLEAN_FLAGS = ['apply', 'json', 'force', 'no-write-frontmatter'];
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+export async function run(argv) {
+    const { positional, flags, booleans } = parseInput(argv);
+    if (positional.length < 2) {
+        fail('Usage: deskwork ingest <project-root> [--site <slug>] [--apply] [--json] ' +
+            '[--force] [--no-write-frontmatter] ' +
+            '[--slug-from frontmatter|path] [--state-from frontmatter|datePublished] ' +
+            '[--slug <s>] [--state <stage>] [--date YYYY-MM-DD] [--title-field <n>] ' +
+            '[--description-field <n>] [--slug-field <n>] [--state-field <n>] ' +
+            '[--date-field <n>] <path>...', 2);
+    }
+    const [rootArg, ...paths] = positional;
+    const projectRoot = absolutize(rootArg);
+    const slugFrom = parseSlugFrom(flags['slug-from']);
+    const stateFrom = parseStateFrom(flags['state-from']);
+    const explicitState = parseExplicitState(flags.state);
+    const explicitDate = parseExplicitDate(flags.date);
+    let config;
+    try {
+        config = readConfig(projectRoot);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    const site = resolveSite(config, flags.site);
+    const calendarPath = resolveCalendarPath(projectRoot, config, site);
+    const calendar = readCalendar(calendarPath);
+    // Build absolute path arguments. Relative paths resolve against
+    // the project root (not cwd) — the operator's mental model is
+    // "paths inside this project", and the dispatcher's cwd may differ
+    // from the project root in tests / scripted invocations.
+    const absolutePaths = paths.map((p) => isAbsolute(p) ? p : resolve(projectRoot, p));
+    // Compute scrapbook root for the resolved site so files under it
+    // are skipped by default (operators have to explicitly opt in to
+    // ingest a sketchpad — `deskwork ingest content/scrapbook/` works
+    // because absolutePaths goes through the scrapbook check on a
+    // file-by-file basis, not on the discovery root).
+    const contentDir = resolveContentDir(projectRoot, config, site);
+    const scrapbookRoots = [join(contentDir, 'scrapbook')];
+    let discovery;
+    try {
+        discovery = discoverIngestCandidates(absolutePaths, {
+            projectRoot,
+            ...(slugFrom !== undefined ? { slugFrom } : {}),
+            ...(stateFrom !== undefined ? { stateFrom } : {}),
+            ...(flags.slug !== undefined ? { explicitSlug: flags.slug } : {}),
+            ...(explicitState !== undefined ? { explicitState } : {}),
+            ...(explicitDate !== undefined ? { explicitDate } : {}),
+            fieldNames: buildFieldNames(flags),
+            calendar,
+            ...(booleans.has('force') ? { force: true } : {}),
+            scrapbookRoots,
+        });
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err), 2);
+    }
+    // Split candidates into actionable vs. ambiguous-state. Ambiguous
+    // ones don't get applied without an explicit --state — emit them
+    // as skips with an actionable reason.
+    const ambiguous = [];
+    const actionable = [];
+    for (const c of discovery.candidates) {
+        if (c.derivedState === null) {
+            ambiguous.push({
+                filePath: c.filePath,
+                relativePath: c.relativePath,
+                slug: c.derivedSlug,
+                reason: `state ambiguous (raw frontmatter value: "${c.rawState ?? ''}"); pass --state <stage> to commit`,
+            });
+            continue;
+        }
+        actionable.push({ candidate: c, stage: c.derivedState });
+    }
+    const allSkips = [...discovery.skips, ...ambiguous];
+    if (booleans.has('json')) {
+        emitJsonPlan({
+            apply: booleans.has('apply'),
+            site,
+            calendarPath,
+            add: actionable.map((a) => candidatePlanRecord(a.candidate, a.stage)),
+            skip: allSkips,
+        });
+    }
+    else {
+        emitTextPlan({
+            apply: booleans.has('apply'),
+            add: actionable,
+            skip: allSkips,
+        });
+    }
+    if (!booleans.has('apply'))
+        return;
+    const writeFrontmatterBinding = !booleans.has('no-write-frontmatter');
+    // Apply path: append entries and write journal records. The
+    // calendar is written once at the end so a partial run does not
+    // leave a torn calendar file. Issue #63: also persist the freshly-
+    // minted UUID into the source file's frontmatter under `deskwork.id`
+    // so the calendar entry isn't orphaned at creation (doctor was
+    // immediately flagging `missing-frontmatter-id` against every ingest).
+    for (const { candidate, stage } of actionable) {
+        const id = randomUUID();
+        const entry = { id, ...candidateToEntry(candidate, stage) };
+        calendar.entries.push(entry);
+        writeIngestJournalEntry(projectRoot, config, site, candidate, entry);
+        if (writeFrontmatterBinding) {
+            writeDeskworkIdToFile(candidate.filePath, id);
+        }
+    }
+    writeCalendar(calendarPath, calendar);
+}
+/**
+ * Patch the markdown file at `filePath` so its frontmatter includes
+ * `deskwork.id: <id>`. Round-trip-preserving (Issue #37): only the
+ * `deskwork:` namespace is touched; existing frontmatter fields keep
+ * their byte-for-byte formatting (quoting, comments, key order). When
+ * the file has no existing frontmatter, a fresh `---` block is
+ * prepended.
+ */
+function writeDeskworkIdToFile(filePath, id) {
+    const original = readFileSync(filePath, 'utf-8');
+    const updated = updateFrontmatter(original, { deskwork: { id } });
+    if (updated !== original) {
+        writeFileSync(filePath, updated, 'utf-8');
+    }
+}
+// ---------------------------------------------------------------------------
+// Argv parsing
+// ---------------------------------------------------------------------------
+function parseInput(argv) {
+    try {
+        return parseArgs(argv, KNOWN_FLAGS, BOOLEAN_FLAGS);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err), 2);
+    }
+}
+function parseSlugFrom(value) {
+    if (value === undefined)
+        return undefined;
+    if (value !== 'frontmatter' && value !== 'path') {
+        fail(`--slug-from must be 'frontmatter' or 'path' (got "${value}")`, 2);
+    }
+    return value;
+}
+function parseStateFrom(value) {
+    if (value === undefined)
+        return undefined;
+    if (value !== 'frontmatter' && value !== 'datePublished') {
+        fail(`--state-from must be 'frontmatter' or 'datePublished' (got "${value}")`, 2);
+    }
+    return value;
+}
+function parseExplicitState(value) {
+    if (value === undefined)
+        return undefined;
+    // Accept the case-insensitive lane name as the operator types it.
+    const normalized = value.charAt(0).toUpperCase() + value.slice(1).toLowerCase();
+    if (!isStage(normalized)) {
+        fail(`--state must be one of Ideas, Planned, Outlining, Drafting, Review, Published ` +
+            `(got "${value}")`, 2);
+    }
+    return normalized;
+}
+function parseExplicitDate(value) {
+    if (value === undefined)
+        return undefined;
+    if (!DATE_RE.test(value)) {
+        fail(`--date must match YYYY-MM-DD (got "${value}")`, 2);
+    }
+    return value;
+}
+function buildFieldNames(flags) {
+    const out = {};
+    if (flags['title-field'] !== undefined)
+        out.title = flags['title-field'];
+    if (flags['description-field'] !== undefined)
+        out.description = flags['description-field'];
+    if (flags['slug-field'] !== undefined)
+        out.slug = flags['slug-field'];
+    if (flags['state-field'] !== undefined)
+        out.state = flags['state-field'];
+    if (flags['date-field'] !== undefined)
+        out.date = flags['date-field'];
+    return out;
+}
+function candidatePlanRecord(c, stage) {
+    return {
+        action: 'add',
+        slug: c.derivedSlug,
+        title: c.title,
+        stage,
+        date: c.derivedDate,
+        filePath: c.filePath,
+        relativePath: c.relativePath,
+        sources: {
+            slug: c.slugSource,
+            state: c.stateSource,
+            date: c.dateSource,
+        },
+    };
+}
+function emitJsonPlan(plan) {
+    process.stdout.write(`${JSON.stringify(plan, null, 2)}\n`);
+}
+function emitTextPlan(plan) {
+    const heading = plan.apply
+        ? `Applying: ${plan.add.length} add, ${plan.skip.length} skip`
+        : `Plan: ${plan.add.length} add, ${plan.skip.length} skip (dry-run; pass --apply to commit)`;
+    process.stdout.write(`${heading}\n\n`);
+    for (const { candidate, stage } of plan.add) {
+        const sources = `slug:${candidate.slugSource} state:${candidate.stateSource} date:${candidate.dateSource}`;
+        process.stdout.write(`add  ${pad(candidate.derivedSlug, 36)}  ${pad(stage, 10)}  ${pad(candidate.derivedDate, 12)}  ${sources}\n`);
+    }
+    for (const skip of plan.skip) {
+        const slug = skip.slug ?? '(no slug)';
+        process.stdout.write(`skip ${pad(slug, 36)}  ${skip.reason}\n`);
+    }
+}
+function pad(s, n) {
+    if (s.length >= n)
+        return s;
+    return s + ' '.repeat(n - s.length);
+}
+/**
+ * Append a journal record under `<reviewJournalDir>/ingest/` so a
+ * later review-start (or audit) can find provenance for the ingested
+ * row. We reuse the existing journal infrastructure rather than
+ * inventing a new dir — review-journal already uses one-file-per-event
+ * shape that a tight-fit for ingest events.
+ */
+function writeIngestJournalEntry(projectRoot, config, site, candidate, entry) {
+    const journalRoot = join(projectRoot, config.reviewJournalDir ?? '.deskwork/review-journal', 'ingest');
+    if (!existsSync(journalRoot)) {
+        mkdirSync(journalRoot, { recursive: true });
+    }
+    const record = {
+        id: entry.id ?? randomUUID(),
+        timestamp: new Date().toISOString(),
+        event: 'ingest',
+        slug: entry.slug,
+        entryId: entry.id ?? '',
+        site,
+        stage: entry.stage,
+        sourceFile: candidate.relativePath,
+        frontmatterSnapshot: candidate.frontmatter,
+        derivation: {
+            slug: candidate.slugSource,
+            state: candidate.stateSource,
+            date: candidate.dateSource,
+        },
+    };
+    appendJournal(journalRoot, record);
+}
+//# sourceMappingURL=ingest.js.map

package/dist/commands/ingest.js.map

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

package/dist/commands/install-preflight.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Install pre-flight checks (Issue #42 + #45, Phase 22).
+ *
+ * Two non-blocking probes that run after `.deskwork/config.json` is
+ * written, before the install command exits successfully:
+ *
+ * 1. detectExistingPipeline — heuristic walk for signals of a competing
+ *    in-house editorial implementation (e.g. the audiocontrol journal
+ *    layout deskwork was extracted from). When detected, the operator
+ *    is warned that deskwork installs ALONGSIDE the existing pipeline
+ *    rather than replacing it.
+ *
+ * 2. preflightSchema — for Astro sites only, statically inspect the
+ *    host's content schema source for either a `deskwork` field
+ *    declaration or a top-level `.passthrough()`. If neither matches
+ *    (or the schema file is missing / ambiguous), the schema-patch
+ *    instructions are printed inline at install time so the operator
+ *    sees the requirement BEFORE the first deskwork write.
+ *
+ * Both probes are loud but non-blocking — they print to stdout and
+ * return without throwing. Install still completes successfully.
+ *
+ * Sibling-relative imports per the project convention.
+ */
+import type { DeskworkConfig } from '@deskwork/core/config';
+/**
+ * Result of the schema preflight check for one site. The probe is
+ * intentionally coarse — it asks "could this schema accept the
+ * `deskwork:` namespace?" rather than parsing TypeScript.
+ */
+export type SchemaProbeOutcome = {
+    kind: 'compatible';
+    schemaPath: string;
+    reason: string;
+} | {
+    kind: 'uncertain';
+    schemaPath: string | null;
+    reason: string;
+} | {
+    kind: 'skipped';
+    reason: string;
+};
+/**
+ * Probe the content-schema file for compatibility with deskwork's
+ * `deskwork:` namespace binding. Static text inspection — does NOT
+ * evaluate the TypeScript.
+ *
+ * Returns `compatible` when either a `deskwork`-named schema field
+ * declaration OR a top-level `.passthrough()` is detected. Anything
+ * else (file missing, no signal found) is `uncertain` — the caller
+ * surfaces patch instructions to the operator.
+ */
+export declare function preflightSchemaForProject(projectRoot: string): SchemaProbeOutcome;
+/**
+ * Print the schema preflight result to stdout. Non-blocking — install
+ * continues regardless of outcome.
+ *
+ * The function is responsible for the entire textual surface of the
+ * check so the install command stays focused on its own concerns.
+ */
+export declare function printSchemaPreflight(projectRoot: string, config: DeskworkConfig): void;
+/**
+ * One signal found by `detectExistingPipeline`. The `kind` discriminator
+ * lets the formatter group findings logically when multiple matches
+ * land in the same category.
+ */
+export interface PipelineSignal {
+    kind: 'journal-tree' | 'editorial-skill' | 'editorial-astro-page' | 'editorial-script-module';
+    /** Path relative to the project root, for display. */
+    relativePath: string;
+}
+/**
+ * Walk the project for signals of a competing in-house editorial
+ * implementation. Each branch is independent — any one signal is mild,
+ * the combination is loud.
+ */
+export declare function detectExistingPipeline(projectRoot: string): PipelineSignal[];
+/**
+ * Print the existing-pipeline warning to stdout when signals were
+ * detected. No-op when nothing was found.
+ */
+export declare function printExistingPipelineWarning(signals: ReadonlyArray<PipelineSignal>): void;
+//# sourceMappingURL=install-preflight.d.ts.map

package/dist/commands/install-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-preflight.d.ts","sourceRoot":"","sources":["../../src/commands/install-preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA2C5D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAqDpB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,GACrB,IAAI,CAuCN;AAMD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,cAAc,GACd,iBAAiB,GACjB,sBAAsB,GACtB,yBAAyB,CAAC;IAC9B,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AA0BD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,GAClB,cAAc,EAAE,CAuFlB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,GACrC,IAAI,CAiBN"}