@hanzlaa/rcode 3.6.15 → 4.0.0

package/rihal/agents/rules/verifier/key-links.md

@@ -1,56 +0,0 @@
-# Verifier — Key Link Wiring Patterns (Step 5)
-
-Key links are critical connections. If broken, the goal fails even with all artifacts present.
-
-Use rihal-tools for key link verification against must_haves in PLAN frontmatter:
-
-```bash
-LINKS_RESULT=$(node ".rihal/bin/rihal-tools.cjs" verify key-links "$PLAN_PATH")
-```
-
-Parse JSON result: `{ all_verified, verified, total, links: [{from, to, via, verified, detail}] }`
-
-For each link:
-- `verified=true` → WIRED
-- `verified=false` with "not found" in detail → NOT_WIRED
-- `verified=false` with "Pattern not found" → PARTIAL
-
-## Fallback Patterns
-
-Use these if `must_haves.key_links` not defined in PLAN.
-
-### Pattern: Component → API
-
-```bash
-grep -E "fetch\(['\"].*$api_path|axios\.(get|post).*$api_path" "$component" 2>/dev/null
-grep -A 5 "fetch\|axios" "$component" | grep -E "await|\.then|setData|setState" 2>/dev/null
-```
-
-Status: WIRED (call + response handling) | PARTIAL (call, no response use) | NOT_WIRED (no call)
-
-### Pattern: API → Database
-
-```bash
-grep -E "prisma\.$model|db\.$model|$model\.(find|create|update|delete)" "$route" 2>/dev/null
-grep -E "return.*json.*\w+|res\.json\(\w+" "$route" 2>/dev/null
-```
-
-Status: WIRED (query + result returned) | PARTIAL (query, static return) | NOT_WIRED (no query)
-
-### Pattern: Form → Handler
-
-```bash
-grep -E "onSubmit=\{|handleSubmit" "$component" 2>/dev/null
-grep -A 10 "onSubmit.*=" "$component" | grep -E "fetch|axios|mutate|dispatch" 2>/dev/null
-```
-
-Status: WIRED (handler + API call) | STUB (only logs/preventDefault) | NOT_WIRED (no handler)
-
-### Pattern: State → Render
-
-```bash
-grep -E "useState.*$state_var|\[$state_var," "$component" 2>/dev/null
-grep -E "\{.*$state_var.*\}|\{$state_var\." "$component" 2>/dev/null
-```
-
-Status: WIRED (state displayed) | NOT_WIRED (state exists, not rendered)

package/rihal/agents/rules/verifier/requirements-coverage.md

@@ -1,28 +0,0 @@
-# Verifier — Requirements Coverage (Step 6)
-
-## 6a. Extract requirement IDs from PLAN frontmatter
-
-```bash
-grep -A5 "^requirements:" "$PHASE_DIR"/*-SPRINT.md 2>/dev/null
-```
-
-Collect ALL requirement IDs declared across plans for this phase.
-
-## 6b. Cross-reference against REQUIREMENTS.md
-
-For each requirement ID from plans:
-
-1. Find its full description in REQUIREMENTS.md (`**REQ-ID**: description`)
-2. Map to supporting truths/artifacts verified in Steps 3-5
-3. Determine status:
-   - ✓ SATISFIED: Implementation evidence found that fulfills the requirement
-   - ✗ BLOCKED: No evidence or contradicting evidence
-   - ? NEEDS HUMAN: Can't verify programmatically (UI behavior, UX quality)
-
-## 6c. Check for orphaned requirements
-
-```bash
-grep -E "Phase $PHASE_NUM" .rihal/REQUIREMENTS.md 2>/dev/null
-```
-
-If REQUIREMENTS.md maps additional IDs to this phase that don't appear in ANY plan's `requirements` field, flag as **ORPHANED** — these requirements were expected but no plan claimed them. ORPHANED requirements MUST appear in the verification report.

package/rihal/agents/rules/verifier/verification-report.md

@@ -1,131 +0,0 @@
-# Verifier — VERIFICATION.md Template + Return Format
-
-## Create VERIFICATION.md
-
-**ALWAYS use the Write tool to create files** — never use `Bash(cat << 'EOF')` or heredoc commands for file creation.
-
-Create `.rihal/phases/{phase_dir}/{phase_num}-VERIFICATION.md`:
-
-```markdown
----
-phase: XX-name
-verified: YYYY-MM-DDTHH:MM:SSZ
-status: passed | gaps_found | human_needed
-score: N/M must-haves verified
-re_verification: # Only if previous VERIFICATION.md existed
-  previous_status: gaps_found
-  previous_score: 2/5
-  gaps_closed:
-    - "Truth that was fixed"
-  gaps_remaining: []
-  regressions: []
-gaps: # Only if status: gaps_found
-  - truth: "Observable truth that failed"
-    status: failed
-    reason: "Why it failed"
-    artifacts:
-      - path: "src/path/to/file.tsx"
-        issue: "What's wrong"
-    missing:
-      - "Specific thing to add/fix"
-human_verification: # Only if status: human_needed
-  - test: "What to do"
-    expected: "What should happen"
-    why_human: "Why can't verify programmatically"
----
-
-# Phase {X}: {Name} Verification Report
-
-**Phase Goal:** {goal from ROADMAP.md}
-**Verified:** {timestamp}
-**Status:** {status}
-**Re-verification:** {Yes — after gap closure | No — initial verification}
-
-## Goal Achievement
-
-### Observable Truths
-
-| #   | Truth   | Status     | Evidence       |
-| --- | ------- | ---------- | -------------- |
-| 1   | {truth} | ✓ VERIFIED | {evidence}     |
-| 2   | {truth} | ✗ FAILED   | {what's wrong} |
-
-**Score:** {N}/{M} truths verified
-
-### Required Artifacts
-
-| Artifact | Expected    | Status | Details |
-| -------- | ----------- | ------ | ------- |
-| `path`   | description | status | details |
-
-### Key Link Verification
-
-| From | To  | Via | Status | Details |
-| ---- | --- | --- | ------ | ------- |
-
-### Data-Flow Trace (Level 4)
-
-| Artifact | Data Variable | Source | Produces Real Data | Status |
-| -------- | ------------- | ------ | ------------------ | ------ |
-
-### Behavioral Spot-Checks
-
-| Behavior | Command | Result | Status |
-| -------- | ------- | ------ | ------ |
-
-### Requirements Coverage
-
-| Requirement | Source Plan | Description | Status | Evidence |
-| ----------- | ---------- | ----------- | ------ | -------- |
-
-### Anti-Patterns Found
-
-| File | Line | Pattern | Severity | Impact |
-| ---- | ---- | ------- | -------- | ------ |
-
-### Human Verification Required
-
-{Items needing human testing — detailed format for user}
-
-### Gaps Summary
-
-{Narrative summary of what's missing and why}
-
----
-
-_Verified: {timestamp}_
-_Verifier: the agent (rihal-verifier)_
-```
-
-## Return to Orchestrator
-
-**DO NOT COMMIT.** The orchestrator bundles VERIFICATION.md with other phase artifacts.
-
-Return with:
-
-```markdown
-## Verification Complete
-
-**Status:** {passed | gaps_found | human_needed}
-**Score:** {N}/{M} must-haves verified
-**Report:** .rihal/phases/{phase_dir}/{phase_num}-VERIFICATION.md
-
-{If passed:}
-All must-haves verified. Phase goal achieved. Ready to proceed.
-
-{If gaps_found:}
-### Gaps Found
-{N} gaps blocking goal achievement:
-1. **{Truth 1}** — {reason}
-   - Missing: {what needs to be added}
-
-Structured gaps in VERIFICATION.md frontmatter for `/rihal-plan --gaps`.
-
-{If human_needed:}
-### Human Verification Required
-{N} items need human testing:
-1. **{Test name}** — {what to do}
-   - Expected: {what should happen}
-
-Automated checks passed. Awaiting human verification.
-```

package/rihal/bin/lib/config.cjs

@@ -1,158 +0,0 @@
-/**
- * Config — dotted-path get/set for .rihal/config.yaml.
- *
- * Supports single-level nested YAML (e.g. `workflow:\n  discuss_mode: adaptive`)
- * in addition to flat `key: value`. Stdlib-only.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-function configPathFor(projectRoot) {
-  return path.join(projectRoot, '.rihal', 'config.yaml');
-}
-
-/** Parse YAML text into a nested object. Supports one level of indentation. */
-function parseNestedYaml(text) {
-  const out = {};
-  const lines = text.split('\n');
-  let currentSection = null;
-  for (const raw of lines) {
-    const line = raw.replace(/#.*$/, '').replace(/\s+$/, '');
-    if (!line.trim()) continue;
-
-    const indent = line.match(/^\s*/)[0].length;
-    const colonAt = line.indexOf(':');
-    if (colonAt === -1) continue;
-
-    const key = line.slice(indent, colonAt).trim();
-    let val = line.slice(colonAt + 1).trim();
-
-    if (indent === 0) {
-      if (val === '') {
-        // Section header
-        currentSection = key;
-        out[key] = {};
-      } else {
-        currentSection = null;
-        out[key] = stripQuotes(val);
-      }
-    } else if (currentSection) {
-      if (typeof out[currentSection] !== 'object' || out[currentSection] === null) {
-        out[currentSection] = {};
-      }
-      out[currentSection][key] = stripQuotes(val);
-    }
-  }
-  return out;
-}
-
-function stripQuotes(v) {
-  if (v.startsWith('"') && v.endsWith('"')) return v.slice(1, -1);
-  if (v.startsWith("'") && v.endsWith("'")) return v.slice(1, -1);
-  return v;
-}
-
-function serialise(config) {
-  const lines = [];
-  // Emit scalar keys first, then sections (mimics common YAML convention).
-  const scalars = [];
-  const sections = [];
-  for (const [k, v] of Object.entries(config)) {
-    if (v && typeof v === 'object' && !Array.isArray(v)) sections.push([k, v]);
-    else scalars.push([k, v]);
-  }
-  for (const [k, v] of scalars) {
-    lines.push(`${k}: ${quoteIfNeeded(v)}`);
-  }
-  for (const [k, v] of sections) {
-    lines.push(`${k}:`);
-    for (const [sk, sv] of Object.entries(v)) {
-      lines.push(`  ${sk}: ${quoteIfNeeded(sv)}`);
-    }
-  }
-  return lines.join('\n') + '\n';
-}
-
-function quoteIfNeeded(v) {
-  if (v === null || v === undefined) return '';
-  const s = String(v);
-  if (/[\s:#]/.test(s) && !(s.startsWith('"') && s.endsWith('"'))) {
-    return `"${s.replace(/"/g, '\\"')}"`;
-  }
-  return s;
-}
-
-function getAt(config, dottedKey) {
-  const parts = String(dottedKey).split('.');
-  let cur = config;
-  for (const p of parts) {
-    if (cur == null || typeof cur !== 'object') return undefined;
-    cur = cur[p];
-  }
-  return cur;
-}
-
-function setAt(config, dottedKey, value) {
-  const parts = String(dottedKey).split('.');
-  let cur = config;
-  for (let i = 0; i < parts.length - 1; i++) {
-    const p = parts[i];
-    if (typeof cur[p] !== 'object' || cur[p] === null || Array.isArray(cur[p])) {
-      cur[p] = {};
-    }
-    cur = cur[p];
-  }
-  cur[parts[parts.length - 1]] = value;
-}
-
-/**
- * config-get <dotted.key>
- * Prints scalar directly (no JSON). Empty output + exit 0 if missing.
- * Returns a string (or null for missing) the caller should print with console.log
- * WITHOUT JSON-wrapping.
- */
-// Aliases: bare key → namespaced key (and reverse). When the primary lookup
-// returns null, the alias is tried automatically — fixes namespace-mix issues.
-const KEY_ALIASES = {
-  'commit_docs':          'git.commit_docs',
-  'git.commit_docs':      'commit_docs',
-  'discuss_mode':         'workflow.discuss_mode',
-  'workflow.discuss_mode': 'discuss_mode',
-};
-
-function cmdGet(projectRoot, dottedKey) {
-  if (!dottedKey) throw new Error('Usage: config-get <dotted.key>');
-  const cp = configPathFor(projectRoot);
-  if (!fs.existsSync(cp)) return null;
-  const config = parseNestedYaml(fs.readFileSync(cp, 'utf8'));
-  let val = getAt(config, dottedKey);
-  if ((val === undefined || val === null) && KEY_ALIASES[dottedKey]) {
-    val = getAt(config, KEY_ALIASES[dottedKey]);
-  }
-  if (val === undefined || val === null) return null;
-  if (typeof val === 'object') return JSON.stringify(val);
-  return String(val);
-}
-
-function cmdSet(projectRoot, dottedKey, value) {
-  if (!dottedKey) throw new Error('Usage: config-set <dotted.key> <value>');
-  if (value === undefined) throw new Error('Usage: config-set <dotted.key> <value>');
-  const cp = configPathFor(projectRoot);
-  fs.mkdirSync(path.dirname(cp), { recursive: true });
-  const existing = fs.existsSync(cp) ? fs.readFileSync(cp, 'utf8') : '';
-  const config = parseNestedYaml(existing);
-  setAt(config, dottedKey, value);
-  const out = serialise(config);
-  const tmp = cp + '.tmp';
-  fs.writeFileSync(tmp, out, 'utf8');
-  fs.renameSync(tmp, cp);
-  return { ok: true, key: dottedKey, value, path: cp };
-}
-
-module.exports = {
-  cmdGet,
-  cmdSet,
-  parseNestedYaml,
-  serialise,
-};