diff --git a/advocate.php b/advocate.php
index 0870fb3..7361fbc 100644
--- a/advocate.php
+++ b/advocate.php
@@ -36,6 +36,12 @@ require_once __DIR__ . '/includes/layout.php';
The agent will frame every sub-question, retrieval pass, and the final brief to argue for the selected party, identifying weaknesses in the opposing position and citing Lovdata statutes, ECHR judgments, and Bufdir guidance.
+ Describe the dispute or case situation
+
+
+
Engine
(~15-45s)
- Describe the dispute or case situation
-
+
+
+
Generated research angles — review & edit
+
The agent will research these angles against the corpus. Edit any question before running to steer retrieval.
+
+
+ Run with these angles
+ Discard & run fresh
+
+
Representing
${escapeHtml(role)}
Brief argues for this party · grounded in Norwegian law and ECHR authorities
-
` : '';
+
+ ${flipRole ? `
+ See the other side?
+ ${escapeHtml(flipRole)}
+ Run counter-brief →
+
` : ''}` : '';
- // 2. Client strengths
+ // 2. Client strengths — with ↗ deep-dive branch button per item
const strengthsHtml = strengths.length ? `
Your strongest arguments
- ${strengths.map((s) => `${renderInlineCitations(escapeHtml(String(s)), sources)} `).join('')}
+ ${strengths.map((s) => `
+ ${renderInlineCitations(escapeHtml(String(s)), sources)}
+ ↗
+ `).join('')}
` : '';
@@ -560,27 +631,27 @@
// 5. Sub-Q report cards
const subQReportsHtml = subs.length ? `
-
-
+
+
What each sub-question agent researched
${subs.length} sub-question${subs.length === 1 ? '' : 's'} framed for ${escapeHtml(role || 'your client')}
-
+
${subs.map((sq, i) => renderSubQReport(sq, i)).join('')}
-
-
+
+
All sources (${sources.length})
Click a card to see the full chunk · external link opens the original article
-
+
${sources.map((s) => renderSourceCard(s)).join('')}
-
+ New query ↑
+ Print
+
${bannerHtml}
${strengthsHtml}
-
Advocate brief
+
+
Advocate brief
+
+
Copy brief
+
Copy arguments
+
↓ .md
+
+
${briefHtml}
+ Restore last session (${ageStr}) — ${escapeHtml(formState.role || '?')} ·
+ “${escapeHtml((formState.query || '').slice(0, 60))}${(formState.query || '').length > 60 ? '…' : ''}”
+
+
+ Restore
+ Dismiss
+
`;
+ els.results.parentNode.insertBefore(banner, els.results);
+ document.getElementById('advRestoreYes').addEventListener('click', () => {
+ banner.remove();
+ restoreSession(result, formState);
+ });
+ document.getElementById('advRestoreNo').addEventListener('click', () => {
+ banner.remove();
+ localStorage.removeItem(CACHE_KEY);
+ });
+ }
+
+ function restoreSession(result, formState) {
+ els.input.value = formState.query || '';
+ updateCharCount();
+ if (formState.role) els.roleSelect.value = formState.role;
+ const radio = els.engineRadios.find((r) => r.value === formState.engine);
+ if (radio) radio.checked = true;
+ if (formState.slices) {
+ els.slices.forEach((btn) => {
+ const on = !!formState.slices[btn.dataset.slice];
+ btn.classList.toggle('is-on', on);
+ btn.setAttribute('aria-pressed', on ? 'true' : 'false');
+ btn.querySelector('.dr-slice__badge').textContent = on ? 'on' : 'off';
+ });
+ }
+ lastResult = result;
+ result.query = formState.query || '';
+ renderResults(result, true);
+ const meta = result.trace_metadata || {};
+ setStatus(`Restored · confidence ${meta.citation_confidence || '?'}`, 'ok');
+ }
+
+ function showSliceHint(echrBtn, ncBtn, echrOff, ncOff) {
+ document.getElementById('advSliceHint')?.remove();
+ const names = [echrOff && 'ECHR', ncOff && 'Norwegian Courts'].filter(Boolean).join(' & ');
+ const hint = document.createElement('p');
+ hint.id = 'advSliceHint';
+ hint.className = 'adv-slice-hint';
+ hint.innerHTML = `${escapeHtml(names)} ${names.includes('&') ? 'are' : 'is'} often valuable for parent/family cases.
+ Enable ${escapeHtml(names)}
+ Dismiss `;
+ document.querySelector('.dr-slice-section')?.after(hint);
+ document.getElementById('advSliceHintEnable').addEventListener('click', () => {
+ if (echrOff) activateSlice(echrBtn);
+ if (ncOff) activateSlice(ncBtn);
+ hint.remove();
+ });
+ document.getElementById('advSliceHintDismiss').addEventListener('click', () => hint.remove());
+ }
+
+ function activateSlice(btn) {
+ if (!btn) return;
+ btn.classList.add('is-on');
+ btn.setAttribute('aria-pressed', 'true');
+ btn.querySelector('.dr-slice__badge').textContent = 'on';
+ }
+
+ function copyToClipboard(text, btn, originalLabel) {
+ navigator.clipboard.writeText(text).then(() => {
+ btn.textContent = 'Copied!';
+ setTimeout(() => { btn.textContent = originalLabel; }, 1500);
+ }).catch(() => {
+ const ta = document.createElement('textarea');
+ ta.value = text;
+ ta.style.cssText = 'position:fixed;opacity:0;top:0;left:0';
+ document.body.appendChild(ta);
+ ta.select();
+ document.execCommand('copy');
+ document.body.removeChild(ta);
+ btn.textContent = 'Copied!';
+ setTimeout(() => { btn.textContent = originalLabel; }, 1500);
+ });
+ }
+
+ function buildExportMarkdown(data) {
+ const role = data.advocate_role || 'Unknown party';
+ const date = new Date().toISOString().slice(0, 10);
+ const strengths = (data.client_strengths || []).map((s) => `- ${s}`).join('\n');
+ const weaknesses = (data.opposing_weaknesses || []).map((w) => `- ${w}`).join('\n');
+ const uncertainty = (data.what_remains_uncertain || []).map((u) => `- ${u}`).join('\n');
+ return [
+ `# Advocate Brief — ${role}`,
+ `**Generated:** ${date}`,
+ '',
+ strengths ? '## Strongest Arguments\n' + strengths : '',
+ '',
+ '## Brief',
+ data.brief_markdown || '',
+ weaknesses ? '\n## Gaps in Opposing Position\n' + weaknesses : '',
+ uncertainty ? '\n## What Remains Uncertain\n' + uncertainty : '',
+ data.next_practical_step ? `\n## Next Practical Step\n${data.next_practical_step}` : '',
+ '',
+ '---',
+ '_Generated by Do Better Norge — Case Advocate_',
+ ].filter((s) => s !== null && s !== '').join('\n');
+ }
+
+ function flipBrief(toRole) {
+ const optionExists = Array.from(els.roleSelect.options).some((o) => o.value === toRole);
+ if (optionExists) {
+ els.roleSelect.value = toRole;
+ if (els.roleCustom) els.roleCustom.classList.add('is-hidden');
+ } else {
+ els.roleSelect.value = '__other__';
+ if (els.roleCustom) {
+ els.roleCustom.classList.remove('is-hidden');
+ els.roleCustom.value = toRole;
+ }
+ }
+ els.form.scrollIntoView({ behavior: 'smooth', block: 'start' });
+ setTimeout(() => els.form.requestSubmit(), 200);
+ }
+
+ function bindPreviewAngles() {
+ if (!els.previewAngles) return;
+ els.previewAngles.addEventListener('click', async () => {
+ const advocateRole = getAdvocateRole();
+ if (!advocateRole) { setStatus('Select who you are representing first.', 'error'); return; }
+ const query = (els.input.value || '').trim();
+ if (!query) { setStatus('Describe the case situation first.', 'error'); return; }
+
+ els.previewAngles.disabled = true;
+ els.previewAngles.textContent = 'Generating angles…';
+ setStatus('Generating research angles (steps 1–2 only, ~10s)…', 'busy');
+
+ try {
+ const res = await fetch('api/generate-subq.php', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ query,
+ language: lang,
+ engine: getEngine(),
+ controls: getControls(),
+ advocate_role: advocateRole,
+ }),
+ credentials: 'same-origin',
+ });
+ const json = await res.json();
+ if (!res.ok || !json.ok) {
+ setStatus(json.message || `Error ${res.status}`, 'error');
+ return;
+ }
+ const sqs = json.sub_questions || [];
+ if (els.subQPreviewList) {
+ els.subQPreviewList.innerHTML = sqs.map((sq, i) => `
+
+
Angle ${i + 1}
+
+ ${sq.rationale ? `
${escapeHtml(sq.rationale)}
` : ''}
+
${escapeHtml(csvLabel)}
`
: '';
- const sortBar = lastTimelineEvents.length > 1 ? `
+ const countBadge = buildTimelineCountBadge(lastTimelineEventsOriginal);
+ const actorChips = buildActorChips(lastTimelineEventsOriginal);
+ const toolbar = buildTimelineToolbar();
+ const sortBar = lastTimelineEventsOriginal.length > 1 ? `
Sort:
${escapeHtml(currentTimelineT('sortDocOrder') || 'Document order')}
${escapeHtml(currentTimelineT('sortChronological') || 'Chronological')}
` : '';
- return `${escapeHtml(data.what_we_found || '')}
${sortBar}${renderTimeline(lastTimelineEvents)}
${csvBtn}`;
+ return `${escapeHtml(data.what_we_found || '')}
${countBadge}${actorChips}${toolbar}${sortBar}${renderTimeline(lastTimelineEvents, false)}
${csvBtn}`;
}
if (data.tool === 'summarize') {
return [
@@ -1533,24 +1581,96 @@ function renderEvidenceItem(item) {
`;
}
-function renderTimeline(events) {
- if (!events.length) {
- return 'No events were identified.
';
+function buildTimelineCountBadge(events) {
+ if (!events.length) return '';
+ const actors = new Set(events.map((e) => e.actor).filter((a) => a && a !== 'unknown'));
+ const isoDates = events.map((e) => e.date || '').filter((d) => /^\d{4}/.test(d)).sort();
+ let rangeStr = '';
+ if (isoDates.length) {
+ const y0 = isoDates[0].slice(0, 4);
+ const y1 = isoDates[isoDates.length - 1].slice(0, 4);
+ rangeStr = y0 === y1 ? ` · ${y0}` : ` · ${y0}–${y1}`;
}
- return `${events.map((ev) => {
+ const ac = actors.size;
+ return `${events.length} event${events.length !== 1 ? 's' : ''}${ac ? ` · ${ac} actor${ac !== 1 ? 's' : ''}` : ''}${rangeStr}
`;
+}
+
+function buildActorChips(events) {
+ const actors = [...new Set(events.map((e) => e.actor).filter((a) => a && a !== 'unknown'))].sort();
+ if (actors.length < 2) return '';
+ const chips = actors.map((a) =>
+ `${escapeHtml(a)} `
+ ).join('');
+ return `${chips}
`;
+}
+
+function buildTimelineToolbar() {
+ return `
+ Hide sources
+
`;
+}
+
+function applyTimelineFilters() {
+ let events = timelineSortMode === 'chrono'
+ ? sortChronological([...lastTimelineEventsOriginal])
+ : [...lastTimelineEventsOriginal];
+ if (activeActorFilters.size > 0) {
+ events = events.filter((e) => activeActorFilters.has(e.actor));
+ }
+ if (timelineSearchTerm) {
+ const q = timelineSearchTerm;
+ events = events.filter((e) =>
+ (e.event || '').toLowerCase().includes(q) ||
+ (e.actor || '').toLowerCase().includes(q) ||
+ (e.source_excerpt || '').toLowerCase().includes(q) ||
+ (e.date || '').toLowerCase().includes(q)
+ );
+ }
+ lastTimelineEvents = events;
+ const container = document.getElementById('timelineListContainer');
+ if (container) container.innerHTML = renderTimeline(events, timelineSortMode === 'chrono');
+}
+
+function renderTimeline(events, grouped = false) {
+ if (!events.length) {
+ return 'No matching events.
';
+ }
+ const MONTH_NAMES = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'];
+ let lastGroupKey = null;
+ const items = events.map((ev) => {
const conf = ev.confidence || 'medium';
- return `
-
+ let groupHeader = '';
+ if (grouped && /^\d{4}-\d{2}/.test(ev.date || '')) {
+ const year = ev.date.slice(0, 4);
+ const mon = ev.date.slice(5, 7);
+ const key = `${year}-${mon}`;
+ if (key !== lastGroupKey) {
+ const prevYear = lastGroupKey ? lastGroupKey.slice(0, 4) : null;
+ const label = (year !== prevYear)
+ ? year
+ : `${MONTH_NAMES[parseInt(mon, 10) - 1] || mon} ${year}`;
+ groupHeader = ` `;
+ lastGroupKey = key;
+ }
+ }
+ const excerptHtml = ev.source_excerpt
+ ? `${escapeHtml(ev.source_excerpt)} `
+ : '';
+ const copyText = [ev.date, ev.actor, ev.event].filter(Boolean).join(' · ');
+ return `${groupHeader}
${escapeHtml(ev.actor || 'unknown actor')}
${escapeHtml(ev.event || '')}
- ${ev.source_excerpt ? `${escapeHtml(ev.source_excerpt)} ` : ''}
+ ${excerptHtml}
`;
- }).join('')} `;
+ }).join('');
+ return `${items} `;
}
function renderFeedbackWidget() {
@@ -1620,9 +1740,9 @@ function setupFeedbackWidget(tool) {
}
function exportTimelineCSV(events) {
- const header = ['Date', 'Time', 'Date Type', 'Actor', 'Event', 'Source Excerpt', 'Confidence'];
+ const header = ['Date', 'End Date', 'Time', 'Date Type', 'Actor', 'Event', 'Source Excerpt', 'Confidence'];
const rows = events.map((ev) => [
- ev.date || '', ev.time || '', ev.date_type || '', ev.actor || '',
+ ev.date || '', ev.end_date || '', ev.time || '', ev.date_type || '', ev.actor || '',
ev.event || '', ev.source_excerpt || '', ev.confidence || '',
]);
const csv = [header, ...rows]
diff --git a/includes/DeepResearchAgent.php b/includes/DeepResearchAgent.php
index 55572dc..24966c2 100644
--- a/includes/DeepResearchAgent.php
+++ b/includes/DeepResearchAgent.php
@@ -33,7 +33,8 @@ final class DbnDeepResearchAgent
?callable $emit = null,
string $advocateRole = '',
?array $priorContext = null,
- string $branchNotes = ''
+ string $branchNotes = '',
+ array $subQuestionsOverride = []
): array {
$seedQuery = trim($seedQuery);
$pastedText = trim($pastedText);
@@ -88,17 +89,26 @@ final class DbnDeepResearchAgent
$this->stepTimings['interpretation'] = $this->elapsedMs($stepStart);
$emitStep('interpretation', 'Query interpretation', $interpretation['detail'], 'complete');
- // STEP 2: Query expansion
- $emitRunning('expansion', 'Query expansion', 'Generating sub-questions…');
+ // STEP 2: Query expansion (or use caller-supplied override)
$stepStart = microtime(true);
- $expansion = $this->expandQueries($seedDescription, $interpretation['brief'], $interpretation['key_signals'], $controls['sub_q_count'], $language, $advocateRole);
- $this->stepTimings['expansion'] = $this->elapsedMs($stepStart);
- $subQuestions = $expansion['questions'];
- $expansionStatus = $expansion['fallback'] ? 'warning' : 'complete';
- $expansionDetail = $expansion['fallback']
- ? 'Could not parse sub-questions; falling back to retrieving on the seed query alone.'
- : sprintf('Generated %d sub-questions to research the corpus from multiple angles.', count($subQuestions));
- $emitStep('expansion', 'Query expansion', $expansionDetail, $expansionStatus);
+ if (!empty($subQuestionsOverride)) {
+ $subQuestions = array_values(array_filter($subQuestionsOverride, fn($sq) =>
+ is_array($sq) && !empty(trim((string)($sq['question'] ?? '')))
+ ));
+ $this->stepTimings['expansion'] = $this->elapsedMs($stepStart);
+ $emitStep('expansion', 'Query expansion',
+ sprintf('Using %d custom sub-question(s) supplied by the user.', count($subQuestions)), 'complete');
+ } else {
+ $emitRunning('expansion', 'Query expansion', 'Generating sub-questions…');
+ $expansion = $this->expandQueries($seedDescription, $interpretation['brief'], $interpretation['key_signals'], $controls['sub_q_count'], $language, $advocateRole);
+ $this->stepTimings['expansion'] = $this->elapsedMs($stepStart);
+ $subQuestions = $expansion['questions'];
+ $expansionStatus = $expansion['fallback'] ? 'warning' : 'complete';
+ $expansionDetail = $expansion['fallback']
+ ? 'Could not parse sub-questions; falling back to retrieving on the seed query alone.'
+ : sprintf('Generated %d sub-questions to research the corpus from multiple angles.', count($subQuestions));
+ $emitStep('expansion', 'Query expansion', $expansionDetail, $expansionStatus);
+ }
// STEP 3: Slice resolution
$emitRunning('slice_resolution', 'Slice resolution', 'Resolving slice toggles to document IDs…');
@@ -1164,6 +1174,50 @@ PROMPT;
return 'low';
}
+ public function generateSubQPreview(
+ string $seedQuery,
+ string $pastedText,
+ string $engine,
+ string $language,
+ array $controls,
+ string $advocateRole = '',
+ ?array $priorContext = null,
+ string $branchNotes = ''
+ ): array {
+ $seedQuery = trim($seedQuery);
+ $pastedText = trim($pastedText);
+ $engine = in_array($engine, ['azure_mini', 'azure_full', 'gpu'], true) ? $engine : 'azure_mini';
+ $language = dbnToolsNormalizeUiLanguage($language);
+ $controls = $this->normalizeControls($controls);
+
+ if ($seedQuery === '' && $pastedText === '') {
+ dbnToolsAbort('Provide a question or pasted text.', 422, 'missing_seed');
+ }
+
+ dbnToolsRequireClient();
+ dbnToolsBootCaveau();
+ $aiPortalRoot = dbnToolsAiPortalRoot();
+ require_once $aiPortalRoot . '/platform/includes/dbn_v6.php';
+
+ $seedDescription = $this->buildSeedDescription($seedQuery, $pastedText, []);
+ $interpretation = $this->interpretSeed($seedDescription, $language, $advocateRole, $priorContext, $branchNotes);
+ $expansion = $this->expandQueries(
+ $seedDescription,
+ $interpretation['brief'],
+ $interpretation['key_signals'],
+ $controls['sub_q_count'],
+ $language,
+ $advocateRole
+ );
+
+ return [
+ 'ok' => true,
+ 'interpretation' => $interpretation,
+ 'sub_questions' => $expansion['questions'],
+ 'fallback' => $expansion['fallback'] ?? false,
+ ];
+ }
+
private function trace(string $label, string $detail, string $status = 'complete'): array
{
return [