@sentry/dotagents 0.2.0

package/README.md

@@ -0,0 +1,96 @@
+# dotagents
+
+A package manager for `.agents` directories. Declare agent skill dependencies in `agents.toml`, lock versions for reproducibility, and let every tool on your team discover skills from a single place.
+
+## Why dotagents?
+
+**One source of truth.** Skills live in `.agents/skills/` and symlink into `.claude/skills/`, `.cursor/skills/`, or wherever your tools expect them. No copy-pasting between directories.
+
+**Reproducible.** `agents.lock` pins exact commits and integrity hashes. `dotagents install --frozen` in CI guarantees everyone runs the same skills.
+
+**Shareable.** Skills are just directories with a `SKILL.md`. Host them in any git repo, discover them automatically, install with one command.
+
+## Quick Start
+
+```bash
+# Initialize a new project
+npx dotagents init
+
+# Add a skill from a GitHub repo
+npx dotagents add getsentry/skills --name find-bugs
+
+# Install all declared skills
+npx dotagents install
+```
+
+This creates an `agents.toml`:
+
+```toml
+version = 1
+gitignore = false
+
+[[skills]]
+name = "find-bugs"
+source = "getsentry/skills"
+```
+
+And a lockfile (`agents.lock`) pinning the exact commit and integrity hash.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `dotagents init` | Create `agents.toml` and `.agents/skills/` |
+| `dotagents add <source>` | Add a skill dependency |
+| `dotagents remove <name>` | Remove a skill |
+| `dotagents install` | Install all dependencies from `agents.toml` |
+| `dotagents update [name]` | Update skills to latest versions |
+| `dotagents list` | Show installed skills and their status |
+| `dotagents sync` | Reconcile gitignore, symlinks, and verify state |
+
+## Source Formats
+
+```toml
+[[skills]]
+name = "find-bugs"
+source = "getsentry/skills"              # GitHub repo (auto-discover)
+
+[[skills]]
+name = "review"
+source = "getsentry/skills@v1.0.0"       # Pinned to a ref
+
+[[skills]]
+name = "internal"
+source = "git:https://git.corp.dev/repo"  # Non-GitHub git
+
+[[skills]]
+name = "local"
+source = "path:./my-skills/local-skill"   # Local directory
+```
+
+## How It Works
+
+1. Skills are declared in `agents.toml` at the project root
+2. `dotagents install` clones repos, discovers skills by convention, and copies them into `.agents/skills/`
+3. `agents.lock` records the resolved commit and a SHA-256 integrity hash
+4. By default (`gitignore = false`), skills are checked into git so collaborators get them immediately. Set `gitignore = true` to auto-generate `.agents/.gitignore` and exclude managed skills instead.
+5. Symlinks connect `.agents/skills/` to wherever your tools look (configured via `symlinks.targets`)
+
+## Checking In Skills
+
+By default, `dotagents init` sets `gitignore = false` so installed skills are committed to git. This means anyone cloning the repo gets skills immediately — they only need dotagents when adding or updating skills.
+
+To gitignore managed skills instead (collaborators must run `dotagents install`), set `gitignore = true` in `agents.toml` or remove the field entirely (it defaults to `true` when absent for backward compatibility).
+
+## Contributing
+
+```bash
+git clone git@github.com:getsentry/dotagents.git
+cd dotagents
+pnpm install
+pnpm check  # lint + typecheck + test
+```
+
+## License
+
+MIT

package/dist/cli/commands/add.d.ts

@@ -0,0 +1,12 @@
+export declare class AddError extends Error {
+    constructor(message: string);
+}
+export interface AddOptions {
+    projectRoot: string;
+    specifier: string;
+    ref?: string;
+    name?: string;
+}
+export declare function runAdd(opts: AddOptions): Promise<string>;
+export default function add(args: string[]): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/cli/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"AAUA,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA6F9D;AAED,wBAA8B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC/D"}

package/dist/cli/commands/add.js

@@ -0,0 +1,127 @@
+import { join } from "node:path";
+import { parseArgs } from "node:util";
+import chalk from "chalk";
+import { loadConfig } from "../../config/loader.js";
+import { addSkillToConfig } from "../../config/writer.js";
+import { parseSource, resolveSkill } from "../../skills/resolver.js";
+import { discoverAllSkills } from "../../skills/discovery.js";
+import { ensureCached } from "../../sources/cache.js";
+import { runInstall } from "./install.js";
+export class AddError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AddError";
+    }
+}
+export async function runAdd(opts) {
+    const { projectRoot, specifier, ref, name: nameOverride } = opts;
+    const configPath = join(projectRoot, "agents.toml");
+    // Parse the specifier
+    const parsed = parseSource(specifier);
+    // Determine ref (flag overrides inline @ref)
+    const effectiveRef = ref ?? parsed.ref;
+    // For git sources, resolve to discover the skill name
+    let skillName;
+    if (parsed.type === "local") {
+        // Local source — resolve and read SKILL.md for the name
+        const resolved = await resolveSkill(nameOverride ?? "unknown", { source: specifier }, { projectRoot });
+        if (resolved.type !== "local")
+            throw new AddError("Unexpected resolve type for local source");
+        const { loadSkillMd } = await import("../../skills/loader.js");
+        const { join: pathJoin } = await import("node:path");
+        const meta = await loadSkillMd(pathJoin(resolved.skillDir, "SKILL.md"));
+        skillName = nameOverride ?? meta.name;
+    }
+    else {
+        // Git source — clone and discover
+        const url = parsed.url;
+        const cacheKey = parsed.type === "github"
+            ? `${parsed.owner}/${parsed.repo}`
+            : url.replace(/^https?:\/\//, "").replace(/\.git$/, "");
+        const cached = await ensureCached({ url, cacheKey, ref: effectiveRef });
+        if (nameOverride) {
+            // User specified name, verify it exists
+            const { discoverSkill } = await import("../../skills/discovery.js");
+            const found = await discoverSkill(cached.repoDir, nameOverride);
+            if (!found) {
+                throw new AddError(`Skill "${nameOverride}" not found in ${specifier}. ` +
+                    `Use 'dotagents add ${specifier}' without --name to see available skills.`);
+            }
+            skillName = nameOverride;
+        }
+        else {
+            // Discover all skills and pick
+            const skills = await discoverAllSkills(cached.repoDir);
+            if (skills.length === 0) {
+                throw new AddError(`No skills found in ${specifier}.`);
+            }
+            if (skills.length === 1) {
+                skillName = skills[0].meta.name;
+            }
+            else {
+                // Multiple skills found — for now, list them and ask user to pick with --name
+                const names = skills.map((s) => s.meta.name).sort();
+                throw new AddError(`Multiple skills found in ${specifier}: ${names.join(", ")}. ` +
+                    `Use --name to specify which one.`);
+            }
+        }
+    }
+    // Check if skill already exists in config
+    const config = await loadConfig(configPath);
+    if (config.skills.some((s) => s.name === skillName)) {
+        throw new AddError(`Skill "${skillName}" already exists in agents.toml. Remove it first or use 'dotagents update'.`);
+    }
+    // Build the source string for agents.toml
+    let source = specifier;
+    // If ref was provided inline (@ref), strip it from source since we'll use the ref field
+    if (parsed.ref && !ref) {
+        // Inline ref — keep it in source as-is
+    }
+    else if (effectiveRef && !specifier.includes("@")) {
+        // Ref from --ref flag, not inline
+    }
+    // Add to config
+    await addSkillToConfig(configPath, skillName, {
+        source,
+        ...(effectiveRef ? { ref: effectiveRef } : {}),
+    });
+    // Run install to actually fetch and place the skill
+    await runInstall({ projectRoot });
+    return skillName;
+}
+export default async function add(args) {
+    const { positionals, values } = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            ref: { type: "string" },
+            name: { type: "string" },
+        },
+        strict: true,
+    });
+    const specifier = positionals[0];
+    if (!specifier) {
+        console.error(chalk.red("Usage: dotagents add <specifier> [--ref <ref>] [--name <name>]"));
+        process.exitCode = 1;
+        return;
+    }
+    const { resolve } = await import("node:path");
+    try {
+        const name = await runAdd({
+            projectRoot: resolve("."),
+            specifier,
+            ref: values["ref"],
+            name: values["name"],
+        });
+        console.log(chalk.green(`Added skill: ${name}`));
+    }
+    catch (err) {
+        if (err instanceof AddError) {
+            console.error(chalk.red(err.message));
+            process.exitCode = 1;
+            return;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/cli/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../src/cli/commands/add.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,10 @@
+export interface InitOptions {
+    force?: boolean;
+    projectRoot: string;
+}
+export declare function runInit(opts: InitOptions): Promise<void>;
+export declare class InitError extends Error {
+    constructor(message: string);
+}
+export default function init(args: string[]): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B9D;AAoCD,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAA8B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhE"}

package/dist/cli/commands/init.js

@@ -0,0 +1,81 @@
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import { generateDefaultConfig } from "../../config/writer.js";
+import { updateAgentsGitignore } from "../../gitignore/writer.js";
+import { ensureSkillsSymlink } from "../../symlinks/manager.js";
+import { loadConfig } from "../../config/loader.js";
+import { parseArgs } from "node:util";
+export async function runInit(opts) {
+    const { projectRoot, force } = opts;
+    const configPath = join(projectRoot, "agents.toml");
+    const agentsDir = join(projectRoot, ".agents");
+    const skillsDir = join(agentsDir, "skills");
+    if (existsSync(configPath) && !force) {
+        throw new InitError("agents.toml already exists. Use --force to overwrite.");
+    }
+    await writeFile(configPath, generateDefaultConfig(), "utf-8");
+    await mkdir(skillsDir, { recursive: true });
+    // Set up gitignore and symlinks based on config
+    const config = await loadConfig(configPath);
+    await updateAgentsGitignore(agentsDir, config.gitignore, []);
+    const targets = config.symlinks?.targets ?? [];
+    const symlinkResults = [];
+    for (const target of targets) {
+        const targetDir = join(projectRoot, target);
+        const result = await ensureSkillsSymlink(agentsDir, targetDir);
+        symlinkResults.push({ target, ...result });
+    }
+    return printSummary(config.gitignore, symlinkResults);
+}
+function printSummary(gitignore, symlinks) {
+    // eslint-disable-next-line no-console
+    console.log(chalk.green("Created agents.toml"));
+    // eslint-disable-next-line no-console
+    console.log(chalk.green("Created .agents/skills/"));
+    if (gitignore) {
+        // eslint-disable-next-line no-console
+        console.log(chalk.green("Created .agents/.gitignore"));
+    }
+    for (const s of symlinks) {
+        if (s.created) {
+            // eslint-disable-next-line no-console
+            console.log(chalk.green(`Created symlink: ${s.target}/skills/ → .agents/skills/`));
+        }
+        if (s.migrated.length > 0) {
+            // eslint-disable-next-line no-console
+            console.log(chalk.yellow(`Migrated ${s.migrated.length} skill(s) from ${s.target}/skills/ to .agents/skills/`));
+        }
+    }
+    // eslint-disable-next-line no-console
+    console.log(`\n${chalk.bold("Next steps:")}\n  1. Add skills: dotagents add @anthropics/pdf-processing\n  2. Install: dotagents install`);
+}
+export class InitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InitError";
+    }
+}
+export default async function init(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            force: { type: "boolean" },
+        },
+        strict: true,
+    });
+    const { resolve } = await import("node:path");
+    try {
+        await runInit({ projectRoot: resolve("."), force: values["force"] });
+    }
+    catch (err) {
+        if (err instanceof InitError) {
+            console.error(chalk.red(err.message));
+            process.exitCode = 1;
+            return;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAOtC,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE5C,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACrC,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,SAAS,CAAC,UAAU,EAAE,qBAAqB,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,gDAAgD;IAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,qBAAqB,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC;IAC/C,MAAM,cAAc,GAA+D,EAAE,CAAC;IAEtF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/D,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,YAAY,CACnB,SAAkB,EAClB,QAAoE;IAEpE,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAChD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACd,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,MAAM,4BAA4B,CAAC,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,sCAAsC;YACtC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CACV,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,kBAAkB,CAAC,CAAC,MAAM,6BAA6B,CACrF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,8FAA8F,CAC7H,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc;IAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI;QACJ,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;SAC3B;QACD,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YACtC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/cli/commands/init.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=init.test.d.ts.map

package/dist/cli/commands/init.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.test.ts"],"names":[],"mappings":""}

package/dist/cli/commands/init.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtemp, rm, writeFile, lstat, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { existsSync } from "node:fs";
+import { runInit, InitError } from "./init.js";
+import { loadConfig } from "../../config/loader.js";
+describe("runInit", () => {
+    let dir;
+    beforeEach(async () => {
+        dir = await mkdtemp(join(tmpdir(), "dotagents-init-test-"));
+    });
+    afterEach(async () => {
+        await rm(dir, { recursive: true });
+    });
+    it("creates agents.toml in project root", async () => {
+        await runInit({ projectRoot: dir });
+        const config = await loadConfig(join(dir, "agents.toml"));
+        expect(config.version).toBe(1);
+        expect(config.skills).toEqual([]);
+    });
+    it("creates .agents/skills/ directory", async () => {
+        await runInit({ projectRoot: dir });
+        const stat = await lstat(join(dir, ".agents", "skills"));
+        expect(stat.isDirectory()).toBe(true);
+    });
+    it("does not create .agents/.gitignore with default config (gitignore = false)", async () => {
+        await runInit({ projectRoot: dir });
+        expect(existsSync(join(dir, ".agents", ".gitignore"))).toBe(false);
+    });
+    it("throws InitError if agents.toml exists without --force", async () => {
+        await writeFile(join(dir, "agents.toml"), "version = 1\n");
+        await expect(runInit({ projectRoot: dir })).rejects.toThrow(InitError);
+        await expect(runInit({ projectRoot: dir })).rejects.toThrow("agents.toml already exists");
+    });
+    it("overwrites agents.toml with --force", async () => {
+        await writeFile(join(dir, "agents.toml"), "garbage content");
+        await runInit({ projectRoot: dir, force: true });
+        const config = await loadConfig(join(dir, "agents.toml"));
+        expect(config.version).toBe(1);
+    });
+    it("is idempotent with --force", async () => {
+        await runInit({ projectRoot: dir });
+        await runInit({ projectRoot: dir, force: true });
+        const config = await loadConfig(join(dir, "agents.toml"));
+        expect(config.version).toBe(1);
+        expect(existsSync(join(dir, ".agents", "skills"))).toBe(true);
+    });
+    it("does not create symlinks with default config", async () => {
+        await runInit({ projectRoot: dir });
+        // Default config has no symlinks configured, so .claude should not exist
+        expect(existsSync(join(dir, ".claude"))).toBe(false);
+    });
+    it("creates all expected files and directories", async () => {
+        await runInit({ projectRoot: dir });
+        expect(existsSync(join(dir, "agents.toml"))).toBe(true);
+        expect(existsSync(join(dir, ".agents"))).toBe(true);
+        expect(existsSync(join(dir, ".agents", "skills"))).toBe(true);
+        // Default config has gitignore = false, so no .gitignore is created
+        expect(existsSync(join(dir, ".agents", ".gitignore"))).toBe(false);
+    });
+    it("preserves existing .agents/skills/ contents", async () => {
+        const { mkdir, writeFile: wf } = await import("node:fs/promises");
+        await mkdir(join(dir, ".agents", "skills", "my-skill"), { recursive: true });
+        await wf(join(dir, ".agents", "skills", "my-skill", "SKILL.md"), "# test");
+        await runInit({ projectRoot: dir });
+        const entries = await readdir(join(dir, ".agents", "skills"));
+        expect(entries).toContain("my-skill");
+    });
+});
+//# sourceMappingURL=init.test.js.map

package/dist/cli/commands/init.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.test.js","sourceRoot":"","sources":["../../../src/cli/commands/init.test.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,15 @@
+export declare class InstallError extends Error {
+    constructor(message: string);
+}
+export interface InstallOptions {
+    projectRoot: string;
+    frozen?: boolean;
+    force?: boolean;
+}
+export interface InstallResult {
+    installed: string[];
+    skipped: string[];
+}
+export declare function runInstall(opts: InstallOptions): Promise<InstallResult>;
+export default function install(args: string[]): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/cli/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"AAgBA,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAiH7E;AAED,wBAA8B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnE"}

package/dist/cli/commands/install.js

@@ -0,0 +1,139 @@
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { parseArgs } from "node:util";
+import chalk from "chalk";
+import { loadConfig } from "../../config/loader.js";
+import { loadLockfile } from "../../lockfile/loader.js";
+import { writeLockfile } from "../../lockfile/writer.js";
+import { isGitLocked } from "../../lockfile/schema.js";
+import { resolveSkill } from "../../skills/resolver.js";
+import { hashDirectory } from "../../utils/hash.js";
+import { copyDir } from "../../utils/fs.js";
+import { updateAgentsGitignore } from "../../gitignore/writer.js";
+import { ensureSkillsSymlink } from "../../symlinks/manager.js";
+export class InstallError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InstallError";
+    }
+}
+export async function runInstall(opts) {
+    const { projectRoot, frozen, force } = opts;
+    const configPath = join(projectRoot, "agents.toml");
+    const lockPath = join(projectRoot, "agents.lock");
+    const agentsDir = join(projectRoot, ".agents");
+    const skillsDir = join(agentsDir, "skills");
+    // 1. Read config
+    const config = await loadConfig(configPath);
+    const skillNames = config.skills.map((s) => s.name);
+    if (skillNames.length === 0) {
+        console.log(chalk.dim("No skills declared in agents.toml."));
+        return { installed: [], skipped: [] };
+    }
+    // 2. Read lockfile
+    const lockfile = await loadLockfile(lockPath);
+    if (frozen && !lockfile) {
+        throw new InstallError("--frozen requires agents.lock to exist.");
+    }
+    if (frozen) {
+        // Verify all skills are in lockfile
+        for (const name of skillNames) {
+            if (!lockfile.skills[name]) {
+                throw new InstallError(`--frozen: skill "${name}" is in agents.toml but missing from agents.lock.`);
+            }
+        }
+    }
+    // 3. Ensure directories exist
+    await mkdir(skillsDir, { recursive: true });
+    // 4. Resolve and install each skill
+    const newLock = { version: 1, skills: {} };
+    const installed = [];
+    const skipped = [];
+    for (const name of skillNames) {
+        const dep = config.skills.find((s) => s.name === name);
+        const locked = lockfile?.skills[name];
+        // If locked and not forced, use the locked commit
+        const lockedCommit = !force && locked && isGitLocked(locked) ? locked.commit : undefined;
+        let resolved;
+        try {
+            resolved = await resolveSkill(name, dep, {
+                projectRoot,
+                lockedCommit,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new InstallError(`Failed to resolve skill "${name}": ${msg}`);
+        }
+        // Copy skill into .agents/skills/<name>/
+        const destDir = join(skillsDir, name);
+        await copyDir(resolved.skillDir, destDir);
+        // Compute integrity hash
+        const integrity = await hashDirectory(destDir);
+        // Frozen mode: verify integrity matches lockfile
+        if (frozen && locked) {
+            if (locked.integrity !== integrity) {
+                throw new InstallError(`--frozen: integrity mismatch for "${name}". ` +
+                    `Expected ${locked.integrity}, got ${integrity}.`);
+            }
+        }
+        // Build lock entry
+        const lockEntry = resolved.type === "git"
+            ? {
+                source: dep.source,
+                resolved_url: resolved.resolvedUrl,
+                resolved_path: resolved.resolvedPath,
+                ...(resolved.resolvedRef ? { resolved_ref: resolved.resolvedRef } : {}),
+                commit: resolved.commit,
+                integrity,
+            }
+            : {
+                source: dep.source,
+                integrity,
+            };
+        newLock.skills[name] = lockEntry;
+        installed.push(name);
+    }
+    // 5. Write lockfile (unless frozen)
+    if (!frozen) {
+        await writeLockfile(lockPath, newLock);
+    }
+    // 6. Regenerate .agents/.gitignore
+    await updateAgentsGitignore(agentsDir, config.gitignore, skillNames);
+    // 7. Create/verify symlinks
+    const targets = config.symlinks?.targets ?? [];
+    for (const target of targets) {
+        await ensureSkillsSymlink(agentsDir, join(projectRoot, target));
+    }
+    return { installed, skipped };
+}
+export default async function install(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            frozen: { type: "boolean" },
+            force: { type: "boolean" },
+        },
+        strict: true,
+    });
+    const { resolve } = await import("node:path");
+    try {
+        const result = await runInstall({
+            projectRoot: resolve("."),
+            frozen: values["frozen"],
+            force: values["force"],
+        });
+        if (result.installed.length > 0) {
+            console.log(chalk.green(`Installed ${result.installed.length} skill(s): ${result.installed.join(", ")}`));
+        }
+    }
+    catch (err) {
+        if (err instanceof InstallError) {
+            console.error(chalk.red(err.message));
+            process.exitCode = 1;
+            return;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/commands/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/cli/commands/install.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/install.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install.test.d.ts.map

package/dist/cli/commands/install.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.test.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/install.test.ts"],"names":[],"mappings":""}