@telora/factory 0.4.5

package/dist/gates/deterministic.js

@@ -0,0 +1,186 @@
+/**
+ * Deterministic gate evaluation.
+ *
+ * Runs configured shell commands (typecheck, lint, test, build) in the
+ * worktree directory and captures structured results. Commands execute
+ * sequentially; the first failure short-circuits remaining checks.
+ */
+import { spawn } from 'node:child_process';
+import { resolveTraceChecks, runTraceChecks, formatTraceOutput } from '../trace-engine.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Log prefix for deterministic gate messages. */
+const LOG_PREFIX = '[gate:deterministic]';
+/** Default commands when the blueprint does not configure any. */
+const DEFAULT_COMMANDS = [
+    'npm run typecheck',
+    'npm run lint',
+    'npm test',
+    'npm run build',
+];
+/** Maximum output length per check (chars). Truncates from start, keeping tail. */
+const MAX_OUTPUT_CHARS = 10_000;
+/** Per-command timeout in milliseconds (10 minutes). */
+const COMMAND_TIMEOUT_MS = 600_000;
+// ============================================================================
+// Output truncation
+// ============================================================================
+/**
+ * Truncate output to the configured maximum length.
+ * Keeps the tail (most recent output) and prepends a truncation marker.
+ */
+function truncateOutput(output) {
+    if (output.length <= MAX_OUTPUT_CHARS) {
+        return output;
+    }
+    const truncationMarker = '... [output truncated] ...\n';
+    const keepLength = MAX_OUTPUT_CHARS - truncationMarker.length;
+    return truncationMarker + output.slice(-keepLength);
+}
+/**
+ * Run a single shell command in the given working directory.
+ *
+ * Uses `child_process.spawn` with `/bin/sh -c` to handle shell syntax
+ * (pipes, redirects, etc.). Captures combined stdout+stderr. Enforces
+ * a per-command timeout.
+ */
+function runCommand(command, cwd) {
+    return new Promise((resolve) => {
+        const startTime = Date.now();
+        const chunks = [];
+        let settled = false;
+        const proc = spawn('/bin/sh', ['-c', command], {
+            cwd,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: { ...process.env, CI: 'true', PORT: '0' },
+        });
+        // Capture stdout
+        proc.stdout.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+        // Capture stderr (interleaved with stdout in the output)
+        proc.stderr.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+        // Timeout guard
+        const timer = setTimeout(() => {
+            if (!settled) {
+                settled = true;
+                proc.kill('SIGTERM');
+                // Give the process a brief window to exit after SIGTERM
+                setTimeout(() => {
+                    try {
+                        proc.kill('SIGKILL');
+                    }
+                    catch {
+                        // Process may already be gone -- ignore
+                    }
+                }, 5000);
+                const durationMs = Date.now() - startTime;
+                const output = Buffer.concat(chunks).toString('utf-8');
+                resolve({
+                    exitCode: 124, // Conventional timeout exit code (like GNU timeout)
+                    output: truncateOutput(output + `\n[TIMEOUT] Command exceeded ${COMMAND_TIMEOUT_MS}ms limit`),
+                    durationMs,
+                });
+            }
+        }, COMMAND_TIMEOUT_MS);
+        proc.on('close', (code) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                const durationMs = Date.now() - startTime;
+                const output = Buffer.concat(chunks).toString('utf-8');
+                resolve({
+                    exitCode: code ?? 1,
+                    output: truncateOutput(output),
+                    durationMs,
+                });
+            }
+        });
+        proc.on('error', (error) => {
+            if (!settled) {
+                settled = true;
+                clearTimeout(timer);
+                const durationMs = Date.now() - startTime;
+                const output = Buffer.concat(chunks).toString('utf-8');
+                resolve({
+                    exitCode: 1,
+                    output: truncateOutput(output + `\n[ERROR] Failed to spawn command: ${error.message}`),
+                    durationMs,
+                });
+            }
+        });
+    });
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Run deterministic gate checks in the given worktree.
+ *
+ * Executes the configured commands sequentially. Each command is run as a
+ * shell command in the worktree directory. The first failure short-circuits
+ * remaining checks.
+ *
+ * @param worktreePath - Absolute path to the git worktree directory
+ * @param config - Blueprint deterministic gate config, or null for defaults
+ * @returns Overall pass/fail and per-check results
+ */
+export async function runDeterministicGates(worktreePath, config, traceChecks) {
+    const commands = config?.commands?.length
+        ? config.commands
+        : DEFAULT_COMMANDS;
+    const results = [];
+    let allPassed = true;
+    console.log(`${LOG_PREFIX} Running ${commands.length} check(s) in ${worktreePath}`);
+    for (const command of commands) {
+        console.log(`${LOG_PREFIX} Running: ${command}`);
+        const { exitCode, output, durationMs } = await runCommand(command, worktreePath);
+        const passed = exitCode === 0;
+        const result = {
+            checkName: command,
+            passed,
+            output,
+            durationMs,
+            isAdversaryGenerated: false,
+        };
+        results.push(result);
+        if (passed) {
+            console.log(`${LOG_PREFIX} PASSED: ${command} (${durationMs}ms)`);
+        }
+        else {
+            allPassed = false;
+            console.warn(`${LOG_PREFIX} FAILED: ${command} (exit code ${exitCode}, ${durationMs}ms)`);
+            // Short-circuit: stop running remaining checks after first failure
+            break;
+        }
+    }
+    // Run trace checks after command-based checks pass
+    if (allPassed && traceChecks && traceChecks.length > 0) {
+        const resolved = resolveTraceChecks(traceChecks);
+        if (resolved.length > 0) {
+            console.log(`${LOG_PREFIX} Running ${resolved.length} trace check(s)...`);
+            const traceResults = await runTraceChecks(resolved, worktreePath);
+            for (const trace of traceResults) {
+                const result = {
+                    checkName: `trace:${trace.checkName}`,
+                    passed: trace.passed,
+                    output: formatTraceOutput(trace),
+                    durationMs: trace.durationMs,
+                    isAdversaryGenerated: false,
+                };
+                results.push(result);
+                if (!trace.passed) {
+                    allPassed = false;
+                    break; // Short-circuit like command checks
+                }
+            }
+        }
+    }
+    console.log(`${LOG_PREFIX} Gate evaluation ${allPassed ? 'PASSED' : 'FAILED'} ` +
+        `(${results.length}/${commands.length} check(s) executed)`);
+    return { passed: allPassed, results };
+}
+//# sourceMappingURL=deterministic.js.map

package/dist/gates/deterministic.js.map

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

package/dist/git-factory.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Git worktree management for the factory orchestrator.
+ *
+ * Thin wrappers around @telora/daemon-core shared git/worktree operations,
+ * adding factory-specific conventions:
+ * - Factory worktrees live in `.telora/factory-worktrees/` (separate from
+ *   daemon worktrees in `.telora/worktrees/`).
+ * - Branch naming: `factory/{blueprint-name}-{short-id}` (caller provides
+ *   the full branch name).
+ *
+ * All heavy lifting (git process spawning, worktree creation/removal,
+ * WIP commits) is delegated to daemon-core.
+ */
+import { runGit, commitWip, type GitResult } from '@telora/daemon-core';
+export { runGit, commitWip };
+export type { GitResult };
+/**
+ * Create a git worktree for a factory instance.
+ *
+ * The worktree is created at `{worktreeDir}/{sanitized-branch}` with a new
+ * branch forked from HEAD of the current default branch. If the branch already
+ * exists (e.g. from a paused instance), the existing branch is checked out
+ * into the worktree instead.
+ *
+ * This is a thin wrapper around `createWorktreeBase` from daemon-core.
+ * Factory worktrees never specify a `baseBranch`, so they fork from HEAD.
+ *
+ * @param repoPath      Absolute path to the main git repository.
+ * @param worktreeDir   Parent directory for factory worktrees
+ *                      (typically `.telora/factory-worktrees/`).
+ * @param branchName    Full branch name, e.g. `factory/my-blueprint-a1b2c3d4`.
+ * @returns             Absolute path to the created worktree directory.
+ * @throws              If the worktree cannot be created.
+ */
+export declare function createFactoryWorktree(repoPath: string, worktreeDir: string, branchName: string): string;
+/**
+ * Ensure MCP server build artifacts are available in a worktree.
+ *
+ * The MCP server dist/ directories are gitignored build artifacts that only
+ * exist in the main repo. Worktrees won't have them, which prevents Claude
+ * Code from loading MCP tools via .mcp.json (which uses relative paths).
+ * Symlinks each MCP dist/ directory from the main repo into the worktree.
+ */
+export declare function ensureMcpServerInWorktree(repoPath: string, worktreePath: string): void;
+/**
+ * Remove a factory worktree after completion or cancellation.
+ *
+ * Delegates to `removeWorktreeBase` from daemon-core, which handles:
+ * - Already-removed worktrees (just prune git state)
+ * - `git worktree remove --force` as the primary removal path
+ * - Fallback to manual directory deletion if git removal fails
+ *
+ * @param repoPath      Absolute path to the main git repository.
+ * @param worktreePath  Absolute path to the factory worktree to remove.
+ * @returns             `true` if the worktree was removed (or already gone),
+ *                      `false` if removal failed.
+ */
+export declare function removeWorktree(repoPath: string, worktreePath: string): boolean;
+//# sourceMappingURL=git-factory.d.ts.map

package/dist/git-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-factory.d.ts","sourceRoot":"","sources":["../src/git-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACL,MAAM,EACN,SAAS,EAGT,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC7B,YAAY,EAAE,SAAS,EAAE,CAAC;AAI1B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAQR;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CA8BtF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAE9E"}

package/dist/git-factory.js

@@ -0,0 +1,102 @@
+/**
+ * Git worktree management for the factory orchestrator.
+ *
+ * Thin wrappers around @telora/daemon-core shared git/worktree operations,
+ * adding factory-specific conventions:
+ * - Factory worktrees live in `.telora/factory-worktrees/` (separate from
+ *   daemon worktrees in `.telora/worktrees/`).
+ * - Branch naming: `factory/{blueprint-name}-{short-id}` (caller provides
+ *   the full branch name).
+ *
+ * All heavy lifting (git process spawning, worktree creation/removal,
+ * WIP commits) is delegated to daemon-core.
+ */
+import { existsSync, mkdirSync, readdirSync, symlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { runGit, commitWip, createWorktreeBase, removeWorktreeBase, } from '@telora/daemon-core';
+// ── Re-exports ─────────────────────────────────────────────────────
+// Other factory modules import runGit, commitWip, and GitResult from
+// this file. Re-export them so those imports continue to work.
+export { runGit, commitWip };
+// ── Factory-specific wrappers ──────────────────────────────────────
+/**
+ * Create a git worktree for a factory instance.
+ *
+ * The worktree is created at `{worktreeDir}/{sanitized-branch}` with a new
+ * branch forked from HEAD of the current default branch. If the branch already
+ * exists (e.g. from a paused instance), the existing branch is checked out
+ * into the worktree instead.
+ *
+ * This is a thin wrapper around `createWorktreeBase` from daemon-core.
+ * Factory worktrees never specify a `baseBranch`, so they fork from HEAD.
+ *
+ * @param repoPath      Absolute path to the main git repository.
+ * @param worktreeDir   Parent directory for factory worktrees
+ *                      (typically `.telora/factory-worktrees/`).
+ * @param branchName    Full branch name, e.g. `factory/my-blueprint-a1b2c3d4`.
+ * @returns             Absolute path to the created worktree directory.
+ * @throws              If the worktree cannot be created.
+ */
+export function createFactoryWorktree(repoPath, worktreeDir, branchName) {
+    const result = createWorktreeBase(repoPath, worktreeDir, branchName);
+    console.log(`[git-factory] Worktree ready: ${result.worktreePath}`);
+    // Symlink MCP server dist/ from main repo so .mcp.json relative paths resolve
+    ensureMcpServerInWorktree(repoPath, result.worktreePath);
+    return result.worktreePath;
+}
+/**
+ * Ensure MCP server build artifacts are available in a worktree.
+ *
+ * The MCP server dist/ directories are gitignored build artifacts that only
+ * exist in the main repo. Worktrees won't have them, which prevents Claude
+ * Code from loading MCP tools via .mcp.json (which uses relative paths).
+ * Symlinks each MCP dist/ directory from the main repo into the worktree.
+ */
+export function ensureMcpServerInWorktree(repoPath, worktreePath) {
+    const mcpDir = join(repoPath, 'mcp');
+    if (!existsSync(mcpDir))
+        return;
+    let entries;
+    try {
+        entries = readdirSync(mcpDir);
+    }
+    catch {
+        return;
+    }
+    for (const serverName of entries) {
+        const sourceDist = join(mcpDir, serverName, 'dist');
+        if (!existsSync(sourceDist))
+            continue;
+        const targetDist = join(worktreePath, 'mcp', serverName, 'dist');
+        if (existsSync(targetDist))
+            continue;
+        const targetParent = join(worktreePath, 'mcp', serverName);
+        if (!existsSync(targetParent)) {
+            mkdirSync(targetParent, { recursive: true });
+        }
+        try {
+            symlinkSync(sourceDist, targetDist, 'dir');
+            console.log(`[git-factory] Symlinked MCP dist: ${serverName}/dist -> ${sourceDist}`);
+        }
+        catch (err) {
+            console.warn(`[git-factory] Failed to symlink MCP dist for ${serverName}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+/**
+ * Remove a factory worktree after completion or cancellation.
+ *
+ * Delegates to `removeWorktreeBase` from daemon-core, which handles:
+ * - Already-removed worktrees (just prune git state)
+ * - `git worktree remove --force` as the primary removal path
+ * - Fallback to manual directory deletion if git removal fails
+ *
+ * @param repoPath      Absolute path to the main git repository.
+ * @param worktreePath  Absolute path to the factory worktree to remove.
+ * @returns             `true` if the worktree was removed (or already gone),
+ *                      `false` if removal failed.
+ */
+export function removeWorktree(repoPath, worktreePath) {
+    return removeWorktreeBase(repoPath, worktreePath);
+}
+//# sourceMappingURL=git-factory.js.map

package/dist/git-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-factory.js","sourceRoot":"","sources":["../src/git-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,MAAM,EACN,SAAS,EACT,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAE7B,sEAAsE;AACtE,qEAAqE;AACrE,+DAA+D;AAE/D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAG7B,sEAAsE;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,WAAmB,EACnB,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;IAEpE,8EAA8E;IAC9E,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAEzD,OAAO,MAAM,CAAC,YAAY,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,YAAoB;IAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAEhC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACjE,IAAI,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAErC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC3D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC;YACH,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,qCAAqC,UAAU,YAAY,UAAU,EAAE,CAAC,CAAC;QACvF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,gDAAgD,UAAU,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClI,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,YAAoB;IACnE,OAAO,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC"}

package/dist/guard-evaluation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Pure guard condition evaluation functions for the factory engine.
+ *
+ * These are extracted from packages/daemon/src/guard-engine.ts and kept
+ * in sync. They evaluate guard condition trees against an EvaluationContext
+ * without any database dependencies -- all data must be pre-fetched.
+ */
+import type { GuardConditionNode, ConditionEvalResult, EvaluationContext, GuardEvalResult, FactoryTemplateContext } from './types.js';
+/**
+ * Evaluate a JSONB condition tree for a guard.
+ * Root-level nodes are combined with AND.
+ */
+export declare function evaluateGuardConditionTree(conditions: GuardConditionNode[], ctx: EvaluationContext): {
+    passed: boolean;
+    details: ConditionEvalResult[];
+};
+/**
+ * Build factory evaluation context from in-memory state.
+ * Pure function -- no database queries.
+ */
+export declare function buildFactoryEvaluationContext(params: {
+    instanceId: string;
+    instanceState: {
+        tokensUsed: number;
+        completionGateIterations: number;
+        wallClockStartedAt: string | null;
+    };
+    blueprint: {
+        maxTokenBudget: number | null;
+        maxWallClockHours: number | null;
+        maxInstanceIterations: number | null;
+    };
+    workUnits: Array<{
+        status: string;
+    }>;
+    gateResults: Array<{
+        strategyId: string;
+        gateType: string;
+        iteration: number;
+        passed: boolean;
+    }>;
+    strategyId?: string;
+}): EvaluationContext;
+/**
+ * Interpolate guard and factory template variables.
+ */
+export declare function interpolateTemplate(template: string | null, evalResult: GuardEvalResult | null, factoryCtx?: FactoryTemplateContext | null): string;
+//# sourceMappingURL=guard-evaluation.d.ts.map

package/dist/guard-evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-evaluation.d.ts","sourceRoot":"","sources":["../src/guard-evaluation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACvB,MAAM,YAAY,CAAC;AA0UpB;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,kBAAkB,EAAE,EAChC,GAAG,EAAE,iBAAiB,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAWrD;AAMD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,wBAAwB,EAAE,MAAM,CAAC;QACjC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,SAAS,EAAE;QACT,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;KACtC,CAAC;IACF,SAAS,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,WAAW,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,iBAAiB,CA8CpB;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,UAAU,EAAE,eAAe,GAAG,IAAI,EAClC,UAAU,CAAC,EAAE,sBAAsB,GAAG,IAAI,GACzC,MAAM,CAuCR"}