project-mgr 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 
-## Unreleased
+## 0.1.6 - 2026-08-03
+
+### Fixed
+
+- Allowed `history` to query recent entries across all projects without `--project`.
+
+## 0.1.5 - 2026-08-03
+
+### Changed
+
+- Matched the Skill picker label to the project name, `project-mgr`, and documented explicit invocation.
 
 ## 0.1.4 - 2026-08-03
 

package/README.md

@@ -33,7 +33,7 @@ PMGR_DB_PATH=/absolute/path/projects.sqlite npx --yes --package project-mgr pmgr
 
 ## Install the Agent Skill
 
-The repository includes `skills/project-mgr`, which guides compatible AI agents to add, import, query, and export status records. Install it with the [skills CLI](https://skills.sh/docs/cli):
+The repository includes the `project-mgr` skill, shown as **project-mgr** in skill pickers. It guides compatible AI agents to add, import, query, and export local project status history. Install it with the [skills CLI](https://skills.sh/docs/cli):
 
 ```bash
 npx skills add deanplus/project-manager
@@ -41,9 +41,28 @@ npx skills add deanplus/project-manager
 
 The installer detects supported agents and asks where to install the skill. No separate `project-mgr` installation is required: the skill runs the CLI through `npx`. Restart or reload the selected agent after installation.
 
-The skill uses the same `PMGR_DB_PATH` behavior as the CLI: it defaults to `~/.local/share/project-mgr/project-mgr.sqlite`; set an absolute path to work in another ledger. For manual or exploratory work, use a dedicated database such as `PMGR_DB_PATH=/tmp/project-mgr-skill-test.sqlite` rather than the default ledger.
+### Invoke the skill
+
+In Codex, write `$project-mgr` in the prompt. Alternatively, type `/pro` and select **project-mgr** from the picker. In other agents, use their explicit skill syntax or select `project-mgr` from the skills menu.
+
+Use normal language after the skill name; the agent translates the request into CLI commands. For example:
+
+```text
+Use $project-mgr to show the current status and latest 10 updates for project-mgr.
+
+Use $project-mgr to record this update for project-mgr: active; released the Agent Skill;
+next, collect user feedback.
 
-Then ask the agent, for example: `Use project-mgr to add an active status after checking its current status.`
+Use $project-mgr to record these updates: api is blocked by authentication; web is active
+and the dashboard is complete.
+
+Use $project-mgr with PMGR_DB_PATH=/tmp/project-mgr-test.sqlite to add a test update,
+then show its history.
+```
+
+The agent should query before writing and ask for missing required values such as the project name, status, or summary.
+
+The skill uses the same `PMGR_DB_PATH` behavior as the CLI: it defaults to `~/.local/share/project-mgr/project-mgr.sqlite`; set an absolute path to work in another ledger. For manual or exploratory work, use a dedicated database such as `PMGR_DB_PATH=/tmp/project-mgr-skill-test.sqlite` rather than the default ledger.
 
 ## Build from source
 
@@ -138,6 +157,9 @@ pnpm start history \
   --limit 20 \
   --offset 0
 
+# Recent history across every project.
+pnpm start history --limit 20 --json
+
 pnpm start at \
   --project project-mgr \
   --at 2026-08-03T12:00:00+08:00 \
@@ -191,12 +213,12 @@ Unknown fields, unknown CLI options, extra positional arguments, invalid statuse
 
 ## Query and export
 
-| Command   | Purpose                                         | Key options                                                        |
-| --------- | ----------------------------------------------- | ------------------------------------------------------------------ |
-| `current` | Current status for all projects or one project  | `--project`, `--json`                                              |
-| `history` | One project's history, newest first             | `--project`, `--since`, `--until`, `--limit`, `--offset`, `--json` |
-| `at`      | The latest status at or before a specified time | `--project`, `--at`, `--json`                                      |
-| `export`  | Export all records or one project's records     | `--project`, `--format json\|jsonl`                                |
+| Command   | Purpose                                               | Key options                                                        |
+| --------- | ----------------------------------------------------- | ------------------------------------------------------------------ |
+| `current` | Current status for all projects or one project        | `--project`, `--json`                                              |
+| `history` | History for all projects or one project, newest first | `--project`, `--since`, `--until`, `--limit`, `--offset`, `--json` |
+| `at`      | The latest status at or before a specified time       | `--project`, `--at`, `--json`                                      |
+| `export`  | Export all records or one project's records           | `--project`, `--format json\|jsonl`                                |
 
 All six actions can also use the compatible `status <action>` form, for example `pmgr status export`. Human-readable multi-record results list project, status, occurrence time, and summary, or `No entries found.` when empty. `add`, `import`, `current`, `history`, and `at` support `--json`; `export` uses `--format` to select its format.
 

package/README_CN.md

@@ -33,7 +33,7 @@ PMGR_DB_PATH=/absolute/path/projects.sqlite npx --yes --package project-mgr pmgr
 
 ## 安装 Agent Skill
 
-仓库包含 `skills/project-mgr`，用于指导兼容 Skills 的 AI Agent 新增、导入、查询和导出项目状态记录。通过 [skills CLI](https://skills.sh/docs/cli) 安装：
+仓库包含 `project-mgr` Skill，在 Skill 选择器中显示为 **project-mgr**。它用于指导兼容 Skills 的 AI Agent 新增、导入、查询和导出本地项目状态历史。通过 [skills CLI](https://skills.sh/docs/cli) 安装：
 
 ```bash
 npx skills add deanplus/project-manager
@@ -41,9 +41,28 @@ npx skills add deanplus/project-manager
 
 安装器会检测支持的 Agent，并询问安装目标。无需单独安装 `project-mgr`：该 Skill 会通过 `npx` 运行 CLI。安装后重启或重新加载所选 Agent。
 
-该 Skill 与 CLI 使用相同的 `PMGR_DB_PATH` 规则：默认使用 `~/.local/share/project-mgr/project-mgr.sqlite`；如需使用其他账本，请设置绝对路径。手工或探索性操作请使用独立数据库，例如 `PMGR_DB_PATH=/tmp/project-mgr-skill-test.sqlite`，避免写入默认账本。
+### 调用 Skill
+
+在 Codex 的提示词中直接写 `$project-mgr`。也可以输入 `/pro`，然后在选择器中选择 **project-mgr**。其他 Agent 请使用其显式 Skill 语法，或从 Skills 菜单选择 `project-mgr`。
+
+Skill 名称后直接使用自然语言即可，Agent 会把请求转换成 CLI 命令。例如：
+
+```text
+使用 $project-mgr 查询 project-mgr 的当前状态和最近 10 条更新。
+
+使用 $project-mgr 记录 project-mgr 的状态：active；已发布 Agent Skill；
+下一步收集用户反馈。
 
-随后可向 Agent 提出，例如：`使用 project-mgr，在查询当前状态后新增一条 active 状态。`
+使用 $project-mgr 批量记录状态：api 因认证问题 blocked；web 为 active，
+dashboard 已完成。
+
+使用 $project-mgr 和 PMGR_DB_PATH=/tmp/project-mgr-test.sqlite 添加一条测试状态，
+然后查询其历史。
+```
+
+Agent 应在写入前先查询；如果缺少项目名、状态或摘要等必填信息，它会向用户确认。
+
+该 Skill 与 CLI 使用相同的 `PMGR_DB_PATH` 规则：默认使用 `~/.local/share/project-mgr/project-mgr.sqlite`；如需使用其他账本，请设置绝对路径。手工或探索性操作请使用独立数据库，例如 `PMGR_DB_PATH=/tmp/project-mgr-skill-test.sqlite`，避免写入默认账本。
 
 ## 从源码构建
 
@@ -138,6 +157,9 @@ pnpm start history \
   --limit 20 \
   --offset 0
 
+# 查询全部项目的近期历史。
+pnpm start history --limit 20 --json
+
 pnpm start at \
   --project project-mgr \
   --at 2026-08-03T12:00:00+08:00 \
@@ -191,12 +213,12 @@ pnpm start import --file statuses.jsonl --json
 
 ## 查询与导出
 
-| 命令      | 用途                       | 主要选项                                                           |
-| --------- | -------------------------- | ------------------------------------------------------------------ |
-| `current` | 所有项目或单项目的当前状态 | `--project`、`--json`                                              |
-| `history` | 单项目历史，最新记录在前   | `--project`、`--since`、`--until`、`--limit`、`--offset`、`--json` |
-| `at`      | 指定时间点及之前的最后状态 | `--project`、`--at`、`--json`                                      |
-| `export`  | 导出全部或单项目记录       | `--project`、`--format json\|jsonl`                                |
+| 命令      | 用途                               | 主要选项                                                           |
+| --------- | ---------------------------------- | ------------------------------------------------------------------ |
+| `current` | 所有项目或单项目的当前状态         | `--project`、`--json`                                              |
+| `history` | 全部或单个项目的历史，最新记录在前 | `--project`、`--since`、`--until`、`--limit`、`--offset`、`--json` |
+| `at`      | 指定时间点及之前的最后状态         | `--project`、`--at`、`--json`                                      |
+| `export`  | 导出全部或单项目记录               | `--project`、`--format json\|jsonl`                                |
 
 全部六个 action 仍可使用 `status <action>` 的兼容形式，例如 `pmgr status export`。人类可读的多条结果按“项目、状态、发生时间、摘要”输出；为空时输出 `No entries found.`。`add`、`import`、`current`、`history`、`at` 支持 `--json`；`export` 由 `--format` 控制格式。
 

package/dist/cli.js

@@ -165,7 +165,7 @@ export function run(argv, write = process.stdout.write.bind(process.stdout)) {
                 output(current(db, stringFlag(flags, "project")), json, write);
                 break;
             case "history":
-                output(history(db, stringFlag(flags, "project", true), {
+                output(history(db, stringFlag(flags, "project"), {
                     since: stringFlag(flags, "since") &&
                         parseTime(stringFlag(flags, "since"), "since"),
                     until: stringFlag(flags, "until") &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-mgr",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Local-first append-only project status ledger",
   "type": "module",
   "bin": {

package/skills/project-mgr/SKILL.md

@@ -3,7 +3,7 @@ name: project-mgr
 description: Manage project status with the local-first project-mgr CLI. Use when an AI agent needs to add an append-only project update, import status records, query current or historical project state, or export a status ledger.
 ---
 
-# Project Mgr
+# project-mgr
 
 Use `npx --yes --package project-mgr pmgr`. In a source checkout, use `pnpm pmgr` instead.
 
@@ -26,6 +26,7 @@ npx --yes --package project-mgr pmgr add --project my-project --status active --
 # Query current state, history, or state at a time.
 npx --yes --package project-mgr pmgr current --project my-project --json
 npx --yes --package project-mgr pmgr history --project my-project --limit 20 --json
+npx --yes --package project-mgr pmgr history --limit 20 --json
 npx --yes --package project-mgr pmgr at --project my-project --at 2026-08-03T12:00:00+08:00 --json
 
 # Import validated JSON/JSONL, or export portable records.

package/skills/project-mgr/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
-  display_name: "Project Manager"
-  short_description: "Manage local project status records safely"
-  default_prompt: "Use $project-mgr to add and inspect this project status."
+  display_name: "project-mgr"
+  short_description: "Append and query local project status history"
+  default_prompt: "Use $project-mgr to record or query this project status history."

package/src/cli.ts

@@ -210,7 +210,7 @@ export function run(
         break;
       case "history":
         output(
-          history(db, stringFlag(flags, "project", true), {
+          history(db, stringFlag(flags, "project"), {
             since:
               stringFlag(flags, "since") &&
               parseTime(stringFlag(flags, "since"), "since"),

package/test/core.test.ts

@@ -314,6 +314,12 @@ test("CLI supports add, import, reads, errors, and export formats", () => {
     execute(["status", "history", "--project", "cli", "--json"]),
     /added/,
   );
+  assert.deepEqual(
+    JSON.parse(execute(["history", "--limit", "2", "--json"])).map(
+      (item: { project: string }) => item.project,
+    ),
+    ["human", "cli"],
+  );
   assert.equal(
     JSON.parse(
       execute([
@@ -366,7 +372,6 @@ test("CLI supports add, import, reads, errors, and export formats", () => {
     () => execute(["status", "history", "--project", "cli", "--limit", "1.5"]),
     ValidationError,
   );
-  assert.throws(() => execute(["status", "history"]), ValidationError);
   assert.throws(() => execute(["status", "add", "--project"]), ValidationError);
   assert.throws(
     () =>