oh-my-codex 0.21.0 → 0.21.2

package/dist/ralplan/advisory-activation-verifier.js

@@ -0,0 +1,77 @@
+import { constants as fsConstants } from 'node:fs';
+import { lstat, open } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { listActiveSkills } from '../state/skill-active.js';
+import { syncDirectory, syncRegularFile } from '../utils/file-durability.js';
+/** @internal Durability seam for deterministic Windows tests. */
+export const ADVISORY_ACTIVATION_VERIFIER_TEST_SEAM = {};
+function parseRecord(raw, path) {
+    const value = JSON.parse(raw);
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`ralplan_advisory_activation_projection_invalid:${path}`);
+    }
+    return value;
+}
+export async function verifyPinnedJsonAndSync(path, predicate, beforeSync) {
+    const handle = await open(path, fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW);
+    try {
+        const opened = await handle.stat();
+        const before = await lstat(path);
+        if (!opened.isFile() || opened.nlink !== 1 || !before.isFile() || before.isSymbolicLink()
+            || before.nlink !== 1 || opened.dev !== before.dev || opened.ino !== before.ino) {
+            throw new Error(`ralplan_advisory_activation_projection_identity_invalid:${path}`);
+        }
+        const value = parseRecord(await handle.readFile('utf8'), path);
+        if (!predicate(value))
+            throw new Error(`ralplan_advisory_activation_projection_mismatch:${path}`);
+        const validated = await handle.stat();
+        await beforeSync?.();
+        const fileSyncOutcome = await (ADVISORY_ACTIVATION_VERIFIER_TEST_SEAM.fileSync ?? syncRegularFile)(handle);
+        if (fileSyncOutcome !== 'synced' && fileSyncOutcome !== 'unsupported-windows-eperm') {
+            throw new Error(`ralplan_advisory_activation_file_fsync_unsupported:${path}`);
+        }
+        const synced = await handle.stat();
+        if (synced.size !== validated.size || synced.mtimeMs !== validated.mtimeMs || synced.ctimeMs !== validated.ctimeMs) {
+            throw new Error(`ralplan_advisory_activation_projection_content_changed:${path}`);
+        }
+        const after = await lstat(path);
+        if (!after.isFile() || after.isSymbolicLink() || after.nlink !== 1
+            || after.dev !== opened.dev || after.ino !== opened.ino) {
+            throw new Error(`ralplan_advisory_activation_projection_identity_changed:${path}`);
+        }
+        const parent = await open(dirname(path), fsConstants.O_RDONLY | fsConstants.O_DIRECTORY);
+        try {
+            const directorySyncOutcome = await (ADVISORY_ACTIVATION_VERIFIER_TEST_SEAM.directorySync ?? syncDirectory)(parent);
+            if (directorySyncOutcome !== 'synced' && directorySyncOutcome !== 'unsupported-windows-eperm') {
+                throw new Error(`ralplan_advisory_activation_directory_fsync_unsupported:${dirname(path)}`);
+            }
+        }
+        finally {
+            await parent.close();
+        }
+        return value;
+    }
+    finally {
+        await handle.close();
+    }
+}
+export function describeAdvisoryActivationProjections(stateDir, sessionId, generationId) {
+    const sessionDir = join(stateDir, 'sessions', sessionId);
+    const hasExactAdvisorySkill = (state) => listActiveSkills(state).some((entry) => (entry.skill === 'ralplan' && entry.active !== false && entry.session_id === sessionId
+        && entry.workflow_variant === 'advisory' && entry.advisory_generation_id === generationId));
+    return {
+        mode: {
+            path: join(sessionDir, 'ralplan-state.json'),
+            predicate: (state) => state.active === true && state.mode === 'ralplan' && state.session_id === sessionId
+                && state.workflow_variant === 'advisory' && state.advisory_generation_id === generationId
+                && state.execution_handoff_authorized === false && state.host_verified === false,
+        },
+        run: {
+            path: join(sessionDir, 'run-state.json'),
+            predicate: (state) => state.active === true && state.mode === 'ralplan',
+        },
+        sessionSkill: { path: join(sessionDir, 'skill-active-state.json'), predicate: hasExactAdvisorySkill },
+        rootSkill: { path: join(stateDir, 'skill-active-state.json'), predicate: hasExactAdvisorySkill },
+    };
+}
+//# sourceMappingURL=advisory-activation-verifier.js.map

package/dist/ralplan/advisory-activation-verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisory-activation-verifier.js","sourceRoot":"","sources":["../../src/ralplan/advisory-activation-verifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE7E,iEAAiE;AACjE,MAAM,CAAC,MAAM,sCAAsC,GAG/C,EAAE,CAAC;AASP,SAAS,WAAW,CAAC,GAAW,EAAE,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACzC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAY,EACZ,SAAsC,EACtC,UAAuC;IAEvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC/E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,cAAc,EAAE;eACpF,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,IAAI,EAAE,CAAC,CAAC;QAClG,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,UAAU,EAAE,EAAE,CAAC;QACrB,MAAM,eAAe,GAAG,MAAM,CAAC,sCAAsC,CAAC,QAAQ,IAAI,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;QAC3G,IAAI,eAAe,KAAK,QAAQ,IAAI,eAAe,KAAK,2BAA2B,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,sDAAsD,IAAI,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;YACnH,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC;eAC7D,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QACzF,IAAI,CAAC;YACH,MAAM,oBAAoB,GAAG,MAAM,CAAC,sCAAsC,CAAC,aAAa,IAAI,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;YACnH,IAAI,oBAAoB,KAAK,QAAQ,IAAI,oBAAoB,KAAK,2BAA2B,EAAE,CAAC;gBAC9F,MAAM,IAAI,KAAK,CAAC,2DAA2D,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;gBAAS,CAAC;YAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,QAAgB,EAChB,SAAiB,EACjB,YAAoB;IAOpB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACzD,MAAM,qBAAqB,GAAG,CAAC,KAA8B,EAAW,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACjH,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;WAClF,KAAK,CAAC,gBAAgB,KAAK,UAAU,IAAI,KAAK,CAAC,sBAAsB,KAAK,YAAY,CAC1F,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC;YAC5C,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;mBACpG,KAAK,CAAC,gBAAgB,KAAK,UAAU,IAAI,KAAK,CAAC,sBAAsB,KAAK,YAAY;mBACtF,KAAK,CAAC,4BAA4B,KAAK,KAAK,IAAI,KAAK,CAAC,aAAa,KAAK,KAAK;SACnF;QACD,GAAG,EAAE;YACH,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC;YACxC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;SACxE;QACD,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,yBAAyB,CAAC,EAAE,SAAS,EAAE,qBAAqB,EAAE;QACrG,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,EAAE,SAAS,EAAE,qBAAqB,EAAE;KACjG,CAAC;AACJ,CAAC"}

package/dist/ralplan/advisory-activation.d.ts

@@ -0,0 +1,34 @@
+import { type AdvisoryActivation, type AdvisoryProjection } from './advisory.js';
+export type AdvisoryActivationCheckpoint = 'after_intent' | 'after_mode' | 'after_run_state' | 'after_session_skill' | 'after_root_skill' | 'before_mode_fsync' | 'before_skill_mirror_commit' | 'after_skill_mirror_transaction' | 'before_commit' | 'intent_committed';
+export interface ActivateOrResumeRalplanAdvisoryInput {
+    cwd: string;
+    sessionId: string;
+    rootThreadId: string;
+    activationTurnId: string;
+    prompt: string;
+    producer: 'native' | string;
+    threadKind: 'root-or-drift' | string;
+    generationId?: string;
+    predecessorGenerationId?: string;
+    maxIterations?: number;
+    nowIso?: string;
+    resumeOnly?: boolean;
+    failpoint?: (checkpoint: AdvisoryActivationCheckpoint) => void | Promise<void>;
+}
+type AdvisoryActivationResult = {
+    activation: AdvisoryActivation;
+    projection: AdvisoryProjection;
+};
+/**
+ * Single activation owner for Ralplan Advisory. The durable intent remains in
+ * place until every canonical runtime projection is present, verified, and
+ * fsynced; retries repair those projections for the same generation.
+ */
+export declare function activateOrResumeRalplanAdvisory(input: ActivateOrResumeRalplanAdvisoryInput & {
+    resumeOnly: true;
+}): Promise<AdvisoryActivationResult | null>;
+export declare function activateOrResumeRalplanAdvisory(input: ActivateOrResumeRalplanAdvisoryInput & {
+    resumeOnly?: false | undefined;
+}): Promise<AdvisoryActivationResult>;
+export {};
+//# sourceMappingURL=advisory-activation.d.ts.map

package/dist/ralplan/advisory-activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisory-activation.d.ts","sourceRoot":"","sources":["../../src/ralplan/advisory-activation.ts"],"names":[],"mappings":"AASA,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAGvB,MAAM,MAAM,4BAA4B,GACpC,cAAc,GACd,YAAY,GACZ,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,4BAA4B,GAC5B,gCAAgC,GAChC,eAAe,GACf,kBAAkB,CAAC;AAEvB,MAAM,WAAW,oCAAoC;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,UAAU,EAAE,eAAe,GAAG,MAAM,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,4BAA4B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAED,KAAK,wBAAwB,GAAG;IAAE,UAAU,EAAE,kBAAkB,CAAC;IAAC,UAAU,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAoHnG;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,oCAAoC,GAAG;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,GACjE,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAAC;AAC5C,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,oCAAoC,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,GAAG,SAAS,CAAA;CAAE,GAC/E,OAAO,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/ralplan/advisory-activation.js

@@ -0,0 +1,205 @@
+import { createHash } from 'node:crypto';
+import { constants as fsConstants } from 'node:fs';
+import { open } from 'node:fs/promises';
+import { join } from 'node:path';
+import { startMode } from '../modes/base.js';
+import { getBaseStateDir } from '../mcp/state-paths.js';
+import { getSkillActiveStatePathsForStateDir, listActiveSkills, mergeRootSkillStateForExactSession, skillActiveOwnershipMatchesExactSession, updateSkillActiveStateCopiesForExactSessionTransaction } from '../state/skill-active.js';
+import { assertStateFileWriteTransactionIdentity, outsideStateFileWriteTransaction, syncExplicitSessionModeState, withStateFileWriteTransaction } from '../state/operations.js';
+import { assertCanonicalModeBindingLeaseSupported } from '../state/mode-binding-lease.js';
+import { commitPreparedRalplanAdvisoryActivationInternal, prepareRalplanAdvisoryActivationInternal, readAuthorizedPendingRalplanActivation, readCurrentRalplanAdvisory, reconcileRalplanAdvisory, } from './advisory.js';
+import { describeAdvisoryActivationProjections, verifyPinnedJsonAndSync } from './advisory-activation-verifier.js';
+async function verifyAllActivationProjections(projections) {
+    await verifyPinnedJsonAndSync(projections.mode.path, projections.mode.predicate);
+    await verifyPinnedJsonAndSync(projections.run.path, projections.run.predicate);
+    await verifyPinnedJsonAndSync(projections.sessionSkill.path, projections.sessionSkill.predicate);
+    await verifyPinnedJsonAndSync(projections.rootSkill.path, projections.rootSkill.predicate);
+}
+function parseRecord(raw, path) {
+    const value = JSON.parse(raw);
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`ralplan_advisory_activation_projection_invalid:${path}`);
+    }
+    return value;
+}
+async function readExistingRecord(path) {
+    try {
+        const handle = await open(path, fsConstants.O_RDONLY | fsConstants.O_NOFOLLOW);
+        try {
+            return parseRecord(await handle.readFile('utf8'), path);
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+}
+function assertRepairableBindingMetadata(value, generationId, conflictCode) {
+    if (!value)
+        return;
+    for (const field of ['workflow_variant', 'advisory_generation_id']) {
+        if (Object.prototype.hasOwnProperty.call(value, field) && typeof value[field] !== 'string') {
+            throw new Error(conflictCode);
+        }
+    }
+    const variant = typeof value.workflow_variant === 'string' ? value.workflow_variant.trim() : '';
+    const generation = typeof value.advisory_generation_id === 'string' ? value.advisory_generation_id.trim() : '';
+    if ((variant && variant !== 'advisory') || (generation && generation !== generationId)) {
+        throw new Error(conflictCode);
+    }
+}
+function assertRepairableRootSkillBinding(rootState, sessionId, generationId) {
+    if (rootState && skillActiveOwnershipMatchesExactSession(rootState, sessionId)) {
+        assertRepairableBindingMetadata(rootState, generationId, 'ralplan_advisory_activation_root_skill_binding_conflict');
+    }
+    const rootRalplan = listActiveSkills(rootState ?? {})
+        .filter((entry) => entry.skill === 'ralplan' && skillActiveOwnershipMatchesExactSession(entry, sessionId));
+    if (rootRalplan.length > 1) {
+        throw new Error('ralplan_advisory_activation_root_skill_identity_mismatch');
+    }
+    assertRepairableBindingMetadata(rootRalplan[0], generationId, 'ralplan_advisory_activation_root_skill_binding_conflict');
+}
+function assertRepairableCommittedLifecycle(projection, generationId) {
+    if (!projection || projection.corruption || projection.activation.generation_id !== generationId
+        || projection.fence || projection.journal || projection.admin_event) {
+        throw new Error('ralplan_advisory_committed_activation_not_precloseout');
+    }
+}
+async function publishAdvisorySkillMirrors(stateDir, sessionId, generationId, validateRuntime, validateLifecycle, failpoint) {
+    const skillPaths = getSkillActiveStatePathsForStateDir(stateDir, sessionId);
+    if (!skillPaths.sessionPath)
+        throw new Error('ralplan_advisory_activation_session_skill_path_missing');
+    await updateSkillActiveStateCopiesForExactSessionTransaction(stateDir, sessionId, async (currentRoot, currentSession) => {
+        await validateLifecycle();
+        await validateRuntime();
+        const entries = listActiveSkills(currentSession ?? {});
+        const exactRalplan = entries.filter((entry) => entry.skill === 'ralplan' && entry.session_id === sessionId);
+        if (exactRalplan.length !== 1 || exactRalplan[0]?.active === false) {
+            throw new Error('ralplan_advisory_activation_session_skill_identity_mismatch');
+        }
+        assertRepairableBindingMetadata(exactRalplan[0], generationId, 'ralplan_advisory_activation_session_skill_binding_conflict');
+        assertRepairableRootSkillBinding(currentRoot, sessionId, generationId);
+        await failpoint?.('before_skill_mirror_commit');
+        return {
+            ...currentSession,
+            workflow_variant: 'advisory',
+            advisory_generation_id: generationId,
+            active_skills: entries.map((entry) => entry.skill === 'ralplan' && entry.session_id === sessionId
+                ? { ...entry, workflow_variant: 'advisory', advisory_generation_id: generationId }
+                : entry),
+        };
+    }, { projectRoot: (currentRoot, nextSession) => mergeRootSkillStateForExactSession(currentRoot, nextSession, sessionId) });
+    await failpoint?.('after_skill_mirror_transaction');
+}
+export async function activateOrResumeRalplanAdvisory(input) {
+    assertCanonicalModeBindingLeaseSupported();
+    for (const [field, value] of [
+        ['sessionId', input.sessionId], ['rootThreadId', input.rootThreadId],
+        ['activationTurnId', input.activationTurnId], ['generationId', input.generationId],
+    ]) {
+        if (value !== undefined && (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/u.test(value) || value === '.' || value === '..')) {
+            throw new Error(`ralplan_advisory_${field}_invalid`);
+        }
+    }
+    if (input.producer !== 'native' || input.threadKind !== 'root-or-drift') {
+        if (input.resumeOnly)
+            return null;
+        throw new Error('ralplan_advisory_activation_authority_required');
+    }
+    const bindingPath = join(getBaseStateDir(input.cwd), 'sessions', input.sessionId, 'ralplan-state.json');
+    const isolatedInput = input.failpoint
+        ? { ...input, failpoint: (checkpoint) => outsideStateFileWriteTransaction(() => input.failpoint(checkpoint)) }
+        : input;
+    return withStateFileWriteTransaction(bindingPath, () => activateOrResumeRalplanAdvisoryUnderCanonicalLock(isolatedInput), getBaseStateDir(input.cwd));
+}
+async function activateOrResumeRalplanAdvisoryUnderCanonicalLock(input) {
+    if (input.producer !== 'native' || input.threadKind !== 'root-or-drift') {
+        if (input.resumeOnly)
+            return null;
+        throw new Error('ralplan_advisory_activation_authority_required');
+    }
+    const authority = {
+        cwd: input.cwd, sessionId: input.sessionId, producer: input.producer, threadKind: input.threadKind,
+        rootThreadId: input.rootThreadId, activationTurnId: input.activationTurnId, prompt: input.prompt,
+    };
+    let activation = await readAuthorizedPendingRalplanActivation(authority);
+    if (!activation && input.resumeOnly)
+        return null;
+    if (!activation) {
+        const committed = await readCurrentRalplanAdvisory(input.cwd, input.sessionId);
+        if (committed?.activation) {
+            const expectedPrompt = createHash('sha256').update(input.prompt).digest('hex');
+            const sameIdentity = committed.activation.root_thread_id === input.rootThreadId
+                && committed.activation.activation_turn_id === input.activationTurnId
+                && committed.activation.activation_prompt_sha256 === expectedPrompt;
+            const binding = await readExistingRecord(join(getBaseStateDir(input.cwd), 'sessions', input.sessionId, 'ralplan-state.json'));
+            if (sameIdentity && binding?.active === true && binding.workflow_variant === 'advisory'
+                && binding.advisory_generation_id === committed.activation.generation_id) {
+                assertRepairableCommittedLifecycle(committed, committed.activation.generation_id);
+                const stateDir = getBaseStateDir(input.cwd);
+                const projections = describeAdvisoryActivationProjections(stateDir, input.sessionId, committed.activation.generation_id);
+                const verifyRuntime = async () => {
+                    await verifyPinnedJsonAndSync(projections.mode.path, projections.mode.predicate);
+                    await verifyPinnedJsonAndSync(projections.run.path, projections.run.predicate);
+                };
+                await publishAdvisorySkillMirrors(stateDir, input.sessionId, committed.activation.generation_id, verifyRuntime, async () => assertRepairableCommittedLifecycle(await readCurrentRalplanAdvisory(input.cwd, input.sessionId), committed.activation.generation_id), input.failpoint);
+                await verifyAllActivationProjections(projections);
+                return { activation: committed.activation, projection: committed };
+            }
+            if (binding?.active === true && binding.workflow_variant === 'advisory') {
+                throw new Error('ralplan_advisory_committed_activation_authority_mismatch');
+            }
+        }
+        const existingBinding = await readExistingRecord(join(getBaseStateDir(input.cwd), 'sessions', input.sessionId, 'ralplan-state.json'));
+        if (existingBinding?.active === true)
+            throw new Error('ralplan_advisory_start_binding_conflict');
+        activation = await prepareRalplanAdvisoryActivationInternal({
+            cwd: input.cwd, sessionId: input.sessionId, rootThreadId: input.rootThreadId,
+            activationTurnId: input.activationTurnId, activationPrompt: input.prompt,
+            ...(input.generationId ? { generationId: input.generationId } : {}),
+            ...(input.predecessorGenerationId ? { predecessorGenerationId: input.predecessorGenerationId } : {}),
+            ...(input.nowIso ? { nowIso: input.nowIso } : {}),
+        });
+        await input.failpoint?.('after_intent');
+    }
+    await startMode('ralplan', input.prompt, input.maxIterations ?? 50, input.cwd, input.sessionId, {
+        kind: 'ralplan-advisory', sessionId: input.sessionId, generationId: activation.generation_id,
+        rootThreadId: input.rootThreadId, activationTurnId: input.activationTurnId,
+        activationPrompt: input.prompt,
+    });
+    await syncExplicitSessionModeState('ralplan', input.cwd, input.sessionId);
+    const stateDir = getBaseStateDir(input.cwd);
+    const projections = describeAdvisoryActivationProjections(stateDir, input.sessionId, activation.generation_id);
+    const verifyMode = (beforeSync) => verifyPinnedJsonAndSync(projections.mode.path, projections.mode.predicate, beforeSync);
+    const verifyRun = () => verifyPinnedJsonAndSync(projections.run.path, projections.run.predicate);
+    const verifySessionSkill = () => verifyPinnedJsonAndSync(projections.sessionSkill.path, projections.sessionSkill.predicate);
+    const verifyRootSkill = () => verifyPinnedJsonAndSync(projections.rootSkill.path, projections.rootSkill.predicate);
+    await publishAdvisorySkillMirrors(stateDir, input.sessionId, activation.generation_id, async () => { await verifyMode(); await verifyRun(); }, async () => undefined, input.failpoint);
+    await verifyMode(() => input.failpoint?.('before_mode_fsync'));
+    await input.failpoint?.('after_mode');
+    await verifyRun();
+    await input.failpoint?.('after_run_state');
+    await verifySessionSkill();
+    await input.failpoint?.('after_session_skill');
+    await verifyRootSkill();
+    await input.failpoint?.('after_root_skill');
+    await input.failpoint?.('before_commit');
+    await assertStateFileWriteTransactionIdentity(join(stateDir, 'sessions', input.sessionId, 'ralplan-state.json'), stateDir);
+    await verifyAllActivationProjections(projections);
+    await commitPreparedRalplanAdvisoryActivationInternal({
+        cwd: input.cwd, sessionId: input.sessionId,
+        producer: input.producer, threadKind: input.threadKind, rootThreadId: input.rootThreadId,
+        activationTurnId: input.activationTurnId,
+        failpoint: (name) => name === 'intent_committed' ? input.failpoint?.('intent_committed') : undefined,
+    });
+    const projection = await reconcileRalplanAdvisory(input.cwd, input.sessionId);
+    if (!projection || projection.corruption) {
+        throw new Error(`ralplan_advisory_activation_commit_failed:${projection?.corruption ?? 'missing'}`);
+    }
+    return { activation, projection };
+}
+//# sourceMappingURL=advisory-activation.js.map

package/dist/ralplan/advisory-activation.js.map

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

package/dist/ralplan/advisory-contract.d.ts

@@ -0,0 +1,103 @@
+import type { AdvisoryReviewLifecycle } from './advisory-evidence.js';
+export declare const RALPLAN_ADVISORY_SCHEMA_VERSION = 1;
+export type AdvisoryFenceState = 'pending_closeout' | 'recovery_required' | 'closed' | 'abandoned' | 'released';
+export type AdvisoryOutcome = 'approved' | 'exhausted' | 'rejected' | 'failed' | 'cancelled' | 'abandoned';
+export type AdvisoryIntent = 'execute' | 'replan' | 'new_advisory' | 'abandon' | 'unrelated';
+export type AdvisoryIntegrityStatus = 'proven' | 'unproven';
+export declare const JOURNAL_STEPS: readonly ['session_mode', 'root_mode', 'session_skill', 'root_skill', 'post_digest', 'journal_commit', 'fence_terminal'];
+export type JournalStep = (typeof JOURNAL_STEPS)[number];
+export interface AdvisoryActivation {
+    schema_version: 1;
+    generation_id: string;
+    predecessor_generation_id?: string;
+    canonical_cwd: string;
+    session_id: string;
+    root_thread_id: string;
+    activation_turn_id: string;
+    activation_prompt_sha256?: string;
+    created_at: string;
+}
+export interface AdvisoryCurrentPointer {
+    schema_version: 1;
+    generation_id: string;
+    predecessor_generation_id?: string;
+    session_id: string;
+    canonical_cwd: string;
+    updated_at: string;
+}
+export interface AdvisoryRolloverIntent {
+    schema_version: 1;
+    predecessor_generation_id?: string;
+    generation_id: string;
+    session_id: string;
+    root_thread_id: string;
+    activation_turn_id: string;
+    activation_prompt_sha256?: string;
+    canonical_cwd: string;
+    created_at: string;
+}
+export interface AdvisoryFence extends AdvisoryActivation {
+    state: AdvisoryFenceState;
+    closing_turn_id: string;
+    iteration: number;
+    iteration_id?: string;
+    plan_manifest_sha256?: string;
+    architect_review_sha256?: string;
+    critic_review_sha256?: string;
+    evidence_bundle_sha256?: string;
+    outcome?: AdvisoryOutcome;
+    integrity_status?: AdvisoryIntegrityStatus;
+    release_turn_id?: string;
+    release_thread_id?: string;
+    release_prompt_sha256?: string;
+    requested_lane?: string;
+    authority_kind?: 'new_root_user_execution_request';
+    updated_at: string;
+    sequence: number;
+    previous_event_sha256?: string;
+}
+export interface AdvisoryJournal {
+    schema_version: 1;
+    generation_id: string;
+    outcome: AdvisoryOutcome;
+    integrity_status: AdvisoryIntegrityStatus;
+    evidence_bundle_sha256?: string;
+    terminal_mode_updates?: Record<string, unknown>;
+    terminal_skill_updates?: {
+        session_skill?: Record<string, unknown> | null;
+        root_skill?: Record<string, unknown> | null;
+    };
+    terminal_timestamp: string;
+    phase: 'prepared' | 'committed';
+    steps: Record<JournalStep, 'pending' | 'applied'>;
+    created_at: string;
+    updated_at: string;
+}
+export interface AdvisoryAdminEvent {
+    schema_version: 1;
+    action: 'abandon';
+    generation_id: string;
+    session_id: string;
+    root_thread_id: string;
+    turn_id: string;
+    prior_fence_sha256: string;
+    prior_journal_sha256?: string;
+    created_at: string;
+}
+export interface AdvisoryProjection {
+    activation: AdvisoryActivation;
+    fence: AdvisoryFence | null;
+    journal: AdvisoryJournal | null;
+    admin_event?: AdvisoryAdminEvent | null;
+    denyProductWrites: boolean;
+    corruption: string | null;
+}
+export type RalplanAdvisoryInvocationKind = 'none' | 'valid' | 'invalid';
+export declare function parseRalplanAdvisoryInvocation(text: string): RalplanAdvisoryInvocationKind;
+export declare function isDirectRalplanAdvisoryInvocation(text: string): boolean;
+export declare function classifyAdvisoryPrompt(prompt: string): AdvisoryIntent;
+export declare function validateAdvisoryInactiveState(state: Record<string, unknown>, projection: AdvisoryProjection | null): string | null;
+export declare function isCanonicalInactiveAdvisoryBinding(state: Record<string, unknown> | null, sessionId: string, generationId: string): boolean;
+export declare function validateAdvisoryPreparedInactiveWrite(state: Record<string, unknown>, projection: AdvisoryProjection | null): string | null;
+export type { AdvisoryReviewLifecycle };
+//# sourceMappingURL=advisory-contract.d.ts.map

package/dist/ralplan/advisory-contract.d.ts.map

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

package/dist/ralplan/advisory-contract.js

@@ -0,0 +1,83 @@
+export const RALPLAN_ADVISORY_SCHEMA_VERSION = 1;
+export const JOURNAL_STEPS = [
+    'session_mode', 'root_mode', 'session_skill', 'root_skill',
+    'post_digest', 'journal_commit', 'fence_terminal',
+];
+const EXECUTION_VERBS = /\b(?:implement(?:á|a|e|ar)?|fix(?:e|ear|á)?|correg(?:í|ir|i)|ejecut(?:á|a|e|ar)|corr(?:é|e|er)|build|ship|deploy|aplic(?:á|a|ar)|cre(?:á|a|ar))\b/iu;
+const EXECUTION_ANCHOR = /(?:\b(?:issue|bug|test|tests|command|comando|task|tarea|plan|prd|spec|archivo|file|path|ruta)\b\s*(?:#?\w+|[.:/-])|(?:^|\s)(?:\.\.?\/|\/)[^\s]+|`[^`]+`|#[0-9]+)/iu;
+const QUESTION = /\?|\b(?:qué|como|cómo|cuál|cual|por qué|porqué|status|estado|explic(?:á|a)|revis(?:á|a)|opin(?:á|a))\b/iu;
+const FUTURE_OR_CONDITIONAL = /\b(?:si|cuando|después|luego|podr(?:ía|ias|íamos)|deber(?:ía|ias|íamos)|quiero que eventualmente|más adelante)\b/iu;
+const CONSERVATIVE = /\b(?:no|nunca|sin|not|never|without|cannot|can't|won't|don't)\b/iu;
+const MODAL = /\b(?:pod(?:és|es|rías?|ria|ría)|deber(?:ías?|ias?|ía)|quer(?:és|es|rías?|ria|ría)|sería\s+posible)\b/iu;
+const ENGLISH_MODAL = /(?:\b(?:can|could|would|will)\s+you\b|\b(?:should|can|could|would)\s+(?:i|we)\b|\bwhether\b|\basking\s+(?:if|whether)\b)/iu;
+const META = /^\s*(?:(?:por\s+favor|please)\s+)?(?:consider(?:á|a|ar)?|copi(?:á|a|ar)|copy|confirm(?:á|a|ar)?|quote|cit(?:á|a|ar)|document(?:á|a|ar)?|traduc(?:í|ir)|translate)\b/iu;
+const QUOTED = /^\s*(?:>|```|~~~|[`"“'‘])|(?:```|~~~)[\s\S]*(?:implement|execute|fix|ejecut|correg)/iu;
+const PRIMARY = /^\s*(?:(?:por\s+favor|please)\s+)?(?:implement(?:á|a|e|ar)?|fix(?:e|ear|á)?|correg(?:í|ir|i)|ejecut(?:á|a|e|ar)|corr(?:é|e|er)|build|ship|deploy|aplic(?:á|a|ar)|cre(?:á|a|ar))\b/iu;
+export function parseRalplanAdvisoryInvocation(text) {
+    const tokens = text.trim().split(/\s+/u);
+    if (!/^\$(?:oh-my-codex:)?ralplan$/iu.test(tokens[0] ?? ''))
+        return 'none';
+    const args = tokens.slice(1);
+    if (!args.some((token) => token.toLowerCase().startsWith('--advisory')))
+        return 'none';
+    return args.every((token) => /^--(?:advisory|interactive|deliberate)$/iu.test(token)
+        || !token.startsWith('-') && !token.startsWith('$')) ? 'valid' : 'invalid';
+}
+export function isDirectRalplanAdvisoryInvocation(text) {
+    return parseRalplanAdvisoryInvocation(text) === 'valid';
+}
+export function classifyAdvisoryPrompt(prompt) {
+    const text = prompt.trim();
+    if (!text || META.test(text) || QUOTED.test(text) || QUESTION.test(text) || FUTURE_OR_CONDITIONAL.test(text)
+        || MODAL.test(text) || ENGLISH_MODAL.test(text) || CONSERVATIVE.test(text))
+        return 'unrelated';
+    if (/^\s*(?:abandon(?:á|a|ar)?|cancel(?:á|a|ar)?)\s+(?:el\s+)?(?:ralplan|advisory|plan)/iu.test(text))
+        return 'abandon';
+    if (isDirectRalplanAdvisoryInvocation(text)
+        || /^\s*(?:inici(?:á|a|ar)|cre(?:á|a|ar)|hac(?:é|e|er))\s+(?:un\s+)?(?:new advisory|nuevo advisory|nueva planificación advisory)\b/iu.test(text))
+        return 'new_advisory';
+    if (/^\s*(?:replan\b|replanific(?:á|a|ar)(?:\s|$)|volv(?:é|e)(?:\s|$)\s+a\s+planificar\b)/iu.test(text))
+        return 'replan';
+    if (/^(?:continue|continuá|dale|ok|sí|si|go|proceed)[.!]?$/iu.test(text))
+        return 'unrelated';
+    return PRIMARY.test(text) && EXECUTION_VERBS.test(text) && EXECUTION_ANCHOR.test(text) ? 'execute' : 'unrelated';
+}
+function object(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;
+}
+export function validateAdvisoryInactiveState(state, projection) {
+    if (state.mode !== 'ralplan' || state.workflow_variant !== 'advisory' || state.active !== false)
+        return null;
+    if (!projection || projection.corruption || !projection.fence || (!projection.journal && !projection.admin_event))
+        return 'ralplan_advisory_inactive_requires_canonical_fence_and_journal';
+    if (!['closed', 'abandoned', 'recovery_required'].includes(projection.fence.state))
+        return 'ralplan_advisory_inactive_fence_not_terminal';
+    if (!projection.admin_event && projection.journal?.phase !== 'committed')
+        return 'ralplan_advisory_inactive_journal_not_committed';
+    if (projection.fence.generation_id !== state.advisory_generation_id)
+        return 'ralplan_advisory_inactive_generation_mismatch';
+    if (state.execution_handoff_authorized !== false || state.host_verified !== false || object(state.ralplan_consensus_gate)?.complete !== false)
+        return 'ralplan_advisory_inactive_explicit_false_fields_required';
+    if (projection.journal && projection.journal.outcome !== 'approved' && object(state.ralplan_review_lifecycle)?.complete === true)
+        return 'ralplan_advisory_negative_outcome_lifecycle_complete_forbidden';
+    return null;
+}
+export function isCanonicalInactiveAdvisoryBinding(state, sessionId, generationId) {
+    return Boolean(state && state.mode === 'ralplan' && state.session_id === sessionId && state.workflow_variant === 'advisory'
+        && state.advisory_generation_id === generationId && state.active === false);
+}
+export function validateAdvisoryPreparedInactiveWrite(state, projection) {
+    if (state.mode !== 'ralplan' || state.workflow_variant !== 'advisory' || state.active !== false)
+        return null;
+    if (!projection || projection.corruption || !projection.fence || !projection.journal)
+        return 'ralplan_advisory_inactive_requires_prepared_fence_and_journal';
+    if (projection.fence.state !== 'pending_closeout')
+        return 'ralplan_advisory_prepared_write_requires_pending_fence';
+    if (projection.journal.phase !== 'prepared')
+        return 'ralplan_advisory_prepared_write_requires_prepared_journal';
+    if (projection.fence.generation_id !== state.advisory_generation_id || projection.journal.generation_id !== state.advisory_generation_id)
+        return 'ralplan_advisory_prepared_write_generation_mismatch';
+    return state.execution_handoff_authorized !== false || state.host_verified !== false
+        ? 'ralplan_advisory_prepared_explicit_false_fields_required' : null;
+}
+//# sourceMappingURL=advisory-contract.js.map

package/dist/ralplan/advisory-contract.js.map

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

package/dist/ralplan/advisory-detached-transition.d.ts

@@ -0,0 +1,11 @@
+export interface DetachedAdvisorySessionSkillTransition {
+    baseline: Record<string, unknown>;
+    rootBaseline?: Record<string, unknown> | null;
+    current: Record<string, unknown>;
+    journalProjection: Record<string, unknown>;
+    terminalModeState: Record<string, unknown>;
+    terminalTimestamp: string;
+    sessionId: string;
+}
+export declare function validateDetachedAdvisorySessionSkillTransition(input: DetachedAdvisorySessionSkillTransition): void;
+//# sourceMappingURL=advisory-detached-transition.d.ts.map

package/dist/ralplan/advisory-detached-transition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisory-detached-transition.d.ts","sourceRoot":"","sources":["../../src/ralplan/advisory-detached-transition.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sCAAsC;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,8CAA8C,CAC5D,KAAK,EAAE,sCAAsC,GAC5C,IAAI,CAsBN"}

package/dist/ralplan/advisory-detached-transition.js

@@ -0,0 +1,21 @@
+import { isDeepStrictEqual } from 'util';
+import { projectRalplanTerminalSkillMirrors } from '../state/operations.js';
+export function validateDetachedAdvisorySessionSkillTransition(input) {
+    const projected = projectRalplanTerminalSkillMirrors({
+        rootSkillState: input.rootBaseline ?? null,
+        sessionSkillState: input.baseline,
+        terminalState: input.terminalModeState,
+        sessionId: input.sessionId,
+        nowIso: input.terminalTimestamp,
+    }).session_skill;
+    const canonicalProjection = projected
+        ? JSON.parse(JSON.stringify(projected))
+        : null;
+    if (!canonicalProjection || !isDeepStrictEqual(input.journalProjection, canonicalProjection)) {
+        throw new Error('Refusing cancellation because detached Advisory journal session skill was not produced by the canonical writer.');
+    }
+    if (!isDeepStrictEqual(input.current, input.journalProjection)) {
+        throw new Error('Refusing cancellation because detached Advisory session skill differs from the canonical terminal payload.');
+    }
+}
+//# sourceMappingURL=advisory-detached-transition.js.map

package/dist/ralplan/advisory-detached-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisory-detached-transition.js","sourceRoot":"","sources":["../../src/ralplan/advisory-detached-transition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAE,kCAAkC,EAAE,MAAM,wBAAwB,CAAC;AAY5E,MAAM,UAAU,8CAA8C,CAC5D,KAA6C;IAE7C,MAAM,SAAS,GAAG,kCAAkC,CAAC;QACnD,cAAc,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QAC1C,iBAAiB,EAAE,KAAK,CAAC,QAAQ;QACjC,aAAa,EAAE,KAAK,CAAC,iBAAiB;QACtC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,iBAAiB;KAChC,CAAC,CAAC,aAAa,CAAC;IACjB,MAAM,mBAAmB,GAAG,SAAS;QACnC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAA4B;QAClE,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,CAAC,mBAAmB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,KAAK,CACb,iHAAiH,CAClH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,4GAA4G,CAC7G,CAAC;IACJ,CAAC;AACH,CAAC"}