@lyupro/skillforge-mcp 1.1.1 → 1.3.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.3.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.3.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,46 @@
 
 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.3.0] — 2026-05-16
+
+Folder ergonomics — address folders by a short alias, toggle them on and off, and filter skills by folder tag.
+
+### Added
+
+- Folder alias. A folder entry now carries an optional kebab-case `alias` — a single short handle for a folder. `skillforge folders add <path> --alias <name>` registers it; `skillforge folders remove <name>` and the new `skillforge folders alias <path|alias> <name>` accept the alias in place of the full absolute path. The full path keeps working everywhere. Aliases are validated kebab-case and unique across registered folders — a collision fails with exit ≠ 0 and leaves the config untouched. The `skills__configure` `add_folder` action accepts an `alias` field too, and `folders list` shows an `ALIAS` column.
+- `skillforge folders enable <path|alias>` / `skillforge folders disable <path|alias>` — a two-way toggle for the `enabled` flag. `folders add --disabled` previously had no inverse; re-activating a folder meant hand-editing `config.json`. A disabled folder stays in the config but is skipped on scan.
+- Folder-tag filtering. Folder `tags` were written to the config but never read. `skills__list` now accepts a `folderTag` argument that keeps only skills under folders carrying that tag, and `skillforge folders list --tag <name>` filters the listing the same way. `docs/CONFIGURATION.md` gains a "tags vs alias" section: `alias` is one unique handle per folder for addressing, `tags` are many shared labels for grouping.
+
+### Changed
+
+- `src/cli/folders.ts` split into four flat sibling modules (`folders.ts`, `folders-handlers.ts`, `folders-format.ts`, `folders-shared.ts`) to stay under the 400-line file gate. The `dispatcher.ts` import path is unchanged.
+
+### Verified
+
+- 561 / 561 tests passing + 1 win32-skip.
+- `pnpm lint` (`tsc --noEmit`) clean.
+- `pnpm build` clean.
+- `pnpm check:size` — all source files ≤ 400 lines.
+
+## [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.
@@ -138,5 +178,8 @@ 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.3.0]: https://github.com/lyupro/skillforge-mcp/releases/tag/v1.3.0
+[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.3.0** — 5 MCP tools, one-command install across Claude Code / Codex CLI / Cursor, terminal `tools` + `folders` subcommands (folder aliases, enable/disable toggle, tag filter), global/project install scopes, Claude Code plugin packaging, 561 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/skillforge-mcp
+/plugin install skillforge
+```
+
+Or install it directly:
 
 ```bash
-/plugin marketplace add lyupro/llm-plugins-marketplace
-/plugin install skillforge-mcp@lyupro-llm-plugins
+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,11 +95,67 @@ 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` / `alias` / `enable` / `disable` / `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] [--tag <name>]          # print registered folders
+skillforge folders add <path> [flags]                    # register a folder
+skillforge folders remove <path|alias>                    # remove a folder entry
+skillforge folders alias <path|alias> <name>              # set or change a folder alias
+skillforge folders enable <path|alias>                    # re-activate a disabled folder
+skillforge folders disable <path|alias>                   # deactivate a folder (kept in config)
+skillforge folders reset --yes                            # reset folders to the default (empty) list
+```
+
+`add` flags:
+
+- `--priority <n>` — folder priority (default `100`; higher wins on name collisions).
+- `--alias <name>` — a short kebab-case handle, unique across folders. Lets `remove` / `enable` / `disable` target the folder without typing the full path.
+- `--tags <a,b,c>` — comma-separated tags. Filter on them via `folders list --tag <name>` or the `skills__list` `folderTag` argument.
+- `--disabled` — register the folder disabled.
+
+```bash
+skillforge folders add ~/.lyupro/skills --priority 50 --alias core --tags work,review
+skillforge folders disable core            # address it by alias, not by path
+skillforge folders list --tag work         # only folders tagged "work"
+```
+
+`alias` is one unique handle per folder (addressing); `tags` are many shared labels (grouping and filtering) — see [docs/CONFIGURATION.md](./docs/CONFIGURATION.md) for the full contrast.
+
+`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 |
 |------|---------|
-| `skills__list`      | Enumerate available skills (metadata only). Filters: `folder`, `search`, `source`. |
+| `skills__list`      | Enumerate available skills (metadata only). Filters: `folder`, `search`, `source`, `folderTag`. |
 | `skills__get`       | Fetch full SKILL.md body + metadata for one skill. |
 | `skills__invoke`    | Execute a skill via its assigned strategy, wrapped in the decorator chain (Logging → Timeout → Cache). Composite skills (`metadata.skills: [a, b]`) walk nested skills sequentially with DFS cycle detection. |
 | `skills__configure` | Manage configured folders + manual blacklist. Actions: `add_folder`, `remove_folder`, `list_folders`, `set_blacklist`, `get_blacklist`, `reset`. Persists to the config file and reconciles in-process state without restart. |
@@ -165,15 +241,21 @@ For production use with untrusted skill authors, run SkillForge inside Docker or
 
 ## Updating
 
+Pick the block that matches how you installed.
+
 ```bash
-# Marketplace install
-/plugin update skillforge-mcp@lyupro-llm-plugins
+# Installed as a Claude Code plugin
+/plugin update skillforge
+
+# Installed via the install CLI (global npm package)
+npm install -g @lyupro/skillforge-mcp@latest
+# host wiring already points at the global bin — restart the host session
 
-# npm install
+# Installed as a bare MCP server (npx)
 claude mcp remove skillforge
 claude mcp add skillforge -- npx -y @lyupro/skillforge-mcp@latest
 
-# Local-build install
+# Local-build install (git clone)
 cd skillforge-mcp
 git pull
 pnpm install

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

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/cli/dispatcher.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAwBH,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,CA4BxB"}
+{"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

@@ -24,20 +24,36 @@
  *   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".
-  serve        Run the stdio MCP server. Default when no command is given.
+               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    Print the package version.
+  --version, -v  Print the package version.
+                 Example: skillforge-mcp --version
 
 Quick start:
   npx -y @lyupro/skillforge-mcp install --all
@@ -98,6 +114,12 @@ export async function main(rawArgv, overrides = {}) {
     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();

package/dist/cli/dispatcher.js.map

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

package/dist/cli/folders-format.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Table rendering for the `folders list` subcommand.
+ *
+ * Split out of `folders.ts` so the entry module stays under the 400-line
+ * file-size gate. Pure formatting — no I/O.
+ */
+import type { FolderEntry } from '../config/config-schema.js';
+/** Render the registered folders as a fixed-width text table. */
+export declare function formatFoldersTable(folders: FolderEntry[]): string;
+//# sourceMappingURL=folders-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders-format.d.ts","sourceRoot":"","sources":["../../src/cli/folders-format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAkCjE"}

package/dist/cli/folders-format.js

@@ -0,0 +1,41 @@
+/**
+ * Table rendering for the `folders list` subcommand.
+ *
+ * Split out of `folders.ts` so the entry module stays under the 400-line
+ * file-size gate. Pure formatting — no I/O.
+ */
+/** Render the registered folders as a fixed-width text table. */
+export function formatFoldersTable(folders) {
+    if (folders.length === 0) {
+        return 'No folders registered.\n';
+    }
+    const rows = folders.map((f) => ({
+        priority: String(f.priority),
+        enabled: f.enabled ? 'yes' : 'no',
+        alias: f.alias !== undefined && f.alias.length > 0 ? f.alias : '-',
+        tags: f.tags.length > 0 ? f.tags.join(',') : '-',
+        path: f.path,
+    }));
+    const headers = {
+        priority: 'PRIORITY',
+        enabled: 'ENABLED',
+        alias: 'ALIAS',
+        tags: 'TAGS',
+        path: 'PATH',
+    };
+    const width = {
+        priority: Math.max(headers.priority.length, ...rows.map((r) => r.priority.length)),
+        enabled: Math.max(headers.enabled.length, ...rows.map((r) => r.enabled.length)),
+        alias: Math.max(headers.alias.length, ...rows.map((r) => r.alias.length)),
+        tags: Math.max(headers.tags.length, ...rows.map((r) => r.tags.length)),
+    };
+    const pad = (text, len) => text.padEnd(len);
+    const lines = [
+        `${pad(headers.priority, width.priority)}  ${pad(headers.enabled, width.enabled)}  ${pad(headers.alias, width.alias)}  ${pad(headers.tags, width.tags)}  ${headers.path}`,
+    ];
+    for (const r of rows) {
+        lines.push(`${pad(r.priority, width.priority)}  ${pad(r.enabled, width.enabled)}  ${pad(r.alias, width.alias)}  ${pad(r.tags, width.tags)}  ${r.path}`);
+    }
+    return `${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=folders-format.js.map

package/dist/cli/folders-format.js.map

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

package/dist/cli/folders-handlers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Action handlers for the `folders` subcommand.
+ *
+ * Each handler takes a `ConfigStore`, the post-action args, and stdout/stderr
+ * sinks; it returns a process exit code. Split out of `folders.ts` so the
+ * entry module stays under the 400-line file-size gate.
+ */
+import type { ConfigStore } from '../config/config-store.js';
+export declare function handleList(store: ConfigStore, rest: string[], stdout: (t: string) => void, stderr: (t: string) => void): Promise<number>;
+export declare function handleAdd(store: ConfigStore, rest: string[], stdout: (t: string) => void, stderr: (t: string) => void, isDirectory: (p: string) => Promise<boolean>): Promise<number>;
+export declare function handleRemove(store: ConfigStore, rest: string[], stdout: (t: string) => void, stderr: (t: string) => void): Promise<number>;
+export declare function handleAlias(store: ConfigStore, rest: string[], stdout: (t: string) => void, stderr: (t: string) => void): Promise<number>;
+export declare function handleEnable(store: ConfigStore, rest: string[], stdout: (t: string) => void, stderr: (t: string) => void): Promise<number>;
+export declare function handleDisable(store: ConfigStore, rest: string[], stdout: (t: string) => void, stderr: (t: string) => void): Promise<number>;
+export declare function handleReset(store: ConfigStore, rest: string[], stdout: (t: string) => void, stderr: (t: string) => void): Promise<number>;
+//# sourceMappingURL=folders-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders-handlers.d.ts","sourceRoot":"","sources":["../../src/cli/folders-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAU7D,wBAAsB,UAAU,CAC9B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3C,OAAO,CAAC,MAAM,CAAC,CAqDjB;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC1B,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/cli/folders-handlers.js

@@ -0,0 +1,195 @@
+/**
+ * Action handlers for the `folders` subcommand.
+ *
+ * Each handler takes a `ConfigStore`, the post-action args, and stdout/stderr
+ * sinks; it returns a process exit code. Split out of `folders.ts` so the
+ * entry module stays under the 400-line file-size gate.
+ */
+import { resolve } from 'node:path';
+import { defaultConfig } from '../config/config-schema.js';
+import { detectSkillSourceConflict, formatConflictHint, } from '../detect/skill-source-conflict.js';
+import { formatFoldersTable } from './folders-format.js';
+import { findFolderEntry, isValidAlias, parseAddFlags } from './folders-shared.js';
+export async function handleList(store, rest, stdout, stderr) {
+    let asJson = false;
+    let tagFilter;
+    for (let i = 0; i < rest.length; i += 1) {
+        const arg = rest[i];
+        if (arg === '--json') {
+            asJson = true;
+        }
+        else if (arg === '--tag') {
+            const value = rest[i + 1];
+            if (value === undefined) {
+                stderr(`skillforge folders list: --tag requires a value\n`);
+                return 2;
+            }
+            tagFilter = value;
+            i += 1;
+        }
+        else {
+            stderr(`skillforge folders list: unknown flag: ${arg}\n`);
+            return 2;
+        }
+    }
+    const config = await store.load();
+    const folders = tagFilter !== undefined
+        ? config.folders.filter((f) => f.tags.includes(tagFilter))
+        : config.folders;
+    if (asJson) {
+        stdout(`${JSON.stringify({ folders }, null, 2)}\n`);
+    }
+    else {
+        stdout(formatFoldersTable(folders));
+    }
+    return 0;
+}
+export async function handleAdd(store, rest, stdout, stderr, isDirectory) {
+    const rawPath = rest[0];
+    if (rawPath === undefined || rawPath.startsWith('--')) {
+        stderr(`skillforge folders add: missing <path>\n`);
+        return 2;
+    }
+    const flags = parseAddFlags(rest.slice(1));
+    if (flags === null) {
+        stderr(`skillforge folders add: invalid or malformed flag\n`);
+        return 2;
+    }
+    if (flags.alias !== undefined && !isValidAlias(flags.alias)) {
+        stderr(`skillforge folders add: invalid --alias "${flags.alias}" — use kebab-case (e.g. my-folder)\n`);
+        return 2;
+    }
+    const absPath = resolve(rawPath);
+    if (!(await isDirectory(absPath))) {
+        stderr(`skillforge folders add: path does not exist or is not a directory: ${absPath}\n`);
+        return 1;
+    }
+    const config = await store.load();
+    const alreadyPresent = config.folders.some((f) => resolve(f.path) === absPath);
+    if (alreadyPresent) {
+        stdout(`Folder already registered: ${absPath}\n`);
+        return 0;
+    }
+    if (flags.alias !== undefined) {
+        const aliasTaken = config.folders.some((f) => f.alias === flags.alias);
+        if (aliasTaken) {
+            stderr(`skillforge folders add: alias already in use: ${flags.alias}\n`);
+            return 2;
+        }
+    }
+    const entry = {
+        path: absPath,
+        priority: flags.priority ?? 100,
+        enabled: !flags.disabled,
+        tags: flags.tags ?? [],
+        ...(flags.alias !== undefined ? { alias: flags.alias } : {}),
+    };
+    config.folders.push(entry);
+    await store.save(config);
+    stdout(`Registered folder: ${absPath}\n`);
+    // Informational only: a conflict does not block the add or change the exit code.
+    const conflict = detectSkillSourceConflict(absPath);
+    if (conflict !== null) {
+        stdout(`${formatConflictHint(conflict)}\n`);
+    }
+    return 0;
+}
+export async function handleRemove(store, rest, stdout, stderr) {
+    const token = rest[0];
+    if (token === undefined || token.startsWith('--')) {
+        stderr(`skillforge folders remove: missing <path>\n`);
+        return 2;
+    }
+    const config = await store.load();
+    const entry = findFolderEntry(config.folders, token);
+    if (entry === null) {
+        stderr(`skillforge folders remove: no registered folder matches: ${token}\n`);
+        return 1;
+    }
+    config.folders = config.folders.filter((f) => f !== entry);
+    await store.save(config);
+    stdout(`Removed folder: ${entry.path}\n`);
+    return 0;
+}
+export async function handleAlias(store, rest, stdout, stderr) {
+    const token = rest[0];
+    const name = rest[1];
+    if (token === undefined || token.startsWith('--') || name === undefined) {
+        stderr(`skillforge folders alias: usage: folders alias <path> <name>\n`);
+        return 2;
+    }
+    if (!isValidAlias(name)) {
+        stderr(`skillforge folders alias: invalid alias "${name}" — use kebab-case (e.g. my-folder)\n`);
+        return 2;
+    }
+    const config = await store.load();
+    const entry = findFolderEntry(config.folders, token);
+    if (entry === null) {
+        stderr(`skillforge folders alias: no registered folder matches: ${token}\n`);
+        return 1;
+    }
+    const aliasTaken = config.folders.some((f) => f !== entry && f.alias === name);
+    if (aliasTaken) {
+        stderr(`skillforge folders alias: alias already in use: ${name}\n`);
+        return 2;
+    }
+    entry.alias = name;
+    await store.save(config);
+    stdout(`Set alias "${name}" for folder: ${entry.path}\n`);
+    return 0;
+}
+export async function handleEnable(store, rest, stdout, stderr) {
+    const token = rest[0];
+    if (token === undefined || token.startsWith('--')) {
+        stderr(`skillforge folders enable: missing <path|alias>\n`);
+        return 2;
+    }
+    const config = await store.load();
+    const entry = findFolderEntry(config.folders, token);
+    if (entry === null) {
+        stderr(`skillforge folders enable: no registered folder matches: ${token}\n`);
+        return 1;
+    }
+    entry.enabled = true;
+    await store.save(config);
+    stdout(`Enabled folder: ${entry.path}\n`);
+    return 0;
+}
+export async function handleDisable(store, rest, stdout, stderr) {
+    const token = rest[0];
+    if (token === undefined || token.startsWith('--')) {
+        stderr(`skillforge folders disable: missing <path|alias>\n`);
+        return 2;
+    }
+    const config = await store.load();
+    const entry = findFolderEntry(config.folders, token);
+    if (entry === null) {
+        stderr(`skillforge folders disable: no registered folder matches: ${token}\n`);
+        return 1;
+    }
+    entry.enabled = false;
+    await store.save(config);
+    stdout(`Disabled folder: ${entry.path}\n`);
+    return 0;
+}
+export async function handleReset(store, rest, stdout, stderr) {
+    const confirmed = rest.includes('--yes');
+    for (const arg of rest) {
+        if (arg !== '--yes') {
+            stderr(`skillforge folders reset: unknown flag: ${arg}\n`);
+            return 2;
+        }
+    }
+    if (!confirmed) {
+        const config = await store.load();
+        stdout(`Would reset ${config.folders.length} folder(s) to the default (empty) list.\n` +
+            `Re-run with --yes to apply. No changes were made.\n`);
+        return 0;
+    }
+    const config = await store.load();
+    config.folders = defaultConfig().folders;
+    await store.save(config);
+    stdout(`Reset folders to the default (empty) list.\n`);
+    return 0;
+}
+//# sourceMappingURL=folders-handlers.js.map