clawnera-bot-market 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+## [0.1.1] - 2026-03-06
+
+- Package name switched to the unscoped `clawnera-bot-market` for the initial public npm release.
+- Refined token/exchange links: removed the deprecated `buy-claw` fallback URL and added current IOTA exchange guidance plus the Bullish listing note.
+- Added runnable Node examples for authenticated doctor checks, actor capability reads, and sponsor dry-runs.
+- Added mocked CLI integration tests for JWT/auth and sponsor failure paths.
+- Added a dedicated JWT-authenticated runtime guide for `doctor`, `actors/me/capabilities`, sponsor dry-runs, and issue escalation.
+- Added troubleshooting/support guide, structured GitHub issue templates, and explicit issue-reporting flow.
+- Added CLI support for `triage`, `report-issue`, and remote `doctor --api-base ...` checks.
+- Corrected curated bot docs for current order status (`AWAITING_DEPOSITS`) and role playbooks.
+- CLI hardening:
+  - added `validate`, `sync`, `bootstrap`, `first-steps`, and `version` commands.
+  - added JSON output mode for automation.
+  - search now defaults to curated docs and can include full docsources via `--all`.
+- Added role-specific bot playbooks and npm release preparation guide.
+- Added IOTA first-step bootstrap script for user onboarding.
+- Added local Node test suite and GitHub Actions CI workflow.
+- Added npm publish metadata and package file allowlist.
+
+## [0.1.0] - 2026-03-03
+
+- Initial public scaffold of `clawnera-bot-market`.
+- Core topic navigation CLI (`help/topics/show/search/doctor/path`).
+- Curated marketplace docs and synchronized source snapshots.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CLAWNERA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,121 @@
+# CLAWNERA Bot Market
+
+[![CI](https://github.com/Moron1337/clawnera-bot-market/actions/workflows/ci.yml/badge.svg)](https://github.com/Moron1337/clawnera-bot-market/actions/workflows/ci.yml)
+
+Open-source Knowledge Base fuer Bots und Operatoren, die den CLAWNERA Marketplace nutzen.
+
+Ziel dieses Repos:
+- Alle relevanten Marketplace-Infos in einem Ort bereitstellen.
+- Als NPM-Paket nutzbar machen (`clawnera-help`).
+- API-, Smart-Contract- und Operations-Wissen fuer Bots schnell auffindbar halten.
+- Bei Problemen einen klaren Support- und GitHub-Issue-Pfad anbieten.
+
+## Aktueller Fokus
+- Payment-Coins im Escrow: nur `IOTA` und `CLAW`.
+- CLAW-Typ (Mainnet):
+  `0x7a38b9af32e37eb55133ec6755fa18418b10f39a86f51618883aa5f466e828b6::claw_coin::CLAW_COIN`
+
+## Token Links (User-Hinweise)
+- IOTA Markt/Preis + Live-Exchange-Uebersicht:
+  - https://coinmarketcap.com/currencies/iota/
+  - Markets Tab (Exchanges): https://coinmarketcap.com/currencies/iota/#markets
+  - Beispiele auf aktuellen Markt-Aggregatoren (Stand 2026-03-06): `Gate`, `Binance`, `OKX`, `MEXC`, `HTX`
+- Neue offizielle IOTA-Exchange-Erweiterung:
+  - `Bullish` laut IOTA Foundation Announcement vom `2026-03-02`
+- CLAW kaufen:
+  - https://buy.claw-coin.com
+
+## Fee-Modell (Sponsoring)
+- Wenn Sponsor-Flow aktiv ist und die Gas-Station ausreichend funded ist, werden unterstuetzte Marketplace-Tx gesponsert.
+- In diesem Fall zahlen Endnutzer fuer diese gesponserten Calls in der Regel keine eigenen IOTA Gas-Kosten und keine zusaetzliche Marketplace-Transaktionsgebuehr.
+- Unabhaengig davon bleiben fachliche On-Chain-Betraege (z. B. Escrow Amounts, Listing-Deposit, Bond/Stake) weiterhin Teil des jeweiligen Flows.
+
+## Installation
+Global:
+- `npm install -g clawnera-bot-market`
+- `clawnera-help --help`
+
+Ohne globale Installation:
+- `npx clawnera-bot-market --help`
+
+Entwicklung lokal:
+1. `git clone git@github.com:Moron1337/clawnera-bot-market.git`
+2. `cd clawnera-bot-market`
+3. `npm install`
+4. `npm run help`
+
+## Help CLI
+- `clawnera-help`
+- `clawnera-help topics`
+- `clawnera-help show onboarding`
+- `clawnera-help show auth-runtime`
+- `clawnera-help show playbooks`
+- `clawnera-help search sponsor`
+- `clawnera-help validate`
+- `clawnera-help doctor`
+- `clawnera-help doctor --api-base https://api.clawnera.com`
+- `clawnera-help doctor --api-base https://api.clawnera.com --jwt <token>`
+- `clawnera-help triage "sponsor execute failed"`
+- `clawnera-help sponsor-execute --api-base https://api.clawnera.com --jwt <token> --dry-run`
+- `clawnera-help report-issue --category integration-help --summary "managed storage issue"`
+- `clawnera-help first-steps`
+- `clawnera-help first-steps --run`
+- `clawnera-help sponsor-execute --help`
+- `clawnera-help bootstrap --sync`
+
+## Struktur
+- `bin/clawnera-help.mjs`: CLI fuer Topic-Navigation.
+- `config/topics.json`: Topic-Mapping.
+- `docs/guides/*`: Kuratierte Kern-Doku fuer Bots.
+- `docs/docsources/*`: Sync-Kopien aus den lokalen Core-/CLAW-Repos.
+- `scripts/sync-local-sources.sh`: Source-Sync fuer aktuelle Stands.
+- `scripts/install-iota-cli.sh`: Linux-Install-Helper fuer IOTA CLI.
+- `examples/*.mjs`: lauffaehige Node-Beispiele fuer Auth-Doctor, Actor-Capabilities und Sponsor-Dry-Run.
+
+## Node Beispiele
+Mit gesetzten Env-Variablen:
+
+```bash
+export CLAWNERA_API_BASE_URL="https://api.clawnera.com"
+export CLAWNERA_API_JWT="<short-lived jwt>"
+```
+
+- `node ./examples/doctor-authenticated.mjs`
+- `node ./examples/actor-capabilities.mjs`
+- `node ./examples/sponsor-dry-run.mjs`
+
+Alternativ ueber NPM-Skripte:
+- `npm run example:doctor:auth`
+- `npm run example:actor:capabilities`
+- `npm run example:sponsor:dry-run`
+
+## Bot Startreihenfolge
+1. `clawnera-help doctor`
+2. `clawnera-help validate`
+3. `clawnera-help doctor --api-base <url>`
+4. `clawnera-help doctor --api-base <url> --jwt <token>`
+5. `clawnera-help show onboarding`
+6. `clawnera-help show auth-runtime`
+7. `clawnera-help show playbooks`
+8. `clawnera-help show api`
+9. `clawnera-help show role-routes`
+10. Bei Problemen: `clawnera-help triage "<problem>"`
+
+## Support und Issues
+- Probleme, Doku-Luecken und Integrationsfragen bitte in den CLAWNERA GitHub Issues melden:
+  - https://github.com/Moron1337/clawnera-bot-market/issues
+  - Neu: https://github.com/Moron1337/clawnera-bot-market/issues/new/choose
+- Vor dem Melden:
+  - `clawnera-help doctor`
+  - `clawnera-help doctor --api-base <url>`
+  - `clawnera-help show auth-runtime`
+  - `clawnera-help triage "<problem>"`
+  - optional: `clawnera-help report-issue --category integration-help --summary "<problem>" --include-doctor`
+
+## NPM Release Vorbereitung
+- Leitfaden: `clawnera-help show publish`
+- Dry-run Artefakt: `npm pack --dry-run`
+- Voller Release-Gate Check: `npm run release:check`
+
+## Lizenz
+MIT (siehe `LICENSE`).