arkaik 0.2.0 → 0.4.0

package/dist/io.js

@@ -15203,6 +15203,13 @@ var QualityFindingResolvedEventSchema = external_exports.object({
   resolved_by: external_exports.string().optional(),
   node_ids: external_exports.array(external_exports.string()).optional()
 }).catchall(external_exports.unknown());
+var QualityFindingAcceptedEventSchema = external_exports.object({
+  ...envelope,
+  type: external_exports.literal("quality.finding.accepted"),
+  finding_id: external_exports.string(),
+  reason: external_exports.string(),
+  node_ids: external_exports.array(external_exports.string()).optional()
+}).catchall(external_exports.unknown());
 var QualitySignalTrippedEventSchema = external_exports.object({
   ...envelope,
   type: external_exports.literal("quality.signal.tripped"),
@@ -15230,6 +15237,7 @@ var JOURNAL_EVENT_SCHEMAS = {
   "quality.audit.completed": QualityAuditCompletedEventSchema,
   "quality.finding.opened": QualityFindingOpenedEventSchema,
   "quality.finding.resolved": QualityFindingResolvedEventSchema,
+  "quality.finding.accepted": QualityFindingAcceptedEventSchema,
   "quality.signal.tripped": QualitySignalTrippedEventSchema
 };
 var KnownJournalEventSchema = external_exports.union([
@@ -15251,6 +15259,7 @@ var KnownJournalEventSchema = external_exports.union([
   QualityAuditCompletedEventSchema,
   QualityFindingOpenedEventSchema,
   QualityFindingResolvedEventSchema,
+  QualityFindingAcceptedEventSchema,
   QualitySignalTrippedEventSchema
 ]);
 
@@ -15338,6 +15347,9 @@ var QualityFindingSchema = external_exports.object({
   remediation: external_exports.string().optional(),
   node_ids: external_exports.array(external_exports.string()).optional().meta({ description: "Graph nodes this finding is about \u2014 the tie deliverable.shipped already uses." }),
   issue_url: external_exports.string().optional(),
+  commit: external_exports.string().optional().meta({
+    description: "Commit SHA anchoring the file:line evidence. Required by policy on any finding written away from a checkout (issue #400 decision 4) \u2014 without it a stale citation is indistinguishable from a wrong one."
+  }),
   verification: external_exports.object({ verdict: external_exports.enum(["CONFIRMED", "REFUTED", "DOWNGRADED"]), note: external_exports.string().optional() }).catchall(external_exports.unknown()).optional().meta({ description: "Result of the adversarial refutation pass. Refuted findings are disclosed, not deleted." })
 }).catchall(external_exports.unknown()).meta({
   id: "QualityFinding",
@@ -16422,6 +16434,15 @@ function validateBundle(input) {
           );
         }
       }
+      if (type === "quality.finding.accepted" && typeof event.finding_id === "string") {
+        if (!openedInJournal.has(event.finding_id) && !seenFindingIds.has(event.finding_id)) {
+          warn(
+            `journal[${index}].finding_id`,
+            "quality-accepted-never-opened",
+            `Journal event ${index}: accepts finding "${event.finding_id}", which no quality.finding.opened event or stored finding ever declared`
+          );
+        }
+      }
     });
   }
   for (const finding of crossCheckJournal(bundle)) findings.push(finding);
@@ -16583,7 +16604,7 @@ function compactSlice(journalPath, slice, version2) {
 
 // src/lib/kritik-io.ts
 import { existsSync as existsSync4 } from "node:fs";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { basename, dirname as dirname3, join as join3, resolve as resolve2 } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // ../schema/src/cli/kritik-paths.ts
@@ -16593,7 +16614,12 @@ var QUALITY_DIR = "docs/quality";
 var OVERLAY_FILE = "criteria.custom.json";
 var PACK_FILE = "library.json";
 function readJson(path) {
-  return JSON.parse(readFileSync3(path, "utf8"));
+  const text = readFileSync3(path, "utf8");
+  try {
+    return JSON.parse(text);
+  } catch (e) {
+    throw new Error(`${path}: not valid JSON \u2014 ${e.message}`);
+  }
 }
 var overlayPath = (root) => join2(root, QUALITY_DIR, OVERLAY_FILE);
 function loadOverlay(root) {
@@ -16638,10 +16664,18 @@ function appendQualityEvents(root, inputs, options = {}) {
   for (const event of events) appendJournalEvent(journal.journalPath, event);
   return { journalPath: journal.journalPath, events, ...baseline !== void 0 ? { baseline } : {} };
 }
+function resolveQualityRoot(options) {
+  if (options.root !== void 0) return resolve2(options.fallback, options.root);
+  const envRoot = (options.env ?? process.env).ARKAIK_QUALITY_ROOT;
+  if (envRoot) return resolve2(envRoot);
+  const dir = dirname3(options.bundlePath);
+  if (basename(dir) === "arkaik" && basename(dirname3(dir)) === "docs") return resolve2(dir, "..", "..");
+  return options.fallback;
+}
 
 // src/lib/bundle-validate.ts
 import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
-import { basename } from "node:path";
+import { basename as basename2 } from "node:path";
 function validateBundleAt(filePath) {
   const bundle = readBundle(filePath);
   const loose = bundle;
@@ -16663,7 +16697,7 @@ function validateBundleAt(filePath) {
     }
     for (const archivePath of archivePathsFor(sidecarPath)) {
       const { events, findings } = parseJournalLines(readFileSync4(archivePath, "utf8"));
-      const file2 = basename(archivePath);
+      const file2 = basename2(archivePath);
       for (const finding of findings) archiveFindings.push({ ...finding, file: file2 });
       archivesLoaded.push(file2);
       folded.push(...events);
@@ -16714,5 +16748,6 @@ export {
   readJournalEvents,
   resolveJournal,
   resolvePack,
+  resolveQualityRoot,
   validateBundleAt
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaik",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Arkaik CLI — link a repository to a hosted product graph, validate and pack bundles, mirror external ref status.",
   "license": "MIT",
   "type": "module",

package/src/io.ts

@@ -30,6 +30,7 @@ export {
   loadKritikLibrary,
   resolveJournal,
   appendQualityEvents,
+  resolveQualityRoot,
   type ResolvedPack,
 } from "./lib/kritik-io";
 export {