spequi 0.1.7 → 0.1.8

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.
@@ -4,8 +4,9 @@ import { planVersions, planChanges } from './studio-plans.mjs';
4
4
  import { renderPlanMarkdown } from './studio-documents.mjs';
5
5
  import { renderCommandPicker } from './commands.mjs';
6
6
  import { renderCreation } from './creation-view.mjs';
7
+ import { changeBranch } from './branches.mjs';
7
8
 
8
- const stages = [['shape', 'Shape spec'], ['finish', 'Validate & archive']];
9
+ const stages = [['shape', 'Plan'], ['finish', 'Workflow']];
9
10
  const labels = { explore: 'Question', 'revise-plan': 'Spec revision', 'update-specs': 'Review feedback', 'plan-next': 'Next artifact', propose: 'Full plan', preview: 'Implementation preview', verify: 'Implementation verification', archive: 'Archive', 'sync-specs': 'Sync specifications', 'create-change': 'New change', 'start-plan': 'New spec', impact: 'File impact' };
10
11
  const statusLabel = value => ({ queued: 'Waiting for agent', running: 'Working', 'awaiting-input': 'Your answer is needed', completed: 'Completed', failed: 'Failed', cancelled: 'Cancelled' }[value] || value);
11
12
  const feedback = '<div data-lifecycle-feedback role="status" aria-live="polite"></div>';
@@ -23,6 +24,8 @@ function question(job, item) {
23
24
  return `<section class="studio-question" ${waiting ? `data-studio-question="${e(item.id)}" tabindex="-1" aria-labelledby="studio-question-${e(item.id)}"` : ''}><p class="studio-question-text" id="studio-question-${e(item.id)}">${e(item.message)}</p>${item.answeredAt ? `<div class="studio-answer"><strong>Your answer</strong><p>${e(item.answer)}</p></div>` : waiting ? `<form data-lifecycle-form id="studio-answer-${item.id}" action="/api/lifecycle/jobs/${job.id}/reply" method="post"><input type="hidden" name="questionId" value="${item.id}">${item.options.map(option => `<label class="studio-choice"><input type="radio" name="choice" value="${e(option)}"><span>${e(option)}</span></label>`).join('')}<label for="studio-reply-${item.id}">${item.options.length ? 'Additional context (optional)' : 'Your answer'}</label><textarea id="studio-reply-${item.id}" name="answer" rows="3" maxlength="6000" ${item.options.length ? '' : 'required'}></textarea><button class="button primary" type="submit">Reply & continue</button>${feedback}</form>` : '<p class="muted">This request is no longer waiting for a reply.</p>'}</section>`;
24
25
  }
25
26
 
27
+ export function jobQuestions(job) { return (job.questions || []).map(item => question(job, item)).join(''); }
28
+
26
29
  export function conversation(jobs, agent = {}) {
27
30
  const visible = jobs.filter(job => !job.hiddenAt);
28
31
  const active = visible.find(job => ['running', 'awaiting-input'].includes(job.status)) || visible.find(job => job.status === 'queued');
@@ -34,10 +37,10 @@ export function conversation(jobs, agent = {}) {
34
37
  const pending = ['queued', 'running', 'awaiting-input'].includes(job.status);
35
38
  const active = ['queued', 'running'].includes(job.status);
36
39
  const ownerConnected = agent.queue?.active?.id === job.id ? agent.queue.active.ownerConnected : agent.connected;
37
- const title = job.status === 'queued' ? agent.queue?.status === 'blocked' ? 'Queue needs attention' : agent.queue?.active ? 'Waiting for the current request' : 'Waiting for your agent' : ownerConnected ? job.preparing ? 'Preparing the isolated workspace' : 'Agent is working' : 'The agent may still be working';
38
- const latest = !ownerConnected && job.status === 'running' ? 'No recent update. You can check back later.' : job.logs.at(-1)?.message || 'Progress will appear here as the agent works.';
39
- const progress = active ? `<div class="studio-progress" role="status"><span class="studio-progress-indicator" ${ownerConnected && job.status === 'running' ? 'data-working' : ''} aria-hidden="true"></span><div><strong>${e(title)}</strong><p>${e(latest)}</p><time datetime="${e(job.updatedAt)}">Updated ${e(new Date(job.updatedAt).toLocaleTimeString())}</time></div></div>` : '';
40
- const body = `${job.message ? `<div class="studio-message studio-user"><strong>You</strong><p>${e(job.message)}</p></div>` : ''}<div class="studio-message studio-agent"><div class="studio-message-heading"><strong>${e(labels[job.action] || job.action)}</strong><span class="${job.status === 'failed' ? 'studio-error' : ''}">${e(statusLabel(job.status))}</span></div>${(job.questions || []).map(item => question(job, item)).join('')}${progress}${job.result ? `<div class="studio-result ${job.status === 'failed' ? 'studio-error' : ''}">${markdown(job.result)}</div>` : ''}<details id="studio-log-${job.id}"><summary>Activity · ${e(new Date(job.updatedAt).toLocaleString())}</summary><ol>${job.logs.slice(-30).map(log => `<li>${e(log.message)}</li>`).join('')}</ol></details>${pending && !(job.status === 'running' && job.origin) ? `<form data-lifecycle-form id="studio-cancel-${job.id}" action="/api/jobs/${job.id}/cancel" method="post" ${job.status === 'running' ? `data-studio-stalled-action data-request-owner="${e(job.id)}" ${ownerConnected || job.origin ? 'hidden' : ''}` : ''}><button type="submit" class="button">${job.status === 'running' ? 'End request' : 'Cancel request'}</button>${job.status === 'running' ? '<p class="studio-blocker">Stop the old agent in your coding tool first. Ending this request does not stop that process or undo its edits.</p>' : ''}${feedback}</form>` : ''}</div>`;
40
+ const title = job.status === 'queued' ? agent.queue?.status === 'blocked' ? 'Queue needs attention' : agent.queue?.active ? 'Waiting for the current request' : 'Waiting for your agent' : ownerConnected ? job.preparing ? 'Preparing the isolated workspace' : 'Agent is working' : 'Your request is in progress';
41
+ const latest = !ownerConnected && job.status === 'running' ? 'This can take a few minutes. The result will appear here when ready. Your CLI may be waiting for a permission or another action.' : job.logs.at(-1)?.message || 'Progress will appear here as the agent works.';
42
+ const progress = active ? `<div class="studio-progress" role="status"><span class="studio-progress-indicator" ${ownerConnected && job.status === 'running' ? 'data-working' : ''} aria-hidden="true"></span><div><strong>${e(title)}</strong><p>${e(latest)}</p><p class="studio-cli-hint">${ownerConnected && job.status === 'running' ? 'If progress pauses, check your CLI for permissions or other actions waiting for you.' : ''}</p><time datetime="${e(job.updatedAt)}">Updated ${e(new Date(job.updatedAt).toLocaleTimeString())}</time></div></div>` : '';
43
+ const body = `${job.message ? `<div class="studio-message studio-user"><strong>You</strong><p>${e(job.message)}</p></div>` : ''}<div class="studio-message studio-agent"><div class="studio-message-heading"><strong>${e(labels[job.action] || job.action)}</strong><span class="${job.status === 'failed' ? 'studio-error' : ''}">${e(statusLabel(job.status))}</span></div>${jobQuestions(job)}${progress}${job.result ? `<div class="studio-result ${job.status === 'failed' ? 'studio-error' : ''}">${markdown(job.result)}</div>` : ''}<details id="studio-log-${job.id}"><summary>Activity · ${e(new Date(job.updatedAt).toLocaleString())}</summary><ol>${job.logs.slice(-30).map(log => `<li>${e(log.message)}</li>`).join('')}</ol></details>${pending && !(job.status === 'running' && job.origin) ? `<form data-lifecycle-form id="studio-cancel-${job.id}" action="/api/jobs/${job.id}/cancel" method="post" ${job.status === 'running' ? `data-studio-stalled-action data-request-owner="${e(job.id)}" ${ownerConnected || job.origin ? 'hidden' : ''}` : ''}><button type="submit" class="button">${job.status === 'running' ? 'End request' : 'Cancel request'}</button>${job.status === 'running' ? '<p class="studio-blocker">Stop the old agent in your coding tool first. Ending this request does not stop that process or undo its edits.</p>' : ''}${feedback}</form>` : ''}</div>`;
41
44
  return `<section class="studio-exchange" id="studio-job-${job.id}">${!pending && index < jobs.length - 1 ? `<details class="studio-history" id="studio-history-${job.id}"><summary><strong>${e(labels[job.action] || job.action)}</strong><span>${e(statusLabel(job.status))} · ${e(new Date(job.updatedAt).toLocaleTimeString())}</span></summary>${body}</details>` : body}</section>`;
42
45
  }).join('');
43
46
  }
@@ -53,45 +56,55 @@ export async function renderStudio({ root, selected, jobs, agent, params = {}, c
53
56
  const option = state.actions[name];
54
57
  return `<div class="studio-action"><form data-lifecycle-form id="studio-action-${e(id)}" action="/api/lifecycle/actions" method="post">${fields(name, selected.id)}<button type="submit" class="button ${primary ? 'primary' : ''}" ${option?.enabled ? '' : 'disabled'}>${e(label || option?.label || name)}</button>${feedback}</form>${option?.reason ? `<p class="studio-blocker">${e(option.reason)}</p>` : ''}</div>`;
55
58
  };
56
- let canvas = '', toolbar = '', footer = '';
59
+ let canvas = '', toolbar = '', footer = '', selectedPlan = '', followComplete = false;
57
60
  if (stage === 'shape') {
58
61
  const versions = await planVersions(root, selected, jobs);
59
62
  const current = versions.current?.documents || {}, previous = versions.previous?.documents || {};
60
63
  const documents = [...new Set([...Object.keys(current), ...Object.keys(previous)])];
61
- const file = documents.includes(params.plan) ? params.plan : params.created === '1' ? documents.find(name => name === 'proposal.md') || documents[0] : documents.find(name => name.startsWith('specs/')) || documents[0];
64
+ const following = state.jobs.find(job => job.id === params.follow && job.action === 'plan-next' && job.status === 'completed');
65
+ const followedFile = following && versions.current?.hash === following.planAfter?.hash ? documents.find(name => !(name in previous)) || documents.find(name => current[name] !== previous[name]) : '';
66
+ followComplete = Boolean(following);
67
+ const file = followedFile || (documents.includes(params.plan) ? params.plan : params.created === '1' ? documents.find(name => name === 'proposal.md') || documents[0] : documents.find(name => name.startsWith('specs/')) || documents[0]);
68
+ selectedPlan = file || '';
62
69
  const changes = versions.previous ? planChanges(previous, current) : [];
63
70
  const newSpec = params.created === '1';
64
71
  const compare = !newSpec && params.compare === '1' && Boolean(versions.previous);
65
- let artifactDocuments = [];
66
- const artifactTabs = state.readiness?.artifacts.filter(item => item.status !== 'skipped').map(item => {
72
+ const files = state.readiness?.artifacts.filter(item => item.status !== 'skipped').map(item => {
67
73
  const paths = state.readiness.artifactPaths[item.id]?.existingOutputPaths || [];
68
- const available = documents.filter(name => paths.some(output => output.replaceAll('\\', '/').endsWith('/' + name)));
69
- if (available.includes(file)) artifactDocuments = available;
70
- return available.length ? stageLink(e(item.id.replaceAll('-', ' ')), { plan: available.includes(file) ? file : available[0], created: params.created }, `studio-artifact-tab ${available.includes(file) ? 'selected' : ''}`, available.includes(file) ? 'aria-current="page"' : '') : `<span class="studio-artifact-tab" aria-disabled="true" title="${e(item.status === 'ready' ? 'Create this artifact next' : 'Complete its planning dependencies first')}">${e(item.id.replaceAll('-', ' '))}<small>Pending</small></span>`;
71
- }).join('') || '';
72
- const files = artifactTabs ? artifactDocuments : documents;
74
+ return documents.filter(name => paths.some(output => output.replaceAll('\\', '/').endsWith('/' + name)));
75
+ }).find(files => files.includes(file)) || documents;
73
76
  const fileHint = files.every(name => name.startsWith('specs/')) ? 'OpenSpec stores each capability in specs/<capability>/spec.md. Select one to review its requirement changes and scenarios.' : 'OpenSpec separates proposals, design, tasks, and capability specs. Select a document to review that part of the plan.';
74
77
  const fileLabel = name => name.replace(/^specs\//, '').replace(/\/spec\.md$/, '').replace(/\.md$/, '');
75
78
  const displayLabel = name => fileLabel(name).replace(/[-_]/g, ' ').replace(/^./, letter => letter.toUpperCase());
76
79
  const filePicker = files.length > 1 ? `<div class="studio-artifact-file-picker"><button type="button" id="studio-plan-file" popovertarget="studio-plan-files" aria-controls="studio-plan-files" aria-expanded="false" aria-label="Choose planning document" aria-describedby="studio-plan-files-help" title="${e(file)}">${icon('file')}<span>${e(displayLabel(file))}</span>${icon('down')}</button><nav id="studio-plan-files" class="studio-artifact-file-menu" popover="auto" data-dropdown-panel aria-label="Planning documents">${files.map(name => stageLink(`<span class="studio-artifact-option-copy"><strong class="studio-artifact-option-heading"><span class="studio-artifact-folder">${e(name.slice(0, name.lastIndexOf('/') + 1))}</span><span class="studio-artifact-filename">${e(name.split('/').at(-1))}</span></strong><small>${e(documentDescription(current[name] ?? previous[name]))}</small></span><span class="studio-artifact-choice-state">${name === file ? icon('check') : ''}</span>`, { plan: name, compare: params.compare }, name === file ? 'selected' : '', `aria-label="${e(name)}" data-dropdown-choice hx-sync="#workspace:replace"${name === file ? ' aria-current="page"' : ''}`)).join('')}<p class="studio-artifact-file-help" id="studio-plan-files-help">${e(fileHint)}</p></nav></div>` : '';
77
- toolbar = artifactTabs || filePicker ? `<div class="studio-artifact-navigation">${artifactTabs ? `<nav class="studio-artifact-tabs" aria-label="Planning artifacts">${artifactTabs}</nav>` : ''}${filePicker}</div>` : '';
80
+ toolbar = filePicker ? `<div class="studio-artifact-navigation">${filePicker}</div>` : '';
78
81
  const summary = changes.length ? `<details class="studio-change-summary" id="studio-change-summary"><summary>${changes.length} ${changes.length === 1 ? 'document changed' : 'documents changed'} in this revision</summary><ul>${changes.map(item => `<li>${stageLink(e(item.file), { stage: 'shape', plan: item.file, compare: params.compare })}<span>${e(item.type)} · +${item.additions} −${item.deletions}</span></li>`).join('')}</ul><p>Highlights mark changed sections.</p><button type="button" class="text-button" data-studio-change-jump>Show first changed section</button></details>` : '';
79
82
  const notice = versions.pending ? '<p class="studio-notice">The agent is updating the plan. The last retained version remains visible until the request finishes.</p>' : versions.failed ? '<p class="studio-notice studio-error">The last planning request failed. Current files may include unfinished edits; review them before continuing.</p>' : '';
80
83
  const document = file in current ? `<article class="prose studio-document">${renderPlanMarkdown(current[file], versions.previous ? previous[file] || '' : undefined)}</article>` : '<p class="studio-empty">This document was removed from the current revision.</p>';
81
- canvas = documents.length ? `${notice}${summary}${compare ? `<div class="studio-comparison"><section><h2>Previous · v${versions.previous.version}</h2><article class="prose studio-document">${file in previous ? markdown(previous[file]) : '<p>This document did not exist in this version.</p>'}</article></section><section><h2>Current · v${versions.current.version}</h2>${document}</section></div>` : document}` : `${notice}<div class="studio-empty"><h1>Shape this change</h1><p>Create the next artifact or generate the full plan, then revise it in the conversation.</p></div>`;
84
+ canvas = documents.length ? `${notice}${summary}${compare ? `<div class="studio-comparison"><section><h2>Previous · v${versions.previous.version}</h2><article class="prose studio-document">${file in previous ? markdown(previous[file]) : '<p>This document did not exist in this version.</p>'}</article></section><section><h2>Current · v${versions.current.version}</h2>${document}</section></div>` : document}` : `${notice}<div class="studio-empty"><h1>Plan this change</h1><p>Create the next artifact or generate the full plan, then revise it in the conversation.</p></div>`;
82
85
  footer = state.error ? action('refresh', 'Retry readiness', true) : !state.readiness?.planningComplete ? action('plan-next', state.readiness?.nextArtifact ? `Create ${state.readiness.nextArtifact}` : 'Create next artifact', true) : action('finish-planning', 'Finish planning', true);
83
86
  canvas += `<details class="studio-more" id="studio-planning-tools"><summary>Planning actions</summary><div class="studio-actions">${action('plan-next')}${action('propose')}${action('refresh', 'Refresh readiness')}</div></details>`;
84
87
 
85
88
  } else {
86
89
  const validation = state.validation;
87
90
  const report = state.jobs.find(job => job.action === 'verify' && job.status === 'completed');
88
- canvas = `<article class="studio-finish"><h1>${selected.archived ? 'Change archived' : 'Validate and finish'}</h1><p>Check the implementation against the spec, then finish this change.</p><section><h2>Specification validation</h2>${validation ? `<p>${badge(validation.stale ? 'Spec changed since validation' : validation.valid ? 'Specification valid' : 'Specification findings', validation.valid && !validation.stale ? 'success' : '')}</p><time>${e(new Date(validation.checkedAt).toLocaleString())}</time><ul>${validation.issues.map(item => `<li>${e(item.level || item.severity || 'Finding')}: ${e(item.message || '')}</li>`).join('')}</ul>` : '<p>No specification validation result saved yet.</p>'}<p class="muted">This checks planning artifacts, not application behavior.</p>${action('validate', 'Validate specification')}</section><section><h2>Implementation verification</h2>${report ? `<p class="muted">${e(new Date(report.updatedAt).toLocaleString())}${state.previewStale || state.result?.appliedAt && report.updatedAt < state.result.appliedAt ? ' · Earlier implementation; run verification again.' : ''}</p><div class="prose studio-document">${markdown(report.result || 'Report completed without a summary.')}</div>` : '<p>No implementation verification report saved yet.</p>'}${action('verify', 'Check implementation')}</section><section><h2>Finish this change</h2><p>Sync updates main specs and keeps the change active. Archive closes the change after the workflow checks its state.</p><div class="studio-actions">${action('sync-specs')}${action('archive')}${state.actions['archive-override']?.enabled ? action('archive-override') : ''}</div></section></article>`;
89
- footer = selected.archived ? '<p>Archived documents and conversation remain available.</p>' : !report || state.previewStale || state.result?.appliedAt && report.updatedAt < state.result.appliedAt ? action('verify', 'Check implementation', true, 'next-verify') : action('archive', 'Archive change', true, 'next-archive');
91
+ const branch = await changeBranch(root, selected.id);
92
+ const step = (number, title, description, status, body) => `<li class="workflow-step" data-step-state="${status === 'Complete' || status === 'Applied' || status === 'Archived' ? 'complete' : 'pending'}"><span class="workflow-step-number" aria-hidden="true">${number}</span><section><div class="workflow-step-heading"><h2>${title}</h2>${badge(status, ['Complete','Applied','Archived'].includes(status) ? 'success' : '')}</div><p>${description}</p>${body}</section></li>`;
93
+ const planStatus = selected.archived || state.readiness?.planningComplete ? 'Complete' : 'In progress';
94
+ const planLink = link('Open planning documents', { change: selected.id, view: 'studio', stage: 'shape' }, 'button');
95
+ const diffLink = link(state.result?.applied ? 'Review applied changes' : state.result ? 'Review file diff' : 'Open Files', { change: selected.id, view: 'preview' }, 'button');
96
+ const validationBody = validation ? `<p>${badge(validation.stale ? 'Plan changed; run again' : validation.valid ? 'Specification valid' : 'Findings to review', validation.valid && !validation.stale ? 'success' : '')}</p><time>${e(new Date(validation.checkedAt).toLocaleString())}</time>${validation.issues.length ? `<ul>${validation.issues.map(item => `<li>${e(item.level || item.severity || 'Finding')}: ${e(item.message || '')}</li>`).join('')}</ul>` : ''}` : '';
97
+ const reportStale = report && (state.previewStale || state.result?.appliedAt && report.updatedAt < state.result.appliedAt);
98
+ const reportBody = report ? `<details class="workflow-report" id="workflow-verification"><summary>${reportStale ? 'Earlier report · run again after changes' : 'Read verification report'}</summary><div class="prose studio-document">${markdown(report.result || 'Report completed without a summary.')}</div></details>` : '';
99
+ const branchForm = selected.archived ? '' : `<details class="workflow-branch" id="workflow-branch"><summary>${icon('git')}<span>Branch: <strong>${e(branch || 'current branch')}</strong></span>${icon('chevron')}</summary><form id="change-branch-form" data-lifecycle-form action="/api/change-branch" method="post"><input type="hidden" name="change" value="${e(selected.id)}"><label for="change-branch">Git branch (optional)</label><div><input id="change-branch" name="branch" maxlength="200" value="${e(branch)}" placeholder="feature/change-name" ${state.pending ? 'disabled' : ''}><button type="submit" class="button" ${state.pending ? 'disabled' : ''}>Save branch</button></div><p>The agent creates or switches to this branch before starting any request, including planning. Existing branches require confirmation.</p>${feedback}</form></details>`;
100
+ canvas = `<article class="studio-finish workflow-guide"><h1>${selected.archived ? 'Change archived' : 'From plan to finished change'}</h1><p>Follow the steps below. File generation only makes changes; run the optional checks when you choose.</p>${branchForm}<ol class="workflow-steps">${step(1, 'Prepare the plan', 'Define what should change in the proposal, specs, design and tasks. Planning stops before application code is changed.', planStatus, planLink)}${step(2, 'Generate, review and apply', 'Generate the spec’s file changes in an isolated copy. Review the diff and its spec references, then apply when ready.', state.result?.applied ? 'Applied' : state.result ? 'Ready to review' : state.pending?.action === 'preview' ? 'Generating' : 'Next', diffLink)}${step(3, 'Validate the specification', 'Optional. Check the planning documents for OpenSpec format and consistency. This does not test application behavior.', validation && !validation.stale && validation.valid ? 'Complete' : 'Optional', validationBody + action('validate', 'Validate specification'))}${step(4, 'Verify the implementation', 'Optional. Ask your agent to compare the implementation against the plan and report gaps. This runs only when you request it.', report && !reportStale ? 'Complete' : 'Optional', reportBody + action('verify', 'Check implementation'))}${step(5, 'Sync the specifications', 'Optional before archive. Merge this change’s requirements into the project’s main specs while keeping the change active.', state.jobs.some(job => job.action === 'sync-specs' && job.status === 'completed') ? 'Complete' : 'Optional', action('sync-specs'))}${step(6, 'Archive the change', 'Close the change when the work is complete. The archive workflow reviews task completion and spec conflicts before proceeding.', selected.archived ? 'Archived' : 'Finish', `<div class="studio-actions">${action('archive')}${state.actions['archive-override']?.enabled ? action('archive-override') : ''}</div>`)}</ol></article>`;
101
+ footer = selected.archived ? '<p>Archived documents and conversation remain available.</p>' : '<p>Choose a step above. Checks run only when you request them.</p>';
102
+
90
103
  }
91
104
  if (state.pending) footer = '<button type="button" class="button" data-studio-conversation-jump>View progress</button>';
92
105
  const latestQuestion = state.pending?.status === 'awaiting-input';
93
106
  const revisionAction = selected.files.length ? 'revise-plan' : 'plan-next';
94
107
  const composer = `<form ${state.pending || selected.archived ? 'hidden' : ''} class="studio-composer" data-lifecycle-form data-studio-composer id="studio-composer" action="/api/lifecycle/actions" method="post">${fields(revisionAction, selected.id)}<label for="studio-message">Describe a revision or ask about this change</label><div class="studio-message-box"><textarea name="message" id="studio-message" rows="2" maxlength="12000" required ${selected.archived || state.pending ? 'disabled' : ''} placeholder="Describe what should change, or type / for commands…"></textarea><div class="studio-composer-end"><fieldset ${selected.archived || state.pending ? 'disabled' : ''}><legend>Conversation intent</legend><label><input type="radio" name="intent" value="${revisionAction}" checked><span>${icon('file')}Revise spec</span></label><label><input type="radio" name="intent" value="explore"><span>${icon('comment')}Ask a question</span></label></fieldset><button type="submit" class="button primary" ${selected.archived || state.pending || state.error ? 'disabled' : ''}>Send ${icon('arrow')}</button></div></div>${state.error || selected.archived || state.pending ? `<p class="studio-blocker">${e(state.error || (selected.archived ? 'This change is archived and read-only.' : 'Answer or finish the current request before sending another message.'))}</p>` : ''}${feedback}</form>`;
95
- const header = `${stage === 'shape' ? `<nav class="studio-stages" aria-label="Build stages">${stages.filter(([id]) => id === 'shape').map(([id, name], index) => stageLink(`<span class="studio-stage-number">${index + 1}</span>${e(name)}`, { stage: id }, `studio-stage ${stage === id ? 'selected' : ''}`, `id="studio-stage-${id}" data-studio-stage="${id}" ${stage === id ? 'aria-current="step"' : ''}`)).join('')}</nav>` : ''}<div class="studio-flow-controls">${renderCommandPicker(state, { icon, planningOnly: stage === 'shape' })}${draft?.creationId ? `<button type="button" class="button danger" data-draft-delete="${e(draft.id)}" data-has-plan="true">Delete draft</button>` : ''}</div>`;
96
- return { header, content: `<section class="studio" id="studio" data-studio data-readiness-pending="${!selected.archived && !state.readiness && !state.error}" data-awaiting-input="${latestQuestion}" data-stage="${stage}" data-pane="${base.pane}"><nav class="studio-mobile-panes" aria-label="Studio panes"><button type="button" data-studio-pane="document" aria-pressed="${base.pane === 'document'}">Document</button><button type="button" data-studio-pane="conversation" aria-pressed="${base.pane === 'conversation'}">Conversation${latestQuestion ? ' · Answer needed' : ''}</button></nav><div class="studio-body" id="studio-body"><section class="studio-canvas" aria-label="${e(stages.find(([id]) => id === stage)[1])} canvas">${toolbar ? `<div class="studio-canvas-toolbar">${toolbar}</div>` : ''}<div class="studio-canvas-body" id="studio-canvas-body">${canvas}</div></section><aside class="studio-conversation" aria-label="Change conversation"><header><div><h2>Conversation</h2><span data-lifecycle-agent-caption>${latestQuestion ? 'Your answer is needed' : agent.connected ? 'Same agent session' : 'Requests wait for your agent'}</span></div><button type="button" class="button studio-expand" data-studio-expand aria-expanded="false" aria-controls="studio-body">${icon('panel')}<span data-studio-expand-label>Expand conversation</span></button></header><div class="studio-thread" id="studio-thread">${conversation(state.jobs, agent)}</div>${composer}</aside></div><footer class="studio-footer"><div><strong>${latestQuestion ? 'Reply in the conversation to continue' : stage === 'shape' ? 'Finish planning to open Review' : selected.archived ? 'This change is archived' : 'Read the checks before archiving'}</strong><span ${latestQuestion ? 'hidden' : ''}>${state.pending ? 'The current request and its progress stay in the conversation.' : stage === 'shape' ? 'Planning documents are ready when all required artifacts have been created.' : 'All finish actions use the existing workflow checks.'}</span></div>${latestQuestion ? '<button type="button" class="button primary" data-studio-question-jump>Answer question</button>' : footer}<div class="studio-footer-feedback" id="studio-action-feedback" role="status" aria-live="polite"></div></footer></section>` };
108
+ const header = `<div class="studio-flow-controls">${renderCommandPicker(state, { icon, planningOnly: stage === 'shape' })}${draft?.creationId ? `<button type="button" class="button danger" data-draft-delete="${e(draft.id)}" data-has-plan="true">Delete draft</button>` : ''}</div>`;
109
+ return { header, plan: selectedPlan, followComplete, content: `<section class="studio" id="studio" data-studio data-readiness-pending="${!selected.archived && !state.readiness && !state.error}" data-awaiting-input="${latestQuestion}" data-stage="${stage}" data-pane="${base.pane}"><nav class="studio-mobile-panes" aria-label="Studio panes"><button type="button" data-studio-pane="document" aria-pressed="${base.pane === 'document'}">Document</button><button type="button" data-studio-pane="conversation" aria-pressed="${base.pane === 'conversation'}">Conversation${latestQuestion ? ' · Answer needed' : ''}</button></nav><div class="studio-body" id="studio-body"><section class="studio-canvas" aria-label="${e(stages.find(([id]) => id === stage)[1])} canvas">${toolbar ? `<div class="studio-canvas-toolbar">${toolbar}</div>` : ''}<div class="studio-canvas-body" id="studio-canvas-body">${canvas}</div></section><aside class="studio-conversation" aria-label="Change conversation"><header><div><h2>Conversation</h2><span data-lifecycle-agent-caption>${latestQuestion ? 'Your answer is needed' : agent.connected ? 'Same agent session' : 'Requests wait for your agent'}</span></div><button type="button" class="button studio-expand" data-studio-expand aria-expanded="false" aria-controls="studio-body">${icon('panel')}<span data-studio-expand-label>Expand conversation</span></button></header><div class="studio-thread" id="studio-thread">${conversation(state.jobs, agent)}</div>${composer}</aside></div><footer class="studio-footer"><div><strong>${latestQuestion ? 'Reply in the conversation to continue' : stage === 'shape' ? 'Finish planning to open Review' : selected.archived ? 'This change is archived' : 'Finish at your own pace'}</strong><span ${latestQuestion ? 'hidden' : ''}>${state.pending ? 'The current request and its progress stay in the conversation.' : stage === 'shape' ? 'Planning documents are ready when all required artifacts have been created.' : 'Validation and verification are optional, separate actions.'}</span></div>${latestQuestion ? '<button type="button" class="button primary" data-studio-question-jump>Answer question</button>' : footer}<div class="studio-footer-feedback" id="studio-action-feedback" role="status" aria-live="polite"></div></footer></section>` };
97
110
  }
package/src/views.mjs CHANGED
@@ -33,6 +33,7 @@ const paths = {
33
33
  spark: '<path d="m12 3 2.5 6.5L21 12l-6.5 2.5L12 21l-2.5-6.5L3 12l6.5-2.5Z"/>',
34
34
  plus: '<path d="M12 5v14M5 12h14"/>',
35
35
  download: '<path d="M12 3v12m-4-4 4 4 4-4M4 16v5h16v-5"/>',
36
+ bell: '<path d="M18 8a6 6 0 0 0-12 0c0 7-3 7-3 9h18c0-2-3-2-3-9"/><path d="M10 21h4"/>',
36
37
  book: '<path d="M12 5C9 2 4 3 2 4v16c3-2 7-2 10 0 3-2 7-2 10 0V4c-2-1-7-2-10 1Zm0 0v15"/>',
37
38
  };
38
39
  export const icon = name => `<svg aria-hidden="true" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.65" stroke-linecap="round" stroke-linejoin="round">${paths[name] || paths.file}</svg>`;
@@ -41,7 +42,7 @@ function link(label, params, className = '', extra = '') { return `<a href="${e(
41
42
  function badge(label, type = '') { return `<span class="badge ${type}">${e(label)}</span>`; }
42
43
  function progressBar(progress) { return `<span class="progress-track" aria-label="${progress.done} of ${progress.total} tasks complete"><span style="width:${progress.total ? Math.round(progress.done / progress.total * 100) : 0}%"></span></span>`; }
43
44
  export function shell(content, data, csrf, params = {}) {
44
- return `<!doctype html><html lang="en" data-theme="enterprise"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="csrf-token" content="${csrf}"><title>${e(data.name)} · Spequi</title><link rel="icon" href="/favicon.svg" type="image/svg+xml"><script src="/assets/app.js" defer></script><script src="/assets/review.js" defer></script><script src="/assets/workflow.js" defer></script><script src="/assets/studio.js" defer></script><script src="/assets/session.js" defer></script><script src="/assets/requests.js" defer></script><link rel="stylesheet" href="/assets/fonts.css"><link rel="stylesheet" href="/assets/app.css"><link rel="stylesheet" href="/assets/diff.css"><link rel="stylesheet" href="/assets/review.css"><link rel="stylesheet" href="/assets/studio.css"></head><body><a class="skip-link" href="#document">Skip to document</a><header class="topbar"><div class="topbar-start"><div class="brand">${icon('layers')}<span>Spequi</span><span class="local-pill">LOCAL</span></div></div><div class="topbar-end"><a class="tool-docs-link" href="/docs" target="_blank" rel="noopener noreferrer" aria-label="Spequi docs and landing page (opens in a new tab)" title="Docs and getting started">${icon('book')}<span>Docs</span></a><button type="button" class="button requests-toggle" data-requests-toggle aria-controls="requests-panel" aria-expanded="false"><span class="requests-icon" aria-hidden="true">${icon('clock')}<span class="requests-attention" data-request-count hidden></span></span>Requests</button><button type="button" id="agent-indicator" class="session-indicator" data-session-toggle aria-expanded="false" aria-controls="agent-connections"><span class="session-agent-icon" aria-hidden="true">${icon('agent')}<i></i></span><span data-session-label>Checking agent</span><span class="session-chevron" aria-hidden="true">${icon('chevron')}</span></button><button type="button" class="session-mcp-button" aria-label="MCP connections" data-session-toggle aria-expanded="false" aria-controls="mcp-connections">${icon('plug')}<span id="mcp-count">MCPs</span></button><button type="button" id="theme-toggle" class="theme-toggle" aria-label="Switch to dark mode" title="Switch to dark mode"><span class="theme-icon-dark">${icon('moon')}</span><span class="theme-icon-light">${icon('sun')}</span></button></div></header><aside id="agent-connections" class="session-panel agent-panel" aria-label="Agent connection" hidden><header><h2>Agent</h2><button type="button" class="icon-button" data-session-close aria-label="Close agent details">${icon('close')}</button></header><div class="agent-summary"><span class="agent-avatar" aria-hidden="true">${icon('agent')}</span><div class="agent-identity"><strong id="session-agent-name">Spequi Agent</strong><p id="session-agent-caption">Checking connection</p></div><span id="session-state" class="agent-state-badge">Checking</span></div><dl class="agent-facts"><div><dt>Last seen</dt><dd><time id="session-last-seen">Not yet</time></dd></div><div><dt>Queue</dt><dd id="session-queue-state">Checking</dd></div></dl><section class="agent-current" data-session-current aria-label="Current request" hidden><div><strong id="session-current-change"></strong><span id="session-current-state"></span></div><p id="session-current-hint"></p></section><section id="session-recovery" class="agent-guidance" aria-label="Next step" hidden><p id="session-recovery-message"></p><p id="session-recovery-detail" hidden></p></section><footer class="agent-panel-actions"><button type="button" class="button" data-session-refresh>Refresh status</button><button type="button" class="text-button" data-session-open-requests>View requests ${icon('arrow')}</button></footer><p data-session-check-result role="status" aria-live="polite" aria-atomic="true"></p></aside><aside id="mcp-connections" class="session-panel mcp-panel" aria-label="MCP connections" hidden><header><div><h2>MCP connections</h2><span id="mcp-panel-state" class="mcp-panel-state">Not reported</span></div><button type="button" class="icon-button" data-session-close aria-label="Close MCP connections">${icon('close')}</button></header><div class="mcp-panel-body"><p id="mcp-report-summary" hidden></p><div class="mcp-empty" data-mcp-empty><span class="mcp-empty-icon" aria-hidden="true">${icon('plug')}</span><div><h3 id="mcp-empty-title">Waiting for connection details</h3><p id="mcp-empty-description">Your agent hasn’t shared its MCP connections yet.</p></div></div><ul id="session-mcps"></ul></div><footer class="mcp-panel-footer"><button type="button" class="text-button" data-mcp-refresh>Refresh status</button><time id="mcp-report-date">Not reported yet</time></footer></aside><aside id="requests-panel" class="requests-panel" aria-label="Requests" hidden><header><h2>Requests</h2><div class="requests-tools"><select data-request-filter aria-label="Filter requests"><option value="inbox" selected>Inbox</option><option value="all">All history</option><option value="active">Active history</option><option value="completed">Completed</option><option value="failed">Failed</option><option value="cancelled">Cancelled</option></select><button type="button" class="icon-button" data-requests-close aria-label="Close requests">${icon('close')}</button></div></header><div data-requests-feedback role="status" aria-live="polite"></div><div data-request-list></div><footer hidden><span data-request-pagination></span><nav data-request-pages aria-label="Request pages" hidden><button class="icon-button" type="button" data-request-page="previous" aria-label="Previous page" title="Previous page">${icon('chevron')}</button><button class="icon-button" type="button" data-request-page="next" aria-label="Next page" title="Next page">${icon('chevron')}</button></nav></footer></aside><dialog id="request-delete-dialog" aria-labelledby="request-delete-title" aria-describedby="request-delete-description request-delete-retention"><form method="dialog"><h2 id="request-delete-title">Delete this request?</h2><p id="request-delete-description">Remove it from request history.</p><label><input type="checkbox" name="reviewData" checked> Also delete its saved preview and that preview’s comments and exports</label><p id="request-delete-retention">Project files, OpenSpec documents, and applied-file backups are kept.</p><div class="dialog-actions"><button value="cancel" class="button">Keep request</button><button value="confirm" class="button danger-solid">Delete request</button></div></form></dialog><dialog id="draft-delete-dialog" aria-labelledby="draft-delete-title" aria-describedby="draft-delete-description draft-delete-retention"><form method="dialog"><h2 id="draft-delete-title">Delete this draft?</h2><p id="draft-delete-description">The saved idea will be removed.</p><label data-delete-plan-choice><input type="checkbox" name="deletePlan"> Also delete the planning files generated from this draft</label><p id="draft-delete-retention">Cancel active requests before deleting. Application source files are kept.</p><div class="dialog-actions"><button value="cancel" class="button">Keep draft</button><button value="confirm" class="button danger-solid">Delete draft</button></div></form></dialog>${content}<div id="toast" role="status" aria-live="polite" aria-atomic="true"></div><dialog id="apply-dialog"><form method="dialog"><h2>Apply this preview?</h2><p>The reviewed files will be written to your project. If any affected file has changed since the preview, the whole operation will stop.</p><div class="dialog-actions"><button value="cancel">Keep reviewing</button><button value="confirm" class="button primary">Apply reviewed files</button></div></form></dialog></body></html>`;
45
+ return `<!doctype html><html lang="en" data-theme="enterprise"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="csrf-token" content="${csrf}"><title>${e(data.name)} · Spequi</title><link rel="icon" href="/favicon.svg" type="image/svg+xml"><script src="/assets/app.js" defer></script><script src="/assets/review.js" defer></script><script src="/assets/workflow.js" defer></script><script src="/assets/studio.js" defer></script><script src="/assets/session.js" defer></script><script src="/assets/requests.js" defer></script><link rel="stylesheet" href="/assets/fonts.css"><link rel="stylesheet" href="/assets/app.css"><link rel="stylesheet" href="/assets/diff.css"><link rel="stylesheet" href="/assets/review.css"><link rel="stylesheet" href="/assets/studio.css"></head><body><a class="skip-link" href="#document">Skip to document</a><header class="topbar"><div class="topbar-start"><div class="brand">${icon('layers')}<span>Spequi</span><span class="local-pill">LOCAL</span></div></div><div class="topbar-end"><a class="tool-docs-link" href="/docs" target="_blank" rel="noopener noreferrer" aria-label="Spequi docs and landing page (opens in a new tab)" title="Docs and getting started">${icon('book')}<span>Docs</span></a><button type="button" class="button requests-toggle" data-requests-toggle aria-controls="requests-panel" aria-expanded="false"><span class="requests-icon" aria-hidden="true">${icon('clock')}<span class="requests-attention" data-request-count hidden></span></span>Requests</button><button type="button" id="agent-indicator" class="session-indicator" data-session-toggle aria-expanded="false" aria-controls="agent-connections"><span class="session-agent-icon" aria-hidden="true">${icon('agent')}<i></i></span><span data-session-label>Checking agent</span><span class="session-chevron" aria-hidden="true">${icon('chevron')}</span></button><button type="button" class="session-mcp-button" aria-label="MCP connections" data-session-toggle aria-expanded="false" aria-controls="mcp-connections">${icon('plug')}<span id="mcp-count">MCPs</span></button><button type="button" class="notification-toggle icon-button" data-notification-toggle popovertarget="notification-settings" aria-controls="notification-settings" aria-expanded="false" aria-label="Desktop notifications" title="Notifications for completed work and questions">${icon('bell')}</button><button type="button" id="theme-toggle" class="theme-toggle" aria-label="Switch to dark mode" title="Switch to dark mode"><span class="theme-icon-dark">${icon('moon')}</span><span class="theme-icon-light">${icon('sun')}</span></button></div></header><aside id="agent-connections" class="session-panel agent-panel" aria-label="Agent connection" hidden><header><h2>Agent</h2><button type="button" class="icon-button" data-session-close aria-label="Close agent details">${icon('close')}</button></header><div class="agent-summary"><span class="agent-avatar" aria-hidden="true">${icon('agent')}</span><div class="agent-identity"><strong id="session-agent-name">Spequi Agent</strong><p id="session-agent-caption">Checking connection</p></div><span id="session-state" class="agent-state-badge">Checking</span></div><dl class="agent-facts"><div><dt>Last seen</dt><dd><time id="session-last-seen">Not yet</time></dd></div><div><dt>Queue</dt><dd id="session-queue-state">Checking</dd></div></dl><section class="agent-current" data-session-current aria-label="Current request" hidden><div><strong id="session-current-change"></strong><span id="session-current-state"></span></div><p id="session-current-hint"></p></section><section id="session-question" aria-label="Agent question" hidden></section><form id="session-cancel-request" data-lifecycle-form method="post" hidden><p>Cancelling frees the queue and keeps existing files.</p><button type="submit" class="button">Cancel request</button><div data-lifecycle-feedback role="status" aria-live="polite"></div></form><section id="session-recovery" class="agent-guidance" aria-label="Next step" hidden><p id="session-recovery-message"></p><p id="session-recovery-detail" hidden></p></section><footer class="agent-panel-actions"><button type="button" class="button" data-session-refresh>Refresh status</button><button type="button" class="text-button" data-session-open-requests>View requests ${icon('arrow')}</button></footer><p data-session-check-result role="status" aria-live="polite" aria-atomic="true"></p></aside><aside id="mcp-connections" class="session-panel mcp-panel" aria-label="MCP connections" hidden><header><div><h2>MCP connections</h2><span id="mcp-panel-state" class="mcp-panel-state">Not reported</span></div><button type="button" class="icon-button" data-session-close aria-label="Close MCP connections">${icon('close')}</button></header><div class="mcp-panel-body"><p id="mcp-report-summary" hidden></p><div class="mcp-empty" data-mcp-empty><span class="mcp-empty-icon" aria-hidden="true">${icon('plug')}</span><div><h3 id="mcp-empty-title">Waiting for connection details</h3><p id="mcp-empty-description">Your agent hasn’t shared its MCP connections yet.</p></div></div><ul id="session-mcps"></ul></div><footer class="mcp-panel-footer"><button type="button" class="text-button" data-mcp-refresh>Refresh status</button><time id="mcp-report-date">Not reported yet</time></footer></aside><aside id="notification-settings" class="notification-settings" popover="auto" data-dropdown-panel data-dropdown-width="320" aria-labelledby="notification-title"><h2 id="notification-title">Stay in the loop</h2><p>Get a desktop notification when your plan or file diff is ready, your agent needs an answer, or a request fails while you’re in another tab.</p><p class="notification-note">Keep this workspace open to receive alerts.</p><p data-notification-message role="status" aria-live="polite"></p><button type="button" class="button primary" data-enable-notifications hidden>Enable notifications</button></aside><aside id="requests-panel" class="requests-panel" aria-label="Requests" hidden><header><h2>Requests</h2><div class="requests-tools"><select data-request-filter aria-label="Filter requests"><option value="inbox" selected>Inbox</option><option value="all">All history</option><option value="active">Active history</option><option value="completed">Completed</option><option value="failed">Failed</option><option value="cancelled">Cancelled</option></select><button type="button" class="icon-button" data-requests-close aria-label="Close requests">${icon('close')}</button></div></header><div data-requests-feedback role="status" aria-live="polite"></div><div data-request-list></div><footer hidden><span data-request-pagination></span><nav data-request-pages aria-label="Request pages" hidden><button class="icon-button" type="button" data-request-page="previous" aria-label="Previous page" title="Previous page">${icon('chevron')}</button><button class="icon-button" type="button" data-request-page="next" aria-label="Next page" title="Next page">${icon('chevron')}</button></nav></footer></aside><dialog id="request-delete-dialog" aria-labelledby="request-delete-title" aria-describedby="request-delete-description request-delete-retention"><form method="dialog"><h2 id="request-delete-title">Delete this request?</h2><p id="request-delete-description">Remove it from request history.</p><label><input type="checkbox" name="reviewData" checked> Also delete its saved preview and that preview’s comments and exports</label><p id="request-delete-retention">Project files, OpenSpec documents, and applied-file backups are kept.</p><div class="dialog-actions"><button value="cancel" class="button">Keep request</button><button value="confirm" class="button danger-solid">Delete request</button></div></form></dialog><dialog id="draft-delete-dialog" aria-labelledby="draft-delete-title" aria-describedby="draft-delete-description draft-delete-retention"><form method="dialog"><h2 id="draft-delete-title">Delete this draft?</h2><p id="draft-delete-description">The saved idea will be removed.</p><label data-delete-plan-choice><input type="checkbox" name="deletePlan"> Also delete the planning files generated from this draft</label><p id="draft-delete-retention">Cancel active requests before deleting. Application source files are kept.</p><div class="dialog-actions"><button value="cancel" class="button">Keep draft</button><button value="confirm" class="button danger-solid">Delete draft</button></div></form></dialog>${content}<div id="toast" role="status" aria-live="polite" aria-atomic="true"></div><dialog id="apply-dialog"><form method="dialog"><h2>Apply this preview?</h2><p>The reviewed files will be written to your project. If any affected file has changed since the preview, the whole operation will stop.</p><div class="dialog-actions"><button value="cancel">Keep reviewing</button><button value="confirm" class="button primary">Apply reviewed files</button></div></form></dialog></body></html>`;
45
46
  }
46
47
  export async function workspace({ root, data, params, jobs, agent, drafts = [], getReadiness, compact = true }) {
47
48
  if (params.view === 'studio' && params.stage === 'implement') params = { ...params, view: 'preview', stage: undefined, pane: undefined };
@@ -90,14 +91,17 @@ export async function workspace({ root, data, params, jobs, agent, drafts = [],
90
91
  }).join('');
91
92
  const sidebar = `<aside class="sidebar" id="navigation"><button class="navigation-close" id="navigation-close" aria-controls="navigation" aria-label="Close project navigation">${icon('close')}</button><div class="project-select">${icon('folder')}<div><strong>${e(data.name)}</strong><small>OpenSpec workspace</small></div>${icon('chevron')}</div>${link(`${icon('plus')}New spec`, { view: 'studio', new: '1' }, 'button new-change-link')}<form class="search" action="/" hx-get="/" hx-target="#workspace" hx-swap="outerHTML" hx-push-url="true">${icon('search')}<input type="hidden" name="change" value="${e(selected?.id || '')}"><input type="hidden" name="view" value="${e(view)}"><input type="hidden" name="doc" value="${e(doc || '')}">${searchContext}<input id="search" hx-include="closest form" name="q" placeholder="Find a change…" aria-label="Find a change" value="${e(params.q || '')}" hx-trigger="input changed delay:300ms, search" hx-get="/" hx-target="#workspace" hx-swap="outerHTML" hx-push-url="true"><kbd>⌘ K</kbd></form><nav aria-label="Project navigation"><div data-project-changes><section data-drafts-navigation ${drafts.length ? '' : 'hidden'}><div class="nav-heading"><span>Drafts</span><span data-draft-count>${drafts.length}</span></div><div data-draft-links>${draftLinks}</div></section><div class="nav-heading"><span>Active changes</span><span>${active.length}</span></div>${active.map(navChange).join('') || '<p class="nav-empty">No matching active changes</p>'}</div>${previewNavigation}<div class="nav-heading separated"><span>Specifications</span><span>${data.specs.length}</span></div>${data.specs.filter(spec => !query || spec.id.toLowerCase().includes(query)).map(spec => link(`${icon('book')}<span>${e(spec.id)}</span>`, { doc: spec.file }, `spec-link ${doc === spec.file ? 'selected' : ''}`)).join('') || '<p class="nav-empty">Specs arrive when a change is synced or archived.</p>'}<div class="nav-heading separated"><span>Archive</span><span>${archived.length}</span></div>${archived.map(navChange).join('') || '<p class="nav-empty">Completed changes live here.</p>'}</nav><footer class="sidebar-community" aria-label="Community and credits"><a class="sidebar-community-invite" href="https://github.com/rahulnjs/spequi" target="_blank" rel="noopener noreferrer">${icon('code')}<span><strong>Make Spequi better</strong><small>Contribute on GitHub</small></span>${icon('arrow')}</a><div class="sidebar-community-credit"><a href="https://github.com/rahulnjs/spequi/issues/new" target="_blank" rel="noopener noreferrer">Share feedback</a><span>Built by <a href="https://github.com/rahulnjs" target="_blank" rel="noopener noreferrer">@rahulnjs</a></span></div></footer></aside>`;
92
93
  const title = view === 'studio' && !selected ? 'New spec' : selected?.title || (doc ? doc.split('/').slice(2, -1).join(' / ') : 'Your specs, in focus.');
93
- const files = selected ? ['proposal.md', 'design.md', 'tasks.md'].map(name => selected.files.find(file => !file.includes('/specs/') && path.basename(file) === name)).filter(Boolean) : [];
94
- const navigation = selected ? `<div class="document-tabs" role="navigation" aria-label="Change documents">${files.map(file => link(`${icon(path.basename(file) === 'tasks.md' ? 'check' : 'file')}<span>${e(path.basename(file, '.md'))}</span>${path.basename(file) === 'tasks.md' ? `<span class="tab-count">${selected.progress.done}/${selected.progress.total}</span>` : ''}`, { change: selected.id, doc: file, view: 'rendered' }, `document-tab ${doc === file && !['preview', 'specs', 'workflow'].includes(view) ? 'active' : ''}`)).join('')}${link(`${icon('git')}<span>Files</span><span class="tab-count">${preview.result?.changes.length || 0}</span>`, { change: selected.id, view: 'preview', job: preview.job?.id }, `document-tab ${view === 'preview' ? 'active' : ''}`, 'data-files-tab hx-sync="#workspace:replace"')}${link('Workflow', { change: selected.id, view: 'workflow' }, `document-tab ${view === 'workflow' ? 'active' : ''}`)}</div>` : '';
95
- let content = '', artifact = null, studioHeader = '';
94
+ let navigation = '';
95
+ let content = '', artifact = null, studioHeader = '', followedArtifact = false;
96
96
  if (studioLayout) {
97
97
  const studio = await renderStudio({ root, selected, jobs, agent, params, changes: data.changes, draft: currentDraft, getReadiness }, { icon, link, badge });
98
- content = studio.content; studioHeader = studio.header;
98
+ content = studio.content; studioHeader = studio.header; followedArtifact = studio.followComplete;
99
+ if (studio.plan) params = { ...params, plan: studio.plan, ...(studio.followComplete ? { follow: undefined, created: undefined } : {}) };
100
+ }
101
+ else if (view === 'preview') {
102
+ content = await renderPreview({ root, params, selected, agent, context: preview, compact: compact && Boolean(selected) }, { icon, link, badge, empty });
103
+ if (preview.followComplete) { params = { ...params, follow: undefined }; followedArtifact = true; }
99
104
  }
100
- else if (view === 'preview') content = await renderPreview({ root, params, selected, agent, context: preview, compact: compact && Boolean(selected) }, { icon, link, badge, empty });
101
105
  else if (view === 'specs' && selected) {
102
106
  const diffs = await requirementDiffs(root, selected);
103
107
  content = `<div class="review-intro"><h2>Specification changes</h2><p>Current requirements alongside this change’s authored deltas. These describe behavior; code previews show the implementation.</p></div>${diffs.length ? diffs.map(diff => `<section class="spec-diff"><div class="diff-file-head">${icon('book')}<strong>${e(diff.capability)}</strong><span class="operation-badges">${diff.operations.map(op => badge(`${op.count} ${op.operation.toLowerCase()}`, op.operation === 'ADDED' ? 'success' : '')).join('')}</span></div><div class="comparison"><section><h3>Current specification</h3><div class="prose small">${diff.current ? markdown(diff.current) : '<p class="muted">New capability. No current specification.</p>'}</div></section><section><h3>Proposed delta</h3><div class="prose small">${markdown(diff.proposed)}</div></section></div></section>`).join('') : empty('No spec deltas yet', 'Propose a change with capability requirements to review its specification changes.', 'book')}`;
@@ -108,13 +112,25 @@ export async function workspace({ root, data, params, jobs, agent, drafts = [],
108
112
  const documentBody = artifact ? `<div data-document-content data-source-hash="${artifact.sourceHash}">${view === 'source' ? renderReviewSource(source, { sourceHash: artifact.sourceHash, comments: notes, icon }) : `<article class="prose document-prose">${renderReviewMarkdown(source, { sourceHash: artifact.sourceHash, comments: notes, icon })}</article>`}</div>${renderDocumentDiscussion({ artifact, change: selected, comments: notes }, { icon })}` : view === 'source' ? `<pre class="source-view"><code>${e(source)}</code></pre>` : `<article class="prose">${markdown(source)}</article>`;
109
113
  content = `<div class="file-toolbar"><span>${icon('file')}<span>${e(doc.replace('openspec/', ''))}</span></span><div class="segmented" aria-label="Document view">${link('Preview', { ...base, view: 'rendered' }, view === 'rendered' ? 'active' : '')}${link('Source', { ...base, view: 'source' }, view === 'source' ? 'active' : '')}<a href="/api/raw?file=${encodeURIComponent(doc)}" download="${e(path.basename(doc))}" title="Download Markdown" aria-label="Download Markdown">${icon('download')}</a></div></div>${documentBody}`;
110
114
  } else content = empty('Your specs, in focus.', 'Initialize OpenSpec in this project, then propose your first change. Its Markdown files will appear here automatically.', 'layers', '<code>openspec init</code>');
115
+ if (selected) {
116
+ const groups = ['proposal', 'specs', 'design', 'tasks'].map(name => ({ name, files: selected.files.filter(file => name === 'specs' ? file.includes('/specs/') : !file.includes('/specs/') && path.basename(file) === `${name}.md`) }));
117
+ const known = new Set(groups.flatMap(group => group.files));
118
+ for (const file of selected.files.filter(file => !known.has(file))) groups.push({ name: path.basename(file, '.md'), files: [file] });
119
+ const prefix = `openspec/changes/${selected.archived ? 'archive/' : ''}${selected.id}/`;
120
+ navigation = `<div class="document-tabs" role="navigation" aria-label="Change documents">${groups.map(group => {
121
+ const file = group.files[0], planning = view === 'studio';
122
+ const active = planning ? group.files.some(file => file.slice(prefix.length) === params.plan) : group.files.includes(doc) && !['preview', 'specs', 'workflow'].includes(view) || group.name === 'specs' && view === 'specs';
123
+ const label = `${icon(group.name === 'tasks' ? 'check' : 'file')}<span>${e(group.name)}</span>${group.name === 'tasks' && file ? `<span class="tab-count">${selected.progress.done}/${selected.progress.total}</span>` : ''}`;
124
+ return file ? link(label, planning ? { change: selected.id, view: 'studio', stage: 'shape', plan: file.slice(prefix.length) } : { change: selected.id, doc: file, view: 'rendered' }, `document-tab ${active ? 'active' : ''}`, active ? 'aria-current="page"' : '') : `<span class="document-tab" aria-disabled="true" title="Create this planning artifact to open it">${label}</span>`;
125
+ }).join('')}${link(`${icon('git')}<span>Files</span><span class="tab-count">${preview.result?.changes.length || 0}</span>`, { change: selected.id, view: 'preview', job: preview.job?.id }, `document-tab ${view === 'preview' ? 'active' : ''}`, 'data-files-tab hx-sync="#workspace:replace"')}${link('Workflow', { change: selected.id, view: 'workflow' }, `document-tab ${view === 'workflow' ? 'active' : ''}`, view === 'workflow' ? 'aria-current="page"' : '')}</div>`;
126
+ }
111
127
  const lastPreview = preview.job;
112
128
  const reviewContext = compact && selected && !studioLayout ? await renderReviewContext({ root, params, selected, context: preview, jobs, agent, artifact, showImpact: view === 'preview' }, { icon, link, badge }) : '';
113
129
  const panel = studioLayout ? '' : `<aside class="inspector" id="review-details" aria-label="Review details">${reviewContext}<section class="inspector-section"><div class="section-title"><h2>Change details</h2>${icon('git')}</div><dl><div><dt>Status</dt><dd>${badge(state.label, state.type)}</dd></div><div><dt>Schema</dt><dd>spec-driven</dd></div><div><dt>Artifacts</dt><dd>${selected?.files.length || 0} files</dd></div></dl>${selected?.progress.total ? `<div class="task-progress"><span>Implementation<strong>${selected.progress.done}<span class="muted"> / ${selected.progress.total}</span></strong></span>${progressBar(selected.progress)}</div>` : ''}</section></aside>`;
114
130
 
115
- const compactBreadcrumbs = `<div class="breadcrumbs"><button class="icon-button mobile-menu" id="navigation-toggle" aria-controls="navigation" aria-label="Toggle project navigation" aria-expanded="false">${icon('menu')}</button><span>${e(data.name)}</span>${icon('chevron')}<span>${selected?.archived ? 'Archive' : 'Changes'}</span>${icon('chevron')}<strong role="heading" aria-level="1" title="${e(title)}">${e(selected?.id || (view === 'studio' ? 'New spec' : ''))}</strong></div>`;
116
- const compactHeader = `<header class="compact-change-header">${compactBreadcrumbs}${view === 'studio' ? studioHeader : navigation + (studioLayout ? studioHeader : '')}${studioLayout ? '' : `<button type="button" class="details-icon-toggle" id="toggle-review-details" data-review-details aria-controls="review-details" aria-expanded="true" aria-label="Hide review details" title="Hide review details">${icon('panel')}</button>`}</header>`;
131
+ const compactBreadcrumbs = `<div class="breadcrumbs"><button class="icon-button mobile-menu" id="navigation-toggle" aria-controls="navigation" aria-label="Toggle project navigation" aria-expanded="false">${icon('menu')}</button><span>${e(data.name)}</span>${icon('chevron')}<span>${selected?.archived ? 'Archive' : 'Changes'}</span>${icon('chevron')}<strong role="heading" aria-level="1" title="${e(title)}">${e(selected?.id || creation?.change || (view === 'studio' ? 'New spec' : ''))}</strong></div>`;
132
+ const compactHeader = `<header class="compact-change-header">${compactBreadcrumbs}${navigation}${studioLayout || view === 'studio' ? studioHeader : ''}${studioLayout ? '' : `<button type="button" class="details-icon-toggle" id="toggle-review-details" data-review-details aria-controls="review-details" aria-expanded="true" aria-label="Hide review details" title="Hide review details">${icon('panel')}</button>`}</header>`;
117
133
  const refreshURL = url({ ...params, draft: view === 'studio' && !selected ? currentDraft.id : params.draft, change: selected?.id, view, doc: ['preview', 'studio', 'workflow'].includes(view) ? undefined : doc, job: view === 'preview' ? preview.job?.id : params.job, file: view === 'preview' ? preview.file?.file : params.file });
118
- return `<div id="workspace" class="workspace ${studioLayout ? 'studio-workspace' : ''} ${view === 'preview' ? 'diff-workspace' : ''} ${compact && selected ? `compact-workspace${studioLayout ? '' : ' review-details-open'}` : ''}" data-creation-complete="${Boolean(created)}" data-request-state="${e(JSON.stringify(jobs.filter(job => !job.hiddenAt && (selected && jobMatchesChange(job, selected) || job.id === params.creation)).map(job => [job.id, job.status])))}" data-change="${e(selected?.id || '')}" data-workspace-mode="${view === 'studio' ? 'build' : 'review'}" data-view="${e(view)}" ${compact ? `data-refresh-url="${e(refreshURL)}"` : ''}>${sidebar}<main class="main" id="document" tabindex="-1">${(compact && selected) || view === 'studio' ? compactHeader : `<div class="breadcrumbs"><button class="icon-button mobile-menu" id="navigation-toggle" aria-controls="navigation" aria-label="Toggle project navigation" aria-expanded="false">${icon('menu')}</button><span>${e(data.name)}</span>${icon('chevron')}<span>${selected?.archived ? 'Archive' : selected ? 'Changes' : 'Specifications'}</span>${selected ? `${icon('chevron')}<strong>${e(selected.id)}</strong>` : ''}</div><div class="change-header"><div><div class="change-title-line"><h1>${e(title)}</h1>${badge(state.label, state.type)}</div><p>${selected ? e(selected.id) : 'A local workspace for intent, implementation, and review.'}</p></div><div class="header-actions">${view === 'preview' ? `<button type="button" class="button" id="toggle-review-details" data-review-details aria-expanded="false" aria-controls="review-details">${icon('layers')}Details</button>` : `${selected ? link(`${icon('git')} Spec changes`, { ...base, view: 'specs' }, `button ${view === 'specs' ? 'selected-button' : ''}`) : ''}${link(`${icon('git')} Files changed${lastPreview ? '<span class="new-dot"></span>' : ''}`, { ...base, view: 'preview', job: lastPreview?.id }, `button ${view === 'preview' ? 'selected-button' : ''}`)}`}</div></div>${navigation}`}<div class="reader ${view === 'preview' || view === 'specs' ? 'review-reader' : ''}">${content}</div><footer class="workspace-footer"><span>${icon('folder')} ${e(data.name)}<span class="footer-divider">/</span>openspec</span><span>${view === 'preview' ? 'Current files compared with an isolated implementation' : 'Markdown is the source of truth'}</span></footer></main>${panel}</div>`;
134
+ return `<div id="workspace" class="workspace ${studioLayout ? 'studio-workspace' : ''} ${view === 'preview' ? 'diff-workspace' : ''} ${compact && selected ? `compact-workspace${studioLayout ? '' : ' review-details-open'}` : ''}" data-creation-complete="${Boolean(created)}" data-artifact-follow-complete="${Boolean(followedArtifact)}" data-request-state="${e(JSON.stringify(jobs.filter(job => !job.hiddenAt && (selected && jobMatchesChange(job, selected) || job.id === params.creation)).map(job => [job.id, job.status])))}" data-change="${e(selected?.id || '')}" data-workspace-mode="${view === 'studio' ? 'build' : 'review'}" data-view="${e(view)}" ${compact ? `data-refresh-url="${e(refreshURL)}"` : ''}>${sidebar}<main class="main" id="document" tabindex="-1">${(compact && selected) || view === 'studio' ? compactHeader : `<div class="breadcrumbs"><button class="icon-button mobile-menu" id="navigation-toggle" aria-controls="navigation" aria-label="Toggle project navigation" aria-expanded="false">${icon('menu')}</button><span>${e(data.name)}</span>${icon('chevron')}<span>${selected?.archived ? 'Archive' : selected ? 'Changes' : 'Specifications'}</span>${selected ? `${icon('chevron')}<strong>${e(selected.id)}</strong>` : ''}</div><div class="change-header"><div><div class="change-title-line"><h1>${e(title)}</h1>${badge(state.label, state.type)}</div><p>${selected ? e(selected.id) : 'A local workspace for intent, implementation, and review.'}</p></div><div class="header-actions">${view === 'preview' ? `<button type="button" class="button" id="toggle-review-details" data-review-details aria-expanded="false" aria-controls="review-details">${icon('layers')}Details</button>` : `${selected ? link(`${icon('git')} Spec changes`, { ...base, view: 'specs' }, `button ${view === 'specs' ? 'selected-button' : ''}`) : ''}${link(`${icon('git')} Files changed${lastPreview ? '<span class="new-dot"></span>' : ''}`, { ...base, view: 'preview', job: lastPreview?.id }, `button ${view === 'preview' ? 'selected-button' : ''}`)}`}</div></div>${navigation}`}<div class="reader ${view === 'preview' || view === 'specs' ? 'review-reader' : ''}">${content}</div><footer class="workspace-footer"><span>${icon('folder')} ${e(data.name)}<span class="footer-divider">/</span>openspec</span><span>${view === 'preview' ? 'Current files compared with an isolated implementation' : 'Markdown is the source of truth'}</span></footer></main>${panel}</div>`;
119
135
  }
120
136
  function empty(title, copy, symbol = 'code', extra = '') { return `<div class="empty-state">${icon(symbol)}<h2>${title}</h2><p>${copy}</p>${extra}</div>`; }