PyPI - researchloop - Versions diffs - 0.1.0__py3-none-any.whl - Mend

researchloop 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (63) hide show

researchloop/__init__.py +1 -0
researchloop/__main__.py +3 -0
researchloop/cli.py +1138 -0
researchloop/clusters/__init__.py +4 -0
researchloop/clusters/monitor.py +199 -0
researchloop/clusters/ssh.py +183 -0
researchloop/comms/__init__.py +0 -0
researchloop/comms/base.py +34 -0
researchloop/comms/conversation.py +465 -0
researchloop/comms/ntfy.py +95 -0
researchloop/comms/router.py +71 -0
researchloop/comms/slack.py +188 -0
researchloop/core/__init__.py +0 -0
researchloop/core/auth.py +78 -0
researchloop/core/config.py +328 -0
researchloop/core/credentials.py +38 -0
researchloop/core/models.py +119 -0
researchloop/core/orchestrator.py +910 -0
researchloop/dashboard/__init__.py +0 -0
researchloop/dashboard/app.py +15 -0
researchloop/dashboard/auth.py +60 -0
researchloop/dashboard/routes.py +912 -0
researchloop/dashboard/templates/base.html +84 -0
researchloop/dashboard/templates/login.html +12 -0
researchloop/dashboard/templates/loop_detail.html +58 -0
researchloop/dashboard/templates/loops.html +61 -0
researchloop/dashboard/templates/setup.html +14 -0
researchloop/dashboard/templates/sprint_detail.html +109 -0
researchloop/dashboard/templates/sprints.html +48 -0
researchloop/dashboard/templates/studies.html +18 -0
researchloop/dashboard/templates/study_detail.html +64 -0
researchloop/db/__init__.py +5 -0
researchloop/db/database.py +86 -0
researchloop/db/migrations.py +172 -0
researchloop/db/queries.py +351 -0
researchloop/runner/__init__.py +1 -0
researchloop/runner/claude.py +169 -0
researchloop/runner/job_templates/sge.sh.j2 +319 -0
researchloop/runner/job_templates/slurm.sh.j2 +336 -0
researchloop/runner/main.py +156 -0
researchloop/runner/pipeline.py +272 -0
researchloop/runner/templates/fix_issues.md.j2 +11 -0
researchloop/runner/templates/idea_generator.md.j2 +16 -0
researchloop/runner/templates/red_team.md.j2 +15 -0
researchloop/runner/templates/report.md.j2 +31 -0
researchloop/runner/templates/research_sprint.md.j2 +51 -0
researchloop/runner/templates/summarizer.md.j2 +7 -0
researchloop/runner/upload.py +153 -0
researchloop/schedulers/__init__.py +11 -0
researchloop/schedulers/base.py +43 -0
researchloop/schedulers/local.py +188 -0
researchloop/schedulers/sge.py +163 -0
researchloop/schedulers/slurm.py +179 -0
researchloop/sprints/__init__.py +0 -0
researchloop/sprints/auto_loop.py +458 -0
researchloop/sprints/manager.py +750 -0
researchloop/studies/__init__.py +0 -0
researchloop/studies/manager.py +102 -0
researchloop-0.1.0.dist-info/METADATA +596 -0
researchloop-0.1.0.dist-info/RECORD +63 -0
researchloop-0.1.0.dist-info/WHEEL +4 -0
researchloop-0.1.0.dist-info/entry_points.txt +3 -0
researchloop-0.1.0.dist-info/licenses/LICENSE +21 -0

researchloop/dashboard/templates/base.html ADDED Viewed

@@ -0,0 +1,84 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>{% block title %}ResearchLoop{% endblock %}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; background: #0f172a; color: #e2e8f0; line-height: 1.6; }
+    a { color: #60a5fa; text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    .container { max-width: 1000px; margin: 0 auto; padding: 1.5rem; }
+    header { background: #1e293b; border-bottom: 1px solid #334155; padding: 1rem 0; margin-bottom: 2rem; }
+    header .container { display: flex; align-items: center; justify-content: space-between; }
+    header h1 { font-size: 1.25rem; color: #f8fafc; }
+    header nav a { margin-left: 1.5rem; color: #94a3b8; font-size: 0.9rem; }
+    header nav a:hover { color: #f8fafc; }
+    h2 { font-size: 1.4rem; margin-bottom: 1rem; color: #f8fafc; }
+    h3 { font-size: 1.1rem; margin-bottom: 0.5rem; color: #f8fafc; }
+    table { width: 100%; border-collapse: collapse; margin-bottom: 1.5rem; }
+    th, td { padding: 0.6rem 0.8rem; text-align: left; border-bottom: 1px solid #1e293b; }
+    th { color: #94a3b8; font-weight: 600; font-size: 0.8rem; text-transform: uppercase; letter-spacing: 0.05em; }
+    tr:hover { background: #1e293b; }
+    .badge { display: inline-block; padding: 0.15rem 0.5rem; border-radius: 9999px; font-size: 0.75rem; font-weight: 600; white-space: nowrap; }
+    .badge-pending { background: #854d0e; color: #fef08a; }
+    .badge-running, .badge-research, .badge-red_team, .badge-fixing, .badge-validating, .badge-reporting, .badge-summarizing { background: #1e3a5f; color: #60a5fa; }
+    .badge-completed { background: #14532d; color: #86efac; }
+    .badge-failed, .badge-cancelled { background: #7f1d1d; color: #fca5a5; }
+    .badge-submitted, .badge-uploading { background: #713f12; color: #fde68a; }
+    .card { background: #1e293b; border-radius: 0.5rem; padding: 1.25rem; margin-bottom: 1rem; }
+    .card dt { color: #94a3b8; font-size: 0.85rem; margin-bottom: 0.2rem; }
+    .card dd { margin-bottom: 0.75rem; }
+    .dim { color: #64748b; }
+    .login-box { max-width: 360px; margin: 4rem auto; }
+    .login-box input { width: 100%; padding: 0.6rem; margin-bottom: 0.75rem; background: #0f172a; border: 1px solid #334155; border-radius: 0.375rem; color: #e2e8f0; font-size: 0.95rem; }
+    .login-box button, .btn { padding: 0.5rem 1rem; background: #2563eb; color: #fff; border: none; border-radius: 0.375rem; cursor: pointer; font-size: 0.9rem; display: inline-block; }
+    .login-box button:hover, .btn:hover { background: #1d4ed8; }
+    .btn-danger { background: #dc2626; }
+    .btn-danger:hover { background: #b91c1c; }
+    .btn-sm { padding: 0.3rem 0.6rem; font-size: 0.8rem; line-height: 1.4; box-sizing: border-box; }
+    .actions { margin-top: 1rem; display: flex; gap: 0.5rem; }
+    textarea { width: 100%; padding: 0.6rem; background: #0f172a; border: 1px solid #334155; border-radius: 0.375rem; color: #e2e8f0; font-size: 0.95rem; font-family: inherit; resize: vertical; }
+    select { padding: 0.6rem; background: #0f172a; border: 1px solid #334155; border-radius: 0.375rem; color: #e2e8f0; font-size: 0.95rem; }
+    .form-group { margin-bottom: 0.75rem; }
+    .form-group label { display: block; color: #94a3b8; font-size: 0.85rem; margin-bottom: 0.3rem; }
+    .error { color: #f87171; margin-bottom: 0.75rem; }
+    .success { color: #86efac; margin-bottom: 0.75rem; }
+    .report-content h1, .report-content h2, .report-content h3 { color: #f8fafc; margin-top: 1.5rem; margin-bottom: 0.5rem; }
+    .report-content h1 { font-size: 1.3rem; }
+    .report-content h2 { font-size: 1.15rem; }
+    .report-content h3 { font-size: 1rem; }
+    .report-content p { margin-bottom: 0.75rem; line-height: 1.7; }
+    .report-content ul, .report-content ol { margin-bottom: 0.75rem; padding-left: 1.5rem; }
+    .report-content li { margin-bottom: 0.3rem; }
+    .report-content code { background: #0f172a; padding: 0.15rem 0.4rem; border-radius: 0.25rem; font-size: 0.85rem; }
+    .report-content pre code { display: block; padding: 1rem; overflow-x: auto; }
+    .report-content table { border-collapse: collapse; margin-bottom: 1rem; }
+    .report-content th, .report-content td { padding: 0.4rem 0.8rem; border: 1px solid #334155; }
+    .report-content blockquote { border-left: 3px solid #334155; padding-left: 1rem; color: #94a3b8; margin: 0.75rem 0; }
+    pre { background: #0f172a; padding: 1rem; border-radius: 0.375rem; overflow-x: auto; font-size: 0.85rem; }
+    .refresh-btn { background: none; border: none; color: #60a5fa; cursor: pointer; font-size: 0.85rem; padding: 0.1rem 0.3rem; border-radius: 0.25rem; }
+    .refresh-btn:hover { background: #1e3a5f; }
+    @keyframes spin { to { transform: rotate(360deg); } }
+    .spinning { animation: spin 0.8s linear infinite; display: inline-block; }
+  </style>
+  {% block head %}{% endblock %}
+</head>
+<body>
+  <header>
+    <div class="container">
+      <h1><a href="/dashboard/" style="color: #f8fafc; text-decoration: none;">ResearchLoop</a></h1>
+      <nav>
+        <a href="/dashboard/">Studies</a>
+        <a href="/dashboard/sprints">Sprints</a>
+        <a href="/dashboard/loops">Loops</a>
+        {% if authenticated %}<a href="/dashboard/logout">Logout</a>{% endif %}
+      </nav>
+    </div>
+  </header>
+  <div class="container">
+    {% block content %}{% endblock %}
+  </div>
+</body>
+</html>

researchloop/dashboard/templates/login.html ADDED Viewed

@@ -0,0 +1,12 @@
+{% extends "base.html" %}
+{% block title %}Login — ResearchLoop{% endblock %}
+{% block content %}
+<div class="login-box">
+  <h2>Login</h2>
+  {% if error %}<p class="error">{{ error }}</p>{% endif %}
+  <form method="post" action="/dashboard/login">
+    <input type="password" name="password" placeholder="Password" autofocus>
+    <button type="submit">Sign in</button>
+  </form>
+</div>
+{% endblock %}

researchloop/dashboard/templates/loop_detail.html ADDED Viewed

@@ -0,0 +1,58 @@
+{% extends "base.html" %}
+{% block title %}{{ loop.id }} — ResearchLoop{% endblock %}
+{% block head %}
+{% if loop.status in ('running', 'pending') %}
+<script>setTimeout(function(){window.location.reload()},30000);</script>
+{% endif %}
+{% endblock %}
+{% block content %}
+<h2>Loop {{ loop.id }}</h2>
+<div class="card">
+  <dl>
+    <dt>Study</dt><dd><a href="/dashboard/studies/{{ loop.study_name }}">{{ loop.study_name }}</a></dd>
+    <dt>Status</dt><dd><span class="badge badge-{{ loop.status }}">{{ loop.status }}</span></dd>
+    <dt>Progress</dt><dd>{{ loop.completed_count }}/{{ loop.total_count }}</dd>
+    <dt>Current Sprint</dt><dd>{% if loop.current_sprint_id %}<a href="/dashboard/sprints/{{ loop.current_sprint_id }}">{{ loop.current_sprint_id }}</a>{% else %}—{% endif %}</dd>
+    <dt>Created</dt><dd>{{ loop.created_at }}</dd>
+    {% if loop.stopped_at %}<dt>Stopped</dt><dd>{{ loop.stopped_at }}</dd>{% endif %}
+  </dl>
+  <div class="actions" style="display: flex; gap: 0.5rem;">
+    {% if loop.status in ('running', 'pending') %}
+    <form method="post" action="/dashboard/loops/{{ loop.id }}/stop">
+      <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+      <button type="submit" class="btn btn-danger btn-sm" onclick="return confirm('Stop this loop?')">Stop loop</button>
+    </form>
+    {% endif %}
+    {% if loop.status in ('stopped', 'failed') and loop.completed_count < loop.total_count %}
+    <form method="post" action="/dashboard/loops/{{ loop.id }}/resume" onsubmit="var b=this.querySelector('button');if(b.disabled)return false;b.disabled=true;b.textContent='Resuming...';">
+      <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+      <button type="submit" class="btn btn-sm">Resume loop</button>
+    </form>
+    {% endif %}
+  </div>
+</div>
+{% if context %}
+<h3>Idea Generation Context</h3>
+<div class="card report-content">{{ context|markdown|safe }}</div>
+{% endif %}
+<h3>Sprints</h3>
+<table>
+  <thead><tr><th>ID</th><th>Status</th><th>Idea</th><th>Summary</th><th>Created</th><th></th></tr></thead>
+  <tbody>
+  {% for sp in sprints %}
+    <tr>
+      <td><a href="/dashboard/sprints/{{ sp.id }}">{{ sp.id }}</a></td>
+      <td><span class="badge badge-{{ sp.status.split(' ')[0] }}">{{ sp.status.split(' ')[0] }}</span>{% if '(' in sp.status %} <span class="dim" style="font-size:0.75rem">{{ sp.status.split('(')[1].rstrip(')') }}</span>{% endif %}</td>
+      <td>{% if sp.idea %}{{ sp.idea[:60] }}{% if sp.idea|length > 60 %}…{% endif %}{% elif sp.status not in ('completed', 'failed', 'cancelled') %}<span class="dim" style="font-style:italic">auto-generating...</span>{% elif sp.summary %}<span class="dim">{{ sp.summary[:60] }}{% if sp.summary|length > 60 %}…{% endif %}</span>{% endif %}</td>
+      <td class="dim">{{ (sp.summary or '')[:80] }}{% if (sp.summary or '')|length > 80 %}…{% endif %}</td>
+      <td class="dim">{{ sp.created_at }}</td>
+      <td>
+        {% if sp.status.startswith('running') or sp.status == 'submitted' %}
+        <button type="button" class="refresh-btn" title="Refresh status" onclick="event.stopPropagation();var b=this;b.innerHTML='<span class=spinning>&#8635;</span>';fetch('/dashboard/sprints/{{ sp.id }}/refresh',{method:'POST',headers:{'X-CSRF-Token':'{{ csrf_token }}'},redirect:'manual'}).then(function(){b.innerHTML='&#10003;';b.style.color='#86efac';setTimeout(function(){b.innerHTML='&#8635;';b.style.color='';},2000)})">&#8635;</button>
+        {% endif %}
+      </td>
+    </tr>
+  {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

researchloop/dashboard/templates/loops.html ADDED Viewed

@@ -0,0 +1,61 @@
+{% extends "base.html" %}
+{% block title %}Auto-Loops — ResearchLoop{% endblock %}
+{% block content %}
+<h2>Auto-Loops</h2>
+<h3>New loop</h3>
+<div class="card">
+  <form method="post" action="/dashboard/loops/new" onsubmit="var b=this.querySelector('button[type=submit]');if(b.disabled)return false;b.disabled=true;b.textContent='Starting...';">
+    <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+    <div class="form-group">
+      <label for="study_name">Study</label>
+      <select name="study_name" id="study_name" required>
+        {% for s in studies %}<option value="{{ s }}">{{ s }}</option>{% endfor %}
+      </select>
+    </div>
+    <div class="form-group">
+      <label for="count">Number of sprints</label>
+      <input type="number" name="count" id="count" value="5" min="1" max="50" required style="width:80px">
+    </div>
+    <div class="form-group">
+      <label for="context">Idea generation guidance <span class="dim">(optional)</span></label>
+      <textarea name="context" id="context" rows="2" placeholder="e.g. Focus on X, avoid approach Y, build on results from previous sprints..."></textarea>
+    </div>
+    <details style="margin-bottom:0.75rem">
+      <summary class="dim" style="cursor:pointer;font-size:0.85rem">Resource overrides per sprint (optional)</summary>
+      <div style="display:flex;gap:0.75rem;margin-top:0.5rem;flex-wrap:wrap">
+        <div class="form-group" style="margin:0">
+          <label for="gpu" style="font-size:0.8rem">GPU</label>
+          <input type="text" name="gpu" id="gpu" placeholder="e.g. gpu:1" style="width:140px;font-size:0.85rem">
+        </div>
+        <div class="form-group" style="margin:0">
+          <label for="mem" style="font-size:0.8rem">Memory</label>
+          <input type="text" name="mem" id="mem" placeholder="e.g. 64G" style="width:80px;font-size:0.85rem">
+        </div>
+        <div class="form-group" style="margin:0">
+          <label for="cpus" style="font-size:0.8rem">CPUs</label>
+          <input type="text" name="cpus" id="cpus" placeholder="e.g. 8" style="width:60px;font-size:0.85rem">
+        </div>
+      </div>
+    </details>
+    <button type="submit" class="btn">Start loop</button>
+  </form>
+</div>
+<h3>Loops</h3>
+<table>
+  <thead><tr><th>ID</th><th>Study</th><th>Status</th><th>Progress</th><th>Current Sprint</th><th>Created</th></tr></thead>
+  <tbody>
+  {% for lp in loops %}
+    <tr>
+      <td><a href="/dashboard/loops/{{ lp.id }}">{{ lp.id }}</a></td>
+      <td><a href="/dashboard/studies/{{ lp.study_name }}">{{ lp.study_name }}</a></td>
+      <td><span class="badge badge-{{ lp.status }}">{{ lp.status }}</span></td>
+      <td>{{ lp.completed_count }}/{{ lp.total_count }}</td>
+      <td>{% if lp.current_sprint_id %}<a href="/dashboard/sprints/{{ lp.current_sprint_id }}">{{ lp.current_sprint_id }}</a>{% else %}—{% endif %}</td>
+      <td class="dim">{{ lp.created_at }}</td>
+    </tr>
+  {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

researchloop/dashboard/templates/setup.html ADDED Viewed

@@ -0,0 +1,14 @@
+{% extends "base.html" %}
+{% block title %}Setup — ResearchLoop{% endblock %}
+{% block content %}
+<div class="login-box">
+  <h2>Welcome to ResearchLoop</h2>
+  <p style="color: #94a3b8; margin-bottom: 1rem;">Set a password to secure your dashboard.</p>
+  {% if error %}<p class="error">{{ error }}</p>{% endif %}
+  <form method="post" action="/dashboard/setup">
+    <input type="password" name="password" placeholder="Password" autofocus required minlength="8">
+    <input type="password" name="confirm" placeholder="Confirm password" required minlength="8">
+    <button type="submit">Set password</button>
+  </form>
+</div>
+{% endblock %}

researchloop/dashboard/templates/sprint_detail.html ADDED Viewed

@@ -0,0 +1,109 @@
+{% extends "base.html" %}
+{% block title %}{{ sprint.id }} — ResearchLoop{% endblock %}
+{% block head %}
+{% if sprint.status.startswith('running') or sprint.status == 'submitted' %}
+<script>setTimeout(function(){refreshSprint()},30000);</script>
+{% endif %}
+{% endblock %}
+{% block content %}
+<h2>Sprint {{ sprint.id }}</h2>
+<div class="card">
+  <dl>
+    <dt>Study</dt><dd><a href="/dashboard/studies/{{ sprint.study_name }}">{{ sprint.study_name }}</a></dd>
+    <dt>Status</dt><dd id="sprint-status"><span class="badge badge-{{ sprint.status.split(' ')[0] }}">{{ sprint.status }}</span></dd>
+    <dt>Idea</dt><dd id="sprint-idea">{% if sprint.idea %}<div class="report-content">{{ sprint.idea|markdown|safe }}</div>{% elif sprint.loop_id and sprint.status not in ('completed', 'failed', 'cancelled') %}<span class="dim" style="font-style:italic">auto-generating idea...</span>{% elif sprint.summary %}<span class="dim">{{ sprint.summary[:120] }}{% if sprint.summary|length > 120 %}…{% endif %}</span>{% else %}—{% endif %}</dd>
+    {% if sprint.loop_id %}<dt>Loop</dt><dd><a href="/dashboard/loops/{{ sprint.loop_id }}">{{ sprint.loop_id }}</a></dd>{% endif %}
+    <dt>Job ID</dt><dd>{{ sprint.job_id or '—' }}</dd>
+    <dt>Directory</dt><dd class="dim">{{ sprint.directory or '—' }}</dd>
+    <dt>Created</dt><dd>{{ sprint.created_at }}</dd>
+    <dt>Started</dt><dd id="sprint-started">{{ sprint.started_at or '—' }}</dd>
+    <dt>Completed</dt><dd id="sprint-completed">{{ sprint.completed_at or '—' }}</dd>
+  </dl>
+  <div class="actions" style="justify-content: space-between;">
+    <div style="display: flex; gap: 0.5rem;">
+      <button type="button" id="refresh-btn" class="btn btn-sm" onclick="refreshSprint()">&#8635; Refresh status</button>
+      {% if sprint.status not in ('completed', 'failed', 'cancelled') %}
+      <form method="post" action="/dashboard/sprints/{{ sprint.id }}/cancel">
+        <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+        <button type="submit" class="btn btn-danger btn-sm" onclick="return confirm('Cancel this sprint?')">Cancel</button>
+      </form>
+      {% endif %}
+      <form method="post" action="/dashboard/sprints/{{ sprint.id }}/delete">
+        <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+        <button type="submit" class="btn btn-danger btn-sm" onclick="return confirm('Delete this sprint? This cannot be undone.')">Delete</button>
+      </form>
+      {% if sprint.status in ('failed', 'cancelled') %}
+      <form method="post" action="/dashboard/sprints/{{ sprint.id }}/resubmit" onsubmit="var b=this.querySelector('button');if(b.disabled)return false;b.disabled=true;b.textContent='Resubmitting...';">
+        <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+        <button type="submit" class="btn btn-sm">Resubmit</button>
+      </form>
+      {% endif %}
+      {% if sprint.idea %}
+      <a href="/dashboard/studies/{{ sprint.study_name }}?idea={{ sprint.idea|urlencode }}" class="btn btn-sm" style="text-decoration:none">Copy</a>
+      {% endif %}
+    </div>
+    {% if has_pdf %}
+    <a href="/dashboard/sprints/{{ sprint.id }}/report.pdf" target="_blank" class="btn btn-sm" style="text-decoration: none;">&#128196; Report PDF</a>
+    {% endif %}
+  </div>
+</div>
+{% if sprint.summary %}
+<h3>Summary</h3>
+<div class="card" id="summary-section"><p>{{ sprint.summary }}</p></div>
+{% endif %}
+{% if report %}
+<h3>Report</h3>
+<div class="card report-content">{{ report|markdown|safe }}</div>
+{% endif %}
+{% if sprint.error %}
+<h3>Log</h3>
+<div class="card"><pre style="white-space: pre-wrap; word-wrap: break-word; color: #94a3b8;">{{ sprint.error }}</pre></div>
+{% endif %}
+{% if artifacts %}
+<h3>Artifacts</h3>
+<table>
+  <thead><tr><th>Filename</th><th>Size</th><th>Uploaded</th><th></th></tr></thead>
+  <tbody>
+  {% for a in artifacts %}
+    <tr>
+      <td>{{ a.filename }}</td>
+      <td class="dim">{% if a.size %}{{ (a.size / 1024)|round(1) }} KB{% endif %}</td>
+      <td class="dim">{{ a.uploaded_at }}</td>
+      <td><a href="/dashboard/artifacts/{{ a.id }}/download">Download</a></td>
+    </tr>
+  {% endfor %}
+  </tbody>
+</table>
+{% endif %}
+<script>
+var csrfToken='{{ csrf_token }}';
+function refreshSprint(){
+  var btn=document.getElementById('refresh-btn');
+  btn.innerHTML='<span class="spinning" style="display:inline-block">&#8635;</span> Refreshing...';
+  btn.disabled=true;
+  fetch('/dashboard/sprints/{{ sprint.id }}/refresh',{method:'POST',headers:{'Accept':'application/json','X-CSRF-Token':csrfToken}})
+    .then(function(r){return r.json()})
+    .then(function(d){
+      if(d.status){
+        var s=d.status.split(' ')[0];
+        document.getElementById('sprint-status').innerHTML='<span class="badge badge-'+s+'">'+d.status+'</span>';
+      }
+      if(d.idea){document.getElementById('sprint-idea').textContent=d.idea;}
+      if(d.summary){
+        var sec=document.getElementById('summary-section');
+        if(sec){sec.querySelector('p').textContent=d.summary;}
+      }
+      if(d.completed_at){document.getElementById('sprint-completed').textContent=d.completed_at;}
+      btn.innerHTML='&#10003; Updated';btn.style.color='#86efac';
+      setTimeout(function(){btn.innerHTML='&#8635; Refresh status';btn.style.color='';btn.disabled=false;},2000);
+      if(d.status && (d.status.startsWith('running') || d.status==='submitted')){
+        setTimeout(function(){refreshSprint()},30000);
+      }
+    })
+    .catch(function(){
+      btn.innerHTML='&#8635; Refresh status';btn.disabled=false;
+      window.location.reload();
+    });
+}
+</script>
+{% endblock %}

researchloop/dashboard/templates/sprints.html ADDED Viewed

@@ -0,0 +1,48 @@
+{% extends "base.html" %}
+{% block title %}Sprints — ResearchLoop{% endblock %}
+{% block content %}
+<h2>Sprints</h2>
+{% if studies %}
+<div class="card">
+  <h3 style="margin-top:0">New sprint</h3>
+  {% if error %}<p class="error">{{ error }}</p>{% endif %}
+  {% if success %}<p class="success">{{ success }}</p>{% endif %}
+  <form method="post" action="/dashboard/sprints/new" onsubmit="var b=this.querySelector('button[type=submit]');if(b.disabled)return false;b.disabled=true;b.textContent='Submitting...';">
+    <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+    <div class="form-group">
+      <label for="study_name">Study</label>
+      <select name="study_name" id="study_name" required>
+        {% for s in studies %}<option value="{{ s }}">{{ s }}</option>{% endfor %}
+      </select>
+    </div>
+    <div class="form-group">
+      <label for="idea">Research idea</label>
+      <textarea name="idea" id="idea" rows="3" placeholder="Describe what this sprint should investigate..." required></textarea>
+    </div>
+    <button type="submit" class="btn">Submit sprint</button>
+  </form>
+</div>
+{% endif %}
+<table>
+  <thead><tr><th>ID</th><th>Study</th><th>Status</th><th>Idea</th><th>Loop</th><th>Created</th><th></th></tr></thead>
+  <tbody>
+  {% for sp in sprints %}
+    <tr>
+      <td><a href="/dashboard/sprints/{{ sp.id }}">{{ sp.id }}</a></td>
+      <td><a href="/dashboard/studies/{{ sp.study_name }}">{{ sp.study_name }}</a></td>
+      <td><span class="badge badge-{{ sp.status.split(' ')[0] }}">{{ sp.status.split(' ')[0] }}</span>{% if '(' in sp.status %} <span class="dim" style="font-size:0.75rem">{{ sp.status.split('(')[1].rstrip(')') }}</span>{% endif %}</td>
+      <td>{% if sp.idea %}{{ sp.idea[:50] }}{% if sp.idea|length > 50 %}…{% endif %}{% elif sp.loop_id and sp.status not in ('completed', 'failed', 'cancelled') %}<span class="dim" style="font-style:italic">auto-generating idea...</span>{% elif sp.summary %}<span class="dim">{{ sp.summary[:50] }}{% if sp.summary|length > 50 %}…{% endif %}</span>{% endif %}</td>
+      <td>{% if sp.loop_id %}<a href="/dashboard/loops/{{ sp.loop_id }}" class="dim" style="font-size:0.85rem">{{ sp.loop_id }}</a>{% endif %}</td>
+      <td class="dim">{{ sp.created_at }}</td>
+      <td>
+        {% if sp.status.startswith('running') or sp.status == 'submitted' %}
+        <button type="button" class="refresh-btn" title="Refresh status" onclick="event.stopPropagation();var b=this;var row=this.closest('tr');b.innerHTML='<span class=spinning>&#8635;</span>';fetch('/dashboard/sprints/{{ sp.id }}/refresh',{method:'POST',headers:{'X-CSRF-Token':'{{ csrf_token }}'},redirect:'manual'}).then(function(){b.innerHTML='&#10003;';b.style.color='#86efac';setTimeout(function(){b.innerHTML='&#8635;';b.style.color='';},2000)})">&#8635;</button>
+        {% endif %}
+      </td>
+    </tr>
+  {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

researchloop/dashboard/templates/studies.html ADDED Viewed

@@ -0,0 +1,18 @@
+{% extends "base.html" %}
+{% block title %}Studies — ResearchLoop{% endblock %}
+{% block content %}
+<h2>Studies</h2>
+<table>
+  <thead><tr><th>Name</th><th>Cluster</th><th>Description</th><th>Sprints</th></tr></thead>
+  <tbody>
+  {% for s in studies %}
+    <tr>
+      <td><a href="/dashboard/studies/{{ s.name }}">{{ s.name }}</a></td>
+      <td>{{ s.cluster }}</td>
+      <td>{{ s.description or '' }}</td>
+      <td>{{ s.sprint_count }}</td>
+    </tr>
+  {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

researchloop/dashboard/templates/study_detail.html ADDED Viewed

@@ -0,0 +1,64 @@
+{% extends "base.html" %}
+{% block title %}{{ study.name }} — ResearchLoop{% endblock %}
+{% block content %}
+<h2>{{ study.name }}</h2>
+<div class="card">
+  <dl>
+    <dt>Cluster</dt><dd>{{ study.cluster }}</dd>
+    <dt>Description</dt><dd>{{ study.description or '—' }}</dd>
+    <dt>Sprints directory</dt><dd class="dim">{{ study.sprints_dir }}</dd>
+  </dl>
+</div>
+<h3>New sprint</h3>
+<div class="card">
+  {% if error %}<p class="error">{{ error }}</p>{% endif %}
+  {% if success %}<p class="success">{{ success }}</p>{% endif %}
+  <form method="post" action="/dashboard/studies/{{ study.name }}/sprint" onsubmit="var b=this.querySelector('button[type=submit]');if(b.disabled)return false;b.disabled=true;b.textContent='Submitting...';">
+    <input type="hidden" name="csrf_token" value="{{ csrf_token }}">
+    <div class="form-group">
+      <label for="idea">Research idea</label>
+      <textarea name="idea" id="idea" rows="3" placeholder="Describe what this sprint should investigate..." required>{{ prefill_idea or '' }}</textarea>
+    </div>
+    <details style="margin-bottom:0.75rem">
+      <summary class="dim" style="cursor:pointer;font-size:0.85rem">Resource overrides (optional)</summary>
+      <div style="display:flex;gap:0.75rem;margin-top:0.5rem;flex-wrap:wrap">
+        <div class="form-group" style="margin:0">
+          <label for="gpu" style="font-size:0.8rem">GPU</label>
+          <input type="text" name="gpu" id="gpu" placeholder="e.g. gpu:1" style="width:140px;font-size:0.85rem">
+        </div>
+        <div class="form-group" style="margin:0">
+          <label for="mem" style="font-size:0.8rem">Memory</label>
+          <input type="text" name="mem" id="mem" placeholder="e.g. 64G" style="width:80px;font-size:0.85rem">
+        </div>
+        <div class="form-group" style="margin:0">
+          <label for="cpus" style="font-size:0.8rem">CPUs</label>
+          <input type="text" name="cpus" id="cpus" placeholder="e.g. 8" style="width:60px;font-size:0.85rem">
+        </div>
+      </div>
+    </details>
+    <button type="submit" class="btn">Submit sprint</button>
+  </form>
+</div>
+<h3>Recent sprints</h3>
+<table>
+  <thead><tr><th>ID</th><th>Status</th><th>Idea</th><th>Loop</th><th>Created</th><th></th></tr></thead>
+  <tbody>
+  {% for sp in sprints %}
+    <tr>
+      <td><a href="/dashboard/sprints/{{ sp.id }}">{{ sp.id }}</a></td>
+      <td><span class="badge badge-{{ sp.status.split(' ')[0] }}">{{ sp.status.split(' ')[0] }}</span>{% if '(' in sp.status %} <span class="dim" style="font-size:0.75rem">{{ sp.status.split('(')[1].rstrip(')') }}</span>{% endif %}</td>
+      <td>{% if sp.idea %}{{ sp.idea[:60] }}{% if sp.idea|length > 60 %}…{% endif %}{% elif sp.loop_id and sp.status not in ('completed', 'failed', 'cancelled') %}<span class="dim" style="font-style:italic">auto-generating idea...</span>{% elif sp.summary %}<span class="dim">{{ sp.summary[:60] }}{% if sp.summary|length > 60 %}…{% endif %}</span>{% endif %}</td>
+      <td>{% if sp.loop_id %}<a href="/dashboard/loops/{{ sp.loop_id }}" class="dim" style="font-size:0.85rem">{{ sp.loop_id }}</a>{% endif %}</td>
+      <td class="dim">{{ sp.created_at }}</td>
+      <td>
+        {% if sp.status.startswith('running') or sp.status == 'submitted' %}
+        <button type="button" class="refresh-btn" title="Refresh status" onclick="event.stopPropagation();var b=this;b.innerHTML='<span class=spinning>&#8635;</span>';fetch('/dashboard/sprints/{{ sp.id }}/refresh',{method:'POST',headers:{'X-CSRF-Token':'{{ csrf_token }}'},redirect:'manual'}).then(function(){b.innerHTML='&#10003;';b.style.color='#86efac';setTimeout(function(){b.innerHTML='&#8635;';b.style.color='';},2000)})">&#8635;</button>
+        {% endif %}
+      </td>
+    </tr>
+  {% endfor %}
+  </tbody>
+</table>
+{% endblock %}

researchloop/db/__init__.py ADDED Viewed

@@ -0,0 +1,5 @@
+from . import queries
+from .database import Database
+from .migrations import run_migrations
+__all__ = ["Database", "run_migrations", "queries"]

researchloop/db/database.py ADDED Viewed

@@ -0,0 +1,86 @@
+"""Async SQLite database wrapper using aiosqlite with WAL mode."""
+from __future__ import annotations
+from collections.abc import Sequence
+from typing import Any
+import aiosqlite
+class Database:
+    """Lightweight async wrapper around aiosqlite.
+    Enables WAL journal mode for concurrent reads and provides
+    convenience helpers for common query patterns.  On the first
+    call to :meth:`connect`, the schema migrations are executed
+    automatically.
+    """
+    def __init__(self, db_path: str) -> None:
+        self.db_path = db_path
+        self._conn: aiosqlite.Connection | None = None
+    # -- lifecycle ------------------------------------------------------------
+    async def connect(self) -> None:
+        """Open the database connection, enable WAL mode, and run migrations."""
+        if self._conn is not None:
+            return
+        self._conn = await aiosqlite.connect(self.db_path)
+        self._conn.row_factory = aiosqlite.Row
+        # Enable WAL for better concurrent read performance.
+        await self._conn.execute("PRAGMA journal_mode=WAL")
+        # Enforce foreign-key constraints.
+        await self._conn.execute("PRAGMA foreign_keys=ON")
+        # Auto-initialize schema on first connect.
+        from .migrations import run_migrations
+        await run_migrations(self)
+    async def close(self) -> None:
+        """Close the database connection."""
+        if self._conn is not None:
+            await self._conn.close()
+            self._conn = None
+    # -- async context manager ------------------------------------------------
+    async def __aenter__(self) -> Database:
+        await self.connect()
+        return self
+    async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None:
+        await self.close()
+    # -- query helpers --------------------------------------------------------
+    async def execute(self, sql: str, params: Sequence[Any] = ()) -> aiosqlite.Cursor:
+        """Execute a single SQL statement and commit."""
+        assert self._conn is not None, "Database is not connected"
+        cursor = await self._conn.execute(sql, params)
+        await self._conn.commit()
+        return cursor
+    async def fetch_one(
+        self, sql: str, params: Sequence[Any] = ()
+    ) -> dict[str, Any] | None:
+        """Execute *sql* and return the first row as a dict, or ``None``."""
+        assert self._conn is not None, "Database is not connected"
+        cursor = await self._conn.execute(sql, params)
+        row = await cursor.fetchone()
+        if row is None:
+            return None
+        return dict(row)
+    async def fetch_all(
+        self, sql: str, params: Sequence[Any] = ()
+    ) -> list[dict[str, Any]]:
+        """Execute *sql* and return all rows as a list of dicts."""
+        assert self._conn is not None, "Database is not connected"
+        cursor = await self._conn.execute(sql, params)
+        rows = await cursor.fetchall()
+        return [dict(r) for r in rows]