@descryy/adapter-common 0.3.0 → 0.3.1

package/dist/file-node.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The shared, language-blind `FILE`-node minter.
+ *
+ * `FILE` is one of the fifteen canonical node types and was already real and
+ * populated before this file existed — `packages/core/src/sources/git/
+ * source.ts` in `descry-core` mints one per touched file, for `CHANGES_WITH`
+ * blast-radius edges, via `nodeId(scope, "FILE", fileQsp(path), null)`. No
+ * *adapter* had ever minted one; every adapter's own filesystem-level
+ * fallback used `MODULE` instead (see `adapter-python`'s `degradedGraph`).
+ *
+ * This helper exists so an adapter's degraded-extraction path can assert the
+ * one fact that survives a parse failure — the file exists — using the exact
+ * id computation the git-history producer already uses. Two `FILE` nodes for
+ * the same repo-relative path, one minted here and one minted by git
+ * history, hash to the same id and merge into one node rather than
+ * duplicate. `producedBy` is deliberately excluded from identity (it is not
+ * part of `nodeId`'s hash inputs) for the same reason: two adapters
+ * degrading on the same file must also merge, not fork.
+ *
+ * Filesystem-level only, per the product owner's ruling on
+ * `DEC-NEXT-degraded-graph-shape-for-adapters-without-one` (2026-09-15): a
+ * fallback "may assert filesystem-level facts... and nothing more." No
+ * language is guessed from the extension (DEC-026's reasoning, restated here
+ * for `FILE` the way `source.ts` already states it for its own).
+ */
+import { type IdentityScope, type IRNode } from "@descryy/ir";
+/**
+ * Mint a `FILE` node for one repo-relative path.
+ *
+ * `producedBy` names the caller for provenance only — it plays no part in
+ * the node's identity, so callers must not rely on it to keep two callers'
+ * nodes apart.
+ */
+export declare function fileNode(scope: IdentityScope, repoRelativePath: string, producedBy: string): IRNode;
+//# sourceMappingURL=file-node.d.ts.map

package/dist/file-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-node.d.ts","sourceRoot":"","sources":["../src/file-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAmB,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAenG"}

package/dist/file-node.js

@@ -0,0 +1,50 @@
+/**
+ * The shared, language-blind `FILE`-node minter.
+ *
+ * `FILE` is one of the fifteen canonical node types and was already real and
+ * populated before this file existed — `packages/core/src/sources/git/
+ * source.ts` in `descry-core` mints one per touched file, for `CHANGES_WITH`
+ * blast-radius edges, via `nodeId(scope, "FILE", fileQsp(path), null)`. No
+ * *adapter* had ever minted one; every adapter's own filesystem-level
+ * fallback used `MODULE` instead (see `adapter-python`'s `degradedGraph`).
+ *
+ * This helper exists so an adapter's degraded-extraction path can assert the
+ * one fact that survives a parse failure — the file exists — using the exact
+ * id computation the git-history producer already uses. Two `FILE` nodes for
+ * the same repo-relative path, one minted here and one minted by git
+ * history, hash to the same id and merge into one node rather than
+ * duplicate. `producedBy` is deliberately excluded from identity (it is not
+ * part of `nodeId`'s hash inputs) for the same reason: two adapters
+ * degrading on the same file must also merge, not fork.
+ *
+ * Filesystem-level only, per the product owner's ruling on
+ * `DEC-NEXT-degraded-graph-shape-for-adapters-without-one` (2026-09-15): a
+ * fallback "may assert filesystem-level facts... and nothing more." No
+ * language is guessed from the extension (DEC-026's reasoning, restated here
+ * for `FILE` the way `source.ts` already states it for its own).
+ */
+import { fileQsp, nodeId } from "@descryy/ir";
+/**
+ * Mint a `FILE` node for one repo-relative path.
+ *
+ * `producedBy` names the caller for provenance only — it plays no part in
+ * the node's identity, so callers must not rely on it to keep two callers'
+ * nodes apart.
+ */
+export function fileNode(scope, repoRelativePath, producedBy) {
+    return {
+        id: nodeId(scope, "FILE", fileQsp(repoRelativePath), null),
+        type: "FILE",
+        name: repoRelativePath.split("/").pop() ?? repoRelativePath,
+        file: repoRelativePath,
+        range: null,
+        // Guessing language from the extension would be a language decision made
+        // by a helper with no business making one — the same reasoning
+        // `source.ts` states for its own FILE nodes.
+        language: null,
+        producedBy,
+        resolution: 0,
+        attrs: { parsed: false },
+    };
+}
+//# sourceMappingURL=file-node.js.map

package/dist/file-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-node.js","sourceRoot":"","sources":["../src/file-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAmC,MAAM,aAAa,CAAC;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoB,EAAE,gBAAwB,EAAE,UAAkB;IACzF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC;QAC1D,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,gBAAgB;QAC3D,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,IAAI;QACX,yEAAyE;QACzE,+DAA+D;QAC/D,6CAA6C;QAC7C,QAAQ,EAAE,IAAI;QACd,UAAU;QACV,UAAU,EAAE,CAAC;QACb,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;KACzB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export type { DiscoverOptions } from "./discover.ts";
 export { isolateFile } from "./isolate.ts";
 export type { Isolated, IsolatedFailure } from "./isolate.ts";
 export { extractOrDegrade, describeThrown } from "./degrade.ts";
+export { fileNode } from "./file-node.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvG,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvG,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -9,4 +9,5 @@
 export { discover, globToRegExp, ignoredDirectories, matchesAny, toRepoRelative } from "./discover.js";
 export { isolateFile } from "./isolate.js";
 export { extractOrDegrade, describeThrown } from "./degrade.js";
+export { fileNode } from "./file-node.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvG,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descryy/adapter-common",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "Shared adapter infrastructure: file discovery, glob matching, path normalisation. No language knowledge.",
   "license": "UNLICENSED",
@@ -32,5 +32,7 @@
   "scripts": {
     "build": "tsc -b"
   },
-  "dependencies": {}
+  "dependencies": {
+    "@descryy/ir": "0.10.0"
+  }
 }