@pghoya2956/livemap 1.2.0 → 1.3.0

package/src/check.mjs

@@ -5,6 +5,8 @@ import { problem } from './lib/issues.mjs';
 
 // derive가 만든 완성 문장을 코드로 가른다. 맞는 규칙이 없으면 마지막 대체 코드
 const STEP_WARNING = [[/^라우트 없음/, 'step.route-missing'], [/^참조 미해결/, 'step.ref-unresolved'], [/^장면은 동작인데/, 'step.screen-not-live'], [/^장면은 \S+인데 화면은 동작/, 'step.screen-live-early'], [/관측 근거 없음/, 'step.no-evidence'], [/^확인 필요/, 'step.review-stale']];
+// 로드맵 problem 중 경고로 내는 문장(1.3.0). 선행 흐름 문제라 화면은 멈추지 않고 CI도 막지 않는다
+const ROADMAP_WARNING = [[/^선행 순환/, 'roadmap.dep-cycle'], [/^마일스톤 순서 역행/, 'roadmap.milestone-backward']];
 const ROADMAP_PROBLEM = [[/^장면 없음/, 'roadmap.scene-missing'], [/^작업 폴더 없음/, 'roadmap.task-missing'], [/^선행 항목 없음/, 'roadmap.dep-missing'], [/^알 수 없는 상태/, 'roadmap.unknown-status'], [/^마일스톤 없음/, 'roadmap.milestone-missing']];
 const MILESTONE_PROBLEM = [[/: id 없음$/, 'milestone.no-id'], [/^마일스톤 id 중복/, 'milestone.duplicate-id'], [/: 알 수 없는 상태 /, 'milestone.unknown-status'], [/: 날짜 형식 /, 'milestone.bad-date']];
 const MILESTONE_WARNING = [[/: 완료인데 미완료 항목/, 'milestone.done-open-items'], [/: 항목이 모두 완료인데 상태/, 'milestone.all-items-done'], [/: 진행 항목이 있는데 상태/, 'milestone.running-items'], [/: 묶인 항목 없음$/, 'milestone.no-items'], [/: 완료일과 상태가 맞지 않음$/, 'milestone.completed-on-mismatch']];
@@ -42,7 +44,11 @@ export function checkProblems(d, cfg) {
   for (const m of d.roadmap || []) {
     const ms = subj('milestone', m.id);
     if (mids.has(m.id)) err('roadmap.duplicate-id', `로드맵 id 중복: ${m.id}`, ms); mids.add(m.id);
-    for (const p of m.problems) err(pick(ROADMAP_PROBLEM, p, 'roadmap.problem'), `로드맵 ${m.title}: ${p}`, ms);
+    for (const p of m.problems) {
+      const w = pick(ROADMAP_WARNING, p, null);
+      if (w) warn(w, `로드맵 ${m.title}: ${p}`, ms);
+      else err(pick(ROADMAP_PROBLEM, p, 'roadmap.problem'), `로드맵 ${m.title}: ${p}`, ms);
+    }
     if (m.status === '진행' && !m.tasks.length) warn('roadmap.running-no-task', `로드맵 ${m.title}: 진행인데 작업 폴더가 없음`, ms);
   }
   // 마일스톤: 문장은 derive가 만든다. 마일스톤 절이 없으면 줄이 없다

package/src/derive.mjs

@@ -39,6 +39,44 @@ export function splitWaiting(text) {
   return m ? { who: m[1].trim(), what: m[2] } : { who: null, what: t };
 }
 
+// 로드맵 선행의 흐름 문제(1.3.0): 선행 순환과 마일스톤 순서 역행. 화면 ui/lib/tree.js와 같은 규칙이고 check는 경고로 낸다.
+// 순환: 자기에게 되돌아오는 항목마다 자기에서 시작해 선행 → 후속 방향으로 돌아오는 가장 짧은 경로 한 문장.
+// 역행: 마일스톤이 있을 때 선행의 열(파일 순서, 미배정·없는 id는 맨 오른쪽)이 항목의 열보다 오른쪽이면 엣지마다 한 문장.
+function roadmapFlowProblems(items, releases) {
+  const out = new Map();
+  const add = (id, text) => { if (!out.has(id)) out.set(id, []); out.get(id).push(text); };
+  const ids = new Set(items.map((m) => m.id));
+  const deps = new Map(items.map((m) => [m.id, [...new Set(m.props.deps)].filter((d) => ids.has(d))]));
+  const children = new Map(items.map((m) => [m.id, []]));
+  for (const m of items) for (const d of deps.get(m.id)) children.get(d).push(m.id);
+  for (const m of items) {
+    const prev = new Map([[m.id, null]]);
+    const queue = [m.id];
+    let back = null;
+    for (let i = 0; i < queue.length && !back; i++) {
+      for (const c of children.get(queue[i])) {
+        if (c === m.id) { back = queue[i]; break; }
+        if (!prev.has(c)) { prev.set(c, queue[i]); queue.push(c); }
+      }
+    }
+    if (!back) continue;
+    const path = [m.id];
+    for (let x = back; x !== m.id; x = prev.get(x)) path.splice(1, 0, x);
+    add(m.id, `선행 순환: ${[...path, m.id].join(' → ')}`);
+  }
+  if (releases.length) {
+    const col = new Map(releases.map((r, i) => [r.id, i]));
+    const colOf = (m) => col.get(m.props.milestone) ?? releases.length;
+    const label = (m) => (col.has(m.props.milestone) ? m.props.milestone : '마일스톤 없음');
+    const byId = new Map(items.map((m) => [m.id, m]));
+    for (const m of items) for (const d of deps.get(m.id)) {
+      const p = byId.get(d);
+      if (colOf(p) > colOf(m)) add(m.id, `마일스톤 순서 역행: ${d}(${label(p)}) → ${m.id}(${label(m)})`);
+    }
+  }
+  return out;
+}
+
 export function derive(g, sem, cfg, { captureExists }) {
   const screens = g.of('screen'), apis = g.of('api'), fns = g.of('function'), tests = g.of('test'), commits = g.of('commit').sort((a, b) => b.props.date.localeCompare(a.props.date));
   const tasks = g.of('task'), decisions = g.of('decision').filter((d) => d.props.kind === 'wiki'), specDefs = g.of('decision').filter((d) => d.props.kind !== 'wiki');
@@ -181,6 +219,7 @@ export function derive(g, sem, cfg, { captureExists }) {
   const milestoneIds = new Set(milestones.map((m) => m.id));
   const releases = g.of('release').sort((a, b) => a.props.order - b.props.order);
   const releaseIds = new Set(releases.map((r) => r.id));
+  const flowProblems = roadmapFlowProblems(milestones, releases);
   const roadmap = milestones.map((m) => {
     const p = m.props;
     const scenes = p.scenes.map((r) => stepByRef[r] ? { ref: r, ...stepByRef[r] } : { ref: r, missing: true });
@@ -188,6 +227,7 @@ export function derive(g, sem, cfg, { captureExists }) {
     const problems = [...scenes.filter((s) => s.missing).map((s) => `장면 없음: ${s.ref}`), ...trackedTasks.filter((t) => t.missing).map((t) => `작업 폴더 없음: ${t.name}`), ...p.deps.filter((d) => !milestoneIds.has(d)).map((d) => `선행 항목 없음: ${d}`)];
     if (!ROADMAP_STATUS.includes(p.status)) problems.push(`알 수 없는 상태: ${p.status || '(비어 있음)'}`);
     if (p.milestone && !releaseIds.has(p.milestone)) problems.push(`마일스톤 없음 ${p.milestone}`);
+    problems.push(...(flowProblems.get(m.id) || []));
     const live = scenes.filter((s) => s.status === 'live').length;
     const deps = p.deps.map((d) => ({ id: d, title: milestones.find((x) => x.id === d)?.label || d, status: milestones.find((x) => x.id === d)?.props.status || null }));
     const waiting = splitWaiting(p.waitingOn);
@@ -315,10 +355,16 @@ export function overviewSlice(d, opts = {}) {
   const currentMilestone = (milestones.find((m) => m.status === '진행') || milestones.find((m) => m.status === '다음'))?.id ?? null;
   const openItems = (d.roadmap || []).filter((r) => r.status !== '완료').sort((a, b) => a.order - b.order);
 
+  // 캡처: 기능마다 동작 단계의 캡처 파일을 단계 순서로 최대 5장. 중복 제거는 기능 안에서만 하고 전체 상한은 없다(1.3.0, DEC-23)
   const captures = [];
   for (const j of d.semantic.journeys) {
-    const s = j.steps.find((x) => x.status === 'live' && x.captureFile && !captures.some((c) => c.file === x.captureFile));
-    if (s && captures.length < 5) captures.push({ file: s.captureFile, journey: j.id, step: s.id });
+    const files = new Set();
+    for (const s of j.steps) {
+      if (files.size >= 5) break;
+      if (s.status !== 'live' || !s.captureFile || files.has(s.captureFile)) continue;
+      files.add(s.captureFile);
+      captures.push({ file: s.captureFile, journey: j.id, step: s.id });
+    }
   }
   const changes = human.slice().sort((a, b) => Date.parse(b.date) - Date.parse(a.date)).slice(0, 20).map((c) => {
     const touched = new Set(c.journeys.map((x) => x.journey));

package/src/lib/issues.mjs

@@ -57,6 +57,9 @@ export const ISSUE_CODES = {
   'roadmap.running-no-task': code('warn', '로드맵 항목', ['source']),
   'roadmap.running-no-milestone': code('warn', '로드맵 항목', ['source']),
   'roadmap.running-open-deps': code('warn', '로드맵 항목', ['source']),
+  // 1.3.0: 선행 흐름 경고
+  'roadmap.dep-cycle': code('warn', '로드맵 항목', ['source']),
+  'roadmap.milestone-backward': code('warn', '로드맵 항목', ['source']),
   'milestone.no-id': code('error', '마일스톤', ['source']),
   'milestone.duplicate-id': code('error', '마일스톤', ['source']),
   'milestone.unknown-status': code('error', '마일스톤', ['source']),