@blxzer/cursor-trellis 0.4.2 → 0.4.3

package/dist/templates/markdown/framework/dogfood-only-surfaces.md.txt

@@ -11,21 +11,19 @@
 
 | Surface | Where it exists | Why dogfood-only | Decision |
 | --- | --- | --- | --- |
-| `goal_preflight.py` / `goal_run.py` / `goal_review_packet.py` / `goal_wall_smoke.py` | `.cstl/scripts/` in the harness | Portable-goal regression scripts for the maintainer runbook; not needed by consumers | **harness-only** (do not ship as default templates) |
-| `/cstl-goal` slash command + `cstl-goal-worker` / `cstl-goal-reviewer` agents | `.cursor/commands/`, `.cursor/agents/` in the harness | Long-horizon goal surface is an extension; the indexed entry point is the CLI `cstl goal` (see AGENTS.md Goal runtime) | **dogfood** — index shipped (P12), slash not shipped by default |
 | `.claude/skills/*` full suite | `.claude/skills/` in the harness | Cursor default install is **commands-only**; Claude skill files are for Claude platforms, not Cursor consumers | **non-Cursor** (not in Cursor default install) |
-| `.cstl/local/cursor2plus/`, `.cstl/local/*.json5` / `.json.example`, model overlay (e.g. `.cursor/agents/.trellis-model-overlay.local.md`) | `.cstl/local/` + `.cursor/agents/` in the harness | Local BYOK / model-routing patch layer; machine-specific, never force-installed | **local only** — opt-in (`cstl init --cursor2plus`) or manual |
-| Private review-pool items / plan narratives / goal-regression runbook habits | `.cstl/pool/items/`, `{TASK}/research/` in the harness | Personal or project-specific content; the pool **mechanism** ships, the items do not | **narrative not packaged** — mechanism ships, content stays local |
+| `.cstl/local/cursor2plus/` residue (if present) | (retired) | Cursor++ local bundle retired — **not** an optional live surface and **not** an install path; hash-safe cleanup on update | **retired residue** — do not patch; do not treat as optional |
+| Private review-pool items / plan narratives | `.cstl/pool/items/`, `{TASK}/research/` in the harness | Personal or project-specific content; the pool **mechanism** ships, the items do not | **narrative not packaged** — mechanism ships, content stays local |
 | `.codegraph/`, `.worktrees/`, scratch/analysis files | Harness root | Per-machine index / tooling state | **local only** |
 
 ## If a capability seems missing in a consumer repo
 
 1. Check the [internal-skills-cursor-reachability.md](./internal-skills-cursor-reachability.md) matrix — the capability's load channel (guide / script / agent / CLI) should be present.
-2. Check AGENTS.md `Invocation map (short)` — the intended entry point (CLI `cstl goal`, `/cstl-handoff`, etc.).
+2. Check AGENTS.md `Invocation map (short)` — the intended entry point (`/cstl-handoff`, etc.).
 3. If the entry point is a harness-only file from the table above, the capability is intentionally **not** shipped to consumers — do not backfill it by copying harness files.
 
 ## Related
 
 - [internal-skills-cursor-reachability.md](./internal-skills-cursor-reachability.md) — reachability of internal skill names.
 - [prd-grill-frontier.md](./prd-grill-frontier.md) — P11 grilling on-demand path.
-- AGENTS.md `Invocation map (short)` — Goal = CLI, not Parent/Child; session handoff = `/cstl-handoff`.
+- AGENTS.md `Invocation map (short)` — session handoff = `/cstl-handoff`.

package/dist/templates/markdown/framework/execution-strategy.md.txt

@@ -2,6 +2,8 @@
 
 > **Purpose**: Suggest a Development Strategy Contract before you freeze `implement.md`, and align Phase 2 dispatch with the approved contract.
 
+This file answers **who** implements/checks and **where** files are edited. It is **not** a parallel scheduler. Parallel-first (default native parallel, serial needs `serial_reason`) lives in `workflow.md` and `cursor-native-modes-guide.md`; declaration fields in `parallel-first-execution.md`.
+
 ---
 
 ## Two orthogonal dimensions

package/dist/templates/markdown/framework/index.md.txt

@@ -14,6 +14,10 @@ Versioned framework and platform-adapter documentation. Project/team knowledge l
 | [cursor-subagent-policy.md](./cursor-subagent-policy.md) | When to spawn Trellis custom agents; model policy stays on the Cursor side |
 | [retrieval-daily-guide.md](./retrieval-daily-guide.md) | Daily retrieval tool routing (search vs retrieval-pack scoring; web-research gate) |
 | [cursor-native-modes-guide.md](./cursor-native-modes-guide.md) | Mapping Cursor Plan / Ask / Debug / Agent / Multitask onto Trellis phases |
+| [parallel-first-execution.md](./parallel-first-execution.md) | Parallel-first **product** principle + execution contract: native parallel default, `serial_reason`, task-map fields |
+| [middleware-protocol.md](./middleware-protocol.md) | Middleware Protocol v1: one ABI, overlay `.cstl/middleware/`, `update` never writes/deletes/hashes it |
+| [upgrade.md](./upgrade.md) | Terminal-user upgrade half-page: install package → `cstl update` → confirm → keep working |
+| [release-boundary.md](./release-boundary.md) | CSTL this-batch ship vs independent cstl-byok ship; BYOK is not a CSTL release gate |
 | [cursor-context-injection-guide.md](./cursor-context-injection-guide.md) | Which Cursor injection channels actually reach the model |
 | [cursor-semantic-compliance.md](./cursor-semantic-compliance.md) | Plan-vs-exec semantic compliance on Cursor |
 | [injection-budget-guide.md](./injection-budget-guide.md) | Context injection budget across reliable Cursor channels |

package/dist/templates/markdown/framework/internal-skills-cursor-reachability.md.txt

@@ -20,7 +20,7 @@
 | `cstl-check` | `bundled-skills/cstl-check/SKILL.md` | **Agent form `.cursor/agents/cstl-check.md`** (Task tool, dual-axis) — prefer Agent when `execution_mode: worker` | no | yes |
 | `cstl-meta` | `bundled-skills/cstl-meta/SKILL.md` | Maintainer skill; body in npm package; no Cursor project file (not routed in consumer workflows) | no | yes |
 | `cstl-spec-bootstrap` | `bundled-skills/cstl-spec-bootstrap/SKILL.md` | One-shot scaffolding skill; body in npm package; not routed in steady-state consumer workflow | no | yes |
-| `cstl-skill-creator` | `bundled-skills/cstl-skill-creator/SKILL.md` | Authoring-time skill; body in npm package; not routed in consumer workflow | no | yes |
+| `cstl-skill-creator` | `bundled-skills/cstl-skill-creator/SKILL.md` | **Authoring-time (mandatory for new / structural skill edits):** Read `cursor-trellis/packages/cli/src/templates/common/bundled-skills/cstl-skill-creator/SKILL.md` then `…/references/review-checklist.md`. Harness dogfood copy: `.claude/skills/cstl-skill-creator/SKILL.md` and `.claude/skills/cstl-skill-creator/references/review-checklist.md`. Installed npm: `dist/templates/common/bundled-skills/cstl-skill-creator/`. Not a slash command. Skip typo/link-only. Does **not** apply to Cursor product skills (`~/.cursor/skills-cursor/`). | no | yes |
 | `smart-search-cli` | `bundled-skills/smart-search-cli/SKILL.md` | **`python ./.cstl/scripts/run_smart_search.py "<question>" --intent deep-research --json`** (shipped script); Cursor web tools are downgrade-only fallback | no | yes |
 | `cstl-handoff` | `bundled-skills/cstl-handoff/SKILL.md` | **Slash `/cstl-handoff`** (writes session handoff to OS temp dir) | **yes** | n/a (user command) |
 | `cstl-continue` / `cstl-finish-work` / `cstl-start` | `common/commands/*.md` | **Slash `/cstl-continue`, `/cstl-finish-work`** (`cstl-start` filtered on agent-capable platforms) | **yes** | n/a (user commands) |
@@ -28,9 +28,10 @@
 
 ## Reading this matrix
 
-- **Reachable on-demand** (green path): brainstorm → guide; check → agent; smart-search → script; micro-grill → embedded contract.
+- **Reachable on-demand** (green path): brainstorm → guide; check → agent; smart-search → script; micro-grill → embedded contract; **skill authoring → Read `cstl-skill-creator/SKILL.md` + `review-checklist.md`** (paths in the matrix row).
 - **Body in npm package only**: the skill is real and shipped, but a pure Cursor project has no project-relative copy. The workflow routes its **behavior** directly; the full body is discoverable under the installed package (`npm root -g` → `dist/templates/…`). Do not claim these are loaded without reading the actual body when the behavior matters.
-- **Maintainer/authoring-only** (`cstl-meta`, `cstl-spec-bootstrap`, `cstl-skill-creator`): named in AGENTS for framework completeness; not part of the consumer execution path. They stay on the list because they are real shipped skills, but no consumer-facing load path is promised beyond the package body.
+- **Maintainer-only** (`cstl-meta`, `cstl-spec-bootstrap`): named in AGENTS for framework completeness; not part of the consumer execution path. No extra consumer load path beyond the package body.
+- **Authoring-time mandatory** (`cstl-skill-creator`): not a consumer runtime path and not a slash command, but **must** be Read before creating or structurally changing Trellis / blaze-skills / harness skills. Cursor product skills are out of scope.
 
 ## Honesty rule
 

package/dist/templates/markdown/framework/middleware-protocol.md.txt

@@ -0,0 +1,83 @@
+# Middleware Protocol v1
+
+> 一种中间件。官方与用户同一契约，只靠 `source` 区分。字段名英文；正文跟 `artifact_locale`（当前 zh）。
+>
+> Overlay（已拍）：项目 **`.cstl/middleware/`**。默认可进 git。`cstl init` / `cstl update` **永不写入、不删除、不纳入 `.template-hashes.json`**。Cursor++ 残渣清理是另一条 allow-list，不得误删本目录。
+
+Capability router 只声明 `exact` / `semantic` / `structural` / `external`，不绑 Agent 工具名。
+
+## 双轨
+
+| 轨 | CSTL 管什么 |
+| --- | --- |
+| 集成 | 本协议：Manifest + Profile + 健康 |
+| Extra | 只在宿主里配 Agent / MCP，不写成中间件 → CSTL 不管 |
+
+## 义务
+
+1. **一种 ABI。** `source: shipped | user` 不是两套协议。
+2. **Update 不顶掉。** 用户 overlay 不进模板 hash / 官方 refresh 写集。同 id：用户赢，并报告。
+3. **Secret。** Manifest 只许引用（环境变量名 / 平台 Secret），不许写密钥原文。日志与 Artifact 同样禁止。
+4. **权限。** 新权限首次启用走一次 Resolution Approval。后续 `update` 不得扩大已批权限；要扩大再批一次。
+5. **校验。** 缺必填字段则拒绝接入并说明，不得半接入。
+6. **Hook。** 只订 Event Bridge 已有事件。未订阅模块不得让 hook 失败。
+7. **协议版本。** Manifest 可带 `protocol: 1`。不兼容升级必须在应用前被发现。
+
+本条不实现安装器、不做商店、不改全局 MCP。可选日后加 `cstl middleware add`，非发布阻塞。
+
+## 生命周期
+
+添加（放入 overlay 的 Manifest）→ 启用/停用（Profile `required` / `optional` / `unset`）→ 移除（用户删 overlay，CSTL 忘记）。
+
+停用 ≠ 删除文件。官方 shipped 可被用户停用，不得被 `update` 强行再打开。`update` 可刷新 shipped 声明，但不得删用户 overlay，也不得在用户停用后自动重装实现。
+
+同一 capability 多个 Provider：Profile 选一个 active；其余 standby。不得静默抢当前 active。
+
+## 传输类
+
+`transport` 取其一：`skill+cli` | `mcp` | `skill` | `hook`。宿主里额外配置的，CSTL 不管。
+
+## 发现与健康
+
+发现方式：在 `.cstl/middleware/` 放 Manifest。缺必填字段则拒绝接入。
+
+Status / Continue 在任务需要该 capability 时展示 `ready` / `missing` / `failed` / `degraded`。不把 Extra 轨的 MCP 列进健康表。
+
+## 第一波 shipped（不挡用户自添）
+
+| Provider | Profile | 说明 |
+| --- | --- | --- |
+| smart-search | required `external-knowledge` | 独立包；缺失则 degrade |
+| codegraph / fast-context | optional | 默认不装 |
+| cstl-byok | 协议里占可选位 | **实现与发版延后**；本批发协议，不带 BYOK 安装 |
+| Playwright / GitHub | 默认不集成 | — |
+
+## Manifest 样例
+
+```yaml
+id: smart-search
+protocol: 1
+capability: external-knowledge
+source: shipped          # shipped | user
+ownership:
+  kind: external-package
+  name: smart-search
+transport: skill+cli     # skill+cli | mcp | skill | hook
+profile: required        # required | optional | unset
+readiness:
+  probe: cli
+  command_hint: smart-search doctor
+on_missing: degrade      # degrade | block-if-required
+permissions:
+  network: true
+  shell: true
+  secrets: true
+secret_refs: []          # 只写引用名，不写值
+update_policy: preserve-user-overlay
+```
+
+## 相关
+
+- [upgrade.md](./upgrade.md) — 终端用户升级半页
+- [release-boundary.md](./release-boundary.md) — CSTL 本批 vs cstl-byok
+- `.cstl/workflow.md` — 并行第一原则（约定，不是 CLI gate）

package/dist/templates/markdown/framework/parallel-first-execution.md.txt

@@ -0,0 +1,78 @@
+# Parallel-first execution contract
+
+> **Purpose**: Make “parallel by default, serial by written reason” a **product** principle and an executable planning contract. Prefer Cursor native parallel; Trellis owns declaration + integration only.
+>
+> **Not a scheduler.** No queue, no new CLI, no Multitask replacement, no cross-platform parallel.
+>
+> **Scope:** review-pool accepted items, development-plan batches, Parent/Full fan-out, and independent middleware / protocol / release tracks. **Not:** Lite / single-file; unisolatable write-sets; HITL / `start-execution --approved` / reviewer / `integrate-child`.
+>
+> **Strength:** convention + review call-out. Not a CLI hard gate. Attention order (`priority`) is not a serial lock.
+
+Full Prefer/Adapt/Own and serial-exception list: `.cstl/workflow.md` (Parallel-first). Native surface: `.cstl/framework/cursor-native-modes-guide.md` (Multitask). Who/where dispatch: `.cstl/framework/execution-strategy.md` (orthogonal).
+
+---
+
+## Declaration fields (task-map / implement.md)
+
+Declare these in Parent `task-map.md` (frontmatter and/or Orchestration notes). For a Full task with explicit Task fan-out and no Parent, put the same block in `implement.md`. **Lite / single-file work omits this block.**
+
+| Need | Field | Where it already lives | Notes |
+| --- | --- | --- | --- |
+| Topology | `execution_topology` | task-map frontmatter | `parallel` (default when ≥2 independent units) or `serial` (requires `serial_reason`) |
+| 可并行组 | `parallel_groups` *or* `stages[].units` | `stages:` already groups units | List child ids that may run concurrently (empty `depends_on`) |
+| 合并点 | `merge_points` *or* `merge_limit` | `merge_limit: 1` + `integrate-child` | HITL, `start-execution --approved`, reviewer gates, and Parent integrate stay **serial** |
+| 冲突面 | `conflict_surface` *or* `children[].touches` | per-child `touches` | Write-sets that can collide; isolate with worktrees or serialize |
+| 串行理由 | `serial_reason` | **new** — required iff topology is `serial` | Exactly one of the exception list below |
+
+`serial_reason` (one of):
+
+- shared write-set
+- HITL or reviewer gate
+- `depends_on` unmet
+- user asked serial
+- conflict surface cannot isolate
+
+Optional YAML (Parent frontmatter or Full `implement.md`):
+
+```yaml
+execution_topology: parallel
+parallel_groups: [child-a, child-b]
+merge_points: [integrate-child, reviewer-gates]
+conflict_surface: [path/that/collides]
+# serial_reason:  # omit when parallel
+```
+
+These fields are **planning declarations**. CLI may round-trip them on `task-map.md` writes; nothing in Trellis auto-dispatches workers from them.
+
+---
+
+## Archived Parent 对照 (do not edit the archive)
+
+Source (read-only): `.cstl/tasks/archive/2026-08/08-05-cursor-trellis-optimization/task-map.md`
+
+That campaign already behaved parallel-first; this table shows which **named** fields the contract would ask for vs what the archive already has. The archive body is **not** rewritten.
+
+| Contract field | Archive evidence | Gap |
+| --- | --- | --- |
+| Default parallel (≥2 children, `depends_on: []`) | Five children, all `depends_on: []`; notes say 可并行尽量并行 | Met |
+| `execution_topology` | `parallel_work_serial_merge` | Met in spirit (parallel work, serial merge). Today’s spelling is `parallel` + serial merge_points — do not rename the archive |
+| 可并行组 | `stages:` `stage-p0` / `stage-p1` / `stage-p1-lsp` with “可并行” titles | Met via `stages:` (alias of `parallel_groups`) |
+| 合并点 | `merge_limit: 1`; Event Log integrates one Child at a time; Suggested integration order: 合入仍串行 | Met via `merge_limit` + notes. Missing the literal key `merge_points:` |
+| 冲突面 | Per-child `touches` (hooks/rules/templates overlap called out) | Met via `touches`. Missing top-level `conflict_surface:` |
+| `serial_reason` | Topology is not `serial`, so none required. HITL/gates stayed serial through `merge_limit` | No gap for this map. A **serial** topology would need one exception line |
+| Prefer native | Parent routing to Multitask / worktrees; workers not scheduled by Trellis | Met (capability). Contract now makes that the **default**, not “when useful” |
+| Worker prompt path | Child prompts under `child-prompts/` with explicit task dirs | Met |
+
+**Would-write `serial_reason` only if** this Parent had set `execution_topology: serial` despite empty `depends_on` — e.g. shared write-set on `cursor-trellis/packages/cli/src/templates/`. It did not; it kept topology parallel and serialized **merge** only.
+
+Contrast (not edited): `.cstl/tasks/archive/2026-08/08-20-08-20-byok-headless-backend/task-map.md` has `execution_topology: serial` with every `depends_on: []` and **no** `serial_reason`. Under this contract that map would add one line (likely shared write-set / same branch `feat/byok-headless`).
+
+---
+
+## Non-goals
+
+- Auto parallel dispatch, queues, or new CLI
+- Forcing Lite tasks into parallel agents
+- Replacing Cursor Multitask
+- Relaxing HITL / `start-execution --approved` / reviewer-gate serial semantics
+- Cross-platform parallel (P16)

package/dist/templates/markdown/framework/release-boundary.md.txt

@@ -0,0 +1,30 @@
+# 发布边界：CSTL 与 cstl-byok
+
+CSTL（cursor-trellis）本批带走**中间件协议**与**并行原则**，外加半页用户升级说明。**cstl-byok** 是另一条产品线、另一个仓库、另一次发布。两者可并行准备，互不门禁。
+
+## CSTL 本批带走
+
+- Middleware Protocol v1（义务 + Manifest 样例 + `update` 不顶掉）。Overlay 路径写死为 `.cstl/middleware/`。
+- 并行第一原则（workflow / 池 / 规划模板）。强度是约定 + 审核指出，不是新 CLI gate。
+- 升级合同给终端用户看的半页：升包 → `cstl update` → 确认 → 接着干活。官方面可随 `update` 开迁；产物先双读；Contract 另批。
+- 池注意力刻度（`priority`）与可并行组说明。注意力排序不是串行锁。
+
+文档/约定即可。本批不强制写完安装器，不实现产物迁移器。
+
+## CSTL 本批不带走
+
+- cstl-byok 建仓、分析、合成、npm/改名、Cursor patch 安装器。
+- 任何 BYOK 实现或可选安装器。全库 BYOK 盘点仍搁置。
+- Cursor++ 活入口不回默认安装面。
+
+未就绪的 BYOK **不是** CSTL 发版硬依赖。成功标准看 CSTL 自己的工作流轴，不用「BYOK 是否合成」当门禁。
+
+## 用户说明边界
+
+用户升级说明见 [upgrade.md](./upgrade.md)。那一页不写内部迁移地图，也不写维护者本机步骤。
+
+## 相关
+
+- [middleware-protocol.md](./middleware-protocol.md)
+- [upgrade.md](./upgrade.md)
+- [parallel-first-execution.md](./parallel-first-execution.md)

package/dist/templates/markdown/framework/retrieval-daily-guide.md.txt

@@ -48,7 +48,7 @@ Prefer **primary sources** — official docs, source code, first-party API refer
 | Named-symbol definition | **Grep → Read** (Prefer); **codegraph** when trap/blast | Native first; structure when ambiguous |
 | IDE diagnostics | **ReadLints** | Cursor-native linter/diagnostic surface |
 | Symbol, callers, edit blast radius | **codegraph** MCP | Own layer: structure-first for caller/trap/extension intents |
-| Unknown keywords, semantic discovery | **@codebase** (Cursor Native) / **fast-context** (Cursor++ BYOK) | Native: built-in semantic; BYOK: `fast_context_search` MCP (see `cursorEnv` in plans) |
+| Unknown keywords, semantic discovery | **@codebase** (Cursor Native) / **fast-context** (BYOK env) | Native: built-in semantic; BYOK: `fast_context_search` MCP (see `cursorEnv` in plans) |
 | External / current facts | **smart-search-cli** | **Mandatory first** — built-in web tools are downgrade-only (see rule above) |
 | Trellis durable docs | **artifact-search** | `search_artifacts.py` |
 | Past sessions | **session-memory** | Historical; verify against tasks/spec |

package/dist/templates/markdown/framework/upgrade.md.txt

@@ -0,0 +1,15 @@
+# 升级 CSTL
+
+给已经在用旧版 CSTL 的仓库。不要重做 `init`，不要手搬任务目录。
+
+1. 按发布说明升级 CSTL 包（或你原来的安装面）。
+2. 在项目根目录跑一次 **`cstl update`**。
+3. 看摘要：刷新了哪些官方文件、迁了哪些官方规则、哪些进行中的任务仍按旧形状可读、有没有 degraded。
+4. **确认一次。** 拒绝则项目保持原状，不会半写。`--force` / `--skip-all` / `--create-new` 会套官方文件，但不算这次确认，也不写停读旗标。
+5. 照常开对话或 `/cstl-continue`。进行中的任务还能做、还能收工。
+
+官方面（CSTL 装进项目的指令与规则）能随这次 `update` 开迁。任务产物先双读，以后再写。确认后才会停读旧形状。从更老的版本一次升上来，也走同一条 `update`。
+
+你改过的官方文件会单独列出并保留。只在 Cursor 里配了 MCP、没写成中间件的，CSTL 不管。失败则回滚或维持双读，项目仍可用。
+
+团队其他人：拉代码即可。若这次只改了本地未提交文件，发布说明会写清谁跑 `update`、谁只要 pull。

package/dist/templates/markdown/index.d.ts

@@ -42,6 +42,10 @@ export declare const frameworkArtifactLocaleGuideContent: string;
 export declare const frameworkPrdGrillFrontierGuideContent: string;
 export declare const frameworkInternalSkillsReachabilityGuideContent: string;
 export declare const frameworkDogfoodOnlySurfacesGuideContent: string;
+export declare const frameworkParallelFirstExecutionContent: string;
+export declare const frameworkMiddlewareProtocolContent: string;
+export declare const frameworkUpgradeContent: string;
+export declare const frameworkReleaseBoundaryContent: string;
 /**
  * Single source of truth for `.cstl/framework/` docs.
  * Consumed by init (configurators/workflow.ts) and update (commands/update.ts)

package/dist/templates/markdown/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACiB,CAAC;AAC1E,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MACiB,CAAC;AAMxE,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,wCAAwC,EAAE,MACW,CAAC;AACnE,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,2CAA2C,EAAE,MACY,CAAC;AACvE,eAAO,MAAM,sCAAsC,EAAE,MAEpD,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACW,CAAC;AACpE,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,qCAAqC,EAAE,MAEnD,CAAC;AACF,eAAO,MAAM,+CAA+C,EAAE,MACa,CAAC;AAC5E,eAAO,MAAM,wCAAwC,EAAE,MACM,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,EA+CA,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,eAAO,MAAM,eAAe,EAAE,MAAuC,CAAC;AAGtE,eAAO,MAAM,qBAAqB,EAAE,MACK,CAAC;AAG1C,eAAO,MAAM,yBAAyB,QAAwB,CAAC;AAG/D,eAAO,MAAM,wBAAwB,EAAE,MACH,CAAC;AAQrC,eAAO,MAAM,mBAAmB,EAAE,MAEjC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AAGF,eAAO,MAAM,oBAAoB,EAAE,MAElC,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,yBAAyB,EAAE,MAEvC,CAAC;AACF,eAAO,MAAM,6BAA6B,EAAE,MAE3C,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,8BAA8B,EAAE,MAE5C,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAEhC,CAAC;AACF,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACiB,CAAC;AAC1E,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,2BAA2B,EAAE,MAEzC,CAAC;AACF,eAAO,MAAM,gCAAgC,EAAE,MAE9C,CAAC;AACF,eAAO,MAAM,uCAAuC,EAAE,MACiB,CAAC;AAMxE,eAAO,MAAM,qBAAqB,EAAE,MAEnC,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,wCAAwC,EAAE,MACW,CAAC;AACnE,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,iCAAiC,EAAE,MAE/C,CAAC;AACF,eAAO,MAAM,2CAA2C,EAAE,MACY,CAAC;AACvE,eAAO,MAAM,sCAAsC,EAAE,MAEpD,CAAC;AACF,eAAO,MAAM,yCAAyC,EAAE,MACW,CAAC;AACpE,eAAO,MAAM,oCAAoC,EAAE,MAElD,CAAC;AACF,eAAO,MAAM,mCAAmC,EAAE,MAEjD,CAAC;AACF,eAAO,MAAM,qCAAqC,EAAE,MAEnD,CAAC;AACF,eAAO,MAAM,+CAA+C,EAAE,MACa,CAAC;AAC5E,eAAO,MAAM,wCAAwC,EAAE,MACM,CAAC;AAC9D,eAAO,MAAM,sCAAsC,EAAE,MAEpD,CAAC;AACF,eAAO,MAAM,kCAAkC,EAAE,MAEhD,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,MAErC,CAAC;AACF,eAAO,MAAM,+BAA+B,EAAE,MAE7C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,EA4DA,CAAC"}

package/dist/templates/markdown/index.js

@@ -70,6 +70,10 @@ export const frameworkArtifactLocaleGuideContent = readLocalTemplate("framework/
 export const frameworkPrdGrillFrontierGuideContent = readLocalTemplate("framework/prd-grill-frontier.md.txt");
 export const frameworkInternalSkillsReachabilityGuideContent = readLocalTemplate("framework/internal-skills-cursor-reachability.md.txt");
 export const frameworkDogfoodOnlySurfacesGuideContent = readLocalTemplate("framework/dogfood-only-surfaces.md.txt");
+export const frameworkParallelFirstExecutionContent = readLocalTemplate("framework/parallel-first-execution.md.txt");
+export const frameworkMiddlewareProtocolContent = readLocalTemplate("framework/middleware-protocol.md.txt");
+export const frameworkUpgradeContent = readLocalTemplate("framework/upgrade.md.txt");
+export const frameworkReleaseBoundaryContent = readLocalTemplate("framework/release-boundary.md.txt");
 /**
  * Single source of truth for `.cstl/framework/` docs.
  * Consumed by init (configurators/workflow.ts) and update (commands/update.ts)
@@ -122,5 +126,18 @@ export const frameworkDocs = [
         name: "dogfood-only-surfaces.md",
         content: frameworkDogfoodOnlySurfacesGuideContent,
     },
+    {
+        name: "parallel-first-execution.md",
+        content: frameworkParallelFirstExecutionContent,
+    },
+    {
+        name: "middleware-protocol.md",
+        content: frameworkMiddlewareProtocolContent,
+    },
+    { name: "upgrade.md", content: frameworkUpgradeContent },
+    {
+        name: "release-boundary.md",
+        content: frameworkReleaseBoundaryContent,
+    },
 ];
 //# sourceMappingURL=index.js.map

package/dist/templates/markdown/index.js.map

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

package/dist/templates/markdown/spec/guides/index.md.txt

@@ -31,12 +31,6 @@ These guides help you **ask the right questions before coding**.
 
 > **Framework & platform docs live in `.cstl/framework/`** (framework-owned, refreshed by `cstl update`) — verification strength, injection budget, retrieval routing, Cursor modes/agents/injection, PRD Grill, execution strategy, artifact locale, and more. See [`.cstl/framework/index.md`](../../framework/index.md).
 
-### When using `/cstl-goal` (optional long-horizon mode)
-
-- [ ] User explicitly invoked `/cstl-goal` — default cstl spine unchanged otherwise
-- [ ] Read [cstl-goal Contract](../Trellis/framework/cstl-goal-contract.md) §1 preflight + §3 hard deny before G1 self-drive
-- [ ] High-risk actions: pack per [Action Packet](../Trellis/framework/cstl-goal-action-packet.md) → reviewer seam; no bare execute
-
 ---
 
 ## Quick Reference: Thinking Triggers

package/dist/templates/shared-hooks/event-bridge.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Thin Cursor Event Bridge hook.
+
+Records one standard hook event. Unsubscribed modules must never fail the hook.
+Does not write Kernel store primitives; optional Kernel patch is best-effort.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+
+def _event_name(argv: list[str], hook_input: dict) -> str:
+    parser = argparse.ArgumentParser(add_help=False)
+    parser.add_argument("--event", default="")
+    args, _unknown = parser.parse_known_args(argv)
+    if args.event.strip():
+        return args.event.strip()
+    for key in ("hook_event_name", "event", "eventName"):
+        value = hook_input.get(key)
+        if isinstance(value, str) and value.strip():
+            return value.strip()
+    return "sessionStart"
+
+
+def _safe_payload() -> dict:
+    raw = sys.stdin.read() if not sys.stdin.isatty() else ""
+    if not raw.strip():
+        return {}
+    try:
+        parsed = json.loads(raw)
+    except json.JSONDecodeError:
+        return {}
+    return parsed if isinstance(parsed, dict) else {}
+
+
+def main() -> int:
+    # Fail-closed for the Agent session: never break the hook.
+    try:
+        hook_input = _safe_payload()
+        event = _event_name(sys.argv[1:], hook_input)
+        sys.path.insert(0, str(Path(__file__).resolve().parents[2] / ".cstl" / "scripts"))
+        try:
+            from common.adapter_middleware import dispatch_hook_event
+        except Exception:
+            print(json.dumps({"permission": "allow"}))
+            return 0
+        result = dispatch_hook_event({"subscriptions": []}, event, source="cursor-hooks")
+        _ = result
+    except Exception:
+        pass
+    print(json.dumps({"permission": "allow"}))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

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" | "rename-session-for-task.py" | "inject-retrieval-plan.py" | "inject-workflow-state.py" | "inject-subagent-context.py" | "research-end-retrieval-pack.py";
+export type SharedHookName = "session-start.py" | "event-bridge.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,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"}
+{"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,iBAAiB,GACjB,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,CAkC1B,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

@@ -44,6 +44,7 @@ export const SHARED_HOOKS_BY_PLATFORM = {
     ],
     cursor: [
         "session-start.py",
+        "event-bridge.py",
         "inject-shell-session-context.py",
         "rename-session-for-task.py",
         "inject-retrieval-plan.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;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"}
+{"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;AA8BD;;;;;;;;;;;;;;;;;;;;;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,iBAAiB;QACjB,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/session-start.py

@@ -222,6 +222,23 @@ def _detect_platform(input_data: dict) -> str | None:
     return None
 
 
+def _resolve_trellis_dir(project_dir: Path) -> Path:
+    """Resolve the cstl instance directory for this project.
+
+    Mirrors common/paths.py get_repo_root(): finds the nearest .cstl upward
+    from project_dir. Harness sub-repos without a local .cstl resolve to the
+    harness root instance (thin-connect, 2026-08-16 instance-boundary decision).
+    """
+    current = project_dir
+    while True:
+        if (current / ".cstl").is_dir():
+            return current / ".cstl"
+        if current.parent == current:
+            break
+        current = current.parent
+    return project_dir / ".cstl"
+
+
 def _resolve_context_key(trellis_dir: Path, input_data: dict) -> str | None:
     scripts_dir = trellis_dir / "scripts"
     if str(scripts_dir) not in sys.path:
@@ -791,7 +808,7 @@ def main():
     if project_dir is None:
         project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
 
-    trellis_dir = project_dir / ".cstl"
+    trellis_dir = _resolve_trellis_dir(project_dir)
     context_key = _resolve_context_key(trellis_dir, hook_input)
     _persist_context_key_for_bash(context_key)
 

package/dist/templates/trellis/CONTEXT.md

@@ -2,7 +2,35 @@
 
 Project domain glossary — the single source of truth for project-specific terms used in this repository. Read **on demand** when project terms matter (e.g. before planning questions, PRD writing, or check reviews); **never always-inject** — this file stays out of the automatic session prompt budget.
 
-Only project-specific concepts belong here; generic programming concepts and framework terms already documented under `.cstl/` do not need entries. Each entry: term + one-line definition + `_Avoid_` aliases when a common synonym causes confusion. Language follows `artifact_locale` (en → English only; zh → Chinese terms with English gloss).
+Only project-specific concepts belong here; generic programming concepts already documented under `.cstl/` do not need entries. Each entry: term + one-line definition + `_Avoid_` aliases when a common synonym causes confusion. Language follows `artifact_locale` (en → English only; zh → Chinese terms with English gloss). Seed below is bilingual so either locale can start from the same file; delete entries that do not apply.
+
+## Governance domain seed
+
+Optional starting set for the review-pool vocabulary — delete entries that do not apply:
+
+**点子** (_idea_):
+Undecided development direction or improvement; a candidate for the review pool.
+_Avoid_: requirement, thought
+
+**不足** (_debt_):
+Confirmed but unresolved gap found in review or verification.
+_Avoid_: issue, bug (unless it is a tracked defect elsewhere)
+
+**审核池** (_review pool_):
+Inbox for ideas and debt; states inbox / review / accepted / rejected / rework.
+_Avoid_: backlog, idea dump
+
+**开发计划** (_dev plan_):
+Plan file: accepted item ids + order + blocking edges + fog. Cite pool ids only.
+_Avoid_: roadmap
+
+**可裁决条目** (_adjudicable item_):
+Pool item with intent / motivation / coarse acceptance / non-goals.
+_Avoid_: todo
+
+**拒绝知识库** (_knowledge base_):
+Archive of rejected-concept reasons, used to dedupe prior requests.
+_Avoid_: blacklist
 
 ## Framework domain seed (optional)
 
@@ -18,7 +46,7 @@ _Avoid_: spec sheet
 
 **Gate** (_gate_):
 Mandatory checkpoint at planning / execution / archive boundaries.
-_Avoid_: — 
+_Avoid_: —
 
 **Evidence** (_evidence_):
 Verification evidence in `verify.md` (command output, paths, acceptance).
@@ -38,7 +66,39 @@ _Avoid_: locale
 
 **Task Ladder** (_task ladder_):
 Triage ladder: No Task / Micro-Grill / Lite / Full / Parent.
-_Avoid_: — 
+_Avoid_: —
+
+## Architecture (deep-module vocabulary)
+
+Seed for codebase-design terms. Keep these seven; do not treat them as generic programming words.
+
+**module** (_module_):
+A unit of any size that has an interface and an implementation.
+_Avoid_: component, service
+
+**interface** (_interface_):
+Every fact a caller needs in order to use the module correctly.
+_Avoid_: API, signature
+
+**depth** (_depth_):
+Leverage on the interface: how much behavior each unit of interface can drive.
+_Avoid_: abstraction level
+
+**seam** (_seam_):
+A place where behavior can change without editing the original site.
+_Avoid_: boundary
+
+**adapter** (_adapter_):
+A concrete thing that satisfies an interface at a seam.
+_Avoid_: implementation
+
+**leverage** (_leverage_):
+Capability the caller gains from depth.
+_Avoid_: reuse
+
+**locality** (_locality_):
+Concentration the maintainer gains from depth (change / knowledge / verification in one place).
+_Avoid_: cohesion
 
 ## Project glossary