@context-forge/cli 0.8.5 → 0.8.6

package/dist/commands/prompt.js

@@ -0,0 +1,112 @@
+import * as path from 'node:path';
+import { FileProjectStore, SystemPromptParser } from '@context-forge/core/node';
+import { PROMPT_FILE_RELATIVE_PATH, applyWorktreeOverlay } from '@context-forge/core';
+import { resolveProjectWorktree } from '../utils/project.js';
+import { resolveOperationPath } from '../utils/worktree-overlay.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { withJsonOption, withProjectOption, withRawOption } from '../options.js';
+import { printJson, printRaw } from '../output/formatter.js';
+import { renderTable } from '../output/tables.js';
+import { getPhaseShorthands, resolvePhaseInput } from '../utils/phaseShorthand.js';
+/**
+ * Substitute project variables into template content.
+ * Unresolvable variables are preserved as-is.
+ */
+function substituteVariables(content, project) {
+    const vars = {
+        'project': project.name,
+        'slice': project.fileSlice,
+        'task-file': project.fileTasks,
+        'fileArch': project.fileArch,
+        'fileHLD': project.fileHLD,
+        'fileSpec': project.fileSpec,
+        'development-phase': project.developmentPhase,
+    };
+    return content.replace(/\{(\w[\w-]*)}/g, (_match, varName) => {
+        const value = vars[varName];
+        return value !== undefined ? value : `{${varName}}`;
+    });
+}
+export function registerPromptCommand(program) {
+    const cmd = program
+        .command('prompt')
+        .description('Access prompt templates with variable substitution');
+    const listCmd = cmd.command('list').description('List available prompt templates');
+    withJsonOption(listCmd);
+    withProjectOption(listCmd);
+    listCmd.action(async (opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id, worktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'.`);
+            }
+            const opPath = resolveOperationPath(project, worktreeId);
+            if (!opPath) {
+                throw new UserError(`Project '${project.name}' has no projectPath configured.\n` +
+                    '  cf project set projectPath /path/to/project');
+            }
+            const promptFilePath = path.join(opPath, PROMPT_FILE_RELATIVE_PATH);
+            const parser = new SystemPromptParser(promptFilePath);
+            const prompts = await parser.getAllPrompts();
+            // Build shorthand map for display
+            const shorthands = await getPhaseShorthands(opPath);
+            const shorthandReverse = new Map();
+            for (const [key, name] of shorthands) {
+                shorthandReverse.set(name.toLowerCase(), key);
+            }
+            const templates = prompts.map((p) => {
+                const shorthand = shorthandReverse.get(p.name.replace(/\s*\(Phase \d+(?:\.\d+)?\)\s*/, '').toLowerCase()) ?? '';
+                return {
+                    name: p.name,
+                    key: p.key,
+                    shorthand,
+                    parameterCount: p.parameters.length,
+                };
+            });
+            if (opts.json) {
+                printJson(templates);
+                return;
+            }
+            const rows = templates.map((t) => [t.name, t.key, t.shorthand]);
+            console.log(renderTable(['Name', 'Key', 'Shorthand'], rows));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    const getCmd = cmd.command('get <phase>').description('Get a prompt template with project variables substituted');
+    withProjectOption(getCmd);
+    withRawOption(getCmd);
+    getCmd.action(async (phase, opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id, worktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'.`);
+            }
+            const opPath = resolveOperationPath(project, worktreeId);
+            if (!opPath) {
+                throw new UserError(`Project '${project.name}' has no projectPath configured.\n` +
+                    '  cf project set projectPath /path/to/project');
+            }
+            // Resolve shorthand or name to instruction key
+            const resolvedPhase = await resolvePhaseInput(phase, opPath);
+            const promptFilePath = path.join(opPath, PROMPT_FILE_RELATIVE_PATH);
+            const parser = new SystemPromptParser(promptFilePath);
+            const prompt = await parser.getPromptForInstruction(resolvedPhase);
+            if (!prompt) {
+                throw new UserError(`No prompt found for '${phase}'. Run cf prompt list to see available templates.`);
+            }
+            const resolved = worktreeId ? applyWorktreeOverlay(project, worktreeId) : project;
+            const output = opts.raw ? prompt.content : substituteVariables(prompt.content, resolved);
+            printRaw(output);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/commands/prompt.js.map

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

package/dist/commands/setup-ide.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+/** Returns true if the file contains the context-forge managed marker in the first 20 lines. */
+export declare function isManagedClaudeMd(filePath: string): boolean;
+/**
+ * Returns true if the Copilot IDE install is managed by context-forge.
+ * Checks the first 20 lines of .github/copilot-instructions.md and AGENTS.md.
+ * Returns true if at least one of those files exists and contains the marker.
+ */
+export declare function isManagedCopilotFiles(projectPath: string): boolean;
+/** Run IDE setup for a project. Errors propagate to the caller. */
+export declare function setupIdeAction(projectPath: string, target: string, opts?: {
+    yes?: boolean;
+}): Promise<void>;
+export declare function registerSetupIdeCommand(program: Command): void;
+//# sourceMappingURL=setup-ide.d.ts.map

package/dist/commands/setup-ide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-ide.d.ts","sourceRoot":"","sources":["../../src/commands/setup-ide.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBpC,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI3D;AAID;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAgBlE;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAuGf;AAmFD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqC9D"}

package/dist/commands/setup-ide.js

@@ -0,0 +1,250 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { execFileSync } from 'node:child_process';
+import { FileProjectStore, GuideDetector, GUIDE_RELATIVE_PATH } from '@context-forge/core/node';
+import { resolveProjectId } from '../utils/project.js';
+import { withProjectOption, withYesOption } from '../options.js';
+import { handleError, UserError } from '../utils/errors.js';
+const VALID_TARGETS = ['claude', 'copilot'];
+/** Prompt user for y/N confirmation via stdin. Returns true if confirmed. */
+function askConfirmation(prompt) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+    });
+}
+/** Returns true if the file contains the context-forge managed marker in the first 20 lines. */
+export function isManagedClaudeMd(filePath) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const lines = content.split('\n').slice(0, 20);
+    return lines.some((line) => line.trim() === '[//]: # (context-forge:managed)');
+}
+const COPILOT_MANAGED_MARKER = '[//]: # (context-forge:managed)';
+/**
+ * Returns true if the Copilot IDE install is managed by context-forge.
+ * Checks the first 20 lines of .github/copilot-instructions.md and AGENTS.md.
+ * Returns true if at least one of those files exists and contains the marker.
+ */
+export function isManagedCopilotFiles(projectPath) {
+    const filesToCheck = [
+        path.join(projectPath, '.github', 'copilot-instructions.md'),
+        path.join(projectPath, 'AGENTS.md'),
+    ];
+    for (const filePath of filesToCheck) {
+        if (!fs.existsSync(filePath))
+            continue;
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').slice(0, 20);
+        if (lines.some((line) => line.trim() === COPILOT_MANAGED_MARKER)) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Run IDE setup for a project. Errors propagate to the caller. */
+export async function setupIdeAction(projectPath, target, opts) {
+    // Validate target
+    if (!VALID_TARGETS.includes(target)) {
+        throw new UserError(`Invalid target '${target}'. Valid targets: ${VALID_TARGETS.join(', ')}`);
+    }
+    // Check guide installation
+    const detector = new GuideDetector();
+    const guideInfo = await detector.detect(projectPath);
+    if (!guideInfo.installed) {
+        throw new UserError("Guides are not installed. Run 'cf guides install' first.");
+    }
+    // Locate setup-ide script
+    const guideDir = path.join(projectPath, GUIDE_RELATIVE_PATH);
+    const scriptPath = path.join(guideDir, 'scripts/setup-ide');
+    if (!fs.existsSync(scriptPath)) {
+        throw new UserError(`setup-ide script not found at ${scriptPath}. Your guides installation may be incomplete — try 'cf guides update'.`);
+    }
+    // CLAUDE.md safety check
+    const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+    const claudeMdBakPath = path.join(projectPath, 'CLAUDE.md.bak');
+    if (target === 'claude') {
+        if (fs.existsSync(claudeMdPath)) {
+            if (isManagedClaudeMd(claudeMdPath)) {
+                // Managed file — skip backup silently
+            }
+            else {
+                // Not managed — possibly prompt, then backup logic
+                if (!opts?.yes) {
+                    console.error('Warning: CLAUDE.md already exists and will be overwritten.');
+                    const confirmed = await askConfirmation('Continue? (y/N) ');
+                    if (!confirmed) {
+                        console.error('Aborted.');
+                        return;
+                    }
+                }
+                if (!fs.existsSync(claudeMdBakPath)) {
+                    fs.copyFileSync(claudeMdPath, claudeMdBakPath);
+                    console.log('Backed up CLAUDE.md → CLAUDE.md.bak');
+                }
+                else {
+                    console.log('existing backup preserved at CLAUDE.md.bak');
+                }
+            }
+        }
+    }
+    else if (target === 'copilot') {
+        // Copilot safety check: only prompt when unmanaged files exist
+        if (!isManagedCopilotFiles(projectPath)) {
+            const copilotInstructionsPath = path.join(projectPath, '.github', 'copilot-instructions.md');
+            const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+            const eitherExists = fs.existsSync(copilotInstructionsPath) || fs.existsSync(agentsMdPath);
+            if (eitherExists) {
+                if (!opts?.yes) {
+                    console.error('Warning: Copilot IDE files already exist and will be overwritten.');
+                    const confirmed = await askConfirmation('Continue? (y/N) ');
+                    if (!confirmed) {
+                        console.error('Aborted.');
+                        return;
+                    }
+                }
+                // Backup each file if it exists and no .bak already present
+                for (const [src, bak] of [
+                    [copilotInstructionsPath, `${copilotInstructionsPath}.bak`],
+                    [agentsMdPath, `${agentsMdPath}.bak`],
+                ]) {
+                    if (fs.existsSync(src)) {
+                        if (!fs.existsSync(bak)) {
+                            fs.copyFileSync(src, bak);
+                            console.log(`Backed up ${path.relative(projectPath, src)} → ${path.relative(projectPath, bak)}`);
+                        }
+                        else {
+                            console.log(`existing backup preserved at ${path.relative(projectPath, bak)}`);
+                        }
+                    }
+                }
+            }
+        }
+        // Managed or no files: proceed silently
+    }
+    // Run the setup-ide script
+    try {
+        execFileSync('bash', [scriptPath, target], {
+            cwd: projectPath,
+            stdio: 'inherit',
+        });
+    }
+    catch (err) {
+        const code = err.status ?? 'unknown';
+        throw new UserError(`setup-ide exited with code ${code}. Check the output above for details.`);
+    }
+    console.error(`IDE setup complete for ${target}.`);
+}
+/**
+ * Propagate IDE-generated files from the project root to all registered worktrees.
+ *
+ * The setup-ide script always writes to the project root (its find_project_root()
+ * walks up to the nearest directory containing project-documents/, which is always
+ * the root). Worktrees share the same guides submodule source but have independent
+ * working trees, so without propagation their CLAUDE.md and .claude/ config files
+ * go stale after every root setup-ide run.
+ *
+ * Files propagated (claude target):
+ *   CLAUDE.md               — compiled from alwaysApply rules
+ *   .claude/rules/          — modular (non-alwaysApply) rule files
+ *   .claude/agents/         — agent definition files
+ *   .claude/skills/         — skill definition files
+ *
+ * Files intentionally NOT propagated:
+ *   .claude/settings.local.json  — worktree-specific user settings
+ *   .claude/worktrees/           — cf worktree registry, root-only
+ */
+function propagateToWorktrees(project, target) {
+    const worktrees = (project.worktrees ?? []).filter((wt) => wt.worktreePath && fs.existsSync(wt.worktreePath));
+    if (worktrees.length === 0)
+        return;
+    const rootPath = project.projectPath;
+    for (const wt of worktrees) {
+        const wtPath = wt.worktreePath;
+        console.log(`  → propagating to worktree: ${wt.name ?? wt.id} (${wtPath})`);
+        if (target === 'claude') {
+            // CLAUDE.md
+            const srcMd = path.join(rootPath, 'CLAUDE.md');
+            if (fs.existsSync(srcMd)) {
+                fs.copyFileSync(srcMd, path.join(wtPath, 'CLAUDE.md'));
+            }
+            // .claude/{rules,agents,skills}
+            for (const dir of ['rules', 'agents', 'skills']) {
+                const srcDir = path.join(rootPath, '.claude', dir);
+                const dstDir = path.join(wtPath, '.claude', dir);
+                if (!fs.existsSync(srcDir))
+                    continue;
+                fs.mkdirSync(dstDir, { recursive: true });
+                for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+                    if (entry.isFile()) {
+                        fs.copyFileSync(path.join(srcDir, entry.name), path.join(dstDir, entry.name));
+                    }
+                }
+            }
+        }
+        else if (target === 'copilot') {
+            // AGENTS.md
+            const srcAgents = path.join(rootPath, 'AGENTS.md');
+            if (fs.existsSync(srcAgents)) {
+                fs.copyFileSync(srcAgents, path.join(wtPath, 'AGENTS.md'));
+            }
+            // .github/copilot-instructions.md
+            const srcInstructions = path.join(rootPath, '.github', 'copilot-instructions.md');
+            if (fs.existsSync(srcInstructions)) {
+                fs.mkdirSync(path.join(wtPath, '.github'), { recursive: true });
+                fs.copyFileSync(srcInstructions, path.join(wtPath, '.github', 'copilot-instructions.md'));
+            }
+            // .github/instructions/ and .github/prompts/
+            for (const dir of ['instructions', 'prompts']) {
+                const srcDir = path.join(rootPath, '.github', dir);
+                const dstDir = path.join(wtPath, '.github', dir);
+                if (!fs.existsSync(srcDir))
+                    continue;
+                fs.mkdirSync(dstDir, { recursive: true });
+                for (const entry of fs.readdirSync(srcDir, { withFileTypes: true })) {
+                    if (entry.isFile()) {
+                        fs.copyFileSync(path.join(srcDir, entry.name), path.join(dstDir, entry.name));
+                    }
+                }
+            }
+        }
+        // Future targets (cursor, windsurf) would propagate their own dirs here.
+    }
+    console.log(`  Propagated to ${worktrees.length} worktree${worktrees.length !== 1 ? 's' : ''}.`);
+}
+export function registerSetupIdeCommand(program) {
+    const ideCmd = program
+        .command('setup-ide')
+        .description('Configure IDE-specific AI integration files for the current project')
+        .argument('<target>', 'IDE target: claude, copilot');
+    withProjectOption(ideCmd);
+    withYesOption(ideCmd);
+    ideCmd.action(async (target, opts) => {
+        try {
+            // Validate target early (before project resolution for fast failure)
+            if (!VALID_TARGETS.includes(target)) {
+                throw new UserError(`Invalid target '${target}'. Valid targets: ${VALID_TARGETS.join(', ')}`);
+            }
+            // Resolve project
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectId(opts.project, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'.`);
+            }
+            if (!project.projectPath) {
+                throw new UserError(`Project '${project.name}' has no configured project path.\n` +
+                    '  Run cf init in the project directory to set the path.');
+            }
+            await setupIdeAction(project.projectPath, target, { yes: opts.yes });
+            propagateToWorktrees(project, target);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=setup-ide.js.map

package/dist/commands/setup-ide.js.map

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

package/dist/commands/slice.d.ts

@@ -0,0 +1,6 @@
+/** Shared action handler for listing slices from the active slice plan. */
+export declare function sliceListAction(opts: {
+    json?: boolean;
+    project?: string;
+}): Promise<void>;
+//# sourceMappingURL=slice.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slice.d.ts","sourceRoot":"","sources":["../../src/commands/slice.ts"],"names":[],"mappings":"AAWA,2EAA2E;AAC3E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4G/F"}

package/dist/commands/slice.js

@@ -0,0 +1,100 @@
+import { join } from 'node:path';
+import { FileProjectStore, ArtifactIntrospector, resolveArtifactPath } from '@context-forge/core/node';
+import { extractSliceIndex } from '@context-forge/core/node';
+import { resolveProjectWorktree } from '../utils/project.js';
+import { resolveProject } from '@context-forge/core';
+import { resolveOperationPath, getWorktreeIndexRange, isInIndexRange } from '../utils/worktree-overlay.js';
+import { UserError } from '../utils/errors.js';
+import { printJson } from '../output/formatter.js';
+import { renderTable } from '../output/tables.js';
+import { label, success, dim } from '../output/styles.js';
+/** Shared action handler for listing slices from the active slice plan. */
+export async function sliceListAction(opts) {
+    const store = new FileProjectStore();
+    const { id, worktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+    const rawProject = await store.getById(id);
+    if (!rawProject) {
+        throw new UserError(`Project not found: '${id}'.`);
+    }
+    const project = await resolveProject(store, id, worktreeId);
+    if (!project) {
+        throw new UserError(`Project not found: '${id}'.`);
+    }
+    if (!project.fileSlicePlan) {
+        throw new UserError('No slice plan configured. Set one with: cf set slicePlan <path>');
+    }
+    if (!project.projectPath) {
+        throw new UserError('No projectPath configured. Set one with: cf set projectPath /path/to/project');
+    }
+    const operationPath = resolveOperationPath(project, worktreeId) ?? project.projectPath;
+    const indexRange = getWorktreeIndexRange(rawProject, worktreeId);
+    const planRelPath = resolveArtifactPath('fileSlicePlan', project.fileSlicePlan);
+    if (!planRelPath) {
+        throw new UserError('Could not resolve slice plan path.');
+    }
+    const planPath = join(operationPath, planRelPath);
+    const introspector = new ArtifactIntrospector();
+    const planResult = await introspector.parseSlicePlan(planPath);
+    // Determine active slice index
+    const activeIndex = extractSliceIndex(project.fileSlice);
+    // Filter entries by worktree index range — but skip filtering when the plan itself
+    // is outside the range (user explicitly switched to a different initiative)
+    const planBaseIndex = /^(\d+)-/.exec(project.fileSlicePlan ?? '')?.[1];
+    const planOutsideRange = planBaseIndex && indexRange && !isInIndexRange(parseInt(planBaseIndex, 10), indexRange);
+    const filteredEntries = planOutsideRange
+        ? planResult.entries
+        : planResult.entries.filter((e) => isInIndexRange(e.index, indexRange));
+    // Check for design files per entry
+    const entries = await Promise.all(filteredEntries.map(async (entry) => {
+        let designFile = null;
+        try {
+            const docs = await introspector.detectDocuments(operationPath, entry.index);
+            designFile = docs.sliceDesign;
+        }
+        catch {
+            // skip
+        }
+        const isActive = activeIndex !== null && entry.index === activeIndex;
+        const isNext = !isActive && !entry.isChecked && activeIndex === null;
+        return { ...entry, designFile, isActive, isNext };
+    }));
+    // Mark first unchecked as next if no active match
+    if (!entries.some((e) => e.isActive)) {
+        const firstUnchecked = entries.find((e) => !e.isChecked);
+        if (firstUnchecked) {
+            firstUnchecked.isNext = true;
+        }
+    }
+    if (opts.json) {
+        const planName = project.fileSlicePlan.split('/').pop() ?? project.fileSlicePlan;
+        printJson({
+            slicePlan: planName,
+            total: planResult.totalSlices,
+            completed: planResult.completedSlices,
+            entries: entries.map((e) => ({
+                index: e.index,
+                name: e.name,
+                isChecked: e.isChecked,
+                designFile: e.designFile,
+                isActive: e.isActive,
+                isNext: e.isNext,
+            })),
+        });
+        return;
+    }
+    // Render table
+    const planName = project.fileSlicePlan.split('/').pop() ?? project.fileSlicePlan;
+    console.log(label(`\nSlice Plan: ${planName}`));
+    const rows = entries.map((e) => {
+        const status = e.isChecked
+            ? success('✓ complete')
+            : dim('○ not started');
+        const file = e.designFile
+            ? dim(e.designFile.split('/').pop() ?? e.designFile)
+            : dim('—');
+        const indicator = e.isActive ? success(' ← active') : e.isNext ? dim(' ← next') : '';
+        return [String(e.index), e.name, status, file + indicator];
+    });
+    console.log(renderTable(['#', 'Slice', 'Status', 'File'], rows));
+}
+//# sourceMappingURL=slice.js.map

package/dist/commands/slice.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuK5D"}