@whitehatd/crag 0.2.7 → 0.2.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitehatd/crag",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "The bedrock layer for AI coding agents. One governance.md. Any project. Never stale.",
   "bin": {
     "crag": "bin/crag.js"

package/src/commands/doctor.js

@@ -21,7 +21,7 @@
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
-const { parseGovernance, flattenGates } = require('../governance/parse');
+const { parseGovernance, flattenGates, extractSection } = require('../governance/parse');
 const { isModified, readFrontmatter } = require('../update/integrity');
 const { EXIT_USER, EXIT_INTERNAL } = require('../cli-errors');
 
@@ -381,6 +381,68 @@ function diagnoseHooks(cwd) {
 // Section: Drift (reuses crag diff logic)
 // ============================================================================
 
+/**
+ * Detect the branch strategy declared in a governance.md document.
+ *
+ * Scopes the text scan to the `## Branch Strategy` section (avoiding false
+ * matches against unrelated prose). Within that section, the FIRST keyword
+ * to appear wins — this matches human reading order where the opening
+ * statement is the rule and later lines are qualifications.
+ *
+ * Returns 'feature-branches', 'trunk-based', or null.
+ *
+ * Exported for unit testing.
+ */
+function detectBranchStrategy(content) {
+  if (typeof content !== 'string' || content.length === 0) return null;
+  const section = extractSection(content, 'Branch Strategy');
+  const scope = section || content; // fall back to whole file if section absent
+  const featureIdx = scope.search(/[Ff]eature branches/);
+  const trunkIdx = scope.search(/[Tt]runk-based/);
+  if (featureIdx === -1 && trunkIdx === -1) return null;
+  if (featureIdx === -1) return 'trunk-based';
+  if (trunkIdx === -1) return 'feature-branches';
+  return featureIdx < trunkIdx ? 'feature-branches' : 'trunk-based';
+}
+
+/**
+ * Given the raw output of `git branch -a --format="%(refname:short)"`, return
+ * the list of unique feature branches (by short name, after stripping any
+ * remote prefix).
+ *
+ * This is the piece that decides whether a repo is practicing feature-branch
+ * development. A repo whose LOCAL branches have all been merged+deleted but
+ * whose REMOTE still has open feat/* branches is absolutely still practicing
+ * feature-branch development — so we count remote-tracking refs as equivalent
+ * to local branches, and we dedupe.
+ *
+ * Exported for unit testing — avoids the need to set up a real git fixture.
+ */
+const FEATURE_PREFIXES = ['feat', 'fix', 'docs', 'chore', 'feature', 'hotfix'];
+
+function countFeatureBranches(gitBranchOutput) {
+  if (typeof gitBranchOutput !== 'string' || gitBranchOutput.length === 0) {
+    return [];
+  }
+  const rawList = gitBranchOutput
+    .split('\n')
+    .map(b => b.trim())
+    .filter(Boolean)
+    // Skip symbolic refs like "origin/HEAD" (no payload branch underneath).
+    .filter(b => !b.endsWith('/HEAD'));
+
+  const prefixGroup = FEATURE_PREFIXES.join('|');
+  const remoteStripRe = new RegExp(`^[A-Za-z0-9_.-]+/((?:${prefixGroup})/.+)$`);
+  const featureRe = new RegExp(`^(${prefixGroup})/`);
+
+  const normalized = rawList.map(b => {
+    const m = b.match(remoteStripRe);
+    return m ? m[1] : b;
+  });
+  const unique = [...new Set(normalized)];
+  return unique.filter(b => featureRe.test(b));
+}
+
 function diagnoseDrift(cwd) {
   const checks = [];
   const govPath = path.join(cwd, '.claude', 'governance.md');
@@ -390,20 +452,19 @@ function diagnoseDrift(cwd) {
 
   const content = fs.readFileSync(govPath, 'utf-8');
 
-  // Branch strategy alignment
-  const govBranchStrategy = content.includes('Feature branches') || content.includes('feature branches')
-    ? 'feature-branches'
-    : content.includes('Trunk-based') || content.includes('trunk-based')
-    ? 'trunk-based'
-    : null;
+  // Branch strategy alignment — detect from the `## Branch Strategy` section
+  // rather than the whole file so unrelated prose ("feature branches in each
+  // sub-repo") doesn't override a workspace wrapper's actual trunk-based
+  // policy. Within that section, the FIRST keyword to appear wins: this
+  // matches the human reading order where the opening bullet states the rule.
+  const govBranchStrategy = detectBranchStrategy(content);
 
   if (govBranchStrategy) {
     try {
       const branches = execSync('git branch -a --format="%(refname:short)"', {
         cwd, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'],
       });
-      const list = branches.trim().split('\n');
-      const featureBranches = list.filter(b => /^(feat|fix|docs|chore|feature|hotfix)\//.test(b));
+      const featureBranches = countFeatureBranches(branches);
       const actualStrategy = featureBranches.length > 2 ? 'feature-branches' : 'trunk-based';
 
       checks.push({
@@ -583,4 +644,4 @@ function printReport(report, { ciMode = false, strict = false } = {}) {
   }
 }
 
-module.exports = { doctor, runDiagnostics };
+module.exports = { doctor, runDiagnostics, countFeatureBranches, detectBranchStrategy };

package/src/governance/parse.js

@@ -107,8 +107,40 @@ function parseGovernance(content) {
   if (gatesBody) {
     let section = 'default';
     let sectionMeta = { path: null, condition: null };
+    // Fenced code blocks (```bash / ```sh / ```shell) are treated as an
+    // alternative command carrier: every non-blank, non-comment line inside
+    // is extracted as a MANDATORY command for the current section. This
+    // matches the very common markdown pattern of documenting gate commands
+    // in a bash fence instead of a bullet list.
+    let inCodeBlock = false;
 
     for (const line of gatesBody.split('\n')) {
+      // Fence toggle. Accepts ``` , ```bash , ```sh , ```shell (and any other
+      // language tag) — we treat all fenced blocks inside ## Gates as gate
+      // command carriers. A non-shell language tag would be unusual here.
+      if (/^\s*```/.test(line)) {
+        inCodeBlock = !inCodeBlock;
+        continue;
+      }
+
+      if (inCodeBlock) {
+        const cmd = line.trim();
+        // Skip blanks and pure comments. Do NOT strip inline comments from
+        // the tail of a command — shell parsers treat `#` mid-line as a
+        // comment only when preceded by whitespace, and losing the rest of
+        // the line could silently drop logic like `echo "# header"`.
+        if (!cmd || cmd.startsWith('#')) continue;
+        if (!result.gates[section]) {
+          result.gates[section] = {
+            commands: [],
+            path: sectionMeta.path,
+            condition: sectionMeta.condition,
+          };
+        }
+        result.gates[section].commands.push({ cmd, classification: 'MANDATORY' });
+        continue;
+      }
+
       // Match ### Section or ### Section (path: dir/) or ### Section (if: file)
       const sub = line.match(/^### (.+?)(?:\s*\((?:(path|if):\s*(.+?))\))?\s*$/);
       if (sub) {

package/src/skills/post-start-validation.md

@@ -1,6 +1,6 @@
 ---
 name: post-start-validation
-version: 0.2.2
+version: 0.2.9
 source_hash: 5a64dfe68b13577dff818fa63ddb6185be360c80b100f205bc586aac39e19e80
 description: Universal validation and knowledge capture. Detects what changed, runs governance gates, captures knowledge, verifies deployment. Works for any project.
 ---

package/src/skills/pre-start-context.md

@@ -1,7 +1,7 @@
 ---
 name: pre-start-context
-version: 0.2.2
-source_hash: b7be8434b99d5b189c904263e783d573c82109218725cc31fbd4fa1bf81538b6
+version: 0.2.9
+source_hash: 4ace3388804f528a7e7a446466a506ca5f0da4c23e42b540b9ae8923eaf35e4e
 description: Universal context loader. Discovers any project's stack, architecture, and state at runtime. Reads governance.md for project-specific rules. Works for any language, framework, or deployment target.
 ---
 
@@ -54,17 +54,20 @@ Detect OS and shell. Use appropriate syntax (Unix forward slashes if Git Bash on
 
 ## 0.05. Skill Currency Check
 
-Check installed skill version:
+Check whether installed skills are behind the crag CLI:
 
+// turbo
 ```
-Read .claude/skills/pre-start-context/SKILL.md
+crag upgrade --check
 ```
 
-If the file has a `version:` frontmatter field, compare it to the expected version (0.2.0). If outdated:
-- Report: `"Pre-start skill vX.Y.Z is outdated (v0.2.0 available). Run: crag upgrade"`
-- Continue with current version — never block startup.
+If the output lists any skill as needing an upgrade (e.g. `0.2.x → 0.2.y`):
+- Report: `"Skills outdated — run: crag upgrade"`
+- Continue with the current version — never block startup.
 
-> This check costs one Read call. If skills are current, no action needed.
+> This check uses `crag upgrade --check` so the skill never has to hard-code
+> its own version number; it asks the CLI, which is always in lockstep with
+> the package. If `crag` is not on PATH (bare CI runner), skip silently.
 
 ---