@mhmdreza-rafiei/agentry 0.1.0 → 0.2.0

package/examples/skills/prompt/enhance-prompt/references/TEMPLATE.md

@@ -1,182 +0,0 @@
-# enhance-prompt — output template
-
-Enhance = clarify + structure. **Never strip user-stated contracts.** Never inject paths/stack. Ask (≤3) when blocked or when a better decision/mode would help — don’t silently override.
-
-## Correct output shape
-
-```markdown
-# <short title>
-
-## Goal
-<what success looks like>
-
-## Contract
-<optional — compact endpoint/body/remove-keep lines the user stated>
-
-## Constraints
-- <must / must-not — one home; don’t repeat Contract>
-
-## Steps
-1. <only if order matters>
-2. …
-
-## Related skills
-- `/skill-name` *(load first)* — use for <why tied to goal>
-- `/other` — use for <why>
-
-## Output
-<deliverable format>
-
-## Open questions
-- <resolve from workspace — don’t guess>
-
-## After you finish
-When the work is done, write a summary anyone can understand, while remaining detailed:
-- What changed (added/removed)
-- How to verify
-- Anything still open or risky
-```
-
-Omit empty sections. Respect depth dial: `compact` | `standard` | `full`.
-
----
-
-## Questions-first shape (pass 0)
-
-When critical gaps or better decisions/modes matter:
-
-```markdown
-## Understood
-<1–3 lines of intent>
-
-## Questions (max 3)
-1. **Mode:** run `compact` (densest), `standard` (default), or `full` (more steps/verify)? — suggestion: `standard` because <why>
-2. **Better decision:** you asked for X; Y is often safer/cleaner because <why>. Use **Y** or keep **X**?
-3. **Missing detail:** <field / success criteria / scope> — options A / B / C?
-
-Reply with choices; then I’ll emit the full enhanced prompt.
-```
-
-Do not invent stack/paths in questions. Don’t ask if the user said not to, or signal is already enough.
-
----
-
-## Example A — casual UI (standard)
-
-**In:** `Hey bro, the frontend look mid can you improve it?`
-
-**Out (right):**
-
-```markdown
-# Improve frontend UI quality
-
-## Goal
-Raise frontend visual quality so the first viewport and overall UI feel polished and intentional.
-
-## Constraints
-- Preserve existing behavior/content unless change is required for the visual fix
-- Do not invent brand, stack, or design language
-- Prefer target workspace design patterns when present
-- First viewport: brand signal, one headline, short support, CTA group, one dominant visual
-
-## Related skills
-- `/frontend-design` *(load first)* — layout and visual polish (if installed)
-
-## Output
-UI improvements in the target workspace.
-
-## After you finish
-Plain-language summary anyone can follow: what looked weak, what changed, how to check desktop and mobile.
-```
-
-**Wrong:** invent React/Tailwind paths under `/Users/...`.
-
----
-
-## Example B — ask mode + better decision (before enhance)
-
-**In:** `refactor auth otp stuff, make it better`
-
-**Questions-first (right):**
-
-```markdown
-## Understood
-You want an auth/OTP refactor toward a cleaner flow, but the target shape isn’t specified.
-
-## Questions (max 3)
-1. **Mode:** `compact`, `standard`, or `full`? — suggestion: `full` (multi-endpoint refactor).
-2. **Better decision:** collapse to `otp/request` → action endpoints (login | register | password-change) with OTP verified **inside** actions (no public verify)? Or keep a public verify step?
-3. **Register body:** if OTP is inside register, should the body be `{ phone, password, code }` (recommended) or something else you already use?
-
-Reply 1–3; then I’ll emit the enhanced prompt with contracts preserved.
-```
-
-**Wrong:** silently invent full API + FastAPI stack + `G:\Projects\...` without asking.
-
----
-
-## Example C — rich auth: preserve contracts (compact packing)
-
-**In (excerpt):** OTP verify internal; `otp/request` → action; register `{ phone, password, code }`; password-change like login + `new_password`; remove public verify + change/reset.
-
-**Wrong (diluted):**
-
-```markdown
-## Constraints
-- Register: accept phone-number and password only
-```
-
-**Right (`compact` / `standard`):**
-
-```markdown
-# Auth: OTP internal + collapse password APIs
-
-## Goal
-OTP verification is internal only. Public flow: otp/request → action (`login` | `register` | `password-change`). Remove public verify-OTP and separate change/reset password APIs.
-
-## Contract
-- `POST /auth/otp/request` — `{ phone, purpose }`
-- `POST /auth/login` — `{ phone, method, secret }`
-- `POST /auth/register` — `{ phone, password, code }`  ← OTP inside register
-- `POST /auth/password-change` — `{ phone, method, secret, new_password }`
-- Keep: refresh, logout
-- Remove: public verify-OTP; password change; password reset; otp_proof cookie register flow if present
-
-## Constraints
-- Verify-OTP stays internal — do not re-expose
-- Register: no `method`, no `secret`
-- `locale_pref`: prefer `localStorage`, else cookies
-- No invented auth fields/status/error shapes; use target workspace
-- Preserve existing security behavior unless user said otherwise
-- No path/stack paste — load from target workspace
-
-## Related skills
-- Rank ≤5 installed skills for auth / API / frontend / tests; mark top as load first
-
-## Output
-Backend + frontend matching Contract.
-
-## Open questions
-- Authenticated vs unauthenticated password-change: resolve OTP purpose / phone-vs-session from workspace — don’t guess
-
-## After you finish
-Plain + detailed summary: before→after flow, endpoints removed vs added (with shapes), how to verify (tests + results), anything still open.
-```
-
----
-
-## Example D — path / stack leak anti-pattern
-
-**Wrong:** `/home/ubuntu/...`, `/Users/dev/...`, “Stack: Next.js, Prisma…”, README dumps.
-
-**Right:** portable Goal/Contract/Constraints; `[use target workspace context]` if a pointer is needed.
-
----
-
-## Fidelity gate (before emit)
-
-- Fields/endpoints/remove-keep all present?
-- No renames (`phone` not `phone-number`)?
-- Goal ↔ Contract ↔ Steps agree?
-- No silent override (suggestions only via questions)?
-- Deduped; mode respected?

package/profile/backend.json

@@ -1,5 +0,0 @@
-{
-  "skills": ["prompt/enhance-prompt"],
-  "rules": ["workflow"],
-  "scripts": ["env/doctor"]
-}

package/profile/frontend.json

@@ -1,5 +0,0 @@
-{
-  "agents": ["frontend"],
-  "skills": ["prompt/enhance-prompt"],
-  "rules": ["workflow/ask-dont-guess"]
-}

package/src/commands.js

@@ -1,64 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-
-// Assets install under `<root>/.cursor/<type>/<category>/<name>`.
-// ponytail: single target dir (.cursor) for now; per-agent targets (.claude, .codex)
-// can be added later via a `target` field in each asset's agentry.json.
-function targetRoot({ global: isGlobal, dir } = {}) {
-  const base = isGlobal ? os.homedir() : dir || process.cwd();
-  return path.join(base, '.cursor');
-}
-
-function lockPath(root) {
-  return path.join(root, 'agentry.lock.json');
-}
-
-function readLock(root) {
-  try {
-    return JSON.parse(fs.readFileSync(lockPath(root), 'utf8'));
-  } catch {
-    return { version: 1, items: {} };
-  }
-}
-
-function writeLock(root, lock) {
-  fs.mkdirSync(root, { recursive: true });
-  fs.writeFileSync(lockPath(root), JSON.stringify(lock, null, 2) + '\n');
-}
-
-function installOne(asset, opts) {
-  const root = targetRoot(opts);
-  const dest = path.join(root, asset.type, asset.id);
-  fs.rmSync(dest, { recursive: true, force: true }); // idempotent re-install
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.cpSync(asset.dir, dest, { recursive: true });
-  const lock = readLock(root);
-  lock.items[`${asset.type}/${asset.id}`] = { installedAt: new Date().toISOString() };
-  writeLock(root, lock);
-  return dest;
-}
-
-// Removes a type, a category, or a single asset from the install target.
-// selector: undefined -> whole type; "category" -> category; "category/name" -> one asset.
-function removeSelection(type, selector, opts) {
-  const root = targetRoot(opts);
-  const rel = [type, selector].filter(Boolean).join('/');
-  const dest = path.join(root, rel);
-  const existed = fs.existsSync(dest);
-  fs.rmSync(dest, { recursive: true, force: true });
-  const lock = readLock(root);
-  const removedKeys = [];
-  for (const key of Object.keys(lock.items)) {
-    if (key === rel || key.startsWith(rel + '/')) {
-      delete lock.items[key];
-      removedKeys.push(key);
-    }
-  }
-  writeLock(root, lock);
-  return { existed, removedKeys };
-}
-
-module.exports = { targetRoot, lockPath, readLock, installOne, removeSelection };

package/src/profile.js

@@ -1,21 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-// Profiles are plain JSON under `<baseDir>/profile/<name>.json`, mapping each
-// asset type to a list of selectors, e.g.:
-//   { "repo": "author/repo", "skills": ["prompt/enhance-prompt"], "rules": ["workflow"] }
-// `repo` is optional; the command-line source (when given) takes precedence.
-function loadProfile(name, baseDir) {
-  const file = path.join(baseDir || process.cwd(), 'profile', `${name}.json`);
-  let cfg;
-  try {
-    cfg = JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    throw new Error(`Profile not found or invalid JSON: ${file}`);
-  }
-  return { file, cfg };
-}
-
-module.exports = { loadProfile };

package/src/registry.js

@@ -1,145 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-// Discovers assets inside a *source root* (a fetched repo or local path).
-// Two discovery modes, unioned:
-//   1) Under <type>/ :   <type>/<name>/  or  <type>/<category>/<name>/
-//   2) At the repo root (like `npx skills add`), classified by a marker file:
-//        <name>/SKILL.md            -> skills/<name>
-//        <group>/<name>/SKILL.md    -> skills/<group>/<name>
-//      (AGENT.md -> agents, RULE.md -> rules). Scripts have no root marker.
-const TYPES = ['agents', 'skills', 'rules', 'scripts'];
-const MARKERS = { skills: 'SKILL.md', agents: 'AGENT.md', rules: 'RULE.md', scripts: null };
-
-function readJson(file) {
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-function entries(dir) {
-  try {
-    return fs.readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-}
-
-function hasFile(dir) {
-  return entries(dir).some((e) => e.isFile());
-}
-
-function firstHeading(md) {
-  const m = md.match(/^#\s+(.+)$/m);
-  return m ? m[1].trim() : '';
-}
-
-function frontmatterDescription(md) {
-  const fm = md.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!fm) return '';
-  const lines = fm[1].split(/\r?\n/);
-  for (let i = 0; i < lines.length; i++) {
-    const dm = lines[i].match(/^description:\s*(.*)$/);
-    if (!dm) continue;
-    let val = dm[1].trim();
-    if (val === '' || val === '>' || val === '|' || val === '>-' || val === '|-') {
-      const collected = [];
-      for (let j = i + 1; j < lines.length; j++) {
-        if (/^\s+\S/.test(lines[j])) collected.push(lines[j].trim());
-        else break;
-      }
-      val = collected.join(' ');
-    }
-    return val.trim();
-  }
-  return '';
-}
-
-function assetDescription(dir) {
-  const cfg = readJson(path.join(dir, 'agentry.json'));
-  if (cfg && cfg.description) return cfg.description;
-  for (const f of ['SKILL.md', 'AGENT.md', 'RULE.md', 'README.md']) {
-    const p = path.join(dir, f);
-    if (!fs.existsSync(p)) continue;
-    const md = fs.readFileSync(p, 'utf8');
-    const d = frontmatterDescription(md) || firstHeading(md);
-    if (d) return d;
-  }
-  return '';
-}
-
-function hasMarker(dir, marker) {
-  return !!marker && fs.existsSync(path.join(dir, marker));
-}
-
-function makeAsset(type, category, name, dir) {
-  const id = category ? `${category}/${name}` : name;
-  return { type, category, name, id, dir, description: assetDescription(dir) };
-}
-
-// Assets living under an explicit <type>/ folder (this repo's own convention).
-function collectFromTypeDir(base, type, out) {
-  for (const child of entries(base)) {
-    if (!child.isDirectory()) continue;
-    const childDir = path.join(base, child.name);
-    if (hasFile(childDir)) {
-      out.push(makeAsset(type, null, child.name, childDir));
-    } else {
-      for (const item of entries(childDir)) {
-        if (!item.isDirectory()) continue;
-        out.push(makeAsset(type, child.name, item.name, path.join(childDir, item.name)));
-      }
-    }
-  }
-}
-
-// Assets at the repo root, identified by marker file (e.g. SKILL.md).
-function collectFromRoot(root, type, marker, out) {
-  if (!marker) return;
-  for (const child of entries(root)) {
-    if (!child.isDirectory()) continue;
-    if (child.name.startsWith('.') || child.name === 'node_modules' || TYPES.includes(child.name)) continue;
-    const childDir = path.join(root, child.name);
-    if (hasMarker(childDir, marker)) {
-      out.push(makeAsset(type, null, child.name, childDir));
-    } else {
-      for (const item of entries(childDir)) {
-        if (item.isDirectory() && hasMarker(path.join(childDir, item.name), marker)) {
-          out.push(makeAsset(type, child.name, item.name, path.join(childDir, item.name)));
-        }
-      }
-    }
-  }
-}
-
-function listType(root, type) {
-  const out = [];
-  const base = path.join(root, type);
-  if (fs.existsSync(base)) collectFromTypeDir(base, type, out);
-  collectFromRoot(root, type, MARKERS[type], out);
-  const seen = new Set();
-  return out
-    .filter((a) => (seen.has(a.id) ? false : seen.add(a.id)))
-    .sort((a, b) => a.id.localeCompare(b.id));
-}
-
-function allAssets(root) {
-  return TYPES.flatMap((t) => listType(root, t));
-}
-
-// selector: undefined -> whole type; "category/name" -> one asset;
-// "category" -> whole category; bare name -> fallback exact-name match.
-function select(root, type, selector) {
-  const items = listType(root, type);
-  if (!selector) return items;
-  if (selector.includes('/')) return items.filter((a) => a.id === selector);
-  const byCategory = items.filter((a) => a.category === selector);
-  if (byCategory.length) return byCategory;
-  return items.filter((a) => a.name === selector);
-}
-
-module.exports = { TYPES, listType, allAssets, select };

package/src/source.js

@@ -1,52 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-const { execFileSync } = require('node:child_process');
-
-function isLocalPath(source) {
-  return (
-    source.startsWith('.') ||
-    source.startsWith('/') ||
-    source.startsWith('~') ||
-    fs.existsSync(source)
-  );
-}
-
-// Accepts a full git URL or the "author/repo" GitHub shorthand.
-function toGitUrl(source) {
-  if (/^https?:\/\//.test(source) || source.startsWith('git@')) return source;
-  if (/^[\w.-]+\/[\w.-]+$/.test(source)) return `https://github.com/${source}.git`;
-  return null;
-}
-
-// Resolves a source (local path | author/repo | git URL) to a local root.
-// Remote sources are shallow-cloned to a temp dir; call cleanup() when done.
-function resolveSource(source) {
-  if (isLocalPath(source)) {
-    const root = path.resolve(source.replace(/^~/, os.homedir()));
-    if (!fs.existsSync(root)) throw new Error(`Path not found: ${source}`);
-    return { root, cleanup() {} };
-  }
-  const url = toGitUrl(source);
-  if (!url) throw new Error(`Cannot resolve source "${source}". Use a local path, author/repo, or git URL.`);
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'agentry-src-'));
-  try {
-    execFileSync('git', ['clone', '--depth', '1', '--quiet', url, tmp], {
-      stdio: ['ignore', 'ignore', 'pipe'],
-    });
-  } catch (e) {
-    fs.rmSync(tmp, { recursive: true, force: true });
-    const detail = e.stderr ? e.stderr.toString().trim() : e.message;
-    throw new Error(`git clone failed for ${url}\n${detail}`);
-  }
-  return {
-    root: tmp,
-    cleanup() {
-      fs.rmSync(tmp, { recursive: true, force: true });
-    },
-  };
-}
-
-module.exports = { isLocalPath, toGitUrl, resolveSource };