omniagent 0.1.6 → 0.1.7

package/README.md

@@ -147,7 +147,9 @@ 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`.
+`omniagent profiles init <name>`, `omniagent profiles show <name>`, and
+`omniagent profiles validate`. Use `omniagent profiles init <name>.local`
+to create a personal local profile override.
 
 See [`docs/profiles.md`](docs/profiles.md) for the full schema, resolution
 order, and examples.

package/dist/cli.js

@@ -2898,6 +2898,26 @@ function resolveTargets(options) {
     disabledTargets
   };
 }
+const PROFILE_SCHEMA_URL = "https://raw.githubusercontent.com/JoeRoddy/omniagent/master/schemas/profile.v1.json";
+const ANSI_GRAY = "\x1B[90m";
+const ANSI_RESET_FOREGROUND = "\x1B[39m";
+const PROFILE_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+const STARTER_PROFILE = {
+  $schema: PROFILE_SCHEMA_URL,
+  description: "",
+  targets: {},
+  enable: {
+    skills: [],
+    subagents: [],
+    commands: []
+  },
+  disable: {
+    skills: [],
+    subagents: [],
+    commands: []
+  },
+  variables: {}
+};
 async function resolveRepoAndAgentsDir(argv) {
   const startDir = process.cwd();
   const repoRoot = await findRepoRoot(startDir);
@@ -2931,6 +2951,122 @@ function formatAnnotations(entry2) {
   }
   return annotations;
 }
+function validateProfileNamePart(name) {
+  if (!PROFILE_NAME_PATTERN.test(name)) {
+    return "Profile names may only contain letters, numbers, dots, underscores, and hyphens, and must start with a letter or number.";
+  }
+  return null;
+}
+function parseInitProfileTarget(name) {
+  if (name.endsWith(".local")) {
+    const profileName = name.slice(0, -".local".length);
+    const issue2 = validateProfileNamePart(profileName);
+    if (issue2) {
+      return { error: issue2 };
+    }
+    if (profileName.endsWith(".local")) {
+      return { error: 'Profile names cannot end with ".local.local".' };
+    }
+    return {
+      profileName,
+      isLocal: true
+    };
+  }
+  const issue = validateProfileNamePart(name);
+  if (issue) {
+    return { error: issue };
+  }
+  return {
+    profileName: name,
+    isLocal: false
+  };
+}
+function colorsEnabled() {
+  if (process.env.NO_COLOR !== void 0) {
+    return false;
+  }
+  const forced = process.env.FORCE_COLOR;
+  if (forced !== void 0) {
+    return forced !== "0" && forced.toLowerCase() !== "false";
+  }
+  return Boolean(process.stdout.isTTY);
+}
+function findLineCommentStart(line) {
+  let inString = false;
+  let escaped = false;
+  for (let index = 0; index < line.length; index += 1) {
+    const char = line[index];
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (char === "\\" && inString) {
+      escaped = true;
+      continue;
+    }
+    if (char === '"') {
+      inString = !inString;
+      continue;
+    }
+    if (!inString && char === "/" && line[index + 1] === "/") {
+      return index;
+    }
+  }
+  return null;
+}
+function colorizeGuideComments(text) {
+  if (!colorsEnabled()) {
+    return text;
+  }
+  return text.split("\n").map((line) => {
+    const commentStart = findLineCommentStart(line);
+    if (commentStart === null) {
+      return line;
+    }
+    return `${line.slice(0, commentStart)}${ANSI_GRAY}${line.slice(commentStart)}${ANSI_RESET_FOREGROUND}`;
+  }).join("\n");
+}
+function initGuide(target, displayPath) {
+  const label = target.isLocal ? `Created local profile "${target.profileName}" at ${displayPath}.` : `Created profile "${target.profileName}" at ${displayPath}.`;
+  const localHint = target.isLocal ? `
+Use profile name "${target.profileName}" when syncing; ".local" is only the file suffix.
+` : "";
+  return colorizeGuideComments(`${label}${localHint}
+
+Profile files must be valid JSON. This commented version is just a guide:
+
+{
+  "$schema": "${PROFILE_SCHEMA_URL}",
+
+  "description": "shown in \`omniagent profiles\`",
+
+  "targets": {
+    "claude": { "enabled": true }, // includes Claude; overrides an earlier profile setting it false
+    "gemini": { "enabled": false } // skips Gemini for this profile
+  },
+
+  "enable": { // names/globs to include; also opts in items marked enabled:false
+    "skills": ["code-review"],
+    "subagents": ["reviewer"],
+    "commands": []
+  },
+
+  "disable": { // names/globs to exclude after enable rules
+    "skills": [],
+    "subagents": [],
+    "commands": ["*-legacy"]
+  },
+
+  // https://github.com/JoeRoddy/omniagent/blob/master/docs/templating.md
+  "variables": {
+    "REVIEW_STYLE": "thorough" // replaces {{REVIEW_STYLE}} in synced files
+  }
+}
+
+Try it:
+  omniagent profiles show ${target.profileName}
+  omniagent sync --profile ${target.profileName}`);
+}
 async function loadProfileValidationCatalog(repoRoot, agentsDir) {
   const { config } = await loadTargetConfig({ repoRoot, agentsDir });
   const validation = validateTargetConfig({ config, builtIns: BUILTIN_TARGETS });
@@ -3016,6 +3152,70 @@ function collectProfileReferenceIssues(profileName, resolvedProfile, catalog) {
   }
   return issues;
 }
+const initSubcommand = {
+  command: "init <name>",
+  describe: "Create a new sync profile",
+  builder: (yargs2) => yargs2.positional("name", {
+    type: "string",
+    demandOption: true,
+    describe: "Profile name"
+  }).option("agentsDir", {
+    type: "string",
+    describe: "Override the agents directory",
+    defaultDescription: DEFAULT_AGENTS_DIR
+  }),
+  handler: async (argv) => {
+    const typed = argv;
+    const initTarget = parseInitProfileTarget(typed.name);
+    if ("error" in initTarget) {
+      console.error(`Error: ${initTarget.error}`);
+      process.exit(1);
+      return;
+    }
+    const resolved = await resolveRepoAndAgentsDir(typed);
+    if (!resolved) return;
+    if (initTarget.isLocal) {
+      const existingDedicatedPath = profileLocalDedicatedPath(
+        resolved.repoRoot,
+        initTarget.profileName,
+        resolved.agentsDir
+      );
+      const inspected = await inspectProfileFiles(
+        resolved.repoRoot,
+        initTarget.profileName,
+        resolved.agentsDir
+      );
+      if (inspected.localDedicated.exists) {
+        const displayPath2 = path.relative(resolved.repoRoot, existingDedicatedPath).split(path.sep).join("/");
+        console.error(
+          `Error: Local profile "${initTarget.profileName}" already exists at ${displayPath2}.`
+        );
+        process.exit(1);
+        return;
+      }
+    }
+    const targetPath = initTarget.isLocal ? profileLocalSiblingPath(resolved.repoRoot, initTarget.profileName, resolved.agentsDir) : profileSharedPath(resolved.repoRoot, initTarget.profileName, resolved.agentsDir);
+    const displayPath = path.relative(resolved.repoRoot, targetPath).split(path.sep).join("/");
+    const starterContents = `${JSON.stringify(STARTER_PROFILE, null, 2)}
+`;
+    try {
+      await mkdir(path.dirname(targetPath), { recursive: true });
+      await writeFile(targetPath, starterContents, { encoding: "utf8", flag: "wx" });
+    } catch (error) {
+      const code = error.code;
+      if (code === "EEXIST") {
+        const label = initTarget.isLocal ? "Local profile" : "Profile";
+        console.error(
+          `Error: ${label} "${initTarget.profileName}" already exists at ${displayPath}.`
+        );
+        process.exit(1);
+        return;
+      }
+      throw error;
+    }
+    console.log(initGuide(initTarget, displayPath));
+  }
+};
 const listSubcommand = {
   command: "$0",
   describe: "List available sync profiles",
@@ -3191,7 +3391,7 @@ const validateSubcommand = {
 const profilesCommand = {
   command: "profiles",
   describe: "Inspect and validate sync profiles",
-  builder: (yargs2) => yargs2.command(listSubcommand).command(showSubcommand).command(validateSubcommand).demandCommand(0).strictCommands(),
+  builder: (yargs2) => yargs2.command(listSubcommand).command(initSubcommand).command(showSubcommand).command(validateSubcommand).demandCommand(0).strictCommands(),
   handler: () => {
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omniagent",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Unified agent configuration CLI that compiles canonical agent configs to multiple runtimes.",
   "type": "module",
   "bin": {

package/CLAUDE.md

@@ -1,68 +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.
-- 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/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
-  }
-})