@hi-man/himan 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -6,6 +6,21 @@ The format is based on Keep a Changelog, and this project follows semver for the
 
 ## [Unreleased]
 
+### Changed
+
+- Changed project guidance to require changelog updates for user-visible CLI behavior changes.
+
+## [0.3.3] - 2026-05-11
+
+### Added
+
+- Added `himan project list` and `himan list --installed` to show resources recorded in the current project's `himan.lock`.
+
+### Changed
+
+- Changed `himan list` without a resource type to group all source resources by `rule`, `command`, and `skill`.
+- Added `himan list --brief` to hide resource descriptions in concise list output.
+
 ## [0.3.2] - 2026-05-08
 
 ### Added

package/README.md

@@ -133,7 +133,7 @@ your-himan-source/
 
 | 命令                             | 说明                                                                                |
 | -------------------------------- | ----------------------------------------------------------------------------------- |
-| `list [type] [--agent a,b] [--json]` | 列出当前 default source 的资源；可按 agent 过滤；`type` 默认 `rule` |
+| `list [type] [--agent a,b] [--brief] [--installed] [--json]` | 默认列出当前 default source 的资源；未传 `type` 时按 `rule`/`command`/`skill` 分组展示全部资源；可按 agent 过滤；默认显示描述，`--brief` 可隐藏描述；`--installed` 改为查看当前项目 `himan.lock` 中的已安装资源 |
 | `history <type> <name> [--json]` | 按 tag 查看版本历史                                                                 |
 | `create <type> <name>`           | 脚手架；常用选项：`--description`、`--agent a,b`、`--dry-run`、`--force`、`--json` |
 
@@ -141,6 +141,7 @@ your-himan-source/
 
 | 命令                              | 说明                                                      |
 | --------------------------------- | --------------------------------------------------------- |
+| `list [type] [--agent a,b] [--json]` | 查看当前项目 `himan.lock` 中记录的已安装资源；未传 `type` 时按 `rule`/`command`/`skill` 分组展示 |
 | `install [type] [name[@version]] [--global] [--agent a,b] [--mode link\|copy]` | 有参数时从当前 default source 安装指定资源；**无参数**时按 `himan.lock` 记录的 source 批量安装；加 `--global` 时安装到用户级 agent 目录且不写项目 lock；可覆盖安装目标 agent 或安装模式 |
 | `dev <type> <name>`               | 切换到开发态，并按安装模式将项目目标指向或复制自 `.himan/dev/...` |
 | `uninstall <type> <name>`         | 从项目移除安装目标，并同步删除 `himan.lock` 条目           |
@@ -159,8 +160,8 @@ your-himan-source/
 
 - `himan resource list|history|create ...`
 - `himan-resource list|history|create ...`（兼容保留：也可执行 install/dev/uninstall/publish）
-- `himan project install|dev|uninstall|publish ...`
-- `himan-project install|dev|uninstall|publish ...`
+- `himan project list|install|dev|uninstall|publish ...`
+- `himan-project list|install|dev|uninstall|publish ...`
 - `himan agent list|use|current|clear ...`
 
 说明：资源与项目相关命令统一使用 `--agent` 指定目标 Agent。

package/dist/cli/builders.js

@@ -25,7 +25,7 @@ export function buildCli() {
     registerAgentCommands(agentCmd, services);
     // Backward compatible top-level resource lifecycle commands.
     registerResourceCommands(program, services);
-    registerProjectCommands(program, services);
+    registerProjectCommands(program, services, { includeList: false });
     return program;
 }
 export function buildSourceCli() {
@@ -43,7 +43,7 @@ export function buildResourceCli() {
         .description("Manage default agent configuration");
     registerAgentCommands(agentCmd, services);
     // Backward compatible: keep project lifecycle commands in himan-resource.
-    registerProjectCommands(program, services);
+    registerProjectCommands(program, services, { includeList: false });
     return program;
 }
 export function buildProjectCli() {
@@ -62,10 +62,11 @@ Command groups:
   source   Data source management (git now, registry reserved)
            init, source init, source add, source use, source list, source init-docs
   resource Source resource discovery and metadata
-           list, history, create, resource list, resource history, resource create
+           list, list --installed, history, create,
+           resource list, resource history, resource create
   project  Resource usage lifecycle in current project or user-level agent dirs
-           install, dev, uninstall, publish,
-           project install, project dev, project uninstall, project publish
+           list, install, dev, uninstall, publish,
+           project list, project install, project dev, project uninstall, project publish
   agent    Default agent configuration
            agent list, agent use, agent current, agent clear
 `);

package/dist/cli/installed-resource-list.js

@@ -0,0 +1,46 @@
+const RESOURCE_TYPES = ["rule", "command", "skill"];
+export async function listInstalledResourceGroups(services, projectDir, agents) {
+    const resources = await services.listInstalled(projectDir, undefined, agents);
+    return groupInstalledResources(resources);
+}
+export function groupInstalledResources(resources) {
+    return {
+        rule: resources.filter((resource) => resource.type === "rule"),
+        command: resources.filter((resource) => resource.type === "command"),
+        skill: resources.filter((resource) => resource.type === "skill"),
+    };
+}
+export function writeInstalledResourceGroups(groups) {
+    const hasResources = RESOURCE_TYPES.some((type) => groups[type].length > 0);
+    if (!hasResources) {
+        process.stdout.write("No installed resources found.\n");
+        return;
+    }
+    for (const type of RESOURCE_TYPES) {
+        const resources = groups[type];
+        if (resources.length === 0)
+            continue;
+        process.stdout.write(`${formatGroupTitle(type)}:\n`);
+        writeInstalledResources(resources);
+    }
+}
+export function writeInstalledResources(resources) {
+    if (resources.length === 0) {
+        process.stdout.write("No installed resources found.\n");
+        return;
+    }
+    for (const resource of resources) {
+        process.stdout.write(`- ${formatInstalledResource(resource)}\n`);
+    }
+}
+function formatInstalledResource(resource) {
+    const agents = resource.agents.length > 0 ? ` [${resource.agents.join(", ")}]` : "";
+    return `${resource.type}/${resource.name}@${resource.version}${agents} (${resource.mode})`;
+}
+function formatGroupTitle(type) {
+    if (type === "rule")
+        return "Rules";
+    if (type === "command")
+        return "Commands";
+    return "Skills";
+}

package/dist/cli/project-commands.js

@@ -1,7 +1,37 @@
 import { HimanError, errorCodes } from "../utils/errors.js";
 import { getSupportedAgentNames, normalizeAgent } from "../utils/agent-configs.js";
+import { listInstalledResourceGroups, writeInstalledResourceGroups, writeInstalledResources, } from "./installed-resource-list.js";
 import { runAction } from "./shared.js";
-export function registerProjectCommands(command, services) {
+export function registerProjectCommands(command, services, options = {}) {
+    if (options.includeList !== false) {
+        command
+            .command("list")
+            .argument("[type]", "resource type")
+            .option("--agent <list>", "agent list filter, comma separated")
+            .option("--json", "output json format")
+            .description("List resources installed in current project")
+            .action(async (type, commandOptions) => {
+            await runAction(async () => {
+                const agents = parseAgents(commandOptions.agent);
+                if (!type) {
+                    const groups = await listInstalledResourceGroups(services, process.cwd(), agents);
+                    if (commandOptions.json) {
+                        process.stdout.write(`${JSON.stringify(groups, null, 2)}\n`);
+                        return;
+                    }
+                    writeInstalledResourceGroups(groups);
+                    return;
+                }
+                const resourceType = ensureResourceType(type);
+                const resources = await services.listInstalled(process.cwd(), resourceType, agents);
+                if (commandOptions.json) {
+                    process.stdout.write(`${JSON.stringify(resources, null, 2)}\n`);
+                    return;
+                }
+                writeInstalledResources(resources);
+            });
+        });
+    }
     command
         .command("install")
         .argument("[type]", "resource type")

package/dist/cli/resource-commands.js

@@ -1,28 +1,41 @@
 import { HimanError, errorCodes } from "../utils/errors.js";
 import { getSupportedAgentNames, normalizeAgent } from "../utils/agent-configs.js";
+import { listInstalledResourceGroups, writeInstalledResourceGroups, writeInstalledResources, } from "./installed-resource-list.js";
 import { runAction } from "./shared.js";
+const RESOURCE_TYPES = ["rule", "command", "skill"];
 export function registerResourceCommands(command, services) {
     command
         .command("list")
-        .argument("[type]", "resource type", "rule")
+        .argument("[type]", "resource type")
         .option("--agent <list>", "agent list filter, comma separated")
+        .option("--brief", "hide resource descriptions")
+        .option("--installed", "list resources installed in current project")
         .option("--json", "output json format")
-        .description("List resources from current default source")
+        .description("List resources from current default source or project installs")
         .action(async (type, options) => {
         await runAction(async () => {
-            const resourceType = ensureResourceType(type);
-            const resources = await services.list(resourceType, parseAgents(options.agent));
-            if (options.json) {
-                process.stdout.write(`${JSON.stringify(resources, null, 2)}\n`);
+            const agents = parseAgents(options.agent);
+            const showDescription = !options.brief;
+            if (options.installed) {
+                await writeInstalledList(services, type, agents, Boolean(options.json));
                 return;
             }
-            if (resources.length === 0) {
-                process.stdout.write("No resources found.\n");
+            if (!type) {
+                const groups = await listGroupedResources(services, agents);
+                if (options.json) {
+                    process.stdout.write(`${JSON.stringify(formatResourceGroups(groups, showDescription), null, 2)}\n`);
+                    return;
+                }
+                writeGroupedResources(groups, showDescription);
                 return;
             }
-            for (const resource of resources) {
-                process.stdout.write(`- ${resource.type}/${resource.name}${resource.description ? `: ${resource.description}` : ""}\n`);
+            const resourceType = ensureResourceType(type);
+            const resources = await services.list(resourceType, agents);
+            if (options.json) {
+                process.stdout.write(`${JSON.stringify(formatResources(resources, showDescription), null, 2)}\n`);
+                return;
             }
+            writeResourceList(resources, showDescription);
         });
     });
     command
@@ -79,12 +92,82 @@ export function registerResourceCommands(command, services) {
         });
     });
 }
+async function writeInstalledList(services, type, agents, json) {
+    if (!type) {
+        const groups = await listInstalledResourceGroups(services, process.cwd(), agents);
+        if (json) {
+            process.stdout.write(`${JSON.stringify(groups, null, 2)}\n`);
+            return;
+        }
+        writeInstalledResourceGroups(groups);
+        return;
+    }
+    const resourceType = ensureResourceType(type);
+    const resources = await services.listInstalled(process.cwd(), resourceType, agents);
+    if (json) {
+        process.stdout.write(`${JSON.stringify(resources, null, 2)}\n`);
+        return;
+    }
+    writeInstalledResources(resources);
+}
 function ensureResourceType(type) {
     if (type !== "rule" && type !== "command" && type !== "skill") {
         throw new HimanError(errorCodes.UNSUPPORTED_RESOURCE_TYPE, `Unsupported resource type: ${type}`);
     }
     return type;
 }
+async function listGroupedResources(services, agents) {
+    return {
+        rule: await services.list("rule", agents),
+        command: await services.list("command", agents),
+        skill: await services.list("skill", agents),
+    };
+}
+function formatResourceGroups(groups, showDescription) {
+    return {
+        rule: formatResources(groups.rule, showDescription),
+        command: formatResources(groups.command, showDescription),
+        skill: formatResources(groups.skill, showDescription),
+    };
+}
+function formatResources(resources, showDescription) {
+    if (showDescription)
+        return resources;
+    return resources.map((resource) => {
+        const { description: _description, ...withoutDescription } = resource;
+        return withoutDescription;
+    });
+}
+function writeGroupedResources(groups, showDescription) {
+    const hasResources = RESOURCE_TYPES.some((type) => groups[type].length > 0);
+    if (!hasResources) {
+        process.stdout.write("No resources found.\n");
+        return;
+    }
+    for (const type of RESOURCE_TYPES) {
+        const resources = groups[type];
+        if (resources.length === 0)
+            continue;
+        process.stdout.write(`${formatGroupTitle(type)}:\n`);
+        writeResourceList(resources, showDescription);
+    }
+}
+function writeResourceList(resources, showDescription) {
+    if (resources.length === 0) {
+        process.stdout.write("No resources found.\n");
+        return;
+    }
+    for (const resource of resources) {
+        process.stdout.write(`- ${resource.type}/${resource.name}${showDescription && resource.description ? `: ${resource.description}` : ""}\n`);
+    }
+}
+function formatGroupTitle(type) {
+    if (type === "rule")
+        return "Rules";
+    if (type === "command")
+        return "Commands";
+    return "Skills";
+}
 function parseAgents(input) {
     if (!input)
         return undefined;

package/dist/services/index.js

@@ -157,6 +157,28 @@ export class ServiceFactory {
         const selected = normalizeAgents(agents);
         return resources.filter((resource) => normalizeAgents(resource.agents).some((agent) => selected.includes(agent)));
     }
+    async listInstalled(projectDir, type, agents) {
+        const { lock, state } = await this.lockStore.loadWithState(projectDir);
+        if (state === "invalid") {
+            throw new HimanError(errorCodes.LOCK_INVALID, `Lock file is invalid: ${this.lockStore.getLockPath(projectDir)}`);
+        }
+        if (state === "missing" || !lock) {
+            return [];
+        }
+        const selectedAgents = agents?.length ? normalizeAgents(agents) : undefined;
+        return lock.resources
+            .filter((resource) => !type || resource.type === type)
+            .map((resource) => ({
+            type: resource.type,
+            name: resource.name,
+            version: resource.version,
+            agents: normalizeAgents(resource.agents),
+            mode: this.resolveInstallMode(resource.mode),
+            updatedAt: resource.updatedAt,
+        }))
+            .filter((resource) => !selectedAgents ||
+            resource.agents.some((agent) => selectedAgents.includes(agent)));
+    }
     async history(type, name) {
         const source = await this.loadSourceFromConfig();
         return source.history(type, name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hi-man/himan",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Prompt and agent asset management CLI",
   "keywords": [
     "ai",