spequi 0.1.0 → 0.1.1
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/CHANGELOG.md +8 -0
- package/README.md +25 -23
- package/bin/spequi.mjs +51 -18
- package/docs/agent-workflow.md +24 -35
- package/package.json +14 -5
- package/public/app.css +114 -5
- package/public/app.js +119 -19
- package/public/diff.css +1 -1
- package/public/requests.js +328 -0
- package/public/review.css +27 -13
- package/public/review.js +5 -2
- package/public/session.js +134 -23
- package/public/studio.css +120 -22
- package/public/studio.js +2 -11
- package/public/{lifecycle.js → workflow.js} +30 -9
- package/skills/spequi/SKILL.md +11 -6
- package/src/agent-client.mjs +17 -0
- package/src/agent-session.mjs +3 -2
- package/src/analytics.mjs +63 -0
- package/src/commands.mjs +35 -11
- package/src/comment-view.mjs +3 -2
- package/src/creation-view.mjs +7 -7
- package/src/diff-view.mjs +11 -2
- package/src/direct-preview.mjs +4 -3
- package/src/drafts.mjs +83 -0
- package/src/files.mjs +79 -6
- package/src/job-dialogue.mjs +2 -2
- package/src/jobs.mjs +138 -43
- package/src/lifecycle.mjs +18 -23
- package/src/openspec-cli.mjs +5 -5
- package/src/preview-view.mjs +20 -7
- package/src/previews.mjs +6 -2
- package/src/project.mjs +2 -0
- package/src/requests.mjs +80 -0
- package/src/server.mjs +151 -21
- package/src/studio-view.mjs +31 -16
- package/src/views.mjs +39 -23
- package/src/workspace-state.mjs +48 -0
- package/public/lifecycle.css +0 -93
- package/src/lifecycle-view.mjs +0 -58
package/src/studio-view.mjs
CHANGED
|
@@ -14,28 +14,41 @@ const statusLabel = value => ({ queued: 'Waiting for agent', running: 'Working',
|
|
|
14
14
|
const feedback = '<div data-lifecycle-feedback role="status" aria-live="polite"></div>';
|
|
15
15
|
const fields = (action, change) => `<input type="hidden" name="action" value="${e(action)}"><input type="hidden" name="change" value="${e(change)}">`;
|
|
16
16
|
|
|
17
|
+
function documentDescription(text = '') {
|
|
18
|
+
const section = text.match(/^#{1,6}\s+(?:Purpose|Overview|Why|Summary)\s*\r?\n+([\s\S]*?)(?=\n#{1,6}\s|$)/im)?.[1] || text;
|
|
19
|
+
const paragraph = section.split(/\r?\n\s*\r?\n/).map(part => part.trim()).find(part => part && !/^(?:#|```|<!--|[-*]\s|\|)/.test(part)) || 'Open this planning document.';
|
|
20
|
+
const description = paragraph.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1').replace(/<[^>]*>|[*_`]/g, '').replace(/\s+/g, ' ').trim();
|
|
21
|
+
return description.length > 180 ? `${description.slice(0, 177)}…` : description;
|
|
22
|
+
}
|
|
23
|
+
|
|
17
24
|
function question(job, item) {
|
|
18
25
|
const waiting = job.status === 'awaiting-input' && !item.answeredAt && item.id === job.questions.at(-1).id;
|
|
19
|
-
return `<section class="studio-question
|
|
26
|
+
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>`;
|
|
20
27
|
}
|
|
21
28
|
|
|
22
|
-
function conversation(jobs, agent = {}) {
|
|
29
|
+
export function conversation(jobs, agent = {}) {
|
|
30
|
+
const visible = jobs.filter(job => !job.hiddenAt);
|
|
31
|
+
const active = visible.find(job => ['running', 'awaiting-input'].includes(job.status));
|
|
32
|
+
jobs = visible.slice(0, 20);
|
|
33
|
+
if (active && !jobs.includes(active)) jobs = [...jobs.slice(0, 19), active];
|
|
34
|
+
const historyLink = visible.length > jobs.length ? '<p class="studio-conversation-empty">Showing recent requests. <button type="button" class="button" data-requests-toggle>View all requests</button></p>' : '';
|
|
23
35
|
if (!jobs.length) return '<p class="studio-conversation-empty">Describe what you want to change in the spec, or ask a question about the plan.</p>';
|
|
24
|
-
return [...jobs].reverse().map((job, index) => {
|
|
36
|
+
return historyLink + [...jobs].reverse().map((job, index) => {
|
|
25
37
|
const pending = ['queued', 'running', 'awaiting-input'].includes(job.status);
|
|
26
38
|
const active = ['queued', 'running'].includes(job.status);
|
|
27
|
-
const
|
|
39
|
+
const ownerConnected = agent.queue?.active?.id === job.id ? agent.queue.active.ownerConnected : agent.connected;
|
|
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' : 'Waiting for the agent to reconnect';
|
|
28
41
|
const latest = job.logs.at(-1)?.message || 'Progress will appear here as the agent works.';
|
|
29
|
-
const progress = active ? `<div class="studio-progress" role="status"><span class="studio-progress-indicator" ${
|
|
30
|
-
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 ? `<form data-lifecycle-form id="studio-cancel-${job.id}" action="/api/jobs/${job.id}/cancel" method="post" ${job.status === 'running' ? `data-studio-stalled-action ${
|
|
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><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>${(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 stalled 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>`;
|
|
31
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>`;
|
|
32
45
|
}).join('');
|
|
33
46
|
}
|
|
34
47
|
|
|
35
|
-
export async function renderStudio({ root, selected, jobs, agent, params = {}, changes = [] }, helpers) {
|
|
48
|
+
export async function renderStudio({ root, selected, jobs, agent, params = {}, changes = [], draft, getReadiness }, helpers) {
|
|
36
49
|
const { icon, link, badge } = helpers;
|
|
37
|
-
if (!selected) return renderCreation({jobs,params,agent,changes},{...helpers,conversation: items => conversation(items, agent)});
|
|
38
|
-
const state = await lifecycleState(root, selected.id, { jobs });
|
|
50
|
+
if (!selected) return renderCreation({jobs,params,agent,changes,draft},{...helpers,conversation: items => conversation(items, agent)});
|
|
51
|
+
const state = await lifecycleState(root, selected.id, { jobs, selected, getReadiness });
|
|
39
52
|
const stage = stages.some(([id]) => id === params.stage) ? params.stage : 'shape';
|
|
40
53
|
const base = { change: selected.id, view: 'studio', stage, q: params.q, created: params.created, pane: params.pane === 'conversation' ? 'conversation' : 'document' };
|
|
41
54
|
const stageLink = (label, values = {}, classes = '', extra = '') => link(label, { ...base, ...values }, classes, extra);
|
|
@@ -43,7 +56,7 @@ export async function renderStudio({ root, selected, jobs, agent, params = {}, c
|
|
|
43
56
|
const option = state.actions[name];
|
|
44
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>`;
|
|
45
58
|
};
|
|
46
|
-
let canvas = '', toolbar = '', footer = ''
|
|
59
|
+
let canvas = '', toolbar = '', footer = '';
|
|
47
60
|
if (stage === 'shape') {
|
|
48
61
|
const versions = await planVersions(root, selected, jobs);
|
|
49
62
|
const current = versions.current?.documents || {}, previous = versions.previous?.documents || {};
|
|
@@ -53,15 +66,17 @@ export async function renderStudio({ root, selected, jobs, agent, params = {}, c
|
|
|
53
66
|
const newSpec = params.created === '1';
|
|
54
67
|
const compare = !newSpec && params.compare === '1' && Boolean(versions.previous);
|
|
55
68
|
let artifactDocuments = [];
|
|
56
|
-
context = file || 'the plan';
|
|
57
69
|
const artifactTabs = state.readiness?.artifacts.filter(item => item.status !== 'skipped').map(item => {
|
|
58
70
|
const paths = state.readiness.artifactPaths[item.id]?.existingOutputPaths || [];
|
|
59
71
|
const available = documents.filter(name => paths.some(output => output.replaceAll('\\', '/').endsWith('/' + name)));
|
|
60
72
|
if (available.includes(file)) artifactDocuments = available;
|
|
61
73
|
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>`;
|
|
62
74
|
}).join('') || '';
|
|
63
|
-
const
|
|
64
|
-
|
|
75
|
+
const files = artifactTabs ? artifactDocuments : documents;
|
|
76
|
+
const fileLabel = name => name.replace(/^specs\//, '').replace(/\/spec\.md$/, '').replace(/\.md$/, '');
|
|
77
|
+
const displayLabel = name => fileLabel(name).replace(/[-_]/g, ' ').replace(/^./, letter => letter.toUpperCase());
|
|
78
|
+
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" 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('')}</nav></div>` : '';
|
|
79
|
+
toolbar = artifactTabs || filePicker ? `<div class="studio-artifact-navigation">${artifactTabs ? `<nav class="studio-artifact-tabs" aria-label="Planning artifacts">${artifactTabs}</nav>` : ''}${filePicker}</div>` : '';
|
|
65
80
|
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>` : '';
|
|
66
81
|
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>' : '';
|
|
67
82
|
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>';
|
|
@@ -86,8 +101,8 @@ export async function renderStudio({ root, selected, jobs, agent, params = {}, c
|
|
|
86
101
|
}
|
|
87
102
|
if (state.pending) footer = '<button type="button" class="button" data-studio-conversation-jump>View progress</button>';
|
|
88
103
|
const latestQuestion = state.pending?.status === 'awaiting-input';
|
|
89
|
-
const status = selected.archived ? 'Archived' : latestQuestion ? 'Your answer is needed' : state.pending ? !agent.connected && state.pending.status === 'running' ? 'Agent needs reconnect' : statusLabel(state.pending.status) : stage === 'shape' ? state.error ? 'Readiness unavailable' : state.readiness?.planningComplete ? 'Plan ready' : 'Planning' : stage === 'implement' ? state.previewStale ? 'Preview needs refresh' : state.result?.applied ? 'Changes applied' : state.result ? 'Preview ready' : 'Preview needed' : 'Review the final result';
|
|
90
104
|
const revisionAction = selected.files.length ? 'revise-plan' : 'plan-next';
|
|
91
|
-
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)}<
|
|
92
|
-
|
|
105
|
+
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>`;
|
|
106
|
+
const header = `<nav class="studio-stages" aria-label="Build stages">${stages.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 })}${draft?.creationId ? `<button type="button" class="button danger" data-draft-delete="${e(draft.id)}" data-has-plan="true">Delete draft</button>` : ''}</div>`;
|
|
107
|
+
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' ? 'Review the plan, then preview code' : stage === 'implement' ? 'Review the exact changes before applying' : 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' ? 'Spec revisions update documents; code generation is a separate step.' : stage === 'implement' ? 'Application uses the reviewed files and checks for conflicts.' : '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>` };
|
|
93
108
|
}
|
package/src/views.mjs
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import path from 'node:path';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
2
3
|
import { renderReviewMarkdown, renderReviewSource, renderDocumentDiscussion } from './document-view.mjs';
|
|
3
4
|
import { documentHash, isCommentableArtifact, artifactReviewID, listComments } from './review-store.mjs';
|
|
4
|
-
import { escape as e, markdown, readArtifact, requirementDiffs, changeState } from './specs.mjs';
|
|
5
|
+
import { escape as e, markdown, readArtifact, requirementDiffs, changeState, jobMatchesChange } from './specs.mjs';
|
|
5
6
|
import { renderReviewContext } from './review-view.mjs';
|
|
6
7
|
import { getPreviewContext, renderPreview, changedFilesNavigation } from './preview-view.mjs';
|
|
7
|
-
import { renderLifecycle } from './lifecycle-view.mjs';
|
|
8
8
|
import { renderStudio } from './studio-view.mjs';
|
|
9
9
|
|
|
10
10
|
const paths = {
|
|
@@ -19,10 +19,12 @@ const paths = {
|
|
|
19
19
|
layers: '<path d="m12 3 9 5-9 5-9-5 9-5Z"/><path d="m3 12 9 5 9-5M3 16l9 5 9-5"/>',
|
|
20
20
|
folder: '<path d="M3 7V5a1 1 0 0 1 1-1h5l2 3h9a1 1 0 0 1 1 1v11H3Z"/>',
|
|
21
21
|
file: '<path d="M14 2H5v20h14V7Z"/><path d="M14 2v6h5M8 12h8M8 16h6"/>',
|
|
22
|
+
draft: '<path d="M10 22H6a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h8l6 6v4"/><path d="M14 2v6h6"/><path d="m16 22 6-6a2.12 2.12 0 0 0-3-3l-6 6-1 4Z"/><path d="m18 14 3 3"/>',
|
|
22
23
|
check: '<path d="m5 12 4 4L19 6"/>',
|
|
23
24
|
arrow: '<path d="M5 12h14m-5-5 5 5-5 5"/>',
|
|
24
25
|
git: '<circle cx="6" cy="5" r="3"/><circle cx="18" cy="6" r="3"/><circle cx="6" cy="19" r="3"/><path d="M6 8v8m12-7c0 7-12 1-12 7"/>',
|
|
25
26
|
search: '<circle cx="10.5" cy="10.5" r="6.5"/><path d="m16 16 5 5"/>',
|
|
27
|
+
agent: '<path d="M9 17H7A5 5 0 0 1 7 7h2m6 0h2a5 5 0 0 1 0 10h-2M8 12h8"/>',
|
|
26
28
|
clock: '<circle cx="12" cy="12" r="9"/><path d="M12 7v5l3 2"/>',
|
|
27
29
|
chevron: '<path d="m9 5 7 7-7 7"/>',
|
|
28
30
|
close: '<path d="m6 6 12 12M6 18 18 6"/>',
|
|
@@ -39,45 +41,59 @@ function link(label, params, className = '', extra = '') { return `<a href="${e(
|
|
|
39
41
|
function badge(label, type = '') { return `<span class="badge ${type}">${e(label)}</span>`; }
|
|
40
42
|
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>`; }
|
|
41
43
|
export function shell(content, data, csrf, params = {}) {
|
|
42
|
-
|
|
43
|
-
const build = params.view === 'studio';
|
|
44
|
-
const modes = `<nav class="workspace-modes" aria-label="Workspace mode">${[['review', 'Review', 'Inspect & comment', 'rendered', 'Read specs, inspect code changes, and leave feedback.'], ['build', 'Build', 'Plan & implement', 'studio', 'Shape a spec with your agent, preview implementation, then validate and archive.']].map(([mode, label, description, view, help]) => link(`<span class="workspace-mode-label">${label}</span><span class="workspace-mode-description">${e(description)}</span>`, { change: selected, view, q: params.q }, `workspace-mode ${build === (mode === 'build') ? 'selected' : ''}`, `data-workspace-mode="${mode}" title="${e(help)}" aria-current="${build === (mode === 'build') ? 'page' : 'false'}"`)).join('')}</nav>`;
|
|
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/lifecycle.js" defer></script><script src="/assets/studio.js" defer></script><script src="/assets/session.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/lifecycle.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></div>${modes}</div><div class="topbar-end"><button type="button" id="agent-indicator" class="session-indicator" data-session-toggle aria-expanded="false" aria-controls="agent-connections"><i></i><span data-session-label>Checking agent</span></button><button type="button" class="session-mcp-button" aria-label="MCP connections" data-session-toggle aria-expanded="false" aria-controls="agent-connections">${icon('plug')}<span id="mcp-count">MCPs</span></button><span class="connection server-connection" id="connection" title="Browser connection to the local server">Connecting</span><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" aria-label="Agent and MCP connections" hidden><header><h2>Agent & connections</h2><button type="button" class="icon-button" data-session-close aria-label="Close connection details">${icon('close')}</button></header><p class="session-panel-state" data-session-label>Checking agent</p><strong id="session-agent-name"></strong><p id="session-last-seen"></p><section id="session-recovery" hidden><h3>Reconnect your agent</h3><p>Return to the coding session that opened this app and resume the <code>spequi</code> skill. In Codex use <code>$spequi</code>; in compatible CLIs use <code>/spequi</code> or <code>/spequi</code>.</p><p>Your questions and requests are saved. If the old agent has stopped, end its stalled request in the conversation before retrying. Reconnecting does not automatically restart a request.</p><button type="button" class="button" data-session-refresh>Check connection</button></section><h3>Session MCPs</h3><p id="mcp-report-summary">This agent has not reported its MCP connections.</p><ul id="session-mcps"></ul><p id="mcp-report-date"></p></aside>${content}<div id="toast" role="status" aria-live="polite"></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>`;
|
|
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"><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>`;
|
|
46
45
|
}
|
|
47
|
-
export async function workspace({ root, data, params, jobs, agent, compact = true }) {
|
|
46
|
+
export async function workspace({ root, data, params, jobs, agent, drafts = [], getReadiness, compact = true }) {
|
|
47
|
+
if (params.view === 'studio' && params.draft && !params.creation && !params.change) {
|
|
48
|
+
const submitted = drafts.find(item => item.id === params.draft && item.creationId);
|
|
49
|
+
if (submitted) {
|
|
50
|
+
if (jobs.some(job => job.id === submitted.creationId && job.action === 'start-plan')) params = { ...params, new: '1', creation: submitted.creationId };
|
|
51
|
+
else if (data.changes.some(change => change.id === submitted.change && !change.archived)) params = { ...params, new: '', change: submitted.change, stage: 'shape' };
|
|
52
|
+
}
|
|
53
|
+
}
|
|
48
54
|
const creation = params.creation && jobs.find(job => job.id === params.creation && job.action === 'start-plan');
|
|
49
55
|
const created = creation?.status === 'completed' && data.changes.some(change => change.id === creation.change && !change.archived);
|
|
50
56
|
if (created) params = { ...params, change: creation.change, view: 'studio', stage: 'shape', new: '', creation: '', created: '1', pane: 'document' };
|
|
57
|
+
const draft = drafts.find(item => item.id === params.draft || item.creationId && item.creationId === params.creation || item.creationId && item.change === params.change);
|
|
58
|
+
const currentDraft = draft || { id: typeof params.draft === 'string' && /^[a-zA-Z0-9_-]{1,128}$/.test(params.draft) ? params.draft : randomUUID() };
|
|
59
|
+
const draftChanges = new Set(drafts.filter(item => item.creationId).map(item => item.change));
|
|
51
60
|
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];
|
|
52
|
-
const selected =
|
|
61
|
+
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);
|
|
53
62
|
const doc = params.doc && data.files.includes(params.doc) ? params.doc : selected?.files[0] || data.specs[0]?.file;
|
|
54
|
-
const view = ['rendered', 'source', 'specs', 'preview', '
|
|
63
|
+
const view = ['rendered', 'source', 'specs', 'preview', 'studio'].includes(params.view) ? params.view : 'rendered';
|
|
55
64
|
const state = changeState(selected);
|
|
56
65
|
const preview = await getPreviewContext(root, params, jobs, selected);
|
|
57
66
|
const base = { ...(selected ? { change: selected.id } : {}), ...(doc ? { doc } : {}) };
|
|
58
67
|
const query = (params.q || '').toLowerCase();
|
|
59
|
-
const active = data.changes.filter(change => !change.archived), archived = data.changes.filter(change => change.archived);
|
|
68
|
+
const active = data.changes.filter(change => !change.archived && !draftChanges.has(change.id)), archived = data.changes.filter(change => change.archived);
|
|
60
69
|
const buildFiles = view === 'studio' && params.stage === 'implement';
|
|
61
70
|
const navChange = change => {
|
|
62
71
|
const state = changeState(change);
|
|
63
72
|
const proposal = change.files.find(file => !file.includes('/specs/') && path.basename(file) === 'proposal.md') || change.files[0];
|
|
64
73
|
if (query && !`${change.id} ${change.title} ${change.summary} ${change.files.join(' ')}`.toLowerCase().includes(query) && !(buildFiles && selected?.id === change.id)) return '';
|
|
65
|
-
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></span>${selected?.id === change.id ? '<span class="selected-mark"></span>' : ''}`, { change: change.id, doc: proposal, view:
|
|
74
|
+
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' : ''}`);
|
|
66
75
|
|
|
67
76
|
return `${item}${buildFiles && selected?.id === change.id ? previewNavigation : ''}`;
|
|
68
77
|
};
|
|
69
78
|
const previewNavigation = `<div data-preview-navigation data-preview-placement="${buildFiles ? 'change' : 'inline'}">${view === 'preview' || buildFiles ? changedFilesNavigation(preview, params, selected, { link }) : ''}</div>`;
|
|
70
|
-
const searchContext = view === 'studio' ? ['stage', 'plan', 'compare', 'pane', 'job', 'file', 'mode', 'wrap', 'new', 'creation', 'created'].map(name => {
|
|
71
|
-
const value = buildFiles && name === 'job' ? preview.job?.id : buildFiles && name === 'file' ? preview.file?.file : params[name];
|
|
79
|
+
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 : buildFiles && name === 'job' ? preview.job?.id : buildFiles && name === 'file' ? preview.file?.file : params[name];
|
|
72
81
|
return value ? `<input type="hidden" name="${name}" value="${e(value)}">` : '';
|
|
73
82
|
}).join('') : '';
|
|
74
|
-
const
|
|
83
|
+
const draftLinks = drafts.filter(item => !query || `${item.change} ${item.message}`.toLowerCase().includes(query)).map(item => {
|
|
84
|
+
const change = data.changes.find(change => !change.archived && change.id === item.change && item.creationId);
|
|
85
|
+
const job = jobs.find(job => job.id === item.creationId);
|
|
86
|
+
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
|
+
}).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>${buildFiles ? '' : 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>`;
|
|
75
89
|
const title = view === 'studio' && !selected ? 'New spec' : selected?.title || (doc ? doc.split('/').slice(2, -1).join(' / ') : 'Your specs, in focus.');
|
|
76
90
|
const files = selected ? ['proposal.md', 'design.md', 'tasks.md'].map(name => selected.files.find(file => !file.includes('/specs/') && path.basename(file) === name)).filter(Boolean) : [];
|
|
77
|
-
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'
|
|
78
|
-
let content = '', artifact = null;
|
|
79
|
-
if (view === 'studio')
|
|
80
|
-
|
|
91
|
+
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'].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' : ''}`)}</div>` : '';
|
|
92
|
+
let content = '', artifact = null, studioHeader = '';
|
|
93
|
+
if (view === 'studio') {
|
|
94
|
+
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;
|
|
96
|
+
}
|
|
81
97
|
else if (view === 'preview') content = await renderPreview({ root, params, selected, agent, context: preview, compact: compact && Boolean(selected) }, { icon, link, badge, empty });
|
|
82
98
|
else if (view === 'specs' && selected) {
|
|
83
99
|
const diffs = await requirementDiffs(root, selected);
|
|
@@ -90,12 +106,12 @@ export async function workspace({ root, data, params, jobs, agent, compact = tru
|
|
|
90
106
|
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}`;
|
|
91
107
|
} 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>');
|
|
92
108
|
const lastPreview = preview.job;
|
|
93
|
-
const reviewContext = compact && selected &&
|
|
94
|
-
const panel =
|
|
109
|
+
const reviewContext = compact && selected && view !== 'studio' ? await renderReviewContext({ root, params, selected, context: preview, jobs, agent, artifact, showImpact: view === 'preview' }, { icon, link, badge }) : '';
|
|
110
|
+
const panel = view === 'studio' ? '' : `<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>`;
|
|
95
111
|
|
|
96
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>`;
|
|
97
|
-
const compactHeader = `<header class="compact-change-header">${compactBreadcrumbs}${view === 'studio' ? '' : navigation}${
|
|
98
|
-
const refreshURL = url({ ...params, change: selected?.id, view, doc: ['preview', '
|
|
99
|
-
return `<div id="workspace" class="workspace ${view === 'studio' ? 'studio-workspace' :
|
|
113
|
+
const compactHeader = `<header class="compact-change-header">${compactBreadcrumbs}${studioHeader}${view === 'studio' ? '' : navigation}${view === 'studio' ? '' : `<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>`;
|
|
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' || buildFiles ? preview.job?.id : params.job, file: view === 'preview' || buildFiles ? preview.file?.file : params.file });
|
|
115
|
+
return `<div id="workspace" class="workspace ${view === 'studio' ? 'studio-workspace' : ''} ${view === 'preview' ? 'diff-workspace' : ''} ${compact && selected ? `compact-workspace${view === 'studio' ? '' : ' 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>`;
|
|
100
116
|
}
|
|
101
117
|
function empty(title, copy, symbol = 'code', extra = '') { return `<div class="empty-state">${icon(symbol)}<h2>${title}</h2><p>${copy}</p>${extra}</div>`; }
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { inventory } from './specs.mjs';
|
|
2
|
+
import { localReadiness } from './openspec-cli.mjs';
|
|
3
|
+
|
|
4
|
+
// Browsing never waits for a CLI process. Mutating actions still use fresh localReadiness.
|
|
5
|
+
export function createWorkspaceState(root, { check = localReadiness, changed = () => {} } = {}) {
|
|
6
|
+
let tree, generation = 0, running = false, closed = false;
|
|
7
|
+
const entries = new Map(), queue = new Set(), abort = new AbortController();
|
|
8
|
+
async function data() {
|
|
9
|
+
if (!tree) {
|
|
10
|
+
const current = generation;
|
|
11
|
+
const promise = inventory(root);
|
|
12
|
+
tree = promise;
|
|
13
|
+
// Coalesce concurrent reads, but never serve a directory listing older than navigation.
|
|
14
|
+
promise.finally(() => { if (tree === promise && current === generation) tree = null; }).catch(() => {});
|
|
15
|
+
}
|
|
16
|
+
return tree;
|
|
17
|
+
}
|
|
18
|
+
async function drain() {
|
|
19
|
+
if (running || closed) return;
|
|
20
|
+
running = true;
|
|
21
|
+
try {
|
|
22
|
+
while (queue.size && !closed) {
|
|
23
|
+
const change = [...queue].at(-1);
|
|
24
|
+
queue.delete(change);
|
|
25
|
+
const entry = entries.get(change);
|
|
26
|
+
if (!entry) continue;
|
|
27
|
+
try { entry.value = await check(root, change, { signal: abort.signal }); }
|
|
28
|
+
catch (error) { entry.error = error.message; }
|
|
29
|
+
entry.pending = false;
|
|
30
|
+
if (entries.get(change) === entry && !closed) changed(change, entry.value);
|
|
31
|
+
}
|
|
32
|
+
} finally { running = false; }
|
|
33
|
+
}
|
|
34
|
+
function readiness(change) {
|
|
35
|
+
let entry = entries.get(change);
|
|
36
|
+
if (!entry) {
|
|
37
|
+
entry = { pending: true }; entries.set(change, entry); queue.add(change);
|
|
38
|
+
void drain();
|
|
39
|
+
}
|
|
40
|
+
if (entry.error) throw new Error(entry.error);
|
|
41
|
+
return entry.value || null;
|
|
42
|
+
}
|
|
43
|
+
function invalidate(change) {
|
|
44
|
+
tree = null; generation++;
|
|
45
|
+
if (change) entries.delete(change); else entries.clear();
|
|
46
|
+
}
|
|
47
|
+
return { data, readiness, invalidate, close() { closed = true; queue.clear(); abort.abort(); } };
|
|
48
|
+
}
|
package/public/lifecycle.css
DELETED
|
@@ -1,93 +0,0 @@
|
|
|
1
|
-
.workspace.lifecycle-workspace .inspector{display:none}
|
|
2
|
-
@media(min-width:761px){.workspace.lifecycle-workspace,.workspace.lifecycle-workspace.review-details-open{grid-template-columns:var(--rail-width) minmax(0,1fr)}}
|
|
3
|
-
.new-change-link{margin-bottom:16px;justify-content:center}
|
|
4
|
-
.lifecycle-page{padding:28px;max-width:1120px;margin:auto;font-size:13px;line-height:1.6;overflow-wrap:anywhere}
|
|
5
|
-
.lc-heading{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;margin-bottom:24px;flex-wrap:wrap}
|
|
6
|
-
.lc-heading h1{font-size:25px;letter-spacing:-.025em;font-weight:600;line-height:1.25;margin:0 0 6px;text-wrap:balance}
|
|
7
|
-
.lc-heading p{margin:0;color:var(--muted);max-width:70ch}
|
|
8
|
-
.lc-agent-note{display:flex;align-items:flex-start;gap:8px;color:var(--muted);font-size:12px;margin:0 0 20px;max-width:80ch}
|
|
9
|
-
.lc-agent-note svg{width:16px;height:16px;flex-shrink:0;margin-top:2px}
|
|
10
|
-
.lc-board{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));padding:0;list-style:none;border-block:1px solid var(--line);margin:0 0 24px}
|
|
11
|
-
.lc-stage{padding:14px 16px;min-width:0;display:flex;flex-direction:column;gap:3px}
|
|
12
|
-
.lc-stage+.lc-stage{border-left:1px solid var(--line)}
|
|
13
|
-
.lc-stage strong{font-size:13px;font-weight:550}
|
|
14
|
-
.lc-stage>span{font-size:11px;color:var(--muted)}
|
|
15
|
-
.lc-stage.current{background:var(--accent-soft)}
|
|
16
|
-
.lc-stage.current strong,.lc-stage.current>span{color:var(--accent-text)}
|
|
17
|
-
.lifecycle-page h2{font-size:15px;line-height:1.4;font-weight:600;margin:0 0 12px;letter-spacing:-.01em}
|
|
18
|
-
.lc-next{display:flex;justify-content:space-between;align-items:center;gap:24px;padding:4px 0 24px;border-bottom:1px solid var(--line)}
|
|
19
|
-
.lc-next h2{font-size:21px;letter-spacing:-.02em;margin:0 0 8px;text-wrap:balance}
|
|
20
|
-
.lc-next p{margin:0;max-width:65ch;color:var(--muted)}
|
|
21
|
-
.lc-next>.button,.lc-next>.lc-action{flex-shrink:0;margin:0;max-width:260px}
|
|
22
|
-
.lc-next .lc-blocker{max-width:30ch}
|
|
23
|
-
.lc-spec-editor{padding:24px 0}
|
|
24
|
-
.lc-spec-editor .lc-field-label{margin-top:0;font-size:15px}
|
|
25
|
-
.lc-composer-actions{display:flex;gap:14px;align-items:center;flex-wrap:wrap}
|
|
26
|
-
.lc-composer-actions>.lc-muted{margin:0;flex:1;min-width:180px}
|
|
27
|
-
.lc-plan-review{border-block:1px solid var(--line);margin:0 0 28px}
|
|
28
|
-
.lc-plan-review>summary{font-weight:550;padding-block:14px!important;font-size:13px!important}
|
|
29
|
-
.lc-plan-review>summary>.lc-muted{margin-left:8px;font-weight:400}
|
|
30
|
-
.lc-plan-documents{display:flex;gap:6px;flex-wrap:wrap;margin:0 0 12px}
|
|
31
|
-
.lc-plan-documents .button{text-transform:capitalize}
|
|
32
|
-
.lc-plan-document.prose{max-width:80ch;padding:16px 0 24px;margin:0;font-size:13px}
|
|
33
|
-
.lc-current{padding:24px 0 12px}
|
|
34
|
-
.lc-current>.lc-job{border-bottom:0}
|
|
35
|
-
.lc-artifacts{padding:0;margin:0 0 20px;list-style:none}
|
|
36
|
-
.lc-artifacts li{display:flex;align-items:center;justify-content:space-between;gap:10px;border-bottom:1px solid var(--line);padding:8px 0;font-size:12px}
|
|
37
|
-
.lc-action{margin:14px 0}
|
|
38
|
-
.lifecycle-page .button{height:auto;min-height:36px;font-size:12px;white-space:normal;text-align:left;line-height:1.4;padding:8px 11px;max-width:100%}
|
|
39
|
-
.lifecycle-page .button svg{width:15px;height:15px;flex-shrink:0}
|
|
40
|
-
.lifecycle-page button:disabled{opacity:.6;cursor:not-allowed}
|
|
41
|
-
.lc-blocker,.lc-muted{font-size:12px;color:var(--muted);line-height:1.6;margin:7px 0 12px}
|
|
42
|
-
.lc-blocker{font-size:11px}
|
|
43
|
-
.lifecycle-page details>summary{cursor:pointer;min-height:32px;padding-block:6px;font-size:12px}
|
|
44
|
-
.lifecycle-page details>summary:hover{color:var(--accent-text)}
|
|
45
|
-
.lc-section-heading{display:flex;gap:10px;align-items:baseline;justify-content:space-between;flex-wrap:wrap;margin-bottom:8px}
|
|
46
|
-
.lc-section-heading h2,.lc-section-heading .lc-muted{margin:0}
|
|
47
|
-
.lc-job{border-bottom:1px solid var(--line)}
|
|
48
|
-
.lc-job>summary{display:flex;justify-content:space-between;gap:12px;align-items:center;padding:12px 0!important}
|
|
49
|
-
.lc-job>summary>span:first-child{font-weight:550;margin-right:auto}
|
|
50
|
-
.lc-job>summary::before{content:"";border:solid var(--muted);border-width:0 1px 1px 0;padding:3px;transform:rotate(-45deg);margin:0 2px}
|
|
51
|
-
.lc-job[open]>summary::before{transform:rotate(45deg)}
|
|
52
|
-
.lc-job-body{padding:0 0 16px 16px}
|
|
53
|
-
.lc-request,.lc-result,.lc-question-text,.lc-answer p{white-space:pre-wrap;max-width:72ch;margin:0 0 16px}
|
|
54
|
-
.lc-request{color:var(--muted)}
|
|
55
|
-
.lc-result{padding-top:12px;border-top:1px solid var(--line)}
|
|
56
|
-
.lc-job-body ol{list-style:none;padding:0;margin:0 0 12px;font-size:12px}
|
|
57
|
-
.lc-job-body li{padding:6px 0;display:grid;gap:6px}
|
|
58
|
-
.lc-job-body time{font-size:11px;color:var(--muted);font-variant-numeric:tabular-nums}
|
|
59
|
-
.lc-question{border-block:1px solid var(--line);padding:18px 0;margin:16px 0}
|
|
60
|
-
.lc-question-text{font-weight:550}
|
|
61
|
-
.lc-answer strong{font-size:11px;color:var(--muted)}
|
|
62
|
-
.lc-field-label{display:block;font-size:12px;font-weight:550;margin:18px 0 8px}
|
|
63
|
-
.lifecycle-page textarea,.lifecycle-page input:not([type=hidden],[type=radio]){display:block;width:100%;box-sizing:border-box;background:var(--surface);color:var(--text);border:1px solid var(--line);border-radius:5px;padding:10px 12px;font:inherit;caret-color:var(--accent);margin-bottom:12px}
|
|
64
|
-
.lifecycle-page textarea{resize:vertical;min-height:80px}
|
|
65
|
-
.lifecycle-page textarea::placeholder,.lifecycle-page input::placeholder{color:var(--muted);opacity:1}
|
|
66
|
-
.lc-choice{display:flex;align-items:flex-start;gap:9px;padding:9px 0;cursor:pointer}
|
|
67
|
-
.lc-choice input{margin-top:5px;accent-color:var(--accent);flex-shrink:0}
|
|
68
|
-
.lc-tools{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:28px;padding:16px 0}
|
|
69
|
-
.lc-tools dl{font-size:12px;margin:0;font-variant-numeric:tabular-nums}
|
|
70
|
-
.lc-tools dl>div{display:flex;justify-content:space-between;gap:12px;margin:8px 0}
|
|
71
|
-
.lc-tools dt{color:var(--muted)}
|
|
72
|
-
.lc-tools dd{margin:0}
|
|
73
|
-
.lc-detail-heading{margin-top:28px!important}
|
|
74
|
-
.lc-validation .row{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
|
|
75
|
-
.lc-validation time{font-size:11px;color:var(--muted);font-variant-numeric:tabular-nums}
|
|
76
|
-
.lc-validation ul{padding-left:18px}
|
|
77
|
-
.lc-validation ul:empty{display:none}
|
|
78
|
-
.lc-start{max-width:72ch;margin:24px 0 32px}
|
|
79
|
-
.lc-start+.lc-current{border-top:1px solid var(--line)}
|
|
80
|
-
.lc-history,.lc-more{border-top:1px solid var(--line);padding:8px 0}
|
|
81
|
-
.lc-more>summary,.lc-history>summary{font-weight:550}
|
|
82
|
-
.lc-history>summary>.lc-muted{margin-left:8px}
|
|
83
|
-
.lifecycle-page [data-lifecycle-feedback]:empty{display:none}
|
|
84
|
-
.lifecycle-page [data-lifecycle-feedback]{margin-top:8px}
|
|
85
|
-
.lifecycle-page form[aria-busy=true]{cursor:progress}
|
|
86
|
-
.lifecycle-page .source-preview-tools{margin:24px 0 0}
|
|
87
|
-
.guided-file-actions{gap:12px;flex-wrap:wrap}
|
|
88
|
-
.guided-file-actions>span{margin-right:auto}
|
|
89
|
-
.guided-file-actions .preview-followup{display:flex;align-items:center;gap:10px;flex-wrap:wrap}
|
|
90
|
-
.guided-file-actions .lc-blocker{flex-basis:100%;margin:0}
|
|
91
|
-
@media(max-width:1100px){.lc-tools{grid-template-columns:minmax(0,1fr)}.lc-tools>section+section{border-top:1px solid var(--line);padding-top:24px}.lc-next{align-items:flex-start;flex-direction:column;gap:16px}.lc-next>.button,.lc-next>.lc-action{max-width:100%}}
|
|
92
|
-
@media(max-width:760px){.lifecycle-page{padding:24px 18px}.lifecycle-page textarea,.lifecycle-page input:not([type=hidden],[type=radio]){font-size:16px}.lc-heading h1{font-size:25px}.lc-heading>.badge{align-self:flex-start}.lc-board{grid-template-columns:repeat(2,minmax(0,1fr))}.lc-stage:nth-child(3){border-left:0}.lc-stage:nth-child(n+3){border-top:1px solid var(--line)}}
|
|
93
|
-
@media(max-width:420px){.lc-stage{padding:12px 10px}.lc-job>summary{flex-wrap:wrap}.lc-job>summary>.badge{margin-left:16px}.lc-job-body{padding-left:0}}
|