@mycelish/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mycelium Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/init-auto.test.d.ts

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

package/dist/__tests__/init-auto.test.d.ts.map

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

package/dist/__tests__/init-auto.test.js

@@ -0,0 +1,60 @@
+/**
+ * Tests for zero-friction auto-setup (mycelium init)
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { isGhAvailable, ghRepoExists, getGhUsername, hasGitRemote, } from "../commands/init.js";
+// Mock child_process
+vi.mock("node:child_process", () => ({
+    execSync: vi.fn(),
+    execFileSync: vi.fn(),
+}));
+import { execFileSync } from "node:child_process";
+const mockedExecFileSync = vi.mocked(execFileSync);
+describe("init auto-setup helpers", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe("isGhAvailable", () => {
+        it("returns true when gh auth status succeeds", () => {
+            mockedExecFileSync.mockReturnValueOnce("");
+            expect(isGhAvailable()).toBe(true);
+        });
+        it("returns false when gh is not installed", () => {
+            mockedExecFileSync.mockImplementationOnce(() => {
+                throw new Error("command not found");
+            });
+            expect(isGhAvailable()).toBe(false);
+        });
+    });
+    describe("ghRepoExists", () => {
+        it("returns true when repo exists", () => {
+            mockedExecFileSync.mockReturnValueOnce('{"name":"mycelium-config"}');
+            expect(ghRepoExists("user/mycelium-config")).toBe(true);
+        });
+        it("returns false when repo not found", () => {
+            mockedExecFileSync.mockImplementationOnce(() => {
+                throw new Error("not found");
+            });
+            expect(ghRepoExists("user/mycelium-config")).toBe(false);
+        });
+    });
+    describe("getGhUsername", () => {
+        it("returns trimmed username", () => {
+            mockedExecFileSync.mockReturnValueOnce("conrado\n");
+            expect(getGhUsername()).toBe("conrado");
+        });
+    });
+    describe("hasGitRemote", () => {
+        it("returns true when origin is configured", () => {
+            mockedExecFileSync.mockReturnValueOnce("https://github.com/user/repo.git\n");
+            expect(hasGitRemote()).toBe(true);
+        });
+        it("returns false when no remote", () => {
+            mockedExecFileSync.mockImplementationOnce(() => {
+                throw new Error("not a git repo");
+            });
+            expect(hasGitRemote()).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=init-auto.test.js.map

package/dist/__tests__/init-auto.test.js.map

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

package/dist/commands/add.d.ts

@@ -0,0 +1,20 @@
+/**
+ * add command - Add skills and MCPs to Mycelium configuration
+ *
+ * Usage:
+ *   mycelium add skill <source>     # Add a skill from GitHub (owner/repo) or local path (./local/skill)
+ *   mycelium add mcp <name>         # Add an MCP server configuration
+ *
+ * Examples:
+ *   mycelium add skill anthropic/claude-skills --global
+ *   mycelium add skill ./my-local-skill
+ *   mycelium add mcp context7 --command "npx" --args "-y @context7/mcp" --global
+ */
+import { Command } from "commander";
+export type { SkillSourceInfo, AddSkillOptions, AddSkillResult, McpNameInfo, AddMcpOptions, AddMcpResult, } from "../core/add-helpers.js";
+export { parseSkillSource, addSkill, parseMcpName, addMcp } from "../core/add-helpers.js";
+/**
+ * Commander.js command for `mycelium add`
+ */
+export declare const addCommand: Command;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAgG1F;;GAEG;AACH,eAAO,MAAM,UAAU,SAGE,CAAC"}

package/dist/commands/add.js

@@ -0,0 +1,99 @@
+/**
+ * add command - Add skills and MCPs to Mycelium configuration
+ *
+ * Usage:
+ *   mycelium add skill <source>     # Add a skill from GitHub (owner/repo) or local path (./local/skill)
+ *   mycelium add mcp <name>         # Add an MCP server configuration
+ *
+ * Examples:
+ *   mycelium add skill anthropic/claude-skills --global
+ *   mycelium add skill ./my-local-skill
+ *   mycelium add mcp context7 --command "npx" --args "-y @context7/mcp" --global
+ */
+import { Command } from "commander";
+import { addSkill, addMcp, fetchMcpFromRegistry, } from "../core/add-helpers.js";
+export { parseSkillSource, addSkill, parseMcpName, addMcp } from "../core/add-helpers.js";
+/**
+ * skill subcommand: mycelium add skill <source>
+ */
+const skillCommand = new Command("skill")
+    .description("Add a skill from GitHub (owner/repo) or local path (./local/skill)")
+    .argument("<source>", "Skill source (owner/repo for GitHub or ./path for local)")
+    .option("-g, --global", "Add to global configuration (~/.mycelium/)")
+    .option("-f, --force", "Overwrite existing skill")
+    .action(async (source, options) => {
+    const result = await addSkill(source, {
+        global: options.global ?? true,
+        force: options.force ?? false,
+    });
+    if (result.success) {
+        console.log(result.message);
+    }
+    else {
+        console.error(`Error: ${result.error}`);
+        process.exit(1);
+    }
+});
+/**
+ * mcp subcommand: mycelium add mcp <name>
+ */
+const mcpCommand = new Command("mcp")
+    .description("Add an MCP server configuration")
+    .argument("<name>", "MCP server name")
+    .option("-c, --command <command>", "Command to run the MCP server")
+    .option("-a, --args <args...>", "Arguments for the command")
+    .option("-e, --env <env...>", "Environment variables (KEY=value)")
+    .option("--enabled", "Enable the MCP server (default: true)")
+    .option("-g, --global", "Add to global configuration (~/.mycelium/)")
+    .option("-f, --force", "Overwrite existing MCP")
+    .option("--from-registry", "Fetch config from the MCP registry")
+    .action(async (name, options) => {
+    if (options.fromRegistry) {
+        const registryConfig = await fetchMcpFromRegistry(name);
+        if (!registryConfig) {
+            console.error(`Error: MCP "${name}" not found in registry`);
+            process.exit(1);
+        }
+        options.command = registryConfig.command;
+        options.args = registryConfig.args;
+        if (registryConfig.env) {
+            options.env = registryConfig.env;
+        }
+    }
+    if (!options.command) {
+        console.error("Error: --command is required (or use --from-registry)");
+        process.exit(1);
+    }
+    const env = {};
+    if (options.env) {
+        for (const envVar of options.env) {
+            const [key, ...valueParts] = envVar.split("=");
+            if (key && valueParts.length > 0) {
+                env[key] = valueParts.join("=");
+            }
+        }
+    }
+    const result = await addMcp(name, {
+        command: options.command,
+        args: options.args,
+        env: Object.keys(env).length > 0 ? env : undefined,
+        enabled: options.enabled,
+        global: options.global ?? true,
+        force: options.force ?? false,
+    });
+    if (result.success) {
+        console.log(result.message);
+    }
+    else {
+        console.error(`Error: ${result.error}`);
+        process.exit(1);
+    }
+});
+/**
+ * Commander.js command for `mycelium add`
+ */
+export const addCommand = new Command("add")
+    .description("Add skills or MCPs to Mycelium configuration")
+    .addCommand(skillCommand)
+    .addCommand(mcpCommand);
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Tests for add command - written FIRST following TDD
+ *
+ * Test cases for skill management:
+ * 1. parseSkillSource - identifies GitHub source (owner/repo)
+ * 2. parseSkillSource - identifies local path source (./local/skill)
+ * 3. parseSkillSource - validates GitHub format
+ * 4. parseSkillSource - validates local path exists
+ * 5. addSkill - adds skill entry to manifest.yaml
+ * 6. addSkill - creates skill directory if needed
+ * 7. addSkill - clones GitHub repo for remote skills
+ * 8. addSkill - copies files for local skills
+ * 9. addSkill - handles skill that already exists
+ * 10. addSkill - shows success message
+ *
+ * Test cases for MCP management:
+ * 11. parseMcpName - parses MCP name correctly
+ * 12. addMcp - adds MCP config to mcps.yaml
+ * 13. addMcp - validates MCP doesn't already exist
+ * 14. addMcp - creates mcps.yaml if it doesn't exist
+ * 15. addMcp - handles errors gracefully
+ * 16. addMcp - shows success message
+ */
+export {};
+//# sourceMappingURL=add.test.d.ts.map

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

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