@markdstage/markdstage 3.1.0 → 3.3.0

package/src/commands/validate.mjs

@@ -3,6 +3,7 @@
 import {
   MarkdStageError,
   architectureValidationErrors,
+  architectureValidationReport,
   createDeckSession,
   createUrlToken,
   hasFrontMatter,
@@ -27,10 +28,24 @@ export async function validateCommand(options) {
       code: error.code,
       message: error.message,
     });
-    return { ok: false, file: options.file, total: 0, errors, warnings };
+    return {
+      ok: false,
+      valid: false,
+      complete: false,
+      truncated: false,
+      file: options.file,
+      total: 0,
+      errors,
+      warnings,
+      stages: { json: "skipped", structure: "skipped", semantic: "skipped", layout: "skipped" },
+      diagnostics: [],
+      diagnosticCount: 0,
+      blocks: [],
+    };
   }
 
-  for (const issue of architectureValidationErrors(session.slides)) {
+  const validation = architectureValidationReport(session.slides);
+  for (const issue of architectureValidationErrors(session.slides, { validation })) {
     errors.push({
       code: issue.code,
       page: issue.page,
@@ -38,6 +53,12 @@ export async function validateCommand(options) {
       message: issue.message,
     });
   }
+  if (validation.truncated) {
+    errors.push({
+      code: "validation_incomplete",
+      message: `Architecture validation reached inspection limits (${validation.budget.limitsReached.join(", ")}). Validate smaller inputs before treating the deck as valid.`,
+    });
+  }
 
   session.slides.forEach((slide, index) => {
     if (!hasFrontMatter(slide)) {
@@ -51,7 +72,10 @@ export async function validateCommand(options) {
   });
 
   return {
-    ok: errors.length === 0,
+    ok: errors.length === 0 && validation.valid,
+    valid: errors.length === 0 && validation.valid,
+    complete: validation.complete,
+    truncated: validation.truncated,
     file: session.file,
     workspace: session.workspaceRoot,
     total: session.slides.length,
@@ -59,6 +83,13 @@ export async function validateCommand(options) {
     themeFile: session.customThemeFile || undefined,
     errors,
     warnings,
+    stages: validation.stages,
+    diagnostics: validation.diagnostics,
+    diagnosticCount: validation.diagnosticCount,
+    blocks: validation.blocks,
+    skipped: validation.skipped,
+    limits: validation.limits,
+    budget: validation.budget,
   };
 }
 
@@ -74,6 +105,11 @@ export function formatValidateReport(report) {
   for (const warning of report.warnings) {
     lines.push(`  warn   slide ${warning.page}: ${warning.message}`);
   }
+  if (report.complete === false) {
+    lines.push(report.truncated
+      ? "  Validation incomplete: inspection limits were reached; unchecked content is not valid."
+      : "  Architecture validation incomplete: fix the reported errors and validate again.");
+  }
   lines.push(report.ok ? "  OK: the deck is valid." : `  ${report.errors.length} error(s) found.`);
   return lines.join("\n");
 }

package/src/runtime.mjs

@@ -48,6 +48,7 @@ const [
   guide,
   presenterWindow,
   markdownFiles,
+  architectureValidation,
 ] = await Promise.all([
   load("runtime/errors.mjs"),
   load("runtime/deck-session.mjs"),
@@ -58,6 +59,7 @@ const [
   load("markdstage-guide.mjs"),
   load("presenter-window.mjs"),
   load("scripts/markdown-files.mjs"),
+  load("architecture-validation.mjs"),
 ]);
 
 export const { MarkdStageError } = errors;
@@ -75,9 +77,11 @@ export const { findChromiumBrowser, terminateProcessTree, isProcessRunning } = b
 export const { captureDirectoryName, pdfNameForSource, pptxNameForSource } = outputPaths;
 export const {
   architectureValidationErrors,
+  architectureValidationReport,
   deckValidationFeedback,
   hasFrontMatter,
   readGuide,
 } = guide;
+export const { validateArchitectureInput, createArchitectureValidationTool } = architectureValidation;
 export const { buildPresenterBrowserArgs } = presenterWindow;
 export const { isMarkdownPath, MARKDOWN_MAX_BYTES } = markdownFiles;

package/src/skills.mjs

@@ -73,11 +73,15 @@ what the MarkdStage canvas and MarkdStage Desktop render.
    required diagrams, and output format.
 2. Read only the relevant guidance. Start with
    \`markdstage guide slide-format\`, then retrieve \`themes\`,
-   \`custom-themes\`, or \`architecture-dsl\` when needed.
+   \`custom-themes\`, or \`architecture-schema\` when needed. Before drafting
+   Architecture DSL, read the compact \`architecture-schema\` contract first;
+   use \`architecture-dsl\` for advanced behavior.
 3. Create the complete deck as one Markdown source file (see
    \`references/slide-format.md\`).
 4. Validate structure, themes, and Architecture DSL before visual review:
-   \`markdstage validate slides.md --json\`.
+   \`markdstage validate slides.md --json\`. Review diagnostic codes, JSON Pointers,
+   and completeness, fix independent issues together, and preserve the same
+   validated content when presenting. Suggestions are never automatic repairs.
 5. Use \`markdstage preview slides.md --watch\` for live source-backed authoring.
    It reloads on save without losing the current slide and keeps the last valid
    deck while a save is incomplete.