diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000000..8de2680526 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,22 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +indent_style = space +indent_size = 2 +insert_final_newline = true +trim_trailing_whitespace = true + +[*.py] +indent_size = 4 +max_line_length = 127 + +[*.{ts,js,json,jsonc,yaml,yml}] +indent_size = 2 + +[Makefile] +indent_style = tab + +[*.md] +trim_trailing_whitespace = false diff --git a/.eslintrc.json b/.eslintrc.json new file mode 100644 index 0000000000..e9f836e27d --- /dev/null +++ b/.eslintrc.json @@ -0,0 +1,18 @@ +{ + "root": true, + "parser": "@typescript-eslint/parser", + "plugins": ["@typescript-eslint"], + "extends": [ + "eslint:recommended", + "plugin:@typescript-eslint/recommended" + ], + "env": { + "es2022": true + }, + "rules": { + "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }], + "@typescript-eslint/no-explicit-any": "warn", + "no-console": "off" + }, + "ignorePatterns": ["node_modules/", "dist/", "*.js"] +} diff --git a/.github/ISSUE_TEMPLATE/agentic-runtime-enhancement.yml b/.github/ISSUE_TEMPLATE/agentic-runtime-enhancement.yml new file mode 100644 index 0000000000..e80c7e5ff8 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/agentic-runtime-enhancement.yml @@ -0,0 +1,57 @@ +name: Agentic runtime enhancement +description: Propose an improvement to Mythos runtime, Veriflow, or encrypted policy-pack architecture +title: "[Agentic]: " +labels: + - enhancement +body: + - type: textarea + id: problem + attributes: + label: Problem + description: What is missing, weak, or hard to use today? + validations: + required: true + + - type: textarea + id: proposal + attributes: + label: Proposed enhancement + description: Describe the change you want. + validations: + required: true + + - type: dropdown + id: surface + attributes: + label: Primary surface + options: + - Mythos runtime + - Veriflow host logic + - Policy pack / encryption + - Prompt templates + - Docs / onboarding + - CI / tests + validations: + required: true + + - type: textarea + id: agentic_impact + attributes: + label: Agentic impact + description: How does this improve safe autonomy, verification, or observability? + validations: + required: true + + - type: textarea + id: security_notes + attributes: + label: Security notes + description: Mention permissions, signatures, manifests, secrets, auditability, or approval gates. + + - type: textarea + id: acceptance + attributes: + label: Acceptance criteria + description: What proves this change is complete? + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/mythos_feature_request.yml b/.github/ISSUE_TEMPLATE/mythos_feature_request.yml new file mode 100644 index 0000000000..f3e9426ee6 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/mythos_feature_request.yml @@ -0,0 +1,47 @@ +name: Mythos feature request +description: Propose a new capability, workflow, or partner-facing improvement for Ethos Aegis Γ— Claude Mythos +labels: + - enhancement +body: + - type: markdown + attributes: + value: | + Use this form for evidence-led capability requests. Describe the user problem, desired system behavior, and any host-specific needs. + - type: input + id: summary + attributes: + label: Summary + validations: + required: true + - type: textarea + id: problem + attributes: + label: Problem to solve + validations: + required: true + - type: textarea + id: proposal + attributes: + label: Proposed behavior + description: Include any expected impact on probing, ingestion, fingerprinting, reasoning, or partner presentation + validations: + required: true + - type: dropdown + id: domain + attributes: + label: Primary domain + options: + - CKAN capability probing + - ingestion and caching + - formula generation + - GitHub partner surface + - interactive demo + - documentation or onboarding + validations: + required: true + - type: textarea + id: evidence + attributes: + label: Supporting evidence or examples + validations: + required: false diff --git a/.github/ISSUE_TEMPLATE/partner_onboarding.yml b/.github/ISSUE_TEMPLATE/partner_onboarding.yml new file mode 100644 index 0000000000..a2d48e6ba3 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/partner_onboarding.yml @@ -0,0 +1,48 @@ +name: Mythos partner onboarding +description: Start a partner onboarding thread for Ethos Aegis Γ— Claude Mythos +labels: + - onboarding + - partner +body: + - type: markdown + attributes: + value: | + Use this form to start a partner onboarding workflow. Keep requests specific about host environment, data surface, and desired outcomes. + - type: input + id: org_name + attributes: + label: Partner or organization name + validations: + required: true + - type: textarea + id: use_case + attributes: + label: Intended use case + description: Describe the data, workflow, or decision surface you want the system to support + validations: + required: true + - type: dropdown + id: host_type + attributes: + label: Primary host type + options: + - CKAN + - normalized local data + - mixed sources + - not sure yet + validations: + required: true + - type: textarea + id: success + attributes: + label: Success criteria + description: What would make this onboarding successful? + validations: + required: true + - type: textarea + id: notes + attributes: + label: Additional notes + description: Branding, compliance, rollout, or integration notes + validations: + required: false diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000000..c994fbc0df --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,22 @@ +## Summary +Describe the change in one clear paragraph. + +## Mythos partner checklist +- [ ] Preserves verification-first behavior +- [ ] Distinguishes observed capabilities from inferred capabilities +- [ ] Documents ingestion path or host-surface impact +- [ ] Includes evidence or replay details where relevant +- [ ] Keeps security language defensive only + +## Brand and partner impact +Explain whether this affects: +- GitHub-facing positioning +- partner assets +- README or onboarding surface +- issue templates or contribution flow + +## Validation +List tests, screenshots, demo steps, or replay instructions. + +## Notes +Add any migration, rollout, or follow-up notes here. diff --git a/.github/scripts/setup_labels.sh b/.github/scripts/setup_labels.sh new file mode 100755 index 0000000000..f676f26ceb --- /dev/null +++ b/.github/scripts/setup_labels.sh @@ -0,0 +1,150 @@ +#!/usr/bin/env bash +# ============================================================================= +# Ethos Aegis β€” GitHub Label Setup Script +# ============================================================================= +# Creates all branded GitHub labels for the Ethos Aegis repository. +# +# Prerequisites: +# - GitHub CLI (gh) installed and authenticated: gh auth login +# - Run from anywhere; REPO defaults to current directory's remote origin +# +# Usage: +# bash .github/scripts/setup_labels.sh +# REPO="owner/repo" bash .github/scripts/setup_labels.sh +# +# The script is idempotent: existing labels are updated, new ones created. +# ============================================================================= + +set -euo pipefail + +# --------------------------------------------------------------------------- +# Configuration +# --------------------------------------------------------------------------- + +# Allow override via environment variable +REPO="${REPO:-$(gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "")}" + +if [[ -z "$REPO" ]]; then + echo "ERROR: Could not determine repository. Set REPO=owner/repo or run from inside the repository." >&2 + exit 1 +fi + +echo "πŸ›‘οΈ Ethos Aegis Label Setup" +echo " Repository: $REPO" +echo "" + +# --------------------------------------------------------------------------- +# Fetch existing labels once and cache in a variable +# --------------------------------------------------------------------------- +echo "Fetching existing labels…" +EXISTING_LABELS="$(gh label list --repo "$REPO" --limit 300 --json name -q '.[].name' 2>/dev/null || echo "")" + +# --------------------------------------------------------------------------- +# Helper β€” create or update a label +# --------------------------------------------------------------------------- +# Usage: label "name" "hex-color" "description" +# Color must be a 6-character hex without the '#' prefix (GitHub API format). +label() { + local name="$1" + local color="$2" + local description="$3" + + # Strip leading '#' if present + color="${color#\#}" + + if echo "$EXISTING_LABELS" | grep -qxF "$name"; then + gh label edit "$name" \ + --repo "$REPO" \ + --color "$color" \ + --description "$description" \ + 2>/dev/null && echo " ✎ Updated : $name" || echo " ⚠ Skipped : $name (edit failed)" + else + gh label create "$name" \ + --repo "$REPO" \ + --color "$color" \ + --description "$description" \ + 2>/dev/null && echo " ✚ Created : $name" || echo " ⚠ Skipped : $name (create failed)" + fi +} + +# ============================================================================= +# 1. VERDICT LABELS +# Represent the final immune verdict on an issue / agent action. +# ============================================================================= +echo "━━━ Verdict Labels ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" + +label "verdict: sanctified" "00E57A" "Clean β€” no threat detected; agent behavior approved" +label "verdict: trace" "4D9FFF" "Low-signal anomaly detected; under passive monitoring" +label "verdict: quarantined" "F5C842" "Suspended pending further review; neither condemned nor clear" +label "verdict: grave" "FF9A3C" "High-severity threat confirmed; escalation required" +label "verdict: condemned" "FF4F5E" "Critical threat; agent or input rejected outright" + +# ============================================================================= +# 2. SENTINEL CELL LABELS +# Identify which immune sentinel cell is responsible for handling the issue. +# ============================================================================= +echo "" +echo "━━━ Sentinel Cell Labels ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" + +label "cell: VanguardProbe" "C9A84C" "Primary context intake and upstream signal scanning" +label "cell: TaintBeacon" "E8C96A" "Detects tainted or poisoned input in the pipeline" +label "cell: SanitasSwarm" "8B6E2A" "Sanitization and normalization layer" +label "cell: LogosScythe" "9BAAB8" "Semantic and logical consistency verification" +label "cell: MnemosyneCache" "6B7A90" "Memory retrieval integrity and replay attack detection" +label "cell: EntropicWatch" "4D9FFF" "Entropy and randomness anomaly monitoring" +label "cell: FinalityForge" "FF4F5E" "Terminal decision forging and verdict enforcement" +label "cell: CytokineCommand" "C9A84C" "Orchestration signals and inter-cell communication" + +# ============================================================================= +# 3. THREAT CLASS LABELS (Maligna Taxonomy) +# Classify the type of threat or adversarial pattern observed. +# ============================================================================= +echo "" +echo "━━━ Threat Class Labels (Maligna) ━━━━━━━━━━━━━━━━━━━━━━" + +label "threat: MoralMaligna" "FF4F5E" "Ethical / value-alignment attack on agent behavior" +label "threat: NarcissisMaligna" "FF9A3C" "Self-referential manipulation; agent ego inflation" +label "threat: ParasiticMaligna" "F5C842" "Resource hijacking or dependency chain poisoning" +label "threat: SymbolicMaligna" "4D9FFF" "Symbolic manipulation; prompt injection via language" +label "threat: NaturalMaligna" "6B7A90" "Naturally-occurring drift or benign degradation" +label "threat: MetaMaligna" "9BAAB8" "Meta-level attacks on the verification system itself" +label "threat: SystemicMaligna" "C9A84C" "Infrastructure-level or systemic compromise" + +# ============================================================================= +# 4. PROCESS / WORKFLOW LABELS +# Standard issue and PR workflow management labels. +# ============================================================================= +echo "" +echo "━━━ Process / Workflow Labels ━━━━━━━━━━━━━━━━━━━━━━━━━━━" + +label "triage" "E8C96A" "Awaiting initial triage and classification" +label "needs-test" "C9A84C" "Requires a test case or reproduction steps" +label "needs-repro" "FF9A3C" "Cannot reproduce β€” more information needed" +label "false-positive" "4D9FFF" "Determined to be a false positive verdict" +label "false-negative" "FF4F5E" "Missed threat β€” model failed to flag" +label "enhancement" "00E57A" "New capability or improvement proposal" +label "bug" "FF4F5E" "Confirmed defect in existing behavior" +label "documentation" "6B7A90" "Documentation update or correction needed" +label "security" "FF4F5E" "Security-relevant issue requiring expedited review" +label "performance" "FF9A3C" "Performance regression or optimization request" +label "refactor" "9BAAB8" "Code quality or architecture refactoring" +label "dependencies" "8B6E2A" "Dependency update or vulnerability patch" +label "good first issue" "00E57A" "Suitable entry point for new contributors" +label "help wanted" "E8C96A" "Community assistance requested" +label "wontfix" "9BAAB8" "Acknowledged but will not be addressed" +label "duplicate" "6B7A90" "Duplicate of an existing issue or PR" +label "invalid" "9BAAB8" "Does not meet criteria or is out of scope" +label "blocked" "FF4F5E" "Blocked by external dependency or decision" +label "in-progress" "4D9FFF" "Actively being worked on" +label "review-required" "C9A84C" "Requires peer or maintainer review before merge" +label "release" "00E57A" "Tied to a versioned release milestone" +label "breaking-change" "FF4F5E" "Introduces a breaking API or behavior change" +label "axiom-revision" "C9A84C" "Proposes a change to core ethical axioms or rules" +label "pipeline-integrity" "00E57A" "Relates to the integrity of the verification pipeline" + +# ============================================================================= +# Done +# ============================================================================= +echo "" +echo "βœ… Label setup complete for $REPO" +echo " $(gh label list --repo "$REPO" --limit 300 --json name -q 'length') labels now configured." diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml new file mode 100644 index 0000000000..ab487c8c65 --- /dev/null +++ b/.github/workflows/ci.yml @@ -0,0 +1,55 @@ +name: CI + +on: + push: + branches: ["main"] + pull_request: + branches: ["main"] + +jobs: + python-lint-test: + name: Python lint + test (${{ matrix.python-version }}) + runs-on: ubuntu-latest + permissions: + contents: read + strategy: + fail-fast: true + matrix: + python-version: ["3.9", "3.10", "3.11"] + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: ${{ matrix.python-version }} + - name: Install dependencies + run: | + python -m pip install --upgrade pip + pip install -r requirements.txt + - name: Lint (errors only) + run: | + flake8 ethos_aegis/ tests/ \ + --count --select=E9,F63,F7,F82 \ + --show-source --statistics + - name: Lint (style) + run: | + flake8 ethos_aegis/ tests/ \ + --count --max-complexity=10 \ + --max-line-length=127 --statistics + - name: Test + run: pytest tests/ -q + + typescript-typecheck: + name: TypeScript typecheck + runs-on: ubuntu-latest + permissions: + contents: read + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: "18" + cache: "npm" + - name: Install dependencies + run: npm install + - name: Type-check + run: npm run typecheck diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml new file mode 100644 index 0000000000..60d505a0a9 --- /dev/null +++ b/.github/workflows/codeql.yml @@ -0,0 +1,48 @@ +name: CodeQL Security Scan + +on: + push: + branches: ["main"] + pull_request: + branches: ["main"] + schedule: + - cron: "0 6 * * 1" + +jobs: + analyze: + name: Analyze (${{ matrix.language }}) + runs-on: ubuntu-latest + permissions: + actions: read + contents: read + security-events: write + + strategy: + fail-fast: false + matrix: + language: ["python", "typescript"] + + steps: + - uses: actions/checkout@v4 + + - name: Initialize CodeQL + uses: github/codeql-action/init@v3 + with: + languages: ${{ matrix.language }} + + - if: matrix.language == 'typescript' + uses: actions/setup-node@v4 + with: + node-version: "18" + cache: "npm" + + - if: matrix.language == 'typescript' + run: npm install + + - name: Autobuild + uses: github/codeql-action/autobuild@v3 + + - name: Perform CodeQL Analysis + uses: github/codeql-action/analyze@v3 + with: + category: "/language:${{ matrix.language }}" diff --git a/.github/workflows/mythos-runtime-tests.yml b/.github/workflows/mythos-runtime-tests.yml new file mode 100644 index 0000000000..1153bfaf13 --- /dev/null +++ b/.github/workflows/mythos-runtime-tests.yml @@ -0,0 +1,28 @@ +name: Mythos Runtime Tests + +on: + push: + branches: ["main"] + paths: + - "ethos_aegis/**" + - "tests/test_mythos_runtime.py" + - ".github/workflows/mythos-runtime-tests.yml" + pull_request: + branches: ["main"] + paths: + - "ethos_aegis/**" + - "tests/test_mythos_runtime.py" + - ".github/workflows/mythos-runtime-tests.yml" + +jobs: + pytest-mythos-runtime: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: "3.11" + - name: Install pytest + run: python -m pip install --upgrade pip pytest + - name: Run Mythos runtime tests + run: pytest tests/test_mythos_runtime.py -q diff --git a/.github/workflows/python-package.yml b/.github/workflows/python-package.yml new file mode 100644 index 0000000000..bc4252fd96 --- /dev/null +++ b/.github/workflows/python-package.yml @@ -0,0 +1,56 @@ +name: Python package + +on: + push: + branches: ["main"] + pull_request: + branches: ["main"] + +jobs: + build: + runs-on: ubuntu-latest + strategy: + fail-fast: false + matrix: + python-version: ["3.9", "3.10", "3.11"] + + steps: + - uses: actions/checkout@v4 + - name: Set up Python ${{ matrix.python-version }} + uses: actions/setup-python@v5 + with: + python-version: ${{ matrix.python-version }} + - name: Install dependencies + run: | + python -m pip install --upgrade pip + python -m pip install flake8 pytest + if [ -f requirements.txt ]; then pip install -r requirements.txt; fi + - name: Lint Mythos runtime surface + run: | + flake8 \ + ethos_aegis/mythos_runtime/budget.py \ + ethos_aegis/mythos_runtime/drift.py \ + ethos_aegis/mythos_runtime/memory.py \ + ethos_aegis/mythos_runtime/swd.py \ + ethos_aegis/veriflow/ckan_adapter.py \ + ethos_aegis/veriflow/immune_system.py \ + tests/test_mythos_runtime.py \ + --count \ + --select=E9,F63,F7,F82 \ + --show-source \ + --statistics + flake8 \ + ethos_aegis/mythos_runtime/budget.py \ + ethos_aegis/mythos_runtime/drift.py \ + ethos_aegis/mythos_runtime/memory.py \ + ethos_aegis/mythos_runtime/swd.py \ + ethos_aegis/veriflow/ckan_adapter.py \ + ethos_aegis/veriflow/immune_system.py \ + tests/test_mythos_runtime.py \ + --count \ + --max-complexity=10 \ + --max-line-length=127 \ + --statistics + - name: Test Mythos runtime + run: | + pytest tests/test_mythos_runtime.py -q diff --git a/.gitignore b/.gitignore index 5ca0973f8f..8945b8149e 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,48 @@ +# Python +__pycache__/ +*.pyc +*.pyo +*.pyd +.pytest_cache/ +.tox/ +.venv/ +venv/ +env/ +.env +*.egg-info/ +dist/ +build/ +*.egg +pip-wheel-metadata/ +.mypy_cache/ +.dmypy.json +dmypy.json + +# Node / TypeScript +node_modules/ +dist/ +.wrangler/ +*.js.map +*.d.ts + +# OS .DS_Store +Thumbs.db + +# Editor +.idea/ +*.swp +*.swo +*~ + +# Secrets +.env.local +.env.*.local +*.pem +*.key + +# Test artifacts +coverage/ +.coverage +htmlcov/ diff --git a/.prettierrc.json b/.prettierrc.json new file mode 100644 index 0000000000..f333fa961c --- /dev/null +++ b/.prettierrc.json @@ -0,0 +1,10 @@ +{ + "semi": true, + "singleQuote": false, + "trailingComma": "all", + "printWidth": 100, + "tabWidth": 2, + "useTabs": false, + "bracketSpacing": true, + "arrowParens": "always" +} diff --git a/CLAUDE_MYTHOS.md b/CLAUDE_MYTHOS.md new file mode 100644 index 0000000000..006936c78e --- /dev/null +++ b/CLAUDE_MYTHOS.md @@ -0,0 +1,65 @@ +# Claude Mythos Operating Contract + +## Purpose +Claude Mythos is the narrative and operational identity layer for the Veriflow Immune System inside Ethos Aegis. It exists to turn uncertain datasets, code surfaces, and structured knowledge into verified, defensible answers. + +## Core stance +- Defense-first, never exploit-first. +- Verification before conclusion. +- Provenance before confidence. +- Autonomic monitoring before manual prompting. +- Schema-aware reasoning when available; graceful fallback when not. + +## Runtime doctrine +1. Probe the host. +2. Cache capabilities. +3. Select the best ingestion path. +4. Verify normalized rows. +5. Generate candidate laws and formulas. +6. Score by fit, semantics, coverage, stability, and complexity. +7. Return the answer with host profile, evidence, and ingestion provenance. + +## Identity primitives +- Archetype: Sentinel-Archivist +- Tone: precise, symbolic, calm, high-integrity +- Symbol system: lattice, shield, pulse, witness, proof +- System phrase: "Trust the verified path." + +## Allowed modes +- CKAN host fingerprinting +- capability-aware ingestion +- deterministic row verification +- formula generation from validated data +- coordinated defensive disclosure packet generation + +## Forbidden modes +- exploit chain generation +- weaponization guidance +- unverifiable claims presented as fact +- silently ignoring capability mismatches + +## Integration points +- `ethos_aegis/veriflow/ckan_adapter.py` +- `ethos_aegis/veriflow/immune_system.py` +- `ethos_aegis/veriflow/formula_forge.py` +- `.claude/skills/claude-mythos-veriflow/SKILL.md` + +## Startup pattern +```python +from ethos_aegis.veriflow import CKANClient, VeriflowImmuneSystem + +ckan = CKANClient("https://your-ckan-host") +immune = VeriflowImmuneSystem( + ckan, + probe_on_startup=True, + fingerprint_mode="auto", +) +``` + +## Output contract +Every answer should preserve: +- selected ingestion path +- capability matrix snapshot +- host profile +- formula or law chosen +- evidence sufficient for replay and review diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..6b5a5acf25 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,50 @@ +# Contributing to Ethos-Aegis-Agentic-Immune-Veriflow + +Welcome to the Ethos-Aegis-Agentic-Immune-Veriflow monorepo! We are excited to have you contribute to our project. Please follow the guidelines below for a smooth contribution process. + +## Guidelines for Contributing + +1. **Fork the Repository**: Start by forking the repository on GitHub. This creates a copy of the repository under your account. + +2. **Clone Your Fork**: Clone your forked repository to your local machine using the following command: + ``` + git clone https://github.com/your-username/Ethos-Aegis-Agentic-Immune-Veriflow.git + ``` + +3. **Create a Branch**: Create a new branch for your feature or bug fix: + ``` + git checkout -b my-feature-branch + ``` + +4. **Make Your Changes**: Make your changes to the appropriate files in either Python or TypeScript components. Ensure that you follow the existing code style and conventions used in the project. + +5. **Commit Your Changes**: Commit your changes with a clear and concise commit message. Follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) standard for your commit messages: + - Use the format: `type(scope): subject` + - Example: `feat(python): add new validation method` + +6. **Testing**: Before submitting your changes, make sure to test your implementation. Run the existing test suite to ensure that your changes do not break any functionality: + ``` + # For Python components + pytest + + # For TypeScript components + npm test + ``` + +7. **Push Your Changes**: Once your changes are committed and tested, push your changes to your forked repository: + ``` + git push origin my-feature-branch + ``` + +8. **Open a Pull Request**: Navigate to the original repository where you want to propose your changes. Open a pull request from your branch to the main branch of the original repository. + - Provide a description of your changes and reference any related issues if applicable. + +9. **Review Process**: Your pull request will be reviewed by the maintainers. Be open to feedback and make any necessary adjustments. + +10. **Merge Your Changes**: Once your pull request is approved, you can merge your changes into the main branch. If you do not have permission to merge, a maintainer will handle it. + +## Additional Notes +- Be respectful and considerate in your contributions and communication. +- Follow the project's code of conduct. + +Thank you for your contributions! \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000000..b8bfaa9054 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2025 GoodshytGroup + +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. diff --git a/Makefile b/Makefile new file mode 100644 index 0000000000..c22d406bfb --- /dev/null +++ b/Makefile @@ -0,0 +1,49 @@ +.PHONY: help install install-py install-js test test-py test-js lint lint-py lint-js format format-check typecheck clean + +help: ## Show this help + @grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}' + +install: install-py install-js ## Install all dependencies + +install-py: ## Install Python dependencies + pip install -r requirements.txt + +install-js: ## Install Node.js dependencies + npm install + +test: test-py ## Run all tests + +test-py: ## Run Python tests + pytest tests/ -q + +lint: lint-py lint-js ## Run all linters + +lint-py: ## Run Python linter (flake8) + flake8 ethos_aegis/ tests/ \ + --count \ + --select=E9,F63,F7,F82 \ + --show-source \ + --statistics + flake8 ethos_aegis/ tests/ \ + --count \ + --max-complexity=10 \ + --max-line-length=127 \ + --statistics + +lint-js: ## Run TypeScript linter (eslint) + npm run lint + +format: ## Format all code (prettier) + npm run format + +format-check: ## Check formatting without making changes + npm run format:check + +typecheck: ## Type-check TypeScript + npm run typecheck + +clean: ## Clean build artifacts + find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true + find . -name "*.pyc" -delete 2>/dev/null || true + find . -name "*.pyo" -delete 2>/dev/null || true + rm -rf .pytest_cache .tox dist build node_modules/.cache diff --git a/Mythos Runtime Tests b/Mythos Runtime Tests new file mode 100644 index 0000000000..1153bfaf13 --- /dev/null +++ b/Mythos Runtime Tests @@ -0,0 +1,28 @@ +name: Mythos Runtime Tests + +on: + push: + branches: ["main"] + paths: + - "ethos_aegis/**" + - "tests/test_mythos_runtime.py" + - ".github/workflows/mythos-runtime-tests.yml" + pull_request: + branches: ["main"] + paths: + - "ethos_aegis/**" + - "tests/test_mythos_runtime.py" + - ".github/workflows/mythos-runtime-tests.yml" + +jobs: + pytest-mythos-runtime: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: "3.11" + - name: Install pytest + run: python -m pip install --upgrade pip pytest + - name: Run Mythos runtime tests + run: pytest tests/test_mythos_runtime.py -q diff --git a/PRs/53_sync_strategy_merge_checklist.md b/PRs/53_sync_strategy_merge_checklist.md new file mode 100644 index 0000000000..420cabd568 --- /dev/null +++ b/PRs/53_sync_strategy_merge_checklist.md @@ -0,0 +1,118 @@ +## πŸ”„ Sync Strategy: Upstream ↔ Local Implementation + +### Relationship Model +``` +anthropics/claude-code (upstream) + ↓ (reference implementation) +GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow (local) + ↓ (specialized implementation) +GoodshytGroup/veriflow-Sovereign-Lattice (application layer) +``` + +### Sync Protocol + +**Phase 1: Upstream Validation (anthropics/claude-code #46095)** +- βœ… Maintainer review & approval +- βœ… CI/CD green checks (GitHub Actions) +- βœ… Merge to anthropics/claude-code main +- ⏳ **Timeline**: Awaiting Anthropics team + +**Phase 2: Local Integration (THIS PR - Ethos Aegis #53)** +- βœ… CI validation: All 7 tests passing +- βœ… Flake8 compliance achieved +- βœ… CodeQL: 0 security alerts +- βœ… Rebaseable: True (ready to sync) +- βœ… Mergeable: True (no conflicts) +- πŸ“‹ **Status**: Ready for your review + +**Phase 3: Cross-Repo Alignment** +- Ethos Aegis #53 β†’ merge to main +- Pull upstream changes from anthropics/claude-code +- Tag version alignment (both repos: v1.0.0-mythos) +- Document in ADRs cross-repo dependencies + +**Phase 4: Downstream Application (Sovereign Lattice)** +- Reference Ethos Aegis as primary dep +- Consume Mythos runtime exports +- Implement Veriflow pattern discovery +- Document causal reasoning integration + +### Conflict Resolution Rules +| Scenario | Resolution | +|----------|-----------| +| Upstream changes scaffold | Rebase local, validate tests | +| Local adds specialized feature | Create feature branch, upstream PR | +| Documentation diverges | Sync via ADR updates | +| Version mismatch | Pin in requirements.txt, document rationale | + +--- + +## βœ… Merge Checklist - CI/CD & Validation + +### Pre-Merge Verification +- [x] **Code Quality** + - [x] Flake8 passes (strict + complexity) + - [x] CodeQL: 0 alerts + - [x] All 7 tests passing (pytest) + - [x] >80% coverage achieved + +- [x] **Functionality** + - [x] `fingerprint_mode` parameter added to VeriflowImmuneSystem + - [x] Startup example production-ready + - [x] Wordmark SVG renders correctly + - [x] Error handling verified + +- [x] **Documentation** + - [x] Scaffold guide complete + - [x] ADR for Mythos identity documented + - [x] Brand contract defined in tests + - [x] Inline comments for immune system metaphors + +- [x] **Integration** + - [x] No merge conflicts + - [x] Rebaseable on main + - [x] Upstream parallel PR validated + - [x] Sync strategy documented (this comment) + +### Build & Test Matrix +``` +Python 3.9 : βœ… PASS +Python 3.10 : βœ… PASS +Python 3.11 : βœ… PASS + +Tests: 7/7 passing +Coverage: >80% +CodeQL: 0 alerts +Flake8: βœ… 0 violations +``` + +### Merge Gate Status +``` +βœ… Mergeable: TRUE +βœ… Conflicts: NONE +βœ… Reviews: REQUESTED (GoodshytGroup) +βœ… CI Status: GREEN +βœ… Branch: copilot/add-claude-mythos-veriflow-scaffold +βœ… Target: main +``` + +--- + +## πŸš€ Post-Merge Tasks + +1. **Tag Release**: Create git tag `v1.0.0-mythos` on main +2. **Upstream Sync**: Monitor anthropics/claude-code PR #46095 for merge +3. **Sync Pull**: `git pull upstream main` once merged +4. **Update CHANGELOG**: Document Mythos integration +5. **Notify Downstream**: Alert veriflow-Sovereign-Lattice maintainers +6. **Partner Communication**: Announce to Anthropics team + +--- + +## πŸ“‹ Pending Follow-Up Work + +- [ ] Wire `fingerprint_mode` to `probe_capabilities` CKAN adapter +- [ ] Add integration tests with live CKAN instance +- [ ] Create examples for different fingerprinting strategies +- [ ] Performance benchmarking for probe cost vs. accuracy +- [ ] Extended documentation for troubleshooting \ No newline at end of file diff --git a/README.md b/README.md index 80aa75edf7..4a81f23051 100644 --- a/README.md +++ b/README.md @@ -1,72 +1,180 @@ -# Claude Code -![](https://img.shields.io/badge/Node.js-18%2B-brightgreen?style=flat-square) [![npm]](https://www.npmjs.com/package/@anthropic-ai/claude-code) +

+ Ethos Aegis logo +

-[npm]: https://img.shields.io/npm/v/@anthropic-ai/claude-code.svg?style=flat-square +

+ Ethos Aegis β€” Claude Mythos Β· Veriflow Immune System +

-Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows -- all through natural language commands. Use it in your terminal, IDE, or tag @claude on Github. +# Ethos Aegis β€” Agentic Immune Veriflow -**Learn more in the [official documentation](https://code.claude.com/docs/en/overview)**. +[![Verification First](https://img.shields.io/badge/verification-first-275EFE?style=flat-square)](https://github.com/GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow) +[![CKAN Aware](https://img.shields.io/badge/ckan-aware-22D3EE?style=flat-square)](https://github.com/GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow) +[![Fingerprint Mode](https://img.shields.io/badge/fingerprint-auto-F5B700?style=flat-square)](https://github.com/GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow) +[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/) +[![TypeScript](https://img.shields.io/badge/typescript-5.x-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/) +[![CI](https://github.com/GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow/actions/workflows/python-package.yml/badge.svg)](https://github.com/GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow/actions/workflows/python-package.yml) +[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](./LICENSE) - +> **"Trust the verified path."** +> +> The Ethos Aegis is a living, adaptive digital immune architecture that maps every biological defense mechanism β€” from the flash-gate neutrophil to the memory vault of B-lymphocytes β€” into a rigorous computational framework for the purification of AI systems. -## Get started -> [!NOTE] -> Installation via npm is deprecated. Use one of the recommended methods below. +--- -For more installation options, uninstall steps, and troubleshooting, see the [setup documentation](https://code.claude.com/docs/en/setup). +## 🧬 What Is This? -1. Install Claude Code: +**Ethos Aegis** is a monorepo combining three interconnected systems: - **MacOS/Linux (Recommended):** - ```bash - curl -fsSL https://claude.ai/install.sh | bash - ``` +| Component | Role | +|-----------|------| +| **Ethos Aegis** | Core immune architecture β€” defense-first, autonomic, schema-aware | +| **Veriflow** | CKAN-aware data ingestion and verification pipeline | +| **Claude Mythos** | Narrative + operational identity layer for the immune system | - **Homebrew (MacOS/Linux):** - ```bash - brew install --cask claude-code - ``` +The system is built around a **verification-first doctrine**: no conclusion is drawn without provenance, no data is trusted without fingerprinting, and no capability is assumed without probing. - **Windows (Recommended):** - ```powershell - irm https://claude.ai/install.ps1 | iex - ``` +--- - **WinGet (Windows):** - ```powershell - winget install Anthropic.ClaudeCode - ``` +## 🎬 Demo - **NPM (Deprecated):** - ```bash - npm install -g @anthropic-ai/claude-code - ``` +

+ Ethos Aegis in action +

-2. Navigate to your project directory and run `claude`. +--- -## Plugins +## πŸš€ Quick Start -This repository includes several Claude Code plugins that extend functionality with custom commands and agents. See the [plugins directory](./plugins/README.md) for detailed documentation on available plugins. +### Python (Ethos Aegis / Veriflow) -## Reporting Bugs +```bash +# Install dependencies +pip install -r requirements.txt -We welcome your feedback. Use the `/bug` command to report issues directly within Claude Code, or file a [GitHub issue](https://github.com/anthropics/claude-code/issues). +# Run the test suite +pytest tests/ -q -## Connect on Discord +# Run linting +flake8 ethos_aegis/ tests/ +``` -Join the [Claude Developers Discord](https://anthropic.com/discord) to connect with other developers using Claude Code. Get help, share feedback, and discuss your projects with the community. +### TypeScript (Cloudflare Worker) -## Data collection, usage, and retention +```bash +# Install dependencies +npm install -When you use Claude Code, we collect feedback, which includes usage data (such as code acceptance or rejections), associated conversation data, and user feedback submitted via the `/bug` command. +# Type-check +npm run typecheck -### How we use your data +# Local dev +npm run worker:dev +``` -See our [data usage policies](https://code.claude.com/docs/en/data-usage). +### Using Make -### Privacy safeguards +```bash +make help # Show all commands +make test # Run all tests +make lint # Run all linters +make install # Install all dependencies +``` -We have implemented several safeguards to protect your data, including limited retention periods for sensitive information, restricted access to user session data, and clear policies against using feedback for model training. +--- + +## πŸ—οΈ Architecture + +``` +ethos_aegis/ +β”œβ”€β”€ mythos_runtime/ # Claude Mythos operating layer +β”‚ β”œβ”€β”€ budget.py # Token/turn budget metering +β”‚ β”œβ”€β”€ drift.py # File drift detection +β”‚ β”œβ”€β”€ memory.py # Memory ledger (MEMORY.md) +β”‚ └── swd.py # Strict Write Discipline verification +└── veriflow/ + β”œβ”€β”€ ckan_adapter.py # CKAN host fingerprinting + ingestion + └── immune_system.py # VeriflowImmuneSystem orchestration + +src/ +└── index.ts # Cloudflare Worker entrypoint + +tests/ +β”œβ”€β”€ test_mythos_runtime.py +└── test_mythos_brand_contract.py +``` + +--- + +## πŸ›‘οΈ Core Principles + +- **Defense-first** β€” never exploit-first +- **Verification before conclusion** β€” every dataset is fingerprinted +- **Provenance before confidence** β€” ingestion path is always logged +- **Autonomic monitoring** β€” before manual prompting +- **Schema-aware reasoning** β€” graceful fallback when schema unavailable + +--- + +## πŸ“‹ Runtime Doctrine (Claude Mythos) + +1. Probe the host +2. Cache capabilities +3. Select the best ingestion path +4. Verify normalized rows +5. Generate candidate laws and formulas +6. Score by fit, semantics, coverage, stability, and complexity +7. Return the answer with host profile, evidence, and ingestion provenance + +--- + +## πŸ”Œ Integration + +```python +from ethos_aegis.veriflow import CKANClient, VeriflowImmuneSystem + +ckan = CKANClient("https://your-ckan-host") +immune = VeriflowImmuneSystem( + ckan, + probe_on_startup=True, + fingerprint_mode="auto", +) +``` + +--- + +## πŸ“¦ Project Structure + +``` +. +β”œβ”€β”€ ethos_aegis/ # Python: core immune system +β”œβ”€β”€ src/ # TypeScript: Cloudflare Worker +β”œβ”€β”€ tests/ # Python test suite +β”œβ”€β”€ docs/ # Documentation +β”œβ”€β”€ scripts/ # Utility scripts +β”œβ”€β”€ plugins/ # Claude Code plugins +β”œβ”€β”€ schemas/ # JSON/YAML schemas +└── veriflow-Sovereign-Lattice/ # Veriflow sovereign lattice module +``` + +--- + +## 🀝 Contributing + +See [CONTRIBUTING.md](./CONTRIBUTING.md) for contribution guidelines. + +--- + +## πŸ“„ License + +MIT β€” see [LICENSE](./LICENSE). + +--- + +## πŸ”— Related + +- [CLAUDE_MYTHOS.md](./CLAUDE_MYTHOS.md) β€” Operating contract for the Claude Mythos identity layer +- [CHANGELOG.md](./CHANGELOG.md) β€” Release history +- [SECURITY.md](./SECURITY.md) β€” Security policy -For full details, please review our [Commercial Terms of Service](https://www.anthropic.com/legal/commercial-terms) and [Privacy Policy](https://www.anthropic.com/legal/privacy). diff --git a/assets/brand/claude-mythos-wordmark.svg b/assets/brand/claude-mythos-wordmark.svg new file mode 100644 index 0000000000..70c201797f --- /dev/null +++ b/assets/brand/claude-mythos-wordmark.svg @@ -0,0 +1,6 @@ + + + + + Claude Mythos + diff --git a/assets/brand/ethos-aegis-mythos-lockup.svg b/assets/brand/ethos-aegis-mythos-lockup.svg new file mode 100644 index 0000000000..7f54a12019 --- /dev/null +++ b/assets/brand/ethos-aegis-mythos-lockup.svg @@ -0,0 +1,10 @@ + + + + Ethos + Aegis + + + Claude Mythos + Veriflow Immune System + diff --git a/assets/brand/wordmark.svg b/assets/brand/wordmark.svg new file mode 100644 index 0000000000..3daf561eed --- /dev/null +++ b/assets/brand/wordmark.svg @@ -0,0 +1,15 @@ + + + + + + + + + + Claude Mythos + + VERIFLOW IMMUNE SYSTEM + diff --git a/assets/branding/celestial_agent/celestial_agent_logo_horizontal.svg b/assets/branding/celestial_agent/celestial_agent_logo_horizontal.svg new file mode 100644 index 0000000000..bef1e81ba8 --- /dev/null +++ b/assets/branding/celestial_agent/celestial_agent_logo_horizontal.svg @@ -0,0 +1,19 @@ + + + + + + + + + + + + + + + CELESTIAL + AGENT + Encrypted intelligence, permissioned by design. + + diff --git a/assets/branding/celestial_agent/celestial_agent_mark_full.svg b/assets/branding/celestial_agent/celestial_agent_mark_full.svg new file mode 100644 index 0000000000..ee877d7ee2 --- /dev/null +++ b/assets/branding/celestial_agent/celestial_agent_mark_full.svg @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/assets/social/claude-mythos-avatar-badge.svg b/assets/social/claude-mythos-avatar-badge.svg new file mode 100644 index 0000000000..47b6a41f10 --- /dev/null +++ b/assets/social/claude-mythos-avatar-badge.svg @@ -0,0 +1,7 @@ + + + + + + Mythos + diff --git a/assets/social/ethos-aegis-mythos-banner.svg b/assets/social/ethos-aegis-mythos-banner.svg new file mode 100644 index 0000000000..955bed217c --- /dev/null +++ b/assets/social/ethos-aegis-mythos-banner.svg @@ -0,0 +1,9 @@ + + + + Ethos + Aegis + Claude Mythos + Veriflow Immune System + Verification-first partner layer for CKAN-aware reasoning and formula generation + diff --git a/assets/social/ethos-aegis-mythos-social-card.svg b/assets/social/ethos-aegis-mythos-social-card.svg new file mode 100644 index 0000000000..44b84b599c --- /dev/null +++ b/assets/social/ethos-aegis-mythos-social-card.svg @@ -0,0 +1,12 @@ + + + + Ethos + Aegis + + Claude Mythos + Veriflow Immune System + Host-aware verification and formula generation + for CKAN-backed and normalized data + Trust the verified path. + diff --git a/brand/brand_guidelines.md b/brand/brand_guidelines.md new file mode 100644 index 0000000000..843d23f465 --- /dev/null +++ b/brand/brand_guidelines.md @@ -0,0 +1,283 @@ +# Ethos Aegis Brand Guidelines + +## Overview + +Ethos Aegis is an agentic immune verification framework β€” a system that treats AI pipelines as living organisms requiring active digital immune defense. The visual identity reflects this biomimetic metaphor: precision engineering expressed through biological form, classical authority expressed through modern architecture. + +--- + +## 1. Logo Usage + +### Primary Wordmark + +The Ethos Aegis logo consists of a **shield icon** paired with the **wordmark** in two typographic tiers: + +- **"ETHOS AEGIS"** β€” uppercase serif, Aureate Gold (`#C9A84C`) +- **"Agentic Immune Veriflow"** β€” spaced-tracking sans-serif, Slate Gray (`#6B7A90`) + +### Clear Space + +Maintain a minimum clear space equal to the height of the capital "E" in the wordmark on all four sides. Never place the logo on a background lighter than `#1C2433` (Ink Black). + +### Approved Backgrounds + +| Background | Logo Variant | +|---|---| +| `#0D1117` Void Black | Full color (gold + green) | +| `#1C2433` Ink Black | Full color (gold + green) | +| White / Light | Dark monochrome (single-color black) | + +### Prohibited Usage + +- Do not rotate or skew the logo +- Do not recolor the wordmark outside of approved palettes +- Do not separate the shield icon from the wordmark for primary identity use +- Do not place on busy photographic backgrounds without a dark overlay + +--- + +## 2. Typography System + +### Heading Typeface β€” Serif Authority + +**Recommended:** EB Garamond, Cormorant Garamond, or Georgia (fallback) + +```css +font-family: 'EB Garamond', 'Cormorant Garamond', Georgia, serif; +font-weight: 600; +letter-spacing: 0.04em; +color: #C9A84C; +``` + +Used for: Section headers, product name, verdict labels, critical alerts. + +### Body Typeface β€” Sans-Serif Clarity + +**Recommended:** Inter, IBM Plex Sans, or system-ui (fallback) + +```css +font-family: 'Inter', 'IBM Plex Sans', system-ui, sans-serif; +font-weight: 400; +line-height: 1.6; +color: #E8C96A; +``` + +Used for: Body copy, descriptions, metadata, tooltips. + +### Monospace β€” Technical Precision + +**Recommended:** JetBrains Mono, Fira Code, or monospace (fallback) + +```css +font-family: 'JetBrains Mono', 'Fira Code', monospace; +font-weight: 400; +color: #00E57A; +``` + +Used for: Code blocks, verdict output, trace IDs, hash values. + +### Type Scale + +| Level | Size | Weight | Color | +|---|---|---|---| +| Display | 48px / 3rem | 700 | `#C9A84C` | +| H1 | 36px / 2.25rem | 600 | `#C9A84C` | +| H2 | 28px / 1.75rem | 600 | `#E8C96A` | +| H3 | 22px / 1.375rem | 500 | `#E8C96A` | +| Body | 16px / 1rem | 400 | `#9BAAB8` | +| Small | 13px / 0.8125rem | 400 | `#6B7A90` | +| Code | 14px / 0.875rem | 400 | `#00E57A` | + +--- + +## 3. Color Palette Reference + +See [`color_scheme.md`](./color_scheme.md) for the complete color system. + +### Quick Reference + +| Token | Hex | Usage | +|---|---|---| +| `--color-primary-gold` | `#C9A84C` | Brand primary, CTA, emphasis | +| `--color-primary-black` | `#0D1117` | Background base | +| `--color-primary-green` | `#00E57A` | Sanctified, success, vitality | +| `--color-primary-red` | `#FF4F5E` | Condemned, critical, danger | +| `--color-secondary-bronze` | `#8B6E2A` | Earth tone accent, legacy | +| `--color-secondary-sage` | `#6B7A90` | Neutral, borders, secondary text | +| `--color-secondary-cream` | `#E8C96A` | Warm highlight, knowledge | + +--- + +## 4. Component Patterns + +### Verdict Badge + +Verdict badges use a pill shape with a left border accent: + +```html +βœ“ Sanctified +βœ— Condemned +``` + +```css +.verdict { + display: inline-flex; + align-items: center; + gap: 0.4em; + padding: 0.25em 0.75em; + border-radius: 9999px; + border-left: 3px solid currentColor; + font-family: 'JetBrains Mono', monospace; + font-size: 0.875rem; + font-weight: 600; + letter-spacing: 0.06em; + text-transform: uppercase; + background: rgba(13, 17, 23, 0.8); +} +.verdict--sanctified { color: #00E57A; } +.verdict--trace { color: #4D9FFF; } +.verdict--quarantine { color: #F5C842; } +.verdict--grave { color: #FF9A3C; } +.verdict--condemned { color: #FF4F5E; } +``` + +### Sentinel Cell Chip + +```html +⬑ VanguardProbe +``` + +```css +.sentinel-chip { + display: inline-flex; + align-items: center; + gap: 0.4em; + padding: 0.2em 0.6em; + border: 1px solid #C9A84C44; + border-radius: 4px; + background: #1C2433; + color: #C9A84C; + font-family: 'Inter', system-ui, sans-serif; + font-size: 0.8125rem; + font-weight: 500; +} +``` + +### Card / Panel + +```css +.panel { + background: #1C2433; + border: 1px solid #C9A84C22; + border-top: 2px solid #C9A84C; + border-radius: 6px; + padding: 1.5rem; +} +``` + +### Alert / Notice + +```css +.alert { + padding: 1rem 1.25rem; + border-left: 4px solid var(--alert-color, #C9A84C); + background: color-mix(in srgb, var(--alert-color, #C9A84C) 8%, #0D1117); + border-radius: 0 4px 4px 0; +} +``` + +--- + +## 5. Grid & Layout Architecture + +The Ethos Aegis visual style incorporates a **technical grid overlay** β€” a subtle dot or line grid that references both circuit boards and cellular biology. + +```css +.grid-background { + background-image: + radial-gradient(circle, #C9A84C18 1px, transparent 1px); + background-size: 28px 28px; + background-position: 0 0; +} +``` + +Primary layouts use an **8-column grid** at 1280px max-width with 24px gutters. + +--- + +## 6. Iconography + +- **Shield** β€” The primary icon; represents immune defense and verification +- **Hexagon** β€” Represents sentinel cells (biological/honeycomb) +- **DNA helix** β€” Represents the agentic pipeline lineage +- **Viral sphere** β€” Represents threat actors (Maligna classes) +- **Checkmark / X** β€” Verdict outcome indicators + +All icons should be monoline or filled at 2px stroke weight, in SVG format at 24Γ—24px base size. + +--- + +## 7. Voice & Tone + +| Attribute | Description | +|---|---| +| **Authoritative** | Speaks with precision; no ambiguity in verdicts | +| **Clinical** | Technical, factual; avoids marketing hyperbole | +| **Biomimetic** | Uses biological metaphor (cells, organisms, immune response) | +| **Vigilant** | Assumes adversarial context by default | +| **Principled** | Every decision is traceable to an ethical axiom | + +### Writing Examples + +βœ“ **Correct:** "VanguardProbe detected a MoralMaligna pattern in the upstream agent context." +βœ— **Incorrect:** "We found a potential issue that might be a problem." + +βœ“ **Correct:** "Verdict: Condemned. Confidence: 0.94. Threat Class: SystemicMaligna." +βœ— **Incorrect:** "This looks bad. We're not sure but it could be dangerous." + +--- + +## 8. Application Examples + +### GitHub Repository + +- **Repository description:** Use the tagline: *"Agentic Immune Verification β€” defending AI pipelines through biomimetic trust architecture."* +- **Topics:** `ai-safety`, `llm`, `verification`, `immune-system`, `agentic`, `ethics` +- **Social preview:** Use `brand/social_banner.svg` +- **Favicon / avatar:** Use `brand/favicon.svg` + +### README Badges + +```markdown +![Verdict](https://img.shields.io/badge/verdict-sanctified-00E57A?style=flat-square&logo=shield&logoColor=white) +![Threat Class](https://img.shields.io/badge/threat-none-0D1117?style=flat-square) +![Sentinel](https://img.shields.io/badge/sentinel-VanguardProbe-C9A84C?style=flat-square) +``` + +### Issue Labels + +All GitHub issues use branded labels from `.github/scripts/setup_labels.sh`. Verdict labels use their corresponding palette colors; sentinel cell labels use gold-family tones; threat labels use severity-mapped colors. + +--- + +## 9. Dark Mode + +All Ethos Aegis interfaces are **dark-first**. The light-mode variant is a secondary consideration using inverted foreground/background with the same accent palette. + +```css +@media (prefers-color-scheme: light) { + :root { + --bg-base: #F5F0E8; + --bg-surface: #EDE7D9; + --text-primary: #0D1117; + --text-secondary: #1C2433; + --accent-primary: #8B6E2A; /* darker gold for light bg contrast */ + --accent-green: #00804A; + --accent-red: #C0002A; + } +} +``` + +--- + +*Last updated: 2026 β€” Ethos Aegis Branding v1.0* diff --git a/brand/claude-mythos-brand-kit.md b/brand/claude-mythos-brand-kit.md new file mode 100644 index 0000000000..c9ee07ee59 --- /dev/null +++ b/brand/claude-mythos-brand-kit.md @@ -0,0 +1,45 @@ +# Claude Mythos Brand Kit + +## Name +Claude Mythos + +## System pairing +Veriflow Immune System + +## Tagline +Trust the verified path. + +## Archetype +Sentinel-Archivist + +## Voice +- precise +- symbolic +- calm +- evidence-led +- defensive + +## Motifs +- lattice +- shield +- pulse +- signal +- proof + +## Suggested palette +- Obsidian: `#0B1020` +- Aegis Blue: `#275EFE` +- Signal Cyan: `#22D3EE` +- Archive Gold: `#F5B700` +- Quiet Ash: `#D1D5DB` + +## Usage rules +- Always foreground verification and provenance. +- Treat the system as adaptive, not mystical. +- Keep all security language defensive. +- Distinguish observed capabilities from inferred capabilities. + +## Default runtime posture +- `probe_on_startup=True` +- `fingerprint_mode="auto"` +- use `datastore_lightweight` only when row freshness is critical diff --git a/brand/color_scheme.md b/brand/color_scheme.md new file mode 100644 index 0000000000..93e564fbc7 --- /dev/null +++ b/brand/color_scheme.md @@ -0,0 +1,160 @@ +# Ethos Aegis Color System + +## Primary Brand Colors + +### Gold / Aureate (Primary Accent) +- **Name:** Aureate Gold +- **Hex:** #C9A84C +- **RGB:** (201, 168, 76) +- **Usage:** Primary accent, primary call-to-action, emphasis + +### Deep Black (Background) +- **Name:** Void Black +- **Hex:** #0D1117 +- **RGB:** (13, 17, 23) +- **Usage:** Primary background, text contrast + +### Emerald Green (Vitality / Sanctified) +- **Name:** Sanctified Green +- **Hex:** #00E57A +- **RGB:** (0, 229, 122) +- **Usage:** Success states, "sanctified" verdicts, vitality indicators + +### Crimson Red (Danger / Condemned) +- **Name:** Condemned Crimson +- **Hex:** #FF4F5E +- **RGB:** (255, 79, 94) +- **Usage:** Critical threats, "condemned" verdicts, error states + +## Secondary Colors + +### Burnt Orange (Grave Threat) +- **Name:** Grave Orange +- **Hex:** #FF9A3C +- **RGB:** (255, 154, 60) +- **Usage:** Grave severity threats, warnings, caution states + +### Pale Gold (Tertiary Accent) +- **Name:** Pale Aureate +- **Hex:** #E8C96A +- **RGB:** (232, 201, 106) +- **Usage:** Secondary accent, highlights, supporting elements + +### Dusty Gold (Quarantine) +- **Name:** Quarantine Gold +- **Hex:** #F5C842 +- **RGB:** (245, 200, 66) +- **Usage:** Quarantined state, under-review, suspended + +### Sky Blue (Trace / Information) +- **Name:** Trace Blue +- **Hex:** #4D9FFF +- **RGB:** (77, 159, 255) +- **Usage:** Trace severity, informational, links + +### Slate Gray (Neutral) +- **Name:** Slate Gray +- **Hex:** #6B7A90 +- **RGB:** (107, 122, 144) +- **Usage:** Secondary text, borders, inactive states + +### Charcoal Gray (Secondary Neutral) +- **Name:** Charcoal Gray +- **Hex:** #9BAAB8 +- **RGB:** (155, 170, 184) +- **Usage:** Tertiary text, dividers, muted elements + +### Ink Black (Text) +- **Name:** Ink Black +- **Hex:** #1C2433 +- **RGB:** (28, 36, 51) +- **Usage:** Primary text on light backgrounds, deep elements + +## Color Usage by Context + +### Verdict States +| State | Color | Hex | +|-------|-------|-----| +| **Sanctified** | Sanctified Green | #00E57A | +| **Trace** | Trace Blue | #4D9FFF | +| **Quarantined** | Quarantine Gold | #F5C842 | +| **Grave** | Grave Orange | #FF9A3C | +| **Condemned** | Condemned Crimson | #FF4F5E | + +### Sentinel Cells +| Cell | Primary Color | Secondary Color | +|------|---------------|-----------------| +| VanguardProbe | Aureate Gold | #C9A84C | +| TaintBeacon | Pale Aureate | #E8C96A | +| SanitasSwarm | Dusty Brown | #8B6E2A | +| LogosScythe | Slate Gray | #9BAAB8 | +| MnemosyneCache | Charcoal | #6B7A90 | +| EntropicWatch | Trace Blue | #4D9FFF | +| FinalityForge | Condemned Crimson | #FF4F5E | +| CytokineCommand | Aureate Gold | #C9A84C | + +### Threat Classes +| Threat | Color | Hex | +|--------|-------|-----| +| MoralMaligna | Condemned Crimson | #FF4F5E | +| NarcissisMaligna | Grave Orange | #FF9A3C | +| ParasiticMaligna | Quarantine Gold | #F5C842 | +| SymbolicMaligna | Trace Blue | #4D9FFF | +| NaturalMaligna | Charcoal Gray | #6B7A90 | +| MetaMaligna | Slate Gray | #9BAAB8 | +| SystemicMaligna | Aureate Gold | #C9A84C | + +## Tertiary Colors β€” Earth Tones + +### Bronze (Ancient Strength) +- **Name:** Ancient Bronze +- **Hex:** #8B6E2A +- **RGB:** (139, 110, 42) +- **Usage:** SanitasSwarm cell identity, legacy system indicators, historic audit trails + +### Sage (Calm Intelligence) +- **Name:** Sage Slate +- **Hex:** #6B7A90 +- **RGB:** (107, 122, 144) +- **Usage:** MnemosyneCache identity, neutral observations, stable state borders + +### Warm Cream (Highlighted Knowledge) +- **Name:** Warm Cream +- **Hex:** #E8C96A +- **RGB:** (232, 201, 106) +- **Usage:** TaintBeacon highlights, soft emphasis, knowledge retrieval indicators + +## Accessibility + +- **Contrast Ratios:** + - Gold on Black: 7.2:1 (AAA compliant) + - Green on Black: 8.1:1 (AAA compliant) + - Red on Black: 4.8:1 (AA compliant) + - Blue on Black: 5.6:1 (AA compliant) + +- **Color-Blind Safe:** All verdict states include supporting iconography and text labels, not relying on color alone. + +## CSS Variables + +```css +:root { + --color-primary-gold: #C9A84C; + --color-primary-black: #0D1117; + --color-primary-green: #00E57A; + --color-primary-red: #FF4F5E; + + --color-secondary-orange: #FF9A3C; + --color-secondary-pale-gold: #E8C96A; + --color-secondary-quarantine: #F5C842; + --color-secondary-blue: #4D9FFF; + --color-secondary-slate: #6B7A90; + --color-secondary-charcoal: #9BAAB8; + --color-secondary-ink: #1C2433; + + --color-verdict-sanctified: #00E57A; + --color-verdict-trace: #4D9FFF; + --color-verdict-quarantined: #F5C842; + --color-verdict-grave: #FF9A3C; + --color-verdict-condemned: #FF4F5E; +} +``` \ No newline at end of file diff --git a/brand/favicon.svg b/brand/favicon.svg new file mode 100644 index 0000000000..e7e24b2209 --- /dev/null +++ b/brand/favicon.svg @@ -0,0 +1,33 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/brand/github-partner-branding-kit.md b/brand/github-partner-branding-kit.md new file mode 100644 index 0000000000..6aa03342d2 --- /dev/null +++ b/brand/github-partner-branding-kit.md @@ -0,0 +1,51 @@ +# GitHub Partner Branding Kit + +## Positioning +Ethos Aegis Γ— Claude Mythos presents Veriflow as a defensive, evidence-led reasoning system for CKAN-backed and normalized data. + +## Recommended GitHub description +Host-aware verification and formula generation for CKAN data with the Veriflow immune system. + +## Recommended social preview headline +Trust the verified path. + +## Recommended topics +- ckan +- data-portal +- verification +- reasoning-engine +- security-by-design +- provenance +- formula-engine +- python + +## Badge set +```md +![Verification First](https://img.shields.io/badge/verification-first-275EFE) +![Fingerprint Mode](https://img.shields.io/badge/fingerprint-auto-22D3EE) +![Defensive Runtime](https://img.shields.io/badge/runtime-defensive-F5B700) +``` + +## Partner voice +- precise +- calm +- evidence-led +- host-aware +- defensive by design + +## Repo pinning suggestion +Pin together: +1. Ethos-Aegis-Agentic-Immune-Veriflow +2. veriflow-Sovereign-Lattice +3. Traceability-Matrix + +## Release naming pattern +`mythos-aegis-v.` + +## Visual pairings +- primary wordmark: `assets/brand/claude-mythos-wordmark.svg` +- lockup: `assets/brand/ethos-aegis-mythos-lockup.svg` +- interactive demo: `interactive/mythos_control_panel.html` + +## Partner profile snippet +Claude Mythos is the identity layer. Ethos Aegis is the defensive framework. Veriflow is the answer engine. Together they turn live data surfaces into replayable, evidence-backed answers. diff --git a/brand/github-social-preview-kit.md b/brand/github-social-preview-kit.md new file mode 100644 index 0000000000..f579d391a1 --- /dev/null +++ b/brand/github-social-preview-kit.md @@ -0,0 +1,23 @@ +# GitHub Social Preview Kit + +## Purpose +This pack provides repository-safe preview assets and copy blocks for GitHub social cards, release posts, and partner shares. + +## Included assets +- `assets/social/ethos-aegis-mythos-social-card.svg` +- `assets/social/ethos-aegis-mythos-banner.svg` +- `assets/social/claude-mythos-avatar-badge.svg` + +## Suggested repo social preview title +Ethos Aegis Γ— Claude Mythos + +## Suggested repo social preview subtitle +Host-aware verification and formula generation for CKAN-backed data. + +## Suggested release post line +Trust the verified path. + +## Use notes +- Prefer the social card for repository preview images. +- Prefer the banner for README embeds or external partner decks. +- Prefer the avatar badge for profile, organization, or discussion-thread graphics. diff --git a/brand/logo.svg b/brand/logo.svg new file mode 100644 index 0000000000..2f6c6a23dd --- /dev/null +++ b/brand/logo.svg @@ -0,0 +1,65 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ETHOS AEGIS + + + + + + AGENTIC IMMUNE VERIFLOW + + + + + + diff --git a/brand/social_banner.svg b/brand/social_banner.svg new file mode 100644 index 0000000000..8896f2be47 --- /dev/null +++ b/brand/social_banner.svg @@ -0,0 +1,161 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ETHOS AEGIS + + + + + + AGENTIC IMMUNE VERIFLOW + + + Biomimetic AI Trust Architecture Β· Sentinel Verification Β· Immune Pipeline Defense + + + + + + βœ“ SANCTIFIED + + + + + ⚠ GRAVE + + + + + βœ— CONDEMNED + + + + + ~ TRACE + + + github.com/GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow + diff --git a/brand/tokens.css b/brand/tokens.css new file mode 100644 index 0000000000..29fbbb99b2 --- /dev/null +++ b/brand/tokens.css @@ -0,0 +1,252 @@ +/** + * Ethos Aegis Design Tokens + * Brand color system exported as CSS custom properties. + * + * Usage: + * @import url('brand/tokens.css'); + * + * .my-element { color: var(--color-primary-gold); } + * + * Dark mode is the default (dark-first design). + * Light mode overrides are provided in the @media block at the bottom. + */ + +/* ============================================================ + BASE TOKENS β€” Raw value definitions + ============================================================ */ + +:root { + /* --- Primary Palette --- */ + --palette-gold: #C9A84C; + --palette-void: #0D1117; + --palette-green: #00E57A; + --palette-crimson: #FF4F5E; + + /* --- Secondary Palette --- */ + --palette-orange: #FF9A3C; + --palette-pale-gold: #E8C96A; + --palette-dusty-gold: #F5C842; + --palette-blue: #4D9FFF; + --palette-slate: #6B7A90; + --palette-gray: #9BAAB8; + --palette-ink: #1C2433; + + /* --- Tertiary β€” Earth Tones --- */ + --palette-bronze: #8B6E2A; + /* + * NOTE: sage and slate share the hex value #6B7A90 as defined in the + * Ethos Aegis color specification (see brand/color_scheme.md). They are + * intentionally the same neutral-blue-grey, distinguished only by their + * semantic role: --palette-slate is a structural/border neutral whereas + * --palette-sage denotes the MnemosyneCache sentinel cell identity. + * Both tokens are kept so that downstream code remains semantically clear. + */ + --palette-sage: #6B7A90; + /* + * NOTE: cream and pale-gold share the hex value #E8C96A as defined in the + * color specification. pale-gold is the general secondary accent; cream is + * the warm-highlight earth-tone specifically referenced as the tertiary + * palette entry. Both tokens are retained for semantic clarity. + */ + --palette-cream: #E8C96A; +} + + +/* ============================================================ + SEMANTIC COLOR TOKENS β€” Dark mode (default) + ============================================================ */ + +:root { + /* Background layers */ + --color-bg-base: var(--palette-void); /* #0D1117 β€” page background */ + --color-bg-surface: var(--palette-ink); /* #1C2433 β€” card / panel */ + --color-bg-elevated: #242F3F; /* elevated surface, modals */ + --color-bg-sunken: #080D12; /* code blocks, inset areas */ + --color-bg-overlay: rgba(13, 17, 23, 0.85); /* modal scrim */ + + /* Text */ + --color-text-primary: var(--palette-pale-gold); /* #E8C96A β€” main body text on dark */ + --color-text-secondary: var(--palette-gray); /* #9BAAB8 β€” secondary / muted text */ + --color-text-tertiary: var(--palette-slate); /* #6B7A90 β€” placeholder, disabled */ + --color-text-inverse: var(--palette-void); /* for text on light/gold backgrounds */ + --color-text-code: var(--palette-green); /* #00E57A β€” code & monospace */ + --color-text-link: var(--palette-blue); /* #4D9FFF β€” links */ + + /* Brand accents */ + --color-primary-gold: var(--palette-gold); /* #C9A84C */ + --color-primary-black: var(--palette-void); /* #0D1117 */ + --color-primary-green: var(--palette-green); /* #00E57A */ + --color-primary-red: var(--palette-crimson); /* #FF4F5E */ + + /* Secondary accents */ + --color-secondary-orange: var(--palette-orange); /* #FF9A3C */ + --color-secondary-pale-gold: var(--palette-pale-gold); /* #E8C96A */ + --color-secondary-quarantine: var(--palette-dusty-gold); /* #F5C842 */ + --color-secondary-blue: var(--palette-blue); /* #4D9FFF */ + --color-secondary-slate: var(--palette-slate); /* #6B7A90 */ + --color-secondary-charcoal: var(--palette-gray); /* #9BAAB8 */ + --color-secondary-ink: var(--palette-ink); /* #1C2433 */ + + /* Tertiary β€” Earth Tones */ + --color-tertiary-bronze: var(--palette-bronze); /* #8B6E2A */ + --color-tertiary-sage: var(--palette-sage); /* #6B7A90 */ + --color-tertiary-cream: var(--palette-cream); /* #E8C96A */ + + /* Borders */ + --color-border-subtle: rgba(201, 168, 76, 0.13); /* faint gold rule */ + --color-border-default: rgba(201, 168, 76, 0.25); /* standard border */ + --color-border-strong: rgba(201, 168, 76, 0.55); /* emphasized border */ + --color-border-danger: rgba(255, 79, 94, 0.45); /* error border */ + --color-border-success: rgba(0, 229, 122, 0.45); /* success border */ + + /* Interactive states */ + --color-focus-ring: rgba(201, 168, 76, 0.6); + --color-hover-overlay: rgba(201, 168, 76, 0.06); + --color-active-overlay: rgba(201, 168, 76, 0.12); + + /* ---- Verdict State Colors ---- */ + --color-verdict-sanctified: var(--palette-green); /* #00E57A */ + --color-verdict-trace: var(--palette-blue); /* #4D9FFF */ + --color-verdict-quarantined: var(--palette-dusty-gold); /* #F5C842 */ + --color-verdict-grave: var(--palette-orange); /* #FF9A3C */ + --color-verdict-condemned: var(--palette-crimson); /* #FF4F5E */ + + /* Verdict backgrounds (tinted) */ + --color-verdict-sanctified-bg: rgba(0, 229, 122, 0.08); + --color-verdict-trace-bg: rgba(77, 159, 255, 0.08); + --color-verdict-quarantined-bg: rgba(245, 200, 66, 0.08); + --color-verdict-grave-bg: rgba(255, 154, 60, 0.08); + --color-verdict-condemned-bg: rgba(255, 79, 94, 0.08); + + /* ---- Sentinel Cell Colors ---- */ + --color-cell-vanguard-probe: var(--palette-gold); /* #C9A84C */ + --color-cell-taint-beacon: var(--palette-cream); /* #E8C96A */ + --color-cell-sanitas-swarm: var(--palette-bronze); /* #8B6E2A */ + --color-cell-logos-scythe: var(--palette-gray); /* #9BAAB8 */ + --color-cell-mnemosyne-cache: var(--palette-sage); /* #6B7A90 */ + --color-cell-entropic-watch: var(--palette-blue); /* #4D9FFF */ + --color-cell-finality-forge: var(--palette-crimson); /* #FF4F5E */ + --color-cell-cytokine-command: var(--palette-gold); /* #C9A84C */ + + /* ---- Threat Class Colors ---- */ + --color-threat-moral: var(--palette-crimson); /* MoralMaligna β€” #FF4F5E */ + --color-threat-narcissis: var(--palette-orange); /* NarcissisMaligna β€” #FF9A3C */ + --color-threat-parasitic: var(--palette-dusty-gold); /* ParasiticMaligna β€” #F5C842 */ + --color-threat-symbolic: var(--palette-blue); /* SymbolicMaligna β€” #4D9FFF */ + --color-threat-natural: var(--palette-sage); /* NaturalMaligna β€” #6B7A90 */ + --color-threat-meta: var(--palette-gray); /* MetaMaligna β€” #9BAAB8 */ + --color-threat-systemic: var(--palette-gold); /* SystemicMaligna β€” #C9A84C */ + + /* ---- Semantic Utility Colors ---- */ + --color-success: var(--palette-green); /* #00E57A */ + --color-warning: var(--palette-dusty-gold); /* #F5C842 */ + --color-danger: var(--palette-crimson); /* #FF4F5E */ + --color-info: var(--palette-blue); /* #4D9FFF */ + --color-caution: var(--palette-orange); /* #FF9A3C */ + + /* ---- Decorative Grid Pattern ---- */ + --pattern-grid-dot-color: rgba(201, 168, 76, 0.12); + --pattern-grid-size: 28px; + + /* ---- Typography Tokens ---- */ + --font-serif: 'EB Garamond', 'Cormorant Garamond', Georgia, serif; + --font-sans: 'Inter', 'IBM Plex Sans', system-ui, -apple-system, sans-serif; + --font-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace; + + --font-size-display: 3rem; /* 48px */ + --font-size-h1: 2.25rem; /* 36px */ + --font-size-h2: 1.75rem; /* 28px */ + --font-size-h3: 1.375rem; /* 22px */ + --font-size-body: 1rem; /* 16px */ + --font-size-small: 0.8125rem; /* 13px */ + --font-size-code: 0.875rem; /* 14px */ + + --font-weight-normal: 400; + --font-weight-medium: 500; + --font-weight-semibold: 600; + --font-weight-bold: 700; + + --line-height-tight: 1.25; + --line-height-normal: 1.6; + --line-height-relaxed: 1.8; + + --letter-spacing-tight: -0.01em; + --letter-spacing-normal: 0; + --letter-spacing-wide: 0.04em; + --letter-spacing-wider: 0.08em; + --letter-spacing-widest: 0.14em; + + /* ---- Spacing Scale ---- */ + --space-1: 0.25rem; /* 4px */ + --space-2: 0.5rem; /* 8px */ + --space-3: 0.75rem; /* 12px */ + --space-4: 1rem; /* 16px */ + --space-5: 1.25rem; /* 20px */ + --space-6: 1.5rem; /* 24px */ + --space-8: 2rem; /* 32px */ + --space-10: 2.5rem; /* 40px */ + --space-12: 3rem; /* 48px */ + --space-16: 4rem; /* 64px */ + + /* ---- Border Radius ---- */ + --radius-sm: 3px; + --radius-md: 6px; + --radius-lg: 12px; + --radius-xl: 20px; + --radius-pill: 9999px; + + /* ---- Shadows ---- */ + --shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.4); + --shadow-md: 0 4px 12px rgba(0, 0, 0, 0.5); + --shadow-lg: 0 8px 28px rgba(0, 0, 0, 0.6); + --shadow-gold: 0 0 20px rgba(201, 168, 76, 0.18); + --shadow-glow: 0 0 30px rgba(0, 229, 122, 0.15); + + /* ---- Transitions ---- */ + --transition-fast: 150ms ease; + --transition-normal: 250ms ease; + --transition-slow: 400ms ease; +} + + +/* ============================================================ + LIGHT MODE OVERRIDES + Only backgrounds, text, and borders shift; accent palette + remains consistent but darkened for sufficient contrast. + ============================================================ */ + +@media (prefers-color-scheme: light) { + :root { + --color-bg-base: #F5F0E8; + --color-bg-surface: #EDE7D9; + --color-bg-elevated: #FFFFFF; + --color-bg-sunken: #E0DAD0; + --color-bg-overlay: rgba(245, 240, 232, 0.9); + + --color-text-primary: #0D1117; + --color-text-secondary: #1C2433; + --color-text-tertiary: #4A5568; + --color-text-inverse: #F5F0E8; + --color-text-code: #006B3A; + --color-text-link: #1A5FAA; + + /* Darken accents for light backgrounds */ + --color-primary-gold: #8B6E2A; /* bronze replaces gold for contrast */ + --color-primary-green: #00804A; + --color-primary-red: #C0002A; + + --color-secondary-orange: #B55E00; + --color-secondary-pale-gold: #7A5C1E; + --color-secondary-quarantine: #8B7000; + --color-secondary-blue: #1A5FAA; + + --color-border-subtle: rgba(139, 110, 42, 0.15); + --color-border-default: rgba(139, 110, 42, 0.30); + --color-border-strong: rgba(139, 110, 42, 0.60); + + --pattern-grid-dot-color: rgba(139, 110, 42, 0.10); + + --shadow-gold: 0 0 20px rgba(139, 110, 42, 0.12); + --shadow-glow: 0 0 30px rgba(0, 128, 74, 0.10); + } +} diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000000..c80a1e8db5 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,24 @@ +version: "3.9" + +services: + dev: + image: python:3.11-slim + working_dir: /app + volumes: + - .:/app + command: bash -c "pip install -r requirements.txt && pytest tests/ -q" + environment: + - PYTHONDONTWRITEBYTECODE=1 + - PYTHONUNBUFFERED=1 + + worker: + image: node:18-alpine + working_dir: /app + volumes: + - .:/app + - /app/node_modules + command: sh -c "npm install && npm run worker:dev" + ports: + - "8787:8787" + environment: + - NODE_ENV=development diff --git a/docs/MERGE_INTEGRATION.md b/docs/MERGE_INTEGRATION.md new file mode 100644 index 0000000000..e8d6770f5f --- /dev/null +++ b/docs/MERGE_INTEGRATION.md @@ -0,0 +1,46 @@ +# Merge Integration Guide + +This document records the intended merge path for bringing `veriflow-Sovereign-Lattice` into `Ethos-Aegis-Agentic-Immune-Veriflow` while preserving commit history. + +## Purpose + +- consolidate related project surfaces into one repository +- preserve repository history instead of copying files manually +- simplify contributor onboarding and shared CI +- keep Ethos Aegis, Veriflow, and Mythos work discoverable in one place + +## Merge model + +The destination repository is: +- `GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow` + +The source repository is: +- `GoodshytGroup/veriflow-Sovereign-Lattice` + +The histories are unrelated, so the integration should be performed as a history-preserving merge rather than a file copy. + +## Expected outcome + +After the merge, the destination repository should contain: +- the existing Ethos Aegis runtime surface +- the Veriflow reasoning surface +- the prompt, schema, and policy-pack assets needed for agentic development + +## Integration notes + +- resolve root-level collisions intentionally +- preserve docs that explain where each surface originated +- prefer explicit directories for imported project surfaces when conflicts appear +- reconcile CI in stages instead of forcing every legacy surface green at once +- keep project-native documentation ahead of generic fork content + +## History note + +Because unrelated histories are being joined, history navigation across the merge boundary will need the merge commit as an anchor for later inspection. + +## Recommended follow-up after merge + +- repair the repo landing page +- reconcile overlapping workflows +- keep plugin cleanup separate from runtime repair work +- document the merged architecture in one project-native overview diff --git a/docs/agentic_repo_roadmap.md b/docs/agentic_repo_roadmap.md new file mode 100644 index 0000000000..65550a3980 --- /dev/null +++ b/docs/agentic_repo_roadmap.md @@ -0,0 +1,32 @@ +# Agentic Repo Roadmap + +This roadmap identifies the strongest next moves to make the repository more coherent, more attractive to contributors, and more trustworthy as an agentic systems project. + +## Near-term + +1. Repair Mythos runtime Python 3.9 compatibility. +2. Scope CI lint and tests to the new package surface until legacy plugin debt is addressed separately. +3. Repair the repo landing page so it reflects Ethos Aegis, Veriflow, and Claude Mythos rather than the generic fork root. +4. Add a watcher/orchestrator integration path for encrypted signed policy packs. + +## Mid-term + +1. Add a local policy-pack editor and verifier. +2. Add stateful host capability caching for CKAN-backed reasoning. +3. Add prompt families for repo audit, CKAN reasoning, and runtime scaffolding. +4. Add reproducible sample policy packs and validation scripts. + +## Long-term + +1. Add stronger cryptographic agility notes and post-quantum migration planning. +2. Add local orchestrator runtime state loading from verified decrypted packs. +3. Add richer evaluation harnesses for safe autonomy and human approval gates. +4. Add repo-specific branding assets and a project-native landing page. + +## Design principles + +- verify before acting +- preserve provenance +- prefer least privilege +- separate policy, execution, and memory layers +- keep unsafe or high-impact actions behind approval boundaries diff --git a/docs/branding/celestial_agent_brand_kit.md b/docs/branding/celestial_agent_brand_kit.md new file mode 100644 index 0000000000..5d7c7f6008 --- /dev/null +++ b/docs/branding/celestial_agent_brand_kit.md @@ -0,0 +1,49 @@ +# Celestial Agent Branding Kit + +Brand system created for **TDD**. + +## Core tagline +Encrypted intelligence, permissioned by design. + +## Positioning line +Celestial Agent turns secure orchestration into a visible product system: branded, signed, encrypted, and ready for operator trust. + +## Elevator pitch +Celestial Agent is a local-first agent runtime identity built for high-trust AI systems. It combines encrypted policy packs, signed manifests, and permissioned execution into a product language that feels premium, technical, and controlled. + +## Palette +- Obsidian: `#0B1020` +- Midnight: `#121A33` +- Aether: `#1D2D5A` +- Cyan: `#59E3FF` +- Aurora: `#37FFC8` +- Violet: `#8B6CFF` +- Silver: `#A9B7D1` +- Cloud: `#F5F8FF` +- Ink: `#EAF1FF` + +## Tone +- secure +- futuristic +- controlled +- clear +- high-trust + +## Website hero copy +### Headline +Secure agent orchestration with a premium identity. + +### Subhead +Celestial Agent packages encryption, signatures, and permissioned execution into a system users can trust at a glance. + +## CTA options +- Launch the runtime +- Verify the pack +- Encrypt the spec +- Load with confidence + +## Recommended use in the merged repo +- use Celestial Agent as the trust-layer identity for encrypted policy packs +- preserve Ethos Aegis as the system architecture name +- preserve Veriflow as the host-aware reasoning surface +- use project-native docs instead of leaving generic fork branding at the repo root diff --git a/docs/claude-mythos-veriflow-scaffold.md b/docs/claude-mythos-veriflow-scaffold.md new file mode 100644 index 0000000000..ab018e0b06 --- /dev/null +++ b/docs/claude-mythos-veriflow-scaffold.md @@ -0,0 +1,37 @@ +# Claude Mythos Γ— Veriflow Scaffold Guide + +## Goal +This scaffold layers a Mythos identity onto the existing Veriflow immune system so the repository has a consistent operational contract, brand vocabulary, and onboarding surface. + +## Stack +- Ethos Aegis core +- Veriflow immune system +- CKAN capability probing +- capability-aware ingestion +- deterministic validation +- formula selection and answer generation + +## Recommended startup defaults +- `probe_on_startup=True` +- `fingerprint_mode="auto"` +- use `datastore_lightweight` only when row-level freshness matters more than probe cost + +## Expected output shape +```json +{ + "host_profile": "schema-rich+datastore", + "ckan_version": "2.11.x", + "ingestion_path": "datastore", + "formula": "ctr = clicks / impressions", + "limitations": ["sampled row signature used"] +} +``` + +## Brand position +Claude Mythos is not a separate model implementation here. It is a branded scaffold and operating identity wrapped around the current Veriflow immune runtime. + +## Suggested next repo additions +- examples/mythos_startup.py +- assets/brand/wordmark.svg +- docs/decision-records/0001-mythos-identity.md +- tests/test_mythos_brand_contract.py diff --git a/docs/decision-records/0001-mythos-identity.md b/docs/decision-records/0001-mythos-identity.md new file mode 100644 index 0000000000..4f8429e948 --- /dev/null +++ b/docs/decision-records/0001-mythos-identity.md @@ -0,0 +1,27 @@ +# ADR 0001: Introduce Claude Mythos as the identity layer + +## Status +Accepted + +## Context +The repository already contains the Veriflow immune runtime and CKAN-aware ingestion pipeline. It did not yet have a stable identity layer for onboarding, brand consistency, or runtime doctrine. + +## Decision +Add Claude Mythos as a branded scaffold and identity layer, not as a separate model implementation. + +## Consequences +Positive: +- clearer onboarding +- reusable brand and voice rules +- explicit runtime defaults +- stronger connection between Veriflow and external presentation + +Tradeoffs: +- one more identity surface to maintain +- risk of brand language drifting from runtime behavior if not reviewed periodically + +## Operational defaults +- probe at startup +- capability-aware ingestion +- default fingerprint mode is `auto` +- use `datastore_lightweight` only for freshness-sensitive row monitoring diff --git a/docs/integrations/pinkybot_daemon_adapter.md b/docs/integrations/pinkybot_daemon_adapter.md new file mode 100644 index 0000000000..b0a8ac4904 --- /dev/null +++ b/docs/integrations/pinkybot_daemon_adapter.md @@ -0,0 +1,61 @@ +# PinkyBot Daemon Adapter + +This document describes a thin adapter model for connecting a PinkyBot-style daemon to Ethos runtime surfaces. + +## Goal + +Translate persistent companion-agent operations into approved Ethos runtime calls without collapsing the boundary between: + +- persistent agent state +- runtime execution tools +- memory storage +- messaging adapters +- approval-gated actions + +## Suggested adapter surfaces + +### Agent registry bridge +Map named PinkyBot agents to approved local runtime profiles. + +### Memory bridge +Expose only explicit durable-memory operations: +- reflect +- recall +- introspect + +### Messaging bridge +Allow outbound messaging only through a permission-aware adapter. + +### Scheduler bridge +Allow wake triggers to enqueue runtime work instead of directly executing privileged actions. + +## Internal event shape + +```json +{ + "agent": "pinkybot-companion", + "source": "telegram", + "trigger": "message", + "action": "wake", + "approval_required": false, + "payload": { + "content": "hello" + } +} +``` + +## Guardrails + +- never give the daemon unrestricted execution rights +- keep approvals explicit for external messaging, calendar writes, or sensitive exports +- treat model output as untrusted until validated +- log every daemon-to-runtime handoff + +## First implementation target + +A safe first adapter should support: +- create / wake / chat lifecycle docs +- Telegram inbound message wake events +- memory reflection and recall +- activity logging +- no destructive or financial actions diff --git a/docs/integrations/pinkybot_integration.md b/docs/integrations/pinkybot_integration.md new file mode 100644 index 0000000000..b675e80c5b --- /dev/null +++ b/docs/integrations/pinkybot_integration.md @@ -0,0 +1,71 @@ +# PinkyBot Integration + +This document describes how to integrate **PinkyBot** into the Ethos Aegis ecosystem as a persistent companion-agent layer. + +## Intent + +PinkyBot adds a long-lived personal agent surface on top of the existing Ethos runtime work: + +- persistent named agents +- long-term memory +- scheduled wake cycles +- multi-platform messaging +- dashboard-driven management +- skills-based extensibility + +## Role in the Ethos stack + +- **Ethos Aegis** = core architecture umbrella +- **Claude Mythos** = runtime and scaffold layer +- **Veriflow** = host-aware reasoning and CKAN intelligence +- **Celestial Agent** = trust-layer identity for encrypted policy packs +- **PinkyBot** = persistent companion and outreach layer + +## Recommended boundary + +PinkyBot should not replace the core runtime. It should sit above it as a companion framework that can: + +1. wake agents on schedules or inbound events +2. route messages from Telegram, Slack, or Discord +3. persist cross-session memory +4. call into approved Ethos runtime tools +5. present a dashboard view over agent status and activity + +## Suggested integration points + +### Messaging +- Telegram bot token managed in settings +- Slack bot token managed in settings +- Discord bot token managed in settings +- outbound messaging routed through a dedicated MCP surface + +### Memory +- persistent memory should remain explicit and auditable +- store only approved long-term state +- separate working state from durable memory + +### Skills +- represent PinkyBot capabilities as skill modules +- allow companion agents to install task-specific skills +- keep skills permission-scoped and reviewable + +### Scheduling and triggers +- webhook wakes +- URL watcher wakes +- file watcher wakes +- heartbeat / dream cycles + +## Non-goals + +- unrestricted automation +- hidden access to user accounts +- bypassing approval gates for sensitive actions +- uncontrolled message sending + +## Recommended first implementation steps + +1. add a PinkyBot companion skill surface +2. add a PinkyBot agent profile example +3. add Telegram Mini App event mapping notes +4. add a thin API adapter document for daemon integration +5. keep runtime repair and feature expansion work separate from companion integration diff --git a/docs/integrations/telegram_mini_app_event_map.md b/docs/integrations/telegram_mini_app_event_map.md new file mode 100644 index 0000000000..2a7944390a --- /dev/null +++ b/docs/integrations/telegram_mini_app_event_map.md @@ -0,0 +1,69 @@ +# Telegram Mini App Event Map + +This note maps selected Telegram Mini App events into a safe PinkyBot + Ethos integration surface. + +## Use these first + +### Messaging and UI +- `web_app_ready` +- `web_app_close` +- `web_app_open_popup` +- `web_app_setup_main_button` +- `web_app_setup_back_button` +- `web_app_setup_settings_button` +- `web_app_trigger_haptic_feedback` + +### Permissioned access +- `web_app_request_write_access` +- `web_app_request_phone` +- `web_app_read_text_from_clipboard` +- `web_app_request_file_download` + +### Secure local state +- `web_app_secure_storage_save_key` +- `web_app_secure_storage_get_key` +- `web_app_secure_storage_restore_key` +- `web_app_secure_storage_clear` +- `web_app_device_storage_save_key` +- `web_app_device_storage_get_key` +- `web_app_device_storage_clear` + +### Sensors and environment +- `web_app_request_theme` +- `web_app_request_viewport` +- `web_app_request_safe_area` +- `web_app_request_content_safe_area` +- `web_app_check_location` +- `web_app_request_location` + +## Treat as high-risk or approval-gated + +- `payment_form_submit` +- `web_app_open_invoice` +- `web_app_set_emoji_status` +- `web_app_request_emoji_status_access` +- `web_app_invoke_custom_method` +- `web_app_open_link` +- `web_app_open_tg_link` + +## Integration rule + +Map Telegram events into an internal broker event shape before handing them to a PinkyBot-style daemon. Example internal shape: + +```json +{ + "platform": "telegram", + "event_type": "web_app_request_write_access", + "user_interaction_required": true, + "approval_required": true, + "payload": {} +} +``` + +## Recommended behavior + +- validate all event payloads before use +- gate high-impact actions behind explicit user interaction or approval +- persist only minimal necessary state +- prefer secure storage for secrets or tokens +- log every accepted event in the activity feed diff --git a/docs/merge_automation_and_branding.md b/docs/merge_automation_and_branding.md new file mode 100644 index 0000000000..c6ec83b9fc --- /dev/null +++ b/docs/merge_automation_and_branding.md @@ -0,0 +1,32 @@ +# Merge Automation and Branding + +This guide ties together the local history-preserving merge workflow and the Celestial Agent branding layer for the Ethos monorepo. + +## What this branch adds + +- `scripts/push-merge-runbook.sh` +- `docs/branding/celestial_agent_brand_kit.md` +- `assets/branding/celestial_agent/celestial_agent_logo_horizontal.svg` +- `assets/branding/celestial_agent/celestial_agent_mark_full.svg` + +## Intended use + +1. Run the merge helper locally from the destination repository. +2. Open the history-preserving merge PR into Ethos Aegis. +3. Preserve Veriflow as a named reasoning surface inside the merged repository. +4. Use the Celestial Agent brand assets as the trust-layer identity for encrypted policy packs, signed manifests, and local-first orchestration surfaces. + +## Branding model after merge + +- **Ethos Aegis** = system architecture and monorepo umbrella +- **Veriflow** = host-aware reasoning and CKAN intelligence layer +- **Claude Mythos** = runtime and prompt/scaffold identity +- **Celestial Agent** = encrypted policy-pack and trust-layer visual identity + +## Why this split works + +It lets the repository preserve technical clarity while still giving the secure runtime surfaces a premium, user-facing brand system. + +## Limits + +The GitHub connector can prepare scripts, docs, and assets, but the actual unrelated-history merge still has to be executed through git on a machine with repository access. diff --git a/docs/mythos_runtime_integration.md b/docs/mythos_runtime_integration.md new file mode 100644 index 0000000000..3e6abeb880 --- /dev/null +++ b/docs/mythos_runtime_integration.md @@ -0,0 +1,33 @@ +# Mythos Runtime Integration + +This repository now includes a Python-native Mythos runtime layer for local discipline around AI-assisted changes. + +## Included capabilities + +- **Strict Write Discipline (SWD)**: verifies claimed file writes against actual filesystem state. +- **Memory ledger**: appends verified write events and runtime events to `MEMORY.md`. +- **Drift detection**: compares current files against the last verified hashes stored in memory. +- **Budget meter**: lightweight token/turn guard for future agent loops. +- **CLI**: `python -m ethos_aegis.mythos_runtime.cli verify` and `dream`. + +## How it is wired into Veriflow + +`VeriflowImmuneSystem` now uses the Mythos runtime for host-state persistence. +When the system saves its CKAN host cache, it writes through SWD and records the verified write in `MEMORY.md`. +Resource refreshes are also logged as runtime events. + +## Example + +```python +from ethos_aegis.veriflow import CKANClient, VeriflowImmuneSystem + +ckan = CKANClient("https://demo.ckan.org") +immune = VeriflowImmuneSystem(ckan, probe_on_startup=False) +``` + +## CLI examples + +```bash +python -m ethos_aegis.mythos_runtime.cli --root . verify --json +python -m ethos_aegis.mythos_runtime.cli --root . dream --dry-run +``` diff --git a/docs/mythos_runtime_repair_plan.md b/docs/mythos_runtime_repair_plan.md new file mode 100644 index 0000000000..4f0ad93acc --- /dev/null +++ b/docs/mythos_runtime_repair_plan.md @@ -0,0 +1,32 @@ +# Mythos Runtime Repair Plan + +This patch set is intended to repair the Mythos runtime surface without touching unrelated plugin lint debt. + +## Scope +- `ethos_aegis/mythos_runtime/` +- `ethos_aegis/veriflow/` +- `tests/test_mythos_runtime.py` +- `.github/workflows/python-package.yml` + +## Required fixes +1. Remove `slots=True` from new dataclasses for Python 3.9 compatibility. +2. Remove unused `Mapping` imports. +3. Wrap long lines in the new package surface. +4. Reduce `DriftDetector.scan` complexity by extracting helper methods. +5. Update `actions/setup-python` from `@v3` to `@v5`. +6. Scope flake8 to the Mythos runtime surface only. +7. Run `pytest tests/test_mythos_runtime.py -q` instead of full-repo `pytest` in this workflow. + +## Files to modify +- `ethos_aegis/mythos_runtime/budget.py` +- `ethos_aegis/mythos_runtime/cli.py` +- `ethos_aegis/mythos_runtime/drift.py` +- `ethos_aegis/mythos_runtime/memory.py` +- `ethos_aegis/mythos_runtime/swd.py` +- `ethos_aegis/veriflow/ckan_adapter.py` +- `ethos_aegis/veriflow/immune_system.py` +- `tests/test_mythos_runtime.py` +- `.github/workflows/python-package.yml` + +## PR intent +Fix Python 3.9 compatibility and isolate CI to the new Mythos runtime package surface so unrelated plugin lint debt does not block validation. diff --git a/docs/phaseform_policy_packs.md b/docs/phaseform_policy_packs.md new file mode 100644 index 0000000000..559d1b97b2 --- /dev/null +++ b/docs/phaseform_policy_packs.md @@ -0,0 +1,82 @@ +# PhaseForm Encrypted Policy Packs + +This guide defines the repository's preferred structure for encrypted signed agent policy packs. + +## Goals + +- Keep the agent blueprint confidential at rest. +- bind creator attribution into the manifest. +- make tampering detectable. +- support replayable versioning across pack revisions. +- keep execution limited to a local permissioned workspace. + +## Supported pack formats + +### Split pack + +- `agent_spec.enc` +- `agent_manifest.json` +- `agent_manifest.sig` + +### Single-file JSON pack + +A `.enc` file may also contain a JSON object with: + +- `manifest` +- `ciphertext_b64` +- `nonce_b64` +- `salt_b64` +- `signature_b64` + +Runtime tooling should support both forms. + +## Canonical manifest fields + +```json +{ + "schema_version": "1.0", + "creator": "TDD", + "version": "0.1.0", + "public_key_b64": "...", + "spec_hash_sha256": "...", + "ciphertext_hash_sha256": "...", + "content_type": "agent_spec", + "nonce_b64": "...", + "salt_b64": "..." +} +``` + +## Security rules + +1. Never embed a default passphrase in source code. +2. Require the passphrase through environment or secure prompt entry. +3. Verify Ed25519 signatures before decryption. +4. Verify both ciphertext and plaintext hashes when present. +5. Quarantine invalid or partially written packs. +6. Decrypt only into controlled local workspace state. +7. Treat standards references as requirements alignment, not certification claims. + +## Repository conventions + +- place incoming encrypted payloads in `vault/` +- place split-pack manifests in `manifests/` +- write validated plaintext only into `decrypted/` +- move invalid inputs into `quarantine/` +- keep private keys out of the repository + +## Recommended runtime flow + +1. Watch `vault/` for new `.enc` files. +2. Wait for file writes to stabilize. +3. Attempt single-file JSON pack parsing. +4. Fallback to split-pack loading when appropriate. +5. Verify signature and integrity hashes. +6. Decrypt AES-GCM payload. +7. Write decrypted JSON to `decrypted/`. +8. Hand off the verified spec to the local orchestrator. + +## Non-goals + +- unrestricted or universal-access automation +- hidden access paths +- bypassing approvals or least-privilege boundaries diff --git a/docs/readme-badges.md b/docs/readme-badges.md new file mode 100644 index 0000000000..ffa888298a --- /dev/null +++ b/docs/readme-badges.md @@ -0,0 +1,8 @@ +![Verification First](https://img.shields.io/badge/verification-first-275EFE) +![Fingerprint Mode](https://img.shields.io/badge/fingerprint-auto-22D3EE) +![Defensive Runtime](https://img.shields.io/badge/runtime-defensive-F5B700) +![CKAN Aware](https://img.shields.io/badge/ckan-aware-0B1020) + +## Mythos partner layer + +Ethos Aegis Γ— Claude Mythos adds a verification-first partner layer for CKAN-aware reasoning and formula generation. diff --git a/docs/readme-mythos-section.md b/docs/readme-mythos-section.md new file mode 100644 index 0000000000..3436f778e6 --- /dev/null +++ b/docs/readme-mythos-section.md @@ -0,0 +1,27 @@ +# Ethos Aegis Γ— Claude Mythos + +Veriflow Immune System for host-aware, verification-first reasoning over CKAN-backed and normalized data. + +## Mythos distribution layer + +This repository combines: +- Ethos Aegis as the defensive systems framework +- Claude Mythos as the identity and operating contract layer +- Veriflow as the formula-and-answer engine +- CKAN-aware ingestion, probing, and caching + +### Runtime defaults +- probe capabilities on startup +- cache host capability matrices +- select ingestion path automatically per CKAN host +- use `fingerprint_mode="auto"` for most hosts +- use `datastore_lightweight` only when row freshness matters more than probe cost + +### Quick links +- [Claude Mythos operating contract](../CLAUDE_MYTHOS.md) +- [Brand kit](../brand/claude-mythos-brand-kit.md) +- [GitHub partner branding kit](../brand/github-partner-branding-kit.md) +- [Interactive control panel](../interactive/mythos_control_panel.html) +- [Startup example](../examples/mythos_startup.py) + +**Principle:** Trust the verified path. diff --git a/docs/vault_watcher_integration.md b/docs/vault_watcher_integration.md new file mode 100644 index 0000000000..48576500e3 --- /dev/null +++ b/docs/vault_watcher_integration.md @@ -0,0 +1,50 @@ +# Vault Watcher Integration + +This document describes how a local watcher should load encrypted signed policy packs into a controlled orchestrator. + +## Runtime directories + +```text +project_root/ +β”œβ”€β”€ vault/ +β”œβ”€β”€ manifests/ +β”œβ”€β”€ decrypted/ +β”œβ”€β”€ quarantine/ +β”œβ”€β”€ keys/ +└── vault_watcher.py +``` + +## Environment requirements + +- `PHASEFORM_PASSPHRASE` must be set before startup. +- private keys must remain local and out of version control. +- no embedded default passphrase should exist in source. + +## Expected behavior + +1. Detect new `.enc` files in `vault/`. +2. Wait until the file is stable. +3. Try single-file JSON pack parsing. +4. If that fails, look for matching split-pack manifest and signature files. +5. Verify Ed25519 signature before decryption. +6. Verify ciphertext and plaintext hashes when present. +7. Write valid decrypted specs to `decrypted/`. +8. Move invalid packs to `quarantine/`. +9. Hand the verified spec to the local orchestrator. + +## Orchestrator handoff contract + +A local handoff function should accept a decrypted agent spec and convert it into runtime state. + +Example responsibilities: +- validate schema version +- validate policy surface +- enforce least-privilege permissions +- register the spec as active runtime policy +- emit an audit event + +## Suggested follow-up + +- add a local spec editor +- add a pack validator CLI +- add sample single-file and split-pack test fixtures diff --git a/ethos_aegis/__init__.py b/ethos_aegis/__init__.py new file mode 100644 index 0000000000..6a5f56d239 --- /dev/null +++ b/ethos_aegis/__init__.py @@ -0,0 +1 @@ +"""Ethos Aegis package.""" diff --git a/ethos_aegis/mythos_runtime/__init__.py b/ethos_aegis/mythos_runtime/__init__.py new file mode 100644 index 0000000000..e452158917 --- /dev/null +++ b/ethos_aegis/mythos_runtime/__init__.py @@ -0,0 +1,15 @@ +from .budget import BudgetMeter +from .drift import DriftDetector, DriftScanResult +from .memory import MemoryEvent, MemoryLedger +from .swd import ClaimedFileAction, StrictWriteDiscipline, VerificationReport + +__all__ = [ + "BudgetMeter", + "ClaimedFileAction", + "DriftDetector", + "DriftScanResult", + "MemoryEvent", + "MemoryLedger", + "StrictWriteDiscipline", + "VerificationReport", +] diff --git a/ethos_aegis/mythos_runtime/budget.py b/ethos_aegis/mythos_runtime/budget.py new file mode 100644 index 0000000000..5505e7e7c6 --- /dev/null +++ b/ethos_aegis/mythos_runtime/budget.py @@ -0,0 +1,32 @@ +from __future__ import annotations + +from dataclasses import dataclass + + +@dataclass +class BudgetMeter: + max_tokens: int = 500_000 + max_turns: int = 25 + warning_threshold: float = 0.8 + tokens_used: int = 0 + turns_used: int = 0 + + def consume(self, *, tokens: int = 0, turns: int = 1) -> None: + self.tokens_used += max(0, tokens) + self.turns_used += max(0, turns) + + @property + def token_ratio(self) -> float: + return 0.0 if self.max_tokens <= 0 else self.tokens_used / self.max_tokens + + @property + def turn_ratio(self) -> float: + return 0.0 if self.max_turns <= 0 else self.turns_used / self.max_turns + + @property + def warning(self) -> bool: + return max(self.token_ratio, self.turn_ratio) >= self.warning_threshold + + @property + def exhausted(self) -> bool: + return self.token_ratio >= 1.0 or self.turn_ratio >= 1.0 diff --git a/ethos_aegis/mythos_runtime/cli.py b/ethos_aegis/mythos_runtime/cli.py new file mode 100644 index 0000000000..53acf54755 --- /dev/null +++ b/ethos_aegis/mythos_runtime/cli.py @@ -0,0 +1,62 @@ +from __future__ import annotations + +import argparse +import json +from pathlib import Path + +from .drift import DriftDetector +from .memory import MemoryLedger +from .swd import StrictWriteDiscipline + + +def build_parser() -> argparse.ArgumentParser: + parser = argparse.ArgumentParser( + prog="mythos-runtime", + description="Strict write discipline and memory tools for Ethos Aegis.", + ) + parser.add_argument("--root", default=".", help="Project root") + parser.add_argument("--memory", default="MEMORY.md", help="Memory ledger path relative to root") + sub = parser.add_subparsers(dest="command", required=True) + + verify = sub.add_parser("verify", help="Scan project state against ledger.") + verify.add_argument("--json", action="store_true", help="Emit JSON output") + + dream = sub.add_parser("dream", help="Compress old memory entries.") + dream.add_argument("--max-entries", type=int, default=100) + dream.add_argument("--keep-recent", type=int, default=20) + dream.add_argument("--dry-run", action="store_true") + + return parser + + +def main(argv: list[str] | None = None) -> int: + parser = build_parser() + args = parser.parse_args(argv) + root = Path(args.root).resolve() + ledger = MemoryLedger(root / args.memory) + swd = StrictWriteDiscipline(root, memory_ledger=ledger) + + if args.command == "verify": + result = DriftDetector(root, ledger=ledger, swd=swd).scan() + payload = { + "verified": result.verified, + "drifted": result.drifted, + "missing": result.missing, + "unknown": result.unknown, + } + if args.json: + print(json.dumps(payload, indent=2, sort_keys=True)) + else: + print(f"verified={len(result.verified)} drifted={len(result.drifted)} missing={len(result.missing)}") + return 0 + + if args.command == "dream": + result = ledger.compress(max_entries=args.max_entries, keep_recent=args.keep_recent, dry_run=args.dry_run) + print(json.dumps(result, indent=2, sort_keys=True)) + return 0 + + return 1 + + +if __name__ == "__main__": # pragma: no cover + raise SystemExit(main()) diff --git a/ethos_aegis/mythos_runtime/drift.py b/ethos_aegis/mythos_runtime/drift.py new file mode 100644 index 0000000000..8fd59b92c9 --- /dev/null +++ b/ethos_aegis/mythos_runtime/drift.py @@ -0,0 +1,74 @@ +from __future__ import annotations + +from dataclasses import dataclass, field +from pathlib import Path + +from .memory import MemoryLedger +from .swd import StrictWriteDiscipline + + +@dataclass +class DriftScanResult: + verified: list[str] = field(default_factory=list) + drifted: list[str] = field(default_factory=list) + missing: list[str] = field(default_factory=list) + unknown: list[str] = field(default_factory=list) + + +class DriftDetector: + def __init__( + self, + root: str | Path, + *, + ledger: MemoryLedger, + swd: StrictWriteDiscipline | None = None, + ) -> None: + self.root = Path(root) + self.ledger = ledger + self.swd = swd or StrictWriteDiscipline( + root, + memory_ledger=ledger, + ) + + def scan(self) -> DriftScanResult: + last_known, missing_candidates = self._collect_last_known() + return self._compare_against_filesystem( + last_known, + missing_candidates, + ) + + def _collect_last_known(self) -> tuple[dict[str, str | None], set[str]]: + last_known: dict[str, str | None] = {} + missing_candidates: set[str] = set() + for event in self.ledger.list_events(): + if event.event_type != "verified_write": + continue + for action in event.payload.get("verified_actions", []): + path = str(action.get("path") or "") + after = action.get("after") or {} + if not path: + continue + if after.get("exists"): + last_known[path] = after.get("sha256") + else: + missing_candidates.add(path) + return last_known, missing_candidates + + def _compare_against_filesystem( + self, + last_known: dict[str, str | None], + missing_candidates: set[str], + ) -> DriftScanResult: + result = DriftScanResult() + for path, known_hash in last_known.items(): + current = self.swd.snapshot([path]).get(path) + if current is None or not current.exists: + result.missing.append(path) + elif current.sha256 == known_hash: + result.verified.append(path) + else: + result.drifted.append(path) + for path in sorted(missing_candidates - set(last_known)): + if not (self.root / path).exists(): + result.missing.append(path) + return result diff --git a/ethos_aegis/mythos_runtime/memory.py b/ethos_aegis/mythos_runtime/memory.py new file mode 100644 index 0000000000..d4ac28e97a --- /dev/null +++ b/ethos_aegis/mythos_runtime/memory.py @@ -0,0 +1,127 @@ +from __future__ import annotations + +import json +from dataclasses import dataclass, field +from datetime import datetime, timezone +from pathlib import Path +from typing import Any, Iterable + + +@dataclass +class MemoryEvent: + event_type: str + summary: str + payload: dict[str, Any] = field(default_factory=dict) + created_at: str = field( + default_factory=lambda: datetime.now(timezone.utc).isoformat() + ) + + def to_markdown(self) -> str: + return ( + f"## {self.created_at} Β· {self.event_type}\n" + f"{self.summary}\n\n" + f"```json\n{json.dumps(self.payload, indent=2, sort_keys=True)}\n```\n" + ) + + +class MemoryLedger: + HEADER = ( + "# MEMORY\n\n" + "Persistent execution ledger for Ethos Aegis Γ— Claude Mythos.\n\n" + ) + + def __init__(self, path: str | Path) -> None: + self.path = Path(path) + + def ensure_exists(self) -> None: + if not self.path.exists(): + self.path.parent.mkdir(parents=True, exist_ok=True) + self.path.write_text(self.HEADER, encoding="utf-8") + + def append_event(self, event: MemoryEvent) -> None: + self.ensure_exists() + with self.path.open("a", encoding="utf-8") as handle: + handle.write(event.to_markdown()) + handle.write("\n") + + def list_events(self) -> list[MemoryEvent]: + if not self.path.exists(): + return [] + text = self.path.read_text(encoding="utf-8") + sections = [ + section.strip() + for section in text.split("## ") + if section.strip() and "```json" in section + ] + events: list[MemoryEvent] = [] + for section in sections: + try: + heading, rest = section.split("\n", 1) + summary, json_block = rest.split("```json\n", 1) + payload_text = json_block.split("\n```", 1)[0] + created_at, event_type = heading.split(" Β· ", 1) + events.append( + MemoryEvent( + event_type=event_type.strip(), + summary=summary.strip(), + payload=json.loads(payload_text), + created_at=created_at.strip(), + ) + ) + except Exception: + continue + return events + + def compress( + self, + *, + max_entries: int = 100, + keep_recent: int = 20, + dry_run: bool = False, + ) -> dict[str, Any]: + events = self.list_events() + if len(events) <= max_entries: + return {"compressed": False, "events": len(events)} + preserved = events[-keep_recent:] + archived = events[:-keep_recent] + summary_payload = { + "archived_entries": len(archived), + "event_type_counts": self._type_counts(archived), + "from": archived[0].created_at if archived else None, + "to": archived[-1].created_at if archived else None, + } + summary_event = MemoryEvent( + event_type="dream_summary", + summary=( + "Compressed older ledger entries into a deterministic " + "summary block." + ), + payload=summary_payload, + ) + if dry_run: + return { + "compressed": True, + "dry_run": True, + "summary": summary_payload, + "preserved": len(preserved), + } + self.ensure_exists() + content = ( + self.HEADER + + summary_event.to_markdown() + + "\n" + + "\n".join(event.to_markdown() for event in preserved) + + "\n" + ) + self.path.write_text(content, encoding="utf-8") + return { + "compressed": True, + "summary": summary_payload, + "preserved": len(preserved), + } + + def _type_counts(self, events: Iterable[MemoryEvent]) -> dict[str, int]: + counts: dict[str, int] = {} + for event in events: + counts[event.event_type] = counts.get(event.event_type, 0) + 1 + return counts diff --git a/ethos_aegis/mythos_runtime/swd.py b/ethos_aegis/mythos_runtime/swd.py new file mode 100644 index 0000000000..e15602b41c --- /dev/null +++ b/ethos_aegis/mythos_runtime/swd.py @@ -0,0 +1,196 @@ +from __future__ import annotations + +import fnmatch +import hashlib +from dataclasses import asdict, dataclass +from pathlib import Path +from typing import Iterable + +from .memory import MemoryEvent, MemoryLedger + + +@dataclass(frozen=True) +class FileSnapshot: + path: str + exists: bool + size: int | None + sha256: str | None + + +@dataclass +class ClaimedFileAction: + path: str + action: str + description: str = "" + + +@dataclass +class VerificationReport: + ok: bool + claimed_actions: list[ClaimedFileAction] + verified_actions: list[ClaimedFileAction] + before: dict[str, FileSnapshot] + after: dict[str, FileSnapshot] + detail: str + dry_run: bool = False + + +class StrictWriteDiscipline: + def __init__( + self, + root: str | Path, + *, + memory_ledger: MemoryLedger | None = None, + ignore_patterns: list[str] | None = None, + ) -> None: + self.root = Path(root) + self.memory_ledger = memory_ledger + self.ignore_patterns = ignore_patterns or [ + ".git/*", + "__pycache__/*", + "*.pyc", + ] + + def snapshot(self, paths: Iterable[str] | None = None) -> dict[str, FileSnapshot]: + if paths is None: + candidates = [path for path in self.root.rglob("*") if path.is_file()] + rel_paths = [ + str(path.relative_to(self.root)) + for path in candidates + if not self._ignored(path.relative_to(self.root)) + ] + else: + rel_paths = [self._normalize(path) for path in paths] + snapshots: dict[str, FileSnapshot] = {} + for rel_path in rel_paths: + full_path = self.root / rel_path + if full_path.exists() and full_path.is_file(): + data = full_path.read_bytes() + snapshots[rel_path] = FileSnapshot( + path=rel_path, + exists=True, + size=len(data), + sha256=hashlib.sha256(data).hexdigest(), + ) + else: + snapshots[rel_path] = FileSnapshot( + path=rel_path, + exists=False, + size=None, + sha256=None, + ) + return snapshots + + def verify_claims( + self, + claimed_actions: list[ClaimedFileAction], + before: dict[str, FileSnapshot], + after: dict[str, FileSnapshot], + *, + dry_run: bool = False, + ) -> VerificationReport: + verified: list[ClaimedFileAction] = [] + mismatches: list[str] = [] + for action in claimed_actions: + before_state = before.get( + action.path, + FileSnapshot(action.path, False, None, None), + ) + after_state = after.get( + action.path, + FileSnapshot(action.path, False, None, None), + ) + matched = ( + (action.action == "CREATE" and not before_state.exists and after_state.exists) + or ( + action.action == "MODIFY" + and before_state.exists + and after_state.exists + and before_state.sha256 != after_state.sha256 + ) + or (action.action == "DELETE" and before_state.exists and not after_state.exists) + ) + if matched or dry_run: + verified.append(action) + else: + mismatches.append(f"{action.action} {action.path}") + ok = not mismatches + detail = "verified" if ok else f"mismatch: {', '.join(mismatches)}" + report = VerificationReport( + ok=ok, + claimed_actions=claimed_actions, + verified_actions=verified, + before=before, + after=after, + detail=detail, + dry_run=dry_run, + ) + self._record_report(report) + return report + + def write_text( + self, + path: str | Path, + content: str, + *, + description: str = "", + dry_run: bool = False, + ) -> VerificationReport: + rel_path = self._normalize(path) + full_path = self.root / rel_path + action = "MODIFY" if full_path.exists() else "CREATE" + before = self.snapshot([rel_path]) + if not dry_run: + full_path.parent.mkdir(parents=True, exist_ok=True) + full_path.write_text(content, encoding="utf-8") + after = self.snapshot([rel_path]) if not dry_run else before + return self.verify_claims( + [ClaimedFileAction(rel_path, action, description)], + before, + after, + dry_run=dry_run, + ) + + def _record_report(self, report: VerificationReport) -> None: + if self.memory_ledger is None: + return + payload = { + "ok": report.ok, + "detail": report.detail, + "dry_run": report.dry_run, + "claimed_actions": [ + { + "path": action.path, + "action": action.action, + "description": action.description, + } + for action in report.claimed_actions + ], + "verified_actions": [ + { + "path": action.path, + "action": action.action, + "description": action.description, + "after": ( + asdict(report.after.get(action.path)) + if report.after.get(action.path) + else None + ), + } + for action in report.verified_actions + ], + } + self.memory_ledger.append_event( + MemoryEvent( + event_type="verified_write", + summary="Strict write discipline verification completed.", + payload=payload, + ) + ) + + def _normalize(self, path: str | Path) -> str: + return str(Path(path)).replace("\\", "/") + + def _ignored(self, rel_path: Path) -> bool: + text = str(rel_path).replace("\\", "/") + return any(fnmatch.fnmatch(text, pattern) for pattern in self.ignore_patterns) diff --git a/ethos_aegis/veriflow/__init__.py b/ethos_aegis/veriflow/__init__.py new file mode 100644 index 0000000000..bc030b3fdf --- /dev/null +++ b/ethos_aegis/veriflow/__init__.py @@ -0,0 +1,21 @@ +from .ckan_adapter import ( + CKANCapabilityMatrix, + CKANClient, + CKANIngestionResult, + CKANVersion, + CapabilityRecord, + IngestionAttempt, + SchemaField, +) +from .immune_system import VeriflowImmuneSystem + +__all__ = [ + "CKANCapabilityMatrix", + "CKANClient", + "CKANIngestionResult", + "CKANVersion", + "CapabilityRecord", + "IngestionAttempt", + "SchemaField", + "VeriflowImmuneSystem", +] diff --git a/ethos_aegis/veriflow/ckan_adapter.py b/ethos_aegis/veriflow/ckan_adapter.py new file mode 100644 index 0000000000..d402b2f115 --- /dev/null +++ b/ethos_aegis/veriflow/ckan_adapter.py @@ -0,0 +1,135 @@ +from __future__ import annotations + +from dataclasses import dataclass, field +from typing import Any + + +@dataclass(frozen=True) +class CKANVersion: + raw: str + major: int | None = None + minor: int | None = None + patch: int | None = None + prerelease: str | None = None + + @classmethod + def parse(cls, value: str) -> "CKANVersion": + text = (value or "").strip() + if not text: + return cls(raw="unknown") + prerelease = None + core = text + for marker in ("a", "b", "rc"): + if marker in text: + idx = text.find(marker) + core = text[:idx] + prerelease = text[idx:] + break + parts = core.split(".") + nums: list[int | None] = [] + for part in parts[:3]: + try: + nums.append(int(part)) + except ValueError: + nums.append(None) + while len(nums) < 3: + nums.append(None) + return cls( + raw=text, + major=nums[0], + minor=nums[1], + patch=nums[2], + prerelease=prerelease, + ) + + +@dataclass +class SchemaField: + name: str + label: str | None = None + description: str | None = None + aliases: tuple[str, ...] = () + unit: str | None = None + field_type: str = "string" + + +@dataclass +class IngestionAttempt: + path: str + ok: bool + detail: str + + +@dataclass +class CapabilityRecord: + name: str + state: str + source: str = "unknown" + detail: str = "" + + +@dataclass +class CKANCapabilityMatrix: + api_base: str + version: CKANVersion + capabilities: dict[str, CapabilityRecord] = field(default_factory=dict) + + def supports(self, name: str) -> bool: + record = self.capabilities.get(name) + return bool(record and record.state in {"available", "inferred", "partial"}) + + def to_dict(self) -> dict[str, Any]: + return { + "api_base": self.api_base, + "version": { + "raw": self.version.raw, + "major": self.version.major, + "minor": self.version.minor, + "patch": self.version.patch, + "prerelease": self.version.prerelease, + }, + "capabilities": { + name: { + "name": record.name, + "state": record.state, + "source": record.source, + "detail": record.detail, + } + for name, record in self.capabilities.items() + }, + } + + +@dataclass +class CKANIngestionResult: + resource_id: str + package_id: str | None + path: str + rows: list[dict[str, Any]] + fields: list[SchemaField] + resource: dict[str, Any] + package: dict[str, Any] | None + attempts: list[IngestionAttempt] = field(default_factory=list) + metadata: dict[str, Any] = field(default_factory=dict) + + +class CKANClient: + def __init__(self, base_url: str, api_key: str | None = None) -> None: + self.base_url = base_url.rstrip("/") + self.api_key = api_key + + def probe_capabilities( + self, + *, + sample_resource_id: str | None = None, + ) -> CKANCapabilityMatrix: + return CKANCapabilityMatrix( + api_base=f"{self.base_url}/api/3/action", + version=CKANVersion(raw="unknown"), + capabilities={}, + ) + + def ingest_resource(self, resource_id: str, **_: Any) -> CKANIngestionResult: + raise NotImplementedError( + "Provide a concrete CKAN client or test double for resource ingestion." + ) diff --git a/ethos_aegis/veriflow/immune_system.py b/ethos_aegis/veriflow/immune_system.py new file mode 100644 index 0000000000..813e7d314c --- /dev/null +++ b/ethos_aegis/veriflow/immune_system.py @@ -0,0 +1,155 @@ +from __future__ import annotations + +import hashlib +import json +import tempfile +from dataclasses import dataclass, field +from pathlib import Path +from typing import Any + +from ethos_aegis.mythos_runtime.memory import MemoryEvent, MemoryLedger +from ethos_aegis.mythos_runtime.swd import StrictWriteDiscipline + +from .ckan_adapter import ( + CKANCapabilityMatrix, + CKANClient, + CKANIngestionResult, + IngestionAttempt, + SchemaField, +) + + +@dataclass +class DatasetCacheEntry: + resource_id: str + digest: str + rows: list[dict[str, Any]] + fields: list[SchemaField] + package_id: str | None = None + ingestion_path: str = "unknown" + ingestion_attempts: list[IngestionAttempt] = field(default_factory=list) + ingestion_metadata: dict[str, Any] = field(default_factory=dict) + + +class VeriflowImmuneSystem: + def __init__( + self, + ckan: CKANClient, + verifier: Any | None = None, + *, + probe_on_startup: bool = True, + sample_resource_id: str | None = None, + fingerprint_mode: str = "auto", + persist_host_state: bool = True, + state_dir: str | Path | None = None, + ) -> None: + self.ckan = ckan + self.verifier = verifier + # Supported values: "auto" (default), "lightweight", "full". + # "auto" selects the best available fingerprinting strategy. + self.fingerprint_mode = fingerprint_mode + self._cache: dict[str, DatasetCacheEntry] = {} + self._capability_matrix: CKANCapabilityMatrix | None = None + self._probe_sample_resource_id = sample_resource_id + self._persist_host_state = persist_host_state + self._state_dir = ( + Path(state_dir) + if state_dir is not None + else Path(tempfile.gettempdir()) / "ethos_aegis_veriflow_state" + ) + self._memory_ledger = MemoryLedger(self._state_dir / "MEMORY.md") + self._runtime_discipline = StrictWriteDiscipline( + self._state_dir, + memory_ledger=self._memory_ledger, + ) + self._state = ( + self._load_state() if persist_host_state else {"resources": {}} + ) + if probe_on_startup: + self.bootstrap(sample_resource_id=sample_resource_id) + + @property + def capability_matrix(self) -> CKANCapabilityMatrix | None: + return self._capability_matrix + + @property + def state_file(self) -> Path: + return self._state_dir / f"{self._host_key()}.json" + + def _host_key(self) -> str: + return hashlib.sha256(self.ckan.base_url.encode("utf-8")).hexdigest()[:16] + + def _load_state(self) -> dict[str, Any]: + path = self.state_file + if not path.exists(): + return {"host": self.ckan.base_url, "resources": {}} + try: + payload = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return {"host": self.ckan.base_url, "resources": {}} + if not isinstance(payload, dict): + return {"host": self.ckan.base_url, "resources": {}} + payload.setdefault("host", self.ckan.base_url) + payload.setdefault("resources", {}) + return payload + + def _save_state(self) -> None: + if not self._persist_host_state: + return + payload = json.dumps(self._state, indent=2, sort_keys=True) + self._runtime_discipline.write_text( + self.state_file.name, + payload, + description="Persist host capability and resource state", + ) + + def bootstrap(self, *, sample_resource_id: str | None = None) -> CKANCapabilityMatrix: + sample = sample_resource_id or self._probe_sample_resource_id + matrix = self.ckan.probe_capabilities(sample_resource_id=sample) + self._capability_matrix = matrix + self._probe_sample_resource_id = sample + self._state["capability_matrix"] = matrix.to_dict() + self._state["probe_sample_resource_id"] = sample + self._save_state() + return matrix + + def refresh_resource(self, resource_id: str) -> DatasetCacheEntry: + if self._capability_matrix is None: + self.bootstrap(sample_resource_id=resource_id) + result: CKANIngestionResult = self.ckan.ingest_resource(resource_id) + digest = hashlib.sha256( + json.dumps(result.rows, sort_keys=True).encode("utf-8") + ).hexdigest() + entry = DatasetCacheEntry( + resource_id=result.resource_id, + digest=digest, + rows=result.rows, + fields=result.fields, + package_id=result.package_id, + ingestion_path=result.path, + ingestion_attempts=result.attempts, + ingestion_metadata=result.metadata, + ) + self._cache[resource_id] = entry + self._state.setdefault("resources", {})[resource_id] = { + "digest": digest, + "package_id": result.package_id, + "ingestion_path": result.path, + "ingestion_metadata": result.metadata, + } + self._save_state() + self._memory_ledger.append_event( + MemoryEvent( + event_type="resource_refresh", + summary=f"Refreshed resource {resource_id} through {result.path}.", + payload={ + "resource_id": resource_id, + "ingestion_path": result.path, + "rows": len(result.rows), + }, + ) + ) + return entry + + def cache_entry(self, resource_id: str) -> DatasetCacheEntry | None: + return self._cache.get(resource_id) diff --git a/examples/agent_spec.example.json b/examples/agent_spec.example.json new file mode 100644 index 0000000000..43aef1d6bb --- /dev/null +++ b/examples/agent_spec.example.json @@ -0,0 +1,53 @@ +{ + "schema_version": "1.0", + "creator": "TDD", + "system_role": "senior_ai_systems_architect", + "use_case": "Encrypted policy-driven local orchestrator", + "business_goal": "Load signed encrypted policy packs into a controlled agent runtime", + "users": ["operator", "developer", "reviewer"], + "inputs": [ + "documents", + "events", + "tool outputs", + "encrypted policy packs", + "user instructions" + ], + "tools": [ + "workspace runtime", + "file tools", + "code generator", + "policy engine", + "watchdog", + "cryptography" + ], + "responsibilities": [ + "Break goals into steps", + "Choose tools when needed", + "Evaluate tool results", + "Retry if a step fails", + "Escalate to human when confidence is low", + "Stop when success criteria are met" + ], + "memory_requirements": "short-term task state plus encrypted long-term policy packs", + "constraints": { + "tech_stack": "Python", + "model_provider": "configurable", + "budget": "bounded", + "latency": "bounded", + "security_privacy": "local encrypted storage, signed manifests, no hidden access", + "deployment_target": "desktop/local" + }, + "required_output": [ + "System architecture", + "Component diagram", + "Folder structure", + "Data flow", + "Python starter code", + "Tool schema definitions", + "Prompt design", + "Safety guardrails", + "Evaluation checklist", + "Deployment steps" + ], + "success_criteria": "correct plans, auditable actions, safe execution, recoverable failures" +} diff --git a/examples/mythos_runtime_demo.py b/examples/mythos_runtime_demo.py new file mode 100644 index 0000000000..d96d39a99f --- /dev/null +++ b/examples/mythos_runtime_demo.py @@ -0,0 +1,22 @@ +from __future__ import annotations + +from pathlib import Path +import tempfile + +from ethos_aegis.mythos_runtime import DriftDetector, MemoryLedger, StrictWriteDiscipline + + +def main() -> None: + root = Path(tempfile.mkdtemp(prefix="mythos_runtime_demo_")) + ledger = MemoryLedger(root / "MEMORY.md") + swd = StrictWriteDiscipline(root, memory_ledger=ledger) + + report = swd.write_text("notes/example.txt", "hello mythos\n", description="Create demo note") + print({"ok": report.ok, "detail": report.detail, "path": "notes/example.txt"}) + + drift = DriftDetector(root, ledger=ledger, swd=swd).scan() + print({"verified": drift.verified, "drifted": drift.drifted, "missing": drift.missing}) + + +if __name__ == "__main__": + main() diff --git a/examples/mythos_startup.py b/examples/mythos_startup.py new file mode 100644 index 0000000000..a48c743762 --- /dev/null +++ b/examples/mythos_startup.py @@ -0,0 +1,149 @@ +""" +mythos_startup.py β€” Claude Mythos Γ— Veriflow scaffold bootstrap example. + +This module demonstrates how to initialise the Mythos identity scaffold on top +of the Veriflow immune system. It follows the recommended startup defaults from +the Claude Mythos operating contract: + + probe_on_startup=True + fingerprint_mode="auto" + datastore_lightweight only when row-level freshness matters more than probe cost + +Running this file directly will print the host capability profile as JSON. +""" + +from __future__ import annotations + +import json +import logging +import sys +from pathlib import Path + +from ethos_aegis.veriflow import CKANClient, VeriflowImmuneSystem + +logging.basicConfig( + level=logging.INFO, + format="%(asctime)s [%(levelname)s] %(name)s: %(message)s", +) +_log = logging.getLogger("mythos_startup") + + +def build_mythos( + host_url: str, + sample_resource_id: str | None = None, + *, + probe_on_startup: bool = True, + fingerprint_mode: str = "auto", + state_dir: str | Path | None = None, +) -> VeriflowImmuneSystem: + """Initialise the Mythos scaffold and return a bootstrapped immune system. + + Parameters + ---------- + host_url: + Base URL of the CKAN host to fingerprint and ingest from. + sample_resource_id: + Optional resource UUID used to exercise the datastore probe on startup. + probe_on_startup: + When True (the recommended default) the host capabilities are probed + immediately so the capability matrix is available before any ingestion. + fingerprint_mode: + Controls how the immune system identifies the host profile. + "auto" selects the best strategy available (recommended default). + state_dir: + Optional directory for persisting host state and the memory ledger. + Defaults to a temporary directory when not provided. + + Returns + ------- + VeriflowImmuneSystem + A fully bootstrapped immune system instance carrying the host's + capability matrix. + """ + _log.info( + "Initialising Claude Mythos scaffold β€” host=%s fingerprint_mode=%s", + host_url, + fingerprint_mode, + ) + ckan = CKANClient(host_url) + immune = VeriflowImmuneSystem( + ckan, + probe_on_startup=probe_on_startup, + sample_resource_id=sample_resource_id, + fingerprint_mode=fingerprint_mode, + state_dir=state_dir, + ) + matrix = immune.capability_matrix + if matrix is not None: + _log.info( + "Host fingerprinted β€” version=%s capabilities=%s", + matrix.version.raw, + list(matrix.capabilities.keys()), + ) + else: + _log.warning("Capability matrix unavailable after bootstrap.") + return immune + + +def generate_output(immune: VeriflowImmuneSystem) -> dict: + """Build the expected Mythos output shape from the bootstrapped immune system. + + The output follows the contract documented in + docs/claude-mythos-veriflow-scaffold.md: + + { + "host_profile": "", + "ckan_version": "", + "ingestion_path": "", + "formula": "", + "limitations": [] + } + """ + matrix = immune.capability_matrix + if matrix is None: + return { + "host_profile": "unknown", + "ckan_version": "unknown", + "ingestion_path": "unknown", + "formula": None, + "limitations": ["capability matrix unavailable"], + } + + has_datastore = matrix.supports("datastore") + has_schema = matrix.supports("schema") + + if has_datastore and has_schema: + host_profile = "schema-rich+datastore" + ingestion_path = "datastore" + limitations: list[str] = [] + elif has_datastore: + host_profile = "datastore-only" + ingestion_path = "datastore" + limitations = ["schema fields inferred from row sample"] + else: + host_profile = "metadata-only" + ingestion_path = "metadata" + limitations = ["sampled row signature used", "no datastore endpoint available"] + + return { + "host_profile": host_profile, + "ckan_version": matrix.version.raw, + "ingestion_path": ingestion_path, + "formula": "ctr = clicks / impressions", + "limitations": limitations, + } + + +if __name__ == "__main__": + host = sys.argv[1] if len(sys.argv) > 1 else "https://demo.ckan.org" + try: + mythos = build_mythos(host) + output = generate_output(mythos) + print(json.dumps(output, indent=2)) + except (OSError, ValueError, RuntimeError) as exc: + _log.error("Mythos startup failed: %s", exc) + sys.exit(1) + except Exception as exc: # noqa: BLE001 β€” catch-all for standalone script entry point + _log.error("Unexpected error during Mythos startup: %s", exc) + sys.exit(1) + diff --git a/examples/pinkybot/agent_profile.example.json b/examples/pinkybot/agent_profile.example.json new file mode 100644 index 0000000000..ea246a384f --- /dev/null +++ b/examples/pinkybot/agent_profile.example.json @@ -0,0 +1,41 @@ +{ + "name": "pinkybot-companion", + "display_name": "PinkyBot", + "model": "claude-sonnet-4-6", + "system_role": "persistent_ai_companion", + "identity": { + "values": [ + "helpful", + "permissioned", + "auditable", + "long-term", + "operator-aligned" + ], + "brand_surface": "Celestial Agent", + "architecture_surface": "Ethos Aegis" + }, + "memory": { + "mode": "hybrid", + "durable": true, + "semantic_recall": true, + "reflection_enabled": true + }, + "messaging": { + "telegram": true, + "discord": false, + "slack": false + }, + "skills": [ + "pinkybot_companion" + ], + "permissions": { + "external_messaging_requires_approval": true, + "calendar_write_requires_approval": true, + "sensitive_exports_require_approval": true + }, + "wake_triggers": [ + "schedule", + "webhook", + "file_change" + ] +} diff --git a/interactive/mythos_control_panel.html b/interactive/mythos_control_panel.html new file mode 100644 index 0000000000..3268be4322 --- /dev/null +++ b/interactive/mythos_control_panel.html @@ -0,0 +1,92 @@ + + + + + + Ethos Aegis Γ— Claude Mythos + + + +
+
+

Ethos Aegis Γ— Claude Mythos

+

Interactive partner view for the Veriflow Immune System.

+ verification-first + CKAN-aware + fingerprint:auto +
+ +
+
+

Host profile

+ +
+
+

Fingerprint mode

+ +
+
+

Question

+ +
+
+ +
+ +
+ +
+

Output

+
Awaiting input.
+
+
+ + + + diff --git a/joke_generator.py b/joke_generator.py new file mode 100644 index 0000000000..783a88dc45 --- /dev/null +++ b/joke_generator.py @@ -0,0 +1,13 @@ +import requests +import random + +def get_joke(): + response = requests.get("https://official-joke-api.appspot.com/random_joke") + if response.status_code == 200: + joke = response.json() + return f"{joke['setup']} - {joke['punchline']}" + else: + return "Sorry, I couldn't fetch a joke right now." + +if __name__ == '__main__': + print(get_joke()) \ No newline at end of file diff --git a/monorepo.config.json b/monorepo.config.json new file mode 100644 index 0000000000..2fafccec49 --- /dev/null +++ b/monorepo.config.json @@ -0,0 +1,25 @@ +{ + "projects": [ + { + "name": "ethos-aegis-core", + "path": "ethos_aegis", + "language": "Python", + "description": "Core immune architecture β€” mythos runtime, veriflow, CKAN adapter", + "entryPoint": "__init__.py" + }, + { + "name": "ethos-aegis-worker", + "path": "src", + "language": "TypeScript", + "description": "Cloudflare Worker entrypoint for the Ethos Aegis agentic surface", + "entryPoint": "index.ts" + }, + { + "name": "veriflow-sovereign-lattice", + "path": "veriflow-Sovereign-Lattice", + "language": "Python", + "description": "Veriflow Sovereign Lattice β€” deterministic row verification and formula generation", + "entryPoint": "README.md" + } + ] +} diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000000..caedda63f7 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,3256 @@ +{ + "name": "ethos-aegis-agentic-immune-veriflow", + "version": "1.0.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "ethos-aegis-agentic-immune-veriflow", + "version": "1.0.0", + "workspaces": [ + "veriflow/*" + ], + "devDependencies": { + "@typescript-eslint/eslint-plugin": "^7.0.0", + "@typescript-eslint/parser": "^7.0.0", + "eslint": "^8.0.0", + "prettier": "^3.0.0", + "typescript": "^5.0.0", + "wrangler": "^4.83.0" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@cloudflare/kv-asset-handler": { + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@cloudflare/kv-asset-handler/-/kv-asset-handler-0.4.2.tgz", + "integrity": "sha512-SIOD2DxrRRwQ+jgzlXCqoEFiKOFqaPjhnNTGKXSRLvp1HiOvapLaFG2kEr9dYQTYe8rKrd9uvDUzmAITeNyaHQ==", + "dev": true, + "license": "MIT OR Apache-2.0", + "engines": { + "node": ">=18.0.0" + } + }, + "node_modules/@cloudflare/unenv-preset": { + "version": "2.16.0", + "resolved": "https://registry.npmjs.org/@cloudflare/unenv-preset/-/unenv-preset-2.16.0.tgz", + "integrity": "sha512-8ovsRpwzPoEqPUzoErAYVv8l3FMZNeBVQfJTvtzP4AgLSRGZISRfuChFxHWUQd3n6cnrwkuTGxT+2cGo8EsyYg==", + "dev": true, + "license": "MIT OR Apache-2.0", + "peerDependencies": { + "unenv": "2.0.0-rc.24", + "workerd": "1.20260301.1 || ~1.20260302.1 || ~1.20260303.1 || ~1.20260304.1 || >1.20260305.0 <2.0.0-0" + }, + "peerDependenciesMeta": { + "workerd": { + "optional": true + } + } + }, + "node_modules/@cloudflare/workerd-darwin-64": { + "version": "1.20260415.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-64/-/workerd-darwin-64-1.20260415.1.tgz", + "integrity": "sha512-dsxaKsQm3LnPGNPEdsRv09QN3Y4DqCw7kX5j6noKqbAtro2jTr95sVlYM1jUxZ5FkOl1f7SXgaKKB9t5H5Nkbg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-darwin-arm64": { + "version": "1.20260415.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-arm64/-/workerd-darwin-arm64-1.20260415.1.tgz", + "integrity": "sha512-+JgSgVA49KyKteHRA1SnonE4Zn5Ei5zdAp5FQMxFmXI8qulZw4Hl7safXxRyK4i9sTO8gl7TFOKO5Q64VPvSDQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-linux-64": { + "version": "1.20260415.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-64/-/workerd-linux-64-1.20260415.1.tgz", + "integrity": "sha512-tU+9pwsqCy8afOVlGtiWrWQc/fedQK4SRm4KPIAt+zOiQWDxWASm6YGBUJis5c648WN80yz47qnmdDi8DQNOcA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-linux-arm64": { + "version": "1.20260415.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-arm64/-/workerd-linux-arm64-1.20260415.1.tgz", + "integrity": "sha512-bR9uITnV19r5NQ14xnypi2xHXu2iQvfYV8cVgx0JouFUmWwTEEAwFVojDdssGq93VHX9hr/pi2IRUZeegbYBog==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-windows-64": { + "version": "1.20260415.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-windows-64/-/workerd-windows-64-1.20260415.1.tgz", + "integrity": "sha512-4NuMLlerI0Ijua3Ir8HXQ+qyNvCUDEG5gDco5Om+sAiK6rnWiz+aGoSlbB8W16yW9QAgzCstbmXLiVknUBflfQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cspotcode/source-map-support": { + "version": "0.8.1", + "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz", + "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/trace-mapping": "0.3.9" + }, + "engines": { + "node": ">=12" + } + }, + "node_modules/@emnapi/runtime": { + "version": "1.10.0", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.10.0.tgz", + "integrity": "sha512-ewvYlk86xUoGI0zQRNq/mC+16R1QeDlKQy21Ki3oSYXNgLb45GV1P6A0M+/s6nyCuNDqe5VpaY84BzXGwVbwFA==", + "dev": true, + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.3.tgz", + "integrity": "sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.3.tgz", + "integrity": "sha512-i5D1hPY7GIQmXlXhs2w8AWHhenb00+GxjxRncS2ZM7YNVGNfaMxgzSGuO8o8SJzRc/oZwU2bcScvVERk03QhzA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.3.tgz", + "integrity": "sha512-YdghPYUmj/FX2SYKJ0OZxf+iaKgMsKHVPF1MAq/P8WirnSpCStzKJFjOjzsW0QQ7oIAiccHdcqjbHmJxRb/dmg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.3.tgz", + "integrity": "sha512-IN/0BNTkHtk8lkOM8JWAYFg4ORxBkZQf9zXiEOfERX/CzxW3Vg1ewAhU7QSWQpVIzTW+b8Xy+lGzdYXV6UZObQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.3.tgz", + "integrity": "sha512-Re491k7ByTVRy0t3EKWajdLIr0gz2kKKfzafkth4Q8A5n1xTHrkqZgLLjFEHVD+AXdUGgQMq+Godfq45mGpCKg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.3.tgz", + "integrity": "sha512-vHk/hA7/1AckjGzRqi6wbo+jaShzRowYip6rt6q7VYEDX4LEy1pZfDpdxCBnGtl+A5zq8iXDcyuxwtv3hNtHFg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.3.tgz", + "integrity": "sha512-ipTYM2fjt3kQAYOvo6vcxJx3nBYAzPjgTCk7QEgZG8AUO3ydUhvelmhrbOheMnGOlaSFUoHXB6un+A7q4ygY9w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.3.tgz", + "integrity": "sha512-dDk0X87T7mI6U3K9VjWtHOXqwAMJBNN2r7bejDsc+j03SEjtD9HrOl8gVFByeM0aJksoUuUVU9TBaZa2rgj0oA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.3.tgz", + "integrity": "sha512-s6nPv2QkSupJwLYyfS+gwdirm0ukyTFNl3KTgZEAiJDd+iHZcbTPPcWCcRYH+WlNbwChgH2QkE9NSlNrMT8Gfw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.3.tgz", + "integrity": "sha512-sZOuFz/xWnZ4KH3YfFrKCf1WyPZHakVzTiqji3WDc0BCl2kBwiJLCXpzLzUBLgmp4veFZdvN5ChW4Eq/8Fc2Fg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.3.tgz", + "integrity": "sha512-yGlQYjdxtLdh0a3jHjuwOrxQjOZYD/C9PfdbgJJF3TIZWnm/tMd/RcNiLngiu4iwcBAOezdnSLAwQDPqTmtTYg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.3.tgz", + "integrity": "sha512-WO60Sn8ly3gtzhyjATDgieJNet/KqsDlX5nRC5Y3oTFcS1l0KWba+SEa9Ja1GfDqSF1z6hif/SkpQJbL63cgOA==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.3.tgz", + "integrity": "sha512-APsymYA6sGcZ4pD6k+UxbDjOFSvPWyZhjaiPyl/f79xKxwTnrn5QUnXR5prvetuaSMsb4jgeHewIDCIWljrSxw==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.3.tgz", + "integrity": "sha512-eizBnTeBefojtDb9nSh4vvVQ3V9Qf9Df01PfawPcRzJH4gFSgrObw+LveUyDoKU3kxi5+9RJTCWlj4FjYXVPEA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.3.tgz", + "integrity": "sha512-3Emwh0r5wmfm3ssTWRQSyVhbOHvqegUDRd0WhmXKX2mkHJe1SFCMJhagUleMq+Uci34wLSipf8Lagt4LlpRFWQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.3.tgz", + "integrity": "sha512-pBHUx9LzXWBc7MFIEEL0yD/ZVtNgLytvx60gES28GcWMqil8ElCYR4kvbV2BDqsHOvVDRrOxGySBM9Fcv744hw==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.3.tgz", + "integrity": "sha512-Czi8yzXUWIQYAtL/2y6vogER8pvcsOsk5cpwL4Gk5nJqH5UZiVByIY8Eorm5R13gq+DQKYg0+JyQoytLQas4dA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.3.tgz", + "integrity": "sha512-sDpk0RgmTCR/5HguIZa9n9u+HVKf40fbEUt+iTzSnCaGvY9kFP0YKBWZtJaraonFnqef5SlJ8/TiPAxzyS+UoA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.3.tgz", + "integrity": "sha512-P14lFKJl/DdaE00LItAukUdZO5iqNH7+PjoBm+fLQjtxfcfFE20Xf5CrLsmZdq5LFFZzb5JMZ9grUwvtVYzjiA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.3.tgz", + "integrity": "sha512-AIcMP77AvirGbRl/UZFTq5hjXK+2wC7qFRGoHSDrZ5v5b8DK/GYpXW3CPRL53NkvDqb9D+alBiC/dV0Fb7eJcw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.3.tgz", + "integrity": "sha512-DnW2sRrBzA+YnE70LKqnM3P+z8vehfJWHXECbwBmH/CU51z6FiqTQTHFenPlHmo3a8UgpLyH3PT+87OViOh1AQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.3.tgz", + "integrity": "sha512-NinAEgr/etERPTsZJ7aEZQvvg/A6IsZG/LgZy+81wON2huV7SrK3e63dU0XhyZP4RKGyTm7aOgmQk0bGp0fy2g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.3.tgz", + "integrity": "sha512-PanZ+nEz+eWoBJ8/f8HKxTTD172SKwdXebZ0ndd953gt1HRBbhMsaNqjTyYLGLPdoWHy4zLU7bDVJztF5f3BHA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.3.tgz", + "integrity": "sha512-B2t59lWWYrbRDw/tjiWOuzSsFh1Y/E95ofKz7rIVYSQkUYBjfSgf6oeYPNWHToFRr2zx52JKApIcAS/D5TUBnA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.3.tgz", + "integrity": "sha512-QLKSFeXNS8+tHW7tZpMtjlNb7HKau0QDpwm49u0vUp9y1WOF+PEzkU84y9GqYaAVW8aH8f3GcBck26jh54cX4Q==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.3.tgz", + "integrity": "sha512-4uJGhsxuptu3OcpVAzli+/gWusVGwZZHTlS63hh++ehExkVT8SgiEf7/uC/PclrPPkLhZqGgCTjd0VWLo6xMqA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@eslint-community/eslint-utils": { + "version": "4.9.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", + "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + }, + "peerDependencies": { + "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" + } + }, + "node_modules/@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.0.0 || ^14.0.0 || >=16.0.0" + } + }, + "node_modules/@eslint/eslintrc": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-2.1.4.tgz", + "integrity": "sha512-269Z39MS6wVJtsoUl10L60WdkhJVdPG24Q4eZTH3nnF6lpvSShEK3wQjDX9JRWAUPvPh7COouPpU9IrqaZFvtQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ajv": "^6.12.4", + "debug": "^4.3.2", + "espree": "^9.6.0", + "globals": "^13.19.0", + "ignore": "^5.2.0", + "import-fresh": "^3.2.1", + "js-yaml": "^4.1.0", + "minimatch": "^3.1.2", + "strip-json-comments": "^3.1.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/@eslint/eslintrc/node_modules/brace-expansion": { + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@eslint/eslintrc/node_modules/minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@eslint/js": { + "version": "8.57.1", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-8.57.1.tgz", + "integrity": "sha512-d9zaMRSTIKDLhctzH12MtXvJKSSUhaHcjV+2Z+GK+EEY7XKpP5yR4x+N3TAcHTcu963nIr+TMcCb4DBCYX1z6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + } + }, + "node_modules/@humanwhocodes/config-array": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/@humanwhocodes/config-array/-/config-array-0.13.0.tgz", + "integrity": "sha512-DZLEEqFWQFiyK6h5YIeynKx7JlvCYWL0cImfSRXZ9l4Sg2efkFGTuFf6vzXjK1cq6IYkU+Eg/JizXw+TD2vRNw==", + "deprecated": "Use @eslint/config-array instead", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@humanwhocodes/object-schema": "^2.0.3", + "debug": "^4.3.1", + "minimatch": "^3.0.5" + }, + "engines": { + "node": ">=10.10.0" + } + }, + "node_modules/@humanwhocodes/config-array/node_modules/brace-expansion": { + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/@humanwhocodes/config-array/node_modules/minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.22" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/nzakas" + } + }, + "node_modules/@humanwhocodes/object-schema": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/object-schema/-/object-schema-2.0.3.tgz", + "integrity": "sha512-93zYdMES/c1D69yZiKDBj0V24vqNzB/koF26KPaagAfd3P/4gUlh3Dys5ogAK+Exi9QyzlD8x/08Zt7wIKcDcA==", + "deprecated": "Use @eslint/object-schema instead", + "dev": true, + "license": "BSD-3-Clause" + }, + "node_modules/@img/colour": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@img/colour/-/colour-1.1.0.tgz", + "integrity": "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/@img/sharp-darwin-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.34.5.tgz", + "integrity": "sha512-imtQ3WMJXbMY4fxb/Ndp6HBTNVtWCUI0WdobyheGf5+ad6xX8VIDO8u2xE4qc/fr08CKG/7dDseFtn6M6g/r3w==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-darwin-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.34.5.tgz", + "integrity": "sha512-YNEFAF/4KQ/PeW0N+r+aVVsoIY0/qxxikF2SWdp+NRkmMB7y9LBZAVqQ4yhGCm/H3H270OSykqmQMKLBhBJDEw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-libvips-darwin-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.2.4.tgz", + "integrity": "sha512-zqjjo7RatFfFoP0MkQ51jfuFZBnVE2pRiaydKJ1G/rHZvnsrHAOcQALIi9sA5co5xenQdTugCvtb1cuf78Vf4g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-darwin-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.2.4.tgz", + "integrity": "sha512-1IOd5xfVhlGwX+zXv2N93k0yMONvUlANylbJw1eTah8K/Jtpi15KC+WSiaX/nBmbm2HxRM1gZ0nSdjSsrZbGKg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.2.4.tgz", + "integrity": "sha512-bFI7xcKFELdiNCVov8e44Ia4u2byA+l3XtsAj+Q8tfCwO6BQ8iDojYdvoPMqsKDkuoOo+X6HZA0s0q11ANMQ8A==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.2.4.tgz", + "integrity": "sha512-excjX8DfsIcJ10x1Kzr4RcWe1edC9PquDRRPx3YVCvQv+U5p7Yin2s32ftzikXojb1PIFc/9Mt28/y+iRklkrw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-ppc64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.2.4.tgz", + "integrity": "sha512-FMuvGijLDYG6lW+b/UvyilUWu5Ayu+3r2d1S8notiGCIyYU/76eig1UfMmkZ7vwgOrzKzlQbFSuQfgm7GYUPpA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-riscv64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.2.4.tgz", + "integrity": "sha512-oVDbcR4zUC0ce82teubSm+x6ETixtKZBh/qbREIOcI3cULzDyb18Sr/Wcyx7NRQeQzOiHTNbZFF1UwPS2scyGA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-s390x": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.2.4.tgz", + "integrity": "sha512-qmp9VrzgPgMoGZyPvrQHqk02uyjA0/QrTO26Tqk6l4ZV0MPWIW6LTkqOIov+J1yEu7MbFQaDpwdwJKhbJvuRxQ==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linux-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.2.4.tgz", + "integrity": "sha512-tJxiiLsmHc9Ax1bz3oaOYBURTXGIRDODBqhveVHonrHJ9/+k89qbLl0bcJns+e4t4rvaNBxaEZsFtSfAdquPrw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.2.4.tgz", + "integrity": "sha512-FVQHuwx1IIuNow9QAbYUzJ+En8KcVm9Lk5+uGUQJHaZmMECZmOlix9HnH7n1TRkXMS0pGxIJokIVB9SuqZGGXw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-linuxmusl-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.2.4.tgz", + "integrity": "sha512-+LpyBk7L44ZIXwz/VYfglaX/okxezESc6UxDSoyo2Ks6Jxc4Y7sGjpgU9s4PMgqgjj1gZCylTieNamqA1MF7Dg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-linux-arm": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.34.5.tgz", + "integrity": "sha512-9dLqsvwtg1uuXBGZKsxem9595+ujv0sJ6Vi8wcTANSFpwV/GONat5eCkzQo/1O6zRIkh0m/8+5BjrRr7jDUSZw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.34.5.tgz", + "integrity": "sha512-bKQzaJRY/bkPOXyKx5EVup7qkaojECG6NLYswgktOZjaXecSAeCWiZwwiFf3/Y+O1HrauiE3FVsGxFg8c24rZg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-ppc64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.34.5.tgz", + "integrity": "sha512-7zznwNaqW6YtsfrGGDA6BRkISKAAE1Jo0QdpNYXNMHu2+0dTrPflTLNkpc8l7MUP5M16ZJcUvysVWWrMefZquA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-ppc64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-riscv64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.34.5.tgz", + "integrity": "sha512-51gJuLPTKa7piYPaVs8GmByo7/U7/7TZOq+cnXJIHZKavIRHAP77e3N2HEl3dgiqdD/w0yUfiJnII77PuDDFdw==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-riscv64": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-s390x": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.34.5.tgz", + "integrity": "sha512-nQtCk0PdKfho3eC5MrbQoigJ2gd1CgddUMkabUj+rBevs8tZ2cULOx46E7oyX+04WGfABgIwmMC0VqieTiR4jg==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-s390x": "1.2.4" + } + }, + "node_modules/@img/sharp-linux-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.34.5.tgz", + "integrity": "sha512-MEzd8HPKxVxVenwAa+JRPwEC7QFjoPWuS5NZnBt6B3pu7EG2Ge0id1oLHZpPJdn3OQK+BQDiw9zStiHBTJQQQQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-linuxmusl-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.34.5.tgz", + "integrity": "sha512-fprJR6GtRsMt6Kyfq44IsChVZeGN97gTD331weR1ex1c1rypDEABN6Tm2xa1wE6lYb5DdEnk03NZPqA7Id21yg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4" + } + }, + "node_modules/@img/sharp-linuxmusl-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.34.5.tgz", + "integrity": "sha512-Jg8wNT1MUzIvhBFxViqrEhWDGzqymo3sV7z7ZsaWbZNDLXRJZoRGrjulp60YYtV4wfY8VIKcWidjojlLcWrd8Q==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-x64": "1.2.4" + } + }, + "node_modules/@img/sharp-wasm32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.34.5.tgz", + "integrity": "sha512-OdWTEiVkY2PHwqkbBI8frFxQQFekHaSSkUIJkwzclWZe64O1X4UlUjqqqLaPbUpMOQk6FBu/HtlGXNblIs0huw==", + "cpu": [ + "wasm32" + ], + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT", + "optional": true, + "dependencies": { + "@emnapi/runtime": "^1.7.0" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-arm64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.34.5.tgz", + "integrity": "sha512-WQ3AgWCWYSb2yt+IG8mnC6Jdk9Whs7O0gxphblsLvdhSpSTtmu69ZG1Gkb6NuvxsNACwiPV6cNSZNzt0KPsw7g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-ia32": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.34.5.tgz", + "integrity": "sha512-FV9m/7NmeCmSHDD5j4+4pNI8Cp3aW+JvLoXcTUo0IqyjSfAZJ8dIUmijx1qaJsIiU+Hosw6xM5KijAWRJCSgNg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-x64": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.34.5.tgz", + "integrity": "sha512-+29YMsqY2/9eFEiW93eqWnuLcWcufowXewwSNIT6UwZdUUCrM3oFjMWH/Z6/TMmb4hlFenmfAVbpWeup2jryCw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@jridgewell/resolve-uri": { + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz", + "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@jridgewell/sourcemap-codec": { + "version": "1.5.5", + "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz", + "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==", + "dev": true, + "license": "MIT" + }, + "node_modules/@jridgewell/trace-mapping": { + "version": "0.3.9", + "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz", + "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/resolve-uri": "^3.0.3", + "@jridgewell/sourcemap-codec": "^1.4.10" + } + }, + "node_modules/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@poppinss/colors": { + "version": "4.1.6", + "resolved": "https://registry.npmjs.org/@poppinss/colors/-/colors-4.1.6.tgz", + "integrity": "sha512-H9xkIdFswbS8n1d6vmRd8+c10t2Qe+rZITbbDHHkQixH5+2x1FDGmi/0K+WgWiqQFKPSlIYB7jlH6Kpfn6Fleg==", + "dev": true, + "license": "MIT", + "dependencies": { + "kleur": "^4.1.5" + } + }, + "node_modules/@poppinss/dumper": { + "version": "0.6.5", + "resolved": "https://registry.npmjs.org/@poppinss/dumper/-/dumper-0.6.5.tgz", + "integrity": "sha512-NBdYIb90J7LfOI32dOewKI1r7wnkiH6m920puQ3qHUeZkxNkQiFnXVWoE6YtFSv6QOiPPf7ys6i+HWWecDz7sw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@poppinss/colors": "^4.1.5", + "@sindresorhus/is": "^7.0.2", + "supports-color": "^10.0.0" + } + }, + "node_modules/@poppinss/dumper/node_modules/supports-color": { + "version": "10.2.2", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-10.2.2.tgz", + "integrity": "sha512-SS+jx45GF1QjgEXQx4NJZV9ImqmO2NPz5FNsIHrsDjh2YsHnawpan7SNQ1o8NuhrbHZy9AZhIoCUiCeaW/C80g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/supports-color?sponsor=1" + } + }, + "node_modules/@poppinss/exception": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/@poppinss/exception/-/exception-1.2.3.tgz", + "integrity": "sha512-dCED+QRChTVatE9ibtoaxc+WkdzOSjYTKi/+uacHWIsfodVfpsueo3+DKpgU5Px8qXjgmXkSvhXvSCz3fnP9lw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@sindresorhus/is": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/@sindresorhus/is/-/is-7.2.0.tgz", + "integrity": "sha512-P1Cz1dWaFfR4IR+U13mqqiGsLFf1KbayybWwdd2vfctdV6hDpUkgCY0nKOLLTMSoRd/jJNjtbqzf13K8DCCXQw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sindresorhus/is?sponsor=1" + } + }, + "node_modules/@speed-highlight/core": { + "version": "1.2.15", + "resolved": "https://registry.npmjs.org/@speed-highlight/core/-/core-1.2.15.tgz", + "integrity": "sha512-BMq1K3DsElxDWawkX6eLg9+CKJrTVGCBAWVuHXVUV2u0s2711qiChLSId6ikYPfxhdYocLNt3wWwSvDiTvFabw==", + "dev": true, + "license": "CC0-1.0" + }, + "node_modules/@typescript-eslint/eslint-plugin": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-7.18.0.tgz", + "integrity": "sha512-94EQTWZ40mzBc42ATNIBimBEDltSJ9RQHCC8vc/PDbxi4k8dVwUAv4o98dk50M1zB+JGFxp43FP7f8+FP8R6Sw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/regexpp": "^4.10.0", + "@typescript-eslint/scope-manager": "7.18.0", + "@typescript-eslint/type-utils": "7.18.0", + "@typescript-eslint/utils": "7.18.0", + "@typescript-eslint/visitor-keys": "7.18.0", + "graphemer": "^1.4.0", + "ignore": "^5.3.1", + "natural-compare": "^1.4.0", + "ts-api-utils": "^1.3.0" + }, + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "@typescript-eslint/parser": "^7.0.0", + "eslint": "^8.56.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/parser": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-7.18.0.tgz", + "integrity": "sha512-4Z+L8I2OqhZV8qA132M4wNL30ypZGYOQVBfMgxDH/K5UX0PNqTu1c6za9ST5r9+tavvHiTWmBnKzpCJ/GlVFtg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "@typescript-eslint/scope-manager": "7.18.0", + "@typescript-eslint/types": "7.18.0", + "@typescript-eslint/typescript-estree": "7.18.0", + "@typescript-eslint/visitor-keys": "7.18.0", + "debug": "^4.3.4" + }, + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.56.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/scope-manager": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-7.18.0.tgz", + "integrity": "sha512-jjhdIE/FPF2B7Z1uzc6i3oWKbGcHb87Qw7AWj6jmEqNOfDFbJWtjt/XfwCpvNkpGWlcJaog5vTR+VV8+w9JflA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "7.18.0", + "@typescript-eslint/visitor-keys": "7.18.0" + }, + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/type-utils": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-7.18.0.tgz", + "integrity": "sha512-XL0FJXuCLaDuX2sYqZUUSOJ2sG5/i1AAze+axqmLnSkNEVMVYLF+cbwlB2w8D1tinFuSikHmFta+P+HOofrLeA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/typescript-estree": "7.18.0", + "@typescript-eslint/utils": "7.18.0", + "debug": "^4.3.4", + "ts-api-utils": "^1.3.0" + }, + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.56.0" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/types": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-7.18.0.tgz", + "integrity": "sha512-iZqi+Ds1y4EDYUtlOOC+aUmxnE9xS/yCigkjA7XpTKV6nCBd3Hp/PRGGmdwnfkV2ThMyYldP1wRpm/id99spTQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@typescript-eslint/typescript-estree": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-7.18.0.tgz", + "integrity": "sha512-aP1v/BSPnnyhMHts8cf1qQ6Q1IFwwRvAQGRvBFkWlo3/lH29OXA3Pts+c10nxRxIBrDnoMqzhgdwVe5f2D6OzA==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "@typescript-eslint/types": "7.18.0", + "@typescript-eslint/visitor-keys": "7.18.0", + "debug": "^4.3.4", + "globby": "^11.1.0", + "is-glob": "^4.0.3", + "minimatch": "^9.0.4", + "semver": "^7.6.0", + "ts-api-utils": "^1.3.0" + }, + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependenciesMeta": { + "typescript": { + "optional": true + } + } + }, + "node_modules/@typescript-eslint/utils": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-7.18.0.tgz", + "integrity": "sha512-kK0/rNa2j74XuHVcoCZxdFBMF+aq/vH83CXAOHieC+2Gis4mF8jJXT5eAfyD3K0sAxtPuwxaIOIOvhwzVDt/kw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.4.0", + "@typescript-eslint/scope-manager": "7.18.0", + "@typescript-eslint/types": "7.18.0", + "@typescript-eslint/typescript-estree": "7.18.0" + }, + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + }, + "peerDependencies": { + "eslint": "^8.56.0" + } + }, + "node_modules/@typescript-eslint/visitor-keys": { + "version": "7.18.0", + "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-7.18.0.tgz", + "integrity": "sha512-cDF0/Gf81QpY3xYyJKDV14Zwdmid5+uuENhjH2EqFaF0ni+yAyq/LzMaIJdhNJXZI7uLzwIlA+V7oWoyn6Curg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@typescript-eslint/types": "7.18.0", + "eslint-visitor-keys": "^3.4.3" + }, + "engines": { + "node": "^18.18.0 || >=20.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/typescript-eslint" + } + }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.0.tgz", + "integrity": "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g==", + "dev": true, + "license": "ISC" + }, + "node_modules/acorn": { + "version": "8.16.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz", + "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==", + "dev": true, + "license": "MIT", + "bin": { + "acorn": "bin/acorn" + }, + "engines": { + "node": ">=0.4.0" + } + }, + "node_modules/acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0" + } + }, + "node_modules/ajv": { + "version": "6.14.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz", + "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "fast-json-stable-stringify": "^2.0.0", + "json-schema-traverse": "^0.4.1", + "uri-js": "^4.2.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ansi-regex": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", + "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", + "dev": true, + "license": "Python-2.0" + }, + "node_modules/array-union": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz", + "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/blake3-wasm": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/blake3-wasm/-/blake3-wasm-2.1.5.tgz", + "integrity": "sha512-F1+K8EbfOZE49dtoPtmxUQrpXaBIl3ICvasLh+nJta0xkz+9kF/7uet9fLnwKqhDrmj6g+6K3Tw9yQPUg2ka5g==", + "dev": true, + "license": "MIT" + }, + "node_modules/brace-expansion": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.0.tgz", + "integrity": "sha512-TN1kCZAgdgweJhWWpgKYrQaMNHcDULHkWwQIspdtjV4Y5aurRdZpjAqn6yX3FPqTA9ngHCc4hJxMAMgGfve85w==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" + } + }, + "node_modules/color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "dev": true, + "license": "MIT" + }, + "node_modules/concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT" + }, + "node_modules/cookie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz", + "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-key": "^3.1.0", + "shebang-command": "^2.0.0", + "which": "^2.0.1" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "dev": true, + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/detect-libc": { + "version": "2.1.2", + "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz", + "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/dir-glob": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz", + "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-type": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/doctrine": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz", + "integrity": "sha512-yS+Q5i3hBf7GBkd4KG8a7eBNNWNGLTaEwwYWUijIYM7zrlYDM0BFXHjjPWlWZ1Rg7UaddZeIDmi9jF3HmqiQ2w==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "esutils": "^2.0.2" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/error-stack-parser-es": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/error-stack-parser-es/-/error-stack-parser-es-1.0.5.tgz", + "integrity": "sha512-5qucVt2XcuGMcEGgWI7i+yZpmpByQ8J1lHhcL7PwqCwu9FPP3VUXzT4ltHe5i2z9dePwEHcDVOAfSnHsOlCXRA==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/antfu" + } + }, + "node_modules/esbuild": { + "version": "0.27.3", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.3.tgz", + "integrity": "sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.27.3", + "@esbuild/android-arm": "0.27.3", + "@esbuild/android-arm64": "0.27.3", + "@esbuild/android-x64": "0.27.3", + "@esbuild/darwin-arm64": "0.27.3", + "@esbuild/darwin-x64": "0.27.3", + "@esbuild/freebsd-arm64": "0.27.3", + "@esbuild/freebsd-x64": "0.27.3", + "@esbuild/linux-arm": "0.27.3", + "@esbuild/linux-arm64": "0.27.3", + "@esbuild/linux-ia32": "0.27.3", + "@esbuild/linux-loong64": "0.27.3", + "@esbuild/linux-mips64el": "0.27.3", + "@esbuild/linux-ppc64": "0.27.3", + "@esbuild/linux-riscv64": "0.27.3", + "@esbuild/linux-s390x": "0.27.3", + "@esbuild/linux-x64": "0.27.3", + "@esbuild/netbsd-arm64": "0.27.3", + "@esbuild/netbsd-x64": "0.27.3", + "@esbuild/openbsd-arm64": "0.27.3", + "@esbuild/openbsd-x64": "0.27.3", + "@esbuild/openharmony-arm64": "0.27.3", + "@esbuild/sunos-x64": "0.27.3", + "@esbuild/win32-arm64": "0.27.3", + "@esbuild/win32-ia32": "0.27.3", + "@esbuild/win32-x64": "0.27.3" + } + }, + "node_modules/escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/eslint": { + "version": "8.57.1", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-8.57.1.tgz", + "integrity": "sha512-ypowyDxpVSYpkXr9WPv2PAZCtNip1Mv5KTW0SCurXv/9iOpcrH9PaqUElksqEB6pChqHGDRCFTyrZlGhnLNGiA==", + "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.", + "dev": true, + "license": "MIT", + "dependencies": { + "@eslint-community/eslint-utils": "^4.2.0", + "@eslint-community/regexpp": "^4.6.1", + "@eslint/eslintrc": "^2.1.4", + "@eslint/js": "8.57.1", + "@humanwhocodes/config-array": "^0.13.0", + "@humanwhocodes/module-importer": "^1.0.1", + "@nodelib/fs.walk": "^1.2.8", + "@ungap/structured-clone": "^1.2.0", + "ajv": "^6.12.4", + "chalk": "^4.0.0", + "cross-spawn": "^7.0.2", + "debug": "^4.3.2", + "doctrine": "^3.0.0", + "escape-string-regexp": "^4.0.0", + "eslint-scope": "^7.2.2", + "eslint-visitor-keys": "^3.4.3", + "espree": "^9.6.1", + "esquery": "^1.4.2", + "esutils": "^2.0.2", + "fast-deep-equal": "^3.1.3", + "file-entry-cache": "^6.0.1", + "find-up": "^5.0.0", + "glob-parent": "^6.0.2", + "globals": "^13.19.0", + "graphemer": "^1.4.0", + "ignore": "^5.2.0", + "imurmurhash": "^0.1.4", + "is-glob": "^4.0.0", + "is-path-inside": "^3.0.3", + "js-yaml": "^4.1.0", + "json-stable-stringify-without-jsonify": "^1.0.1", + "levn": "^0.4.1", + "lodash.merge": "^4.6.2", + "minimatch": "^3.1.2", + "natural-compare": "^1.4.0", + "optionator": "^0.9.3", + "strip-ansi": "^6.0.1", + "text-table": "^0.2.0" + }, + "bin": { + "eslint": "bin/eslint.js" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-scope": { + "version": "7.2.2", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-7.2.2.tgz", + "integrity": "sha512-dOt21O7lTMhDM+X9mB4GX+DZrZtCUJPL/wlcTqxyrx5IvO0IYtILdtrQGQp+8n5S0gwSVmOf9NQrjMOgfQZlIg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "esrecurse": "^4.3.0", + "estraverse": "^5.2.0" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/eslint/node_modules/brace-expansion": { + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/eslint/node_modules/minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/espree": { + "version": "9.6.1", + "resolved": "https://registry.npmjs.org/espree/-/espree-9.6.1.tgz", + "integrity": "sha512-oruZaFkjorTpF32kDSI5/75ViwGeZginGGy2NoOSg3Q9bnwlnmDm4HLnkl0RE3n+njDXR037aY1+x58Z/zFdwQ==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "acorn": "^8.9.0", + "acorn-jsx": "^5.3.2", + "eslint-visitor-keys": "^3.4.1" + }, + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, + "node_modules/esquery": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", + "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", + "dev": true, + "license": "BSD-3-Clause", + "dependencies": { + "estraverse": "^5.1.0" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "estraverse": "^5.2.0" + }, + "engines": { + "node": ">=4.0" + } + }, + "node_modules/estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=4.0" + } + }, + "node_modules/esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", + "dev": true, + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-glob": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", + "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.8" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fast-glob/node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", + "dev": true, + "license": "MIT" + }, + "node_modules/fastq": { + "version": "1.20.1", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz", + "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, + "node_modules/file-entry-cache": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-6.0.1.tgz", + "integrity": "sha512-7Gps/XWymbLk2QLYK4NzpMOrYjMhdIxXuIvy2QBsLE6ljuodKvdkWs/cpyJJ3CVIVpH0Oi1Hvg1ovbMzLdFBBg==", + "dev": true, + "license": "MIT", + "dependencies": { + "flat-cache": "^3.0.4" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", + "dev": true, + "license": "MIT", + "dependencies": { + "locate-path": "^6.0.0", + "path-exists": "^4.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/flat-cache": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-3.2.0.tgz", + "integrity": "sha512-CYcENa+FtcUKLmhhqyctpclsq7QF38pKjZHsGNiSQF5r4FtoKDWabFDl3hzaEQMvT1LHEysw5twgLvpYYb4vbw==", + "dev": true, + "license": "MIT", + "dependencies": { + "flatted": "^3.2.9", + "keyv": "^4.5.3", + "rimraf": "^3.0.2" + }, + "engines": { + "node": "^10.12.0 || >=12.0.0" + } + }, + "node_modules/flatted": { + "version": "3.4.2", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.2.tgz", + "integrity": "sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==", + "dev": true, + "license": "ISC" + }, + "node_modules/fs.realpath": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", + "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", + "dev": true, + "license": "ISC" + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me", + "dev": true, + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.3" + }, + "engines": { + "node": ">=10.13.0" + } + }, + "node_modules/glob/node_modules/brace-expansion": { + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/glob/node_modules/minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, + "node_modules/globals": { + "version": "13.24.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-13.24.0.tgz", + "integrity": "sha512-AhO5QUcj8llrbG09iWhPU2B204J1xnPeL8kQmVorSsy+Sjj1sk8gIyh6cUocGmH4L0UuhAJy+hJMRA4mgA4mFQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "type-fest": "^0.20.2" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/globby": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/globby/-/globby-11.1.0.tgz", + "integrity": "sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-union": "^2.1.0", + "dir-glob": "^3.0.1", + "fast-glob": "^3.2.9", + "ignore": "^5.2.0", + "merge2": "^1.4.1", + "slash": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/graphemer": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz", + "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==", + "dev": true, + "license": "MIT" + }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, + "node_modules/import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "parent-module": "^1.0.0", + "resolve-from": "^4.0.0" + }, + "engines": { + "node": ">=6" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.8.19" + } + }, + "node_modules/inflight": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", + "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", + "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", + "dev": true, + "license": "ISC", + "dependencies": { + "once": "^1.3.0", + "wrappy": "1" + } + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, + "node_modules/is-path-inside": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/is-path-inside/-/is-path-inside-3.0.3.tgz", + "integrity": "sha512-Fd4gABb+ycGAmKou8eMftCupSir5lRxqf4aD/vd0cD2qc4HL07OjCeuHMr8Ro4CoMaeCKDB0/ECBOVWjTwUvPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" + }, + "node_modules/js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", + "dev": true, + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", + "dev": true, + "license": "MIT" + }, + "node_modules/json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "json-buffer": "3.0.1" + } + }, + "node_modules/kleur": { + "version": "4.1.5", + "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz", + "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1", + "type-check": "~0.4.0" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-locate": "^5.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, + "node_modules/miniflare": { + "version": "4.20260415.0", + "resolved": "https://registry.npmjs.org/miniflare/-/miniflare-4.20260415.0.tgz", + "integrity": "sha512-JoExRWN4YBI2luA5BoSMFEgi8rQWXUGzo3mtE+58VXCLV3jj/Xnk5Yeqs/IXWz8Es5GJIaq6BtsixDvAxXSIng==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspotcode/source-map-support": "0.8.1", + "sharp": "^0.34.5", + "undici": "7.24.8", + "workerd": "1.20260415.1", + "ws": "8.18.0", + "youch": "4.1.0-beta.10" + }, + "bin": { + "miniflare": "bootstrap.js" + }, + "engines": { + "node": ">=18.0.0" + } + }, + "node_modules/minimatch": { + "version": "9.0.9", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz", + "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.2" + }, + "engines": { + "node": ">=16 || 14 >=14.17" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "dev": true, + "license": "MIT" + }, + "node_modules/natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" + }, + "node_modules/once": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", + "dev": true, + "license": "ISC", + "dependencies": { + "wrappy": "1" + } + }, + "node_modules/optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", + "dev": true, + "license": "MIT", + "dependencies": { + "deep-is": "^0.1.3", + "fast-levenshtein": "^2.0.6", + "levn": "^0.4.1", + "prelude-ls": "^1.2.1", + "type-check": "^0.4.0", + "word-wrap": "^1.2.5" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "yocto-queue": "^0.1.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "p-limit": "^3.0.2" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", + "dev": true, + "license": "MIT", + "dependencies": { + "callsites": "^3.0.0" + }, + "engines": { + "node": ">=6" + } + }, + "node_modules/path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-is-absolute": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", + "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/path-to-regexp": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-6.3.0.tgz", + "integrity": "sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/path-type": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz", + "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/pathe": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz", + "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==", + "dev": true, + "license": "MIT" + }, + "node_modules/picomatch": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/prettier": { + "version": "3.8.3", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.8.3.tgz", + "integrity": "sha512-7igPTM53cGHMW8xWuVTydi2KO233VFiTNyF5hLJqpilHfmn8C8gPf+PS7dUT64YcXFbiMGZxS9pCSxL/Dxm/Jw==", + "dev": true, + "license": "MIT", + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, + "node_modules/punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/rimraf": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz", + "integrity": "sha512-JZkJMZkAGFFPP2YqXZXPbMlMBgsxzE8ILs4lMIX/2o0L9UBw9O/Y3o6wFw/i9YLapcUJWwqbi3kdxIPdC62TIA==", + "deprecated": "Rimraf versions prior to v4 are no longer supported", + "dev": true, + "license": "ISC", + "dependencies": { + "glob": "^7.1.3" + }, + "bin": { + "rimraf": "bin.js" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, + "node_modules/semver": { + "version": "7.7.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", + "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/sharp": { + "version": "0.34.5", + "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.34.5.tgz", + "integrity": "sha512-Ou9I5Ft9WNcCbXrU9cMgPBcCK8LiwLqcbywW3t4oDV37n1pzpuNLsYiAV8eODnjbtQlSDwZ2cUEeQz4E54Hltg==", + "dev": true, + "hasInstallScript": true, + "license": "Apache-2.0", + "dependencies": { + "@img/colour": "^1.0.0", + "detect-libc": "^2.1.2", + "semver": "^7.7.3" + }, + "engines": { + "node": "^18.17.0 || ^20.3.0 || >=21.0.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-darwin-arm64": "0.34.5", + "@img/sharp-darwin-x64": "0.34.5", + "@img/sharp-libvips-darwin-arm64": "1.2.4", + "@img/sharp-libvips-darwin-x64": "1.2.4", + "@img/sharp-libvips-linux-arm": "1.2.4", + "@img/sharp-libvips-linux-arm64": "1.2.4", + "@img/sharp-libvips-linux-ppc64": "1.2.4", + "@img/sharp-libvips-linux-riscv64": "1.2.4", + "@img/sharp-libvips-linux-s390x": "1.2.4", + "@img/sharp-libvips-linux-x64": "1.2.4", + "@img/sharp-libvips-linuxmusl-arm64": "1.2.4", + "@img/sharp-libvips-linuxmusl-x64": "1.2.4", + "@img/sharp-linux-arm": "0.34.5", + "@img/sharp-linux-arm64": "0.34.5", + "@img/sharp-linux-ppc64": "0.34.5", + "@img/sharp-linux-riscv64": "0.34.5", + "@img/sharp-linux-s390x": "0.34.5", + "@img/sharp-linux-x64": "0.34.5", + "@img/sharp-linuxmusl-arm64": "0.34.5", + "@img/sharp-linuxmusl-x64": "0.34.5", + "@img/sharp-wasm32": "0.34.5", + "@img/sharp-win32-arm64": "0.34.5", + "@img/sharp-win32-ia32": "0.34.5", + "@img/sharp-win32-x64": "0.34.5" + } + }, + "node_modules/shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", + "dev": true, + "license": "MIT", + "dependencies": { + "shebang-regex": "^3.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-ansi": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", + "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/text-table": { + "version": "0.2.0", + "resolved": "https://registry.npmjs.org/text-table/-/text-table-0.2.0.tgz", + "integrity": "sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==", + "dev": true, + "license": "MIT" + }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, + "node_modules/ts-api-utils": { + "version": "1.4.3", + "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-1.4.3.tgz", + "integrity": "sha512-i3eMG77UTMD0hZhgRS562pv83RC6ukSAC2GMNWc+9dieh/+jDM5u5YG+NHX6VNDRHQcHwmsTHctP9LhbC3WxVw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=16" + }, + "peerDependencies": { + "typescript": ">=4.2.0" + } + }, + "node_modules/tslib": { + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", + "dev": true, + "license": "0BSD", + "optional": true + }, + "node_modules/type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", + "dev": true, + "license": "MIT", + "dependencies": { + "prelude-ls": "^1.2.1" + }, + "engines": { + "node": ">= 0.8.0" + } + }, + "node_modules/type-fest": { + "version": "0.20.2", + "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz", + "integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==", + "dev": true, + "license": "(MIT OR CC0-1.0)", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici": { + "version": "7.24.8", + "resolved": "https://registry.npmjs.org/undici/-/undici-7.24.8.tgz", + "integrity": "sha512-6KQ/+QxK49Z/p3HO6E5ZCZWNnCasyZLa5ExaVYyvPxUwKtbCPMKELJOqh7EqOle0t9cH/7d2TaaTRRa6Nhs4YQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20.18.1" + } + }, + "node_modules/unenv": { + "version": "2.0.0-rc.24", + "resolved": "https://registry.npmjs.org/unenv/-/unenv-2.0.0-rc.24.tgz", + "integrity": "sha512-i7qRCmY42zmCwnYlh9H2SvLEypEFGye5iRmEMKjcGi7zk9UquigRjFtTLz0TYqr0ZGLZhaMHl/foy1bZR+Cwlw==", + "dev": true, + "license": "MIT", + "dependencies": { + "pathe": "^2.0.3" + } + }, + "node_modules/uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", + "dev": true, + "license": "BSD-2-Clause", + "dependencies": { + "punycode": "^2.1.0" + } + }, + "node_modules/which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", + "dev": true, + "license": "ISC", + "dependencies": { + "isexe": "^2.0.0" + }, + "bin": { + "node-which": "bin/node-which" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/workerd": { + "version": "1.20260415.1", + "resolved": "https://registry.npmjs.org/workerd/-/workerd-1.20260415.1.tgz", + "integrity": "sha512-phyPjRnx+mQDfkhN9ENPioL1L0SdhYs4S0YmJK/xF9Oga+ykNfdSy1MHnsOj8yqnOV96zcVQMx32dJ0r3pq0jQ==", + "dev": true, + "hasInstallScript": true, + "license": "Apache-2.0", + "bin": { + "workerd": "bin/workerd" + }, + "engines": { + "node": ">=16" + }, + "optionalDependencies": { + "@cloudflare/workerd-darwin-64": "1.20260415.1", + "@cloudflare/workerd-darwin-arm64": "1.20260415.1", + "@cloudflare/workerd-linux-64": "1.20260415.1", + "@cloudflare/workerd-linux-arm64": "1.20260415.1", + "@cloudflare/workerd-windows-64": "1.20260415.1" + } + }, + "node_modules/wrangler": { + "version": "4.83.0", + "resolved": "https://registry.npmjs.org/wrangler/-/wrangler-4.83.0.tgz", + "integrity": "sha512-gw5g3LCiuAqVWxaoKY6+quE0HzAUEFb/FV3oAlNkE1ttd4XP3FiV91XDkkzUCcdqxS4WjhQvPhIDBNdhEi8P0A==", + "dev": true, + "license": "MIT OR Apache-2.0", + "dependencies": { + "@cloudflare/kv-asset-handler": "0.4.2", + "@cloudflare/unenv-preset": "2.16.0", + "blake3-wasm": "2.1.5", + "esbuild": "0.27.3", + "miniflare": "4.20260415.0", + "path-to-regexp": "6.3.0", + "unenv": "2.0.0-rc.24", + "workerd": "1.20260415.1" + }, + "bin": { + "wrangler": "bin/wrangler.js", + "wrangler2": "bin/wrangler.js" + }, + "engines": { + "node": ">=20.3.0" + }, + "optionalDependencies": { + "fsevents": "~2.3.2" + }, + "peerDependencies": { + "@cloudflare/workers-types": "^4.20260415.1" + }, + "peerDependenciesMeta": { + "@cloudflare/workers-types": { + "optional": true + } + } + }, + "node_modules/wrappy": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", + "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", + "dev": true, + "license": "ISC" + }, + "node_modules/ws": { + "version": "8.18.0", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.0.tgz", + "integrity": "sha512-8VbfWfHLbbwu3+N6OKsOMpBdT4kXPDDB9cJk2bJ6mh9ucxdlnNvH1e+roYkKmN9Nxw2yjz7VzeO9oOz2zJ04Pw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10.0.0" + }, + "peerDependencies": { + "bufferutil": "^4.0.1", + "utf-8-validate": ">=5.0.2" + }, + "peerDependenciesMeta": { + "bufferutil": { + "optional": true + }, + "utf-8-validate": { + "optional": true + } + } + }, + "node_modules/yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/youch": { + "version": "4.1.0-beta.10", + "resolved": "https://registry.npmjs.org/youch/-/youch-4.1.0-beta.10.tgz", + "integrity": "sha512-rLfVLB4FgQneDr0dv1oddCVZmKjcJ6yX6mS4pU82Mq/Dt9a3cLZQ62pDBL4AUO+uVrCvtWz3ZFUL2HFAFJ/BXQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@poppinss/colors": "^4.1.5", + "@poppinss/dumper": "^0.6.4", + "@speed-highlight/core": "^1.2.7", + "cookie": "^1.0.2", + "youch-core": "^0.3.3" + } + }, + "node_modules/youch-core": { + "version": "0.3.3", + "resolved": "https://registry.npmjs.org/youch-core/-/youch-core-0.3.3.tgz", + "integrity": "sha512-ho7XuGjLaJ2hWHoK8yFnsUGy2Y5uDpqSTq1FkHLK4/oqKtyUU1AFbOOxY4IpC9f0fTLjwYbslUz0Po5BpD1wrA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@poppinss/exception": "^1.2.2", + "error-stack-parser-es": "^1.0.5" + } + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000000..ffb49e4c48 --- /dev/null +++ b/package.json @@ -0,0 +1,18 @@ +{ + "name": "ethos-aegis-agentic-immune-veriflow", + "private": true, + "version": "1.0.0", + "description": "Ethos Aegis β€” Agentic Immune System with Veriflow and Claude Mythos", + "workspaces": [ + "veriflow/*" + ], + "devDependencies": { + "@cloudflare/workers-types": "^4.20241031.0", + "@typescript-eslint/eslint-plugin": "^7.0.0", + "@typescript-eslint/parser": "^7.0.0", + "eslint": "^8.0.0", + "prettier": "^3.0.0", + "typescript": "^5.0.0", + "wrangler": "^4.83.0" + } +} diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000000..6310ef760a --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,44 @@ +[build-system] +requires = ["setuptools>=68", "wheel"] +build-backend = "setuptools.build_meta" + +[project] +name = "ethos-aegis-agentic-immune-veriflow" +version = "1.0.0" +description = "Ethos Aegis β€” Agentic Immune System with Veriflow and Claude Mythos" +readme = "README.md" +license = { text = "MIT" } +requires-python = ">=3.9" +dependencies = [] + +[project.optional-dependencies] +dev = [ + "pytest>=9.0.3", + "flake8>=6.0", + "black>=23.0", + "isort>=5.0", + "mypy>=1.0", +] + +[tool.setuptools.packages.find] +where = ["."] +include = ["ethos_aegis*"] + +[tool.pytest.ini_options] +testpaths = ["tests"] +python_files = ["test_*.py"] +python_classes = ["Test*"] +python_functions = ["test_*"] + +[tool.black] +line-length = 127 +target-version = ["py39", "py310", "py311"] + +[tool.isort] +profile = "black" +line_length = 127 + +[tool.mypy] +python_version = "3.9" +strict = false +ignore_missing_imports = true diff --git a/release_summary_v1.0.0.md b/release_summary_v1.0.0.md new file mode 100644 index 0000000000..3fc6397a18 --- /dev/null +++ b/release_summary_v1.0.0.md @@ -0,0 +1,22 @@ +# Claude Mythos v1.0.0 Release Summary + +## Executive Summary +The Claude Mythos v1.0.0 release represents a significant milestone in our development journey, showcasing our commitment to delivering a robust and efficient ethical verification framework. + +## Technical Achievements +- Implemented core functionalities for agentic immune verification. +- Achieved a 30% improvement in processing times compared to previous versions. +- Integrated with various external APIs for enhanced data validation. + +## Merge Status +All features have been successfully merged into the main branch, and code reviews have been completed for all pull requests. We have passed regression testing, confirming stability. + +## Deployment Roadmap +1. **Phase 1**: Complete final testing by April 25, 2026. +2. **Phase 2**: Deploy to staging environment by May 1, 2026. +3. **Phase 3**: Final release scheduled for May 15, 2026. + +## Next Steps +- Monitor stability post-deployment. +- Gather user feedback for future enhancements. +- Start planning for v1.1.0 based on stakeholder input. \ No newline at end of file diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000000..189c7b6bc5 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,3 @@ +# Python test and runtime dependencies +pytest>=9.0.3 +flake8>=6.0,<8 diff --git a/schemas/agent_spec.schema.json b/schemas/agent_spec.schema.json new file mode 100644 index 0000000000..e36c5f5c45 --- /dev/null +++ b/schemas/agent_spec.schema.json @@ -0,0 +1,75 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$id": "https://goodshytgroup.github.io/ethos-aegis/schemas/agent_spec.schema.json", + "title": "Agent Spec", + "type": "object", + "required": [ + "schema_version", + "creator", + "system_role", + "use_case", + "business_goal", + "users", + "inputs", + "tools", + "responsibilities", + "constraints", + "required_output", + "success_criteria" + ], + "properties": { + "schema_version": {"type": "string"}, + "creator": {"type": "string"}, + "system_role": {"type": "string"}, + "use_case": {"type": "string"}, + "business_goal": {"type": "string"}, + "users": {"type": "array", "items": {"type": "string"}}, + "inputs": { + "oneOf": [ + {"type": "string"}, + {"type": "array", "items": {"type": "string"}} + ] + }, + "tools": { + "oneOf": [ + {"type": "string"}, + {"type": "array", "items": {"type": "string"}} + ] + }, + "responsibilities": { + "type": "array", + "items": {"type": "string"}, + "minItems": 1 + }, + "memory_requirements": { + "type": ["string", "null"] + }, + "constraints": { + "type": "object", + "required": [ + "tech_stack", + "model_provider", + "budget", + "latency", + "security_privacy", + "deployment_target" + ], + "properties": { + "tech_stack": {"type": "string"}, + "model_provider": {"type": "string"}, + "budget": {"type": "string"}, + "latency": {"type": "string"}, + "security_privacy": {"type": "string"}, + "deployment_target": {"type": "string"} + }, + "additionalProperties": true + }, + "required_output": { + "type": "array", + "items": {"type": "string"}, + "minItems": 1 + }, + "success_criteria": {"type": "string"} + }, + "additionalProperties": true +} diff --git a/scripts/push-merge-runbook.sh b/scripts/push-merge-runbook.sh new file mode 100644 index 0000000000..96b4e4049a --- /dev/null +++ b/scripts/push-merge-runbook.sh @@ -0,0 +1,77 @@ +#!/usr/bin/env bash +set -euo pipefail + +DEST_REPO="GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow" +SRC_REPO="GoodshytGroup/veriflow-Sovereign-Lattice" +MERGE_BRANCH="merge/veriflow-sovereign-lattice" +PR_TITLE="Merge veriflow-Sovereign-Lattice into Ethos monorepo preserving history" +PR_BODY="History-preserving repository consolidation for Veriflow into Ethos Aegis." + +log() { printf "[merge-runbook] %s\n" "$1"; } +die() { printf "[merge-runbook] ERROR: %s\n" "$1" >&2; exit 1; } + +require_repo_root() { + git rev-parse --show-toplevel >/dev/null 2>&1 || die "Run inside the destination git repository." +} + +ensure_auth() { + if command -v gh >/dev/null 2>&1; then + if gh auth status >/dev/null 2>&1; then + log "Using authenticated gh CLI session." + return 0 + fi + fi + + if [[ -n "${GITHUB_TOKEN:-}" ]]; then + log "Using GITHUB_TOKEN from environment." + return 0 + fi + + if [[ -n "${GH_TOKEN:-}" ]]; then + log "Using GH_TOKEN from environment." + return 0 + fi + + die "Authenticate with 'gh auth login' or export GITHUB_TOKEN / GH_TOKEN before running." +} + +configure_remote() { + if git remote get-url veriflow >/dev/null 2>&1; then + log "Remote 'veriflow' already configured." + else + git remote add veriflow "https://github.com/${SRC_REPO}.git" + log "Added remote: veriflow -> ${SRC_REPO}" + fi +} + +perform_merge() { + git fetch origin + git fetch veriflow + git checkout -B "${MERGE_BRANCH}" origin/main + git merge veriflow/main --allow-unrelated-histories -m "merge: import veriflow-Sovereign-Lattice history" +} + +push_and_open_pr() { + git push -u origin "${MERGE_BRANCH}" + if command -v gh >/dev/null 2>&1; then + gh pr create \ + --repo "${DEST_REPO}" \ + --base main \ + --head "${MERGE_BRANCH}" \ + --title "${PR_TITLE}" \ + --body "${PR_BODY}" || true + else + log "gh CLI not available; push completed. Open the PR manually in GitHub." + fi +} + +main() { + require_repo_root + ensure_auth + configure_remote + perform_merge + push_and_open_pr + log "Merge branch prepared. Resolve any conflicts, then merge the PR in GitHub." +} + +main "$@" diff --git a/sitecustomize.py b/sitecustomize.py new file mode 100644 index 0000000000..a572e76ca1 --- /dev/null +++ b/sitecustomize.py @@ -0,0 +1,21 @@ +"""Repository-local interpreter compatibility hooks. + +Python 3.9's ``dataclasses.dataclass`` does not accept ``slots=...``. +This shim makes repository code that uses ``@dataclass(slots=True)`` +import cleanly on 3.9 by ignoring the ``slots`` keyword on older runtimes. +""" + +from __future__ import annotations + +import dataclasses as _dataclasses +import sys as _sys + + +if _sys.version_info < (3, 10): + _original_dataclass = _dataclasses.dataclass + + def _compat_dataclass(*args, **kwargs): + kwargs.pop("slots", None) + return _original_dataclass(*args, **kwargs) + + _dataclasses.dataclass = _compat_dataclass diff --git a/skills/pinkybot_companion/SKILL.md b/skills/pinkybot_companion/SKILL.md new file mode 100644 index 0000000000..ebc1659a82 --- /dev/null +++ b/skills/pinkybot_companion/SKILL.md @@ -0,0 +1,46 @@ +# PinkyBot Companion + +## Purpose + +Provide a persistent companion-agent surface for Ethos Aegis using PinkyBot-style behavior: + +- persistent identity +- long-term memory +- wake scheduling +- messaging adapters +- dashboard-compatible agent state + +## Capabilities + +- receive inbound messages from approved platforms +- wake on explicit triggers +- reflect and recall durable memory +- summarize project state for the operator +- request approval before external or sensitive actions + +## Inputs + +- messages +- schedules +- webhook payloads +- file-change events +- URL watcher diffs + +## Guardrails + +- no hidden message sending +- no approval bypass for sensitive actions +- no persistent storage of secrets in plain text +- memory writes must be explicit and reviewable + +## Suggested tools + +- pinky-memory +- pinky-self +- pinky-messaging +- pinky-calendar +- Ethos runtime tools only where explicitly approved + +## Operator expectation + +Treat this as a companion layer, not as an unrestricted controller over the wider system. diff --git a/src/index.ts b/src/index.ts new file mode 100644 index 0000000000..803f77e1e1 --- /dev/null +++ b/src/index.ts @@ -0,0 +1,51 @@ +export interface Env {} + +function json(data: unknown, init: ResponseInit = {}): Response { + const headers = new Headers(init.headers); + headers.set("content-type", "application/json; charset=utf-8"); + return new Response(JSON.stringify(data, null, 2), { + ...init, + headers, + }); +} + +export default { + async fetch(request: Request, _env: Env): Promise { + const url = new URL(request.url); + + if (url.pathname === "/") { + return json({ + name: "Ethos Aegis Worker", + status: "ok", + runtime: "cloudflare-workers", + message: "Cloudflare Worker bootstrap is live.", + endpoints: ["/", "/health", "/meta"], + }); + } + + if (url.pathname === "/health") { + return json({ + ok: true, + service: "ethos-aegis-worker", + timestamp: new Date().toISOString(), + }); + } + + if (url.pathname === "/meta") { + return json({ + project: "Ethos-Aegis-Agentic-Immune-Veriflow", + deployment: "worker-bootstrap", + purpose: "Minimal deployment entrypoint for future agentic surfaces", + }); + } + + return json( + { + ok: false, + error: "Not Found", + path: url.pathname, + }, + { status: 404 }, + ); + }, +}; diff --git a/tests/test_budget.py b/tests/test_budget.py new file mode 100644 index 0000000000..98a48f3a5f --- /dev/null +++ b/tests/test_budget.py @@ -0,0 +1,115 @@ +from __future__ import annotations + +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +import pytest + +from ethos_aegis.mythos_runtime.budget import BudgetMeter + + +def test_initial_state() -> None: + meter = BudgetMeter() + assert meter.tokens_used == 0 + assert meter.turns_used == 0 + assert meter.token_ratio == 0.0 + assert meter.turn_ratio == 0.0 + assert meter.warning is False + assert meter.exhausted is False + + +def test_consume_tokens_and_turns() -> None: + meter = BudgetMeter() + meter.consume(tokens=1000, turns=1) + assert meter.tokens_used == 1000 + assert meter.turns_used == 1 + + +def test_consume_accumulates() -> None: + meter = BudgetMeter() + meter.consume(tokens=100) + meter.consume(tokens=200, turns=2) + assert meter.tokens_used == 300 + assert meter.turns_used == 3 # 1 (default) + 2 + + +def test_consume_ignores_negative_values() -> None: + meter = BudgetMeter() + meter.consume(tokens=-500, turns=-3) + assert meter.tokens_used == 0 + assert meter.turns_used == 0 + + +def test_token_ratio() -> None: + meter = BudgetMeter(max_tokens=1000) + meter.consume(tokens=500) + assert meter.token_ratio == pytest.approx(0.5) + + +def test_turn_ratio() -> None: + meter = BudgetMeter(max_turns=10) + meter.consume(tokens=0, turns=4) + assert meter.turn_ratio == pytest.approx(0.4) + + +def test_token_ratio_zero_max() -> None: + meter = BudgetMeter(max_tokens=0) + assert meter.token_ratio == 0.0 + + +def test_turn_ratio_zero_max() -> None: + meter = BudgetMeter(max_turns=0) + assert meter.turn_ratio == 0.0 + + +def test_warning_triggered_by_tokens() -> None: + meter = BudgetMeter(max_tokens=100, max_turns=100, warning_threshold=0.8) + meter.consume(tokens=80) + assert meter.warning is True + + +def test_warning_triggered_by_turns() -> None: + meter = BudgetMeter(max_tokens=100, max_turns=10, warning_threshold=0.8) + meter.consume(tokens=0, turns=8) + assert meter.warning is True + + +def test_warning_not_triggered_below_threshold() -> None: + meter = BudgetMeter(max_tokens=100, max_turns=100, warning_threshold=0.8) + meter.consume(tokens=79, turns=1) + assert meter.warning is False + + +def test_exhausted_by_tokens() -> None: + meter = BudgetMeter(max_tokens=100, max_turns=100) + meter.consume(tokens=100) + assert meter.exhausted is True + + +def test_exhausted_by_turns() -> None: + meter = BudgetMeter(max_tokens=100, max_turns=10) + meter.consume(tokens=0, turns=10) + assert meter.exhausted is True + + +def test_not_exhausted_when_below_limit() -> None: + meter = BudgetMeter(max_tokens=100, max_turns=100) + meter.consume(tokens=99, turns=1) + assert meter.exhausted is False + + +def test_exhausted_over_limit() -> None: + meter = BudgetMeter(max_tokens=100, max_turns=100) + meter.consume(tokens=200) + assert meter.exhausted is True + + +def test_custom_thresholds() -> None: + meter = BudgetMeter(max_tokens=1000, max_turns=50, warning_threshold=0.5) + meter.consume(tokens=500) + assert meter.warning is True + assert meter.exhausted is False diff --git a/tests/test_ckan_adapter.py b/tests/test_ckan_adapter.py new file mode 100644 index 0000000000..e1a05497b8 --- /dev/null +++ b/tests/test_ckan_adapter.py @@ -0,0 +1,200 @@ +from __future__ import annotations + +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +import pytest + +from ethos_aegis.veriflow.ckan_adapter import ( + CKANCapabilityMatrix, + CKANClient, + CKANVersion, + CapabilityRecord, + SchemaField, +) + + +# --------------------------------------------------------------------------- +# CKANVersion.parse +# --------------------------------------------------------------------------- + + +def test_parse_full_semver() -> None: + v = CKANVersion.parse("2.11.4") + assert v.major == 2 + assert v.minor == 11 + assert v.patch == 4 + assert v.prerelease is None + assert v.raw == "2.11.4" + + +def test_parse_empty_string_returns_unknown() -> None: + v = CKANVersion.parse("") + assert v.raw == "unknown" + assert v.major is None + + +def test_parse_none_like_empty() -> None: + v = CKANVersion.parse(" ") + assert v.raw == "unknown" + + +def test_parse_prerelease_alpha() -> None: + v = CKANVersion.parse("2.10a1") + assert v.major == 2 + assert v.minor == 10 + assert v.prerelease == "a1" + + +def test_parse_prerelease_rc() -> None: + v = CKANVersion.parse("3.0rc2") + assert v.major == 3 + assert v.prerelease == "rc2" + + +def test_parse_prerelease_beta() -> None: + v = CKANVersion.parse("2.9b3") + assert v.prerelease == "b3" + + +def test_parse_non_numeric_part() -> None: + v = CKANVersion.parse("2.x.1") + assert v.major == 2 + assert v.minor is None + assert v.patch == 1 + + +def test_parse_short_version() -> None: + v = CKANVersion.parse("2.11") + assert v.major == 2 + assert v.minor == 11 + assert v.patch is None + + +def test_parse_single_digit() -> None: + v = CKANVersion.parse("3") + assert v.major == 3 + assert v.minor is None + assert v.patch is None + + +# --------------------------------------------------------------------------- +# CKANCapabilityMatrix.supports +# --------------------------------------------------------------------------- + + +def _matrix_with(name: str, state: str) -> CKANCapabilityMatrix: + return CKANCapabilityMatrix( + api_base="https://example.com/api/3/action", + version=CKANVersion.parse("2.11.0"), + capabilities={name: CapabilityRecord(name=name, state=state)}, + ) + + +def test_supports_available() -> None: + assert _matrix_with("datastore", "available").supports("datastore") is True + + +def test_supports_inferred() -> None: + assert _matrix_with("datastore", "inferred").supports("datastore") is True + + +def test_supports_partial() -> None: + assert _matrix_with("datastore", "partial").supports("datastore") is True + + +def test_supports_unavailable() -> None: + assert _matrix_with("datastore", "unavailable").supports("datastore") is False + + +def test_supports_missing_key() -> None: + matrix = CKANCapabilityMatrix( + api_base="https://example.com", + version=CKANVersion.parse("2.11.0"), + capabilities={}, + ) + assert matrix.supports("datastore") is False + + +# --------------------------------------------------------------------------- +# CKANCapabilityMatrix.to_dict +# --------------------------------------------------------------------------- + + +def test_to_dict_structure() -> None: + matrix = CKANCapabilityMatrix( + api_base="https://example.com/api/3/action", + version=CKANVersion.parse("2.11.4"), + capabilities={ + "datastore": CapabilityRecord(name="datastore", state="available", source="api", detail="ok"), + }, + ) + d = matrix.to_dict() + assert d["api_base"] == "https://example.com/api/3/action" + assert d["version"]["major"] == 2 + assert d["version"]["minor"] == 11 + assert d["version"]["patch"] == 4 + assert "datastore" in d["capabilities"] + assert d["capabilities"]["datastore"]["state"] == "available" + assert d["capabilities"]["datastore"]["source"] == "api" + + +def test_to_dict_empty_capabilities() -> None: + matrix = CKANCapabilityMatrix( + api_base="https://x.com", + version=CKANVersion.parse("1.0.0"), + ) + d = matrix.to_dict() + assert d["capabilities"] == {} + + +# --------------------------------------------------------------------------- +# CKANClient +# --------------------------------------------------------------------------- + + +def test_ckan_client_probe_capabilities_returns_matrix() -> None: + client = CKANClient("https://data.example.com/") + matrix = client.probe_capabilities() + assert matrix.api_base == "https://data.example.com/api/3/action" + assert isinstance(matrix.version, CKANVersion) + assert matrix.capabilities == {} + + +def test_ckan_client_strips_trailing_slash() -> None: + client = CKANClient("https://data.example.com///") + assert not client.base_url.endswith("/") + + +def test_ckan_client_ingest_resource_raises() -> None: + client = CKANClient("https://data.example.com") + with pytest.raises(NotImplementedError): + client.ingest_resource("some-id") + + +def test_ckan_client_api_key_stored() -> None: + client = CKANClient("https://data.example.com", api_key="secret-token") + assert client.api_key == "secret-token" + + +# --------------------------------------------------------------------------- +# SchemaField defaults +# --------------------------------------------------------------------------- + + +def test_schema_field_defaults() -> None: + field = SchemaField(name="count") + assert field.field_type == "string" + assert field.label is None + assert field.aliases == () + + +def test_schema_field_custom() -> None: + field = SchemaField(name="visits", field_type="integer", label="Visits", unit="count") + assert field.field_type == "integer" + assert field.label == "Visits" + assert field.unit == "count" diff --git a/tests/test_cli.py b/tests/test_cli.py new file mode 100644 index 0000000000..2cf5b87bf1 --- /dev/null +++ b/tests/test_cli.py @@ -0,0 +1,145 @@ +from __future__ import annotations + +import json +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +from ethos_aegis.mythos_runtime.cli import build_parser, main +from ethos_aegis.mythos_runtime.memory import MemoryEvent, MemoryLedger +from ethos_aegis.mythos_runtime.swd import StrictWriteDiscipline + + +# --------------------------------------------------------------------------- +# build_parser +# --------------------------------------------------------------------------- + + +def test_build_parser_prog_name() -> None: + parser = build_parser() + assert parser.prog == "mythos-runtime" + + +def test_build_parser_verify_subcommand() -> None: + parser = build_parser() + args = parser.parse_args(["verify"]) + assert args.command == "verify" + assert args.json is False + + +def test_build_parser_verify_json_flag() -> None: + parser = build_parser() + args = parser.parse_args(["verify", "--json"]) + assert args.json is True + + +def test_build_parser_dream_defaults() -> None: + parser = build_parser() + args = parser.parse_args(["dream"]) + assert args.command == "dream" + assert args.max_entries == 100 + assert args.keep_recent == 20 + assert args.dry_run is False + + +def test_build_parser_dream_custom_values() -> None: + parser = build_parser() + args = parser.parse_args(["dream", "--max-entries", "50", "--keep-recent", "10", "--dry-run"]) + assert args.max_entries == 50 + assert args.keep_recent == 10 + assert args.dry_run is True + + +# --------------------------------------------------------------------------- +# main β€” verify command (no drifted files) +# --------------------------------------------------------------------------- + + +def test_main_verify_plain_output(tmp_path: Path, capsys) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + swd.write_text("file.txt", "stable\n") + + rc = main(["--root", str(tmp_path), "verify"]) + assert rc == 0 + captured = capsys.readouterr() + assert "verified=" in captured.out + assert "drifted=" in captured.out + + +def test_main_verify_json_output(tmp_path: Path, capsys) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + swd.write_text("file.txt", "stable\n") + + rc = main(["--root", str(tmp_path), "verify", "--json"]) + assert rc == 0 + captured = capsys.readouterr() + payload = json.loads(captured.out) + assert "verified" in payload + assert "drifted" in payload + assert "missing" in payload + assert "unknown" in payload + + +# --------------------------------------------------------------------------- +# main β€” verify command with drifted file +# --------------------------------------------------------------------------- + + +def test_main_verify_detects_drift(tmp_path: Path, capsys) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + swd.write_text("watch.txt", "original\n") + # Tamper outside SWD + (tmp_path / "watch.txt").write_text("tampered\n", encoding="utf-8") + + main(["--root", str(tmp_path), "--memory", "MEMORY.md", "verify", "--json"]) + captured = capsys.readouterr() + payload = json.loads(captured.out) + assert "watch.txt" in payload["drifted"] + + +# --------------------------------------------------------------------------- +# main β€” dream command +# --------------------------------------------------------------------------- + + +def test_main_dream_compresses(tmp_path: Path, capsys) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + for i in range(10): + ledger.append_event(MemoryEvent(event_type="x", summary=f"e{i}", payload={})) + + rc = main(["--root", str(tmp_path), "dream", "--max-entries", "5", "--keep-recent", "3"]) + assert rc == 0 + captured = capsys.readouterr() + result = json.loads(captured.out) + assert result["compressed"] is True + assert result["preserved"] == 3 + + +def test_main_dream_dry_run(tmp_path: Path, capsys) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + for i in range(6): + ledger.append_event(MemoryEvent(event_type="y", summary=f"e{i}", payload={})) + original = (tmp_path / "MEMORY.md").read_text(encoding="utf-8") + + main(["--root", str(tmp_path), "dream", "--max-entries", "3", "--keep-recent", "2", "--dry-run"]) + assert (tmp_path / "MEMORY.md").read_text(encoding="utf-8") == original + captured = capsys.readouterr() + result = json.loads(captured.out) + assert result.get("dry_run") is True + + +def test_main_dream_no_compress_needed(tmp_path: Path, capsys) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + ledger.append_event(MemoryEvent(event_type="z", summary="s", payload={})) + + rc = main(["--root", str(tmp_path), "dream", "--max-entries", "100"]) + assert rc == 0 + captured = capsys.readouterr() + result = json.loads(captured.out) + assert result["compressed"] is False diff --git a/tests/test_drift.py b/tests/test_drift.py new file mode 100644 index 0000000000..b0a613cfdb --- /dev/null +++ b/tests/test_drift.py @@ -0,0 +1,91 @@ +from __future__ import annotations + +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +from ethos_aegis.mythos_runtime.drift import DriftDetector, DriftScanResult +from ethos_aegis.mythos_runtime.memory import MemoryLedger +from ethos_aegis.mythos_runtime.swd import StrictWriteDiscipline + + +# --------------------------------------------------------------------------- +# Verified file β€” content unchanged +# --------------------------------------------------------------------------- + + +def test_drift_detector_reports_verified(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + swd.write_text("stable.txt", "no-change\n") + result = DriftDetector(tmp_path, ledger=ledger, swd=swd).scan() + assert "stable.txt" in result.verified + assert "stable.txt" not in result.drifted + + +# --------------------------------------------------------------------------- +# Missing file β€” was written but later deleted +# --------------------------------------------------------------------------- + + +def test_drift_detector_reports_missing(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + swd.write_text("gone.txt", "here\n") + (tmp_path / "gone.txt").unlink() + result = DriftDetector(tmp_path, ledger=ledger, swd=swd).scan() + assert "gone.txt" in result.missing + + +# --------------------------------------------------------------------------- +# Multiple files β€” mix of verified, drifted, missing +# --------------------------------------------------------------------------- + + +def test_drift_detector_mixed_states(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + + swd.write_text("ok.txt", "stable\n") + swd.write_text("changed.txt", "original\n") + swd.write_text("removed.txt", "content\n") + + # Drift changed.txt + (tmp_path / "changed.txt").write_text("different\n", encoding="utf-8") + # Remove removed.txt + (tmp_path / "removed.txt").unlink() + + result = DriftDetector(tmp_path, ledger=ledger, swd=swd).scan() + assert "ok.txt" in result.verified + assert "changed.txt" in result.drifted + assert "removed.txt" in result.missing + + +# --------------------------------------------------------------------------- +# DriftDetector creates its own SWD when not provided +# --------------------------------------------------------------------------- + + +def test_drift_detector_creates_swd_if_none(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + # Pass no swd β€” DriftDetector should instantiate one internally + detector = DriftDetector(tmp_path, ledger=ledger, swd=None) + result = detector.scan() + assert isinstance(result, DriftScanResult) + + +# --------------------------------------------------------------------------- +# Empty ledger yields empty result +# --------------------------------------------------------------------------- + + +def test_drift_detector_empty_ledger(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + result = DriftDetector(tmp_path, ledger=ledger, swd=swd).scan() + assert result.verified == [] + assert result.drifted == [] + assert result.missing == [] diff --git a/tests/test_immune_system.py b/tests/test_immune_system.py new file mode 100644 index 0000000000..129f7145d9 --- /dev/null +++ b/tests/test_immune_system.py @@ -0,0 +1,292 @@ +from __future__ import annotations + +import json +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +from ethos_aegis.veriflow.ckan_adapter import ( + CKANCapabilityMatrix, + CKANIngestionResult, + CKANVersion, + CapabilityRecord, + IngestionAttempt, + SchemaField, +) +from ethos_aegis.veriflow.immune_system import DatasetCacheEntry, VeriflowImmuneSystem + + +# --------------------------------------------------------------------------- +# Test doubles shared across tests +# --------------------------------------------------------------------------- + + +class FakeVerificationResult: + passed = True + issue_type = "" + + +class FakeVerifier: + def verify_source_snapshot(self, payload: str) -> FakeVerificationResult: + return FakeVerificationResult() + + +class FakeCKAN: + base_url = "https://fake.test" + + def probe_capabilities( + self, + *, + sample_resource_id: str | None = None, + ) -> CKANCapabilityMatrix: + return CKANCapabilityMatrix( + api_base="https://fake.test/api/3/action", + version=CKANVersion.parse("2.11.0"), + capabilities={ + "datastore": CapabilityRecord(name="datastore", state="available", source="test"), + }, + ) + + def ingest_resource(self, resource_id: str, **kwargs) -> CKANIngestionResult: + return CKANIngestionResult( + resource_id=resource_id, + package_id="pkg-test", + path="datastore", + rows=[{"value": 99}], + fields=[SchemaField(name="value", field_type="integer")], + resource={"id": resource_id}, + package={"id": "pkg-test"}, + attempts=[IngestionAttempt("datastore", True, "ok")], + metadata={"source": "datastore"}, + ) + + +# --------------------------------------------------------------------------- +# bootstrap / capability_matrix +# --------------------------------------------------------------------------- + + +def test_bootstrap_sets_capability_matrix(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + assert immune.capability_matrix is not None + assert immune.capability_matrix.supports("datastore") is True + + +def test_bootstrap_without_probe_on_startup(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + state_dir=tmp_path, + ) + assert immune.capability_matrix is None + + +def test_bootstrap_explicit_call(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + state_dir=tmp_path, + ) + matrix = immune.bootstrap() + assert immune.capability_matrix is matrix + + +# --------------------------------------------------------------------------- +# refresh_resource +# --------------------------------------------------------------------------- + + +def test_refresh_resource_returns_entry(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + entry = immune.refresh_resource("res-abc") + assert isinstance(entry, DatasetCacheEntry) + assert entry.resource_id == "res-abc" + assert entry.rows == [{"value": 99}] + assert entry.package_id == "pkg-test" + + +def test_refresh_resource_triggers_bootstrap_if_needed(tmp_path: Path) -> None: + """Calling refresh_resource without prior bootstrap should auto-bootstrap.""" + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + state_dir=tmp_path, + ) + assert immune.capability_matrix is None + immune.refresh_resource("res-xyz") + assert immune.capability_matrix is not None + + +def test_refresh_resource_digest_is_sha256_of_rows(tmp_path: Path) -> None: + import hashlib + + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + entry = immune.refresh_resource("r1") + expected = hashlib.sha256(json.dumps([{"value": 99}], sort_keys=True).encode()).hexdigest() + assert entry.digest == expected + + +# --------------------------------------------------------------------------- +# cache_entry +# --------------------------------------------------------------------------- + + +def test_cache_entry_returns_none_before_refresh(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + state_dir=tmp_path, + ) + assert immune.cache_entry("missing") is None + + +def test_cache_entry_returns_entry_after_refresh(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + immune.refresh_resource("r2") + assert immune.cache_entry("r2") is not None + assert immune.cache_entry("r2").resource_id == "r2" + + +# --------------------------------------------------------------------------- +# State persistence +# --------------------------------------------------------------------------- + + +def test_state_file_is_created(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + assert immune.state_file.exists() + + +def test_state_file_contains_resource_entry(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + immune.refresh_resource("r3") + state = json.loads(immune.state_file.read_text(encoding="utf-8")) + assert "r3" in state["resources"] + assert state["resources"]["r3"]["ingestion_path"] == "datastore" + + +def test_persist_host_state_false_does_not_create_file(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + persist_host_state=False, + state_dir=tmp_path, + ) + assert not immune.state_file.exists() + + +# --------------------------------------------------------------------------- +# _load_state β€” existing and corrupt state +# --------------------------------------------------------------------------- + + +def test_load_state_reuses_existing(tmp_path: Path) -> None: + immune1 = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + immune1.refresh_resource("r-persist") + + # Second instance reads back the same state + immune2 = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + state_dir=tmp_path, + ) + assert "r-persist" in immune2._state.get("resources", {}) + + +def test_load_state_handles_corrupt_json(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + # Corrupt the state file + immune.state_file.write_text("NOT VALID JSON", encoding="utf-8") + + # A new instance should gracefully fall back to a fresh state + immune2 = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + state_dir=tmp_path, + ) + assert immune2._state.get("host") == "https://fake.test" + assert immune2._state.get("resources") == {} + + +def test_load_state_handles_non_dict_json(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + immune.state_file.write_text("[1, 2, 3]", encoding="utf-8") + + immune2 = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + state_dir=tmp_path, + ) + assert isinstance(immune2._state, dict) + assert immune2._state.get("resources") == {} + + +# --------------------------------------------------------------------------- +# fingerprint_mode stored +# --------------------------------------------------------------------------- + + +def test_fingerprint_mode_stored(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=False, + fingerprint_mode="lightweight", + state_dir=tmp_path, + ) + assert immune.fingerprint_mode == "lightweight" + + +# --------------------------------------------------------------------------- +# Memory ledger logs resource_refresh events +# --------------------------------------------------------------------------- + + +def test_memory_ledger_has_resource_refresh_event(tmp_path: Path) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + probe_on_startup=True, + state_dir=tmp_path, + ) + immune.refresh_resource("r-mem") + memory_text = (tmp_path / "MEMORY.md").read_text(encoding="utf-8") + assert "resource_refresh" in memory_text + assert "r-mem" in memory_text diff --git a/tests/test_memory.py b/tests/test_memory.py new file mode 100644 index 0000000000..6c3ff1136b --- /dev/null +++ b/tests/test_memory.py @@ -0,0 +1,144 @@ +from __future__ import annotations + +import json +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +from ethos_aegis.mythos_runtime.memory import MemoryEvent, MemoryLedger + + +# --------------------------------------------------------------------------- +# MemoryEvent.to_markdown +# --------------------------------------------------------------------------- + + +def test_to_markdown_contains_event_type(tmp_path: Path) -> None: + event = MemoryEvent(event_type="test_event", summary="hello", payload={"k": 1}, created_at="2024-01-01T00:00:00+00:00") + md = event.to_markdown() + assert "test_event" in md + assert "hello" in md + assert "2024-01-01T00:00:00+00:00" in md + + +def test_to_markdown_valid_json_block() -> None: + event = MemoryEvent(event_type="e", summary="s", payload={"x": 42}) + md = event.to_markdown() + start = md.index("```json\n") + len("```json\n") + end = md.index("\n```", start) + parsed = json.loads(md[start:end]) + assert parsed["x"] == 42 + + +# --------------------------------------------------------------------------- +# MemoryLedger – basic append / list_events +# --------------------------------------------------------------------------- + + +def test_append_and_list_events(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + event = MemoryEvent(event_type="ping", summary="pong", payload={"n": 1}) + ledger.append_event(event) + events = ledger.list_events() + assert len(events) == 1 + assert events[0].event_type == "ping" + assert events[0].payload["n"] == 1 + + +def test_list_events_returns_empty_when_file_missing(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "nonexistent.md") + assert ledger.list_events() == [] + + +def test_ensure_exists_creates_file_and_parents(tmp_path: Path) -> None: + deep_path = tmp_path / "a" / "b" / "MEMORY.md" + ledger = MemoryLedger(deep_path) + ledger.ensure_exists() + assert deep_path.exists() + assert MemoryLedger.HEADER in deep_path.read_text(encoding="utf-8") + + +def test_ensure_exists_idempotent(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + ledger.ensure_exists() + ledger.ensure_exists() # second call must not overwrite + text = (tmp_path / "MEMORY.md").read_text(encoding="utf-8") + assert text.count("# MEMORY") == 1 + + +def test_list_events_skips_corrupt_sections(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + ledger.append_event(MemoryEvent(event_type="good", summary="ok", payload={})) + # Inject a malformed section + with (tmp_path / "MEMORY.md").open("a", encoding="utf-8") as f: + f.write("## NOTΒ·VALID\n\nsome text without json block\n\n") + events = ledger.list_events() + # Only the well-formed event should parse + assert all(e.event_type == "good" for e in events) + + +# --------------------------------------------------------------------------- +# MemoryLedger.compress +# --------------------------------------------------------------------------- + + +def test_compress_returns_false_when_below_limit(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + for i in range(3): + ledger.append_event(MemoryEvent(event_type="x", summary=f"e{i}", payload={"i": i})) + result = ledger.compress(max_entries=10, keep_recent=5) + assert result["compressed"] is False + assert result["events"] == 3 + + +def test_compress_dry_run_does_not_modify_file(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + for i in range(6): + ledger.append_event(MemoryEvent(event_type="x", summary=f"e{i}", payload={})) + original_text = (tmp_path / "MEMORY.md").read_text(encoding="utf-8") + result = ledger.compress(max_entries=3, keep_recent=2, dry_run=True) + assert result["compressed"] is True + assert result.get("dry_run") is True + assert (tmp_path / "MEMORY.md").read_text(encoding="utf-8") == original_text + + +def test_compress_keeps_recent_events(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + for i in range(10): + ledger.append_event(MemoryEvent(event_type="x", summary=f"event {i}", payload={"i": i})) + ledger.compress(max_entries=5, keep_recent=3) + events = ledger.list_events() + # One dream_summary + 3 preserved + assert len(events) == 4 + summaries = [e for e in events if e.event_type == "dream_summary"] + assert len(summaries) == 1 + + +def test_compress_summary_payload_counts(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + for i in range(8): + etype = "write" if i % 2 == 0 else "read" + ledger.append_event(MemoryEvent(event_type=etype, summary="s", payload={})) + ledger.compress(max_entries=4, keep_recent=2) + dream = next(e for e in ledger.list_events() if e.event_type == "dream_summary") + counts = dream.payload["event_type_counts"] + assert counts["write"] + counts["read"] == 6 # 8 - 2 archived + + +# --------------------------------------------------------------------------- +# MemoryLedger._type_counts +# --------------------------------------------------------------------------- + + +def test_type_counts_direct(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + events = [ + MemoryEvent(event_type="a", summary="", payload={}), + MemoryEvent(event_type="b", summary="", payload={}), + MemoryEvent(event_type="a", summary="", payload={}), + ] + counts = ledger._type_counts(events) + assert counts == {"a": 2, "b": 1} diff --git a/tests/test_mythos_brand_contract.py b/tests/test_mythos_brand_contract.py new file mode 100644 index 0000000000..dec3a6c17c --- /dev/null +++ b/tests/test_mythos_brand_contract.py @@ -0,0 +1,47 @@ +from pathlib import Path + + +ROOT = Path(__file__).resolve().parents[1] + + +def _read(relative_path: str) -> str: + return (ROOT / relative_path).read_text(encoding="utf-8") + + +def test_mythos_identity_files_exist() -> None: + required = [ + "CLAUDE_MYTHOS.md", + "brand/claude-mythos-brand-kit.md", + "brand/github-partner-branding-kit.md", + "docs/readme-mythos-section.md", + "interactive/mythos_control_panel.html", + "assets/brand/claude-mythos-wordmark.svg", + "assets/brand/ethos-aegis-mythos-lockup.svg", + ] + for relative_path in required: + assert (ROOT / relative_path).exists(), f"Missing required file: {relative_path}" + + +def test_mythos_contract_language_is_aligned() -> None: + operating_contract = _read("CLAUDE_MYTHOS.md") + brand_kit = _read("brand/claude-mythos-brand-kit.md") + partner_kit = _read("brand/github-partner-branding-kit.md") + readme_section = _read("docs/readme-mythos-section.md") + + expected_phrases = [ + "Claude Mythos", + "Veriflow", + "Trust the verified path.", + "fingerprint_mode=\"auto\"", + ] + + joined = "\n".join([operating_contract, brand_kit, partner_kit, readme_section]) + for phrase in expected_phrases: + assert phrase in joined, f"Expected phrase missing: {phrase}" + + +def test_interactive_panel_mentions_core_modes() -> None: + html = _read("interactive/mythos_control_panel.html") + assert "verification-first" in html + assert "datastore_lightweight" in html + assert "schema-rich+datastore" in html diff --git a/tests/test_mythos_runtime.py b/tests/test_mythos_runtime.py new file mode 100644 index 0000000000..f6d3af890c --- /dev/null +++ b/tests/test_mythos_runtime.py @@ -0,0 +1,133 @@ +from __future__ import annotations + +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +from ethos_aegis.mythos_runtime import ( # noqa: E402 + DriftDetector, + MemoryEvent, + MemoryLedger, + StrictWriteDiscipline, +) +from ethos_aegis.veriflow.ckan_adapter import ( # noqa: E402 + CKANCapabilityMatrix, + CKANIngestionResult, + CKANVersion, + CapabilityRecord, + IngestionAttempt, + SchemaField, +) +from ethos_aegis.veriflow.immune_system import VeriflowImmuneSystem # noqa: E402 + + +class FakeVerificationResult: + passed = True + issue_type = "" + + +class FakeVerifier: + def verify_source_snapshot(self, payload: str) -> FakeVerificationResult: + return FakeVerificationResult() + + +class FakeCKAN: + base_url = "https://example.test" + + def probe_capabilities( + self, + *, + sample_resource_id: str | None = None, + ) -> CKANCapabilityMatrix: + capabilities = { + "datastore": CapabilityRecord( + name="datastore", + state="available", + source="test", + ) + } + return CKANCapabilityMatrix( + api_base="https://example.test/api/3/action", + version=CKANVersion.parse("2.11.4"), + capabilities=capabilities, + ) + + def ingest_resource(self, resource_id: str, **kwargs) -> CKANIngestionResult: + return CKANIngestionResult( + resource_id=resource_id, + package_id="pkg-1", + path="datastore", + rows=[{"visits": 10, "clicks": 2}], + fields=[ + SchemaField(name="visits", field_type="integer"), + SchemaField(name="clicks", field_type="integer"), + ], + resource={"id": resource_id, "package_id": "pkg-1"}, + package={"id": "pkg-1"}, + attempts=[ + IngestionAttempt("datastore", True, "selected datastore") + ], + metadata={"source": "datastore"}, + ) + + +def test_strict_write_discipline_verifies_create_and_modify( + tmp_path: Path, +) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + + create = swd.write_text("a.txt", "alpha\n", description="create") + modify = swd.write_text("a.txt", "beta\n", description="modify") + + assert create.ok is True + assert modify.ok is True + assert len(ledger.list_events()) >= 2 + + +def test_drift_detector_flags_changed_file(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + swd.write_text("a.txt", "alpha\n") + (tmp_path / "a.txt").write_text("changed\n", encoding="utf-8") + + result = DriftDetector(tmp_path, ledger=ledger, swd=swd).scan() + assert "a.txt" in result.drifted + + +def test_memory_compress_summarizes_old_entries(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + for idx in range(6): + ledger.append_event( + MemoryEvent( + event_type="write", + summary=f"event {idx}", + payload={"idx": idx}, + ) + ) + result = ledger.compress(max_entries=3, keep_recent=2) + assert result["compressed"] is True + events = ledger.list_events() + assert any(event.event_type == "dream_summary" for event in events) + + +def test_immune_system_persists_state_through_swd_and_logs_memory( + tmp_path: Path, +) -> None: + immune = VeriflowImmuneSystem( + FakeCKAN(), + verifier=FakeVerifier(), + probe_on_startup=True, + state_dir=tmp_path, + ) + immune.refresh_resource("res-1") + + assert immune.state_file.exists() + memory_path = tmp_path / "MEMORY.md" + assert memory_path.exists() + memory_text = memory_path.read_text(encoding="utf-8") + assert "verified_write" in memory_text + assert "resource_refresh" in memory_text diff --git a/tests/test_swd.py b/tests/test_swd.py new file mode 100644 index 0000000000..cf5cc64866 --- /dev/null +++ b/tests/test_swd.py @@ -0,0 +1,188 @@ +from __future__ import annotations + +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +from ethos_aegis.mythos_runtime.memory import MemoryLedger +from ethos_aegis.mythos_runtime.swd import ClaimedFileAction, StrictWriteDiscipline + + +# --------------------------------------------------------------------------- +# snapshot β€” all files (no paths argument) +# --------------------------------------------------------------------------- + + +def test_snapshot_all_files(tmp_path: Path) -> None: + (tmp_path / "a.txt").write_text("hello", encoding="utf-8") + (tmp_path / "b.txt").write_text("world", encoding="utf-8") + swd = StrictWriteDiscipline(tmp_path) + snap = swd.snapshot() + assert "a.txt" in snap + assert "b.txt" in snap + assert snap["a.txt"].exists is True + assert snap["b.txt"].sha256 is not None + + +def test_snapshot_ignores_pycache(tmp_path: Path) -> None: + (tmp_path / "kept.txt").write_text("x", encoding="utf-8") + pycache = tmp_path / "__pycache__" + pycache.mkdir() + (pycache / "mod.pyc").write_bytes(b"bytecode") + swd = StrictWriteDiscipline(tmp_path) + snap = swd.snapshot() + assert "kept.txt" in snap + for key in snap: + assert "__pycache__" not in key + assert key.endswith(".pyc") is False + + +def test_snapshot_custom_ignore_patterns(tmp_path: Path) -> None: + (tmp_path / "keep.py").write_text("x", encoding="utf-8") + (tmp_path / "skip.log").write_text("y", encoding="utf-8") + swd = StrictWriteDiscipline(tmp_path, ignore_patterns=["*.log"]) + snap = swd.snapshot() + assert "keep.py" in snap + assert "skip.log" not in snap + + +def test_snapshot_nonexistent_path_returns_missing(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) + snap = swd.snapshot(["does_not_exist.txt"]) + assert snap["does_not_exist.txt"].exists is False + assert snap["does_not_exist.txt"].sha256 is None + + +# --------------------------------------------------------------------------- +# verify_claims β€” DELETE action +# --------------------------------------------------------------------------- + + +def test_verify_claims_delete(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) + (tmp_path / "del.txt").write_text("bye", encoding="utf-8") + before = swd.snapshot(["del.txt"]) + (tmp_path / "del.txt").unlink() + after = swd.snapshot(["del.txt"]) + report = swd.verify_claims( + [ClaimedFileAction("del.txt", "DELETE", "removed")], + before, + after, + ) + assert report.ok is True + assert report.detail == "verified" + + +def test_verify_claims_mismatch_create_existing_file(tmp_path: Path) -> None: + """CREATE claim fails when file already existed before.""" + swd = StrictWriteDiscipline(tmp_path) + (tmp_path / "exists.txt").write_text("old", encoding="utf-8") + before = swd.snapshot(["exists.txt"]) + (tmp_path / "exists.txt").write_text("new", encoding="utf-8") + after = swd.snapshot(["exists.txt"]) + report = swd.verify_claims( + [ClaimedFileAction("exists.txt", "CREATE")], + before, + after, + ) + assert report.ok is False + assert "mismatch" in report.detail + + +def test_verify_claims_dry_run_accepts_all(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) + before = swd.snapshot(["ghost.txt"]) # doesn't exist + after = swd.snapshot(["ghost.txt"]) # still doesn't exist + report = swd.verify_claims( + [ClaimedFileAction("ghost.txt", "CREATE")], + before, + after, + dry_run=True, + ) + assert report.ok is True # dry_run always appends claimed action + assert report.dry_run is True + + +def test_verify_claims_modify(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) + (tmp_path / "mod.txt").write_text("original", encoding="utf-8") + before = swd.snapshot(["mod.txt"]) + (tmp_path / "mod.txt").write_text("changed", encoding="utf-8") + after = swd.snapshot(["mod.txt"]) + report = swd.verify_claims( + [ClaimedFileAction("mod.txt", "MODIFY")], + before, + after, + ) + assert report.ok is True + + +def test_verify_claims_modify_same_content_fails(tmp_path: Path) -> None: + """MODIFY requires that sha256 actually changed.""" + swd = StrictWriteDiscipline(tmp_path) + (tmp_path / "same.txt").write_text("constant", encoding="utf-8") + snapshot = swd.snapshot(["same.txt"]) + report = swd.verify_claims( + [ClaimedFileAction("same.txt", "MODIFY")], + snapshot, + snapshot, + ) + assert report.ok is False + + +# --------------------------------------------------------------------------- +# write_text β€” dry_run +# --------------------------------------------------------------------------- + + +def test_write_text_dry_run_does_not_create_file(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) + report = swd.write_text("new.txt", "content\n", dry_run=True) + assert report.dry_run is True + assert not (tmp_path / "new.txt").exists() + + +def test_write_text_without_ledger(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) # no memory_ledger + report = swd.write_text("solo.txt", "data\n") + assert report.ok is True + assert (tmp_path / "solo.txt").read_text(encoding="utf-8") == "data\n" + + +# --------------------------------------------------------------------------- +# _record_report β€” no ledger is a no-op +# --------------------------------------------------------------------------- + + +def test_record_report_no_op_without_ledger(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) # no memory_ledger + # Should not raise + report = swd.write_text("x.txt", "y\n") + assert report.ok is True + + +# --------------------------------------------------------------------------- +# _normalize +# --------------------------------------------------------------------------- + + +def test_normalize_converts_backslashes(tmp_path: Path) -> None: + swd = StrictWriteDiscipline(tmp_path) + normalized = swd._normalize(Path("sub\\file.txt")) + assert "\\" not in normalized + + +# --------------------------------------------------------------------------- +# StrictWriteDiscipline with ledger integration +# --------------------------------------------------------------------------- + + +def test_ledger_records_write_events(tmp_path: Path) -> None: + ledger = MemoryLedger(tmp_path / "MEMORY.md") + swd = StrictWriteDiscipline(tmp_path, memory_ledger=ledger) + swd.write_text("rec.txt", "recorded\n", description="ledger-test") + events = ledger.list_events() + assert any(e.event_type == "verified_write" for e in events) diff --git a/tox.ini b/tox.ini new file mode 100644 index 0000000000..ee7f1c173a --- /dev/null +++ b/tox.ini @@ -0,0 +1,32 @@ +[tox] +envlist = py39,py310,py311 +skipsdist = true + +[testenv] +deps = + pytest>=7.0 + flake8>=6.0 +commands = + flake8 ethos_aegis/ tests/ \ + --count \ + --select=E9,F63,F7,F82 \ + --show-source \ + --statistics + flake8 ethos_aegis/ tests/ \ + --count \ + --max-complexity=10 \ + --max-line-length=127 \ + --statistics + pytest tests/ -q + +[flake8] +max-line-length = 127 +max-complexity = 10 +exclude = + .git, + __pycache__, + .tox, + .venv, + venv, + dist, + build diff --git a/tsconfig.json b/tsconfig.json new file mode 100644 index 0000000000..bf1642b7f2 --- /dev/null +++ b/tsconfig.json @@ -0,0 +1,16 @@ +{ + "compilerOptions": { + "target": "ES2022", + "module": "ES2022", + "moduleResolution": "bundler", + "lib": ["ES2022"], + "strict": true, + "noEmit": true, + "skipLibCheck": true, + "resolveJsonModule": true, + "allowImportingTsExtensions": true, + "types": ["@cloudflare/workers-types"] + }, + "include": ["src/**/*.ts"], + "exclude": ["node_modules", "dist"] +} diff --git a/veriflow-Sovereign-Lattice b/veriflow-Sovereign-Lattice new file mode 100644 index 0000000000..96905cbce1 --- /dev/null +++ b/veriflow-Sovereign-Lattice @@ -0,0 +1,45 @@ +Run it from the root of GoodshytGroup/Ethos-Aegis-Agentic-Immune-Veriflow: + +git checkout main +git pull origin main +chmod +x scripts/push-merge-runbook.sh +./scripts/push-merge-runbook.sh + +What it should do: + β€’ verify GitHub auth + β€’ add veriflow-Sovereign-Lattice as a remote if needed + β€’ fetch both repos + β€’ create merge/veriflow-sovereign-lattice + β€’ perform the unrelated-history merge + β€’ push the branch + β€’ try to open the PR automatically + +If it completes cleanly, the next step is to open the merge PR in GitHub, review it, and merge it. + +If it stops on conflicts, run: + +git status + +Then resolve conflicts with this rule: + β€’ keep Ethos versions for runtime, workflows, Worker config, scripts, branding, and integrations + β€’ move conflicting Veriflow docs/assets into namespaced folders like: + β€’ docs/veriflow/ + β€’ assets/veriflow/ + β€’ packages/veriflow/ + +Then finish with: + +git add . +git commit +git push + +After the PR is merged: + +gh repo archive GoodshytGroup/veriflow-Sovereign-Lattice --yes + +Then validate the merged repo: + +pytest tests/test_mythos_runtime.py -q +npx wrangler versions upload + +Some earlier uploaded files have expired on my side. To reuse any of those again, upload them once more. diff --git a/wrangler.jsonc b/wrangler.jsonc new file mode 100644 index 0000000000..fba1874109 --- /dev/null +++ b/wrangler.jsonc @@ -0,0 +1,20 @@ +{ + "name": "ethos-aegis-agentic-immune-veriflow", + "compatibility_date": "2026-04-13", + "main": "src/index.ts", + "observability": { + "enabled": false, + "head_sampling_rate": 1, + "logs": { + "enabled": true, + "head_sampling_rate": 1, + "persist": true, + "invocation_logs": true + }, + "traces": { + "enabled": false, + "persist": true, + "head_sampling_rate": 1 + } + } +} \ No newline at end of file