@sabaiway/agent-workflow-kit 14.31.0 → 14.33.0

package/tools/write-lanes.mjs

@@ -2,6 +2,7 @@ import { join, resolve } from 'node:path';
 import { dirCovers } from './declared-paths.mjs';
 import { claudeDirOf, quoteArg, skillTargets } from './jev-facts.mjs';
 import { targetsFor } from './jev-connect.mjs';
+import { BUNDLED_SCRIPT_NAMES, INSTALLER_REL, SCRIPTS_REL } from './git-hooks.mjs';
 
 export const LANE_CHAT = 'chat';
 export const LANE_HARNESS = 'harness';
@@ -27,8 +28,8 @@ export const VARIANT_LANES = Object.freeze({
   'source-size.id-squatter': LANE_CHAT,
   'gate-hook': LANE_HARNESS,
   'gate-hook.marker-stale': LANE_HARNESS,
-  'commit-guard': LANE_USER,
-  enforcement: LANE_USER,
+  'commit-guard': LANE_HARNESS,
+  enforcement: LANE_HARNESS,
   'read-lane': LANE_CHAT,
   'read-lane.stale': LANE_HARNESS,
   'read-lane.missing': LANE_HARNESS,
@@ -41,7 +42,8 @@ export const VARIANT_LANES = Object.freeze({
   'adr-store-migration': LANE_CHAT,
   'sandbox-masks': LANE_CHAT,
   'sandbox-masks.unfenced-mount': LANE_CHAT,
-  'worktrees-dir': LANE_CHAT,
+  'worktrees-dir': LANE_HARNESS,
+  'worktrees-dir.home': LANE_USER,
   'spec-adoption': LANE_CHAT,
   'profile-gap': LANE_CHAT,
   'jev-connect': LANE_USER,
@@ -79,6 +81,7 @@ export const isProtectedPath = (abs, { root, home, hooksDir }) => {
 };
 
 const SETTINGS_WRITES = [SETTINGS_PATH];
+const LOCAL_SETTINGS_WRITES = [join('.claude', 'settings.local.json')];
 const HOOK_WRITES = [join('.claude', 'hooks', 'agent-workflow-gates.mjs'), ...SETTINGS_WRITES];
 const STOP_HOOK_WRITES = [join('.claude', 'hooks', 'state-block-guard.mjs'), ...SETTINGS_WRITES];
 const MCP_WRITES = ['.mcp.json', ...SETTINGS_WRITES];
@@ -97,16 +100,22 @@ const getStartupPaths = ({ env, home, platform }) => targetsFor({
   platform,
 }).filter(({ path }) => path !== null).map(({ path }) => path);
 
+const preCommitOf = (facts) => join(facts.hooksDir ?? join(facts.root, '.git', 'hooks'), 'pre-commit');
+const getEnforcementPaths = (facts) => [...BUNDLED_SCRIPT_NAMES.map((name) => join(facts.root, SCRIPTS_REL, name)), preCommitOf(facts)];
+const getGuardPaths = (facts) => [preCommitOf(facts), join(facts.root, INSTALLER_REL)];
+
 const formatCommand = (argv) => argv.map(quoteArg).join(' ');
 const TERMINAL_STEP = 'run in a terminal of your own: ';
 
-const createForm = (file, preview, apply, writes, envDependent = false, userStep = null) => Object.freeze({
+// rejudged: the written value derives from state init's record does not watch, so init re-runs its check before the apply.
+const createForm = (file, preview, apply, writes, envDependent = false, userStep = null, rejudged = false) => Object.freeze({
   file,
   preview,
   apply,
   writes,
   envDependent,
   userStep,
+  rejudged,
 });
 
 const CORE_FORM = createForm('velocity-profile.mjs', ['--cwd', '<root>'], ['--apply', '--cwd', '<root>'], SETTINGS_WRITES);
@@ -148,8 +157,15 @@ const FORMS = Object.freeze({
     userStep: (facts) => 'your own step — the doctor has no install it can run for you here (the reason is this item\'s text) — '
       + `${TERMINAL_STEP}cd ${quoteArg(facts.root)} && ${formatCommand(['node', join(facts.toolsDir, 'autonomy-doctor.mjs')])}`,
   }),
-  'commit-guard': null,
-  enforcement: null,
+  enforcement: createForm('git-hooks.mjs',
+    ['--enforcement', '--cwd', '<root>'], ['--apply', '--enforcement', '--cwd', '<root>'], getEnforcementPaths),
+  'commit-guard': createForm('git-hooks.mjs',
+    ['--commit-guard', '--cwd', '<root>'], ['--apply', '--commit-guard', '--cwd', '<root>'], getGuardPaths),
+  'worktrees-dir': createForm('velocity-profile.mjs',
+    ['--worktrees', '--cwd', '<root>'], ['--apply', '--worktrees', '--cwd', '<root>'], LOCAL_SETTINGS_WRITES, false, null, true),
+  'worktrees-dir.home': Object.freeze({
+    userStep: () => 'your own step — point docs/ai/worktrees.json parentDir at a dedicated directory, then run /agent-workflow-kit recommendations',
+  }),
 });
 
 const resolveArgument = (arg, facts) => {
@@ -183,6 +199,11 @@ export const isEnvDependent = (variant) => {
   return FORMS[variant]?.envDependent === true;
 };
 
+export const isRejudged = (variant) => {
+  laneOf(variant);
+  return FORMS[variant]?.rejudged === true;
+};
+
 export const applySlot = (variant, facts) => {
   const lane = laneOf(variant);
   const form = FORMS[variant];