agentplane 0.3.12 → 0.3.14

package/dist/commands/shared/task-store/readme.js

@@ -0,0 +1,125 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { docChanged, extractTaskDoc, mergeTaskDoc, normalizeTaskDocVersion, parseTaskReadme, renderTaskReadme, } from "@agentplaneorg/core";
+import { taskRecordToData } from "../../../backends/task-backend.js";
+import { exitCodeForError } from "../../../cli/exit-codes.js";
+import { CliError } from "../../../shared/errors.js";
+import { writeTextIfChanged } from "../../../shared/write-if-changed.js";
+import { resolveDocUpdatedBy, taskDataToFrontmatter } from "../task-backend.js";
+function taskReadmePath(ctx, taskId) {
+    return path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.workflow_dir, taskId, "README.md");
+}
+export function normalizeTaskRevision(value, fallback = 1) {
+    return Number.isInteger(value) && Number(value) > 0 ? Number(value) : fallback;
+}
+export function readStoredTaskRevision(value) {
+    return Number.isInteger(value) && Number(value) > 0 ? Number(value) : null;
+}
+export function isConcurrentReadmeChangeError(err) {
+    return (err instanceof CliError &&
+        err.code === "E_IO" &&
+        err.message.startsWith("Task README changed concurrently:"));
+}
+export function throwTaskRevisionConflict(opts) {
+    throw new CliError({
+        exitCode: exitCodeForError("E_VALIDATION"),
+        code: "E_VALIDATION",
+        message: `Task revision changed concurrently: ${opts.taskId} ` +
+            `(expected revision ${opts.expectedRevision}, current revision ${opts.currentRevision})`,
+        context: {
+            task_id: opts.taskId,
+            expected_revision: opts.expectedRevision,
+            current_revision: opts.currentRevision,
+            reason_code: "task_revision_conflict",
+        },
+    });
+}
+export async function readTaskReadmeCached(opts) {
+    const readmePath = taskReadmePath(opts.ctx, opts.taskId);
+    let text;
+    let st;
+    try {
+        st = await stat(readmePath);
+        text = await readFile(readmePath, "utf8");
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT") {
+            throw new CliError({
+                exitCode: 4,
+                code: "E_IO",
+                message: `ENOENT: no such file or directory, open '${readmePath}'`,
+            });
+        }
+        throw err;
+    }
+    const parsed = parseTaskReadme(text);
+    const task = taskRecordToData({
+        id: opts.taskId,
+        frontmatter: parsed.frontmatter,
+        body: parsed.body,
+        readmePath,
+    });
+    return { task, readmePath, mtimeMs: st.mtimeMs, parsed, rawText: text };
+}
+export async function ensureUnchangedOnDisk(opts) {
+    const st = await stat(opts.readmePath);
+    if (st.mtimeMs !== opts.expectedMtimeMs) {
+        throw new CliError({
+            exitCode: exitCodeForError("E_IO"),
+            code: "E_IO",
+            message: `Task README changed concurrently: ${opts.readmePath}`,
+        });
+    }
+}
+export async function didReadmeChangeOnDisk(opts) {
+    try {
+        const st = await stat(opts.readmePath);
+        return st.mtimeMs !== opts.expectedMtimeMs;
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === "ENOENT")
+            return true;
+        throw err;
+    }
+}
+export async function writeTaskReadme(opts) {
+    const { entry, next } = opts;
+    const frontmatter = { ...entry.parsed.frontmatter, ...taskDataToFrontmatter(next) };
+    let body = entry.parsed.body ?? "";
+    const existingDoc = extractTaskDoc(body);
+    const now = new Date().toISOString();
+    const currentDocVersion = normalizeTaskDocVersion(entry.parsed.frontmatter.doc_version);
+    const requestedDocVersion = normalizeTaskDocVersion(next.doc_version, currentDocVersion);
+    if (next.doc !== undefined) {
+        const nextDoc = String(next.doc ?? "");
+        body = mergeTaskDoc(body, nextDoc);
+        if (docChanged(existingDoc, nextDoc) || !frontmatter.doc_updated_at) {
+            frontmatter.doc_version = requestedDocVersion;
+            frontmatter.doc_updated_at = now;
+            frontmatter.doc_updated_by = resolveDocUpdatedBy(next);
+        }
+    }
+    frontmatter.doc_version = normalizeTaskDocVersion(frontmatter.doc_version, requestedDocVersion);
+    if (typeof frontmatter.doc_updated_at !== "string" || frontmatter.doc_updated_at.trim() === "") {
+        frontmatter.doc_updated_at = now;
+    }
+    if (typeof frontmatter.doc_updated_by !== "string" || frontmatter.doc_updated_by.trim() === "") {
+        frontmatter.doc_updated_by = resolveDocUpdatedBy(next);
+    }
+    const storedRevision = readStoredTaskRevision(entry.parsed.frontmatter.revision);
+    frontmatter.revision = storedRevision ?? 1;
+    let nextText = renderTaskReadme(frontmatter, body);
+    nextText = nextText.endsWith("\n") ? nextText : `${nextText}\n`;
+    if (storedRevision !== null && nextText !== entry.rawText) {
+        frontmatter.revision = storedRevision + 1;
+        nextText = renderTaskReadme(frontmatter, body);
+        nextText = nextText.endsWith("\n") ? nextText : `${nextText}\n`;
+    }
+    await ensureUnchangedOnDisk({
+        readmePath: entry.readmePath,
+        expectedMtimeMs: entry.mtimeMs,
+    });
+    return await writeTextIfChanged(entry.readmePath, nextText);
+}

package/dist/commands/shared/task-store/store.d.ts

@@ -0,0 +1,26 @@
+import type { TaskData } from "../../../backends/task-backend.js";
+import type { TaskStore as TaskStoreContract, TaskStoreContext, TaskStoreIntentResult, TaskStoreMutationOptions, TaskStorePatch } from "./types.js";
+export declare class TaskStore implements TaskStoreContract {
+    private ctx;
+    private cache;
+    constructor(ctx: TaskStoreContext);
+    get(taskId: string): Promise<TaskData>;
+    update(taskId: string, updater: (current: TaskData) => Promise<TaskData> | TaskData, opts?: TaskStoreMutationOptions): Promise<{
+        changed: boolean;
+        task: TaskData;
+    }>;
+    patch(taskId: string, builder: (current: TaskData) => Promise<TaskStorePatch | null | undefined> | TaskStorePatch | null | undefined, opts?: TaskStoreMutationOptions): Promise<{
+        changed: boolean;
+        task: TaskData;
+    }>;
+    mutate(taskId: string, builder: (current: TaskData) => Promise<TaskStoreIntentResult> | TaskStoreIntentResult, opts?: TaskStoreMutationOptions): Promise<{
+        changed: boolean;
+        task: TaskData;
+    }>;
+    private getCached;
+    private runWithRetry;
+    private writeNextTask;
+}
+export declare function getTaskStore(ctx: TaskStoreContext): TaskStore;
+export declare function backendIsLocalFileBackend(ctx: TaskStoreContext): boolean;
+//# sourceMappingURL=store.d.ts.map

package/dist/commands/shared/task-store/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/commands/shared/task-store/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAiBlE,OAAO,KAAK,EAEV,SAAS,IAAI,iBAAiB,EAC9B,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,qBAAa,SAAU,YAAW,iBAAiB;IACjD,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,KAAK,CAA0C;gBAE3C,GAAG,EAAE,gBAAgB;IAI3B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKtC,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAC5D,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IAM1C,KAAK,CACT,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CACP,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,EACnF,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IAQ1C,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,EACtF,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;YAOlC,SAAS;YAmBT,YAAY;YAiDZ,aAAa;CAgB5B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAI7D;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAExE"}

package/dist/commands/shared/task-store/store.js

@@ -0,0 +1,105 @@
+import { exitCodeForError } from "../../../cli/exit-codes.js";
+import { CliError } from "../../../shared/errors.js";
+import { backendUsesLocalTaskStore } from "../task-backend.js";
+import { applyTaskStoreIntents, resolveTaskStoreIntents, resolveTaskStorePatch, } from "./intents.js";
+import { didReadmeChangeOnDisk, isConcurrentReadmeChangeError, normalizeTaskRevision, readTaskReadmeCached, throwTaskRevisionConflict, writeTaskReadme, } from "./readme.js";
+export class TaskStore {
+    ctx;
+    cache = new Map();
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    async get(taskId) {
+        const entry = await this.getCached(taskId);
+        return entry.task;
+    }
+    async update(taskId, updater, opts = {}) {
+        return await this.runWithRetry(taskId, opts, async (entry) => {
+            return await updater({ ...entry.task });
+        });
+    }
+    async patch(taskId, builder, opts = {}) {
+        return await this.mutate(taskId, async (current) => resolveTaskStorePatch(await builder(current)), opts);
+    }
+    async mutate(taskId, builder, opts = {}) {
+        return await this.runWithRetry(taskId, opts, async (entry) => {
+            const intents = resolveTaskStoreIntents(await builder({ ...entry.task }));
+            return applyTaskStoreIntents(entry, intents);
+        });
+    }
+    async getCached(taskId) {
+        const key = taskId.trim();
+        if (!key) {
+            throw new CliError({
+                exitCode: exitCodeForError("E_USAGE"),
+                code: "E_USAGE",
+                message: "task id is required",
+            });
+        }
+        const existing = this.cache.get(key);
+        if (existing)
+            return await existing;
+        const load = (async () => {
+            return await readTaskReadmeCached({ ctx: this.ctx, taskId: key });
+        })();
+        this.cache.set(key, load);
+        return await load;
+    }
+    async runWithRetry(taskId, opts, computeNext) {
+        for (let attempt = 0; attempt < 2; attempt++) {
+            const entry = await this.getCached(taskId);
+            if (opts.expectedRevision !== undefined) {
+                const expectedRevision = normalizeTaskRevision(opts.expectedRevision);
+                const currentRevision = normalizeTaskRevision(entry.task.revision);
+                if (currentRevision !== expectedRevision) {
+                    throwTaskRevisionConflict({ taskId, expectedRevision, currentRevision });
+                }
+            }
+            let next;
+            try {
+                next = await computeNext(entry);
+            }
+            catch (err) {
+                if (attempt === 0 &&
+                    err instanceof CliError &&
+                    err.code === "E_VALIDATION" &&
+                    (await didReadmeChangeOnDisk({
+                        readmePath: entry.readmePath,
+                        expectedMtimeMs: entry.mtimeMs,
+                    }))) {
+                    this.cache.delete(taskId);
+                    continue;
+                }
+                throw err;
+            }
+            try {
+                return await this.writeNextTask(taskId, entry, next);
+            }
+            catch (err) {
+                if (attempt === 0 && isConcurrentReadmeChangeError(err)) {
+                    this.cache.delete(taskId);
+                    continue;
+                }
+                throw err;
+            }
+        }
+        const task = await this.get(taskId);
+        return { changed: false, task };
+    }
+    async writeNextTask(taskId, entry, next) {
+        const changed = await writeTaskReadme({ entry, next });
+        this.cache.set(taskId, (async () => {
+            return await readTaskReadmeCached({ ctx: this.ctx, taskId });
+        })());
+        const updated = await this.get(taskId);
+        return { changed, task: updated };
+    }
+}
+export function getTaskStore(ctx) {
+    const memo = ctx.memo;
+    memo.taskStore ??= new TaskStore(ctx);
+    return memo.taskStore;
+}
+export function backendIsLocalFileBackend(ctx) {
+    return backendUsesLocalTaskStore(ctx);
+}

package/dist/commands/shared/task-store/types.d.ts

@@ -0,0 +1,94 @@
+import type { ParsedTaskReadme } from "@agentplaneorg/core";
+import type { TaskData, TaskEvent } from "../../../backends/task-backend.js";
+import type { CommandContext } from "../task-backend.js";
+export type CachedTask = {
+    task: TaskData;
+    readmePath: string;
+    mtimeMs: number;
+    parsed: ParsedTaskReadme;
+    rawText: string;
+};
+export type TaskComment = NonNullable<TaskData["comments"]>[number];
+export type TaskDocState = {
+    comments: TaskData["comments"] | null;
+    doc: string;
+    doc_updated_at?: string;
+    doc_updated_by?: string;
+    doc_version: 2 | 3;
+    owner: string;
+    sections?: TaskData["sections"] | null;
+};
+export type TaskStoreTaskPatch = Partial<Omit<TaskData, "doc" | "comments" | "events" | "doc_version" | "doc_updated_at" | "doc_updated_by">>;
+export type TaskStoreDocPatch = {
+    kind: "replace-doc";
+    doc: string;
+    expectedCurrentDoc?: string | null;
+} | {
+    kind: "set-section";
+    section: string;
+    text: string;
+    requiredSections: string[];
+    expectedCurrentText?: string | null;
+};
+export type TaskStorePatch = {
+    task?: TaskStoreTaskPatch;
+    appendComments?: TaskComment[];
+    appendEvents?: TaskEvent[];
+    doc?: TaskStoreDocPatch;
+    docMeta?: {
+        touch?: boolean;
+        updatedBy?: string;
+        version?: 2 | 3;
+    };
+};
+export type TaskStoreIntent = {
+    kind: "set-task-fields";
+    task: TaskStoreTaskPatch;
+} | {
+    kind: "append-comments";
+    comments: TaskComment[];
+} | {
+    kind: "append-events";
+    events: TaskEvent[];
+} | {
+    kind: "replace-doc";
+    doc: string;
+    expectedCurrentDoc?: string | null;
+} | {
+    kind: "set-section";
+    section: string;
+    text: string;
+    requiredSections: string[];
+    expectedCurrentText?: string | null;
+} | {
+    kind: "touch-doc-meta";
+    updatedBy?: string;
+    version?: 2 | 3;
+};
+export type TaskStoreIntentResult = TaskStoreIntent | readonly TaskStoreIntent[] | null | undefined;
+export type TaskStoreMutationOptions = {
+    expectedRevision?: number;
+};
+export type TaskStoreLike = Pick<TaskStore, "patch"> & {
+    mutate?: TaskStore["mutate"];
+};
+export type TaskStoreReader = {
+    get(taskId: string): Promise<TaskData>;
+};
+export interface TaskStore {
+    get(taskId: string): Promise<TaskData>;
+    update(taskId: string, updater: (current: TaskData) => Promise<TaskData> | TaskData, opts?: TaskStoreMutationOptions): Promise<{
+        changed: boolean;
+        task: TaskData;
+    }>;
+    patch(taskId: string, builder: (current: TaskData) => Promise<TaskStorePatch | null | undefined> | TaskStorePatch | null | undefined, opts?: TaskStoreMutationOptions): Promise<{
+        changed: boolean;
+        task: TaskData;
+    }>;
+    mutate(taskId: string, builder: (current: TaskData) => Promise<TaskStoreIntentResult> | TaskStoreIntentResult, opts?: TaskStoreMutationOptions): Promise<{
+        changed: boolean;
+        task: TaskData;
+    }>;
+}
+export type TaskStoreContext = CommandContext;
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/shared/task-store/types.d.ts.map

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

package/dist/commands/shared/task-store/types.js

@@ -0,0 +1 @@
+export {};

package/dist/commands/shared/task-store.d.ts

@@ -1,110 +1,4 @@
-import { type TaskData, type TaskEvent } from "../../backends/task-backend.js";
-import { type CommandContext } from "./task-backend.js";
-type TaskComment = NonNullable<TaskData["comments"]>[number];
-export type TaskStoreTaskPatch = Partial<Omit<TaskData, "doc" | "comments" | "events" | "doc_version" | "doc_updated_at" | "doc_updated_by">>;
-export type TaskStoreDocPatch = {
-    kind: "replace-doc";
-    doc: string;
-    expectedCurrentDoc?: string | null;
-} | {
-    kind: "set-section";
-    section: string;
-    text: string;
-    requiredSections: string[];
-    expectedCurrentText?: string | null;
-};
-export type TaskStorePatch = {
-    task?: TaskStoreTaskPatch;
-    appendComments?: TaskComment[];
-    appendEvents?: TaskEvent[];
-    doc?: TaskStoreDocPatch;
-    docMeta?: {
-        touch?: boolean;
-        updatedBy?: string;
-        version?: 2 | 3;
-    };
-};
-export type TaskStoreIntent = {
-    kind: "set-task-fields";
-    task: TaskStoreTaskPatch;
-} | {
-    kind: "append-comments";
-    comments: TaskComment[];
-} | {
-    kind: "append-events";
-    events: TaskEvent[];
-} | {
-    kind: "replace-doc";
-    doc: string;
-    expectedCurrentDoc?: string | null;
-} | {
-    kind: "set-section";
-    section: string;
-    text: string;
-    requiredSections: string[];
-    expectedCurrentText?: string | null;
-} | {
-    kind: "touch-doc-meta";
-    updatedBy?: string;
-    version?: 2 | 3;
-};
-export type TaskStoreIntentResult = TaskStoreIntent | readonly TaskStoreIntent[] | null | undefined;
-export type TaskStoreMutationOptions = {
-    expectedRevision?: number;
-};
-export type TaskStoreLike = Pick<TaskStore, "patch"> & {
-    mutate?: TaskStore["mutate"];
-};
-export declare function setTaskFieldsIntent(task: TaskStoreTaskPatch): TaskStoreIntent;
-export declare function appendTaskCommentsIntent(comments: TaskComment[]): TaskStoreIntent;
-export declare function appendTaskCommentIntent(comment: TaskComment): TaskStoreIntent;
-export declare function appendTaskEventsIntent(events: TaskEvent[]): TaskStoreIntent;
-export declare function appendTaskEventIntent(event: TaskEvent): TaskStoreIntent;
-export declare function replaceTaskDocIntent(opts: {
-    doc: string;
-    expectedCurrentDoc?: string | null;
-}): TaskStoreIntent;
-export declare function setTaskSectionIntent(opts: {
-    section: string;
-    text: string;
-    requiredSections: string[];
-    expectedCurrentText?: string | null;
-}): TaskStoreIntent;
-export declare function touchTaskDocMetaIntent(opts?: {
-    updatedBy?: string;
-    version?: 2 | 3;
-}): TaskStoreIntent;
-export declare function taskStorePatchFromIntents(intents: TaskStoreIntentResult): TaskStorePatch | null | undefined;
-export declare function mutateTaskStore(store: TaskStoreLike, taskId: string, builder: (current: TaskData) => Promise<TaskStoreIntentResult> | TaskStoreIntentResult, opts?: TaskStoreMutationOptions): Promise<{
-    changed: boolean;
-    task: TaskData;
-}>;
-export declare function applyTaskStoreIntentsToTask(task: TaskData, intents: TaskStoreIntentResult, opts?: {
-    currentDocVersion?: 2 | 3;
-    docUpdatedAt?: string;
-}): TaskData;
-export declare class TaskStore {
-    private ctx;
-    private cache;
-    constructor(ctx: CommandContext);
-    get(taskId: string): Promise<TaskData>;
-    private getCached;
-    update(taskId: string, updater: (current: TaskData) => Promise<TaskData> | TaskData, opts?: TaskStoreMutationOptions): Promise<{
-        changed: boolean;
-        task: TaskData;
-    }>;
-    patch(taskId: string, builder: (current: TaskData) => Promise<TaskStorePatch | null | undefined> | TaskStorePatch | null | undefined, opts?: TaskStoreMutationOptions): Promise<{
-        changed: boolean;
-        task: TaskData;
-    }>;
-    mutate(taskId: string, builder: (current: TaskData) => Promise<TaskStoreIntentResult> | TaskStoreIntentResult, opts?: TaskStoreMutationOptions): Promise<{
-        changed: boolean;
-        task: TaskData;
-    }>;
-    private runWithRetry;
-    private writeNextTask;
-}
-export declare function getTaskStore(ctx: CommandContext): TaskStore;
-export declare function backendIsLocalFileBackend(ctx: CommandContext): boolean;
-export {};
+export type { TaskStoreDocPatch, TaskStoreIntent, TaskStoreIntentResult, TaskStoreLike, TaskStoreMutationOptions, TaskStorePatch, TaskStoreTaskPatch, } from "./task-store/types.js";
+export { appendTaskCommentIntent, appendTaskCommentsIntent, appendTaskEventIntent, appendTaskEventsIntent, applyTaskStoreIntentsToTask, mutateTaskStore, replaceTaskDocIntent, setTaskFieldsIntent, setTaskSectionIntent, taskStorePatchFromIntents, touchTaskDocMetaIntent, } from "./task-store/intents.js";
+export { TaskStore, backendIsLocalFileBackend, getTaskStore } from "./task-store/store.js";
 //# sourceMappingURL=task-store.d.ts.map

package/dist/commands/shared/task-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-store.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-store.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-store.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}