@functional-systems/srcx 0.1.0-dev.3 → 0.1.0-dev.30

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 (60) hide show
  1. package/CHANGELOG.md +132 -1
  2. package/DESIGN.md +193 -58
  3. package/README.md +542 -38
  4. package/RELEASING.md +30 -9
  5. package/VALIDATION.md +834 -25
  6. package/dist/build.d.ts +81 -1
  7. package/dist/build.js +187 -37
  8. package/dist/build.js.map +1 -1
  9. package/dist/chunk.d.ts +9 -3
  10. package/dist/chunk.js +341 -14
  11. package/dist/chunk.js.map +1 -1
  12. package/dist/cli.js +103 -19
  13. package/dist/cli.js.map +1 -1
  14. package/dist/file-policy.d.ts +20 -0
  15. package/dist/file-policy.js +96 -0
  16. package/dist/file-policy.js.map +1 -0
  17. package/dist/implementation.d.ts +11 -0
  18. package/dist/implementation.js +191 -0
  19. package/dist/implementation.js.map +1 -0
  20. package/dist/publish.d.ts +18 -0
  21. package/dist/publish.js +158 -34
  22. package/dist/publish.js.map +1 -1
  23. package/dist/releases.js +21 -3
  24. package/dist/releases.js.map +1 -1
  25. package/dist/remote.js +38 -9
  26. package/dist/remote.js.map +1 -1
  27. package/dist/repository.d.ts +4 -1
  28. package/dist/repository.js +15 -11
  29. package/dist/repository.js.map +1 -1
  30. package/dist/rerank.d.ts +16 -0
  31. package/dist/rerank.js +87 -0
  32. package/dist/rerank.js.map +1 -0
  33. package/dist/search.d.ts +14 -4
  34. package/dist/search.js +119 -23
  35. package/dist/search.js.map +1 -1
  36. package/dist/skills.d.ts +24 -0
  37. package/dist/skills.js +155 -0
  38. package/dist/skills.js.map +1 -0
  39. package/package.json +16 -5
  40. package/runtime/grammars/README.md +50 -0
  41. package/runtime/grammars/tree-sitter-bash.LICENSE +21 -0
  42. package/runtime/grammars/tree-sitter-bash.wasm +0 -0
  43. package/runtime/grammars/tree-sitter-sql.LICENSE +21 -0
  44. package/runtime/grammars/tree-sitter-sql.wasm +0 -0
  45. package/runtime/grammars/tree-sitter-wasm.LICENSE +21 -0
  46. package/runtime/qwen.py +132 -0
  47. package/runtime/requirements.txt +34 -0
  48. package/skills/srcx-search/SKILL.md +85 -0
  49. package/src/build.ts +258 -47
  50. package/src/chunk.ts +360 -12
  51. package/src/cli.ts +212 -24
  52. package/src/file-policy.ts +157 -0
  53. package/src/implementation.ts +253 -0
  54. package/src/publish.ts +226 -34
  55. package/src/releases.ts +36 -3
  56. package/src/remote.ts +59 -13
  57. package/src/repository.ts +20 -11
  58. package/src/rerank.ts +131 -0
  59. package/src/search.ts +154 -28
  60. package/src/skills.ts +205 -0
package/RELEASING.md CHANGED
@@ -2,12 +2,31 @@
2
2
 
3
3
  ## Current state
4
4
 
5
- The source is prepared as `@functional-systems/srcx@0.1.0-dev.1` under Apache-2.0.
6
- It has not been published to npm. `private: false` permits a reviewed first
7
- publication; it does not establish registry availability or distribution readiness.
8
- `NPM_DEV_PUBLISH_ENABLED` is initially `false`. No stable/rc release or Homebrew
9
- formula has been published. Local/live application evidence is in
10
- [VALIDATION.md](VALIDATION.md); it is separate from package publication evidence.
5
+ As of 2026-09-26, the verified `dev` package is `0.1.0-dev.17`, built from
6
+ `98be125d45128a9395544b0925df591c0da08b39` by the successful
7
+ [develop publication](https://github.com/lambdadb/srcx/actions/runs/36178586841).
8
+ The downloaded registry tarball matches its SHA-512 integrity and installed
9
+ `gitHead`. The npm provenance statement identifies the same commit, workflow
10
+ and run; inspecting that statement is separate from cryptographic verification
11
+ of its signature. See [first-use validation](VALIDATION.md#installed-dev-package-first-use)
12
+ for the clean consumer and live CLI checks. `dev` is mutable; these claims apply
13
+ to the exact version above, not future publications.
14
+
15
+ Bootstrap history:
16
+
17
+ The initial `@functional-systems/srcx@0.1.0-dev.1` package was published publicly
18
+ from reviewed commit `f94f947bf593b2f8498c07e130933b0ab444f868`. Its exact tarball
19
+ passed clean-install and live LambdaDB checks. The local bootstrap has no GitHub
20
+ Actions provenance. npm created both `dev` and `latest` at that prerelease; select
21
+ `@dev` explicitly. No stable/rc release or Homebrew formula has been published.
22
+
23
+ The package-specific Trusted Publisher is configured for `lambdadb/srcx` and
24
+ `publish.yaml`, with direct publication allowed. `NPM_DEV_PUBLISH_ENABLED=true`.
25
+ The first successful [OIDC publication](https://github.com/lambdadb/srcx/actions/runs/36035063463/attempts/3)
26
+ produced `0.1.0-dev.3` from the same commit and moved `dev` to that version.
27
+ Provenance identifies this repository, workflow, commit, and run. At the September 26 registry check,
28
+ `latest` remained the bootstrap prerelease `0.1.0-dev.1`; it is not a stable release.
29
+ See [VALIDATION.md](VALIDATION.md) for registry and consumer verification.
11
30
 
12
31
  This workflow follows [LambdaDB CLI](https://github.com/lambdadb/lambdadb-cli/blob/develop/RELEASING.md).
13
32
  The repository keeps Prettier plus strict TypeScript checks as its existing lint
@@ -26,7 +45,8 @@ version entries in `package-lock.json` together, for example using
26
45
  `npm version VERSION --no-git-tag-version`. CLI `--version` reads package metadata.
27
46
  For explicit releases, add a dated `## [VERSION] - YYYY-MM-DD` changelog section.
28
47
  The GitHub tag must match the version, and the prerelease flag must match its channel.
29
- `latest`, not the tip of `main`, identifies the stable npm release.
48
+ After the first stable release, `latest` identifies the stable npm release;
49
+ the bootstrap exception is recorded above.
30
50
 
31
51
  The checked-in development base starts at `0.1.0-dev.1`. During an eligible push,
32
52
  `scripts/dev-release.mjs` replaces `N` with the full history's first-parent commit
@@ -46,7 +66,7 @@ GitHub permissions and no LambdaDB service keys.
46
66
  Publication packs once, tests that exact tarball through a clean installation,
47
67
  and publishes the same file with provenance. Do not replace it with a repacked
48
68
  artifact after testing. The package includes runtime JavaScript, source maps and
49
- their source files, and public docs/license; it excludes tests, workflows,
69
+ their source files, the optional Qwen worker/requirements, and public docs/license; it excludes tests, workflows,
50
70
  scripts, `.env`, and `.srcx` state. Production dependencies supply the parser
51
71
  WASM assets; package tests exercise parsing with install scripts disabled.
52
72
 
@@ -64,7 +84,8 @@ Do not republish, overwrite versions, or move release tags to work around lag.
64
84
 
65
85
  ## First publication and Trusted Publisher setup
66
86
 
67
- Complete these steps from a reviewed, validated commit after this setup PR merges:
87
+ The initial bootstrap is complete. The procedure below documents first-time setup
88
+ and the checks required before declaring automatic publication operational:
68
89
 
69
90
  1. Verify npm ownership for the `functional-systems` scope and the package name.
70
91
  GitHub organization membership does not establish npm permissions.