@g3nomaly/analyze 0.1.4 → 0.1.5

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.
package/README.md CHANGED
@@ -21,13 +21,13 @@ On top of `.gitignore`, the scan skips `node_modules/`, `dist/`, `build/`, `out/
21
21
 
22
22
  ## What it reads
23
23
 
24
- | Section | Read from |
25
- |---|---|
26
- | Skills | Every `SKILL.md` inside the directory of an AI tool (`.claude`, `.codex`, `.cursor`, `.gemini`, `.agents`, `.windsurf`, `.opencode`) and the files beside it. A `SKILL.md` elsewhere is a doc |
27
- | Docs | Markdown. `glossary.md` is read as terms, `decisions.md` as decisions, in any case. Any other markdown file is a document, whatever its folder |
28
- | Code | Classes and functions in 13 languages through tree-sitter, with their doc comments. JSON, TOML and YAML files, OpenAPI documents and JSON Schemas among them |
29
- | Database | `.sql` files. A file that creates tables becomes a schema diagram, any other a query catalog. No database is ever opened |
30
- | Tasks | The plans, phases and tasks that task-manager keeps, in `skills.settings.filetreeRoot` of `.g3n.config.json` (default `docs/task-manager`) |
24
+ | Section | Read from |
25
+ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
+ | Skills | Every `SKILL.md` inside the directory of an AI tool (`.claude`, `.codex`, `.cursor`, `.gemini`, `.agents`, `.windsurf`, `.opencode`) and the files beside it. A `SKILL.md` elsewhere is a doc |
27
+ | Docs | Markdown. `glossary.md` is read as terms, `decisions.md` as decisions, in any case. Any other markdown file is a document, whatever its folder |
28
+ | Code | Classes and functions in 13 languages through tree-sitter, with their doc comments. JSON, TOML and YAML files, OpenAPI documents and JSON Schemas among them |
29
+ | Database | `.sql` files. A file that creates tables becomes a schema diagram, any other a query catalog. No database is ever opened |
30
+ | Tasks | The plans, phases and tasks that task-manager keeps, in `skills.settings.filetreeRoot` of `.g3n.config.json` (default `docs/task-manager`) |
31
31
  | Packages | A directory with a `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`, `pom.xml`, `build.gradle`, `composer.json`, `.csproj`, `.gemspec`, `Gemfile`, `vcpkg.json` or `CMakeLists.txt` is shown as a package: an app, a library or a workspace. A `CMakeLists.txt` counts when it calls `project(`, builds a library or an executable (`add_library`, `add_executable`, or a macro whose name holds `library` or `executable`), or sits beside an `include/` folder. In a `src/`, `test/`, `tests/`, `cmake/` or `examples/` directory only `project(` counts, so `libs/<lib>/src/CMakeLists.txt` stays part of `libs/<lib>` |
32
32
 
33
33
  Every page, entry, parameter and field is a node of one graph. Edges connect a type to where it is used, a source file to the files it includes or imports, a function to the functions it calls, a term to the text that uses it, a decision to the code it affects, a table to its foreign keys and queries, and a task to the code, docs and decisions it names and to the tasks it depends on. One registry in `src/model/registry.ts` defines every kind of node and edge.
@@ -64,11 +64,20 @@ A **community** is a group of nodes that link to each other more than to the res
64
64
  The same queries are a typed library API. A function never prints. Warnings go to `onWarning`, and errors are thrown as `OptionsError`, `QueryError` or `SourceError`.
65
65
 
66
66
  ```ts
67
- import { refs, search, show } from '@g3nomaly/analyze';
68
-
69
- const hits = await search({ repo: '/home/me/app', query: 'route price', limit: 5 });
70
- const task = await show({ repo: '/home/me/app', target: 'TASK-002' });
71
- const callers = await refs({ repo: '/home/me/app', target: 'choose_route', incoming: true, edges: ['names'] });
67
+ import { refs, search, show } from "@g3nomaly/analyze";
68
+
69
+ const hits = await search({
70
+ repo: "/home/me/app",
71
+ query: "route price",
72
+ limit: 5,
73
+ });
74
+ const task = await show({ repo: "/home/me/app", target: "TASK-002" });
75
+ const callers = await refs({
76
+ repo: "/home/me/app",
77
+ target: "choose_route",
78
+ incoming: true,
79
+ edges: ["names"],
80
+ });
72
81
  ```
73
82
 
74
83
  `createDocs`, `search`, `show`, `refs`, `list` and `graph` take the options of the CLI as fields.
@@ -1691,11 +1691,11 @@ Embedding model
1691
1691
 
1692
1692
  `vectors.bin` and `vocab.txt` are a table with one vector per word. `scripts/distill_word_table.py` computed it from the files below. `manifest.json` holds their SHA-256.
1693
1693
 
1694
- | Source | Used for | License |
1695
- |---|---|---|
1694
+ | Source | Used for | License |
1695
+ | ---------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------- |
1696
1696
  | [all-MiniLM-L6-v2](https://huggingface.co/sentence-transformers/all-MiniLM-L6-v2) by the Sentence Transformers authors | The vector of each word, and the whole words of its vocabulary as the first part of the word list | Apache-2.0 |
1697
- | [potion-base-8M](https://huggingface.co/minishlab/potion-base-8M) by MinishLab | How much each word counts: the length of its row | MIT |
1698
- | [potion-code-16M-v2](https://huggingface.co/minishlab/potion-code-16M-v2) by MinishLab | `code-words.txt`: the 12,000 most frequent words of its vocabulary that the first list lacks | MIT |
1697
+ | [potion-base-8M](https://huggingface.co/minishlab/potion-base-8M) by MinishLab | How much each word counts: the length of its row | MIT |
1698
+ | [potion-code-16M-v2](https://huggingface.co/minishlab/potion-code-16M-v2) by MinishLab | `code-words.txt`: the 12,000 most frequent words of its vocabulary that the first list lacks | MIT |
1699
1699
 
1700
1700
  The model files were taken from the npm packages `@lat.md/embed-minilm-fp16@0.1.0` (a 16-bit copy of all-MiniLM-L6-v2), `counterparts-model-potion@0.1.0` and `zvec-grep-potion-code-16m-v2-model@0.1.0`. analyze ships none of them, only the table.
1701
1701
 
package/dist/cli.js CHANGED
@@ -7989,7 +7989,7 @@ async function prepareOutputDir(repo) {
7989
7989
  // package.json
7990
7990
  var package_default = {
7991
7991
  name: "@g3nomaly/analyze",
7992
- version: "0.1.4",
7992
+ version: "0.1.5",
7993
7993
  description: "Turns a repository into one offline HTML documentation site, and queries the same linked model from the terminal and from hooks.",
7994
7994
  keywords: [
7995
7995
  "documentation",
package/dist/index.js CHANGED
@@ -7985,7 +7985,7 @@ async function prepareOutputDir(repo) {
7985
7985
  // package.json
7986
7986
  var package_default = {
7987
7987
  name: "@g3nomaly/analyze",
7988
- version: "0.1.4",
7988
+ version: "0.1.5",
7989
7989
  description: "Turns a repository into one offline HTML documentation site, and queries the same linked model from the terminal and from hooks.",
7990
7990
  keywords: [
7991
7991
  "documentation",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@g3nomaly/analyze",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "description": "Turns a repository into one offline HTML documentation site, and queries the same linked model from the terminal and from hooks.",
5
5
  "keywords": [
6
6
  "documentation",
@@ -40,7 +40,7 @@
40
40
  "docs": "bun run build && bun dist/cli.js create_docs"
41
41
  },
42
42
  "dependencies": {
43
- "@g3nomaly/core": "^0.3.5",
43
+ "@g3nomaly/core": "^0.3.6",
44
44
  "@t3-oss/env-core": "^0.13.11",
45
45
  "hast-util-to-string": "^3.0.1",
46
46
  "rehype-parse": "^9.0.1",
@@ -58,7 +58,7 @@
58
58
  "zod": "^4.6.5"
59
59
  },
60
60
  "devDependencies": {
61
- "@g3nomaly/ui": "^0.3.6",
61
+ "@g3nomaly/ui": "^0.3.7",
62
62
  "@tanstack/react-router": "^1.170.41",
63
63
  "@tanstack/react-store": "^0.11.2",
64
64
  "@tree-sitter-grammars/tree-sitter-kotlin": "^1.1.0",