@lifeaitools/rdc-skills 0.9.33 → 0.9.35

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

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Stop hook — enforce visible RDC output contract artifacts.
+ *
+ * Triggered only when rdc-invocation-marker.js has marked the session. It checks
+ * positive output patterns only: at least one checklist row and one verdict
+ * line. It intentionally does not police forbidden phrases.
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const hookLog = require('./hook-logger');
+
+function readStdin() {
+  return new Promise((resolve) => {
+    let input = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => { input += chunk; });
+    process.stdin.on('end', () => resolve(input));
+    process.stdin.resume();
+  });
+}
+
+function markerPath(sessionId) {
+  const safe = String(sessionId || 'unknown').replace(/[^a-zA-Z0-9_.-]/g, '_');
+  return path.join(os.homedir(), '.claude', 'rdc-active', `${safe}.json`);
+}
+
+function readMarker(sessionId) {
+  const p = markerPath(sessionId);
+  if (!fs.existsSync(p)) return null;
+  try {
+    return { path: p, data: JSON.parse(fs.readFileSync(p, 'utf8')) };
+  } catch {
+    return { path: p, data: { command: 'unknown' } };
+  }
+}
+
+function hasChecklist(text) {
+  return /(?:^|\n)\s*(?:[-*]\s*)?\[(?: |x|X|~|!|-)\]\s+\S/m.test(text || '');
+}
+
+function hasVerdict(text) {
+  return /(?:^|\n)\s*(?:✅|⚠️|❌)\s+\S/m.test(text || '');
+}
+
+function block(reason, details = {}) {
+  hookLog('rdc-output-contract-gate', 'Stop', 'block', details);
+  process.stdout.write(JSON.stringify({ decision: 'block', reason }));
+  process.exit(0);
+}
+
+function pass(marker) {
+  try { fs.unlinkSync(marker.path); } catch {}
+  hookLog('rdc-output-contract-gate', 'Stop', 'pass', {
+    command: marker.data.command || null,
+  });
+  process.exit(0);
+}
+
+async function main() {
+  let raw;
+  try { raw = JSON.parse(await readStdin()); } catch { process.exit(0); }
+  const marker = readMarker(raw.session_id);
+  if (!marker) process.exit(0);
+
+  const message = String(raw.last_assistant_message || '');
+  const checklist = hasChecklist(message);
+  const verdict = hasVerdict(message);
+  if (checklist && verdict) pass(marker);
+
+  const command = marker.data.command || 'rdc';
+  const missing = [];
+  if (!checklist) missing.push('a visible checklist row like `[ ] Step` or `[x] Step`');
+  if (!verdict) missing.push('a final verdict line beginning with ✅, ⚠️, or ❌');
+
+  block(
+    `RDC output contract incomplete for /${command}: missing ${missing.join(' and ')}. Continue the response by rendering the RDC checklist and verdict required by .rdc/guides/output-contract.md. Do not restart the task; correct the visible output contract.`,
+    { command, checklist, verdict, stop_hook_active: raw.stop_hook_active === true },
+  );
+}
+
+main().catch((e) => block(`RDC output contract gate crashed: ${e.message}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifeaitools/rdc-skills",
-  "version": "0.9.33",
+  "version": "0.9.35",
   "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.33",
+    "version": "0.9.35",
     "commands": "commands/"
   },
   "scripts": {

package/scripts/install-rdc-skills.js

@@ -100,6 +100,22 @@ function copyDirRecursive(src, dst) {
   }
 }
 
+function copyMissingProjectGuides(projectRoot) {
+  if (!projectRoot) return 0;
+  const src = path.join(repoRoot, 'guides');
+  const dst = path.join(projectRoot, '.rdc', 'guides');
+  if (!fs.existsSync(src) || !fs.existsSync(dst)) return 0;
+  let copied = 0;
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (!entry.isFile() || !entry.name.endsWith('.md')) continue;
+    const target = path.join(dst, entry.name);
+    if (fs.existsSync(target)) continue;
+    fs.copyFileSync(path.join(src, entry.name), target);
+    copied++;
+  }
+  return copied;
+}
+
 function readJson(p, fallback = {}) {
   if (!fs.existsSync(p)) return fallback;
   try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch { return fallback; }
@@ -541,6 +557,12 @@ function buildHooksConfig(hooksDir) {
     return entry;
   };
   return {
+    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...'),
@@ -566,6 +588,7 @@ function buildHooksConfig(hooksDir) {
     ]}],
     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...'),
     ]}],
@@ -780,6 +803,12 @@ async function main() {
     } else {
       info('[2.7] Symlinks   — no rdc skill links created (skills may already be linked)');
     }
+    const projectGuideCount = copyMissingProjectGuides(codexRoot);
+    if (projectGuideCount > 0) {
+      ok(`[2.8] Guides     — ${projectGuideCount} missing guide(s) copied to ${path.join(codexRoot, '.rdc', 'guides')}`);
+    } else {
+      info('[2.8] Guides     — project .rdc/guides already has base guide files or is absent');
+    }
   } else {
     info('[2.7] Symlinks   — skipped (no codex root found)');
   }

package/scripts/install.ps1

@@ -82,6 +82,20 @@ if ($SkipHooks) {
     $hooksBase = $hooksDir.Replace("\", "/")
 
     $hooksConfig = [PSCustomObject]@{
+        UserPromptExpansion = @(
+            [PSCustomObject]@{
+                hooks = @(
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC slash command..." }
+                )
+            }
+        )
+        UserPromptSubmit = @(
+            [PSCustomObject]@{
+                hooks = @(
+                    [PSCustomObject]@{ type = "command"; command = "powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -WindowStyle Hidden -File `"$hooksBase/run-hidden-hook.ps1`" `"$hooksBase/rdc-invocation-marker.js`""; statusMessage = "Marking RDC prompt..." }
+                )
+            }
+        )
         SessionStart = @(
             [PSCustomObject]@{
                 hooks = @(
@@ -130,6 +144,7 @@ if ($SkipHooks) {
             [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..." }
                 )