onto-mcp 0.4.3 → 0.4.5

package/README.md

@@ -132,25 +132,25 @@ Available MCP tools:
 
 | Tool | Purpose |
 |---|---|
-| `onto.review` | Run the full review path and return artifact refs plus summary |
-| `onto.prepare_review` | Prepare a review session and prompt packets |
-| `onto.review_continue` | Continue a prepared or halted review from the ledger frontier |
-| `onto.review_status` | Read structured status and artifact refs |
-| `onto.review_result` | Read `review-record.yaml` and final output |
-| `onto.list_lenses` | List canonical lens sets |
-| `onto.list_domains` | List available domain ids |
-| `onto.list_source_profiles` | List reconstruct source profiles |
-| `onto.observe_source` | Materialize reconstruct material profile, inventory, source observations, and initial record |
-| `onto.validate_reconstruct_directive` | Validate LLM-authored reconstruct artifacts |
-| `onto.reconstruct` | Run the material-aware direct-call reconstruct path with runtime validation gates |
-| `onto.reconstruct_status` | Read reconstruct session status, progress, counts, and artifact refs |
-| `onto.reconstruct_result` | Read `reconstruct-record.yaml`, run manifest, progress projection, and final output |
+| `onto_review` | Run the full review path and return artifact refs plus summary |
+| `onto_prepare_review` | Prepare a review session and prompt packets |
+| `onto_review_continue` | Continue a prepared or halted review from the ledger frontier |
+| `onto_review_status` | Read structured status and artifact refs |
+| `onto_review_result` | Read `review-record.yaml` and final output |
+| `onto_list_lenses` | List canonical lens sets |
+| `onto_list_domains` | List available domain ids |
+| `onto_list_source_profiles` | List reconstruct source profiles |
+| `onto_observe_source` | Materialize reconstruct material profile, inventory, source observations, and initial record |
+| `onto_validate_reconstruct_directive` | Validate LLM-authored reconstruct artifacts |
+| `onto_reconstruct` | Run the material-aware direct-call reconstruct path with runtime validation gates |
+| `onto_reconstruct_status` | Read reconstruct session status, progress, counts, and artifact refs |
+| `onto_reconstruct_result` | Read `reconstruct-record.yaml`, run manifest, progress projection, and final output |
 
 MCP results include `llmPresentation` prompts. The runtime supplies bounded
 facts; the host LLM should use those prompts to explain the opening brief and
 final result to the user without inventing settings or findings.
 
-When `onto.review`, `onto.review_continue`, or `onto.reconstruct` starts, the
+When `onto_review`, `onto_review_continue`, or `onto_reconstruct` starts, the
 runtime writes a session-local `runtime-events.ndjson` stream and tries to open
 `scripts/onto-runtime-watch.sh` in a supported terminal split/tab. Current
 automatic attach targets are `tmux`, Codex Desktop with a configured launcher
@@ -168,7 +168,7 @@ Minimal reconstruct MCP call shape:
 
 ```json
 {
-  "name": "onto.reconstruct",
+  "name": "onto_reconstruct",
   "arguments": {
     "projectRoot": "/path/to/project",
     "targetRefs": ["src/example.ts"],

package/dist/cli.js

@@ -41,18 +41,18 @@ function printHelp() {
         "  register       Register the onto MCP server into supported hosts",
         "",
         "Available MCP tools:",
-        "  onto.review",
-        "  onto.prepare_review",
-        "  onto.review_status",
-        "  onto.review_result",
-        "  onto.list_lenses",
-        "  onto.list_domains",
-        "  onto.list_source_profiles",
-        "  onto.observe_source",
-        "  onto.validate_reconstruct_directive",
-        "  onto.reconstruct",
-        "  onto.reconstruct_status",
-        "  onto.reconstruct_result",
+        "  onto_review",
+        "  onto_prepare_review",
+        "  onto_review_status",
+        "  onto_review_result",
+        "  onto_list_lenses",
+        "  onto_list_domains",
+        "  onto_list_source_profiles",
+        "  onto_observe_source",
+        "  onto_validate_reconstruct_directive",
+        "  onto_reconstruct",
+        "  onto_reconstruct_status",
+        "  onto_reconstruct_result",
         "",
         "Options:",
         "  --version, -v  Show version",

package/dist/core-runtime/cli/assemble-review-record.js

@@ -110,8 +110,46 @@ function parseDomainConstraints(sectionText, lensId) {
         };
     });
 }
-function parseStringList(sectionText, label) {
-    return parseYamlList(sectionText, label).map((item, index) => requireNonEmptyString(item, `${label}[${index}]`));
+/**
+ * Parse a lens section that is a list of free-text strings (e.g. Domain Context
+ * Assumptions).
+ *
+ * The lens-output contract asks for a YAML list, but lens output is LLM-authored
+ * prose and models routinely emit natural markdown bullets such as
+ * `- "PATH resolution" means ...`, which are valid markdown yet invalid YAML (a
+ * quoted scalar followed by more text -> "Unexpected scalar at node end"). That
+ * brittleness failed real ReviewRecord assembly. Accept a valid YAML string list
+ * first (preserves `[]`, `- none`, and clean YAML lists), then fall back to
+ * parsing markdown bullet lines as literal strings. Structured object sections
+ * (e.g. Domain Constraints Used) stay strict via parseYamlList/parseDomainConstraints.
+ *
+ * Exported for unit testing.
+ */
+export function parseStringList(sectionText, label) {
+    const source = extractYamlFence(sectionText);
+    if (source.length === 0)
+        return [];
+    let yamlParsed;
+    let yamlParseOk = true;
+    try {
+        yamlParsed = YAML.parse(source);
+    }
+    catch {
+        yamlParseOk = false;
+    }
+    if (yamlParseOk &&
+        Array.isArray(yamlParsed) &&
+        yamlParsed.every((item) => typeof item === "string" && item.trim().length > 0)) {
+        return yamlParsed.map((item) => item.trim());
+    }
+    // Fallback: treat markdown bullet lines as literal strings.
+    const bullets = source
+        .split(/\r?\n/u)
+        .map((line) => /^\s*[-*]\s+(.*\S)\s*$/u.exec(line)?.[1]?.trim())
+        .filter((item) => Boolean(item && item.length > 0));
+    if (bullets.length > 0)
+        return bullets;
+    throw new Error(`Expected a YAML list of strings or a markdown bullet list in ${label}.`);
 }
 async function deriveLensProvenance(lensResultPathsById, participatingLensIds) {
     const perLensProvenance = {};

package/dist/mcp/server.js

@@ -90,7 +90,7 @@ const REVIEW_INPUT_SCHEMA = {
         },
         returnRunningAfterMs: {
             type: "number",
-            description: "Optional synchronous wait budget in milliseconds. When exceeded after session planning, onto.review returns a running handle and background execution continues.",
+            description: "Optional synchronous wait budget in milliseconds. When exceeded after session planning, onto_review returns a running handle and background execution continues.",
         },
     },
 };
@@ -383,72 +383,72 @@ const VALIDATE_RECONSTRUCT_DIRECTIVE_INPUT_SCHEMA = {
 };
 const TOOL_DEFINITIONS = [
     {
-        name: "onto.review",
+        name: "onto_review",
         description: "Run an onto review: isolated parallel lens review followed by controlled synthesize/deliberation and ReviewRecord assembly.",
         inputSchema: REVIEW_INPUT_SCHEMA,
     },
     {
-        name: "onto.prepare_review",
+        name: "onto_prepare_review",
         description: "Prepare an onto review session and prompt packets without executing lens units.",
         inputSchema: REVIEW_INPUT_SCHEMA,
     },
     {
-        name: "onto.review_continue",
+        name: "onto_review_continue",
         description: "Continue a review session when runControl.continuationAvailable is true by reusing trusted PipelineExecutionLedger units and rerunning only the continuation frontier and downstream units.",
         inputSchema: REVIEW_CONTINUE_INPUT_SCHEMA,
     },
     {
-        name: "onto.review_cancel",
+        name: "onto_review_cancel",
         description: "Request cancellation for a running review session. The runner writes a halted cancellation result at the next runtime cancellation checkpoint.",
         inputSchema: REVIEW_CANCEL_INPUT_SCHEMA,
     },
     {
-        name: "onto.review_status",
+        name: "onto_review_status",
         description: "Read structured status and artifact refs for a review session, or recover the latest matching session.",
         inputSchema: REVIEW_STATUS_INPUT_SCHEMA,
     },
     {
-        name: "onto.review_result",
+        name: "onto_review_result",
         description: "Read the ReviewRecord and rendered final output for a completed review session with compact/standard/full projections.",
         inputSchema: REVIEW_RESULT_INPUT_SCHEMA,
     },
     {
-        name: "onto.list_lenses",
+        name: "onto_list_lenses",
         description: "List canonical full and core-axis review lens ids.",
         inputSchema: { type: "object", additionalProperties: false, properties: {} },
     },
     {
-        name: "onto.list_domains",
+        name: "onto_list_domains",
         description: "List available domain ids from project, user, and installation domain seats.",
         inputSchema: LIST_DOMAINS_INPUT_SCHEMA,
     },
     {
-        name: "onto.list_source_profiles",
+        name: "onto_list_source_profiles",
         description: "List reconstruct source profiles by target_material_kind and support status.",
         inputSchema: LIST_SOURCE_PROFILES_INPUT_SCHEMA,
     },
     {
-        name: "onto.observe_source",
+        name: "onto_observe_source",
         description: "Prepare reconstruct material profiling, inventory, structural source observations, and reconstruct-record refs without generating ontology meaning.",
         inputSchema: OBSERVE_SOURCE_INPUT_SCHEMA,
     },
     {
-        name: "onto.validate_reconstruct_directive",
+        name: "onto_validate_reconstruct_directive",
         description: "Validate LLM-authored reconstruct artifacts against runtime observations, registry enums, and evidence refs without repairing or rewriting them.",
         inputSchema: VALIDATE_RECONSTRUCT_DIRECTIVE_INPUT_SCHEMA,
     },
     {
-        name: "onto.reconstruct",
+        name: "onto_reconstruct",
         description: "Run the material-aware reconstruct path with live semantic authoring, runtime validation gates, final-output.md, and reconstruct-record.yaml refs.",
         inputSchema: RECONSTRUCT_INPUT_SCHEMA,
     },
     {
-        name: "onto.reconstruct_status",
+        name: "onto_reconstruct_status",
         description: "Read structured status, stage progress, liveness, count summary, and artifact refs for a reconstruct session.",
         inputSchema: RECONSTRUCT_SESSION_INPUT_SCHEMA,
     },
     {
-        name: "onto.reconstruct_result",
+        name: "onto_reconstruct_result",
         description: "Read the reconstruct record, run manifest, stage progress, final output, and artifact refs for a reconstruct session.",
         inputSchema: RECONSTRUCT_SESSION_INPUT_SCHEMA,
     },
@@ -836,7 +836,7 @@ async function resolveAllowedReconstructSessionRoot(args) {
 async function callTool(name, args, options = {}) {
     try {
         switch (name) {
-            case "onto.review": {
+            case "onto_review": {
                 const parsed = OntoReviewToolInputSchema.parse(args);
                 if (parsed.prepareOnly) {
                     const prepared = await reviewApi.prepareReview(toReviewRequest(parsed));
@@ -855,12 +855,12 @@ async function callTool(name, args, options = {}) {
                 });
                 return formatToolResult(result);
             }
-            case "onto.prepare_review": {
+            case "onto_prepare_review": {
                 const parsed = OntoPrepareReviewToolInputSchema.parse(args);
                 const result = await reviewApi.prepareReview(toReviewRequest(parsed));
                 return formatToolResult(result);
             }
-            case "onto.review_continue": {
+            case "onto_review_continue": {
                 const parsed = OntoReviewContinueToolInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 const sessionRoot = await resolveAllowedSessionRoot({
@@ -882,7 +882,7 @@ async function callTool(name, args, options = {}) {
                 });
                 return formatToolResult(result);
             }
-            case "onto.review_cancel": {
+            case "onto_review_cancel": {
                 const parsed = OntoReviewCancelToolInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 const sessionRoot = await resolveAllowedSessionRoot({
@@ -895,7 +895,7 @@ async function callTool(name, args, options = {}) {
                     ...(parsed.reason !== undefined ? { reason: parsed.reason } : {}),
                 }));
             }
-            case "onto.review_status": {
+            case "onto_review_status": {
                 const parsed = OntoReviewStatusInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 if (parsed.sessionRoot) {
@@ -935,28 +935,28 @@ async function callTool(name, args, options = {}) {
                     latestSessionMatches,
                 });
             }
-            case "onto.review_result": {
+            case "onto_review_result": {
                 const parsed = OntoReviewResultInputSchema.parse(args);
                 const sessionRoot = await resolveAllowedSessionRoot(parsed);
                 return formatToolResult(await reviewApi.getReviewResult(sessionRoot, {
                     projectionLevel: parsed.projectionLevel ?? "standard",
                 }));
             }
-            case "onto.list_lenses":
+            case "onto_list_lenses":
                 return formatToolResult(await reviewApi.listLenses());
-            case "onto.list_domains": {
+            case "onto_list_domains": {
                 const parsed = OntoListDomainsToolInputSchema.parse(args ?? {});
                 const domains = await reviewApi.listDomains(parsed.projectRoot);
                 // Wrap the array so structuredContent is a JSON object (MCP requirement).
                 return formatToolResult({ domains });
             }
-            case "onto.list_source_profiles": {
+            case "onto_list_source_profiles": {
                 const parsed = OntoListSourceProfilesToolInputSchema.parse(args ?? {});
                 const sourceProfiles = await reconstructApi.listSourceProfiles(parsed.projectRoot);
                 // Wrap the array so structuredContent is a JSON object (MCP requirement).
                 return formatToolResult({ sourceProfiles });
             }
-            case "onto.observe_source": {
+            case "onto_observe_source": {
                 const parsed = OntoObserveSourceToolInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 const sessionRoot = resolveReconstructSessionRoot({
@@ -988,7 +988,7 @@ async function callTool(name, args, options = {}) {
                     ...(filesystemAllowedRoots ? { filesystemAllowedRoots } : {}),
                 }));
             }
-            case "onto.validate_reconstruct_directive": {
+            case "onto_validate_reconstruct_directive": {
                 const parsed = OntoValidateReconstructDirectiveToolInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 const sourceObservationsPath = resolveInsideProject({
@@ -1066,7 +1066,7 @@ async function callTool(name, args, options = {}) {
                 }
                 throw new Error("Unsupported reconstruct directive kind.");
             }
-            case "onto.reconstruct": {
+            case "onto_reconstruct": {
                 const parsed = OntoReconstructToolInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 const sessionRoot = resolveReconstructSessionRoot({
@@ -1103,7 +1103,7 @@ async function callTool(name, args, options = {}) {
                     ...(filesystemAllowedRoots ? { filesystemAllowedRoots } : {}),
                 }));
             }
-            case "onto.reconstruct_status": {
+            case "onto_reconstruct_status": {
                 const parsed = OntoReconstructSessionInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 const sessionRoot = await resolveAllowedReconstructSessionRoot({
@@ -1112,7 +1112,7 @@ async function callTool(name, args, options = {}) {
                 });
                 return formatToolResult(await reconstructApi.getRunStatus(sessionRoot));
             }
-            case "onto.reconstruct_result": {
+            case "onto_reconstruct_result": {
                 const parsed = OntoReconstructSessionInputSchema.parse(args);
                 const projectRoot = resolveProjectRoot(parsed.projectRoot);
                 const sessionRoot = await resolveAllowedReconstructSessionRoot({

package/dist/mcp/tool-schemas.js

@@ -116,18 +116,18 @@ export const OntoValidateReconstructDirectiveToolInputSchema = z.discriminatedUn
     OntoValidateOntologySeedToolInputSchema,
 ]);
 export const OntoToolNames = [
-    "onto.review",
-    "onto.prepare_review",
-    "onto.review_continue",
-    "onto.review_cancel",
-    "onto.review_status",
-    "onto.review_result",
-    "onto.list_lenses",
-    "onto.list_domains",
-    "onto.list_source_profiles",
-    "onto.observe_source",
-    "onto.validate_reconstruct_directive",
-    "onto.reconstruct",
-    "onto.reconstruct_status",
-    "onto.reconstruct_result",
+    "onto_review",
+    "onto_prepare_review",
+    "onto_review_continue",
+    "onto_review_cancel",
+    "onto_review_status",
+    "onto_review_result",
+    "onto_list_lenses",
+    "onto_list_domains",
+    "onto_list_source_profiles",
+    "onto_observe_source",
+    "onto_validate_reconstruct_directive",
+    "onto_reconstruct",
+    "onto_reconstruct_status",
+    "onto_reconstruct_result",
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onto-mcp",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "MCP-native ontology review runtime with context-isolated lenses and controlled deliberation",
   "homepage": "https://github.com/kangminlee-maker/onto-mcp#readme",
   "bugs": {