tea-sdlc/test/sdlc-analyze-assets.test.js

/**
 * sdlc-analyze 的交付物：四份可行性檢查清單與流程正本。
 * 這一段不寫入 Gitea，所以沒有腳本——交付的就是這些文件本身。
 */
import test from 'node:test';
import assert from 'node:assert/strict';
import { assertNeutralPrompt, promptStep, readPrompt, readReference } from './helpers/prompt-doc.js';

const prompt = readPrompt('sdlc-analyze');

/** 四類檢查，順序即提問順序 */
const CHECKS = [
  { kind: '架構', file: 'feasibility-architecture' },
  { kind: '邏輯', file: 'feasibility-logic' },
  { kind: '資料', file: 'feasibility-data' },
  { kind: '時程', file: 'feasibility-schedule' },
];

// ── 規則正本 ───────────────────────────────────────────────────────

test('四份可行性檢查清單各自存在且有檢查項', () => {
  for (const { kind, file } of CHECKS) {
    const reference = readReference(file);
    const items = [...reference.matchAll(/^\d+\.\s+\*\*(.+?)\*\*/gm)];
    assert.ok(items.length >= 4, `${kind}清單至少要有四條檢查項，目前 ${items.length} 條`);
  }
});

test('每份清單都交代了「問題怎麼問」，不只列檢查項', () => {
  for (const { kind, file } of CHECKS) {
    assert.match(readReference(file), /## 問題怎麼問/, `${kind}清單缺少提問指引`);
  }
});

test('各清單涵蓋議題點名的重點', () => {
  assert.match(readReference('feasibility-architecture'), /循環相依/);
  assert.match(readReference('feasibility-logic'), /既有功能/);
  assert.match(readReference('feasibility-data'), /schema/);
  assert.match(readReference('feasibility-data'), /遷移/);
  assert.match(readReference('feasibility-data'), /交易邊界/);
  assert.match(readReference('feasibility-schedule'), /最長路徑/);
  assert.match(readReference('feasibility-schedule'), /未知數最大/);
});

// ── 流程正本 ───────────────────────────────────────────────────────

test('正本平台中立，description 前綴正確', () => {
  assertNeutralPrompt(prompt, 'sdlc-analyze');
});

test('正本逐一指名四份規則正本，且順序為架構→邏輯→資料→時程', () => {
  const positions = CHECKS.map(({ file }) => prompt.indexOf(`references/${file}.md`));
  assert.equal(positions.every((p) => p >= 0), true, '四份清單都要被正本指名讀取');
  assert.deepEqual([...positions].sort((a, b) => a - b), positions, '指名順序需為架構→邏輯→資料→時程');
});

test('正本明令一次只問一題', () => {
  assert.match(prompt, /一次問一題/);
  assert.match(prompt, /不要一次丟出/);
});

test('正本規定每題固定兩個選項：建議（含理由）與手動輸入', () => {
  assert.match(prompt, /\*\*建議\*\*/);
  assert.match(prompt, /理由/);
  assert.match(prompt, /\*\*手動輸入\*\*/);
  assert.match(prompt, /不被選項限制/);
});

test('正本要求前一類問完才進下一類', () => {
  assert.match(prompt, /前一類的問題全部清空才進入下一類/);
});

test('正本規定最後輸出共識摘要，且摘要只印不寫', () => {
  assert.match(prompt, /共識摘要/);
  assert.match(prompt, /只印在終端/);
  assert.match(prompt, /不寫回議題/);
});

test('正本把「共識摘要之前不寫入」寫成明確邊界', () => {
  const boundary = prompt.slice(prompt.indexOf('## 邊界'));
  assert.match(boundary, /共識摘要之前不對 Gitea 寫入任何內容/);
  assert.match(boundary, /不建議題/);
  assert.match(boundary, /不留留言/);
});

test('第一段在共識摘要之前不寫入任何內容，碼錶是唯一的例外', () => {
  const analysis = prompt.slice(prompt.indexOf('## 第一段'), prompt.indexOf('## 第二段'));
  for (const writer of ['issue-create', 'issue-update', 'issue-link', 'project-add']) {
    assert.equal(analysis.includes(writer), false, `第一段不該出現寫入型腳本 ${writer}`);
  }
  assert.match(analysis, /timer\.js/, '錶要起在第一段開頭，分析最耗時的正是共識之前那一段');
});

// ── 計時 ───────────────────────────────────────────────────────────

test('起錶排在第一段開頭，停錶排在最後的回報，兩者成對出現', () => {
  const 起 = prompt.indexOf(promptStep(prompt, '起錶'));
  assert.ok(起 > prompt.indexOf(promptStep(prompt, '讀議題')), '讀完議題確認它存在之後才起');
  assert.ok(起 < prompt.indexOf('## 第二段'), '起錶要在第一段之內：分析最耗時的是共識之前那一段');
  assert.match(promptStep(prompt, '停錶並回報'), /--stop/, '停錶與最後的回報寫在同一步');
});

test('起錶與停錶指的都是同一顆需求議題', () => {
  const 計時段 = [...prompt.matchAll(/node scripts\/timer\.js[^\n]*/g)].map((m) => m[0]);
  assert.ok(計時段.length >= 2, '起錶與停錶都要寫在正本裡');
  for (const line of 計時段) {
    assert.match(line, /--index <需求議題編號>/, `錶要起停在需求議題上：${line}`);
  }
});

test('正本寫出這段計時涵蓋到哪，讀的人不必自己推', () => {
  assert.match(prompt, /## 計時範圍/);
  assert.match(prompt, /錶不跨階段跑/);
});

test('正本交代錶已經跑在同一顆上時不重起，不把累積時間切成兩段', () => {
  assert.match(prompt, /切成兩段/);
});

test('正本明令不代停別顆議題上的錶', () => {
  assert.match(prompt, /請他自己去停/);
  assert.match(prompt, /不停別顆議題上的錶/);
});

test('邊界把碼錶從「不寫入」裡明文除外，並寫出理由', () => {
  const boundary = prompt.slice(prompt.indexOf('## 邊界'));
  assert.match(boundary, /碼錶除外/);
  assert.match(boundary, /工時/, '要說清楚碼錶記的是工時不是內容，否則下一個人會把它刪掉');
});

test('正本要求先看未處理留言數，不是 0 就提示先整併', () => {
  assert.match(prompt, /未處理留言數/);
  assert.match(prompt, /sdlc-sync/);
  assert.match(prompt, /先停下來|先整併/);
});

test('正本指名由 issue-extract 讀議題，而不是自己讀全文', () => {
  assert.match(prompt, /issue-extract/);
  assert.match(prompt, /不必再讀整份議題全文/);
});

test('正本要求能自己查證的就不要拿去問使用者', () => {
  assert.match(prompt, /能在程式碼裡查證的就自己去查/);
});

test('時程清單交代了「這階段還沒有工作包」該怎麼估', () => {
  // 相依鏈最長路徑預設了一份拆法，而分析階段還沒有工作包可依
  assert.match(readReference('feasibility-schedule'), /暫定拆法/);
  assert.match(readReference('feasibility-schedule'), /還沒有工作包/);
});