@liuyoumi/codex-history 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.0 - 2026-05-29
+
+### Changed
+
+- Narrow `--grep` matching to conversation text fields and let `--cwd` match working-directory path fragments.
+
 ## 0.4.0 - 2026-05-29
 
 ### Added

package/README.en.md

@@ -77,10 +77,10 @@ Type 019e6885 to confirm:
 | --- | --- |
 | `codex-history doctor` | Check whether the local Codex data layout is supported. |
 | `codex-history list` | List local conversations. |
-| `codex-history list --grep <keyword>` | Filter conversations by title, id, or cwd. |
+| `codex-history list --grep <keyword>` | Filter conversations by title, first user message, or preview. |
 | `codex-history purge <id...>` | Remove one or more resolved local conversations after confirmation. |
-| `codex-history purge --cwd <path>` | Remove local conversations matching a working directory after confirmation. |
-| `codex-history purge --grep <keyword>` | Remove local conversations matching title, id, or cwd after confirmation. |
+| `codex-history purge --cwd <path>` | Remove local conversations whose working directory contains the path fragment after confirmation. |
+| `codex-history purge --grep <keyword>` | Remove local conversations matching title, first user message, or preview after confirmation. |
 | `codex-history purge-orphans` | Remove orphaned local data after confirmation. |
 
 ### `doctor`
@@ -112,7 +112,13 @@ Default output is one line per conversation:
 019e6874  Review Astro blog visual plan
 ```
 
-`--grep` filters by displayed title, thread id, and cwd. It does not search or print prompt bodies.
+`--grep` filters by displayed title, first user message, and preview. It does not match thread ids or cwd values, and it does not search or print full transcript bodies.
+
+`--cwd` filters by a working-directory path fragment, so you can provide either a full path or a project name / partial path:
+
+```bash
+codex-history list --cwd codex-history
+```
 
 Use the short id shown by `list`, or paste a full thread id, when running `purge`.
 
@@ -152,7 +158,7 @@ codex-history purge --archived
 codex-history purge --cwd /Users/me/Projects/example --grep "Astro"
 ```
 
-`--cwd`, `--grep`, and `--archived` can be combined. Combined filters delete only conversations that match every provided condition. By default, filter mode matches non-archived conversations only; use `--archived` to target archived conversations. Filtered purge prints a batch plan and requires typing `purge-selected`. Filters cannot be combined with explicit ids.
+`--cwd`, `--grep`, and `--archived` can be combined. Combined filters delete only conversations that match every provided condition. `--cwd` matches working-directory path fragments, while `--grep` matches only title, first user message, and preview. By default, filter mode matches non-archived conversations only; use `--archived` to target archived conversations. Filtered purge prints a batch plan and matched cwd values, then requires typing `purge-selected`. Filters cannot be combined with explicit ids.
 
 For scripts or non-interactive shells, use `--force`:
 

package/README.md

@@ -77,10 +77,10 @@ Type 019e6885 to confirm:
 | --- | --- |
 | `codex-history doctor` | 检查当前本地 Codex 数据结构是否受支持。 |
 | `codex-history list` | 列出本地对话。 |
-| `codex-history list --grep <keyword>` | 按标题、id 或 cwd 过滤对话。 |
+| `codex-history list --grep <keyword>` | 按标题、首条用户消息或预览过滤对话。 |
 | `codex-history purge <id...>` | 确认后删除一条或多条解析到的本地对话。 |
-| `codex-history purge --cwd <path>` | 确认后删除匹配工作目录的本地对话。 |
-| `codex-history purge --grep <keyword>` | 确认后删除匹配标题、id 或 cwd 的本地对话。 |
+| `codex-history purge --cwd <path>` | 确认后删除工作目录路径包含该片段的本地对话。 |
+| `codex-history purge --grep <keyword>` | 确认后删除匹配标题、首条用户消息或预览的本地对话。 |
 | `codex-history purge-orphans` | 确认后清理本地孤儿数据。 |
 
 ### `doctor`
@@ -112,7 +112,13 @@ codex-history list --pretty=full
 019e6874  评审 Astro 博客视觉方案
 ```
 
-`--grep` 会按显示标题、线程 id、cwd 过滤。它不会搜索或输出对话正文。
+`--grep` 会按显示标题、首条用户消息和预览过滤。它不会匹配线程 id 或 cwd，也不会搜索或输出完整对话正文。
+
+`--cwd` 会按工作目录路径片段过滤，既可以输入完整路径，也可以输入项目名或部分路径：
+
+```bash
+codex-history list --cwd codex-history
+```
 
 执行 `purge` 时，可以使用 `list` 里显示的短 id，也可以粘贴完整 thread id。
 
@@ -152,7 +158,7 @@ codex-history purge --archived
 codex-history purge --cwd /Users/me/Projects/example --grep "Astro"
 ```
 
-`--cwd`、`--grep`、`--archived` 可以组合，组合后只删除同时满足全部条件的对话。默认只匹配未归档对话；如果要删除已归档对话，请使用 `--archived`。过滤式删除会展示批量计划，并要求输入 `purge-selected` 确认。过滤条件不能和 id 同时使用。
+`--cwd`、`--grep`、`--archived` 可以组合，组合后只删除同时满足全部条件的对话。`--cwd` 会匹配工作目录路径片段，`--grep` 只匹配标题、首条用户消息和预览。默认只匹配未归档对话；如果要删除已归档对话，请使用 `--archived`。过滤式删除会展示批量计划和匹配到的 cwd，并要求输入 `purge-selected` 确认。过滤条件不能和 id 同时使用。
 
 脚本或非交互环境可以使用 `--force`：
 

package/dist/cli.js

@@ -290,8 +290,8 @@ function listThreads(paths, options = {}) {
     params.push(1);
   }
   if (options.cwd) {
-    where.push(`${quoteIdentifier("cwd")} = ?`);
-    params.push(options.cwd);
+    where.push(`lower(${quoteIdentifier("cwd")}) like lower(?) escape '\\'`);
+    params.push(`%${escapeLike(options.cwd)}%`);
   }
   const whereClause = where.length > 0 ? `where ${where.join(" and ")}` : "";
   const hasLimit = typeof limit === "number" && Number.isFinite(limit) && limit > 0;
@@ -321,9 +321,10 @@ function filterThreads(threads, keyword) {
   const normalizedKeyword = keyword.toLocaleLowerCase();
   return threads.filter((thread) => {
     const haystack = [
-      thread.id,
       thread.title,
-      thread.cwd
+      thread.sourceTitle,
+      thread.firstUserMessage,
+      thread.preview
     ].join("\n").toLocaleLowerCase();
     return haystack.includes(normalizedKeyword);
   });
@@ -1139,7 +1140,7 @@ program.command("doctor").description("Check whether the local Codex data model
     return formatDoctor(report);
   })
 );
-program.command("list").description("List local Codex conversations.").option("--limit <number>", "Maximum rows to show", parseInteger).option("--all", "Include archived and non-archived threads").option("--archived", "Show archived threads").option("--cwd <path>", "Filter by exact working directory").option("--grep <keyword>", "Filter by title, id, or cwd keyword").option("--pretty <format>", "Output format: oneline, medium, full", parsePretty, "oneline").action(
+program.command("list").description("List local Codex conversations.").option("--limit <number>", "Maximum rows to show", parseInteger).option("--all", "Include archived and non-archived threads").option("--archived", "Show archived threads").option("--cwd <path>", "Filter by working directory path fragment").option("--grep <keyword>", "Filter by title, first user message, or preview keyword").option("--pretty <format>", "Output format: oneline, medium, full", parsePretty, "oneline").action(
   (options) => runCommand(
     () => formatThreads(
       listCommand(currentPaths(), {
@@ -1154,7 +1155,7 @@ program.command("list").description("List local Codex conversations.").option("-
     )
   )
 );
-program.command("purge").argument("[threadIds...]", "Codex thread id(s) or unique short id prefix(es) to purge").option("--force", "Skip interactive confirmation").option("--cwd <path>", "Filter conversations by exact working directory").option("--grep <keyword>", "Filter conversations by title, id, or cwd keyword").option("--archived", "Filter archived conversations").description("Purge local Codex conversation(s) after target confirmation.").action(
+program.command("purge").argument("[threadIds...]", "Codex thread id(s) or unique short id prefix(es) to purge").option("--force", "Skip interactive confirmation").option("--cwd <path>", "Filter conversations by working directory path fragment").option("--grep <keyword>", "Filter conversations by title, first user message, or preview keyword").option("--archived", "Filter archived conversations").description("Purge local Codex conversation(s) after target confirmation.").action(
   (threadIds, options) => runCommand(async () => {
     const paths = currentPaths();
     const requestedThreadIds = threadIds ?? [];
@@ -1472,6 +1473,7 @@ function formatBatchPurgeConfirmation(plan) {
     "SQLite row changes:",
     ...formatSqliteRows(summarizePlannedSqliteRows(plan.plans)),
     "",
+    ...formatMatchedCwdValues(plan),
     ...formatBatchPurgeExamples(plan),
     colorize("dim", "This cannot be undone."),
     ""
@@ -1486,16 +1488,28 @@ function formatBatchPurgeSelection(plan) {
 function formatPurgeFilters(filters) {
   const parts = [];
   if (filters.cwd) {
-    parts.push(`cwd=${filters.cwd}`);
+    parts.push(`cwd contains "${filters.cwd}"`);
   }
   if (filters.grep) {
-    parts.push(`grep=${filters.grep}`);
+    parts.push(`grep="${filters.grep}"`);
   }
   if (filters.archived) {
     parts.push("archived=true");
   }
   return parts.length > 0 ? parts.join(", ") : "filtered conversations";
 }
+function formatMatchedCwdValues(plan) {
+  if (plan.source !== "filtered" || !plan.filters?.cwd || plan.plans.length === 0) {
+    return [];
+  }
+  const cwdValues = [...new Set(plan.plans.map((item) => item.target.cwd))].sort();
+  const shown = cwdValues.slice(0, 5);
+  const lines = ["Matched cwd values:", ...shown.map((cwd) => `- ${colorize("dim", cwd)}`), ""];
+  if (cwdValues.length > shown.length) {
+    lines.push(`Showing ${shown.length} of ${cwdValues.length} cwd value(s).`, "");
+  }
+  return lines;
+}
 function formatPurgeOrphansConfirmation(plan) {
   return [
     "About to purge orphaned local Codex data:",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liuyoumi/codex-history",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "CLI for listing and safely purging local Codex conversation history",
   "type": "module",
   "bin": {