@lifeaitools/rdc-skills 0.9.35 → 0.9.37

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rdc",
-  "version": "0.9.35",
+  "version": "0.9.37",
   "description": "RDC typed-agent dispatch skill suite for Claude Code — plan, build, review, overnight unattended builds with work-item tracking and TDD enforcement.",
   "author": {
     "name": "LIFEAI",

package/CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## v0.9.37 — RDC hook loop guard and behavior tests
+
+### Fixed
+
+- **Stop hook reentry.** `rdc-output-contract-gate.js` now exits cleanly when Claude is already inside an active Stop-hook retry, preventing noncompliant-but-legitimate turns from hard-looping the session.
+- **Marker deduplication.** `rdc-invocation-marker.js` now preserves the original marker when `UserPromptExpansion` and `UserPromptSubmit` both fire for the same RDC command within the same second.
+
+### Added
+
+- **Hook behavioral tests.** New `scripts/test-rdc-hooks.mjs` executes the marker and Stop hooks against real JSON payloads, and `self-test --strict` now fails if those behavioral checks fail.
+
+---
+
+## v0.9.36 — Portable installer profiles and startup onboarding
+
+### Added
+
+- **Installer profiles.** `--profile core` installs clean-box-safe hooks only; `--profile lifeai` keeps the LIFEAI/regen-root cwd, clauth, Supabase, and overnight hooks. `auto` chooses `lifeai` only when a sibling `regen-root` project is detected.
+- **Managed startup guide.** New `guides/rdc-skills-startup.md` explains what RDC skills add, the active profiles, and where to find skills, commands, guides, hooks, and installer behavior.
+- **Optional startup block writer.** `--project-root <path> --write-startup-blocks` writes `.rdc/guides/rdc-skills-startup.md` plus managed RDC sections in project `CLAUDE.md` and `AGENTS.md`.
+- **Install welcome.** The installer now prints the selected profile, what it enables, and where to look next.
+
+### Changed
+
+- The default clean-box profile no longer wires regen-root-specific hooks such as cwd lock, Supabase work-item exit gate, rate-limit retry, or overnight open-epic guard.
+
+---
+
 ## v0.9.35 — RDC output-contract hook enforcement
 
 ### Added

package/README.md

@@ -45,6 +45,27 @@ rm -rf ~/.claude/plugins/cache/rdc-skills/rdc-skills/0.7.*
 
 Use **one method only**: plugin (Option A or B) OR manual install — never both.
 
+### Installer profiles
+
+`scripts/install-rdc-skills.js` supports profiles:
+
+```bash
+node scripts/install-rdc-skills.js --profile core
+node scripts/install-rdc-skills.js --profile lifeai
+```
+
+- `core` is safe for a clean machine with only rdc-skills installed. It wires portable hooks only: RDC output-contract enforcement, foreground-process policy, commit-message hygiene, and non-blocking work logging.
+- `lifeai` is for the LIFEAI/regen-root workstation. It additionally wires the regen-root cwd lock, clauth/Supabase work-item gates, overnight queue guard, and LIFEAI session hooks.
+- `auto` is the default. It chooses `lifeai` only when a sibling `regen-root` project is detected; otherwise it chooses `core`.
+
+To add managed startup instructions to a project:
+
+```bash
+node scripts/install-rdc-skills.js --project-root /path/to/project --write-startup-blocks
+```
+
+This writes `.rdc/guides/rdc-skills-startup.md` and managed RDC sections in `CLAUDE.md` and `AGENTS.md`.
+
 ### Legacy install scripts (deprecated since v0.6.0)
 
 `scripts/install.sh` and `scripts/install.ps1` copy files into `~/.claude/skills/user/`. These exist only for environments that cannot use the plugin system. Running them alongside the plugin creates duplicates. Do not use them if you have the plugin installed.
@@ -176,7 +197,7 @@ python3 -c "import json; print(json.load(open('package.json'))['version'])"
 /rdc:help
 ```
 
-Current version: **v0.9.35**
+Current version: **v0.9.36**
 
 ## Quick Start
 

package/guides/rdc-skills-startup.md

@@ -0,0 +1,30 @@
+# RDC Skills Startup Contract
+> Managed by `rdc-skills`. Keep local project-specific details in adjacent project guides.
+
+## What RDC Skills Adds
+
+- Slash commands for the RDC workflow: plan, build, review, report, design, deploy, release, status, and work item operations.
+- Output-contract enforcement for active `/rdc:*` turns: visible checklist rows plus a final verdict line.
+- Engineering behavior guidance: small scoped changes, explicit assumptions, evidence for completed work, and honest blockers.
+- Optional project integrations for work items, credentials, deployments, and release automation.
+
+## Agent Startup Rules
+
+1. Read the active project instructions first (`CLAUDE.md` for Claude Code, `AGENTS.md` for Codex).
+2. For any `/rdc:*` invocation, follow `.rdc/guides/output-contract.md` and `.rdc/guides/engineering-behavior.md`.
+3. Do not treat skill prose as proof. Completed work needs evidence: command output, test result, route probe, screenshot, SQL result, or source citation.
+4. If a project has its own approval gates, architecture rules, or credential model, those project rules override generic RDC defaults.
+5. When an RDC skill cannot access the required project services, stop with a specific blocker instead of inventing a fallback.
+
+## Profiles
+
+- `core`: portable defaults for a clean machine. No regen-root cwd lock, clauth requirement, Supabase exit gate, or LIFEAI deployment assumption.
+- `lifeai`: LIFEAI/regen-root defaults. Enables project-specific hooks and workflows for clauth, Supabase work items, deployment, and overnight queue behavior.
+
+## Where To Look
+
+- Skills: `skills/<name>/SKILL.md`
+- Commands: `commands/<name>.md`
+- Guides: `guides/*.md` and project copies under `.rdc/guides/`
+- Hooks: `hooks/*.js`
+- Installer: `scripts/install-rdc-skills.js`

package/hooks/rdc-invocation-marker.js

@@ -76,7 +76,7 @@ function detectRdc(raw) {
 
   if (event === 'UserPromptSubmit') {
     const prompt = String(raw.prompt || '').trim();
-    const m = prompt.match(/^\/(?:rdc[:-])?([a-z][a-z0-9-]*)\b/i);
+    const m = prompt.match(/^\/rdc[:-]([a-z][a-z0-9-]*)\b/i);
     if (!m) return null;
     const command = normalizeCommandName(m[1]);
     if (RDC_COMMANDS.has(command)) return command;
@@ -87,6 +87,20 @@ function detectRdc(raw) {
 
 function writeMarker(raw, command) {
   fs.mkdirSync(markerDir(), { recursive: true });
+  const p = markerPath(raw.session_id);
+  if (fs.existsSync(p)) {
+    try {
+      const existing = JSON.parse(fs.readFileSync(p, 'utf8'));
+      const started = Date.parse(existing.started_at || '');
+      const isRecentDuplicate = Number.isFinite(started) &&
+        Date.now() - started <= 1000 &&
+        existing.session_id === (raw.session_id || null) &&
+        existing.command === command;
+      if (isRecentDuplicate) {
+        return { ...existing, deduped: true };
+      }
+    } catch {}
+  }
   const marker = {
     session_id: raw.session_id || null,
     command,
@@ -98,7 +112,7 @@ function writeMarker(raw, command) {
     started_at: new Date().toISOString(),
     hook_event_name: raw.hook_event_name || null,
   };
-  fs.writeFileSync(markerPath(raw.session_id), JSON.stringify(marker, null, 2));
+  fs.writeFileSync(p, JSON.stringify(marker, null, 2));
   return marker;
 }
 
@@ -127,7 +141,7 @@ async function main() {
 
   try {
     const marker = writeMarker(raw, command);
-    hookLog('rdc-invocation-marker', raw.hook_event_name || 'unknown', 'marked', {
+    hookLog('rdc-invocation-marker', raw.hook_event_name || 'unknown', marker.deduped ? 'deduped' : 'marked', {
       command,
       session_id: marker.session_id,
     });

package/hooks/rdc-output-contract-gate.js

@@ -60,6 +60,14 @@ function pass(marker) {
   process.exit(0);
 }
 
+function passReentry(marker) {
+  try { fs.unlinkSync(marker.path); } catch {}
+  hookLog('rdc-output-contract-gate', 'Stop', 'pass-reentry', {
+    command: marker.data.command || null,
+  });
+  process.exit(0);
+}
+
 async function main() {
   let raw;
   try { raw = JSON.parse(await readStdin()); } catch { process.exit(0); }
@@ -70,6 +78,7 @@ async function main() {
   const checklist = hasChecklist(message);
   const verdict = hasVerdict(message);
   if (checklist && verdict) pass(marker);
+  if (raw.stop_hook_active === true) passReentry(marker);
 
   const command = marker.data.command || 'rdc';
   const missing = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.9.35",
+  "version": "0.9.37",
   "description": "RDC typed-agent dispatch skill suite for Claude Code - plan, build, review, overnight builds",
   "keywords": [
     "claude-code",
@@ -19,7 +19,7 @@
     "type": "plugin",
     "skills": "skills/",
     "guides": "guides/",
-    "version": "0.9.35",
+    "version": "0.9.37",
     "commands": "commands/"
   },
   "scripts": {
@@ -27,6 +27,7 @@
     "uninstall:win": "powershell -ExecutionPolicy Bypass -File scripts/uninstall.ps1",
     "uninstall:unix": "bash scripts/uninstall.sh",
     "validate": "node tests/validate-skills.js",
-    "rdc-design": "node scripts/rdc-design-cli.mjs"
+    "rdc-design": "node scripts/rdc-design-cli.mjs",
+    "test:hooks": "node scripts/test-rdc-hooks.mjs"
   }
 }

package/scripts/install-rdc-skills.js

@@ -5,9 +5,12 @@
  * Usage:
  *   node scripts/install-rdc-skills.js                      ← standard
  *   node scripts/install-rdc-skills.js --skip-hooks         ← skip hook wiring
+ *   node scripts/install-rdc-skills.js --profile core       ← clean-box portable hooks
+ *   node scripts/install-rdc-skills.js --profile lifeai     ← LIFEAI/regen-root hooks
  *   node scripts/install-rdc-skills.js --claude-home <path> ← custom CLI home
  *   node scripts/install-rdc-skills.js --codex-root <path>  ← also install to .agents/skills/user/
  *   node scripts/install-rdc-skills.js --codex-skill-dir <path> ← also install to a Codex skill dir
+ *   node scripts/install-rdc-skills.js --project-root <path> --write-startup-blocks
  *   node scripts/install-rdc-skills.js --migrate <path>     ← migrate docs/ → .rdc/
  *
  * What it does:
@@ -32,11 +35,16 @@ const { execSync } = require('child_process');
 // ── Args ──────────────────────────────────────────────────────────────────────
 const args       = process.argv.slice(2);
 const skipHooks  = args.includes('--skip-hooks');
+const profileIdx = args.indexOf('--profile');
+const profileArg = profileIdx >= 0 ? String(args[profileIdx + 1] || '').toLowerCase() : 'auto';
 const homeIdx    = args.indexOf('--claude-home');
 const claudeHome = homeIdx >= 0 ? args[homeIdx + 1] : path.join(os.homedir(), '.claude');
 const migrateIdx = args.indexOf('--migrate');
 const doMigrate  = migrateIdx >= 0;
 const migratePath = doMigrate ? (args[migrateIdx + 1] || process.cwd()) : null;
+const projectIdx = args.indexOf('--project-root');
+const projectRootArg = projectIdx >= 0 ? path.resolve(args[projectIdx + 1]) : null;
+const shouldWriteStartupBlocks = args.includes('--write-startup-blocks');
 
 const repoRoot     = path.resolve(__dirname, '..');
 
@@ -44,6 +52,7 @@ const codexIdx   = args.indexOf('--codex-root');
 const codexRoot  = codexIdx >= 0
   ? path.resolve(args[codexIdx + 1])
   : (() => {
+      if (projectRootArg) return null;
       const sibling = path.resolve(repoRoot, '..', 'regen-root');
       return fs.existsSync(path.join(sibling, '.agents')) ? sibling : null;
     })();
@@ -54,6 +63,18 @@ const explicitCodexSkillDir = codexSkillDirIdx >= 0
 const hooksSrc     = path.join(repoRoot, 'hooks');
 const hooksDst     = path.join(claudeHome, 'hooks');
 const settingsPath = path.join(claudeHome, 'settings.json');
+const detectedLifeaiRoot = (() => {
+  const sibling = path.resolve(repoRoot, '..', 'regen-root');
+  return fs.existsSync(path.join(sibling, 'CLAUDE.md')) && fs.existsSync(path.join(sibling, '.rdc')) ? sibling : null;
+})();
+const installProfile = (() => {
+  if (profileArg === 'core' || profileArg === 'lifeai') return profileArg;
+  if (profileArg !== 'auto') {
+    console.log(`  \x1b[33m⚠\x1b[0m Unknown --profile "${profileArg}" — using auto`);
+  }
+  return detectedLifeaiRoot ? 'lifeai' : 'core';
+})();
+const projectRoot = projectRootArg || codexRoot || detectedLifeaiRoot;
 
 const PLUGIN_KEY   = 'rdc-skills@rdc-skills';
 const MARKETPLACE  = 'rdc-skills';
@@ -108,6 +129,7 @@ function copyMissingProjectGuides(projectRoot) {
   let copied = 0;
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     if (!entry.isFile() || !entry.name.endsWith('.md')) continue;
+    if (entry.name === 'rdc-skills-startup.md') continue; // installed only by --write-startup-blocks
     const target = path.join(dst, entry.name);
     if (fs.existsSync(target)) continue;
     fs.copyFileSync(path.join(src, entry.name), target);
@@ -126,6 +148,53 @@ function writeJson(p, data, indent = 2) {
   fs.writeFileSync(p, JSON.stringify(data, null, indent));
 }
 
+function upsertManagedBlock(filePath, title, body) {
+  const begin = `<!-- BEGIN RDC-SKILLS:${title} -->`;
+  const end = `<!-- END RDC-SKILLS:${title} -->`;
+  const block = `${begin}\n${body.trim()}\n${end}\n`;
+  const current = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : '';
+  const re = new RegExp(`${begin.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[\\s\\S]*?${end.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\n?`, 'm');
+  const next = re.test(current)
+    ? current.replace(re, block)
+    : `${current.replace(/\s*$/, '')}${current.trim() ? '\n\n' : ''}${block}`;
+  if (next !== current) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, next);
+    return true;
+  }
+  return false;
+}
+
+function writeStartupBlocks(targetRoot, profile) {
+  if (!targetRoot) return { wrote: 0, skipped: 'no-project-root' };
+  const startupSrc = path.join(repoRoot, 'guides', 'rdc-skills-startup.md');
+  const guidesDir = path.join(targetRoot, '.rdc', 'guides');
+  const startupDst = path.join(guidesDir, 'rdc-skills-startup.md');
+  fs.mkdirSync(guidesDir, { recursive: true });
+  fs.copyFileSync(startupSrc, startupDst);
+
+  let wrote = 1;
+  const claudeBody = [
+    '## RDC Skills',
+    '',
+    '@.rdc/guides/rdc-skills-startup.md',
+    '',
+    `Installed profile: \`${profile}\`.`,
+    'For `/rdc:*` work, follow `.rdc/guides/output-contract.md` and `.rdc/guides/engineering-behavior.md`.',
+  ].join('\n');
+  const agentsBody = [
+    '## RDC Skills',
+    '',
+    'Read `.rdc/guides/rdc-skills-startup.md` before using any `rdc:*` workflow.',
+    `Installed profile: \`${profile}\`.`,
+    'For `/rdc:*` work, follow `.rdc/guides/output-contract.md` and `.rdc/guides/engineering-behavior.md`.',
+  ].join('\n');
+
+  if (upsertManagedBlock(path.join(targetRoot, 'CLAUDE.md'), 'STARTUP', claudeBody)) wrote++;
+  if (upsertManagedBlock(path.join(targetRoot, 'AGENTS.md'), 'STARTUP', agentsBody)) wrote++;
+  return { wrote, skipped: null };
+}
+
 // ── Frontmatter parser ────────────────────────────────────────────────────────
 function readFrontmatter(filePath) {
   try {
@@ -546,7 +615,7 @@ function buildZip(version) {
 }
 
 // ── Hook config ───────────────────────────────────────────────────────────────
-function buildHooksConfig(hooksDir) {
+function buildHooksConfig(hooksDir, profile = 'core') {
   const base = hooksDir.replace(/\\/g, '/');
   const cmd  = (file, msg) => {
     const command = process.platform === 'win32'
@@ -556,21 +625,16 @@ function buildHooksConfig(hooksDir) {
     if (msg) entry.statusMessage = msg;
     return entry;
   };
-  return {
+  const config = {
     UserPromptExpansion: [{ hooks: [
       cmd('rdc-invocation-marker.js', 'Marking RDC slash command...'),
     ]}],
     UserPromptSubmit: [{ hooks: [
       cmd('rdc-invocation-marker.js', 'Marking RDC prompt...'),
     ]}],
-    SessionStart: [{ hooks: [
-      cmd('check-cwd.js'),
-      cmd('check-stale-work-items.js', 'Checking for stale work items...'),
-    ]}],
     PreToolUse: [
       { hooks: [
         cmd('foreground-process-gate.js', 'Checking foreground process policy...'),
-        cmd('work-item-exit-gate.js', 'Checking work item exit gates...'),
       ]},
       { matcher: 'Bash', hooks: [
         cmd('require-work-item-on-commit.js'),
@@ -579,20 +643,36 @@ function buildHooksConfig(hooksDir) {
     PostToolUse: [{ hooks: [
       cmd('check-services.js'),
     ]}],
-    PreCompact: [{ hooks: [
-      cmd('precompact-log.js'),
-    ]}],
-    PostCompact: [{ hooks: [
-      cmd('postcompact-log.js'),
-      cmd('restart-brief.js', 'Writing restart brief...'),
-    ]}],
     Stop: [{ hooks: [
-      cmd('rate-limit-retry.js',   'Checking for rate limits...'),
       cmd('rdc-output-contract-gate.js', 'Checking RDC output contract...'),
       cmd('post-work-check.js',    'Checking for undocumented work...'),
-      cmd('no-stop-open-epics.js', 'Checking for open epics...'),
     ]}],
   };
+
+  if (profile === 'lifeai') {
+    config.SessionStart = [{ hooks: [
+      cmd('check-cwd.js'),
+      cmd('check-stale-work-items.js', 'Checking for stale work items...'),
+    ]}];
+    config.PreToolUse[0].hooks.push(
+      cmd('work-item-exit-gate.js', 'Checking work item exit gates...'),
+    );
+    config.PreCompact = [{ hooks: [
+      cmd('precompact-log.js'),
+    ]}];
+    config.PostCompact = [{ hooks: [
+      cmd('postcompact-log.js'),
+      cmd('restart-brief.js', 'Writing restart brief...'),
+    ]}];
+    config.Stop[0].hooks.unshift(
+      cmd('rate-limit-retry.js', 'Checking for rate limits...'),
+    );
+    config.Stop[0].hooks.push(
+      cmd('no-stop-open-epics.js', 'Checking for open epics...'),
+    );
+  }
+
+  return config;
 }
 
 // ── Preflight ─────────────────────────────────────────────────────────────────
@@ -682,6 +762,7 @@ async function main() {
   console.log('');
   console.log(`  CLAUDE_HOME : ${claudeHome}`);
   console.log(`  Plugin root : ${repoRoot}`);
+  console.log(`  Profile     : ${installProfile}${profileArg === 'auto' ? ' (auto)' : ''}`);
   console.log('');
 
   if (!fs.existsSync(claudeHome)) {
@@ -822,11 +903,20 @@ async function main() {
     info('[4/6] Hook wiring — skipped (--skip-hooks)');
   } else {
     const settings = readJson(settingsPath);
-    settings.hooks = buildHooksConfig(hooksDst);
+    settings.hooks = buildHooksConfig(hooksDst, installProfile);
     writeJson(settingsPath, settings);
     ok(`[4/6] Hook wiring — ${settingsPath}`);
   }
 
+  // 4.5 Optional startup blocks
+  if (shouldWriteStartupBlocks) {
+    const startup = writeStartupBlocks(projectRoot, installProfile);
+    if (startup.skipped) warn(`[4.5] Startup   — skipped (${startup.skipped})`);
+    else ok(`[4.5] Startup   — wrote managed startup guide/block(s) under ${projectRoot}`);
+  } else {
+    info('[4.5] Startup   — skipped (use --project-root <path> --write-startup-blocks)');
+  }
+
   // 5. Zip for claude.ai / distribution
   const zipPath = buildZip(version);
   if (zipPath) {
@@ -897,6 +987,15 @@ async function main() {
   console.log('  Cowork : restart Claude Desktop — /rdc:status in a new Cowork session');
   console.log('  claude.ai : no plugin install needed — use FS MCP to read commands on demand');
   console.log('            dist/rdc-skills-plugin-v' + version + '.zip available if needed');
+  console.log('');
+  console.log(`  Profile: ${installProfile}`);
+  if (installProfile === 'core') {
+    console.log('  Core hooks are portable: RDC output contract + foreground process + commit-message hygiene.');
+    console.log('  Project services are not provisioned. Configure work items, credentials, deploys, and project guides before using infrastructure-heavy skills.');
+  } else {
+    console.log('  LIFEAI hooks are active: regen-root cwd lock, Supabase work-item gates, clauth-aware checks, and overnight queue guard.');
+  }
+  console.log('  Startup blocks: run with --project-root <path> --write-startup-blocks to add managed CLAUDE.md/AGENTS.md sections.');
 
   listCommands();
 

package/scripts/install.ps1

@@ -7,10 +7,14 @@
 # Usage:
 #   ./install.ps1                  # standard install
 #   ./install.ps1 -SkipHooks       # skip hooks registration (e.g. if you manage hooks manually)
+#   ./install.ps1 -Profile core    # portable hooks only
+#   ./install.ps1 -Profile lifeai  # LIFEAI/regen-root hooks
 #   ./install.ps1 -ClaudeHome <path>  # custom CLAUDE_HOME
 
 param(
     [string]$ClaudeHome = "",
+    [ValidateSet("auto", "core", "lifeai")]
+    [string]$Profile = "auto",
     [switch]$SkipHooks = $false,
     [switch]$Force = $false
 )
@@ -22,6 +26,12 @@ if (-not $ClaudeHome) {
 
 $scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $repoRoot  = Split-Path -Parent $scriptDir
+$lifeaiRoot = Join-Path (Split-Path -Parent $repoRoot) "regen-root"
+$installProfile = if ($Profile -eq "auto") {
+    if ((Test-Path (Join-Path $lifeaiRoot "CLAUDE.md")) -and (Test-Path (Join-Path $lifeaiRoot ".rdc"))) { "lifeai" } else { "core" }
+} else {
+    $Profile
+}
 
 Write-Host ""
 Write-Host "  rdc-skills Installer" -ForegroundColor Green
@@ -29,6 +39,7 @@ Write-Host "  ====================" -ForegroundColor Green
 Write-Host ""
 Write-Host "  CLAUDE_HOME : $ClaudeHome" -ForegroundColor Cyan
 Write-Host "  Plugin root : $repoRoot" -ForegroundColor Cyan
+Write-Host "  Profile     : $installProfile$(if ($Profile -eq 'auto') { ' (auto)' } else { '' })" -ForegroundColor Cyan
 Write-Host ""
 
 if (-not (Test-Path $ClaudeHome)) {
@@ -96,19 +107,10 @@ if ($SkipHooks) {
                 )
             }
         )
-        SessionStart = @(
-            [PSCustomObject]@{
-                hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-cwd.js`"" },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-stale-work-items.js`""; statusMessage = "Checking for stale work items..." }
-                )
-            }
-        )
         PreToolUse = @(
             [PSCustomObject]@{
                 hooks   = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/foreground-process-gate.js`""; statusMessage = "Checking foreground process policy..." },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/work-item-exit-gate.js`""; statusMessage = "Checking work item exit gates..." }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/foreground-process-gate.js`""; statusMessage = "Checking foreground process policy..." }
                 )
             },
             [PSCustomObject]@{
@@ -125,31 +127,42 @@ if ($SkipHooks) {
                 )
             }
         )
-        PreCompact = @(
+        Stop = @(
             [PSCustomObject]@{
                 hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/precompact-log.js`"" }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-output-contract-gate.js`""; statusMessage = "Checking RDC output contract..." },
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/post-work-check.js`""; statusMessage = "Checking for undocumented work..." }
                 )
             }
         )
-        PostCompact = @(
+    }
+
+    if ($installProfile -eq "lifeai") {
+        $hooksConfig | Add-Member -NotePropertyName "SessionStart" -NotePropertyValue @(
             [PSCustomObject]@{
                 hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/postcompact-log.js`"" },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/restart-brief.js`""; statusMessage = "Writing restart brief..." }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-cwd.js`"" },
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/check-stale-work-items.js`""; statusMessage = "Checking for stale work items..." }
                 )
             }
         )
-        Stop = @(
+        $hooksConfig.PreToolUse[0].hooks += [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/work-item-exit-gate.js`""; statusMessage = "Checking work item exit gates..." }
+        $hooksConfig | Add-Member -NotePropertyName "PreCompact" -NotePropertyValue @(
+            [PSCustomObject]@{ hooks = @([PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/precompact-log.js`"" }) }
+        )
+        $hooksConfig | Add-Member -NotePropertyName "PostCompact" -NotePropertyValue @(
             [PSCustomObject]@{
                 hooks = @(
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rate-limit-retry.js`""; statusMessage = "Checking for rate limits..." },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-output-contract-gate.js`""; statusMessage = "Checking RDC output contract..." },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/post-work-check.js`""; statusMessage = "Checking for undocumented work..." },
-                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/no-stop-open-epics.js`""; statusMessage = "Checking for open epics..." }
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/postcompact-log.js`"" },
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/restart-brief.js`""; statusMessage = "Writing restart brief..." }
                 )
             }
         )
+        $hooksConfig.Stop[0].hooks = @(
+            [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rate-limit-retry.js`""; statusMessage = "Checking for rate limits..." }
+        ) + $hooksConfig.Stop[0].hooks + @(
+            [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/no-stop-open-epics.js`""; statusMessage = "Checking for open epics..." }
+        )
     }
 
     # Add/replace hooks key
@@ -163,6 +176,8 @@ if ($SkipHooks) {
     $settings | ConvertTo-Json -Depth 20 | Set-Content $settingsPath -Encoding UTF8
     Write-Host "  [3/3] Hook wiring ✓  registered in $settingsPath" -ForegroundColor Green
 }
+}
+}
 
 # ── Summary ───────────────────────────────────────────────────────────────────
 
@@ -184,3 +199,4 @@ Write-Host "  4. Run /rdc:status in Claude Code to verify"
 Write-Host ""
 Write-Host "  Docs: https://github.com/LIFEAI/rdc-skills#readme" -ForegroundColor Cyan
 Write-Host ""
+}

package/scripts/self-test.mjs

@@ -31,6 +31,7 @@
 import { readFileSync, readdirSync, existsSync, writeFileSync, appendFileSync, renameSync, mkdirSync, statSync } from "node:fs";
 import { join, basename, dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
 import { loadAllManifests } from "./lib/manifest-schema.mjs";
 import { runManifest } from "./lib/runner.mjs";
 import {
@@ -802,6 +803,19 @@ function auditRequiredHookWiring() {
   return findings;
 }
 
+function runHookBehaviorTests() {
+  const result = spawnSync(process.execPath, [join(REPO_ROOT, "scripts", "test-rdc-hooks.mjs")], {
+    cwd: REPO_ROOT,
+    encoding: "utf8",
+  });
+  return {
+    ok: result.status === 0,
+    status: result.status,
+    stdout: (result.stdout || "").trim(),
+    stderr: (result.stderr || "").trim(),
+  };
+}
+
 // ─── Tier 2 behavioral runner ──────────────────────────────────────────────
 
 async function runPool(items, concurrency, worker) {
@@ -1038,6 +1052,7 @@ function main() {
     }
 
     const guideValidatorResultJson = !ONLY_SKILL ? runGuideContentValidator() : null;
+    const hookBehaviorResultJson = !ONLY_SKILL ? runHookBehaviorTests() : null;
 
     const failed = results.filter((r) => r.errors.length > 0);
     const warned = results.filter((r) => r.warnings.length > 0 && r.errors.length === 0);
@@ -1050,6 +1065,11 @@ function main() {
       ...duplicateFindings.filter((f) => f.level === "error"),
       ...orphanHookFindings.filter((f) => f.level === "error"),
       ...(guideValidatorResultJson ? guideValidatorResultJson.errors : []),
+      ...(hookBehaviorResultJson && !hookBehaviorResultJson.ok ? [{
+        level: "error",
+        code: "hook-behavior-test-failed",
+        message: hookBehaviorResultJson.stderr || hookBehaviorResultJson.stdout || `exit ${hookBehaviorResultJson.status}`,
+      }] : []),
     ];
     const globalWarnings = [
       ...manifestAudit.findings.filter((f) => f.level === "warn"),
@@ -1092,6 +1112,7 @@ function main() {
                 findings: guideValidatorResultJson.findings,
               }
             : null,
+          hook_behavior_tests: hookBehaviorResultJson,
           results: results.map((r) => ({
             skill: r.skill,
             file: r.file,
@@ -1217,10 +1238,12 @@ function main() {
   let duplicateFindings = [];
   let orphanHookFindings = [];
   let requiredHookFindings = [];
+  let hookBehaviorResult = null;
   if (!ONLY_SKILL) {
     duplicateFindings = auditDuplicates(results);
     orphanHookFindings = auditOrphanHooks(results);
     requiredHookFindings = auditRequiredHookWiring();
+    hookBehaviorResult = runHookBehaviorTests();
   }
 
   if (duplicateFindings.length + orphanHookFindings.length + requiredHookFindings.length > 0) {
@@ -1230,6 +1253,14 @@ function main() {
     }
   }
 
+  if (hookBehaviorResult) {
+    console.log("\nhook behavior tests\n");
+    console.log("─".repeat(80));
+    console.log(hookBehaviorResult.ok ? "  pass  rdc marker/gate behavioral smoke tests" : "  FAIL  rdc marker/gate behavioral smoke tests");
+    if (hookBehaviorResult.stdout) console.log(`  ${hookBehaviorResult.stdout}`);
+    if (hookBehaviorResult.stderr) console.log(`  ${hookBehaviorResult.stderr}`);
+  }
+
   if (FIXED_FILES.length > 0) {
     console.log("\nfixed files (review with git diff):");
     for (const p of FIXED_FILES) console.log(`  ${p}`);
@@ -1243,6 +1274,11 @@ function main() {
     ...orphanHookFindings.filter((f) => f.level === "error"),
     ...requiredHookFindings.filter((f) => f.level === "error"),
     ...(guideValidatorResult ? guideValidatorResult.errors : []),
+    ...(hookBehaviorResult && !hookBehaviorResult.ok ? [{
+      level: "error",
+      code: "hook-behavior-test-failed",
+      message: hookBehaviorResult.stderr || hookBehaviorResult.stdout || `exit ${hookBehaviorResult.status}`,
+    }] : []),
   ];
   const globalWarnings = [
     ...manifestAudit.findings.filter((f) => f.level === "warn"),

package/scripts/test-rdc-hooks.mjs

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+// Behavioral smoke tests for the RDC marker and Stop output-contract hooks.
+
+import { mkdtempSync, rmSync, existsSync, readFileSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join, resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const REPO_ROOT = resolve(__dirname, "..");
+const MARKER_HOOK = join(REPO_ROOT, "hooks", "rdc-invocation-marker.js");
+const STOP_HOOK = join(REPO_ROOT, "hooks", "rdc-output-contract-gate.js");
+
+const tmpHome = mkdtempSync(join(tmpdir(), "rdc-hooks-"));
+const env = { ...process.env, HOME: tmpHome, USERPROFILE: tmpHome };
+const failures = [];
+
+function markerPath(sessionId) {
+  return join(tmpHome, ".claude", "rdc-active", `${sessionId}.json`);
+}
+
+function runHook(script, payload) {
+  return spawnSync(process.execPath, [script], {
+    input: JSON.stringify(payload),
+    encoding: "utf8",
+    env,
+  });
+}
+
+function assert(name, condition, detail = "") {
+  if (!condition) failures.push(`${name}${detail ? `: ${detail}` : ""}`);
+}
+
+function readMarker(sessionId) {
+  return JSON.parse(readFileSync(markerPath(sessionId), "utf8"));
+}
+
+try {
+  const expansion = runHook(MARKER_HOOK, {
+    hook_event_name: "UserPromptExpansion",
+    session_id: "s-expansion",
+    command_source: "plugin",
+    command_name: "rdc:design",
+    prompt: "/rdc:design palette audit",
+  });
+  assert("expansion exits zero", expansion.status === 0, expansion.stderr);
+  assert("expansion emits context", /RDC CONTRACT ACTIVE/.test(expansion.stdout), expansion.stdout);
+  assert("expansion writes marker", existsSync(markerPath("s-expansion")));
+  assert("expansion marker event preserved", readMarker("s-expansion").hook_event_name === "UserPromptExpansion");
+
+  const builtin = runHook(MARKER_HOOK, {
+    hook_event_name: "UserPromptExpansion",
+    session_id: "s-builtin",
+    command_source: "builtin",
+    command_name: "help",
+    prompt: "/help",
+  });
+  assert("builtin exits zero", builtin.status === 0, builtin.stderr);
+  assert("builtin emits no context", builtin.stdout.trim() === "", builtin.stdout);
+  assert("builtin writes no marker", !existsSync(markerPath("s-builtin")));
+
+  const submit1 = runHook(MARKER_HOOK, {
+    hook_event_name: "UserPromptExpansion",
+    session_id: "s-dedup",
+    command_source: "plugin",
+    command_name: "rdc:design",
+    prompt: "/rdc:design button audit",
+  });
+  assert("dedup first mark exits zero", submit1.status === 0, submit1.stderr);
+  const first = readMarker("s-dedup");
+  const submit2 = runHook(MARKER_HOOK, {
+    hook_event_name: "UserPromptSubmit",
+    session_id: "s-dedup",
+    prompt: "/rdc:design button audit",
+  });
+  assert("dedup second mark exits zero", submit2.status === 0, submit2.stderr);
+  const second = readMarker("s-dedup");
+  assert("dedup preserves started_at", second.started_at === first.started_at);
+  assert("dedup preserves hook event", second.hook_event_name === "UserPromptExpansion");
+
+  const genericHelp = runHook(MARKER_HOOK, {
+    hook_event_name: "UserPromptSubmit",
+    session_id: "s-help",
+    prompt: "/help",
+  });
+  assert("generic help exits zero", genericHelp.status === 0, genericHelp.stderr);
+  assert("generic help writes no marker", !existsSync(markerPath("s-help")));
+
+  const noMarker = runHook(STOP_HOOK, {
+    hook_event_name: "Stop",
+    session_id: "s-no-marker",
+    last_assistant_message: "plain chat",
+  });
+  assert("stop without marker exits zero", noMarker.status === 0, noMarker.stderr);
+  assert("stop without marker is silent", noMarker.stdout.trim() === "", noMarker.stdout);
+
+  writeFileSync(markerPath("s-block"), JSON.stringify({
+    session_id: "s-block",
+    command: "design",
+    started_at: new Date().toISOString(),
+  }, null, 2));
+  const blocked = runHook(STOP_HOOK, {
+    hook_event_name: "Stop",
+    session_id: "s-block",
+    last_assistant_message: "No contract artifacts here.",
+  });
+  assert("noncompliant stop exits zero", blocked.status === 0, blocked.stderr);
+  assert("noncompliant stop blocks", /"decision"\s*:\s*"block"/.test(blocked.stdout), blocked.stdout);
+  assert("noncompliant stop retains marker", existsSync(markerPath("s-block")));
+
+  const reentry = runHook(STOP_HOOK, {
+    hook_event_name: "Stop",
+    session_id: "s-block",
+    stop_hook_active: true,
+    last_assistant_message: "Still no contract artifacts.",
+  });
+  assert("stop reentry exits zero", reentry.status === 0, reentry.stderr);
+  assert("stop reentry allows silent pass", reentry.stdout.trim() === "", reentry.stdout);
+  assert("stop reentry clears marker", !existsSync(markerPath("s-block")));
+
+  writeFileSync(markerPath("s-pass"), JSON.stringify({
+    session_id: "s-pass",
+    command: "review",
+    started_at: new Date().toISOString(),
+  }, null, 2));
+  const compliant = runHook(STOP_HOOK, {
+    hook_event_name: "Stop",
+    session_id: "s-pass",
+    last_assistant_message: "[x] Verified hook behavior\n\n✅ Complete in 2s",
+  });
+  assert("compliant stop exits zero", compliant.status === 0, compliant.stderr);
+  assert("compliant stop is silent", compliant.stdout.trim() === "", compliant.stdout);
+  assert("compliant stop clears marker", !existsSync(markerPath("s-pass")));
+} finally {
+  rmSync(tmpHome, { recursive: true, force: true });
+}
+
+if (failures.length > 0) {
+  console.error("\nrdc hook behavior tests — FAIL\n");
+  for (const failure of failures) console.error(`  - ${failure}`);
+  process.exit(1);
+}
+
+console.log("rdc hook behavior tests — PASS");