Files
shtil/tools/roadmap-context/roadmap-context.mjs
T
TMSHandDevin a1ce4bdb8a docs: AI documentation protocol and roadmap context tool
Протокол работы AI-ассистентов, зоны frontend/backend/shared, статусы, журнал, шаблоны и скрипт сводки дорожной карты.

Refs: 1.2.3

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-11-08 17:14:44 +03:00

172 lines
11 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env node
// Сводка дорожной карты «Штиль» для AI-ассистентов и людей. Только чтение, без зависимостей, Node 18+.
//
// node tools/roadmap-context/roadmap-context.mjs текущий шаг + последние изменения
// node tools/roadmap-context/roadmap-context.mjs 2 обзор шага 2
// node tools/roadmap-context/roadmap-context.mjs 2.11 задача 2.11 полностью
// node tools/roadmap-context/roadmap-context.mjs --all все шаги подробно (как «Сводка для AI»)
// --remote-data брать план (data.js) с сервера, даже если есть локальный roadmap/data.js
//
// Переменные окружения: ROADMAP_URL, ROADMAP_AUTH («логин:пароль» для Basic Auth), ROADMAP_DATA.
import { readFile } from 'node:fs/promises';
import { existsSync } from 'node:fs';
import vm from 'node:vm';
const BASE = (process.env.ROADMAP_URL || 'https://locshare.ru/roadmap').replace(/\/+$/, '');
const AUTH = process.env.ROADMAP_AUTH;
const LOCAL = process.env.ROADMAP_DATA || 'roadmap/data.js';
const args = process.argv.slice(2);
const flag = n => args.includes(n);
const target = args.find(a => !a.startsWith('--'));
const STATUS = { todo: 'Не начато', doing: 'В работе', review: 'На проверке', done: 'Выполнено', blocked: 'Заблокировано' };
const KINDS = { comment: 'Комментарий', question: 'Вопрос', proposal: 'Предложение', blocker: 'Блокер', decision: 'Решение' };
const DEC = { open: 'Не обсуждали', discuss: 'Обсуждаем', accepted: 'Принято', postponed: 'Отложено' };
const PRIO = { normal: 'Обычный', high: 'Высокий', critical: 'Критичный' };
async function get(path, kind) {
const headers = AUTH ? { Authorization: 'Basic ' + Buffer.from(AUTH).toString('base64') } : {};
const r = await fetch(BASE + path, { headers, cache: 'no-store', signal: AbortSignal.timeout(15000) });
if (!r.ok) throw new Error(`${path}: HTTP ${r.status}`);
return kind === 'json' ? r.json() : r.text();
}
function evalPlan(src) {
const sandbox = { window: {} };
vm.runInNewContext(src, sandbox, { timeout: 1000 });
if (!sandbox.window.SHTIL_ROADMAP) throw new Error('data.js не содержит window.SHTIL_ROADMAP');
return sandbox.window.SHTIL_ROADMAP;
}
async function loadPlan(warn) {
const hasLocal = existsSync(LOCAL) && !flag('--remote-data');
const remote = await get('/roadmap/data.js', 'text').catch(e => (hasLocal ? null : Promise.reject(e)));
if (!hasLocal) return { plan: evalPlan(remote), source: BASE + '/roadmap/data.js' };
const local = await readFile(LOCAL, 'utf8');
if (remote !== null && remote.replace(/\r\n/g, '\n') !== local.replace(/\r\n/g, '\n'))
warn.push(`Локальный ${LOCAL} отличается от data.js на сервере: подтяните main или обновите сервер.`);
return { plan: evalPlan(local), source: LOCAL };
}
const strip = s => String(s ?? '')
.replace(/<\/(p|div|tr|pre|ul|ol|table)>/gi, '\n').replace(/<br\s*\/?>/gi, '\n')
.replace(/<li>/gi, '\n- ').replace(/<t[dh][^>]*>/gi, ' | ').replace(/<[^>]+>/g, '')
.replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#92;/g, '\\').replace(/&amp;/g, '&')
.replace(/[ \t]+\n/g, '\n').replace(/\n{3,}/g, '\n\n').trim();
const oneLine = s => strip(s).replace(/\s*\n\s*/g, ' ');
const day = iso => (iso ? String(iso).slice(0, 10) : '—');
const indent = s => String(s).replace(/\n/g, '\n ');
function build(plan, P) {
const nameOf = id => P.members?.[id]?.name || id || '—';
const steps = plan.phases.flatMap(ph => (ph.steps || []).map(st => ({ ...st, phase: ph })));
const tasks = Object.fromEntries(steps.flatMap(st => (st.tasks || []).map(t => [t.id, { t, step: st }])));
const tstate = id => ({ status: 'todo', assignees: [], priority: 'normal', ...(P.tasks?.[id] || {}) });
const live = (sec, id) => Object.entries(P[sec] || {}).map(([k, v]) => ({ id: k, ...v })).filter(x => x.task === id && !x.deleted);
const items = id => [
...(tasks[id].t.subtasks || []).map(([sid, text]) => ({ id: sid, text })),
...live('custom', id).map(c => ({ id: c.id, text: c.text, own: nameOf(c.by) })),
];
const done = iid => !!P.items?.[iid]?.done;
const stats = id => { const it = items(id); return { done: it.filter(i => done(i.id)).length, total: it.length }; };
const comments = id => live('comments', id).sort((a, b) => String(a.created_at).localeCompare(String(b.created_at)));
const answer = (id, i) => P.answers?.[`${id}~${i}`];
function taskLine(id) {
const { t } = tasks[id], st = tstate(id), s = stats(id), cs = comments(id);
const q = (t.discuss || []).length, qa = (t.discuss || []).filter((_, i) => answer(id, i + 1)?.text).length;
const parts = [`${s.done}/${s.total}`];
if (st.assignees.length) parts.push(st.assignees.map(nameOf).join(', '));
if (st.priority !== 'normal') parts.push('приоритет: ' + PRIO[st.priority]);
if (st.due) parts.push('срок ' + st.due);
if (t.decision) parts.push('решение: ' + DEC[P.decisions?.[id]?.status || 'open']);
if (q) parts.push(`ответов на вопросы ${qa}/${q}`);
const blk = cs.filter(c => c.kind === 'blocker' && !c.resolved).length;
const oq = cs.filter(c => c.kind === 'question' && !c.resolved).length;
if (blk) parts.push(`БЛОКЕРЫ: ${blk}`);
if (oq) parts.push(`открытые вопросы в обсуждении: ${oq}`);
return `- [${STATUS[st.status] || st.status}] ${id} ${t.title} · ${parts.join(' · ')}`;
}
function stepBlock(st, detailed) {
const all = (st.tasks || []).map(t => stats(t.id)).reduce((a, s) => ({ d: a.d + s.done, n: a.n + s.total }), { d: 0, n: 0 });
const cur = plan.meta.current?.step === st.id ? ' ← ТЕКУЩИЙ' : '';
const L = [`## Шаг ${st.id} · ${st.title} (${st.period}, версия ${st.version})${cur} — пунктов ${all.d}/${all.n}`, oneLine(st.goal)];
if (!st.tasks) { if (st.preview) L.push('Планируется: ' + st.preview.join('; ')); return L; }
if (st.outcome) L.push('Результат шага: ' + st.outcome.join('; '));
L.push('');
(st.tasks || []).forEach(t => (detailed ? L.push(...taskDetail(t.id), '') : L.push(taskLine(t.id))));
return L;
}
function taskDetail(id) {
const { t, step } = tasks[id], st = tstate(id), s = stats(id);
const L = [`### [${id}] ${t.title}`,
`Шаг ${step.id} · области: ${(t.area || []).map(a => plan.areas[a] || a).join(', ')} · тип: ${plan.types[t.type] || t.type}${t.adr ? ' · ADR-' + t.adr : ''}`,
`Статус: ${STATUS[st.status]} · пункты ${s.done}/${s.total}` + (st.assignees.length ? ' · исполнители: ' + st.assignees.map(nameOf).join(', ') : '') + (st.due ? ' · срок ' + st.due : '') + (st.priority !== 'normal' ? ' · приоритет: ' + PRIO[st.priority] : '')];
if (t.why) L.push('', '**Зачем:** ' + oneLine(t.why));
if (t.body) L.push('', '**Описание:**', strip(t.body));
if (t.recommend) L.push('', '**Рекомендация:**', strip(t.recommend));
if (t.discuss?.length) {
L.push('', '**Вопросы:**');
t.discuss.forEach((q, i) => { const a = answer(id, i + 1); L.push(`- В${i + 1}: ${oneLine(q)}`, a?.text ? ` Ответ (${nameOf(a.by)}, ${day(a.at)}): ${indent(a.text)}` : ' Ответа нет'); });
}
if (t.decision) { const d = P.decisions?.[id] || {}; L.push('', `**Решение [${DEC[d.status || 'open']}]:** ${d.text ? indent(d.text) : '—'}`); }
L.push('', '**Выполнение:**', ...items(id).map(i => `- [${done(i.id) ? 'x' : ' '}] ${i.own ? `«${i.text}» (свой пункт, ${i.own}, ${i.id})` : `${i.id} ${oneLine(i.text)}`}`));
if (t.done) L.push('', '**Готово, когда:** ' + oneLine(t.done));
if (t.artifacts?.length) L.push('**Артефакты:** ' + t.artifacts.join(', '));
const n = P.notes?.[id];
if (n?.text?.trim()) L.push('', `**Заметка (${nameOf(n.by)}):**`, n.text.trim());
const cs = comments(id);
if (cs.length) { L.push('', '**Обсуждение:**'); cs.forEach(c => L.push(`- ${day(c.created_at)} ${nameOf(c.author)} [${KINDS[c.kind || 'comment']}${c.resolved ? ', решено' : ''}]: ${indent(c.text)}`)); }
const ls = live('links', id);
if (ls.length) L.push('', '**Ссылки:** ' + ls.map(l => (l.title ? l.title + ' — ' : '') + l.url).join('; '));
return L;
}
function recent(limit) {
const ev = [];
for (const [k, v] of Object.entries(P.items || {})) if (v?.done) ev.push([v.at, v.by, `отметил(а) пункт ${k}`]);
for (const [k, v] of Object.entries(P.tasks || {})) ev.push([v.at, v.by, `задача ${k}: ${STATUS[v.status] || v.status}`]);
for (const [k, v] of Object.entries(P.decisions || {})) ev.push([v.at, v.by, `решение ${k}: ${DEC[v.status || 'open']}${v.text ? ' — ' + oneLine(v.text).slice(0, 120) : ''}`]);
for (const [k, v] of Object.entries(P.answers || {})) if (v?.text) ev.push([v.at, v.by, `ответ на ${k.replace('~', ' В')}: ${oneLine(v.text).slice(0, 120)}`]);
for (const c of Object.values(P.comments || {})) if (!c.deleted) ev.push([c.created_at, c.author, `${KINDS[c.kind || 'comment']} в ${c.task}: ${oneLine(c.text).slice(0, 120)}`]);
return ev.filter(e => e[0]).sort((a, b) => String(b[0]).localeCompare(String(a[0]))).slice(0, limit)
.map(([at, by, text]) => `- ${String(at).slice(0, 16).replace('T', ' ')} ${nameOf(by)}: ${text}`);
}
return { steps, tasks, stepBlock, taskDetail, recent, nameOf };
}
async function main() {
const warn = [];
const [{ plan, source }, P] = await Promise.all([
loadPlan(warn),
get('/api/progress', 'json').catch(e => { throw new Error(`прогресс недоступен (${e.message}). Попросите пользователя вставить «Настройки → Сводка для AI».`); }),
]);
const R = build(plan, P);
const cur = plan.meta.current || {};
const out = [`# Дорожная карта «Штиль» · ревизия ${P.revision ?? '—'} · прогресс от ${day(P.updated_at)} · план от ${plan.meta.updated} (${source})`,
`Текущая фаза ${cur.phase}, шаг ${cur.step}. Команда: ${Object.values(P.members || {}).filter(m => !m.archived).map(m => m.name + (m.role ? ` (${m.role})` : '')).join(', ') || '—'}`];
if (warn.length) out.push(...warn.map(w => '> ВНИМАНИЕ: ' + w));
out.push('');
if (target && /^\d+\.\d+$/.test(target)) {
if (!R.tasks[target]) throw new Error(`задачи ${target} нет в плане`);
out.push(...R.taskDetail(target));
} else if (flag('--all')) {
R.steps.forEach(st => out.push(...R.stepBlock(st, !!st.tasks), ''));
} else {
const id = target || cur.step;
const st = R.steps.find(s => s.id === id);
if (!st) throw new Error(`шага ${id} нет в плане`);
out.push(...R.stepBlock(st, false), '', '## Последние изменения', ...R.recent(15));
const next = R.steps.filter(s => Number(s.id) > Number(id)).slice(0, 2).map(s => `${s.id} · ${s.title}`);
if (next.length) out.push('', 'Дальше: ' + next.join('; '));
}
process.stdout.write(out.join('\n') + '\n');
}
main().catch(e => { console.error('roadmap-context: ' + e.message); process.exit(1); });