azcodr 1.0.0 → 1.1.0

package/lib/index.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Enterprise Multi-Tenant Architecture & Agentic Engineering Starter Template
+ * Programmatic API Definitions
+ */
+
+export interface ScaffoldOptions {
+  /** Target directory path where template should be scaffolded (default: process.cwd()) */
+  targetDir?: string;
+  /** Force overwrite if target directory is non-empty (default: false) */
+  force?: boolean;
+  /** Skip git repository initialization (default: false) */
+  noGit?: boolean;
+  /** Custom template root directory (default: azcodr root) */
+  templateDir?: string;
+  /** Simulate scaffolding without writing files or running git (default: false) */
+  dryRun?: boolean;
+  /** Suppress console output messages (default: false) */
+  silent?: boolean;
+}
+
+export interface ScaffoldResult {
+  /** Whether the scaffolding succeeded */
+  success: boolean;
+  /** Absolute resolved path of the target directory */
+  targetDir: string;
+  /** Whether git init was successfully executed */
+  gitInitialized: boolean;
+  /** Whether execution ran in dry-run simulation mode */
+  dryRun: boolean;
+  /** List of files, directories, and symlinks created or simulated */
+  actions: string[];
+}
+
+export interface LogChangeOptions {
+  /** Short title describing the architectural change */
+  title: string;
+  /** Category of change (Architecture | Rule | Skill | Infrastructure | CLI | Knowledge Hub) */
+  category?: string;
+  /** Target file(s) affected by the change */
+  targetFiles?: string;
+  /** Architectural rationale for upstream template incorporation */
+  rationale?: string;
+  /** Detailed description of the change */
+  description?: string;
+  /** Working directory containing changes.md (default: process.cwd()) */
+  targetDir?: string;
+}
+
+export interface LogChangeResult {
+  /** Whether the log entry was successfully recorded */
+  success: boolean;
+  /** Absolute path to changes.md */
+  filePath: string;
+  /** Markdown entry text that was appended */
+  entry: string;
+}
+
+export interface ValidateTargetOptions {
+  /** Custom template root directory */
+  templateDir?: string;
+  /** Force allow non-empty directory */
+  force?: boolean;
+}
+
+export interface InitGitOptions {
+  /** If true, skips git initialization */
+  noGit?: boolean;
+  /** If true, simulates git initialization without executing */
+  dryRun?: boolean;
+}
+
+export interface CopyTemplateOptions {
+  /** If true, simulates copy without writing to disk */
+  dryRun?: boolean;
+}
+
+/**
+ * High-level orchestration function to scaffold the azcodr workspace into targetDir.
+ */
+export function scaffold(options?: ScaffoldOptions): ScaffoldResult;
+
+/**
+ * Appends a standardized upstream change entry to changes.md.
+ */
+export function logChange(options: LogChangeOptions): LogChangeResult;
+
+/**
+ * Validates the target directory to ensure it is suitable for scaffolding.
+ */
+export function validateTarget(targetDir: string, options?: ValidateTargetOptions): void;
+
+/**
+ * Copies template items into target directory and sets up symlinks and permissions.
+ */
+export function copyTemplate(
+  targetDir: string,
+  templateDir?: string,
+  options?: CopyTemplateOptions
+): string[];
+
+/**
+ * Safely creates or updates a symbolic link, falling back to a file copy if symlinks are unsupported.
+ */
+export function ensureSymlink(
+  targetDir: string,
+  linkName: string,
+  targetFileName: string,
+  dryRun?: boolean
+): boolean;
+
+/**
+ * Detects whether linkName and targetFileName refer to the same entry on a case-insensitive filesystem.
+ */
+export function isSameCaseInsensitiveFile(
+  targetDir: string,
+  linkName: string,
+  targetFileName: string
+): boolean;
+
+/**
+ * Ensures all bash scripts in skill directories have executable permissions (0o755).
+ */
+export function makeScriptsExecutable(targetDir: string, dryRun?: boolean): string[];
+
+/**
+ * Initializes a git repository in the target directory if not already inside one.
+ */
+export function initGit(targetDir: string, options?: InitGitOptions): boolean;
+
+/**
+ * Returns the root path to the azcodr template files.
+ */
+export function getTemplateDir(): string;
+
+/**
+ * Array of essential template files and directories copied during scaffolding.
+ */
+export const TEMPLATE_ITEMS: readonly string[];
+
+declare const defaultExport: {
+  scaffold: typeof scaffold;
+  logChange: typeof logChange;
+  validateTarget: typeof validateTarget;
+  copyTemplate: typeof copyTemplate;
+  ensureSymlink: typeof ensureSymlink;
+  isSameCaseInsensitiveFile: typeof isSameCaseInsensitiveFile;
+  makeScriptsExecutable: typeof makeScriptsExecutable;
+  initGit: typeof initGit;
+  getTemplateDir: typeof getTemplateDir;
+  TEMPLATE_ITEMS: typeof TEMPLATE_ITEMS;
+};
+
+export default defaultExport;

package/lib/scaffold.js

@@ -2,15 +2,17 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { execSync } = require('node:child_process');
+const cp = require('node:child_process');
 
 const TEMPLATE_ITEMS = [
   'AGENTS.md',
   'memory.md',
+  'changes.md',
   'README.md',
   'docs',
   '.agents',
-  '.gitignore'
+  '.gitignore',
+  '.editorconfig'
 ];
 
 /**
@@ -24,7 +26,7 @@ function getTemplateDir() {
  * Validates the target directory to ensure it is suitable for scaffolding.
  */
 function validateTarget(targetDir, options = {}) {
-  const { templateDir = getTemplateDir(), force = false } = options;
+  const { templateDir = getTemplateDir(), force = false, dryRun = false } = options;
   const resolvedTarget = path.resolve(targetDir);
   const resolvedTemplate = path.resolve(templateDir);
 
@@ -33,7 +35,9 @@ function validateTarget(targetDir, options = {}) {
   }
 
   if (!fs.existsSync(resolvedTarget)) {
-    fs.mkdirSync(resolvedTarget, { recursive: true });
+    if (!dryRun) {
+      fs.mkdirSync(resolvedTarget, { recursive: true });
+    }
     return;
   }
 
@@ -46,10 +50,35 @@ function validateTarget(targetDir, options = {}) {
   }
 }
 
+/**
+ * Detects whether linkName and targetFileName refer to the same entry on a case-insensitive filesystem.
+ */
+function isSameCaseInsensitiveFile(targetDir, linkName, targetFileName) {
+  if (linkName.toLowerCase() !== targetFileName.toLowerCase()) {
+    return false;
+  }
+  const targetPath = path.join(targetDir, targetFileName);
+  const linkPath = path.join(targetDir, linkName);
+  try {
+    if (fs.existsSync(targetPath) && fs.existsSync(linkPath)) {
+      return !fs.lstatSync(linkPath).isSymbolicLink();
+    }
+  } catch {
+    return false;
+  }
+  return false;
+}
+
 /**
  * Safely creates or updates a symbolic link, falling back to a file copy if symlinks are unsupported.
  */
-function ensureSymlink(targetDir, linkName, targetFileName) {
+function ensureSymlink(targetDir, linkName, targetFileName, dryRun = false) {
+  if (dryRun) return true;
+
+  if (isSameCaseInsensitiveFile(targetDir, linkName, targetFileName)) {
+    return true;
+  }
+
   const linkPath = path.join(targetDir, linkName);
   try {
     const stat = fs.lstatSync(linkPath);
@@ -62,21 +91,24 @@ function ensureSymlink(targetDir, linkName, targetFileName) {
 
   try {
     fs.symlinkSync(targetFileName, linkPath);
+    return true;
   } catch {
     // Fallback if environment (e.g., certain Windows configs) prevents symlink creation
     const sourceFile = path.join(targetDir, targetFileName);
     if (fs.existsSync(sourceFile)) {
       fs.copyFileSync(sourceFile, linkPath);
     }
+    return true;
   }
 }
 
 /**
  * Ensures all bash scripts in skill directories have executable permissions (0o755).
  */
-function makeScriptsExecutable(targetDir) {
+function makeScriptsExecutable(targetDir, dryRun = false) {
+  const modified = [];
   const skillsDir = path.join(targetDir, '.agents', 'skills');
-  if (!fs.existsSync(skillsDir)) return;
+  if (!fs.existsSync(skillsDir)) return modified;
 
   const skills = fs.readdirSync(skillsDir);
   for (const skill of skills) {
@@ -86,25 +118,31 @@ function makeScriptsExecutable(targetDir) {
       for (const file of files) {
         if (file.endsWith('.sh')) {
           const filePath = path.join(scriptsDir, file);
-          try {
-            fs.chmodSync(filePath, 0o755);
-          } catch {
-            // Non-critical if filesystem does not support POSIX permissions
+          modified.push(filePath);
+          if (!dryRun) {
+            try {
+              fs.chmodSync(filePath, 0o755);
+            } catch {
+              // Non-critical if filesystem does not support POSIX permissions
+            }
           }
         }
       }
     }
   }
+  return modified;
 }
 
 /**
  * Recursively copies template files into the target directory and sets up symlinks and permissions.
  */
-function copyTemplate(targetDir, templateDir = getTemplateDir()) {
+function copyTemplate(targetDir, templateDir = getTemplateDir(), options = {}) {
+  const { dryRun = false } = options;
   const resolvedTarget = path.resolve(targetDir);
   const resolvedTemplate = path.resolve(templateDir);
+  const actions = [];
 
-  if (!fs.existsSync(resolvedTarget)) {
+  if (!dryRun && !fs.existsSync(resolvedTarget)) {
     fs.mkdirSync(resolvedTarget, { recursive: true });
   }
 
@@ -113,29 +151,46 @@ function copyTemplate(targetDir, templateDir = getTemplateDir()) {
     if (!fs.existsSync(srcPath)) continue;
 
     const destPath = path.join(resolvedTarget, item);
-    fs.cpSync(srcPath, destPath, { recursive: true, force: true, dereference: false });
+    actions.push(`copy: ${item} -> ${destPath}`);
+
+    if (!dryRun) {
+      fs.cpSync(srcPath, destPath, { recursive: true, force: true, dereference: false });
+    }
   }
 
   // Ensure harness parity symlinks per AGENTS.md mandate
-  ensureSymlink(resolvedTarget, 'CLAUDE.md', 'AGENTS.md');
-  ensureSymlink(resolvedTarget, 'agents.md', 'AGENTS.md');
+  actions.push(`symlink: CLAUDE.md -> AGENTS.md`);
+  ensureSymlink(resolvedTarget, 'CLAUDE.md', 'AGENTS.md', dryRun);
+
+  actions.push(`symlink: agents.md -> AGENTS.md`);
+  ensureSymlink(resolvedTarget, 'agents.md', 'AGENTS.md', dryRun);
 
   // Ensure scripts are executable
-  makeScriptsExecutable(resolvedTarget);
+  const inspectDir = dryRun ? resolvedTemplate : resolvedTarget;
+  const scripts = makeScriptsExecutable(inspectDir, dryRun);
+  for (const script of scripts) {
+    actions.push(`chmod: +x ${path.relative(inspectDir, script)}`);
+  }
+
+  return actions;
 }
 
 /**
  * Initializes a git repository in the target directory if not already inside one.
  */
 function initGit(targetDir, options = {}) {
-  const { noGit = false } = options;
+  const { noGit = false, dryRun = false } = options;
   if (noGit) return false;
 
   const gitDir = path.join(targetDir, '.git');
   if (fs.existsSync(gitDir)) return false;
 
+  if (dryRun) {
+    return true;
+  }
+
   try {
-    execSync('git init -q', { cwd: targetDir, stdio: 'ignore' });
+    cp.execSync('git init -q', { cwd: targetDir, stdio: 'ignore' });
     return true;
   } catch {
     return false;
@@ -150,26 +205,79 @@ function scaffold(options = {}) {
     targetDir = process.cwd(),
     force = false,
     noGit = false,
-    templateDir = getTemplateDir()
+    templateDir = getTemplateDir(),
+    dryRun = false,
+    silent = false
   } = options;
 
   const resolvedTarget = path.resolve(targetDir);
-  validateTarget(resolvedTarget, { templateDir, force });
-  copyTemplate(resolvedTarget, templateDir);
-  const gitInitialized = initGit(resolvedTarget, { noGit });
+  validateTarget(resolvedTarget, { templateDir, force, dryRun });
+  const actions = copyTemplate(resolvedTarget, templateDir, { dryRun });
+  const gitInitialized = initGit(resolvedTarget, { noGit, dryRun });
+  if (gitInitialized) {
+    actions.push('git: initialize repository');
+  }
 
   return {
     success: true,
     targetDir: resolvedTarget,
-    gitInitialized
+    gitInitialized,
+    dryRun,
+    actions
+  };
+}
+
+/**
+ * Appends a standardized upstream change entry to changes.md.
+ */
+function logChange(options = {}) {
+  const {
+    title,
+    category = 'Architecture',
+    targetFiles = 'docs/rules/',
+    rationale = 'Generic architectural enhancement',
+    description = '',
+    targetDir = process.cwd()
+  } = options;
+
+  if (!title || typeof title !== 'string' || !title.trim()) {
+    throw new Error('A change title is required to log an upstream change.');
+  }
+
+  const cleanTitle = title.trim();
+  const changesFilePath = path.join(path.resolve(targetDir), 'changes.md');
+  const today = new Date().toISOString().slice(0, 10);
+
+  const entry = `\n### [${today}] ${cleanTitle}\n` +
+    `- **Category:** ${category}\n` +
+    `- **Target File(s):** ${targetFiles}\n` +
+    `- **Rationale:** ${rationale}\n` +
+    `- **Description:** ${description || cleanTitle}\n` +
+    `- **Domain Filter Verification:** Verified 100% generic; purged of all project-specific business entities and models.\n`;
+
+  if (fs.existsSync(changesFilePath)) {
+    fs.appendFileSync(changesFilePath, entry, 'utf-8');
+  } else {
+    const initialHeader = `# Upstream Changes Ledger (\`changes.md\`)\n\n` +
+      `> **Core Purpose:** Record candidate improvements, generic architectural updates, defect post-mortems, and rule enhancements discovered in this workspace that should be incorporated into the upstream \`azcodr\` baseline template.\n\n` +
+      `---\n\n## Upstream Changes Log\n`;
+    fs.writeFileSync(changesFilePath, initialHeader + entry, 'utf-8');
+  }
+
+  return {
+    success: true,
+    filePath: changesFilePath,
+    entry
   };
 }
 
 module.exports = {
   scaffold,
+  logChange,
   validateTarget,
   copyTemplate,
   ensureSymlink,
+  isSameCaseInsensitiveFile,
   makeScriptsExecutable,
   initGit,
   getTemplateDir,

package/package.json

@@ -1,20 +1,30 @@
 {
   "name": "azcodr",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Enterprise Multi-Tenant Architecture & Agentic Engineering Starter Template",
   "bin": {
     "azcodr": "bin/azcodr.js"
   },
   "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "bin",
     "lib",
     "AGENTS.md",
     "memory.md",
+    "changes.md",
     "README.md",
     "docs",
     ".agents",
     ".gitignore",
+    ".editorconfig",
     "LICENSE"
   ],
   "keywords": [
@@ -41,9 +51,10 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "node --test tests/**/*.test.js",
-    "test:coverage": "node --test --experimental-test-coverage tests/**/*.test.js",
+    "test": "node --test",
+    "test:coverage": "node scripts/test_coverage.js",
+    "lint": "node --check bin/azcodr.js lib/index.js lib/scaffold.js tests/cli.test.js tests/scaffold.test.js scripts/test_coverage.js",
     "validate": "bash .agents/skills/agentic-architect/scripts/validate_agentic_configs.sh",
-    "prepublishOnly": "npm test && npm run validate"
+    "prepublishOnly": "npm run test:coverage && npm run validate"
   }
 }

package/.agents/skills/merge-ai/SKILL.md

@@ -1,90 +0,0 @@
----
-name: merge-ai
-description: Use when the user invokes /merge-ai or asks to merge generic AI rules, skills, lessons learned, and post-mortems from the current workspace back into the generic azcodr baseline repository. Do not use for merging application business logic or routine Git branches.
----
-
-# Merge AI Knowledge, Rules & Skills Skill (`/merge-ai`)
-
-> **Core Philosophy:** Upstream baseline repositories (e.g. `https://github.com/org/azcodr`) must remain pristine, generic, and untouched until the user explicitly triggers `/merge-ai`. When triggered from any project workspace (e.g. `https://github.com/org/my-project`), detect if the baseline repo is already cloned locally (apply directly) or clone it first, purge all project-specific domain models, colocate DOs and DONTs into atomic rules, and synchronize the generic baseline.
-
----
-
-## 1. When to Use This Skill
-- The user issues `/merge-ai` or requests syncing AI rules, skills, issue logs, and lessons learned back into the generic baseline repository.
-- User references repository URLs (e.g. Source: `https://github.com/org/my-project`, Target: `https://github.com/org/azcodr`).
-- Auditing divergences between the current project workspace and the generic baseline repository.
-- Exporting newly discovered architectural patterns, defect post-mortems, or reusable skills to the generic starter.
-- **DO NOT USE** during routine project feature development or bug fixes.
-- **DO NOT USE** to merge application domain entities, business logic, or project-specific data models.
-- **DO NOT USE** without explicit user invocation.
-
----
-
-## 2. Step-by-Step Execution Workflow
-
-### Phase 1: Target Baseline Repository Resolution (URL or Local)
-When `/merge-ai` is triggered with repository URLs (e.g. `/merge-ai https://github.com/org/my-project https://github.com/org/azcodr`):
-1. **Execute Repo Resolver Script:**
-   ```bash
-   # Discovers existing local clone or automatically clones fresh
-   eval $(bash .agents/skills/merge-ai/scripts/resolve_repo.sh "$TARGET_REPO_URL")
-   ```
-   - **If already cloned locally:** Discovers its directory, verifies clean working tree, and exports `STATUS=ALREADY_CLONED` and `LOCAL_PATH` (e.g. `/path/to/azcodr`).
-   - **If not cloned locally:** Automatically executes `git clone "$TARGET_REPO_URL"` to `$HOME/projects/<name>` and exports `STATUS=CLONED_FRESH` and `LOCAL_PATH`.
-2. Set `$BASELINE_DIR="$LOCAL_PATH"`.
-3. If `STATUS=ALREADY_CLONED`, ensure the repository is on branch `main` (`git -C "$BASELINE_DIR" pull --ff-only`).
-
----
-
-### Phase 2: Divergence Audit & Domain Purging
-1. Run the divergence audit script:
-   ```bash
-   bash .agents/skills/merge-ai/scripts/audit_divergence.sh "$BASELINE_DIR"
-   ```
-2. Systematically filter out all project-specific elements before proposing changes:
-   - **Purge Business Domain Entities:** Replace project-specific nouns with universal architectural archetypes (`Entity`, `Aggregate`, `ValueObject`, `Resource`, `Transaction`).
-   - **Purge Concrete Stack Specifics:** Keep core rules stack-agnostic (Hexagonal Ports, abstract repositories). Keep project-specific setups (e.g. SQLite dev / Postgres prod, React Vite client) in the project workspace.
-   - **Colocate DOs & DONTs into Atomic Rules:** Embed DOs and DONTs directly inside their governing atomic rule files in `docs/rules/` (`## Invariants, DO's & DONT's`). Keep `docs/knowledge/dos_and_donts.md` strictly as a clean cross-reference index directory.
-   - **Transform ADRs & Post-Mortems:** Port universal decisions (ADR-007 CRUD & Selectors, ADR-008 Bootstrapping Decoupling, ADR-009 Agile Domain TDD, ADR-010 M:N Skill Composability) as generic ADRs in `memory.md`. Port universal post-mortems (`ISSUE-004`, `ISSUE-005`) into `issue_log.md` and `lessons_learned.md`.
-
----
-
-### Phase 3: Dry-Run Review & Explicit User Confirmation
-1. Present a concise, structured dry-run report to the user summarizing:
-   - Target baseline repo URL and resolved local directory (`$BASELINE_DIR`).
-   - Generic rules, skills, post-mortems, and ADRs to be merged.
-   - Domain-specific elements purged.
-2. **STOP AND ASK FOR EXPLICIT CONFIRMATION** before modifying `$BASELINE_DIR`.
-
----
-
-### Phase 4: Apply Merge, Validate & Sync
-Upon user confirmation:
-1. Apply the generic updates to `$BASELINE_DIR`:
-   - `AGENTS.md` (Unified Agent Cognitive & Agile Domain Lifecycle).
-   - `docs/rules/` (Updated atomic rules with colocated DOs/DONTs).
-   - `.agents/skills/` (Updated generic skills, e.g. decoupled `lets-build`).
-   - `docs/knowledge/` (Index-only `dos_and_donts.md`, generic post-mortems in `issue_log.md`, `lessons_learned.md`, `knowledge_graph.md`).
-   - `memory.md` (Generic ADRs).
-2. Validate agentic configuration integrity in the baseline:
-   ```bash
-   bash "$BASELINE_DIR/.agents/skills/agentic-architect/scripts/validate_agentic_configs.sh"
-   ```
-   *Requirement: 0 warnings, AGENTS.md <= 120 lines, valid symlinks.*
-3. Commit and push the baseline repository to remote:
-   ```bash
-   git -C "$BASELINE_DIR" add -A
-   git -C "$BASELINE_DIR" commit -m "feat(ai-sync): merge generic rules, skills, and lifecycle improvements from workspace"
-   git -C "$BASELINE_DIR" push origin main
-   ```
-4. Confirm successful synchronization with the remote generic baseline URL.
-
----
-
-## 3. Gotchas & What NOT to Do
-
-- **MAJOR DONT: Never touch, edit, or commit to the baseline repository (`azcodr`) during routine feature development.** The baseline must be left completely alone until `/merge-ai` is explicitly invoked.
-- **DO NOT** copy application domain models, database tables, or framework-specific configs to the baseline.
-- **DO NOT** create monolithic DO/DONT lists. Always colocate directives in atomic rules.
-- **DO NOT** execute the merge without presenting a dry-run summary and receiving explicit approval.
-- **DO NOT** push to the baseline repository if `validate_agentic_configs.sh` fails or reports warnings.

package/.agents/skills/merge-ai/scripts/audit_divergence.sh

@@ -1,108 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-BASELINE_DIR="${1:-/home/prosubodh/projects/azcodr}"
-CURRENT_DIR="$(pwd)"
-
-echo "=================================================================="
-echo "🔍 Auditing AI Knowledge & Rule Divergence"
-echo "Current Workspace: $CURRENT_DIR"
-echo "Baseline Template: $BASELINE_DIR"
-echo "=================================================================="
-
-if [ ! -d "$BASELINE_DIR" ]; then
-  echo "❌ Error: Baseline directory '$BASELINE_DIR' does not exist."
-  exit 1
-fi
-
-echo ""
-echo "--- 1. Checking Core Directives (AGENTS.md) ---"
-if diff -q "$CURRENT_DIR/AGENTS.md" "$BASELINE_DIR/AGENTS.md" > /dev/null 2>&1; then
-  echo "✅ AGENTS.md is identical."
-else
-  echo "⚠️ AGENTS.md differs between workspaces."
-fi
-
-echo ""
-echo "--- 2. Checking Atomic Rules (docs/rules/) ---"
-DIFF_RULES=$(diff -qr "$CURRENT_DIR/docs/rules" "$BASELINE_DIR/docs/rules" 2>/dev/null || true)
-if [ -z "$DIFF_RULES" ]; then
-  echo "✅ All atomic rules in docs/rules/ are identical."
-else
-  echo "$DIFF_RULES"
-fi
-
-echo ""
-echo "--- 3. Checking Specialized Skills (.agents/skills/) ---"
-DIFF_SKILLS=$(diff -qr "$CURRENT_DIR/.agents/skills" "$BASELINE_DIR/.agents/skills" 2>/dev/null || true)
-if [ -z "$DIFF_SKILLS" ]; then
-  echo "✅ All skills in .agents/skills/ are identical."
-else
-  echo "$DIFF_SKILLS"
-fi
-
-echo ""
-echo "--- 4. Checking Knowledge Hub (docs/knowledge/) ---"
-DIFF_KNOW=$(diff -qr "$CURRENT_DIR/docs/knowledge" "$BASELINE_DIR/docs/knowledge" 2>/dev/null || true)
-if [ -z "$DIFF_KNOW" ]; then
-  echo "✅ All knowledge files in docs/knowledge/ are identical."
-else
-  echo "$DIFF_KNOW"
-fi
-
-echo ""
-echo "--- 5. Checking Architecture Decision Records (memory.md) ---"
-if [ -f "$CURRENT_DIR/memory.md" ] && [ -f "$BASELINE_DIR/memory.md" ]; then
-  mapfile -t BASELINE_ADRS < <(grep -E '^### ADR-[0-9]+:' "$BASELINE_DIR/memory.md" 2>/dev/null | sed -E 's/^### ADR-[0-9]+:[[:space:]]*//' || true)
-  mapfile -t CURRENT_ADRS < <(grep -E '^### ADR-[0-9]+:' "$CURRENT_DIR/memory.md" 2>/dev/null | sed -E 's/^### ADR-[0-9]+:[[:space:]]*//' || true)
-
-  MISSING_IN_CURRENT=()
-  for b_adr in "${BASELINE_ADRS[@]}"; do
-    [ -z "$b_adr" ] && continue
-    found=false
-    for c_adr in "${CURRENT_ADRS[@]}"; do
-      if [ "$b_adr" = "$c_adr" ]; then
-        found=true
-        break
-      fi
-    done
-    if [ "$found" = false ]; then
-      MISSING_IN_CURRENT+=("$b_adr")
-    fi
-  done
-
-  EXTRA_IN_CURRENT=()
-  for c_adr in "${CURRENT_ADRS[@]}"; do
-    [ -z "$c_adr" ] && continue
-    found=false
-    for b_adr in "${BASELINE_ADRS[@]}"; do
-      if [ "$c_adr" = "$b_adr" ]; then
-        found=true
-        break
-      fi
-    done
-    if [ "$found" = false ]; then
-      EXTRA_IN_CURRENT+=("$c_adr")
-    fi
-  done
-
-  if [ ${#MISSING_IN_CURRENT[@]} -gt 0 ]; then
-    echo "⚠️ Workspace is missing ${#MISSING_IN_CURRENT[@]} baseline ADR(s):"
-    for m in "${MISSING_IN_CURRENT[@]}"; do
-      echo "   - $m"
-    done
-  elif [ ${#EXTRA_IN_CURRENT[@]} -eq 0 ]; then
-    echo "✅ memory.md ADRs are 100% identical."
-  else
-    echo "✅ All generic baseline ADRs are synchronized."
-    for e in "${EXTRA_IN_CURRENT[@]}"; do
-      echo "   ℹ️ Project-specific ADR retained in workspace: $e"
-    done
-  fi
-else
-  echo "⚠️ memory.md not found in one or both workspaces."
-fi
-
-echo "=================================================================="
-echo "Audit complete. Run /merge-ai to filter and merge generic changes."
-echo "=================================================================="