onto-mcp 0.3.2 → 0.4.0

package/dist/core-runtime/evolve/renderers/draft-packet.js

@@ -1,303 +0,0 @@
-import { isPolicyChangeRequired } from "../../scope-runtime/types.js";
-import { findConstraint } from "../../scope-runtime/constraint-pool.js";
-import { formatPerspective } from "./format.js";
-/**
- * Render a Draft Packet — the document that presents deep constraint
- * discovery results and collects user decisions on each constraint.
- *
- * Pure function: (state, content) → string.
- *
- * - "처리하지 않으면" from pool.impact_if_ignored (single source).
- * - Summary table sorted: required → recommended, then CST-ID ascending.
- * - PO/Builder detail format determined by pool's decision_owner.
- * - Section 4 (Invalidated) auto-generated from pool; omitted if 0 items.
- * - Throws if constraint_id not in pool, or if detail targets an invalidated constraint.
- * - Section 2 "결정 필요 N건" canonical source = content.constraint_details (Section 3 실제 렌더 항목). status별 집계는 pool lookup.
- */
-export function renderDraftPacket(state, content) {
-    validate(state, content);
-    const lines = [];
-    lines.push(`## Draft Packet: ${state.title}`);
-    lines.push("");
-    renderSurface(lines, state, content);
-    renderStatus(lines, state, content);
-    renderConstraints(lines, state, content);
-    renderInvalidated(lines, state);
-    renderGuardrails(lines, content);
-    renderDecision(lines, state, content);
-    return lines.join("\n");
-}
-// ─── Validation ───
-function validate(state, content) {
-    const missingIds = content.constraint_details
-        .map((d) => d.constraint_id)
-        .filter((id) => findConstraint(state.constraint_pool, id) === undefined);
-    if (missingIds.length > 0) {
-        throw new Error(`renderDraftPacket: constraint_id not found in pool: ${missingIds.join(", ")}. constraint.discovered 이벤트로 해당 ID를 pool에 먼저 등록하세요.`);
-    }
-    for (const d of content.constraint_details) {
-        const entry = findConstraint(state.constraint_pool, d.constraint_id);
-        if (entry.decision_owner !== d.decision_owner) {
-            const fix = entry.decision_owner === "builder"
-                ? "ConstraintDetailBuilder 형식(builder_decision, builder_judgment)으로 변경하세요"
-                : "ConstraintDetailPO 형식(options_table, recommendation)으로 변경하세요";
-            throw new Error(`renderDraftPacket: decision_owner mismatch for ${d.constraint_id} — pool: "${entry.decision_owner}", content: "${d.decision_owner}". ${fix}`);
-        }
-        // W-B-09: constraint source 일치 가드 — pool에 source_refs가 없는 constraint reject
-        if (!entry.source_refs || entry.source_refs.length === 0) {
-            throw new Error(`renderDraftPacket: constraint ${d.constraint_id} has no source_refs in pool. constraint.discovered 이벤트에 source_refs를 포함하세요.`);
-        }
-        // invalidated constraint 는 Section 4(자동 생성)에서만 노출되어야 함. Section 3 detail로 들어오면 중복/모순 발생.
-        if (entry.status === "invalidated") {
-            throw new Error(`renderDraftPacket: constraint ${d.constraint_id} is invalidated — must not appear in constraint_details. Invalidated constraints are auto-rendered in Section 4.`);
-        }
-    }
-}
-// ─── Section 1: 확정된 Surface ───
-function renderSurface(lines, state, content) {
-    lines.push("### 1. 확정된 Surface");
-    lines.push("");
-    lines.push(`- **scope type**: ${state.entry_mode}`);
-    lines.push(`- **surface location**: \`${content.surface_path}\``);
-    if (content.run_command) {
-        lines.push(`- **실행 방법**: \`${content.run_command}\``);
-    }
-    if (content.mockup_revisions !== undefined) {
-        lines.push(`- **mockup 반복**: ${content.mockup_revisions}회 수정 후 주체자 확정`);
-    }
-    lines.push("");
-    if (content.scenario_guide.length > 0) {
-        lines.push("**시나리오 가이드:**");
-        lines.push("");
-        lines.push("| 시나리오 | 시작 | 동작 순서 | 확인된 동작 |");
-        lines.push("|---------|------|----------|------------|");
-        for (const s of content.scenario_guide) {
-            lines.push(`| ${s.scenario} | ${s.start} | ${s.steps} | ${s.confirmed} |`);
-        }
-        lines.push("");
-    }
-    lines.push("---");
-    lines.push("");
-}
-// ─── Section 2: 현재까지의 결정 현황 (자동 생성) ───
-function renderStatus(lines, state, content) {
-    lines.push("### 2. 현재까지의 결정 현황");
-    lines.push("");
-    // Align decisions
-    const alignItems = [];
-    if (state.direction)
-        alignItems.push("방향 승인");
-    if (state.scope_boundaries)
-        alignItems.push("범위 확정");
-    const groundingCSTs = state.constraint_pool.constraints
-        .filter((c) => c.discovery_stage === "grounding")
-        .map((c) => c.constraint_id);
-    if (groundingCSTs.length > 0) {
-        alignItems.push(`${groundingCSTs.join(", ")} 인지 완료`);
-    }
-    lines.push(`- Align에서 결정: ${alignItems.join(", ")}`);
-    // Canonical source for Section 2 active count = content.constraint_details (Section 3에 실제로 렌더되는 항목들).
-    // status별 집계는 pool에서 lookup — detail id set ∩ pool 의 status 합.
-    const active = content.constraint_details.length;
-    let decided = 0;
-    let undecided = 0;
-    let clarifyPending = 0;
-    for (const d of content.constraint_details) {
-        const entry = findConstraint(state.constraint_pool, d.constraint_id);
-        if (entry.status === "decided")
-            decided++;
-        else if (entry.status === "clarify_pending")
-            clarifyPending++;
-        else
-            undecided++;
-    }
-    lines.push(`- Draft에서 결정 필요: 아래 ${active}건 (${decided}건 결정 완료, ${undecided + clarifyPending}건 미결정)`);
-    // Lock condition — clarify_pending은 pool.summary가 runtime 사실 source (Section 3 렌더와 독립적 gate).
-    const poolClarify = state.constraint_pool.summary.clarify_pending;
-    if (poolClarify > 0) {
-        lines.push(`- 잠금 전 필수 해소: \`clarify\` 상태 항목이 ${poolClarify}건 있어 잠글 수 없음`);
-    }
-    else {
-        lines.push("- 잠금 전 필수 해소: `clarify` 상태 항목이 있으면 잠글 수 없음");
-    }
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-}
-// ─── Section 3: 결정이 필요한 항목 ───
-function renderConstraints(lines, state, content) {
-    lines.push("### 3. 결정이 필요한 항목 — 확정된 mockup 기준");
-    lines.push("");
-    if (content.constraint_details.length === 0) {
-        lines.push("발견된 제약이 없습니다.");
-        lines.push("");
-        lines.push("---");
-        lines.push("");
-        return;
-    }
-    // Sorted entries: required → recommended, then CST-ID
-    const sorted = sortConstraintDetails(content.constraint_details, state);
-    // Summary table
-    lines.push("#### 요약");
-    lines.push("");
-    lines.push("| CST-ID | 관점 | 요약 | severity(중요도) |");
-    lines.push("|--------|------|------|--------|");
-    for (const d of sorted) {
-        const entry = findConstraint(state.constraint_pool, d.constraint_id);
-        const severityLabel = formatSeverity(entry, d);
-        lines.push(`| ${d.constraint_id} | ${formatPerspective(entry.perspective)} | ${entry.summary} | ${severityLabel} |`);
-    }
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-    // Individual details
-    for (const d of sorted) {
-        const entry = findConstraint(state.constraint_pool, d.constraint_id);
-        renderConstraintDetail(lines, d, entry);
-    }
-}
-function renderConstraintDetail(lines, detail, entry) {
-    const severityTag = entry.severity === "required" ? "필수" : "권장";
-    const policyTag = isPolicyChangeRequired(entry) ? " [정책 변경 검토 필요]" : "";
-    const ownerTag = detail.decision_owner === "builder" ? " (Builder 결정 항목)" : "";
-    lines.push(`#### ${detail.constraint_id} | ${formatPerspective(entry.perspective)} | ${entry.summary} — ${severityTag}${policyTag}${ownerTag}`);
-    lines.push("");
-    lines.push(`**상황:** ${detail.situation}`);
-    lines.push("");
-    lines.push(`**처리하지 않으면:** ${entry.impact_if_ignored}`);
-    lines.push("");
-    if (isPolicyChangeRequired(entry)) {
-        lines.push(`> **정책 변경 전제**: 이 항목은 기존 정책 변경을 전제합니다(requires_policy_change=true). inject 결정 시 구현 전 법무/정책 검토가 필요합니다.`);
-        lines.push(`> 해소 경로: (1) evidence_updated 이벤트로 requires_policy_change=false 설정 (2) 정책 검토 완료 후 evidence_note에 근거 기록`);
-        lines.push("");
-    }
-    if (detail.decision_owner === "product_owner") {
-        // PO detail
-        lines.push("**선택지:**");
-        lines.push("");
-        lines.push("| 선택 | 이점 | 내용 | 리스크 | 되돌림 비용 |");
-        lines.push("|------|------|------|--------|------------|");
-        for (const opt of detail.options_table) {
-            lines.push(`| ${opt.choice} | ${opt.pros} | ${opt.description} | ${opt.risk} | ${opt.reversal_cost} |`);
-        }
-        lines.push("");
-        lines.push(`추천: ${detail.recommendation}`);
-        lines.push("");
-        lines.push("선택: ___");
-    }
-    else {
-        // Builder detail
-        lines.push(`**Builder가 결정할 사항:** ${detail.builder_decision}`);
-        lines.push("");
-        lines.push(`**이 작업 관점에서의 판단:** ${detail.builder_judgment}`);
-        lines.push("");
-        if (detail.guardrail) {
-            lines.push(`**guardrail:** ${detail.guardrail}`);
-            lines.push("");
-            lines.push("Builder 결정 예정 — 위 guardrail 확인 후 승인: ___");
-        }
-        else {
-            lines.push("Builder 결정 예정 — 제품 관점 제약 조건 없음. 승인: ___");
-        }
-    }
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-}
-// ─── Section 4: 시스템이 제외한 항목 (자동, 조건부) ───
-function renderInvalidated(lines, state) {
-    const invalidated = state.constraint_pool.constraints.filter((c) => c.status === "invalidated");
-    if (invalidated.length === 0)
-        return;
-    lines.push("### 4. 시스템이 제외한 항목");
-    lines.push("");
-    lines.push("| CST-ID | 관점 | 요약 | 제외 사유 |");
-    lines.push("|--------|------|------|----------|");
-    for (const c of invalidated) {
-        lines.push(`| ${c.constraint_id} | ${formatPerspective(c.perspective)} | ${c.summary} | ${c.invalidation_reason ?? ""} |`);
-    }
-    lines.push("");
-    // Required severity warning
-    const requiredInvalidated = invalidated.filter((c) => c.severity === "required");
-    if (requiredInvalidated.length > 0) {
-        for (const c of requiredInvalidated) {
-            lines.push(`> **${c.constraint_id}**: 이 항목은 기능 불능 또는 규정 위반으로 분류되었습니다. 제외에 동의하시나요?`);
-        }
-        lines.push("");
-    }
-    lines.push("동의하지 않으면 해당 항목을 결정 목록으로 복원할 수 있습니다.");
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-}
-// ─── Section 5: 제약 조건 ───
-function renderGuardrails(lines, content) {
-    lines.push("### 5. 제약 조건 (구현 시 반드시 지켜야 할 것)");
-    lines.push("");
-    if (content.guardrails.length === 0) {
-        lines.push("없음");
-    }
-    else {
-        for (const g of content.guardrails) {
-            lines.push(`- ${g}`);
-        }
-    }
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-}
-// ─── Section 6: 지금 결정할 것 ───
-function renderDecision(lines, state, content) {
-    lines.push("### 6. 지금 결정할 것");
-    lines.push("");
-    if (content.constraint_details.length === 0) {
-        lines.push("발견된 제약이 없으므로, Approve만 선택하시면 됩니다.");
-        lines.push("");
-        lines.push("- **Approve**: 위 결정에 동의하며, compile 단계로 진행합니다. 각 CST에 대한 결정을 함께 제출해 주세요.");
-        lines.push("- **Revise**: 피드백을 주시면 Draft Packet을 수정하여 다시 보여드립니다.");
-        lines.push("- **Reject**: 이 scope를 거절하고 종료합니다.");
-        lines.push("- **Redirect to Align**: 방향 자체를 재검토하기 위해 Align 단계로 돌아갑니다.");
-        lines.push("- **Review**: 이 Packet 전체에 대해 6-Agent Panel Review를 요청합니다.");
-        lines.push("");
-        lines.push("선택: **Approve** / **Revise** / **Reject** / **Redirect to Align** / **Review**");
-    }
-    else {
-        for (let i = 0; i < content.decision_questions.length; i++) {
-            lines.push(`${i + 1}. ${content.decision_questions[i]}`);
-        }
-        lines.push("");
-        if (state.constraint_pool.summary.clarify_pending > 0) {
-            lines.push(`> \`clarify\`를 선택한 항목은 해소될 때까지 잠글 수 없습니다 (현재 ${state.constraint_pool.summary.clarify_pending}건)`);
-            lines.push("");
-        }
-        lines.push("모든 결정이 완료되면 compile을 시작합니다.");
-        lines.push("");
-        lines.push("- **Approve**: 위 결정에 동의하며, compile 단계로 진행합니다. 각 CST에 대한 결정을 함께 제출해 주세요.");
-        lines.push("- **Revise**: 피드백을 주시면 Draft Packet을 수정하여 다시 보여드립니다.");
-        lines.push("- **Reject**: 이 scope를 거절하고 종료합니다.");
-        lines.push("- **Redirect to Align**: 방향 자체를 재검토하기 위해 Align 단계로 돌아갑니다.");
-        lines.push("- **Review**: 이 Packet 전체에 대해 6-Agent Panel Review를 요청합니다.");
-        lines.push("");
-        lines.push("선택: **Approve** + 각 CST 결정 / **Revise** / **Reject** / **Redirect to Align** / **Review**");
-    }
-    lines.push("");
-}
-// ─── Helpers ───
-function sortConstraintDetails(details, state) {
-    return [...details].sort((a, b) => {
-        const entryA = findConstraint(state.constraint_pool, a.constraint_id);
-        const entryB = findConstraint(state.constraint_pool, b.constraint_id);
-        // required first
-        if (entryA.severity !== entryB.severity) {
-            return entryA.severity === "required" ? -1 : 1;
-        }
-        // then CST-ID ascending
-        return a.constraint_id.localeCompare(b.constraint_id);
-    });
-}
-function formatSeverity(entry, detail) {
-    const base = entry.severity === "required" ? "필수" : "권장";
-    const suffix = detail.decision_owner === "builder" ? " (Builder 결정)" : "";
-    return `${base}${suffix}`;
-}
-// formatPerspective is imported from ./format.ts