@specverse/engines 6.21.0 → 6.21.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -18,11 +18,17 @@ export type BackendName = 'codegraph' | 'gitnexus' | 'grep-only' | 'auto';
18
18
  /**
19
19
  * Select a backend by name, or auto-pick a sensible default.
20
20
  *
21
- * `auto` semantics:
22
- * - CodeGraph + sqlite3 both available → CodeGraph (lighter; richest baseline)
23
- * - Otherwise grep-only (always works, no external tools)
24
- * - Note: GitNexus is NOT auto-selected even when available, because its
25
- * index overhead is significant. Explicit opt-in via name='gitnexus'.
21
+ * `auto` semantics (engines 6.21.x onward):
22
+ * - GitNexus available → GitNexus. Richest, empirically validated
23
+ * across twenty + idle_meta cases. Slightly heavier index step
24
+ * than CodeGraph but produces better cluster quality for behavior
25
+ * extraction (#27 substrate).
26
+ * - CodeGraph + sqlite3 available → CodeGraph as fallback. Recent
27
+ * CodeGraph CLI releases (≥0.7) changed the edges-table schema
28
+ * (`source`/`target` cols replacing `from_id`/`to_id`); our
29
+ * queries don't yet handle the new shape, so it errors loudly on
30
+ * fresh databases. GitNexus is the better default.
31
+ * - Otherwise → grep-only (always works, no external tools).
26
32
  */
27
33
  export declare function selectBackend(name?: BackendName): StructuralPrepass;
28
34
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAoB,GAAG,iBAAiB,CAyB3E"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAoB,GAAG,iBAAiB,CA6B3E"}
@@ -5,11 +5,17 @@ export { GrepOnlyBackend, CodeGraphBackend, GitNexusBackend };
5
5
  /**
6
6
  * Select a backend by name, or auto-pick a sensible default.
7
7
  *
8
- * `auto` semantics:
9
- * - CodeGraph + sqlite3 both available → CodeGraph (lighter; richest baseline)
10
- * - Otherwise grep-only (always works, no external tools)
11
- * - Note: GitNexus is NOT auto-selected even when available, because its
12
- * index overhead is significant. Explicit opt-in via name='gitnexus'.
8
+ * `auto` semantics (engines 6.21.x onward):
9
+ * - GitNexus available → GitNexus. Richest, empirically validated
10
+ * across twenty + idle_meta cases. Slightly heavier index step
11
+ * than CodeGraph but produces better cluster quality for behavior
12
+ * extraction (#27 substrate).
13
+ * - CodeGraph + sqlite3 available → CodeGraph as fallback. Recent
14
+ * CodeGraph CLI releases (≥0.7) changed the edges-table schema
15
+ * (`source`/`target` cols replacing `from_id`/`to_id`); our
16
+ * queries don't yet handle the new shape, so it errors loudly on
17
+ * fresh databases. GitNexus is the better default.
18
+ * - Otherwise → grep-only (always works, no external tools).
13
19
  */
14
20
  export function selectBackend(name = 'auto') {
15
21
  if (name === 'codegraph') {
@@ -27,7 +33,11 @@ export function selectBackend(name = 'auto') {
27
33
  if (name === 'grep-only') {
28
34
  return new GrepOnlyBackend();
29
35
  }
30
- // auto — prefer CodeGraph (lighter, fast); GitNexus stays opt-in.
36
+ // auto — prefer GitNexus (richest + empirically validated); fall back
37
+ // to CodeGraph (with caveat noted in the docstring); fall back to grep.
38
+ if (GitNexusBackend.isAvailable()) {
39
+ return new GitNexusBackend();
40
+ }
31
41
  if (CodeGraphBackend.isAvailable()) {
32
42
  return new CodeGraphBackend();
33
43
  }
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAI9D;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAAoB,MAAM;IACtD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+HAA+H,CAChI,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,kEAAkE;IAClE,IAAI,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;QACnC,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyse-prepass/backends/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAI9D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,OAAoB,MAAM;IACtD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,+HAA+H,CAChI,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,sEAAsE;IACtE,wEAAwE;IACxE,IAAI,eAAe,CAAC,WAAW,EAAE,EAAE,CAAC;QAClC,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,gBAAgB,CAAC,WAAW,EAAE,EAAE,CAAC;QACnC,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@specverse/engines",
3
- "version": "6.21.0",
3
+ "version": "6.21.1",
4
4
  "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry, bundles",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",