From fa2faf408dca33ef1de41bb85e85b03b6d792f3c Mon Sep 17 00:00:00 2001 From: simianastronaut Date: Sat, 7 Mar 2026 21:05:23 -0500 Subject: [PATCH 01/35] chore: update .gitignore, CODEOWNERS, and dependabot configuration - Add .zeroclaw/* to .gitignore to exclude ZeroClaw files from version control. - Update CODEOWNERS to include @SimianAstronaut7 as a maintainer alongside @jordanthejet. - Change dependabot target branch from dev to master for all update configurations. - Revise master-branch-flow documentation to clarify active workflows and triggers. --- .github/CODEOWNERS | 2 +- .github/dependabot.yml | 6 +- .github/workflows/README.md | 17 +- .github/workflows/master-branch-flow.md | 261 +++++++----------------- .gitignore | 1 + 5 files changed, 86 insertions(+), 201 deletions(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 7bd42b5ac..9925ba495 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -1,5 +1,5 @@ # Default owner for all files -* @jordanthejet +* @jordanthejet @SimianAstronaut7 # Important functional modules /src/agent/** @theonlyhennygod diff --git a/.github/dependabot.yml b/.github/dependabot.yml index 166552a71..e797d7089 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -5,7 +5,7 @@ updates: directory: "/" schedule: interval: daily - target-branch: dev + target-branch: master open-pull-requests-limit: 3 labels: - "dependencies" @@ -21,7 +21,7 @@ updates: directory: "/" schedule: interval: daily - target-branch: dev + target-branch: master open-pull-requests-limit: 1 labels: - "ci" @@ -38,7 +38,7 @@ updates: directory: "/" schedule: interval: daily - target-branch: dev + target-branch: master open-pull-requests-limit: 1 labels: - "ci" diff --git a/.github/workflows/README.md b/.github/workflows/README.md index 8ccbcb769..9347bf356 100644 --- a/.github/workflows/README.md +++ b/.github/workflows/README.md @@ -10,21 +10,8 @@ Subdirectories are not valid locations for workflow entry files. Repository convention: 1. Keep runnable workflow entry files at `.github/workflows/` root. -2. Keep workflow-only helper scripts under `.github/workflows/scripts/`. -3. Keep cross-tooling/local CI scripts under `scripts/ci/` when they are used outside Actions. +2. Keep cross-tooling/local CI scripts under `dev/` or `scripts/ci/` when used outside Actions. Workflow behavior documentation in this directory: -- `.github/workflows/main-branch-flow.md` - -Current workflow helper scripts: - -- `.github/workflows/scripts/ci_workflow_owner_approval.js` -- `.github/workflows/scripts/ci_license_file_owner_guard.js` -- `.github/workflows/scripts/lint_feedback.js` -- `.github/workflows/scripts/pr_auto_response_contributor_tier.js` -- `.github/workflows/scripts/pr_auto_response_labeled_routes.js` -- `.github/workflows/scripts/pr_check_status_nudge.js` -- `.github/workflows/scripts/pr_intake_checks.js` -- `.github/workflows/scripts/pr_labeler.js` -- `.github/workflows/scripts/test_benchmarks_pr_comment.js` +- `.github/workflows/master-branch-flow.md` diff --git a/.github/workflows/master-branch-flow.md b/.github/workflows/master-branch-flow.md index d790780bd..12d70a72e 100644 --- a/.github/workflows/master-branch-flow.md +++ b/.github/workflows/master-branch-flow.md @@ -14,174 +14,72 @@ ZeroClaw uses a single default branch: `master`. All contributor PRs target `mas Current maintainers with PR approval authority: `theonlyhennygod` and `jordanthejet`. +## Active Workflows + +| File | Trigger | Purpose | +| --- | --- | --- | +| `ci.yml` | `pull_request` → `master` | Test + build check on every PR | +| `ci-full.yml` | `workflow_dispatch` | Full platform build matrix (manual) | +| `release.yml` | `push` → `master` | Beta release on every master commit | +| `promote-release.yml` | `workflow_dispatch` | Stable release (manual, version-gated) | + ## Event Summary -| Event | Main workflows | +| Event | Workflows triggered | | --- | --- | -| PR activity (`pull_request_target`) | `pr-intake-checks.yml`, `pr-labeler.yml`, `pr-auto-response.yml` | -| PR activity (`pull_request`) | `ci-run.yml`, `sec-audit.yml`, plus path-scoped workflows | -| Push to `master` | `ci-run.yml`, `sec-audit.yml`, plus path-scoped workflows | -| Tag push (`v*`) | `pub-release.yml` publish mode, `pub-docker-img.yml` publish job | -| Scheduled/manual | `pub-release.yml` verification mode, `pub-homebrew-core.yml` (manual), `sec-codeql.yml`, `feature-matrix.yml`, `test-fuzz.yml`, `pr-check-stale.yml`, `pr-check-status.yml`, `sync-contributors.yml`, `test-benchmarks.yml`, `test-e2e.yml` | - -## Runtime and Docker Matrix - -Observed averages below are from recent completed runs (sampled from GitHub Actions on February 17, 2026). Values are directional, not SLA. - -| Workflow | Typical trigger in main flow | Avg runtime | Docker build? | Docker run? | Docker push? | -| --- | --- | ---:| --- | --- | --- | -| `pr-intake-checks.yml` | PR open/update (`pull_request_target`) | 14.5s | No | No | No | -| `pr-labeler.yml` | PR open/update (`pull_request_target`) | 53.7s | No | No | No | -| `pr-auto-response.yml` | PR/issue automation | 24.3s | No | No | No | -| `ci-run.yml` | PR + push to `master` | 74.7s | No | No | No | -| `sec-audit.yml` | PR + push to `master` | 127.2s | No | No | No | -| `workflow-sanity.yml` | Workflow-file changes | 34.2s | No | No | No | -| `pr-label-policy-check.yml` | Label policy/automation changes | 14.7s | No | No | No | -| `pub-docker-img.yml` (`pull_request`) | Docker build-input PR changes | 240.4s | Yes | Yes | No | -| `pub-docker-img.yml` (`push`) | tag push `v*` | 139.9s | Yes | No | Yes | -| `pub-release.yml` | Tag push `v*` (publish) + manual/scheduled verification (no publish) | N/A in recent sample | No | No | No | -| `pub-homebrew-core.yml` | Manual workflow dispatch only | N/A in recent sample | No | No | No | - -Notes: - -1. `pub-docker-img.yml` is the only workflow in the main PR/push path that builds Docker images. -2. Container runtime verification (`docker run`) occurs in PR smoke only. -3. Container registry push occurs on tag pushes (`v*`) only. -4. `ci-run.yml` "Build (Smoke)" builds Rust binaries, not Docker images. +| PR opened or updated against `master` | `ci.yml` | +| Push to `master` (including after merge) | `release.yml` | +| Manual dispatch | `ci-full.yml`, `promote-release.yml` | ## Step-By-Step -### 1) PR from branch in this repository -> `master` +### 1) PR → `master` -1. Contributor opens or updates PR against `master`. -2. `pull_request_target` automation runs (typical runtime): - - `pr-intake-checks.yml` posts intake warnings/errors. - - `pr-labeler.yml` sets size/risk/scope labels. - - `pr-auto-response.yml` runs first-interaction and label routes. -3. `pull_request` CI workflows start: - - `ci-run.yml` - - `sec-audit.yml` - - path-scoped workflows if matching files changed: - - `pub-docker-img.yml` (Docker build-input paths only) - - `workflow-sanity.yml` (workflow files only) - - `pr-label-policy-check.yml` (label-policy files only) -4. In `ci-run.yml`, `changes` computes: - - `docs_only` - - `docs_changed` - - `rust_changed` - - `workflow_changed` -5. `build` runs for Rust-impacting changes. -6. On PRs, full lint/test/docs checks run when PR has label `ci:full`: - - `lint` - - `lint-strict-delta` - - `test` - - `docs-quality` -7. If `.github/workflows/**` changed, `workflow-owner-approval` must pass. -8. `lint-feedback` posts actionable comment if lint/docs gates fail. -9. `CI Required Gate` aggregates results to final pass/fail. -10. Maintainer (`theonlyhennygod` or `jordanthejet`) merges PR once checks and review policy are satisfied. -11. Merge emits a `push` event on `master` (see scenario 3). +1. Contributor opens or updates a PR against `master`. +2. `ci.yml` starts: + - `test` job: runs `cargo nextest run --locked` on `ubuntu-latest` with Rust 1.92.0 and mold linker. + - `build` job (matrix): compiles release binary on `x86_64-unknown-linux-gnu` and `aarch64-apple-darwin`. + - Concurrency group cancels in-progress runs for the same PR on new pushes. +3. All jobs must pass before merge. +4. Maintainer (`theonlyhennygod` or `jordanthejet`) merges PR once checks and review policy are satisfied. +5. Merge emits a `push` event on `master` (see section 2). -### 2) PR from fork -> `master` +### 2) Push to `master` (including after merge) -1. External contributor opens PR from `fork/` into `zeroclaw:master`. -2. Immediately on `opened`: - - `pull_request_target` workflows start with base-repo context and base-repo token: - - `pr-intake-checks.yml` - - `pr-labeler.yml` - - `pr-auto-response.yml` - - `pull_request` workflows are queued for the fork head commit: - - `ci-run.yml` - - `sec-audit.yml` - - path-scoped workflows (`pub-docker-img.yml`, `workflow-sanity.yml`, `pr-label-policy-check.yml`) if changed files match. -3. Fork-specific permission behavior in `pull_request` workflows: - - token is restricted (read-focused), so jobs that try to write PR comments/status extras can be limited. - - secrets from the base repo are not exposed to fork PR `pull_request` jobs. -4. Approval gate possibility: - - if Actions settings require maintainer approval for fork workflows, the `pull_request` run stays in `action_required`/waiting state until approved. -5. Event fan-out after labeling: - - `pr-labeler.yml` and manual label changes emit `labeled`/`unlabeled` events. - - those events retrigger `pull_request_target` automation (`pr-labeler.yml` and `pr-auto-response.yml`), creating extra run volume/noise. -6. When contributor pushes new commits to fork branch (`synchronize`): - - reruns: `pr-intake-checks.yml`, `pr-labeler.yml`, `ci-run.yml`, `sec-audit.yml`, and matching path-scoped PR workflows. - - does not rerun `pr-auto-response.yml` unless label/open events occur. -7. `ci-run.yml` execution details for fork PR: - - `changes` computes `docs_only`, `docs_changed`, `rust_changed`, `workflow_changed`. - - `build` runs for Rust-impacting changes. - - `lint`/`lint-strict-delta`/`test`/`docs-quality` run on PR when `ci:full` label exists. - - `workflow-owner-approval` runs when `.github/workflows/**` changed. - - `CI Required Gate` emits final pass/fail for the PR head. -8. Fork PR merge blockers to check first when diagnosing stalls: - - run approval pending for fork workflows. - - `workflow-owner-approval` failing on workflow-file changes. - - `CI Required Gate` failure caused by upstream jobs. - - repeated `pull_request_target` reruns from label churn causing noisy signals. -9. After merge, normal `push` workflows on `master` execute (scenario 3). +1. Commit reaches `master`. +2. `release.yml` (Beta Release) starts: + - `version` job: computes beta tag as `v{cargo_version}-beta.{run_number}`. + - `build` job (matrix, 4 targets): `x86_64-linux`, `aarch64-linux`, `aarch64-darwin`, `x86_64-windows`. + - `publish` job: generates `SHA256SUMS`, creates a GitHub pre-release with all artifacts. Artifact retention: 7 days. + - `docker` job: builds multi-platform image (`linux/amd64,linux/arm64`) and pushes to `ghcr.io` with `:beta` and the versioned beta tag. +3. This runs on every push to `master` without filtering. Every merged PR produces a beta pre-release. -### 3) Push to `master` (including after merge) +### 3) Stable Release (manual) -1. Commit reaches `master` (usually from a merged PR). -2. `ci-run.yml` runs on `push`. -3. `sec-audit.yml` runs on `push`. -4. Path-filtered workflows run only if touched files match their filters. -5. In `ci-run.yml`, push behavior differs from PR behavior: - - Rust path: `lint`, `lint-strict-delta`, `test`, `build` are expected. - - Docs/non-rust paths: fast-path behavior applies. -6. `CI Required Gate` computes overall push result. +1. Maintainer runs `promote-release.yml` via `workflow_dispatch` with a version input (e.g. `0.2.0`). +2. `validate` job checks: + - Input matches semver `X.Y.Z` format. + - `Cargo.toml` version matches input exactly. + - Tag `vX.Y.Z` does not already exist on the remote. +3. `build` job (matrix, same 4 targets as beta): compiles release binary. +4. `publish` job: generates `SHA256SUMS`, creates a stable GitHub Release (not pre-release). Artifact retention: 14 days. +5. `docker` job: pushes to `ghcr.io` with `:latest` and `:vX.Y.Z`. -## Docker Publish Logic +### 4) Full Platform Build (manual) -Workflow: `.github/workflows/pub-docker-img.yml` +1. Maintainer runs `ci-full.yml` via `workflow_dispatch`. +2. `build` job (matrix, 3 targets): `aarch64-linux-gnu`, `x86_64-darwin` (macOS 15 Intel), `x86_64-windows-msvc`. +3. Build-only, no tests, no publish. Used to verify cross-compilation on platforms not covered by `ci.yml`. -### PR behavior +## Build Targets by Workflow -1. Triggered on `pull_request` to `master` when Docker build-input paths change. -2. Runs `PR Docker Smoke` job: - - Builds local smoke image with Blacksmith builder. - - Verifies container with `docker run ... --version`. -3. Typical runtime in recent sample: ~240.4s. -4. No registry push happens on PR events. - -### Push behavior - -1. `publish` job runs on tag pushes `v*` only. -2. Workflow trigger includes semantic version tag pushes (`v*`) only. -3. Login to `ghcr.io` uses `${{ github.actor }}` and `${{ secrets.GITHUB_TOKEN }}`. -4. Tag computation includes semantic tag from pushed git tag (`vX.Y.Z`) + SHA tag. -5. Multi-platform publish is used for tag pushes (`linux/amd64,linux/arm64`). -6. Typical runtime in recent sample: ~139.9s. -7. Result: pushed image tags under `ghcr.io//`. - -Important: Docker publish requires a `v*` tag push; regular `master` branch pushes do not publish images. - -## Release Logic - -Workflow: `.github/workflows/pub-release.yml` - -1. Trigger modes: - - Tag push `v*` -> publish mode. - - Manual dispatch -> verification-only or publish mode (input-driven). - - Weekly schedule -> verification-only mode. -2. `prepare` resolves release context (`release_ref`, `release_tag`, publish/draft mode) and validates manual publish inputs. - - publish mode enforces `release_tag` == `Cargo.toml` version at the tag commit. -3. `build-release` builds matrix artifacts across Linux/macOS/Windows targets. -4. `verify-artifacts` enforces presence of all expected archives before any publish attempt. -5. In publish mode, workflow generates SBOM (`CycloneDX` + `SPDX`), `SHA256SUMS`, keyless cosign signatures, and verifies GHCR release-tag availability. -6. In publish mode, workflow creates/updates the GitHub Release for the resolved tag and commit-ish. - -Manual Homebrew formula flow: - -1. Run `.github/workflows/pub-homebrew-core.yml` with `release_tag=vX.Y.Z`. -2. Use `dry_run=true` first to validate formula patch and metadata. -3. Use `dry_run=false` to push from bot fork and open `homebrew-core` PR. - -## Merge/Policy Notes - -1. Workflow-file changes (`.github/workflows/**`) activate owner-approval gate in `ci-run.yml`. -2. PR lint/test strictness is intentionally controlled by `ci:full` label. -3. `sec-audit.yml` runs on both PR and push, plus scheduled weekly. -4. Some workflows are operational and non-merge-path (`pr-check-stale`, `pr-check-status`, `sync-contributors`, etc.). -5. Workflow-specific JavaScript helpers are organized under `.github/workflows/scripts/`. +| Target | `ci.yml` | `ci-full.yml` | `release.yml` | `promote-release.yml` | +| --- | :---: | :---: | :---: | :---: | +| `x86_64-unknown-linux-gnu` | ✓ | | ✓ | ✓ | +| `aarch64-unknown-linux-gnu` | | ✓ | ✓ | ✓ | +| `aarch64-apple-darwin` | ✓ | | ✓ | ✓ | +| `x86_64-apple-darwin` | | ✓ | | | +| `x86_64-pc-windows-msvc` | | ✓ | ✓ | ✓ | ## Mermaid Diagrams @@ -189,41 +87,40 @@ Manual Homebrew formula flow: ```mermaid flowchart TD - A["PR opened or updated -> master"] --> B["pull_request_target lane"] - B --> B1["pr-intake-checks.yml"] - B --> B2["pr-labeler.yml"] - B --> B3["pr-auto-response.yml"] - A --> C["pull_request CI lane"] - C --> C1["ci-run.yml"] - C --> C2["sec-audit.yml"] - C --> C3["pub-docker-img.yml (if Docker paths changed)"] - C --> C4["workflow-sanity.yml (if workflow files changed)"] - C --> C5["pr-label-policy-check.yml (if policy files changed)"] - C1 --> D["CI Required Gate"] - D --> E{"Checks + review policy pass?"} - E -->|No| F["PR stays open"] - E -->|Yes| G["Merge PR"] - G --> H["push event on master"] + A["PR opened or updated → master"] --> B["ci.yml"] + B --> B1["test: cargo nextest (ubuntu-latest)"] + B --> B2["build: x86_64-linux + aarch64-darwin"] + B1 & B2 --> C{"Checks pass?"} + C -->|No| D["PR stays open"] + C -->|Yes| E["Maintainer merges"] + E --> F["push event on master"] ``` -### Release +### Beta Release (on every master push) ```mermaid flowchart TD - A["Commit reaches master"] --> B["ci-run.yml"] - A --> C["sec-audit.yml"] - A --> D["path-scoped workflows (if matched)"] - T["Tag push v*"] --> R["pub-release.yml"] - W["Manual/Scheduled release verify"] --> R - T --> P["pub-docker-img.yml publish job"] - R --> R1["Artifacts + SBOM + checksums + signatures + GitHub Release"] - W --> R2["Verification build only (no GitHub Release publish)"] - P --> P1["Push ghcr image tags (version + sha)"] + A["Push to master"] --> B["release.yml"] + B --> B1["version: compute v{x.y.z}-beta.{N}"] + B1 --> B2["build: 4 targets"] + B2 --> B3["publish: GitHub pre-release + SHA256SUMS"] + B2 --> B4["docker: push ghcr.io :beta + versioned tag"] +``` + +### Stable Release (manual) + +```mermaid +flowchart TD + A["workflow_dispatch: version=X.Y.Z"] --> B["promote-release.yml"] + B --> B1["validate: semver + Cargo.toml + tag uniqueness"] + B1 --> B2["build: 4 targets"] + B2 --> B3["publish: GitHub stable release + SHA256SUMS"] + B2 --> B4["docker: push ghcr.io :latest + :vX.Y.Z"] ``` ## Quick Troubleshooting -1. Unexpected skipped jobs: inspect `scripts/ci/detect_change_scope.sh` outputs. -2. Workflow-change PR blocked: verify `WORKFLOW_OWNER_LOGINS` and approvals. -3. Fork PR appears stalled: check whether Actions run approval is pending. -4. Docker not published: confirm a `v*` tag was pushed to the intended commit. +1. **CI failing on PR**: check `test` job logs for test failures; check `build` job for compile errors. +2. **Beta release not appearing**: confirm the push landed on `master` (not another branch); check `release.yml` run status. +3. **Promote release failing at validate**: ensure `Cargo.toml` version matches the input version and the tag does not already exist. +4. **Full matrix build needed**: run `ci-full.yml` manually from the Actions tab. diff --git a/.gitignore b/.gitignore index 89a1f8b5b..30fbb817d 100644 --- a/.gitignore +++ b/.gitignore @@ -29,3 +29,4 @@ venv/ *.pem credentials.json .worktrees/ +.zeroclaw/* From 8c0375a9ba792eacacb66049593f0c6deb6c3a07 Mon Sep 17 00:00:00 2001 From: simianastronaut Date: Sat, 7 Mar 2026 21:39:10 -0500 Subject: [PATCH 02/35] Skill Creator (from anthropic) --- .claude/skills/skill-creator/LICENSE.txt | 202 +++ .claude/skills/skill-creator/SKILL.md | 485 ++++++ .../skills/skill-creator/agents/analyzer.md | 274 ++++ .../skills/skill-creator/agents/comparator.md | 202 +++ .claude/skills/skill-creator/agents/grader.md | 223 +++ .../skill-creator/assets/eval_review.html | 146 ++ .../eval-viewer/generate_review.py | 471 ++++++ .../skill-creator/eval-viewer/viewer.html | 1325 +++++++++++++++++ .../skill-creator/references/schemas.md | 430 ++++++ .../skills/skill-creator/scripts/__init__.py | 0 .../scripts/aggregate_benchmark.py | 401 +++++ .../skill-creator/scripts/generate_report.py | 326 ++++ .../scripts/improve_description.py | 247 +++ .../skill-creator/scripts/package_skill.py | 136 ++ .../skill-creator/scripts/quick_validate.py | 103 ++ .../skills/skill-creator/scripts/run_eval.py | 310 ++++ .../skills/skill-creator/scripts/run_loop.py | 328 ++++ .claude/skills/skill-creator/scripts/utils.py | 47 + 18 files changed, 5656 insertions(+) create mode 100644 .claude/skills/skill-creator/LICENSE.txt create mode 100644 .claude/skills/skill-creator/SKILL.md create mode 100644 .claude/skills/skill-creator/agents/analyzer.md create mode 100644 .claude/skills/skill-creator/agents/comparator.md create mode 100644 .claude/skills/skill-creator/agents/grader.md create mode 100644 .claude/skills/skill-creator/assets/eval_review.html create mode 100644 .claude/skills/skill-creator/eval-viewer/generate_review.py create mode 100644 .claude/skills/skill-creator/eval-viewer/viewer.html create mode 100644 .claude/skills/skill-creator/references/schemas.md create mode 100644 .claude/skills/skill-creator/scripts/__init__.py create mode 100755 .claude/skills/skill-creator/scripts/aggregate_benchmark.py create mode 100755 .claude/skills/skill-creator/scripts/generate_report.py create mode 100755 .claude/skills/skill-creator/scripts/improve_description.py create mode 100755 .claude/skills/skill-creator/scripts/package_skill.py create mode 100755 .claude/skills/skill-creator/scripts/quick_validate.py create mode 100755 .claude/skills/skill-creator/scripts/run_eval.py create mode 100755 .claude/skills/skill-creator/scripts/run_loop.py create mode 100644 .claude/skills/skill-creator/scripts/utils.py diff --git a/.claude/skills/skill-creator/LICENSE.txt b/.claude/skills/skill-creator/LICENSE.txt new file mode 100644 index 000000000..7a4a3ea24 --- /dev/null +++ b/.claude/skills/skill-creator/LICENSE.txt @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. \ No newline at end of file diff --git a/.claude/skills/skill-creator/SKILL.md b/.claude/skills/skill-creator/SKILL.md new file mode 100644 index 000000000..65b3a402d --- /dev/null +++ b/.claude/skills/skill-creator/SKILL.md @@ -0,0 +1,485 @@ +--- +name: skill-creator +description: Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. +--- + +# Skill Creator + +A skill for creating new skills and iteratively improving them. + +At a high level, the process of creating a skill goes like this: + +- Decide what you want the skill to do and roughly how it should do it +- Write a draft of the skill +- Create a few test prompts and run claude-with-access-to-the-skill on them +- Help the user evaluate the results both qualitatively and quantitatively + - While the runs happen in the background, draft some quantitative evals if there aren't any (if there are some, you can either use as is or modify if you feel something needs to change about them). Then explain them to the user (or if they already existed, explain the ones that already exist) + - Use the `eval-viewer/generate_review.py` script to show the user the results for them to look at, and also let them look at the quantitative metrics +- Rewrite the skill based on feedback from the user's evaluation of the results (and also if there are any glaring flaws that become apparent from the quantitative benchmarks) +- Repeat until you're satisfied +- Expand the test set and try again at larger scale + +Your job when using this skill is to figure out where the user is in this process and then jump in and help them progress through these stages. So for instance, maybe they're like "I want to make a skill for X". You can help narrow down what they mean, write a draft, write the test cases, figure out how they want to evaluate, run all the prompts, and repeat. + +On the other hand, maybe they already have a draft of the skill. In this case you can go straight to the eval/iterate part of the loop. + +Of course, you should always be flexible and if the user is like "I don't need to run a bunch of evaluations, just vibe with me", you can do that instead. + +Then after the skill is done (but again, the order is flexible), you can also run the skill description improver, which we have a whole separate script for, to optimize the triggering of the skill. + +Cool? Cool. + +## Communicating with the user + +The skill creator is liable to be used by people across a wide range of familiarity with coding jargon. If you haven't heard (and how could you, it's only very recently that it started), there's a trend now where the power of Claude is inspiring plumbers to open up their terminals, parents and grandparents to google "how to install npm". On the other hand, the bulk of users are probably fairly computer-literate. + +So please pay attention to context cues to understand how to phrase your communication! In the default case, just to give you some idea: + +- "evaluation" and "benchmark" are borderline, but OK +- for "JSON" and "assertion" you want to see serious cues from the user that they know what those things are before using them without explaining them + +It's OK to briefly explain terms if you're in doubt, and feel free to clarify terms with a short definition if you're unsure if the user will get it. + +--- + +## Creating a skill + +### Capture Intent + +Start by understanding the user's intent. The current conversation might already contain a workflow the user wants to capture (e.g., they say "turn this into a skill"). If so, extract answers from the conversation history first — the tools used, the sequence of steps, corrections the user made, input/output formats observed. The user may need to fill the gaps, and should confirm before proceeding to the next step. + +1. What should this skill enable Claude to do? +2. When should this skill trigger? (what user phrases/contexts) +3. What's the expected output format? +4. Should we set up test cases to verify the skill works? Skills with objectively verifiable outputs (file transforms, data extraction, code generation, fixed workflow steps) benefit from test cases. Skills with subjective outputs (writing style, art) often don't need them. Suggest the appropriate default based on the skill type, but let the user decide. + +### Interview and Research + +Proactively ask questions about edge cases, input/output formats, example files, success criteria, and dependencies. Wait to write test prompts until you've got this part ironed out. + +Check available MCPs - if useful for research (searching docs, finding similar skills, looking up best practices), research in parallel via subagents if available, otherwise inline. Come prepared with context to reduce burden on the user. + +### Write the SKILL.md + +Based on the user interview, fill in these components: + +- **name**: Skill identifier +- **description**: When to trigger, what it does. This is the primary triggering mechanism - include both what the skill does AND specific contexts for when to use it. All "when to use" info goes here, not in the body. Note: currently Claude has a tendency to "undertrigger" skills -- to not use them when they'd be useful. To combat this, please make the skill descriptions a little bit "pushy". So for instance, instead of "How to build a simple fast dashboard to display internal Anthropic data.", you might write "How to build a simple fast dashboard to display internal Anthropic data. Make sure to use this skill whenever the user mentions dashboards, data visualization, internal metrics, or wants to display any kind of company data, even if they don't explicitly ask for a 'dashboard.'" +- **compatibility**: Required tools, dependencies (optional, rarely needed) +- **the rest of the skill :)** + +### Skill Writing Guide + +#### Anatomy of a Skill + +``` +skill-name/ +├── SKILL.md (required) +│ ├── YAML frontmatter (name, description required) +│ └── Markdown instructions +└── Bundled Resources (optional) + ├── scripts/ - Executable code for deterministic/repetitive tasks + ├── references/ - Docs loaded into context as needed + └── assets/ - Files used in output (templates, icons, fonts) +``` + +#### Progressive Disclosure + +Skills use a three-level loading system: +1. **Metadata** (name + description) - Always in context (~100 words) +2. **SKILL.md body** - In context whenever skill triggers (<500 lines ideal) +3. **Bundled resources** - As needed (unlimited, scripts can execute without loading) + +These word counts are approximate and you can feel free to go longer if needed. + +**Key patterns:** +- Keep SKILL.md under 500 lines; if you're approaching this limit, add an additional layer of hierarchy along with clear pointers about where the model using the skill should go next to follow up. +- Reference files clearly from SKILL.md with guidance on when to read them +- For large reference files (>300 lines), include a table of contents + +**Domain organization**: When a skill supports multiple domains/frameworks, organize by variant: +``` +cloud-deploy/ +├── SKILL.md (workflow + selection) +└── references/ + ├── aws.md + ├── gcp.md + └── azure.md +``` +Claude reads only the relevant reference file. + +#### Principle of Lack of Surprise + +This goes without saying, but skills must not contain malware, exploit code, or any content that could compromise system security. A skill's contents should not surprise the user in their intent if described. Don't go along with requests to create misleading skills or skills designed to facilitate unauthorized access, data exfiltration, or other malicious activities. Things like a "roleplay as an XYZ" are OK though. + +#### Writing Patterns + +Prefer using the imperative form in instructions. + +**Defining output formats** - You can do it like this: +```markdown +## Report structure +ALWAYS use this exact template: +# [Title] +## Executive summary +## Key findings +## Recommendations +``` + +**Examples pattern** - It's useful to include examples. You can format them like this (but if "Input" and "Output" are in the examples you might want to deviate a little): +```markdown +## Commit message format +**Example 1:** +Input: Added user authentication with JWT tokens +Output: feat(auth): implement JWT-based authentication +``` + +### Writing Style + +Try to explain to the model why things are important in lieu of heavy-handed musty MUSTs. Use theory of mind and try to make the skill general and not super-narrow to specific examples. Start by writing a draft and then look at it with fresh eyes and improve it. + +### Test Cases + +After writing the skill draft, come up with 2-3 realistic test prompts — the kind of thing a real user would actually say. Share them with the user: [you don't have to use this exact language] "Here are a few test cases I'd like to try. Do these look right, or do you want to add more?" Then run them. + +Save test cases to `evals/evals.json`. Don't write assertions yet — just the prompts. You'll draft assertions in the next step while the runs are in progress. + +```json +{ + "skill_name": "example-skill", + "evals": [ + { + "id": 1, + "prompt": "User's task prompt", + "expected_output": "Description of expected result", + "files": [] + } + ] +} +``` + +See `references/schemas.md` for the full schema (including the `assertions` field, which you'll add later). + +## Running and evaluating test cases + +This section is one continuous sequence — don't stop partway through. Do NOT use `/skill-test` or any other testing skill. + +Put results in `-workspace/` as a sibling to the skill directory. Within the workspace, organize results by iteration (`iteration-1/`, `iteration-2/`, etc.) and within that, each test case gets a directory (`eval-0/`, `eval-1/`, etc.). Don't create all of this upfront — just create directories as you go. + +### Step 1: Spawn all runs (with-skill AND baseline) in the same turn + +For each test case, spawn two subagents in the same turn — one with the skill, one without. This is important: don't spawn the with-skill runs first and then come back for baselines later. Launch everything at once so it all finishes around the same time. + +**With-skill run:** + +``` +Execute this task: +- Skill path: +- Task: +- Input files: +- Save outputs to: /iteration-/eval-/with_skill/outputs/ +- Outputs to save: +``` + +**Baseline run** (same prompt, but the baseline depends on context): +- **Creating a new skill**: no skill at all. Same prompt, no skill path, save to `without_skill/outputs/`. +- **Improving an existing skill**: the old version. Before editing, snapshot the skill (`cp -r /skill-snapshot/`), then point the baseline subagent at the snapshot. Save to `old_skill/outputs/`. + +Write an `eval_metadata.json` for each test case (assertions can be empty for now). Give each eval a descriptive name based on what it's testing — not just "eval-0". Use this name for the directory too. If this iteration uses new or modified eval prompts, create these files for each new eval directory — don't assume they carry over from previous iterations. + +```json +{ + "eval_id": 0, + "eval_name": "descriptive-name-here", + "prompt": "The user's task prompt", + "assertions": [] +} +``` + +### Step 2: While runs are in progress, draft assertions + +Don't just wait for the runs to finish — you can use this time productively. Draft quantitative assertions for each test case and explain them to the user. If assertions already exist in `evals/evals.json`, review them and explain what they check. + +Good assertions are objectively verifiable and have descriptive names — they should read clearly in the benchmark viewer so someone glancing at the results immediately understands what each one checks. Subjective skills (writing style, design quality) are better evaluated qualitatively — don't force assertions onto things that need human judgment. + +Update the `eval_metadata.json` files and `evals/evals.json` with the assertions once drafted. Also explain to the user what they'll see in the viewer — both the qualitative outputs and the quantitative benchmark. + +### Step 3: As runs complete, capture timing data + +When each subagent task completes, you receive a notification containing `total_tokens` and `duration_ms`. Save this data immediately to `timing.json` in the run directory: + +```json +{ + "total_tokens": 84852, + "duration_ms": 23332, + "total_duration_seconds": 23.3 +} +``` + +This is the only opportunity to capture this data — it comes through the task notification and isn't persisted elsewhere. Process each notification as it arrives rather than trying to batch them. + +### Step 4: Grade, aggregate, and launch the viewer + +Once all runs are done: + +1. **Grade each run** — spawn a grader subagent (or grade inline) that reads `agents/grader.md` and evaluates each assertion against the outputs. Save results to `grading.json` in each run directory. The grading.json expectations array must use the fields `text`, `passed`, and `evidence` (not `name`/`met`/`details` or other variants) — the viewer depends on these exact field names. For assertions that can be checked programmatically, write and run a script rather than eyeballing it — scripts are faster, more reliable, and can be reused across iterations. + +2. **Aggregate into benchmark** — run the aggregation script from the skill-creator directory: + ```bash + python -m scripts.aggregate_benchmark /iteration-N --skill-name + ``` + This produces `benchmark.json` and `benchmark.md` with pass_rate, time, and tokens for each configuration, with mean ± stddev and the delta. If generating benchmark.json manually, see `references/schemas.md` for the exact schema the viewer expects. +Put each with_skill version before its baseline counterpart. + +3. **Do an analyst pass** — read the benchmark data and surface patterns the aggregate stats might hide. See `agents/analyzer.md` (the "Analyzing Benchmark Results" section) for what to look for — things like assertions that always pass regardless of skill (non-discriminating), high-variance evals (possibly flaky), and time/token tradeoffs. + +4. **Launch the viewer** with both qualitative outputs and quantitative data: + ```bash + nohup python /eval-viewer/generate_review.py \ + /iteration-N \ + --skill-name "my-skill" \ + --benchmark /iteration-N/benchmark.json \ + > /dev/null 2>&1 & + VIEWER_PID=$! + ``` + For iteration 2+, also pass `--previous-workspace /iteration-`. + + **Cowork / headless environments:** If `webbrowser.open()` is not available or the environment has no display, use `--static ` to write a standalone HTML file instead of starting a server. Feedback will be downloaded as a `feedback.json` file when the user clicks "Submit All Reviews". After download, copy `feedback.json` into the workspace directory for the next iteration to pick up. + +Note: please use generate_review.py to create the viewer; there's no need to write custom HTML. + +5. **Tell the user** something like: "I've opened the results in your browser. There are two tabs — 'Outputs' lets you click through each test case and leave feedback, 'Benchmark' shows the quantitative comparison. When you're done, come back here and let me know." + +### What the user sees in the viewer + +The "Outputs" tab shows one test case at a time: +- **Prompt**: the task that was given +- **Output**: the files the skill produced, rendered inline where possible +- **Previous Output** (iteration 2+): collapsed section showing last iteration's output +- **Formal Grades** (if grading was run): collapsed section showing assertion pass/fail +- **Feedback**: a textbox that auto-saves as they type +- **Previous Feedback** (iteration 2+): their comments from last time, shown below the textbox + +The "Benchmark" tab shows the stats summary: pass rates, timing, and token usage for each configuration, with per-eval breakdowns and analyst observations. + +Navigation is via prev/next buttons or arrow keys. When done, they click "Submit All Reviews" which saves all feedback to `feedback.json`. + +### Step 5: Read the feedback + +When the user tells you they're done, read `feedback.json`: + +```json +{ + "reviews": [ + {"run_id": "eval-0-with_skill", "feedback": "the chart is missing axis labels", "timestamp": "..."}, + {"run_id": "eval-1-with_skill", "feedback": "", "timestamp": "..."}, + {"run_id": "eval-2-with_skill", "feedback": "perfect, love this", "timestamp": "..."} + ], + "status": "complete" +} +``` + +Empty feedback means the user thought it was fine. Focus your improvements on the test cases where the user had specific complaints. + +Kill the viewer server when you're done with it: + +```bash +kill $VIEWER_PID 2>/dev/null +``` + +--- + +## Improving the skill + +This is the heart of the loop. You've run the test cases, the user has reviewed the results, and now you need to make the skill better based on their feedback. + +### How to think about improvements + +1. **Generalize from the feedback.** The big picture thing that's happening here is that we're trying to create skills that can be used a million times (maybe literally, maybe even more who knows) across many different prompts. Here you and the user are iterating on only a few examples over and over again because it helps move faster. The user knows these examples in and out and it's quick for them to assess new outputs. But if the skill you and the user are codeveloping works only for those examples, it's useless. Rather than put in fiddly overfitty changes, or oppressively constrictive MUSTs, if there's some stubborn issue, you might try branching out and using different metaphors, or recommending different patterns of working. It's relatively cheap to try and maybe you'll land on something great. + +2. **Keep the prompt lean.** Remove things that aren't pulling their weight. Make sure to read the transcripts, not just the final outputs — if it looks like the skill is making the model waste a bunch of time doing things that are unproductive, you can try getting rid of the parts of the skill that are making it do that and seeing what happens. + +3. **Explain the why.** Try hard to explain the **why** behind everything you're asking the model to do. Today's LLMs are *smart*. They have good theory of mind and when given a good harness can go beyond rote instructions and really make things happen. Even if the feedback from the user is terse or frustrated, try to actually understand the task and why the user is writing what they wrote, and what they actually wrote, and then transmit this understanding into the instructions. If you find yourself writing ALWAYS or NEVER in all caps, or using super rigid structures, that's a yellow flag — if possible, reframe and explain the reasoning so that the model understands why the thing you're asking for is important. That's a more humane, powerful, and effective approach. + +4. **Look for repeated work across test cases.** Read the transcripts from the test runs and notice if the subagents all independently wrote similar helper scripts or took the same multi-step approach to something. If all 3 test cases resulted in the subagent writing a `create_docx.py` or a `build_chart.py`, that's a strong signal the skill should bundle that script. Write it once, put it in `scripts/`, and tell the skill to use it. This saves every future invocation from reinventing the wheel. + +This task is pretty important (we are trying to create billions a year in economic value here!) and your thinking time is not the blocker; take your time and really mull things over. I'd suggest writing a draft revision and then looking at it anew and making improvements. Really do your best to get into the head of the user and understand what they want and need. + +### The iteration loop + +After improving the skill: + +1. Apply your improvements to the skill +2. Rerun all test cases into a new `iteration-/` directory, including baseline runs. If you're creating a new skill, the baseline is always `without_skill` (no skill) — that stays the same across iterations. If you're improving an existing skill, use your judgment on what makes sense as the baseline: the original version the user came in with, or the previous iteration. +3. Launch the reviewer with `--previous-workspace` pointing at the previous iteration +4. Wait for the user to review and tell you they're done +5. Read the new feedback, improve again, repeat + +Keep going until: +- The user says they're happy +- The feedback is all empty (everything looks good) +- You're not making meaningful progress + +--- + +## Advanced: Blind comparison + +For situations where you want a more rigorous comparison between two versions of a skill (e.g., the user asks "is the new version actually better?"), there's a blind comparison system. Read `agents/comparator.md` and `agents/analyzer.md` for the details. The basic idea is: give two outputs to an independent agent without telling it which is which, and let it judge quality. Then analyze why the winner won. + +This is optional, requires subagents, and most users won't need it. The human review loop is usually sufficient. + +--- + +## Description Optimization + +The description field in SKILL.md frontmatter is the primary mechanism that determines whether Claude invokes a skill. After creating or improving a skill, offer to optimize the description for better triggering accuracy. + +### Step 1: Generate trigger eval queries + +Create 20 eval queries — a mix of should-trigger and should-not-trigger. Save as JSON: + +```json +[ + {"query": "the user prompt", "should_trigger": true}, + {"query": "another prompt", "should_trigger": false} +] +``` + +The queries must be realistic and something a Claude Code or Claude.ai user would actually type. Not abstract requests, but requests that are concrete and specific and have a good amount of detail. For instance, file paths, personal context about the user's job or situation, column names and values, company names, URLs. A little bit of backstory. Some might be in lowercase or contain abbreviations or typos or casual speech. Use a mix of different lengths, and focus on edge cases rather than making them clear-cut (the user will get a chance to sign off on them). + +Bad: `"Format this data"`, `"Extract text from PDF"`, `"Create a chart"` + +Good: `"ok so my boss just sent me this xlsx file (its in my downloads, called something like 'Q4 sales final FINAL v2.xlsx') and she wants me to add a column that shows the profit margin as a percentage. The revenue is in column C and costs are in column D i think"` + +For the **should-trigger** queries (8-10), think about coverage. You want different phrasings of the same intent — some formal, some casual. Include cases where the user doesn't explicitly name the skill or file type but clearly needs it. Throw in some uncommon use cases and cases where this skill competes with another but should win. + +For the **should-not-trigger** queries (8-10), the most valuable ones are the near-misses — queries that share keywords or concepts with the skill but actually need something different. Think adjacent domains, ambiguous phrasing where a naive keyword match would trigger but shouldn't, and cases where the query touches on something the skill does but in a context where another tool is more appropriate. + +The key thing to avoid: don't make should-not-trigger queries obviously irrelevant. "Write a fibonacci function" as a negative test for a PDF skill is too easy — it doesn't test anything. The negative cases should be genuinely tricky. + +### Step 2: Review with user + +Present the eval set to the user for review using the HTML template: + +1. Read the template from `assets/eval_review.html` +2. Replace the placeholders: + - `__EVAL_DATA_PLACEHOLDER__` → the JSON array of eval items (no quotes around it — it's a JS variable assignment) + - `__SKILL_NAME_PLACEHOLDER__` → the skill's name + - `__SKILL_DESCRIPTION_PLACEHOLDER__` → the skill's current description +3. Write to a temp file (e.g., `/tmp/eval_review_.html`) and open it: `open /tmp/eval_review_.html` +4. The user can edit queries, toggle should-trigger, add/remove entries, then click "Export Eval Set" +5. The file downloads to `~/Downloads/eval_set.json` — check the Downloads folder for the most recent version in case there are multiple (e.g., `eval_set (1).json`) + +This step matters — bad eval queries lead to bad descriptions. + +### Step 3: Run the optimization loop + +Tell the user: "This will take some time — I'll run the optimization loop in the background and check on it periodically." + +Save the eval set to the workspace, then run in the background: + +```bash +python -m scripts.run_loop \ + --eval-set \ + --skill-path \ + --model \ + --max-iterations 5 \ + --verbose +``` + +Use the model ID from your system prompt (the one powering the current session) so the triggering test matches what the user actually experiences. + +While it runs, periodically tail the output to give the user updates on which iteration it's on and what the scores look like. + +This handles the full optimization loop automatically. It splits the eval set into 60% train and 40% held-out test, evaluates the current description (running each query 3 times to get a reliable trigger rate), then calls Claude to propose improvements based on what failed. It re-evaluates each new description on both train and test, iterating up to 5 times. When it's done, it opens an HTML report in the browser showing the results per iteration and returns JSON with `best_description` — selected by test score rather than train score to avoid overfitting. + +### How skill triggering works + +Understanding the triggering mechanism helps design better eval queries. Skills appear in Claude's `available_skills` list with their name + description, and Claude decides whether to consult a skill based on that description. The important thing to know is that Claude only consults skills for tasks it can't easily handle on its own — simple, one-step queries like "read this PDF" may not trigger a skill even if the description matches perfectly, because Claude can handle them directly with basic tools. Complex, multi-step, or specialized queries reliably trigger skills when the description matches. + +This means your eval queries should be substantive enough that Claude would actually benefit from consulting a skill. Simple queries like "read file X" are poor test cases — they won't trigger skills regardless of description quality. + +### Step 4: Apply the result + +Take `best_description` from the JSON output and update the skill's SKILL.md frontmatter. Show the user before/after and report the scores. + +--- + +### Package and Present (only if `present_files` tool is available) + +Check whether you have access to the `present_files` tool. If you don't, skip this step. If you do, package the skill and present the .skill file to the user: + +```bash +python -m scripts.package_skill +``` + +After packaging, direct the user to the resulting `.skill` file path so they can install it. + +--- + +## Claude.ai-specific instructions + +In Claude.ai, the core workflow is the same (draft → test → review → improve → repeat), but because Claude.ai doesn't have subagents, some mechanics change. Here's what to adapt: + +**Running test cases**: No subagents means no parallel execution. For each test case, read the skill's SKILL.md, then follow its instructions to accomplish the test prompt yourself. Do them one at a time. This is less rigorous than independent subagents (you wrote the skill and you're also running it, so you have full context), but it's a useful sanity check — and the human review step compensates. Skip the baseline runs — just use the skill to complete the task as requested. + +**Reviewing results**: If you can't open a browser (e.g., Claude.ai's VM has no display, or you're on a remote server), skip the browser reviewer entirely. Instead, present results directly in the conversation. For each test case, show the prompt and the output. If the output is a file the user needs to see (like a .docx or .xlsx), save it to the filesystem and tell them where it is so they can download and inspect it. Ask for feedback inline: "How does this look? Anything you'd change?" + +**Benchmarking**: Skip the quantitative benchmarking — it relies on baseline comparisons which aren't meaningful without subagents. Focus on qualitative feedback from the user. + +**The iteration loop**: Same as before — improve the skill, rerun the test cases, ask for feedback — just without the browser reviewer in the middle. You can still organize results into iteration directories on the filesystem if you have one. + +**Description optimization**: This section requires the `claude` CLI tool (specifically `claude -p`) which is only available in Claude Code. Skip it if you're on Claude.ai. + +**Blind comparison**: Requires subagents. Skip it. + +**Packaging**: The `package_skill.py` script works anywhere with Python and a filesystem. On Claude.ai, you can run it and the user can download the resulting `.skill` file. + +**Updating an existing skill**: The user might be asking you to update an existing skill, not create a new one. In this case: +- **Preserve the original name.** Note the skill's directory name and `name` frontmatter field -- use them unchanged. E.g., if the installed skill is `research-helper`, output `research-helper.skill` (not `research-helper-v2`). +- **Copy to a writeable location before editing.** The installed skill path may be read-only. Copy to `/tmp/skill-name/`, edit there, and package from the copy. +- **If packaging manually, stage in `/tmp/` first**, then copy to the output directory -- direct writes may fail due to permissions. + +--- + +## Cowork-Specific Instructions + +If you're in Cowork, the main things to know are: + +- You have subagents, so the main workflow (spawn test cases in parallel, run baselines, grade, etc.) all works. (However, if you run into severe problems with timeouts, it's OK to run the test prompts in series rather than parallel.) +- You don't have a browser or display, so when generating the eval viewer, use `--static ` to write a standalone HTML file instead of starting a server. Then proffer a link that the user can click to open the HTML in their browser. +- For whatever reason, the Cowork setup seems to disincline Claude from generating the eval viewer after running the tests, so just to reiterate: whether you're in Cowork or in Claude Code, after running tests, you should always generate the eval viewer for the human to look at examples before revising the skill yourself and trying to make corrections, using `generate_review.py` (not writing your own boutique html code). Sorry in advance but I'm gonna go all caps here: GENERATE THE EVAL VIEWER *BEFORE* evaluating inputs yourself. You want to get them in front of the human ASAP! +- Feedback works differently: since there's no running server, the viewer's "Submit All Reviews" button will download `feedback.json` as a file. You can then read it from there (you may have to request access first). +- Packaging works — `package_skill.py` just needs Python and a filesystem. +- Description optimization (`run_loop.py` / `run_eval.py`) should work in Cowork just fine since it uses `claude -p` via subprocess, not a browser, but please save it until you've fully finished making the skill and the user agrees it's in good shape. +- **Updating an existing skill**: The user might be asking you to update an existing skill, not create a new one. Follow the update guidance in the claude.ai section above. + +--- + +## Reference files + +The agents/ directory contains instructions for specialized subagents. Read them when you need to spawn the relevant subagent. + +- `agents/grader.md` — How to evaluate assertions against outputs +- `agents/comparator.md` — How to do blind A/B comparison between two outputs +- `agents/analyzer.md` — How to analyze why one version beat another + +The references/ directory has additional documentation: +- `references/schemas.md` — JSON structures for evals.json, grading.json, etc. + +--- + +Repeating one more time the core loop here for emphasis: + +- Figure out what the skill is about +- Draft or edit the skill +- Run claude-with-access-to-the-skill on test prompts +- With the user, evaluate the outputs: + - Create benchmark.json and run `eval-viewer/generate_review.py` to help the user review them + - Run quantitative evals +- Repeat until you and the user are satisfied +- Package the final skill and return it to the user. + +Please add steps to your TodoList, if you have such a thing, to make sure you don't forget. If you're in Cowork, please specifically put "Create evals JSON and run `eval-viewer/generate_review.py` so human can review test cases" in your TodoList to make sure it happens. + +Good luck! diff --git a/.claude/skills/skill-creator/agents/analyzer.md b/.claude/skills/skill-creator/agents/analyzer.md new file mode 100644 index 000000000..14e41d606 --- /dev/null +++ b/.claude/skills/skill-creator/agents/analyzer.md @@ -0,0 +1,274 @@ +# Post-hoc Analyzer Agent + +Analyze blind comparison results to understand WHY the winner won and generate improvement suggestions. + +## Role + +After the blind comparator determines a winner, the Post-hoc Analyzer "unblids" the results by examining the skills and transcripts. The goal is to extract actionable insights: what made the winner better, and how can the loser be improved? + +## Inputs + +You receive these parameters in your prompt: + +- **winner**: "A" or "B" (from blind comparison) +- **winner_skill_path**: Path to the skill that produced the winning output +- **winner_transcript_path**: Path to the execution transcript for the winner +- **loser_skill_path**: Path to the skill that produced the losing output +- **loser_transcript_path**: Path to the execution transcript for the loser +- **comparison_result_path**: Path to the blind comparator's output JSON +- **output_path**: Where to save the analysis results + +## Process + +### Step 1: Read Comparison Result + +1. Read the blind comparator's output at comparison_result_path +2. Note the winning side (A or B), the reasoning, and any scores +3. Understand what the comparator valued in the winning output + +### Step 2: Read Both Skills + +1. Read the winner skill's SKILL.md and key referenced files +2. Read the loser skill's SKILL.md and key referenced files +3. Identify structural differences: + - Instructions clarity and specificity + - Script/tool usage patterns + - Example coverage + - Edge case handling + +### Step 3: Read Both Transcripts + +1. Read the winner's transcript +2. Read the loser's transcript +3. Compare execution patterns: + - How closely did each follow their skill's instructions? + - What tools were used differently? + - Where did the loser diverge from optimal behavior? + - Did either encounter errors or make recovery attempts? + +### Step 4: Analyze Instruction Following + +For each transcript, evaluate: +- Did the agent follow the skill's explicit instructions? +- Did the agent use the skill's provided tools/scripts? +- Were there missed opportunities to leverage skill content? +- Did the agent add unnecessary steps not in the skill? + +Score instruction following 1-10 and note specific issues. + +### Step 5: Identify Winner Strengths + +Determine what made the winner better: +- Clearer instructions that led to better behavior? +- Better scripts/tools that produced better output? +- More comprehensive examples that guided edge cases? +- Better error handling guidance? + +Be specific. Quote from skills/transcripts where relevant. + +### Step 6: Identify Loser Weaknesses + +Determine what held the loser back: +- Ambiguous instructions that led to suboptimal choices? +- Missing tools/scripts that forced workarounds? +- Gaps in edge case coverage? +- Poor error handling that caused failures? + +### Step 7: Generate Improvement Suggestions + +Based on the analysis, produce actionable suggestions for improving the loser skill: +- Specific instruction changes to make +- Tools/scripts to add or modify +- Examples to include +- Edge cases to address + +Prioritize by impact. Focus on changes that would have changed the outcome. + +### Step 8: Write Analysis Results + +Save structured analysis to `{output_path}`. + +## Output Format + +Write a JSON file with this structure: + +```json +{ + "comparison_summary": { + "winner": "A", + "winner_skill": "path/to/winner/skill", + "loser_skill": "path/to/loser/skill", + "comparator_reasoning": "Brief summary of why comparator chose winner" + }, + "winner_strengths": [ + "Clear step-by-step instructions for handling multi-page documents", + "Included validation script that caught formatting errors", + "Explicit guidance on fallback behavior when OCR fails" + ], + "loser_weaknesses": [ + "Vague instruction 'process the document appropriately' led to inconsistent behavior", + "No script for validation, agent had to improvise and made errors", + "No guidance on OCR failure, agent gave up instead of trying alternatives" + ], + "instruction_following": { + "winner": { + "score": 9, + "issues": [ + "Minor: skipped optional logging step" + ] + }, + "loser": { + "score": 6, + "issues": [ + "Did not use the skill's formatting template", + "Invented own approach instead of following step 3", + "Missed the 'always validate output' instruction" + ] + } + }, + "improvement_suggestions": [ + { + "priority": "high", + "category": "instructions", + "suggestion": "Replace 'process the document appropriately' with explicit steps: 1) Extract text, 2) Identify sections, 3) Format per template", + "expected_impact": "Would eliminate ambiguity that caused inconsistent behavior" + }, + { + "priority": "high", + "category": "tools", + "suggestion": "Add validate_output.py script similar to winner skill's validation approach", + "expected_impact": "Would catch formatting errors before final output" + }, + { + "priority": "medium", + "category": "error_handling", + "suggestion": "Add fallback instructions: 'If OCR fails, try: 1) different resolution, 2) image preprocessing, 3) manual extraction'", + "expected_impact": "Would prevent early failure on difficult documents" + } + ], + "transcript_insights": { + "winner_execution_pattern": "Read skill -> Followed 5-step process -> Used validation script -> Fixed 2 issues -> Produced output", + "loser_execution_pattern": "Read skill -> Unclear on approach -> Tried 3 different methods -> No validation -> Output had errors" + } +} +``` + +## Guidelines + +- **Be specific**: Quote from skills and transcripts, don't just say "instructions were unclear" +- **Be actionable**: Suggestions should be concrete changes, not vague advice +- **Focus on skill improvements**: The goal is to improve the losing skill, not critique the agent +- **Prioritize by impact**: Which changes would most likely have changed the outcome? +- **Consider causation**: Did the skill weakness actually cause the worse output, or is it incidental? +- **Stay objective**: Analyze what happened, don't editorialize +- **Think about generalization**: Would this improvement help on other evals too? + +## Categories for Suggestions + +Use these categories to organize improvement suggestions: + +| Category | Description | +|----------|-------------| +| `instructions` | Changes to the skill's prose instructions | +| `tools` | Scripts, templates, or utilities to add/modify | +| `examples` | Example inputs/outputs to include | +| `error_handling` | Guidance for handling failures | +| `structure` | Reorganization of skill content | +| `references` | External docs or resources to add | + +## Priority Levels + +- **high**: Would likely change the outcome of this comparison +- **medium**: Would improve quality but may not change win/loss +- **low**: Nice to have, marginal improvement + +--- + +# Analyzing Benchmark Results + +When analyzing benchmark results, the analyzer's purpose is to **surface patterns and anomalies** across multiple runs, not suggest skill improvements. + +## Role + +Review all benchmark run results and generate freeform notes that help the user understand skill performance. Focus on patterns that wouldn't be visible from aggregate metrics alone. + +## Inputs + +You receive these parameters in your prompt: + +- **benchmark_data_path**: Path to the in-progress benchmark.json with all run results +- **skill_path**: Path to the skill being benchmarked +- **output_path**: Where to save the notes (as JSON array of strings) + +## Process + +### Step 1: Read Benchmark Data + +1. Read the benchmark.json containing all run results +2. Note the configurations tested (with_skill, without_skill) +3. Understand the run_summary aggregates already calculated + +### Step 2: Analyze Per-Assertion Patterns + +For each expectation across all runs: +- Does it **always pass** in both configurations? (may not differentiate skill value) +- Does it **always fail** in both configurations? (may be broken or beyond capability) +- Does it **always pass with skill but fail without**? (skill clearly adds value here) +- Does it **always fail with skill but pass without**? (skill may be hurting) +- Is it **highly variable**? (flaky expectation or non-deterministic behavior) + +### Step 3: Analyze Cross-Eval Patterns + +Look for patterns across evals: +- Are certain eval types consistently harder/easier? +- Do some evals show high variance while others are stable? +- Are there surprising results that contradict expectations? + +### Step 4: Analyze Metrics Patterns + +Look at time_seconds, tokens, tool_calls: +- Does the skill significantly increase execution time? +- Is there high variance in resource usage? +- Are there outlier runs that skew the aggregates? + +### Step 5: Generate Notes + +Write freeform observations as a list of strings. Each note should: +- State a specific observation +- Be grounded in the data (not speculation) +- Help the user understand something the aggregate metrics don't show + +Examples: +- "Assertion 'Output is a PDF file' passes 100% in both configurations - may not differentiate skill value" +- "Eval 3 shows high variance (50% ± 40%) - run 2 had an unusual failure that may be flaky" +- "Without-skill runs consistently fail on table extraction expectations (0% pass rate)" +- "Skill adds 13s average execution time but improves pass rate by 50%" +- "Token usage is 80% higher with skill, primarily due to script output parsing" +- "All 3 without-skill runs for eval 1 produced empty output" + +### Step 6: Write Notes + +Save notes to `{output_path}` as a JSON array of strings: + +```json +[ + "Assertion 'Output is a PDF file' passes 100% in both configurations - may not differentiate skill value", + "Eval 3 shows high variance (50% ± 40%) - run 2 had an unusual failure", + "Without-skill runs consistently fail on table extraction expectations", + "Skill adds 13s average execution time but improves pass rate by 50%" +] +``` + +## Guidelines + +**DO:** +- Report what you observe in the data +- Be specific about which evals, expectations, or runs you're referring to +- Note patterns that aggregate metrics would hide +- Provide context that helps interpret the numbers + +**DO NOT:** +- Suggest improvements to the skill (that's for the improvement step, not benchmarking) +- Make subjective quality judgments ("the output was good/bad") +- Speculate about causes without evidence +- Repeat information already in the run_summary aggregates diff --git a/.claude/skills/skill-creator/agents/comparator.md b/.claude/skills/skill-creator/agents/comparator.md new file mode 100644 index 000000000..80e00eb45 --- /dev/null +++ b/.claude/skills/skill-creator/agents/comparator.md @@ -0,0 +1,202 @@ +# Blind Comparator Agent + +Compare two outputs WITHOUT knowing which skill produced them. + +## Role + +The Blind Comparator judges which output better accomplishes the eval task. You receive two outputs labeled A and B, but you do NOT know which skill produced which. This prevents bias toward a particular skill or approach. + +Your judgment is based purely on output quality and task completion. + +## Inputs + +You receive these parameters in your prompt: + +- **output_a_path**: Path to the first output file or directory +- **output_b_path**: Path to the second output file or directory +- **eval_prompt**: The original task/prompt that was executed +- **expectations**: List of expectations to check (optional - may be empty) + +## Process + +### Step 1: Read Both Outputs + +1. Examine output A (file or directory) +2. Examine output B (file or directory) +3. Note the type, structure, and content of each +4. If outputs are directories, examine all relevant files inside + +### Step 2: Understand the Task + +1. Read the eval_prompt carefully +2. Identify what the task requires: + - What should be produced? + - What qualities matter (accuracy, completeness, format)? + - What would distinguish a good output from a poor one? + +### Step 3: Generate Evaluation Rubric + +Based on the task, generate a rubric with two dimensions: + +**Content Rubric** (what the output contains): +| Criterion | 1 (Poor) | 3 (Acceptable) | 5 (Excellent) | +|-----------|----------|----------------|---------------| +| Correctness | Major errors | Minor errors | Fully correct | +| Completeness | Missing key elements | Mostly complete | All elements present | +| Accuracy | Significant inaccuracies | Minor inaccuracies | Accurate throughout | + +**Structure Rubric** (how the output is organized): +| Criterion | 1 (Poor) | 3 (Acceptable) | 5 (Excellent) | +|-----------|----------|----------------|---------------| +| Organization | Disorganized | Reasonably organized | Clear, logical structure | +| Formatting | Inconsistent/broken | Mostly consistent | Professional, polished | +| Usability | Difficult to use | Usable with effort | Easy to use | + +Adapt criteria to the specific task. For example: +- PDF form → "Field alignment", "Text readability", "Data placement" +- Document → "Section structure", "Heading hierarchy", "Paragraph flow" +- Data output → "Schema correctness", "Data types", "Completeness" + +### Step 4: Evaluate Each Output Against the Rubric + +For each output (A and B): + +1. **Score each criterion** on the rubric (1-5 scale) +2. **Calculate dimension totals**: Content score, Structure score +3. **Calculate overall score**: Average of dimension scores, scaled to 1-10 + +### Step 5: Check Assertions (if provided) + +If expectations are provided: + +1. Check each expectation against output A +2. Check each expectation against output B +3. Count pass rates for each output +4. Use expectation scores as secondary evidence (not the primary decision factor) + +### Step 6: Determine the Winner + +Compare A and B based on (in priority order): + +1. **Primary**: Overall rubric score (content + structure) +2. **Secondary**: Assertion pass rates (if applicable) +3. **Tiebreaker**: If truly equal, declare a TIE + +Be decisive - ties should be rare. One output is usually better, even if marginally. + +### Step 7: Write Comparison Results + +Save results to a JSON file at the path specified (or `comparison.json` if not specified). + +## Output Format + +Write a JSON file with this structure: + +```json +{ + "winner": "A", + "reasoning": "Output A provides a complete solution with proper formatting and all required fields. Output B is missing the date field and has formatting inconsistencies.", + "rubric": { + "A": { + "content": { + "correctness": 5, + "completeness": 5, + "accuracy": 4 + }, + "structure": { + "organization": 4, + "formatting": 5, + "usability": 4 + }, + "content_score": 4.7, + "structure_score": 4.3, + "overall_score": 9.0 + }, + "B": { + "content": { + "correctness": 3, + "completeness": 2, + "accuracy": 3 + }, + "structure": { + "organization": 3, + "formatting": 2, + "usability": 3 + }, + "content_score": 2.7, + "structure_score": 2.7, + "overall_score": 5.4 + } + }, + "output_quality": { + "A": { + "score": 9, + "strengths": ["Complete solution", "Well-formatted", "All fields present"], + "weaknesses": ["Minor style inconsistency in header"] + }, + "B": { + "score": 5, + "strengths": ["Readable output", "Correct basic structure"], + "weaknesses": ["Missing date field", "Formatting inconsistencies", "Partial data extraction"] + } + }, + "expectation_results": { + "A": { + "passed": 4, + "total": 5, + "pass_rate": 0.80, + "details": [ + {"text": "Output includes name", "passed": true}, + {"text": "Output includes date", "passed": true}, + {"text": "Format is PDF", "passed": true}, + {"text": "Contains signature", "passed": false}, + {"text": "Readable text", "passed": true} + ] + }, + "B": { + "passed": 3, + "total": 5, + "pass_rate": 0.60, + "details": [ + {"text": "Output includes name", "passed": true}, + {"text": "Output includes date", "passed": false}, + {"text": "Format is PDF", "passed": true}, + {"text": "Contains signature", "passed": false}, + {"text": "Readable text", "passed": true} + ] + } + } +} +``` + +If no expectations were provided, omit the `expectation_results` field entirely. + +## Field Descriptions + +- **winner**: "A", "B", or "TIE" +- **reasoning**: Clear explanation of why the winner was chosen (or why it's a tie) +- **rubric**: Structured rubric evaluation for each output + - **content**: Scores for content criteria (correctness, completeness, accuracy) + - **structure**: Scores for structure criteria (organization, formatting, usability) + - **content_score**: Average of content criteria (1-5) + - **structure_score**: Average of structure criteria (1-5) + - **overall_score**: Combined score scaled to 1-10 +- **output_quality**: Summary quality assessment + - **score**: 1-10 rating (should match rubric overall_score) + - **strengths**: List of positive aspects + - **weaknesses**: List of issues or shortcomings +- **expectation_results**: (Only if expectations provided) + - **passed**: Number of expectations that passed + - **total**: Total number of expectations + - **pass_rate**: Fraction passed (0.0 to 1.0) + - **details**: Individual expectation results + +## Guidelines + +- **Stay blind**: DO NOT try to infer which skill produced which output. Judge purely on output quality. +- **Be specific**: Cite specific examples when explaining strengths and weaknesses. +- **Be decisive**: Choose a winner unless outputs are genuinely equivalent. +- **Output quality first**: Assertion scores are secondary to overall task completion. +- **Be objective**: Don't favor outputs based on style preferences; focus on correctness and completeness. +- **Explain your reasoning**: The reasoning field should make it clear why you chose the winner. +- **Handle edge cases**: If both outputs fail, pick the one that fails less badly. If both are excellent, pick the one that's marginally better. diff --git a/.claude/skills/skill-creator/agents/grader.md b/.claude/skills/skill-creator/agents/grader.md new file mode 100644 index 000000000..558ab05c0 --- /dev/null +++ b/.claude/skills/skill-creator/agents/grader.md @@ -0,0 +1,223 @@ +# Grader Agent + +Evaluate expectations against an execution transcript and outputs. + +## Role + +The Grader reviews a transcript and output files, then determines whether each expectation passes or fails. Provide clear evidence for each judgment. + +You have two jobs: grade the outputs, and critique the evals themselves. A passing grade on a weak assertion is worse than useless — it creates false confidence. When you notice an assertion that's trivially satisfied, or an important outcome that no assertion checks, say so. + +## Inputs + +You receive these parameters in your prompt: + +- **expectations**: List of expectations to evaluate (strings) +- **transcript_path**: Path to the execution transcript (markdown file) +- **outputs_dir**: Directory containing output files from execution + +## Process + +### Step 1: Read the Transcript + +1. Read the transcript file completely +2. Note the eval prompt, execution steps, and final result +3. Identify any issues or errors documented + +### Step 2: Examine Output Files + +1. List files in outputs_dir +2. Read/examine each file relevant to the expectations. If outputs aren't plain text, use the inspection tools provided in your prompt — don't rely solely on what the transcript says the executor produced. +3. Note contents, structure, and quality + +### Step 3: Evaluate Each Assertion + +For each expectation: + +1. **Search for evidence** in the transcript and outputs +2. **Determine verdict**: + - **PASS**: Clear evidence the expectation is true AND the evidence reflects genuine task completion, not just surface-level compliance + - **FAIL**: No evidence, or evidence contradicts the expectation, or the evidence is superficial (e.g., correct filename but empty/wrong content) +3. **Cite the evidence**: Quote the specific text or describe what you found + +### Step 4: Extract and Verify Claims + +Beyond the predefined expectations, extract implicit claims from the outputs and verify them: + +1. **Extract claims** from the transcript and outputs: + - Factual statements ("The form has 12 fields") + - Process claims ("Used pypdf to fill the form") + - Quality claims ("All fields were filled correctly") + +2. **Verify each claim**: + - **Factual claims**: Can be checked against the outputs or external sources + - **Process claims**: Can be verified from the transcript + - **Quality claims**: Evaluate whether the claim is justified + +3. **Flag unverifiable claims**: Note claims that cannot be verified with available information + +This catches issues that predefined expectations might miss. + +### Step 5: Read User Notes + +If `{outputs_dir}/user_notes.md` exists: +1. Read it and note any uncertainties or issues flagged by the executor +2. Include relevant concerns in the grading output +3. These may reveal problems even when expectations pass + +### Step 6: Critique the Evals + +After grading, consider whether the evals themselves could be improved. Only surface suggestions when there's a clear gap. + +Good suggestions test meaningful outcomes — assertions that are hard to satisfy without actually doing the work correctly. Think about what makes an assertion *discriminating*: it passes when the skill genuinely succeeds and fails when it doesn't. + +Suggestions worth raising: +- An assertion that passed but would also pass for a clearly wrong output (e.g., checking filename existence but not file content) +- An important outcome you observed — good or bad — that no assertion covers at all +- An assertion that can't actually be verified from the available outputs + +Keep the bar high. The goal is to flag things the eval author would say "good catch" about, not to nitpick every assertion. + +### Step 7: Write Grading Results + +Save results to `{outputs_dir}/../grading.json` (sibling to outputs_dir). + +## Grading Criteria + +**PASS when**: +- The transcript or outputs clearly demonstrate the expectation is true +- Specific evidence can be cited +- The evidence reflects genuine substance, not just surface compliance (e.g., a file exists AND contains correct content, not just the right filename) + +**FAIL when**: +- No evidence found for the expectation +- Evidence contradicts the expectation +- The expectation cannot be verified from available information +- The evidence is superficial — the assertion is technically satisfied but the underlying task outcome is wrong or incomplete +- The output appears to meet the assertion by coincidence rather than by actually doing the work + +**When uncertain**: The burden of proof to pass is on the expectation. + +### Step 8: Read Executor Metrics and Timing + +1. If `{outputs_dir}/metrics.json` exists, read it and include in grading output +2. If `{outputs_dir}/../timing.json` exists, read it and include timing data + +## Output Format + +Write a JSON file with this structure: + +```json +{ + "expectations": [ + { + "text": "The output includes the name 'John Smith'", + "passed": true, + "evidence": "Found in transcript Step 3: 'Extracted names: John Smith, Sarah Johnson'" + }, + { + "text": "The spreadsheet has a SUM formula in cell B10", + "passed": false, + "evidence": "No spreadsheet was created. The output was a text file." + }, + { + "text": "The assistant used the skill's OCR script", + "passed": true, + "evidence": "Transcript Step 2 shows: 'Tool: Bash - python ocr_script.py image.png'" + } + ], + "summary": { + "passed": 2, + "failed": 1, + "total": 3, + "pass_rate": 0.67 + }, + "execution_metrics": { + "tool_calls": { + "Read": 5, + "Write": 2, + "Bash": 8 + }, + "total_tool_calls": 15, + "total_steps": 6, + "errors_encountered": 0, + "output_chars": 12450, + "transcript_chars": 3200 + }, + "timing": { + "executor_duration_seconds": 165.0, + "grader_duration_seconds": 26.0, + "total_duration_seconds": 191.0 + }, + "claims": [ + { + "claim": "The form has 12 fillable fields", + "type": "factual", + "verified": true, + "evidence": "Counted 12 fields in field_info.json" + }, + { + "claim": "All required fields were populated", + "type": "quality", + "verified": false, + "evidence": "Reference section was left blank despite data being available" + } + ], + "user_notes_summary": { + "uncertainties": ["Used 2023 data, may be stale"], + "needs_review": [], + "workarounds": ["Fell back to text overlay for non-fillable fields"] + }, + "eval_feedback": { + "suggestions": [ + { + "assertion": "The output includes the name 'John Smith'", + "reason": "A hallucinated document that mentions the name would also pass — consider checking it appears as the primary contact with matching phone and email from the input" + }, + { + "reason": "No assertion checks whether the extracted phone numbers match the input — I observed incorrect numbers in the output that went uncaught" + } + ], + "overall": "Assertions check presence but not correctness. Consider adding content verification." + } +} +``` + +## Field Descriptions + +- **expectations**: Array of graded expectations + - **text**: The original expectation text + - **passed**: Boolean - true if expectation passes + - **evidence**: Specific quote or description supporting the verdict +- **summary**: Aggregate statistics + - **passed**: Count of passed expectations + - **failed**: Count of failed expectations + - **total**: Total expectations evaluated + - **pass_rate**: Fraction passed (0.0 to 1.0) +- **execution_metrics**: Copied from executor's metrics.json (if available) + - **output_chars**: Total character count of output files (proxy for tokens) + - **transcript_chars**: Character count of transcript +- **timing**: Wall clock timing from timing.json (if available) + - **executor_duration_seconds**: Time spent in executor subagent + - **total_duration_seconds**: Total elapsed time for the run +- **claims**: Extracted and verified claims from the output + - **claim**: The statement being verified + - **type**: "factual", "process", or "quality" + - **verified**: Boolean - whether the claim holds + - **evidence**: Supporting or contradicting evidence +- **user_notes_summary**: Issues flagged by the executor + - **uncertainties**: Things the executor wasn't sure about + - **needs_review**: Items requiring human attention + - **workarounds**: Places where the skill didn't work as expected +- **eval_feedback**: Improvement suggestions for the evals (only when warranted) + - **suggestions**: List of concrete suggestions, each with a `reason` and optionally an `assertion` it relates to + - **overall**: Brief assessment — can be "No suggestions, evals look solid" if nothing to flag + +## Guidelines + +- **Be objective**: Base verdicts on evidence, not assumptions +- **Be specific**: Quote the exact text that supports your verdict +- **Be thorough**: Check both transcript and output files +- **Be consistent**: Apply the same standard to each expectation +- **Explain failures**: Make it clear why evidence was insufficient +- **No partial credit**: Each expectation is pass or fail, not partial diff --git a/.claude/skills/skill-creator/assets/eval_review.html b/.claude/skills/skill-creator/assets/eval_review.html new file mode 100644 index 000000000..938ff32ae --- /dev/null +++ b/.claude/skills/skill-creator/assets/eval_review.html @@ -0,0 +1,146 @@ + + + + + + Eval Set Review - __SKILL_NAME_PLACEHOLDER__ + + + + + + +

Eval Set Review: __SKILL_NAME_PLACEHOLDER__

+

Current description: __SKILL_DESCRIPTION_PLACEHOLDER__

+ +
+ + +
+ + + + + + + + + + +
QueryShould TriggerActions
+ +

+ + + + diff --git a/.claude/skills/skill-creator/eval-viewer/generate_review.py b/.claude/skills/skill-creator/eval-viewer/generate_review.py new file mode 100644 index 000000000..7fa597863 --- /dev/null +++ b/.claude/skills/skill-creator/eval-viewer/generate_review.py @@ -0,0 +1,471 @@ +#!/usr/bin/env python3 +"""Generate and serve a review page for eval results. + +Reads the workspace directory, discovers runs (directories with outputs/), +embeds all output data into a self-contained HTML page, and serves it via +a tiny HTTP server. Feedback auto-saves to feedback.json in the workspace. + +Usage: + python generate_review.py [--port PORT] [--skill-name NAME] + python generate_review.py --previous-feedback /path/to/old/feedback.json + +No dependencies beyond the Python stdlib are required. +""" + +import argparse +import base64 +import json +import mimetypes +import os +import re +import signal +import subprocess +import sys +import time +import webbrowser +from functools import partial +from http.server import HTTPServer, BaseHTTPRequestHandler +from pathlib import Path + +# Files to exclude from output listings +METADATA_FILES = {"transcript.md", "user_notes.md", "metrics.json"} + +# Extensions we render as inline text +TEXT_EXTENSIONS = { + ".txt", ".md", ".json", ".csv", ".py", ".js", ".ts", ".tsx", ".jsx", + ".yaml", ".yml", ".xml", ".html", ".css", ".sh", ".rb", ".go", ".rs", + ".java", ".c", ".cpp", ".h", ".hpp", ".sql", ".r", ".toml", +} + +# Extensions we render as inline images +IMAGE_EXTENSIONS = {".png", ".jpg", ".jpeg", ".gif", ".svg", ".webp"} + +# MIME type overrides for common types +MIME_OVERRIDES = { + ".svg": "image/svg+xml", + ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", + ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document", + ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation", +} + + +def get_mime_type(path: Path) -> str: + ext = path.suffix.lower() + if ext in MIME_OVERRIDES: + return MIME_OVERRIDES[ext] + mime, _ = mimetypes.guess_type(str(path)) + return mime or "application/octet-stream" + + +def find_runs(workspace: Path) -> list[dict]: + """Recursively find directories that contain an outputs/ subdirectory.""" + runs: list[dict] = [] + _find_runs_recursive(workspace, workspace, runs) + runs.sort(key=lambda r: (r.get("eval_id", float("inf")), r["id"])) + return runs + + +def _find_runs_recursive(root: Path, current: Path, runs: list[dict]) -> None: + if not current.is_dir(): + return + + outputs_dir = current / "outputs" + if outputs_dir.is_dir(): + run = build_run(root, current) + if run: + runs.append(run) + return + + skip = {"node_modules", ".git", "__pycache__", "skill", "inputs"} + for child in sorted(current.iterdir()): + if child.is_dir() and child.name not in skip: + _find_runs_recursive(root, child, runs) + + +def build_run(root: Path, run_dir: Path) -> dict | None: + """Build a run dict with prompt, outputs, and grading data.""" + prompt = "" + eval_id = None + + # Try eval_metadata.json + for candidate in [run_dir / "eval_metadata.json", run_dir.parent / "eval_metadata.json"]: + if candidate.exists(): + try: + metadata = json.loads(candidate.read_text()) + prompt = metadata.get("prompt", "") + eval_id = metadata.get("eval_id") + except (json.JSONDecodeError, OSError): + pass + if prompt: + break + + # Fall back to transcript.md + if not prompt: + for candidate in [run_dir / "transcript.md", run_dir / "outputs" / "transcript.md"]: + if candidate.exists(): + try: + text = candidate.read_text() + match = re.search(r"## Eval Prompt\n\n([\s\S]*?)(?=\n##|$)", text) + if match: + prompt = match.group(1).strip() + except OSError: + pass + if prompt: + break + + if not prompt: + prompt = "(No prompt found)" + + run_id = str(run_dir.relative_to(root)).replace("/", "-").replace("\\", "-") + + # Collect output files + outputs_dir = run_dir / "outputs" + output_files: list[dict] = [] + if outputs_dir.is_dir(): + for f in sorted(outputs_dir.iterdir()): + if f.is_file() and f.name not in METADATA_FILES: + output_files.append(embed_file(f)) + + # Load grading if present + grading = None + for candidate in [run_dir / "grading.json", run_dir.parent / "grading.json"]: + if candidate.exists(): + try: + grading = json.loads(candidate.read_text()) + except (json.JSONDecodeError, OSError): + pass + if grading: + break + + return { + "id": run_id, + "prompt": prompt, + "eval_id": eval_id, + "outputs": output_files, + "grading": grading, + } + + +def embed_file(path: Path) -> dict: + """Read a file and return an embedded representation.""" + ext = path.suffix.lower() + mime = get_mime_type(path) + + if ext in TEXT_EXTENSIONS: + try: + content = path.read_text(errors="replace") + except OSError: + content = "(Error reading file)" + return { + "name": path.name, + "type": "text", + "content": content, + } + elif ext in IMAGE_EXTENSIONS: + try: + raw = path.read_bytes() + b64 = base64.b64encode(raw).decode("ascii") + except OSError: + return {"name": path.name, "type": "error", "content": "(Error reading file)"} + return { + "name": path.name, + "type": "image", + "mime": mime, + "data_uri": f"data:{mime};base64,{b64}", + } + elif ext == ".pdf": + try: + raw = path.read_bytes() + b64 = base64.b64encode(raw).decode("ascii") + except OSError: + return {"name": path.name, "type": "error", "content": "(Error reading file)"} + return { + "name": path.name, + "type": "pdf", + "data_uri": f"data:{mime};base64,{b64}", + } + elif ext == ".xlsx": + try: + raw = path.read_bytes() + b64 = base64.b64encode(raw).decode("ascii") + except OSError: + return {"name": path.name, "type": "error", "content": "(Error reading file)"} + return { + "name": path.name, + "type": "xlsx", + "data_b64": b64, + } + else: + # Binary / unknown — base64 download link + try: + raw = path.read_bytes() + b64 = base64.b64encode(raw).decode("ascii") + except OSError: + return {"name": path.name, "type": "error", "content": "(Error reading file)"} + return { + "name": path.name, + "type": "binary", + "mime": mime, + "data_uri": f"data:{mime};base64,{b64}", + } + + +def load_previous_iteration(workspace: Path) -> dict[str, dict]: + """Load previous iteration's feedback and outputs. + + Returns a map of run_id -> {"feedback": str, "outputs": list[dict]}. + """ + result: dict[str, dict] = {} + + # Load feedback + feedback_map: dict[str, str] = {} + feedback_path = workspace / "feedback.json" + if feedback_path.exists(): + try: + data = json.loads(feedback_path.read_text()) + feedback_map = { + r["run_id"]: r["feedback"] + for r in data.get("reviews", []) + if r.get("feedback", "").strip() + } + except (json.JSONDecodeError, OSError, KeyError): + pass + + # Load runs (to get outputs) + prev_runs = find_runs(workspace) + for run in prev_runs: + result[run["id"]] = { + "feedback": feedback_map.get(run["id"], ""), + "outputs": run.get("outputs", []), + } + + # Also add feedback for run_ids that had feedback but no matching run + for run_id, fb in feedback_map.items(): + if run_id not in result: + result[run_id] = {"feedback": fb, "outputs": []} + + return result + + +def generate_html( + runs: list[dict], + skill_name: str, + previous: dict[str, dict] | None = None, + benchmark: dict | None = None, +) -> str: + """Generate the complete standalone HTML page with embedded data.""" + template_path = Path(__file__).parent / "viewer.html" + template = template_path.read_text() + + # Build previous_feedback and previous_outputs maps for the template + previous_feedback: dict[str, str] = {} + previous_outputs: dict[str, list[dict]] = {} + if previous: + for run_id, data in previous.items(): + if data.get("feedback"): + previous_feedback[run_id] = data["feedback"] + if data.get("outputs"): + previous_outputs[run_id] = data["outputs"] + + embedded = { + "skill_name": skill_name, + "runs": runs, + "previous_feedback": previous_feedback, + "previous_outputs": previous_outputs, + } + if benchmark: + embedded["benchmark"] = benchmark + + data_json = json.dumps(embedded) + + return template.replace("/*__EMBEDDED_DATA__*/", f"const EMBEDDED_DATA = {data_json};") + + +# --------------------------------------------------------------------------- +# HTTP server (stdlib only, zero dependencies) +# --------------------------------------------------------------------------- + +def _kill_port(port: int) -> None: + """Kill any process listening on the given port.""" + try: + result = subprocess.run( + ["lsof", "-ti", f":{port}"], + capture_output=True, text=True, timeout=5, + ) + for pid_str in result.stdout.strip().split("\n"): + if pid_str.strip(): + try: + os.kill(int(pid_str.strip()), signal.SIGTERM) + except (ProcessLookupError, ValueError): + pass + if result.stdout.strip(): + time.sleep(0.5) + except subprocess.TimeoutExpired: + pass + except FileNotFoundError: + print("Note: lsof not found, cannot check if port is in use", file=sys.stderr) + +class ReviewHandler(BaseHTTPRequestHandler): + """Serves the review HTML and handles feedback saves. + + Regenerates the HTML on each page load so that refreshing the browser + picks up new eval outputs without restarting the server. + """ + + def __init__( + self, + workspace: Path, + skill_name: str, + feedback_path: Path, + previous: dict[str, dict], + benchmark_path: Path | None, + *args, + **kwargs, + ): + self.workspace = workspace + self.skill_name = skill_name + self.feedback_path = feedback_path + self.previous = previous + self.benchmark_path = benchmark_path + super().__init__(*args, **kwargs) + + def do_GET(self) -> None: + if self.path == "/" or self.path == "/index.html": + # Regenerate HTML on each request (re-scans workspace for new outputs) + runs = find_runs(self.workspace) + benchmark = None + if self.benchmark_path and self.benchmark_path.exists(): + try: + benchmark = json.loads(self.benchmark_path.read_text()) + except (json.JSONDecodeError, OSError): + pass + html = generate_html(runs, self.skill_name, self.previous, benchmark) + content = html.encode("utf-8") + self.send_response(200) + self.send_header("Content-Type", "text/html; charset=utf-8") + self.send_header("Content-Length", str(len(content))) + self.end_headers() + self.wfile.write(content) + elif self.path == "/api/feedback": + data = b"{}" + if self.feedback_path.exists(): + data = self.feedback_path.read_bytes() + self.send_response(200) + self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(data))) + self.end_headers() + self.wfile.write(data) + else: + self.send_error(404) + + def do_POST(self) -> None: + if self.path == "/api/feedback": + length = int(self.headers.get("Content-Length", 0)) + body = self.rfile.read(length) + try: + data = json.loads(body) + if not isinstance(data, dict) or "reviews" not in data: + raise ValueError("Expected JSON object with 'reviews' key") + self.feedback_path.write_text(json.dumps(data, indent=2) + "\n") + resp = b'{"ok":true}' + self.send_response(200) + except (json.JSONDecodeError, OSError, ValueError) as e: + resp = json.dumps({"error": str(e)}).encode() + self.send_response(500) + self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(resp))) + self.end_headers() + self.wfile.write(resp) + else: + self.send_error(404) + + def log_message(self, format: str, *args: object) -> None: + # Suppress request logging to keep terminal clean + pass + + +def main() -> None: + parser = argparse.ArgumentParser(description="Generate and serve eval review") + parser.add_argument("workspace", type=Path, help="Path to workspace directory") + parser.add_argument("--port", "-p", type=int, default=3117, help="Server port (default: 3117)") + parser.add_argument("--skill-name", "-n", type=str, default=None, help="Skill name for header") + parser.add_argument( + "--previous-workspace", type=Path, default=None, + help="Path to previous iteration's workspace (shows old outputs and feedback as context)", + ) + parser.add_argument( + "--benchmark", type=Path, default=None, + help="Path to benchmark.json to show in the Benchmark tab", + ) + parser.add_argument( + "--static", "-s", type=Path, default=None, + help="Write standalone HTML to this path instead of starting a server", + ) + args = parser.parse_args() + + workspace = args.workspace.resolve() + if not workspace.is_dir(): + print(f"Error: {workspace} is not a directory", file=sys.stderr) + sys.exit(1) + + runs = find_runs(workspace) + if not runs: + print(f"No runs found in {workspace}", file=sys.stderr) + sys.exit(1) + + skill_name = args.skill_name or workspace.name.replace("-workspace", "") + feedback_path = workspace / "feedback.json" + + previous: dict[str, dict] = {} + if args.previous_workspace: + previous = load_previous_iteration(args.previous_workspace.resolve()) + + benchmark_path = args.benchmark.resolve() if args.benchmark else None + benchmark = None + if benchmark_path and benchmark_path.exists(): + try: + benchmark = json.loads(benchmark_path.read_text()) + except (json.JSONDecodeError, OSError): + pass + + if args.static: + html = generate_html(runs, skill_name, previous, benchmark) + args.static.parent.mkdir(parents=True, exist_ok=True) + args.static.write_text(html) + print(f"\n Static viewer written to: {args.static}\n") + sys.exit(0) + + # Kill any existing process on the target port + port = args.port + _kill_port(port) + handler = partial(ReviewHandler, workspace, skill_name, feedback_path, previous, benchmark_path) + try: + server = HTTPServer(("127.0.0.1", port), handler) + except OSError: + # Port still in use after kill attempt — find a free one + server = HTTPServer(("127.0.0.1", 0), handler) + port = server.server_address[1] + + url = f"http://localhost:{port}" + print(f"\n Eval Viewer") + print(f" ─────────────────────────────────") + print(f" URL: {url}") + print(f" Workspace: {workspace}") + print(f" Feedback: {feedback_path}") + if previous: + print(f" Previous: {args.previous_workspace} ({len(previous)} runs)") + if benchmark_path: + print(f" Benchmark: {benchmark_path}") + print(f"\n Press Ctrl+C to stop.\n") + + webbrowser.open(url) + + try: + server.serve_forever() + except KeyboardInterrupt: + print("\nStopped.") + server.server_close() + + +if __name__ == "__main__": + main() diff --git a/.claude/skills/skill-creator/eval-viewer/viewer.html b/.claude/skills/skill-creator/eval-viewer/viewer.html new file mode 100644 index 000000000..6d8e96348 --- /dev/null +++ b/.claude/skills/skill-creator/eval-viewer/viewer.html @@ -0,0 +1,1325 @@ + + + + + + Eval Review + + + + + + + +
+
+
+

Eval Review:

+
Review each output and leave feedback below. Navigate with arrow keys or buttons. When done, copy feedback and paste into Claude Code.
+
+
+
+ + + + + +
+
+ +
+
Prompt
+
+
+
+
+ + +
+
Output
+
+
No output files found
+
+
+ + + + + + + + +
+
Your Feedback
+
+ + + +
+
+
+ + +
+ + +
+
+
No benchmark data available. Run a benchmark to see quantitative results here.
+
+
+
+ + +
+
+

Review Complete

+

Your feedback has been saved. Go back to your Claude Code session and tell Claude you're done reviewing.

+
+ +
+
+
+ + +
+ + + + diff --git a/.claude/skills/skill-creator/references/schemas.md b/.claude/skills/skill-creator/references/schemas.md new file mode 100644 index 000000000..b6eeaa2d4 --- /dev/null +++ b/.claude/skills/skill-creator/references/schemas.md @@ -0,0 +1,430 @@ +# JSON Schemas + +This document defines the JSON schemas used by skill-creator. + +--- + +## evals.json + +Defines the evals for a skill. Located at `evals/evals.json` within the skill directory. + +```json +{ + "skill_name": "example-skill", + "evals": [ + { + "id": 1, + "prompt": "User's example prompt", + "expected_output": "Description of expected result", + "files": ["evals/files/sample1.pdf"], + "expectations": [ + "The output includes X", + "The skill used script Y" + ] + } + ] +} +``` + +**Fields:** +- `skill_name`: Name matching the skill's frontmatter +- `evals[].id`: Unique integer identifier +- `evals[].prompt`: The task to execute +- `evals[].expected_output`: Human-readable description of success +- `evals[].files`: Optional list of input file paths (relative to skill root) +- `evals[].expectations`: List of verifiable statements + +--- + +## history.json + +Tracks version progression in Improve mode. Located at workspace root. + +```json +{ + "started_at": "2026-01-15T10:30:00Z", + "skill_name": "pdf", + "current_best": "v2", + "iterations": [ + { + "version": "v0", + "parent": null, + "expectation_pass_rate": 0.65, + "grading_result": "baseline", + "is_current_best": false + }, + { + "version": "v1", + "parent": "v0", + "expectation_pass_rate": 0.75, + "grading_result": "won", + "is_current_best": false + }, + { + "version": "v2", + "parent": "v1", + "expectation_pass_rate": 0.85, + "grading_result": "won", + "is_current_best": true + } + ] +} +``` + +**Fields:** +- `started_at`: ISO timestamp of when improvement started +- `skill_name`: Name of the skill being improved +- `current_best`: Version identifier of the best performer +- `iterations[].version`: Version identifier (v0, v1, ...) +- `iterations[].parent`: Parent version this was derived from +- `iterations[].expectation_pass_rate`: Pass rate from grading +- `iterations[].grading_result`: "baseline", "won", "lost", or "tie" +- `iterations[].is_current_best`: Whether this is the current best version + +--- + +## grading.json + +Output from the grader agent. Located at `/grading.json`. + +```json +{ + "expectations": [ + { + "text": "The output includes the name 'John Smith'", + "passed": true, + "evidence": "Found in transcript Step 3: 'Extracted names: John Smith, Sarah Johnson'" + }, + { + "text": "The spreadsheet has a SUM formula in cell B10", + "passed": false, + "evidence": "No spreadsheet was created. The output was a text file." + } + ], + "summary": { + "passed": 2, + "failed": 1, + "total": 3, + "pass_rate": 0.67 + }, + "execution_metrics": { + "tool_calls": { + "Read": 5, + "Write": 2, + "Bash": 8 + }, + "total_tool_calls": 15, + "total_steps": 6, + "errors_encountered": 0, + "output_chars": 12450, + "transcript_chars": 3200 + }, + "timing": { + "executor_duration_seconds": 165.0, + "grader_duration_seconds": 26.0, + "total_duration_seconds": 191.0 + }, + "claims": [ + { + "claim": "The form has 12 fillable fields", + "type": "factual", + "verified": true, + "evidence": "Counted 12 fields in field_info.json" + } + ], + "user_notes_summary": { + "uncertainties": ["Used 2023 data, may be stale"], + "needs_review": [], + "workarounds": ["Fell back to text overlay for non-fillable fields"] + }, + "eval_feedback": { + "suggestions": [ + { + "assertion": "The output includes the name 'John Smith'", + "reason": "A hallucinated document that mentions the name would also pass" + } + ], + "overall": "Assertions check presence but not correctness." + } +} +``` + +**Fields:** +- `expectations[]`: Graded expectations with evidence +- `summary`: Aggregate pass/fail counts +- `execution_metrics`: Tool usage and output size (from executor's metrics.json) +- `timing`: Wall clock timing (from timing.json) +- `claims`: Extracted and verified claims from the output +- `user_notes_summary`: Issues flagged by the executor +- `eval_feedback`: (optional) Improvement suggestions for the evals, only present when the grader identifies issues worth raising + +--- + +## metrics.json + +Output from the executor agent. Located at `/outputs/metrics.json`. + +```json +{ + "tool_calls": { + "Read": 5, + "Write": 2, + "Bash": 8, + "Edit": 1, + "Glob": 2, + "Grep": 0 + }, + "total_tool_calls": 18, + "total_steps": 6, + "files_created": ["filled_form.pdf", "field_values.json"], + "errors_encountered": 0, + "output_chars": 12450, + "transcript_chars": 3200 +} +``` + +**Fields:** +- `tool_calls`: Count per tool type +- `total_tool_calls`: Sum of all tool calls +- `total_steps`: Number of major execution steps +- `files_created`: List of output files created +- `errors_encountered`: Number of errors during execution +- `output_chars`: Total character count of output files +- `transcript_chars`: Character count of transcript + +--- + +## timing.json + +Wall clock timing for a run. Located at `/timing.json`. + +**How to capture:** When a subagent task completes, the task notification includes `total_tokens` and `duration_ms`. Save these immediately — they are not persisted anywhere else and cannot be recovered after the fact. + +```json +{ + "total_tokens": 84852, + "duration_ms": 23332, + "total_duration_seconds": 23.3, + "executor_start": "2026-01-15T10:30:00Z", + "executor_end": "2026-01-15T10:32:45Z", + "executor_duration_seconds": 165.0, + "grader_start": "2026-01-15T10:32:46Z", + "grader_end": "2026-01-15T10:33:12Z", + "grader_duration_seconds": 26.0 +} +``` + +--- + +## benchmark.json + +Output from Benchmark mode. Located at `benchmarks//benchmark.json`. + +```json +{ + "metadata": { + "skill_name": "pdf", + "skill_path": "/path/to/pdf", + "executor_model": "claude-sonnet-4-20250514", + "analyzer_model": "most-capable-model", + "timestamp": "2026-01-15T10:30:00Z", + "evals_run": [1, 2, 3], + "runs_per_configuration": 3 + }, + + "runs": [ + { + "eval_id": 1, + "eval_name": "Ocean", + "configuration": "with_skill", + "run_number": 1, + "result": { + "pass_rate": 0.85, + "passed": 6, + "failed": 1, + "total": 7, + "time_seconds": 42.5, + "tokens": 3800, + "tool_calls": 18, + "errors": 0 + }, + "expectations": [ + {"text": "...", "passed": true, "evidence": "..."} + ], + "notes": [ + "Used 2023 data, may be stale", + "Fell back to text overlay for non-fillable fields" + ] + } + ], + + "run_summary": { + "with_skill": { + "pass_rate": {"mean": 0.85, "stddev": 0.05, "min": 0.80, "max": 0.90}, + "time_seconds": {"mean": 45.0, "stddev": 12.0, "min": 32.0, "max": 58.0}, + "tokens": {"mean": 3800, "stddev": 400, "min": 3200, "max": 4100} + }, + "without_skill": { + "pass_rate": {"mean": 0.35, "stddev": 0.08, "min": 0.28, "max": 0.45}, + "time_seconds": {"mean": 32.0, "stddev": 8.0, "min": 24.0, "max": 42.0}, + "tokens": {"mean": 2100, "stddev": 300, "min": 1800, "max": 2500} + }, + "delta": { + "pass_rate": "+0.50", + "time_seconds": "+13.0", + "tokens": "+1700" + } + }, + + "notes": [ + "Assertion 'Output is a PDF file' passes 100% in both configurations - may not differentiate skill value", + "Eval 3 shows high variance (50% ± 40%) - may be flaky or model-dependent", + "Without-skill runs consistently fail on table extraction expectations", + "Skill adds 13s average execution time but improves pass rate by 50%" + ] +} +``` + +**Fields:** +- `metadata`: Information about the benchmark run + - `skill_name`: Name of the skill + - `timestamp`: When the benchmark was run + - `evals_run`: List of eval names or IDs + - `runs_per_configuration`: Number of runs per config (e.g. 3) +- `runs[]`: Individual run results + - `eval_id`: Numeric eval identifier + - `eval_name`: Human-readable eval name (used as section header in the viewer) + - `configuration`: Must be `"with_skill"` or `"without_skill"` (the viewer uses this exact string for grouping and color coding) + - `run_number`: Integer run number (1, 2, 3...) + - `result`: Nested object with `pass_rate`, `passed`, `total`, `time_seconds`, `tokens`, `errors` +- `run_summary`: Statistical aggregates per configuration + - `with_skill` / `without_skill`: Each contains `pass_rate`, `time_seconds`, `tokens` objects with `mean` and `stddev` fields + - `delta`: Difference strings like `"+0.50"`, `"+13.0"`, `"+1700"` +- `notes`: Freeform observations from the analyzer + +**Important:** The viewer reads these field names exactly. Using `config` instead of `configuration`, or putting `pass_rate` at the top level of a run instead of nested under `result`, will cause the viewer to show empty/zero values. Always reference this schema when generating benchmark.json manually. + +--- + +## comparison.json + +Output from blind comparator. Located at `/comparison-N.json`. + +```json +{ + "winner": "A", + "reasoning": "Output A provides a complete solution with proper formatting and all required fields. Output B is missing the date field and has formatting inconsistencies.", + "rubric": { + "A": { + "content": { + "correctness": 5, + "completeness": 5, + "accuracy": 4 + }, + "structure": { + "organization": 4, + "formatting": 5, + "usability": 4 + }, + "content_score": 4.7, + "structure_score": 4.3, + "overall_score": 9.0 + }, + "B": { + "content": { + "correctness": 3, + "completeness": 2, + "accuracy": 3 + }, + "structure": { + "organization": 3, + "formatting": 2, + "usability": 3 + }, + "content_score": 2.7, + "structure_score": 2.7, + "overall_score": 5.4 + } + }, + "output_quality": { + "A": { + "score": 9, + "strengths": ["Complete solution", "Well-formatted", "All fields present"], + "weaknesses": ["Minor style inconsistency in header"] + }, + "B": { + "score": 5, + "strengths": ["Readable output", "Correct basic structure"], + "weaknesses": ["Missing date field", "Formatting inconsistencies", "Partial data extraction"] + } + }, + "expectation_results": { + "A": { + "passed": 4, + "total": 5, + "pass_rate": 0.80, + "details": [ + {"text": "Output includes name", "passed": true} + ] + }, + "B": { + "passed": 3, + "total": 5, + "pass_rate": 0.60, + "details": [ + {"text": "Output includes name", "passed": true} + ] + } + } +} +``` + +--- + +## analysis.json + +Output from post-hoc analyzer. Located at `/analysis.json`. + +```json +{ + "comparison_summary": { + "winner": "A", + "winner_skill": "path/to/winner/skill", + "loser_skill": "path/to/loser/skill", + "comparator_reasoning": "Brief summary of why comparator chose winner" + }, + "winner_strengths": [ + "Clear step-by-step instructions for handling multi-page documents", + "Included validation script that caught formatting errors" + ], + "loser_weaknesses": [ + "Vague instruction 'process the document appropriately' led to inconsistent behavior", + "No script for validation, agent had to improvise" + ], + "instruction_following": { + "winner": { + "score": 9, + "issues": ["Minor: skipped optional logging step"] + }, + "loser": { + "score": 6, + "issues": [ + "Did not use the skill's formatting template", + "Invented own approach instead of following step 3" + ] + } + }, + "improvement_suggestions": [ + { + "priority": "high", + "category": "instructions", + "suggestion": "Replace 'process the document appropriately' with explicit steps", + "expected_impact": "Would eliminate ambiguity that caused inconsistent behavior" + } + ], + "transcript_insights": { + "winner_execution_pattern": "Read skill -> Followed 5-step process -> Used validation script", + "loser_execution_pattern": "Read skill -> Unclear on approach -> Tried 3 different methods" + } +} +``` diff --git a/.claude/skills/skill-creator/scripts/__init__.py b/.claude/skills/skill-creator/scripts/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/.claude/skills/skill-creator/scripts/aggregate_benchmark.py b/.claude/skills/skill-creator/scripts/aggregate_benchmark.py new file mode 100755 index 000000000..3e66e8c10 --- /dev/null +++ b/.claude/skills/skill-creator/scripts/aggregate_benchmark.py @@ -0,0 +1,401 @@ +#!/usr/bin/env python3 +""" +Aggregate individual run results into benchmark summary statistics. + +Reads grading.json files from run directories and produces: +- run_summary with mean, stddev, min, max for each metric +- delta between with_skill and without_skill configurations + +Usage: + python aggregate_benchmark.py + +Example: + python aggregate_benchmark.py benchmarks/2026-01-15T10-30-00/ + +The script supports two directory layouts: + + Workspace layout (from skill-creator iterations): + / + └── eval-N/ + ├── with_skill/ + │ ├── run-1/grading.json + │ └── run-2/grading.json + └── without_skill/ + ├── run-1/grading.json + └── run-2/grading.json + + Legacy layout (with runs/ subdirectory): + / + └── runs/ + └── eval-N/ + ├── with_skill/ + │ └── run-1/grading.json + └── without_skill/ + └── run-1/grading.json +""" + +import argparse +import json +import math +import sys +from datetime import datetime, timezone +from pathlib import Path + + +def calculate_stats(values: list[float]) -> dict: + """Calculate mean, stddev, min, max for a list of values.""" + if not values: + return {"mean": 0.0, "stddev": 0.0, "min": 0.0, "max": 0.0} + + n = len(values) + mean = sum(values) / n + + if n > 1: + variance = sum((x - mean) ** 2 for x in values) / (n - 1) + stddev = math.sqrt(variance) + else: + stddev = 0.0 + + return { + "mean": round(mean, 4), + "stddev": round(stddev, 4), + "min": round(min(values), 4), + "max": round(max(values), 4) + } + + +def load_run_results(benchmark_dir: Path) -> dict: + """ + Load all run results from a benchmark directory. + + Returns dict keyed by config name (e.g. "with_skill"/"without_skill", + or "new_skill"/"old_skill"), each containing a list of run results. + """ + # Support both layouts: eval dirs directly under benchmark_dir, or under runs/ + runs_dir = benchmark_dir / "runs" + if runs_dir.exists(): + search_dir = runs_dir + elif list(benchmark_dir.glob("eval-*")): + search_dir = benchmark_dir + else: + print(f"No eval directories found in {benchmark_dir} or {benchmark_dir / 'runs'}") + return {} + + results: dict[str, list] = {} + + for eval_idx, eval_dir in enumerate(sorted(search_dir.glob("eval-*"))): + metadata_path = eval_dir / "eval_metadata.json" + if metadata_path.exists(): + try: + with open(metadata_path) as mf: + eval_id = json.load(mf).get("eval_id", eval_idx) + except (json.JSONDecodeError, OSError): + eval_id = eval_idx + else: + try: + eval_id = int(eval_dir.name.split("-")[1]) + except ValueError: + eval_id = eval_idx + + # Discover config directories dynamically rather than hardcoding names + for config_dir in sorted(eval_dir.iterdir()): + if not config_dir.is_dir(): + continue + # Skip non-config directories (inputs, outputs, etc.) + if not list(config_dir.glob("run-*")): + continue + config = config_dir.name + if config not in results: + results[config] = [] + + for run_dir in sorted(config_dir.glob("run-*")): + run_number = int(run_dir.name.split("-")[1]) + grading_file = run_dir / "grading.json" + + if not grading_file.exists(): + print(f"Warning: grading.json not found in {run_dir}") + continue + + try: + with open(grading_file) as f: + grading = json.load(f) + except json.JSONDecodeError as e: + print(f"Warning: Invalid JSON in {grading_file}: {e}") + continue + + # Extract metrics + result = { + "eval_id": eval_id, + "run_number": run_number, + "pass_rate": grading.get("summary", {}).get("pass_rate", 0.0), + "passed": grading.get("summary", {}).get("passed", 0), + "failed": grading.get("summary", {}).get("failed", 0), + "total": grading.get("summary", {}).get("total", 0), + } + + # Extract timing — check grading.json first, then sibling timing.json + timing = grading.get("timing", {}) + result["time_seconds"] = timing.get("total_duration_seconds", 0.0) + timing_file = run_dir / "timing.json" + if result["time_seconds"] == 0.0 and timing_file.exists(): + try: + with open(timing_file) as tf: + timing_data = json.load(tf) + result["time_seconds"] = timing_data.get("total_duration_seconds", 0.0) + result["tokens"] = timing_data.get("total_tokens", 0) + except json.JSONDecodeError: + pass + + # Extract metrics if available + metrics = grading.get("execution_metrics", {}) + result["tool_calls"] = metrics.get("total_tool_calls", 0) + if not result.get("tokens"): + result["tokens"] = metrics.get("output_chars", 0) + result["errors"] = metrics.get("errors_encountered", 0) + + # Extract expectations — viewer requires fields: text, passed, evidence + raw_expectations = grading.get("expectations", []) + for exp in raw_expectations: + if "text" not in exp or "passed" not in exp: + print(f"Warning: expectation in {grading_file} missing required fields (text, passed, evidence): {exp}") + result["expectations"] = raw_expectations + + # Extract notes from user_notes_summary + notes_summary = grading.get("user_notes_summary", {}) + notes = [] + notes.extend(notes_summary.get("uncertainties", [])) + notes.extend(notes_summary.get("needs_review", [])) + notes.extend(notes_summary.get("workarounds", [])) + result["notes"] = notes + + results[config].append(result) + + return results + + +def aggregate_results(results: dict) -> dict: + """ + Aggregate run results into summary statistics. + + Returns run_summary with stats for each configuration and delta. + """ + run_summary = {} + configs = list(results.keys()) + + for config in configs: + runs = results.get(config, []) + + if not runs: + run_summary[config] = { + "pass_rate": {"mean": 0.0, "stddev": 0.0, "min": 0.0, "max": 0.0}, + "time_seconds": {"mean": 0.0, "stddev": 0.0, "min": 0.0, "max": 0.0}, + "tokens": {"mean": 0, "stddev": 0, "min": 0, "max": 0} + } + continue + + pass_rates = [r["pass_rate"] for r in runs] + times = [r["time_seconds"] for r in runs] + tokens = [r.get("tokens", 0) for r in runs] + + run_summary[config] = { + "pass_rate": calculate_stats(pass_rates), + "time_seconds": calculate_stats(times), + "tokens": calculate_stats(tokens) + } + + # Calculate delta between the first two configs (if two exist) + if len(configs) >= 2: + primary = run_summary.get(configs[0], {}) + baseline = run_summary.get(configs[1], {}) + else: + primary = run_summary.get(configs[0], {}) if configs else {} + baseline = {} + + delta_pass_rate = primary.get("pass_rate", {}).get("mean", 0) - baseline.get("pass_rate", {}).get("mean", 0) + delta_time = primary.get("time_seconds", {}).get("mean", 0) - baseline.get("time_seconds", {}).get("mean", 0) + delta_tokens = primary.get("tokens", {}).get("mean", 0) - baseline.get("tokens", {}).get("mean", 0) + + run_summary["delta"] = { + "pass_rate": f"{delta_pass_rate:+.2f}", + "time_seconds": f"{delta_time:+.1f}", + "tokens": f"{delta_tokens:+.0f}" + } + + return run_summary + + +def generate_benchmark(benchmark_dir: Path, skill_name: str = "", skill_path: str = "") -> dict: + """ + Generate complete benchmark.json from run results. + """ + results = load_run_results(benchmark_dir) + run_summary = aggregate_results(results) + + # Build runs array for benchmark.json + runs = [] + for config in results: + for result in results[config]: + runs.append({ + "eval_id": result["eval_id"], + "configuration": config, + "run_number": result["run_number"], + "result": { + "pass_rate": result["pass_rate"], + "passed": result["passed"], + "failed": result["failed"], + "total": result["total"], + "time_seconds": result["time_seconds"], + "tokens": result.get("tokens", 0), + "tool_calls": result.get("tool_calls", 0), + "errors": result.get("errors", 0) + }, + "expectations": result["expectations"], + "notes": result["notes"] + }) + + # Determine eval IDs from results + eval_ids = sorted(set( + r["eval_id"] + for config in results.values() + for r in config + )) + + benchmark = { + "metadata": { + "skill_name": skill_name or "", + "skill_path": skill_path or "", + "executor_model": "", + "analyzer_model": "", + "timestamp": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"), + "evals_run": eval_ids, + "runs_per_configuration": 3 + }, + "runs": runs, + "run_summary": run_summary, + "notes": [] # To be filled by analyzer + } + + return benchmark + + +def generate_markdown(benchmark: dict) -> str: + """Generate human-readable benchmark.md from benchmark data.""" + metadata = benchmark["metadata"] + run_summary = benchmark["run_summary"] + + # Determine config names (excluding "delta") + configs = [k for k in run_summary if k != "delta"] + config_a = configs[0] if len(configs) >= 1 else "config_a" + config_b = configs[1] if len(configs) >= 2 else "config_b" + label_a = config_a.replace("_", " ").title() + label_b = config_b.replace("_", " ").title() + + lines = [ + f"# Skill Benchmark: {metadata['skill_name']}", + "", + f"**Model**: {metadata['executor_model']}", + f"**Date**: {metadata['timestamp']}", + f"**Evals**: {', '.join(map(str, metadata['evals_run']))} ({metadata['runs_per_configuration']} runs each per configuration)", + "", + "## Summary", + "", + f"| Metric | {label_a} | {label_b} | Delta |", + "|--------|------------|---------------|-------|", + ] + + a_summary = run_summary.get(config_a, {}) + b_summary = run_summary.get(config_b, {}) + delta = run_summary.get("delta", {}) + + # Format pass rate + a_pr = a_summary.get("pass_rate", {}) + b_pr = b_summary.get("pass_rate", {}) + lines.append(f"| Pass Rate | {a_pr.get('mean', 0)*100:.0f}% ± {a_pr.get('stddev', 0)*100:.0f}% | {b_pr.get('mean', 0)*100:.0f}% ± {b_pr.get('stddev', 0)*100:.0f}% | {delta.get('pass_rate', '—')} |") + + # Format time + a_time = a_summary.get("time_seconds", {}) + b_time = b_summary.get("time_seconds", {}) + lines.append(f"| Time | {a_time.get('mean', 0):.1f}s ± {a_time.get('stddev', 0):.1f}s | {b_time.get('mean', 0):.1f}s ± {b_time.get('stddev', 0):.1f}s | {delta.get('time_seconds', '—')}s |") + + # Format tokens + a_tokens = a_summary.get("tokens", {}) + b_tokens = b_summary.get("tokens", {}) + lines.append(f"| Tokens | {a_tokens.get('mean', 0):.0f} ± {a_tokens.get('stddev', 0):.0f} | {b_tokens.get('mean', 0):.0f} ± {b_tokens.get('stddev', 0):.0f} | {delta.get('tokens', '—')} |") + + # Notes section + if benchmark.get("notes"): + lines.extend([ + "", + "## Notes", + "" + ]) + for note in benchmark["notes"]: + lines.append(f"- {note}") + + return "\n".join(lines) + + +def main(): + parser = argparse.ArgumentParser( + description="Aggregate benchmark run results into summary statistics" + ) + parser.add_argument( + "benchmark_dir", + type=Path, + help="Path to the benchmark directory" + ) + parser.add_argument( + "--skill-name", + default="", + help="Name of the skill being benchmarked" + ) + parser.add_argument( + "--skill-path", + default="", + help="Path to the skill being benchmarked" + ) + parser.add_argument( + "--output", "-o", + type=Path, + help="Output path for benchmark.json (default: /benchmark.json)" + ) + + args = parser.parse_args() + + if not args.benchmark_dir.exists(): + print(f"Directory not found: {args.benchmark_dir}") + sys.exit(1) + + # Generate benchmark + benchmark = generate_benchmark(args.benchmark_dir, args.skill_name, args.skill_path) + + # Determine output paths + output_json = args.output or (args.benchmark_dir / "benchmark.json") + output_md = output_json.with_suffix(".md") + + # Write benchmark.json + with open(output_json, "w") as f: + json.dump(benchmark, f, indent=2) + print(f"Generated: {output_json}") + + # Write benchmark.md + markdown = generate_markdown(benchmark) + with open(output_md, "w") as f: + f.write(markdown) + print(f"Generated: {output_md}") + + # Print summary + run_summary = benchmark["run_summary"] + configs = [k for k in run_summary if k != "delta"] + delta = run_summary.get("delta", {}) + + print(f"\nSummary:") + for config in configs: + pr = run_summary[config]["pass_rate"]["mean"] + label = config.replace("_", " ").title() + print(f" {label}: {pr*100:.1f}% pass rate") + print(f" Delta: {delta.get('pass_rate', '—')}") + + +if __name__ == "__main__": + main() diff --git a/.claude/skills/skill-creator/scripts/generate_report.py b/.claude/skills/skill-creator/scripts/generate_report.py new file mode 100755 index 000000000..959e30a00 --- /dev/null +++ b/.claude/skills/skill-creator/scripts/generate_report.py @@ -0,0 +1,326 @@ +#!/usr/bin/env python3 +"""Generate an HTML report from run_loop.py output. + +Takes the JSON output from run_loop.py and generates a visual HTML report +showing each description attempt with check/x for each test case. +Distinguishes between train and test queries. +""" + +import argparse +import html +import json +import sys +from pathlib import Path + + +def generate_html(data: dict, auto_refresh: bool = False, skill_name: str = "") -> str: + """Generate HTML report from loop output data. If auto_refresh is True, adds a meta refresh tag.""" + history = data.get("history", []) + holdout = data.get("holdout", 0) + title_prefix = html.escape(skill_name + " \u2014 ") if skill_name else "" + + # Get all unique queries from train and test sets, with should_trigger info + train_queries: list[dict] = [] + test_queries: list[dict] = [] + if history: + for r in history[0].get("train_results", history[0].get("results", [])): + train_queries.append({"query": r["query"], "should_trigger": r.get("should_trigger", True)}) + if history[0].get("test_results"): + for r in history[0].get("test_results", []): + test_queries.append({"query": r["query"], "should_trigger": r.get("should_trigger", True)}) + + refresh_tag = ' \n' if auto_refresh else "" + + html_parts = [""" + + + +""" + refresh_tag + """ """ + title_prefix + """Skill Description Optimization + + + + + + +

""" + title_prefix + """Skill Description Optimization

+
+ Optimizing your skill's description. This page updates automatically as Claude tests different versions of your skill's description. Each row is an iteration — a new description attempt. The columns show test queries: green checkmarks mean the skill triggered correctly (or correctly didn't trigger), red crosses mean it got it wrong. The "Train" score shows performance on queries used to improve the description; the "Test" score shows performance on held-out queries the optimizer hasn't seen. When it's done, Claude will apply the best-performing description to your skill. +
+"""] + + # Summary section + best_test_score = data.get('best_test_score') + best_train_score = data.get('best_train_score') + html_parts.append(f""" +
+

Original: {html.escape(data.get('original_description', 'N/A'))}

+

Best: {html.escape(data.get('best_description', 'N/A'))}

+

Best Score: {data.get('best_score', 'N/A')} {'(test)' if best_test_score else '(train)'}

+

Iterations: {data.get('iterations_run', 0)} | Train: {data.get('train_size', '?')} | Test: {data.get('test_size', '?')}

+
+""") + + # Legend + html_parts.append(""" +
+ Query columns: + Should trigger + Should NOT trigger + Train + Test +
+""") + + # Table header + html_parts.append(""" +
+ + + + + + + +""") + + # Add column headers for train queries + for qinfo in train_queries: + polarity = "positive-col" if qinfo["should_trigger"] else "negative-col" + html_parts.append(f' \n') + + # Add column headers for test queries (different color) + for qinfo in test_queries: + polarity = "positive-col" if qinfo["should_trigger"] else "negative-col" + html_parts.append(f' \n') + + html_parts.append(""" + + +""") + + # Find best iteration for highlighting + if test_queries: + best_iter = max(history, key=lambda h: h.get("test_passed") or 0).get("iteration") + else: + best_iter = max(history, key=lambda h: h.get("train_passed", h.get("passed", 0))).get("iteration") + + # Add rows for each iteration + for h in history: + iteration = h.get("iteration", "?") + train_passed = h.get("train_passed", h.get("passed", 0)) + train_total = h.get("train_total", h.get("total", 0)) + test_passed = h.get("test_passed") + test_total = h.get("test_total") + description = h.get("description", "") + train_results = h.get("train_results", h.get("results", [])) + test_results = h.get("test_results", []) + + # Create lookups for results by query + train_by_query = {r["query"]: r for r in train_results} + test_by_query = {r["query"]: r for r in test_results} if test_results else {} + + # Compute aggregate correct/total runs across all retries + def aggregate_runs(results: list[dict]) -> tuple[int, int]: + correct = 0 + total = 0 + for r in results: + runs = r.get("runs", 0) + triggers = r.get("triggers", 0) + total += runs + if r.get("should_trigger", True): + correct += triggers + else: + correct += runs - triggers + return correct, total + + train_correct, train_runs = aggregate_runs(train_results) + test_correct, test_runs = aggregate_runs(test_results) + + # Determine score classes + def score_class(correct: int, total: int) -> str: + if total > 0: + ratio = correct / total + if ratio >= 0.8: + return "score-good" + elif ratio >= 0.5: + return "score-ok" + return "score-bad" + + train_class = score_class(train_correct, train_runs) + test_class = score_class(test_correct, test_runs) + + row_class = "best-row" if iteration == best_iter else "" + + html_parts.append(f""" + + + + +""") + + # Add result for each train query + for qinfo in train_queries: + r = train_by_query.get(qinfo["query"], {}) + did_pass = r.get("pass", False) + triggers = r.get("triggers", 0) + runs = r.get("runs", 0) + + icon = "✓" if did_pass else "✗" + css_class = "pass" if did_pass else "fail" + + html_parts.append(f' \n') + + # Add result for each test query (with different background) + for qinfo in test_queries: + r = test_by_query.get(qinfo["query"], {}) + did_pass = r.get("pass", False) + triggers = r.get("triggers", 0) + runs = r.get("runs", 0) + + icon = "✓" if did_pass else "✗" + css_class = "pass" if did_pass else "fail" + + html_parts.append(f' \n') + + html_parts.append(" \n") + + html_parts.append(""" +
IterTrainTestDescription{html.escape(qinfo["query"])}{html.escape(qinfo["query"])}
{iteration}{train_correct}/{train_runs}{test_correct}/{test_runs}{html.escape(description)}{icon}{triggers}/{runs}{icon}{triggers}/{runs}
+
+""") + + html_parts.append(""" + + +""") + + return "".join(html_parts) + + +def main(): + parser = argparse.ArgumentParser(description="Generate HTML report from run_loop output") + parser.add_argument("input", help="Path to JSON output from run_loop.py (or - for stdin)") + parser.add_argument("-o", "--output", default=None, help="Output HTML file (default: stdout)") + parser.add_argument("--skill-name", default="", help="Skill name to include in the report title") + args = parser.parse_args() + + if args.input == "-": + data = json.load(sys.stdin) + else: + data = json.loads(Path(args.input).read_text()) + + html_output = generate_html(data, skill_name=args.skill_name) + + if args.output: + Path(args.output).write_text(html_output) + print(f"Report written to {args.output}", file=sys.stderr) + else: + print(html_output) + + +if __name__ == "__main__": + main() diff --git a/.claude/skills/skill-creator/scripts/improve_description.py b/.claude/skills/skill-creator/scripts/improve_description.py new file mode 100755 index 000000000..06bcec761 --- /dev/null +++ b/.claude/skills/skill-creator/scripts/improve_description.py @@ -0,0 +1,247 @@ +#!/usr/bin/env python3 +"""Improve a skill description based on eval results. + +Takes eval results (from run_eval.py) and generates an improved description +by calling `claude -p` as a subprocess (same auth pattern as run_eval.py — +uses the session's Claude Code auth, no separate ANTHROPIC_API_KEY needed). +""" + +import argparse +import json +import os +import re +import subprocess +import sys +from pathlib import Path + +from scripts.utils import parse_skill_md + + +def _call_claude(prompt: str, model: str | None, timeout: int = 300) -> str: + """Run `claude -p` with the prompt on stdin and return the text response. + + Prompt goes over stdin (not argv) because it embeds the full SKILL.md + body and can easily exceed comfortable argv length. + """ + cmd = ["claude", "-p", "--output-format", "text"] + if model: + cmd.extend(["--model", model]) + + # Remove CLAUDECODE env var to allow nesting claude -p inside a + # Claude Code session. The guard is for interactive terminal conflicts; + # programmatic subprocess usage is safe. Same pattern as run_eval.py. + env = {k: v for k, v in os.environ.items() if k != "CLAUDECODE"} + + result = subprocess.run( + cmd, + input=prompt, + capture_output=True, + text=True, + env=env, + timeout=timeout, + ) + if result.returncode != 0: + raise RuntimeError( + f"claude -p exited {result.returncode}\nstderr: {result.stderr}" + ) + return result.stdout + + +def improve_description( + skill_name: str, + skill_content: str, + current_description: str, + eval_results: dict, + history: list[dict], + model: str, + test_results: dict | None = None, + log_dir: Path | None = None, + iteration: int | None = None, +) -> str: + """Call Claude to improve the description based on eval results.""" + failed_triggers = [ + r for r in eval_results["results"] + if r["should_trigger"] and not r["pass"] + ] + false_triggers = [ + r for r in eval_results["results"] + if not r["should_trigger"] and not r["pass"] + ] + + # Build scores summary + train_score = f"{eval_results['summary']['passed']}/{eval_results['summary']['total']}" + if test_results: + test_score = f"{test_results['summary']['passed']}/{test_results['summary']['total']}" + scores_summary = f"Train: {train_score}, Test: {test_score}" + else: + scores_summary = f"Train: {train_score}" + + prompt = f"""You are optimizing a skill description for a Claude Code skill called "{skill_name}". A "skill" is sort of like a prompt, but with progressive disclosure -- there's a title and description that Claude sees when deciding whether to use the skill, and then if it does use the skill, it reads the .md file which has lots more details and potentially links to other resources in the skill folder like helper files and scripts and additional documentation or examples. + +The description appears in Claude's "available_skills" list. When a user sends a query, Claude decides whether to invoke the skill based solely on the title and on this description. Your goal is to write a description that triggers for relevant queries, and doesn't trigger for irrelevant ones. + +Here's the current description: + +"{current_description}" + + +Current scores ({scores_summary}): + +""" + if failed_triggers: + prompt += "FAILED TO TRIGGER (should have triggered but didn't):\n" + for r in failed_triggers: + prompt += f' - "{r["query"]}" (triggered {r["triggers"]}/{r["runs"]} times)\n' + prompt += "\n" + + if false_triggers: + prompt += "FALSE TRIGGERS (triggered but shouldn't have):\n" + for r in false_triggers: + prompt += f' - "{r["query"]}" (triggered {r["triggers"]}/{r["runs"]} times)\n' + prompt += "\n" + + if history: + prompt += "PREVIOUS ATTEMPTS (do NOT repeat these — try something structurally different):\n\n" + for h in history: + train_s = f"{h.get('train_passed', h.get('passed', 0))}/{h.get('train_total', h.get('total', 0))}" + test_s = f"{h.get('test_passed', '?')}/{h.get('test_total', '?')}" if h.get('test_passed') is not None else None + score_str = f"train={train_s}" + (f", test={test_s}" if test_s else "") + prompt += f'\n' + prompt += f'Description: "{h["description"]}"\n' + if "results" in h: + prompt += "Train results:\n" + for r in h["results"]: + status = "PASS" if r["pass"] else "FAIL" + prompt += f' [{status}] "{r["query"][:80]}" (triggered {r["triggers"]}/{r["runs"]})\n' + if h.get("note"): + prompt += f'Note: {h["note"]}\n' + prompt += "\n\n" + + prompt += f""" + +Skill content (for context on what the skill does): + +{skill_content} + + +Based on the failures, write a new and improved description that is more likely to trigger correctly. When I say "based on the failures", it's a bit of a tricky line to walk because we don't want to overfit to the specific cases you're seeing. So what I DON'T want you to do is produce an ever-expanding list of specific queries that this skill should or shouldn't trigger for. Instead, try to generalize from the failures to broader categories of user intent and situations where this skill would be useful or not useful. The reason for this is twofold: + +1. Avoid overfitting +2. The list might get loooong and it's injected into ALL queries and there might be a lot of skills, so we don't want to blow too much space on any given description. + +Concretely, your description should not be more than about 100-200 words, even if that comes at the cost of accuracy. There is a hard limit of 1024 characters — descriptions over that will be truncated, so stay comfortably under it. + +Here are some tips that we've found to work well in writing these descriptions: +- The skill should be phrased in the imperative -- "Use this skill for" rather than "this skill does" +- The skill description should focus on the user's intent, what they are trying to achieve, vs. the implementation details of how the skill works. +- The description competes with other skills for Claude's attention — make it distinctive and immediately recognizable. +- If you're getting lots of failures after repeated attempts, change things up. Try different sentence structures or wordings. + +I'd encourage you to be creative and mix up the style in different iterations since you'll have multiple opportunities to try different approaches and we'll just grab the highest-scoring one at the end. + +Please respond with only the new description text in tags, nothing else.""" + + text = _call_claude(prompt, model) + + match = re.search(r"(.*?)", text, re.DOTALL) + description = match.group(1).strip().strip('"') if match else text.strip().strip('"') + + transcript: dict = { + "iteration": iteration, + "prompt": prompt, + "response": text, + "parsed_description": description, + "char_count": len(description), + "over_limit": len(description) > 1024, + } + + # Safety net: the prompt already states the 1024-char hard limit, but if + # the model blew past it anyway, make one fresh single-turn call that + # quotes the too-long version and asks for a shorter rewrite. (The old + # SDK path did this as a true multi-turn; `claude -p` is one-shot, so we + # inline the prior output into the new prompt instead.) + if len(description) > 1024: + shorten_prompt = ( + f"{prompt}\n\n" + f"---\n\n" + f"A previous attempt produced this description, which at " + f"{len(description)} characters is over the 1024-character hard limit:\n\n" + f'"{description}"\n\n' + f"Rewrite it to be under 1024 characters while keeping the most " + f"important trigger words and intent coverage. Respond with only " + f"the new description in tags." + ) + shorten_text = _call_claude(shorten_prompt, model) + match = re.search(r"(.*?)", shorten_text, re.DOTALL) + shortened = match.group(1).strip().strip('"') if match else shorten_text.strip().strip('"') + + transcript["rewrite_prompt"] = shorten_prompt + transcript["rewrite_response"] = shorten_text + transcript["rewrite_description"] = shortened + transcript["rewrite_char_count"] = len(shortened) + description = shortened + + transcript["final_description"] = description + + if log_dir: + log_dir.mkdir(parents=True, exist_ok=True) + log_file = log_dir / f"improve_iter_{iteration or 'unknown'}.json" + log_file.write_text(json.dumps(transcript, indent=2)) + + return description + + +def main(): + parser = argparse.ArgumentParser(description="Improve a skill description based on eval results") + parser.add_argument("--eval-results", required=True, help="Path to eval results JSON (from run_eval.py)") + parser.add_argument("--skill-path", required=True, help="Path to skill directory") + parser.add_argument("--history", default=None, help="Path to history JSON (previous attempts)") + parser.add_argument("--model", required=True, help="Model for improvement") + parser.add_argument("--verbose", action="store_true", help="Print thinking to stderr") + args = parser.parse_args() + + skill_path = Path(args.skill_path) + if not (skill_path / "SKILL.md").exists(): + print(f"Error: No SKILL.md found at {skill_path}", file=sys.stderr) + sys.exit(1) + + eval_results = json.loads(Path(args.eval_results).read_text()) + history = [] + if args.history: + history = json.loads(Path(args.history).read_text()) + + name, _, content = parse_skill_md(skill_path) + current_description = eval_results["description"] + + if args.verbose: + print(f"Current: {current_description}", file=sys.stderr) + print(f"Score: {eval_results['summary']['passed']}/{eval_results['summary']['total']}", file=sys.stderr) + + new_description = improve_description( + skill_name=name, + skill_content=content, + current_description=current_description, + eval_results=eval_results, + history=history, + model=args.model, + ) + + if args.verbose: + print(f"Improved: {new_description}", file=sys.stderr) + + # Output as JSON with both the new description and updated history + output = { + "description": new_description, + "history": history + [{ + "description": current_description, + "passed": eval_results["summary"]["passed"], + "failed": eval_results["summary"]["failed"], + "total": eval_results["summary"]["total"], + "results": eval_results["results"], + }], + } + print(json.dumps(output, indent=2)) + + +if __name__ == "__main__": + main() diff --git a/.claude/skills/skill-creator/scripts/package_skill.py b/.claude/skills/skill-creator/scripts/package_skill.py new file mode 100755 index 000000000..f48eac444 --- /dev/null +++ b/.claude/skills/skill-creator/scripts/package_skill.py @@ -0,0 +1,136 @@ +#!/usr/bin/env python3 +""" +Skill Packager - Creates a distributable .skill file of a skill folder + +Usage: + python utils/package_skill.py [output-directory] + +Example: + python utils/package_skill.py skills/public/my-skill + python utils/package_skill.py skills/public/my-skill ./dist +""" + +import fnmatch +import sys +import zipfile +from pathlib import Path +from scripts.quick_validate import validate_skill + +# Patterns to exclude when packaging skills. +EXCLUDE_DIRS = {"__pycache__", "node_modules"} +EXCLUDE_GLOBS = {"*.pyc"} +EXCLUDE_FILES = {".DS_Store"} +# Directories excluded only at the skill root (not when nested deeper). +ROOT_EXCLUDE_DIRS = {"evals"} + + +def should_exclude(rel_path: Path) -> bool: + """Check if a path should be excluded from packaging.""" + parts = rel_path.parts + if any(part in EXCLUDE_DIRS for part in parts): + return True + # rel_path is relative to skill_path.parent, so parts[0] is the skill + # folder name and parts[1] (if present) is the first subdir. + if len(parts) > 1 and parts[1] in ROOT_EXCLUDE_DIRS: + return True + name = rel_path.name + if name in EXCLUDE_FILES: + return True + return any(fnmatch.fnmatch(name, pat) for pat in EXCLUDE_GLOBS) + + +def package_skill(skill_path, output_dir=None): + """ + Package a skill folder into a .skill file. + + Args: + skill_path: Path to the skill folder + output_dir: Optional output directory for the .skill file (defaults to current directory) + + Returns: + Path to the created .skill file, or None if error + """ + skill_path = Path(skill_path).resolve() + + # Validate skill folder exists + if not skill_path.exists(): + print(f"❌ Error: Skill folder not found: {skill_path}") + return None + + if not skill_path.is_dir(): + print(f"❌ Error: Path is not a directory: {skill_path}") + return None + + # Validate SKILL.md exists + skill_md = skill_path / "SKILL.md" + if not skill_md.exists(): + print(f"❌ Error: SKILL.md not found in {skill_path}") + return None + + # Run validation before packaging + print("🔍 Validating skill...") + valid, message = validate_skill(skill_path) + if not valid: + print(f"❌ Validation failed: {message}") + print(" Please fix the validation errors before packaging.") + return None + print(f"✅ {message}\n") + + # Determine output location + skill_name = skill_path.name + if output_dir: + output_path = Path(output_dir).resolve() + output_path.mkdir(parents=True, exist_ok=True) + else: + output_path = Path.cwd() + + skill_filename = output_path / f"{skill_name}.skill" + + # Create the .skill file (zip format) + try: + with zipfile.ZipFile(skill_filename, 'w', zipfile.ZIP_DEFLATED) as zipf: + # Walk through the skill directory, excluding build artifacts + for file_path in skill_path.rglob('*'): + if not file_path.is_file(): + continue + arcname = file_path.relative_to(skill_path.parent) + if should_exclude(arcname): + print(f" Skipped: {arcname}") + continue + zipf.write(file_path, arcname) + print(f" Added: {arcname}") + + print(f"\n✅ Successfully packaged skill to: {skill_filename}") + return skill_filename + + except Exception as e: + print(f"❌ Error creating .skill file: {e}") + return None + + +def main(): + if len(sys.argv) < 2: + print("Usage: python utils/package_skill.py [output-directory]") + print("\nExample:") + print(" python utils/package_skill.py skills/public/my-skill") + print(" python utils/package_skill.py skills/public/my-skill ./dist") + sys.exit(1) + + skill_path = sys.argv[1] + output_dir = sys.argv[2] if len(sys.argv) > 2 else None + + print(f"📦 Packaging skill: {skill_path}") + if output_dir: + print(f" Output directory: {output_dir}") + print() + + result = package_skill(skill_path, output_dir) + + if result: + sys.exit(0) + else: + sys.exit(1) + + +if __name__ == "__main__": + main() diff --git a/.claude/skills/skill-creator/scripts/quick_validate.py b/.claude/skills/skill-creator/scripts/quick_validate.py new file mode 100755 index 000000000..ed8e1dddc --- /dev/null +++ b/.claude/skills/skill-creator/scripts/quick_validate.py @@ -0,0 +1,103 @@ +#!/usr/bin/env python3 +""" +Quick validation script for skills - minimal version +""" + +import sys +import os +import re +import yaml +from pathlib import Path + +def validate_skill(skill_path): + """Basic validation of a skill""" + skill_path = Path(skill_path) + + # Check SKILL.md exists + skill_md = skill_path / 'SKILL.md' + if not skill_md.exists(): + return False, "SKILL.md not found" + + # Read and validate frontmatter + content = skill_md.read_text() + if not content.startswith('---'): + return False, "No YAML frontmatter found" + + # Extract frontmatter + match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL) + if not match: + return False, "Invalid frontmatter format" + + frontmatter_text = match.group(1) + + # Parse YAML frontmatter + try: + frontmatter = yaml.safe_load(frontmatter_text) + if not isinstance(frontmatter, dict): + return False, "Frontmatter must be a YAML dictionary" + except yaml.YAMLError as e: + return False, f"Invalid YAML in frontmatter: {e}" + + # Define allowed properties + ALLOWED_PROPERTIES = {'name', 'description', 'license', 'allowed-tools', 'metadata', 'compatibility'} + + # Check for unexpected properties (excluding nested keys under metadata) + unexpected_keys = set(frontmatter.keys()) - ALLOWED_PROPERTIES + if unexpected_keys: + return False, ( + f"Unexpected key(s) in SKILL.md frontmatter: {', '.join(sorted(unexpected_keys))}. " + f"Allowed properties are: {', '.join(sorted(ALLOWED_PROPERTIES))}" + ) + + # Check required fields + if 'name' not in frontmatter: + return False, "Missing 'name' in frontmatter" + if 'description' not in frontmatter: + return False, "Missing 'description' in frontmatter" + + # Extract name for validation + name = frontmatter.get('name', '') + if not isinstance(name, str): + return False, f"Name must be a string, got {type(name).__name__}" + name = name.strip() + if name: + # Check naming convention (kebab-case: lowercase with hyphens) + if not re.match(r'^[a-z0-9-]+$', name): + return False, f"Name '{name}' should be kebab-case (lowercase letters, digits, and hyphens only)" + if name.startswith('-') or name.endswith('-') or '--' in name: + return False, f"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens" + # Check name length (max 64 characters per spec) + if len(name) > 64: + return False, f"Name is too long ({len(name)} characters). Maximum is 64 characters." + + # Extract and validate description + description = frontmatter.get('description', '') + if not isinstance(description, str): + return False, f"Description must be a string, got {type(description).__name__}" + description = description.strip() + if description: + # Check for angle brackets + if '<' in description or '>' in description: + return False, "Description cannot contain angle brackets (< or >)" + # Check description length (max 1024 characters per spec) + if len(description) > 1024: + return False, f"Description is too long ({len(description)} characters). Maximum is 1024 characters." + + # Validate compatibility field if present (optional) + compatibility = frontmatter.get('compatibility', '') + if compatibility: + if not isinstance(compatibility, str): + return False, f"Compatibility must be a string, got {type(compatibility).__name__}" + if len(compatibility) > 500: + return False, f"Compatibility is too long ({len(compatibility)} characters). Maximum is 500 characters." + + return True, "Skill is valid!" + +if __name__ == "__main__": + if len(sys.argv) != 2: + print("Usage: python quick_validate.py ") + sys.exit(1) + + valid, message = validate_skill(sys.argv[1]) + print(message) + sys.exit(0 if valid else 1) \ No newline at end of file diff --git a/.claude/skills/skill-creator/scripts/run_eval.py b/.claude/skills/skill-creator/scripts/run_eval.py new file mode 100755 index 000000000..e58c70bea --- /dev/null +++ b/.claude/skills/skill-creator/scripts/run_eval.py @@ -0,0 +1,310 @@ +#!/usr/bin/env python3 +"""Run trigger evaluation for a skill description. + +Tests whether a skill's description causes Claude to trigger (read the skill) +for a set of queries. Outputs results as JSON. +""" + +import argparse +import json +import os +import select +import subprocess +import sys +import time +import uuid +from concurrent.futures import ProcessPoolExecutor, as_completed +from pathlib import Path + +from scripts.utils import parse_skill_md + + +def find_project_root() -> Path: + """Find the project root by walking up from cwd looking for .claude/. + + Mimics how Claude Code discovers its project root, so the command file + we create ends up where claude -p will look for it. + """ + current = Path.cwd() + for parent in [current, *current.parents]: + if (parent / ".claude").is_dir(): + return parent + return current + + +def run_single_query( + query: str, + skill_name: str, + skill_description: str, + timeout: int, + project_root: str, + model: str | None = None, +) -> bool: + """Run a single query and return whether the skill was triggered. + + Creates a command file in .claude/commands/ so it appears in Claude's + available_skills list, then runs `claude -p` with the raw query. + Uses --include-partial-messages to detect triggering early from + stream events (content_block_start) rather than waiting for the + full assistant message, which only arrives after tool execution. + """ + unique_id = uuid.uuid4().hex[:8] + clean_name = f"{skill_name}-skill-{unique_id}" + project_commands_dir = Path(project_root) / ".claude" / "commands" + command_file = project_commands_dir / f"{clean_name}.md" + + try: + project_commands_dir.mkdir(parents=True, exist_ok=True) + # Use YAML block scalar to avoid breaking on quotes in description + indented_desc = "\n ".join(skill_description.split("\n")) + command_content = ( + f"---\n" + f"description: |\n" + f" {indented_desc}\n" + f"---\n\n" + f"# {skill_name}\n\n" + f"This skill handles: {skill_description}\n" + ) + command_file.write_text(command_content) + + cmd = [ + "claude", + "-p", query, + "--output-format", "stream-json", + "--verbose", + "--include-partial-messages", + ] + if model: + cmd.extend(["--model", model]) + + # Remove CLAUDECODE env var to allow nesting claude -p inside a + # Claude Code session. The guard is for interactive terminal conflicts; + # programmatic subprocess usage is safe. + env = {k: v for k, v in os.environ.items() if k != "CLAUDECODE"} + + process = subprocess.Popen( + cmd, + stdout=subprocess.PIPE, + stderr=subprocess.DEVNULL, + cwd=project_root, + env=env, + ) + + triggered = False + start_time = time.time() + buffer = "" + # Track state for stream event detection + pending_tool_name = None + accumulated_json = "" + + try: + while time.time() - start_time < timeout: + if process.poll() is not None: + remaining = process.stdout.read() + if remaining: + buffer += remaining.decode("utf-8", errors="replace") + break + + ready, _, _ = select.select([process.stdout], [], [], 1.0) + if not ready: + continue + + chunk = os.read(process.stdout.fileno(), 8192) + if not chunk: + break + buffer += chunk.decode("utf-8", errors="replace") + + while "\n" in buffer: + line, buffer = buffer.split("\n", 1) + line = line.strip() + if not line: + continue + + try: + event = json.loads(line) + except json.JSONDecodeError: + continue + + # Early detection via stream events + if event.get("type") == "stream_event": + se = event.get("event", {}) + se_type = se.get("type", "") + + if se_type == "content_block_start": + cb = se.get("content_block", {}) + if cb.get("type") == "tool_use": + tool_name = cb.get("name", "") + if tool_name in ("Skill", "Read"): + pending_tool_name = tool_name + accumulated_json = "" + else: + return False + + elif se_type == "content_block_delta" and pending_tool_name: + delta = se.get("delta", {}) + if delta.get("type") == "input_json_delta": + accumulated_json += delta.get("partial_json", "") + if clean_name in accumulated_json: + return True + + elif se_type in ("content_block_stop", "message_stop"): + if pending_tool_name: + return clean_name in accumulated_json + if se_type == "message_stop": + return False + + # Fallback: full assistant message + elif event.get("type") == "assistant": + message = event.get("message", {}) + for content_item in message.get("content", []): + if content_item.get("type") != "tool_use": + continue + tool_name = content_item.get("name", "") + tool_input = content_item.get("input", {}) + if tool_name == "Skill" and clean_name in tool_input.get("skill", ""): + triggered = True + elif tool_name == "Read" and clean_name in tool_input.get("file_path", ""): + triggered = True + return triggered + + elif event.get("type") == "result": + return triggered + finally: + # Clean up process on any exit path (return, exception, timeout) + if process.poll() is None: + process.kill() + process.wait() + + return triggered + finally: + if command_file.exists(): + command_file.unlink() + + +def run_eval( + eval_set: list[dict], + skill_name: str, + description: str, + num_workers: int, + timeout: int, + project_root: Path, + runs_per_query: int = 1, + trigger_threshold: float = 0.5, + model: str | None = None, +) -> dict: + """Run the full eval set and return results.""" + results = [] + + with ProcessPoolExecutor(max_workers=num_workers) as executor: + future_to_info = {} + for item in eval_set: + for run_idx in range(runs_per_query): + future = executor.submit( + run_single_query, + item["query"], + skill_name, + description, + timeout, + str(project_root), + model, + ) + future_to_info[future] = (item, run_idx) + + query_triggers: dict[str, list[bool]] = {} + query_items: dict[str, dict] = {} + for future in as_completed(future_to_info): + item, _ = future_to_info[future] + query = item["query"] + query_items[query] = item + if query not in query_triggers: + query_triggers[query] = [] + try: + query_triggers[query].append(future.result()) + except Exception as e: + print(f"Warning: query failed: {e}", file=sys.stderr) + query_triggers[query].append(False) + + for query, triggers in query_triggers.items(): + item = query_items[query] + trigger_rate = sum(triggers) / len(triggers) + should_trigger = item["should_trigger"] + if should_trigger: + did_pass = trigger_rate >= trigger_threshold + else: + did_pass = trigger_rate < trigger_threshold + results.append({ + "query": query, + "should_trigger": should_trigger, + "trigger_rate": trigger_rate, + "triggers": sum(triggers), + "runs": len(triggers), + "pass": did_pass, + }) + + passed = sum(1 for r in results if r["pass"]) + total = len(results) + + return { + "skill_name": skill_name, + "description": description, + "results": results, + "summary": { + "total": total, + "passed": passed, + "failed": total - passed, + }, + } + + +def main(): + parser = argparse.ArgumentParser(description="Run trigger evaluation for a skill description") + parser.add_argument("--eval-set", required=True, help="Path to eval set JSON file") + parser.add_argument("--skill-path", required=True, help="Path to skill directory") + parser.add_argument("--description", default=None, help="Override description to test") + parser.add_argument("--num-workers", type=int, default=10, help="Number of parallel workers") + parser.add_argument("--timeout", type=int, default=30, help="Timeout per query in seconds") + parser.add_argument("--runs-per-query", type=int, default=3, help="Number of runs per query") + parser.add_argument("--trigger-threshold", type=float, default=0.5, help="Trigger rate threshold") + parser.add_argument("--model", default=None, help="Model to use for claude -p (default: user's configured model)") + parser.add_argument("--verbose", action="store_true", help="Print progress to stderr") + args = parser.parse_args() + + eval_set = json.loads(Path(args.eval_set).read_text()) + skill_path = Path(args.skill_path) + + if not (skill_path / "SKILL.md").exists(): + print(f"Error: No SKILL.md found at {skill_path}", file=sys.stderr) + sys.exit(1) + + name, original_description, content = parse_skill_md(skill_path) + description = args.description or original_description + project_root = find_project_root() + + if args.verbose: + print(f"Evaluating: {description}", file=sys.stderr) + + output = run_eval( + eval_set=eval_set, + skill_name=name, + description=description, + num_workers=args.num_workers, + timeout=args.timeout, + project_root=project_root, + runs_per_query=args.runs_per_query, + trigger_threshold=args.trigger_threshold, + model=args.model, + ) + + if args.verbose: + summary = output["summary"] + print(f"Results: {summary['passed']}/{summary['total']} passed", file=sys.stderr) + for r in output["results"]: + status = "PASS" if r["pass"] else "FAIL" + rate_str = f"{r['triggers']}/{r['runs']}" + print(f" [{status}] rate={rate_str} expected={r['should_trigger']}: {r['query'][:70]}", file=sys.stderr) + + print(json.dumps(output, indent=2)) + + +if __name__ == "__main__": + main() diff --git a/.claude/skills/skill-creator/scripts/run_loop.py b/.claude/skills/skill-creator/scripts/run_loop.py new file mode 100755 index 000000000..30a263d67 --- /dev/null +++ b/.claude/skills/skill-creator/scripts/run_loop.py @@ -0,0 +1,328 @@ +#!/usr/bin/env python3 +"""Run the eval + improve loop until all pass or max iterations reached. + +Combines run_eval.py and improve_description.py in a loop, tracking history +and returning the best description found. Supports train/test split to prevent +overfitting. +""" + +import argparse +import json +import random +import sys +import tempfile +import time +import webbrowser +from pathlib import Path + +from scripts.generate_report import generate_html +from scripts.improve_description import improve_description +from scripts.run_eval import find_project_root, run_eval +from scripts.utils import parse_skill_md + + +def split_eval_set(eval_set: list[dict], holdout: float, seed: int = 42) -> tuple[list[dict], list[dict]]: + """Split eval set into train and test sets, stratified by should_trigger.""" + random.seed(seed) + + # Separate by should_trigger + trigger = [e for e in eval_set if e["should_trigger"]] + no_trigger = [e for e in eval_set if not e["should_trigger"]] + + # Shuffle each group + random.shuffle(trigger) + random.shuffle(no_trigger) + + # Calculate split points + n_trigger_test = max(1, int(len(trigger) * holdout)) + n_no_trigger_test = max(1, int(len(no_trigger) * holdout)) + + # Split + test_set = trigger[:n_trigger_test] + no_trigger[:n_no_trigger_test] + train_set = trigger[n_trigger_test:] + no_trigger[n_no_trigger_test:] + + return train_set, test_set + + +def run_loop( + eval_set: list[dict], + skill_path: Path, + description_override: str | None, + num_workers: int, + timeout: int, + max_iterations: int, + runs_per_query: int, + trigger_threshold: float, + holdout: float, + model: str, + verbose: bool, + live_report_path: Path | None = None, + log_dir: Path | None = None, +) -> dict: + """Run the eval + improvement loop.""" + project_root = find_project_root() + name, original_description, content = parse_skill_md(skill_path) + current_description = description_override or original_description + + # Split into train/test if holdout > 0 + if holdout > 0: + train_set, test_set = split_eval_set(eval_set, holdout) + if verbose: + print(f"Split: {len(train_set)} train, {len(test_set)} test (holdout={holdout})", file=sys.stderr) + else: + train_set = eval_set + test_set = [] + + history = [] + exit_reason = "unknown" + + for iteration in range(1, max_iterations + 1): + if verbose: + print(f"\n{'='*60}", file=sys.stderr) + print(f"Iteration {iteration}/{max_iterations}", file=sys.stderr) + print(f"Description: {current_description}", file=sys.stderr) + print(f"{'='*60}", file=sys.stderr) + + # Evaluate train + test together in one batch for parallelism + all_queries = train_set + test_set + t0 = time.time() + all_results = run_eval( + eval_set=all_queries, + skill_name=name, + description=current_description, + num_workers=num_workers, + timeout=timeout, + project_root=project_root, + runs_per_query=runs_per_query, + trigger_threshold=trigger_threshold, + model=model, + ) + eval_elapsed = time.time() - t0 + + # Split results back into train/test by matching queries + train_queries_set = {q["query"] for q in train_set} + train_result_list = [r for r in all_results["results"] if r["query"] in train_queries_set] + test_result_list = [r for r in all_results["results"] if r["query"] not in train_queries_set] + + train_passed = sum(1 for r in train_result_list if r["pass"]) + train_total = len(train_result_list) + train_summary = {"passed": train_passed, "failed": train_total - train_passed, "total": train_total} + train_results = {"results": train_result_list, "summary": train_summary} + + if test_set: + test_passed = sum(1 for r in test_result_list if r["pass"]) + test_total = len(test_result_list) + test_summary = {"passed": test_passed, "failed": test_total - test_passed, "total": test_total} + test_results = {"results": test_result_list, "summary": test_summary} + else: + test_results = None + test_summary = None + + history.append({ + "iteration": iteration, + "description": current_description, + "train_passed": train_summary["passed"], + "train_failed": train_summary["failed"], + "train_total": train_summary["total"], + "train_results": train_results["results"], + "test_passed": test_summary["passed"] if test_summary else None, + "test_failed": test_summary["failed"] if test_summary else None, + "test_total": test_summary["total"] if test_summary else None, + "test_results": test_results["results"] if test_results else None, + # For backward compat with report generator + "passed": train_summary["passed"], + "failed": train_summary["failed"], + "total": train_summary["total"], + "results": train_results["results"], + }) + + # Write live report if path provided + if live_report_path: + partial_output = { + "original_description": original_description, + "best_description": current_description, + "best_score": "in progress", + "iterations_run": len(history), + "holdout": holdout, + "train_size": len(train_set), + "test_size": len(test_set), + "history": history, + } + live_report_path.write_text(generate_html(partial_output, auto_refresh=True, skill_name=name)) + + if verbose: + def print_eval_stats(label, results, elapsed): + pos = [r for r in results if r["should_trigger"]] + neg = [r for r in results if not r["should_trigger"]] + tp = sum(r["triggers"] for r in pos) + pos_runs = sum(r["runs"] for r in pos) + fn = pos_runs - tp + fp = sum(r["triggers"] for r in neg) + neg_runs = sum(r["runs"] for r in neg) + tn = neg_runs - fp + total = tp + tn + fp + fn + precision = tp / (tp + fp) if (tp + fp) > 0 else 1.0 + recall = tp / (tp + fn) if (tp + fn) > 0 else 1.0 + accuracy = (tp + tn) / total if total > 0 else 0.0 + print(f"{label}: {tp+tn}/{total} correct, precision={precision:.0%} recall={recall:.0%} accuracy={accuracy:.0%} ({elapsed:.1f}s)", file=sys.stderr) + for r in results: + status = "PASS" if r["pass"] else "FAIL" + rate_str = f"{r['triggers']}/{r['runs']}" + print(f" [{status}] rate={rate_str} expected={r['should_trigger']}: {r['query'][:60]}", file=sys.stderr) + + print_eval_stats("Train", train_results["results"], eval_elapsed) + if test_summary: + print_eval_stats("Test ", test_results["results"], 0) + + if train_summary["failed"] == 0: + exit_reason = f"all_passed (iteration {iteration})" + if verbose: + print(f"\nAll train queries passed on iteration {iteration}!", file=sys.stderr) + break + + if iteration == max_iterations: + exit_reason = f"max_iterations ({max_iterations})" + if verbose: + print(f"\nMax iterations reached ({max_iterations}).", file=sys.stderr) + break + + # Improve the description based on train results + if verbose: + print(f"\nImproving description...", file=sys.stderr) + + t0 = time.time() + # Strip test scores from history so improvement model can't see them + blinded_history = [ + {k: v for k, v in h.items() if not k.startswith("test_")} + for h in history + ] + new_description = improve_description( + skill_name=name, + skill_content=content, + current_description=current_description, + eval_results=train_results, + history=blinded_history, + model=model, + log_dir=log_dir, + iteration=iteration, + ) + improve_elapsed = time.time() - t0 + + if verbose: + print(f"Proposed ({improve_elapsed:.1f}s): {new_description}", file=sys.stderr) + + current_description = new_description + + # Find the best iteration by TEST score (or train if no test set) + if test_set: + best = max(history, key=lambda h: h["test_passed"] or 0) + best_score = f"{best['test_passed']}/{best['test_total']}" + else: + best = max(history, key=lambda h: h["train_passed"]) + best_score = f"{best['train_passed']}/{best['train_total']}" + + if verbose: + print(f"\nExit reason: {exit_reason}", file=sys.stderr) + print(f"Best score: {best_score} (iteration {best['iteration']})", file=sys.stderr) + + return { + "exit_reason": exit_reason, + "original_description": original_description, + "best_description": best["description"], + "best_score": best_score, + "best_train_score": f"{best['train_passed']}/{best['train_total']}", + "best_test_score": f"{best['test_passed']}/{best['test_total']}" if test_set else None, + "final_description": current_description, + "iterations_run": len(history), + "holdout": holdout, + "train_size": len(train_set), + "test_size": len(test_set), + "history": history, + } + + +def main(): + parser = argparse.ArgumentParser(description="Run eval + improve loop") + parser.add_argument("--eval-set", required=True, help="Path to eval set JSON file") + parser.add_argument("--skill-path", required=True, help="Path to skill directory") + parser.add_argument("--description", default=None, help="Override starting description") + parser.add_argument("--num-workers", type=int, default=10, help="Number of parallel workers") + parser.add_argument("--timeout", type=int, default=30, help="Timeout per query in seconds") + parser.add_argument("--max-iterations", type=int, default=5, help="Max improvement iterations") + parser.add_argument("--runs-per-query", type=int, default=3, help="Number of runs per query") + parser.add_argument("--trigger-threshold", type=float, default=0.5, help="Trigger rate threshold") + parser.add_argument("--holdout", type=float, default=0.4, help="Fraction of eval set to hold out for testing (0 to disable)") + parser.add_argument("--model", required=True, help="Model for improvement") + parser.add_argument("--verbose", action="store_true", help="Print progress to stderr") + parser.add_argument("--report", default="auto", help="Generate HTML report at this path (default: 'auto' for temp file, 'none' to disable)") + parser.add_argument("--results-dir", default=None, help="Save all outputs (results.json, report.html, log.txt) to a timestamped subdirectory here") + args = parser.parse_args() + + eval_set = json.loads(Path(args.eval_set).read_text()) + skill_path = Path(args.skill_path) + + if not (skill_path / "SKILL.md").exists(): + print(f"Error: No SKILL.md found at {skill_path}", file=sys.stderr) + sys.exit(1) + + name, _, _ = parse_skill_md(skill_path) + + # Set up live report path + if args.report != "none": + if args.report == "auto": + timestamp = time.strftime("%Y%m%d_%H%M%S") + live_report_path = Path(tempfile.gettempdir()) / f"skill_description_report_{skill_path.name}_{timestamp}.html" + else: + live_report_path = Path(args.report) + # Open the report immediately so the user can watch + live_report_path.write_text("

Starting optimization loop...

") + webbrowser.open(str(live_report_path)) + else: + live_report_path = None + + # Determine output directory (create before run_loop so logs can be written) + if args.results_dir: + timestamp = time.strftime("%Y-%m-%d_%H%M%S") + results_dir = Path(args.results_dir) / timestamp + results_dir.mkdir(parents=True, exist_ok=True) + else: + results_dir = None + + log_dir = results_dir / "logs" if results_dir else None + + output = run_loop( + eval_set=eval_set, + skill_path=skill_path, + description_override=args.description, + num_workers=args.num_workers, + timeout=args.timeout, + max_iterations=args.max_iterations, + runs_per_query=args.runs_per_query, + trigger_threshold=args.trigger_threshold, + holdout=args.holdout, + model=args.model, + verbose=args.verbose, + live_report_path=live_report_path, + log_dir=log_dir, + ) + + # Save JSON output + json_output = json.dumps(output, indent=2) + print(json_output) + if results_dir: + (results_dir / "results.json").write_text(json_output) + + # Write final HTML report (without auto-refresh) + if live_report_path: + live_report_path.write_text(generate_html(output, auto_refresh=False, skill_name=name)) + print(f"\nReport: {live_report_path}", file=sys.stderr) + + if results_dir and live_report_path: + (results_dir / "report.html").write_text(generate_html(output, auto_refresh=False, skill_name=name)) + + if results_dir: + print(f"Results saved to: {results_dir}", file=sys.stderr) + + +if __name__ == "__main__": + main() diff --git a/.claude/skills/skill-creator/scripts/utils.py b/.claude/skills/skill-creator/scripts/utils.py new file mode 100644 index 000000000..51b6a07dd --- /dev/null +++ b/.claude/skills/skill-creator/scripts/utils.py @@ -0,0 +1,47 @@ +"""Shared utilities for skill-creator scripts.""" + +from pathlib import Path + + + +def parse_skill_md(skill_path: Path) -> tuple[str, str, str]: + """Parse a SKILL.md file, returning (name, description, full_content).""" + content = (skill_path / "SKILL.md").read_text() + lines = content.split("\n") + + if lines[0].strip() != "---": + raise ValueError("SKILL.md missing frontmatter (no opening ---)") + + end_idx = None + for i, line in enumerate(lines[1:], start=1): + if line.strip() == "---": + end_idx = i + break + + if end_idx is None: + raise ValueError("SKILL.md missing frontmatter (no closing ---)") + + name = "" + description = "" + frontmatter_lines = lines[1:end_idx] + i = 0 + while i < len(frontmatter_lines): + line = frontmatter_lines[i] + if line.startswith("name:"): + name = line[len("name:"):].strip().strip('"').strip("'") + elif line.startswith("description:"): + value = line[len("description:"):].strip() + # Handle YAML multiline indicators (>, |, >-, |-) + if value in (">", "|", ">-", "|-"): + continuation_lines: list[str] = [] + i += 1 + while i < len(frontmatter_lines) and (frontmatter_lines[i].startswith(" ") or frontmatter_lines[i].startswith("\t")): + continuation_lines.append(frontmatter_lines[i].strip()) + i += 1 + description = " ".join(continuation_lines) + continue + else: + description = value.strip('"').strip("'") + i += 1 + + return name, description, content From d4caba09678f887b49b7dee3f121a99f21238e7e Mon Sep 17 00:00:00 2001 From: simianastronaut Date: Sat, 7 Mar 2026 21:39:31 -0500 Subject: [PATCH 03/35] Removing extraneous required fields from Github PRs --- .github/ISSUE_TEMPLATE/bug_report.yml | 20 +++++--------------- .github/ISSUE_TEMPLATE/feature_request.yml | 16 ++++++++-------- 2 files changed, 13 insertions(+), 23 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 80811388d..9f10edfe0 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -11,15 +11,6 @@ body: Please provide a minimal reproducible case so maintainers can triage quickly. Do not include personal/sensitive data; redact and anonymize all logs/payloads. - - type: input - id: summary - attributes: - label: Summary - description: One-line description of the problem. - placeholder: zeroclaw daemon exits immediately when ... - validations: - required: true - - type: dropdown id: component attributes: @@ -83,13 +74,13 @@ body: id: impact attributes: label: Impact - description: Who is affected, how often, and practical consequences. + description: Who is affected, how often, and practical consequences (optional but helps triage). placeholder: | Affected users: ... Frequency: always/intermittent Consequence: ... validations: - required: true + required: false - type: textarea id: logs @@ -112,9 +103,10 @@ body: id: rust attributes: label: Rust version + description: Required for runtime/build bugs; optional for docs/config issues. placeholder: rustc 1.xx.x validations: - required: true + required: false - type: input id: os @@ -142,7 +134,5 @@ body: options: - label: I reproduced this on the latest master branch or latest release. required: true - - label: I redacted secrets/tokens from logs. - required: true - - label: I removed personal identifiers and replaced identity-specific data with neutral placeholders. + - label: I redacted secrets, tokens, and personal data from all submitted content. required: true diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml index 25fa32b43..f1c07a15f 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yml +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -42,10 +42,10 @@ body: id: non_goals attributes: label: Non-goals / out of scope - description: Clarify what should not be included in the first iteration. + description: Clarify what should not be included in the first iteration (optional but helps scope discussion). placeholder: No UI changes, no cross-provider dynamic adaptation in v1. validations: - required: true + required: false - type: textarea id: alternatives @@ -60,31 +60,31 @@ body: id: acceptance attributes: label: Acceptance criteria - description: What outcomes would make this request complete? + description: What outcomes would make this request complete? (optional — can be defined during triage) placeholder: | - Config key is documented and validated - Runtime path uses configured retry budget - Regression tests cover fallback and invalid config validations: - required: true + required: false - type: textarea id: architecture attributes: label: Architecture impact - description: Which subsystem(s) are affected? + description: Which subsystem(s) are affected? (optional — maintainers will assess during triage) placeholder: providers/, channels/, memory/, runtime/, security/, docs/ ... validations: - required: true + required: false - type: textarea id: risk attributes: label: Risk and rollback - description: Main risk + how to disable/revert quickly. + description: Main risk + how to disable/revert quickly (optional — can be defined during planning). placeholder: Risk is ... rollback is ... validations: - required: true + required: false - type: dropdown id: breaking From a7e295c966358073b7d0fe107f4683814da47680 Mon Sep 17 00:00:00 2001 From: simianastronaut Date: Sat, 7 Mar 2026 21:48:58 -0500 Subject: [PATCH 04/35] Skill for making PRs in the proper format --- .claude/skills/github-issue/SKILL.md | 133 +++++++++++++++++++++++++++ 1 file changed, 133 insertions(+) create mode 100644 .claude/skills/github-issue/SKILL.md diff --git a/.claude/skills/github-issue/SKILL.md b/.claude/skills/github-issue/SKILL.md new file mode 100644 index 000000000..2f793ca36 --- /dev/null +++ b/.claude/skills/github-issue/SKILL.md @@ -0,0 +1,133 @@ +# Skill: github-issue + +File a structured GitHub issue (bug report or feature request) for ZeroClaw interactively from Claude Code. + +## When to Use + +Trigger when the user wants to file a GitHub issue, report a bug, or request a feature for ZeroClaw. Keywords: "file issue", "report bug", "feature request", "open issue", "create issue", "github issue". + +## Instructions + +You are filing a GitHub issue against the ZeroClaw repository using structured issue forms. Follow this workflow exactly. + +### Step 1: Detect Issue Type and Read the Template + +Determine from the user's message whether this is a **bug report** or **feature request**. +- If unclear, use AskUserQuestion to ask: "Is this a bug report or a feature request?" + +Then read the corresponding issue template to understand the required fields: + +- Bug report: `.github/ISSUE_TEMPLATE/bug_report.yml` +- Feature request: `.github/ISSUE_TEMPLATE/feature_request.yml` + +Parse the YAML to extract: +- The `title` prefix (e.g. `[Bug]: `, `[Feature]: `) +- The `labels` array +- Each field in the `body` array: its `type` (dropdown, textarea, input, checkboxes, markdown), `id`, `attributes.label`, `attributes.options` (for dropdowns), `attributes.description`, `attributes.placeholder`, and `validations.required` + +This is the source of truth for what fields exist, what they're called, what options are available, and which are required. Do not assume or hardcode any field names or options — always derive them from the template file. + +### Step 2: Auto-Gather Context + +Before asking the user anything, silently gather environment and repo context: + +```bash +# Git context +git log --oneline -5 +git status --short +git diff --stat HEAD~1 2>/dev/null + +# For bug reports — environment detection +uname -s -r -m # OS info +sw_vers 2>/dev/null # macOS version +rustc --version 2>/dev/null # Rust version +cargo metadata --format-version=1 --no-deps 2>/dev/null | jq -r '.packages[] | select(.name=="zeroclaw") | .version' 2>/dev/null # ZeroClaw version +git rev-parse --short HEAD # commit SHA fallback +``` + +Also read recently changed files to infer the affected component and architecture impact. + +### Step 3: Pre-Fill and Present the Form + +Using the parsed template fields and gathered context, draft values for ALL fields from the template: + +- **dropdown** fields: select the most likely option from `attributes.options` based on context. For dropdowns where you're uncertain, note your best guess and flag it for the user. +- **textarea** fields: draft content based on the user's description, git context, and the field's `attributes.description`/`attributes.placeholder` for guidance on what's expected. +- **input** fields: fill with auto-detected values (versions, OS) or draft from user context. +- **checkboxes** fields: auto-check all items (the skill itself ensures compliance with the stated checks). +- **markdown** fields: skip these — they're informational headers, not form inputs. +- **optional fields** (where `validations.required` is false): fill if there's enough context, otherwise note "(optional — not enough context to fill)". + +Present the complete draft to the user in a clean readable format: + +``` +## Issue Draft: [Bug]: / [Feature]: <title> +**Labels**: <from template> + +### <Field Label> +<proposed value or selection> + +### <Field Label> +<proposed value> +... +``` + +Use AskUserQuestion to ask the user to review: +- "Here's the pre-filled issue. Please review and let me know what to change, or say 'submit' to file it." + +If the user requests changes, update the draft and re-present. Iterate until the user approves. + +### Step 4: Scope Guard + +Before final submission, analyze the collected content for scope creep: +- Does the bug report describe multiple independent defects? +- Does the feature request bundle unrelated changes? + +If multi-concept issues are detected: +1. Inform the user: "This issue appears to cover multiple distinct topics. Focused, single-concept issues are strongly preferred and more likely to be accepted." +2. Break down the distinct groups found. +3. Offer to file separate issues for each group, reusing shared context (environment, etc.). +4. Let the user decide: proceed as-is or split. + +### Step 5: Construct Issue Body + +Build the issue body as markdown sections matching GitHub's form-field rendering format. GitHub renders form-submitted issues with `### <Field Label>` sections, so use that exact structure. + +For each non-markdown field from the template, in order: + +```markdown +### <attributes.label> + +<value> +``` + +For optional fields with no content, use `_No response_` as the value (this matches GitHub's native rendering for empty optional fields). + +For checkbox fields, render each option as: +```markdown +- [X] <option label text> +``` + +### Step 6: Final Preview and Submit + +Show the final constructed issue (title + labels + full body) for one last confirmation. + +Then submit using a HEREDOC for the body to preserve formatting: + +```bash +gh issue create --title "<title prefix><user title>" --label "<label1>,<label2>" --body "$(cat <<'ISSUE_EOF' +<body content> +ISSUE_EOF +)" +``` + +Return the resulting issue URL to the user. + +### Important Rules + +- **Always read the template file** — never assume field names, options, or structure. The templates are the source of truth and may change over time. +- **Never include personal/sensitive data** in the issue. Redact secrets, tokens, emails, real names. +- **Use neutral project-scoped placeholders** per ZeroClaw's privacy contract. +- **One concept per issue** — enforce the scope guard. +- **Auto-detect, don't guess** — use real command output for environment fields. +- **Match GitHub's rendering** — use `### Field Label` sections so issues look consistent whether filed via web UI or this skill. From 57065b07a3ec87c0679f92937783756220884c64 Mon Sep 17 00:00:00 2001 From: simianastronaut <simianastronaut7@gmail.com> Date: Sat, 7 Mar 2026 21:54:16 -0500 Subject: [PATCH 05/35] PR creation/update skill --- .claude/skills/github-pr/SKILL.md | 209 ++++++++++++++++++++++++++++++ 1 file changed, 209 insertions(+) create mode 100644 .claude/skills/github-pr/SKILL.md diff --git a/.claude/skills/github-pr/SKILL.md b/.claude/skills/github-pr/SKILL.md new file mode 100644 index 000000000..e14be55c7 --- /dev/null +++ b/.claude/skills/github-pr/SKILL.md @@ -0,0 +1,209 @@ +# Skill: github-pr + +Open or update a GitHub Pull Request for ZeroClaw. Handles creating new PRs with a fully filled-out template body, and updating existing PRs (title, body sections, labels, comments). Use this skill whenever the user wants to open a PR, create a pull request, update a PR, edit PR description, add labels to a PR, or sync a PR after new commits — even if they don't say "PR" explicitly (e.g., "submit this for review", "push and open for merge"). + +## Instructions + +This skill supports two modes: **Open** (create a new PR) and **Update** (edit an existing PR). Detect the mode from context — if there's already an open PR for the current branch and the user didn't say "open a new PR", default to update mode. + +The PR template at `.github/pull_request_template.md` is the source of truth for the PR body structure. Read it every time — never assume or hardcode section names, fields, or their order. The template may change over time and the skill should always reflect its current state. + +--- + +## Shared: Read the PR Template + +Before opening or updating a PR body, read `.github/pull_request_template.md` and parse it to understand: + +- The `## ` section headers (these are the top-level sections of the PR body) +- The bullet points, fields, and prompts within each section +- Which sections are marked `(required)` vs optional/recommended +- Any inline formatting conventions (backtick options, Yes/No fields, etc.) + +This parsed structure drives how you fill, present, and edit the PR body. + +--- + +## Mode: Open a New PR + +### Step 1: Gather Context + +Collect information to pre-fill the PR body. Run these in parallel: + +```bash +# Branch and commit context +git branch --show-current +git log master..HEAD --oneline +git diff master...HEAD --stat + +# Check if branch is pushed +git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>/dev/null + +# Environment (for validation evidence) +rustc --version 2>/dev/null +``` + +Also review the changed files and commit messages to understand the nature of the change (bug fix, feature, refactor, docs, chore, etc.) and which subsystems are affected. + +### Step 2: Pre-Fill the Template + +Using the parsed template structure and gathered context, draft a complete PR body: + +- For each `## ` section from the template, fill in the bullet points and fields based on context from the commits, diff, and changed files. +- Use the field descriptions and placeholder text in the template as guidance for what each field expects. +- For Yes/No fields, infer from the diff (e.g., if no files in `src/security/` changed, security impact is likely all No). +- For required sections, always provide a substantive answer. For optional sections, fill if there's enough context, otherwise leave the template prompts in place. +- Draft a conventional commit-style PR title based on the changes (e.g., `feat(provider): add retry budget override`, `fix(channel): handle disconnect gracefully`, `chore(ci): update workflow targets`). + +### Step 3: Present Draft for Review + +Show the user the complete draft: + +``` +## PR Draft: <title> +**Branch**: <head> -> master +**Labels**: <suggested labels> + +<full body with all sections filled> +``` + +Ask the user to review: "Here's the pre-filled PR. Review and let me know what to change, or say 'submit' to open it." + +Iterate on changes until the user approves. + +### Step 4: Push and Create + +1. If the branch isn't pushed yet, push it: + ```bash + git push -u origin <branch> + ``` + +2. Create the PR using a HEREDOC for the body: + ```bash + gh pr create --title "<title>" --base master --body "$(cat <<'PR_BODY_EOF' + <full body> + PR_BODY_EOF + )" + ``` + +3. If labels were agreed on, add them: + ```bash + gh pr edit <number> --add-label "<label1>,<label2>" + ``` + +4. Return the PR URL to the user. + +--- + +## Mode: Update an Existing PR + +### Step 1: Identify the PR + +1. **If a PR number or URL is given**: use that directly. +2. **If on a branch with an open PR**: auto-detect: + ```bash + gh pr view --json number,title,body,labels,state,author,url,headRefName 2>/dev/null + ``` +3. **If neither**: ask the user for the PR number. + +Verify the current user is the PR author: +```bash +CURRENT_USER=$(gh api user --jq '.login') +PR_AUTHOR=$(gh pr view <number> --json author --jq '.author.login') +``` +If not the author, stop and inform the user. + +### Step 2: Fetch Current State + +```bash +gh pr view <number> --json number,title,body,labels,state,baseRefName,headRefName,url,author,reviewDecision,statusCheckRollup,commits +``` + +Display a summary: +``` +## PR #<number>: <title> +**State**: <open/closed/merged> +**Branch**: <head> -> <base> +**Labels**: <label list> +**Checks**: <pass/fail/pending> +**URL**: <url> +``` + +### Step 3: Determine What to Update + +Support these operations: + +| Operation | How | +|---|---| +| **Edit title** | `gh pr edit <number> --title "<new title>"` | +| **Edit full body** | `gh pr edit <number> --body "<new body>"` | +| **Add labels** | `gh pr edit <number> --add-label "<label1>,<label2>"` | +| **Remove labels** | `gh pr edit <number> --remove-label "<label1>"` | +| **Edit specific section** | Parse body by `## ` headers, modify target section, re-submit full body | +| **Add a comment** | `gh pr comment <number> --body "<comment>"` | +| **Link an issue** | Edit the linked-issue section in the body | +| **Smart update after new commits** | Re-analyze and suggest section updates | + +### Step 4: Handle Body Section Edits + +When editing a specific section: + +1. Parse the current PR body into sections by `## ` headers +2. Match the user's request to the corresponding section from the template +3. Show the current content of that section and the proposed replacement +4. On confirmation, modify only that section, reconstruct the full body, and submit + +### Step 5: Smart Update After New Commits + +When the user wants to sync the PR description after pushing new changes: + +1. Identify new commits: + ```bash + gh pr view <number> --json commits --jq '.commits[].messageHeadline' + git log <base>..<head> --oneline + git diff <base>...<head> --stat + ``` + +2. Re-read the PR template. Analyze which sections are now stale based on the new changes — use the template's section names and field descriptions to identify what needs updating rather than relying on hardcoded assumptions. + +3. Present proposed updates section-by-section and confirm before applying. + +### Step 6: Apply Updates + +For title/label changes, use direct `gh pr edit` flags. + +For body edits, use a HEREDOC: +```bash +gh pr edit <number> --body "$(cat <<'PR_BODY_EOF' +<full updated body> +PR_BODY_EOF +)" +``` + +For comments: +```bash +gh pr comment <number> --body "$(cat <<'COMMENT_EOF' +<comment text> +COMMENT_EOF +)" +``` + +### Step 7: Confirm + +Fetch and display the updated state: +```bash +gh pr view <number> --json number,title,labels,url +``` + +Return the PR URL. + +--- + +## Important Rules + +- **Always read `.github/pull_request_template.md`** before filling or editing a PR body. Never assume section names, fields, or structure — derive everything from the template. It's the source of truth and may change. +- **For updates, only modify requested sections.** Preserve everything else exactly as-is. +- **Always show diffs before applying body edits.** Present current vs proposed for each changed section. +- **Never include personal/sensitive data** in PR content per ZeroClaw's privacy contract. +- **For label changes**, only use labels that exist in the repository. Check with `gh label list` if unsure. +- **Fetch the latest body before editing** to avoid clobbering concurrent changes. +- **For new PRs**, push the branch before creating (with `-u` to set upstream tracking). From 8439b40145b843f80d191259cdb08e342ea1b11d Mon Sep 17 00:00:00 2001 From: simianastronaut <simianastronaut7@gmail.com> Date: Sat, 7 Mar 2026 22:05:49 -0500 Subject: [PATCH 06/35] Returning file to prior state --- .github/CODEOWNERS | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 9925ba495..7bd42b5ac 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -1,5 +1,5 @@ # Default owner for all files -* @jordanthejet @SimianAstronaut7 +* @jordanthejet # Important functional modules /src/agent/** @theonlyhennygod From c8df83dd17d6cac0990f6468e12566fb6400a76b Mon Sep 17 00:00:00 2001 From: argenis de la rosa <theonlyhennygod@gmail.com> Date: Mon, 9 Mar 2026 18:01:00 -0400 Subject: [PATCH 07/35] docs: add localized README files for all 31 supported languages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This commit adds complete README translations for all 31 languages supported by the ZeroClaw web dashboard, enabling users to access documentation in their native language. New README files added: - README.ko.md (Korean - 한국어) - README.tl.md (Tagalog) - README.es.md (Spanish - Español) - README.pt.md (Portuguese - Português) - README.it.md (Italian - Italiano) - README.de.md (German - Deutsch) - README.ar.md (Arabic - العربية) [RTL] - README.hi.md (Hindi - हिन्दी) - README.bn.md (Bengali - বাংলা) - README.he.md (Hebrew - עברית) [RTL] - README.pl.md (Polish - Polski) - README.cs.md (Czech - Čeština) - README.nl.md (Dutch - Nederlands) - README.tr.md (Turkish - Türkçe) - README.uk.md (Ukrainian - Українська) - README.id.md (Indonesian - Bahasa Indonesia) - README.th.md (Thai - ไทย) - README.ur.md (Urdu - اردو) [RTL] - README.ro.md (Romanian - Română) - README.sv.md (Swedish - Svenska) - README.el.md (Greek - Ελληνικά) - README.hu.md (Hungarian - Magyar) - README.fi.md (Finnish - Suomi) - README.da.md (Danish - Dansk) - README.nb.md (Norwegian Bokmål - Norsk) Updated README.md with complete language selector links for all 31 languages. RTL support added for Arabic, Hebrew, and Urdu. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --- README.ar.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.bn.md | 179 ++++++++++ README.cs.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.da.md | 179 ++++++++++ README.de.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.el.md | 179 ++++++++++ README.es.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.fi.md | 179 ++++++++++ README.he.md | 197 +++++++++++ README.hi.md | 179 ++++++++++ README.hu.md | 179 ++++++++++ README.id.md | 179 ++++++++++ README.it.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.ko.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 33 +- README.nb.md | 179 ++++++++++ README.nl.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.pl.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.pt.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.ro.md | 179 ++++++++++ README.sv.md | 179 ++++++++++ README.th.md | 179 ++++++++++ README.tl.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.tr.md | 914 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.uk.md | 179 ++++++++++ README.ur.md | 197 +++++++++++ 26 files changed, 12628 insertions(+), 1 deletion(-) create mode 100644 README.ar.md create mode 100644 README.bn.md create mode 100644 README.cs.md create mode 100644 README.da.md create mode 100644 README.de.md create mode 100644 README.el.md create mode 100644 README.es.md create mode 100644 README.fi.md create mode 100644 README.he.md create mode 100644 README.hi.md create mode 100644 README.hu.md create mode 100644 README.id.md create mode 100644 README.it.md create mode 100644 README.ko.md create mode 100644 README.nb.md create mode 100644 README.nl.md create mode 100644 README.pl.md create mode 100644 README.pt.md create mode 100644 README.ro.md create mode 100644 README.sv.md create mode 100644 README.th.md create mode 100644 README.tl.md create mode 100644 README.tr.md create mode 100644 README.uk.md create mode 100644 README.ur.md diff --git a/README.ar.md b/README.ar.md new file mode 100644 index 000000000..21834e9e1 --- /dev/null +++ b/README.ar.md @@ -0,0 +1,914 @@ +<p align="center" dir="rtl"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center" dir="rtl"> + <strong>صفر عبء. صفر تنازلات. 100% Rust. 100% محايد.</strong><br> + <strong dir="ltr">⚡️ Runs on $10 hardware with <5MB RAM: That's 99% less memory than OpenClaw and 98% cheaper than a Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center" dir="rtl"> +بني من قبل طلاب وأعضاء مجتمعات هارفارد ومعهد ماساتشوستس للتكنولوجيا وSundai.Club. +</p> + +<p align="center" dir="rtl"> + 🌐 <strong>اللغات:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center" dir="rtl"> + <a href="#البدء-السريع">البدء السريع</a> | + <a href="bootstrap.sh">الإعداد بنقرة واحدة</a> | + <a href="docs/README.md">مركز التوثيق</a> | + <a href="docs/SUMMARY.md">فهرس التوثيق</a> +</p> + +<p align="center" dir="rtl"> + <strong>الوصول السريع:</strong> + <a href="docs/reference/README.md">المرجع</a> · + <a href="docs/operations/README.md">العمليات</a> · + <a href="docs/troubleshooting.md">استكشاف الأخطاء</a> · + <a href="docs/security/README.md">الأمان</a> · + <a href="docs/hardware/README.md">الأجهزة</a> · + <a href="docs/contributing/README.md">المساهمة</a> +</p> + +<p align="center" dir="rtl"> + <strong>بنية تحتية سريعة وخفيفة ومستقلة تمامًا لمساعد الذكاء الاصطناعي</strong><br /> + انشر في أي مكان. استبدل أي شيء. +</p> + +<p align="center" dir="rtl"> + ZeroClaw هو <strong>نظام تشغيل وقت التشغيل</strong> لعمليات العمل الآلية — بنية تحتية تجرد النماذج والأدوات والذاكرة والتنفيذ لبناء وكلاء مرة واحدة وتشغيلهم في أي مكان. +</p> + +<p align="center"><code>بنية قائمة على السمات · وقت تشغيل آمن افتراضيًا · موفر/قناة/أداة قابلة للتبديل · كل شيء قابل للتوصيل</code></p> + +### 📢 الإعلانات + +استخدم هذا الجدول للإشعارات المهمة (تغييرات التوافق، إشعارات الأمان، نوافذ الصيانة، وحجوز الإصدارات). + +| التاريخ (UTC) | المستوى | الإشعار | الإجراء | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _حرج_ | **نحن غير مرتبطين** بـ `openagen/zeroclaw` أو `zeroclaw.org`. نطاق `zeroclaw.org` يشير حاليًا إلى الفرع `openagen/zeroclaw`، وهذا النطاق/المستودع ينتحل شخصية موقعنا/مشروعنا الرسمي. | لا تثق بالمعلومات أو الملفات الثنائية أو جمع التبرعات أو الإعلانات من هذه المصادر. استخدم فقط [هذا المستودع](https://github.com/zeroclaw-labs/zeroclaw) وحساباتنا الموثقة على وسائل التواصل الاجتماعي. | +| 2026-02-21 | _مهم_ | موقعنا الرسمي أصبح متاحًا الآن: [zeroclawlabs.ai](https://zeroclawlabs.ai). شكرًا لصبرك أثناء الانتظار. لا نزال نكتشف محاولات الانتحال: لا تشارك في أي نشاط استثمار/تمويل باسم ZeroClaw إذا لم يتم نشره عبر قنواتنا الرسمية. | استخدم [هذا المستودع](https://github.com/zeroclaw-labs/zeroclaw) كمصدر وحيد للحقيقة. تابع [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21)، [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs)، [Facebook (مجموعة)](https://www.facebook.com/groups/zeroclaw)، [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/)، و[Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) للتحديثات الرسمية. | +| 2026-02-19 | _مهم_ | قامت Anthropic بتحديث شروط استخدام المصادقة وبيانات الاعتماد في 2026-02-19. مصادقة OAuth (Free، Pro، Max) حصريًا لـ Claude Code و Claude.ai؛ استخدام رموز Claude Free/Pro/Max OAuth في أي منتج أو أداة أو خدمة أخرى (بما في ذلك Agent SDK) غير مسموح به وقد ينتهك شروط استخدام المستهلك. | يرجى تجنب مؤقتًا تكاملات Claude Code OAuth لمنع أي خسارة محتملة. البند الأصلي: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ الميزات + +- 🏎️ **وقت تشغيل خفيف افتراضيًا:** عمليات سطر الأوامر الشائعة وأوامر الحالة تعمل ضمن مساحة ذاكرة بضع ميغابايت في إصدارات الإنتاج. +- 💰 **نشر فعال من حيث التكلفة:** مصمم للوحات منخفضة التكلفة وحالات السحابة الصغيرة بدون تبعيات وقت تشغيل ثقيلة. +- ⚡ **بدء تشغيل سريع من البارد:** وقت تشغيل Rust الثنائي الواحد يحافظ على بدء الأوامر والبرامج الخلفية شبه فوري للعمليات اليومية. +- 🌍 **بنية محمولة:** سير عمل ثنائي واحد على ARM و x86 و RISC-V مع موفر/قناة/أداة قابلة للتبديل. + +### لماذا تختار الفرق ZeroClaw + +- **خفيف افتراضيًا:** ملف Rust ثنائي صغير، بدء تشغيل سريع، بصمة ذاكرة منخفضة. +- **آمن بالتصميم:** الاقتران، الصندوق الرملي الصارم، قوائم السماح الصريحة، نطاق مساحة العمل. +- **قابل للتبديل بالكامل:** الأنظمة الأساسية هي سمات (الموفرون، القنوات، الأدوات، الذاكرة، الأنفاق). +- **لا قفل للمورد:** دعم موفر متوافق مع OpenAI + نقاط نهاية مخصصة قابلة للتوصيل. + +## لقطة قياس الأداء (ZeroClaw مقابل OpenClaw، قابلة للتكرار) + +قياس أداء سريع على جهاز محلي (macOS arm64، فبراير 2026) مُطبع لأجهزة الحافة بسرعة 0.8 GHz. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **اللغة** | TypeScript | Python | Go | **Rust** | +| **الذاكرة العشوائية** | > 1 غيغابايت | > 100 ميغابايت | < 10 ميغابايت | **< 5 ميغابايت** | +| **بدء التشغيل (نواة 0.8 GHz)** | > 500 ثانية | > 30 ثانية | < 1 ثانية | **< 10 ملي ثانية** | +| **حجم الملف الثنائي** | ~28 ميغابايت (dist) | N/A (Scripts) | ~8 ميغابايت | **3.4 ميغابايت** | +| **التكلفة** | Mac Mini $599 | Linux SBC ~$50 | لوحة Linux $10 | **أي جهاز $10** | + +> ملاحظات: تم قياس نتائج ZeroClaw في إصدارات الإنتاج باستخدام `/usr/bin/time -l`. يتطلب OpenClaw وقت تشغيل Node.js (عادةً ~390 ميغابايت من عبء الذاكرة الإضافي)، بينما يتطلب NanoBot وقت تشغيل Python. PicoClaw و ZeroClaw هما ملفات ثنائية ثابتة. أرقام الذاكرة العشوائية أعلاه هي ذاكرة وقت التشغيل؛ متطلبات التجميع في وقت البناء أعلى. + +<p align="center"> + <img src="zero-claw.jpeg" alt="مقارنة ZeroClaw مقابل OpenClaw" width="800" /> +</p> + +### قياس محلي قابل للتكرار + +قد تتغير ادعاءات قياس الأداء مع تطور الكود وسلاسل الأدوات، لذا قم دائمًا بقياس إصدارك الحالي محليًا: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +عينة مثال (macOS arm64، تم قياسها في 18 فبراير 2026): + +- حجم الملف الثنائي للإصدار: `8.8M` +- `zeroclaw --help`: وقت حقيقي حوالي `0.02s`، بصمة ذاكرة قصوى ~`3.9 ميغابايت` +- `zeroclaw status`: وقت حقيقي حوالي `0.01s`، بصمة ذاكرة قصوى ~`4.1 ميغابايت` + +## المتطلبات الأساسية + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — مطلوب + +1. **Visual Studio Build Tools** (يوفر رابط MSVC و Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + أثناء التثبيت (أو عبر Visual Studio Installer)، حدد عبء عمل **"تطوير سطح المكتب باستخدام C++"**. + +2. **سلسلة أدوات Rust:** + + ```powershell + winget install Rustlang.Rustup + ``` + + بعد التثبيت، افتح محطة طرفية جديدة وقم بتشغيل `rustup default stable` للتأكد من أن سلسلة الأدوات المستقرة نشطة. + +3. **تحقق** من أن كلاهما يعمل: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — اختياري + +- **Docker Desktop** — مطلوب فقط إذا كنت تستخدم [وقت تشغيل Docker المعزول](#دعم-وقت-التشغيل-الحالي) (`runtime.kind = "docker"`). قم بالتثبيت عبر `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — مطلوب + +1. **أدوات البناء الأساسية:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** قم بتثبيت Xcode Command Line Tools: `xcode-select --install` + +2. **سلسلة أدوات Rust:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + راجع [rustup.rs](https://rustup.rs) للتفاصيل. + +3. **تحقق:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — اختياري + +- **Docker** — مطلوب فقط إذا كنت تستخدم [وقت تشغيل Docker المعزول](#دعم-وقت-التشغيل-الحالي) (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** راجع [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** راجع [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** قم بتثبيت Docker Desktop عبر [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## البدء السريع + +### الخيار 1: الإعداد الآلي (موصى به) + +يقوم نص `bootstrap.sh` بتثبيت Rust ونسخ ZeroClaw وتجميعه وإعداد بيئة التطوير الأولية الخاصة بك: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +سيقوم هذا بـ: + +1. تثبيت Rust (إذا لم يكن موجودًا) +2. نسخ مستودع ZeroClaw +3. تجميع ZeroClaw في وضع الإصدار +4. تثبيت `zeroclaw` في `~/.cargo/bin/` +5. إنشاء هيكل مساحة العمل الافتراضية في `~/.zeroclaw/workspace/` +6. إنشاء ملف تكوين بدء التشغيل `~/.zeroclaw/workspace/config.toml` + +بعد التمهيد، أعد تحميل shell الخاص بك أو قم بتشغيل `source ~/.cargo/env` لاستخدام أمر `zeroclaw` عالميًا. + +### الخيار 2: التثبيت اليدوي + +<details> +<summary><strong>انقر لرؤية خطوات التثبيت اليدوي</strong></summary> + +```bash +# 1. نسخ المستودع +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. التجميع في وضع الإصدار +cargo build --release --locked + +# 3. تثبيت الملف الثنائي +cargo install --path . --locked + +# 4. تهيئة مساحة العمل +zeroclaw init + +# 5. التحقق من التثبيت +zeroclaw --version +zeroclaw status +``` + +</details> + +### بعد التثبيت + +بمجرد التثبيت (عبر التمهيد أو يدويًا)، يجب أن ترى: + +``` +~/.zeroclaw/workspace/ +├── config.toml # التكوين الرئيسي +├── .pairing # أسرار الاقتران (تُنشأ عند التشغيل الأول) +├── logs/ # سجلات البرنامج الخفي/الوكيل +├── skills/ # المهارات المخصصة +└── memory/ # تخزين سياق المحادثة +``` + +**الخطوات التالية:** + +1. قم بتكوين موفري الذكاء الاصطناعي الخاص بك في `~/.zeroclaw/workspace/config.toml` +2. تحقق من [مرجع التكوين](docs/config-reference.md) للخيارات المتقدمة +3. ابدأ الوكيل: `zeroclaw agent start` +4. اختبر عبر قناتك المفضلة (راجع [مرجع القنوات](docs/channels-reference.md)) + +## التكوين + +قم بتحرير `~/.zeroclaw/workspace/config.toml` لتكوين الموفرون والقنوات وسلوك النظام. + +### مرجع التكوين السريع + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # أو "sqlite" أو "none" + +[runtime] +kind = "native" # أو "docker" (يتطلب Docker) +``` + +**مستندات المرجع الكاملة:** + +- [مرجع التكوين](docs/config-reference.md) — جميع الإعدادات والتحقق والقيم الافتراضية +- [مرجع الموفرون](docs/providers-reference.md) — تكوينات محددة لموفري الذكاء الاصطناعي +- [مرجع القنوات](docs/channels-reference.md) — Telegram و Matrix و Slack و Discord والمزيد +- [العمليات](docs/operations-runbook.md) — المراقبة في الإنتاج وتدوير الأسرار والتوسع + +### دعم وقت التشغيل الحالي + +يدعم ZeroClaw واجهتين خلفيتين لتنفيذ الكود: + +- **`native`** (افتراضي) — تنفيذ العملية المباشر، المسار الأسرع، مثالي للبيئات الموثوقة +- **`docker`** — عزل الحاوية الكامل، سياسات الأمان المحصنة، يتطلب Docker + +استخدم `runtime.kind = "docker"` إذا كنت بحاجة إلى صندوق رملي صارم أو عزل الشبكة. راجع [مرجع التكوين](docs/config-reference.md#runtime) للتفاصيل الكاملة. + +## الأوامر + +```bash +# إدارة مساحة العمل +zeroclaw init # تهيئة مساحة عمل جديدة +zeroclaw status # عرض حالة البرنامج الخفي/الوكيل +zeroclaw config validate # التحقق من بنية وقيم config.toml + +# إدارة البرنامج الخفي +zeroclaw daemon start # بدء البرنامج الخفي في الخلفية +zeroclaw daemon stop # إيقاف البرنامج الخفي قيد التشغيل +zeroclaw daemon restart # إعادة تشغيل البرنامج الخفي (إعادة تحميل التكوين) +zeroclaw daemon logs # عرض سجلات البرنامج الخفي + +# إدارة الوكيل +zeroclaw agent start # بدء الوكيل (يتطلب تشغيل البرنامج الخفي) +zeroclaw agent stop # إيقاف الوكيل +zeroclaw agent restart # إعادة تشغيل الوكيل (إعادة تحميل التكوين) + +# عمليات الاقتران +zeroclaw pairing init # إنشاء سر اقتران جديد +zeroclaw pairing rotate # تدوير سر الاقتران الحالي + +# الأنفاق (للتعرض العام) +zeroclaw tunnel start # بدء نفق إلى البرنامج الخفي المحلي +zeroclaw tunnel stop # إيقاف النفق النشط + +# التشخيص +zeroclaw doctor # تشغيل فحوصات صحة النظام +zeroclaw version # عرض الإصدار ومعلومات البناء +``` + +راجع [مرجع الأوامر](docs/commands-reference.md) للخيارات والأمثلة الكاملة. + +## البنية + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ القنوات (سمة) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ منسق الوكيل │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ توجيه │ │ السياق │ │ التنفيذ │ │ +│ │ الرسائل │ │ الذاكرة │ │ الأداة │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ الموفرون │ │ الذاكرة │ │ الأدوات │ +│ (سمة) │ │ (سمة) │ │ (سمة) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ وقت التشغيل (سمة) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**المبادئ الأساسية:** + +- كل شيء هو **سمة** — الموفرون والقنوات والأدوات والذاكرة والأنفاق +- القنوات تستدعي المنسق؛ المنسق يستدعي الموفرون + الأدوات +- نظام الذاكرة يدير سياق المحادثة (markdown أو SQLite أو لا شيء) +- وقت التشغيل يجرد تنفيذ الكود (أصلي أو Docker) +- لا قفل للمورد — استبدل Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama بدون تغييرات في الكود + +راجع [توثيق البنية](docs/architecture.svg) للرسوم البيانية التفصيلية وتفاصيل التنفيذ. + +## الأمثلة + +### بوت Telegram + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # معرف مستخدم Telegram الخاص بك +``` + +ابدأ البرنامج الخفي + الوكيل، ثم أرسل رسالة إلى بوتك على Telegram: + +``` +/start +مرحباً! هل يمكنك مساعدتي في كتابة نص Python؟ +``` + +يستجيب البوت بكود مُنشأ بالذكاء الاصطناعي، وينفذ الأدوات إذا طُلب، ويحافظ على سياق المحادثة. + +### Matrix (تشفير من طرف إلى طرف) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +ادعُ `@zeroclaw:matrix.org` إلى غرفة مشفرة، وسيستجيب البوت بتشفير كامل. راجع [دليل Matrix E2EE](docs/matrix-e2ee-guide.md) لإعداد التحقق من الجهاز. + +### متعدد الموفرون + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # التبديل عند خطأ المورد +``` + +إذا فشل Anthropic أو وصل إلى حد السرعة، يتبادل المنسق تلقائيًا إلى OpenAI. + +### ذاكرة مخصصة + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # حذف تلقائي بعد 90 يومًا +``` + +أو استخدم Markdown للتخزين القابل للقراءة البشرية: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +راجع [مرجع التكوين](docs/config-reference.md#memory) لجميع خيارات الذاكرة. + +## دعم الموفرون + +| المورد | الحالة | مفتاح API | النماذج المثال | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ مستقر | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ مستقر | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ مستقر | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ مستقر | N/A (محلي) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ مستقر | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ مستقر | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 مخطط | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 مخطط | `COHERE_API_KEY` | TBD | + +### نقاط النهاية المخصصة + +يدعم ZeroClaw نقاط النهاية المتوافقة مع OpenAI: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +مثال: استخدم [LiteLLM](https://github.com/BerriAI/litellm) كوكيل للوصول إلى أي LLM عبر واجهة OpenAI. + +راجع [مرجع الموفرون](docs/providers-reference.md) لتفاصيل التكوين الكاملة. + +## دعم القنوات + +| القناة | الحالة | المصادقة | ملاحظات | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ مستقر | رمز البوت | دعم كامل بما في ذلك الملفات والصور والأزرار المضمنة | +| **Matrix** | ✅ مستقر | كلمة المرور أو الرمز | دعم E2EE مع التحقق من الجهاز | +| **Slack** | 🚧 مخطط | OAuth أو رمز البوت | يتطلب الوصول إلى مساحة العمل | +| **Discord** | 🚧 مخطط | رمز البوت | يتطلب أذونات النقابة | +| **WhatsApp** | 🚧 مخطط | Twilio أو API الرسمية | يتطلب حساب تجاري | +| **CLI** | ✅ مستقر | لا شيء | واجهة محادثة مباشرة | +| **Web** | 🚧 مخطط | مفتاح API أو OAuth | واجهة دردشة قائمة على المتصفح | + +راجع [مرجع القنوات](docs/channels-reference.md) لتعليمات التكوين الكاملة. + +## دعم الأدوات + +يوفر ZeroClaw أدوات مدمجة لتنفيذ الكود والوصول إلى نظام الملفات واسترجاع الويب: + +| الأداة | الوصف | وقت التشغيل المطلوب | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | ينفذ أوامر الصدفة | أصلي أو Docker | +| **python** | ينفذ نصوص Python | Python 3.8+ (أصلي) أو Docker | +| **javascript** | ينفذ كود Node.js | Node.js 18+ (أصلي) أو Docker | +| **filesystem_read** | يقرأ الملفات | أصلي أو Docker | +| **filesystem_write** | يكتب الملفات | أصلي أو Docker | +| **web_fetch** | يجلب محتوى الويب | أصلي أو Docker | + +### أمان التنفيذ + +- **وقت التشغيل الأصلي** — يعمل كعملية مستخدم البرنامج الخفي، وصول كامل لنظام الملفات +- **وقت تشغيل Docker** — عزل حاوية كامل، أنظمة ملفات وشبكات منفصلة + +قم بتكوين سياسة التنفيذ في `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # قائمة سماح صريحة +``` + +راجع [مرجع التكوين](docs/config-reference.md#runtime) لخيارات الأمان الكاملة. + +## النشر + +### النشر المحلي (التطوير) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### نشر الخادم (الإنتاج) + +استخدم systemd لإدارة البرنامج الخفي والوكيل كخدمات: + +```bash +# تثبيت الملف الثنائي +cargo install --path . --locked + +# تكوين مساحة العمل +zeroclaw init + +# إنشاء ملفات خدمة systemd +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# تمكين وبدء الخدمات +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# التحقق من الحالة +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +راجع [دليل نشر الشبكة](docs/network-deployment.md) لتعليمات نشر الإنتاج الكاملة. + +### Docker + +```bash +# بناء الصورة +docker build -t zeroclaw:latest . + +# تشغيل الحاوية +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +راجع [`Dockerfile`](Dockerfile) لتفاصيل البناء وخيارات التكوين. + +### أجهزة الحافة + +تم تصميم ZeroClaw للعمل على أجهزة منخفضة الطاقة: + +- **Raspberry Pi Zero 2 W** — ~512 ميغابايت ذاكرة عشوائية، نواة ARMv8 واحدة، < $5 تكلفة الأجهزة +- **Raspberry Pi 4/5** — 1 غيغابايت+ ذاكرة عشوائية، متعدد النوى، مثالي لأحمال العمل المتزامنة +- **Orange Pi Zero 2** — ~512 ميغابايت ذاكرة عشوائية، رباعي النواة ARMv8، تكلفة منخفضة جدًا +- **أجهزة SBCs x86 (Intel N100)** — 4-8 غيغابايت ذاكرة عشوائية، بناء سريع، دعم Docker أصلي + +راجع [دليل الأجهزة](docs/hardware/README.md) لتعليمات الإعداد الخاصة بالجهاز. + +## الأنفاق (التعرض العام) + +اعرض البرنامج الخفي ZeroClaw المحلي الخاص بك للشبكة العامة عبر أنفاق آمنة: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +موفرو الأنفاق المدعومون: + +- **Cloudflare Tunnel** — HTTPS مجاني، لا تعرض للمنافذ، دعم متعدد المجالات +- **Ngrok** — إعداد سريع، مجالات مخصصة (خطة مدفوعة) +- **Tailscale** — شبكة شبكية خاصة، لا منفذ عام + +راجع [مرجع التكوين](docs/config-reference.md#tunnel) لخيارات التكوين الكاملة. + +## الأمان + +ينفذ ZeroClaw طبقات متعددة من الأمان: + +### الاقتران + +يُنشئ البرنامج الخفي سر اقتران عند التشغيل الأول مخزن في `~/.zeroclaw/workspace/.pairing`. يجب على العملاء (الوكيل، CLI) تقديم هذا السر للاتصال. + +```bash +zeroclaw pairing rotate # يُنشئ سرًا جديدًا ويبطل القديم +``` + +### الصندوق الرملي + +- **وقت تشغيل Docker** — عزل حاوية كامل مع أنظمة ملفات وشبكات منفصلة +- **وقت التشغيل الأصلي** — يعمل كعملية مستخدم، محدد النطاق في مساحة العمل افتراضيًا + +### قوائم السماح + +يمكن للقنوات تقييد الوصول حسب معرف المستخدم: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # قائمة سماح صريحة +``` + +### التشفير + +- **Matrix E2EE** — تشفير من طرف إلى طرف كامل مع التحقق من الجهاز +- **نقل TLS** — جميع حركة API والنفق تستخدم HTTPS/TLS + +راجع [توثيق الأمان](docs/security/README.md) للسياسات والممارسات الكاملة. + +## إمكانية الملاحظة + +يسجل ZeroClaw في `~/.zeroclaw/workspace/logs/` افتراضيًا. يتم تخزين السجلات حسب المكون: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # سجلات البرنامج الخفي (بدء التشغيل، طلبات API، الأخطاء) +├── agent.log # سجلات الوكيل (توجيه الرسائل، تنفيذ الأدوات) +├── telegram.log # سجلات خاصة بالقناة (إذا مُكنت) +└── matrix.log # سجلات خاصة بالقناة (إذا مُكنت) +``` + +### تكوين التسجيل + +```toml +[logging] +level = "info" # debug، info، warn، error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # يومي، ساعي، حجم +max_size_mb = 100 # للتدوير القائم على الحجم +retention_days = 30 # حذف تلقائي بعد N يومًا +``` + +راجع [مرجع التكوين](docs/config-reference.md#logging) لجميع خيارات التسجيل. + +### المقاييس (مخطط) + +دعم مقاييس Prometheus لمراقبة الإنتاج قريبًا. التتبع في [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## المهارات + +يدعم ZeroClaw المهارات المخصصة — وحدات قابلة لإعادة الاستخدام توسع قدرات النظام. + +### تعريف المهارة + +يتم تخزين المهارات في `~/.zeroclaw/workspace/skills/<skill-name>/` بهذا الهيكل: + +``` +skills/ +└── my-skill/ + ├── skill.toml # بيانات المهارة (الاسم، الوصف، التبعيات) + ├── prompt.md # موجه النظام للذكاء الاصطناعي + └── tools/ # أدوات مخصصة اختيارية + └── my_tool.py +``` + +### مثال المهارة + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "يبحث في الويب ويلخص النتائج" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +أنت مساعد بحث. عند طلب البحث عن شيء ما: + +1. استخدم web_fetch لاسترجاع المحتوى +2. لخص النتائج بتنسيق سهل القراءة +3. استشهد بالمصادر مع عناوين URL +``` + +### استخدام المهارات + +يتم تحميل المهارات تلقائيًا عند بدء تشغيل الوكيل. أشر إليها بالاسم في المحادثات: + +``` +المستخدم: استخدم مهارة البحث على الويب للعثور على أخبار الذكاء الاصطناعي الأخيرة +البوت: [يحمل مهارة البحث على الويب، ينفذ web_fetch، يلخص النتائج] +``` + +راجع قسم [المهارات](#المهارات) لتعليمات إنشاء المهارات الكاملة. + +## المهارات المفتوحة + +يدعم ZeroClaw [Open Skills](https://github.com/openagents-com/open-skills) — نظام معياري ومحايد للمورد لتوسيع قدرات وكلاء الذكاء الاصطناعي. + +### تمكين المهارات المفتوحة + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # اختياري +``` + +يمكنك أيضًا التجاوز في وقت التشغيل باستخدام `ZEROCLAW_OPEN_SKILLS_ENABLED` و `ZEROCLAW_OPEN_SKILLS_DIR`. + +## التطوير + +```bash +cargo build # بناء التطوير +cargo build --release # بناء الإصدار (codegen-units=1، يعمل على جميع الأجهزة بما في ذلك Raspberry Pi) +cargo build --profile release-fast # بناء أسرع (codegen-units=8، يتطلب 16 غيغابايت+ ذاكرة عشوائية) +cargo test # تشغيل مجموعة الاختبار الكاملة +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # تنسيق + +# تشغيل معيار مقارنة SQLite مقابل Markdown +cargo test --test memory_comparison -- --nocapture +``` + +### خطاف ما قبل الدفع + +يقوم خطاف git بتشغيل `cargo fmt --check` و `cargo clippy -- -D warnings` و `cargo test` قبل كل دفع. قم بتمكينه مرة واحدة: + +```bash +git config core.hooksPath .githooks +``` + +### استكشاف أخطاء البناء وإصلاحها (أخطاء OpenSSL على Linux) + +إذا واجهت خطأ بناء `openssl-sys`، قم بمزامنة التبعيات وأعد التجميع باستخدام ملف قفل المستودع: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +تم تكوين ZeroClaw لاستخدام `rustls` لتبعيات HTTP/TLS؛ `--locked` يحافظ على الرسم البياني العابر حتمي في البيئات النظيفة. + +لتخطي الخطاف عندما تحتاج إلى دفع سريع أثناء التطوير: + +```bash +git push --no-verify +``` + +## التعاون والتوثيق + +ابدأ بمركز التوثيق لخريطة قائمة على المهام: + +- مركز التوثيق: [`docs/README.md`](docs/README.md) +- فهرس التوثيق الموحد: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- مرجع الأوامر: [`docs/commands-reference.md`](docs/commands-reference.md) +- مرجع التكوين: [`docs/config-reference.md`](docs/config-reference.md) +- مرجع الموفرون: [`docs/providers-reference.md`](docs/providers-reference.md) +- مرجع القنوات: [`docs/channels-reference.md`](docs/channels-reference.md) +- دليل العمليات: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- استكشاف الأخطاء: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- مخزون/تصنيف التوثيق: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- لقطة فرز PR/المشكلة (اعتبارًا من 18 فبراير 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +مراجع التعاون الرئيسية: + +- مركز التوثيق: [docs/README.md](docs/README.md) +- قالب التوثيق: [docs/doc-template.md](docs/doc-template.md) +- قائمة تغيير التوثيق: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- مرجع تكوين القنوات: [docs/channels-reference.md](docs/channels-reference.md) +- عمليات غرف Matrix المشفرة: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- دليل المساهمة: [CONTRIBUTING.md](CONTRIBUTING.md) +- سياسة سير عمل PR: [docs/pr-workflow.md](docs/pr-workflow.md) +- دليل المراجع (الفرز + المراجعة العميقة): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- خريطة الملكية وفرز CI: [docs/ci-map.md](docs/ci-map.md) +- سياسة الإفصاح الأمني: [SECURITY.md](SECURITY.md) + +للنشر وعمليات وقت التشغيل: + +- دليل نشر الشبكة: [docs/network-deployment.md](docs/network-deployment.md) +- دليل وكيل الوكيل: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## دعم ZeroClaw + +إذا كان ZeroClaw يساعد عملك وترغب في دعم التطوير المستمر، يمكنك التبرع هنا: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="اشترِ لي قهوة" /></a> + +### 🙏 شكر خاص + +شكر خالص للمجتمعات والمؤسسات التي تلهم وتغذي هذا العمل مفتوح المصدر: + +- **جامعة هارفارد** — لتعزيز الفضول الفكري ودفع حدود ما هو ممكن. +- **MIT** — للدفاع عن المعرفة المفتوحة والمصدر المفتوح والاعتقاد بأن التكنولوجيا يجب أن تكون متاحة للجميع. +- **Sundai Club** — للمجتمع والطاقة والإرادة الدؤوبة لبناء أشياء مهمة. +- **العالم وما بعده** 🌍✨ — لكل مساهم وحالم وباني هناك يجعل المصدر المفتوح قوة للخير. هذا من أجلك. + +نحن نبني في المصدر المفتوح لأن أفضل الأفكار تأتي من كل مكان. إذا كنت تقرأ هذا، فأنت جزء منه. مرحبًا. 🦀❤️ + +## ⚠️ المستودع الرسمي وتحذير الانتحال + +**هذا هو مستودع ZeroClaw الرسمي الوحيد:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +أي مستودع أو منظمة أو نطاق أو حزمة آخر يدعي أنه "ZeroClaw" أو يلمح إلى الارتباط بـ ZeroClaw Labs هو **غير مصرح به وغير مرتبط بهذا المشروع**. سيتم إدراج الفروع غير المصرح بها المعروفة في [TRADEMARK.md](TRADEMARK.md). + +إذا واجهت انتحالًا أو سوء استخدام للعلامة التجارية، يرجى [فتح مشكلة](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## الترخيص + +ZeroClaw مرخص بشكل مزدوج لأقصى قدر من الانفتاح وحماية المساهمين: + +| الترخيص | حالات الاستخدام | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | مفتوح المصدر، البحث، الأكاديمي، الاستخدام الشخصي | +| [Apache 2.0](LICENSE-APACHE) | حماية براءات الاختراع، المؤسسي، النشر التجاري | + +يمكنك اختيار أي من الترخيصين. **يمنح المساهمون تلقائيًا حقوقًا بموجب كليهما** — راجع [CLA.md](CLA.md) لاتفاقية المساهم الكاملة. + +### العلامة التجارية + +اسم **ZeroClaw** والشعار علامتان تجاريتان مسجلتان لـ ZeroClaw Labs. لا يمنح هذا الترخيص الإذن باستخدامهما للإيحاء بالموافقة أو الارتباط. راجع [TRADEMARK.md](TRADEMARK.md) للاستخدامات المسموح بها والمحظورة. + +### حماية المساهمين + +- **تحتفظ بحقوق النشر** لمساهماتك +- **منح براءة الاختراع** (Apache 2.0) يحميك من مطالبات براءات الاختراع من مساهمين آخرين +- يتم **نسب مساهماتك بشكل دائم** في تاريخ الالتزامات و [NOTICE](NOTICE) +- لا يتم نقل حقوق العلامة التجارية من خلال المساهمة + +## المساهمة + +راجع [CONTRIBUTING.md](CONTRIBUTING.md) و [CLA.md](CLA.md). قم بتنفيذ سمة، أرسل PR: + +- دليل سير عمل CI: [docs/ci-map.md](docs/ci-map.md) +- `Provider` جديد ← `src/providers/` +- `Channel` جديد ← `src/channels/` +- `Observer` جديد ← `src/observability/` +- `Tool` جديد ← `src/tools/` +- `Memory` جديدة ← `src/memory/` +- `Tunnel` جديد ← `src/tunnel/` +- `Skill` جديدة ← `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — صفر عبء. صفر تنازلات. انشر في أي مكان. استبدل أي شيء. 🦀 + +## تاريخ النجوم + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="رسم بياني لتاريخ النجوم" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.bn.md b/README.bn.md new file mode 100644 index 000000000..09800e1f0 --- /dev/null +++ b/README.bn.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>শূন্য ওভারহেড। শূন্য আপস। 100% রাস্ট। 100% অজ্ঞেয়বাদী।</strong><br> + ⚡️ <strong>$10 হার্ডওয়্যারে <5MB RAM নিয়ে চলে: এটি OpenClaw থেকে 99% কম মেমোরি এবং Mac mini থেকে 98% সস্তা!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>ভাষা:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## ZeroClaw কী? + +ZeroClaw হল একটি হালকা, মিউটেবল এবং এক্সটেনসিবল AI অ্যাসিস্ট্যান্ট ইনফ্রাস্ট্রাকচার যা রাস্টে তৈরি। এটি বিভিন্ন LLM প্রদানকারীদের (Anthropic, OpenAI, Google, Ollama, ইত্যাদি) একটি ইউনিফাইড ইন্টারফেসের মাধ্যমে সংযুক্ত করে এবং একাধিক চ্যানেল (Telegram, Matrix, CLI, ইত্যাদি) সমর্থন করে। + +### মূল বৈশিষ্ট্যসমূহ + +- **🦀 রাস্টে লেখা**: উচ্চ পারফরম্যান্স, মেমোরি নিরাপত্তা, এবং জিরো-কস্ট অ্যাবস্ট্রাকশন +- **🔌 প্রদানকারী-অজ্ঞেয়বাদী**: OpenAI, Anthropic, Google Gemini, Ollama, এবং অন্যান্য সমর্থন +- **📱 মাল্টি-চ্যানেল**: Telegram, Matrix (E2EE সহ), CLI, এবং অন্যান্য +- **🧠 প্লাগেবল মেমোরি**: SQLite এবং Markdown ব্যাকএন্ড +- **🛠️ এক্সটেন্সিবল টুলস**: সহজেই কাস্টম টুল যোগ করুন +- **🔒 নিরাপত্তা-প্রথম**: রিভার্স-প্রক্সি, গোপনীয়তা-প্রথম ডিজাইন + +--- + +## দ্রুত শুরু + +### প্রয়োজনীয়তা + +- রাস্ট 1.70+ +- একটি LLM প্রদানকারী API কী (Anthropic, OpenAI, ইত্যাদি) + +### ইনস্টলেশন + +```bash +# রিপোজিটরি ক্লোন করুন +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# বিল্ড করুন +cargo build --release + +# চালান +cargo run --release +``` + +### Docker দিয়ে + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## কনফিগারেশন + +ZeroClaw একটি YAML কনফিগারেশন ফাইল ব্যবহার করে। ডিফল্টরূপে, এটি `config.yaml` দেখে। + +```yaml +# ডিফল্ট প্রদানকারী +provider: anthropic + +# প্রদানকারী কনফিগারেশন +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# মেমোরি কনফিগারেশন +memory: + backend: sqlite + path: data/memory.db + +# চ্যানেল কনফিগারেশন +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## ডকুমেন্টেশন + +বিস্তারিত ডকুমেন্টেশনের জন্য, দেখুন: + +- [ডকুমেন্টেশন হাব](docs/README.md) +- [কমান্ড রেফারেন্স](docs/commands-reference.md) +- [প্রদানকারী রেফারেন্স](docs/providers-reference.md) +- [চ্যানেল রেফারেন্স](docs/channels-reference.md) +- [কনফিগারেশন রেফারেন্স](docs/config-reference.md) + +--- + +## অবদান + +অবদান স্বাগত! অনুগ্রহ করে [অবদান গাইড](CONTRIBUTING.md) পড়ুন। + +--- + +## লাইসেন্স + +এই প্রজেক্টটি ডুয়াল লাইসেন্সপ্রাপ্ত: + +- MIT লাইসেন্স +- Apache লাইসেন্স, সংস্করণ 2.0 + +বিস্তারিতের জন্য [LICENSE-APACHE](LICENSE-APACHE) এবং [LICENSE-MIT](LICENSE-MIT) দেখুন। + +--- + +## কমিউনিটি + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## স্পনসর + +যদি ZeroClaw আপনার জন্য উপযোগী হয়, তবে অনুগ্রহ করে আমাদের একটি কফি কিনতে বিবেচনা করুন: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.cs.md b/README.cs.md new file mode 100644 index 000000000..e38bb78b8 --- /dev/null +++ b/README.cs.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Nulová režie. Nulové kompromisy. 100% Rust. 100% Agnostický.</strong><br> + ⚡️ <strong>Beží na hardwaru za $10 s <5MB RAM: To je o 99% méně paměti než OpenClaw a o 98% levnější než Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Postaveno studenty a členy komunit Harvard, MIT a Sundai.Club. +</p> + +<p align="center"> + 🌐 <strong>Jazyky:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#rychlý-start">Rychlý Start</a> | + <a href="bootstrap.sh">Jedno-klikové nastavení</a> | + <a href="docs/README.md">Dokumentační Centrum</a> | + <a href="docs/SUMMARY.md">Obsah Dokumentace</a> +</p> + +<p align="center"> + <strong>Rychlý přístup:</strong> + <a href="docs/reference/README.md">Reference</a> · + <a href="docs/operations/README.md">Operace</a> · + <a href="docs/troubleshooting.md">Řešení problémů</a> · + <a href="docs/security/README.md">Bezpečnost</a> · + <a href="docs/hardware/README.md">Hardware</a> · + <a href="docs/contributing/README.md">Příspívání</a> +</p> + +<p align="center"> + <strong>Rychlá, lehká a plně autonomní AI asistent infrastruktura</strong><br /> + Nasazujte kdekoliv. Měňte cokoliv. +</p> + +<p align="center"> + ZeroClaw je <strong>operační systém runtime</strong> pro workflow agentů — infrastruktura která abstrahuje modely, nástroje, paměť a provádění pro stavbu agentů jednou a spouštění kdekoliv. +</p> + +<p align="center"><code>Architektura založená na traitech · bezpečný runtime defaultně · vyměnitelný poskytovatel/kanál/nástroj · vše je připojitelné</code></p> + +### 📢 Oznámení + +Použijte tuto tabulku pro důležitá oznámení (změny kompatibility, bezpečnostní upozornění, servisní okna a blokování verzí). + +| Datum (UTC) | Úroveň | Oznámení | Akce | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Kritické_ | **Nejsme propojeni** s `openagen/zeroclaw` nebo `zeroclaw.org`. Doména `zeroclaw.org` aktuálně směřuje na fork `openagen/zeroclaw`, a tato doména/repoziťář se vydává za náš oficiální web/projekt. | Nevěřte informacím, binárním souborům, fundraisingu nebo oznámením z těchto zdrojů. Používejte pouze [tento repoziťář](https://github.com/zeroclaw-labs/zeroclaw) a naše ověřené sociální účty. | +| 2026-02-21 | _Důležité_ | Náš oficiální web je nyní online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Děkujeme za trpělivost během čekání. Stále detekujeme pokusy o vydávání se: neúčastněte žádné investiční/fundraisingové aktivity ve jménu ZeroClaw pokud není publikována přes naše oficiální kanály. | Používejte [tento repoziťář](https://github.com/zeroclaw-labs/zeroclaw) jako jediný zdroj pravdy. Sledujte [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (skupina)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), a [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) pro oficiální aktualizace. | +| 2026-02-19 | _Důležité_ | Anthropic aktualizoval podmínky použití autentizace a přihlašovacích údajů dne 2026-02-19. OAuth autentizace (Free, Pro, Max) je výhradně pro Claude Code a Claude.ai; použití Claude Free/Pro/Max OAuth tokenů v jakémkoliv jiném produktu, nástroji nebo službě (včetně Agent SDK) není povoleno a může porušit Podmínky použití spotřebitele. | Prosím dočasně se vyhněte Claude Code OAuth integracím pro předcházení potenciálním ztrátám. Původní klauzule: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Funkce + +- 🏎️ **Lehký Runtime Defaultně:** Běžné CLI workflowy a stavové příkazy běží v paměťovém prostoru několika megabytů v produkčních buildech. +- 💰 **Cenově efektivní nasazení:** Navrženo pro nízkonákladové desky a malé cloud instance bez těžkých runtime závislostí. +- ⚡ **Rychlé studené starty:** Single-binary Rust runtime udržuje start příkazů a daemonů téměř okamžitý pro denní operace. +- 🌍 **Přenosná architektura:** Single-binary workflow na ARM, x86 a RISC-V s vyměnitelným poskytovatelem/kanálem/nástrojem. + +### Proč týmy volí ZeroClaw + +- **Lehký defaultně:** malý Rust binary, rychlý start, nízká paměťová stopa. +- **Bezpečný designem:** párování, striktní sandboxing, explicitní allowlisty, workspace scope. +- **Plně vyměnitelné:** jádrové systémy jsou traity (poskytovatelé, kanály, nástroje, paměť, tunely). +- **Žádné vendor lock-in:** OpenAI-kompatibilní podpora poskytovatele + připojitelné vlastní endpointy. + +## Benchmark Snapshot (ZeroClaw vs OpenClaw, Reprodukovatelné) + +Rychlý benchmark na lokálním stroji (macOS arm64, únor 2026) normalizovaný pro 0.8 GHz edge hardware. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Jazyk** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Start (0.8 GHz jádro)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Velikost Binary** | ~28 MB (dist) | N/A (Skripty) | ~8 MB | **3.4 MB** | +| **Náklady** | Mac Mini $599 | Linux SBC ~$50 | Linux deska $10 | **Jakýkoliv hardware $10** | + +> Poznámky: Výsledky ZeroClaw jsou měřeny na produkčních buildech pomocí `/usr/bin/time -l`. OpenClaw vyžaduje Node.js runtime (typicky ~390 MB dodatečného paměťového režijního nákladu), zatímco NanoBot vyžaduje Python runtime. PicoClaw a ZeroClaw jsou statická binaria. Výše uvedené RAM čísla jsou runtime paměť; build-time kompilační požadavky jsou vyšší. + +<p align="center"> + <img src="zero-claw.jpeg" alt="Porovnání ZeroClaw vs OpenClaw" width="800" /> +</p> + +### Reprodukovatelné lokální měření + +Benchmark tvrzení se mohou měnit jak se kód a toolchainy vyvíjejí, takže vždy měřte svůj aktuální build lokálně: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Ukázková vzorka (macOS arm64, měřeno 18. února 2026): + +- Velikost release binary: `8.8M` +- `zeroclaw --help`: reálný čas přibližně `0.02s`, špičková paměťová stopa ~`3.9 MB` +- `zeroclaw status`: reálný čas přibližně `0.01s`, špičková paměťová stopa ~`4.1 MB` + +## Předpoklady + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Vyžadováno + +1. **Visual Studio Build Tools** (poskytuje MSVC linker a Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Během instalace (nebo přes Visual Studio Installer), vyberte workload **"Desktop development with C++"**. + +2. **Rust Toolchain:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Po instalaci otevřete nový terminál a spusťte `rustup default stable` pro zajištění, že stabilní toolchain je aktivní. + +3. **Ověřte** že oba fungují: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Volitelné + +- **Docker Desktop** — vyžadováno pouze pokud používáte [Docker sandboxed runtime](#aktuální-runtime-podpora) (`runtime.kind = "docker"`). Nainstalujte přes `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Vyžadováno + +1. **Essenciální build nástroje:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Nainstalujte Xcode Command Line Tools: `xcode-select --install` + +2. **Rust Toolchain:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Viz [rustup.rs](https://rustup.rs) pro detaily. + +3. **Ověřte:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Volitelné + +- **Docker** — vyžadováno pouze pokud používáte [Docker sandboxed runtime](#aktuální-runtime-podpora) (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** viz [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** viz [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** nainstalujte Docker Desktop přes [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Rychlý Start + +### Možnost 1: Automatické nastavení (doporučeno) + +Skript `bootstrap.sh` nainstaluje Rust, naklonuje ZeroClaw, zkompiluje ho a nastaví vaše počáteční vývojové prostředí: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Toto: + +1. Nainstaluje Rust (pokud chybí) +2. Naklonuje ZeroClaw repoziťář +3. Zkompiluje ZeroClaw v release módu +4. Nainstaluje `zeroclaw` do `~/.cargo/bin/` +5. Vytvoří výchozí workspace strukturu v `~/.zeroclaw/workspace/` +6. Vygeneruje počáteční konfigurační soubor `~/.zeroclaw/workspace/config.toml` + +Po bootstrapu znovu načtěte váš shell nebo spusťte `source ~/.cargo/env` pro použití příkazu `zeroclaw` globálně. + +### Možnost 2: Manuální instalace + +<details> +<summary><strong>Klikněte pro zobrazení kroků manuální instalace</strong></summary> + +```bash +# 1. Naklonujte repoziťář +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Zkompilujte v release +cargo build --release --locked + +# 3. Nainstalujte binary +cargo install --path . --locked + +# 4. Inicializujte workspace +zeroclaw init + +# 5. Ověřte instalaci +zeroclaw --version +zeroclaw status +``` + +</details> + +### Po instalaci + +Jakmile nainstalováno (přes bootstrap nebo manuálně), měli byste vidět: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Hlavní konfigurace +├── .pairing # Párovací tajemství (generováno při prvním spuštění) +├── logs/ # Daemon/agent logy +├── skills/ # Vlastní dovednosti +└── memory/ # Uložení konverzačního kontextu +``` + +**Další kroky:** + +1. Nakonfigurujte své AI poskytovatele v `~/.zeroclaw/workspace/config.toml` +2. Podívejte se na [konfigurační referenci](docs/config-reference.md) pro pokročilé možnosti +3. Spusťte agenta: `zeroclaw agent start` +4. Otestujte přes váš preferovaný kanál (viz [kanálová reference](docs/channels-reference.md)) + +## Konfigurace + +Upravte `~/.zeroclaw/workspace/config.toml` pro konfiguraci poskytovatelů, kanálů a chování systému. + +### Rychlá konfigurační reference + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # nebo "sqlite" nebo "none" + +[runtime] +kind = "native" # nebo "docker" (vyžaduje Docker) +``` + +**Kompletní referenční dokumenty:** + +- [Konfigurační reference](docs/config-reference.md) — všechna nastavení, validace, výchozí hodnoty +- [Poskytovatel reference](docs/providers-reference.md) — AI poskytovatel-specifické konfigurace +- [Kanálová reference](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord a další +- [Operace](docs/operations-runbook.md) — produkční monitoring, rotace tajemství, škálování + +### Aktuální Runtime Podpora + +ZeroClaw podporuje dva backendy provádění kódu: + +- **`native`** (výchozí) — přímé provedení procesu, nejrychlejší cesta, ideální pro důvěryhodná prostředí +- **`docker`** — plná kontejnerová izolace, zpřísněné bezpečnostní politiky, vyžaduje Docker + +Použijte `runtime.kind = "docker"` pokud potřebujete striktní sandboxing nebo síťovou izolaci. Viz [konfigurační reference](docs/config-reference.md#runtime) pro úplné detaily. + +## Příkazy + +```bash +# Správa workspace +zeroclaw init # Inicializuje nový workspace +zeroclaw status # Zobrazuje stav daemon/agent +zeroclaw config validate # Ověřuje syntaxi a hodnoty config.toml + +# Správa daemon +zeroclaw daemon start # Spouští daemon na pozadí +zeroclaw daemon stop # Zastavuje běžící daemon +zeroclaw daemon restart # Restartuje daemon (znovunačtení config) +zeroclaw daemon logs # Zobrazuje daemon logy + +# Správa agent +zeroclaw agent start # Spouští agenta (vyžaduje běžící daemon) +zeroclaw agent stop # Zastavuje agenta +zeroclaw agent restart # Restartuje agenta (znovunačtení config) + +# Párovací operace +zeroclaw pairing init # Generuje nové párovací tajemství +zeroclaw pairing rotate # Rotuje existující párovací tajemství + +# Tunneling (pro veřejnou expozici) +zeroclaw tunnel start # Spouští tunnel k lokálnímu daemon +zeroclaw tunnel stop # Zastavuje aktivní tunnel + +# Diagnostika +zeroclaw doctor # Spouští kontroly zdraví systému +zeroclaw version # Zobrazuje verzi a build informace +``` + +Viz [Příkazová reference](docs/commands-reference.md) pro kompletní možnosti a příklady. + +## Architektura + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Kanály (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Agent Orchestrátor │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Směrování │ │ Kontext │ │ Provedení │ │ +│ │ Zpráva │ │ Paměť │ │ Nástroj │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Poskytovatel│ │ Paměť │ │ Nástroje │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Klíčové principy:** + +- Vše je **trait** — poskytovatelé, kanály, nástroje, paměť, tunely +- Kanály volají orchestrátor; orchestrátor volá poskytovatele + nástroje +- Paměťový systém spravuje konverzační kontext (markdown, SQLite, nebo žádný) +- Runtime abstrahuje provádění kódu (nativní nebo Docker) +- Žádné vendor lock-in — vyměňujte Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama beze změn kódu + +Viz [dokumentace architektury](docs/architecture.svg) pro detailní diagramy a detaily implementace. + +## Příklady + +### Telegram Bot + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Vaše Telegram user ID +``` + +Spusťte daemon + agent, pak pošlete zprávu vašemu botovi na Telegram: + +``` +/start +Ahoj! Mohl bys mi pomoci napsat Python skript? +``` + +Bot odpoví AI-generovaným kódem, provede nástroje pokud požadováno a udržuje konverzační kontext. + +### Matrix (end-to-end šifrování) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Pozvěte `@zeroclaw:matrix.org` do šifrované místnosti a bot odpoví s plným šifrováním. Viz [Matrix E2EE Guide](docs/matrix-e2ee-guide.md) pro nastavení ověření zařízení. + +### Multi-Poskytovatel + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover při chybě poskytovatele +``` + +Pokud Anthropic selže nebo má rate-limit, orchestrátor automaticky přepne na OpenAI. + +### Vlastní Paměť + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Automatické čištění po 90 dnech +``` + +Nebo použijte Markdown pro lidsky čitelné ukládání: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Viz [Konfigurační reference](docs/config-reference.md#memory) pro všechny možnosti paměti. + +## Podpora Poskytovatelů + +| Poskytovatel | Stav | API Klíč | Příklad Modelů | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Stabilní | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Stabilní | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Stabilní | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Stabilní | N/A (lokální) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Stabilní | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Stabilní | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Plánováno | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Plánováno | `COHERE_API_KEY` | TBD | + +### Vlastní Endpointy + +ZeroClaw podporuje OpenAI-kompatibilní endpointy: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Příklad: použijte [LiteLLM](https://github.com/BerriAI/litellm) jako proxy pro přístup k jakémukoli LLM přes OpenAI rozhraní. + +Viz [Poskytovatel reference](docs/providers-reference.md) pro kompletní detaily konfigurace. + +## Podpora Kanálů + +| Kanál | Stav | Autentizace | Poznámky | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Stabilní | Bot Token | Plná podpora včetně souborů, obrázků, inline tlačítek | +| **Matrix** | ✅ Stabilní | Heslo nebo Token | E2EE podpora s ověřením zařízení | +| **Slack** | 🚧 Plánováno | OAuth nebo Bot Token | Vyžaduje workspace přístup | +| **Discord** | 🚧 Plánováno | Bot Token | Vyžaduje guild oprávnění | +| **WhatsApp** | 🚧 Plánováno | Twilio nebo oficiální API | Vyžaduje business účet | +| **CLI** | ✅ Stabilní | Žádné | Přímé konverzační rozhraní | +| **Web** | 🚧 Plánováno | API Klíč nebo OAuth | Prohlížečové chat rozhraní | + +Viz [Kanálová reference](docs/channels-reference.md) pro kompletní instrukce konfigurace. + +## Podpora Nástrojů + +ZeroClaw poskytuje vestavěné nástroje pro provádění kódu, přístup k souborovému systému a web retrieval: + +| Nástroj | Popis | Vyžadovaný Runtime | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Provádí shell příkazy | Nativní nebo Docker | +| **python** | Provádí Python skripty | Python 3.8+ (nativní) nebo Docker | +| **javascript** | Provádí Node.js kód | Node.js 18+ (nativní) nebo Docker | +| **filesystem_read** | Čte soubory | Nativní nebo Docker | +| **filesystem_write** | Zapisuje soubory | Nativní nebo Docker | +| **web_fetch** | Získává web obsah | Nativní nebo Docker | + +### Bezpečnost Provedení + +- **Nativní Runtime** — běží jako uživatelský proces daemon, plný přístup k souborovému systému +- **Docker Runtime** — plná kontejnerová izolace, oddělené souborové systémy a sítě + +Nakonfigurujte politiku provedení v `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Explicitní allowlist +``` + +Viz [Konfigurační reference](docs/config-reference.md#runtime) pro kompletní možnosti bezpečnosti. + +## Nasazení + +### Lokální Nasazení (Vývoj) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Serverové Nasazení (Produkce) + +Použijte systemd pro správu daemon a agent jako služby: + +```bash +# Nainstalujte binary +cargo install --path . --locked + +# Nakonfigurujte workspace +zeroclaw init + +# Vytvořte systemd servisní soubory +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Povolte a spusťte služby +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Ověřte stav +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Viz [Průvodce síťovým nasazením](docs/network-deployment.md) pro kompletní instrukce produkčního nasazení. + +### Docker + +```bash +# Sestavte image +docker build -t zeroclaw:latest . + +# Spusťte kontejner +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Viz [`Dockerfile`](Dockerfile) pro detaily sestavení a konfigurační možnosti. + +### Edge Hardware + +ZeroClaw je navržen pro běh na nízko-příkonovém hardwaru: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, jedno ARMv8 jádro, < $5 hardwarové náklady +- **Raspberry Pi 4/5** — 1 GB+ RAM, vícejádrový, ideální pro souběžné úlohy +- **Orange Pi Zero 2** — ~512 MB RAM, čtyřjádrový ARMv8, ultra-nízké náklady +- **x86 SBCs (Intel N100)** — 4-8 GB RAM, rychlé buildy, nativní Docker podpora + +Viz [Hardware Guide](docs/hardware/README.md) pro instrukce nastavení specifické pro zařízení. + +## Tunneling (Veřejná Expozice) + +Exponujte svůj lokální ZeroClaw daemon do veřejné sítě přes bezpečné tunely: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Podporovaní tunnel poskytovatelé: + +- **Cloudflare Tunnel** — bezplatný HTTPS, bez expozice portů, multi-doména podpora +- **Ngrok** — rychlé nastavení, vlastní domény (placený plán) +- **Tailscale** — soukromá mesh síť, bez veřejného portu + +Viz [Konfigurační reference](docs/config-reference.md#tunnel) pro kompletní konfigurační možnosti. + +## Bezpečnost + +ZeroClaw implementuje více vrstev bezpečnosti: + +### Párování + +Daemon generuje párovací tajemství při prvním spuštění uložené v `~/.zeroclaw/workspace/.pairing`. Klienti (agent, CLI) musí předložit toto tajemství pro připojení. + +```bash +zeroclaw pairing rotate # Generuje nové tajemství a zneplatňuje staré +``` + +### Sandboxing + +- **Docker Runtime** — plná kontejnerová izolace s oddělenými souborovými systémy a sítěmi +- **Nativní Runtime** — běží jako uživatelský proces, scoped na workspace defaultně + +### Allowlisty + +Kanály mohou omezit přístup podle user ID: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Explicitní allowlist +``` + +### Šifrování + +- **Matrix E2EE** — plné end-to-end šifrování s ověřením zařízení +- **TLS Transport** — veškerý API a tunnel provoz používá HTTPS/TLS + +Viz [Bezpečnostní dokumentace](docs/security/README.md) pro kompletní politiky a praktiky. + +## Pozorovatelnost + +ZeroClaw loguje do `~/.zeroclaw/workspace/logs/` defaultně. Logy jsou ukládány podle komponenty: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Daemon logy (startup, API požadavky, chyby) +├── agent.log # Agent logy (směrování zpráv, provedení nástrojů) +├── telegram.log # Kanál-specifické logy (pokud povoleno) +└── matrix.log # Kanál-specifické logy (pokud povoleno) +``` + +### Konfigurace Logování + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # Pro rotaci založenou na velikosti +retention_days = 30 # Automatické čištění po N dnech +``` + +Viz [Konfigurační reference](docs/config-reference.md#logging) pro všechny možnosti logování. + +### Metriky (Plánováno) + +Podpora Prometheus metrik pro produkční monitoring již brzy. Sledování v [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Dovednosti + +ZeroClaw podporuje vlastní dovednosti — opakovaně použitelné moduly rozšiřující schopnosti systému. + +### Definice Dovednosti + +Dovednosti jsou uloženy v `~/.zeroclaw/workspace/skills/<skill-name>/` s touto strukturou: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Metadata dovednosti (název, popis, závislosti) + ├── prompt.md # Systémový prompt pro AI + └── tools/ # Volitelné vlastní nástroje + └── my_tool.py +``` + +### Příklad Dovednosti + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Hledá na webu a shrnuje výsledky" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Jste výzkumný asistent. Když požádáte o výzkum něčeho: + +1. Použijte web_fetch pro získání obsahu +2. Shrňte výsledky v snadno čitelném formátu +3. Citujte zdroje s URL +``` + +### Použití Dovedností + +Dovednosti jsou automaticky načítány při startu agenta. Odkazujte na ně jménem v konverzacích: + +``` +Uživatel: Použij dovednost web-research k nalezení nejnovějších AI zpráv +Bot: [načte dovednost web-research, provede web_fetch, shrne výsledky] +``` + +Viz sekce [Dovednosti](#dovednosti) pro kompletní instrukce tvorby dovedností. + +## Open Skills + +ZeroClaw podporuje [Open Skills](https://github.com/openagents-com/open-skills) — modulární a poskytovatel-agnostický systém pro rozšíření schopností AI agentů. + +### Povolit Open Skills + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # volitelné +``` + +Můžete také přepsat za běhu pomocí `ZEROCLAW_OPEN_SKILLS_ENABLED` a `ZEROCLAW_OPEN_SKILLS_DIR`. + +## Vývoj + +```bash +cargo build # Dev build +cargo build --release # Release build (codegen-units=1, funguje na všech zařízeních včetně Raspberry Pi) +cargo build --profile release-fast # Rychlejší build (codegen-units=8, vyžaduje 16 GB+ RAM) +cargo test # Spustí plnou testovací sadu +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Formátování + +# Spusťte SQLite vs Markdown srovnávací benchmark +cargo test --test memory_comparison -- --nocapture +``` + +### Pre-push hook + +Git hook spouští `cargo fmt --check`, `cargo clippy -- -D warnings`, a `cargo test` před každým push. Povolte jej jednou: + +```bash +git config core.hooksPath .githooks +``` + +### Řešení problémů s Buildem (OpenSSL chyby na Linuxu) + +Pokud narazíte na `openssl-sys` build chybu, synchronizujte závislosti a znovu zkompilujte s lockfile repoziťáře: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw je nakonfigurován pro použití `rustls` pro HTTP/TLS závislosti; `--locked` udržuje transitivní graf deterministický v čistých prostředích. + +Pro přeskočení hooku když potřebujete rychlý push během vývoje: + +```bash +git push --no-verify +``` + +## Spolupráce & Docs + +Začněte s dokumentačním centrem pro task-based mapu: + +- Dokumentační Centrum: [`docs/README.md`](docs/README.md) +- Sjednocený Docs TOC: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Příkazová reference: [`docs/commands-reference.md`](docs/commands-reference.md) +- Konfigurační reference: [`docs/config-reference.md`](docs/config-reference.md) +- Poskytovatel reference: [`docs/providers-reference.md`](docs/providers-reference.md) +- Kanálová reference: [`docs/channels-reference.md`](docs/channels-reference.md) +- Operations Runbook: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Řešení problémů: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Docs Inventář/Klasifikace: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- PR/Issue Triage Snapshot (k 18. únoru 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Hlavní spolupráční reference: + +- Dokumentační Centrum: [docs/README.md](docs/README.md) +- Šablona dokumentace: [docs/doc-template.md](docs/doc-template.md) +- Checklist změn dokumentace: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Reference konfigurace kanálů: [docs/channels-reference.md](docs/channels-reference.md) +- Operace šifrovaných místností Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Průvodce příspíváním: [CONTRIBUTING.md](CONTRIBUTING.md) +- PR Workflow politika: [docs/pr-workflow.md](docs/pr-workflow.md) +- Reviewer Playbook (triage + hluboká recenze): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Mapa vlastnictví a CI triage: [docs/ci-map.md](docs/ci-map.md) +- Bezpečnostní disclosure politika: [SECURITY.md](SECURITY.md) + +Pro nasazení a runtime operace: + +- Průvodce síťovým nasazením: [docs/network-deployment.md](docs/network-deployment.md) +- Proxy Agent Playbook: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## Podpořte ZeroClaw + +Pokud ZeroClaw pomáhá vaší práci a chcete podpořit pokračující vývoj, můžete darovat zde: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Kup Mi Kávu" /></a> + +### 🙏 Speciální Poděkování + +Upřímné poděkování komunitám a institucím které inspirují a živí tuto open-source práci: + +- **Harvard University** — za podporu intelektuální zvídavosti a posouvání hranic toho co je možné. +- **MIT** — za obhajobu otevřeného vědění, open source, a přesvědčení že technologie by měla být přístupná všem. +- **Sundai Club** — za komunitu, energii, a neustálou vůli stavět věci které na něčem záleží. +- **Svět a Dál** 🌍✨ — každému přispěvateli, snílkovi, a staviteli tam venku který dělá z open source sílu pro dobro. To je pro tebe. + +Stavíme v open source protože nejlepší nápady přicházejí odkudkoliv. Pokud toto čtete, jste součástí toho. Vítejte. 🦀❤️ + +## ⚠️ Oficiální Repoziťář a Varování před Vydáváním se + +**Toto je jediný oficiální ZeroClaw repoziťář:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Jakýkoliv jiný repoziťář, organizace, doména nebo balík tvrdící že je "ZeroClaw" nebo naznačující afiliaci s ZeroClaw Labs je **neautorizovaný a není spojen s tímto projektem**. Známé neautorizované forky budou uvedeny v [TRADEMARK.md](TRADEMARK.md). + +Pokud narazíte na vydávání se nebo zneužití ochranné známky, prosím [otevřete issue](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Licence + +ZeroClaw je duálně licencován pro maximální otevřenost a ochranu přispěvatelů: + +| Licence | Případy použití | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Open-source, výzkum, akademické, osobní použití | +| [Apache 2.0](LICENSE-APACHE) | Ochrana patentů, institucionální, komerční nasazení | + +Můžete si vybrat jednu z licencí. **Přispěvatelé automaticky udělují práva pod oběma** — viz [CLA.md](CLA.md) pro plnou dohodu přispěvatele. + +### Ochranná známka + +Název **ZeroClaw** a logo jsou registrované ochranné známky ZeroClaw Labs. Tato licence neuděluje povolení je používat k naznačení schválení nebo afiliace. Viz [TRADEMARK.md](TRADEMARK.md) pro povolená a zakázaná použití. + +### Ochrany přispěvatelů + +- **Si zachováváte autorská práva** k vašim příspěvkům +- **Patentový grant** (Apache 2.0) vás chrání před patentovými nároky ostatních přispěvatelů +- Vaše příspěvky jsou **trvale připsány** v historii commitů a [NOTICE](NOTICE) +- Žádná práva ochranné známky nejsou přenesena příspěvkem + +## Příspívání + +Viz [CONTRIBUTING.md](CONTRIBUTING.md) a [CLA.md](CLA.md). Implementujte trait, odešlete PR: + +- Průvodce CI workflow: [docs/ci-map.md](docs/ci-map.md) +- Nový `Provider` → `src/providers/` +- Nový `Channel` → `src/channels/` +- Nový `Observer` → `src/observability/` +- Nový `Tool` → `src/tools/` +- Nová `Memory` → `src/memory/` +- Nový `Tunnel` → `src/tunnel/` +- Nová `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Nulová režie. Nulové kompromisy. Nasazujte kdekoliv. Měňte cokoliv. 🦀 + +## Historie Hvězd + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Graf Historie Hvězd" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.da.md b/README.da.md new file mode 100644 index 000000000..31275cb93 --- /dev/null +++ b/README.da.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Nul overhead. Nul kompromis. 100% Rust. 100% Agnostisk.</strong><br> + ⚡️ <strong>Kører på $10 hardware med <5MB RAM: Det er 99% mindre hukommelse end OpenClaw og 98% billigere end en Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Sprog:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Hvad er ZeroClaw? + +ZeroClaw er en letvægts, foranderlig og udvidbar AI-assistent-infrastruktur bygget i Rust. Den forbinder forskellige LLM-udbydere (Anthropic, OpenAI, Google, Ollama osv.) via en samlet grænseflade og understøtter flere kanaler (Telegram, Matrix, CLI osv.). + +### Nøglefunktioner + +- **🦀 Skrevet i Rust**: Høj ydeevne, hukommelsessikkerhed og nul-omkostningsabstraktioner +- **🔌 Udbyder-agnostisk**: Understøtter OpenAI, Anthropic, Google Gemini, Ollama og andre +- **📱 Multi-kanal**: Telegram, Matrix (med E2EE), CLI og andre +- **🧠 Pluggbar hukommelse**: SQLite og Markdown-backends +- **🛠️ Udvidbare værktøjer**: Tilføj brugerdefinerede værktøjer nemt +- **🔒 Sikkerhed først**: Omvendt proxy, privatlivs-først design + +--- + +## Hurtig Start + +### Krav + +- Rust 1.70+ +- En LLM-udbyder API-nøgle (Anthropic, OpenAI osv.) + +### Installation + +```bash +# Klon repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Byg +cargo build --release + +# Kør +cargo run --release +``` + +### Med Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Konfiguration + +ZeroClaw bruger en YAML-konfigurationsfil. Som standard leder den efter `config.yaml`. + +```yaml +# Standardudbyder +provider: anthropic + +# Udbyderkonfiguration +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Hukommelseskonfiguration +memory: + backend: sqlite + path: data/memory.db + +# Kanalkonfiguration +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Dokumentation + +For detaljeret dokumentation, se: + +- [Dokumentationshub](docs/README.md) +- [Kommandoreference](docs/commands-reference.md) +- [Udbyderreference](docs/providers-reference.md) +- [Kanalreference](docs/channels-reference.md) +- [Konfigurationsreference](docs/config-reference.md) + +--- + +## Bidrag + +Bidrag er velkomne! Læs venligst [Bidragsguiden](CONTRIBUTING.md). + +--- + +## Licens + +Dette projekt er dobbelt-licenseret: + +- MIT License +- Apache License, version 2.0 + +Se [LICENSE-APACHE](LICENSE-APACHE) og [LICENSE-MIT](LICENSE-MIT) for detaljer. + +--- + +## Fællesskab + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Sponsorer + +Hvis ZeroClaw er nyttigt for dig, overvej venligst at købe os en kaffe: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.de.md b/README.de.md new file mode 100644 index 000000000..3ef05794a --- /dev/null +++ b/README.de.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Null Overhead. Null Kompromiss. 100% Rust. 100% Agnostisch.</strong><br> + ⚡️ <strong>Läuft auf 10$ Hardware mit <5MB RAM: Das ist 99% weniger Speicher als OpenClaw und 98% günstiger als ein Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Erstellt von Studenten und Mitgliedern der Harvard, MIT und Sundai.Club Gemeinschaften. +</p> + +<p align="center"> + 🌐 <strong>Sprachen:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#schnellstart">Schnellstart</a> | + <a href="bootstrap.sh">Ein-Klick-Einrichtung</a> | + <a href="docs/README.md">Dokumentations-Hub</a> | + <a href="docs/SUMMARY.md">Dokumentations-Inhaltsverzeichnis</a> +</p> + +<p align="center"> + <strong>Schnellzugriffe:</strong> + <a href="docs/reference/README.md">Referenz</a> · + <a href="docs/operations/README.md">Betrieb</a> · + <a href="docs/troubleshooting.md">Fehlerbehebung</a> · + <a href="docs/security/README.md">Sicherheit</a> · + <a href="docs/hardware/README.md">Hardware</a> · + <a href="docs/contributing/README.md">Mitwirken</a> +</p> + +<p align="center"> + <strong>Schnelle, leichtgewichtige und vollständig autonome KI-Assistenten-Infrastruktur</strong><br /> + Deploy überall. Tausche alles. +</p> + +<p align="center"> + ZeroClaw ist das <strong>Runtime-Betriebssystem</strong> für Agenten-Workflows — eine Infrastruktur, die Modelle, Tools, Speicher und Ausführung abstrahiert, um Agenten einmal zu bauen und überall auszuführen. +</p> + +<p align="center"><code>Trait-basierte Architektur · sicheres Runtime standardmäßig · Provider/Channel/Tool austauschbar · alles ist steckbar</code></p> + +### 📢 Ankündigungen + +Verwende diese Tabelle für wichtige Hinweise (Kompatibilitätsänderungen, Sicherheitshinweise, Wartungsfenster und Versionsblockierungen). + +| Datum (UTC) | Ebene | Hinweis | Aktion | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Kritisch_ | Wir sind **nicht verbunden** mit `openagen/zeroclaw` oder `zeroclaw.org`. Die Domain `zeroclaw.org` zeigt derzeit auf den Fork `openagen/zeroclaw`, und diese Domain/Repository fälscht unsere offizielle Website/Projekt. | Vertraue keinen Informationen, Binärdateien, Fundraising oder Ankündigungen aus diesen Quellen. Verwende nur [dieses Repository](https://github.com/zeroclaw-labs/zeroclaw) und unsere verifizierten Social-Media-Konten. | +| 2026-02-21 | _Wichtig_ | Unsere offizielle Website ist jetzt online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Danke für deine Geduld während der Wartezeit. Wir erkennen weiterhin Fälschungsversuche: nimm an keiner Investitions-/Finanzierungsaktivität im Namen von ZeroClaw teil, wenn sie nicht über unsere offiziellen Kanäle veröffentlicht wird. | Verwende [dieses Repository](https://github.com/zeroclaw-labs/zeroclaw) als einzige Quelle der Wahrheit. Folge [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (Gruppe)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), und [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) für offizielle Updates. | +| 2026-02-19 | _Wichtig_ | Anthropic hat die Nutzungsbedingungen für Authentifizierung und Anmeldedaten am 2026-02-19 aktualisiert. Die OAuth-Authentifizierung (Free, Pro, Max) ist ausschließlich für Claude Code und Claude.ai; die Verwendung von Claude Free/Pro/Max OAuth-Token in einem anderen Produkt, Tool oder Dienst (einschließlich Agent SDK) ist nicht erlaubt und kann gegen die Verbrauchernutzungsbedingungen verstoßen. | Bitte vermeide vorübergehend Claude Code OAuth-Integrationen, um potenzielle Verluste zu verhindern. Originalklausel: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Funktionen + +- 🏎️ **Leichtgewichtiges Runtime standardmäßig:** Gängige CLI-Workflows und Statusbefehle laufen in einem Speicherbereich von wenigen Megabyte bei Produktions-Builds. +- 💰 **Kosteneffizientes Deployment:** Entwickelt für Low-Cost-Boards und kleine Cloud-Instanzen ohne schwere Runtime-Abhängigkeiten. +- ⚡ **Schnelle Kaltstarts:** Die Single-Binary-Rust-Runtime hält Befehls- und Daemon-Starts für tägliche Operationen nahezu augenblicklich. +- 🌍 **Portable Architektur:** Ein Single-Binary-Workflow auf ARM, x86 und RISC-V mit austauschbaren Providern/Channels/Tools. + +### Warum Teams ZeroClaw wählen + +- **Leichtgewichtig standardmäßig:** kleines Rust-Binary, schneller Start, geringer Speicherbedarf. +- **Sicher by Design:** Pairing, striktes Sandboxing, explizite Allowlists, Workspace-Scope. +- **Vollständig austauschbar:** Kernsysteme sind Traits (Provider, Channels, Tools, Speicher, Tunnel). +- **Kein Provider-Lock-in:** OpenAI-kompatible Provider-Unterstützung + steckbare Custom-Endpoints. + +## Benchmark-Snapshot (ZeroClaw vs OpenClaw, Reproduzierbar) + +Schneller Benchmark auf lokalem Rechner (macOS arm64, Feb. 2026) normalisiert für 0.8 GHz Edge-Hardware. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Sprache** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Start (0.8 GHz Kern)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Binary-Größe** | ~28 MB (dist) | N/A (Scripts) | ~8 MB | **3.4 MB** | +| **Kosten** | Mac Mini $599 | Linux SBC ~$50 | Linux-Board $10 | **Jede Hardware $10** | + +> Hinweise: ZeroClaw-Ergebnisse werden auf Produktions-Builds mit `/usr/bin/time -l` gemessen. OpenClaw benötigt die Node.js-Runtime (typischerweise ~390 MB zusätzlicher Speicher-Overhead), während NanoBot die Python-Runtime benötigt. PicoClaw und ZeroClaw sind statische Binaries. Die oben genannten RAM-Zahlen sind Runtime-Speicher; Build-time-Kompilierungsanforderungen sind höher. + +<p align="center"> + <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Vergleich" width="800" /> +</p> + +### Reproduzierbare lokale Messung + +Benchmark-Behauptungen können sich ändern, wenn Code und Toolchains sich weiterentwickeln, also miss deinen aktuellen Build immer lokal: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Beispielstichprobe (macOS arm64, gemessen am 18. Februar 2026): + +- Release-Binary-Größe: `8.8M` +- `zeroclaw --help`: Echtzeit ca. `0.02s`, maximaler Speicherbedarf ~`3.9 MB` +- `zeroclaw status`: Echtzeit ca. `0.01s`, maximaler Speicherbedarf ~`4.1 MB` + +## Voraussetzungen + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Erforderlich + +1. **Visual Studio Build Tools** (stellt MSVC-Linker und Windows SDK bereit): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Wähle während der Installation (oder über Visual Studio Installer) die Workload **"Desktop-Entwicklung mit C++"**. + +2. **Rust-Toolchain:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Öffne nach der Installation ein neues Terminal und führe `rustup default stable` aus, um sicherzustellen, dass die stabile Toolchain aktiv ist. + +3. **Überprüfe**, dass beide funktionieren: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Optional + +- **Docker Desktop** — nur erforderlich, wenn du die [Docker-Sandbox-Runtime](#aktuelle-runtime-unterstützung) verwendest (`runtime.kind = "docker"`). Installiere über `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Erforderlich + +1. **Essentielle Build-Tools:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Installiere Xcode Command Line Tools: `xcode-select --install` + +2. **Rust-Toolchain:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Siehe [rustup.rs](https://rustup.rs) für Details. + +3. **Überprüfe:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Optional + +- **Docker** — nur erforderlich, wenn du die [Docker-Sandbox-Runtime](#aktuelle-runtime-unterstützung) verwendest (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** siehe [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** siehe [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** installiere Docker Desktop über [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Schnellstart + +### Option 1: Automatisierte Einrichtung (empfohlen) + +Das `bootstrap.sh`-Skript installiert Rust, klont ZeroClaw, kompiliert es und richtet deine anfängliche Entwicklungsumgebung ein: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Dies wird: + +1. Rust installieren (falls nicht vorhanden) +2. Das ZeroClaw-Repository klonen +3. ZeroClaw im Release-Modus kompilieren +4. `zeroclaw` in `~/.cargo/bin/` installieren +5. Die Standard-Workspace-Struktur in `~/.zeroclaw/workspace/` erstellen +6. Eine Startkonfigurationsdatei `~/.zeroclaw/workspace/config.toml` generieren + +Nach dem Bootstrap lade deine Shell neu oder führe `source ~/.cargo/env` aus, um den `zeroclaw`-Befehl global zu verwenden. + +### Option 2: Manuelle Installation + +<details> +<summary><strong>Klicke, um die manuellen Installationsschritte zu sehen</strong></summary> + +```bash +# 1. Klone das Repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Kompiliere im Release-Modus +cargo build --release --locked + +# 3. Installiere das Binary +cargo install --path . --locked + +# 4. Initialisiere den Workspace +zeroclaw init + +# 5. Überprüfe die Installation +zeroclaw --version +zeroclaw status +``` + +</details> + +### Nach der Installation + +Nach der Installation (via Bootstrap oder manuell) solltest du sehen: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Hauptkonfiguration +├── .pairing # Pairing-Geheimnisse (beim ersten Start generiert) +├── logs/ # Daemon/Agent-Logs +├── skills/ # Benutzerdefinierte Skills +└── memory/ # Konversationskontext-Speicherung +``` + +**Nächste Schritte:** + +1. Konfiguriere deine KI-Provider in `~/.zeroclaw/workspace/config.toml` +2. Sieh dir die [Konfigurationsreferenz](docs/config-reference.md) für erweiterte Optionen an +3. Starte den Agent: `zeroclaw agent start` +4. Teste über deinen bevorzugten Channel (siehe [Channel-Referenz](docs/channels-reference.md)) + +## Konfiguration + +Bearbeite `~/.zeroclaw/workspace/config.toml`, um Provider, Channels und Systemverhalten zu konfigurieren. + +### Schnelle Konfigurationsreferenz + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # oder "sqlite" oder "none" + +[runtime] +kind = "native" # oder "docker" (erfordert Docker) +``` + +**Vollständige Referenzdokumente:** + +- [Konfigurationsreferenz](docs/config-reference.md) — alle Einstellungen, Validierungen, Standardwerte +- [Provider-Referenz](docs/providers-reference.md) — KI-Provider-spezifische Konfigurationen +- [Channel-Referenz](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord und mehr +- [Betrieb](docs/operations-runbook.md) — Produktionsüberwachung, Secret-Rotation, Skalierung + +### Aktuelle Runtime-Unterstützung + +ZeroClaw unterstützt zwei Code-Ausführungs-Backends: + +- **`native`** (Standard) — direkte Prozessausführung, schnellster Pfad, ideal für vertrauenswürdige Umgebungen +- **`docker`** — vollständige Container-Isolierung, gehärtete Sicherheitsrichtlinien, erfordert Docker + +Verwende `runtime.kind = "docker"`, wenn du striktes Sandboxing oder Netzwerkisolierung benötigst. Siehe [Konfigurationsreferenz](docs/config-reference.md#runtime) für vollständige Details. + +## Befehle + +```bash +# Workspace-Verwaltung +zeroclaw init # Initialisiert einen neuen Workspace +zeroclaw status # Zeigt Daemon/Agent-Status +zeroclaw config validate # Überprüft config.toml Syntax und Werte + +# Daemon-Verwaltung +zeroclaw daemon start # Startet den Daemon im Hintergrund +zeroclaw daemon stop # Stoppt den laufenden Daemon +zeroclaw daemon restart # Startet den Daemon neu (Config-Neuladen) +zeroclaw daemon logs # Zeigt Daemon-Logs + +# Agent-Verwaltung +zeroclaw agent start # Startet den Agent (erfordert laufenden Daemon) +zeroclaw agent stop # Stoppt den Agent +zeroclaw agent restart # Startet den Agent neu (Config-Neuladen) + +# Pairing-Operationen +zeroclaw pairing init # Generiert ein neues Pairing-Geheimnis +zeroclaw pairing rotate # Rotiert das bestehende Pairing-Geheimnis + +# Tunneling (für öffentliche Exposition) +zeroclaw tunnel start # Startet einen Tunnel zum lokalen Daemon +zeroclaw tunnel stop # Stoppt den aktiven Tunnel + +# Diagnose +zeroclaw doctor # Führt System-Gesundheitsprüfungen durch +zeroclaw version # Zeigt Version und Build-Informationen +``` + +Siehe [Befehlsreferenz](docs/commands-reference.md) für vollständige Optionen und Beispiele. + +## Architektur + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Channels (Trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Agent-Orchestrator │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Routing │ │ Kontext │ │ Ausführung │ │ +│ │ Nachricht │ │ Speicher │ │ Werkzeug │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Provider │ │ Speicher │ │ Werkzeuge │ +│ (Trait) │ │ (Trait) │ │ (Trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (Trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Schlüsselprinzipien:** + +- Alles ist ein **Trait** — Provider, Channels, Tools, Speicher, Tunnel +- Channels rufen den Orchestrator auf; der Orchestrator ruft Provider + Tools auf +- Das Speichersystem verwaltet Konversationskontext (Markdown, SQLite, oder keiner) +- Das Runtime abstrahiert Code-Ausführung (nativ oder Docker) +- Kein Provider-Lock-in — tausche Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama ohne Code-Änderungen + +Siehe [Architektur-Dokumentation](docs/architecture.svg) für detaillierte Diagramme und Implementierungsdetails. + +## Beispiele + +### Telegram-Bot + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Deine Telegram-Benutzer-ID +``` + +Starte den Daemon + Agent, dann sende eine Nachricht an deinen Bot auf Telegram: + +``` +/start +Hallo! Könntest du mir helfen, ein Python-Skript zu schreiben? +``` + +Der Bot antwortet mit KI-generiertem Code, führt Tools auf Anfrage aus und behält den Konversationskontext. + +### Matrix (Ende-zu-Ende-Verschlüsselung) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Lade `@zeroclaw:matrix.org` in einen verschlüsselten Raum ein, und der Bot wird mit vollständiger Verschlüsselung antworten. Siehe [Matrix E2EE-Leitfaden](docs/matrix-e2ee-guide.md) für Geräteverifizierungs-Setup. + +### Multi-Provider + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover bei Provider-Fehler +``` + +Wenn Anthropic fehlschlägt oder Rate-Limit erreicht, wechselt der Orchestrator automatisch zu OpenAI. + +### Benutzerdefinierter Speicher + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Automatische Bereinigung nach 90 Tagen +``` + +Oder verwende Markdown für menschenlesbaren Speicher: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Siehe [Konfigurationsreferenz](docs/config-reference.md#memory) für alle Speicheroptionen. + +## Provider-Unterstützung + +| Provider | Status | API-Schlüssel | Beispielmodelle | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Stabil | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Stabil | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Stabil | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Stabil | N/A (lokal) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Stabil | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Stabil | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Geplant | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Geplant | `COHERE_API_KEY` | TBD | + +### Benutzerdefinierte Endpoints + +ZeroClaw unterstützt OpenAI-kompatible Endpoints: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Beispiel: verwende [LiteLLM](https://github.com/BerriAI/litellm) als Proxy, um auf jedes LLM über die OpenAI-Schnittstelle zuzugreifen. + +Siehe [Provider-Referenz](docs/providers-reference.md) für vollständige Konfigurationsdetails. + +## Channel-Unterstützung + +| Channel | Status | Authentifizierung | Hinweise | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Stabil | Bot-Token | Vollständige Unterstützung inklusive Dateien, Bilder, Inline-Buttons | +| **Matrix** | ✅ Stabil | Passwort oder Token | E2EE-Unterstützung mit Geräteverifizierung | +| **Slack** | 🚧 Geplant | OAuth oder Bot-Token | Erfordert Workspace-Zugriff | +| **Discord** | 🚧 Geplant | Bot-Token | Erfordert Guild-Berechtigungen | +| **WhatsApp** | 🚧 Geplant | Twilio oder offizielle API | Erfordert Business-Konto | +| **CLI** | ✅ Stabil | Keine | Direkte konversationelle Schnittstelle | +| **Web** | 🚧 Geplant | API-Schlüssel oder OAuth | Browserbasierte Chat-Schnittstelle | + +Siehe [Channel-Referenz](docs/channels-reference.md) für vollständige Konfigurationsanleitungen. + +## Tool-Unterstützung + +ZeroClaw bietet integrierte Tools für Code-Ausführung, Dateisystemzugriff und Web-Abruf: + +| Tool | Beschreibung | Erforderliches Runtime | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Führt Shell-Befehle aus | Nativ oder Docker | +| **python** | Führt Python-Skripte aus | Python 3.8+ (nativ) oder Docker | +| **javascript** | Führt Node.js-Code aus | Node.js 18+ (nativ) oder Docker | +| **filesystem_read** | Liest Dateien | Nativ oder Docker | +| **filesystem_write** | Schreibt Dateien | Nativ oder Docker | +| **web_fetch** | Ruft Web-Inhalte ab | Nativ oder Docker | + +### Ausführungssicherheit + +- **Natives Runtime** — läuft als Benutzerprozess des Daemons, voller Dateisystemzugriff +- **Docker-Runtime** — vollständige Container-Isolierung, separate Dateisysteme und Netzwerke + +Konfiguriere die Ausführungsrichtlinie in `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Explizite Allowlist +``` + +Siehe [Konfigurationsreferenz](docs/config-reference.md#runtime) für vollständige Sicherheitsoptionen. + +## Deployment + +### Lokales Deployment (Entwicklung) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Server-Deployment (Produktion) + +Verwende systemd, um Daemon und Agent als Dienste zu verwalten: + +```bash +# Installiere das Binary +cargo install --path . --locked + +# Konfiguriere den Workspace +zeroclaw init + +# Erstelle systemd-Dienstdateien +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Aktiviere und starte die Dienste +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Überprüfe den Status +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Siehe [Netzwerk-Deployment-Leitfaden](docs/network-deployment.md) für vollständige Produktions-Deployment-Anleitungen. + +### Docker + +```bash +# Baue das Image +docker build -t zeroclaw:latest . + +# Führe den Container aus +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Siehe [`Dockerfile`](Dockerfile) für Build-Details und Konfigurationsoptionen. + +### Edge-Hardware + +ZeroClaw ist für den Betrieb auf Low-Power-Hardware konzipiert: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, einzelner ARMv8-Kern, < $5 Hardware-Kosten +- **Raspberry Pi 4/5** — 1 GB+ RAM, Multi-Core, ideal für gleichzeitige Workloads +- **Orange Pi Zero 2** — ~512 MB RAM, Quad-Core ARMv8, Ultra-Low-Cost +- **x86 SBCs (Intel N100)** — 4-8 GB RAM, schnelle Builds, nativer Docker-Support + +Siehe [Hardware-Leitfaden](docs/hardware/README.md) für gerätespezifische Einrichtungsanleitungen. + +## Tunneling (Öffentliche Exposition) + +Exponiere deinen lokalen ZeroClaw-Daemon über sichere Tunnel zum öffentlichen Netzwerk: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Unterstützte Tunnel-Provider: + +- **Cloudflare Tunnel** — kostenloses HTTPS, keine Port-Exposition, Multi-Domain-Support +- **Ngrok** — schnelle Einrichtung, benutzerdefinierte Domains (kostenpflichtiger Plan) +- **Tailscale** — privates Mesh-Netzwerk, kein öffentlicher Port + +Siehe [Konfigurationsreferenz](docs/config-reference.md#tunnel) für vollständige Konfigurationsoptionen. + +## Sicherheit + +ZeroClaw implementiert mehrere Sicherheitsebenen: + +### Pairing + +Der Daemon generiert beim ersten Start ein Pairing-Geheimnis, das in `~/.zeroclaw/workspace/.pairing` gespeichert wird. Clients (Agent, CLI) müssen dieses Geheimnis präsentieren, um eine Verbindung herzustellen. + +```bash +zeroclaw pairing rotate # Generiert ein neues Geheimnis und erklärt das alte für ungültig +``` + +### Sandboxing + +- **Docker-Runtime** — vollständige Container-Isolierung mit separaten Dateisystemen und Netzwerken +- **Natives Runtime** — läuft als Benutzerprozess, standardmäßig auf Workspace beschränkt + +### Allowlists + +Channels können den Zugriff nach Benutzer-ID einschränken: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Explizite Allowlist +``` + +### Verschlüsselung + +- **Matrix E2EE** — vollständige Ende-zu-Ende-Verschlüsselung mit Geräteverifizierung +- **TLS-Transport** — der gesamte API- und Tunnel-Verkehr verwendet HTTPS/TLS + +Siehe [Sicherheitsdokumentation](docs/security/README.md) für vollständige Richtlinien und Praktiken. + +## Observability + +ZeroClaw protokolliert standardmäßig in `~/.zeroclaw/workspace/logs/`. Logs werden nach Komponente gespeichert: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Daemon-Logs (Start, API-Anfragen, Fehler) +├── agent.log # Agent-Logs (Nachrichten-Routing, Tool-Ausführung) +├── telegram.log # Kanalspezifische Logs (falls aktiviert) +└── matrix.log # Kanalspezifische Logs (falls aktiviert) +``` + +### Logging-Konfiguration + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # Für größenbasierte Rotation +retention_days = 30 # Automatische Bereinigung nach N Tagen +``` + +Siehe [Konfigurationsreferenz](docs/config-reference.md#logging) für alle Logging-Optionen. + +### Metriken (Geplant) + +Prometheus-Metrik-Unterstützung für Produktionsüberwachung kommt bald. Verfolgung in [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Skills + +ZeroClaw unterstützt benutzerdefinierte Skills — wiederverwendbare Module, die die Systemfähigkeiten erweitern. + +### Skill-Definition + +Skills werden in `~/.zeroclaw/workspace/skills/<skill-name>/` mit dieser Struktur gespeichert: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Skill-Metadaten (Name, Beschreibung, Abhängigkeiten) + ├── prompt.md # System-Prompt für die KI + └── tools/ # Optionale benutzerdefinierte Tools + └── my_tool.py +``` + +### Skill-Beispiel + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Sucht im Web und fasst Ergebnisse zusammen" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Du bist ein Forschungsassistent. Wenn du gebeten wirst, etwas zu recherchieren: + +1. Verwende web_fetch, um den Inhalt abzurufen +2. Fasse die Ergebnisse in einem leicht lesbaren Format zusammen +3. Zitiere die Quellen mit URLs +``` + +### Skill-Verwendung + +Skills werden beim Agent-Start automatisch geladen. Referenziere sie nach Namen in Konversationen: + +``` +Benutzer: Verwende den Web-Research-Skill, um die neuesten KI-Nachrichten zu finden +Bot: [lädt den Web-Research-Skill, führt web_fetch aus, fasst Ergebnisse zusammen] +``` + +Siehe Abschnitt [Skills](#skills) für vollständige Skill-Erstellungsanleitungen. + +## Open Skills + +ZeroClaw unterstützt [Open Skills](https://github.com/openagents-com/open-skills) — ein modulares und provider-agnostisches System zur Erweiterung von KI-Agenten-Fähigkeiten. + +### Open Skills aktivieren + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # optional +``` + +Du kannst auch zur Laufzeit mit `ZEROCLAW_OPEN_SKILLS_ENABLED` und `ZEROCLAW_OPEN_SKILLS_DIR` überschreiben. + +## Entwicklung + +```bash +cargo build # Entwicklungs-Build +cargo build --release # Release-Build (codegen-units=1, funktioniert auf allen Geräten einschließlich Raspberry Pi) +cargo build --profile release-fast # Schnellerer Build (codegen-units=8, erfordert 16 GB+ RAM) +cargo test # Führt die vollständige Test-Suite aus +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Formatierung + +# Führe den SQLite vs Markdown Vergleichs-Benchmark aus +cargo test --test memory_comparison -- --nocapture +``` + +### Pre-push-Hook + +Ein Git-Hook führt `cargo fmt --check`, `cargo clippy -- -D warnings`, und `cargo test` vor jedem Push aus. Aktiviere ihn einmal: + +```bash +git config core.hooksPath .githooks +``` + +### Build-Fehlerbehebung (OpenSSL-Fehler unter Linux) + +Wenn du auf einen `openssl-sys`-Build-Fehler stößt, synchronisiere Abhängigkeiten und kompiliere mit dem Lockfile des Repositories neu: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw ist so konfiguriert, dass es `rustls` für HTTP/TLS-Abhängigkeiten verwendet; `--locked` hält den transitiven Graphen in sauberen Umgebungen deterministisch. + +Um den Hook zu überspringen, wenn du während der Entwicklung einen schnellen Push benötigst: + +```bash +git push --no-verify +``` + +## Zusammenarbeit & Docs + +Beginne mit dem Dokumentations-Hub für eine Aufgaben-basierte Karte: + +- Dokumentations-Hub: [`docs/README.md`](docs/README.md) +- Vereinigtes Docs-Inhaltsverzeichnis: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Befehlsreferenz: [`docs/commands-reference.md`](docs/commands-reference.md) +- Konfigurationsreferenz: [`docs/config-reference.md`](docs/config-reference.md) +- Provider-Referenz: [`docs/providers-reference.md`](docs/providers-reference.md) +- Channel-Referenz: [`docs/channels-reference.md`](docs/channels-reference.md) +- Betriebshandbuch: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Fehlerbehebung: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Docs-Inventar/Klassifizierung: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- PR/Issue-Triage-Snapshot (Stand 18. Feb. 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Hauptzusammenarbeitsreferenzen: + +- Dokumentations-Hub: [docs/README.md](docs/README.md) +- Dokumentationsvorlage: [docs/doc-template.md](docs/doc-template.md) +- Dokumentationsänderungs-Checkliste: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Channel-Konfigurationsreferenz: [docs/channels-reference.md](docs/channels-reference.md) +- Matrix-verschlüsselte Raum-Operationen: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Beitragsleitfaden: [CONTRIBUTING.md](CONTRIBUTING.md) +- PR-Workflow-Richtlinie: [docs/pr-workflow.md](docs/pr-workflow.md) +- Reviewer-Playbook (Triage + Tiefenreview): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Eigentums- und CI-Triage-Map: [docs/ci-map.md](docs/ci-map.md) +- Sicherheits-Offenlegungsrichtlinie: [SECURITY.md](SECURITY.md) + +Für Deployment und Runtime-Betrieb: + +- Netzwerk-Deployment-Leitfaden: [docs/network-deployment.md](docs/network-deployment.md) +- Proxy-Agent-Playbook: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## ZeroClaw unterstützen + +Wenn ZeroClaw deine Arbeit hilft und du die kontinuierliche Entwicklung unterstützen möchtest, kannst du hier spenden: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Kauf mir einen Kaffee" /></a> + +### 🙏 Besonderer Dank + +Ein herzliches Dankeschön an die Gemeinschaften und Institutionen, die diese Open-Source-Arbeit inspirieren und unterstützen: + +- **Harvard University** — für die Förderung intellektueller Neugier und das Erweitern der Grenzen des Möglichen. +- **MIT** — für das Eintreten für offenes Wissen, Open Source und die Überzeugung, dass Technologie für alle zugänglich sein sollte. +- **Sundai Club** — für die Gemeinschaft, die Energie und den unermüdlichen Willen, Dinge zu bauen, die zählen. +- **Die Welt und Darüber Hinaus** 🌍✨ — an jeden Mitwirkenden, Träumer und Erbauer da draußen, der Open Source zu einer Kraft für das Gute macht. Das ist für dich. + +Wir bauen in Open Source, weil die besten Ideen von überall kommen. Wenn du das liest, bist du Teil davon. Willkommen. 🦀❤️ + +## ⚠️ Offizielles Repository und Fälschungswarnung + +**Dies ist das einzige offizielle ZeroClaw-Repository:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Jedes andere Repository, Organisation, Domain oder Paket, das behauptet "ZeroClaw" zu sein oder eine Verbindung zu ZeroClaw Labs zu implizieren, ist **nicht autorisiert und nicht mit diesem Projekt verbunden**. Bekannte nicht autorisierte Forks werden in [TRADEMARK.md](TRADEMARK.md) aufgeführt. + +Wenn du auf Fälschung oder Markenmissbrauch stößt, bitte [öffne ein Issue](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Lizenz + +ZeroClaw ist doppelt lizenziert für maximale Offenheit und Contributorschutz: + +| Lizenz | Anwendungsfälle | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Open-Source, Forschung, akademisch, persönliche Nutzung | +| [Apache 2.0](LICENSE-APACHE) | Patentschutz, institutionell, kommerzielles Deployment | + +Du kannst eine der beiden Lizenzen wählen. **Contributors gewähren automatisch Rechte unter beiden** — siehe [CLA.md](CLA.md) für die vollständige Contributor-Vereinbarung. + +### Marke + +Der Name **ZeroClaw** und das Logo sind eingetragene Marken von ZeroClaw Labs. Diese Lizenz gewährt keine Erlaubnis, sie zu verwenden, um Befürwortung oder Verbindung zu implizieren. Siehe [TRADEMARK.md](TRADEMARK.md) für erlaubte und verbotene Verwendungen. + +### Contributorschutz + +- Du **behältst das Urheberrecht** an deinen Beiträgen +- **Patentgewährung** (Apache 2.0) schützt dich vor Patentansprüchen anderer Contributors +- Deine Beiträge werden **dauerhaft zugeschrieben** in der Commit-Historie und [NOTICE](NOTICE) +- Keine Markenrechte werden durch Beiträge übertragen + +## Mitwirken + +Siehe [CONTRIBUTING.md](CONTRIBUTING.md) und [CLA.md](CLA.md). Implementiere einen Trait, reiche eine PR ein: + +- CI-Workflow-Leitfaden: [docs/ci-map.md](docs/ci-map.md) +- Neuer `Provider` → `src/providers/` +- Neuer `Channel` → `src/channels/` +- Neuer `Observer` → `src/observability/` +- Neues `Tool` → `src/tools/` +- Neuer `Memory` → `src/memory/` +- Neuer `Tunnel` → `src/tunnel/` +- Neuer `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Null Overhead. Null Kompromiss. Deploy überall. Tausche alles. 🦀 + +## Stern-Historie + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Stern-Historie-Diagramm" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.el.md b/README.el.md new file mode 100644 index 000000000..a6ea36964 --- /dev/null +++ b/README.el.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Μηδενικό overhead. Μηδενικός συμβιβασμός. 100% Rust. 100% Αγνωστικιστικό.</strong><br> + ⚡️ <strong>Εκτελείται σε hardware $10 με <5MB RAM: Αυτό είναι 99% λιγότερη μνήμη από το OpenClaw και 98% φθηνότερο από ένα Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Γλώσσες:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Τι είναι το ZeroClaw; + +Το ZeroClaw είναι μια ελαφριά, μεταβλητή και επεκτάσιμη υποδομή AI βοηθού χτισμένη σε Rust. Συνδέει διάφορους παρόχους LLM (Anthropic, OpenAI, Google, Ollama, κλπ.) μέσω μιας ενοποιημένης διεπαφής και υποστηρίζει πολλαπλά κανάλια (Telegram, Matrix, CLI, κλπ.). + +### Κύρια Χαρακτηριστικά + +- **🦀 Γραμμένο σε Rust**: Υψηλή απόδοση, ασφάλεια μνήμης και αφαιρέσεις μηδενικού κόστους +- **🔌 Αγνωστικιστικό προς παρόχους**: Υποστηρίζει OpenAI, Anthropic, Google Gemini, Ollama και άλλους +- **📱 Πολυκάναλο**: Telegram, Matrix (με E2EE), CLI και άλλα +- **🧠 Προσαρμόσιμη μνήμη**: SQLite και Markdown backends +- **🛠️ Επεκτάσιμα εργαλεία**: Προσθέστε εύκολα προσαρμοσμένα εργαλεία +- **🔒 Ασφάλεια πρώτα**: Αντίστροφος proxy, σχεδιασμός προσανατολισμένος στο απόρρητο + +--- + +## Γρήγορη Εκκίνηση + +### Απαιτήσεις + +- Rust 1.70+ +- Ένα κλειδί API παρόχου LLM (Anthropic, OpenAI, κλπ.) + +### Εγκατάσταση + +```bash +# Κλωνοποιήστε το repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Κατασκευή +cargo build --release + +# Εκτέλεση +cargo run --release +``` + +### Με Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Ρύθμιση + +Το ZeroClaw χρησιμοποιεί ένα αρχείο ρύθμισης YAML. Από προεπιλογή, αναζητά το `config.yaml`. + +```yaml +# Προεπιλεγμένος πάροχος +provider: anthropic + +# Ρύθμιση παρόχων +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Ρύθμιση μνήμης +memory: + backend: sqlite + path: data/memory.db + +# Ρύθμιση καναλιών +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Τεκμηρίωση + +Για λεπτομερή τεκμηρίωση, δείτε: + +- [Κόμβος Τεκμηρίωσης](docs/README.md) +- [Αναφορά Εντολών](docs/commands-reference.md) +- [Αναφορά Παρόχων](docs/providers-reference.md) +- [Αναφορά Καναλιών](docs/channels-reference.md) +- [Αναφορά Ρυθμίσεων](docs/config-reference.md) + +--- + +## Συνεισφορά + +Οι συνεισφορές είναι ευπρόσδεκτες! Παρακαλώ διαβάστε τον [Οδηγό Συνεισφοράς](CONTRIBUTING.md). + +--- + +## Άδεια + +Αυτό το έργο έχει διπλή άδεια: + +- MIT License +- Apache License, έκδοση 2.0 + +Δείτε τα [LICENSE-APACHE](LICENSE-APACHE) και [LICENSE-MIT](LICENSE-MIT) για λεπτομέρειες. + +--- + +## Κοινότητα + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Χορηγοί + +Αν το ZeroClaw είναι χρήσιμο για εσάς, παρακαλώ σκεφτείτε να μας αγοράσετε έναν καφέ: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.es.md b/README.es.md new file mode 100644 index 000000000..3e0825625 --- /dev/null +++ b/README.es.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Cero sobrecarga. Cero compromiso. 100% Rust. 100% Agnóstico.</strong><br> + ⚡️ <strong>¡Ejecuta en hardware de $10 con <5MB de RAM: ¡Eso es 99% menos memoria que OpenClaw y 98% más barato que un Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Construido por estudiantes y miembros de las comunidades de Harvard, MIT y Sundai.Club. +</p> + +<p align="center"> + 🌐 <strong>Idiomas:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#inicio-rápido">Inicio Rápido</a> | + <a href="bootstrap.sh">Configuración con Un Clic</a> | + <a href="docs/README.md">Hub de Documentación</a> | + <a href="docs/SUMMARY.md">Tabla de Contenidos de Documentación</a> +</p> + +<p align="center"> + <strong>Accesos rápidos:</strong> + <a href="docs/reference/README.md">Referencia</a> · + <a href="docs/operations/README.md">Operaciones</a> · + <a href="docs/troubleshooting.md">Solución de Problemas</a> · + <a href="docs/security/README.md">Seguridad</a> · + <a href="docs/hardware/README.md">Hardware</a> · + <a href="docs/contributing/README.md">Contribuir</a> +</p> + +<p align="center"> + <strong>Infraestructura de asistente AI rápida, ligera y completamente autónoma</strong><br /> + Despliega en cualquier lugar. Intercambia cualquier cosa. +</p> + +<p align="center"> + ZeroClaw es el <strong>sistema operativo de runtime</strong> para flujos de trabajo de agentes — una infraestructura que abstrae modelos, herramientas, memoria y ejecución para construir agentes una vez y ejecutarlos en cualquier lugar. +</p> + +<p align="center"><code>Arquitectura basada en traits · runtime seguro por defecto · proveedor/canal/herramienta intercambiables · todo es conectable</code></p> + +### 📢 Anuncios + +Usa esta tabla para avisos importantes (cambios de compatibilidad, avisos de seguridad, ventanas de mantenimiento y bloqueos de versión). + +| Fecha (UTC) | Nivel | Aviso | Acción | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Crítico_ | **No estamos afiliados** con `openagen/zeroclaw` o `zeroclaw.org`. El dominio `zeroclaw.org` apunta actualmente al fork `openagen/zeroclaw`, y este dominio/repositorio está suplantando nuestro sitio web/proyecto oficial. | No confíes en información, binarios, recaudaciones de fondos o anuncios de estas fuentes. Usa solo [este repositorio](https://github.com/zeroclaw-labs/zeroclaw) y nuestras cuentas sociales verificadas. | +| 2026-02-21 | _Importante_ | Nuestro sitio web oficial ahora está en línea: [zeroclawlabs.ai](https://zeroclawlabs.ai). Gracias por tu paciencia durante la espera. Todavía detectamos intentos de suplantación: no participes en ninguna actividad de inversión/financiamiento en nombre de ZeroClaw si no se publica a través de nuestros canales oficiales. | Usa [este repositorio](https://github.com/zeroclaw-labs/zeroclaw) como la única fuente de verdad. Sigue [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (grupo)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), y [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) para actualizaciones oficiales. | +| 2026-02-19 | _Importante_ | Anthropic actualizó los términos de uso de autenticación y credenciales el 2026-02-19. La autenticación OAuth (Free, Pro, Max) es exclusivamente para Claude Code y Claude.ai; el uso de tokens OAuth de Claude Free/Pro/Max en cualquier otro producto, herramienta o servicio (incluyendo Agent SDK) no está permitido y puede violar los Términos de Uso del Consumidor. | Por favor, evita temporalmente las integraciones OAuth de Claude Code para prevenir cualquier pérdida potencial. Cláusula original: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Características + +- 🏎️ **Runtime Ligero por Defecto:** Los flujos de trabajo CLI comunes y comandos de estado se ejecutan dentro de un espacio de memoria de pocos megabytes en builds de producción. +- 💰 **Despliegue Económico:** Diseñado para placas de bajo costo e instancias cloud pequeñas sin dependencias de runtime pesadas. +- ⚡ **Inicios en Frío Rápidos:** El runtime Rust de binario único mantiene el inicio de comandos y demonios casi instantáneo para operaciones diarias. +- 🌍 **Arquitectura Portátil:** Un flujo de trabajo de binario único en ARM, x86 y RISC-V con proveedor/canal/herramienta intercambiables. + +### Por qué los equipos eligen ZeroClaw + +- **Ligero por defecto:** binario Rust pequeño, inicio rápido, huella de memoria baja. +- **Seguro por diseño:** emparejamiento, sandboxing estricto, listas permitidas explícitas, alcance de workspace. +- **Completamente intercambiable:** los sistemas centrales son traits (proveedores, canales, herramientas, memoria, túneles). +- **Sin lock-in de proveedor:** soporte de proveedor compatible con OpenAI + endpoints personalizados conectables. + +## Instantánea de Benchmark (ZeroClaw vs OpenClaw, Reproducible) + +Benchmark rápido en máquina local (macOS arm64, feb. 2026) normalizado para hardware edge de 0.8 GHz. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Lenguaje** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Inicio (núcleo 0.8 GHz)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Tamaño Binario** | ~28 MB (dist) | N/A (Scripts) | ~8 MB | **3.4 MB** | +| **Costo** | Mac Mini $599 | Linux SBC ~$50 | Placa Linux $10 | **Cualquier hardware $10** | + +> Notas: Los resultados de ZeroClaw se miden en builds de producción usando `/usr/bin/time -l`. OpenClaw requiere el runtime Node.js (típicamente ~390 MB de sobrecarga de memoria adicional), mientras que NanoBot requiere el runtime Python. PicoClaw y ZeroClaw son binarios estáticos. Las cifras de RAM anteriores son memoria de runtime; los requisitos de compilación en tiempo de build son mayores. + +<p align="center"> + <img src="zero-claw.jpeg" alt="Comparación ZeroClaw vs OpenClaw" width="800" /> +</p> + +### Medición Local Reproducible + +Las afirmaciones de benchmark pueden derivar a medida que el código y las toolchains evolucionan, así que siempre mide tu build actual localmente: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Ejemplo de muestra (macOS arm64, medido el 18 de febrero de 2026): + +- Tamaño de binario release: `8.8M` +- `zeroclaw --help`: tiempo real aprox `0.02s`, huella de memoria máxima ~`3.9 MB` +- `zeroclaw status`: tiempo real aprox `0.01s`, huella de memoria máxima ~`4.1 MB` + +## Requisitos Previos + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Requerido + +1. **Visual Studio Build Tools** (proporciona el linker MSVC y el Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Durante la instalación (o a través de Visual Studio Installer), selecciona la carga de trabajo **"Desarrollo de escritorio con C++"**. + +2. **Toolchain Rust:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Después de la instalación, abre una nueva terminal y ejecuta `rustup default stable` para asegurar que la toolchain estable esté activa. + +3. **Verifica** que ambos funcionan: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Opcional + +- **Docker Desktop** — requerido solo si usas el [runtime sandboxed Docker](#soporte-de-runtime-actual) (`runtime.kind = "docker"`). Instala vía `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Requerido + +1. **Herramientas de compilación esenciales:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Instala Xcode Command Line Tools: `xcode-select --install` + +2. **Toolchain Rust:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Ver [rustup.rs](https://rustup.rs) para detalles. + +3. **Verifica:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Opcional + +- **Docker** — requerido solo si usas el [runtime sandboxed Docker](#soporte-de-runtime-actual) (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** ver [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** ver [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** instala Docker Desktop vía [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Inicio Rápido + +### Opción 1: Configuración automatizada (recomendada) + +El script `bootstrap.sh` instala Rust, clona ZeroClaw, lo compila, y configura tu entorno de desarrollo inicial: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Esto: + +1. Instalará Rust (si no está presente) +2. Clonará el repositorio ZeroClaw +3. Compilará ZeroClaw en modo release +4. Instalará `zeroclaw` en `~/.cargo/bin/` +5. Creará la estructura de workspace por defecto en `~/.zeroclaw/workspace/` +6. Generará un archivo de configuración inicial `~/.zeroclaw/workspace/config.toml` + +Después del bootstrap, recarga tu shell o ejecuta `source ~/.cargo/env` para usar el comando `zeroclaw` globalmente. + +### Opción 2: Instalación manual + +<details> +<summary><strong>Clic para ver los pasos de instalación manual</strong></summary> + +```bash +# 1. Clona el repositorio +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Compila en release +cargo build --release --locked + +# 3. Instala el binario +cargo install --path . --locked + +# 4. Inicializa el workspace +zeroclaw init + +# 5. Verifica la instalación +zeroclaw --version +zeroclaw status +``` + +</details> + +### Después de la instalación + +Una vez instalado (vía bootstrap o manualmente), deberías ver: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Configuración principal +├── .pairing # Secretos de emparejamiento (generado al primer inicio) +├── logs/ # Logs de daemon/agent +├── skills/ # Habilidades personalizadas +└── memory/ # Almacenamiento de contexto conversacional +``` + +**Siguientes pasos:** + +1. Configura tus proveedores de AI en `~/.zeroclaw/workspace/config.toml` +2. Revisa la [referencia de configuración](docs/config-reference.md) para opciones avanzadas +3. Inicia el agente: `zeroclaw agent start` +4. Prueba vía tu canal preferido (ver [referencia de canales](docs/channels-reference.md)) + +## Configuración + +Edita `~/.zeroclaw/workspace/config.toml` para configurar proveedores, canales y comportamiento del sistema. + +### Referencia de Configuración Rápida + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # o "sqlite" o "none" + +[runtime] +kind = "native" # o "docker" (requiere Docker) +``` + +**Documentos de referencia completos:** + +- [Referencia de Configuración](docs/config-reference.md) — todos los ajustes, validaciones, valores por defecto +- [Referencia de Proveedores](docs/providers-reference.md) — configuraciones específicas de proveedores de AI +- [Referencia de Canales](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord y más +- [Operaciones](docs/operations-runbook.md) — monitoreo en producción, rotación de secretos, escalado + +### Soporte de Runtime (actual) + +ZeroClaw soporta dos backends de ejecución de código: + +- **`native`** (por defecto) — ejecución de proceso directo, camino más rápido, ideal para entornos de confianza +- **`docker`** — aislamiento completo de contenedor, políticas de seguridad reforzadas, requiere Docker + +Usa `runtime.kind = "docker"` si necesitas sandboxing estricto o aislamiento de red. Ver [referencia de configuración](docs/config-reference.md#runtime) para detalles completos. + +## Comandos + +```bash +# Gestión de workspace +zeroclaw init # Inicializa un nuevo workspace +zeroclaw status # Muestra estado de daemon/agent +zeroclaw config validate # Verifica sintaxis y valores de config.toml + +# Gestión de daemon +zeroclaw daemon start # Inicia el daemon en segundo plano +zeroclaw daemon stop # Detiene el daemon en ejecución +zeroclaw daemon restart # Reinicia el daemon (recarga de config) +zeroclaw daemon logs # Muestra logs del daemon + +# Gestión de agent +zeroclaw agent start # Inicia el agent (requiere daemon ejecutándose) +zeroclaw agent stop # Detiene el agent +zeroclaw agent restart # Reinicia el agent (recarga de config) + +# Operaciones de emparejamiento +zeroclaw pairing init # Genera un nuevo secreto de emparejamiento +zeroclaw pairing rotate # Rota el secreto de emparejamiento existente + +# Tunneling (para exposición pública) +zeroclaw tunnel start # Inicia un tunnel hacia el daemon local +zeroclaw tunnel stop # Detiene el tunnel activo + +# Diagnóstico +zeroclaw doctor # Ejecuta verificaciones de salud del sistema +zeroclaw version # Muestra versión e información de build +``` + +Ver [Referencia de Comandos](docs/commands-reference.md) para opciones y ejemplos completos. + +## Arquitectura + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Canales (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Orquestador Agent │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Ruteo │ │ Contexto │ │ Ejecución │ │ +│ │ Mensaje │ │ Memoria │ │ Herramienta│ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Proveedores │ │ Memoria │ │ Herramientas │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Principios clave:** + +- Todo es un **trait** — proveedores, canales, herramientas, memoria, túneles +- Los canales llaman al orquestador; el orquestador llama a proveedores + herramientas +- El sistema de memoria gestiona contexto conversacional (markdown, SQLite, o ninguno) +- El runtime abstrae la ejecución de código (nativo o Docker) +- Sin lock-in de proveedor — intercambia Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama sin cambios de código + +Ver [documentación de arquitectura](docs/architecture.svg) para diagramas detallados y detalles de implementación. + +## Ejemplos + +### Bot de Telegram + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Tu ID de usuario de Telegram +``` + +Inicia el daemon + agent, luego envía un mensaje a tu bot en Telegram: + +``` +/start +¡Hola! ¿Podrías ayudarme a escribir un script Python? +``` + +El bot responde con código generado por AI, ejecuta herramientas si se solicita, y mantiene el contexto de conversación. + +### Matrix (cifrado extremo a extremo) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Invita a `@zeroclaw:matrix.org` a una sala cifrada, y el bot responderá con cifrado completo. Ver [Guía Matrix E2EE](docs/matrix-e2ee-guide.md) para configuración de verificación de dispositivo. + +### Multi-Proveedor + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover en error de proveedor +``` + +Si Anthropic falla o tiene rate-limit, el orquestador hace failover automáticamente a OpenAI. + +### Memoria Personalizada + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Purga automática después de 90 días +``` + +O usa Markdown para almacenamiento legible por humanos: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Ver [Referencia de Configuración](docs/config-reference.md#memory) para todas las opciones de memoria. + +## Soporte de Proveedor + +| Proveedor | Estado | API Key | Modelos de Ejemplo | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Estable | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Estable | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Estable | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Estable | N/A (local) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Estable | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Estable | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Planificado | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Planificado | `COHERE_API_KEY` | TBD | + +### Endpoints Personalizados + +ZeroClaw soporta endpoints compatibles con OpenAI: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Ejemplo: usa [LiteLLM](https://github.com/BerriAI/litellm) como proxy para acceder a cualquier LLM vía interfaz OpenAI. + +Ver [Referencia de Proveedores](docs/providers-reference.md) para detalles de configuración completos. + +## Soporte de Canal + +| Canal | Estado | Autenticación | Notas | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Estable | Bot Token | Soporte completo incluyendo archivos, imágenes, botones inline | +| **Matrix** | ✅ Estable | Contraseña o Token | Soporte E2EE con verificación de dispositivo | +| **Slack** | 🚧 Planificado | OAuth o Bot Token | Requiere acceso a workspace | +| **Discord** | 🚧 Planificado | Bot Token | Requiere permisos de guild | +| **WhatsApp** | 🚧 Planificado | Twilio o API oficial | Requiere cuenta business | +| **CLI** | ✅ Estable | Ninguno | Interfaz conversacional directa | +| **Web** | 🚧 Planificado | API Key o OAuth | Interfaz de chat basada en navegador | + +Ver [Referencia de Canales](docs/channels-reference.md) para instrucciones de configuración completas. + +## Soporte de Herramientas + +ZeroClaw proporciona herramientas integradas para ejecución de código, acceso al sistema de archivos y recuperación web: + +| Herramienta | Descripción | Runtime Requerido | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Ejecuta comandos shell | Nativo o Docker | +| **python** | Ejecuta scripts Python | Python 3.8+ (nativo) o Docker | +| **javascript** | Ejecuta código Node.js | Node.js 18+ (nativo) o Docker | +| **filesystem_read** | Lee archivos | Nativo o Docker | +| **filesystem_write** | Escribe archivos | Nativo o Docker | +| **web_fetch** | Obtiene contenido web | Nativo o Docker | + +### Seguridad de Ejecución + +- **Runtime Nativo** — se ejecuta como proceso de usuario del daemon, acceso completo al sistema de archivos +- **Runtime Docker** — aislamiento completo de contenedor, sistemas de archivos y redes separados + +Configura la política de ejecución en `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Lista permitida explícita +``` + +Ver [Referencia de Configuración](docs/config-reference.md#runtime) para opciones de seguridad completas. + +## Despliegue + +### Despliegue Local (Desarrollo) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Despliegue en Servidor (Producción) + +Usa systemd para gestionar el daemon y agent como servicios: + +```bash +# Instala el binario +cargo install --path . --locked + +# Configura el workspace +zeroclaw init + +# Crea archivos de servicio systemd +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Habilita e inicia los servicios +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Verifica el estado +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Ver [Guía de Despliegue de Red](docs/network-deployment.md) para instrucciones completas de despliegue en producción. + +### Docker + +```bash +# Compila la imagen +docker build -t zeroclaw:latest . + +# Ejecuta el contenedor +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Ver [`Dockerfile`](Dockerfile) para detalles de build y opciones de configuración. + +### Hardware Edge + +ZeroClaw está diseñado para ejecutarse en hardware de bajo consumo: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, núcleo ARMv8 único, < $5 costo de hardware +- **Raspberry Pi 4/5** — 1 GB+ RAM, multi-núcleo, ideal para workloads concurrentes +- **Orange Pi Zero 2** — ~512 MB RAM, quad-core ARMv8, costo ultra-bajo +- **SBCs x86 (Intel N100)** — 4-8 GB RAM, builds rápidos, soporte Docker nativo + +Ver [Guía de Hardware](docs/hardware/README.md) para instrucciones de configuración específicas por dispositivo. + +## Tunneling (Exposición Pública) + +Expón tu daemon ZeroClaw local a la red pública vía túneles seguros: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Proveedores de tunnel soportados: + +- **Cloudflare Tunnel** — HTTPS gratis, sin exposición de puertos, soporte multi-dominio +- **Ngrok** — configuración rápida, dominios personalizados (plan de pago) +- **Tailscale** — red mesh privada, sin puerto público + +Ver [Referencia de Configuración](docs/config-reference.md#tunnel) para opciones de configuración completas. + +## Seguridad + +ZeroClaw implementa múltiples capas de seguridad: + +### Emparejamiento + +El daemon genera un secreto de emparejamiento al primer inicio almacenado en `~/.zeroclaw/workspace/.pairing`. Los clientes (agent, CLI) deben presentar este secreto para conectarse. + +```bash +zeroclaw pairing rotate # Genera un nuevo secreto e invalida el anterior +``` + +### Sandboxing + +- **Runtime Docker** — aislamiento completo de contenedor con sistemas de archivos y redes separados +- **Runtime Nativo** — se ejecuta como proceso de usuario, con alcance de workspace por defecto + +### Listas Permitidas + +Los canales pueden restringir acceso por ID de usuario: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Lista permitida explícita +``` + +### Cifrado + +- **Matrix E2EE** — cifrado extremo a extremo completo con verificación de dispositivo +- **Transporte TLS** — todo el tráfico de API y tunnel usa HTTPS/TLS + +Ver [Documentación de Seguridad](docs/security/README.md) para políticas y prácticas completas. + +## Observabilidad + +ZeroClaw registra logs en `~/.zeroclaw/workspace/logs/` por defecto. Los logs se almacenan por componente: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Logs del daemon (inicio, solicitudes API, errores) +├── agent.log # Logs del agent (ruteo de mensajes, ejecución de herramientas) +├── telegram.log # Logs específicos del canal (si está habilitado) +└── matrix.log # Logs específicos del canal (si está habilitado) +``` + +### Configuración de Logging + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # Para rotación basada en tamaño +retention_days = 30 # Purga automática después de N días +``` + +Ver [Referencia de Configuración](docs/config-reference.md#logging) para todas las opciones de logging. + +### Métricas (Planificado) + +Soporte de métricas Prometheus para monitoreo en producción próximamente. Seguimiento en [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Habilidades (Skills) + +ZeroClaw soporta habilidades personalizadas — módulos reutilizables que extienden las capacidades del sistema. + +### Definición de Habilidad + +Las habilidades se almacenan en `~/.zeroclaw/workspace/skills/<skill-name>/` con esta estructura: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Metadatos de habilidad (nombre, descripción, dependencias) + ├── prompt.md # Prompt de sistema para la AI + └── tools/ # Herramientas personalizadas opcionales + └── my_tool.py +``` + +### Ejemplo de Habilidad + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Busca en la web y resume resultados" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Eres un asistente de investigación. Cuando te pidan buscar algo: + +1. Usa web_fetch para obtener el contenido +2. Resume los resultados en un formato fácil de leer +3. Cita las fuentes con URLs +``` + +### Uso de Habilidades + +Las habilidades se cargan automáticamente al inicio del agent. Referéncialas por nombre en conversaciones: + +``` +Usuario: Usa la habilidad web-research para encontrar las últimas noticias de AI +Bot: [carga la habilidad web-research, ejecuta web_fetch, resume resultados] +``` + +Ver sección [Habilidades (Skills)](#habilidades-skills) para instrucciones completas de creación de habilidades. + +## Open Skills + +ZeroClaw soporta [Open Skills](https://github.com/openagents-com/open-skills) — un sistema modular y agnóstico de proveedores para extender capacidades de agentes AI. + +### Habilitar Open Skills + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # opcional +``` + +También puedes sobrescribir en runtime con `ZEROCLAW_OPEN_SKILLS_ENABLED` y `ZEROCLAW_OPEN_SKILLS_DIR`. + +## Desarrollo + +```bash +cargo build # Build de desarrollo +cargo build --release # Build release (codegen-units=1, funciona en todos los dispositivos incluyendo Raspberry Pi) +cargo build --profile release-fast # Build más rápido (codegen-units=8, requiere 16 GB+ RAM) +cargo test # Ejecuta el suite de pruebas completo +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Formato + +# Ejecuta el benchmark de comparación SQLite vs Markdown +cargo test --test memory_comparison -- --nocapture +``` + +### Hook pre-push + +Un hook de git ejecuta `cargo fmt --check`, `cargo clippy -- -D warnings`, y `cargo test` antes de cada push. Actívalo una vez: + +```bash +git config core.hooksPath .githooks +``` + +### Solución de Problemas de Build (errores OpenSSL en Linux) + +Si encuentras un error de build `openssl-sys`, sincroniza dependencias y recompila con el lockfile del repositorio: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw está configurado para usar `rustls` para dependencias HTTP/TLS; `--locked` mantiene el grafo transitivo determinista en entornos limpios. + +Para saltar el hook cuando necesites un push rápido durante desarrollo: + +```bash +git push --no-verify +``` + +## Colaboración y Docs + +Comienza con el hub de documentación para un mapa basado en tareas: + +- Hub de Documentación: [`docs/README.md`](docs/README.md) +- Tabla de Contenidos Unificada de Docs: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Referencia de Comandos: [`docs/commands-reference.md`](docs/commands-reference.md) +- Referencia de Configuración: [`docs/config-reference.md`](docs/config-reference.md) +- Referencia de Proveedores: [`docs/providers-reference.md`](docs/providers-reference.md) +- Referencia de Canales: [`docs/channels-reference.md`](docs/channels-reference.md) +- Runbook de Operaciones: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Solución de Problemas: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Inventario/Clasificación de Docs: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- Snapshot de Triage de PR/Issue (al 18 de feb. de 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Referencias principales de colaboración: + +- Hub de Documentación: [docs/README.md](docs/README.md) +- Plantilla de Documentación: [docs/doc-template.md](docs/doc-template.md) +- Checklist de Cambio de Documentación: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Referencia de Configuración de Canales: [docs/channels-reference.md](docs/channels-reference.md) +- Operaciones de Salas Cifradas Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Guía de Contribución: [CONTRIBUTING.md](CONTRIBUTING.md) +- Política de Flujo de Trabajo PR: [docs/pr-workflow.md](docs/pr-workflow.md) +- Playbook del Revisor (triage + revisión profunda): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Mapa de Propiedad y Triage CI: [docs/ci-map.md](docs/ci-map.md) +- Política de Divulgación de Seguridad: [SECURITY.md](SECURITY.md) + +Para despliegue y operaciones de runtime: + +- Guía de Despliegue de Red: [docs/network-deployment.md](docs/network-deployment.md) +- Playbook de Agent Proxy: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## Apoyar a ZeroClaw + +Si ZeroClaw ayuda a tu trabajo y deseas apoyar el desarrollo continuo, puedes donar aquí: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Cómprame un Café" /></a> + +### 🙏 Agradecimientos Especiales + +Un sincero agradecimiento a las comunidades e instituciones que inspiran y alimentan este trabajo de código abierto: + +- **Harvard University** — por fomentar la curiosidad intelectual y empujar los límites de lo posible. +- **MIT** — por defender el conocimiento abierto, el código abierto, y la convicción de que la tecnología debería ser accesible para todos. +- **Sundai Club** — por la comunidad, la energía, y la voluntad incesante de construir cosas que importan. +- **El Mundo y Más Allá** 🌍✨ — a cada contribuyente, soñador, y constructor allá afuera que hace del código abierto una fuerza para el bien. Esto es por ti. + +Construimos en código abierto porque las mejores ideas vienen de todas partes. Si estás leyendo esto, eres parte de esto. Bienvenido. 🦀❤️ + +## ⚠️ Repositorio Oficial y Advertencia de Suplantación + +**Este es el único repositorio oficial de ZeroClaw:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Cualquier otro repositorio, organización, dominio o paquete que afirme ser "ZeroClaw" o que implique afiliación con ZeroClaw Labs es **no autorizado y no está afiliado con este proyecto**. Los forks no autorizados conocidos serán listados en [TRADEMARK.md](TRADEMARK.md). + +Si encuentras suplantación o uso indebido de marca, por favor [abre un issue](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Licencia + +ZeroClaw tiene doble licencia para máxima apertura y protección de contribuyentes: + +| Licencia | Casos de Uso | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Código abierto, investigación, académico, uso personal | +| [Apache 2.0](LICENSE-APACHE) | Protección de patentes, institucional, despliegue comercial | + +Puedes elegir cualquiera de las dos licencias. **Los contribuyentes otorgan automáticamente derechos bajo ambas** — ver [CLA.md](CLA.md) para el acuerdo de contribuyente completo. + +### Marca + +El nombre **ZeroClaw** y el logo son marcas registradas de ZeroClaw Labs. Esta licencia no otorga permiso para usarlos para implicar aprobación o afiliación. Ver [TRADEMARK.md](TRADEMARK.md) para usos permitidos y prohibidos. + +### Protecciones del Contribuyente + +- **Mantienes los derechos de autor** de tus contribuciones +- **Concesión de patentes** (Apache 2.0) te protege contra reclamos de patentes por otros contribuyentes +- Tus contribuciones son **atribuidas permanentemente** en el historial de commits y [NOTICE](NOTICE) +- No se transfieren derechos de marca al contribuir + +## Contribuir + +Ver [CONTRIBUTING.md](CONTRIBUTING.md) y [CLA.md](CLA.md). Implementa un trait, envía una PR: + +- Guía de flujo de trabajo CI: [docs/ci-map.md](docs/ci-map.md) +- Nuevo `Provider` → `src/providers/` +- Nuevo `Channel` → `src/channels/` +- Nuevo `Observer` → `src/observability/` +- Nuevo `Tool` → `src/tools/` +- Nueva `Memory` → `src/memory/` +- Nuevo `Tunnel` → `src/tunnel/` +- Nueva `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Cero sobrecarga. Cero compromiso. Despliega en cualquier lugar. Intercambia cualquier cosa. 🦀 + +## Historial de Estrellas + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Gráfico de Historial de Estrellas" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.fi.md b/README.fi.md new file mode 100644 index 000000000..38161a428 --- /dev/null +++ b/README.fi.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Noll overhead. Noll kompromissi. 100% Rust. 100% Agnostinen.</strong><br> + ⚡️ <strong>Ajaa $10 laitteistolla <5MB RAM:lla: Tämä on 99% vähemmän muistia kuin OpenClaw ja 98% halvempi kuin Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Kielet:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Mikä on ZeroClaw? + +ZeroClaw on kevyt, muokattava ja laajennettava AI-assistentti-infrastruktuuri, joka on rakennettu Rustilla. Se yhdistää eri LLM-palveluntarjoajat (Anthropic, OpenAI, Google, Ollama jne.) yhtenäisen käyttöliittymän kautta ja tukee useita kanavia (Telegram, Matrix, CLI jne.). + +### Keskeiset Ominaisuudet + +- **🦀 Kirjoitettu Rustilla**: Korkea suorituskyky, muistiturvallisuus ja nollakustannus-abstraktiot +- **🔌 Palveluntarjoaja-agnostinen**: Tukee OpenAI, Anthropic, Google Gemini, Ollama ja muita +- **📱 Monikanavainen**: Telegram, Matrix (E2EE:llä), CLI ja muut +- **🧠 Pluggaava muisti**: SQLite ja Markdown-backendit +- **🛠️ Laajennettavat työkalut**: Lisää mukautettuja työkaluja helposti +- **🔒 Turvallisuus edellä**: Käänteinen proxy, yksityisyys-edellä-suunnittelu + +--- + +## Pika-aloitus + +### Vaatimukset + +- Rust 1.70+ +- LLM-palveluntarjoajan API-avain (Anthropic, OpenAI jne.) + +### Asennus + +```bash +# Kloonaa repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Rakenna +cargo build --release + +# Aja +cargo run --release +``` + +### Dockerilla + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Konfiguraatio + +ZeroClaw käyttää YAML-konfiguraatiotiedostoa. Oletuksena se etsii `config.yaml`. + +```yaml +# Oletuspalveluntarjoaja +provider: anthropic + +# Palveluntarjoajien konfiguraatio +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Muistin konfiguraatio +memory: + backend: sqlite + path: data/memory.db + +# Kanavien konfiguraatio +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Dokumentaatio + +Yksityiskohtaista dokumentaatiota varten katso: + +- [Dokumentaatiokeskus](docs/README.md) +- [Komentojen Viite](docs/commands-reference.md) +- [Palveluntarjoajien Viite](docs/providers-reference.md) +- [Kanavien Viite](docs/channels-reference.md) +- [Konfiguraation Viite](docs/config-reference.md) + +--- + +## Osallistuminen + +Osallistumiset ovat tervetulleita! Lue [Osallistumisopas](CONTRIBUTING.md). + +--- + +## Lisenssi + +Tämä projekti on kaksoislisensoitu: + +- MIT License +- Apache License, versio 2.0 + +Katso [LICENSE-APACHE](LICENSE-APACHE) ja [LICENSE-MIT](LICENSE-MIT) yksityiskohdille. + +--- + +## Yhteisö + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Sponsorit + +Jos ZeroClaw on hyödyllinen sinulle, harkitse kahvin ostamista meille: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.he.md b/README.he.md new file mode 100644 index 000000000..520db146c --- /dev/null +++ b/README.he.md @@ -0,0 +1,197 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center" dir="rtl"> + <strong>תקורת אפס. אין פשרות. 100% Rust. 100% אגנוסטי.</strong><br> + ⚡️ <strong>פועל על חומרה ב-$10 עם <5MB זיכרון: זה 99% פחות זיכרון מ-OpenClaw ו-98% זול יותר מ-Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center" dir="rtl"> + 🌐 <strong>שפות:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## מה זה ZeroClaw? + +<p align="center" dir="rtl"> +ZeroClaw הוא תשתית עוזר AI קלת משקל, מוטטבילית וניתנת להרחבה שנבנתה ב-Rust. היא מחברת ספקי LLM שונים (Anthropic, OpenAI, Google, Ollama, וכו') דרך ממשק מאוחד ותומכת בערוצים מרובים (Telegram, Matrix, CLI, וכו'). +</p> + +### תכונות עיקריות + +<p align="center" dir="rtl"> +- **🦀 נכתב ב-Rust**: ביצועים גבוהים, אבטחת זיכרון, ואבסטרקציות ללא עלות +- **🔌 אגנוסטי לספקים**: תמיכה ב-OpenAI, Anthropic, Google Gemini, Ollama, ואחרים +- **📱 ערוצים מרובים**: Telegram, Matrix (עם E2EE), CLI, ואחרים +- **🧠 זיכרון ניתן להחלפה**: Backend של SQLite ו-Markdown +- **🛠️ כלים ניתנים להרחבה**: הוסף כלים מותאמים אישית בקלות +- **🔒 אבטחה תחילה**: פרוקסי הפוך, עיצוב מותחל על פרטיות +</p> + +--- + +## התחלה מהירה + +### דרישות מוקדמות + +<p align="center" dir="rtl"> +- Rust 1.70+ +- מפתח API של ספק LLM (Anthropic, OpenAI, וכו') +</p> + +### התקנה + +```bash +# שכפל את המאגר +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# בנה +cargo build --release + +# הפעל +cargo run --release +``` + +### עם Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## קונפיגורציה + +<p align="center" dir="rtl"> +ZeroClaw משתמש בקובץ קונפיגורציה YAML. כברירת מחדל, הוא מחפש `config.yaml`. +</p> + +```yaml +# ספק ברירת מחדל +provider: anthropic + +# קונפיגורציית ספקים +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# קונפיגורציית זיכרון +memory: + backend: sqlite + path: data/memory.db + +# קונפיגורציית ערוצים +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## תיעוד + +<p align="center" dir="rtl"> +לתיעוד מפורט, ראה: +</p> + +- [מרכז התיעוד](docs/README.md) +- [הפניה לפקודות](docs/commands-reference.md) +- [הפניה לספקים](docs/providers-reference.md) +- [הפניה לערוצים](docs/channels-reference.md) +- [הפניה לקונפיגורציה](docs/config-reference.md) + +--- + +## תרומות + +<p align="center" dir="rtl"> +תרומות מוזמנות! אנא קרא את [מדריך התרומות](CONTRIBUTING.md). +</p> + +--- + +## רישיון + +<p align="center" dir="rtl"> +פרויקט זה מורשה ברישיון כפול: +</p> + +- MIT License +- Apache License, גרסה 2.0 + +<p align="center" dir="rtl"> +ראה [LICENSE-APACHE](LICENSE-APACHE) ו-[LICENSE-MIT](LICENSE-MIT) לפרטים. +</p> + +--- + +## קהילה + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## נותני חסות + +<p align="center" dir="rtl"> +אם ZeroClaw שימושי עבורך, אנא שקול לקנות לנו קפה: +</p> + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.hi.md b/README.hi.md new file mode 100644 index 000000000..2a7a2b629 --- /dev/null +++ b/README.hi.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>शून्य ओवरहेड। शून्य समझौता। 100% रस्ट। 100% अज्ञेयवादी।</strong><br> + ⚡️ <strong>$10 हार्डवेयर पर <5MB RAM के साथ चलता है: यह OpenClaw से 99% कम मेमोरी और Mac mini से 98% सस्ता है!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>भाषाएँ:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## ZeroClaw क्या है? + +ZeroClaw एक हल्का, म्यूटेबल और एक्स्टेंसिबल AI असिस्टेंट इन्फ्रास्ट्रक्चर है जो रस्ट में बनाया गया है। यह विभिन्न LLM प्रदाताओं (Anthropic, OpenAI, Google, Ollama, आदि) को एक एकीकृत इंटरफेस के माध्यम से कनेक्ट करता है और कई चैनलों (Telegram, Matrix, CLI, आदि) का समर्थन करता है। + +### मुख्य विशेषताएं + +- **🦀 रस्ट में लिखा गया**: उच्च प्रदर्शन, मेमोरी सुरक्षा, और शून्य-लागत एब्सट्रैक्शन +- **🔌 प्रदाता-अज्ञेयवादी**: OpenAI, Anthropic, Google Gemini, Ollama, और अन्य का समर्थन +- **📱 बहु-चैनल**: Telegram, Matrix (E2EE के साथ), CLI, और अन्य +- **🧠 प्लगेबल मेमोरी**: SQLite और Markdown बैकएंड +- **🛠️ विस्तार योग्य टूल**: आसानी से कस्टम टूल जोड़ें +- **🔒 सुरक्षा-पहले**: रिवर्स-प्रॉक्सी, गोपनीयता-पहले डिज़ाइन + +--- + +## त्वरित शुरुआत + +### आवश्यकताएं + +- रस्ट 1.70+ +- एक LLM प्रदाता API कुंजी (Anthropic, OpenAI, आदि) + +### इंस्टॉलेशन + +```bash +# रिपॉजिटरी क्लोन करें +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# बिल्ड करें +cargo build --release + +# चलाएं +cargo run --release +``` + +### Docker के साथ + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## कॉन्फ़िगरेशन + +ZeroClaw एक YAML कॉन्फ़िगरेशन फ़ाइल का उपयोग करता है। डिफ़ॉल्ट रूप से, यह `config.yaml` देखता है। + +```yaml +# डिफ़ॉल्ट प्रदाता +provider: anthropic + +# प्रदाता कॉन्फ़िगरेशन +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# मेमोरी कॉन्फ़िगरेशन +memory: + backend: sqlite + path: data/memory.db + +# चैनल कॉन्फ़िगरेशन +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## दस्तावेज़ीकरण + +विस्तृत दस्तावेज़ीकरण के लिए, देखें: + +- [दस्तावेज़ीकरण हब](docs/README.md) +- [कमांड संदर्भ](docs/commands-reference.md) +- [प्रदाता संदर्भ](docs/providers-reference.md) +- [चैनल संदर्भ](docs/channels-reference.md) +- [कॉन्फ़िगरेशन संदर्भ](docs/config-reference.md) + +--- + +## योगदान + +योगदान का स्वागत है! कृपया [योगदान गाइड](CONTRIBUTING.md) पढ़ें। + +--- + +## लाइसेंस + +यह प्रोजेक्ट दोहरे लाइसेंस प्राप्त है: + +- MIT लाइसेंस +- Apache लाइसेंस, संस्करण 2.0 + +विवरण के लिए [LICENSE-APACHE](LICENSE-APACHE) और [LICENSE-MIT](LICENSE-MIT) देखें। + +--- + +## समुदाय + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## प्रायोजक + +यदि ZeroClaw आपके लिए उपयोगी है, तो कृपया हमें एक कॉफी खरीदने पर विचार करें: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.hu.md b/README.hu.md new file mode 100644 index 000000000..31d0e7349 --- /dev/null +++ b/README.hu.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Nulla többletköltség. Nulla kompromisszum. 100% Rust. 100% Agnosztikus.</strong><br> + ⚡️ <strong>$10-es hardveren fut <5MB RAM-mal: Ez 99%-kal kevesebb memória, mint az OpenClaw és 98%-kal olcsóbb, mint egy Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Nyelvek:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Mi az a ZeroClaw? + +A ZeroClaw egy könnyűsúlyú, változtatható és bővíthető AI asszisztens infrastruktúra, amely Rust nyelven készült. Különböző LLM szolgáltatókat (Anthropic, OpenAI, Google, Ollama stb.) köt össze egy egységes felületen keresztül, és több csatornát támogat (Telegram, Matrix, CLI stb.). + +### Fő jellemzők + +- **🦀 Rust nyelven írva**: Magas teljesítmény, memória biztonság és null költségű absztrakciók +- **🔌 Szolgáltató-agnosztikus**: OpenAI, Anthropic, Google Gemini, Ollama és mások támogatása +- **📱 Többcsatornás**: Telegram, Matrix (E2EE-vel), CLI és mások +- **🧠 Cserélhető memória**: SQLite és Markdown backendek +- **🛠️ Bővíthető eszközök**: Egyszerűen adjon hozzá egyedi eszközöket +- **🔒 Biztonság először**: Fordított proxy, adatvédelem-elsődleges tervezés + +--- + +## Gyors Kezdés + +### Követelmények + +- Rust 1.70+ +- Egy LLM szolgáltató API kulcs (Anthropic, OpenAI stb.) + +### Telepítés + +```bash +# Klónozza a repositoryt +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Építés +cargo build --release + +# Futtatás +cargo run --release +``` + +### Docker-rel + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Konfiguráció + +A ZeroClaw egy YAML konfigurációs fájlt használ. Alapértelmezés szerint a `config.yaml` fájlt keresi. + +```yaml +# Alapértelmezett szolgáltató +provider: anthropic + +# Szolgáltató konfiguráció +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Memória konfiguráció +memory: + backend: sqlite + path: data/memory.db + +# Csatorna konfiguráció +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Dokumentáció + +Részletes dokumentációért lásd: + +- [Dokumentációs Központ](docs/README.md) +- [Parancs Referencia](docs/commands-reference.md) +- [Szolgáltató Referencia](docs/providers-reference.md) +- [Csatorna Referencia](docs/channels-reference.md) +- [Konfigurációs Referencia](docs/config-reference.md) + +--- + +## Hozzájárulás + +A hozzájárulások várják! Kérjük, olvassa el a [Hozzájárulási Útmutatót](CONTRIBUTING.md). + +--- + +## Licenc + +Ez a projekt kettős licencelt: + +- MIT License +- Apache License, 2.0 verzió + +Részletekért lásd a [LICENSE-APACHE](LICENSE-APACHE) és [LICENSE-MIT](LICENSE-MIT) fájlokat. + +--- + +## Közösség + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Szponzorok + +Ha a ZeroClaw hasznos az Ön számára, kérjük, fontolja meg, hogy vesz nekünk egy kávét: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.id.md b/README.id.md new file mode 100644 index 000000000..d985b72d1 --- /dev/null +++ b/README.id.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Nol overhead. Nol kompromi. 100% Rust. 100% Agnostik.</strong><br> + ⚡️ <strong>Jalan di perangkat $10 dengan <5MB RAM: Itu 99% lebih sedikit memori dari OpenClaw dan 98% lebih murah dari Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Bahasa:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Apa itu ZeroClaw? + +ZeroClaw adalah infrastruktur asisten AI yang ringan, dapat diubah, dan dapat diperluas yang dibangun dengan Rust. Ini menghubungkan berbagai penyedia LLM (Anthropic, OpenAI, Google, Ollama, dll.) melalui antarmuka terpadu dan mendukung banyak saluran (Telegram, Matrix, CLI, dll.). + +### Fitur Utama + +- **🦀 Ditulis dalam Rust**: Kinerja tinggi, keamanan memori, dan abstraksi tanpa biaya +- **🔌 Agnostik penyedia**: Mendukung OpenAI, Anthropic, Google Gemini, Ollama, dan lainnya +- **📱 Multi-saluran**: Telegram, Matrix (dengan E2EE), CLI, dan lainnya +- **🧠 Memori yang dapat dipasang**: Backend SQLite dan Markdown +- **🛠️ Alat yang dapat diperluas**: Tambahkan alat kustom dengan mudah +- **🔒 Keamanan pertama**: Proxy terbalik, desain yang mengutamakan privasi + +--- + +## Mulai Cepat + +### Persyaratan + +- Rust 1.70+ +- Kunci API penyedia LLM (Anthropic, OpenAI, dll.) + +### Instalasi + +```bash +# Klon repositori +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Bangun +cargo build --release + +# Jalankan +cargo run --release +``` + +### Dengan Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Konfigurasi + +ZeroClaw menggunakan file konfigurasi YAML. Secara default, ini mencari `config.yaml`. + +```yaml +# Penyedia default +provider: anthropic + +# Konfigurasi penyedia +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Konfigurasi memori +memory: + backend: sqlite + path: data/memory.db + +# Konfigurasi saluran +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Dokumentasi + +Untuk dokumentasi terperinci, lihat: + +- [Hub Dokumentasi](docs/README.md) +- [Referensi Perintah](docs/commands-reference.md) +- [Referensi Penyedia](docs/providers-reference.md) +- [Referensi Saluran](docs/channels-reference.md) +- [Referensi Konfigurasi](docs/config-reference.md) + +--- + +## Berkontribusi + +Kontribusi diterima! Silakan baca [Panduan Kontribusi](CONTRIBUTING.md). + +--- + +## Lisensi + +Proyek ini dilisensikan ganda: + +- MIT License +- Apache License, versi 2.0 + +Lihat [LICENSE-APACHE](LICENSE-APACHE) dan [LICENSE-MIT](LICENSE-MIT) untuk detailnya. + +--- + +## Komunitas + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Sponsor + +Jika ZeroClaw berguna bagi Anda, mohon pertimbangkan untuk membelikan kami kopi: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.it.md b/README.it.md new file mode 100644 index 000000000..71e430097 --- /dev/null +++ b/README.it.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Zero overhead. Zero compromesso. 100% Rust. 100% Agnostico.</strong><br> + ⚡️ <strong>Gira su hardware da $10 con <5MB di RAM: È il 99% di memoria in meno di OpenClaw e il 98% più economico di un Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Costruito da studenti e membri delle comunità Harvard, MIT e Sundai.Club. +</p> + +<p align="center"> + 🌐 <strong>Lingue:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#avvio-rapido">Avvio Rapido</a> | + <a href="bootstrap.sh">Configurazione con Un Clic</a> | + <a href="docs/README.md">Hub Documentazione</a> | + <a href="docs/SUMMARY.md">Indice Documentazione</a> +</p> + +<p align="center"> + <strong>Accessi rapidi:</strong> + <a href="docs/reference/README.md">Riferimento</a> · + <a href="docs/operations/README.md">Operazioni</a> · + <a href="docs/troubleshooting.md">Risoluzione Problemi</a> · + <a href="docs/security/README.md">Sicurezza</a> · + <a href="docs/hardware/README.md">Hardware</a> · + <a href="docs/contributing/README.md">Contribuire</a> +</p> + +<p align="center"> + <strong>Infrastruttura assistente AI veloce, leggera e completamente autonoma</strong><br /> + Distribuisci ovunque. Scambia qualsiasi cosa. +</p> + +<p align="center"> + ZeroClaw è il <strong>sistema operativo runtime</strong> per i workflow degli agenti — un'infrastruttura che astrae modelli, strumenti, memoria ed esecuzione per costruire agenti una volta e eseguirli ovunque. +</p> + +<p align="center"><code>Architettura basata su trait · runtime sicuro di default · provider/canale/strumento intercambiabili · tutto è collegabile</code></p> + +### 📢 Annunci + +Usa questa tabella per avvisi importanti (cambiamenti di compatibilità, avvisi di sicurezza, finestre di manutenzione e blocchi di versione). + +| Data (UTC) | Livello | Avviso | Azione | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Critico_ | **Non siamo affiliati** con `openagen/zeroclaw` o `zeroclaw.org`. Il dominio `zeroclaw.org` punta attualmente al fork `openagen/zeroclaw`, e questo dominio/repository sta contraffacendo il nostro sito web/progetto ufficiale. | Non fidarti di informazioni, binari, raccolte fondi o annunci da queste fonti. Usa solo [questo repository](https://github.com/zeroclaw-labs/zeroclaw) e i nostri account social verificati. | +| 2026-02-21 | _Importante_ | Il nostro sito ufficiale è ora online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Grazie per la pazienza durante l'attesa. Rileviamo ancora tentativi di contraffazione: non partecipare ad alcuna attività di investimento/finanziamento a nome di ZeroClaw se non pubblicata tramite i nostri canali ufficiali. | Usa [questo repository](https://github.com/zeroclaw-labs/zeroclaw) come unica fonte di verità. Segui [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (gruppo)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), e [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) per aggiornamenti ufficiali. | +| 2026-02-19 | _Importante_ | Anthropic ha aggiornato i termini di utilizzo di autenticazione e credenziali il 2026-02-19. L'autenticazione OAuth (Free, Pro, Max) è esclusivamente per Claude Code e Claude.ai; l'uso di token OAuth di Claude Free/Pro/Max in qualsiasi altro prodotto, strumento o servizio (incluso Agent SDK) non è consentito e può violare i Termini di Utilizzo del Consumatore. | Si prega di evitare temporaneamente le integrazioni OAuth di Claude Code per prevenire qualsiasi potenziale perdita. Clausola originale: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Funzionalità + +- 🏎️ **Runtime Leggero di Default:** I workflow CLI comuni e i comandi di stato girano all'interno di uno spazio di memoria di pochi megabyte nelle build di produzione. +- 💰 **Distribuzione Economica:** Progettato per schede a basso costo e piccole istanze cloud senza dipendenze runtime pesanti. +- ⚡ **Avvii a Freddo Rapidi:** Il runtime Rust a binario singolo mantiene l'avvio di comandi e demoni quasi istantaneo per le operazioni quotidiane. +- 🌍 **Architettura Portabile:** Un workflow a binario singolo su ARM, x86 e RISC-V con provider/canale/strumento intercambiabili. + +### Perché i team scelgono ZeroClaw + +- **Leggero di default:** binario Rust piccolo, avvio rapido, basso impatto di memoria. +- **Sicuro per design:** pairing, sandboxing rigoroso, liste di autorizzazione esplicite, scope del workspace. +- **Completamente intercambiabile:** i sistemi centrali sono trait (provider, canali, strumenti, memoria, tunnel). +- **Nessun lock-in del provider:** supporto provider compatibile OpenAI + endpoint personalizzati collegabili. + +## Snapshot Benchmark (ZeroClaw vs OpenClaw, Riproducibile) + +Benchmark rapido su macchina locale (macOS arm64, feb. 2026) normalizzato per hardware edge a 0.8 GHz. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Linguaggio** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Avvio (core 0.8 GHz)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Dimensione Binario** | ~28 MB (dist) | N/A (Scripts) | ~8 MB | **3.4 MB** | +| **Costo** | Mac Mini $599 | Linux SBC ~$50 | Scheda Linux $10 | **Qualsiasi hardware $10** | + +> Note: I risultati di ZeroClaw sono misurati su build di produzione usando `/usr/bin/time -l`. OpenClaw richiede il runtime Node.js (tipicamente ~390 MB di overhead memoria aggiuntivo), mentre NanoBot richiede il runtime Python. PicoClaw e ZeroClaw sono binari statici. Le cifre RAM sopra sono memoria runtime; i requisiti di compilazione in build-time sono maggiori. + +<p align="center"> + <img src="zero-claw.jpeg" alt="Confronto ZeroClaw vs OpenClaw" width="800" /> +</p> + +### Misurazione Locale Riproducibile + +Le affermazioni di benchmark possono derivare man mano che il codice e le toolchain evolvono, quindi misura sempre la tua build attuale localmente: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Esempio di campione (macOS arm64, misurato il 18 febbraio 2026): + +- Dimensione binario release: `8.8M` +- `zeroclaw --help`: tempo reale circa `0.02s`, impatto memoria massimo ~`3.9 MB` +- `zeroclaw status`: tempo reale circa `0.01s`, impatto memoria massimo ~`4.1 MB` + +## Prerequisiti + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Richiesto + +1. **Visual Studio Build Tools** (fornisce il linker MSVC e il Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Durante l'installazione (o via Visual Studio Installer), seleziona il carico di lavoro **"Sviluppo desktop con C++"**. + +2. **Toolchain Rust:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Dopo l'installazione, apri un nuovo terminale ed esegui `rustup default stable` per assicurarti che la toolchain stabile sia attiva. + +3. **Verifica** che entrambi funzionano: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Opzionale + +- **Docker Desktop** — richiesto solo se usi il [runtime Docker sandboxed](#supporto-runtime-attuale) (`runtime.kind = "docker"`). Installa via `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Richiesto + +1. **Strumenti di build essenziali:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Installa Xcode Command Line Tools: `xcode-select --install` + +2. **Toolchain Rust:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Vedi [rustup.rs](https://rustup.rs) per dettagli. + +3. **Verifica:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Opzionale + +- **Docker** — richiesto solo se usi il [runtime Docker sandboxed](#supporto-runtime-attuale) (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** vedi [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** vedi [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** installa Docker Desktop via [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Avvio Rapido + +### Opzione 1: Configurazione automatizzata (consigliata) + +Lo script `bootstrap.sh` installa Rust, clona ZeroClaw, lo compila, e configura il tuo ambiente di sviluppo iniziale: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Questo: + +1. Installerà Rust (se non presente) +2. Clonerà il repository ZeroClaw +3. Compilerà ZeroClaw in modalità release +4. Installerà `zeroclaw` in `~/.cargo/bin/` +5. Creerà la struttura del workspace di default in `~/.zeroclaw/workspace/` +6. Genererà un file di configurazione iniziale `~/.zeroclaw/workspace/config.toml` + +Dopo il bootstrap, ricarica la tua shell o esegui `source ~/.cargo/env` per usare il comando `zeroclaw` globalmente. + +### Opzione 2: Installazione manuale + +<details> +<summary><strong>Clicca per vedere i passaggi di installazione manuale</strong></summary> + +```bash +# 1. Clona il repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Compila in release +cargo build --release --locked + +# 3. Installa il binario +cargo install --path . --locked + +# 4. Inizializza il workspace +zeroclaw init + +# 5. Verifica l'installazione +zeroclaw --version +zeroclaw status +``` + +</details> + +### Dopo l'installazione + +Una volta installato (via bootstrap o manualmente), dovresti vedere: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Configurazione principale +├── .pairing # Segreti di pairing (generati al primo avvio) +├── logs/ # Log di daemon/agent +├── skills/ # Competenze personalizzate +└── memory/ # Archiviazione contesto conversazionale +``` + +**Prossimi passi:** + +1. Configura i tuoi provider AI in `~/.zeroclaw/workspace/config.toml` +2. Controlla la [riferimento configurazione](docs/config-reference.md) per opzioni avanzate +3. Avvia l'agente: `zeroclaw agent start` +4. Testa tramite il tuo canale preferito (vedi [riferimento canali](docs/channels-reference.md)) + +## Configurazione + +Modifica `~/.zeroclaw/workspace/config.toml` per configurare provider, canali e comportamento del sistema. + +### Riferimento Configurazione Rapida + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # o "sqlite" o "none" + +[runtime] +kind = "native" # o "docker" (richiede Docker) +``` + +**Documenti di riferimento completi:** + +- [Riferimento Configurazione](docs/config-reference.md) — tutte le impostazioni, validazioni, valori di default +- [Riferimento Provider](docs/providers-reference.md) — configurazioni specifiche per provider AI +- [Riferimento Canali](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord e altro +- [Operazioni](docs/operations-runbook.md) — monitoraggio in produzione, rotazione segreti, scaling + +### Supporto Runtime (attuale) + +ZeroClaw supporta due backend di esecuzione del codice: + +- **`native`** (default) — esecuzione processo diretta, percorso più veloce, ideale per ambienti fidati +- **`docker`** — isolamento container completo, politiche di sicurezza potenziate, richiede Docker + +Usa `runtime.kind = "docker"` se hai bisogno di sandboxing rigoroso o isolamento rete. Vedi [riferimento configurazione](docs/config-reference.md#runtime) per dettagli completi. + +## Comandi + +```bash +# Gestione workspace +zeroclaw init # Inizializza un nuovo workspace +zeroclaw status # Mostra stato daemon/agent +zeroclaw config validate # Verifica sintassi e valori di config.toml + +# Gestione daemon +zeroclaw daemon start # Avvia il daemon in background +zeroclaw daemon stop # Ferma il daemon in esecuzione +zeroclaw daemon restart # Riavvia il daemon (ricaricamento config) +zeroclaw daemon logs # Mostra log del daemon + +# Gestione agent +zeroclaw agent start # Avvia l'agent (richiede daemon in esecuzione) +zeroclaw agent stop # Ferma l'agent +zeroclaw agent restart # Riavvia l'agent (ricaricamento config) + +# Operazioni di pairing +zeroclaw pairing init # Genera un nuovo segreto di pairing +zeroclaw pairing rotate # Ruota il segreto di pairing esistente + +# Tunneling (per esposizione pubblica) +zeroclaw tunnel start # Avvia un tunnel verso il daemon locale +zeroclaw tunnel stop # Ferma il tunnel attivo + +# Diagnostica +zeroclaw doctor # Esegue controlli di salute del sistema +zeroclaw version # Mostra versione e informazioni di build +``` + +Vedi [Riferimento Comandi](docs/commands-reference.md) per opzioni ed esempi completi. + +## Architettura + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Canali (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Agente Orchestratore │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Routing │ │ Contesto │ │ Esecuzione │ │ +│ │ Messaggio │ │ Memoria │ │ Strumento │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Provider │ │ Memoria │ │ Strumenti │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Principi chiave:** + +- Tutto è un **trait** — provider, canali, strumenti, memoria, tunnel +- I canali chiamano l'orchestratore; l'orchestratore chiama provider + strumenti +- Il sistema memoria gestisce il contesto conversazionale (markdown, SQLite, o nessuno) +- Il runtime astrae l'esecuzione del codice (nativo o Docker) +- Nessun lock-in del provider — scambia Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama senza modifiche al codice + +Vedi [documentazione architettura](docs/architecture.svg) per diagrammi dettagliati e dettagli di implementazione. + +## Esempi + +### Bot Telegram + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Il tuo ID utente Telegram +``` + +Avvia il daemon + agent, poi invia un messaggio al tuo bot su Telegram: + +``` +/start +Ciao! Potresti aiutarmi a scrivere uno script Python? +``` + +Il bot risponde con codice generato dall'AI, esegue strumenti se richiesto, e mantiene il contesto della conversazione. + +### Matrix (crittografia end-to-end) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Invita `@zeroclaw:matrix.org` in una stanza crittografata, e il bot risponderà con crittografia completa. Vedi [Guida Matrix E2EE](docs/matrix-e2ee-guide.md) per la configurazione della verifica dispositivo. + +### Multi-Provider + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover su errore del provider +``` + +Se Anthropic fallisce o va in rate-limit, l'orchestratore passa automaticamente a OpenAI. + +### Memoria Personalizzata + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Eliminazione automatica dopo 90 giorni +``` + +O usa Markdown per un archiviazione leggibile dall'uomo: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Vedi [Riferimento Configurazione](docs/config-reference.md#memory) per tutte le opzioni memoria. + +## Supporto Provider + +| Provider | Stato | API Key | Modelli di Esempio | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Stabile | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Stabile | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Stabile | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Stabile | N/A (locale) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Stabile | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Stabile | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Pianificato | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Pianificato | `COHERE_API_KEY` | TBD | + +### Endpoint Personalizzati + +ZeroClaw supporta endpoint compatibili con OpenAI: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Esempio: usa [LiteLLM](https://github.com/BerriAI/litellm) come proxy per accedere a qualsiasi LLM tramite l'interfaccia OpenAI. + +Vedi [Riferimento Provider](docs/providers-reference.md) per dettagli di configurazione completi. + +## Supporto Canali + +| Canale | Stato | Autenticazione | Note | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Stabile | Bot Token | Supporto completo inclusi file, immagini, pulsanti inline | +| **Matrix** | ✅ Stabile | Password o Token | Supporto E2EE con verifica dispositivo | +| **Slack** | 🚧 Pianificato | OAuth o Bot Token | Richiede accesso workspace | +| **Discord** | 🚧 Pianificato | Bot Token | Richiede permessi guild | +| **WhatsApp** | 🚧 Pianificato | Twilio o API ufficiale | Richiede account business | +| **CLI** | ✅ Stabile | Nessuno | Interfaccia conversazionale diretta | +| **Web** | 🚧 Pianificato | API Key o OAuth | Interfaccia chat basata su browser | + +Vedi [Riferimento Canali](docs/channels-reference.md) per istruzioni di configurazione complete. + +## Supporto Strumenti + +ZeroClaw fornisce strumenti integrati per l'esecuzione del codice, l'accesso al filesystem e il recupero web: + +| Strumento | Descrizione | Runtime Richiesto | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Esegue comandi shell | Nativo o Docker | +| **python** | Esegue script Python | Python 3.8+ (nativo) o Docker | +| **javascript** | Esegue codice Node.js | Node.js 18+ (nativo) o Docker | +| **filesystem_read** | Legge file | Nativo o Docker | +| **filesystem_write** | Scrive file | Nativo o Docker | +| **web_fetch** | Recupera contenuti web | Nativo o Docker | + +### Sicurezza dell'Esecuzione + +- **Runtime Nativo** — gira come processo utente del daemon, accesso completo al filesystem +- **Runtime Docker** — isolamento container completo, filesystem e reti separati + +Configura la politica di esecuzione in `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Lista di autorizzazione esplicita +``` + +Vedi [Riferimento Configurazione](docs/config-reference.md#runtime) per opzioni di sicurezza complete. + +## Distribuzione + +### Distribuzione Locale (Sviluppo) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Distribuzione Server (Produzione) + +Usa systemd per gestire daemon e agent come servizi: + +```bash +# Installa il binario +cargo install --path . --locked + +# Configura il workspace +zeroclaw init + +# Crea i file di servizio systemd +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Abilita e avvia i servizi +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Verifica lo stato +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Vedi [Guida Distribuzione di Rete](docs/network-deployment.md) per istruzioni complete di distribuzione in produzione. + +### Docker + +```bash +# Compila l'immagine +docker build -t zeroclaw:latest . + +# Esegui il container +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Vedi [`Dockerfile`](Dockerfile) per dettagli di build e opzioni di configurazione. + +### Hardware Edge + +ZeroClaw è progettato per girare su hardware a basso consumo: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, singolo core ARMv8, < $5 costo hardware +- **Raspberry Pi 4/5** — 1 GB+ RAM, multi-core, ideale per workload concorrenti +- **Orange Pi Zero 2** — ~512 MB RAM, quad-core ARMv8, costo ultra-basso +- **SBC x86 (Intel N100)** — 4-8 GB RAM, build veloci, supporto Docker nativo + +Vedi [Guida Hardware](docs/hardware/README.md) per istruzioni di configurazione specifiche per dispositivo. + +## Tunneling (Esposizione Pubblica) + +Espone il tuo daemon ZeroClaw locale alla rete pubblica tramite tunnel sicuri: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Provider di tunnel supportati: + +- **Cloudflare Tunnel** — HTTPS gratuito, nessuna esposizione di porte, supporto multi-dominio +- **Ngrok** — configurazione rapida, domini personalizzati (piano a pagamento) +- **Tailscale** — rete mesh privata, nessuna porta pubblica + +Vedi [Riferimento Configurazione](docs/config-reference.md#tunnel) per opzioni di configurazione complete. + +## Sicurezza + +ZeroClaw implementa molteplici livelli di sicurezza: + +### Pairing + +Il daemon genera un segreto di pairing al primo avvio memorizzato in `~/.zeroclaw/workspace/.pairing`. I client (agent, CLI) devono presentare questo segreto per connettersi. + +```bash +zeroclaw pairing rotate # Genera un nuovo segreto e invalida quello precedente +``` + +### Sandboxing + +- **Runtime Docker** — isolamento container completo con filesystem e reti separati +- **Runtime Nativo** — gira come processo utente, con scope del workspace di default + +### Liste di Autorizzazione + +I canali possono limitare l'accesso per ID utente: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Lista di autorizzazione esplicita +``` + +### Crittografia + +- **Matrix E2EE** — crittografia end-to-end completa con verifica dispositivo +- **Trasporto TLS** — tutto il traffico API e tunnel usa HTTPS/TLS + +Vedi [Documentazione Sicurezza](docs/security/README.md) per politiche e pratiche complete. + +## Osservabilità + +ZeroClaw registra i log in `~/.zeroclaw/workspace/logs/` di default. I log sono memorizzati per componente: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Log del daemon (avvio, richieste API, errori) +├── agent.log # Log dell'agent (routing messaggi, esecuzione strumenti) +├── telegram.log # Log specifici del canale (se abilitato) +└── matrix.log # Log specifici del canale (se abilitato) +``` + +### Configurazione Logging + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # Per rotazione basata sulla dimensione +retention_days = 30 # Eliminazione automatica dopo N giorni +``` + +Vedi [Riferimento Configurazione](docs/config-reference.md#logging) per tutte le opzioni di logging. + +### Metriche (Pianificato) + +Supporto metriche Prometheus per il monitoraggio in produzione in arrivo. Tracciamento in [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Competenze (Skills) + +ZeroClaw supporta competenze personalizzate — moduli riutilizzabili che estendono le capacità del sistema. + +### Definizione Competenza + +Le competenze sono memorizzate in `~/.zeroclaw/workspace/skills/<skill-name>/` con questa struttura: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Metadati competenza (nome, descrizione, dipendenze) + ├── prompt.md # Prompt di sistema per l'AI + └── tools/ # Strumenti personalizzati opzionali + └── my_tool.py +``` + +### Esempio Competenza + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Cerca sul web e riassume i risultati" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Sei un assistente di ricerca. Quando ti viene chiesto di cercare qualcosa: + +1. Usa web_fetch per recuperare il contenuto +2. Riassume i risultati in un formato facile da leggere +3. Cita le fonti con gli URL +``` + +### Uso delle Competenze + +Le competenze sono caricate automaticamente all'avvio dell'agent. Fai riferimento ad esse per nome nelle conversazioni: + +``` +Utente: Usa la competenza web-research per trovare le ultime notizie AI +Bot: [carica la competenza web-research, esegue web_fetch, riassume i risultati] +``` + +Vedi sezione [Competenze (Skills)](#competenze-skills) per istruzioni complete sulla creazione di competenze. + +## Open Skills + +ZeroClaw supporta [Open Skills](https://github.com/openagents-com/open-skills) — un sistema modulare e agnostico del provider per estendere le capacità degli agent AI. + +### Abilita Open Skills + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # opzionale +``` + +Puoi anche sovrascrivere a runtime con `ZEROCLAW_OPEN_SKILLS_ENABLED` e `ZEROCLAW_OPEN_SKILLS_DIR`. + +## Sviluppo + +```bash +cargo build # Build di sviluppo +cargo build --release # Build release (codegen-units=1, funziona su tutti i dispositivi incluso Raspberry Pi) +cargo build --profile release-fast # Build più veloce (codegen-units=8, richiede 16 GB+ RAM) +cargo test # Esegue la suite di test completa +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Formattazione + +# Esegue il benchmark di confronto SQLite vs Markdown +cargo test --test memory_comparison -- --nocapture +``` + +### Hook pre-push + +Un hook git esegue `cargo fmt --check`, `cargo clippy -- -D warnings`, e `cargo test` prima di ogni push. Attivalo una volta: + +```bash +git config core.hooksPath .githooks +``` + +### Risoluzione Problemi di Build (errori OpenSSL su Linux) + +Se incontri un errore di build `openssl-sys`, sincronizza le dipendenze e ricompila con il lockfile del repository: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw è configurato per usare `rustls` per le dipendenze HTTP/TLS; `--locked` mantiene il grafo transitivo deterministico in ambienti puliti. + +Per saltare l'hook quando hai bisogno di un push veloce durante lo sviluppo: + +```bash +git push --no-verify +``` + +## Collaborazione e Docs + +Inizia con l'hub della documentazione per una mappa basata sui task: + +- Hub Documentazione: [`docs/README.md`](docs/README.md) +- Indice Unificato Docs: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Riferimento Comandi: [`docs/commands-reference.md`](docs/commands-reference.md) +- Riferimento Configurazione: [`docs/config-reference.md`](docs/config-reference.md) +- Riferimento Provider: [`docs/providers-reference.md`](docs/providers-reference.md) +- Riferimento Canali: [`docs/channels-reference.md`](docs/channels-reference.md) +- Runbook Operazioni: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Risoluzione Problemi: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Inventario/Classificazione Docs: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- Snapshot Triage PR/Issue (al 18 feb. 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Riferimenti principali di collaborazione: + +- Hub Documentazione: [docs/README.md](docs/README.md) +- Modello Documentazione: [docs/doc-template.md](docs/doc-template.md) +- Checklist Cambio Documentazione: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Riferimento Configurazione Canali: [docs/channels-reference.md](docs/channels-reference.md) +- Operazioni Stanze Crittografate Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Guida Contribuzione: [CONTRIBUTING.md](CONTRIBUTING.md) +- Politica Workflow PR: [docs/pr-workflow.md](docs/pr-workflow.md) +- Playbook Revisore (triage + revisione profonda): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Mappa Proprietà e Triage CI: [docs/ci-map.md](docs/ci-map.md) +- Politica Divulgazione Sicurezza: [SECURITY.md](SECURITY.md) + +Per distribuzione e operazioni runtime: + +- Guida Distribuzione di Rete: [docs/network-deployment.md](docs/network-deployment.md) +- Playbook Agent Proxy: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## Supportare ZeroClaw + +Se ZeroClaw aiuta il tuo lavoro e desideri supportare lo sviluppo continuo, puoi donare qui: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Offrimi un Caffè" /></a> + +### 🙏 Ringraziamenti Speciali + +Un sincero ringraziamento alle comunità e istituzioni che ispirano e alimentano questo lavoro open-source: + +- **Harvard University** — per favorire la curiosità intellettuale e spingere i confini del possibile. +- **MIT** — per difendere la conoscenza aperta, l'open source, e la convinzione che la tecnologia dovrebbe essere accessibile a tutti. +- **Sundai Club** — per la comunità, l'energia, e la volontà incessante di costruire cose che contano. +- **Il Mondo e Oltre** 🌍✨ — a ogni contributore, sognatore, e costruttore là fuori che rende l'open source una forza per il bene. Questo è per te. + +Costruiamo in open source perché le migliori idee vengono da ovunque. Se stai leggendo questo, ne fai parte. Benvenuto. 🦀❤️ + +## ⚠️ Repository Ufficiale e Avviso di Contraffazione + +**Questo è l'unico repository ufficiale di ZeroClaw:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Qualsiasi altro repository, organizzazione, dominio o pacchetto che afferma di essere "ZeroClaw" o che implica affiliazione con ZeroClaw Labs è **non autorizzato e non affiliato a questo progetto**. I fork non autorizzati noti saranno elencati in [TRADEMARK.md](TRADEMARK.md). + +Se incontri contraffazione o uso improprio del marchio, per favore [apri una issue](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Licenza + +ZeroClaw è doppia licenza per massima apertura e protezione dei contributori: + +| Licenza | Casi d'Uso | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Open-source, ricerca, accademico, uso personale | +| [Apache 2.0](LICENSE-APACHE) | Protezione brevetti, istituzionale, distribuzione commerciale | + +Puoi scegliere una delle due licenze. **I contributori concedono automaticamente diritti sotto entrambe** — vedi [CLA.md](CLA.md) per l'accordo completo dei contributori. + +### Marchio + +Il nome **ZeroClaw** e il logo sono marchi registrati di ZeroClaw Labs. Questa licenza non concede il permesso di usarli per implicare approvazione o affiliazione. Vedi [TRADEMARK.md](TRADEMARK.md) per usi permessi e proibiti. + +### Protezioni dei Contributori + +- **Mantieni i diritti d'autore** dei tuoi contributi +- **Concessione brevetti** (Apache 2.0) ti protegge da reclami di brevetti da parte di altri contributori +- I tuoi contributi sono **attribuiti permanentemente** nella cronologia dei commit e [NOTICE](NOTICE) +- Nessun diritto di marchio viene trasferito contribuendo + +## Contribuire + +Vedi [CONTRIBUTING.md](CONTRIBUTING.md) e [CLA.md](CLA.md). Implementa un trait, invia una PR: + +- Guida workflow CI: [docs/ci-map.md](docs/ci-map.md) +- Nuovo `Provider` → `src/providers/` +- Nuovo `Channel` → `src/channels/` +- Nuovo `Observer` → `src/observability/` +- Nuovo `Tool` → `src/tools/` +- Nuova `Memory` → `src/memory/` +- Nuovo `Tunnel` → `src/tunnel/` +- Nuova `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Zero overhead. Zero compromesso. Distribuisci ovunque. Scambia qualsiasi cosa. 🦀 + +## Storico Stelle + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Grafico Storico Stelle" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.ko.md b/README.ko.md new file mode 100644 index 000000000..c12849e80 --- /dev/null +++ b/README.ko.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>오버헤드 없음. 타협 없음. 100% Rust. 100% 독립적.</strong><br> + ⚡️ <strong>$10 하드웨어에서 <5MB RAM으로 실행: OpenClaw보다 99% 적은 메모리, Mac mini보다 98% 저렴!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Harvard, MIT, 그리고 Sundai.Club 커뮤니티의 학생들과 멤버들이 만들었습니다. +</p> + +<p align="center"> + 🌐 <strong>언어:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#빠른-시작">빠른 시작</a> | + <a href="bootstrap.sh">원클릭 설정</a> | + <a href="docs/README.md">문서 허브</a> | + <a href="docs/SUMMARY.md">문서 목차</a> +</p> + +<p align="center"> + <strong>빠른 접근:</strong> + <a href="docs/reference/README.md">참조</a> · + <a href="docs/operations/README.md">운영</a> · + <a href="docs/troubleshooting.md">문제 해결</a> · + <a href="docs/security/README.md">보안</a> · + <a href="docs/hardware/README.md">하드웨어</a> · + <a href="docs/contributing/README.md">기여하기</a> +</p> + +<p align="center"> + <strong>빠르고 가벼우며 완전히 자율적인 AI 어시스턴트 인프라</strong><br /> + 어디서나 배포. 무엇이든 교체. +</p> + +<p align="center"> + ZeroClaw는 에이전트 워크플로우를 위한 <strong>런타임 운영체제</strong>입니다 — 모델, 도구, 메모리, 실행을 추상화하여 한 번 구축하고 어디서나 실행할 수 있는 인프라입니다. +</p> + +<p align="center"><code>트레이트 기반 아키텍처 · 기본 보안 런타임 · 교체 가능한 제공자/채널/도구 · 모든 것이 플러그 가능</code></p> + +### 📢 공지사항 + +이 표를 사용하여 중요한 공지사항(호환성 변경, 보안 공지, 유지보수 기간, 버전 차단)을 확인하세요. + +| 날짜 (UTC) | 수준 | 공지 | 조치 | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _중요_ | 우리는 `openagen/zeroclaw` 또는 `zeroclaw.org`와 **관련이 없습니다**. `zeroclaw.org` 도메인은 현재 `openagen/zeroclaw` 포크를 가리키고 있으며, 이 도메인/저장소는 우리의 공식 웹사이트/프로젝트를 사칭하고 있습니다. | 이 소스의 정보, 바이너리, 펀딩, 공지를 신뢰하지 마세요. [이 저장소](https://github.com/zeroclaw-labs/zeroclaw)와 우리의 확인된 소셜 계정만 사용하세요. | +| 2026-02-21 | _중요_ | 우리의 공식 웹사이트가 이제 온라인입니다: [zeroclawlabs.ai](https://zeroclawlabs.ai). 기다려주셔서 감사합니다. 여전히 사칭 시도가 감지되고 있습니다: 공식 채널을 통해 게시되지 않은 ZeroClaw 이름의 모든 투자/펀딩 활동에 참여하지 마세요. | [이 저장소](https://github.com/zeroclaw-labs/zeroclaw)를 유일한 진실의 원천으로 사용하세요. [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (그룹)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), 그리고 [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search)를 팔로우하여 공식 업데이트를 받으세요. | +| 2026-02-19 | _중요_ | Anthropic이 2026-02-19에 인증 및 자격증명 사용 약관을 업데이트했습니다. OAuth 인증(Free, Pro, Max)은 Claude Code 및 Claude.ai 전용입니다. 다른 제품, 도구 또는 서비스(Agent SDK 포함)에서 Claude Free/Pro/Max OAuth 토큰을 사용하는 것은 허용되지 않으며 소비자 이용약관을 위반할 수 있습니다. | 잠재적인 손실을 방지하기 위해 일시적으로 Claude Code OAuth 통합을 피하세요. 원본 조항: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ 기능 + +- 🏎️ **기본 경량 런타임:** 일반적인 CLI 워크플로우와 상태 명령이 프로덕션 빌드에서 몇 메가바이트의 메모리 공간 내에서 실행됩니다. +- 💰 **비용 효율적인 배포:** 무거운 런타임 의존성 없이 저비용 보드 및 소규모 클라우드 인스턴스를 위해 설계되었습니다. +- ⚡ **빠른 콜드 스타트:** 단일 Rust 바이너리 런타임이 일상적인 운영을 위해 거의 즉각적인 명령 및 데몬 시작을 유지합니다. +- 🌍 **이식 가능한 아키텍처:** 교체 가능한 제공자/채널/도구로 ARM, x86, RISC-V에서 단일 바이너리 워크플로우. + +### 왜 팀들이 ZeroClaw를 선택하나요 + +- **기본 경량:** 작은 Rust 바이너리, 빠른 시작, 낮은 메모리 공간. +- **기본 보안:** 페어링, 엄격한 샌드박싱, 명시적 허용 목록, 작업공간 범위. +- **완전히 교체 가능:** 핵심 시스템이 트레이트입니다(제공자, 채널, 도구, 메모리, 터널). +- **벤더 락인 없음:** OpenAI 호환 제공자 지원 + 플러그 가능한 사용자 정의 엔드포인트. + +## 벤치마크 스냅샷 (ZeroClaw vs OpenClaw, 재현 가능) + +로컬 머신에서 빠른 벤치마크(macOS arm64, 2026년 2월) 0.8 GHz 엣지 하드웨어로 정규화됨. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **언어** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **시작 (0.8 GHz 코어)** | > 500s | > 30s | < 1s | **< 10ms** | +| **바이너리 크기** | ~28 MB (dist) | N/A (Scripts) | ~8 MB | **3.4 MB** | +| **비용** | Mac Mini $599 | Linux SBC ~$50 | Linux 보드 $10 | **모든 하드웨어 $10** | + +> 참고: ZeroClaw 결과는 `/usr/bin/time -l`을 사용한 프로덕션 빌드에서 측정되었습니다. OpenClaw는 Node.js 런타임이 필요하며(일반적으로 ~390MB 추가 메모리 오버헤드), NanoBot은 Python 런타임이 필요합니다. PicoClaw와 ZeroClaw는 정적 바이너리입니다. 위 RAM 수치는 런타임 메모리이며, 빌드 시간 컴파일 요구사항은 더 높습니다. + +<p align="center"> + <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw 비교" width="800" /> +</p> + +### 재현 가능한 로컬 측정 + +벤치마크 주장은 코드와 툴체인의 발전에 따라 달라질 수 있으므로 항상 현재 빌드를 로컬에서 측정하세요: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +샘플 예시(macOS arm64, 2026년 2월 18일 측정): + +- 릴리스 바이너리 크기: `8.8M` +- `zeroclaw --help`: 실제 시간 약 `0.02s`, 최대 메모리 공간 ~`3.9 MB` +- `zeroclaw status`: 실제 시간 약 `0.01s`, 최대 메모리 공간 ~`4.1 MB` + +## 사전 요구사항 + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — 필수 + +1. **Visual Studio Build Tools**(MSVC 링커 및 Windows SDK 제공): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + 설치 중(또는 Visual Studio Installer를 통해) **"C++를 사용한 데스크톱 개발"** 워크로드를 선택하세요. + +2. **Rust 툴체인:** + + ```powershell + winget install Rustlang.Rustup + ``` + + 설치 후, 새 터미널을 열고 `rustup default stable`을 실행하여 안정적인 툴체인이 활성화되어 있는지 확인하세요. + +3. **확인:** 둘 다 작동하는지 확인: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — 선택사항 + +- **Docker Desktop** — [Docker 샌드박스 런타임](#현재-런타임-지원)을 사용하는 경우에만 필요(`runtime.kind = "docker"`). `winget install Docker.DockerDesktop`을 통해 설치. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — 필수 + +1. **필수 빌드 도구:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Xcode Command Line Tools 설치: `xcode-select --install` + +2. **Rust 툴체인:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + 자세한 내용은 [rustup.rs](https://rustup.rs)를 참조하세요. + +3. **확인:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — 선택사항 + +- **Docker** — [Docker 샌드박스 런타임](#현재-런타임-지원)을 사용하는 경우에만 필요(`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) 참조 + - **Linux (Fedora/RHEL):** [docs.docker.com](https://docs.docker.com/engine/install/fedora/) 참조 + - **macOS:** [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/)에서 Docker Desktop 설치 + +</details> + +## 빠른 시작 + +### 옵션 1: 자동 설정 (권장) + +`bootstrap.sh` 스크립트는 Rust를 설치하고, ZeroClaw를 클론하고, 컴파일하고, 초기 개발 환경을 설정합니다: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +이 작업은 다음을 수행합니다: + +1. Rust 설치 (없는 경우) +2. ZeroClaw 저장소 클론 +3. ZeroClaw를 릴리스 모드로 컴파일 +4. `~/.cargo/bin/`에 `zeroclaw` 설치 +5. `~/.zeroclaw/workspace/`에 기본 작업공간 구조 생성 +6. 시작용 `~/.zeroclaw/workspace/config.toml` 구성 파일 생성 + +부트스트랩 후, 셸을 다시 로드하거나 `source ~/.cargo/env`를 실행하여 `zeroclaw` 명령을 전역으로 사용하세요. + +### 옵션 2: 수동 설치 + +<details> +<summary><strong>클릭하여 수동 설치 단계 보기</strong></summary> + +```bash +# 1. 저장소 클론 +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. 릴리스로 컴파일 +cargo build --release --locked + +# 3. 바이너리 설치 +cargo install --path . --locked + +# 4. 작업공간 초기화 +zeroclaw init + +# 5. 설치 확인 +zeroclaw --version +zeroclaw status +``` + +</details> + +### 설치 후 + +설치 후(부트스트랩 또는 수동), 다음이 표시되어야 합니다: + +``` +~/.zeroclaw/workspace/ +├── config.toml # 메인 구성 +├── .pairing # 페어링 시크릿 (첫 실행 시 생성) +├── logs/ # 데몬/에이전트 로그 +├── skills/ # 사용자 정의 스킬 +└── memory/ # 대화 컨텍스트 저장소 +``` + +**다음 단계:** + +1. `~/.zeroclaw/workspace/config.toml`에서 AI 제공자 구성 +2. 고급 옵션은 [구성 참조](docs/config-reference.md) 확인 +3. 에이전트 시작: `zeroclaw agent start` +4. 선호하는 채널을 통해 테스트 ([채널 참조](docs/channels-reference.md) 참조) + +## 구성 + +제공자, 채널 및 시스템 동작을 구성하려면 `~/.zeroclaw/workspace/config.toml`을 편집하세요. + +### 빠른 구성 참조 + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # 또는 "sqlite" 또는 "none" + +[runtime] +kind = "native" # 또는 "docker" (Docker 필요) +``` + +**전체 참조 문서:** + +- [구성 참조](docs/config-reference.md) — 모든 설정, 검증, 기본값 +- [제공자 참조](docs/providers-reference.md) — AI 제공자별 구성 +- [채널 참조](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord 등 +- [운영](docs/operations-runbook.md) — 프로덕션 모니터링, 시크릿 교체, 스케일링 + +### 현재 런타임 지원 + +ZeroClaw는 두 가지 코드 실행 백엔드를 지원합니다: + +- **`native`**(기본값) — 직접 프로세스 실행, 가장 빠른 경로, 신뢰할 수 있는 환경에 이상적 +- **`docker`** — 전체 컨테이너 격리, 강화된 보안 정책, Docker 필요 + +엄격한 샌드박싱이나 네트워크 격리가 필요한 경우 `runtime.kind = "docker"`를 사용하세요. 자세한 내용은 [구성 참조](docs/config-reference.md#runtime)를 참조하세요. + +## 명령어 + +```bash +# 작업공간 관리 +zeroclaw init # 새 작업공간 초기화 +zeroclaw status # 데몬/에이전트 상태 표시 +zeroclaw config validate # config.toml 구문 및 값 확인 + +# 데몬 관리 +zeroclaw daemon start # 백그라운드에서 데몬 시작 +zeroclaw daemon stop # 실행 중인 데몬 중지 +zeroclaw daemon restart # 데몬 재시작 (구성 다시 로드) +zeroclaw daemon logs # 데몬 로그 표시 + +# 에이전트 관리 +zeroclaw agent start # 에이전트 시작 (데몬 실행 중 필요) +zeroclaw agent stop # 에이전트 중지 +zeroclaw agent restart # 에이전트 재시작 (구성 다시 로드) + +# 페어링 작업 +zeroclaw pairing init # 새 페어링 시크릿 생성 +zeroclaw pairing rotate # 기존 페어링 시크릿 교체 + +# 터널링 (공개 노출용) +zeroclaw tunnel start # 로컬 데몬으로 터널 시작 +zeroclaw tunnel stop # 활성 터널 중지 + +# 진단 +zeroclaw doctor # 시스템 상태 검사 실행 +zeroclaw version # 버전 및 빌드 정보 표시 +``` + +전체 옵션 및 예제는 [명령어 참조](docs/commands-reference.md)를 참조하세요. + +## 아키텍처 + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ 채널 (트레이트) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ 에이전트 오케스트레이터 │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ 메시지 │ │ 컨텍스트 │ │ 도구 │ │ +│ │ 라우팅 │ │ 메모리 │ │ 실행 │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ 제공자 │ │ 메모리 │ │ 도구 │ +│ (트레이트) │ │ (트레이트) │ │ (트레이트) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ 런타임 (트레이트) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**핵심 원칙:** + +- 모든 것이 **트레이트**입니다 — 제공자, 채널, 도구, 메모리, 터널 +- 채널이 오케스트레이터를 호출; 오케스트레이터가 제공자 + 도구를 호출 +- 메모리 시스템이 대화 컨텍스트 관리(markdown, SQLite, 또는 없음) +- 런타임이 코드 실행 추상화(네이티브 또는 Docker) +- 제공자 락인 없음 — 코드 변경 없이 Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama 교체 + +자세한 다이어그램과 구현 세부 정보는 [아키텍처 문서](docs/architecture.svg)를 참조하세요. + +## 예제 + +### 텔레그램 봇 + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # 당신의 텔레그램 사용자 ID +``` + +데몬 + 에이전트를 시작한 다음 텔레그램에서 봇에 메시지를 보내세요: + +``` +/start +안녕하세요! Python 스크립트 작성을 도와주실 수 있나요? +``` + +봇이 AI가 생성한 코드로 응답하고, 요청 시 도구를 실행하며, 대화 컨텍스트를 유지합니다. + +### Matrix (종단 간 암호화) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +암호화된 방에 `@zeroclaw:matrix.org`를 초대하면 봇이 완전한 암호화로 응답합니다. 장치 확인 설정은 [Matrix E2EE 가이드](docs/matrix-e2ee-guide.md)를 참조하세요. + +### 다중 제공자 + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # 제공자 오류 시 장애 조치 +``` + +Anthropic이 실패하거나 속도 제한이 걸리면 오케스트레이터가 자동으로 OpenAI로 장애 조치합니다. + +### 사용자 정의 메모리 + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # 90일 후 자동 삭제 +``` + +또는 사람이 읽을 수 있는 저장소를 위해 Markdown을 사용하세요: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +모든 메모리 옵션은 [구성 참조](docs/config-reference.md#memory)를 참조하세요. + +## 제공자 지원 + +| 제공자 | 상태 | API 키 | 예제 모델 | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ 안정 | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ 안정 | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ 안정 | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ 안정 | N/A (로컬) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ 안정 | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ 안정 | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 계획 중 | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 계획 중 | `COHERE_API_KEY` | TBD | + +### 사용자 정의 엔드포인트 + +ZeroClaw는 OpenAI 호환 엔드포인트를 지원합니다: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +예: [LiteLLM](https://github.com/BerriAI/litellm)을 프록시로 사용하여 OpenAI 인터페이스를 통해 모든 LLM에 액세스. + +전체 구성 세부 정보는 [제공자 참조](docs/providers-reference.md)를 참조하세요. + +## 채널 지원 + +| 채널 | 상태 | 인증 | 참고 | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ 안정 | 봇 토큰 | 파일, 이미지, 인라인 버튼 포함 전체 지원 | +| **Matrix** | ✅ 안정 | 비밀번호 또는 토큰 | 장치 확인과 함께 E2EE 지원 | +| **Slack** | 🚧 계획 중 | OAuth 또는 봇 토큰 | 작업공간 액세스 필요 | +| **Discord** | 🚧 계획 중 | 봇 토큰 | 길드 권한 필요 | +| **WhatsApp** | 🚧 계획 중 | Twilio 또는 공식 API | 비즈니스 계정 필요 | +| **CLI** | ✅ 안정 | 없음 | 직접 대화형 인터페이스 | +| **Web** | 🚧 계획 중 | API 키 또는 OAuth | 브라우저 기반 채팅 인터페이스 | + +전체 구성 지침은 [채널 참조](docs/channels-reference.md)를 참조하세요. + +## 도구 지원 + +ZeroClaw는 코드 실행, 파일 시스템 액세스 및 웹 검색을 위한 기본 제공 도구를 제공합니다: + +| 도구 | 설명 | 필수 런타임 | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | 셸 명령 실행 | 네이티브 또는 Docker | +| **python** | Python 스크립트 실행 | Python 3.8+ (네이티브) 또는 Docker | +| **javascript** | Node.js 코드 실행 | Node.js 18+ (네이티브) 또는 Docker | +| **filesystem_read** | 파일 읽기 | 네이티브 또는 Docker | +| **filesystem_write** | 파일 쓰기 | 네이티브 또는 Docker | +| **web_fetch** | 웹 콘텐츠 가져오기 | 네이티브 또는 Docker | + +### 실행 보안 + +- **네이티브 런타임** — 데몬의 사용자 프로세스로 실행, 파일 시스템에 전체 액세스 +- **Docker 런타임** — 전체 컨테이너 격리, 별도의 파일 시스템 및 네트워크 + +`config.toml`에서 실행 정책을 구성하세요: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # 명시적 허용 목록 +``` + +전체 보안 옵션은 [구성 참조](docs/config-reference.md#runtime)를 참조하세요. + +## 배포 + +### 로컬 배포 (개발) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### 서버 배포 (프로덕션) + +systemd를 사용하여 데몬과 에이전트를 서비스로 관리하세요: + +```bash +# 바이너리 설치 +cargo install --path . --locked + +# 작업공간 구성 +zeroclaw init + +# systemd 서비스 파일 생성 +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# 서비스 활성화 및 시작 +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# 상태 확인 +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +전체 프로덕션 배포 지침은 [네트워크 배포 가이드](docs/network-deployment.md)를 참조하세요. + +### Docker + +```bash +# 이미지 빌드 +docker build -t zeroclaw:latest . + +# 컨테이너 실행 +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +빌드 세부 정보 및 구성 옵션은 [`Dockerfile`](Dockerfile)을 참조하세요. + +### 엣지 하드웨어 + +ZeroClaw는 저전력 하드웨어에서 실행되도록 설계되었습니다: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, 단일 ARMv8 코어, < $5 하드웨어 비용 +- **Raspberry Pi 4/5** — 1 GB+ RAM, 멀티코어, 동시 워크로드에 이상적 +- **Orange Pi Zero 2** — ~512 MB RAM, 쿼드코어 ARMv8, 초저비용 +- **x86 SBCs (Intel N100)** — 4-8 GB RAM, 빠른 빌드, 네이티브 Docker 지원 + +장치별 설정 지침은 [하드웨어 가이드](docs/hardware/README.md)를 참조하세요. + +## 터널링 (공개 노출) + +보안 터널을 통해 로컬 ZeroClaw 데몬을 공개 네트워크에 노출하세요: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +지원되는 터널 제공자: + +- **Cloudflare Tunnel** — 무료 HTTPS, 포트 노출 없음, 멀티 도메인 지원 +- **Ngrok** — 빠른 설정, 사용자 정의 도메인 (유료 플랜) +- **Tailscale** — 프라이빗 메시 네트워크, 공개 포트 없음 + +전체 구성 옵션은 [구성 참조](docs/config-reference.md#tunnel)를 참조하세요. + +## 보안 + +ZeroClaw는 여러 보안 계층을 구현합니다: + +### 페어링 + +데몬은 첫 실행 시 `~/.zeroclaw/workspace/.pairing`에 저장된 페어링 시크릿을 생성합니다. 클라이언트(에이전트, CLI)는 연결하기 위해 이 시크릿을 제시해야 합니다. + +```bash +zeroclaw pairing rotate # 새 시크릿 생성 및 이전 것 무효화 +``` + +### 샌드박싱 + +- **Docker 런타임** — 별도의 파일 시스템 및 네트워크로 전체 컨테이너 격리 +- **네이티브 런타임** — 사용자 프로세스로 실행, 기본적으로 작업공간으로 범위 지정 + +### 허용 목록 + +채널은 사용자 ID로 액세스를 제한할 수 있습니다: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # 명시적 허용 목록 +``` + +### 암호화 + +- **Matrix E2EE** — 장치 확인과 함께 완전한 종단 간 암호화 +- **TLS 전송** — 모든 API 및 터널 트래픽이 HTTPS/TLS 사용 + +전체 정책 및 관행은 [보안 문서](docs/security/README.md)를 참조하세요. + +## 관찰 가능성 + +ZeroClaw는 기본적으로 `~/.zeroclaw/workspace/logs/`에 로그를 기록합니다. 로그는 구성 요소별로 저장됩니다: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # 데몬 로그 (시작, API 요청, 오류) +├── agent.log # 에이전트 로그 (메시지 라우팅, 도구 실행) +├── telegram.log # 채널별 로그 (활성화된 경우) +└── matrix.log # 채널별 로그 (활성화된 경우) +``` + +### 로깅 구성 + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # 크기 기반 회전용 +retention_days = 30 # N일 후 자동 삭제 +``` + +모든 로깅 옵션은 [구성 참조](docs/config-reference.md#logging)를 참조하세요. + +### 메트릭 (계획 중) + +프로덕션 모니터링을 위한 Prometheus 메트릭 지원이 곧 제공됩니다. [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234)에서 추적 중. + +## 스킬 (Skills) + +ZeroClaw는 시스템 기능을 확장하는 재사용 가능한 모듈인 사용자 정의 스킬을 지원합니다. + +### 스킬 정의 + +스킬은 다음 구조로 `~/.zeroclaw/workspace/skills/<skill-name>/`에 저장됩니다: + +``` +skills/ +└── my-skill/ + ├── skill.toml # 스킬 메타데이터 (이름, 설명, 의존성) + ├── prompt.md # AI용 시스템 프롬프트 + └── tools/ # 선택적 사용자 정의 도구 + └── my_tool.py +``` + +### 스킬 예제 + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "웹 검색 및 결과 요약" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +당신은 연구 어시스턴트입니다. 무언가를 검색하라는 요청을 받으면: + +1. web_fetch를 사용하여 콘텐츠 가져오기 +2. 읽기 쉬운 형식으로 결과 요약 +3. URL로 출처 인용 +``` + +### 스킬 사용 + +스킬은 에이전트 시작 시 자동으로 로드됩니다. 대화에서 이름으로 참조하세요: + +``` +사용자: 웹 연구 스킬을 사용하여 최신 AI 뉴스 찾기 +봇: [웹 연구 스킬 로드, web_fetch 실행, 결과 요약] +``` + +전체 스킬 생성 지침은 [스킬 (Skills)](#스킬-skills) 섹션을 참조하세요. + +## Open Skills + +ZeroClaw는 [Open Skills](https://github.com/openagents-com/open-skills)를 지원합니다 — AI 에이전트 기능을 확장하기 위한 모듈형 및 제공자 독립적인 시스템. + +### Open Skills 활성화 + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # 선택사항 +``` + +런타임에 `ZEROCLAW_OPEN_SKILLS_ENABLED` 및 `ZEROCLAW_OPEN_SKILLS_DIR`로 재정의할 수도 있습니다. + +## 개발 + +```bash +cargo build # 개발 빌드 +cargo build --release # 릴리스 빌드 (codegen-units=1, Raspberry Pi 포함 모든 장치에서 작동) +cargo build --profile release-fast # 더 빠른 빌드 (codegen-units=8, 16 GB+ RAM 필요) +cargo test # 전체 테스트 스위트 실행 +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # 포맷 + +# SQLite vs Markdown 비교 벤치마크 실행 +cargo test --test memory_comparison -- --nocapture +``` + +### pre-push 훅 + +git 훅이 각 푸시 전에 `cargo fmt --check`, `cargo clippy -- -D warnings`, 그리고 `cargo test`를 실행합니다. 한 번 활성화하세요: + +```bash +git config core.hooksPath .githooks +``` + +### 빌드 문제 해결 (Linux에서 OpenSSL 오류) + +`openssl-sys` 빌드 오류가 발생하면 종속성을 동기화하고 저장소의 lockfile로 다시 빌드하세요: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw는 HTTP/TLS 종속성에 대해 `rustls`를 사용하도록 구성되어 있습니다; `--locked`는 깨끗한 환경에서 전이적 그래프를 결정적으로 유지합니다. + +개발 중 빠른 푸시가 필요할 때 훅을 건너뛰려면: + +```bash +git push --no-verify +``` + +## 협업 및 문서 + +작업 기반 맵을 위해 문서 허브로 시작하세요: + +- 문서 허브: [`docs/README.md`](docs/README.md) +- 통합 문서 목차: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- 명령어 참조: [`docs/commands-reference.md`](docs/commands-reference.md) +- 구성 참조: [`docs/config-reference.md`](docs/config-reference.md) +- 제공자 참조: [`docs/providers-reference.md`](docs/providers-reference.md) +- 채널 참조: [`docs/channels-reference.md`](docs/channels-reference.md) +- 운영 런북: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- 문제 해결: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- 문서 인벤토리/분류: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- PR/이슈 트리아지 스냅샷 (2026년 2월 18일 기준): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +주요 협업 참조: + +- 문서 허브: [docs/README.md](docs/README.md) +- 문서 템플릿: [docs/doc-template.md](docs/doc-template.md) +- 문서 변경 체크리스트: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- 채널 구성 참조: [docs/channels-reference.md](docs/channels-reference.md) +- Matrix 암호화 방 운영: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- 기여 가이드: [CONTRIBUTING.md](CONTRIBUTING.md) +- PR 워크플로 정책: [docs/pr-workflow.md](docs/pr-workflow.md) +- 리뷰어 플레이북 (트리아지 + 심층 리뷰): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- 소유권 및 CI 트리아지 맵: [docs/ci-map.md](docs/ci-map.md) +- 보안 공개 정책: [SECURITY.md](SECURITY.md) + +배포 및 런타임 운영용: + +- 네트워크 배포 가이드: [docs/network-deployment.md](docs/network-deployment.md) +- 프록시 에이전트 플레이북: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## ZeroClaw 지원하기 + +ZeroClaw가 당신의 작업에 도움이 되었고 지속적인 개발을 지원하고 싶다면 여기에서 기부할 수 있습니다: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="커피 한 잔 사주기" /></a> + +### 🙏 특별 감사 + +이 오픈소스 작업에 영감을 주고 지원하는 커뮤니티와 기관에 진심으로 감사드립니다: + +- **Harvard University** — 지적 호기심을 키우고 가능성의 한계를 넓혀줌. +- **MIT** — 열린 지식, 오픈소스, 기술이 모두에게 접근 가능해야 한다는 신념을 옹호함. +- **Sundai Club** — 커뮤니티, 에너지, 그리고 의미 있는 것을 만들고자 하는 끊임없는 의지. +- **세계 그리고 그 너머** 🌍✨ — 오픈소스를 선한 힘으로 만드는 모든 기여자, 꿈꾸는 자, 그리고 빌더에게. 이것은 여러분을 위한 것입니다. + +우리는 최고의 아이디어가 모든 곳에서 나오기 때문에 오픈소스로 구축합니다. 이것을 읽고 있다면 여러분도 그 일부입니다. 환영합니다. 🦀❤️ + +## ⚠️ 공식 저장소 및 사칭 경고 + +**이것이 유일한 공식 ZeroClaw 저장소입니다:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +"ZeroClaw"라고 주장하거나 ZeroClaw Labs와의 제휴를 암시하는 다른 저장소, 조직, 도메인 또는 패키지는 **승인되지 않았으며 이 프로젝트와 관련이 없습니다**. 알려진 승인되지 않은 포크는 [TRADEMARK.md](TRADEMARK.md)에 나열됩니다. + +사칭 또는 상표 오용을 발견하면 [이슈를 열어](https://github.com/zeroclaw-labs/zeroclaw/issues) 신고해 주세요. + +--- + +## 라이선스 + +ZeroClaw는 최대한의 개방성과 기여자 보호를 위해 듀얼 라이선스가 적용됩니다: + +| 라이선스 | 사용 사례 | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | 오픈소스, 연구, 학술, 개인 사용 | +| [Apache 2.0](LICENSE-APACHE) | 특허 보호, 기관, 상업 배포 | + +두 라이선스 중 하나를 선택할 수 있습니다. **기여자는 자동으로 두 가지 모두에 대한 권한을 부여합니다** — 전체 기여자 계약은 [CLA.md](CLA.md)를 참조하세요. + +### 상표 + +**ZeroClaw** 이름과 로고는 ZeroClaw Labs의 등록 상표입니다. 이 라이선스는 승인 또는 제휴를 암시하기 위해 사용할 수 있는 권한을 부여하지 않습니다. 허용 및 금지된 사용은 [TRADEMARK.md](TRADEMARK.md)를 참조하세요. + +### 기여자 보호 + +- 기여의 **저작권을 유지**합니다 +- **특허 부여** (Apache 2.0)가 다른 기여자의 특허 청구로부터 보호합니다 +- 기여는 커밋 기록과 [NOTICE](NOTICE)에 **영구적으로 귀속**됩니다 +- 기여함으로써 상표권이 이전되지 않습니다 + +## 기여하기 + +[CONTRIBUTING.md](CONTRIBUTING.md)와 [CLA.md](CLA.md)를 참조하세요. 트레이트를 구현하고 PR을 제출하세요: + +- CI 워크플로 가이드: [docs/ci-map.md](docs/ci-map.md) +- 새 `Provider` → `src/providers/` +- 새 `Channel` → `src/channels/` +- 새 `Observer` → `src/observability/` +- 새 `Tool` → `src/tools/` +- 새 `Memory` → `src/memory/` +- 새 `Tunnel` → `src/tunnel/` +- 새 `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — 오버헤드 없음. 타협 없음. 어디서나 배포. 무엇이든 교체. 🦀 + +## 스타 히스토리 + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="스타 히스토리 그래프" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.md b/README.md index ebe569cd4..9af7b3df8 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,38 @@ Built by students and members of the Harvard, MIT, and Sundai.Club communities. </p> <p align="center"> - 🌐 <strong>Languages:</strong> <a href="README.md">English</a> · <a href="README.zh-CN.md">简体中文</a> · <a href="README.ja.md">日本語</a> · <a href="README.ru.md">Русский</a> · <a href="README.fr.md">Français</a> · <a href="README.vi.md">Tiếng Việt</a> + 🌐 <strong>Languages:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> </p> <p align="center"> diff --git a/README.nb.md b/README.nb.md new file mode 100644 index 000000000..323c536a3 --- /dev/null +++ b/README.nb.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Null overhead. Null kompromiss. 100% Rust. 100% Agnostisk.</strong><br> + ⚡️ <strong>Kjører på $10 maskinvare med <5MB RAM: Det er 99% mindre minne enn OpenClaw og 98% billigere enn en Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Språk:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Hva er ZeroClaw? + +ZeroClaw er en lettvektig, foranderlig og utvidbar AI-assistent-infrastruktur bygget i Rust. Den kobler sammen ulike LLM-leverandører (Anthropic, OpenAI, Google, Ollama osv.) via et samlet grensesnitt og støtter flere kanaler (Telegram, Matrix, CLI osv.). + +### Hovedfunksjoner + +- **🦀 Skrevet i Rust**: Høy ytelse, minnesikkerhet og nullkostnads-abstraksjoner +- **🔌 Leverandør-agnostisk**: Støtter OpenAI, Anthropic, Google Gemini, Ollama og andre +- **📱 Multi-kanal**: Telegram, Matrix (med E2EE), CLI og andre +- **🧠 Pluggbart minne**: SQLite og Markdown-backends +- **🛠️ Utvidbare verktøy**: Legg til tilpassede verktøy enkelt +- **🔒 Sikkerhet først**: Omvendt proxy, personvern-først design + +--- + +## Rask Start + +### Krav + +- Rust 1.70+ +- En LLM-leverandør API-nøkkel (Anthropic, OpenAI osv.) + +### Installasjon + +```bash +# Klon repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Bygg +cargo build --release + +# Kjør +cargo run --release +``` + +### Med Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Konfigurasjon + +ZeroClaw bruker en YAML-konfigurasjonsfil. Som standard ser den etter `config.yaml`. + +```yaml +# Standardleverandør +provider: anthropic + +# Leverandørkonfigurasjon +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Minnekonfigurasjon +memory: + backend: sqlite + path: data/memory.db + +# Kanalkonfigurasjon +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Dokumentasjon + +For detaljert dokumentasjon, se: + +- [Dokumentasjonshub](docs/README.md) +- [Kommandoreferanse](docs/commands-reference.md) +- [Leverandørreferanse](docs/providers-reference.md) +- [Kanalreferanse](docs/channels-reference.md) +- [Konfigurasjonsreferanse](docs/config-reference.md) + +--- + +## Bidrag + +Bidrag er velkomne! Vennligst les [Bidragsguiden](CONTRIBUTING.md). + +--- + +## Lisens + +Dette prosjektet er dobbelt-lisensiert: + +- MIT License +- Apache License, versjon 2.0 + +Se [LICENSE-APACHE](LICENSE-APACHE) og [LICENSE-MIT](LICENSE-MIT) for detaljer. + +--- + +## Fellesskap + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Sponsorer + +Hvis ZeroClaw er nyttig for deg, vennligst vurder å kjøpe oss en kaffe: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.nl.md b/README.nl.md new file mode 100644 index 000000000..570bf67ad --- /dev/null +++ b/README.nl.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Nul overhead. Nul compromis. 100% Rust. 100% Agnostisch.</strong><br> + ⚡️ <strong>Draait op $10 hardware met <5MB RAM: Dat is 99% minder geheugen dan OpenClaw en 98% goedkoper dan een Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Gebouwd door studenten en leden van de Harvard, MIT en Sundai.Club gemeenschappen. +</p> + +<p align="center"> + 🌐 <strong>Talen:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#snelle-start">Snelle Start</a> | + <a href="bootstrap.sh">One-Click Setup</a> | + <a href="docs/README.md">Documentatie Hub</a> | + <a href="docs/SUMMARY.md">Documentatie Inhoudsopgave</a> +</p> + +<p align="center"> + <strong>Snelle toegang:</strong> + <a href="docs/reference/README.md">Referentie</a> · + <a href="docs/operations/README.md">Operations</a> · + <a href="docs/troubleshooting.md">Probleemoplossing</a> · + <a href="docs/security/README.md">Beveiliging</a> · + <a href="docs/hardware/README.md">Hardware</a> · + <a href="docs/contributing/README.md">Bijdragen</a> +</p> + +<p align="center"> + <strong>Snelle, lichtgewicht en volledig autonome AI-assistent infrastructuur</strong><br /> + Implementeer overal. Wissel alles. +</p> + +<p align="center"> + ZeroClaw is het <strong>runtime besturingssysteem</strong> voor agent workflows — een infrastructuur die modellen, tools, geheugen en uitvoering abstraheert om agenten één keer te bouwen en overal uit te voeren. +</p> + +<p align="center"><code>Trait-gedreven architectuur · veilige runtime standaard · verwisselbare provider/kanaal/tool · alles is plugbaar</code></p> + +### 📢 Aankondigingen + +Gebruik deze tabel voor belangrijke aankondigingen (compatibiliteitswijzigingen, beveiligingsberichten, onderhoudsvensters en versieblokkades). + +| Datum (UTC) | Niveau | Aankondiging | Actie | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Kritiek_ | **We zijn niet gelieerd** met `openagen/zeroclaw` of `zeroclaw.org`. Het domein `zeroclaw.org` wijst momenteel naar de fork `openagen/zeroclaw`, en dit domein/repository imiteert onze officiële website/project. | Vertrouw geen informatie, binaire bestanden, fondsenwerving of aankondigingen van deze bronnen. Gebruik alleen [deze repository](https://github.com/zeroclaw-labs/zeroclaw) en onze geverifieerde sociale media accounts. | +| 2026-02-21 | _Belangrijk_ | Onze officiële website is nu online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Bedankt voor je geduld tijdens het wachten. We detecteren nog steeds imitatiepogingen: neem niet deel aan enige investering/fondsenwerving activiteit in naam van ZeroClaw als deze niet via onze officiële kanalen wordt gepubliceerd. | Gebruik [deze repository](https://github.com/zeroclaw-labs/zeroclaw) als de enige bron van waarheid. Volg [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (groep)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), en [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) voor officiële updates. | +| 2026-02-19 | _Belangrijk_ | Anthropic heeft de gebruiksvoorwaarden voor authenticatie en inloggegevens bijgewerkt op 2026-02-19. OAuth authenticatie (Free, Pro, Max) is exclusief voor Claude Code en Claude.ai; het gebruik van Claude Free/Pro/Max OAuth tokens in enig ander product, tool of service (inclusief Agent SDK) is niet toegestaan en kan in strijd zijn met de Consumenten Gebruiksvoorwaarden. | Vermijd tijdelijk Claude Code OAuth integraties om potentiële verliezen te voorkomen. Originele clausule: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Functies + +- 🏎️ **Lichtgewicht Runtime Standaard:** Veelvoorkomende CLI workflows en statuscommando's draaien binnen een geheugenruimte van enkele megabytes in productie builds. +- 💰 **Kosteneffectieve Implementatie:** Ontworpen voor goedkope boards en kleine cloud instanties zonder zware runtime afhankelijkheden. +- ⚡ **Snelle Koude Starts:** De single-binary Rust runtime houdt commando en daemon starts bijna direct voor dagelijkse operaties. +- 🌍 **Draagbare Architectuur:** Een single-binary workflow op ARM, x86 en RISC-V met verwisselbare provider/kanaal/tool. + +### Waarom teams kiezen voor ZeroClaw + +- **Lichtgewicht standaard:** kleine Rust binary, snelle start, laag geheugengebruik. +- **Veilig door design:** pairing, strikte sandboxing, expliciete allowlists, workspace scope. +- **Volledig verwisselbaar:** kernsystemen zijn traits (providers, kanalen, tools, geheugen, tunnels). +- **Geen vendor lock-in:** OpenAI-compatibele provider ondersteuning + plugbare custom endpoints. + +## Benchmark Snapshot (ZeroClaw vs OpenClaw, Reproduceerbaar) + +Snelle benchmark op lokale machine (macOS arm64, feb. 2026) genormaliseerd voor 0.8 GHz edge hardware. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Taal** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Start (0.8 GHz core)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Binary Grootte** | ~28 MB (dist) | N/A (Scripts) | ~8 MB | **3.4 MB** | +| **Kosten** | Mac Mini $599 | Linux SBC ~$50 | Linux board $10 | **Elke hardware $10** | + +> Opmerkingen: ZeroClaw resultaten worden gemeten op productie builds met `/usr/bin/time -l`. OpenClaw vereist de Node.js runtime (typisch ~390 MB extra geheugen overhead), terwijl NanoBot de Python runtime vereist. PicoClaw en ZeroClaw zijn statische binaries. De bovenstaande RAM cijfers zijn runtime geheugen; build-time compilatievereisten zijn hoger. + +<p align="center"> + <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Vergelijking" width="800" /> +</p> + +### Reproduceerbare Lokale Meting + +Benchmark beweringen kunnen afwijken naarmate code en toolchains evolueren, dus meet altijd je huidige build lokaal: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Voorbeeld monster (macOS arm64, gemeten op 18 februari 2026): + +- Release binary grootte: `8.8M` +- `zeroclaw --help`: werkelijke tijd ongeveer `0.02s`, piek geheugengebruik ~`3.9 MB` +- `zeroclaw status`: werkelijke tijd ongeveer `0.01s`, piek geheugengebruik ~`4.1 MB` + +## Vereisten + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Vereist + +1. **Visual Studio Build Tools** (levert MSVC linker en Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Selecteer tijdens de installatie (of via Visual Studio Installer) de **"Desktop development with C++"** workload. + +2. **Rust Toolchain:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Na installatie, open een nieuwe terminal en voer `rustup default stable` uit om ervoor te zorgen dat de stabiele toolchain actief is. + +3. **Verifieer** dat beide werken: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Optioneel + +- **Docker Desktop** — alleen vereist als je de [Docker sandboxed runtime](#huidige-runtime-ondersteuning) gebruikt (`runtime.kind = "docker"`). Installeer via `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Vereist + +1. **Essentiële build tools:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Installeer Xcode Command Line Tools: `xcode-select --install` + +2. **Rust Toolchain:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Zie [rustup.rs](https://rustup.rs) voor details. + +3. **Verifieer:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Optioneel + +- **Docker** — alleen vereist als je de [Docker sandboxed runtime](#huidige-runtime-ondersteuning) gebruikt (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** zie [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** zie [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** installeer Docker Desktop via [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Snelle Start + +### Optie 1: Geautomatiseerde setup (aanbevolen) + +Het `bootstrap.sh` script installeert Rust, kloont ZeroClaw, compileert het, en stelt je initiële ontwikkelomgeving in: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Dit zal: + +1. Rust installeren (indien afwezig) +2. De ZeroClaw repository klonen +3. ZeroClaw compileren in release modus +4. `zeroclaw` installeren in `~/.cargo/bin/` +5. De standaard workspace structuur maken in `~/.zeroclaw/workspace/` +6. Een initiële configuratie `~/.zeroclaw/workspace/config.toml` genereren + +Na de bootstrap, herlaad je shell of voer `source ~/.cargo/env` uit om het `zeroclaw` commando globaal te gebruiken. + +### Optie 2: Handmatige installatie + +<details> +<summary><strong>Klik om handmatige installatiestappen te zien</strong></summary> + +```bash +# 1. Kloon de repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Compileer in release +cargo build --release --locked + +# 3. Installeer de binary +cargo install --path . --locked + +# 4. Initialiseer de workspace +zeroclaw init + +# 5. Verifieer de installatie +zeroclaw --version +zeroclaw status +``` + +</details> + +### Na Installatie + +Eenmaal geïnstalleerd (via bootstrap of handmatig), zou je moeten zien: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Hoofdconfiguratie +├── .pairing # Pairing geheimen (gegenereerd bij eerste lancering) +├── logs/ # Daemon/agent logs +├── skills/ # Aangepaste vaardigheden +└── memory/ # Gesprekscontext opslag +``` + +**Volgende stappen:** + +1. Configureer je AI providers in `~/.zeroclaw/workspace/config.toml` +2. Bekijk de [configuratie referentie](docs/config-reference.md) voor geavanceerde opties +3. Start de agent: `zeroclaw agent start` +4. Test via je voorkeurskanaal (zie [kanalen referentie](docs/channels-reference.md)) + +## Configuratie + +Bewerk `~/.zeroclaw/workspace/config.toml` om providers, kanalen en systeemgedrag te configureren. + +### Snelle Configuratie Referentie + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # of "sqlite" of "none" + +[runtime] +kind = "native" # of "docker" (vereist Docker) +``` + +**Volledige referentie documenten:** + +- [Configuratie Referentie](docs/config-reference.md) — alle instellingen, validaties, standaardwaarden +- [Providers Referentie](docs/providers-reference.md) — AI provider-specifieke configuraties +- [Kanalen Referentie](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord en meer +- [Operations](docs/operations-runbook.md) — productie monitoring, geheim rotatie, schaling + +### Huidige Runtime Ondersteuning + +ZeroClaw ondersteunt twee code uitvoeringsbackends: + +- **`native`** (standaard) — directe procesuitvoering, snelste pad, ideaal voor vertrouwde omgevingen +- **`docker`** — volledige container isolatie, versterkt beveiligingsbeleid, vereist Docker + +Gebruik `runtime.kind = "docker"` als je strikte sandboxing of netwerkisolatie nodig hebt. Zie [configuratie referentie](docs/config-reference.md#runtime) voor volledige details. + +## Commando's + +```bash +# Workspace beheer +zeroclaw init # Initialiseert een nieuwe workspace +zeroclaw status # Toont daemon/agent status +zeroclaw config validate # Verifieert config.toml syntax en waarden + +# Daemon beheer +zeroclaw daemon start # Start de daemon in de achtergrond +zeroclaw daemon stop # Stopt de draaiende daemon +zeroclaw daemon restart # Herstart de daemon (config herladen) +zeroclaw daemon logs # Toont daemon logs + +# Agent beheer +zeroclaw agent start # Start de agent (vereist draaiende daemon) +zeroclaw agent stop # Stopt de agent +zeroclaw agent restart # Herstart de agent (config herladen) + +# Pairing operaties +zeroclaw pairing init # Genereert een nieuw pairing geheim +zeroclaw pairing rotate # Roteert het bestaande pairing geheim + +# Tunneling (voor publieke blootstelling) +zeroclaw tunnel start # Start een tunnel naar de lokale daemon +zeroclaw tunnel stop # Stopt de actieve tunnel + +# Diagnostiek +zeroclaw doctor # Voert systeem gezondheidscontroles uit +zeroclaw version # Toont versie en build informatie +``` + +Zie [Commando's Referentie](docs/commands-reference.md) voor volledige opties en voorbeelden. + +## Architectuur + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Kanalen (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Agent Orchestrator │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Bericht │ │ Context │ │ Tool │ │ +│ │ Routing │ │ Geheugen │ │ Uitvoering │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Providers │ │ Geheugen │ │ Tools │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Belangrijkste principes:** + +- Alles is een **trait** — providers, kanalen, tools, geheugen, tunnels +- Kanalen roepen de orchestrator aan; de orchestrator roept providers + tools aan +- Het geheugensysteem beheert gesprekscontext (markdown, SQLite, of geen) +- De runtime abstraheert code-uitvoering (native of Docker) +- Geen provider lock-in — wissel Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama zonder codewijzigingen + +Zie [architectuur documentatie](docs/architecture.svg) voor gedetailleerde diagrammen en implementatiedetails. + +## Voorbeelden + +### Telegram Bot + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Je Telegram user ID +``` + +Start de daemon + agent, stuur dan een bericht naar je bot op Telegram: + +``` +/start +Hallo! Zou je me kunnen helpen met het schrijven van een Python script? +``` + +De bot reageert met AI-gegenereerde code, voert tools uit indien gevraagd, en behoudt gesprekscontext. + +### Matrix (end-to-end encryptie) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Nodig `@zeroclaw:matrix.org` uit in een versleutelde kamer, en de bot zal reageren met volledige encryptie. Zie [Matrix E2EE Gids](docs/matrix-e2ee-guide.md) voor apparaatverificatie setup. + +### Multi-Provider + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover bij provider fout +``` + +Als Anthropic faalt of rate-limit heeft, schakelt de orchestrator automatisch over naar OpenAI. + +### Aangepast Geheugen + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Automatische opruiming na 90 dagen +``` + +Of gebruik Markdown voor mens-leesbare opslag: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Zie [Configuratie Referentie](docs/config-reference.md#memory) voor alle geheugenopties. + +## Provider Ondersteuning + +| Provider | Status | API Sleutel | Voorbeeld Modellen | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Stabiel | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Stabiel | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Stabiel | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Stabiel | N/A (lokaal) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Stabiel | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Stabiel | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Gepland | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Gepland | `COHERE_API_KEY` | TBD | + +### Aangepaste Endpoints + +ZeroClaw ondersteunt OpenAI-compatibele endpoints: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Voorbeeld: gebruik [LiteLLM](https://github.com/BerriAI/litellm) als proxy om toegang te krijgen tot elke LLM via de OpenAI interface. + +Zie [Providers Referentie](docs/providers-reference.md) voor volledige configuratiedetails. + +## Kanaal Ondersteuning + +| Kanaal | Status | Authenticatie | Opmerkingen | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Stabiel | Bot Token | Volledige ondersteuning inclusief bestanden, afbeeldingen, inline knoppen | +| **Matrix** | ✅ Stabiel | Wachtwoord of Token | E2EE ondersteuning met apparaatverificatie | +| **Slack** | 🚧 Gepland | OAuth of Bot Token | Vereist workspace toegang | +| **Discord** | 🚧 Gepland | Bot Token | Vereist guild permissies | +| **WhatsApp** | 🚧 Gepland | Twilio of officiële API | Vereist business account | +| **CLI** | ✅ Stabiel | Geen | Directe conversationele interface | +| **Web** | 🚧 Gepland | API Sleutel of OAuth | Browser-gebaseerde chat interface | + +Zie [Kanalen Referentie](docs/channels-reference.md) voor volledige configuratie-instructies. + +## Tool Ondersteuning + +ZeroClaw biedt ingebouwde tools voor code-uitvoering, bestandssysteem toegang en web retrieval: + +| Tool | Beschrijving | Vereiste Runtime | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Voert shell commando's uit | Native of Docker | +| **python** | Voert Python scripts uit | Python 3.8+ (native) of Docker | +| **javascript** | Voert Node.js code uit | Node.js 18+ (native) of Docker | +| **filesystem_read** | Leest bestanden | Native of Docker | +| **filesystem_write** | Schrijft bestanden | Native of Docker | +| **web_fetch** | Haalt web inhoud op | Native of Docker | + +### Uitvoeringsbeveiliging + +- **Native Runtime** — draait als gebruikersproces van de daemon, volledige bestandssysteem toegang +- **Docker Runtime** — volledige container isolatie, gescheiden bestandssystemen en netwerken + +Configureer het uitvoeringsbeleid in `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Expliciete allowlist +``` + +Zie [Configuratie Referentie](docs/config-reference.md#runtime) voor volledige beveiligingsopties. + +## Implementatie + +### Lokale Implementatie (Ontwikkeling) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Server Implementatie (Productie) + +Gebruik systemd om daemon en agent als services te beheren: + +```bash +# Installeer de binary +cargo install --path . --locked + +# Configureer de workspace +zeroclaw init + +# Maak systemd service bestanden +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Schakel in en start de services +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Verifieer de status +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Zie [Netwerk Implementatie Gids](docs/network-deployment.md) voor volledige productie-implementatie instructies. + +### Docker + +```bash +# Bouw de image +docker build -t zeroclaw:latest . + +# Draai de container +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Zie [`Dockerfile`](Dockerfile) voor bouw-details en configuratie-opties. + +### Edge Hardware + +ZeroClaw is ontworpen om te draaien op laagvermogen hardware: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, enkele ARMv8 core, < $5 hardware kosten +- **Raspberry Pi 4/5** — 1 GB+ RAM, multi-core, ideaal voor gelijktijdige workloads +- **Orange Pi Zero 2** — ~512 MB RAM, quad-core ARMv8, ultra-lage kosten +- **x86 SBCs (Intel N100)** — 4-8 GB RAM, snelle builds, native Docker ondersteuning + +Zie [Hardware Gids](docs/hardware/README.md) voor apparaat-specifieke setup instructies. + +## Tunneling (Publieke Blootstelling) + +Stel je lokale ZeroClaw daemon bloot aan het publieke netwerk via beveiligde tunnels: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Ondersteunde tunnel providers: + +- **Cloudflare Tunnel** — gratis HTTPS, geen poort blootstelling, multi-domein ondersteuning +- **Ngrok** — snelle setup, aangepaste domeinen (betaald plan) +- **Tailscale** — privé mesh netwerk, geen publieke poort + +Zie [Configuratie Referentie](docs/config-reference.md#tunnel) voor volledige configuratie-opties. + +## Beveiliging + +ZeroClaw implementeert meerdere beveiligingslagen: + +### Pairing + +De daemon genereert een pairing geheim bij de eerste lancering opgeslagen in `~/.zeroclaw/workspace/.pairing`. Clients (agent, CLI) moeten dit geheim presenteren om verbinding te maken. + +```bash +zeroclaw pairing rotate # Genereert een nieuw geheim en invalideert het oude +``` + +### Sandboxing + +- **Docker Runtime** — volledige container isolatie met gescheiden bestandssystemen en netwerken +- **Native Runtime** — draait als gebruikersproces, standaard scoped naar workspace + +### Allowlists + +Kanalen kunnen toegang beperken per user ID: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Expliciete allowlist +``` + +### Encryptie + +- **Matrix E2EE** — volledige end-to-end encryptie met apparaatverificatie +- **TLS Transport** — alle API en tunnel verkeer gebruikt HTTPS/TLS + +Zie [Beveiligingsdocumentatie](docs/security/README.md) voor volledig beleid en praktijken. + +## Observeerbaarheid + +ZeroClaw logt naar `~/.zeroclaw/workspace/logs/` standaard. Logs worden per component opgeslagen: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Daemon logs (startup, API verzoeken, fouten) +├── agent.log # Agent logs (bericht routing, tool uitvoering) +├── telegram.log # Kanaal-specifieke logs (indien ingeschakeld) +└── matrix.log # Kanaal-specifieke logs (indien ingeschakeld) +``` + +### Logging Configuratie + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # Voor grootte-gebaseerde rotatie +retention_days = 30 # Automatische opruiming na N dagen +``` + +Zie [Configuratie Referentie](docs/config-reference.md#logging) voor alle logging-opties. + +### Metrieken (Gepland) + +Prometheus metrieken ondersteuning voor productie monitoring komt binnenkort. Tracking in [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Vaardigheden + +ZeroClaw ondersteunt aangepaste vaardigheden — herbruikbare modules die systeemmogelijkheden uitbreiden. + +### Vaardigheidsdefinitie + +Vaardigheden worden opgeslagen in `~/.zeroclaw/workspace/skills/<skill-name>/` met deze structuur: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Vaardigheidsmetadata (naam, beschrijving, afhankelijkheden) + ├── prompt.md # Systeem prompt voor de AI + └── tools/ # Optionele aangepaste tools + └── my_tool.py +``` + +### Vaardigheidsvoorbeeld + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Zoekt op het web en vat resultaten samen" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Je bent een onderzoeksassistent. Wanneer gevraagd wordt om iets te onderzoeken: + +1. Gebruik web_fetch om inhoud op te halen +2. Vat resultaten samen in een gemakkelijk leesbaar formaat +3. Citeer bronnen met URL's +``` + +### Vaardigheidsgebruik + +Vaardigheden worden automatisch geladen bij agent startup. Referentie ze bij naam in gesprekken: + +``` +Gebruiker: Gebruik de web-research vaardigheid om het laatste AI nieuws te vinden +Bot: [laadt web-research vaardigheid, voert web_fetch uit, vat resultaten samen] +``` + +Zie [Vaardigheden](#vaardigheden) sectie voor volledige vaardigheidscreatie-instructies. + +## Open Skills + +ZeroClaw ondersteunt [Open Skills](https://github.com/openagents-com/open-skills) — een modulair en provider-agnostisch systeem voor het uitbreiden van AI-agent mogelijkheden. + +### Open Skills Inschakelen + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # optioneel +``` + +Je kunt ook tijdens runtime overschrijven met `ZEROCLAW_OPEN_SKILLS_ENABLED` en `ZEROCLAW_OPEN_SKILLS_DIR`. + +## Ontwikkeling + +```bash +cargo build # Dev build +cargo build --release # Release build (codegen-units=1, werkt op alle apparaten inclusief Raspberry Pi) +cargo build --profile release-fast # Snellere build (codegen-units=8, vereist 16 GB+ RAM) +cargo test # Voer volledige test suite uit +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Formaat + +# Voer SQLite vs Markdown vergelijkingsbenchmark uit +cargo test --test memory_comparison -- --nocapture +``` + +### Pre-push hook + +Een git hook voert `cargo fmt --check`, `cargo clippy -- -D warnings`, en `cargo test` uit voor elke push. Schakel het één keer in: + +```bash +git config core.hooksPath .githooks +``` + +### Build Probleemoplossing (OpenSSL fouten op Linux) + +Als je een `openssl-sys` build fout tegenkomt, synchroniseer afhankelijkheden en compileer opnieuw met de repository's lockfile: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw is geconfigureerd om `rustls` te gebruiken voor HTTP/TLS afhankelijkheden; `--locked` houdt de transitieve grafiek deterministisch in schone omgevingen. + +Om de hook over te slaan wanneer je een snelle push nodig hebt tijdens ontwikkeling: + +```bash +git push --no-verify +``` + +## Samenwerking & Docs + +Begin met de documentatie hub voor een taak-gebaseerde kaart: + +- Documentatie Hub: [`docs/README.md`](docs/README.md) +- Geünificeerde Docs TOC: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Commando's Referentie: [`docs/commands-reference.md`](docs/commands-reference.md) +- Configuratie Referentie: [`docs/config-reference.md`](docs/config-reference.md) +- Providers Referentie: [`docs/providers-reference.md`](docs/providers-reference.md) +- Kanalen Referentie: [`docs/channels-reference.md`](docs/channels-reference.md) +- Operations Runbook: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Probleemoplossing: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Docs Inventaris/Classificatie: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- PR/Issue Triage Snapshot (vanaf 18 feb. 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Belangrijkste samenwerkingsreferenties: + +- Documentatie Hub: [docs/README.md](docs/README.md) +- Documentatie Sjabloon: [docs/doc-template.md](docs/doc-template.md) +- Documentatiewijziging Checklist: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Kanaal Configuratie Referentie: [docs/channels-reference.md](docs/channels-reference.md) +- Matrix Versleutelde Kamer Operations: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Bijdrage Gids: [CONTRIBUTING.md](CONTRIBUTING.md) +- PR Workflow Beleid: [docs/pr-workflow.md](docs/pr-workflow.md) +- Reviewer Playbook (triage + diepgaande review): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Eigendom en CI Triage Kaart: [docs/ci-map.md](docs/ci-map.md) +- Beveiligingsopenbaarmaking Beleid: [SECURITY.md](SECURITY.md) + +Voor implementatie en runtime operaties: + +- Netwerk Implementatie Gids: [docs/network-deployment.md](docs/network-deployment.md) +- Proxy Agent Playbook: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## ZeroClaw Ondersteunen + +Als ZeroClaw je werk helpt en je de doorlopende ontwikkeling wilt ondersteunen, kun je hier doneren: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Koop Een Koffie Voor Mij" /></a> + +### 🙏 Speciale Dank + +Een oprechte dankjewel aan de gemeenschappen en instellingen die dit open-source werk inspireren en voeden: + +- **Harvard University** — voor het bevorderen van intellectuele nieuwsgierigheid en het verleggen van de grenzen van wat mogelijk is. +- **MIT** — voor het verdedigen van open kennis, open source, en de overtuiging dat technologie toegankelijk moet zijn voor iedereen. +- **Sundai Club** — voor de gemeenschap, energie, en de onophoudelijke wil om dingen te bouwen die ertoe doen. +- **De Wereld en Verder** 🌍✨ — aan elke bijdrager, dromer, en bouwer daarbuiten die open source tot een kracht voor goed maakt. Dit is voor jou. + +We bouwen in open source omdat de beste ideeën van overal komen. Als je dit leest, ben je er deel van. Welkom. 🦀❤️ + +## ⚠️ Officiële Repository en Implantatie Waarschuwing + +**Dit is de enige officiële ZeroClaw repository:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Elke andere repository, organisatie, domein of pakket dat beweert "ZeroClaw" te zijn of affiniteit met ZeroClaw Labs suggereert is **niet-geautoriseerd en niet gelieerd aan dit project**. Bekende niet-geautoriseerde forks worden vermeld in [TRADEMARK.md](TRADEMARK.md). + +Als je imitatie of handelsmerk misbruik tegenkomt, [open dan een issue](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Licentie + +ZeroClaw is dubbel gelicentieerd voor maximale openheid en bijdrager bescherming: + +| Licentie | Gebruiksscenario's | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Open-source, onderzoek, academisch, persoonlijk gebruik | +| [Apache 2.0](LICENSE-APACHE) | Patent bescherming, institutioneel, commerciële implementatie | + +Je kunt een van beide licenties kiezen. **Bijdragers verlenen automatisch rechten onder beide** — zie [CLA.md](CLA.md) voor de volledige bijdrager overeenkomst. + +### Handelsmerk + +De naam **ZeroClaw** en het logo zijn geregistreerde handelsmerken van ZeroClaw Labs. Deze licentie verleent geen toestemming om ze te gebruiken om goedkeuring of affiniteit te impliceren. Zie [TRADEMARK.md](TRADEMARK.md) voor toegestane en verboden gebruiksmogelijkheden. + +### Bijdrager Beschermingen + +- **Je behoudt auteursrechten** op je bijdragen +- **Patent verlening** (Apache 2.0) beschermt je tegen patent claims door andere bijdragers +- Je bijdragen worden **permanent toegeschreven** in de commit geschiedenis en [NOTICE](NOTICE) +- Geen handelsmerk rechten worden overgedragen door bij te dragen + +## Bijdragen + +Zie [CONTRIBUTING.md](CONTRIBUTING.md) en [CLA.md](CLA.md). Implementeer een trait, dien een PR in: + +- CI workflow gids: [docs/ci-map.md](docs/ci-map.md) +- Nieuwe `Provider` → `src/providers/` +- Nieuw `Channel` → `src/channels/` +- Nieuwe `Observer` → `src/observability/` +- Nieuwe `Tool` → `src/tools/` +- Nieuwe `Memory` → `src/memory/` +- Nieuwe `Tunnel` → `src/tunnel/` +- Nieuwe `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Nul overhead. Nul compromis. Implementeer overal. Wissel alles. 🦀 + +## Sterren Geschiedenis + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Sterren Geschiedenis Grafiek" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.pl.md b/README.pl.md new file mode 100644 index 000000000..520221c23 --- /dev/null +++ b/README.pl.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Zero narzutu. Zero kompromisów. 100% Rust. 100% Agnostyczny.</strong><br> + ⚡️ <strong>Działa na sprzęcie za $10 z <5MB RAM: To 99% mniej pamięci niż OpenClaw i 98% taniej niż Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Zbudowany przez studentów i członków społeczności Harvard, MIT i Sundai.Club. +</p> + +<p align="center"> + 🌐 <strong>Języki:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#szybki-start">Szybki Start</a> | + <a href="bootstrap.sh">Konfiguracja Jednym Kliknięciem</a> | + <a href="docs/README.md">Centrum Dokumentacji</a> | + <a href="docs/SUMMARY.md">Spis Treści Dokumentacji</a> +</p> + +<p align="center"> + <strong>Szybki dostęp:</strong> + <a href="docs/reference/README.md">Referencje</a> · + <a href="docs/operations/README.md">Operacje</a> · + <a href="docs/troubleshooting.md">Rozwiązywanie Problemów</a> · + <a href="docs/security/README.md">Bezpieczeństwo</a> · + <a href="docs/hardware/README.md">Sprzęt</a> · + <a href="docs/contributing/README.md">Wkład</a> +</p> + +<p align="center"> + <strong>Szybka, lekka i w pełni autonomiczna infrastruktura asystenta AI</strong><br /> + Wdrażaj wszędzie. Zamieniaj cokolwiek. +</p> + +<p align="center"> + ZeroClaw to <strong>system operacyjny runtime</strong> dla workflow agentów — infrastruktura abstrahująca modele, narzędzia, pamięć i wykonanie do budowania agentów raz i uruchamiania ich wszędzie. +</p> + +<p align="center"><code>Architektura oparta na traitach · bezpieczny runtime domyślnie · wymienny dostawca/kanał/narzędzie · wszystko jest podłączalne</code></p> + +### 📢 Ogłoszenia + +Użyj tej tabeli dla ważnych ogłoszeń (zmiany kompatybilności, powiadomienia bezpieczeństwa, okna serwisowe i blokady wersji). + +| Data (UTC) | Poziom | Ogłoszenie | Działanie | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Krytyczny_ | **Nie jesteśmy powiązani** z `openagen/zeroclaw` lub `zeroclaw.org`. Domena `zeroclaw.org` obecnie wskazuje na fork `openagen/zeroclaw`, i ta domena/repozytorium podszywa się pod naszą oficjalną stronę/projekt. | Nie ufaj informacjom, plikom binarnym, zbiórkom funduszy lub ogłoszeniom z tych źródeł. Używaj tylko [tego repozytorium](https://github.com/zeroclaw-labs/zeroclaw) i naszych zweryfikowanych kont społecznościowych. | +| 2026-02-21 | _Ważne_ | Nasza oficjalna strona jest teraz online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Dziękujemy za cierpliwość podczas oczekiwania. Nadal wykrywamy próby podszywania się: nie uczestnicz w żadnej działalności inwestycyjnej/finansowej w imieniu ZeroClaw jeśli nie jest opublikowana przez nasze oficjalne kanały. | Używaj [tego repozytorium](https://github.com/zeroclaw-labs/zeroclaw) jako jedynego źródła prawdy. Śledź [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (grupa)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), i [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) dla oficjalnych aktualizacji. | +| 2026-02-19 | _Ważne_ | Anthropic zaktualizował warunki używania uwierzytelniania i poświadczeń 2026-02-19. Uwierzytelnianie OAuth (Free, Pro, Max) jest wyłącznie dla Claude Code i Claude.ai; używanie tokenów OAuth Claude Free/Pro/Max w jakimkolwiek innym produkcie, narzędziu lub usłudze (w tym Agent SDK) nie jest dozwolone i może naruszać Warunki Użytkowania Konsumenta. | Prosimy tymczasowo unikać integracji OAuth Claude Code aby zapobiec potencjalnym stratom. Oryginalna klauzula: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Funkcje + +- 🏎️ **Lekki Runtime Domyślnie:** Typowe workflow CLI i komendy statusu działają w przestrzeni pamięci kilku megabajtów w buildach produkcyjnych. +- 💰 **Ekonomiczne Wdrażanie:** Zaprojektowane dla tanich płytek i małych instancji chmurowych bez ciężkich zależności runtime. +- ⚡ **Szybkie Zimne Starty:** Runtime Rust pojedynczego binarium utrzymuje start komend i daemonów niemal natychmiastowy dla codziennych operacji. +- 🌍 **Przenośna Architektura:** Pojedynczy workflow binarium na ARM, x86 i RISC-V z wymiennym dostawcą/kanałem/narzędziem. + +### Dlaczego zespoły wybierają ZeroClaw + +- **Lekki domyślnie:** mały binarium Rust, szybki start, niski ślad pamięci. +- **Bezpieczny przez design:** parowanie, ścisłe sandboxowanie, jawne listy dozwolone, zakres workspace. +- **Całkowicie wymienny:** systemy rdzenne to trait-y (dostawcy, kanały, narzędzia, pamięć, tunele). +- **Brak blokady dostawcy:** wsparcie dostawcy kompatybilnego z OpenAI + podłączalne własne endpointy. + +## Snapshot Benchmark (ZeroClaw vs OpenClaw, Reprodukowalne) + +Szybki benchmark na maszynie lokalnej (macOS arm64, luty 2026) znormalizowany dla sprzętu edge 0.8 GHz. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Język** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Start (rdzeń 0.8 GHz)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Rozmiar Binarny** | ~28 MB (dist) | N/A (Skrypty) | ~8 MB | **3.4 MB** | +| **Koszt** | Mac Mini $599 | Linux SBC ~$50 | Płytka Linux $10 | **Dowolny sprzęt $10** | + +> Uwagi: Wyniki ZeroClaw są mierzone na buildach produkcyjnych używając `/usr/bin/time -l`. OpenClaw wymaga runtime Node.js (typowo ~390 MB dodatkowego narzutu pamięci), podczas gdy NanoBot wymaga runtime Python. PicoClaw i ZeroClaw to statyczne binaria. Powyższe liczby RAM to pamięć runtime; wymagania kompilacji w czasie build są wyższe. + +<p align="center"> + <img src="zero-claw.jpeg" alt="Porównanie ZeroClaw vs OpenClaw" width="800" /> +</p> + +### Reprodukowalny Pomiar Lokalny + +Twierdzenia benchmark mogą się zmieniać wraz z ewolucją kodu i toolchainów, więc zawsze mierz swój aktualny build lokalnie: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Przykładowa próbka (macOS arm64, zmierzone 18 lutego 2026): + +- Rozmiar binarium release: `8.8M` +- `zeroclaw --help`: czas rzeczywisty ok. `0.02s`, szczytowy ślad pamięci ~`3.9 MB` +- `zeroclaw status`: czas rzeczywisty ok. `0.01s`, szczytowy ślad pamięci ~`4.1 MB` + +## Wymagania Wstępne + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Wymagane + +1. **Visual Studio Build Tools** (dostarcza linker MSVC i Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Podczas instalacji (lub przez Visual Studio Installer), wybierz obciążenie **"Desktop development with C++"**. + +2. **Toolchain Rust:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Po instalacji, otwórz nowy terminal i uruchom `rustup default stable` aby upewnić się, że stabilny toolchain jest aktywny. + +3. **Zweryfikuj** że oba działają: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Opcjonalne + +- **Docker Desktop** — wymagany tylko jeśli używasz [Docker sandboxed runtime](#aktualne-wsparcie-runtime) (`runtime.kind = "docker"`). Zainstaluj przez `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Wymagane + +1. **Niezbędne narzędzia build:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Zainstaluj Xcode Command Line Tools: `xcode-select --install` + +2. **Toolchain Rust:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Zobacz [rustup.rs](https://rustup.rs) dla szczegółów. + +3. **Zweryfikuj:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Opcjonalne + +- **Docker** — wymagany tylko jeśli używasz [Docker sandboxed runtime](#aktualne-wsparcie-runtime) (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** zobacz [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** zobacz [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** zainstaluj Docker Desktop przez [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Szybki Start + +### Opcja 1: Automatyczna konfiguracja (zalecana) + +Skrypt `bootstrap.sh` instaluje Rust, klonuje ZeroClaw, kompiluje go i konfiguruje twoje początkowe środowisko deweloperskie: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +To: + +1. Zainstaluje Rust (jeśli nieobecny) +2. Sklonuje repozytorium ZeroClaw +3. Skompiluje ZeroClaw w trybie release +4. Zainstaluje `zeroclaw` w `~/.cargo/bin/` +5. Utworzy domyślną strukturę workspace w `~/.zeroclaw/workspace/` +6. Wygeneruje początkowy plik konfiguracyjny `~/.zeroclaw/workspace/config.toml` + +Po bootstrap, przeładuj swój shell lub uruchom `source ~/.cargo/env` aby używać komendy `zeroclaw` globalnie. + +### Opcja 2: Ręczna instalacja + +<details> +<summary><strong>Kliknij aby zobaczyć kroki ręcznej instalacji</strong></summary> + +```bash +# 1. Sklonuj repozytorium +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Skompiluj w release +cargo build --release --locked + +# 3. Zainstaluj binarium +cargo install --path . --locked + +# 4. Zinicjuj workspace +zeroclaw init + +# 5. Zweryfikuj instalację +zeroclaw --version +zeroclaw status +``` + +</details> + +### Po Instalacji + +Po zainstalowaniu (przez bootstrap lub ręcznie), powinieneś widzieć: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Główna konfiguracja +├── .pairing # Sekrety parowania (generowane przy pierwszym uruchomieniu) +├── logs/ # Logi daemon/agent +├── skills/ # Własne umiejętności +└── memory/ # Przechowywanie kontekstu konwersacji +``` + +**Następne kroki:** + +1. Skonfiguruj swoich dostawców AI w `~/.zeroclaw/workspace/config.toml` +2. Sprawdź [referencje konfiguracji](docs/config-reference.md) dla opcji zaawansowanych +3. Uruchom agenta: `zeroclaw agent start` +4. Testuj przez preferowany kanał (zobacz [referencje kanałów](docs/channels-reference.md)) + +## Konfiguracja + +Edytuj `~/.zeroclaw/workspace/config.toml` aby skonfigurować dostawców, kanały i zachowanie systemu. + +### Szybka Referencja Konfiguracji + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # lub "sqlite" lub "none" + +[runtime] +kind = "native" # lub "docker" (wymaga Docker) +``` + +**Pełne dokumenty referencyjne:** + +- [Referencje Konfiguracji](docs/config-reference.md) — wszystkie ustawienia, walidacje, wartości domyślne +- [Referencje Dostawców](docs/providers-reference.md) — konfiguracje specyficzne dla dostawców AI +- [Referencje Kanałów](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord i więcej +- [Operacje](docs/operations-runbook.md) — monitoring produkcyjny, rotacja sekretów, skalowanie + +### Aktualne Wsparcie Runtime + +ZeroClaw wspiera dwa backendy wykonania kodu: + +- **`native`** (domyślnie) — bezpośrednie wykonanie procesu, najszybsza ścieżka, idealna dla zaufanych środowisk +- **`docker`** — pełna izolacja kontenera, wzmocnione polityki bezpieczeństwa, wymaga Docker + +Użyj `runtime.kind = "docker"` jeśli potrzebujesz ścisłego sandboxowania lub izolacji sieciowej. Zobacz [referencje konfiguracji](docs/config-reference.md#runtime) dla pełnych szczegółów. + +## Komendy + +```bash +# Zarządzanie workspace +zeroclaw init # Inicjuje nowy workspace +zeroclaw status # Pokazuje status daemon/agent +zeroclaw config validate # Weryfikuje składnię i wartości config.toml + +# Zarządzanie daemon +zeroclaw daemon start # Uruchamia daemon w tle +zeroclaw daemon stop # Zatrzymuje działający daemon +zeroclaw daemon restart # Restartuje daemon (przeładowanie config) +zeroclaw daemon logs # Pokazuje logi daemon + +# Zarządzanie agent +zeroclaw agent start # Uruchamia agenta (wymaga działającego daemon) +zeroclaw agent stop # Zatrzymuje agenta +zeroclaw agent restart # Restartuje agenta (przeładowanie config) + +# Operacje parowania +zeroclaw pairing init # Generuje nowy sekret parowania +zeroclaw pairing rotate # Rotuje istniejący sekret parowania + +# Tunneling (dla publicznej ekspozycji) +zeroclaw tunnel start # Uruchamia tunnel do lokalnego daemon +zeroclaw tunnel stop # Zatrzymuje aktywny tunnel + +# Diagnostyka +zeroclaw doctor # Uruchamia sprawdzenia zdrowia systemu +zeroclaw version # Pokazuje wersję i informacje o build +``` + +Zobacz [Referencje Komend](docs/commands-reference.md) dla pełnych opcji i przykładów. + +## Architektura + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Kanały (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Orchestrator Agent │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Routing │ │ Kontekst │ │ Wykonanie │ │ +│ │ Wiadomość │ │ Pamięć │ │ Narzędzie │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Dostawcy │ │ Pamięć │ │ Narzędzia │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Kluczowe zasady:** + +- Wszystko jest **trait** — dostawcy, kanały, narzędzia, pamięć, tunele +- Kanały wywołują orchestrator; orchestrator wywołuje dostawców + narzędzia +- System pamięci zarządza kontekstem konwersacji (markdown, SQLite, lub brak) +- Runtime abstrahuje wykonanie kodu (natywny lub Docker) +- Brak blokady dostawcy — zamieniaj Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama bez zmian kodu + +Zobacz [dokumentację architektury](docs/architecture.svg) dla szczegółowych diagramów i szczegółów implementacji. + +## Przykłady + +### Bot Telegram + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Twój Telegram user ID +``` + +Uruchom daemon + agent, a następnie wyślij wiadomość do swojego bota na Telegram: + +``` +/start +Cześć! Czy mógłbyś pomóc mi napisać skrypt Python? +``` + +Bot odpowiada kodem wygenerowanym przez AI, wykonuje narzędzia jeśli wymagane i utrzymuje kontekst konwersacji. + +### Matrix (szyfrowanie end-to-end) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Zaproś `@zeroclaw:matrix.org` do zaszyfrowanego pokoju, a bot odpowie z pełnym szyfrowaniem. Zobacz [Przewodnik Matrix E2EE](docs/matrix-e2ee-guide.md) dla konfiguracji weryfikacji urządzenia. + +### Multi-Dostawca + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover przy błędzie dostawcy +``` + +Jeśli Anthropic zawiedzie lub ma rate-limit, orchestrator automatycznie przełącza się na OpenAI. + +### Własna Pamięć + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Automatyczne czyszczenie po 90 dniach +``` + +Lub użyj Markdown dla przechowywania czytelnego dla ludzi: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Zobacz [Referencje Konfiguracji](docs/config-reference.md#memory) dla wszystkich opcji pamięci. + +## Wsparcie Dostawców + +| Dostawca | Status | API Key | Przykładowe Modele | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Stabilny | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Stabilny | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Stabilny | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Stabilny | N/A (lokalny) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Stabilny | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Stabilny | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Planowany | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Planowany | `COHERE_API_KEY` | TBD | + +### Własne Endpointy + +ZeroClaw wspiera endpointy kompatybilne z OpenAI: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Przykład: użyj [LiteLLM](https://github.com/BerriAI/litellm) jako proxy aby uzyskać dostęp do każdego LLM przez interfejs OpenAI. + +Zobacz [Referencje Dostawców](docs/providers-reference.md) dla pełnych szczegółów konfiguracji. + +## Wsparcie Kanałów + +| Kanał | Status | Uwierzytelnianie | Uwagi | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Stabilny | Bot Token | Pełne wsparcie w tym pliki, obrazy, przyciski inline | +| **Matrix** | ✅ Stabilny | Hasło lub Token | Wsparcie E2EE z weryfikacją urządzenia | +| **Slack** | 🚧 Planowany | OAuth lub Bot Token | Wymaga dostępu do workspace | +| **Discord** | 🚧 Planowany | Bot Token | Wymaga uprawnień guild | +| **WhatsApp** | 🚧 Planowany | Twilio lub oficjalne API | Wymaga konta business | +| **CLI** | ✅ Stabilny | Brak | Bezpośredni interfejs konwersacyjny | +| **Web** | 🚧 Planowany | API Key lub OAuth | Interfejs czatu oparty na przeglądarce | + +Zobacz [Referencje Kanałów](docs/channels-reference.md) dla pełnych instrukcji konfiguracji. + +## Wsparcie Narzędzi + +ZeroClaw dostarcza wbudowane narzędzia do wykonania kodu, dostępu do systemu plików i pobierania web: + +| Narzędzie | Opis | Wymagany Runtime | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Wykonuje komendy shell | Natywny lub Docker | +| **python** | Wykonuje skrypty Python | Python 3.8+ (natywny) lub Docker | +| **javascript** | Wykonuje kod Node.js | Node.js 18+ (natywny) lub Docker | +| **filesystem_read** | Odczytuje pliki | Natywny lub Docker | +| **filesystem_write** | Zapisuje pliki | Natywny lub Docker | +| **web_fetch** | Pobiera treści web | Natywny lub Docker | + +### Bezpieczeństwo Wykonania + +- **Natywny Runtime** — działa jako proces użytkownika daemon, pełny dostęp do systemu plików +- **Docker Runtime** — pełna izolacja kontenera, oddzielne systemy plików i sieci + +Skonfiguruj politykę wykonania w `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Jawna lista dozwolona +``` + +Zobacz [Referencje Konfiguracji](docs/config-reference.md#runtime) dla pełnych opcji bezpieczeństwa. + +## Wdrażanie + +### Lokalne Wdrażanie (Rozwój) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Serwerowe Wdrażanie (Produkcja) + +Użyj systemd do zarządzania daemon i agent jako usługi: + +```bash +# Zainstaluj binarium +cargo install --path . --locked + +# Skonfiguruj workspace +zeroclaw init + +# Utwórz pliki usług systemd +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Włącz i uruchom usługi +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Zweryfikuj status +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Zobacz [Przewodnik Wdrażania Sieciowego](docs/network-deployment.md) dla pełnych instrukcji wdrażania produkcyjnego. + +### Docker + +```bash +# Zbuduj obraz +docker build -t zeroclaw:latest . + +# Uruchom kontener +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Zobacz [`Dockerfile`](Dockerfile) dla szczegółów budowania i opcji konfiguracji. + +### Sprzęt Edge + +ZeroClaw jest zaprojektowany do działania na sprzęcie niskiego poboru mocy: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, pojedynczy rdzeń ARMv8, < $5 koszt sprzętu +- **Raspberry Pi 4/5** — 1 GB+ RAM, wielordzeniowy, idealny dla równoczesnych obciążeń +- **Orange Pi Zero 2** — ~512 MB RAM, czterordzeniowy ARMv8, ultra-niski koszt +- **SBC x86 (Intel N100)** — 4-8 GB RAM, szybkie buildy, natywne wsparcie Docker + +Zobacz [Przewodnik Sprzętowy](docs/hardware/README.md) dla instrukcji konfiguracji specyficznych dla urządzenia. + +## Tunneling (Publiczna Ekspozycja) + +Exponuj swoj lokalny daemon ZeroClaw do sieci publicznej przez bezpieczne tunele: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Wspierani dostawcy tunnel: + +- **Cloudflare Tunnel** — darmowy HTTPS, brak ekspozycji portów, wsparcie multi-domenowe +- **Ngrok** — szybka konfiguracja, własne domeny (plan płatny) +- **Tailscale** — prywatna sieć mesh, brak publicznego portu + +Zobacz [Referencje Konfiguracji](docs/config-reference.md#tunnel) dla pełnych opcji konfiguracji. + +## Bezpieczeństwo + +ZeroClaw implementuje wiele warstw bezpieczeństwa: + +### Parowanie + +Daemon generuje sekret parowania przy pierwszym uruchomieniu przechowywany w `~/.zeroclaw/workspace/.pairing`. Klienci (agent, CLI) muszą przedstawić ten sekret aby się połączyć. + +```bash +zeroclaw pairing rotate # Generuje nowy sekret i unieważnia stary +``` + +### Sandbox + +- **Docker Runtime** — pełna izolacja kontenera z oddzielnymi systemami plików i sieciami +- **Natywny Runtime** — działa jako proces użytkownika, domyślnie ograniczony do workspace + +### Listy Dozwolone + +Kanały mogą ograniczać dostęp po ID użytkownika: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Jawna lista dozwolona +``` + +### Szyfrowanie + +- **Matrix E2EE** — pełne szyfrowanie end-to-end z weryfikacją urządzenia +- **Transport TLS** — cały ruch API i tunnel używa HTTPS/TLS + +Zobacz [Dokumentację Bezpieczeństwa](docs/security/README.md) dla pełnych polityk i praktyk. + +## Obserwowalność + +ZeroClaw loguje do `~/.zeroclaw/workspace/logs/` domyślnie. Logi są przechowywane po komponentach: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Logi daemon (startup, żądania API, błędy) +├── agent.log # Logi agent (routing wiadomości, wykonanie narzędzi) +├── telegram.log # Logi specyficzne dla kanału (jeśli włączone) +└── matrix.log # Logi specyficzne dla kanału (jeśli włączone) +``` + +### Konfiguracja Logowania + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # Dla rotacji opartej na rozmiarze +retention_days = 30 # Automatyczne czyszczenie po N dniach +``` + +Zobacz [Referencje Konfiguracji](docs/config-reference.md#logging) dla wszystkich opcji logowania. + +### Metryki (Planowane) + +Wsparcie metryk Prometheus dla monitoringu produkcyjnego wkrótce. Śledzenie w [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Umiejętności + +ZeroClaw wspiera własne umiejętności — wielokrotnego użytku moduły rozszerzające możliwości systemu. + +### Definicja Umiejętności + +Umiejętności są przechowywane w `~/.zeroclaw/workspace/skills/<skill-name>/` z tą strukturą: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Metadane umiejętności (nazwa, opis, zależności) + ├── prompt.md # Prompt systemowy dla AI + └── tools/ # Opcjonalne własne narzędzia + └── my_tool.py +``` + +### Przykład Umiejętności + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Szuka w web i podsumowuje wyniki" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Jesteś asystentem badawczym. Kiedy proszą o zbadanie czegoś: + +1. Użyj web_fetch aby pobrać treść +2. Podsumuj wyniki w łatwym do czytania formacie +3. Zacytuj źródła z URL-ami +``` + +### Użycie Umiejętności + +Umiejętności są automatycznie ładowane przy starcie agenta. Odwołuj się do nich po nazwie w konwersacjach: + +``` +Użytkownik: Użyj umiejętności web-research aby znaleźć najnowsze wiadomości AI +Bot: [ładuje umiejętność web-research, wykonuje web_fetch, podsumowuje wyniki] +``` + +Zobacz sekcję [Umiejętności](#umiejętności) dla pełnych instrukcji tworzenia umiejętności. + +## Open Skills + +ZeroClaw wspiera [Open Skills](https://github.com/openagents-com/open-skills) — modułowy i agnostyczny względem dostawcy system do rozszerzania możliwości agentów AI. + +### Włącz Open Skills + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # opcjonalne +``` + +Możesz też nadpisać w runtime używając `ZEROCLAW_OPEN_SKILLS_ENABLED` i `ZEROCLAW_OPEN_SKILLS_DIR`. + +## Rozwój + +```bash +cargo build # Build deweloperski +cargo build --release # Build release (codegen-units=1, działa na wszystkich urządzeniach w tym Raspberry Pi) +cargo build --profile release-fast # Szybszy build (codegen-units=8, wymaga 16 GB+ RAM) +cargo test # Uruchom pełny zestaw testów +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Formatowanie + +# Uruchom benchmark porównawczy SQLite vs Markdown +cargo test --test memory_comparison -- --nocapture +``` + +### Hook pre-push + +Hook git uruchamia `cargo fmt --check`, `cargo clippy -- -D warnings`, i `cargo test` przed każdym push. Włącz go raz: + +```bash +git config core.hooksPath .githooks +``` + +### Rozwiązywanie Problemów Build (błędy OpenSSL na Linux) + +Jeśli napotkasz błąd build `openssl-sys`, zsynchronizuj zależności i przekompiluj z lockfile repozytorium: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw jest skonfigurowany do używania `rustls` dla zależności HTTP/TLS; `--locked` utrzymuje graf przechodni deterministyczny w czystych środowiskach. + +Aby pominąć hook gdy potrzebujesz szybkiego push podczas rozwoju: + +```bash +git push --no-verify +``` + +## Współpraca i Docs + +Zacznij od centrum dokumentacji dla mapy opartej na zadaniach: + +- Centrum Dokumentacji: [`docs/README.md`](docs/README.md) +- Zunifikowany Spis Treści Docs: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Referencje Komend: [`docs/commands-reference.md`](docs/commands-reference.md) +- Referencje Konfiguracji: [`docs/config-reference.md`](docs/config-reference.md) +- Referencje Dostawców: [`docs/providers-reference.md`](docs/providers-reference.md) +- Referencje Kanałów: [`docs/channels-reference.md`](docs/channels-reference.md) +- Runbook Operacji: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Rozwiązywanie Problemów: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Inwentarz/Klasyfikacja Docs: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- Snapshot Triages PR/Issue (stan na 18 lutego 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Główne referencje współpracy: + +- Centrum Dokumentacji: [docs/README.md](docs/README.md) +- Szablon Dokumentacji: [docs/doc-template.md](docs/doc-template.md) +- Checklist Zmiany Dokumentacji: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Referencje Konfiguracji Kanałów: [docs/channels-reference.md](docs/channels-reference.md) +- Operacje Zaszyfrowanych Pokoi Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Przewodnik Wkładu: [CONTRIBUTING.md](CONTRIBUTING.md) +- Polityka Workflow PR: [docs/pr-workflow.md](docs/pr-workflow.md) +- Playbook Recenzenta (triage + głęboka recenzja): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Mapa Własności i Triages CI: [docs/ci-map.md](docs/ci-map.md) +- Polityka Ujawnienia Bezpieczeństwa: [SECURITY.md](SECURITY.md) + +Dla wdrażania i operacji runtime: + +- Przewodnik Wdrażania Sieciowego: [docs/network-deployment.md](docs/network-deployment.md) +- Playbook Proxy Agent: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## Wspieraj ZeroClaw + +Jeśli ZeroClaw pomaga twojej pracy i chcesz wspierać ciągły rozwój, możesz przekazać darowiznę tutaj: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Kup Mi Kawę" /></a> + +### 🙏 Specjalne Podziękowania + +Serdeczne podziękowania dla społeczności i instytucji które inspirują i zasilają tę pracę open-source: + +- **Harvard University** — za promowanie intelektualnej ciekawości i przesuwanie granic tego co możliwe. +- **MIT** — za obronę otwartej wiedzy, open source, i przekonania że technologia powinna być dostępna dla wszystkich. +- **Sundai Club** — za społeczność, energię, i nieustanną wolę budowania rzeczy które mają znaczenie. +- **Świat i Dalej** 🌍✨ — dla każdego kontrybutora, marzyciela, i budowniczego tam na zewnątrz który czyni open source siłą dla dobra. To dla ciebie. + +Budujemy w open source ponieważ najlepsze pomysły przychodzą zewsząd. Jeśli to czytasz, jesteś tego częścią. Witamy. 🦀❤️ + +## ⚠️ Oficjalne Repozytorium i Ostrzeżenie o Podszywaniu Się + +**To jest jedyne oficjalne repozytorium ZeroClaw:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Jakiekolwiek inne repozytorium, organizacja, domena lub pakiet twierdzący że jest "ZeroClaw" lub sugerujący powiązanie z ZeroClaw Labs jest **nieautoryzowany i niepowiązany z tym projektem**. Znane nieautoryzowane forki będą wymienione w [TRADEMARK.md](TRADEMARK.md). + +Jeśli napotkasz podszywanie się lub nadużycie znaku towarowego, proszę [otwórz issue](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Licencja + +ZeroClaw jest podwójnie licencjonowany dla maksymalnej otwartości i ochrony kontrybutorów: + +| Licencja | Przypadki Użycia | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Open-source, badania, akademicki, użycie osobiste | +| [Apache 2.0](LICENSE-APACHE) | Ochrona patentowa, instytucjonalne, wdrożenie komercyjne | + +Możesz wybrać jedną z licencji. **Kontrybutorzy automatycznie przyznają prawa pod obiema** — zobacz [CLA.md](CLA.md) dla pełnej umowy kontrybutora. + +### Znak Towarowy + +Nazwa **ZeroClaw** i logo są zarejestrowanymi znakami towarowymi ZeroClaw Labs. Ta licencja nie przyznaje pozwolenia na ich używanie do sugerowania poparcia lub powiązania. Zobacz [TRADEMARK.md](TRADEMARK.md) dla dozwolonych i zabronionych użyć. + +### Ochrony Kontrybutorów + +- **Zachowuj prawa autorskie** swoich wkładów +- **Grant patentowy** (Apache 2.0) chroni cię przed roszczeniami patentowymi innych kontrybutorów +- Twoje wkłady są **trwale przypisane** w historii commitów i [NOTICE](NOTICE) +- Żadne prawa znaku towarowego nie są przenoszone przez kontrybucję + +## Wkład + +Zobacz [CONTRIBUTING.md](CONTRIBUTING.md) i [CLA.md](CLA.md). Zaimplementuj trait, prześlij PR: + +- Przewodnik workflow CI: [docs/ci-map.md](docs/ci-map.md) +- Nowy `Provider` → `src/providers/` +- Nowy `Channel` → `src/channels/` +- Nowy `Observer` → `src/observability/` +- Nowe `Tool` → `src/tools/` +- Nowa `Memory` → `src/memory/` +- Nowy `Tunnel` → `src/tunnel/` +- Nowa `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Zero narzutu. Zero kompromisów. Wdrażaj wszędzie. Zamieniaj cokolwiek. 🦀 + +## Historia Gwiazdek + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Wykres Historii Gwiazdek" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.pt.md b/README.pt.md new file mode 100644 index 000000000..d1313cf59 --- /dev/null +++ b/README.pt.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Zero sobrecarga. Zero compromisso. 100% Rust. 100% Agnóstico.</strong><br> + ⚡️ <strong>Roda em hardware de $10 com <5MB de RAM: Isso é 99% menos memória que o OpenClaw e 98% mais barato que um Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Construído por estudantes e membros das comunidades Harvard, MIT e Sundai.Club. +</p> + +<p align="center"> + 🌐 <strong>Idiomas:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#início-rápido">Início Rápido</a> | + <a href="bootstrap.sh">Configuração com Um Clique</a> | + <a href="docs/README.md">Hub de Documentação</a> | + <a href="docs/SUMMARY.md">Índice de Documentação</a> +</p> + +<p align="center"> + <strong>Acessos rápidos:</strong> + <a href="docs/reference/README.md">Referência</a> · + <a href="docs/operations/README.md">Operações</a> · + <a href="docs/troubleshooting.md">Solução de Problemas</a> · + <a href="docs/security/README.md">Segurança</a> · + <a href="docs/hardware/README.md">Hardware</a> · + <a href="docs/contributing/README.md">Contribuir</a> +</p> + +<p align="center"> + <strong>Infraestrutura de assistente AI rápida, leve e totalmente autônoma</strong><br /> + Implante em qualquer lugar. Troque qualquer coisa. +</p> + +<p align="center"> + ZeroClaw é o <strong>sistema operacional de runtime</strong> para fluxos de trabalho de agentes — uma infraestrutura que abstrai modelos, ferramentas, memória e execução para construir agentes uma vez e executá-los em qualquer lugar. +</p> + +<p align="center"><code>Arquitetura baseada em traits · runtime seguro por padrão · provedor/canal/ferramenta intercambiáveis · tudo é conectável</code></p> + +### 📢 Anúncios + +Use esta tabela para avisos importantes (mudanças de compatibilidade, avisos de segurança, janelas de manutenção e bloqueios de versão). + +| Data (UTC) | Nível | Aviso | Ação | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Crítico_ | **Não somos afiliados** ao `openagen/zeroclaw` ou `zeroclaw.org`. O domínio `zeroclaw.org` atualmente aponta para o fork `openagen/zeroclaw`, e este domínio/repositório está falsificando nosso site/projeto oficial. | Não confie em informações, binários, arrecadações ou anúncios dessas fontes. Use apenas [este repositório](https://github.com/zeroclaw-labs/zeroclaw) e nossas contas sociais verificadas. | +| 2026-02-21 | _Importante_ | Nosso site oficial agora está online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Obrigado pela paciência durante a espera. Ainda detectamos tentativas de falsificação: não participe de nenhuma atividade de investimento/financiamento em nome do ZeroClaw se não for publicada através de nossos canais oficiais. | Use [este repositório](https://github.com/zeroclaw-labs/zeroclaw) como a única fonte de verdade. Siga [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (grupo)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), e [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) para atualizações oficiais. | +| 2026-02-19 | _Importante_ | A Anthropic atualizou os termos de uso de autenticação e credenciais em 2026-02-19. A autenticação OAuth (Free, Pro, Max) é exclusivamente para Claude Code e Claude.ai; o uso de tokens OAuth do Claude Free/Pro/Max em qualquer outro produto, ferramenta ou serviço (incluindo Agent SDK) não é permitido e pode violar os Termos de Uso do Consumidor. | Por favor, evite temporariamente as integrações OAuth do Claude Code para prevenir qualquer perda potencial. Cláusula original: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Funcionalidades + +- 🏎️ **Runtime Leve por Padrão:** Fluxos de trabalho CLI comuns e comandos de status rodam dentro de um espaço de memória de poucos megabytes em builds de produção. +- 💰 **Implantação Econômica:** Projetado para placas de baixo custo e pequenas instâncias cloud sem dependências de runtime pesadas. +- ⚡ **Inícios a Frio Rápidos:** O runtime Rust de binário único mantém o início de comandos e daemons quase instantâneo para operações diárias. +- 🌍 **Arquitetura Portátil:** Um fluxo de trabalho de binário único em ARM, x86 e RISC-V com provedor/canal/ferramenta intercambiáveis. + +### Por que as equipes escolhem o ZeroClaw + +- **Leve por padrão:** binário Rust pequeno, início rápido, baixa pegada de memória. +- **Seguro por design:** emparelhamento, sandboxing estrito, listas de permissão explícitas, escopo de workspace. +- **Totalmente intercambiável:** os sistemas principais são traits (provedores, canais, ferramentas, memória, túneis). +- **Sem lock-in de provedor:** suporte de provedor compatível com OpenAI + endpoints personalizados conectáveis. + +## Instantâneo de Benchmark (ZeroClaw vs OpenClaw, Reproduzível) + +Benchmark rápido em máquina local (macOS arm64, fev. 2026) normalizado para hardware edge de 0.8 GHz. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Linguagem** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Início (núcleo 0.8 GHz)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Tamanho Binário** | ~28 MB (dist) | N/A (Scripts) | ~8 MB | **3.4 MB** | +| **Custo** | Mac Mini $599 | Linux SBC ~$50 | Placa Linux $10 | **Qualquer hardware $10** | + +> Notas: Os resultados do ZeroClaw são medidos em builds de produção usando `/usr/bin/time -l`. O OpenClaw requer o runtime Node.js (tipicamente ~390 MB de sobrecarga de memória adicional), enquanto o NanoBot requer o runtime Python. PicoClaw e ZeroClaw são binários estáticos. As cifras de RAM acima são memória de runtime; os requisitos de compilação em tempo de build são maiores. + +<p align="center"> + <img src="zero-claw.jpeg" alt="Comparação ZeroClaw vs OpenClaw" width="800" /> +</p> + +### Medição Local Reproduzível + +As alegações de benchmark podem derivar à medida que o código e as toolchains evoluem, então sempre meça seu build atual localmente: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Exemplo de amostra (macOS arm64, medido em 18 de fevereiro de 2026): + +- Tamanho do binário release: `8.8M` +- `zeroclaw --help`: tempo real aprox `0.02s`, pegada de memória máxima ~`3.9 MB` +- `zeroclaw status`: tempo real aprox `0.01s`, pegada de memória máxima ~`4.1 MB` + +## Pré-requisitos + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Obrigatório + +1. **Visual Studio Build Tools** (fornece o linker MSVC e o Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Durante a instalação (ou via Visual Studio Installer), selecione a carga de trabalho **"Desenvolvimento Desktop com C++"**. + +2. **Toolchain Rust:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Após a instalação, abra um novo terminal e execute `rustup default stable` para garantir que a toolchain estável esteja ativa. + +3. **Verifique** que ambos funcionam: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Opcional + +- **Docker Desktop** — obrigatório apenas se você usar o [runtime Docker sandboxed](#suporte-de-runtime-atual) (`runtime.kind = "docker"`). Instale via `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Obrigatório + +1. **Ferramentas de build essenciais:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Instale as Xcode Command Line Tools: `xcode-select --install` + +2. **Toolchain Rust:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Veja [rustup.rs](https://rustup.rs) para detalhes. + +3. **Verifique:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Opcional + +- **Docker** — obrigatório apenas se você usar o [runtime Docker sandboxed](#suporte-de-runtime-atual) (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** veja [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** veja [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** instale o Docker Desktop via [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Início Rápido + +### Opção 1: Configuração automatizada (recomendada) + +O script `bootstrap.sh` instala Rust, clona ZeroClaw, compila, e configura seu ambiente de desenvolvimento inicial: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Isso vai: + +1. Instalar Rust (se não presente) +2. Clonar o repositório ZeroClaw +3. Compilar ZeroClaw em modo release +4. Instalar `zeroclaw` em `~/.cargo/bin/` +5. Criar a estrutura de workspace padrão em `~/.zeroclaw/workspace/` +6. Gerar um arquivo de configuração inicial `~/.zeroclaw/workspace/config.toml` + +Após o bootstrap, recarregue seu shell ou execute `source ~/.cargo/env` para usar o comando `zeroclaw` globalmente. + +### Opção 2: Instalação manual + +<details> +<summary><strong>Clique para ver os passos de instalação manual</strong></summary> + +```bash +# 1. Clone o repositório +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Compile em release +cargo build --release --locked + +# 3. Instale o binário +cargo install --path . --locked + +# 4. Inicialize o workspace +zeroclaw init + +# 5. Verifique a instalação +zeroclaw --version +zeroclaw status +``` + +</details> + +### Após a instalação + +Uma vez instalado (via bootstrap ou manualmente), você deve ver: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Configuração principal +├── .pairing # Segredos de emparelhamento (gerado no primeiro início) +├── logs/ # Logs de daemon/agent +├── skills/ # Habilidades personalizadas +└── memory/ # Armazenamento de contexto conversacional +``` + +**Próximos passos:** + +1. Configure seus provedores de AI em `~/.zeroclaw/workspace/config.toml` +2. Confira a [referência de configuração](docs/config-reference.md) para opções avançadas +3. Inicie o agente: `zeroclaw agent start` +4. Teste via seu canal preferido (veja [referência de canais](docs/channels-reference.md)) + +## Configuração + +Edite `~/.zeroclaw/workspace/config.toml` para configurar provedores, canais e comportamento do sistema. + +### Referência de Configuração Rápida + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # ou "sqlite" ou "none" + +[runtime] +kind = "native" # ou "docker" (requer Docker) +``` + +**Documentos de referência completos:** + +- [Referência de Configuração](docs/config-reference.md) — todas as configurações, validações, valores padrão +- [Referência de Provedores](docs/providers-reference.md) — configurações específicas de provedores de AI +- [Referência de Canais](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord e mais +- [Operações](docs/operations-runbook.md) — monitoramento em produção, rotação de segredos, escalonamento + +### Suporte de Runtime (atual) + +ZeroClaw suporta dois backends de execução de código: + +- **`native`** (padrão) — execução de processo direta, caminho mais rápido, ideal para ambientes confiáveis +- **`docker`** — isolamento completo de container, políticas de segurança reforçadas, requer Docker + +Use `runtime.kind = "docker"` se você precisar de sandboxing estrito ou isolamento de rede. Veja [referência de configuração](docs/config-reference.md#runtime) para detalhes completos. + +## Comandos + +```bash +# Gestão de workspace +zeroclaw init # Inicializa um novo workspace +zeroclaw status # Mostra status de daemon/agent +zeroclaw config validate # Verifica sintaxe e valores do config.toml + +# Gestão de daemon +zeroclaw daemon start # Inicia o daemon em segundo plano +zeroclaw daemon stop # Para o daemon em execução +zeroclaw daemon restart # Reinicia o daemon (recarga de config) +zeroclaw daemon logs # Mostra logs do daemon + +# Gestão de agent +zeroclaw agent start # Inicia o agent (requer daemon rodando) +zeroclaw agent stop # Para o agent +zeroclaw agent restart # Reinicia o agent (recarga de config) + +# Operações de emparelhamento +zeroclaw pairing init # Gera um novo segredo de emparelhamento +zeroclaw pairing rotate # Rotaciona o segredo de emparelhamento existente + +# Tunneling (para exposição pública) +zeroclaw tunnel start # Inicia um tunnel para o daemon local +zeroclaw tunnel stop # Para o tunnel ativo + +# Diagnóstico +zeroclaw doctor # Executa verificações de saúde do sistema +zeroclaw version # Mostra versão e informações de build +``` + +Veja [Referência de Comandos](docs/commands-reference.md) para opções e exemplos completos. + +## Arquitetura + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Canais (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Orquestrador Agent │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Roteamento │ │ Contexto │ │ Execução │ │ +│ │ Mensagem │ │ Memória │ │ Ferramenta │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Provedores │ │ Memória │ │ Ferramentas │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Princípios chave:** + +- Tudo é um **trait** — provedores, canais, ferramentas, memória, túneis +- Canais chamam o orquestrador; o orquestrador chama provedores + ferramentas +- O sistema de memória gerencia contexto conversacional (markdown, SQLite, ou nenhum) +- O runtime abstrai a execução de código (nativo ou Docker) +- Sem lock-in de provedor — troque Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama sem mudanças de código + +Veja [documentação de arquitetura](docs/architecture.svg) para diagramas detalhados e detalhes de implementação. + +## Exemplos + +### Bot do Telegram + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Seu ID de usuário do Telegram +``` + +Inicie o daemon + agent, então envie uma mensagem para seu bot no Telegram: + +``` +/start +Olá! Você poderia me ajudar a escrever um script Python? +``` + +O bot responde com código gerado por AI, executa ferramentas se solicitado, e mantém o contexto de conversação. + +### Matrix (criptografia ponta a ponta) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Convide `@zeroclaw:matrix.org` para uma sala criptografada, e o bot responderá com criptografia completa. Veja [Guia Matrix E2EE](docs/matrix-e2ee-guide.md) para configuração de verificação de dispositivo. + +### Multi-Provedor + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover em erro de provedor +``` + +Se Anthropic falhar ou tiver rate-limit, o orquestrador faz failover automaticamente para OpenAI. + +### Memória Personalizada + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Purga automática após 90 dias +``` + +Ou use Markdown para armazenamento legível por humanos: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Veja [Referência de Configuração](docs/config-reference.md#memory) para todas as opções de memória. + +## Suporte de Provedor + +| Provedor | Status | API Key | Modelos de Exemplo | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Estável | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Estável | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Estável | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Estável | N/A (local) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Estável | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Estável | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Planejado | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Planejado | `COHERE_API_KEY` | TBD | + +### Endpoints Personalizados + +ZeroClaw suporta endpoints compatíveis com OpenAI: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Exemplo: use [LiteLLM](https://github.com/BerriAI/litellm) como proxy para acessar qualquer LLM via interface OpenAI. + +Veja [Referência de Provedores](docs/providers-reference.md) para detalhes de configuração completos. + +## Suporte de Canal + +| Canal | Status | Autenticação | Notas | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Estável | Bot Token | Suporte completo incluindo arquivos, imagens, botões inline | +| **Matrix** | ✅ Estável | Senha ou Token | Suporte E2EE com verificação de dispositivo | +| **Slack** | 🚧 Planejado | OAuth ou Bot Token | Requer acesso ao workspace | +| **Discord** | 🚧 Planejado | Bot Token | Requer permissões de guild | +| **WhatsApp** | 🚧 Planejado | Twilio ou API oficial | Requer conta business | +| **CLI** | ✅ Estável | Nenhum | Interface conversacional direta | +| **Web** | 🚧 Planejado | API Key ou OAuth | Interface de chat baseada em navegador | + +Veja [Referência de Canais](docs/channels-reference.md) para instruções de configuração completas. + +## Suporte de Ferramentas + +ZeroClaw fornece ferramentas integradas para execução de código, acesso ao sistema de arquivos e recuperação web: + +| Ferramenta | Descrição | Runtime Requerido | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Executa comandos shell | Nativo ou Docker | +| **python** | Executa scripts Python | Python 3.8+ (nativo) ou Docker | +| **javascript** | Executa código Node.js | Node.js 18+ (nativo) ou Docker | +| **filesystem_read** | Lê arquivos | Nativo ou Docker | +| **filesystem_write** | Escreve arquivos | Nativo ou Docker | +| **web_fetch** | Obtém conteúdo web | Nativo ou Docker | + +### Segurança de Execução + +- **Runtime Nativo** — roda como processo de usuário do daemon, acesso completo ao sistema de arquivos +- **Runtime Docker** — isolamento completo de container, sistemas de arquivos e redes separados + +Configure a política de execução em `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Lista de permissão explícita +``` + +Veja [Referência de Configuração](docs/config-reference.md#runtime) para opções de segurança completas. + +## Implantação + +### Implantação Local (Desenvolvimento) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Implantação em Servidor (Produção) + +Use systemd para gerenciar o daemon e agent como serviços: + +```bash +# Instale o binário +cargo install --path . --locked + +# Configure o workspace +zeroclaw init + +# Crie arquivos de serviço systemd +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Habilite e inicie os serviços +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Verifique o status +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Veja [Guia de Implantação de Rede](docs/network-deployment.md) para instruções completas de implantação em produção. + +### Docker + +```bash +# Compile a imagem +docker build -t zeroclaw:latest . + +# Execute o container +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Veja [`Dockerfile`](Dockerfile) para detalhes de build e opções de configuração. + +### Hardware Edge + +ZeroClaw é projetado para rodar em hardware de baixo consumo: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, núcleo ARMv8 único, < $5 custo de hardware +- **Raspberry Pi 4/5** — 1 GB+ RAM, multi-núcleo, ideal para workloads concorrentes +- **Orange Pi Zero 2** — ~512 MB RAM, quad-core ARMv8, custo ultra-baixo +- **SBCs x86 (Intel N100)** — 4-8 GB RAM, builds rápidos, suporte Docker nativo + +Veja [Guia de Hardware](docs/hardware/README.md) para instruções de configuração específicas por dispositivo. + +## Tunneling (Exposição Pública) + +Exponha seu daemon ZeroClaw local à rede pública via túneis seguros: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Provedores de tunnel suportados: + +- **Cloudflare Tunnel** — HTTPS grátis, sem exposição de portas, suporte multi-domínio +- **Ngrok** — configuração rápida, domínios personalizados (plano pago) +- **Tailscale** — rede mesh privada, sem porta pública + +Veja [Referência de Configuração](docs/config-reference.md#tunnel) para opções de configuração completas. + +## Segurança + +ZeroClaw implementa múltiplas camadas de segurança: + +### Emparelhamento + +O daemon gera um segredo de emparelhamento no primeiro início armazenado em `~/.zeroclaw/workspace/.pairing`. Clientes (agent, CLI) devem apresentar este segredo para conectar. + +```bash +zeroclaw pairing rotate # Gera um novo segredo e invalida o anterior +``` + +### Sandboxing + +- **Runtime Docker** — isolamento completo de container com sistemas de arquivos e redes separados +- **Runtime Nativo** — roda como processo de usuário, com escopo de workspace por padrão + +### Listas de Permissão + +Canais podem restringir acesso por ID de usuário: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Lista de permissão explícita +``` + +### Criptografia + +- **Matrix E2EE** — criptografia ponta a ponta completa com verificação de dispositivo +- **Transporte TLS** — todo o tráfego de API e tunnel usa HTTPS/TLS + +Veja [Documentação de Segurança](docs/security/README.md) para políticas e práticas completas. + +## Observabilidade + +ZeroClaw registra logs em `~/.zeroclaw/workspace/logs/` por padrão. Os logs são armazenados por componente: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Logs do daemon (início, requisições API, erros) +├── agent.log # Logs do agent (roteamento de mensagens, execução de ferramentas) +├── telegram.log # Logs específicos do canal (se habilitado) +└── matrix.log # Logs específicos do canal (se habilitado) +``` + +### Configuração de Logging + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # Para rotação baseada em tamanho +retention_days = 30 # Purga automática após N dias +``` + +Veja [Referência de Configuração](docs/config-reference.md#logging) para todas as opções de logging. + +### Métricas (Planejado) + +Suporte a métricas Prometheus para monitoramento em produção em breve. Rastreamento em [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Habilidades (Skills) + +ZeroClaw suporta habilidades personalizadas — módulos reutilizáveis que estendem as capacidades do sistema. + +### Definição de Habilidade + +Habilidades são armazenadas em `~/.zeroclaw/workspace/skills/<skill-name>/` com esta estrutura: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Metadados da habilidade (nome, descrição, dependências) + ├── prompt.md # Prompt de sistema para a AI + └── tools/ # Ferramentas personalizadas opcionais + └── my_tool.py +``` + +### Exemplo de Habilidade + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Pesquisa na web e resume resultados" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Você é um assistente de pesquisa. Quando pedirem para pesquisar algo: + +1. Use web_fetch para obter o conteúdo +2. Resuma os resultados em um formato fácil de ler +3. Cite as fontes com URLs +``` + +### Uso de Habilidades + +Habilidades são carregadas automaticamente no início do agent. Referencie-as por nome em conversas: + +``` +Usuário: Use a habilidade web-research para encontrar as últimas notícias de AI +Bot: [carrega a habilidade web-research, executa web_fetch, resume resultados] +``` + +Veja seção [Habilidades (Skills)](#habilidades-skills) para instruções completas de criação de habilidades. + +## Open Skills + +ZeroClaw suporta [Open Skills](https://github.com/openagents-com/open-skills) — um sistema modular e agnóstico de provedores para estender capacidades de agentes AI. + +### Habilitar Open Skills + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # opcional +``` + +Você também pode sobrescrever em runtime com `ZEROCLAW_OPEN_SKILLS_ENABLED` e `ZEROCLAW_OPEN_SKILLS_DIR`. + +## Desenvolvimento + +```bash +cargo build # Build de desenvolvimento +cargo build --release # Build release (codegen-units=1, funciona em todos os dispositivos incluindo Raspberry Pi) +cargo build --profile release-fast # Build mais rápido (codegen-units=8, requer 16 GB+ RAM) +cargo test # Executa o suite de testes completo +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Formato + +# Executa o benchmark de comparação SQLite vs Markdown +cargo test --test memory_comparison -- --nocapture +``` + +### Hook pre-push + +Um hook de git executa `cargo fmt --check`, `cargo clippy -- -D warnings`, e `cargo test` antes de cada push. Ative-o uma vez: + +```bash +git config core.hooksPath .githooks +``` + +### Solução de Problemas de Build (erros OpenSSL no Linux) + +Se você encontrar um erro de build `openssl-sys`, sincronize dependências e recompile com o lockfile do repositório: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw está configurado para usar `rustls` para dependências HTTP/TLS; `--locked` mantém o grafo transitivo determinístico em ambientes limpios. + +Para pular o hook quando precisar de um push rápido durante desenvolvimento: + +```bash +git push --no-verify +``` + +## Colaboração e Docs + +Comece com o hub de documentação para um mapa baseado em tarefas: + +- Hub de Documentação: [`docs/README.md`](docs/README.md) +- Índice Unificado de Docs: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Referência de Comandos: [`docs/commands-reference.md`](docs/commands-reference.md) +- Referência de Configuração: [`docs/config-reference.md`](docs/config-reference.md) +- Referência de Provedores: [`docs/providers-reference.md`](docs/providers-reference.md) +- Referência de Canais: [`docs/channels-reference.md`](docs/channels-reference.md) +- Runbook de Operações: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Solução de Problemas: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Inventário/Classificação de Docs: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- Snapshot de Triage de PR/Issue (em 18 de fev. de 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Referências principais de colaboração: + +- Hub de Documentação: [docs/README.md](docs/README.md) +- Modelo de Documentação: [docs/doc-template.md](docs/doc-template.md) +- Checklist de Mudança de Documentação: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Referência de Configuração de Canais: [docs/channels-reference.md](docs/channels-reference.md) +- Operações de Salas Criptografadas Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Guia de Contribuição: [CONTRIBUTING.md](CONTRIBUTING.md) +- Política de Fluxo de Trabalho PR: [docs/pr-workflow.md](docs/pr-workflow.md) +- Playbook do Revisor (triage + revisão profunda): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Mapa de Propriedade e Triage CI: [docs/ci-map.md](docs/ci-map.md) +- Política de Divulgação de Segurança: [SECURITY.md](SECURITY.md) + +Para implantação e operações de runtime: + +- Guia de Implantação de Rede: [docs/network-deployment.md](docs/network-deployment.md) +- Playbook de Agent Proxy: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## Apoiar o ZeroClaw + +Se ZeroClaw ajuda seu trabalho e você deseja apoiar o desenvolvimento contínuo, você pode doar aqui: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Me Pague um Café" /></a> + +### 🙏 Agradecimentos Especiais + +Um sincero agradecimento às comunidades e instituições que inspiram e alimentam este trabalho de código aberto: + +- **Harvard University** — por fomentar a curiosidade intelectual e empurrar os limites do possível. +- **MIT** — por defender o conhecimento aberto, o código aberto, e a convicção de que a tecnologia deveria ser acessível a todos. +- **Sundai Club** — pela comunidade, energia, e vontade incessante de construir coisas que importam. +- **O Mundo e Além** 🌍✨ — a cada contribuidor, sonhador, e construtor lá fora que faz do código aberto uma força para o bem. Isso é por você. + +Construímos em código aberto porque as melhores ideias vêm de todo lugar. Se você está lendo isso, você é parte disso. Bem-vindo. 🦀❤️ + +## ⚠️ Repositório Oficial e Aviso de Falsificação + +**Este é o único repositório oficial do ZeroClaw:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Qualquer outro repositório, organização, domínio ou pacote que afirme ser "ZeroClaw" ou que implique afiliação com ZeroClaw Labs é **não autorizado e não é afiliado a este projeto**. Forks não autorizados conhecidos serão listados em [TRADEMARK.md](TRADEMARK.md). + +Se você encontrar falsificação ou uso indevido de marca, por favor [abra uma issue](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Licença + +ZeroClaw tem licença dupla para máxima abertura e proteção de contribuidores: + +| Licença | Casos de Uso | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Código aberto, pesquisa, acadêmico, uso pessoal | +| [Apache 2.0](LICENSE-APACHE) | Proteção de patentes, institucional, implantação comercial | + +Você pode escolher qualquer uma das licenças. **Os contribuidores concedem automaticamente direitos sob ambas** — veja [CLA.md](CLA.md) para o acordo de contribuidor completo. + +### Marca + +O nome **ZeroClaw** e o logo são marcas registradas da ZeroClaw Labs. Esta licença não concede permissão para usá-los para implicar aprovação ou afiliação. Veja [TRADEMARK.md](TRADEMARK.md) para usos permitidos e proibidos. + +### Proteções do Contribuidor + +- **Você mantém os direitos autorais** de suas contribuições +- **Concessão de patentes** (Apache 2.0) protege você contra reivindicações de patentes por outros contribuidores +- Suas contribuições são **atribuídas permanentemente** no histórico de commits e [NOTICE](NOTICE) +- Nenhum direito de marca é transferido ao contribuir + +## Contribuir + +Veja [CONTRIBUTING.md](CONTRIBUTING.md) e [CLA.md](CLA.md). Implemente um trait, envie uma PR: + +- Guia de fluxo de trabalho CI: [docs/ci-map.md](docs/ci-map.md) +- Novo `Provider` → `src/providers/` +- Novo `Channel` → `src/channels/` +- Novo `Observer` → `src/observability/` +- Novo `Tool` → `src/tools/` +- Nova `Memory` → `src/memory/` +- Novo `Tunnel` → `src/tunnel/` +- Nova `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Zero sobrecarga. Zero compromisso. Implante em qualquer lugar. Troque qualquer coisa. 🦀 + +## Histórico de Estrelas + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Gráfico de Histórico de Estrelas" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.ro.md b/README.ro.md new file mode 100644 index 000000000..7130e77c8 --- /dev/null +++ b/README.ro.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Zero overhead. Zero compromisuri. 100% Rust. 100% Agnostic.</strong><br> + ⚡️ <strong>Rulează pe hardware de $10 cu <5MB RAM: Asta e cu 99% mai puțină memorie decât OpenClaw și cu 98% mai ieftin decât un Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Limbi:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Ce este ZeroClaw? + +ZeroClaw este o infrastructură de asistent AI ușoară, mutabilă și extensibilă construită în Rust. Conectează diverși furnizori de LLM (Anthropic, OpenAI, Google, Ollama, etc.) printr-o interfață unificată și suportă multiple canale (Telegram, Matrix, CLI, etc.). + +### Caracteristici Principale + +- **🦀 Scris în Rust**: Performanță ridicată, siguranță a memoriei și abstracțiuni fără costuri +- **🔌 Agnostic față de furnizori**: Suportă OpenAI, Anthropic, Google Gemini, Ollama și alții +- **📱 Multi-canal**: Telegram, Matrix (cu E2EE), CLI și altele +- **🧠 Memorie modulară**: Backend-uri SQLite și Markdown +- **🛠️ Instrumente extensibile**: Adaugă instrumente personalizate cu ușurință +- **🔒 Securitate pe primul loc**: Reverse proxy, design axat pe confidențialitate + +--- + +## Start Rapid + +### Cerințe + +- Rust 1.70+ +- O cheie API de furnizor LLM (Anthropic, OpenAI, etc.) + +### Instalare + +```bash +# Clonează repository-ul +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Construiește +cargo build --release + +# Rulează +cargo run --release +``` + +### Cu Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Configurare + +ZeroClaw folosește un fișier de configurare YAML. În mod implicit, caută `config.yaml`. + +```yaml +# Furnizor implicit +provider: anthropic + +# Configurare furnizori +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Configurare memorie +memory: + backend: sqlite + path: data/memory.db + +# Configurare canale +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Documentație + +Pentru documentație detaliată, vezi: + +- [Hub Documentație](docs/README.md) +- [Referință Comenzi](docs/commands-reference.md) +- [Referință Furnizori](docs/providers-reference.md) +- [Referință Canale](docs/channels-reference.md) +- [Referință Configurare](docs/config-reference.md) + +--- + +## Contribuții + +Contribuțiile sunt binevenite! Te rugăm să citești [Ghidul de Contribuții](CONTRIBUTING.md). + +--- + +## Licență + +Acest proiect este licențiat dual: + +- MIT License +- Apache License, versiunea 2.0 + +Vezi [LICENSE-APACHE](LICENSE-APACHE) și [LICENSE-MIT](LICENSE-MIT) pentru detalii. + +--- + +## Comunitate + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Sponsori + +Dacă ZeroClaw îți este util, te rugăm să iei în considerare să ne cumperi o cafea: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.sv.md b/README.sv.md new file mode 100644 index 000000000..3ca4d45e5 --- /dev/null +++ b/README.sv.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Noll overhead. Noll kompromiss. 100% Rust. 100% Agnostisk.</strong><br> + ⚡️ <strong>Kör på $10 hårdvara med <5MB RAM: Det är 99% mindre minne än OpenClaw och 98% billigare än en Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Språk:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Vad är ZeroClaw? + +ZeroClaw är en lättvikts, föränderlig och utökningsbar AI-assistent-infrastruktur byggd i Rust. Den ansluter olika LLM-leverantörer (Anthropic, OpenAI, Google, Ollama, etc.) via ett enhetligt gränssnitt och stöder flera kanaler (Telegram, Matrix, CLI, etc.). + +### Huvudfunktioner + +- **🦀 Skrivet i Rust**: Hög prestanda, minnessäkerhet och nollkostnadsabstraktioner +- **🔌 Leverantörsagnostisk**: Stöder OpenAI, Anthropic, Google Gemini, Ollama och andra +- **📱 Multi-kanal**: Telegram, Matrix (med E2EE), CLI och andra +- **🧠 Pluggbart minne**: SQLite och Markdown-backends +- **🛠️ Utökningsbara verktyg**: Lägg enkelt till anpassade verktyg +- **🔒 Säkerhet först**: Omvänd proxy, integritetsförst-design + +--- + +## Snabbstart + +### Krav + +- Rust 1.70+ +- En LLM-leverantörs API-nyckel (Anthropic, OpenAI, etc.) + +### Installation + +```bash +# Klona repositoryt +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Bygg +cargo build --release + +# Kör +cargo run --release +``` + +### Med Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Konfiguration + +ZeroClaw använder en YAML-konfigurationsfil. Som standard letar den efter `config.yaml`. + +```yaml +# Standardleverantör +provider: anthropic + +# Leverantörskonfiguration +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Minneskonfiguration +memory: + backend: sqlite + path: data/memory.db + +# Kanalkonfiguration +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Dokumentation + +För detaljerad dokumentation, se: + +- [Dokumentationshubb](docs/README.md) +- [Kommandoreferens](docs/commands-reference.md) +- [Leverantörsreferens](docs/providers-reference.md) +- [Kanalreferens](docs/channels-reference.md) +- [Konfigurationsreferens](docs/config-reference.md) + +--- + +## Bidrag + +Bidrag är välkomna! Vänligen läs [Bidragsguiden](CONTRIBUTING.md). + +--- + +## Licens + +Detta projekt är dubbellicensierat: + +- MIT License +- Apache License, version 2.0 + +Se [LICENSE-APACHE](LICENSE-APACHE) och [LICENSE-MIT](LICENSE-MIT) för detaljer. + +--- + +## Community + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Sponsorer + +Om ZeroClaw är användbart för dig, vänligen överväg att köpa en kaffe till oss: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.th.md b/README.th.md new file mode 100644 index 000000000..48444c052 --- /dev/null +++ b/README.th.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>โอเวอร์เฮดเป็นศูนย์ ไม่มีการประนีประนอม 100% Rust 100% Agnostic</strong><br> + ⚡️ <strong>ทำงานบนฮาร์ดแวร์ $10 ด้วย RAM <5MB: ใช้หน่วยความจำน้อยกว่า OpenClaw 99% และถูกกว่า Mac mini 98%!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>ภาษา:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## ZeroClaw คืออะไร? + +ZeroClaw เป็นโครงสร้างพื้นฐานผู้ช่วย AI ที่มีน้ำหนักเบา ปรับเปลี่ยนได้ และขยายได้ สร้างด้วย Rust มันเชื่อมต่อผู้ให้บริการ LLM ต่างๆ (Anthropic, OpenAI, Google, Ollama ฯลฯ) ผ่านอินเทอร์เฟซแบบรวมและรองรับหลายช่องทาง (Telegram, Matrix, CLI ฯลฯ) + +### คุณสมบัติหลัก + +- **🦀 เขียนด้วย Rust**: ประสิทธิภาพสูง ความปลอดภัยของหน่วยความจำ และ abstraction แบบไม่มีค่าใช้จ่าย +- **🔌 Agnostic ต่อผู้ให้บริการ**: รองรับ OpenAI, Anthropic, Google Gemini, Ollama และอื่นๆ +- **📱 หลายช่องทาง**: Telegram, Matrix (พร้อม E2EE), CLI และอื่นๆ +- **🧠 หน่วยความจำแบบเสียบได้**: Backend แบบ SQLite และ Markdown +- **🛠️ เครื่องมือที่ขยายได้**: เพิ่มเครื่องมือที่กำหนดเองได้ง่าย +- **🔒 ความปลอดภัยเป็นอันดับหนึ่ง**: Reverse proxy, การออกแบบที่ให้ความสำคัญกับความเป็นส่วนตัว + +--- + +## เริ่มต้นอย่างรวดเร็ว + +### ข้อกำหนด + +- Rust 1.70+ +- API key ของผู้ให้บริการ LLM (Anthropic, OpenAI ฯลฯ) + +### การติดตั้ง + +```bash +# Clone repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Build +cargo build --release + +# Run +cargo run --release +``` + +### ด้วย Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## การกำหนดค่า + +ZeroClaw ใช้ไฟล์กำหนดค่า YAML โดยค่าเริ่มต้นจะค้นหา `config.yaml` + +```yaml +# ผู้ให้บริการเริ่มต้น +provider: anthropic + +# การกำหนดค่าผู้ให้บริการ +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# การกำหนดค่าหน่วยความจำ +memory: + backend: sqlite + path: data/memory.db + +# การกำหนดค่าช่องทาง +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## เอกสาร + +สำหรับเอกสารโดยละเอียด ดูที่: + +- [ศูนย์เอกสาร](docs/README.md) +- [ข้อมูลอ้างอิงคำสั่ง](docs/commands-reference.md) +- [ข้อมูลอ้างอิงผู้ให้บริการ](docs/providers-reference.md) +- [ข้อมูลอ้างอิงช่องทาง](docs/channels-reference.md) +- [ข้อมูลอ้างอิงการกำหนดค่า](docs/config-reference.md) + +--- + +## การมีส่วนร่วม + +ยินดีต้อนรับการมีส่วนร่วม! โปรดอ่าน [คู่มือการมีส่วนร่วม](CONTRIBUTING.md) + +--- + +## สัญญาอนุญาต + +โปรเจกต์นี้มีสัญญาอนุญาตคู่: + +- MIT License +- Apache License, เวอร์ชัน 2.0 + +ดู [LICENSE-APACHE](LICENSE-APACHE) และ [LICENSE-MIT](LICENSE-MIT) สำหรับรายละเอียด + +--- + +## ชุมชน + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## ผู้สนับสนุน + +หาก ZeroClaw มีประโยชน์สำหรับคุณ โปรดพิจารณาซื้อกาแฟให้เรา: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.tl.md b/README.tl.md new file mode 100644 index 000000000..5a4829941 --- /dev/null +++ b/README.tl.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Zero overhead. Zero compromise. 100% Rust. 100% Agnostic.</strong><br> + ⚡️ <strong>Tumatakbo sa $10 hardware na may <5MB RAM: Ito ay 99% mas kaunting memorya kaysa sa OpenClaw at 98% mas mura kaysa sa isang Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Binuo ng mga mag-aaral at miyembro ng Harvard, MIT, at Sundai.Club na komunidad. +</p> + +<p align="center"> + 🌐 <strong>Mga Wika:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#mabilis-na-pagsisimula">Mabilis na Pagsisimula</a> | + <a href="bootstrap.sh">One-Click na Setup</a> | + <a href="docs/README.md">Hub ng Dokumentasyon</a> | + <a href="docs/SUMMARY.md">Talaan ng Nilalaman</a> +</p> + +<p align="center"> + <strong>Mga mabilis na access:</strong> + <a href="docs/reference/README.md">Reference</a> · + <a href="docs/operations/README.md">Operations</a> · + <a href="docs/troubleshooting.md">Troubleshooting</a> · + <a href="docs/security/README.md">Security</a> · + <a href="docs/hardware/README.md">Hardware</a> · + <a href="docs/contributing/README.md">Mag-contribute</a> +</p> + +<p align="center"> + <strong>Mabilis, magaan, at ganap na autonomous na AI assistant infrastructure</strong><br /> + I-deploy kahit saan. I-swap ang anumang bagay. +</p> + +<p align="center"> + Ang ZeroClaw ay ang <strong>runtime operating system</strong> para sa agent workflows — isang infrastructure na nag-a-abstract ng mga modelo, tools, memory, at execution upang bumuo ng mga agent nang isang beses at patakbuhin ang mga ito kahit saan. +</p> + +<p align="center"><code>Trait-driven architecture · secure-by-default runtime · swappable provider/channel/tool · lahat ay pluggable</code></p> + +### 📢 Mga Anunsyo + +Gamitin ang talahanayang ito para sa mahahalagang paunawa (compatibility changes, security notices, maintenance windows, at version blocks). + +| Petsa (UTC) | Antas | Paunawa | Aksyon | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Kritikal_ | **Hindi kami kaugnay** sa `openagen/zeroclaw` o `zeroclaw.org`. Ang domain na `zeroclaw.org` ay kasalukuyang tumuturo sa fork na `openagen/zeroclaw`, at ang domain/repository na ito ay nanggagaya sa aming opisyal na website/proyekto. | Huwag magtiwala sa impormasyon, binaries, fundraising, o mga anunsyo mula sa mga pinagmulang ito. Gamitin lamang [ang repository na ito](https://github.com/zeroclaw-labs/zeroclaw) at aming mga verified social media accounts. | +| 2026-02-21 | _Mahalaga_ | Ang aming opisyal na website ay ngayon online: [zeroclawlabs.ai](https://zeroclawlabs.ai). Salamat sa iyong pasensya sa panahon ng paghihintay. Nakikita pa rin namin ang mga pagtatangka ng panliliko: huwag lumahok sa anumang investment/funding activity sa ngalan ng ZeroClaw kung hindi ito nai-publish sa pamamagitan ng aming mga opisyal na channel. | Gamitin [ang repository na ito](https://github.com/zeroclaw-labs/zeroclaw) bilang nag-iisang source of truth. Sundan [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (grupo)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), at [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) para sa mga opisyal na update. | +| 2026-02-19 | _Mahalaga_ | In-update ng Anthropic ang authentication at credential use terms noong 2026-02-19. Ang OAuth authentication (Free, Pro, Max) ay eksklusibo para sa Claude Code at Claude.ai; ang paggamit ng Claude Free/Pro/Max OAuth tokens sa anumang iba pang produkto, tool, o serbisyo (kasama ang Agent SDK) ay hindi pinapayagan at maaaring lumabag sa Consumer Terms of Use. | Mangyaring pansamantalang iwasan ang Claude Code OAuth integrations upang maiwasan ang anumang potensyal na pagkawala. Orihinal na clause: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Mga Tampok + +- 🏎️ **Lightweight Runtime by Default:** Ang mga karaniwang CLI workflows at status commands ay tumatakbo sa loob ng ilang megabytes ng memory footprint sa production builds. +- 💰 **Cost-Effective Deployment:** Dinisenyo para sa low-cost boards at maliliit na cloud instances nang walang mga heavy runtime dependencies. +- ⚡ **Fast Cold Starts:** Ang single-binary Rust runtime ay nagpapanatili ng command at daemon startup na halos instant para sa pang-araw-araw na operasyon. +- 🌍 **Portable Architecture:** Isang single-binary workflow sa ARM, x86, at RISC-V na may swappable na provider/channel/tool. + +### Bakit pinipili ng mga team ang ZeroClaw + +- **Lightweight by default:** maliit na Rust binary, mabilis na startup, mababang memory footprint. +- **Secure by design:** pairing, strict sandboxing, explicit allowlists, workspace scope. +- **Fully swappable:** ang core systems ay traits (providers, channels, tools, memory, tunnels). +- **No vendor lock-in:** OpenAI-compatible provider support + pluggable custom endpoints. + +## Benchmark Snapshot (ZeroClaw vs OpenClaw, Reproducible) + +Mabilis na benchmark sa lokal na machine (macOS arm64, Peb. 2026) na normalized para sa 0.8 GHz edge hardware. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Wika** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Startup (0.8 GHz core)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Binary Size** | ~28 MB (dist) | N/A (Scripts) | ~8 MB | **3.4 MB** | +| **Gastos** | Mac Mini $599 | Linux SBC ~$50 | Linux board $10 | **Kahit anong hardware $10** | + +> Mga Tala: Ang mga resulta ng ZeroClaw ay sinusukat sa production builds gamit ang `/usr/bin/time -l`. Ang OpenClaw ay nangangailangan ng Node.js runtime (typically ~390 MB additional memory overhead), habang ang NanoBot ay nangangailangan ng Python runtime. Ang PicoClaw at ZeroClaw ay static binaries. Ang mga RAM figure sa itaas ay runtime memory; ang build-time compilation requirements ay mas mataas. + +<p align="center"> + <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" /> +</p> + +### Reproducible Local Measurement + +Ang mga benchmark claim ay maaaring mag-drift habang ang code at toolchains ay nag-e-evolve, kaya palaging sukatin ang iyong current build locally: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Halimbawa ng sample (macOS arm64, nasukat noong Pebrero 18, 2026): + +- Release binary size: `8.8M` +- `zeroclaw --help`: real time na humigit-kumulang `0.02s`, peak memory footprint ~`3.9 MB` +- `zeroclaw status`: real time na humigit-kumulang `0.01s`, peak memory footprint ~`4.1 MB` + +## Mga Kinakailangan + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Kinakailangan + +1. **Visual Studio Build Tools** (nagbibigay ng MSVC linker at Windows SDK): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Sa panahon ng installation (o sa pamamagitan ng Visual Studio Installer), piliin ang **"Desktop development with C++"** workload. + +2. **Rust Toolchain:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Pagkatapos ng installation, magbukas ng bagong terminal at patakbuhin ang `rustup default stable` upang matiyak na ang stable toolchain ay aktibo. + +3. **I-verify** na ang pareho ay gumagana: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — Opsyonal + +- **Docker Desktop** — kinakailangan lamang kung gagamit ka ng [Docker sandboxed runtime](#current-runtime-support) (`runtime.kind = "docker"`). I-install sa pamamagitan ng `winget install Docker.DockerDesktop`. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Kinakailangan + +1. **Essential build tools:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** I-install ang Xcode Command Line Tools: `xcode-select --install` + +2. **Rust Toolchain:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Tingnan ang [rustup.rs](https://rustup.rs) para sa mga detalye. + +3. **I-verify:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — Opsyonal + +- **Docker** — kinakailangan lamang kung gagamit ka ng [Docker sandboxed runtime](#current-runtime-support) (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** tingnan ang [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) + - **Linux (Fedora/RHEL):** tingnan ang [docs.docker.com](https://docs.docker.com/engine/install/fedora/) + - **macOS:** i-install ang Docker Desktop sa pamamagitan ng [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) + +</details> + +## Mabilis na Pagsisimula + +### Option 1: Automated setup (inirerekomenda) + +Ang `bootstrap.sh` script ay nag-i-install ng Rust, nagi-clone ng ZeroClaw, nagi-compile, at nagse-set up ng iyong paunang development environment: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Ito ay: + +1. Mag-i-install ng Rust (kung wala) +2. Magi-clone ng ZeroClaw repository +3. Magi-compile ng ZeroClaw sa release mode +4. Mag-i-install ng `zeroclaw` sa `~/.cargo/bin/` +5. Gagawa ng default workspace structure sa `~/.zeroclaw/workspace/` +6. Gagawa ng paunang configuration file na `~/.zeroclaw/workspace/config.toml` + +Pagkatapos ng bootstrap, i-reload ang iyong shell o patakbuhin ang `source ~/.cargo/env` para gamitin ang `zeroclaw` command globally. + +### Option 2: Manual installation + +<details> +<summary><strong>I-click para makita ang mga manual installation steps</strong></summary> + +```bash +# 1. I-clone ang repository +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. I-compile sa release +cargo build --release --locked + +# 3. I-install ang binary +cargo install --path . --locked + +# 4. I-initialize ang workspace +zeroclaw init + +# 5. I-verify ang installation +zeroclaw --version +zeroclaw status +``` + +</details> + +### Pagkatapos ng Installation + +Kapag na-install (sa pamamagitan ng bootstrap o manual), dapat mong makita: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Main configuration +├── .pairing # Pairing secrets (generated on first launch) +├── logs/ # Daemon/agent logs +├── skills/ # Custom skills +└── memory/ # Conversation context storage +``` + +**Mga susunod na hakbang:** + +1. I-configure ang iyong AI providers sa `~/.zeroclaw/workspace/config.toml` +2. Tingnan ang [configuration reference](docs/config-reference.md) para sa advanced options +3. Simulan ang agent: `zeroclaw agent start` +4. I-test sa pamamagitan ng iyong preferred channel (tingnan ang [channels reference](docs/channels-reference.md)) + +## Configuration + +I-edit ang `~/.zeroclaw/workspace/config.toml` para i-configure ang providers, channels, at system behavior. + +### Quick Configuration Reference + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # o "sqlite" o "none" + +[runtime] +kind = "native" # o "docker" (nangangailangan ng Docker) +``` + +**Mga kumpletong reference document:** + +- [Configuration Reference](docs/config-reference.md) — lahat ng settings, validations, defaults +- [Providers Reference](docs/providers-reference.md) — AI provider-specific configurations +- [Channels Reference](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord, at higit pa +- [Operations](docs/operations-runbook.md) — production monitoring, secret rotation, scaling + +### Current Runtime Support + +Sinusuportahan ng ZeroClaw ang dalawang code execution backends: + +- **`native`** (default) — direct process execution, pinakamabilis na path, ideal para sa trusted environments +- **`docker`** — full container isolation, hardened security policies, nangangailangan ng Docker + +Gamitin ang `runtime.kind = "docker"` kung kailangan mo ng strict sandboxing o network isolation. Tingnan ang [configuration reference](docs/config-reference.md#runtime) para sa buong detalye. + +## Mga Command + +```bash +# Workspace management +zeroclaw init # Nag-initialize ng bagong workspace +zeroclaw status # Nagpapakita ng daemon/agent status +zeroclaw config validate # Nag-verify ng config.toml syntax at values + +# Daemon management +zeroclaw daemon start # Nagse-start ng daemon sa background +zeroclaw daemon stop # Naghihinto sa running daemon +zeroclaw daemon restart # Nagre-restart ng daemon (config reload) +zeroclaw daemon logs # Nagpapakita ng daemon logs + +# Agent management +zeroclaw agent start # Nagse-start ng agent (nangangailangan ng running daemon) +zeroclaw agent stop # Naghihinto sa agent +zeroclaw agent restart # Nagre-restart ng agent (config reload) + +# Pairing operations +zeroclaw pairing init # Nag-generate ng bagong pairing secret +zeroclaw pairing rotate # Nag-rotate ng existing pairing secret + +# Tunneling (para sa public exposure) +zeroclaw tunnel start # Nagse-start ng tunnel sa local daemon +zeroclaw tunnel stop # Naghihinto sa active tunnel + +# Diagnostics +zeroclaw doctor # Nagpapatakbo ng system health checks +zeroclaw version # Nagpapakita ng version at build info +``` + +Tingnan ang [Commands Reference](docs/commands-reference.md) para sa buong options at examples. + +## Architecture + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Channels (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Custom │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Agent Orchestrator │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Message │ │ Context │ │ Tool │ │ +│ │ Routing │ │ Memory │ │ Execution │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Providers │ │ Memory │ │ Tools │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ None │ │ Web Fetch │ +│ Ollama │ │ Custom │ │ Custom │ +│ Custom │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Runtime (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Mga pangunahing prinsipyo:** + +- Ang lahat ay isang **trait** — providers, channels, tools, memory, tunnels +- Ang mga channel ay tumatawag sa orchestrator; ang orchestrator ay tumatawag sa providers + tools +- Ang memory system ay nagmamaneho ng conversation context (markdown, SQLite, o none) +- Ang runtime ay nag-a-abstract ng code execution (native o Docker) +- Walang provider lock-in — i-swap ang Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama nang walang code changes + +Tingnan ang [architecture documentation](docs/architecture.svg) para sa mga detalyadong diagram at implementation details. + +## Mga Halimbawa + +### Telegram Bot + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Ang iyong Telegram user ID +``` + +Simulan ang daemon + agent, pagkatapos ay magpadala ng mensahe sa iyong bot sa Telegram: + +``` +/start +Hello! Could you help me write a Python script? +``` + +Ang bot ay tumutugon gamit ang AI-generated code, nagpapatupad ng mga tool kung hiniling, at nagpapanatili ng conversation context. + +### Matrix (end-to-end encryption) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Imbitahan ang `@zeroclaw:matrix.org` sa isang encrypted room, at ang bot ay tutugon gamit ang full encryption. Tingnan ang [Matrix E2EE Guide](docs/matrix-e2ee-guide.md) para sa device verification setup. + +### Multi-Provider + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Failover on provider error +``` + +Kung ang Anthropic ay mabigo o ma-rate-limit, ang orchestrator ay awtomatikong mag-failover sa OpenAI. + +### Custom Memory + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # Automatic purge after 90 days +``` + +O gamitin ang Markdown para sa human-readable storage: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Tingnan ang [Configuration Reference](docs/config-reference.md#memory) para sa lahat ng memory options. + +## Provider Support + +| Provider | Status | API Key | Example Models | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Stable | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Stable | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Stable | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Stable | N/A (local) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Stable | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Stable | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Planned | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Planned | `COHERE_API_KEY` | TBD | + +### Custom Endpoints + +Sinusuportahan ng ZeroClaw ang OpenAI-compatible endpoints: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Halimbawa: gamitin ang [LiteLLM](https://github.com/BerriAI/litellm) bilang proxy para ma-access ang anumang LLM sa pamamagitan ng OpenAI interface. + +Tingnan ang [Providers Reference](docs/providers-reference.md) para sa kumpletong configuration details. + +## Channel Support + +| Channel | Status | Authentication | Notes | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Stable | Bot Token | Full support including files, images, inline buttons | +| **Matrix** | ✅ Stable | Password or Token | E2EE support with device verification | +| **Slack** | 🚧 Planned | OAuth or Bot Token | Requires workspace access | +| **Discord** | 🚧 Planned | Bot Token | Requires guild permissions | +| **WhatsApp** | 🚧 Planned | Twilio or official API | Requires business account | +| **CLI** | ✅ Stable | None | Direct conversational interface | +| **Web** | 🚧 Planned | API Key or OAuth | Browser-based chat interface | + +Tingnan ang [Channels Reference](docs/channels-reference.md) para sa kumpletong configuration instructions. + +## Tool Support + +Nagbibigay ang ZeroClaw ng built-in tools para sa code execution, filesystem access, at web retrieval: + +| Tool | Description | Required Runtime | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Executes shell commands | Native or Docker | +| **python** | Executes Python scripts | Python 3.8+ (native) or Docker | +| **javascript** | Executes Node.js code | Node.js 18+ (native) or Docker | +| **filesystem_read** | Reads files | Native or Docker | +| **filesystem_write** | Writes files | Native or Docker | +| **web_fetch** | Fetches web content | Native or Docker | + +### Execution Security + +- **Native Runtime** — runs as daemon's user process, full filesystem access +- **Docker Runtime** — full container isolation, separate filesystems and networks + +I-configure ang execution policy sa `config.toml`: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Explicit allowlist +``` + +Tingnan ang [Configuration Reference](docs/config-reference.md#runtime) para sa kumpletong security options. + +## Deployment + +### Local Deployment (Development) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Server Deployment (Production) + +Gamitin ang systemd para mamaneho ang daemon at agent bilang services: + +```bash +# I-install ang binary +cargo install --path . --locked + +# I-configure ang workspace +zeroclaw init + +# Gumawa ng systemd service files +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# I-enable at i-start ang services +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# I-verify ang status +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Tingnan ang [Network Deployment Guide](docs/network-deployment.md) para sa kumpletong production deployment instructions. + +### Docker + +```bash +# I-build ang image +docker build -t zeroclaw:latest . + +# I-run ang container +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Tingnan ang [`Dockerfile`](Dockerfile) para sa build details at configuration options. + +### Edge Hardware + +Ang ZeroClaw ay dinisenyo para tumakbo sa low-power hardware: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, single ARMv8 core, < $5 hardware cost +- **Raspberry Pi 4/5** — 1 GB+ RAM, multi-core, ideal for concurrent workloads +- **Orange Pi Zero 2** — ~512 MB RAM, quad-core ARMv8, ultra-low cost +- **x86 SBCs (Intel N100)** — 4-8 GB RAM, fast builds, native Docker support + +Tingnan ang [Hardware Guide](docs/hardware/README.md) para sa device-specific setup instructions. + +## Tunneling (Public Exposure) + +I-expose ang iyong local ZeroClaw daemon sa public network sa pamamagitan ng secure tunnels: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Mga supported tunnel provider: + +- **Cloudflare Tunnel** — free HTTPS, no port exposure, multi-domain support +- **Ngrok** — quick setup, custom domains (paid plan) +- **Tailscale** — private mesh network, no public port + +Tingnan ang [Configuration Reference](docs/config-reference.md#tunnel) para sa kumpletong configuration options. + +## Security + +Nagpapatupad ang ZeroClaw ng maraming layer ng security: + +### Pairing + +Ang daemon ay nag-generate ng pairing secret sa unang launch na nakaimbak sa `~/.zeroclaw/workspace/.pairing`. Ang mga client (agent, CLI) ay dapat mag-present ng secret na ito para kumonekta. + +```bash +zeroclaw pairing rotate # Gagawa ng bagong secret at i-invalidate ang dati +``` + +### Sandboxing + +- **Docker Runtime** — full container isolation na may separate filesystems at networks +- **Native Runtime** — runs as user process, scoped sa workspace by default + +### Allowlists + +Ang mga channel ay maaaring mag-limit ng access by user ID: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Explicit allowlist +``` + +### Encryption + +- **Matrix E2EE** — full end-to-end encryption with device verification +- **TLS Transport** — all API and tunnel traffic uses HTTPS/TLS + +Tingnan ang [Security Documentation](docs/security/README.md) para sa kumpletong policies at practices. + +## Observability + +Ang ZeroClaw ay naglo-log sa `~/.zeroclaw/workspace/logs/` by default. Ang mga log ay nakaimbak by component: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Daemon logs (startup, API requests, errors) +├── agent.log # Agent logs (message routing, tool execution) +├── telegram.log # Channel-specific logs (if enabled) +└── matrix.log # Channel-specific logs (if enabled) +``` + +### Logging Configuration + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # daily, hourly, size +max_size_mb = 100 # For size-based rotation +retention_days = 30 # Automatic purge after N days +``` + +Tingnan ang [Configuration Reference](docs/config-reference.md#logging) para sa lahat ng logging options. + +### Metrics (Planned) + +Prometheus metrics support para sa production monitoring ay coming soon. Tracking sa [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234). + +## Skills + +Sinusuportahan ng ZeroClaw ang custom skills — reusable modules na nag-e-extend sa system capabilities. + +### Skill Definition + +Ang mga skill ay nakaimbak sa `~/.zeroclaw/workspace/skills/<skill-name>/` na may ganitong structure: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Skill metadata (name, description, dependencies) + ├── prompt.md # System prompt for the AI + └── tools/ # Optional custom tools + └── my_tool.py +``` + +### Skill Example + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Searches the web and summarizes results" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +You are a research assistant. When asked to research something: + +1. Use web_fetch to retrieve content +2. Summarize results in an easy-to-read format +3. Cite sources with URLs +``` + +### Skill Usage + +Ang mga skill ay automatically loaded sa agent startup. I-reference ang mga ito by name sa conversations: + +``` +User: Use the web-research skill to find the latest AI news +Bot: [loads web-research skill, executes web_fetch, summarizes results] +``` + +Tingnan ang [Skills](#skills) section para sa kumpletong skill creation instructions. + +## Open Skills + +Sinusuportahan ng ZeroClaw ang [Open Skills](https://github.com/openagents-com/open-skills) — isang modular at provider-agnostic system para sa pag-extend sa AI agent capabilities. + +### Enable Open Skills + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # optional +``` + +Maaari mo ring i-override sa runtime gamit ang `ZEROCLAW_OPEN_SKILLS_ENABLED` at `ZEROCLAW_OPEN_SKILLS_DIR`. + +## Development + +```bash +cargo build # Dev build +cargo build --release # Release build (codegen-units=1, works on all devices including Raspberry Pi) +cargo build --profile release-fast # Faster build (codegen-units=8, requires 16 GB+ RAM) +cargo test # Run full test suite +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Format + +# Run SQLite vs Markdown comparison benchmark +cargo test --test memory_comparison -- --nocapture +``` + +### Pre-push hook + +Ang isang git hook ay nagpapatakbo ng `cargo fmt --check`, `cargo clippy -- -D warnings`, at `cargo test` bago ang bawat push. I-enable ito nang isang beses: + +```bash +git config core.hooksPath .githooks +``` + +### Build Troubleshooting (OpenSSL errors on Linux) + +Kung makakita ka ng `openssl-sys` build error, i-sync ang dependencies at i-recompile gamit ang repository's lockfile: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +Ang ZeroClaw ay naka-configure na gumamit ng `rustls` para sa HTTP/TLS dependencies; ang `--locked` ay nagpapanatili sa transitive graph na deterministic sa clean environments. + +Para i-skip ang hook kapag kailangan mo ng quick push habang nagde-develop: + +```bash +git push --no-verify +``` + +## Collaboration & Docs + +Magsimula sa documentation hub para sa task-based map: + +- Documentation Hub: [`docs/README.md`](docs/README.md) +- Unified Docs TOC: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Commands Reference: [`docs/commands-reference.md`](docs/commands-reference.md) +- Configuration Reference: [`docs/config-reference.md`](docs/config-reference.md) +- Providers Reference: [`docs/providers-reference.md`](docs/providers-reference.md) +- Channels Reference: [`docs/channels-reference.md`](docs/channels-reference.md) +- Operations Runbook: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Troubleshooting: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Docs Inventory/Classification: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- PR/Issue Triage Snapshot (as of Feb 18, 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Mga pangunahing collaboration references: + +- Documentation Hub: [docs/README.md](docs/README.md) +- Documentation Template: [docs/doc-template.md](docs/doc-template.md) +- Documentation Change Checklist: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Channel Configuration Reference: [docs/channels-reference.md](docs/channels-reference.md) +- Matrix Encrypted Room Operations: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Contributing Guide: [CONTRIBUTING.md](CONTRIBUTING.md) +- PR Workflow Policy: [docs/pr-workflow.md](docs/pr-workflow.md) +- Reviewer Playbook (triage + deep review): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Ownership and CI Triage Map: [docs/ci-map.md](docs/ci-map.md) +- Security Disclosure Policy: [SECURITY.md](SECURITY.md) + +Para sa deployment at runtime operations: + +- Network Deployment Guide: [docs/network-deployment.md](docs/network-deployment.md) +- Proxy Agent Playbook: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## Suportahan ang ZeroClaw + +Kung tinutulungan ng ZeroClaw ang iyong trabaho at nais mong suportahan ang patuloy na development, maaari kang mag-donate dito: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Bilhan Mo Ako ng Kape" /></a> + +### 🙏 Special Thanks + +Isang taos-pusong pasasalamat sa mga komunidad at institusyon na nagbibigay-inspirasyon at nagpapakain sa open-source work na ito: + +- **Harvard University** — para sa pagpapaunlad ng intelektwal na kuryosidad at pagtulak sa mga hangganan ng kung ano ang posible. +- **MIT** — para sa pagtatanggol ng open knowledge, open source, at ang paniniwala na ang teknolohiya ay dapat na accessible sa lahat. +- **Sundai Club** — para sa komunidad, enerhiya, at ang walang-humpay na kagustuhang bumuo ng mga bagay na mahalaga. +- **Ang Mundo at Higit Pa** 🌍✨ — sa bawat contributor, dreamer, at builder doon sa labas na gumagawa ng open source bilang isang puwersa para sa kabutihan. Ito ay para sa iyo. + +Kami ay bumubuo sa open source dahil ang mga pinakamahusay na ideya ay nagmumula sa lahat ng dako. Kung binabasa mo ito, ikaw ay bahagi nito. Maligayang pagdating. 🦀❤️ + +## ⚠️ Official Repository at Impersonation Warning + +**Ito ang tanging opisyal na ZeroClaw repository:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +Ang anumang iba pang repository, organization, domain, o package na nagpapanggap na "ZeroClaw" o nagpapahiwatig ng affiliation sa ZeroClaw Labs ay **hindi awtorisado at hindi kaugnay sa proyektong ito**. Ang mga kilalang unauthorized forks ay ililista sa [TRADEMARK.md](TRADEMARK.md). + +Kung makakita ka ng impersonation o trademark misuse, mangyaring [magbukas ng isyu](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## License + +Ang ZeroClaw ay dual-licensed para sa maximum openness at contributor protection: + +| License | Use Cases | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Open-source, research, academic, personal use | +| [Apache 2.0](LICENSE-APACHE) | Patent protection, institutional, commercial deployment | + +Maaari mong piliin ang alinmang license. **Ang mga contributor ay awtomatikong nagbibigay ng rights sa ilalim ng pareho** — tingnan ang [CLA.md](CLA.md) para sa kumpletong contributor agreement. + +### Trademark + +Ang pangalang **ZeroClaw** at logo ay mga rehistradong trademark ng ZeroClaw Labs. Ang license na ito ay hindi nagbibigay ng pahintulot na gamitin ang mga ito upang ipahiwatig ang endorsement o affiliation. Tingnan ang [TRADEMARK.md](TRADEMARK.md) para sa mga allowed at prohibited uses. + +### Contributor Protections + +- **Mo namang pinapanatili** ang copyright ng iyong mga kontribusyon +- **Patent grant** (Apache 2.0) ay nagpoprotekta sa iyo laban sa patent claims ng ibang mga contributor +- Ang iyong mga kontribusyon ay **permanenteng naa-attributed** sa commit history at [NOTICE](NOTICE) +- Walang trademark rights ang naililipat sa pamamagitan ng pagko-contribute + +## Mag-contribute + +Tingnan ang [CONTRIBUTING.md](CONTRIBUTING.md) at [CLA.md](CLA.md). Mag-implement ng isang trait, mag-submit ng PR: + +- CI workflow guide: [docs/ci-map.md](docs/ci-map.md) +- Bagong `Provider` → `src/providers/` +- Bagong `Channel` → `src/channels/` +- Bagong `Observer` → `src/observability/` +- Bagong `Tool` → `src/tools/` +- Bagong `Memory` → `src/memory/` +- Bagong `Tunnel` → `src/tunnel/` +- Bagong `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Zero overhead. Zero compromise. Deploy anywhere. Swap anything. 🦀 + +## Star History + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Star History Graph" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.tr.md b/README.tr.md new file mode 100644 index 000000000..67bf481bd --- /dev/null +++ b/README.tr.md @@ -0,0 +1,914 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Sıfırı aşırı yok. Sıfır ödün ver yok. %100 Rust. %100 Agnostik.</strong><br> + ⚡️ <strong>$10 donanımla <5MB RAM ile çalışır: OpenClaw'dan %99 daha az bellek ve Mac mini'den %98 daha ucuz!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> + <a href="https://www.reddit.com/r/zeroclawlabs/"><img src="https://img.shields.io/badge/Reddit-r%2Fzeroclawlabs-FF4500?style=flat&logo=reddit&logoColor=white" alt="Reddit: r/zeroclawlabs" /></a> +</p> +<p align="center"> +Harvard, MIT ve Sundai.Club topluluklarının öğrencileri ve üyeleri tarafından inşa edilmiştir. +</p> + +<p align="center"> + 🌐 <strong>Diller:</strong><a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +<p align="center"> + <a href="#hızlı-başlangıç">Hızlı Başlangıç</a> | + <a href="bootstrap.sh">Tek Tıklama Kurulumu</a> | + <a href="docs/README.md">Dokümantasyon Merkezi</a> | + <a href="docs/SUMMARY.md">Dokümantasyon İçindekiler</a> +</p> + +<p align="center"> + <strong>Hızlı erişim:</strong> + <a href="docs/reference/README.md">Referans</a> · + <a href="docs/operations/README.md">Operasyonlar</a> · + <a href="docs/troubleshooting.md">Sorun Giderme</a> · + <a href="docs/security/README.md">Güvenlik</a> · + <a href="docs/hardware/README.md">Donanım</a> · + <a href="docs/contributing/README.md">Katkıda Bulunma</a> +</p> + +<p align="center"> + <strong>Hızlı, hafif ve tamamen otonom AI asistan altyapısı</strong><br /> + Her yerde dağıtın. Her şeyi değiştirin. +</p> + +<p align="center"> + ZeroClaw, ajan iş akışları için <strong>çalışma zamanı işletim sistemidir</strong> — modelleri, araçları, belleği ve yürütmeyi soyutlayan, ajanları bir kez oluşturup ve her yerde çalıştıran bir altyapıdır. +</p> + +<p align="center"><code>Trait tabanlı mimari · varsayılan olarak güvenli çalışma zamanı · değiştirilebilir sağlayıcı/kanal/araç · her şey eklenebilir</code></p> + +### 📢 Duyurular + +Önemli duyurular için bu tabloyu kullanın (uyumluluk değişiklikleri, güvenlik bildirimleri, bakım pencereleri ve sürüm engellemeleri). + +| Tarih (UTC) | Seviye | Duyuru | Eylem | +| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 2026-02-19 | _Kritik_ | **`openagen/zeroclaw` veya `zeroclaw.org` ile bağlantılı değiliz.** `zeroclaw.org` alanı şu anda `openagen/zeroclaw` fork'una işaret ediyor ve bu alan/depo taklitçiliğini yapıyor. | Bu kaynaklardan bilgi, ikili dosyalar, bağış toplama veya duyurulara güvenmeyin. Sadece [bu depoyu](https://github.com/zeroclaw-labs/zeroclaw) ve doğrulanmış sosyal medya hesaplarımızı kullanın. | +| 2026-02-21 | _Önemli_ | Resmi web sitemiz artık çevrimiçi: [zeroclawlabs.ai](https://zeroclawlabs.ai). Bekleme sürecinde sabırlarınız için teşekkürler. Hala taklit girişimleri tespit ediyoruz: ZeroClaw adına resmi kanallarımız aracılığıyla yayınlanmayan herhangi bir yatırım/bağış faaliyetine katılmayın. | [Bu depoyu](https://github.com/zeroclaw-labs/zeroclaw) tek doğruluk kaynağı olarak kullanın. Resmi güncellemeler için [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Facebook (grup)](https://www.facebook.com/groups/zeroclaw), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/) ve [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search)'u takip edin. | +| 2026-02-19 | _Önemli_ | Anthropic, 2026-02-19 tarihinde kimlik doğrulama ve kimlik bilgileri kullanım şartlarını güncelledi. OAuth kimlik doğrulaması (Free, Pro, Max) yalnızca Claude Code ve Claude.ai içindir; Claude Free/Pro/Max OAuth belirteçlerini başka herhangi bir ürün, araç veya hizmette (Agent SDK dahil) kullanmak yasaktır ve Tüketici Kullanım Şartlarını ihlal edebilir. | Olası kayıpları önlemek için lütfen geçici olarak Claude Code OAuth entegrasyonlarından kaçının. Orijinal madde: [Authentication and Credential Use](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Özellikler + +- 🏎️ **Varsayılan Hafif Çalışma Zamanı:** Yaygın CLI iş akışları ve durum komutları üretim derlemelerinde birkaç megabaytlık bellek alanında çalışır. +- 💰 **Maliyet Etkin Dağıtım:** Ağır çalışma zamanı bağımlılıkları olmadan düşük maliyetli kartlar ve küçük bulut örnekleri için tasarlanmıştır. +- 💡 **Hızlı Soğuk Başlangıçlar:** Tek ikili Rust çalışma zamanı, komut ve arka plan programı başlatmalarını günlük operasyonlar için neredeyse anlık tutar. +- 🌍 **Taşınabilir Mimari:** Değiştirilebilir sağlayıcı/kanal/araç ile ARM, x86 ve RISC-V üzerinde tek ikili iş akışı. + +### Neden ekipler ZeroClaw'ı seçiyor + +- **Varsayılan hafif:** küçük Rust ikilisi, hızlı başlangıç, düşük bellek ayak izi. +- **Tasarıma göre güvenli:** eşleştirme, katı kum alanı, açık izin listeleri, çalışma alanı kapsamı. +- **Tamamen değiştirilebilir:** çekirdek sistemler trait'tir (sağlayıcılar, kanallar, araçlar, bellek, tüneller). +- **Satıcı kilitlenmesi yok:** OpenAI uyumlu sağlayıcı desteği + eklenebilir özel uç noktalar. + +## Kıyaslama Anlık Görüntüsü (ZeroClaw vs OpenClaw, Tekrarlanabilir) + +Yerel makinede hızlı kıyaslama (macOS arm64, Şub. 2026) 0.8 GHz uç donanımı için normalize edilmiş. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +| ---------------------------- | ------------- | -------------- | --------------- | --------------------- | +| **Dil** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1 GB | > 100 MB | < 10 MB | **< 5 MB** | +| **Başlangıç (0.8 GHz çekirdek)** | > 500s | > 30s | < 1s | **< 10ms** | +| **İkili Boyut** | ~28 MB (dist) | Yok (Betikler) | ~8 MB | **3.4 MB** | +| **Maliyet** | Mac Mini $599 | Linux SBC ~$50 | Linux kart $10 | **Herhangi bir donanım $10** | + +> Notlar: ZeroClaw sonuçları `/usr/bin/time -l` kullanılarak üretim derlemelerinde ölçülür. OpenClaw Node.js çalışma zamanı gerektirir (tipik olarak ~390 MB ek bellek yükü), NanoBot ise Python çalışma zamanı gerektirir. PicoClaw ve ZeroClaw statik ikililerdir. Yukarıdaki RAM rakamları çalışma zamanı belleğidir; derleme zamanı derleme gereksinimleri daha yüksektir. + +<p align="center"> + <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Karşılaştırması" width="800" /> +</p> + +### Tekrarlanabilir Yerel Ölçüm + +Kıyaslama iddiaları kod ve araç zincirleri geliştikçe değişebilir, bu yüzden her zaman mevcut derlemenizi yerel olarak ölçün: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Örnek numune (macOS arm64, 18 Şubat 2026'da ölçüldü): + +- Sürüm ikili boyutu: `8.8M` +- `zeroclaw --help`: gerçek süre yaklaşık `0.02s`, en büyük bellek ayak izi ~`3.9 MB` +- `zeroclaw status`: gerçek süre yaklaşık `0.01s`, en büyük bellek ayak izi ~`4.1 MB` + +## Ön Koşullar + +<details> +<summary><strong>Windows</strong></summary> + +### Windows — Gerekli + +1. **Visual Studio Build Tools** (MSVC bağlayıcısını ve Windows SDK'yı sağlar): + + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + + Kurulum sırasında (veya Visual Studio Installer aracılığıyla), **"C++ ile Masaüstü Geliştirme"** iş yükünü seçin. + +2. **Rust Araç Zinciri:** + + ```powershell + winget install Rustlang.Rustup + ``` + + Kurulumdan sonra, yeni bir terminal açın ve kararlı araç zincirinin aktif olduğundan emin olmak için `rustup default stable` çalıştırın. + +3. **Doğrulayın** ikisinin de çalıştığını: + ```powershell + rustc --version + cargo --version + ``` + +### Windows — İsteğe Bağlı + +- **Docker Desktop** — yalnızca [Docker kum alanlı çalışma zamanı](#mevcut-çalışma-zamanı-desteği) kullanıyorsanız gereklidir (`runtime.kind = "docker"`). `winget install Docker.DockerDesktop` aracılığıyla yükleyin. + +</details> + +<details> +<summary><strong>Linux / macOS</strong></summary> + +### Linux / macOS — Gerekli + +1. **Temel derleme araçları:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Xcode Command Line Tools'u yükleyin: `xcode-select --install` + +2. **Rust Araç Zinciri:** + + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + + Detaylar için [rustup.rs](https://rustup.rs) adresine bakın. + +3. **Doğrulayın:** + ```bash + rustc --version + cargo --version + ``` + +### Linux / macOS — İsteğe Bağlı + +- **Docker** — yalnızca [Docker kum alanlı çalışma zamanı](#mevcut-çalışma-zamanı-desteği) kullanıyorsanız gereklidir (`runtime.kind = "docker"`). + - **Linux (Debian/Ubuntu):** [docs.docker.com](https://docs.docker.com/engine/install/ubuntu/) adresine bakın + - **Linux (Fedora/RHEL):** [docs.docker.com](https://docs.docker.com/engine/install/fedora/) adresine bakın + - **macOS:** [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/) adresinden Docker Desktop'u yükleyin + +</details> + +## Hızlı Başlangıç + +### Seçenek 1: Otomatik kurulum (önerilen) + +`bootstrap.sh` betiği Rust'u yükler, ZeroClaw'ı klonlar, derler ve ilk geliştirme ortamınızı ayarlar: + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +``` + +Bu işlem: + +1. Rust'u yükler (yoksa) +2. ZeroClaw deposunu klonlar +3. ZeroClaw'ı sürüm modunda derler +4. `zeroclaw`'ı `~/.cargo/bin/`e yükler +5. `~/.zeroclaw/workspace/` içinde varsayılan çalışma alanı yapısını oluşturur +6. Başlangıç `~/.zeroclaw/workspace/config.toml` yapılandırma dosyasını üretir + +Önyüklemeden sonra, `zeroclaw` komutunu global olarak kullanmak için kabuğunuzu yeniden yükleyin veya `source ~/.cargo/env` çalıştırın. + +### Seçenek 2: Manuel kurulum + +<details> +<summary><strong>Manuel kurulum adımlarını görmek için tıklayın</strong></summary> + +```bash +# 1. Depoyu klonla +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# 2. Sürüm olarak derle +cargo build --release --locked + +# 3. İkiliyi yükle +cargo install --path . --locked + +# 4. Çalışma alanını başlat +zeroclaw init + +# 5. Kurulumu doğrula +zeroclaw --version +zeroclaw status +``` + +</details> + +### Kurulumdan Sonra + +Kurulumdan sonra (önyükleme veya manuel olarak), şunları görmelisiniz: + +``` +~/.zeroclaw/workspace/ +├── config.toml # Ana yapılandırma +├── .pairing # Eşleştirme sırları (ilk başlangıçta oluşturulur) +├── logs/ # Arka plan programı/ajan logları +├── skills/ # Özel beceriler +└── memory/ # Konuşma bağlamı depolaması +``` + +**Sonraki adımlar:** + +1. AI sağlayıcılarınızı `~/.zeroclaw/workspace/config.toml` içinde yapılandırın +2. Gelişmiş seçenekler için [yapılandırma referansına](docs/config-reference.md) bakın +3. Ajanı başlatın: `zeroclaw agent start` +4. Tercih ettiğiniz kanal üzerinden test edin ([kanallar referansına](docs/channels-reference.md) bakın) + +## Yapılandırma + +Sağlayıcıları, kanalları ve sistem davranışını yapılandırmak için `~/.zeroclaw/workspace/config.toml` dosyasını düzenleyin. + +### Hızlı Yapılandırma Referansı + +```toml +[providers.anthropic] +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +api_key = "sk-..." +model = "gpt-4o" + +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." + +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@bot:matrix.org" +password = "..." + +[memory] +kind = "markdown" # veya "sqlite" veya "none" + +[runtime] +kind = "native" # veya "docker" (Docker gerektirir) +``` + +**Tam referans belgeleri:** + +- [Yapılandırma Referansı](docs/config-reference.md) — tüm ayarlar, doğrulamalar, varsayılanlar +- [Sağlayıcı Referansı](docs/providers-reference.md) — AI sağlayıcıya özgü yapılandırmalar +- [Kanallar Referansı](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord ve daha fazlası +- [Operasyonlar](docs/operations-runbook.md) — üretim izleme, sırları döndürme, ölçeklendirme + +### Mevcut Çalışma Zamanı Desteği + +ZeroClaw iki kod yürütme arka ucu destekler: + +- **`native`** (varsayılan) — doğrudan süreç yürütme, en hızlı yol, güvenilir ortamlar için ideal +- **`docker`** — tam konteyner yalıtımı. sertleştirilmiş güvenlik ilkeleri. Docker gerektirir + +Katı kum alanı veya ağ yalıtımı gerekiyorsa `runtime.kind = "docker"` kullanın. Tam detaylar için [yapılandırma referansına](docs/config-reference.md#runtime) bakın. + +## Komutlar + +```bash +# Çalışma alanı yönetimi +zeroclaw init # Yeni bir çalışma alanı başlatır +zeroclaw status # Arka plan programı/ajan durumunu gösterir +zeroclaw config validate # config.toml sözdizimini ve değerlerini doğrular + +# Arka plan programı yönetimi +zeroclaw daemon start # Arka plan programını arka planda başlatır +zeroclaw daemon stop # Çalışan arka plan programını durdurur +zeroclaw daemon restart # Arka plan programını yeniden başlatır (yapılandırmayı yeniden yükler) +zeroclaw daemon logs # Arka plan programı loglarını gösterir + +# Ajan yönetimi +zeroclaw agent start # Ajanı başlatır (çalışan arka plan programı gerektirir) +zeroclaw agent stop # Ajanı durdurur +zeroclaw agent restart # Ajanı yeniden başlatır (yapılandırmayı yeniden yükler) + +# Eşleştirme operasyonları +zeroclaw pairing init # Yeni bir eşleştirme sırrı oluşturur +zeroclaw pairing rotate # Mevcut eşleştirme sırrını döndürür + +# Tünelleme (herkese açık kullanım için) +zeroclaw tunnel start # Yerel arka plan programına bir tünel başlatır +zeroclaw tunnel stop # Aktif tüneli durdurur + +# Teşhis +zeroclaw doctor # Sistem sağlık kontrollerini çalıştırır +zeroclaw version # Sürüm ve derleme bilgilerini gösterir +``` + +Tam seçenekler ve örnekler için [Komutlar Referansına](docs/commands-reference.md) bakın. + +## Mimari + +``` +┌─────────────────────────────────────────────────────────────────┐ +│ Kanallar (trait) │ +│ Telegram │ Matrix │ Slack │ Discord │ Web │ CLI │ Özel │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Ajan Orkestratörü │ +│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ +│ │ Mesaj │ │ Bağlam │ │ Araç │ │ +│ │ Yönlendirme│ │ Bellek │ │ Yürütme │ │ +│ └──────────────┘ └──────────────┘ └──────────────┘ │ +└─────────────────────────┬───────────────────────────────────────┘ + │ + ┌───────────────┼───────────────┐ + ▼ ▼ ▼ +┌──────────────┐ ┌──────────────┐ ┌──────────────┐ +│ Sağlayıcılar│ │ Bellek │ │ Araçlar │ +│ (trait) │ │ (trait) │ │ (trait) │ +├──────────────┤ ├──────────────┤ ├──────────────┤ +│ Anthropic │ │ Markdown │ │ Filesystem │ +│ OpenAI │ │ SQLite │ │ Bash │ +│ Gemini │ │ Yok │ │ Web Fetch │ +│ Ollama │ │ Özel │ │ Özel │ +│ Özel │ └──────────────┘ └──────────────┘ +└──────────────┘ + │ + ▼ +┌─────────────────────────────────────────────────────────────────┐ +│ Çalışma Zamanı (trait) │ +│ Native │ Docker │ +└─────────────────────────────────────────────────────────────────┘ +``` + +**Temel ilkeler:** + +- Her şey bir **trait'tir** — sağlayıcılar, kanallar, araçlar, bellek, tüneller +- Kanallar orkestratörü çağırır; orkestratör sağlayıcıları + araçları çağırır +- Bellek sistemi konuşma bağlamını yönetir (markdown, SQLite veya yok) +- Çalışma zamanı kod yürütmeyi soyutlar (yerel veya Docker) +- Satıcı kilitlenmesi yok — kod değişikliği olmadan Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama değiştirin + +Detaylı diyagramlar ve uygulama detayları için [mimari belgelerine](docs/architecture.svg) bakın. + +## Örnekler + +### Telegram Bot + +```toml +[channels.telegram] +enabled = true +bot_token = "123456:ABC-DEF..." +allowed_users = [987654321] # Telegram kullanıcı ID'niz +``` + +Arka plan programını + ajanı başlatın, ardından Telegram'da botunuza bir mesaj gönderin: + +``` +/start +Merhaba! Bir Python betiği yazmama yardımcı olabilir misin? +``` + +Bot, AI tarafından oluşturulan kodla yanıt verir, istenirse araçları yürütür ve konuşma bağlamını korur. + +### Matrix (uçtan uca şifreleme) + +```toml +[channels.matrix] +enabled = true +homeserver_url = "https://matrix.org" +username = "@zeroclaw:matrix.org" +password = "..." +device_name = "zeroclaw-prod" +e2ee_enabled = true +``` + +Şifreli bir odaya `@zeroclaw:matrix.org` davet edin ve bot tam şifrelemeyle yanıt verecektir. Cihaz doğrulama kurulumu için [Matrix E2EE Kılavuzuna](docs/matrix-e2ee-guide.md) bakın. + +### Çoklu-Sağlayıcı + +```toml +[providers.anthropic] +enabled = true +api_key = "sk-ant-..." +model = "claude-sonnet-4-20250514" + +[providers.openai] +enabled = true +api_key = "sk-..." +model = "gpt-4o" + +[orchestrator] +default_provider = "anthropic" +fallback_providers = ["openai"] # Sağlayıcı hatasında geçiş +``` + +Anthropic başarısız olursa veya hız sınırına ulaşırsa, orkestratör otomatik olarak OpenAI'ya geçer. + +### Özel Bellek + +```toml +[memory] +kind = "sqlite" +path = "~/.zeroclaw/workspace/memory/conversations.db" +retention_days = 90 # 90 gün sonra otomatik temizleme +``` + +Veya insan tarafından okunabilir depolama için Markdown kullanın: + +```toml +[memory] +kind = "markdown" +path = "~/.zeroclaw/workspace/memory/" +``` + +Tüm bellek seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#memory) bakın. + +## Sağlayıcı Desteği + +| Sağlayıcı | Durum | API Anahtarı | Örnek Modeller | +| ----------------- | ----------- | ------------------- | ---------------------------------------------------- | +| **Anthropic** | ✅ Kararlı | `ANTHROPIC_API_KEY` | `claude-sonnet-4-20250514`, `claude-opus-4-20250514` | +| **OpenAI** | ✅ Kararlı | `OPENAI_API_KEY` | `gpt-4o`, `gpt-4o-mini`, `o1`, `o1-mini` | +| **Google Gemini** | ✅ Kararlı | `GOOGLE_API_KEY` | `gemini-2.0-flash-exp`, `gemini-exp-1206` | +| **Ollama** | ✅ Kararlı | Yok (yerel) | `llama3.3`, `qwen2.5`, `phi4` | +| **Cerebras** | ✅ Kararlı | `CEREBRAS_API_KEY` | `llama-3.3-70b` | +| **Groq** | ✅ Kararlı | `GROQ_API_KEY` | `llama-3.3-70b-versatile` | +| **Mistral** | 🚧 Planlanan | `MISTRAL_API_KEY` | TBD | +| **Cohere** | 🚧 Planlanan | `COHERE_API_KEY` | TBD | + +### Özel Uç Noktalar + +ZeroClaw, OpenAI uyumlu uç noktaları destekler: + +```toml +[providers.custom] +enabled = true +api_key = "..." +base_url = "https://api.your-llm-provider.com/v1" +model = "your-model-name" +``` + +Örnek: herhangi bir LLM'ye OpenAI arayüzü üzerinden erişmek için [LiteLLM](https://github.com/BerriAI/litellm)'i proxy olarak kullanın. + +Tam yapılandırma detayları için [Sağlayıcı Referansına](docs/providers-reference.md) bakın. + +## Kanal Desteği + +| Kanal | Durum | Kimlik Doğrulama | Notlar | +| ------------ | ----------- | ------------------------ | --------------------------------------------------------- | +| **Telegram** | ✅ Kararlı | Bot Token | Dosyalar, resimler, satır içi düğmeler dahil tam destek | +| **Matrix** | ✅ Kararlı | Şifre veya Token | Cihaz doğrulamalı E2EE desteği | +| **Slack** | 🚧 Planlanan | OAuth veya Bot Token | Çalışma alanı erişimi gerektirir | +| **Discord** | 🚧 Planlanan | Bot Token | Guild izinleri gerektirir | +| **WhatsApp** | 🚧 Planlanan | Twilio veya resmi API | İş hesabı gerektirir | +| **CLI** | ✅ Kararlı | Yok | Doğrudan konuşma arayüzü | +| **Web** | 🚧 Planlanan | API Anahtarı veya OAuth | Tarayıcı tabanlı sohbet arayüzü | + +Tam yapılandırma talimatları için [Kanallar Referansına](docs/channels-reference.md) bakın. + +## Araç Desteği + +ZeroClaw, kod yürütme, dosya sistemi erişimi ve web alımı için yerleşik araçlar sağlar: + +| Araç | Açıklama | Gerekli Çalışma Zamanı | +| -------------------- | --------------------------- | ----------------------------- | +| **bash** | Shell komutlarını yürüt | Yerel veya Docker | +| **python** | Python betiklerini yürüt | Python 3.8+ (yerel) veya Docker | +| **javascript** | Node.js kodunu yürüt | Node.js 18+ (yerel) veya Docker | +| **filesystem_read** | Dosyaları oku | Yerel veya Docker | +| **filesystem_write** | Dosyaları yaz | Yerel veya Docker | +| **web_fetch** | Web içeriği al | Yerel veya Docker | + +### Yürütme Güvenliği + +- **Yerel Çalışma Zamanı** — arka plan programının kullanıcı süreci olarak çalışır, tam dosya sistemi erişimi +- **Docker Çalışma Zamanı** — tam konteyner yalıtımı, ayrı dosya sistemleri ve ağlar + +`config.toml` içinde yürütme ilkesini yapılandırın: + +```toml +[runtime] +kind = "docker" +allowed_tools = ["bash", "python", "filesystem_read"] # Açık izin listesi +``` + +Tam güvenlik seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#runtime) bakın. + +## Dağıtım + +### Yerel Dağıtım (Geliştirme) + +```bash +zeroclaw daemon start +zeroclaw agent start +``` + +### Sunucu Dağıtımı (Üretim) + +Arka plan programını ve ajanı hizmet olarak yönetmek için systemd kullanın: + +```bash +# İkiliyi yükle +cargo install --path . --locked + +# Çalışma alanını yapılandır +zeroclaw init + +# systemd hizmet dosyaları oluştur +sudo cp deployment/systemd/zeroclaw-daemon.service /etc/systemd/system/ +sudo cp deployment/systemd/zeroclaw-agent.service /etc/systemd/system/ + +# Hizmetleri etkinleştir ve başlat +sudo systemctl enable zeroclaw-daemon zeroclaw-agent +sudo systemctl start zeroclaw-daemon zeroclaw-agent + +# Durumu doğrula +sudo systemctl status zeroclaw-daemon +sudo systemctl status zeroclaw-agent +``` + +Tam üretim dağıtım talimatları için [Ağ Dağıtımı Kılavuzuna](docs/network-deployment.md) bakın. + +### Docker + +```bash +# İmajı oluştur +docker build -t zeroclaw:latest . + +# Konteyneri çalıştır +docker run -d \ + --name zeroclaw \ + -v ~/.zeroclaw/workspace:/workspace \ + -e ANTHROPIC_API_KEY=sk-ant-... \ + zeroclaw:latest +``` + +Derleme detayları ve yapılandırma seçenekleri için [`Dockerfile`](Dockerfile)'a bakın. + +### Uç Donanım + +ZeroClaw, düşük güç tüketimli donanımda çalışmak üzere tasarlanmıştır: + +- **Raspberry Pi Zero 2 W** — ~512 MB RAM, tek ARMv8 çekirdek, < $5 donanım maliyeti +- **Raspberry Pi 4/5** — 1 GB+ RAM, çok çekirdekli, eşzamanlı iş yükleri için ideal +- **Orange Pi Zero 2** — ~512 MB RAM, dört çekirdekli ARMv8, ultra düşük maliyet +- **x86 SBC'ler (Intel N100)** — 4-8 GB RAM, hızlı derlemeler, yerel Docker desteği + +Cihaza özgü kurulum talimatları için [Donanım Kılavuzuna](docs/hardware/README.md) bakın. + +## Tünelleme (Herkese Açık Kullanım) + +Yerel ZeroClaw arka plan programınızı güvenli tüneller aracılığıyla herkese açık ağa çıkarın: + +```bash +zeroclaw tunnel start --provider cloudflare +``` + +Desteklenen tünel sağlayıcıları: + +- **Cloudflare Tunnel** — ücretsiz HTTPS, port açığa çıkarma yok, çoklu etki alanı desteği +- **Ngrok** — hızlı kurulum, özel etki alanları (ücretli plan) +- **Tailscale** — özel mesh ağı. herkese açık port yok + +Tam yapılandırma seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#tunnel) bakın. + +## Güvenlik + +ZeroClaw birden çok güvenlik katmanı uygular: + +### Eşleştirme + +Arka plan programı ilk başlangıçta `~/.zeroclaw/workspace/.pairing` içinde saklanan bir eşleştirme sırrı oluşturur. İstemciler (ajan, CLI) bağlanmak için bu sırrı sunmalıdır. + +```bash +zeroclaw pairing rotate # Yeni bir sır oluşturur ve eskisini geçersiz kılar +``` + +### Kum Alanı + +- **Docker Çalışma Zamanı** — ayrı dosya sistemleri ve ağlarla tam konteyner yalıtımı +- **Yerel Çalışma Zamanı** — kullanıcı süreci olarak çalışır. varsayılan olarak çalışma alanına kapsamlı + +### İzin Listeleri + +Kanallar kullanıcı ID'sine göre erişimi kısıtlayabilir: + +```toml +[channels.telegram] +enabled = true +allowed_users = [123456789, 987654321] # Açık izin listesi +``` + +### Şifreleme + +- **Matrix E2EE** — cihaz doğrulamalı tam uçtan uca şifreleme +- **TLS Taşıma** — tüm API ve tünel trafiği HTTPS/TLS kullanır + +Tam ilkeler ve uygulamalar için [Güvenlik Belgelerine](docs/security/README.md) bakın. + +## Gözlemlenebilirlik + +ZeroClaw varsayılan olarak `~/.zeroclaw/workspace/logs/` dizinine log yazar. Loglar bileşene göre saklanır: + +``` +~/.zeroclaw/workspace/logs/ +├── daemon.log # Arka plan programı logları (başlangıç, API istekleri, hatalar) +├── agent.log # Ajan logları (mesaj yönlendirme, araç yürütme) +├── telegram.log # Kanala özgü loglar (etkinse) +└── matrix.log # Kanala özgü loglar (etkinse) +``` + +### Loglama Yapılandırması + +```toml +[logging] +level = "info" # debug, info, warn, error +path = "~/.zeroclaw/workspace/logs/" +rotation = "daily" # günlük, saatlik, boyut +max_size_mb = 100 # Boyut tabanlı döndürme için +retention_days = 30 # N gün sonra otomatik temizleme +``` + +Tüm loglama seçenekleri için [Yapılandırma Referansına](docs/config-reference.md#logging) bakın. + +### Metrikler (Planlanan) + +Üretim izleme için Prometheus metrikleri desteği yakında geliyor. [#234](https://github.com/zeroclaw-labs/zeroclaw/issues/234) numaralı konuda takip ediliyor. + +## Beceriler + +ZeroClaw, sistem yeteneklerini genişleten yeniden kullanılabilir modüller olan özel becerileri destekler. + +### Beceri Tanımı + +Beceriler bu yapı ile `~/.zeroclaw/workspace/skills/<skill-name>/` içinde saklanır: + +``` +skills/ +└── my-skill/ + ├── skill.toml # Beceri metaverileri (ad, açıklama, bağımlılıklar) + ├── prompt.md # AI için sistem istemi + └── tools/ # İsteğe bağlı özel araçlar + └── my_tool.py +``` + +### Beceri Örneği + +```toml +# skills/web-research/skill.toml +[skill] +name = "web-research" +description = "Web'de arama yapar ve sonuçları özetler" +version = "1.0.0" + +[dependencies] +tools = ["web_fetch", "bash"] +``` + +```markdown +<!-- skills/web-research/prompt.md --> + +Sen bir araştırma asistanısın. Bir şeyi araştırmam istendiğinde: + +1. İçeriği almak için web_fetch kullan +2. Sonuçları okunması kolay bir biçimde özetle +3. Kaynakları URL'lerle göster +``` + +### Beceri Kullanımı + +Beceriler ajan başlangıcında otomatik olarak yüklenir. Konuşmalarda ada göre başvurun: + +``` +Kullanıcı: En son AI haberlerini bulmak için web-research becerisini kullan +Bot: [web-research becerisini yükler, web_fetch'i yürütür, sonuçları özetler] +``` + +Tam beceri oluşturma talimatları için [Beceriler](#beceriler) bölümüne bakın. + +## Open Skills + +ZeroClaw, AI ajan yeteneklerini genişletmek için modüler ve sağlayıcıdan bağımsız bir sistem olan [Open Skills](https://github.com/openagents-com/open-skills)'i destekler. + +### Open Skills'i Etkinleştir + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # isteğe bağlı +``` + +Ayrıca `ZEROCLAW_OPEN_SKILLS_ENABLED` ve `ZEROCLAW_OPEN_SKILLS_DIR` ile çalışma zamanında geçersiz kılabilirsiniz. + +## Geliştirme + +```bash +cargo build # Geliştirme derlemesi +cargo build --release # Sürüm derlemesi (codegen-units=1, Raspberry Pi dahil tüm cihazlarda çalışır) +cargo build --profile release-fast # Daha hızlı derleme (codegen-units=8, 16 GB+ RAM gerektirir) +cargo test # Tam test paketini çalıştır +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Biçimlendir + +# SQLite vs Markdown karşılaştırma kıyaslamasını çalıştır +cargo test --test memory_comparison -- --nocapture +``` + +### Ön push kancası + +Bir git kancası her push'tan önce `cargo fmt --check`, `cargo clippy -- -D warnings` ve `cargo test` çalıştırır. Bir kez etkinleştirin: + +```bash +git config core.hooksPath .githooks +``` + +### Derleme Sorun Giderme (Linux'ta OpenSSL hataları) + +Bir `openssl-sys` derleme hatasıyla karşılaşırsanız, bağımlılıkları eşzamanlayın ve deponun lockfile'ı ile yeniden derleyin: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +ZeroClaw, HTTP/TLS bağımlılıkları için `rustls` kullanacak şekilde yapılandırılmıştır; `--locked`, geçişli grafiği temiz ortamlarda deterministik tutar. + +Geliştirme sırasında hızlı bir push'a ihtiyacınız olduğunda kancayı atlamak için: + +```bash +git push --no-verify +``` + +## İşbirliği ve Belgeler + +Görev tabanlı bir harita için belge merkeziyle başlayın: + +- Belge Merkezi: [`docs/README.md`](docs/README.md) +- Birleşik Docs İçindekiler: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Komutlar Referansı: [`docs/commands-reference.md`](docs/commands-reference.md) +- Yapılandırma Referansı: [`docs/config-reference.md`](docs/config-reference.md) +- Sağlayıcı Referansı: [`docs/providers-reference.md`](docs/providers-reference.md) +- Kanallar Referansı: [`docs/channels-reference.md`](docs/channels-reference.md) +- Operasyonlar Runbook'u: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Sorun Giderme: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Docs Envanteri/Sınıflandırma: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- PR/Issue Triaj Anlık Görüntüsü (18 Şub. 2026 itibariyle): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Ana işbirliği referansları: + +- Belge Merkezi: [docs/README.md](docs/README.md) +- Belge Şablonu: [docs/doc-template.md](docs/doc-template.md) +- Belge Değişikliği Kontrol Listesi: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Kanal Yapılandırma Referansı: [docs/channels-reference.md](docs/channels-reference.md) +- Matrix Şifreli Oda Operasyonları: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Katkı Kılavuzu: [CONTRIBUTING.md](CONTRIBUTING.md) +- PR İş Akışı İlkesi: [docs/pr-workflow.md](docs/pr-workflow.md) +- Gözden Geçiren Playbook'u (triaj + derinlemesine gözden geçirme): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Sahiplik ve CI Triaj Haritası: [docs/ci-map.md](docs/ci-map.md) +- Güvenlik Açıklama İlkesi: [SECURITY.md](SECURITY.md) + +Dağıtım ve çalışma zamanı operasyonları için: + +- Ağ Dağıtımı Kılavuzu: [docs/network-deployment.md](docs/network-deployment.md) +- Proxy Agent Playbook'u: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## ZeroClaw'ı Destekleyin + +ZeroClaw işinize yardımcı oluyorsa ve sürekli geliştirmeyi desteklemek istiyorsanız, buradan bağış yapabilirsiniz: + +<a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=for-the-badge&logo=buy-me-a-coffee" alt="Bana Bir Kahve Ismarla" /></a> + +### 🙏 Özel Teşekkürler + +Bu açık kaynak çalışmasını ilham veren ve besleyen topluluklara ve kurumlara içten teşekkürler: + +- **Harvard Üniversitesi** — entelektüel merakı teşvik ettikleri ve mümkün olanın sınırlarını zorladıkları için. +- **MIT** — açık bilgiyi, açık kaynağı ve teknolojinin herkes için erişilebilir olması gerektiği inancını savundukları için. +- **Sundai Club** — topluluk, enerji ve önemli şeyler inşa etme konusundaki amansız irade için. +- **Dünya ve Ötesi** 🌍✨ — açık kaynağı iyi bir güç haline getiren her katılımcı, hayalper ve inşa edene. Bu senin için. + +En iyi fikirler her yerden geldiği için açık kaynakta inşa ediyoruz. Bunu okuyorsan, bunun bir parçasısın. Hoş geldin. 🦀❤️ + +## ⚠️ Resmi Depo ve Taklit Uyarısı + +**Bu tek resmi ZeroClaw deposudur:** + +> <https://github.com/zeroclaw-labs/zeroclaw> + +ZeroClaw olduğunu iddia eden veya ZeroClaw Labs ile bağlantıyı ima eden başka herhangi bir depo, organizasyon, etki alanı veya paket **yetkisizdir ve bu projeyle bağlantılı değildir**. Bilinen yetkisiz forklar [TRADEMARK.md](TRADEMARK.md)'da listelenecektir. + +Taklit veya marka kötüye kullanımıyla karşılaşırsanız, lütfen [bir sorun açın](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Lisans + +ZeroClaw, maksimum açıklık ve katılımcı koruma için çift lisanslıdır: + +| Lisans | Kullanım Durumları | +| ---------------------------- | ------------------------------------------------------------ | +| [MIT](LICENSE-MIT) | Açık kaynak, araştırma, akademik, kişisel kullanım | +| [Apache 2.0](LICENSE-APACHE) | Patent koruması, kurumsal, ticari dağıtım | + +Lisanslardan birini seçebilirsiniz. **Katılımcılar otomatik olarak her ikisi altında da hak verir** — tam katılımcı anlaşması için [CLA.md](CLA.md)'ye bakın. + +### Marka + +**ZeroClaw** adı ve logosu, ZeroClaw Labs'ın tescilli markalarıdır. Bu lisans, onay veya bağlantı ima etmek için kullanım izni vermez. İzin verilen ve yasaklanan kullanımlar için [TRADEMARK.md](TRADEMARK.md)'e bakın. + +### Katılımcı Korumaları + +- Katkılarınızın **telif hakkını sizde tutarsınız** +- **Patent hibesi** (Apache 2.0) sizi diğer katılımcıların patent iddialarından korur +- Katkılarınız commit geçmişinde ve [NOTICE](NOTICE)'da **kalıcı olarak atfedilir** +- Katkıda bulunarak marka hakları devredilmez + +## Katkıda Bulunma + +[CONTRIBUTING.md](CONTRIBUTING.md) ve [CLA.md](CLA.md)'ye bakın. Bir trait uygulayın, bir PR gönderin: + +- CI iş akışı kılavuzu: [docs/ci-map.md](docs/ci-map.md) +- Yeni `Provider` → `src/providers/` +- Yeni `Channel` → `src/channels/` +- Yeni `Observer` → `src/observability/` +- Yeni `Tool` → `src/tools/` +- Yeni `Memory` → `src/memory/` +- Yeni `Tunnel` → `src/tunnel/` +- Yeni `Skill` → `~/.zeroclaw/workspace/skills/<n>/` + +--- + +**ZeroClaw** — Sıfır yük. Sıfır ödün. Her yerde dağıtın. Her şeyi değiştirin. 🦀 + +## Yıldız Geçmişi + +<p align="center"> + <a href="https://www.star-history.com/#zeroclaw-labs/zeroclaw&type=date&legend=top-left"> + <picture> + <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&theme=dark&legend=top-left" /> + <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + <img alt="Yıldız Geçmişi Grafiği" src="https://api.star-history.com/svg?repos=zeroclaw-labs/zeroclaw&type=date&legend=top-left" /> + </picture> + </a> +</p> diff --git a/README.uk.md b/README.uk.md new file mode 100644 index 000000000..bcc72db59 --- /dev/null +++ b/README.uk.md @@ -0,0 +1,179 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center"> + <strong>Нуль накладних витрат. Нуль компромісів. 100% Rust. 100% Агностичний.</strong><br> + ⚡️ <strong>Працює на $10 обладнанні з <5MB RAM: Це на 99% менше пам'яті ніж OpenClaw і на 98% дешевше ніж Mac mini!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center"> + 🌐 <strong>Мови:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## Що таке ZeroClaw? + +ZeroClaw — це легка, змінювана та розширювана інфраструктура AI-асистента, написана на Rust. Вона з'єднує різних LLM-провайдерів (Anthropic, OpenAI, Google, Ollama тощо) через уніфікований інтерфейс і підтримує багато каналів (Telegram, Matrix, CLI тощо). + +### Ключові особливості + +- **🦀 Написано на Rust**: Висока продуктивність, безпека пам'яті та абстракції без накладних витрат +- **🔌 Агностичний до провайдерів**: Підтримка OpenAI, Anthropic, Google Gemini, Ollama та інших +- **📱 Багатоканальність**: Telegram, Matrix (з E2EE), CLI та інші +- **🧠 Плагінна пам'ять**: SQLite та Markdown бекенди +- **🛠️ Розширювані інструменти**: Легко додавайте власні інструменти +- **🔒 Безпека першочергово**: Зворотний проксі, дизайн з пріоритетом конфіденційності + +--- + +## Швидкий старт + +### Вимоги + +- Rust 1.70+ +- API-ключ LLM-провайдера (Anthropic, OpenAI тощо) + +### Встановлення + +```bash +# Клонуйте репозиторій +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Зберіть проект +cargo build --release + +# Запустіть +cargo run --release +``` + +### З Docker + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## Конфігурація + +ZeroClaw використовує YAML-файл конфігурації. За замовчуванням він шукає `config.yaml`. + +```yaml +# Провайдер за замовчуванням +provider: anthropic + +# Конфігурація провайдерів +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# Конфігурація пам'яті +memory: + backend: sqlite + path: data/memory.db + +# Конфігурація каналів +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## Документація + +Для детальної документації дивіться: + +- [Хаб документації](docs/README.md) +- [Довідник команд](docs/commands-reference.md) +- [Довідник провайдерів](docs/providers-reference.md) +- [Довідник каналів](docs/channels-reference.md) +- [Довідник конфігурації](docs/config-reference.md) + +--- + +## Внесок + +Внески вітаються! Будь ласка, прочитайте [Керівництво з внеску](CONTRIBUTING.md). + +--- + +## Ліцензія + +Цей проект має подвійну ліцензію: + +- MIT License +- Apache License, версія 2.0 + +Дивіться [LICENSE-APACHE](LICENSE-APACHE) та [LICENSE-MIT](LICENSE-MIT) для деталей. + +--- + +## Спільнота + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## Спонсори + +Якщо ZeroClaw корисний для вас, будь ласка, розгляньте можливість купити нам каву: + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) diff --git a/README.ur.md b/README.ur.md new file mode 100644 index 000000000..d7265eb3d --- /dev/null +++ b/README.ur.md @@ -0,0 +1,197 @@ +<p align="center"> + <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> +</p> + +<h1 align="center">ZeroClaw 🦀</h1> + +<p align="center" dir="rtl"> + <strong>صفر اوور ہیڈ۔ صفر سمجھوتہ۔ 100% رسٹ۔ 100% اگنوسٹک۔</strong><br> + ⚡️ <strong>$10 کے ہارڈویئر پر <5MB RAM کے ساتھ چلتا ہے: یہ OpenClaw سے 99% کم میموری اور Mac mini سے 98% سستا ہے!</strong> +</p> + +<p align="center"> + <a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/license-MIT%20OR%20Apache%202.0-blue.svg" alt="License: MIT OR Apache-2.0" /></a> + <a href="NOTICE"><img src="https://img.shields.io/badge/contributors-27+-green.svg" alt="Contributors" /></a> + <a href="https://buymeacoffee.com/argenistherose"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee" alt="Buy Me a Coffee" /></a> + <a href="https://x.com/zeroclawlabs?s=21"><img src="https://img.shields.io/badge/X-%40zeroclawlabs-000000?style=flat&logo=x&logoColor=white" alt="X: @zeroclawlabs" /></a> + <a href="https://zeroclawlabs.cn/group.jpg"><img src="https://img.shields.io/badge/WeChat-Group-B7D7A8?logo=wechat&logoColor=white" alt="WeChat Group" /></a> + <a href="https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search"><img src="https://img.shields.io/badge/Xiaohongshu-Official-FF2442?style=flat" alt="Xiaohongshu: Official" /></a> + <a href="https://t.me/zeroclawlabs"><img src="https://img.shields.io/badge/Telegram-%40zeroclawlabs-26A5E4?style=flat&logo=telegram&logoColor=white" alt="Telegram: @zeroclawlabs" /></a> + <a href="https://www.facebook.com/groups/zeroclaw"><img src="https://img.shields.io/badge/Facebook-Group-1877F2?style=flat&logo=facebook&logoColor=white" alt="Facebook Group" /></a> +</p> + +<p align="center" dir="rtl"> + 🌐 <strong>زبانیں:</strong> + <a href="README.md">🇺🇸 English</a> · + <a href="README.zh-CN.md">🇨🇳 简体中文</a> · + <a href="README.ja.md">🇯🇵 日本語</a> · + <a href="README.ko.md">🇰🇷 한국어</a> · + <a href="README.vi.md">🇻🇳 Tiếng Việt</a> · + <a href="README.tl.md">🇵🇭 Tagalog</a> · + <a href="README.es.md">🇪🇸 Español</a> · + <a href="README.pt.md">🇧🇷 Português</a> · + <a href="README.it.md">🇮🇹 Italiano</a> · + <a href="README.de.md">🇩🇪 Deutsch</a> · + <a href="README.fr.md">🇫🇷 Français</a> · + <a href="README.ar.md">🇸🇦 العربية</a> · + <a href="README.hi.md">🇮🇳 हिन्दी</a> · + <a href="README.ru.md">🇷🇺 Русский</a> · + <a href="README.bn.md">🇧🇩 বাংলা</a> · + <a href="README.he.md">🇮🇱 עברית</a> · + <a href="README.pl.md">🇵🇱 Polski</a> · + <a href="README.cs.md">🇨🇿 Čeština</a> · + <a href="README.nl.md">🇳🇱 Nederlands</a> · + <a href="README.tr.md">🇹🇷 Türkçe</a> · + <a href="README.uk.md">🇺🇦 Українська</a> · + <a href="README.id.md">🇮🇩 Bahasa Indonesia</a> · + <a href="README.th.md">🇹🇭 ไทย</a> · + <a href="README.ur.md">🇵🇰 اردو</a> · + <a href="README.ro.md">🇷🇴 Română</a> · + <a href="README.sv.md">🇸🇪 Svenska</a> · + <a href="README.el.md">🇬🇷 Ελληνικά</a> · + <a href="README.hu.md">🇭🇺 Magyar</a> · + <a href="README.fi.md">🇫🇮 Suomi</a> · + <a href="README.da.md">🇩🇰 Dansk</a> · + <a href="README.nb.md">🇳🇴 Norsk</a> +</p> + +--- + +## ZeroClaw کیا ہے؟ + +<p align="center" dir="rtl"> +ZeroClaw ایک ہلکا، قابل تبدیلی اور توسیع پذیر AI اسسٹنٹ انفراسٹرکچر ہے جو رسٹ میں بنایا گیا ہے۔ یہ مختلف LLM فراہم کنندگان (Anthropic, OpenAI, Google, Ollama, وغیرہ) کو ایک متحد انٹرفیس کے ذریعے جوڑتا ہے اور متعدد چینلز (Telegram, Matrix, CLI, وغیرہ) کی حمایت کرتا ہے۔ +</p> + +### اہم خصوصیات + +<p align="center" dir="rtl"> +- **🦀 رسٹ میں لکھا گیا**: اعلیٰ کارکردگی، میموری سیورٹی، اور بغیر لاگت کے ایبسٹریکشن +- **🔌 فراہم کنندہ-اگنوسٹک**: OpenAI, Anthropic, Google Gemini, Ollama, اور دیگر کی حمایت +- **📱 ملٹی چینل**: Telegram, Matrix (E2EE کے ساتھ), CLI, اور دیگر +- **🧠 پلگ ایبل میموری**: SQLite اور Markdown بیک اینڈ +- **🛠️ قابل توسیع ٹولز**: آسانی سے کسٹم ٹولز شامل کریں +- **🔒 سیورٹی فرسٹ**: ریورس پراکسی، پرائیویسی فرسٹ ڈیزائن +</p> + +--- + +## فوری شروعات + +### ضروریات + +<p align="center" dir="rtl"> +- Rust 1.70+ +- ایک LLM فراہم کنندہ API کی (Anthropic, OpenAI, وغیرہ) +</p> + +### انسٹالیشن + +```bash +# ریپوزٹری کلون کریں +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# بلڈ کریں +cargo build --release + +# چلائیں +cargo run --release +``` + +### Docker کے ساتھ + +```bash +docker run -d \ + --name zeroclaw \ + -e ANTHROPIC_API_KEY=your_key \ + -v zeroclaw-data:/app/data \ + zeroclaw/zeroclaw:latest +``` + +--- + +## کنفیگریشن + +<p align="center" dir="rtl"> +ZeroClaw ایک YAML کنفیگریشن فائل استعمال کرتا ہے۔ ڈیفالٹ طور پر، یہ `config.yaml` تلاش کرتا ہے۔ +</p> + +```yaml +# ڈیفالٹ فراہم کنندہ +provider: anthropic + +# فراہم کنندگان کی کنفیگریشن +providers: + anthropic: + api_key: ${ANTHROPIC_API_KEY} + model: claude-3-5-sonnet-20241022 + openai: + api_key: ${OPENAI_API_KEY} + model: gpt-4o + +# میموری کنفیگریشن +memory: + backend: sqlite + path: data/memory.db + +# چینلز کی کنفیگریشن +channels: + telegram: + token: ${TELEGRAM_BOT_TOKEN} +``` + +--- + +## دستاویزات + +<p align="center" dir="rtl"> +تفصیلی دستاویزات کے لیے، دیکھیں: +</p> + +- [دستاویزات ہب](docs/README.md) +- [کمانڈز ریفرنس](docs/commands-reference.md) +- [فراہم کنندگان ریفرنس](docs/providers-reference.md) +- [چینلز ریفرنس](docs/channels-reference.md) +- [کنفیگریشن ریفرنس](docs/config-reference.md) + +--- + +## شراکت + +<p align="center" dir="rtl"> +شراکت کا خیرمقدم ہے! براہ کرم [شراکت گائیڈ](CONTRIBUTING.md) پڑھیں۔ +</p> + +--- + +## لائسنس + +<p align="center" dir="rtl"> +یہ پروجیکٹ ڈول لائسنس یافتہ ہے: +</p> + +- MIT License +- Apache License, ورژن 2.0 + +<p align="center" dir="rtl"> +تفصیلات کے لیے [LICENSE-APACHE](LICENSE-APACHE) اور [LICENSE-MIT](LICENSE-MIT) دیکھیں۔ +</p> + +--- + +## کمیونٹی + +- [Telegram](https://t.me/zeroclawlabs) +- [Facebook Group](https://www.facebook.com/groups/zeroclaw) +- [WeChat Group](https://zeroclawlabs.cn/group.jpg) + +--- + +## سپانسرز + +<p align="center" dir="rtl"> +اگر ZeroClaw آپ کے لیے مفید ہے، تو براہ کرم ہمیں کافی خریدنے پر غور کریں: +</p> + +[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Donate-yellow.svg?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/argenistherose) From b454a9d3011ba4655367e98bcdb693ebf41d93da Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 <simianastronaut7@gmail.com> Date: Mon, 9 Mar 2026 20:33:34 -0400 Subject: [PATCH 08/35] Removed unused file --- .tmp_todo_probe | 0 tests/dockerignore_test.rs | 1 - 2 files changed, 1 deletion(-) delete mode 100644 .tmp_todo_probe diff --git a/.tmp_todo_probe b/.tmp_todo_probe deleted file mode 100644 index e69de29bb..000000000 diff --git a/tests/dockerignore_test.rs b/tests/dockerignore_test.rs index 8af6fa8ca..314526df5 100644 --- a/tests/dockerignore_test.rs +++ b/tests/dockerignore_test.rs @@ -334,7 +334,6 @@ async fn dockerignore_pattern_matching_edge_cases() { assert!(is_excluded(&patterns, "target/debug/build")); assert!(is_excluded(&patterns, "README.md")); assert!(is_excluded(&patterns, "brain.db")); - assert!(is_excluded(&patterns, ".tmp_todo_probe")); assert!(is_excluded(&patterns, ".env")); // Should NOT match From a6e5a6ffda67157b2123b84bee0cb6c9dd89ee35 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 <simianastronaut7@gmail.com> Date: Mon, 9 Mar 2026 21:44:08 -0400 Subject: [PATCH 09/35] chore(docs): relocate assets and project docs to docs/ subdirectories Move zeroclaw.png and zero-claw.jpeg to docs/assets/, CLA.md to docs/contributing/cla.md, and TRADEMARK.md to docs/project/trademark.md. Update all cross-references in root README files (en, fr, ja, ru, vi, zh-CN) to point to new locations. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --- README.fr.md | 12 ++++++------ README.ja.md | 4 ++-- README.md | 12 ++++++------ README.ru.md | 4 ++-- README.vi.md | 12 ++++++------ README.zh-CN.md | 4 ++-- .../assets/zeroclaw-comparison.jpeg | Bin zeroclaw.png => docs/assets/zeroclaw.png | Bin CLA.md => docs/contributing/cla.md | 2 +- TRADEMARK.md => docs/project/trademark.md | 0 10 files changed, 25 insertions(+), 25 deletions(-) rename zero-claw.jpeg => docs/assets/zeroclaw-comparison.jpeg (100%) rename zeroclaw.png => docs/assets/zeroclaw.png (100%) rename CLA.md => docs/contributing/cla.md (97%) rename TRADEMARK.md => docs/project/trademark.md (100%) diff --git a/README.fr.md b/README.fr.md index fdbc4cc45..6edbcc2e5 100644 --- a/README.fr.md +++ b/README.fr.md @@ -1,5 +1,5 @@ <p align="center"> - <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> + <img src="docs/assets/zeroclaw.png" alt="ZeroClaw" width="200" /> </p> <h1 align="center">ZeroClaw 🦀</h1> @@ -95,7 +95,7 @@ Benchmark rapide sur machine locale (macOS arm64, fév. 2026) normalisé pour ma > Notes : Les résultats ZeroClaw sont mesurés sur des builds de production utilisant `/usr/bin/time -l`. OpenClaw nécessite le runtime Node.js (typiquement ~390 Mo de surcharge mémoire supplémentaire), tandis que NanoBot nécessite le runtime Python. PicoClaw et ZeroClaw sont des binaires statiques. Les chiffres RAM ci-dessus sont la mémoire runtime ; les exigences de compilation build-time sont plus élevées. <p align="center"> - <img src="zero-claw.jpeg" alt="Comparaison ZeroClaw vs OpenClaw" width="800" /> + <img src="docs/assets/zeroclaw-comparison.jpeg" alt="Comparaison ZeroClaw vs OpenClaw" width="800" /> </p> ### Mesure locale reproductible @@ -826,7 +826,7 @@ Nous construisons en open source parce que les meilleures idées viennent de par > <https://github.com/zeroclaw-labs/zeroclaw> -Tout autre dépôt, organisation, domaine ou package prétendant être "ZeroClaw" ou impliquant une affiliation avec ZeroClaw Labs est **non autorisé et non affilié à ce projet**. Les forks non autorisés connus seront listés dans [TRADEMARK.md](TRADEMARK.md). +Tout autre dépôt, organisation, domaine ou package prétendant être "ZeroClaw" ou impliquant une affiliation avec ZeroClaw Labs est **non autorisé et non affilié à ce projet**. Les forks non autorisés connus seront listés dans [TRADEMARK.md](docs/project/trademark.md). Si vous rencontrez une usurpation d'identité ou une utilisation abusive de marque, veuillez [ouvrir une issue](https://github.com/zeroclaw-labs/zeroclaw/issues). @@ -841,11 +841,11 @@ ZeroClaw est sous double licence pour une ouverture maximale et la protection de | [MIT](LICENSE-MIT) | Open-source, recherche, académique, usage personnel | | [Apache 2.0](LICENSE-APACHE) | Protection de brevet, institutionnel, déploiement commercial | -Vous pouvez choisir l'une ou l'autre licence. **Les contributeurs accordent automatiquement des droits sous les deux** — voir [CLA.md](CLA.md) pour l'accord de contributeur complet. +Vous pouvez choisir l'une ou l'autre licence. **Les contributeurs accordent automatiquement des droits sous les deux** — voir [CLA.md](docs/contributing/cla.md) pour l'accord de contributeur complet. ### Marque -Le nom **ZeroClaw** et le logo sont des marques déposées de ZeroClaw Labs. Cette licence n'accorde pas la permission de les utiliser pour impliquer une approbation ou une affiliation. Voir [TRADEMARK.md](TRADEMARK.md) pour les utilisations permises et interdites. +Le nom **ZeroClaw** et le logo sont des marques déposées de ZeroClaw Labs. Cette licence n'accorde pas la permission de les utiliser pour impliquer une approbation ou une affiliation. Voir [TRADEMARK.md](docs/project/trademark.md) pour les utilisations permises et interdites. ### Protections des Contributeurs @@ -856,7 +856,7 @@ Le nom **ZeroClaw** et le logo sont des marques déposées de ZeroClaw Labs. Cet ## Contribuer -Voir [CONTRIBUTING.md](CONTRIBUTING.md) et [CLA.md](CLA.md). Implémentez un trait, soumettez une PR : +Voir [CONTRIBUTING.md](CONTRIBUTING.md) et [CLA.md](docs/contributing/cla.md). Implémentez un trait, soumettez une PR : - Guide de workflow CI : [docs/ci-map.md](docs/ci-map.md) - Nouveau `Provider` → `src/providers/` diff --git a/README.ja.md b/README.ja.md index 848ae9cb1..4e5889e2f 100644 --- a/README.ja.md +++ b/README.ja.md @@ -1,5 +1,5 @@ <p align="center"> - <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> + <img src="docs/assets/zeroclaw.png" alt="ZeroClaw" width="200" /> </p> <h1 align="center">ZeroClaw 🦀（日本語）</h1> @@ -87,7 +87,7 @@ ZeroClaw は、高速・省リソース・高拡張性を重視した自律エ > 注記: ZeroClaw の結果は release ビルドを `/usr/bin/time -l` で計測したものです。OpenClaw は Node.js ランタイムが必要で、ランタイム由来だけで通常は約390MBの追加メモリを要します。NanoBot は Python ランタイムが必要です。PicoClaw と ZeroClaw は静的バイナリです。 <p align="center"> - <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" /> + <img src="docs/assets/zeroclaw-comparison.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" /> </p> ### ローカルで再現可能な測定 diff --git a/README.md b/README.md index ebe569cd4..8dbfa2218 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ <p align="center"> - <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> + <img src="docs/assets/zeroclaw.png" alt="ZeroClaw" width="200" /> </p> <h1 align="center">ZeroClaw 🦀</h1> @@ -95,7 +95,7 @@ Local machine quick benchmark (macOS arm64, Feb 2026) normalized for 0.8GHz edge > Notes: ZeroClaw results are measured on release builds using `/usr/bin/time -l`. OpenClaw requires Node.js runtime (typically ~390MB additional memory overhead), while NanoBot requires Python runtime. PicoClaw and ZeroClaw are static binaries. The RAM figures above are runtime memory; build-time compilation requirements are higher. <p align="center"> - <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" /> + <img src="docs/assets/zeroclaw-comparison.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" /> </p> ### Reproducible local measurement @@ -1110,7 +1110,7 @@ We're building in the open because the best ideas come from everywhere. If you'r > https://github.com/zeroclaw-labs/zeroclaw -Any other repository, organization, domain, or package claiming to be "ZeroClaw" or implying affiliation with ZeroClaw Labs is **unauthorized and not affiliated with this project**. Known unauthorized forks will be listed in [TRADEMARK.md](TRADEMARK.md). +Any other repository, organization, domain, or package claiming to be "ZeroClaw" or implying affiliation with ZeroClaw Labs is **unauthorized and not affiliated with this project**. Known unauthorized forks will be listed in [TRADEMARK.md](docs/project/trademark.md). If you encounter impersonation or trademark misuse, please [open an issue](https://github.com/zeroclaw-labs/zeroclaw/issues). @@ -1125,11 +1125,11 @@ ZeroClaw is dual-licensed for maximum openness and contributor protection: | [MIT](LICENSE-MIT) | Open-source, research, academic, personal use | | [Apache 2.0](LICENSE-APACHE) | Patent protection, institutional, commercial deployment | -You may choose either license. **Contributors automatically grant rights under both** — see [CLA.md](CLA.md) for the full contributor agreement. +You may choose either license. **Contributors automatically grant rights under both** — see [CLA.md](docs/contributing/cla.md) for the full contributor agreement. ### Trademark -The **ZeroClaw** name and logo are trademarks of ZeroClaw Labs. This license does not grant permission to use them to imply endorsement or affiliation. See [TRADEMARK.md](TRADEMARK.md) for permitted and prohibited uses. +The **ZeroClaw** name and logo are trademarks of ZeroClaw Labs. This license does not grant permission to use them to imply endorsement or affiliation. See [TRADEMARK.md](docs/project/trademark.md) for permitted and prohibited uses. ### Contributor Protections @@ -1142,7 +1142,7 @@ The **ZeroClaw** name and logo are trademarks of ZeroClaw Labs. This license doe New to ZeroClaw? Look for issues labeled [`good first issue`](https://github.com/zeroclaw-labs/zeroclaw/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) — see our [Contributing Guide](CONTRIBUTING.md#first-time-contributors) for how to get started. -See [CONTRIBUTING.md](CONTRIBUTING.md) and [CLA.md](CLA.md). Implement a trait, submit a PR: +See [CONTRIBUTING.md](CONTRIBUTING.md) and [CLA.md](docs/contributing/cla.md). Implement a trait, submit a PR: - CI workflow guide: [docs/ci-map.md](docs/ci-map.md) - New `Provider` → `src/providers/` diff --git a/README.ru.md b/README.ru.md index cfb10393e..3631a31f3 100644 --- a/README.ru.md +++ b/README.ru.md @@ -1,5 +1,5 @@ <p align="center"> - <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> + <img src="docs/assets/zeroclaw.png" alt="ZeroClaw" width="200" /> </p> <h1 align="center">ZeroClaw 🦀（Русский）</h1> @@ -87,7 +87,7 @@ ZeroClaw — это производительная и расширяемая > Примечание: результаты ZeroClaw получены на release-сборке с помощью `/usr/bin/time -l`. OpenClaw требует Node.js runtime; только этот runtime обычно добавляет около 390MB дополнительного потребления памяти. NanoBot требует Python runtime. PicoClaw и ZeroClaw — статические бинарники. <p align="center"> - <img src="zero-claw.jpeg" alt="Сравнение ZeroClaw и OpenClaw" width="800" /> + <img src="docs/assets/zeroclaw-comparison.jpeg" alt="Сравнение ZeroClaw и OpenClaw" width="800" /> </p> ### Локально воспроизводимое измерение diff --git a/README.vi.md b/README.vi.md index b7cb33ecd..d23cd059d 100644 --- a/README.vi.md +++ b/README.vi.md @@ -1,5 +1,5 @@ <p align="center"> - <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> + <img src="docs/assets/zeroclaw.png" alt="ZeroClaw" width="200" /> </p> <h1 align="center">ZeroClaw 🦀</h1> @@ -95,7 +95,7 @@ Bảng này dành cho các thông báo quan trọng (thay đổi không tương > Ghi chú: Kết quả ZeroClaw được đo trên release build sử dụng `/usr/bin/time -l`. OpenClaw yêu cầu runtime Node.js (thường thêm ~390MB bộ nhớ overhead), còn NanoBot yêu cầu runtime Python. PicoClaw và ZeroClaw là các static binary. Số RAM ở trên là bộ nhớ runtime; yêu cầu biên dịch lúc build-time sẽ cao hơn. <p align="center"> - <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" /> + <img src="docs/assets/zeroclaw-comparison.jpeg" alt="ZeroClaw vs OpenClaw Comparison" width="800" /> </p> ### Tự đo trên máy bạn @@ -1003,7 +1003,7 @@ Chúng tôi xây dựng công khai vì ý tưởng hay đến từ khắp nơi. **Đây là repository ZeroClaw chính thức duy nhất:** > <https://github.com/zeroclaw-labs/zeroclaw> -Bất kỳ repository, tổ chức, tên miền hay gói nào khác tuyên bố là "ZeroClaw" hoặc ngụ ý liên kết với ZeroClaw Labs đều là **không được ủy quyền và không liên kết với dự án này**. Các fork không được ủy quyền đã biết sẽ được liệt kê trong [TRADEMARK.md](TRADEMARK.md). +Bất kỳ repository, tổ chức, tên miền hay gói nào khác tuyên bố là "ZeroClaw" hoặc ngụ ý liên kết với ZeroClaw Labs đều là **không được ủy quyền và không liên kết với dự án này**. Các fork không được ủy quyền đã biết sẽ được liệt kê trong [TRADEMARK.md](docs/project/trademark.md). Nếu bạn phát hiện hành vi mạo danh hoặc lạm dụng nhãn hiệu, vui lòng [mở một issue](https://github.com/zeroclaw-labs/zeroclaw/issues). @@ -1018,11 +1018,11 @@ ZeroClaw được cấp phép kép để tối đa hóa tính mở và bảo v | [MIT](LICENSE-MIT) | Mã nguồn mở, nghiên cứu, học thuật, sử dụng cá nhân | | [Apache 2.0](LICENSE-APACHE) | Bảo hộ bằng sáng chế, triển khai tổ chức, thương mại | -Bạn có thể chọn một trong hai giấy phép. **Người đóng góp tự động cấp quyền theo cả hai** — xem [CLA.md](CLA.md) để biết thỏa thuận đóng góp đầy đủ. +Bạn có thể chọn một trong hai giấy phép. **Người đóng góp tự động cấp quyền theo cả hai** — xem [CLA.md](docs/contributing/cla.md) để biết thỏa thuận đóng góp đầy đủ. ### Nhãn hiệu -Tên **ZeroClaw** và logo là nhãn hiệu của ZeroClaw Labs. Giấy phép này không cấp phép sử dụng chúng để ngụ ý chứng thực hoặc liên kết. Xem [TRADEMARK.md](TRADEMARK.md) để biết các sử dụng được phép và bị cấm. +Tên **ZeroClaw** và logo là nhãn hiệu của ZeroClaw Labs. Giấy phép này không cấp phép sử dụng chúng để ngụ ý chứng thực hoặc liên kết. Xem [TRADEMARK.md](docs/project/trademark.md) để biết các sử dụng được phép và bị cấm. ### Bảo vệ người đóng góp @@ -1033,7 +1033,7 @@ Tên **ZeroClaw** và logo là nhãn hiệu của ZeroClaw Labs. Giấy phép n ## Đóng góp -Xem [CONTRIBUTING.md](CONTRIBUTING.md) và [CLA.md](CLA.md). Triển khai một trait, gửi PR: +Xem [CONTRIBUTING.md](CONTRIBUTING.md) và [CLA.md](docs/contributing/cla.md). Triển khai một trait, gửi PR: - Hướng dẫn quy trình CI: [docs/ci-map.md](docs/ci-map.md) - `Provider` mới → `src/providers/` - `Channel` mới → `src/channels/` diff --git a/README.zh-CN.md b/README.zh-CN.md index 55f86ccab..f2f2699d3 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,5 +1,5 @@ <p align="center"> - <img src="zeroclaw.png" alt="ZeroClaw" width="200" /> + <img src="docs/assets/zeroclaw.png" alt="ZeroClaw" width="200" /> </p> <h1 align="center">ZeroClaw 🦀（简体中文）</h1> @@ -87,7 +87,7 @@ ZeroClaw 是一个高性能、低资源占用、可组合的自主智能体运 > 说明：ZeroClaw 的数据来自 release 构建，并通过 `/usr/bin/time -l` 测得。OpenClaw 需要 Node.js 运行时环境，仅该运行时通常就会带来约 390MB 的额外内存占用；NanoBot 需要 Python 运行时环境。PicoClaw 与 ZeroClaw 为静态二进制。 <p align="center"> - <img src="zero-claw.jpeg" alt="ZeroClaw vs OpenClaw 对比图" width="800" /> + <img src="docs/assets/zeroclaw-comparison.jpeg" alt="ZeroClaw vs OpenClaw 对比图" width="800" /> </p> ### 本地可复现测量 diff --git a/zero-claw.jpeg b/docs/assets/zeroclaw-comparison.jpeg similarity index 100% rename from zero-claw.jpeg rename to docs/assets/zeroclaw-comparison.jpeg diff --git a/zeroclaw.png b/docs/assets/zeroclaw.png similarity index 100% rename from zeroclaw.png rename to docs/assets/zeroclaw.png diff --git a/CLA.md b/docs/contributing/cla.md similarity index 97% rename from CLA.md rename to docs/contributing/cla.md index 1333c4810..2dddf8d41 100644 --- a/CLA.md +++ b/docs/contributing/cla.md @@ -84,7 +84,7 @@ You represent that: ## 6. No Trademark Rights This CLA does not grant you any rights to use the ZeroClaw name, -trademarks, service marks, or logos. See TRADEMARK.md for trademark policy. +trademarks, service marks, or logos. See docs/project/trademark.md for trademark policy. --- diff --git a/TRADEMARK.md b/docs/project/trademark.md similarity index 100% rename from TRADEMARK.md rename to docs/project/trademark.md From 507c93fcf553f46e6c7527bea06937ed54fd4e34 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 <simianastronaut7@gmail.com> Date: Mon, 9 Mar 2026 21:44:20 -0400 Subject: [PATCH 10/35] chore(tests): relocate test scripts and testing docs Move RUN_TESTS.md and TESTING_TELEGRAM.md to docs/contributing/, and move quick_test.sh, test_telegram_integration.sh, generate_test_messages.py to tests/telegram/. Move scripts/test_dockerignore.sh to tests/. Update internal cross-references to reflect new paths. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> --- .../contributing/testing-telegram.md | 16 +++++------ RUN_TESTS.md => docs/contributing/testing.md | 28 +++++++++---------- .../telegram}/generate_test_messages.py | 0 quick_test.sh => tests/telegram/quick_test.sh | 2 +- .../telegram/test_telegram_integration.sh | 0 {scripts => tests}/test_dockerignore.sh | 2 +- 6 files changed, 24 insertions(+), 24 deletions(-) rename TESTING_TELEGRAM.md => docs/contributing/testing-telegram.md (95%) rename RUN_TESTS.md => docs/contributing/testing.md (90%) rename {test_helpers => tests/telegram}/generate_test_messages.py (100%) rename quick_test.sh => tests/telegram/quick_test.sh (90%) rename test_telegram_integration.sh => tests/telegram/test_telegram_integration.sh (100%) rename {scripts => tests}/test_dockerignore.sh (99%) diff --git a/TESTING_TELEGRAM.md b/docs/contributing/testing-telegram.md similarity index 95% rename from TESTING_TELEGRAM.md rename to docs/contributing/testing-telegram.md index d1cfe9878..a9dd04f00 100644 --- a/TESTING_TELEGRAM.md +++ b/docs/contributing/testing-telegram.md @@ -8,10 +8,10 @@ This guide covers testing the Telegram channel integration for ZeroClaw. ```bash # Full test suite (20+ tests, ~2 minutes) -./test_telegram_integration.sh +./tests/telegram/test_telegram_integration.sh # Quick smoke test (~10 seconds) -./quick_test.sh +./tests/telegram/quick_test.sh # Just unit tests cargo test telegram --lib @@ -176,7 +176,7 @@ Solution: Verify code changes ```bash # 1. Run automated tests -./test_telegram_integration.sh +./tests/telegram/test_telegram_integration.sh # 2. Configure Telegram zeroclaw onboard --interactive @@ -197,10 +197,10 @@ zeroclaw channel start ```bash # 1. Quick validation -./quick_test.sh +./tests/telegram/quick_test.sh # 2. Full test suite -./test_telegram_integration.sh +./tests/telegram/test_telegram_integration.sh # 3. Manual smoke test zeroclaw channel start @@ -211,7 +211,7 @@ zeroclaw channel start ```bash # 1. Full test suite -./test_telegram_integration.sh +./tests/telegram/test_telegram_integration.sh # 2. Load test (optional) # Send 100 messages rapidly @@ -315,8 +315,8 @@ jobs: Before merging code: -- [ ] `./quick_test.sh` passes -- [ ] `./test_telegram_integration.sh` passes +- [ ] `./tests/telegram/quick_test.sh` passes +- [ ] `./tests/telegram/test_telegram_integration.sh` passes - [ ] Manual tests completed - [ ] No new clippy warnings - [ ] Code is formatted (`cargo fmt`) diff --git a/RUN_TESTS.md b/docs/contributing/testing.md similarity index 90% rename from RUN_TESTS.md rename to docs/contributing/testing.md index eddc5785c..b9a9afea3 100644 --- a/RUN_TESTS.md +++ b/docs/contributing/testing.md @@ -4,10 +4,10 @@ ```bash # Full automated test suite (~2 min) -./test_telegram_integration.sh +./tests/telegram/test_telegram_integration.sh # Quick smoke test (~10 sec) -./quick_test.sh +./tests/telegram/quick_test.sh # Just compile and unit test (~30 sec) cargo test telegram --lib @@ -22,7 +22,7 @@ cargo test telegram --lib - **Detailed summary** at the end ```bash - ./test_telegram_integration.sh + ./tests/telegram/test_telegram_integration.sh ``` ### 2. **quick_test.sh** (Fast Validation) @@ -31,7 +31,7 @@ cargo test telegram --lib - Perfect for **pre-commit** checks ```bash - ./quick_test.sh + ./tests/telegram/quick_test.sh ``` ### 3. **generate_test_messages.py** (Test Helper) @@ -41,10 +41,10 @@ cargo test telegram --lib ```bash # Generate a long message (>4096 chars) - python3 test_helpers/generate_test_messages.py long + python3 tests/telegram/generate_test_messages.py long # Show all message types - python3 test_helpers/generate_test_messages.py all + python3 tests/telegram/generate_test_messages.py all ``` ### 4. **TESTING_TELEGRAM.md** (Complete Guide) @@ -61,10 +61,10 @@ cargo test telegram --lib cd /Users/abdzsam/zeroclaw # Make scripts executable (already done) -chmod +x test_telegram_integration.sh quick_test.sh +chmod +x tests/telegram/test_telegram_integration.sh tests/telegram/quick_test.sh # Run the full test suite -./test_telegram_integration.sh +./tests/telegram/test_telegram_integration.sh ``` **Expected output:** @@ -146,7 +146,7 @@ zeroclaw channel start ```bash # Generate a long message -python3 test_helpers/generate_test_messages.py long +python3 tests/telegram/generate_test_messages.py long ``` - **Copy the output** @@ -161,7 +161,7 @@ python3 test_helpers/generate_test_messages.py long #### Test 3: Word Boundary Splitting ```bash -python3 test_helpers/generate_test_messages.py word +python3 tests/telegram/generate_test_messages.py word ``` - Send to bot @@ -257,17 +257,17 @@ Add to your workflow: ```bash # Pre-commit hook #!/bin/bash -./quick_test.sh +./tests/telegram/quick_test.sh # CI pipeline -./test_telegram_integration.sh +./tests/telegram/test_telegram_integration.sh ``` ## 📚 Next Steps 1. **Run the tests:** ```bash - ./test_telegram_integration.sh + ./tests/telegram/test_telegram_integration.sh ``` 2. **Fix any failures** using the troubleshooting guide @@ -299,5 +299,5 @@ If all tests pass: ## 📞 Support - Issues: https://github.com/theonlyhennygod/zeroclaw/issues -- Docs: `./TESTING_TELEGRAM.md` +- Docs: `docs/contributing/testing-telegram.md` - Help: `zeroclaw --help` diff --git a/test_helpers/generate_test_messages.py b/tests/telegram/generate_test_messages.py similarity index 100% rename from test_helpers/generate_test_messages.py rename to tests/telegram/generate_test_messages.py diff --git a/quick_test.sh b/tests/telegram/quick_test.sh similarity index 90% rename from quick_test.sh rename to tests/telegram/quick_test.sh index 07f0eac4a..dbb529b7e 100755 --- a/quick_test.sh +++ b/tests/telegram/quick_test.sh @@ -27,4 +27,4 @@ grep -q "tokio::time::timeout" src/channels/telegram.rs && \ echo "✓" || { echo "✗ FAILED"; exit 1; } echo "" -echo "✅ Quick tests passed! Run ./test_telegram_integration.sh for full suite." +echo "✅ Quick tests passed! Run ./tests/telegram/test_telegram_integration.sh for full suite." diff --git a/test_telegram_integration.sh b/tests/telegram/test_telegram_integration.sh similarity index 100% rename from test_telegram_integration.sh rename to tests/telegram/test_telegram_integration.sh diff --git a/scripts/test_dockerignore.sh b/tests/test_dockerignore.sh similarity index 99% rename from scripts/test_dockerignore.sh rename to tests/test_dockerignore.sh index 839d21e58..1fe28571b 100755 --- a/scripts/test_dockerignore.sh +++ b/tests/test_dockerignore.sh @@ -1,6 +1,6 @@ #!/usr/bin/env bash # Test script to verify .dockerignore excludes sensitive paths -# Run: ./scripts/test_dockerignore.sh +# Run: ./tests/test_dockerignore.sh set -euo pipefail From 0b9a975da5bcc76cdf2afca8e287f48a1c361546 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 <simianastronaut7@gmail.com> Date: Mon, 9 Mar 2026 22:25:20 -0400 Subject: [PATCH 11/35] docs: restructure docs/ into topic-based directory layout - Move ~60 flat files from docs/ root into category subdirs: security/, hardware/, ops/, reference/{api,cli,sop}, setup-guides/, contributing/, maintainers/, assets/ - Absorb and remove datasheets/, operations/, getting-started/, project/, structure/, sop/ directories - Move testing-telegram.md to tests/telegram/ alongside test scripts - Merge FutureRefactorings.md into refactor-candidates.md --- docs/{ => assets}/Hardware_architecture.jpg | Bin docs/assets/architecture-diagrams.md | 832 ++++++++++++++++++ docs/{ => assets}/architecture.svg | 0 .../actions-source-policy.md | 0 .../adding-boards-and-tools.md | 0 .../cargo-slicer-speedup.md | 0 docs/{ => contributing}/ci-map.md | 0 docs/{ => contributing}/custom-providers.md | 0 docs/{ => contributing}/doc-template.md | 0 .../langgraph-integration.md | 0 docs/{ => contributing}/pr-workflow.md | 0 docs/{ => contributing}/release-process.md | 0 docs/{ => contributing}/reviewer-playbook.md | 0 docs/{ => hardware}/android-setup.md | 0 docs/{ => hardware}/arduino-uno-q-setup.md | 0 docs/{ => hardware}/datasheets/arduino-uno.md | 0 docs/{ => hardware}/datasheets/esp32.md | 0 .../datasheets/nucleo-f401re.md | 0 .../hardware-peripherals-design.md | 0 docs/{ => hardware}/nucleo-setup.md | 0 docs/{project => maintainers}/README.md | 0 docs/{ => maintainers}/docs-inventory.md | 0 docs/{ => maintainers}/i18n-coverage.md | 0 .../project-triage-snapshot-2026-02-18.md | 0 docs/maintainers/refactor-candidates.md | 135 +++ docs/maintainers/repo-map.md | 255 ++++++ .../structure-README.md} | 0 docs/{project => maintainers}/trademark.md | 0 docs/{operations => ops}/README.md | 0 docs/{ => ops}/network-deployment.md | 0 docs/{ => ops}/operations-runbook.md | 0 docs/{ => ops}/proxy-agent-playbook.md | 0 docs/{ => ops}/resource-limits.md | 0 docs/{ => ops}/troubleshooting.md | 0 docs/{ => ops}/troubleshooting.vi.md | 0 .../{ => reference/api}/channels-reference.md | 0 docs/{ => reference/api}/config-reference.md | 0 .../api}/config-reference.vi.md | 0 .../api}/providers-reference.md | 0 .../{ => reference/cli}/commands-reference.md | 0 .../cli}/commands-reference.vi.md | 0 docs/{ => reference}/sop/README.md | 0 docs/{ => reference}/sop/connectivity.md | 0 docs/{ => reference}/sop/cookbook.md | 0 docs/{ => reference}/sop/observability.md | 0 docs/{ => reference}/sop/syntax.md | 0 docs/{ => security}/agnostic-security.md | 0 docs/{ => security}/audit-logging.md | 0 docs/{ => security}/frictionless-security.md | 0 docs/{ => security}/matrix-e2ee-guide.md | 0 docs/{ => security}/sandboxing.md | 0 docs/{ => security}/security-roadmap.md | 0 .../README.md | 0 .../README.vi.md | 0 .../macos-update-uninstall.md | 0 docs/{ => setup-guides}/mattermost-setup.md | 0 .../nextcloud-talk-setup.md | 0 .../{ => setup-guides}/one-click-bootstrap.md | 0 .../one-click-bootstrap.vi.md | 0 docs/{ => setup-guides}/zai-glm-setup.md | 0 .../telegram}/testing-telegram.md | 0 61 files changed, 1222 insertions(+) rename docs/{ => assets}/Hardware_architecture.jpg (100%) create mode 100644 docs/assets/architecture-diagrams.md rename docs/{ => assets}/architecture.svg (100%) rename docs/{ => contributing}/actions-source-policy.md (100%) rename docs/{ => contributing}/adding-boards-and-tools.md (100%) rename docs/{ => contributing}/cargo-slicer-speedup.md (100%) rename docs/{ => contributing}/ci-map.md (100%) rename docs/{ => contributing}/custom-providers.md (100%) rename docs/{ => contributing}/doc-template.md (100%) rename docs/{ => contributing}/langgraph-integration.md (100%) rename docs/{ => contributing}/pr-workflow.md (100%) rename docs/{ => contributing}/release-process.md (100%) rename docs/{ => contributing}/reviewer-playbook.md (100%) rename docs/{ => hardware}/android-setup.md (100%) rename docs/{ => hardware}/arduino-uno-q-setup.md (100%) rename docs/{ => hardware}/datasheets/arduino-uno.md (100%) rename docs/{ => hardware}/datasheets/esp32.md (100%) rename docs/{ => hardware}/datasheets/nucleo-f401re.md (100%) rename docs/{ => hardware}/hardware-peripherals-design.md (100%) rename docs/{ => hardware}/nucleo-setup.md (100%) rename docs/{project => maintainers}/README.md (100%) rename docs/{ => maintainers}/docs-inventory.md (100%) rename docs/{ => maintainers}/i18n-coverage.md (100%) rename docs/{ => maintainers}/project-triage-snapshot-2026-02-18.md (100%) create mode 100644 docs/maintainers/refactor-candidates.md create mode 100644 docs/maintainers/repo-map.md rename docs/{structure/README.md => maintainers/structure-README.md} (100%) rename docs/{project => maintainers}/trademark.md (100%) rename docs/{operations => ops}/README.md (100%) rename docs/{ => ops}/network-deployment.md (100%) rename docs/{ => ops}/operations-runbook.md (100%) rename docs/{ => ops}/proxy-agent-playbook.md (100%) rename docs/{ => ops}/resource-limits.md (100%) rename docs/{ => ops}/troubleshooting.md (100%) rename docs/{ => ops}/troubleshooting.vi.md (100%) rename docs/{ => reference/api}/channels-reference.md (100%) rename docs/{ => reference/api}/config-reference.md (100%) rename docs/{ => reference/api}/config-reference.vi.md (100%) rename docs/{ => reference/api}/providers-reference.md (100%) rename docs/{ => reference/cli}/commands-reference.md (100%) rename docs/{ => reference/cli}/commands-reference.vi.md (100%) rename docs/{ => reference}/sop/README.md (100%) rename docs/{ => reference}/sop/connectivity.md (100%) rename docs/{ => reference}/sop/cookbook.md (100%) rename docs/{ => reference}/sop/observability.md (100%) rename docs/{ => reference}/sop/syntax.md (100%) rename docs/{ => security}/agnostic-security.md (100%) rename docs/{ => security}/audit-logging.md (100%) rename docs/{ => security}/frictionless-security.md (100%) rename docs/{ => security}/matrix-e2ee-guide.md (100%) rename docs/{ => security}/sandboxing.md (100%) rename docs/{ => security}/security-roadmap.md (100%) rename docs/{getting-started => setup-guides}/README.md (100%) rename docs/{getting-started => setup-guides}/README.vi.md (100%) rename docs/{getting-started => setup-guides}/macos-update-uninstall.md (100%) rename docs/{ => setup-guides}/mattermost-setup.md (100%) rename docs/{ => setup-guides}/nextcloud-talk-setup.md (100%) rename docs/{ => setup-guides}/one-click-bootstrap.md (100%) rename docs/{ => setup-guides}/one-click-bootstrap.vi.md (100%) rename docs/{ => setup-guides}/zai-glm-setup.md (100%) rename {docs/contributing => tests/telegram}/testing-telegram.md (100%) diff --git a/docs/Hardware_architecture.jpg b/docs/assets/Hardware_architecture.jpg similarity index 100% rename from docs/Hardware_architecture.jpg rename to docs/assets/Hardware_architecture.jpg diff --git a/docs/assets/architecture-diagrams.md b/docs/assets/architecture-diagrams.md new file mode 100644 index 000000000..3360362d3 --- /dev/null +++ b/docs/assets/architecture-diagrams.md @@ -0,0 +1,832 @@ +# ZeroClaw Architecture Diagrams + +This document provides visual representations of ZeroClaw's architecture, execution modes, and data flows. + +--- + +## 1. Execution Modes + +**Ways ZeroClaw can be run:** + +```mermaid +flowchart TD + Start[zeroclaw CLI] --> Onboard[onboard<br/>Setup wizard] + Start --> Agent[agent<br/>Interactive CLI] + Start --> Gateway[gateway<br/>HTTP server] + Start --> Daemon[daemon<br/>Long-running runtime] + Start --> Channel[channel<br/>Messaging platforms] + Start --> Service[service<br/>OS service mgmt] + Start --> Models[models<br/>Provider catalog] + Start --> Cron[cron<br/>Scheduled tasks] + Start --> Hardware[hardware<br/>Peripheral discovery] + Start --> Peripheral[peripheral<br/>Hardware management] + Start --> Status[status<br/>System overview] + Start --> Doctor[doctor<br/>Diagnostics] + Start --> Migrate[migrate<br/>Data import] + Start --> Skills[skills<br/>User capabilities] + Start --> Integrations[integrations<br/>Browse 50+ apps] + + Agent --> AgentSingle[-m message<br/>One-shot] + Agent --> AgentInteractive[Interactive REPL<br/>stdin/stdout] + + Daemon --> DaemonSupervised[Supervised runtime<br/>Gateway + Channels + Scheduler] +``` + +--- + +## 2. System Architecture Overview + +**High-level component structure:** + +```mermaid +flowchart TB + subgraph CLI[CLI Entry Point] + Main[main.rs] + end + + subgraph Core[Core Subsystems] + Config[config/<br/>Configuration & Schema] + Agent[agent/<br/>Orchestration Loop] + Providers[providers/<br/>LLM Adapters] + Channels[channels/<br/>Messaging Platforms] + Tools[tools/<br/>Tool Execution] + Memory[memory/<br/>Storage Backends] + Security[security/<br/>Policy & Pairing] + Runtime[runtime/<br/>Execution Adapters] + Gateway[gateway/<br/>HTTP/Webhook Server] + Daemon[daemon/<br/>Supervised Runtime] + Peripherals[peripherals/<br/>Hardware Control] + Observability[observability/<br/>Telemetry & Metrics] + RAG[rag/<br/>Hardware Documentation] + Cron[cron/<br/>Scheduler] + Skills[skills/<br/>User Capabilities] + end + + subgraph Integrations[Integrations] + Composio[Composio<br/>1000+ Apps] + Browser[Browser<br/>Brave Integration] + Tunnel[Tunnel<br/>Cloudflare/boringproxy] + end + + Main --> Config + Main --> Agent + Main --> Gateway + Main --> Daemon + Main --> Channels + + Agent --> Providers + Agent --> Tools + Agent --> Memory + Agent --> Security + Agent --> Runtime + Agent --> Peripherals + Agent --> RAG + Agent --> Skills + + Channels --> Agent + Gateway --> Agent + + Daemon --> Gateway + Daemon --> Channels + Daemon --> Cron + Daemon --> Observability + + Tools --> Composio + Tools --> Browser + Gateway --> Tunnel + + classDef coreComp fill:#4A90E2,stroke:#1E3A5F,color:#fff + classDef integComp fill:#50C878,stroke:#1E3A5F,color:#fff + classDef cliComp fill:#F5A623,stroke:#1E3A5F,color:#fff + + class Config,Agent,Providers,Channels,Tools,Memory,Security,Runtime,Gateway,Daemon,Peripherals,Observability,RAG,Cron,Skills coreComp + class Composio,Browser,Tunnel integComp + class Main cliComp +``` + +--- + +## 3. Message Flow Through The System + +**How a user message becomes a response:** + +```mermaid +sequenceDiagram + participant User + participant Channel as Channel Layer + participant Dispatcher as Message Dispatcher + participant Agent as Agent Loop + participant Provider as LLM Provider + participant Tools as Tool Registry + participant Memory as Memory Backend + + User->>Channel: Send message + Channel->>Dispatcher: ChannelMessage{id, sender, content} + Dispatcher->>Memory: Recall context + Memory-->>Dispatcher: Relevant memories + Dispatcher->>Agent: process_message() + + Note over Agent: Build system prompt<br/>+ memory context + + Agent->>Provider: chat_with_tools(history) + Provider-->>Agent: LLM response + + alt Tool calls present + loop For each tool call + Agent->>Tools: execute(args) + Tools-->>Agent: ToolResult + end + Agent->>Provider: chat_with_tools(+ tool results) + Provider-->>Agent: Final response + end + + Agent-->>Dispatcher: Response text + Dispatcher->>Memory: Store conversation + Dispatcher-->>Channel: SendMessage{content, recipient} + Channel-->>User: Reply +``` + +--- + +## 4. Agent Loop Execution Flow + +**The core agent orchestration loop:** + +```mermaid +flowchart TD + Start[[Start: User Message]] --> BuildContext[Build Context] + + BuildContext --> MemoryRecall[Memory.recall<br/>Retrieve relevant entries] + BuildContext --> HardwareRAG{Hardware<br/>enabled?} + HardwareRAG -->|Yes| LoadDatasheets[Load Hardware RAG<br/>Pin aliases + chunks] + HardwareRAG -->|No| BuildPrompt[Build System Prompt] + LoadDatasheets --> BuildPrompt + + MemoryRecall --> Enrich[Enrich Message<br/>memory + RAG context] + Enrich --> BuildPrompt + + BuildPrompt --> InitHistory[Initialize History<br/>system + user message] + + InitHistory --> ToolLoop{Tool Call Loop<br/>max 10 iterations} + + ToolLoop --> LLMRequest[Provider.chat_with_tools<br/>or chat_with_history] + LLMRequest --> ParseResponse[Parse Response] + + ParseResponse --> HasTools{Tool calls<br/>present?} + + HasTools -->|No| SaveResponse[Push assistant response] + SaveResponse --> Return[[Return: Final Response]] + + HasTools -->|Yes| Approval{Needs<br/>approval?} + Approval -->|Yes & Denied| DenyTool[Record denied] + DenyTool --> NextIteration + + Approval -->|No / Approved| ExecuteTools[Execute Tools<br/>in parallel] + + ExecuteTools --> ScrubResults[Scrub credentials<br/>from output] + ScrubResults --> AddResults[Add tool results<br/>to history] + AddResults --> NextIteration + + DenyTool --> NextIteration[Increment iteration] + NextIteration --> MaxIter{Reached<br/>max 10?} + MaxIter -->|Yes| Error[[Error: Max iterations]] + MaxIter -->|No| ToolLoop + + classDef contextStep fill:#E8F4FD,stroke:#4A90E2 + classDef llmStep fill:#FFF4E6,stroke:#F5A623 + classDef toolStep fill:#E8FDF5,stroke:#50C878 + classDef errorStep fill:#FDE8E8,stroke:#D0021B + + class BuildContext,MemoryRecall,HardwareRAG,LoadDatasheets,Enrich,BuildPrompt,InitHistory contextStep + class LLMRequest,ParseResponse llmStep + class ExecuteTools,ScrubResults,AddResults toolStep + class Error errorStep +``` + +--- + +## 5. Daemon Supervision Model + +**How the daemon keeps components alive:** + +```mermaid +flowchart TB + Start[[zeroclaw daemon]] --> SpawnComponents + + SpawnComponents --> SpawnState[Spawn State Writer<br/>5s flush interval] + SpawnComponents --> SpawnGateway[Spawn Gateway Supervisor] + SpawnComponents --> SpawnChannels{Channels<br/>configured?} + SpawnComponents --> SpawnHeartbeat{Heartbeat<br/>enabled?} + SpawnComponents --> SpawnScheduler{Cron<br/>enabled?} + + SpawnChannels -->|Yes| SpawnChannelSup[Spawn Channel Supervisor] + SpawnChannels -->|No| MarkChannelsOK[Mark channels OK<br/>disabled] + + SpawnHeartbeat -->|Yes| SpawnHeartbeatWorker[Spawn Heartbeat Worker] + SpawnHeartbeat -->|No| MarkHeartbeatOK[Mark heartbeat OK<br/>disabled] + + SpawnScheduler -->|Yes| SpawnSchedulerWorker[Spawn Cron Scheduler] + SpawnScheduler -->|No| MarkSchedulerOK[Mark scheduler OK<br/>disabled] + + SpawnGateway --> GatewayLoop{Gateway Loop} + SpawnChannelSup --> ChannelLoop{Channel Loop} + SpawnHeartbeatWorker --> HeartbeatLoop{Heartbeat Loop} + SpawnSchedulerWorker --> SchedulerLoop{Scheduler Loop} + + GatewayLoop --> GatewayRun[run_gateway] + GatewayRun --> GatewayExit{Exit OK?} + GatewayExit -->|No| GatewayError[Mark error + log] + GatewayExit -->|Yes| GatewayUnexpected[Mark: unexpected exit] + GatewayError --> GatewayBackoff[Wait with backoff] + GatewayUnexpected --> GatewayBackoff + GatewayBackoff --> GatewayLoop + + ChannelLoop --> ChannelRun[start_channels] + ChannelRun --> ChannelExit{Exit OK?} + ChannelExit -->|No| ChannelError[Mark error + log] + ChannelExit -->|Yes| ChannelUnexpected[Mark: unexpected exit] + ChannelError --> ChannelBackoff[Wait with backoff] + ChannelUnexpected --> ChannelBackoff + ChannelBackoff --> ChannelLoop + + HeartbeatLoop --> HeartbeatRun[Collect tasks + Agent runs] + HeartbeatRun --> HeartbeatExit{Exit OK?} + HeartbeatExit -->|No| HeartbeatError[Mark error + log] + HeartbeatExit -->|Yes| HeartbeatUnexpected[Mark: unexpected exit] + HeartbeatError --> HeartbeatBackoff[Wait with backoff] + HeartbeatUnexpected --> HeartbeatBackoff + HeartbeatBackoff --> HeartbeatLoop + + SchedulerLoop --> SchedulerRun[cron::scheduler::run] + SchedulerRun --> SchedulerExit{Exit OK?} + SchedulerExit -->|No| SchedulerError[Mark error + log] + SchedulerExit -->|Yes| SchedulerUnexpected[Mark: unexpected exit] + SchedulerError --> SchedulerBackoff[Wait with backoff] + SchedulerUnexpected --> SchedulerBackoff + SchedulerBackoff --> SchedulerLoop + + MarkChannelsOK --> Running[Daemon Running<br/>Ctrl+C to stop] + MarkHeartbeatOK --> Running + MarkSchedulerOK --> Running + SpawnState --> Running + + Running --> StopRequest[Ctrl+C received] + StopRequest --> AbortAll[Abort all tasks] + AbortAll --> JoinAll[Wait for tasks] + JoinAll --> Done[[Daemon stopped]] + + classDef supervisor fill:#FDE8E8,stroke:#D0021B + classDef running fill:#E8FDF5,stroke:#50C878 + classDef component fill:#E8F4FD,stroke:#4A90E2 + + class SpawnGateway,SpawnChannelSup,SpawnHeartbeatWorker,SpawnSchedulerWorker,SpawnState supervisor + class Running running + class GatewayRun,ChannelRun,HeartbeatRun,SchedulerRun component +``` + +--- + +## 6. Gateway HTTP Endpoints + +**The gateway's HTTP API structure:** + +```mermaid +flowchart TB + Client[HTTP Client] --> Gateway[ZeroClaw Gateway] + + Gateway --> PairPOST[POST /pair<br/>Exchange one-time code<br/>for bearer token] + Gateway --> HealthGET[GET /health<br/>Status check] + Gateway --> WebhookPOST[POST /webhook<br/>Main agent endpoint] + Gateway --> WAVerify[GET /whatsapp<br/>Meta verification] + Gateway --> WAMessage[POST /whatsapp<br/>WhatsApp webhook] + + PairPOST --> PairLimiter[Rate Limiter<br/>pair req/min] + PairLimiter --> PairGuard[PairingGuard<br/>Code validation] + PairGuard --> PairResponse[{paired, token, persisted}] + + WebhookPOST --> WebhookLimiter[Rate Limiter<br/>webhook req/min] + WebhookLimiter --> WebhookPairing{Pairing<br/>required?} + WebhookPairing -->|Yes| BearerAuth[Bearer token check] + WebhookPairing -->|No| WebhookSecret{Secret<br/>configured?} + WebhookSecret -->|Yes| SecretCheck[X-Webhook-Secret<br/>HMAC-SHA256 verify] + WebhookSecret -->|No| Idempotency[Idempotency check<br/>X-Idempotency-Key] + BearerAuth --> Idempotency + SecretCheck --> Idempotency + + Idempotency --> MemoryStore[Auto-save to memory] + MemoryStore --> ProviderCall[Provider.simple_chat] + ProviderCall --> WebhookResponse[{response, model}] + + WAVerify --> TokenCheck[verify_token check<br/>constant-time compare] + TokenCheck --> Challenge[Return hub.challenge] + + WAMessage --> SignatureCheck[X-Hub-Signature-256<br/>HMAC-SHA256 verify] + SignatureCheck --> ParsePayload[Parse messages] + ParsePayload --> ForEach[For each message] + ForEach --> WAMemory[Auto-save to memory] + WAMemory --> WAProvider[Provider.simple_chat] + WAProvider --> WASend[WhatsAppChannel.send] + + classDef auth fill:#FDE8E8,stroke:#D0021B + classDef processing fill:#E8F4FD,stroke:#4A90E2 + classDef response fill:#E8FDF5,stroke:#50C878 + + class PairLimiter,PairGuard,BearerAuth,SecretCheck auth + class MemoryStore,ProviderCall,TokenCheck,ParsePayload,ForEach,WAMemory,WAProvider processing + class PairResponse,WebhookResponse,Challenge,WASend response +``` + +--- + +## 7. Channel Message Dispatch + +**How channels route messages to the agent:** + +```mermaid +flowchart TB + subgraph Channels[Channel Listeners] + TG[Telegram] + DC[Discord] + SL[Slack] + IM[iMessage] + MX[Matrix] + SIG[Signal] + WA[WhatsApp] + Email[Email] + IRC[IRC] + Lark[Lark] + DT[DingTalk] + QQ[QQ] + end + + Channels --> MPSC[MPSC Channel<br/>100-buffer queue] + + MPSC --> Semaphore[Semaphore<br/>Max in-flight limit] + Semaphore --> WorkerPool[Worker Pool<br/>JoinSet] + + WorkerPool --> Process[process_channel_message] + + Process --> LogReceive[Log: 💬 from user] + LogReceive --> MemoryRecall[build_memory_context] + MemoryRecall --> AutoSave[Auto-save if enabled] + + AutoSave --> StartTyping[channel.start_typing] + StartTyping --> Timeout[300s timeout guard] + + Timeout --> AgentCall[run_tool_call_loop<br/>silent mode] + AgentCall --> StopTyping[channel.stop_typing] + + StopTyping --> Success{Success?} + Success -->|Yes| LogReply[Log: 🤖 Reply time] + Success -->|No| LogError[Log: ❌ LLM error] + Success -->|Timeout| LogTimeout[Log: ❌ Timeout] + + LogReply --> SendReply[channel.send reply] + LogError --> SendError[channel.send error msg] + LogTimeout --> SendTimeout[channel.send timeout msg] + + SendReply --> Done[Message complete] + SendError --> Done + SendTimeout --> Done + + Done --> NextWorker[Join next worker] + NextWorker --> WorkerPool + + classDef channel fill:#E8F4FD,stroke:#4A90E2 + classDef queue fill:#FFF4E6,stroke:#F5A623 + classDef process fill:#FDE8E8,stroke:#D0021B + classDef success fill:#E8FDF5,stroke:#50C878 + + class TG,DC,SL,IM,MX,SIG,WA,Email,IRC,Lark,DT,QQ channel + class MPSC,Semaphore,WorkerPool queue + class Process,LogReceive,MemoryRecall,AutoSave,StartTyping,Timeout,AgentCall,StopTyping process + class LogReply,SendReply,Done,NextWorker success +``` + +--- + +## 8. Memory System Architecture + +**Storage backends and data flow:** + +```mermaid +flowchart TB + subgraph Frontend[Memory Frontends] + AutoSave[Auto-save hooks<br/>user_msg, assistant_resp] + StoreTool[memory_store tool] + RecallTool[memory_recall tool] + ForgetTool[memory_forget tool] + GetTool[memory_get tool] + ListTool[memory_list tool] + CountTool[memory_count tool] + end + + subgraph Backends[Memory Backends] + Sqlite[(sqlite<br/>Default, local file)] + Markdown[(markdown<br/>Daily .md files)] + Lucid[(lucid<br/>Cloud sync)] + None[(none<br/>In-memory only)] + end + + subgraph Categories[Memory Categories] + Conv[Conversation<br/>Chat transcripts] + Daily[Daily<br/>Session summaries] + Core[Core<br/>Long-term facts] + end + + AutoSave --> MemoryTrait[Memory trait] + StoreTool --> MemoryTrait + RecallTool --> MemoryTrait + ForgetTool --> MemoryTrait + GetTool --> MemoryTrait + ListTool --> MemoryTrait + CountTool --> MemoryTrait + + MemoryTrait --> Factory[create_memory factory] + Factory -->|config.memory.backend| BackendSelect{Backend?} + + BackendSelect -->|sqlite| Sqlite + BackendSelect -->|markdown| Markdown + BackendSelect -->|lucid| Lucid + BackendSelect -->|none| None + + Sqlite --> Categories + Markdown --> Categories + Lucid --> Categories + + Categories --> Storage[(Persistent Storage)] + + RAG[Hardware RAG] -.->|load_chunks| Markdown + + classDef frontend fill:#E8F4FD,stroke:#4A90E2 + classDef backend fill:#FFF4E6,stroke:#F5A623 + classDef category fill:#E8FDF5,stroke:#50C878 + classDef storage fill:#FDE8E8,stroke:#D0021B + + class AutoSave,StoreTool,RecallTool,ForgetTool,GetTool,ListTool,CountTool frontend + class Sqlite,Markdown,Lucid,None backend + class Conv,Daily,Core category + class Storage storage +``` + +--- + +## 9. Provider and Model Routing + +**LLM provider abstraction and routing:** + +```mermaid +flowchart TB + subgraph Providers[Supported Providers] + OR[OpenRouter] + Anth[Anthropic] + OAI[OpenAI] + OpenRouter[openrouter] + MiniMax[minimax] + DeepSeek[deepseek] + Kimi[kimi] + Custom[custom URL] + end + + subgraph Routing[Model Routing] + Routes[model_routes config<br/>Pattern -> Provider] + end + + subgraph Factory[Provider Factory] + Resilient[create_resilient_provider<br/>Retry + Timeout] + Routed[create_routed_provider<br/>Model-based routing] + end + + subgraph Traits[Provider Trait] + ChatSystem[chat_with_system<br/>Simple chat] + ChatHistory[chat_with_history<br/>Multi-turn] + ChatTools[chat_with_tools<br/>Native function calling] + Warmup[warmup<br/>Connection pool warmup] + SupportsNative[supports_native_tools<br/>Capability check] + end + + Providers --> Factory + Routes --> Factory + + Factory --> Traits + + ChatSystem --> LLM1[LLM API Call] + ChatHistory --> LLM2[LLM API Call] + ChatTools --> LLM3[LLM API Call + Functions] + + LLM1 --> Response[ChatMessage<br/>text + role] + LLM2 --> Response + LLM3 --> ToolResponse[ChatMessage + ToolCalls<br/>id, name, arguments] + + classDef provider fill:#E8F4FD,stroke:#4A90E2 + classDef routing fill:#FFF4E6,stroke:#F5A623 + classDef factory fill:#E8FDF5,stroke:#50C878 + classDef trait fill:#FDE8E8,stroke:#D0021B + + class OR,Anth,OAI,OpenRouter,MiniMax,DeepSeek,Kimi,Custom provider + class Routes routing + class Resilient,Routed factory + class ChatSystem,ChatHistory,ChatTools,Warmup,SupportsNative trait +``` + +--- + +## 10. Tool Execution Architecture + +**Tool registry, execution, and security:** + +```mermaid +flowchart TB + subgraph ToolCategories[Tool Categories] + Core[Core Tools<br/>shell, file_read, file_write] + Memory[Memory Tools<br/>store, recall, forget] + Schedule[Schedule Tools<br/>cron_add, cron_list, etc.] + Browser[Browser<br/>Brave integration] + Composio[Composio<br/>1000+ app actions] + Hardware[Hardware<br/>gpio_read, gpio_write,<br/>arduino_upload, etc.] + Delegate[Delegate<br/>Sub-agent routing] + Screenshot[screenshot<br/>Screen capture] + end + + subgraph Registry[Tool Registry] + AllTools[all_tools_with_runtime<br/>Factory function] + DefaultTools[default_tools<br/>Base set] + PeripheralTools[create_peripheral_tools<br/>Hardware-specific] + end + + subgraph Security[Security Policy] + AllowedCmds[allowed_commands<br/>Allowlist] + WorkspaceOnly[workspace_only<br/>Path restriction] + MaxActions[max_actions_per_hour<br/>Rate limit] + MaxCost[max_cost_per_day_cents<br/>Cost cap] + Approval[approval manager<br/>Supervised tools] + end + + subgraph Execution[Tool Execution] + Validate[Input validation<br/>Schema check] + Approve{Approval<br/>needed?} + Execute[execute async] + Scrub[Scrub credentials<br/>from output] + Result[ToolResult<br/>success, output, error] + end + + ToolCategories --> Registry + Registry --> Security + Security --> Execution + + Validate --> Approve + Approve -->|Yes| Prompt[Prompt CLI] + Approve -->|No / Approved| Execute + Approve -->|Denied| Denied[Return denied] + + Prompt --> UserChoice{User choice?} + UserChoice -->|Yes| Execute + UserChoice -->|No| Denied + + Execute --> Scrub + Scrub --> Result + Result --> Return[Return to agent loop] + + classDef tools fill:#E8F4FD,stroke:#4A90E2 + classDef registry fill:#FFF4E6,stroke:#F5A623 + classDef security fill:#FDE8E8,stroke:#D0021B + classDef exec fill:#E8FDF5,stroke:#50C878 + + class Core,Memory,Schedule,Browser,Composio,Hardware,Delegate,Screenshot tools + class AllTools,DefaultTools,PeripheralTools registry + class AllowedCmds,WorkspaceOnly,MaxActions,MaxCost,Approval security + class Validate,Approve,Prompt,Execute,Scrub,Result,Return exec +``` + +--- + +## 11. Configuration Loading + +**How configuration is loaded and merged:** + +```mermaid +flowchart TB + Start[Config::load_or_init] --> Exists{Config file<br/>exists?} + + Exists -->|No| RunWizard[Run onboard wizard] + RunWizard --> Save[Save config.toml] + Save --> Load[Load from file] + + Exists -->|Yes| Load + + Load --> Parse[TOML parse] + Parse --> Defaults[Apply defaults<br/>Config::default] + + Defaults --> EnvOverrides[apply_env_overrides<br/>ZEROCLAW_* env vars] + + EnvOverrides --> Validate[Schema validation] + + Validate --> Valid{Valid?} + Valid -->|No| Error[[Error: invalid config]] + Valid -->|Yes| Complete[Complete Config] + + Complete --> Paths[Paths<br/>workspace_dir, config_path] + Complete --> Providers[default_provider,<br/>api_key, api_url] + Complete --> Model[default_model,<br/>default_temperature] + Complete --> Gateway[gateway config<br/>port, host, pairing] + Complete --> Channels[channels_config<br/>telegram, discord, etc.] + Complete --> Memory[memory config<br/>backend, auto_save] + Complete --> Security[autonomy config<br/>level, allowed_commands] + Complete --> Reliability[reliability config<br/>timeouts, retries] + Complete --> Observability[observability<br/>backend, metrics] + Complete --> Runtime[runtime config<br/>kind, exec] + Complete --> Peripherals[peripherals<br/>boards, datasheet_dir] + Complete --> Cron[cron config<br/>enabled, db_path] + Complete --> Composio[composio<br/>enabled, api_key] + Complete --> Browser[browser<br/>enabled, allowlist] + Complete --> Tunnel[tunnel<br/>provider, token] + + classDef config fill:#E8F4FD,stroke:#4A90E2 + classDef error fill:#FDE8E8,stroke:#D0021B + classDef section fill:#FFF4E6,stroke:#F5A623 + + class Load,Parse,Defaults,EnvOverrides,Validate,Complete config + class Error error + class Paths,Providers,Model,Gateway,Channels,Memory,Security,Reliability,Observability,Runtime,Peripherals,Cron,Composio,Browser,Tunnel section +``` + +--- + +## 12. Hardware Peripherals Integration + +**Hardware board support and control:** + +```mermaid +flowchart TB + subgraph Boards[Supported Boards] + Nucleo[Nucleo-F401RE<br/>STM32F401RETx] + Uno[Arduino Uno<br/>ATmega328P] + UnoQ[Uno Q<br/>ESP32 WiFi bridge] + RPi[RPi GPIO<br/>Native Linux] + ESP32[ESP32<br/>Direct serial] + end + + subgraph Transport[Transport Layer] + Serial[Serial port<br/>/dev/ttyACM0, /dev/ttyUSB0] + USB[USB probe-rs<br/>ST-Link JTAG] + Native[Native GPIO<br/>Linux sysfs] + end + + subgraph Peripherals[Peripheral System] + Create[create_peripheral_tools<br/>Factory function] + GPIO[gpio_read/write<br/>Digital I/O] + Upload[arduino_upload<br/>Sketch flash] + MemMap[hardware_memory_map<br/>Address ranges] + BoardInfo[hardware_board_info<br/>Chip identification] + MemRead[hardware_memory_read<br/>Register dump] + Capabilities[hardware_capabilities<br/>Pin enumeration] + end + + subgraph RAG[Hardware RAG] + Datasheets[datasheet_dir<br/>.md documentation] + Chunks[Chunked embedding<br/>Semantic search] + PinAliases[Pin alias mapping<br/>red_led → 13] + end + + Boards --> Transport + Transport --> Peripherals + + RAG -.->|Context injection| Peripherals + + Create --> ToolRegistry[Tool registry] + GPIO --> ToolRegistry + Upload --> ToolRegistry + MemMap --> ToolRegistry + BoardInfo --> ToolRegistry + MemRead --> ToolRegistry + Capabilities --> ToolRegistry + + ToolRegistry --> Agent[Agent loop integration] + + classDef board fill:#E8F4FD,stroke:#4A90E2 + classDef transport fill:#FFF4E6,stroke:#F5A623 + classDef peripheral fill:#E8FDF5,stroke:#50C878 + classDef rag fill:#FDE8E8,stroke:#D0021B + + class Nucleo,Uno,UnoQ,RPi,ESP32 board + class Serial,USB,Native transport + class Create,GPIO,Upload,MemMap,BoardInfo,MemRead,Capabilities,ToolRegistry peripheral + class Datasheets,Chunks,PinAliases rag +``` + +--- + +## 13. Observable Events + +**Telemetry and observability flow:** + +```mermaid +flowchart TB + subgraph Observers[Observer Backends] + Noop[NoopObserver<br/>No-op / testing] + Console[ConsoleObserver<br/>Stdout logging] + Metrics[MetricsObserver<br/>Prometheus format] + end + + subgraph Events[Observable Events] + AgentStart[AgentStart<br/>provider, model] + LlmRequest[LlmRequest<br/>provider, model, msg_count] + LlmResponse[LlmResponse<br/>duration, success, error] + ToolCallStart[ToolCallStart<br/>tool name] + ToolCall[ToolCall<br/>tool, duration, success] + TurnComplete[TurnComplete<br/>end of agent loop] + AgentEnd[AgentEnd<br/>duration, tokens, cost] + end + + subgraph Outputs[Outputs] + Stdout[stdout trace logs] + MetricsFile[metrics.json<br/>JSON lines] + Prometheus[Prometheus<br/>Text format] + end + + Events --> Observers + Observers --> Outputs + + AgentStart --> Record[record_event] + LlmRequest --> Record + LlmResponse --> Record + ToolCallStart --> Record + ToolCall --> Record + TurnComplete --> Record + AgentEnd --> Record + + Record --> Dispatch[Dispatch to backend] + Dispatch --> Console + Dispatch --> Metrics + + Console --> Stdout + Metrics --> MetricsFile + + classDef observer fill:#E8F4FD,stroke:#4A90E2 + classDef event fill:#FFF4E6,stroke:#F5A623 + classDef output fill:#E8FDF5,stroke:#50C878 + + class Noop,Console,Metrics observer + class AgentStart,LlmRequest,LlmResponse,ToolCallStart,ToolCall,TurnComplete,AgentEnd,Record,Dispatch event + class Stdout,MetricsFile,Prometheus output +``` + +--- + +## Summary Diagram + +**Quick reference overview:** + +```mermaid +mindmap + root((ZeroClaw)) + Modes + Agent CLI + Interactive + Single-shot + Gateway + HTTP API + Webhooks + Daemon + Supervised + Multi-component + Channels + 12+ platforms + Components + Agent Loop + Tool calling + Memory aware + Providers + 50+ LLMs + Model routing + Channels + Real-time + Supervised + Tools + 30+ tools + Hardware control + Memory + 4 backends + RAG-capable + Security + Pairing + Approval + Policy + Integrations + Composio + 1000+ apps + Browser + Brave + Tunnel + Cloudflare + boringproxy + Hardware + STM32 + Arduino + ESP32 + RPi GPIO +``` + +--- + +*Generated for ZeroClaw v0.1.0 - Architecture Documentation* diff --git a/docs/architecture.svg b/docs/assets/architecture.svg similarity index 100% rename from docs/architecture.svg rename to docs/assets/architecture.svg diff --git a/docs/actions-source-policy.md b/docs/contributing/actions-source-policy.md similarity index 100% rename from docs/actions-source-policy.md rename to docs/contributing/actions-source-policy.md diff --git a/docs/adding-boards-and-tools.md b/docs/contributing/adding-boards-and-tools.md similarity index 100% rename from docs/adding-boards-and-tools.md rename to docs/contributing/adding-boards-and-tools.md diff --git a/docs/cargo-slicer-speedup.md b/docs/contributing/cargo-slicer-speedup.md similarity index 100% rename from docs/cargo-slicer-speedup.md rename to docs/contributing/cargo-slicer-speedup.md diff --git a/docs/ci-map.md b/docs/contributing/ci-map.md similarity index 100% rename from docs/ci-map.md rename to docs/contributing/ci-map.md diff --git a/docs/custom-providers.md b/docs/contributing/custom-providers.md similarity index 100% rename from docs/custom-providers.md rename to docs/contributing/custom-providers.md diff --git a/docs/doc-template.md b/docs/contributing/doc-template.md similarity index 100% rename from docs/doc-template.md rename to docs/contributing/doc-template.md diff --git a/docs/langgraph-integration.md b/docs/contributing/langgraph-integration.md similarity index 100% rename from docs/langgraph-integration.md rename to docs/contributing/langgraph-integration.md diff --git a/docs/pr-workflow.md b/docs/contributing/pr-workflow.md similarity index 100% rename from docs/pr-workflow.md rename to docs/contributing/pr-workflow.md diff --git a/docs/release-process.md b/docs/contributing/release-process.md similarity index 100% rename from docs/release-process.md rename to docs/contributing/release-process.md diff --git a/docs/reviewer-playbook.md b/docs/contributing/reviewer-playbook.md similarity index 100% rename from docs/reviewer-playbook.md rename to docs/contributing/reviewer-playbook.md diff --git a/docs/android-setup.md b/docs/hardware/android-setup.md similarity index 100% rename from docs/android-setup.md rename to docs/hardware/android-setup.md diff --git a/docs/arduino-uno-q-setup.md b/docs/hardware/arduino-uno-q-setup.md similarity index 100% rename from docs/arduino-uno-q-setup.md rename to docs/hardware/arduino-uno-q-setup.md diff --git a/docs/datasheets/arduino-uno.md b/docs/hardware/datasheets/arduino-uno.md similarity index 100% rename from docs/datasheets/arduino-uno.md rename to docs/hardware/datasheets/arduino-uno.md diff --git a/docs/datasheets/esp32.md b/docs/hardware/datasheets/esp32.md similarity index 100% rename from docs/datasheets/esp32.md rename to docs/hardware/datasheets/esp32.md diff --git a/docs/datasheets/nucleo-f401re.md b/docs/hardware/datasheets/nucleo-f401re.md similarity index 100% rename from docs/datasheets/nucleo-f401re.md rename to docs/hardware/datasheets/nucleo-f401re.md diff --git a/docs/hardware-peripherals-design.md b/docs/hardware/hardware-peripherals-design.md similarity index 100% rename from docs/hardware-peripherals-design.md rename to docs/hardware/hardware-peripherals-design.md diff --git a/docs/nucleo-setup.md b/docs/hardware/nucleo-setup.md similarity index 100% rename from docs/nucleo-setup.md rename to docs/hardware/nucleo-setup.md diff --git a/docs/project/README.md b/docs/maintainers/README.md similarity index 100% rename from docs/project/README.md rename to docs/maintainers/README.md diff --git a/docs/docs-inventory.md b/docs/maintainers/docs-inventory.md similarity index 100% rename from docs/docs-inventory.md rename to docs/maintainers/docs-inventory.md diff --git a/docs/i18n-coverage.md b/docs/maintainers/i18n-coverage.md similarity index 100% rename from docs/i18n-coverage.md rename to docs/maintainers/i18n-coverage.md diff --git a/docs/project-triage-snapshot-2026-02-18.md b/docs/maintainers/project-triage-snapshot-2026-02-18.md similarity index 100% rename from docs/project-triage-snapshot-2026-02-18.md rename to docs/maintainers/project-triage-snapshot-2026-02-18.md diff --git a/docs/maintainers/refactor-candidates.md b/docs/maintainers/refactor-candidates.md new file mode 100644 index 000000000..28f16768f --- /dev/null +++ b/docs/maintainers/refactor-candidates.md @@ -0,0 +1,135 @@ +# Refactor Candidates + +Largest source files in `src/`, ranked by severity. Each does multiple jobs in a single file, hurting readability, testability, and merge conflict frequency. + +| File | Lines | Problem | +|---|---|---| +| `config/schema.rs` | 7,647 | Every config struct for the entire system in one file | +| `onboard/wizard.rs` | 7,200 | Entire onboarding flow in one function-like blob | +| `channels/mod.rs` | 6,591 | Channel factory + shared logic + all wiring | +| `agent/loop_.rs` | 5,599 | The entire agent orchestration loop | +| `channels/telegram.rs` | 4,606 | One channel impl shouldn't be this big | +| `providers/mod.rs` | 2,903 | Provider factory + shared conversion logic | +| `gateway/mod.rs` | 2,777 | HTTP server setup + middleware + routing | + +## Additional Notes + +- `tools/mod.rs` (635 lines) has a 13-parameter `all_tools_with_runtime()` factory function that will get worse as tool count grows. Consider a registry/builder pattern. +- `security/policy.rs` (2,338 lines) mixes policy definition, action tracking, and validation — could split by concern. +- `providers/compatible.rs` (2,892 lines) and `providers/gemini.rs` (2,142 lines) are large for single provider implementations — likely mixing HTTP client logic, response parsing, and tool conversion. + +--- + +## Best Practices Audit Findings + +Findings from a general Rust/Python best-practices review (not project-specific conventions). + +### Critical: `.unwrap()` in production code (~2,800 instances) + +`.unwrap()` appears in I/O paths, serialization, and security-sensitive modules beyond test code. Example: + +```rust +// cost/tracker.rs +writeln!(file, "{}", serde_json::to_string(&old_record).unwrap()).unwrap(); +file.sync_all().unwrap(); +``` + +Rust best practice: use `.context("msg")?` or handle errors explicitly. Each unwrap is a potential runtime panic on transient failures. + +### Critical: `panic!` in production paths (28+ instances) + +Providers, pairing, and CLI routing use `panic!` instead of returning errors: + +```rust +// providers/bedrock.rs +panic!("Expected ToolResult block"); +// security/pairing.rs +panic!("Generated 10 pairs of codes and all were collisions — CSPRNG failure"); +``` + +These should be `bail!()` or typed error variants — panics are unrecoverable and crash the process. + +### Critical: Blanket clippy suppression (32+ lints globally) + +`main.rs` and `lib.rs` suppress `too_many_lines`, `similar_names`, `dead_code`, `missing_errors_doc`, and many others at crate level. This hides new violations as they accumulate. Best practice: suppress per-function with a justification comment, not globally. + +### High: Silent error swallowing (`let _ = ...` on Results, 30+ instances) + +Gateway, WebSocket, and skill sync paths discard `Result` values silently: + +```rust +let _ = state.event_tx.send(serde_json::json!({...})).await; +let _ = sender.send(Message::Text(err.to_string().into())).await; +let _ = mark_open_skills_synced(&repo_dir); +``` + +At minimum these should `tracing::warn!` on failure. Silent drops make distributed debugging nearly impossible. + +### High: God struct — `Config` with 30+ fields + +Every subsystem that needs any configuration must hold the entire `Config` struct, creating implicit coupling and bloated test setup. Best practice: pass narrow config slices or trait-bounded config objects. + +### High: Security code not isolated + +Shell command validation (300+ lines of quote-aware parsing), webhook signature verification, and pairing logic are embedded in large multipurpose files rather than isolated modules. This complicates security audits and increases regression risk from unrelated changes. + +### Medium: Excessive `.clone()` (~1,227 instances) + +Auth/token refresh paths clone large structs on every branch. Hot paths like token access could use `Cow<'_>` or `Arc` instead of full clones. + +### Medium: Test depth — mostly smoke tests + +193 test modules exist (good structural coverage), but most are simple value assertions. Missing: + +- Property-based testing for parsers/validators +- Integration tests for multi-module flows +- Fuzz testing for the shell command parser (security surface) +- Mock-based tests for network-dependent paths + +### Medium: Dependency count (82 direct) + +The project claims size optimization as a goal (`opt-level = "z"`, `lto = "fat"`) while accumulating heavy optional deps like `matrix-sdk` (full E2EE crypto) and `probe-rs` (50+ transitive deps). The tension between size goals and feature breadth is unresolved. + +### Low: `unsafe` without safety comments + +Two instances in `src/service/mod.rs` for `libc::getuid()` — no `// SAFETY:` comment. Could use the `nix` crate's safe wrapper instead. + +### Low: Python code quality + +The `python/` subtree has minimal type hints, no docstrings on key functions, and no parametrized tests. Inconsistent with the Rust side's rigor. + +### Low: Minimal `rustfmt.toml` + +Only sets `edition = "2021"`. For a project this size, configuring `max_width`, `imports_granularity`, `group_imports` would enforce consistency as contributor count grows. + +## Priority Recommendations + +1. **Replace unwraps/panics in non-test code** with proper error propagation — highest stability impact. +2. **Split god modules** — extract runtime orchestration from `channels/mod.rs`, isolate security parsing, break `Config` into sub-configs. +3. **Remove global clippy suppressions** — fix violations individually or add per-item `#[allow]` with reasoning. +4. **Replace `let _ =` on Results** with at minimum `tracing::warn!` logging. +5. **Add property/fuzz tests** for security-surface parsers (shell command validation, webhook signatures). + +--- + +## Deferred Structural Refactorings + +Changes deferred from the project-cleanup pass. Each entry includes rationale and scope. + +### Rename `src/sop/` to `src/runbooks/` + +**Why:** "SOP" is jargon-heavy and doesn't communicate what the module does. "Runbooks" is the industry-standard term for trigger-driven automated procedures with approval gates. + +**Scope:** Rename module (`src/sop/` → `src/runbooks/`), update config keys (`[sop]` → `[runbooks]`), CLI subcommand (`zeroclaw sop` → `zeroclaw runbook`), all internal types (`Sop*` → `Runbook*`), docs (`docs/sop/` → matching new structure), and references in CLAUDE.md. + +### Consolidate i18n docs into `docs/i18n/<locale>/` + +**Why:** Vietnamese translations currently exist in three places: `docs/i18n/vi/` (canonical per CLAUDE.md), `docs/vi/` (stale duplicate with 17 files diverged), and `docs/*.vi.md` (5 scattered suffix files). Other locales (zh-CN, ja, ru, fr) have SUMMARY + README files scattered in `docs/` root. + +**Plan:** +- Keep `docs/i18n/vi/` as canonical; delete `docs/vi/` (stale duplicate) +- Move `docs/*.vi.md` files into `docs/i18n/vi/` at matching paths +- Move `docs/SUMMARY.*.md` and `docs/README.*.md` into `docs/i18n/<locale>/` +- Create `docs/i18n/{zh-CN,ja,ru,fr}/` directories with their README + SUMMARY +- Root `README.*.md` files stay (GitHub convention) +- Update `docs/i18n/vi/` internal structure to mirror the new English docs layout after the English restructure lands diff --git a/docs/maintainers/repo-map.md b/docs/maintainers/repo-map.md new file mode 100644 index 000000000..928aeac5c --- /dev/null +++ b/docs/maintainers/repo-map.md @@ -0,0 +1,255 @@ +# ZeroClaw Repository Map + +ZeroClaw is a Rust-first autonomous agent runtime. It receives messages from messaging platforms, routes them through an LLM, executes tool calls, persists memory, and returns responses. It can also control hardware peripherals and run as a long-lived daemon. + +## Runtime Flow + +``` +User message (Telegram/Discord/Slack/...) + │ + ▼ + ┌─────────┐ ┌────────────┐ + │ Channel │────▶│ Agent │ (src/agent/) + └─────────┘ │ Loop │ + │ │◀──── Memory Loader (loads relevant context) + │ │◀──── System Prompt Builder + │ │◀──── Query Classifier (model routing) + └─────┬──────┘ + │ + ▼ + ┌───────────┐ + │ Provider │ (LLM: Anthropic, OpenAI, Gemini, etc.) + └─────┬─────┘ + │ + tool calls? + ┌────┴────┐ + ▼ ▼ + ┌────────┐ text response + │ Tools │ │ + └────┬───┘ │ + │ │ + ▼ ▼ + feed results send back + back to LLM via Channel +``` + +--- + +## Top-Level Layout + +``` +zeroclaw/ +├── src/ # Rust source (the runtime) +├── crates/robot-kit/ # Separate crate for hardware robot kit +├── tests/ # Integration/E2E tests +├── benches/ # Benchmarks (agent loop) +├── examples/ # Extension examples (custom provider/channel/tool/memory) +├── firmware/ # Embedded firmware for Arduino, ESP32, Nucleo boards +├── web/ # Web UI (Vite + TypeScript) +├── python/ # Python SDK / tools bridge +├── dev/ # Local dev tooling (Docker, CI scripts, sandbox) +├── scripts/ # CI scripts, release automation, bootstrap +├── docs/ # Documentation system (multilingual, runtime refs) +├── .github/ # CI workflows, PR templates, automation +├── playground/ # (empty, experimental scratch space) +├── Cargo.toml # Workspace manifest +├── Dockerfile # Container build +├── docker-compose.yml # Service composition +├── flake.nix # Nix dev environment +└── bootstrap.sh # One-command setup script +``` + +--- + +## src/ — Module-by-Module + +### Entrypoints + +| File | Lines | Role | +|---|---|---| +| `main.rs` | 1,977 | CLI entrypoint. Clap parser, command dispatch. All `zeroclaw <subcommand>` routing lives here. | +| `lib.rs` | 436 | Module declarations, visibility (`pub` vs `pub(crate)`), CLI command enums (`ServiceCommands`, `ChannelCommands`, `SkillCommands`, etc.) shared between lib and binary. | + +### Core Runtime + +| Module | Key Files | Role | +|---|---|---| +| `agent/` | `agent.rs`, `loop_.rs` (5.6k), `dispatcher.rs`, `prompt.rs`, `classifier.rs`, `memory_loader.rs` | **The brain.** `AgentBuilder` composes provider+tools+memory+observer. `loop_.rs` runs the multi-turn tool-calling loop. Dispatcher handles native vs XML tool call parsing. Classifier routes queries to different models. | +| `config/` | `schema.rs` (7.6k), `mod.rs`, `traits.rs` | **All configuration structs.** Every subsystem's config lives in `schema.rs` — providers, channels, memory, security, gateway, tools, hardware, scheduling, etc. Loaded from TOML. | +| `runtime/` | `native.rs`, `docker.rs`, `wasm.rs`, `traits.rs` | **Platform adapters.** `RuntimeAdapter` trait abstracts shell access, filesystem, storage paths, memory budgets. Native = direct OS. Docker = container isolation. WASM = experimental. | + +### LLM Providers + +| Module | Key Files | Role | +|---|---|---| +| `providers/` | `traits.rs`, `mod.rs` (2.9k), `reliable.rs`, `router.rs`, + 11 provider files | **LLM integrations.** `Provider` trait: `chat()`, `chat_with_system()`, `capabilities()`, `convert_tools()`. Factory in `mod.rs` creates providers by name. `ReliableProvider` wraps any provider with retry/fallback chains. `RoutedProvider` routes by classifier hints. | + +Providers: `anthropic`, `openai`, `openai_codex`, `openrouter`, `gemini`, `ollama`, `compatible` (OpenAI-compat), `copilot`, `bedrock`, `telnyx`, `glm` + +### Messaging Channels + +| Module | Key Files | Role | +|---|---|---| +| `channels/` | `traits.rs`, `mod.rs` (6.6k), + 22 channel files | **Input/output transports.** `Channel` trait: `send()`, `listen()`, `health_check()`, `start_typing()`, draft updates. Factory in `mod.rs` wires config to channel instances, manages per-sender conversation history (max 50 messages). | + +Channels: `telegram` (4.6k), `discord`, `slack`, `whatsapp`, `whatsapp_web`, `matrix`, `signal`, `email_channel`, `qq`, `dingtalk`, `lark`, `imessage`, `irc`, `nostr`, `mattermost`, `nextcloud_talk`, `wati`, `mqtt`, `linq`, `clawdtalk`, `cli` + +### Tools (Agent Capabilities) + +| Module | Key Files | Role | +|---|---|---| +| `tools/` | `traits.rs`, `mod.rs` (635), + 38 tool files | **What the agent can do.** `Tool` trait: `name()`, `description()`, `parameters_schema()`, `execute()`. Two registries: `default_tools()` (6 essentials) and `all_tools_with_runtime()` (full set, config-gated). | + +Tool categories: +- **File/Shell**: `shell`, `file_read`, `file_write`, `file_edit`, `glob_search`, `content_search` +- **Memory**: `memory_store`, `memory_recall`, `memory_forget` +- **Web**: `browser`, `browser_open`, `web_fetch`, `web_search_tool`, `http_request` +- **Scheduling**: `cron_add`, `cron_list`, `cron_remove`, `cron_update`, `cron_run`, `cron_runs`, `schedule` +- **Delegation**: `delegate` (sub-agent spawning), `composio` (OAuth integrations) +- **Hardware**: `hardware_board_info`, `hardware_memory_map`, `hardware_memory_read` +- **SOP**: `sop_execute`, `sop_advance`, `sop_approve`, `sop_list`, `sop_status` +- **Utility**: `git_operations`, `image_info`, `pdf_read`, `screenshot`, `pushover`, `model_routing_config`, `proxy_config`, `cli_discovery`, `schema` + +### Memory + +| Module | Key Files | Role | +|---|---|---| +| `memory/` | `traits.rs`, `backend.rs`, `mod.rs`, + 8 backend files | **Persistent knowledge.** `Memory` trait: `store()`, `recall()`, `get()`, `list()`, `forget()`, `count()`. Categories: Core, Daily, Conversation, Custom. | + +Backends: `sqlite`, `markdown`, `lucid` (hybrid SQLite + embeddings), `qdrant` (vector DB), `postgres`, `none` + +Supporting: `embeddings.rs` (embedding generation), `vector.rs` (vector ops), `chunker.rs` (text splitting), `hygiene.rs` (cleanup), `snapshot.rs` (backup), `response_cache.rs` (caching), `cli.rs` (CLI commands) + +### Security + +| Module | Key Files | Role | +|---|---|---| +| `security/` | `policy.rs` (2.3k), `secrets.rs`, `pairing.rs`, `prompt_guard.rs`, `leak_detector.rs`, `audit.rs`, `otp.rs`, `estop.rs`, `domain_matcher.rs`, + 4 sandbox files | **Policy engine and enforcement.** `SecurityPolicy`: autonomy levels (ReadOnly/Supervised/Full), workspace confinement, command allowlists, forbidden paths, rate limits, cost caps. | + +Sandboxing: `bubblewrap.rs`, `firejail.rs`, `landlock.rs`, `docker.rs`, `detect.rs` (auto-detect best available) + +### Gateway (HTTP API) + +| Module | Key Files | Role | +|---|---|---| +| `gateway/` | `mod.rs` (2.8k), `api.rs` (1.4k), `sse.rs`, `ws.rs`, `static_files.rs` | **Axum HTTP server.** Webhook receivers (WhatsApp, WATI, Linq, Nextcloud Talk), REST API, SSE streaming, WebSocket support. Rate limiting, idempotency keys, 64KB body limit, 30s timeout. | + +### Hardware & Peripherals + +| Module | Key Files | Role | +|---|---|---| +| `peripherals/` | `traits.rs`, `mod.rs`, `serial.rs`, `rpi.rs`, `arduino_flash.rs`, `uno_q_bridge.rs`, `uno_q_setup.rs`, `nucleo_flash.rs`, `capabilities_tool.rs` | **Hardware board abstraction.** `Peripheral` trait: `connect()`, `disconnect()`, `health_check()`, `tools()`. Each peripheral exposes its capabilities as Tools the agent can call. | +| `hardware/` | `discover.rs`, `introspect.rs`, `registry.rs`, `mod.rs` | **USB discovery and board identification.** Scans VID/PID, matches known boards, introspects connected devices. | + +### Observability + +| Module | Key Files | Role | +|---|---|---| +| `observability/` | `traits.rs`, `mod.rs`, `log.rs`, `prometheus.rs`, `otel.rs`, `verbose.rs`, `noop.rs`, `multi.rs`, `runtime_trace.rs` | **Metrics and tracing.** `Observer` trait: `log_event()`. Composite observer (`multi.rs`) fans out to multiple backends. | + +### Skills & SkillForge + +| Module | Key Files | Role | +|---|---|---| +| `skills/` | `mod.rs` (1.5k), `audit.rs` | **User/community-authored capabilities.** Loaded from `~/.zeroclaw/workspace/skills/<name>/SKILL.md`. CLI: list, install, audit, remove. Optional community sync from open-skills repo. | +| `skillforge/` | `scout.rs`, `evaluate.rs`, `integrate.rs`, `mod.rs` | **Skill discovery and evaluation.** Scouts for skills, evaluates quality/fitness, integrates into the runtime. | + +### SOP (Standard Operating Procedures) + +| Module | Key Files | Role | +|---|---|---| +| `sop/` | `engine.rs` (1.6k), `metrics.rs` (1.5k), `types.rs`, `dispatch.rs`, `condition.rs`, `gates.rs`, `audit.rs`, `mod.rs` | **Workflow engine.** Define multi-step procedures with conditions, gates (approval checkpoints), and metrics. Agent can execute, advance, and audit SOP runs. | + +### Scheduling & Lifecycle + +| Module | Key Files | Role | +|---|---|---| +| `cron/` | `scheduler.rs`, `schedule.rs`, `store.rs`, `types.rs`, `mod.rs` | **Task scheduler.** Cron expressions, one-shot timers, fixed intervals. Persistent store. | +| `heartbeat/` | `engine.rs`, `mod.rs` | **Liveness monitor.** Periodic health checks on channels/gateway. | +| `daemon/` | `mod.rs` | **Long-running daemon.** Starts gateway + channels + heartbeat + scheduler together. | +| `service/` | `mod.rs` (1.3k) | **OS service management.** Install/start/stop/restart via systemd or launchd. | +| `hooks/` | `mod.rs`, `runner.rs`, `traits.rs`, `builtin/` | **Lifecycle hooks.** Run user scripts on events (pre/post tool execution, message received, etc.). | + +### Supporting Modules + +| Module | Key Files | Role | +|---|---|---| +| `onboard/` | `wizard.rs` (7.2k), `mod.rs` | **First-run setup wizard.** Interactive or quick-mode onboarding: provider, API key, channels, memory backend. | +| `auth/` | `profiles.rs`, `anthropic_token.rs`, `gemini_oauth.rs`, `openai_oauth.rs`, `oauth_common.rs` | **Auth profiles and OAuth flows.** Per-provider credential management. | +| `approval/` | `mod.rs` | **Approval workflows.** Gate risky actions behind human approval. | +| `doctor/` | `mod.rs` (1.3k) | **Diagnostics.** Checks daemon health, scheduler freshness, channel connectivity. | +| `health/` | `mod.rs` | **Health check endpoints.** | +| `cost/` | `tracker.rs`, `types.rs`, `mod.rs` | **Cost tracking.** Per-session and per-day cost accounting. | +| `tunnel/` | `cloudflare.rs`, `ngrok.rs`, `tailscale.rs`, `custom.rs`, `none.rs`, `mod.rs` | **Tunnel adapters.** Expose gateway via Cloudflare, ngrok, Tailscale, or custom tunnels. | +| `rag/` | `mod.rs` | **Retrieval-augmented generation.** PDF extraction, chunking support. | +| `integrations/` | `registry.rs`, `mod.rs` | **Integration registry.** Catalog of third-party integrations. | +| `identity.rs` | (1.5k) | **Agent identity.** Name, description, persona for the agent instance. | +| `multimodal.rs` | — | **Multimodal support.** Image/vision handling config. | +| `migration.rs` | — | **Data migration.** Import from OpenClaw workspaces. | +| `util.rs` | — | **Shared utilities.** | + +--- + +## Outside src/ + +| Directory | Role | +|---|---| +| `crates/robot-kit/` | Separate Rust crate for hardware robot kit functionality | +| `tests/` | Integration and E2E tests (agent loop, config persistence, channel routing, provider resolution, webhook security) | +| `benches/` | Performance benchmarks (`agent_benchmarks.rs`) | +| `examples/` | Extension examples: `custom_channel.rs`, `custom_memory.rs`, `custom_provider.rs`, `custom_tool.rs` | +| `firmware/` | Embedded firmware: `zeroclaw-arduino/`, `zeroclaw-esp32/`, `zeroclaw-esp32-ui/`, `zeroclaw-nucleo/`, `zeroclaw-uno-q-bridge/` | +| `web/` | Web UI frontend (Vite + TypeScript) | +| `python/` | Python SDK / tools bridge with its own tests | +| `dev/` | Local development: Docker Compose, CI script (`ci.sh`), config template, sandbox configs | +| `scripts/` | CI helpers, release automation, bootstrap, contributor tier computation | +| `docs/` | Documentation system: multilingual (en/zh-CN/ja/ru/fr/vi), runtime references, operations runbooks, security proposals | +| `.github/` | CI workflows, PR templates, issue templates, automation | + +--- + +## Dependency Direction + +``` +main.rs ──▶ agent/ ──▶ providers/ (LLM calls) + │──▶ tools/ (capability execution) + │──▶ memory/ (context persistence) + │──▶ observability/ (event logging) + │──▶ security/ (policy enforcement) + │──▶ config/ (all config structs) + │──▶ runtime/ (platform abstraction) + │ +main.rs ──▶ channels/ ──▶ agent/ (message routing) +main.rs ──▶ gateway/ ──▶ agent/ (HTTP/WS routing) +main.rs ──▶ daemon/ ──▶ gateway/ + channels/ + cron/ + heartbeat/ + +Concrete modules depend inward on traits/config. +Traits never import concrete implementations. +``` + +--- + +## CLI Command Tree + +``` +zeroclaw +├── onboard [--interactive] [--force] # First-run setup +├── agent [-m "msg"] [-p provider] # Start agent loop +├── daemon [-p port] # Full runtime (gateway+channels+cron+heartbeat) +├── gateway [-p port] # HTTP API server only +├── channel {list|start|doctor|add|remove|bind-telegram} +├── skill {list|install|audit|remove} +├── memory {list|get|stats|clear} +├── cron {list|add|add-at|add-every|once|remove|update|pause|resume} +├── peripheral {list|add|flash|flash-nucleo|setup-uno-q} +├── hardware {discover|introspect|info} +├── service {install|start|stop|restart|status|uninstall} +├── doctor # Diagnostics +├── status # System overview +├── estop [--level] [status|resume] # Emergency stop +├── migrate openclaw # Data migration +├── pair # Device pairing +├── auth-profiles # Credential management +├── version / completions # Meta +└── config {show|edit|validate|reset} +``` diff --git a/docs/structure/README.md b/docs/maintainers/structure-README.md similarity index 100% rename from docs/structure/README.md rename to docs/maintainers/structure-README.md diff --git a/docs/project/trademark.md b/docs/maintainers/trademark.md similarity index 100% rename from docs/project/trademark.md rename to docs/maintainers/trademark.md diff --git a/docs/operations/README.md b/docs/ops/README.md similarity index 100% rename from docs/operations/README.md rename to docs/ops/README.md diff --git a/docs/network-deployment.md b/docs/ops/network-deployment.md similarity index 100% rename from docs/network-deployment.md rename to docs/ops/network-deployment.md diff --git a/docs/operations-runbook.md b/docs/ops/operations-runbook.md similarity index 100% rename from docs/operations-runbook.md rename to docs/ops/operations-runbook.md diff --git a/docs/proxy-agent-playbook.md b/docs/ops/proxy-agent-playbook.md similarity index 100% rename from docs/proxy-agent-playbook.md rename to docs/ops/proxy-agent-playbook.md diff --git a/docs/resource-limits.md b/docs/ops/resource-limits.md similarity index 100% rename from docs/resource-limits.md rename to docs/ops/resource-limits.md diff --git a/docs/troubleshooting.md b/docs/ops/troubleshooting.md similarity index 100% rename from docs/troubleshooting.md rename to docs/ops/troubleshooting.md diff --git a/docs/troubleshooting.vi.md b/docs/ops/troubleshooting.vi.md similarity index 100% rename from docs/troubleshooting.vi.md rename to docs/ops/troubleshooting.vi.md diff --git a/docs/channels-reference.md b/docs/reference/api/channels-reference.md similarity index 100% rename from docs/channels-reference.md rename to docs/reference/api/channels-reference.md diff --git a/docs/config-reference.md b/docs/reference/api/config-reference.md similarity index 100% rename from docs/config-reference.md rename to docs/reference/api/config-reference.md diff --git a/docs/config-reference.vi.md b/docs/reference/api/config-reference.vi.md similarity index 100% rename from docs/config-reference.vi.md rename to docs/reference/api/config-reference.vi.md diff --git a/docs/providers-reference.md b/docs/reference/api/providers-reference.md similarity index 100% rename from docs/providers-reference.md rename to docs/reference/api/providers-reference.md diff --git a/docs/commands-reference.md b/docs/reference/cli/commands-reference.md similarity index 100% rename from docs/commands-reference.md rename to docs/reference/cli/commands-reference.md diff --git a/docs/commands-reference.vi.md b/docs/reference/cli/commands-reference.vi.md similarity index 100% rename from docs/commands-reference.vi.md rename to docs/reference/cli/commands-reference.vi.md diff --git a/docs/sop/README.md b/docs/reference/sop/README.md similarity index 100% rename from docs/sop/README.md rename to docs/reference/sop/README.md diff --git a/docs/sop/connectivity.md b/docs/reference/sop/connectivity.md similarity index 100% rename from docs/sop/connectivity.md rename to docs/reference/sop/connectivity.md diff --git a/docs/sop/cookbook.md b/docs/reference/sop/cookbook.md similarity index 100% rename from docs/sop/cookbook.md rename to docs/reference/sop/cookbook.md diff --git a/docs/sop/observability.md b/docs/reference/sop/observability.md similarity index 100% rename from docs/sop/observability.md rename to docs/reference/sop/observability.md diff --git a/docs/sop/syntax.md b/docs/reference/sop/syntax.md similarity index 100% rename from docs/sop/syntax.md rename to docs/reference/sop/syntax.md diff --git a/docs/agnostic-security.md b/docs/security/agnostic-security.md similarity index 100% rename from docs/agnostic-security.md rename to docs/security/agnostic-security.md diff --git a/docs/audit-logging.md b/docs/security/audit-logging.md similarity index 100% rename from docs/audit-logging.md rename to docs/security/audit-logging.md diff --git a/docs/frictionless-security.md b/docs/security/frictionless-security.md similarity index 100% rename from docs/frictionless-security.md rename to docs/security/frictionless-security.md diff --git a/docs/matrix-e2ee-guide.md b/docs/security/matrix-e2ee-guide.md similarity index 100% rename from docs/matrix-e2ee-guide.md rename to docs/security/matrix-e2ee-guide.md diff --git a/docs/sandboxing.md b/docs/security/sandboxing.md similarity index 100% rename from docs/sandboxing.md rename to docs/security/sandboxing.md diff --git a/docs/security-roadmap.md b/docs/security/security-roadmap.md similarity index 100% rename from docs/security-roadmap.md rename to docs/security/security-roadmap.md diff --git a/docs/getting-started/README.md b/docs/setup-guides/README.md similarity index 100% rename from docs/getting-started/README.md rename to docs/setup-guides/README.md diff --git a/docs/getting-started/README.vi.md b/docs/setup-guides/README.vi.md similarity index 100% rename from docs/getting-started/README.vi.md rename to docs/setup-guides/README.vi.md diff --git a/docs/getting-started/macos-update-uninstall.md b/docs/setup-guides/macos-update-uninstall.md similarity index 100% rename from docs/getting-started/macos-update-uninstall.md rename to docs/setup-guides/macos-update-uninstall.md diff --git a/docs/mattermost-setup.md b/docs/setup-guides/mattermost-setup.md similarity index 100% rename from docs/mattermost-setup.md rename to docs/setup-guides/mattermost-setup.md diff --git a/docs/nextcloud-talk-setup.md b/docs/setup-guides/nextcloud-talk-setup.md similarity index 100% rename from docs/nextcloud-talk-setup.md rename to docs/setup-guides/nextcloud-talk-setup.md diff --git a/docs/one-click-bootstrap.md b/docs/setup-guides/one-click-bootstrap.md similarity index 100% rename from docs/one-click-bootstrap.md rename to docs/setup-guides/one-click-bootstrap.md diff --git a/docs/one-click-bootstrap.vi.md b/docs/setup-guides/one-click-bootstrap.vi.md similarity index 100% rename from docs/one-click-bootstrap.vi.md rename to docs/setup-guides/one-click-bootstrap.vi.md diff --git a/docs/zai-glm-setup.md b/docs/setup-guides/zai-glm-setup.md similarity index 100% rename from docs/zai-glm-setup.md rename to docs/setup-guides/zai-glm-setup.md diff --git a/docs/contributing/testing-telegram.md b/tests/telegram/testing-telegram.md similarity index 100% rename from docs/contributing/testing-telegram.md rename to tests/telegram/testing-telegram.md From 9f2655dc4d8448331f8c764a2d9162dcefa2ac4a Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 <simianastronaut7@gmail.com> Date: Mon, 9 Mar 2026 22:33:59 -0400 Subject: [PATCH 12/35] refactor: - Move `recompute_contributor_tiers.sh` to automate the labeling of contributors based on their merged PR counts. - Removed web/dist from git tracking (mistake) --- .gitignore | 1 + .../recompute_contributor_tiers.sh | 0 web/dist/assets/index-DEhGL4Jw.css | 1 - web/dist/assets/index-Dam-egf7.js | 295 ------------------ web/dist/index.html | 14 - 5 files changed, 1 insertion(+), 310 deletions(-) rename {scripts => dev}/recompute_contributor_tiers.sh (100%) delete mode 100644 web/dist/assets/index-DEhGL4Jw.css delete mode 100644 web/dist/assets/index-Dam-egf7.js delete mode 100644 web/dist/index.html diff --git a/.gitignore b/.gitignore index 89a1f8b5b..26014160a 100644 --- a/.gitignore +++ b/.gitignore @@ -1,5 +1,6 @@ /target firmware/*/target +web/dist/ *.db *.db-journal .DS_Store diff --git a/scripts/recompute_contributor_tiers.sh b/dev/recompute_contributor_tiers.sh similarity index 100% rename from scripts/recompute_contributor_tiers.sh rename to dev/recompute_contributor_tiers.sh diff --git a/web/dist/assets/index-DEhGL4Jw.css b/web/dist/assets/index-DEhGL4Jw.css deleted file mode 100644 index 98d9dcf9a..000000000 --- a/web/dist/assets/index-DEhGL4Jw.css +++ /dev/null @@ -1 +0,0 @@ -/*! tailwindcss v4.2.0 | MIT License | https://tailwindcss.com */@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-translate-x:0;--tw-translate-y:0;--tw-translate-z:0;--tw-space-y-reverse:0;--tw-border-style:solid;--tw-font-weight:initial;--tw-tracking:initial;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000}}}@layer theme{:root,:host{--font-sans:ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--color-red-300:oklch(80.8% .114 19.571);--color-red-400:oklch(70.4% .191 22.216);--color-red-500:oklch(63.7% .237 25.331);--color-red-700:oklch(50.5% .213 27.518);--color-red-900:oklch(39.6% .141 25.723);--color-orange-400:oklch(75% .183 55.934);--color-orange-600:oklch(64.6% .222 41.116);--color-yellow-300:oklch(90.5% .182 98.111);--color-yellow-400:oklch(85.2% .199 91.936);--color-yellow-500:oklch(79.5% .184 86.047);--color-yellow-600:oklch(68.1% .162 75.834);--color-yellow-700:oklch(55.4% .135 66.442);--color-yellow-900:oklch(42.1% .095 57.708);--color-green-300:oklch(87.1% .15 154.449);--color-green-400:oklch(79.2% .209 151.711);--color-green-500:oklch(72.3% .219 149.579);--color-green-600:oklch(62.7% .194 149.214);--color-green-700:oklch(52.7% .154 150.069);--color-green-900:oklch(39.3% .095 152.535);--color-blue-200:oklch(88.2% .059 254.128);--color-blue-300:oklch(80.9% .105 251.813);--color-blue-400:oklch(70.7% .165 254.624);--color-blue-500:oklch(62.3% .214 259.815);--color-blue-600:oklch(54.6% .245 262.881);--color-blue-700:oklch(48.8% .243 264.376);--color-blue-900:oklch(37.9% .146 265.522);--color-purple-400:oklch(71.4% .203 305.504);--color-purple-500:oklch(62.7% .265 303.9);--color-purple-600:oklch(55.8% .288 302.321);--color-purple-700:oklch(49.6% .265 301.924);--color-purple-900:oklch(38.1% .176 304.987);--color-gray-100:oklch(96.7% .003 264.542);--color-gray-200:oklch(92.8% .006 264.531);--color-gray-300:oklch(87.2% .01 258.338);--color-gray-400:oklch(70.7% .022 261.325);--color-gray-500:oklch(55.1% .027 264.364);--color-gray-600:oklch(44.6% .03 256.802);--color-gray-700:oklch(37.3% .034 259.733);--color-gray-800:oklch(27.8% .033 256.848);--color-gray-900:oklch(21% .034 264.665);--color-gray-950:oklch(13% .028 261.692);--color-black:#000;--color-white:#fff;--spacing:.25rem;--container-md:28rem;--container-4xl:56rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-base:1rem;--text-base--line-height: 1.5 ;--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--text-xl:1.25rem;--text-xl--line-height:calc(1.75 / 1.25);--text-2xl:1.5rem;--text-2xl--line-height:calc(2 / 1.5);--font-weight-normal:400;--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--tracking-wide:.025em;--tracking-wider:.05em;--tracking-widest:.1em;--radius-md:.375rem;--radius-lg:.5rem;--radius-xl:.75rem;--animate-spin:spin 1s linear infinite;--animate-bounce:bounce 1s infinite;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono);--color-bg-primary:#0a0a0f;--color-bg-secondary:#12121a;--color-bg-card:#1a1a2e;--color-bg-card-hover:#22223a;--color-border-default:#2a2a3e;--color-accent-blue:#3b82f6;--color-text-primary:#e2e8f0;--color-text-muted:#64748b}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.inset-0{inset:calc(var(--spacing) * 0)}.start{inset-inline-start:var(--spacing)}.end{inset-inline-end:var(--spacing)}.top-0{top:calc(var(--spacing) * 0)}.top-1\/2{top:50%}.left-0{left:calc(var(--spacing) * 0)}.left-3{left:calc(var(--spacing) * 3)}.z-50{z-index:50}.col-span-2{grid-column:span 2/span 2}.mx-4{margin-inline:calc(var(--spacing) * 4)}.mx-auto{margin-inline:auto}.mt-0\.5{margin-top:calc(var(--spacing) * .5)}.mt-1{margin-top:calc(var(--spacing) * 1)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mt-4{margin-top:calc(var(--spacing) * 4)}.mt-6{margin-top:calc(var(--spacing) * 6)}.mb-1{margin-bottom:calc(var(--spacing) * 1)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.mb-3{margin-bottom:calc(var(--spacing) * 3)}.mb-4{margin-bottom:calc(var(--spacing) * 4)}.mb-6{margin-bottom:calc(var(--spacing) * 6)}.ml-1{margin-left:calc(var(--spacing) * 1)}.ml-2{margin-left:calc(var(--spacing) * 2)}.ml-60{margin-left:calc(var(--spacing) * 60)}.ml-auto{margin-left:auto}.line-clamp-2{-webkit-line-clamp:2;-webkit-box-orient:vertical;display:-webkit-box;overflow:hidden}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.h-2{height:calc(var(--spacing) * 2)}.h-2\.5{height:calc(var(--spacing) * 2.5)}.h-3{height:calc(var(--spacing) * 3)}.h-3\.5{height:calc(var(--spacing) * 3.5)}.h-4{height:calc(var(--spacing) * 4)}.h-5{height:calc(var(--spacing) * 5)}.h-8{height:calc(var(--spacing) * 8)}.h-10{height:calc(var(--spacing) * 10)}.h-12{height:calc(var(--spacing) * 12)}.h-14{height:calc(var(--spacing) * 14)}.h-32{height:calc(var(--spacing) * 32)}.h-64{height:calc(var(--spacing) * 64)}.h-\[calc\(100vh-3\.5rem\)\]{height:calc(100vh - 3.5rem)}.h-full{height:100%}.h-screen{height:100vh}.max-h-64{max-height:calc(var(--spacing) * 64)}.min-h-\[500px\]{min-height:500px}.min-h-screen{min-height:100vh}.w-2{width:calc(var(--spacing) * 2)}.w-2\.5{width:calc(var(--spacing) * 2.5)}.w-3{width:calc(var(--spacing) * 3)}.w-3\.5{width:calc(var(--spacing) * 3.5)}.w-4{width:calc(var(--spacing) * 4)}.w-5{width:calc(var(--spacing) * 5)}.w-8{width:calc(var(--spacing) * 8)}.w-10{width:calc(var(--spacing) * 10)}.w-12{width:calc(var(--spacing) * 12)}.w-20{width:calc(var(--spacing) * 20)}.w-60{width:calc(var(--spacing) * 60)}.w-full{width:100%}.w-px{width:1px}.max-w-4xl{max-width:var(--container-4xl)}.max-w-\[75\%\]{max-width:75%}.max-w-\[200px\]{max-width:200px}.max-w-\[300px\]{max-width:300px}.max-w-md{max-width:var(--container-md)}.min-w-0{min-width:calc(var(--spacing) * 0)}.flex-1{flex:1}.flex-shrink-0{flex-shrink:0}.-translate-y-1\/2{--tw-translate-y: -50% ;translate:var(--tw-translate-x) var(--tw-translate-y)}.animate-bounce{animation:var(--animate-bounce)}.animate-spin{animation:var(--animate-spin)}.cursor-pointer{cursor:pointer}.resize-none{resize:none}.resize-y{resize:vertical}.appearance-none{-webkit-appearance:none;-moz-appearance:none;appearance:none}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.flex-col{flex-direction:column}.flex-row-reverse{flex-direction:row-reverse}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.items-start{align-items:flex-start}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-1{gap:calc(var(--spacing) * 1)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.gap-6{gap:calc(var(--spacing) * 6)}:where(.space-y-1>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 1) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 1) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 4) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 4) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-6>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 6) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 6) * calc(1 - var(--tw-space-y-reverse)))}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-full{border-radius:3.40282e38px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-xl{border-radius:var(--radius-xl)}.border{border-style:var(--tw-border-style);border-width:1px}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-r{border-right-style:var(--tw-border-style);border-right-width:1px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-blue-500{border-color:var(--color-blue-500)}.border-blue-700\/50{border-color:#1447e680}@supports (color:color-mix(in lab,red,red)){.border-blue-700\/50{border-color:color-mix(in oklab,var(--color-blue-700) 50%,transparent)}}.border-gray-600{border-color:var(--color-gray-600)}.border-gray-700{border-color:var(--color-gray-700)}.border-gray-800{border-color:var(--color-gray-800)}.border-gray-800\/50{border-color:#1e293980}@supports (color:color-mix(in lab,red,red)){.border-gray-800\/50{border-color:color-mix(in oklab,var(--color-gray-800) 50%,transparent)}}.border-green-500\/30{border-color:#00c7584d}@supports (color:color-mix(in lab,red,red)){.border-green-500\/30{border-color:color-mix(in oklab,var(--color-green-500) 30%,transparent)}}.border-green-700{border-color:var(--color-green-700)}.border-green-700\/40{border-color:#00813866}@supports (color:color-mix(in lab,red,red)){.border-green-700\/40{border-color:color-mix(in oklab,var(--color-green-700) 40%,transparent)}}.border-green-700\/50{border-color:#00813880}@supports (color:color-mix(in lab,red,red)){.border-green-700\/50{border-color:color-mix(in oklab,var(--color-green-700) 50%,transparent)}}.border-purple-700\/50{border-color:#8200da80}@supports (color:color-mix(in lab,red,red)){.border-purple-700\/50{border-color:color-mix(in oklab,var(--color-purple-700) 50%,transparent)}}.border-red-500\/30{border-color:#fb2c364d}@supports (color:color-mix(in lab,red,red)){.border-red-500\/30{border-color:color-mix(in oklab,var(--color-red-500) 30%,transparent)}}.border-red-700{border-color:var(--color-red-700)}.border-red-700\/40{border-color:#bf000f66}@supports (color:color-mix(in lab,red,red)){.border-red-700\/40{border-color:color-mix(in oklab,var(--color-red-700) 40%,transparent)}}.border-red-700\/50{border-color:#bf000f80}@supports (color:color-mix(in lab,red,red)){.border-red-700\/50{border-color:color-mix(in oklab,var(--color-red-700) 50%,transparent)}}.border-yellow-500\/30{border-color:#edb2004d}@supports (color:color-mix(in lab,red,red)){.border-yellow-500\/30{border-color:color-mix(in oklab,var(--color-yellow-500) 30%,transparent)}}.border-yellow-700\/40{border-color:#a3610066}@supports (color:color-mix(in lab,red,red)){.border-yellow-700\/40{border-color:color-mix(in oklab,var(--color-yellow-700) 40%,transparent)}}.border-yellow-700\/50{border-color:#a3610080}@supports (color:color-mix(in lab,red,red)){.border-yellow-700\/50{border-color:color-mix(in oklab,var(--color-yellow-700) 50%,transparent)}}.border-t-transparent{border-top-color:#0000}.bg-black\/60{background-color:#0009}@supports (color:color-mix(in lab,red,red)){.bg-black\/60{background-color:color-mix(in oklab,var(--color-black) 60%,transparent)}}.bg-blue-500{background-color:var(--color-blue-500)}.bg-blue-600{background-color:var(--color-blue-600)}.bg-blue-600\/20{background-color:#155dfc33}@supports (color:color-mix(in lab,red,red)){.bg-blue-600\/20{background-color:color-mix(in oklab,var(--color-blue-600) 20%,transparent)}}.bg-blue-900\/40{background-color:#1c398e66}@supports (color:color-mix(in lab,red,red)){.bg-blue-900\/40{background-color:color-mix(in oklab,var(--color-blue-900) 40%,transparent)}}.bg-blue-900\/50{background-color:#1c398e80}@supports (color:color-mix(in lab,red,red)){.bg-blue-900\/50{background-color:color-mix(in oklab,var(--color-blue-900) 50%,transparent)}}.bg-gray-400{background-color:var(--color-gray-400)}.bg-gray-500{background-color:var(--color-gray-500)}.bg-gray-700{background-color:var(--color-gray-700)}.bg-gray-800{background-color:var(--color-gray-800)}.bg-gray-800\/50{background-color:#1e293980}@supports (color:color-mix(in lab,red,red)){.bg-gray-800\/50{background-color:color-mix(in oklab,var(--color-gray-800) 50%,transparent)}}.bg-gray-900{background-color:var(--color-gray-900)}.bg-gray-900\/80{background-color:#101828cc}@supports (color:color-mix(in lab,red,red)){.bg-gray-900\/80{background-color:color-mix(in oklab,var(--color-gray-900) 80%,transparent)}}.bg-gray-950{background-color:var(--color-gray-950)}.bg-green-500{background-color:var(--color-green-500)}.bg-green-600{background-color:var(--color-green-600)}.bg-green-600\/20{background-color:#00a54433}@supports (color:color-mix(in lab,red,red)){.bg-green-600\/20{background-color:color-mix(in oklab,var(--color-green-600) 20%,transparent)}}.bg-green-900\/10{background-color:#0d542b1a}@supports (color:color-mix(in lab,red,red)){.bg-green-900\/10{background-color:color-mix(in oklab,var(--color-green-900) 10%,transparent)}}.bg-green-900\/30{background-color:#0d542b4d}@supports (color:color-mix(in lab,red,red)){.bg-green-900\/30{background-color:color-mix(in oklab,var(--color-green-900) 30%,transparent)}}.bg-green-900\/40{background-color:#0d542b66}@supports (color:color-mix(in lab,red,red)){.bg-green-900\/40{background-color:color-mix(in oklab,var(--color-green-900) 40%,transparent)}}.bg-green-900\/50{background-color:#0d542b80}@supports (color:color-mix(in lab,red,red)){.bg-green-900\/50{background-color:color-mix(in oklab,var(--color-green-900) 50%,transparent)}}.bg-orange-600\/20{background-color:#f0510033}@supports (color:color-mix(in lab,red,red)){.bg-orange-600\/20{background-color:color-mix(in oklab,var(--color-orange-600) 20%,transparent)}}.bg-purple-500{background-color:var(--color-purple-500)}.bg-purple-600\/20{background-color:#9810fa33}@supports (color:color-mix(in lab,red,red)){.bg-purple-600\/20{background-color:color-mix(in oklab,var(--color-purple-600) 20%,transparent)}}.bg-purple-900\/50{background-color:#59168b80}@supports (color:color-mix(in lab,red,red)){.bg-purple-900\/50{background-color:color-mix(in oklab,var(--color-purple-900) 50%,transparent)}}.bg-red-500{background-color:var(--color-red-500)}.bg-red-900\/10{background-color:#82181a1a}@supports (color:color-mix(in lab,red,red)){.bg-red-900\/10{background-color:color-mix(in oklab,var(--color-red-900) 10%,transparent)}}.bg-red-900\/30{background-color:#82181a4d}@supports (color:color-mix(in lab,red,red)){.bg-red-900\/30{background-color:color-mix(in oklab,var(--color-red-900) 30%,transparent)}}.bg-red-900\/40{background-color:#82181a66}@supports (color:color-mix(in lab,red,red)){.bg-red-900\/40{background-color:color-mix(in oklab,var(--color-red-900) 40%,transparent)}}.bg-red-900\/50{background-color:#82181a80}@supports (color:color-mix(in lab,red,red)){.bg-red-900\/50{background-color:color-mix(in oklab,var(--color-red-900) 50%,transparent)}}.bg-yellow-500{background-color:var(--color-yellow-500)}.bg-yellow-600{background-color:var(--color-yellow-600)}.bg-yellow-900\/10{background-color:#733e0a1a}@supports (color:color-mix(in lab,red,red)){.bg-yellow-900\/10{background-color:color-mix(in oklab,var(--color-yellow-900) 10%,transparent)}}.bg-yellow-900\/20{background-color:#733e0a33}@supports (color:color-mix(in lab,red,red)){.bg-yellow-900\/20{background-color:color-mix(in oklab,var(--color-yellow-900) 20%,transparent)}}.bg-yellow-900\/40{background-color:#733e0a66}@supports (color:color-mix(in lab,red,red)){.bg-yellow-900\/40{background-color:color-mix(in oklab,var(--color-yellow-900) 40%,transparent)}}.bg-yellow-900\/50{background-color:#733e0a80}@supports (color:color-mix(in lab,red,red)){.bg-yellow-900\/50{background-color:color-mix(in oklab,var(--color-yellow-900) 50%,transparent)}}.p-2{padding:calc(var(--spacing) * 2)}.p-3{padding:calc(var(--spacing) * 3)}.p-4{padding:calc(var(--spacing) * 4)}.p-5{padding:calc(var(--spacing) * 5)}.p-6{padding:calc(var(--spacing) * 6)}.p-8{padding:calc(var(--spacing) * 8)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.px-5{padding-inline:calc(var(--spacing) * 5)}.px-6{padding-inline:calc(var(--spacing) * 6)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:calc(var(--spacing) * 1)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-2\.5{padding-block:calc(var(--spacing) * 2.5)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-4{padding-block:calc(var(--spacing) * 4)}.py-5{padding-block:calc(var(--spacing) * 5)}.py-16{padding-block:calc(var(--spacing) * 16)}.pt-3{padding-top:calc(var(--spacing) * 3)}.pr-4{padding-right:calc(var(--spacing) * 4)}.pr-8{padding-right:calc(var(--spacing) * 8)}.pl-10{padding-left:calc(var(--spacing) * 10)}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.font-mono{font-family:var(--font-mono)}.text-2xl{font-size:var(--text-2xl);line-height:var(--tw-leading,var(--text-2xl--line-height))}.text-base{font-size:var(--text-base);line-height:var(--tw-leading,var(--text-base--line-height))}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xl{font-size:var(--text-xl);line-height:var(--tw-leading,var(--text-xl--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-normal{--tw-font-weight:var(--font-weight-normal);font-weight:var(--font-weight-normal)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-wide{--tw-tracking:var(--tracking-wide);letter-spacing:var(--tracking-wide)}.tracking-wider{--tw-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider)}.tracking-widest{--tw-tracking:var(--tracking-widest);letter-spacing:var(--tracking-widest)}.break-words{overflow-wrap:break-word}.break-all{word-break:break-all}.whitespace-nowrap{white-space:nowrap}.whitespace-pre-wrap{white-space:pre-wrap}.text-blue-200{color:var(--color-blue-200)}.text-blue-400{color:var(--color-blue-400)}.text-blue-500{color:var(--color-blue-500)}.text-gray-100{color:var(--color-gray-100)}.text-gray-200{color:var(--color-gray-200)}.text-gray-300{color:var(--color-gray-300)}.text-gray-400{color:var(--color-gray-400)}.text-gray-500{color:var(--color-gray-500)}.text-gray-600{color:var(--color-gray-600)}.text-green-300{color:var(--color-green-300)}.text-green-400{color:var(--color-green-400)}.text-orange-400{color:var(--color-orange-400)}.text-purple-400{color:var(--color-purple-400)}.text-red-300{color:var(--color-red-300)}.text-red-400{color:var(--color-red-400)}.text-white{color:var(--color-white)}.text-yellow-300{color:var(--color-yellow-300)}.text-yellow-400{color:var(--color-yellow-400)}.text-yellow-400\/70{color:#fac800b3}@supports (color:color-mix(in lab,red,red)){.text-yellow-400\/70{color:color-mix(in oklab,var(--color-yellow-400) 70%,transparent)}}.capitalize{text-transform:capitalize}.uppercase{text-transform:uppercase}.placeholder-gray-500::placeholder{color:var(--color-gray-500)}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}@media(hover:hover){.hover\:border-gray-700:hover{border-color:var(--color-gray-700)}.hover\:bg-blue-700:hover{background-color:var(--color-blue-700)}.hover\:bg-gray-700:hover{background-color:var(--color-gray-700)}.hover\:bg-gray-800:hover{background-color:var(--color-gray-800)}.hover\:bg-gray-800\/30:hover{background-color:#1e29394d}@supports (color:color-mix(in lab,red,red)){.hover\:bg-gray-800\/30:hover{background-color:color-mix(in oklab,var(--color-gray-800) 30%,transparent)}}.hover\:bg-gray-800\/50:hover{background-color:#1e293980}@supports (color:color-mix(in lab,red,red)){.hover\:bg-gray-800\/50:hover{background-color:color-mix(in oklab,var(--color-gray-800) 50%,transparent)}}.hover\:bg-green-700:hover{background-color:var(--color-green-700)}.hover\:bg-yellow-700:hover{background-color:var(--color-yellow-700)}.hover\:text-blue-300:hover{color:var(--color-blue-300)}.hover\:text-red-300:hover{color:var(--color-red-300)}.hover\:text-red-400:hover{color:var(--color-red-400)}.hover\:text-white:hover{color:var(--color-white)}}.focus\:border-blue-500:focus{border-color:var(--color-blue-500)}.focus\:border-transparent:focus{border-color:#0000}.focus\:ring-2:focus{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.focus\:ring-blue-500:focus{--tw-ring-color:var(--color-blue-500)}.focus\:ring-offset-0:focus{--tw-ring-offset-width:0px;--tw-ring-offset-shadow:var(--tw-ring-inset,) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color)}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}.focus\:ring-inset:focus{--tw-ring-inset:inset}.disabled\:bg-gray-700:disabled{background-color:var(--color-gray-700)}.disabled\:text-gray-500:disabled{color:var(--color-gray-500)}.disabled\:opacity-50:disabled{opacity:.5}@media(min-width:40rem){.sm\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.sm\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.sm\:flex-row{flex-direction:row}}@media(min-width:48rem){.md\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}}@media(min-width:64rem){.lg\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.lg\:grid-cols-4{grid-template-columns:repeat(4,minmax(0,1fr))}}@media(min-width:80rem){.xl\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}}}html{color-scheme:dark}body{background-color:var(--color-bg-primary);color:var(--color-text-primary);-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;font-family:Inter,ui-sans-serif,system-ui,-apple-system,sans-serif}#root{min-height:100vh}::-webkit-scrollbar{width:8px;height:8px}::-webkit-scrollbar-track{background:var(--color-bg-secondary)}::-webkit-scrollbar-thumb{background:var(--color-border-default);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--color-text-muted)}.card{background-color:var(--color-bg-card);border:1px solid var(--color-border-default);border-radius:.75rem}.card:hover{background-color:var(--color-bg-card-hover)}:focus-visible{outline:2px solid var(--color-accent-blue);outline-offset:2px}@property --tw-translate-x{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-y{syntax:"*";inherits:false;initial-value:0}@property --tw-translate-z{syntax:"*";inherits:false;initial-value:0}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@keyframes spin{to{transform:rotate(360deg)}}@keyframes bounce{0%,to{animation-timing-function:cubic-bezier(.8,0,1,1);transform:translateY(-25%)}50%{animation-timing-function:cubic-bezier(0,0,.2,1);transform:none}} diff --git a/web/dist/assets/index-Dam-egf7.js b/web/dist/assets/index-Dam-egf7.js deleted file mode 100644 index 7c751f5da..000000000 --- a/web/dist/assets/index-Dam-egf7.js +++ /dev/null @@ -1,295 +0,0 @@ -var Ly=Object.defineProperty;var By=(i,o,f)=>o in i?Ly(i,o,{enumerable:!0,configurable:!0,writable:!0,value:f}):i[o]=f;var we=(i,o,f)=>By(i,typeof o!="symbol"?o+"":o,f);(function(){const o=document.createElement("link").relList;if(o&&o.supports&&o.supports("modulepreload"))return;for(const m of document.querySelectorAll('link[rel="modulepreload"]'))r(m);new MutationObserver(m=>{for(const h of m)if(h.type==="childList")for(const x of h.addedNodes)x.tagName==="LINK"&&x.rel==="modulepreload"&&r(x)}).observe(document,{childList:!0,subtree:!0});function f(m){const h={};return m.integrity&&(h.integrity=m.integrity),m.referrerPolicy&&(h.referrerPolicy=m.referrerPolicy),m.crossOrigin==="use-credentials"?h.credentials="include":m.crossOrigin==="anonymous"?h.credentials="omit":h.credentials="same-origin",h}function r(m){if(m.ep)return;m.ep=!0;const h=f(m);fetch(m.href,h)}})();function _m(i){return i&&i.__esModule&&Object.prototype.hasOwnProperty.call(i,"default")?i.default:i}var Os={exports:{}},Hn={};/** - * @license React - * react-jsx-runtime.production.js - * - * Copyright (c) Meta Platforms, Inc. and affiliates. - * - * This source code is licensed under the MIT license found in the - * LICENSE file in the root directory of this source tree. - */var fm;function qy(){if(fm)return Hn;fm=1;var i=Symbol.for("react.transitional.element"),o=Symbol.for("react.fragment");function f(r,m,h){var x=null;if(h!==void 0&&(x=""+h),m.key!==void 0&&(x=""+m.key),"key"in m){h={};for(var j in m)j!=="key"&&(h[j]=m[j])}else h=m;return m=h.ref,{$$typeof:i,type:r,key:x,ref:m!==void 0?m:null,props:h}}return Hn.Fragment=o,Hn.jsx=f,Hn.jsxs=f,Hn}var dm;function Yy(){return dm||(dm=1,Os.exports=qy()),Os.exports}var c=Yy(),Us={exports:{}},le={};/** - * @license React - * react.production.js - * - * Copyright (c) Meta Platforms, Inc. and affiliates. - * - * This source code is licensed under the MIT license found in the - * LICENSE file in the root directory of this source tree. - */var mm;function Gy(){if(mm)return le;mm=1;var i=Symbol.for("react.transitional.element"),o=Symbol.for("react.portal"),f=Symbol.for("react.fragment"),r=Symbol.for("react.strict_mode"),m=Symbol.for("react.profiler"),h=Symbol.for("react.consumer"),x=Symbol.for("react.context"),j=Symbol.for("react.forward_ref"),v=Symbol.for("react.suspense"),y=Symbol.for("react.memo"),A=Symbol.for("react.lazy"),b=Symbol.for("react.activity"),U=Symbol.iterator;function L(N){return N===null||typeof N!="object"?null:(N=U&&N[U]||N["@@iterator"],typeof N=="function"?N:null)}var q={isMounted:function(){return!1},enqueueForceUpdate:function(){},enqueueReplaceState:function(){},enqueueSetState:function(){}},Y=Object.assign,B={};function G(N,O,X){this.props=N,this.context=O,this.refs=B,this.updater=X||q}G.prototype.isReactComponent={},G.prototype.setState=function(N,O){if(typeof N!="object"&&typeof N!="function"&&N!=null)throw Error("takes an object of state variables to update or a function which returns an object of state variables.");this.updater.enqueueSetState(this,N,O,"setState")},G.prototype.forceUpdate=function(N){this.updater.enqueueForceUpdate(this,N,"forceUpdate")};function Q(){}Q.prototype=G.prototype;function H(N,O,X){this.props=N,this.context=O,this.refs=B,this.updater=X||q}var ee=H.prototype=new Q;ee.constructor=H,Y(ee,G.prototype),ee.isPureReactComponent=!0;var I=Array.isArray;function oe(){}var W={H:null,A:null,T:null,S:null},J=Object.prototype.hasOwnProperty;function Ee(N,O,X){var V=X.ref;return{$$typeof:i,type:N,key:O,ref:V!==void 0?V:null,props:X}}function We(N,O){return Ee(N.type,O,N.props)}function St(N){return typeof N=="object"&&N!==null&&N.$$typeof===i}function Fe(N){var O={"=":"=0",":":"=2"};return"$"+N.replace(/[=:]/g,function(X){return O[X]})}var Gt=/\/+/g;function te(N,O){return typeof N=="object"&&N!==null&&N.key!=null?Fe(""+N.key):O.toString(36)}function ke(N){switch(N.status){case"fulfilled":return N.value;case"rejected":throw N.reason;default:switch(typeof N.status=="string"?N.then(oe,oe):(N.status="pending",N.then(function(O){N.status==="pending"&&(N.status="fulfilled",N.value=O)},function(O){N.status==="pending"&&(N.status="rejected",N.reason=O)})),N.status){case"fulfilled":return N.value;case"rejected":throw N.reason}}throw N}function w(N,O,X,V,ae){var ce=typeof N;(ce==="undefined"||ce==="boolean")&&(N=null);var xe=!1;if(N===null)xe=!0;else switch(ce){case"bigint":case"string":case"number":xe=!0;break;case"object":switch(N.$$typeof){case i:case o:xe=!0;break;case A:return xe=N._init,w(xe(N._payload),O,X,V,ae)}}if(xe)return ae=ae(N),xe=V===""?"."+te(N,0):V,I(ae)?(X="",xe!=null&&(X=xe.replace(Gt,"$&/")+"/"),w(ae,O,X,"",function(ka){return ka})):ae!=null&&(St(ae)&&(ae=We(ae,X+(ae.key==null||N&&N.key===ae.key?"":(""+ae.key).replace(Gt,"$&/")+"/")+xe)),O.push(ae)),1;xe=0;var Pe=V===""?".":V+":";if(I(N))for(var Oe=0;Oe<N.length;Oe++)V=N[Oe],ce=Pe+te(V,Oe),xe+=w(V,O,X,ce,ae);else if(Oe=L(N),typeof Oe=="function")for(N=Oe.call(N),Oe=0;!(V=N.next()).done;)V=V.value,ce=Pe+te(V,Oe++),xe+=w(V,O,X,ce,ae);else if(ce==="object"){if(typeof N.then=="function")return w(ke(N),O,X,V,ae);throw O=String(N),Error("Objects are not valid as a React child (found: "+(O==="[object Object]"?"object with keys {"+Object.keys(N).join(", ")+"}":O)+"). If you meant to render a collection of children, use an array instead.")}return xe}function k(N,O,X){if(N==null)return N;var V=[],ae=0;return w(N,V,"","",function(ce){return O.call(X,ce,ae++)}),V}function P(N){if(N._status===-1){var O=N._result;O=O(),O.then(function(X){(N._status===0||N._status===-1)&&(N._status=1,N._result=X)},function(X){(N._status===0||N._status===-1)&&(N._status=2,N._result=X)}),N._status===-1&&(N._status=0,N._result=O)}if(N._status===1)return N._result.default;throw N._result}var be=typeof reportError=="function"?reportError:function(N){if(typeof window=="object"&&typeof window.ErrorEvent=="function"){var O=new window.ErrorEvent("error",{bubbles:!0,cancelable:!0,message:typeof N=="object"&&N!==null&&typeof N.message=="string"?String(N.message):String(N),error:N});if(!window.dispatchEvent(O))return}else if(typeof process=="object"&&typeof process.emit=="function"){process.emit("uncaughtException",N);return}console.error(N)},Te={map:k,forEach:function(N,O,X){k(N,function(){O.apply(this,arguments)},X)},count:function(N){var O=0;return k(N,function(){O++}),O},toArray:function(N){return k(N,function(O){return O})||[]},only:function(N){if(!St(N))throw Error("React.Children.only expected to receive a single React element child.");return N}};return le.Activity=b,le.Children=Te,le.Component=G,le.Fragment=f,le.Profiler=m,le.PureComponent=H,le.StrictMode=r,le.Suspense=v,le.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE=W,le.__COMPILER_RUNTIME={__proto__:null,c:function(N){return W.H.useMemoCache(N)}},le.cache=function(N){return function(){return N.apply(null,arguments)}},le.cacheSignal=function(){return null},le.cloneElement=function(N,O,X){if(N==null)throw Error("The argument must be a React element, but you passed "+N+".");var V=Y({},N.props),ae=N.key;if(O!=null)for(ce in O.key!==void 0&&(ae=""+O.key),O)!J.call(O,ce)||ce==="key"||ce==="__self"||ce==="__source"||ce==="ref"&&O.ref===void 0||(V[ce]=O[ce]);var ce=arguments.length-2;if(ce===1)V.children=X;else if(1<ce){for(var xe=Array(ce),Pe=0;Pe<ce;Pe++)xe[Pe]=arguments[Pe+2];V.children=xe}return Ee(N.type,ae,V)},le.createContext=function(N){return N={$$typeof:x,_currentValue:N,_currentValue2:N,_threadCount:0,Provider:null,Consumer:null},N.Provider=N,N.Consumer={$$typeof:h,_context:N},N},le.createElement=function(N,O,X){var V,ae={},ce=null;if(O!=null)for(V in O.key!==void 0&&(ce=""+O.key),O)J.call(O,V)&&V!=="key"&&V!=="__self"&&V!=="__source"&&(ae[V]=O[V]);var xe=arguments.length-2;if(xe===1)ae.children=X;else if(1<xe){for(var Pe=Array(xe),Oe=0;Oe<xe;Oe++)Pe[Oe]=arguments[Oe+2];ae.children=Pe}if(N&&N.defaultProps)for(V in xe=N.defaultProps,xe)ae[V]===void 0&&(ae[V]=xe[V]);return Ee(N,ce,ae)},le.createRef=function(){return{current:null}},le.forwardRef=function(N){return{$$typeof:j,render:N}},le.isValidElement=St,le.lazy=function(N){return{$$typeof:A,_payload:{_status:-1,_result:N},_init:P}},le.memo=function(N,O){return{$$typeof:y,type:N,compare:O===void 0?null:O}},le.startTransition=function(N){var O=W.T,X={};W.T=X;try{var V=N(),ae=W.S;ae!==null&&ae(X,V),typeof V=="object"&&V!==null&&typeof V.then=="function"&&V.then(oe,be)}catch(ce){be(ce)}finally{O!==null&&X.types!==null&&(O.types=X.types),W.T=O}},le.unstable_useCacheRefresh=function(){return W.H.useCacheRefresh()},le.use=function(N){return W.H.use(N)},le.useActionState=function(N,O,X){return W.H.useActionState(N,O,X)},le.useCallback=function(N,O){return W.H.useCallback(N,O)},le.useContext=function(N){return W.H.useContext(N)},le.useDebugValue=function(){},le.useDeferredValue=function(N,O){return W.H.useDeferredValue(N,O)},le.useEffect=function(N,O){return W.H.useEffect(N,O)},le.useEffectEvent=function(N){return W.H.useEffectEvent(N)},le.useId=function(){return W.H.useId()},le.useImperativeHandle=function(N,O,X){return W.H.useImperativeHandle(N,O,X)},le.useInsertionEffect=function(N,O){return W.H.useInsertionEffect(N,O)},le.useLayoutEffect=function(N,O){return W.H.useLayoutEffect(N,O)},le.useMemo=function(N,O){return W.H.useMemo(N,O)},le.useOptimistic=function(N,O){return W.H.useOptimistic(N,O)},le.useReducer=function(N,O,X){return W.H.useReducer(N,O,X)},le.useRef=function(N){return W.H.useRef(N)},le.useState=function(N){return W.H.useState(N)},le.useSyncExternalStore=function(N,O,X){return W.H.useSyncExternalStore(N,O,X)},le.useTransition=function(){return W.H.useTransition()},le.version="19.2.4",le}var hm;function Ws(){return hm||(hm=1,Us.exports=Gy()),Us.exports}var p=Ws();const wm=_m(p);var Hs={exports:{}},Ln={},Ls={exports:{}},Bs={};/** - * @license React - * scheduler.production.js - * - * Copyright (c) Meta Platforms, Inc. and affiliates. - * - * This source code is licensed under the MIT license found in the - * LICENSE file in the root directory of this source tree. - */var ym;function ky(){return ym||(ym=1,(function(i){function o(w,k){var P=w.length;w.push(k);e:for(;0<P;){var be=P-1>>>1,Te=w[be];if(0<m(Te,k))w[be]=k,w[P]=Te,P=be;else break e}}function f(w){return w.length===0?null:w[0]}function r(w){if(w.length===0)return null;var k=w[0],P=w.pop();if(P!==k){w[0]=P;e:for(var be=0,Te=w.length,N=Te>>>1;be<N;){var O=2*(be+1)-1,X=w[O],V=O+1,ae=w[V];if(0>m(X,P))V<Te&&0>m(ae,X)?(w[be]=ae,w[V]=P,be=V):(w[be]=X,w[O]=P,be=O);else if(V<Te&&0>m(ae,P))w[be]=ae,w[V]=P,be=V;else break e}}return k}function m(w,k){var P=w.sortIndex-k.sortIndex;return P!==0?P:w.id-k.id}if(i.unstable_now=void 0,typeof performance=="object"&&typeof performance.now=="function"){var h=performance;i.unstable_now=function(){return h.now()}}else{var x=Date,j=x.now();i.unstable_now=function(){return x.now()-j}}var v=[],y=[],A=1,b=null,U=3,L=!1,q=!1,Y=!1,B=!1,G=typeof setTimeout=="function"?setTimeout:null,Q=typeof clearTimeout=="function"?clearTimeout:null,H=typeof setImmediate<"u"?setImmediate:null;function ee(w){for(var k=f(y);k!==null;){if(k.callback===null)r(y);else if(k.startTime<=w)r(y),k.sortIndex=k.expirationTime,o(v,k);else break;k=f(y)}}function I(w){if(Y=!1,ee(w),!q)if(f(v)!==null)q=!0,oe||(oe=!0,Fe());else{var k=f(y);k!==null&&ke(I,k.startTime-w)}}var oe=!1,W=-1,J=5,Ee=-1;function We(){return B?!0:!(i.unstable_now()-Ee<J)}function St(){if(B=!1,oe){var w=i.unstable_now();Ee=w;var k=!0;try{e:{q=!1,Y&&(Y=!1,Q(W),W=-1),L=!0;var P=U;try{t:{for(ee(w),b=f(v);b!==null&&!(b.expirationTime>w&&We());){var be=b.callback;if(typeof be=="function"){b.callback=null,U=b.priorityLevel;var Te=be(b.expirationTime<=w);if(w=i.unstable_now(),typeof Te=="function"){b.callback=Te,ee(w),k=!0;break t}b===f(v)&&r(v),ee(w)}else r(v);b=f(v)}if(b!==null)k=!0;else{var N=f(y);N!==null&&ke(I,N.startTime-w),k=!1}}break e}finally{b=null,U=P,L=!1}k=void 0}}finally{k?Fe():oe=!1}}}var Fe;if(typeof H=="function")Fe=function(){H(St)};else if(typeof MessageChannel<"u"){var Gt=new MessageChannel,te=Gt.port2;Gt.port1.onmessage=St,Fe=function(){te.postMessage(null)}}else Fe=function(){G(St,0)};function ke(w,k){W=G(function(){w(i.unstable_now())},k)}i.unstable_IdlePriority=5,i.unstable_ImmediatePriority=1,i.unstable_LowPriority=4,i.unstable_NormalPriority=3,i.unstable_Profiling=null,i.unstable_UserBlockingPriority=2,i.unstable_cancelCallback=function(w){w.callback=null},i.unstable_forceFrameRate=function(w){0>w||125<w?console.error("forceFrameRate takes a positive int between 0 and 125, forcing frame rates higher than 125 fps is not supported"):J=0<w?Math.floor(1e3/w):5},i.unstable_getCurrentPriorityLevel=function(){return U},i.unstable_next=function(w){switch(U){case 1:case 2:case 3:var k=3;break;default:k=U}var P=U;U=k;try{return w()}finally{U=P}},i.unstable_requestPaint=function(){B=!0},i.unstable_runWithPriority=function(w,k){switch(w){case 1:case 2:case 3:case 4:case 5:break;default:w=3}var P=U;U=w;try{return k()}finally{U=P}},i.unstable_scheduleCallback=function(w,k,P){var be=i.unstable_now();switch(typeof P=="object"&&P!==null?(P=P.delay,P=typeof P=="number"&&0<P?be+P:be):P=be,w){case 1:var Te=-1;break;case 2:Te=250;break;case 5:Te=1073741823;break;case 4:Te=1e4;break;default:Te=5e3}return Te=P+Te,w={id:A++,callback:k,priorityLevel:w,startTime:P,expirationTime:Te,sortIndex:-1},P>be?(w.sortIndex=P,o(y,w),f(v)===null&&w===f(y)&&(Y?(Q(W),W=-1):Y=!0,ke(I,P-be))):(w.sortIndex=Te,o(v,w),q||L||(q=!0,oe||(oe=!0,Fe()))),w},i.unstable_shouldYield=We,i.unstable_wrapCallback=function(w){var k=U;return function(){var P=U;U=k;try{return w.apply(this,arguments)}finally{U=P}}}})(Bs)),Bs}var gm;function Xy(){return gm||(gm=1,Ls.exports=ky()),Ls.exports}var qs={exports:{}},Ie={};/** - * @license React - * react-dom.production.js - * - * Copyright (c) Meta Platforms, Inc. and affiliates. - * - * This source code is licensed under the MIT license found in the - * LICENSE file in the root directory of this source tree. - */var xm;function Qy(){if(xm)return Ie;xm=1;var i=Ws();function o(v){var y="https://react.dev/errors/"+v;if(1<arguments.length){y+="?args[]="+encodeURIComponent(arguments[1]);for(var A=2;A<arguments.length;A++)y+="&args[]="+encodeURIComponent(arguments[A])}return"Minified React error #"+v+"; visit "+y+" for the full message or use the non-minified dev environment for full errors and additional helpful warnings."}function f(){}var r={d:{f,r:function(){throw Error(o(522))},D:f,C:f,L:f,m:f,X:f,S:f,M:f},p:0,findDOMNode:null},m=Symbol.for("react.portal");function h(v,y,A){var b=3<arguments.length&&arguments[3]!==void 0?arguments[3]:null;return{$$typeof:m,key:b==null?null:""+b,children:v,containerInfo:y,implementation:A}}var x=i.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;function j(v,y){if(v==="font")return"";if(typeof y=="string")return y==="use-credentials"?y:""}return Ie.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE=r,Ie.createPortal=function(v,y){var A=2<arguments.length&&arguments[2]!==void 0?arguments[2]:null;if(!y||y.nodeType!==1&&y.nodeType!==9&&y.nodeType!==11)throw Error(o(299));return h(v,y,null,A)},Ie.flushSync=function(v){var y=x.T,A=r.p;try{if(x.T=null,r.p=2,v)return v()}finally{x.T=y,r.p=A,r.d.f()}},Ie.preconnect=function(v,y){typeof v=="string"&&(y?(y=y.crossOrigin,y=typeof y=="string"?y==="use-credentials"?y:"":void 0):y=null,r.d.C(v,y))},Ie.prefetchDNS=function(v){typeof v=="string"&&r.d.D(v)},Ie.preinit=function(v,y){if(typeof v=="string"&&y&&typeof y.as=="string"){var A=y.as,b=j(A,y.crossOrigin),U=typeof y.integrity=="string"?y.integrity:void 0,L=typeof y.fetchPriority=="string"?y.fetchPriority:void 0;A==="style"?r.d.S(v,typeof y.precedence=="string"?y.precedence:void 0,{crossOrigin:b,integrity:U,fetchPriority:L}):A==="script"&&r.d.X(v,{crossOrigin:b,integrity:U,fetchPriority:L,nonce:typeof y.nonce=="string"?y.nonce:void 0})}},Ie.preinitModule=function(v,y){if(typeof v=="string")if(typeof y=="object"&&y!==null){if(y.as==null||y.as==="script"){var A=j(y.as,y.crossOrigin);r.d.M(v,{crossOrigin:A,integrity:typeof y.integrity=="string"?y.integrity:void 0,nonce:typeof y.nonce=="string"?y.nonce:void 0})}}else y==null&&r.d.M(v)},Ie.preload=function(v,y){if(typeof v=="string"&&typeof y=="object"&&y!==null&&typeof y.as=="string"){var A=y.as,b=j(A,y.crossOrigin);r.d.L(v,A,{crossOrigin:b,integrity:typeof y.integrity=="string"?y.integrity:void 0,nonce:typeof y.nonce=="string"?y.nonce:void 0,type:typeof y.type=="string"?y.type:void 0,fetchPriority:typeof y.fetchPriority=="string"?y.fetchPriority:void 0,referrerPolicy:typeof y.referrerPolicy=="string"?y.referrerPolicy:void 0,imageSrcSet:typeof y.imageSrcSet=="string"?y.imageSrcSet:void 0,imageSizes:typeof y.imageSizes=="string"?y.imageSizes:void 0,media:typeof y.media=="string"?y.media:void 0})}},Ie.preloadModule=function(v,y){if(typeof v=="string")if(y){var A=j(y.as,y.crossOrigin);r.d.m(v,{as:typeof y.as=="string"&&y.as!=="script"?y.as:void 0,crossOrigin:A,integrity:typeof y.integrity=="string"?y.integrity:void 0})}else r.d.m(v)},Ie.requestFormReset=function(v){r.d.r(v)},Ie.unstable_batchedUpdates=function(v,y){return v(y)},Ie.useFormState=function(v,y,A){return x.H.useFormState(v,y,A)},Ie.useFormStatus=function(){return x.H.useHostTransitionStatus()},Ie.version="19.2.4",Ie}var pm;function Zy(){if(pm)return qs.exports;pm=1;function i(){if(!(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__>"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(i)}catch(o){console.error(o)}}return i(),qs.exports=Qy(),qs.exports}/** - * @license React - * react-dom-client.production.js - * - * Copyright (c) Meta Platforms, Inc. and affiliates. - * - * This source code is licensed under the MIT license found in the - * LICENSE file in the root directory of this source tree. - */var vm;function Vy(){if(vm)return Ln;vm=1;var i=Xy(),o=Ws(),f=Zy();function r(e){var t="https://react.dev/errors/"+e;if(1<arguments.length){t+="?args[]="+encodeURIComponent(arguments[1]);for(var l=2;l<arguments.length;l++)t+="&args[]="+encodeURIComponent(arguments[l])}return"Minified React error #"+e+"; visit "+t+" for the full message or use the non-minified dev environment for full errors and additional helpful warnings."}function m(e){return!(!e||e.nodeType!==1&&e.nodeType!==9&&e.nodeType!==11)}function h(e){var t=e,l=e;if(e.alternate)for(;t.return;)t=t.return;else{e=t;do t=e,(t.flags&4098)!==0&&(l=t.return),e=t.return;while(e)}return t.tag===3?l:null}function x(e){if(e.tag===13){var t=e.memoizedState;if(t===null&&(e=e.alternate,e!==null&&(t=e.memoizedState)),t!==null)return t.dehydrated}return null}function j(e){if(e.tag===31){var t=e.memoizedState;if(t===null&&(e=e.alternate,e!==null&&(t=e.memoizedState)),t!==null)return t.dehydrated}return null}function v(e){if(h(e)!==e)throw Error(r(188))}function y(e){var t=e.alternate;if(!t){if(t=h(e),t===null)throw Error(r(188));return t!==e?null:e}for(var l=e,a=t;;){var n=l.return;if(n===null)break;var u=n.alternate;if(u===null){if(a=n.return,a!==null){l=a;continue}break}if(n.child===u.child){for(u=n.child;u;){if(u===l)return v(n),e;if(u===a)return v(n),t;u=u.sibling}throw Error(r(188))}if(l.return!==a.return)l=n,a=u;else{for(var s=!1,d=n.child;d;){if(d===l){s=!0,l=n,a=u;break}if(d===a){s=!0,a=n,l=u;break}d=d.sibling}if(!s){for(d=u.child;d;){if(d===l){s=!0,l=u,a=n;break}if(d===a){s=!0,a=u,l=n;break}d=d.sibling}if(!s)throw Error(r(189))}}if(l.alternate!==a)throw Error(r(190))}if(l.tag!==3)throw Error(r(188));return l.stateNode.current===l?e:t}function A(e){var t=e.tag;if(t===5||t===26||t===27||t===6)return e;for(e=e.child;e!==null;){if(t=A(e),t!==null)return t;e=e.sibling}return null}var b=Object.assign,U=Symbol.for("react.element"),L=Symbol.for("react.transitional.element"),q=Symbol.for("react.portal"),Y=Symbol.for("react.fragment"),B=Symbol.for("react.strict_mode"),G=Symbol.for("react.profiler"),Q=Symbol.for("react.consumer"),H=Symbol.for("react.context"),ee=Symbol.for("react.forward_ref"),I=Symbol.for("react.suspense"),oe=Symbol.for("react.suspense_list"),W=Symbol.for("react.memo"),J=Symbol.for("react.lazy"),Ee=Symbol.for("react.activity"),We=Symbol.for("react.memo_cache_sentinel"),St=Symbol.iterator;function Fe(e){return e===null||typeof e!="object"?null:(e=St&&e[St]||e["@@iterator"],typeof e=="function"?e:null)}var Gt=Symbol.for("react.client.reference");function te(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===Gt?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case Y:return"Fragment";case G:return"Profiler";case B:return"StrictMode";case I:return"Suspense";case oe:return"SuspenseList";case Ee:return"Activity"}if(typeof e=="object")switch(e.$$typeof){case q:return"Portal";case H:return e.displayName||"Context";case Q:return(e._context.displayName||"Context")+".Consumer";case ee:var t=e.render;return e=e.displayName,e||(e=t.displayName||t.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case W:return t=e.displayName||null,t!==null?t:te(e.type)||"Memo";case J:t=e._payload,e=e._init;try{return te(e(t))}catch{}}return null}var ke=Array.isArray,w=o.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,k=f.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,P={pending:!1,data:null,method:null,action:null},be=[],Te=-1;function N(e){return{current:e}}function O(e){0>Te||(e.current=be[Te],be[Te]=null,Te--)}function X(e,t){Te++,be[Te]=e.current,e.current=t}var V=N(null),ae=N(null),ce=N(null),xe=N(null);function Pe(e,t){switch(X(ce,t),X(ae,e),X(V,null),t.nodeType){case 9:case 11:e=(e=t.documentElement)&&(e=e.namespaceURI)?Od(e):0;break;default:if(e=t.tagName,t=t.namespaceURI)t=Od(t),e=Ud(t,e);else switch(e){case"svg":e=1;break;case"math":e=2;break;default:e=0}}O(V),X(V,e)}function Oe(){O(V),O(ae),O(ce)}function ka(e){e.memoizedState!==null&&X(xe,e);var t=V.current,l=Ud(t,e.type);t!==l&&(X(ae,e),X(V,l))}function Qn(e){ae.current===e&&(O(V),O(ae)),xe.current===e&&(O(xe),Dn._currentValue=P)}var gi,sr;function Ol(e){if(gi===void 0)try{throw Error()}catch(l){var t=l.stack.trim().match(/\n( *(at )?)/);gi=t&&t[1]||"",sr=-1<l.stack.indexOf(` - at`)?" (<anonymous>)":-1<l.stack.indexOf("@")?"@unknown:0:0":""}return` -`+gi+e+sr}var xi=!1;function pi(e,t){if(!e||xi)return"";xi=!0;var l=Error.prepareStackTrace;Error.prepareStackTrace=void 0;try{var a={DetermineComponentFrameRoot:function(){try{if(t){var R=function(){throw Error()};if(Object.defineProperty(R.prototype,"props",{set:function(){throw Error()}}),typeof Reflect=="object"&&Reflect.construct){try{Reflect.construct(R,[])}catch(_){var z=_}Reflect.construct(e,[],R)}else{try{R.call()}catch(_){z=_}e.call(R.prototype)}}else{try{throw Error()}catch(_){z=_}(R=e())&&typeof R.catch=="function"&&R.catch(function(){})}}catch(_){if(_&&z&&typeof _.stack=="string")return[_.stack,z.stack]}return[null,null]}};a.DetermineComponentFrameRoot.displayName="DetermineComponentFrameRoot";var n=Object.getOwnPropertyDescriptor(a.DetermineComponentFrameRoot,"name");n&&n.configurable&&Object.defineProperty(a.DetermineComponentFrameRoot,"name",{value:"DetermineComponentFrameRoot"});var u=a.DetermineComponentFrameRoot(),s=u[0],d=u[1];if(s&&d){var g=s.split(` -`),C=d.split(` -`);for(n=a=0;a<g.length&&!g[a].includes("DetermineComponentFrameRoot");)a++;for(;n<C.length&&!C[n].includes("DetermineComponentFrameRoot");)n++;if(a===g.length||n===C.length)for(a=g.length-1,n=C.length-1;1<=a&&0<=n&&g[a]!==C[n];)n--;for(;1<=a&&0<=n;a--,n--)if(g[a]!==C[n]){if(a!==1||n!==1)do if(a--,n--,0>n||g[a]!==C[n]){var M=` -`+g[a].replace(" at new "," at ");return e.displayName&&M.includes("<anonymous>")&&(M=M.replace("<anonymous>",e.displayName)),M}while(1<=a&&0<=n);break}}}finally{xi=!1,Error.prepareStackTrace=l}return(l=e?e.displayName||e.name:"")?Ol(l):""}function h0(e,t){switch(e.tag){case 26:case 27:case 5:return Ol(e.type);case 16:return Ol("Lazy");case 13:return e.child!==t&&t!==null?Ol("Suspense Fallback"):Ol("Suspense");case 19:return Ol("SuspenseList");case 0:case 15:return pi(e.type,!1);case 11:return pi(e.type.render,!1);case 1:return pi(e.type,!0);case 31:return Ol("Activity");default:return""}}function rr(e){try{var t="",l=null;do t+=h0(e,l),l=e,e=e.return;while(e);return t}catch(a){return` -Error generating stack: `+a.message+` -`+a.stack}}var vi=Object.prototype.hasOwnProperty,bi=i.unstable_scheduleCallback,Si=i.unstable_cancelCallback,y0=i.unstable_shouldYield,g0=i.unstable_requestPaint,rt=i.unstable_now,x0=i.unstable_getCurrentPriorityLevel,or=i.unstable_ImmediatePriority,fr=i.unstable_UserBlockingPriority,Zn=i.unstable_NormalPriority,p0=i.unstable_LowPriority,dr=i.unstable_IdlePriority,v0=i.log,b0=i.unstable_setDisableYieldValue,Xa=null,ot=null;function rl(e){if(typeof v0=="function"&&b0(e),ot&&typeof ot.setStrictMode=="function")try{ot.setStrictMode(Xa,e)}catch{}}var ft=Math.clz32?Math.clz32:j0,S0=Math.log,N0=Math.LN2;function j0(e){return e>>>=0,e===0?32:31-(S0(e)/N0|0)|0}var Vn=256,Kn=262144,Jn=4194304;function Ul(e){var t=e&42;if(t!==0)return t;switch(e&-e){case 1:return 1;case 2:return 2;case 4:return 4;case 8:return 8;case 16:return 16;case 32:return 32;case 64:return 64;case 128:return 128;case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:return e&261888;case 262144:case 524288:case 1048576:case 2097152:return e&3932160;case 4194304:case 8388608:case 16777216:case 33554432:return e&62914560;case 67108864:return 67108864;case 134217728:return 134217728;case 268435456:return 268435456;case 536870912:return 536870912;case 1073741824:return 0;default:return e}}function $n(e,t,l){var a=e.pendingLanes;if(a===0)return 0;var n=0,u=e.suspendedLanes,s=e.pingedLanes;e=e.warmLanes;var d=a&134217727;return d!==0?(a=d&~u,a!==0?n=Ul(a):(s&=d,s!==0?n=Ul(s):l||(l=d&~e,l!==0&&(n=Ul(l))))):(d=a&~u,d!==0?n=Ul(d):s!==0?n=Ul(s):l||(l=a&~e,l!==0&&(n=Ul(l)))),n===0?0:t!==0&&t!==n&&(t&u)===0&&(u=n&-n,l=t&-t,u>=l||u===32&&(l&4194048)!==0)?t:n}function Qa(e,t){return(e.pendingLanes&~(e.suspendedLanes&~e.pingedLanes)&t)===0}function E0(e,t){switch(e){case 1:case 2:case 4:case 8:case 64:return t+250;case 16:case 32:case 128:case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:return t+5e3;case 4194304:case 8388608:case 16777216:case 33554432:return-1;case 67108864:case 134217728:case 268435456:case 536870912:case 1073741824:return-1;default:return-1}}function mr(){var e=Jn;return Jn<<=1,(Jn&62914560)===0&&(Jn=4194304),e}function Ni(e){for(var t=[],l=0;31>l;l++)t.push(e);return t}function Za(e,t){e.pendingLanes|=t,t!==268435456&&(e.suspendedLanes=0,e.pingedLanes=0,e.warmLanes=0)}function T0(e,t,l,a,n,u){var s=e.pendingLanes;e.pendingLanes=l,e.suspendedLanes=0,e.pingedLanes=0,e.warmLanes=0,e.expiredLanes&=l,e.entangledLanes&=l,e.errorRecoveryDisabledLanes&=l,e.shellSuspendCounter=0;var d=e.entanglements,g=e.expirationTimes,C=e.hiddenUpdates;for(l=s&~l;0<l;){var M=31-ft(l),R=1<<M;d[M]=0,g[M]=-1;var z=C[M];if(z!==null)for(C[M]=null,M=0;M<z.length;M++){var _=z[M];_!==null&&(_.lane&=-536870913)}l&=~R}a!==0&&hr(e,a,0),u!==0&&n===0&&e.tag!==0&&(e.suspendedLanes|=u&~(s&~t))}function hr(e,t,l){e.pendingLanes|=t,e.suspendedLanes&=~t;var a=31-ft(t);e.entangledLanes|=t,e.entanglements[a]=e.entanglements[a]|1073741824|l&261930}function yr(e,t){var l=e.entangledLanes|=t;for(e=e.entanglements;l;){var a=31-ft(l),n=1<<a;n&t|e[a]&t&&(e[a]|=t),l&=~n}}function gr(e,t){var l=t&-t;return l=(l&42)!==0?1:ji(l),(l&(e.suspendedLanes|t))!==0?0:l}function ji(e){switch(e){case 2:e=1;break;case 8:e=4;break;case 32:e=16;break;case 256:case 512:case 1024:case 2048:case 4096:case 8192:case 16384:case 32768:case 65536:case 131072:case 262144:case 524288:case 1048576:case 2097152:case 4194304:case 8388608:case 16777216:case 33554432:e=128;break;case 268435456:e=134217728;break;default:e=0}return e}function Ei(e){return e&=-e,2<e?8<e?(e&134217727)!==0?32:268435456:8:2}function xr(){var e=k.p;return e!==0?e:(e=window.event,e===void 0?32:nm(e.type))}function pr(e,t){var l=k.p;try{return k.p=e,t()}finally{k.p=l}}var ol=Math.random().toString(36).slice(2),Ze="__reactFiber$"+ol,tt="__reactProps$"+ol,Pl="__reactContainer$"+ol,Ti="__reactEvents$"+ol,C0="__reactListeners$"+ol,z0="__reactHandles$"+ol,vr="__reactResources$"+ol,Va="__reactMarker$"+ol;function Ci(e){delete e[Ze],delete e[tt],delete e[Ti],delete e[C0],delete e[z0]}function ea(e){var t=e[Ze];if(t)return t;for(var l=e.parentNode;l;){if(t=l[Pl]||l[Ze]){if(l=t.alternate,t.child!==null||l!==null&&l.child!==null)for(e=kd(e);e!==null;){if(l=e[Ze])return l;e=kd(e)}return t}e=l,l=e.parentNode}return null}function ta(e){if(e=e[Ze]||e[Pl]){var t=e.tag;if(t===5||t===6||t===13||t===31||t===26||t===27||t===3)return e}return null}function Ka(e){var t=e.tag;if(t===5||t===26||t===27||t===6)return e.stateNode;throw Error(r(33))}function la(e){var t=e[vr];return t||(t=e[vr]={hoistableStyles:new Map,hoistableScripts:new Map}),t}function Xe(e){e[Va]=!0}var br=new Set,Sr={};function Hl(e,t){aa(e,t),aa(e+"Capture",t)}function aa(e,t){for(Sr[e]=t,e=0;e<t.length;e++)br.add(t[e])}var A0=RegExp("^[:A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][:A-Z_a-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$"),Nr={},jr={};function _0(e){return vi.call(jr,e)?!0:vi.call(Nr,e)?!1:A0.test(e)?jr[e]=!0:(Nr[e]=!0,!1)}function Wn(e,t,l){if(_0(t))if(l===null)e.removeAttribute(t);else{switch(typeof l){case"undefined":case"function":case"symbol":e.removeAttribute(t);return;case"boolean":var a=t.toLowerCase().slice(0,5);if(a!=="data-"&&a!=="aria-"){e.removeAttribute(t);return}}e.setAttribute(t,""+l)}}function Fn(e,t,l){if(l===null)e.removeAttribute(t);else{switch(typeof l){case"undefined":case"function":case"symbol":case"boolean":e.removeAttribute(t);return}e.setAttribute(t,""+l)}}function kt(e,t,l,a){if(a===null)e.removeAttribute(l);else{switch(typeof a){case"undefined":case"function":case"symbol":case"boolean":e.removeAttribute(l);return}e.setAttributeNS(t,l,""+a)}}function Nt(e){switch(typeof e){case"bigint":case"boolean":case"number":case"string":case"undefined":return e;case"object":return e;default:return""}}function Er(e){var t=e.type;return(e=e.nodeName)&&e.toLowerCase()==="input"&&(t==="checkbox"||t==="radio")}function w0(e,t,l){var a=Object.getOwnPropertyDescriptor(e.constructor.prototype,t);if(!e.hasOwnProperty(t)&&typeof a<"u"&&typeof a.get=="function"&&typeof a.set=="function"){var n=a.get,u=a.set;return Object.defineProperty(e,t,{configurable:!0,get:function(){return n.call(this)},set:function(s){l=""+s,u.call(this,s)}}),Object.defineProperty(e,t,{enumerable:a.enumerable}),{getValue:function(){return l},setValue:function(s){l=""+s},stopTracking:function(){e._valueTracker=null,delete e[t]}}}}function zi(e){if(!e._valueTracker){var t=Er(e)?"checked":"value";e._valueTracker=w0(e,t,""+e[t])}}function Tr(e){if(!e)return!1;var t=e._valueTracker;if(!t)return!0;var l=t.getValue(),a="";return e&&(a=Er(e)?e.checked?"true":"false":e.value),e=a,e!==l?(t.setValue(e),!0):!1}function In(e){if(e=e||(typeof document<"u"?document:void 0),typeof e>"u")return null;try{return e.activeElement||e.body}catch{return e.body}}var M0=/[\n"\\]/g;function jt(e){return e.replace(M0,function(t){return"\\"+t.charCodeAt(0).toString(16)+" "})}function Ai(e,t,l,a,n,u,s,d){e.name="",s!=null&&typeof s!="function"&&typeof s!="symbol"&&typeof s!="boolean"?e.type=s:e.removeAttribute("type"),t!=null?s==="number"?(t===0&&e.value===""||e.value!=t)&&(e.value=""+Nt(t)):e.value!==""+Nt(t)&&(e.value=""+Nt(t)):s!=="submit"&&s!=="reset"||e.removeAttribute("value"),t!=null?_i(e,s,Nt(t)):l!=null?_i(e,s,Nt(l)):a!=null&&e.removeAttribute("value"),n==null&&u!=null&&(e.defaultChecked=!!u),n!=null&&(e.checked=n&&typeof n!="function"&&typeof n!="symbol"),d!=null&&typeof d!="function"&&typeof d!="symbol"&&typeof d!="boolean"?e.name=""+Nt(d):e.removeAttribute("name")}function Cr(e,t,l,a,n,u,s,d){if(u!=null&&typeof u!="function"&&typeof u!="symbol"&&typeof u!="boolean"&&(e.type=u),t!=null||l!=null){if(!(u!=="submit"&&u!=="reset"||t!=null)){zi(e);return}l=l!=null?""+Nt(l):"",t=t!=null?""+Nt(t):l,d||t===e.value||(e.value=t),e.defaultValue=t}a=a??n,a=typeof a!="function"&&typeof a!="symbol"&&!!a,e.checked=d?e.checked:!!a,e.defaultChecked=!!a,s!=null&&typeof s!="function"&&typeof s!="symbol"&&typeof s!="boolean"&&(e.name=s),zi(e)}function _i(e,t,l){t==="number"&&In(e.ownerDocument)===e||e.defaultValue===""+l||(e.defaultValue=""+l)}function na(e,t,l,a){if(e=e.options,t){t={};for(var n=0;n<l.length;n++)t["$"+l[n]]=!0;for(l=0;l<e.length;l++)n=t.hasOwnProperty("$"+e[l].value),e[l].selected!==n&&(e[l].selected=n),n&&a&&(e[l].defaultSelected=!0)}else{for(l=""+Nt(l),t=null,n=0;n<e.length;n++){if(e[n].value===l){e[n].selected=!0,a&&(e[n].defaultSelected=!0);return}t!==null||e[n].disabled||(t=e[n])}t!==null&&(t.selected=!0)}}function zr(e,t,l){if(t!=null&&(t=""+Nt(t),t!==e.value&&(e.value=t),l==null)){e.defaultValue!==t&&(e.defaultValue=t);return}e.defaultValue=l!=null?""+Nt(l):""}function Ar(e,t,l,a){if(t==null){if(a!=null){if(l!=null)throw Error(r(92));if(ke(a)){if(1<a.length)throw Error(r(93));a=a[0]}l=a}l==null&&(l=""),t=l}l=Nt(t),e.defaultValue=l,a=e.textContent,a===l&&a!==""&&a!==null&&(e.value=a),zi(e)}function ua(e,t){if(t){var l=e.firstChild;if(l&&l===e.lastChild&&l.nodeType===3){l.nodeValue=t;return}}e.textContent=t}var D0=new Set("animationIterationCount aspectRatio borderImageOutset borderImageSlice borderImageWidth boxFlex boxFlexGroup boxOrdinalGroup columnCount columns flex flexGrow flexPositive flexShrink flexNegative flexOrder gridArea gridRow gridRowEnd gridRowSpan gridRowStart gridColumn gridColumnEnd gridColumnSpan gridColumnStart fontWeight lineClamp lineHeight opacity order orphans scale tabSize widows zIndex zoom fillOpacity floodOpacity stopOpacity strokeDasharray strokeDashoffset strokeMiterlimit strokeOpacity strokeWidth MozAnimationIterationCount MozBoxFlex MozBoxFlexGroup MozLineClamp msAnimationIterationCount msFlex msZoom msFlexGrow msFlexNegative msFlexOrder msFlexPositive msFlexShrink msGridColumn msGridColumnSpan msGridRow msGridRowSpan WebkitAnimationIterationCount WebkitBoxFlex WebKitBoxFlexGroup WebkitBoxOrdinalGroup WebkitColumnCount WebkitColumns WebkitFlex WebkitFlexGrow WebkitFlexPositive WebkitFlexShrink WebkitLineClamp".split(" "));function _r(e,t,l){var a=t.indexOf("--")===0;l==null||typeof l=="boolean"||l===""?a?e.setProperty(t,""):t==="float"?e.cssFloat="":e[t]="":a?e.setProperty(t,l):typeof l!="number"||l===0||D0.has(t)?t==="float"?e.cssFloat=l:e[t]=(""+l).trim():e[t]=l+"px"}function wr(e,t,l){if(t!=null&&typeof t!="object")throw Error(r(62));if(e=e.style,l!=null){for(var a in l)!l.hasOwnProperty(a)||t!=null&&t.hasOwnProperty(a)||(a.indexOf("--")===0?e.setProperty(a,""):a==="float"?e.cssFloat="":e[a]="");for(var n in t)a=t[n],t.hasOwnProperty(n)&&l[n]!==a&&_r(e,n,a)}else for(var u in t)t.hasOwnProperty(u)&&_r(e,u,t[u])}function wi(e){if(e.indexOf("-")===-1)return!1;switch(e){case"annotation-xml":case"color-profile":case"font-face":case"font-face-src":case"font-face-uri":case"font-face-format":case"font-face-name":case"missing-glyph":return!1;default:return!0}}var R0=new Map([["acceptCharset","accept-charset"],["htmlFor","for"],["httpEquiv","http-equiv"],["crossOrigin","crossorigin"],["accentHeight","accent-height"],["alignmentBaseline","alignment-baseline"],["arabicForm","arabic-form"],["baselineShift","baseline-shift"],["capHeight","cap-height"],["clipPath","clip-path"],["clipRule","clip-rule"],["colorInterpolation","color-interpolation"],["colorInterpolationFilters","color-interpolation-filters"],["colorProfile","color-profile"],["colorRendering","color-rendering"],["dominantBaseline","dominant-baseline"],["enableBackground","enable-background"],["fillOpacity","fill-opacity"],["fillRule","fill-rule"],["floodColor","flood-color"],["floodOpacity","flood-opacity"],["fontFamily","font-family"],["fontSize","font-size"],["fontSizeAdjust","font-size-adjust"],["fontStretch","font-stretch"],["fontStyle","font-style"],["fontVariant","font-variant"],["fontWeight","font-weight"],["glyphName","glyph-name"],["glyphOrientationHorizontal","glyph-orientation-horizontal"],["glyphOrientationVertical","glyph-orientation-vertical"],["horizAdvX","horiz-adv-x"],["horizOriginX","horiz-origin-x"],["imageRendering","image-rendering"],["letterSpacing","letter-spacing"],["lightingColor","lighting-color"],["markerEnd","marker-end"],["markerMid","marker-mid"],["markerStart","marker-start"],["overlinePosition","overline-position"],["overlineThickness","overline-thickness"],["paintOrder","paint-order"],["panose-1","panose-1"],["pointerEvents","pointer-events"],["renderingIntent","rendering-intent"],["shapeRendering","shape-rendering"],["stopColor","stop-color"],["stopOpacity","stop-opacity"],["strikethroughPosition","strikethrough-position"],["strikethroughThickness","strikethrough-thickness"],["strokeDasharray","stroke-dasharray"],["strokeDashoffset","stroke-dashoffset"],["strokeLinecap","stroke-linecap"],["strokeLinejoin","stroke-linejoin"],["strokeMiterlimit","stroke-miterlimit"],["strokeOpacity","stroke-opacity"],["strokeWidth","stroke-width"],["textAnchor","text-anchor"],["textDecoration","text-decoration"],["textRendering","text-rendering"],["transformOrigin","transform-origin"],["underlinePosition","underline-position"],["underlineThickness","underline-thickness"],["unicodeBidi","unicode-bidi"],["unicodeRange","unicode-range"],["unitsPerEm","units-per-em"],["vAlphabetic","v-alphabetic"],["vHanging","v-hanging"],["vIdeographic","v-ideographic"],["vMathematical","v-mathematical"],["vectorEffect","vector-effect"],["vertAdvY","vert-adv-y"],["vertOriginX","vert-origin-x"],["vertOriginY","vert-origin-y"],["wordSpacing","word-spacing"],["writingMode","writing-mode"],["xmlnsXlink","xmlns:xlink"],["xHeight","x-height"]]),O0=/^[\u0000-\u001F ]*j[\r\n\t]*a[\r\n\t]*v[\r\n\t]*a[\r\n\t]*s[\r\n\t]*c[\r\n\t]*r[\r\n\t]*i[\r\n\t]*p[\r\n\t]*t[\r\n\t]*:/i;function Pn(e){return O0.test(""+e)?"javascript:throw new Error('React has blocked a javascript: URL as a security precaution.')":e}function Xt(){}var Mi=null;function Di(e){return e=e.target||e.srcElement||window,e.correspondingUseElement&&(e=e.correspondingUseElement),e.nodeType===3?e.parentNode:e}var ia=null,ca=null;function Mr(e){var t=ta(e);if(t&&(e=t.stateNode)){var l=e[tt]||null;e:switch(e=t.stateNode,t.type){case"input":if(Ai(e,l.value,l.defaultValue,l.defaultValue,l.checked,l.defaultChecked,l.type,l.name),t=l.name,l.type==="radio"&&t!=null){for(l=e;l.parentNode;)l=l.parentNode;for(l=l.querySelectorAll('input[name="'+jt(""+t)+'"][type="radio"]'),t=0;t<l.length;t++){var a=l[t];if(a!==e&&a.form===e.form){var n=a[tt]||null;if(!n)throw Error(r(90));Ai(a,n.value,n.defaultValue,n.defaultValue,n.checked,n.defaultChecked,n.type,n.name)}}for(t=0;t<l.length;t++)a=l[t],a.form===e.form&&Tr(a)}break e;case"textarea":zr(e,l.value,l.defaultValue);break e;case"select":t=l.value,t!=null&&na(e,!!l.multiple,t,!1)}}}var Ri=!1;function Dr(e,t,l){if(Ri)return e(t,l);Ri=!0;try{var a=e(t);return a}finally{if(Ri=!1,(ia!==null||ca!==null)&&(Yu(),ia&&(t=ia,e=ca,ca=ia=null,Mr(t),e)))for(t=0;t<e.length;t++)Mr(e[t])}}function Ja(e,t){var l=e.stateNode;if(l===null)return null;var a=l[tt]||null;if(a===null)return null;l=a[t];e:switch(t){case"onClick":case"onClickCapture":case"onDoubleClick":case"onDoubleClickCapture":case"onMouseDown":case"onMouseDownCapture":case"onMouseMove":case"onMouseMoveCapture":case"onMouseUp":case"onMouseUpCapture":case"onMouseEnter":(a=!a.disabled)||(e=e.type,a=!(e==="button"||e==="input"||e==="select"||e==="textarea")),e=!a;break e;default:e=!1}if(e)return null;if(l&&typeof l!="function")throw Error(r(231,t,typeof l));return l}var Qt=!(typeof window>"u"||typeof window.document>"u"||typeof window.document.createElement>"u"),Oi=!1;if(Qt)try{var $a={};Object.defineProperty($a,"passive",{get:function(){Oi=!0}}),window.addEventListener("test",$a,$a),window.removeEventListener("test",$a,$a)}catch{Oi=!1}var fl=null,Ui=null,eu=null;function Rr(){if(eu)return eu;var e,t=Ui,l=t.length,a,n="value"in fl?fl.value:fl.textContent,u=n.length;for(e=0;e<l&&t[e]===n[e];e++);var s=l-e;for(a=1;a<=s&&t[l-a]===n[u-a];a++);return eu=n.slice(e,1<a?1-a:void 0)}function tu(e){var t=e.keyCode;return"charCode"in e?(e=e.charCode,e===0&&t===13&&(e=13)):e=t,e===10&&(e=13),32<=e||e===13?e:0}function lu(){return!0}function Or(){return!1}function lt(e){function t(l,a,n,u,s){this._reactName=l,this._targetInst=n,this.type=a,this.nativeEvent=u,this.target=s,this.currentTarget=null;for(var d in e)e.hasOwnProperty(d)&&(l=e[d],this[d]=l?l(u):u[d]);return this.isDefaultPrevented=(u.defaultPrevented!=null?u.defaultPrevented:u.returnValue===!1)?lu:Or,this.isPropagationStopped=Or,this}return b(t.prototype,{preventDefault:function(){this.defaultPrevented=!0;var l=this.nativeEvent;l&&(l.preventDefault?l.preventDefault():typeof l.returnValue!="unknown"&&(l.returnValue=!1),this.isDefaultPrevented=lu)},stopPropagation:function(){var l=this.nativeEvent;l&&(l.stopPropagation?l.stopPropagation():typeof l.cancelBubble!="unknown"&&(l.cancelBubble=!0),this.isPropagationStopped=lu)},persist:function(){},isPersistent:lu}),t}var Ll={eventPhase:0,bubbles:0,cancelable:0,timeStamp:function(e){return e.timeStamp||Date.now()},defaultPrevented:0,isTrusted:0},au=lt(Ll),Wa=b({},Ll,{view:0,detail:0}),U0=lt(Wa),Hi,Li,Fa,nu=b({},Wa,{screenX:0,screenY:0,clientX:0,clientY:0,pageX:0,pageY:0,ctrlKey:0,shiftKey:0,altKey:0,metaKey:0,getModifierState:qi,button:0,buttons:0,relatedTarget:function(e){return e.relatedTarget===void 0?e.fromElement===e.srcElement?e.toElement:e.fromElement:e.relatedTarget},movementX:function(e){return"movementX"in e?e.movementX:(e!==Fa&&(Fa&&e.type==="mousemove"?(Hi=e.screenX-Fa.screenX,Li=e.screenY-Fa.screenY):Li=Hi=0,Fa=e),Hi)},movementY:function(e){return"movementY"in e?e.movementY:Li}}),Ur=lt(nu),H0=b({},nu,{dataTransfer:0}),L0=lt(H0),B0=b({},Wa,{relatedTarget:0}),Bi=lt(B0),q0=b({},Ll,{animationName:0,elapsedTime:0,pseudoElement:0}),Y0=lt(q0),G0=b({},Ll,{clipboardData:function(e){return"clipboardData"in e?e.clipboardData:window.clipboardData}}),k0=lt(G0),X0=b({},Ll,{data:0}),Hr=lt(X0),Q0={Esc:"Escape",Spacebar:" ",Left:"ArrowLeft",Up:"ArrowUp",Right:"ArrowRight",Down:"ArrowDown",Del:"Delete",Win:"OS",Menu:"ContextMenu",Apps:"ContextMenu",Scroll:"ScrollLock",MozPrintableKey:"Unidentified"},Z0={8:"Backspace",9:"Tab",12:"Clear",13:"Enter",16:"Shift",17:"Control",18:"Alt",19:"Pause",20:"CapsLock",27:"Escape",32:" ",33:"PageUp",34:"PageDown",35:"End",36:"Home",37:"ArrowLeft",38:"ArrowUp",39:"ArrowRight",40:"ArrowDown",45:"Insert",46:"Delete",112:"F1",113:"F2",114:"F3",115:"F4",116:"F5",117:"F6",118:"F7",119:"F8",120:"F9",121:"F10",122:"F11",123:"F12",144:"NumLock",145:"ScrollLock",224:"Meta"},V0={Alt:"altKey",Control:"ctrlKey",Meta:"metaKey",Shift:"shiftKey"};function K0(e){var t=this.nativeEvent;return t.getModifierState?t.getModifierState(e):(e=V0[e])?!!t[e]:!1}function qi(){return K0}var J0=b({},Wa,{key:function(e){if(e.key){var t=Q0[e.key]||e.key;if(t!=="Unidentified")return t}return e.type==="keypress"?(e=tu(e),e===13?"Enter":String.fromCharCode(e)):e.type==="keydown"||e.type==="keyup"?Z0[e.keyCode]||"Unidentified":""},code:0,location:0,ctrlKey:0,shiftKey:0,altKey:0,metaKey:0,repeat:0,locale:0,getModifierState:qi,charCode:function(e){return e.type==="keypress"?tu(e):0},keyCode:function(e){return e.type==="keydown"||e.type==="keyup"?e.keyCode:0},which:function(e){return e.type==="keypress"?tu(e):e.type==="keydown"||e.type==="keyup"?e.keyCode:0}}),$0=lt(J0),W0=b({},nu,{pointerId:0,width:0,height:0,pressure:0,tangentialPressure:0,tiltX:0,tiltY:0,twist:0,pointerType:0,isPrimary:0}),Lr=lt(W0),F0=b({},Wa,{touches:0,targetTouches:0,changedTouches:0,altKey:0,metaKey:0,ctrlKey:0,shiftKey:0,getModifierState:qi}),I0=lt(F0),P0=b({},Ll,{propertyName:0,elapsedTime:0,pseudoElement:0}),eh=lt(P0),th=b({},nu,{deltaX:function(e){return"deltaX"in e?e.deltaX:"wheelDeltaX"in e?-e.wheelDeltaX:0},deltaY:function(e){return"deltaY"in e?e.deltaY:"wheelDeltaY"in e?-e.wheelDeltaY:"wheelDelta"in e?-e.wheelDelta:0},deltaZ:0,deltaMode:0}),lh=lt(th),ah=b({},Ll,{newState:0,oldState:0}),nh=lt(ah),uh=[9,13,27,32],Yi=Qt&&"CompositionEvent"in window,Ia=null;Qt&&"documentMode"in document&&(Ia=document.documentMode);var ih=Qt&&"TextEvent"in window&&!Ia,Br=Qt&&(!Yi||Ia&&8<Ia&&11>=Ia),qr=" ",Yr=!1;function Gr(e,t){switch(e){case"keyup":return uh.indexOf(t.keyCode)!==-1;case"keydown":return t.keyCode!==229;case"keypress":case"mousedown":case"focusout":return!0;default:return!1}}function kr(e){return e=e.detail,typeof e=="object"&&"data"in e?e.data:null}var sa=!1;function ch(e,t){switch(e){case"compositionend":return kr(t);case"keypress":return t.which!==32?null:(Yr=!0,qr);case"textInput":return e=t.data,e===qr&&Yr?null:e;default:return null}}function sh(e,t){if(sa)return e==="compositionend"||!Yi&&Gr(e,t)?(e=Rr(),eu=Ui=fl=null,sa=!1,e):null;switch(e){case"paste":return null;case"keypress":if(!(t.ctrlKey||t.altKey||t.metaKey)||t.ctrlKey&&t.altKey){if(t.char&&1<t.char.length)return t.char;if(t.which)return String.fromCharCode(t.which)}return null;case"compositionend":return Br&&t.locale!=="ko"?null:t.data;default:return null}}var rh={color:!0,date:!0,datetime:!0,"datetime-local":!0,email:!0,month:!0,number:!0,password:!0,range:!0,search:!0,tel:!0,text:!0,time:!0,url:!0,week:!0};function Xr(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t==="input"?!!rh[e.type]:t==="textarea"}function Qr(e,t,l,a){ia?ca?ca.push(a):ca=[a]:ia=a,t=Ku(t,"onChange"),0<t.length&&(l=new au("onChange","change",null,l,a),e.push({event:l,listeners:t}))}var Pa=null,en=null;function oh(e){Ad(e,0)}function uu(e){var t=Ka(e);if(Tr(t))return e}function Zr(e,t){if(e==="change")return t}var Vr=!1;if(Qt){var Gi;if(Qt){var ki="oninput"in document;if(!ki){var Kr=document.createElement("div");Kr.setAttribute("oninput","return;"),ki=typeof Kr.oninput=="function"}Gi=ki}else Gi=!1;Vr=Gi&&(!document.documentMode||9<document.documentMode)}function Jr(){Pa&&(Pa.detachEvent("onpropertychange",$r),en=Pa=null)}function $r(e){if(e.propertyName==="value"&&uu(en)){var t=[];Qr(t,en,e,Di(e)),Dr(oh,t)}}function fh(e,t,l){e==="focusin"?(Jr(),Pa=t,en=l,Pa.attachEvent("onpropertychange",$r)):e==="focusout"&&Jr()}function dh(e){if(e==="selectionchange"||e==="keyup"||e==="keydown")return uu(en)}function mh(e,t){if(e==="click")return uu(t)}function hh(e,t){if(e==="input"||e==="change")return uu(t)}function yh(e,t){return e===t&&(e!==0||1/e===1/t)||e!==e&&t!==t}var dt=typeof Object.is=="function"?Object.is:yh;function tn(e,t){if(dt(e,t))return!0;if(typeof e!="object"||e===null||typeof t!="object"||t===null)return!1;var l=Object.keys(e),a=Object.keys(t);if(l.length!==a.length)return!1;for(a=0;a<l.length;a++){var n=l[a];if(!vi.call(t,n)||!dt(e[n],t[n]))return!1}return!0}function Wr(e){for(;e&&e.firstChild;)e=e.firstChild;return e}function Fr(e,t){var l=Wr(e);e=0;for(var a;l;){if(l.nodeType===3){if(a=e+l.textContent.length,e<=t&&a>=t)return{node:l,offset:t-e};e=a}e:{for(;l;){if(l.nextSibling){l=l.nextSibling;break e}l=l.parentNode}l=void 0}l=Wr(l)}}function Ir(e,t){return e&&t?e===t?!0:e&&e.nodeType===3?!1:t&&t.nodeType===3?Ir(e,t.parentNode):"contains"in e?e.contains(t):e.compareDocumentPosition?!!(e.compareDocumentPosition(t)&16):!1:!1}function Pr(e){e=e!=null&&e.ownerDocument!=null&&e.ownerDocument.defaultView!=null?e.ownerDocument.defaultView:window;for(var t=In(e.document);t instanceof e.HTMLIFrameElement;){try{var l=typeof t.contentWindow.location.href=="string"}catch{l=!1}if(l)e=t.contentWindow;else break;t=In(e.document)}return t}function Xi(e){var t=e&&e.nodeName&&e.nodeName.toLowerCase();return t&&(t==="input"&&(e.type==="text"||e.type==="search"||e.type==="tel"||e.type==="url"||e.type==="password")||t==="textarea"||e.contentEditable==="true")}var gh=Qt&&"documentMode"in document&&11>=document.documentMode,ra=null,Qi=null,ln=null,Zi=!1;function eo(e,t,l){var a=l.window===l?l.document:l.nodeType===9?l:l.ownerDocument;Zi||ra==null||ra!==In(a)||(a=ra,"selectionStart"in a&&Xi(a)?a={start:a.selectionStart,end:a.selectionEnd}:(a=(a.ownerDocument&&a.ownerDocument.defaultView||window).getSelection(),a={anchorNode:a.anchorNode,anchorOffset:a.anchorOffset,focusNode:a.focusNode,focusOffset:a.focusOffset}),ln&&tn(ln,a)||(ln=a,a=Ku(Qi,"onSelect"),0<a.length&&(t=new au("onSelect","select",null,t,l),e.push({event:t,listeners:a}),t.target=ra)))}function Bl(e,t){var l={};return l[e.toLowerCase()]=t.toLowerCase(),l["Webkit"+e]="webkit"+t,l["Moz"+e]="moz"+t,l}var oa={animationend:Bl("Animation","AnimationEnd"),animationiteration:Bl("Animation","AnimationIteration"),animationstart:Bl("Animation","AnimationStart"),transitionrun:Bl("Transition","TransitionRun"),transitionstart:Bl("Transition","TransitionStart"),transitioncancel:Bl("Transition","TransitionCancel"),transitionend:Bl("Transition","TransitionEnd")},Vi={},to={};Qt&&(to=document.createElement("div").style,"AnimationEvent"in window||(delete oa.animationend.animation,delete oa.animationiteration.animation,delete oa.animationstart.animation),"TransitionEvent"in window||delete oa.transitionend.transition);function ql(e){if(Vi[e])return Vi[e];if(!oa[e])return e;var t=oa[e],l;for(l in t)if(t.hasOwnProperty(l)&&l in to)return Vi[e]=t[l];return e}var lo=ql("animationend"),ao=ql("animationiteration"),no=ql("animationstart"),xh=ql("transitionrun"),ph=ql("transitionstart"),vh=ql("transitioncancel"),uo=ql("transitionend"),io=new Map,Ki="abort auxClick beforeToggle cancel canPlay canPlayThrough click close contextMenu copy cut drag dragEnd dragEnter dragExit dragLeave dragOver dragStart drop durationChange emptied encrypted ended error gotPointerCapture input invalid keyDown keyPress keyUp load loadedData loadedMetadata loadStart lostPointerCapture mouseDown mouseMove mouseOut mouseOver mouseUp paste pause play playing pointerCancel pointerDown pointerMove pointerOut pointerOver pointerUp progress rateChange reset resize seeked seeking stalled submit suspend timeUpdate touchCancel touchEnd touchStart volumeChange scroll toggle touchMove waiting wheel".split(" ");Ki.push("scrollEnd");function Dt(e,t){io.set(e,t),Hl(t,[e])}var iu=typeof reportError=="function"?reportError:function(e){if(typeof window=="object"&&typeof window.ErrorEvent=="function"){var t=new window.ErrorEvent("error",{bubbles:!0,cancelable:!0,message:typeof e=="object"&&e!==null&&typeof e.message=="string"?String(e.message):String(e),error:e});if(!window.dispatchEvent(t))return}else if(typeof process=="object"&&typeof process.emit=="function"){process.emit("uncaughtException",e);return}console.error(e)},Et=[],fa=0,Ji=0;function cu(){for(var e=fa,t=Ji=fa=0;t<e;){var l=Et[t];Et[t++]=null;var a=Et[t];Et[t++]=null;var n=Et[t];Et[t++]=null;var u=Et[t];if(Et[t++]=null,a!==null&&n!==null){var s=a.pending;s===null?n.next=n:(n.next=s.next,s.next=n),a.pending=n}u!==0&&co(l,n,u)}}function su(e,t,l,a){Et[fa++]=e,Et[fa++]=t,Et[fa++]=l,Et[fa++]=a,Ji|=a,e.lanes|=a,e=e.alternate,e!==null&&(e.lanes|=a)}function $i(e,t,l,a){return su(e,t,l,a),ru(e)}function Yl(e,t){return su(e,null,null,t),ru(e)}function co(e,t,l){e.lanes|=l;var a=e.alternate;a!==null&&(a.lanes|=l);for(var n=!1,u=e.return;u!==null;)u.childLanes|=l,a=u.alternate,a!==null&&(a.childLanes|=l),u.tag===22&&(e=u.stateNode,e===null||e._visibility&1||(n=!0)),e=u,u=u.return;return e.tag===3?(u=e.stateNode,n&&t!==null&&(n=31-ft(l),e=u.hiddenUpdates,a=e[n],a===null?e[n]=[t]:a.push(t),t.lane=l|536870912),u):null}function ru(e){if(50<Tn)throw Tn=0,ns=null,Error(r(185));for(var t=e.return;t!==null;)e=t,t=e.return;return e.tag===3?e.stateNode:null}var da={};function bh(e,t,l,a){this.tag=e,this.key=l,this.sibling=this.child=this.return=this.stateNode=this.type=this.elementType=null,this.index=0,this.refCleanup=this.ref=null,this.pendingProps=t,this.dependencies=this.memoizedState=this.updateQueue=this.memoizedProps=null,this.mode=a,this.subtreeFlags=this.flags=0,this.deletions=null,this.childLanes=this.lanes=0,this.alternate=null}function mt(e,t,l,a){return new bh(e,t,l,a)}function Wi(e){return e=e.prototype,!(!e||!e.isReactComponent)}function Zt(e,t){var l=e.alternate;return l===null?(l=mt(e.tag,t,e.key,e.mode),l.elementType=e.elementType,l.type=e.type,l.stateNode=e.stateNode,l.alternate=e,e.alternate=l):(l.pendingProps=t,l.type=e.type,l.flags=0,l.subtreeFlags=0,l.deletions=null),l.flags=e.flags&65011712,l.childLanes=e.childLanes,l.lanes=e.lanes,l.child=e.child,l.memoizedProps=e.memoizedProps,l.memoizedState=e.memoizedState,l.updateQueue=e.updateQueue,t=e.dependencies,l.dependencies=t===null?null:{lanes:t.lanes,firstContext:t.firstContext},l.sibling=e.sibling,l.index=e.index,l.ref=e.ref,l.refCleanup=e.refCleanup,l}function so(e,t){e.flags&=65011714;var l=e.alternate;return l===null?(e.childLanes=0,e.lanes=t,e.child=null,e.subtreeFlags=0,e.memoizedProps=null,e.memoizedState=null,e.updateQueue=null,e.dependencies=null,e.stateNode=null):(e.childLanes=l.childLanes,e.lanes=l.lanes,e.child=l.child,e.subtreeFlags=0,e.deletions=null,e.memoizedProps=l.memoizedProps,e.memoizedState=l.memoizedState,e.updateQueue=l.updateQueue,e.type=l.type,t=l.dependencies,e.dependencies=t===null?null:{lanes:t.lanes,firstContext:t.firstContext}),e}function ou(e,t,l,a,n,u){var s=0;if(a=e,typeof e=="function")Wi(e)&&(s=1);else if(typeof e=="string")s=Ty(e,l,V.current)?26:e==="html"||e==="head"||e==="body"?27:5;else e:switch(e){case Ee:return e=mt(31,l,t,n),e.elementType=Ee,e.lanes=u,e;case Y:return Gl(l.children,n,u,t);case B:s=8,n|=24;break;case G:return e=mt(12,l,t,n|2),e.elementType=G,e.lanes=u,e;case I:return e=mt(13,l,t,n),e.elementType=I,e.lanes=u,e;case oe:return e=mt(19,l,t,n),e.elementType=oe,e.lanes=u,e;default:if(typeof e=="object"&&e!==null)switch(e.$$typeof){case H:s=10;break e;case Q:s=9;break e;case ee:s=11;break e;case W:s=14;break e;case J:s=16,a=null;break e}s=29,l=Error(r(130,e===null?"null":typeof e,"")),a=null}return t=mt(s,l,t,n),t.elementType=e,t.type=a,t.lanes=u,t}function Gl(e,t,l,a){return e=mt(7,e,a,t),e.lanes=l,e}function Fi(e,t,l){return e=mt(6,e,null,t),e.lanes=l,e}function ro(e){var t=mt(18,null,null,0);return t.stateNode=e,t}function Ii(e,t,l){return t=mt(4,e.children!==null?e.children:[],e.key,t),t.lanes=l,t.stateNode={containerInfo:e.containerInfo,pendingChildren:null,implementation:e.implementation},t}var oo=new WeakMap;function Tt(e,t){if(typeof e=="object"&&e!==null){var l=oo.get(e);return l!==void 0?l:(t={value:e,source:t,stack:rr(t)},oo.set(e,t),t)}return{value:e,source:t,stack:rr(t)}}var ma=[],ha=0,fu=null,an=0,Ct=[],zt=0,dl=null,Lt=1,Bt="";function Vt(e,t){ma[ha++]=an,ma[ha++]=fu,fu=e,an=t}function fo(e,t,l){Ct[zt++]=Lt,Ct[zt++]=Bt,Ct[zt++]=dl,dl=e;var a=Lt;e=Bt;var n=32-ft(a)-1;a&=~(1<<n),l+=1;var u=32-ft(t)+n;if(30<u){var s=n-n%5;u=(a&(1<<s)-1).toString(32),a>>=s,n-=s,Lt=1<<32-ft(t)+n|l<<n|a,Bt=u+e}else Lt=1<<u|l<<n|a,Bt=e}function Pi(e){e.return!==null&&(Vt(e,1),fo(e,1,0))}function ec(e){for(;e===fu;)fu=ma[--ha],ma[ha]=null,an=ma[--ha],ma[ha]=null;for(;e===dl;)dl=Ct[--zt],Ct[zt]=null,Bt=Ct[--zt],Ct[zt]=null,Lt=Ct[--zt],Ct[zt]=null}function mo(e,t){Ct[zt++]=Lt,Ct[zt++]=Bt,Ct[zt++]=dl,Lt=t.id,Bt=t.overflow,dl=e}var Ve=null,ze=null,me=!1,ml=null,At=!1,tc=Error(r(519));function hl(e){var t=Error(r(418,1<arguments.length&&arguments[1]!==void 0&&arguments[1]?"text":"HTML",""));throw nn(Tt(t,e)),tc}function ho(e){var t=e.stateNode,l=e.type,a=e.memoizedProps;switch(t[Ze]=e,t[tt]=a,l){case"dialog":re("cancel",t),re("close",t);break;case"iframe":case"object":case"embed":re("load",t);break;case"video":case"audio":for(l=0;l<zn.length;l++)re(zn[l],t);break;case"source":re("error",t);break;case"img":case"image":case"link":re("error",t),re("load",t);break;case"details":re("toggle",t);break;case"input":re("invalid",t),Cr(t,a.value,a.defaultValue,a.checked,a.defaultChecked,a.type,a.name,!0);break;case"select":re("invalid",t);break;case"textarea":re("invalid",t),Ar(t,a.value,a.defaultValue,a.children)}l=a.children,typeof l!="string"&&typeof l!="number"&&typeof l!="bigint"||t.textContent===""+l||a.suppressHydrationWarning===!0||Dd(t.textContent,l)?(a.popover!=null&&(re("beforetoggle",t),re("toggle",t)),a.onScroll!=null&&re("scroll",t),a.onScrollEnd!=null&&re("scrollend",t),a.onClick!=null&&(t.onclick=Xt),t=!0):t=!1,t||hl(e,!0)}function yo(e){for(Ve=e.return;Ve;)switch(Ve.tag){case 5:case 31:case 13:At=!1;return;case 27:case 3:At=!0;return;default:Ve=Ve.return}}function ya(e){if(e!==Ve)return!1;if(!me)return yo(e),me=!0,!1;var t=e.tag,l;if((l=t!==3&&t!==27)&&((l=t===5)&&(l=e.type,l=!(l!=="form"&&l!=="button")||vs(e.type,e.memoizedProps)),l=!l),l&&ze&&hl(e),yo(e),t===13){if(e=e.memoizedState,e=e!==null?e.dehydrated:null,!e)throw Error(r(317));ze=Gd(e)}else if(t===31){if(e=e.memoizedState,e=e!==null?e.dehydrated:null,!e)throw Error(r(317));ze=Gd(e)}else t===27?(t=ze,Al(e.type)?(e=Es,Es=null,ze=e):ze=t):ze=Ve?wt(e.stateNode.nextSibling):null;return!0}function kl(){ze=Ve=null,me=!1}function lc(){var e=ml;return e!==null&&(it===null?it=e:it.push.apply(it,e),ml=null),e}function nn(e){ml===null?ml=[e]:ml.push(e)}var ac=N(null),Xl=null,Kt=null;function yl(e,t,l){X(ac,t._currentValue),t._currentValue=l}function Jt(e){e._currentValue=ac.current,O(ac)}function nc(e,t,l){for(;e!==null;){var a=e.alternate;if((e.childLanes&t)!==t?(e.childLanes|=t,a!==null&&(a.childLanes|=t)):a!==null&&(a.childLanes&t)!==t&&(a.childLanes|=t),e===l)break;e=e.return}}function uc(e,t,l,a){var n=e.child;for(n!==null&&(n.return=e);n!==null;){var u=n.dependencies;if(u!==null){var s=n.child;u=u.firstContext;e:for(;u!==null;){var d=u;u=n;for(var g=0;g<t.length;g++)if(d.context===t[g]){u.lanes|=l,d=u.alternate,d!==null&&(d.lanes|=l),nc(u.return,l,e),a||(s=null);break e}u=d.next}}else if(n.tag===18){if(s=n.return,s===null)throw Error(r(341));s.lanes|=l,u=s.alternate,u!==null&&(u.lanes|=l),nc(s,l,e),s=null}else s=n.child;if(s!==null)s.return=n;else for(s=n;s!==null;){if(s===e){s=null;break}if(n=s.sibling,n!==null){n.return=s.return,s=n;break}s=s.return}n=s}}function ga(e,t,l,a){e=null;for(var n=t,u=!1;n!==null;){if(!u){if((n.flags&524288)!==0)u=!0;else if((n.flags&262144)!==0)break}if(n.tag===10){var s=n.alternate;if(s===null)throw Error(r(387));if(s=s.memoizedProps,s!==null){var d=n.type;dt(n.pendingProps.value,s.value)||(e!==null?e.push(d):e=[d])}}else if(n===xe.current){if(s=n.alternate,s===null)throw Error(r(387));s.memoizedState.memoizedState!==n.memoizedState.memoizedState&&(e!==null?e.push(Dn):e=[Dn])}n=n.return}e!==null&&uc(t,e,l,a),t.flags|=262144}function du(e){for(e=e.firstContext;e!==null;){if(!dt(e.context._currentValue,e.memoizedValue))return!0;e=e.next}return!1}function Ql(e){Xl=e,Kt=null,e=e.dependencies,e!==null&&(e.firstContext=null)}function Ke(e){return go(Xl,e)}function mu(e,t){return Xl===null&&Ql(e),go(e,t)}function go(e,t){var l=t._currentValue;if(t={context:t,memoizedValue:l,next:null},Kt===null){if(e===null)throw Error(r(308));Kt=t,e.dependencies={lanes:0,firstContext:t},e.flags|=524288}else Kt=Kt.next=t;return l}var Sh=typeof AbortController<"u"?AbortController:function(){var e=[],t=this.signal={aborted:!1,addEventListener:function(l,a){e.push(a)}};this.abort=function(){t.aborted=!0,e.forEach(function(l){return l()})}},Nh=i.unstable_scheduleCallback,jh=i.unstable_NormalPriority,Le={$$typeof:H,Consumer:null,Provider:null,_currentValue:null,_currentValue2:null,_threadCount:0};function ic(){return{controller:new Sh,data:new Map,refCount:0}}function un(e){e.refCount--,e.refCount===0&&Nh(jh,function(){e.controller.abort()})}var cn=null,cc=0,xa=0,pa=null;function Eh(e,t){if(cn===null){var l=cn=[];cc=0,xa=os(),pa={status:"pending",value:void 0,then:function(a){l.push(a)}}}return cc++,t.then(xo,xo),t}function xo(){if(--cc===0&&cn!==null){pa!==null&&(pa.status="fulfilled");var e=cn;cn=null,xa=0,pa=null;for(var t=0;t<e.length;t++)(0,e[t])()}}function Th(e,t){var l=[],a={status:"pending",value:null,reason:null,then:function(n){l.push(n)}};return e.then(function(){a.status="fulfilled",a.value=t;for(var n=0;n<l.length;n++)(0,l[n])(t)},function(n){for(a.status="rejected",a.reason=n,n=0;n<l.length;n++)(0,l[n])(void 0)}),a}var po=w.S;w.S=function(e,t){ld=rt(),typeof t=="object"&&t!==null&&typeof t.then=="function"&&Eh(e,t),po!==null&&po(e,t)};var Zl=N(null);function sc(){var e=Zl.current;return e!==null?e:Ce.pooledCache}function hu(e,t){t===null?X(Zl,Zl.current):X(Zl,t.pool)}function vo(){var e=sc();return e===null?null:{parent:Le._currentValue,pool:e}}var va=Error(r(460)),rc=Error(r(474)),yu=Error(r(542)),gu={then:function(){}};function bo(e){return e=e.status,e==="fulfilled"||e==="rejected"}function So(e,t,l){switch(l=e[l],l===void 0?e.push(t):l!==t&&(t.then(Xt,Xt),t=l),t.status){case"fulfilled":return t.value;case"rejected":throw e=t.reason,jo(e),e;default:if(typeof t.status=="string")t.then(Xt,Xt);else{if(e=Ce,e!==null&&100<e.shellSuspendCounter)throw Error(r(482));e=t,e.status="pending",e.then(function(a){if(t.status==="pending"){var n=t;n.status="fulfilled",n.value=a}},function(a){if(t.status==="pending"){var n=t;n.status="rejected",n.reason=a}})}switch(t.status){case"fulfilled":return t.value;case"rejected":throw e=t.reason,jo(e),e}throw Kl=t,va}}function Vl(e){try{var t=e._init;return t(e._payload)}catch(l){throw l!==null&&typeof l=="object"&&typeof l.then=="function"?(Kl=l,va):l}}var Kl=null;function No(){if(Kl===null)throw Error(r(459));var e=Kl;return Kl=null,e}function jo(e){if(e===va||e===yu)throw Error(r(483))}var ba=null,sn=0;function xu(e){var t=sn;return sn+=1,ba===null&&(ba=[]),So(ba,e,t)}function rn(e,t){t=t.props.ref,e.ref=t!==void 0?t:null}function pu(e,t){throw t.$$typeof===U?Error(r(525)):(e=Object.prototype.toString.call(t),Error(r(31,e==="[object Object]"?"object with keys {"+Object.keys(t).join(", ")+"}":e)))}function Eo(e){function t(E,S){if(e){var T=E.deletions;T===null?(E.deletions=[S],E.flags|=16):T.push(S)}}function l(E,S){if(!e)return null;for(;S!==null;)t(E,S),S=S.sibling;return null}function a(E){for(var S=new Map;E!==null;)E.key!==null?S.set(E.key,E):S.set(E.index,E),E=E.sibling;return S}function n(E,S){return E=Zt(E,S),E.index=0,E.sibling=null,E}function u(E,S,T){return E.index=T,e?(T=E.alternate,T!==null?(T=T.index,T<S?(E.flags|=67108866,S):T):(E.flags|=67108866,S)):(E.flags|=1048576,S)}function s(E){return e&&E.alternate===null&&(E.flags|=67108866),E}function d(E,S,T,D){return S===null||S.tag!==6?(S=Fi(T,E.mode,D),S.return=E,S):(S=n(S,T),S.return=E,S)}function g(E,S,T,D){var $=T.type;return $===Y?M(E,S,T.props.children,D,T.key):S!==null&&(S.elementType===$||typeof $=="object"&&$!==null&&$.$$typeof===J&&Vl($)===S.type)?(S=n(S,T.props),rn(S,T),S.return=E,S):(S=ou(T.type,T.key,T.props,null,E.mode,D),rn(S,T),S.return=E,S)}function C(E,S,T,D){return S===null||S.tag!==4||S.stateNode.containerInfo!==T.containerInfo||S.stateNode.implementation!==T.implementation?(S=Ii(T,E.mode,D),S.return=E,S):(S=n(S,T.children||[]),S.return=E,S)}function M(E,S,T,D,$){return S===null||S.tag!==7?(S=Gl(T,E.mode,D,$),S.return=E,S):(S=n(S,T),S.return=E,S)}function R(E,S,T){if(typeof S=="string"&&S!==""||typeof S=="number"||typeof S=="bigint")return S=Fi(""+S,E.mode,T),S.return=E,S;if(typeof S=="object"&&S!==null){switch(S.$$typeof){case L:return T=ou(S.type,S.key,S.props,null,E.mode,T),rn(T,S),T.return=E,T;case q:return S=Ii(S,E.mode,T),S.return=E,S;case J:return S=Vl(S),R(E,S,T)}if(ke(S)||Fe(S))return S=Gl(S,E.mode,T,null),S.return=E,S;if(typeof S.then=="function")return R(E,xu(S),T);if(S.$$typeof===H)return R(E,mu(E,S),T);pu(E,S)}return null}function z(E,S,T,D){var $=S!==null?S.key:null;if(typeof T=="string"&&T!==""||typeof T=="number"||typeof T=="bigint")return $!==null?null:d(E,S,""+T,D);if(typeof T=="object"&&T!==null){switch(T.$$typeof){case L:return T.key===$?g(E,S,T,D):null;case q:return T.key===$?C(E,S,T,D):null;case J:return T=Vl(T),z(E,S,T,D)}if(ke(T)||Fe(T))return $!==null?null:M(E,S,T,D,null);if(typeof T.then=="function")return z(E,S,xu(T),D);if(T.$$typeof===H)return z(E,S,mu(E,T),D);pu(E,T)}return null}function _(E,S,T,D,$){if(typeof D=="string"&&D!==""||typeof D=="number"||typeof D=="bigint")return E=E.get(T)||null,d(S,E,""+D,$);if(typeof D=="object"&&D!==null){switch(D.$$typeof){case L:return E=E.get(D.key===null?T:D.key)||null,g(S,E,D,$);case q:return E=E.get(D.key===null?T:D.key)||null,C(S,E,D,$);case J:return D=Vl(D),_(E,S,T,D,$)}if(ke(D)||Fe(D))return E=E.get(T)||null,M(S,E,D,$,null);if(typeof D.then=="function")return _(E,S,T,xu(D),$);if(D.$$typeof===H)return _(E,S,T,mu(S,D),$);pu(S,D)}return null}function Z(E,S,T,D){for(var $=null,he=null,K=S,ie=S=0,de=null;K!==null&&ie<T.length;ie++){K.index>ie?(de=K,K=null):de=K.sibling;var ye=z(E,K,T[ie],D);if(ye===null){K===null&&(K=de);break}e&&K&&ye.alternate===null&&t(E,K),S=u(ye,S,ie),he===null?$=ye:he.sibling=ye,he=ye,K=de}if(ie===T.length)return l(E,K),me&&Vt(E,ie),$;if(K===null){for(;ie<T.length;ie++)K=R(E,T[ie],D),K!==null&&(S=u(K,S,ie),he===null?$=K:he.sibling=K,he=K);return me&&Vt(E,ie),$}for(K=a(K);ie<T.length;ie++)de=_(K,E,ie,T[ie],D),de!==null&&(e&&de.alternate!==null&&K.delete(de.key===null?ie:de.key),S=u(de,S,ie),he===null?$=de:he.sibling=de,he=de);return e&&K.forEach(function(Rl){return t(E,Rl)}),me&&Vt(E,ie),$}function F(E,S,T,D){if(T==null)throw Error(r(151));for(var $=null,he=null,K=S,ie=S=0,de=null,ye=T.next();K!==null&&!ye.done;ie++,ye=T.next()){K.index>ie?(de=K,K=null):de=K.sibling;var Rl=z(E,K,ye.value,D);if(Rl===null){K===null&&(K=de);break}e&&K&&Rl.alternate===null&&t(E,K),S=u(Rl,S,ie),he===null?$=Rl:he.sibling=Rl,he=Rl,K=de}if(ye.done)return l(E,K),me&&Vt(E,ie),$;if(K===null){for(;!ye.done;ie++,ye=T.next())ye=R(E,ye.value,D),ye!==null&&(S=u(ye,S,ie),he===null?$=ye:he.sibling=ye,he=ye);return me&&Vt(E,ie),$}for(K=a(K);!ye.done;ie++,ye=T.next())ye=_(K,E,ie,ye.value,D),ye!==null&&(e&&ye.alternate!==null&&K.delete(ye.key===null?ie:ye.key),S=u(ye,S,ie),he===null?$=ye:he.sibling=ye,he=ye);return e&&K.forEach(function(Hy){return t(E,Hy)}),me&&Vt(E,ie),$}function je(E,S,T,D){if(typeof T=="object"&&T!==null&&T.type===Y&&T.key===null&&(T=T.props.children),typeof T=="object"&&T!==null){switch(T.$$typeof){case L:e:{for(var $=T.key;S!==null;){if(S.key===$){if($=T.type,$===Y){if(S.tag===7){l(E,S.sibling),D=n(S,T.props.children),D.return=E,E=D;break e}}else if(S.elementType===$||typeof $=="object"&&$!==null&&$.$$typeof===J&&Vl($)===S.type){l(E,S.sibling),D=n(S,T.props),rn(D,T),D.return=E,E=D;break e}l(E,S);break}else t(E,S);S=S.sibling}T.type===Y?(D=Gl(T.props.children,E.mode,D,T.key),D.return=E,E=D):(D=ou(T.type,T.key,T.props,null,E.mode,D),rn(D,T),D.return=E,E=D)}return s(E);case q:e:{for($=T.key;S!==null;){if(S.key===$)if(S.tag===4&&S.stateNode.containerInfo===T.containerInfo&&S.stateNode.implementation===T.implementation){l(E,S.sibling),D=n(S,T.children||[]),D.return=E,E=D;break e}else{l(E,S);break}else t(E,S);S=S.sibling}D=Ii(T,E.mode,D),D.return=E,E=D}return s(E);case J:return T=Vl(T),je(E,S,T,D)}if(ke(T))return Z(E,S,T,D);if(Fe(T)){if($=Fe(T),typeof $!="function")throw Error(r(150));return T=$.call(T),F(E,S,T,D)}if(typeof T.then=="function")return je(E,S,xu(T),D);if(T.$$typeof===H)return je(E,S,mu(E,T),D);pu(E,T)}return typeof T=="string"&&T!==""||typeof T=="number"||typeof T=="bigint"?(T=""+T,S!==null&&S.tag===6?(l(E,S.sibling),D=n(S,T),D.return=E,E=D):(l(E,S),D=Fi(T,E.mode,D),D.return=E,E=D),s(E)):l(E,S)}return function(E,S,T,D){try{sn=0;var $=je(E,S,T,D);return ba=null,$}catch(K){if(K===va||K===yu)throw K;var he=mt(29,K,null,E.mode);return he.lanes=D,he.return=E,he}finally{}}}var Jl=Eo(!0),To=Eo(!1),gl=!1;function oc(e){e.updateQueue={baseState:e.memoizedState,firstBaseUpdate:null,lastBaseUpdate:null,shared:{pending:null,lanes:0,hiddenCallbacks:null},callbacks:null}}function fc(e,t){e=e.updateQueue,t.updateQueue===e&&(t.updateQueue={baseState:e.baseState,firstBaseUpdate:e.firstBaseUpdate,lastBaseUpdate:e.lastBaseUpdate,shared:e.shared,callbacks:null})}function xl(e){return{lane:e,tag:0,payload:null,callback:null,next:null}}function pl(e,t,l){var a=e.updateQueue;if(a===null)return null;if(a=a.shared,(ge&2)!==0){var n=a.pending;return n===null?t.next=t:(t.next=n.next,n.next=t),a.pending=t,t=ru(e),co(e,null,l),t}return su(e,a,t,l),ru(e)}function on(e,t,l){if(t=t.updateQueue,t!==null&&(t=t.shared,(l&4194048)!==0)){var a=t.lanes;a&=e.pendingLanes,l|=a,t.lanes=l,yr(e,l)}}function dc(e,t){var l=e.updateQueue,a=e.alternate;if(a!==null&&(a=a.updateQueue,l===a)){var n=null,u=null;if(l=l.firstBaseUpdate,l!==null){do{var s={lane:l.lane,tag:l.tag,payload:l.payload,callback:null,next:null};u===null?n=u=s:u=u.next=s,l=l.next}while(l!==null);u===null?n=u=t:u=u.next=t}else n=u=t;l={baseState:a.baseState,firstBaseUpdate:n,lastBaseUpdate:u,shared:a.shared,callbacks:a.callbacks},e.updateQueue=l;return}e=l.lastBaseUpdate,e===null?l.firstBaseUpdate=t:e.next=t,l.lastBaseUpdate=t}var mc=!1;function fn(){if(mc){var e=pa;if(e!==null)throw e}}function dn(e,t,l,a){mc=!1;var n=e.updateQueue;gl=!1;var u=n.firstBaseUpdate,s=n.lastBaseUpdate,d=n.shared.pending;if(d!==null){n.shared.pending=null;var g=d,C=g.next;g.next=null,s===null?u=C:s.next=C,s=g;var M=e.alternate;M!==null&&(M=M.updateQueue,d=M.lastBaseUpdate,d!==s&&(d===null?M.firstBaseUpdate=C:d.next=C,M.lastBaseUpdate=g))}if(u!==null){var R=n.baseState;s=0,M=C=g=null,d=u;do{var z=d.lane&-536870913,_=z!==d.lane;if(_?(fe&z)===z:(a&z)===z){z!==0&&z===xa&&(mc=!0),M!==null&&(M=M.next={lane:0,tag:d.tag,payload:d.payload,callback:null,next:null});e:{var Z=e,F=d;z=t;var je=l;switch(F.tag){case 1:if(Z=F.payload,typeof Z=="function"){R=Z.call(je,R,z);break e}R=Z;break e;case 3:Z.flags=Z.flags&-65537|128;case 0:if(Z=F.payload,z=typeof Z=="function"?Z.call(je,R,z):Z,z==null)break e;R=b({},R,z);break e;case 2:gl=!0}}z=d.callback,z!==null&&(e.flags|=64,_&&(e.flags|=8192),_=n.callbacks,_===null?n.callbacks=[z]:_.push(z))}else _={lane:z,tag:d.tag,payload:d.payload,callback:d.callback,next:null},M===null?(C=M=_,g=R):M=M.next=_,s|=z;if(d=d.next,d===null){if(d=n.shared.pending,d===null)break;_=d,d=_.next,_.next=null,n.lastBaseUpdate=_,n.shared.pending=null}}while(!0);M===null&&(g=R),n.baseState=g,n.firstBaseUpdate=C,n.lastBaseUpdate=M,u===null&&(n.shared.lanes=0),jl|=s,e.lanes=s,e.memoizedState=R}}function Co(e,t){if(typeof e!="function")throw Error(r(191,e));e.call(t)}function zo(e,t){var l=e.callbacks;if(l!==null)for(e.callbacks=null,e=0;e<l.length;e++)Co(l[e],t)}var Sa=N(null),vu=N(0);function Ao(e,t){e=al,X(vu,e),X(Sa,t),al=e|t.baseLanes}function hc(){X(vu,al),X(Sa,Sa.current)}function yc(){al=vu.current,O(Sa),O(vu)}var ht=N(null),_t=null;function vl(e){var t=e.alternate;X(Ue,Ue.current&1),X(ht,e),_t===null&&(t===null||Sa.current!==null||t.memoizedState!==null)&&(_t=e)}function gc(e){X(Ue,Ue.current),X(ht,e),_t===null&&(_t=e)}function _o(e){e.tag===22?(X(Ue,Ue.current),X(ht,e),_t===null&&(_t=e)):bl()}function bl(){X(Ue,Ue.current),X(ht,ht.current)}function yt(e){O(ht),_t===e&&(_t=null),O(Ue)}var Ue=N(0);function bu(e){for(var t=e;t!==null;){if(t.tag===13){var l=t.memoizedState;if(l!==null&&(l=l.dehydrated,l===null||Ns(l)||js(l)))return t}else if(t.tag===19&&(t.memoizedProps.revealOrder==="forwards"||t.memoizedProps.revealOrder==="backwards"||t.memoizedProps.revealOrder==="unstable_legacy-backwards"||t.memoizedProps.revealOrder==="together")){if((t.flags&128)!==0)return t}else if(t.child!==null){t.child.return=t,t=t.child;continue}if(t===e)break;for(;t.sibling===null;){if(t.return===null||t.return===e)return null;t=t.return}t.sibling.return=t.return,t=t.sibling}return null}var $t=0,ne=null,Se=null,Be=null,Su=!1,Na=!1,$l=!1,Nu=0,mn=0,ja=null,Ch=0;function De(){throw Error(r(321))}function xc(e,t){if(t===null)return!1;for(var l=0;l<t.length&&l<e.length;l++)if(!dt(e[l],t[l]))return!1;return!0}function pc(e,t,l,a,n,u){return $t=u,ne=t,t.memoizedState=null,t.updateQueue=null,t.lanes=0,w.H=e===null||e.memoizedState===null?mf:Rc,$l=!1,u=l(a,n),$l=!1,Na&&(u=Mo(t,l,a,n)),wo(e),u}function wo(e){w.H=gn;var t=Se!==null&&Se.next!==null;if($t=0,Be=Se=ne=null,Su=!1,mn=0,ja=null,t)throw Error(r(300));e===null||qe||(e=e.dependencies,e!==null&&du(e)&&(qe=!0))}function Mo(e,t,l,a){ne=e;var n=0;do{if(Na&&(ja=null),mn=0,Na=!1,25<=n)throw Error(r(301));if(n+=1,Be=Se=null,e.updateQueue!=null){var u=e.updateQueue;u.lastEffect=null,u.events=null,u.stores=null,u.memoCache!=null&&(u.memoCache.index=0)}w.H=hf,u=t(l,a)}while(Na);return u}function zh(){var e=w.H,t=e.useState()[0];return t=typeof t.then=="function"?hn(t):t,e=e.useState()[0],(Se!==null?Se.memoizedState:null)!==e&&(ne.flags|=1024),t}function vc(){var e=Nu!==0;return Nu=0,e}function bc(e,t,l){t.updateQueue=e.updateQueue,t.flags&=-2053,e.lanes&=~l}function Sc(e){if(Su){for(e=e.memoizedState;e!==null;){var t=e.queue;t!==null&&(t.pending=null),e=e.next}Su=!1}$t=0,Be=Se=ne=null,Na=!1,mn=Nu=0,ja=null}function et(){var e={memoizedState:null,baseState:null,baseQueue:null,queue:null,next:null};return Be===null?ne.memoizedState=Be=e:Be=Be.next=e,Be}function He(){if(Se===null){var e=ne.alternate;e=e!==null?e.memoizedState:null}else e=Se.next;var t=Be===null?ne.memoizedState:Be.next;if(t!==null)Be=t,Se=e;else{if(e===null)throw ne.alternate===null?Error(r(467)):Error(r(310));Se=e,e={memoizedState:Se.memoizedState,baseState:Se.baseState,baseQueue:Se.baseQueue,queue:Se.queue,next:null},Be===null?ne.memoizedState=Be=e:Be=Be.next=e}return Be}function ju(){return{lastEffect:null,events:null,stores:null,memoCache:null}}function hn(e){var t=mn;return mn+=1,ja===null&&(ja=[]),e=So(ja,e,t),t=ne,(Be===null?t.memoizedState:Be.next)===null&&(t=t.alternate,w.H=t===null||t.memoizedState===null?mf:Rc),e}function Eu(e){if(e!==null&&typeof e=="object"){if(typeof e.then=="function")return hn(e);if(e.$$typeof===H)return Ke(e)}throw Error(r(438,String(e)))}function Nc(e){var t=null,l=ne.updateQueue;if(l!==null&&(t=l.memoCache),t==null){var a=ne.alternate;a!==null&&(a=a.updateQueue,a!==null&&(a=a.memoCache,a!=null&&(t={data:a.data.map(function(n){return n.slice()}),index:0})))}if(t==null&&(t={data:[],index:0}),l===null&&(l=ju(),ne.updateQueue=l),l.memoCache=t,l=t.data[t.index],l===void 0)for(l=t.data[t.index]=Array(e),a=0;a<e;a++)l[a]=We;return t.index++,l}function Wt(e,t){return typeof t=="function"?t(e):t}function Tu(e){var t=He();return jc(t,Se,e)}function jc(e,t,l){var a=e.queue;if(a===null)throw Error(r(311));a.lastRenderedReducer=l;var n=e.baseQueue,u=a.pending;if(u!==null){if(n!==null){var s=n.next;n.next=u.next,u.next=s}t.baseQueue=n=u,a.pending=null}if(u=e.baseState,n===null)e.memoizedState=u;else{t=n.next;var d=s=null,g=null,C=t,M=!1;do{var R=C.lane&-536870913;if(R!==C.lane?(fe&R)===R:($t&R)===R){var z=C.revertLane;if(z===0)g!==null&&(g=g.next={lane:0,revertLane:0,gesture:null,action:C.action,hasEagerState:C.hasEagerState,eagerState:C.eagerState,next:null}),R===xa&&(M=!0);else if(($t&z)===z){C=C.next,z===xa&&(M=!0);continue}else R={lane:0,revertLane:C.revertLane,gesture:null,action:C.action,hasEagerState:C.hasEagerState,eagerState:C.eagerState,next:null},g===null?(d=g=R,s=u):g=g.next=R,ne.lanes|=z,jl|=z;R=C.action,$l&&l(u,R),u=C.hasEagerState?C.eagerState:l(u,R)}else z={lane:R,revertLane:C.revertLane,gesture:C.gesture,action:C.action,hasEagerState:C.hasEagerState,eagerState:C.eagerState,next:null},g===null?(d=g=z,s=u):g=g.next=z,ne.lanes|=R,jl|=R;C=C.next}while(C!==null&&C!==t);if(g===null?s=u:g.next=d,!dt(u,e.memoizedState)&&(qe=!0,M&&(l=pa,l!==null)))throw l;e.memoizedState=u,e.baseState=s,e.baseQueue=g,a.lastRenderedState=u}return n===null&&(a.lanes=0),[e.memoizedState,a.dispatch]}function Ec(e){var t=He(),l=t.queue;if(l===null)throw Error(r(311));l.lastRenderedReducer=e;var a=l.dispatch,n=l.pending,u=t.memoizedState;if(n!==null){l.pending=null;var s=n=n.next;do u=e(u,s.action),s=s.next;while(s!==n);dt(u,t.memoizedState)||(qe=!0),t.memoizedState=u,t.baseQueue===null&&(t.baseState=u),l.lastRenderedState=u}return[u,a]}function Do(e,t,l){var a=ne,n=He(),u=me;if(u){if(l===void 0)throw Error(r(407));l=l()}else l=t();var s=!dt((Se||n).memoizedState,l);if(s&&(n.memoizedState=l,qe=!0),n=n.queue,zc(Uo.bind(null,a,n,e),[e]),n.getSnapshot!==t||s||Be!==null&&Be.memoizedState.tag&1){if(a.flags|=2048,Ea(9,{destroy:void 0},Oo.bind(null,a,n,l,t),null),Ce===null)throw Error(r(349));u||($t&127)!==0||Ro(a,t,l)}return l}function Ro(e,t,l){e.flags|=16384,e={getSnapshot:t,value:l},t=ne.updateQueue,t===null?(t=ju(),ne.updateQueue=t,t.stores=[e]):(l=t.stores,l===null?t.stores=[e]:l.push(e))}function Oo(e,t,l,a){t.value=l,t.getSnapshot=a,Ho(t)&&Lo(e)}function Uo(e,t,l){return l(function(){Ho(t)&&Lo(e)})}function Ho(e){var t=e.getSnapshot;e=e.value;try{var l=t();return!dt(e,l)}catch{return!0}}function Lo(e){var t=Yl(e,2);t!==null&&ct(t,e,2)}function Tc(e){var t=et();if(typeof e=="function"){var l=e;if(e=l(),$l){rl(!0);try{l()}finally{rl(!1)}}}return t.memoizedState=t.baseState=e,t.queue={pending:null,lanes:0,dispatch:null,lastRenderedReducer:Wt,lastRenderedState:e},t}function Bo(e,t,l,a){return e.baseState=l,jc(e,Se,typeof a=="function"?a:Wt)}function Ah(e,t,l,a,n){if(Au(e))throw Error(r(485));if(e=t.action,e!==null){var u={payload:n,action:e,next:null,isTransition:!0,status:"pending",value:null,reason:null,listeners:[],then:function(s){u.listeners.push(s)}};w.T!==null?l(!0):u.isTransition=!1,a(u),l=t.pending,l===null?(u.next=t.pending=u,qo(t,u)):(u.next=l.next,t.pending=l.next=u)}}function qo(e,t){var l=t.action,a=t.payload,n=e.state;if(t.isTransition){var u=w.T,s={};w.T=s;try{var d=l(n,a),g=w.S;g!==null&&g(s,d),Yo(e,t,d)}catch(C){Cc(e,t,C)}finally{u!==null&&s.types!==null&&(u.types=s.types),w.T=u}}else try{u=l(n,a),Yo(e,t,u)}catch(C){Cc(e,t,C)}}function Yo(e,t,l){l!==null&&typeof l=="object"&&typeof l.then=="function"?l.then(function(a){Go(e,t,a)},function(a){return Cc(e,t,a)}):Go(e,t,l)}function Go(e,t,l){t.status="fulfilled",t.value=l,ko(t),e.state=l,t=e.pending,t!==null&&(l=t.next,l===t?e.pending=null:(l=l.next,t.next=l,qo(e,l)))}function Cc(e,t,l){var a=e.pending;if(e.pending=null,a!==null){a=a.next;do t.status="rejected",t.reason=l,ko(t),t=t.next;while(t!==a)}e.action=null}function ko(e){e=e.listeners;for(var t=0;t<e.length;t++)(0,e[t])()}function Xo(e,t){return t}function Qo(e,t){if(me){var l=Ce.formState;if(l!==null){e:{var a=ne;if(me){if(ze){t:{for(var n=ze,u=At;n.nodeType!==8;){if(!u){n=null;break t}if(n=wt(n.nextSibling),n===null){n=null;break t}}u=n.data,n=u==="F!"||u==="F"?n:null}if(n){ze=wt(n.nextSibling),a=n.data==="F!";break e}}hl(a)}a=!1}a&&(t=l[0])}}return l=et(),l.memoizedState=l.baseState=t,a={pending:null,lanes:0,dispatch:null,lastRenderedReducer:Xo,lastRenderedState:t},l.queue=a,l=of.bind(null,ne,a),a.dispatch=l,a=Tc(!1),u=Dc.bind(null,ne,!1,a.queue),a=et(),n={state:t,dispatch:null,action:e,pending:null},a.queue=n,l=Ah.bind(null,ne,n,u,l),n.dispatch=l,a.memoizedState=e,[t,l,!1]}function Zo(e){var t=He();return Vo(t,Se,e)}function Vo(e,t,l){if(t=jc(e,t,Xo)[0],e=Tu(Wt)[0],typeof t=="object"&&t!==null&&typeof t.then=="function")try{var a=hn(t)}catch(s){throw s===va?yu:s}else a=t;t=He();var n=t.queue,u=n.dispatch;return l!==t.memoizedState&&(ne.flags|=2048,Ea(9,{destroy:void 0},_h.bind(null,n,l),null)),[a,u,e]}function _h(e,t){e.action=t}function Ko(e){var t=He(),l=Se;if(l!==null)return Vo(t,l,e);He(),t=t.memoizedState,l=He();var a=l.queue.dispatch;return l.memoizedState=e,[t,a,!1]}function Ea(e,t,l,a){return e={tag:e,create:l,deps:a,inst:t,next:null},t=ne.updateQueue,t===null&&(t=ju(),ne.updateQueue=t),l=t.lastEffect,l===null?t.lastEffect=e.next=e:(a=l.next,l.next=e,e.next=a,t.lastEffect=e),e}function Jo(){return He().memoizedState}function Cu(e,t,l,a){var n=et();ne.flags|=e,n.memoizedState=Ea(1|t,{destroy:void 0},l,a===void 0?null:a)}function zu(e,t,l,a){var n=He();a=a===void 0?null:a;var u=n.memoizedState.inst;Se!==null&&a!==null&&xc(a,Se.memoizedState.deps)?n.memoizedState=Ea(t,u,l,a):(ne.flags|=e,n.memoizedState=Ea(1|t,u,l,a))}function $o(e,t){Cu(8390656,8,e,t)}function zc(e,t){zu(2048,8,e,t)}function wh(e){ne.flags|=4;var t=ne.updateQueue;if(t===null)t=ju(),ne.updateQueue=t,t.events=[e];else{var l=t.events;l===null?t.events=[e]:l.push(e)}}function Wo(e){var t=He().memoizedState;return wh({ref:t,nextImpl:e}),function(){if((ge&2)!==0)throw Error(r(440));return t.impl.apply(void 0,arguments)}}function Fo(e,t){return zu(4,2,e,t)}function Io(e,t){return zu(4,4,e,t)}function Po(e,t){if(typeof t=="function"){e=e();var l=t(e);return function(){typeof l=="function"?l():t(null)}}if(t!=null)return e=e(),t.current=e,function(){t.current=null}}function ef(e,t,l){l=l!=null?l.concat([e]):null,zu(4,4,Po.bind(null,t,e),l)}function Ac(){}function tf(e,t){var l=He();t=t===void 0?null:t;var a=l.memoizedState;return t!==null&&xc(t,a[1])?a[0]:(l.memoizedState=[e,t],e)}function lf(e,t){var l=He();t=t===void 0?null:t;var a=l.memoizedState;if(t!==null&&xc(t,a[1]))return a[0];if(a=e(),$l){rl(!0);try{e()}finally{rl(!1)}}return l.memoizedState=[a,t],a}function _c(e,t,l){return l===void 0||($t&1073741824)!==0&&(fe&261930)===0?e.memoizedState=t:(e.memoizedState=l,e=nd(),ne.lanes|=e,jl|=e,l)}function af(e,t,l,a){return dt(l,t)?l:Sa.current!==null?(e=_c(e,l,a),dt(e,t)||(qe=!0),e):($t&42)===0||($t&1073741824)!==0&&(fe&261930)===0?(qe=!0,e.memoizedState=l):(e=nd(),ne.lanes|=e,jl|=e,t)}function nf(e,t,l,a,n){var u=k.p;k.p=u!==0&&8>u?u:8;var s=w.T,d={};w.T=d,Dc(e,!1,t,l);try{var g=n(),C=w.S;if(C!==null&&C(d,g),g!==null&&typeof g=="object"&&typeof g.then=="function"){var M=Th(g,a);yn(e,t,M,pt(e))}else yn(e,t,a,pt(e))}catch(R){yn(e,t,{then:function(){},status:"rejected",reason:R},pt())}finally{k.p=u,s!==null&&d.types!==null&&(s.types=d.types),w.T=s}}function Mh(){}function wc(e,t,l,a){if(e.tag!==5)throw Error(r(476));var n=uf(e).queue;nf(e,n,t,P,l===null?Mh:function(){return cf(e),l(a)})}function uf(e){var t=e.memoizedState;if(t!==null)return t;t={memoizedState:P,baseState:P,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:Wt,lastRenderedState:P},next:null};var l={};return t.next={memoizedState:l,baseState:l,baseQueue:null,queue:{pending:null,lanes:0,dispatch:null,lastRenderedReducer:Wt,lastRenderedState:l},next:null},e.memoizedState=t,e=e.alternate,e!==null&&(e.memoizedState=t),t}function cf(e){var t=uf(e);t.next===null&&(t=e.alternate.memoizedState),yn(e,t.next.queue,{},pt())}function Mc(){return Ke(Dn)}function sf(){return He().memoizedState}function rf(){return He().memoizedState}function Dh(e){for(var t=e.return;t!==null;){switch(t.tag){case 24:case 3:var l=pt();e=xl(l);var a=pl(t,e,l);a!==null&&(ct(a,t,l),on(a,t,l)),t={cache:ic()},e.payload=t;return}t=t.return}}function Rh(e,t,l){var a=pt();l={lane:a,revertLane:0,gesture:null,action:l,hasEagerState:!1,eagerState:null,next:null},Au(e)?ff(t,l):(l=$i(e,t,l,a),l!==null&&(ct(l,e,a),df(l,t,a)))}function of(e,t,l){var a=pt();yn(e,t,l,a)}function yn(e,t,l,a){var n={lane:a,revertLane:0,gesture:null,action:l,hasEagerState:!1,eagerState:null,next:null};if(Au(e))ff(t,n);else{var u=e.alternate;if(e.lanes===0&&(u===null||u.lanes===0)&&(u=t.lastRenderedReducer,u!==null))try{var s=t.lastRenderedState,d=u(s,l);if(n.hasEagerState=!0,n.eagerState=d,dt(d,s))return su(e,t,n,0),Ce===null&&cu(),!1}catch{}finally{}if(l=$i(e,t,n,a),l!==null)return ct(l,e,a),df(l,t,a),!0}return!1}function Dc(e,t,l,a){if(a={lane:2,revertLane:os(),gesture:null,action:a,hasEagerState:!1,eagerState:null,next:null},Au(e)){if(t)throw Error(r(479))}else t=$i(e,l,a,2),t!==null&&ct(t,e,2)}function Au(e){var t=e.alternate;return e===ne||t!==null&&t===ne}function ff(e,t){Na=Su=!0;var l=e.pending;l===null?t.next=t:(t.next=l.next,l.next=t),e.pending=t}function df(e,t,l){if((l&4194048)!==0){var a=t.lanes;a&=e.pendingLanes,l|=a,t.lanes=l,yr(e,l)}}var gn={readContext:Ke,use:Eu,useCallback:De,useContext:De,useEffect:De,useImperativeHandle:De,useLayoutEffect:De,useInsertionEffect:De,useMemo:De,useReducer:De,useRef:De,useState:De,useDebugValue:De,useDeferredValue:De,useTransition:De,useSyncExternalStore:De,useId:De,useHostTransitionStatus:De,useFormState:De,useActionState:De,useOptimistic:De,useMemoCache:De,useCacheRefresh:De};gn.useEffectEvent=De;var mf={readContext:Ke,use:Eu,useCallback:function(e,t){return et().memoizedState=[e,t===void 0?null:t],e},useContext:Ke,useEffect:$o,useImperativeHandle:function(e,t,l){l=l!=null?l.concat([e]):null,Cu(4194308,4,Po.bind(null,t,e),l)},useLayoutEffect:function(e,t){return Cu(4194308,4,e,t)},useInsertionEffect:function(e,t){Cu(4,2,e,t)},useMemo:function(e,t){var l=et();t=t===void 0?null:t;var a=e();if($l){rl(!0);try{e()}finally{rl(!1)}}return l.memoizedState=[a,t],a},useReducer:function(e,t,l){var a=et();if(l!==void 0){var n=l(t);if($l){rl(!0);try{l(t)}finally{rl(!1)}}}else n=t;return a.memoizedState=a.baseState=n,e={pending:null,lanes:0,dispatch:null,lastRenderedReducer:e,lastRenderedState:n},a.queue=e,e=e.dispatch=Rh.bind(null,ne,e),[a.memoizedState,e]},useRef:function(e){var t=et();return e={current:e},t.memoizedState=e},useState:function(e){e=Tc(e);var t=e.queue,l=of.bind(null,ne,t);return t.dispatch=l,[e.memoizedState,l]},useDebugValue:Ac,useDeferredValue:function(e,t){var l=et();return _c(l,e,t)},useTransition:function(){var e=Tc(!1);return e=nf.bind(null,ne,e.queue,!0,!1),et().memoizedState=e,[!1,e]},useSyncExternalStore:function(e,t,l){var a=ne,n=et();if(me){if(l===void 0)throw Error(r(407));l=l()}else{if(l=t(),Ce===null)throw Error(r(349));(fe&127)!==0||Ro(a,t,l)}n.memoizedState=l;var u={value:l,getSnapshot:t};return n.queue=u,$o(Uo.bind(null,a,u,e),[e]),a.flags|=2048,Ea(9,{destroy:void 0},Oo.bind(null,a,u,l,t),null),l},useId:function(){var e=et(),t=Ce.identifierPrefix;if(me){var l=Bt,a=Lt;l=(a&~(1<<32-ft(a)-1)).toString(32)+l,t="_"+t+"R_"+l,l=Nu++,0<l&&(t+="H"+l.toString(32)),t+="_"}else l=Ch++,t="_"+t+"r_"+l.toString(32)+"_";return e.memoizedState=t},useHostTransitionStatus:Mc,useFormState:Qo,useActionState:Qo,useOptimistic:function(e){var t=et();t.memoizedState=t.baseState=e;var l={pending:null,lanes:0,dispatch:null,lastRenderedReducer:null,lastRenderedState:null};return t.queue=l,t=Dc.bind(null,ne,!0,l),l.dispatch=t,[e,t]},useMemoCache:Nc,useCacheRefresh:function(){return et().memoizedState=Dh.bind(null,ne)},useEffectEvent:function(e){var t=et(),l={impl:e};return t.memoizedState=l,function(){if((ge&2)!==0)throw Error(r(440));return l.impl.apply(void 0,arguments)}}},Rc={readContext:Ke,use:Eu,useCallback:tf,useContext:Ke,useEffect:zc,useImperativeHandle:ef,useInsertionEffect:Fo,useLayoutEffect:Io,useMemo:lf,useReducer:Tu,useRef:Jo,useState:function(){return Tu(Wt)},useDebugValue:Ac,useDeferredValue:function(e,t){var l=He();return af(l,Se.memoizedState,e,t)},useTransition:function(){var e=Tu(Wt)[0],t=He().memoizedState;return[typeof e=="boolean"?e:hn(e),t]},useSyncExternalStore:Do,useId:sf,useHostTransitionStatus:Mc,useFormState:Zo,useActionState:Zo,useOptimistic:function(e,t){var l=He();return Bo(l,Se,e,t)},useMemoCache:Nc,useCacheRefresh:rf};Rc.useEffectEvent=Wo;var hf={readContext:Ke,use:Eu,useCallback:tf,useContext:Ke,useEffect:zc,useImperativeHandle:ef,useInsertionEffect:Fo,useLayoutEffect:Io,useMemo:lf,useReducer:Ec,useRef:Jo,useState:function(){return Ec(Wt)},useDebugValue:Ac,useDeferredValue:function(e,t){var l=He();return Se===null?_c(l,e,t):af(l,Se.memoizedState,e,t)},useTransition:function(){var e=Ec(Wt)[0],t=He().memoizedState;return[typeof e=="boolean"?e:hn(e),t]},useSyncExternalStore:Do,useId:sf,useHostTransitionStatus:Mc,useFormState:Ko,useActionState:Ko,useOptimistic:function(e,t){var l=He();return Se!==null?Bo(l,Se,e,t):(l.baseState=e,[e,l.queue.dispatch])},useMemoCache:Nc,useCacheRefresh:rf};hf.useEffectEvent=Wo;function Oc(e,t,l,a){t=e.memoizedState,l=l(a,t),l=l==null?t:b({},t,l),e.memoizedState=l,e.lanes===0&&(e.updateQueue.baseState=l)}var Uc={enqueueSetState:function(e,t,l){e=e._reactInternals;var a=pt(),n=xl(a);n.payload=t,l!=null&&(n.callback=l),t=pl(e,n,a),t!==null&&(ct(t,e,a),on(t,e,a))},enqueueReplaceState:function(e,t,l){e=e._reactInternals;var a=pt(),n=xl(a);n.tag=1,n.payload=t,l!=null&&(n.callback=l),t=pl(e,n,a),t!==null&&(ct(t,e,a),on(t,e,a))},enqueueForceUpdate:function(e,t){e=e._reactInternals;var l=pt(),a=xl(l);a.tag=2,t!=null&&(a.callback=t),t=pl(e,a,l),t!==null&&(ct(t,e,l),on(t,e,l))}};function yf(e,t,l,a,n,u,s){return e=e.stateNode,typeof e.shouldComponentUpdate=="function"?e.shouldComponentUpdate(a,u,s):t.prototype&&t.prototype.isPureReactComponent?!tn(l,a)||!tn(n,u):!0}function gf(e,t,l,a){e=t.state,typeof t.componentWillReceiveProps=="function"&&t.componentWillReceiveProps(l,a),typeof t.UNSAFE_componentWillReceiveProps=="function"&&t.UNSAFE_componentWillReceiveProps(l,a),t.state!==e&&Uc.enqueueReplaceState(t,t.state,null)}function Wl(e,t){var l=t;if("ref"in t){l={};for(var a in t)a!=="ref"&&(l[a]=t[a])}if(e=e.defaultProps){l===t&&(l=b({},l));for(var n in e)l[n]===void 0&&(l[n]=e[n])}return l}function xf(e){iu(e)}function pf(e){console.error(e)}function vf(e){iu(e)}function _u(e,t){try{var l=e.onUncaughtError;l(t.value,{componentStack:t.stack})}catch(a){setTimeout(function(){throw a})}}function bf(e,t,l){try{var a=e.onCaughtError;a(l.value,{componentStack:l.stack,errorBoundary:t.tag===1?t.stateNode:null})}catch(n){setTimeout(function(){throw n})}}function Hc(e,t,l){return l=xl(l),l.tag=3,l.payload={element:null},l.callback=function(){_u(e,t)},l}function Sf(e){return e=xl(e),e.tag=3,e}function Nf(e,t,l,a){var n=l.type.getDerivedStateFromError;if(typeof n=="function"){var u=a.value;e.payload=function(){return n(u)},e.callback=function(){bf(t,l,a)}}var s=l.stateNode;s!==null&&typeof s.componentDidCatch=="function"&&(e.callback=function(){bf(t,l,a),typeof n!="function"&&(El===null?El=new Set([this]):El.add(this));var d=a.stack;this.componentDidCatch(a.value,{componentStack:d!==null?d:""})})}function Oh(e,t,l,a,n){if(l.flags|=32768,a!==null&&typeof a=="object"&&typeof a.then=="function"){if(t=l.alternate,t!==null&&ga(t,l,n,!0),l=ht.current,l!==null){switch(l.tag){case 31:case 13:return _t===null?Gu():l.alternate===null&&Re===0&&(Re=3),l.flags&=-257,l.flags|=65536,l.lanes=n,a===gu?l.flags|=16384:(t=l.updateQueue,t===null?l.updateQueue=new Set([a]):t.add(a),cs(e,a,n)),!1;case 22:return l.flags|=65536,a===gu?l.flags|=16384:(t=l.updateQueue,t===null?(t={transitions:null,markerInstances:null,retryQueue:new Set([a])},l.updateQueue=t):(l=t.retryQueue,l===null?t.retryQueue=new Set([a]):l.add(a)),cs(e,a,n)),!1}throw Error(r(435,l.tag))}return cs(e,a,n),Gu(),!1}if(me)return t=ht.current,t!==null?((t.flags&65536)===0&&(t.flags|=256),t.flags|=65536,t.lanes=n,a!==tc&&(e=Error(r(422),{cause:a}),nn(Tt(e,l)))):(a!==tc&&(t=Error(r(423),{cause:a}),nn(Tt(t,l))),e=e.current.alternate,e.flags|=65536,n&=-n,e.lanes|=n,a=Tt(a,l),n=Hc(e.stateNode,a,n),dc(e,n),Re!==4&&(Re=2)),!1;var u=Error(r(520),{cause:a});if(u=Tt(u,l),En===null?En=[u]:En.push(u),Re!==4&&(Re=2),t===null)return!0;a=Tt(a,l),l=t;do{switch(l.tag){case 3:return l.flags|=65536,e=n&-n,l.lanes|=e,e=Hc(l.stateNode,a,e),dc(l,e),!1;case 1:if(t=l.type,u=l.stateNode,(l.flags&128)===0&&(typeof t.getDerivedStateFromError=="function"||u!==null&&typeof u.componentDidCatch=="function"&&(El===null||!El.has(u))))return l.flags|=65536,n&=-n,l.lanes|=n,n=Sf(n),Nf(n,e,l,a),dc(l,n),!1}l=l.return}while(l!==null);return!1}var Lc=Error(r(461)),qe=!1;function Je(e,t,l,a){t.child=e===null?To(t,null,l,a):Jl(t,e.child,l,a)}function jf(e,t,l,a,n){l=l.render;var u=t.ref;if("ref"in a){var s={};for(var d in a)d!=="ref"&&(s[d]=a[d])}else s=a;return Ql(t),a=pc(e,t,l,s,u,n),d=vc(),e!==null&&!qe?(bc(e,t,n),Ft(e,t,n)):(me&&d&&Pi(t),t.flags|=1,Je(e,t,a,n),t.child)}function Ef(e,t,l,a,n){if(e===null){var u=l.type;return typeof u=="function"&&!Wi(u)&&u.defaultProps===void 0&&l.compare===null?(t.tag=15,t.type=u,Tf(e,t,u,a,n)):(e=ou(l.type,null,a,t,t.mode,n),e.ref=t.ref,e.return=t,t.child=e)}if(u=e.child,!Zc(e,n)){var s=u.memoizedProps;if(l=l.compare,l=l!==null?l:tn,l(s,a)&&e.ref===t.ref)return Ft(e,t,n)}return t.flags|=1,e=Zt(u,a),e.ref=t.ref,e.return=t,t.child=e}function Tf(e,t,l,a,n){if(e!==null){var u=e.memoizedProps;if(tn(u,a)&&e.ref===t.ref)if(qe=!1,t.pendingProps=a=u,Zc(e,n))(e.flags&131072)!==0&&(qe=!0);else return t.lanes=e.lanes,Ft(e,t,n)}return Bc(e,t,l,a,n)}function Cf(e,t,l,a){var n=a.children,u=e!==null?e.memoizedState:null;if(e===null&&t.stateNode===null&&(t.stateNode={_visibility:1,_pendingMarkers:null,_retryCache:null,_transitions:null}),a.mode==="hidden"){if((t.flags&128)!==0){if(u=u!==null?u.baseLanes|l:l,e!==null){for(a=t.child=e.child,n=0;a!==null;)n=n|a.lanes|a.childLanes,a=a.sibling;a=n&~u}else a=0,t.child=null;return zf(e,t,u,l,a)}if((l&536870912)!==0)t.memoizedState={baseLanes:0,cachePool:null},e!==null&&hu(t,u!==null?u.cachePool:null),u!==null?Ao(t,u):hc(),_o(t);else return a=t.lanes=536870912,zf(e,t,u!==null?u.baseLanes|l:l,l,a)}else u!==null?(hu(t,u.cachePool),Ao(t,u),bl(),t.memoizedState=null):(e!==null&&hu(t,null),hc(),bl());return Je(e,t,n,l),t.child}function xn(e,t){return e!==null&&e.tag===22||t.stateNode!==null||(t.stateNode={_visibility:1,_pendingMarkers:null,_retryCache:null,_transitions:null}),t.sibling}function zf(e,t,l,a,n){var u=sc();return u=u===null?null:{parent:Le._currentValue,pool:u},t.memoizedState={baseLanes:l,cachePool:u},e!==null&&hu(t,null),hc(),_o(t),e!==null&&ga(e,t,a,!0),t.childLanes=n,null}function wu(e,t){return t=Du({mode:t.mode,children:t.children},e.mode),t.ref=e.ref,e.child=t,t.return=e,t}function Af(e,t,l){return Jl(t,e.child,null,l),e=wu(t,t.pendingProps),e.flags|=2,yt(t),t.memoizedState=null,e}function Uh(e,t,l){var a=t.pendingProps,n=(t.flags&128)!==0;if(t.flags&=-129,e===null){if(me){if(a.mode==="hidden")return e=wu(t,a),t.lanes=536870912,xn(null,e);if(gc(t),(e=ze)?(e=Yd(e,At),e=e!==null&&e.data==="&"?e:null,e!==null&&(t.memoizedState={dehydrated:e,treeContext:dl!==null?{id:Lt,overflow:Bt}:null,retryLane:536870912,hydrationErrors:null},l=ro(e),l.return=t,t.child=l,Ve=t,ze=null)):e=null,e===null)throw hl(t);return t.lanes=536870912,null}return wu(t,a)}var u=e.memoizedState;if(u!==null){var s=u.dehydrated;if(gc(t),n)if(t.flags&256)t.flags&=-257,t=Af(e,t,l);else if(t.memoizedState!==null)t.child=e.child,t.flags|=128,t=null;else throw Error(r(558));else if(qe||ga(e,t,l,!1),n=(l&e.childLanes)!==0,qe||n){if(a=Ce,a!==null&&(s=gr(a,l),s!==0&&s!==u.retryLane))throw u.retryLane=s,Yl(e,s),ct(a,e,s),Lc;Gu(),t=Af(e,t,l)}else e=u.treeContext,ze=wt(s.nextSibling),Ve=t,me=!0,ml=null,At=!1,e!==null&&mo(t,e),t=wu(t,a),t.flags|=4096;return t}return e=Zt(e.child,{mode:a.mode,children:a.children}),e.ref=t.ref,t.child=e,e.return=t,e}function Mu(e,t){var l=t.ref;if(l===null)e!==null&&e.ref!==null&&(t.flags|=4194816);else{if(typeof l!="function"&&typeof l!="object")throw Error(r(284));(e===null||e.ref!==l)&&(t.flags|=4194816)}}function Bc(e,t,l,a,n){return Ql(t),l=pc(e,t,l,a,void 0,n),a=vc(),e!==null&&!qe?(bc(e,t,n),Ft(e,t,n)):(me&&a&&Pi(t),t.flags|=1,Je(e,t,l,n),t.child)}function _f(e,t,l,a,n,u){return Ql(t),t.updateQueue=null,l=Mo(t,a,l,n),wo(e),a=vc(),e!==null&&!qe?(bc(e,t,u),Ft(e,t,u)):(me&&a&&Pi(t),t.flags|=1,Je(e,t,l,u),t.child)}function wf(e,t,l,a,n){if(Ql(t),t.stateNode===null){var u=da,s=l.contextType;typeof s=="object"&&s!==null&&(u=Ke(s)),u=new l(a,u),t.memoizedState=u.state!==null&&u.state!==void 0?u.state:null,u.updater=Uc,t.stateNode=u,u._reactInternals=t,u=t.stateNode,u.props=a,u.state=t.memoizedState,u.refs={},oc(t),s=l.contextType,u.context=typeof s=="object"&&s!==null?Ke(s):da,u.state=t.memoizedState,s=l.getDerivedStateFromProps,typeof s=="function"&&(Oc(t,l,s,a),u.state=t.memoizedState),typeof l.getDerivedStateFromProps=="function"||typeof u.getSnapshotBeforeUpdate=="function"||typeof u.UNSAFE_componentWillMount!="function"&&typeof u.componentWillMount!="function"||(s=u.state,typeof u.componentWillMount=="function"&&u.componentWillMount(),typeof u.UNSAFE_componentWillMount=="function"&&u.UNSAFE_componentWillMount(),s!==u.state&&Uc.enqueueReplaceState(u,u.state,null),dn(t,a,u,n),fn(),u.state=t.memoizedState),typeof u.componentDidMount=="function"&&(t.flags|=4194308),a=!0}else if(e===null){u=t.stateNode;var d=t.memoizedProps,g=Wl(l,d);u.props=g;var C=u.context,M=l.contextType;s=da,typeof M=="object"&&M!==null&&(s=Ke(M));var R=l.getDerivedStateFromProps;M=typeof R=="function"||typeof u.getSnapshotBeforeUpdate=="function",d=t.pendingProps!==d,M||typeof u.UNSAFE_componentWillReceiveProps!="function"&&typeof u.componentWillReceiveProps!="function"||(d||C!==s)&&gf(t,u,a,s),gl=!1;var z=t.memoizedState;u.state=z,dn(t,a,u,n),fn(),C=t.memoizedState,d||z!==C||gl?(typeof R=="function"&&(Oc(t,l,R,a),C=t.memoizedState),(g=gl||yf(t,l,g,a,z,C,s))?(M||typeof u.UNSAFE_componentWillMount!="function"&&typeof u.componentWillMount!="function"||(typeof u.componentWillMount=="function"&&u.componentWillMount(),typeof u.UNSAFE_componentWillMount=="function"&&u.UNSAFE_componentWillMount()),typeof u.componentDidMount=="function"&&(t.flags|=4194308)):(typeof u.componentDidMount=="function"&&(t.flags|=4194308),t.memoizedProps=a,t.memoizedState=C),u.props=a,u.state=C,u.context=s,a=g):(typeof u.componentDidMount=="function"&&(t.flags|=4194308),a=!1)}else{u=t.stateNode,fc(e,t),s=t.memoizedProps,M=Wl(l,s),u.props=M,R=t.pendingProps,z=u.context,C=l.contextType,g=da,typeof C=="object"&&C!==null&&(g=Ke(C)),d=l.getDerivedStateFromProps,(C=typeof d=="function"||typeof u.getSnapshotBeforeUpdate=="function")||typeof u.UNSAFE_componentWillReceiveProps!="function"&&typeof u.componentWillReceiveProps!="function"||(s!==R||z!==g)&&gf(t,u,a,g),gl=!1,z=t.memoizedState,u.state=z,dn(t,a,u,n),fn();var _=t.memoizedState;s!==R||z!==_||gl||e!==null&&e.dependencies!==null&&du(e.dependencies)?(typeof d=="function"&&(Oc(t,l,d,a),_=t.memoizedState),(M=gl||yf(t,l,M,a,z,_,g)||e!==null&&e.dependencies!==null&&du(e.dependencies))?(C||typeof u.UNSAFE_componentWillUpdate!="function"&&typeof u.componentWillUpdate!="function"||(typeof u.componentWillUpdate=="function"&&u.componentWillUpdate(a,_,g),typeof u.UNSAFE_componentWillUpdate=="function"&&u.UNSAFE_componentWillUpdate(a,_,g)),typeof u.componentDidUpdate=="function"&&(t.flags|=4),typeof u.getSnapshotBeforeUpdate=="function"&&(t.flags|=1024)):(typeof u.componentDidUpdate!="function"||s===e.memoizedProps&&z===e.memoizedState||(t.flags|=4),typeof u.getSnapshotBeforeUpdate!="function"||s===e.memoizedProps&&z===e.memoizedState||(t.flags|=1024),t.memoizedProps=a,t.memoizedState=_),u.props=a,u.state=_,u.context=g,a=M):(typeof u.componentDidUpdate!="function"||s===e.memoizedProps&&z===e.memoizedState||(t.flags|=4),typeof u.getSnapshotBeforeUpdate!="function"||s===e.memoizedProps&&z===e.memoizedState||(t.flags|=1024),a=!1)}return u=a,Mu(e,t),a=(t.flags&128)!==0,u||a?(u=t.stateNode,l=a&&typeof l.getDerivedStateFromError!="function"?null:u.render(),t.flags|=1,e!==null&&a?(t.child=Jl(t,e.child,null,n),t.child=Jl(t,null,l,n)):Je(e,t,l,n),t.memoizedState=u.state,e=t.child):e=Ft(e,t,n),e}function Mf(e,t,l,a){return kl(),t.flags|=256,Je(e,t,l,a),t.child}var qc={dehydrated:null,treeContext:null,retryLane:0,hydrationErrors:null};function Yc(e){return{baseLanes:e,cachePool:vo()}}function Gc(e,t,l){return e=e!==null?e.childLanes&~l:0,t&&(e|=xt),e}function Df(e,t,l){var a=t.pendingProps,n=!1,u=(t.flags&128)!==0,s;if((s=u)||(s=e!==null&&e.memoizedState===null?!1:(Ue.current&2)!==0),s&&(n=!0,t.flags&=-129),s=(t.flags&32)!==0,t.flags&=-33,e===null){if(me){if(n?vl(t):bl(),(e=ze)?(e=Yd(e,At),e=e!==null&&e.data!=="&"?e:null,e!==null&&(t.memoizedState={dehydrated:e,treeContext:dl!==null?{id:Lt,overflow:Bt}:null,retryLane:536870912,hydrationErrors:null},l=ro(e),l.return=t,t.child=l,Ve=t,ze=null)):e=null,e===null)throw hl(t);return js(e)?t.lanes=32:t.lanes=536870912,null}var d=a.children;return a=a.fallback,n?(bl(),n=t.mode,d=Du({mode:"hidden",children:d},n),a=Gl(a,n,l,null),d.return=t,a.return=t,d.sibling=a,t.child=d,a=t.child,a.memoizedState=Yc(l),a.childLanes=Gc(e,s,l),t.memoizedState=qc,xn(null,a)):(vl(t),kc(t,d))}var g=e.memoizedState;if(g!==null&&(d=g.dehydrated,d!==null)){if(u)t.flags&256?(vl(t),t.flags&=-257,t=Xc(e,t,l)):t.memoizedState!==null?(bl(),t.child=e.child,t.flags|=128,t=null):(bl(),d=a.fallback,n=t.mode,a=Du({mode:"visible",children:a.children},n),d=Gl(d,n,l,null),d.flags|=2,a.return=t,d.return=t,a.sibling=d,t.child=a,Jl(t,e.child,null,l),a=t.child,a.memoizedState=Yc(l),a.childLanes=Gc(e,s,l),t.memoizedState=qc,t=xn(null,a));else if(vl(t),js(d)){if(s=d.nextSibling&&d.nextSibling.dataset,s)var C=s.dgst;s=C,a=Error(r(419)),a.stack="",a.digest=s,nn({value:a,source:null,stack:null}),t=Xc(e,t,l)}else if(qe||ga(e,t,l,!1),s=(l&e.childLanes)!==0,qe||s){if(s=Ce,s!==null&&(a=gr(s,l),a!==0&&a!==g.retryLane))throw g.retryLane=a,Yl(e,a),ct(s,e,a),Lc;Ns(d)||Gu(),t=Xc(e,t,l)}else Ns(d)?(t.flags|=192,t.child=e.child,t=null):(e=g.treeContext,ze=wt(d.nextSibling),Ve=t,me=!0,ml=null,At=!1,e!==null&&mo(t,e),t=kc(t,a.children),t.flags|=4096);return t}return n?(bl(),d=a.fallback,n=t.mode,g=e.child,C=g.sibling,a=Zt(g,{mode:"hidden",children:a.children}),a.subtreeFlags=g.subtreeFlags&65011712,C!==null?d=Zt(C,d):(d=Gl(d,n,l,null),d.flags|=2),d.return=t,a.return=t,a.sibling=d,t.child=a,xn(null,a),a=t.child,d=e.child.memoizedState,d===null?d=Yc(l):(n=d.cachePool,n!==null?(g=Le._currentValue,n=n.parent!==g?{parent:g,pool:g}:n):n=vo(),d={baseLanes:d.baseLanes|l,cachePool:n}),a.memoizedState=d,a.childLanes=Gc(e,s,l),t.memoizedState=qc,xn(e.child,a)):(vl(t),l=e.child,e=l.sibling,l=Zt(l,{mode:"visible",children:a.children}),l.return=t,l.sibling=null,e!==null&&(s=t.deletions,s===null?(t.deletions=[e],t.flags|=16):s.push(e)),t.child=l,t.memoizedState=null,l)}function kc(e,t){return t=Du({mode:"visible",children:t},e.mode),t.return=e,e.child=t}function Du(e,t){return e=mt(22,e,null,t),e.lanes=0,e}function Xc(e,t,l){return Jl(t,e.child,null,l),e=kc(t,t.pendingProps.children),e.flags|=2,t.memoizedState=null,e}function Rf(e,t,l){e.lanes|=t;var a=e.alternate;a!==null&&(a.lanes|=t),nc(e.return,t,l)}function Qc(e,t,l,a,n,u){var s=e.memoizedState;s===null?e.memoizedState={isBackwards:t,rendering:null,renderingStartTime:0,last:a,tail:l,tailMode:n,treeForkCount:u}:(s.isBackwards=t,s.rendering=null,s.renderingStartTime=0,s.last=a,s.tail=l,s.tailMode=n,s.treeForkCount=u)}function Of(e,t,l){var a=t.pendingProps,n=a.revealOrder,u=a.tail;a=a.children;var s=Ue.current,d=(s&2)!==0;if(d?(s=s&1|2,t.flags|=128):s&=1,X(Ue,s),Je(e,t,a,l),a=me?an:0,!d&&e!==null&&(e.flags&128)!==0)e:for(e=t.child;e!==null;){if(e.tag===13)e.memoizedState!==null&&Rf(e,l,t);else if(e.tag===19)Rf(e,l,t);else if(e.child!==null){e.child.return=e,e=e.child;continue}if(e===t)break e;for(;e.sibling===null;){if(e.return===null||e.return===t)break e;e=e.return}e.sibling.return=e.return,e=e.sibling}switch(n){case"forwards":for(l=t.child,n=null;l!==null;)e=l.alternate,e!==null&&bu(e)===null&&(n=l),l=l.sibling;l=n,l===null?(n=t.child,t.child=null):(n=l.sibling,l.sibling=null),Qc(t,!1,n,l,u,a);break;case"backwards":case"unstable_legacy-backwards":for(l=null,n=t.child,t.child=null;n!==null;){if(e=n.alternate,e!==null&&bu(e)===null){t.child=n;break}e=n.sibling,n.sibling=l,l=n,n=e}Qc(t,!0,l,null,u,a);break;case"together":Qc(t,!1,null,null,void 0,a);break;default:t.memoizedState=null}return t.child}function Ft(e,t,l){if(e!==null&&(t.dependencies=e.dependencies),jl|=t.lanes,(l&t.childLanes)===0)if(e!==null){if(ga(e,t,l,!1),(l&t.childLanes)===0)return null}else return null;if(e!==null&&t.child!==e.child)throw Error(r(153));if(t.child!==null){for(e=t.child,l=Zt(e,e.pendingProps),t.child=l,l.return=t;e.sibling!==null;)e=e.sibling,l=l.sibling=Zt(e,e.pendingProps),l.return=t;l.sibling=null}return t.child}function Zc(e,t){return(e.lanes&t)!==0?!0:(e=e.dependencies,!!(e!==null&&du(e)))}function Hh(e,t,l){switch(t.tag){case 3:Pe(t,t.stateNode.containerInfo),yl(t,Le,e.memoizedState.cache),kl();break;case 27:case 5:ka(t);break;case 4:Pe(t,t.stateNode.containerInfo);break;case 10:yl(t,t.type,t.memoizedProps.value);break;case 31:if(t.memoizedState!==null)return t.flags|=128,gc(t),null;break;case 13:var a=t.memoizedState;if(a!==null)return a.dehydrated!==null?(vl(t),t.flags|=128,null):(l&t.child.childLanes)!==0?Df(e,t,l):(vl(t),e=Ft(e,t,l),e!==null?e.sibling:null);vl(t);break;case 19:var n=(e.flags&128)!==0;if(a=(l&t.childLanes)!==0,a||(ga(e,t,l,!1),a=(l&t.childLanes)!==0),n){if(a)return Of(e,t,l);t.flags|=128}if(n=t.memoizedState,n!==null&&(n.rendering=null,n.tail=null,n.lastEffect=null),X(Ue,Ue.current),a)break;return null;case 22:return t.lanes=0,Cf(e,t,l,t.pendingProps);case 24:yl(t,Le,e.memoizedState.cache)}return Ft(e,t,l)}function Uf(e,t,l){if(e!==null)if(e.memoizedProps!==t.pendingProps)qe=!0;else{if(!Zc(e,l)&&(t.flags&128)===0)return qe=!1,Hh(e,t,l);qe=(e.flags&131072)!==0}else qe=!1,me&&(t.flags&1048576)!==0&&fo(t,an,t.index);switch(t.lanes=0,t.tag){case 16:e:{var a=t.pendingProps;if(e=Vl(t.elementType),t.type=e,typeof e=="function")Wi(e)?(a=Wl(e,a),t.tag=1,t=wf(null,t,e,a,l)):(t.tag=0,t=Bc(null,t,e,a,l));else{if(e!=null){var n=e.$$typeof;if(n===ee){t.tag=11,t=jf(null,t,e,a,l);break e}else if(n===W){t.tag=14,t=Ef(null,t,e,a,l);break e}}throw t=te(e)||e,Error(r(306,t,""))}}return t;case 0:return Bc(e,t,t.type,t.pendingProps,l);case 1:return a=t.type,n=Wl(a,t.pendingProps),wf(e,t,a,n,l);case 3:e:{if(Pe(t,t.stateNode.containerInfo),e===null)throw Error(r(387));a=t.pendingProps;var u=t.memoizedState;n=u.element,fc(e,t),dn(t,a,null,l);var s=t.memoizedState;if(a=s.cache,yl(t,Le,a),a!==u.cache&&uc(t,[Le],l,!0),fn(),a=s.element,u.isDehydrated)if(u={element:a,isDehydrated:!1,cache:s.cache},t.updateQueue.baseState=u,t.memoizedState=u,t.flags&256){t=Mf(e,t,a,l);break e}else if(a!==n){n=Tt(Error(r(424)),t),nn(n),t=Mf(e,t,a,l);break e}else{switch(e=t.stateNode.containerInfo,e.nodeType){case 9:e=e.body;break;default:e=e.nodeName==="HTML"?e.ownerDocument.body:e}for(ze=wt(e.firstChild),Ve=t,me=!0,ml=null,At=!0,l=To(t,null,a,l),t.child=l;l;)l.flags=l.flags&-3|4096,l=l.sibling}else{if(kl(),a===n){t=Ft(e,t,l);break e}Je(e,t,a,l)}t=t.child}return t;case 26:return Mu(e,t),e===null?(l=Vd(t.type,null,t.pendingProps,null))?t.memoizedState=l:me||(l=t.type,e=t.pendingProps,a=Ju(ce.current).createElement(l),a[Ze]=t,a[tt]=e,$e(a,l,e),Xe(a),t.stateNode=a):t.memoizedState=Vd(t.type,e.memoizedProps,t.pendingProps,e.memoizedState),null;case 27:return ka(t),e===null&&me&&(a=t.stateNode=Xd(t.type,t.pendingProps,ce.current),Ve=t,At=!0,n=ze,Al(t.type)?(Es=n,ze=wt(a.firstChild)):ze=n),Je(e,t,t.pendingProps.children,l),Mu(e,t),e===null&&(t.flags|=4194304),t.child;case 5:return e===null&&me&&((n=a=ze)&&(a=dy(a,t.type,t.pendingProps,At),a!==null?(t.stateNode=a,Ve=t,ze=wt(a.firstChild),At=!1,n=!0):n=!1),n||hl(t)),ka(t),n=t.type,u=t.pendingProps,s=e!==null?e.memoizedProps:null,a=u.children,vs(n,u)?a=null:s!==null&&vs(n,s)&&(t.flags|=32),t.memoizedState!==null&&(n=pc(e,t,zh,null,null,l),Dn._currentValue=n),Mu(e,t),Je(e,t,a,l),t.child;case 6:return e===null&&me&&((e=l=ze)&&(l=my(l,t.pendingProps,At),l!==null?(t.stateNode=l,Ve=t,ze=null,e=!0):e=!1),e||hl(t)),null;case 13:return Df(e,t,l);case 4:return Pe(t,t.stateNode.containerInfo),a=t.pendingProps,e===null?t.child=Jl(t,null,a,l):Je(e,t,a,l),t.child;case 11:return jf(e,t,t.type,t.pendingProps,l);case 7:return Je(e,t,t.pendingProps,l),t.child;case 8:return Je(e,t,t.pendingProps.children,l),t.child;case 12:return Je(e,t,t.pendingProps.children,l),t.child;case 10:return a=t.pendingProps,yl(t,t.type,a.value),Je(e,t,a.children,l),t.child;case 9:return n=t.type._context,a=t.pendingProps.children,Ql(t),n=Ke(n),a=a(n),t.flags|=1,Je(e,t,a,l),t.child;case 14:return Ef(e,t,t.type,t.pendingProps,l);case 15:return Tf(e,t,t.type,t.pendingProps,l);case 19:return Of(e,t,l);case 31:return Uh(e,t,l);case 22:return Cf(e,t,l,t.pendingProps);case 24:return Ql(t),a=Ke(Le),e===null?(n=sc(),n===null&&(n=Ce,u=ic(),n.pooledCache=u,u.refCount++,u!==null&&(n.pooledCacheLanes|=l),n=u),t.memoizedState={parent:a,cache:n},oc(t),yl(t,Le,n)):((e.lanes&l)!==0&&(fc(e,t),dn(t,null,null,l),fn()),n=e.memoizedState,u=t.memoizedState,n.parent!==a?(n={parent:a,cache:a},t.memoizedState=n,t.lanes===0&&(t.memoizedState=t.updateQueue.baseState=n),yl(t,Le,a)):(a=u.cache,yl(t,Le,a),a!==n.cache&&uc(t,[Le],l,!0))),Je(e,t,t.pendingProps.children,l),t.child;case 29:throw t.pendingProps}throw Error(r(156,t.tag))}function It(e){e.flags|=4}function Vc(e,t,l,a,n){if((t=(e.mode&32)!==0)&&(t=!1),t){if(e.flags|=16777216,(n&335544128)===n)if(e.stateNode.complete)e.flags|=8192;else if(sd())e.flags|=8192;else throw Kl=gu,rc}else e.flags&=-16777217}function Hf(e,t){if(t.type!=="stylesheet"||(t.state.loading&4)!==0)e.flags&=-16777217;else if(e.flags|=16777216,!Fd(t))if(sd())e.flags|=8192;else throw Kl=gu,rc}function Ru(e,t){t!==null&&(e.flags|=4),e.flags&16384&&(t=e.tag!==22?mr():536870912,e.lanes|=t,Aa|=t)}function pn(e,t){if(!me)switch(e.tailMode){case"hidden":t=e.tail;for(var l=null;t!==null;)t.alternate!==null&&(l=t),t=t.sibling;l===null?e.tail=null:l.sibling=null;break;case"collapsed":l=e.tail;for(var a=null;l!==null;)l.alternate!==null&&(a=l),l=l.sibling;a===null?t||e.tail===null?e.tail=null:e.tail.sibling=null:a.sibling=null}}function Ae(e){var t=e.alternate!==null&&e.alternate.child===e.child,l=0,a=0;if(t)for(var n=e.child;n!==null;)l|=n.lanes|n.childLanes,a|=n.subtreeFlags&65011712,a|=n.flags&65011712,n.return=e,n=n.sibling;else for(n=e.child;n!==null;)l|=n.lanes|n.childLanes,a|=n.subtreeFlags,a|=n.flags,n.return=e,n=n.sibling;return e.subtreeFlags|=a,e.childLanes=l,t}function Lh(e,t,l){var a=t.pendingProps;switch(ec(t),t.tag){case 16:case 15:case 0:case 11:case 7:case 8:case 12:case 9:case 14:return Ae(t),null;case 1:return Ae(t),null;case 3:return l=t.stateNode,a=null,e!==null&&(a=e.memoizedState.cache),t.memoizedState.cache!==a&&(t.flags|=2048),Jt(Le),Oe(),l.pendingContext&&(l.context=l.pendingContext,l.pendingContext=null),(e===null||e.child===null)&&(ya(t)?It(t):e===null||e.memoizedState.isDehydrated&&(t.flags&256)===0||(t.flags|=1024,lc())),Ae(t),null;case 26:var n=t.type,u=t.memoizedState;return e===null?(It(t),u!==null?(Ae(t),Hf(t,u)):(Ae(t),Vc(t,n,null,a,l))):u?u!==e.memoizedState?(It(t),Ae(t),Hf(t,u)):(Ae(t),t.flags&=-16777217):(e=e.memoizedProps,e!==a&&It(t),Ae(t),Vc(t,n,e,a,l)),null;case 27:if(Qn(t),l=ce.current,n=t.type,e!==null&&t.stateNode!=null)e.memoizedProps!==a&&It(t);else{if(!a){if(t.stateNode===null)throw Error(r(166));return Ae(t),null}e=V.current,ya(t)?ho(t):(e=Xd(n,a,l),t.stateNode=e,It(t))}return Ae(t),null;case 5:if(Qn(t),n=t.type,e!==null&&t.stateNode!=null)e.memoizedProps!==a&&It(t);else{if(!a){if(t.stateNode===null)throw Error(r(166));return Ae(t),null}if(u=V.current,ya(t))ho(t);else{var s=Ju(ce.current);switch(u){case 1:u=s.createElementNS("http://www.w3.org/2000/svg",n);break;case 2:u=s.createElementNS("http://www.w3.org/1998/Math/MathML",n);break;default:switch(n){case"svg":u=s.createElementNS("http://www.w3.org/2000/svg",n);break;case"math":u=s.createElementNS("http://www.w3.org/1998/Math/MathML",n);break;case"script":u=s.createElement("div"),u.innerHTML="<script><\/script>",u=u.removeChild(u.firstChild);break;case"select":u=typeof a.is=="string"?s.createElement("select",{is:a.is}):s.createElement("select"),a.multiple?u.multiple=!0:a.size&&(u.size=a.size);break;default:u=typeof a.is=="string"?s.createElement(n,{is:a.is}):s.createElement(n)}}u[Ze]=t,u[tt]=a;e:for(s=t.child;s!==null;){if(s.tag===5||s.tag===6)u.appendChild(s.stateNode);else if(s.tag!==4&&s.tag!==27&&s.child!==null){s.child.return=s,s=s.child;continue}if(s===t)break e;for(;s.sibling===null;){if(s.return===null||s.return===t)break e;s=s.return}s.sibling.return=s.return,s=s.sibling}t.stateNode=u;e:switch($e(u,n,a),n){case"button":case"input":case"select":case"textarea":a=!!a.autoFocus;break e;case"img":a=!0;break e;default:a=!1}a&&It(t)}}return Ae(t),Vc(t,t.type,e===null?null:e.memoizedProps,t.pendingProps,l),null;case 6:if(e&&t.stateNode!=null)e.memoizedProps!==a&&It(t);else{if(typeof a!="string"&&t.stateNode===null)throw Error(r(166));if(e=ce.current,ya(t)){if(e=t.stateNode,l=t.memoizedProps,a=null,n=Ve,n!==null)switch(n.tag){case 27:case 5:a=n.memoizedProps}e[Ze]=t,e=!!(e.nodeValue===l||a!==null&&a.suppressHydrationWarning===!0||Dd(e.nodeValue,l)),e||hl(t,!0)}else e=Ju(e).createTextNode(a),e[Ze]=t,t.stateNode=e}return Ae(t),null;case 31:if(l=t.memoizedState,e===null||e.memoizedState!==null){if(a=ya(t),l!==null){if(e===null){if(!a)throw Error(r(318));if(e=t.memoizedState,e=e!==null?e.dehydrated:null,!e)throw Error(r(557));e[Ze]=t}else kl(),(t.flags&128)===0&&(t.memoizedState=null),t.flags|=4;Ae(t),e=!1}else l=lc(),e!==null&&e.memoizedState!==null&&(e.memoizedState.hydrationErrors=l),e=!0;if(!e)return t.flags&256?(yt(t),t):(yt(t),null);if((t.flags&128)!==0)throw Error(r(558))}return Ae(t),null;case 13:if(a=t.memoizedState,e===null||e.memoizedState!==null&&e.memoizedState.dehydrated!==null){if(n=ya(t),a!==null&&a.dehydrated!==null){if(e===null){if(!n)throw Error(r(318));if(n=t.memoizedState,n=n!==null?n.dehydrated:null,!n)throw Error(r(317));n[Ze]=t}else kl(),(t.flags&128)===0&&(t.memoizedState=null),t.flags|=4;Ae(t),n=!1}else n=lc(),e!==null&&e.memoizedState!==null&&(e.memoizedState.hydrationErrors=n),n=!0;if(!n)return t.flags&256?(yt(t),t):(yt(t),null)}return yt(t),(t.flags&128)!==0?(t.lanes=l,t):(l=a!==null,e=e!==null&&e.memoizedState!==null,l&&(a=t.child,n=null,a.alternate!==null&&a.alternate.memoizedState!==null&&a.alternate.memoizedState.cachePool!==null&&(n=a.alternate.memoizedState.cachePool.pool),u=null,a.memoizedState!==null&&a.memoizedState.cachePool!==null&&(u=a.memoizedState.cachePool.pool),u!==n&&(a.flags|=2048)),l!==e&&l&&(t.child.flags|=8192),Ru(t,t.updateQueue),Ae(t),null);case 4:return Oe(),e===null&&hs(t.stateNode.containerInfo),Ae(t),null;case 10:return Jt(t.type),Ae(t),null;case 19:if(O(Ue),a=t.memoizedState,a===null)return Ae(t),null;if(n=(t.flags&128)!==0,u=a.rendering,u===null)if(n)pn(a,!1);else{if(Re!==0||e!==null&&(e.flags&128)!==0)for(e=t.child;e!==null;){if(u=bu(e),u!==null){for(t.flags|=128,pn(a,!1),e=u.updateQueue,t.updateQueue=e,Ru(t,e),t.subtreeFlags=0,e=l,l=t.child;l!==null;)so(l,e),l=l.sibling;return X(Ue,Ue.current&1|2),me&&Vt(t,a.treeForkCount),t.child}e=e.sibling}a.tail!==null&&rt()>Bu&&(t.flags|=128,n=!0,pn(a,!1),t.lanes=4194304)}else{if(!n)if(e=bu(u),e!==null){if(t.flags|=128,n=!0,e=e.updateQueue,t.updateQueue=e,Ru(t,e),pn(a,!0),a.tail===null&&a.tailMode==="hidden"&&!u.alternate&&!me)return Ae(t),null}else 2*rt()-a.renderingStartTime>Bu&&l!==536870912&&(t.flags|=128,n=!0,pn(a,!1),t.lanes=4194304);a.isBackwards?(u.sibling=t.child,t.child=u):(e=a.last,e!==null?e.sibling=u:t.child=u,a.last=u)}return a.tail!==null?(e=a.tail,a.rendering=e,a.tail=e.sibling,a.renderingStartTime=rt(),e.sibling=null,l=Ue.current,X(Ue,n?l&1|2:l&1),me&&Vt(t,a.treeForkCount),e):(Ae(t),null);case 22:case 23:return yt(t),yc(),a=t.memoizedState!==null,e!==null?e.memoizedState!==null!==a&&(t.flags|=8192):a&&(t.flags|=8192),a?(l&536870912)!==0&&(t.flags&128)===0&&(Ae(t),t.subtreeFlags&6&&(t.flags|=8192)):Ae(t),l=t.updateQueue,l!==null&&Ru(t,l.retryQueue),l=null,e!==null&&e.memoizedState!==null&&e.memoizedState.cachePool!==null&&(l=e.memoizedState.cachePool.pool),a=null,t.memoizedState!==null&&t.memoizedState.cachePool!==null&&(a=t.memoizedState.cachePool.pool),a!==l&&(t.flags|=2048),e!==null&&O(Zl),null;case 24:return l=null,e!==null&&(l=e.memoizedState.cache),t.memoizedState.cache!==l&&(t.flags|=2048),Jt(Le),Ae(t),null;case 25:return null;case 30:return null}throw Error(r(156,t.tag))}function Bh(e,t){switch(ec(t),t.tag){case 1:return e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 3:return Jt(Le),Oe(),e=t.flags,(e&65536)!==0&&(e&128)===0?(t.flags=e&-65537|128,t):null;case 26:case 27:case 5:return Qn(t),null;case 31:if(t.memoizedState!==null){if(yt(t),t.alternate===null)throw Error(r(340));kl()}return e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 13:if(yt(t),e=t.memoizedState,e!==null&&e.dehydrated!==null){if(t.alternate===null)throw Error(r(340));kl()}return e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 19:return O(Ue),null;case 4:return Oe(),null;case 10:return Jt(t.type),null;case 22:case 23:return yt(t),yc(),e!==null&&O(Zl),e=t.flags,e&65536?(t.flags=e&-65537|128,t):null;case 24:return Jt(Le),null;case 25:return null;default:return null}}function Lf(e,t){switch(ec(t),t.tag){case 3:Jt(Le),Oe();break;case 26:case 27:case 5:Qn(t);break;case 4:Oe();break;case 31:t.memoizedState!==null&&yt(t);break;case 13:yt(t);break;case 19:O(Ue);break;case 10:Jt(t.type);break;case 22:case 23:yt(t),yc(),e!==null&&O(Zl);break;case 24:Jt(Le)}}function vn(e,t){try{var l=t.updateQueue,a=l!==null?l.lastEffect:null;if(a!==null){var n=a.next;l=n;do{if((l.tag&e)===e){a=void 0;var u=l.create,s=l.inst;a=u(),s.destroy=a}l=l.next}while(l!==n)}}catch(d){ve(t,t.return,d)}}function Sl(e,t,l){try{var a=t.updateQueue,n=a!==null?a.lastEffect:null;if(n!==null){var u=n.next;a=u;do{if((a.tag&e)===e){var s=a.inst,d=s.destroy;if(d!==void 0){s.destroy=void 0,n=t;var g=l,C=d;try{C()}catch(M){ve(n,g,M)}}}a=a.next}while(a!==u)}}catch(M){ve(t,t.return,M)}}function Bf(e){var t=e.updateQueue;if(t!==null){var l=e.stateNode;try{zo(t,l)}catch(a){ve(e,e.return,a)}}}function qf(e,t,l){l.props=Wl(e.type,e.memoizedProps),l.state=e.memoizedState;try{l.componentWillUnmount()}catch(a){ve(e,t,a)}}function bn(e,t){try{var l=e.ref;if(l!==null){switch(e.tag){case 26:case 27:case 5:var a=e.stateNode;break;case 30:a=e.stateNode;break;default:a=e.stateNode}typeof l=="function"?e.refCleanup=l(a):l.current=a}}catch(n){ve(e,t,n)}}function qt(e,t){var l=e.ref,a=e.refCleanup;if(l!==null)if(typeof a=="function")try{a()}catch(n){ve(e,t,n)}finally{e.refCleanup=null,e=e.alternate,e!=null&&(e.refCleanup=null)}else if(typeof l=="function")try{l(null)}catch(n){ve(e,t,n)}else l.current=null}function Yf(e){var t=e.type,l=e.memoizedProps,a=e.stateNode;try{e:switch(t){case"button":case"input":case"select":case"textarea":l.autoFocus&&a.focus();break e;case"img":l.src?a.src=l.src:l.srcSet&&(a.srcset=l.srcSet)}}catch(n){ve(e,e.return,n)}}function Kc(e,t,l){try{var a=e.stateNode;iy(a,e.type,l,t),a[tt]=t}catch(n){ve(e,e.return,n)}}function Gf(e){return e.tag===5||e.tag===3||e.tag===26||e.tag===27&&Al(e.type)||e.tag===4}function Jc(e){e:for(;;){for(;e.sibling===null;){if(e.return===null||Gf(e.return))return null;e=e.return}for(e.sibling.return=e.return,e=e.sibling;e.tag!==5&&e.tag!==6&&e.tag!==18;){if(e.tag===27&&Al(e.type)||e.flags&2||e.child===null||e.tag===4)continue e;e.child.return=e,e=e.child}if(!(e.flags&2))return e.stateNode}}function $c(e,t,l){var a=e.tag;if(a===5||a===6)e=e.stateNode,t?(l.nodeType===9?l.body:l.nodeName==="HTML"?l.ownerDocument.body:l).insertBefore(e,t):(t=l.nodeType===9?l.body:l.nodeName==="HTML"?l.ownerDocument.body:l,t.appendChild(e),l=l._reactRootContainer,l!=null||t.onclick!==null||(t.onclick=Xt));else if(a!==4&&(a===27&&Al(e.type)&&(l=e.stateNode,t=null),e=e.child,e!==null))for($c(e,t,l),e=e.sibling;e!==null;)$c(e,t,l),e=e.sibling}function Ou(e,t,l){var a=e.tag;if(a===5||a===6)e=e.stateNode,t?l.insertBefore(e,t):l.appendChild(e);else if(a!==4&&(a===27&&Al(e.type)&&(l=e.stateNode),e=e.child,e!==null))for(Ou(e,t,l),e=e.sibling;e!==null;)Ou(e,t,l),e=e.sibling}function kf(e){var t=e.stateNode,l=e.memoizedProps;try{for(var a=e.type,n=t.attributes;n.length;)t.removeAttributeNode(n[0]);$e(t,a,l),t[Ze]=e,t[tt]=l}catch(u){ve(e,e.return,u)}}var Pt=!1,Ye=!1,Wc=!1,Xf=typeof WeakSet=="function"?WeakSet:Set,Qe=null;function qh(e,t){if(e=e.containerInfo,xs=ti,e=Pr(e),Xi(e)){if("selectionStart"in e)var l={start:e.selectionStart,end:e.selectionEnd};else e:{l=(l=e.ownerDocument)&&l.defaultView||window;var a=l.getSelection&&l.getSelection();if(a&&a.rangeCount!==0){l=a.anchorNode;var n=a.anchorOffset,u=a.focusNode;a=a.focusOffset;try{l.nodeType,u.nodeType}catch{l=null;break e}var s=0,d=-1,g=-1,C=0,M=0,R=e,z=null;t:for(;;){for(var _;R!==l||n!==0&&R.nodeType!==3||(d=s+n),R!==u||a!==0&&R.nodeType!==3||(g=s+a),R.nodeType===3&&(s+=R.nodeValue.length),(_=R.firstChild)!==null;)z=R,R=_;for(;;){if(R===e)break t;if(z===l&&++C===n&&(d=s),z===u&&++M===a&&(g=s),(_=R.nextSibling)!==null)break;R=z,z=R.parentNode}R=_}l=d===-1||g===-1?null:{start:d,end:g}}else l=null}l=l||{start:0,end:0}}else l=null;for(ps={focusedElem:e,selectionRange:l},ti=!1,Qe=t;Qe!==null;)if(t=Qe,e=t.child,(t.subtreeFlags&1028)!==0&&e!==null)e.return=t,Qe=e;else for(;Qe!==null;){switch(t=Qe,u=t.alternate,e=t.flags,t.tag){case 0:if((e&4)!==0&&(e=t.updateQueue,e=e!==null?e.events:null,e!==null))for(l=0;l<e.length;l++)n=e[l],n.ref.impl=n.nextImpl;break;case 11:case 15:break;case 1:if((e&1024)!==0&&u!==null){e=void 0,l=t,n=u.memoizedProps,u=u.memoizedState,a=l.stateNode;try{var Z=Wl(l.type,n);e=a.getSnapshotBeforeUpdate(Z,u),a.__reactInternalSnapshotBeforeUpdate=e}catch(F){ve(l,l.return,F)}}break;case 3:if((e&1024)!==0){if(e=t.stateNode.containerInfo,l=e.nodeType,l===9)Ss(e);else if(l===1)switch(e.nodeName){case"HEAD":case"HTML":case"BODY":Ss(e);break;default:e.textContent=""}}break;case 5:case 26:case 27:case 6:case 4:case 17:break;default:if((e&1024)!==0)throw Error(r(163))}if(e=t.sibling,e!==null){e.return=t.return,Qe=e;break}Qe=t.return}}function Qf(e,t,l){var a=l.flags;switch(l.tag){case 0:case 11:case 15:tl(e,l),a&4&&vn(5,l);break;case 1:if(tl(e,l),a&4)if(e=l.stateNode,t===null)try{e.componentDidMount()}catch(s){ve(l,l.return,s)}else{var n=Wl(l.type,t.memoizedProps);t=t.memoizedState;try{e.componentDidUpdate(n,t,e.__reactInternalSnapshotBeforeUpdate)}catch(s){ve(l,l.return,s)}}a&64&&Bf(l),a&512&&bn(l,l.return);break;case 3:if(tl(e,l),a&64&&(e=l.updateQueue,e!==null)){if(t=null,l.child!==null)switch(l.child.tag){case 27:case 5:t=l.child.stateNode;break;case 1:t=l.child.stateNode}try{zo(e,t)}catch(s){ve(l,l.return,s)}}break;case 27:t===null&&a&4&&kf(l);case 26:case 5:tl(e,l),t===null&&a&4&&Yf(l),a&512&&bn(l,l.return);break;case 12:tl(e,l);break;case 31:tl(e,l),a&4&&Kf(e,l);break;case 13:tl(e,l),a&4&&Jf(e,l),a&64&&(e=l.memoizedState,e!==null&&(e=e.dehydrated,e!==null&&(l=Jh.bind(null,l),hy(e,l))));break;case 22:if(a=l.memoizedState!==null||Pt,!a){t=t!==null&&t.memoizedState!==null||Ye,n=Pt;var u=Ye;Pt=a,(Ye=t)&&!u?ll(e,l,(l.subtreeFlags&8772)!==0):tl(e,l),Pt=n,Ye=u}break;case 30:break;default:tl(e,l)}}function Zf(e){var t=e.alternate;t!==null&&(e.alternate=null,Zf(t)),e.child=null,e.deletions=null,e.sibling=null,e.tag===5&&(t=e.stateNode,t!==null&&Ci(t)),e.stateNode=null,e.return=null,e.dependencies=null,e.memoizedProps=null,e.memoizedState=null,e.pendingProps=null,e.stateNode=null,e.updateQueue=null}var _e=null,at=!1;function el(e,t,l){for(l=l.child;l!==null;)Vf(e,t,l),l=l.sibling}function Vf(e,t,l){if(ot&&typeof ot.onCommitFiberUnmount=="function")try{ot.onCommitFiberUnmount(Xa,l)}catch{}switch(l.tag){case 26:Ye||qt(l,t),el(e,t,l),l.memoizedState?l.memoizedState.count--:l.stateNode&&(l=l.stateNode,l.parentNode.removeChild(l));break;case 27:Ye||qt(l,t);var a=_e,n=at;Al(l.type)&&(_e=l.stateNode,at=!1),el(e,t,l),_n(l.stateNode),_e=a,at=n;break;case 5:Ye||qt(l,t);case 6:if(a=_e,n=at,_e=null,el(e,t,l),_e=a,at=n,_e!==null)if(at)try{(_e.nodeType===9?_e.body:_e.nodeName==="HTML"?_e.ownerDocument.body:_e).removeChild(l.stateNode)}catch(u){ve(l,t,u)}else try{_e.removeChild(l.stateNode)}catch(u){ve(l,t,u)}break;case 18:_e!==null&&(at?(e=_e,Bd(e.nodeType===9?e.body:e.nodeName==="HTML"?e.ownerDocument.body:e,l.stateNode),Ha(e)):Bd(_e,l.stateNode));break;case 4:a=_e,n=at,_e=l.stateNode.containerInfo,at=!0,el(e,t,l),_e=a,at=n;break;case 0:case 11:case 14:case 15:Sl(2,l,t),Ye||Sl(4,l,t),el(e,t,l);break;case 1:Ye||(qt(l,t),a=l.stateNode,typeof a.componentWillUnmount=="function"&&qf(l,t,a)),el(e,t,l);break;case 21:el(e,t,l);break;case 22:Ye=(a=Ye)||l.memoizedState!==null,el(e,t,l),Ye=a;break;default:el(e,t,l)}}function Kf(e,t){if(t.memoizedState===null&&(e=t.alternate,e!==null&&(e=e.memoizedState,e!==null))){e=e.dehydrated;try{Ha(e)}catch(l){ve(t,t.return,l)}}}function Jf(e,t){if(t.memoizedState===null&&(e=t.alternate,e!==null&&(e=e.memoizedState,e!==null&&(e=e.dehydrated,e!==null))))try{Ha(e)}catch(l){ve(t,t.return,l)}}function Yh(e){switch(e.tag){case 31:case 13:case 19:var t=e.stateNode;return t===null&&(t=e.stateNode=new Xf),t;case 22:return e=e.stateNode,t=e._retryCache,t===null&&(t=e._retryCache=new Xf),t;default:throw Error(r(435,e.tag))}}function Uu(e,t){var l=Yh(e);t.forEach(function(a){if(!l.has(a)){l.add(a);var n=$h.bind(null,e,a);a.then(n,n)}})}function nt(e,t){var l=t.deletions;if(l!==null)for(var a=0;a<l.length;a++){var n=l[a],u=e,s=t,d=s;e:for(;d!==null;){switch(d.tag){case 27:if(Al(d.type)){_e=d.stateNode,at=!1;break e}break;case 5:_e=d.stateNode,at=!1;break e;case 3:case 4:_e=d.stateNode.containerInfo,at=!0;break e}d=d.return}if(_e===null)throw Error(r(160));Vf(u,s,n),_e=null,at=!1,u=n.alternate,u!==null&&(u.return=null),n.return=null}if(t.subtreeFlags&13886)for(t=t.child;t!==null;)$f(t,e),t=t.sibling}var Rt=null;function $f(e,t){var l=e.alternate,a=e.flags;switch(e.tag){case 0:case 11:case 14:case 15:nt(t,e),ut(e),a&4&&(Sl(3,e,e.return),vn(3,e),Sl(5,e,e.return));break;case 1:nt(t,e),ut(e),a&512&&(Ye||l===null||qt(l,l.return)),a&64&&Pt&&(e=e.updateQueue,e!==null&&(a=e.callbacks,a!==null&&(l=e.shared.hiddenCallbacks,e.shared.hiddenCallbacks=l===null?a:l.concat(a))));break;case 26:var n=Rt;if(nt(t,e),ut(e),a&512&&(Ye||l===null||qt(l,l.return)),a&4){var u=l!==null?l.memoizedState:null;if(a=e.memoizedState,l===null)if(a===null)if(e.stateNode===null){e:{a=e.type,l=e.memoizedProps,n=n.ownerDocument||n;t:switch(a){case"title":u=n.getElementsByTagName("title")[0],(!u||u[Va]||u[Ze]||u.namespaceURI==="http://www.w3.org/2000/svg"||u.hasAttribute("itemprop"))&&(u=n.createElement(a),n.head.insertBefore(u,n.querySelector("head > title"))),$e(u,a,l),u[Ze]=e,Xe(u),a=u;break e;case"link":var s=$d("link","href",n).get(a+(l.href||""));if(s){for(var d=0;d<s.length;d++)if(u=s[d],u.getAttribute("href")===(l.href==null||l.href===""?null:l.href)&&u.getAttribute("rel")===(l.rel==null?null:l.rel)&&u.getAttribute("title")===(l.title==null?null:l.title)&&u.getAttribute("crossorigin")===(l.crossOrigin==null?null:l.crossOrigin)){s.splice(d,1);break t}}u=n.createElement(a),$e(u,a,l),n.head.appendChild(u);break;case"meta":if(s=$d("meta","content",n).get(a+(l.content||""))){for(d=0;d<s.length;d++)if(u=s[d],u.getAttribute("content")===(l.content==null?null:""+l.content)&&u.getAttribute("name")===(l.name==null?null:l.name)&&u.getAttribute("property")===(l.property==null?null:l.property)&&u.getAttribute("http-equiv")===(l.httpEquiv==null?null:l.httpEquiv)&&u.getAttribute("charset")===(l.charSet==null?null:l.charSet)){s.splice(d,1);break t}}u=n.createElement(a),$e(u,a,l),n.head.appendChild(u);break;default:throw Error(r(468,a))}u[Ze]=e,Xe(u),a=u}e.stateNode=a}else Wd(n,e.type,e.stateNode);else e.stateNode=Jd(n,a,e.memoizedProps);else u!==a?(u===null?l.stateNode!==null&&(l=l.stateNode,l.parentNode.removeChild(l)):u.count--,a===null?Wd(n,e.type,e.stateNode):Jd(n,a,e.memoizedProps)):a===null&&e.stateNode!==null&&Kc(e,e.memoizedProps,l.memoizedProps)}break;case 27:nt(t,e),ut(e),a&512&&(Ye||l===null||qt(l,l.return)),l!==null&&a&4&&Kc(e,e.memoizedProps,l.memoizedProps);break;case 5:if(nt(t,e),ut(e),a&512&&(Ye||l===null||qt(l,l.return)),e.flags&32){n=e.stateNode;try{ua(n,"")}catch(Z){ve(e,e.return,Z)}}a&4&&e.stateNode!=null&&(n=e.memoizedProps,Kc(e,n,l!==null?l.memoizedProps:n)),a&1024&&(Wc=!0);break;case 6:if(nt(t,e),ut(e),a&4){if(e.stateNode===null)throw Error(r(162));a=e.memoizedProps,l=e.stateNode;try{l.nodeValue=a}catch(Z){ve(e,e.return,Z)}}break;case 3:if(Fu=null,n=Rt,Rt=$u(t.containerInfo),nt(t,e),Rt=n,ut(e),a&4&&l!==null&&l.memoizedState.isDehydrated)try{Ha(t.containerInfo)}catch(Z){ve(e,e.return,Z)}Wc&&(Wc=!1,Wf(e));break;case 4:a=Rt,Rt=$u(e.stateNode.containerInfo),nt(t,e),ut(e),Rt=a;break;case 12:nt(t,e),ut(e);break;case 31:nt(t,e),ut(e),a&4&&(a=e.updateQueue,a!==null&&(e.updateQueue=null,Uu(e,a)));break;case 13:nt(t,e),ut(e),e.child.flags&8192&&e.memoizedState!==null!=(l!==null&&l.memoizedState!==null)&&(Lu=rt()),a&4&&(a=e.updateQueue,a!==null&&(e.updateQueue=null,Uu(e,a)));break;case 22:n=e.memoizedState!==null;var g=l!==null&&l.memoizedState!==null,C=Pt,M=Ye;if(Pt=C||n,Ye=M||g,nt(t,e),Ye=M,Pt=C,ut(e),a&8192)e:for(t=e.stateNode,t._visibility=n?t._visibility&-2:t._visibility|1,n&&(l===null||g||Pt||Ye||Fl(e)),l=null,t=e;;){if(t.tag===5||t.tag===26){if(l===null){g=l=t;try{if(u=g.stateNode,n)s=u.style,typeof s.setProperty=="function"?s.setProperty("display","none","important"):s.display="none";else{d=g.stateNode;var R=g.memoizedProps.style,z=R!=null&&R.hasOwnProperty("display")?R.display:null;d.style.display=z==null||typeof z=="boolean"?"":(""+z).trim()}}catch(Z){ve(g,g.return,Z)}}}else if(t.tag===6){if(l===null){g=t;try{g.stateNode.nodeValue=n?"":g.memoizedProps}catch(Z){ve(g,g.return,Z)}}}else if(t.tag===18){if(l===null){g=t;try{var _=g.stateNode;n?qd(_,!0):qd(g.stateNode,!1)}catch(Z){ve(g,g.return,Z)}}}else if((t.tag!==22&&t.tag!==23||t.memoizedState===null||t===e)&&t.child!==null){t.child.return=t,t=t.child;continue}if(t===e)break e;for(;t.sibling===null;){if(t.return===null||t.return===e)break e;l===t&&(l=null),t=t.return}l===t&&(l=null),t.sibling.return=t.return,t=t.sibling}a&4&&(a=e.updateQueue,a!==null&&(l=a.retryQueue,l!==null&&(a.retryQueue=null,Uu(e,l))));break;case 19:nt(t,e),ut(e),a&4&&(a=e.updateQueue,a!==null&&(e.updateQueue=null,Uu(e,a)));break;case 30:break;case 21:break;default:nt(t,e),ut(e)}}function ut(e){var t=e.flags;if(t&2){try{for(var l,a=e.return;a!==null;){if(Gf(a)){l=a;break}a=a.return}if(l==null)throw Error(r(160));switch(l.tag){case 27:var n=l.stateNode,u=Jc(e);Ou(e,u,n);break;case 5:var s=l.stateNode;l.flags&32&&(ua(s,""),l.flags&=-33);var d=Jc(e);Ou(e,d,s);break;case 3:case 4:var g=l.stateNode.containerInfo,C=Jc(e);$c(e,C,g);break;default:throw Error(r(161))}}catch(M){ve(e,e.return,M)}e.flags&=-3}t&4096&&(e.flags&=-4097)}function Wf(e){if(e.subtreeFlags&1024)for(e=e.child;e!==null;){var t=e;Wf(t),t.tag===5&&t.flags&1024&&t.stateNode.reset(),e=e.sibling}}function tl(e,t){if(t.subtreeFlags&8772)for(t=t.child;t!==null;)Qf(e,t.alternate,t),t=t.sibling}function Fl(e){for(e=e.child;e!==null;){var t=e;switch(t.tag){case 0:case 11:case 14:case 15:Sl(4,t,t.return),Fl(t);break;case 1:qt(t,t.return);var l=t.stateNode;typeof l.componentWillUnmount=="function"&&qf(t,t.return,l),Fl(t);break;case 27:_n(t.stateNode);case 26:case 5:qt(t,t.return),Fl(t);break;case 22:t.memoizedState===null&&Fl(t);break;case 30:Fl(t);break;default:Fl(t)}e=e.sibling}}function ll(e,t,l){for(l=l&&(t.subtreeFlags&8772)!==0,t=t.child;t!==null;){var a=t.alternate,n=e,u=t,s=u.flags;switch(u.tag){case 0:case 11:case 15:ll(n,u,l),vn(4,u);break;case 1:if(ll(n,u,l),a=u,n=a.stateNode,typeof n.componentDidMount=="function")try{n.componentDidMount()}catch(C){ve(a,a.return,C)}if(a=u,n=a.updateQueue,n!==null){var d=a.stateNode;try{var g=n.shared.hiddenCallbacks;if(g!==null)for(n.shared.hiddenCallbacks=null,n=0;n<g.length;n++)Co(g[n],d)}catch(C){ve(a,a.return,C)}}l&&s&64&&Bf(u),bn(u,u.return);break;case 27:kf(u);case 26:case 5:ll(n,u,l),l&&a===null&&s&4&&Yf(u),bn(u,u.return);break;case 12:ll(n,u,l);break;case 31:ll(n,u,l),l&&s&4&&Kf(n,u);break;case 13:ll(n,u,l),l&&s&4&&Jf(n,u);break;case 22:u.memoizedState===null&&ll(n,u,l),bn(u,u.return);break;case 30:break;default:ll(n,u,l)}t=t.sibling}}function Fc(e,t){var l=null;e!==null&&e.memoizedState!==null&&e.memoizedState.cachePool!==null&&(l=e.memoizedState.cachePool.pool),e=null,t.memoizedState!==null&&t.memoizedState.cachePool!==null&&(e=t.memoizedState.cachePool.pool),e!==l&&(e!=null&&e.refCount++,l!=null&&un(l))}function Ic(e,t){e=null,t.alternate!==null&&(e=t.alternate.memoizedState.cache),t=t.memoizedState.cache,t!==e&&(t.refCount++,e!=null&&un(e))}function Ot(e,t,l,a){if(t.subtreeFlags&10256)for(t=t.child;t!==null;)Ff(e,t,l,a),t=t.sibling}function Ff(e,t,l,a){var n=t.flags;switch(t.tag){case 0:case 11:case 15:Ot(e,t,l,a),n&2048&&vn(9,t);break;case 1:Ot(e,t,l,a);break;case 3:Ot(e,t,l,a),n&2048&&(e=null,t.alternate!==null&&(e=t.alternate.memoizedState.cache),t=t.memoizedState.cache,t!==e&&(t.refCount++,e!=null&&un(e)));break;case 12:if(n&2048){Ot(e,t,l,a),e=t.stateNode;try{var u=t.memoizedProps,s=u.id,d=u.onPostCommit;typeof d=="function"&&d(s,t.alternate===null?"mount":"update",e.passiveEffectDuration,-0)}catch(g){ve(t,t.return,g)}}else Ot(e,t,l,a);break;case 31:Ot(e,t,l,a);break;case 13:Ot(e,t,l,a);break;case 23:break;case 22:u=t.stateNode,s=t.alternate,t.memoizedState!==null?u._visibility&2?Ot(e,t,l,a):Sn(e,t):u._visibility&2?Ot(e,t,l,a):(u._visibility|=2,Ta(e,t,l,a,(t.subtreeFlags&10256)!==0||!1)),n&2048&&Fc(s,t);break;case 24:Ot(e,t,l,a),n&2048&&Ic(t.alternate,t);break;default:Ot(e,t,l,a)}}function Ta(e,t,l,a,n){for(n=n&&((t.subtreeFlags&10256)!==0||!1),t=t.child;t!==null;){var u=e,s=t,d=l,g=a,C=s.flags;switch(s.tag){case 0:case 11:case 15:Ta(u,s,d,g,n),vn(8,s);break;case 23:break;case 22:var M=s.stateNode;s.memoizedState!==null?M._visibility&2?Ta(u,s,d,g,n):Sn(u,s):(M._visibility|=2,Ta(u,s,d,g,n)),n&&C&2048&&Fc(s.alternate,s);break;case 24:Ta(u,s,d,g,n),n&&C&2048&&Ic(s.alternate,s);break;default:Ta(u,s,d,g,n)}t=t.sibling}}function Sn(e,t){if(t.subtreeFlags&10256)for(t=t.child;t!==null;){var l=e,a=t,n=a.flags;switch(a.tag){case 22:Sn(l,a),n&2048&&Fc(a.alternate,a);break;case 24:Sn(l,a),n&2048&&Ic(a.alternate,a);break;default:Sn(l,a)}t=t.sibling}}var Nn=8192;function Ca(e,t,l){if(e.subtreeFlags&Nn)for(e=e.child;e!==null;)If(e,t,l),e=e.sibling}function If(e,t,l){switch(e.tag){case 26:Ca(e,t,l),e.flags&Nn&&e.memoizedState!==null&&Cy(l,Rt,e.memoizedState,e.memoizedProps);break;case 5:Ca(e,t,l);break;case 3:case 4:var a=Rt;Rt=$u(e.stateNode.containerInfo),Ca(e,t,l),Rt=a;break;case 22:e.memoizedState===null&&(a=e.alternate,a!==null&&a.memoizedState!==null?(a=Nn,Nn=16777216,Ca(e,t,l),Nn=a):Ca(e,t,l));break;default:Ca(e,t,l)}}function Pf(e){var t=e.alternate;if(t!==null&&(e=t.child,e!==null)){t.child=null;do t=e.sibling,e.sibling=null,e=t;while(e!==null)}}function jn(e){var t=e.deletions;if((e.flags&16)!==0){if(t!==null)for(var l=0;l<t.length;l++){var a=t[l];Qe=a,td(a,e)}Pf(e)}if(e.subtreeFlags&10256)for(e=e.child;e!==null;)ed(e),e=e.sibling}function ed(e){switch(e.tag){case 0:case 11:case 15:jn(e),e.flags&2048&&Sl(9,e,e.return);break;case 3:jn(e);break;case 12:jn(e);break;case 22:var t=e.stateNode;e.memoizedState!==null&&t._visibility&2&&(e.return===null||e.return.tag!==13)?(t._visibility&=-3,Hu(e)):jn(e);break;default:jn(e)}}function Hu(e){var t=e.deletions;if((e.flags&16)!==0){if(t!==null)for(var l=0;l<t.length;l++){var a=t[l];Qe=a,td(a,e)}Pf(e)}for(e=e.child;e!==null;){switch(t=e,t.tag){case 0:case 11:case 15:Sl(8,t,t.return),Hu(t);break;case 22:l=t.stateNode,l._visibility&2&&(l._visibility&=-3,Hu(t));break;default:Hu(t)}e=e.sibling}}function td(e,t){for(;Qe!==null;){var l=Qe;switch(l.tag){case 0:case 11:case 15:Sl(8,l,t);break;case 23:case 22:if(l.memoizedState!==null&&l.memoizedState.cachePool!==null){var a=l.memoizedState.cachePool.pool;a!=null&&a.refCount++}break;case 24:un(l.memoizedState.cache)}if(a=l.child,a!==null)a.return=l,Qe=a;else e:for(l=e;Qe!==null;){a=Qe;var n=a.sibling,u=a.return;if(Zf(a),a===l){Qe=null;break e}if(n!==null){n.return=u,Qe=n;break e}Qe=u}}}var Gh={getCacheForType:function(e){var t=Ke(Le),l=t.data.get(e);return l===void 0&&(l=e(),t.data.set(e,l)),l},cacheSignal:function(){return Ke(Le).controller.signal}},kh=typeof WeakMap=="function"?WeakMap:Map,ge=0,Ce=null,se=null,fe=0,pe=0,gt=null,Nl=!1,za=!1,Pc=!1,al=0,Re=0,jl=0,Il=0,es=0,xt=0,Aa=0,En=null,it=null,ts=!1,Lu=0,ld=0,Bu=1/0,qu=null,El=null,Ge=0,Tl=null,_a=null,nl=0,ls=0,as=null,ad=null,Tn=0,ns=null;function pt(){return(ge&2)!==0&&fe!==0?fe&-fe:w.T!==null?os():xr()}function nd(){if(xt===0)if((fe&536870912)===0||me){var e=Kn;Kn<<=1,(Kn&3932160)===0&&(Kn=262144),xt=e}else xt=536870912;return e=ht.current,e!==null&&(e.flags|=32),xt}function ct(e,t,l){(e===Ce&&(pe===2||pe===9)||e.cancelPendingCommit!==null)&&(wa(e,0),Cl(e,fe,xt,!1)),Za(e,l),((ge&2)===0||e!==Ce)&&(e===Ce&&((ge&2)===0&&(Il|=l),Re===4&&Cl(e,fe,xt,!1)),Yt(e))}function ud(e,t,l){if((ge&6)!==0)throw Error(r(327));var a=!l&&(t&127)===0&&(t&e.expiredLanes)===0||Qa(e,t),n=a?Zh(e,t):is(e,t,!0),u=a;do{if(n===0){za&&!a&&Cl(e,t,0,!1);break}else{if(l=e.current.alternate,u&&!Xh(l)){n=is(e,t,!1),u=!1;continue}if(n===2){if(u=t,e.errorRecoveryDisabledLanes&u)var s=0;else s=e.pendingLanes&-536870913,s=s!==0?s:s&536870912?536870912:0;if(s!==0){t=s;e:{var d=e;n=En;var g=d.current.memoizedState.isDehydrated;if(g&&(wa(d,s).flags|=256),s=is(d,s,!1),s!==2){if(Pc&&!g){d.errorRecoveryDisabledLanes|=u,Il|=u,n=4;break e}u=it,it=n,u!==null&&(it===null?it=u:it.push.apply(it,u))}n=s}if(u=!1,n!==2)continue}}if(n===1){wa(e,0),Cl(e,t,0,!0);break}e:{switch(a=e,u=n,u){case 0:case 1:throw Error(r(345));case 4:if((t&4194048)!==t)break;case 6:Cl(a,t,xt,!Nl);break e;case 2:it=null;break;case 3:case 5:break;default:throw Error(r(329))}if((t&62914560)===t&&(n=Lu+300-rt(),10<n)){if(Cl(a,t,xt,!Nl),$n(a,0,!0)!==0)break e;nl=t,a.timeoutHandle=Hd(id.bind(null,a,l,it,qu,ts,t,xt,Il,Aa,Nl,u,"Throttled",-0,0),n);break e}id(a,l,it,qu,ts,t,xt,Il,Aa,Nl,u,null,-0,0)}}break}while(!0);Yt(e)}function id(e,t,l,a,n,u,s,d,g,C,M,R,z,_){if(e.timeoutHandle=-1,R=t.subtreeFlags,R&8192||(R&16785408)===16785408){R={stylesheets:null,count:0,imgCount:0,imgBytes:0,suspenseyImages:[],waitingForImages:!0,waitingForViewTransition:!1,unsuspend:Xt},If(t,u,R);var Z=(u&62914560)===u?Lu-rt():(u&4194048)===u?ld-rt():0;if(Z=zy(R,Z),Z!==null){nl=u,e.cancelPendingCommit=Z(hd.bind(null,e,t,u,l,a,n,s,d,g,M,R,null,z,_)),Cl(e,u,s,!C);return}}hd(e,t,u,l,a,n,s,d,g)}function Xh(e){for(var t=e;;){var l=t.tag;if((l===0||l===11||l===15)&&t.flags&16384&&(l=t.updateQueue,l!==null&&(l=l.stores,l!==null)))for(var a=0;a<l.length;a++){var n=l[a],u=n.getSnapshot;n=n.value;try{if(!dt(u(),n))return!1}catch{return!1}}if(l=t.child,t.subtreeFlags&16384&&l!==null)l.return=t,t=l;else{if(t===e)break;for(;t.sibling===null;){if(t.return===null||t.return===e)return!0;t=t.return}t.sibling.return=t.return,t=t.sibling}}return!0}function Cl(e,t,l,a){t&=~es,t&=~Il,e.suspendedLanes|=t,e.pingedLanes&=~t,a&&(e.warmLanes|=t),a=e.expirationTimes;for(var n=t;0<n;){var u=31-ft(n),s=1<<u;a[u]=-1,n&=~s}l!==0&&hr(e,l,t)}function Yu(){return(ge&6)===0?(Cn(0),!1):!0}function us(){if(se!==null){if(pe===0)var e=se.return;else e=se,Kt=Xl=null,Sc(e),ba=null,sn=0,e=se;for(;e!==null;)Lf(e.alternate,e),e=e.return;se=null}}function wa(e,t){var l=e.timeoutHandle;l!==-1&&(e.timeoutHandle=-1,ry(l)),l=e.cancelPendingCommit,l!==null&&(e.cancelPendingCommit=null,l()),nl=0,us(),Ce=e,se=l=Zt(e.current,null),fe=t,pe=0,gt=null,Nl=!1,za=Qa(e,t),Pc=!1,Aa=xt=es=Il=jl=Re=0,it=En=null,ts=!1,(t&8)!==0&&(t|=t&32);var a=e.entangledLanes;if(a!==0)for(e=e.entanglements,a&=t;0<a;){var n=31-ft(a),u=1<<n;t|=e[n],a&=~u}return al=t,cu(),l}function cd(e,t){ne=null,w.H=gn,t===va||t===yu?(t=No(),pe=3):t===rc?(t=No(),pe=4):pe=t===Lc?8:t!==null&&typeof t=="object"&&typeof t.then=="function"?6:1,gt=t,se===null&&(Re=1,_u(e,Tt(t,e.current)))}function sd(){var e=ht.current;return e===null?!0:(fe&4194048)===fe?_t===null:(fe&62914560)===fe||(fe&536870912)!==0?e===_t:!1}function rd(){var e=w.H;return w.H=gn,e===null?gn:e}function od(){var e=w.A;return w.A=Gh,e}function Gu(){Re=4,Nl||(fe&4194048)!==fe&&ht.current!==null||(za=!0),(jl&134217727)===0&&(Il&134217727)===0||Ce===null||Cl(Ce,fe,xt,!1)}function is(e,t,l){var a=ge;ge|=2;var n=rd(),u=od();(Ce!==e||fe!==t)&&(qu=null,wa(e,t)),t=!1;var s=Re;e:do try{if(pe!==0&&se!==null){var d=se,g=gt;switch(pe){case 8:us(),s=6;break e;case 3:case 2:case 9:case 6:ht.current===null&&(t=!0);var C=pe;if(pe=0,gt=null,Ma(e,d,g,C),l&&za){s=0;break e}break;default:C=pe,pe=0,gt=null,Ma(e,d,g,C)}}Qh(),s=Re;break}catch(M){cd(e,M)}while(!0);return t&&e.shellSuspendCounter++,Kt=Xl=null,ge=a,w.H=n,w.A=u,se===null&&(Ce=null,fe=0,cu()),s}function Qh(){for(;se!==null;)fd(se)}function Zh(e,t){var l=ge;ge|=2;var a=rd(),n=od();Ce!==e||fe!==t?(qu=null,Bu=rt()+500,wa(e,t)):za=Qa(e,t);e:do try{if(pe!==0&&se!==null){t=se;var u=gt;t:switch(pe){case 1:pe=0,gt=null,Ma(e,t,u,1);break;case 2:case 9:if(bo(u)){pe=0,gt=null,dd(t);break}t=function(){pe!==2&&pe!==9||Ce!==e||(pe=7),Yt(e)},u.then(t,t);break e;case 3:pe=7;break e;case 4:pe=5;break e;case 7:bo(u)?(pe=0,gt=null,dd(t)):(pe=0,gt=null,Ma(e,t,u,7));break;case 5:var s=null;switch(se.tag){case 26:s=se.memoizedState;case 5:case 27:var d=se;if(s?Fd(s):d.stateNode.complete){pe=0,gt=null;var g=d.sibling;if(g!==null)se=g;else{var C=d.return;C!==null?(se=C,ku(C)):se=null}break t}}pe=0,gt=null,Ma(e,t,u,5);break;case 6:pe=0,gt=null,Ma(e,t,u,6);break;case 8:us(),Re=6;break e;default:throw Error(r(462))}}Vh();break}catch(M){cd(e,M)}while(!0);return Kt=Xl=null,w.H=a,w.A=n,ge=l,se!==null?0:(Ce=null,fe=0,cu(),Re)}function Vh(){for(;se!==null&&!y0();)fd(se)}function fd(e){var t=Uf(e.alternate,e,al);e.memoizedProps=e.pendingProps,t===null?ku(e):se=t}function dd(e){var t=e,l=t.alternate;switch(t.tag){case 15:case 0:t=_f(l,t,t.pendingProps,t.type,void 0,fe);break;case 11:t=_f(l,t,t.pendingProps,t.type.render,t.ref,fe);break;case 5:Sc(t);default:Lf(l,t),t=se=so(t,al),t=Uf(l,t,al)}e.memoizedProps=e.pendingProps,t===null?ku(e):se=t}function Ma(e,t,l,a){Kt=Xl=null,Sc(t),ba=null,sn=0;var n=t.return;try{if(Oh(e,n,t,l,fe)){Re=1,_u(e,Tt(l,e.current)),se=null;return}}catch(u){if(n!==null)throw se=n,u;Re=1,_u(e,Tt(l,e.current)),se=null;return}t.flags&32768?(me||a===1?e=!0:za||(fe&536870912)!==0?e=!1:(Nl=e=!0,(a===2||a===9||a===3||a===6)&&(a=ht.current,a!==null&&a.tag===13&&(a.flags|=16384))),md(t,e)):ku(t)}function ku(e){var t=e;do{if((t.flags&32768)!==0){md(t,Nl);return}e=t.return;var l=Lh(t.alternate,t,al);if(l!==null){se=l;return}if(t=t.sibling,t!==null){se=t;return}se=t=e}while(t!==null);Re===0&&(Re=5)}function md(e,t){do{var l=Bh(e.alternate,e);if(l!==null){l.flags&=32767,se=l;return}if(l=e.return,l!==null&&(l.flags|=32768,l.subtreeFlags=0,l.deletions=null),!t&&(e=e.sibling,e!==null)){se=e;return}se=e=l}while(e!==null);Re=6,se=null}function hd(e,t,l,a,n,u,s,d,g){e.cancelPendingCommit=null;do Xu();while(Ge!==0);if((ge&6)!==0)throw Error(r(327));if(t!==null){if(t===e.current)throw Error(r(177));if(u=t.lanes|t.childLanes,u|=Ji,T0(e,l,u,s,d,g),e===Ce&&(se=Ce=null,fe=0),_a=t,Tl=e,nl=l,ls=u,as=n,ad=a,(t.subtreeFlags&10256)!==0||(t.flags&10256)!==0?(e.callbackNode=null,e.callbackPriority=0,Wh(Zn,function(){return vd(),null})):(e.callbackNode=null,e.callbackPriority=0),a=(t.flags&13878)!==0,(t.subtreeFlags&13878)!==0||a){a=w.T,w.T=null,n=k.p,k.p=2,s=ge,ge|=4;try{qh(e,t,l)}finally{ge=s,k.p=n,w.T=a}}Ge=1,yd(),gd(),xd()}}function yd(){if(Ge===1){Ge=0;var e=Tl,t=_a,l=(t.flags&13878)!==0;if((t.subtreeFlags&13878)!==0||l){l=w.T,w.T=null;var a=k.p;k.p=2;var n=ge;ge|=4;try{$f(t,e);var u=ps,s=Pr(e.containerInfo),d=u.focusedElem,g=u.selectionRange;if(s!==d&&d&&d.ownerDocument&&Ir(d.ownerDocument.documentElement,d)){if(g!==null&&Xi(d)){var C=g.start,M=g.end;if(M===void 0&&(M=C),"selectionStart"in d)d.selectionStart=C,d.selectionEnd=Math.min(M,d.value.length);else{var R=d.ownerDocument||document,z=R&&R.defaultView||window;if(z.getSelection){var _=z.getSelection(),Z=d.textContent.length,F=Math.min(g.start,Z),je=g.end===void 0?F:Math.min(g.end,Z);!_.extend&&F>je&&(s=je,je=F,F=s);var E=Fr(d,F),S=Fr(d,je);if(E&&S&&(_.rangeCount!==1||_.anchorNode!==E.node||_.anchorOffset!==E.offset||_.focusNode!==S.node||_.focusOffset!==S.offset)){var T=R.createRange();T.setStart(E.node,E.offset),_.removeAllRanges(),F>je?(_.addRange(T),_.extend(S.node,S.offset)):(T.setEnd(S.node,S.offset),_.addRange(T))}}}}for(R=[],_=d;_=_.parentNode;)_.nodeType===1&&R.push({element:_,left:_.scrollLeft,top:_.scrollTop});for(typeof d.focus=="function"&&d.focus(),d=0;d<R.length;d++){var D=R[d];D.element.scrollLeft=D.left,D.element.scrollTop=D.top}}ti=!!xs,ps=xs=null}finally{ge=n,k.p=a,w.T=l}}e.current=t,Ge=2}}function gd(){if(Ge===2){Ge=0;var e=Tl,t=_a,l=(t.flags&8772)!==0;if((t.subtreeFlags&8772)!==0||l){l=w.T,w.T=null;var a=k.p;k.p=2;var n=ge;ge|=4;try{Qf(e,t.alternate,t)}finally{ge=n,k.p=a,w.T=l}}Ge=3}}function xd(){if(Ge===4||Ge===3){Ge=0,g0();var e=Tl,t=_a,l=nl,a=ad;(t.subtreeFlags&10256)!==0||(t.flags&10256)!==0?Ge=5:(Ge=0,_a=Tl=null,pd(e,e.pendingLanes));var n=e.pendingLanes;if(n===0&&(El=null),Ei(l),t=t.stateNode,ot&&typeof ot.onCommitFiberRoot=="function")try{ot.onCommitFiberRoot(Xa,t,void 0,(t.current.flags&128)===128)}catch{}if(a!==null){t=w.T,n=k.p,k.p=2,w.T=null;try{for(var u=e.onRecoverableError,s=0;s<a.length;s++){var d=a[s];u(d.value,{componentStack:d.stack})}}finally{w.T=t,k.p=n}}(nl&3)!==0&&Xu(),Yt(e),n=e.pendingLanes,(l&261930)!==0&&(n&42)!==0?e===ns?Tn++:(Tn=0,ns=e):Tn=0,Cn(0)}}function pd(e,t){(e.pooledCacheLanes&=t)===0&&(t=e.pooledCache,t!=null&&(e.pooledCache=null,un(t)))}function Xu(){return yd(),gd(),xd(),vd()}function vd(){if(Ge!==5)return!1;var e=Tl,t=ls;ls=0;var l=Ei(nl),a=w.T,n=k.p;try{k.p=32>l?32:l,w.T=null,l=as,as=null;var u=Tl,s=nl;if(Ge=0,_a=Tl=null,nl=0,(ge&6)!==0)throw Error(r(331));var d=ge;if(ge|=4,ed(u.current),Ff(u,u.current,s,l),ge=d,Cn(0,!1),ot&&typeof ot.onPostCommitFiberRoot=="function")try{ot.onPostCommitFiberRoot(Xa,u)}catch{}return!0}finally{k.p=n,w.T=a,pd(e,t)}}function bd(e,t,l){t=Tt(l,t),t=Hc(e.stateNode,t,2),e=pl(e,t,2),e!==null&&(Za(e,2),Yt(e))}function ve(e,t,l){if(e.tag===3)bd(e,e,l);else for(;t!==null;){if(t.tag===3){bd(t,e,l);break}else if(t.tag===1){var a=t.stateNode;if(typeof t.type.getDerivedStateFromError=="function"||typeof a.componentDidCatch=="function"&&(El===null||!El.has(a))){e=Tt(l,e),l=Sf(2),a=pl(t,l,2),a!==null&&(Nf(l,a,t,e),Za(a,2),Yt(a));break}}t=t.return}}function cs(e,t,l){var a=e.pingCache;if(a===null){a=e.pingCache=new kh;var n=new Set;a.set(t,n)}else n=a.get(t),n===void 0&&(n=new Set,a.set(t,n));n.has(l)||(Pc=!0,n.add(l),e=Kh.bind(null,e,t,l),t.then(e,e))}function Kh(e,t,l){var a=e.pingCache;a!==null&&a.delete(t),e.pingedLanes|=e.suspendedLanes&l,e.warmLanes&=~l,Ce===e&&(fe&l)===l&&(Re===4||Re===3&&(fe&62914560)===fe&&300>rt()-Lu?(ge&2)===0&&wa(e,0):es|=l,Aa===fe&&(Aa=0)),Yt(e)}function Sd(e,t){t===0&&(t=mr()),e=Yl(e,t),e!==null&&(Za(e,t),Yt(e))}function Jh(e){var t=e.memoizedState,l=0;t!==null&&(l=t.retryLane),Sd(e,l)}function $h(e,t){var l=0;switch(e.tag){case 31:case 13:var a=e.stateNode,n=e.memoizedState;n!==null&&(l=n.retryLane);break;case 19:a=e.stateNode;break;case 22:a=e.stateNode._retryCache;break;default:throw Error(r(314))}a!==null&&a.delete(t),Sd(e,l)}function Wh(e,t){return bi(e,t)}var Qu=null,Da=null,ss=!1,Zu=!1,rs=!1,zl=0;function Yt(e){e!==Da&&e.next===null&&(Da===null?Qu=Da=e:Da=Da.next=e),Zu=!0,ss||(ss=!0,Ih())}function Cn(e,t){if(!rs&&Zu){rs=!0;do for(var l=!1,a=Qu;a!==null;){if(e!==0){var n=a.pendingLanes;if(n===0)var u=0;else{var s=a.suspendedLanes,d=a.pingedLanes;u=(1<<31-ft(42|e)+1)-1,u&=n&~(s&~d),u=u&201326741?u&201326741|1:u?u|2:0}u!==0&&(l=!0,Td(a,u))}else u=fe,u=$n(a,a===Ce?u:0,a.cancelPendingCommit!==null||a.timeoutHandle!==-1),(u&3)===0||Qa(a,u)||(l=!0,Td(a,u));a=a.next}while(l);rs=!1}}function Fh(){Nd()}function Nd(){Zu=ss=!1;var e=0;zl!==0&&sy()&&(e=zl);for(var t=rt(),l=null,a=Qu;a!==null;){var n=a.next,u=jd(a,t);u===0?(a.next=null,l===null?Qu=n:l.next=n,n===null&&(Da=l)):(l=a,(e!==0||(u&3)!==0)&&(Zu=!0)),a=n}Ge!==0&&Ge!==5||Cn(e),zl!==0&&(zl=0)}function jd(e,t){for(var l=e.suspendedLanes,a=e.pingedLanes,n=e.expirationTimes,u=e.pendingLanes&-62914561;0<u;){var s=31-ft(u),d=1<<s,g=n[s];g===-1?((d&l)===0||(d&a)!==0)&&(n[s]=E0(d,t)):g<=t&&(e.expiredLanes|=d),u&=~d}if(t=Ce,l=fe,l=$n(e,e===t?l:0,e.cancelPendingCommit!==null||e.timeoutHandle!==-1),a=e.callbackNode,l===0||e===t&&(pe===2||pe===9)||e.cancelPendingCommit!==null)return a!==null&&a!==null&&Si(a),e.callbackNode=null,e.callbackPriority=0;if((l&3)===0||Qa(e,l)){if(t=l&-l,t===e.callbackPriority)return t;switch(a!==null&&Si(a),Ei(l)){case 2:case 8:l=fr;break;case 32:l=Zn;break;case 268435456:l=dr;break;default:l=Zn}return a=Ed.bind(null,e),l=bi(l,a),e.callbackPriority=t,e.callbackNode=l,t}return a!==null&&a!==null&&Si(a),e.callbackPriority=2,e.callbackNode=null,2}function Ed(e,t){if(Ge!==0&&Ge!==5)return e.callbackNode=null,e.callbackPriority=0,null;var l=e.callbackNode;if(Xu()&&e.callbackNode!==l)return null;var a=fe;return a=$n(e,e===Ce?a:0,e.cancelPendingCommit!==null||e.timeoutHandle!==-1),a===0?null:(ud(e,a,t),jd(e,rt()),e.callbackNode!=null&&e.callbackNode===l?Ed.bind(null,e):null)}function Td(e,t){if(Xu())return null;ud(e,t,!0)}function Ih(){oy(function(){(ge&6)!==0?bi(or,Fh):Nd()})}function os(){if(zl===0){var e=xa;e===0&&(e=Vn,Vn<<=1,(Vn&261888)===0&&(Vn=256)),zl=e}return zl}function Cd(e){return e==null||typeof e=="symbol"||typeof e=="boolean"?null:typeof e=="function"?e:Pn(""+e)}function zd(e,t){var l=t.ownerDocument.createElement("input");return l.name=t.name,l.value=t.value,e.id&&l.setAttribute("form",e.id),t.parentNode.insertBefore(l,t),e=new FormData(e),l.parentNode.removeChild(l),e}function Ph(e,t,l,a,n){if(t==="submit"&&l&&l.stateNode===n){var u=Cd((n[tt]||null).action),s=a.submitter;s&&(t=(t=s[tt]||null)?Cd(t.formAction):s.getAttribute("formAction"),t!==null&&(u=t,s=null));var d=new au("action","action",null,a,n);e.push({event:d,listeners:[{instance:null,listener:function(){if(a.defaultPrevented){if(zl!==0){var g=s?zd(n,s):new FormData(n);wc(l,{pending:!0,data:g,method:n.method,action:u},null,g)}}else typeof u=="function"&&(d.preventDefault(),g=s?zd(n,s):new FormData(n),wc(l,{pending:!0,data:g,method:n.method,action:u},u,g))},currentTarget:n}]})}}for(var fs=0;fs<Ki.length;fs++){var ds=Ki[fs],ey=ds.toLowerCase(),ty=ds[0].toUpperCase()+ds.slice(1);Dt(ey,"on"+ty)}Dt(lo,"onAnimationEnd"),Dt(ao,"onAnimationIteration"),Dt(no,"onAnimationStart"),Dt("dblclick","onDoubleClick"),Dt("focusin","onFocus"),Dt("focusout","onBlur"),Dt(xh,"onTransitionRun"),Dt(ph,"onTransitionStart"),Dt(vh,"onTransitionCancel"),Dt(uo,"onTransitionEnd"),aa("onMouseEnter",["mouseout","mouseover"]),aa("onMouseLeave",["mouseout","mouseover"]),aa("onPointerEnter",["pointerout","pointerover"]),aa("onPointerLeave",["pointerout","pointerover"]),Hl("onChange","change click focusin focusout input keydown keyup selectionchange".split(" ")),Hl("onSelect","focusout contextmenu dragend focusin keydown keyup mousedown mouseup selectionchange".split(" ")),Hl("onBeforeInput",["compositionend","keypress","textInput","paste"]),Hl("onCompositionEnd","compositionend focusout keydown keypress keyup mousedown".split(" ")),Hl("onCompositionStart","compositionstart focusout keydown keypress keyup mousedown".split(" ")),Hl("onCompositionUpdate","compositionupdate focusout keydown keypress keyup mousedown".split(" "));var zn="abort canplay canplaythrough durationchange emptied encrypted ended error loadeddata loadedmetadata loadstart pause play playing progress ratechange resize seeked seeking stalled suspend timeupdate volumechange waiting".split(" "),ly=new Set("beforetoggle cancel close invalid load scroll scrollend toggle".split(" ").concat(zn));function Ad(e,t){t=(t&4)!==0;for(var l=0;l<e.length;l++){var a=e[l],n=a.event;a=a.listeners;e:{var u=void 0;if(t)for(var s=a.length-1;0<=s;s--){var d=a[s],g=d.instance,C=d.currentTarget;if(d=d.listener,g!==u&&n.isPropagationStopped())break e;u=d,n.currentTarget=C;try{u(n)}catch(M){iu(M)}n.currentTarget=null,u=g}else for(s=0;s<a.length;s++){if(d=a[s],g=d.instance,C=d.currentTarget,d=d.listener,g!==u&&n.isPropagationStopped())break e;u=d,n.currentTarget=C;try{u(n)}catch(M){iu(M)}n.currentTarget=null,u=g}}}}function re(e,t){var l=t[Ti];l===void 0&&(l=t[Ti]=new Set);var a=e+"__bubble";l.has(a)||(_d(t,e,2,!1),l.add(a))}function ms(e,t,l){var a=0;t&&(a|=4),_d(l,e,a,t)}var Vu="_reactListening"+Math.random().toString(36).slice(2);function hs(e){if(!e[Vu]){e[Vu]=!0,br.forEach(function(l){l!=="selectionchange"&&(ly.has(l)||ms(l,!1,e),ms(l,!0,e))});var t=e.nodeType===9?e:e.ownerDocument;t===null||t[Vu]||(t[Vu]=!0,ms("selectionchange",!1,t))}}function _d(e,t,l,a){switch(nm(t)){case 2:var n=wy;break;case 8:n=My;break;default:n=_s}l=n.bind(null,t,l,e),n=void 0,!Oi||t!=="touchstart"&&t!=="touchmove"&&t!=="wheel"||(n=!0),a?n!==void 0?e.addEventListener(t,l,{capture:!0,passive:n}):e.addEventListener(t,l,!0):n!==void 0?e.addEventListener(t,l,{passive:n}):e.addEventListener(t,l,!1)}function ys(e,t,l,a,n){var u=a;if((t&1)===0&&(t&2)===0&&a!==null)e:for(;;){if(a===null)return;var s=a.tag;if(s===3||s===4){var d=a.stateNode.containerInfo;if(d===n)break;if(s===4)for(s=a.return;s!==null;){var g=s.tag;if((g===3||g===4)&&s.stateNode.containerInfo===n)return;s=s.return}for(;d!==null;){if(s=ea(d),s===null)return;if(g=s.tag,g===5||g===6||g===26||g===27){a=u=s;continue e}d=d.parentNode}}a=a.return}Dr(function(){var C=u,M=Di(l),R=[];e:{var z=io.get(e);if(z!==void 0){var _=au,Z=e;switch(e){case"keypress":if(tu(l)===0)break e;case"keydown":case"keyup":_=$0;break;case"focusin":Z="focus",_=Bi;break;case"focusout":Z="blur",_=Bi;break;case"beforeblur":case"afterblur":_=Bi;break;case"click":if(l.button===2)break e;case"auxclick":case"dblclick":case"mousedown":case"mousemove":case"mouseup":case"mouseout":case"mouseover":case"contextmenu":_=Ur;break;case"drag":case"dragend":case"dragenter":case"dragexit":case"dragleave":case"dragover":case"dragstart":case"drop":_=L0;break;case"touchcancel":case"touchend":case"touchmove":case"touchstart":_=I0;break;case lo:case ao:case no:_=Y0;break;case uo:_=eh;break;case"scroll":case"scrollend":_=U0;break;case"wheel":_=lh;break;case"copy":case"cut":case"paste":_=k0;break;case"gotpointercapture":case"lostpointercapture":case"pointercancel":case"pointerdown":case"pointermove":case"pointerout":case"pointerover":case"pointerup":_=Lr;break;case"toggle":case"beforetoggle":_=nh}var F=(t&4)!==0,je=!F&&(e==="scroll"||e==="scrollend"),E=F?z!==null?z+"Capture":null:z;F=[];for(var S=C,T;S!==null;){var D=S;if(T=D.stateNode,D=D.tag,D!==5&&D!==26&&D!==27||T===null||E===null||(D=Ja(S,E),D!=null&&F.push(An(S,D,T))),je)break;S=S.return}0<F.length&&(z=new _(z,Z,null,l,M),R.push({event:z,listeners:F}))}}if((t&7)===0){e:{if(z=e==="mouseover"||e==="pointerover",_=e==="mouseout"||e==="pointerout",z&&l!==Mi&&(Z=l.relatedTarget||l.fromElement)&&(ea(Z)||Z[Pl]))break e;if((_||z)&&(z=M.window===M?M:(z=M.ownerDocument)?z.defaultView||z.parentWindow:window,_?(Z=l.relatedTarget||l.toElement,_=C,Z=Z?ea(Z):null,Z!==null&&(je=h(Z),F=Z.tag,Z!==je||F!==5&&F!==27&&F!==6)&&(Z=null)):(_=null,Z=C),_!==Z)){if(F=Ur,D="onMouseLeave",E="onMouseEnter",S="mouse",(e==="pointerout"||e==="pointerover")&&(F=Lr,D="onPointerLeave",E="onPointerEnter",S="pointer"),je=_==null?z:Ka(_),T=Z==null?z:Ka(Z),z=new F(D,S+"leave",_,l,M),z.target=je,z.relatedTarget=T,D=null,ea(M)===C&&(F=new F(E,S+"enter",Z,l,M),F.target=T,F.relatedTarget=je,D=F),je=D,_&&Z)t:{for(F=ay,E=_,S=Z,T=0,D=E;D;D=F(D))T++;D=0;for(var $=S;$;$=F($))D++;for(;0<T-D;)E=F(E),T--;for(;0<D-T;)S=F(S),D--;for(;T--;){if(E===S||S!==null&&E===S.alternate){F=E;break t}E=F(E),S=F(S)}F=null}else F=null;_!==null&&wd(R,z,_,F,!1),Z!==null&&je!==null&&wd(R,je,Z,F,!0)}}e:{if(z=C?Ka(C):window,_=z.nodeName&&z.nodeName.toLowerCase(),_==="select"||_==="input"&&z.type==="file")var he=Zr;else if(Xr(z))if(Vr)he=hh;else{he=dh;var K=fh}else _=z.nodeName,!_||_.toLowerCase()!=="input"||z.type!=="checkbox"&&z.type!=="radio"?C&&wi(C.elementType)&&(he=Zr):he=mh;if(he&&(he=he(e,C))){Qr(R,he,l,M);break e}K&&K(e,z,C),e==="focusout"&&C&&z.type==="number"&&C.memoizedProps.value!=null&&_i(z,"number",z.value)}switch(K=C?Ka(C):window,e){case"focusin":(Xr(K)||K.contentEditable==="true")&&(ra=K,Qi=C,ln=null);break;case"focusout":ln=Qi=ra=null;break;case"mousedown":Zi=!0;break;case"contextmenu":case"mouseup":case"dragend":Zi=!1,eo(R,l,M);break;case"selectionchange":if(gh)break;case"keydown":case"keyup":eo(R,l,M)}var ie;if(Yi)e:{switch(e){case"compositionstart":var de="onCompositionStart";break e;case"compositionend":de="onCompositionEnd";break e;case"compositionupdate":de="onCompositionUpdate";break e}de=void 0}else sa?Gr(e,l)&&(de="onCompositionEnd"):e==="keydown"&&l.keyCode===229&&(de="onCompositionStart");de&&(Br&&l.locale!=="ko"&&(sa||de!=="onCompositionStart"?de==="onCompositionEnd"&&sa&&(ie=Rr()):(fl=M,Ui="value"in fl?fl.value:fl.textContent,sa=!0)),K=Ku(C,de),0<K.length&&(de=new Hr(de,e,null,l,M),R.push({event:de,listeners:K}),ie?de.data=ie:(ie=kr(l),ie!==null&&(de.data=ie)))),(ie=ih?ch(e,l):sh(e,l))&&(de=Ku(C,"onBeforeInput"),0<de.length&&(K=new Hr("onBeforeInput","beforeinput",null,l,M),R.push({event:K,listeners:de}),K.data=ie)),Ph(R,e,C,l,M)}Ad(R,t)})}function An(e,t,l){return{instance:e,listener:t,currentTarget:l}}function Ku(e,t){for(var l=t+"Capture",a=[];e!==null;){var n=e,u=n.stateNode;if(n=n.tag,n!==5&&n!==26&&n!==27||u===null||(n=Ja(e,l),n!=null&&a.unshift(An(e,n,u)),n=Ja(e,t),n!=null&&a.push(An(e,n,u))),e.tag===3)return a;e=e.return}return[]}function ay(e){if(e===null)return null;do e=e.return;while(e&&e.tag!==5&&e.tag!==27);return e||null}function wd(e,t,l,a,n){for(var u=t._reactName,s=[];l!==null&&l!==a;){var d=l,g=d.alternate,C=d.stateNode;if(d=d.tag,g!==null&&g===a)break;d!==5&&d!==26&&d!==27||C===null||(g=C,n?(C=Ja(l,u),C!=null&&s.unshift(An(l,C,g))):n||(C=Ja(l,u),C!=null&&s.push(An(l,C,g)))),l=l.return}s.length!==0&&e.push({event:t,listeners:s})}var ny=/\r\n?/g,uy=/\u0000|\uFFFD/g;function Md(e){return(typeof e=="string"?e:""+e).replace(ny,` -`).replace(uy,"")}function Dd(e,t){return t=Md(t),Md(e)===t}function Ne(e,t,l,a,n,u){switch(l){case"children":typeof a=="string"?t==="body"||t==="textarea"&&a===""||ua(e,a):(typeof a=="number"||typeof a=="bigint")&&t!=="body"&&ua(e,""+a);break;case"className":Fn(e,"class",a);break;case"tabIndex":Fn(e,"tabindex",a);break;case"dir":case"role":case"viewBox":case"width":case"height":Fn(e,l,a);break;case"style":wr(e,a,u);break;case"data":if(t!=="object"){Fn(e,"data",a);break}case"src":case"href":if(a===""&&(t!=="a"||l!=="href")){e.removeAttribute(l);break}if(a==null||typeof a=="function"||typeof a=="symbol"||typeof a=="boolean"){e.removeAttribute(l);break}a=Pn(""+a),e.setAttribute(l,a);break;case"action":case"formAction":if(typeof a=="function"){e.setAttribute(l,"javascript:throw new Error('A React form was unexpectedly submitted. If you called form.submit() manually, consider using form.requestSubmit() instead. If you\\'re trying to use event.stopPropagation() in a submit event handler, consider also calling event.preventDefault().')");break}else typeof u=="function"&&(l==="formAction"?(t!=="input"&&Ne(e,t,"name",n.name,n,null),Ne(e,t,"formEncType",n.formEncType,n,null),Ne(e,t,"formMethod",n.formMethod,n,null),Ne(e,t,"formTarget",n.formTarget,n,null)):(Ne(e,t,"encType",n.encType,n,null),Ne(e,t,"method",n.method,n,null),Ne(e,t,"target",n.target,n,null)));if(a==null||typeof a=="symbol"||typeof a=="boolean"){e.removeAttribute(l);break}a=Pn(""+a),e.setAttribute(l,a);break;case"onClick":a!=null&&(e.onclick=Xt);break;case"onScroll":a!=null&&re("scroll",e);break;case"onScrollEnd":a!=null&&re("scrollend",e);break;case"dangerouslySetInnerHTML":if(a!=null){if(typeof a!="object"||!("__html"in a))throw Error(r(61));if(l=a.__html,l!=null){if(n.children!=null)throw Error(r(60));e.innerHTML=l}}break;case"multiple":e.multiple=a&&typeof a!="function"&&typeof a!="symbol";break;case"muted":e.muted=a&&typeof a!="function"&&typeof a!="symbol";break;case"suppressContentEditableWarning":case"suppressHydrationWarning":case"defaultValue":case"defaultChecked":case"innerHTML":case"ref":break;case"autoFocus":break;case"xlinkHref":if(a==null||typeof a=="function"||typeof a=="boolean"||typeof a=="symbol"){e.removeAttribute("xlink:href");break}l=Pn(""+a),e.setAttributeNS("http://www.w3.org/1999/xlink","xlink:href",l);break;case"contentEditable":case"spellCheck":case"draggable":case"value":case"autoReverse":case"externalResourcesRequired":case"focusable":case"preserveAlpha":a!=null&&typeof a!="function"&&typeof a!="symbol"?e.setAttribute(l,""+a):e.removeAttribute(l);break;case"inert":case"allowFullScreen":case"async":case"autoPlay":case"controls":case"default":case"defer":case"disabled":case"disablePictureInPicture":case"disableRemotePlayback":case"formNoValidate":case"hidden":case"loop":case"noModule":case"noValidate":case"open":case"playsInline":case"readOnly":case"required":case"reversed":case"scoped":case"seamless":case"itemScope":a&&typeof a!="function"&&typeof a!="symbol"?e.setAttribute(l,""):e.removeAttribute(l);break;case"capture":case"download":a===!0?e.setAttribute(l,""):a!==!1&&a!=null&&typeof a!="function"&&typeof a!="symbol"?e.setAttribute(l,a):e.removeAttribute(l);break;case"cols":case"rows":case"size":case"span":a!=null&&typeof a!="function"&&typeof a!="symbol"&&!isNaN(a)&&1<=a?e.setAttribute(l,a):e.removeAttribute(l);break;case"rowSpan":case"start":a==null||typeof a=="function"||typeof a=="symbol"||isNaN(a)?e.removeAttribute(l):e.setAttribute(l,a);break;case"popover":re("beforetoggle",e),re("toggle",e),Wn(e,"popover",a);break;case"xlinkActuate":kt(e,"http://www.w3.org/1999/xlink","xlink:actuate",a);break;case"xlinkArcrole":kt(e,"http://www.w3.org/1999/xlink","xlink:arcrole",a);break;case"xlinkRole":kt(e,"http://www.w3.org/1999/xlink","xlink:role",a);break;case"xlinkShow":kt(e,"http://www.w3.org/1999/xlink","xlink:show",a);break;case"xlinkTitle":kt(e,"http://www.w3.org/1999/xlink","xlink:title",a);break;case"xlinkType":kt(e,"http://www.w3.org/1999/xlink","xlink:type",a);break;case"xmlBase":kt(e,"http://www.w3.org/XML/1998/namespace","xml:base",a);break;case"xmlLang":kt(e,"http://www.w3.org/XML/1998/namespace","xml:lang",a);break;case"xmlSpace":kt(e,"http://www.w3.org/XML/1998/namespace","xml:space",a);break;case"is":Wn(e,"is",a);break;case"innerText":case"textContent":break;default:(!(2<l.length)||l[0]!=="o"&&l[0]!=="O"||l[1]!=="n"&&l[1]!=="N")&&(l=R0.get(l)||l,Wn(e,l,a))}}function gs(e,t,l,a,n,u){switch(l){case"style":wr(e,a,u);break;case"dangerouslySetInnerHTML":if(a!=null){if(typeof a!="object"||!("__html"in a))throw Error(r(61));if(l=a.__html,l!=null){if(n.children!=null)throw Error(r(60));e.innerHTML=l}}break;case"children":typeof a=="string"?ua(e,a):(typeof a=="number"||typeof a=="bigint")&&ua(e,""+a);break;case"onScroll":a!=null&&re("scroll",e);break;case"onScrollEnd":a!=null&&re("scrollend",e);break;case"onClick":a!=null&&(e.onclick=Xt);break;case"suppressContentEditableWarning":case"suppressHydrationWarning":case"innerHTML":case"ref":break;case"innerText":case"textContent":break;default:if(!Sr.hasOwnProperty(l))e:{if(l[0]==="o"&&l[1]==="n"&&(n=l.endsWith("Capture"),t=l.slice(2,n?l.length-7:void 0),u=e[tt]||null,u=u!=null?u[l]:null,typeof u=="function"&&e.removeEventListener(t,u,n),typeof a=="function")){typeof u!="function"&&u!==null&&(l in e?e[l]=null:e.hasAttribute(l)&&e.removeAttribute(l)),e.addEventListener(t,a,n);break e}l in e?e[l]=a:a===!0?e.setAttribute(l,""):Wn(e,l,a)}}}function $e(e,t,l){switch(t){case"div":case"span":case"svg":case"path":case"a":case"g":case"p":case"li":break;case"img":re("error",e),re("load",e);var a=!1,n=!1,u;for(u in l)if(l.hasOwnProperty(u)){var s=l[u];if(s!=null)switch(u){case"src":a=!0;break;case"srcSet":n=!0;break;case"children":case"dangerouslySetInnerHTML":throw Error(r(137,t));default:Ne(e,t,u,s,l,null)}}n&&Ne(e,t,"srcSet",l.srcSet,l,null),a&&Ne(e,t,"src",l.src,l,null);return;case"input":re("invalid",e);var d=u=s=n=null,g=null,C=null;for(a in l)if(l.hasOwnProperty(a)){var M=l[a];if(M!=null)switch(a){case"name":n=M;break;case"type":s=M;break;case"checked":g=M;break;case"defaultChecked":C=M;break;case"value":u=M;break;case"defaultValue":d=M;break;case"children":case"dangerouslySetInnerHTML":if(M!=null)throw Error(r(137,t));break;default:Ne(e,t,a,M,l,null)}}Cr(e,u,d,g,C,s,n,!1);return;case"select":re("invalid",e),a=s=u=null;for(n in l)if(l.hasOwnProperty(n)&&(d=l[n],d!=null))switch(n){case"value":u=d;break;case"defaultValue":s=d;break;case"multiple":a=d;default:Ne(e,t,n,d,l,null)}t=u,l=s,e.multiple=!!a,t!=null?na(e,!!a,t,!1):l!=null&&na(e,!!a,l,!0);return;case"textarea":re("invalid",e),u=n=a=null;for(s in l)if(l.hasOwnProperty(s)&&(d=l[s],d!=null))switch(s){case"value":a=d;break;case"defaultValue":n=d;break;case"children":u=d;break;case"dangerouslySetInnerHTML":if(d!=null)throw Error(r(91));break;default:Ne(e,t,s,d,l,null)}Ar(e,a,n,u);return;case"option":for(g in l)if(l.hasOwnProperty(g)&&(a=l[g],a!=null))switch(g){case"selected":e.selected=a&&typeof a!="function"&&typeof a!="symbol";break;default:Ne(e,t,g,a,l,null)}return;case"dialog":re("beforetoggle",e),re("toggle",e),re("cancel",e),re("close",e);break;case"iframe":case"object":re("load",e);break;case"video":case"audio":for(a=0;a<zn.length;a++)re(zn[a],e);break;case"image":re("error",e),re("load",e);break;case"details":re("toggle",e);break;case"embed":case"source":case"link":re("error",e),re("load",e);case"area":case"base":case"br":case"col":case"hr":case"keygen":case"meta":case"param":case"track":case"wbr":case"menuitem":for(C in l)if(l.hasOwnProperty(C)&&(a=l[C],a!=null))switch(C){case"children":case"dangerouslySetInnerHTML":throw Error(r(137,t));default:Ne(e,t,C,a,l,null)}return;default:if(wi(t)){for(M in l)l.hasOwnProperty(M)&&(a=l[M],a!==void 0&&gs(e,t,M,a,l,void 0));return}}for(d in l)l.hasOwnProperty(d)&&(a=l[d],a!=null&&Ne(e,t,d,a,l,null))}function iy(e,t,l,a){switch(t){case"div":case"span":case"svg":case"path":case"a":case"g":case"p":case"li":break;case"input":var n=null,u=null,s=null,d=null,g=null,C=null,M=null;for(_ in l){var R=l[_];if(l.hasOwnProperty(_)&&R!=null)switch(_){case"checked":break;case"value":break;case"defaultValue":g=R;default:a.hasOwnProperty(_)||Ne(e,t,_,null,a,R)}}for(var z in a){var _=a[z];if(R=l[z],a.hasOwnProperty(z)&&(_!=null||R!=null))switch(z){case"type":u=_;break;case"name":n=_;break;case"checked":C=_;break;case"defaultChecked":M=_;break;case"value":s=_;break;case"defaultValue":d=_;break;case"children":case"dangerouslySetInnerHTML":if(_!=null)throw Error(r(137,t));break;default:_!==R&&Ne(e,t,z,_,a,R)}}Ai(e,s,d,g,C,M,u,n);return;case"select":_=s=d=z=null;for(u in l)if(g=l[u],l.hasOwnProperty(u)&&g!=null)switch(u){case"value":break;case"multiple":_=g;default:a.hasOwnProperty(u)||Ne(e,t,u,null,a,g)}for(n in a)if(u=a[n],g=l[n],a.hasOwnProperty(n)&&(u!=null||g!=null))switch(n){case"value":z=u;break;case"defaultValue":d=u;break;case"multiple":s=u;default:u!==g&&Ne(e,t,n,u,a,g)}t=d,l=s,a=_,z!=null?na(e,!!l,z,!1):!!a!=!!l&&(t!=null?na(e,!!l,t,!0):na(e,!!l,l?[]:"",!1));return;case"textarea":_=z=null;for(d in l)if(n=l[d],l.hasOwnProperty(d)&&n!=null&&!a.hasOwnProperty(d))switch(d){case"value":break;case"children":break;default:Ne(e,t,d,null,a,n)}for(s in a)if(n=a[s],u=l[s],a.hasOwnProperty(s)&&(n!=null||u!=null))switch(s){case"value":z=n;break;case"defaultValue":_=n;break;case"children":break;case"dangerouslySetInnerHTML":if(n!=null)throw Error(r(91));break;default:n!==u&&Ne(e,t,s,n,a,u)}zr(e,z,_);return;case"option":for(var Z in l)if(z=l[Z],l.hasOwnProperty(Z)&&z!=null&&!a.hasOwnProperty(Z))switch(Z){case"selected":e.selected=!1;break;default:Ne(e,t,Z,null,a,z)}for(g in a)if(z=a[g],_=l[g],a.hasOwnProperty(g)&&z!==_&&(z!=null||_!=null))switch(g){case"selected":e.selected=z&&typeof z!="function"&&typeof z!="symbol";break;default:Ne(e,t,g,z,a,_)}return;case"img":case"link":case"area":case"base":case"br":case"col":case"embed":case"hr":case"keygen":case"meta":case"param":case"source":case"track":case"wbr":case"menuitem":for(var F in l)z=l[F],l.hasOwnProperty(F)&&z!=null&&!a.hasOwnProperty(F)&&Ne(e,t,F,null,a,z);for(C in a)if(z=a[C],_=l[C],a.hasOwnProperty(C)&&z!==_&&(z!=null||_!=null))switch(C){case"children":case"dangerouslySetInnerHTML":if(z!=null)throw Error(r(137,t));break;default:Ne(e,t,C,z,a,_)}return;default:if(wi(t)){for(var je in l)z=l[je],l.hasOwnProperty(je)&&z!==void 0&&!a.hasOwnProperty(je)&&gs(e,t,je,void 0,a,z);for(M in a)z=a[M],_=l[M],!a.hasOwnProperty(M)||z===_||z===void 0&&_===void 0||gs(e,t,M,z,a,_);return}}for(var E in l)z=l[E],l.hasOwnProperty(E)&&z!=null&&!a.hasOwnProperty(E)&&Ne(e,t,E,null,a,z);for(R in a)z=a[R],_=l[R],!a.hasOwnProperty(R)||z===_||z==null&&_==null||Ne(e,t,R,z,a,_)}function Rd(e){switch(e){case"css":case"script":case"font":case"img":case"image":case"input":case"link":return!0;default:return!1}}function cy(){if(typeof performance.getEntriesByType=="function"){for(var e=0,t=0,l=performance.getEntriesByType("resource"),a=0;a<l.length;a++){var n=l[a],u=n.transferSize,s=n.initiatorType,d=n.duration;if(u&&d&&Rd(s)){for(s=0,d=n.responseEnd,a+=1;a<l.length;a++){var g=l[a],C=g.startTime;if(C>d)break;var M=g.transferSize,R=g.initiatorType;M&&Rd(R)&&(g=g.responseEnd,s+=M*(g<d?1:(d-C)/(g-C)))}if(--a,t+=8*(u+s)/(n.duration/1e3),e++,10<e)break}}if(0<e)return t/e/1e6}return navigator.connection&&(e=navigator.connection.downlink,typeof e=="number")?e:5}var xs=null,ps=null;function Ju(e){return e.nodeType===9?e:e.ownerDocument}function Od(e){switch(e){case"http://www.w3.org/2000/svg":return 1;case"http://www.w3.org/1998/Math/MathML":return 2;default:return 0}}function Ud(e,t){if(e===0)switch(t){case"svg":return 1;case"math":return 2;default:return 0}return e===1&&t==="foreignObject"?0:e}function vs(e,t){return e==="textarea"||e==="noscript"||typeof t.children=="string"||typeof t.children=="number"||typeof t.children=="bigint"||typeof t.dangerouslySetInnerHTML=="object"&&t.dangerouslySetInnerHTML!==null&&t.dangerouslySetInnerHTML.__html!=null}var bs=null;function sy(){var e=window.event;return e&&e.type==="popstate"?e===bs?!1:(bs=e,!0):(bs=null,!1)}var Hd=typeof setTimeout=="function"?setTimeout:void 0,ry=typeof clearTimeout=="function"?clearTimeout:void 0,Ld=typeof Promise=="function"?Promise:void 0,oy=typeof queueMicrotask=="function"?queueMicrotask:typeof Ld<"u"?function(e){return Ld.resolve(null).then(e).catch(fy)}:Hd;function fy(e){setTimeout(function(){throw e})}function Al(e){return e==="head"}function Bd(e,t){var l=t,a=0;do{var n=l.nextSibling;if(e.removeChild(l),n&&n.nodeType===8)if(l=n.data,l==="/$"||l==="/&"){if(a===0){e.removeChild(n),Ha(t);return}a--}else if(l==="$"||l==="$?"||l==="$~"||l==="$!"||l==="&")a++;else if(l==="html")_n(e.ownerDocument.documentElement);else if(l==="head"){l=e.ownerDocument.head,_n(l);for(var u=l.firstChild;u;){var s=u.nextSibling,d=u.nodeName;u[Va]||d==="SCRIPT"||d==="STYLE"||d==="LINK"&&u.rel.toLowerCase()==="stylesheet"||l.removeChild(u),u=s}}else l==="body"&&_n(e.ownerDocument.body);l=n}while(l);Ha(t)}function qd(e,t){var l=e;e=0;do{var a=l.nextSibling;if(l.nodeType===1?t?(l._stashedDisplay=l.style.display,l.style.display="none"):(l.style.display=l._stashedDisplay||"",l.getAttribute("style")===""&&l.removeAttribute("style")):l.nodeType===3&&(t?(l._stashedText=l.nodeValue,l.nodeValue=""):l.nodeValue=l._stashedText||""),a&&a.nodeType===8)if(l=a.data,l==="/$"){if(e===0)break;e--}else l!=="$"&&l!=="$?"&&l!=="$~"&&l!=="$!"||e++;l=a}while(l)}function Ss(e){var t=e.firstChild;for(t&&t.nodeType===10&&(t=t.nextSibling);t;){var l=t;switch(t=t.nextSibling,l.nodeName){case"HTML":case"HEAD":case"BODY":Ss(l),Ci(l);continue;case"SCRIPT":case"STYLE":continue;case"LINK":if(l.rel.toLowerCase()==="stylesheet")continue}e.removeChild(l)}}function dy(e,t,l,a){for(;e.nodeType===1;){var n=l;if(e.nodeName.toLowerCase()!==t.toLowerCase()){if(!a&&(e.nodeName!=="INPUT"||e.type!=="hidden"))break}else if(a){if(!e[Va])switch(t){case"meta":if(!e.hasAttribute("itemprop"))break;return e;case"link":if(u=e.getAttribute("rel"),u==="stylesheet"&&e.hasAttribute("data-precedence"))break;if(u!==n.rel||e.getAttribute("href")!==(n.href==null||n.href===""?null:n.href)||e.getAttribute("crossorigin")!==(n.crossOrigin==null?null:n.crossOrigin)||e.getAttribute("title")!==(n.title==null?null:n.title))break;return e;case"style":if(e.hasAttribute("data-precedence"))break;return e;case"script":if(u=e.getAttribute("src"),(u!==(n.src==null?null:n.src)||e.getAttribute("type")!==(n.type==null?null:n.type)||e.getAttribute("crossorigin")!==(n.crossOrigin==null?null:n.crossOrigin))&&u&&e.hasAttribute("async")&&!e.hasAttribute("itemprop"))break;return e;default:return e}}else if(t==="input"&&e.type==="hidden"){var u=n.name==null?null:""+n.name;if(n.type==="hidden"&&e.getAttribute("name")===u)return e}else return e;if(e=wt(e.nextSibling),e===null)break}return null}function my(e,t,l){if(t==="")return null;for(;e.nodeType!==3;)if((e.nodeType!==1||e.nodeName!=="INPUT"||e.type!=="hidden")&&!l||(e=wt(e.nextSibling),e===null))return null;return e}function Yd(e,t){for(;e.nodeType!==8;)if((e.nodeType!==1||e.nodeName!=="INPUT"||e.type!=="hidden")&&!t||(e=wt(e.nextSibling),e===null))return null;return e}function Ns(e){return e.data==="$?"||e.data==="$~"}function js(e){return e.data==="$!"||e.data==="$?"&&e.ownerDocument.readyState!=="loading"}function hy(e,t){var l=e.ownerDocument;if(e.data==="$~")e._reactRetry=t;else if(e.data!=="$?"||l.readyState!=="loading")t();else{var a=function(){t(),l.removeEventListener("DOMContentLoaded",a)};l.addEventListener("DOMContentLoaded",a),e._reactRetry=a}}function wt(e){for(;e!=null;e=e.nextSibling){var t=e.nodeType;if(t===1||t===3)break;if(t===8){if(t=e.data,t==="$"||t==="$!"||t==="$?"||t==="$~"||t==="&"||t==="F!"||t==="F")break;if(t==="/$"||t==="/&")return null}}return e}var Es=null;function Gd(e){e=e.nextSibling;for(var t=0;e;){if(e.nodeType===8){var l=e.data;if(l==="/$"||l==="/&"){if(t===0)return wt(e.nextSibling);t--}else l!=="$"&&l!=="$!"&&l!=="$?"&&l!=="$~"&&l!=="&"||t++}e=e.nextSibling}return null}function kd(e){e=e.previousSibling;for(var t=0;e;){if(e.nodeType===8){var l=e.data;if(l==="$"||l==="$!"||l==="$?"||l==="$~"||l==="&"){if(t===0)return e;t--}else l!=="/$"&&l!=="/&"||t++}e=e.previousSibling}return null}function Xd(e,t,l){switch(t=Ju(l),e){case"html":if(e=t.documentElement,!e)throw Error(r(452));return e;case"head":if(e=t.head,!e)throw Error(r(453));return e;case"body":if(e=t.body,!e)throw Error(r(454));return e;default:throw Error(r(451))}}function _n(e){for(var t=e.attributes;t.length;)e.removeAttributeNode(t[0]);Ci(e)}var Mt=new Map,Qd=new Set;function $u(e){return typeof e.getRootNode=="function"?e.getRootNode():e.nodeType===9?e:e.ownerDocument}var ul=k.d;k.d={f:yy,r:gy,D:xy,C:py,L:vy,m:by,X:Ny,S:Sy,M:jy};function yy(){var e=ul.f(),t=Yu();return e||t}function gy(e){var t=ta(e);t!==null&&t.tag===5&&t.type==="form"?cf(t):ul.r(e)}var Ra=typeof document>"u"?null:document;function Zd(e,t,l){var a=Ra;if(a&&typeof t=="string"&&t){var n=jt(t);n='link[rel="'+e+'"][href="'+n+'"]',typeof l=="string"&&(n+='[crossorigin="'+l+'"]'),Qd.has(n)||(Qd.add(n),e={rel:e,crossOrigin:l,href:t},a.querySelector(n)===null&&(t=a.createElement("link"),$e(t,"link",e),Xe(t),a.head.appendChild(t)))}}function xy(e){ul.D(e),Zd("dns-prefetch",e,null)}function py(e,t){ul.C(e,t),Zd("preconnect",e,t)}function vy(e,t,l){ul.L(e,t,l);var a=Ra;if(a&&e&&t){var n='link[rel="preload"][as="'+jt(t)+'"]';t==="image"&&l&&l.imageSrcSet?(n+='[imagesrcset="'+jt(l.imageSrcSet)+'"]',typeof l.imageSizes=="string"&&(n+='[imagesizes="'+jt(l.imageSizes)+'"]')):n+='[href="'+jt(e)+'"]';var u=n;switch(t){case"style":u=Oa(e);break;case"script":u=Ua(e)}Mt.has(u)||(e=b({rel:"preload",href:t==="image"&&l&&l.imageSrcSet?void 0:e,as:t},l),Mt.set(u,e),a.querySelector(n)!==null||t==="style"&&a.querySelector(wn(u))||t==="script"&&a.querySelector(Mn(u))||(t=a.createElement("link"),$e(t,"link",e),Xe(t),a.head.appendChild(t)))}}function by(e,t){ul.m(e,t);var l=Ra;if(l&&e){var a=t&&typeof t.as=="string"?t.as:"script",n='link[rel="modulepreload"][as="'+jt(a)+'"][href="'+jt(e)+'"]',u=n;switch(a){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":u=Ua(e)}if(!Mt.has(u)&&(e=b({rel:"modulepreload",href:e},t),Mt.set(u,e),l.querySelector(n)===null)){switch(a){case"audioworklet":case"paintworklet":case"serviceworker":case"sharedworker":case"worker":case"script":if(l.querySelector(Mn(u)))return}a=l.createElement("link"),$e(a,"link",e),Xe(a),l.head.appendChild(a)}}}function Sy(e,t,l){ul.S(e,t,l);var a=Ra;if(a&&e){var n=la(a).hoistableStyles,u=Oa(e);t=t||"default";var s=n.get(u);if(!s){var d={loading:0,preload:null};if(s=a.querySelector(wn(u)))d.loading=5;else{e=b({rel:"stylesheet",href:e,"data-precedence":t},l),(l=Mt.get(u))&&Ts(e,l);var g=s=a.createElement("link");Xe(g),$e(g,"link",e),g._p=new Promise(function(C,M){g.onload=C,g.onerror=M}),g.addEventListener("load",function(){d.loading|=1}),g.addEventListener("error",function(){d.loading|=2}),d.loading|=4,Wu(s,t,a)}s={type:"stylesheet",instance:s,count:1,state:d},n.set(u,s)}}}function Ny(e,t){ul.X(e,t);var l=Ra;if(l&&e){var a=la(l).hoistableScripts,n=Ua(e),u=a.get(n);u||(u=l.querySelector(Mn(n)),u||(e=b({src:e,async:!0},t),(t=Mt.get(n))&&Cs(e,t),u=l.createElement("script"),Xe(u),$e(u,"link",e),l.head.appendChild(u)),u={type:"script",instance:u,count:1,state:null},a.set(n,u))}}function jy(e,t){ul.M(e,t);var l=Ra;if(l&&e){var a=la(l).hoistableScripts,n=Ua(e),u=a.get(n);u||(u=l.querySelector(Mn(n)),u||(e=b({src:e,async:!0,type:"module"},t),(t=Mt.get(n))&&Cs(e,t),u=l.createElement("script"),Xe(u),$e(u,"link",e),l.head.appendChild(u)),u={type:"script",instance:u,count:1,state:null},a.set(n,u))}}function Vd(e,t,l,a){var n=(n=ce.current)?$u(n):null;if(!n)throw Error(r(446));switch(e){case"meta":case"title":return null;case"style":return typeof l.precedence=="string"&&typeof l.href=="string"?(t=Oa(l.href),l=la(n).hoistableStyles,a=l.get(t),a||(a={type:"style",instance:null,count:0,state:null},l.set(t,a)),a):{type:"void",instance:null,count:0,state:null};case"link":if(l.rel==="stylesheet"&&typeof l.href=="string"&&typeof l.precedence=="string"){e=Oa(l.href);var u=la(n).hoistableStyles,s=u.get(e);if(s||(n=n.ownerDocument||n,s={type:"stylesheet",instance:null,count:0,state:{loading:0,preload:null}},u.set(e,s),(u=n.querySelector(wn(e)))&&!u._p&&(s.instance=u,s.state.loading=5),Mt.has(e)||(l={rel:"preload",as:"style",href:l.href,crossOrigin:l.crossOrigin,integrity:l.integrity,media:l.media,hrefLang:l.hrefLang,referrerPolicy:l.referrerPolicy},Mt.set(e,l),u||Ey(n,e,l,s.state))),t&&a===null)throw Error(r(528,""));return s}if(t&&a!==null)throw Error(r(529,""));return null;case"script":return t=l.async,l=l.src,typeof l=="string"&&t&&typeof t!="function"&&typeof t!="symbol"?(t=Ua(l),l=la(n).hoistableScripts,a=l.get(t),a||(a={type:"script",instance:null,count:0,state:null},l.set(t,a)),a):{type:"void",instance:null,count:0,state:null};default:throw Error(r(444,e))}}function Oa(e){return'href="'+jt(e)+'"'}function wn(e){return'link[rel="stylesheet"]['+e+"]"}function Kd(e){return b({},e,{"data-precedence":e.precedence,precedence:null})}function Ey(e,t,l,a){e.querySelector('link[rel="preload"][as="style"]['+t+"]")?a.loading=1:(t=e.createElement("link"),a.preload=t,t.addEventListener("load",function(){return a.loading|=1}),t.addEventListener("error",function(){return a.loading|=2}),$e(t,"link",l),Xe(t),e.head.appendChild(t))}function Ua(e){return'[src="'+jt(e)+'"]'}function Mn(e){return"script[async]"+e}function Jd(e,t,l){if(t.count++,t.instance===null)switch(t.type){case"style":var a=e.querySelector('style[data-href~="'+jt(l.href)+'"]');if(a)return t.instance=a,Xe(a),a;var n=b({},l,{"data-href":l.href,"data-precedence":l.precedence,href:null,precedence:null});return a=(e.ownerDocument||e).createElement("style"),Xe(a),$e(a,"style",n),Wu(a,l.precedence,e),t.instance=a;case"stylesheet":n=Oa(l.href);var u=e.querySelector(wn(n));if(u)return t.state.loading|=4,t.instance=u,Xe(u),u;a=Kd(l),(n=Mt.get(n))&&Ts(a,n),u=(e.ownerDocument||e).createElement("link"),Xe(u);var s=u;return s._p=new Promise(function(d,g){s.onload=d,s.onerror=g}),$e(u,"link",a),t.state.loading|=4,Wu(u,l.precedence,e),t.instance=u;case"script":return u=Ua(l.src),(n=e.querySelector(Mn(u)))?(t.instance=n,Xe(n),n):(a=l,(n=Mt.get(u))&&(a=b({},l),Cs(a,n)),e=e.ownerDocument||e,n=e.createElement("script"),Xe(n),$e(n,"link",a),e.head.appendChild(n),t.instance=n);case"void":return null;default:throw Error(r(443,t.type))}else t.type==="stylesheet"&&(t.state.loading&4)===0&&(a=t.instance,t.state.loading|=4,Wu(a,l.precedence,e));return t.instance}function Wu(e,t,l){for(var a=l.querySelectorAll('link[rel="stylesheet"][data-precedence],style[data-precedence]'),n=a.length?a[a.length-1]:null,u=n,s=0;s<a.length;s++){var d=a[s];if(d.dataset.precedence===t)u=d;else if(u!==n)break}u?u.parentNode.insertBefore(e,u.nextSibling):(t=l.nodeType===9?l.head:l,t.insertBefore(e,t.firstChild))}function Ts(e,t){e.crossOrigin==null&&(e.crossOrigin=t.crossOrigin),e.referrerPolicy==null&&(e.referrerPolicy=t.referrerPolicy),e.title==null&&(e.title=t.title)}function Cs(e,t){e.crossOrigin==null&&(e.crossOrigin=t.crossOrigin),e.referrerPolicy==null&&(e.referrerPolicy=t.referrerPolicy),e.integrity==null&&(e.integrity=t.integrity)}var Fu=null;function $d(e,t,l){if(Fu===null){var a=new Map,n=Fu=new Map;n.set(l,a)}else n=Fu,a=n.get(l),a||(a=new Map,n.set(l,a));if(a.has(e))return a;for(a.set(e,null),l=l.getElementsByTagName(e),n=0;n<l.length;n++){var u=l[n];if(!(u[Va]||u[Ze]||e==="link"&&u.getAttribute("rel")==="stylesheet")&&u.namespaceURI!=="http://www.w3.org/2000/svg"){var s=u.getAttribute(t)||"";s=e+s;var d=a.get(s);d?d.push(u):a.set(s,[u])}}return a}function Wd(e,t,l){e=e.ownerDocument||e,e.head.insertBefore(l,t==="title"?e.querySelector("head > title"):null)}function Ty(e,t,l){if(l===1||t.itemProp!=null)return!1;switch(e){case"meta":case"title":return!0;case"style":if(typeof t.precedence!="string"||typeof t.href!="string"||t.href==="")break;return!0;case"link":if(typeof t.rel!="string"||typeof t.href!="string"||t.href===""||t.onLoad||t.onError)break;switch(t.rel){case"stylesheet":return e=t.disabled,typeof t.precedence=="string"&&e==null;default:return!0}case"script":if(t.async&&typeof t.async!="function"&&typeof t.async!="symbol"&&!t.onLoad&&!t.onError&&t.src&&typeof t.src=="string")return!0}return!1}function Fd(e){return!(e.type==="stylesheet"&&(e.state.loading&3)===0)}function Cy(e,t,l,a){if(l.type==="stylesheet"&&(typeof a.media!="string"||matchMedia(a.media).matches!==!1)&&(l.state.loading&4)===0){if(l.instance===null){var n=Oa(a.href),u=t.querySelector(wn(n));if(u){t=u._p,t!==null&&typeof t=="object"&&typeof t.then=="function"&&(e.count++,e=Iu.bind(e),t.then(e,e)),l.state.loading|=4,l.instance=u,Xe(u);return}u=t.ownerDocument||t,a=Kd(a),(n=Mt.get(n))&&Ts(a,n),u=u.createElement("link"),Xe(u);var s=u;s._p=new Promise(function(d,g){s.onload=d,s.onerror=g}),$e(u,"link",a),l.instance=u}e.stylesheets===null&&(e.stylesheets=new Map),e.stylesheets.set(l,t),(t=l.state.preload)&&(l.state.loading&3)===0&&(e.count++,l=Iu.bind(e),t.addEventListener("load",l),t.addEventListener("error",l))}}var zs=0;function zy(e,t){return e.stylesheets&&e.count===0&&ei(e,e.stylesheets),0<e.count||0<e.imgCount?function(l){var a=setTimeout(function(){if(e.stylesheets&&ei(e,e.stylesheets),e.unsuspend){var u=e.unsuspend;e.unsuspend=null,u()}},6e4+t);0<e.imgBytes&&zs===0&&(zs=62500*cy());var n=setTimeout(function(){if(e.waitingForImages=!1,e.count===0&&(e.stylesheets&&ei(e,e.stylesheets),e.unsuspend)){var u=e.unsuspend;e.unsuspend=null,u()}},(e.imgBytes>zs?50:800)+t);return e.unsuspend=l,function(){e.unsuspend=null,clearTimeout(a),clearTimeout(n)}}:null}function Iu(){if(this.count--,this.count===0&&(this.imgCount===0||!this.waitingForImages)){if(this.stylesheets)ei(this,this.stylesheets);else if(this.unsuspend){var e=this.unsuspend;this.unsuspend=null,e()}}}var Pu=null;function ei(e,t){e.stylesheets=null,e.unsuspend!==null&&(e.count++,Pu=new Map,t.forEach(Ay,e),Pu=null,Iu.call(e))}function Ay(e,t){if(!(t.state.loading&4)){var l=Pu.get(e);if(l)var a=l.get(null);else{l=new Map,Pu.set(e,l);for(var n=e.querySelectorAll("link[data-precedence],style[data-precedence]"),u=0;u<n.length;u++){var s=n[u];(s.nodeName==="LINK"||s.getAttribute("media")!=="not all")&&(l.set(s.dataset.precedence,s),a=s)}a&&l.set(null,a)}n=t.instance,s=n.getAttribute("data-precedence"),u=l.get(s)||a,u===a&&l.set(null,n),l.set(s,n),this.count++,a=Iu.bind(this),n.addEventListener("load",a),n.addEventListener("error",a),u?u.parentNode.insertBefore(n,u.nextSibling):(e=e.nodeType===9?e.head:e,e.insertBefore(n,e.firstChild)),t.state.loading|=4}}var Dn={$$typeof:H,Provider:null,Consumer:null,_currentValue:P,_currentValue2:P,_threadCount:0};function _y(e,t,l,a,n,u,s,d,g){this.tag=1,this.containerInfo=e,this.pingCache=this.current=this.pendingChildren=null,this.timeoutHandle=-1,this.callbackNode=this.next=this.pendingContext=this.context=this.cancelPendingCommit=null,this.callbackPriority=0,this.expirationTimes=Ni(-1),this.entangledLanes=this.shellSuspendCounter=this.errorRecoveryDisabledLanes=this.expiredLanes=this.warmLanes=this.pingedLanes=this.suspendedLanes=this.pendingLanes=0,this.entanglements=Ni(0),this.hiddenUpdates=Ni(null),this.identifierPrefix=a,this.onUncaughtError=n,this.onCaughtError=u,this.onRecoverableError=s,this.pooledCache=null,this.pooledCacheLanes=0,this.formState=g,this.incompleteTransitions=new Map}function Id(e,t,l,a,n,u,s,d,g,C,M,R){return e=new _y(e,t,l,s,g,C,M,R,d),t=1,u===!0&&(t|=24),u=mt(3,null,null,t),e.current=u,u.stateNode=e,t=ic(),t.refCount++,e.pooledCache=t,t.refCount++,u.memoizedState={element:a,isDehydrated:l,cache:t},oc(u),e}function Pd(e){return e?(e=da,e):da}function em(e,t,l,a,n,u){n=Pd(n),a.context===null?a.context=n:a.pendingContext=n,a=xl(t),a.payload={element:l},u=u===void 0?null:u,u!==null&&(a.callback=u),l=pl(e,a,t),l!==null&&(ct(l,e,t),on(l,e,t))}function tm(e,t){if(e=e.memoizedState,e!==null&&e.dehydrated!==null){var l=e.retryLane;e.retryLane=l!==0&&l<t?l:t}}function As(e,t){tm(e,t),(e=e.alternate)&&tm(e,t)}function lm(e){if(e.tag===13||e.tag===31){var t=Yl(e,67108864);t!==null&&ct(t,e,67108864),As(e,67108864)}}function am(e){if(e.tag===13||e.tag===31){var t=pt();t=ji(t);var l=Yl(e,t);l!==null&&ct(l,e,t),As(e,t)}}var ti=!0;function wy(e,t,l,a){var n=w.T;w.T=null;var u=k.p;try{k.p=2,_s(e,t,l,a)}finally{k.p=u,w.T=n}}function My(e,t,l,a){var n=w.T;w.T=null;var u=k.p;try{k.p=8,_s(e,t,l,a)}finally{k.p=u,w.T=n}}function _s(e,t,l,a){if(ti){var n=ws(a);if(n===null)ys(e,t,a,li,l),um(e,a);else if(Ry(n,e,t,l,a))a.stopPropagation();else if(um(e,a),t&4&&-1<Dy.indexOf(e)){for(;n!==null;){var u=ta(n);if(u!==null)switch(u.tag){case 3:if(u=u.stateNode,u.current.memoizedState.isDehydrated){var s=Ul(u.pendingLanes);if(s!==0){var d=u;for(d.pendingLanes|=2,d.entangledLanes|=2;s;){var g=1<<31-ft(s);d.entanglements[1]|=g,s&=~g}Yt(u),(ge&6)===0&&(Bu=rt()+500,Cn(0))}}break;case 31:case 13:d=Yl(u,2),d!==null&&ct(d,u,2),Yu(),As(u,2)}if(u=ws(a),u===null&&ys(e,t,a,li,l),u===n)break;n=u}n!==null&&a.stopPropagation()}else ys(e,t,a,null,l)}}function ws(e){return e=Di(e),Ms(e)}var li=null;function Ms(e){if(li=null,e=ea(e),e!==null){var t=h(e);if(t===null)e=null;else{var l=t.tag;if(l===13){if(e=x(t),e!==null)return e;e=null}else if(l===31){if(e=j(t),e!==null)return e;e=null}else if(l===3){if(t.stateNode.current.memoizedState.isDehydrated)return t.tag===3?t.stateNode.containerInfo:null;e=null}else t!==e&&(e=null)}}return li=e,null}function nm(e){switch(e){case"beforetoggle":case"cancel":case"click":case"close":case"contextmenu":case"copy":case"cut":case"auxclick":case"dblclick":case"dragend":case"dragstart":case"drop":case"focusin":case"focusout":case"input":case"invalid":case"keydown":case"keypress":case"keyup":case"mousedown":case"mouseup":case"paste":case"pause":case"play":case"pointercancel":case"pointerdown":case"pointerup":case"ratechange":case"reset":case"resize":case"seeked":case"submit":case"toggle":case"touchcancel":case"touchend":case"touchstart":case"volumechange":case"change":case"selectionchange":case"textInput":case"compositionstart":case"compositionend":case"compositionupdate":case"beforeblur":case"afterblur":case"beforeinput":case"blur":case"fullscreenchange":case"focus":case"hashchange":case"popstate":case"select":case"selectstart":return 2;case"drag":case"dragenter":case"dragexit":case"dragleave":case"dragover":case"mousemove":case"mouseout":case"mouseover":case"pointermove":case"pointerout":case"pointerover":case"scroll":case"touchmove":case"wheel":case"mouseenter":case"mouseleave":case"pointerenter":case"pointerleave":return 8;case"message":switch(x0()){case or:return 2;case fr:return 8;case Zn:case p0:return 32;case dr:return 268435456;default:return 32}default:return 32}}var Ds=!1,_l=null,wl=null,Ml=null,Rn=new Map,On=new Map,Dl=[],Dy="mousedown mouseup touchcancel touchend touchstart auxclick dblclick pointercancel pointerdown pointerup dragend dragstart drop compositionend compositionstart keydown keypress keyup input textInput copy cut paste click change contextmenu reset".split(" ");function um(e,t){switch(e){case"focusin":case"focusout":_l=null;break;case"dragenter":case"dragleave":wl=null;break;case"mouseover":case"mouseout":Ml=null;break;case"pointerover":case"pointerout":Rn.delete(t.pointerId);break;case"gotpointercapture":case"lostpointercapture":On.delete(t.pointerId)}}function Un(e,t,l,a,n,u){return e===null||e.nativeEvent!==u?(e={blockedOn:t,domEventName:l,eventSystemFlags:a,nativeEvent:u,targetContainers:[n]},t!==null&&(t=ta(t),t!==null&&lm(t)),e):(e.eventSystemFlags|=a,t=e.targetContainers,n!==null&&t.indexOf(n)===-1&&t.push(n),e)}function Ry(e,t,l,a,n){switch(t){case"focusin":return _l=Un(_l,e,t,l,a,n),!0;case"dragenter":return wl=Un(wl,e,t,l,a,n),!0;case"mouseover":return Ml=Un(Ml,e,t,l,a,n),!0;case"pointerover":var u=n.pointerId;return Rn.set(u,Un(Rn.get(u)||null,e,t,l,a,n)),!0;case"gotpointercapture":return u=n.pointerId,On.set(u,Un(On.get(u)||null,e,t,l,a,n)),!0}return!1}function im(e){var t=ea(e.target);if(t!==null){var l=h(t);if(l!==null){if(t=l.tag,t===13){if(t=x(l),t!==null){e.blockedOn=t,pr(e.priority,function(){am(l)});return}}else if(t===31){if(t=j(l),t!==null){e.blockedOn=t,pr(e.priority,function(){am(l)});return}}else if(t===3&&l.stateNode.current.memoizedState.isDehydrated){e.blockedOn=l.tag===3?l.stateNode.containerInfo:null;return}}}e.blockedOn=null}function ai(e){if(e.blockedOn!==null)return!1;for(var t=e.targetContainers;0<t.length;){var l=ws(e.nativeEvent);if(l===null){l=e.nativeEvent;var a=new l.constructor(l.type,l);Mi=a,l.target.dispatchEvent(a),Mi=null}else return t=ta(l),t!==null&&lm(t),e.blockedOn=l,!1;t.shift()}return!0}function cm(e,t,l){ai(e)&&l.delete(t)}function Oy(){Ds=!1,_l!==null&&ai(_l)&&(_l=null),wl!==null&&ai(wl)&&(wl=null),Ml!==null&&ai(Ml)&&(Ml=null),Rn.forEach(cm),On.forEach(cm)}function ni(e,t){e.blockedOn===t&&(e.blockedOn=null,Ds||(Ds=!0,i.unstable_scheduleCallback(i.unstable_NormalPriority,Oy)))}var ui=null;function sm(e){ui!==e&&(ui=e,i.unstable_scheduleCallback(i.unstable_NormalPriority,function(){ui===e&&(ui=null);for(var t=0;t<e.length;t+=3){var l=e[t],a=e[t+1],n=e[t+2];if(typeof a!="function"){if(Ms(a||l)===null)continue;break}var u=ta(l);u!==null&&(e.splice(t,3),t-=3,wc(u,{pending:!0,data:n,method:l.method,action:a},a,n))}}))}function Ha(e){function t(g){return ni(g,e)}_l!==null&&ni(_l,e),wl!==null&&ni(wl,e),Ml!==null&&ni(Ml,e),Rn.forEach(t),On.forEach(t);for(var l=0;l<Dl.length;l++){var a=Dl[l];a.blockedOn===e&&(a.blockedOn=null)}for(;0<Dl.length&&(l=Dl[0],l.blockedOn===null);)im(l),l.blockedOn===null&&Dl.shift();if(l=(e.ownerDocument||e).$$reactFormReplay,l!=null)for(a=0;a<l.length;a+=3){var n=l[a],u=l[a+1],s=n[tt]||null;if(typeof u=="function")s||sm(l);else if(s){var d=null;if(u&&u.hasAttribute("formAction")){if(n=u,s=u[tt]||null)d=s.formAction;else if(Ms(n)!==null)continue}else d=s.action;typeof d=="function"?l[a+1]=d:(l.splice(a,3),a-=3),sm(l)}}}function rm(){function e(u){u.canIntercept&&u.info==="react-transition"&&u.intercept({handler:function(){return new Promise(function(s){return n=s})},focusReset:"manual",scroll:"manual"})}function t(){n!==null&&(n(),n=null),a||setTimeout(l,20)}function l(){if(!a&&!navigation.transition){var u=navigation.currentEntry;u&&u.url!=null&&navigation.navigate(u.url,{state:u.getState(),info:"react-transition",history:"replace"})}}if(typeof navigation=="object"){var a=!1,n=null;return navigation.addEventListener("navigate",e),navigation.addEventListener("navigatesuccess",t),navigation.addEventListener("navigateerror",t),setTimeout(l,100),function(){a=!0,navigation.removeEventListener("navigate",e),navigation.removeEventListener("navigatesuccess",t),navigation.removeEventListener("navigateerror",t),n!==null&&(n(),n=null)}}}function Rs(e){this._internalRoot=e}ii.prototype.render=Rs.prototype.render=function(e){var t=this._internalRoot;if(t===null)throw Error(r(409));var l=t.current,a=pt();em(l,a,e,t,null,null)},ii.prototype.unmount=Rs.prototype.unmount=function(){var e=this._internalRoot;if(e!==null){this._internalRoot=null;var t=e.containerInfo;em(e.current,2,null,e,null,null),Yu(),t[Pl]=null}};function ii(e){this._internalRoot=e}ii.prototype.unstable_scheduleHydration=function(e){if(e){var t=xr();e={blockedOn:null,target:e,priority:t};for(var l=0;l<Dl.length&&t!==0&&t<Dl[l].priority;l++);Dl.splice(l,0,e),l===0&&im(e)}};var om=o.version;if(om!=="19.2.4")throw Error(r(527,om,"19.2.4"));k.findDOMNode=function(e){var t=e._reactInternals;if(t===void 0)throw typeof e.render=="function"?Error(r(188)):(e=Object.keys(e).join(","),Error(r(268,e)));return e=y(t),e=e!==null?A(e):null,e=e===null?null:e.stateNode,e};var Uy={bundleType:0,version:"19.2.4",rendererPackageName:"react-dom",currentDispatcherRef:w,reconcilerVersion:"19.2.4"};if(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__<"u"){var ci=__REACT_DEVTOOLS_GLOBAL_HOOK__;if(!ci.isDisabled&&ci.supportsFiber)try{Xa=ci.inject(Uy),ot=ci}catch{}}return Ln.createRoot=function(e,t){if(!m(e))throw Error(r(299));var l=!1,a="",n=xf,u=pf,s=vf;return t!=null&&(t.unstable_strictMode===!0&&(l=!0),t.identifierPrefix!==void 0&&(a=t.identifierPrefix),t.onUncaughtError!==void 0&&(n=t.onUncaughtError),t.onCaughtError!==void 0&&(u=t.onCaughtError),t.onRecoverableError!==void 0&&(s=t.onRecoverableError)),t=Id(e,1,!1,null,null,l,a,null,n,u,s,rm),e[Pl]=t.current,hs(e),new Rs(t)},Ln.hydrateRoot=function(e,t,l){if(!m(e))throw Error(r(299));var a=!1,n="",u=xf,s=pf,d=vf,g=null;return l!=null&&(l.unstable_strictMode===!0&&(a=!0),l.identifierPrefix!==void 0&&(n=l.identifierPrefix),l.onUncaughtError!==void 0&&(u=l.onUncaughtError),l.onCaughtError!==void 0&&(s=l.onCaughtError),l.onRecoverableError!==void 0&&(d=l.onRecoverableError),l.formState!==void 0&&(g=l.formState)),t=Id(e,1,!0,t,l??null,a,n,g,u,s,d,rm),t.context=Pd(null),l=t.current,a=pt(),a=ji(a),n=xl(a),n.callback=null,pl(l,n,a),l=a,t.current.lanes=l,Za(t,l),Yt(t),e[Pl]=t.current,hs(e),new ii(t)},Ln.version="19.2.4",Ln}var bm;function Ky(){if(bm)return Hs.exports;bm=1;function i(){if(!(typeof __REACT_DEVTOOLS_GLOBAL_HOOK__>"u"||typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE!="function"))try{__REACT_DEVTOOLS_GLOBAL_HOOK__.checkDCE(i)}catch(o){console.error(o)}}return i(),Hs.exports=Vy(),Hs.exports}var Jy=Ky();const $y=_m(Jy);/** - * react-router v7.13.0 - * - * Copyright (c) Remix Software Inc. - * - * This source code is licensed under the MIT license found in the - * LICENSE.md file in the root directory of this source tree. - * - * @license MIT - */var Sm="popstate";function Wy(i={}){function o(r,m){let{pathname:h,search:x,hash:j}=r.location;return Qs("",{pathname:h,search:x,hash:j},m.state&&m.state.usr||null,m.state&&m.state.key||"default")}function f(r,m){return typeof m=="string"?m:Yn(m)}return Iy(o,f,null,i)}function Me(i,o){if(i===!1||i===null||typeof i>"u")throw new Error(o)}function Ut(i,o){if(!i){typeof console<"u"&&console.warn(o);try{throw new Error(o)}catch{}}}function Fy(){return Math.random().toString(36).substring(2,10)}function Nm(i,o){return{usr:i.state,key:i.key,idx:o}}function Qs(i,o,f=null,r){return{pathname:typeof i=="string"?i:i.pathname,search:"",hash:"",...typeof o=="string"?Ba(o):o,state:f,key:o&&o.key||r||Fy()}}function Yn({pathname:i="/",search:o="",hash:f=""}){return o&&o!=="?"&&(i+=o.charAt(0)==="?"?o:"?"+o),f&&f!=="#"&&(i+=f.charAt(0)==="#"?f:"#"+f),i}function Ba(i){let o={};if(i){let f=i.indexOf("#");f>=0&&(o.hash=i.substring(f),i=i.substring(0,f));let r=i.indexOf("?");r>=0&&(o.search=i.substring(r),i=i.substring(0,r)),i&&(o.pathname=i)}return o}function Iy(i,o,f,r={}){let{window:m=document.defaultView,v5Compat:h=!1}=r,x=m.history,j="POP",v=null,y=A();y==null&&(y=0,x.replaceState({...x.state,idx:y},""));function A(){return(x.state||{idx:null}).idx}function b(){j="POP";let B=A(),G=B==null?null:B-y;y=B,v&&v({action:j,location:Y.location,delta:G})}function U(B,G){j="PUSH";let Q=Qs(Y.location,B,G);y=A()+1;let H=Nm(Q,y),ee=Y.createHref(Q);try{x.pushState(H,"",ee)}catch(I){if(I instanceof DOMException&&I.name==="DataCloneError")throw I;m.location.assign(ee)}h&&v&&v({action:j,location:Y.location,delta:1})}function L(B,G){j="REPLACE";let Q=Qs(Y.location,B,G);y=A();let H=Nm(Q,y),ee=Y.createHref(Q);x.replaceState(H,"",ee),h&&v&&v({action:j,location:Y.location,delta:0})}function q(B){return Py(B)}let Y={get action(){return j},get location(){return i(m,x)},listen(B){if(v)throw new Error("A history only accepts one active listener");return m.addEventListener(Sm,b),v=B,()=>{m.removeEventListener(Sm,b),v=null}},createHref(B){return o(m,B)},createURL:q,encodeLocation(B){let G=q(B);return{pathname:G.pathname,search:G.search,hash:G.hash}},push:U,replace:L,go(B){return x.go(B)}};return Y}function Py(i,o=!1){let f="http://localhost";typeof window<"u"&&(f=window.location.origin!=="null"?window.location.origin:window.location.href),Me(f,"No window.location.(origin|href) available to create URL");let r=typeof i=="string"?i:Yn(i);return r=r.replace(/ $/,"%20"),!o&&r.startsWith("//")&&(r=f+r),new URL(r,f)}function Mm(i,o,f="/"){return eg(i,o,f,!1)}function eg(i,o,f,r){let m=typeof o=="string"?Ba(o):o,h=cl(m.pathname||"/",f);if(h==null)return null;let x=Dm(i);tg(x);let j=null;for(let v=0;j==null&&v<x.length;++v){let y=dg(h);j=og(x[v],y,r)}return j}function Dm(i,o=[],f=[],r="",m=!1){let h=(x,j,v=m,y)=>{let A={relativePath:y===void 0?x.path||"":y,caseSensitive:x.caseSensitive===!0,childrenIndex:j,route:x};if(A.relativePath.startsWith("/")){if(!A.relativePath.startsWith(r)&&v)return;Me(A.relativePath.startsWith(r),`Absolute route path "${A.relativePath}" nested under path "${r}" is not valid. An absolute child route path must start with the combined path of all its parent routes.`),A.relativePath=A.relativePath.slice(r.length)}let b=il([r,A.relativePath]),U=f.concat(A);x.children&&x.children.length>0&&(Me(x.index!==!0,`Index routes must not have child routes. Please remove all child routes from route path "${b}".`),Dm(x.children,o,U,b,v)),!(x.path==null&&!x.index)&&o.push({path:b,score:sg(b,x.index),routesMeta:U})};return i.forEach((x,j)=>{var v;if(x.path===""||!((v=x.path)!=null&&v.includes("?")))h(x,j);else for(let y of Rm(x.path))h(x,j,!0,y)}),o}function Rm(i){let o=i.split("/");if(o.length===0)return[];let[f,...r]=o,m=f.endsWith("?"),h=f.replace(/\?$/,"");if(r.length===0)return m?[h,""]:[h];let x=Rm(r.join("/")),j=[];return j.push(...x.map(v=>v===""?h:[h,v].join("/"))),m&&j.push(...x),j.map(v=>i.startsWith("/")&&v===""?"/":v)}function tg(i){i.sort((o,f)=>o.score!==f.score?f.score-o.score:rg(o.routesMeta.map(r=>r.childrenIndex),f.routesMeta.map(r=>r.childrenIndex)))}var lg=/^:[\w-]+$/,ag=3,ng=2,ug=1,ig=10,cg=-2,jm=i=>i==="*";function sg(i,o){let f=i.split("/"),r=f.length;return f.some(jm)&&(r+=cg),o&&(r+=ng),f.filter(m=>!jm(m)).reduce((m,h)=>m+(lg.test(h)?ag:h===""?ug:ig),r)}function rg(i,o){return i.length===o.length&&i.slice(0,-1).every((r,m)=>r===o[m])?i[i.length-1]-o[o.length-1]:0}function og(i,o,f=!1){let{routesMeta:r}=i,m={},h="/",x=[];for(let j=0;j<r.length;++j){let v=r[j],y=j===r.length-1,A=h==="/"?o:o.slice(h.length)||"/",b=fi({path:v.relativePath,caseSensitive:v.caseSensitive,end:y},A),U=v.route;if(!b&&y&&f&&!r[r.length-1].route.index&&(b=fi({path:v.relativePath,caseSensitive:v.caseSensitive,end:!1},A)),!b)return null;Object.assign(m,b.params),x.push({params:m,pathname:il([h,b.pathname]),pathnameBase:gg(il([h,b.pathnameBase])),route:U}),b.pathnameBase!=="/"&&(h=il([h,b.pathnameBase]))}return x}function fi(i,o){typeof i=="string"&&(i={path:i,caseSensitive:!1,end:!0});let[f,r]=fg(i.path,i.caseSensitive,i.end),m=o.match(f);if(!m)return null;let h=m[0],x=h.replace(/(.)\/+$/,"$1"),j=m.slice(1);return{params:r.reduce((y,{paramName:A,isOptional:b},U)=>{if(A==="*"){let q=j[U]||"";x=h.slice(0,h.length-q.length).replace(/(.)\/+$/,"$1")}const L=j[U];return b&&!L?y[A]=void 0:y[A]=(L||"").replace(/%2F/g,"/"),y},{}),pathname:h,pathnameBase:x,pattern:i}}function fg(i,o=!1,f=!0){Ut(i==="*"||!i.endsWith("*")||i.endsWith("/*"),`Route path "${i}" will be treated as if it were "${i.replace(/\*$/,"/*")}" because the \`*\` character must always follow a \`/\` in the pattern. To get rid of this warning, please change the route path to "${i.replace(/\*$/,"/*")}".`);let r=[],m="^"+i.replace(/\/*\*?$/,"").replace(/^\/*/,"/").replace(/[\\.*+^${}|()[\]]/g,"\\$&").replace(/\/:([\w-]+)(\?)?/g,(x,j,v)=>(r.push({paramName:j,isOptional:v!=null}),v?"/?([^\\/]+)?":"/([^\\/]+)")).replace(/\/([\w-]+)\?(\/|$)/g,"(/$1)?$2");return i.endsWith("*")?(r.push({paramName:"*"}),m+=i==="*"||i==="/*"?"(.*)$":"(?:\\/(.+)|\\/*)$"):f?m+="\\/*$":i!==""&&i!=="/"&&(m+="(?:(?=\\/|$))"),[new RegExp(m,o?void 0:"i"),r]}function dg(i){try{return i.split("/").map(o=>decodeURIComponent(o).replace(/\//g,"%2F")).join("/")}catch(o){return Ut(!1,`The URL path "${i}" could not be decoded because it is a malformed URL segment. This is probably due to a bad percent encoding (${o}).`),i}}function cl(i,o){if(o==="/")return i;if(!i.toLowerCase().startsWith(o.toLowerCase()))return null;let f=o.endsWith("/")?o.length-1:o.length,r=i.charAt(f);return r&&r!=="/"?null:i.slice(f)||"/"}var mg=/^(?:[a-z][a-z0-9+.-]*:|\/\/)/i;function hg(i,o="/"){let{pathname:f,search:r="",hash:m=""}=typeof i=="string"?Ba(i):i,h;return f?(f=f.replace(/\/\/+/g,"/"),f.startsWith("/")?h=Em(f.substring(1),"/"):h=Em(f,o)):h=o,{pathname:h,search:xg(r),hash:pg(m)}}function Em(i,o){let f=o.replace(/\/+$/,"").split("/");return i.split("/").forEach(m=>{m===".."?f.length>1&&f.pop():m!=="."&&f.push(m)}),f.length>1?f.join("/"):"/"}function Ys(i,o,f,r){return`Cannot include a '${i}' character in a manually specified \`to.${o}\` field [${JSON.stringify(r)}]. Please separate it out to the \`to.${f}\` field. Alternatively you may provide the full path as a string in <Link to="..."> and the router will parse it for you.`}function yg(i){return i.filter((o,f)=>f===0||o.route.path&&o.route.path.length>0)}function Fs(i){let o=yg(i);return o.map((f,r)=>r===o.length-1?f.pathname:f.pathnameBase)}function Is(i,o,f,r=!1){let m;typeof i=="string"?m=Ba(i):(m={...i},Me(!m.pathname||!m.pathname.includes("?"),Ys("?","pathname","search",m)),Me(!m.pathname||!m.pathname.includes("#"),Ys("#","pathname","hash",m)),Me(!m.search||!m.search.includes("#"),Ys("#","search","hash",m)));let h=i===""||m.pathname==="",x=h?"/":m.pathname,j;if(x==null)j=f;else{let b=o.length-1;if(!r&&x.startsWith("..")){let U=x.split("/");for(;U[0]==="..";)U.shift(),b-=1;m.pathname=U.join("/")}j=b>=0?o[b]:"/"}let v=hg(m,j),y=x&&x!=="/"&&x.endsWith("/"),A=(h||x===".")&&f.endsWith("/");return!v.pathname.endsWith("/")&&(y||A)&&(v.pathname+="/"),v}var il=i=>i.join("/").replace(/\/\/+/g,"/"),gg=i=>i.replace(/\/+$/,"").replace(/^\/*/,"/"),xg=i=>!i||i==="?"?"":i.startsWith("?")?i:"?"+i,pg=i=>!i||i==="#"?"":i.startsWith("#")?i:"#"+i,vg=class{constructor(i,o,f,r=!1){this.status=i,this.statusText=o||"",this.internal=r,f instanceof Error?(this.data=f.toString(),this.error=f):this.data=f}};function bg(i){return i!=null&&typeof i.status=="number"&&typeof i.statusText=="string"&&typeof i.internal=="boolean"&&"data"in i}function Sg(i){return i.map(o=>o.route.path).filter(Boolean).join("/").replace(/\/\/*/g,"/")||"/"}var Om=typeof window<"u"&&typeof window.document<"u"&&typeof window.document.createElement<"u";function Um(i,o){let f=i;if(typeof f!="string"||!mg.test(f))return{absoluteURL:void 0,isExternal:!1,to:f};let r=f,m=!1;if(Om)try{let h=new URL(window.location.href),x=f.startsWith("//")?new URL(h.protocol+f):new URL(f),j=cl(x.pathname,o);x.origin===h.origin&&j!=null?f=j+x.search+x.hash:m=!0}catch{Ut(!1,`<Link to="${f}"> contains an invalid URL which will probably break when clicked - please update to a valid URL path.`)}return{absoluteURL:r,isExternal:m,to:f}}Object.getOwnPropertyNames(Object.prototype).sort().join("\0");var Hm=["POST","PUT","PATCH","DELETE"];new Set(Hm);var Ng=["GET",...Hm];new Set(Ng);var qa=p.createContext(null);qa.displayName="DataRouter";var mi=p.createContext(null);mi.displayName="DataRouterState";var jg=p.createContext(!1),Lm=p.createContext({isTransitioning:!1});Lm.displayName="ViewTransition";var Eg=p.createContext(new Map);Eg.displayName="Fetchers";var Tg=p.createContext(null);Tg.displayName="Await";var bt=p.createContext(null);bt.displayName="Navigation";var kn=p.createContext(null);kn.displayName="Location";var Ht=p.createContext({outlet:null,matches:[],isDataRoute:!1});Ht.displayName="Route";var Ps=p.createContext(null);Ps.displayName="RouteError";var Bm="REACT_ROUTER_ERROR",Cg="REDIRECT",zg="ROUTE_ERROR_RESPONSE";function Ag(i){if(i.startsWith(`${Bm}:${Cg}:{`))try{let o=JSON.parse(i.slice(28));if(typeof o=="object"&&o&&typeof o.status=="number"&&typeof o.statusText=="string"&&typeof o.location=="string"&&typeof o.reloadDocument=="boolean"&&typeof o.replace=="boolean")return o}catch{}}function _g(i){if(i.startsWith(`${Bm}:${zg}:{`))try{let o=JSON.parse(i.slice(40));if(typeof o=="object"&&o&&typeof o.status=="number"&&typeof o.statusText=="string")return new vg(o.status,o.statusText,o.data)}catch{}}function wg(i,{relative:o}={}){Me(Ya(),"useHref() may be used only in the context of a <Router> component.");let{basename:f,navigator:r}=p.useContext(bt),{hash:m,pathname:h,search:x}=Xn(i,{relative:o}),j=h;return f!=="/"&&(j=h==="/"?f:il([f,h])),r.createHref({pathname:j,search:x,hash:m})}function Ya(){return p.useContext(kn)!=null}function sl(){return Me(Ya(),"useLocation() may be used only in the context of a <Router> component."),p.useContext(kn).location}var qm="You should call navigate() in a React.useEffect(), not when your component is first rendered.";function Ym(i){p.useContext(bt).static||p.useLayoutEffect(i)}function Gm(){let{isDataRoute:i}=p.useContext(Ht);return i?Zg():Mg()}function Mg(){Me(Ya(),"useNavigate() may be used only in the context of a <Router> component.");let i=p.useContext(qa),{basename:o,navigator:f}=p.useContext(bt),{matches:r}=p.useContext(Ht),{pathname:m}=sl(),h=JSON.stringify(Fs(r)),x=p.useRef(!1);return Ym(()=>{x.current=!0}),p.useCallback((v,y={})=>{if(Ut(x.current,qm),!x.current)return;if(typeof v=="number"){f.go(v);return}let A=Is(v,JSON.parse(h),m,y.relative==="path");i==null&&o!=="/"&&(A.pathname=A.pathname==="/"?o:il([o,A.pathname])),(y.replace?f.replace:f.push)(A,y.state,y)},[o,f,h,m,i])}var Dg=p.createContext(null);function Rg(i){let o=p.useContext(Ht).outlet;return p.useMemo(()=>o&&p.createElement(Dg.Provider,{value:i},o),[o,i])}function Xn(i,{relative:o}={}){let{matches:f}=p.useContext(Ht),{pathname:r}=sl(),m=JSON.stringify(Fs(f));return p.useMemo(()=>Is(i,JSON.parse(m),r,o==="path"),[i,m,r,o])}function Og(i,o){return km(i,o)}function km(i,o,f,r,m){var Q;Me(Ya(),"useRoutes() may be used only in the context of a <Router> component.");let{navigator:h}=p.useContext(bt),{matches:x}=p.useContext(Ht),j=x[x.length-1],v=j?j.params:{},y=j?j.pathname:"/",A=j?j.pathnameBase:"/",b=j&&j.route;{let H=b&&b.path||"";Qm(y,!b||H.endsWith("*")||H.endsWith("*?"),`You rendered descendant <Routes> (or called \`useRoutes()\`) at "${y}" (under <Route path="${H}">) but the parent route path has no trailing "*". This means if you navigate deeper, the parent won't match anymore and therefore the child routes will never render. - -Please change the parent <Route path="${H}"> to <Route path="${H==="/"?"*":`${H}/*`}">.`)}let U=sl(),L;if(o){let H=typeof o=="string"?Ba(o):o;Me(A==="/"||((Q=H.pathname)==null?void 0:Q.startsWith(A)),`When overriding the location using \`<Routes location>\` or \`useRoutes(routes, location)\`, the location pathname must begin with the portion of the URL pathname that was matched by all parent routes. The current pathname base is "${A}" but pathname "${H.pathname}" was given in the \`location\` prop.`),L=H}else L=U;let q=L.pathname||"/",Y=q;if(A!=="/"){let H=A.replace(/^\//,"").split("/");Y="/"+q.replace(/^\//,"").split("/").slice(H.length).join("/")}let B=Mm(i,{pathname:Y});Ut(b||B!=null,`No routes matched location "${L.pathname}${L.search}${L.hash}" `),Ut(B==null||B[B.length-1].route.element!==void 0||B[B.length-1].route.Component!==void 0||B[B.length-1].route.lazy!==void 0,`Matched leaf route at location "${L.pathname}${L.search}${L.hash}" does not have an element or Component. This means it will render an <Outlet /> with a null value by default resulting in an "empty" page.`);let G=qg(B&&B.map(H=>Object.assign({},H,{params:Object.assign({},v,H.params),pathname:il([A,h.encodeLocation?h.encodeLocation(H.pathname.replace(/\?/g,"%3F").replace(/#/g,"%23")).pathname:H.pathname]),pathnameBase:H.pathnameBase==="/"?A:il([A,h.encodeLocation?h.encodeLocation(H.pathnameBase.replace(/\?/g,"%3F").replace(/#/g,"%23")).pathname:H.pathnameBase])})),x,f,r,m);return o&&G?p.createElement(kn.Provider,{value:{location:{pathname:"/",search:"",hash:"",state:null,key:"default",...L},navigationType:"POP"}},G):G}function Ug(){let i=Qg(),o=bg(i)?`${i.status} ${i.statusText}`:i instanceof Error?i.message:JSON.stringify(i),f=i instanceof Error?i.stack:null,r="rgba(200,200,200, 0.5)",m={padding:"0.5rem",backgroundColor:r},h={padding:"2px 4px",backgroundColor:r},x=null;return console.error("Error handled by React Router default ErrorBoundary:",i),x=p.createElement(p.Fragment,null,p.createElement("p",null,"💿 Hey developer 👋"),p.createElement("p",null,"You can provide a way better UX than this when your app throws errors by providing your own ",p.createElement("code",{style:h},"ErrorBoundary")," or"," ",p.createElement("code",{style:h},"errorElement")," prop on your route.")),p.createElement(p.Fragment,null,p.createElement("h2",null,"Unexpected Application Error!"),p.createElement("h3",{style:{fontStyle:"italic"}},o),f?p.createElement("pre",{style:m},f):null,x)}var Hg=p.createElement(Ug,null),Xm=class extends p.Component{constructor(i){super(i),this.state={location:i.location,revalidation:i.revalidation,error:i.error}}static getDerivedStateFromError(i){return{error:i}}static getDerivedStateFromProps(i,o){return o.location!==i.location||o.revalidation!=="idle"&&i.revalidation==="idle"?{error:i.error,location:i.location,revalidation:i.revalidation}:{error:i.error!==void 0?i.error:o.error,location:o.location,revalidation:i.revalidation||o.revalidation}}componentDidCatch(i,o){this.props.onError?this.props.onError(i,o):console.error("React Router caught the following error during render",i)}render(){let i=this.state.error;if(this.context&&typeof i=="object"&&i&&"digest"in i&&typeof i.digest=="string"){const f=_g(i.digest);f&&(i=f)}let o=i!==void 0?p.createElement(Ht.Provider,{value:this.props.routeContext},p.createElement(Ps.Provider,{value:i,children:this.props.component})):this.props.children;return this.context?p.createElement(Lg,{error:i},o):o}};Xm.contextType=jg;var Gs=new WeakMap;function Lg({children:i,error:o}){let{basename:f}=p.useContext(bt);if(typeof o=="object"&&o&&"digest"in o&&typeof o.digest=="string"){let r=Ag(o.digest);if(r){let m=Gs.get(o);if(m)throw m;let h=Um(r.location,f);if(Om&&!Gs.get(o))if(h.isExternal||r.reloadDocument)window.location.href=h.absoluteURL||h.to;else{const x=Promise.resolve().then(()=>window.__reactRouterDataRouter.navigate(h.to,{replace:r.replace}));throw Gs.set(o,x),x}return p.createElement("meta",{httpEquiv:"refresh",content:`0;url=${h.absoluteURL||h.to}`})}}return i}function Bg({routeContext:i,match:o,children:f}){let r=p.useContext(qa);return r&&r.static&&r.staticContext&&(o.route.errorElement||o.route.ErrorBoundary)&&(r.staticContext._deepestRenderedBoundaryId=o.route.id),p.createElement(Ht.Provider,{value:i},f)}function qg(i,o=[],f=null,r=null,m=null){if(i==null){if(!f)return null;if(f.errors)i=f.matches;else if(o.length===0&&!f.initialized&&f.matches.length>0)i=f.matches;else return null}let h=i,x=f==null?void 0:f.errors;if(x!=null){let A=h.findIndex(b=>b.route.id&&(x==null?void 0:x[b.route.id])!==void 0);Me(A>=0,`Could not find a matching route for errors on route IDs: ${Object.keys(x).join(",")}`),h=h.slice(0,Math.min(h.length,A+1))}let j=!1,v=-1;if(f)for(let A=0;A<h.length;A++){let b=h[A];if((b.route.HydrateFallback||b.route.hydrateFallbackElement)&&(v=A),b.route.id){let{loaderData:U,errors:L}=f,q=b.route.loader&&!U.hasOwnProperty(b.route.id)&&(!L||L[b.route.id]===void 0);if(b.route.lazy||q){j=!0,v>=0?h=h.slice(0,v+1):h=[h[0]];break}}}let y=f&&r?(A,b)=>{var U,L;r(A,{location:f.location,params:((L=(U=f.matches)==null?void 0:U[0])==null?void 0:L.params)??{},unstable_pattern:Sg(f.matches),errorInfo:b})}:void 0;return h.reduceRight((A,b,U)=>{let L,q=!1,Y=null,B=null;f&&(L=x&&b.route.id?x[b.route.id]:void 0,Y=b.route.errorElement||Hg,j&&(v<0&&U===0?(Qm("route-fallback",!1,"No `HydrateFallback` element provided to render during initial hydration"),q=!0,B=null):v===U&&(q=!0,B=b.route.hydrateFallbackElement||null)));let G=o.concat(h.slice(0,U+1)),Q=()=>{let H;return L?H=Y:q?H=B:b.route.Component?H=p.createElement(b.route.Component,null):b.route.element?H=b.route.element:H=A,p.createElement(Bg,{match:b,routeContext:{outlet:A,matches:G,isDataRoute:f!=null},children:H})};return f&&(b.route.ErrorBoundary||b.route.errorElement||U===0)?p.createElement(Xm,{location:f.location,revalidation:f.revalidation,component:Y,error:L,children:Q(),routeContext:{outlet:null,matches:G,isDataRoute:!0},onError:y}):Q()},null)}function er(i){return`${i} must be used within a data router. See https://reactrouter.com/en/main/routers/picking-a-router.`}function Yg(i){let o=p.useContext(qa);return Me(o,er(i)),o}function Gg(i){let o=p.useContext(mi);return Me(o,er(i)),o}function kg(i){let o=p.useContext(Ht);return Me(o,er(i)),o}function tr(i){let o=kg(i),f=o.matches[o.matches.length-1];return Me(f.route.id,`${i} can only be used on routes that contain a unique "id"`),f.route.id}function Xg(){return tr("useRouteId")}function Qg(){var r;let i=p.useContext(Ps),o=Gg("useRouteError"),f=tr("useRouteError");return i!==void 0?i:(r=o.errors)==null?void 0:r[f]}function Zg(){let{router:i}=Yg("useNavigate"),o=tr("useNavigate"),f=p.useRef(!1);return Ym(()=>{f.current=!0}),p.useCallback(async(m,h={})=>{Ut(f.current,qm),f.current&&(typeof m=="number"?await i.navigate(m):await i.navigate(m,{fromRouteId:o,...h}))},[i,o])}var Tm={};function Qm(i,o,f){!o&&!Tm[i]&&(Tm[i]=!0,Ut(!1,f))}p.memo(Vg);function Vg({routes:i,future:o,state:f,onError:r}){return km(i,void 0,f,r,o)}function Kg({to:i,replace:o,state:f,relative:r}){Me(Ya(),"<Navigate> may be used only in the context of a <Router> component.");let{static:m}=p.useContext(bt);Ut(!m,"<Navigate> must not be used on the initial render in a <StaticRouter>. This is a no-op, but you should modify your code so the <Navigate> is only ever rendered in response to some user interaction or state change.");let{matches:h}=p.useContext(Ht),{pathname:x}=sl(),j=Gm(),v=Is(i,Fs(h),x,r==="path"),y=JSON.stringify(v);return p.useEffect(()=>{j(JSON.parse(y),{replace:o,state:f,relative:r})},[j,y,r,o,f]),null}function Jg(i){return Rg(i.context)}function vt(i){Me(!1,"A <Route> is only ever to be used as the child of <Routes> element, never rendered directly. Please wrap your <Route> in a <Routes>.")}function $g({basename:i="/",children:o=null,location:f,navigationType:r="POP",navigator:m,static:h=!1,unstable_useTransitions:x}){Me(!Ya(),"You cannot render a <Router> inside another <Router>. You should never have more than one in your app.");let j=i.replace(/^\/*/,"/"),v=p.useMemo(()=>({basename:j,navigator:m,static:h,unstable_useTransitions:x,future:{}}),[j,m,h,x]);typeof f=="string"&&(f=Ba(f));let{pathname:y="/",search:A="",hash:b="",state:U=null,key:L="default"}=f,q=p.useMemo(()=>{let Y=cl(y,j);return Y==null?null:{location:{pathname:Y,search:A,hash:b,state:U,key:L},navigationType:r}},[j,y,A,b,U,L,r]);return Ut(q!=null,`<Router basename="${j}"> is not able to match the URL "${y}${A}${b}" because it does not start with the basename, so the <Router> won't render anything.`),q==null?null:p.createElement(bt.Provider,{value:v},p.createElement(kn.Provider,{children:o,value:q}))}function Wg({children:i,location:o}){return Og(Zs(i),o)}function Zs(i,o=[]){let f=[];return p.Children.forEach(i,(r,m)=>{if(!p.isValidElement(r))return;let h=[...o,m];if(r.type===p.Fragment){f.push.apply(f,Zs(r.props.children,h));return}Me(r.type===vt,`[${typeof r.type=="string"?r.type:r.type.name}] is not a <Route> component. All component children of <Routes> must be a <Route> or <React.Fragment>`),Me(!r.props.index||!r.props.children,"An index route cannot have child routes.");let x={id:r.props.id||h.join("-"),caseSensitive:r.props.caseSensitive,element:r.props.element,Component:r.props.Component,index:r.props.index,path:r.props.path,middleware:r.props.middleware,loader:r.props.loader,action:r.props.action,hydrateFallbackElement:r.props.hydrateFallbackElement,HydrateFallback:r.props.HydrateFallback,errorElement:r.props.errorElement,ErrorBoundary:r.props.ErrorBoundary,hasErrorBoundary:r.props.hasErrorBoundary===!0||r.props.ErrorBoundary!=null||r.props.errorElement!=null,shouldRevalidate:r.props.shouldRevalidate,handle:r.props.handle,lazy:r.props.lazy};r.props.children&&(x.children=Zs(r.props.children,h)),f.push(x)}),f}var ri="get",oi="application/x-www-form-urlencoded";function hi(i){return typeof HTMLElement<"u"&&i instanceof HTMLElement}function Fg(i){return hi(i)&&i.tagName.toLowerCase()==="button"}function Ig(i){return hi(i)&&i.tagName.toLowerCase()==="form"}function Pg(i){return hi(i)&&i.tagName.toLowerCase()==="input"}function ex(i){return!!(i.metaKey||i.altKey||i.ctrlKey||i.shiftKey)}function tx(i,o){return i.button===0&&(!o||o==="_self")&&!ex(i)}var si=null;function lx(){if(si===null)try{new FormData(document.createElement("form"),0),si=!1}catch{si=!0}return si}var ax=new Set(["application/x-www-form-urlencoded","multipart/form-data","text/plain"]);function ks(i){return i!=null&&!ax.has(i)?(Ut(!1,`"${i}" is not a valid \`encType\` for \`<Form>\`/\`<fetcher.Form>\` and will default to "${oi}"`),null):i}function nx(i,o){let f,r,m,h,x;if(Ig(i)){let j=i.getAttribute("action");r=j?cl(j,o):null,f=i.getAttribute("method")||ri,m=ks(i.getAttribute("enctype"))||oi,h=new FormData(i)}else if(Fg(i)||Pg(i)&&(i.type==="submit"||i.type==="image")){let j=i.form;if(j==null)throw new Error('Cannot submit a <button> or <input type="submit"> without a <form>');let v=i.getAttribute("formaction")||j.getAttribute("action");if(r=v?cl(v,o):null,f=i.getAttribute("formmethod")||j.getAttribute("method")||ri,m=ks(i.getAttribute("formenctype"))||ks(j.getAttribute("enctype"))||oi,h=new FormData(j,i),!lx()){let{name:y,type:A,value:b}=i;if(A==="image"){let U=y?`${y}.`:"";h.append(`${U}x`,"0"),h.append(`${U}y`,"0")}else y&&h.append(y,b)}}else{if(hi(i))throw new Error('Cannot submit element that is not <form>, <button>, or <input type="submit|image">');f=ri,r=null,m=oi,x=i}return h&&m==="text/plain"&&(x=h,h=void 0),{action:r,method:f.toLowerCase(),encType:m,formData:h,body:x}}Object.getOwnPropertyNames(Object.prototype).sort().join("\0");function lr(i,o){if(i===!1||i===null||typeof i>"u")throw new Error(o)}function ux(i,o,f,r){let m=typeof i=="string"?new URL(i,typeof window>"u"?"server://singlefetch/":window.location.origin):i;return f?m.pathname.endsWith("/")?m.pathname=`${m.pathname}_.${r}`:m.pathname=`${m.pathname}.${r}`:m.pathname==="/"?m.pathname=`_root.${r}`:o&&cl(m.pathname,o)==="/"?m.pathname=`${o.replace(/\/$/,"")}/_root.${r}`:m.pathname=`${m.pathname.replace(/\/$/,"")}.${r}`,m}async function ix(i,o){if(i.id in o)return o[i.id];try{let f=await import(i.module);return o[i.id]=f,f}catch(f){return console.error(`Error loading route module \`${i.module}\`, reloading page...`),console.error(f),window.__reactRouterContext&&window.__reactRouterContext.isSpaMode,window.location.reload(),new Promise(()=>{})}}function cx(i){return i==null?!1:i.href==null?i.rel==="preload"&&typeof i.imageSrcSet=="string"&&typeof i.imageSizes=="string":typeof i.rel=="string"&&typeof i.href=="string"}async function sx(i,o,f){let r=await Promise.all(i.map(async m=>{let h=o.routes[m.route.id];if(h){let x=await ix(h,f);return x.links?x.links():[]}return[]}));return dx(r.flat(1).filter(cx).filter(m=>m.rel==="stylesheet"||m.rel==="preload").map(m=>m.rel==="stylesheet"?{...m,rel:"prefetch",as:"style"}:{...m,rel:"prefetch"}))}function Cm(i,o,f,r,m,h){let x=(v,y)=>f[y]?v.route.id!==f[y].route.id:!0,j=(v,y)=>{var A;return f[y].pathname!==v.pathname||((A=f[y].route.path)==null?void 0:A.endsWith("*"))&&f[y].params["*"]!==v.params["*"]};return h==="assets"?o.filter((v,y)=>x(v,y)||j(v,y)):h==="data"?o.filter((v,y)=>{var b;let A=r.routes[v.route.id];if(!A||!A.hasLoader)return!1;if(x(v,y)||j(v,y))return!0;if(v.route.shouldRevalidate){let U=v.route.shouldRevalidate({currentUrl:new URL(m.pathname+m.search+m.hash,window.origin),currentParams:((b=f[0])==null?void 0:b.params)||{},nextUrl:new URL(i,window.origin),nextParams:v.params,defaultShouldRevalidate:!0});if(typeof U=="boolean")return U}return!0}):[]}function rx(i,o,{includeHydrateFallback:f}={}){return ox(i.map(r=>{let m=o.routes[r.route.id];if(!m)return[];let h=[m.module];return m.clientActionModule&&(h=h.concat(m.clientActionModule)),m.clientLoaderModule&&(h=h.concat(m.clientLoaderModule)),f&&m.hydrateFallbackModule&&(h=h.concat(m.hydrateFallbackModule)),m.imports&&(h=h.concat(m.imports)),h}).flat(1))}function ox(i){return[...new Set(i)]}function fx(i){let o={},f=Object.keys(i).sort();for(let r of f)o[r]=i[r];return o}function dx(i,o){let f=new Set;return new Set(o),i.reduce((r,m)=>{let h=JSON.stringify(fx(m));return f.has(h)||(f.add(h),r.push({key:h,link:m})),r},[])}function Zm(){let i=p.useContext(qa);return lr(i,"You must render this element inside a <DataRouterContext.Provider> element"),i}function mx(){let i=p.useContext(mi);return lr(i,"You must render this element inside a <DataRouterStateContext.Provider> element"),i}var ar=p.createContext(void 0);ar.displayName="FrameworkContext";function Vm(){let i=p.useContext(ar);return lr(i,"You must render this element inside a <HydratedRouter> element"),i}function hx(i,o){let f=p.useContext(ar),[r,m]=p.useState(!1),[h,x]=p.useState(!1),{onFocus:j,onBlur:v,onMouseEnter:y,onMouseLeave:A,onTouchStart:b}=o,U=p.useRef(null);p.useEffect(()=>{if(i==="render"&&x(!0),i==="viewport"){let Y=G=>{G.forEach(Q=>{x(Q.isIntersecting)})},B=new IntersectionObserver(Y,{threshold:.5});return U.current&&B.observe(U.current),()=>{B.disconnect()}}},[i]),p.useEffect(()=>{if(r){let Y=setTimeout(()=>{x(!0)},100);return()=>{clearTimeout(Y)}}},[r]);let L=()=>{m(!0)},q=()=>{m(!1),x(!1)};return f?i!=="intent"?[h,U,{}]:[h,U,{onFocus:Bn(j,L),onBlur:Bn(v,q),onMouseEnter:Bn(y,L),onMouseLeave:Bn(A,q),onTouchStart:Bn(b,L)}]:[!1,U,{}]}function Bn(i,o){return f=>{i&&i(f),f.defaultPrevented||o(f)}}function yx({page:i,...o}){let{router:f}=Zm(),r=p.useMemo(()=>Mm(f.routes,i,f.basename),[f.routes,i,f.basename]);return r?p.createElement(xx,{page:i,matches:r,...o}):null}function gx(i){let{manifest:o,routeModules:f}=Vm(),[r,m]=p.useState([]);return p.useEffect(()=>{let h=!1;return sx(i,o,f).then(x=>{h||m(x)}),()=>{h=!0}},[i,o,f]),r}function xx({page:i,matches:o,...f}){let r=sl(),{future:m,manifest:h,routeModules:x}=Vm(),{basename:j}=Zm(),{loaderData:v,matches:y}=mx(),A=p.useMemo(()=>Cm(i,o,y,h,r,"data"),[i,o,y,h,r]),b=p.useMemo(()=>Cm(i,o,y,h,r,"assets"),[i,o,y,h,r]),U=p.useMemo(()=>{if(i===r.pathname+r.search+r.hash)return[];let Y=new Set,B=!1;if(o.forEach(Q=>{var ee;let H=h.routes[Q.route.id];!H||!H.hasLoader||(!A.some(I=>I.route.id===Q.route.id)&&Q.route.id in v&&((ee=x[Q.route.id])!=null&&ee.shouldRevalidate)||H.hasClientLoader?B=!0:Y.add(Q.route.id))}),Y.size===0)return[];let G=ux(i,j,m.unstable_trailingSlashAwareDataRequests,"data");return B&&Y.size>0&&G.searchParams.set("_routes",o.filter(Q=>Y.has(Q.route.id)).map(Q=>Q.route.id).join(",")),[G.pathname+G.search]},[j,m.unstable_trailingSlashAwareDataRequests,v,r,h,A,o,i,x]),L=p.useMemo(()=>rx(b,h),[b,h]),q=gx(b);return p.createElement(p.Fragment,null,U.map(Y=>p.createElement("link",{key:Y,rel:"prefetch",as:"fetch",href:Y,...f})),L.map(Y=>p.createElement("link",{key:Y,rel:"modulepreload",href:Y,...f})),q.map(({key:Y,link:B})=>p.createElement("link",{key:Y,nonce:f.nonce,...B,crossOrigin:B.crossOrigin??f.crossOrigin})))}function px(...i){return o=>{i.forEach(f=>{typeof f=="function"?f(o):f!=null&&(f.current=o)})}}var vx=typeof window<"u"&&typeof window.document<"u"&&typeof window.document.createElement<"u";try{vx&&(window.__reactRouterVersion="7.13.0")}catch{}function bx({basename:i,children:o,unstable_useTransitions:f,window:r}){let m=p.useRef();m.current==null&&(m.current=Wy({window:r,v5Compat:!0}));let h=m.current,[x,j]=p.useState({action:h.action,location:h.location}),v=p.useCallback(y=>{f===!1?j(y):p.startTransition(()=>j(y))},[f]);return p.useLayoutEffect(()=>h.listen(v),[h,v]),p.createElement($g,{basename:i,children:o,location:x.location,navigationType:x.action,navigator:h,unstable_useTransitions:f})}var Km=/^(?:[a-z][a-z0-9+.-]*:|\/\/)/i,Jm=p.forwardRef(function({onClick:o,discover:f="render",prefetch:r="none",relative:m,reloadDocument:h,replace:x,state:j,target:v,to:y,preventScrollReset:A,viewTransition:b,unstable_defaultShouldRevalidate:U,...L},q){let{basename:Y,unstable_useTransitions:B}=p.useContext(bt),G=typeof y=="string"&&Km.test(y),Q=Um(y,Y);y=Q.to;let H=wg(y,{relative:m}),[ee,I,oe]=hx(r,L),W=jx(y,{replace:x,state:j,target:v,preventScrollReset:A,relative:m,viewTransition:b,unstable_defaultShouldRevalidate:U,unstable_useTransitions:B});function J(We){o&&o(We),We.defaultPrevented||W(We)}let Ee=p.createElement("a",{...L,...oe,href:Q.absoluteURL||H,onClick:Q.isExternal||h?o:J,ref:px(q,I),target:v,"data-discover":!G&&f==="render"?"true":void 0});return ee&&!G?p.createElement(p.Fragment,null,Ee,p.createElement(yx,{page:H})):Ee});Jm.displayName="Link";var $m=p.forwardRef(function({"aria-current":o="page",caseSensitive:f=!1,className:r="",end:m=!1,style:h,to:x,viewTransition:j,children:v,...y},A){let b=Xn(x,{relative:y.relative}),U=sl(),L=p.useContext(mi),{navigator:q,basename:Y}=p.useContext(bt),B=L!=null&&Ax(b)&&j===!0,G=q.encodeLocation?q.encodeLocation(b).pathname:b.pathname,Q=U.pathname,H=L&&L.navigation&&L.navigation.location?L.navigation.location.pathname:null;f||(Q=Q.toLowerCase(),H=H?H.toLowerCase():null,G=G.toLowerCase()),H&&Y&&(H=cl(H,Y)||H);const ee=G!=="/"&&G.endsWith("/")?G.length-1:G.length;let I=Q===G||!m&&Q.startsWith(G)&&Q.charAt(ee)==="/",oe=H!=null&&(H===G||!m&&H.startsWith(G)&&H.charAt(G.length)==="/"),W={isActive:I,isPending:oe,isTransitioning:B},J=I?o:void 0,Ee;typeof r=="function"?Ee=r(W):Ee=[r,I?"active":null,oe?"pending":null,B?"transitioning":null].filter(Boolean).join(" ");let We=typeof h=="function"?h(W):h;return p.createElement(Jm,{...y,"aria-current":J,className:Ee,ref:A,style:We,to:x,viewTransition:j},typeof v=="function"?v(W):v)});$m.displayName="NavLink";var Sx=p.forwardRef(({discover:i="render",fetcherKey:o,navigate:f,reloadDocument:r,replace:m,state:h,method:x=ri,action:j,onSubmit:v,relative:y,preventScrollReset:A,viewTransition:b,unstable_defaultShouldRevalidate:U,...L},q)=>{let{unstable_useTransitions:Y}=p.useContext(bt),B=Cx(),G=zx(j,{relative:y}),Q=x.toLowerCase()==="get"?"get":"post",H=typeof j=="string"&&Km.test(j),ee=I=>{if(v&&v(I),I.defaultPrevented)return;I.preventDefault();let oe=I.nativeEvent.submitter,W=(oe==null?void 0:oe.getAttribute("formmethod"))||x,J=()=>B(oe||I.currentTarget,{fetcherKey:o,method:W,navigate:f,replace:m,state:h,relative:y,preventScrollReset:A,viewTransition:b,unstable_defaultShouldRevalidate:U});Y&&f!==!1?p.startTransition(()=>J()):J()};return p.createElement("form",{ref:q,method:Q,action:G,onSubmit:r?v:ee,...L,"data-discover":!H&&i==="render"?"true":void 0})});Sx.displayName="Form";function Nx(i){return`${i} must be used within a data router. See https://reactrouter.com/en/main/routers/picking-a-router.`}function Wm(i){let o=p.useContext(qa);return Me(o,Nx(i)),o}function jx(i,{target:o,replace:f,state:r,preventScrollReset:m,relative:h,viewTransition:x,unstable_defaultShouldRevalidate:j,unstable_useTransitions:v}={}){let y=Gm(),A=sl(),b=Xn(i,{relative:h});return p.useCallback(U=>{if(tx(U,o)){U.preventDefault();let L=f!==void 0?f:Yn(A)===Yn(b),q=()=>y(i,{replace:L,state:r,preventScrollReset:m,relative:h,viewTransition:x,unstable_defaultShouldRevalidate:j});v?p.startTransition(()=>q()):q()}},[A,y,b,f,r,o,i,m,h,x,j,v])}var Ex=0,Tx=()=>`__${String(++Ex)}__`;function Cx(){let{router:i}=Wm("useSubmit"),{basename:o}=p.useContext(bt),f=Xg(),r=i.fetch,m=i.navigate;return p.useCallback(async(h,x={})=>{let{action:j,method:v,encType:y,formData:A,body:b}=nx(h,o);if(x.navigate===!1){let U=x.fetcherKey||Tx();await r(U,f,x.action||j,{unstable_defaultShouldRevalidate:x.unstable_defaultShouldRevalidate,preventScrollReset:x.preventScrollReset,formData:A,body:b,formMethod:x.method||v,formEncType:x.encType||y,flushSync:x.flushSync})}else await m(x.action||j,{unstable_defaultShouldRevalidate:x.unstable_defaultShouldRevalidate,preventScrollReset:x.preventScrollReset,formData:A,body:b,formMethod:x.method||v,formEncType:x.encType||y,replace:x.replace,state:x.state,fromRouteId:f,flushSync:x.flushSync,viewTransition:x.viewTransition})},[r,m,o,f])}function zx(i,{relative:o}={}){let{basename:f}=p.useContext(bt),r=p.useContext(Ht);Me(r,"useFormAction must be used inside a RouteContext");let[m]=r.matches.slice(-1),h={...Xn(i||".",{relative:o})},x=sl();if(i==null){h.search=x.search;let j=new URLSearchParams(h.search),v=j.getAll("index");if(v.some(A=>A==="")){j.delete("index"),v.filter(b=>b).forEach(b=>j.append("index",b));let A=j.toString();h.search=A?`?${A}`:""}}return(!i||i===".")&&m.route.index&&(h.search=h.search?h.search.replace(/^\?/,"?index&"):"?index"),f!=="/"&&(h.pathname=h.pathname==="/"?f:il([f,h.pathname])),Yn(h)}function Ax(i,{relative:o}={}){let f=p.useContext(Lm);Me(f!=null,"`useViewTransitionState` must be used within `react-router-dom`'s `RouterProvider`. Did you accidentally import `RouterProvider` from `react-router`?");let{basename:r}=Wm("useViewTransitionState"),m=Xn(i,{relative:o});if(!f.isTransitioning)return!1;let h=cl(f.currentLocation.pathname,r)||f.currentLocation.pathname,x=cl(f.nextLocation.pathname,r)||f.nextLocation.pathname;return fi(m.pathname,x)!=null||fi(m.pathname,h)!=null}/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const _x=i=>i.replace(/([a-z0-9])([A-Z])/g,"$1-$2").toLowerCase(),Fm=(...i)=>i.filter((o,f,r)=>!!o&&o.trim()!==""&&r.indexOf(o)===f).join(" ").trim();/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */var wx={xmlns:"http://www.w3.org/2000/svg",width:24,height:24,viewBox:"0 0 24 24",fill:"none",stroke:"currentColor",strokeWidth:2,strokeLinecap:"round",strokeLinejoin:"round"};/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Mx=p.forwardRef(({color:i="currentColor",size:o=24,strokeWidth:f=2,absoluteStrokeWidth:r,className:m="",children:h,iconNode:x,...j},v)=>p.createElement("svg",{ref:v,...wx,width:o,height:o,stroke:i,strokeWidth:r?Number(f)*24/Number(o):f,className:Fm("lucide",m),...j},[...x.map(([y,A])=>p.createElement(y,A)),...Array.isArray(h)?h:[h]]));/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const ue=(i,o)=>{const f=p.forwardRef(({className:r,...m},h)=>p.createElement(Mx,{ref:h,iconNode:o,className:Fm(`lucide-${_x(i)}`,r),...m}));return f.displayName=`${i}`,f};/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const di=ue("Activity",[["path",{d:"M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2",key:"169zse"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Dx=ue("ArrowDown",[["path",{d:"M12 5v14",key:"s699le"}],["path",{d:"m19 12-7 7-7-7",key:"1idqje"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Xs=ue("Bot",[["path",{d:"M12 8V4H8",key:"hb8ula"}],["rect",{width:"16",height:"12",x:"4",y:"8",rx:"2",key:"enze0r"}],["path",{d:"M2 14h2",key:"vft8re"}],["path",{d:"M20 14h2",key:"4cs60a"}],["path",{d:"M15 13v2",key:"1xurst"}],["path",{d:"M9 13v2",key:"rq6x2g"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Vs=ue("Brain",[["path",{d:"M12 5a3 3 0 1 0-5.997.125 4 4 0 0 0-2.526 5.77 4 4 0 0 0 .556 6.588A4 4 0 1 0 12 18Z",key:"l5xja"}],["path",{d:"M12 5a3 3 0 1 1 5.997.125 4 4 0 0 1 2.526 5.77 4 4 0 0 1-.556 6.588A4 4 0 1 1 12 18Z",key:"ep3f8r"}],["path",{d:"M15 13a4.5 4.5 0 0 1-3-4 4.5 4.5 0 0 1-3 4",key:"1p4c4q"}],["path",{d:"M17.599 6.5a3 3 0 0 0 .399-1.375",key:"tmeiqw"}],["path",{d:"M6.003 5.125A3 3 0 0 0 6.401 6.5",key:"105sqy"}],["path",{d:"M3.477 10.896a4 4 0 0 1 .585-.396",key:"ql3yin"}],["path",{d:"M19.938 10.5a4 4 0 0 1 .585.396",key:"1qfode"}],["path",{d:"M6 18a4 4 0 0 1-1.967-.516",key:"2e4loj"}],["path",{d:"M19.967 17.484A4 4 0 0 1 18 18",key:"159ez6"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Rx=ue("Check",[["path",{d:"M20 6 9 17l-5-5",key:"1gmf2c"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Ox=ue("ChevronDown",[["path",{d:"m6 9 6 6 6-6",key:"qrunsl"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Ux=ue("ChevronRight",[["path",{d:"m9 18 6-6-6-6",key:"mthhwq"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Im=ue("CircleAlert",[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["line",{x1:"12",x2:"12",y1:"8",y2:"12",key:"1pkeuh"}],["line",{x1:"12",x2:"12.01",y1:"16",y2:"16",key:"4dfq90"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const yi=ue("CircleCheckBig",[["path",{d:"M21.801 10A10 10 0 1 1 17 3.335",key:"yps3ct"}],["path",{d:"m9 11 3 3L22 4",key:"1pflzl"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const nr=ue("CircleX",[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"m15 9-6 6",key:"1uzhvr"}],["path",{d:"m9 9 6 6",key:"z0biqf"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Gn=ue("Clock",[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["polyline",{points:"12 6 12 12 16 14",key:"68esgv"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Hx=ue("Cpu",[["rect",{width:"16",height:"16",x:"4",y:"4",rx:"2",key:"14l7u7"}],["rect",{width:"6",height:"6",x:"9",y:"9",rx:"1",key:"5aljv4"}],["path",{d:"M15 2v2",key:"13l42r"}],["path",{d:"M15 20v2",key:"15mkzm"}],["path",{d:"M2 15h2",key:"1gxd5l"}],["path",{d:"M2 9h2",key:"1bbxkp"}],["path",{d:"M20 15h2",key:"19e6y8"}],["path",{d:"M20 9h2",key:"19tzq7"}],["path",{d:"M9 2v2",key:"165o2o"}],["path",{d:"M9 20v2",key:"i2bqo8"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Lx=ue("Database",[["ellipse",{cx:"12",cy:"5",rx:"9",ry:"3",key:"msslwz"}],["path",{d:"M3 5V19A9 3 0 0 0 21 19V5",key:"1wlel7"}],["path",{d:"M3 12A9 3 0 0 0 21 12",key:"mv7ke4"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const ur=ue("DollarSign",[["line",{x1:"12",x2:"12",y1:"2",y2:"22",key:"7eqyqh"}],["path",{d:"M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6",key:"1b0p4s"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Pm=ue("Filter",[["polygon",{points:"22 3 2 3 10 12.46 10 19 14 21 14 12.46 22 3",key:"1yg77f"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Bx=ue("Globe",[["circle",{cx:"12",cy:"12",r:"10",key:"1mglay"}],["path",{d:"M12 2a14.5 14.5 0 0 0 0 20 14.5 14.5 0 0 0 0-20",key:"13o1zl"}],["path",{d:"M2 12h20",key:"9i4pu4"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const qx=ue("Hash",[["line",{x1:"4",x2:"20",y1:"9",y2:"9",key:"4lhtct"}],["line",{x1:"4",x2:"20",y1:"15",y2:"15",key:"vyu0kd"}],["line",{x1:"10",x2:"8",y1:"3",y2:"21",key:"1ggp8o"}],["line",{x1:"16",x2:"14",y1:"3",y2:"21",key:"weycgp"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Yx=ue("Layers",[["path",{d:"M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z",key:"zw3jo"}],["path",{d:"M2 12a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 12",key:"1wduqc"}],["path",{d:"M2 17a1 1 0 0 0 .58.91l8.6 3.91a2 2 0 0 0 1.65 0l8.58-3.9A1 1 0 0 0 22 17",key:"kqbvx6"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Gx=ue("LayoutDashboard",[["rect",{width:"7",height:"9",x:"3",y:"3",rx:"1",key:"10lvy0"}],["rect",{width:"7",height:"5",x:"14",y:"3",rx:"1",key:"16une8"}],["rect",{width:"7",height:"9",x:"14",y:"12",rx:"1",key:"1hutg5"}],["rect",{width:"7",height:"5",x:"3",y:"16",rx:"1",key:"ldoo1y"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const zm=ue("LoaderCircle",[["path",{d:"M21 12a9 9 0 1 1-6.219-8.56",key:"13zald"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const kx=ue("LogOut",[["path",{d:"M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4",key:"1uf3rs"}],["polyline",{points:"16 17 21 12 16 7",key:"1gabdz"}],["line",{x1:"21",x2:"9",y1:"12",y2:"12",key:"1uyos4"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Xx=ue("MessageSquare",[["path",{d:"M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z",key:"1lielz"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Qx=ue("Package",[["path",{d:"M11 21.73a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73z",key:"1a0edw"}],["path",{d:"M12 22V12",key:"d0xqtd"}],["path",{d:"m3.3 7 7.703 4.734a2 2 0 0 0 1.994 0L20.7 7",key:"yx3hmr"}],["path",{d:"m7.5 4.27 9 5.15",key:"1c824w"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Zx=ue("Pause",[["rect",{x:"14",y:"4",width:"4",height:"16",rx:"1",key:"zuxfzm"}],["rect",{x:"6",y:"4",width:"4",height:"16",rx:"1",key:"1okwgv"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const e0=ue("Play",[["polygon",{points:"6 3 20 12 6 21 6 3",key:"1oa8hb"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const t0=ue("Plus",[["path",{d:"M5 12h14",key:"1ays0h"}],["path",{d:"M12 5v14",key:"s699le"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Ks=ue("Puzzle",[["path",{d:"M15.39 4.39a1 1 0 0 0 1.68-.474 2.5 2.5 0 1 1 3.014 3.015 1 1 0 0 0-.474 1.68l1.683 1.682a2.414 2.414 0 0 1 0 3.414L19.61 15.39a1 1 0 0 1-1.68-.474 2.5 2.5 0 1 0-3.014 3.015 1 1 0 0 1 .474 1.68l-1.683 1.682a2.414 2.414 0 0 1-3.414 0L8.61 19.61a1 1 0 0 0-1.68.474 2.5 2.5 0 1 1-3.014-3.015 1 1 0 0 0 .474-1.68l-1.683-1.682a2.414 2.414 0 0 1 0-3.414L4.39 8.61a1 1 0 0 1 1.68.474 2.5 2.5 0 1 0 3.014-3.015 1 1 0 0 1-.474-1.68l1.683-1.682a2.414 2.414 0 0 1 3.414 0z",key:"w46dr5"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Vx=ue("Radio",[["path",{d:"M4.9 19.1C1 15.2 1 8.8 4.9 4.9",key:"1vaf9d"}],["path",{d:"M7.8 16.2c-2.3-2.3-2.3-6.1 0-8.5",key:"u1ii0m"}],["circle",{cx:"12",cy:"12",r:"2",key:"1c9p78"}],["path",{d:"M16.2 7.8c2.3 2.3 2.3 6.1 0 8.5",key:"1j5fej"}],["path",{d:"M19.1 4.9C23 8.8 23 15.1 19.1 19",key:"10b0cb"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Kx=ue("Save",[["path",{d:"M15.2 3a2 2 0 0 1 1.4.6l3.8 3.8a2 2 0 0 1 .6 1.4V19a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z",key:"1c8476"}],["path",{d:"M17 21v-7a1 1 0 0 0-1-1H8a1 1 0 0 0-1 1v7",key:"1ydtos"}],["path",{d:"M7 3v4a1 1 0 0 0 1 1h7",key:"t51u73"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const l0=ue("Search",[["circle",{cx:"11",cy:"11",r:"8",key:"4ej97u"}],["path",{d:"m21 21-4.3-4.3",key:"1qie3q"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Jx=ue("Send",[["path",{d:"M14.536 21.686a.5.5 0 0 0 .937-.024l6.5-19a.496.496 0 0 0-.635-.635l-19 6.5a.5.5 0 0 0-.024.937l7.93 3.18a2 2 0 0 1 1.112 1.11z",key:"1ffxy3"}],["path",{d:"m21.854 2.147-10.94 10.939",key:"12cjpa"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const a0=ue("Settings",[["path",{d:"M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z",key:"1qme2f"}],["circle",{cx:"12",cy:"12",r:"3",key:"1v7zrd"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const $x=ue("ShieldAlert",[["path",{d:"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",key:"oel41y"}],["path",{d:"M12 8v4",key:"1got3b"}],["path",{d:"M12 16h.01",key:"1drbdi"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Js=ue("Stethoscope",[["path",{d:"M11 2v2",key:"1539x4"}],["path",{d:"M5 2v2",key:"1yf1q8"}],["path",{d:"M5 3H4a2 2 0 0 0-2 2v4a6 6 0 0 0 12 0V5a2 2 0 0 0-2-2h-1",key:"rb5t3r"}],["path",{d:"M8 15a6 6 0 0 0 12 0v-3",key:"x18d4x"}],["circle",{cx:"20",cy:"10",r:"2",key:"ts1r5v"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Wx=ue("Terminal",[["polyline",{points:"4 17 10 11 4 5",key:"akl6gq"}],["line",{x1:"12",x2:"20",y1:"19",y2:"19",key:"q2wloq"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const n0=ue("Trash2",[["path",{d:"M3 6h18",key:"d0wm0j"}],["path",{d:"M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6",key:"4alrt4"}],["path",{d:"M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2",key:"v07s0e"}],["line",{x1:"10",x2:"10",y1:"11",y2:"17",key:"1uufr5"}],["line",{x1:"14",x2:"14",y1:"11",y2:"17",key:"xtxkd"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Fx=ue("TrendingUp",[["polyline",{points:"22 7 13.5 15.5 8.5 10.5 2 17",key:"126l90"}],["polyline",{points:"16 7 22 7 22 13",key:"kwv8wd"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const ir=ue("TriangleAlert",[["path",{d:"m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3",key:"wmoenq"}],["path",{d:"M12 9v4",key:"juzpu7"}],["path",{d:"M12 17h.01",key:"p32p05"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Ix=ue("User",[["path",{d:"M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2",key:"975kel"}],["circle",{cx:"12",cy:"7",r:"4",key:"17ys0d"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const u0=ue("Wrench",[["path",{d:"M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94l-3.76 3.76z",key:"cbrjhi"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const i0=ue("X",[["path",{d:"M18 6 6 18",key:"1bl5f8"}],["path",{d:"m6 6 12 12",key:"d8bk6v"}]]);/** - * @license lucide-react v0.468.0 - ISC - * - * This source code is licensed under the ISC license. - * See the LICENSE file in the root directory of this source tree. - */const Px=ue("Zap",[["path",{d:"M4 14a1 1 0 0 1-.78-1.63l9.9-10.2a.5.5 0 0 1 .86.46l-1.92 6.02A1 1 0 0 0 13 10h7a1 1 0 0 1 .78 1.63l-9.9 10.2a.5.5 0 0 1-.86-.46l1.92-6.02A1 1 0 0 0 11 14z",key:"1xq2db"}]]),cr="zeroclaw_token";function La(){try{return localStorage.getItem(cr)}catch{return null}}function c0(i){try{localStorage.setItem(cr,i)}catch{}}function s0(){try{localStorage.removeItem(cr)}catch{}}function ep(){const i=La();return i!==null&&i.length>0}class tp extends Error{constructor(){super("Unauthorized"),this.name="UnauthorizedError"}}async function st(i,o={}){const f=La(),r=new Headers(o.headers);f&&r.set("Authorization",`Bearer ${f}`),o.body&&typeof o.body=="string"&&!r.has("Content-Type")&&r.set("Content-Type","application/json");const m=await fetch(i,{...o,headers:r});if(m.status===401)throw s0(),window.dispatchEvent(new Event("zeroclaw-unauthorized")),new tp;if(!m.ok){const h=await m.text().catch(()=>"");throw new Error(`API ${m.status}: ${h||m.statusText}`)}if(m.status!==204)return m.json()}function Ga(i,o){if(i!==null&&typeof i=="object"&&!Array.isArray(i)&&o in i){const f=i[o];if(f!==void 0)return f}return i}async function lp(i){const o=await fetch("/pair",{method:"POST",headers:{"X-Pairing-Code":i}});if(!o.ok){const r=await o.text().catch(()=>"");throw new Error(`Pairing failed (${o.status}): ${r||o.statusText}`)}const f=await o.json();return c0(f.token),f}function ap(){return st("/api/status")}function np(){return st("/api/config").then(i=>typeof i=="string"?i:i.content)}function up(i){return st("/api/config",{method:"PUT",headers:{"Content-Type":"application/toml"},body:i})}function ip(){return st("/api/tools").then(i=>Ga(i,"tools"))}function cp(){return st("/api/cron").then(i=>Ga(i,"jobs"))}function sp(i){return st("/api/cron",{method:"POST",body:JSON.stringify(i)}).then(o=>typeof o.job=="object"?o.job:o)}function rp(i){return st(`/api/cron/${encodeURIComponent(i)}`,{method:"DELETE"})}function op(){return st("/api/integrations").then(i=>Ga(i,"integrations"))}function fp(){return st("/api/doctor").then(i=>Array.isArray(i)?i:i.results)}function dp(i,o){const f=new URLSearchParams;i&&f.set("query",i),o&&f.set("category",o);const r=f.toString();return st(`/api/memory${r?`?${r}`:""}`).then(m=>Ga(m,"entries"))}function mp(i,o,f){return st("/api/memory",{method:"POST",body:JSON.stringify({key:i,content:o,category:f})}).then(()=>{})}function hp(i){return st(`/api/memory/${encodeURIComponent(i)}`,{method:"DELETE"})}function r0(){return st("/api/cost").then(i=>Ga(i,"cost"))}function yp(){return st("/api/cli-tools").then(i=>Ga(i,"cli_tools"))}const Am={en:{"nav.dashboard":"Dashboard","nav.agent":"Agent","nav.tools":"Tools","nav.cron":"Scheduled Jobs","nav.integrations":"Integrations","nav.memory":"Memory","nav.config":"Configuration","nav.cost":"Cost Tracker","nav.logs":"Logs","nav.doctor":"Doctor","dashboard.title":"Dashboard","dashboard.provider":"Provider","dashboard.model":"Model","dashboard.uptime":"Uptime","dashboard.temperature":"Temperature","dashboard.gateway_port":"Gateway Port","dashboard.locale":"Locale","dashboard.memory_backend":"Memory Backend","dashboard.paired":"Paired","dashboard.channels":"Channels","dashboard.health":"Health","dashboard.status":"Status","dashboard.overview":"Overview","dashboard.system_info":"System Information","dashboard.quick_actions":"Quick Actions","agent.title":"Agent Chat","agent.send":"Send","agent.placeholder":"Type a message...","agent.connecting":"Connecting...","agent.connected":"Connected","agent.disconnected":"Disconnected","agent.reconnecting":"Reconnecting...","agent.thinking":"Thinking...","agent.tool_call":"Tool Call","agent.tool_result":"Tool Result","tools.title":"Available Tools","tools.name":"Name","tools.description":"Description","tools.parameters":"Parameters","tools.search":"Search tools...","tools.empty":"No tools available.","tools.count":"Total tools","cron.title":"Scheduled Jobs","cron.add":"Add Job","cron.delete":"Delete","cron.enable":"Enable","cron.disable":"Disable","cron.name":"Name","cron.command":"Command","cron.schedule":"Schedule","cron.next_run":"Next Run","cron.last_run":"Last Run","cron.last_status":"Last Status","cron.enabled":"Enabled","cron.empty":"No scheduled jobs.","cron.confirm_delete":"Are you sure you want to delete this job?","integrations.title":"Integrations","integrations.available":"Available","integrations.active":"Active","integrations.coming_soon":"Coming Soon","integrations.category":"Category","integrations.status":"Status","integrations.search":"Search integrations...","integrations.empty":"No integrations found.","integrations.activate":"Activate","integrations.deactivate":"Deactivate","memory.title":"Memory Store","memory.search":"Search memory...","memory.add":"Store Memory","memory.delete":"Delete","memory.key":"Key","memory.content":"Content","memory.category":"Category","memory.timestamp":"Timestamp","memory.session":"Session","memory.score":"Score","memory.empty":"No memory entries found.","memory.confirm_delete":"Are you sure you want to delete this memory entry?","memory.all_categories":"All Categories","config.title":"Configuration","config.save":"Save","config.reset":"Reset","config.saved":"Configuration saved successfully.","config.error":"Failed to save configuration.","config.loading":"Loading configuration...","config.editor_placeholder":"TOML configuration...","cost.title":"Cost Tracker","cost.session":"Session Cost","cost.daily":"Daily Cost","cost.monthly":"Monthly Cost","cost.total_tokens":"Total Tokens","cost.request_count":"Requests","cost.by_model":"Cost by Model","cost.model":"Model","cost.tokens":"Tokens","cost.requests":"Requests","cost.usd":"Cost (USD)","logs.title":"Live Logs","logs.clear":"Clear","logs.pause":"Pause","logs.resume":"Resume","logs.filter":"Filter logs...","logs.empty":"No log entries.","logs.connected":"Connected to event stream.","logs.disconnected":"Disconnected from event stream.","doctor.title":"System Diagnostics","doctor.run":"Run Diagnostics","doctor.running":"Running diagnostics...","doctor.ok":"OK","doctor.warn":"Warning","doctor.error":"Error","doctor.severity":"Severity","doctor.category":"Category","doctor.message":"Message","doctor.empty":"No diagnostics have been run yet.","doctor.summary":"Diagnostic Summary","auth.pair":"Pair Device","auth.pairing_code":"Pairing Code","auth.pair_button":"Pair","auth.logout":"Logout","auth.pairing_success":"Pairing successful!","auth.pairing_failed":"Pairing failed. Please try again.","auth.enter_code":"Enter your pairing code to connect to the agent.","common.loading":"Loading...","common.error":"An error occurred.","common.retry":"Retry","common.cancel":"Cancel","common.confirm":"Confirm","common.save":"Save","common.delete":"Delete","common.edit":"Edit","common.close":"Close","common.yes":"Yes","common.no":"No","common.search":"Search...","common.no_data":"No data available.","common.refresh":"Refresh","common.back":"Back","common.actions":"Actions","common.name":"Name","common.description":"Description","common.status":"Status","common.created":"Created","common.updated":"Updated","health.title":"System Health","health.component":"Component","health.status":"Status","health.last_ok":"Last OK","health.last_error":"Last Error","health.restart_count":"Restarts","health.pid":"Process ID","health.uptime":"Uptime","health.updated_at":"Last Updated"},tr:{"nav.dashboard":"Kontrol Paneli","nav.agent":"Ajan","nav.tools":"Araclar","nav.cron":"Zamanlanmis Gorevler","nav.integrations":"Entegrasyonlar","nav.memory":"Hafiza","nav.config":"Yapilandirma","nav.cost":"Maliyet Takibi","nav.logs":"Kayitlar","nav.doctor":"Doktor","dashboard.title":"Kontrol Paneli","dashboard.provider":"Saglayici","dashboard.model":"Model","dashboard.uptime":"Calisma Suresi","dashboard.temperature":"Sicaklik","dashboard.gateway_port":"Gecit Portu","dashboard.locale":"Yerel Ayar","dashboard.memory_backend":"Hafiza Motoru","dashboard.paired":"Eslestirilmis","dashboard.channels":"Kanallar","dashboard.health":"Saglik","dashboard.status":"Durum","dashboard.overview":"Genel Bakis","dashboard.system_info":"Sistem Bilgisi","dashboard.quick_actions":"Hizli Islemler","agent.title":"Ajan Sohbet","agent.send":"Gonder","agent.placeholder":"Bir mesaj yazin...","agent.connecting":"Baglaniyor...","agent.connected":"Bagli","agent.disconnected":"Baglanti Kesildi","agent.reconnecting":"Yeniden Baglaniyor...","agent.thinking":"Dusunuyor...","agent.tool_call":"Arac Cagrisi","agent.tool_result":"Arac Sonucu","tools.title":"Mevcut Araclar","tools.name":"Ad","tools.description":"Aciklama","tools.parameters":"Parametreler","tools.search":"Arac ara...","tools.empty":"Mevcut arac yok.","tools.count":"Toplam arac","cron.title":"Zamanlanmis Gorevler","cron.add":"Gorev Ekle","cron.delete":"Sil","cron.enable":"Etkinlestir","cron.disable":"Devre Disi Birak","cron.name":"Ad","cron.command":"Komut","cron.schedule":"Zamanlama","cron.next_run":"Sonraki Calistirma","cron.last_run":"Son Calistirma","cron.last_status":"Son Durum","cron.enabled":"Etkin","cron.empty":"Zamanlanmis gorev yok.","cron.confirm_delete":"Bu gorevi silmek istediginizden emin misiniz?","integrations.title":"Entegrasyonlar","integrations.available":"Mevcut","integrations.active":"Aktif","integrations.coming_soon":"Yakinda","integrations.category":"Kategori","integrations.status":"Durum","integrations.search":"Entegrasyon ara...","integrations.empty":"Entegrasyon bulunamadi.","integrations.activate":"Etkinlestir","integrations.deactivate":"Devre Disi Birak","memory.title":"Hafiza Deposu","memory.search":"Hafizada ara...","memory.add":"Hafiza Kaydet","memory.delete":"Sil","memory.key":"Anahtar","memory.content":"Icerik","memory.category":"Kategori","memory.timestamp":"Zaman Damgasi","memory.session":"Oturum","memory.score":"Skor","memory.empty":"Hafiza kaydi bulunamadi.","memory.confirm_delete":"Bu hafiza kaydini silmek istediginizden emin misiniz?","memory.all_categories":"Tum Kategoriler","config.title":"Yapilandirma","config.save":"Kaydet","config.reset":"Sifirla","config.saved":"Yapilandirma basariyla kaydedildi.","config.error":"Yapilandirma kaydedilemedi.","config.loading":"Yapilandirma yukleniyor...","config.editor_placeholder":"TOML yapilandirmasi...","cost.title":"Maliyet Takibi","cost.session":"Oturum Maliyeti","cost.daily":"Gunluk Maliyet","cost.monthly":"Aylik Maliyet","cost.total_tokens":"Toplam Token","cost.request_count":"Istekler","cost.by_model":"Modele Gore Maliyet","cost.model":"Model","cost.tokens":"Token","cost.requests":"Istekler","cost.usd":"Maliyet (USD)","logs.title":"Canli Kayitlar","logs.clear":"Temizle","logs.pause":"Duraklat","logs.resume":"Devam Et","logs.filter":"Kayitlari filtrele...","logs.empty":"Kayit girisi yok.","logs.connected":"Olay akisina baglandi.","logs.disconnected":"Olay akisi baglantisi kesildi.","doctor.title":"Sistem Teshisleri","doctor.run":"Teshis Calistir","doctor.running":"Teshisler calistiriliyor...","doctor.ok":"Tamam","doctor.warn":"Uyari","doctor.error":"Hata","doctor.severity":"Ciddiyet","doctor.category":"Kategori","doctor.message":"Mesaj","doctor.empty":"Henuz teshis calistirilmadi.","doctor.summary":"Teshis Ozeti","auth.pair":"Cihaz Esle","auth.pairing_code":"Eslestirme Kodu","auth.pair_button":"Esle","auth.logout":"Cikis Yap","auth.pairing_success":"Eslestirme basarili!","auth.pairing_failed":"Eslestirme basarisiz. Lutfen tekrar deneyin.","auth.enter_code":"Ajana baglanmak icin eslestirme kodunuzu girin.","common.loading":"Yukleniyor...","common.error":"Bir hata olustu.","common.retry":"Tekrar Dene","common.cancel":"Iptal","common.confirm":"Onayla","common.save":"Kaydet","common.delete":"Sil","common.edit":"Duzenle","common.close":"Kapat","common.yes":"Evet","common.no":"Hayir","common.search":"Ara...","common.no_data":"Veri mevcut degil.","common.refresh":"Yenile","common.back":"Geri","common.actions":"Islemler","common.name":"Ad","common.description":"Aciklama","common.status":"Durum","common.created":"Olusturulma","common.updated":"Guncellenme","health.title":"Sistem Sagligi","health.component":"Bilesen","health.status":"Durum","health.last_ok":"Son Basarili","health.last_error":"Son Hata","health.restart_count":"Yeniden Baslatmalar","health.pid":"Islem Kimligi","health.uptime":"Calisma Suresi","health.updated_at":"Son Guncelleme"}};let o0="en";function gp(i){o0=i}function $s(i){var o;return((o=Am[o0])==null?void 0:o[i])??Am.en[i]??i}const xp=[{to:"/",icon:Gx,labelKey:"nav.dashboard"},{to:"/agent",icon:Xx,labelKey:"nav.agent"},{to:"/tools",icon:u0,labelKey:"nav.tools"},{to:"/cron",icon:Gn,labelKey:"nav.cron"},{to:"/integrations",icon:Ks,labelKey:"nav.integrations"},{to:"/memory",icon:Vs,labelKey:"nav.memory"},{to:"/config",icon:a0,labelKey:"nav.config"},{to:"/cost",icon:ur,labelKey:"nav.cost"},{to:"/logs",icon:di,labelKey:"nav.logs"},{to:"/doctor",icon:Js,labelKey:"nav.doctor"}];function pp(){return c.jsxs("aside",{className:"fixed top-0 left-0 h-screen w-60 bg-gray-900 flex flex-col border-r border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-2 px-5 py-5 border-b border-gray-800",children:[c.jsx("div",{className:"h-8 w-8 rounded-lg bg-blue-600 flex items-center justify-center text-white font-bold text-sm",children:"ZC"}),c.jsx("span",{className:"text-lg font-semibold text-white tracking-wide",children:"ZeroClaw"})]}),c.jsx("nav",{className:"flex-1 overflow-y-auto py-4 px-3 space-y-1",children:xp.map(({to:i,icon:o,labelKey:f})=>c.jsxs($m,{to:i,end:i==="/",className:({isActive:r})=>["flex items-center gap-3 px-3 py-2.5 rounded-lg text-sm font-medium transition-colors",r?"bg-blue-600 text-white":"text-gray-300 hover:bg-gray-800 hover:text-white"].join(" "),children:[c.jsx(o,{className:"h-5 w-5 flex-shrink-0"}),c.jsx("span",{children:$s(f)})]},i))})]})}const f0=p.createContext(null);function vp({children:i}){const[o,f]=p.useState(La),[r,m]=p.useState(ep);p.useEffect(()=>{const v=y=>{if(y.key==="zeroclaw_token"){const A=La();f(A),m(A!==null&&A.length>0)}};return window.addEventListener("storage",v),()=>window.removeEventListener("storage",v)},[]);const h=p.useCallback(async v=>{const{token:y}=await lp(v);c0(y),f(y),m(!0)},[]),x=p.useCallback(()=>{s0(),f(null),m(!1)},[]),j={token:o,isAuthenticated:r,pair:h,logout:x};return wm.createElement(f0.Provider,{value:j},i)}function d0(){const i=p.useContext(f0);if(!i)throw new Error("useAuth must be used within an <AuthProvider>");return i}const bp={"/":"nav.dashboard","/agent":"nav.agent","/tools":"nav.tools","/cron":"nav.cron","/integrations":"nav.integrations","/memory":"nav.memory","/config":"nav.config","/cost":"nav.cost","/logs":"nav.logs","/doctor":"nav.doctor"};function Sp(){const i=sl(),{logout:o}=d0(),{locale:f,setAppLocale:r}=Ip(),m=bp[i.pathname]??"nav.dashboard",h=$s(m),x=()=>{r(f==="en"?"tr":"en")};return c.jsxs("header",{className:"h-14 bg-gray-800 border-b border-gray-700 flex items-center justify-between px-6",children:[c.jsx("h1",{className:"text-lg font-semibold text-white",children:h}),c.jsxs("div",{className:"flex items-center gap-4",children:[c.jsx("button",{type:"button",onClick:x,className:"px-3 py-1 rounded-md text-sm font-medium border border-gray-600 text-gray-300 hover:bg-gray-700 hover:text-white transition-colors",children:f==="en"?"EN":"TR"}),c.jsxs("button",{type:"button",onClick:o,className:"flex items-center gap-1.5 px-3 py-1.5 rounded-md text-sm text-gray-300 hover:bg-gray-700 hover:text-white transition-colors",children:[c.jsx(kx,{className:"h-4 w-4"}),c.jsx("span",{children:$s("auth.logout")})]})]})]})}function Np(){return c.jsxs("div",{className:"min-h-screen bg-gray-950 text-white",children:[c.jsx(pp,{}),c.jsxs("div",{className:"ml-60 flex flex-col min-h-screen",children:[c.jsx(Sp,{}),c.jsx("main",{className:"flex-1 overflow-y-auto",children:c.jsx(Jg,{})})]})]})}function jp(i){const o=Math.floor(i/86400),f=Math.floor(i%86400/3600),r=Math.floor(i%3600/60);return o>0?`${o}d ${f}h ${r}m`:f>0?`${f}h ${r}m`:`${r}m`}function Ep(i){return`$${i.toFixed(4)}`}function Tp(i){switch(i.toLowerCase()){case"ok":case"healthy":return"bg-green-500";case"warn":case"warning":case"degraded":return"bg-yellow-500";default:return"bg-red-500"}}function Cp(i){switch(i.toLowerCase()){case"ok":case"healthy":return"border-green-500/30";case"warn":case"warning":case"degraded":return"border-yellow-500/30";default:return"border-red-500/30"}}function zp(){const[i,o]=p.useState(null),[f,r]=p.useState(null),[m,h]=p.useState(null);if(p.useEffect(()=>{Promise.all([ap(),r0()]).then(([j,v])=>{o(j),r(v)}).catch(j=>h(j.message))},[]),m)return c.jsx("div",{className:"p-6",children:c.jsxs("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-4 text-red-300",children:["Failed to load dashboard: ",m]})});if(!i||!f)return c.jsx("div",{className:"flex items-center justify-center h-64",children:c.jsx("div",{className:"animate-spin rounded-full h-8 w-8 border-2 border-blue-500 border-t-transparent"})});const x=Math.max(f.session_cost_usd,f.daily_cost_usd,f.monthly_cost_usd,.001);return c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4",children:[c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-blue-600/20 rounded-lg",children:c.jsx(Hx,{className:"h-5 w-5 text-blue-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Provider / Model"})]}),c.jsx("p",{className:"text-lg font-semibold text-white truncate",children:i.provider??"Unknown"}),c.jsx("p",{className:"text-sm text-gray-400 truncate",children:i.model})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-green-600/20 rounded-lg",children:c.jsx(Gn,{className:"h-5 w-5 text-green-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Uptime"})]}),c.jsx("p",{className:"text-lg font-semibold text-white",children:jp(i.uptime_seconds)}),c.jsx("p",{className:"text-sm text-gray-400",children:"Since last restart"})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-purple-600/20 rounded-lg",children:c.jsx(Bx,{className:"h-5 w-5 text-purple-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Gateway Port"})]}),c.jsxs("p",{className:"text-lg font-semibold text-white",children:[":",i.gateway_port]}),c.jsxs("p",{className:"text-sm text-gray-400",children:["Locale: ",i.locale]})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-orange-600/20 rounded-lg",children:c.jsx(Lx,{className:"h-5 w-5 text-orange-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Memory Backend"})]}),c.jsx("p",{className:"text-lg font-semibold text-white capitalize",children:i.memory_backend}),c.jsxs("p",{className:"text-sm text-gray-400",children:["Paired: ",i.paired?"Yes":"No"]})]})]}),c.jsxs("div",{className:"grid grid-cols-1 lg:grid-cols-3 gap-6",children:[c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-2 mb-4",children:[c.jsx(ur,{className:"h-5 w-5 text-blue-400"}),c.jsx("h2",{className:"text-base font-semibold text-white",children:"Cost Overview"})]}),c.jsx("div",{className:"space-y-4",children:[{label:"Session",value:f.session_cost_usd,color:"bg-blue-500"},{label:"Daily",value:f.daily_cost_usd,color:"bg-green-500"},{label:"Monthly",value:f.monthly_cost_usd,color:"bg-purple-500"}].map(({label:j,value:v,color:y})=>c.jsxs("div",{children:[c.jsxs("div",{className:"flex justify-between text-sm mb-1",children:[c.jsx("span",{className:"text-gray-400",children:j}),c.jsx("span",{className:"text-white font-medium",children:Ep(v)})]}),c.jsx("div",{className:"w-full h-2 bg-gray-800 rounded-full overflow-hidden",children:c.jsx("div",{className:`h-full rounded-full ${y}`,style:{width:`${Math.max(v/x*100,2)}%`}})})]},j))}),c.jsxs("div",{className:"mt-4 pt-3 border-t border-gray-800 flex justify-between text-sm",children:[c.jsx("span",{className:"text-gray-400",children:"Total Tokens"}),c.jsx("span",{className:"text-white",children:f.total_tokens.toLocaleString()})]}),c.jsxs("div",{className:"flex justify-between text-sm mt-1",children:[c.jsx("span",{className:"text-gray-400",children:"Requests"}),c.jsx("span",{className:"text-white",children:f.request_count.toLocaleString()})]})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-2 mb-4",children:[c.jsx(Vx,{className:"h-5 w-5 text-blue-400"}),c.jsx("h2",{className:"text-base font-semibold text-white",children:"Active Channels"})]}),c.jsx("div",{className:"space-y-2",children:Object.entries(i.channels).length===0?c.jsx("p",{className:"text-sm text-gray-500",children:"No channels configured"}):Object.entries(i.channels).map(([j,v])=>c.jsxs("div",{className:"flex items-center justify-between py-2 px-3 rounded-lg bg-gray-800/50",children:[c.jsx("span",{className:"text-sm text-white capitalize",children:j}),c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx("span",{className:`inline-block h-2.5 w-2.5 rounded-full ${v?"bg-green-500":"bg-gray-500"}`}),c.jsx("span",{className:"text-xs text-gray-400",children:v?"Active":"Inactive"})]})]},j))})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-2 mb-4",children:[c.jsx(di,{className:"h-5 w-5 text-blue-400"}),c.jsx("h2",{className:"text-base font-semibold text-white",children:"Component Health"})]}),c.jsx("div",{className:"grid grid-cols-2 gap-3",children:Object.entries(i.health.components).length===0?c.jsx("p",{className:"text-sm text-gray-500 col-span-2",children:"No components reporting"}):Object.entries(i.health.components).map(([j,v])=>c.jsxs("div",{className:`rounded-lg p-3 border ${Cp(v.status)} bg-gray-800/50`,children:[c.jsxs("div",{className:"flex items-center gap-2 mb-1",children:[c.jsx("span",{className:`inline-block h-2 w-2 rounded-full ${Tp(v.status)}`}),c.jsx("span",{className:"text-sm font-medium text-white capitalize truncate",children:j})]}),c.jsx("p",{className:"text-xs text-gray-400 capitalize",children:v.status}),v.restart_count>0&&c.jsxs("p",{className:"text-xs text-yellow-400 mt-1",children:["Restarts: ",v.restart_count]})]},j))})]})]})]})}const Ap=1e3,_p=3e4;class wp{constructor(o={}){we(this,"ws",null);we(this,"currentDelay");we(this,"reconnectTimer",null);we(this,"intentionallyClosed",!1);we(this,"onMessage",null);we(this,"onOpen",null);we(this,"onClose",null);we(this,"onError",null);we(this,"baseUrl");we(this,"reconnectDelay");we(this,"maxReconnectDelay");we(this,"autoReconnect");const f=window.location.protocol==="https:"?"wss:":"ws:";this.baseUrl=o.baseUrl??`${f}//${window.location.host}`,this.reconnectDelay=o.reconnectDelay??Ap,this.maxReconnectDelay=o.maxReconnectDelay??_p,this.autoReconnect=o.autoReconnect??!0,this.currentDelay=this.reconnectDelay}connect(){this.intentionallyClosed=!1,this.clearReconnectTimer();const o=La(),f=`${this.baseUrl}/ws/chat${o?`?token=${encodeURIComponent(o)}`:""}`;this.ws=new WebSocket(f),this.ws.onopen=()=>{var r;this.currentDelay=this.reconnectDelay,(r=this.onOpen)==null||r.call(this)},this.ws.onmessage=r=>{var m;try{const h=JSON.parse(r.data);(m=this.onMessage)==null||m.call(this,h)}catch{}},this.ws.onclose=r=>{var m;(m=this.onClose)==null||m.call(this,r),this.scheduleReconnect()},this.ws.onerror=r=>{var m;(m=this.onError)==null||m.call(this,r)}}sendMessage(o){if(!this.ws||this.ws.readyState!==WebSocket.OPEN)throw new Error("WebSocket is not connected");this.ws.send(JSON.stringify({type:"message",content:o}))}disconnect(){this.intentionallyClosed=!0,this.clearReconnectTimer(),this.ws&&(this.ws.close(),this.ws=null)}get connected(){var o;return((o=this.ws)==null?void 0:o.readyState)===WebSocket.OPEN}scheduleReconnect(){this.intentionallyClosed||!this.autoReconnect||(this.reconnectTimer=setTimeout(()=>{this.currentDelay=Math.min(this.currentDelay*2,this.maxReconnectDelay),this.connect()},this.currentDelay))}clearReconnectTimer(){this.reconnectTimer!==null&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=null)}}function Mp(){const[i,o]=p.useState([]),[f,r]=p.useState(""),[m,h]=p.useState(!1),[x,j]=p.useState(!1),[v,y]=p.useState(null),A=p.useRef(null),b=p.useRef(null),U=p.useRef(null),L=p.useRef("");p.useEffect(()=>{const B=new wp;return B.onOpen=()=>{j(!0),y(null)},B.onClose=()=>{j(!1)},B.onError=()=>{y("Connection error. Attempting to reconnect...")},B.onMessage=G=>{switch(G.type){case"chunk":h(!0),L.current+=G.content??"";break;case"message":case"done":{const Q=G.full_response??G.content??L.current;Q&&o(H=>[...H,{id:crypto.randomUUID(),role:"agent",content:Q,timestamp:new Date}]),L.current="",h(!1);break}case"tool_call":o(Q=>[...Q,{id:crypto.randomUUID(),role:"agent",content:`[Tool Call] ${G.name??"unknown"}(${JSON.stringify(G.args??{})})`,timestamp:new Date}]);break;case"tool_result":o(Q=>[...Q,{id:crypto.randomUUID(),role:"agent",content:`[Tool Result] ${G.output??""}`,timestamp:new Date}]);break;case"error":o(Q=>[...Q,{id:crypto.randomUUID(),role:"agent",content:`[Error] ${G.message??"Unknown error"}`,timestamp:new Date}]),h(!1),L.current="";break}},B.connect(),A.current=B,()=>{B.disconnect()}},[]),p.useEffect(()=>{var B;(B=b.current)==null||B.scrollIntoView({behavior:"smooth"})},[i,m]);const q=()=>{var G,Q;const B=f.trim();if(!(!B||!((G=A.current)!=null&&G.connected))){o(H=>[...H,{id:crypto.randomUUID(),role:"user",content:B,timestamp:new Date}]);try{A.current.sendMessage(B),h(!0),L.current=""}catch{y("Failed to send message. Please try again.")}r(""),(Q=U.current)==null||Q.focus()}},Y=B=>{B.key==="Enter"&&!B.shiftKey&&(B.preventDefault(),q())};return c.jsxs("div",{className:"flex flex-col h-[calc(100vh-3.5rem)]",children:[v&&c.jsxs("div",{className:"px-4 py-2 bg-red-900/30 border-b border-red-700 flex items-center gap-2 text-sm text-red-300",children:[c.jsx(Im,{className:"h-4 w-4 flex-shrink-0"}),v]}),c.jsxs("div",{className:"flex-1 overflow-y-auto p-4 space-y-4",children:[i.length===0&&c.jsxs("div",{className:"flex flex-col items-center justify-center h-full text-gray-500",children:[c.jsx(Xs,{className:"h-12 w-12 mb-3 text-gray-600"}),c.jsx("p",{className:"text-lg font-medium",children:"ZeroClaw Agent"}),c.jsx("p",{className:"text-sm mt-1",children:"Send a message to start the conversation"})]}),i.map(B=>c.jsxs("div",{className:`flex items-start gap-3 ${B.role==="user"?"flex-row-reverse":""}`,children:[c.jsx("div",{className:`flex-shrink-0 w-8 h-8 rounded-full flex items-center justify-center ${B.role==="user"?"bg-blue-600":"bg-gray-700"}`,children:B.role==="user"?c.jsx(Ix,{className:"h-4 w-4 text-white"}):c.jsx(Xs,{className:"h-4 w-4 text-white"})}),c.jsxs("div",{className:`max-w-[75%] rounded-xl px-4 py-3 ${B.role==="user"?"bg-blue-600 text-white":"bg-gray-800 text-gray-100 border border-gray-700"}`,children:[c.jsx("p",{className:"text-sm whitespace-pre-wrap break-words",children:B.content}),c.jsx("p",{className:`text-xs mt-1 ${B.role==="user"?"text-blue-200":"text-gray-500"}`,children:B.timestamp.toLocaleTimeString()})]})]},B.id)),m&&c.jsxs("div",{className:"flex items-start gap-3",children:[c.jsx("div",{className:"flex-shrink-0 w-8 h-8 rounded-full bg-gray-700 flex items-center justify-center",children:c.jsx(Xs,{className:"h-4 w-4 text-white"})}),c.jsxs("div",{className:"bg-gray-800 border border-gray-700 rounded-xl px-4 py-3",children:[c.jsxs("div",{className:"flex items-center gap-1",children:[c.jsx("span",{className:"w-2 h-2 bg-gray-400 rounded-full animate-bounce",style:{animationDelay:"0ms"}}),c.jsx("span",{className:"w-2 h-2 bg-gray-400 rounded-full animate-bounce",style:{animationDelay:"150ms"}}),c.jsx("span",{className:"w-2 h-2 bg-gray-400 rounded-full animate-bounce",style:{animationDelay:"300ms"}})]}),c.jsx("p",{className:"text-xs text-gray-500 mt-1",children:"Typing..."})]})]}),c.jsx("div",{ref:b})]}),c.jsxs("div",{className:"border-t border-gray-800 bg-gray-900 p-4",children:[c.jsxs("div",{className:"flex items-center gap-3 max-w-4xl mx-auto",children:[c.jsx("div",{className:"flex-1 relative",children:c.jsx("input",{ref:U,type:"text",value:f,onChange:B=>r(B.target.value),onKeyDown:Y,placeholder:x?"Type a message...":"Connecting...",disabled:!x,className:"w-full bg-gray-800 border border-gray-700 rounded-xl px-4 py-3 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent disabled:opacity-50"})}),c.jsx("button",{onClick:q,disabled:!x||!f.trim(),className:"flex-shrink-0 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-700 disabled:text-gray-500 text-white rounded-xl p-3 transition-colors",children:c.jsx(Jx,{className:"h-5 w-5"})})]}),c.jsxs("div",{className:"flex items-center justify-center mt-2 gap-2",children:[c.jsx("span",{className:`inline-block h-2 w-2 rounded-full ${x?"bg-green-500":"bg-red-500"}`}),c.jsx("span",{className:"text-xs text-gray-500",children:x?"Connected":"Disconnected"})]})]})]})}function Dp(){const[i,o]=p.useState([]),[f,r]=p.useState([]),[m,h]=p.useState(""),[x,j]=p.useState(null),[v,y]=p.useState(!0),[A,b]=p.useState(null);p.useEffect(()=>{Promise.all([ip(),yp()]).then(([q,Y])=>{o(q),r(Y)}).catch(q=>b(q.message)).finally(()=>y(!1))},[]);const U=i.filter(q=>q.name.toLowerCase().includes(m.toLowerCase())||q.description.toLowerCase().includes(m.toLowerCase())),L=f.filter(q=>q.name.toLowerCase().includes(m.toLowerCase())||q.category.toLowerCase().includes(m.toLowerCase()));return A?c.jsx("div",{className:"p-6",children:c.jsxs("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-4 text-red-300",children:["Failed to load tools: ",A]})}):v?c.jsx("div",{className:"flex items-center justify-center h-64",children:c.jsx("div",{className:"animate-spin rounded-full h-8 w-8 border-2 border-blue-500 border-t-transparent"})}):c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"relative max-w-md",children:[c.jsx(l0,{className:"absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-gray-500"}),c.jsx("input",{type:"text",value:m,onChange:q=>h(q.target.value),placeholder:"Search tools...",className:"w-full bg-gray-900 border border-gray-700 rounded-lg pl-10 pr-4 py-2.5 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-transparent"})]}),c.jsxs("div",{children:[c.jsxs("div",{className:"flex items-center gap-2 mb-4",children:[c.jsx(u0,{className:"h-5 w-5 text-blue-400"}),c.jsxs("h2",{className:"text-base font-semibold text-white",children:["Agent Tools (",U.length,")"]})]}),U.length===0?c.jsx("p",{className:"text-sm text-gray-500",children:"No tools match your search."}):c.jsx("div",{className:"grid grid-cols-1 md:grid-cols-2 xl:grid-cols-3 gap-4",children:U.map(q=>{const Y=x===q.name;return c.jsxs("div",{className:"bg-gray-900 rounded-xl border border-gray-800 overflow-hidden",children:[c.jsxs("button",{onClick:()=>j(Y?null:q.name),className:"w-full text-left p-4 hover:bg-gray-800/50 transition-colors",children:[c.jsxs("div",{className:"flex items-start justify-between gap-2",children:[c.jsxs("div",{className:"flex items-center gap-2 min-w-0",children:[c.jsx(Qx,{className:"h-4 w-4 text-blue-400 flex-shrink-0 mt-0.5"}),c.jsx("h3",{className:"text-sm font-semibold text-white truncate",children:q.name})]}),Y?c.jsx(Ox,{className:"h-4 w-4 text-gray-400 flex-shrink-0"}):c.jsx(Ux,{className:"h-4 w-4 text-gray-400 flex-shrink-0"})]}),c.jsx("p",{className:"text-sm text-gray-400 mt-2 line-clamp-2",children:q.description})]}),Y&&q.parameters&&c.jsxs("div",{className:"border-t border-gray-800 p-4",children:[c.jsx("p",{className:"text-xs text-gray-500 mb-2 font-medium uppercase tracking-wider",children:"Parameter Schema"}),c.jsx("pre",{className:"text-xs text-gray-300 bg-gray-950 rounded-lg p-3 overflow-x-auto max-h-64 overflow-y-auto",children:JSON.stringify(q.parameters,null,2)})]})]},q.name)})})]}),L.length>0&&c.jsxs("div",{children:[c.jsxs("div",{className:"flex items-center gap-2 mb-4",children:[c.jsx(Wx,{className:"h-5 w-5 text-green-400"}),c.jsxs("h2",{className:"text-base font-semibold text-white",children:["CLI Tools (",L.length,")"]})]}),c.jsx("div",{className:"bg-gray-900 rounded-xl border border-gray-800 overflow-hidden",children:c.jsxs("table",{className:"w-full text-sm",children:[c.jsx("thead",{children:c.jsxs("tr",{className:"border-b border-gray-800",children:[c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Name"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Path"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Version"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Category"})]})}),c.jsx("tbody",{children:L.map(q=>c.jsxs("tr",{className:"border-b border-gray-800/50 hover:bg-gray-800/30 transition-colors",children:[c.jsx("td",{className:"px-4 py-3 text-white font-medium",children:q.name}),c.jsx("td",{className:"px-4 py-3 text-gray-400 font-mono text-xs truncate max-w-[200px]",children:q.path}),c.jsx("td",{className:"px-4 py-3 text-gray-400",children:q.version??"-"}),c.jsx("td",{className:"px-4 py-3",children:c.jsx("span",{className:"inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-gray-800 text-gray-300 capitalize",children:q.category})})]},q.name))})]})})]})]})}function Rp(i){return i?new Date(i).toLocaleString():"-"}function Op(){const[i,o]=p.useState([]),[f,r]=p.useState(!0),[m,h]=p.useState(null),[x,j]=p.useState(!1),[v,y]=p.useState(null),[A,b]=p.useState(""),[U,L]=p.useState(""),[q,Y]=p.useState(""),[B,G]=p.useState(null),[Q,H]=p.useState(!1),ee=()=>{r(!0),cp().then(o).catch(J=>h(J.message)).finally(()=>r(!1))};p.useEffect(()=>{ee()},[]);const I=async()=>{if(!U.trim()||!q.trim()){G("Schedule and command are required.");return}H(!0),G(null);try{const J=await sp({name:A.trim()||void 0,schedule:U.trim(),command:q.trim()});o(Ee=>[...Ee,J]),j(!1),b(""),L(""),Y("")}catch(J){G(J instanceof Error?J.message:"Failed to add job")}finally{H(!1)}},oe=async J=>{try{await rp(J),o(Ee=>Ee.filter(We=>We.id!==J))}catch(Ee){h(Ee instanceof Error?Ee.message:"Failed to delete job")}finally{y(null)}},W=J=>{if(!J)return null;switch(J.toLowerCase()){case"ok":case"success":return c.jsx(yi,{className:"h-4 w-4 text-green-400"});case"error":case"failed":return c.jsx(nr,{className:"h-4 w-4 text-red-400"});default:return c.jsx(Im,{className:"h-4 w-4 text-yellow-400"})}};return m?c.jsx("div",{className:"p-6",children:c.jsxs("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-4 text-red-300",children:["Failed to load cron jobs: ",m]})}):f?c.jsx("div",{className:"flex items-center justify-center h-64",children:c.jsx("div",{className:"animate-spin rounded-full h-8 w-8 border-2 border-blue-500 border-t-transparent"})}):c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"flex items-center justify-between",children:[c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(Gn,{className:"h-5 w-5 text-blue-400"}),c.jsxs("h2",{className:"text-base font-semibold text-white",children:["Scheduled Tasks (",i.length,")"]})]}),c.jsxs("button",{onClick:()=>j(!0),className:"flex items-center gap-2 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-4 py-2 rounded-lg transition-colors",children:[c.jsx(t0,{className:"h-4 w-4"}),"Add Job"]})]}),x&&c.jsx("div",{className:"fixed inset-0 bg-black/60 flex items-center justify-center z-50",children:c.jsxs("div",{className:"bg-gray-900 border border-gray-700 rounded-xl p-6 w-full max-w-md mx-4",children:[c.jsxs("div",{className:"flex items-center justify-between mb-4",children:[c.jsx("h3",{className:"text-lg font-semibold text-white",children:"Add Cron Job"}),c.jsx("button",{onClick:()=>{j(!1),G(null)},className:"text-gray-400 hover:text-white transition-colors",children:c.jsx(i0,{className:"h-5 w-5"})})]}),B&&c.jsx("div",{className:"mb-4 rounded-lg bg-red-900/30 border border-red-700 p-3 text-sm text-red-300",children:B}),c.jsxs("div",{className:"space-y-4",children:[c.jsxs("div",{children:[c.jsx("label",{className:"block text-sm font-medium text-gray-300 mb-1",children:"Name (optional)"}),c.jsx("input",{type:"text",value:A,onChange:J=>b(J.target.value),placeholder:"e.g. Daily cleanup",className:"w-full bg-gray-800 border border-gray-700 rounded-lg px-3 py-2 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"})]}),c.jsxs("div",{children:[c.jsxs("label",{className:"block text-sm font-medium text-gray-300 mb-1",children:["Schedule ",c.jsx("span",{className:"text-red-400",children:"*"})]}),c.jsx("input",{type:"text",value:U,onChange:J=>L(J.target.value),placeholder:"e.g. 0 0 * * * (cron expression)",className:"w-full bg-gray-800 border border-gray-700 rounded-lg px-3 py-2 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"})]}),c.jsxs("div",{children:[c.jsxs("label",{className:"block text-sm font-medium text-gray-300 mb-1",children:["Command ",c.jsx("span",{className:"text-red-400",children:"*"})]}),c.jsx("input",{type:"text",value:q,onChange:J=>Y(J.target.value),placeholder:"e.g. cleanup --older-than 7d",className:"w-full bg-gray-800 border border-gray-700 rounded-lg px-3 py-2 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"})]})]}),c.jsxs("div",{className:"flex justify-end gap-3 mt-6",children:[c.jsx("button",{onClick:()=>{j(!1),G(null)},className:"px-4 py-2 text-sm font-medium text-gray-300 hover:text-white border border-gray-700 rounded-lg hover:bg-gray-800 transition-colors",children:"Cancel"}),c.jsx("button",{onClick:I,disabled:Q,className:"px-4 py-2 text-sm font-medium text-white bg-blue-600 hover:bg-blue-700 rounded-lg transition-colors disabled:opacity-50",children:Q?"Adding...":"Add Job"})]})]})}),i.length===0?c.jsxs("div",{className:"bg-gray-900 rounded-xl border border-gray-800 p-8 text-center",children:[c.jsx(Gn,{className:"h-10 w-10 text-gray-600 mx-auto mb-3"}),c.jsx("p",{className:"text-gray-400",children:"No scheduled tasks configured."})]}):c.jsx("div",{className:"bg-gray-900 rounded-xl border border-gray-800 overflow-x-auto",children:c.jsxs("table",{className:"w-full text-sm",children:[c.jsx("thead",{children:c.jsxs("tr",{className:"border-b border-gray-800",children:[c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"ID"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Name"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Command"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Next Run"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Last Status"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Enabled"}),c.jsx("th",{className:"text-right px-4 py-3 text-gray-400 font-medium",children:"Actions"})]})}),c.jsx("tbody",{children:i.map(J=>c.jsxs("tr",{className:"border-b border-gray-800/50 hover:bg-gray-800/30 transition-colors",children:[c.jsx("td",{className:"px-4 py-3 text-gray-400 font-mono text-xs",children:J.id.slice(0,8)}),c.jsx("td",{className:"px-4 py-3 text-white font-medium",children:J.name??"-"}),c.jsx("td",{className:"px-4 py-3 text-gray-300 font-mono text-xs max-w-[200px] truncate",children:J.command}),c.jsx("td",{className:"px-4 py-3 text-gray-400 text-xs",children:Rp(J.next_run)}),c.jsx("td",{className:"px-4 py-3",children:c.jsxs("div",{className:"flex items-center gap-1.5",children:[W(J.last_status),c.jsx("span",{className:"text-gray-300 text-xs capitalize",children:J.last_status??"-"})]})}),c.jsx("td",{className:"px-4 py-3",children:c.jsx("span",{className:`inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium ${J.enabled?"bg-green-900/40 text-green-400 border border-green-700/50":"bg-gray-800 text-gray-500 border border-gray-700"}`,children:J.enabled?"Enabled":"Disabled"})}),c.jsx("td",{className:"px-4 py-3 text-right",children:v===J.id?c.jsxs("div",{className:"flex items-center justify-end gap-2",children:[c.jsx("span",{className:"text-xs text-red-400",children:"Delete?"}),c.jsx("button",{onClick:()=>oe(J.id),className:"text-red-400 hover:text-red-300 text-xs font-medium",children:"Yes"}),c.jsx("button",{onClick:()=>y(null),className:"text-gray-400 hover:text-white text-xs font-medium",children:"No"})]}):c.jsx("button",{onClick:()=>y(J.id),className:"text-gray-400 hover:text-red-400 transition-colors",children:c.jsx(n0,{className:"h-4 w-4"})})})]},J.id))})]})})]})}function Up(i){switch(i){case"Active":return{icon:Rx,label:"Active",classes:"bg-green-900/40 text-green-400 border-green-700/50"};case"Available":return{icon:Px,label:"Available",classes:"bg-blue-900/40 text-blue-400 border-blue-700/50"};case"ComingSoon":return{icon:Gn,label:"Coming Soon",classes:"bg-gray-800 text-gray-400 border-gray-700"}}}function Hp(){const[i,o]=p.useState([]),[f,r]=p.useState(!0),[m,h]=p.useState(null),[x,j]=p.useState("all");p.useEffect(()=>{op().then(o).catch(b=>h(b.message)).finally(()=>r(!1))},[]);const v=["all",...Array.from(new Set(i.map(b=>b.category))).sort()],A=(x==="all"?i:i.filter(b=>b.category===x)).reduce((b,U)=>{const L=U.category;return b[L]||(b[L]=[]),b[L].push(U),b},{});return m?c.jsx("div",{className:"p-6",children:c.jsxs("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-4 text-red-300",children:["Failed to load integrations: ",m]})}):f?c.jsx("div",{className:"flex items-center justify-center h-64",children:c.jsx("div",{className:"animate-spin rounded-full h-8 w-8 border-2 border-blue-500 border-t-transparent"})}):c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(Ks,{className:"h-5 w-5 text-blue-400"}),c.jsxs("h2",{className:"text-base font-semibold text-white",children:["Integrations (",i.length,")"]})]}),c.jsx("div",{className:"flex flex-wrap gap-2",children:v.map(b=>c.jsx("button",{onClick:()=>j(b),className:`px-3 py-1.5 rounded-lg text-sm font-medium transition-colors capitalize ${x===b?"bg-blue-600 text-white":"bg-gray-900 text-gray-400 border border-gray-700 hover:bg-gray-800 hover:text-white"}`,children:b},b))}),Object.keys(A).length===0?c.jsxs("div",{className:"bg-gray-900 rounded-xl border border-gray-800 p-8 text-center",children:[c.jsx(Ks,{className:"h-10 w-10 text-gray-600 mx-auto mb-3"}),c.jsx("p",{className:"text-gray-400",children:"No integrations found."})]}):Object.entries(A).sort(([b],[U])=>b.localeCompare(U)).map(([b,U])=>c.jsxs("div",{children:[c.jsx("h3",{className:"text-sm font-semibold text-gray-400 uppercase tracking-wider mb-3 capitalize",children:b}),c.jsx("div",{className:"grid grid-cols-1 md:grid-cols-2 xl:grid-cols-3 gap-4",children:U.map(L=>{const q=Up(L.status),Y=q.icon;return c.jsx("div",{className:"bg-gray-900 rounded-xl border border-gray-800 p-5 hover:border-gray-700 transition-colors",children:c.jsxs("div",{className:"flex items-start justify-between gap-3",children:[c.jsxs("div",{className:"min-w-0",children:[c.jsx("h4",{className:"text-sm font-semibold text-white truncate",children:L.name}),c.jsx("p",{className:"text-sm text-gray-400 mt-1 line-clamp-2",children:L.description})]}),c.jsxs("span",{className:`flex-shrink-0 inline-flex items-center gap-1 px-2 py-1 rounded-full text-xs font-medium border ${q.classes}`,children:[c.jsx(Y,{className:"h-3 w-3"}),q.label]})]})},L.name)})})]},b))]})}function Lp(i,o){return i.length<=o?i:i.slice(0,o)+"..."}function Bp(i){return new Date(i).toLocaleString()}function qp(){const[i,o]=p.useState([]),[f,r]=p.useState(!0),[m,h]=p.useState(null),[x,j]=p.useState(""),[v,y]=p.useState(""),[A,b]=p.useState(!1),[U,L]=p.useState(null),[q,Y]=p.useState(""),[B,G]=p.useState(""),[Q,H]=p.useState(""),[ee,I]=p.useState(null),[oe,W]=p.useState(!1),J=(te,ke)=>{r(!0),dp(te||void 0,ke||void 0).then(o).catch(w=>h(w.message)).finally(()=>r(!1))};p.useEffect(()=>{J()},[]);const Ee=()=>{J(x,v)},We=te=>{te.key==="Enter"&&Ee()},St=Array.from(new Set(i.map(te=>te.category))).sort(),Fe=async()=>{if(!q.trim()||!B.trim()){I("Key and content are required.");return}W(!0),I(null);try{await mp(q.trim(),B.trim(),Q.trim()||void 0),J(x,v),b(!1),Y(""),G(""),H("")}catch(te){I(te instanceof Error?te.message:"Failed to store memory")}finally{W(!1)}},Gt=async te=>{try{await hp(te),o(ke=>ke.filter(w=>w.key!==te))}catch(ke){h(ke instanceof Error?ke.message:"Failed to delete memory")}finally{L(null)}};return m&&i.length===0?c.jsx("div",{className:"p-6",children:c.jsxs("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-4 text-red-300",children:["Failed to load memory: ",m]})}):c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"flex items-center justify-between",children:[c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(Vs,{className:"h-5 w-5 text-blue-400"}),c.jsxs("h2",{className:"text-base font-semibold text-white",children:["Memory (",i.length,")"]})]}),c.jsxs("button",{onClick:()=>b(!0),className:"flex items-center gap-2 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-4 py-2 rounded-lg transition-colors",children:[c.jsx(t0,{className:"h-4 w-4"}),"Add Memory"]})]}),c.jsxs("div",{className:"flex flex-col sm:flex-row gap-3",children:[c.jsxs("div",{className:"relative flex-1",children:[c.jsx(l0,{className:"absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-gray-500"}),c.jsx("input",{type:"text",value:x,onChange:te=>j(te.target.value),onKeyDown:We,placeholder:"Search memory entries...",className:"w-full bg-gray-900 border border-gray-700 rounded-lg pl-10 pr-4 py-2.5 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"})]}),c.jsxs("div",{className:"relative",children:[c.jsx(Pm,{className:"absolute left-3 top-1/2 -translate-y-1/2 h-4 w-4 text-gray-500"}),c.jsxs("select",{value:v,onChange:te=>y(te.target.value),className:"bg-gray-900 border border-gray-700 rounded-lg pl-10 pr-8 py-2.5 text-sm text-white appearance-none focus:outline-none focus:ring-2 focus:ring-blue-500 cursor-pointer",children:[c.jsx("option",{value:"",children:"All Categories"}),St.map(te=>c.jsx("option",{value:te,children:te},te))]})]}),c.jsx("button",{onClick:Ee,className:"px-4 py-2.5 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium rounded-lg transition-colors",children:"Search"})]}),m&&c.jsx("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-3 text-sm text-red-300",children:m}),A&&c.jsx("div",{className:"fixed inset-0 bg-black/60 flex items-center justify-center z-50",children:c.jsxs("div",{className:"bg-gray-900 border border-gray-700 rounded-xl p-6 w-full max-w-md mx-4",children:[c.jsxs("div",{className:"flex items-center justify-between mb-4",children:[c.jsx("h3",{className:"text-lg font-semibold text-white",children:"Add Memory"}),c.jsx("button",{onClick:()=>{b(!1),I(null)},className:"text-gray-400 hover:text-white transition-colors",children:c.jsx(i0,{className:"h-5 w-5"})})]}),ee&&c.jsx("div",{className:"mb-4 rounded-lg bg-red-900/30 border border-red-700 p-3 text-sm text-red-300",children:ee}),c.jsxs("div",{className:"space-y-4",children:[c.jsxs("div",{children:[c.jsxs("label",{className:"block text-sm font-medium text-gray-300 mb-1",children:["Key ",c.jsx("span",{className:"text-red-400",children:"*"})]}),c.jsx("input",{type:"text",value:q,onChange:te=>Y(te.target.value),placeholder:"e.g. user_preferences",className:"w-full bg-gray-800 border border-gray-700 rounded-lg px-3 py-2 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"})]}),c.jsxs("div",{children:[c.jsxs("label",{className:"block text-sm font-medium text-gray-300 mb-1",children:["Content ",c.jsx("span",{className:"text-red-400",children:"*"})]}),c.jsx("textarea",{value:B,onChange:te=>G(te.target.value),placeholder:"Memory content...",rows:4,className:"w-full bg-gray-800 border border-gray-700 rounded-lg px-3 py-2 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500 resize-none"})]}),c.jsxs("div",{children:[c.jsx("label",{className:"block text-sm font-medium text-gray-300 mb-1",children:"Category (optional)"}),c.jsx("input",{type:"text",value:Q,onChange:te=>H(te.target.value),placeholder:"e.g. preferences, context, facts",className:"w-full bg-gray-800 border border-gray-700 rounded-lg px-3 py-2 text-sm text-white placeholder-gray-500 focus:outline-none focus:ring-2 focus:ring-blue-500"})]})]}),c.jsxs("div",{className:"flex justify-end gap-3 mt-6",children:[c.jsx("button",{onClick:()=>{b(!1),I(null)},className:"px-4 py-2 text-sm font-medium text-gray-300 hover:text-white border border-gray-700 rounded-lg hover:bg-gray-800 transition-colors",children:"Cancel"}),c.jsx("button",{onClick:Fe,disabled:oe,className:"px-4 py-2 text-sm font-medium text-white bg-blue-600 hover:bg-blue-700 rounded-lg transition-colors disabled:opacity-50",children:oe?"Saving...":"Save"})]})]})}),f?c.jsx("div",{className:"flex items-center justify-center h-32",children:c.jsx("div",{className:"animate-spin rounded-full h-8 w-8 border-2 border-blue-500 border-t-transparent"})}):i.length===0?c.jsxs("div",{className:"bg-gray-900 rounded-xl border border-gray-800 p-8 text-center",children:[c.jsx(Vs,{className:"h-10 w-10 text-gray-600 mx-auto mb-3"}),c.jsx("p",{className:"text-gray-400",children:"No memory entries found."})]}):c.jsx("div",{className:"bg-gray-900 rounded-xl border border-gray-800 overflow-x-auto",children:c.jsxs("table",{className:"w-full text-sm",children:[c.jsx("thead",{children:c.jsxs("tr",{className:"border-b border-gray-800",children:[c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Key"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Content"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Category"}),c.jsx("th",{className:"text-left px-4 py-3 text-gray-400 font-medium",children:"Timestamp"}),c.jsx("th",{className:"text-right px-4 py-3 text-gray-400 font-medium",children:"Actions"})]})}),c.jsx("tbody",{children:i.map(te=>c.jsxs("tr",{className:"border-b border-gray-800/50 hover:bg-gray-800/30 transition-colors",children:[c.jsx("td",{className:"px-4 py-3 text-white font-medium font-mono text-xs",children:te.key}),c.jsx("td",{className:"px-4 py-3 text-gray-300 max-w-[300px]",children:c.jsx("span",{title:te.content,children:Lp(te.content,80)})}),c.jsx("td",{className:"px-4 py-3",children:c.jsx("span",{className:"inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-gray-800 text-gray-300 capitalize",children:te.category})}),c.jsx("td",{className:"px-4 py-3 text-gray-400 text-xs whitespace-nowrap",children:Bp(te.timestamp)}),c.jsx("td",{className:"px-4 py-3 text-right",children:U===te.key?c.jsxs("div",{className:"flex items-center justify-end gap-2",children:[c.jsx("span",{className:"text-xs text-red-400",children:"Delete?"}),c.jsx("button",{onClick:()=>Gt(te.key),className:"text-red-400 hover:text-red-300 text-xs font-medium",children:"Yes"}),c.jsx("button",{onClick:()=>L(null),className:"text-gray-400 hover:text-white text-xs font-medium",children:"No"})]}):c.jsx("button",{onClick:()=>L(te.key),className:"text-gray-400 hover:text-red-400 transition-colors",children:c.jsx(n0,{className:"h-4 w-4"})})})]},te.id))})]})})]})}function Yp(){const[i,o]=p.useState(""),[f,r]=p.useState(!0),[m,h]=p.useState(!1),[x,j]=p.useState(null),[v,y]=p.useState(null);p.useEffect(()=>{np().then(b=>{o(typeof b=="string"?b:JSON.stringify(b,null,2))}).catch(b=>j(b.message)).finally(()=>r(!1))},[]);const A=async()=>{h(!0),j(null),y(null);try{await up(i),y("Configuration saved successfully.")}catch(b){j(b instanceof Error?b.message:"Failed to save configuration")}finally{h(!1)}};return p.useEffect(()=>{if(!v)return;const b=setTimeout(()=>y(null),4e3);return()=>clearTimeout(b)},[v]),f?c.jsx("div",{className:"flex items-center justify-center h-64",children:c.jsx("div",{className:"animate-spin rounded-full h-8 w-8 border-2 border-blue-500 border-t-transparent"})}):c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"flex items-center justify-between",children:[c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(a0,{className:"h-5 w-5 text-blue-400"}),c.jsx("h2",{className:"text-base font-semibold text-white",children:"Configuration"})]}),c.jsxs("button",{onClick:A,disabled:m,className:"flex items-center gap-2 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-4 py-2 rounded-lg transition-colors disabled:opacity-50",children:[c.jsx(Kx,{className:"h-4 w-4"}),m?"Saving...":"Save"]})]}),c.jsxs("div",{className:"flex items-start gap-3 bg-yellow-900/20 border border-yellow-700/40 rounded-lg p-4",children:[c.jsx($x,{className:"h-5 w-5 text-yellow-400 flex-shrink-0 mt-0.5"}),c.jsxs("div",{children:[c.jsx("p",{className:"text-sm text-yellow-300 font-medium",children:"Sensitive fields are masked"}),c.jsx("p",{className:"text-sm text-yellow-400/70 mt-0.5",children:"API keys, tokens, and passwords are hidden for security. To update a masked field, replace the entire masked value with your new value."})]})]}),v&&c.jsxs("div",{className:"flex items-center gap-2 bg-green-900/30 border border-green-700 rounded-lg p-3",children:[c.jsx(yi,{className:"h-4 w-4 text-green-400 flex-shrink-0"}),c.jsx("span",{className:"text-sm text-green-300",children:v})]}),x&&c.jsxs("div",{className:"flex items-center gap-2 bg-red-900/30 border border-red-700 rounded-lg p-3",children:[c.jsx(ir,{className:"h-4 w-4 text-red-400 flex-shrink-0"}),c.jsx("span",{className:"text-sm text-red-300",children:x})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl border border-gray-800 overflow-hidden",children:[c.jsxs("div",{className:"flex items-center justify-between px-4 py-2 border-b border-gray-800 bg-gray-800/50",children:[c.jsx("span",{className:"text-xs text-gray-400 font-medium uppercase tracking-wider",children:"TOML Configuration"}),c.jsxs("span",{className:"text-xs text-gray-500",children:[i.split(` -`).length," lines"]})]}),c.jsx("textarea",{value:i,onChange:b=>o(b.target.value),spellCheck:!1,className:"w-full min-h-[500px] bg-gray-950 text-gray-200 font-mono text-sm p-4 resize-y focus:outline-none focus:ring-2 focus:ring-blue-500 focus:ring-inset",style:{tabSize:4}})]})]})}function qn(i){return`$${i.toFixed(4)}`}function Gp(){const[i,o]=p.useState(null),[f,r]=p.useState(!0),[m,h]=p.useState(null);if(p.useEffect(()=>{r0().then(o).catch(j=>h(j.message)).finally(()=>r(!1))},[]),m)return c.jsx("div",{className:"p-6",children:c.jsxs("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-4 text-red-300",children:["Failed to load cost data: ",m]})});if(f||!i)return c.jsx("div",{className:"flex items-center justify-center h-64",children:c.jsx("div",{className:"animate-spin rounded-full h-8 w-8 border-2 border-blue-500 border-t-transparent"})});const x=Object.values(i.by_model);return c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-4",children:[c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-blue-600/20 rounded-lg",children:c.jsx(ur,{className:"h-5 w-5 text-blue-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Session Cost"})]}),c.jsx("p",{className:"text-2xl font-bold text-white",children:qn(i.session_cost_usd)})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-green-600/20 rounded-lg",children:c.jsx(Fx,{className:"h-5 w-5 text-green-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Daily Cost"})]}),c.jsx("p",{className:"text-2xl font-bold text-white",children:qn(i.daily_cost_usd)})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-purple-600/20 rounded-lg",children:c.jsx(Yx,{className:"h-5 w-5 text-purple-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Monthly Cost"})]}),c.jsx("p",{className:"text-2xl font-bold text-white",children:qn(i.monthly_cost_usd)})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl p-5 border border-gray-800",children:[c.jsxs("div",{className:"flex items-center gap-3 mb-3",children:[c.jsx("div",{className:"p-2 bg-orange-600/20 rounded-lg",children:c.jsx(qx,{className:"h-5 w-5 text-orange-400"})}),c.jsx("span",{className:"text-sm text-gray-400",children:"Total Requests"})]}),c.jsx("p",{className:"text-2xl font-bold text-white",children:i.request_count.toLocaleString()})]})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl border border-gray-800 p-5",children:[c.jsx("h3",{className:"text-base font-semibold text-white mb-4",children:"Token Statistics"}),c.jsxs("div",{className:"grid grid-cols-1 sm:grid-cols-3 gap-4",children:[c.jsxs("div",{className:"bg-gray-800/50 rounded-lg p-4",children:[c.jsx("p",{className:"text-sm text-gray-400",children:"Total Tokens"}),c.jsx("p",{className:"text-xl font-bold text-white mt-1",children:i.total_tokens.toLocaleString()})]}),c.jsxs("div",{className:"bg-gray-800/50 rounded-lg p-4",children:[c.jsx("p",{className:"text-sm text-gray-400",children:"Avg Tokens / Request"}),c.jsx("p",{className:"text-xl font-bold text-white mt-1",children:i.request_count>0?Math.round(i.total_tokens/i.request_count).toLocaleString():"0"})]}),c.jsxs("div",{className:"bg-gray-800/50 rounded-lg p-4",children:[c.jsx("p",{className:"text-sm text-gray-400",children:"Cost per 1K Tokens"}),c.jsx("p",{className:"text-xl font-bold text-white mt-1",children:i.total_tokens>0?qn(i.monthly_cost_usd/i.total_tokens*1e3):"$0.0000"})]})]})]}),c.jsxs("div",{className:"bg-gray-900 rounded-xl border border-gray-800 overflow-hidden",children:[c.jsx("div",{className:"px-5 py-4 border-b border-gray-800",children:c.jsx("h3",{className:"text-base font-semibold text-white",children:"Model Breakdown"})}),x.length===0?c.jsx("div",{className:"p-8 text-center text-gray-500",children:"No model data available."}):c.jsx("div",{className:"overflow-x-auto",children:c.jsxs("table",{className:"w-full text-sm",children:[c.jsx("thead",{children:c.jsxs("tr",{className:"border-b border-gray-800",children:[c.jsx("th",{className:"text-left px-5 py-3 text-gray-400 font-medium",children:"Model"}),c.jsx("th",{className:"text-right px-5 py-3 text-gray-400 font-medium",children:"Cost"}),c.jsx("th",{className:"text-right px-5 py-3 text-gray-400 font-medium",children:"Tokens"}),c.jsx("th",{className:"text-right px-5 py-3 text-gray-400 font-medium",children:"Requests"}),c.jsx("th",{className:"text-left px-5 py-3 text-gray-400 font-medium",children:"Share"})]})}),c.jsx("tbody",{children:x.sort((j,v)=>v.cost_usd-j.cost_usd).map(j=>{const v=i.monthly_cost_usd>0?j.cost_usd/i.monthly_cost_usd*100:0;return c.jsxs("tr",{className:"border-b border-gray-800/50 hover:bg-gray-800/30 transition-colors",children:[c.jsx("td",{className:"px-5 py-3 text-white font-medium",children:j.model}),c.jsx("td",{className:"px-5 py-3 text-gray-300 text-right font-mono",children:qn(j.cost_usd)}),c.jsx("td",{className:"px-5 py-3 text-gray-300 text-right",children:j.total_tokens.toLocaleString()}),c.jsx("td",{className:"px-5 py-3 text-gray-300 text-right",children:j.request_count.toLocaleString()}),c.jsx("td",{className:"px-5 py-3",children:c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx("div",{className:"w-20 h-2 bg-gray-800 rounded-full overflow-hidden",children:c.jsx("div",{className:"h-full bg-blue-500 rounded-full",style:{width:`${Math.max(v,2)}%`}})}),c.jsxs("span",{className:"text-xs text-gray-400 w-10 text-right",children:[v.toFixed(1),"%"]})]})})]},j.model)})})]})})]})]})}const kp=1e3,Xp=3e4;class Qp{constructor(o={}){we(this,"controller",null);we(this,"reconnectTimer",null);we(this,"currentDelay");we(this,"intentionallyClosed",!1);we(this,"onEvent",null);we(this,"onError",null);we(this,"onConnect",null);we(this,"path");we(this,"reconnectDelay");we(this,"maxReconnectDelay");we(this,"autoReconnect");this.path=o.path??"/api/events",this.reconnectDelay=o.reconnectDelay??kp,this.maxReconnectDelay=o.maxReconnectDelay??Xp,this.autoReconnect=o.autoReconnect??!0,this.currentDelay=this.reconnectDelay}connect(){this.intentionallyClosed=!1,this.clearReconnectTimer(),this.controller=new AbortController;const o=La(),f={Accept:"text/event-stream"};o&&(f.Authorization=`Bearer ${o}`),fetch(this.path,{headers:f,signal:this.controller.signal}).then(r=>{var m;if(!r.ok)throw new Error(`SSE connection failed: ${r.status}`);if(!r.body)throw new Error("SSE response has no body");return this.currentDelay=this.reconnectDelay,(m=this.onConnect)==null||m.call(this),this.consumeStream(r.body)}).catch(r=>{var m;r instanceof DOMException&&r.name==="AbortError"||((m=this.onError)==null||m.call(this,r instanceof Error?r:new Error(String(r))),this.scheduleReconnect())})}disconnect(){this.intentionallyClosed=!0,this.clearReconnectTimer(),this.controller&&(this.controller.abort(),this.controller=null)}async consumeStream(o){var h;const f=o.getReader(),r=new TextDecoder;let m="";try{for(;;){const{done:x,value:j}=await f.read();if(x)break;m+=r.decode(j,{stream:!0});const v=m.split(` - -`);m=v.pop()??"";for(const y of v)this.parseEvent(y)}}catch(x){if(x instanceof DOMException&&x.name==="AbortError")return;(h=this.onError)==null||h.call(this,x instanceof Error?x:new Error(String(x)))}finally{f.releaseLock()}this.scheduleReconnect()}parseEvent(o){var x;let f="message";const r=[];for(const j of o.split(` -`))j.startsWith("event:")?f=j.slice(6).trim():j.startsWith("data:")&&r.push(j.slice(5).trim());if(r.length===0)return;const m=r.join(` -`);let h;try{h=JSON.parse(m),h.type=h.type??f}catch{h={type:f,data:m}}(x=this.onEvent)==null||x.call(this,h)}scheduleReconnect(){this.intentionallyClosed||!this.autoReconnect||(this.reconnectTimer=setTimeout(()=>{this.currentDelay=Math.min(this.currentDelay*2,this.maxReconnectDelay),this.connect()},this.currentDelay))}clearReconnectTimer(){this.reconnectTimer!==null&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=null)}}function Zp(i){return i?new Date(i).toLocaleTimeString():new Date().toLocaleTimeString()}function Vp(i){switch(i.toLowerCase()){case"error":return"bg-red-900/50 text-red-400 border-red-700/50";case"warn":case"warning":return"bg-yellow-900/50 text-yellow-400 border-yellow-700/50";case"tool_call":case"tool_result":return"bg-purple-900/50 text-purple-400 border-purple-700/50";case"message":case"chat":return"bg-blue-900/50 text-blue-400 border-blue-700/50";case"health":case"status":return"bg-green-900/50 text-green-400 border-green-700/50";default:return"bg-gray-800 text-gray-400 border-gray-700"}}function Kp(){const[i,o]=p.useState([]),[f,r]=p.useState(!1),[m,h]=p.useState(!1),[x,j]=p.useState(!0),[v,y]=p.useState(new Set),A=p.useRef(null),b=p.useRef(null),U=p.useRef(!1),L=p.useRef(0);p.useEffect(()=>{U.current=f},[f]),p.useEffect(()=>{const H=new Qp;return H.onConnect=()=>{h(!0)},H.onError=()=>{h(!1)},H.onEvent=ee=>{if(U.current)return;L.current+=1;const I={id:`log-${L.current}`,event:ee};o(oe=>{const W=[...oe,I];return W.length>500?W.slice(-500):W})},H.connect(),b.current=H,()=>{H.disconnect()}},[]),p.useEffect(()=>{x&&A.current&&(A.current.scrollTop=A.current.scrollHeight)},[i,x]);const q=p.useCallback(()=>{if(!A.current)return;const{scrollTop:H,scrollHeight:ee,clientHeight:I}=A.current,oe=ee-H-I<50;j(oe)},[]),Y=()=>{A.current&&(A.current.scrollTop=A.current.scrollHeight),j(!0)},B=Array.from(new Set(i.map(H=>H.event.type))).sort(),G=H=>{y(ee=>{const I=new Set(ee);return I.has(H)?I.delete(H):I.add(H),I})},Q=v.size===0?i:i.filter(H=>v.has(H.event.type));return c.jsxs("div",{className:"flex flex-col h-[calc(100vh-3.5rem)]",children:[c.jsxs("div",{className:"flex items-center justify-between px-6 py-3 border-b border-gray-800 bg-gray-900",children:[c.jsxs("div",{className:"flex items-center gap-3",children:[c.jsx(di,{className:"h-5 w-5 text-blue-400"}),c.jsx("h2",{className:"text-base font-semibold text-white",children:"Live Logs"}),c.jsxs("div",{className:"flex items-center gap-2 ml-2",children:[c.jsx("span",{className:`inline-block h-2 w-2 rounded-full ${m?"bg-green-500":"bg-red-500"}`}),c.jsx("span",{className:"text-xs text-gray-500",children:m?"Connected":"Disconnected"})]}),c.jsxs("span",{className:"text-xs text-gray-500 ml-2",children:[Q.length," events"]})]}),c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx("button",{onClick:()=>r(!f),className:`flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-sm font-medium transition-colors ${f?"bg-green-600 hover:bg-green-700 text-white":"bg-yellow-600 hover:bg-yellow-700 text-white"}`,children:f?c.jsxs(c.Fragment,{children:[c.jsx(e0,{className:"h-3.5 w-3.5"})," Resume"]}):c.jsxs(c.Fragment,{children:[c.jsx(Zx,{className:"h-3.5 w-3.5"})," Pause"]})}),!x&&c.jsxs("button",{onClick:Y,className:"flex items-center gap-1.5 px-3 py-1.5 rounded-lg text-sm font-medium bg-blue-600 hover:bg-blue-700 text-white transition-colors",children:[c.jsx(Dx,{className:"h-3.5 w-3.5"}),"Jump to bottom"]})]})]}),B.length>0&&c.jsxs("div",{className:"flex items-center gap-2 px-6 py-2 border-b border-gray-800 bg-gray-900/80 overflow-x-auto",children:[c.jsx(Pm,{className:"h-4 w-4 text-gray-500 flex-shrink-0"}),c.jsx("span",{className:"text-xs text-gray-500 flex-shrink-0",children:"Filter:"}),B.map(H=>c.jsxs("label",{className:"flex items-center gap-1.5 cursor-pointer flex-shrink-0",children:[c.jsx("input",{type:"checkbox",checked:v.has(H),onChange:()=>G(H),className:"rounded bg-gray-800 border-gray-600 text-blue-500 focus:ring-blue-500 focus:ring-offset-0 h-3.5 w-3.5"}),c.jsx("span",{className:"text-xs text-gray-400 capitalize",children:H})]},H)),v.size>0&&c.jsx("button",{onClick:()=>y(new Set),className:"text-xs text-blue-400 hover:text-blue-300 flex-shrink-0 ml-1",children:"Clear"})]}),c.jsx("div",{ref:A,onScroll:q,className:"flex-1 overflow-y-auto p-4 space-y-2",children:Q.length===0?c.jsxs("div",{className:"flex flex-col items-center justify-center h-full text-gray-500",children:[c.jsx(di,{className:"h-10 w-10 text-gray-600 mb-3"}),c.jsx("p",{className:"text-sm",children:f?"Log streaming is paused.":"Waiting for events..."})]}):Q.map(H=>{const{event:ee}=H,I=ee.message??ee.content??ee.data??JSON.stringify(Object.fromEntries(Object.entries(ee).filter(([oe])=>oe!=="type"&&oe!=="timestamp")));return c.jsx("div",{className:"bg-gray-900 border border-gray-800 rounded-lg p-3 hover:border-gray-700 transition-colors",children:c.jsxs("div",{className:"flex items-start gap-3",children:[c.jsx("span",{className:"text-xs text-gray-500 font-mono whitespace-nowrap mt-0.5",children:Zp(ee.timestamp)}),c.jsx("span",{className:`inline-flex items-center px-2 py-0.5 rounded text-xs font-medium border capitalize flex-shrink-0 ${Vp(ee.type)}`,children:ee.type}),c.jsx("p",{className:"text-sm text-gray-300 break-all min-w-0",children:typeof I=="string"?I:JSON.stringify(I)})]})},H.id)})})]})}function Jp(i){switch(i){case"ok":return c.jsx(yi,{className:"h-4 w-4 text-green-400 flex-shrink-0"});case"warn":return c.jsx(ir,{className:"h-4 w-4 text-yellow-400 flex-shrink-0"});case"error":return c.jsx(nr,{className:"h-4 w-4 text-red-400 flex-shrink-0"})}}function $p(i){switch(i){case"ok":return"border-green-700/40";case"warn":return"border-yellow-700/40";case"error":return"border-red-700/40"}}function Wp(i){switch(i){case"ok":return"bg-green-900/10";case"warn":return"bg-yellow-900/10";case"error":return"bg-red-900/10"}}function Fp(){const[i,o]=p.useState(null),[f,r]=p.useState(!1),[m,h]=p.useState(null),x=async()=>{r(!0),h(null),o(null);try{const b=await fp();o(b)}catch(b){h(b instanceof Error?b.message:"Failed to run diagnostics")}finally{r(!1)}},j=(i==null?void 0:i.filter(b=>b.severity==="ok").length)??0,v=(i==null?void 0:i.filter(b=>b.severity==="warn").length)??0,y=(i==null?void 0:i.filter(b=>b.severity==="error").length)??0,A=(i==null?void 0:i.reduce((b,U)=>{const L=U.category;return b[L]||(b[L]=[]),b[L].push(U),b},{}))??{};return c.jsxs("div",{className:"p-6 space-y-6",children:[c.jsxs("div",{className:"flex items-center justify-between",children:[c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(Js,{className:"h-5 w-5 text-blue-400"}),c.jsx("h2",{className:"text-base font-semibold text-white",children:"Diagnostics"})]}),c.jsx("button",{onClick:x,disabled:f,className:"flex items-center gap-2 bg-blue-600 hover:bg-blue-700 text-white text-sm font-medium px-4 py-2 rounded-lg transition-colors disabled:opacity-50",children:f?c.jsxs(c.Fragment,{children:[c.jsx(zm,{className:"h-4 w-4 animate-spin"}),"Running..."]}):c.jsxs(c.Fragment,{children:[c.jsx(e0,{className:"h-4 w-4"}),"Run Diagnostics"]})})]}),m&&c.jsx("div",{className:"rounded-lg bg-red-900/30 border border-red-700 p-4 text-red-300",children:m}),f&&c.jsxs("div",{className:"flex flex-col items-center justify-center py-16",children:[c.jsx(zm,{className:"h-10 w-10 text-blue-500 animate-spin mb-4"}),c.jsx("p",{className:"text-gray-400",children:"Running diagnostics..."}),c.jsx("p",{className:"text-sm text-gray-500 mt-1",children:"This may take a few seconds."})]}),i&&!f&&c.jsxs(c.Fragment,{children:[c.jsxs("div",{className:"flex items-center gap-4 bg-gray-900 rounded-xl border border-gray-800 p-4",children:[c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(yi,{className:"h-5 w-5 text-green-400"}),c.jsxs("span",{className:"text-sm text-white font-medium",children:[j," ",c.jsx("span",{className:"text-gray-400 font-normal",children:"ok"})]})]}),c.jsx("div",{className:"w-px h-5 bg-gray-700"}),c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(ir,{className:"h-5 w-5 text-yellow-400"}),c.jsxs("span",{className:"text-sm text-white font-medium",children:[v," ",c.jsxs("span",{className:"text-gray-400 font-normal",children:["warning",v!==1?"s":""]})]})]}),c.jsx("div",{className:"w-px h-5 bg-gray-700"}),c.jsxs("div",{className:"flex items-center gap-2",children:[c.jsx(nr,{className:"h-5 w-5 text-red-400"}),c.jsxs("span",{className:"text-sm text-white font-medium",children:[y," ",c.jsxs("span",{className:"text-gray-400 font-normal",children:["error",y!==1?"s":""]})]})]}),c.jsx("div",{className:"ml-auto",children:y>0?c.jsx("span",{className:"inline-flex items-center gap-1.5 px-3 py-1 rounded-full text-xs font-medium bg-red-900/40 text-red-400 border border-red-700/50",children:"Issues Found"}):v>0?c.jsx("span",{className:"inline-flex items-center gap-1.5 px-3 py-1 rounded-full text-xs font-medium bg-yellow-900/40 text-yellow-400 border border-yellow-700/50",children:"Warnings"}):c.jsx("span",{className:"inline-flex items-center gap-1.5 px-3 py-1 rounded-full text-xs font-medium bg-green-900/40 text-green-400 border border-green-700/50",children:"All Clear"})})]}),Object.entries(A).sort(([b],[U])=>b.localeCompare(U)).map(([b,U])=>c.jsxs("div",{children:[c.jsx("h3",{className:"text-sm font-semibold text-gray-400 uppercase tracking-wider mb-3 capitalize",children:b}),c.jsx("div",{className:"space-y-2",children:U.map((L,q)=>c.jsxs("div",{className:`flex items-start gap-3 rounded-lg border p-3 ${$p(L.severity)} ${Wp(L.severity)}`,children:[Jp(L.severity),c.jsxs("div",{className:"min-w-0",children:[c.jsx("p",{className:"text-sm text-white",children:L.message}),c.jsx("p",{className:"text-xs text-gray-500 mt-0.5 capitalize",children:L.severity})]})]},`${b}-${q}`))})]},b))]}),!i&&!f&&!m&&c.jsxs("div",{className:"flex flex-col items-center justify-center py-16 text-gray-500",children:[c.jsx(Js,{className:"h-12 w-12 text-gray-600 mb-4"}),c.jsx("p",{className:"text-lg font-medium",children:"System Diagnostics"}),c.jsx("p",{className:"text-sm mt-1",children:'Click "Run Diagnostics" to check your ZeroClaw installation.'})]})]})}const m0=p.createContext({locale:"tr",setAppLocale:()=>{}}),Ip=()=>p.useContext(m0);function Pp({onPair:i}){const[o,f]=p.useState(""),[r,m]=p.useState(""),[h,x]=p.useState(!1),j=async v=>{v.preventDefault(),x(!0),m("");try{await i(o)}catch(y){m(y instanceof Error?y.message:"Pairing failed")}finally{x(!1)}};return c.jsx("div",{className:"min-h-screen bg-gray-950 flex items-center justify-center",children:c.jsxs("div",{className:"bg-gray-900 rounded-xl p-8 w-full max-w-md border border-gray-800",children:[c.jsxs("div",{className:"text-center mb-6",children:[c.jsx("h1",{className:"text-2xl font-bold text-white mb-2",children:"ZeroClaw"}),c.jsx("p",{className:"text-gray-400",children:"Enter the pairing code from your terminal"})]}),c.jsxs("form",{onSubmit:j,children:[c.jsx("input",{type:"text",value:o,onChange:v=>f(v.target.value),placeholder:"6-digit code",className:"w-full px-4 py-3 bg-gray-800 border border-gray-700 rounded-lg text-white text-center text-2xl tracking-widest focus:outline-none focus:border-blue-500 mb-4",maxLength:6,autoFocus:!0}),r&&c.jsx("p",{className:"text-red-400 text-sm mb-4 text-center",children:r}),c.jsx("button",{type:"submit",disabled:h||o.length<6,className:"w-full py-3 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-700 disabled:text-gray-500 text-white rounded-lg font-medium transition-colors",children:h?"Pairing...":"Pair"})]})]})})}function ev(){const{isAuthenticated:i,pair:o,logout:f}=d0(),[r,m]=p.useState("tr"),h=x=>{m(x),gp(x)};return p.useEffect(()=>{const x=()=>{f()};return window.addEventListener("zeroclaw-unauthorized",x),()=>window.removeEventListener("zeroclaw-unauthorized",x)},[f]),i?c.jsx(m0.Provider,{value:{locale:r,setAppLocale:h},children:c.jsx(Wg,{children:c.jsxs(vt,{element:c.jsx(Np,{}),children:[c.jsx(vt,{path:"/",element:c.jsx(zp,{})}),c.jsx(vt,{path:"/agent",element:c.jsx(Mp,{})}),c.jsx(vt,{path:"/tools",element:c.jsx(Dp,{})}),c.jsx(vt,{path:"/cron",element:c.jsx(Op,{})}),c.jsx(vt,{path:"/integrations",element:c.jsx(Hp,{})}),c.jsx(vt,{path:"/memory",element:c.jsx(qp,{})}),c.jsx(vt,{path:"/config",element:c.jsx(Yp,{})}),c.jsx(vt,{path:"/cost",element:c.jsx(Gp,{})}),c.jsx(vt,{path:"/logs",element:c.jsx(Kp,{})}),c.jsx(vt,{path:"/doctor",element:c.jsx(Fp,{})}),c.jsx(vt,{path:"*",element:c.jsx(Kg,{to:"/",replace:!0})})]})})}):c.jsx(Pp,{onPair:o})}function tv(){return c.jsx(vp,{children:c.jsx(ev,{})})}$y.createRoot(document.getElementById("root")).render(c.jsx(wm.StrictMode,{children:c.jsx(bx,{basename:"/",children:c.jsx(tv,{})})})); diff --git a/web/dist/index.html b/web/dist/index.html deleted file mode 100644 index 7aa9b8743..000000000 --- a/web/dist/index.html +++ /dev/null @@ -1,14 +0,0 @@ -<!DOCTYPE html> -<html lang="en"> - <head> - <meta charset="UTF-8" /> - <meta name="viewport" content="width=device-width, initial-scale=1.0" /> - <meta name="color-scheme" content="dark" /> - <title>ZeroClaw - - - - -
- - From 67b0ff0ee97c429c8cfa12309ad8aa6db8595b81 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:09:09 -0400 Subject: [PATCH 13/35] docs: update all internal links to match topic-based directory layout - Bulk-fix internal links broken by docs/ reorganization into topic-based subdirectories - Cover root READMEs (en/fr/ja/ru/vi/zh-CN), docs hubs, SUMMARY TOCs, and all subdirectory docs - Fix ancillary issues: GitHub URL org name, LICENSE path, Vietnamese shim depths, installer rename references Co-Authored-By: Claude Opus 4.6 --- .github/workflows/master-branch-flow.md | 6 +- AGENTS.md | 484 +------------------ CLAUDE.md | 2 +- CONTRIBUTING.md | 22 +- README.fr.md | 82 ++-- README.ja.md | 36 +- README.md | 78 +-- README.ru.md | 36 +- README.vi.md | 70 +-- README.zh-CN.md | 36 +- bootstrap.sh | 5 - docs/README.fr.md | 80 +-- docs/README.ja.md | 74 +-- docs/README.md | 84 ++-- docs/README.ru.md | 74 +-- docs/README.vi.md | 8 +- docs/README.zh-CN.md | 74 +-- docs/SUMMARY.fr.md | 76 +-- docs/SUMMARY.ja.md | 76 +-- docs/SUMMARY.md | 78 +-- docs/SUMMARY.ru.md | 76 +-- docs/SUMMARY.zh-CN.md | 76 +-- docs/contributing/README.md | 8 +- docs/contributing/adding-boards-and-tools.md | 2 +- docs/contributing/cargo-slicer-speedup.md | 2 +- docs/contributing/ci-map.md | 6 +- docs/contributing/cla.md | 2 +- docs/contributing/pr-workflow.md | 4 +- docs/contributing/reviewer-playbook.md | 4 +- docs/contributing/testing.md | 4 +- docs/hardware/README.md | 18 +- docs/hardware/hardware-peripherals-design.md | 4 +- docs/i18n/README.md | 4 +- docs/i18n/vi/README.md | 6 +- docs/i18n/vi/SUMMARY.md | 2 +- docs/i18n/vi/one-click-bootstrap.md | 30 +- docs/i18n/vi/project/README.md | 4 +- docs/i18n/vi/reference/README.md | 2 +- docs/i18n/vi/troubleshooting.md | 17 +- docs/maintainers/README.md | 4 +- docs/maintainers/repo-map.md | 2 +- docs/ops/README.md | 12 +- docs/ops/network-deployment.md | 8 +- docs/ops/operations-runbook.md | 10 +- docs/ops/resource-limits.md | 2 +- docs/ops/troubleshooting.md | 21 +- docs/ops/troubleshooting.vi.md | 2 +- docs/reference/README.md | 18 +- docs/reference/api/channels-reference.md | 14 +- docs/reference/api/config-reference.md | 10 +- docs/reference/api/config-reference.vi.md | 2 +- docs/reference/cli/commands-reference.vi.md | 2 +- docs/security/README.md | 18 +- docs/security/agnostic-security.md | 2 +- docs/security/audit-logging.md | 2 +- docs/security/frictionless-security.md | 2 +- docs/security/matrix-e2ee-guide.md | 8 +- docs/security/sandboxing.md | 2 +- docs/security/security-roadmap.md | 2 +- docs/setup-guides/README.md | 6 +- docs/setup-guides/README.vi.md | 6 +- docs/setup-guides/macos-update-uninstall.md | 8 +- docs/setup-guides/one-click-bootstrap.md | 46 +- docs/setup-guides/one-click-bootstrap.vi.md | 2 +- docs/setup-guides/zai-glm-setup.md | 4 +- docs/vi/README.md | 10 +- docs/vi/one-click-bootstrap.md | 30 +- docs/vi/project/README.md | 4 +- docs/vi/reference/README.md | 2 +- docs/vi/troubleshooting.md | 17 +- firmware/zeroclaw-esp32-ui/README.md | 2 +- scripts/bootstrap.sh => install.sh | 99 ++-- python/README.md | 2 +- python/README.vi.md | 2 +- scripts/install.sh | 43 -- tests/telegram/testing-telegram.md | 6 +- zeroclaw_install.sh | 88 ---- 77 files changed, 829 insertions(+), 1443 deletions(-) mode change 100644 => 120000 AGENTS.md delete mode 100755 bootstrap.sh rename scripts/bootstrap.sh => install.sh (90%) delete mode 100755 scripts/install.sh delete mode 100755 zeroclaw_install.sh diff --git a/.github/workflows/master-branch-flow.md b/.github/workflows/master-branch-flow.md index 12d70a72e..34c800fd1 100644 --- a/.github/workflows/master-branch-flow.md +++ b/.github/workflows/master-branch-flow.md @@ -4,9 +4,9 @@ This document explains what runs when code is proposed to `master` and released. Use this with: -- [`docs/ci-map.md`](../../docs/ci-map.md) -- [`docs/pr-workflow.md`](../../docs/pr-workflow.md) -- [`docs/release-process.md`](../../docs/release-process.md) +- [`docs/ci-map.md`](../../docs/contributing/ci-map.md) +- [`docs/pr-workflow.md`](../../docs/contributing/pr-workflow.md) +- [`docs/release-process.md`](../../docs/contributing/release-process.md) ## Branching Model diff --git a/AGENTS.md b/AGENTS.md deleted file mode 100644 index 63b66e86d..000000000 --- a/AGENTS.md +++ /dev/null @@ -1,483 +0,0 @@ -# AGENTS.md — ZeroClaw Agent Engineering Protocol - -This file defines the default working protocol for coding agents in this repository. -Scope: entire repository. - -## 1) Project Snapshot (Read First) - -ZeroClaw is a Rust-first autonomous agent runtime optimized for: - -- high performance -- high efficiency -- high stability -- high extensibility -- high sustainability -- high security - -Core architecture is trait-driven and modular. Most extension work should be done by implementing traits and registering in factory modules. - -Key extension points: - -- `src/providers/traits.rs` (`Provider`) -- `src/channels/traits.rs` (`Channel`) -- `src/tools/traits.rs` (`Tool`) -- `src/memory/traits.rs` (`Memory`) -- `src/observability/traits.rs` (`Observer`) -- `src/runtime/traits.rs` (`RuntimeAdapter`) -- `src/peripherals/traits.rs` (`Peripheral`) — hardware boards (STM32, RPi GPIO) - -## 2) Deep Architecture Observations (Why This Protocol Exists) - -These codebase realities should drive every design decision: - -1. **Trait + factory architecture is the stability backbone** - - Extension points are intentionally explicit and swappable. - - Most features should be added via trait implementation + factory registration, not cross-cutting rewrites. -2. **Security-critical surfaces are first-class and internet-adjacent** - - `src/gateway/`, `src/security/`, `src/tools/`, `src/runtime/` carry high blast radius. - - Defaults already lean secure-by-default (pairing, bind safety, limits, secret handling); keep it that way. -3. **Performance and binary size are product goals, not nice-to-have** - - `Cargo.toml` release profile and dependency choices optimize for size and determinism. - - Convenience dependencies and broad abstractions can silently regress these goals. -4. **Config and runtime contracts are user-facing API** - - `src/config/schema.rs` and CLI commands are effectively public interfaces. - - Backward compatibility and explicit migration matter. -5. **The project now runs in high-concurrency collaboration mode** - - CI + docs governance + label routing are part of the product delivery system. - - PR throughput is a design constraint; not just a maintainer inconvenience. - -## 3) Engineering Principles (Normative) - -These principles are mandatory by default. They are not slogans; they are implementation constraints. - -### 3.1 KISS (Keep It Simple, Stupid) - -**Why here:** Runtime + security behavior must stay auditable under pressure. - -Required: - -- Prefer straightforward control flow over clever meta-programming. -- Prefer explicit match branches and typed structs over hidden dynamic behavior. -- Keep error paths obvious and localized. - -### 3.2 YAGNI (You Aren't Gonna Need It) - -**Why here:** Premature features increase attack surface and maintenance burden. - -Required: - -- Do not add new config keys, trait methods, feature flags, or workflow branches without a concrete accepted use case. -- Do not introduce speculative “future-proof” abstractions without at least one current caller. -- Keep unsupported paths explicit (error out) rather than adding partial fake support. - -### 3.3 DRY + Rule of Three - -**Why here:** Naive DRY can create brittle shared abstractions across providers/channels/tools. - -Required: - -- Duplicate small, local logic when it preserves clarity. -- Extract shared utilities only after repeated, stable patterns (rule-of-three). -- When extracting, preserve module boundaries and avoid hidden coupling. - -### 3.4 SRP + ISP (Single Responsibility + Interface Segregation) - -**Why here:** Trait-driven architecture already encodes subsystem boundaries. - -Required: - -- Keep each module focused on one concern. -- Extend behavior by implementing existing narrow traits whenever possible. -- Avoid fat interfaces and “god modules” that mix policy + transport + storage. - -### 3.5 Fail Fast + Explicit Errors - -**Why here:** Silent fallback in agent runtimes can create unsafe or costly behavior. - -Required: - -- Prefer explicit `bail!`/errors for unsupported or unsafe states. -- Never silently broaden permissions/capabilities. -- Document fallback behavior when fallback is intentional and safe. - -### 3.6 Secure by Default + Least Privilege - -**Why here:** Gateway/tools/runtime can execute actions with real-world side effects. - -Required: - -- Deny-by-default for access and exposure boundaries. -- Never log secrets, raw tokens, or sensitive payloads. -- Keep network/filesystem/shell scope as narrow as possible unless explicitly justified. - -### 3.7 Determinism + Reproducibility - -**Why here:** Reliable CI and low-latency triage depend on deterministic behavior. - -Required: - -- Prefer reproducible commands and locked dependency behavior in CI-sensitive paths. -- Keep tests deterministic (no flaky timing/network dependence without guardrails). -- Ensure local validation commands map to CI expectations. - -### 3.8 Reversibility + Rollback-First Thinking - -**Why here:** Fast recovery is mandatory under high PR volume. - -Required: - -- Keep changes easy to revert (small scope, clear blast radius). -- For risky changes, define rollback path before merge. -- Avoid mixed mega-patches that block safe rollback. - -## 4) Repository Map (High-Level) - -- `src/main.rs` — CLI entrypoint and command routing -- `src/lib.rs` — module exports and shared command enums -- `src/config/` — schema + config loading/merging -- `src/agent/` — orchestration loop -- `src/gateway/` — webhook/gateway server -- `src/security/` — policy, pairing, secret store -- `src/memory/` — markdown/sqlite memory backends + embeddings/vector merge -- `src/providers/` — model providers and resilient wrapper -- `src/channels/` — Telegram/Discord/Slack/etc channels -- `src/tools/` — tool execution surface (shell, file, memory, browser) -- `src/peripherals/` — hardware peripherals (STM32, RPi GPIO); see `docs/hardware-peripherals-design.md` -- `src/runtime/` — runtime adapters (currently native) -- `docs/` — task-oriented documentation system (hubs, unified TOC, references, operations, security proposals, multilingual guides) -- `.github/` — CI, templates, automation workflows - -## 4.1 Documentation System Contract (Required) - -Treat documentation as a first-class product surface, not a post-merge artifact. - -Canonical entry points: - -- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md` -- docs hubs: `docs/README.md`, `docs/README.zh-CN.md`, `docs/README.ja.md`, `docs/README.ru.md`, `docs/README.fr.md`, `docs/i18n/vi/README.md` -- unified TOC: `docs/SUMMARY.md` - -Supported locales (current contract): - -- `en`, `zh-CN`, `ja`, `ru`, `fr`, `vi` - -Collection indexes (category navigation): - -- `docs/getting-started/README.md` -- `docs/reference/README.md` -- `docs/operations/README.md` -- `docs/security/README.md` -- `docs/hardware/README.md` -- `docs/contributing/README.md` -- `docs/project/README.md` - -Runtime-contract references (must track behavior changes): - -- `docs/commands-reference.md` -- `docs/providers-reference.md` -- `docs/channels-reference.md` -- `docs/config-reference.md` -- `docs/operations-runbook.md` -- `docs/troubleshooting.md` -- `docs/one-click-bootstrap.md` - -Required docs governance rules: - -- Keep README/hub top navigation and quick routes intuitive and non-duplicative. -- Keep entry-point parity across all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when changing navigation architecture. -- If a change touches docs IA, runtime-contract references, or user-facing wording in shared docs, perform i18n follow-through for currently supported locales in the same PR: - - Update locale navigation links (`README*`, `docs/README*`, `docs/SUMMARY.md`). - - Update localized runtime-contract docs where equivalents exist (at minimum `commands-reference`, `config-reference`, `troubleshooting` for `fr` and `vi`). - - For Vietnamese, treat `docs/i18n/vi/**` as canonical. Keep `docs/*..md` compatibility shims aligned if present. -- Keep proposal/roadmap docs explicitly labeled; avoid mixing proposal text into runtime-contract docs. -- Keep project snapshots date-stamped and immutable once superseded by a newer date. - -## 5) Risk Tiers by Path (Review Depth Contract) - -Use these tiers when deciding validation depth and review rigor. - -- **Low risk**: docs/chore/tests-only changes -- **Medium risk**: most `src/**` behavior changes without boundary/security impact -- **High risk**: `src/security/**`, `src/runtime/**`, `src/gateway/**`, `src/tools/**`, `.github/workflows/**`, access-control boundaries - -When uncertain, classify as higher risk. - -## 6) Agent Workflow (Required) - -1. **Read before write** - - Inspect existing module, factory wiring, and adjacent tests before editing. -2. **Define scope boundary** - - One concern per PR; avoid mixed feature+refactor+infra patches. -3. **Implement minimal patch** - - Apply KISS/YAGNI/DRY rule-of-three explicitly. -4. **Validate by risk tier** - - Docs-only: lightweight checks. - - Code/risky changes: full relevant checks and focused scenarios. -5. **Document impact** - - Update docs/PR notes for behavior, risk, side effects, and rollback. - - If CLI/config/provider/channel behavior changed, update corresponding runtime-contract references. - - If docs entry points changed, keep all supported locale README/docs-hub navigation aligned (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`). -6. **Respect queue hygiene** - - If stacked PR: declare `Depends on #...`. - - If replacing old PR: declare `Supersedes #...`. - -### 6.1 Branch / Commit / PR Flow (Required) - -All contributors (human or agent) must follow the same collaboration flow: - -- Create and work from a non-`master` branch. -- Commit changes to that branch with clear, scoped commit messages. -- Open a PR to `master`; do not push directly to `master`. -- Wait for required checks and review outcomes before merging. -- Merge via PR controls (squash/rebase/merge as repository policy allows). -- Branch deletion after merge is optional; long-lived branches are allowed when intentionally maintained. - -### 6.2 Worktree Workflow (Required for Multi-Track Agent Work) - -Use Git worktrees to isolate concurrent agent/human tracks safely and predictably: - -- Use one worktree per active branch/PR stream to avoid cross-task contamination. -- Keep each worktree on a single branch; do not mix unrelated edits in one worktree. -- Run validation commands inside the corresponding worktree before commit/PR. -- Name worktrees clearly by scope (for example: `wt/ci-hardening`, `wt/provider-fix`) and remove stale worktrees when no longer needed. -- PR checkpoint rules from section 6.1 still apply to worktree-based development. - -### 6.3 Code Naming Contract (Required) - -Apply these naming rules for all code changes unless a subsystem has a stronger existing pattern. - -- Use Rust standard casing consistently: modules/files `snake_case`, types/traits/enums `PascalCase`, functions/variables `snake_case`, constants/statics `SCREAMING_SNAKE_CASE`. -- Name types and modules by domain role, not implementation detail (for example `DiscordChannel`, `SecurityPolicy`, `MemoryStore` over vague names like `Manager`/`Helper`). -- Keep trait implementer naming explicit and predictable: `Provider`, `Channel`, `Tool`, `Memory`. -- Keep factory registration keys stable, lowercase, and user-facing (for example `"openai"`, `"discord"`, `"shell"`), and avoid alias sprawl without migration need. -- Name tests by behavior/outcome (`_`) and keep fixture identifiers neutral/project-scoped. -- If identity-like naming is required in tests/examples, use ZeroClaw-native labels only (`ZeroClawAgent`, `zeroclaw_user`, `zeroclaw_node`). - -### 6.4 Architecture Boundary Contract (Required) - -Use these rules to keep the trait/factory architecture stable under growth. - -- Extend capabilities by adding trait implementations + factory wiring first; avoid cross-module rewrites for isolated features. -- Keep dependency direction inward to contracts: concrete integrations depend on trait/config/util layers, not on other concrete integrations. -- Avoid creating cross-subsystem coupling (for example provider code importing channel internals, tool code mutating gateway policy directly). -- Keep module responsibilities single-purpose: orchestration in `agent/`, transport in `channels/`, model I/O in `providers/`, policy in `security/`, execution in `tools/`. -- Introduce new shared abstractions only after repeated use (rule-of-three), with at least one real caller in current scope. -- For config/schema changes, treat keys as public contract: document defaults, compatibility impact, and migration/rollback path. - -## 7) Change Playbooks - -### 7.1 Adding a Provider - -- Implement `Provider` in `src/providers/`. -- Register in `src/providers/mod.rs` factory. -- Add focused tests for factory wiring and error paths. -- Avoid provider-specific behavior leaks into shared orchestration code. - -### 7.2 Adding a Channel - -- Implement `Channel` in `src/channels/`. -- Keep `send`, `listen`, `health_check`, typing semantics consistent. -- Cover auth/allowlist/health behavior with tests. - -### 7.3 Adding a Tool - -- Implement `Tool` in `src/tools/` with strict parameter schema. -- Validate and sanitize all inputs. -- Return structured `ToolResult`; avoid panics in runtime path. - -### 7.4 Adding a Peripheral - -- Implement `Peripheral` in `src/peripherals/`. -- Peripherals expose `tools()` — each tool delegates to the hardware (GPIO, sensors, etc.). -- Register board type in config schema if needed. -- See `docs/hardware-peripherals-design.md` for protocol and firmware notes. - -### 7.5 Security / Runtime / Gateway Changes - -- Include threat/risk notes and rollback strategy. -- Add/update tests or validation evidence for failure modes and boundaries. -- Keep observability useful but non-sensitive. -- For `.github/workflows/**` changes, include Actions allowlist impact in PR notes and update `docs/actions-source-policy.md` when sources change. - -### 7.6 Docs System / README / IA Changes - -- Treat docs navigation as product UX: preserve clear pathing from README -> docs hub -> SUMMARY -> category index. -- Keep top-level nav concise; avoid duplicative links across adjacent nav blocks. -- When runtime surfaces change, update related references (`commands/providers/channels/config/runbook/troubleshooting`). -- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when nav or key wording changes. -- When shared docs wording changes, sync corresponding localized docs for supported locales in the same PR (or explicitly document deferral and follow-up PR). -- For docs snapshots, add new date-stamped files for new sprints rather than rewriting historical context. - - -## 8) Validation Matrix - -Default local checks for code changes: - -```bash -cargo fmt --all -- --check -cargo clippy --all-targets -- -D warnings -cargo test -``` - -Preferred local pre-PR validation path (recommended, not required): - -```bash -./dev/ci.sh all -``` - -Notes: - -- Local Docker-based CI is strongly recommended when Docker is available. -- Contributors are not blocked from opening a PR if local Docker CI is unavailable; in that case run the most relevant native checks and document what was run. - -Additional expectations by change type: - -- **Docs/template-only**: - - run markdown lint and link-integrity checks - - if touching README/docs-hub/SUMMARY/collection indexes, verify EN/ZH/JA/RU navigation parity - - if touching bootstrap docs/scripts, run `bash -n bootstrap.sh scripts/bootstrap.sh scripts/install.sh` -- **Workflow changes**: validate YAML syntax; run workflow lint/sanity checks when available. -- **Security/runtime/gateway/tools**: include at least one boundary/failure-mode validation. - -If full checks are impractical, run the most relevant subset and document what was skipped and why. - -## 9) Collaboration and PR Discipline - -- Follow `.github/pull_request_template.md` fully (including side effects / blast radius). -- Keep PR descriptions concrete: problem, change, non-goals, risk, rollback. -- Use conventional commit titles. -- Prefer small PRs (`size: XS/S/M`) when possible. -- Agent-assisted PRs are welcome, **but contributors remain accountable for understanding what their code will do**. - -### 9.1 Privacy/Sensitive Data and Neutral Wording (Required) - -Treat privacy and neutrality as merge gates, not best-effort guidelines. - -- Never commit personal or sensitive data in code, docs, tests, fixtures, snapshots, logs, examples, or commit messages. -- Prohibited data includes (non-exhaustive): real names, personal emails, phone numbers, addresses, access tokens, API keys, credentials, IDs, and private URLs. -- Use neutral project-scoped placeholders (for example: `user_a`, `test_user`, `project_bot`, `example.com`) instead of real identity data. -- Test names/messages/fixtures must be impersonal and system-focused; avoid first-person or identity-specific language. -- If identity-like context is unavoidable, use ZeroClaw-scoped roles/labels only (for example: `ZeroClawAgent`, `ZeroClawOperator`, `zeroclaw_user`) and avoid real-world personas. -- Recommended identity-safe naming palette (use when identity-like context is required): - - actor labels: `ZeroClawAgent`, `ZeroClawOperator`, `ZeroClawMaintainer`, `zeroclaw_user` - - service/runtime labels: `zeroclaw_bot`, `zeroclaw_service`, `zeroclaw_runtime`, `zeroclaw_node` - - environment labels: `zeroclaw_project`, `zeroclaw_workspace`, `zeroclaw_channel` -- If reproducing external incidents, redact and anonymize all payloads before committing. -- Before push, review `git diff --cached` specifically for accidental sensitive strings and identity leakage. - -### 9.2 Superseded-PR Attribution (Required) - -When a PR supersedes another contributor's PR and carries forward substantive code or design decisions, preserve authorship explicitly. - -- In the integrating commit message, add one `Co-authored-by: Name ` trailer per superseded contributor whose work is materially incorporated. -- Use a GitHub-recognized email (`` or the contributor's verified commit email) so attribution is rendered correctly. -- Keep trailers on their own lines after a blank line at commit-message end; never encode them as escaped `\\n` text. -- In the PR body, list superseded PR links and briefly state what was incorporated from each. -- If no actual code/design was incorporated (only inspiration), do not use `Co-authored-by`; give credit in PR notes instead. - -### 9.3 Superseded-PR PR Template (Recommended) - -When superseding multiple PRs, use a consistent title/body structure to reduce reviewer ambiguity. - -- Recommended title format: `feat(): unify and supersede #, # [and #]` -- If this is docs/chore/meta only, keep the same supersede suffix and use the appropriate conventional-commit type. -- In the PR body, include the following template (fill placeholders, remove non-applicable lines): - -```md -## Supersedes -- # by @ -- # by @ -- # by @ - -## Integrated Scope -- From #: -- From #: -- From #: - -## Attribution -- Co-authored-by trailers added for materially incorporated contributors: Yes/No -- If No, explain why (for example: no direct code/design carry-over) - -## Non-goals -- - -## Risk and Rollback -- Risk: -- Rollback: -``` - -### 9.4 Superseded-PR Commit Template (Recommended) - -When a commit unifies or supersedes prior PR work, use a deterministic commit message layout so attribution is machine-parsed and reviewer-friendly. - -- Keep one blank line between message sections, and exactly one blank line before trailer lines. -- Keep each trailer on its own line; do not wrap, indent, or encode as escaped `\n` text. -- Add one `Co-authored-by` trailer per materially incorporated contributor, using GitHub-recognized email. -- If no direct code/design is carried over, omit `Co-authored-by` and explain attribution in the PR body instead. - -```text -feat(): unify and supersede #, # [and #] - - - -Supersedes: -- # by @ -- # by @ -- # by @ - -Integrated scope: -- : from # -- : from # - -Co-authored-by: -Co-authored-by: -``` - -Reference docs: - -- `CONTRIBUTING.md` -- `docs/README.md` -- `docs/SUMMARY.md` -- `docs/docs-inventory.md` -- `docs/commands-reference.md` -- `docs/providers-reference.md` -- `docs/channels-reference.md` -- `docs/config-reference.md` -- `docs/operations-runbook.md` -- `docs/troubleshooting.md` -- `docs/one-click-bootstrap.md` -- `docs/pr-workflow.md` -- `docs/reviewer-playbook.md` -- `docs/ci-map.md` -- `docs/actions-source-policy.md` - -## 10) Anti-Patterns (Do Not) - -- Do not add heavy dependencies for minor convenience. -- Do not silently weaken security policy or access constraints. -- Do not add speculative config/feature flags “just in case”. -- Do not mix massive formatting-only changes with functional changes. -- Do not modify unrelated modules “while here”. -- Do not bypass failing checks without explicit explanation. -- Do not hide behavior-changing side effects in refactor commits. -- Do not include personal identity or sensitive information in test data, examples, docs, or commits. - -## 11) Handoff Template (Agent -> Agent / Maintainer) - -When handing off work, include: - -1. What changed -2. What did not change -3. Validation run and results -4. Remaining risks / unknowns -5. Next recommended action - -## 12) Vibe Coding Guardrails - -When working in fast iterative mode: - -- Keep each iteration reversible (small commits, clear rollback). -- Validate assumptions with code search before implementing. -- Prefer deterministic behavior over clever shortcuts. -- Do not “ship and hope” on security-sensitive paths. -- If uncertain, leave a concrete TODO with verification context, not a hidden guess. diff --git a/AGENTS.md b/AGENTS.md new file mode 120000 index 000000000..681311eb9 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1 @@ +CLAUDE.md \ No newline at end of file diff --git a/CLAUDE.md b/CLAUDE.md index a31833a7d..4c3b57329 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -335,7 +335,7 @@ Additional expectations by change type: - **Docs/template-only**: - run markdown lint and link-integrity checks - if touching README/docs-hub/SUMMARY/collection indexes, verify EN/ZH/JA/RU navigation parity - - if touching bootstrap docs/scripts, run `bash -n bootstrap.sh scripts/bootstrap.sh scripts/install.sh` + - if touching bootstrap docs/scripts, run `bash -n install.sh` - **Workflow changes**: validate YAML syntax; run workflow lint/sanity checks when available. - **Security/runtime/gateway/tools**: include at least one boundary/failure-mode validation. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0e3c7b6d3..75932f2be 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -210,20 +210,20 @@ To keep docs useful under high PR volume, we use these rules: - **Side-effect visibility**: document blast radius, failure modes, and rollback before merge. - **Automation assists, humans decide**: bots triage and label, but merge accountability stays human. - **Index-first discoverability**: `docs/README.md` is the first entry point for operational documentation. -- **Template-first authoring**: start new operational docs from `docs/doc-template.md`. +- **Template-first authoring**: start new operational docs from `docs/contributing/doc-template.md`. ### Documentation System Map | Doc | Primary purpose | When to update | |---|---|---| | `docs/README.md` | canonical docs index and taxonomy | add/remove docs or change documentation ownership/navigation | -| `docs/doc-template.md` | standard skeleton for new operational documentation | when required sections or documentation quality bar changes | +| `docs/contributing/doc-template.md` | standard skeleton for new operational documentation | when required sections or documentation quality bar changes | | `CONTRIBUTING.md` | contributor contract and readiness baseline | contributor expectations or policy changes | -| `docs/pr-workflow.md` | governance logic and merge contract | workflow/risk/merge gate changes | -| `docs/reviewer-playbook.md` | reviewer operating checklist | review depth or triage behavior changes | -| `docs/ci-map.md` | CI ownership and triage entry points | workflow trigger/job ownership changes | -| `docs/network-deployment.md` | runtime deployment and network operating guide | gateway/channel/tunnel/network runtime behavior changes | -| `docs/proxy-agent-playbook.md` | agent-operable proxy runbook and rollback recipes | proxy scope/selector/tooling behavior changes | +| `docs/contributing/pr-workflow.md` | governance logic and merge contract | workflow/risk/merge gate changes | +| `docs/contributing/reviewer-playbook.md` | reviewer operating checklist | review depth or triage behavior changes | +| `docs/contributing/ci-map.md` | CI ownership and triage entry points | workflow trigger/job ownership changes | +| `docs/ops/network-deployment.md` | runtime deployment and network operating guide | gateway/channel/tunnel/network runtime behavior changes | +| `docs/ops/proxy-agent-playbook.md` | agent-operable proxy runbook and rollback recipes | proxy scope/selector/tooling behavior changes | ## PR Definition of Ready (DoR) @@ -237,7 +237,7 @@ Before requesting review, ensure all of the following are true: - Tests/fixtures/examples use neutral project-scoped wording (no identity-specific or first-person phrasing). - If identity-like wording is required, use ZeroClaw-centric labels only (for example: `ZeroClawAgent`, `ZeroClawOperator`, `zeroclaw_user`). - If docs were changed, update `docs/README.md` navigation and reciprocal links with related docs. -- If a new operational doc was added, start from `docs/doc-template.md` and keep risk/rollback/troubleshooting sections where applicable. +- If a new operational doc was added, start from `docs/contributing/doc-template.md` and keep risk/rollback/troubleshooting sections where applicable. - Linked issue (or rationale for no issue) is included. ## PR Definition of Done (DoD) @@ -265,9 +265,9 @@ When PR traffic is high (especially with AI-assisted contributions), these rules - **Identity normalization**: when identity traits are unavoidable, use ZeroClaw/project-native roles instead of personal or real-world identities. - **Supersede hygiene**: if your PR replaces an older open PR, add `Supersedes #...` and request maintainers close the outdated one. -Full maintainer workflow: [`docs/pr-workflow.md`](docs/pr-workflow.md). -CI workflow ownership and triage map: [`docs/ci-map.md`](docs/ci-map.md). -Reviewer operating checklist: [`docs/reviewer-playbook.md`](docs/reviewer-playbook.md). +Full maintainer workflow: [`docs/contributing/pr-workflow.md`](docs/contributing/pr-workflow.md). +CI workflow ownership and triage map: [`docs/contributing/ci-map.md`](docs/contributing/ci-map.md). +Reviewer operating checklist: [`docs/contributing/reviewer-playbook.md`](docs/contributing/reviewer-playbook.md). ## Agent Collaboration Guidance diff --git a/README.fr.md b/README.fr.md index 6edbcc2e5..defe8083c 100644 --- a/README.fr.md +++ b/README.fr.md @@ -30,7 +30,7 @@ Construit par des étudiants et membres des communautés Harvard, MIT et Sundai.

Démarrage | - Configuration en un clic | + Configuration en un clic | Hub Documentation | Table des matières Documentation

@@ -38,8 +38,8 @@ Construit par des étudiants et membres des communautés Harvard, MIT et Sundai.

Accès rapides : Référence · - Opérations · - Dépannage · + Opérations · + Dépannage · Sécurité · Matériel · Contribuer @@ -188,10 +188,10 @@ Exemple d'échantillon (macOS arm64, mesuré le 18 février 2026) : ### Option 1 : Configuration automatisée (recommandée) -Le script `bootstrap.sh` installe Rust, clone ZeroClaw, le compile, et configure votre environnement de développement initial : +Le script `install.sh` installe Rust, clone ZeroClaw, le compile, et configure votre environnement de développement initial : ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/bootstrap.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` Ceci va : @@ -247,9 +247,9 @@ Une fois installé (via bootstrap ou manuellement), vous devriez voir : **Prochaines étapes :** 1. Configurez vos fournisseurs d'IA dans `~/.zeroclaw/workspace/config.toml` -2. Consultez la [référence de configuration](docs/config-reference.md) pour les options avancées +2. Consultez la [référence de configuration](docs/reference/api/config-reference.md) pour les options avancées 3. Lancez l'agent : `zeroclaw agent start` -4. Testez via votre canal préféré (voir [référence des canaux](docs/channels-reference.md)) +4. Testez via votre canal préféré (voir [référence des canaux](docs/reference/api/channels-reference.md)) ## Configuration @@ -285,10 +285,10 @@ kind = "native" # ou "docker" (nécessite Docker) **Documents de référence complets :** -- [Référence de Configuration](docs/config-reference.md) — tous les paramètres, validations, valeurs par défaut -- [Référence des Fournisseurs](docs/providers-reference.md) — configurations spécifiques aux fournisseurs d'IA -- [Référence des Canaux](docs/channels-reference.md) — Telegram, Matrix, Slack, Discord et plus -- [Opérations](docs/operations-runbook.md) — surveillance en production, rotation des secrets, mise à l'échelle +- [Référence de Configuration](docs/reference/api/config-reference.md) — tous les paramètres, validations, valeurs par défaut +- [Référence des Fournisseurs](docs/reference/api/providers-reference.md) — configurations spécifiques aux fournisseurs d'IA +- [Référence des Canaux](docs/reference/api/channels-reference.md) — Telegram, Matrix, Slack, Discord et plus +- [Opérations](docs/ops/operations-runbook.md) — surveillance en production, rotation des secrets, mise à l'échelle ### Support Runtime (actuel) @@ -297,7 +297,7 @@ ZeroClaw prend en charge deux backends d'exécution de code : - **`native`** (par défaut) — exécution de processus directe, chemin le plus rapide, idéal pour les environnements de confiance - **`docker`** — isolation complète du conteneur, politiques de sécurité renforcées, nécessite Docker -Utilisez `runtime.kind = "docker"` si vous avez besoin d'un sandboxing strict ou de l'isolation réseau. Voir [référence de configuration](docs/config-reference.md#runtime) pour les détails complets. +Utilisez `runtime.kind = "docker"` si vous avez besoin d'un sandboxing strict ou de l'isolation réseau. Voir [référence de configuration](docs/reference/api/config-reference.md#runtime) pour les détails complets. ## Commandes @@ -331,7 +331,7 @@ zeroclaw doctor # Exécute les vérifications de santé du système zeroclaw version # Affiche la version et les informations de build ``` -Voir [Référence des Commandes](docs/commands-reference.md) pour les options et exemples complets. +Voir [Référence des Commandes](docs/reference/cli/commands-reference.md) pour les options et exemples complets. ## Architecture @@ -378,7 +378,7 @@ Voir [Référence des Commandes](docs/commands-reference.md) pour les options et - Le runtime abstrait l'exécution de code (natif ou Docker) - Aucun verrouillage de fournisseur — échangez Anthropic ↔ OpenAI ↔ Gemini ↔ Ollama sans changement de code -Voir [documentation architecture](docs/architecture.svg) pour les diagrammes détaillés et les détails d'implémentation. +Voir [documentation architecture](docs/assets/architecture.svg) pour les diagrammes détaillés et les détails d'implémentation. ## Exemples @@ -412,7 +412,7 @@ device_name = "zeroclaw-prod" e2ee_enabled = true ``` -Invitez `@zeroclaw:matrix.org` dans une salle chiffrée, et le bot répondra avec le chiffrement complet. Voir [Guide Matrix E2EE](docs/matrix-e2ee-guide.md) pour la configuration de vérification de dispositif. +Invitez `@zeroclaw:matrix.org` dans une salle chiffrée, et le bot répondra avec le chiffrement complet. Voir [Guide Matrix E2EE](docs/security/matrix-e2ee-guide.md) pour la configuration de vérification de dispositif. ### Multi-Fournisseur @@ -451,7 +451,7 @@ kind = "markdown" path = "~/.zeroclaw/workspace/memory/" ``` -Voir [Référence de Configuration](docs/config-reference.md#memory) pour toutes les options mémoire. +Voir [Référence de Configuration](docs/reference/api/config-reference.md#memory) pour toutes les options mémoire. ## Support de Fournisseur @@ -480,7 +480,7 @@ model = "your-model-name" Exemple : utilisez [LiteLLM](https://github.com/BerriAI/litellm) comme proxy pour accéder à n'importe quel LLM via l'interface OpenAI. -Voir [Référence des Fournisseurs](docs/providers-reference.md) pour les détails de configuration complets. +Voir [Référence des Fournisseurs](docs/reference/api/providers-reference.md) pour les détails de configuration complets. ## Support de Canal @@ -494,7 +494,7 @@ Voir [Référence des Fournisseurs](docs/providers-reference.md) pour les détai | **CLI** | ✅ Stable | Aucun | Interface conversationnelle directe | | **Web** | 🚧 Planifié | Clé API ou OAuth | Interface de chat basée navigateur | -Voir [Référence des Canaux](docs/channels-reference.md) pour les instructions de configuration complètes. +Voir [Référence des Canaux](docs/reference/api/channels-reference.md) pour les instructions de configuration complètes. ## Support d'Outil @@ -522,7 +522,7 @@ kind = "docker" allowed_tools = ["bash", "python", "filesystem_read"] # Liste d'autorisation explicite ``` -Voir [Référence de Configuration](docs/config-reference.md#runtime) pour les options de sécurité complètes. +Voir [Référence de Configuration](docs/reference/api/config-reference.md#runtime) pour les options de sécurité complètes. ## Déploiement @@ -557,7 +557,7 @@ sudo systemctl status zeroclaw-daemon sudo systemctl status zeroclaw-agent ``` -Voir [Guide de Déploiement Réseau](docs/network-deployment.md) pour les instructions de déploiement en production complètes. +Voir [Guide de Déploiement Réseau](docs/ops/network-deployment.md) pour les instructions de déploiement en production complètes. ### Docker @@ -600,7 +600,7 @@ Fournisseurs de tunnel supportés : - **Ngrok** — configuration rapide, domaines personnalisés (plan payant) - **Tailscale** — réseau maillé privé, pas de port public -Voir [Référence de Configuration](docs/config-reference.md#tunnel) pour les options de configuration complètes. +Voir [Référence de Configuration](docs/reference/api/config-reference.md#tunnel) pour les options de configuration complètes. ## Sécurité @@ -659,7 +659,7 @@ max_size_mb = 100 # Pour rotation basée sur la taille retention_days = 30 # Purge automatique après N jours ``` -Voir [Référence de Configuration](docs/config-reference.md#logging) pour toutes les options de journalisation. +Voir [Référence de Configuration](docs/reference/api/config-reference.md#logging) pour toutes les options de journalisation. ### Métriques (Planifié) @@ -776,32 +776,32 @@ Commencez par le hub de documentation pour une carte basée sur les tâches : - Hub de documentation : [`docs/README.md`](docs/README.md) - Table des matières unifiée docs : [`docs/SUMMARY.md`](docs/SUMMARY.md) -- Référence des commandes : [`docs/commands-reference.md`](docs/commands-reference.md) -- Référence de configuration : [`docs/config-reference.md`](docs/config-reference.md) -- Référence des fournisseurs : [`docs/providers-reference.md`](docs/providers-reference.md) -- Référence des canaux : [`docs/channels-reference.md`](docs/channels-reference.md) -- Runbook des opérations : [`docs/operations-runbook.md`](docs/operations-runbook.md) -- Dépannage : [`docs/troubleshooting.md`](docs/troubleshooting.md) -- Inventaire/classification docs : [`docs/docs-inventory.md`](docs/docs-inventory.md) -- Instantané triage PR/Issue (au 18 février 2026) : [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) +- Référence des commandes : [`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md) +- Référence de configuration : [`docs/reference/api/config-reference.md`](docs/reference/api/config-reference.md) +- Référence des fournisseurs : [`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md) +- Référence des canaux : [`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md) +- Runbook des opérations : [`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md) +- Dépannage : [`docs/ops/troubleshooting.md`](docs/ops/troubleshooting.md) +- Inventaire/classification docs : [`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md) +- Instantané triage PR/Issue (au 18 février 2026) : [`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md) Références de collaboration principales : - Hub de documentation : [docs/README.md](docs/README.md) -- Modèle de documentation : [docs/doc-template.md](docs/doc-template.md) +- Modèle de documentation : [docs/contributing/doc-template.md](docs/contributing/doc-template.md) - Checklist de modification de documentation : [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) -- Référence de configuration des canaux : [docs/channels-reference.md](docs/channels-reference.md) -- Opérations de salles chiffrées Matrix : [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Référence de configuration des canaux : [docs/reference/api/channels-reference.md](docs/reference/api/channels-reference.md) +- Opérations de salles chiffrées Matrix : [docs/security/matrix-e2ee-guide.md](docs/security/matrix-e2ee-guide.md) - Guide de contribution : [CONTRIBUTING.md](CONTRIBUTING.md) -- Politique de workflow PR : [docs/pr-workflow.md](docs/pr-workflow.md) -- Playbook du relecteur (triage + revue approfondie) : [docs/reviewer-playbook.md](docs/reviewer-playbook.md) -- Carte de propriété et triage CI : [docs/ci-map.md](docs/ci-map.md) +- Politique de workflow PR : [docs/contributing/pr-workflow.md](docs/contributing/pr-workflow.md) +- Playbook du relecteur (triage + revue approfondie) : [docs/contributing/reviewer-playbook.md](docs/contributing/reviewer-playbook.md) +- Carte de propriété et triage CI : [docs/contributing/ci-map.md](docs/contributing/ci-map.md) - Politique de divulgation de sécurité : [SECURITY.md](SECURITY.md) Pour le déploiement et les opérations runtime : -- Guide de déploiement réseau : [docs/network-deployment.md](docs/network-deployment.md) -- Playbook d'agent proxy : [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) +- Guide de déploiement réseau : [docs/ops/network-deployment.md](docs/ops/network-deployment.md) +- Playbook d'agent proxy : [docs/ops/proxy-agent-playbook.md](docs/ops/proxy-agent-playbook.md) ## Soutenir ZeroClaw @@ -826,7 +826,7 @@ Nous construisons en open source parce que les meilleures idées viennent de par > -Tout autre dépôt, organisation, domaine ou package prétendant être "ZeroClaw" ou impliquant une affiliation avec ZeroClaw Labs est **non autorisé et non affilié à ce projet**. Les forks non autorisés connus seront listés dans [TRADEMARK.md](docs/project/trademark.md). +Tout autre dépôt, organisation, domaine ou package prétendant être "ZeroClaw" ou impliquant une affiliation avec ZeroClaw Labs est **non autorisé et non affilié à ce projet**. Les forks non autorisés connus seront listés dans [TRADEMARK.md](docs/maintainers/trademark.md). Si vous rencontrez une usurpation d'identité ou une utilisation abusive de marque, veuillez [ouvrir une issue](https://github.com/zeroclaw-labs/zeroclaw/issues). @@ -845,7 +845,7 @@ Vous pouvez choisir l'une ou l'autre licence. **Les contributeurs accordent auto ### Marque -Le nom **ZeroClaw** et le logo sont des marques déposées de ZeroClaw Labs. Cette licence n'accorde pas la permission de les utiliser pour impliquer une approbation ou une affiliation. Voir [TRADEMARK.md](docs/project/trademark.md) pour les utilisations permises et interdites. +Le nom **ZeroClaw** et le logo sont des marques déposées de ZeroClaw Labs. Cette licence n'accorde pas la permission de les utiliser pour impliquer une approbation ou une affiliation. Voir [TRADEMARK.md](docs/maintainers/trademark.md) pour les utilisations permises et interdites. ### Protections des Contributeurs @@ -858,7 +858,7 @@ Le nom **ZeroClaw** et le logo sont des marques déposées de ZeroClaw Labs. Cet Voir [CONTRIBUTING.md](CONTRIBUTING.md) et [CLA.md](docs/contributing/cla.md). Implémentez un trait, soumettez une PR : -- Guide de workflow CI : [docs/ci-map.md](docs/ci-map.md) +- Guide de workflow CI : [docs/contributing/ci-map.md](docs/contributing/ci-map.md) - Nouveau `Provider` → `src/providers/` - Nouveau `Channel` → `src/channels/` - Nouveau `Observer` → `src/observability/` diff --git a/README.ja.md b/README.ja.md index 4e5889e2f..85180b5f9 100644 --- a/README.ja.md +++ b/README.ja.md @@ -25,8 +25,8 @@

- ワンクリック導入 | - 導入ガイド | + ワンクリック導入 | + 導入ガイド | ドキュメントハブ | Docs TOC

@@ -34,8 +34,8 @@

クイック分流： 参照 · - 運用 · - 障害対応 · + 運用 · + 障害対応 · セキュリティ · ハードウェア · 貢献・CI @@ -113,12 +113,12 @@ README のサンプル値（macOS arm64, 2026-02-18）: ```bash git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh ``` -環境ごと初期化する場合: `./bootstrap.sh --install-system-deps --install-rust`（システムパッケージで `sudo` が必要な場合があります）。 +環境ごと初期化する場合: `./install.sh --install-system-deps --install-rust`（システムパッケージで `sudo` が必要な場合があります）。 -詳細は [`docs/one-click-bootstrap.md`](docs/one-click-bootstrap.md) を参照してください。 +詳細は [`docs/setup-guides/one-click-bootstrap.md`](docs/setup-guides/one-click-bootstrap.md) を参照してください。 ## クイックスタート @@ -195,7 +195,7 @@ zeroclaw agent --provider anthropic -m "hello" すべてのサブシステムは **Trait** — 設定変更だけで実装を差し替え可能、コード変更不要。

- ZeroClaw アーキテクチャ + ZeroClaw アーキテクチャ

| サブシステム | Trait | 内蔵実装 | 拡張方法 | @@ -279,20 +279,20 @@ allow_public_bind = false - ドキュメントハブ（英語）: [`docs/README.md`](docs/README.md) - 統合 TOC: [`docs/SUMMARY.md`](docs/SUMMARY.md) - ドキュメントハブ（日本語）: [`docs/README.ja.md`](docs/README.ja.md) -- コマンドリファレンス: [`docs/commands-reference.md`](docs/commands-reference.md) -- 設定リファレンス: [`docs/config-reference.md`](docs/config-reference.md) -- Provider リファレンス: [`docs/providers-reference.md`](docs/providers-reference.md) -- Channel リファレンス: [`docs/channels-reference.md`](docs/channels-reference.md) -- 運用ガイド（Runbook）: [`docs/operations-runbook.md`](docs/operations-runbook.md) -- トラブルシューティング: [`docs/troubleshooting.md`](docs/troubleshooting.md) -- ドキュメント一覧 / 分類: [`docs/docs-inventory.md`](docs/docs-inventory.md) -- プロジェクト triage スナップショット: [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) +- コマンドリファレンス: [`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md) +- 設定リファレンス: [`docs/reference/api/config-reference.md`](docs/reference/api/config-reference.md) +- Provider リファレンス: [`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md) +- Channel リファレンス: [`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md) +- 運用ガイド（Runbook）: [`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md) +- トラブルシューティング: [`docs/ops/troubleshooting.md`](docs/ops/troubleshooting.md) +- ドキュメント一覧 / 分類: [`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md) +- プロジェクト triage スナップショット: [`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md) ## コントリビュート / ライセンス - Contributing: [`CONTRIBUTING.md`](CONTRIBUTING.md) -- PR Workflow: [`docs/pr-workflow.md`](docs/pr-workflow.md) -- Reviewer Playbook: [`docs/reviewer-playbook.md`](docs/reviewer-playbook.md) +- PR Workflow: [`docs/contributing/pr-workflow.md`](docs/contributing/pr-workflow.md) +- Reviewer Playbook: [`docs/contributing/reviewer-playbook.md`](docs/contributing/reviewer-playbook.md) - License: MIT or Apache 2.0（[`LICENSE-MIT`](LICENSE-MIT), [`LICENSE-APACHE`](LICENSE-APACHE), [`NOTICE`](NOTICE)） --- diff --git a/README.md b/README.md index 8dbfa2218..102f5f3da 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ Built by students and members of the Harvard, MIT, and Sundai.Club communities.

Getting Started | - One-Click Setup | + One-Click Setup | Docs Hub | Docs TOC

@@ -38,8 +38,8 @@ Built by students and members of the Harvard, MIT, and Sundai.Club communities.

Quick Routes: Reference · - Operations · - Troubleshoot · + Operations · + Troubleshoot · Security · Hardware · Contribute @@ -180,7 +180,7 @@ Example sample (macOS arm64, measured on February 18, 2026): Or skip the steps above and install everything (system deps, Rust, ZeroClaw) in a single command: ```bash -curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash +curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` #### Compilation resource requirements @@ -195,13 +195,13 @@ Building from source needs more resources than running the resulting binary: If your host is below the minimum, use pre-built binaries: ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` To require binary-only install with no source fallback: ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` #### Optional @@ -226,37 +226,37 @@ brew install zeroclaw # Recommended: clone then run local bootstrap script git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh # Optional: bootstrap dependencies + Rust on fresh machines -./bootstrap.sh --install-system-deps --install-rust +./install.sh --install-system-deps --install-rust # Optional: pre-built binary first (recommended on low-RAM/low-disk hosts) -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt # Optional: binary-only install (no source build fallback) -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only # Optional: run onboarding in the same flow -./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter [--model "openrouter/auto"] +./install.sh --onboard --api-key "sk-..." --provider openrouter [--model "openrouter/auto"] # Optional: run bootstrap + onboarding fully in Docker-compatible mode -./bootstrap.sh --docker +./install.sh --docker # Optional: force Podman as container CLI -ZEROCLAW_CONTAINER_CLI=podman ./bootstrap.sh --docker +ZEROCLAW_CONTAINER_CLI=podman ./install.sh --docker # Optional: in --docker mode, skip local image build and use local tag or pull fallback image -./bootstrap.sh --docker --skip-build +./install.sh --docker --skip-build ``` Remote one-liner (review first in security-sensitive environments): ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` -Details: [`docs/one-click-bootstrap.md`](docs/one-click-bootstrap.md) (toolchain mode may request `sudo` for system packages). +Details: [`docs/setup-guides/one-click-bootstrap.md`](docs/setup-guides/one-click-bootstrap.md) (toolchain mode may request `sudo` for system packages). ### Pre-built binaries @@ -398,7 +398,7 @@ zeroclaw agent --provider anthropic -m "hello" Every subsystem is a **trait** — swap implementations with a config change, zero code changes.

- ZeroClaw Architecture + ZeroClaw Architecture

| Subsystem | Trait | Ships with | Extend | @@ -497,7 +497,7 @@ Inbound sender policy is now consistent: This keeps accidental exposure low by default. -Full channel configuration reference: [docs/channels-reference.md](docs/channels-reference.md). +Full channel configuration reference: [docs/reference/api/channels-reference.md](docs/reference/api/channels-reference.md). Recommended low-friction setup (secure + fast): @@ -816,7 +816,7 @@ default_model = "qwen3-30b-a3b-8bit" ### Custom Provider Endpoints -For detailed configuration of custom OpenAI-compatible and Anthropic-compatible endpoints, see [docs/custom-providers.md](docs/custom-providers.md). +For detailed configuration of custom OpenAI-compatible and Anthropic-compatible endpoints, see [docs/contributing/custom-providers.md](docs/contributing/custom-providers.md). ## Python Companion Package (`zeroclaw-tools`) @@ -980,7 +980,7 @@ See [aieos.org](https://aieos.org) for the full schema and live examples. | `hardware` | USB discover/introspect/info commands | | `peripheral` | Manage and flash hardware peripherals | -For a task-oriented command guide, see [`docs/commands-reference.md`](docs/commands-reference.md). +For a task-oriented command guide, see [`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md). ### Service Management @@ -1004,7 +1004,7 @@ sudo rc-update add zeroclaw default sudo rc-service zeroclaw start ``` -For full OpenRC setup instructions, see [docs/network-deployment.md](docs/network-deployment.md#7-openrc-alpine-linux-service). +For full OpenRC setup instructions, see [docs/ops/network-deployment.md](docs/ops/network-deployment.md#7-openrc-alpine-linux-service). ### Open-Skills Opt-In @@ -1061,31 +1061,31 @@ Start from the docs hub for a task-oriented map: - Documentation hub: [`docs/README.md`](docs/README.md) - Unified docs TOC: [`docs/SUMMARY.md`](docs/SUMMARY.md) -- Commands reference: [`docs/commands-reference.md`](docs/commands-reference.md) -- Config reference: [`docs/config-reference.md`](docs/config-reference.md) -- Providers reference: [`docs/providers-reference.md`](docs/providers-reference.md) -- Channels reference: [`docs/channels-reference.md`](docs/channels-reference.md) -- Operations runbook: [`docs/operations-runbook.md`](docs/operations-runbook.md) -- Troubleshooting: [`docs/troubleshooting.md`](docs/troubleshooting.md) -- Docs inventory/classification: [`docs/docs-inventory.md`](docs/docs-inventory.md) -- PR/Issue triage snapshot (as of February 18, 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) +- Commands reference: [`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md) +- Config reference: [`docs/reference/api/config-reference.md`](docs/reference/api/config-reference.md) +- Providers reference: [`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md) +- Channels reference: [`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md) +- Operations runbook: [`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md) +- Troubleshooting: [`docs/ops/troubleshooting.md`](docs/ops/troubleshooting.md) +- Docs inventory/classification: [`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md) +- PR/Issue triage snapshot (as of February 18, 2026): [`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md) Core collaboration references: - Documentation hub: [docs/README.md](docs/README.md) -- Documentation template: [docs/doc-template.md](docs/doc-template.md) +- Documentation template: [docs/contributing/doc-template.md](docs/contributing/doc-template.md) - Documentation change checklist: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) -- Channel configuration reference: [docs/channels-reference.md](docs/channels-reference.md) -- Matrix encrypted-room operations: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Channel configuration reference: [docs/reference/api/channels-reference.md](docs/reference/api/channels-reference.md) +- Matrix encrypted-room operations: [docs/security/matrix-e2ee-guide.md](docs/security/matrix-e2ee-guide.md) - Contribution guide: [CONTRIBUTING.md](CONTRIBUTING.md) -- PR workflow policy: [docs/pr-workflow.md](docs/pr-workflow.md) -- Reviewer playbook (triage + deep review): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- PR workflow policy: [docs/contributing/pr-workflow.md](docs/contributing/pr-workflow.md) +- Reviewer playbook (triage + deep review): [docs/contributing/reviewer-playbook.md](docs/contributing/reviewer-playbook.md) - Security disclosure policy: [SECURITY.md](SECURITY.md) For deployment and runtime operations: -- Network deployment guide: [docs/network-deployment.md](docs/network-deployment.md) -- Proxy agent playbook: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) +- Network deployment guide: [docs/ops/network-deployment.md](docs/ops/network-deployment.md) +- Proxy agent playbook: [docs/ops/proxy-agent-playbook.md](docs/ops/proxy-agent-playbook.md) ## Support ZeroClaw @@ -1110,7 +1110,7 @@ We're building in the open because the best ideas come from everywhere. If you'r > https://github.com/zeroclaw-labs/zeroclaw -Any other repository, organization, domain, or package claiming to be "ZeroClaw" or implying affiliation with ZeroClaw Labs is **unauthorized and not affiliated with this project**. Known unauthorized forks will be listed in [TRADEMARK.md](docs/project/trademark.md). +Any other repository, organization, domain, or package claiming to be "ZeroClaw" or implying affiliation with ZeroClaw Labs is **unauthorized and not affiliated with this project**. Known unauthorized forks will be listed in [TRADEMARK.md](docs/maintainers/trademark.md). If you encounter impersonation or trademark misuse, please [open an issue](https://github.com/zeroclaw-labs/zeroclaw/issues). @@ -1129,7 +1129,7 @@ You may choose either license. **Contributors automatically grant rights under b ### Trademark -The **ZeroClaw** name and logo are trademarks of ZeroClaw Labs. This license does not grant permission to use them to imply endorsement or affiliation. See [TRADEMARK.md](docs/project/trademark.md) for permitted and prohibited uses. +The **ZeroClaw** name and logo are trademarks of ZeroClaw Labs. This license does not grant permission to use them to imply endorsement or affiliation. See [TRADEMARK.md](docs/maintainers/trademark.md) for permitted and prohibited uses. ### Contributor Protections @@ -1144,7 +1144,7 @@ New to ZeroClaw? Look for issues labeled [`good first issue`](https://github.com See [CONTRIBUTING.md](CONTRIBUTING.md) and [CLA.md](docs/contributing/cla.md). Implement a trait, submit a PR: -- CI workflow guide: [docs/ci-map.md](docs/ci-map.md) +- CI workflow guide: [docs/contributing/ci-map.md](docs/contributing/ci-map.md) - New `Provider` → `src/providers/` - New `Channel` → `src/channels/` - New `Observer` → `src/observability/` diff --git a/README.ru.md b/README.ru.md index 3631a31f3..2388fe6c1 100644 --- a/README.ru.md +++ b/README.ru.md @@ -25,8 +25,8 @@

- Установка в 1 клик | - Быстрый старт | + Установка в 1 клик | + Быстрый старт | Хаб документации | TOC docs

@@ -34,8 +34,8 @@

Быстрые маршруты: Справочники · - Операции · - Диагностика · + Операции · + Диагностика · Безопасность · Аппаратная часть · Вклад и CI @@ -113,12 +113,12 @@ ls -lh target/release/zeroclaw ```bash git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh ``` -Для полной инициализации окружения: `./bootstrap.sh --install-system-deps --install-rust` (для системных пакетов может потребоваться `sudo`). +Для полной инициализации окружения: `./install.sh --install-system-deps --install-rust` (для системных пакетов может потребоваться `sudo`). -Подробности: [`docs/one-click-bootstrap.md`](docs/one-click-bootstrap.md). +Подробности: [`docs/setup-guides/one-click-bootstrap.md`](docs/setup-guides/one-click-bootstrap.md). ## Быстрый старт @@ -195,7 +195,7 @@ zeroclaw agent --provider anthropic -m "hello" Каждая подсистема — это **Trait**: меняйте реализации через конфигурацию, без изменения кода.

- Архитектура ZeroClaw + Архитектура ZeroClaw

| Подсистема | Trait | Встроенные реализации | Расширение | @@ -279,20 +279,20 @@ allow_public_bind = false - Хаб документации (English): [`docs/README.md`](docs/README.md) - Единый TOC docs: [`docs/SUMMARY.md`](docs/SUMMARY.md) - Хаб документации (Русский): [`docs/README.ru.md`](docs/README.ru.md) -- Справочник команд: [`docs/commands-reference.md`](docs/commands-reference.md) -- Справочник конфигурации: [`docs/config-reference.md`](docs/config-reference.md) -- Справочник providers: [`docs/providers-reference.md`](docs/providers-reference.md) -- Справочник channels: [`docs/channels-reference.md`](docs/channels-reference.md) -- Операционный runbook: [`docs/operations-runbook.md`](docs/operations-runbook.md) -- Устранение неполадок: [`docs/troubleshooting.md`](docs/troubleshooting.md) -- Инвентарь и классификация docs: [`docs/docs-inventory.md`](docs/docs-inventory.md) -- Снимок triage проекта: [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) +- Справочник команд: [`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md) +- Справочник конфигурации: [`docs/reference/api/config-reference.md`](docs/reference/api/config-reference.md) +- Справочник providers: [`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md) +- Справочник channels: [`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md) +- Операционный runbook: [`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md) +- Устранение неполадок: [`docs/ops/troubleshooting.md`](docs/ops/troubleshooting.md) +- Инвентарь и классификация docs: [`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md) +- Снимок triage проекта: [`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md) ## Вклад и лицензия - Contribution guide: [`CONTRIBUTING.md`](CONTRIBUTING.md) -- PR workflow: [`docs/pr-workflow.md`](docs/pr-workflow.md) -- Reviewer playbook: [`docs/reviewer-playbook.md`](docs/reviewer-playbook.md) +- PR workflow: [`docs/contributing/pr-workflow.md`](docs/contributing/pr-workflow.md) +- Reviewer playbook: [`docs/contributing/reviewer-playbook.md`](docs/contributing/reviewer-playbook.md) - License: MIT or Apache 2.0 ([`LICENSE-MIT`](LICENSE-MIT), [`LICENSE-APACHE`](LICENSE-APACHE), [`NOTICE`](NOTICE)) --- diff --git a/README.vi.md b/README.vi.md index d23cd059d..3e0a2a49d 100644 --- a/README.vi.md +++ b/README.vi.md @@ -30,7 +30,7 @@

Bắt đầu | - Cài đặt một lần bấm | + Cài đặt một lần bấm | Trung tâm tài liệu | Mục lục tài liệu

@@ -38,7 +38,7 @@

Truy cập nhanh: Tài liệu tham khảo · - Vận hành · + Vận hành · Khắc phục sự cố · Bảo mật · Phần cứng · @@ -174,7 +174,7 @@ Ví dụ mẫu (macOS arm64, đo ngày 18 tháng 2 năm 2026): Hoặc bỏ qua các bước trên, cài hết mọi thứ (system deps, Rust, ZeroClaw) chỉ bằng một lệnh: ```bash -curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash +curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` #### Yêu cầu tài nguyên biên dịch @@ -189,13 +189,13 @@ Việc build từ source đòi hỏi nhiều tài nguyên hơn so với chạy b Nếu cấu hình máy thấp hơn mức tối thiểu, dùng binary có sẵn: ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` Chỉ cài từ binary, không quay lại build từ source: ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` ### Tùy chọn (Linux/macOS) @@ -220,37 +220,37 @@ brew install zeroclaw # Khuyến nghị: clone rồi chạy script bootstrap cục bộ git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh # Tùy chọn: cài đặt system dependencies + Rust trên máy mới -./bootstrap.sh --install-system-deps --install-rust +./install.sh --install-system-deps --install-rust # Tùy chọn: ưu tiên binary dựng sẵn (khuyến nghị cho máy ít RAM/ít dung lượng đĩa) -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt # Tùy chọn: cài đặt chỉ từ binary (không fallback sang build source) -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only # Tùy chọn: chạy onboarding trong cùng luồng -./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter [--model "openrouter/auto"] +./install.sh --onboard --api-key "sk-..." --provider openrouter [--model "openrouter/auto"] # Tùy chọn: chạy bootstrap + onboarding hoàn toàn ở chế độ tương thích với Docker -./bootstrap.sh --docker +./install.sh --docker # Tùy chọn: ép dùng Podman làm container CLI -ZEROCLAW_CONTAINER_CLI=podman ./bootstrap.sh --docker +ZEROCLAW_CONTAINER_CLI=podman ./install.sh --docker # Tùy chọn: ở chế độ --docker, bỏ qua build image local và dùng tag local hoặc pull image fallback -./bootstrap.sh --docker --skip-build +./install.sh --docker --skip-build ``` Cài từ xa bằng một lệnh (nên xem trước nếu môi trường nhạy cảm về bảo mật): ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` -Chi tiết: [`docs/one-click-bootstrap.md`](docs/one-click-bootstrap.md) (chế độ toolchain có thể yêu cầu `sudo` cho các gói hệ thống). +Chi tiết: [`docs/setup-guides/one-click-bootstrap.md`](docs/setup-guides/one-click-bootstrap.md) (chế độ toolchain có thể yêu cầu `sudo` cho các gói hệ thống). ### Binary có sẵn @@ -383,7 +383,7 @@ zeroclaw agent --provider anthropic -m "hello" Mọi hệ thống con đều là **trait** — chỉ cần đổi cấu hình, không cần sửa code.

- ZeroClaw Architecture + ZeroClaw Architecture

| Hệ thống con | Trait | Đi kèm sẵn | Mở rộng | @@ -482,7 +482,7 @@ Chính sách kiểm soát người gửi đã được thống nhất: Mặc định an toàn, hạn chế tối đa rủi ro lộ thông tin. -Tài liệu tham khảo đầy đủ về cấu hình channel: [docs/channels-reference.md](docs/channels-reference.md). +Tài liệu tham khảo đầy đủ về cấu hình channel: [docs/reference/api/channels-reference.md](docs/reference/api/channels-reference.md). Cài đặt được khuyến nghị (bảo mật + nhanh): @@ -734,7 +734,7 @@ api_key = "ollama_api_key_here" ### Endpoint provider tùy chỉnh -Cấu hình chi tiết cho endpoint tùy chỉnh tương thích OpenAI và Anthropic, xem [docs/custom-providers.md](docs/custom-providers.md). +Cấu hình chi tiết cho endpoint tùy chỉnh tương thích OpenAI và Anthropic, xem [docs/contributing/custom-providers.md](docs/contributing/custom-providers.md). ## Gói Python đi kèm (`zeroclaw-tools`) @@ -894,7 +894,7 @@ Xem [aieos.org](https://aieos.org) để có schema đầy đủ và ví dụ tr | `hardware` | Lệnh khám phá/kiểm tra/thông tin USB | | `peripheral` | Quản lý và flash thiết bị ngoại vi phần cứng | -Để có hướng dẫn lệnh theo tác vụ, xem [`docs/commands-reference.md`](docs/commands-reference.md). +Để có hướng dẫn lệnh theo tác vụ, xem [`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md). ### Opt-In Open-Skills @@ -956,30 +956,30 @@ Bắt đầu từ trung tâm tài liệu để có bản đồ theo tác vụ: - Mục lục tài liệu thống nhất: [`docs/SUMMARY.md`](docs/SUMMARY.md) - Tài liệu tham khảo lệnh: [`docs/i18n/vi/commands-reference.md`](docs/i18n/vi/commands-reference.md) - Tài liệu tham khảo cấu hình: [`docs/i18n/vi/config-reference.md`](docs/i18n/vi/config-reference.md) -- Tài liệu tham khảo provider: [`docs/providers-reference.md`](docs/providers-reference.md) -- Tài liệu tham khảo channel: [`docs/channels-reference.md`](docs/channels-reference.md) -- Sổ tay vận hành: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Tài liệu tham khảo provider: [`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md) +- Tài liệu tham khảo channel: [`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md) +- Sổ tay vận hành: [`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md) - Khắc phục sự cố: [`docs/i18n/vi/troubleshooting.md`](docs/i18n/vi/troubleshooting.md) -- Kiểm kê/phân loại tài liệu: [`docs/docs-inventory.md`](docs/docs-inventory.md) -- Tổng hợp phân loại PR/Issue (tính đến 18/2/2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) +- Kiểm kê/phân loại tài liệu: [`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md) +- Tổng hợp phân loại PR/Issue (tính đến 18/2/2026): [`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md) Tài liệu tham khảo cộng tác cốt lõi: - Trung tâm tài liệu: [docs/i18n/vi/README.md](docs/i18n/vi/README.md) -- Template tài liệu: [docs/doc-template.md](docs/doc-template.md) +- Template tài liệu: [docs/contributing/doc-template.md](docs/contributing/doc-template.md) - Danh sách kiểm tra thay đổi tài liệu: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) -- Tài liệu tham khảo cấu hình channel: [docs/channels-reference.md](docs/channels-reference.md) -- Vận hành phòng mã hóa Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Tài liệu tham khảo cấu hình channel: [docs/reference/api/channels-reference.md](docs/reference/api/channels-reference.md) +- Vận hành phòng mã hóa Matrix: [docs/security/matrix-e2ee-guide.md](docs/security/matrix-e2ee-guide.md) - Hướng dẫn đóng góp: [CONTRIBUTING.md](CONTRIBUTING.md) -- Chính sách quy trình PR: [docs/pr-workflow.md](docs/pr-workflow.md) -- Sổ tay người review (phân loại + review sâu): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) -- Bản đồ sở hữu và phân loại CI: [docs/ci-map.md](docs/ci-map.md) +- Chính sách quy trình PR: [docs/contributing/pr-workflow.md](docs/contributing/pr-workflow.md) +- Sổ tay người review (phân loại + review sâu): [docs/contributing/reviewer-playbook.md](docs/contributing/reviewer-playbook.md) +- Bản đồ sở hữu và phân loại CI: [docs/contributing/ci-map.md](docs/contributing/ci-map.md) - Chính sách tiết lộ bảo mật: [SECURITY.md](SECURITY.md) Cho triển khai và vận hành runtime: -- Hướng dẫn triển khai mạng: [docs/network-deployment.md](docs/network-deployment.md) -- Sổ tay proxy agent: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) +- Hướng dẫn triển khai mạng: [docs/ops/network-deployment.md](docs/ops/network-deployment.md) +- Sổ tay proxy agent: [docs/ops/proxy-agent-playbook.md](docs/ops/proxy-agent-playbook.md) ## Ủng hộ ZeroClaw @@ -1003,7 +1003,7 @@ Chúng tôi xây dựng công khai vì ý tưởng hay đến từ khắp nơi. **Đây là repository ZeroClaw chính thức duy nhất:** > -Bất kỳ repository, tổ chức, tên miền hay gói nào khác tuyên bố là "ZeroClaw" hoặc ngụ ý liên kết với ZeroClaw Labs đều là **không được ủy quyền và không liên kết với dự án này**. Các fork không được ủy quyền đã biết sẽ được liệt kê trong [TRADEMARK.md](docs/project/trademark.md). +Bất kỳ repository, tổ chức, tên miền hay gói nào khác tuyên bố là "ZeroClaw" hoặc ngụ ý liên kết với ZeroClaw Labs đều là **không được ủy quyền và không liên kết với dự án này**. Các fork không được ủy quyền đã biết sẽ được liệt kê trong [TRADEMARK.md](docs/maintainers/trademark.md). Nếu bạn phát hiện hành vi mạo danh hoặc lạm dụng nhãn hiệu, vui lòng [mở một issue](https://github.com/zeroclaw-labs/zeroclaw/issues). @@ -1022,7 +1022,7 @@ Bạn có thể chọn một trong hai giấy phép. **Người đóng góp tự ### Nhãn hiệu -Tên **ZeroClaw** và logo là nhãn hiệu của ZeroClaw Labs. Giấy phép này không cấp phép sử dụng chúng để ngụ ý chứng thực hoặc liên kết. Xem [TRADEMARK.md](docs/project/trademark.md) để biết các sử dụng được phép và bị cấm. +Tên **ZeroClaw** và logo là nhãn hiệu của ZeroClaw Labs. Giấy phép này không cấp phép sử dụng chúng để ngụ ý chứng thực hoặc liên kết. Xem [TRADEMARK.md](docs/maintainers/trademark.md) để biết các sử dụng được phép và bị cấm. ### Bảo vệ người đóng góp @@ -1034,7 +1034,7 @@ Tên **ZeroClaw** và logo là nhãn hiệu của ZeroClaw Labs. Giấy phép n ## Đóng góp Xem [CONTRIBUTING.md](CONTRIBUTING.md) và [CLA.md](docs/contributing/cla.md). Triển khai một trait, gửi PR: -- Hướng dẫn quy trình CI: [docs/ci-map.md](docs/ci-map.md) +- Hướng dẫn quy trình CI: [docs/contributing/ci-map.md](docs/contributing/ci-map.md) - `Provider` mới → `src/providers/` - `Channel` mới → `src/channels/` - `Observer` mới → `src/observability/` diff --git a/README.zh-CN.md b/README.zh-CN.md index f2f2699d3..f5018afb9 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -25,8 +25,8 @@

- 一键部署 | - 安装入门 | + 一键部署 | + 安装入门 | 文档总览 | 文档目录

@@ -34,8 +34,8 @@

场景分流： 参考手册 · - 运维部署 · - 故障排查 · + 运维部署 · + 故障排查 · 安全专题 · 硬件外设 · 贡献与 CI @@ -113,12 +113,12 @@ ls -lh target/release/zeroclaw ```bash git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh ``` -可选环境初始化：`./bootstrap.sh --install-system-deps --install-rust`（可能需要 `sudo`）。 +可选环境初始化：`./install.sh --install-system-deps --install-rust`（可能需要 `sudo`）。 -详细说明见：[`docs/one-click-bootstrap.md`](docs/one-click-bootstrap.md)。 +详细说明见：[`docs/setup-guides/one-click-bootstrap.md`](docs/setup-guides/one-click-bootstrap.md)。 ## 快速开始 @@ -200,7 +200,7 @@ zeroclaw agent --provider anthropic -m "hello" 每个子系统都是一个 **Trait** — 通过配置切换即可更换实现，无需修改代码。

- ZeroClaw 架构图 + ZeroClaw 架构图

| 子系统 | Trait | 内置实现 | 扩展方式 | @@ -284,20 +284,20 @@ allow_public_bind = false - 文档总览（英文）：[`docs/README.md`](docs/README.md) - 统一目录（TOC）：[`docs/SUMMARY.md`](docs/SUMMARY.md) - 文档总览（简体中文）：[`docs/README.zh-CN.md`](docs/README.zh-CN.md) -- 命令参考：[`docs/commands-reference.md`](docs/commands-reference.md) -- 配置参考：[`docs/config-reference.md`](docs/config-reference.md) -- Provider 参考：[`docs/providers-reference.md`](docs/providers-reference.md) -- Channel 参考：[`docs/channels-reference.md`](docs/channels-reference.md) -- 运维手册：[`docs/operations-runbook.md`](docs/operations-runbook.md) -- 故障排查：[`docs/troubleshooting.md`](docs/troubleshooting.md) -- 文档清单与分类：[`docs/docs-inventory.md`](docs/docs-inventory.md) -- 项目 triage 快照（2026-02-18）：[`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) +- 命令参考：[`docs/reference/cli/commands-reference.md`](docs/reference/cli/commands-reference.md) +- 配置参考：[`docs/reference/api/config-reference.md`](docs/reference/api/config-reference.md) +- Provider 参考：[`docs/reference/api/providers-reference.md`](docs/reference/api/providers-reference.md) +- Channel 参考：[`docs/reference/api/channels-reference.md`](docs/reference/api/channels-reference.md) +- 运维手册：[`docs/ops/operations-runbook.md`](docs/ops/operations-runbook.md) +- 故障排查：[`docs/ops/troubleshooting.md`](docs/ops/troubleshooting.md) +- 文档清单与分类：[`docs/maintainers/docs-inventory.md`](docs/maintainers/docs-inventory.md) +- 项目 triage 快照（2026-02-18）：[`docs/maintainers/project-triage-snapshot-2026-02-18.md`](docs/maintainers/project-triage-snapshot-2026-02-18.md) ## 贡献与许可证 - 贡献指南：[`CONTRIBUTING.md`](CONTRIBUTING.md) -- PR 工作流：[`docs/pr-workflow.md`](docs/pr-workflow.md) -- Reviewer 指南：[`docs/reviewer-playbook.md`](docs/reviewer-playbook.md) +- PR 工作流：[`docs/contributing/pr-workflow.md`](docs/contributing/pr-workflow.md) +- Reviewer 指南：[`docs/contributing/reviewer-playbook.md`](docs/contributing/reviewer-playbook.md) - 许可证：MIT 或 Apache 2.0（见 [`LICENSE-MIT`](LICENSE-MIT)、[`LICENSE-APACHE`](LICENSE-APACHE) 与 [`NOTICE`](NOTICE)） --- diff --git a/bootstrap.sh b/bootstrap.sh deleted file mode 100755 index 2c8984dee..000000000 --- a/bootstrap.sh +++ /dev/null @@ -1,5 +0,0 @@ -#!/usr/bin/env bash -set -euo pipefail - -ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" >/dev/null 2>&1 && pwd || pwd)" -exec "$ROOT_DIR/zeroclaw_install.sh" "$@" diff --git a/docs/README.fr.md b/docs/README.fr.md index ce696b9ff..c3ad1512a 100644 --- a/docs/README.fr.md +++ b/docs/README.fr.md @@ -11,24 +11,24 @@ Hubs localisés : [简体中文](README.zh-CN.md) · [日本語](README.ja.md) | Je veux… | Lire ceci | | ------------------------------------------------------------------- | ------------------------------------------------------------------------------ | | Installer et exécuter ZeroClaw rapidement | [README.md (Démarrage Rapide)](../README.md#quick-start) | -| Bootstrap en une seule commande | [one-click-bootstrap.md](one-click-bootstrap.md) | -| Trouver des commandes par tâche | [commands-reference.md](commands-reference.md) | -| Vérifier rapidement les valeurs par défaut et clés de config | [config-reference.md](config-reference.md) | -| Configurer des fournisseurs/endpoints personnalisés | [custom-providers.md](custom-providers.md) | -| Configurer le fournisseur Z.AI / GLM | [zai-glm-setup.md](zai-glm-setup.md) | -| Utiliser les modèles d'intégration LangGraph | [langgraph-integration.md](langgraph-integration.md) | -| Opérer le runtime (runbook jour-2) | [operations-runbook.md](operations-runbook.md) | -| Dépanner les problèmes d'installation/runtime/canal | [troubleshooting.md](troubleshooting.md) | -| Exécuter la configuration et diagnostics de salles chiffrées Matrix | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | +| Bootstrap en une seule commande | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) | +| Trouver des commandes par tâche | [commands-reference.md](reference/cli/commands-reference.md) | +| Vérifier rapidement les valeurs par défaut et clés de config | [config-reference.md](reference/api/config-reference.md) | +| Configurer des fournisseurs/endpoints personnalisés | [custom-providers.md](contributing/custom-providers.md) | +| Configurer le fournisseur Z.AI / GLM | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) | +| Utiliser les modèles d'intégration LangGraph | [langgraph-integration.md](contributing/langgraph-integration.md) | +| Opérer le runtime (runbook jour-2) | [operations-runbook.md](ops/operations-runbook.md) | +| Dépanner les problèmes d'installation/runtime/canal | [troubleshooting.md](ops/troubleshooting.md) | +| Exécuter la configuration et diagnostics de salles chiffrées Matrix | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) | | Parcourir les docs par catégorie | [SUMMARY.md](SUMMARY.md) | -| Voir l'instantané docs des PR/issues du projet | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | +| Voir l'instantané docs des PR/issues du projet | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) | ## Arbre de Décision Rapide (10 secondes) -- Besoin de configuration ou installation initiale ? → [getting-started/README.md](getting-started/README.md) +- Besoin de configuration ou installation initiale ? → [setup-guides/README.md](setup-guides/README.md) - Besoin de clés CLI/config exactes ? → [reference/README.md](reference/README.md) -- Besoin d'opérations de production/service ? → [operations/README.md](operations/README.md) -- Vous voyez des échecs ou régressions ? → [troubleshooting.md](troubleshooting.md) +- Besoin d'opérations de production/service ? → [ops/README.md](ops/README.md) +- Vous voyez des échecs ou régressions ? → [troubleshooting.md](ops/troubleshooting.md) - Vous travaillez sur le durcissement sécurité ou la roadmap ? → [security/README.md](security/README.md) - Vous travaillez avec des cartes/périphériques ? → [hardware/README.md](hardware/README.md) - Contribution/revue/workflow CI ? → [contributing/README.md](contributing/README.md) @@ -36,55 +36,55 @@ Hubs localisés : [简体中文](README.zh-CN.md) · [日本語](README.ja.md) ## Collections (Recommandées) -- Démarrage : [getting-started/README.md](getting-started/README.md) +- Démarrage : [setup-guides/README.md](setup-guides/README.md) - Catalogues de référence : [reference/README.md](reference/README.md) -- Opérations & déploiement : [operations/README.md](operations/README.md) +- Opérations & déploiement : [ops/README.md](ops/README.md) - Docs sécurité : [security/README.md](security/README.md) - Matériel/périphériques : [hardware/README.md](hardware/README.md) - Contribution/CI : [contributing/README.md](contributing/README.md) -- Instantanés projet : [project/README.md](project/README.md) +- Instantanés projet : [maintainers/README.md](maintainers/README.md) ## Par Audience ### Utilisateurs / Opérateurs -- [commands-reference.md](commands-reference.md) — recherche de commandes par workflow -- [providers-reference.md](providers-reference.md) — IDs fournisseurs, alias, variables d'environnement d'identifiants -- [channels-reference.md](channels-reference.md) — capacités des canaux et chemins de configuration -- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) — configuration de salles chiffrées Matrix (E2EE) et diagnostics de non-réponse -- [config-reference.md](config-reference.md) — clés de configuration à haute signalisation et valeurs par défaut sécurisées -- [custom-providers.md](custom-providers.md) — modèles d'intégration de fournisseur personnalisé/URL de base -- [zai-glm-setup.md](zai-glm-setup.md) — configuration Z.AI/GLM et matrice d'endpoints -- [langgraph-integration.md](langgraph-integration.md) — intégration de secours pour les cas limites de modèle/appel d'outil -- [operations-runbook.md](operations-runbook.md) — opérations runtime jour-2 et flux de rollback -- [troubleshooting.md](troubleshooting.md) — signatures d'échec courantes et étapes de récupération +- [commands-reference.md](reference/cli/commands-reference.md) — recherche de commandes par workflow +- [providers-reference.md](reference/api/providers-reference.md) — IDs fournisseurs, alias, variables d'environnement d'identifiants +- [channels-reference.md](reference/api/channels-reference.md) — capacités des canaux et chemins de configuration +- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — configuration de salles chiffrées Matrix (E2EE) et diagnostics de non-réponse +- [config-reference.md](reference/api/config-reference.md) — clés de configuration à haute signalisation et valeurs par défaut sécurisées +- [custom-providers.md](contributing/custom-providers.md) — modèles d'intégration de fournisseur personnalisé/URL de base +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — configuration Z.AI/GLM et matrice d'endpoints +- [langgraph-integration.md](contributing/langgraph-integration.md) — intégration de secours pour les cas limites de modèle/appel d'outil +- [operations-runbook.md](ops/operations-runbook.md) — opérations runtime jour-2 et flux de rollback +- [troubleshooting.md](ops/troubleshooting.md) — signatures d'échec courantes et étapes de récupération ### Contributeurs / Mainteneurs - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### Sécurité / Fiabilité -> Note : cette zone inclut des docs de proposition/roadmap. Pour le comportement actuel, commencez par [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), et [troubleshooting.md](troubleshooting.md). +> Note : cette zone inclut des docs de proposition/roadmap. Pour le comportement actuel, commencez par [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), et [troubleshooting.md](ops/troubleshooting.md). - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [audit-logging.md](audit-logging.md) -- [resource-limits.md](resource-limits.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [audit-logging.md](security/audit-logging.md) +- [resource-limits.md](ops/resource-limits.md) +- [security-roadmap.md](security/security-roadmap.md) ## Navigation Système & Gouvernance - Table des matières unifiée : [SUMMARY.md](SUMMARY.md) -- Carte de structure docs (langue/partie/fonction) : [structure/README.md](structure/README.md) -- Inventaire/classification de la documentation : [docs-inventory.md](docs-inventory.md) -- Instantané de triage du projet : [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- Carte de structure docs (langue/partie/fonction) : [structure/README.md](maintainers/structure-README.md) +- Inventaire/classification de la documentation : [docs-inventory.md](maintainers/docs-inventory.md) +- Instantané de triage du projet : [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) ## Autres langues diff --git a/docs/README.ja.md b/docs/README.ja.md index c552ea857..3cfd4a3f8 100644 --- a/docs/README.ja.md +++ b/docs/README.ja.md @@ -11,23 +11,23 @@ | やりたいこと | 参照先 | |---|---| | すぐにセットアップしたい | [../README.ja.md](../README.ja.md) / [../README.md](../README.md) | -| ワンコマンドで導入したい | [one-click-bootstrap.md](one-click-bootstrap.md) | -| コマンドを用途別に確認したい | [commands-reference.md](commands-reference.md) | -| 設定キーと既定値を確認したい | [config-reference.md](config-reference.md) | -| カスタム Provider / endpoint を追加したい | [custom-providers.md](custom-providers.md) | -| Z.AI / GLM Provider を設定したい | [zai-glm-setup.md](zai-glm-setup.md) | -| LangGraph ツール連携を使いたい | [langgraph-integration.md](langgraph-integration.md) | -| 日常運用（runbook）を確認したい | [operations-runbook.md](operations-runbook.md) | -| インストール/実行トラブルを解決したい | [troubleshooting.md](troubleshooting.md) | +| ワンコマンドで導入したい | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) | +| コマンドを用途別に確認したい | [commands-reference.md](reference/cli/commands-reference.md) | +| 設定キーと既定値を確認したい | [config-reference.md](reference/api/config-reference.md) | +| カスタム Provider / endpoint を追加したい | [custom-providers.md](contributing/custom-providers.md) | +| Z.AI / GLM Provider を設定したい | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) | +| LangGraph ツール連携を使いたい | [langgraph-integration.md](contributing/langgraph-integration.md) | +| 日常運用（runbook）を確認したい | [operations-runbook.md](ops/operations-runbook.md) | +| インストール/実行トラブルを解決したい | [troubleshooting.md](ops/troubleshooting.md) | | 統合 TOC から探したい | [SUMMARY.md](SUMMARY.md) | -| PR/Issue の現状を把握したい | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | +| PR/Issue の現状を把握したい | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) | ## 10秒ルーティング（まずここ） -- 初回セットアップや導入をしたい → [getting-started/README.md](getting-started/README.md) +- 初回セットアップや導入をしたい → [setup-guides/README.md](setup-guides/README.md) - CLI/設定キーを正確に確認したい → [reference/README.md](reference/README.md) -- 本番運用やサービス管理をしたい → [operations/README.md](operations/README.md) -- エラーや不具合を解消したい → [troubleshooting.md](troubleshooting.md) +- 本番運用やサービス管理をしたい → [ops/README.md](ops/README.md) +- エラーや不具合を解消したい → [troubleshooting.md](ops/troubleshooting.md) - セキュリティ方針やロードマップを見たい → [security/README.md](security/README.md) - ボード/周辺機器を扱いたい → [hardware/README.md](hardware/README.md) - 貢献・レビュー・CIを確認したい → [contributing/README.md](contributing/README.md) @@ -35,53 +35,53 @@ ## カテゴリ別ナビゲーション（推奨） -- 入門: [getting-started/README.md](getting-started/README.md) +- 入門: [setup-guides/README.md](setup-guides/README.md) - リファレンス: [reference/README.md](reference/README.md) -- 運用 / デプロイ: [operations/README.md](operations/README.md) +- 運用 / デプロイ: [ops/README.md](ops/README.md) - セキュリティ: [security/README.md](security/README.md) - ハードウェア: [hardware/README.md](hardware/README.md) - コントリビュート / CI: [contributing/README.md](contributing/README.md) -- プロジェクトスナップショット: [project/README.md](project/README.md) +- プロジェクトスナップショット: [maintainers/README.md](maintainers/README.md) ## ロール別 ### ユーザー / オペレーター -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) -- [operations-runbook.md](operations-runbook.md) -- [troubleshooting.md](troubleshooting.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [troubleshooting.md](ops/troubleshooting.md) ### コントリビューター / メンテナー - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### セキュリティ / 信頼性 -> 注: このセクションには proposal/roadmap 文書が含まれ、想定段階のコマンドや設定が記載される場合があります。現行動作は [config-reference.md](config-reference.md)、[operations-runbook.md](operations-runbook.md)、[troubleshooting.md](troubleshooting.md) を優先してください。 +> 注: このセクションには proposal/roadmap 文書が含まれ、想定段階のコマンドや設定が記載される場合があります。現行動作は [config-reference.md](reference/api/config-reference.md)、[operations-runbook.md](ops/operations-runbook.md)、[troubleshooting.md](ops/troubleshooting.md) を優先してください。 - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ## ドキュメント運用 / 分類 - 統合 TOC: [SUMMARY.md](SUMMARY.md) -- ドキュメント構造マップ（言語/カテゴリ/機能）: [structure/README.md](structure/README.md) -- ドキュメント一覧 / 分類: [docs-inventory.md](docs-inventory.md) +- ドキュメント構造マップ（言語/カテゴリ/機能）: [structure/README.md](maintainers/structure-README.md) +- ドキュメント一覧 / 分類: [docs-inventory.md](maintainers/docs-inventory.md) ## 他言語 diff --git a/docs/README.md b/docs/README.md index ac23e5138..c9af0d43e 100644 --- a/docs/README.md +++ b/docs/README.md @@ -11,25 +11,25 @@ Localized hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · | I want to… | Read this | |---|---| | Install and run ZeroClaw quickly | [README.md (Quick Start)](../README.md#quick-start) | -| Bootstrap in one command | [one-click-bootstrap.md](one-click-bootstrap.md) | -| Update or uninstall on macOS | [getting-started/macos-update-uninstall.md](getting-started/macos-update-uninstall.md) | -| Find commands by task | [commands-reference.md](commands-reference.md) | -| Check config defaults and keys quickly | [config-reference.md](config-reference.md) | -| Configure custom providers/endpoints | [custom-providers.md](custom-providers.md) | -| Configure Z.AI / GLM provider | [zai-glm-setup.md](zai-glm-setup.md) | -| Use LangGraph integration patterns | [langgraph-integration.md](langgraph-integration.md) | -| Operate runtime (day-2 runbook) | [operations-runbook.md](operations-runbook.md) | -| Troubleshoot install/runtime/channel issues | [troubleshooting.md](troubleshooting.md) | -| Run Matrix encrypted-room setup and diagnostics | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | +| Bootstrap in one command | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) | +| Update or uninstall on macOS | [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md) | +| Find commands by task | [commands-reference.md](reference/cli/commands-reference.md) | +| Check config defaults and keys quickly | [config-reference.md](reference/api/config-reference.md) | +| Configure custom providers/endpoints | [custom-providers.md](contributing/custom-providers.md) | +| Configure Z.AI / GLM provider | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) | +| Use LangGraph integration patterns | [langgraph-integration.md](contributing/langgraph-integration.md) | +| Operate runtime (day-2 runbook) | [operations-runbook.md](ops/operations-runbook.md) | +| Troubleshoot install/runtime/channel issues | [troubleshooting.md](ops/troubleshooting.md) | +| Run Matrix encrypted-room setup and diagnostics | [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) | | Browse docs by category | [SUMMARY.md](SUMMARY.md) | -| See project PR/issue docs snapshot | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | +| See project PR/issue docs snapshot | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) | ## Quick Decision Tree (10 seconds) -- Need first-time setup or install? → [getting-started/README.md](getting-started/README.md) +- Need first-time setup or install? → [setup-guides/README.md](setup-guides/README.md) - Need exact CLI/config keys? → [reference/README.md](reference/README.md) -- Need production/service operations? → [operations/README.md](operations/README.md) -- Seeing failures or regressions? → [troubleshooting.md](troubleshooting.md) +- Need production/service operations? → [ops/README.md](ops/README.md) +- Seeing failures or regressions? → [troubleshooting.md](ops/troubleshooting.md) - Working on security hardening or roadmap? → [security/README.md](security/README.md) - Working with boards/peripherals? → [hardware/README.md](hardware/README.md) - Contributing/reviewing/CI workflow? → [contributing/README.md](contributing/README.md) @@ -37,54 +37,54 @@ Localized hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · ## Collections (Recommended) -- Getting started: [getting-started/README.md](getting-started/README.md) +- Getting started: [setup-guides/README.md](setup-guides/README.md) - Reference catalogs: [reference/README.md](reference/README.md) -- Operations & deployment: [operations/README.md](operations/README.md) +- Operations & deployment: [ops/README.md](ops/README.md) - Security docs: [security/README.md](security/README.md) - Hardware/peripherals: [hardware/README.md](hardware/README.md) - Contributing/CI: [contributing/README.md](contributing/README.md) -- Project snapshots: [project/README.md](project/README.md) +- Project snapshots: [maintainers/README.md](maintainers/README.md) ## By Audience ### Users / Operators -- [commands-reference.md](commands-reference.md) — command lookup by workflow -- [providers-reference.md](providers-reference.md) — provider IDs, aliases, credential env vars -- [channels-reference.md](channels-reference.md) — channel capabilities and setup paths -- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) — Matrix encrypted-room (E2EE) setup and no-response diagnostics -- [config-reference.md](config-reference.md) — high-signal config keys and secure defaults -- [custom-providers.md](custom-providers.md) — custom provider/base URL integration templates -- [zai-glm-setup.md](zai-glm-setup.md) — Z.AI/GLM setup and endpoint matrix -- [langgraph-integration.md](langgraph-integration.md) — fallback integration for model/tool-calling edge cases -- [operations-runbook.md](operations-runbook.md) — day-2 runtime operations and rollback flow -- [troubleshooting.md](troubleshooting.md) — common failure signatures and recovery steps +- [commands-reference.md](reference/cli/commands-reference.md) — command lookup by workflow +- [providers-reference.md](reference/api/providers-reference.md) — provider IDs, aliases, credential env vars +- [channels-reference.md](reference/api/channels-reference.md) — channel capabilities and setup paths +- [matrix-e2ee-guide.md](security/matrix-e2ee-guide.md) — Matrix encrypted-room (E2EE) setup and no-response diagnostics +- [config-reference.md](reference/api/config-reference.md) — high-signal config keys and secure defaults +- [custom-providers.md](contributing/custom-providers.md) — custom provider/base URL integration templates +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) — Z.AI/GLM setup and endpoint matrix +- [langgraph-integration.md](contributing/langgraph-integration.md) — fallback integration for model/tool-calling edge cases +- [operations-runbook.md](ops/operations-runbook.md) — day-2 runtime operations and rollback flow +- [troubleshooting.md](ops/troubleshooting.md) — common failure signatures and recovery steps ### Contributors / Maintainers - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### Security / Reliability -> Note: this area includes proposal/roadmap docs. For current behavior, start with [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). +> Note: this area includes proposal/roadmap docs. For current behavior, start with [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), and [troubleshooting.md](ops/troubleshooting.md). - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [audit-logging.md](audit-logging.md) -- [resource-limits.md](resource-limits.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [audit-logging.md](security/audit-logging.md) +- [resource-limits.md](ops/resource-limits.md) +- [security-roadmap.md](security/security-roadmap.md) ## System Navigation & Governance - Unified TOC: [SUMMARY.md](SUMMARY.md) -- Docs structure map (language/part/function): [structure/README.md](structure/README.md) -- Documentation inventory/classification: [docs-inventory.md](docs-inventory.md) +- Docs structure map (language/part/function): [structure/README.md](maintainers/structure-README.md) +- Documentation inventory/classification: [docs-inventory.md](maintainers/docs-inventory.md) - i18n docs index: [i18n/README.md](i18n/README.md) -- i18n coverage map: [i18n-coverage.md](i18n-coverage.md) -- Project triage snapshot: [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- i18n coverage map: [i18n-coverage.md](maintainers/i18n-coverage.md) +- Project triage snapshot: [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) diff --git a/docs/README.ru.md b/docs/README.ru.md index 0c131c4ee..2b63e9623 100644 --- a/docs/README.ru.md +++ b/docs/README.ru.md @@ -11,23 +11,23 @@ | Что нужно | Куда смотреть | |---|---| | Быстро установить и запустить | [../README.ru.md](../README.ru.md) / [../README.md](../README.md) | -| Установить одной командой | [one-click-bootstrap.md](one-click-bootstrap.md) | -| Найти команды по задаче | [commands-reference.md](commands-reference.md) | -| Проверить ключи конфигурации и дефолты | [config-reference.md](config-reference.md) | -| Подключить кастомный provider / endpoint | [custom-providers.md](custom-providers.md) | -| Настроить provider Z.AI / GLM | [zai-glm-setup.md](zai-glm-setup.md) | -| Использовать интеграцию LangGraph | [langgraph-integration.md](langgraph-integration.md) | -| Операционный runbook (day-2) | [operations-runbook.md](operations-runbook.md) | -| Быстро устранить типовые проблемы | [troubleshooting.md](troubleshooting.md) | +| Установить одной командой | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) | +| Найти команды по задаче | [commands-reference.md](reference/cli/commands-reference.md) | +| Проверить ключи конфигурации и дефолты | [config-reference.md](reference/api/config-reference.md) | +| Подключить кастомный provider / endpoint | [custom-providers.md](contributing/custom-providers.md) | +| Настроить provider Z.AI / GLM | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) | +| Использовать интеграцию LangGraph | [langgraph-integration.md](contributing/langgraph-integration.md) | +| Операционный runbook (day-2) | [operations-runbook.md](ops/operations-runbook.md) | +| Быстро устранить типовые проблемы | [troubleshooting.md](ops/troubleshooting.md) | | Открыть общий TOC docs | [SUMMARY.md](SUMMARY.md) | -| Посмотреть snapshot PR/Issue | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | +| Посмотреть snapshot PR/Issue | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) | ## Дерево решений на 10 секунд -- Нужна первая установка и быстрый старт → [getting-started/README.md](getting-started/README.md) +- Нужна первая установка и быстрый старт → [setup-guides/README.md](setup-guides/README.md) - Нужны точные команды и ключи конфигурации → [reference/README.md](reference/README.md) -- Нужны операции/сервисный режим/деплой → [operations/README.md](operations/README.md) -- Есть ошибки, сбои или регрессии → [troubleshooting.md](troubleshooting.md) +- Нужны операции/сервисный режим/деплой → [ops/README.md](ops/README.md) +- Есть ошибки, сбои или регрессии → [troubleshooting.md](ops/troubleshooting.md) - Нужны материалы по безопасности и roadmap → [security/README.md](security/README.md) - Работаете с платами и периферией → [hardware/README.md](hardware/README.md) - Нужны процессы вклада, ревью и CI → [contributing/README.md](contributing/README.md) @@ -35,53 +35,53 @@ ## Навигация по категориям (рекомендуется) -- Старт и установка: [getting-started/README.md](getting-started/README.md) +- Старт и установка: [setup-guides/README.md](setup-guides/README.md) - Справочники: [reference/README.md](reference/README.md) -- Операции и деплой: [operations/README.md](operations/README.md) +- Операции и деплой: [ops/README.md](ops/README.md) - Безопасность: [security/README.md](security/README.md) - Аппаратная часть: [hardware/README.md](hardware/README.md) - Вклад и CI: [contributing/README.md](contributing/README.md) -- Снимки проекта: [project/README.md](project/README.md) +- Снимки проекта: [maintainers/README.md](maintainers/README.md) ## По ролям ### Пользователи / Операторы -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) -- [operations-runbook.md](operations-runbook.md) -- [troubleshooting.md](troubleshooting.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [troubleshooting.md](ops/troubleshooting.md) ### Контрибьюторы / Мейнтейнеры - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### Безопасность / Надёжность -> Примечание: часть документов в этом разделе относится к proposal/roadmap и может содержать гипотетические команды/конфигурации. Для текущего поведения сначала смотрите [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), [troubleshooting.md](troubleshooting.md). +> Примечание: часть документов в этом разделе относится к proposal/roadmap и может содержать гипотетические команды/конфигурации. Для текущего поведения сначала смотрите [config-reference.md](reference/api/config-reference.md), [operations-runbook.md](ops/operations-runbook.md), [troubleshooting.md](ops/troubleshooting.md). - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ## Инвентаризация и структура docs - Единый TOC: [SUMMARY.md](SUMMARY.md) -- Карта структуры docs (язык/раздел/функция): [structure/README.md](structure/README.md) -- Инвентарь и классификация docs: [docs-inventory.md](docs-inventory.md) +- Карта структуры docs (язык/раздел/функция): [structure/README.md](maintainers/structure-README.md) +- Инвентарь и классификация docs: [docs-inventory.md](maintainers/docs-inventory.md) ## Другие языки diff --git a/docs/README.vi.md b/docs/README.vi.md index 2932e7d3c..693c9c309 100644 --- a/docs/README.vi.md +++ b/docs/README.vi.md @@ -13,7 +13,7 @@ Hub bản địa hóa: [简体中文](README.zh-CN.md) · [日本語](README.ja. | Tôi muốn… | Xem tài liệu | | -------------------------------------------------- | ------------------------------------------------------------------------------ | | Cài đặt và chạy nhanh | [README.vi.md (Khởi động nhanh)](../README.vi.md) / [../README.md](../README.md) | -| Cài đặt bằng một lệnh | [one-click-bootstrap.md](one-click-bootstrap.md) | +| Cài đặt bằng một lệnh | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) | | Tìm lệnh theo tác vụ | [commands-reference.md](i18n/vi/commands-reference.md) | | Kiểm tra giá trị mặc định và khóa cấu hình | [config-reference.md](i18n/vi/config-reference.md) | | Kết nối provider / endpoint tùy chỉnh | [custom-providers.md](i18n/vi/custom-providers.md) | @@ -23,7 +23,7 @@ Hub bản địa hóa: [简体中文](README.zh-CN.md) · [日本語](README.ja. | Khắc phục sự cố cài đặt/chạy/kênh | [troubleshooting.md](i18n/vi/troubleshooting.md) | | Cấu hình Matrix phòng mã hóa (E2EE) | [matrix-e2ee-guide.md](i18n/vi/matrix-e2ee-guide.md) | | Xem theo danh mục | [SUMMARY.md](i18n/vi/SUMMARY.md) | -| Xem bản chụp PR/Issue | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | +| Xem bản chụp PR/Issue | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) | ## Tìm nhanh (10 giây) @@ -84,8 +84,8 @@ Hub bản địa hóa: [简体中文](README.zh-CN.md) · [日本語](README.ja. ## Quản lý tài liệu - Mục lục thống nhất (TOC): [SUMMARY.md](i18n/vi/SUMMARY.md) -- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [structure/README.md](structure/README.md) -- Danh mục và phân loại tài liệu: [docs-inventory.md](docs-inventory.md) +- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [structure/README.md](maintainers/structure-README.md) +- Danh mục và phân loại tài liệu: [docs-inventory.md](maintainers/docs-inventory.md) ## Ngôn ngữ khác diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md index f4178eaa2..e11d9bc82 100644 --- a/docs/README.zh-CN.md +++ b/docs/README.zh-CN.md @@ -11,23 +11,23 @@ | 我想要… | 建议阅读 | |---|---| | 快速安装并运行 | [../README.zh-CN.md](../README.zh-CN.md) / [../README.md](../README.md) | -| 一键安装与初始化 | [one-click-bootstrap.md](one-click-bootstrap.md) | -| 按任务找命令 | [commands-reference.md](commands-reference.md) | -| 快速查看配置默认值与关键项 | [config-reference.md](config-reference.md) | -| 接入自定义 Provider / endpoint | [custom-providers.md](custom-providers.md) | -| 配置 Z.AI / GLM Provider | [zai-glm-setup.md](zai-glm-setup.md) | -| 使用 LangGraph 工具调用集成 | [langgraph-integration.md](langgraph-integration.md) | -| 进行日常运维（runbook） | [operations-runbook.md](operations-runbook.md) | -| 快速排查安装/运行问题 | [troubleshooting.md](troubleshooting.md) | +| 一键安装与初始化 | [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) | +| 按任务找命令 | [commands-reference.md](reference/cli/commands-reference.md) | +| 快速查看配置默认值与关键项 | [config-reference.md](reference/api/config-reference.md) | +| 接入自定义 Provider / endpoint | [custom-providers.md](contributing/custom-providers.md) | +| 配置 Z.AI / GLM Provider | [zai-glm-setup.md](setup-guides/zai-glm-setup.md) | +| 使用 LangGraph 工具调用集成 | [langgraph-integration.md](contributing/langgraph-integration.md) | +| 进行日常运维（runbook） | [operations-runbook.md](ops/operations-runbook.md) | +| 快速排查安装/运行问题 | [troubleshooting.md](ops/troubleshooting.md) | | 统一目录导航 | [SUMMARY.md](SUMMARY.md) | -| 查看 PR/Issue 扫描快照 | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | +| 查看 PR/Issue 扫描快照 | [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) | ## 10 秒决策树（先看这个） -- 首次安装或快速启动 → [getting-started/README.md](getting-started/README.md) +- 首次安装或快速启动 → [setup-guides/README.md](setup-guides/README.md) - 需要精确命令或配置键 → [reference/README.md](reference/README.md) -- 需要部署与服务化运维 → [operations/README.md](operations/README.md) -- 遇到报错、异常或回归 → [troubleshooting.md](troubleshooting.md) +- 需要部署与服务化运维 → [ops/README.md](ops/README.md) +- 遇到报错、异常或回归 → [troubleshooting.md](ops/troubleshooting.md) - 查看安全现状与路线图 → [security/README.md](security/README.md) - 接入板卡与外设 → [hardware/README.md](hardware/README.md) - 参与贡献、评审与 CI → [contributing/README.md](contributing/README.md) @@ -35,53 +35,53 @@ ## 按目录浏览（推荐） -- 入门文档： [getting-started/README.md](getting-started/README.md) +- 入门文档： [setup-guides/README.md](setup-guides/README.md) - 参考手册： [reference/README.md](reference/README.md) -- 运维与部署： [operations/README.md](operations/README.md) +- 运维与部署： [ops/README.md](ops/README.md) - 安全文档： [security/README.md](security/README.md) - 硬件与外设： [hardware/README.md](hardware/README.md) - 贡献与 CI： [contributing/README.md](contributing/README.md) -- 项目快照： [project/README.md](project/README.md) +- 项目快照： [maintainers/README.md](maintainers/README.md) ## 按角色 ### 用户 / 运维 -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) -- [operations-runbook.md](operations-runbook.md) -- [troubleshooting.md](troubleshooting.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [troubleshooting.md](ops/troubleshooting.md) ### 贡献者 / 维护者 - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### 安全 / 稳定性 -> 说明：本分组内有 proposal/roadmap 文档，可能包含设想中的命令或配置。当前可执行行为请优先阅读 [config-reference.md](config-reference.md)、[operations-runbook.md](operations-runbook.md)、[troubleshooting.md](troubleshooting.md)。 +> 说明：本分组内有 proposal/roadmap 文档，可能包含设想中的命令或配置。当前可执行行为请优先阅读 [config-reference.md](reference/api/config-reference.md)、[operations-runbook.md](ops/operations-runbook.md)、[troubleshooting.md](ops/troubleshooting.md)。 - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ## 文档治理与分类 - 统一目录（TOC）：[SUMMARY.md](SUMMARY.md) -- 文档结构图（按语言/分区/功能）：[structure/README.md](structure/README.md) -- 文档清单与分类：[docs-inventory.md](docs-inventory.md) +- 文档结构图（按语言/分区/功能）：[structure/README.md](maintainers/structure-README.md) +- 文档清单与分类：[docs-inventory.md](maintainers/docs-inventory.md) ## 其他语言 diff --git a/docs/SUMMARY.fr.md b/docs/SUMMARY.fr.md index 925508d70..b9b91fd4e 100644 --- a/docs/SUMMARY.fr.md +++ b/docs/SUMMARY.fr.md @@ -8,7 +8,7 @@ Dernière mise à jour : **18 février 2026**. ## Points d'entrée par langue -- Carte de structure docs (langue/partie/fonction) : [structure/README.md](structure/README.md) +- Carte de structure docs (langue/partie/fonction) : [structure/README.md](maintainers/structure-README.md) - README en anglais : [../README.md](../README.md) - README en chinois : [../README.zh-CN.md](../README.zh-CN.md) - README en japonais : [../README.ja.md](../README.ja.md) @@ -22,68 +22,68 @@ Dernière mise à jour : **18 février 2026**. - Documentation en français : [README.fr.md](README.fr.md) - Documentation en vietnamien : [i18n/vi/README.md](i18n/vi/README.md) - Index de localisation : [i18n/README.md](i18n/README.md) -- Carte de couverture i18n : [i18n-coverage.md](i18n-coverage.md) +- Carte de couverture i18n : [i18n-coverage.md](maintainers/i18n-coverage.md) ## Catégories ### 1) Démarrage rapide -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [setup-guides/README.md](setup-guides/README.md) +- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) ### 2) Référence des commandes, configuration et intégrations - [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) ### 3) Exploitation et déploiement -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [ops/README.md](ops/README.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [release-process.md](contributing/release-process.md) +- [troubleshooting.md](ops/troubleshooting.md) +- [network-deployment.md](ops/network-deployment.md) +- [mattermost-setup.md](setup-guides/mattermost-setup.md) ### 4) Conception de la sécurité et propositions - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ### 5) Matériel et périphériques - [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md) +- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md) +- [nucleo-setup.md](hardware/nucleo-setup.md) +- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md) +- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md) +- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md) +- [datasheets/esp32.md](hardware/datasheets/esp32.md) ### 6) Contribution et CI - [contributing/README.md](contributing/README.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### 7) État du projet et instantanés -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [maintainers/README.md](maintainers/README.md) +- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) +- [docs-inventory.md](maintainers/docs-inventory.md) diff --git a/docs/SUMMARY.ja.md b/docs/SUMMARY.ja.md index 9fe533da1..4c58b83da 100644 --- a/docs/SUMMARY.ja.md +++ b/docs/SUMMARY.ja.md @@ -8,7 +8,7 @@ ## 言語別入口 -- ドキュメント構造マップ（言語/カテゴリ/機能）: [structure/README.md](structure/README.md) +- ドキュメント構造マップ（言語/カテゴリ/機能）: [structure/README.md](maintainers/structure-README.md) - 英語 README：[../README.md](../README.md) - 中国語 README：[../README.zh-CN.md](../README.zh-CN.md) - 日本語 README：[../README.ja.md](../README.ja.md) @@ -22,68 +22,68 @@ - フランス語ドキュメントハブ：[README.fr.md](README.fr.md) - ベトナム語ドキュメントハブ：[i18n/vi/README.md](i18n/vi/README.md) - 国際化ドキュメント索引：[i18n/README.md](i18n/README.md) -- 国際化カバレッジマップ：[i18n-coverage.md](i18n-coverage.md) +- 国際化カバレッジマップ：[i18n-coverage.md](maintainers/i18n-coverage.md) ## カテゴリ ### 1) はじめに -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [setup-guides/README.md](setup-guides/README.md) +- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) ### 2) コマンド・設定リファレンスと統合 - [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) ### 3) 運用とデプロイ -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [ops/README.md](ops/README.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [release-process.md](contributing/release-process.md) +- [troubleshooting.md](ops/troubleshooting.md) +- [network-deployment.md](ops/network-deployment.md) +- [mattermost-setup.md](setup-guides/mattermost-setup.md) ### 4) セキュリティ設計と提案 - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ### 5) ハードウェアと周辺機器 - [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md) +- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md) +- [nucleo-setup.md](hardware/nucleo-setup.md) +- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md) +- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md) +- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md) +- [datasheets/esp32.md](hardware/datasheets/esp32.md) ### 6) コントリビューションと CI - [contributing/README.md](contributing/README.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### 7) プロジェクト状況とスナップショット -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [maintainers/README.md](maintainers/README.md) +- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) +- [docs-inventory.md](maintainers/docs-inventory.md) diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 1f828256e..7a97fd9ec 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -6,7 +6,7 @@ Last refreshed: **February 18, 2026**. ## Language Entry -- Docs Structure Map (language/part/function): [structure/README.md](structure/README.md) +- Docs Structure Map (language/part/function): [structure/README.md](maintainers/structure-README.md) - English README: [../README.md](../README.md) - Chinese README: [../README.zh-CN.md](../README.zh-CN.md) - Japanese README: [../README.ja.md](../README.ja.md) @@ -20,69 +20,69 @@ Last refreshed: **February 18, 2026**. - French Docs Hub: [README.fr.md](README.fr.md) - Vietnamese Docs Hub: [i18n/vi/README.md](i18n/vi/README.md) - i18n Docs Index: [i18n/README.md](i18n/README.md) -- i18n Coverage Map: [i18n-coverage.md](i18n-coverage.md) +- i18n Coverage Map: [i18n-coverage.md](maintainers/i18n-coverage.md) ## Collections ### 1) Getting Started -- [getting-started/README.md](getting-started/README.md) -- [getting-started/macos-update-uninstall.md](getting-started/macos-update-uninstall.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [setup-guides/README.md](setup-guides/README.md) +- [macos-update-uninstall.md](setup-guides/macos-update-uninstall.md) +- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) ### 2) Command/Config References & Integrations - [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) ### 3) Operations & Deployment -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [ops/README.md](ops/README.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [release-process.md](contributing/release-process.md) +- [troubleshooting.md](ops/troubleshooting.md) +- [network-deployment.md](ops/network-deployment.md) +- [mattermost-setup.md](setup-guides/mattermost-setup.md) ### 4) Security Design & Proposals - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ### 5) Hardware & Peripherals - [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md) +- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md) +- [nucleo-setup.md](hardware/nucleo-setup.md) +- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md) +- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md) +- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md) +- [datasheets/esp32.md](hardware/datasheets/esp32.md) ### 6) Contribution & CI - [contributing/README.md](contributing/README.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### 7) Project Status & Snapshot -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [maintainers/README.md](maintainers/README.md) +- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) +- [docs-inventory.md](maintainers/docs-inventory.md) diff --git a/docs/SUMMARY.ru.md b/docs/SUMMARY.ru.md index c8ef697eb..a8f5749a3 100644 --- a/docs/SUMMARY.ru.md +++ b/docs/SUMMARY.ru.md @@ -8,7 +8,7 @@ ## Языковые точки входа -- Карта структуры docs (язык/раздел/функция): [structure/README.md](structure/README.md) +- Карта структуры docs (язык/раздел/функция): [structure/README.md](maintainers/structure-README.md) - README на английском: [../README.md](../README.md) - README на китайском: [../README.zh-CN.md](../README.zh-CN.md) - README на японском: [../README.ja.md](../README.ja.md) @@ -22,68 +22,68 @@ - Документация на французском: [README.fr.md](README.fr.md) - Документация на вьетнамском: [i18n/vi/README.md](i18n/vi/README.md) - Индекс локализации: [i18n/README.md](i18n/README.md) -- Карта покрытия локализации: [i18n-coverage.md](i18n-coverage.md) +- Карта покрытия локализации: [i18n-coverage.md](maintainers/i18n-coverage.md) ## Разделы ### 1) Начало работы -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [setup-guides/README.md](setup-guides/README.md) +- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) ### 2) Справочник команд, конфигурации и интеграций - [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) ### 3) Эксплуатация и развёртывание -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [ops/README.md](ops/README.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [release-process.md](contributing/release-process.md) +- [troubleshooting.md](ops/troubleshooting.md) +- [network-deployment.md](ops/network-deployment.md) +- [mattermost-setup.md](setup-guides/mattermost-setup.md) ### 4) Проектирование безопасности и предложения - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ### 5) Оборудование и периферия - [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md) +- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md) +- [nucleo-setup.md](hardware/nucleo-setup.md) +- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md) +- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md) +- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md) +- [datasheets/esp32.md](hardware/datasheets/esp32.md) ### 6) Участие в проекте и CI - [contributing/README.md](contributing/README.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### 7) Состояние проекта и снимки -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [maintainers/README.md](maintainers/README.md) +- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) +- [docs-inventory.md](maintainers/docs-inventory.md) diff --git a/docs/SUMMARY.zh-CN.md b/docs/SUMMARY.zh-CN.md index dda5b19f9..0add2df15 100644 --- a/docs/SUMMARY.zh-CN.md +++ b/docs/SUMMARY.zh-CN.md @@ -8,7 +8,7 @@ ## 语言入口 -- 文档结构图（按语言/分区/功能）：[structure/README.md](structure/README.md) +- 文档结构图（按语言/分区/功能）：[structure/README.md](maintainers/structure-README.md) - 英文 README：[../README.md](../README.md) - 中文 README：[../README.zh-CN.md](../README.zh-CN.md) - 日文 README：[../README.ja.md](../README.ja.md) @@ -22,68 +22,68 @@ - 法文文档中心：[README.fr.md](README.fr.md) - 越南文文档中心：[i18n/vi/README.md](i18n/vi/README.md) - 国际化文档索引：[i18n/README.md](i18n/README.md) -- 国际化覆盖图：[i18n-coverage.md](i18n-coverage.md) +- 国际化覆盖图：[i18n-coverage.md](maintainers/i18n-coverage.md) ## 分类 ### 1) 快速入门 -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [setup-guides/README.md](setup-guides/README.md) +- [one-click-bootstrap.md](setup-guides/one-click-bootstrap.md) ### 2) 命令 / 配置参考与集成 - [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [commands-reference.md](reference/cli/commands-reference.md) +- [providers-reference.md](reference/api/providers-reference.md) +- [channels-reference.md](reference/api/channels-reference.md) +- [nextcloud-talk-setup.md](setup-guides/nextcloud-talk-setup.md) +- [config-reference.md](reference/api/config-reference.md) +- [custom-providers.md](contributing/custom-providers.md) +- [zai-glm-setup.md](setup-guides/zai-glm-setup.md) +- [langgraph-integration.md](contributing/langgraph-integration.md) ### 3) 运维与部署 -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [ops/README.md](ops/README.md) +- [operations-runbook.md](ops/operations-runbook.md) +- [release-process.md](contributing/release-process.md) +- [troubleshooting.md](ops/troubleshooting.md) +- [network-deployment.md](ops/network-deployment.md) +- [mattermost-setup.md](setup-guides/mattermost-setup.md) ### 4) 安全设计与提案 - [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [agnostic-security.md](security/agnostic-security.md) +- [frictionless-security.md](security/frictionless-security.md) +- [sandboxing.md](security/sandboxing.md) +- [resource-limits.md](ops/resource-limits.md) +- [audit-logging.md](security/audit-logging.md) +- [security-roadmap.md](security/security-roadmap.md) ### 5) 硬件与外设 - [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware-peripherals-design.md](hardware/hardware-peripherals-design.md) +- [adding-boards-and-tools.md](contributing/adding-boards-and-tools.md) +- [nucleo-setup.md](hardware/nucleo-setup.md) +- [arduino-uno-q-setup.md](hardware/arduino-uno-q-setup.md) +- [datasheets/nucleo-f401re.md](hardware/datasheets/nucleo-f401re.md) +- [datasheets/arduino-uno.md](hardware/datasheets/arduino-uno.md) +- [datasheets/esp32.md](hardware/datasheets/esp32.md) ### 6) 贡献与 CI - [contributing/README.md](contributing/README.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [pr-workflow.md](contributing/pr-workflow.md) +- [reviewer-playbook.md](contributing/reviewer-playbook.md) +- [ci-map.md](contributing/ci-map.md) +- [actions-source-policy.md](contributing/actions-source-policy.md) ### 7) 项目状态与快照 -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [maintainers/README.md](maintainers/README.md) +- [project-triage-snapshot-2026-02-18.md](maintainers/project-triage-snapshot-2026-02-18.md) +- [docs-inventory.md](maintainers/docs-inventory.md) diff --git a/docs/contributing/README.md b/docs/contributing/README.md index fba915e87..072353515 100644 --- a/docs/contributing/README.md +++ b/docs/contributing/README.md @@ -5,10 +5,10 @@ For contributors, reviewers, and maintainers. ## Core Policies - Contribution guide: [../../CONTRIBUTING.md](../../CONTRIBUTING.md) -- PR workflow rules: [../pr-workflow.md](../pr-workflow.md) -- Reviewer playbook: [../reviewer-playbook.md](../reviewer-playbook.md) -- CI map and ownership: [../ci-map.md](../ci-map.md) -- Actions source policy: [../actions-source-policy.md](../actions-source-policy.md) +- PR workflow rules: [./pr-workflow.md](./pr-workflow.md) +- Reviewer playbook: [./reviewer-playbook.md](./reviewer-playbook.md) +- CI map and ownership: [./ci-map.md](./ci-map.md) +- Actions source policy: [./actions-source-policy.md](./actions-source-policy.md) ## Suggested Reading Order diff --git a/docs/contributing/adding-boards-and-tools.md b/docs/contributing/adding-boards-and-tools.md index 6bd4a9895..0417b8514 100644 --- a/docs/contributing/adding-boards-and-tools.md +++ b/docs/contributing/adding-boards-and-tools.md @@ -90,7 +90,7 @@ Place PDFs in the datasheet directory. They are extracted and chunked for RAG. 2. **Add to config** — `zeroclaw peripheral add my-board /dev/ttyUSB0` 3. **Implement a peripheral** (optional) — For custom protocols, implement the `Peripheral` trait in `src/peripherals/` and register in `create_peripheral_tools`. -See `docs/hardware-peripherals-design.md` for the full design. +See [`docs/hardware/hardware-peripherals-design.md`](../hardware/hardware-peripherals-design.md) for the full design. ## Adding a Custom Tool diff --git a/docs/contributing/cargo-slicer-speedup.md b/docs/contributing/cargo-slicer-speedup.md index fd9493bf7..10d25e0c5 100644 --- a/docs/contributing/cargo-slicer-speedup.md +++ b/docs/contributing/cargo-slicer-speedup.md @@ -14,7 +14,7 @@ All measurements are clean `cargo +nightly build --release`. MIR-precise mode re ## CI Integration -The workflow [`.github/workflows/ci-build-fast.yml`](../.github/workflows/ci-build-fast.yml) runs an accelerated release build alongside the standard one. It triggers on Rust-code changes and workflow changes, does not gate merges, and runs in parallel as a non-blocking check. +The workflow `.github/workflows/ci-build-fast.yml` (not yet implemented) is intended to run an accelerated release build alongside the standard one. It triggers on Rust-code changes and workflow changes, does not gate merges, and runs in parallel as a non-blocking check. CI uses a resilient two-path strategy: - **Fast path**: install `cargo-slicer` plus the `rustc-driver` binaries and run the MIR-precise sliced build. diff --git a/docs/contributing/ci-map.md b/docs/contributing/ci-map.md index d82a01a4a..613885a54 100644 --- a/docs/contributing/ci-map.md +++ b/docs/contributing/ci-map.md @@ -2,7 +2,7 @@ This document explains what each GitHub workflow does, when it runs, and whether it should block merges. -For event-by-event delivery behavior across PR, merge, push, and release, see [`.github/workflows/master-branch-flow.md`](../.github/workflows/master-branch-flow.md). +For event-by-event delivery behavior across PR, merge, push, and release, see [`.github/workflows/master-branch-flow.md`](../../.github/workflows/master-branch-flow.md). ## Merge-Blocking vs Optional @@ -102,14 +102,14 @@ Merge-blocking checks should stay small and deterministic. Optional checks are u ## Maintenance Rules - Keep merge-blocking checks deterministic and reproducible (`--locked` where applicable). -- Follow `docs/release-process.md` for verify-before-publish release cadence and tag discipline. +- Follow [`docs/contributing/release-process.md`](./release-process.md) for verify-before-publish release cadence and tag discipline. - Keep merge-blocking rust quality policy aligned across `.github/workflows/ci-run.yml`, `dev/ci.sh`, and `.githooks/pre-push` (`./scripts/ci/rust_quality_gate.sh` + `./scripts/ci/rust_strict_delta_gate.sh`). - Use `./scripts/ci/rust_strict_delta_gate.sh` (or `./dev/ci.sh lint-delta`) as the incremental strict merge gate for changed Rust lines. - Run full strict lint audits regularly via `./scripts/ci/rust_quality_gate.sh --strict` (for example through `./dev/ci.sh lint-strict`) and track cleanup in focused PRs. - Keep docs markdown gating incremental via `./scripts/ci/docs_quality_gate.sh` (block changed-line issues, report baseline issues separately). - Keep docs link gating incremental via `./scripts/ci/collect_changed_links.py` + lychee (check only links added on changed lines). - Prefer explicit workflow permissions (least privilege). -- Keep Actions source policy restricted to approved allowlist patterns (see `docs/actions-source-policy.md`). +- Keep Actions source policy restricted to approved allowlist patterns (see [`docs/contributing/actions-source-policy.md`](./actions-source-policy.md)). - Use path filters for expensive workflows when practical. - Keep docs quality checks low-noise (incremental markdown + incremental added-link checks). - Keep dependency update volume controlled (grouping + PR limits). diff --git a/docs/contributing/cla.md b/docs/contributing/cla.md index 2dddf8d41..c97d0d51c 100644 --- a/docs/contributing/cla.md +++ b/docs/contributing/cla.md @@ -84,7 +84,7 @@ You represent that: ## 6. No Trademark Rights This CLA does not grant you any rights to use the ZeroClaw name, -trademarks, service marks, or logos. See docs/project/trademark.md for trademark policy. +trademarks, service marks, or logos. See [trademark.md](../maintainers/trademark.md) for trademark policy. --- diff --git a/docs/contributing/pr-workflow.md b/docs/contributing/pr-workflow.md index 0571929e7..c984b1b5a 100644 --- a/docs/contributing/pr-workflow.md +++ b/docs/contributing/pr-workflow.md @@ -11,7 +11,7 @@ This document defines how ZeroClaw handles high PR volume while maintaining: Related references: -- [`docs/README.md`](./README.md) for documentation taxonomy and navigation. +- [`docs/README.md`](../README.md) for documentation taxonomy and navigation. - [`docs/ci-map.md`](./ci-map.md) for per-workflow ownership, triggers, and triage flow. - [`docs/reviewer-playbook.md`](./reviewer-playbook.md) for day-to-day reviewer execution. @@ -352,7 +352,7 @@ This keeps context loss low and avoids repeated deep dives. ## 15. Related Docs -- [README.md](./README.md) — documentation taxonomy and navigation. +- [README.md](../README.md) — documentation taxonomy and navigation. - [ci-map.md](./ci-map.md) — CI workflow ownership and triage map. - [reviewer-playbook.md](./reviewer-playbook.md) — reviewer execution model. - [actions-source-policy.md](./actions-source-policy.md) — action source allowlist policy. diff --git a/docs/contributing/reviewer-playbook.md b/docs/contributing/reviewer-playbook.md index 3a0285695..a04ab7299 100644 --- a/docs/contributing/reviewer-playbook.md +++ b/docs/contributing/reviewer-playbook.md @@ -1,7 +1,7 @@ # Reviewer Playbook This playbook is the operational companion to [`docs/pr-workflow.md`](./pr-workflow.md). -For broader documentation navigation, use [`docs/README.md`](./README.md). +For broader documentation navigation, use [`docs/README.md`](../README.md). ## 0. Summary @@ -177,7 +177,7 @@ If handing off review to another maintainer/agent, include: ## 8. Related Docs -- [README.md](./README.md) — documentation taxonomy and navigation. +- [README.md](../README.md) — documentation taxonomy and navigation. - [pr-workflow.md](./pr-workflow.md) — governance workflow and merge contract. - [ci-map.md](./ci-map.md) — CI ownership and triage map. - [actions-source-policy.md](./actions-source-policy.md) — action source allowlist policy. diff --git a/docs/contributing/testing.md b/docs/contributing/testing.md index b9a9afea3..629cb525f 100644 --- a/docs/contributing/testing.md +++ b/docs/contributing/testing.md @@ -298,6 +298,6 @@ If all tests pass: ## 📞 Support -- Issues: https://github.com/theonlyhennygod/zeroclaw/issues -- Docs: `docs/contributing/testing-telegram.md` +- Issues: https://github.com/zeroclaw-labs/zeroclaw/issues +- Docs: [testing-telegram.md](../../tests/telegram/testing-telegram.md) - Help: `zeroclaw --help` diff --git a/docs/hardware/README.md b/docs/hardware/README.md index ca0a62a41..4e854c755 100644 --- a/docs/hardware/README.md +++ b/docs/hardware/README.md @@ -2,18 +2,18 @@ For board integration, firmware flow, and peripheral architecture. -ZeroClaw's hardware subsystem enables direct control of microcontrollers and peripherals via the `Peripheral` trait. Each board exposes tools for GPIO, ADC, and sensor operations, allowing agent-driven hardware interaction on boards like STM32 Nucleo, Raspberry Pi, and ESP32. See [hardware-peripherals-design.md](../hardware-peripherals-design.md) for the full architecture. +ZeroClaw's hardware subsystem enables direct control of microcontrollers and peripherals via the `Peripheral` trait. Each board exposes tools for GPIO, ADC, and sensor operations, allowing agent-driven hardware interaction on boards like STM32 Nucleo, Raspberry Pi, and ESP32. See [hardware-peripherals-design.md](hardware-peripherals-design.md) for the full architecture. ## Entry Points -- Architecture and peripheral model: [../hardware-peripherals-design.md](../hardware-peripherals-design.md) -- Add a new board/tool: [../adding-boards-and-tools.md](../adding-boards-and-tools.md) -- Nucleo setup: [../nucleo-setup.md](../nucleo-setup.md) -- Arduino Uno R4 WiFi setup: [../arduino-uno-q-setup.md](../arduino-uno-q-setup.md) +- Architecture and peripheral model: [hardware-peripherals-design.md](hardware-peripherals-design.md) +- Add a new board/tool: [../contributing/adding-boards-and-tools.md](../contributing/adding-boards-and-tools.md) +- Nucleo setup: [nucleo-setup.md](nucleo-setup.md) +- Arduino Uno R4 WiFi setup: [arduino-uno-q-setup.md](arduino-uno-q-setup.md) ## Datasheets -- Datasheet index: [../datasheets](../datasheets) -- STM32 Nucleo-F401RE: [../datasheets/nucleo-f401re.md](../datasheets/nucleo-f401re.md) -- Arduino Uno: [../datasheets/arduino-uno.md](../datasheets/arduino-uno.md) -- ESP32: [../datasheets/esp32.md](../datasheets/esp32.md) +- Datasheet index: [datasheets](datasheets) +- STM32 Nucleo-F401RE: [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) +- Arduino Uno: [datasheets/arduino-uno.md](datasheets/arduino-uno.md) +- ESP32: [datasheets/esp32.md](datasheets/esp32.md) diff --git a/docs/hardware/hardware-peripherals-design.md b/docs/hardware/hardware-peripherals-design.md index 87f61bfa7..125e69981 100644 --- a/docs/hardware/hardware-peripherals-design.md +++ b/docs/hardware/hardware-peripherals-design.md @@ -304,8 +304,8 @@ Simple JSON over serial for boards without gRPC support: ## 12. Related Documents -- [adding-boards-and-tools.md](./adding-boards-and-tools.md) — How to add boards and datasheets -- [network-deployment.md](./network-deployment.md) — RPi and network deployment +- [adding-boards-and-tools.md](../contributing/adding-boards-and-tools.md) — How to add boards and datasheets +- [network-deployment.md](../ops/network-deployment.md) — RPi and network deployment ## 13. References diff --git a/docs/i18n/README.md b/docs/i18n/README.md index 1769166d1..545ee6a75 100644 --- a/docs/i18n/README.md +++ b/docs/i18n/README.md @@ -8,8 +8,8 @@ Canonical localized documentation trees live here. ## Structure -- Docs structure map (language/part/function): [../structure/README.md](../structure/README.md) +- Docs structure map (language/part/function): [../maintainers/structure-README.md](../maintainers/structure-README.md) - Canonical Vietnamese tree: `docs/i18n/vi/` - Compatibility Vietnamese paths: `docs/vi/` and `docs/*.vi.md` -See overall coverage and conventions in [../i18n-coverage.md](../i18n-coverage.md). +See overall coverage and conventions in [../maintainers/i18n-coverage.md](../maintainers/i18n-coverage.md). diff --git a/docs/i18n/vi/README.md b/docs/i18n/vi/README.md index 4a86dd57b..3450a784c 100644 --- a/docs/i18n/vi/README.md +++ b/docs/i18n/vi/README.md @@ -21,7 +21,7 @@ | Khắc phục sự cố cài đặt/chạy/kênh | [troubleshooting.md](troubleshooting.md) | | Cấu hình Matrix phòng mã hóa (E2EE) | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | | Xem theo danh mục | [SUMMARY.md](SUMMARY.md) | -| Xem bản chụp PR/Issue | [project-triage-snapshot-2026-02-18.md](../../project-triage-snapshot-2026-02-18.md) | +| Xem bản chụp PR/Issue | [project-triage-snapshot-2026-02-18.md](../../maintainers/project-triage-snapshot-2026-02-18.md) | ## Tìm nhanh @@ -82,8 +82,8 @@ ## Quản lý tài liệu - Mục lục thống nhất (TOC): [SUMMARY.md](SUMMARY.md) -- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [../../structure/README.md](../../structure/README.md) -- Danh mục và phân loại tài liệu: [docs-inventory.md](../../docs-inventory.md) +- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [../../maintainers/structure-README.md](../../maintainers/structure-README.md) +- Danh mục và phân loại tài liệu: [docs-inventory.md](../../maintainers/docs-inventory.md) ## Ngôn ngữ khác diff --git a/docs/i18n/vi/SUMMARY.md b/docs/i18n/vi/SUMMARY.md index ce0280bd1..56970141b 100644 --- a/docs/i18n/vi/SUMMARY.md +++ b/docs/i18n/vi/SUMMARY.md @@ -6,7 +6,7 @@ ## Điểm vào -- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [../../structure/README.md](../../structure/README.md) +- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [../../maintainers/structure-README.md](../../maintainers/structure-README.md) - README tiếng Việt: [../../../README.vi.md](../../../README.vi.md) - Docs hub tiếng Việt: [README.md](README.md) diff --git a/docs/i18n/vi/one-click-bootstrap.md b/docs/i18n/vi/one-click-bootstrap.md index dcda26ff9..41f1496c6 100644 --- a/docs/i18n/vi/one-click-bootstrap.md +++ b/docs/i18n/vi/one-click-bootstrap.md @@ -15,7 +15,7 @@ brew install zeroclaw ```bash git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh ``` Mặc định script sẽ: @@ -33,19 +33,19 @@ Build từ mã nguồn thường yêu cầu tối thiểu: Khi tài nguyên hạn chế, bootstrap sẽ thử tải binary dựng sẵn trước. ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` Chỉ dùng binary dựng sẵn, báo lỗi nếu không tìm thấy bản phù hợp: ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` Bỏ qua binary dựng sẵn, buộc build từ mã nguồn: ```bash -./bootstrap.sh --force-source-build +./install.sh --force-source-build ``` ## Bootstrap kép @@ -55,7 +55,7 @@ Mặc định là **chỉ ứng dụng** (build/cài ZeroClaw), yêu cầu Rust Với máy mới, bật bootstrap môi trường: ```bash -./bootstrap.sh --install-system-deps --install-rust +./install.sh --install-system-deps --install-rust ``` Lưu ý: @@ -69,19 +69,11 @@ Lưu ý: ## Cách B: Lệnh từ xa một dòng ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` Với môi trường yêu cầu bảo mật cao, nên dùng Cách A để kiểm tra script trước khi chạy. -Tương thích ngược: - -```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash -``` - -Endpoint cũ này ưu tiên chuyển tiếp đến `scripts/bootstrap.sh`, nếu không có thì dùng cài đặt từ nguồn kiểu cũ. - Nếu chạy Cách B ngoài thư mục repo, bootstrap script sẽ tự clone workspace tạm, build, cài đặt rồi dọn dẹp. ## Chế độ thiết lập tùy chọn @@ -89,7 +81,7 @@ Nếu chạy Cách B ngoài thư mục repo, bootstrap script sẽ tự clone wo ### Thiết lập trong container (Docker) ```bash -./bootstrap.sh --docker +./install.sh --docker ``` Lệnh này build image ZeroClaw cục bộ và chạy thiết lập trong container, lưu config/workspace vào `./.zeroclaw-docker`. @@ -97,19 +89,19 @@ Lệnh này build image ZeroClaw cục bộ và chạy thiết lập trong conta ### Thiết lập nhanh (không tương tác) ```bash -./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter +./install.sh --onboard --api-key "sk-..." --provider openrouter ``` Hoặc dùng biến môi trường: ```bash -ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./bootstrap.sh --onboard +ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./install.sh --onboard ``` ### Thiết lập tương tác ```bash -./bootstrap.sh --interactive-onboard +./install.sh --interactive-onboard ``` ## Các cờ hữu ích @@ -123,7 +115,7 @@ ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./bootstrap.sh --onboar Xem tất cả tùy chọn: ```bash -./bootstrap.sh --help +./install.sh --help ``` ## Tài liệu liên quan diff --git a/docs/i18n/vi/project/README.md b/docs/i18n/vi/project/README.md index f779b5ca0..30d9df9fe 100644 --- a/docs/i18n/vi/project/README.md +++ b/docs/i18n/vi/project/README.md @@ -4,7 +4,7 @@ Snapshot trạng thái dự án có giới hạn thời gian cho tài liệu l ## Snapshot hiện tại -- [project-triage-snapshot-2026-02-18.md](../../../project-triage-snapshot-2026-02-18.md) +- [project-triage-snapshot-2026-02-18.md](../../../maintainers/project-triage-snapshot-2026-02-18.md) ## Phạm vi @@ -14,4 +14,4 @@ Snapshot dự án là các đánh giá có giới hạn thời gian về PR mở - Ưu tiên bảo trì tài liệu song song với thay đổi code - Theo dõi áp lực PR/issue đang phát triển theo thời gian -Để phân loại tài liệu ổn định (không giới hạn thời gian), dùng [docs-inventory.md](../../../docs-inventory.md). +Để phân loại tài liệu ổn định (không giới hạn thời gian), dùng [docs-inventory.md](../../../maintainers/docs-inventory.md). diff --git a/docs/i18n/vi/reference/README.md b/docs/i18n/vi/reference/README.md index 626cf8723..25b5df663 100644 --- a/docs/i18n/vi/reference/README.md +++ b/docs/i18n/vi/reference/README.md @@ -19,4 +19,4 @@ Tra cứu lệnh, provider, channel, config và tích hợp. Sử dụng bộ sưu tập này khi bạn cần chi tiết CLI/config chính xác hoặc các mẫu tích hợp provider thay vì hướng dẫn từng bước. -Khi thêm tài liệu tham chiếu/tích hợp mới, hãy đảm bảo nó được liên kết trong cả [../SUMMARY.md](../SUMMARY.md) và [docs-inventory.md](../../../docs-inventory.md). +Khi thêm tài liệu tham chiếu/tích hợp mới, hãy đảm bảo nó được liên kết trong cả [../SUMMARY.md](../SUMMARY.md) và [docs-inventory.md](../../../maintainers/docs-inventory.md). diff --git a/docs/i18n/vi/troubleshooting.md b/docs/i18n/vi/troubleshooting.md index 876fbb942..cbf9c8b7b 100644 --- a/docs/i18n/vi/troubleshooting.md +++ b/docs/i18n/vi/troubleshooting.md @@ -15,7 +15,7 @@ Triệu chứng: Khắc phục: ```bash -./bootstrap.sh --install-rust +./install.sh --install-rust ``` Hoặc cài từ . @@ -29,7 +29,7 @@ Triệu chứng: Khắc phục: ```bash -./bootstrap.sh --install-system-deps +./install.sh --install-system-deps ``` ### Build thất bại trên máy ít RAM / ít dung lượng @@ -48,13 +48,13 @@ Nguyên nhân: Cách tốt nhất cho máy hạn chế tài nguyên: ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` Chế độ chỉ dùng binary (không build từ nguồn): ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` Nếu bắt buộc phải build từ nguồn trên máy yếu: @@ -209,17 +209,12 @@ Xem log trên Linux: journalctl --user -u zeroclaw.service -f ``` -## Tương thích cài đặt cũ - -Cả hai cách vẫn hoạt động: +## URL cài đặt ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` -`install.sh` là điểm vào tương thích, chuyển tiếp/dự phòng về hành vi bootstrap. - ## Vẫn chưa giải quyết được? Thu thập và đính kèm các thông tin sau khi tạo issue: diff --git a/docs/maintainers/README.md b/docs/maintainers/README.md index 478200c47..3f97f06fc 100644 --- a/docs/maintainers/README.md +++ b/docs/maintainers/README.md @@ -4,7 +4,7 @@ Time-bound project status snapshots for planning documentation and operations wo ## Current Snapshot -- [../project-triage-snapshot-2026-02-18.md](../project-triage-snapshot-2026-02-18.md) +- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) ## Scope @@ -14,4 +14,4 @@ Project snapshots are time-bound assessments of open PRs, issues, and documentat - Prioritize docs maintenance alongside code changes - Track evolving PR/issue pressure over time -For stable documentation classification (not time-bound), use [docs-inventory.md](../docs-inventory.md). +For stable documentation classification (not time-bound), use [docs-inventory.md](docs-inventory.md). diff --git a/docs/maintainers/repo-map.md b/docs/maintainers/repo-map.md index 928aeac5c..bedfdc7ce 100644 --- a/docs/maintainers/repo-map.md +++ b/docs/maintainers/repo-map.md @@ -56,7 +56,7 @@ zeroclaw/ ├── Dockerfile # Container build ├── docker-compose.yml # Service composition ├── flake.nix # Nix dev environment -└── bootstrap.sh # One-command setup script +└── install.sh # One-command setup script ``` --- diff --git a/docs/ops/README.md b/docs/ops/README.md index 876c637ac..e13fa242d 100644 --- a/docs/ops/README.md +++ b/docs/ops/README.md @@ -4,11 +4,11 @@ For operators running ZeroClaw in persistent or production-like environments. ## Core Operations -- Day-2 runbook: [../operations-runbook.md](../operations-runbook.md) -- Release runbook: [../release-process.md](../release-process.md) -- Troubleshooting matrix: [../troubleshooting.md](../troubleshooting.md) -- Safe network/gateway deployment: [../network-deployment.md](../network-deployment.md) -- Mattermost setup (channel-specific): [../mattermost-setup.md](../mattermost-setup.md) +- Day-2 runbook: [./operations-runbook.md](./operations-runbook.md) +- Release runbook: [../contributing/release-process.md](../contributing/release-process.md) +- Troubleshooting matrix: [./troubleshooting.md](./troubleshooting.md) +- Safe network/gateway deployment: [./network-deployment.md](./network-deployment.md) +- Mattermost setup (channel-specific): [../setup-guides/mattermost-setup.md](../setup-guides/mattermost-setup.md) ## Common Flow @@ -20,5 +20,5 @@ For operators running ZeroClaw in persistent or production-like environments. ## Related -- Config reference: [../config-reference.md](../config-reference.md) +- Config reference: [../reference/api/config-reference.md](../reference/api/config-reference.md) - Security collection: [../security/README.md](../security/README.md) diff --git a/docs/ops/network-deployment.md b/docs/ops/network-deployment.md index 00d3e3022..f92e7ea30 100644 --- a/docs/ops/network-deployment.md +++ b/docs/ops/network-deployment.md @@ -299,7 +299,7 @@ sudo zeroclaw service uninstall ## 8. References -- [channels-reference.md](./channels-reference.md) — Channel configuration overview -- [matrix-e2ee-guide.md](./matrix-e2ee-guide.md) — Matrix setup and encrypted-room troubleshooting -- [hardware-peripherals-design.md](./hardware-peripherals-design.md) — Peripherals design -- [adding-boards-and-tools.md](./adding-boards-and-tools.md) — Hardware setup and adding boards +- [channels-reference.md](../reference/api/channels-reference.md) — Channel configuration overview +- [matrix-e2ee-guide.md](../security/matrix-e2ee-guide.md) — Matrix setup and encrypted-room troubleshooting +- [hardware-peripherals-design.md](../hardware/hardware-peripherals-design.md) — Peripherals design +- [adding-boards-and-tools.md](../contributing/adding-boards-and-tools.md) — Hardware setup and adding boards diff --git a/docs/ops/operations-runbook.md b/docs/ops/operations-runbook.md index 9eb740fbe..8193e706f 100644 --- a/docs/ops/operations-runbook.md +++ b/docs/ops/operations-runbook.md @@ -13,7 +13,7 @@ Use this document for day-2 operations: - safe rollout and rollback - incident triage and recovery -For first-time installation, start from [one-click-bootstrap.md](one-click-bootstrap.md). +For first-time installation, start from [one-click-bootstrap.md](../setup-guides/one-click-bootstrap.md). ## Runtime Modes @@ -122,7 +122,7 @@ If a rollout regresses behavior: ## Related Docs -- [one-click-bootstrap.md](one-click-bootstrap.md) -- [troubleshooting.md](troubleshooting.md) -- [config-reference.md](config-reference.md) -- [commands-reference.md](commands-reference.md) +- [one-click-bootstrap.md](../setup-guides/one-click-bootstrap.md) +- [troubleshooting.md](./troubleshooting.md) +- [config-reference.md](../reference/api/config-reference.md) +- [commands-reference.md](../reference/cli/commands-reference.md) diff --git a/docs/ops/resource-limits.md b/docs/ops/resource-limits.md index 4b85977da..8a1c5ba09 100644 --- a/docs/ops/resource-limits.md +++ b/docs/ops/resource-limits.md @@ -3,7 +3,7 @@ > ⚠️ **Status: Proposal / Roadmap** > > This document describes proposed approaches and may include hypothetical commands or config. -> For current runtime behavior, see [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). +> For current runtime behavior, see [config-reference.md](../reference/api/config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). ## Problem ZeroClaw has rate limiting (20 actions/hour) but no resource caps. A runaway agent could: diff --git a/docs/ops/troubleshooting.md b/docs/ops/troubleshooting.md index 903ab409c..fb8cddf4e 100644 --- a/docs/ops/troubleshooting.md +++ b/docs/ops/troubleshooting.md @@ -15,7 +15,7 @@ Symptom: Fix: ```bash -./bootstrap.sh --install-rust +./install.sh --install-rust ``` Or install from . @@ -29,7 +29,7 @@ Symptom: Fix: ```bash -./bootstrap.sh --install-system-deps +./install.sh --install-system-deps ``` ### Build fails on low-RAM / low-disk hosts @@ -48,13 +48,13 @@ Why this happens: Preferred path for constrained machines: ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` Binary-only mode (no source fallback): ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` If you must compile from source on constrained hosts: @@ -215,17 +215,12 @@ Linux logs: journalctl --user -u zeroclaw.service -f ``` -## Legacy Installer Compatibility - -Both still work: +## Installer URL ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` -`install.sh` is a compatibility entry and forwards/falls back to bootstrap behavior. - ## Still Stuck? Collect and include these outputs when filing an issue: @@ -242,6 +237,6 @@ Also include OS, install method, and sanitized config snippets (no secrets). ## Related Docs - [operations-runbook.md](operations-runbook.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) -- [channels-reference.md](channels-reference.md) +- [one-click-bootstrap.md](../setup-guides/one-click-bootstrap.md) +- [channels-reference.md](../reference/api/channels-reference.md) - [network-deployment.md](network-deployment.md) diff --git a/docs/ops/troubleshooting.vi.md b/docs/ops/troubleshooting.vi.md index 93190cb1a..182b2d68d 100644 --- a/docs/ops/troubleshooting.vi.md +++ b/docs/ops/troubleshooting.vi.md @@ -2,6 +2,6 @@ Canonical page: -- [i18n/vi/troubleshooting.md](i18n/vi/troubleshooting.md) +- [i18n/vi/troubleshooting.md](../i18n/vi/troubleshooting.md) Compatibility shim only. diff --git a/docs/reference/README.md b/docs/reference/README.md index aa215eb4d..874bc11e8 100644 --- a/docs/reference/README.md +++ b/docs/reference/README.md @@ -4,20 +4,20 @@ Structured reference index for commands, providers, channels, config, and integr ## Core References -- Commands by workflow: [../commands-reference.md](../commands-reference.md) -- Provider IDs / aliases / env vars: [../providers-reference.md](../providers-reference.md) -- Channel setup + allowlists: [../channels-reference.md](../channels-reference.md) -- Config defaults and keys: [../config-reference.md](../config-reference.md) +- Commands by workflow: [cli/commands-reference.md](cli/commands-reference.md) +- Provider IDs / aliases / env vars: [api/providers-reference.md](api/providers-reference.md) +- Channel setup + allowlists: [api/channels-reference.md](api/channels-reference.md) +- Config defaults and keys: [api/config-reference.md](api/config-reference.md) ## Provider & Integration Extensions -- Custom provider endpoints: [../custom-providers.md](../custom-providers.md) -- Z.AI / GLM provider onboarding: [../zai-glm-setup.md](../zai-glm-setup.md) -- Nextcloud Talk bot integration: [../nextcloud-talk-setup.md](../nextcloud-talk-setup.md) -- LangGraph-based integration patterns: [../langgraph-integration.md](../langgraph-integration.md) +- Custom provider endpoints: [../contributing/custom-providers.md](../contributing/custom-providers.md) +- Z.AI / GLM provider onboarding: [../setup-guides/zai-glm-setup.md](../setup-guides/zai-glm-setup.md) +- Nextcloud Talk bot integration: [../setup-guides/nextcloud-talk-setup.md](../setup-guides/nextcloud-talk-setup.md) +- LangGraph-based integration patterns: [../contributing/langgraph-integration.md](../contributing/langgraph-integration.md) ## Usage Use this collection when you need precise CLI/config details or provider integration patterns rather than step-by-step tutorials. -When adding a new reference/integration doc, make sure it is linked in both [../SUMMARY.md](../SUMMARY.md) and [../docs-inventory.md](../docs-inventory.md). +When adding a new reference/integration doc, make sure it is linked in both [../SUMMARY.md](../SUMMARY.md) and [../maintainers/docs-inventory.md](../maintainers/docs-inventory.md). diff --git a/docs/reference/api/channels-reference.md b/docs/reference/api/channels-reference.md index bf5953436..19a8af517 100644 --- a/docs/reference/api/channels-reference.md +++ b/docs/reference/api/channels-reference.md @@ -3,15 +3,15 @@ This document is the canonical reference for channel configuration in ZeroClaw. For encrypted Matrix rooms, also read the dedicated runbook: -- [Matrix E2EE Guide](./matrix-e2ee-guide.md) +- [Matrix E2EE Guide](../../security/matrix-e2ee-guide.md) ## Quick Paths - Need a full config reference by channel: jump to [Per-Channel Config Examples](#4-per-channel-config-examples). - Need a no-response diagnosis flow: jump to [Troubleshooting Checklist](#6-troubleshooting-checklist). -- Need Matrix encrypted-room help: use [Matrix E2EE Guide](./matrix-e2ee-guide.md). -- Need Nextcloud Talk bot setup: use [Nextcloud Talk Setup](./nextcloud-talk-setup.md). -- Need deployment/network assumptions (polling vs webhook): use [Network Deployment](./network-deployment.md). +- Need Matrix encrypted-room help: use [Matrix E2EE Guide](../../security/matrix-e2ee-guide.md). +- Need Nextcloud Talk bot setup: use [Nextcloud Talk Setup](../../setup-guides/nextcloud-talk-setup.md). +- Need deployment/network assumptions (polling vs webhook): use [Network Deployment](../../ops/network-deployment.md). ## FAQ: Matrix setup passes but no reply @@ -211,7 +211,7 @@ room_id = "!room:matrix.example.com" # or room alias (#ops:matrix.example. allowed_users = ["*"] ``` -See [Matrix E2EE Guide](./matrix-e2ee-guide.md) for encrypted-room troubleshooting. +See [Matrix E2EE Guide](../../security/matrix-e2ee-guide.md) for encrypted-room troubleshooting. ### 4.6 Signal @@ -403,7 +403,7 @@ Notes: - Signature verification uses `X-Nextcloud-Talk-Random` and `X-Nextcloud-Talk-Signature`. - If `webhook_secret` is set, invalid signatures are rejected with `401`. - `ZEROCLAW_NEXTCLOUD_TALK_WEBHOOK_SECRET` overrides config secret. -- See [nextcloud-talk-setup.md](./nextcloud-talk-setup.md) for a full runbook. +- See [nextcloud-talk-setup.md](../../setup-guides/nextcloud-talk-setup.md) for a full runbook. ### 4.16 Linq @@ -462,7 +462,7 @@ If a channel appears connected but does not respond: 5. Restart `zeroclaw daemon` after config changes. For Matrix encrypted rooms specifically, use: -- [Matrix E2EE Guide](./matrix-e2ee-guide.md) +- [Matrix E2EE Guide](../../security/matrix-e2ee-guide.md) --- diff --git a/docs/reference/api/config-reference.md b/docs/reference/api/config-reference.md index 77758fd01..bfa4ac2b0 100644 --- a/docs/reference/api/config-reference.md +++ b/docs/reference/api/config-reference.md @@ -568,7 +568,7 @@ Notes: - Webhook endpoint is `POST /nextcloud-talk`. - `ZEROCLAW_NEXTCLOUD_TALK_WEBHOOK_SECRET` overrides `webhook_secret` when set. -- See [nextcloud-talk-setup.md](nextcloud-talk-setup.md) for setup and troubleshooting. +- See [nextcloud-talk-setup.md](../../setup-guides/nextcloud-talk-setup.md) for setup and troubleshooting. ## `[hardware]` @@ -587,7 +587,7 @@ Notes: - Use `transport = "serial"` with `serial_port` for USB-serial connections. - Use `transport = "probe"` with `probe_target` for debug-probe flashing (e.g. ST-Link). -- See [hardware-peripherals-design.md](hardware-peripherals-design.md) for protocol details. +- See [hardware-peripherals-design.md](../../hardware/hardware-peripherals-design.md) for protocol details. ## `[peripherals]` @@ -627,7 +627,7 @@ transport = "native" Notes: - Place `.md`/`.txt` datasheet files named by board (e.g. `nucleo-f401re.md`, `rpi-gpio.md`) in `datasheet_dir` for RAG retrieval. -- See [hardware-peripherals-design.md](hardware-peripherals-design.md) for board protocol and firmware notes. +- See [hardware-peripherals-design.md](../../hardware/hardware-peripherals-design.md) for board protocol and firmware notes. ## Security-Relevant Defaults @@ -650,5 +650,5 @@ zeroclaw service restart - [channels-reference.md](channels-reference.md) - [providers-reference.md](providers-reference.md) -- [operations-runbook.md](operations-runbook.md) -- [troubleshooting.md](troubleshooting.md) +- [operations-runbook.md](../../ops/operations-runbook.md) +- [troubleshooting.md](../../ops/troubleshooting.md) diff --git a/docs/reference/api/config-reference.vi.md b/docs/reference/api/config-reference.vi.md index 507512e39..e0cab31aa 100644 --- a/docs/reference/api/config-reference.vi.md +++ b/docs/reference/api/config-reference.vi.md @@ -2,6 +2,6 @@ Canonical page: -- [i18n/vi/config-reference.md](i18n/vi/config-reference.md) +- [i18n/vi/config-reference.md](../../i18n/vi/config-reference.md) Compatibility shim only. diff --git a/docs/reference/cli/commands-reference.vi.md b/docs/reference/cli/commands-reference.vi.md index 352bed8a6..f327c6d6e 100644 --- a/docs/reference/cli/commands-reference.vi.md +++ b/docs/reference/cli/commands-reference.vi.md @@ -2,6 +2,6 @@ Canonical page: -- [i18n/vi/commands-reference.md](i18n/vi/commands-reference.md) +- [i18n/vi/commands-reference.md](../../i18n/vi/commands-reference.md) Compatibility shim only. diff --git a/docs/security/README.md b/docs/security/README.md index bc50adea2..d633458f4 100644 --- a/docs/security/README.md +++ b/docs/security/README.md @@ -6,17 +6,17 @@ This section mixes current hardening guidance and proposal/roadmap documents. For current runtime behavior, start here: -- Config reference: [../config-reference.md](../config-reference.md) -- Operations runbook: [../operations-runbook.md](../operations-runbook.md) -- Troubleshooting: [../troubleshooting.md](../troubleshooting.md) +- Config reference: [../reference/api/config-reference.md](../reference/api/config-reference.md) +- Operations runbook: [../ops/operations-runbook.md](../ops/operations-runbook.md) +- Troubleshooting: [../ops/troubleshooting.md](../ops/troubleshooting.md) ## Proposal / Roadmap Docs The following docs are explicitly proposal-oriented and may include hypothetical CLI/config examples: -- [../agnostic-security.md](../agnostic-security.md) -- [../frictionless-security.md](../frictionless-security.md) -- [../sandboxing.md](../sandboxing.md) -- [../resource-limits.md](../resource-limits.md) -- [../audit-logging.md](../audit-logging.md) -- [../security-roadmap.md](../security-roadmap.md) +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [sandboxing.md](sandboxing.md) +- [../ops/resource-limits.md](../ops/resource-limits.md) +- [audit-logging.md](audit-logging.md) +- [security-roadmap.md](security-roadmap.md) diff --git a/docs/security/agnostic-security.md b/docs/security/agnostic-security.md index 5c6213abe..0b7be7003 100644 --- a/docs/security/agnostic-security.md +++ b/docs/security/agnostic-security.md @@ -3,7 +3,7 @@ > ⚠️ **Status: Proposal / Roadmap** > > This document describes proposed approaches and may include hypothetical commands or config. -> For current runtime behavior, see [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). +> For current runtime behavior, see [config-reference.md](../reference/api/config-reference.md), [operations-runbook.md](../ops/operations-runbook.md), and [troubleshooting.md](../ops/troubleshooting.md). ## Core Question: Will security features break... 1. ❓ Fast cross-compilation builds? diff --git a/docs/security/audit-logging.md b/docs/security/audit-logging.md index fc44d674f..2637d813a 100644 --- a/docs/security/audit-logging.md +++ b/docs/security/audit-logging.md @@ -3,7 +3,7 @@ > ⚠️ **Status: Proposal / Roadmap** > > This document describes proposed approaches and may include hypothetical commands or config. -> For current runtime behavior, see [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). +> For current runtime behavior, see [config-reference.md](../reference/api/config-reference.md), [operations-runbook.md](../ops/operations-runbook.md), and [troubleshooting.md](../ops/troubleshooting.md). ## Problem ZeroClaw logs actions but lacks tamper-evident audit trails for: diff --git a/docs/security/frictionless-security.md b/docs/security/frictionless-security.md index f62046d55..46d14c868 100644 --- a/docs/security/frictionless-security.md +++ b/docs/security/frictionless-security.md @@ -3,7 +3,7 @@ > ⚠️ **Status: Proposal / Roadmap** > > This document describes proposed approaches and may include hypothetical commands or config. -> For current runtime behavior, see [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). +> For current runtime behavior, see [config-reference.md](../reference/api/config-reference.md), [operations-runbook.md](../ops/operations-runbook.md), and [troubleshooting.md](../ops/troubleshooting.md). ## Core Principle > **"Security features should be like airbags — present, protective, and invisible until needed."** diff --git a/docs/security/matrix-e2ee-guide.md b/docs/security/matrix-e2ee-guide.md index 6f31089e7..43a5d19e0 100644 --- a/docs/security/matrix-e2ee-guide.md +++ b/docs/security/matrix-e2ee-guide.md @@ -134,8 +134,8 @@ After updating config, restart daemon and send a new message (not just old timel ## 6. Related Docs -- [Channels Reference](./channels-reference.md) -- [Operations log keyword appendix](./channels-reference.md#7-operations-appendix-log-keywords-matrix) -- [Network Deployment](./network-deployment.md) +- [Channels Reference](../reference/api/channels-reference.md) +- [Operations log keyword appendix](../reference/api/channels-reference.md#7-operations-appendix-log-keywords-matrix) +- [Network Deployment](../ops/network-deployment.md) - [Agnostic Security](./agnostic-security.md) -- [Reviewer Playbook](./reviewer-playbook.md) +- [Reviewer Playbook](../contributing/reviewer-playbook.md) diff --git a/docs/security/sandboxing.md b/docs/security/sandboxing.md index 4e0d90592..9063abcbd 100644 --- a/docs/security/sandboxing.md +++ b/docs/security/sandboxing.md @@ -3,7 +3,7 @@ > ⚠️ **Status: Proposal / Roadmap** > > This document describes proposed approaches and may include hypothetical commands or config. -> For current runtime behavior, see [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). +> For current runtime behavior, see [config-reference.md](../reference/api/config-reference.md), [operations-runbook.md](../ops/operations-runbook.md), and [troubleshooting.md](../ops/troubleshooting.md). ## Problem ZeroClaw currently has application-layer security (allowlists, path blocking, command injection protection) but lacks OS-level containment. If an attacker is on the allowlist, they can run any allowed command with zeroclaw's user permissions. diff --git a/docs/security/security-roadmap.md b/docs/security/security-roadmap.md index 8b57908d3..1fef89fc5 100644 --- a/docs/security/security-roadmap.md +++ b/docs/security/security-roadmap.md @@ -3,7 +3,7 @@ > ⚠️ **Status: Proposal / Roadmap** > > This document describes proposed approaches and may include hypothetical commands or config. -> For current runtime behavior, see [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), and [troubleshooting.md](troubleshooting.md). +> For current runtime behavior, see [config-reference.md](../reference/api/config-reference.md), [operations-runbook.md](../ops/operations-runbook.md), and [troubleshooting.md](../ops/troubleshooting.md). ## Current State: Strong Foundation diff --git a/docs/setup-guides/README.md b/docs/setup-guides/README.md index 8495427d3..f4cad157c 100644 --- a/docs/setup-guides/README.md +++ b/docs/setup-guides/README.md @@ -5,9 +5,9 @@ For first-time setup and quick orientation. ## Start Path 1. Main overview and quick start: [../../README.md](../../README.md) -2. One-click setup and dual bootstrap mode: [../one-click-bootstrap.md](../one-click-bootstrap.md) +2. One-click setup and dual bootstrap mode: [one-click-bootstrap.md](one-click-bootstrap.md) 3. Update or uninstall on macOS: [macos-update-uninstall.md](macos-update-uninstall.md) -4. Find commands by tasks: [../commands-reference.md](../commands-reference.md) +4. Find commands by tasks: [../reference/cli/commands-reference.md](../reference/cli/commands-reference.md) ## Choose Your Path @@ -29,6 +29,6 @@ For first-time setup and quick orientation. ## Next -- Runtime operations: [../operations/README.md](../operations/README.md) +- Runtime operations: [../ops/README.md](../ops/README.md) - Reference catalogs: [../reference/README.md](../reference/README.md) - macOS lifecycle tasks: [macos-update-uninstall.md](macos-update-uninstall.md) diff --git a/docs/setup-guides/README.vi.md b/docs/setup-guides/README.vi.md index b5f43d8b6..a347f5a63 100644 --- a/docs/setup-guides/README.vi.md +++ b/docs/setup-guides/README.vi.md @@ -5,8 +5,8 @@ Dành cho cài đặt lần đầu và làm quen nhanh. ## Lộ trình bắt đầu 1. Tổng quan và khởi động nhanh: [../../README.vi.md](../../README.vi.md) -2. Cài đặt một lệnh và chế độ bootstrap kép: [../one-click-bootstrap.md](../one-click-bootstrap.md) -3. Tìm lệnh theo tác vụ: [../commands-reference.md](../commands-reference.md) +2. Cài đặt một lệnh và chế độ bootstrap kép: [one-click-bootstrap.md](one-click-bootstrap.md) +3. Tìm lệnh theo tác vụ: [../reference/cli/commands-reference.md](../reference/cli/commands-reference.md) ## Chọn hướng đi @@ -25,5 +25,5 @@ Dành cho cài đặt lần đầu và làm quen nhanh. ## Tiếp theo -- Vận hành runtime: [../operations/README.md](../operations/README.md) +- Vận hành runtime: [../ops/README.md](../ops/README.md) - Tra cứu tham khảo: [../reference/README.md](../reference/README.md) diff --git a/docs/setup-guides/macos-update-uninstall.md b/docs/setup-guides/macos-update-uninstall.md index 944cd4ce3..2220310e3 100644 --- a/docs/setup-guides/macos-update-uninstall.md +++ b/docs/setup-guides/macos-update-uninstall.md @@ -34,7 +34,7 @@ From your local repository checkout: ```bash git pull --ff-only -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt zeroclaw --version ``` @@ -107,6 +107,6 @@ pkill -f zeroclaw ## Related docs -- [One-Click Bootstrap](../one-click-bootstrap.md) -- [Commands Reference](../commands-reference.md) -- [Troubleshooting](../troubleshooting.md) +- [One-Click Bootstrap](one-click-bootstrap.md) +- [Commands Reference](../reference/cli/commands-reference.md) +- [Troubleshooting](../ops/troubleshooting.md) diff --git a/docs/setup-guides/one-click-bootstrap.md b/docs/setup-guides/one-click-bootstrap.md index f2d8ddb37..0e3a169ac 100644 --- a/docs/setup-guides/one-click-bootstrap.md +++ b/docs/setup-guides/one-click-bootstrap.md @@ -15,7 +15,7 @@ brew install zeroclaw ```bash git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh ``` What it does by default: @@ -33,19 +33,19 @@ Source builds typically require at least: When resources are constrained, bootstrap now attempts a pre-built binary first. ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` To require binary-only installation and fail if no compatible release asset exists: ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` To bypass pre-built flow and force source compilation: ```bash -./bootstrap.sh --force-source-build +./install.sh --force-source-build ``` ## Dual-mode bootstrap @@ -55,7 +55,7 @@ Default behavior is **app-only** (build/install ZeroClaw) and expects existing R For fresh machines, enable environment bootstrap explicitly: ```bash -./bootstrap.sh --install-system-deps --install-rust +./install.sh --install-system-deps --install-rust ``` Notes: @@ -69,59 +69,51 @@ Notes: ## Option B: Remote one-liner ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` For high-security environments, prefer Option A so you can review the script before execution. -Legacy compatibility: - -```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash -``` - -This legacy endpoint prefers forwarding to `scripts/bootstrap.sh` and falls back to legacy source install if unavailable in that revision. - -If you run Option B outside a repository checkout, the bootstrap script automatically clones a temporary workspace, builds, installs, and then cleans it up. +If you run Option B outside a repository checkout, the install script automatically clones a temporary workspace, builds, installs, and then cleans it up. ## Optional onboarding modes ### Containerized onboarding (Docker) ```bash -./bootstrap.sh --docker +./install.sh --docker ``` This builds a local ZeroClaw image and launches onboarding inside a container while persisting config/workspace to `./.zeroclaw-docker`. Container CLI defaults to `docker`. If Docker CLI is unavailable and `podman` exists, -bootstrap auto-falls back to `podman`. You can also set `ZEROCLAW_CONTAINER_CLI` -explicitly (for example: `ZEROCLAW_CONTAINER_CLI=podman ./bootstrap.sh --docker`). +the installer auto-falls back to `podman`. You can also set `ZEROCLAW_CONTAINER_CLI` +explicitly (for example: `ZEROCLAW_CONTAINER_CLI=podman ./install.sh --docker`). -For Podman, bootstrap runs with `--userns keep-id` and `:Z` volume labels so +For Podman, the installer runs with `--userns keep-id` and `:Z` volume labels so workspace/config mounts remain writable inside the container. -If you add `--skip-build`, bootstrap skips local image build. It first tries the local +If you add `--skip-build`, the installer skips local image build. It first tries the local Docker tag (`ZEROCLAW_DOCKER_IMAGE`, default: `zeroclaw-bootstrap:local`); if missing, it pulls `ghcr.io/zeroclaw-labs/zeroclaw:latest` and tags it locally before running. ### Quick onboarding (non-interactive) ```bash -./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter +./install.sh --onboard --api-key "sk-..." --provider openrouter ``` Or with environment variables: ```bash -ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./bootstrap.sh --onboard +ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./install.sh --onboard ``` ### Interactive onboarding ```bash -./bootstrap.sh --interactive-onboard +./install.sh --interactive-onboard ``` ## Useful flags @@ -135,12 +127,12 @@ ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./bootstrap.sh --onboar See all options: ```bash -./bootstrap.sh --help +./install.sh --help ``` ## Related docs - [README.md](../README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) +- [commands-reference.md](../reference/cli/commands-reference.md) +- [providers-reference.md](../reference/api/providers-reference.md) +- [channels-reference.md](../reference/api/channels-reference.md) diff --git a/docs/setup-guides/one-click-bootstrap.vi.md b/docs/setup-guides/one-click-bootstrap.vi.md index 3860b9b9a..b4e2ea67c 100644 --- a/docs/setup-guides/one-click-bootstrap.vi.md +++ b/docs/setup-guides/one-click-bootstrap.vi.md @@ -2,6 +2,6 @@ Canonical page: -- [i18n/vi/one-click-bootstrap.md](i18n/vi/one-click-bootstrap.md) +- [i18n/vi/one-click-bootstrap.md](../i18n/vi/one-click-bootstrap.md) Compatibility shim only. diff --git a/docs/setup-guides/zai-glm-setup.md b/docs/setup-guides/zai-glm-setup.md index 5fdfa684f..0692fd691 100644 --- a/docs/setup-guides/zai-glm-setup.md +++ b/docs/setup-guides/zai-glm-setup.md @@ -138,5 +138,5 @@ curl -s "https://api.z.ai/api/coding/paas/v4/models" \ ## Related Documentation - [ZeroClaw README](../README.md) -- [Custom Provider Endpoints](./custom-providers.md) -- [Contributing Guide](../CONTRIBUTING.md) +- [Custom Provider Endpoints](../contributing/custom-providers.md) +- [Contributing Guide](../../CONTRIBUTING.md) diff --git a/docs/vi/README.md b/docs/vi/README.md index 53e680843..70e3bed54 100644 --- a/docs/vi/README.md +++ b/docs/vi/README.md @@ -20,8 +20,8 @@ | Vận hành hàng ngày (runbook) | [operations-runbook.md](operations-runbook.md) | | Khắc phục sự cố cài đặt/chạy/kênh | [troubleshooting.md](troubleshooting.md) | | Cấu hình Matrix phòng mã hóa (E2EE) | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | -| Xem theo danh mục | [SUMMARY.md](SUMMARY.md) | -| Xem bản chụp PR/Issue | [../project-triage-snapshot-2026-02-18.md](../project-triage-snapshot-2026-02-18.md) | +| Xem theo danh mục | [SUMMARY.md](../i18n/vi/SUMMARY.md) | +| Xem bản chụp PR/Issue | [../maintainers/project-triage-snapshot-2026-02-18.md](../maintainers/project-triage-snapshot-2026-02-18.md) | ## Tìm nhanh @@ -32,7 +32,7 @@ - Tìm hiểu bảo mật và lộ trình → [security/README.md](security/README.md) - Làm việc với bo mạch / thiết bị ngoại vi → [hardware/README.md](hardware/README.md) - Đóng góp / review / quy trình CI → [contributing/README.md](contributing/README.md) -- Xem toàn bộ bản đồ tài liệu → [SUMMARY.md](SUMMARY.md) +- Xem toàn bộ bản đồ tài liệu → [SUMMARY.md](../i18n/vi/SUMMARY.md) ## Theo danh mục @@ -81,8 +81,8 @@ ## Quản lý tài liệu -- Mục lục thống nhất (TOC): [SUMMARY.md](SUMMARY.md) -- Danh mục và phân loại tài liệu: [../docs-inventory.md](../docs-inventory.md) +- Mục lục thống nhất (TOC): [SUMMARY.md](../i18n/vi/SUMMARY.md) +- Danh mục và phân loại tài liệu: [../maintainers/docs-inventory.md](../maintainers/docs-inventory.md) ## Ngôn ngữ khác diff --git a/docs/vi/one-click-bootstrap.md b/docs/vi/one-click-bootstrap.md index 09b2da981..8e5899887 100644 --- a/docs/vi/one-click-bootstrap.md +++ b/docs/vi/one-click-bootstrap.md @@ -15,7 +15,7 @@ brew install zeroclaw ```bash git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw -./bootstrap.sh +./install.sh ``` Mặc định script sẽ: @@ -33,19 +33,19 @@ Build từ mã nguồn thường yêu cầu tối thiểu: Khi tài nguyên hạn chế, bootstrap sẽ thử tải binary dựng sẵn trước. ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` Chỉ dùng binary dựng sẵn, báo lỗi nếu không tìm thấy bản phù hợp: ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` Bỏ qua binary dựng sẵn, buộc build từ mã nguồn: ```bash -./bootstrap.sh --force-source-build +./install.sh --force-source-build ``` ## Bootstrap kép @@ -55,7 +55,7 @@ Mặc định là **chỉ ứng dụng** (build/cài ZeroClaw), yêu cầu Rust Với máy mới, bật bootstrap môi trường: ```bash -./bootstrap.sh --install-system-deps --install-rust +./install.sh --install-system-deps --install-rust ``` Lưu ý: @@ -69,19 +69,11 @@ Lưu ý: ## Cách B: Lệnh từ xa một dòng ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` Với môi trường yêu cầu bảo mật cao, nên dùng Cách A để kiểm tra script trước khi chạy. -Tương thích ngược: - -```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash -``` - -Endpoint cũ này ưu tiên chuyển tiếp đến `scripts/bootstrap.sh`, nếu không có thì dùng cài đặt từ nguồn kiểu cũ. - Nếu chạy Cách B ngoài thư mục repo, bootstrap script sẽ tự clone workspace tạm, build, cài đặt rồi dọn dẹp. ## Chế độ thiết lập tùy chọn @@ -89,7 +81,7 @@ Nếu chạy Cách B ngoài thư mục repo, bootstrap script sẽ tự clone wo ### Thiết lập trong container (Docker) ```bash -./bootstrap.sh --docker +./install.sh --docker ``` Lệnh này build image ZeroClaw cục bộ và chạy thiết lập trong container, lưu config/workspace vào `./.zeroclaw-docker`. @@ -97,19 +89,19 @@ Lệnh này build image ZeroClaw cục bộ và chạy thiết lập trong conta ### Thiết lập nhanh (không tương tác) ```bash -./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter +./install.sh --onboard --api-key "sk-..." --provider openrouter ``` Hoặc dùng biến môi trường: ```bash -ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./bootstrap.sh --onboard +ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./install.sh --onboard ``` ### Thiết lập tương tác ```bash -./bootstrap.sh --interactive-onboard +./install.sh --interactive-onboard ``` ## Các cờ hữu ích @@ -123,7 +115,7 @@ ZEROCLAW_API_KEY="sk-..." ZEROCLAW_PROVIDER="openrouter" ./bootstrap.sh --onboar Xem tất cả tùy chọn: ```bash -./bootstrap.sh --help +./install.sh --help ``` ## Tài liệu liên quan diff --git a/docs/vi/project/README.md b/docs/vi/project/README.md index 215cfbb30..92dea0386 100644 --- a/docs/vi/project/README.md +++ b/docs/vi/project/README.md @@ -4,7 +4,7 @@ Snapshot trạng thái dự án có giới hạn thời gian cho tài liệu l ## Snapshot hiện tại -- [../../project-triage-snapshot-2026-02-18.md](../../project-triage-snapshot-2026-02-18.md) +- [../../maintainers/project-triage-snapshot-2026-02-18.md](../../maintainers/project-triage-snapshot-2026-02-18.md) ## Phạm vi @@ -14,4 +14,4 @@ Snapshot dự án là các đánh giá có giới hạn thời gian về PR mở - Ưu tiên bảo trì tài liệu song song với thay đổi code - Theo dõi áp lực PR/issue đang phát triển theo thời gian -Để phân loại tài liệu ổn định (không giới hạn thời gian), dùng [../../docs-inventory.md](../../docs-inventory.md). +Để phân loại tài liệu ổn định (không giới hạn thời gian), dùng [../../maintainers/docs-inventory.md](../../maintainers/docs-inventory.md). diff --git a/docs/vi/reference/README.md b/docs/vi/reference/README.md index 56550409d..57d3f773b 100644 --- a/docs/vi/reference/README.md +++ b/docs/vi/reference/README.md @@ -19,4 +19,4 @@ Tra cứu lệnh, provider, channel, config và tích hợp. Sử dụng bộ sưu tập này khi bạn cần chi tiết CLI/config chính xác hoặc các mẫu tích hợp provider thay vì hướng dẫn từng bước. -Khi thêm tài liệu tham chiếu/tích hợp mới, hãy đảm bảo nó được liên kết trong cả [../SUMMARY.md](../SUMMARY.md) và [../../docs-inventory.md](../../docs-inventory.md). +Khi thêm tài liệu tham chiếu/tích hợp mới, hãy đảm bảo nó được liên kết trong cả [../SUMMARY.md](../../i18n/vi/SUMMARY.md) và [../../maintainers/docs-inventory.md](../../maintainers/docs-inventory.md). diff --git a/docs/vi/troubleshooting.md b/docs/vi/troubleshooting.md index 876fbb942..cbf9c8b7b 100644 --- a/docs/vi/troubleshooting.md +++ b/docs/vi/troubleshooting.md @@ -15,7 +15,7 @@ Triệu chứng: Khắc phục: ```bash -./bootstrap.sh --install-rust +./install.sh --install-rust ``` Hoặc cài từ . @@ -29,7 +29,7 @@ Triệu chứng: Khắc phục: ```bash -./bootstrap.sh --install-system-deps +./install.sh --install-system-deps ``` ### Build thất bại trên máy ít RAM / ít dung lượng @@ -48,13 +48,13 @@ Nguyên nhân: Cách tốt nhất cho máy hạn chế tài nguyên: ```bash -./bootstrap.sh --prefer-prebuilt +./install.sh --prefer-prebuilt ``` Chế độ chỉ dùng binary (không build từ nguồn): ```bash -./bootstrap.sh --prebuilt-only +./install.sh --prebuilt-only ``` Nếu bắt buộc phải build từ nguồn trên máy yếu: @@ -209,17 +209,12 @@ Xem log trên Linux: journalctl --user -u zeroclaw.service -f ``` -## Tương thích cài đặt cũ - -Cả hai cách vẫn hoạt động: +## URL cài đặt ```bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash -curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash ``` -`install.sh` là điểm vào tương thích, chuyển tiếp/dự phòng về hành vi bootstrap. - ## Vẫn chưa giải quyết được? Thu thập và đính kèm các thông tin sau khi tạo issue: diff --git a/firmware/zeroclaw-esp32-ui/README.md b/firmware/zeroclaw-esp32-ui/README.md index ffba119fb..a7f9141bc 100644 --- a/firmware/zeroclaw-esp32-ui/README.md +++ b/firmware/zeroclaw-esp32-ui/README.md @@ -103,4 +103,4 @@ MIT - See root `LICENSE` - [Slint ESP32 Documentation](https://slint.dev/esp32) - [ESP-IDF Rust Book](https://esp-rs.github.io/book/) -- [ZeroClaw Hardware Design](../../docs/hardware-peripherals-design.md) +- [ZeroClaw Hardware Design](../../docs/hardware/hardware-peripherals-design.md) diff --git a/scripts/bootstrap.sh b/install.sh similarity index 90% rename from scripts/bootstrap.sh rename to install.sh index 3d7a867a6..f921f912c 100755 --- a/scripts/bootstrap.sh +++ b/install.sh @@ -1,4 +1,50 @@ -#!/usr/bin/env bash +#!/usr/bin/env sh +# ZeroClaw installer +# POSIX preamble: ensure bash is available, then re-exec under bash. +set -eu + +_have_cmd() { command -v "$1" >/dev/null 2>&1; } + +_run_privileged() { + if [ "$(id -u)" -eq 0 ]; then "$@" + elif _have_cmd sudo; then sudo "$@" + else echo "error: sudo is required to install missing dependencies." >&2; exit 1; fi +} + +_is_container_runtime() { + [ -f /.dockerenv ] || [ -f /run/.containerenv ] && return 0 + [ -r /proc/1/cgroup ] && grep -Eq '(docker|containerd|kubepods|podman|lxc)' /proc/1/cgroup && return 0 + return 1 +} + +_ensure_bash() { + _have_cmd bash && return 0 + echo "==> bash not found; attempting to install it" + if _have_cmd apk; then _run_privileged apk add --no-cache bash + elif _have_cmd apt-get; then _run_privileged apt-get update -qq && _run_privileged apt-get install -y bash + elif _have_cmd dnf; then _run_privileged dnf install -y bash + elif _have_cmd pacman; then + if _is_container_runtime; then + _PACMAN_CFG="$(mktemp /tmp/zeroclaw-pacman.XXXXXX.conf)" + cp /etc/pacman.conf "$_PACMAN_CFG" + grep -Eq '^[[:space:]]*DisableSandboxSyscalls([[:space:]]|$)' "$_PACMAN_CFG" || printf '\nDisableSandboxSyscalls\n' >> "$_PACMAN_CFG" + _run_privileged pacman --config "$_PACMAN_CFG" -Sy --noconfirm + _run_privileged pacman --config "$_PACMAN_CFG" -S --noconfirm --needed bash + rm -f "$_PACMAN_CFG" + else + _run_privileged pacman -Sy --noconfirm + _run_privileged pacman -S --noconfirm --needed bash + fi + else echo "error: unsupported package manager; install bash manually and retry." >&2; exit 1; fi +} + +# If not already running under bash, ensure bash exists and re-exec. +if [ -z "${BASH_VERSION:-}" ]; then + _ensure_bash + exec bash "$0" "$@" +fi + +# --- From here on, we are running under bash --- set -euo pipefail info() { @@ -15,11 +61,10 @@ error() { usage() { cat <<'USAGE' -ZeroClaw installer bootstrap engine +ZeroClaw installer Usage: - ./zeroclaw_install.sh [options] - ./bootstrap.sh [options] # compatibility entrypoint + ./install.sh [options] Modes: Default mode installs/builds ZeroClaw only (requires existing Rust toolchain). @@ -29,7 +74,7 @@ Modes: Options: --guided Run interactive guided installer --no-guided Disable guided installer - --docker Run bootstrap in Docker-compatible mode and launch onboarding inside the container + --docker Run install in Docker-compatible mode and launch onboarding inside the container --install-system-deps Install build dependencies (Linux/macOS) --install-rust Install Rust via rustup if missing --prefer-prebuilt Try latest release binary first; fallback to source build on miss @@ -46,19 +91,17 @@ Options: -h, --help Show help Examples: - ./zeroclaw_install.sh - ./zeroclaw_install.sh --guided - ./zeroclaw_install.sh --install-system-deps --install-rust - ./zeroclaw_install.sh --prefer-prebuilt - ./zeroclaw_install.sh --prebuilt-only - ./zeroclaw_install.sh --onboard --api-key "sk-..." --provider openrouter [--model "openrouter/auto"] - ./zeroclaw_install.sh --interactive-onboard - - # Compatibility entrypoint: - ./bootstrap.sh --docker + ./install.sh + ./install.sh --guided + ./install.sh --install-system-deps --install-rust + ./install.sh --prefer-prebuilt + ./install.sh --prebuilt-only + ./install.sh --onboard --api-key "sk-..." --provider openrouter [--model "openrouter/auto"] + ./install.sh --interactive-onboard + ./install.sh --docker # Remote one-liner - curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/scripts/bootstrap.sh | bash + curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/install.sh | bash Environment: ZEROCLAW_CONTAINER_CLI Container CLI command (default: docker; auto-fallback: podman) @@ -690,9 +733,9 @@ run_docker_bootstrap() { Use either: --api-key "sk-..." or: - ZEROCLAW_API_KEY="sk-..." ./zeroclaw_install.sh --docker + ZEROCLAW_API_KEY="sk-..." ./install.sh --docker or run interactive: - ./zeroclaw_install.sh --docker --interactive-onboard + ./install.sh --docker --interactive-onboard MSG exit 1 fi @@ -720,7 +763,7 @@ MSG SCRIPT_PATH="${BASH_SOURCE[0]:-$0}" SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" >/dev/null 2>&1 && pwd || pwd)" -ROOT_DIR="$(cd "$SCRIPT_DIR/.." >/dev/null 2>&1 && pwd || pwd)" +ROOT_DIR="$SCRIPT_DIR" REPO_URL="https://github.com/zeroclaw-labs/zeroclaw.git" ORIGINAL_ARG_COUNT=$# GUIDED_MODE="auto" @@ -889,9 +932,9 @@ cleanup() { trap cleanup EXIT # Support three launch modes: -# 1) ./bootstrap.sh from repo root -# 2) scripts/bootstrap.sh from repo -# 3) curl | bash (no local repo => temporary clone) +# Support two launch modes: +# 1) ./install.sh from repo root +# 2) curl | bash (no local repo => temporary clone) if [[ ! -f "$WORK_DIR/Cargo.toml" ]]; then if [[ -f "$(pwd)/Cargo.toml" ]]; then WORK_DIR="$(pwd)" @@ -912,7 +955,7 @@ if [[ ! -f "$WORK_DIR/Cargo.toml" ]]; then fi fi -info "ZeroClaw bootstrap" +info "ZeroClaw installer" echo " workspace: $WORK_DIR" cd "$WORK_DIR" @@ -945,8 +988,8 @@ DONE cat <<'DONE' Next steps: - ./zeroclaw_install.sh --docker --interactive-onboard - ./zeroclaw_install.sh --docker --api-key "sk-..." --provider openrouter + ./install.sh --docker --interactive-onboard + ./install.sh --docker --api-key "sk-..." --provider openrouter DONE exit 0 fi @@ -979,7 +1022,7 @@ if [[ "$PREBUILT_INSTALLED" == false && ( "$SKIP_BUILD" == false || "$SKIP_INSTA cat <<'MSG' >&2 Install Rust first: https://rustup.rs/ or re-run with: - ./zeroclaw_install.sh --install-rust + ./install.sh --install-rust MSG exit 1 fi @@ -1024,9 +1067,9 @@ if [[ "$RUN_ONBOARD" == true ]]; then Use either: --api-key "sk-..." or: - ZEROCLAW_API_KEY="sk-..." ./zeroclaw_install.sh --onboard + ZEROCLAW_API_KEY="sk-..." ./install.sh --onboard or run interactive: - ./zeroclaw_install.sh --interactive-onboard + ./install.sh --interactive-onboard MSG exit 1 fi diff --git a/python/README.md b/python/README.md index 0f04f3e14..5b744c9a1 100644 --- a/python/README.md +++ b/python/README.md @@ -151,4 +151,4 @@ Use **Rust ZeroClaw** for production edge deployments. Use **zeroclaw-tools** wh ## License -MIT License — see [LICENSE](../LICENSE) +MIT License — see [LICENSE](../LICENSE-MIT) diff --git a/python/README.vi.md b/python/README.vi.md index 2ef6b7c47..a26126aa6 100644 --- a/python/README.vi.md +++ b/python/README.vi.md @@ -151,4 +151,4 @@ Dùng **Rust ZeroClaw** cho triển khai biên (edge) trong sản phẩm. Dùng ## Giấy phép -MIT License — xem [LICENSE](../LICENSE) +MIT License — xem [LICENSE](../LICENSE-MIT) diff --git a/scripts/install.sh b/scripts/install.sh deleted file mode 100755 index 478bdd527..000000000 --- a/scripts/install.sh +++ /dev/null @@ -1,43 +0,0 @@ -#!/usr/bin/env bash -set -euo pipefail - -SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" >/dev/null 2>&1 && pwd || pwd)" -INSTALLER_LOCAL="$(cd "$SCRIPT_DIR/.." >/dev/null 2>&1 && pwd || pwd)/zeroclaw_install.sh" -BOOTSTRAP_LOCAL="$SCRIPT_DIR/bootstrap.sh" -REPO_URL="https://github.com/zeroclaw-labs/zeroclaw.git" - -echo "[deprecated] scripts/install.sh -> ./zeroclaw_install.sh" >&2 - -if [[ -x "$INSTALLER_LOCAL" ]]; then - exec "$INSTALLER_LOCAL" "$@" -fi - -if [[ -f "$BOOTSTRAP_LOCAL" ]]; then - exec "$BOOTSTRAP_LOCAL" "$@" -fi - -if ! command -v git >/dev/null 2>&1; then - echo "error: git is required for legacy install.sh remote mode" >&2 - exit 1 -fi - -TEMP_DIR="$(mktemp -d -t zeroclaw-install-XXXXXX)" -cleanup() { - rm -rf "$TEMP_DIR" -} -trap cleanup EXIT - -git clone --depth 1 "$REPO_URL" "$TEMP_DIR" >/dev/null 2>&1 - -if [[ -x "$TEMP_DIR/zeroclaw_install.sh" ]]; then - exec "$TEMP_DIR/zeroclaw_install.sh" "$@" -fi - -if [[ -x "$TEMP_DIR/scripts/bootstrap.sh" ]]; then - exec "$TEMP_DIR/scripts/bootstrap.sh" "$@" -fi - -echo "error: zeroclaw_install.sh/bootstrap.sh was not found in the fetched revision." >&2 -echo "Run the local bootstrap directly when possible:" >&2 -echo " ./zeroclaw_install.sh --help" >&2 -exit 1 diff --git a/tests/telegram/testing-telegram.md b/tests/telegram/testing-telegram.md index a9dd04f00..ee4408af3 100644 --- a/tests/telegram/testing-telegram.md +++ b/tests/telegram/testing-telegram.md @@ -347,6 +347,6 @@ zeroclaw channel doctor ## 📚 Additional Resources - [Telegram Bot API Documentation](https://core.telegram.org/bots/api) -- [ZeroClaw Main README](README.md) -- [Contributing Guide](CONTRIBUTING.md) -- [Issue Tracker](https://github.com/theonlyhennygod/zeroclaw/issues) +- [ZeroClaw Main README](../../README.md) +- [Contributing Guide](../../CONTRIBUTING.md) +- [Issue Tracker](https://github.com/zeroclaw-labs/zeroclaw/issues) diff --git a/zeroclaw_install.sh b/zeroclaw_install.sh deleted file mode 100755 index 4279e1a33..000000000 --- a/zeroclaw_install.sh +++ /dev/null @@ -1,88 +0,0 @@ -#!/usr/bin/env sh -set -eu - -have_cmd() { - command -v "$1" >/dev/null 2>&1 -} - -run_privileged() { - if [ "$(id -u)" -eq 0 ]; then - "$@" - elif have_cmd sudo; then - sudo "$@" - else - echo "error: sudo is required to install missing dependencies." >&2 - exit 1 - fi -} - -is_container_runtime() { - if [ -f /.dockerenv ] || [ -f /run/.containerenv ]; then - return 0 - fi - - if [ -r /proc/1/cgroup ] && grep -Eq '(docker|containerd|kubepods|podman|lxc)' /proc/1/cgroup; then - return 0 - fi - - return 1 -} - -run_pacman() { - if ! is_container_runtime; then - run_privileged pacman "$@" - return $? - fi - - PACMAN_CFG_TMP="$(mktemp /tmp/zeroclaw-pacman.XXXXXX.conf)" - cp /etc/pacman.conf "$PACMAN_CFG_TMP" - if ! grep -Eq '^[[:space:]]*DisableSandboxSyscalls([[:space:]]|$)' "$PACMAN_CFG_TMP"; then - printf '\nDisableSandboxSyscalls\n' >> "$PACMAN_CFG_TMP" - fi - - if run_privileged pacman --config "$PACMAN_CFG_TMP" "$@"; then - PACMAN_RC=0 - else - PACMAN_RC=$? - fi - rm -f "$PACMAN_CFG_TMP" - return "$PACMAN_RC" -} - -ensure_bash() { - if have_cmd bash; then - return 0 - fi - - echo "==> bash not found; attempting to install it" - if have_cmd apk; then - run_privileged apk add --no-cache bash - elif have_cmd apt-get; then - run_privileged apt-get update -qq - run_privileged apt-get install -y bash - elif have_cmd dnf; then - run_privileged dnf install -y bash - elif have_cmd pacman; then - run_pacman -Sy --noconfirm - run_pacman -S --noconfirm --needed bash - else - echo "error: unsupported package manager; install bash manually and retry." >&2 - exit 1 - fi -} - -ROOT_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" >/dev/null 2>&1 && pwd || pwd)" -BOOTSTRAP_SCRIPT="$ROOT_DIR/scripts/bootstrap.sh" - -if [ ! -f "$BOOTSTRAP_SCRIPT" ]; then - echo "error: scripts/bootstrap.sh not found from repository root." >&2 - exit 1 -fi - -ensure_bash - -if [ "$#" -eq 0 ]; then - exec bash "$BOOTSTRAP_SCRIPT" --guided -fi - -exec bash "$BOOTSTRAP_SCRIPT" "$@" From 36bc6c4aee503ccbdd332fded489dc189a571e94 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:16:48 -0400 Subject: [PATCH 14/35] refactor: Agents file done according to best practices (slim, light, project specific, avoids things the models already know) --- CLAUDE.md | 475 +++----------------------- docs/contributing/change-playbooks.md | 53 +++ docs/contributing/docs-contract.md | 34 ++ docs/contributing/pr-discipline.md | 86 +++++ 4 files changed, 214 insertions(+), 434 deletions(-) create mode 100644 docs/contributing/change-playbooks.md create mode 100644 docs/contributing/docs-contract.md create mode 100644 docs/contributing/pr-discipline.md diff --git a/CLAUDE.md b/CLAUDE.md index 4c3b57329..2c0ab82d4 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,20 +1,26 @@ -# CLAUDE.md — ZeroClaw Agent Engineering Protocol +# CLAUDE.md — ZeroClaw -This file defines the default working protocol for Claude agents in this repository. -Scope: entire repository. +## Commands -## 1) Project Snapshot (Read First) +```bash +cargo fmt --all -- --check +cargo clippy --all-targets -- -D warnings +cargo test +``` -ZeroClaw is a Rust-first autonomous agent runtime optimized for: +Full pre-PR validation (recommended): -- high performance -- high efficiency -- high stability -- high extensibility -- high sustainability -- high security +```bash +./dev/ci.sh all +``` -Core architecture is trait-driven and modular. Most extension work should be done by implementing traits and registering in factory modules. +Docs-only changes: run markdown lint and link-integrity checks. If touching bootstrap scripts: `bash -n install.sh`. + +## Project Snapshot + +ZeroClaw is a Rust-first autonomous agent runtime optimized for performance, efficiency, stability, extensibility, sustainability, and security. + +Core architecture is trait-driven and modular. Extend by implementing traits and registering in factory modules. Key extension points: @@ -26,111 +32,7 @@ Key extension points: - `src/runtime/traits.rs` (`RuntimeAdapter`) - `src/peripherals/traits.rs` (`Peripheral`) — hardware boards (STM32, RPi GPIO) -## 2) Deep Architecture Observations (Why This Protocol Exists) - -These codebase realities should drive every design decision: - -1. **Trait + factory architecture is the stability backbone** - - Extension points are intentionally explicit and swappable. - - Most features should be added via trait implementation + factory registration, not cross-cutting rewrites. -2. **Security-critical surfaces are first-class and internet-adjacent** - - `src/gateway/`, `src/security/`, `src/tools/`, `src/runtime/` carry high blast radius. - - Defaults already lean secure-by-default (pairing, bind safety, limits, secret handling); keep it that way. -3. **Performance and binary size are product goals, not nice-to-have** - - `Cargo.toml` release profile and dependency choices optimize for size and determinism. - - Convenience dependencies and broad abstractions can silently regress these goals. -4. **Config and runtime contracts are user-facing API** - - `src/config/schema.rs` and CLI commands are effectively public interfaces. - - Backward compatibility and explicit migration matter. -5. **The project now runs in high-concurrency collaboration mode** - - CI + docs governance + label routing are part of the product delivery system. - - PR throughput is a design constraint; not just a maintainer inconvenience. - -## 3) Engineering Principles (Normative) - -These principles are mandatory by default. They are not slogans; they are implementation constraints. - -### 3.1 KISS (Keep It Simple, Stupid) - -**Why here:** Runtime + security behavior must stay auditable under pressure. - -Required: - -- Prefer straightforward control flow over clever meta-programming. -- Prefer explicit match branches and typed structs over hidden dynamic behavior. -- Keep error paths obvious and localized. - -### 3.2 YAGNI (You Aren't Gonna Need It) - -**Why here:** Premature features increase attack surface and maintenance burden. - -Required: - -- Do not add new config keys, trait methods, feature flags, or workflow branches without a concrete accepted use case. -- Do not introduce speculative “future-proof” abstractions without at least one current caller. -- Keep unsupported paths explicit (error out) rather than adding partial fake support. - -### 3.3 DRY + Rule of Three - -**Why here:** Naive DRY can create brittle shared abstractions across providers/channels/tools. - -Required: - -- Duplicate small, local logic when it preserves clarity. -- Extract shared utilities only after repeated, stable patterns (rule-of-three). -- When extracting, preserve module boundaries and avoid hidden coupling. - -### 3.4 SRP + ISP (Single Responsibility + Interface Segregation) - -**Why here:** Trait-driven architecture already encodes subsystem boundaries. - -Required: - -- Keep each module focused on one concern. -- Extend behavior by implementing existing narrow traits whenever possible. -- Avoid fat interfaces and “god modules” that mix policy + transport + storage. - -### 3.5 Fail Fast + Explicit Errors - -**Why here:** Silent fallback in agent runtimes can create unsafe or costly behavior. - -Required: - -- Prefer explicit `bail!`/errors for unsupported or unsafe states. -- Never silently broaden permissions/capabilities. -- Document fallback behavior when fallback is intentional and safe. - -### 3.6 Secure by Default + Least Privilege - -**Why here:** Gateway/tools/runtime can execute actions with real-world side effects. - -Required: - -- Deny-by-default for access and exposure boundaries. -- Never log secrets, raw tokens, or sensitive payloads. -- Keep network/filesystem/shell scope as narrow as possible unless explicitly justified. - -### 3.7 Determinism + Reproducibility - -**Why here:** Reliable CI and low-latency triage depend on deterministic behavior. - -Required: - -- Prefer reproducible commands and locked dependency behavior in CI-sensitive paths. -- Keep tests deterministic (no flaky timing/network dependence without guardrails). -- Ensure local validation commands map to CI expectations. - -### 3.8 Reversibility + Rollback-First Thinking - -**Why here:** Fast recovery is mandatory under high PR volume. - -Required: - -- Keep changes easy to revert (small scope, clear blast radius). -- For risky changes, define rollback path before merge. -- Avoid mixed mega-patches that block safe rollback. - -## 4) Repository Map (High-Level) +## Repository Map - `src/main.rs` — CLI entrypoint and command routing - `src/lib.rs` — module exports and shared command enums @@ -142,59 +44,12 @@ Required: - `src/providers/` — model providers and resilient wrapper - `src/channels/` — Telegram/Discord/Slack/etc channels - `src/tools/` — tool execution surface (shell, file, memory, browser) -- `src/peripherals/` — hardware peripherals (STM32, RPi GPIO); see `docs/hardware-peripherals-design.md` +- `src/peripherals/` — hardware peripherals (STM32, RPi GPIO) - `src/runtime/` — runtime adapters (currently native) -- `docs/` — task-oriented documentation system (hubs, unified TOC, references, operations, security proposals, multilingual guides) +- `docs/` — topic-based documentation (setup-guides, reference, ops, security, hardware, contributing, maintainers) - `.github/` — CI, templates, automation workflows -## 4.1 Documentation System Contract (Required) - -Treat documentation as a first-class product surface, not a post-merge artifact. - -Canonical entry points: - -- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md` -- docs hubs: `docs/README.md`, `docs/README.zh-CN.md`, `docs/README.ja.md`, `docs/README.ru.md`, `docs/README.fr.md`, `docs/i18n/vi/README.md` -- unified TOC: `docs/SUMMARY.md` - -Supported locales (current contract): - -- `en`, `zh-CN`, `ja`, `ru`, `fr`, `vi` - -Collection indexes (category navigation): - -- `docs/getting-started/README.md` -- `docs/reference/README.md` -- `docs/operations/README.md` -- `docs/security/README.md` -- `docs/hardware/README.md` -- `docs/contributing/README.md` -- `docs/project/README.md` - -Runtime-contract references (must track behavior changes): - -- `docs/commands-reference.md` -- `docs/providers-reference.md` -- `docs/channels-reference.md` -- `docs/config-reference.md` -- `docs/operations-runbook.md` -- `docs/troubleshooting.md` -- `docs/one-click-bootstrap.md` - -Required docs governance rules: - -- Keep README/hub top navigation and quick routes intuitive and non-duplicative. -- Keep entry-point parity across all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when changing navigation architecture. -- If a change touches docs IA, runtime-contract references, or user-facing wording in shared docs, perform i18n follow-through for currently supported locales in the same PR: - - Update locale navigation links (`README*`, `docs/README*`, `docs/SUMMARY.md`). - - Update localized runtime-contract docs where equivalents exist (at minimum `commands-reference`, `config-reference`, `troubleshooting` for `fr` and `vi`). - - For Vietnamese, treat `docs/i18n/vi/**` as canonical. Keep `docs/*..md` compatibility shims aligned if present. -- Keep proposal/roadmap docs explicitly labeled; avoid mixing proposal text into runtime-contract docs. -- Keep project snapshots date-stamped and immutable once superseded by a newer date. - -## 5) Risk Tiers by Path (Review Depth Contract) - -Use these tiers when deciding validation depth and review rigor. +## Risk Tiers - **Low risk**: docs/chore/tests-only changes - **Medium risk**: most `src/**` behavior changes without boundary/security impact @@ -202,282 +57,34 @@ Use these tiers when deciding validation depth and review rigor. When uncertain, classify as higher risk. -## 6) Agent Workflow (Required) +## Workflow -1. **Read before write** - - Inspect existing module, factory wiring, and adjacent tests before editing. -2. **Define scope boundary** - - One concern per PR; avoid mixed feature+refactor+infra patches. -3. **Implement minimal patch** - - Apply KISS/YAGNI/DRY rule-of-three explicitly. -4. **Validate by risk tier** - - Docs-only: lightweight checks. - - Code/risky changes: full relevant checks and focused scenarios. -5. **Document impact** - - Update docs/PR notes for behavior, risk, side effects, and rollback. - - If CLI/config/provider/channel behavior changed, update corresponding runtime-contract references. - - If docs entry points changed, keep all supported locale README/docs-hub navigation aligned (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`). -6. **Respect queue hygiene** - - If stacked PR: declare `Depends on #...`. - - If replacing old PR: declare `Supersedes #...`. +1. **Read before write** — inspect existing module, factory wiring, and adjacent tests before editing. +2. **One concern per PR** — avoid mixed feature+refactor+infra patches. +3. **Implement minimal patch** — no speculative abstractions, no config keys without a concrete use case. +4. **Validate by risk tier** — docs-only: lightweight checks. Code changes: full relevant checks. +5. **Document impact** — update PR notes for behavior, risk, side effects, and rollback. +6. **Queue hygiene** — stacked PR: declare `Depends on #...`. Replacing old PR: declare `Supersedes #...`. -### 6.1 Branch / Commit / PR Flow (Required) +Branch/commit/PR rules: +- Work from a non-`master` branch. Open a PR to `master`; do not push directly. +- Use conventional commit titles. Prefer small PRs (`size: XS/S/M`). +- Follow `.github/pull_request_template.md` fully. +- Never commit secrets, personal data, or real identity information (see `@docs/contributing/pr-discipline.md`). -All contributors (human or agent) must follow the same collaboration flow: - -- Create and work from a non-`master` branch. -- Commit changes to that branch with clear, scoped commit messages. -- Open a PR to `master`; do not push directly to `master`. -- Wait for required checks and review outcomes before merging. -- Merge via PR controls (squash/rebase/merge as repository policy allows). -- Branch deletion after merge is optional; long-lived branches are allowed when intentionally maintained. - -### 6.2 Worktree Workflow (Required for Multi-Track Agent Work) - -Use Git worktrees to isolate concurrent agent/human tracks safely and predictably: - -- Use one worktree per active branch/PR stream to avoid cross-task contamination. -- Keep each worktree on a single branch; do not mix unrelated edits in one worktree. -- Run validation commands inside the corresponding worktree before commit/PR. -- Name worktrees clearly by scope (for example: `wt/ci-hardening`, `wt/provider-fix`) and remove stale worktrees when no longer needed. -- PR checkpoint rules from section 6.1 still apply to worktree-based development. - -### 6.3 Code Naming Contract (Required) - -Apply these naming rules for all code changes unless a subsystem has a stronger existing pattern. - -- Use Rust standard casing consistently: modules/files `snake_case`, types/traits/enums `PascalCase`, functions/variables `snake_case`, constants/statics `SCREAMING_SNAKE_CASE`. -- Name types and modules by domain role, not implementation detail (for example `DiscordChannel`, `SecurityPolicy`, `MemoryStore` over vague names like `Manager`/`Helper`). -- Keep trait implementer naming explicit and predictable: `Provider`, `Channel`, `Tool`, `Memory`. -- Keep factory registration keys stable, lowercase, and user-facing (for example `"openai"`, `"discord"`, `"shell"`), and avoid alias sprawl without migration need. -- Name tests by behavior/outcome (`_`) and keep fixture identifiers neutral/project-scoped. -- If identity-like naming is required in tests/examples, use ZeroClaw-native labels only (`ZeroClawAgent`, `zeroclaw_user`, `zeroclaw_node`). - -### 6.4 Architecture Boundary Contract (Required) - -Use these rules to keep the trait/factory architecture stable under growth. - -- Extend capabilities by adding trait implementations + factory wiring first; avoid cross-module rewrites for isolated features. -- Keep dependency direction inward to contracts: concrete integrations depend on trait/config/util layers, not on other concrete integrations. -- Avoid creating cross-subsystem coupling (for example provider code importing channel internals, tool code mutating gateway policy directly). -- Keep module responsibilities single-purpose: orchestration in `agent/`, transport in `channels/`, model I/O in `providers/`, policy in `security/`, execution in `tools/`. -- Introduce new shared abstractions only after repeated use (rule-of-three), with at least one real caller in current scope. -- For config/schema changes, treat keys as public contract: document defaults, compatibility impact, and migration/rollback path. - -## 7) Change Playbooks - -### 7.1 Adding a Provider - -- Implement `Provider` in `src/providers/`. -- Register in `src/providers/mod.rs` factory. -- Add focused tests for factory wiring and error paths. -- Avoid provider-specific behavior leaks into shared orchestration code. - -### 7.2 Adding a Channel - -- Implement `Channel` in `src/channels/`. -- Keep `send`, `listen`, `health_check`, typing semantics consistent. -- Cover auth/allowlist/health behavior with tests. - -### 7.3 Adding a Tool - -- Implement `Tool` in `src/tools/` with strict parameter schema. -- Validate and sanitize all inputs. -- Return structured `ToolResult`; avoid panics in runtime path. - -### 7.4 Adding a Peripheral - -- Implement `Peripheral` in `src/peripherals/`. -- Peripherals expose `tools()` — each tool delegates to the hardware (GPIO, sensors, etc.). -- Register board type in config schema if needed. -- See `docs/hardware-peripherals-design.md` for protocol and firmware notes. - -### 7.5 Security / Runtime / Gateway Changes - -- Include threat/risk notes and rollback strategy. -- Add/update tests or validation evidence for failure modes and boundaries. -- Keep observability useful but non-sensitive. -- For `.github/workflows/**` changes, include Actions allowlist impact in PR notes and update `docs/actions-source-policy.md` when sources change. - -### 7.6 Docs System / README / IA Changes - -- Treat docs navigation as product UX: preserve clear pathing from README -> docs hub -> SUMMARY -> category index. -- Keep top-level nav concise; avoid duplicative links across adjacent nav blocks. -- When runtime surfaces change, update related references (`commands/providers/channels/config/runbook/troubleshooting`). -- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when nav or key wording changes. -- When shared docs wording changes, sync corresponding localized docs for supported locales in the same PR (or explicitly document deferral and follow-up PR). -- For docs snapshots, add new date-stamped files for new sprints rather than rewriting historical context. - - -## 8) Validation Matrix - -Default local checks for code changes: - -```bash -cargo fmt --all -- --check -cargo clippy --all-targets -- -D warnings -cargo test -``` - -Preferred local pre-PR validation path (recommended, not required): - -```bash -./dev/ci.sh all -``` - -Notes: - -- Local Docker-based CI is strongly recommended when Docker is available. -- Contributors are not blocked from opening a PR if local Docker CI is unavailable; in that case run the most relevant native checks and document what was run. - -Additional expectations by change type: - -- **Docs/template-only**: - - run markdown lint and link-integrity checks - - if touching README/docs-hub/SUMMARY/collection indexes, verify EN/ZH/JA/RU navigation parity - - if touching bootstrap docs/scripts, run `bash -n install.sh` -- **Workflow changes**: validate YAML syntax; run workflow lint/sanity checks when available. -- **Security/runtime/gateway/tools**: include at least one boundary/failure-mode validation. - -If full checks are impractical, run the most relevant subset and document what was skipped and why. - -## 9) Collaboration and PR Discipline - -- Follow `.github/pull_request_template.md` fully (including side effects / blast radius). -- Keep PR descriptions concrete: problem, change, non-goals, risk, rollback. -- Use conventional commit titles. -- Prefer small PRs (`size: XS/S/M`) when possible. -- Agent-assisted PRs are welcome, **but contributors remain accountable for understanding what their code will do**. - -### 9.1 Privacy/Sensitive Data and Neutral Wording (Required) - -Treat privacy and neutrality as merge gates, not best-effort guidelines. - -- Never commit personal or sensitive data in code, docs, tests, fixtures, snapshots, logs, examples, or commit messages. -- Prohibited data includes (non-exhaustive): real names, personal emails, phone numbers, addresses, access tokens, API keys, credentials, IDs, and private URLs. -- Use neutral project-scoped placeholders (for example: `user_a`, `test_user`, `project_bot`, `example.com`) instead of real identity data. -- Test names/messages/fixtures must be impersonal and system-focused; avoid first-person or identity-specific language. -- If identity-like context is unavoidable, use ZeroClaw-scoped roles/labels only (for example: `ZeroClawAgent`, `ZeroClawOperator`, `zeroclaw_user`) and avoid real-world personas. -- Recommended identity-safe naming palette (use when identity-like context is required): - - actor labels: `ZeroClawAgent`, `ZeroClawOperator`, `ZeroClawMaintainer`, `zeroclaw_user` - - service/runtime labels: `zeroclaw_bot`, `zeroclaw_service`, `zeroclaw_runtime`, `zeroclaw_node` - - environment labels: `zeroclaw_project`, `zeroclaw_workspace`, `zeroclaw_channel` -- If reproducing external incidents, redact and anonymize all payloads before committing. -- Before push, review `git diff --cached` specifically for accidental sensitive strings and identity leakage. - -### 9.2 Superseded-PR Attribution (Required) - -When a PR supersedes another contributor's PR and carries forward substantive code or design decisions, preserve authorship explicitly. - -- In the integrating commit message, add one `Co-authored-by: Name ` trailer per superseded contributor whose work is materially incorporated. -- Use a GitHub-recognized email (`` or the contributor's verified commit email) so attribution is rendered correctly. -- Keep trailers on their own lines after a blank line at commit-message end; never encode them as escaped `\\n` text. -- In the PR body, list superseded PR links and briefly state what was incorporated from each. -- If no actual code/design was incorporated (only inspiration), do not use `Co-authored-by`; give credit in PR notes instead. - -### 9.3 Superseded-PR PR Template (Recommended) - -When superseding multiple PRs, use a consistent title/body structure to reduce reviewer ambiguity. - -- Recommended title format: `feat(): unify and supersede #, # [and #]` -- If this is docs/chore/meta only, keep the same supersede suffix and use the appropriate conventional-commit type. -- In the PR body, include the following template (fill placeholders, remove non-applicable lines): - -```md -## Supersedes -- # by @ -- # by @ -- # by @ - -## Integrated Scope -- From #: -- From #: -- From #: - -## Attribution -- Co-authored-by trailers added for materially incorporated contributors: Yes/No -- If No, explain why (for example: no direct code/design carry-over) - -## Non-goals -- - -## Risk and Rollback -- Risk: -- Rollback: -``` - -### 9.4 Superseded-PR Commit Template (Recommended) - -When a commit unifies or supersedes prior PR work, use a deterministic commit message layout so attribution is machine-parsed and reviewer-friendly. - -- Keep one blank line between message sections, and exactly one blank line before trailer lines. -- Keep each trailer on its own line; do not wrap, indent, or encode as escaped `\n` text. -- Add one `Co-authored-by` trailer per materially incorporated contributor, using GitHub-recognized email. -- If no direct code/design is carried over, omit `Co-authored-by` and explain attribution in the PR body instead. - -```text -feat(): unify and supersede #, # [and #] - - - -Supersedes: -- # by @ -- # by @ -- # by @ - -Integrated scope: -- : from # -- : from # - -Co-authored-by: -Co-authored-by: -``` - -Reference docs: - -- `CONTRIBUTING.md` -- `docs/README.md` -- `docs/SUMMARY.md` -- `docs/docs-inventory.md` -- `docs/commands-reference.md` -- `docs/providers-reference.md` -- `docs/channels-reference.md` -- `docs/config-reference.md` -- `docs/operations-runbook.md` -- `docs/troubleshooting.md` -- `docs/one-click-bootstrap.md` -- `docs/pr-workflow.md` -- `docs/reviewer-playbook.md` -- `docs/ci-map.md` -- `docs/actions-source-policy.md` - -## 10) Anti-Patterns (Do Not) +## Anti-Patterns - Do not add heavy dependencies for minor convenience. - Do not silently weaken security policy or access constraints. -- Do not add speculative config/feature flags “just in case”. +- Do not add speculative config/feature flags "just in case". - Do not mix massive formatting-only changes with functional changes. -- Do not modify unrelated modules “while here”. +- Do not modify unrelated modules "while here". - Do not bypass failing checks without explicit explanation. - Do not hide behavior-changing side effects in refactor commits. - Do not include personal identity or sensitive information in test data, examples, docs, or commits. -## 11) Handoff Template (Agent -> Agent / Maintainer) +## Linked References -When handing off work, include: - -1. What changed -2. What did not change -3. Validation run and results -4. Remaining risks / unknowns -5. Next recommended action - -## 12) Vibe Coding Guardrails - -When working in fast iterative mode: - -- Keep each iteration reversible (small commits, clear rollback). -- Validate assumptions with code search before implementing. -- Prefer deterministic behavior over clever shortcuts. -- Do not “ship and hope” on security-sensitive paths. -- If uncertain, leave a concrete TODO with verification context, not a hidden guess. +- `@docs/contributing/change-playbooks.md` — adding providers, channels, tools, peripherals; security/gateway changes; architecture boundaries +- `@docs/contributing/pr-discipline.md` — privacy rules, superseded-PR attribution/templates, handoff template +- `@docs/contributing/docs-contract.md` — docs system contract, i18n rules, locale parity diff --git a/docs/contributing/change-playbooks.md b/docs/contributing/change-playbooks.md new file mode 100644 index 000000000..c18477ccc --- /dev/null +++ b/docs/contributing/change-playbooks.md @@ -0,0 +1,53 @@ +# Change Playbooks + +Step-by-step guides for common extension and modification patterns in ZeroClaw. + +## Adding a Provider + +- Implement `Provider` in `src/providers/`. +- Register in `src/providers/mod.rs` factory. +- Add focused tests for factory wiring and error paths. +- Avoid provider-specific behavior leaks into shared orchestration code. + +## Adding a Channel + +- Implement `Channel` in `src/channels/`. +- Keep `send`, `listen`, `health_check`, typing semantics consistent. +- Cover auth/allowlist/health behavior with tests. + +## Adding a Tool + +- Implement `Tool` in `src/tools/` with strict parameter schema. +- Validate and sanitize all inputs. +- Return structured `ToolResult`; avoid panics in runtime path. + +## Adding a Peripheral + +- Implement `Peripheral` in `src/peripherals/`. +- Peripherals expose `tools()` — each tool delegates to the hardware (GPIO, sensors, etc.). +- Register board type in config schema if needed. +- See `docs/hardware/hardware-peripherals-design.md` for protocol and firmware notes. + +## Security / Runtime / Gateway Changes + +- Include threat/risk notes and rollback strategy. +- Add/update tests or validation evidence for failure modes and boundaries. +- Keep observability useful but non-sensitive. +- For `.github/workflows/**` changes, include Actions allowlist impact in PR notes and update `docs/contributing/actions-source-policy.md` when sources change. + +## Docs System / README / IA Changes + +- Treat docs navigation as product UX: preserve clear pathing from README -> docs hub -> SUMMARY -> category index. +- Keep top-level nav concise; avoid duplicative links across adjacent nav blocks. +- When runtime surfaces change, update related references in `docs/reference/`. +- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when nav or key wording changes. +- When shared docs wording changes, sync corresponding localized docs in the same PR (or explicitly document deferral and follow-up PR). + +## Architecture Boundary Rules + +- Extend capabilities by adding trait implementations + factory wiring first; avoid cross-module rewrites for isolated features. +- Keep dependency direction inward to contracts: concrete integrations depend on trait/config/util layers, not on other concrete integrations. +- Avoid cross-subsystem coupling (e.g., provider code importing channel internals, tool code mutating gateway policy directly). +- Keep module responsibilities single-purpose: orchestration in `agent/`, transport in `channels/`, model I/O in `providers/`, policy in `security/`, execution in `tools/`. +- Introduce new shared abstractions only after repeated use (rule-of-three), with at least one real caller. +- For config/schema changes, treat keys as public contract: document defaults, compatibility impact, and migration/rollback path. diff --git a/docs/contributing/docs-contract.md b/docs/contributing/docs-contract.md new file mode 100644 index 000000000..592a654b4 --- /dev/null +++ b/docs/contributing/docs-contract.md @@ -0,0 +1,34 @@ +# Documentation System Contract + +Treat documentation as a first-class product surface, not a post-merge artifact. + +## Canonical Entry Points + +- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md` +- docs hubs: `docs/README.md`, `docs/README.zh-CN.md`, `docs/README.ja.md`, `docs/README.ru.md`, `docs/README.fr.md`, `docs/README.vi.md` +- unified TOC: `docs/SUMMARY.md` + +## Supported Locales + +`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi` + +## Collection Indexes + +- `docs/setup-guides/README.md` +- `docs/reference/README.md` +- `docs/ops/README.md` +- `docs/security/README.md` +- `docs/hardware/README.md` +- `docs/contributing/README.md` +- `docs/maintainers/README.md` + +## Governance Rules + +- Keep README/hub top navigation and quick routes intuitive and non-duplicative. +- Keep entry-point parity across all supported locales when changing navigation architecture. +- If a change touches docs IA, runtime-contract references, or user-facing wording in shared docs, perform i18n follow-through for supported locales in the same PR: + - Update locale navigation links (`README*`, `docs/README*`, `docs/SUMMARY.md`). + - Update localized runtime-contract docs where equivalents exist. + - For Vietnamese, treat `docs/vi/**` as canonical. +- Keep proposal/roadmap docs explicitly labeled; avoid mixing proposal text into runtime-contract docs. +- Keep project snapshots date-stamped and immutable once superseded by a newer date. diff --git a/docs/contributing/pr-discipline.md b/docs/contributing/pr-discipline.md new file mode 100644 index 000000000..c4951c2b9 --- /dev/null +++ b/docs/contributing/pr-discipline.md @@ -0,0 +1,86 @@ +# PR Discipline + +Rules for pull request quality, attribution, privacy, and handoff in ZeroClaw. + +## Privacy / Sensitive Data (Required) + +Treat privacy and neutrality as merge gates, not best-effort guidelines. + +- Never commit personal or sensitive data in code, docs, tests, fixtures, snapshots, logs, examples, or commit messages. +- Prohibited data includes (non-exhaustive): real names, personal emails, phone numbers, addresses, access tokens, API keys, credentials, IDs, and private URLs. +- Use neutral project-scoped placeholders (e.g., `user_a`, `test_user`, `project_bot`, `example.com`) instead of real identity data. +- Test names/messages/fixtures must be impersonal and system-focused; avoid first-person or identity-specific language. +- If identity-like context is unavoidable, use ZeroClaw-scoped roles/labels only (e.g., `ZeroClawAgent`, `ZeroClawOperator`, `zeroclaw_user`). +- Recommended identity-safe naming palette: + - actor labels: `ZeroClawAgent`, `ZeroClawOperator`, `ZeroClawMaintainer`, `zeroclaw_user` + - service/runtime labels: `zeroclaw_bot`, `zeroclaw_service`, `zeroclaw_runtime`, `zeroclaw_node` + - environment labels: `zeroclaw_project`, `zeroclaw_workspace`, `zeroclaw_channel` +- If reproducing external incidents, redact and anonymize all payloads before committing. +- Before push, review `git diff --cached` specifically for accidental sensitive strings and identity leakage. + +## Superseded-PR Attribution (Required) + +When a PR supersedes another contributor's PR and carries forward substantive code or design decisions, preserve authorship explicitly. + +- In the integrating commit message, add one `Co-authored-by: Name ` trailer per superseded contributor whose work is materially incorporated. +- Use a GitHub-recognized email (`` or the contributor's verified commit email). +- Keep trailers on their own lines after a blank line at commit-message end; never encode them as escaped `\\n` text. +- In the PR body, list superseded PR links and briefly state what was incorporated from each. +- If no actual code/design was incorporated (only inspiration), do not use `Co-authored-by`; give credit in PR notes instead. + +## Superseded-PR Templates + +### PR Title/Body Template + +- Recommended title format: `feat(): unify and supersede #, # [and #]` +- In the PR body, include: + +```md +## Supersedes +- # by @ +- # by @ + +## Integrated Scope +- From #: +- From #: + +## Attribution +- Co-authored-by trailers added for materially incorporated contributors: Yes/No +- If No, explain why + +## Non-goals +- + +## Risk and Rollback +- Risk: +- Rollback: +``` + +### Commit Message Template + +```text +feat(): unify and supersede #, # [and #] + + + +Supersedes: +- # by @ +- # by @ + +Integrated scope: +- : from # +- : from # + +Co-authored-by: +Co-authored-by: +``` + +## Handoff Template (Agent -> Agent / Maintainer) + +When handing off work, include: + +1. What changed +2. What did not change +3. Validation run and results +4. Remaining risks / unknowns +5. Next recommended action From 631e7f61b5101c058aaba3c1993a90ab68dd0016 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:46:17 -0400 Subject: [PATCH 15/35] refactor(firmware): rename directories to drop zeroclaw- prefix MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - zeroclaw-arduino → arduino - zeroclaw-esp32 → esp32 - zeroclaw-esp32-ui → esp32-ui - zeroclaw-nucleo → nucleo - zeroclaw-uno-q-bridge → uno-q-bridge Pure file moves — no content changes. Follow-up commits update internal references (Cargo.toml names, include_str! paths, docs). --- .../zeroclaw-arduino.ino => arduino/arduino.ino} | 0 firmware/{zeroclaw-esp32-ui => esp32-ui}/.cargo/config.toml | 0 firmware/{zeroclaw-esp32-ui => esp32-ui}/Cargo.toml | 0 firmware/{zeroclaw-esp32-ui => esp32-ui}/README.md | 0 firmware/{zeroclaw-esp32-ui => esp32-ui}/build.rs | 0 firmware/{zeroclaw-esp32-ui => esp32-ui}/src/main.rs | 0 firmware/{zeroclaw-esp32-ui => esp32-ui}/ui/main.slint | 0 firmware/{zeroclaw-esp32 => esp32}/.cargo/config.toml | 0 firmware/{zeroclaw-esp32 => esp32}/Cargo.lock | 0 firmware/{zeroclaw-esp32 => esp32}/Cargo.toml | 0 firmware/{zeroclaw-esp32 => esp32}/README.md | 0 firmware/{zeroclaw-esp32 => esp32}/SETUP.md | 0 firmware/{zeroclaw-esp32 => esp32}/build.rs | 0 firmware/{zeroclaw-esp32 => esp32}/rust-toolchain.toml | 0 firmware/{zeroclaw-esp32 => esp32}/src/main.rs | 0 firmware/{zeroclaw-nucleo => nucleo}/Cargo.lock | 0 firmware/{zeroclaw-nucleo => nucleo}/Cargo.toml | 0 firmware/{zeroclaw-nucleo => nucleo}/src/main.rs | 0 firmware/{zeroclaw-uno-q-bridge => uno-q-bridge}/app.yaml | 0 firmware/{zeroclaw-uno-q-bridge => uno-q-bridge}/python/main.py | 0 .../python/requirements.txt | 0 .../{zeroclaw-uno-q-bridge => uno-q-bridge}/sketch/sketch.ino | 0 .../{zeroclaw-uno-q-bridge => uno-q-bridge}/sketch/sketch.yaml | 0 23 files changed, 0 insertions(+), 0 deletions(-) rename firmware/{zeroclaw-arduino/zeroclaw-arduino.ino => arduino/arduino.ino} (100%) rename firmware/{zeroclaw-esp32-ui => esp32-ui}/.cargo/config.toml (100%) rename firmware/{zeroclaw-esp32-ui => esp32-ui}/Cargo.toml (100%) rename firmware/{zeroclaw-esp32-ui => esp32-ui}/README.md (100%) rename firmware/{zeroclaw-esp32-ui => esp32-ui}/build.rs (100%) rename firmware/{zeroclaw-esp32-ui => esp32-ui}/src/main.rs (100%) rename firmware/{zeroclaw-esp32-ui => esp32-ui}/ui/main.slint (100%) rename firmware/{zeroclaw-esp32 => esp32}/.cargo/config.toml (100%) rename firmware/{zeroclaw-esp32 => esp32}/Cargo.lock (100%) rename firmware/{zeroclaw-esp32 => esp32}/Cargo.toml (100%) rename firmware/{zeroclaw-esp32 => esp32}/README.md (100%) rename firmware/{zeroclaw-esp32 => esp32}/SETUP.md (100%) rename firmware/{zeroclaw-esp32 => esp32}/build.rs (100%) rename firmware/{zeroclaw-esp32 => esp32}/rust-toolchain.toml (100%) rename firmware/{zeroclaw-esp32 => esp32}/src/main.rs (100%) rename firmware/{zeroclaw-nucleo => nucleo}/Cargo.lock (100%) rename firmware/{zeroclaw-nucleo => nucleo}/Cargo.toml (100%) rename firmware/{zeroclaw-nucleo => nucleo}/src/main.rs (100%) rename firmware/{zeroclaw-uno-q-bridge => uno-q-bridge}/app.yaml (100%) rename firmware/{zeroclaw-uno-q-bridge => uno-q-bridge}/python/main.py (100%) rename firmware/{zeroclaw-uno-q-bridge => uno-q-bridge}/python/requirements.txt (100%) rename firmware/{zeroclaw-uno-q-bridge => uno-q-bridge}/sketch/sketch.ino (100%) rename firmware/{zeroclaw-uno-q-bridge => uno-q-bridge}/sketch/sketch.yaml (100%) diff --git a/firmware/zeroclaw-arduino/zeroclaw-arduino.ino b/firmware/arduino/arduino.ino similarity index 100% rename from firmware/zeroclaw-arduino/zeroclaw-arduino.ino rename to firmware/arduino/arduino.ino diff --git a/firmware/zeroclaw-esp32-ui/.cargo/config.toml b/firmware/esp32-ui/.cargo/config.toml similarity index 100% rename from firmware/zeroclaw-esp32-ui/.cargo/config.toml rename to firmware/esp32-ui/.cargo/config.toml diff --git a/firmware/zeroclaw-esp32-ui/Cargo.toml b/firmware/esp32-ui/Cargo.toml similarity index 100% rename from firmware/zeroclaw-esp32-ui/Cargo.toml rename to firmware/esp32-ui/Cargo.toml diff --git a/firmware/zeroclaw-esp32-ui/README.md b/firmware/esp32-ui/README.md similarity index 100% rename from firmware/zeroclaw-esp32-ui/README.md rename to firmware/esp32-ui/README.md diff --git a/firmware/zeroclaw-esp32-ui/build.rs b/firmware/esp32-ui/build.rs similarity index 100% rename from firmware/zeroclaw-esp32-ui/build.rs rename to firmware/esp32-ui/build.rs diff --git a/firmware/zeroclaw-esp32-ui/src/main.rs b/firmware/esp32-ui/src/main.rs similarity index 100% rename from firmware/zeroclaw-esp32-ui/src/main.rs rename to firmware/esp32-ui/src/main.rs diff --git a/firmware/zeroclaw-esp32-ui/ui/main.slint b/firmware/esp32-ui/ui/main.slint similarity index 100% rename from firmware/zeroclaw-esp32-ui/ui/main.slint rename to firmware/esp32-ui/ui/main.slint diff --git a/firmware/zeroclaw-esp32/.cargo/config.toml b/firmware/esp32/.cargo/config.toml similarity index 100% rename from firmware/zeroclaw-esp32/.cargo/config.toml rename to firmware/esp32/.cargo/config.toml diff --git a/firmware/zeroclaw-esp32/Cargo.lock b/firmware/esp32/Cargo.lock similarity index 100% rename from firmware/zeroclaw-esp32/Cargo.lock rename to firmware/esp32/Cargo.lock diff --git a/firmware/zeroclaw-esp32/Cargo.toml b/firmware/esp32/Cargo.toml similarity index 100% rename from firmware/zeroclaw-esp32/Cargo.toml rename to firmware/esp32/Cargo.toml diff --git a/firmware/zeroclaw-esp32/README.md b/firmware/esp32/README.md similarity index 100% rename from firmware/zeroclaw-esp32/README.md rename to firmware/esp32/README.md diff --git a/firmware/zeroclaw-esp32/SETUP.md b/firmware/esp32/SETUP.md similarity index 100% rename from firmware/zeroclaw-esp32/SETUP.md rename to firmware/esp32/SETUP.md diff --git a/firmware/zeroclaw-esp32/build.rs b/firmware/esp32/build.rs similarity index 100% rename from firmware/zeroclaw-esp32/build.rs rename to firmware/esp32/build.rs diff --git a/firmware/zeroclaw-esp32/rust-toolchain.toml b/firmware/esp32/rust-toolchain.toml similarity index 100% rename from firmware/zeroclaw-esp32/rust-toolchain.toml rename to firmware/esp32/rust-toolchain.toml diff --git a/firmware/zeroclaw-esp32/src/main.rs b/firmware/esp32/src/main.rs similarity index 100% rename from firmware/zeroclaw-esp32/src/main.rs rename to firmware/esp32/src/main.rs diff --git a/firmware/zeroclaw-nucleo/Cargo.lock b/firmware/nucleo/Cargo.lock similarity index 100% rename from firmware/zeroclaw-nucleo/Cargo.lock rename to firmware/nucleo/Cargo.lock diff --git a/firmware/zeroclaw-nucleo/Cargo.toml b/firmware/nucleo/Cargo.toml similarity index 100% rename from firmware/zeroclaw-nucleo/Cargo.toml rename to firmware/nucleo/Cargo.toml diff --git a/firmware/zeroclaw-nucleo/src/main.rs b/firmware/nucleo/src/main.rs similarity index 100% rename from firmware/zeroclaw-nucleo/src/main.rs rename to firmware/nucleo/src/main.rs diff --git a/firmware/zeroclaw-uno-q-bridge/app.yaml b/firmware/uno-q-bridge/app.yaml similarity index 100% rename from firmware/zeroclaw-uno-q-bridge/app.yaml rename to firmware/uno-q-bridge/app.yaml diff --git a/firmware/zeroclaw-uno-q-bridge/python/main.py b/firmware/uno-q-bridge/python/main.py similarity index 100% rename from firmware/zeroclaw-uno-q-bridge/python/main.py rename to firmware/uno-q-bridge/python/main.py diff --git a/firmware/zeroclaw-uno-q-bridge/python/requirements.txt b/firmware/uno-q-bridge/python/requirements.txt similarity index 100% rename from firmware/zeroclaw-uno-q-bridge/python/requirements.txt rename to firmware/uno-q-bridge/python/requirements.txt diff --git a/firmware/zeroclaw-uno-q-bridge/sketch/sketch.ino b/firmware/uno-q-bridge/sketch/sketch.ino similarity index 100% rename from firmware/zeroclaw-uno-q-bridge/sketch/sketch.ino rename to firmware/uno-q-bridge/sketch/sketch.ino diff --git a/firmware/zeroclaw-uno-q-bridge/sketch/sketch.yaml b/firmware/uno-q-bridge/sketch/sketch.yaml similarity index 100% rename from firmware/zeroclaw-uno-q-bridge/sketch/sketch.yaml rename to firmware/uno-q-bridge/sketch/sketch.yaml From 620e4adee5a972cdd2a52b4dc2aa9106d139b41a Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:47:45 -0400 Subject: [PATCH 16/35] refactor(firmware): update crate names and paths to match directory renames - Align Cargo.toml package names and Cargo.lock with directory renames from previous commit - Update build and flash instructions in firmware docs --- firmware/esp32-ui/Cargo.toml | 2 +- firmware/esp32-ui/README.md | 4 ++-- firmware/esp32/Cargo.lock | 2 +- firmware/esp32/Cargo.toml | 2 +- firmware/esp32/README.md | 4 ++-- firmware/esp32/SETUP.md | 10 +++++----- firmware/nucleo/Cargo.lock | 2 +- firmware/nucleo/Cargo.toml | 4 ++-- 8 files changed, 15 insertions(+), 15 deletions(-) diff --git a/firmware/esp32-ui/Cargo.toml b/firmware/esp32-ui/Cargo.toml index f73c18d3f..53e3974fa 100644 --- a/firmware/esp32-ui/Cargo.toml +++ b/firmware/esp32-ui/Cargo.toml @@ -1,5 +1,5 @@ [package] -name = "zeroclaw-esp32-ui" +name = "esp32-ui" version = "0.1.0" edition = "2021" license = "MIT OR Apache-2.0" diff --git a/firmware/esp32-ui/README.md b/firmware/esp32-ui/README.md index a7f9141bc..58e2c36bf 100644 --- a/firmware/esp32-ui/README.md +++ b/firmware/esp32-ui/README.md @@ -26,7 +26,7 @@ What this crate **does not** do yet: ## Project Structure ```text -firmware/zeroclaw-esp32-ui/ +firmware/esp32-ui/ ├── Cargo.toml # Rust package and feature flags ├── build.rs # Slint compilation hook ├── .cargo/ @@ -56,7 +56,7 @@ firmware/zeroclaw-esp32-ui/ ### Default target (ESP32-C3, from `.cargo/config.toml`) ```bash -cd firmware/zeroclaw-esp32-ui +cd firmware/esp32-ui cargo build --release cargo espflash flash --release --monitor ``` diff --git a/firmware/esp32/Cargo.lock b/firmware/esp32/Cargo.lock index 69e989bc9..f1efc6bdd 100644 --- a/firmware/esp32/Cargo.lock +++ b/firmware/esp32/Cargo.lock @@ -1776,7 +1776,7 @@ dependencies = [ ] [[package]] -name = "zeroclaw-esp32" +name = "esp32" version = "0.1.0" dependencies = [ "anyhow", diff --git a/firmware/esp32/Cargo.toml b/firmware/esp32/Cargo.toml index fa4c90c97..42654c173 100644 --- a/firmware/esp32/Cargo.toml +++ b/firmware/esp32/Cargo.toml @@ -8,7 +8,7 @@ # Flash: cargo espflash flash --monitor [package] -name = "zeroclaw-esp32" +name = "esp32" version = "0.1.0" edition = "2021" license = "MIT OR Apache-2.0" diff --git a/firmware/esp32/README.md b/firmware/esp32/README.md index f4b2c0883..0d4d18bde 100644 --- a/firmware/esp32/README.md +++ b/firmware/esp32/README.md @@ -47,13 +47,13 @@ Commands: `gpio_read`, `gpio_write`. ## Build & Flash ```sh -cd firmware/zeroclaw-esp32 +cd firmware/esp32 # Use Python 3.12 (required if you have 3.14) export PATH="/opt/homebrew/opt/python@3.12/libexec/bin:$PATH" # Optional: pin MCU (esp32c3 or esp32c2) export MCU=esp32c3 cargo build --release -espflash flash target/riscv32imc-esp-espidf/release/zeroclaw-esp32 --monitor +espflash flash target/riscv32imc-esp-espidf/release/esp32 --monitor ``` ## Host Config diff --git a/firmware/esp32/SETUP.md b/firmware/esp32/SETUP.md index 0624f4de2..05a386079 100644 --- a/firmware/esp32/SETUP.md +++ b/firmware/esp32/SETUP.md @@ -15,12 +15,12 @@ brew install python@3.12 cargo install espflash ldproxy # 4. Build -cd firmware/zeroclaw-esp32 +cd firmware/esp32 export PATH="/opt/homebrew/opt/python@3.12/libexec/bin:$PATH" cargo build --release # 5. Flash (connect ESP32 via USB) -espflash flash target/riscv32imc-esp-espidf/release/zeroclaw-esp32 --monitor +espflash flash target/riscv32imc-esp-espidf/release/esp32 --monitor ``` --- @@ -63,7 +63,7 @@ export PATH="/opt/homebrew/opt/python@3.12/libexec/bin:$PATH" ### 5. Build ```sh -cd firmware/zeroclaw-esp32 +cd firmware/esp32 cargo build --release ``` @@ -72,7 +72,7 @@ First build downloads and compiles ESP-IDF (~5–15 min). ### 6. Flash ```sh -espflash flash target/riscv32imc-esp-espidf/release/zeroclaw-esp32 --monitor +espflash flash target/riscv32imc-esp-espidf/release/esp32 --monitor ``` --- @@ -104,7 +104,7 @@ This project uses **nightly Rust with build-std**, not espup. Ensure: - `rust-toolchain.toml` exists (pins nightly + rust-src) - You are **not** sourcing `~/export-esp.sh` (that's for Xtensa targets) -- Run `cargo build` from `firmware/zeroclaw-esp32` +- Run `cargo build` from `firmware/esp32` ### "externally-managed-environment" / "No module named 'virtualenv'" diff --git a/firmware/nucleo/Cargo.lock b/firmware/nucleo/Cargo.lock index 41b57b50b..17a7e2e14 100644 --- a/firmware/nucleo/Cargo.lock +++ b/firmware/nucleo/Cargo.lock @@ -834,7 +834,7 @@ dependencies = [ ] [[package]] -name = "zeroclaw-nucleo" +name = "nucleo" version = "0.1.0" dependencies = [ "cortex-m-rt", diff --git a/firmware/nucleo/Cargo.toml b/firmware/nucleo/Cargo.toml index 01d42114d..dd4190aab 100644 --- a/firmware/nucleo/Cargo.toml +++ b/firmware/nucleo/Cargo.toml @@ -4,11 +4,11 @@ # Protocol: same as Arduino/ESP32 — ping, capabilities, gpio_read, gpio_write. # # Build: cargo build --release -# Flash: probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/zeroclaw-nucleo +# Flash: probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/nucleo # Or: zeroclaw peripheral flash-nucleo [package] -name = "zeroclaw-nucleo" +name = "nucleo" version = "0.1.0" edition = "2021" license = "MIT OR Apache-2.0" From 1a78dcf447aeeb45b33e6dda9aa15a999594b6a0 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:49:20 -0400 Subject: [PATCH 17/35] refactor: update firmware path references to match directory renames - Align src/peripherals/ and docs/hardware/ with the firmware directory renames - Covers both compiled references (include_str!, constants) and documentation --- docs/hardware/hardware-peripherals-design.md | 4 ++-- docs/hardware/nucleo-setup.md | 8 ++++---- docs/i18n/vi/hardware-peripherals-design.md | 4 ++-- docs/i18n/vi/nucleo-setup.md | 8 ++++---- docs/maintainers/repo-map.md | 2 +- docs/vi/hardware-peripherals-design.md | 4 ++-- docs/vi/nucleo-setup.md | 8 ++++---- src/peripherals/arduino_flash.rs | 4 ++-- src/peripherals/nucleo_flash.rs | 6 +++--- src/peripherals/uno_q_bridge.rs | 4 ++-- src/peripherals/uno_q_setup.rs | 16 ++++++++-------- 11 files changed, 34 insertions(+), 34 deletions(-) diff --git a/docs/hardware/hardware-peripherals-design.md b/docs/hardware/hardware-peripherals-design.md index 125e69981..68f29248e 100644 --- a/docs/hardware/hardware-peripherals-design.md +++ b/docs/hardware/hardware-peripherals-design.md @@ -277,12 +277,12 @@ Simple JSON over serial for boards without gRPC support: ### Phase 6: Edge-Native — ESP32 - [x] Host-mediated ESP32 (serial transport) — same JSON protocol as STM32 -- [x] `zeroclaw-esp32` firmware crate (`firmware/zeroclaw-esp32`) — GPIO over UART +- [x] `esp32` firmware crate (`firmware/esp32`) — GPIO over UART - [x] ESP32 in hardware registry (CH340 VID/PID) - [ ] ZeroClaw *on* ESP32 (WiFi + LLM, edge-native) — future - [ ] Wasm or template-based execution for LLM-generated logic -**Usage:** Flash `firmware/zeroclaw-esp32` to ESP32, add `board = "esp32"`, `transport = "serial"`, `path = "/dev/ttyUSB0"` to config. +**Usage:** Flash `firmware/esp32` to ESP32, add `board = "esp32"`, `transport = "serial"`, `path = "/dev/ttyUSB0"` to config. ### Phase 7: Dynamic Execution (LLM-Generated Code) diff --git a/docs/hardware/nucleo-setup.md b/docs/hardware/nucleo-setup.md index bbbb88677..eb18862e0 100644 --- a/docs/hardware/nucleo-setup.md +++ b/docs/hardware/nucleo-setup.md @@ -41,7 +41,7 @@ ZeroClaw includes everything for Nucleo-F401RE: | Component | Location | Purpose | |-----------|----------|---------| -| Firmware | `firmware/zeroclaw-nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write | +| Firmware | `firmware/nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write | | Serial peripheral | `src/peripherals/serial.rs` | JSON-over-serial protocol (same as Arduino/ESP32) | | Flash command | `zeroclaw peripheral flash-nucleo` | Builds firmware, flashes via probe-rs | @@ -72,14 +72,14 @@ From the zeroclaw repo root: zeroclaw peripheral flash-nucleo ``` -This builds `firmware/zeroclaw-nucleo` and runs `probe-rs run --chip STM32F401RETx`. The firmware runs immediately after flashing. +This builds `firmware/nucleo` and runs `probe-rs run --chip STM32F401RETx`. The firmware runs immediately after flashing. ### 1.3 Manual Flash (Alternative) ```bash -cd firmware/zeroclaw-nucleo +cd firmware/nucleo cargo build --release --target thumbv7em-none-eabihf -probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/zeroclaw-nucleo +probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/nucleo ``` --- diff --git a/docs/i18n/vi/hardware-peripherals-design.md b/docs/i18n/vi/hardware-peripherals-design.md index d9c3c11f1..8a6e83d05 100644 --- a/docs/i18n/vi/hardware-peripherals-design.md +++ b/docs/i18n/vi/hardware-peripherals-design.md @@ -277,12 +277,12 @@ JSON đơn giản qua serial cho các board không hỗ trợ gRPC: ### Phase 6: Edge-Native — ESP32 - [x] ESP32 qua Host-Mediated (serial transport) — cùng giao thức JSON như STM32 -- [x] Crate firmware `zeroclaw-esp32` (`firmware/zeroclaw-esp32`) — GPIO qua UART +- [x] Crate firmware `esp32` (`firmware/esp32`) — GPIO qua UART - [x] ESP32 trong hardware registry (CH340 VID/PID) - [ ] ZeroClaw *chạy trực tiếp trên* ESP32 (WiFi + LLM, edge-native) — tương lai - [ ] Thực thi Wasm hoặc dựa trên template cho logic do LLM tạo ra -**Cách dùng:** Nạp `firmware/zeroclaw-esp32` vào ESP32, thêm `board = "esp32"`, `transport = "serial"`, `path = "/dev/ttyUSB0"` vào config. +**Cách dùng:** Nạp `firmware/esp32` vào ESP32, thêm `board = "esp32"`, `transport = "serial"`, `path = "/dev/ttyUSB0"` vào config. ### Phase 7: Thực thi động (Code do LLM tạo ra) diff --git a/docs/i18n/vi/nucleo-setup.md b/docs/i18n/vi/nucleo-setup.md index 1ddc935ea..9e5cd261d 100644 --- a/docs/i18n/vi/nucleo-setup.md +++ b/docs/i18n/vi/nucleo-setup.md @@ -41,7 +41,7 @@ ZeroClaw bao gồm mọi thứ cần thiết cho Nucleo-F401RE: | Thành phần | Vị trí | Mục đích | |------------|--------|---------| -| Firmware | `firmware/zeroclaw-nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write | +| Firmware | `firmware/nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write | | Serial peripheral | `src/peripherals/serial.rs` | Giao thức JSON-over-serial (giống Arduino/ESP32) | | Flash command | `zeroclaw peripheral flash-nucleo` | Build firmware, nạp qua probe-rs | @@ -72,14 +72,14 @@ Từ thư mục gốc của repo zeroclaw: zeroclaw peripheral flash-nucleo ``` -Lệnh này build `firmware/zeroclaw-nucleo` và chạy `probe-rs run --chip STM32F401RETx`. Firmware chạy ngay sau khi nạp xong. +Lệnh này build `firmware/nucleo` và chạy `probe-rs run --chip STM32F401RETx`. Firmware chạy ngay sau khi nạp xong. ### 1.3 Nạp thủ công (Phương án thay thế) ```bash -cd firmware/zeroclaw-nucleo +cd firmware/nucleo cargo build --release --target thumbv7em-none-eabihf -probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/zeroclaw-nucleo +probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/nucleo ``` --- diff --git a/docs/maintainers/repo-map.md b/docs/maintainers/repo-map.md index bedfdc7ce..97d10b0bd 100644 --- a/docs/maintainers/repo-map.md +++ b/docs/maintainers/repo-map.md @@ -198,7 +198,7 @@ Sandboxing: `bubblewrap.rs`, `firejail.rs`, `landlock.rs`, `docker.rs`, `detect. | `tests/` | Integration and E2E tests (agent loop, config persistence, channel routing, provider resolution, webhook security) | | `benches/` | Performance benchmarks (`agent_benchmarks.rs`) | | `examples/` | Extension examples: `custom_channel.rs`, `custom_memory.rs`, `custom_provider.rs`, `custom_tool.rs` | -| `firmware/` | Embedded firmware: `zeroclaw-arduino/`, `zeroclaw-esp32/`, `zeroclaw-esp32-ui/`, `zeroclaw-nucleo/`, `zeroclaw-uno-q-bridge/` | +| `firmware/` | Embedded firmware: `arduino/`, `esp32/`, `esp32-ui/`, `nucleo/`, `uno-q-bridge/` | | `web/` | Web UI frontend (Vite + TypeScript) | | `python/` | Python SDK / tools bridge with its own tests | | `dev/` | Local development: Docker Compose, CI script (`ci.sh`), config template, sandbox configs | diff --git a/docs/vi/hardware-peripherals-design.md b/docs/vi/hardware-peripherals-design.md index d9c3c11f1..8a6e83d05 100644 --- a/docs/vi/hardware-peripherals-design.md +++ b/docs/vi/hardware-peripherals-design.md @@ -277,12 +277,12 @@ JSON đơn giản qua serial cho các board không hỗ trợ gRPC: ### Phase 6: Edge-Native — ESP32 - [x] ESP32 qua Host-Mediated (serial transport) — cùng giao thức JSON như STM32 -- [x] Crate firmware `zeroclaw-esp32` (`firmware/zeroclaw-esp32`) — GPIO qua UART +- [x] Crate firmware `esp32` (`firmware/esp32`) — GPIO qua UART - [x] ESP32 trong hardware registry (CH340 VID/PID) - [ ] ZeroClaw *chạy trực tiếp trên* ESP32 (WiFi + LLM, edge-native) — tương lai - [ ] Thực thi Wasm hoặc dựa trên template cho logic do LLM tạo ra -**Cách dùng:** Nạp `firmware/zeroclaw-esp32` vào ESP32, thêm `board = "esp32"`, `transport = "serial"`, `path = "/dev/ttyUSB0"` vào config. +**Cách dùng:** Nạp `firmware/esp32` vào ESP32, thêm `board = "esp32"`, `transport = "serial"`, `path = "/dev/ttyUSB0"` vào config. ### Phase 7: Thực thi động (Code do LLM tạo ra) diff --git a/docs/vi/nucleo-setup.md b/docs/vi/nucleo-setup.md index 1ddc935ea..9e5cd261d 100644 --- a/docs/vi/nucleo-setup.md +++ b/docs/vi/nucleo-setup.md @@ -41,7 +41,7 @@ ZeroClaw bao gồm mọi thứ cần thiết cho Nucleo-F401RE: | Thành phần | Vị trí | Mục đích | |------------|--------|---------| -| Firmware | `firmware/zeroclaw-nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write | +| Firmware | `firmware/nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write | | Serial peripheral | `src/peripherals/serial.rs` | Giao thức JSON-over-serial (giống Arduino/ESP32) | | Flash command | `zeroclaw peripheral flash-nucleo` | Build firmware, nạp qua probe-rs | @@ -72,14 +72,14 @@ Từ thư mục gốc của repo zeroclaw: zeroclaw peripheral flash-nucleo ``` -Lệnh này build `firmware/zeroclaw-nucleo` và chạy `probe-rs run --chip STM32F401RETx`. Firmware chạy ngay sau khi nạp xong. +Lệnh này build `firmware/nucleo` và chạy `probe-rs run --chip STM32F401RETx`. Firmware chạy ngay sau khi nạp xong. ### 1.3 Nạp thủ công (Phương án thay thế) ```bash -cd firmware/zeroclaw-nucleo +cd firmware/nucleo cargo build --release --target thumbv7em-none-eabihf -probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/zeroclaw-nucleo +probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/nucleo ``` --- diff --git a/src/peripherals/arduino_flash.rs b/src/peripherals/arduino_flash.rs index 414427386..16c5b7a34 100644 --- a/src/peripherals/arduino_flash.rs +++ b/src/peripherals/arduino_flash.rs @@ -7,10 +7,10 @@ use anyhow::{Context, Result}; use std::process::Command; /// ZeroClaw Arduino Uno base firmware (capabilities, gpio_read, gpio_write). -const FIRMWARE_INO: &str = include_str!("../../firmware/zeroclaw-arduino/zeroclaw-arduino.ino"); +const FIRMWARE_INO: &str = include_str!("../../firmware/arduino/arduino.ino"); const FQBN: &str = "arduino:avr:uno"; -const SKETCH_NAME: &str = "zeroclaw-arduino"; +const SKETCH_NAME: &str = "arduino"; /// Check if arduino-cli is available. pub fn arduino_cli_available() -> bool { diff --git a/src/peripherals/nucleo_flash.rs b/src/peripherals/nucleo_flash.rs index 555887277..7744996f8 100644 --- a/src/peripherals/nucleo_flash.rs +++ b/src/peripherals/nucleo_flash.rs @@ -19,7 +19,7 @@ pub fn probe_rs_available() -> bool { .unwrap_or(false) } -/// Flash ZeroClaw Nucleo firmware. Builds from firmware/zeroclaw-nucleo. +/// Flash ZeroClaw Nucleo firmware. Builds from firmware/nucleo. pub fn flash_nucleo_firmware() -> Result<()> { if !probe_rs_available() { anyhow::bail!( @@ -31,7 +31,7 @@ pub fn flash_nucleo_firmware() -> Result<()> { // CARGO_MANIFEST_DIR = repo root (zeroclaw's Cargo.toml) let repo_root = PathBuf::from(env!("CARGO_MANIFEST_DIR")); - let firmware_dir = repo_root.join("firmware").join("zeroclaw-nucleo"); + let firmware_dir = repo_root.join("firmware").join("nucleo"); if !firmware_dir.join("Cargo.toml").exists() { anyhow::bail!( "Nucleo firmware not found at {}. Run from zeroclaw repo root.", @@ -55,7 +55,7 @@ pub fn flash_nucleo_firmware() -> Result<()> { .join("target") .join(TARGET) .join("release") - .join("zeroclaw-nucleo"); + .join("nucleo"); if !elf_path.exists() { anyhow::bail!("Built binary not found at {}", elf_path.display()); diff --git a/src/peripherals/uno_q_bridge.rs b/src/peripherals/uno_q_bridge.rs index a62183159..be981a773 100644 --- a/src/peripherals/uno_q_bridge.rs +++ b/src/peripherals/uno_q_bridge.rs @@ -40,7 +40,7 @@ impl Tool for UnoQGpioReadTool { } fn description(&self) -> &str { - "Read GPIO pin value (0 or 1) on Arduino Uno Q. Requires zeroclaw-uno-q-bridge app running." + "Read GPIO pin value (0 or 1) on Arduino Uno Q. Requires uno-q-bridge app running." } fn parameters_schema(&self) -> Value { @@ -96,7 +96,7 @@ impl Tool for UnoQGpioWriteTool { } fn description(&self) -> &str { - "Set GPIO pin high (1) or low (0) on Arduino Uno Q. Requires zeroclaw-uno-q-bridge app running." + "Set GPIO pin high (1) or low (0) on Arduino Uno Q. Requires uno-q-bridge app running." } fn parameters_schema(&self) -> Value { diff --git a/src/peripherals/uno_q_setup.rs b/src/peripherals/uno_q_setup.rs index 424bc89e4..b1e4d1e6f 100644 --- a/src/peripherals/uno_q_setup.rs +++ b/src/peripherals/uno_q_setup.rs @@ -3,14 +3,14 @@ use anyhow::{Context, Result}; use std::process::Command; -const BRIDGE_APP_NAME: &str = "zeroclaw-uno-q-bridge"; +const BRIDGE_APP_NAME: &str = "uno-q-bridge"; /// Deploy the Bridge app. If host is Some, scp from repo and ssh to start. /// If host is None, assume we're ON the Uno Q — use embedded files and start. pub fn setup_uno_q_bridge(host: Option<&str>) -> Result<()> { let bridge_dir = std::path::Path::new(env!("CARGO_MANIFEST_DIR")) .join("firmware") - .join("zeroclaw-uno-q-bridge"); + .join("uno-q-bridge"); if let Some(h) = host { if bridge_dir.exists() { @@ -66,7 +66,7 @@ fn deploy_remote(host: &str, bridge_dir: &std::path::Path) -> Result<()> { "arduino-app-cli", "app", "start", - "~/ArduinoApps/zeroclaw-uno-q-bridge", + "~/ArduinoApps/uno-q-bridge", ]) .status() .context("arduino-app-cli start failed")?; @@ -110,11 +110,11 @@ fn deploy_local(bridge_dir: Option<&std::path::Path>) -> Result<()> { } fn write_embedded_bridge(dest: &std::path::Path) -> Result<()> { - let app_yaml = include_str!("../../firmware/zeroclaw-uno-q-bridge/app.yaml"); - let sketch_ino = include_str!("../../firmware/zeroclaw-uno-q-bridge/sketch/sketch.ino"); - let sketch_yaml = include_str!("../../firmware/zeroclaw-uno-q-bridge/sketch/sketch.yaml"); - let main_py = include_str!("../../firmware/zeroclaw-uno-q-bridge/python/main.py"); - let requirements = include_str!("../../firmware/zeroclaw-uno-q-bridge/python/requirements.txt"); + let app_yaml = include_str!("../../firmware/uno-q-bridge/app.yaml"); + let sketch_ino = include_str!("../../firmware/uno-q-bridge/sketch/sketch.ino"); + let sketch_yaml = include_str!("../../firmware/uno-q-bridge/sketch/sketch.yaml"); + let main_py = include_str!("../../firmware/uno-q-bridge/python/main.py"); + let requirements = include_str!("../../firmware/uno-q-bridge/python/requirements.txt"); std::fs::write(dest.join("app.yaml"), app_yaml)?; std::fs::create_dir_all(dest.join("sketch"))?; From ea61491f2a17223e97ed6d148b945293ea2e2bee Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:49:56 -0400 Subject: [PATCH 18/35] chore: migrate GitHub URLs from theonlyhennygod to zeroclaw-labs - Replace all occurrences of theonlyhennygod/zeroclaw with zeroclaw-labs/zeroclaw - Affects root metadata, source code headers, hardware setup docs, and crate docs --- CHANGELOG.md | 2 +- SECURITY.md | 2 +- crates/robot-kit/PI5_SETUP.md | 2 +- docs/hardware/arduino-uno-q-setup.md | 8 ++++---- docs/i18n/vi/arduino-uno-q-setup.md | 8 ++++---- docs/vi/arduino-uno-q-setup.md | 8 ++++---- src/integrations/mod.rs | 2 +- src/providers/openrouter.rs | 8 ++++---- 8 files changed, 20 insertions(+), 20 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index fbc7ee779..84df648ef 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -64,4 +64,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Workspace escape prevention - Forbidden system path protection (`/etc`, `/root`, `~/.ssh`) -[0.1.0]: https://github.com/theonlyhennygod/zeroclaw/releases/tag/v0.1.0 +[0.1.0]: https://github.com/zeroclaw-labs/zeroclaw/releases/tag/v0.1.0 diff --git a/SECURITY.md b/SECURITY.md index 32c7c289c..a330860f3 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -13,7 +13,7 @@ Instead, please report them responsibly: 1. **Email**: Send details to the maintainers via GitHub private vulnerability reporting -2. **GitHub**: Use [GitHub Security Advisories](https://github.com/theonlyhennygod/zeroclaw/security/advisories/new) +2. **GitHub**: Use [GitHub Security Advisories](https://github.com/zeroclaw-labs/zeroclaw/security/advisories/new) ### What to Include diff --git a/crates/robot-kit/PI5_SETUP.md b/crates/robot-kit/PI5_SETUP.md index 5e90a5f2c..417ef8070 100644 --- a/crates/robot-kit/PI5_SETUP.md +++ b/crates/robot-kit/PI5_SETUP.md @@ -171,7 +171,7 @@ sudo usermod -aG dialout $USER ```bash # Clone repo (or copy from USB) -git clone https://github.com/theonlyhennygod/zeroclaw +git clone https://github.com/zeroclaw-labs/zeroclaw cd zeroclaw # Build robot kit diff --git a/docs/hardware/arduino-uno-q-setup.md b/docs/hardware/arduino-uno-q-setup.md index 1f333c19c..ee70b218e 100644 --- a/docs/hardware/arduino-uno-q-setup.md +++ b/docs/hardware/arduino-uno-q-setup.md @@ -10,7 +10,7 @@ ZeroClaw includes everything needed for Arduino Uno Q. **Clone the repo and foll | Component | Location | Purpose | |-----------|----------|---------| -| Bridge app | `firmware/zeroclaw-uno-q-bridge/` | MCU sketch + Python socket server (port 9999) for GPIO | +| Bridge app | `firmware/uno-q-bridge/` | MCU sketch + Python socket server (port 9999) for GPIO | | Bridge tools | `src/peripherals/uno_q_bridge.rs` | `gpio_read` / `gpio_write` tools that talk to the Bridge over TCP | | Setup command | `src/peripherals/uno_q_setup.rs` | `zeroclaw peripheral setup-uno-q` deploys the Bridge via scp + arduino-app-cli | | Config schema | `board = "arduino-uno-q"`, `transport = "bridge"` | Supported in `config.toml` | @@ -66,7 +66,7 @@ sudo apt-get update sudo apt-get install -y pkg-config libssl-dev # Clone zeroclaw (or scp your project) -git clone https://github.com/theonlyhennygod/zeroclaw.git +git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw # Build (takes ~15–30 min on Uno Q) @@ -168,7 +168,7 @@ zeroclaw peripheral setup-uno-q --host 192.168.0.48 zeroclaw peripheral setup-uno-q ``` -This copies the Bridge app to `~/ArduinoApps/zeroclaw-uno-q-bridge` and starts it. +This copies the Bridge app to `~/ArduinoApps/uno-q-bridge` and starts it. ### 5.2 Add to config.toml @@ -199,7 +199,7 @@ Now when you message your Telegram bot *"Turn on the LED"* or *"Set pin 13 high" | 2 | `ssh arduino@` | | 3 | `curl -sSf https://sh.rustup.rs \| sh -s -- -y && source ~/.cargo/env` | | 4 | `sudo apt-get install -y pkg-config libssl-dev` | -| 5 | `git clone https://github.com/theonlyhennygod/zeroclaw.git && cd zeroclaw` | +| 5 | `git clone https://github.com/zeroclaw-labs/zeroclaw.git && cd zeroclaw` | | 6 | `cargo build --release --features hardware` | | 7 | `zeroclaw onboard --api-key KEY --provider openrouter` | | 8 | Edit `~/.zeroclaw/config.toml` (add Telegram bot_token) | diff --git a/docs/i18n/vi/arduino-uno-q-setup.md b/docs/i18n/vi/arduino-uno-q-setup.md index 432ed0cf2..bf00ee727 100644 --- a/docs/i18n/vi/arduino-uno-q-setup.md +++ b/docs/i18n/vi/arduino-uno-q-setup.md @@ -10,7 +10,7 @@ ZeroClaw bao gồm mọi thứ cần thiết cho Arduino Uno Q. **Clone repo và | Thành phần | Vị trí | Mục đích | |------------|--------|---------| -| Bridge app | `firmware/zeroclaw-uno-q-bridge/` | MCU sketch + Python socket server (port 9999) cho GPIO | +| Bridge app | `firmware/uno-q-bridge/` | MCU sketch + Python socket server (port 9999) cho GPIO | | Bridge tools | `src/peripherals/uno_q_bridge.rs` | Tool `gpio_read` / `gpio_write` giao tiếp với Bridge qua TCP | | Setup command | `src/peripherals/uno_q_setup.rs` | `zeroclaw peripheral setup-uno-q` triển khai Bridge qua scp + arduino-app-cli | | Config schema | `board = "arduino-uno-q"`, `transport = "bridge"` | Được hỗ trợ trong `config.toml` | @@ -66,7 +66,7 @@ sudo apt-get update sudo apt-get install -y pkg-config libssl-dev # Clone zeroclaw (hoặc scp project của bạn) -git clone https://github.com/theonlyhennygod/zeroclaw.git +git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw # Build (~15–30 phút trên Uno Q) @@ -168,7 +168,7 @@ zeroclaw peripheral setup-uno-q --host 192.168.0.48 zeroclaw peripheral setup-uno-q ``` -Lệnh này copy Bridge app vào `~/ArduinoApps/zeroclaw-uno-q-bridge` và khởi động nó. +Lệnh này copy Bridge app vào `~/ArduinoApps/uno-q-bridge` và khởi động nó. ### 5.2 Thêm vào config.toml @@ -199,7 +199,7 @@ Giờ khi bạn nhắn tin cho Telegram bot *"Turn on the LED"* hoặc *"Set pin | 2 | `ssh arduino@` | | 3 | `curl -sSf https://sh.rustup.rs \| sh -s -- -y && source ~/.cargo/env` | | 4 | `sudo apt-get install -y pkg-config libssl-dev` | -| 5 | `git clone https://github.com/theonlyhennygod/zeroclaw.git && cd zeroclaw` | +| 5 | `git clone https://github.com/zeroclaw-labs/zeroclaw.git && cd zeroclaw` | | 6 | `cargo build --release --no-default-features` | | 7 | `zeroclaw onboard --api-key KEY --provider openrouter` | | 8 | Chỉnh sửa `~/.zeroclaw/config.toml` (thêm Telegram bot_token) | diff --git a/docs/vi/arduino-uno-q-setup.md b/docs/vi/arduino-uno-q-setup.md index 432ed0cf2..bf00ee727 100644 --- a/docs/vi/arduino-uno-q-setup.md +++ b/docs/vi/arduino-uno-q-setup.md @@ -10,7 +10,7 @@ ZeroClaw bao gồm mọi thứ cần thiết cho Arduino Uno Q. **Clone repo và | Thành phần | Vị trí | Mục đích | |------------|--------|---------| -| Bridge app | `firmware/zeroclaw-uno-q-bridge/` | MCU sketch + Python socket server (port 9999) cho GPIO | +| Bridge app | `firmware/uno-q-bridge/` | MCU sketch + Python socket server (port 9999) cho GPIO | | Bridge tools | `src/peripherals/uno_q_bridge.rs` | Tool `gpio_read` / `gpio_write` giao tiếp với Bridge qua TCP | | Setup command | `src/peripherals/uno_q_setup.rs` | `zeroclaw peripheral setup-uno-q` triển khai Bridge qua scp + arduino-app-cli | | Config schema | `board = "arduino-uno-q"`, `transport = "bridge"` | Được hỗ trợ trong `config.toml` | @@ -66,7 +66,7 @@ sudo apt-get update sudo apt-get install -y pkg-config libssl-dev # Clone zeroclaw (hoặc scp project của bạn) -git clone https://github.com/theonlyhennygod/zeroclaw.git +git clone https://github.com/zeroclaw-labs/zeroclaw.git cd zeroclaw # Build (~15–30 phút trên Uno Q) @@ -168,7 +168,7 @@ zeroclaw peripheral setup-uno-q --host 192.168.0.48 zeroclaw peripheral setup-uno-q ``` -Lệnh này copy Bridge app vào `~/ArduinoApps/zeroclaw-uno-q-bridge` và khởi động nó. +Lệnh này copy Bridge app vào `~/ArduinoApps/uno-q-bridge` và khởi động nó. ### 5.2 Thêm vào config.toml @@ -199,7 +199,7 @@ Giờ khi bạn nhắn tin cho Telegram bot *"Turn on the LED"* hoặc *"Set pin | 2 | `ssh arduino@` | | 3 | `curl -sSf https://sh.rustup.rs \| sh -s -- -y && source ~/.cargo/env` | | 4 | `sudo apt-get install -y pkg-config libssl-dev` | -| 5 | `git clone https://github.com/theonlyhennygod/zeroclaw.git && cd zeroclaw` | +| 5 | `git clone https://github.com/zeroclaw-labs/zeroclaw.git && cd zeroclaw` | | 6 | `cargo build --release --no-default-features` | | 7 | `zeroclaw onboard --api-key KEY --provider openrouter` | | 8 | Chỉnh sửa `~/.zeroclaw/config.toml` (thêm Telegram bot_token) | diff --git a/src/integrations/mod.rs b/src/integrations/mod.rs index 6a9b686fb..c8d6363fb 100644 --- a/src/integrations/mod.rs +++ b/src/integrations/mod.rs @@ -163,7 +163,7 @@ fn show_integration_info(config: &Config, name: &str) -> Result<()> { _ => { if status == IntegrationStatus::ComingSoon { println!(" This integration is planned. Stay tuned!"); - println!(" Track progress: https://github.com/theonlyhennygod/zeroclaw"); + println!(" Track progress: https://github.com/zeroclaw-labs/zeroclaw"); } } } diff --git a/src/providers/openrouter.rs b/src/providers/openrouter.rs index e92c9efa4..067284ae2 100644 --- a/src/providers/openrouter.rs +++ b/src/providers/openrouter.rs @@ -359,7 +359,7 @@ impl Provider for OpenRouterProvider { .header("Authorization", format!("Bearer {credential}")) .header( "HTTP-Referer", - "https://github.com/theonlyhennygod/zeroclaw", + "https://github.com/zeroclaw-labs/zeroclaw", ) .header("X-Title", "ZeroClaw") .json(&request) @@ -409,7 +409,7 @@ impl Provider for OpenRouterProvider { .header("Authorization", format!("Bearer {credential}")) .header( "HTTP-Referer", - "https://github.com/theonlyhennygod/zeroclaw", + "https://github.com/zeroclaw-labs/zeroclaw", ) .header("X-Title", "ZeroClaw") .json(&request) @@ -457,7 +457,7 @@ impl Provider for OpenRouterProvider { .header("Authorization", format!("Bearer {credential}")) .header( "HTTP-Referer", - "https://github.com/theonlyhennygod/zeroclaw", + "https://github.com/zeroclaw-labs/zeroclaw", ) .header("X-Title", "ZeroClaw") .json(&native_request) @@ -551,7 +551,7 @@ impl Provider for OpenRouterProvider { .header("Authorization", format!("Bearer {credential}")) .header( "HTTP-Referer", - "https://github.com/theonlyhennygod/zeroclaw", + "https://github.com/zeroclaw-labs/zeroclaw", ) .header("X-Title", "ZeroClaw") .json(&native_request) From 97ebfe054969072ec0e3b221dbeba1473a63cd14 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:51:26 -0400 Subject: [PATCH 19/35] minor typo --- NOTICE | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/NOTICE b/NOTICE index 70fc196fc..3b337b534 100644 --- a/NOTICE +++ b/NOTICE @@ -17,7 +17,7 @@ License This software is available under a dual-license model: - 1. MIT License — see LICENSE + 1. MIT License — see LICENSE-MIT 2. Apache License 2.0 — see LICENSE-APACHE You may use either license. Contributors grant rights under both. From 991a1ea9cc9ce0cba71856865aa3a4bf93a000e7 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Mon, 9 Mar 2026 23:51:44 -0400 Subject: [PATCH 20/35] ignore coverage report --- .gitignore | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.gitignore b/.gitignore index b8fd04961..484c81213 100644 --- a/.gitignore +++ b/.gitignore @@ -31,3 +31,6 @@ venv/ credentials.json .worktrees/ .zeroclaw/* + +# Coverage artifacts +lcov.info From df4e11bd1dbc977b55d63142cebeb1d624b17580 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 00:17:54 -0400 Subject: [PATCH 21/35] ci(workflows): rename workflow files and add lint + security jobs - Rename all 4 workflow files to match trigger and purpose - Expand PR quality gate with dedicated lint and security audit jobs - Align workflow display names, concurrency groups, and all doc references --- .../workflows/{ci.yml => checks-on-pr.yml} | 45 +++++++++++++++++- ...ll.yml => cross-platform-build-manual.yml} | 2 +- .github/workflows/master-branch-flow.md | 46 ++++++++++--------- .../{release.yml => release-beta-on-push.yml} | 2 +- ...-release.yml => release-stable-manual.yml} | 2 +- SECURITY.md | 2 +- docs/contributing/actions-source-policy.md | 9 ++-- docs/i18n/vi/actions-source-policy.md | 2 +- docs/vi/actions-source-policy.md | 2 +- 9 files changed, 79 insertions(+), 33 deletions(-) rename .github/workflows/{ci.yml => checks-on-pr.yml} (63%) rename .github/workflows/{ci-full.yml => cross-platform-build-manual.yml} (98%) rename .github/workflows/{release.yml => release-beta-on-push.yml} (99%) rename .github/workflows/{promote-release.yml => release-stable-manual.yml} (99%) diff --git a/.github/workflows/ci.yml b/.github/workflows/checks-on-pr.yml similarity index 63% rename from .github/workflows/ci.yml rename to .github/workflows/checks-on-pr.yml index b477d2964..b6fb02c89 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/checks-on-pr.yml @@ -1,11 +1,11 @@ -name: CI +name: Quality Gate on: pull_request: branches: [master] concurrency: - group: ci-${{ github.event.pull_request.number }} + group: checks-${{ github.event.pull_request.number }} cancel-in-progress: true permissions: @@ -16,6 +16,24 @@ env: CARGO_INCREMENTAL: 0 jobs: + lint: + name: Lint + runs-on: ubuntu-latest + timeout-minutes: 10 + steps: + - uses: actions/checkout@v4 + - uses: dtolnay/rust-toolchain@stable + with: + toolchain: 1.92.0 + components: rustfmt, clippy + - uses: Swatinem/rust-cache@v2 + + - name: Check formatting + run: cargo fmt --all -- --check + + - name: Clippy + run: cargo clippy --all-targets -- -D warnings + test: name: Test runs-on: ubuntu-latest @@ -73,3 +91,26 @@ jobs: env: CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_LINKER: clang CARGO_TARGET_X86_64_UNKNOWN_LINUX_GNU_RUSTFLAGS: "-C link-arg=-fuse-ld=mold" + + security: + name: Security Audit + runs-on: ubuntu-latest + timeout-minutes: 10 + steps: + - uses: actions/checkout@v4 + - uses: dtolnay/rust-toolchain@stable + with: + toolchain: 1.92.0 + - uses: Swatinem/rust-cache@v2 + + - name: Install cargo-audit + run: cargo install cargo-audit --locked + + - name: Install cargo-deny + run: cargo install cargo-deny --locked + + - name: Audit dependencies + run: cargo audit + + - name: Check licenses and sources + run: cargo deny check licenses sources diff --git a/.github/workflows/ci-full.yml b/.github/workflows/cross-platform-build-manual.yml similarity index 98% rename from .github/workflows/ci-full.yml rename to .github/workflows/cross-platform-build-manual.yml index cad707342..159869b3b 100644 --- a/.github/workflows/ci-full.yml +++ b/.github/workflows/cross-platform-build-manual.yml @@ -1,4 +1,4 @@ -name: CI Full Matrix +name: Cross-Platform Build on: workflow_dispatch: diff --git a/.github/workflows/master-branch-flow.md b/.github/workflows/master-branch-flow.md index 34c800fd1..8248e979d 100644 --- a/.github/workflows/master-branch-flow.md +++ b/.github/workflows/master-branch-flow.md @@ -18,27 +18,29 @@ Current maintainers with PR approval authority: `theonlyhennygod` and `jordanthe | File | Trigger | Purpose | | --- | --- | --- | -| `ci.yml` | `pull_request` → `master` | Test + build check on every PR | -| `ci-full.yml` | `workflow_dispatch` | Full platform build matrix (manual) | -| `release.yml` | `push` → `master` | Beta release on every master commit | -| `promote-release.yml` | `workflow_dispatch` | Stable release (manual, version-gated) | +| `checks-on-pr.yml` | `pull_request` → `master` | Lint + test + build + security audit on every PR | +| `cross-platform-build-manual.yml` | `workflow_dispatch` | Full platform build matrix (manual) | +| `release-beta-on-push.yml` | `push` → `master` | Beta release on every master commit | +| `release-stable-manual.yml` | `workflow_dispatch` | Stable release (manual, version-gated) | ## Event Summary | Event | Workflows triggered | | --- | --- | -| PR opened or updated against `master` | `ci.yml` | -| Push to `master` (including after merge) | `release.yml` | -| Manual dispatch | `ci-full.yml`, `promote-release.yml` | +| PR opened or updated against `master` | `checks-on-pr.yml` | +| Push to `master` (including after merge) | `release-beta-on-push.yml` | +| Manual dispatch | `cross-platform-build-manual.yml`, `release-stable-manual.yml` | ## Step-By-Step ### 1) PR → `master` 1. Contributor opens or updates a PR against `master`. -2. `ci.yml` starts: +2. `checks-on-pr.yml` starts: + - `lint` job: runs `cargo fmt --check` and `cargo clippy -D warnings`. - `test` job: runs `cargo nextest run --locked` on `ubuntu-latest` with Rust 1.92.0 and mold linker. - `build` job (matrix): compiles release binary on `x86_64-unknown-linux-gnu` and `aarch64-apple-darwin`. + - `security` job: runs `cargo audit` and `cargo deny check licenses sources`. - Concurrency group cancels in-progress runs for the same PR on new pushes. 3. All jobs must pass before merge. 4. Maintainer (`theonlyhennygod` or `jordanthejet`) merges PR once checks and review policy are satisfied. @@ -47,7 +49,7 @@ Current maintainers with PR approval authority: `theonlyhennygod` and `jordanthe ### 2) Push to `master` (including after merge) 1. Commit reaches `master`. -2. `release.yml` (Beta Release) starts: +2. `release-beta-on-push.yml` (Release Beta) starts: - `version` job: computes beta tag as `v{cargo_version}-beta.{run_number}`. - `build` job (matrix, 4 targets): `x86_64-linux`, `aarch64-linux`, `aarch64-darwin`, `x86_64-windows`. - `publish` job: generates `SHA256SUMS`, creates a GitHub pre-release with all artifacts. Artifact retention: 7 days. @@ -56,7 +58,7 @@ Current maintainers with PR approval authority: `theonlyhennygod` and `jordanthe ### 3) Stable Release (manual) -1. Maintainer runs `promote-release.yml` via `workflow_dispatch` with a version input (e.g. `0.2.0`). +1. Maintainer runs `release-stable-manual.yml` via `workflow_dispatch` with a version input (e.g. `0.2.0`). 2. `validate` job checks: - Input matches semver `X.Y.Z` format. - `Cargo.toml` version matches input exactly. @@ -67,13 +69,13 @@ Current maintainers with PR approval authority: `theonlyhennygod` and `jordanthe ### 4) Full Platform Build (manual) -1. Maintainer runs `ci-full.yml` via `workflow_dispatch`. +1. Maintainer runs `cross-platform-build-manual.yml` via `workflow_dispatch`. 2. `build` job (matrix, 3 targets): `aarch64-linux-gnu`, `x86_64-darwin` (macOS 15 Intel), `x86_64-windows-msvc`. -3. Build-only, no tests, no publish. Used to verify cross-compilation on platforms not covered by `ci.yml`. +3. Build-only, no tests, no publish. Used to verify cross-compilation on platforms not covered by `checks-on-pr.yml`. ## Build Targets by Workflow -| Target | `ci.yml` | `ci-full.yml` | `release.yml` | `promote-release.yml` | +| Target | `checks-on-pr.yml` | `cross-platform-build-manual.yml` | `release-beta-on-push.yml` | `release-stable-manual.yml` | | --- | :---: | :---: | :---: | :---: | | `x86_64-unknown-linux-gnu` | ✓ | | ✓ | ✓ | | `aarch64-unknown-linux-gnu` | | ✓ | ✓ | ✓ | @@ -87,10 +89,12 @@ Current maintainers with PR approval authority: `theonlyhennygod` and `jordanthe ```mermaid flowchart TD - A["PR opened or updated → master"] --> B["ci.yml"] + A["PR opened or updated → master"] --> B["checks-on-pr.yml"] + B --> B0["lint: fmt + clippy"] B --> B1["test: cargo nextest (ubuntu-latest)"] B --> B2["build: x86_64-linux + aarch64-darwin"] - B1 & B2 --> C{"Checks pass?"} + B --> B3["security: audit + deny"] + B0 & B1 & B2 & B3 --> C{"Checks pass?"} C -->|No| D["PR stays open"] C -->|Yes| E["Maintainer merges"] E --> F["push event on master"] @@ -100,7 +104,7 @@ flowchart TD ```mermaid flowchart TD - A["Push to master"] --> B["release.yml"] + A["Push to master"] --> B["release-beta-on-push.yml"] B --> B1["version: compute v{x.y.z}-beta.{N}"] B1 --> B2["build: 4 targets"] B2 --> B3["publish: GitHub pre-release + SHA256SUMS"] @@ -111,7 +115,7 @@ flowchart TD ```mermaid flowchart TD - A["workflow_dispatch: version=X.Y.Z"] --> B["promote-release.yml"] + A["workflow_dispatch: version=X.Y.Z"] --> B["release-stable-manual.yml"] B --> B1["validate: semver + Cargo.toml + tag uniqueness"] B1 --> B2["build: 4 targets"] B2 --> B3["publish: GitHub stable release + SHA256SUMS"] @@ -120,7 +124,7 @@ flowchart TD ## Quick Troubleshooting -1. **CI failing on PR**: check `test` job logs for test failures; check `build` job for compile errors. -2. **Beta release not appearing**: confirm the push landed on `master` (not another branch); check `release.yml` run status. -3. **Promote release failing at validate**: ensure `Cargo.toml` version matches the input version and the tag does not already exist. -4. **Full matrix build needed**: run `ci-full.yml` manually from the Actions tab. +1. **Quality gate failing on PR**: check `lint` job for formatting/clippy issues; check `test` job for test failures; check `build` job for compile errors; check `security` job for audit/deny failures. +2. **Beta release not appearing**: confirm the push landed on `master` (not another branch); check `release-beta-on-push.yml` run status. +3. **Stable release failing at validate**: ensure `Cargo.toml` version matches the input version and the tag does not already exist. +4. **Full matrix build needed**: run `cross-platform-build-manual.yml` manually from the Actions tab. diff --git a/.github/workflows/release.yml b/.github/workflows/release-beta-on-push.yml similarity index 99% rename from .github/workflows/release.yml rename to .github/workflows/release-beta-on-push.yml index 4490969e4..c78b4ca9b 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release-beta-on-push.yml @@ -1,4 +1,4 @@ -name: Beta Release +name: Release Beta on: push: diff --git a/.github/workflows/promote-release.yml b/.github/workflows/release-stable-manual.yml similarity index 99% rename from .github/workflows/promote-release.yml rename to .github/workflows/release-stable-manual.yml index 5158d0979..45c99abcf 100644 --- a/.github/workflows/promote-release.yml +++ b/.github/workflows/release-stable-manual.yml @@ -1,4 +1,4 @@ -name: Promote Release +name: Release Stable on: workflow_dispatch: diff --git a/SECURITY.md b/SECURITY.md index a330860f3..28b1370e7 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -87,7 +87,7 @@ docker run --read-only -v /path/to/workspace:/workspace zeroclaw gateway ### CI Enforcement -The `docker` job in `.github/workflows/ci.yml` automatically verifies: +The `docker` job in `.github/workflows/checks-on-pr.yml` automatically verifies: 1. Container does not run as root (UID 0) 2. Runtime stage uses `:nonroot` variant 3. Explicit `USER` directive with numeric UID exists diff --git a/docs/contributing/actions-source-policy.md b/docs/contributing/actions-source-policy.md index d306a4cdd..a51aa189d 100644 --- a/docs/contributing/actions-source-policy.md +++ b/docs/contributing/actions-source-policy.md @@ -7,7 +7,7 @@ This document defines the current GitHub Actions source-control policy for this - Repository Actions permissions: enabled - Allowed actions mode: selected -Selected allowlist (all actions currently used across CI, Beta Release, and Promote Release workflows): +Selected allowlist (all actions currently used across Quality Gate, Release Beta, and Release Stable workflows): | Action | Used In | Purpose | |--------|---------|---------| @@ -33,9 +33,9 @@ Equivalent allowlist patterns: | Workflow | File | Trigger | |----------|------|---------| -| CI | `.github/workflows/ci.yml` | Pull requests to `master` | -| Beta Release | `.github/workflows/release.yml` | Push to `master` | -| Promote Release | `.github/workflows/promote-release.yml` | Manual `workflow_dispatch` | +| Quality Gate | `.github/workflows/checks-on-pr.yml` | Pull requests to `master` | +| Release Beta | `.github/workflows/release-beta-on-push.yml` | Push to `master` | +| Release Stable | `.github/workflows/release-stable-manual.yml` | Manual `workflow_dispatch` | ## Change Control @@ -62,6 +62,7 @@ gh api repos/zeroclaw-labs/zeroclaw/actions/permissions/selected-actions ## Change Log +- 2026-03-10: Renamed workflows — CI → Quality Gate (`checks-on-pr.yml`), Beta Release → Release Beta (`release-beta-on-push.yml`), Promote Release → Release Stable (`release-stable-manual.yml`). Added `lint` and `security` jobs to Quality Gate. Added Cross-Platform Build (`cross-platform-build-manual.yml`). - 2026-03-05: Complete workflow overhaul — replaced 22 workflows with 3 (CI, Beta Release, Promote Release) - Removed patterns no longer in use: `DavidAnson/markdownlint-cli2-action@*`, `lycheeverse/lychee-action@*`, `EmbarkStudios/cargo-deny-action@*`, `rustsec/audit-check@*`, `rhysd/actionlint@*`, `sigstore/cosign-installer@*`, `Checkmarx/vorpal-reviewdog-github-action@*`, `useblacksmith/*` - Added: `Swatinem/rust-cache@*` (replaces `useblacksmith/*` rust-cache fork) diff --git a/docs/i18n/vi/actions-source-policy.md b/docs/i18n/vi/actions-source-policy.md index 9c6cc6766..37651bd58 100644 --- a/docs/i18n/vi/actions-source-policy.md +++ b/docs/i18n/vi/actions-source-policy.md @@ -76,7 +76,7 @@ Ghi chú quét gần đây nhất: - 2026-02-17: Cache phụ thuộc Rust được migrate từ `Swatinem/rust-cache` sang `useblacksmith/rust-cache` - Không cần mẫu allowlist mới (`useblacksmith/*` đã có trong allowlist) -- 2026-02-16: Phụ thuộc ẩn được phát hiện trong `release.yml`: `sigstore/cosign-installer@...` +- 2026-02-16: Phụ thuộc ẩn được phát hiện trong `release-beta-on-push.yml`: `sigstore/cosign-installer@...` - Đã thêm mẫu allowlist: `sigstore/cosign-installer@*` - 2026-02-16: Migration Blacksmith chặn thực thi workflow - Đã thêm mẫu allowlist: `useblacksmith/*` cho cơ sở hạ tầng self-hosted runner diff --git a/docs/vi/actions-source-policy.md b/docs/vi/actions-source-policy.md index 9c6cc6766..37651bd58 100644 --- a/docs/vi/actions-source-policy.md +++ b/docs/vi/actions-source-policy.md @@ -76,7 +76,7 @@ Ghi chú quét gần đây nhất: - 2026-02-17: Cache phụ thuộc Rust được migrate từ `Swatinem/rust-cache` sang `useblacksmith/rust-cache` - Không cần mẫu allowlist mới (`useblacksmith/*` đã có trong allowlist) -- 2026-02-16: Phụ thuộc ẩn được phát hiện trong `release.yml`: `sigstore/cosign-installer@...` +- 2026-02-16: Phụ thuộc ẩn được phát hiện trong `release-beta-on-push.yml`: `sigstore/cosign-installer@...` - Đã thêm mẫu allowlist: `sigstore/cosign-installer@*` - 2026-02-16: Migration Blacksmith chặn thực thi workflow - Đã thêm mẫu allowlist: `useblacksmith/*` cho cơ sở hạ tầng self-hosted runner From 852b67fff3fb7d5f79a3c2a731c9da88b1991ff7 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 00:19:12 -0400 Subject: [PATCH 22/35] chore: add VSCode configuration files for project - Introduced extensions.json to recommend essential Rust-related extensions. - Added launch.json for debugging configurations with LLDB for various components. - Created settings.json to configure editor preferences and Rust analyzer settings. - Included tasks.json to define build, lint, test, and CI tasks for the project. --- .vscode/extensions.json | 14 +++++ .vscode/launch.json | 73 ++++++++++++++++++++++ .vscode/settings.json | 22 +++++++ .vscode/tasks.json | 133 ++++++++++++++++++++++++++++++++++++++++ 4 files changed, 242 insertions(+) create mode 100644 .vscode/extensions.json create mode 100644 .vscode/launch.json create mode 100644 .vscode/settings.json create mode 100644 .vscode/tasks.json diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 000000000..0ea0454a0 --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,14 @@ +{ + "recommendations": [ + "rust-lang.rust-analyzer", + "vadimcn.vscode-lldb", + "serayuzgur.crates", + "bungcip.better-toml", + "usernamehw.errorlens", + "eamodio.gitlens", + "tamasfe.even-better-toml", + "dbaeumer.vscode-eslint", + "oderwat.indent-rainbow", + "ryanluker.vscode-coverage-gutters" + ] +} diff --git a/.vscode/launch.json b/.vscode/launch.json new file mode 100644 index 000000000..16503356d --- /dev/null +++ b/.vscode/launch.json @@ -0,0 +1,73 @@ +{ + "version": "0.2.0", + "inputs": [ + { + "id": "testName", + "description": "Exact test name to debug (e.g. tests::my_test)", + "type": "promptString", + "default": "" + } + ], + "configurations": [ + // ── Runtime ─────────────────────────────────────────── + { + "type": "lldb", + "request": "launch", + "name": "Debug: Agent", + "program": "${workspaceFolder}/target/debug/zeroclaw", + "args": ["agent"], + "cwd": "${workspaceFolder}", + "preLaunchTask": "Build: Debug" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug: Gateway", + "program": "${workspaceFolder}/target/debug/zeroclaw", + "args": ["gateway"], + "cwd": "${workspaceFolder}", + "preLaunchTask": "Build: Debug" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug: Daemon", + "program": "${workspaceFolder}/target/debug/zeroclaw", + "args": ["daemon"], + "cwd": "${workspaceFolder}", + "preLaunchTask": "Build: Debug" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug: Status", + "program": "${workspaceFolder}/target/debug/zeroclaw", + "args": ["status"], + "cwd": "${workspaceFolder}", + "preLaunchTask": "Build: Debug" + }, + { + "type": "lldb", + "request": "launch", + "name": "Debug: Onboard", + "program": "${workspaceFolder}/target/debug/zeroclaw", + "args": ["onboard"], + "cwd": "${workspaceFolder}", + "preLaunchTask": "Build: Debug" + }, + // ── Test ────────────────────────────────────────────── + { + "type": "lldb", + "request": "launch", + "name": "Debug: Test (by name)", + "cargo": { + "args": ["test", "--no-run", "--lib", "--"], + "filter": { + "kind": "lib" + } + }, + "args": ["--exact", "${input:testName}", "--nocapture"], + "cwd": "${workspaceFolder}" + } + ] +} diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 000000000..5ca32a7aa --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,22 @@ +{ + "git.autofetch": true, + "git.autofetchPeriod": 90, + "search.exclude": { + "**/target": true + }, + "files.watcherExclude": { + "**/target/**": true + }, + "[rust]": { + "editor.defaultFormatter": "rust-lang.rust-analyzer" + }, + "editor.formatOnSave": true, + "editor.formatOnPaste": true, + "files.autoSave": "afterDelay", + "files.autoSaveDelay": 1000, + "rust-analyzer.check.command": "clippy", + "rust-analyzer.check.extraArgs": ["--all-targets", "--", "-D", "warnings"], + "window.title": "${activeRepositoryBranchName}", + "coverage-gutters.coverageFileNames": ["lcov.info"], + "git.postCommitCommand": "push" +} diff --git a/.vscode/tasks.json b/.vscode/tasks.json new file mode 100644 index 000000000..fac8eeb1c --- /dev/null +++ b/.vscode/tasks.json @@ -0,0 +1,133 @@ +{ + "version": "2.0.0", + "inputs": [ + { + "id": "testFilter", + "description": "Test name or filter pattern", + "type": "promptString", + "default": "" + } + ], + "tasks": [ + // ── Build ────────────────────────────────────────────── + { + "label": "Build: Debug", + "type": "shell", + "command": "cargo", + "args": ["build"], + "group": { + "kind": "build", + "isDefault": true + }, + "problemMatcher": ["$rustc"] + }, + { + "label": "Build: Release", + "type": "shell", + "command": "cargo", + "args": ["build", "--release"], + "problemMatcher": ["$rustc"] + }, + { + "label": "Build: Check (fast)", + "type": "shell", + "command": "cargo", + "args": ["check", "--all-targets"], + "problemMatcher": ["$rustc"] + }, + // ── Lint ─────────────────────────────────────────────── + { + "label": "Lint: Clippy", + "type": "shell", + "command": "cargo", + "args": ["clippy", "--all-targets", "--", "-D", "warnings"], + "problemMatcher": ["$rustc"] + }, + { + "label": "Lint: Format Check", + "type": "shell", + "command": "cargo", + "args": ["fmt", "--all", "--", "--check"], + "problemMatcher": [] + }, + { + "label": "Lint: Format Fix", + "type": "shell", + "command": "cargo", + "args": ["fmt", "--all"], + "problemMatcher": [] + }, + // ── Test ────────────────────────────────────────────── + { + "label": "Test: All", + "type": "shell", + "command": "cargo nextest --version >/dev/null 2>&1 || cargo install cargo-nextest && cargo nextest run", + "group": { + "kind": "test", + "isDefault": true + }, + "problemMatcher": ["$rustc"] + }, + { + "label": "Test: Filtered", + "type": "shell", + "command": "cargo nextest --version >/dev/null 2>&1 || cargo install cargo-nextest && cargo nextest run -E 'test(${input:testFilter})'", + "problemMatcher": ["$rustc"] + }, + { + "label": "Test: Coverage Report", + "type": "shell", + "command": "cargo llvm-cov --version >/dev/null 2>&1 || cargo install cargo-llvm-cov && cargo llvm-cov --lcov --output-path lcov.info", + "problemMatcher": [] + }, + { + "label": "Test: Benchmarks", + "type": "shell", + "command": "cargo", + "args": ["bench"], + "problemMatcher": [] + }, + // ── Security ────────────────────────────────────────── + { + "label": "Security: Audit", + "type": "shell", + "command": "cargo audit --version >/dev/null 2>&1 || cargo install cargo-audit && cargo audit", + "problemMatcher": [] + }, + { + "label": "Security: Deny (licenses + sources)", + "type": "shell", + "command": "cargo deny --version >/dev/null 2>&1 || cargo install cargo-deny && cargo deny check licenses sources", + "problemMatcher": [] + }, + // ── CI (Docker) ─────────────────────────────────────── + { + "label": "CI: All (Docker)", + "type": "shell", + "command": "./dev/ci.sh", + "args": ["all"], + "problemMatcher": [] + }, + { + "label": "CI: Lint (Docker)", + "type": "shell", + "command": "./dev/ci.sh", + "args": ["lint"], + "problemMatcher": [] + }, + { + "label": "CI: Test (Docker)", + "type": "shell", + "command": "./dev/ci.sh", + "args": ["test"], + "problemMatcher": [] + }, + { + "label": "CI: Security (Docker)", + "type": "shell", + "command": "./dev/ci.sh", + "args": ["security"], + "problemMatcher": [] + } + ] +} From c204d72cc4622c868432523cfbff7564f5a9cfd6 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 00:19:18 -0400 Subject: [PATCH 23/35] TODOs --- docs/maintainers/refactor-candidates.md | 50 +++++++++++++++++++++++++ 1 file changed, 50 insertions(+) diff --git a/docs/maintainers/refactor-candidates.md b/docs/maintainers/refactor-candidates.md index 28f16768f..fba86b431 100644 --- a/docs/maintainers/refactor-candidates.md +++ b/docs/maintainers/refactor-candidates.md @@ -133,3 +133,53 @@ Changes deferred from the project-cleanup pass. Each entry includes rationale an - Create `docs/i18n/{zh-CN,ja,ru,fr}/` directories with their README + SUMMARY - Root `README.*.md` files stay (GitHub convention) - Update `docs/i18n/vi/` internal structure to mirror the new English docs layout after the English restructure lands + +### TODO: Fuzz testing — upgrade stubs to real coverage + +**Current state:** 5 fuzz targets exist in `fuzz/fuzz_targets/`, but only `fuzz_command_validation` tests real ZeroClaw code. The other 4 (`fuzz_config_parse`, `fuzz_tool_params`, `fuzz_webhook_payload`, `fuzz_provider_response`) just fuzz `serde_json::from_str::` or `toml::from_str::` — they test third-party crate internals, not ZeroClaw logic. + +**Wire existing stubs to real code paths:** + +- `fuzz_config_parse`: deserialize into `Config`, not `toml::Value` +- `fuzz_tool_params`: pass through actual `Tool::execute` input validation +- `fuzz_webhook_payload`: run through webhook signature verification + body parsing +- `fuzz_provider_response`: parse into actual provider response types (Anthropic, OpenAI, etc.) + +**Add missing targets for security surfaces:** + +- Shell command parser (quote-aware parsing, beyond just `validate_command_execution`) +- Credential scrubbing (`scrub_credentials` — already had a UTF-8 boundary panic in #3024) +- Pairing code generation/validation +- Domain matcher +- Prompt guard scoring +- Leak detector regex + +**Infrastructure improvements:** + +- Add seed corpora (`fuzz/corpus//`) with known-good and edge-case inputs; commit to repo +- Consider `Arbitrary` derive for structured fuzzing instead of raw `&[u8]` +- Set up scheduled CI fuzzing (nightly/weekly) — OSS-Fuzz is free for open-source projects +- Use `cargo fuzz coverage ` to generate lcov reports from corpus runs and track which code paths the fuzzer actually reaches +- Track crash artifacts (`fuzz/artifacts//`) as issues + +### TODO: Automated release announcements — Twitter/X integration + +**Current state:** Releases are published on GitHub only. No automated cross-posting to social channels. + +**Plan:** + +- Add `.github/workflows/release-tweet.yml` triggered on `release: [published]` +- Use `nearform-actions/github-action-notify-twitter` (OAuth 1.0a, v1.1 API) or direct X API v2 `curl` with OAuth signing +- Tweet template: release tag, one-line summary, link to GitHub release +- Skip prereleases (`if: "!github.event.release.prerelease"`) + +**Required secrets (Settings > Secrets > Actions):** + +- `TWITTER_API_KEY`, `TWITTER_API_KEY_SECRET` +- `TWITTER_ACCESS_TOKEN`, `TWITTER_ACCESS_TOKEN_SECRET` + +**Considerations:** + +- Review against `docs/contributing/actions-source-policy.md` — pin third-party action to commit SHA or vendor +- X free tier: 1,500 tweets/month (sufficient for releases) +- Truncate release body to 280 chars if including highlights in tweet From ad8e1e65e049acde8c886a921245d1399410dbd6 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 00:36:24 -0400 Subject: [PATCH 24/35] fix(ci): resolve lint and build failures in PR checks Apply cargo fmt to fix formatting diffs in openrouter.rs and serial.rs. Add web/dist placeholder step to lint, test, and build jobs so RustEmbed compiles without the gitignored frontend assets. Co-Authored-By: Claude Opus 4.6 --- .github/workflows/checks-on-pr.yml | 9 +++++++++ src/peripherals/serial.rs | 2 +- src/providers/openrouter.rs | 20 ++++---------------- 3 files changed, 14 insertions(+), 17 deletions(-) diff --git a/.github/workflows/checks-on-pr.yml b/.github/workflows/checks-on-pr.yml index b6fb02c89..2c431bff6 100644 --- a/.github/workflows/checks-on-pr.yml +++ b/.github/workflows/checks-on-pr.yml @@ -28,6 +28,9 @@ jobs: components: rustfmt, clippy - uses: Swatinem/rust-cache@v2 + - name: Ensure web/dist placeholder exists + run: mkdir -p web/dist && touch web/dist/.gitkeep + - name: Check formatting run: cargo fmt --all -- --check @@ -45,6 +48,9 @@ jobs: toolchain: 1.92.0 - uses: Swatinem/rust-cache@v2 + - name: Ensure web/dist placeholder exists + run: mkdir -p web/dist && touch web/dist/.gitkeep + - name: Install mold linker run: | sudo apt-get update -qq @@ -85,6 +91,9 @@ jobs: sudo apt-get update -qq sudo apt-get install -y mold + - name: Ensure web/dist placeholder exists + run: mkdir -p web/dist && touch web/dist/.gitkeep + - name: Build release shell: bash run: cargo build --release --locked --target ${{ matrix.target }} diff --git a/src/peripherals/serial.rs b/src/peripherals/serial.rs index da2c2c146..4b0654736 100644 --- a/src/peripherals/serial.rs +++ b/src/peripherals/serial.rs @@ -4,8 +4,8 @@ //! Request: {"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}} //! Response: {"id":"1","ok":true,"result":"done"} -use crate::peripherals::Peripheral; use crate::config::PeripheralBoardConfig; +use crate::peripherals::Peripheral; use crate::tools::traits::{Tool, ToolResult}; use async_trait::async_trait; use serde_json::{json, Value}; diff --git a/src/providers/openrouter.rs b/src/providers/openrouter.rs index 067284ae2..3443b48db 100644 --- a/src/providers/openrouter.rs +++ b/src/providers/openrouter.rs @@ -357,10 +357,7 @@ impl Provider for OpenRouterProvider { .http_client() .post("https://openrouter.ai/api/v1/chat/completions") .header("Authorization", format!("Bearer {credential}")) - .header( - "HTTP-Referer", - "https://github.com/zeroclaw-labs/zeroclaw", - ) + .header("HTTP-Referer", "https://github.com/zeroclaw-labs/zeroclaw") .header("X-Title", "ZeroClaw") .json(&request) .send() @@ -407,10 +404,7 @@ impl Provider for OpenRouterProvider { .http_client() .post("https://openrouter.ai/api/v1/chat/completions") .header("Authorization", format!("Bearer {credential}")) - .header( - "HTTP-Referer", - "https://github.com/zeroclaw-labs/zeroclaw", - ) + .header("HTTP-Referer", "https://github.com/zeroclaw-labs/zeroclaw") .header("X-Title", "ZeroClaw") .json(&request) .send() @@ -455,10 +449,7 @@ impl Provider for OpenRouterProvider { .http_client() .post("https://openrouter.ai/api/v1/chat/completions") .header("Authorization", format!("Bearer {credential}")) - .header( - "HTTP-Referer", - "https://github.com/zeroclaw-labs/zeroclaw", - ) + .header("HTTP-Referer", "https://github.com/zeroclaw-labs/zeroclaw") .header("X-Title", "ZeroClaw") .json(&native_request) .send() @@ -549,10 +540,7 @@ impl Provider for OpenRouterProvider { .http_client() .post("https://openrouter.ai/api/v1/chat/completions") .header("Authorization", format!("Bearer {credential}")) - .header( - "HTTP-Referer", - "https://github.com/zeroclaw-labs/zeroclaw", - ) + .header("HTTP-Referer", "https://github.com/zeroclaw-labs/zeroclaw") .header("X-Title", "ZeroClaw") .json(&native_request) .send() From 08d6959e0d5d387e741ac570c42667cb58942111 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 00:55:30 -0400 Subject: [PATCH 25/35] =?UTF-8?q?security:=20=20Bump=20quinn-proto=200.11.?= =?UTF-8?q?13=20=E2=86=92=200.11.14=20to=20resolve=20high-severity=20(8.7)?= =?UTF-8?q?=20=20=20denial-of-service=20vulnerability=20in=20Quinn=20endpo?= =?UTF-8?q?ints.=20Lockfile-only=20=20=20change;=20no=20code=20modificatio?= =?UTF-8?q?ns.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Cargo.lock | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Cargo.lock b/Cargo.lock index 6aaebdd93..00be0b1cf 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -4797,9 +4797,9 @@ dependencies = [ [[package]] name = "quinn-proto" -version = "0.11.13" +version = "0.11.14" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "f1906b49b0c3bc04b5fe5d86a77925ae6524a19b816ae38ce1e426255f1d8a31" +checksum = "434b42fec591c96ef50e21e886936e66d3cc3f737104fdb9b737c40ffb94c098" dependencies = [ "bytes", "getrandom 0.3.4", From 8538c4105ac673a0c94b6d46a4d47df52c6e980c Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 01:09:32 -0400 Subject: [PATCH 26/35] fix(ci): SHA-pin all third-party GitHub Actions Replace mutable version tags with immutable commit SHAs to prevent tag-hijacking supply chain attacks (P1 finding). Co-Authored-By: Claude Opus 4.6 --- .github/workflows/checks-on-pr.yml | 24 +++++++++---------- .../workflows/cross-platform-build-manual.yml | 6 ++--- .github/workflows/release-beta-on-push.yml | 24 +++++++++---------- .github/workflows/release-stable-manual.yml | 24 +++++++++---------- 4 files changed, 39 insertions(+), 39 deletions(-) diff --git a/.github/workflows/checks-on-pr.yml b/.github/workflows/checks-on-pr.yml index 2c431bff6..43a0dfd5f 100644 --- a/.github/workflows/checks-on-pr.yml +++ b/.github/workflows/checks-on-pr.yml @@ -21,12 +21,12 @@ jobs: runs-on: ubuntu-latest timeout-minutes: 10 steps: - - uses: actions/checkout@v4 - - uses: dtolnay/rust-toolchain@stable + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 + - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable with: toolchain: 1.92.0 components: rustfmt, clippy - - uses: Swatinem/rust-cache@v2 + - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 - name: Ensure web/dist placeholder exists run: mkdir -p web/dist && touch web/dist/.gitkeep @@ -42,11 +42,11 @@ jobs: runs-on: ubuntu-latest timeout-minutes: 30 steps: - - uses: actions/checkout@v4 - - uses: dtolnay/rust-toolchain@stable + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 + - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable with: toolchain: 1.92.0 - - uses: Swatinem/rust-cache@v2 + - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 - name: Ensure web/dist placeholder exists run: mkdir -p web/dist && touch web/dist/.gitkeep @@ -78,12 +78,12 @@ jobs: - os: macos-14 target: aarch64-apple-darwin steps: - - uses: actions/checkout@v4 - - uses: dtolnay/rust-toolchain@stable + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 + - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable with: toolchain: 1.92.0 targets: ${{ matrix.target }} - - uses: Swatinem/rust-cache@v2 + - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 - name: Install mold linker if: runner.os == 'Linux' @@ -106,11 +106,11 @@ jobs: runs-on: ubuntu-latest timeout-minutes: 10 steps: - - uses: actions/checkout@v4 - - uses: dtolnay/rust-toolchain@stable + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 + - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable with: toolchain: 1.92.0 - - uses: Swatinem/rust-cache@v2 + - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 - name: Install cargo-audit run: cargo install cargo-audit --locked diff --git a/.github/workflows/cross-platform-build-manual.yml b/.github/workflows/cross-platform-build-manual.yml index 159869b3b..1966f832c 100644 --- a/.github/workflows/cross-platform-build-manual.yml +++ b/.github/workflows/cross-platform-build-manual.yml @@ -29,12 +29,12 @@ jobs: - os: windows-latest target: x86_64-pc-windows-msvc steps: - - uses: actions/checkout@v4 - - uses: dtolnay/rust-toolchain@stable + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 + - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable with: toolchain: 1.92.0 targets: ${{ matrix.target }} - - uses: Swatinem/rust-cache@v2 + - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 if: runner.os != 'Windows' - name: Install cross compiler diff --git a/.github/workflows/release-beta-on-push.yml b/.github/workflows/release-beta-on-push.yml index c78b4ca9b..b81d93200 100644 --- a/.github/workflows/release-beta-on-push.yml +++ b/.github/workflows/release-beta-on-push.yml @@ -25,7 +25,7 @@ jobs: version: ${{ steps.ver.outputs.version }} tag: ${{ steps.ver.outputs.tag }} steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 - name: Compute beta version id: ver shell: bash @@ -66,12 +66,12 @@ jobs: artifact: zeroclaw.exe ext: zip steps: - - uses: actions/checkout@v4 - - uses: dtolnay/rust-toolchain@stable + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 + - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable with: toolchain: 1.92.0 targets: ${{ matrix.target }} - - uses: Swatinem/rust-cache@v2 + - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 if: runner.os != 'Windows' - name: Install cross compiler @@ -100,7 +100,7 @@ jobs: cd target/${{ matrix.target }}/release 7z a ../../../zeroclaw-${{ matrix.target }}.${{ matrix.ext }} ${{ matrix.artifact }} - - uses: actions/upload-artifact@v4 + - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 with: name: zeroclaw-${{ matrix.target }} path: zeroclaw-${{ matrix.target }}.${{ matrix.ext }} @@ -111,9 +111,9 @@ jobs: needs: [version, build] runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 - - uses: actions/download-artifact@v4 + - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4 with: path: artifacts @@ -124,7 +124,7 @@ jobs: cat SHA256SUMS - name: Create GitHub Release - uses: softprops/action-gh-release@v2 + uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2 with: tag_name: ${{ needs.version.outputs.tag }} name: ${{ needs.version.outputs.tag }} @@ -141,18 +141,18 @@ jobs: runs-on: ubuntu-latest timeout-minutes: 30 steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 - - uses: docker/setup-buildx-action@v3 + - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3 - - uses: docker/login-action@v3 + - uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3 with: registry: ${{ env.REGISTRY }} username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Build and push - uses: docker/build-push-action@v6 + uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6 with: context: . push: true diff --git a/.github/workflows/release-stable-manual.yml b/.github/workflows/release-stable-manual.yml index 45c99abcf..37eeb7dc8 100644 --- a/.github/workflows/release-stable-manual.yml +++ b/.github/workflows/release-stable-manual.yml @@ -28,7 +28,7 @@ jobs: outputs: tag: ${{ steps.check.outputs.tag }} steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 - name: Validate semver and Cargo.toml match id: check shell: bash @@ -84,12 +84,12 @@ jobs: artifact: zeroclaw.exe ext: zip steps: - - uses: actions/checkout@v4 - - uses: dtolnay/rust-toolchain@stable + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 + - uses: dtolnay/rust-toolchain@631a55b12751854ce901bb631d5902ceb48146f7 # stable with: toolchain: 1.92.0 targets: ${{ matrix.target }} - - uses: Swatinem/rust-cache@v2 + - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 if: runner.os != 'Windows' - name: Install cross compiler @@ -118,7 +118,7 @@ jobs: cd target/${{ matrix.target }}/release 7z a ../../../zeroclaw-${{ matrix.target }}.${{ matrix.ext }} ${{ matrix.artifact }} - - uses: actions/upload-artifact@v4 + - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4 with: name: zeroclaw-${{ matrix.target }} path: zeroclaw-${{ matrix.target }}.${{ matrix.ext }} @@ -129,9 +129,9 @@ jobs: needs: [validate, build] runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 - - uses: actions/download-artifact@v4 + - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4 with: path: artifacts @@ -142,7 +142,7 @@ jobs: cat SHA256SUMS - name: Create GitHub Release - uses: softprops/action-gh-release@v2 + uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2 with: tag_name: ${{ needs.validate.outputs.tag }} name: ${{ needs.validate.outputs.tag }} @@ -159,18 +159,18 @@ jobs: runs-on: ubuntu-latest timeout-minutes: 30 steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 - - uses: docker/setup-buildx-action@v3 + - uses: docker/setup-buildx-action@8d2750c68a42422c14e847fe6c8ac0403b4cbd6f # v3 - - uses: docker/login-action@v3 + - uses: docker/login-action@c94ce9fb468520275223c153574b00df6fe4bcc9 # v3 with: registry: ${{ env.REGISTRY }} username: ${{ github.actor }} password: ${{ secrets.GITHUB_TOKEN }} - name: Build and push - uses: docker/build-push-action@v6 + uses: docker/build-push-action@10e90e3645eae34f1e60eeb005ba3a3d33f178e8 # v6 with: context: . push: true From d1fffc3b7464ee3e743145fd188456e0f3f6d2bf Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 01:09:51 -0400 Subject: [PATCH 27/35] fix(ci): scope release workflow permissions per-job Narrow workflow-level permissions to contents:read and grant write access only to the specific jobs that need it (publish gets contents:write, docker gets packages:write). Reduces blast radius if a build step is compromised (P1 finding). Co-Authored-By: Claude Opus 4.6 --- .github/workflows/release-beta-on-push.yml | 8 ++++++-- .github/workflows/release-stable-manual.yml | 8 ++++++-- 2 files changed, 12 insertions(+), 4 deletions(-) diff --git a/.github/workflows/release-beta-on-push.yml b/.github/workflows/release-beta-on-push.yml index b81d93200..ae51109df 100644 --- a/.github/workflows/release-beta-on-push.yml +++ b/.github/workflows/release-beta-on-push.yml @@ -9,8 +9,7 @@ concurrency: cancel-in-progress: false permissions: - contents: write - packages: write + contents: read env: CARGO_TERM_COLOR: always @@ -110,6 +109,8 @@ jobs: name: Publish Beta Release needs: [version, build] runs-on: ubuntu-latest + permissions: + contents: write steps: - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 @@ -140,6 +141,9 @@ jobs: needs: [version, build] runs-on: ubuntu-latest timeout-minutes: 30 + permissions: + contents: read + packages: write steps: - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 diff --git a/.github/workflows/release-stable-manual.yml b/.github/workflows/release-stable-manual.yml index 37eeb7dc8..39dc4fe35 100644 --- a/.github/workflows/release-stable-manual.yml +++ b/.github/workflows/release-stable-manual.yml @@ -13,8 +13,7 @@ concurrency: cancel-in-progress: false permissions: - contents: write - packages: write + contents: read env: CARGO_TERM_COLOR: always @@ -128,6 +127,8 @@ jobs: name: Publish Stable Release needs: [validate, build] runs-on: ubuntu-latest + permissions: + contents: write steps: - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 @@ -158,6 +159,9 @@ jobs: needs: [validate, build] runs-on: ubuntu-latest timeout-minutes: 30 + permissions: + contents: read + packages: write steps: - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4 From 8d48472c9e473ff64a5365a28ac52ceaf3510fe2 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 01:10:19 -0400 Subject: [PATCH 28/35] fix(ci): add gate job and use pre-built security tools Add composite Gate job to checks-on-pr.yml so branch protection only needs a single required check. Replace cargo-install with taiki-e/install-action for cargo-audit and cargo-deny to cut minutes off every PR run. Mark CI/CD P1/P2 findings as resolved in refactor-candidates.md. Co-Authored-By: Claude Opus 4.6 --- .github/workflows/checks-on-pr.yml | 25 +++++++++++++++++++++---- docs/maintainers/refactor-candidates.md | 10 ++++++++++ 2 files changed, 31 insertions(+), 4 deletions(-) diff --git a/.github/workflows/checks-on-pr.yml b/.github/workflows/checks-on-pr.yml index 43a0dfd5f..be573b296 100644 --- a/.github/workflows/checks-on-pr.yml +++ b/.github/workflows/checks-on-pr.yml @@ -112,14 +112,31 @@ jobs: toolchain: 1.92.0 - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2 - - name: Install cargo-audit - run: cargo install cargo-audit --locked + - uses: taiki-e/install-action@a37010ded18ff788be4440302bd6830b1ae50d8b # v2 + with: + tool: cargo-audit - - name: Install cargo-deny - run: cargo install cargo-deny --locked + - uses: taiki-e/install-action@a37010ded18ff788be4440302bd6830b1ae50d8b # v2 + with: + tool: cargo-deny - name: Audit dependencies run: cargo audit - name: Check licenses and sources run: cargo deny check licenses sources + + # Composite status check — branch protection only needs to require this + # single job instead of tracking every matrix leg individually. + gate: + name: Gate + if: always() + needs: [lint, test, build, security] + runs-on: ubuntu-latest + steps: + - name: Check upstream job results + run: | + if [[ "${{ contains(needs.*.result, 'failure') || contains(needs.*.result, 'cancelled') }}" == "true" ]]; then + echo "::error::One or more upstream jobs failed or were cancelled" + exit 1 + fi diff --git a/docs/maintainers/refactor-candidates.md b/docs/maintainers/refactor-candidates.md index fba86b431..4e19321e8 100644 --- a/docs/maintainers/refactor-candidates.md +++ b/docs/maintainers/refactor-candidates.md @@ -102,6 +102,16 @@ The `python/` subtree has minimal type hints, no docstrings on key functions, an Only sets `edition = "2021"`. For a project this size, configuring `max_width`, `imports_granularity`, `group_imports` would enforce consistency as contributor count grows. +### Resolved: CI/CD security hardening (P1/P2) + +~~Third-party actions pinned to mutable tags; release workflows granted overly broad write permissions; no composite gate job for branch protection; security tools compiled from source on every PR.~~ + +**Fixed in** `cicd-best-practices` **branch:** +- All third-party actions SHA-pinned (P1) +- Release workflow permissions scoped per-job (P1) +- Composite `Gate` job added to PR checks (P2) +- Security tools installed via pre-built binaries (P2) + ## Priority Recommendations 1. **Replace unwraps/panics in non-test code** with proper error propagation — highest stability impact. From 7ef9d8a7b592d5d130d372ca2b209e32b442b0c4 Mon Sep 17 00:00:00 2001 From: Simian Astronaut 7 Date: Tue, 10 Mar 2026 01:48:19 -0400 Subject: [PATCH 29/35] Addressed clippy lint issues --- src/agent/loop_.rs | 20 ++++---- src/channels/discord.rs | 9 +++- src/channels/mod.rs | 10 ++-- src/channels/nextcloud_talk.rs | 2 +- src/channels/telegram.rs | 45 +++++++++--------- src/channels/wati.rs | 16 +++---- src/config/mod.rs | 2 +- src/config/schema.rs | 66 ++++++++++---------------- src/gateway/ws.rs | 3 +- src/hardware/mod.rs | 2 +- src/main.rs | 3 +- src/memory/hygiene.rs | 9 +++- src/observability/runtime_trace.rs | 1 - src/onboard/wizard.rs | 4 +- src/peripherals/mod.rs | 1 + src/providers/bedrock.rs | 1 - src/providers/openai_codex.rs | 1 - src/security/leak_detector.rs | 10 ++-- src/skills/audit.rs | 12 ++--- src/skills/mod.rs | 2 +- src/tools/screenshot.rs | 6 ++- src/tools/shell.rs | 12 ++++- tests/config_persistence.rs | 18 ++++--- tests/config_schema.rs | 12 +++-- tests/gemini_fallback_oauth_refresh.rs | 1 + tests/openai_codex_vision_e2e.rs | 2 +- tests/provider_schema.rs | 4 +- 27 files changed, 140 insertions(+), 134 deletions(-) diff --git a/src/agent/loop_.rs b/src/agent/loop_.rs index 3d0a8b051..bdf5eb971 100644 --- a/src/agent/loop_.rs +++ b/src/agent/loop_.rs @@ -387,7 +387,7 @@ fn parse_tool_call_value(value: &serde_json::Value) -> Option { return Some(ParsedToolCall { name, arguments, - tool_call_id: tool_call_id, + tool_call_id, }); } } @@ -409,7 +409,7 @@ fn parse_tool_call_value(value: &serde_json::Value) -> Option { Some(ParsedToolCall { name, arguments, - tool_call_id: tool_call_id, + tool_call_id, }) } @@ -2625,15 +2625,13 @@ pub(crate) async fn run_tool_call_loop( ordered_results[*idx] = Some((call.name.clone(), call.tool_call_id.clone(), outcome)); } - for entry in ordered_results { - if let Some((tool_name, tool_call_id, outcome)) = entry { - individual_results.push((tool_call_id, outcome.output.clone())); - let _ = writeln!( - tool_results, - "\n{}\n", - tool_name, outcome.output - ); - } + for (tool_name, tool_call_id, outcome) in ordered_results.into_iter().flatten() { + individual_results.push((tool_call_id, outcome.output.clone())); + let _ = writeln!( + tool_results, + "\n{}\n", + tool_name, outcome.output + ); } // Add assistant message with tool calls + tool results to history. diff --git a/src/channels/discord.rs b/src/channels/discord.rs index 297366e24..71a6a1b7d 100644 --- a/src/channels/discord.rs +++ b/src/channels/discord.rs @@ -5,6 +5,7 @@ use parking_lot::Mutex; use reqwest::multipart::{Form, Part}; use serde_json::json; use std::collections::HashMap; +use std::fmt::Write as _; use std::path::{Path, PathBuf}; use tokio_tungstenite::tungstenite::Message; use uuid::Uuid; @@ -370,6 +371,7 @@ fn pick_uniform_index(len: usize) -> usize { loop { let value = rand::random::(); if value < reject_threshold { + #[allow(clippy::cast_possible_truncation)] return (value % upper) as usize; } } @@ -391,7 +393,7 @@ fn encode_emoji_for_discord(emoji: &str) -> String { let mut encoded = String::new(); for byte in emoji.as_bytes() { - encoded.push_str(&format!("%{byte:02X}")); + let _ = write!(encoded, "%{byte:02X}"); } encoded } @@ -1368,7 +1370,10 @@ mod tests { #[test] fn split_message_many_short_lines() { // Many short lines should be batched into chunks under the limit - let msg: String = (0..500).map(|i| format!("line {i}\n")).collect(); + let msg: String = (0..500).fold(String::new(), |mut acc, i| { + let _ = writeln!(acc, "line {i}"); + acc + }); let parts = split_message_for_discord(&msg); for part in &parts { assert!( diff --git a/src/channels/mod.rs b/src/channels/mod.rs index 320e53e82..df405bcfd 100644 --- a/src/channels/mod.rs +++ b/src/channels/mod.rs @@ -1295,9 +1295,7 @@ fn sanitize_tool_json_value( return None; } - let Some(object) = value.as_object() else { - return None; - }; + let object = value.as_object()?; if let Some(tool_calls) = object.get("tool_calls").and_then(|value| value.as_array()) { if !tool_calls.is_empty() @@ -1337,7 +1335,7 @@ fn strip_isolated_tool_json_artifacts(message: &str, known_tool_names: &HashSet< let mut saw_tool_call_payload = false; while cursor < message.len() { - let Some(rel_start) = message[cursor..].find(|ch: char| ch == '{' || ch == '[') else { + let Some(rel_start) = message[cursor..].find(['{', '[']) else { cleaned.push_str(&message[cursor..]); break; }; @@ -2682,7 +2680,7 @@ struct ConfiguredChannel { fn collect_configured_channels( config: &Config, - _matrix_skip_context: &str, + matrix_skip_context: &str, ) -> Vec { let mut channels = Vec::new(); @@ -2767,7 +2765,7 @@ fn collect_configured_channels( if config.channels_config.matrix.is_some() { tracing::warn!( "Matrix channel is configured but this build was compiled without `channel-matrix`; skipping Matrix {}.", - _matrix_skip_context + matrix_skip_context ); } diff --git a/src/channels/nextcloud_talk.rs b/src/channels/nextcloud_talk.rs index 574a5b6f1..07070ad8d 100644 --- a/src/channels/nextcloud_talk.rs +++ b/src/channels/nextcloud_talk.rs @@ -429,7 +429,7 @@ mod tests { "message": { "actorType": "users", "actorId": "user_a", - "timestamp": 1735701200123u64, + "timestamp": 1_735_701_200_123_u64, "message": "hello" } }); diff --git a/src/channels/telegram.rs b/src/channels/telegram.rs index b3cf7771a..b1dca1988 100644 --- a/src/channels/telegram.rs +++ b/src/channels/telegram.rs @@ -6,6 +6,7 @@ use async_trait::async_trait; use directories::UserDirs; use parking_lot::Mutex; use reqwest::multipart::{Form, Part}; +use std::fmt::Write as _; use std::path::Path; use std::sync::{Arc, RwLock}; use std::time::Duration; @@ -100,6 +101,7 @@ fn pick_uniform_index(len: usize) -> usize { loop { let value = rand::random::(); if value < reject_threshold { + #[allow(clippy::cast_possible_truncation)] return (value % upper) as usize; } } @@ -1248,7 +1250,7 @@ Allowlist Telegram username (without '@') or numeric user ID.", if self.mention_only && is_group { let bot_username = self.bot_username.lock(); if let Some(ref bot_username) = *bot_username { - if !Self::contains_bot_mention(&text, bot_username) { + if !Self::contains_bot_mention(text, bot_username) { return None; } } else { @@ -1283,7 +1285,7 @@ Allowlist Telegram username (without '@') or numeric user ID.", let content = if self.mention_only && is_group { let bot_username = self.bot_username.lock(); let bot_username = bot_username.as_ref()?; - Self::normalize_incoming_content(&text, bot_username)? + Self::normalize_incoming_content(text, bot_username)? } else { text.to_string() }; @@ -1391,7 +1393,7 @@ Allowlist Telegram username (without '@') or numeric user ID.", if i + 1 < len && bytes[i] == b'*' && bytes[i + 1] == b'*' { if let Some(end) = line[i + 2..].find("**") { let inner = Self::escape_html(&line[i + 2..i + 2 + end]); - line_out.push_str(&format!("{inner}")); + let _ = write!(line_out, "{inner}"); i += 4 + end; continue; } @@ -1399,7 +1401,7 @@ Allowlist Telegram username (without '@') or numeric user ID.", if i + 1 < len && bytes[i] == b'_' && bytes[i + 1] == b'_' { if let Some(end) = line[i + 2..].find("__") { let inner = Self::escape_html(&line[i + 2..i + 2 + end]); - line_out.push_str(&format!("{inner}")); + let _ = write!(line_out, "{inner}"); i += 4 + end; continue; } @@ -1409,7 +1411,7 @@ Allowlist Telegram username (without '@') or numeric user ID.", if let Some(end) = line[i + 1..].find('*') { if end > 0 { let inner = Self::escape_html(&line[i + 1..i + 1 + end]); - line_out.push_str(&format!("{inner}")); + let _ = write!(line_out, "{inner}"); i += 2 + end; continue; } @@ -1419,7 +1421,7 @@ Allowlist Telegram username (without '@') or numeric user ID.", if bytes[i] == b'`' && (i == 0 || bytes[i - 1] != b'`') { if let Some(end) = line[i + 1..].find('`') { let inner = Self::escape_html(&line[i + 1..i + 1 + end]); - line_out.push_str(&format!("{inner}")); + let _ = write!(line_out, "{inner}"); i += 2 + end; continue; } @@ -1435,9 +1437,8 @@ Allowlist Telegram username (without '@') or numeric user ID.", if url.starts_with("http://") || url.starts_with("https://") { let text_html = Self::escape_html(text_part); let url_html = Self::escape_html(url); - line_out.push_str(&format!( - "{text_html}" - )); + let _ = + write!(line_out, "{text_html}"); i = after_bracket + 1 + paren_end + 1; continue; } @@ -1449,7 +1450,7 @@ Allowlist Telegram username (without '@') or numeric user ID.", if i + 1 < len && bytes[i] == b'~' && bytes[i + 1] == b'~' { if let Some(end) = line[i + 2..].find("~~") { let inner = Self::escape_html(&line[i + 2..i + 2 + end]); - line_out.push_str(&format!("{inner}")); + let _ = write!(line_out, "{inner}"); i += 4 + end; continue; } @@ -1478,14 +1479,14 @@ Allowlist Telegram username (without '@') or numeric user ID.", for line in joined.split('\n') { let trimmed = line.trim(); if trimmed.starts_with("```") { - if !in_code_block { - in_code_block = true; - code_buf.clear(); - } else { + if in_code_block { in_code_block = false; let escaped = code_buf.trim_end_matches('\n'); // Telegram HTML parse mode supports 
 and , but not class attributes.
-                    final_out.push_str(&format!("
{escaped}
\n"));
+                    let _ = writeln!(final_out, "
{escaped}
");
+                    code_buf.clear();
+                } else {
+                    in_code_block = true;
                     code_buf.clear();
                 }
             } else if in_code_block {
@@ -1497,10 +1498,7 @@ Allowlist Telegram username (without '@') or numeric user ID.",
             }
         }
         if in_code_block && !code_buf.is_empty() {
-            final_out.push_str(&format!(
-                "
{}
\n",
-                code_buf.trim_end()
-            ));
+            let _ = writeln!(final_out, "
{}
", code_buf.trim_end());
         }
 
         final_out.trim_end_matches('\n').to_string()
@@ -2731,7 +2729,7 @@ mod tests {
             "update_id": 1,
             "message": {
                 "message_id": 99,
-                "chat": { "id": -100123456 }
+                "chat": { "id": -100_123_456 }
             }
         });
 
@@ -3824,7 +3822,10 @@ mod tests {
 
     #[test]
     fn telegram_split_many_short_lines() {
-        let msg: String = (0..1000).map(|i| format!("line {i}\n")).collect();
+        let msg: String = (0..1000).fold(String::new(), |mut acc, i| {
+            let _ = writeln!(acc, "line {i}");
+            acc
+        });
         let parts = split_message_for_telegram(&msg);
         for part in &parts {
             assert!(
@@ -4130,7 +4131,7 @@ mod tests {
     /// Skipped automatically when `GROQ_API_KEY` is not set.
     /// Run: `GROQ_API_KEY= cargo test --lib -- telegram::tests::e2e_live_voice_transcription_and_reply_cache --ignored`
     #[tokio::test]
-    #[ignore]
+    #[ignore = "requires GROQ_API_KEY environment variable"]
     async fn e2e_live_voice_transcription_and_reply_cache() {
         if std::env::var("GROQ_API_KEY").is_err() {
             eprintln!("GROQ_API_KEY not set — skipping live voice transcription test");
diff --git a/src/channels/wati.rs b/src/channels/wati.rs
index 6e3037027..78903bc6b 100644
--- a/src/channels/wati.rs
+++ b/src/channels/wati.rs
@@ -335,7 +335,7 @@ mod tests {
             "text": "Hello from WATI!",
             "waId": "1234567890",
             "fromMe": false,
-            "timestamp": 1705320000u64
+            "timestamp": 1_705_320_000_u64
         });
 
         let msgs = ch.parse_webhook_payload(&payload);
@@ -344,7 +344,7 @@ mod tests {
         assert_eq!(msgs[0].content, "Hello from WATI!");
         assert_eq!(msgs[0].channel, "wati");
         assert_eq!(msgs[0].reply_target, "+1234567890");
-        assert_eq!(msgs[0].timestamp, 1705320000);
+        assert_eq!(msgs[0].timestamp, 1_705_320_000);
     }
 
     #[test]
@@ -381,7 +381,7 @@ mod tests {
             "message": { "body": "Alt field test" },
             "wa_id": "1234567890",
             "from_me": false,
-            "timestamp": 1705320000u64
+            "timestamp": 1_705_320_000_u64
         });
 
         let msgs = ch.parse_webhook_payload(&payload);
@@ -396,11 +396,11 @@ mod tests {
         let payload = serde_json::json!({
             "text": "Test",
             "waId": "1234567890",
-            "timestamp": 1705320000u64
+            "timestamp": 1_705_320_000_u64
         });
 
         let msgs = ch.parse_webhook_payload(&payload);
-        assert_eq!(msgs[0].timestamp, 1705320000);
+        assert_eq!(msgs[0].timestamp, 1_705_320_000);
     }
 
     #[test]
@@ -409,11 +409,11 @@ mod tests {
         let payload = serde_json::json!({
             "text": "Test",
             "waId": "1234567890",
-            "timestamp": 1705320000000u64
+            "timestamp": 1_705_320_000_000_u64
         });
 
         let msgs = ch.parse_webhook_payload(&payload);
-        assert_eq!(msgs[0].timestamp, 1705320000);
+        assert_eq!(msgs[0].timestamp, 1_705_320_000);
     }
 
     #[test]
@@ -426,7 +426,7 @@ mod tests {
         });
 
         let msgs = ch.parse_webhook_payload(&payload);
-        assert_eq!(msgs[0].timestamp, 1736942400);
+        assert_eq!(msgs[0].timestamp, 1_736_942_400);
     }
 
     #[test]
diff --git a/src/config/mod.rs b/src/config/mod.rs
index 9fe1b25c6..0b1564913 100644
--- a/src/config/mod.rs
+++ b/src/config/mod.rs
@@ -19,7 +19,7 @@ pub use schema::{
     WebFetchConfig, WebSearchConfig, WebhookConfig,
 };
 
-pub fn name_and_presence(channel: &Option) -> (&'static str, bool) {
+pub fn name_and_presence(channel: Option<&T>) -> (&'static str, bool) {
     (T::name(), channel.is_some())
 }
 
diff --git a/src/config/schema.rs b/src/config/schema.rs
index 1b8d6e70e..8f3670e4e 100644
--- a/src/config/schema.rs
+++ b/src/config/schema.rs
@@ -457,7 +457,7 @@ fn parse_skills_prompt_injection_mode(raw: &str) -> Option Self {
-        Self {
-            open_skills_enabled: false,
-            open_skills_dir: None,
-            prompt_injection_mode: SkillsPromptInjectionMode::default(),
-        }
-    }
-}
-
 /// Multimodal (image) handling configuration (`[multimodal]` section).
 #[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
 pub struct MultimodalConfig {
@@ -1940,20 +1930,12 @@ impl Default for HooksConfig {
     }
 }
 
-#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema)]
+#[derive(Debug, Clone, Serialize, Deserialize, JsonSchema, Default)]
 pub struct BuiltinHooksConfig {
     /// Enable the command-logger hook (logs tool calls for auditing).
     pub command_logger: bool,
 }
 
-impl Default for BuiltinHooksConfig {
-    fn default() -> Self {
-        Self {
-            command_logger: false,
-        }
-    }
-}
-
 // ── Autonomy / Security ──────────────────────────────────────────
 
 /// Autonomy and security policy configuration (`[autonomy]` section).
@@ -2528,7 +2510,7 @@ pub struct CustomTunnelConfig {
 struct ConfigWrapper(std::marker::PhantomData);
 
 impl ConfigWrapper {
-    fn new(_: &Option) -> Self {
+    fn new(_: Option<&T>) -> Self {
         Self(std::marker::PhantomData)
     }
 }
@@ -2604,79 +2586,79 @@ impl ChannelsConfig {
     pub fn channels_except_webhook(&self) -> Vec<(Box, bool)> {
         vec![
             (
-                Box::new(ConfigWrapper::new(&self.telegram)),
+                Box::new(ConfigWrapper::new(self.telegram.as_ref())),
                 self.telegram.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.discord)),
+                Box::new(ConfigWrapper::new(self.discord.as_ref())),
                 self.discord.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.slack)),
+                Box::new(ConfigWrapper::new(self.slack.as_ref())),
                 self.slack.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.mattermost)),
+                Box::new(ConfigWrapper::new(self.mattermost.as_ref())),
                 self.mattermost.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.imessage)),
+                Box::new(ConfigWrapper::new(self.imessage.as_ref())),
                 self.imessage.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.matrix)),
+                Box::new(ConfigWrapper::new(self.matrix.as_ref())),
                 self.matrix.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.signal)),
+                Box::new(ConfigWrapper::new(self.signal.as_ref())),
                 self.signal.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.whatsapp)),
+                Box::new(ConfigWrapper::new(self.whatsapp.as_ref())),
                 self.whatsapp.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.linq)),
+                Box::new(ConfigWrapper::new(self.linq.as_ref())),
                 self.linq.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.wati)),
+                Box::new(ConfigWrapper::new(self.wati.as_ref())),
                 self.wati.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.nextcloud_talk)),
+                Box::new(ConfigWrapper::new(self.nextcloud_talk.as_ref())),
                 self.nextcloud_talk.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.email)),
+                Box::new(ConfigWrapper::new(self.email.as_ref())),
                 self.email.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.irc)),
+                Box::new(ConfigWrapper::new(self.irc.as_ref())),
                 self.irc.is_some()
             ),
             (
-                Box::new(ConfigWrapper::new(&self.lark)),
+                Box::new(ConfigWrapper::new(self.lark.as_ref())),
                 self.lark.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.feishu)),
+                Box::new(ConfigWrapper::new(self.feishu.as_ref())),
                 self.feishu.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.dingtalk)),
+                Box::new(ConfigWrapper::new(self.dingtalk.as_ref())),
                 self.dingtalk.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.qq)),
+                Box::new(ConfigWrapper::new(self.qq.as_ref())),
                 self.qq.is_some()
             ),
             (
-                Box::new(ConfigWrapper::new(&self.nostr)),
+                Box::new(ConfigWrapper::new(self.nostr.as_ref())),
                 self.nostr.is_some(),
             ),
             (
-                Box::new(ConfigWrapper::new(&self.clawdtalk)),
+                Box::new(ConfigWrapper::new(self.clawdtalk.as_ref())),
                 self.clawdtalk.is_some(),
             ),
         ]
@@ -2685,7 +2667,7 @@ impl ChannelsConfig {
     pub fn channels(&self) -> Vec<(Box, bool)> {
         let mut ret = self.channels_except_webhook();
         ret.push((
-            Box::new(ConfigWrapper::new(&self.webhook)),
+            Box::new(ConfigWrapper::new(self.webhook.as_ref())),
             self.webhook.is_some(),
         ));
         ret
@@ -4823,7 +4805,7 @@ async fn sync_directory(path: &Path) -> Result<()> {
         dir.sync_all()
             .await
             .with_context(|| format!("Failed to fsync directory metadata: {}", path.display()))?;
-        return Ok(());
+        Ok(())
     }
 
     #[cfg(not(unix))]
diff --git a/src/gateway/ws.rs b/src/gateway/ws.rs
index 5abd49ca1..83a129313 100644
--- a/src/gateway/ws.rs
+++ b/src/gateway/ws.rs
@@ -53,8 +53,7 @@ async fn handle_socket(socket: WebSocket, state: AppState) {
     while let Some(msg) = receiver.next().await {
         let msg = match msg {
             Ok(Message::Text(text)) => text,
-            Ok(Message::Close(_)) => break,
-            Err(_) => break,
+            Ok(Message::Close(_)) | Err(_) => break,
             _ => continue,
         };
 
diff --git a/src/hardware/mod.rs b/src/hardware/mod.rs
index 67407a734..a1fa82314 100644
--- a/src/hardware/mod.rs
+++ b/src/hardware/mod.rs
@@ -109,7 +109,7 @@ pub fn handle_command(cmd: crate::HardwareCommands, _config: &Config) -> Result<
         let _ = &cmd;
         println!("Hardware discovery requires the 'hardware' feature.");
         println!("Build with: cargo build --features hardware");
-        return Ok(());
+        Ok(())
     }
 
     #[cfg(all(
diff --git a/src/main.rs b/src/main.rs
index ddf5dd089..23c705a9a 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -766,8 +766,7 @@ async fn main() -> Result<()> {
     }
 
     match cli.command {
-        Commands::Onboard { .. } => unreachable!(),
-        Commands::Completions { .. } => unreachable!(),
+        Commands::Onboard { .. } | Commands::Completions { .. } => unreachable!(),
 
         Commands::Agent {
             message,
diff --git a/src/memory/hygiene.rs b/src/memory/hygiene.rs
index 01054cecb..4e33db8f2 100644
--- a/src/memory/hygiene.rs
+++ b/src/memory/hygiene.rs
@@ -328,7 +328,14 @@ fn date_prefix(filename: &str) -> Option {
     if filename.len() < 10 {
         return None;
     }
-    NaiveDate::parse_from_str(&filename[..filename.floor_char_boundary(10)], "%Y-%m-%d").ok()
+    let boundary = {
+        let mut i = 10.min(filename.len());
+        while i > 0 && !filename.is_char_boundary(i) {
+            i -= 1;
+        }
+        i
+    };
+    NaiveDate::parse_from_str(&filename[..boundary], "%Y-%m-%d").ok()
 }
 
 fn is_older_than(path: &Path, cutoff: SystemTime) -> bool {
diff --git a/src/observability/runtime_trace.rs b/src/observability/runtime_trace.rs
index 0bcdd55bf..e3ca98146 100644
--- a/src/observability/runtime_trace.rs
+++ b/src/observability/runtime_trace.rs
@@ -22,7 +22,6 @@ pub enum RuntimeTraceStorageMode {
 impl RuntimeTraceStorageMode {
     fn from_raw(raw: &str) -> Self {
         match raw.trim().to_ascii_lowercase().as_str() {
-            "none" => Self::None,
             "rolling" => Self::Rolling,
             "full" => Self::Full,
             _ => Self::None,
diff --git a/src/onboard/wizard.rs b/src/onboard/wizard.rs
index 69a882550..f11d21587 100644
--- a/src/onboard/wizard.rs
+++ b/src/onboard/wizard.rs
@@ -2004,7 +2004,7 @@ fn resolve_interactive_onboarding_mode(
             "  Existing config found at {}. Select setup mode",
             config_path.display()
         ))
-        .items(&options)
+        .items(options)
         .default(1)
         .interact()?;
 
@@ -5814,7 +5814,7 @@ mod tests {
         apply_provider_update(
             &mut config,
             "anthropic".to_string(),
-            "".to_string(),
+            String::new(),
             "claude-sonnet-4-5-20250929".to_string(),
             None,
         );
diff --git a/src/peripherals/mod.rs b/src/peripherals/mod.rs
index 367226b48..46f9055d3 100644
--- a/src/peripherals/mod.rs
+++ b/src/peripherals/mod.rs
@@ -229,6 +229,7 @@ pub async fn create_peripheral_tools(config: &PeripheralsConfig) -> Result Result>> {
     Ok(Vec::new())
 }
diff --git a/src/providers/bedrock.rs b/src/providers/bedrock.rs
index 72e51e34a..ad353d3cd 100644
--- a/src/providers/bedrock.rs
+++ b/src/providers/bedrock.rs
@@ -697,7 +697,6 @@ impl BedrockProvider {
                         let after_semi = &rest[semi + 1..];
                         if let Some(b64) = after_semi.strip_prefix("base64,") {
                             let format = match mime {
-                                "image/jpeg" | "image/jpg" => "jpeg",
                                 "image/png" => "png",
                                 "image/gif" => "gif",
                                 "image/webp" => "webp",
diff --git a/src/providers/openai_codex.rs b/src/providers/openai_codex.rs
index b5227fecd..235529188 100644
--- a/src/providers/openai_codex.rs
+++ b/src/providers/openai_codex.rs
@@ -281,7 +281,6 @@ fn clamp_reasoning_effort(model: &str, effort: &str) -> String {
         return match effort {
             "low" | "medium" | "high" => effort.to_string(),
             "minimal" => "low".to_string(),
-            "xhigh" => "high".to_string(),
             _ => "high".to_string(),
         };
     }
diff --git a/src/security/leak_detector.rs b/src/security/leak_detector.rs
index 6849630d3..fba74bbb7 100644
--- a/src/security/leak_detector.rs
+++ b/src/security/leak_detector.rs
@@ -311,7 +311,7 @@ mod tests {
                 assert!(patterns.iter().any(|p| p.contains("Stripe")));
                 assert!(redacted.contains("[REDACTED"));
             }
-            _ => panic!("Should detect Stripe key"),
+            LeakResult::Clean => panic!("Should detect Stripe key"),
         }
     }
 
@@ -324,7 +324,7 @@ mod tests {
             LeakResult::Detected { patterns, .. } => {
                 assert!(patterns.iter().any(|p| p.contains("AWS")));
             }
-            _ => panic!("Should detect AWS key"),
+            LeakResult::Clean => panic!("Should detect AWS key"),
         }
     }
 
@@ -342,7 +342,7 @@ MIIEowIBAAKCAQEA0ZPr5JeyVDonXsKhfq...
                 assert!(patterns.iter().any(|p| p.contains("private key")));
                 assert!(redacted.contains("[REDACTED_PRIVATE_KEY]"));
             }
-            _ => panic!("Should detect private key"),
+            LeakResult::Clean => panic!("Should detect private key"),
         }
     }
 
@@ -356,7 +356,7 @@ MIIEowIBAAKCAQEA0ZPr5JeyVDonXsKhfq...
                 assert!(patterns.iter().any(|p| p.contains("JWT")));
                 assert!(redacted.contains("[REDACTED_JWT]"));
             }
-            _ => panic!("Should detect JWT"),
+            LeakResult::Clean => panic!("Should detect JWT"),
         }
     }
 
@@ -369,7 +369,7 @@ MIIEowIBAAKCAQEA0ZPr5JeyVDonXsKhfq...
             LeakResult::Detected { patterns, .. } => {
                 assert!(patterns.iter().any(|p| p.contains("PostgreSQL")));
             }
-            _ => panic!("Should detect database URL"),
+            LeakResult::Clean => panic!("Should detect database URL"),
         }
     }
 
diff --git a/src/skills/audit.rs b/src/skills/audit.rs
index 45b10a646..e8883e571 100644
--- a/src/skills/audit.rs
+++ b/src/skills/audit.rs
@@ -200,12 +200,12 @@ fn audit_manifest_file(root: &Path, path: &Path, report: &mut SkillAuditReport)
                     .push(format!("{rel}: tools[{idx}] is missing a command field."));
             }
 
-            if kind.eq_ignore_ascii_case("script") || kind.eq_ignore_ascii_case("shell") {
-                if command.is_some_and(|value| value.trim().is_empty()) {
-                    report
-                        .findings
-                        .push(format!("{rel}: tools[{idx}] has an empty {kind} command."));
-                }
+            if (kind.eq_ignore_ascii_case("script") || kind.eq_ignore_ascii_case("shell"))
+                && command.is_some_and(|value| value.trim().is_empty())
+            {
+                report
+                    .findings
+                    .push(format!("{rel}: tools[{idx}] has an empty {kind} command."));
             }
         }
     }
diff --git a/src/skills/mod.rs b/src/skills/mod.rs
index a97d520c8..9d84055fc 100644
--- a/src/skills/mod.rs
+++ b/src/skills/mod.rs
@@ -238,7 +238,7 @@ fn open_skills_enabled_from_sources(
     env_override: Option<&str>,
 ) -> bool {
     if let Some(raw) = env_override {
-        if let Some(enabled) = parse_open_skills_enabled(&raw) {
+        if let Some(enabled) = parse_open_skills_enabled(raw) {
             return enabled;
         }
         if !raw.trim().is_empty() {
diff --git a/src/tools/screenshot.rs b/src/tools/screenshot.rs
index a0152ecc7..c5b763654 100644
--- a/src/tools/screenshot.rs
+++ b/src/tools/screenshot.rs
@@ -173,7 +173,11 @@ impl ScreenshotTool {
                 let size = bytes.len();
                 let mut encoded = base64::engine::general_purpose::STANDARD.encode(&bytes);
                 let truncated = if encoded.len() > MAX_BASE64_BYTES {
-                    encoded.truncate(encoded.floor_char_boundary(MAX_BASE64_BYTES));
+                    let mut boundary = MAX_BASE64_BYTES.min(encoded.len());
+                    while boundary > 0 && !encoded.is_char_boundary(boundary) {
+                        boundary -= 1;
+                    }
+                    encoded.truncate(boundary);
                     true
                 } else {
                     false
diff --git a/src/tools/shell.rs b/src/tools/shell.rs
index bbbb75065..b6244a94d 100644
--- a/src/tools/shell.rs
+++ b/src/tools/shell.rs
@@ -164,11 +164,19 @@ impl Tool for ShellTool {
 
                 // Truncate output to prevent OOM
                 if stdout.len() > MAX_OUTPUT_BYTES {
-                    stdout.truncate(stdout.floor_char_boundary(MAX_OUTPUT_BYTES));
+                    let mut b = MAX_OUTPUT_BYTES.min(stdout.len());
+                    while b > 0 && !stdout.is_char_boundary(b) {
+                        b -= 1;
+                    }
+                    stdout.truncate(b);
                     stdout.push_str("\n... [output truncated at 1MB]");
                 }
                 if stderr.len() > MAX_OUTPUT_BYTES {
-                    stderr.truncate(stderr.floor_char_boundary(MAX_OUTPUT_BYTES));
+                    let mut b = MAX_OUTPUT_BYTES.min(stderr.len());
+                    while b > 0 && !stderr.is_char_boundary(b) {
+                        b -= 1;
+                    }
+                    stderr.truncate(b);
                     stderr.push_str("\n... [stderr truncated at 1MB]");
                 }
 
diff --git a/tests/config_persistence.rs b/tests/config_persistence.rs
index 079b9dfc6..44545b75c 100644
--- a/tests/config_persistence.rs
+++ b/tests/config_persistence.rs
@@ -119,10 +119,12 @@ fn memory_config_default_vector_keyword_weights_sum_to_one() {
 
 #[test]
 fn config_toml_roundtrip_preserves_provider() {
-    let mut config = Config::default();
-    config.default_provider = Some("deepseek".into());
-    config.default_model = Some("deepseek-chat".into());
-    config.default_temperature = 0.5;
+    let config = Config {
+        default_provider: Some("deepseek".into()),
+        default_model: Some("deepseek-chat".into()),
+        default_temperature: 0.5,
+        ..Default::default()
+    };
 
     let toml_str = toml::to_string(&config).expect("config should serialize to TOML");
     let parsed: Config = toml::from_str(&toml_str).expect("TOML should deserialize back");
@@ -173,9 +175,11 @@ fn config_file_write_read_roundtrip() {
     let tmp = tempfile::TempDir::new().expect("tempdir creation should succeed");
     let config_path = tmp.path().join("config.toml");
 
-    let mut config = Config::default();
-    config.default_provider = Some("mistral".into());
-    config.default_model = Some("mistral-large".into());
+    let mut config = Config {
+        default_provider: Some("mistral".into()),
+        default_model: Some("mistral-large".into()),
+        ..Default::default()
+    };
     config.agent.max_tool_iterations = 15;
 
     let toml_str = toml::to_string(&config).expect("config should serialize");
diff --git a/tests/config_schema.rs b/tests/config_schema.rs
index 6627312c0..85c5e8e8a 100644
--- a/tests/config_schema.rs
+++ b/tests/config_schema.rs
@@ -99,11 +99,13 @@ fn gateway_config_idempotency_defaults() {
 
 #[test]
 fn gateway_config_toml_roundtrip() {
-    let mut gw = GatewayConfig::default();
-    gw.port = 8080;
-    gw.host = "0.0.0.0".into();
-    gw.require_pairing = false;
-    gw.pair_rate_limit_per_minute = 5;
+    let gw = GatewayConfig {
+        port: 8080,
+        host: "0.0.0.0".into(),
+        require_pairing: false,
+        pair_rate_limit_per_minute: 5,
+        ..Default::default()
+    };
 
     let toml_str = toml::to_string(&gw).expect("gateway config should serialize");
     let parsed: GatewayConfig = toml::from_str(&toml_str).expect("should deserialize back");
diff --git a/tests/gemini_fallback_oauth_refresh.rs b/tests/gemini_fallback_oauth_refresh.rs
index 612c44818..4bcd8001d 100644
--- a/tests/gemini_fallback_oauth_refresh.rs
+++ b/tests/gemini_fallback_oauth_refresh.rs
@@ -4,6 +4,7 @@
 //! 1. Primary provider (OpenAI Codex) fails
 //! 2. Fallback to Gemini is triggered
 //! 3. Gemini OAuth tokens are expired (we manually expire them)
+//!
 //! Then:
 //! - Gemini provider's warmup() automatically refreshes the tokens
 //! - The fallback request succeeds
diff --git a/tests/openai_codex_vision_e2e.rs b/tests/openai_codex_vision_e2e.rs
index be456911a..9f2e85dbe 100644
--- a/tests/openai_codex_vision_e2e.rs
+++ b/tests/openai_codex_vision_e2e.rs
@@ -12,7 +12,7 @@
 //! Run manually: `cargo test provider_vision -- --ignored --nocapture`
 
 use anyhow::Result;
-use zeroclaw::providers::{ChatMessage, ChatRequest, Provider, ProviderRuntimeOptions};
+use zeroclaw::providers::{ChatMessage, ChatRequest, ProviderRuntimeOptions};
 
 /// Tests that provider supports vision input.
 ///
diff --git a/tests/provider_schema.rs b/tests/provider_schema.rs
index f92c5062a..adffd0d83 100644
--- a/tests/provider_schema.rs
+++ b/tests/provider_schema.rs
@@ -292,7 +292,7 @@ fn provider_construction_with_different_auth_styles() {
 
 #[test]
 fn chat_messages_maintain_role_sequence() {
-    let history = vec![
+    let history = [
         ChatMessage::system("You are helpful"),
         ChatMessage::user("What is Rust?"),
         ChatMessage::assistant("Rust is a systems programming language"),
@@ -309,7 +309,7 @@ fn chat_messages_maintain_role_sequence() {
 
 #[test]
 fn chat_messages_with_tool_calls_maintain_sequence() {
-    let history = vec![
+    let history = [
         ChatMessage::system("You are helpful"),
         ChatMessage::user("Search for Rust"),
         ChatMessage::assistant("I'll search for that"),

From 7399894cc822c2caa9c058194f1b8033630a30ec Mon Sep 17 00:00:00 2001
From: Simian Astronaut 7 
Date: Tue, 10 Mar 2026 02:03:15 -0400
Subject: [PATCH 30/35] fix(ci): add web dashboard build step to release
 workflows

RustEmbed requires web/dist/ to exist at compile time. The PR checks
workflow used a placeholder mkdir, but release workflows need real
built assets since they produce the distributed binary. Add Node.js
setup and npm ci/build before cargo build in all three release/build
workflows.

Co-Authored-By: Claude Opus 4.6 
---
 .github/workflows/cross-platform-build-manual.yml | 10 ++++++++++
 .github/workflows/release-beta-on-push.yml        | 10 ++++++++++
 .github/workflows/release-stable-manual.yml       | 10 ++++++++++
 3 files changed, 30 insertions(+)

diff --git a/.github/workflows/cross-platform-build-manual.yml b/.github/workflows/cross-platform-build-manual.yml
index 159869b3b..dcc1e0618 100644
--- a/.github/workflows/cross-platform-build-manual.yml
+++ b/.github/workflows/cross-platform-build-manual.yml
@@ -37,6 +37,16 @@ jobs:
       - uses: Swatinem/rust-cache@v2
         if: runner.os != 'Windows'
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+
+      - name: Build web dashboard
+        run: cd web && npm ci && npm run build
+
       - name: Install cross compiler
         if: matrix.cross_compiler
         run: |
diff --git a/.github/workflows/release-beta-on-push.yml b/.github/workflows/release-beta-on-push.yml
index c78b4ca9b..ff3561594 100644
--- a/.github/workflows/release-beta-on-push.yml
+++ b/.github/workflows/release-beta-on-push.yml
@@ -74,6 +74,16 @@ jobs:
       - uses: Swatinem/rust-cache@v2
         if: runner.os != 'Windows'
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+
+      - name: Build web dashboard
+        run: cd web && npm ci && npm run build
+
       - name: Install cross compiler
         if: matrix.cross_compiler
         run: |
diff --git a/.github/workflows/release-stable-manual.yml b/.github/workflows/release-stable-manual.yml
index 45c99abcf..3b40db253 100644
--- a/.github/workflows/release-stable-manual.yml
+++ b/.github/workflows/release-stable-manual.yml
@@ -92,6 +92,16 @@ jobs:
       - uses: Swatinem/rust-cache@v2
         if: runner.os != 'Windows'
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+
+      - name: Build web dashboard
+        run: cd web && npm ci && npm run build
+
       - name: Install cross compiler
         if: matrix.cross_compiler
         run: |

From f19d4951b6df8f0ece979aee23ff70aa7a765477 Mon Sep 17 00:00:00 2001
From: Simian Astronaut 7 
Date: Tue, 10 Mar 2026 02:09:30 -0400
Subject: [PATCH 31/35] refactor(ci): extract web build into shared job to
 avoid 4x redundancy

Instead of each build matrix job independently installing Node.js and
running npm ci/build, extract web dashboard build into a single job
that uploads web/dist/ as an artifact. Build jobs download it before
cargo build. Reduces total CI time by ~3 Node installs + builds.

Co-Authored-By: Claude Opus 4.6 
---
 .../workflows/cross-platform-build-manual.yml | 31 +++++++++++++-----
 .github/workflows/release-beta-on-push.yml    | 32 +++++++++++++------
 .github/workflows/release-stable-manual.yml   | 32 +++++++++++++------
 3 files changed, 69 insertions(+), 26 deletions(-)

diff --git a/.github/workflows/cross-platform-build-manual.yml b/.github/workflows/cross-platform-build-manual.yml
index dcc1e0618..8ed1ce31c 100644
--- a/.github/workflows/cross-platform-build-manual.yml
+++ b/.github/workflows/cross-platform-build-manual.yml
@@ -11,8 +11,28 @@ env:
   CARGO_INCREMENTAL: 0
 
 jobs:
+  web:
+    name: Build Web Dashboard
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+      - name: Build web dashboard
+        run: cd web && npm ci && npm run build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: web-dist
+          path: web/dist/
+          retention-days: 1
+
   build:
     name: Build ${{ matrix.target }}
+    needs: [web]
     runs-on: ${{ matrix.os }}
     timeout-minutes: 40
     strategy:
@@ -37,15 +57,10 @@ jobs:
       - uses: Swatinem/rust-cache@v2
         if: runner.os != 'Windows'
 
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
+      - uses: actions/download-artifact@v4
         with:
-          node-version: 22
-          cache: npm
-          cache-dependency-path: web/package-lock.json
-
-      - name: Build web dashboard
-        run: cd web && npm ci && npm run build
+          name: web-dist
+          path: web/dist/
 
       - name: Install cross compiler
         if: matrix.cross_compiler
diff --git a/.github/workflows/release-beta-on-push.yml b/.github/workflows/release-beta-on-push.yml
index ff3561594..4fd18dce1 100644
--- a/.github/workflows/release-beta-on-push.yml
+++ b/.github/workflows/release-beta-on-push.yml
@@ -37,9 +37,28 @@ jobs:
           echo "tag=${beta_tag}" >> "$GITHUB_OUTPUT"
           echo "Beta release: ${beta_tag}"
 
+  web:
+    name: Build Web Dashboard
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+      - name: Build web dashboard
+        run: cd web && npm ci && npm run build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: web-dist
+          path: web/dist/
+          retention-days: 1
+
   build:
     name: Build ${{ matrix.target }}
-    needs: [version]
+    needs: [version, web]
     runs-on: ${{ matrix.os }}
     timeout-minutes: 40
     strategy:
@@ -74,15 +93,10 @@ jobs:
       - uses: Swatinem/rust-cache@v2
         if: runner.os != 'Windows'
 
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
+      - uses: actions/download-artifact@v4
         with:
-          node-version: 22
-          cache: npm
-          cache-dependency-path: web/package-lock.json
-
-      - name: Build web dashboard
-        run: cd web && npm ci && npm run build
+          name: web-dist
+          path: web/dist/
 
       - name: Install cross compiler
         if: matrix.cross_compiler
diff --git a/.github/workflows/release-stable-manual.yml b/.github/workflows/release-stable-manual.yml
index 3b40db253..a54fb2f7b 100644
--- a/.github/workflows/release-stable-manual.yml
+++ b/.github/workflows/release-stable-manual.yml
@@ -55,9 +55,28 @@ jobs:
 
           echo "tag=${tag}" >> "$GITHUB_OUTPUT"
 
+  web:
+    name: Build Web Dashboard
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+      - name: Build web dashboard
+        run: cd web && npm ci && npm run build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: web-dist
+          path: web/dist/
+          retention-days: 1
+
   build:
     name: Build ${{ matrix.target }}
-    needs: [validate]
+    needs: [validate, web]
     runs-on: ${{ matrix.os }}
     timeout-minutes: 40
     strategy:
@@ -92,15 +111,10 @@ jobs:
       - uses: Swatinem/rust-cache@v2
         if: runner.os != 'Windows'
 
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
+      - uses: actions/download-artifact@v4
         with:
-          node-version: 22
-          cache: npm
-          cache-dependency-path: web/package-lock.json
-
-      - name: Build web dashboard
-        run: cd web && npm ci && npm run build
+          name: web-dist
+          path: web/dist/
 
       - name: Install cross compiler
         if: matrix.cross_compiler

From 863d731b929dcfdc95b001343c5fc5022c72f3d5 Mon Sep 17 00:00:00 2001
From: Simian Astronaut 7 
Date: Tue, 10 Mar 2026 02:16:37 -0400
Subject: [PATCH 32/35] fix(docs): address CodeRabbit review feedback on
 localized READMEs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- README.ar.md: translate hero performance callout from English to Arabic
- README.nl.md: fix "Implantatie" → "Imitatie" in anti-impersonation heading
- README.tr.md: fix ambiguous security wording for native runtime sandbox
- README.uk.md: update "проект" → "проєкт" (modern Ukrainian orthography)
- README.fr/vi/ja/ru/zh-CN.md: update 6-language selector to full 31-language
  selector matching README.md for navigation parity
- README.de.md: add note clarifying docs links route to English sources
- README.el.md: add note marking this as a condensed translation with pointer
  to full English README

Addresses review comments from PR #3087.

Co-Authored-By: Claude Opus 4.6 
---
 README.ar.md    |  2 +-
 README.de.md    |  4 ++++
 README.el.md    |  2 ++
 README.fr.md    | 33 ++++++++++++++++++++++++++++++++-
 README.ja.md    | 33 ++++++++++++++++++++++++++++++++-
 README.nl.md    |  2 +-
 README.ru.md    | 33 ++++++++++++++++++++++++++++++++-
 README.tr.md    |  2 +-
 README.uk.md    |  2 +-
 README.vi.md    | 33 ++++++++++++++++++++++++++++++++-
 README.zh-CN.md | 33 ++++++++++++++++++++++++++++++++-
 11 files changed, 170 insertions(+), 9 deletions(-)

diff --git a/README.ar.md b/README.ar.md
index 21834e9e1..279c26b7d 100644
--- a/README.ar.md
+++ b/README.ar.md
@@ -6,7 +6,7 @@
 
 

   صفر عبء. صفر تنازلات. 100% Rust. 100% محايد.

-  ⚡️ Runs on $10 hardware with <5MB RAM: That's 99% less memory than OpenClaw and 98% cheaper than a Mac mini!
+  ⚡️ يعمل على أجهزة بقيمة $10 بأقل من 5MB RAM: ذاكرة أقل بنسبة 99% من OpenClaw وأرخص بنسبة 98% من Mac mini!
 

 
 

diff --git a/README.de.md b/README.de.md
index 3ef05794a..3c4882fa5 100644
--- a/README.de.md
+++ b/README.de.md
@@ -65,6 +65,10 @@ Erstellt von Studenten und Mitgliedern der Harvard, MIT und Sundai.Club Gemeinsc
   Dokumentations-Inhaltsverzeichnis
 

 
+

+  📝 Hinweis: Die Dokumentationslinks verweisen auf die englischsprachige Dokumentation. Lokalisierte Dokumentation für Deutsch ist noch nicht verfügbar.
+

+
 

   Schnellzugriffe:
   Referenz ·
diff --git a/README.el.md b/README.el.md
index a6ea36964..6d7850df2 100644
--- a/README.el.md
+++ b/README.el.md
@@ -57,6 +57,8 @@
 
 ---
 
+> **📝 Σημείωση:** Αυτό είναι ένα συνοπτικό README στα ελληνικά. Για πλήρη τεκμηρίωση, ανατρέξτε στο [αγγλικό README](README.md). Οι σύνδεσμοι τεκμηρίωσης παραπέμπουν στην αγγλική τεκμηρίωση.
+
 ## Τι είναι το ZeroClaw;
 
 Το ZeroClaw είναι μια ελαφριά, μεταβλητή και επεκτάσιμη υποδομή AI βοηθού χτισμένη σε Rust. Συνδέει διάφορους παρόχους LLM (Anthropic, OpenAI, Google, Ollama, κλπ.) μέσω μιας ενοποιημένης διεπαφής και υποστηρίζει πολλαπλά κανάλια (Telegram, Matrix, CLI, κλπ.).
diff --git a/README.fr.md b/README.fr.md
index fdbc4cc45..26df579c6 100644
--- a/README.fr.md
+++ b/README.fr.md
@@ -25,7 +25,38 @@ Construit par des étudiants et membres des communautés Harvard, MIT et Sundai.
 

 
 

-  🌐 Langues : English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt
+  🌐 Langues :
+  🇺🇸 English ·
+  🇨🇳 简体中文 ·
+  🇯🇵 日本語 ·
+  🇰🇷 한국어 ·
+  🇻🇳 Tiếng Việt ·
+  🇵🇭 Tagalog ·
+  🇪🇸 Español ·
+  🇧🇷 Português ·
+  🇮🇹 Italiano ·
+  🇩🇪 Deutsch ·
+  🇫🇷 Français ·
+  🇸🇦 العربية ·
+  🇮🇳 हिन्दी ·
+  🇷🇺 Русский ·
+  🇧🇩 বাংলা ·
+  🇮🇱 עברית ·
+  🇵🇱 Polski ·
+  🇨🇿 Čeština ·
+  🇳🇱 Nederlands ·
+  🇹🇷 Türkçe ·
+  🇺🇦 Українська ·
+  🇮🇩 Bahasa Indonesia ·
+  🇹🇭 ไทย ·
+  🇵🇰 اردو ·
+  🇷🇴 Română ·
+  🇸🇪 Svenska ·
+  🇬🇷 Ελληνικά ·
+  🇭🇺 Magyar ·
+  🇫🇮 Suomi ·
+  🇩🇰 Dansk ·
+  🇳🇴 Norsk
 

 
 

diff --git a/README.ja.md b/README.ja.md
index 848ae9cb1..0519b8204 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -21,7 +21,38 @@
 

 
 

-  🌐 言語: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt
+  🌐 言語:
+  🇺🇸 English ·
+  🇨🇳 简体中文 ·
+  🇯🇵 日本語 ·
+  🇰🇷 한국어 ·
+  🇻🇳 Tiếng Việt ·
+  🇵🇭 Tagalog ·
+  🇪🇸 Español ·
+  🇧🇷 Português ·
+  🇮🇹 Italiano ·
+  🇩🇪 Deutsch ·
+  🇫🇷 Français ·
+  🇸🇦 العربية ·
+  🇮🇳 हिन्दी ·
+  🇷🇺 Русский ·
+  🇧🇩 বাংলা ·
+  🇮🇱 עברית ·
+  🇵🇱 Polski ·
+  🇨🇿 Čeština ·
+  🇳🇱 Nederlands ·
+  🇹🇷 Türkçe ·
+  🇺🇦 Українська ·
+  🇮🇩 Bahasa Indonesia ·
+  🇹🇭 ไทย ·
+  🇵🇰 اردو ·
+  🇷🇴 Română ·
+  🇸🇪 Svenska ·
+  🇬🇷 Ελληνικά ·
+  🇭🇺 Magyar ·
+  🇫🇮 Suomi ·
+  🇩🇰 Dansk ·
+  🇳🇴 Norsk
 

 
 

diff --git a/README.nl.md b/README.nl.md
index 570bf67ad..a00e68e7f 100644
--- a/README.nl.md
+++ b/README.nl.md
@@ -850,7 +850,7 @@ Een oprechte dankjewel aan de gemeenschappen en instellingen die dit open-source
 
 We bouwen in open source omdat de beste ideeën van overal komen. Als je dit leest, ben je er deel van. Welkom. 🦀❤️
 
-## ⚠️ Officiële Repository en Implantatie Waarschuwing
+## ⚠️ Officiële Repository en Waarschuwing voor Imitatie
 
 **Dit is de enige officiële ZeroClaw repository:**
 
diff --git a/README.ru.md b/README.ru.md
index cfb10393e..32defa59c 100644
--- a/README.ru.md
+++ b/README.ru.md
@@ -21,7 +21,38 @@
 

 
 

-  🌐 Языки: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt
+  🌐 Языки:
+  🇺🇸 English ·
+  🇨🇳 简体中文 ·
+  🇯🇵 日本語 ·
+  🇰🇷 한국어 ·
+  🇻🇳 Tiếng Việt ·
+  🇵🇭 Tagalog ·
+  🇪🇸 Español ·
+  🇧🇷 Português ·
+  🇮🇹 Italiano ·
+  🇩🇪 Deutsch ·
+  🇫🇷 Français ·
+  🇸🇦 العربية ·
+  🇮🇳 हिन्दी ·
+  🇷🇺 Русский ·
+  🇧🇩 বাংলা ·
+  🇮🇱 עברית ·
+  🇵🇱 Polski ·
+  🇨🇿 Čeština ·
+  🇳🇱 Nederlands ·
+  🇹🇷 Türkçe ·
+  🇺🇦 Українська ·
+  🇮🇩 Bahasa Indonesia ·
+  🇹🇭 ไทย ·
+  🇵🇰 اردو ·
+  🇷🇴 Română ·
+  🇸🇪 Svenska ·
+  🇬🇷 Ελληνικά ·
+  🇭🇺 Magyar ·
+  🇫🇮 Suomi ·
+  🇩🇰 Dansk ·
+  🇳🇴 Norsk
 

 
 

diff --git a/README.tr.md b/README.tr.md
index 67bf481bd..55cba7a79 100644
--- a/README.tr.md
+++ b/README.tr.md
@@ -647,7 +647,7 @@ zeroclaw pairing rotate  # Yeni bir sır oluşturur ve eskisini geçersiz kılar
 ### Kum Alanı
 
 - **Docker Çalışma Zamanı** — ayrı dosya sistemleri ve ağlarla tam konteyner yalıtımı
-- **Yerel Çalışma Zamanı** — kullanıcı süreci olarak çalışır. varsayılan olarak çalışma alanına kapsamlı
+- **Yerel Çalışma Zamanı** — kullanıcı süreci olarak çalışır; varsayılan olarak çalışma alanıyla sınırlıdır
 
 ### İzin Listeleri
 
diff --git a/README.uk.md b/README.uk.md
index bcc72db59..d9c3ac979 100644
--- a/README.uk.md
+++ b/README.uk.md
@@ -155,7 +155,7 @@ channels:
 
 ## Ліцензія
 
-Цей проект має подвійну ліцензію:
+Цей проєкт має подвійну ліцензію:
 
 - MIT License
 - Apache License, версія 2.0
diff --git a/README.vi.md b/README.vi.md
index b7cb33ecd..dd4d65061 100644
--- a/README.vi.md
+++ b/README.vi.md
@@ -25,7 +25,38 @@
 

 
 

-  🌐 Ngôn ngữ: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt
+  🌐 Ngôn ngữ:
+  🇺🇸 English ·
+  🇨🇳 简体中文 ·
+  🇯🇵 日本語 ·
+  🇰🇷 한국어 ·
+  🇻🇳 Tiếng Việt ·
+  🇵🇭 Tagalog ·
+  🇪🇸 Español ·
+  🇧🇷 Português ·
+  🇮🇹 Italiano ·
+  🇩🇪 Deutsch ·
+  🇫🇷 Français ·
+  🇸🇦 العربية ·
+  🇮🇳 हिन्दी ·
+  🇷🇺 Русский ·
+  🇧🇩 বাংলা ·
+  🇮🇱 עברית ·
+  🇵🇱 Polski ·
+  🇨🇿 Čeština ·
+  🇳🇱 Nederlands ·
+  🇹🇷 Türkçe ·
+  🇺🇦 Українська ·
+  🇮🇩 Bahasa Indonesia ·
+  🇹🇭 ไทย ·
+  🇵🇰 اردو ·
+  🇷🇴 Română ·
+  🇸🇪 Svenska ·
+  🇬🇷 Ελληνικά ·
+  🇭🇺 Magyar ·
+  🇫🇮 Suomi ·
+  🇩🇰 Dansk ·
+  🇳🇴 Norsk
 

 
 

diff --git a/README.zh-CN.md b/README.zh-CN.md
index 55f86ccab..20733b1fe 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -21,7 +21,38 @@
 

 
 

-  🌐 语言：English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt
+  🌐 语言：
+  🇺🇸 English ·
+  🇨🇳 简体中文 ·
+  🇯🇵 日本語 ·
+  🇰🇷 한국어 ·
+  🇻🇳 Tiếng Việt ·
+  🇵🇭 Tagalog ·
+  🇪🇸 Español ·
+  🇧🇷 Português ·
+  🇮🇹 Italiano ·
+  🇩🇪 Deutsch ·
+  🇫🇷 Français ·
+  🇸🇦 العربية ·
+  🇮🇳 हिन्दी ·
+  🇷🇺 Русский ·
+  🇧🇩 বাংলা ·
+  🇮🇱 עברית ·
+  🇵🇱 Polski ·
+  🇨🇿 Čeština ·
+  🇳🇱 Nederlands ·
+  🇹🇷 Türkçe ·
+  🇺🇦 Українська ·
+  🇮🇩 Bahasa Indonesia ·
+  🇹🇭 ไทย ·
+  🇵🇰 اردو ·
+  🇷🇴 Română ·
+  🇸🇪 Svenska ·
+  🇬🇷 Ελληνικά ·
+  🇭🇺 Magyar ·
+  🇫🇮 Suomi ·
+  🇩🇰 Dansk ·
+  🇳🇴 Norsk
 

 
 


From f73f39d33d37f5f3a9fa6b822e004a9da9a9badb Mon Sep 17 00:00:00 2001
From: Simian Astronaut 7 
Date: Tue, 10 Mar 2026 02:37:22 -0400
Subject: [PATCH 34/35] fix(ci): replace taiki-e/install-action with cargo
 install

The taiki-e/install-action is likely not on the org/repo Actions
allowlist, causing startup_failure for the entire workflow. Revert
to cargo install for cargo-audit and cargo-deny.

Co-Authored-By: Claude Opus 4.6 
---
 .github/workflows/checks-on-pr.yml | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/checks-on-pr.yml b/.github/workflows/checks-on-pr.yml
index be573b296..e1f83f52e 100644
--- a/.github/workflows/checks-on-pr.yml
+++ b/.github/workflows/checks-on-pr.yml
@@ -112,13 +112,11 @@ jobs:
           toolchain: 1.92.0
       - uses: Swatinem/rust-cache@779680da715d629ac1d338a641029a2f4372abb5 # v2
 
-      - uses: taiki-e/install-action@a37010ded18ff788be4440302bd6830b1ae50d8b # v2
-        with:
-          tool: cargo-audit
+      - name: Install cargo-audit
+        run: cargo install cargo-audit --locked
 
-      - uses: taiki-e/install-action@a37010ded18ff788be4440302bd6830b1ae50d8b # v2
-        with:
-          tool: cargo-deny
+      - name: Install cargo-deny
+        run: cargo install cargo-deny --locked
 
       - name: Audit dependencies
         run: cargo audit

From 283385624e64254700840a128c22fbc521dcb90d Mon Sep 17 00:00:00 2001
From: Simian Astronaut 7 
Date: Tue, 10 Mar 2026 02:47:07 -0400
Subject: [PATCH 35/35] chore(ci): rename gate job for clarity

Updated the name of the CI gate job from "Gate" to "CI Required Gate" to enhance clarity and better reflect its purpose in the workflow.
---
 .github/workflows/checks-on-pr.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/checks-on-pr.yml b/.github/workflows/checks-on-pr.yml
index e1f83f52e..b9ff53d77 100644
--- a/.github/workflows/checks-on-pr.yml
+++ b/.github/workflows/checks-on-pr.yml
@@ -127,7 +127,7 @@ jobs:
   # Composite status check — branch protection only needs to require this
   # single job instead of tracking every matrix leg individually.
   gate:
-    name: Gate
+    name: CI Required Gate
     if: always()
     needs: [lint, test, build, security]
     runs-on: ubuntu-latest