claude-flow-guidance-implementation 0.1.2 → 0.1.3

package/README.md

@@ -47,6 +47,24 @@ npx --yes -p claude-flow-guidance-implementation cf-guidance-impl init --target
 npx --yes -p claude-flow-guidance-implementation cf-guidance-impl verify --target ~/source/my-project
 ```
 
+## Package Runtime Mode (No Local Guidance Code)
+
+You can run guidance directly from `node_modules` and avoid committing copied guidance runtime files.
+
+Example `package.json` scripts in a target repo:
+
+```bash
+"guidance:analyze": "node ./node_modules/claude-flow-guidance-implementation/scaffold/scripts/analyze-guidance.js",
+"guidance:optimize": "node ./node_modules/claude-flow-guidance-implementation/scaffold/scripts/guidance-autopilot.js --once --apply --source manual",
+"guidance:ab-benchmark": "node ./node_modules/claude-flow-guidance-implementation/scaffold/scripts/guidance-ab-benchmark.js",
+"guidance:codex:status": "node ./node_modules/claude-flow-guidance-implementation/scaffold/scripts/guidance-codex-bridge.js status"
+```
+
+Project root resolution for scaffold scripts:
+- `GUIDANCE_PROJECT_DIR` (if set)
+- else `CLAUDE_PROJECT_DIR` (if set)
+- else current working directory (`process.cwd()`)
+
 ## CLI commands
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-guidance-implementation",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Reusable guidance control-plane implementation kit for wiring @claude-flow/guidance into any repo",
   "type": "module",
   "private": false,

package/scaffold/scripts/analyze-guidance.js

@@ -12,7 +12,7 @@ import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const root = resolve(__dirname, '..');
+const root = resolve(process.env.GUIDANCE_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd());
 
 // Import guidance modules
 const { analyze, autoOptimize, formatReport, formatBenchmark } = await import('@claude-flow/guidance/analyzer');

package/scaffold/scripts/guidance-ab-benchmark.js

@@ -7,7 +7,9 @@ import { abBenchmark } from '@claude-flow/guidance/analyzer';
 import { createSyntheticContentAwareExecutor } from '../src/guidance/content-aware-executor.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const rootDir = resolve(__dirname, '..');
+const rootDir = resolve(
+  process.env.GUIDANCE_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd()
+);
 const guidanceDir = resolve(rootDir, '.claude-flow', 'guidance');
 const reportPath = resolve(guidanceDir, 'ab-benchmark-report.json');
 

package/scaffold/scripts/guidance-autopilot.js

@@ -19,7 +19,9 @@ import { createCompiler } from '@claude-flow/guidance/compiler';
 import { createSyntheticContentAwareExecutor } from '../src/guidance/content-aware-executor.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const rootDir = resolve(__dirname, '..');
+const rootDir = resolve(
+  process.env.GUIDANCE_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd()
+);
 
 const DEFAULTS = {
   mode: 'once',

package/scaffold/scripts/guidance-codex-bridge.js

@@ -5,7 +5,9 @@ import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const rootDir = resolve(__dirname, '..');
+const rootDir = resolve(
+  process.env.GUIDANCE_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd()
+);
 
 const SUPPORTED_EVENTS = new Set([
   'pre-command',

package/scaffold/scripts/guidance-integrations.js

@@ -6,7 +6,9 @@ import { fileURLToPath } from 'node:url';
 import { createGuidanceAdvancedRuntime } from '../src/guidance/advanced-runtime.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const rootDir = resolve(__dirname, '..');
+const rootDir = resolve(
+  process.env.GUIDANCE_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd()
+);
 
 function usage() {
   console.log(`Usage:

package/scaffold/scripts/guidance-runtime.js

@@ -5,7 +5,9 @@ import { fileURLToPath } from 'node:url';
 import { createGuidancePhase1Runtime } from '../src/guidance/phase1-runtime.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const rootDir = resolve(__dirname, '..');
+const rootDir = resolve(
+  process.env.GUIDANCE_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd()
+);
 
 function usage() {
   console.log(`Usage:

package/scaffold/scripts/scaffold-guidance.js

@@ -6,7 +6,9 @@ import { fileURLToPath } from 'node:url';
 import { scaffold } from '@claude-flow/guidance/generators';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const rootDir = resolve(__dirname, '..');
+const rootDir = resolve(
+  process.env.GUIDANCE_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd()
+);
 const defaultOutputDir = resolve(rootDir, '.claude-flow', 'guidance', 'scaffold');
 
 function parseArg(flag) {