codespine 1.0.8__tar.gz → 1.0.10__tar.gz

{codespine-1.0.8 → codespine-1.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codespine
-Version: 1.0.8
+Version: 1.0.10
 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.10** — 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,22 @@ 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.
+
 Everything at once (ml + community detection):
 
 ```bash
@@ -124,8 +135,7 @@ Downloads and caches the embedding model. Only needed once. After this, `--embed
 codespine analyse /path/to/java-project
 
 # 2. (Optional) Run the expensive deep passes: communities, flows, dead code, coupling
-#    Auto-enabled for repos with ≤ 3,000 files; use --deep to force on larger repos.
-codespine analyse /path/to/java-project --deep
+codespine analyse /path/to/java-project --complete --deep
 
 # 3. (Optional) Add semantic embeddings for concept-level search
 codespine analyse /path/to/java-project --embed
@@ -150,6 +160,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
@@ -313,10 +325,17 @@ Higher-level tools designed to answer full agent questions in a single call, wit
 # Indexing
 codespine analyse <path>                     # incremental index (default)
 codespine analyse <path> --full              # full re-index from scratch
-codespine analyse <path> --deep              # + communities, flows, dead code, coupling
-codespine analyse <path> --incremental-deep  # incremental index + force deep passes
+codespine analyse <path> --budget 90         # fast index with a resolver deadline
+codespine analyse <path> --complete --deep   # + communities, flows, dead code, coupling
+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 +353,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 +381,7 @@ codespine force-reset                        # emergency: delete all data files
 
 `analyse` defaults to incremental mode. Repeat runs only process changed files and are fast.
 
-Deep analysis (`--deep`) now runs automatically for repos with ≤ 3,000 files. For larger repos, pass `--deep` explicitly. Use `--incremental-deep` when you want a fast file-only update but still want communities, flows, dead code, and coupling refreshed.
+`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 `codespine tasks` or `codespine ui` to watch that work. Use `--complete --deep` when you want those passes refreshed before the command returns.
 
 ---
 
@@ -546,12 +567,16 @@ 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` |
 
-**Auto-threshold:** deep analysis runs automatically when the project has ≤ 3,000 Java files. Larger repos get lightweight flow/dead-code passes; full deep analysis requires `--deep`.
+**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`.
+
+**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`.
 
-**Incremental deep:** `--incremental-deep` combines incremental file indexing with a forced full deep pass — useful after large refactors where you want the call graph refreshed quickly but also want updated communities and coupling.
+**Complete deep:** `--complete --deep` runs the expensive enrichment passes before returning. `--complete --incremental-deep` combines incremental file indexing with a forced full deep pass.
 
 ```bash
-codespine analyse . --incremental-deep
+codespine analyse . --complete --incremental-deep
 ```
 
 **Embeddings** (`--embed`) are independent of deep analysis. Without them, BM25 + fuzzy search still works. Add embeddings when you need concept-level retrieval ("find retry logic", "find payment processing").

{codespine-1.0.8 → codespine-1.0.10}/README.md

@@ -1,6 +1,6 @@
 # CodeSpine
 
-**v1.0.0** — Local Java code intelligence for coding agents, backed by a graph database.
+**v1.0.10** — 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,22 @@ 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.
+
 Everything at once (ml + community detection):
 
 ```bash
@@ -59,8 +69,7 @@ Downloads and caches the embedding model. Only needed once. After this, `--embed
 codespine analyse /path/to/java-project
 
 # 2. (Optional) Run the expensive deep passes: communities, flows, dead code, coupling
-#    Auto-enabled for repos with ≤ 3,000 files; use --deep to force on larger repos.
-codespine analyse /path/to/java-project --deep
+codespine analyse /path/to/java-project --complete --deep
 
 # 3. (Optional) Add semantic embeddings for concept-level search
 codespine analyse /path/to/java-project --embed
@@ -85,6 +94,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
@@ -248,10 +259,17 @@ Higher-level tools designed to answer full agent questions in a single call, wit
 # Indexing
 codespine analyse <path>                     # incremental index (default)
 codespine analyse <path> --full              # full re-index from scratch
-codespine analyse <path> --deep              # + communities, flows, dead code, coupling
-codespine analyse <path> --incremental-deep  # incremental index + force deep passes
+codespine analyse <path> --budget 90         # fast index with a resolver deadline
+codespine analyse <path> --complete --deep   # + communities, flows, dead code, coupling
+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 +287,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 +315,7 @@ codespine force-reset                        # emergency: delete all data files
 
 `analyse` defaults to incremental mode. Repeat runs only process changed files and are fast.
 
-Deep analysis (`--deep`) now runs automatically for repos with ≤ 3,000 files. For larger repos, pass `--deep` explicitly. Use `--incremental-deep` when you want a fast file-only update but still want communities, flows, dead code, and coupling refreshed.
+`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 `codespine tasks` or `codespine ui` to watch that work. Use `--complete --deep` when you want those passes refreshed before the command returns.
 
 ---
 
@@ -481,12 +501,16 @@ 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` |
 
-**Auto-threshold:** deep analysis runs automatically when the project has ≤ 3,000 Java files. Larger repos get lightweight flow/dead-code passes; full deep analysis requires `--deep`.
+**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`.
+
+**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`.
 
-**Incremental deep:** `--incremental-deep` combines incremental file indexing with a forced full deep pass — useful after large refactors where you want the call graph refreshed quickly but also want updated communities and coupling.
+**Complete deep:** `--complete --deep` runs the expensive enrichment passes before returning. `--complete --incremental-deep` combines incremental file indexing with a forced full deep pass.
 
 ```bash
-codespine analyse . --incremental-deep
+codespine analyse . --complete --incremental-deep
 ```
 
 **Embeddings** (`--embed`) are independent of deep analysis. Without them, BM25 + fuzzy search still works. Add embeddings when you need concept-level retrieval ("find retry logic", "find payment processing").

{codespine-1.0.8 → codespine-1.0.10}/codespine/__init__.py

@@ -1,4 +1,4 @@
 """CodeSpine package."""
 
 __all__ = ["__version__"]
-__version__ = "1.0.8"
+__version__ = "1.0.10"