@polymerix-labs/facts-extract 0.10.0 → 0.12.0

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.
Files changed (2) hide show
  1. package/README.md +10 -1
  2. package/package.json +6 -6
package/README.md CHANGED
@@ -42,11 +42,20 @@ const bundle = JSON.parse(out.stdout); // FactsBundle
42
42
  npx @polymerix-labs/facts-extract --repo-root /abs/path/to/project -o bundle.json
43
43
  ```
44
44
 
45
+ ### Single file (incremental sync)
46
+
47
+ ```bash
48
+ npx @polymerix-labs/facts-extract --repo-root /abs/path/to/project --file src/Foo.java
49
+ ```
50
+
51
+ Stdout is one **FactsFileEntry** JSON (`entry`, `facts`, `content_fingerprint`) suitable for per-file upload to the sync API.
52
+
45
53
  ## Flags
46
54
 
47
55
  | Flag | Effet |
48
56
  |------|-------|
49
57
  | `--repo-root <PATH>` | Absolute path to the repository root (required) |
58
+ | `--file <REL_PATH>` | Extract one repo-relative file as a **FactsFileEntry** JSON (incremental sync) |
50
59
  | `--output, -o <FILE>` | Write the FactsBundle JSON to a file (default: stdout) |
51
60
  | `--verbose` | Real-time logs on stderr |
52
61
  | `--progress` | Progress bar on stderr during the parallel parse pass |
@@ -68,4 +77,4 @@ Each file entry includes:
68
77
  | `facts.local_bindings` | Local variables and their declared or inferred types |
69
78
  | `facts.has_syntax_errors` | Whether the file had parse errors |
70
79
 
71
- The bundle format is versioned by `FACTS_SCHEMA_VERSION` (currently `1`).
80
+ The bundle format is versioned by `FACTS_SCHEMA_VERSION` (currently `2`). Per-file entries include a `content_fingerprint` for incremental sync.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@polymerix-labs/facts-extract",
3
- "version": "0.10.0",
3
+ "version": "0.12.0",
4
4
  "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.",
5
5
  "keywords": [
6
6
  "polymerix",
@@ -28,10 +28,10 @@
28
28
  "node": ">=16"
29
29
  },
30
30
  "optionalDependencies": {
31
- "@polymerix-labs/facts-extract-linux-x64": "0.10.0",
32
- "@polymerix-labs/facts-extract-linux-arm64": "0.10.0",
33
- "@polymerix-labs/facts-extract-darwin-x64": "0.10.0",
34
- "@polymerix-labs/facts-extract-darwin-arm64": "0.10.0",
35
- "@polymerix-labs/facts-extract-win32-x64": "0.10.0"
31
+ "@polymerix-labs/facts-extract-linux-x64": "0.0.0",
32
+ "@polymerix-labs/facts-extract-linux-arm64": "0.0.0",
33
+ "@polymerix-labs/facts-extract-darwin-x64": "0.0.0",
34
+ "@polymerix-labs/facts-extract-darwin-arm64": "0.12.0",
35
+ "@polymerix-labs/facts-extract-win32-x64": "0.0.0"
36
36
  }
37
37
  }