@deskwork/cli 0.9.5

package/dist/commands/install-preflight.js

@@ -0,0 +1,300 @@
+/**
+ * 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 { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { printSchemaPatchInstructions } from '@deskwork/core/doctor';
+const ASTRO_CONFIG_NAMES = [
+    'astro.config.mjs',
+    'astro.config.ts',
+    'astro.config.js',
+    'astro.config.cjs',
+];
+const CONTENT_SCHEMA_NAMES = [
+    // Newer Astro convention.
+    'src/content.config.ts',
+    'src/content.config.js',
+    'src/content.config.mjs',
+    // Older Astro convention (used by the original audiocontrol tree).
+    'src/content/config.ts',
+    'src/content/config.js',
+    'src/content/config.mjs',
+];
+/**
+ * True when the project has any Astro config file at the root. Used to
+ * gate the schema preflight — non-Astro projects (Hugo / Jekyll / etc)
+ * don't need the patch.
+ */
+function isAstroProject(projectRoot) {
+    return ASTRO_CONFIG_NAMES.some((name) => existsSync(join(projectRoot, name)));
+}
+/**
+ * Locate the host's content-schema source file. Returns the absolute
+ * path to the first matching candidate, or null when none exist.
+ */
+function findContentSchemaFile(projectRoot) {
+    for (const rel of CONTENT_SCHEMA_NAMES) {
+        const abs = join(projectRoot, rel);
+        if (existsSync(abs))
+            return abs;
+    }
+    return null;
+}
+/**
+ * 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 function preflightSchemaForProject(projectRoot) {
+    if (!isAstroProject(projectRoot)) {
+        return {
+            kind: 'skipped',
+            reason: 'no Astro config detected at project root; non-Astro engines (Hugo / Jekyll / Eleventy / plain markdown) do not validate frontmatter',
+        };
+    }
+    const schemaPath = findContentSchemaFile(projectRoot);
+    if (schemaPath === null) {
+        return {
+            kind: 'uncertain',
+            schemaPath: null,
+            reason: 'no src/content/config.* or src/content.config.* file found',
+        };
+    }
+    let raw;
+    try {
+        raw = readFileSync(schemaPath, 'utf-8');
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return {
+            kind: 'uncertain',
+            schemaPath,
+            reason: `could not read schema file: ${reason}`,
+        };
+    }
+    // Heuristic 1: an explicit `deskwork:` field on the schema object.
+    // We accept any of:
+    //   deskwork: z.object(...)
+    //   deskwork: z.unknown()
+    //   deskwork: z.any()
+    const explicitNamespace = /\bdeskwork\s*:\s*z\.[a-zA-Z]/u.test(raw);
+    if (explicitNamespace) {
+        return {
+            kind: 'compatible',
+            schemaPath,
+            reason: 'detected explicit `deskwork:` field in the schema',
+        };
+    }
+    // Heuristic 2: a `.passthrough()` call anywhere — this accepts
+    // unknown keys including the entire `deskwork:` namespace.
+    if (/\.passthrough\s*\(/u.test(raw)) {
+        return {
+            kind: 'compatible',
+            schemaPath,
+            reason: 'detected `.passthrough()` on the schema (accepts unknown keys)',
+        };
+    }
+    return {
+        kind: 'uncertain',
+        schemaPath,
+        reason: 'no `deskwork:` field declaration and no `.passthrough()` found',
+    };
+}
+/**
+ * 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 function printSchemaPreflight(projectRoot, config) {
+    // The check applies project-wide (Astro config is at the root). We
+    // run the probe once and then describe the outcome in terms of the
+    // configured sites for the operator's mental model.
+    const outcome = preflightSchemaForProject(projectRoot);
+    const sites = Object.keys(config.sites);
+    if (outcome.kind === 'skipped') {
+        console.log(`Schema pre-flight: skipped (${outcome.reason}).`);
+        return;
+    }
+    if (outcome.kind === 'compatible') {
+        console.log(`Schema pre-flight: OK (${outcome.reason}).`);
+        console.log(`  schema file: ${outcome.schemaPath}`);
+        if (sites.length > 0) {
+            console.log(`  applies to sites: ${sites.join(', ')}`);
+        }
+        return;
+    }
+    // uncertain — surface the patch instructions inline. This is the
+    // operator-facing reminder so they don't discover the requirement
+    // mid-workflow at the first `/deskwork:outline`.
+    console.log('Schema pre-flight: UNCERTAIN — patch instructions follow.');
+    console.log(`  reason: ${outcome.reason}`);
+    if (outcome.schemaPath !== null) {
+        console.log(`  inspected: ${outcome.schemaPath}`);
+    }
+    if (sites.length > 0) {
+        console.log(`  configured sites: ${sites.join(', ')}`);
+    }
+    console.log('');
+    console.log(printSchemaPatchInstructions());
+}
+/**
+ * The set of editorial-* skill names we consider strong signals when
+ * three or more land. Sourced from the in-house implementation
+ * deskwork was extracted from (audiocontrol). A coincidental single
+ * match (e.g. a project happens to have one `editorial-add` skill)
+ * doesn't trip the heuristic.
+ */
+const EDITORIAL_SKILL_NAMES = new Set([
+    'editorial-add',
+    'editorial-plan',
+    'editorial-outline',
+    'editorial-draft',
+    'editorial-publish',
+    'editorial-iterate',
+    'editorial-approve',
+    'editorial-review-cancel',
+    'editorial-review-help',
+    'editorial-review-report',
+    'editorial-distribute',
+]);
+/** Minimum editorial-* skills present before we treat them as a real pipeline. */
+const EDITORIAL_SKILL_SIGNAL_THRESHOLD = 3;
+/**
+ * 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 function detectExistingPipeline(projectRoot) {
+    const out = [];
+    // Branch 1: audiocontrol-style journal tree.
+    if (existsSync(join(projectRoot, 'journal/editorial'))) {
+        out.push({
+            kind: 'journal-tree',
+            relativePath: 'journal/editorial/',
+        });
+    }
+    // Branch 2: editorial-* skills under .claude/skills/. We require
+    // EDITORIAL_SKILL_SIGNAL_THRESHOLD matches before reporting any of
+    // them — a single coincidental match shouldn't trip the heuristic.
+    const skillsDir = join(projectRoot, '.claude/skills');
+    const skillMatches = [];
+    if (existsSync(skillsDir)) {
+        let entries = [];
+        try {
+            entries = readdirSync(skillsDir);
+        }
+        catch {
+            entries = [];
+        }
+        for (const name of entries) {
+            if (EDITORIAL_SKILL_NAMES.has(name)) {
+                const abs = join(skillsDir, name);
+                try {
+                    if (statSync(abs).isDirectory()) {
+                        skillMatches.push(name);
+                    }
+                }
+                catch {
+                    // ignore stat errors — name was already matched
+                }
+            }
+        }
+    }
+    if (skillMatches.length >= EDITORIAL_SKILL_SIGNAL_THRESHOLD) {
+        for (const name of skillMatches) {
+            out.push({
+                kind: 'editorial-skill',
+                relativePath: `.claude/skills/${name}/`,
+            });
+        }
+    }
+    // Branch 3: src/sites/*/pages/dev/editorial-*.astro — the multi-site
+    // pattern. We don't enumerate every page; one match anywhere is
+    // enough to register the signal.
+    const sitesDir = join(projectRoot, 'src/sites');
+    if (existsSync(sitesDir)) {
+        let siteNames = [];
+        try {
+            siteNames = readdirSync(sitesDir);
+        }
+        catch {
+            siteNames = [];
+        }
+        for (const site of siteNames) {
+            const pagesDir = join(sitesDir, site, 'pages/dev');
+            if (!existsSync(pagesDir))
+                continue;
+            let pageEntries = [];
+            try {
+                pageEntries = readdirSync(pagesDir);
+            }
+            catch {
+                continue;
+            }
+            for (const page of pageEntries) {
+                if (page.startsWith('editorial-') && page.endsWith('.astro')) {
+                    out.push({
+                        kind: 'editorial-astro-page',
+                        relativePath: `src/sites/${site}/pages/dev/${page}`,
+                    });
+                }
+            }
+        }
+    }
+    // Branch 4: scripts/lib/editorial/ or scripts/lib/editorial-review/.
+    for (const candidate of ['scripts/lib/editorial', 'scripts/lib/editorial-review']) {
+        if (existsSync(join(projectRoot, candidate))) {
+            out.push({
+                kind: 'editorial-script-module',
+                relativePath: `${candidate}/`,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Print the existing-pipeline warning to stdout when signals were
+ * detected. No-op when nothing was found.
+ */
+export function printExistingPipelineWarning(signals) {
+    if (signals.length === 0)
+        return;
+    console.log('');
+    console.log('Detected existing editorial-pipeline signals in this project:');
+    for (const s of signals) {
+        console.log(`  - ${s.relativePath}`);
+    }
+    console.log('');
+    console.log('Deskwork will install ALONGSIDE the existing implementation, not replace it.');
+    console.log('Resolve overlap manually before driving both pipelines against the same calendar.');
+    console.log('');
+}
+//# sourceMappingURL=install-preflight.js.map

package/dist/commands/install-preflight.js.map

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

package/dist/commands/install.d.ts

@@ -0,0 +1,27 @@
+/**
+ * deskwork-install — validate a deskwork config, write it to disk, and seed
+ * empty calendar files for every configured site.
+ *
+ * Usage (one-arg, project-root defaults to cwd):
+ *   deskwork install <config-file>
+ *
+ * Usage (two-arg, explicit project-root):
+ *   deskwork install <project-root> <config-file>
+ *
+ * The agent inside Claude Code is already running in the host project's
+ * working directory, so the one-arg form is the natural call. The
+ * explicit two-arg form is preserved for scripted use (CI bootstrapping
+ * a project from outside, etc.).
+ *
+ * The config-file must contain valid JSON matching the DeskworkConfig
+ * schema (see lib/config.ts). On success the script:
+ *   1. Writes the validated config to <project-root>/.deskwork/config.json
+ *   2. Creates an empty calendar file at each site's calendarPath, but
+ *      only when no file is already there
+ *   3. Prints a summary of what was written and what was left untouched
+ *
+ * Exits non-zero with an actionable message on any failure. Idempotent:
+ * re-running with the same config leaves existing calendars alone.
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAYH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgHvD"}

package/dist/commands/install.js

@@ -0,0 +1,132 @@
+/**
+ * deskwork-install — validate a deskwork config, write it to disk, and seed
+ * empty calendar files for every configured site.
+ *
+ * Usage (one-arg, project-root defaults to cwd):
+ *   deskwork install <config-file>
+ *
+ * Usage (two-arg, explicit project-root):
+ *   deskwork install <project-root> <config-file>
+ *
+ * The agent inside Claude Code is already running in the host project's
+ * working directory, so the one-arg form is the natural call. The
+ * explicit two-arg form is preserved for scripted use (CI bootstrapping
+ * a project from outside, etc.).
+ *
+ * The config-file must contain valid JSON matching the DeskworkConfig
+ * schema (see lib/config.ts). On success the script:
+ *   1. Writes the validated config to <project-root>/.deskwork/config.json
+ *   2. Creates an empty calendar file at each site's calendarPath, but
+ *      only when no file is already there
+ *   3. Prints a summary of what was written and what was left untouched
+ *
+ * Exits non-zero with an actionable message on any failure. Idempotent:
+ * re-running with the same config leaves existing calendars alone.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { parseConfig, configPath } from '@deskwork/core/config';
+import { renderEmptyCalendar } from '@deskwork/core/calendar';
+import { detectExistingPipeline, printExistingPipelineWarning, printSchemaPreflight, } from "./install-preflight.js";
+export async function run(argv) {
+    function usage() {
+        console.error('Usage: deskwork install [<project-root>] <config-file>');
+        process.exit(2);
+    }
+    // Two argv shapes possible after the cli dispatcher has run:
+    //   [<config-file>]                    → project-root defaults to cwd
+    //   [<project-root>, <config-file>]    → explicit project-root
+    // The dispatcher's pathLike heuristic injects cwd for non-path-like
+    // first args, so `deskwork install bare.json` arrives here as the
+    // two-arg form `[cwd, bare.json]`. The one-arg form below only fires
+    // when the user passed an absolute or relative path as the single
+    // positional (e.g. `deskwork install /tmp/config.json`).
+    let projectRootArg;
+    let configFileArg;
+    if (argv.length === 1) {
+        projectRootArg = process.cwd();
+        configFileArg = argv[0];
+    }
+    else if (argv.length === 2) {
+        [projectRootArg, configFileArg] = argv;
+    }
+    else {
+        usage();
+    }
+    const projectRoot = isAbsolute(projectRootArg)
+        ? projectRootArg
+        : resolve(process.cwd(), projectRootArg);
+    const configFile = isAbsolute(configFileArg)
+        ? configFileArg
+        : resolve(process.cwd(), configFileArg);
+    // Heads-up so the operator (or the agent reading the output) can
+    // interrupt before any disk writes if the inferred project-root is
+    // wrong. Prints to stdout so it lands above the success summary.
+    console.log(`Installing into: ${projectRoot}`);
+    if (!existsSync(projectRoot)) {
+        console.error(`Project root does not exist: ${projectRoot}`);
+        process.exit(1);
+    }
+    if (!existsSync(configFile)) {
+        console.error(`Config file does not exist: ${configFile}`);
+        process.exit(1);
+    }
+    let rawConfig;
+    try {
+        rawConfig = JSON.parse(readFileSync(configFile, 'utf-8'));
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        console.error(`Config file is not valid JSON: ${reason}`);
+        process.exit(1);
+    }
+    let config;
+    try {
+        config = parseConfig(rawConfig);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        console.error(reason);
+        process.exit(1);
+    }
+    // Issue #45: detect competing in-house editorial pipelines BEFORE
+    // writing the config file. The warning is non-blocking; install
+    // still proceeds. The operator gets an honest accounting of what
+    // they're about to be running alongside.
+    const pipelineSignals = detectExistingPipeline(projectRoot);
+    printExistingPipelineWarning(pipelineSignals);
+    const writtenConfigPath = configPath(projectRoot);
+    mkdirSync(dirname(writtenConfigPath), { recursive: true });
+    writeFileSync(writtenConfigPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    const createdCalendars = [];
+    const preservedCalendars = [];
+    for (const [slug, site] of Object.entries(config.sites)) {
+        const absPath = join(projectRoot, site.calendarPath);
+        if (existsSync(absPath)) {
+            preservedCalendars.push(`${slug}: ${site.calendarPath}`);
+            continue;
+        }
+        mkdirSync(dirname(absPath), { recursive: true });
+        writeFileSync(absPath, renderEmptyCalendar(), 'utf-8');
+        createdCalendars.push(`${slug}: ${site.calendarPath}`);
+    }
+    console.log(`Wrote config: ${writtenConfigPath}`);
+    console.log(`Sites configured: ${Object.keys(config.sites).join(', ')}`);
+    console.log(`Default site: ${config.defaultSite}`);
+    if (createdCalendars.length > 0) {
+        console.log(`Created calendars:`);
+        for (const c of createdCalendars)
+            console.log(`  - ${c}`);
+    }
+    if (preservedCalendars.length > 0) {
+        console.log(`Left existing calendars untouched:`);
+        for (const c of preservedCalendars)
+            console.log(`  - ${c}`);
+    }
+    // Issue #42: schema pre-flight. Loud-but-non-blocking probe for the
+    // host's content-collection schema. Skipped on non-Astro projects.
+    // When uncertain, the helper prints inline patch instructions so
+    // the operator sees the requirement before the first deskwork write.
+    printSchemaPreflight(projectRoot, config);
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACtC,SAAS,KAAK;QACZ,OAAO,CAAC,KAAK,CACX,wDAAwD,CACzD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,6DAA6D;IAC7D,sEAAsE;IACtE,+DAA+D;IAC/D,oEAAoE;IACpE,kEAAkE;IAClE,qEAAqE;IACrE,kEAAkE;IAClE,yDAAyD;IACzD,IAAI,cAAsB,CAAC;IAC3B,IAAI,aAAqB,CAAC;IAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,KAAK,EAAE,CAAC;IACV,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,cAAc,CAAC;QAC5C,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,aAAa,CAAC;QAC1C,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC,CAAC;IAE1C,iEAAiE;IACjE,mEAAmE;IACnE,iEAAiE;IACjE,OAAO,CAAC,GAAG,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,gCAAgC,WAAW,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,SAAkB,CAAC;IACvB,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,kEAAkE;IAClE,gEAAgE;IAChE,iEAAiE;IACjE,yCAAyC;IACzC,MAAM,eAAe,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC5D,4BAA4B,CAAC,eAAe,CAAC,CAAC;IAE9C,MAAM,iBAAiB,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAClD,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,aAAa,CACX,iBAAiB,EACjB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACtC,OAAO,CACR,CAAC;IAEF,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,MAAM,kBAAkB,GAAa,EAAE,CAAC;IAExC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,OAAO,CAAC,CAAC;QACvD,gBAAgB,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,iBAAiB,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,gBAAgB;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAClD,KAAK,MAAM,CAAC,IAAI,kBAAkB;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,oEAAoE;IACpE,mEAAmE;IACnE,iEAAiE;IACjE,qEAAqE;IACrE,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/commands/iterate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * deskwork-iterate — snapshot the agent's revised content file as a new
+ * workflow version and transition back to in-review.
+ *
+ * Call this AFTER the agent has rewritten the markdown on disk based on
+ * operator comments. The helper does the mechanical persist-and-transition
+ * step:
+ *
+ *   1. Read the workflow (must be in state `iterating`).
+ *   2. If disk differs from the workflow's current version, append a
+ *      new version (originatedBy='agent') — this is the SSOT flow:
+ *      disk is canonical, the journal captures snapshots.
+ *   3. Optionally read a dispositions JSON and emit address annotations
+ *      (one per commentId) that the studio sidebar renders as badges.
+ *   4. Transition the workflow back to in-review.
+ *
+ * Phase 21a: `--kind shortform` is accepted alongside longform/outline.
+ * The mutation is kind-agnostic — it reads the workflow's on-disk file
+ * (longform: `<contentDir>/<slug>.md`; shortform:
+ * `<contentDir>/<slug>/scrapbook/shortform/<platform>[-<channel>].md`)
+ * and snapshots its body as the new version.
+ *
+ * Usage:
+ *   deskwork-iterate <project-root> [--site <slug>]
+ *                    [--kind longform|outline|shortform]
+ *                    [--platform <p>] [--channel <c>]
+ *                    [--dispositions <path>] <slug>
+ *
+ * The dispositions file (optional) is a JSON object mapping commentId to
+ * { disposition: 'addressed'|'deferred'|'wontfix', reason?: string }.
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=iterate.d.ts.map

package/dist/commands/iterate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterate.d.ts","sourceRoot":"","sources":["../../src/commands/iterate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAqBH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgOvD"}