omniagent 0.1.1 → 0.1.3

package/CLAUDE.md

@@ -0,0 +1,29 @@
+# omniagent Development Guidelines
+
+Auto-generated from all feature plans. Last updated: 2026-02-08
+
+## Active Technologies
+
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path` + `child_process`, Vitest, Vite, Biome (017-dynamic-template-scripts)
+
+## Project Structure
+
+```text
+src/
+tests/
+```
+
+## Commands
+
+npm test && npm run lint
+
+## Code Style
+
+TypeScript 5.9 (ES2022) on Node.js 18+: Follow standard conventions
+
+## Recent Changes
+
+- 017-dynamic-template-scripts: Added TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path` + `child_process`, Vitest, Vite, Biome
+
+<!-- MANUAL ADDITIONS START -->
+<!-- MANUAL ADDITIONS END -->

package/README.md

@@ -266,6 +266,54 @@ Everyone except Claude and Gemini see this.
 </agents>
 ```
 
+### Dynamic template scripts (`<nodejs>` and `<shell>`)
+
+`sync` can execute inline script blocks in canonical templates before agent templating/rendering.
+
+Node.js blocks evaluate JavaScript and inject the returned value:
+
+```md
+Current docs:
+<nodejs>
+const fs = require("node:fs");
+const path = require("node:path");
+
+const docsDir = path.join(process.cwd(), "docs");
+const pages = fs
+  .readdirSync(docsDir)
+  .filter((name) => name.endsWith(".md"))
+  .sort();
+
+return pages.map((name) => `- ${name}`).join("\n");
+</nodejs>
+```
+
+Shell blocks execute in the user's shell and inject stdout:
+
+```md
+Current docs:
+<shell>
+for file in docs/*.md; do
+  [ -f "$file" ] || continue
+  printf -- "- %s\n" "$(basename "$file")"
+done | sort
+</shell>
+```
+
+Behavior:
+
+- Scripts run once per template per sync run and cached results are reused across targets.
+- Each script block runs in an isolated process (Node subprocess for `<nodejs>`, shell process for `<shell>`).
+- `<nodejs>` blocks can use `require`, `__dirname`, and `__filename`.
+- `<shell>` blocks run with the user's shell (`$SHELL` on Unix, `cmd.exe` on Windows fallback).
+- `<nodejs>` return values are normalized as: string unchanged, object/array JSON text, other values via
+  `String(value)`, `null`/`undefined` as empty output.
+- `<shell>` blocks render raw stdout.
+- Static template text around script blocks is preserved.
+- Script failures stop sync before managed writes are applied.
+- Long-running scripts emit periodic `still running` warnings every 30 seconds.
+- Routine per-script telemetry is quiet by default and shown only with `sync --verbose`.
+
 ## CLI reference
 
 ```bash
@@ -277,6 +325,7 @@ npx omniagent@latest sync --exclude-local=skills,commands
 npx omniagent@latest sync --agentsDir ./my-custom-agents
 npx omniagent@latest sync --list-local
 npx omniagent@latest sync --yes
+npx omniagent@latest sync --verbose
 npx omniagent@latest sync --json
 ```