onto-mcp 0.3.2 → 0.4.0

package/dist/core-runtime/evolve/renderers/scope-md.test.js

@@ -1,306 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { renderScopeMd } from "./scope-md.js";
-import { reduce } from "../../scope-runtime/reducer.js";
-// ─── Helpers ───
-function emptyPool() {
-    return {
-        constraints: [],
-        summary: { total: 0, required: 0, recommended: 0, decided: 0, clarify_pending: 0, invalidated: 0, undecided: 0 },
-    };
-}
-function makeState(overrides = {}) {
-    return {
-        scope_id: "SC-TEST",
-        title: "테스트 Scope",
-        description: "테스트용",
-        entry_mode: "experience",
-        current_state: "draft",
-        constraint_pool: emptyPool(),
-        stale: false,
-        compile_ready: false,
-        convergence_blocked: false,
-        revision_count_align: 0,
-        revision_count_surface: 0,
-        retry_count_compile: 0,
-        snapshot_revision: 0,
-        pre_apply_completed: false,
-        prd_review_completed: false,
-        verdict_log: [],
-        feedback_history: [],
-        latest_revision: 0,
-        ...overrides,
-    };
-}
-// ─── Golden data ───
-describe("scope-md — golden data", () => {
-    it("renders scope.md from golden events", () => {
-        const goldenPath = resolve(import.meta.dirname, "../../scope-runtime/__fixtures__/example-tutor-block/events.ndjson");
-        const events = readFileSync(goldenPath, "utf-8")
-            .trimEnd()
-            .split("\n")
-            .map((line) => JSON.parse(line));
-        const state = reduce(events);
-        const md = renderScopeMd(state);
-        expect(md).toContain("# Scope: 튜터 차단 기능");
-        expect(md).toContain("Build Spec 생성 완료");
-        expect(md).toContain("방향");
-        expect(md).toContain("학생이 튜터를 차단하면");
-        expect(md).toContain("전체: 8건");
-        expect(md).toContain("결정 완료: 8건");
-        expect(md).toContain("revision 29");
-        // verdict_log shows last 5: CST-004~008 (CST-001 is older, trimmed)
-        expect(md).toContain("CST-008");
-    });
-});
-// ─── Structure tests ───
-describe("scope-md — structure", () => {
-    it("renders header with title from state", () => {
-        const md = renderScopeMd(makeState({ title: "My Scope" }));
-        expect(md).toContain("# Scope: My Scope");
-    });
-    it("shows current state in human-readable form", () => {
-        const md = renderScopeMd(makeState({ current_state: "surface_confirmed" }));
-        expect(md).toContain("Surface 확정됨");
-    });
-    it("shows direction when present", () => {
-        const md = renderScopeMd(makeState({ direction: "test direction" }));
-        expect(md).toContain("**방향**: test direction");
-    });
-    it("omits direction when absent", () => {
-        const md = renderScopeMd(makeState());
-        expect(md).not.toContain("**방향**");
-    });
-    it("shows scope boundaries when locked", () => {
-        const md = renderScopeMd(makeState({
-            scope_boundaries: { in: ["기능A", "기능B"], out: ["기능C"] },
-        }));
-        expect(md).toContain("## 범위");
-        expect(md).toContain("기능A");
-        expect(md).toContain("기능C");
-    });
-    it("omits scope boundaries when not locked", () => {
-        const md = renderScopeMd(makeState());
-        expect(md).not.toContain("## 범위");
-    });
-});
-// ─── Next action ───
-describe("scope-md — next action", () => {
-    it("draft → scan sources", () => {
-        const md = renderScopeMd(makeState({ current_state: "draft" }));
-        expect(md).toContain("/start");
-    });
-    it("surface_confirmed with undecided → decide constraints", () => {
-        const pool = emptyPool();
-        pool.summary.total = 3;
-        pool.summary.undecided = 2;
-        const md = renderScopeMd(makeState({ current_state: "surface_confirmed", constraint_pool: pool }));
-        expect(md).toContain("2건의 제약 사항");
-    });
-    it("surface_confirmed with clarify_pending → resolve clarify", () => {
-        const pool = emptyPool();
-        pool.summary.total = 3;
-        pool.summary.clarify_pending = 1;
-        const md = renderScopeMd(makeState({ current_state: "surface_confirmed", constraint_pool: pool }));
-        expect(md).toContain("clarify");
-    });
-    it("closed → scope terminated", () => {
-        const md = renderScopeMd(makeState({ current_state: "closed" }));
-        expect(md).toContain("종료");
-    });
-});
-// ─── Blockers ───
-describe("scope-md — blockers", () => {
-    it("shows stale blocker with source details", () => {
-        const md = renderScopeMd(makeState({
-            stale: true,
-            stale_sources: [{ path: "src/a.ts", old_hash: "h1", new_hash: "h2" }],
-            stale_since: 10,
-        }));
-        expect(md).toContain("## 차단 상태");
-        expect(md).toContain("src/a.ts");
-        expect(md).toContain("revision 10");
-    });
-    it("shows convergence blocker", () => {
-        const md = renderScopeMd(makeState({ convergence_blocked: true }));
-        expect(md).toContain("수렴 차단");
-    });
-    it("shows clarify blocker", () => {
-        const pool = emptyPool();
-        pool.summary.total = 2;
-        pool.summary.clarify_pending = 1;
-        const md = renderScopeMd(makeState({ constraint_pool: pool }));
-        expect(md).toContain("clarify 미해소");
-    });
-    it("omits blocker section when no blockers", () => {
-        const md = renderScopeMd(makeState());
-        expect(md).not.toContain("## 차단 상태");
-    });
-});
-// ─── Constraint summary ───
-describe("scope-md — constraint summary", () => {
-    it("shows constraint counts", () => {
-        const pool = emptyPool();
-        pool.summary = { total: 8, required: 3, recommended: 5, decided: 6, clarify_pending: 1, invalidated: 0, undecided: 1 };
-        const md = renderScopeMd(makeState({ constraint_pool: pool }));
-        expect(md).toContain("전체: 8건");
-        expect(md).toContain("필수 3");
-        expect(md).toContain("결정 완료: 6건");
-        expect(md).toContain("미결정: 1건");
-        expect(md).toContain("clarify 대기: 1건");
-    });
-    it("omits constraint section when total is 0", () => {
-        const md = renderScopeMd(makeState());
-        expect(md).not.toContain("## Constraint 현황");
-    });
-});
-// ─── Edge cases: convergence_blocked override, stale with undefined, empty verdict_log ───
-describe("scope-md — edge cases", () => {
-    it("convergence_blocked overrides next action message", () => {
-        const md = renderScopeMd(makeState({
-            current_state: "surface_iterating",
-            convergence_blocked: true,
-        }));
-        expect(md).toContain("수렴 차단 상태입니다");
-        expect(md).toContain("방향 변경");
-    });
-    it("stale with undefined stale_sources shows '알 수 없음'", () => {
-        const md = renderScopeMd(makeState({
-            stale: true,
-            stale_sources: undefined,
-            stale_since: undefined,
-        }));
-        expect(md).toContain("알 수 없음");
-        expect(md).toContain("?");
-    });
-    it("empty verdict_log omits 최근 결정 section", () => {
-        const md = renderScopeMd(makeState({ verdict_log: [] }));
-        expect(md).not.toContain("## 최근 결정");
-    });
-    it("verdict_log with clarify_resolved renders correctly", () => {
-        const md = renderScopeMd(makeState({
-            verdict_log: [
-                { type: "constraint.clarify_resolved", revision: 15, ts: "2026-01-01T00:00:15Z", constraint_id: "CST-002", decision: "inject", decision_owner: "product_owner" },
-            ],
-        }));
-        expect(md).toContain("## 최근 결정");
-        expect(md).toContain("CST-002 clarify 해소");
-        expect(md).toContain("inject");
-    });
-    it("constraint summary omits undecided/clarify/invalidated lines when zero", () => {
-        const pool = emptyPool();
-        pool.summary = { total: 3, required: 2, recommended: 1, decided: 3, clarify_pending: 0, invalidated: 0, undecided: 0 };
-        const md = renderScopeMd(makeState({ constraint_pool: pool }));
-        expect(md).toContain("전체: 3건");
-        expect(md).toContain("결정 완료: 3건");
-        expect(md).not.toContain("미결정:");
-        expect(md).not.toContain("clarify 대기:");
-        expect(md).not.toContain("제외됨:");
-    });
-    it("terminal states show appropriate messages", () => {
-        expect(renderScopeMd(makeState({ current_state: "closed" }))).toContain("완료");
-        expect(renderScopeMd(makeState({ current_state: "deferred" }))).toContain("보류");
-        expect(renderScopeMd(makeState({ current_state: "rejected" }))).toContain("거절");
-    });
-});
-// ─── Backward transition ───
-describe("scope-md — backward transition", () => {
-    it("shows compile retry blocker when constraints_resolved with retry_count > 0", () => {
-        const md = renderScopeMd(makeState({
-            current_state: "constraints_resolved",
-            retry_count_compile: 1,
-        }));
-        expect(md).toContain("## 차단 상태");
-        expect(md).toContain("compile 중 새 제약이 발견되어 결정이 필요합니다");
-        expect(md).toContain("재시도 1/3회");
-    });
-    it("shows retry count 2/3 in blocker message", () => {
-        const md = renderScopeMd(makeState({
-            current_state: "constraints_resolved",
-            retry_count_compile: 2,
-        }));
-        expect(md).toContain("재시도 2/3회");
-    });
-    it("does not show compile retry blocker when retry_count is 0", () => {
-        const md = renderScopeMd(makeState({
-            current_state: "constraints_resolved",
-            retry_count_compile: 0,
-        }));
-        expect(md).not.toContain("compile 중 새 제약이 발견되어");
-    });
-    it("does not show compile retry blocker for other states even with retry_count > 0", () => {
-        const md = renderScopeMd(makeState({
-            current_state: "target_locked",
-            retry_count_compile: 1,
-        }));
-        expect(md).not.toContain("compile 중 새 제약이 발견되어");
-    });
-});
-// ─── Verdict log ───
-describe("scope-md — verdict log", () => {
-    it("shows recent decisions (last 5)", () => {
-        const md = renderScopeMd(makeState({
-            verdict_log: [
-                { type: "align.locked", revision: 8, ts: "2026-01-01T00:00:08Z", locked_direction: "dir" },
-                { type: "constraint.decision_recorded", revision: 19, ts: "2026-01-01T00:00:19Z", constraint_id: "CST-001", decision: "inject", decision_owner: "product_owner" },
-            ],
-        }));
-        expect(md).toContain("## 최근 결정");
-        expect(md).toContain("방향 확정");
-        expect(md).toContain("CST-001");
-        expect(md).toContain("inject");
-    });
-    it("omits verdict section when empty", () => {
-        const md = renderScopeMd(makeState());
-        expect(md).not.toContain("## 최근 결정");
-    });
-});
-// ─── requires_policy_change rendering ───
-describe("scope-md — requires_policy_change count", () => {
-    it("shows policy change count when requires_policy_change constraints exist", () => {
-        const pool = {
-            constraints: [
-                {
-                    constraint_id: "CST-001", perspective: "policy", summary: "s",
-                    severity: "required", discovery_stage: "draft_phase2",
-                    decision_owner: "product_owner", impact_if_ignored: "i",
-                    source_refs: [{ source: "t.ts", detail: "d" }],
-                    evidence_status: "unverified",
-                    status: "decided", decision: "inject", discovered_at: 1, decided_at: 2,
-                    requires_policy_change: true,
-                },
-                {
-                    constraint_id: "CST-002", perspective: "code", summary: "s2",
-                    severity: "recommended", discovery_stage: "draft_phase2",
-                    decision_owner: "product_owner", impact_if_ignored: "i",
-                    source_refs: [{ source: "t.ts", detail: "d" }],
-                    evidence_status: "unverified",
-                    status: "decided", decision: "inject", discovered_at: 1, decided_at: 2,
-                    requires_policy_change: false,
-                },
-            ],
-            summary: { total: 2, required: 1, recommended: 1, decided: 2, clarify_pending: 0, invalidated: 0, undecided: 0 },
-        };
-        const md = renderScopeMd(makeState({ constraint_pool: pool }));
-        expect(md).toContain("정책 변경 검토 필요: 1건");
-    });
-    it("omits policy change count when no requires_policy_change constraints", () => {
-        const pool = {
-            constraints: [
-                {
-                    constraint_id: "CST-001", perspective: "code", summary: "s",
-                    severity: "recommended", discovery_stage: "draft_phase2",
-                    decision_owner: "product_owner", impact_if_ignored: "i",
-                    source_refs: [{ source: "t.ts", detail: "d" }],
-                    evidence_status: "unverified",
-                    status: "decided", decision: "inject", discovered_at: 1, decided_at: 2,
-                    requires_policy_change: false,
-                },
-            ],
-            summary: { total: 1, required: 0, recommended: 1, decided: 1, clarify_pending: 0, invalidated: 0, undecided: 0 },
-        };
-        const md = renderScopeMd(makeState({ constraint_pool: pool }));
-        expect(md).not.toContain("정책 변경 검토 필요");
-    });
-});

package/dist/core-runtime/govern/cli.js

@@ -1,369 +0,0 @@
-/**
- * govern runtime adapter (W-C-01, bounded minimum surface v0).
- *
- * Subcommands: submit / list / decide (queue pattern).
- *
- * Responsibility split (consistent with evolve propose-align precedent):
- *   - runtime adapter owns: queue I/O, event log append, deterministic projection, table/JSON rendering.
- *   - LLM / agent owns: proposal authoring (payload JSON assembly), judgment reasoning.
- *
- * v0 scope: 기록만. decide approve 후 authority 파일 실제 반영은 주체자 수동 편집 or W-C-02.
- * 승인 강제 차단 (pre-commit/CI/merge gate) 도 W-C-02.
- */
-import { appendQueueEvent, generateGovernId, projectQueue, readQueueEvents, resolveQueuePath, } from "./queue.js";
-import { routeProposal } from "./drift-engine.js";
-import { executePromotePrinciple } from "./promote-principle.js";
-import { originToTag } from "./types.js";
-export async function handleGovernCli(_ontoHome, argv) {
-    const subcommand = argv[0];
-    const subArgv = argv.slice(1);
-    switch (subcommand) {
-        case "submit":
-            return handleSubmit(subArgv);
-        case "list":
-            return handleList(subArgv);
-        case "decide":
-            return handleDecide(subArgv);
-        case "route":
-            return handleRoute(subArgv);
-        case "promote-principle":
-            return handlePromotePrinciple(subArgv);
-        case "--help":
-        case "-h":
-        case undefined:
-            printHelp();
-            return 0;
-        default:
-            console.error(`[onto] Unknown govern adapter subcommand: ${subcommand}`);
-            console.error("Use the govern runtime adapter help for usage.");
-            return 1;
-    }
-}
-function printHelp() {
-    console.log([
-        "Usage: govern-adapter <subcommand> [options]",
-        "",
-        "Subcommands:",
-        "  submit   Queue a norm-change proposal or drift-detection item",
-        "  list     Show queue entries (pending / decided / all)",
-        "  decide   Record Principal verdict on a queued item",
-        "  route    Classify a change proposal by drift policy (W-C-02, §1.3)",
-        "  promote-principle  Propose a promoted learning for principle promotion (W-C-03)",
-        "",
-        "Options (submit):",
-        "  --origin <human|system>     who is submitting (required)",
-        "  --target <path>             file/resource being proposed to change (required)",
-        "  --json <payload-json>       proposal payload JSON (required)",
-        "  --prompted-by-drift <id>    optional: this human proposal was prompted by a drift item",
-        "  --submitted-by <actor>      optional actor label (default: 'principal' for human, 'drift-engine' for system)",
-        "  --project-root <path>       project root (default: cwd)",
-        "",
-        "Options (list):",
-        "  --status <pending|decided|all>   filter (default: pending)",
-        "  --format <table|json>            output format (default: table)",
-        "  --project-root <path>            project root (default: cwd)",
-        "",
-        "Options (decide):",
-        "  <id>                        queue entry id (positional, required)",
-        "  --verdict <approve|reject>  required",
-        "  --reason <text>             required",
-        "  --decided-by <actor>        optional (default: principal)",
-        "  --project-root <path>       project root (default: cwd)",
-        "",
-        "Options (route):",
-        "  --json <proposal-json>                          required. ChangeProposal JSON (summary, target_files, change_kind, rationale?)",
-        "  --project-root <path>                           project root (default: cwd)",
-        "  (outcome routes)",
-        "    self_apply        drift-free local change. no queue append. caller logs only.",
-        "    queue             drift-risk change. appends origin=system, tag=drift to queue.",
-        "    principal_direct  governance-core change. appends with payload marker route=principal_direct.",
-        "",
-        "v0 scope (bounded minimum surface):",
-        "  - submit appends to .onto/govern/queue.ndjson (event-sourced, append-only).",
-        "  - decide records verdict only. Actual authority-file edit after approve is",
-        "    manual (or delegated to W-C-02 drift-engine). No merge/CI gate in v0.",
-        "  - origin→tag is deterministic: human→norm_change, system→drift.",
-        "  - Cross-project norms (e.g., global meta-rules) are out of scope; see W-C-03.",
-    ].join("\n"));
-}
-function readOption(argv, name) {
-    const idx = argv.indexOf(`--${name}`);
-    if (idx >= 0 && idx + 1 < argv.length)
-        return argv[idx + 1];
-    return undefined;
-}
-function resolveProjectRoot(argv) {
-    return readOption(argv, "project-root") ?? process.cwd();
-}
-// ─── submit ───
-function handleSubmit(argv) {
-    const originRaw = readOption(argv, "origin");
-    const target = readOption(argv, "target");
-    const jsonRaw = readOption(argv, "json");
-    const promptedBy = readOption(argv, "prompted-by-drift");
-    const submittedByOverride = readOption(argv, "submitted-by");
-    if (!originRaw || (originRaw !== "human" && originRaw !== "system")) {
-        console.error("[onto] govern submit: --origin must be 'human' or 'system'.");
-        return 1;
-    }
-    if (!target) {
-        console.error("[onto] govern submit: --target is required.");
-        return 1;
-    }
-    if (!jsonRaw) {
-        console.error("[onto] govern submit: --json payload is required.");
-        return 1;
-    }
-    let payload;
-    try {
-        const parsed = JSON.parse(jsonRaw);
-        if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-            console.error("[onto] govern submit: --json must be a JSON object.");
-            return 1;
-        }
-        payload = parsed;
-    }
-    catch (e) {
-        console.error(`[onto] govern submit: --json parse error: ${e instanceof Error ? e.message : String(e)}`);
-        return 1;
-    }
-    const origin = originRaw;
-    const tag = originToTag(origin);
-    const projectRoot = resolveProjectRoot(argv);
-    const queuePath = resolveQueuePath(projectRoot);
-    const id = generateGovernId();
-    const submittedBy = submittedByOverride ?? (origin === "human" ? "principal" : "drift-engine");
-    const event = {
-        type: "submit",
-        id,
-        origin,
-        tag,
-        target,
-        payload,
-        submitted_at: new Date().toISOString(),
-        submitted_by: submittedBy,
-    };
-    if (promptedBy !== undefined)
-        event.prompted_by_drift_id = promptedBy;
-    appendQueueEvent(queuePath, event);
-    console.log(JSON.stringify({
-        status: "queued",
-        id,
-        origin,
-        tag,
-        target,
-        next_action: "govern MCP design pending; inspect the queue artifact before deciding",
-    }, null, 2));
-    return 0;
-}
-// ─── list ───
-function handleList(argv) {
-    const statusFilterRaw = readOption(argv, "status") ?? "pending";
-    if (statusFilterRaw !== "pending" &&
-        statusFilterRaw !== "decided" &&
-        statusFilterRaw !== "all") {
-        console.error("[onto] govern list: --status must be 'pending', 'decided', or 'all'.");
-        return 1;
-    }
-    const format = readOption(argv, "format") ?? "table";
-    if (format !== "table" && format !== "json") {
-        console.error("[onto] govern list: --format must be 'table' or 'json'.");
-        return 1;
-    }
-    const projectRoot = resolveProjectRoot(argv);
-    const queuePath = resolveQueuePath(projectRoot);
-    const events = readQueueEvents(queuePath);
-    const entries = projectQueue(events);
-    const filtered = statusFilterRaw === "all"
-        ? entries
-        : entries.filter((e) => e.status === statusFilterRaw);
-    if (format === "json") {
-        console.log(JSON.stringify(filtered, null, 2));
-        return 0;
-    }
-    renderTable(filtered, statusFilterRaw);
-    return 0;
-}
-function renderTable(entries, statusFilter) {
-    if (entries.length === 0) {
-        console.log(`(no ${statusFilter} govern entries)`);
-        return;
-    }
-    const rows = entries.map((e) => ({
-        id: e.id,
-        status: e.status,
-        tag: e.tag,
-        origin: e.origin,
-        target: e.target,
-        submitted_at: e.submitted_at,
-        verdict: e.verdict?.verdict ?? "",
-    }));
-    const cols = [
-        "id",
-        "status",
-        "tag",
-        "origin",
-        "target",
-        "submitted_at",
-        "verdict",
-    ];
-    const widths = {};
-    for (const c of cols) {
-        widths[c] = Math.max(c.length, ...rows.map((r) => String(r[c] ?? "").length));
-    }
-    const header = cols.map((c) => c.padEnd(widths[c])).join("  ");
-    console.log(header);
-    console.log(cols.map((c) => "-".repeat(widths[c])).join("  "));
-    for (const r of rows) {
-        console.log(cols.map((c) => String(r[c] ?? "").padEnd(widths[c])).join("  "));
-    }
-}
-// ─── promote-principle (W-C-03) ───
-function handlePromotePrinciple(argv) {
-    const jsonRaw = readOption(argv, "json");
-    if (!jsonRaw) {
-        console.error("[onto] govern promote-principle: --json proposal is required.");
-        console.error("Example JSON shape: {\"learning_ref\":{\"agent_id\":\"logic\",\"entry_marker\":\"...\"},\"target\":{\"category\":\"principle\",\"file_path\":\".onto/principles/X.md\",\"section\":\"NEW\"},\"rationale\":\"...\",\"conflict_check\":{\"reviewed_by_agent\":true,\"existing_principle_refs\":[],\"conflict_summary\":\"no conflict\"},\"workload_evidence\":{\"state_transitions\":10,\"evidence_summary\":\"...\",\"event_refs\":[]},\"source_impact\":\"high\"}");
-        return 1;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(jsonRaw);
-    }
-    catch (e) {
-        console.error(`[onto] govern promote-principle: --json parse error: ${e instanceof Error ? e.message : String(e)}`);
-        return 1;
-    }
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-        console.error("[onto] govern promote-principle: --json must be a JSON object.");
-        return 1;
-    }
-    const projectRoot = resolveProjectRoot(argv);
-    const result = executePromotePrinciple(parsed, projectRoot);
-    if (!result.success) {
-        console.error(`[onto] govern promote-principle: ${result.reason}`);
-        return 1;
-    }
-    console.log(JSON.stringify({
-        status: "queued",
-        id: result.id,
-        gate_passed: result.gate_passed,
-        similar_to: result.similar_to,
-        next_action: "govern MCP design pending; inspect the queue artifact before deciding",
-    }, null, 2));
-    return 0;
-}
-// ─── route (W-C-02 drift engine) ───
-function handleRoute(argv) {
-    const jsonRaw = readOption(argv, "json");
-    if (!jsonRaw) {
-        console.error("[onto] govern route: --json proposal is required.");
-        return 1;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(jsonRaw);
-    }
-    catch (e) {
-        console.error(`[onto] govern route: --json parse error: ${e instanceof Error ? e.message : String(e)}`);
-        return 1;
-    }
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-        console.error("[onto] govern route: --json must be a JSON object.");
-        return 1;
-    }
-    const obj = parsed;
-    const summary = obj.summary;
-    const targetFiles = obj.target_files;
-    const changeKind = obj.change_kind;
-    const rationale = obj.rationale;
-    if (typeof summary !== "string" || summary.trim().length === 0) {
-        console.error("[onto] govern route: proposal.summary (string) is required.");
-        return 1;
-    }
-    if (!Array.isArray(targetFiles) ||
-        targetFiles.length === 0 ||
-        !targetFiles.every((f) => typeof f === "string" && f.length > 0)) {
-        console.error("[onto] govern route: proposal.target_files must be a non-empty string array.");
-        return 1;
-    }
-    const validKinds = ["docs_only", "code", "config", "mixed"];
-    if (typeof changeKind !== "string" ||
-        !validKinds.includes(changeKind)) {
-        console.error(`[onto] govern route: proposal.change_kind must be one of ${validKinds.join(", ")}.`);
-        return 1;
-    }
-    const proposal = {
-        summary,
-        target_files: targetFiles,
-        change_kind: changeKind,
-    };
-    if (typeof rationale === "string")
-        proposal.rationale = rationale;
-    const projectRoot = resolveProjectRoot(argv);
-    const outcome = routeProposal(proposal, projectRoot);
-    console.log(JSON.stringify({
-        status: "routed",
-        route: outcome.decision.route,
-        matched_rule: outcome.decision.matched_rule,
-        reason: outcome.decision.reason,
-        ...(outcome.queue_event_id
-            ? { queue_event_id: outcome.queue_event_id }
-            : {}),
-    }, null, 2));
-    return 0;
-}
-// ─── decide ───
-function handleDecide(argv) {
-    const id = argv.find((a) => !a.startsWith("--"));
-    if (!id) {
-        console.error("[onto] govern decide: <id> positional argument is required.");
-        return 1;
-    }
-    const verdictRaw = readOption(argv, "verdict");
-    const reason = readOption(argv, "reason");
-    const decidedByOverride = readOption(argv, "decided-by");
-    if (!verdictRaw || (verdictRaw !== "approve" && verdictRaw !== "reject")) {
-        console.error("[onto] govern decide: --verdict must be 'approve' or 'reject'.");
-        return 1;
-    }
-    if (!reason || reason.trim().length === 0) {
-        console.error("[onto] govern decide: --reason is required.");
-        return 1;
-    }
-    const projectRoot = resolveProjectRoot(argv);
-    const queuePath = resolveQueuePath(projectRoot);
-    const events = readQueueEvents(queuePath);
-    const entries = projectQueue(events);
-    const existing = entries.find((e) => e.id === id);
-    if (!existing) {
-        console.error(`[onto] govern decide: id '${id}' not found in queue.`);
-        return 1;
-    }
-    if (existing.status === "decided") {
-        console.error(`[onto] govern decide: id '${id}' already decided (verdict=${existing.verdict?.verdict}). v0 는 재판정 지원하지 않음.`);
-        return 1;
-    }
-    const verdict = verdictRaw;
-    const event = {
-        type: "decide",
-        id,
-        verdict,
-        reason,
-        decided_at: new Date().toISOString(),
-        decided_by: decidedByOverride ?? "principal",
-    };
-    appendQueueEvent(queuePath, event);
-    const applyNote = verdict === "approve"
-        ? `(v0 는 기록만) 승인됨. ${existing.target} 파일의 실제 수정은 주체자 수동 편집 또는 W-C-02 drift-engine 책임.`
-        : `(v0 는 기록만) 거부됨. 제안 내용은 폐기. ${existing.target} 파일은 변경 없음.`;
-    console.log(JSON.stringify({
-        status: "decided",
-        id,
-        verdict,
-        target: existing.target,
-        tag: existing.tag,
-        note: applyNote,
-    }, null, 2));
-    return 0;
-}