devglide 0.1.1

package/src/apps/prompts/services/prompt-store.ts

@@ -0,0 +1,212 @@
+import fs from 'fs/promises';
+import path from 'path';
+import type { Prompt, PromptSummary } from '../types.js';
+import { getActiveProject } from '../../../project-context.js';
+import { PROMPTS_DIR } from '../../../packages/paths.js';
+import { JsonFileStore } from '../../../packages/json-file-store.js';
+
+/** Regex for {{varName}} placeholders — matches word chars, hyphens, and dots. */
+const VAR_PATTERN = /\{\{([\w.-]+)\}\}/g;
+
+/** Extract {{varName}} placeholders from prompt content. */
+function detectVariables(content: string): string[] {
+  const matches = content.matchAll(VAR_PATTERN);
+  const vars = new Set<string>();
+  for (const m of matches) vars.add(m[1]);
+  return [...vars];
+}
+
+export class PromptStore extends JsonFileStore<Prompt> {
+  private static instance: PromptStore;
+  protected readonly baseDir = PROMPTS_DIR;
+
+  static getInstance(): PromptStore {
+    if (!PromptStore.instance) {
+      PromptStore.instance = new PromptStore();
+    }
+    return PromptStore.instance;
+  }
+
+  async list(filter?: { category?: string; tags?: string[]; search?: string }): Promise<PromptSummary[]> {
+    const seen = new Map<string, PromptSummary>();
+
+    const projectDir = this.getProjectDir();
+    if (projectDir) {
+      for (const s of await this.scanDir(projectDir, 'project')) {
+        seen.set(s.id, s);
+      }
+      for (const s of await this.scanDir(this.getGlobalDir(), 'global')) {
+        if (!seen.has(s.id)) seen.set(s.id, s);
+      }
+    } else {
+      // No active project — scan global + project subdirs with correct scope labels
+      for (const s of await this.scanDir(this.getGlobalDir(), 'global')) {
+        seen.set(s.id, s);
+      }
+      for (const s of await this.scanProjectSubdirs()) {
+        if (!seen.has(s.id)) seen.set(s.id, s);
+      }
+    }
+
+    let results = [...seen.values()];
+
+    if (filter?.category) {
+      results = results.filter((p) => p.category === filter.category);
+    }
+    if (filter?.tags?.length) {
+      results = results.filter((p) => filter.tags!.every((t) => p.tags.includes(t)));
+    }
+    if (filter?.search) {
+      const q = filter.search.toLowerCase();
+      results = results.filter((p) =>
+        p.title.toLowerCase().includes(q) ||
+        (p.description ?? '').toLowerCase().includes(q) ||
+        (p.category ?? '').toLowerCase().includes(q) ||
+        p.tags.some((t) => t.toLowerCase().includes(q)),
+      );
+    }
+
+    return results;
+  }
+
+  async save(
+    input: Omit<Prompt, 'id' | 'createdAt' | 'updatedAt'> & { id?: string; scope?: 'project' | 'global' },
+  ): Promise<Prompt> {
+    const lockKey = input.id ?? this.generateId();
+    return this.withLock(lockKey, async () => {
+      const now = new Date().toISOString();
+      const isUpdate = !!input.id;
+
+      let existing: Prompt | null = null;
+      if (isUpdate) {
+        existing = await this.get(input.id!);
+      }
+
+      const prompt: Prompt = {
+        id: input.id ?? lockKey,
+        title: input.title,
+        content: input.content,
+        description: input.description,
+        category: input.category,
+        tags: input.tags ?? [],
+        variables: detectVariables(input.content),
+        model: input.model,
+        temperature: input.temperature,
+        rating: input.rating,
+        notes: input.notes,
+        projectId: input.projectId,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+      };
+
+      let scope = input.scope;
+      if (!scope && isUpdate) {
+        scope = await this.resolveExistingScope(input.id!);
+      }
+      scope = scope ?? (getActiveProject() ? 'project' : 'global');
+
+      await this.writeEntity(prompt, scope, getActiveProject()?.id);
+      return prompt;
+    });
+  }
+
+  /**
+   * Atomically fetch, merge, and write — eliminates TOCTOU race in callers.
+   * undefined = keep existing, null = clear field, value = update.
+   */
+  async update(
+    id: string,
+    fields: { [K in keyof Omit<Prompt, 'id' | 'createdAt' | 'updatedAt' | 'variables'>]?: Prompt[K] | null },
+  ): Promise<Prompt | null> {
+    return this.withLock(id, async () => {
+      const existing = await this.get(id);
+      if (!existing) return null;
+
+      const merged: Prompt = { ...existing, updatedAt: new Date().toISOString() };
+      for (const [key, value] of Object.entries(fields)) {
+        if (value === undefined) continue;
+        (merged as unknown as Record<string, unknown>)[key] = value === null ? undefined : value;
+      }
+      merged.variables = detectVariables(merged.content);
+
+      const scope = await this.resolveExistingScope(id) ?? (getActiveProject() ? 'project' : 'global');
+      await this.writeEntity(merged, scope, getActiveProject()?.id);
+      return merged;
+    });
+  }
+
+  /** Return all prompts as compiled markdown for LLM context injection. */
+  async getCompiledContext(): Promise<string> {
+    const summaries = await this.list();
+    if (summaries.length === 0) return '';
+
+    const lines: string[] = [
+      '# Available Prompts',
+      '',
+      '> Reusable prompt templates. Use `prompts_render` with the ID to expand variables.',
+      '',
+    ];
+
+    const byCategory = new Map<string, PromptSummary[]>();
+    for (const s of summaries) {
+      const cat = s.category ?? 'General';
+      if (!byCategory.has(cat)) byCategory.set(cat, []);
+      byCategory.get(cat)!.push(s);
+    }
+
+    for (const [category, entries] of byCategory) {
+      lines.push(`## ${category}`, '');
+      for (const e of entries) {
+        const stars = e.rating ? ' ' + '\u2605'.repeat(e.rating) : '';
+        const tags = e.tags.length ? ` [${e.tags.join(', ')}]` : '';
+        lines.push(`- **${e.title}** (id: \`${e.id}\`)${stars}${tags}`);
+        if (e.description) lines.push(`  ${e.description}`);
+      }
+      lines.push('');
+    }
+
+    return lines.join('\n');
+  }
+
+  async render(id: string, vars: Record<string, string>): Promise<string | null> {
+    const prompt = await this.get(id);
+    if (!prompt) return null;
+    return prompt.content.replace(VAR_PATTERN, (_, name) => vars[name] ?? `{{${name}}}`);
+  }
+
+  private toSummary(entry: Prompt, scope: 'project' | 'global'): PromptSummary {
+    return {
+      id: entry.id,
+      title: entry.title,
+      description: entry.description,
+      category: entry.category,
+      tags: entry.tags,
+      rating: entry.rating,
+      scope,
+      updatedAt: entry.updatedAt,
+    };
+  }
+
+  private async scanDir(dir: string, scope: 'project' | 'global'): Promise<PromptSummary[]> {
+    const entries = await this.scanDirFull(dir);
+    return entries.map((e) => this.toSummary(e, scope));
+  }
+
+  /** Scan all project subdirectories under baseDir, labeling entries as 'project' scope. */
+  private async scanProjectSubdirs(): Promise<PromptSummary[]> {
+    const results: PromptSummary[] = [];
+    let names: string[];
+    try {
+      names = await fs.readdir(this.baseDir);
+    } catch {
+      return [];
+    }
+    for (const name of names) {
+      if (name.endsWith('.json')) continue;
+      for (const entry of await this.scanDirFull(path.join(this.baseDir, name))) {
+        results.push(this.toSummary(entry, 'project'));
+      }
+    }
+    return results;
+  }
+}

package/src/apps/prompts/src/index.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { createPromptsMcpServer } from "../mcp.js";
+import { runStdio } from "@devglide/mcp-utils";
+
+if (process.argv.includes("--stdio")) {
+  const server = createPromptsMcpServer();
+  await runStdio(server);
+  console.error("Devglide Prompts MCP server running on stdio");
+}

package/src/apps/prompts/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../packages/tsconfig/node.json",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "include": ["src", "mcp.ts", "types.ts", "services"],
+  "exclude": ["node_modules", "dist"]
+}

package/src/apps/prompts/types.ts

@@ -0,0 +1,27 @@
+export interface Prompt {
+  id: string;
+  title: string;
+  content: string;           // Supports {{varName}} placeholders
+  description?: string;
+  category?: string;
+  tags: string[];
+  variables?: string[];      // Auto-detected from {{...}} in content
+  model?: string;            // Preferred model hint
+  temperature?: number;      // Preferred temperature hint
+  rating?: number;           // 1–5
+  notes?: string;            // Evaluation notes
+  projectId?: string;        // undefined = global
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface PromptSummary {
+  id: string;
+  title: string;
+  description?: string;
+  category?: string;
+  tags: string[];
+  rating?: number;
+  scope: 'project' | 'global';
+  updatedAt: string;
+}

package/src/apps/shell/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+ WARN  Issue while reading "/home/runner/_work/devglide/devglide/.npmrc". Failed to replace env in config: ${NODE_AUTH_TOKEN}
+
+> @devglide/shell@0.1.0 build /home/runner/_work/devglide/devglide/src/apps/shell
+> tsc
+

package/src/apps/shell/.turbo/turbo-lint.log

@@ -0,0 +1,34 @@
+ WARN  Issue while reading "/home/runner/_work/devglide/devglide/.npmrc". Failed to replace env in config: ${NODE_AUTH_TOKEN}
+
+> @devglide/shell@0.1.0 lint /home/runner/_work/devglide/devglide/src/apps/shell
+> eslint .
+
+
+/home/runner/_work/devglide/devglide/src/apps/shell/src/index.ts
+  1:1  warning  There should be at least one empty line between import groups          import/order
+  2:1  warning  There should be at least one empty line between import groups          import/order
+  2:1  warning  `fs` import should occur before import of `node-pty`                   import/order
+  3:1  warning  There should be at least one empty line between import groups          import/order
+  4:1  warning  `@devglide/mcp-utils` import should occur before import of `node-pty`  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/shell/src/mcp.ts
+  1:1  warning  There should be at least one empty line between import groups                                    import/order
+  1:1  warning  `@modelcontextprotocol/sdk/server/streamableHttp.js` import should occur after import of `path`  import/order
+  2:1  warning  There should be at least one empty line between import groups                                    import/order
+  3:1  warning  There should be at least one empty line between import groups                                    import/order
+  3:1  warning  `zod` import should occur after type import of `express`                                         import/order
+  4:1  warning  There should be at least one empty line between import groups                                    import/order
+  4:1  warning  `../../../packages/mcp-utils/src/index.js` import should occur after type import of `express`    import/order
+  5:1  warning  There should be at least one empty line between import groups                                    import/order
+  5:1  warning  `@modelcontextprotocol/sdk/server/mcp.js` type import should occur after import of `path`        import/order
+  7:1  warning  There should be at least one empty line between import groups                                    import/order
+  8:1  warning  There should be at least one empty line between import groups                                    import/order
+  9:1  warning  There should be at least one empty line between import groups                                    import/order
+  9:1  warning  `./shell-types.js` type import should occur after import of `../../../project-context.js`        import/order
+
+/home/runner/_work/devglide/devglide/src/apps/shell/src/shell-types.ts
+  34:7  warning  Unexpected any. Specify a different type  @typescript-eslint/no-explicit-any
+
+✖ 19 problems (0 errors, 19 warnings)
+  0 errors and 18 warnings potentially fixable with the `--fix` option.
+

package/src/apps/shell/.turbo/turbo-typecheck.log

@@ -0,0 +1,5 @@
+ WARN  Issue while reading "/home/runner/_work/devglide/devglide/.npmrc". Failed to replace env in config: ${NODE_AUTH_TOKEN}
+
+> @devglide/shell@0.1.0 typecheck /home/runner/_work/devglide/devglide/src/apps/shell
+> tsc --noEmit
+

package/src/apps/shell/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@devglide/shell",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Multi-terminal dashboard with speech-to-text",
+  "main": "dist/index.js",
+  "bin": {
+    "devglide-shell": "./dist/index.js"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "mcp": "tsx src/index.ts --stdio",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  },
+  "private": true,
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@puppeteer/browsers": "^2.13.0",
+    "express": "^5.2.1",
+    "node-pty": "^1.1.0",
+    "puppeteer-core": "^24.39.0",
+    "@devglide/mcp-utils": "workspace:*",
+    "zod": "^3.25.49"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.0"
+  }
+}

package/src/apps/shell/public/favicon.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect width="32" height="32" fill="#1c2128"/>
+  <rect width="32" height="32" fill="none" stroke="#7ee787" stroke-width="1.5"/>
+  <path d="M8 10h6a6 6 0 0 1 0 12H8V10z" fill="#7ee787"/>
+  <rect x="18" y="10" width="6" height="4" fill="#7ee787" opacity="0.6"/>
+  <rect x="18" y="18" width="6" height="4" fill="#7ee787" opacity="0.6"/>
+</svg>