snapshot of https://github.com/marmelab/atomic-crm.git (main, 2026-09-18; blobs > 131072B omitted)

.claude/hooks/lib/topology.mjs

@@ -0,0 +1,25 @@
+// Session worktree/branch topology — the single source for the layout created
+// by setup-worktree and torn down by cleanup-worktree:
+//   <worktreeBase>/TASK-XXX  on branch <short>/TASK-XXX   (one per ticket)
+//   <worktreeBase>/simple       on branch <short>/simple        (single-shot rollback / migration)
+//   <worktreeBase>/_session  on branch session/<short>    (merger integration)
+//   session-base/<short>                                  (fixed fork anchor)
+// Every hook that builds or matches these names must go through this module.
+
+import { join } from "node:path";
+
+export const taskWorktreePath = (ctx, taskId) => join(ctx.worktreeBase, taskId);
+export const simpleWorktreePath = (ctx) => join(ctx.worktreeBase, "simple");
+export const sessionWorktreePath = (ctx) => join(ctx.worktreeBase, "_session");
+
+export const taskBranch = (ctx, taskId) => `${ctx.sessionShort}/${taskId}`;
+export const simpleBranch = (ctx) => `${ctx.sessionShort}/simple`;
+export const sessionBranch = (ctx) => `session/${ctx.sessionShort}`;
+export const sessionBaseBranch = (ctx) => `session-base/${ctx.sessionShort}`;
+
+// Infrastructure worktrees are never removed by cleanup.
+export const isInfraWorktreePath = (p) => p.endsWith("/_session") || p.endsWith("/simple");
+// Session-lifetime branches are never deleted by cleanup.
+export const isProtectedBranch = (b) => /^session(-base)?\//.test(b) || /\/simple$/.test(b);
+// Directory names under <worktreeBase> that the leftover sweep may touch.
+export const isTaskWorktreeDirName = (name) => /^TASK-[0-9]+$/.test(name) || name === "simple";