@lyupro/skillforge-mcp 1.2.0 → 1.3.0

package/.claude-plugin/marketplace.json

@@ -14,7 +14,7 @@
         "package": "@lyupro/skillforge-mcp"
       },
       "description": "Universal Skills MCP server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool.",
-      "version": "1.2.0",
+      "version": "1.3.0",
       "author": {
         "name": "Lyu Pro",
         "email": "lyupro.dev@gmail.com"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "skillforge",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Universal Skills MCP server — load Markdown skills from arbitrary folders, lazy-by-design, cross-tool.",
   "author": {
     "name": "Lyu Pro",

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 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.
@@ -157,6 +178,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.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

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.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).
+**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).
 
 ---
 
@@ -105,7 +105,7 @@ The `skillforge` / `skillforge-mcp` binary is a dispatcher — the first positio
 | `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`. |
+| `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. |
 
@@ -123,22 +123,30 @@ Prints every MCP tool the server exposes (`skills__list`, `skills__get`, `skills
 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
+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).
-- `--tags <a,b,c>` — comma-separated tags.
+- `--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 --tags work,review
+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.
@@ -147,7 +155,7 @@ If you register a folder that already lives inside another tool's native skill s
 
 | 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. |
@@ -233,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
-# Plugin install
+# Installed as a Claude Code plugin
 /plugin update skillforge
 
-# npm install
+# 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
+
+# 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/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

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Shared helpers for the `folders` subcommand modules.
+ *
+ * Holds pure parsing/lookup logic split out of `folders.ts` so the entry
+ * module stays small and the handler modules can reuse it.
+ */
+import type { FolderEntry } from '../config/config-schema.js';
+/** Kebab-case shape required for a folder alias (lowercase words joined by `-`). */
+export declare const ALIAS_PATTERN: RegExp;
+/** Whether `name` is a valid kebab-case alias token. */
+export declare function isValidAlias(name: string): boolean;
+/** Check whether a path exists and is a directory. Overridable for tests. */
+export declare function defaultIsDirectory(p: string): Promise<boolean>;
+/**
+ * Locate a registered folder by `token`, matching an alias first and falling
+ * back to a resolved-path comparison. Shared so `remove`/`alias` address the
+ * same entry the same way.
+ */
+export declare function findFolderEntry(folders: FolderEntry[], token: string): FolderEntry | null;
+/** Parsed result of the flags accepted by `add`. */
+export interface ParsedAddFlags {
+    priority?: number;
+    tags?: string[];
+    disabled: boolean;
+    alias?: string;
+}
+/** Parse the flags accepted by `add`. Returns null on a malformed flag. */
+export declare function parseAddFlags(args: string[]): ParsedAddFlags | null;
+//# sourceMappingURL=folders-shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folders-shared.d.ts","sourceRoot":"","sources":["../../src/cli/folders-shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,oFAAoF;AACpF,eAAO,MAAM,aAAa,QAA6B,CAAC;AAExD,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,6EAA6E;AAC7E,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOpE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMzF;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,cAAc,GAAG,IAAI,CAmCnE"}

package/dist/cli/folders-shared.js

@@ -0,0 +1,82 @@
+/**
+ * Shared helpers for the `folders` subcommand modules.
+ *
+ * Holds pure parsing/lookup logic split out of `folders.ts` so the entry
+ * module stays small and the handler modules can reuse it.
+ */
+import { resolve } from 'node:path';
+import { stat } from 'node:fs/promises';
+/** Kebab-case shape required for a folder alias (lowercase words joined by `-`). */
+export const ALIAS_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/** Whether `name` is a valid kebab-case alias token. */
+export function isValidAlias(name) {
+    return ALIAS_PATTERN.test(name);
+}
+/** Check whether a path exists and is a directory. Overridable for tests. */
+export async function defaultIsDirectory(p) {
+    try {
+        const info = await stat(p);
+        return info.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Locate a registered folder by `token`, matching an alias first and falling
+ * back to a resolved-path comparison. Shared so `remove`/`alias` address the
+ * same entry the same way.
+ */
+export function findFolderEntry(folders, token) {
+    const byAlias = folders.find((f) => f.alias !== undefined && f.alias === token);
+    if (byAlias !== undefined)
+        return byAlias;
+    const absToken = resolve(token);
+    const byPath = folders.find((f) => resolve(f.path) === absToken);
+    return byPath ?? null;
+}
+/** Parse the flags accepted by `add`. Returns null on a malformed flag. */
+export function parseAddFlags(args) {
+    let priority;
+    let tags;
+    let disabled = false;
+    let alias;
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--disabled') {
+            disabled = true;
+        }
+        else if (arg === '--priority') {
+            const value = args[i + 1];
+            if (value === undefined)
+                return null;
+            const n = Number(value);
+            if (!Number.isInteger(n))
+                return null;
+            priority = n;
+            i += 1;
+        }
+        else if (arg === '--tags') {
+            const value = args[i + 1];
+            if (value === undefined)
+                return null;
+            tags = value
+                .split(',')
+                .map((t) => t.trim())
+                .filter((t) => t.length > 0);
+            i += 1;
+        }
+        else if (arg === '--alias') {
+            const value = args[i + 1];
+            if (value === undefined)
+                return null;
+            alias = value;
+            i += 1;
+        }
+        else {
+            return null;
+        }
+    }
+    return { priority, tags, disabled, alias };
+}
+//# sourceMappingURL=folders-shared.js.map

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

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

package/dist/cli/folders.d.ts

@@ -10,13 +10,18 @@
  * 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 remove <path|alias>         Remove a folder entry
+ *   skillforge folders alias <path|alias> <name>   Set/change a folder alias
  *   skillforge folders reset --yes                 Reset folders to default
  *
  * add flags:
- *   --priority <n>     Folder priority (default 100, lower wins ordering).
+ *   --priority <n>     Folder priority (default 100; higher wins on name collisions).
  *   --tags <a,b,c>     Comma-separated tags.
  *   --disabled         Register the folder disabled.
+ *   --alias <name>     Short kebab-case alias to address the folder later.
+ *
+ * This module keeps only the entry point + action dispatch; the handlers,
+ * table formatting, and shared parsing helpers live in sibling modules.
  */
 export interface FoldersDeps {
     stdout?: (text: string) => void;

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

@@ -1 +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"}
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/cli/folders.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAcH,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;AA8BD;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCrF"}