@useshifu/coding-harness 0.3.36 → 0.3.38

package/wizard/wizard.js

@@ -1,49 +1,254 @@
 (() => {
-  const token=location.hash.slice(1);
-  const el=(id)=>document.getElementById(id);
-  let state, choices, busy=false;
-  const names={codex:'Codex',claude_code:'Claude Code',opencode:'OpenCode',cursor:'Cursor'};
-  async function api(path,body){
-    const response=await fetch('/api/'+path,{method:body?'POST':'GET',headers:{'X-Shifu-Wizard':token,...(body?{'Content-Type':'application/json'}:{})},...(body?{body:JSON.stringify(body)}:{})});
-    const result=await response.json();if(!response.ok)throw new Error(result.error||'Setup is unavailable.');return result;
-  }
-  function facts(target,items){el(target).replaceChildren(...items.map(([label,value])=>{const row=document.createElement('div'),dt=document.createElement('dt'),dd=document.createElement('dd');dt.textContent=label;dd.textContent=value;row.append(dt,dd);return row;}));}
-  function settings(value){
-    el('history').value=['0','15','30'].includes(String(value.historyDays))?String(value.historyDays):'custom';el('custom').value=value.historyDays||7;el('custom-label').hidden=el('history').value!=='custom';
-    document.querySelector(`input[name=growth][value=${value.growthFeedback?'on':'off'}]`).checked=true;document.querySelector(`input[name=alignment][value=${value.decisionAlignment?'on':'off'}]`).checked=true;
-    el('key-entry').hidden=value.configured;el('saved-key').hidden=!value.configured;el('harness').textContent=names[value.harness]||value.harness;
-  }
-  function renderProgress(){
-    el('welcome').hidden=true;el('settings').hidden=true;el('review').hidden=true;el('progress').hidden=false;
-    const labels={pending:'Ready to sync your recent work',running:'Syncing your recent work',partial:'Some work is saved; sync will continue',blocked:'Some older work needs your attention',failed:'Sync needs a retry',complete:'Your selected history is saved',skipped:'Ready for new work',empty:'No recent work found in this time range'};
-    const connections={pending:'Connecting',verified:'Connected',reload_required:'Connected · start a new chat',failed:'Reconnect required'};
-    el('progress-title').textContent=state.contextAvailable?'Shifu is ready to help.':labels[state.backfillStatus]||'Setup is continuing.';
-    facts('progress-facts',[['Assistant',names[state.harness]||state.harness],['Connection',connections[state.connectionStatus]||'Checking connection'],['History',labels[state.backfillStatus]||'Checking your recent work']]);
-    el('progress-note').textContent=state.lastErrorCode?'Work already saved is kept. Try again, or ask your assistant to help reconnect Shifu.':state.backfillStatus==='skipped'?'Your next captured work can become context for future questions. No past work was imported.':'You can close this page and keep working. Sync continues in the background and resumes without repeating saved work.';
-    el('resume').hidden=!['failed','partial','blocked','pending'].includes(state.backfillStatus);el('copy').hidden=!state.contextAvailable;el('handoff').hidden=!state.contextAvailable;
-    el('prompt').value=state.resumePrompt||'';el('change').hidden=state.backfillStatus==='running';
-  }
-  el('history').addEventListener('change',()=>{el('custom-label').hidden=el('history').value!=='custom';});
-  el('settings').addEventListener('submit',(event)=>{
-    event.preventDefault();const days=el('history').value==='custom'?Number(el('custom').value):Number(el('history').value);
-    if(!Number.isSafeInteger(days)||days<0||days>36500||(el('history').value==='custom'&&days===0)){el('message').textContent='Choose a positive whole number of custom days, or Start from now.';return;}
-    choices={historyDays:days,growthFeedback:document.querySelector('input[name=growth]:checked').value==='on',decisionAlignment:document.querySelector('input[name=alignment]:checked').value==='on'};
-    facts('summary',[['History',days?`Last ${days} days`:'Start from now'],['Feedback',choices.growthFeedback?'On':'Off'],['Decision reminders',choices.decisionAlignment?'On':'Off']]);
-    el('scope').textContent=days?`Include the last ${days} days of work. Preparing this history uses your coding tool’s model account; cost depends on the amount of work.`:'Connect your assistant and start with new work. Past work will not be imported.';
-    el('apply').textContent=days?'Connect and sync':'Connect Shifu';el('welcome').hidden=true;el('settings').hidden=true;el('review').hidden=false;el('message').textContent='';
+  const token = location.hash.slice(1);
+  const el = (id) => document.getElementById(id);
+  const names = { codex: 'Codex', claude_code: 'Claude Code', opencode: 'OpenCode', cursor: 'Cursor' };
+  const completed = ['complete', 'skipped', 'empty'];
+  let state, choices, busy = false;
+
+  async function api(path, body) {
+    const response = await fetch('/api/' + path, {
+      method: body ? 'POST' : 'GET',
+      headers: { 'X-Shifu-Wizard': token, ...(body ? { 'Content-Type': 'application/json' } : {}) },
+      ...(body ? { body: JSON.stringify(body) } : {}),
+    });
+    const result = await response.json();
+    if (!response.ok) throw new Error(result.error || 'Setup is unavailable.');
+    return result;
+  }
+
+  function facts(target, items) {
+    el(target).replaceChildren(...items.map(([label, value]) => {
+      const row = document.createElement('div'), dt = document.createElement('dt'), dd = document.createElement('dd');
+      dt.textContent = label;
+      dd.textContent = value;
+      row.append(dt, dd);
+      return row;
+    }));
+  }
+
+  function projectScope() {
+    const all = document.querySelector('input[name=project-scope][value=all]').checked;
+    el('project-list').hidden = all;
+    el('project-note').textContent = all ? 'All projects in this coding tool are included, including new projects.' : 'Select the projects whose history and new work you want Shifu to use.';
+  }
+
+  function connectionKeyLink(value) {
+    const link = el('get-key');
+    link.hidden = true;
+    link.removeAttribute('href');
+    if (typeof value.connectionKeyUrl !== 'string' || !Object.hasOwn(names, value.harness)) return;
+    try {
+      const url = new URL(value.connectionKeyUrl);
+      if (url.username || url.password || url.port) return;
+      const desktop = url.protocol === 'shifu:' && url.hostname === 'sources' && url.pathname === '/coding-sessions' && !url.hash;
+      const hosted = url.origin === 'https://app.useshifu.com' && url.pathname === '/' && !url.search && url.hash.startsWith('#/sources/coding-sessions?');
+      if (!desktop && !hosted) return;
+      const params = desktop ? url.searchParams : new URLSearchParams(url.hash.slice('#/sources/coding-sessions?'.length));
+      const expected = desktop ? ['harness', 'profile', 'connection'] : ['harness', 'connection'];
+      if (params.size !== expected.length || expected.some((key) => params.getAll(key).length !== 1) ||
+          params.get('harness') !== value.harness || params.get('connection') !== 'key' ||
+          (desktop && !/^desktop-[a-f0-9]{12}$/.test(params.get('profile') || ''))) return;
+      link.href = url.href;
+      link.target = desktop ? '_self' : '_blank';
+      link.rel = 'noopener noreferrer';
+      link.hidden = false;
+    } catch { /* Keep the manual key instructions when a shortcut is unavailable. */ }
+  }
+
+  function settings(value) {
+    el('history').value = ['0', '15', '30'].includes(String(value.historyDays)) ? String(value.historyDays) : 'custom';
+    el('custom').value = value.historyDays || 7;
+    el('custom-label').hidden = el('history').value !== 'custom';
+    document.querySelector(`input[name=growth][value=${value.growthFeedback ? 'on' : 'off'}]`).checked = true;
+    document.querySelector(`input[name=alignment][value=${value.decisionAlignment ? 'on' : 'off'}]`).checked = true;
+    document.querySelector(`input[name=project-scope][value=${value.projectScope === 'all' ? 'all' : 'selected'}]`).checked = true;
+    const selected = new Set(value.projectRefs || []);
+    const projects = (value.projects || []).map((project) => {
+      const label = document.createElement('label'), checkbox = document.createElement('input'), text = document.createElement('span');
+      checkbox.type = 'checkbox';
+      checkbox.name = 'project';
+      checkbox.value = project.ref;
+      checkbox.checked = selected.has(project.ref);
+      text.textContent = `${project.label} · ${project.sessionCount} sessions`;
+      label.append(checkbox, text);
+      return label;
+    });
+    if (!projects.length) {
+      const empty = document.createElement('p');
+      empty.className = 'note';
+      empty.textContent = 'No projects found yet. Select All projects to include new work as it appears.';
+      projects.push(empty);
+    }
+    el('project-list').replaceChildren(...projects);
+    projectScope();
+    el('schedule-enabled').checked = value.scheduleEnabled ?? value.syncPolicy?.scheduleEnabled ?? true;
+    el('files-enabled').checked = value.filesEnabled ?? true;
+    el('input-folder').value = value.inputFolder || '';
+    el('folder-choice').hidden = !el('files-enabled').checked;
+    el('key-entry').hidden = value.configured;
+    el('saved-key').hidden = !value.configured;
+    el('harness').textContent = names[value.harness] || value.harness;
+    connectionKeyLink(value);
+  }
+
+  function syncLabel(value) {
+    const policy = value.syncPolicy;
+    if ((value.scheduleEnabled ?? policy?.scheduleEnabled) === false) return 'Scheduled work sync off';
+    if (!policy) return 'Every hour · automatic after Start sync';
+    return policy.scheduleEnabled ? `Every ${policy.intervalHours} hours · ${policy.approvalMode}` : 'Scheduled work sync off';
+  }
+
+  function projectLabel(value) {
+    if (value.projectScope === 'all') return 'All projects in this coding tool';
+    const selected = new Set(value.projectRefs || []);
+    return (value.projects || state.projects || []).filter((project) => selected.has(project.ref)).map((project) => project.label).join(', ') || 'Selected projects';
+  }
+
+  function renderProgress() {
+    el('welcome').hidden = true;
+    el('settings').hidden = true;
+    el('review').hidden = true;
+    el('progress').hidden = false;
+    const labels = { pending: 'Waiting to prepare history', running: 'Preparing selected history', partial: 'Part of your selected history is saved', blocked: 'Older unsynced turns need your direction', failed: 'History import needs attention', complete: 'Selected history saved', skipped: 'Initial history skipped', empty: 'No eligible history found', paused: 'Processing paused' };
+    el('progress-title').textContent = state.paused ? 'Local preparation and uploads are paused.' : state.contextAvailable ? 'Your first context is ready.' : labels[state.backfillStatus] || 'Setup is continuing.';
+    facts('progress-facts', [
+      ['Connection', state.connectionStatus === 'reload_required' ? 'Verified · reload assistant required' : state.connectionStatus],
+      ['Projects', projectLabel(state)],
+      ['History', state.historyDays ? `Last ${state.historyDays} days` : 'Start from now'],
+      ['Files', state.filesEnabled ? state.inputFolder : 'Off'],
+      ['Ongoing sync', state.paused ? 'Paused' : syncLabel(state)],
+      ['History import', labels[state.backfillStatus] || state.backfillStatus],
+      ['Accepted', String(state.acceptedSegments || 0) + ' segments'],
+      ['Remaining', String(state.pendingSegments || 0) + ' segments'],
+      ['Blocked', String(state.blockedSegments || 0) + ' sessions'],
+    ]);
+    el('progress-note').textContent = state.paused ? 'No new local preparation or upload requests will start. Work already submitted to Shifu or your model provider may finish; saved work and import progress are preserved.' : state.lastErrorCode === 'preparation_deferred' ? 'This batch reached its model-request limit. Remaining selected history stays pending for the next scheduled run or Retry unfinished history.' : state.lastErrorCode ? 'Accepted work is preserved. Retry the connection or ask your assistant for help; the selected scope will not be expanded automatically.' : state.backfillStatus === 'skipped' ? 'Initial history was skipped. New work in the selected scope can become context for future questions.' : 'You can continue working. The import resumes from saved progress; first context availability is separate from full completion.';
+    el('pause').hidden = state.paused === true;
+    el('resume-all').hidden = state.paused !== true;
+    el('resume').hidden = state.paused === true || !['failed', 'partial', 'blocked', 'pending'].includes(state.backfillStatus);
+    el('copy').hidden = !state.contextAvailable;
+    el('handoff').hidden = !state.contextAvailable;
+    el('prompt').value = state.resumePrompt || '';
+    el('change').hidden = state.backfillStatus === 'running' && !state.paused;
+  }
+
+  el('history').addEventListener('change', () => { el('custom-label').hidden = el('history').value !== 'custom'; });
+  el('files-enabled').addEventListener('change', () => { el('folder-choice').hidden = !el('files-enabled').checked; });
+  document.querySelectorAll('input[name=project-scope]').forEach((input) => input.addEventListener('change', projectScope));
+  el('settings').addEventListener('submit', async (event) => {
+    event.preventDefault();
+    if (busy) return;
+    if (!state.configured && !/^cs_sk_[a-f0-9]{16}_[a-f0-9]{64}$/.test(el('key').value.trim())) {
+      el('message').textContent = `Return to Shifu → Sources → ${names[state.harness] || state.harness}, select Create & copy key (or Copy connection key), then paste it in Connection key below. This is a Shifu connection key, not a model provider key.`;
+      el('key').focus();
+      return;
+    }
+    const historyDays = el('history').value === 'custom' ? Number(el('custom').value) : Number(el('history').value);
+    if (!Number.isSafeInteger(historyDays) || historyDays < 0 || historyDays > 36500 || (el('history').value === 'custom' && historyDays === 0)) {
+      el('message').textContent = 'Choose a positive whole number of custom days, or Start from now.';
+      return;
+    }
+    const projectScope = document.querySelector('input[name=project-scope]:checked').value;
+    const projectRefs = projectScope === 'all' ? [] : [...document.querySelectorAll('input[name=project]:checked')].map((input) => input.value);
+    if (projectScope === 'selected' && !projectRefs.length) {
+      el('message').textContent = 'Select at least one project, or choose All projects.';
+      return;
+    }
+    const filesEnabled = el('files-enabled').checked;
+    const inputFolder = el('input-folder').value.trim();
+    if (filesEnabled && !inputFolder) {
+      el('message').textContent = 'Choose the folder whose files you want parsed into context.';
+      return;
+    }
+    choices = { historyDays, projectScope, projectRefs, scheduleEnabled: el('schedule-enabled').checked, filesEnabled, ...(filesEnabled ? { inputFolder } : {}), growthFeedback: document.querySelector('input[name=growth]:checked').value === 'on', decisionAlignment: document.querySelector('input[name=alignment]:checked').value === 'on' };
+    busy = true;
+    el('review-button').disabled = true;
+    el('message').textContent = 'Checking your selection locally…';
+    try {
+      const preview = await api('preview', choices);
+      if (!Number.isSafeInteger(preview.scopeRevision) || preview.scopeRevision < 1) throw new Error('The selection could not be reviewed. Try again before starting sync.');
+      choices.scopeRevision = preview.scopeRevision;
+      facts('summary', [
+        ['Destination', preview.destination],
+        ['Projects', projectLabel(preview)],
+        ['History', historyDays ? `Last ${historyDays} days · ${preview.sessionCount} sessions` : 'Start from now'],
+        ['Files', filesEnabled ? `${preview.fileCount} files · ${preview.totalFileBytes} bytes` : 'Off'],
+        ...(filesEnabled ? [['Folder', preview.inputFolder], ['Skipped', `${preview.skippedSymlinks || 0} links · ${preview.skippedDirectories || 0} subfolders`]] : []),
+        ['Ongoing sync', syncLabel(preview)],
+        ['Growth feedback', choices.growthFeedback ? 'On' : 'Off'],
+        ['Decision alignment', choices.decisionAlignment ? 'On' : 'Off'],
+      ]);
+      el('scope').textContent = preview.quotaNotice || 'Preparing selected coding text uses your configured model account’s allowance. Review is local; processing begins after Start sync.';
+      el('welcome').hidden = true;
+      el('settings').hidden = true;
+      el('review').hidden = false;
+      el('message').textContent = '';
+    } catch (error) { el('message').textContent = error.message; }
+    finally { busy = false; el('review-button').disabled = false; }
+  });
+  el('edit').addEventListener('click', () => { choices = undefined; el('key-entry').hidden = state.configured; el('saved-key').hidden = !state.configured; el('review').hidden = true; el('welcome').hidden = false; el('settings').hidden = false; });
+  el('apply').addEventListener('click', async () => {
+    if (busy || !choices?.scopeRevision) return;
+    busy = true;
+    el('apply').disabled = true;
+    el('message').textContent = 'Verifying your connection and starting the reviewed selection…';
+    const key = el('key').value.trim();
+    try {
+      state = await api('apply', { ...choices, ...(!state.configured ? { key } : {}) });
+      el('key').value = '';
+      renderProgress();
+      el('message').textContent = '';
+    } catch (error) {
+      try { state = await api('status'); } catch { /* Keep the reviewed selection available during a connection failure. */ }
+      el('message').textContent = error.message;
+    } finally { busy = false; el('apply').disabled = false; }
   });
-  el('edit').addEventListener('click',()=>{el('welcome').hidden=false;el('review').hidden=true;el('settings').hidden=false;});
-  el('apply').addEventListener('click',async()=>{
-    if(busy)return;busy=true;el('apply').disabled=true;el('message').textContent='Verifying your connection and configuring Shifu…';
-    const key=el('key').value.trim();el('key').value='';
-    try{state=await api('apply',{...choices,...(!state.configured?{key}:{})});renderProgress();el('message').textContent='';}
-    catch(error){el('message').textContent=error.message;el('welcome').hidden=false;el('review').hidden=true;el('settings').hidden=false;}
-    finally{busy=false;el('apply').disabled=false;}
+  el('change').addEventListener('click', async () => {
+    try {
+      const abandon = !completed.includes(state.backfillStatus);
+      if (abandon && !window.confirm('Leave the unfinished history selection and review new settings? Saved records and import progress will remain.')) return;
+      state = await api('new', { abandon });
+      choices = undefined;
+      settings(state);
+      el('progress').hidden = true;
+      el('welcome').hidden = false; el('settings').hidden = false;
+    } catch (error) { el('message').textContent = error.message; }
   });
-  el('change').addEventListener('click',async()=>{try{const abandon=!['complete','skipped','empty'].includes(state.backfillStatus);if(abandon&&!window.confirm('Change your history selection? Work already saved will stay in Shifu. This stops the current selection; no older work will be added automatically.'))return;state=await api('new',{abandon});settings(state);el('welcome').hidden=false;el('progress').hidden=true;el('settings').hidden=false;}catch(error){el('message').textContent=error.message;}});
-  el('resume').addEventListener('click',async()=>{try{state=await api('resume',{});renderProgress();el('message').textContent='Sync is continuing. Work already saved will not be sent again.';}catch(error){el('message').textContent=error.message;}});
-  el('copy').addEventListener('click',async()=>{try{await navigator.clipboard.writeText(state.resumePrompt);el('message').textContent='Question copied. Return to your assistant and paste it there. Start a new chat if Shifu is not available yet.';}catch{el('prompt').hidden=false;el('prompt').focus();el('prompt').select();el('message').textContent='Copy the question below and paste it into your assistant.';}});
-  async function refresh(){if(busy||document.hidden)return;try{state=await api('status');if(state.authorized)renderProgress();}catch(error){el('message').textContent=error.message;}}
-  api('status').then(value=>{state=value;settings(value);if(value.authorized)renderProgress();}).catch(error=>{el('settings').hidden=true;el('message').textContent=error.message;});
-  setInterval(refresh,5000);document.addEventListener('visibilitychange',()=>{if(!document.hidden)refresh();});
+  async function processingAction(path) {
+    if (busy) return;
+    busy = true;
+    for (const id of ['pause', 'resume-all', 'resume']) el(id).disabled = true;
+    try {
+      state = await api(path, {});
+      renderProgress();
+      el('message').textContent = path === 'pause' ? 'Local preparation and uploads paused. Accepted work is preserved.' : 'Local preparation and uploads resumed from the saved selection and import progress.';
+    } catch (error) { el('message').textContent = error.message; }
+    finally { busy = false; for (const id of ['pause', 'resume-all', 'resume']) el(id).disabled = false; }
+  }
+  el('pause').addEventListener('click', () => processingAction('pause'));
+  el('resume-all').addEventListener('click', () => processingAction('resume'));
+  el('resume').addEventListener('click', () => processingAction('resume'));
+  el('copy').addEventListener('click', async () => {
+    try { await navigator.clipboard.writeText(state.resumePrompt); el('message').textContent = 'Copied. Reload your assistant if needed, then paste the prompt.'; }
+    catch { el('prompt').hidden = false; el('prompt').focus(); el('prompt').select(); el('message').textContent = 'Copy this prompt and paste it into your assistant.'; }
+  });
+  async function refresh() {
+    if (busy || document.hidden) return;
+    try {
+      const previous = state;
+      state = await api('status');
+      if (state.scopeReviewRequired && !previous?.scopeReviewRequired) {
+        choices = undefined;
+        settings(state);
+        el('progress').hidden = true;
+        el('review').hidden = true;
+        el('welcome').hidden = false; el('settings').hidden = false;
+        el('message').textContent = 'The source selection changed. Review it before processing continues.';
+      } else if (state.authorized && !state.scopeReviewRequired) renderProgress();
+    }
+    catch (error) { el('message').textContent = error.message; }
+  }
+  api('status').then((value) => { state = value; settings(value); if (value.authorized && !value.scopeReviewRequired) renderProgress(); if (value.scopeReviewRequired) el('message').textContent = 'Review your sources and select Start sync to continue. Saved work and import progress are preserved.'; }).catch((error) => { el('settings').hidden = true; el('message').textContent = error.message; });
+  setInterval(refresh, 5000);
+  document.addEventListener('visibilitychange', () => { if (!document.hidden) refresh(); });
 })();