@nimiplatform/nimi-coding 0.3.1 → 0.4.0

package/cli/commands/generate-spec-derived-docs.mjs

@@ -1,151 +0,0 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-import { localize } from "../lib/ui.mjs";
-import { loadGovernanceConfig, requireProfile } from "../lib/internal/governance/config.mjs";
-import { runCommand } from "../lib/internal/governance/runner.mjs";
-import { parseSpecGenerationInputsConfig } from "../lib/internal/contracts-parse.mjs";
-
-const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
-
-function parseOptions(args) {
-  const options = {
-    profile: null,
-    scope: "all",
-    check: false,
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-
-    if (arg === "--profile") {
-      const value = args[index + 1];
-      if (!value || value.startsWith("--")) {
-        return { ok: false, error: "nimicoding generate-spec-derived-docs refused: --profile requires a value.\n" };
-      }
-      options.profile = value;
-      index += 1;
-      continue;
-    }
-
-    if (arg === "--scope") {
-      const value = args[index + 1];
-      if (!value || value.startsWith("--")) {
-        return { ok: false, error: "nimicoding generate-spec-derived-docs refused: --scope requires a value.\n" };
-      }
-      options.scope = value;
-      index += 1;
-      continue;
-    }
-
-    if (arg === "--check") {
-      options.check = true;
-      continue;
-    }
-
-    return {
-      ok: false,
-      error: `nimicoding generate-spec-derived-docs refused: unknown option ${arg}.\n`,
-    };
-  }
-
-  return { ok: true, options };
-}
-
-function resolveScopes(scope, governanceConfig) {
-  const configuredScopes = Object.keys(governanceConfig.specGovernance.generateCommands || {});
-  if (scope === "all") {
-    return {
-      ok: true,
-      scopes: configuredScopes,
-      error: null,
-    };
-  }
-  if (!configuredScopes.includes(scope)) {
-    return {
-      ok: false,
-      scopes: [],
-      error: `nimicoding generate-spec-derived-docs refused: unsupported --scope value ${scope}.\n`,
-    };
-  }
-  return {
-    ok: true,
-    scopes: [scope],
-    error: null,
-  };
-}
-
-export async function runGenerateSpecDerivedDocs(args) {
-  const parsed = parseOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(localize(parsed.error, parsed.error));
-    return 2;
-  }
-
-  const governance = await loadGovernanceConfig(process.cwd());
-  if (!governance.ok) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-derived-docs refused: ${governance.reason} at ${governance.path}.\n`,
-      `nimicoding generate-spec-derived-docs 已拒绝：${governance.path} 的治理配置不可用。\n`,
-    ));
-    return 2;
-  }
-
-  const profileCheck = requireProfile(governance.config, parsed.options.profile);
-  if (!profileCheck.ok) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-derived-docs refused: ${profileCheck.error}.\n`,
-      `nimicoding generate-spec-derived-docs 已拒绝：${profileCheck.error}。\n`,
-    ));
-    return 2;
-  }
-
-  const scopeResolution = resolveScopes(parsed.options.scope, governance.config);
-  if (!scopeResolution.ok) {
-    process.stderr.write(localize(scopeResolution.error, scopeResolution.error));
-    return 2;
-  }
-
-  const packageInputsText = await readFile(
-    path.join(PACKAGE_ROOT, "config", "spec-generation-inputs.yaml"),
-    "utf8",
-  );
-  const packageInputs = parseSpecGenerationInputsConfig(packageInputsText);
-  if (!packageInputs.ok || !packageInputs.generationOrder.includes("validate_placement")) {
-    process.stderr.write(localize(
-      "nimicoding generate-spec-derived-docs refused: package spec generation inputs must be class-filtered and include placement validation.\n",
-      "nimicoding generate-spec-derived-docs 已拒绝：package spec generation inputs 必须按 surface class 过滤并包含 placement validation。\n",
-    ));
-    return 2;
-  }
-
-  let failed = false;
-  for (const scope of scopeResolution.scopes) {
-    const commands = governance.config.specGovernance.generateCommands[scope] || [];
-    if (commands.length === 0) {
-      process.stderr.write(localize(
-        `nimicoding generate-spec-derived-docs refused: scope ${scope} is not configured in .nimi/config/governance.yaml.\n`,
-        `nimicoding generate-spec-derived-docs 已拒绝：.nimi/config/governance.yaml 未配置 ${scope}。\n`,
-      ));
-      return 2;
-    }
-
-    for (const command of commands) {
-      const commandToRun = parsed.options.check ? `${command} --check` : command;
-      const result = runCommand(commandToRun, { cwd: process.cwd() });
-      if (result.stdout) process.stdout.write(result.stdout);
-      if (result.stderr) process.stderr.write(result.stderr);
-      if (!result.ok) {
-        failed = true;
-        break;
-      }
-    }
-
-    if (failed) {
-      break;
-    }
-  }
-
-  return failed ? 1 : 0;
-}

package/cli/commands/generate-spec-migration-plan.mjs

@@ -1,30 +0,0 @@
-import {
-  generateSpecMigrationPlan,
-  parseSurfaceValidatorOptions,
-  writeMigrationPlanIfRequested,
-} from "../lib/internal/surface-taxonomy-validators.mjs";
-import { localize } from "../lib/ui.mjs";
-
-export async function runGenerateSpecMigrationPlan(args) {
-  const parsed = parseSurfaceValidatorOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-migration-plan refused: ${parsed.error}\n`,
-      `nimicoding generate-spec-migration-plan 已拒绝：${parsed.error}\n`,
-    ));
-    return 2;
-  }
-
-  try {
-    const report = await generateSpecMigrationPlan(process.cwd(), parsed.options);
-    await writeMigrationPlanIfRequested(report, parsed.options.emit, process.cwd());
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    return report.ok ? 0 : 1;
-  } catch (error) {
-    process.stderr.write(localize(
-      `nimicoding generate-spec-migration-plan refused: ${error.message}\n`,
-      `nimicoding generate-spec-migration-plan 已拒绝：${error.message}\n`,
-    ));
-    return 2;
-  }
-}

package/cli/commands/surface-validator-command.mjs

@@ -1,49 +0,0 @@
-import {
-  classifySpecSurface,
-  parseSurfaceValidatorOptions,
-  validateDomainAdmission,
-  validateGuidanceBodies,
-  validatePlacement,
-  validateProjectionEdges,
-  validateTableFamily,
-  validateTrackedOutputAdmission,
-  writeInventoryIfRequested,
-} from "../lib/internal/surface-taxonomy-validators.mjs";
-import { localize } from "../lib/ui.mjs";
-
-const VALIDATORS = {
-  "classify-spec-tree": classifySpecSurface,
-  "validate-placement": validatePlacement,
-  "validate-table-family": validateTableFamily,
-  "validate-projection-edges": validateProjectionEdges,
-  "validate-guidance-bodies": validateGuidanceBodies,
-  "validate-domain-admission": validateDomainAdmission,
-  "validate-tracked-output-admission": validateTrackedOutputAdmission,
-};
-
-export async function runSurfaceValidatorCommand(args, validatorName) {
-  const parsed = parseSurfaceValidatorOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(localize(
-      `nimicoding ${validatorName} refused: ${parsed.error}\n`,
-      `nimicoding ${validatorName} 已拒绝：${parsed.error}\n`,
-    ));
-    return 2;
-  }
-
-  const validator = VALIDATORS[validatorName];
-  if (!validator) {
-    process.stderr.write(localize(
-      `nimicoding ${validatorName} refused: unknown surface validator.\n`,
-      `nimicoding ${validatorName} 已拒绝：未知 surface validator。\n`,
-    ));
-    return 2;
-  }
-
-  const report = await validator(process.cwd(), parsed.options);
-  if (validatorName === "classify-spec-tree") {
-    await writeInventoryIfRequested(report, parsed.options.emit, process.cwd());
-  }
-  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-  return report.ok ? 0 : 1;
-}

package/cli/commands/validate-domain-admission.mjs

@@ -1,5 +0,0 @@
-import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
-
-export function runValidateDomainAdmission(args) {
-  return runSurfaceValidatorCommand(args, "validate-domain-admission");
-}

package/cli/commands/validate-guidance-bodies.mjs

@@ -1,5 +0,0 @@
-import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
-
-export function runValidateGuidanceBodies(args) {
-  return runSurfaceValidatorCommand(args, "validate-guidance-bodies");
-}

package/cli/commands/validate-placement.mjs

@@ -1,5 +0,0 @@
-import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
-
-export function runValidatePlacement(args) {
-  return runSurfaceValidatorCommand(args, "validate-placement");
-}

package/cli/commands/validate-projection-edges.mjs

@@ -1,5 +0,0 @@
-import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
-
-export function runValidateProjectionEdges(args) {
-  return runSurfaceValidatorCommand(args, "validate-projection-edges");
-}

package/cli/commands/validate-spec-audit.mjs

@@ -1,27 +0,0 @@
-import path from "node:path";
-
-import { validateSpecAudit, buildValidatorCliReport } from "../lib/validators.mjs";
-import { localize } from "../lib/ui.mjs";
-
-export async function runValidateSpecAudit(args) {
-  const normalized = args[0] === "--" ? args.slice(1) : args;
-  let targetPath = ".nimi/local/state/spec-generation/spec-generation-audit.yaml";
-
-  if (normalized.length > 1) {
-    process.stderr.write(localize(
-      "nimicoding validate-spec-audit refused: expected zero or one path argument.\n",
-      "nimicoding validate-spec-audit 已拒绝：期望零个或一个路径参数。\n",
-    ));
-    return 2;
-  }
-
-  if (normalized.length === 1) {
-    targetPath = normalized[0];
-  }
-
-  const absolutePath = path.resolve(process.cwd(), targetPath);
-  const report = await validateSpecAudit(absolutePath, { projectRoot: process.cwd() });
-  const cliReport = buildValidatorCliReport("validate-spec-audit", absolutePath, report);
-  process.stdout.write(`${JSON.stringify(cliReport, null, 2)}\n`);
-  return report.ok ? 0 : 1;
-}

package/cli/commands/validate-spec-governance.mjs

@@ -1,144 +0,0 @@
-import path from "node:path";
-
-import { localize } from "../lib/ui.mjs";
-import { buildValidatorCliReport, validateSpecTree } from "../lib/validators.mjs";
-import { loadGovernanceConfig, requireProfile } from "../lib/internal/governance/config.mjs";
-import { runCommand } from "../lib/internal/governance/runner.mjs";
-
-function parseOptions(args) {
-  const options = {
-    profile: null,
-    scope: "all",
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-
-    if (arg === "--profile") {
-      const value = args[index + 1];
-      if (!value || value.startsWith("--")) {
-        return { ok: false, error: "nimicoding validate-spec-governance refused: --profile requires a value.\n" };
-      }
-      options.profile = value;
-      index += 1;
-      continue;
-    }
-
-    if (arg === "--scope") {
-      const value = args[index + 1];
-      if (!value || value.startsWith("--")) {
-        return { ok: false, error: "nimicoding validate-spec-governance refused: --scope requires a value.\n" };
-      }
-      options.scope = value;
-      index += 1;
-      continue;
-    }
-
-    return {
-      ok: false,
-      error: `nimicoding validate-spec-governance refused: unknown option ${arg}.\n`,
-    };
-  }
-
-  return { ok: true, options };
-}
-
-function resolveScopes(scope, governanceConfig) {
-  const configuredScopes = Object.keys(governanceConfig.specGovernance.validateCommands || {});
-  if (scope === "all") {
-    return {
-      ok: true,
-      scopes: configuredScopes,
-      error: null,
-    };
-  }
-  if (!configuredScopes.includes(scope)) {
-    return {
-      ok: false,
-      scopes: [],
-      error: `nimicoding validate-spec-governance refused: unsupported --scope value ${scope}.\n`,
-    };
-  }
-  return {
-    ok: true,
-    scopes: [scope],
-    error: null,
-  };
-}
-
-export async function runValidateSpecGovernance(args) {
-  const parsed = parseOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(localize(parsed.error, parsed.error));
-    return 2;
-  }
-
-  const governance = await loadGovernanceConfig(process.cwd());
-  if (!governance.ok) {
-    process.stderr.write(localize(
-      `nimicoding validate-spec-governance refused: ${governance.reason} at ${governance.path}.\n`,
-      `nimicoding validate-spec-governance 已拒绝：${governance.path} 的治理配置不可用。\n`,
-    ));
-    return 2;
-  }
-
-  const profileCheck = requireProfile(governance.config, parsed.options.profile);
-  if (!profileCheck.ok) {
-    process.stderr.write(localize(
-      `nimicoding validate-spec-governance refused: ${profileCheck.error}.\n`,
-      `nimicoding validate-spec-governance 已拒绝：${profileCheck.error}。\n`,
-    ));
-    return 2;
-  }
-
-  const scopeResolution = resolveScopes(parsed.options.scope, governance.config);
-  if (!scopeResolution.ok) {
-    process.stderr.write(localize(scopeResolution.error, scopeResolution.error));
-    return 2;
-  }
-
-  if (parsed.options.scope === "all") {
-    if (governance.config.specGovernance.canonicalRoot !== ".nimi/spec") {
-      process.stderr.write(localize(
-        "nimicoding validate-spec-governance refused: spec_governance.canonical_root must be .nimi/spec.\n",
-        "nimicoding validate-spec-governance 已拒绝：spec_governance.canonical_root 必须为 .nimi/spec。\n",
-      ));
-      return 2;
-    }
-    const canonicalRoot = path.resolve(process.cwd(), ".nimi/spec");
-    const treeReport = await validateSpecTree(canonicalRoot, { projectRoot: process.cwd() });
-    if (!treeReport.ok) {
-      const cliReport = buildValidatorCliReport("validate-spec-tree", canonicalRoot, treeReport);
-      process.stdout.write(`${JSON.stringify(cliReport, null, 2)}\n`);
-      return 1;
-    }
-  }
-
-  let failed = false;
-  for (const scope of scopeResolution.scopes) {
-    const commands = governance.config.specGovernance.validateCommands[scope] || [];
-    if (commands.length === 0) {
-      process.stderr.write(localize(
-        `nimicoding validate-spec-governance refused: scope ${scope} is not configured in .nimi/config/governance.yaml.\n`,
-        `nimicoding validate-spec-governance 已拒绝：.nimi/config/governance.yaml 未配置 ${scope}。\n`,
-      ));
-      return 2;
-    }
-
-    for (const command of commands) {
-      const result = runCommand(command, { cwd: process.cwd() });
-      if (result.stdout) process.stdout.write(result.stdout);
-      if (result.stderr) process.stderr.write(result.stderr);
-      if (!result.ok) {
-        failed = true;
-        break;
-      }
-    }
-
-    if (failed) {
-      break;
-    }
-  }
-
-  return failed ? 1 : 0;
-}

package/cli/commands/validate-spec-tree.mjs

@@ -1,27 +0,0 @@
-import path from "node:path";
-
-import { buildValidatorCliReport, validateSpecTree } from "../lib/validators.mjs";
-import { localize } from "../lib/ui.mjs";
-
-export async function runValidateSpecTree(args) {
-  const normalized = args[0] === "--" ? args.slice(1) : args;
-  let targetRoot = ".nimi/spec";
-
-  if (normalized.length > 1) {
-    process.stderr.write(localize(
-      "nimicoding validate-spec-tree refused: expected zero or one path argument.\n",
-      "nimicoding validate-spec-tree 已拒绝：期望零个或一个路径参数。\n",
-    ));
-    return 2;
-  }
-
-  if (normalized.length === 1) {
-    targetRoot = normalized[0];
-  }
-
-  const absoluteRoot = path.resolve(process.cwd(), targetRoot);
-  const report = await validateSpecTree(absoluteRoot, { projectRoot: process.cwd() });
-  const cliReport = buildValidatorCliReport("validate-spec-tree", absoluteRoot, report);
-  process.stdout.write(`${JSON.stringify(cliReport, null, 2)}\n`);
-  return report.ok ? 0 : 1;
-}

package/cli/commands/validate-table-family.mjs

@@ -1,5 +0,0 @@
-import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
-
-export function runValidateTableFamily(args) {
-  return runSurfaceValidatorCommand(args, "validate-table-family");
-}

package/cli/commands/validate-tracked-output-admission.mjs

@@ -1,5 +0,0 @@
-import { runSurfaceValidatorCommand } from "./surface-validator-command.mjs";
-
-export function runValidateTrackedOutputAdmission(args) {
-  return runSurfaceValidatorCommand(args, "validate-tracked-output-admission");
-}