mirai-graph 1.3.0 → 2.1.0

package/packages/cli/validate-release-state.js

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require("child_process");
-const path = require("path");
-
-const root = path.resolve(__dirname, "..", "..");
-const node = process.execPath;
-const releaseState = path.join(root, "packages", "cli", "release-state.js");
-
-const args = process.argv.slice(2);
-const requireGitTag = args.includes("--require-git-tag");
-const requireGithubRelease = args.includes("--require-github-release");
-const requireNpmPublished = args.includes("--require-npm-published");
-const releaseStateArgs = [
-  ...(requireGitTag ? ["--require-git-tag"] : []),
-  ...(requireGithubRelease ? ["--require-github-release"] : []),
-  ...(requireNpmPublished ? ["--require-npm-published"] : [])
-];
-
-const result = spawnSync(node, [releaseState, ...releaseStateArgs], {
-  cwd: root,
-  encoding: "utf8"
-});
-
-const errors = [];
-let state = null;
-
-if (result.status !== 0) {
-  errors.push(`release-state command failed with exit ${result.status}`);
-}
-
-try {
-  state = JSON.parse(result.stdout);
-} catch (error) {
-  errors.push("release-state output is not valid JSON");
-}
-
-if (state) {
-  if (state.report_type !== "mirai_graph_release_state") {
-    errors.push("unexpected report_type");
-  }
-  if (!state.package || state.package.name !== "mirai-graph") {
-    errors.push("package name must be mirai-graph");
-  }
-  if (!state.package || !state.package.version) {
-    errors.push("package version is required");
-  }
-  if (requireGitTag && (!state.git || !state.git.tag_exists)) {
-    errors.push("current package version must have a local git tag");
-  }
-  if (requireGithubRelease && (!state.github_release || !state.github_release.found)) {
-    errors.push("matching GitHub Release must exist");
-  }
-  if (!state.npm || !state.npm.package || typeof state.npm.package.version_published !== "boolean") {
-    errors.push("npm package publication state must be reported");
-  }
-  if (!state.npm || typeof state.npm.authenticated !== "boolean") {
-    errors.push("npm authentication state must be reported");
-  }
-  if (!Array.isArray(state.blockers)) {
-    errors.push("blockers must be an array");
-  }
-  if (!Array.isArray(state.boundary) || !state.boundary.some((item) => item.includes("does not publish"))) {
-    errors.push("release-state boundary must state that the report does not publish");
-  }
-}
-
-const markdown = spawnSync(node, [releaseState, "--markdown", ...releaseStateArgs], {
-  cwd: root,
-  encoding: "utf8"
-});
-
-if (markdown.status !== 0) {
-  errors.push(`release-state markdown command failed with exit ${markdown.status}`);
-} else {
-  for (const expected of ["Mirai Graph Release State", "GitHub Release", "NPM Package", "Blockers"]) {
-    if (!markdown.stdout.includes(expected)) {
-      errors.push(`markdown report missing ${expected}`);
-    }
-  }
-}
-
-const validation = {
-  mode: "release_state",
-  valid: errors.length === 0,
-  checked_version: state && state.package && state.package.version || null,
-  require_git_tag: requireGitTag,
-  require_github_release: requireGithubRelease,
-  require_npm_published: requireNpmPublished,
-  npm_version_published: state && state.npm && state.npm.package && state.npm.package.version_published,
-  npm_authenticated: state && state.npm && state.npm.authenticated,
-  blockers: state && state.blockers || [],
-  errors
-};
-
-console.log(JSON.stringify(validation, null, 2));
-
-if (errors.length > 0) {
-  process.exit(1);
-}

package/packages/cli/validate-routing-control-examples.js

@@ -1,79 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const path = require("path");
-
-const exampleDir = path.join("examples", "federation-routing-smoke");
-const requiredFiles = [
-  "routing-fixtures.json",
-  "routing-fixture-run.json",
-  "route-explanation.json",
-  "route-regression-result.json",
-  "federation-health-dashboard.json"
-];
-
-const errors = [];
-
-function readJson(file) {
-  try {
-    return JSON.parse(fs.readFileSync(file, "utf8"));
-  } catch (error) {
-    errors.push(`${file}: cannot read JSON: ${error.message}`);
-    return null;
-  }
-}
-
-for (const fileName of requiredFiles) {
-  const file = path.join(exampleDir, fileName);
-  if (!fs.existsSync(file)) {
-    errors.push(`${file}: missing`);
-  }
-}
-
-const fixtures = readJson(path.join(exampleDir, "routing-fixtures.json"));
-const run = readJson(path.join(exampleDir, "routing-fixture-run.json"));
-const explanation = readJson(path.join(exampleDir, "route-explanation.json"));
-const regression = readJson(path.join(exampleDir, "route-regression-result.json"));
-const health = readJson(path.join(exampleDir, "federation-health-dashboard.json"));
-
-if (fixtures) {
-  if (fixtures.canonical_write_allowed !== false) errors.push("routing-fixtures.json: canonical_write_allowed must be false");
-  if (!Array.isArray(fixtures.fixtures) || fixtures.fixtures.length < 2) errors.push("routing-fixtures.json: must include at least two synthetic fixtures");
-}
-
-if (run) {
-  if (run.canonical_write_allowed !== false) errors.push("routing-fixture-run.json: canonical_write_allowed must be false");
-  if (!run.summary || run.summary.fixture_count !== 2 || run.summary.passed !== 2) errors.push("routing-fixture-run.json: expected two passing fixtures");
-  for (const result of run.results || []) {
-    if (!result.execution_evidence_ref) errors.push(`${result.fixture_id}: execution_evidence_ref is required`);
-    if (!result.route_result_ref) errors.push(`${result.fixture_id}: route_result_ref is required`);
-    if (result.high_risk_route && !result.route_explanation_ref) errors.push(`${result.fixture_id}: high-risk route requires route_explanation_ref`);
-  }
-}
-
-if (explanation) {
-  if (explanation.canonical_write_allowed !== false) errors.push("route-explanation.json: canonical_write_allowed must be false");
-  if (!explanation.route_evidence_ref) errors.push("route-explanation.json: route_evidence_ref is required");
-  if (explanation.explanation_source !== "synthetic_example") errors.push("route-explanation.json: explanation_source must be synthetic_example");
-}
-
-if (regression) {
-  if (regression.regression_status !== "unchanged") errors.push("route-regression-result.json: regression_status must be unchanged");
-  if (regression.canonical_write_allowed !== false) errors.push("route-regression-result.json: canonical_write_allowed must be false");
-}
-
-if (health) {
-  if (health.watch_conflict_count < 1) errors.push("federation-health-dashboard.json: watch_conflict_count should expose watched conflict families");
-  if (health.high_risk_without_explanation_count !== 0) errors.push("federation-health-dashboard.json: high_risk_without_explanation_count must be zero");
-  if (health.canonical_write_allowed !== false) errors.push("federation-health-dashboard.json: canonical_write_allowed must be false");
-}
-
-const output = {
-  mode: "routing_control_examples",
-  valid: errors.length === 0,
-  checked_files: requiredFiles.map((fileName) => path.join(exampleDir, fileName)),
-  errors
-};
-
-console.log(JSON.stringify(output, null, 2));
-process.exit(output.valid ? 0 : 1);

package/packages/cli/validate-self-service-onboarding.js

@@ -1,159 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const { spawnSync } = require("child_process");
-
-const root = path.resolve(__dirname, "..", "..");
-const node = process.execPath;
-const cli = path.join(root, "packages", "cli", "mirai-graph.js");
-const validator = path.join(root, "packages", "cli", "validate-mirai-graph.js");
-
-function run(args, options = {}) {
-  return spawnSync(node, [cli, ...args], {
-    cwd: root,
-    encoding: "utf8",
-    ...options
-  });
-}
-
-function runValidator(args, options = {}) {
-  return spawnSync(node, [validator, ...args], {
-    cwd: root,
-    encoding: "utf8",
-    ...options
-  });
-}
-
-function readJson(text) {
-  return JSON.parse(text);
-}
-
-function listFiles(dir) {
-  if (!fs.existsSync(dir)) return [];
-  const out = [];
-  function walk(current) {
-    for (const entry of fs.readdirSync(current).sort()) {
-      const abs = path.join(current, entry);
-      const rel = path.relative(dir, abs);
-      if (fs.statSync(abs).isDirectory()) {
-        walk(abs);
-      } else {
-        out.push(rel);
-      }
-    }
-  }
-  walk(dir);
-  return out;
-}
-
-function copyDir(source, target) {
-  fs.mkdirSync(target, { recursive: true });
-  for (const entry of fs.readdirSync(source)) {
-    const src = path.join(source, entry);
-    const dst = path.join(target, entry);
-    if (fs.statSync(src).isDirectory()) {
-      copyDir(src, dst);
-    } else {
-      fs.copyFileSync(src, dst);
-    }
-  }
-}
-
-const errors = [];
-
-function assert(condition, message) {
-  if (!condition) errors.push(message);
-}
-
-const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mirai-graph-self-service-"));
-
-const noGraph = path.join(root, "examples", "self-service-onboarding", "no-graph");
-const staleGraph = path.join(root, "examples", "self-service-onboarding", "stale-graph");
-const existingGraph = path.join(root, "examples", "self-service-onboarding", "existing-graph");
-
-const beforeDetect = listFiles(noGraph);
-const detect = run(["detect", noGraph, "--json"]);
-assert(detect.status === 0, `detect failed: ${detect.stderr}`);
-if (detect.status === 0) {
-  const result = readJson(detect.stdout);
-  assert(result.graph_presence === "missing", "detect should classify no-graph fixture as missing");
-  assert(result.recommended_profile === "software_specification", "detect should recommend software_specification for package.json/src fixture");
-  assert(result.canonical_write_allowed === false, "detect must not allow canonical writes");
-}
-assert(JSON.stringify(beforeDetect) === JSON.stringify(listFiles(noGraph)), "detect must not write files");
-
-const staleDetect = run(["detect", staleGraph, "--json"]);
-assert(staleDetect.status === 0, `stale detect failed: ${staleDetect.stderr}`);
-if (staleDetect.status === 0) {
-  const result = readJson(staleDetect.stdout);
-  assert(result.graph_presence === "incomplete", "stale fixture should be incomplete");
-  assert(result.missing_artifacts.includes(path.join("graph", "objects.json")), "stale fixture should report missing graph/objects.json");
-}
-
-const bootstrapTarget = path.join(tmpRoot, "bootstrap-target");
-copyDir(noGraph, bootstrapTarget);
-const bootstrap = run(["bootstrap", bootstrapTarget, "--mode", "suggest", "--json"]);
-assert(bootstrap.status === 0, `bootstrap suggest failed: ${bootstrap.stderr}`);
-if (bootstrap.status === 0) {
-  const result = readJson(bootstrap.stdout);
-  assert(result.mode === "bootstrap_suggest", "bootstrap should report bootstrap_suggest");
-  assert(result.canonical_write_allowed === false, "bootstrap suggest must not allow canonical writes");
-  assert(fs.existsSync(result.proposal_ref), "bootstrap proposal should exist");
-  const proposal = readJson(fs.readFileSync(result.proposal_ref, "utf8"));
-  assert(proposal.canonical_write_allowed === false, "bootstrap proposal must keep canonical_write_allowed=false");
-  assert(!fs.existsSync(path.join(bootstrapTarget, "graph.json")), "bootstrap suggest must not create canonical manifest");
-}
-
-const initTarget = path.join(tmpRoot, "init-target");
-fs.mkdirSync(initTarget, { recursive: true });
-const init = run(["init", initTarget, "--profile", "software_specification"]);
-assert(init.status === 0, `init failed: ${init.stderr}`);
-assert(fs.existsSync(path.join(initTarget, "graph.json")), "init should create v2 manifest");
-assert(fs.existsSync(path.join(initTarget, "graph", "objects.json")), "init should create graph/objects.json");
-assert(fs.existsSync(path.join(initTarget, "graph", "relations.json")), "init should create graph/relations.json");
-assert(fs.existsSync(path.join(initTarget, "gates", "results.json")), "init should create gates/results.json");
-
-const initValidation = runValidator([initTarget]);
-assert(initValidation.status === 0, `created package should validate: ${initValidation.stderr || initValidation.stdout}`);
-
-const existingTarget = path.join(tmpRoot, "existing-target");
-copyDir(existingGraph, existingTarget);
-const initExisting = run(["init", existingTarget, "--profile", "software_specification"]);
-assert(initExisting.status !== 0, "init should fail on existing graph files without --force");
-assert(initExisting.stderr.includes("Refusing") || initExisting.stderr.includes("already has graph files"), "init existing failure should explain overwrite boundary");
-
-const invalidProfile = run(["init", path.join(tmpRoot, "invalid-profile"), "--profile", "unknown_profile"]);
-assert(invalidProfile.status !== 0, "invalid profile should fail");
-assert(invalidProfile.stderr.includes("Unknown profile"), "invalid profile should produce actionable error");
-
-const markdown = run(["detect", noGraph, "--markdown"]);
-assert(markdown.status === 0, `detect markdown failed: ${markdown.stderr}`);
-assert(markdown.stdout.includes("Mirai Graph Self-Service Report"), "detect markdown should include report title");
-
-const fixtureProposal = JSON.parse(fs.readFileSync(path.join(root, "examples", "self-service-onboarding", "bootstrap-proposal", "bootstrap-proposal.json"), "utf8"));
-assert(fixtureProposal.canonical_write_allowed === false, "static bootstrap proposal fixture must keep canonical_write_allowed=false");
-
-const result = {
-  mode: "self_service_onboarding",
-  valid: errors.length === 0,
-  temp_dir: tmpRoot,
-  checked: [
-    "detect read-only",
-    "stale graph detection",
-    "bootstrap suggest proposal",
-    "init creates valid package",
-    "init overwrite negative",
-    "invalid profile negative",
-    "markdown report",
-    "static proposal fixture"
-  ],
-  errors
-};
-
-console.log(JSON.stringify(result, null, 2));
-
-if (errors.length > 0) {
-  process.exit(1);
-}