@nimiplatform/nimi-coding 0.6.2 → 0.6.4

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.6.4
+
+- Made experimental `code context` declaration ordering independent of the host locale, using UTF-16 code-unit text order followed by numeric source positions.
+
+## 0.6.3
+
+- Removed Claude-specific managed entrypoints and path validation. `start`, `sync`, `doctor`, and `clear` now manage only `AGENTS.md` instruction blocks and leave unrelated host files untouched.
+
 ## 0.6.2
 
 - Made managed authority/code queries depend on task-relevant uncertainty, including static-dependency questions for `code context`, while preserving authority admission and result boundaries.

package/README.md

@@ -69,7 +69,7 @@ The current Nimi-realm validation corpus contains 33 canonical containers, 2,212
 
 ## Using the code surface
 
-`start` writes package-managed guidance into the marked blocks in `AGENTS.md` and `CLAUDE.md`. On an existing installation, `doctor` diagnoses drift in that guidance and the compact methodology projection; `sync --apply` restores the exact current package projections while preserving host-owned text outside the managed blocks. An AI host that honors repository instructions can therefore learn when to request `code authority` or `code context`, and when a changed authority-governed feature warrants a small number of `@nimi-authority` markers at key semantic owners.
+`start` writes package-managed guidance into the marked blocks in `AGENTS.md`. On an existing installation, `doctor` diagnoses drift in that guidance and the compact methodology projection; `sync --apply` restores the exact current package projections while preserving host-owned text outside the managed blocks. An AI host that honors repository instructions can therefore learn when to request `code authority` or `code context`, and when a changed authority-governed feature warrants a small number of `@nimi-authority` markers at key semantic owners.
 
 This is instruction-based integration, not an automatic execution layer. Nimi Coding installs no hook or daemon, intercepts no task, requires no fixed preflight, and owns no task or completion state. The host decides whether a query is useful for the current coding task. `code authority` only recalls explicit markers and current authority lifecycle; `code context` only returns the admitted root-direct TypeScript projection. Neither result proves conformance, replaces affected builds and tests, or evaluates unannotated code.
 
@@ -84,7 +84,7 @@ pnpm add -D @nimiplatform/nimi-coding
 pnpm exec nimicoding start --yes
 ```
 
-`start` creates the compact AI-visible authoring guide, managed instruction blocks in `AGENTS.md` and `CLAUDE.md`, and the ignored `.nimi/local/` root. It does not generate product semantics or create `.nimi/spec` for the project.
+`start` creates the compact AI-visible authoring guide, managed instruction blocks in `AGENTS.md`, and the ignored `.nimi/local/` root. It does not generate product semantics or create `.nimi/spec` for the project.
 
 `pnpm exec nimicoding` is the supported host invocation: run it from the repository root so automation resolves the pinned project-local package. A global `nimicoding` binary in `PATH` is neither required nor a valid availability check.
 

package/README.zh-CN.md

@@ -69,7 +69,7 @@ AI host · 第三方扩展 · CI · future editor/UI surfaces
 
 ## 使用 code surface
 
-`start` 会把 package 管理的指导写入 `AGENTS.md` 和 `CLAUDE.md` 的 marked blocks。对于已有安装，`doctor` 会诊断这些指导及 compact methodology projection 的 drift，`sync --apply` 则恢复当前 package 的精确 projections，同时保留 managed blocks 之外的宿主文本。因此，遵守 repository instructions 的 AI host 可以知道何时按需调用 `code authority` 或 `code context`，以及何时只在发生变更、受 authority 约束的功能中，为少数关键语义 owner 添加 `@nimi-authority` marker。
+`start` 会把 package 管理的指导写入 `AGENTS.md` 的 marked blocks。对于已有安装，`doctor` 会诊断这些指导及 compact methodology projection 的 drift，`sync --apply` 则恢复当前 package 的精确 projections，同时保留 managed blocks 之外的宿主文本。因此，遵守 repository instructions 的 AI host 可以知道何时按需调用 `code authority` 或 `code context`，以及何时只在发生变更、受 authority 约束的功能中，为少数关键语义 owner 添加 `@nimi-authority` marker。
 
 这是一种基于 instruction 的集成，不是自动执行层。Nimi Coding 不安装 hook 或 daemon，不拦截 task，不要求固定 preflight，也不拥有 task 或 completion state。是否需要查询由 host 根据当前 coding task 决定。`code authority` 只召回显式 marker 和当前 authority lifecycle；`code context` 只返回 admitted root-direct TypeScript projection。两者都不证明 conformance，不替代 affected build/tests，也不评价未标注代码。
 
@@ -84,7 +84,7 @@ pnpm add -D @nimiplatform/nimi-coding
 pnpm exec nimicoding start --yes
 ```
 
-`start` 创建紧凑的 AI-visible authoring guide、`AGENTS.md`/`CLAUDE.md` 中的 managed instruction blocks，以及 ignored `.nimi/local/` root。它不会生成产品语义，也不会替项目创建 `.nimi/spec`。
+`start` 创建紧凑的 AI-visible authoring guide、`AGENTS.md` 中的 managed instruction blocks，以及 ignored `.nimi/local/` root。它不会生成产品语义，也不会替项目创建 `.nimi/spec`。
 
 `pnpm exec nimicoding` 是受支持的宿主调用方式：应从仓库根目录执行，使自动化解析到项目锁定的本地 package。既不要求全局 `PATH` 中存在 `nimicoding`，也不能用它判断 CLI 是否可用。
 

package/cli/constants.mjs

@@ -1,4 +1,4 @@
-export const VERSION = "0.6.2";
+export const VERSION = "0.6.4";
 export const PACKAGE_NAME = "@nimiplatform/nimi-coding";
 export const PROJECT_LOCAL_CLI_INVOCATION = "pnpm exec nimicoding";
 export const LOCAL_GITIGNORE_ENTRIES = [".nimi/local/"];
@@ -10,5 +10,3 @@ export const REQUIRED_LOCAL_DIRS = [".nimi/local"];
 
 export const AGENTS_BEGIN = "<!-- nimicoding:managed:agents:start -->";
 export const AGENTS_END = "<!-- nimicoding:managed:agents:end -->";
-export const CLAUDE_BEGIN = "<!-- nimicoding:managed:claude:start -->";
-export const CLAUDE_END = "<!-- nimicoding:managed:claude:end -->";

package/cli/lib/code/context.mjs

@@ -5,6 +5,8 @@ import { createRequire } from "node:module";
 import path from "node:path";
 import { promisify } from "node:util";
 
+import { compareText } from "../authority/diagnostics.mjs";
+
 const execFileAsync = promisify(execFile);
 const TYPESCRIPT_VERSION = "5.9.3";
 
@@ -339,10 +341,10 @@ function portableLocus(compiler, repository, compilerRoot, compilerVersion, node
 }
 
 function compareLoci(left, right) {
-  return left.origin.localeCompare(right.origin)
-    || (left.package?.name ?? "").localeCompare(right.package?.name ?? "")
-    || (left.package?.version ?? "").localeCompare(right.package?.version ?? "")
-    || left.path.localeCompare(right.path)
+  return compareText(left.origin, right.origin)
+    || compareText(left.package?.name ?? "", right.package?.name ?? "")
+    || compareText(left.package?.version ?? "", right.package?.version ?? "")
+    || compareText(left.path, right.path)
     || left.range.start_line - right.range.start_line
     || left.range.start_column - right.range.start_column
     || left.range.end_line - right.range.end_line
@@ -437,7 +439,7 @@ function collectSites(compiler, rootNode) {
   return sites.sort((left, right) => (
     left.node.getStart() - right.node.getStart()
     || left.node.getEnd() - right.node.getEnd()
-    || left.role.localeCompare(right.role)
+    || compareText(left.role, right.role)
   ));
 }
 

package/cli/lib/entrypoints.mjs

@@ -4,8 +4,6 @@ import path from "node:path";
 import {
   AGENTS_BEGIN,
   AGENTS_END,
-  CLAUDE_BEGIN,
-  CLAUDE_END,
   PROJECT_LOCAL_CLI_INVOCATION,
 } from "../constants.mjs";
 import { pathExists, preflightManagedProjectPaths, readUtf8FileFatal } from "./fs-helpers.mjs";
@@ -41,9 +39,6 @@ function authorityAuthoringLines() {
 function managedAgentsBlock() {
   return [AGENTS_BEGIN, "# Nimi Coding Managed Block", "", ...authorityAuthoringLines(), AGENTS_END].join("\n");
 }
-function managedClaudeBlock() {
-  return [CLAUDE_BEGIN, "# Nimi Coding Managed Block", "", ...authorityAuthoringLines(), CLAUDE_END].join("\n");
-}
 
 function occurrenceIndexes(text, marker) {
   const indexes = [];
@@ -101,14 +96,6 @@ function entrypointDefinitions(projectRoot) {
       header: "# AGENTS.md\n",
       relativePath: "AGENTS.md",
     },
-    {
-      path: path.join(projectRoot, "CLAUDE.md"),
-      block: managedClaudeBlock(),
-      begin: CLAUDE_BEGIN,
-      end: CLAUDE_END,
-      header: "# CLAUDE.md\n",
-      relativePath: "CLAUDE.md",
-    },
   ];
 }
 

package/cli/lib/fs-helpers.mjs

@@ -4,11 +4,10 @@ import path from "node:path";
 const SHARED_INODE_FORBIDDEN_PATHS = new Set([
   ".nimi/methodology/authority-authoring.yaml",
   "AGENTS.md",
-  "CLAUDE.md",
   ".gitignore",
   ".gitattributes",
 ]);
-const FATAL_UTF8_HOST_PATHS = new Set(["AGENTS.md", "CLAUDE.md", ".gitignore", ".gitattributes"]);
+const FATAL_UTF8_HOST_PATHS = new Set(["AGENTS.md", ".gitignore", ".gitattributes"]);
 
 const BASE_MANAGED_PATHS = [
   [".nimi", "directory"],
@@ -20,7 +19,6 @@ const BASE_MANAGED_PATHS = [
   [".nimi/contracts", "directory"],
   [".nimi/contracts/domain-admission.schema.yaml", "file"],
   ["AGENTS.md", "file"],
-  ["CLAUDE.md", "file"],
   [".gitignore", "file"],
   [".gitattributes", "file"],
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nimiplatform/nimi-coding",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "private": false,
   "description": "Canonical authority products and bounded read-only code queries for AI coding systems.",
   "license": "MIT",

package/spec/code-context.yaml

@@ -18,6 +18,7 @@ projection:
   scope: selected_root_AST_only
   relations: [static_value_binding, static_type_binding, static_constructor_binding, static_JSX_binding]
   target: complete_nonempty_portable_declaration_set
+  declaration_loci_order: origin_package_name_package_version_path_by_UTF_16_code_units_then_numeric_range
   target_source: optional_single_repository_declaration_syntactic_slice
   runtime_dispatch: not_evaluated
 response:

package/spec/product-scope.yaml

@@ -1,4 +1,4 @@
-version: 12
+version: 13
 product:
   package_name: "@nimiplatform/nimi-coding"
   mission: canonical_authority_products_bounded_read_only_code_context_and_explicit_code_authority_marker_lookup
@@ -22,7 +22,7 @@ canonical_boundary:
 surface_separation:
   public: [documented_CLI, package_documentation]
   canonical_project_owned: .nimi/spec/**/*.authority.{yaml,md}
-  projected_AI_visible_package_owned: [.nimi/methodology/authority-authoring.yaml, AGENTS.md#managed-block, CLAUDE.md#managed-block]
+  projected_AI_visible_package_owned: [.nimi/methodology/authority-authoring.yaml, AGENTS.md#managed-block]
   local_non_authority: .nimi/local/**
   package_internal: [authority_grammar_contracts, AuthorityIR, SourceMap, compiler_implementation]
 out_of_scope: