@mhmdreza-rafiei/agentry 0.1.0 → 0.2.1

package/package.json

@@ -1,34 +1,53 @@
 {
   "name": "@mhmdreza-rafiei/agentry",
-  "version": "0.1.0",
-  "description": "One CLI to install agents, skills, rules, and scripts into any project or globally — portable AI/agent tooling.",
+  "version": "0.2.1",
+  "description": "One CLI to install agents, skills, rules, and profiles onto AI coding agents — portable AI/agent tooling.",
+  "type": "module",
   "bin": {
-    "agentry": "bin/agentry.js"
+    "agentry": "./dist/cli.mjs"
   },
   "files": [
-    "bin",
-    "src",
-    "profile",
-    "examples",
+    "dist",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
-    "agentry": "node bin/agentry.js",
-    "test": "node --test"
+    "dev": "tsx src/cli.ts",
+    "build": "obuild",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22.20.0"
   },
   "keywords": [
     "ai",
     "agents",
     "skills",
     "rules",
+    "profiles",
     "cli",
     "cursor",
+    "claude-code",
+    "codex",
     "agentic",
     "scaffold"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "@vercel/detect-agent": "^1.2.1",
+    "picocolors": "^1.1.1",
+    "xdg-basedir": "^5.1.0",
+    "yaml": "^2.8.3",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "obuild": "^0.4.22",
+    "tsx": "^4.19.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.0"
+  }
 }

package/bin/agentry.js

@@ -1,257 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const readline = require('node:readline');
-const { execSync } = require('node:child_process');
-const reg = require('../src/registry');
-const src = require('../src/source');
-const prof = require('../src/profile');
-const cmd = require('../src/commands');
-const pkg = require('../package.json');
-
-function parseArgs(argv) {
-  const flags = {};
-  const positional = [];
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a === '-g' || a === '--global') flags.global = true;
-    else if (a === '--project') flags.project = true;
-    else if (a === '-y' || a === '--yes') flags.yes = true;
-    else if (a === '--dir') flags.dir = argv[++i];
-    else if (a === '-v' || a === '--version') flags.version = true;
-    else if (a === '-h' || a === '--help') flags.help = true;
-    else if (a === '--uninstall') flags.uninstall = true;
-    else positional.push(a);
-  }
-  return { flags, positional };
-}
-
-const HELP = `agentry — a raw installer for agents, skills, rules, and scripts from any repo.
-
-Usage:
-  agentry add <type> <source> [category/name | category] [options]
-  agentry add profile <name> [source] [options]
-  agentry remove <type> [category/name | category] [options]
-  agentry list <source> [type]
-  agentry update
-
-Sources:
-  author/repo        GitHub shorthand      e.g. Prat011/awesome-llm-skills
-  https://…/repo.git full git URL
-  ./path             a local directory
-
-Selectors (after the source):
-  category/name   one asset      e.g. video/downloader
-  name            one asset      (when the repo has no categories)
-  category        a whole category
-  (omitted)       list assets and pick interactively
-
-Examples:
-  agentry add skills Prat011/awesome-llm-skills                    # pick from all skills
-  agentry add skills Prat011/awesome-llm-skills video/downloader   # one skill (categorized)
-  agentry add skills Prat011/awesome-llm-skills video-downloader   # one skill (no category)
-  agentry add agents author/repo frontend                         # a whole category
-  agentry add profile frontend author/repo                        # apply profile/frontend.json
-  agentry remove skills video/downloader                          # remove installed asset
-  agentry list author/repo
-
-Options:
-  -g, --global     Install into ~/.cursor (all projects)
-      --project    Install into the current folder (default)
-      --dir <p>    Install into a specific folder
-  -y, --yes        Don't prompt; install everything matched
-  -v, --version    Print version
-  -h, --help       Show this help
-      --uninstall  Uninstall the agentry CLI`;
-
-function ask(question) {
-  return new Promise((resolve) => {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-function interactive(flags) {
-  return process.stdin.isTTY && !flags.yes;
-}
-
-async function resolveTarget(flags) {
-  if (flags.global) return { global: true };
-  if (flags.project || flags.dir) return { global: false, dir: flags.dir };
-  if (interactive(flags)) {
-    const ans = await ask('Install location — [P]roject (this folder) or [g]lobal (home)? ');
-    if (/^g/i.test(ans)) return { global: true };
-  }
-  return { global: false };
-}
-
-async function pick(assets) {
-  console.log('Available:');
-  assets.forEach((a, i) => {
-    const desc = (a.description || '').replace(/\s+/g, ' ').slice(0, 60);
-    console.log(`  [${i + 1}] ${a.type}/${a.id}${desc ? ' — ' + desc : ''}`);
-  });
-  const ans = await ask('Install which? (numbers comma-separated, or "all"): ');
-  if (!ans || /^all$/i.test(ans)) return assets;
-  const idx = ans
-    .split(/[, ]+/)
-    .map((s) => parseInt(s, 10) - 1)
-    .filter((n) => n >= 0 && n < assets.length);
-  return idx.map((i) => assets[i]);
-}
-
-function locationLabel(opts) {
-  return opts.global ? 'globally (~/.cursor)' : `project (${cmd.targetRoot(opts)})`;
-}
-
-function dedupe(assets) {
-  const seen = new Set();
-  return assets.filter((a) => {
-    const key = `${a.type}/${a.id}`;
-    if (seen.has(key)) return false;
-    seen.add(key);
-    return true;
-  });
-}
-
-function installAll(assets, opts) {
-  if (!assets.length) {
-    console.log('Nothing matched — nothing installed.');
-    return;
-  }
-  console.log(`Installing ${assets.length} item(s) ${locationLabel(opts)}:`);
-  for (const a of assets) {
-    const dest = cmd.installOne(a, opts);
-    console.log(`  + ${a.type}/${a.id} -> ${dest}`);
-  }
-  console.log('\nDone. Review assets before use; they run with full agent permissions.');
-}
-
-async function addType(type, source, selector, flags) {
-  if (!source) throw new Error(`Missing source. e.g. agentry add ${type} author/repo`);
-  const opts = await resolveTarget(flags);
-  const { root, cleanup } = src.resolveSource(source);
-  try {
-    let assets = type === 'all' ? reg.allAssets(root) : reg.select(root, type, selector);
-    if (!assets.length) throw new Error(`Nothing found for "${type}${selector ? ' ' + selector : ''}" in ${source}.`);
-    if (!selector && type !== 'all' && assets.length > 1 && interactive(flags)) assets = await pick(assets);
-    installAll(assets, opts);
-  } finally {
-    cleanup();
-  }
-}
-
-async function addProfile(name, source, flags) {
-  const { file, cfg } = prof.loadProfile(name);
-  const repo = source || cfg.repo;
-  if (!repo) throw new Error(`No source given and ${file} has no "repo". Try: agentry add profile ${name} author/repo`);
-  const opts = await resolveTarget(flags);
-  const { root, cleanup } = src.resolveSource(repo);
-  try {
-    const assets = [];
-    for (const type of reg.TYPES) {
-      for (const selector of cfg[type] || []) assets.push(...reg.select(root, type, selector));
-    }
-    installAll(dedupe(assets), opts);
-  } finally {
-    cleanup();
-  }
-}
-
-function listSource(source, type) {
-  if (!source) throw new Error('Missing source. e.g. agentry list author/repo');
-  const { root, cleanup } = src.resolveSource(source);
-  try {
-    for (const t of type ? [type] : reg.TYPES) {
-      console.log(`\n${t}:`);
-      const items = reg.listType(root, t);
-      if (!items.length) {
-        console.log('  (none)');
-        continue;
-      }
-      for (const it of items) {
-        const desc = (it.description || '').replace(/\s+/g, ' ').slice(0, 80);
-        console.log(`  ${it.id}${desc ? ' — ' + desc : ''}`);
-      }
-    }
-  } finally {
-    cleanup();
-  }
-}
-
-async function remove(type, selector, flags) {
-  const opts = await resolveTarget(flags);
-  const scope = [type, selector].filter(Boolean).join('/');
-  if (type === 'all') {
-    let count = 0;
-    for (const t of reg.TYPES) count += cmd.removeSelection(t, undefined, opts).removedKeys.length;
-    console.log(`Removed ${count} item(s) from ${locationLabel(opts)}.`);
-    return;
-  }
-  const r = cmd.removeSelection(type, selector, opts);
-  if (!r.existed && r.removedKeys.length === 0) {
-    console.log(`Nothing installed at "${scope}" in ${locationLabel(opts)}.`);
-    return;
-  }
-  for (const k of r.removedKeys) console.log(`removed ${k}`);
-  console.log(`\nRemoved ${r.removedKeys.length || 1} item(s) from ${locationLabel(opts)}.`);
-}
-
-function runUpdate() {
-  console.log('Updating agentry CLI...');
-  try {
-    execSync('npm install -g agentry@latest', { stdio: 'inherit' });
-  } catch {
-    console.error('Update failed. Once published, run: npm install -g agentry@latest');
-    process.exit(1);
-  }
-}
-
-function runUninstall() {
-  console.log('Uninstalling agentry CLI...');
-  try {
-    execSync('npm uninstall -g agentry', { stdio: 'inherit' });
-  } catch {
-    console.error('Uninstall failed. Try: npm uninstall -g agentry');
-    process.exit(1);
-  }
-}
-
-async function main() {
-  const { flags, positional } = parseArgs(process.argv.slice(2));
-
-  if (flags.version) return console.log(pkg.version);
-  if (flags.uninstall) return runUninstall();
-  if (flags.help || positional.length === 0) return console.log(HELP);
-
-  const [action] = positional;
-
-  if (action === 'update') return runUpdate();
-  if (action === 'list') return listSource(positional[1], positional[2]);
-
-  if (action === 'add') {
-    const type = positional[1];
-    if (!type) throw new Error('Missing type. e.g. agentry add skills author/repo');
-    if (type === 'profile') return addProfile(positional[2], positional[3], flags);
-    if (type !== 'all' && !reg.TYPES.includes(type)) throw new Error(`Unknown type: ${type}`);
-    return addType(type, positional[2], positional[3], flags);
-  }
-
-  if (action === 'remove') {
-    const type = positional[1];
-    if (!type) throw new Error('Missing type. e.g. agentry remove skills video/downloader');
-    if (type !== 'all' && !reg.TYPES.includes(type)) throw new Error(`Unknown type: ${type}`);
-    return remove(type, positional[2], flags);
-  }
-
-  console.error(`Unknown action: ${action}\n\n${HELP}`);
-  process.exit(1);
-}
-
-main().catch((err) => {
-  console.error(err.message || err);
-  process.exit(1);
-});

package/examples/agents/frontend/frontend-developer/AGENT.md

@@ -1,17 +0,0 @@
----
-name: frontend-developer
-description: >
-  Starter frontend developer agent — UI implementation, component structure,
-  accessibility, responsive layout, and visual polish. Edit for your project.
----
-
-# frontend-developer
-
-Example agent shipped with `agentry`. Use it as a starting point and adapt it to your stack.
-
-## Focus
-
-- Implement and refine UI components and layouts.
-- Prioritize accessibility, responsive design, and visual polish.
-- Reuse existing design patterns and tokens before introducing new ones.
-- Keep changes small and verifiable; prefer the simplest approach that works.

package/examples/agents/frontend/frontend-developer/agentry.json

@@ -1,5 +0,0 @@
-{
-  "name": "frontend-developer",
-  "type": "agents",
-  "description": "Starter frontend developer agent persona."
-}

package/examples/rules/workflow/ask-dont-guess/RULE.md

@@ -1,15 +0,0 @@
----
-name: ask-dont-guess
-description: >
-  Ask before guessing requirements or product truth. Act without asking only
-  when verified context already answers it. Prefer short, concrete questions.
----
-
-# ask-dont-guess
-
-Before writing code, changing architecture, or stating product facts, ask when anything is unclear, ambiguous, missing, or a "probably fine" default that would lock the project in.
-
-- Use short, concrete questions; multiple-choice is fine.
-- Do not invent missing specs.
-- When verified project context already answers it, proceed — do not re-ask settled facts.
-- When docs and code conflict, trust verified code and runtime evidence.

package/examples/rules/workflow/ask-dont-guess/agentry.json

@@ -1,5 +0,0 @@
-{
-  "name": "ask-dont-guess",
-  "type": "rules",
-  "description": "Ask before guessing requirements or product truth."
-}

package/examples/scripts/env/doctor/agentry.json

@@ -1,5 +0,0 @@
-{
-  "name": "doctor",
-  "type": "scripts",
-  "description": "Print a simple environment readiness check."
-}

package/examples/scripts/env/doctor/run.sh

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-# Starter script shipped with agentry. Prints a simple readiness check.
-set -euo pipefail
-echo "agentry: environment OK"

package/examples/skills/prompt/enhance-prompt/SKILL.md

@@ -1,186 +0,0 @@
----
-name: enhance-prompt
-description: >
-  Use when the user asks to enhance, improve, rewrite, optimize, or clarify a prompt —
-  or when always-on prompt enhancement is enabled for the session.
-  Rewrites casual or vague chat into precise, portable agent instructions
-  without injecting workspace paths, stack, or session-local context.
-  Preserves user-stated contracts; ranks related skills; asks clarifying /
-  mode / better-decision questions when needed; ends with an after-finish summary instruction.
----
-
-# enhance-prompt
-
-Rewrite the user’s message into a precise, portable agent prompt. **Enhance = clarify and structure — never strip user-stated details that affect accuracy.** Accuracy first; tokens second (same or better meaning, fewer tokens).
-
-Do **not** invent requirements or paste workspace-local paths/stack. For shape and examples, open [references/TEMPLATE.md](references/TEMPLATE.md).
-
-## Procedure
-
-Apply passes in order. Deliver one copy-ready enhanced prompt (or questions-first when blocked — see pass 0).
-
-### 0) Clarify, suggest, choose mode (ask before guessing)
-
-Before (or instead of) emitting a full enhanced prompt, ask when it improves accuracy.
-
-**Ask when:**
-
-- Critical details are missing (fields, success criteria, scope, must-nots)
-- A better / more optimal decision exists than what the user stated — propose it; don’t silently override
-- Approach is ambiguous (how to do X vs Y given what they wrote)
-- Depth / packing mode is unclear for a large task
-
-**How to ask:**
-
-- Prefer short multiple-choice or yes/no + one-line rationale
-- Suggest **better options** (optimal defaults) labeled as suggestions — user can reject
-- Ask **mode** when useful: `compact` | `standard` | `full` (see Depth dial)
-- Ask approach forks only when they change the result (e.g. auth vs unauth OTP purpose)
-- Cap: **MAX 3 questions** per turn (batch them). Don’t interrogate for niceties.
-- If the user said “just enhance” / “don’t ask” / always-on with enough signal → enhance without questions
-- Casual but clear enough → enhance; put residual ambiguity under **Open questions** for the implementer
-
-**Question-first output** (when blocked on critical gaps):
-
-1. Brief “what I understood”
-2. Up to 3 questions (include mode / better-decision suggestions when relevant)
-3. Optional mini draft only if helpful — still no path/stack injection
-
-After answers (or if not blocked), continue passes 1–8.
-
-### Depth dial
-
-| Mode | When | Behavior |
-|------|------|----------|
-| `compact` | User asks, or rich contract already dense | Densest packing; full contracts kept; minimal Steps |
-| `standard` | Default | Normal sections; Steps only if needed |
-| `full` | Large / multi-system task, or user asks | More Steps + verify detail; still no path/stack dumps |
-
-Same accuracy floor in all modes — only verbosity changes. If unset, use `standard` (or ask once when the task is large and mode would matter).
-
-### 1) Full-text enhance
-
-- Fix grammar, wording, clarity; prefer precise verbs.
-- Remove filler, noise symbols, decorative separators, emojis.
-- Preserve user intent and constraints; never invent requirements, brand systems, stack, or scope the user did not ask for.
-- **Do not rename** user field names (`phone` stays `phone`, not `phone-number`).
-
-### 2) Context policy (non-negotiable)
-
-**Prompt context must be portable and session-safe.**
-
-#### Always preserve (if present in the user input)
-
-Contracts — compressing them away makes results worse:
-
-- Endpoint lists, request/response bodies, field lists (e.g. `{ phone, password, code }`)
-- Remove / keep / replace lists
-- Security rules, do / don’t, acceptance criteria
-- Explicit open questions or ambiguities the user left unresolved
-- Any detail that changes implementation behavior
-
-**Enhance** = reorganize and tighten. **Not** = delete or “summarize away” those facts.
-
-**Rich input** → compress wording only; **copy contracts forward** (don’t rebuild from memory).  
-**Casual input** → add structure without inventing environment.
-
-#### Never inject
-
-- Absolute or relative project/workspace folder paths
-- Repo roots, home paths, machine-specific paths
-- Tech stack / framework / language lists the target workspace already provides via `AGENTS.md`, `context/`, rules, or open files
-- Long dumps of docs already loadable in the *target* workspace
-- Paths or facts from the *current* workspace when the prompt will be used elsewhere
-- Invented field names, status codes, or API shapes the user did not state
-- Silent “optimal” overrides the user didn’t accept (suggest via pass 0 instead)
-
-Rules of thumb:
-
-- Agent can read it from the target workspace → don’t paste paths/stack/docs.
-- User stated a contract → keep it densely (tables / one-liners OK).
-- Unsure if session-local → omit or `[use target workspace context]`.
-
-### 3) Structure / layout enhance
-
-Use only sections with content; drop empty ones. One structure. **One home per fact** (Contract = shapes; Constraints = must-not; Steps = order only).
-
-- **Title** — when helpful
-- **Goal** — success looks like
-- **Contract** (optional) — APIs / bodies / remove-keep; prefer compact packing
-- **Constraints** — must / must-not
-- **Steps** — only if order matters (omit in `compact` unless essential)
-- **Related skills** — pass 5
-- **Output** — deliverable format
-- **Open questions** — unresolved; “resolve from workspace — don’t guess”
-- **After you finish** — pass 6
-
-After drafting: **Goal ↔ Contract ↔ Constraints ↔ Steps must agree**.
-
-### 4) Token optimization + dedup
-
-- Same or better meaning, fewer tokens — **without dropping preserved contracts**.
-- Strip banners, redundant headers, fluff verbs.
-- Prefer short imperatives; pack field lists and endpoints as compact lines/tables.
-- **Dedup:** remove the same constraint repeated across Goal / Constraints / Steps; delete Steps that only restate Contract.
-
-### 5) Related skills (precision)
-
-Discover skills relevant to the prompt; attach **inside** the prompt.
-
-1. Search installed / project / agent skills (`npx skills list`, `AGENTS.md`, agent skills dirs). Prefer **target** environment.
-2. Rank by relevance to the goal; keep the **strongest** matches only (prefer ≤5).
-3. Each entry: name + one “use for …” tied to the goal. Optional: mark top 1–2 as “load first”.
-4. Skip weak / unrelated. Do not invent skill names.
-5. If none: omit section or `None found — proceed with workspace defaults.`
-
-### 6) After you finish (handoff summary instruction)
-
-End with **After you finish**: tell the *implementing* agent, once work is done, write a result summary that:
-
-- Anyone can understand (plain language)
-- Still detailed — what changed, added/removed, how to verify, what’s still open
-- Is **not** a prompt restatement or enhancer changelog
-
-Always include unless the user asked to omit post-work summaries.
-
-### 7) Ambiguity policy
-
-- Unclear but non-blocking → **Open questions** for the implementer; do not invent a default.
-- Blocking → return to pass 0 (ask). Never silently pick auth rules, field names, or modes the user didn’t state or accept.
-
-### 8) Fidelity checklist + silent self-eval (before emit)
-
-**Must pass before delivering the enhanced prompt:**
-
-- [ ] Every user field / body / endpoint preserved?
-- [ ] Every remove / keep preserved?
-- [ ] Goal ↔ Contract ↔ Steps agree?
-- [ ] No renamed fields; no invented stack / paths?
-- [ ] No silent override of user intent (suggestions only via asks)?
-- [ ] Deduped; depth mode respected?
-
-If any fail → fix once, then emit.
-
-Silently score 1–5: fidelity, portability, density. If fidelity < 5 → revise once. Don’t print scores unless asked.
-
-Optional chat-only enhancer changelog after the copy-ready block — omit if overloaded or user disabled it.
-
-## Always-on mode
-
-If the user asks to enhance every chat / every prompt:
-
-1. Create or update `AGENTS.md` in the **target** project.
-2. Add a **Skills** section: when-to-use vs always-use.
-3. Register `enhance-prompt` as always-on, e.g.:
-
-```yaml
-alwaysApply: true
-```
-
-Always-on: rewrite the user message into a better agent prompt **before** acting — still obey context policy and fidelity rules. Prefer enhancing over asking unless blocked on critical gaps (then ≤3 tight questions).
-
-## Output
-
-1. Either questions-first (pass 0) **or** one copy-ready enhanced prompt (Related skills when found + **After you finish**).
-2. Optional brief chat-only enhancer changelog outside that block.
-3. Do not announce skill usage unless the user asks.