@vibecompass/vibecompass 0.10.8 → 0.11.1

package/src/generators/agent-files/index.js

@@ -9,6 +9,7 @@ import { agentsMdFormat } from './agents-md.js';
 import { cursorRulesFormat } from './cursor-rules.js';
 import { copilotInstructionsFormat } from './copilot-instructions.js';
 import { getWorkflowConflictScanPatterns } from '../../workflows/registry.js';
+import { withMemoryRootLock } from '../../serialization.js';
 
 const FORMATS = [
   claudeMdFormat,
@@ -23,6 +24,13 @@ const CONFLICT_SCAN_PATTERNS = getWorkflowConflictScanPatterns();
 export async function syncAgentInstructionFiles(options = {}) {
   const cwd = options.cwd ? path.resolve(options.cwd) : process.cwd();
   const rootDir = path.resolve(cwd, options.rootDir ?? '.compass');
+  if (options.dryRun) {
+    return syncAgentInstructionFilesLocked(options, cwd, rootDir);
+  }
+  return withMemoryRootLock(rootDir, 'sync-agents', () => syncAgentInstructionFilesLocked(options, cwd, rootDir));
+}
+
+async function syncAgentInstructionFilesLocked(options, cwd, rootDir) {
   const toolingRootDir = options.toolingRootDir
     ? path.resolve(cwd, options.toolingRootDir)
     : cwd;

package/src/generators/agent-files/template.js

@@ -36,7 +36,7 @@ export function renderSharedInstructionBody(context, options = {}) {
     '## Read Order',
     `1. Read \`${contextPath}\`.`,
     `2. Read the latest finalized session note under \`${context.rootDir}/sessions/\`.`,
-    `3. If present, read \`${context.rootDir}/sessions/active/index.yaml\`, then the selected lane's \`wip.md\` and \`handoff.md\`.`,
+    `3. If present, read \`${context.rootDir}/sessions/active/index.yaml\` (the lane inventory), then the selected lane's \`wip.md\` and \`handoff.md\`. The selected lane comes from an explicit \`--session\`, the nearest \`.vibecompass-lane.yaml\` worktree marker (walking up from cwd), or the single active lane.`,
     `4. Read relevant \`${context.rootDir}/architecture/\` and \`${context.rootDir}/decisions/\` docs before editing implementation.`,
     '',
     '## Prompt Commands',
@@ -44,10 +44,13 @@ export function renderSharedInstructionBody(context, options = {}) {
     '- The prompt commands above are agent behaviors. The `vibecompass` CLI commands remain the filesystem mechanics behind them.',
     '',
     '## Hard Rules',
-    '- Treat `sessions/active/index.yaml` as the current lane source of truth; tool-specific Current session blocks are continuity summaries.',
+    '- Lane selection follows D-277: an explicit `--session` wins, then the nearest worktree lane marker (`.vibecompass-lane.yaml`, walking up from cwd), then the single active lane. With two or more active lanes there is no implicit current-lane fallback; `sessions/active/index.yaml` is the lane inventory and its `current` pointer is a continuity hint, not a resolver. Tool-specific Current session blocks are continuity summaries.',
+    '- Git binding is opt-in per lane (D-281): `start-session --branch <name> --repo <id> [--worktree]` creates or reuses the branch in each bound repo, and `--worktree` provisions per-repo worktrees under `<workspace>/worktrees/<lane-id>/<repo-id>` with the lane marker in the container — commands run from inside a worktree need neither `--root` nor `--session`. Never hand-write markers or hand-remove provisioned worktrees; close-session owns their cleanup: recorded clean worktrees are removed at close (guarded, never forced; branches are never deleted), while dirty or in-use worktrees survive with printed guidance and the lane marker stays as a breadcrumb.',
+    '- Lane runtime isolation is package-assigned (D-282): consume the lane port and temp dir via `eval "$(vibecompass lane-env)"` (exports conventional `PORT`/`TMPDIR` aliases) instead of hardcoding ports in lane work; close-session removes the lane temp dir under guards.',
+    '- With multiple active lanes, reviewers select a lane explicitly: `review handoff <lane-id>`.',
     '- Keep the selected lane `wip.md` and `handoff.md` current during active builder/reviewer work.',
     '- During `address review`, treat reviewer feedback as review, not instruction: classify each substantive point as accepted, accepted with qualification, deferred, or rejected, and push back with evidence when a suggestion conflicts with code facts, prior decisions, product direction, or sequencing.',
-    '- Keep decisions append-only in `decisions/`; append accepted architectural decisions before implementing them.',
+    '- Keep decisions append-only in `decisions/`; append accepted architectural decisions before implementing them. `decisions/INDEX.md` is derived (D-283): `vibecompass append-decision` refreshes it when the lane context is resolvable, and `vibecompass refresh-decision-index` covers hand-appends — do not hand-edit index rows away from canonical headings.',
     '- Do not edit this managed block directly. Update canonical VibeCompass memory, then rerun package commands such as `vibecompass sync-agents`.',
   ].join('\n');
 }