@rbbtsn0w/adg 0.1.0-alpha.1 → 0.1.0-beta.2

package/dist/src/sources.js

@@ -0,0 +1,122 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { readManifest, findManifestFile } from "./manifest.js";
+const GH_SHORTHAND = /^([\w.-]+)\/([\w.-]+?)(?:@(.+))?$/;
+const GH_URL = /^(?:https?:\/\/github\.com\/|git@github\.com:)([\w.-]+)\/([\w.-]+?)(?:\.git)?(?:@(.+))?$/;
+/**
+ * Parse an install spec into a local directory or a GitHub source.
+ *
+ * An existing local directory always wins; otherwise the spec is matched
+ * against `owner/repo[@ref]` shorthand or a github.com URL.
+ */
+export function parseSource(spec) {
+    if (existsSync(spec))
+        return { kind: "local", dir: spec };
+    const url = spec.match(GH_URL);
+    if (url) {
+        const [, owner, repo, ref] = url;
+        return gh(owner, repo, ref);
+    }
+    const short = spec.match(GH_SHORTHAND);
+    if (short) {
+        const [, owner, repo, ref] = short;
+        return gh(owner, repo, ref);
+    }
+    throw new Error(`cannot parse install source: "${spec}" (expected a local path or owner/repo[@ref])`);
+}
+function gh(owner, repo, ref) {
+    return {
+        kind: "github",
+        source: `${owner}/${repo}`,
+        owner,
+        repo,
+        ref,
+        sourceUrl: `https://github.com/${owner}/${repo}.git`,
+    };
+}
+/**
+ * Shallow-clone a GitHub source into `dest`, optionally restricting the working
+ * tree to `sparse` sub-paths (cone-mode sparse checkout) for large monorepos.
+ * The git runner is injectable so the flow can be exercised offline in tests.
+ */
+export function cloneGitHub(src, dest, opts = {}) {
+    const runner = opts.runner ?? defaultGitRunner;
+    const sparse = opts.sparse?.filter(Boolean) ?? [];
+    const clone = ["clone", "--depth", "1"];
+    if (src.ref)
+        clone.push("--branch", src.ref);
+    if (sparse.length > 0)
+        clone.push("--filter=blob:none", "--sparse");
+    clone.push(src.sourceUrl, dest);
+    runner(clone);
+    if (sparse.length > 0) {
+        runner(["-C", dest, "sparse-checkout", "set", ...sparse]);
+    }
+    return dest;
+}
+const defaultGitRunner = (args) => {
+    execFileSync("git", args, { stdio: "pipe" });
+};
+/**
+ * Recursively find ADG plugins under `root` (directories containing
+ * `.agents/.plugin.json`, or the legacy `.adg-plugin/plugin.json`), keyed by
+ * manifest name. Used as the resolution universe for dependency ordering.
+ */
+export function scanPlugins(root) {
+    const found = new Map();
+    walk(root, root, found);
+    return found;
+}
+function walk(root, current, out) {
+    if (findManifestFile(current)) {
+        const manifest = readManifest(current);
+        if (!out.has(manifest.name))
+            out.set(manifest.name, { dir: current, manifest });
+        return; // do not descend into a plugin directory
+    }
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name === ".git" || entry.name === "node_modules")
+            continue;
+        walk(root, join(current, entry.name), out);
+    }
+}
+export const CODEX_MANIFEST_PATH = join(".codex-plugin", "plugin.json");
+export const CLAUDE_MANIFEST_PATH = join(".claude-plugin", "plugin.json");
+/**
+ * Recursively find plugin directories under `root`, recognizing ADG, Codex and
+ * Claude manifests. Used by `import` to discover existing plugins to convert.
+ */
+export function scanNativePlugins(root) {
+    const found = [];
+    walkNative(root, found);
+    return found;
+}
+function walkNative(current, out) {
+    // Resolution priority: canonical .agents/.plugin.json first, then Claude, then
+    // Codex. Only matters when a single dir exposes more than one manifest.
+    const adg = findManifestFile(current);
+    const claude = join(current, CLAUDE_MANIFEST_PATH);
+    const codex = join(current, CODEX_MANIFEST_PATH);
+    if (adg) {
+        out.push({ dir: current, kind: "adg", manifestFile: adg });
+        return;
+    }
+    if (existsSync(claude)) {
+        out.push({ dir: current, kind: "anthropic", manifestFile: claude });
+        return;
+    }
+    if (existsSync(codex)) {
+        out.push({ dir: current, kind: "openai", manifestFile: codex });
+        return;
+    }
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name === ".git" || entry.name === "node_modules")
+            continue;
+        walkNative(join(current, entry.name), out);
+    }
+}

package/dist/src/types.js

@@ -0,0 +1,19 @@
+/**
+ * ADG type definitions mirroring the JSON Schemas under ../schemas.
+ */
+export const ADG_SCHEMA_VERSION = "adg.plugin/v1";
+export const LOCK_VERSION = 2;
+/** The component categories a plugin can expose. */
+export const COMPONENT_TYPES = ["skills", "agents", "commands", "mcp", "hooks", "apps"];
+/** Structural equality for provenance/source comparison (collision checks). */
+export function sameSource(a, b) {
+    if (a.type !== b.type)
+        return false;
+    if (a.type === "local" && b.type === "local")
+        return a.path === b.path;
+    if (a.type === "github" && b.type === "github")
+        return a.repo === b.repo && a.path === b.path;
+    if (a.type === "git" && b.type === "git")
+        return a.url === b.url && a.path === b.path;
+    return false;
+}

package/dist/vendor/skills/package.json

@@ -0,0 +1,143 @@
+{
+    "name": "skills",
+    "version": "1.5.11",
+    "description": "The open agent skills ecosystem",
+    "type": "module",
+    "bin": {
+        "skills": "./bin/cli.mjs",
+        "add-skill": "./bin/cli.mjs"
+    },
+    "files": [
+        "dist",
+        "bin",
+        "README.md",
+        "ThirdPartyNoticeText.txt"
+    ],
+    "scripts": {
+        "build": "node scripts/generate-licenses.ts && obuild",
+        "generate-licenses": "node scripts/generate-licenses.ts",
+        "dev": "node src/cli.ts",
+        "exec:test": "node scripts/execute-tests.ts",
+        "prepublishOnly": "npm run build",
+        "format": "prettier --write \"src/**/*.ts\" \"scripts/**/*.ts\"",
+        "format:check": "prettier --check \"src/**/*.ts\" \"scripts/**/*.ts\"",
+        "prepare": "husky",
+        "test": "vitest",
+        "type-check": "tsc --noEmit",
+        "publish:snapshot": "npm version prerelease --preid=snapshot --no-git-tag-version && npm publish --tag snapshot"
+    },
+    "lint-staged": {
+        "src/**/*.ts": "prettier --write",
+        "scripts/**/*.ts": "prettier --write",
+        "tests/**/*.ts": "prettier --write"
+    },
+    "keywords": [
+        "cli",
+        "agent-skills",
+        "skills",
+        "ai-agents",
+        "aider-desk",
+        "amp",
+        "antigravity",
+        "antigravity-cli",
+        "astrbot",
+        "autohand-code",
+        "augment",
+        "bob",
+        "claude-code",
+        "openclaw",
+        "cline",
+        "codearts-agent",
+        "codebuddy",
+        "codemaker",
+        "codestudio",
+        "codex",
+        "command-code",
+        "continue",
+        "cortex",
+        "crush",
+        "cursor",
+        "deepagents",
+        "devin",
+        "dexto",
+        "droid",
+        "firebender",
+        "forgecode",
+        "gemini-cli",
+        "github-copilot",
+        "goose",
+        "hermes-agent",
+        "inference-sh",
+        "jazz",
+        "junie",
+        "iflow-cli",
+        "kilo",
+        "kimi-code-cli",
+        "kiro-cli",
+        "kode",
+        "lingma",
+        "loaf",
+        "mcpjam",
+        "mistral-vibe",
+        "moxby",
+        "mux",
+        "opencode",
+        "openhands",
+        "ona",
+        "pi",
+        "qoder",
+        "qoder-cn",
+        "qwen-code",
+        "replit",
+        "reasonix",
+        "rovodev",
+        "roo",
+        "tabnine-cli",
+        "terramind",
+        "tinycloud",
+        "trae",
+        "trae-cn",
+        "warp",
+        "windsurf",
+        "zed",
+        "zencoder",
+        "zenflow",
+        "neovate",
+        "pochi",
+        "promptscript",
+        "adal",
+        "universal"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/vercel-labs/skills.git"
+    },
+    "homepage": "https://github.com/vercel-labs/skills#readme",
+    "bugs": {
+        "url": "https://github.com/vercel-labs/skills/issues"
+    },
+    "author": "",
+    "license": "MIT",
+    "devDependencies": {
+        "@clack/prompts": "^0.11.0",
+        "@types/bun": "latest",
+        "@types/node": "^22.10.0",
+        "@vercel/detect-agent": "^1.2.1",
+        "husky": "^9.1.7",
+        "lint-staged": "^16.2.7",
+        "obuild": "^0.4.22",
+        "picocolors": "^1.1.1",
+        "prettier": "^3.8.1",
+        "simple-git": "^3.27.0",
+        "typescript": "^5.9.3",
+        "vitest": "^4.0.17",
+        "xdg-basedir": "^5.1.0"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "packageManager": "pnpm@10.17.1",
+    "dependencies": {
+        "yaml": "^2.8.3"
+    }
+}