onto-mcp 0.3.2 → 0.4.0

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

@@ -1,256 +0,0 @@
-/**
- * Evolve runtime adapter.
- *
- * Routes evolve subcommands to the appropriate command handler.
- */
-import { join } from "node:path";
-import { existsSync, mkdirSync } from "node:fs";
-import { resolveScopePaths } from "../scope-runtime/scope-manager.js";
-export async function handleEvolveCli(ontoHome, argv) {
-    const subcommand = argv[0];
-    const subArgv = argv.slice(1);
-    switch (subcommand) {
-        case "start":
-            return handleEvolveStart(ontoHome, subArgv);
-        case "propose-align":
-            return handleEvolveProposeAlign(subArgv);
-        case "align":
-            return handleEvolveAlign(subArgv);
-        case "draft":
-            return handleEvolveDraft(subArgv);
-        case "apply":
-            return handleEvolveApply(subArgv);
-        case "close":
-            return handleEvolveClose(subArgv);
-        case "defer":
-            return handleEvolveDefer(subArgv);
-        case "--help":
-        case "-h":
-        case undefined:
-            console.log([
-                "Usage: evolve <subcommand> [options]",
-                "",
-                "Subcommands:",
-                "  start <description>              Start or resume an evolve scope",
-                "  propose-align --scope-id <id>    Submit consolidated dialog output → align_proposed",
-                "  align --scope-id <id>            Lock or revise alignment direction",
-                "  draft --scope-id <id>            Generate draft packet / confirm surface / decide constraints",
-                "  apply --scope-id <id>            Apply evolve output to implementation",
-                "  close --scope-id <id>            Close a validated scope",
-                "  defer --scope-id <id>            Defer a non-terminal scope",
-                "",
-                "Options:",
-                "  --project-root <path>       Project root (default: cwd)",
-                "  --scopes-dir <path>         Scopes directory (default: <project-root>/scopes)",
-                "  --project-name <name>       Project name for scope ID generation",
-                "  --scope-id <id>             Target scope ID (required for align/draft/apply/close)",
-                "  --entry-mode <mode>         'experience', 'interface', or 'process' (default: experience)",
-                "  --json <content>            propose-align: dialog output JSON; align: verdict JSON",
-                "  --reason <text>             Defer reason (required for defer)",
-                "  --resume-condition <text>   Condition under which scope resumes (required for defer)",
-                "",
-                "propose-align UX contract:",
-                "  Agent (Claude Code session / LLM) conducts dialog with Principal using",
-                "  selection-based choices + natural-language fallback, consolidates answers",
-                "  across rounds, and on convergence calls propose-align with the resulting",
-                "  {interpreted_direction, proposed_scope, scenarios, as_is, constraints,",
-                "   decision_questions}. Runtime owns state machine, event log, packet rendering.",
-            ].join("\n"));
-            return 0;
-        default:
-            console.error(`[onto] Unknown evolve subcommand: ${subcommand}`);
-            console.error("Run evolve help for usage.");
-            return 1;
-    }
-}
-// ─── Shared helpers ───
-function readOption(argv, name) {
-    const idx = argv.indexOf(`--${name}`);
-    if (idx >= 0 && idx + 1 < argv.length) {
-        return argv[idx + 1];
-    }
-    return undefined;
-}
-function resolveScopePathsFromArgv(argv) {
-    const scopeId = readOption(argv, "scope-id");
-    if (!scopeId) {
-        console.error("[onto] --scope-id is required.");
-        return null;
-    }
-    const projectRoot = readOption(argv, "project-root") ?? process.cwd();
-    const scopesDir = readOption(argv, "scopes-dir") ?? join(projectRoot, "scopes");
-    return resolveScopePaths(scopesDir, scopeId);
-}
-// ─── start ───
-async function handleEvolveStart(_ontoHome, argv) {
-    const { executeStart } = await import("./commands/start.js");
-    const projectRoot = readOption(argv, "project-root") ?? process.cwd();
-    const scopesDir = readOption(argv, "scopes-dir") ?? join(projectRoot, "scopes");
-    const projectName = readOption(argv, "project-name");
-    const scopeId = readOption(argv, "scope-id");
-    const entryMode = (readOption(argv, "entry-mode") ?? "experience");
-    // Collect non-flag arguments as description
-    const rawInput = argv
-        .filter((arg) => !arg.startsWith("--"))
-        .join(" ")
-        .trim();
-    if (!rawInput && !scopeId) {
-        console.error("[onto] evolve start requires a description or --scope-id to resume.");
-        return 1;
-    }
-    // Ensure scopes directory exists
-    if (!existsSync(scopesDir)) {
-        mkdirSync(scopesDir, { recursive: true });
-    }
-    try {
-        const result = await executeStart({
-            rawInput: rawInput || "",
-            projectRoot,
-            scopesDir,
-            ...(projectName !== undefined ? { projectName } : {}),
-            ...(scopeId !== undefined ? { scopeId } : {}),
-            entryMode,
-            onProgress: (msg) => console.log(`  ${msg}`),
-        });
-        if (!result.success) {
-            console.error(`[onto] evolve start failed: ${result.reason} (step: ${result.step})`);
-            return 1;
-        }
-        if (result.action === "initialized") {
-            console.log(JSON.stringify({
-                status: "initialized",
-                scope_id: result.scopeId,
-                brief_path: result.briefPath,
-                message: "Scope initialized. Fill in the brief, then resume evolve start.",
-            }, null, 2));
-            return 0;
-        }
-        if (result.action === "resume_info") {
-            console.log(JSON.stringify({
-                status: "resume",
-                scope_id: result.scopeId,
-                current_state: result.currentState,
-                next_action: result.nextAction,
-            }, null, 2));
-            return 0;
-        }
-        if (result.action === "process_scope_created") {
-            console.log(JSON.stringify({
-                status: "process_scope_created",
-                scope_id: result.scopeId,
-                authority_sources: result.authoritySources.length,
-                authority_consistency: result.authorityConsistency,
-            }, null, 2));
-            return 0;
-        }
-        // Full execution result (code-product path)
-        console.log(JSON.stringify({
-            status: "executed",
-            paths: result.paths,
-            scan_results: result.scanResults.length,
-            scan_errors: result.scanErrors.length,
-            total_files: result.totalFiles,
-        }, null, 2));
-        return 0;
-    }
-    catch (error) {
-        console.error(`[onto] evolve start error: ${error instanceof Error ? error.message : String(error)}`);
-        return 1;
-    }
-}
-// ─── align ───
-// ─── propose-align ───
-async function handleEvolveProposeAlign(argv) {
-    const paths = resolveScopePathsFromArgv(argv);
-    if (!paths)
-        return 1;
-    const jsonInput = readOption(argv, "json");
-    if (!jsonInput) {
-        console.error("[onto] evolve propose-align requires --json '<dialog-output>'.");
-        console.error('Shape: --json \'{"interpreted_direction":"...","proposed_scope":{"in":[...],"out":[...]},"as_is":{...},"constraints":[...],"decision_questions":[...]}\'');
-        console.error("See evolve help for the UX contract (agent owns dialog, runtime owns state/events/packet).");
-        return 1;
-    }
-    const { executeProposeAlign } = await import("./commands/propose-align.js");
-    const result = executeProposeAlign(paths, jsonInput);
-    console.log(JSON.stringify(result, null, 2));
-    return result.success ? 0 : 1;
-}
-// ─── align ───
-async function handleEvolveAlign(argv) {
-    const paths = resolveScopePathsFromArgv(argv);
-    if (!paths)
-        return 1;
-    const jsonInput = readOption(argv, "json");
-    if (!jsonInput) {
-        console.error("[onto] evolve align requires --json '<verdict-object>'.");
-        console.error("Example: --json '{\"type\":\"approve\",\"direction\":\"...\",\"scope_in\":[],\"scope_out\":[]}'");
-        return 1;
-    }
-    const { executeAlign } = await import("./commands/align.js");
-    const verdict = JSON.parse(jsonInput);
-    const result = executeAlign({ paths, verdict });
-    console.log(JSON.stringify(result, null, 2));
-    return result.success ? 0 : 1;
-}
-// ─── draft ───
-async function handleEvolveDraft(argv) {
-    const paths = resolveScopePathsFromArgv(argv);
-    if (!paths)
-        return 1;
-    const jsonInput = readOption(argv, "json");
-    if (!jsonInput) {
-        console.error("[onto] evolve draft requires --json '<action-object>'.");
-        console.error("Example: --json '{\"type\":\"generate_surface\"}'");
-        return 1;
-    }
-    const { executeDraft } = await import("./commands/draft.js");
-    const action = JSON.parse(jsonInput);
-    const result = executeDraft({ paths, action });
-    console.log(JSON.stringify(result, null, 2));
-    return result.success ? 0 : 1;
-}
-// ─── apply ───
-async function handleEvolveApply(argv) {
-    const paths = resolveScopePathsFromArgv(argv);
-    if (!paths)
-        return 1;
-    const jsonInput = readOption(argv, "json");
-    if (!jsonInput) {
-        console.error("[onto] evolve apply requires --json '<action-object>'.");
-        console.error("Example: --json '{\"type\":\"start_apply\",\"buildSpecHash\":\"...\"}'");
-        return 1;
-    }
-    const projectRoot = readOption(argv, "project-root") ?? process.cwd();
-    const { executeApply } = await import("./commands/apply.js");
-    const action = JSON.parse(jsonInput);
-    const result = executeApply(paths, action, { projectRoot });
-    console.log(JSON.stringify(result, null, 2));
-    return result.success ? 0 : 1;
-}
-// ─── close ───
-async function handleEvolveClose(argv) {
-    const paths = resolveScopePathsFromArgv(argv);
-    if (!paths)
-        return 1;
-    const { executeClose } = await import("./commands/close.js");
-    const result = executeClose(paths);
-    console.log(JSON.stringify(result, null, 2));
-    return result.success ? 0 : 1;
-}
-// ─── defer ───
-async function handleEvolveDefer(argv) {
-    const paths = resolveScopePathsFromArgv(argv);
-    if (!paths)
-        return 1;
-    const reason = readOption(argv, "reason");
-    const resumeCondition = readOption(argv, "resume-condition");
-    if (!reason || !resumeCondition) {
-        console.error("[onto] evolve defer requires --reason and --resume-condition.");
-        return 1;
-    }
-    const { executeDefer } = await import("./commands/defer.js");
-    const result = executeDefer(paths, reason, resumeCondition);
-    console.log(JSON.stringify(result, null, 2));
-    return result.success ? 0 : 1;
-}

package/dist/core-runtime/evolve/commands/align.js

@@ -1,194 +0,0 @@
-/**
- * /align command orchestration.
- *
- * Processes user verdict on the Align Packet:
- * - approve: lock direction + scope boundaries → align_locked
- * - revise: re-render Align Packet with feedback → stay align_proposed
- * - reject: terminate scope → rejected
- * - redirect: return to grounding → grounded
- *
- * Stale detection and convergence safety are handled here.
- */
-import { writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { readEvents } from "../../scope-runtime/event-store.js";
-import { reduce } from "../../scope-runtime/reducer.js";
-import { appendScopeEvent } from "../../scope-runtime/event-pipeline.js";
-import { renderAlignPacket } from "../renderers/align-packet.js";
-import { checkStale } from "./stale-check.js";
-import { wrapGateError } from "./error-messages.js";
-import { refreshScopeMd } from "./shared.js";
-import { CONVERGENCE_THRESHOLDS } from "../../scope-runtime/constants.js";
-import { contentHash } from "../../scope-runtime/hash.js";
-// ─── Main ───
-export function executeAlign(input) {
-    const { paths, verdict } = input;
-    // Step 1: Check current state
-    const events = readEvents(paths.events);
-    const state = reduce(events);
-    if (state.current_state !== "align_proposed") {
-        return {
-            success: false,
-            reason: `현재 상태가 ${state.current_state}입니다. /align은 align_proposed 상태에서만 실행할 수 있습니다.`,
-        };
-    }
-    // Step 2: Stale check (local sources only)
-    const staleResult = checkStale(paths);
-    if (staleResult.stale) {
-        const changedPaths = staleResult.stale_sources.map(s => s.path).join(", ");
-        return {
-            success: false,
-            reason: `소스가 변경되었습니다 (${changedPaths}). /start를 다시 실행하여 재스캔하세요.`,
-        };
-    }
-    // Step 3: Check convergence blocked
-    if (state.convergence_blocked) {
-        return {
-            success: false,
-            reason: "수렴 차단 상태입니다. 다음 중 하나를 선택하세요: (1) 방향 변경 (/align redirect) (2) scope 축소 (/align revise) (3) scope 보류 (scope.deferred)",
-        };
-    }
-    // Step 4: Process verdict
-    switch (verdict.type) {
-        case "approve":
-            return handleApprove(paths, state, verdict);
-        case "revise":
-            return handleRevise(paths, state, verdict);
-        case "reject":
-            return handleReject(paths, verdict);
-        case "redirect":
-            return handleRedirect(paths, verdict);
-    }
-}
-// ─── Verdict Handlers ───
-function handleApprove(paths, state, verdict) {
-    const result = appendScopeEvent(paths, {
-        type: "align.locked",
-        actor: "user",
-        payload: {
-            locked_direction: verdict.direction,
-            locked_scope_boundaries: {
-                in: verdict.scope_in,
-                out: verdict.scope_out,
-            },
-            locked_in_out: true,
-        },
-    });
-    if (!result.success) {
-        return { success: false, reason: wrapGateError(result.reason) };
-    }
-    refreshScopeMd(paths, result.state);
-    return {
-        success: true,
-        nextState: "align_locked",
-        message: "방향과 범위가 확정되었습니다. /draft로 Surface를 생성하세요.",
-    };
-}
-function handleRevise(paths, state, verdict) {
-    const result = appendScopeEvent(paths, {
-        type: "align.revised",
-        actor: "user",
-        payload: {
-            revision_count: state.revision_count_align + 1,
-            feedback_scope: verdict.feedbackScope,
-            feedback_text: verdict.feedback,
-            packet_path: "build/align-packet.md",
-            packet_hash: verdict.updatedPacketHash,
-        },
-    });
-    if (!result.success) {
-        return { success: false, reason: wrapGateError(result.reason) };
-    }
-    // Record convergence observational events based on revision count
-    const revCount = state.revision_count_align + 1;
-    if (revCount >= CONVERGENCE_THRESHOLDS.blocked) {
-        appendScopeEvent(paths, {
-            type: "convergence.blocked",
-            actor: "system",
-            payload: { state: "align_proposed", revision_count: revCount, requires_action: true },
-        });
-    }
-    else if (revCount >= CONVERGENCE_THRESHOLDS.caution) {
-        appendScopeEvent(paths, {
-            type: "convergence.diagnosis",
-            actor: "system",
-            payload: { state: "align_proposed", revision_count: revCount, diagnosis: "반복 수정이 지속되고 있습니다", options: ["방향 변경", "scope 축소", "전문가 상담"] },
-        });
-    }
-    else if (revCount >= CONVERGENCE_THRESHOLDS.notice) {
-        appendScopeEvent(paths, {
-            type: "convergence.warning",
-            actor: "system",
-            payload: { state: "align_proposed", revision_count: revCount, pattern_summary: `${revCount}회 반복 수정 중` },
-        });
-    }
-    refreshScopeMd(paths);
-    let message = "피드백이 반영되었습니다. 수정된 Align Packet을 확인하세요.";
-    if (revCount >= CONVERGENCE_THRESHOLDS.blocked) {
-        message = "7회 이상 수정되었습니다. 수렴 차단 상태입니다. 다음 중 선택하세요: (1) 방향 변경 (2) scope 축소 (3) scope 보류";
-    }
-    else if (revCount >= CONVERGENCE_THRESHOLDS.caution) {
-        message = `${revCount}회 수정되었습니다. 방향 자체를 재검토하는 것이 좋을 수 있습니다.`;
-    }
-    else if (revCount >= 3) {
-        message = `${revCount}회 수정되었습니다. 피드백 패턴을 확인해 주세요.`;
-    }
-    return {
-        success: true,
-        nextState: "align_proposed",
-        message,
-    };
-}
-function handleReject(paths, verdict) {
-    const result = appendScopeEvent(paths, {
-        type: "scope.rejected",
-        actor: "user",
-        payload: {
-            reason: verdict.reason,
-            rejection_basis: verdict.basis,
-        },
-    });
-    if (!result.success) {
-        return { success: false, reason: wrapGateError(result.reason) };
-    }
-    refreshScopeMd(paths, result.state);
-    return {
-        success: true,
-        nextState: "rejected",
-        message: "scope가 거절되었습니다.",
-    };
-}
-function handleRedirect(paths, verdict) {
-    const result = appendScopeEvent(paths, {
-        type: "redirect.to_grounding",
-        actor: "user",
-        payload: {
-            from_state: "align_proposed",
-            reason: verdict.reason,
-        },
-    });
-    if (!result.success) {
-        return { success: false, reason: wrapGateError(result.reason) };
-    }
-    refreshScopeMd(paths, result.state);
-    return {
-        success: true,
-        nextState: "grounded",
-        message: "grounding으로 복귀합니다. 추가 소스를 확보한 뒤 /start를 재실행하세요.",
-    };
-}
-// ─── Packet Rendering (UF-STRUCTURE-PACKET-SEAT) ───
-/**
- * Render an Align Packet and write it to `build/align-packet.md`.
- *
- * Called by the agent when it has assembled AlignPacketContent.
- * Returns the content hash of the written packet (used by align.revised events).
- */
-export function writeAlignPacket(paths, content) {
-    const state = reduce(readEvents(paths.events));
-    const md = renderAlignPacket(state, content);
-    const packetPath = join(paths.build, "align-packet.md");
-    writeFileSync(packetPath, md, "utf-8");
-    return { packetPath, packetHash: contentHash(md) };
-}
-// refreshScopeMd is imported from ./shared.ts (UF-CONCISENESS-SCOPE-MD consolidated)

package/dist/core-runtime/evolve/commands/align.test.js

@@ -1,82 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { executeAlign } from "./align.js";
-import { createScope } from "../../scope-runtime/scope-manager.js";
-import { appendScopeEvent } from "../../scope-runtime/event-pipeline.js";
-import { readEvents } from "../../scope-runtime/event-store.js";
-import { reduce } from "../../scope-runtime/reducer.js";
-let tmpDir;
-beforeEach(() => { tmpDir = mkdtempSync(join(tmpdir(), "sprint-align-")); });
-afterEach(() => { rmSync(tmpDir, { recursive: true, force: true }); });
-/** Set up a scope in align_proposed state */
-function setupAlignProposed() {
-    const paths = createScope(tmpDir, "SC-ALIGN-001");
-    appendScopeEvent(paths, { type: "scope.created", actor: "user", payload: { title: "Test", description: "d", entry_mode: "experience" } });
-    appendScopeEvent(paths, { type: "grounding.started", actor: "system", payload: { sources: [{ type: "add-dir", path_or_url: "/test" }] } });
-    appendScopeEvent(paths, { type: "grounding.completed", actor: "system", payload: { snapshot_revision: 1, source_hashes: { "add-dir:/test": "h1" }, perspective_summary: { experience: 1, code: 1, policy: 1 } } });
-    appendScopeEvent(paths, { type: "align.proposed", actor: "system", payload: { packet_path: "build/align-packet.md", packet_hash: "hash1", snapshot_revision: 1 } });
-    return paths;
-}
-describe("executeAlign", () => {
-    it("approve → align_locked", () => {
-        const paths = setupAlignProposed();
-        const result = executeAlign({
-            paths,
-            verdict: { type: "approve", direction: "튜터 차단 기능", scope_in: ["차단 생성"], scope_out: ["관리자 차단"] },
-        });
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        expect(result.nextState).toBe("align_locked");
-        const state = reduce(readEvents(paths.events));
-        expect(state.current_state).toBe("align_locked");
-        expect(state.direction).toBe("튜터 차단 기능");
-    });
-    it("revise → stay align_proposed", () => {
-        const paths = setupAlignProposed();
-        const result = executeAlign({
-            paths,
-            verdict: { type: "revise", feedback: "범위를 좁혀주세요", feedbackScope: "scope", updatedPacketHash: "hash2" },
-        });
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        expect(result.nextState).toBe("align_proposed");
-    });
-    it("reject → rejected", () => {
-        const paths = setupAlignProposed();
-        const result = executeAlign({
-            paths,
-            verdict: { type: "reject", reason: "방향이 잘못됨", basis: "시장 조사 결과" },
-        });
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        expect(result.nextState).toBe("rejected");
-    });
-    it("redirect → grounded", () => {
-        const paths = setupAlignProposed();
-        const result = executeAlign({
-            paths,
-            verdict: { type: "redirect", reason: "정보 부족" },
-        });
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        expect(result.nextState).toBe("grounded");
-    });
-    it("fails when not in align_proposed state", () => {
-        const paths = createScope(tmpDir, "SC-ALIGN-002");
-        appendScopeEvent(paths, { type: "scope.created", actor: "user", payload: { title: "T", description: "d", entry_mode: "experience" } });
-        const result = executeAlign({
-            paths,
-            verdict: { type: "approve", direction: "d", scope_in: [], scope_out: [] },
-        });
-        expect(result.success).toBe(false);
-        if (result.success)
-            return;
-        expect(result.reason).toContain("align_proposed");
-    });
-});