@ghl-ai/aw 0.1.37-beta.8 → 0.1.37

package/git.mjs

@@ -5,7 +5,7 @@ import { mkdtempSync, existsSync, lstatSync, rmSync, readFileSync, symlinkSync,
 import { join, basename, dirname } from 'node:path';
 import { homedir, tmpdir } from 'node:os';
 import { promisify } from 'node:util';
-import { REGISTRY_BASE_BRANCH, REGISTRY_DIR, DOCS_SOURCE_DIR } from './constants.mjs';
+import { REGISTRY_BASE_BRANCH, REGISTRY_DIR, DOCS_SOURCE_DIR, RULES_SOURCE_DIR } from './constants.mjs';
 
 const exec = promisify(execCb);
 
@@ -91,6 +91,7 @@ export function includeToSparsePaths(paths) {
   result.add(`${REGISTRY_DIR}/AW-PROTOCOL.md`);
   if (paths.includes('platform')) {
     result.add(DOCS_SOURCE_DIR);
+    result.add(RULES_SOURCE_DIR);
   }
   return [...result];
 }

package/hooks.mjs

@@ -9,6 +9,7 @@ import { execSync } from 'node:child_process';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import * as fmt from './fmt.mjs';
+import { AW_CO_AUTHOR } from './constants.mjs';
 
 const HOME = homedir();
 const HOOKS_DIR = join(HOME, '.aw', 'hooks');
@@ -113,6 +114,27 @@ fi
 exit 0
 `;
 
+// prepare-commit-msg: synchronous hook — appends Co-Authored-By trailer to commits
+// in AW-linked repos. Skips merge commits and respects AW_NO_COAUTHOR=1 opt-out.
+const PREPARE_COMMIT_MSG = makeDispatcher('prepare-commit-msg', `\
+# Inject co-author trailer unless it's a merge commit or opt-out is set
+if [ "$2" != "merge" ] && [ "$AW_NO_COAUTHOR" != "1" ]; then
+  # Only brand AW-linked repos (check for .aw/ symlink or worktree)
+  if [ -L ".aw" ] || [ -f ".aw/.git" ]; then
+    TRAILER="${AW_CO_AUTHOR}"
+    # Replace Claude/Cursor co-author trailers with AW
+    sed -i.bak '/^Co-Authored-By:.*Claude/d' "$1" 2>/dev/null || true
+    sed -i.bak '/^Co-Authored-By:.*noreply@anthropic\\.com/d' "$1" 2>/dev/null || true
+    sed -i.bak '/^Co-Authored-By:.*Cursor/d' "$1" 2>/dev/null || true
+    rm -f "$1.bak"
+    # Only append if not already present (idempotent)
+    if ! grep -qF "$TRAILER" "$1"; then
+      echo "" >> "$1"
+      echo "$TRAILER" >> "$1"
+    fi
+  fi
+fi`);
+
 /**
  * Install global git hooks at ~/.aw/hooks/ and set core.hooksPath.
  * If core.hooksPath is already set by another tool, saves the previous
@@ -136,6 +158,9 @@ export function installGlobalHooks() {
     writeFileSync(join(HOOKS_DIR, 'post-commit'), POST_COMMIT);
     chmodSync(join(HOOKS_DIR, 'post-commit'), '755');
 
+    writeFileSync(join(HOOKS_DIR, 'prepare-commit-msg'), PREPARE_COMMIT_MSG);
+    chmodSync(join(HOOKS_DIR, 'prepare-commit-msg'), '755');
+
     // Detect and preserve existing core.hooksPath
     let previousPath = null;
     try {
@@ -199,3 +224,79 @@ export function removeGlobalHooks() {
 
   fmt.logStep('Global git hooks removed');
 }
+
+// Standalone prepare-commit-msg for local .git/hooks/ installation.
+// Unlike the global dispatcher, this does NOT chain to repo-local hooks
+// (because it IS the repo-local hook — chaining would cause infinite recursion).
+const LOCAL_PREPARE_COMMIT_MSG = `#!/bin/sh
+# aw: local prepare-commit-msg hook (installed by aw init)
+
+# Skip aw temp dirs
+case "$(pwd)" in /tmp/aw-*|/var/folders/*/aw-*|*/.aw|*/.aw/*) exit 0 ;; esac
+
+# Skip merge commits
+[ "$2" = "merge" ] && exit 0
+
+# Opt-out escape hatch
+[ "$AW_NO_COAUTHOR" = "1" ] && exit 0
+
+# Only brand AW-linked repos (check for .aw/ symlink or worktree)
+if [ -L ".aw" ] || [ -f ".aw/.git" ]; then
+  TRAILER="${AW_CO_AUTHOR}"
+  # Replace Claude/Cursor co-author trailers with AW
+  sed -i.bak '/^Co-Authored-By:.*Claude/d' "$1" 2>/dev/null || true
+  sed -i.bak '/^Co-Authored-By:.*noreply@anthropic\\.com/d' "$1" 2>/dev/null || true
+  sed -i.bak '/^Co-Authored-By:.*Cursor/d' "$1" 2>/dev/null || true
+  rm -f "$1.bak"
+  # Only append if not already present (idempotent)
+  if ! grep -qF "$TRAILER" "$1"; then
+    echo "" >> "$1"
+    echo "$TRAILER" >> "$1"
+  fi
+fi
+
+exit 0
+`;
+
+/**
+ * Install prepare-commit-msg hook into a project's local .git/hooks/.
+ * This covers repos where another tool (e.g. Claude Code) sets a local
+ * core.hooksPath that overrides the global one.
+ *
+ * @param {string} projectDir — root of the project (must contain .git/)
+ */
+export function installLocalCommitHook(projectDir) {
+  if (process.env.AW_NO_HOOKS === '1') return;
+  try {
+    const gitDir = join(projectDir, '.git');
+    if (!existsSync(gitDir)) return;
+
+    // Only install if a local core.hooksPath is set (overrides our global hooks)
+    let localHooksPath;
+    try {
+      localHooksPath = execSync('git config --local core.hooksPath', {
+        cwd: projectDir, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
+      }).trim();
+    } catch { return; /* no local override — global hooks will handle it */ }
+
+    if (!localHooksPath) return;
+
+    // Resolve relative paths against projectDir
+    const hooksDir = localHooksPath.startsWith('/')
+      ? localHooksPath
+      : join(projectDir, localHooksPath);
+
+    mkdirSync(hooksDir, { recursive: true });
+
+    const hookPath = join(hooksDir, 'prepare-commit-msg');
+    // Don't overwrite if a non-aw hook already exists
+    if (existsSync(hookPath)) {
+      const content = readFileSync(hookPath, 'utf8');
+      if (!content.includes('aw:') && !content.includes('Co-Authored-By')) return;
+    }
+
+    writeFileSync(hookPath, LOCAL_PREPARE_COMMIT_MSG);
+    chmodSync(hookPath, '755');
+  } catch { /* best effort */ }
+}
+

package/integrate.mjs

@@ -6,6 +6,19 @@ import { homedir } from 'node:os';
 import * as fmt from './fmt.mjs';
 import * as config from './config.mjs';
 import { getLocalRegistryDir } from './git.mjs';
+import { renderRules } from './render-rules.mjs';
+
+function upsertRulesSection(content, header, section) {
+  if (!section) return content;
+
+  const marker = `## ${header}`;
+  const idx = content.indexOf(marker);
+  if (idx === -1) {
+    return `${content.trimEnd()}\n\n${section}\n`;
+  }
+
+  return `${content.slice(0, idx).trimEnd()}\n\n${section}\n`;
+}
 
 /**
  * Count hand-written commands already present in the registry.
@@ -62,15 +75,29 @@ function findFiles(dir, typeName) {
 }
 
 /**
- * Copy AGENTS.md to project root.
- * CLAUDE.md is intentionally NOT generated — its routing rule hijacks plugin
- * commands like /aw:plan, preventing proper agent dispatch.
+ * Copy AGENTS.md to project root and refresh rules sections in any existing
+ * CLAUDE.md. New CLAUDE.md files are intentionally not generated because their
+ * routing rules can hijack plugin command dispatch in some workspaces.
  */
 export function copyInstructions(cwd, tempDir, namespace) {
+  const rulesSections = renderRules(cwd);
   const createdFiles = [];
-  for (const file of ['AGENTS.md']) {
+  for (const file of ['AGENTS.md', 'CLAUDE.md']) {
     const dest = join(cwd, file);
-    if (existsSync(dest)) continue;
+    if (existsSync(dest)) {
+      const existing = readFileSync(dest, 'utf8');
+      const updated = file === 'CLAUDE.md'
+        ? upsertRulesSection(existing, 'Platform Rules (MUST)', rulesSections.claudeSection)
+        : upsertRulesSection(existing, 'Platform Rules — Non-Negotiables', rulesSections.agentsSection);
+
+      if (updated !== existing) {
+        writeFileSync(dest, updated);
+        fmt.logSuccess(`Updated ${file}`);
+      }
+      continue;
+    }
+
+    if (file === 'CLAUDE.md') continue;
 
     if (tempDir) {
       const src = join(tempDir, '.aw_registry', file);
@@ -86,7 +113,7 @@ export function copyInstructions(cwd, tempDir, namespace) {
       }
     }
 
-    const content = generateAgentsMd(cwd, namespace);
+    const content = generateAgentsMd(cwd, namespace, rulesSections);
     if (content) {
       writeFileSync(dest, content);
       fmt.logSuccess(`Created ${file}`);
@@ -96,9 +123,9 @@ export function copyInstructions(cwd, tempDir, namespace) {
   return createdFiles;
 }
 
-function generateClaudeMd(cwd, namespace) {
+function generateClaudeMd(cwd, namespace, rulesSections = {}) {
   const team = namespace || 'my-team';
-  return `# CLAUDE.md — ${team}
+  let base = `# CLAUDE.md — ${team}
 
 Team: ${team} | Local-first orchestration via \`.aw_docs/\` | MCPs: \`memory/*\` (shared knowledge), \`git-jenkins\` (CI/CD), \`grafana\` (observability)
 
@@ -231,11 +258,17 @@ Gates are shell scripts in \`scripts/gates/\` — CANNOT be bypassed by LLM judg
 - **Agents**: Definitions ≤5 KB, reference material in linked skills
 - **Local-first**: No MCP calls for orchestration — file reads are faster and always available
 `;
+
+  if (rulesSections.claudeSection) {
+    base += '\n' + rulesSections.claudeSection;
+  }
+
+  return base;
 }
 
-function generateAgentsMd(cwd, namespace) {
+function generateAgentsMd(cwd, namespace, rulesSections = {}) {
   const team = namespace || 'my-team';
-  return `# AGENTS.md — ${team}
+  let base = `# AGENTS.md — ${team}
 
 ## Agent System
 
@@ -367,6 +400,12 @@ Each agent has quality test cases in \`.claude/evals/\`:
 
 Run with: \`/platform:eval agent:<slug>\` or \`/platform:eval skill:<slug>\`
 `;
+
+  if (rulesSections.agentsSection) {
+    base += '\n' + rulesSections.agentsSection;
+  }
+
+  return base;
 }
 
 /**
@@ -450,4 +489,3 @@ function getTeamNamespaces(awDir) {
       .map(p => p.split('/')[0]),
   )];
 }
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.37-beta.8",
+  "version": "0.1.37",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": "bin.js",
@@ -20,10 +20,13 @@
     "paths.mjs",
     "plan.mjs",
     "registry.mjs",
+    "slack-sim/",
+    "file-tree.mjs",
     "apply.mjs",
     "update.mjs",
     "hooks.mjs",
     "ecc.mjs",
+    "render-rules.mjs",
     "telemetry.mjs"
   ],
   "engines": {
@@ -39,8 +42,10 @@
   "author": "GoHighLevel",
   "license": "MIT",
   "scripts": {
-    "test": "vitest run --reporter=verbose",
-    "test:watch": "vitest --reporter=verbose",
+    "test": "yarn test:vitest && yarn test:node",
+    "test:vitest": "vitest run --reporter=verbose tests/commands tests/mcp.test.mjs tests/telemetry.test.mjs",
+    "test:node": "node tests/run-node-tests.mjs",
+    "test:watch": "vitest --reporter=verbose tests/commands tests/mcp.test.mjs tests/telemetry.test.mjs",
     "preuninstall": "node bin.js nuke 2>/dev/null || true"
   },
   "publishConfig": {
@@ -49,7 +54,8 @@
   "dependencies": {
     "@clack/prompts": "0.8.2",
     "chalk": "^5.6.2",
-    "figlet": "^1.11.0"
+    "figlet": "^1.11.0",
+    "pg": "^8.13.0"
   },
   "devDependencies": {
     "vitest": "^4.1.2"