spequi 0.1.6 → 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.
- package/README.md +17 -13
- package/bin/spequi.mjs +12 -1
- package/docs/agent-workflow.md +12 -4
- package/package.json +1 -1
- package/public/app.css +5 -2
- package/public/app.js +120 -9
- package/public/diff.css +41 -6
- package/public/index.html +60 -47
- package/public/requests.js +41 -10
- package/public/session.js +43 -22
- package/public/studio.css +77 -5
- package/public/studio.js +2 -2
- package/public/workflow.js +58 -5
- package/skills/spequi/SKILL.md +4 -4
- package/src/analytics.mjs +11 -6
- package/src/branches.mjs +52 -0
- package/src/commands.mjs +4 -3
- package/src/creation-view.mjs +10 -3
- package/src/diff-view.mjs +2 -2
- package/src/document-view.mjs +1 -1
- package/src/drafts.mjs +4 -4
- package/src/jobs.mjs +17 -8
- package/src/lifecycle.mjs +12 -6
- package/src/preview-view.mjs +21 -14
- package/src/previews.mjs +28 -6
- package/src/project.mjs +3 -2
- package/src/requests.mjs +1 -1
- package/src/server.mjs +14 -9
- package/src/source-preview-view.mjs +4 -4
- package/src/spec-context-view.mjs +3 -1
- package/src/spec-context.mjs +11 -8
- package/src/studio-view.mjs +36 -65
- package/src/views.mjs +39 -20
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,9 +42,12 @@ 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 }) {
|
|
48
|
+
if (params.view === 'studio' && params.stage === 'implement') params = { ...params, view: 'preview', stage: undefined, pane: undefined };
|
|
49
|
+
if (params.view === 'studio' && params.stage === 'finish') params = { ...params, view: 'workflow' };
|
|
50
|
+
if (params.view === 'workflow') params = { ...params, stage: 'finish' };
|
|
47
51
|
if (params.view === 'studio' && params.draft && !params.creation && !params.change) {
|
|
48
52
|
const submitted = drafts.find(item => item.id === params.draft && item.creationId);
|
|
49
53
|
if (submitted) {
|
|
@@ -60,24 +64,24 @@ export async function workspace({ root, data, params, jobs, agent, drafts = [],
|
|
|
60
64
|
const archivedTarget = params.change && data.changes.filter(change => change.archived && /^\d{4}-\d{2}-\d{2}-/.test(change.id) && change.id.slice(11) === params.change).sort((a, b) => b.id.localeCompare(a.id))[0];
|
|
61
65
|
const selected = params.view === 'studio' && params.new === '1' ? null : data.changes.find(change => change.id === params.change) || archivedTarget || (!params.doc ? data.changes.find(change => !change.archived) || data.changes[0] : null);
|
|
62
66
|
const doc = params.doc && data.files.includes(params.doc) ? params.doc : selected?.files[0] || data.specs[0]?.file;
|
|
63
|
-
const view = ['rendered', 'source', 'specs', 'preview', 'studio'].includes(params.view) ? params.view : 'rendered';
|
|
67
|
+
const view = ['rendered', 'source', 'specs', 'preview', 'studio', 'workflow'].includes(params.view) ? params.view : 'rendered';
|
|
68
|
+
const studioLayout = ['studio', 'workflow'].includes(view);
|
|
64
69
|
const state = changeState(selected);
|
|
65
70
|
const preview = await getPreviewContext(root, params, jobs, selected);
|
|
66
71
|
const base = { ...(selected ? { change: selected.id } : {}), ...(doc ? { doc } : {}) };
|
|
67
72
|
const query = (params.q || '').toLowerCase();
|
|
68
73
|
const active = data.changes.filter(change => !change.archived && !draftChanges.has(change.id)), archived = data.changes.filter(change => change.archived);
|
|
69
|
-
const buildFiles = view === 'studio' && params.stage === 'implement';
|
|
70
74
|
const navChange = change => {
|
|
71
75
|
const state = changeState(change);
|
|
72
76
|
const proposal = change.files.find(file => !file.includes('/specs/') && path.basename(file) === 'proposal.md') || change.files[0];
|
|
73
|
-
if (query && !`${change.id} ${change.title} ${change.summary} ${change.files.join(' ')}`.toLowerCase().includes(query)
|
|
77
|
+
if (query && !`${change.id} ${change.title} ${change.summary} ${change.files.join(' ')}`.toLowerCase().includes(query)) return '';
|
|
74
78
|
const item = link(`<span class="nav-icon">${icon(change.archived ? 'clock' : state.complete ? 'check' : 'git')}</span><span class="nav-change"><span>${e(change.id)}</span><small>${change.archived ? 'Archived' : change.progress.total ? `${change.progress.done}/${change.progress.total} tasks${state.complete ? ' · complete' : ''}` : 'Planning'}</small><small data-job-state="${e(change.id)}">${e(jobs.find(job => job.change === change.id && ['queued','running','awaiting-input'].includes(job.status))?.status || '')}</small></span>${selected?.id === change.id ? '<span class="selected-mark"></span>' : ''}`, { change: change.id, doc: proposal, view: draftChanges.has(change.id) ? 'studio' : 'rendered', q: params.q }, `change-link ${state.complete ? 'tasks-complete' : ''} ${selected?.id === change.id ? 'selected' : ''}`);
|
|
75
79
|
|
|
76
|
-
return
|
|
80
|
+
return item;
|
|
77
81
|
};
|
|
78
|
-
const previewNavigation = `<div data-preview-navigation data-preview-placement="
|
|
82
|
+
const previewNavigation = `<div data-preview-navigation data-preview-placement="inline">${view === 'preview' ? changedFilesNavigation(preview, params, selected, { link }) : ''}</div>`;
|
|
79
83
|
const searchContext = view === 'studio' ? ['stage', 'plan', 'compare', 'pane', 'job', 'file', 'mode', 'wrap', 'new', 'creation', 'created', 'draft'].map(name => {
|
|
80
|
-
const value = name === 'draft' && !selected ? currentDraft.id :
|
|
84
|
+
const value = name === 'draft' && !selected ? currentDraft.id : params[name];
|
|
81
85
|
return value ? `<input type="hidden" name="${name}" value="${e(value)}">` : '';
|
|
82
86
|
}).join('') : '';
|
|
83
87
|
const draftLinks = drafts.filter(item => !query || `${item.change} ${item.message}`.toLowerCase().includes(query)).map(item => {
|
|
@@ -85,16 +89,19 @@ export async function workspace({ root, data, params, jobs, agent, drafts = [],
|
|
|
85
89
|
const job = jobs.find(job => job.id === item.creationId);
|
|
86
90
|
return link(`<span class="nav-icon">${icon('draft')}</span><span class="nav-change"><span>${e(item.change || 'Untitled idea')}</span><small>${e(job?.status === 'awaiting-input' ? 'Answer needed' : job?.status === 'running' ? 'Agent planning' : job?.status === 'queued' ? 'Queued' : change ? 'Continue planning' : 'Saved idea')}</small></span>`, change ? { change: change.id, view: 'studio', draft: item.id } : job ? { view: 'studio', new: '1', creation: job.id, draft: item.id } : { view: 'studio', new: '1', draft: item.id }, `change-link draft-link ${draft?.id === item.id ? 'selected' : ''}`);
|
|
87
91
|
}).join('');
|
|
88
|
-
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>${
|
|
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>`;
|
|
89
93
|
const title = view === 'studio' && !selected ? 'New spec' : selected?.title || (doc ? doc.split('/').slice(2, -1).join(' / ') : 'Your specs, in focus.');
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
if (view === 'studio') {
|
|
94
|
+
let navigation = '';
|
|
95
|
+
let content = '', artifact = null, studioHeader = '', followedArtifact = false;
|
|
96
|
+
if (studioLayout) {
|
|
94
97
|
const studio = await renderStudio({ root, selected, jobs, agent, params, changes: data.changes, draft: currentDraft, getReadiness }, { icon, link, badge });
|
|
95
|
-
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; }
|
|
96
104
|
}
|
|
97
|
-
else if (view === 'preview') content = await renderPreview({ root, params, selected, agent, context: preview, compact: compact && Boolean(selected) }, { icon, link, badge, empty });
|
|
98
105
|
else if (view === 'specs' && selected) {
|
|
99
106
|
const diffs = await requirementDiffs(root, selected);
|
|
100
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')}`;
|
|
@@ -105,13 +112,25 @@ export async function workspace({ root, data, params, jobs, agent, drafts = [],
|
|
|
105
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>`;
|
|
106
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}`;
|
|
107
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
|
+
}
|
|
108
127
|
const lastPreview = preview.job;
|
|
109
|
-
const reviewContext = compact && selected &&
|
|
110
|
-
const panel =
|
|
128
|
+
const reviewContext = compact && selected && !studioLayout ? await renderReviewContext({ root, params, selected, context: preview, jobs, agent, artifact, showImpact: view === 'preview' }, { icon, link, badge }) : '';
|
|
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>`;
|
|
111
130
|
|
|
112
|
-
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>`;
|
|
113
|
-
const compactHeader = `<header class="compact-change-header">${compactBreadcrumbs}${
|
|
114
|
-
const refreshURL = url({ ...params, draft: view === 'studio' && !selected ? currentDraft.id : params.draft, change: selected?.id, view, doc: ['preview', 'studio'].includes(view) ? undefined : doc, job: view === 'preview'
|
|
115
|
-
return `<div id="workspace" class="workspace ${
|
|
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>`;
|
|
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 });
|
|
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>`;
|
|
116
135
|
}
|
|
117
136
|
function empty(title, copy, symbol = 'code', extra = '') { return `<div class="empty-state">${icon(symbol)}<h2>${title}</h2><p>${copy}</p>${extra}</div>`; }
|