@githolon/dsl 0.102.4 → 0.103.0

package/src/compat_manifest.ts

@@ -9,11 +9,11 @@
 export interface NomosCompat {
   /** The package name (`cfg.name`). */
   readonly packageName: string;
-  /** The deploy domainHash — sha256 of the package bytes (`policy:{hash}`). */
+  /** The deploy domainHash — the composed typed USDA closure identity. */
   readonly lawHash: string;
   /** sha256 over the CANONICAL serialization of the package structural interface. */
   readonly interfaceHash: string;
-  /** Per domain key → its admission-identity hash (absent for identity-excluded domains). */
+  /** Per domain key → its canonical typed USDA layer identity. */
   readonly domains: Record<string, { readonly identityHash?: string }>;
   /** The generator provenance — the `@githolon/dsl` version + this manifest's schema. */
   readonly generator: { readonly dsl: string; readonly schema: number };

package/src/compat_package_main.ts

@@ -9,8 +9,7 @@
  * REQUIREMENT) against a TARGET's installed law (the workspace OFFER), PER MEMBER, via the #72
  * subtype relation (`memberVerdicts`). Exits NON-ZERO on any incompatible member — so a client/law
  * mismatch is caught in CI, before it ships. The target is:
- *   • a deploy.json (`build/<name>.deploy.json`) — its staged `.interface` is the offer;
- *   • an `.interface.json` (or a build/package DIR containing one) — the offer directly;
+ *   • an `.interface.json` (or a build/package DIR containing one) — the diagnostic offer directly;
  *   • a LIVE workspace URL (`https://host/v2/workspaces/<ws>` or `https://host --workspace <ws>`) —
  *     connect()s and reads the on-ledger offer (`holon.interfaceOffer()`).
  *
@@ -42,7 +41,7 @@ function mergeInterfaces(byDomain: InterfaceMap | undefined): DomainInterface {
   return out;
 }
 
-/** The package name from `nomos.package.mjs` (only field we need — to locate `build/<name>.interface.json`). */
+/** The package name from `nomos.project.ts` (only field we need — to locate `build/<name>.interface.json`). */
 async function loadPackageName(configArg: string): Promise<{ name: string; dir: string }> {
   const configPath = path.resolve(process.cwd(), configArg);
   if (!existsSync(configPath)) fail(`config not found: ${configPath} (pass the package config, or run from the package dir)`);
@@ -67,7 +66,7 @@ function loadCurrentInterface(pkgDir: string, name: string): InterfaceMap {
   }
 }
 
-/** Read a TARGET offer from a file path (deploy.json / interface.json / dir). Returns `{ offer, source }`. */
+/** Read a TARGET diagnostic offer from an interface.json / directory. */
 function loadFileOffer(arg: string): { offer: InterfaceMap; source: string } {
   const abs = path.resolve(process.cwd(), arg);
   if (!existsSync(abs)) fail(`target not found: ${abs}`);
@@ -75,12 +74,11 @@ function loadFileOffer(arg: string): { offer: InterfaceMap; source: string } {
   if (statSync(abs).isDirectory()) {
     const scan = (d: string): string | undefined => {
       if (!existsSync(d)) return undefined;
-      const hit =
-        readdirSync(d).find((f) => f.endsWith(".deploy.json")) ?? readdirSync(d).find((f) => f.endsWith(".interface.json"));
+      const hit = readdirSync(d).find((f) => f.endsWith(".interface.json"));
       return hit !== undefined ? path.join(d, hit) : undefined;
     };
     const found = scan(abs) ?? scan(path.join(abs, "build"));
-    if (found === undefined) fail(`no *.deploy.json or *.interface.json under ${abs}`);
+    if (found === undefined) fail(`no *.interface.json under ${abs}`);
     file = found;
   }
   let parsed: unknown;
@@ -89,9 +87,7 @@ function loadFileOffer(arg: string): { offer: InterfaceMap; source: string } {
   } catch (e) {
     fail(`could not parse ${file}: ${(e as Error).message}`);
   }
-  const p = parsed as Record<string, unknown>;
-  // A deploy.json carries `{ …, interface }`; a bare interface.json IS the {[domain]: interface} map.
-  const offer = (p.interface !== undefined ? p.interface : p) as InterfaceMap;
+  const offer = parsed as InterfaceMap;
   if (offer === null || typeof offer !== "object") fail(`target ${file} carries no structural interface`);
   return { offer, source: file };
 }
@@ -153,13 +149,13 @@ async function main(): Promise<void> {
     return inline?.slice(name.length + 1);
   };
   const asJson = argv.includes("--json");
-  const configArg = flagVal("--config") ?? "nomos.package.mjs";
+  const configArg = flagVal("--config") ?? "nomos.project.ts";
   const workspaceFlag = flagVal("--workspace");
   const domainFlag = flagVal("--domain");
   // The positional target = the first non-flag arg that isn't a flag VALUE.
   const flagsWithVals = new Set(["--config", "--workspace", "--domain"]);
   const target = argv.find((a, i) => !a.startsWith("--") && !(i > 0 && flagsWithVals.has(argv[i - 1]!)));
-  if (!target) fail(`usage: githolon compat <workspace-url | deploy.json | interface.json | dir> [--config <cfg>] [--workspace <ws>] [--domain <name,...>] [--json]`);
+  if (!target) fail(`usage: githolon compat <workspace-url | interface.json | dir> [--config <cfg>] [--workspace <ws>] [--domain <name,...>] [--json]`);
 
   const { name, dir } = await loadPackageName(configArg);
   const allCurrent = loadCurrentInterface(dir, name);