@lyupro/skillforge-mcp 1.1.0 → 1.2.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
+  "name": "skillforge",
+  "description": "SkillForge — universal Markdown skills for Claude Code and any MCP client.",
+  "owner": {
+    "name": "Lyu Pro",
+    "email": "lyupro.dev@gmail.com"
+  },
+  "plugins": [
+    {
+      "name": "skillforge",
+      "source": {
+        "source": "npm",
+        "package": "@lyupro/skillforge-mcp"
+      },
+      "description": "Universal Skills MCP server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool.",
+      "version": "1.2.0",
+      "author": {
+        "name": "Lyu Pro",
+        "email": "lyupro.dev@gmail.com"
+      },
+      "homepage": "https://github.com/lyupro/skillforge-mcp",
+      "repository": "https://github.com/lyupro/skillforge-mcp",
+      "license": "MIT",
+      "keywords": [
+        "skills",
+        "mcp",
+        "productivity",
+        "developer-tools",
+        "cross-tool",
+        "lazy-loading"
+      ],
+      "category": "productivity"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "skillforge",
+  "version": "1.2.0",
+  "description": "Universal Skills MCP server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool.",
+  "author": {
+    "name": "Lyu Pro",
+    "email": "lyupro.dev@gmail.com",
+    "url": "https://lyupro.com"
+  },
+  "homepage": "https://github.com/lyupro/skillforge-mcp",
+  "repository": "https://github.com/lyupro/skillforge-mcp",
+  "license": "MIT",
+  "keywords": [
+    "skills",
+    "mcp",
+    "productivity",
+    "developer-tools",
+    "cross-tool",
+    "lazy-loading"
+  ],
+  "mcpServers": {
+    "skillforge": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/dist/cli/dispatcher.js", "serve"]
+    }
+  }
+}

package/CHANGELOG.md

@@ -2,6 +2,53 @@
 
 All notable changes to **SkillForge MCP** are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] — 2026-05-16
+
+Terminal-side tooling — inspect MCP tools and manage skill folders without an LLM session, plus repo-local install scope and Claude Code plugin packaging.
+
+### Added
+
+- `skillforge tools` CLI subcommand — prints the 5 MCP tools the server exposes (`skills__list`, `skills__get`, `skills__invoke`, `skills__configure`, `skills__reload`) with each tool's description, parameters, and an example invocation. Pass `--json` for machine-readable output. Lets you confirm the tool surface without starting an LLM session.
+- `skillforge folders` CLI subcommand — manage skill folders from the terminal: `folders list [--json]`, `folders add <path> [--priority N] [--tags a,b] [--disabled]`, `folders remove <path>`, `folders reset --yes`. Previously folder management was only reachable via the `skills__configure` MCP tool inside an LLM session; both surfaces now read and write the same persisted config.
+- `--scope global|project` flag on `skillforge install` / `skillforge uninstall`. The default `global` scope edits each host's home-directory config (unchanged behavior). `--scope project` wires SkillForge into a repo-local config rooted at the current directory — `.mcp.json` (Claude Code), `.codex/config.toml` (Codex CLI), `.cursor/mcp.json` (Cursor).
+- Skill-source conflict detection. Registering a folder that already lives inside another tool's native skill store (a Claude Code plugin cache or a Gemini CLI extension) now surfaces a hint to disable the duplicate source — otherwise the same skills load twice and skill names collide. The `folders add` CLI prints the hint; the `skills__configure` `add_folder` action returns it as a `conflictHint` field. The conflict is informational only — it never blocks the folder from being added, and SkillForge never edits another tool's config.
+- Claude Code plugin packaging — `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json`. SkillForge can now be installed via `claude plugin install` (rich `/plugins` UI card) in addition to `claude mcp add` and `skillforge install`.
+
+### Verified
+
+- 535 / 535 tests passing + 1 win32-skip.
+- `pnpm lint` (`tsc --noEmit`) clean.
+- `pnpm build` clean.
+- `pnpm check:size` — all source files ≤ 400 lines.
+
+## [1.1.1] — 2026-05-15
+
+Single-bin dispatcher — fixes `npx @lyupro/skillforge-mcp install --all` hanging on stdin.
+
+### Fixed
+
+- `npx @lyupro/skillforge-mcp install ...` previously hung because the package shipped two bins (`skillforge-mcp` → server, `skillforge` → install CLI), and `npx` matched the package's unscoped basename to the server bin, which silently waited on stdio. Both bins now resolve to a unified dispatcher that routes by the first positional argument.
+
+### Added
+
+- `src/cli/dispatcher.ts` — single CLI entry point that routes between `serve`, `install`, `uninstall`, `--help`, and `--version`.
+- `skillforge-mcp serve` subcommand — explicit invocation of the MCP stdio server (default when no command is supplied).
+- `skillforge-mcp --version` — prints the package version.
+- Dispatcher unit tests covering help, version, serve routing, install/uninstall delegation, and unknown-command rejection.
+
+### Changed
+
+- `package.json#bin` — both `skillforge-mcp` and `skillforge` now point at `dist/cli/dispatcher.js`.
+- `manifest.json#runtime.entry` — `dist/cli/dispatcher.js`. MCP host configs that auto-detect the entry pick up the dispatcher and fall through to `serve` when invoked with no args.
+- Installer-generated host config entries now write `args: ['-y', '@lyupro/skillforge-mcp', 'serve']` explicitly. Older `['-y', '@lyupro/skillforge-mcp']` entries still work — the default subcommand resolves to `serve`.
+
+### Verified
+
+- All existing tests passing + dispatcher suite added.
+- `pnpm lint` (`tsc --noEmit`) clean.
+- `pnpm build` clean.
+- Manual smoke test from a fresh shell: `npx --yes @lyupro/skillforge-mcp@1.1.1 install --all --dry-run` outputs planned edits and exits cleanly.
+
 ## [1.1.0] — 2026-05-14
 
 One-command install across Claude Code, Codex CLI, and Cursor.
@@ -110,5 +157,7 @@ All 10 verified through real parse pipeline + `StrategyFactory.create()` correct
 - **`pnpm build`** clean.
 - **`pnpm smoke`** end-to-end via subprocess `dist/server.js` — LoggingDecorator trace visible.
 
+[1.2.0]: https://github.com/lyupro/skillforge-mcp/releases/tag/v1.2.0
+[1.1.1]: https://github.com/lyupro/skillforge-mcp/releases/tag/v1.1.1
 [1.1.0]: https://github.com/lyupro/skillforge-mcp/releases/tag/v1.1.0
 [1.0.0]: https://github.com/lyupro/skillforge-mcp/releases/tag/v1.0.0

package/README.md

@@ -6,7 +6,7 @@
 [![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 [![MCP](https://img.shields.io/badge/MCP-stdio-purple)](https://modelcontextprotocol.io)
 
-**v1.1.0** — 5 MCP tools, one-command install across Claude Code / Codex CLI / Cursor, 451 tests, 10 sample skills, modular architecture (all source files ≤ 400 lines).
+**v1.2.0** — 5 MCP tools, one-command install across Claude Code / Codex CLI / Cursor, terminal `tools` + `folders` subcommands, global/project install scopes, Claude Code plugin packaging, 535 tests, 10 sample skills, modular architecture (all source files ≤ 400 lines).
 
 ---
 
@@ -25,21 +25,37 @@ One skill folder. One config file. Any tool can ask for any skill on demand.
 | No cross-tool format | Each tool ships its own skill layout | Universal frontmatter parser auto-detects Claude / Codex / persona / custom dialects |
 | Skill execution = "just inline body in prompt" | No scripts, no caching, no timeouts, no composition | Strategy pattern (prompt / script / hybrid) + decorator chain (logging → timeout → cache) + composite skills with cycle detection |
 
-## One-command install (v1.1)
+## One-command install
 
 ```bash
 npx @lyupro/skillforge-mcp install --all
 ```
 
-Auto-detects Claude Code, Codex CLI, and Cursor on your machine and wires SkillForge into each. Supports `--dry-run`, `--uninstall`, and `--force`. Full reference: [docs/INSTALL_CLI.md](./docs/INSTALL_CLI.md).
+Auto-detects Claude Code, Codex CLI, and Cursor on your machine and wires SkillForge into each. Supports `--dry-run`, `--uninstall`, and `--force`.
+
+By default the installer edits each host's global config. Pass `--scope project` to wire SkillForge into a repo-local config rooted at the current directory instead — `.mcp.json` (Claude Code), `.codex/config.toml` (Codex CLI), `.cursor/mcp.json` (Cursor):
+
+```bash
+npx @lyupro/skillforge-mcp install --all --scope project
+```
+
+Full reference: [docs/INSTALL_CLI.md](./docs/INSTALL_CLI.md).
 
 ## Quick Start
 
-### Option 1 — Claude Code marketplace (recommended)
+### Option 1 — Claude Code plugin (recommended)
+
+SkillForge ships a Claude Code plugin manifest, so it installs through the native `/plugins` UI with a rich plugin card:
 
 ```bash
-/plugin marketplace add lyupro/llm-plugins-marketplace
-/plugin install skillforge-mcp@lyupro-llm-plugins
+/plugin marketplace add lyupro/skillforge-mcp
+/plugin install skillforge
+```
+
+Or install it directly:
+
+```bash
+claude plugin install skillforge@lyupro/skillforge-mcp
 ```
 
 Restart your Claude Code session. The five tools (`skills__list`, `skills__get`, `skills__invoke`, `skills__configure`, `skills__reload`) appear in the tool list.
@@ -50,7 +66,11 @@ Restart your Claude Code session. The five tools (`skills__list`, `skills__get`,
 claude mcp add skillforge -- npx -y @lyupro/skillforge-mcp
 ```
 
-Works for any MCP host that can spawn a stdio command (Claude Code, Codex CLI, Cursor).
+Works for any MCP host that can spawn a stdio command (Claude Code, Codex CLI, Cursor). Or let the install CLI wire every detected host at once:
+
+```bash
+npx -y @lyupro/skillforge-mcp install --all
+```
 
 ### Option 3 — local build
 
@@ -75,6 +95,54 @@ After the install step, run these three checks from inside any wired LLM tool se
 
 If any call fails with `[skillforge] fatal:` on stderr, the most likely cause is a corrupt config file or a missing folder path — the error message points at the offending file. Delete or fix `~/.lyupro/.skillforge/config.json` and retry.
 
+## CLI commands
+
+The `skillforge` / `skillforge-mcp` binary is a dispatcher — the first positional argument selects a subcommand. Run `skillforge --help` for the full list.
+
+| Command | Purpose |
+|---------|---------|
+| `serve` | Run the stdio MCP server. Default when no command is given. |
+| `install` | Wire SkillForge into Claude Code / Codex CLI / Cursor. Flags: `--claude` / `--codex` / `--cursor` / `--all`, `--dry-run`, `--uninstall`, `--force`, `--entry npx\|local`, `--binary-path <path>`, `--scope global\|project`. |
+| `uninstall` | Reverse a previous install. Accepts the same `--scope global\|project` flag. |
+| `tools` | Print the 5 MCP tools the server exposes (name, description, parameters, example). Pass `--json` for machine-readable output. |
+| `folders` | Manage skill folders from the terminal — `list` / `add` / `remove` / `reset`. |
+| `--version`, `-v` | Print the package version. |
+| `--help`, `-h` | Print combined usage. |
+
+### Inspect the MCP tools — `skillforge tools`
+
+```bash
+skillforge tools          # human-readable reference
+skillforge tools --json   # machine-readable: { "tools": [ ... ] }
+```
+
+Prints every MCP tool the server exposes (`skills__list`, `skills__get`, `skills__invoke`, `skills__configure`, `skills__reload`) with its description, parameters, and an example invocation — handy for confirming the surface without starting a session.
+
+### Manage skill folders from the terminal — `skillforge folders`
+
+Folder management is also available from the shell, not just via the `skills__configure` MCP tool inside an LLM session:
+
+```bash
+skillforge folders list [--json]                        # print registered folders
+skillforge folders add <path> [flags]                   # register a folder
+skillforge folders remove <path>                         # remove a folder entry
+skillforge folders reset --yes                           # reset folders to the default (empty) list
+```
+
+`add` flags:
+
+- `--priority <n>` — folder priority (default `100`; higher wins on name collisions).
+- `--tags <a,b,c>` — comma-separated tags.
+- `--disabled` — register the folder disabled.
+
+```bash
+skillforge folders add ~/.lyupro/skills --priority 50 --tags work,review
+```
+
+`reset` requires `--yes` to apply — without it, the command prints what would change and makes no edits. All `folders` actions read and write the same persisted config (`~/.lyupro/.skillforge/config.json`) as the `skills__configure` MCP tool.
+
+If you register a folder that already lives inside another tool's native skill store (a Claude Code plugin cache or a Gemini CLI extension), `folders add` prints a hint to disable the duplicate source so the same skills don't load twice. SkillForge only prints the hint — it never edits another tool's config.
+
 ## MCP tool surface
 
 | Tool | Purpose |
@@ -166,8 +234,8 @@ For production use with untrusted skill authors, run SkillForge inside Docker or
 ## Updating
 
 ```bash
-# Marketplace install
-/plugin update skillforge-mcp@lyupro-llm-plugins
+# Plugin install
+/plugin update skillforge
 
 # npm install
 claude mcp remove skillforge

package/dist/cli/dispatcher.d.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * SkillForge MCP CLI dispatcher.
+ *
+ * Single entry point for the `skillforge-mcp` and `skillforge` bins. Routes
+ * by the first positional argument so a single binary can act as both the
+ * MCP stdio server and the install CLI.
+ *
+ *   skillforge-mcp install [flags]     Wire SkillForge into host configs
+ *   skillforge-mcp uninstall [flags]   Reverse a previous install
+ *   skillforge-mcp serve               Run the MCP stdio server (default)
+ *   skillforge-mcp [no args]           Same as `serve`
+ *   skillforge-mcp --help              Print combined usage
+ *   skillforge-mcp --version           Print package version
+ *
+ * Why dispatcher exists:
+ *   `npx @scope/foo <subcommand>` matches a single bin by the package's
+ *   unscoped basename (`foo`). The earlier release shipped two separate
+ *   bins (`skillforge-mcp` → server, `skillforge` → install CLI). The
+ *   README-recommended `npx @lyupro/skillforge-mcp install --all` therefore
+ *   resolved to the server bin, which silently waited on stdin while users
+ *   thought the installer had hung. This dispatcher collapses both bins
+ *   into one and routes by argv, so the documented quick-start works
+ *   without an `--package=` override.
+ */
+export declare function readPackageVersion(): Promise<string>;
+export interface ServeDeps {
+    start: () => Promise<void>;
+}
+/**
+ * Dispatcher entry. Returns:
+ *   - exit code (number) for install/uninstall/help/version/unknown — caller
+ *     should `process.exit(code)`.
+ *   - null for serve — caller must NOT call process.exit; the server keeps
+ *     the event loop alive via stdio transport + signal handlers.
+ */
+export declare function main(rawArgv: string[], overrides?: {
+    startServe?: () => Promise<void>;
+}): Promise<number | null>;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/cli/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/cli/dispatcher.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAwCH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAa1D;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAsBD;;;;;;GAMG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAO,GACnD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkCxB"}

package/dist/cli/dispatcher.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+/**
+ * SkillForge MCP CLI dispatcher.
+ *
+ * Single entry point for the `skillforge-mcp` and `skillforge` bins. Routes
+ * by the first positional argument so a single binary can act as both the
+ * MCP stdio server and the install CLI.
+ *
+ *   skillforge-mcp install [flags]     Wire SkillForge into host configs
+ *   skillforge-mcp uninstall [flags]   Reverse a previous install
+ *   skillforge-mcp serve               Run the MCP stdio server (default)
+ *   skillforge-mcp [no args]           Same as `serve`
+ *   skillforge-mcp --help              Print combined usage
+ *   skillforge-mcp --version           Print package version
+ *
+ * Why dispatcher exists:
+ *   `npx @scope/foo <subcommand>` matches a single bin by the package's
+ *   unscoped basename (`foo`). The earlier release shipped two separate
+ *   bins (`skillforge-mcp` → server, `skillforge` → install CLI). The
+ *   README-recommended `npx @lyupro/skillforge-mcp install --all` therefore
+ *   resolved to the server bin, which silently waited on stdin while users
+ *   thought the installer had hung. This dispatcher collapses both bins
+ *   into one and routes by argv, so the documented quick-start works
+ *   without an `--package=` override.
+ */
+import { main as installMain } from './install.js';
+import { main as toolsMain } from './tools.js';
+import { main as foldersMain } from './folders.js';
+const USAGE = `skillforge-mcp — universal Skills MCP server + install CLI.
+
+Usage:
+  skillforge-mcp <command> [flags]
+
+Commands:
+  serve        Run the stdio MCP server. Default when no command is given.
+                 Example: skillforge-mcp serve
+  install      Wire SkillForge into Claude Code / Codex CLI / Cursor.
+               Defaults to the host's global config; pass --scope project to
+               edit a repo-local config rooted at the current directory.
+               Run "skillforge-mcp install --help" for installer flags.
+                 Example: skillforge-mcp install --all
+                 Example: skillforge-mcp install --all --scope project
+  uninstall    Reverse a previous install. Forwards to "install --uninstall".
+               Accepts the same --scope global|project flag.
+                 Example: skillforge-mcp uninstall --all
+  tools        List the 5 MCP tools the server exposes (params + examples).
+               Pass --json for machine-readable output.
+                 Example: skillforge-mcp tools --json
+  folders      Manage skill folders from the terminal (list/add/remove/reset).
+               Run "skillforge-mcp folders" for sub-action usage.
+                 Example: skillforge-mcp folders add ~/.lyupro/skills
+
+Options:
+  --help, -h   Show this message.
+  --version, -v  Print the package version.
+                 Example: skillforge-mcp --version
+
+Quick start:
+  npx -y @lyupro/skillforge-mcp install --all
+  npx -y @lyupro/skillforge-mcp install --all --dry-run
+`;
+export async function readPackageVersion() {
+    const { readFile } = await import('node:fs/promises');
+    const { fileURLToPath } = await import('node:url');
+    const { dirname, resolve } = await import('node:path');
+    const here = dirname(fileURLToPath(import.meta.url));
+    // dist/cli/dispatcher.js → package.json is two levels up.
+    const pkgPath = resolve(here, '..', '..', 'package.json');
+    const raw = await readFile(pkgPath, 'utf8');
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.version !== 'string') {
+        throw new Error('package.json missing string "version" field');
+    }
+    return parsed.version;
+}
+async function defaultStartServe() {
+    const { buildDeps, buildServer } = await import('../server.js');
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const deps = await buildDeps();
+    const server = buildServer(deps);
+    await server.connect(new StdioServerTransport());
+    await deps.folderWatcher.start();
+    const shutdown = async () => {
+        await deps.folderWatcher.stop();
+    };
+    process.once('SIGTERM', () => {
+        void shutdown();
+    });
+    process.once('SIGINT', () => {
+        void shutdown();
+    });
+}
+/**
+ * Dispatcher entry. Returns:
+ *   - exit code (number) for install/uninstall/help/version/unknown — caller
+ *     should `process.exit(code)`.
+ *   - null for serve — caller must NOT call process.exit; the server keeps
+ *     the event loop alive via stdio transport + signal handlers.
+ */
+export async function main(rawArgv, overrides = {}) {
+    const first = rawArgv[0];
+    if (first === '--help' || first === '-h') {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    if (first === '--version' || first === '-v') {
+        const version = await readPackageVersion();
+        process.stdout.write(`${version}\n`);
+        return 0;
+    }
+    if (first === 'install') {
+        return installMain(rawArgv.slice(1));
+    }
+    if (first === 'uninstall') {
+        return installMain(['--uninstall', ...rawArgv.slice(1)]);
+    }
+    if (first === 'tools') {
+        return toolsMain(rawArgv.slice(1));
+    }
+    if (first === 'folders') {
+        return foldersMain(rawArgv.slice(1));
+    }
+    if (first === 'serve' || first === undefined) {
+        const start = overrides.startServe ?? defaultStartServe;
+        await start();
+        return null;
+    }
+    process.stderr.write(`skillforge-mcp: unknown command: ${first}\n\n${USAGE}`);
+    return 2;
+}
+import { fileURLToPath } from 'node:url';
+const isDirectRun = process.argv[1] !== undefined &&
+    fileURLToPath(import.meta.url) === process.argv[1];
+if (isDirectRun) {
+    main(process.argv.slice(2))
+        .then((code) => {
+        if (code !== null)
+            process.exit(code);
+    })
+        .catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[skillforge-mcp] fatal: ${msg}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/cli/dispatcher.js.map

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

package/dist/cli/folders.d.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * SkillForge `folders` subcommand.
+ *
+ * Terminal-side skill-folder management. Without this, folders could only
+ * be registered from inside an LLM session via the `skills__configure` MCP
+ * tool. This subcommand exposes the same `ConfigStore` folder operations
+ * (load → mutate → save) to the shell — no separate config logic.
+ *
+ * Usage:
+ *   skillforge folders list [--json]               List registered folders
+ *   skillforge folders add <path> [flags]          Register a folder
+ *   skillforge folders remove <path>               Remove a folder entry
+ *   skillforge folders reset --yes                 Reset folders to default
+ *
+ * add flags:
+ *   --priority <n>     Folder priority (default 100, lower wins ordering).
+ *   --tags <a,b,c>     Comma-separated tags.
+ *   --disabled         Register the folder disabled.
+ */
+export interface FoldersDeps {
+    stdout?: (text: string) => void;
+    stderr?: (text: string) => void;
+    /** Override the config file path — tests inject a temp path here. */
+    configPath?: string;
+    /** Check whether a path exists and is a directory. Overridable for tests. */
+    isDirectory?: (p: string) => Promise<boolean>;
+}
+/**
+ * `folders` subcommand entry. Returns an exit code:
+ *   - 0 on success
+ *   - 1 on a runtime/validation failure (e.g. bad path)
+ *   - 2 on a missing/unknown sub-action or malformed flag
+ */
+export declare function main(rawArgv: string[], deps?: FoldersDeps): Promise<number>;
+//# sourceMappingURL=folders.d.ts.map

package/dist/cli/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/cli/folders.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AAYH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAwND;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCrF"}