@nimiplatform/nimi-coding 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to `@nimiplatform/nimi-coding` are tracked here.
 
 This project follows semantic versioning for published npm releases.
 
+## 0.2.2
+
+- Fixed v2 doctor lifecycle/readiness derivation so host projects using the
+  class-filtered surface model no longer depend on legacy `.nimi/spec/_meta`
+  carriers or `.nimi/spec/bootstrap-state.yaml`.
+- Fixed v2 handoff readiness for `doc_spec_audit` so it can run when the
+  canonical tree is present but the local generation audit still needs repair.
+
 ## 0.2.1
 
 - Added the `gate_registry` table family for product-owned release gate

package/README.md

@@ -314,7 +314,7 @@ repository itself keeps the package-owned source directly under
 
 ```bash
 pnpm install
-pnpm test           # runs the node:test suite (329 tests at 0.2.1)
+pnpm test           # runs the node:test suite (331 tests at 0.2.2)
 pnpm check:pack     # npm pack --dry-run
 pnpm check:ci       # test + pack + CLI help/version smoke
 ```

package/README.zh-CN.md

@@ -256,7 +256,7 @@ Nimi Coding 坐在你已经用的 AI host *底下*。它是让 AI 做完的工
 
 ```bash
 pnpm install
-pnpm test           # 跑 node:test 套件（0.2.1 共 329 用例）
+pnpm test           # 跑 node:test 套件（0.2.2 共 331 用例）
 pnpm check:pack     # npm pack --dry-run
 pnpm check:ci       # test + pack + CLI help/version smoke
 ```

package/cli/constants.mjs

@@ -1,4 +1,4 @@
-export const VERSION = "0.2.1";
+export const VERSION = "0.2.2";
 export const PACKAGE_NAME = "@nimiplatform/nimi-coding";
 export const BOOTSTRAP_CONTRACT_ID = "nimicoding.bootstrap";
 export const BOOTSTRAP_CONTRACT_VERSION = 1;

package/cli/lib/handoff.mjs

@@ -72,13 +72,16 @@ function commandRuleAllowsCurrentState(rule, doctorResult) {
   };
 }
 function evaluateSkillReadiness(skillId, doctorResult) {
-  if (!doctorResult.ok || !doctorResult.handoffReadiness.ok) {
+  const usesV2SurfaceModel = doctorResult.specGenerationInputs?.mode === "class_filtered";
+  const canBypassV2GlobalHandoffGate = usesV2SurfaceModel
+    && ["spec_reconstruction", "doc_spec_audit"].includes(skillId);
+
+  if (!doctorResult.ok || (!doctorResult.handoffReadiness.ok && !canBypassV2GlobalHandoffGate)) {
     return {
       ok: false,
       reason: "Bootstrap or handoff validation is failing; repair doctor errors before exporting handoff payloads",
     };
   }
-  const usesV2SurfaceModel = doctorResult.specGenerationInputs?.mode === "class_filtered";
   if (usesV2SurfaceModel && (doctorResult.commandGating?.entries ?? []).length === 0) {
     if (skillId === "spec_reconstruction") {
       return {
@@ -86,6 +89,12 @@ function evaluateSkillReadiness(skillId, doctorResult) {
         reason: "Projects may delegate spec reconstruction to an external AI host when canonical tree work is needed",
       };
     }
+    if (skillId === "doc_spec_audit" && doctorResult.canonicalTree?.requiredFilesValid === true) {
+      return {
+        ok: true,
+        reason: "Skill prerequisites are satisfied by the current project-local truth",
+      };
+    }
     if (doctorResult.canonicalTree?.requiredFilesValid === true && doctorResult.specGenerationAudit?.ok === true) {
       return {
         ok: true,
@@ -338,7 +347,7 @@ export async function buildHandoffPayload(projectRoot, skillId) {
     },
     runtimeOwner: doctorResult.delegatedContracts.runtimeOwner,
     triggerMode: doctorResult.delegatedContracts.triggerMode,
-    handoffReady: doctorResult.handoffReadiness.ok,
+    handoffReady: readiness.ok,
     skill: {
       id: skillId,
       required: expectedSkill.required === "true",

package/cli/lib/internal/doctor-finalize.mjs

@@ -37,6 +37,24 @@ import {
 
 const PACKAGE_REPO_ROOT = fileURLToPath(new URL("../../..", import.meta.url));
 
+function deriveV2LifecycleState(bootstrapSurface) {
+  const treeReady = bootstrapSurface.canonicalTree.requiredFilesValid === true;
+  const benchmarkMode = bootstrapSurface.specGenerationInputs?.benchmarkMode
+    ?? bootstrapSurface.blueprintReference?.mode
+    ?? "none";
+
+  return {
+    mode: "class_filtered",
+    treeState: treeReady ? "canonical_tree_ready" : "canonical_tree_in_progress",
+    authorityMode: "surface_class_validated",
+    blueprintMode: benchmarkMode,
+    reconstructionRequired: !treeReady,
+    readyForAiReconstruction: !treeReady,
+    cutoverReadiness: {},
+    activeAuthorityRoot: bootstrapSurface.specGenerationInputs?.canonicalTargetRoot ?? ".nimi/spec",
+  };
+}
+
 export async function finalizeDoctorState(projectRoot, bootstrapSurface, delegatedSurface) {
   const checks = [...bootstrapSurface.checks, ...delegatedSurface.checks];
   const usesV2SurfaceModel = bootstrapSurface.specGenerationInputs?.mode === "class_filtered";
@@ -264,7 +282,19 @@ export async function finalizeDoctorState(projectRoot, bootstrapSurface, delegat
   }
 
   const hasErrors = checks.some((check) => check.severity === "error");
-  const reconstructionRequired = bootstrapSurface.bootstrapStateContract.reconstructionRequired === true;
+  const lifecycleState = usesV2SurfaceModel
+    ? deriveV2LifecycleState(bootstrapSurface)
+    : {
+      mode: bootstrapSurface.bootstrapStateContract.mode,
+      treeState: bootstrapSurface.bootstrapStateContract.treeState,
+      authorityMode: bootstrapSurface.bootstrapStateContract.authorityMode,
+      blueprintMode: bootstrapSurface.bootstrapStateContract.blueprintMode,
+      reconstructionRequired: bootstrapSurface.bootstrapStateContract.reconstructionRequired,
+      readyForAiReconstruction: bootstrapSurface.bootstrapStateContract.readyForAiReconstruction,
+      cutoverReadiness: bootstrapSurface.bootstrapStateContract.cutoverReadiness,
+      activeAuthorityRoot: bootstrapSurface.bootstrapStateContract.activeAuthorityRoot,
+    };
+  const reconstructionRequired = lifecycleState.reconstructionRequired === true;
 
   const handoffReadiness = {
     ok: delegatedSurface.handoffContextOk
@@ -355,16 +385,7 @@ export async function finalizeDoctorState(projectRoot, bootstrapSurface, delegat
       id: bootstrapSurface.bootstrapCompatibility.contractId,
       version: bootstrapSurface.bootstrapCompatibility.contractVersion,
     },
-    lifecycleState: {
-      mode: bootstrapSurface.bootstrapStateContract.mode,
-      treeState: bootstrapSurface.bootstrapStateContract.treeState,
-      authorityMode: bootstrapSurface.bootstrapStateContract.authorityMode,
-      blueprintMode: bootstrapSurface.bootstrapStateContract.blueprintMode,
-      reconstructionRequired: bootstrapSurface.bootstrapStateContract.reconstructionRequired,
-      readyForAiReconstruction: bootstrapSurface.bootstrapStateContract.readyForAiReconstruction,
-      cutoverReadiness: bootstrapSurface.bootstrapStateContract.cutoverReadiness,
-      activeAuthorityRoot: bootstrapSurface.bootstrapStateContract.activeAuthorityRoot,
-    },
+    lifecycleState,
     specTreeModel: bootstrapSurface.specTreeModel,
     specGenerationInputs: bootstrapSurface.specGenerationInputs,
     canonicalTree: bootstrapSurface.canonicalTree,

package/cli/lib/internal/doctor-format.mjs

@@ -64,7 +64,7 @@ const DOCTOR_NEXT_STEP_TRANSLATIONS = new Map([
   ["Repair the failing bootstrap checks, then rerun `nimicoding doctor`.", "修复失败的 bootstrap 检查项，然后重新运行 `nimicoding doctor`。"],
   ["Use an external AI host to reconstruct the declared canonical tree under `.nimi/spec`.", "使用外部 AI host 重建声明的 `.nimi/spec` canonical tree。"],
   ["Run `nimicoding blueprint-audit --write-local` after canonical tree generation when a benchmark blueprint is declared.", "当声明了 benchmark blueprint 且 canonical tree 生成完成后，运行 `nimicoding blueprint-audit --write-local`。"],
-  ["Run `nimicoding validate-spec-audit` after generating `.nimi/spec/_meta/spec-generation-audit.yaml` for the canonical tree.", "在为 canonical tree 生成 `.nimi/spec/_meta/spec-generation-audit.yaml` 后，运行 `nimicoding validate-spec-audit`。"],
+  ["Run `nimicoding validate-spec-audit` after generating the local spec generation audit for the canonical tree.", "为 canonical tree 生成本地 spec generation audit 后，运行 `nimicoding validate-spec-audit`。"],
   ["Run `nimicoding handoff --skill doc_spec_audit` and close out the result locally when the audit is complete.", "运行 `nimicoding handoff --skill doc_spec_audit`，并在审计完成后于本地 closeout 结果。"],
   ["Keep runtime ownership delegated; do not assume local skill installation or self-hosting.", "保持 runtime ownership 为 delegated；不要假设本地 skill 安装或 self-hosting。"],
   ["If you want a constrained external execution host, select one in `.nimi/config/host-adapter.yaml`.", "如果你希望使用受约束的外部执行 host，请在 `.nimi/config/host-adapter.yaml` 中选择一个。"],
@@ -86,6 +86,7 @@ function summarizeDoctorState(result) {
   const blockingChecks = result.checks.filter((check) => check.severity === "error");
   const warningChecks = result.checks.filter((check) => check.severity === "warn");
   const importantInfoChecks = result.checks.filter((check) => check.severity === "info").slice(0, 2);
+  const usesV2SurfaceModel = result.specGenerationInputs?.mode === "class_filtered";
 
   const bootstrapState = !result.bootstrapPresent
     ? localize("missing", "缺失")
@@ -93,7 +94,7 @@ function summarizeDoctorState(result) {
       ? localize("ready", "就绪")
       : localize("needs attention", "需要关注");
 
-  const canonicalTreeState = !result.specTreeModel?.ok
+  const canonicalTreeState = !usesV2SurfaceModel && !result.specTreeModel?.ok
     ? localize("invalid", "无效")
     : !result.canonicalTree.requiredFilesValid
       ? localize("incomplete", "未完成")

package/config/bootstrap.yaml

@@ -1,6 +1,6 @@
 version: 1
 initialized_by: "@nimiplatform/nimi-coding"
-cli_version: "0.2.1"
+cli_version: "0.2.2"
 bootstrap_contract: "nimicoding.bootstrap"
 bootstrap_contract_version: 1
 profile: default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimiplatform/nimi-coding",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "private": false,
   "description": "AI-native coding governance toolkit for bootstrapping .nimi/** into arbitrary projects.",
   "license": "MIT",
@@ -22,7 +22,7 @@
     "provenance": true
   },
   "bin": {
-    "nimicoding": "./bin/nimicoding.mjs"
+    "nimicoding": "bin/nimicoding.mjs"
   },
   "packageManager": "pnpm@10.32.1",
   "engines": {