godpowers 2.4.1 → 2.4.3

package/lib/recipes.js

@@ -8,13 +8,17 @@
 
 const fs = require('fs');
 const path = require('path');
-const { parseSimpleYaml } = require('./intent');
+const { parseSimpleYaml, formatDiagnostic } = require('./intent');
 const state = require('./state');
 
 const RECIPES_DIR = path.join(__dirname, '..', 'routing', 'recipes');
 
 let _cache = null;
 
+function warnYamlDiagnostic(diagnostic) {
+  console.warn(`[godpowers] YAML warning ${formatDiagnostic(diagnostic)}`);
+}
+
 /**
  * Load all recipe definitions.
  */
@@ -26,7 +30,11 @@ function loadAll() {
   for (const file of fs.readdirSync(RECIPES_DIR)) {
     if (!file.endsWith('.yaml') && !file.endsWith('.yml')) continue;
     const content = fs.readFileSync(path.join(RECIPES_DIR, file), 'utf8');
-    const parsed = parseSimpleYaml(content);
+    const parsed = parseSimpleYaml(content, {
+      strict: true,
+      source: path.join('routing', 'recipes', file),
+      onDiagnostic: warnYamlDiagnostic
+    });
     if (parsed.metadata && parsed.metadata.name) {
       result.push(parsed);
     }

package/lib/router.js

@@ -10,7 +10,7 @@
 
 const fs = require('fs');
 const path = require('path');
-const { parseSimpleYaml } = require('./intent');
+const { parseSimpleYaml, formatDiagnostic } = require('./intent');
 const state = require('./state');
 const commandFamilies = require('./command-families');
 
@@ -24,6 +24,10 @@ const HARDEN_FINDINGS = '.godpowers/harden/FINDINGS.md';
 
 let _cache = null;
 
+function warnYamlDiagnostic(diagnostic) {
+  console.warn(`[godpowers] YAML warning ${formatDiagnostic(diagnostic)}`);
+}
+
 /**
  * Load all routing files into a map keyed by command.
  */
@@ -35,7 +39,11 @@ function loadAll() {
   for (const file of fs.readdirSync(ROUTING_DIR)) {
     if (!file.endsWith('.yaml')) continue;
     const content = fs.readFileSync(path.join(ROUTING_DIR, file), 'utf8');
-    const parsed = parseSimpleYaml(content);
+    const parsed = parseSimpleYaml(content, {
+      strict: true,
+      source: path.join('routing', file),
+      onDiagnostic: warnYamlDiagnostic
+    });
     if (parsed.metadata && parsed.metadata.command) {
       result[parsed.metadata.command] = parsed;
     }

package/lib/skill-surface.js

@@ -1,17 +1,8 @@
 const fs = require('fs');
 const path = require('path');
+const frontmatter = require('./frontmatter');
 
-function parseFrontmatter(text) {
-  if (!text.startsWith('---\n')) return {};
-  const end = text.indexOf('\n---', 4);
-  if (end === -1) return {};
-  const out = {};
-  for (const line of text.slice(4, end).split('\n')) {
-    const match = line.match(/^([a-zA-Z0-9_-]+):\s*(.*)$/);
-    if (match) out[match[1]] = match[2].replace(/^["']|["']$/g, '');
-  }
-  return out;
-}
+const parseFrontmatter = (text) => frontmatter.parse(text, { strict: true });
 
 function listSkills(rootDir = path.join(__dirname, '..', 'skills')) {
   return fs.readdirSync(rootDir)

package/lib/workflow-parser.js

@@ -7,7 +7,11 @@
 
 const fs = require('fs');
 const path = require('path');
-const { parseSimpleYaml } = require('./intent');
+const { parseSimpleYaml, formatDiagnostic } = require('./intent');
+
+function warnYamlDiagnostic(diagnostic) {
+  console.warn(`[godpowers] YAML warning ${formatDiagnostic(diagnostic)}`);
+}
 
 /**
  * Parse a workflow YAML file into a structured object.
@@ -17,14 +21,18 @@ function parseFile(filePath) {
     throw new Error(`Workflow not found: ${filePath}`);
   }
   const content = fs.readFileSync(filePath, 'utf8');
-  return parse(content);
+  return parse(content, filePath);
 }
 
 /**
  * Parse YAML content into a workflow object.
  */
-function parse(yamlContent) {
-  const parsed = parseSimpleYaml(yamlContent);
+function parse(yamlContent, source = 'workflow.yaml') {
+  const parsed = parseSimpleYaml(yamlContent, {
+    strict: true,
+    source,
+    onDiagnostic: warnYamlDiagnostic
+  });
   validate(parsed);
   return parsed;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "godpowers",
-  "version": "2.4.1",
+  "version": "2.4.3",
   "description": "AI-powered development system: 112 slash commands and 40 specialist agents that take a project from raw idea to hardened production. Runs inside Claude Code, Codex, Cursor, Windsurf, Gemini, and 10+ other AI coding tools.",
   "bin": {
     "godpowers": "./bin/install.js"
@@ -22,9 +22,11 @@
     "test:linter": "node scripts/test-artifact-linter.js",
     "test:diff": "node scripts/test-artifact-diff.js",
     "test:e2e": "node tests/integration/full-arc.test.js",
+    "coverage": "c8 --reporter=text --reporter=lcov node scripts/run-tests.js",
+    "coverage:lib": "c8 --include=lib/**/*.js --check-coverage --lines 90 --reporter=text node scripts/run-tests.js",
     "test:audit": "npm audit --omit=dev && git diff --check && npm run test:surface",
     "pack:check": "node scripts/check-package-contents.js",
-    "release:check": "npm test && npm run test:audit && npm run pack:check",
+    "release:check": "npm run coverage:lib && npm run test:audit && npm run pack:check",
     "lint": "node scripts/static-check.js"
   },
   "keywords": [
@@ -86,5 +88,8 @@
     "AGENTS.md",
     "CHANGELOG.md",
     "LICENSE"
-  ]
+  ],
+  "devDependencies": {
+    "c8": "^11.0.0"
+  }
 }

package/references/orchestration/GOD-NEXT-RUNBOOK.md

@@ -0,0 +1,32 @@
+# God Next Runbook
+
+This reference owns the detailed process notes for `/god-next`. The skill file stays a concise dispatch contract.
+
+## Invocation modes
+
+1. Post-completion routing reads `routing/<just-completed>.yaml`, applies success-path and conditional-next rules, runs any configured standards gate, and announces the next command.
+2. Pre-flight routing reads `routing/<target>.yaml`, evaluates prerequisites, and offers auto-completable prerequisites before the target command runs.
+3. Standalone routing reads disk state, uses `lib/router.js` for structural next steps, then uses recipes when the project is already in steady state.
+4. Intent-based routing uses `lib/recipes.js` for fuzzy text, ranked recipes, and state-aware command sequences.
+
+## Data sources
+
+Use runtime routing YAML, recipes, `lib/command-families.js`, `lib/router.js`, `lib/dashboard.js`, state.json, PROGRESS.md, CHECKPOINT.md, and completed artifacts.
+
+Read `.godpowers/prep/INITIAL-FINDINGS.md` and `.godpowers/prep/IMPORTED-CONTEXT.md` when present. Treat them as preparation context only.
+
+## Route detail
+
+When the suggestion is based on state.json, show a three-line path ahead: current state, next command, and the following gate if known.
+
+When prerequisites are missing, name the missing prerequisite, the auto-completable command when available, and the exact decision needed from the user.
+
+When a standards gate fails, show the failures, suggest `/god-redo` with feedback or `/god-skip` with a reason, and do not auto-progress.
+
+## Edge cases
+
+State drift routes to `/god-repair`. Safe sync blockers route to `/god-reconcile Release Truth And Safe Sync` before deploy, observe, harden, launch, broad migration, or resume work.
+
+Unresolved Critical harden findings block launch in default mode and under `--yolo`.
+
+In steady state, use the work-family ladders before raw route order so feature, hotfix, refactor, docs, dependency, audit, hygiene, and preflight intents resolve to the narrowest useful command.