@attentionform/astra 0.2.0 → 0.2.1

package/dist/cli.js

@@ -34084,19 +34084,6 @@ async function repairDocxBuffer(input, options = {}) {
   }
   return { buffer: normalized.length > 0 ? pack(current) : input, normalized, remaining, rolledBack };
 }
-async function forecastNormalize(input) {
-  try {
-    const outcome = await repairDocxBuffer(input);
-    if (outcome.normalized.length === 0) return void 0;
-    return { changes: outcome.normalized.length, remaining: outcome.remaining };
-  } catch {
-    return void 0;
-  }
-}
-function normalizeHintSentence(forecast, errorCount, how) {
-  const left = forecast.remaining === 0 ? "and the document then validates" : forecast.remaining > 0 ? `and leaves ${forecast.remaining} of ${errorCount} errors, which need Word` : "and the rest need Word";
-  return `${how} can repair some of these errors (${forecast.changes} change${forecast.changes === 1 ? "" : "s"}) ${left}.`;
-}
 
 // ../engine/src/export/html.ts
 function asFootnoteZipCapable(parser2) {
@@ -38633,7 +38620,7 @@ function summarizeStyleGuide(guide) {
 // package.json
 var package_default = {
   name: "@attentionform/astra",
-  version: "0.2.0",
+  version: "0.2.1",
   description: "Command-line tool for OOXML (.docx) document engineering",
   main: "dist/cli.js",
   types: "dist/packages/cli/src/cli.d.ts",
@@ -38676,8 +38663,8 @@ var package_default = {
     "adm-zip-gate": "node ../../scripts/check-adm-zip-imports.mjs"
   },
   dependencies: {
-    "@attentionform/astra-engine": "^0.2.0",
-    "@attentionform/ooxml-validator": "^0.2.0",
+    "@attentionform/astra-engine": "^0.2.1",
+    "@attentionform/ooxml-validator": "^0.2.1",
     "@xmldom/xmldom": "0.8.15",
     "adm-zip": "0.6.1",
     "isomorphic-git": "^1.25.0",
@@ -39179,6 +39166,7 @@ function commandHelpText(cmd) {
       `Usage: ${CLI_NAME} validate <docx> [--max-errors <n>] [--max-ratio <n>] [--max-uncompressed-bytes <n>] [--allow-macros] [--strip-macros] [--style-guide <name|path>]`,
       "",
       "Fail-closed OOXML validation. Prints VALID <file> (exit 0) or INVALID + first errors (exit 1).",
+      "Invalid documents receive advice to attempt normalize with --out to a new file, then validate again; no repair preview is run.",
       "  --max-errors <n>                   most errors listed by --json (integer 1 to 5000, default 500); the JSON carries truncated:true and maxErrors when the list was cut. The human output shows 10 and counts the rest.",
       "  --max-ratio <n>                    zip-bomb ratio ceiling override (default 100; env ASTRA_MAX_RATIO)",
       "  --max-uncompressed-bytes <n>       zip-bomb total-bytes ceiling override in bytes (default 209715200; env ASTRA_MAX_UNCOMPRESSED_BYTES)",
@@ -41642,6 +41630,7 @@ async function cmdInspect(out, args) {
 var DEFAULT_MAX_ERRORS = 500;
 var MAX_ERRORS_LIMIT = 5e3;
 var HUMAN_ERRORS_SHOWN = 10;
+var NORMALIZE_HINT = `Run \`${CLI_NAME} normalize\` with \`--out\` pointing to a new file to attempt supported repairs, then validate the result again.`;
 async function cmdValidate(out, args) {
   if (hasHelpFlag(args)) return printCommandHelp(out, "validate");
   let file;
@@ -41719,6 +41708,7 @@ async function cmdValidate(out, args) {
     }
     const macroOpts = macroOptsFromFlags({ allowMacros, stripMacros });
     let pendingNormalizations = [];
+    let schemaValidationCompleted = false;
     const result = await withZipCeilingEnv(ceilings, async () => {
       let p;
       try {
@@ -41747,7 +41737,9 @@ async function cmdValidate(out, args) {
       } catch {
         pendingNormalizations = [];
       }
-      return p.validateOOXML({ maxErrors });
+      const validation = await p.validateOOXML({ maxErrors });
+      schemaValidationCompleted = true;
+      return validation;
     });
     const pending = pendingNormalizations.length > 0 ? { pendingNormalizations } : {};
     if (result.ok) {
@@ -41801,8 +41793,7 @@ async function cmdValidate(out, args) {
     if (errors.length > HUMAN_ERRORS_SHOWN) {
       print(out, `  ... and ${errors.length - HUMAN_ERRORS_SHOWN} more${truncated ? " (the list is cut at the limit)" : ""}; --json lists them (up to ${maxErrors}, --max-errors <n> changes the limit)`);
     }
-    const forecast = truncated ? void 0 : await forecastNormalize(buf);
-    const hint = forecast ? normalizeHintSentence(forecast, errors.length, `Run \`${CLI_NAME} normalize ${file}\`: it`) : void 0;
+    const hint = schemaValidationCompleted ? NORMALIZE_HINT : void 0;
     printJson(out, {
       ok: false,
       file,
@@ -41814,8 +41805,8 @@ async function cmdValidate(out, args) {
       errors
     });
     if (!out.json) {
-      const hintSuffix = hint ? ` ${hint}` : "";
-      printStderr(`${CLI_NAME}: error: [E_VALIDATION] "${file}" failed OOXML validation. Remedy: repair the document in Word and retry.${hintSuffix}`);
+      const remedy = hint ? `${hint} Repair by hand what remains, for example in Word.` : "repair the document in Word and retry.";
+      printStderr(`${CLI_NAME}: error: [E_VALIDATION] "${file}" failed OOXML validation. Remedy: ${remedy}`);
     }
     return EXIT_FAIL;
   } catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attentionform/astra",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Command-line tool for OOXML (.docx) document engineering",
   "main": "dist/cli.js",
   "types": "dist/packages/cli/src/cli.d.ts",
@@ -43,8 +43,8 @@
     "adm-zip-gate": "node ../../scripts/check-adm-zip-imports.mjs"
   },
   "dependencies": {
-    "@attentionform/astra-engine": "^0.2.0",
-    "@attentionform/ooxml-validator": "^0.2.0",
+    "@attentionform/astra-engine": "^0.2.1",
+    "@attentionform/ooxml-validator": "^0.2.1",
     "@xmldom/xmldom": "0.8.15",
     "adm-zip": "0.6.1",
     "isomorphic-git": "^1.25.0",