@elyracode/coding-agent 0.6.0 → 0.6.2

package/dist/modes/interactive/interactive-mode.js

@@ -14,6 +14,7 @@ import { parseSkillBlock } from "../../core/agent-session.js";
 import { SessionImportFileNotFoundError } from "../../core/agent-session-runtime.js";
 import { FooterDataProvider } from "../../core/footer-data-provider.js";
 import { KeybindingsManager } from "../../core/keybindings.js";
+import { getMemoryPath, loadMemory } from "../../core/memory.js";
 import { createCompactionSummaryMessage } from "../../core/messages.js";
 import { defaultModelPerProvider, findExactModelReferenceMatch, resolveModelScope } from "../../core/model-resolver.js";
 import { DefaultPackageManager } from "../../core/package-manager.js";
@@ -447,7 +448,7 @@ export class InteractiveMode {
                 hint("app.tools.expand", "more"),
             ].join(theme.fg("muted", " · "));
             const compactOnboarding = theme.fg("dim", `Press ${keyText("app.tools.expand")} to show full startup help and loaded resources.`);
-            const onboarding = theme.fg("dim", `Elyra can explain its own features and look up its docs. Ask it how to use or extend Elyra.`);
+            const onboarding = theme.fg("dim", `Docs and guides at elyracode.com. Type / for commands, /ext for extensions.`);
             this.builtInHeader = new ExpandableText(() => `${logo}\n${compactInstructions}\n${compactOnboarding}\n\n${onboarding}`, () => `${logo}\n${expandedInstructions}\n\n${onboarding}`, this.getStartupExpansionState(), 1, 0);
             // Setup UI layout
             this.headerContainer.addChild(new Spacer(1));
@@ -459,6 +460,21 @@ export class InteractiveMode {
             this.builtInHeader = new Text("", 0, 0);
             this.headerContainer.addChild(this.builtInHeader);
         }
+        // Show first-run help for new projects
+        if (!this.settingsManager.getQuietStartup() &&
+            !fs.existsSync(path.join(this.sessionManager.getCwd(), ".elyra"))) {
+            const examples = [
+                theme.fg("dim", "Try one of these to get started:"),
+                "",
+                theme.fg("muted", "  Summarize this codebase and explain the architecture"),
+                theme.fg("muted", "  Find and fix bugs in src/auth/"),
+                theme.fg("muted", "  Add tests for the user registration flow"),
+                theme.fg("muted", "  Review the payment module for security issues"),
+                "",
+                theme.fg("dim", "Type / for commands, /ext for extensions. Docs at elyracode.com"),
+            ].join("\n");
+            this.chatContainer.addChild(new Text(examples, 1, 0));
+        }
         this.ui.addChild(this.chatContainer);
         this.ui.addChild(this.pendingMessagesContainer);
         this.ui.addChild(this.statusContainer);
@@ -1943,6 +1959,16 @@ export class InteractiveMode {
             if (!text)
                 return;
             // Handle commands
+            if (text === "/help") {
+                this.editor.setText("");
+                this.handleHelpCommand();
+                return;
+            }
+            if (text === "/init") {
+                this.editor.setText("");
+                await this.handleInitCommand();
+                return;
+            }
             if (text === "/settings") {
                 this.showSettingsSelector();
                 this.editor.setText("");
@@ -1973,6 +1999,11 @@ export class InteractiveMode {
                 this.handlePinsCommand();
                 return;
             }
+            if (text === "/memory" || text.startsWith("/memory ")) {
+                this.editor.setText("");
+                this.handleMemoryCommand(text.startsWith("/memory ") ? text.slice(8).trim() : undefined);
+                return;
+            }
             if (text === "/blueprint" || text.startsWith("/blueprint ")) {
                 this.editor.setText("");
                 this.handleBlueprintCommand(text.startsWith("/blueprint ") ? text.slice(11).trim() : undefined);
@@ -3296,6 +3327,93 @@ export class InteractiveMode {
             return { component: selector, focus: selector.getSettingsList() };
         });
     }
+    async handleInitCommand() {
+        const cwd = this.sessionManager.getCwd();
+        const elyraDir = path.join(cwd, ".elyra");
+        if (fs.existsSync(elyraDir)) {
+            this.showStatus(".elyra/ already exists in this project");
+            return;
+        }
+        // Detect stack
+        const stackResult = detectStack(cwd);
+        // Create .elyra/ directory
+        fs.mkdirSync(elyraDir, { recursive: true });
+        // Create AGENTS.md with project context
+        const agentsLines = [
+            "# Project Rules",
+            "",
+            "## Overview",
+            "",
+            "<!-- Describe your project here. The agent reads this on every session. -->",
+            "",
+        ];
+        if (stackResult.summary) {
+            agentsLines.push(`## Stack`, "", stackResult.summary, "");
+        }
+        agentsLines.push("## Conventions", "", "<!-- Add coding conventions, patterns, and preferences here. -->", "");
+        fs.writeFileSync(path.join(elyraDir, "AGENTS.md"), agentsLines.join("\n"), "utf-8");
+        // Create blueprints directory
+        fs.mkdirSync(path.join(elyraDir, "blueprints"), { recursive: true });
+        // Build status message
+        const parts = [];
+        parts.push(theme.bold("Project initialized"));
+        parts.push("");
+        parts.push(`  ${theme.fg("success", "Created")} .elyra/AGENTS.md`);
+        parts.push(`  ${theme.fg("success", "Created")} .elyra/blueprints/`);
+        // Suggest extensions based on detected stack
+        if (stackResult.stack) {
+            const pkg = getSuggestedPackage(stackResult.stack);
+            parts.push("");
+            parts.push(`  ${theme.fg("accent", "Detected:")} ${stackResult.stack} stack`);
+            parts.push(`  ${theme.fg("dim", "Install:")} elyra install npm:${pkg}`);
+        }
+        if (stackResult.frameworks.some((f) => f.name === "Filament")) {
+            parts.push(`  ${theme.fg("dim", "Install:")} elyra install npm:@elyracode/stack-filament`);
+        }
+        if (stackResult.frameworks.some((f) => f.name === "Laravel AI SDK")) {
+            parts.push(`  ${theme.fg("dim", "Install:")} elyra install npm:@elyracode/stack-laravel-ai`);
+        }
+        // Check for Docker
+        if (fs.existsSync(path.join(cwd, "docker-compose.yml")) || fs.existsSync(path.join(cwd, "compose.yml"))) {
+            parts.push(`  ${theme.fg("dim", "Install:")} elyra install npm:@elyracode/docker`);
+        }
+        // Always suggest useful general extensions
+        parts.push("");
+        parts.push(theme.fg("dim", "Edit .elyra/AGENTS.md to add project rules and conventions."));
+        parts.push(theme.fg("dim", "Browse all extensions with /ext."));
+        this.chatContainer.addChild(new Spacer(1));
+        this.chatContainer.addChild(new Text(parts.join("\n"), 1, 0));
+        this.ui.requestRender();
+    }
+    handleHelpCommand() {
+        const help = [
+            theme.bold("Elyra"),
+            "",
+            theme.fg("accent", "Example prompts:"),
+            "  Summarize this codebase and explain the architecture",
+            "  Add a REST API for user profiles with validation and tests",
+            "  Find and fix the bug in the checkout flow",
+            "  Refactor the notification system to use events",
+            "  Review src/auth/ for security issues",
+            "",
+            theme.fg("accent", "Useful commands:"),
+            `  ${theme.fg("muted", "/model")}       Switch model`,
+            `  ${theme.fg("muted", "/theme")}       Switch theme`,
+            `  ${theme.fg("muted", "/cost")}        Token usage and cost`,
+            `  ${theme.fg("muted", "/diff")}        Show uncommitted changes`,
+            `  ${theme.fg("muted", "/pin <path>")}  Pin file to context`,
+            `  ${theme.fg("muted", "/memory")}      View project memory`,
+            `  ${theme.fg("muted", "/blueprint")}   Apply session template`,
+            `  ${theme.fg("muted", "/ext")}         Browse extensions`,
+            `  ${theme.fg("muted", "/settings")}    Full settings menu`,
+            `  ${theme.fg("muted", "/hotkeys")}     Keyboard shortcuts`,
+            "",
+            theme.fg("dim", "Docs and guides at elyracode.com"),
+        ].join("\n");
+        this.chatContainer.addChild(new Spacer(1));
+        this.chatContainer.addChild(new Text(help, 1, 0));
+        this.ui.requestRender();
+    }
     handleCostCommand() {
         const stats = this.session.getSessionStats();
         const fmt = (n) => n.toLocaleString();
@@ -3382,6 +3500,37 @@ export class InteractiveMode {
         this.chatContainer.addChild(new Text(info, 1, 0));
         this.ui.requestRender();
     }
+    handleMemoryCommand(subcommand) {
+        const cwd = this.sessionManager.getCwd();
+        if (subcommand === "clear") {
+            const memoryPath = getMemoryPath(cwd);
+            if (fs.existsSync(memoryPath)) {
+                fs.unlinkSync(memoryPath);
+                this.showStatus("Memory cleared for this project");
+            }
+            else {
+                this.showStatus("No memory to clear");
+            }
+            return;
+        }
+        if (subcommand === "path") {
+            const memoryPath = getMemoryPath(cwd);
+            this.showStatus(memoryPath);
+            return;
+        }
+        const memory = loadMemory(cwd);
+        if (!memory) {
+            this.showStatus("No project memory yet. Memory is generated automatically after sessions.");
+            return;
+        }
+        this.chatContainer.addChild(new Spacer(1));
+        this.chatContainer.addChild(new DynamicBorder());
+        this.chatContainer.addChild(new Text(theme.bold(theme.fg("accent", "Project Memory")), 1, 0));
+        this.chatContainer.addChild(new Spacer(1));
+        this.chatContainer.addChild(new Markdown(memory, 1, 1, this.getMarkdownThemeWithSettings()));
+        this.chatContainer.addChild(new DynamicBorder());
+        this.ui.requestRender();
+    }
     handleBlueprintCommand(name) {
         const cwd = this.sessionManager.getCwd();
         const dirs = [getProjectBlueprintsDir(cwd), getBlueprintsDir()];