@untangle-code/cli 0.1.0 → 0.1.1

package/README.md

@@ -3,34 +3,60 @@
 Untangle's CLI and MCP entry point: the **`untangle`** binary. It connects local search,
 code complexity and declared feature responsibility. Requires Node.js **`^22.13.0 || >=24.0.0`**.
 
-The first public release is being prepared. The recorded public lookup on 2 November 2026
-returned `E404` for `@untangle-code/cli@0.1.0`; this is not a current availability or scope-rights
-claim. Until publication, use an available checkout. One CLI tarball does not publish its
-Untangle dependencies. The [release guide](https://github.com/lboel/untangle/blob/main/docs/RELEASE.md)
-separates local acceptance, remote matrix and actual publication.
-
 The [agent workflow](https://github.com/lboel/untangle/blob/main/docs/AGENT_WORKFLOW.md)
 connects MCP, search, complete feature scopes and real tests, with a copyable task brief for
 spec-driven development and agentic engineering.
 
-## Installed CLI — after registry publication
+## Install in an npm project
+
+From the directory containing your project's `package.json`, add Untangle as a pinned
+development dependency and run a first analysis.
+
+```bash
+npm install --save-dev --save-exact @untangle-code/cli@0.1.1
+npm exec -- untangle --version
+npm exec -- untangle complexity --top=10
+```
+
+Direct complexity analysis runs on the current project without an index or search services.
+Commit the manifest and lockfile changes to share the version with your team.
+
+Preview the project setup, then create `untangle.toml` when you're ready.
+
+```bash
+npm exec -- untangle init --offline --dry-run
+npm exec -- untangle init --offline
+```
+
+Offline init inspects local files and skips network probes. Dry-run previews the
+configuration. The second command creates it in a new project and reports any differences
+with an existing configuration.
+
+## Try it in any repository
 
-After `@untangle-code/cli@0.1.0` and its Untangle dependencies are published to npm, use
-this version-pinned entry point without a global installation. Replace the project path:
+Run a one-off analysis from a project directory, including repositories without a `package.json`.
 
 ```bash
-npm exec --yes --package=@untangle-code/cli@0.1.0 -- \
-  untangle complexity --root=/absolute/path/to/project --format=json
+npm exec --yes --package=@untangle-code/cli@0.1.1 -- untangle complexity --top=10
+```
+
+`npm exec` fetches the package into the npm cache if needed. To preview setup the same way,
+replace `complexity --top=10` with `init --offline --dry-run`.
 
-npm exec --yes --package=@untangle-code/cli@0.1.0 -- \
-  untangle init --root=/absolute/path/to/project --offline --dry-run --format=json
+## Install once for multiple projects
+
+Install the npm preview globally if you prefer to run `untangle` directly from each project.
+
+```bash
+npm install --global @untangle-code/cli@next
+untangle --version
+cd /path/to/your/project
+untangle complexity --top=10
 ```
 
-`npm exec` may download the package. Direct complexity analysis needs no search services;
-the offline init dry-run previews configuration without writing files or probing services.
-The checkout helper below is a separate way to build and try an unpublished version.
+For a project installation, prefix the `untangle` examples below with `npm exec --`.
 
-## First checkout result
+## Build from a source checkout
 
 From the checkout root with **pnpm 10.34.5**:
 
@@ -216,7 +242,8 @@ roles, not human approval or an objective feature-richness score.
 | `mcp` | Implemented: stdio runtime; specified unbuilt capabilities explicitly unavailable. |
 
 Command specifications/`--help` are executable truth. Registered but unbuilt MCP tools return
-`FEATURE_UNAVAILABLE`. An explicit-root MCP template:
+`FEATURE_UNAVAILABLE`. For a project installation, configure the MCP host with the absolute
+paths to your Node executable, installed CLI and project root.
 
 ```json
 {
@@ -224,7 +251,7 @@ Command specifications/`--help` are executable truth. Registered but unbuilt MCP
     "untangle": {
       "command": "/absolute/path/to/node",
       "args": [
-        "/absolute/path/to/untangle/apps/cli/dist/index.js",
+        "/path/to/your/project/node_modules/@untangle-code/cli/dist/index.js",
         "mcp",
         "--stdio",
         "--root=/path/to/your/project"

package/dist/cli/version.d.ts

@@ -1,3 +1,3 @@
 /** Package version shared by the CLI and its MCP entry point. */
-export declare const CLI_VERSION = "0.1.0";
+export declare const CLI_VERSION = "0.1.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 /** Package version shared by the CLI and its MCP entry point. */
-export const CLI_VERSION = "0.1.0";
+export const CLI_VERSION = "0.1.1";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@untangle-code/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": false,
   "type": "module",
   "description": "Local search and complexity harness for coding agents: code graphs, declared feature ownership and spec-to-code evidence.",
@@ -64,32 +64,32 @@
   "dependencies": {
     "@modelcontextprotocol/server": "2.0.0",
     "zod": "4.5.4",
-    "@untangle-code/chunker": "0.1.0",
-    "@untangle-code/complexity": "0.1.0",
-    "@untangle-code/config": "0.1.0",
-    "@untangle-code/core": "0.1.0",
-    "@untangle-code/domain": "0.1.0",
-    "@untangle-code/embeddings-ollama": "0.1.0",
-    "@untangle-code/extension-runtime": "0.1.0",
-    "@untangle-code/file-graph": "0.1.0",
-    "@untangle-code/graph-explorer": "0.1.0",
-    "@untangle-code/jobs": "0.1.0",
-    "@untangle-code/observability": "0.1.0",
-    "@untangle-code/parser-registry": "0.1.0",
-    "@untangle-code/scanner": "0.1.0",
-    "@untangle-code/search": "0.1.0",
-    "@untangle-code/storage-local": "0.1.0",
-    "@untangle-code/storage-lancedb": "0.1.0",
-    "@untangle-code/storage-qdrant": "0.1.0",
-    "@untangle-code/symbol-graph": "0.1.0",
-    "@untangle-code/watcher": "0.1.0"
+    "@untangle-code/chunker": "0.1.1",
+    "@untangle-code/complexity": "0.1.1",
+    "@untangle-code/config": "0.1.1",
+    "@untangle-code/domain": "0.1.1",
+    "@untangle-code/core": "0.1.1",
+    "@untangle-code/embeddings-ollama": "0.1.1",
+    "@untangle-code/extension-runtime": "0.1.1",
+    "@untangle-code/file-graph": "0.1.1",
+    "@untangle-code/jobs": "0.1.1",
+    "@untangle-code/graph-explorer": "0.1.1",
+    "@untangle-code/observability": "0.1.1",
+    "@untangle-code/parser-registry": "0.1.1",
+    "@untangle-code/scanner": "0.1.1",
+    "@untangle-code/search": "0.1.1",
+    "@untangle-code/storage-lancedb": "0.1.1",
+    "@untangle-code/storage-local": "0.1.1",
+    "@untangle-code/storage-qdrant": "0.1.1",
+    "@untangle-code/symbol-graph": "0.1.1",
+    "@untangle-code/watcher": "0.1.1"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "2.0.0",
     "@types/node": "22.19.7",
     "typescript": "5.9.3",
     "vitest": "3.2.7",
-    "@untangle-code/testkit": "0.1.0"
+    "@untangle-code/testkit": "0.1.1"
   },
   "scripts": {
     "pretest": "pnpm run build",

package/src/cli/version.ts

@@ -1,2 +1,2 @@
 /** Package version shared by the CLI and its MCP entry point. */
-export const CLI_VERSION = "0.1.0";
+export const CLI_VERSION = "0.1.1";