devglide 0.1.1

package/src/apps/test/src/services/scenario-store.ts

@@ -0,0 +1,145 @@
+import fs from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+import { v4 as uuidv4 } from "uuid";
+
+interface TriggerStep {
+  command: string;
+  selector?: string;
+  text?: string;
+  value?: string;
+  timeout?: number;
+  ms?: number;
+  clear?: boolean;
+  contains?: boolean;
+  path?: string;
+}
+
+export interface SavedScenario {
+  id: string;
+  name: string;
+  description?: string;
+  target: string;
+  steps: TriggerStep[];
+  createdAt: string;
+  lastRunAt?: string;
+  runCount: number;
+}
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DATA_DIR = path.join(__dirname, "..", "..", "data");
+const DATA_FILE = path.join(DATA_DIR, "scenarios.json");
+
+/**
+ * JSON file-backed store for saved test scenarios.
+ */
+export class ScenarioStore {
+  private static instance: ScenarioStore;
+  private scenarios: SavedScenario[] = [];
+  private loaded = false;
+  private persistQueue: Promise<void> = Promise.resolve();
+
+  static getInstance(): ScenarioStore {
+    if (!ScenarioStore.instance) {
+      ScenarioStore.instance = new ScenarioStore();
+    }
+    return ScenarioStore.instance;
+  }
+
+  async load(): Promise<void> {
+    if (this.loaded) return;
+    await this.reload();
+  }
+
+  private async reload(): Promise<void> {
+    try {
+      const raw = await fs.readFile(DATA_FILE, "utf-8");
+      this.scenarios = JSON.parse(raw);
+    } catch {
+      this.scenarios = [];
+    }
+    this.loaded = true;
+  }
+
+  private persist(): Promise<void> {
+    const write = async () => {
+      await fs.mkdir(DATA_DIR, { recursive: true });
+      await fs.writeFile(DATA_FILE, JSON.stringify(this.scenarios, null, 2));
+    };
+    // Serialize writes to prevent concurrent persist() from corrupting the file
+    this.persistQueue = this.persistQueue.then(write, write);
+    return this.persistQueue;
+  }
+
+  async list(target: string): Promise<SavedScenario[]> {
+    await this.reload();
+    return this.scenarios.filter((s) => s.target === target);
+  }
+
+  async listAll(): Promise<SavedScenario[]> {
+    await this.reload();
+    return [...this.scenarios];
+  }
+
+  async get(id: string): Promise<SavedScenario | undefined> {
+    await this.reload();
+    return this.scenarios.find((s) => s.id === id);
+  }
+
+  async save(input: {
+    name: string;
+    description?: string;
+    target: string;
+    steps: TriggerStep[];
+  }): Promise<SavedScenario> {
+    await this.load();
+    const scenario: SavedScenario = {
+      id: uuidv4(),
+      name: input.name,
+      description: input.description,
+      target: input.target,
+      steps: input.steps,
+      createdAt: new Date().toISOString(),
+      runCount: 0,
+    };
+    this.scenarios.push(scenario);
+    await this.persist();
+    return scenario;
+  }
+
+  async update(id: string, input: {
+    name?: string;
+    description?: string;
+    target?: string;
+    steps?: TriggerStep[];
+  }): Promise<SavedScenario | undefined> {
+    await this.load();
+    const scenario = this.scenarios.find((s) => s.id === id);
+    if (!scenario) return undefined;
+    if (input.name !== undefined) scenario.name = input.name;
+    if (input.description !== undefined) scenario.description = input.description;
+    if (input.target !== undefined) scenario.target = input.target;
+    if (input.steps !== undefined) scenario.steps = input.steps;
+    await this.persist();
+    return scenario;
+  }
+
+  async delete(id: string): Promise<boolean> {
+    await this.load();
+    const idx = this.scenarios.findIndex((s) => s.id === id);
+    if (idx === -1) return false;
+    this.scenarios.splice(idx, 1);
+    await this.persist();
+    return true;
+  }
+
+  async markRun(id: string): Promise<SavedScenario | undefined> {
+    await this.load();
+    const scenario = this.scenarios.find((s) => s.id === id);
+    if (!scenario) return undefined;
+    scenario.lastRunAt = new Date().toISOString();
+    scenario.runCount++;
+    await this.persist();
+    return scenario;
+  }
+}

package/src/apps/test/tsconfig.json

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

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

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

@@ -0,0 +1,25 @@
+ WARN  Issue while reading "/home/runner/_work/devglide/devglide/.npmrc". Failed to replace env in config: ${NODE_AUTH_TOKEN}
+
+> @devglide/vocabulary@0.1.0 lint /home/runner/_work/devglide/devglide/src/apps/vocabulary
+> eslint .
+
+
+/home/runner/_work/devglide/devglide/src/apps/vocabulary/mcp.ts
+  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
+  4:1  warning  `../../packages/mcp-utils/src/index.js` import should occur before import of `./services/vocabulary-store.js`  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/vocabulary/services/vocabulary-store.ts
+  1:1  warning  There should be at least one empty line between import groups                                   import/order
+  1:8  warning  'path' is defined but never used. Allowed unused vars must match /^_/u                          @typescript-eslint/no-unused-vars
+  3:1  warning  `../../../project-context.js` import should occur before type import of `../types.js`           import/order
+  4:1  warning  `../../../packages/paths.js` import should occur before type import of `../types.js`            import/order
+  5:1  warning  `../../../packages/json-file-store.js` import should occur before type import of `../types.js`  import/order
+
+/home/runner/_work/devglide/devglide/src/apps/vocabulary/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
+
+✖ 10 problems (0 errors, 10 warnings)
+  0 errors and 9 warnings potentially fixable with the `--fix` option.
+

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

package/src/apps/vocabulary/mcp.ts

@@ -0,0 +1,173 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { VocabularyStore } from './services/vocabulary-store.js';
+import { jsonResult, errorResult, createDevglideMcpServer } from '../../packages/mcp-utils/src/index.js';
+
+export function createVocabularyMcpServer(): McpServer {
+  const server = createDevglideMcpServer(
+    'devglide-vocabulary',
+    '0.1.0',
+    'Project-scoped domain vocabulary for LLM context enrichment',
+    {
+      instructions: [
+        '## Vocabulary — Usage Conventions',
+        '',
+        '### Purpose',
+        '- Vocabulary entries define domain-specific terms, abbreviations, and jargon.',
+        '- The LLM uses these to accurately interpret short or ambiguous user language.',
+        '',
+        '### Managing vocabulary',
+        '- Use `vocabulary_list` to see all terms.',
+        '- Use `vocabulary_lookup` to expand a term by name or alias.',
+        '- Use `vocabulary_add` to define a new term.',
+        '- Use `vocabulary_update` to modify an existing entry.',
+        '- Use `vocabulary_remove` to delete a term.',
+        '- Use `vocabulary_context` to get all terms as compiled markdown for LLM injection.',
+      ],
+    },
+  );
+
+  const store = VocabularyStore.getInstance();
+
+  // ── 1. vocabulary_list ────────────────────────────────────────────────────
+
+  server.tool(
+    'vocabulary_list',
+    'List all vocabulary entries. Optionally filter by category or tag.',
+    {
+      category: z.string().optional().describe('Filter by category'),
+      tag: z.string().optional().describe('Filter by tag'),
+    },
+    async ({ category, tag }) => {
+      const entries = await store.list({ category, tag });
+      return jsonResult(entries);
+    },
+  );
+
+  // ── 2. vocabulary_lookup ──────────────────────────────────────────────────
+
+  server.tool(
+    'vocabulary_lookup',
+    'Look up a term by name or alias. Returns the full entry with definition.',
+    {
+      term: z.string().describe('Term or alias to look up'),
+    },
+    async ({ term }) => {
+      const entry = await store.lookup(term);
+      if (!entry) return errorResult(`Term "${term}" not found`);
+      return jsonResult(entry);
+    },
+  );
+
+  // ── 3. vocabulary_add ─────────────────────────────────────────────────────
+
+  server.tool(
+    'vocabulary_add',
+    'Add a new vocabulary entry. Define a domain term with its full definition.',
+    {
+      term: z.string().describe('The short term or abbreviation'),
+      definition: z.string().describe('Full definition or expansion of the term'),
+      aliases: z.string().optional().describe('JSON array of alternative names for this term'),
+      category: z.string().optional().describe('Category to group the term under (e.g. "API", "Database", "Business")'),
+      tags: z.string().optional().describe('JSON array of tag strings'),
+    },
+    async ({ term, definition, aliases, category, tags }) => {
+      const existing = await store.lookup(term);
+      if (existing) return errorResult(`Term "${term}" already exists (id: ${existing.id})`);
+
+      let parsedAliases: string[] | undefined;
+      if (aliases) {
+        try { parsedAliases = JSON.parse(aliases); } catch { return errorResult('Invalid JSON for aliases'); }
+      }
+
+      let parsedTags: string[] = [];
+      if (tags) {
+        try { parsedTags = JSON.parse(tags); } catch { return errorResult('Invalid JSON for tags'); }
+      }
+
+      const entry = await store.save({
+        term,
+        definition,
+        aliases: parsedAliases,
+        category,
+        tags: parsedTags,
+      });
+
+      return jsonResult(entry);
+    },
+  );
+
+  // ── 4. vocabulary_update ──────────────────────────────────────────────────
+
+  server.tool(
+    'vocabulary_update',
+    'Update an existing vocabulary entry by ID.',
+    {
+      id: z.string().describe('Entry ID'),
+      term: z.string().optional().describe('New term'),
+      definition: z.string().optional().describe('New definition'),
+      aliases: z.string().optional().describe('JSON array of alternative names'),
+      category: z.string().optional().describe('New category'),
+      tags: z.string().optional().describe('JSON array of tag strings'),
+    },
+    async ({ id, term, definition, aliases, category, tags }) => {
+      const existing = await store.get(id);
+      if (!existing) return errorResult('Entry not found');
+
+      let parsedAliases: string[] | undefined = existing.aliases;
+      if (aliases) {
+        try { parsedAliases = JSON.parse(aliases); } catch { return errorResult('Invalid JSON for aliases'); }
+      }
+
+      let parsedTags: string[] = existing.tags;
+      if (tags) {
+        try { parsedTags = JSON.parse(tags); } catch { return errorResult('Invalid JSON for tags'); }
+      }
+
+      const updated = await store.save({
+        id,
+        term: term ?? existing.term,
+        definition: definition ?? existing.definition,
+        aliases: parsedAliases,
+        category: category ?? existing.category,
+        tags: parsedTags,
+        projectId: existing.projectId,
+      });
+
+      return jsonResult(updated);
+    },
+  );
+
+  // ── 5. vocabulary_remove ──────────────────────────────────────────────────
+
+  server.tool(
+    'vocabulary_remove',
+    'Remove a vocabulary entry by ID.',
+    {
+      id: z.string().describe('Entry ID'),
+    },
+    async ({ id }) => {
+      const deleted = await store.delete(id);
+      if (!deleted) return errorResult('Entry not found');
+      return jsonResult({ ok: true });
+    },
+  );
+
+  // ── 6. vocabulary_context ─────────────────────────────────────────────────
+
+  server.tool(
+    'vocabulary_context',
+    'Get all vocabulary entries compiled as markdown context for LLM injection. Optionally filter by project.',
+    {
+      projectId: z.string().optional().describe('Optional project ID to filter entries'),
+    },
+    async ({ projectId }) => {
+      const markdown = await store.getCompiledContext(projectId);
+      return {
+        content: [{ type: 'text' as const, text: markdown || 'No vocabulary entries defined.' }],
+      };
+    },
+  );
+
+  return server;
+}

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

@@ -0,0 +1,25 @@
+{
+  "name": "@devglide/vocabulary",
+  "version": "0.1.0",
+  "description": "Project-scoped domain vocabulary for LLM context enrichment",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/src/index.js",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint ."
+  },
+  "private": true,
+  "dependencies": {
+    "@devglide/mcp-utils": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.49"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.0"
+  }
+}