@lowgular/code-graph 0.0.1 → 0.1.1

package/{libs/cli/cypher/src → cypher}/lib/validator/supported-features.config.js

@@ -1,30 +1,3 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var supported_features_config_exports = {};
-__export(supported_features_config_exports, {
-  ERROR_HANDLING_ITEMS: () => ERROR_HANDLING_ITEMS,
-  NODE_CONSTRAINTS: () => NODE_CONSTRAINTS,
-  PATTERN_CONSTRAINTS: () => PATTERN_CONSTRAINTS,
-  QUERY_CONSTRAINTS: () => QUERY_CONSTRAINTS,
-  RELATIONSHIP_CONSTRAINTS: () => RELATIONSHIP_CONSTRAINTS,
-  RESULT_FORMAT_ITEMS: () => RESULT_FORMAT_ITEMS
-});
-module.exports = __toCommonJS(supported_features_config_exports);
 const NODE_CONSTRAINTS = [
   {
     description: "Nodes can have multiple labels (:A:B means must have A AND B and :A|B means must have A OR B)"
@@ -100,12 +73,11 @@ const ERROR_HANDLING_ITEMS = [
     description: "Using FORBIDDEN features will cause errors"
   }
 ];
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+export {
   ERROR_HANDLING_ITEMS,
   NODE_CONSTRAINTS,
   PATTERN_CONSTRAINTS,
   QUERY_CONSTRAINTS,
   RELATIONSHIP_CONSTRAINTS,
   RESULT_FORMAT_ITEMS
-});
+};

package/{libs/cli/cypher/src → cypher}/lib/validator/unsupported-features.config.js

@@ -1,29 +1,3 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var unsupported_features_config_exports = {};
-__export(unsupported_features_config_exports, {
-  FORBIDDEN_AGGREGATIONS: () => FORBIDDEN_AGGREGATIONS,
-  FORBIDDEN_FEATURES: () => FORBIDDEN_FEATURES,
-  FORBIDDEN_KEYWORDS: () => FORBIDDEN_KEYWORDS,
-  FORBIDDEN_MODIFIERS: () => FORBIDDEN_MODIFIERS,
-  FORBIDDEN_PATTERNS: () => FORBIDDEN_PATTERNS
-});
-module.exports = __toCommonJS(unsupported_features_config_exports);
 const FORBIDDEN_KEYWORDS = [
   {
     pattern: /\bWITH\b/i,
@@ -55,12 +29,13 @@ const FORBIDDEN_KEYWORDS = [
     pattern: /\bDELETE\b/i,
     name: "DELETE clause",
     errorMessage: "DELETE clause is not supported. This is a read-only query engine (no mutations)."
-  },
-  {
-    pattern: /\bSET\b/i,
-    name: "SET clause",
-    errorMessage: "SET clause is not supported. This is a read-only query engine (no mutations)."
   }
+  // {
+  //   pattern: /\bSET\b/i,
+  //   name: 'SET clause',
+  //   errorMessage:
+  //     'SET clause is not supported. This is a read-only query engine (no mutations).',
+  // },
 ];
 const FORBIDDEN_AGGREGATIONS = [
   {
@@ -140,11 +115,10 @@ const FORBIDDEN_FEATURES = [
     description: "Nested queries not supported"
   }
 ];
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+export {
   FORBIDDEN_AGGREGATIONS,
   FORBIDDEN_FEATURES,
   FORBIDDEN_KEYWORDS,
   FORBIDDEN_MODIFIERS,
   FORBIDDEN_PATTERNS
-});
+};

package/cypher-cli.js

@@ -0,0 +1,41 @@
+const command = "cypher";
+const describe = "Print supported Cypher syntax and constraints (MATCH, WHERE, RETURN, etc.).";
+const builder = (yargs) => yargs;
+function handler() {
+  console.log(CYPHER_REFERENCE);
+}
+const CYPHER_REFERENCE = `# Cypher reference (code-graph dialect)
+
+Unsupported features (e.g. CREATE, MERGE, path ranges like *1..3) will error \u2014 see validator if needed.
+
+MATCH, WHERE, RETURN, ORDER BY, LIMIT, OPTIONAL MATCH, and variable-length paths are supported.
+
+## MATCH
+  (n:Label), (n:Label { prop: 'value' }), (a)-[:REL]->(b), (a)<-[:REL]-(b)
+  Variable-length: (a)-[*]->(b)
+  Multiple labels: (n:A:B) AND, (n:A|B) OR. Multiple rel types: [:R1|R2]
+  OPTIONAL MATCH for left outer joins.
+
+## WHERE
+  =, !=, >, <, >=, <=
+  IN [...], NOT IN [...]
+  IS NULL, IS NOT NULL
+  STARTS WITH, ENDS WITH, CONTAINS, =~ 'regex'
+  Same logic for whole clause: all AND or all OR (no mixing).
+
+## RETURN
+  RETURN n, m  |  RETURN *  |  RETURN n AS alias
+  RETURN DISTINCT n  |  RETURN n LIMIT 10
+
+## ORDER BY
+  ORDER BY n.name ASC | DESC, multiple fields supported.
+
+## Constraints
+  RETURN required. Node properties flat, primitives only. Edges: source, target, type (no edge properties). Variable-length only * (no *1..3 etc).
+`;
+export {
+  builder,
+  command,
+  describe,
+  handler
+};

package/infra/code-graph.js

@@ -0,0 +1,147 @@
+import {
+  buildCodeGraph,
+  buildConfigFromQuery
+} from "../code-graph-v2/index.js";
+import {
+  createProgramFromFileSystem,
+  createProgramFromTsConfig
+} from "../codegular/index.js";
+import { buildQueryObject, query } from "../cypher/index.js";
+const matchFromGeneratedFiles = (cypherQuery, config, generatedFiles) => {
+  const fileSystem = generatedFiles.reduce((acc, file) => {
+    if (file.filePath.endsWith(".ts")) {
+      acc[file.filePath] = file.code;
+    }
+    return acc;
+  }, {});
+  return matchFromFileSystem(cypherQuery, config, fileSystem);
+};
+const matchFromFileSystem = (cypherQuery, config, fileSystem) => {
+  const program = createProgramFromFileSystem(fileSystem);
+  const codeGraph = buildCodeGraph(program, config);
+  const results = query(cypherQuery, codeGraph);
+  return results;
+};
+const mapGeneratedFilesToFileSystem = (generatedFiles) => {
+  return generatedFiles.reduce(
+    (acc, file) => {
+      acc[file.filePath] = file.code;
+      return acc;
+    },
+    {}
+  );
+};
+const resolveProgramFromConfig = (env) => {
+  return env.tsConfig ? createProgramFromTsConfig(env.tsConfig) : createProgramFromFileSystem(
+    mapGeneratedFilesToFileSystem(env.generatedFiles)
+  );
+};
+const autoMatch = (cypherQuery, program, options) => {
+  const queryObject = buildQueryObject(cypherQuery);
+  const config = buildConfigFromQuery(queryObject);
+  const codeGraph = buildCodeGraph(program, config);
+  const results = query(cypherQuery, codeGraph);
+  return options?.skipRewrite ? results : rewriteOccurenceOf(results);
+};
+const PATH_ANCHOR_SRC_APP = "src/app";
+const rewriteUntilPath = (pathOrNodeId, pathAnchor) => {
+  const searchSegment = pathAnchor.startsWith("/") && pathAnchor.endsWith("/") ? pathAnchor : `/${pathAnchor.replace(/^\/|\/$/g, "")}/`;
+  const idx = pathOrNodeId.lastIndexOf(searchSegment);
+  if (idx < 0)
+    return pathOrNodeId;
+  const sliced = pathOrNodeId.slice(idx);
+  return sliced.startsWith("/") ? sliced.slice(1) : sliced;
+};
+const rewriteOccurenceOf = (result) => {
+  return result.map((result2) => {
+    return Object.keys(result2).reduce((acc, key) => {
+      if (!result2[key]) {
+        return acc;
+      }
+      const id = result2[key]["id"];
+      if (!id) {
+        return acc;
+      }
+      return {
+        ...acc,
+        [key]: {
+          ...result2[key],
+          id: rewriteUntilPath(id, PATH_ANCHOR_SRC_APP)
+        }
+      };
+    }, {});
+  });
+};
+const filterResultsByGeneratedFiles = (results, generatedFiles) => {
+  const filePaths = generatedFiles.map((file) => file.filePath);
+  return results.filter(
+    (result) => Object.values(result).find(
+      (n) => filePaths.includes(n["id"].split(".")[0] + ".ts")
+    )
+  );
+};
+const autoMatchFromGeneratedFiles = (cypherQuery, generatedFiles) => {
+  const queryObject = buildQueryObject(cypherQuery);
+  const config = buildConfigFromQuery(queryObject);
+  return matchFromGeneratedFiles(cypherQuery, config, generatedFiles);
+};
+const NODE_PROPERTIES_PRESET = {
+  NAMEABLE: {
+    name: `helpers.getDescendantsBy(args.current, (node) => node.kind === args.ts.SyntaxKind.Identifier)[0]?.getText();`,
+    filePath: "args.sourceFile.fileName;"
+  },
+  /**
+   * Creates a preset that extracts a property value from an ObjectLiteralExpression
+   * @param key - The property name to look for in the object literal
+   * @returns An extractor code string that finds the property and returns its initializer text
+   *
+   * @example
+   * ```typescript
+   * properties: {
+   *   selector: NODE_PROPERTIES_PRESET.OBJECT_PROPERTY('selector'),
+   *   template: NODE_PROPERTIES_PRESET.OBJECT_PROPERTY('template'),
+   * }
+   * ```
+   */
+  OBJECT_LITERAL_PROPERTY: (key, valueFns = []) => {
+    return `(function() {
+      const objectLiterals = helpers.getDescendantsBy(
+        args.current, 
+        (node) => node.kind === args.ts.SyntaxKind.ObjectLiteralExpression
+      );
+      
+      for (const objLiteral of objectLiterals) {
+        if (args.ts.isObjectLiteralExpression(objLiteral)) {
+          for (const property of objLiteral.properties) {
+            if (args.ts.isPropertyAssignment(property)) {
+              const propName = property.name;
+              let propNameText = '';
+              
+              if (args.ts.isIdentifier(propName)) {
+                propNameText = propName.text;
+              } else if (args.ts.isStringLiteral(propName)) {
+                propNameText = propName.text;
+              }
+              
+              if (propNameText === '${key}') {
+                const value = property.initializer?.getText() || null;
+                return [${valueFns.join(", ")}].reduce((acc, valueFn) => valueFn(acc), value);
+              }
+            }
+          }
+        }
+      }
+      return null;
+    })();`;
+  }
+};
+export {
+  NODE_PROPERTIES_PRESET,
+  autoMatch,
+  autoMatchFromGeneratedFiles,
+  filterResultsByGeneratedFiles,
+  matchFromFileSystem,
+  matchFromGeneratedFiles,
+  resolveProgramFromConfig,
+  rewriteUntilPath
+};

package/main.js

@@ -1,43 +0,0 @@
-const Module = require("module");
-const path = require("path");
-const fs = require("fs");
-const originalResolveFilename = Module._resolveFilename;
-const distPath = __dirname;
-const manifest = [{ "module": "@features/practice-solutions/api", "exactMatch": "libs/features/practice-solutions/api/src/index.js", "pattern": "libs/features/practice-solutions/api/src/index.ts" }, { "module": "@core/code-snapshot/api", "exactMatch": "libs/core/code-snapshot/api/src/index.js", "pattern": "libs/core/code-snapshot/api/src/index.ts" }, { "module": "@platform/challenge/solution", "exactMatch": "libs/platform/challenge/solution/src/index.js", "pattern": "libs/platform/challenge/solution/src/index.ts" }, { "module": "@core/story-points/api", "exactMatch": "libs/core/story-points/api/src/index.js", "pattern": "libs/core/story-points/api/src/index.ts" }, { "module": "@core/story-points/platform", "exactMatch": "libs/core/story-points/platform/src/index.js", "pattern": "libs/core/story-points/platform/src/index.ts" }, { "module": "@shared/http-utils/api", "exactMatch": "libs/shared/http-utils/api/src/index.js", "pattern": "libs/shared/http-utils/api/src/index.ts" }, { "module": "@academy/features/articles", "exactMatch": "libs/features/articles/academy/src/index.js", "pattern": "libs/features/articles/academy/src/index.ts" }, { "module": "@academy/features/code-snapshot-review", "exactMatch": "libs/features/code-snapshot-review/academy/src/index.js", "pattern": "libs/features/code-snapshot-review/academy/src/index.ts" }, { "module": "@academy/features/code-solutions", "exactMatch": "libs/features/code-solutions/academy/src/index.js", "pattern": "libs/features/code-solutions/academy/src/index.ts" }, { "module": "@academy/features/content", "exactMatch": "libs/features/content/academy/src/index.js", "pattern": "libs/features/content/academy/src/index.ts" }, { "module": "@academy/features/ide", "exactMatch": "libs/features/ide/academy/src/index.js", "pattern": "libs/features/ide/academy/src/index.ts" }, { "module": "@academy/features/modules", "exactMatch": "libs/features/modules/academy/src/index.js", "pattern": "libs/features/modules/academy/src/index.ts" }, { "module": "@academy/features/patterns", "exactMatch": "libs/features/patterns/academy/src/index.js", "pattern": "libs/features/patterns/academy/src/index.ts" }, { "module": "@academy/features/practices", "exactMatch": "libs/features/practices/academy/src/index.js", "pattern": "libs/features/practices/academy/src/index.ts" }, { "module": "@academy/features/projects", "exactMatch": "libs/features/projects/academy/src/index.js", "pattern": "libs/features/projects/academy/src/index.ts" }, { "module": "@academy/features/sequences", "exactMatch": "libs/features/sequences/academy/src/index.js", "pattern": "libs/features/sequences/academy/src/index.ts" }, { "module": "@core/app-events/api", "exactMatch": "libs/core/app-events/api/src/index.js", "pattern": "libs/core/app-events/api/src/index.ts" }, { "module": "@platform/report/build", "exactMatch": "libs/platform/report/build/src/index.js", "pattern": "libs/platform/report/build/src/index.ts" }, { "module": "@platform/report/code", "exactMatch": "libs/platform/report/code/src/index.js", "pattern": "libs/platform/report/code/src/index.ts" }, { "module": "@platform/report/feature", "exactMatch": "libs/platform/report/feature/src/index.js", "pattern": "libs/platform/report/feature/src/index.ts" }, { "module": "@platform/report/lint", "exactMatch": "libs/platform/report/lint/src/index.js", "pattern": "libs/platform/report/lint/src/index.ts" }, { "module": "@platform/report/ui", "exactMatch": "libs/platform/report/ui/src/index.js", "pattern": "libs/platform/report/ui/src/index.ts" }, { "module": "@platform/review/ui", "exactMatch": "libs/platform/review/ui/src/index.js", "pattern": "libs/platform/review/ui/src/index.ts" }, { "module": "@platform/shared/layouts", "exactMatch": "libs/platform/shared/layouts/src/index.js", "pattern": "libs/platform/shared/layouts/src/index.ts" }, { "module": "@platform/shared/modals", "exactMatch": "libs/platform/shared/modals/src/index.js", "pattern": "libs/platform/shared/modals/src/index.ts" }, { "module": "@platform/shared/polling", "exactMatch": "libs/platform/shared/polling/src/index.js", "pattern": "libs/platform/shared/polling/src/index.ts" }, { "module": "@platform/shared/progress", "exactMatch": "libs/platform/shared/progress/src/index.js", "pattern": "libs/platform/shared/progress/src/index.ts" }, { "module": "@platform/shared/tables", "exactMatch": "libs/platform/shared/tables/src/index.js", "pattern": "libs/platform/shared/tables/src/index.ts" }, { "module": "@platform/shared/text", "exactMatch": "libs/platform/shared/text/src/index.js", "pattern": "libs/platform/shared/text/src/index.ts" }, { "module": "@platform/shared/utils", "exactMatch": "libs/platform/shared/utils/index.js", "pattern": "libs/platform/shared/utils/index.ts" }, { "module": "@shared/features/benchmark", "exactMatch": "libs/features/benchmark/shared/src/index.js", "pattern": "libs/features/benchmark/shared/src/index.ts" }, { "module": "@shared/features/code-snapshot-review", "exactMatch": "libs/features/code-snapshot-review/shared/src/index.js", "pattern": "libs/features/code-snapshot-review/shared/src/index.ts" }, { "module": "@shared/features/code-solutions", "exactMatch": "libs/features/code-solutions/shared/src/index.js", "pattern": "libs/features/code-solutions/shared/src/index.ts" }, { "module": "@shared/features/content", "exactMatch": "libs/features/content/shared/src/index.js", "pattern": "libs/features/content/shared/src/index.ts" }, { "module": "@shared/features/llm", "exactMatch": "libs/features/llm/shared/src/index.js", "pattern": "libs/features/llm/shared/src/index.ts" }, { "module": "@shared/features/modules", "exactMatch": "libs/features/modules/shared/src/index.js", "pattern": "libs/features/modules/shared/src/index.ts" }, { "module": "@shared/features/patterns", "exactMatch": "libs/features/patterns/shared/src/index.js", "pattern": "libs/features/patterns/shared/src/index.ts" }, { "module": "@shared/features/projects", "exactMatch": "libs/features/projects/shared/src/index.js", "pattern": "libs/features/projects/shared/src/index.ts" }, { "module": "@shared/features/sequences", "exactMatch": "libs/features/sequences/shared/src/index.js", "pattern": "libs/features/sequences/shared/src/index.ts" }, { "module": "@shared/firebase/api", "exactMatch": "libs/shared/firebase/api/src/index.js", "pattern": "libs/shared/firebase/api/src/index.ts" }, { "module": "@feature-shared/challenges", "exactMatch": "libs/features/challenges/shared/src/index.js", "pattern": "libs/features/challenges/shared/src/index.ts" }, { "module": "@platform/core/code-snapshot", "exactMatch": "libs/core/code-snapshot/platform/src/index.js", "pattern": "libs/core/code-snapshot/platform/src/index.ts" }, { "module": "@platform/core/feature-flags", "exactMatch": "libs/platform/core/feature-flags/src/index.js", "pattern": "libs/platform/core/feature-flags/src/index.ts" }, { "module": "@academy/core/feature-flags", "exactMatch": "libs/academy/core/feature-flags/src/index.js", "pattern": "libs/academy/core/feature-flags/src/index.ts" }, { "module": "@api/features/articles", "exactMatch": "libs/features/articles/api/src/index.js", "pattern": "libs/features/articles/api/src/index.ts" }, { "module": "@api/features/challenge-solutions", "exactMatch": "libs/features/challenge-solutions/api/src/index.js", "pattern": "libs/features/challenge-solutions/api/src/index.ts" }, { "module": "@api/features/challenges", "exactMatch": "libs/features/challenges/api/src/index.js", "pattern": "libs/features/challenges/api/src/index.ts" }, { "module": "@api/features/code-snapshot-review", "exactMatch": "libs/features/code-snapshot-review/api/src/index.js", "pattern": "libs/features/code-snapshot-review/api/src/index.ts" }, { "module": "@api/features/code-solutions", "exactMatch": "libs/features/code-solutions/api/src/index.js", "pattern": "libs/features/code-solutions/api/src/index.ts" }, { "module": "@api/features/content", "exactMatch": "libs/features/content/api/src/index.js", "pattern": "libs/features/content/api/src/index.ts" }, { "module": "@api/features/lessons", "exactMatch": "libs/features/lessons/api/src/index.js", "pattern": "libs/features/lessons/api/src/index.ts" }, { "module": "@api/features/llm", "exactMatch": "libs/features/llm/api/src/index.js", "pattern": "libs/features/llm/api/src/index.ts" }, { "module": "@api/features/modules", "exactMatch": "libs/features/modules/api/src/index.js", "pattern": "libs/features/modules/api/src/index.ts" }, { "module": "@api/features/patterns", "exactMatch": "libs/features/patterns/api/src/index.js", "pattern": "libs/features/patterns/api/src/index.ts" }, { "module": "@api/features/pipelines", "exactMatch": "libs/features/pipelines/api/src/index.js", "pattern": "libs/features/pipelines/api/src/index.ts" }, { "module": "@api/features/practices", "exactMatch": "libs/features/practices/api/src/index.js", "pattern": "libs/features/practices/api/src/index.ts" }, { "module": "@api/features/projects", "exactMatch": "libs/features/projects/api/src/index.js", "pattern": "libs/features/projects/api/src/index.ts" }, { "module": "@api/features/sequences", "exactMatch": "libs/features/sequences/api/src/index.js", "pattern": "libs/features/sequences/api/src/index.ts" }, { "module": "@api/features/sprints", "exactMatch": "libs/features/sprints/api/src/index.js", "pattern": "libs/features/sprints/api/src/index.ts" }, { "module": "@api/features/users", "exactMatch": "libs/features/users/api/src/index.js", "pattern": "libs/features/users/api/src/index.ts" }, { "module": "@cli/features/articles", "exactMatch": "libs/features/articles/cli/src/index.js", "pattern": "libs/features/articles/cli/src/index.ts" }, { "module": "@cli/features/challenges", "exactMatch": "libs/features/challenges/cli/src/index.js", "pattern": "libs/features/challenges/cli/src/index.ts" }, { "module": "@cli/features/code-snapshot-review", "exactMatch": "libs/features/code-snapshot-review/cli/src/index.js", "pattern": "libs/features/code-snapshot-review/cli/src/index.ts" }, { "module": "@cli/features/content", "exactMatch": "libs/features/content/cli/src/index.js", "pattern": "libs/features/content/cli/src/index.ts" }, { "module": "@cli/features/patterns", "exactMatch": "libs/features/patterns/cli/src/index.js", "pattern": "libs/features/patterns/cli/src/index.ts" }, { "module": "@cli/features/practices", "exactMatch": "libs/features/practices/cli/src/index.js", "pattern": "libs/features/practices/cli/src/index.ts" }, { "module": "@cli/features/projects", "exactMatch": "libs/features/projects/cli/src/index.js", "pattern": "libs/features/projects/cli/src/index.ts" }, { "module": "@cli/features/sequences", "exactMatch": "libs/features/sequences/cli/src/index.js", "pattern": "libs/features/sequences/cli/src/index.ts" }, { "module": "@api/core/circle-ci", "exactMatch": "libs/api/core/circle-ci/src/index.js", "pattern": "libs/api/core/circle-ci/src/index.ts" }, { "module": "@api/core/http", "exactMatch": "libs/api/core/http/src/index.js", "pattern": "libs/api/core/http/src/index.ts" }, { "module": "@api/core/payments", "exactMatch": "libs/core/payments/api/src/index.js", "pattern": "libs/core/payments/api/src/index.ts" }, { "module": "@api/core/rating", "exactMatch": "libs/core/rating/api/src/index.js", "pattern": "libs/core/rating/api/src/index.ts" }, { "module": "@api/core/subscriptions", "exactMatch": "libs/core/subscriptions/api/src/index.js", "pattern": "libs/core/subscriptions/api/src/index.ts" }, { "module": "@api/core/utils", "exactMatch": "libs/api/core/utils/src/index.js", "pattern": "libs/api/core/utils/src/index.ts" }, { "module": "@lowgular/code-locator", "exactMatch": "libs/lowgular/code-locator/src/index.js", "pattern": "libs/lowgular/code-locator/src/index.ts" }, { "module": "@lowgular/codegular", "exactMatch": "libs/lowgular/codegular/src/index.js", "pattern": "libs/lowgular/codegular/src/index.ts" }, { "module": "@lowgular/marked-bootstrap", "exactMatch": "libs/lowgular/marked-bootstrap/src/index.js", "pattern": "libs/lowgular/marked-bootstrap/src/index.ts" }, { "module": "@platform/challenges", "exactMatch": "libs/platform/challenges/src/index.js", "pattern": "libs/platform/challenges/src/index.ts" }, { "module": "@platform/code-editor", "exactMatch": "libs/code-editor/src/index.js", "pattern": "libs/code-editor/src/index.ts" }, { "module": "@platform/featured-reports", "exactMatch": "libs/platform/featured-reports/src/index.js", "pattern": "libs/platform/featured-reports/src/index.ts" }, { "module": "@platform/featured-solutions", "exactMatch": "libs/platform/featured-solutions/src/index.js", "pattern": "libs/platform/featured-solutions/src/index.ts" }, { "module": "@platform/legacy-review", "exactMatch": "libs/platform/legacy-review/src/index.js", "pattern": "libs/platform/legacy-review/src/index.ts" }, { "module": "@platform/lessons", "exactMatch": "libs/platform/lessons/src/index.js", "pattern": "libs/platform/lessons/src/index.ts" }, { "module": "@platform/module", "exactMatch": "libs/platform/module/src/index.js", "pattern": "libs/platform/module/src/index.ts" }, { "module": "@platform/page-title", "exactMatch": "libs/platform/page-title/src/index.js", "pattern": "libs/platform/page-title/src/index.ts" }, { "module": "@platform/payment", "exactMatch": "libs/platform/payment/src/index.js", "pattern": "libs/platform/payment/src/index.ts" }, { "module": "@platform/pipelines", "exactMatch": "libs/platform/pipelines/src/index.js", "pattern": "libs/platform/pipelines/src/index.ts" }, { "module": "@platform/practice", "exactMatch": "libs/platform/practice/src/index.js", "pattern": "libs/platform/practice/src/index.ts" }, { "module": "@platform/practice-solutions", "exactMatch": "libs/platform/practice-solutions/src/index.js", "pattern": "libs/platform/practice-solutions/src/index.ts" }, { "module": "@platform/rating", "exactMatch": "libs/platform/rating/src/index.js", "pattern": "libs/platform/rating/src/index.ts" }, { "module": "@platform/sprints", "exactMatch": "libs/platform/sprints/src/index.js", "pattern": "libs/platform/sprints/src/index.ts" }, { "module": "@platform/subscriptions", "exactMatch": "libs/platform/subscriptions/src/index.js", "pattern": "libs/platform/subscriptions/src/index.ts" }, { "module": "@platform/users", "exactMatch": "libs/platform/users/src/index.js", "pattern": "libs/platform/users/src/index.ts" }, { "module": "@shared/alerts", "exactMatch": "libs/shared/alerts/src/index.js", "pattern": "libs/shared/alerts/src/index.ts" }, { "module": "@shared/annotation", "exactMatch": "libs/shared/annotation/src/index.js", "pattern": "libs/shared/annotation/src/index.ts" }, { "module": "@shared/articles", "exactMatch": "libs/features/articles/shared/src/index.js", "pattern": "libs/features/articles/shared/src/index.ts" }, { "module": "@shared/canvas", "exactMatch": "libs/shared/canvas/src/index.js", "pattern": "libs/shared/canvas/src/index.ts" }, { "module": "@shared/code-editor", "exactMatch": "libs/platform/shared/code-editor/src/index.js", "pattern": "libs/platform/shared/code-editor/src/index.ts" }, { "module": "@shared/components", "exactMatch": "libs/shared/components/src/index.js", "pattern": "libs/shared/components/src/index.ts" }, { "module": "@shared/design-system", "exactMatch": "libs/shared/design-system/src/index.js", "pattern": "libs/shared/design-system/src/index.ts" }, { "module": "@shared/directives", "exactMatch": "libs/shared/directives/src/index.js", "pattern": "libs/shared/directives/src/index.ts" }, { "module": "@shared/errors", "exactMatch": "libs/shared/errors/src/index.js", "pattern": "libs/shared/errors/src/index.ts" }, { "module": "@shared/forms", "exactMatch": "libs/shared/forms/src/index.js", "pattern": "libs/shared/forms/src/index.ts" }, { "module": "@shared/full-screen", "exactMatch": "libs/shared/full-screen/src/index.js", "pattern": "libs/shared/full-screen/src/index.ts" }, { "module": "@shared/ghosts", "exactMatch": "libs/shared/ghosts/src/index.js", "pattern": "libs/shared/ghosts/src/index.ts" }, { "module": "@shared/http", "exactMatch": "libs/shared/http/src/index.js", "pattern": "libs/shared/http/src/index.ts" }, { "module": "@shared/modals", "exactMatch": "libs/shared/modals/src/index.js", "pattern": "libs/shared/modals/src/index.ts" }, { "module": "@shared/pagination", "exactMatch": "libs/shared/pagination/src/index.js", "pattern": "libs/shared/pagination/src/index.ts" }, { "module": "@shared/pipes", "exactMatch": "libs/shared/pipes/src/index.js", "pattern": "libs/shared/pipes/src/index.ts" }, { "module": "@shared/states", "exactMatch": "libs/shared/states/src/index.js", "pattern": "libs/shared/states/src/index.ts" }, { "module": "@shared/text-area", "exactMatch": "libs/shared/text-area/src/index.js", "pattern": "libs/shared/text-area/src/index.ts" }, { "module": "@shared/theme", "exactMatch": "libs/shared/theme/src/index.js", "pattern": "libs/shared/theme/src/index.ts" }, { "module": "@shared/utils", "exactMatch": "libs/shared/utils/src/index.js", "pattern": "libs/shared/utils/src/index.ts" }, { "module": "@core/environment", "exactMatch": "libs/core/environment/src/index.js", "pattern": "libs/core/environment/src/index.ts" }, { "module": "@core/users", "exactMatch": "libs/core/users/src/index.js", "pattern": "libs/core/users/src/index.ts" }, { "module": "@core/codegular", "exactMatch": "libs/core/codegular/src/index.js", "pattern": "libs/core/codegular/src/index.ts" }, { "module": "@cli/code-graph", "exactMatch": "libs/cli/code-graph/src/index.js", "pattern": "libs/cli/code-graph/src/index.ts" }, { "module": "@cli/core", "exactMatch": "libs/cli/core/src/index.js", "pattern": "libs/cli/core/src/index.ts" }, { "module": "@cli/cypher", "exactMatch": "libs/cli/cypher/src/index.js", "pattern": "libs/cli/cypher/src/index.ts" }, { "module": "@cli/shared", "exactMatch": "libs/cli/shared/src/index.js", "pattern": "libs/cli/shared/src/index.ts" }, { "module": "@cli/typescript", "exactMatch": "libs/cli/typescript/src/index.js", "pattern": "libs/cli/typescript/src/index.ts" }, { "module": "@achievements", "exactMatch": "libs/achievements/src/index.js", "pattern": "libs/achievements/src/index.ts" }, { "module": "@auth", "exactMatch": "libs/auth/src/index.js", "pattern": "libs/auth/src/index.ts" }, { "module": "@breadcrumbs", "exactMatch": "libs/breadcrumbs/src/index.js", "pattern": "libs/breadcrumbs/src/index.ts" }, { "module": "@common", "exactMatch": "libs/common/src/index.js", "pattern": "libs/common/src/index.ts" }, { "module": "theme", "exactMatch": "libs/shared/theme/src/index.js", "pattern": "libs/shared/theme/src/index.ts" }];
-Module._resolveFilename = function(request, parent) {
-  let found;
-  for (const entry of manifest) {
-    if (request === entry.module && entry.exactMatch) {
-      const entry2 = manifest.find((x) => request === x.module || request.startsWith(x.module + "/"));
-      const candidate = path.join(distPath, entry2.exactMatch);
-      if (isFile(candidate)) {
-        found = candidate;
-        break;
-      }
-    } else {
-      const re = new RegExp(entry.module.replace(/\*$/, "(?<rest>.*)"));
-      const match = request.match(re);
-      if (match?.groups) {
-        const candidate = path.join(distPath, entry.pattern.replace("*", ""), match.groups.rest);
-        if (isFile(candidate)) {
-          found = candidate;
-        }
-      }
-    }
-  }
-  if (found) {
-    const modifiedArguments = [found, ...[].slice.call(arguments, 1)];
-    return originalResolveFilename.apply(this, modifiedArguments);
-  } else {
-    return originalResolveFilename.apply(this, arguments);
-  }
-};
-function isFile(s) {
-  try {
-    require.resolve(s);
-    return true;
-  } catch (_e) {
-    return false;
-  }
-}
-module.exports = require("./apps/code-graph/src/main.js");

package/package.json

@@ -1,12 +1,30 @@
 {
   "name": "@lowgular/code-graph",
-  "version": "0.0.1",
-  "main": "./main.js",
-  "type": "commonjs",
-  "publishConfig": {
-    "access": "public"
+  "version": "0.1.1",
+  "description": "Run Cypher queries against a TypeScript code graph built from tsconfig",
+  "license": "MIT",
+  "type": "module",
+  "main": "./bin/cli.js",
+  "exports": {
+    ".": "./bin/cli.js"
+  },
+  "bin": {
+    "code-graph": "./bin/cli.js"
+  },
+  "files": [
+    "**/*.js",
+    "!**/*.spec.js",
+    "!**/*.test.js"
+  ],
+  "scripts": {
+    "build": "nx build code-graph",
+    "cli": "nx run code-graph:cli"
   },
   "dependencies": {
-    "tslib": "^2.3.0"
+    "typescript": "^5.0.0",
+    "yargs": "^18.0.0"
+  },
+  "engines": {
+    "node": ">=18"
   }
-}
+}

package/resources-cli.js

@@ -0,0 +1,75 @@
+const command = "resources";
+const describe = "Print code graph schema and Cypher reference (for agents and tooling).";
+const builder = (yargs) => yargs;
+function handler() {
+  console.log(RESOURCES_TEXT);
+}
+const RESOURCES_TEXT = `# Code Graph \u2014 Cypher over TypeScript
+
+The graph database is your **TypeScript code**. Nodes are AST nodes; relationships follow the structure of the program. You run Cypher queries against a project built from a tsconfig; the engine builds the graph on the fly from the query (no separate schema).
+
+## Node labels = TypeScript SyntaxKind
+
+Labels are **TypeScript AST node kinds** (SyntaxKind names). Examples:
+
+  ClassDeclaration, MethodDeclaration, PropertyDeclaration, Constructor,
+  FunctionDeclaration, VariableStatement, CallExpression, Identifier,
+  ObjectLiteralExpression, Decorator, SourceFile, ImportDeclaration, ...
+
+Use them in patterns: \`(n:ClassDeclaration)\`, \`(d:Decorator)\`, \`(p:PropertyDeclaration)\`.
+
+## Node shape (every node)
+
+Each node in the result has:
+
+  - **id**     \u2014 unique node id (file path + position)
+  - **labels** \u2014 array of one label (the SyntaxKind name)
+  - **name**   \u2014 \`node.name?.getText()\` (e.g. class/method/prop name)
+  - **filePath** \u2014 source file path
+  - **text**   \u2014 full text of the AST node
+  - **type**   \u2014 resolved type from TypeChecker when available
+  - **firstIdentifier** \u2014 first descendant Identifier text
+  - **initializer**     \u2014 initializer text when present (e.g. variable, property)
+
+So you can filter or return \`n.name\`, \`n.filePath\`, \`n.text\`, \`n.type\`, etc.
+
+## Relationships (most common)
+
+**Traversal (AST structure)**
+  - **HAS_DESCENDANTS** \u2014 recursive descent into child nodes (optionally by kind)
+  - **HAS_ANCESTORS** \u2014 recursive ascent to parent nodes
+
+**Direct AST properties**
+  - **HAS_INITIALIZER** \u2014 \`node.initializer\` (VariableDeclaration, PropertyDeclaration, \u2026)
+  - **HAS_PARAMETERS** \u2014 \`node.parameters\` (functions, constructors, \u2026)
+  - **HAS_EXPRESSION** \u2014 \`node.expression\` (CallExpression, Decorator, \u2026)
+  - **HAS_TYPE_ANNOTATION** \u2014 \`node.type\` (explicit type on params, properties, return)
+  - **HAS_BODY** \u2014 \`node.body\` (functions, methods, arrow functions, \u2026)
+  - **HAS_MEMBERS** \u2014 \`node.members\` (class/interface/enum members)
+  - **HAS_PROPERTIES** \u2014 \`node.properties\` (ObjectLiteralExpression)
+  - **HAS_ARGUMENTS** \u2014 \`node.arguments\` (CallExpression, NewExpression)
+  - **HAS_DECORATORS** \u2014 decorators on the node
+  - **HAS_TYPE** \u2014 resolved type (TypeChecker)
+  - **HAS_NAME** \u2014 \`node.name\` (Identifier)
+
+**Heritage**
+  - **EXTENDS** \u2014 \`extends\` clause (classes, interfaces)
+  - **IMPLEMENTS** \u2014 \`implements\` clause (classes)
+
+Example: find classes with a \`Component\` decorator:
+
+  MATCH (c:ClassDeclaration)-[:HAS_DECORATORS]->(d:Decorator)
+  WHERE d.name = 'Component'
+  RETURN c
+
+Example: find method and its parameters:
+
+  MATCH (m:MethodDeclaration)-[:HAS_PARAMETERS]->(p:ParameterDeclaration)
+  RETURN m, p
+`;
+export {
+  builder,
+  command,
+  describe,
+  handler
+};

package/run-cli.js

@@ -0,0 +1,43 @@
+import * as fs from "fs";
+import * as path from "path";
+import { createProgramFromTsConfig } from "./codegular/index.js";
+import { autoMatch } from "./infra/code-graph.js";
+const command = "query <cypher>";
+const describe = "Run Cypher and print match results as JSON. Builds the code graph from the project tsconfig; node/relationship config is inferred from the query.";
+const builder = (yargs) => yargs.option("tsconfig", {
+  type: "string",
+  default: "tsconfig.json",
+  description: "Path to tsconfig.json (default: tsconfig.json in cwd)"
+}).positional("cypher", {
+  type: "string",
+  demandOption: true,
+  description: 'Cypher query (quote in shell: "MATCH (n:ClassDeclaration) RETURN n")'
+});
+async function handler(argv) {
+  const cypherQuery = argv.cypher.trim();
+  const cwd = process.cwd();
+  const tsconfigPath = path.isAbsolute(argv.tsconfig) ? argv.tsconfig : path.join(cwd, argv.tsconfig);
+  if (!fs.existsSync(tsconfigPath)) {
+    console.error(`Error: tsconfig not found at ${tsconfigPath}`);
+    process.exit(1);
+  }
+  try {
+    const program = createProgramFromTsConfig(tsconfigPath);
+    const results = autoMatch(cypherQuery, program);
+    console.log(JSON.stringify(results, null, 2));
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const stack = err instanceof Error ? err.stack : void 0;
+    console.error(`Error: ${message}`);
+    if (stack && process.env.DEBUG) {
+      console.error(stack);
+    }
+    process.exit(1);
+  }
+}
+export {
+  builder,
+  command,
+  describe,
+  handler
+};

package/apps/code-graph/src/main.js

@@ -1,50 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var main_exports = {};
-__export(main_exports, {
-  NODE_PRESETS: () => NODE_PRESETS,
-  matchFromFileSystem: () => matchFromFileSystem,
-  matchFromTsConfig: () => matchFromTsConfig
-});
-module.exports = __toCommonJS(main_exports);
-var import_code_graph = require("@cli/code-graph");
-var import_codegular = require("@core/codegular");
-const matchFromTsConfig = async (cypherQuery, tsConfigPath = "./tsconfig.json") => {
-  const program = (0, import_codegular.createProgramFromTsConfig)(tsConfigPath);
-  return [];
-};
-const matchFromFileSystem = async (cypherQuery, config, fileSystem) => {
-  const program = (0, import_codegular.createProgramFromFileSystem)(fileSystem);
-  const codeGraph = (0, import_code_graph.buildCodeGraph)(program, config);
-  const results = await import_code_graph.TOOLS.queryFromGraph(cypherQuery, codeGraph);
-  return results;
-};
-const NODE_PRESETS = {
-  NAMEABLE: {
-    properties: {
-      name: `helpers.getDescendantsBy(args.current, (node) => node.kind === args.ts.SyntaxKind.Identifier)[0]?.getText();`,
-      filePath: "args.sourceFile.fileName;"
-    }
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  NODE_PRESETS,
-  matchFromFileSystem,
-  matchFromTsConfig
-});

package/libs/cli/code-graph/src/index.js

@@ -1,39 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var src_exports = {};
-module.exports = __toCommonJS(src_exports);
-__reExport(src_exports, require("./lib/class-declarations"), module.exports);
-__reExport(src_exports, require("./lib/code.graph.factory"), module.exports);
-__reExport(src_exports, require("./lib/core/core"), module.exports);
-__reExport(src_exports, require("./lib/decorators"), module.exports);
-__reExport(src_exports, require("./lib/docs"), module.exports);
-__reExport(src_exports, require("./lib/method-declarations"), module.exports);
-__reExport(src_exports, require("./lib/parameters"), module.exports);
-__reExport(src_exports, require("./lib/property-declarations"), module.exports);
-__reExport(src_exports, require("./lib/tools"), module.exports);
-__reExport(src_exports, require("./lib/v2"), module.exports);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ...require("./lib/class-declarations"),
-  ...require("./lib/code.graph.factory"),
-  ...require("./lib/core/core"),
-  ...require("./lib/decorators"),
-  ...require("./lib/docs"),
-  ...require("./lib/method-declarations"),
-  ...require("./lib/parameters"),
-  ...require("./lib/property-declarations"),
-  ...require("./lib/tools"),
-  ...require("./lib/v2")
-});