project-iris 0.0.1

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

@@ -0,0 +1,116 @@
+{
+    "name": "irismd",
+    "displayName": "irismd - Memory Bank Extension - Spec Driven Development",
+    "description": "Dashboard sidebar for browsing AI-DLC memory-bank artifacts",
+    "version": "0.0.7",
+    "publisher": "fabriqaai",
+    "icon": "resources/favicon.png",
+    "homepage": "https://iris.md",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/fabriqaai/iris.md.git"
+    },
+    "license": "MIT",
+    "engines": {
+        "vscode": "^1.85.0"
+    },
+    "categories": [
+        "Other"
+    ],
+    "activationEvents": [
+        "workspaceContains:**/memory-bank",
+        "workspaceContains:**/.irismd"
+    ],
+    "main": "./out/extension.js",
+    "contributes": {
+        "viewsContainers": {
+            "activitybar": [
+                {
+                    "id": "irismd",
+                    "title": "irismd",
+                    "icon": "resources/extension_icon.svg"
+                }
+            ]
+        },
+        "views": {
+            "irismd": [
+                {
+                    "id": "irismdExplorer",
+                    "name": "Explorer",
+                    "when": "irismd.isProject",
+                    "type": "webview"
+                },
+                {
+                    "id": "irismdWelcome",
+                    "name": "Welcome",
+                    "when": "!irismd.isProject",
+                    "type": "webview"
+                }
+            ]
+        },
+        "commands": [
+            {
+                "command": "irismd.refresh",
+                "title": "Refresh",
+                "icon": "$(refresh)"
+            },
+            {
+                "command": "irismd.openFile",
+                "title": "Open File"
+            },
+            {
+                "command": "irismd.revealInExplorer",
+                "title": "Reveal in Explorer"
+            },
+            {
+                "command": "irismd.copyPath",
+                "title": "Copy Path"
+            }
+        ],
+        "menus": {
+            "view/title": [
+                {
+                    "command": "irismd.refresh",
+                    "when": "view == irismdExplorer",
+                    "group": "navigation"
+                }
+            ]
+        }
+    },
+    "scripts": {
+        "vscode:prepublish": "npm run compile -- --production",
+        "compile": "tsc -p ./ && tsc -p ./tsconfig.webview.json && node esbuild.webview.mjs",
+        "compile:ext": "tsc -p ./",
+        "compile:webview": "tsc -p ./tsconfig.webview.json && node esbuild.webview.mjs",
+        "typecheck:webview": "tsc -p ./tsconfig.webview.json",
+        "watch": "tsc -watch -p ./",
+        "watch:webview": "node esbuild.webview.mjs --watch",
+        "pretest": "npm run compile && npm run compile:test",
+        "compile:test": "tsc -p ./tsconfig.test.json",
+        "test": "mocha ./out-test/**/*.test.js",
+        "test:vscode": "node ./out/test/runTest.js",
+        "lint": "eslint src",
+        "package": "vsce package"
+    },
+    "devDependencies": {
+        "@types/eslint": "^9.6.1",
+        "@types/glob": "^8.1.0",
+        "@types/js-yaml": "^4.0.9",
+        "@types/mocha": "^10.0.6",
+        "@types/node": "^20.10.0",
+        "@types/vscode": "^1.85.0",
+        "@vscode/test-electron": "^2.3.8",
+        "@vscode/vsce": "^2.22.0",
+        "esbuild": "^0.24.0",
+        "eslint": "^9.39.2",
+        "glob": "^10.3.10",
+        "mocha": "^10.2.0",
+        "typescript": "^5.3.2",
+        "typescript-eslint": "^8.50.1"
+    },
+    "dependencies": {
+        "@lit/context": "^1.1.6",
+        "js-yaml": "^4.1.0",
+        "lit": "^3.3.2"
+    }
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/extension_icon.svg

@@ -0,0 +1,40 @@
+<svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Pixel art S from specs.md logo -->
+  <g stroke="#3D2F2F" stroke-width="0.5">
+    <!-- Top row -->
+    <rect x="8" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="12" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="16" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="20" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="24" y="2" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Second row -->
+    <rect x="4" y="6" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="8" y="6" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Third row (left side) -->
+    <rect x="4" y="10" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="8" y="10" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Middle row -->
+    <rect x="8" y="14" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="12" y="14" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="16" y="14" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="20" y="14" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Fifth row (right side) -->
+    <rect x="20" y="18" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="24" y="18" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Sixth row (right side) -->
+    <rect x="20" y="22" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="24" y="22" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Bottom row -->
+    <rect x="4" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="8" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="12" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="16" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="20" y="26" width="4" height="4" fill="#CD6B4D"/>
+  </g>
+</svg>

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/resources/favicon.svg

@@ -0,0 +1,40 @@
+<svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- Pixel art S from specs.md logo -->
+  <g stroke="#3D2F2F" stroke-width="0.5">
+    <!-- Top row -->
+    <rect x="8" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="12" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="16" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="20" y="2" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="24" y="2" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Second row -->
+    <rect x="4" y="6" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="8" y="6" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Third row (left side) -->
+    <rect x="4" y="10" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="8" y="10" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Middle row -->
+    <rect x="8" y="14" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="12" y="14" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="16" y="14" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="20" y="14" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Fifth row (right side) -->
+    <rect x="20" y="18" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="24" y="18" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Sixth row (right side) -->
+    <rect x="20" y="22" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="24" y="22" width="4" height="4" fill="#CD6B4D"/>
+
+    <!-- Bottom row -->
+    <rect x="4" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="8" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="12" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="16" y="26" width="4" height="4" fill="#CD6B4D"/>
+    <rect x="20" y="26" width="4" height="4" fill="#CD6B4D"/>
+  </g>
+</svg>

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

@@ -0,0 +1,142 @@
+/**
+ * irismd VS Code Extension
+ *
+ * Entry point for the irismd extension that provides a dashboard sidebar
+ * for browsing AI-DLC memory-bank artifacts.
+ */
+
+import * as vscode from 'vscode';
+import { scanMemoryBank } from './parser/artifactParser';
+import { SpecsmdWebviewProvider, createWebviewProvider } from './sidebar/webviewProvider';
+import { FileWatcher } from './watcher';
+import { WelcomeViewProvider, createInstallationWatcher } from './welcome';
+
+let webviewProvider: SpecsmdWebviewProvider | undefined;
+let fileWatcher: FileWatcher | undefined;
+let installationWatcher: vscode.Disposable | undefined;
+
+/**
+ * Extension activation.
+ * Called when the extension is first activated.
+ */
+export async function activate(context: vscode.ExtensionContext): Promise<void> {
+    const workspacePath = getWorkspacePath();
+
+    // Set initial project context
+    await updateProjectContext(workspacePath);
+
+    // Create and register webview provider
+    webviewProvider = createWebviewProvider(context, workspacePath);
+
+    // Register welcome view provider
+    const welcomeProvider = new WelcomeViewProvider(context.extensionUri);
+    context.subscriptions.push(
+        vscode.window.registerWebviewViewProvider(
+            WelcomeViewProvider.viewType,
+            welcomeProvider
+        )
+    );
+
+    // Initial data load
+    await webviewProvider.refresh();
+
+    // Set up file watcher for auto-refresh
+    if (workspacePath) {
+        fileWatcher = new FileWatcher(workspacePath, async () => {
+            await webviewProvider?.refresh();
+            await updateProjectContext(workspacePath);
+        });
+        fileWatcher.start();
+        context.subscriptions.push(fileWatcher);
+    }
+
+    // Set up installation watcher for non-irismd workspaces
+    installationWatcher = createInstallationWatcher(async () => {
+        await webviewProvider?.refresh();
+        await updateProjectContext(workspacePath);
+    });
+    context.subscriptions.push(installationWatcher);
+
+    // Register commands
+    registerCommands(context);
+
+    console.log('irismd extension activated');
+}
+
+/**
+ * Extension deactivation.
+ * Called when the extension is deactivated.
+ */
+export function deactivate(): void {
+    // Resources are cleaned up via context.subscriptions
+    webviewProvider?.dispose();
+    webviewProvider = undefined;
+    fileWatcher = undefined;
+    installationWatcher = undefined;
+    console.log('irismd extension deactivated');
+}
+
+/**
+ * Gets the workspace path.
+ */
+function getWorkspacePath(): string | undefined {
+    const folders = vscode.workspace.workspaceFolders;
+    return folders && folders.length > 0 ? folders[0].uri.fsPath : undefined;
+}
+
+/**
+ * Updates the irismd.isProject context based on workspace scan.
+ */
+async function updateProjectContext(workspacePath: string | undefined): Promise<void> {
+    if (!workspacePath) {
+        await vscode.commands.executeCommand('setContext', 'irismd.isProject', false);
+        return;
+    }
+
+    const model = await scanMemoryBank(workspacePath);
+    await vscode.commands.executeCommand('setContext', 'irismd.isProject', model.isProject);
+}
+
+/**
+ * Registers all extension commands.
+ */
+function registerCommands(context: vscode.ExtensionContext): void {
+    // Refresh command
+    context.subscriptions.push(
+        vscode.commands.registerCommand('irismd.refresh', async () => {
+            await webviewProvider?.refresh();
+            const workspacePath = getWorkspacePath();
+            await updateProjectContext(workspacePath);
+        })
+    );
+
+    // Open file command (can be triggered from webview)
+    context.subscriptions.push(
+        vscode.commands.registerCommand('irismd.openFile', async (filePath: string) => {
+            if (filePath) {
+                const uri = vscode.Uri.file(filePath);
+                await vscode.window.showTextDocument(uri);
+            }
+        })
+    );
+
+    // Reveal in Explorer command
+    context.subscriptions.push(
+        vscode.commands.registerCommand('irismd.revealInExplorer', async (filePath: string) => {
+            if (filePath) {
+                const uri = vscode.Uri.file(filePath);
+                await vscode.commands.executeCommand('revealFileInOS', uri);
+            }
+        })
+    );
+
+    // Copy Path command
+    context.subscriptions.push(
+        vscode.commands.registerCommand('irismd.copyPath', async (filePath: string) => {
+            if (filePath) {
+                await vscode.env.clipboard.writeText(filePath);
+                vscode.window.showInformationMessage(`Path copied: ${filePath}`);
+            }
+        })
+    );
+}

package/src/iris_bundle/frameworks/iris-core/vs-code-extension/src/parser/activityFeed.ts

@@ -0,0 +1,184 @@
+/**
+ * Activity feed derivation functions.
+ * Derives activity events from bolt timestamps for the command center UI.
+ */
+
+import { Bolt, ActivityEvent, ActivityEventType } from './types';
+
+/**
+ * Icon mapping for activity event types.
+ */
+const EVENT_ICONS: Record<ActivityEventType, { icon: string; iconClass: string }> = {
+    'bolt-created': { icon: '+', iconClass: 'bolt-created' },
+    'bolt-start': { icon: '▶', iconClass: 'bolt-start' },
+    'stage-complete': { icon: '✓', iconClass: 'stage-complete' },
+    'bolt-complete': { icon: '✔', iconClass: 'bolt-complete' }
+};
+
+/**
+ * Creates a display name for a bolt.
+ * Extracts unit and number from bolt ID like "bolt-artifact-parser-1".
+ */
+function getBoltDisplayName(boltId: string): string {
+    // Remove "bolt-" prefix if present
+    const withoutPrefix = boltId.replace(/^bolt-/, '');
+    return withoutPrefix;
+}
+
+/**
+ * Creates an activity event.
+ */
+function createEvent(
+    type: ActivityEventType,
+    bolt: Bolt,
+    timestamp: Date,
+    stageName?: string
+): ActivityEvent {
+    const iconData = EVENT_ICONS[type];
+    let text: string;
+    let id: string;
+    let tag: 'bolt' | 'stage';
+
+    switch (type) {
+        case 'bolt-created':
+            text = `Created <strong>${getBoltDisplayName(bolt.id)}</strong>`;
+            id = `${bolt.id}-created`;
+            tag = 'bolt';
+            break;
+        case 'bolt-start':
+            text = `Started <strong>${getBoltDisplayName(bolt.id)}</strong>`;
+            id = `${bolt.id}-started`;
+            tag = 'bolt';
+            break;
+        case 'stage-complete':
+            text = `Completed <strong>${stageName}</strong> stage in ${getBoltDisplayName(bolt.id)}`;
+            id = `${bolt.id}-stage-${stageName}`;
+            tag = 'stage';
+            break;
+        case 'bolt-complete':
+            text = `Completed <strong>${getBoltDisplayName(bolt.id)}</strong>`;
+            id = `${bolt.id}-completed`;
+            tag = 'bolt';
+            break;
+    }
+
+    return {
+        id,
+        type,
+        timestamp,
+        icon: iconData.icon,
+        iconClass: iconData.iconClass,
+        text,
+        targetId: bolt.id,
+        targetName: getBoltDisplayName(bolt.id),
+        tag,
+        path: bolt.filePath
+    };
+}
+
+/**
+ * Builds an activity feed from bolt timestamps.
+ * Derives events from created, started, completed, and stage completion timestamps.
+ *
+ * @param bolts - Array of bolts with timestamp fields
+ * @returns Array of ActivityEvents sorted by timestamp descending (most recent first)
+ */
+export function buildActivityFeed(bolts: Bolt[]): ActivityEvent[] {
+    const events: ActivityEvent[] = [];
+
+    for (const bolt of bolts) {
+        // bolt-created event
+        if (bolt.createdAt) {
+            events.push(createEvent('bolt-created', bolt, bolt.createdAt));
+        }
+
+        // bolt-start event
+        if (bolt.startedAt) {
+            events.push(createEvent('bolt-start', bolt, bolt.startedAt));
+        }
+
+        // stage-complete events from stages array
+        for (const stage of bolt.stages) {
+            if (stage.completedAt) {
+                events.push(
+                    createEvent('stage-complete', bolt, stage.completedAt, stage.name)
+                );
+            }
+        }
+
+        // bolt-complete event
+        if (bolt.completedAt) {
+            events.push(createEvent('bolt-complete', bolt, bolt.completedAt));
+        }
+    }
+
+    // Sort by timestamp descending (most recent first)
+    return events.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+}
+
+/**
+ * Filters activity events by tag.
+ *
+ * @param events - Array of activity events
+ * @param tag - Tag to filter by ('bolt' or 'stage'), or 'all' for no filtering
+ * @returns Filtered array of events
+ */
+export function filterActivityEvents(
+    events: ActivityEvent[],
+    tag: 'all' | 'bolt' | 'stage'
+): ActivityEvent[] {
+    if (tag === 'all') {
+        return events;
+    }
+    return events.filter(e => e.tag === tag);
+}
+
+/**
+ * Limits activity events to most recent N items.
+ *
+ * @param events - Array of activity events (should already be sorted)
+ * @param limit - Maximum number of events to return
+ * @returns Array limited to specified count
+ */
+export function limitActivityEvents(events: ActivityEvent[], limit: number): ActivityEvent[] {
+    return events.slice(0, limit);
+}
+
+/**
+ * Formats a relative time string for display.
+ * Examples: "Just now", "5m ago", "2h ago", "Yesterday", "3d ago"
+ *
+ * @param timestamp - Date to format
+ * @param now - Reference time (defaults to current time)
+ * @returns Human-readable relative time string
+ */
+export function formatRelativeTime(timestamp: Date, now: Date = new Date()): string {
+    const diffMs = now.getTime() - timestamp.getTime();
+    const diffSeconds = Math.floor(diffMs / 1000);
+    const diffMinutes = Math.floor(diffSeconds / 60);
+    const diffHours = Math.floor(diffMinutes / 60);
+    const diffDays = Math.floor(diffHours / 24);
+
+    if (diffSeconds < 60) {
+        return 'Just now';
+    }
+
+    if (diffMinutes < 60) {
+        return `${diffMinutes}m ago`;
+    }
+
+    if (diffHours < 24) {
+        return `${diffHours}h ago`;
+    }
+
+    if (diffDays === 1) {
+        return 'Yesterday';
+    }
+
+    if (diffDays < 7) {
+        return `${diffDays}d ago`;
+    }
+
+    // For older events, show the date
+    return timestamp.toLocaleDateString();
+}