omniagent 0.1.4 → 0.1.6

package/CLAUDE.md

@@ -1,10 +1,32 @@
 # omniagent Development Guidelines
 
-Auto-generated from all feature plans. Last updated: 2026-02-08
+Auto-generated from all feature plans. Last updated: 2026-01-10
 
 ## Active Technologies
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js fs/promises + path (004-sync-agent-config)
+- Filesystem (repo-local directories) (004-sync-agent-config)
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js fs/promises + path, Vitest, Vite, Biome (005-sync-slash-commands)
+- Filesystem (repo `agents/commands/`, project target dirs, user home dirs) (005-sync-slash-commands)
+- Filesystem (repo-local config + target directories) (006-add-custom-subagents)
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises`, `path`, Vitest, Vite, Biome (007-agent-templating)
+- Filesystem (repo-local config + target directories + user home config) (007-agent-templating)
+- Filesystem (repo-local agents/ directories and user home state under `~/.omniagent/state/`) (009-local-config-sync)
+- Filesystem (repo-local sources/outputs + user home state under `~/.omniagent/state/`) (010-instruction-file-sync)
+- Filesystem (repo-local `agents/` directory or user-supplied agents directory) (012-agents-dir-override)
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, @typescript/native-preview (tsgo), Vitest, Vite, Biome (013-fix-typecheck-ci)
+- Filesystem (repo-local config and user home state) (013-fix-typecheck-ci)
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vite, Vitest, Biome (014-add-custom-targets)
+- Filesystem (repo-local directories and user home state under `~/.omniagent/state/`) (014-add-custom-targets)
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, `jiti`, Vite, Vitest, Biome, @typescript/native-preview (tsgo) (015-cli-shim-flags)
+- Filesystem (repo-local agents directory and user home state under `~/.omniagent/state/`) (015-cli-shim-flags)
+- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vitest, Vite, Biome (016-sync-default-agents)
+- Filesystem (repo-local outputs and user home state under `~/.omniagent/state/`) (016-sync-default-agents)
 
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path` + `child_process`, Vitest, Vite, Biome (017-dynamic-template-scripts)
+- TypeScript 5.x, ES2022 target + yargs (CLI parsing), Vitest (testing), Vite (build), Biome (formatting/linting) (003-biome-integration)
+
+- TypeScript 5.x, ES2022 target + yargs (CLI parsing), Vitest (testing) (002-vitest-cli-testing)
+
+- TypeScript 5.x, Node.js 18+ + yargs (CLI parsing only) (001-cli-foundation)
 
 ## Project Structure
 
@@ -15,15 +37,32 @@ tests/
 
 ## Commands
 
-npm test && npm run lint
+npm run check && npm test
 
 ## Code Style
 
-TypeScript 5.9 (ES2022) on Node.js 18+: Follow standard conventions
+TypeScript 5.x, Node.js 18+: Enforced by Biome (formatting and linting)
+- Line width: 100 characters
+- Indentation: Tabs (2-space width)
+- Quotes: Double quotes
+- Semicolons: Always
+- Run `npm run format` before committing
 
 ## Recent Changes
+- 016-sync-default-agents: Added TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vitest, Vite, Biome
+- 015-cli-shim-flags: Added TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, `jiti`, Vite, Vitest, Biome, @typescript/native-preview (tsgo)
+- 014-add-custom-targets: Added TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vite, Vitest, Biome
+
+
 
-- 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 -->
+- Dynamic template scripts (`<nodejs>` and `<shell>`) are a shared sync runtime feature and apply across all
+  syncable template surfaces (skills, subagents, slash commands, and instruction templates).
+- Any future syncable surface must integrate with the shared template-script runtime instead of
+  introducing surface-specific script execution behavior.
+- For GitHub actions, use `gh` CLI.
+- Keep ignore and publish rules aligned with tool-specific directories so package publishes stay
+  clean.
+- CLI shim E2E docs: `docs/cli-shim-e2e.md`.
 <!-- MANUAL ADDITIONS END -->

package/README.md

@@ -68,6 +68,9 @@ npx omniagent@latest sync --agentsDir ./my-custom-agents
 # Show local-only overrides and exit
 npx omniagent@latest sync --list-local
 
+# Apply a sync profile (see docs/profiles.md)
+npx omniagent@latest sync --profile code-reviewer
+
 # Shim mode (no subcommand)
 omniagent --agent codex
 omniagent -p "Summarize this repo" --agent codex --output json
@@ -110,6 +113,45 @@ agents/.local/
 agents/**/*.local*
 ```
 
+## Sync Profiles
+
+Profiles let each dev pick a named, checked-in filter that `sync` applies to
+the shared `agents/` directory — so a ten-person team can share one source of
+truth while each member opts in to exactly the skills, subagents, commands,
+and targets they want.
+
+```jsonc
+// agents/profiles/code-reviewer.json
+{
+  "description": "Focused setup for PR reviews",
+  "extends": "base",
+  "targets": { "claude": { "enabled": true }, "codex": { "enabled": true } },
+  "enable": {
+    "skills":    ["code-review", "security-review"],
+    "subagents": ["reviewer"],
+    "commands":  ["review", "diff-summary"]
+  },
+  "variables": { "REVIEW_STYLE": "terse" }
+}
+```
+
+```bash
+omniagent sync                                   # uses agents/profiles/default.json when present
+omniagent sync --profile code-reviewer
+omniagent sync --profile base,code-reviewer     # merge multiple (later wins)
+omniagent sync --var REVIEW_STYLE=thorough      # override a variable from the CLI
+```
+
+Profiles support `extends` chains, `.local` overrides (personal, gitignored),
+glob-based `enable`/`disable` lists, per-target toggles, and template
+variables. Individual skills, subagents, and commands can also set frontmatter
+`enabled: false` to stay hidden by default until a profile opts them in.
+Discover and validate profiles with `omniagent profiles`,
+`omniagent profiles show <name>`, and `omniagent profiles validate`.
+
+See [`docs/profiles.md`](docs/profiles.md) for the full schema, resolution
+order, and examples.
+
 ## Basic Templating
 
 Use `<agents ...>` blocks when some text should render only for specific targets.
@@ -155,6 +197,7 @@ Example usage:
 - CLI shim details: [`docs/cli-shim.md`](docs/cli-shim.md)
 - Custom targets (custom agents): [`docs/custom-targets.md`](docs/custom-targets.md)
 - Local overrides: [`docs/local-overrides.md`](docs/local-overrides.md)
+- Sync profiles: [`docs/profiles.md`](docs/profiles.md)
 - Templating and dynamic scripts: [`docs/templating.md`](docs/templating.md)
 - Command reference: [`docs/reference.md`](docs/reference.md)
 - Troubleshooting: [`docs/troubleshooting.md`](docs/troubleshooting.md)