@blxzer/cursor-trellis 0.3.3 → 0.3.4

package/CHANGELOG.md

@@ -11,6 +11,12 @@ SemVer: [semver.org](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.3.4] - 2026-07-04
+
+### Added
+
+- **feat(cursor)**: auto-rename the **main** Agent chat tab to the cstl task **directory name** after `task.py select` or `task.py start-execution --approved` (`rename-session-for-task.py` `afterShellExecution` hook + `cstl-session-rename.mdc` rule). Uses `cursor-app-control` `rename_chat` when available; skips silently when MCP is missing. Does not rename on `task.py create`. Native and BYOK share the same path.
+
 ## [0.3.3] - 2026-07-04
 
 Follow-up polish after 0.3.2 coexistence release: closes known limitations from the runtime-isolation task.

package/README.zh-CN.md

@@ -197,6 +197,7 @@ smart-search --version
 | --- | --- |
 | `pnpm build` | `tsc` + 拷贝模板 |
 | `pnpm test` | Vitest |
+| `pnpm mirror-check` | Dogfood `.cursor` / `.agents` vs templates |
 | `pnpm run sync:smart-search` | 刷新 vendor |
 
 Release 与 npm 发布流程**不在**公开 README 中；见内部维护文档。

package/dist/migrations/manifests/0.3.2.json

@@ -0,0 +1,16 @@
+{
+  "version": "0.3.2",
+  "description": "Reissue 0.3.1 runtime isolation with publishable core/cli pair (.cstl/)",
+  "breaking": true,
+  "recommendMigrate": true,
+  "changelog": "**@blxzer/cursor-trellis 0.3.2**\n\nReissues 0.3.1 content with a publishable `@blxzer/cursor-trellis-core` pair. Runtime root `.trellis/` → **`.cstl/`** for coexistence with upstream Trellis.\n\n```bash\nnpm install -g @blxzer/cursor-trellis@0.3.2\ncstl update --migrate\n```",
+  "migrations": [
+    {
+      "type": "rename-dir",
+      "from": ".trellis",
+      "to": ".cstl",
+      "description": "v0.3.2: cursor-trellis runtime dir isolation (.trellis -> .cstl)"
+    }
+  ],
+  "notes": "0.3.1 was withdrawn from npm; use 0.3.2+ for the .cstl/ migration."
+}

package/dist/migrations/manifests/0.3.3.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.3",
+  "description": "Coexistence polish: AGENTS CSTL block uninstall, hash scope, publish CI",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.3.3**\n\n- feat(uninstall): strip CSTL managed block from AGENTS.md while preserving upstream TRELLIS block\n- feat(hash): AGENTS.md template hash tracks CSTL block only\n- docs(spec): cursor-trellis release coexistence guide\n- ci: publish workflow on cstl-v* tags",
+  "migrations": [],
+  "notes": "Run `cstl update` to sync templates. No `--migrate` required."
+}

package/dist/migrations/manifests/0.3.4.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.4",
+  "description": "Rename main Cursor chat to cstl task directory on select/start-execution",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**@blxzer/cursor-trellis 0.3.4**\n\n- feat(cursor): auto-rename main Agent chat tab to task directory name after `task.py select` or `start-execution --approved` (`rename-session-for-task.py` + `cstl-session-rename.mdc`). Uses `cursor-app-control` `rename_chat` when available; silent skip when MCP missing. No rename on `task.py create`.",
+  "migrations": [],
+  "notes": "Run `cstl update` to sync new hook, rule, and hooks.json wiring."
+}

package/dist/templates/common/bundled-skills/cstl-meta/references/platform-files/hooks-and-settings.md

@@ -27,8 +27,9 @@ Whether legacy settings/config files exist in a project depends on which histori
 | `inject-workflow-state.py` | Parses `[workflow-state:STATUS]` blocks in `.cstl/workflow.md` and emits the body matching the selected task status. Falls back to `Refer to workflow.md for current step.` when no matching block exists. |
 | `inject-subagent-context.py` | Injects PRD, JSONL context, and related spec/research into sub-agents. |
 | `inject-shell-session-context.py` | Lets shell commands inherit Trellis session identity. |
+| `rename-session-for-task.py` | After successful `task.py select` / `start-execution --approved`, prompts main-session rename to task directory name (best-effort `rename_chat`). |
 
-Cursor exposes sessionStart, preToolUse on Task/Subagent, beforeShellExecution, and stop events. Confirm against the current Cursor release before wiring a new event name; the available event surface has evolved over time and historical platform documentation may be stale.
+Cursor exposes sessionStart, preToolUse on Task/Subagent, beforeShellExecution, afterShellExecution, and stop events. Confirm against the current Cursor release before wiring a new event name; the available event surface has evolved over time and historical platform documentation may be stale.
 
 ## Local Change Scenarios
 

package/dist/templates/cursor/fixtures/expected-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expected-rules.d.ts","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EAoBvC,CAAC"}
+{"version":3,"file":"expected-rules.d.ts","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EAyBvC,CAAC"}

package/dist/templates/cursor/fixtures/expected-rules.js

@@ -22,5 +22,10 @@ export const expectedRules = [
         requiredSections: ["Native", "BYOK", "codegraph", "smart-search"],
         minBytes: 600,
     },
+    {
+        filename: "cstl-session-rename.mdc",
+        requiredSections: ["rename_chat", "select", "start-execution", "skip silently"],
+        minBytes: 300,
+    },
 ];
 //# sourceMappingURL=expected-rules.js.map

package/dist/templates/cursor/fixtures/expected-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"expected-rules.js","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,QAAQ,EAAE,iBAAiB;QAC3B,gBAAgB,EAAE;YAChB,eAAe;YACf,qBAAqB;YACrB,cAAc;SACf;QACD,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,4BAA4B;QACtC,gBAAgB,EAAE,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;QAChE,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,uBAAuB;QACjC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC;QACjE,QAAQ,EAAE,GAAG;KACd;CACF,CAAC"}
+{"version":3,"file":"expected-rules.js","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,QAAQ,EAAE,iBAAiB;QAC3B,gBAAgB,EAAE;YAChB,eAAe;YACf,qBAAqB;YACrB,cAAc;SACf;QACD,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,4BAA4B;QACtC,gBAAgB,EAAE,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;QAChE,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,uBAAuB;QACjC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC;QACjE,QAAQ,EAAE,GAAG;KACd;IACD;QACE,QAAQ,EAAE,yBAAyB;QACnC,gBAAgB,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,eAAe,CAAC;QAC/E,QAAQ,EAAE,GAAG;KACd;CACF,CAAC"}

package/dist/templates/cursor/hooks.json

@@ -26,6 +26,13 @@
         "timeout": 5
       }
     ],
+    "afterShellExecution": [
+      {
+        "command": "{{PYTHON_CMD}} .cursor/hooks/rename-session-for-task.py",
+        "matcher": "task\\.py.*(select|start-execution)",
+        "timeout": 5
+      }
+    ],
     "stop": [
       {
         "command": "{{PYTHON_CMD}} .cursor/hooks/research-end-retrieval-pack.py",

package/dist/templates/cursor/rules/cstl-session-rename.mdc

@@ -0,0 +1,31 @@
+---
+description: "Rename Cursor chat to cstl task directory name after select or start-execution (cursor-app-control rename_chat)"
+alwaysApply: true
+---
+
+# Trellis session rename (Cursor main session)
+
+Encourage **one task per main Agent chat**. Subagent / Task child windows are out of scope.
+
+## When to rename
+
+After **you** successfully run either command in the **main** session (same turn or immediately after shell output):
+
+- `python ./.cstl/scripts/task.py select <task-dir>`
+- `python ./.cstl/scripts/task.py start-execution <task-dir> --approved`
+
+Do **not** rename for `task.py create` alone (create does not bind the session).
+
+## Title
+
+Use the task **directory name** only (e.g. `07-04-cstl-session-rename`), not `task.json` `title`.
+
+## How
+
+1. If `cursor-app-control` MCP `rename_chat` is available, call it once with `title` = directory name.
+2. If the tool is **not** available (BYOK or other environments), **skip silently** — no user prompt to rename manually.
+3. Do not rename repeatedly for the same task in the same session unless the user switched to a different task directory.
+
+## Native vs BYOK
+
+Same rule for both. BYOK availability of `rename_chat` is environment-dependent; never fail the task workflow when rename is unavailable.

package/dist/templates/shared-hooks/index.d.ts

@@ -11,7 +11,7 @@ export interface HookScript {
     /** Script content — no placeholders, ready to write directly */
     content: string;
 }
-export type SharedHookName = "session-start.py" | "inject-shell-session-context.py" | "inject-retrieval-plan.py" | "inject-workflow-state.py" | "inject-subagent-context.py" | "research-end-retrieval-pack.py";
+export type SharedHookName = "session-start.py" | "inject-shell-session-context.py" | "rename-session-for-task.py" | "inject-retrieval-plan.py" | "inject-workflow-state.py" | "inject-subagent-context.py" | "research-end-retrieval-pack.py";
 export type SharedHookPlatform = "claude" | "cursor" | "codex" | "gemini" | "qoder" | "copilot" | "codebuddy" | "droid" | "kiro";
 /**
  * Which shared hooks each platform actually invokes. Single source of truth

package/dist/templates/shared-hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iCAAiC,GACjC,0BAA0B,GAC1B,0BAA0B,GAC1B,4BAA4B,GAC5B,gCAAgC,CAAC;AAErC,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,SAAS,cAAc,EAAE,CAgC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,EAAE,CAWnD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,iCAAiC,GACjC,4BAA4B,GAC5B,0BAA0B,GAC1B,0BAA0B,GAC1B,4BAA4B,GAC5B,gCAAgC,CAAC;AAErC,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,WAAW,GACX,OAAO,GACP,MAAM,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAC3C,kBAAkB,EAClB,SAAS,cAAc,EAAE,CAiC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,EAAE,CAWnD;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,kBAAkB,GAC3B,UAAU,EAAE,CAGd"}

package/dist/templates/shared-hooks/index.js

@@ -45,6 +45,7 @@ export const SHARED_HOOKS_BY_PLATFORM = {
     cursor: [
         "session-start.py",
         "inject-shell-session-context.py",
+        "rename-session-for-task.py",
         "inject-retrieval-plan.py",
         "inject-subagent-context.py",
         "research-end-retrieval-pack.py",

package/dist/templates/shared-hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AA4BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,MAAM,EAAE;QACN,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,KAAK,EAAE,CAAC,0BAA0B,CAAC;IACnC,MAAM,EAAE,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACxD,KAAK,EAAE,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACvD,OAAO,EAAE,CAAC,0BAA0B,CAAC;IACrC,SAAS,EAAE;QACT,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,IAAI,EAAE,CAAC,4BAA4B,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/shared-hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AA6BD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAGjC;IACF,MAAM,EAAE;QACN,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,MAAM,EAAE;QACN,kBAAkB;QAClB,iCAAiC;QACjC,4BAA4B;QAC5B,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,KAAK,EAAE,CAAC,0BAA0B,CAAC;IACnC,MAAM,EAAE,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACxD,KAAK,EAAE,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;IACvD,OAAO,EAAE,CAAC,0BAA0B,CAAC;IACrC,SAAS,EAAE;QACT,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,KAAK,EAAE;QACL,kBAAkB;QAClB,0BAA0B;QAC1B,4BAA4B;QAC5B,gCAAgC;KACjC;IACD,IAAI,EAAE,CAAC,4BAA4B,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAChC,IAAI,EAAE,CAAC;IAEV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA4B;IAE5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,OAAO,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/templates/shared-hooks/rename-session-for-task.py

@@ -0,0 +1,231 @@
+#!/usr/bin/env python3
+"""Cursor afterShellExecution hook: prompt session rename after task bind/start.
+
+When the agent successfully runs `task.py select` or
+`task.py start-execution <task> --approved`, emit an agent_message (best-effort)
+so the main session calls cursor-app-control `rename_chat` with the task
+directory name. MCP unavailable → agent skips silently per cstl-session-rename rule.
+"""
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import re
+import shlex
+import sys
+from pathlib import Path
+from typing import Any
+
+DIR_WORKFLOW = ".cstl"
+DIR_RUNTIME = ".runtime"
+DIR_SESSION_RENAME = "session-rename"
+ANSI_ESCAPE = re.compile(r"\x1b\[[0-9;]*m")
+CONTEXT_IDENTITY_KEYS = (
+    "session_id",
+    "sessionId",
+    "sessionID",
+    "conversation_id",
+    "conversationId",
+    "conversationID",
+    "transcript_path",
+    "transcriptPath",
+    "transcript",
+)
+
+
+def _string_value(value: Any) -> str | None:
+    if isinstance(value, str):
+        stripped = value.strip()
+        return stripped or None
+    return None
+
+
+def _strip_ansi(text: str) -> str:
+    return ANSI_ESCAPE.sub("", text)
+
+
+def _find_trellis_root(start: Path) -> Path | None:
+    current = start.resolve()
+    while True:
+        if (current / DIR_WORKFLOW).is_dir():
+            return current
+        if current == current.parent:
+            return None
+        current = current.parent
+
+
+def _task_py_token_index(tokens: list[str]) -> int | None:
+    for index, token in enumerate(tokens):
+        if Path(token.strip("\"'")).name == "task.py":
+            return index
+    return None
+
+
+def parse_rename_intent(command: str) -> dict[str, str] | None:
+    """Return subcommand + task_ref when command should trigger rename."""
+    try:
+        tokens = shlex.split(command, posix=os.name != "nt")
+    except ValueError:
+        return None
+
+    task_index = _task_py_token_index(tokens)
+    if task_index is None or task_index + 1 >= len(tokens):
+        return None
+
+    subcommand = tokens[task_index + 1]
+    if subcommand == "select":
+        if task_index + 2 >= len(tokens):
+            return None
+        return {"subcommand": subcommand, "task_ref": tokens[task_index + 2]}
+    if subcommand == "start-execution":
+        if "--approved" not in tokens:
+            return None
+        if task_index + 2 >= len(tokens):
+            return None
+        task_ref = tokens[task_index + 2]
+        if task_ref.startswith("-"):
+            return None
+        return {"subcommand": subcommand, "task_ref": task_ref}
+    return None
+
+
+def task_directory_name(task_ref: str) -> str:
+    """Use task folder basename as the chat title."""
+    cleaned = task_ref.strip().strip("\"'")
+    return Path(cleaned.replace("\\", "/")).name
+
+
+def shell_output_succeeded(subcommand: str, output: str) -> bool:
+    text = _strip_ansi(output or "")
+    if "Error:" in text or "error:" in text.lower():
+        return False
+    if subcommand == "select":
+        return "Selected task:" in text or "✓ Selected task" in text
+    if subcommand == "start-execution":
+        return "Execution approved" in text or "✓ Execution approved" in text
+    return False
+
+
+def _safe_context_filename(context_key: str) -> str:
+    digest = hashlib.sha256(context_key.encode("utf-8")).hexdigest()[:24]
+    return f"{digest}.json"
+
+
+def _rename_state_dir(root: Path) -> Path:
+    return root / DIR_WORKFLOW / DIR_RUNTIME / DIR_SESSION_RENAME
+
+
+def _load_rename_state(path: Path) -> dict[str, Any]:
+    if not path.is_file():
+        return {}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except (json.JSONDecodeError, OSError):
+        return {}
+    return data if isinstance(data, dict) else {}
+
+
+def _should_emit_rename(state: dict[str, Any], title: str) -> bool:
+    return state.get("last_title") != title
+
+
+def _write_rename_state(path: Path, context_key: str, title: str) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    payload = {
+        "context_key": context_key,
+        "last_title": title,
+    }
+    path.write_text(
+        json.dumps(payload, indent=2, ensure_ascii=False) + "\n",
+        encoding="utf-8",
+    )
+
+
+def _agent_rename_message(title: str) -> str:
+    return (
+        "Trellis session rename: call cursor-app-control MCP `rename_chat` once "
+        f'with title "{title}" (task directory name). '
+        "If rename_chat is not in your tool list, skip silently — do not ask the user "
+        "to rename manually."
+    )
+
+
+def _load_context_key(root: Path, hook_input: dict[str, Any]) -> str | None:
+    scripts_dir = root / DIR_WORKFLOW / "scripts"
+    if str(scripts_dir) not in sys.path:
+        sys.path.insert(0, str(scripts_dir))
+    from common.active_task import resolve_context_key  # type: ignore[import-not-found]
+
+    if not any(_string_value(hook_input.get(key)) for key in CONTEXT_IDENTITY_KEYS):
+        return None
+    return resolve_context_key(hook_input, platform="cursor")
+
+
+def main() -> int:
+    if os.environ.get("TRELLIS_HOOKS") == "0" or os.environ.get("TRELLIS_DISABLE_HOOKS") == "1":
+        print("{}")
+        return 0
+
+    try:
+        hook_input = json.loads(sys.stdin.read())
+    except (json.JSONDecodeError, ValueError):
+        hook_input = {}
+    if not isinstance(hook_input, dict):
+        hook_input = {}
+
+    event = _string_value(hook_input.get("hook_event_name")) or "afterShellExecution"
+    if event != "afterShellExecution":
+        print("{}")
+        return 0
+
+    command = _string_value(hook_input.get("command")) or ""
+    intent = parse_rename_intent(command)
+    if intent is None:
+        print("{}")
+        return 0
+
+    output = _string_value(hook_input.get("output")) or ""
+    if not shell_output_succeeded(intent["subcommand"], output):
+        print("{}")
+        return 0
+
+    title = task_directory_name(intent["task_ref"])
+    if not title:
+        print("{}")
+        return 0
+
+    cwd = Path(_string_value(hook_input.get("cwd")) or os.getcwd())
+    root = _find_trellis_root(cwd)
+    if root is None:
+        print("{}")
+        return 0
+
+    context_key = _load_context_key(root, hook_input)
+    if not context_key:
+        print("{}")
+        return 0
+
+    state_path = _rename_state_dir(root) / _safe_context_filename(context_key)
+    state = _load_rename_state(state_path)
+    if not _should_emit_rename(state, title):
+        print("{}")
+        return 0
+
+    try:
+        _write_rename_state(state_path, context_key, title)
+    except OSError:
+        print("{}")
+        return 0
+
+    print(
+        json.dumps(
+            {"agent_message": _agent_rename_message(title)},
+            ensure_ascii=False,
+        ),
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/dist/templates/trellis/tasks/templates/release-execution/design.md

@@ -1,61 +1,61 @@
-# Design — Release execution
-
-## Boundary
-
-This task **may** mutate remotes **only** after explicit user approval captured in `verify.md` (quote or paraphrase the approval request/response).
-
-## Release status model (this task)
-
-| Status | When to use |
-| --- | --- |
-| **published** | npm and/or git remote actions completed for the approved version |
-| **not published** | Execution aborted or only dry-run/preflight completed |
-| **blocked** | Preflight failed; do not publish until fixed |
-| **waived** | User approved proceeding despite a listed risk |
-| **deferred** | User postponed publish after readiness |
-
-Do not mark **ready to publish** here — that remains the readiness task outcome.
-
-## Approval gate (mandatory)
-
-Before any of the following, stop and obtain explicit user approval:
-
-- `node scripts/release.js …` (bundles bump, commit, tag, push)
-- `npm publish` / CI publish workflow dispatch
-- `git tag` / `git push` (including `--tags`)
-- GitHub **Create release** or promotion workflows
-
-Document in `verify.md`:
-
-```markdown
-## Publish approval evidence
-
-User explicitly approved: yes/no
-Approved version: …
-Approved dist-tag: …
-Approved remote actions: tag / push / npm publish / …
-```
-
-## Evidence contract (`verify.md`)
-
-1. **Readiness link** — path to readiness `handoff.md`.
-2. **Publish approval evidence** — as above.
-3. **Preflight results** — `check-versions`, `publish-plan`, `verify-packed-cli`.
-4. **Execution log** — commands run (redact tokens); pass/fail.
-5. **Post-publish smoke** — registry check, `trellis --version`, dogfood smoke commands.
-6. **Validation evidence** — tests run after publish if applicable.
-
-## Trellis CLI reference sequence (after approval)
-
-Typical human/CI sequence (do not automate without approval):
-
-```bash
-cd packages/cli
-node scripts/release-preflight.js check-versions
-node scripts/release-preflight.js publish-plan
-# After approval:
-pnpm --filter @blxzer/cursor-trellis release:beta   # or patch/minor/major per policy
-node scripts/release-preflight.js verify-npm --package all
-```
-
+# Design — Release execution
+
+## Boundary
+
+This task **may** mutate remotes **only** after explicit user approval captured in `verify.md` (quote or paraphrase the approval request/response).
+
+## Release status model (this task)
+
+| Status | When to use |
+| --- | --- |
+| **published** | npm and/or git remote actions completed for the approved version |
+| **not published** | Execution aborted or only dry-run/preflight completed |
+| **blocked** | Preflight failed; do not publish until fixed |
+| **waived** | User approved proceeding despite a listed risk |
+| **deferred** | User postponed publish after readiness |
+
+Do not mark **ready to publish** here — that remains the readiness task outcome.
+
+## Approval gate (mandatory)
+
+Before any of the following, stop and obtain explicit user approval:
+
+- `node scripts/release.js …` (bundles bump, commit, tag, push)
+- `npm publish` / CI publish workflow dispatch
+- `git tag` / `git push` (including `--tags`)
+- GitHub **Create release** or promotion workflows
+
+Document in `verify.md`:
+
+```markdown
+## Publish approval evidence
+
+User explicitly approved: yes/no
+Approved version: …
+Approved dist-tag: …
+Approved remote actions: tag / push / npm publish / …
+```
+
+## Evidence contract (`verify.md`)
+
+1. **Readiness link** — path to readiness `handoff.md`.
+2. **Publish approval evidence** — as above.
+3. **Preflight results** — `check-versions`, `publish-plan`, `verify-packed-cli`.
+4. **Execution log** — commands run (redact tokens); pass/fail.
+5. **Post-publish smoke** — registry check, `cstl --version`, dogfood smoke commands.
+6. **Validation evidence** — tests run after publish if applicable.
+
+## Trellis CLI reference sequence (after approval)
+
+Typical human/CI sequence (do not automate without approval):
+
+```bash
+cd packages/cli
+node scripts/release-preflight.js check-versions
+node scripts/release-preflight.js publish-plan
+# After approval:
+pnpm --filter @blxzer/cursor-trellis release:beta   # or patch/minor/major per policy
+node scripts/release-preflight.js verify-npm --package all
+```
+
 `release.js` performs commit, tag, and push — treat it as a single approved bundle or decompose manually per policy.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blxzer/cursor-trellis",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,7 +35,7 @@
     "inquirer": "^9.3.7",
     "undici": "^6.21.0",
     "zod": "^4.4.2",
-    "@blxzer/cursor-trellis-core": "0.3.3"
+    "@blxzer/cursor-trellis-core": "0.3.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",