@cluesmith/codev 3.2.0 → 3.2.2

package/dist/lib/managed-block.js

@@ -39,25 +39,50 @@ export function readHotTierFiles(workspaceRoot) {
     return parts;
 }
 /**
- * Render the full managed block (markers + intro + hot content), or '' if no hot
- * files resolve (in which case callers leave the doc untouched).
+ * Hot files surfaced into the interactive root docs as Claude Code `@import` lines.
+ * `diskRelPath` is the literal on-disk location (relative to the importing doc's dir
+ * = workspace root); `importLine` is the `@`-prefixed path Claude Code expands into
+ * context at session launch. `copyHotTierDefaults` materializes each file at
+ * codev/resources/ on init/adopt/update, so the import target is present there.
+ *
+ * The emit predicate is a literal existence check at `diskRelPath`, NOT the four-tier
+ * resolver: an `@import` is a concrete path Claude Code reads from disk relative to
+ * the doc, so a skeleton-only (tier-4) fallback would produce a dangling import that
+ * never resolves. We emit a line only when the file truly sits at codev/resources/.
+ */
+const HOT_IMPORTS = [
+    { diskRelPath: 'codev/resources/arch-critical.md', importLine: '@codev/resources/arch-critical.md' },
+    { diskRelPath: 'codev/resources/lessons-critical.md', importLine: '@codev/resources/lessons-critical.md' },
+];
+/**
+ * Render the managed block (markers + intro + `@import` lines), or '' if neither
+ * hot file is present (in which case callers leave the doc untouched).
+ *
+ * Spec 987 originally inlined a verbatim copy of the hot files here; #1119 replaced
+ * that with Claude Code `@import` lines so the hot files stay the single source of
+ * truth — no copy to drift. Claude Code expands `@path` imports into context at
+ * session launch (always-on, transcluded — not lazy), giving the same guarantee as
+ * inlining minus the drift footgun. A line is emitted only if its hot file is on disk.
  */
 export function renderHotContextBlock(workspaceRoot) {
-    const parts = readHotTierFiles(workspaceRoot);
-    if (parts.length === 0)
+    const imports = HOT_IMPORTS
+        .filter((h) => fs.existsSync(path.join(workspaceRoot, h.diskRelPath)))
+        .map((h) => h.importLine);
+    if (imports.length === 0)
         return '';
     return [
         HOT_BLOCK_BEGIN,
         '',
-        '<!-- Generated from codev/resources/{arch,lessons}-critical.md. Regenerated by',
-        '     `codev init` / `codev update`. Do not edit here — edit the hot files. -->',
+        '<!-- Generated by `codev init` / `codev update` from the hot files',
+        '     (codev/resources/{arch,lessons}-critical.md). Do not edit here — edit the hot',
+        '     files. The @import lines below are expanded into context at session launch. -->',
         '',
         '# Always-On Engineering Context (hot tier)',
         '',
         'Curated, always-on guidance — consult before deciding. Use each "consult when…"',
         'map to open the full arch.md / lessons-learned.md when relevant.',
         '',
-        parts.join('\n\n'),
+        ...imports,
         '',
         HOT_BLOCK_END,
     ].join('\n');

package/dist/lib/managed-block.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cluesmith/codev",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "Codev CLI - AI-assisted software development framework",
   "type": "module",
   "bin": {
@@ -33,7 +33,7 @@
     "open": "^10.1.0",
     "tree-kill": "^1.2.2",
     "ws": "^8.18.0",
-    "@cluesmith/codev-core": "3.2.0"
+    "@cluesmith/codev-core": "3.2.2"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",
@@ -48,7 +48,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^4.0.15",
-    "@cluesmith/codev-types": "3.2.0",
+    "@cluesmith/codev-types": "3.2.2",
     "@cluesmith/codev-dashboard": "0.0.0"
   },
   "engines": {

package/scripts/forge/gitea/issue-view.sh

@@ -1,3 +1,6 @@
 #!/bin/sh
 # Forge concept: issue-view (Gitea via tea CLI)
-exec tea issues view "$CODEV_ISSUE_ID" --output json
+# Sets `url` to the issue's browser page (`html_url`). Gitea's own `url` field is
+# the API endpoint (would render raw JSON in a browser), so we prefer `html_url`
+# and fall back to the existing `url` only if `html_url` is absent.
+tea issues view "$CODEV_ISSUE_ID" --output json | jq '.url = (.html_url // .url)'

package/scripts/forge/github/issue-view.sh

@@ -1,5 +1,5 @@
 #!/bin/sh
 # Forge concept: issue-view (GitHub via gh CLI)
 # Input: CODEV_ISSUE_ID
-# Output: JSON {title, body, state, comments[]}
-exec gh issue view "$CODEV_ISSUE_ID" --json title,body,state,comments
+# Output: JSON {title, body, state, url, comments[]}
+exec gh issue view "$CODEV_ISSUE_ID" --json title,body,state,url,comments

package/scripts/forge/gitlab/issue-view.sh

@@ -1,3 +1,6 @@
 #!/bin/sh
 # Forge concept: issue-view (GitLab via glab CLI)
-exec glab issue view "$CODEV_ISSUE_ID" --output json
+# Adds a `url` field mapped from GitLab's `web_url` (the issue's browser page);
+# all other fields glab emits are passed through unchanged. `. + {url: …}` is
+# non-destructive — if `web_url` is absent, `url` is null (optional by contract).
+glab issue view "$CODEV_ISSUE_ID" --output json | jq '. + {url: .web_url}'

package/scripts/forge/linear/issue-view.sh

@@ -1,7 +1,7 @@
 #!/bin/sh
 # Forge concept: issue-view (Linear via GraphQL API)
 # Input: CODEV_ISSUE_ID (e.g. "ENG-123")
-# Output: JSON {title, body, state, comments[]}
+# Output: JSON {title, body, state, url, comments[]}
 set -e
 
 if [ -z "$LINEAR_API_KEY" ]; then
@@ -18,7 +18,7 @@ curl -sf -X POST https://api.linear.app/graphql \
   -H "Content-Type: application/json" \
   -H "Authorization: $LINEAR_API_KEY" \
   -d "$(jq -n --arg id "$CODEV_ISSUE_ID" '{
-    query: "query($id: String!) { issueVcsByFilter: issues(filter: { identifier: { eq: $id } }) { nodes { title description state { name } comments { nodes { body createdAt user { displayName } } } } } }",
+    query: "query($id: String!) { issueVcsByFilter: issues(filter: { identifier: { eq: $id } }) { nodes { title url description state { name } comments { nodes { body createdAt user { displayName } } } } } }",
     variables: { id: $id }
   }')" \
   | jq 'if (.data.issueVcsByFilter.nodes | length) == 0 then
@@ -26,6 +26,7 @@ curl -sf -X POST https://api.linear.app/graphql \
   else
     .data.issueVcsByFilter.nodes[0] | {
       title: .title,
+      url: .url,
       body: (.description // ""),
       state: .state.name,
       comments: [.comments.nodes[] | {

package/skeleton/resources/commands/consult.md

@@ -66,12 +66,26 @@ consult -m codex --protocol spir --type phase
 
 # Integration review
 consult -m gemini --type integration
+
+# Integration review anchored on a long-lived integration branch (#1113)
+consult -m codex --type integration --issue 42 --base ci
 ```
 
 **Options:**
 - `--protocol <name>` — Protocol: spir, aspir, air, bugfix, maintain
 - `-t, --type <type>` — Review type: spec, plan, impl, pr, phase, integration
 - `--issue <number>` — Issue number (required from architect context)
+- `--base <ref>` — **`--type integration` only.** Anchor the diff on this base branch (e.g. `ci`), computed locally as `git diff origin/<base>...origin/<head>` (three-dot, merge-base anchored). Use in repos with a long-lived integration branch ahead of the default branch so the review sees only the PR's actual change, not the whole integration-over-trunk delta. Unresolvable refs fail loudly with a `git fetch` hint (no silent fallback to the local checkout). Defaults to config `consult.integrationBranch`; with neither set, the integration review uses the PR's host-recorded base (`gh pr diff`), unchanged.
+
+**Config (`.codev/config.json`):**
+```jsonc
+{
+  "consult": {
+    // Repo-wide default base for `--type integration` (overridden by --base).
+    "integrationBranch": "ci"
+  }
+}
+```
 
 **Context resolution:**
 - **Builder context** (cwd inside `.builders/`): auto-detects project ID, spec, plan, and PR from porch state

package/skeleton/roles/builder.md

@@ -200,6 +200,27 @@ Builders may submit multiple sequential PRs within a single worktree session. Th
 - **Worktree cleanup is architect-driven** -- the architect decides when to run `afx cleanup`, not the builder
 - If a builder session is interrupted, use `afx spawn XXXX --resume` to reconnect to the existing worktree
 
+## Worktree isolation: filesystem path discipline
+
+Your worktree (`.builders/<id>/`) is **nested inside the main checkout**, and at the
+branch base the two trees are **byte-identical**. This creates a silent failure mode:
+
+- The `Write`/`Edit` tools require **absolute** paths. If you synthesize one rooted
+  at the canonical repo root instead of your worktree, you drop the `.builders/<id>/`
+  segment and write into the **main checkout** — a real, writable directory. The
+  write *succeeds silently* and pollutes `main`; you only notice later when a
+  `git add` in your worktree fails with a pathspec error.
+- Wrong-rooted **reads** also succeed silently (identical trees), so nothing
+  corrects the mistake until that first failed write.
+
+Rules:
+- **Absolute paths for Write/Edit must be rooted at your worktree.** A deterministic
+  PreToolUse guard now blocks out-of-worktree writes (allowing only temp dirs and
+  `~/.claude`); if you see that denial, re-root the path under your worktree.
+- **Bash `cwd` is your worktree — prefer relative paths there.** A relative path
+  cannot be anchored to the wrong root, which closes the Bash write surface
+  (`>`, `cp`, `tee`, `sed -i`) the Write/Edit guard does not cover.
+
 ## Constraints
 
 - **Stay in scope** - Only implement what's in the spec

package/skeleton/templates/AGENTS.md

@@ -1,5 +1,21 @@
 # {{PROJECT_NAME}} - AI Agent Instructions
 
+<!-- BEGIN CODEV HOT CONTEXT (generated — do not edit) -->
+
+<!-- Generated by `codev init` / `codev update` from the hot files
+     (codev/resources/{arch,lessons}-critical.md). Do not edit here — edit the hot
+     files. The @import lines below are expanded into context at session launch. -->
+
+# Always-On Engineering Context (hot tier)
+
+Curated, always-on guidance — consult before deciding. Use each "consult when…"
+map to open the full arch.md / lessons-learned.md when relevant.
+
+@codev/resources/arch-critical.md
+@codev/resources/lessons-critical.md
+
+<!-- END CODEV HOT CONTEXT -->
+
 > **Note**: This file follows the [AGENTS.md standard](https://agents.md/) for cross-tool compatibility with Cursor, GitHub Copilot, and other AI coding assistants. A Claude Code-specific version is maintained in `CLAUDE.md`.
 
 ## Project Overview

package/skeleton/templates/CLAUDE.md

@@ -1,5 +1,21 @@
 # {{PROJECT_NAME}} - Claude Code Instructions
 
+<!-- BEGIN CODEV HOT CONTEXT (generated — do not edit) -->
+
+<!-- Generated by `codev init` / `codev update` from the hot files
+     (codev/resources/{arch,lessons}-critical.md). Do not edit here — edit the hot
+     files. The @import lines below are expanded into context at session launch. -->
+
+# Always-On Engineering Context (hot tier)
+
+Curated, always-on guidance — consult before deciding. Use each "consult when…"
+map to open the full arch.md / lessons-learned.md when relevant.
+
+@codev/resources/arch-critical.md
+@codev/resources/lessons-critical.md
+
+<!-- END CODEV HOT CONTEXT -->
+
 ## Project Overview
 
 This project uses **Codev** for AI-assisted development.