specpilot 2.3.0 → 2.4.0
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 +7 -5
- package/dist/cli.js +2 -1
- package/dist/cli.js.map +1 -1
- package/dist/commands/archive.d.ts.map +1 -1
- package/dist/commands/archive.js +5 -1
- package/dist/commands/archive.js.map +1 -1
- package/dist/commands/serve.d.ts +1 -0
- package/dist/commands/serve.d.ts.map +1 -1
- package/dist/commands/serve.js +5 -3
- package/dist/commands/serve.js.map +1 -1
- package/dist/utils/slashCommandGenerator.d.ts.map +1 -1
- package/dist/utils/slashCommandGenerator.js +117 -26
- package/dist/utils/slashCommandGenerator.js.map +1 -1
- package/dist/utils/specArchiver.d.ts +22 -0
- package/dist/utils/specArchiver.d.ts.map +1 -1
- package/dist/utils/specArchiver.js +121 -26
- package/dist/utils/specArchiver.js.map +1 -1
- package/dist/utils/specReader.d.ts +21 -0
- package/dist/utils/specReader.d.ts.map +1 -1
- package/dist/utils/specReader.js +26 -3
- package/dist/utils/specReader.js.map +1 -1
- package/dist/utils/specServer.d.ts +5 -0
- package/dist/utils/specServer.d.ts.map +1 -1
- package/dist/utils/specServer.js +89 -3
- package/dist/utils/specServer.js.map +1 -1
- package/dist/utils/specValidator.d.ts +3 -1
- package/dist/utils/specValidator.d.ts.map +1 -1
- package/dist/utils/specValidator.js +44 -11
- package/dist/utils/specValidator.js.map +1 -1
- package/dist/utils/taskMover.d.ts +50 -0
- package/dist/utils/taskMover.d.ts.map +1 -0
- package/dist/utils/taskMover.js +131 -0
- package/dist/utils/taskMover.js.map +1 -0
- package/package.json +1 -1
- package/ui/app.css +7 -0
- package/ui/app.js +70 -2
- package/ui/index.html +1 -0
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/** The write allowlist: exactly one file, separate from what the server may read. */
|
|
2
|
+
export declare const WRITABLE_TASKS_FILE = ".specs/planning/tasks.md";
|
|
3
|
+
export type MovableSection = 'backlog' | 'currentSprint';
|
|
4
|
+
/** The section headings as tasks.md writes them (what readSpecs() matches). */
|
|
5
|
+
export declare const SECTION_HEADINGS: {
|
|
6
|
+
readonly backlog: "Backlog";
|
|
7
|
+
readonly currentSprint: "Current Sprint";
|
|
8
|
+
readonly completed: "Completed";
|
|
9
|
+
};
|
|
10
|
+
export interface TaskMove {
|
|
11
|
+
id: string;
|
|
12
|
+
toSection: MovableSection;
|
|
13
|
+
/** The row's position in `toSection` after the move, 0-based. */
|
|
14
|
+
toIndex: number;
|
|
15
|
+
}
|
|
16
|
+
export type PlanResult = {
|
|
17
|
+
ok: true;
|
|
18
|
+
content: string;
|
|
19
|
+
from: MovableSection;
|
|
20
|
+
fromIndex: number;
|
|
21
|
+
noop: boolean;
|
|
22
|
+
} | {
|
|
23
|
+
ok: false;
|
|
24
|
+
error: string;
|
|
25
|
+
};
|
|
26
|
+
export declare const sha256: (data: string | Buffer) => string;
|
|
27
|
+
/** Check a request body's shape; returns a plain-words problem or null. */
|
|
28
|
+
export declare function moveShapeError(body: unknown): string | null;
|
|
29
|
+
/** Work out a move on tasks.md content in memory: the new content, or why it cannot be done. */
|
|
30
|
+
export declare function planMove(content: string, move: TaskMove): PlanResult;
|
|
31
|
+
export type MoveOutcome = {
|
|
32
|
+
status: 200;
|
|
33
|
+
sha256: string;
|
|
34
|
+
from: MovableSection;
|
|
35
|
+
fromIndex: number;
|
|
36
|
+
} | {
|
|
37
|
+
status: 409;
|
|
38
|
+
error: string;
|
|
39
|
+
} | {
|
|
40
|
+
status: 422;
|
|
41
|
+
error: string;
|
|
42
|
+
};
|
|
43
|
+
export declare const STALE_ERROR = "planning/tasks.md changed on disk since this page loaded. The move was not made.";
|
|
44
|
+
/**
|
|
45
|
+
* Apply a move to tasks.md on disk if `ifMatch` is its current sha256. Synchronous from the first
|
|
46
|
+
* read to the rename, so nothing else in this process runs in between; the caller's lock queues
|
|
47
|
+
* requests. Writes a temp file in the same folder, fsyncs it, keeps the mode, renames it over.
|
|
48
|
+
*/
|
|
49
|
+
export declare function moveTask(root: string, move: TaskMove, ifMatch: string): MoveOutcome;
|
|
50
|
+
//# sourceMappingURL=taskMover.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"taskMover.d.ts","sourceRoot":"","sources":["../../src/utils/taskMover.ts"],"names":[],"mappings":"AASA,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,eAAe,CAAC;AAEzD,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB;;;;CAA2F,CAAC;AAEzH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,cAAc,CAAC;IAC1B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACrF;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,GAAG,MAAM,KAAG,MAAyD,CAAC;AAEzG,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAO3D;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CA+BpE;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,eAAO,MAAM,WAAW,qFAAqF,CAAC;AAE9G;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAkDnF"}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.STALE_ERROR = exports.sha256 = exports.SECTION_HEADINGS = exports.WRITABLE_TASKS_FILE = void 0;
|
|
4
|
+
exports.moveShapeError = moveShapeError;
|
|
5
|
+
exports.planMove = planMove;
|
|
6
|
+
exports.moveTask = moveTask;
|
|
7
|
+
const fs_1 = require("fs");
|
|
8
|
+
const crypto_1 = require("crypto");
|
|
9
|
+
const path_1 = require("path");
|
|
10
|
+
const specReader_1 = require("./specReader");
|
|
11
|
+
const specValidator_1 = require("./specValidator");
|
|
12
|
+
// The one writer behind `specpilot serve` (BL-053, ARCH-003.18, ARCH-004.36). A move removes one
|
|
13
|
+
// line of tasks.md and inserts the identical line elsewhere; every other byte stays as it was.
|
|
14
|
+
/** The write allowlist: exactly one file, separate from what the server may read. */
|
|
15
|
+
exports.WRITABLE_TASKS_FILE = '.specs/planning/tasks.md';
|
|
16
|
+
/** The section headings as tasks.md writes them (what readSpecs() matches). */
|
|
17
|
+
exports.SECTION_HEADINGS = { backlog: 'Backlog', currentSprint: 'Current Sprint', completed: 'Completed' };
|
|
18
|
+
const sha256 = (data) => (0, crypto_1.createHash)('sha256').update(data).digest('hex');
|
|
19
|
+
exports.sha256 = sha256;
|
|
20
|
+
/** Check a request body's shape; returns a plain-words problem or null. */
|
|
21
|
+
function moveShapeError(body) {
|
|
22
|
+
const b = body;
|
|
23
|
+
if (!b || typeof b !== 'object')
|
|
24
|
+
return 'The request must be a JSON object with id, toSection and toIndex.';
|
|
25
|
+
if (typeof b.id !== 'string' || !b.id)
|
|
26
|
+
return 'The request has no task ID.';
|
|
27
|
+
if (b.toSection !== 'backlog' && b.toSection !== 'currentSprint')
|
|
28
|
+
return 'Tasks can only be moved to Backlog or Current Sprint.';
|
|
29
|
+
if (!Number.isInteger(b.toIndex) || b.toIndex < 0)
|
|
30
|
+
return 'The position must be a whole number, 0 or more.';
|
|
31
|
+
return null;
|
|
32
|
+
}
|
|
33
|
+
/** Work out a move on tasks.md content in memory: the new content, or why it cannot be done. */
|
|
34
|
+
function planMove(content, move) {
|
|
35
|
+
const lines = content.split('\n');
|
|
36
|
+
const where = (0, specReader_1.taskRowLines)(content);
|
|
37
|
+
const hits = ['backlog', 'currentSprint', 'completed'].flatMap(sec => (where[sec]?.rows ?? []).map((r, i) => ({ sec, i, line: r.line })).filter((_, i) => where[sec].rows[i].id === move.id));
|
|
38
|
+
if (!hits.length)
|
|
39
|
+
return { ok: false, error: `No task row in planning/tasks.md has the ID ${move.id}.` };
|
|
40
|
+
if (hits.length > 1)
|
|
41
|
+
return { ok: false, error: `${move.id} is on more than one row in planning/tasks.md, so SpecPilot cannot tell which to move.` };
|
|
42
|
+
const hit = hits[0];
|
|
43
|
+
if (hit.sec === 'completed')
|
|
44
|
+
return { ok: false, error: 'Completed rows cannot be moved.' };
|
|
45
|
+
const from = hit.sec;
|
|
46
|
+
const target = where[move.toSection];
|
|
47
|
+
if (!target)
|
|
48
|
+
return { ok: false, error: `planning/tasks.md has no ## ${exports.SECTION_HEADINGS[move.toSection]} section.` };
|
|
49
|
+
if (target.separator === null)
|
|
50
|
+
return { ok: false, error: `${exports.SECTION_HEADINGS[move.toSection]} has no table yet.` };
|
|
51
|
+
const others = target.rows.filter(r => r.line !== hit.line);
|
|
52
|
+
if (move.toIndex > others.length) {
|
|
53
|
+
return { ok: false, error: `Position ${move.toIndex} is past the end of ${exports.SECTION_HEADINGS[move.toSection]}, which would have ${others.length + 1} rows.` };
|
|
54
|
+
}
|
|
55
|
+
if (from === move.toSection && move.toIndex === hit.i)
|
|
56
|
+
return { ok: true, content, from, fromIndex: hit.i, noop: true };
|
|
57
|
+
// Insert before the row now at toIndex, or right after the last row (or the separator).
|
|
58
|
+
const at = move.toIndex < others.length ? others[move.toIndex].line : (others.length ? others[others.length - 1].line : target.separator) + 1;
|
|
59
|
+
const last = lines.length - 1; // with a trailing newline, lines[last] is '' and never a row
|
|
60
|
+
if (hit.line === last || at > last) {
|
|
61
|
+
return { ok: false, error: `This move would change which line ends the file, because planning/tasks.md has no line break after its last line. Add one and try again.` };
|
|
62
|
+
}
|
|
63
|
+
const out = lines.slice();
|
|
64
|
+
const [row] = out.splice(hit.line, 1);
|
|
65
|
+
out.splice(at > hit.line ? at - 1 : at, 0, row);
|
|
66
|
+
return { ok: true, content: out.join('\n'), from, fromIndex: hit.i, noop: false };
|
|
67
|
+
}
|
|
68
|
+
exports.STALE_ERROR = 'planning/tasks.md changed on disk since this page loaded. The move was not made.';
|
|
69
|
+
/**
|
|
70
|
+
* Apply a move to tasks.md on disk if `ifMatch` is its current sha256. Synchronous from the first
|
|
71
|
+
* read to the rename, so nothing else in this process runs in between; the caller's lock queues
|
|
72
|
+
* requests. Writes a temp file in the same folder, fsyncs it, keeps the mode, renames it over.
|
|
73
|
+
*/
|
|
74
|
+
function moveTask(root, move, ifMatch) {
|
|
75
|
+
const file = (0, path_1.join)(root, exports.WRITABLE_TASKS_FILE);
|
|
76
|
+
let st;
|
|
77
|
+
try {
|
|
78
|
+
st = (0, fs_1.lstatSync)(file);
|
|
79
|
+
}
|
|
80
|
+
catch {
|
|
81
|
+
return { status: 422, error: 'planning/tasks.md does not exist.' };
|
|
82
|
+
}
|
|
83
|
+
if (st.isSymbolicLink())
|
|
84
|
+
return { status: 422, error: 'planning/tasks.md is a symbolic link, and SpecPilot will not replace it with a regular file.' };
|
|
85
|
+
const before = (0, fs_1.readFileSync)(file);
|
|
86
|
+
if ((0, exports.sha256)(before) !== ifMatch)
|
|
87
|
+
return { status: 409, error: exports.STALE_ERROR };
|
|
88
|
+
const content = before.toString('utf-8');
|
|
89
|
+
// Decoding and re-encoding must give back the same bytes, or the write would alter lines it never moved.
|
|
90
|
+
if (!Buffer.from(content, 'utf-8').equals(before)) {
|
|
91
|
+
return { status: 422, error: 'planning/tasks.md contains bytes that are not valid UTF-8, so SpecPilot cannot move a line without changing others.' };
|
|
92
|
+
}
|
|
93
|
+
const plan = planMove(content, move);
|
|
94
|
+
if (!plan.ok)
|
|
95
|
+
return { status: 422, error: plan.error };
|
|
96
|
+
if (plan.noop)
|
|
97
|
+
return { status: 200, sha256: ifMatch, from: plan.from, fromIndex: plan.fromIndex };
|
|
98
|
+
const was = new Set((0, specValidator_1.tasksChecks)(content));
|
|
99
|
+
const introduced = (0, specValidator_1.tasksChecks)(plan.content).filter(m => !was.has(m));
|
|
100
|
+
if (introduced.length)
|
|
101
|
+
return { status: 422, error: `The move was not made, because \`specpilot validate\` would then report: ${introduced.join(' ')}` };
|
|
102
|
+
const tmp = (0, path_1.join)((0, path_1.dirname)(file), `.tasks.md.${(0, crypto_1.randomBytes)(6).toString('hex')}.tmp`);
|
|
103
|
+
try {
|
|
104
|
+
const fd = (0, fs_1.openSync)(tmp, 'wx', st.mode & 0o777);
|
|
105
|
+
try {
|
|
106
|
+
(0, fs_1.writeSync)(fd, plan.content);
|
|
107
|
+
(0, fs_1.fsyncSync)(fd);
|
|
108
|
+
}
|
|
109
|
+
finally {
|
|
110
|
+
(0, fs_1.closeSync)(fd);
|
|
111
|
+
}
|
|
112
|
+
(0, fs_1.chmodSync)(tmp, st.mode & 0o7777);
|
|
113
|
+
// Last look: an editor may have saved while we were writing.
|
|
114
|
+
if ((0, exports.sha256)((0, fs_1.readFileSync)(file)) !== ifMatch) {
|
|
115
|
+
(0, fs_1.unlinkSync)(tmp);
|
|
116
|
+
return { status: 409, error: exports.STALE_ERROR };
|
|
117
|
+
}
|
|
118
|
+
(0, fs_1.renameSync)(tmp, file);
|
|
119
|
+
}
|
|
120
|
+
catch (err) {
|
|
121
|
+
try {
|
|
122
|
+
(0, fs_1.unlinkSync)(tmp);
|
|
123
|
+
}
|
|
124
|
+
catch {
|
|
125
|
+
/* never created, or already renamed */
|
|
126
|
+
}
|
|
127
|
+
throw err;
|
|
128
|
+
}
|
|
129
|
+
return { status: 200, sha256: (0, exports.sha256)(plan.content), from: plan.from, fromIndex: plan.fromIndex };
|
|
130
|
+
}
|
|
131
|
+
//# sourceMappingURL=taskMover.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"taskMover.js","sourceRoot":"","sources":["../../src/utils/taskMover.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
package/ui/app.css
CHANGED
|
@@ -297,3 +297,10 @@ input.txt{width:100%}
|
|
|
297
297
|
/* Group headers in the content and inspector carry file text (section headings, paths):
|
|
298
298
|
show it as written instead of uppercasing it. Sidebar group labels stay uppercase. */
|
|
299
299
|
.content .gl .gh,.insp .gl .gh{text-transform:none;letter-spacing:.02em}
|
|
300
|
+
/* Task moves (BL-053): drag state, drop target, and the toast's Undo. */
|
|
301
|
+
.row[draggable="true"]{cursor:grab}
|
|
302
|
+
.row[draggable="true"]:active{cursor:grabbing}
|
|
303
|
+
.row.drag{opacity:.4}
|
|
304
|
+
.gl.drop .box{border-color:var(--focus);box-shadow:inset 0 0 0 1px var(--focus)}
|
|
305
|
+
.toast.has-action.show{pointer-events:auto}
|
|
306
|
+
.toast .tact{margin-left:12px;color:var(--ground);font-weight:600;text-decoration:underline;text-underline-offset:2px}
|
package/ui/app.js
CHANGED
|
@@ -4,7 +4,13 @@
|
|
|
4
4
|
(function(){
|
|
5
5
|
const $=(s,r=document)=>r.querySelector(s), $$=(s,r=document)=>[...r.querySelectorAll(s)];
|
|
6
6
|
const toastEl=$('#toast');let toastT;
|
|
7
|
-
const toast=m=>{
|
|
7
|
+
const toast=(m,action)=>{
|
|
8
|
+
toastEl.textContent=m;toastEl.classList.toggle('has-action',!!action);
|
|
9
|
+
if(action){const b=document.createElement('button');b.type='button';b.className='tact';b.textContent=action.label;b.onclick=()=>{toastEl.classList.remove('show');action.fn();};toastEl.appendChild(b);}
|
|
10
|
+
toastEl.classList.add('show');clearTimeout(toastT);toastT=setTimeout(()=>toastEl.classList.remove('show'),action?8000:2600);};
|
|
11
|
+
/* Task moves (BL-053) are on only when the server put a token in the page (not with --read-only). */
|
|
12
|
+
const TOKEN=(document.querySelector('meta[name="specpilot-token"]')||{}).content||null;
|
|
13
|
+
const MOVABLE={backlog:true,currentSprint:true};
|
|
8
14
|
const chev='<svg class="ico chev" aria-hidden="true" focusable="false"><use href="#i-chev"/></svg>';
|
|
9
15
|
|
|
10
16
|
/* theme: dark by default, light is a per-viewer toggle */
|
|
@@ -128,7 +134,8 @@ function rowsOf(col){
|
|
|
128
134
|
return col==='completed'?items.reverse():items;
|
|
129
135
|
}
|
|
130
136
|
function taskRow({t,i},col){
|
|
131
|
-
|
|
137
|
+
const mv=TOKEN&&MOVABLE[col];
|
|
138
|
+
return `<button type="button" class="row act" data-col="${col}" data-i="${i}"${mv?' draggable="true" aria-keyshortcuts="Alt+ArrowUp Alt+ArrowDown Alt+ArrowLeft Alt+ArrowRight"':''}>
|
|
132
139
|
<span class="st ${DOT[col]}" aria-hidden="true"></span>
|
|
133
140
|
<div class="body"><div class="ttl clamp">${col==='completed'?`<span class="num" translate="no">${esc(t.num)}</span>`:''}<span class="id" translate="no">${mdi(t.id)}</span>${mdi(t.description)}</div></div>
|
|
134
141
|
<div class="trail">${chev}</div>
|
|
@@ -175,6 +182,7 @@ function openInsp(quiet){insp.classList.add('open');insp.setAttribute('aria-hidd
|
|
|
175
182
|
function closeInsp(){const was=insp.classList.contains('open');insp.classList.remove('open');insp.setAttribute('aria-hidden','true');selected=null;inspOpen=null;$$('.row.sel').forEach(r=>r.classList.remove('sel'));if(was&&lastFocus&&lastFocus.focus){lastFocus.focus();lastFocus=null;}}
|
|
176
183
|
function bind(){
|
|
177
184
|
$$('#v-board .row[data-col]').forEach(r=>r.onclick=()=>openTask(r.dataset.col,+r.dataset.i));
|
|
185
|
+
if(TOKEN)bindMoves();
|
|
178
186
|
$$('[data-more]').forEach(b=>b.onclick=e=>{e.stopPropagation();if(b.dataset.more==='completed')showAllDone=true;else showAllBacklog=true;renderTasks();});
|
|
179
187
|
$$('[data-disc]').forEach(b=>b.onclick=e=>{e.stopPropagation();const g=$('#gDone');g.classList.toggle('closed');b.setAttribute('aria-expanded',!g.classList.contains('closed'));});
|
|
180
188
|
}
|
|
@@ -274,6 +282,60 @@ document.addEventListener('keydown',e=>{
|
|
|
274
282
|
if((e.key==='j'||e.key==='k')&&curView==='board'){const rows=$$((mode==='board'?'#boardMode':'#listMode')+' .row[data-col]');if(!rows.length)return;let i=rows.findIndex(r=>r.dataset.col+':'+r.dataset.i===selected);i=e.key==='j'?Math.min(rows.length-1,i+1):Math.max(0,i-1);if(i<0)i=0;openTask(rows[i].dataset.col,+rows[i].dataset.i);rows[i].scrollIntoView({block:'nearest'});rows[i].focus();}
|
|
275
283
|
});
|
|
276
284
|
|
|
285
|
+
/* ---------------- task moves (BL-053) ----------------
|
|
286
|
+
A move is one line of planning/tasks.md cut and pasted unchanged; the server does it and
|
|
287
|
+
answers with the new file hash and the fresh payload. Completed rows never move. */
|
|
288
|
+
let dragging=null,moving=false;
|
|
289
|
+
function bindMoves(){
|
|
290
|
+
$$('#v-board .row[draggable="true"]').forEach(r=>{
|
|
291
|
+
r.ondragstart=e=>{dragging={col:r.dataset.col,i:+r.dataset.i};e.dataTransfer.setData('text/plain',DATA.tasks[dragging.col][dragging.i].id);e.dataTransfer.effectAllowed='move';r.classList.add('drag');};
|
|
292
|
+
r.ondragend=()=>{r.classList.remove('drag');dragging=null;$$('.gl.drop').forEach(g=>g.classList.remove('drop'));};
|
|
293
|
+
r.onkeydown=e=>{
|
|
294
|
+
if(!e.altKey||e.metaKey||e.ctrlKey)return;
|
|
295
|
+
const col=r.dataset.col,i=+r.dataset.i,n=DATA.tasks[col].length;
|
|
296
|
+
const go2={ArrowUp:i>0&&[col,i-1],ArrowDown:i<n-1&&[col,i+1],ArrowRight:col==='backlog'&&['currentSprint',DATA.tasks.currentSprint.length],ArrowLeft:col==='currentSprint'&&['backlog',DATA.tasks.backlog.length]}[e.key];
|
|
297
|
+
if(go2===undefined)return;
|
|
298
|
+
e.preventDefault();
|
|
299
|
+
if(go2)move(col,i,go2[0],go2[1]);
|
|
300
|
+
};
|
|
301
|
+
});
|
|
302
|
+
$$('#v-board .gl[data-col="backlog"],#v-board .gl[data-col="currentSprint"]').forEach(g=>{
|
|
303
|
+
g.ondragover=e=>{if(!dragging)return;e.preventDefault();e.dataTransfer.dropEffect='move';g.classList.add('drop');};
|
|
304
|
+
g.ondragleave=e=>{if(!g.contains(e.relatedTarget))g.classList.remove('drop');};
|
|
305
|
+
g.ondrop=e=>{
|
|
306
|
+
if(!dragging)return;e.preventDefault();g.classList.remove('drop');
|
|
307
|
+
const to=g.dataset.col,src=dragging;dragging=null;
|
|
308
|
+
// Position among the target's rows once the dragged row is out of the way.
|
|
309
|
+
const others=DATA.tasks[to].map((_,j)=>j).filter(j=>!(to===src.col&&j===src.i));
|
|
310
|
+
const over=e.target.closest&&e.target.closest('.row[data-col]');
|
|
311
|
+
let at=others.length;
|
|
312
|
+
if(over&&over.dataset.col===to){const j=+over.dataset.i,k=others.indexOf(j);if(k>=0){const b=over.getBoundingClientRect();at=k+(e.clientY>b.top+b.height/2?1:0);}}
|
|
313
|
+
move(src.col,src.i,to,at);
|
|
314
|
+
};
|
|
315
|
+
});
|
|
316
|
+
}
|
|
317
|
+
async function move(col,i,toSection,toIndex,isUndo){
|
|
318
|
+
const t=DATA.tasks[col][i];if(!t||moving)return;
|
|
319
|
+
moving=true;
|
|
320
|
+
let r,body={};
|
|
321
|
+
try{
|
|
322
|
+
r=await fetch('/api/tasks/move',{method:'POST',cache:'no-store',headers:{'Content-Type':'application/json','X-SpecPilot-Token':TOKEN,'If-Match':DATA.tasks.sha256},body:JSON.stringify({id:t.id,toSection,toIndex})});
|
|
323
|
+
body=await r.json().catch(()=>({}));
|
|
324
|
+
}catch(e){moving=false;toast('The server did not answer. Nothing was moved.');return;}
|
|
325
|
+
moving=false;
|
|
326
|
+
if(r.status===200){
|
|
327
|
+
if(toSection==='backlog'&&toIndex>=6)showAllBacklog=true;
|
|
328
|
+
await apply(body.specs,['.specs/planning/tasks.md']);
|
|
329
|
+
const j=DATA.tasks[toSection].findIndex(x=>x.id===t.id);
|
|
330
|
+
const el=$(`${mode==='board'?'#boardMode':'#listMode'} .row[data-col="${toSection}"][data-i="${j}"]`);if(el)el.focus();
|
|
331
|
+
const msg=col===toSection?`${t.id} moved within ## ${COLS[col]} in planning/tasks.md`:`${t.id} moved from ## ${COLS[col]} to ## ${COLS[toSection]} in planning/tasks.md`;
|
|
332
|
+
toast(msg,isUndo?null:{label:'Undo',fn:()=>{const k=DATA.tasks[toSection].findIndex(x=>x.id===t.id);if(k>=0)move(toSection,k,body.from,body.fromIndex,true);}});
|
|
333
|
+
}else if(r.status===409){
|
|
334
|
+
if(body.specs)await apply(body.specs,null);
|
|
335
|
+
toast(body.error||'planning/tasks.md changed on disk since this page loaded. The move was not made.');
|
|
336
|
+
}else toast(body.error||`The move was not made (HTTP ${r.status}).`);
|
|
337
|
+
}
|
|
338
|
+
|
|
277
339
|
/* ---------------- live reload (BL-052) ----------------
|
|
278
340
|
On a change event: re-fetch, redraw in place. Route, scroll, open inspector, selected row
|
|
279
341
|
and focus stay where they were. If the server is gone, the last content stays on screen. */
|
|
@@ -303,6 +365,12 @@ function refresh(paths){refreshing=refreshing.then(()=>redraw(paths)).catch(()=>
|
|
|
303
365
|
async function redraw(paths){
|
|
304
366
|
let d;
|
|
305
367
|
try{const r=await fetch('/api/specs',{cache:'no-store'});if(!r.ok)return;d=await r.json();}catch(e){return;} // server gone: keep what is shown
|
|
368
|
+
// The poller's echo of a move this page just made: same tasks.md hash, nothing to redraw.
|
|
369
|
+
if(paths&&paths.length&&paths.every(p=>p==='.specs/planning/tasks.md')&&DATA&&DATA.tasks&&d.tasks&&d.tasks.sha256===DATA.tasks.sha256)return;
|
|
370
|
+
await apply(d,paths);
|
|
371
|
+
}
|
|
372
|
+
/* Draw a fresh /api/specs payload in place: same route, scroll, inspector, selection and focus. */
|
|
373
|
+
async function apply(d,paths){
|
|
306
374
|
(paths||Object.keys(fileCache)).forEach(p=>{delete fileCache[p];});
|
|
307
375
|
const key=focusKey(document.activeElement);
|
|
308
376
|
const scroll=$('#content').scrollTop,ib0=insp.querySelector('.ib2'),inspScroll=ib0?ib0.scrollTop:0;
|
package/ui/index.html
CHANGED
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
6
6
|
<title>SpecPilot Local</title>
|
|
7
7
|
<meta name="theme-color" content="#0f172a">
|
|
8
|
+
<!-- specpilot-token -->
|
|
8
9
|
<link rel="icon" href="/assets/favicon.svg" type="image/svg+xml">
|
|
9
10
|
<link rel="stylesheet" href="/assets/app.css">
|
|
10
11
|
<script src="/assets/md.js" defer></script>
|