@dzhechkov/harness-cli 0.3.221 → 0.3.223

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-cli",
-  "version": "0.3.221",
+  "version": "0.3.223",
   "description": "The dz CLI — install AI skills for Claude Code, Codex, OpenCode, Hermes, OpenClaude, GitHub Copilot. 35 commands, 13 presets, 6 platform targets.",
   "type": "module",
   "license": "MIT",
@@ -55,7 +55,7 @@
     "@dzhechkov/skills-reverse-engineering": "^0.1.0",
     "@dzhechkov/skills-presentation-storyteller": "^0.1.0",
     "@dzhechkov/skills-website-cloner": "^0.1.0",
-    "@dzhechkov/harness-core": "0.3.115"
+    "@dzhechkov/harness-core": "0.3.117"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/src/cli.ts

@@ -135,7 +135,17 @@ import {
   retroLessonText,
   PROCESS_SIGNATURES,
   RETRO_DOMAIN,
+  scanForSetup,
+  buildSetupPlan,
+  scaffoldFromSpec,
+  renderScaffoldPreview,
+  readExistingForScaffold,
+  assembleChallengeContext,
+  buildChallengeBrief,
+  pickAdversaryModel,
+  CHALLENGE_QUESTIONS,
 } from '@dzhechkov/harness-core';
+import type { SetupSpec } from '@dzhechkov/harness-core';
 import type { ProvenanceMode, PackVerdict, ClaudeUsageModel, PatternRecord, TargetName, BookKU, HarmonizeReport, UsageCalibrationPlan, ClaimFinding, RecallUsagePatternRow } from '@dzhechkov/harness-core';
 import { getPreset, PRESET_NAMES } from '@dzhechkov/harness-presets';
 import { scanGitHub, analyzeRepo, generateReport, deepAnalyze, scanAllSources, ScoutMemory } from '@dzhechkov/scout';
@@ -4438,6 +4448,116 @@ async function cmdRetro(options: Map<string, string>, flags: Set<string>, cwd: s
   return 0;
 }
 
+/**
+ * `dz feature-adr-setup` — the deterministic engine behind the `configure-feature-adr` SKILL (R5). Scaffolds
+ * the project-awareness files (vision / map / testing / project-skills) so a user configures feature-adr
+ * without knowing any schema.
+ *   --plan [--json]            read-only: what exists / discoverable / missing (the "which docs, where?" answer)
+ *   --from-spec <spec.json>    preview the scaffold (create / augment per file); the SKILL fills the spec
+ *   --apply                    with --from-spec: WRITE (create missing, AUGMENT existing — never clobber)
+ */
+function cmdFeatureAdrSetup(options: Map<string, string>, flags: Set<string>, cwd: string, write: Write): number {
+  let repoRoot = cwd;
+  try { repoRoot = execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf-8' }).trim() || cwd; } catch { /* not git */ }
+
+  const specPath = options.get('from-spec');
+  if (specPath === undefined) {
+    // default + --plan: the read-only "which documents, and where?" answer.
+    const plan = buildSetupPlan(scanForSetup(repoRoot));
+    if (flags.has('json')) { write(JSON.stringify(plan, null, 2)); return 0; }
+    write('feature-adr project setup — current state:');
+    write(`  vision.md: ${plan.exists.vision ? '✓' : '✗ missing'}   manifest: ${plan.exists.manifest ? '✓' : '✗ missing'}   testing.md: ${plan.exists.testing ? '✓' : '✗ missing'}   project-skills.json: ${plan.exists.projectSkills ? '✓' : '✗ missing'}`);
+    if (plan.discoveredPackages.length > 0) write(`  discovered ${plan.discoveredPackages.length} workspace package(s) → a map can be auto-scaffolded`);
+    if (plan.suggestions.length > 0) { write('  next steps:'); for (const s of plan.suggestions) write(`    • ${s}`); }
+    if (plan.missing.length === 0) write('  all set — feature-adr is project-aware here.');
+    else write('  → the `configure-feature-adr` skill walks you through the missing docs; or pass a filled spec with --from-spec.');
+    return 0;
+  }
+
+  // --from-spec: scaffold (preview, or --apply to write).
+  let spec: SetupSpec;
+  try { spec = JSON.parse(readFileSync(resolve(cwd, specPath), 'utf-8')) as SetupSpec; }
+  catch (e) { write(`dz feature-adr-setup: cannot read spec ${specPath}: ${e instanceof Error ? e.message : String(e)}`); return 1; }
+
+  const result = scaffoldFromSpec(spec, readExistingForScaffold(repoRoot));
+  if (flags.has('json') && !flags.has('apply')) { write(JSON.stringify(result, null, 2)); return 0; }
+  write(renderScaffoldPreview(result));
+
+  if (!flags.has('apply')) { write('\n(preview only — pass --apply to write)'); return 0; }
+
+  let wrote = 0;
+  for (const f of result.files) {
+    if (f.action === 'unchanged') continue;                       // never clobber
+    const abs = resolve(repoRoot, f.path);
+    // Write-boundary augment-never-clobber guard (defense in depth): a 'create' must NEVER overwrite an
+    // existing file, even if the plan (built from a caller-supplied `existing`) said create. 'augment' has
+    // already union-merged the prior content, so overwriting there is the merged result, not a clobber.
+    if (f.action === 'create' && existsSync(abs)) {
+      write(`  · skipped ${f.path} — already exists (not overwritten)`);
+      continue;
+    }
+    try {
+      mkdirSync(dirname(abs), { recursive: true });
+      writeFileSync(abs, f.content);
+      write(`  ✓ ${f.action === 'create' ? 'created' : 'augmented'} ${f.path}`);
+      wrote++;
+    } catch (e) { write(`  ✗ ${f.path}: ${e instanceof Error ? e.message : String(e)}`); }
+  }
+  write(`\n↳ wrote ${wrote} file(s). Verify: dz project-skills   +   dz architecture --revise`);
+  return 0;
+}
+
+/**
+ * `dz challenge` — the deterministic "cartridge" behind the `challenge-panel` adversarial plan-gate (R6).
+ * Assembles a WIDE context pack (plan + vision + testing + map + degradations) and prints the fixed C1-C8
+ * "break it, don't confirm it" brief + the verdict schema. It runs NO LLM and writes nothing — the
+ * `challenge-panel` SKILL fires the brief at a FRESH adversary (a model ≠ the plan author) + a mandatory
+ * cross-validator. ADVISE, never block.
+ *   --plan <plan.md>      the plan under review (required)
+ *   --json                emit the assembled context + brief as JSON
+ *   --context-only        just the assembled context summary (what the panel will read)
+ *   --author <model>      the plan-author model → prints the cross-family adversary to dispatch (FR-4)
+ */
+function cmdChallenge(options: Map<string, string>, flags: Set<string>, cwd: string, write: Write): number {
+  let repoRoot = cwd;
+  try { repoRoot = execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf-8' }).trim() || cwd; } catch { /* not git */ }
+
+  const planPath = options.get('plan');
+  if (planPath === undefined) {
+    write('dz challenge: pass --plan <plan.md> (the implementation plan to challenge).');
+    return 1;
+  }
+
+  const ctx = assembleChallengeContext(repoRoot, planPath);
+  if (ctx.plan === '') {
+    write(`dz challenge: plan not found or empty: ${planPath}`);
+    return 1;
+  }
+
+  const adversary = pickAdversaryModel(options.get('author') ?? 'claude');
+
+  if (flags.has('json')) {
+    write(JSON.stringify({ context: ctx, brief: buildChallengeBrief(ctx), adversary, questions: CHALLENGE_QUESTIONS }, null, 2));
+    return 0;
+  }
+
+  if (flags.has('context-only')) {
+    const has = (v: string | undefined): string => (v === undefined ? '✗ (less calibration)' : `✓ ${v.length} chars`);
+    write(`challenge context for ${planPath}:`);
+    write(`  plan:        ✓ ${ctx.plan.length} chars`);
+    write(`  vision:      ${has(ctx.vision)}`);
+    write(`  testing:     ${has(ctx.testing)}`);
+    write(`  map:         ${has(ctx.map)}`);
+    write(`  degradations:${has(ctx.degradations)}`);
+    write(`  → adversary: ${adversary.model} — ${adversary.note}`);
+    return 0;
+  }
+
+  write(buildChallengeBrief(ctx));
+  write(`\n── dispatch (panel ≠ plan author) ──\n${adversary.model}: ${adversary.note}`);
+  return 0;
+}
+
 function cmdStats(cwd: string, write: Write): number {
   const baseDir = join(cwd, 'packages', '@dzhechkov');
   if (!existsSync(baseDir)) {
@@ -4710,6 +4830,10 @@ export async function runCli(argv: string[], io: CliIo = {}): Promise<number> {
         return await cmdMrRakes(options, flags, cwd, write);
       case 'retro':
         return await cmdRetro(options, flags, cwd, write);
+      case 'feature-adr-setup':
+        return cmdFeatureAdrSetup(options, flags, cwd, write);
+      case 'challenge':
+        return cmdChallenge(options, flags, cwd, write);
       case 'dashboard':
         return cmdDashboard(cwd, write);
       case 'roam':