Merge pull request #2 from gryszzz/upgrade-kaspa-researcher-engineer-v1.4

Upgrade Kaspa AI Agent Skill freshness, research radar, source discipline, adapters, docs, and dedicated branding.

Author: gryszzz

.DS_Store

@@ -40,11 +40,13 @@ jobs:
           if [ -z "$DOMAIN" ] && [ -f /tmp/pages-artifact/CNAME ]; then
             DOMAIN="$(tr -d '[:space:]' < /tmp/pages-artifact/CNAME)"
           fi
-          if [ -z "$DOMAIN" ]; then
-            DOMAIN="forge-os.xyz"
+          if [ -n "$DOMAIN" ]; then
+            echo "$DOMAIN" > /tmp/pages-artifact/CNAME
+            echo "Using custom domain: $DOMAIN"
+          else
+            rm -f /tmp/pages-artifact/CNAME
+            echo "Using default GitHub Pages project URL"
           fi
-          echo "$DOMAIN" > /tmp/pages-artifact/CNAME
-          echo "Using custom domain: $DOMAIN"
 
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3

.github/workflows/pages.yml

@@ -1,68 +1,64 @@
-# ExecPlan: Ship Kaspa Wallet Fullstack v1 Revenue-Ready
+# ExecPlan: Upgrade Kaspa Researcher + Engineer Skill v1.4.0
 
 ## Goal
-Deliver a production-ready Kaspa wallet fullstack where users can connect via Kasware/Kaspium, query balances, and generate payment intents with a transparent platform fee routed to the configured operator wallet.
+
+Upgrade the existing `kaspa-sovereign-architect-engine` package into a sharper, current-aware, source-grounded Kaspa researcher and engineering skill without breaking its package-first structure or adapter compatibility.
 
 ## Success Metrics
-- Activation: wallet challenge + session completion succeeds for both Kasware and Kaspium flows.
-- Retention: balance refresh + payment quote happy path remains stable under repeated requests.
-- Revenue: platform fee quote is generated on every eligible payment intent and points to configured fee recipient.
+
+- Skill supports efficient response modes and no longer forces deep audit output for tiny questions.
+- Current/future Kaspa claims use freshness checks, source hierarchy, absolute dates, and commit hashes where applicable.
+- KIPs, Kdapp, WASM/TypeScript, indexers, wallet safety, and future features have explicit handling rules.
+- Adapters reference the same core policies and pass compatibility validation.
+- README, manifest, release notes, and references describe the v1.4.0 behavior clearly.
 
 ## Constraints
-- Timebox: ship in this execution session with verified commands.
-- Tech constraints:
-  - Keep Kaspa UTXO-first and wallet-signing separation intact.
-  - No hidden fees; fees must be explicit in API response and UI.
-  - Preserve both wallet flows (Kasware/Kaspium).
-  - Validate both `kaspa:` and `kaspatest:` prefixes.
-
-## Milestones (PR-sized)
-1. Planning rails and repo alignment
-- [x] Add/update `AGENTS.md` and `PLANS.md` with enforceable execution rules.
-- [x] Ensure required docs references are present or documented if missing.
-
-2. Monetization spine (transparent platform fee)
-- [x] Add backend pricing config (fee recipient, bps, min fee, enable toggle).
-- [x] Add fee quote endpoint for payment intents.
-- [x] Add frontend payment quote UI + fee breakdown + deeplink outputs.
-
-3. Analytics/telemetry minimums
-- [x] Add backend analytics event counters for signup, activation, payment intent.
-- [x] Expose telemetry through existing metrics endpoint.
-
-4. Tests and verification hardening
-- [x] Add backend unit tests for fee math and validation.
-- [x] Add frontend tests for fee/deeplink logic.
-- [x] Run lint/typecheck/tests for backend and frontend.
-
-5. Deployment + docs completeness
-- [x] Update README + env docs + troubleshooting + pricing config.
-- [x] Verify Docker path exists and is documented.
-- [x] Run one end-to-end happy path command sequence and record result.
-
-## Definition of Done Checklist
-- [x] Clean clone -> one command runs (`docker compose up --build` in `kaspa-wallet-fullstack/`)
-- [x] Tests/lint/typecheck pass
-- [x] Deploy documented and reproducible
-- [x] Monetization live (transparent platform fee config + quote flow)
-- [x] Analytics events tracked (signup/activation/payment)
-- [x] README complete (setup, env vars, run, test, deploy, troubleshooting)
+
+- Preserve the existing package layout under `skills/public/kaspa-sovereign-architect-engine/`.
+- Modify existing skill/docs instead of creating a new project.
+- Do not remove adapter compatibility or validator-required metadata.
+- Do not present roadmap or research discussion as live protocol behavior.
+
+## Milestones
+
+1. Inspect current repository structure and stale defaults.
+- [x] Review README, README.dev, AGENTS, PLANS, CONTRIBUTING, manifest, skill, references, adapters, workflows, docs, release notes, and training corpus.
+
+2. Refresh source baseline.
+- [x] Check primary Kaspa source families and record repository snapshot hashes.
+
+3. Upgrade the core skill.
+- [x] Add Freshness & Verification Protocol.
+- [x] Add Source Trust Policy pointer.
+- [x] Add Research Radar pointer.
+- [x] Add Efficient Response Modes.
+- [x] Add KIP, Kdapp, WASM/TypeScript, indexer, wallet, and future-feature disciplines.
+- [x] Scope deep audit skeleton to Deep Protocol Audit mode.
+
+4. Update package assets.
+- [x] Add `source-trust-policy.md`.
+- [x] Add `kaspa-research-radar.md`.
+- [x] Refresh source inventory.
+- [x] Update adapters.
+- [x] Update README examples and manifest metadata.
+- [x] Add v1.4.0 release notes.
+
+5. Validate and ship branch.
+- [x] Run compatibility validation.
+- [x] Run available markdown/link checks if present.
+- [x] Confirm adapter references and required files.
+- [ ] Commit changes.
+- [ ] Push branch if remote is available.
 
 ## Commands to Verify
-- `cd kaspa-wallet-fullstack/backend && npm ci && npm run build && npm run lint && npm test`
-- `cd kaspa-wallet-fullstack/frontend && npm ci && npm run build && npm run lint && npm test`
-- `cd kaspa-wallet-fullstack && docker compose config`
-- Happy path API run:
-  - `cd kaspa-wallet-fullstack/backend && npm run build && node dist/server.js`
-  - `curl -s http://localhost:8080/v1/payments/quote -X POST -H 'content-type: application/json' -d '{...}'`
-
-## Progress Log
-- [x] Initial scan of repository and target app (`kaspa-wallet-fullstack`).
-- [x] Milestone 1 complete.
-- [x] Milestone 2 complete.
-- [x] Milestone 3 complete.
-- [x] Milestone 4 complete.
-- [x] Milestone 5 complete.
+
+- `node skills/public/kaspa-sovereign-architect-engine/scripts/validate-compatibility.mjs --all`
+- `rg -n "Freshness & Verification Protocol|Source Trust Policy|Research Radar|Efficient Response Modes|KIP Status Discipline|Wallet Safety Discipline" skills/public/kaspa-sovereign-architect-engine/agents`
+- `rg -n "kaspa-sovereign-architect-engine" skills/public/kaspa-sovereign-architect-engine/agents`
+- `test -f skills/public/kaspa-sovereign-architect-engine/references/source-trust-policy.md`
+- `test -f skills/public/kaspa-sovereign-architect-engine/references/kaspa-research-radar.md`
+- `test -f release-notes/v1.4.0.md`
 
 ## Blockers / TODOs
-- TODO(issue:LOCAL-DOCKER-VERIFY): Docker binary is unavailable in this execution environment, so local Docker smoke execution could not be run here. Follow-up: run `docker compose up --build` in `kaspa-wallet-fullstack/` and verify `GET /healthz` plus frontend boot at `http://localhost:3000`.
+
+- No markdown lint or broken-link checker was present in repo metadata or workflows; compatibility, package, adapter export, and targeted search checks were run instead.

PLANS.md

@@ -1,25 +1,29 @@
 # 🧠 Kaspa Sovereign Architect Engine
 
-**Codex-native Kaspa engineering skill** with **cross-platform adapters** for OpenAI, Claude, Cursor, OpenClaw, Gemini CLI, and generic LLM workflows.
+**Kaspa researcher + engineering skill** with **cross-platform adapters** for Codex, OpenAI-style agents, Claude, Cursor, OpenClaw, Gemini CLI, and generic LLM workflows.
 
 ## 🚀 What This Is
 
-This repository publishes a reusable AI skill package for serious Kaspa engineering.
+This repository publishes a reusable AI skill package for serious Kaspa research and engineering.
 
 - **Skill ID:** `$kaspa-sovereign-architect-engine`
 - **Main skill file:** [`SKILL.md`](skills/public/kaspa-sovereign-architect-engine/SKILL.md)
-- **Release downloads:** [GitHub Releases](https://github.com/gryszzz/Top-Ai-Agent-Developer-For-Kaspa/releases)
+- **Release downloads:** [GitHub Releases](https://github.com/gryszzz/Kaspa-Ai-Agent-Skill/releases)
 - **Positioning:** package-first distribution (not a website product)
+- **Freshness model:** current-aware, source-grounded, KIP-aware, and research-radar aware
+- **Build scope:** Kaspa protocol, wallet, indexer, WASM, dApp, Kdapp, and infrastructure work
 
 ## 🔥 What This Agent Is Good At
 
 `$kaspa-sovereign-architect-engine` focuses on:
 
-- **Protocol engineering:** BlockDAG, GHOSTDAG, mempool, UTXO semantics
-- **Indexer architecture:** DAG-aware indexing, conflict handling, consistency flows
-- **Backend reliability:** APIs, workers, retries, caching, validation, observability
-- **Wallet + UX:** wallet-aware transaction lifecycle and confirmation state UX
-- **Security rigor:** threat modeling, key boundaries, replay and double-spend controls
+- **Kaspa research radar:** economics, L1/L2, consensus, mining, KIPs, papers, and ecosystem engineering
+- **Protocol engineering:** BlockDAG, GHOSTDAG, DAGKNIGHT status checks, mempool, UTXO semantics, and future-feature handling
+- **KIP-aware analysis:** separates research ideas, KIP proposals, merged code, activation, wallet/indexer support, and app usability
+- **Indexer architecture:** DAG-aware ordering, idempotent ingestion, dedupe, checkpoints, retries, sync lag, and query-layer separation
+- **WASM + TypeScript apps:** browser/Node separation, watch-only prototypes, wallet-provider signing, RPC trust assumptions
+- **Wallet + UX safety:** signing boundaries, custody warnings, phishing, UI spoofing, RPC hijacking, replay, and supply-chain risk
+- **Backend and infrastructure reliability:** APIs, workers, retries, caching, validation, observability, deployment, and recovery plans
 
 ## ⚡ Quick Start (Codex)
 
@@ -36,6 +40,24 @@ Or embed it directly:
 Use $kaspa-sovereign-architect-engine to audit my wallet backend for replay, nonce, and signing risks.
 ```
 
+## 🛰 Example Prompts
+
+```text
+Use $kaspa-sovereign-architect-engine in Research Radar mode. Check what is new across Kaspa Research categories and identify builder-relevant changes.
+```
+
+```text
+Use $kaspa-sovereign-architect-engine in Engineering Build Plan mode. Design a testnet-first Kaspa WASM wallet dashboard with watch-only mode and safe signing boundaries.
+```
+
+```text
+Use $kaspa-sovereign-architect-engine in Deep Protocol Audit mode. Audit a Kaspa indexer design for DAG-aware ordering, idempotency, replay handling, and sync lag.
+```
+
+```text
+Use $kaspa-sovereign-architect-engine in KIP Status mode. Build a table of relevant KIPs, their activation status, builder impact, and what must be verified.
+```
+
 ## 🧩 Compatibility Matrix
 
 | Platform | Status | Adapter |
@@ -51,10 +73,12 @@ Use $kaspa-sovereign-architect-engine to audit my wallet backend for replay, non
 Compatibility metadata:
 
 - [`manifest.json`](skills/public/kaspa-sovereign-architect-engine/manifest.json)
+- Source trust policy: [`source-trust-policy.md`](skills/public/kaspa-sovereign-architect-engine/references/source-trust-policy.md)
+- Research radar: [`kaspa-research-radar.md`](skills/public/kaspa-sovereign-architect-engine/references/kaspa-research-radar.md)
 
 Automated verification:
 
-- [Compatibility Matrix workflow](https://github.com/gryszzz/Top-Ai-Agent-Developer-For-Kaspa/actions/workflows/compatibility-matrix.yml)
+- [Compatibility Matrix workflow](https://github.com/gryszzz/Kaspa-Ai-Agent-Skill/actions/workflows/compatibility-matrix.yml)
 - Release gating validation is enforced in [`.github/workflows/release-skill.yml`](.github/workflows/release-skill.yml)
 
 ## 🛠 Install
@@ -64,23 +88,23 @@ Automated verification:
 ```bash
 mkdir -p "$CODEX_HOME/skills"
 curl -L -o /tmp/kaspa-sovereign-architect-engine.zip \
-  https://github.com/gryszzz/Top-Ai-Agent-Developer-For-Kaspa/releases/latest/download/kaspa-sovereign-architect-engine.zip
+  https://github.com/gryszzz/Kaspa-Ai-Agent-Skill/releases/latest/download/kaspa-sovereign-architect-engine.zip
 unzip -o /tmp/kaspa-sovereign-architect-engine.zip -d "$CODEX_HOME/skills"
 ```
 
 Verify artifact integrity:
 
 ```bash
 curl -L -o /tmp/SHA256SUMS.txt \
-  https://github.com/gryszzz/Top-Ai-Agent-Developer-For-Kaspa/releases/latest/download/SHA256SUMS.txt
+  https://github.com/gryszzz/Kaspa-Ai-Agent-Skill/releases/latest/download/SHA256SUMS.txt
 (cd /tmp && grep "kaspa-sovereign-architect-engine.zip$" SHA256SUMS.txt | shasum -a 256 -c -)
 ```
 
 Alternative tarball install:
 
 ```bash
 curl -L -o /tmp/kaspa-sovereign-architect-engine.tar.gz \
-  https://github.com/gryszzz/Top-Ai-Agent-Developer-For-Kaspa/releases/latest/download/kaspa-sovereign-architect-engine.tar.gz
+  https://github.com/gryszzz/Kaspa-Ai-Agent-Skill/releases/latest/download/kaspa-sovereign-architect-engine.tar.gz
 tar -xzf /tmp/kaspa-sovereign-architect-engine.tar.gz -C "$CODEX_HOME/skills"
 ```
 
@@ -160,13 +184,13 @@ Design a Kaspa DAG-aware indexer for 100k users with failure recovery and replay
 
 ## 📦 Releases
 
-- Download packages: [Releases](https://github.com/gryszzz/Top-Ai-Agent-Developer-For-Kaspa/releases)
+- Download packages: [Releases](https://github.com/gryszzz/Kaspa-Ai-Agent-Skill/releases)
 - Automated packaging workflow: [`.github/workflows/release-skill.yml`](.github/workflows/release-skill.yml)
 
 ## 🌐 Deploy + Marketing
 
 - Auto-deploy workflow: [`.github/workflows/pages.yml`](.github/workflows/pages.yml)
-- GitHub Pages landing page: [Live Site](https://gryszzz.github.io/Top-Ai-Agent-Developer-For-Kaspa/)
+- GitHub Pages landing page: [Live Site](https://gryszzz.github.io/Kaspa-Ai-Agent-Skill/)
 - Custom domain support: set repo variable `GH_PAGES_CNAME` (for example `skill.yourdomain.com`); workflow writes `CNAME` automatically
 - Domain setup guide: [`docs/domain-setup.md`](docs/domain-setup.md)
 - Launch copy + channel templates: [`docs/launch-kit.html`](docs/launch-kit.html)

README.md

@@ -1,44 +1,28 @@
-# Custom Domain Setup (GitHub Pages)
+# GitHub Pages Setup
 
-Canonical domain for this repository:
+This repository is dedicated to Kaspa AI Agent Skill.
 
-- https://forge-os.xyz
+Default project URL:
 
-Fallback project URL:
+- https://gryszzz.github.io/Kaspa-Ai-Agent-Skill/
 
-- https://gryszzz.github.io/Top-Ai-Agent-Developer-For-Kaspa/
+## Optional Custom Domain
 
-## DNS records (Name.com or similar)
+The Pages workflow uses the default GitHub Pages project URL unless you set a repository Actions variable:
 
-Set these records:
+- `GH_PAGES_CNAME`
 
-1. Apex `A` records for `forge-os.xyz`:
-   - `185.199.108.153`
-   - `185.199.109.153`
-   - `185.199.110.153`
-   - `185.199.111.153`
-2. `CNAME` for `www`:
-   - `www -> gryszzz.github.io`
-3. Remove conflicting `www` `A`/`AAAA`/URL redirect records.
+When `GH_PAGES_CNAME` is set, the workflow writes that value into the deployed `CNAME` artifact. No custom domain is hard-coded in this repository.
 
-## GitHub Pages settings
+## GitHub Pages Settings
 
 1. Repo -> `Settings` -> `Pages`.
-2. Set `Custom domain` to `forge-os.xyz` and save.
-3. Wait for certificate provisioning.
-4. Enable `Enforce HTTPS`.
+2. Use GitHub Actions as the Pages source.
+3. Leave custom domain blank unless you intentionally configure `GH_PAGES_CNAME`.
+4. Enable `Enforce HTTPS` when GitHub allows it.
 
-## Repo behavior
-
-- `docs/CNAME` is committed as `forge-os.xyz`.
-- Pages workflow always writes a `CNAME` into the deploy artifact.
-- Optional Actions variable `GH_PAGES_CNAME` can override if needed.
-
-## Quick verification commands
+## Quick Verification
 
 ```bash
-dig +short forge-os.xyz A
-dig +short www.forge-os.xyz CNAME
-curl -I https://forge-os.xyz
-curl -I https://www.forge-os.xyz
+curl -I https://gryszzz.github.io/Kaspa-Ai-Agent-Skill/
 ```