@deskwork/cli 0.9.5

package/dist/commands/iterate.js

@@ -0,0 +1,202 @@
+/**
+ * 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 }.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { readConfig } from '@deskwork/core/config';
+import { resolveSite, resolveEntryFilePath, resolveShortformFilePath, } from '@deskwork/core/paths';
+import { appendAnnotation, appendVersion, mintAnnotation, readAnnotations, readVersions, readWorkflows, transitionState, } from '@deskwork/core/review/pipeline';
+import { isPlatform } from '@deskwork/core/types';
+import { absolutize, emit, fail, parseArgs } from '@deskwork/core/cli-args';
+export async function run(argv) {
+    const KNOWN_FLAGS = ['site', 'kind', 'platform', 'channel', 'dispositions'];
+    const DISPOSITIONS = new Set(['addressed', 'deferred', 'wontfix']);
+    const VALID_KINDS = ['longform', 'outline', 'shortform'];
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork-iterate <project-root> [--site <slug>] ' +
+            '[--kind longform|outline|shortform] [--platform <p>] [--channel <c>] ' +
+            '[--dispositions <path>] <slug>', 2);
+    }
+    const [rootArg, slug] = positional;
+    const projectRoot = absolutize(rootArg);
+    if (flags.kind !== undefined &&
+        !VALID_KINDS.includes(flags.kind)) {
+        fail(`Invalid --kind "${flags.kind}". Must be 'longform', 'outline', or 'shortform'.`);
+    }
+    const kind = (() => {
+        if (flags.kind === 'shortform')
+            return 'shortform';
+        if (flags.kind === 'outline')
+            return 'outline';
+        return 'longform';
+    })();
+    if (kind === 'shortform') {
+        if (flags.platform === undefined) {
+            fail('--platform is required when --kind=shortform.');
+        }
+        if (!isPlatform(flags.platform)) {
+            fail(`Invalid --platform "${flags.platform}".`);
+        }
+    }
+    else if (flags.platform !== undefined || flags.channel !== undefined) {
+        fail('--platform / --channel are only valid with --kind=shortform.');
+    }
+    let config;
+    try {
+        config = readConfig(projectRoot);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    const site = resolveSite(config, flags.site);
+    // Find the workflow BEFORE resolving the file path. The workflow
+    // records the stable entry id, which the path resolver uses to
+    // prefer the UUID-bound file over the slug-template (Issue #67).
+    const workflow = readWorkflows(projectRoot, config).find((w) => w.site === site &&
+        w.slug === slug &&
+        w.contentKind === kind &&
+        (kind !== 'shortform' || w.platform === flags.platform) &&
+        (kind !== 'shortform' || (w.channel ?? null) === (flags.channel ?? null)) &&
+        w.state !== 'applied' &&
+        w.state !== 'cancelled');
+    if (!workflow) {
+        fail(`No active ${kind} workflow for ${site}/${slug}. ` +
+            `Run /deskwork:review-start <slug> to enqueue one first.`);
+    }
+    let file;
+    if (kind === 'shortform' && flags.platform !== undefined && isPlatform(flags.platform)) {
+        const channel = flags.channel;
+        const resolved = resolveShortformFilePath(projectRoot, config, site, workflow.entryId !== undefined && workflow.entryId !== ''
+            ? { id: workflow.entryId, slug }
+            : { slug }, flags.platform, channel);
+        if (resolved === undefined) {
+            fail(`Cannot resolve shortform file for site=${site} slug=${slug} platform=${flags.platform}. ` +
+                `Run /deskwork:shortform-start to scaffold it first.`);
+        }
+        file = resolved;
+    }
+    else {
+        file = resolveEntryFilePath(projectRoot, config, site, slug, workflow.entryId);
+    }
+    if (!existsSync(file)) {
+        fail(kind === 'shortform'
+            ? `No shortform file at ${file}. Run /deskwork:shortform-start first.`
+            : `No blog file at ${file}.`);
+    }
+    const diskMarkdown = readFileSync(file, 'utf8');
+    if (workflow.state !== 'iterating') {
+        fail(`Workflow state is '${workflow.state}', not 'iterating'.\n` +
+            `The studio must click 'Request iteration' to move the workflow to ` +
+            `'iterating' before this helper runs.`);
+    }
+    const versions = readVersions(projectRoot, config, workflow.id);
+    const current = versions.find((v) => v.version === workflow.currentVersion);
+    if (current && current.markdown === diskMarkdown) {
+        fail(`File on disk is identical to workflow v${workflow.currentVersion} — no revision to snapshot. ` +
+            `Write the revision to disk first (the agent does this), then re-run.`);
+    }
+    // Load dispositions file, if provided. Validate each entry.
+    let dispositions = null;
+    if (flags.dispositions !== undefined) {
+        const path = absolutize(flags.dispositions);
+        if (!existsSync(path)) {
+            fail(`--dispositions file not found: ${path}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            fail(`--dispositions: invalid JSON at ${path}: ${reason}`);
+        }
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            fail(`--dispositions: expected JSON object at ${path}`);
+        }
+        dispositions = {};
+        for (const [commentId, raw] of Object.entries(parsed)) {
+            if (typeof raw !== 'object' || raw === null) {
+                fail(`--dispositions[${commentId}]: must be an object`);
+            }
+            const d = raw;
+            if (typeof d.disposition !== 'string' || !DISPOSITIONS.has(d.disposition)) {
+                fail(`--dispositions[${commentId}].disposition: must be 'addressed' | 'deferred' | 'wontfix'`);
+            }
+            const entry = { disposition: d.disposition };
+            if (typeof d.reason === 'string' && d.reason.length > 0) {
+                entry.reason = d.reason;
+            }
+            dispositions[commentId] = entry;
+        }
+    }
+    // Append the new version from disk.
+    const newVersion = appendVersion(projectRoot, config, workflow.id, diskMarkdown, 'agent');
+    // Emit per-comment address annotations for the new version.
+    const addressed = [];
+    if (dispositions) {
+        const workflowComments = new Set(readAnnotations(projectRoot, config, workflow.id)
+            .filter((a) => a.type === 'comment')
+            .map((a) => a.id));
+        for (const [commentId, entry] of Object.entries(dispositions)) {
+            if (!workflowComments.has(commentId))
+                continue;
+            const ann = mintAnnotation({
+                type: 'address',
+                workflowId: workflow.id,
+                commentId,
+                version: newVersion.version,
+                disposition: entry.disposition,
+                ...(entry.reason !== undefined ? { reason: entry.reason } : {}),
+            });
+            appendAnnotation(projectRoot, config, ann);
+            addressed.push(commentId);
+        }
+    }
+    // Flip state back to in-review.
+    const updated = transitionState(projectRoot, config, workflow.id, 'in-review');
+    emit({
+        workflowId: workflow.id,
+        site: updated.site,
+        slug: updated.slug,
+        state: updated.state,
+        version: newVersion.version,
+        addressedComments: addressed,
+    });
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=iterate.js.map

package/dist/commands/iterate.js.map

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

package/dist/commands/outline.d.ts

@@ -0,0 +1,19 @@
+/**
+ * deskwork-outline — move a Planned entry to Outlining.
+ *
+ * For blog entries, scaffolds the blog post markdown with frontmatter +
+ * (optionally) a `## Outline` section so the operator can shape the
+ * piece before the agent drafts the body. For youtube/tool entries,
+ * no filesystem artifact is created — the stage flip to Outlining
+ * still happens (the pipeline expects every content type to pass
+ * through Outlining before Drafting).
+ *
+ * Usage:
+ *   deskwork-outline <project-root> [--site <slug>] [--author "Name"] <slug>
+ *
+ * Emits a JSON result:
+ *   { slug, stage, contentType, scaffolded: {filePath, relativePath} | null,
+ *     site, calendarPath }
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=outline.d.ts.map

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

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

package/dist/commands/outline.js

@@ -0,0 +1,102 @@
+/**
+ * deskwork-outline — move a Planned entry to Outlining.
+ *
+ * For blog entries, scaffolds the blog post markdown with frontmatter +
+ * (optionally) a `## Outline` section so the operator can shape the
+ * piece before the agent drafts the body. For youtube/tool entries,
+ * no filesystem artifact is created — the stage flip to Outlining
+ * still happens (the pipeline expects every content type to pass
+ * through Outlining before Drafting).
+ *
+ * Usage:
+ *   deskwork-outline <project-root> [--site <slug>] [--author "Name"] <slug>
+ *
+ * Emits a JSON result:
+ *   { slug, stage, contentType, scaffolded: {filePath, relativePath} | null,
+ *     site, calendarPath }
+ */
+import { readConfig } from '@deskwork/core/config';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { outlineEntry, findEntry } from '@deskwork/core/calendar-mutations';
+import { scaffoldBlogPost, } from '@deskwork/core/scaffold';
+import { effectiveContentType, hasRepoContent, } from '@deskwork/core/types';
+import { resolveSite, resolveCalendarPath } from '@deskwork/core/paths';
+import { absolutize, emit, fail, parseArgs } from '@deskwork/core/cli-args';
+export async function run(argv) {
+    const KNOWN_FLAGS = ['site', 'author', 'layout'];
+    const VALID_LAYOUTS = ['index', 'readme', 'flat'];
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork-outline <project-root> [--site <slug>] [--author "Name"] ' +
+            '[--layout index|readme|flat] <slug>', 2);
+    }
+    if (flags.layout !== undefined &&
+        !VALID_LAYOUTS.includes(flags.layout)) {
+        fail(`--layout must be one of ${VALID_LAYOUTS.join(', ')} (got "${flags.layout}")`, 2);
+    }
+    const layout = flags.layout;
+    const [rootArg, slug] = positional;
+    const projectRoot = absolutize(rootArg);
+    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);
+    // Preflight: find the entry and verify stage before writing anything.
+    const existing = findEntry(calendar, slug);
+    if (!existing) {
+        const planned = calendar.entries
+            .filter((e) => e.stage === 'Planned')
+            .map((e) => e.slug)
+            .join(', ') || '(none)';
+        fail(`No calendar entry found with slug "${slug}". Planned entries: ${planned}`);
+    }
+    if (existing.stage !== 'Planned') {
+        fail(`Entry "${slug}" is in stage "${existing.stage}" — must be in Planned to outline.`);
+    }
+    const contentType = effectiveContentType(existing);
+    let scaffolded = null;
+    if (hasRepoContent(contentType)) {
+        const opts = {};
+        if (flags.author !== undefined)
+            opts.authorOverride = flags.author;
+        if (layout !== undefined)
+            opts.layout = layout;
+        try {
+            scaffolded = scaffoldBlogPost(projectRoot, config, site, existing, opts);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err));
+        }
+    }
+    // Phase 19a removed CalendarEntry.filePath — path-encoding lives in
+    // the scaffolded file's frontmatter `id:` and is resolved through
+    // the content index at read time. The scaffolder still reports
+    // `contentRelativePath` in its result for the JSON emit so the
+    // caller can show the operator where the file was created.
+    const updated = outlineEntry(calendar, slug);
+    writeCalendar(calendarPath, calendar);
+    emit({
+        slug: updated.slug,
+        title: updated.title,
+        stage: updated.stage,
+        contentType,
+        scaffolded,
+        site,
+        calendarPath,
+    });
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=outline.js.map

package/dist/commands/outline.js.map

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

package/dist/commands/pause.d.ts

@@ -0,0 +1,15 @@
+/**
+ * deskwork-pause — move a non-terminal entry to Paused.
+ *
+ * Records the prior stage on `pausedFrom` so `deskwork resume` can put
+ * the entry back where it came from. Refuses to pause Published or
+ * already-Paused entries (see core's `pauseEntry`). #27.
+ *
+ * Usage:
+ *   deskwork-pause <project-root> [--site <slug>] <slug>
+ *
+ * Emits a JSON result:
+ *   { slug, stage: "Paused", pausedFrom, site, calendarPath }
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=pause.d.ts.map

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

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

package/dist/commands/pause.js

@@ -0,0 +1,70 @@
+/**
+ * deskwork-pause — move a non-terminal entry to Paused.
+ *
+ * Records the prior stage on `pausedFrom` so `deskwork resume` can put
+ * the entry back where it came from. Refuses to pause Published or
+ * already-Paused entries (see core's `pauseEntry`). #27.
+ *
+ * Usage:
+ *   deskwork-pause <project-root> [--site <slug>] <slug>
+ *
+ * Emits a JSON result:
+ *   { slug, stage: "Paused", pausedFrom, site, calendarPath }
+ */
+import { readConfig } from '@deskwork/core/config';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { findEntry, pauseEntry } from '@deskwork/core/calendar-mutations';
+import { resolveSite, resolveCalendarPath } from '@deskwork/core/paths';
+import { absolutize, emit, fail, parseArgs } from '@deskwork/core/cli-args';
+export async function run(argv) {
+    const KNOWN_FLAGS = ['site'];
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork-pause <project-root> [--site <slug>] <slug>', 2);
+    }
+    const [rootArg, slug] = positional;
+    const projectRoot = absolutize(rootArg);
+    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);
+    const existing = findEntry(calendar, slug);
+    if (!existing) {
+        const available = calendar.entries
+            .filter((e) => e.stage !== 'Published' && e.stage !== 'Paused')
+            .map((e) => e.slug)
+            .join(', ') || '(none)';
+        fail(`No calendar entry found with slug "${slug}". Pausable entries: ${available}`);
+    }
+    let paused;
+    try {
+        paused = pauseEntry(calendar, slug);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    writeCalendar(calendarPath, calendar);
+    emit({
+        slug: paused.slug,
+        title: paused.title,
+        stage: paused.stage,
+        pausedFrom: paused.pausedFrom,
+        site,
+        calendarPath,
+    });
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=pause.js.map

package/dist/commands/pause.js.map

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

package/dist/commands/plan.d.ts

@@ -0,0 +1,12 @@
+/**
+ * deskwork-plan — move an Ideas entry to Planned and set target keywords.
+ *
+ * Usage:
+ *   deskwork-plan <project-root> [--site <slug>] [--topics t1,t2,...]
+ *                 <slug> [<keyword1> <keyword2> ...]
+ *
+ * Keywords may be passed as separate positionals or a single
+ * comma-separated string. Emits a JSON result with the updated entry.
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=plan.d.ts.map

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

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

package/dist/commands/plan.js

@@ -0,0 +1,74 @@
+/**
+ * deskwork-plan — move an Ideas entry to Planned and set target keywords.
+ *
+ * Usage:
+ *   deskwork-plan <project-root> [--site <slug>] [--topics t1,t2,...]
+ *                 <slug> [<keyword1> <keyword2> ...]
+ *
+ * Keywords may be passed as separate positionals or a single
+ * comma-separated string. Emits a JSON result with the updated entry.
+ */
+import { readConfig } from '@deskwork/core/config';
+import { readCalendar, writeCalendar } from '@deskwork/core/calendar';
+import { planEntry } from '@deskwork/core/calendar-mutations';
+import { resolveSite, resolveCalendarPath } from '@deskwork/core/paths';
+import { absolutize, emit, fail, parseArgs } from '@deskwork/core/cli-args';
+export async function run(argv) {
+    const KNOWN_FLAGS = ['site', 'topics'];
+    const { positional, flags } = parse();
+    if (positional.length < 2) {
+        fail('Usage: deskwork-plan <project-root> [--site <slug>] [--topics t1,t2,...] ' +
+            '<slug> [<keyword1> <keyword2> ...]', 2);
+    }
+    const [rootArg, slug, ...keywordArgs] = positional;
+    const projectRoot = absolutize(rootArg);
+    // Accept "a, b, c" as a single arg or separate positionals. Both shapes
+    // collapse to a flat string[] of non-empty trimmed keywords.
+    const keywords = keywordArgs
+        .flatMap((k) => k.split(','))
+        .map((k) => k.trim())
+        .filter((k) => k.length > 0);
+    let topics;
+    if (flags.topics !== undefined) {
+        topics = flags.topics
+            .split(',')
+            .map((t) => t.trim())
+            .filter((t) => t.length > 0);
+    }
+    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);
+    let entry;
+    try {
+        entry = planEntry(calendar, slug, keywords, topics ? { topics } : undefined);
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+    }
+    writeCalendar(calendarPath, calendar);
+    emit({
+        slug: entry.slug,
+        title: entry.title,
+        stage: entry.stage,
+        targetKeywords: entry.targetKeywords,
+        topics: entry.topics,
+        site,
+        calendarPath,
+    });
+    function parse() {
+        try {
+            return parseArgs(argv, KNOWN_FLAGS);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : String(err), 2);
+        }
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/commands/publish.d.ts

@@ -0,0 +1,18 @@
+/**
+ * deskwork-publish — mark a Drafting/Review entry as Published.
+ *
+ * For blog entries, the helper verifies that `<contentDir>/<slug>/index.md`
+ * exists — refusing to publish a post whose file hasn't been written. For
+ * youtube/tool entries, the helper requires `contentUrl` to be set on the
+ * entry; if it's missing, pass --content-url to set it in the same call.
+ *
+ * Usage:
+ *   deskwork-publish <project-root> [--site <slug>] [--date YYYY-MM-DD]
+ *                    [--content-url URL] <slug>
+ *
+ * Emits a JSON result:
+ *   { slug, stage: "Published", datePublished, contentType, contentUrl?,
+ *     issueNumber?, filePath?, site, calendarPath }
+ */
+export declare function run(argv: string[]): Promise<void>;
+//# sourceMappingURL=publish.d.ts.map

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

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