omniagent 0.1.5 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omniagent",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Unified agent configuration CLI that compiles canonical agent configs to multiple runtimes.",
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
   "scripts": {
     "build": "npm run check && vite build",
     "patch": "npm version patch --no-git-tag-version",
-    "prepublish": "npm run patch && npm run build",
+    "prepublishOnly": "npm run patch",
+    "prepack": "npm run build",
     "postbuild": "chmod +x dist/cli.js",
     "dev": "npm run build && node dist/cli.js",
     "check": "biome check .",

package/schemas/profile.v1.json

@@ -8,7 +8,7 @@
 	"properties": {
 		"$schema": {
 			"type": "string",
-			"description": "Optional reference to this JSON Schema for editor autocomplete."
+			"description": "Optional reference to this JSON Schema for editor autocomplete, for example https://raw.githubusercontent.com/JoeRoddy/omniagent/master/schemas/profile.v1.json."
 		},
 		"description": {
 			"type": "string",

package/CLAUDE.md

@@ -1,67 +0,0 @@
-# omniagent Development Guidelines
-
-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.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
-
-```text
-src/
-tests/
-```
-
-## Commands
-
-npm run check && npm test
-
-## Code Style
-
-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
-
-
-
-
-<!-- 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.
-- 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/CONTRIBUTING.md

@@ -1,56 +0,0 @@
-# Contributing
-
-This document is for contributors and maintainers working on the `omniagent` codebase.
-
-If you are using `omniagent` as an npm package consumer, start with [`README.md`](README.md).
-
-## Local Setup
-
-- Node.js 18+
-- npm
-
-Install dependencies:
-
-```bash
-npm ci
-```
-
-## Local Validation
-
-Run the same checks used by CI before opening a PR:
-
-```bash
-npm run check
-npm run typecheck
-npm test
-npm run build
-```
-
-## Docs Changes
-
-When updating docs, keep root `README.md` consumer-focused.
-
-- End-user usage and product behavior belong in `README.md` and `docs/*.md`.
-- Development and contribution workflows belong in `CONTRIBUTING.md`.
-- Update docs assertions in `tests/docs/readme.test.ts` when docs architecture changes.
-
-## CLI Shim E2E (Contributor Workflow)
-
-CLI shim E2E is a contributor-only verification flow and is not required for normal package usage.
-
-Detailed guide:
-
-- [`docs/cli-shim-e2e.md`](docs/cli-shim-e2e.md)
-
-Quick commands:
-
-```bash
-# Build first
-npm run build
-
-# Record baseline outputs from real CLIs
-OA_E2E_RECORD_BASELINE=1 npm test -- tests/e2e/cli-shim/cli-shim.e2e.test.ts
-
-# Compare shim output to recorded baselines
-OA_E2E=1 npm test -- tests/e2e/cli-shim/cli-shim.e2e.test.ts
-```

package/biome.json

@@ -1,41 +0,0 @@
-{
-	"$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
-	"files": {
-		"includes": ["src/**/*.ts", "tests/**/*.ts"]
-	},
-	"formatter": {
-		"enabled": true,
-		"indentStyle": "tab",
-		"indentWidth": 2,
-		"lineWidth": 100
-	},
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"recommended": true,
-			"suspicious": {
-				"noExplicitAny": "warn"
-			},
-			"correctness": {
-				"noUnusedImports": "error",
-				"noUnusedVariables": "error"
-			}
-		}
-	},
-	"assist": {
-		"enabled": true,
-		"actions": {
-			"source": {
-				"recommended": true
-			}
-		}
-	},
-	"javascript": {
-		"formatter": {
-			"quoteStyle": "double",
-			"semicolons": "always",
-			"trailingCommas": "all",
-			"arrowParentheses": "always"
-		}
-	}
-}

package/tasks.md

@@ -1,25 +0,0 @@
-# README Docs Refactor Tasks
-
-- [x] Create concise onboarding-first `README.md` for the 90% sync workflow.
-- [x] Add advanced docs pages and move complex README content into `/docs`.
-- [x] Move custom targets/custom agent declaration guidance to `docs/custom-targets.md`.
-- [x] Move templating and dynamic script guidance to `docs/templating.md`.
-- [x] Add a docs index and link advanced docs from `README.md`.
-- [x] Update docs tests to match the new README/docs structure.
-- [x] Run validation (`npm run check` and `npm test`).
-
-# Contributor/Consumer Split Follow-up
-
-- [x] Remove development-only validation details from root `README.md`.
-- [x] Add `CONTRIBUTING.md` with local development and validation guidance.
-- [x] Move CLI shim E2E guidance under contributing docs flow.
-- [x] Remove contributor-only links from end-user docs indexes.
-- [x] Update docs tests for the new contributing boundary.
-- [x] Run validation (`npm run check` and `npm test`).
-
-# README Basics Follow-up
-
-- [x] Add simple `.local` override explanation to root `README.md`.
-- [x] Add simple basic templating explanation to root `README.md`.
-- [x] Update docs tests to assert these root README basics.
-- [x] Run validation (`npm run check` and `npm test`).

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "strict": true,
-    "types": ["node", "vitest/globals"],
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src"]
-}

package/vite.config.ts

@@ -1,22 +0,0 @@
-import { defineConfig } from 'vite'
-
-export default defineConfig({
-  build: {
-    target: 'node18',
-    ssr: true,
-    lib: {
-      entry: {
-        cli: 'src/cli/index.ts',
-        index: 'src/index.ts'
-      },
-      formats: ['es'],
-      fileName: (_format, entryName) => `${entryName}.js`
-    },
-    rollupOptions: {
-      external: ['yargs', 'yargs/helpers'],
-      output: {
-        banner: (chunk) => (chunk.name === 'cli' ? '#!/usr/bin/env node' : '')
-      }
-    }
-  }
-})

package/vitest.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    environment: 'node',
-    globals: true,
-    include: ['tests/**/*.test.ts', 'src/**/*.test.ts'],
-    testTimeout: 10000
-  }
-})