jfl 0.2.5 → 0.4.2

package/template/.jfl/flows-self-driving.yaml

@@ -0,0 +1,170 @@
+# Self-driving loop flows
+# Enable with: jfl agent enable
+# These flows close the autonomous improvement loop:
+#   Peter Parker creates PR -> CI runs eval -> auto-merge if improved
+#
+# Required secrets (set in GitHub repo settings):
+#   JFL_HUB_URL   - Context Hub URL (e.g. http://localhost:3001)
+#   JFL_HUB_TOKEN - Auth token for hub API
+#
+# Required CLI tools:
+#   gh - GitHub CLI (for merge/review operations)
+
+flows:
+  - name: auto-merge-on-improvement
+    description: "Auto-merge Peter Parker PRs when eval score improves"
+    enabled: true
+    trigger:
+      pattern: "eval:scored"
+      condition: 'data.improved == "true"'
+    gate:
+      requires_approval: false
+    actions:
+      - type: log
+        message: "Eval passed: {{data.agent}} on PR #{{data.pr_number}} delta={{data.delta}} ({{data.baseline}} -> {{data.composite}})"
+      - type: command
+        command: |
+          if [ "{{data.improved}}" = "true" ] && [ -n "{{data.pr_number}}" ]; then
+            gh pr merge {{data.pr_number}} --merge --delete-branch \
+              --body "Auto-merged by JFL: test_pass_rate improved by {{data.delta}} ({{data.baseline}} -> {{data.composite}})"
+          fi
+      - type: journal
+        entry_type: "milestone"
+        title: "Auto-merged PP PR #{{data.pr_number}}"
+        summary: "Peter Parker PR auto-merged. test_pass_rate: {{data.baseline}} -> {{data.composite}} (delta: {{data.delta}})"
+
+  - name: flag-regression
+    description: "Request changes on Peter Parker PRs when eval regresses"
+    enabled: true
+    trigger:
+      pattern: "eval:scored"
+      condition: 'data.improved == "false"'
+    actions:
+      - type: log
+        message: "Eval regression: {{data.agent}} on PR #{{data.pr_number}} delta={{data.delta}} ({{data.baseline}} -> {{data.composite}})"
+      - type: command
+        command: |
+          if [ "{{data.improved}}" = "false" ] && [ -n "{{data.pr_number}}" ]; then
+            gh pr review {{data.pr_number}} --request-changes \
+              --body "JFL eval regression: test_pass_rate dropped by {{data.delta}} ({{data.baseline}} -> {{data.composite}}). Run URL: {{data.run_url}}"
+          fi
+      - type: journal
+        entry_type: "fix"
+        title: "Regression flagged: PP PR #{{data.pr_number}}"
+        summary: "Peter Parker PR flagged for regression. test_pass_rate: {{data.baseline}} -> {{data.composite}} (delta: {{data.delta}})"
+
+  - name: log-training-tuple
+    description: "Log training tuple after every eval:scored for RL improvement"
+    enabled: true
+    trigger:
+      pattern: "eval:scored"
+    actions:
+      - type: journal
+        entry_type: "discovery"
+        title: "Training tuple: {{data.agent}} delta={{data.delta}}"
+        summary: "State: score={{data.baseline}}, Action: PR #{{data.pr_number}} ({{data.branch}}), Reward: delta={{data.delta}} improved={{data.improved}}"
+      - type: log
+        message: "Training tuple logged: state={{data.baseline}} action=PR#{{data.pr_number}} reward={{data.delta}}"
+
+  # Review → Fix loop flows
+  - name: block-merge-on-blockers
+    description: "Request changes when AI review finds red (blocker) findings"
+    enabled: true
+    trigger:
+      pattern: "review:findings"
+      condition: 'data.has_blockers == "true"'
+    actions:
+      - type: log
+        message: "Review blockers on PR #{{data.pr_number}}: {{data.total_findings}} findings (red={{data.counts.red}})"
+      - type: command
+        command: |
+          if [ "{{data.has_blockers}}" = "true" ] && [ -n "{{data.pr_number}}" ]; then
+            gh pr review {{data.pr_number}} --request-changes \
+              --body "JFL AI Review found {{data.counts.red}} blocker(s). Address red findings before merge. Run: {{data.run_url}}"
+          fi
+      - type: journal
+        entry_type: "fix"
+        title: "Review blockers: PR #{{data.pr_number}}"
+        summary: "AI review found {{data.total_findings}} findings ({{data.counts.red}} red, {{data.counts.yellow}} yellow, {{data.counts.blue}} blue). PP should address blockers."
+
+  - name: log-review-training-data
+    description: "Log review results as training data for every review"
+    enabled: true
+    trigger:
+      pattern: "review:findings"
+    actions:
+      - type: journal
+        entry_type: "discovery"
+        title: "Review data: PR #{{data.pr_number}} — {{data.total_findings}} findings"
+        summary: "Review: {{data.model}} on {{data.branch}}. Findings: red={{data.counts.red}} yellow={{data.counts.yellow}} blue={{data.counts.blue}}. Blockers: {{data.has_blockers}}"
+      - type: log
+        message: "Review training data logged: PR#{{data.pr_number}} findings={{data.total_findings}} blockers={{data.has_blockers}}"
+
+  # PP auto-response to review findings
+  - name: pp-address-review-blockers
+    description: "Spawn Peter Parker to address blocker findings from AI review"
+    enabled: true
+    trigger:
+      pattern: "review:findings"
+      condition: 'data.has_blockers == "true"'
+    gate:
+      requires_approval: true
+      max_iterations: 3
+    actions:
+      - type: log
+        message: "PP dispatched to fix {{data.counts.red}} blocker(s) on PR #{{data.pr_number}}"
+      - type: spawn
+        command: jfl
+        args: ["peter", "run", "--task", "Address AI review blockers on PR #{{data.pr_number}} (branch: {{data.branch}}). Findings: {{data.counts.red}} red, {{data.counts.yellow}} yellow. Read the review comment with 'gh pr view {{data.pr_number}} --comments', fix each red finding, commit and push to the same branch. Do NOT create a new PR."]
+        detach: true
+      - type: journal
+        entry_type: "milestone"
+        title: "PP auto-fix dispatched: PR #{{data.pr_number}}"
+        summary: "Peter Parker spawned to address {{data.counts.red}} review blockers on {{data.branch}}. Max 3 iterations."
+
+  # Telemetry agent: log high-severity insights
+  - name: telemetry-insight-journal
+    description: "Log telemetry insights to journal for tracking"
+    enabled: true
+    trigger:
+      pattern: "telemetry:insight"
+    actions:
+      - type: journal
+        entry_type: "discovery"
+        title: "Telemetry: {{data.title}}"
+        summary: "{{data.description}}. Fix: {{data.suggested_fix}}"
+      - type: log
+        message: "[telemetry-agent] {{data.severity}} insight: {{data.title}}"
+
+  # Telemetry agent: spawn PP for high-severity issues
+  - name: telemetry-auto-fix
+    description: "Spawn Peter Parker to address high-severity telemetry findings"
+    enabled: true
+    trigger:
+      pattern: "telemetry:insight"
+      condition: 'data.severity == "high" && data.is_new == true'
+    gate:
+      requires_approval: true
+    actions:
+      - type: log
+        message: "PP dispatched for telemetry issue: {{data.title}}"
+      - type: spawn
+        command: jfl
+        args: ["peter", "pr", "--task", "Fix telemetry issue: {{data.title}}. Details: {{data.description}}. Suggested fix: {{data.suggested_fix}}"]
+        detach: true
+      - type: journal
+        entry_type: "milestone"
+        title: "PP dispatched: {{data.title}}"
+        summary: "Telemetry agent detected high-severity issue. Peter Parker spawned to address: {{data.description}}"
+
+  # Training tuple enrichment with AI quality score
+  - name: log-quality-training-tuple
+    description: "Log enriched training tuple with AI quality dimensions"
+    enabled: true
+    trigger:
+      pattern: "eval:scored"
+    actions:
+      - type: journal
+        entry_type: "discovery"
+        title: "Quality tuple: {{data.agent}} quality={{data.quality_score}}"
+        summary: "Enriched tuple — State: baseline={{data.baseline}}, Action: PR #{{data.pr_number}}, Reward: delta={{data.delta}} quality={{data.quality_score}}. Dims: correctness={{data.dim_correctness}} coverage={{data.dim_coverage}} architecture={{data.dim_architecture}} value={{data.dim_value}}"

package/template/THEORY.md

@@ -0,0 +1,26 @@
+# Theory — {agent-name}
+
+## Current Hypothesis
+
+{What do you believe is true about your approach? Why should it work? What's the core insight?}
+
+## Approach
+
+{How are you executing on the hypothesis? What's the method?}
+
+## Predictions (specific, falsifiable)
+
+| # | Prediction | Metric | Target | By |
+|---|-----------|--------|--------|-----|
+| P1 | {specific claim} | {metric name} | {threshold} | {version or date} |
+| P2 | {specific claim} | {metric name} | {threshold} | {version or date} |
+
+## Evidence
+
+| Date | Prediction | Actual | Delta | Verdict |
+|------|-----------|--------|-------|---------|
+| | | | | |
+
+## Revisions
+
+{When evidence contradicts predictions, document what changed and why.}

package/template/scripts/session/session-cleanup.sh

@@ -155,12 +155,21 @@ if [ $MERGE_STATUS -eq 0 ]; then
   # Push to origin
   git push origin "$WORKING_BRANCH" 2>/dev/null || echo "⚠ Push failed - run manually: git push origin $WORKING_BRANCH"
 
-  # Remove worktree if it exists
-  WORKTREE_PATH=$(git worktree list | grep "$BRANCH" | awk '{print $1}' | head -1)
+  # Remove worktree if it exists (NEVER remove the main repo)
+  MAIN_TOPLEVEL=$(git rev-parse --show-toplevel 2>/dev/null)
+  WORKTREE_PATH=$(git worktree list | grep "$BRANCH" | grep -v "(bare)" | awk '{print $1}' | head -1)
   if [ -n "$WORKTREE_PATH" ] && [ -d "$WORKTREE_PATH" ]; then
-    echo "Removing worktree at $WORKTREE_PATH..."
-    rm -rf "$WORKTREE_PATH" 2>/dev/null || true
-    git worktree prune 2>/dev/null || true
+    WORKTREE_REAL=$(cd "$WORKTREE_PATH" && pwd -P)
+    MAIN_REAL=$(cd "$MAIN_TOPLEVEL" && pwd -P)
+    if [ "$WORKTREE_REAL" = "$MAIN_REAL" ]; then
+      echo "⚠ SAFETY: refusing to rm -rf main repo at $WORKTREE_PATH"
+    elif [ "$WORKTREE_REAL" = "$HOME" ] || [ "$WORKTREE_REAL" = "/" ]; then
+      echo "⚠ SAFETY: refusing to rm -rf protected path $WORKTREE_PATH"
+    else
+      echo "Removing worktree at $WORKTREE_PATH..."
+      git worktree remove "$WORKTREE_PATH" --force 2>/dev/null || true
+      git worktree prune 2>/dev/null || true
+    fi
   fi
 
   # Delete the branch
@@ -227,12 +236,21 @@ else
     # Push to origin
     git push origin "$WORKING_BRANCH" 2>/dev/null || echo "⚠ Push failed - run manually: git push origin $WORKING_BRANCH"
 
-    # Remove worktree
-    WORKTREE_PATH=$(git worktree list | grep "$BRANCH" | awk '{print $1}' | head -1)
+    # Remove worktree if it exists (NEVER remove the main repo)
+    MAIN_TOPLEVEL=$(git rev-parse --show-toplevel 2>/dev/null)
+    WORKTREE_PATH=$(git worktree list | grep "$BRANCH" | grep -v "(bare)" | awk '{print $1}' | head -1)
     if [ -n "$WORKTREE_PATH" ] && [ -d "$WORKTREE_PATH" ]; then
-      echo "Removing worktree at $WORKTREE_PATH..."
-      rm -rf "$WORKTREE_PATH" 2>/dev/null || true
-      git worktree prune 2>/dev/null || true
+      WORKTREE_REAL=$(cd "$WORKTREE_PATH" && pwd -P)
+      MAIN_REAL=$(cd "$MAIN_TOPLEVEL" && pwd -P)
+      if [ "$WORKTREE_REAL" = "$MAIN_REAL" ]; then
+        echo "⚠ SAFETY: refusing to rm -rf main repo at $WORKTREE_PATH"
+      elif [ "$WORKTREE_REAL" = "$HOME" ] || [ "$WORKTREE_REAL" = "/" ]; then
+        echo "⚠ SAFETY: refusing to rm -rf protected path $WORKTREE_PATH"
+      else
+        echo "Removing worktree at $WORKTREE_PATH..."
+        git worktree remove "$WORKTREE_PATH" --force 2>/dev/null || true
+        git worktree prune 2>/dev/null || true
+      fi
     fi
 
     # Delete the branch

package/dist/dashboard/components.d.ts

@@ -1,7 +0,0 @@
-/**
- * Dashboard reusable Preact components
- *
- * @purpose Preact+HTM component JS strings for Nav, Card, StatusBadge, Table, JournalEntry, etc.
- */
-export declare function getComponentsJS(): string;
-//# sourceMappingURL=components.d.ts.map

package/dist/dashboard/components.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/dashboard/components.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,eAAe,IAAI,MAAM,CA4JxC"}

package/dist/dashboard/components.js

@@ -1,163 +0,0 @@
-/**
- * Dashboard reusable Preact components
- *
- * @purpose Preact+HTM component JS strings for Nav, Card, StatusBadge, Table, JournalEntry, etc.
- */
-export function getComponentsJS() {
-    return `
-    function Nav({ currentPage, setPage, projectName, port }) {
-      const pages = [
-        { id: 'overview', label: 'Command Center' },
-        { id: 'journal', label: 'Journal' },
-        { id: 'agents', label: 'Agents' },
-        { id: 'events', label: 'Events' },
-        { id: 'sessions', label: 'Sessions' },
-        { id: 'projects', label: 'Projects' },
-      ]
-
-      return html\`
-        <div class="sidebar">
-          <div class="sidebar-brand">
-            <h1>\${projectName || 'Context Hub'}</h1>
-            <div class="port-badge">Port \${port}</div>
-          </div>
-          <ul class="nav-items">
-            \${pages.map(p => html\`
-              <li
-                key=\${p.id}
-                class=\${'nav-item' + (currentPage === p.id ? ' active' : '')}
-                onClick=\${() => setPage(p.id)}
-              >
-                \${p.label}
-              </li>
-            \`)}
-          </ul>
-        </div>
-      \`
-    }
-
-    function Card({ title, children, className }) {
-      return html\`
-        <div class=\${'card ' + (className || '')}>
-          \${title && html\`<div class="card-title">\${title}</div>\`}
-          \${children}
-        </div>
-      \`
-    }
-
-    function StatusBadge({ status }) {
-      const s = (status || 'unknown').toLowerCase()
-      return html\`<span class=\${'badge badge-' + s}>\${status}</span>\`
-    }
-
-    function TypeBadge({ type }) {
-      const t = (type || 'unknown').toLowerCase()
-      let cls = 'badge-unknown'
-      if (t.startsWith('peter')) cls = 'badge-peter'
-      else if (t.startsWith('task')) cls = 'badge-task'
-      else if (t.startsWith('session')) cls = 'badge-session'
-      else if (t.startsWith('system')) cls = 'badge-system'
-      else if (t === 'feature') cls = 'badge-feature'
-      else if (t === 'fix') cls = 'badge-fix'
-      else if (t === 'decision') cls = 'badge-decision'
-      else if (t === 'discovery') cls = 'badge-discovery'
-      else if (t === 'milestone') cls = 'badge-milestone'
-      else if (t === 'entry') cls = 'badge-unknown'
-      else if (t === 'doc') cls = 'badge-unknown'
-      return html\`<span class=\${'badge ' + cls}>\${type}</span>\`
-    }
-
-    function DataTable({ headers, rows }) {
-      if (!rows || rows.length === 0) {
-        return html\`<div class="empty-state">No data</div>\`
-      }
-      return html\`
-        <table>
-          <thead>
-            <tr>\${headers.map(h => html\`<th key=\${h}>\${h}</th>\`)}</tr>
-          </thead>
-          <tbody>
-            \${rows.map((row, i) => html\`
-              <tr key=\${i}>
-                \${row.map((cell, j) => html\`<td key=\${j}>\${cell}</td>\`)}
-              </tr>
-            \`)}
-          </tbody>
-        </table>
-      \`
-    }
-
-    function EventRow({ event }) {
-      const time = new Date(event.timestamp).toLocaleTimeString()
-      const payload = JSON.stringify(event.data || {}).slice(0, 80)
-      return html\`
-        <tr class="event-row">
-          <td class="event-time">\${time}</td>
-          <td><\${TypeBadge} type=\${event.type} /></td>
-          <td>\${event.source || '-'}</td>
-          <td class="event-payload">\${payload}</td>
-        </tr>
-      \`
-    }
-
-    function JournalEntryRow({ entry, expanded }) {
-      const time = entry.timestamp ? new Date(entry.timestamp).toLocaleString() : ''
-      return html\`
-        <div class="journal-entry">
-          <div class="journal-entry-header">
-            <\${TypeBadge} type=\${entry.type || 'entry'} />
-            <span class="journal-entry-title">\${entry.title}</span>
-            <span class="journal-entry-time">\${time}</span>
-          </div>
-          \${(expanded || entry.content) && html\`
-            <div class="journal-entry-content">\${(entry.content || '').slice(0, 200)}\${(entry.content || '').length > 200 ? '...' : ''}</div>
-          \`}
-        </div>
-      \`
-    }
-
-    function SearchInput({ value, onInput, placeholder, loading }) {
-      return html\`
-        <div style="position: relative; flex: 1;">
-          <input
-            type="text"
-            class="search-input"
-            value=\${value}
-            onInput=\${onInput}
-            placeholder=\${placeholder || 'Search...'}
-            onKeyDown=\${e => { if (e.key === 'Enter' && e.target.closest('.card')) { const btn = e.target.closest('.card').querySelector('.btn-primary'); if (btn) btn.click() }}}
-          />
-          \${loading && html\`<div class="loading" style="position: absolute; right: 8px; top: 50%; transform: translateY(-50%); padding: 0;"></div>\`}
-        </div>
-      \`
-    }
-
-    function LiveIndicator({ connected }) {
-      return html\`
-        <span style="display: inline-flex; align-items: center; font-size: 0.8rem;">
-          <span class="live-dot" style=\${'background: ' + (connected ? 'var(--success)' : 'var(--error)')}></span>
-          \${connected ? 'Live' : 'Disconnected'}
-        </span>
-      \`
-    }
-
-    function StatRow({ label, value }) {
-      return html\`
-        <div class="stat-row">
-          <span class="stat-label">\${label}</span>
-          <span class="stat-value">\${value}</span>
-        </div>
-      \`
-    }
-
-    function RelevanceBar({ score, max }) {
-      const pct = Math.min(100, Math.round((score / (max || 1)) * 100))
-      return html\`
-        <div class="relevance-bar" style="width: 60px;">
-          <div class="relevance-fill" style=\${'width: ' + pct + '%'}></div>
-        </div>
-      \`
-    }
-  `;
-}
-//# sourceMappingURL=components.js.map

package/dist/dashboard/components.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"components.js","sourceRoot":"","sources":["../../src/dashboard/components.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0JN,CAAA;AACH,CAAC"}

package/dist/dashboard/pages.d.ts

@@ -1,7 +0,0 @@
-/**
- * Dashboard page components
- *
- * @purpose Command center pages: journal-first overview, events, agents, projects, sessions, journal
- */
-export declare function getPagesJS(): string;
-//# sourceMappingURL=pages.d.ts.map

package/dist/dashboard/pages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/dashboard/pages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,UAAU,IAAI,MAAM,CA+tBnC"}