project-iris 0.0.1

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/types/messages.ts

@@ -0,0 +1,40 @@
+/**
+ * Message type re-exports for webview code.
+ *
+ * These types are defined in the extension code (sidebar/webviewMessaging.ts)
+ * and re-exported here for use in webview components.
+ */
+
+// Note: We can't directly import from extension code in webview
+// because of different build targets (Node vs Browser).
+// Instead, we define compatible types here.
+
+import type { BoltsViewData } from '../components/bolts/bolts-view.js';
+import type { ActivityFilter } from '../components/bolts/activity-feed.js';
+
+/**
+ * Tab identifiers.
+ */
+export type TabId = 'bolts' | 'specs' | 'overview';
+
+/**
+ * Messages from webview to extension.
+ */
+export type WebviewToExtensionMessage =
+    | { type: 'ready' }
+    | { type: 'tabChange'; tab: TabId }
+    | { type: 'openArtifact'; kind: string; path: string }
+    | { type: 'refresh' }
+    | { type: 'toggleFocus'; expanded: boolean }
+    | { type: 'activityFilter'; filter: ActivityFilter }
+    | { type: 'activityResize'; height: number }
+    | { type: 'startBolt'; boltId: string }
+    | { type: 'openExternal'; url: string };
+
+/**
+ * Messages from extension to webview.
+ */
+export type ExtensionToWebviewMessage =
+    | { type: 'setData'; activeTab: TabId; boltsData: BoltsViewData; specsHtml: string; overviewHtml: string }
+    | { type: 'setBoltsData'; boltsData: BoltsViewData }
+    | { type: 'setTab'; activeTab: TabId };

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/types/vscode.ts

@@ -0,0 +1,13 @@
+/**
+ * VS Code Webview API type declarations.
+ */
+
+export interface VsCodeApi {
+    postMessage(message: unknown): void;
+    getState(): unknown;
+    setState(state: unknown): void;
+}
+
+declare global {
+    function acquireVsCodeApi(): VsCodeApi;
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/utils/messaging.ts

@@ -0,0 +1,57 @@
+/**
+ * Type-safe messaging utilities for webview.
+ *
+ * Provides compile-time validation for messages sent to the extension.
+ */
+
+import type { WebviewToExtensionMessage, ExtensionToWebviewMessage } from '../types/messages.js';
+import { vscode } from '../vscode-api.js';
+
+/**
+ * Send a type-safe message to the extension.
+ *
+ * @example
+ * ```typescript
+ * sendMessage({ type: 'tabChange', tab: 'bolts' });
+ * sendMessage({ type: 'startBolt', boltId: 'my-bolt' });
+ * ```
+ */
+export function sendMessage(message: WebviewToExtensionMessage): void {
+    vscode.postMessage(message);
+}
+
+/**
+ * Subscribe to messages from the extension.
+ *
+ * @returns Cleanup function to unsubscribe
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = onMessage((msg) => {
+ *     if (msg.type === 'setData') {
+ *         // TypeScript knows msg has activeTab, boltsData, etc.
+ *     }
+ * });
+ * ```
+ */
+export function onMessage(
+    handler: (message: ExtensionToWebviewMessage) => void
+): () => void {
+    const listener = (event: MessageEvent<ExtensionToWebviewMessage>) => {
+        handler(event.data);
+    };
+    window.addEventListener('message', listener);
+    return () => window.removeEventListener('message', listener);
+}
+
+/**
+ * Type guard for extension messages.
+ */
+export function isExtensionMessage(data: unknown): data is ExtensionToWebviewMessage {
+    return (
+        typeof data === 'object' &&
+        data !== null &&
+        'type' in data &&
+        typeof (data as { type: unknown }).type === 'string'
+    );
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/utils.ts

@@ -0,0 +1,16 @@
+/**
+ * Utility functions for webview content.
+ * These functions don't depend on VS Code API so can be tested independently.
+ */
+
+/**
+ * Generates a nonce for CSP.
+ */
+export function getNonce(): string {
+    let text = '';
+    const possible = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    for (let i = 0; i < 32; i++) {
+        text += possible.charAt(Math.floor(Math.random() * possible.length));
+    }
+    return text;
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/webview/vscode-api.ts

@@ -0,0 +1,14 @@
+/**
+ * VS Code API instance for webview.
+ *
+ * This module acquires the VS Code API and exports it for use by components.
+ * IMPORTANT: This must only be imported by code running in the webview context.
+ */
+
+import type { VsCodeApi } from './types/vscode.js';
+
+/**
+ * The VS Code API instance.
+ * Acquired once when this module loads.
+ */
+export const vscode: VsCodeApi = acquireVsCodeApi();

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/WelcomeViewProvider.ts

@@ -0,0 +1,254 @@
+import * as vscode from 'vscode';
+import { handleInstallCommand } from './installHandler';
+
+/**
+ * Provides the welcome view webview for non-irismd workspaces.
+ * Shows a branded onboarding experience with installation instructions.
+ */
+export class WelcomeViewProvider implements vscode.WebviewViewProvider {
+    public static readonly viewType = 'irismdWelcome';
+
+    private _view?: vscode.WebviewView;
+
+    constructor(private readonly _extensionUri: vscode.Uri) {}
+
+    public resolveWebviewView(
+        webviewView: vscode.WebviewView,
+        _context: vscode.WebviewViewResolveContext,
+        _token: vscode.CancellationToken
+    ): void {
+        this._view = webviewView;
+
+        webviewView.webview.options = {
+            enableScripts: true,
+            localResourceRoots: [
+                vscode.Uri.joinPath(this._extensionUri, 'resources')
+            ]
+        };
+
+        webviewView.webview.html = this._getHtmlContent(webviewView.webview);
+
+        // Handle messages from the webview
+        webviewView.webview.onDidReceiveMessage(async (message) => {
+            switch (message.command) {
+                case 'openWebsite':
+                    vscode.env.openExternal(vscode.Uri.parse('https://iris.md'));
+                    break;
+                case 'copyCommand':
+                    await vscode.env.clipboard.writeText('npx irismd@latest install');
+                    vscode.window.showInformationMessage('Command copied to clipboard!');
+                    break;
+                case 'install':
+                    await handleInstallCommand();
+                    break;
+            }
+        });
+    }
+
+    private _getHtmlContent(webview: vscode.Webview): string {
+        const logoUri = webview.asWebviewUri(
+            vscode.Uri.joinPath(this._extensionUri, 'resources', 'logo.png')
+        );
+
+        const nonce = getNonce();
+
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src ${webview.cspSource}; style-src 'unsafe-inline'; script-src 'nonce-${nonce}';">
+    <title>Welcome to irismd</title>
+    <style>
+        body {
+            padding: 16px;
+            font-family: var(--vscode-font-family);
+            font-size: var(--vscode-font-size);
+            color: var(--vscode-foreground);
+            background: transparent;
+        }
+
+        .logo-container {
+            text-align: center;
+            margin-bottom: 24px;
+            cursor: pointer;
+        }
+
+        .logo {
+            max-width: 120px;
+            height: auto;
+            image-rendering: pixelated;
+        }
+
+        .logo:hover {
+            opacity: 0.8;
+        }
+
+        h2 {
+            font-size: 14px;
+            font-weight: 600;
+            margin: 0 0 12px 0;
+            color: var(--vscode-foreground);
+        }
+
+        p {
+            margin: 0 0 16px 0;
+            line-height: 1.5;
+            color: var(--vscode-descriptionForeground);
+        }
+
+        .command-box {
+            display: flex;
+            align-items: center;
+            background: var(--vscode-input-background);
+            border: 1px solid var(--vscode-input-border);
+            border-radius: 4px;
+            padding: 8px 12px;
+            margin-bottom: 16px;
+        }
+
+        .command-text {
+            flex: 1;
+            font-family: var(--vscode-editor-font-family);
+            font-size: 12px;
+            color: var(--vscode-input-foreground);
+            user-select: all;
+        }
+
+        .copy-button {
+            background: transparent;
+            border: none;
+            cursor: pointer;
+            padding: 4px;
+            color: var(--vscode-foreground);
+            opacity: 0.7;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+
+        .copy-button:hover {
+            opacity: 1;
+        }
+
+        .copy-button svg {
+            width: 16px;
+            height: 16px;
+            fill: currentColor;
+        }
+
+        .install-button {
+            width: 100%;
+            padding: 10px 16px;
+            background: var(--vscode-button-background);
+            color: var(--vscode-button-foreground);
+            border: none;
+            border-radius: 4px;
+            font-size: 13px;
+            font-weight: 500;
+            cursor: pointer;
+            transition: background 0.1s;
+        }
+
+        .install-button:hover {
+            background: var(--vscode-button-hoverBackground);
+        }
+
+        .install-button:focus {
+            outline: 1px solid var(--vscode-focusBorder);
+            outline-offset: 2px;
+        }
+
+        .divider {
+            height: 1px;
+            background: var(--vscode-panel-border);
+            margin: 16px 0;
+        }
+
+        .footer {
+            text-align: center;
+            font-size: 11px;
+            color: var(--vscode-descriptionForeground);
+        }
+
+        .footer a {
+            color: var(--vscode-textLink-foreground);
+            text-decoration: none;
+        }
+
+        .footer a:hover {
+            text-decoration: underline;
+        }
+    </style>
+</head>
+<body>
+    <div class="logo-container" title="Visit iris.md">
+        <img src="${logoUri}" alt="irismd logo" class="logo" />
+    </div>
+
+    <h2>Welcome to irismd</h2>
+
+    <p>
+        AI-native software development with multi-agent orchestration.
+        Capture requirements, build iteratively, and deploy with confidence.
+    </p>
+
+    <p>Get started by running:</p>
+
+    <div class="command-box">
+        <code class="command-text">npx irismd@latest install</code>
+        <button class="copy-button" title="Copy to clipboard" aria-label="Copy command">
+            <svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg">
+                <path d="M4 2a2 2 0 0 1 2-2h6a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V2zm2-1a1 1 0 0 0-1 1v8a1 1 0 0 0 1 1h6a1 1 0 0 0 1-1V2a1 1 0 0 0-1-1H6zM2 5a1 1 0 0 0-1 1v8a1 1 0 0 0 1 1h6a1 1 0 0 0 1-1v-1h1v1a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h1v1H2z"/>
+            </svg>
+        </button>
+    </div>
+
+    <button class="install-button">
+        Install irismd
+    </button>
+
+    <div class="divider"></div>
+
+    <div class="footer">
+        <a href="#" id="learnMoreLink">Learn more at iris.md</a>
+    </div>
+
+    <script nonce="${nonce}">
+        const vscode = acquireVsCodeApi();
+
+        function openWebsite(e) {
+            if (e) e.preventDefault();
+            vscode.postMessage({ command: 'openWebsite' });
+        }
+
+        function copyCommand() {
+            vscode.postMessage({ command: 'copyCommand' });
+        }
+
+        function install() {
+            vscode.postMessage({ command: 'install' });
+        }
+
+        // Set up event listeners after DOM is ready
+        document.getElementById('learnMoreLink').addEventListener('click', openWebsite);
+        document.querySelector('.logo-container').addEventListener('click', openWebsite);
+        document.querySelector('.copy-button').addEventListener('click', copyCommand);
+        document.querySelector('.install-button').addEventListener('click', install);
+    </script>
+</body>
+</html>`;
+    }
+}
+
+/**
+ * Generate a nonce for Content Security Policy
+ */
+function getNonce(): string {
+    let text = '';
+    const possible = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    for (let i = 0; i < 32; i++) {
+        text += possible.charAt(Math.floor(Math.random() * possible.length));
+    }
+    return text;
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Welcome view module for irismd VS Code extension.
+ *
+ * Provides an onboarding experience for non-irismd workspaces,
+ * including installation flow and post-installation detection.
+ */
+
+export { WelcomeViewProvider } from './WelcomeViewProvider';
+export { handleInstallCommand, createInstallationWatcher } from './installHandler';

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/welcome/installHandler.ts

@@ -0,0 +1,82 @@
+import * as vscode from 'vscode';
+
+/**
+ * The installation command to paste into the terminal
+ */
+const INSTALL_COMMAND = 'npx irismd@latest install';
+
+/**
+ * Handle the install button click from the welcome view.
+ * Shows a confirmation dialog and opens a terminal with the install command.
+ */
+export async function handleInstallCommand(): Promise<void> {
+    // Check if there's a workspace folder open
+    if (!vscode.workspace.workspaceFolders || vscode.workspace.workspaceFolders.length === 0) {
+        vscode.window.showErrorMessage(
+            'Please open a folder first before installing irismd.'
+        );
+        return;
+    }
+
+    // Show confirmation dialog
+    const confirm = await vscode.window.showInformationMessage(
+        'This will open a terminal with the irismd install command. ' +
+        'Press Enter in the terminal to run the installation.',
+        { modal: true },
+        'Open Terminal'
+    );
+
+    if (confirm !== 'Open Terminal') {
+        return; // User cancelled
+    }
+
+    // Create a new terminal
+    const terminal = vscode.window.createTerminal({
+        name: 'irismd install',
+        cwd: vscode.workspace.workspaceFolders[0].uri.fsPath
+    });
+
+    // Show the terminal
+    terminal.show();
+
+    // Wait for terminal to be ready (zsh needs time to initialize)
+    await new Promise(resolve => setTimeout(resolve, 1000));
+
+    // Send the command without executing (false = don't add newline)
+    terminal.sendText(INSTALL_COMMAND, false);
+}
+
+/**
+ * Set up watchers for post-installation detection.
+ * Updates the irismd.isProject context when project folders are detected.
+ */
+export function createInstallationWatcher(
+    onProjectDetected: () => void
+): vscode.Disposable {
+    if (!vscode.workspace.workspaceFolders || vscode.workspace.workspaceFolders.length === 0) {
+        return { dispose: () => {} };
+    }
+
+    const rootPath = vscode.workspace.workspaceFolders[0].uri.fsPath;
+
+    // Watch for memory-bank and .irismd folder creation
+    const watcher = vscode.workspace.createFileSystemWatcher(
+        new vscode.RelativePattern(rootPath, '{memory-bank,.irismd}/**'),
+        false, // Don't ignore creates
+        true,  // Ignore changes
+        true   // Ignore deletes
+    );
+
+    let detected = false;
+
+    const checkAndNotify = () => {
+        if (!detected) {
+            detected = true;
+            onProjectDetected();
+        }
+    };
+
+    watcher.onDidCreate(checkAndNotify);
+
+    return watcher;
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.json

@@ -0,0 +1,30 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "ES2022",
+        "lib": ["ES2022"],
+        "outDir": "out",
+        "rootDir": "src",
+        "sourceMap": true,
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "declaration": true,
+        "declarationMap": true,
+        "moduleResolution": "node",
+        "resolveJsonModule": true
+    },
+    "include": ["src/**/*"],
+    "exclude": [
+        "node_modules",
+        "out",
+        "test",
+        "src/webview/components/**/*",
+        "src/webview/styles/**/*",
+        "src/webview/types/**/*",
+        "src/webview/utils/**/*",
+        "src/webview/lit/**/*",
+        "src/webview/vscode-api.ts"
+    ]
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.test.json

@@ -0,0 +1,26 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "ES2022",
+        "lib": ["ES2022"],
+        "outDir": "out-test",
+        "rootDir": "src",
+        "sourceMap": true,
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "moduleResolution": "node",
+        "resolveJsonModule": true
+    },
+    "include": ["src/**/*"],
+    "exclude": [
+        "node_modules",
+        "src/webview/components/**/*",
+        "src/webview/styles/**/*",
+        "src/webview/types/**/*",
+        "src/webview/utils/**/*",
+        "src/webview/lit/**/*",
+        "src/webview/vscode-api.ts"
+    ]
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/tsconfig.webview.json

@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "ESNext",
+        "lib": ["ES2020", "DOM"],
+        "moduleResolution": "bundler",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "experimentalDecorators": true,
+        "useDefineForClassFields": false,
+        "noEmit": true
+    },
+    "include": [
+        "src/webview/components/**/*",
+        "src/webview/styles/**/*",
+        "src/webview/types/**/*",
+        "src/webview/utils/**/*",
+        "src/webview/lit/**/*",
+        "src/webview/vscode-api.ts"
+    ]
+}