devglide 0.1.1

package/src/apps/vocabulary/services/vocabulary-store.ts

@@ -0,0 +1,179 @@
+import path from 'path';
+import type { VocabularyEntry, VocabularyEntrySummary } from '../types.js';
+import { getActiveProject } from '../../../project-context.js';
+import { VOCABULARY_DIR } from '../../../packages/paths.js';
+import { JsonFileStore } from '../../../packages/json-file-store.js';
+
+/**
+ * Per-project and global vocabulary storage.
+ * One JSON file per entry for git-friendly diffs.
+ * Storage: ~/.devglide/vocabulary/{projectId}/ and ~/.devglide/vocabulary/
+ */
+export class VocabularyStore extends JsonFileStore<VocabularyEntry> {
+  private static instance: VocabularyStore;
+  protected readonly baseDir = VOCABULARY_DIR;
+
+  static getInstance(): VocabularyStore {
+    if (!VocabularyStore.instance) {
+      VocabularyStore.instance = new VocabularyStore();
+    }
+    return VocabularyStore.instance;
+  }
+
+  async list(filter?: { category?: string; tag?: string }): Promise<VocabularyEntrySummary[]> {
+    const seen = new Map<string, VocabularyEntrySummary>();
+
+    const projectDir = this.getProjectDir();
+    if (projectDir) {
+      // Active project set — scan project dir (priority) then global
+      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 (e.g. stdio MCP mode) — scan all dirs
+      for (const entry of await this.scanAllDirs()) {
+        if (!seen.has(entry.id)) {
+          seen.set(entry.id, this.toSummary(entry, 'project'));
+        }
+      }
+    }
+
+    let results = [...seen.values()];
+
+    if (filter?.category) {
+      results = results.filter((e) => e.category === filter.category);
+    }
+    if (filter?.tag) {
+      results = results.filter((e) => e.tags.includes(filter.tag!));
+    }
+
+    return results;
+  }
+
+  async lookup(term: string): Promise<VocabularyEntry | null> {
+    const all = await this.listFull();
+    const normalized = term.toLowerCase();
+
+    for (const entry of all) {
+      if (entry.term.toLowerCase() === normalized) return entry;
+      if (entry.aliases?.some((a) => a.toLowerCase() === normalized)) return entry;
+    }
+
+    return null;
+  }
+
+  async save(
+    input: Omit<VocabularyEntry, 'id' | 'createdAt' | 'updatedAt'> & { id?: string; scope?: 'project' | 'global' },
+  ): Promise<VocabularyEntry> {
+    const lockKey = input.id ?? this.generateId();
+    return this.withLock(lockKey, async () => {
+      const now = new Date().toISOString();
+      const isUpdate = !!input.id;
+
+      let existing: VocabularyEntry | null = null;
+      if (isUpdate) {
+        existing = await this.get(input.id!);
+      }
+
+      const entry: VocabularyEntry = {
+        id: input.id ?? lockKey,
+        term: input.term,
+        definition: input.definition,
+        aliases: input.aliases,
+        category: input.category,
+        tags: input.tags ?? [],
+        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(entry, scope, getActiveProject()?.id);
+      return entry;
+    });
+  }
+
+  async getCompiledContext(projectId?: string): Promise<string> {
+    const all = await this.listFull();
+
+    const filtered = all.filter((e) => {
+      if (projectId && e.projectId && e.projectId !== projectId) return false;
+      return true;
+    });
+
+    if (filtered.length === 0) return '';
+
+    const lines: string[] = [
+      '# Domain Vocabulary',
+      '',
+      '> Use the following domain-specific terms when interpreting user requests.',
+      '',
+    ];
+
+    const byCategory = new Map<string, VocabularyEntry[]>();
+    for (const entry of filtered) {
+      const cat = entry.category ?? 'General';
+      if (!byCategory.has(cat)) byCategory.set(cat, []);
+      byCategory.get(cat)!.push(entry);
+    }
+
+    for (const [category, entries] of byCategory) {
+      lines.push(`## ${category}`, '');
+      for (const entry of entries) {
+        const aliases = entry.aliases?.length ? ` (also: ${entry.aliases.join(', ')})` : '';
+        lines.push(`- **${entry.term}**${aliases}: ${entry.definition}`);
+      }
+      lines.push('');
+    }
+
+    return lines.join('\n');
+  }
+
+  private async listFull(): Promise<VocabularyEntry[]> {
+    const seen = new Map<string, VocabularyEntry>();
+
+    const projectDir = this.getProjectDir();
+    if (projectDir) {
+      // Active project set — scan project dir (priority) then global
+      for (const e of await this.scanDirFull(projectDir)) {
+        seen.set(e.id, e);
+      }
+      for (const e of await this.scanDirFull(this.getGlobalDir())) {
+        if (!seen.has(e.id)) seen.set(e.id, e);
+      }
+    } else {
+      // No active project (e.g. stdio MCP mode) — scan all dirs
+      for (const e of await this.scanAllDirs()) {
+        if (!seen.has(e.id)) seen.set(e.id, e);
+      }
+    }
+
+    return [...seen.values()];
+  }
+
+  private toSummary(entry: VocabularyEntry, scope: 'project' | 'global'): VocabularyEntrySummary {
+    return {
+      id: entry.id,
+      term: entry.term,
+      definition: entry.definition,
+      aliases: entry.aliases,
+      category: entry.category,
+      tags: entry.tags,
+      scope,
+      updatedAt: entry.updatedAt,
+    };
+  }
+
+  private async scanDir(dir: string, scope: 'project' | 'global'): Promise<VocabularyEntrySummary[]> {
+    const entries = await this.scanDirFull(dir);
+    return entries.map((e) => this.toSummary(e, scope));
+  }
+}

package/src/apps/vocabulary/src/index.ts

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

package/src/apps/vocabulary/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/vocabulary/types.ts

@@ -0,0 +1,22 @@
+export interface VocabularyEntry {
+  id: string;
+  term: string;
+  definition: string;
+  aliases?: string[];
+  category?: string;
+  tags: string[];
+  projectId?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface VocabularyEntrySummary {
+  id: string;
+  term: string;
+  definition: string;
+  aliases?: string[];
+  category?: string;
+  tags: string[];
+  scope: 'project' | 'global';
+  updatedAt: string;
+}

package/src/apps/voice/.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/voice@0.1.0 build /home/runner/_work/devglide/devglide/src/apps/voice
+> tsc
+

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

@@ -0,0 +1,43 @@
+ WARN  Issue while reading "/home/runner/_work/devglide/devglide/.npmrc". Failed to replace env in config: ${NODE_AUTH_TOKEN}
+
+> @devglide/voice@0.1.0 lint /home/runner/_work/devglide/devglide/src/apps/voice
+> eslint .
+
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/index.ts
+  2:1  warning  There should be at least one empty line between import groups          import/order
+  3:1  warning  `@devglide/mcp-utils` import should occur before import of `./mcp.js`  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/mcp.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
+  4:1  warning  `./services/stats.js` import should occur before import of `./transcribe.js`         import/order
+  6:1  warning  `./services/config-store.js` import should occur before import of `./transcribe.js`  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/providers/index.ts
+  2:1  warning  There should be at least one empty line between import groups                         import/order
+  2:1  warning  `./openai-compatible.js` import should occur before type import of `./types.js`       import/order
+  3:1  warning  `../services/config-store.js` import should occur before type import of `./types.js`  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/providers/openai-compatible.ts
+   9:14  warning  Unexpected any. Specify a different type  @typescript-eslint/no-explicit-any
+  10:38  warning  Unexpected any. Specify a different type  @typescript-eslint/no-explicit-any
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/routes/config.ts
+  1: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
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/routes/transcribe.ts
+  1:1  warning  There should be at least one empty line between import groups  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/services/config-store.ts
+  2:1  warning  There should be at least one empty line between import groups  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/voice/src/services/stats.ts
+  1:1  warning  There should be at least one empty line between import groups                                import/order
+  1:1  warning  `../providers/index.js` import should occur after import of `../../../../packages/paths.js`  import/order
+  3:1  warning  There should be at least one empty line between import groups                                import/order
+
+✖ 18 problems (0 errors, 18 warnings)
+  0 errors and 16 warnings potentially fixable with the `--fix` option.
+

package/src/apps/voice/.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/voice@0.1.0 typecheck /home/runner/_work/devglide/devglide/src/apps/voice
+> tsc --noEmit
+

package/src/apps/voice/node_modules/.bin/openai

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/openai@4.104.0_ws@8.19.0_zod@3.25.76/node_modules/openai/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/openai@4.104.0_ws@8.19.0_zod@3.25.76/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/openai@4.104.0_ws@8.19.0_zod@3.25.76/node_modules/openai/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/openai@4.104.0_ws@8.19.0_zod@3.25.76/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../openai/bin/cli" "$@"
+else
+  exec node  "$basedir/../openai/bin/cli" "$@"
+fi

package/src/apps/voice/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/src/apps/voice/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/src/apps/voice/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/_work/devglide/devglide/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/_work/devglide/devglide/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
+fi

package/src/apps/voice/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@devglide/voice",
+  "version": "0.1.0",
+  "description": "Speech-to-text with config dashboard",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "devglide-voice": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "mcp": "tsx src/index.ts --stdio",
+    "mcp:http": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@devglide/mcp-utils": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "cors": "^2.8.5",
+    "express": "^5.2.1",
+    "openai": "^4.80.0",
+    "zod": "^3.25.49"
+  },
+  "private": true,
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.0"
+  }
+}

package/src/apps/voice/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>