From 56b0da0ffd3e9822641b0196bce3a35cb75412c6 Mon Sep 17 00:00:00 2001 From: Sam Date: Sat, 5 Sep 2026 20:49:09 +0200 Subject: [PATCH 1/2] fix(agents): republish @knolo/agents 0.2.1 with GitHub repository URLs Point npm metadata and package README links at HiveForensics-AI/Knolo-Agents. --- CHANGELOG.md | 4 ++-- packages/agents/README.md | 5 +++-- packages/agents/package.json | 2 +- 3 files changed, 6 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ff473e3..7698578 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,8 +14,8 @@ called out explicitly and may evolve without a crates.io release. ### Fixed -- Crate `repository` / `homepage` URLs now point at the public GitHub - repository, so crates.io README documentation links resolve. +- Crate and npm `repository` / `homepage` URLs now point at the public GitHub + repository, so crates.io and npm README documentation links resolve. ## [0.2.0] - 2026-09-05 diff --git a/packages/agents/README.md b/packages/agents/README.md index 4a07c8c..636a9c2 100644 --- a/packages/agents/README.md +++ b/packages/agents/README.md @@ -49,8 +49,9 @@ contracts, Cortex and ClaimGraph injection interfaces, multi-agent authority helpers, and an **ICP canister client** (`IcpAgentRuntimeClient` + candid-aligned DTOs). The ICP client does not hard-depend on `@dfinity/agent`; pass an actor built from your dfx declarations for live calls. See -[`examples/icp-agent-canister/`](../../examples/icp-agent-canister/) and -[architecture documentation](../../docs/architecture/README.md). +[`examples/icp-agent-canister/`](https://github.com/HiveForensics-AI/Knolo-Agents/tree/main/examples/icp-agent-canister) +and +[architecture documentation](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/README.md). ## Development diff --git a/packages/agents/package.json b/packages/agents/package.json index ebfca09..06c7827 100644 --- a/packages/agents/package.json +++ b/packages/agents/package.json @@ -1,6 +1,6 @@ { "name": "@knolo/agents", - "version": "0.2.0", + "version": "0.2.1", "type": "module", "description": "Typed graph builders, explicit TypeScript/WASM adapters, and the additive universal harness for Knolo Agents.", "license": "Apache-2.0", From 7f754d5f8292eee5a4d690c9238870d17acebc67 Mon Sep 17 00:00:00 2001 From: Sam Date: Sat, 5 Sep 2026 20:54:08 +0200 Subject: [PATCH 2/2] fix(docs): use repository-root GitHub URLs in the crate README crates.io was rewriting relative README links under each crate directory, so documentation pages 404'd. Point those links at the repo-root docs. --- CHANGELOG.md | 8 ++++ Cargo.lock | 8 ++-- Cargo.toml | 6 +-- README.md | 100 ++++++++++++++++++++++----------------------- scripts/hygiene.sh | 2 +- 5 files changed, 66 insertions(+), 58 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7698578..50a6ac0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,6 +10,14 @@ called out explicitly and may evolve without a crates.io release. ## [Unreleased] +## [0.2.2] - 2026-09-05 + +### Fixed + +- Crate README documentation links now use repository-root GitHub URLs so + crates.io no longer rewrites them under `crates/knolo-agent-core/` or + `crates/knolo-agent/`. + ## [0.2.1] - 2026-09-05 ### Fixed diff --git a/Cargo.lock b/Cargo.lock index 71c34fe..8c4d2f0 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -385,7 +385,7 @@ checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682" [[package]] name = "knolo-agent" -version = "0.2.1" +version = "0.2.2" dependencies = [ "knolo-agent-core", "serde", @@ -394,7 +394,7 @@ dependencies = [ [[package]] name = "knolo-agent-core" -version = "0.2.1" +version = "0.2.2" dependencies = [ "serde", "serde_json", @@ -403,7 +403,7 @@ dependencies = [ [[package]] name = "knolo-agent-icp" -version = "0.2.1" +version = "0.2.2" dependencies = [ "candid", "ic-cdk", @@ -420,7 +420,7 @@ dependencies = [ [[package]] name = "knolo-agent-wasm" -version = "0.2.1" +version = "0.2.2" dependencies = [ "knolo-agent-core", "serde", diff --git a/Cargo.toml b/Cargo.toml index 2d82cc9..aaf2cad 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -11,11 +11,11 @@ members = [ edition = "2021" license = "Apache-2.0" rust-version = "1.78" -version = "0.2.1" +version = "0.2.2" [workspace.dependencies] -knolo-agent-core = { path = "crates/knolo-agent-core", version = "0.2.1" } -knolo-agent = { path = "crates/knolo-agent", version = "0.2.1" } +knolo-agent-core = { path = "crates/knolo-agent-core", version = "0.2.2" } +knolo-agent = { path = "crates/knolo-agent", version = "0.2.2" } serde = { version = "1", features = ["derive"] } serde_json = "1" sha2 = "0.10" diff --git a/README.md b/README.md index 58ca8cb..85d2e5d 100644 --- a/README.md +++ b/README.md @@ -101,8 +101,8 @@ layer. | `@knolo/core` | Separate peer dependency owned by the consumer; can provide Cortex and ClaimGraph implementations. **Never vendored here.** | The repository does not vendor `@knolo/core`, credentials, retrieval storage, or -provider SDKs. See [docs/architecture/README.md](docs/architecture/README.md) and -[docs/core-boundary.md](docs/core-boundary.md). +provider SDKs. See [docs/architecture/README.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/README.md) and +[docs/core-boundary.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/core-boundary.md). ### Trust boundaries @@ -169,7 +169,7 @@ declared on the node. The runtime rejects: Successful reduction increments the revision once and records provenance (execution id, node id, event sequence). See -[docs/architecture/state-transactions.md](docs/architecture/state-transactions.md). +[docs/architecture/state-transactions.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/state-transactions.md). ### Graph validation @@ -183,7 +183,7 @@ Compilation rejects (among other issues): - invalid read/write paths - non-positive limits -See [docs/architecture/graph-validation.md](docs/architecture/graph-validation.md). +See [docs/architecture/graph-validation.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/graph-validation.md). ### Execution limits @@ -196,7 +196,7 @@ Graphs carry `ExecutionLimitsV1`: Native packs may also declare `budget.max_steps` / `budget.max_cost_micros`. Those fields are validated today; full shared ownership with pack policy is -still evolving (see [FUTURE.md](FUTURE.md)). Tool-level resource budgets are +still evolving (see [FUTURE.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/FUTURE.md)). Tool-level resource budgets are enforced separately via the pack budget ledger. ### What each engine can do @@ -257,7 +257,7 @@ Scenario packs under `examples/packs/` intentionally grant only what each demo needs (`basic`, `tools`, `retrieval`, `checkpoint`, `hitl`, `handoff`, `replay`, `claims`, `cortex`, `wasm`, …). -Full write-up: [docs/packs.md](docs/packs.md). +Full write-up: [docs/packs.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/packs.md). --- @@ -278,7 +278,7 @@ Usage is charged after execution. Denials are structured (`PolicyDenialV1`) and auditable. Resume and live replay require fresh explicit authorization. Host credentials are never serialized into events or checkpoints. -See [docs/policy-enforcement.md](docs/policy-enforcement.md). +See [docs/policy-enforcement.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/policy-enforcement.md). ### Tools @@ -292,7 +292,7 @@ Tools pair a **serializable definition** with a **host-owned implementation**: Implementations remain outside checkpoints. Unit tests should use deterministic local fakes and must not access the network. -See [docs/tools.md](docs/tools.md). +See [docs/tools.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/tools.md). ### Host injection (Rust) @@ -325,7 +325,7 @@ production hosts should provide equivalent durability. Resume verifies **every** artifact hash before accepting typed input. Stale HITL tokens or changed authority fail closed. -See [docs/checkpoints.md](docs/checkpoints.md). +See [docs/checkpoints.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/checkpoints.md). ### Human-in-the-loop (HITL) @@ -357,9 +357,9 @@ Replay never silently upgrades contracts or bypasses current policy. TypeScript `Agent.replay` validates event contiguity; `replayDeterministic` re-runs the portable graph and compares the control-plane trace (excluding wall-clock timestamps). Full per-step state snapshot replay is on the roadmap -([FUTURE.md](FUTURE.md)). +([FUTURE.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/FUTURE.md)). -See [docs/replay.md](docs/replay.md). +See [docs/replay.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/replay.md). --- @@ -373,7 +373,7 @@ content hash). Retrieval is a **policy-gated host capability**, not hidden prompt augmentation. Persist the result or event reference so replay can use recorded evidence without repeating external reads. -See [docs/retrieval.md](docs/retrieval.md). +See [docs/retrieval.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/retrieval.md). ### Cortex and ClaimGraph (`@knolo/core` boundary) @@ -387,7 +387,7 @@ This repository only defines **narrow injection interfaces**. It does not contain core source, storage, credentials, or release process. Consumers install a compatible `@knolo/core` (`^3.5.0` peer on the TypeScript package) themselves. -See [docs/core-boundary.md](docs/core-boundary.md). +See [docs/core-boundary.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/core-boundary.md). --- @@ -506,7 +506,7 @@ const report = await client.startExecution("run-1", { }); ``` -Package README: [packages/agents/README.md](packages/agents/README.md). +Package README: [packages/agents/README.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/packages/agents/README.md). --- @@ -578,16 +578,16 @@ These are **two different** `wasm32-unknown-unknown` products: | 3 | `ic-stable-structures` v1, limits/allowlists, multi-agent handoff, ops queries | | 4 | DX scripts, TypeScript client, cost & security guides | -Local dfx example: [examples/icp-agent-canister/](examples/icp-agent-canister/). +Local dfx example: [examples/icp-agent-canister/](https://github.com/HiveForensics-AI/Knolo-Agents/tree/main/examples/icp-agent-canister/). Architecture docs: -- [ADR-001](docs/architecture/adr-001-icp-agent-runtime.md) -- [Constraints matrix](docs/architecture/icp-constraints-matrix.md) -- [Cost guide](docs/architecture/icp-cost-guide.md) -- [Security checklist](docs/architecture/icp-security-checklist.md) +- [ADR-001](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/adr-001-icp-agent-runtime.md) +- [Constraints matrix](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/icp-constraints-matrix.md) +- [Cost guide](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/icp-cost-guide.md) +- [Security checklist](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/icp-security-checklist.md) -WASM notes: [docs/wasm.md](docs/wasm.md). +WASM notes: [docs/wasm.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/wasm.md). --- @@ -637,14 +637,14 @@ cd examples/icp-agent-canister && bash scripts/run-handoff.sh | Path | Description | | --- | --- | -| [crates/knolo-agent/examples/pack_e2e.rs](crates/knolo-agent/examples/pack_e2e.rs) | Pack → policy → allowed/denied tool → replay | -| [crates/knolo-agent/examples/complete.rs](crates/knolo-agent/examples/complete.rs) | Cortex, ClaimGraph, handoff, replay request shapes | -| [examples/typescript/complete.ts](examples/typescript/complete.ts) | Full TS walkthrough: graph, tools, retrieval, HITL, WASM inspect | -| [examples/packs/](examples/packs/) | Scenario packs (minimal grants per scenario) | -| [examples/icp-agent-canister/](examples/icp-agent-canister/) | dfx deploy, deterministic run, handoff smoke | -| [contracts/](contracts/) | JSON schemas and deterministic fixtures | +| [crates/knolo-agent/examples/pack_e2e.rs](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/crates/knolo-agent/examples/pack_e2e.rs) | Pack → policy → allowed/denied tool → replay | +| [crates/knolo-agent/examples/complete.rs](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/crates/knolo-agent/examples/complete.rs) | Cortex, ClaimGraph, handoff, replay request shapes | +| [examples/typescript/complete.ts](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/examples/typescript/complete.ts) | Full TS walkthrough: graph, tools, retrieval, HITL, WASM inspect | +| [examples/packs/](https://github.com/HiveForensics-AI/Knolo-Agents/tree/main/examples/packs/) | Scenario packs (minimal grants per scenario) | +| [examples/icp-agent-canister/](https://github.com/HiveForensics-AI/Knolo-Agents/tree/main/examples/icp-agent-canister/) | dfx deploy, deterministic run, handoff smoke | +| [contracts/](https://github.com/HiveForensics-AI/Knolo-Agents/tree/main/contracts/) | JSON schemas and deterministic fixtures | -More context: [examples/README.md](examples/README.md). +More context: [examples/README.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/examples/README.md). --- @@ -684,8 +684,8 @@ More context: [examples/README.md](examples/README.md). ## Development -Contributor conventions are in [AGENTS.md](AGENTS.md) and -[CONTRIBUTING.md](CONTRIBUTING.md). +Contributor conventions are in [AGENTS.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/AGENTS.md) and +[CONTRIBUTING.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/CONTRIBUTING.md). ### Commands @@ -713,7 +713,7 @@ bash scripts/hygiene.sh - Do not vendor `@knolo/core` or commit secrets, build artifacts, or editor state. - Preserve public API compatibility unless the change is intentional and documented. -Releases: [docs/releasing.md](docs/releasing.md). +Releases: [docs/releasing.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/releasing.md). --- @@ -725,8 +725,8 @@ Validate all versioned input; deny unknown capabilities; constrain arguments and budgets; redact sensitive event fields; bind resumes to artifact hashes; narrow handoffs; keep secrets only in host memory. -Report vulnerabilities per [SECURITY.md](SECURITY.md). Broader notes: -[docs/security.md](docs/security.md). +Report vulnerabilities per [SECURITY.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/SECURITY.md). Broader notes: +[docs/security.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/security.md). ### Compatibility @@ -737,7 +737,7 @@ Report vulnerabilities per [SECURITY.md](SECURITY.md). Broader notes: - TypeScript: **Node 20+**, optional `@knolo/core` **^3.5.0** - TypeScript and WASM exchange only documented JSON contracts -See [docs/compatibility.md](docs/compatibility.md). +See [docs/compatibility.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/compatibility.md). --- @@ -745,21 +745,21 @@ See [docs/compatibility.md](docs/compatibility.md). | Topic | Document | | --- | --- | -| Docs home | [docs/README.md](docs/README.md) | -| Architecture overview | [docs/architecture/README.md](docs/architecture/README.md) | -| State transactions | [docs/architecture/state-transactions.md](docs/architecture/state-transactions.md) | -| Graph validation | [docs/architecture/graph-validation.md](docs/architecture/graph-validation.md) | -| Packs | [docs/packs.md](docs/packs.md) | -| Policy | [docs/policy-enforcement.md](docs/policy-enforcement.md) | -| Tools | [docs/tools.md](docs/tools.md) | -| Retrieval | [docs/retrieval.md](docs/retrieval.md) | -| Checkpoints | [docs/checkpoints.md](docs/checkpoints.md) | -| Replay | [docs/replay.md](docs/replay.md) | -| WASM | [docs/wasm.md](docs/wasm.md) | -| Core boundary | [docs/core-boundary.md](docs/core-boundary.md) | -| ICP ADR | [docs/architecture/adr-001-icp-agent-runtime.md](docs/architecture/adr-001-icp-agent-runtime.md) | -| Roadmap | [FUTURE.md](FUTURE.md) | -| Changelog | [CHANGELOG.md](CHANGELOG.md) | +| Docs home | [docs/README.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/README.md) | +| Architecture overview | [docs/architecture/README.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/README.md) | +| State transactions | [docs/architecture/state-transactions.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/state-transactions.md) | +| Graph validation | [docs/architecture/graph-validation.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/graph-validation.md) | +| Packs | [docs/packs.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/packs.md) | +| Policy | [docs/policy-enforcement.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/policy-enforcement.md) | +| Tools | [docs/tools.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/tools.md) | +| Retrieval | [docs/retrieval.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/retrieval.md) | +| Checkpoints | [docs/checkpoints.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/checkpoints.md) | +| Replay | [docs/replay.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/replay.md) | +| WASM | [docs/wasm.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/wasm.md) | +| Core boundary | [docs/core-boundary.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/core-boundary.md) | +| ICP ADR | [docs/architecture/adr-001-icp-agent-runtime.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/docs/architecture/adr-001-icp-agent-runtime.md) | +| Roadmap | [FUTURE.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/FUTURE.md) | +| Changelog | [CHANGELOG.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/CHANGELOG.md) | --- @@ -783,10 +783,10 @@ The project is an early **0.1.x** release. - Production multi-agent and live-core examples - Evaluation harnesses and pre-1.0 API freeze -Details: [FUTURE.md](FUTURE.md). +Details: [FUTURE.md](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/FUTURE.md). --- ## License -Apache License 2.0. See [LICENSE](LICENSE). +Apache License 2.0. See [LICENSE](https://github.com/HiveForensics-AI/Knolo-Agents/blob/main/LICENSE). diff --git a/scripts/hygiene.sh b/scripts/hygiene.sh index ff3ac10..cf258a8 100755 --- a/scripts/hygiene.sh +++ b/scripts/hygiene.sh @@ -12,7 +12,7 @@ done # Product comparisons are allowed in README prose; legacy integrations, # credentials, and source-level identity references remain forbidden. legacy="lang"'chain|lang'"graph|lang"'smith|HiveForensics-AI|LANGCHAIN_API_KEY|LANGSMITH_API_KEY' -if git grep -IniE "$legacy" -- ':!scripts/hygiene.sh' ':!README.md' ':!**/Cargo.toml' ':!**/package.json'; then echo "forbidden legacy identity" >&2; exit 1; fi +if git grep -IniE "$legacy" -- ':!scripts/hygiene.sh' ':!README.md' ':!**/README.md' ':!**/Cargo.toml' ':!**/package.json'; then echo "forbidden legacy identity" >&2; exit 1; fi if find . -type l -print -quit | grep -q .; then echo "symlinks require explicit review" >&2; exit 1; fi for dir in node_modules target dist .venv coverage; do if find . -type d -name "$dir" -not -path './.git/*' -print -quit | grep -q .; then echo "generated directory present: $dir" >&2; exit 1; fi