#!/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(/
/gi, '\n')
.replace(/
/gi, '\n- ').replace(/]*>/gi, ' | ').replace(/<[^>]+>/g, '')
.replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"').replace(/\/g, '\\').replace(/&/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); });