qriton 0.3.0 → 0.3.2

package/README.md

@@ -18,7 +18,7 @@ qriton
 
 `qriton` starts on `qwen3.5:4b`. `qriton --light` uses that model for one bounded session: an 8K context, thinking disabled, and keyword memory. If the pull or the model does not start, run `qriton doctor`.
 
-From the project directory, ask for a change. Qriton CLI shows the edit and waits.
+Open a terminal in the project directory, not your home folder, and ask for a change. Qriton CLI shows the edit and waits. `qriton -C /path/to/your/project` selects that directory from anywhere.
 
 ```text
 Approval · File change
@@ -44,13 +44,13 @@ Qriton CLI keeps the evidence of a coding session attached to the session. You c
 
 **Hopfield recall.** `qriton pull bge-m3` installs the embedding model. With embeddings enabled, recall also reads the query against an energy landscape. A low-energy query matches a known basin. A high-energy query is new. A query between two basins — eureka — returns both. `/memory probe` compares ordinary recall with that reading. Keyword and graph recall remain available without embeddings.
 
-**HLM.** The [HLM workbench](docs/hlm.md) keeps a base model's weights frozen and applies a reversible memory overlay: preview, compare the next token, apply, evaluate, restore. The operation is on the local model. It does not replace the model conducting the coding session.
+**HLM.** The [HLM workbench](https://unpkg.com/qriton/docs/hlm.md) keeps a base model's weights frozen and applies a reversible memory overlay: preview, compare the next token, apply, evaluate, restore. The operation is on the local model. It does not replace the model conducting the coding session.
 
-**Energy Language.** The [Energy Language workbench](docs/energy.md) is programmable memory for a supported Hopfield checkpoint. Edits are staged, evaluated, and restored from bounded scripts. The source checkpoint is preserved.
+**Energy Language.** The [Energy Language workbench](https://unpkg.com/qriton/docs/energy.md) is programmable memory for a supported Hopfield checkpoint. Edits are staged, evaluated, and restored from bounded scripts. The source checkpoint is preserved.
 
 **Research with sources.** `research` queries several angles, reads the selected pages, and returns the passages that address the question, with numbered sources.
 
-**A session you can resume.** `qriton --continue` restores the latest session in this directory. `/sessions` lists them. See [session recovery](docs/session-recovery.md). `qriton capabilities` reports what is installed, without loading a model.
+**A session you can resume.** `qriton --continue` restores the latest session in this directory. `/sessions` lists them. See [session recovery](https://unpkg.com/qriton/docs/session-recovery.md). `qriton capabilities` reports what is installed, without loading a model.
 
 The runtime adds the terminal interface, provider SDKs, Hopfield analysis, and controlled HTTP.
 
@@ -91,7 +91,7 @@ qriton --model openai/gpt-5-mini
 export OPENAI_BASE_URL=https://openrouter.ai/api/v1   # also Groq, vLLM, LM Studio
 ```
 
-Set `network.allowHostedFallback` in user configuration when a hosted model should be available alongside Ollama. A managed machine can run shell, Git, and Python through the container profile in the [deployment guide](docs/production-operations.md).
+Set `network.allowHostedFallback` in user configuration when a hosted model should be available alongside Ollama. A managed machine can run shell, Git, and Python through the container profile in the [deployment guide](https://unpkg.com/qriton/docs/production-operations.md).
 
 Check everything is wired up:
 
@@ -117,7 +117,7 @@ qriton --image shot.png "what is wrong here"
 
 Writes and shell commands are confirmed before they run. Use `/auto on` to run them without approval prompts for this session, and `/auto off` to restore confirmations. `/auto` toggles, and `Shift+Tab` cycles modes only when the composer is empty and idle. In an open list it moves to the previous choice. The footer always shows the current mode and auto-run status.
 
-[Network policy](docs/network-policy.md) can limit destinations to this machine or to an exact list of origins. A restricted profile runs shell, Git, and Python through the [container profile](docs/production-operations.md).
+[Network policy](https://unpkg.com/qriton/docs/network-policy.md) can limit destinations to this machine or to an exact list of origins. A restricted profile runs shell, Git, and Python through the [container profile](https://unpkg.com/qriton/docs/production-operations.md).
 
 You can also use `/mode` or a startup flag:
 
@@ -160,7 +160,7 @@ Choose a discovered server with Enter, or use `/server <url>`. Qriton verifies i
 
 Type `/` to discover commands. `↑`/`↓` moves the highlighted suggestion, `Tab` fills it, and `Esc` closes suggestions without clearing the draft. `Enter` fills a partial command first; press it again to run the completed command. Common options are suggested too: try `/theme `, `/mode `, `/auto `, `/queue ` or `/auth `.
 
-`/sessions` opens a searchable list of conversations in the current workspace. Filter by title, model or ID; use arrows or `Tab`/`Shift+Tab` to navigate, `Enter` to resume, and `Esc` to return. The footer shows shortcuts for the active control. See [terminal interaction principles](docs/terminal-interaction.md) for the keyboard contract and current scope.
+`/sessions` opens a searchable list of conversations in the current workspace. Filter by title, model or ID; use arrows or `Tab`/`Shift+Tab` to navigate, `Enter` to resume, and `Esc` to return. The footer shows shortcuts for the active control. See [terminal interaction principles](https://unpkg.com/qriton/docs/terminal-interaction.md) for the keyboard contract and current scope.
 
 | | |
 |---|---|
@@ -211,7 +211,7 @@ Resuming a session restores its model unless `--model` overrides it. The current
 
 Both are optional and run locally. Python and PyTorch are installed separately. The model conducting the coding session is unchanged.
 
-HLM keeps a published base model frozen and stages a memory overlay. `qriton hlm catalog` lists the releases. The [walkthrough](docs/hlm.md) covers setup.
+HLM keeps a published base model frozen and stages a memory overlay. `qriton hlm catalog` lists the releases. The [walkthrough](https://unpkg.com/qriton/docs/hlm.md) covers setup.
 
 ```sh
 qriton hlm compare hlm5-1b "The capital of Veldoria is"
@@ -221,7 +221,7 @@ qriton hlm evaluate <proposal-id>
 qriton hlm restore <proposal-id>
 ```
 
-Energy Language does the reversible edit for a supported Hopfield checkpoint, using a bounded script. The [guide](docs/energy.md) covers the runtime and the evaluation suite. Apply and restore ask for approval.
+Energy Language does the reversible edit for a supported Hopfield checkpoint, using a bounded script. The [guide](https://unpkg.com/qriton/docs/energy.md) covers the runtime and the evaluation suite. Apply and restore ask for approval.
 
 ```sh
 qriton energy doctor
@@ -251,7 +251,7 @@ Read-only tools run in parallel and never prompt. Everything else is serialised
 
 ## Configuration
 
-`~/.qriton/config.json`, or `.qriton/config.json` in a project to override per workspace. Project configuration requires an explicit grant: run `qriton trust show`, review the file, then `qriton trust grant <fingerprint>`. Changes require a new grant. `qriton doctor policy` inspects effective settings and their origins offline; `/policy` shows the active session. See [workspace configuration trust](docs/workspace-trust.md).
+`~/.qriton/config.json`, or `.qriton/config.json` in a project to override per workspace. Project configuration requires an explicit grant: run `qriton trust show`, review the file, then `qriton trust grant <fingerprint>`. Changes require a new grant. `qriton doctor policy` inspects effective settings and their origins offline; `/policy` shows the active session. See [workspace configuration trust](https://unpkg.com/qriton/docs/workspace-trust.md).
 
 `qriton` already starts on `qwen3.5:4b`. Save this file to keep an 8K context and embeddings for later sessions. `qriton --light` still applies the bounded session for a single run, with keyword memory for that run. The `model` field also accepts `grok-4.6`, `anthropic/claude-opus-5`, `openai/gpt-5-mini`, or any model served through `OPENAI_BASE_URL`.
 
@@ -355,7 +355,7 @@ The `reasoning` setting chooses whether a model's scratchpad is shown in its own
 
 ## Development
 
-Local [Shield scanning](docs/shield.md) checks retrieved content and withholds recognized credentials. `qriton shield status` and `qriton shield scan SKILL.md` run offline.
+Local [Shield scanning](https://unpkg.com/qriton/docs/shield.md) checks retrieved content and withholds recognized credentials. `qriton shield status` and `qriton shield scan SKILL.md` run offline.
 
 ```bash
 npm run dev        # esbuild watch
@@ -369,4 +369,4 @@ npm run typecheck
 
 MIT
 
-The [deployment guide](docs/production-operations.md) covers installation, the container profile, memory authorization, backup and restore, and rollback.
+The [deployment guide](https://unpkg.com/qriton/docs/production-operations.md) covers installation, the container profile, memory authorization, backup and restore, and rollback.