chore(release): prepare 0.2.5 — sync registry 0.2.4, new changeset, watch coverage timeouts

Align package.json and CHANGELOG with npm 0.2.4; remove consumed changeset; add patch changeset for README/ROADMAP/hook updates. Raise watch unit vi.waitFor timeouts so pnpm test:coverage stays green. Record the coverage timing lesson.

Made-with: Cursor

Author: serhiizhabskiy

.changeset/release-0-2-4.md

@@ -0,0 +1,5 @@
+---
+"agentsmesh": patch
+---
+
+Expand the project README, add `ROADMAP.md`, and fix the sample Claude Code PostToolUse hook to use `type: prompt` with a `prompt` field instead of an invalid command-style hook after reads.

.changeset/release-0-2-5.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.4
+
+### Patch Changes
+
+- 98bf8cb: Preserve nested canonical import paths and placeholder metadata; keep nested command picks and Cline workflow exclusions when installing packs; import Cline MCP settings from legacy `.cline/mcp_settings.json` when `cline_mcp_settings.json` is absent; refresh default `.gitignore` patterns for AgentsMesh cache and lock temp files.
+
 ## 0.2.3
 
 ### Patch Changes

CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "agentsmesh",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "One canonical source for AI coding agent rules, commands, skills, MCP, hooks, and permissions — synced across Claude Code, Cursor, Copilot, Continue, Junie, Gemini CLI, Cline, Codex CLI, and Windsurf.",
   "type": "module",
   "main": "./dist/cli.js",

package.json

@@ -83,3 +83,4 @@
 - **Auxiliary rule folders must not duplicate a target's primary root file unless the spec explicitly asks for it**: I initially mirrored Codex `_root.md` into `.codex/instructions/` even though Codex already uses `AGENTS.md` as the main instruction file and the user only wanted additional rules there. Root cause: I interpreted "all canonical rules" literally instead of preserving the target's established root surface and the user's scope correction. Rule: when adding a secondary rule projection folder for a target with an existing primary root file, default to mirroring only non-root/additional rules unless the spec explicitly requires a root duplicate.
 - **Dist-backed e2e and integration runs require a rebuild before trusting failures**: I fixed the Gemini importer in `src/` and kept seeing the old failure because the e2e harness executes `dist/cli.js`, not the source tree directly. Root cause: I reran targeted dist-backed tests after source edits without rebuilding, so I was debugging stale output instead of the current code. Rule: after any CLI behavior change, run `pnpm build` before interpreting e2e or integration results that invoke `dist/cli.js`.
 - **User corrections about target-native filenames must override stale repo assumptions everywhere**: The repo still used `.cline/mcp_settings.json` across code, tests, and docs after the user clarified that Cline should use `cline_mcp_settings.json`. Root cause: target-native filename assumptions had drifted and were repeated in multiple layers without one explicit correction pass. Rule: when a user corrects a target-native path or filename, update the constant first and then sweep generators, importers, stale-cleanup, tests, and docs in the same change so the contract cannot stay split-brained.
+- **Watch `vi.waitFor` thresholds must survive `pnpm test:coverage`**: `runMatrix` and `Regenerated.` assertions in `watch.test.ts` passed under plain `pnpm test` but timed out at 3000 ms when the same suite ran with coverage instrumentation. Root cause: coverage slows the process enough that chokidar debounce plus generate occasionally exceeded the minimum wait budget. Rule: keep watch unit `vi.waitFor` timeouts comfortably above 3000 ms (for example 8000 ms) and idle-stability delays at least 3000 ms when those tests must gate release prep and CI coverage.

tasks/lessons.md

@@ -74,7 +74,7 @@ describe('runWatch', () => {
       join(testDir, '.agentsmesh', 'rules', 'new.md'),
       '---\ndescription: "New"\n---\n# New',
     );
-    await vi.waitFor(() => expect(runMatrixSpy).toHaveBeenCalled(), { timeout: 3000 });
+    await vi.waitFor(() => expect(runMatrixSpy).toHaveBeenCalled(), { timeout: 8000 });
     runMatrixSpy.mockRestore();
     await result!.stop();
   });
@@ -103,7 +103,7 @@ features: [rules, permissions]
       join(testDir, '.agentsmesh', 'rules', 'new.md'),
       '---\ndescription: "New"\n---\n# New',
     );
-    await vi.waitFor(() => expect(runMatrixSpy).toHaveBeenCalled(), { timeout: 3000 });
+    await vi.waitFor(() => expect(runMatrixSpy).toHaveBeenCalled(), { timeout: 8000 });
     runMatrixSpy.mockRestore();
     await result!.stop();
   });
@@ -123,7 +123,7 @@ description: "Project rules"
 - Added one line (same rule count)
 `,
     );
-    await vi.waitFor(() => expect(infoSpy).toHaveBeenCalledWith('Regenerated.'), { timeout: 3000 });
+    await vi.waitFor(() => expect(infoSpy).toHaveBeenCalledWith('Regenerated.'), { timeout: 8000 });
     expect(runMatrixSpy).not.toHaveBeenCalled();
     runMatrixSpy.mockRestore();
     infoSpy.mockRestore();
@@ -143,14 +143,14 @@ description: "Project rules"
         expect(
           infoSpy.mock.calls.filter(([message]) => message === 'Regenerated.').length,
         ).toBeGreaterThanOrEqual(1),
-      { timeout: 3000 },
+      { timeout: 8000 },
     );
 
     const regenCountAfterStartup = infoSpy.mock.calls.filter(
       ([message]) => message === 'Regenerated.',
     ).length;
 
-    await new Promise((resolve) => setTimeout(resolve, 2000));
+    await new Promise((resolve) => setTimeout(resolve, 3000));
 
     expect(infoSpy.mock.calls.filter(([message]) => message === 'Regenerated.').length).toBe(
       regenCountAfterStartup,