@polymerix-labs/facts-extract 0.7.4 → 0.7.5

package/README.md

@@ -1,11 +1,10 @@
 # @polymerix-labs/facts-extract
 
-Native **Polymerix front extractor**. It walks a repository and emits a `FactsBundle` JSON
-(faithful, language-neutral facts produced with tree-sitter). It carries **no business logic**
-(no semantic resolution, no graph assembly), so it is safe to ship to client machines.
+Analyze a project directory and write a **FactsBundle** JSON file — one entry per
+supported source file.
 
-The matching native binary is installed automatically for your platform via an optional
-dependency (the same pattern as `esbuild`): nothing is downloaded at runtime.
+The native CLI for your platform is installed automatically (same pattern as `esbuild`);
+nothing is downloaded at runtime.
 
 ## Install
 
@@ -56,6 +55,17 @@ Exit codes: `0` success, `1` usage error, `2` repo not found, `3` extraction/ser
 
 ## Output
 
-A `FactsBundle` JSON (the front to back transport contract), versioned by
-`FACTS_SCHEMA_VERSION`. Feed it to the back (`facts-build`) to produce a `graph.json`. See the
-[Polymerix parser repository](https://gitlab.com/polymerix/parser) for the bundle format.
+The CLI writes a **FactsBundle** JSON (`schema_version`, `repo_root`, and a `files` array).
+Each file entry includes:
+
+| Field | What it contains |
+|-------|------------------|
+| `entry` | File path, language, extension |
+| `facts.imports` | Import declarations as written in source |
+| `facts.exports` | Export / re-export declarations (JS/TS) |
+| `facts.symbols` | Classes, methods, functions, fields… with names, types, signatures, and source positions |
+| `facts.refs` | Calls, type uses, inheritance, annotations — collected as written, not yet resolved to targets |
+| `facts.local_bindings` | Local variables and their declared or inferred types |
+| `facts.has_syntax_errors` | Whether the file had parse errors |
+
+The bundle format is versioned by `FACTS_SCHEMA_VERSION` (currently `1`).

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@polymerix-labs/facts-extract",
-  "version": "0.7.4",
-  "description": "Polymerix front extractor: walk a repository and emit a FactsBundle JSON (tree-sitter only, no business logic). Ships the native binary per platform.",
+  "version": "0.7.5",
+  "description": "Analyze a project directory and output structured JSON describing its source files (symbols, imports, and code references). Installs the native CLI for your OS.",
   "keywords": [
     "polymerix",
     "facts",
@@ -10,10 +10,9 @@
     "parser"
   ],
   "homepage": "https://gitlab.com/polymerix/parser",
-  "repository": {
-    "type": "git",
-    "url": "https://gitlab.com/polymerix/parser.git",
-    "directory": "npm/facts-extract"
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   },
   "license": "MIT",
   "type": "commonjs",
@@ -29,10 +28,10 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@polymerix-labs/facts-extract-linux-x64": "0.7.4",
-    "@polymerix-labs/facts-extract-linux-arm64": "0.7.4",
-    "@polymerix-labs/facts-extract-darwin-x64": "0.7.4",
-    "@polymerix-labs/facts-extract-darwin-arm64": "0.7.4",
-    "@polymerix-labs/facts-extract-win32-x64": "0.7.4"
+    "@polymerix-labs/facts-extract-linux-x64": "0.7.5",
+    "@polymerix-labs/facts-extract-linux-arm64": "0.7.5",
+    "@polymerix-labs/facts-extract-darwin-x64": "0.7.5",
+    "@polymerix-labs/facts-extract-darwin-arm64": "0.7.5",
+    "@polymerix-labs/facts-extract-win32-x64": "0.7.5"
   }
 }