codespine 1.0.9__tar.gz → 1.0.11__tar.gz

{codespine-1.0.9 → codespine-1.0.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codespine
-Version: 1.0.9
+Version: 1.0.11
 Summary: Local Java code intelligence indexer backed by a graph database
 Author: CodeSpine contributors
 License: MIT License
@@ -56,6 +56,7 @@ Requires-Dist: numpy; extra == "ml"
 Provides-Extra: community
 Requires-Dist: igraph; extra == "community"
 Requires-Dist: leidenalg; extra == "community"
+Provides-Extra: ui
 Provides-Extra: full
 Requires-Dist: sentence-transformers; extra == "full"
 Requires-Dist: numpy; extra == "full"
@@ -65,7 +66,7 @@ Dynamic: license-file
 
 # CodeSpine
 
-**v1.0.0** — Local Java code intelligence for coding agents, backed by a graph database.
+**v1.0.11** — Local Java code intelligence for coding agents, backed by a graph database.
 
 CodeSpine cuts token burn for coding agents working on Java codebases.
 
@@ -95,12 +96,23 @@ File changes are written directly to the graph and are immediately queryable —
 pip install codespine
 ```
 
+Default install includes the CLI, MCP server, Java indexer, watch mode, health checks, background task tracking, and graph/search commands.
+
 Optional semantic search (sentence-transformers):
 
 ```bash
 pip install "codespine[ml]"
 ```
 
+Add the local index explorer UI:
+
+```bash
+pip install "codespine[ui]"
+```
+
+The current lite UI is dependency-free and served locally by CodeSpine; the `ui` extra is the stable add-on install target for the browser explorer.
+Quotes are required in zsh: use `pip install "codespine[ui]"`, not `pip install codespine[ui]`.
+
 Everything at once (ml + community detection):
 
 ```bash
@@ -149,6 +161,8 @@ Detecting execution flows...   34 processes found
 Finding dead code...           12 unreachable symbols
 Analyzing git history...       18 coupled file pairs
 Generating embeddings...       623 vectors stored
+Index self-test...             passed
+Index health...                no anomalies
 
 Done in 4.2s — 623 symbols, 1,847 edges, 8 clusters, 34 flows
 Publishing read replica...     MCP will reload automatically
@@ -317,6 +331,12 @@ codespine analyse <path> --complete --deep   # + communities, flows, dead code,
 codespine analyse <path> --complete --incremental-deep
 codespine analyse <path> --embed             # + vector embeddings
 
+# Background jobs and local UI
+codespine background                         # background task progress
+codespine tasks                              # running/recent background work
+codespine ui                                 # local read-only index explorer
+codespine ui --open                          # open http://127.0.0.1:8765
+
 # Live watch
 codespine watch --path .                     # file-save-triggered direct-to-graph writes
 codespine watch --path . --install-hook      # also install post-commit git hook
@@ -334,6 +354,8 @@ codespine diff main..feature                 # symbol-level branch diff
 
 # Status & Info
 codespine stats                              # per-project stats (--shards for shard layout)
+codespine health                             # index coverage and anomaly dashboard
+codespine self-test                          # smoke queries for schema/translator checks
 codespine list                               # indexed projects
 codespine status                             # service and database status
 codespine guide                              # tool catalog and workflows
@@ -360,7 +382,7 @@ codespine force-reset                        # emergency: delete all data files
 
 `analyse` defaults to incremental mode. Repeat runs only process changed files and are fast.
 
-`analyse` runs in fast mode by default: it indexes the core graph, publishes that read replica from a detached process, then continues communities, flows, dead code, coupling, and cross-module enrichment in the background. Use `--complete --deep` when you want those passes refreshed before the command returns.
+`analyse` runs in fast mode by default: it indexes the core graph, honors the foreground time budget, publishes a read replica, then continues unfinished core indexing or enrichment in the background. Use `codespine background` or `codespine ui` to watch that work. Use `--complete --deep` when you want those passes refreshed before the command returns.
 
 ---
 
@@ -546,7 +568,11 @@ The deep analysis phase covers four passes that are expensive but optional:
 | Dead code | Finds methods with no callers (Java-aware exemptions) | Cleanup audits |
 | Change coupling | Analyses git history for co-changed file pairs | `get_change_coupling`, `related` |
 
-**Fast default:** `codespine analyse` prioritizes a queryable core index. Communities, flows, dead-code, git coupling, and cross-module links are queued in a detached background enrichment job unless you use `--complete`.
+**Fast default:** `codespine analyse` prioritizes a queryable core index and keeps the foreground run inside the configured budget. If core indexing or call/type resolution cannot finish in time, the partial index is published and a background continuation finishes the core graph. Communities, flows, dead-code, git coupling, and cross-module links are queued in a detached background enrichment job unless you use `--complete`.
+
+**Health checks:** every analyse run now performs a small self-test query suite and reports index anomalies such as large projects with zero call edges. Use `codespine health` for the terminal dashboard or `codespine self-test --json` in CI.
+
+**Background visibility:** `codespine background` shows running background job progress in the terminal, and `codespine tasks` remains available as the shorter registry view. `codespine ui` serves a local read-only index explorer with project counts, index health, and the same background task state at `http://127.0.0.1:8765`.
 
 **Complete deep:** `--complete --deep` runs the expensive enrichment passes before returning. `--complete --incremental-deep` combines incremental file indexing with a forced full deep pass.
 

{codespine-1.0.9 → codespine-1.0.11}/README.md

@@ -1,6 +1,6 @@
 # CodeSpine
 
-**v1.0.0** — Local Java code intelligence for coding agents, backed by a graph database.
+**v1.0.11** — Local Java code intelligence for coding agents, backed by a graph database.
 
 CodeSpine cuts token burn for coding agents working on Java codebases.
 
@@ -30,12 +30,23 @@ File changes are written directly to the graph and are immediately queryable —
 pip install codespine
 ```
 
+Default install includes the CLI, MCP server, Java indexer, watch mode, health checks, background task tracking, and graph/search commands.
+
 Optional semantic search (sentence-transformers):
 
 ```bash
 pip install "codespine[ml]"
 ```
 
+Add the local index explorer UI:
+
+```bash
+pip install "codespine[ui]"
+```
+
+The current lite UI is dependency-free and served locally by CodeSpine; the `ui` extra is the stable add-on install target for the browser explorer.
+Quotes are required in zsh: use `pip install "codespine[ui]"`, not `pip install codespine[ui]`.
+
 Everything at once (ml + community detection):
 
 ```bash
@@ -84,6 +95,8 @@ Detecting execution flows...   34 processes found
 Finding dead code...           12 unreachable symbols
 Analyzing git history...       18 coupled file pairs
 Generating embeddings...       623 vectors stored
+Index self-test...             passed
+Index health...                no anomalies
 
 Done in 4.2s — 623 symbols, 1,847 edges, 8 clusters, 34 flows
 Publishing read replica...     MCP will reload automatically
@@ -252,6 +265,12 @@ codespine analyse <path> --complete --deep   # + communities, flows, dead code,
 codespine analyse <path> --complete --incremental-deep
 codespine analyse <path> --embed             # + vector embeddings
 
+# Background jobs and local UI
+codespine background                         # background task progress
+codespine tasks                              # running/recent background work
+codespine ui                                 # local read-only index explorer
+codespine ui --open                          # open http://127.0.0.1:8765
+
 # Live watch
 codespine watch --path .                     # file-save-triggered direct-to-graph writes
 codespine watch --path . --install-hook      # also install post-commit git hook
@@ -269,6 +288,8 @@ codespine diff main..feature                 # symbol-level branch diff
 
 # Status & Info
 codespine stats                              # per-project stats (--shards for shard layout)
+codespine health                             # index coverage and anomaly dashboard
+codespine self-test                          # smoke queries for schema/translator checks
 codespine list                               # indexed projects
 codespine status                             # service and database status
 codespine guide                              # tool catalog and workflows
@@ -295,7 +316,7 @@ codespine force-reset                        # emergency: delete all data files
 
 `analyse` defaults to incremental mode. Repeat runs only process changed files and are fast.
 
-`analyse` runs in fast mode by default: it indexes the core graph, publishes that read replica from a detached process, then continues communities, flows, dead code, coupling, and cross-module enrichment in the background. Use `--complete --deep` when you want those passes refreshed before the command returns.
+`analyse` runs in fast mode by default: it indexes the core graph, honors the foreground time budget, publishes a read replica, then continues unfinished core indexing or enrichment in the background. Use `codespine background` or `codespine ui` to watch that work. Use `--complete --deep` when you want those passes refreshed before the command returns.
 
 ---
 
@@ -481,7 +502,11 @@ The deep analysis phase covers four passes that are expensive but optional:
 | Dead code | Finds methods with no callers (Java-aware exemptions) | Cleanup audits |
 | Change coupling | Analyses git history for co-changed file pairs | `get_change_coupling`, `related` |
 
-**Fast default:** `codespine analyse` prioritizes a queryable core index. Communities, flows, dead-code, git coupling, and cross-module links are queued in a detached background enrichment job unless you use `--complete`.
+**Fast default:** `codespine analyse` prioritizes a queryable core index and keeps the foreground run inside the configured budget. If core indexing or call/type resolution cannot finish in time, the partial index is published and a background continuation finishes the core graph. Communities, flows, dead-code, git coupling, and cross-module links are queued in a detached background enrichment job unless you use `--complete`.
+
+**Health checks:** every analyse run now performs a small self-test query suite and reports index anomalies such as large projects with zero call edges. Use `codespine health` for the terminal dashboard or `codespine self-test --json` in CI.
+
+**Background visibility:** `codespine background` shows running background job progress in the terminal, and `codespine tasks` remains available as the shorter registry view. `codespine ui` serves a local read-only index explorer with project counts, index health, and the same background task state at `http://127.0.0.1:8765`.
 
 **Complete deep:** `--complete --deep` runs the expensive enrichment passes before returning. `--complete --incremental-deep` combines incremental file indexing with a forced full deep pass.
 

{codespine-1.0.9 → codespine-1.0.11}/codespine/__init__.py

@@ -1,4 +1,4 @@
 """CodeSpine package."""
 
 __all__ = ["__version__"]
-__version__ = "1.0.9"
+__version__ = "1.0.11"