claude-comms 1.0.34 → 1.0.35

package/.agents/repo.md

@@ -1,29 +1,7 @@
 
 # Repository Guidelines
-
-## Project Structure & Module Organization
-- `apps/server` hosts the Bun observability API; routes stay in `src/index.ts`, persistence helpers in `src/db.ts`, and regression suites in `src/__tests__`.
-- `apps/client` contains the Vue dashboard; UI modules live in `src/components` and `src/views` with Vitest and Playwright specs under `tests/`.
-- `packages/setup-installer` ships the `claude-comms` NPX CLI; logic resides in `src/`, distributable templates in `templates/`, and Jest suites across `test/unit`, `test/integration`, and `test/e2e`.
-- `.claude/hooks/*` stores Python-powered agents, while `scripts/` provides operational helpers such as `start-system.sh`, `reset-system.sh`, and telemetry generators.
-
-## Build, Test, and Development Commands
-- `./scripts/start-system.sh` boots the Bun API, Vue dashboard, and SQLite broker for an end-to-end stack from the repo root.
-- `cd apps/server && bun install && bun run dev` starts the API with hot reload; use `bun run start` for production parity and `bun run typecheck` before merging.
-- `cd apps/client && bun install && bun run dev` launches the dashboard; `bun run build` compiles the Vite bundle and `bun run preview` smoke-tests it.
-- `cd packages/setup-installer && npm install && npm test` validates the installer; run `npm run lint` or `npm run test:coverage` when altering CLI behavior or templates.
-
-## Coding Style & Naming Conventions
-- Use 2-space indentation, `camelCase` utilities, `PascalCase` components and types, and co-locate shared shapes in `apps/*/src/types.ts`.
-- Keep persistence isolated to `apps/server/src/db.ts`; expose new queries through typed helpers rather than inline SQL inside request handlers.
-- In the dashboard prefer composables in `src/composables`, Tailwind utility classes, and structured logging or toast utilities instead of raw `console.log` calls.
-
-## Testing Guidelines
-- Backend suites live in `apps/server/src/__tests__` with `.test.ts` suffixes; run `bun run test` or `bun run test:coverage` whenever mutating server logic.
-- Dashboard coverage pairs Vitest (`bun run test`) with Playwright smoke tests in `apps/client/tests/playwright`; refresh artifacts in `tests/visual` when UI states change.
-- Installer validation relies on Jest; execute `npm run test:integration` after template edits and `npm run test:e2e` before publishing new packages.
-
-## Commit & Pull Request Guidelines
-- History favors short, imperative subjects (`remove matrix mode`) with selective conventional prefixes (`chore(release): 1.0.23`); follow that tone and omit trailing periods.
-- Reference issues and describe agent-facing impact in PR descriptions; attach dashboard screenshots or installer logs whenever UX or setup flows shift.
-- Before requesting review, ensure `./scripts/test-system.sh` plus relevant package checks pass and call out skipped suites or follow-up tasks in the PR notes.
+Run required commands — all must pass without warnings or errors:
+   - `pnpm lint`
+   - `pnpm ts:check`
+   - `pnpm test:all`
+   - `pnpm build`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-comms",
-  "version": "1.0.34",
+  "version": "1.0.35",
   "description": "NPX installer for Claude Code hooks and observability setup",
   "main": "src/index.js",
   "bin": {

package/src/fetcher/github.js

@@ -332,6 +332,10 @@ class GitHubFetcher extends EventEmitter {
       // Observability hooks
       '.claude/hooks/observability/send_event.py',
 
+      // Agents directory
+      '.agents/AGENTS.md',
+      '.agents/repo.md',
+
       // Root CLAUDE.md
       'CLAUDE.md'
     ];
@@ -339,7 +343,10 @@ class GitHubFetcher extends EventEmitter {
     const files = [];
 
     for (const filePath of knownFiles) {
-      if (filePath.startsWith(path) || (path === '.claude' && filePath.startsWith('.claude')) || (path === 'CLAUDE.md' && filePath === 'CLAUDE.md')) {
+      if (filePath.startsWith(path) ||
+          (path === '.claude' && filePath.startsWith('.claude')) ||
+          (path === '.agents' && filePath.startsWith('.agents')) ||
+          (path === 'CLAUDE.md' && filePath === 'CLAUDE.md')) {
         try {
           const content = await this._fetchSingleFileRaw(filePath, options);
           files.push(content);
@@ -867,6 +874,12 @@ class GitHubFetcher extends EventEmitter {
           type: 'dir',
           children: [],
           files: []
+        },
+        '.agents': {
+          path: '.agents',
+          type: 'dir',
+          children: [],
+          files: []
         }
       };
 
@@ -899,18 +912,19 @@ class GitHubFetcher extends EventEmitter {
 
           // Only extract files we care about
           const isClaudeFile = actualPath.startsWith('.claude/') || actualPath === '.claude';
+          const isAgentsFile = actualPath.startsWith('.agents/') || actualPath === '.agents';
           const isClaudeMd = actualPath === 'CLAUDE.md';
 
-          console.log(`DEBUG: ${actualPath} -> claude: ${isClaudeFile}, md: ${isClaudeMd}, type: ${entry.type}`);
+          console.log(`DEBUG: ${actualPath} -> claude: ${isClaudeFile}, agents: ${isAgentsFile}, md: ${isClaudeMd}, type: ${entry.type}`);
 
-          if ((isClaudeFile || isClaudeMd) && entry.type === 'File') {
+          if ((isClaudeFile || isAgentsFile || isClaudeMd) && entry.type === 'File') {
             wantedFiles.set(filePath, actualPath);
             console.log(`DEBUG: Will extract: ${filePath} -> ${actualPath}`);
             return true;
           }
 
-          // Also allow .claude directories to be processed for their children
-          if (isClaudeFile && entry.type === 'Directory') {
+          // Also allow .claude and .agents directories to be processed for their children
+          if ((isClaudeFile || isAgentsFile) && entry.type === 'Directory') {
             return true;
           }
 
@@ -964,6 +978,21 @@ class GitHubFetcher extends EventEmitter {
                   // Build directory structure for compatibility
                   const relativePath = actualPath.slice('.claude/'.length);
                   this._addToDirectoryStructure(extractedFiles['.claude'], relativePath, fileObj);
+                } else if (actualPath.startsWith('.agents/')) {
+                  // Add to .agents files
+                  const fileObj = {
+                    path: actualPath,
+                    content: content,
+                    encoding: 'utf-8',
+                    type: 'file'
+                  };
+
+                  extractedFiles['.agents'].files.push(fileObj);
+                  console.log(`DEBUG: Added ${actualPath} to .agents files (${extractedFiles['.agents'].files.length} total)`);
+
+                  // Build directory structure for compatibility
+                  const relativePath = actualPath.slice('.agents/'.length);
+                  this._addToDirectoryStructure(extractedFiles['.agents'], relativePath, fileObj);
                 }
               }
             } catch (fileError) {
@@ -972,7 +1001,7 @@ class GitHubFetcher extends EventEmitter {
             }
           }
 
-          console.log(`DEBUG: Final result - .claude has ${extractedFiles['.claude'].files.length} files, CLAUDE.md: ${extractedFiles['CLAUDE.md'] ? 'present' : 'missing'}`);
+          console.log(`DEBUG: Final result - .claude has ${extractedFiles['.claude'].files.length} files, .agents has ${extractedFiles['.agents'].files.length} files, CLAUDE.md: ${extractedFiles['CLAUDE.md'] ? 'present' : 'missing'}`);
 
           // Clean up temp directory
           try {
@@ -1059,8 +1088,13 @@ async function fetchRepository(gitRef = 'main', options = {}) {
 
     return {
       claudeDirectory: tarballFiles['.claude'],
+      agentsDirectory: tarballFiles['.agents'],
       claudeFile: tarballFiles['CLAUDE.md'],
-      files: [...(tarballFiles['.claude'].files || []), tarballFiles['CLAUDE.md']]
+      files: [
+        ...(tarballFiles['.claude'].files || []),
+        ...(tarballFiles['.agents'].files || []),
+        tarballFiles['CLAUDE.md']
+      ]
     };
 
   } catch (tarballError) {
@@ -1069,15 +1103,17 @@ async function fetchRepository(gitRef = 'main', options = {}) {
 
     try {
       // Strategy 2: Individual file fetch (fallback)
-      const [claudeDir, claudeMd] = await Promise.all([
+      const [claudeDir, agentsDir, claudeMd] = await Promise.all([
         fetcher.fetchDirectory('.claude', { version: gitRef }),
+        fetcher.fetchDirectory('.agents', { version: gitRef }),
         fetcher.fetchFile('CLAUDE.md', { version: gitRef })
       ]);
 
       return {
         claudeDirectory: claudeDir,
+        agentsDirectory: agentsDir,
         claudeFile: claudeMd,
-        files: [...(claudeDir.files || []), claudeMd]
+        files: [...(claudeDir.files || []), ...(agentsDir.files || []), claudeMd]
       };
 
     } catch (fallbackError) {