diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 6875e1d..f90a82c 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -1,9 +1,32 @@ -name: CI +name: Legacy Runtime integrity on: + workflow_dispatch: push: branches: [main] + paths: + - "brain/**" + - "bot/**" + - "scheduler/**" + - "storage/**" + - "tests/**" + - "tools/**" + - "main.py" + - "config.py" + - "requirements.txt" + - ".github/workflows/ci.yml" pull_request: branches: [main] + paths: + - "brain/**" + - "bot/**" + - "scheduler/**" + - "storage/**" + - "tests/**" + - "tools/**" + - "main.py" + - "config.py" + - "requirements.txt" + - ".github/workflows/ci.yml" jobs: test: @@ -12,11 +35,11 @@ jobs: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 with: - python-version: '3.11' - cache: 'pip' + python-version: "3.11" + cache: "pip" - run: pip install -r requirements.txt - - run: pip install pytest ruff + - run: pip install pytest ruff==0.16.3 - name: Lint - run: ruff check . + run: ruff check . --select E4,E7,E9,F --exclude publication - name: Test run: python -m pytest tests/ -v -k "not docker" --tb=short diff --git a/.github/workflows/publication-ci.yml b/.github/workflows/publication-ci.yml new file mode 100644 index 0000000..9744c3e --- /dev/null +++ b/.github/workflows/publication-ci.yml @@ -0,0 +1,85 @@ +name: AgentSutra publication CI + +on: + pull_request: + paths: + - "README.md" + - "publication/**" + - ".github/workflows/publication-ci.yml" + push: + branches: [main] + paths: + - "README.md" + - "publication/**" + - ".github/workflows/publication-ci.yml" + +permissions: + contents: read + +concurrency: + group: agentsutra-publication-${{ github.ref }} + cancel-in-progress: true + +defaults: + run: + working-directory: publication + +jobs: + verify: + name: Verify static publication + runs-on: ubuntu-24.04 + timeout-minutes: 30 + steps: + - name: Check out repository + uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6 + + - name: Use exact Node.js runtime + uses: actions/setup-node@249970729cb0ef3589644e2896645e5dc5ba9c38 # v6 + with: + node-version: 24.19.0 + cache: npm + cache-dependency-path: publication/package-lock.json + + - name: Confirm runtime and install locked dependencies + run: | + npm install --global npm@11.17.0 + node --version + npm --version + npm ci + + - name: Validate source, content, privacy, and pre-launch output + run: npm run verify + + - name: Prove the public release profile fails closed + run: npm run verify:public-profile + + - name: Install pinned Playwright browsers + run: npx --no-install playwright install --with-deps chromium firefox webkit + + - name: Run cross-browser and accessibility tests + run: npm run test:e2e + + - name: Install PDF inspection tools + run: | + sudo apt-get update + sudo apt-get install --yes --no-install-recommends poppler-utils + + - name: Validate deterministic social export + env: + INCLUDE_FIXTURES: "1" + EXPORT_MODE: "1" + run: npm run export:verify + + - name: Rebuild clean pre-launch output + run: | + npm run build + npm run privacy:scan + npm run verify:dist + + - name: Validate Cloudflare package without deploying + env: + WRANGLER_LOG_PATH: /tmp/agentsutra-wrangler.log + run: npm run deploy:dry-run + + - name: Rehearse clean source and validated preview archives + run: npm run release:artifacts diff --git a/AGENTSUTRA.md b/AGENTSUTRA.md index b1b032d..c941774 100644 --- a/AGENTSUTRA.md +++ b/AGENTSUTRA.md @@ -1,4 +1,10 @@ -# AgentSutra v9.0.0 - Complete Project Documentation +# AgentSutra Runtime v9.0.0 — frozen historical documentation + +> **Archive notice:** The Mac mini that hosted this Runtime was reset. The Runtime is unsupported, +> receives no feature development and must not be described as currently operating. The active +> flagship is the evidence-led publication in [`publication/`](publication/). The documentation +> below records the system as it was last described and may contain claims that require fresh +> verification before reuse. A Telegram-driven AI agent server running on Mac Mini M2 (16GB). Receives tasks via Telegram, processes them through a LangGraph Plan-Execute-Audit pipeline powered by Claude API, and delivers results back. Features: project registry with shared auto-managed venv, cross-model adversarial auditing (Sonnet+Opus), full internet access, local AI orchestration (Ollama), big data processing, production frontend generation, Docker container isolation for code execution, static deployment (GitHub Pages, Vercel, Firebase Hosting), local server preview with auto-kill, Playwright visual verification, 7 task types, 19 commands, budget enforcement with cost analytics, RAM guards, code content scanner with 28 patterns (Tier 4 + Tier 5 JS) + AST-based checks for importlib and shutil.rmtree, 39-pattern command blocklist, fabrication detection, truncation recovery, environment error detection, project dependency bootstrapping, streaming for extended thinking, honest failure delivery, partial result preservation, cross-task memory, model routing, task chaining, task retry, system setup validation, Ollama health monitoring, purpose-dependent model routing, and 840 automated tests (804 passing, 36 deselected). @@ -18,18 +24,18 @@ The user is the system's owner, operator, and sole consumer. There are no untrus Every architectural decision in this codebase was made through the lens of: **"What is the right engineering choice for a single-user personal system running on dedicated hardware?"** Reviewers applying enterprise/multi-tenant criteria will find gaps that are intentional, not oversights: -| Decision | Rationale | -|----------|-----------| -| **SQLite, not PostgreSQL** | Single-user on one machine. SQLite handles thousands of writes/second with WAL mode. Connection pooling is unnecessary — connection-per-call with 20s timeout is simpler and correct for this workload. | -| **No LLM abstraction layer** | This is a Claude-powered system by design. Abstracting the provider adds complexity for a hypothetical migration that may never happen. If it does, the 5 node files are straightforward to adapt. | -| **Telegram-only interface** | The user controls the system from their phone. A REST API or web UI would add attack surface, authentication complexity, and maintenance burden for zero practical benefit. | +| Decision | Rationale | +| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| **SQLite, not PostgreSQL** | Single-user on one machine. SQLite handles thousands of writes/second with WAL mode. Connection pooling is unnecessary — connection-per-call with 20s timeout is simpler and correct for this workload. | +| **No LLM abstraction layer** | This is a Claude-powered system by design. Abstracting the provider adds complexity for a hypothetical migration that may never happen. If it does, the 5 node files are straightforward to adapt. | +| **Telegram-only interface** | The user controls the system from their phone. A REST API or web UI would add attack surface, authentication complexity, and maintenance burden for zero practical benefit. | | **Blocklist + Docker + Opus audit, not a capability-based sandbox** | The threat model is LLM hallucination, not adversarial users. The blocklist catches accidental destructive commands. Docker isolates filesystem access. Opus audits output quality. These three layers are sufficient for a system where the only user is the owner. A capability-based sandbox (seccomp, AppArmor) would be over-engineering for this threat model. | -| **Docker isolation is opt-in, not default** | Many tasks require packages not pre-installed in the Docker image. Subprocess mode with the code content scanner provides adequate protection for a single-user system. Docker is recommended but not forced. | -| **No Prometheus/StatsD/structured logging** | `/cost`, `/health`, `/usage`, and `/status` commands provide all the observability a single operator needs. JSON logs and metrics exporters serve teams with dashboards and alerting infrastructure — this system has neither. | -| **No multi-user isolation** | `ALLOWED_USER_IDS` is a flat allowlist. All users share `workspace/outputs/`. This is correct because there is one user. Per-user workspace isolation, RBAC, and tenant separation are multi-tenant concerns. | -| **Synchronous pipeline in `asyncio.to_thread()`** | The bot handles 5-30 tasks/day. The synchronous LangGraph pipeline occupies one thread for 15-60 seconds per task. With `MAX_CONCURRENT_TASKS=3`, this uses 3 threads at peak. An async pipeline would add complexity for no measurable benefit at this scale. | -| **`psutil` RAM guard instead of cgroups** | Simple, cross-platform, sufficient. A Mac Mini with 16GB RAM serving one user does not need container-level memory isolation. | -| **APScheduler 3.x, not Celery** | Celery requires Redis/RabbitMQ infrastructure. APScheduler with SQLite persistence gives cron-like scheduling with zero external dependencies. Appropriate for a system running on one machine. | +| **Docker isolation is opt-in, not default** | Many tasks require packages not pre-installed in the Docker image. Subprocess mode with the code content scanner provides adequate protection for a single-user system. Docker is recommended but not forced. | +| **No Prometheus/StatsD/structured logging** | `/cost`, `/health`, `/usage`, and `/status` commands provide all the observability a single operator needs. JSON logs and metrics exporters serve teams with dashboards and alerting infrastructure — this system has neither. | +| **No multi-user isolation** | `ALLOWED_USER_IDS` is a flat allowlist. All users share `workspace/outputs/`. This is correct because there is one user. Per-user workspace isolation, RBAC, and tenant separation are multi-tenant concerns. | +| **Synchronous pipeline in `asyncio.to_thread()`** | The bot handles 5-30 tasks/day. The synchronous LangGraph pipeline occupies one thread for 15-60 seconds per task. With `MAX_CONCURRENT_TASKS=3`, this uses 3 threads at peak. An async pipeline would add complexity for no measurable benefit at this scale. | +| **`psutil` RAM guard instead of cgroups** | Simple, cross-platform, sufficient. A Mac Mini with 16GB RAM serving one user does not need container-level memory isolation. | +| **APScheduler 3.x, not Celery** | Celery requires Redis/RabbitMQ infrastructure. APScheduler with SQLite persistence gives cron-like scheduling with zero external dependencies. Appropriate for a system running on one machine. | ### Design Philosophy @@ -209,6 +215,7 @@ AgentSutra/ ## Every File Explained ### `main.py` - Entry Point + - Imports `config` first to ensure `.env` is loaded before any other module - Configures logging to both console and `agentsutra.log` via `RotatingFileHandler` (10MB max, 3 backups) to prevent unbounded log growth (v6.5) - Validates three required env vars: `ANTHROPIC_API_KEY`, `TELEGRAM_BOT_TOKEN`, `ALLOWED_USER_IDS` -- exits with clear error if any missing @@ -220,6 +227,7 @@ AgentSutra/ - Starts bot in long-polling mode with `drop_pending_updates=True` (ignores messages sent while bot was offline) ### `config.py` - Configuration + - Loads `.env` at import time via `python-dotenv` - Defines all path constants: `BASE_DIR`, `WORKSPACE_DIR`, `UPLOADS_DIR`, `OUTPUTS_DIR`, `PROJECTS_DIR`, `DB_PATH` - Auto-creates all workspace directories and `storage/` directory on import via `mkdir(parents=True, exist_ok=True)` @@ -233,18 +241,21 @@ AgentSutra/ - **Visual check config (v8.3):** `VISUAL_CHECK_ENABLED`, `VISUAL_CHECK_TIMEOUT` ### `projects.yaml` - Project Registry (v2) + - YAML file defining 8 registered projects the agent can invoke instead of writing code from scratch - Each project entry has: `name`, `path` (absolute), `description` (multiline, Claude reads this), `commands` (named shell commands with `{placeholder}` parameters), `timeout` (seconds), `requires_file` (boolean), `triggers` (keyword list for matching) - Current projects: Affiliate Job Scraper, Jobs Analysis Pipeline v4, iGaming Intelligence Dashboard, Work Reports Generator, Domain Categorisation, Industry Voices Benchmarks, Suppliers Database, Newsletter Benchmarks - Paths must be updated when transferring to a different machine ### `bot/telegram_bot.py` - Bot Setup + - Creates `ApplicationBuilder` with bot token from config - Registers 19 command handlers: `/start`, `/status`, `/history`, `/usage`, `/cost`, `/health`, `/exec`, `/context`, `/cancel`, `/retry`, `/projects`, `/schedule`, `/chain`, `/debug`, `/deploy`, `/servers`, `/stopserver`, `/setup`, `/reindex` - Registers file handlers (Document, Photo) before text handler to ensure proper routing - Text handler is catch-all for non-command messages via `filters.TEXT & ~filters.COMMAND` ### `bot/handlers.py` - Request Handling (v6.2+: resource guards, rate limiter, v8 commands) + - `auth_required` decorator: wraps every handler, rejects Telegram users not in `ALLOWED_USER_IDS`, uses `@functools.wraps` for proper function metadata - `STAGE_LABELS` dict: maps internal stage names to user-friendly streaming status messages - **`_check_resources()` (v6.2):** checks RAM usage via `psutil` and active task count before launching pipeline. Returns rejection message or None. @@ -271,6 +282,7 @@ AgentSutra/ - `_send_long_message`: splits text at line boundaries respecting Telegram's 4096-char limit, hard-splits individual lines that exceed the limit ### `brain/state.py` - State Definition + - `AgentState(TypedDict)` with 23 fields across 10 groups: - **Input:** `task_id` (str), `user_id` (int), `message` (str), `files` (list of paths) - **Classification:** `task_type` (str: "code" | "data" | "file" | "automation" | "project" | "ui_design" | "frontend") @@ -285,6 +297,7 @@ AgentSutra/ - **Output:** `final_response` (str), `artifacts` (list of file paths), `server_url` (str, v8.2), `deploy_url` (str, v8.1) ### `brain/graph.py` - LangGraph Pipeline + - Thread-safe stage tracking via `_task_stages` dict protected by `threading.Lock` -- enables real-time streaming status to Telegram from the worker thread - `set_stage()` / `get_stage()` / `clear_stage()`: thread-safe stage management - `_wrap_node()`: wraps each pipeline node function to automatically call `set_stage()` with the node name before execution @@ -294,6 +307,7 @@ AgentSutra/ - `run_task()`: populates initial state with all 23 fields defaulted (including `stage_timings`, `server_url`, `deploy_url`), invokes the compiled graph, clears stage tracking in `finally` block ### `brain/nodes/classifier.py` - Task Classification (v2: project-aware) + - **Fast path (v2):** calls `match_project()` first to check for trigger keyword matches before calling Claude; if matched, immediately returns `task_type: "project"` with project config -- no API call needed - **Slow path:** sends message to Claude with classification prompt that includes all registered projects summary via `get_all_projects_summary()` - 7 categories: `project` (v2), `frontend`, `ui_design`, `code`, `data`, `file`, `automation` @@ -303,6 +317,7 @@ AgentSutra/ - If Claude classifies as "project" but fast path missed it, does a second `match_project()` call ### `brain/nodes/planner.py` - Plan Generation (v2 + v8: TDD, project mode, memory, file injection, security) + - **TDD_INSTRUCTION (v2):** constant appended to all non-project system prompts, instructs Claude to write `assert` statements that verify correctness -- data tasks assert row counts and column names, code tasks include at least 2 assertions, file tasks assert output exists, all end with "ALL ASSERTIONS PASSED" - **CAPABILITIES_BLOCK:** shared system capabilities injected into all planner prompts (internet, runtime installs, Ollama, filesystem, shell, big data rules). Braces in code examples are escaped for `.format()` compatibility. - **PROJECT_SYSTEM (v2):** dedicated system prompt for project tasks -- injects full project context (name, path, description, commands, timeout) via `get_project_context()`, explicitly instructs Claude to use existing commands instead of writing new code @@ -315,6 +330,7 @@ AgentSutra/ - On retry: appends audit feedback + previous execution output (up to 3K chars) to prompt, asks for revised plan ### `brain/nodes/executor.py` - Code Generation + Execution (v2: shell mode + traceback injection) + - Two execution paths based on task type: - **`_execute_project()` (v2):** generates a bash script from the plan using SHELL_GEN_SYSTEM prompt, executes via `run_shell()` with project's working directory and timeout, passes project's venv path if configured - **`_execute_code()`:** generates Python/JS code from the plan, strips markdown code blocks via regex, executes via `run_code()` in sandbox @@ -324,6 +340,7 @@ AgentSutra/ - Both paths guard against empty code generation ### `brain/nodes/auditor.py` - Quality Verification (v2 + v6.5 + v8.3: cross-model adversarial review, fail-safe defaults, visual check) + - **Cross-model auditing (v2):** executor uses `DEFAULT_MODEL` (Sonnet), auditor uses `COMPLEX_MODEL` (Opus) -- a different, more capable model reviews the work of the generating model, preventing the "echo chamber" effect where the same model approves its own output - Strict evaluation criteria: checks exit code, assertion results (looks for "ALL ASSERTIONS PASSED"), traceback presence, output correctness, completeness - v2: project-specific audit criteria -- checks that project commands actually ran and produced expected output @@ -334,6 +351,7 @@ AgentSutra/ - Uses `temperature=0.0` for deterministic auditing ### `brain/nodes/deliverer.py` - Response Formatting (v7 + v8: memory, deployment, screenshots) + - Formats final text response based on task type and audit verdict - Project tasks (v2): shows project name in success message ("Project 'X' executed successfully.") - Code tasks: includes code in backtick blocks (truncated at 3500 chars with note about attached file) @@ -347,6 +365,7 @@ AgentSutra/ - **Debug sidecar (v8.0):** Builds per-task debug JSON (timings, verdict, retries, server_url, deploy_url) for `/debug` command ### `tools/claude_client.py` - Claude API Wrapper + - Lazy client initialization via `_get_client()` -- only creates `Anthropic` client on first API call - **Budget enforcement (v6.2):** `_check_budget()` runs before every API call. Queries daily and monthly spend from `api_usage` table against `DAILY_BUDGET_USD` / `MONTHLY_BUDGET_USD`. Raises `BudgetExceededError` (subclass of `RuntimeError`) if exceeded. Gracefully degrades on DB errors (allows call, logs warning). - `call()`: sends message to Claude with retry logic (up to `MAX_RETRIES` attempts): @@ -365,6 +384,7 @@ AgentSutra/ - `get_usage_summary()` **(v2.2: reads from DB):** returns lifetime totals (calls, input tokens, output tokens) from persistent storage, not ephemeral session data ### `tools/sandbox.py` - Code Execution (v2 + v6.2 + v6.3 + v6.4 + v6.5 + v6.6: shell mode, traceback extraction, expanded safety, Docker isolation, process group kill, code scanner) + - `ExecutionResult` dataclass: `success`, `stdout`, `stderr`, `traceback` (v2), `files_created`, `timed_out`, `return_code`, `auto_installed` (v6.3) - **Command blocklist (v6.6+, 39 patterns):** `_BLOCKED_PATTERNS` checks all commands before execution. Patterns include: `rm -rf` (root/home/critical dirs), `mkfs`, `dd if=`, `shutdown/reboot/halt/poweroff`, `fork bomb`, `sudo`, `curl|sh`, `curl|bash`, `wget|sh`, `wget|bash`, `chmod 777/a+rwx`, interpreter inline execution (`python -c`, `perl -e`, `ruby -e`, `node -e`), destructive find (`-delete`, `-exec rm`), base64 decode piped to shell, home directory relocation (`mv ~/`), dotfile write/append redirects (`.bashrc`, `.ssh`, `.gitconfig`, etc.), symlink attacks on dotfiles, printf/echo piped to shell, eval with command substitution, bash/sh -c string splitting. Blocked commands return failure with security warning. - **Code content scanner (v6.6):** `_check_code_safety()` scans Python code content before subprocess execution. Blocks credential file reads (`~/.ssh/`, `~/.gnupg/`, `.env`, PEM, id_rsa), `os.system()`, `shutil.rmtree(~/root)`, raw socket connections, `/etc/passwd|shadow` reads. Not applied in Docker mode. Defense-in-depth, not a security boundary. @@ -379,6 +399,7 @@ AgentSutra/ - **Server management (v8.2):** Thread-safe server registry with `start_server()`, `stop_server()`, `stop_all_servers()`, `list_servers()`. Port allocation from configurable range (8100-8120), HTTP polling for readiness, auto-kill timer via `threading.Timer`. Executor auto-starts `python3 -m http.server` for frontend/ui_design tasks after HTML generation. ### `tools/projects.py` - Project Registry (v2) + - `load_projects()`: reads `projects.yaml` via `yaml.safe_load()`, caches in module-level `_projects` list - `get_projects()`: returns cached list, auto-loads if empty - `match_project()`: iterates all projects' trigger keywords (case-insensitive substring match), scores by trigger length (longer = more specific), returns best match or `None` @@ -386,6 +407,7 @@ AgentSutra/ - `get_all_projects_summary()`: one-line summary of each project with first 3 triggers, used in classifier's system prompt ### `tools/model_router.py` - Model Router (v8.0.0) + - Routes LLM calls to Claude or Ollama based on purpose, complexity, RAM availability, and daily budget - `route_and_call()` is the main entry point — drop-in replacement for `claude_client.call()` with routing intelligence - Routing rules: audit → always Opus, code_gen → always Sonnet, low-complexity classify/plan → Ollama if available @@ -395,6 +417,7 @@ AgentSutra/ - `_ollama_available()` checks Ollama API with 2-second timeout; `_ram_below_threshold()` uses psutil ### `tools/deployer.py` - Static Deployment (v8.1 + v8.4) + - Module for deploying generated frontend artifacts to live URLs - `deploy(output_dir, project_name)`: main entry point — routes to provider-specific function based on `config.DEPLOY_PROVIDER` - **GitHub Pages (v8.1):** `_deploy_github_pages()` — uses `gh` CLI to push to a dedicated repo's branch. Requires `DEPLOY_REPO` and `DEPLOY_GITHUB_TOKEN`. @@ -404,6 +427,7 @@ AgentSutra/ - Credential safety: `DEPLOY_FIREBASE_TOKEN` is stripped from subprocess env via `PROTECTED_ENV_SUBSTRINGS` containing "TOKEN" ### `tools/visual_check.py` - Playwright Visual Verification (v8.3) + - `VisualCheckResult` dataclass: `checked`, `loads`, `status_code`, `console_errors`, `screenshot_path`, `error` - `check_page(url, screenshot_dir, timeout)`: launches headless Chromium via Playwright, navigates to URL, captures console errors via callback, takes full-page screenshot, returns structured result - **Graceful degradation:** imports `playwright.sync_api` inside the function — if Playwright is not installed, returns `VisualCheckResult(checked=False)` with no crash @@ -411,6 +435,7 @@ AgentSutra/ - Used by `auditor.py` to inject visual context into the Opus audit prompt ### `tools/file_manager.py` - File Operations + - `save_upload()`: validates against `MAX_FILE_SIZE_BYTES`, saves bytes to uploads dir with UUID-based unique filenames (`{stem}_{uuid4_hex8}{suffix}`) to prevent TOCTOU race conditions (v6.7) - `get_file_content()`: reads text files with UTF-8 encoding (errors="replace"), truncates at `max_chars` (default 50K), returns binary file description for non-text files - `list_outputs()`: lists files in outputs directory @@ -418,6 +443,7 @@ AgentSutra/ - `ensure_project_dir()`: creates named subdirectory under `workspace/projects/` ### `storage/db.py` - SQLite Persistence + - `init_db()`: creates `tasks` table with 11 columns if not exists. **v6.2:** enables `PRAGMA journal_mode=WAL` for concurrent write safety. - Schema: `id` (TEXT PK), `user_id` (INTEGER), `message` (TEXT), `task_type` (TEXT), `status` (TEXT, default "pending"), `plan` (TEXT), `result` (TEXT), `error` (TEXT), `token_usage` (TEXT/JSON), `created_at` (TEXT/ISO), `completed_at` (TEXT/ISO) - `create_task()`: inserts new record with UTC timestamp @@ -429,6 +455,7 @@ AgentSutra/ - Each function opens and closes its own connection (acceptable for SQLite, avoids connection sharing across async contexts) ### `scheduler/cron.py` - Task Scheduling (v2: SQLite-backed persistence) + - `AsyncIOScheduler` with `SQLAlchemyJobStore` backed by a **separate** SQLite database (`storage/scheduler.db`) to avoid lock contention with the main aiosqlite database (`storage/agentsutra.db`) -- scheduled tasks survive process restarts and reboots - `start_scheduler()`: starts scheduler, logs count of persisted jobs loaded from DB - `stop_scheduler()`: graceful shutdown with `wait=False` @@ -442,21 +469,22 @@ AgentSutra/ ### Dependencies (requirements.txt) -| Library | Version | Purpose | Why This One | Used In | -|---------|---------|---------|--------------|---------| -| **anthropic** | >=0.50.0 | Claude API SDK | Direct SDK, not LangChain wrapper. Cleaner API, typed error classes (RateLimitError, APITimeoutError, APIError), lower overhead than langchain-anthropic. Full control over retries and token tracking. | `tools/claude_client.py` | -| **langgraph** | >=0.2.0 | Agent orchestration | State-based cyclic graph for Plan-Execute-Audit loops. Supports conditional edges (retry routing after audit). Built by LangChain team, production-grade. TypedDict state makes data flow explicit. | `brain/graph.py` | -| **langchain-core** | >=0.3.0 | LangGraph dependency | Required by langgraph for base types and graph primitives. Not imported directly in our code. | (transitive) | -| **python-telegram-bot** | >=21.0 | Telegram interface | v21+ is fully async-native. ApplicationBuilder pattern, composable filters, context-based handlers with user_data for state. Most mature Python Telegram library. Supports message editing for streaming status. | `bot/telegram_bot.py`, `bot/handlers.py` | -| **aiosqlite** | >=0.20.0 | Async SQLite | Wraps sqlite3 in async/await. Lightweight, no server process. Perfect for single-machine task persistence. Row factory support for dict-like access. | `storage/db.py` | -| **apscheduler** | >=3.10.0 | Task scheduling | AsyncIOScheduler integrates with asyncio event loop. Supports interval scheduling and SQLAlchemy job store for persistence across reboots. | `scheduler/cron.py` | -| **sqlalchemy** | >=2.0.0 | APScheduler job store | Provides the SQLAlchemyJobStore backend so APScheduler can persist scheduled jobs to SQLite. Not used directly for ORM. | `scheduler/cron.py` (via APScheduler) | -| **python-dotenv** | >=1.0.0 | Environment variables | Loads `.env` file into `os.environ` at import time. Industry standard for secret management. | `config.py` | -| **pyyaml** | >=6.0.0 | YAML parsing | Parses `projects.yaml` registry via `yaml.safe_load()`. Safe loader prevents arbitrary code execution from YAML. | `tools/projects.py` | +| Library | Version | Purpose | Why This One | Used In | +| ----------------------- | -------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | +| **anthropic** | >=0.50.0 | Claude API SDK | Direct SDK, not LangChain wrapper. Cleaner API, typed error classes (RateLimitError, APITimeoutError, APIError), lower overhead than langchain-anthropic. Full control over retries and token tracking. | `tools/claude_client.py` | +| **langgraph** | >=0.2.0 | Agent orchestration | State-based cyclic graph for Plan-Execute-Audit loops. Supports conditional edges (retry routing after audit). Built by LangChain team, production-grade. TypedDict state makes data flow explicit. | `brain/graph.py` | +| **langchain-core** | >=0.3.0 | LangGraph dependency | Required by langgraph for base types and graph primitives. Not imported directly in our code. | (transitive) | +| **python-telegram-bot** | >=21.0 | Telegram interface | v21+ is fully async-native. ApplicationBuilder pattern, composable filters, context-based handlers with user_data for state. Most mature Python Telegram library. Supports message editing for streaming status. | `bot/telegram_bot.py`, `bot/handlers.py` | +| **aiosqlite** | >=0.20.0 | Async SQLite | Wraps sqlite3 in async/await. Lightweight, no server process. Perfect for single-machine task persistence. Row factory support for dict-like access. | `storage/db.py` | +| **apscheduler** | >=3.10.0 | Task scheduling | AsyncIOScheduler integrates with asyncio event loop. Supports interval scheduling and SQLAlchemy job store for persistence across reboots. | `scheduler/cron.py` | +| **sqlalchemy** | >=2.0.0 | APScheduler job store | Provides the SQLAlchemyJobStore backend so APScheduler can persist scheduled jobs to SQLite. Not used directly for ORM. | `scheduler/cron.py` (via APScheduler) | +| **python-dotenv** | >=1.0.0 | Environment variables | Loads `.env` file into `os.environ` at import time. Industry standard for secret management. | `config.py` | +| **pyyaml** | >=6.0.0 | YAML parsing | Parses `projects.yaml` registry via `yaml.safe_load()`. Safe loader prevents arbitrary code execution from YAML. | `tools/projects.py` | ### Usage Examples From Actual Code **anthropic** -- `tools/claude_client.py` + ```python from anthropic import Anthropic, APIError, APITimeoutError, RateLimitError @@ -474,6 +502,7 @@ output_tokens = response.usage.output_tokens ``` **langgraph** -- `brain/graph.py` + ```python from langgraph.graph import StateGraph, START, END @@ -492,6 +521,7 @@ result = agent_graph.invoke(initial_state) ``` **python-telegram-bot** -- `bot/handlers.py` + ```python from telegram import Update from telegram.ext import ContextTypes @@ -506,6 +536,7 @@ while not task_future.done(): ``` **aiosqlite** -- `storage/db.py` + ```python import aiosqlite async with aiosqlite.connect(config.DB_PATH) as db: @@ -519,6 +550,7 @@ async with aiosqlite.connect(config.DB_PATH) as db: ``` **apscheduler + sqlalchemy** -- `scheduler/cron.py` + ```python from apscheduler.schedulers.asyncio import AsyncIOScheduler from apscheduler.jobstores.sqlalchemy import SQLAlchemyJobStore @@ -532,6 +564,7 @@ scheduler.start() ``` **pyyaml** -- `tools/projects.py` + ```python import yaml with open(_REGISTRY_PATH) as f: @@ -577,6 +610,7 @@ cp .env.example .env ``` Edit `.env` with your actual values: + ``` ANTHROPIC_API_KEY=sk-ant-your-key-here TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz @@ -592,6 +626,7 @@ MAX_FILE_SIZE_MB=50 #### Budget Controls (Optional but Recommended) Add daily and/or monthly API spend limits to `.env` to prevent runaway costs: + ``` DAILY_BUDGET_USD=5 # Max $5/day on API calls MONTHLY_BUDGET_USD=50 # Max $50/month on API calls @@ -628,6 +663,7 @@ projects: ``` If you have no external projects to register, you can leave the file with an empty list: + ```yaml projects: [] ``` @@ -640,6 +676,7 @@ python main.py ``` Expected startup output: + ``` AgentSutra starting up Allowed user IDs: [123456789] @@ -660,15 +697,20 @@ For isolated code execution (prevents LLM-generated code from accessing host fil 1. Install Docker Desktop for Mac: https://docs.docker.com/desktop/install/mac-install/ 2. Launch Docker Desktop and wait for it to fully start 3. Build the sandbox image: + ```bash chmod +x scripts/build_sandbox.sh ./scripts/build_sandbox.sh ``` + 4. Enable in `.env`: + ``` DOCKER_ENABLED=true ``` + 5. Optional configuration: + ``` DOCKER_MEMORY_LIMIT=2g # Max memory per container DOCKER_CPU_LIMIT=2 # Max CPU cores per container @@ -680,6 +722,7 @@ Without Docker, code executes via subprocess with full user-level access (protec ### Step 7: Test Open Telegram, find your bot, and send `/start`. Then try: + - `Write a Python function that checks if a number is prime` (code task) - Send a CSV file, then type `Analyze this data and create a chart` (data task) - `Run the job scraper` (project invocation) @@ -764,6 +807,7 @@ mkdir -p ~/Library/LaunchAgents ``` Create `~/Library/LaunchAgents/com.agentsutra.bot.plist`: + ```xml `) to prevent collision with generated code 3. Runs in the project's working directory with optional venv activation 4. Uses the project's configured timeout (can be up to 900s for long-running scrapers) **Code execution:** + 1. Claude generates Python/JS code from the plan 2. Markdown code blocks stripped via regex 3. Code written to temp file and executed via `subprocess.run()` in `workspace/outputs/` 4. Default 60s timeout Both paths: + - Capture stdout (max 50K chars) and stderr (max 20K chars) - Detect newly created files by directory diffing - Extract full Python tracebacks from stderr (v2) -- exact file names and line numbers are preserved for the retry loop @@ -1051,6 +1102,7 @@ Both paths: Cross-model adversarial review (v2): The auditor runs on Opus while the executor runs on Sonnet. This prevents the "echo chamber" effect where the same model would approve its own flawed output. A different model is more likely to catch subtle errors. Strict evaluation: + 1. Does the output actually accomplish the task? (not just "runs without errors") 2. Did execution succeed (exit code 0)? 3. Did all TDD assertions pass? (looks for "ALL ASSERTIONS PASSED") @@ -1060,6 +1112,7 @@ Strict evaluation: 7. **Visual verification (v8.3):** For frontend/ui_design tasks with a `server_url`, runs Playwright headless check and appends results (page loads, HTTP status, console errors) to the audit prompt before Opus review Returns JSON verdict: + - `"pass"` --> route to deliver - `"fail"` --> increment retry_count, route back to plan (up to MAX_RETRIES times) @@ -1072,6 +1125,7 @@ The feedback field contains specific, actionable fix instructions that get injec **Model:** DEFAULT_MODEL (Sonnet) Generates a polished Telegram-ready summary via Claude: + - Receives original request, execution output, code description, and artifact list - Claude produces a concise, structured summary (under 1800 chars for Telegram) - Falls back to template-based formatting if Claude call fails @@ -1084,39 +1138,39 @@ Generates a polished Telegram-ready summary via Claude: ### Pipeline Cost Summary -| Scenario | Claude Calls | Models Used | -|----------|-------------|-------------| -| Project task (trigger match, no retry) | 4 | Sonnet (plan, execute, deliver) + Opus (audit) | -| Project task (Claude classification, no retry) | 5 | Sonnet (classify, plan, execute, deliver) + Opus (audit) | -| Code task (no retry) | 5 | Sonnet (classify, plan, execute, deliver) + Opus (audit) | -| Any task with 1 retry | +3 | Sonnet (plan, execute) + Opus (audit) per retry | -| Any task with max retries (3) | up to 14 | Sonnet + Opus per iteration, Sonnet deliver at end | -| Frontend task with deploy | +0 (no extra Claude calls) | Deploy uses CLI subprocess, not LLM | +| Scenario | Claude Calls | Models Used | +| ---------------------------------------------- | -------------------------- | -------------------------------------------------------- | +| Project task (trigger match, no retry) | 4 | Sonnet (plan, execute, deliver) + Opus (audit) | +| Project task (Claude classification, no retry) | 5 | Sonnet (classify, plan, execute, deliver) + Opus (audit) | +| Code task (no retry) | 5 | Sonnet (classify, plan, execute, deliver) + Opus (audit) | +| Any task with 1 retry | +3 | Sonnet (plan, execute) + Opus (audit) per retry | +| Any task with max retries (3) | up to 14 | Sonnet + Opus per iteration, Sonnet deliver at end | +| Frontend task with deploy | +0 (no extra Claude calls) | Deploy uses CLI subprocess, not LLM | --- ## Telegram Bot Commands -| Command | Description | Example | -|---------|-------------|---------| -| `/start` | Welcome message with capabilities list and all available commands | `/start` | -| `/status` | Shows active tasks; `/status ` shows partial pipeline state: plan, audit, timings (v8.6) | `/status` or `/status a1b2` | -| `/history` | Last 5 tasks with status indicators (done/err/stop/...) | `/history` | -| `/usage` | Session API token usage: total calls, input tokens, output tokens | `/usage` --> "Total calls: 12, Input tokens: 45,230..." | -| `/cost` | 7-day daily breakdown by day and model, budget remaining, lifetime totals (v8.6) | `/cost` | -| `/health` | System health: RAM %, disk free, Ollama, active tasks, pipeline perf stats (v8.6) | `/health` | -| `/exec` | Execute a shell command directly via sandbox safety checks | `/exec ls -la ~/Desktop` | -| `/context` | View or clear conversation memory and recent history | `/context` or `/context clear` | -| `/cancel` | Cancel all running tasks (v2: cancels multiple), updates DB status | `/cancel` --> "Cancelled 2 task(s)." | -| `/projects` | List all registered projects with their commands and triggers (v2) | `/projects` --> "Affiliate Job Scraper (scrape, export, stats)..." | -| `/schedule` | Schedule recurring tasks, list scheduled tasks, or remove them (v2) | See below | -| `/chain` | Execute strict-AND task chain with artifact passing (v8.0) | `/chain Scrape jobs -> Analyze results -> Send report` | -| `/debug` | Per-task debug JSON: timings, verdict, retries, server/deploy URLs (v8.0) | `/debug a1b2c3d4` | -| `/deploy` | Manually deploy a task's frontend artifacts to configured provider (v8.1) | `/deploy a1b2c3d4` | -| `/servers` | List running local preview servers with port, PID, uptime (v8.2) | `/servers` | -| `/stopserver` | Stop a local server by task ID or stop all (v8.2) | `/stopserver a1b2c3d4` or `/stopserver all` | -| `/retry` | Re-run failed/crashed tasks with same input (v8.6) | `/retry` or `/retry a1b2c3d4` | -| `/setup` | Validate system config: env vars, Ollama, projects, DB, budget (v8.6) | `/setup` | +| Command | Description | Example | +| ------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | +| `/start` | Welcome message with capabilities list and all available commands | `/start` | +| `/status` | Shows active tasks; `/status ` shows partial pipeline state: plan, audit, timings (v8.6) | `/status` or `/status a1b2` | +| `/history` | Last 5 tasks with status indicators (done/err/stop/...) | `/history` | +| `/usage` | Session API token usage: total calls, input tokens, output tokens | `/usage` --> "Total calls: 12, Input tokens: 45,230..." | +| `/cost` | 7-day daily breakdown by day and model, budget remaining, lifetime totals (v8.6) | `/cost` | +| `/health` | System health: RAM %, disk free, Ollama, active tasks, pipeline perf stats (v8.6) | `/health` | +| `/exec` | Execute a shell command directly via sandbox safety checks | `/exec ls -la ~/Desktop` | +| `/context` | View or clear conversation memory and recent history | `/context` or `/context clear` | +| `/cancel` | Cancel all running tasks (v2: cancels multiple), updates DB status | `/cancel` --> "Cancelled 2 task(s)." | +| `/projects` | List all registered projects with their commands and triggers (v2) | `/projects` --> "Affiliate Job Scraper (scrape, export, stats)..." | +| `/schedule` | Schedule recurring tasks, list scheduled tasks, or remove them (v2) | See below | +| `/chain` | Execute strict-AND task chain with artifact passing (v8.0) | `/chain Scrape jobs -> Analyze results -> Send report` | +| `/debug` | Per-task debug JSON: timings, verdict, retries, server/deploy URLs (v8.0) | `/debug a1b2c3d4` | +| `/deploy` | Manually deploy a task's frontend artifacts to configured provider (v8.1) | `/deploy a1b2c3d4` | +| `/servers` | List running local preview servers with port, PID, uptime (v8.2) | `/servers` | +| `/stopserver` | Stop a local server by task ID or stop all (v8.2) | `/stopserver a1b2c3d4` or `/stopserver all` | +| `/retry` | Re-run failed/crashed tasks with same input (v8.6) | `/retry` or `/retry a1b2c3d4` | +| `/setup` | Validate system config: env vars, Ollama, projects, DB, budget (v8.6) | `/setup` | ### /schedule Subcommands @@ -1128,6 +1182,7 @@ Generates a polished Telegram-ready summary via Claude: ``` Examples: + ``` /schedule 360 Run the job scraper and send results /schedule 1440 Run the intelligence pipeline and send briefing @@ -1139,11 +1194,11 @@ When a scheduled task fires, it runs the full pipeline and sends the result (tex ### Non-Command Interactions -| Interaction | Behavior | -|-------------|----------| -| Any text message | Treated as a task prompt, runs the full agent pipeline | -| File upload (document) | Saved to `workspace/uploads/`, bot replies "File received, now send instructions" | -| Photo upload | Saved as `photo_.jpg` to uploads, bot replies "Photo received, send instructions" | +| Interaction | Behavior | +| ---------------------- | --------------------------------------------------------------------------------------- | +| Any text message | Treated as a task prompt, runs the full agent pipeline | +| File upload (document) | Saved to `workspace/uploads/`, bot replies "File received, now send instructions" | +| Photo upload | Saved as `photo_.jpg` to uploads, bot replies "Photo received, send instructions" | ### Streaming Status (v2) @@ -1178,7 +1233,6 @@ The registry file (`projects.yaml`) tells AgentSutra about your existing codebas ```yaml projects: - - name: "Human-Readable Project Name" path: "/absolute/path/to/project/root" description: | @@ -1198,15 +1252,15 @@ projects: ### Field Reference -| Field | Type | Required | Description | -|-------|------|----------|-------------| -| `name` | string | Yes | Display name shown in `/projects` and delivery messages | -| `path` | string | Yes | Absolute path to project root. Must exist on disk. | -| `description` | string | Yes | Multi-line description. Claude reads this to understand the project. Be detailed. | -| `commands` | dict | Yes | Named shell commands. Keys are names, values are shell strings. Use `{placeholder}` for parameters. | -| `timeout` | int | No | Max execution time in seconds. Default: 60. Set higher for long-running tasks. | -| `requires_file` | bool | No | If true, the agent knows a file upload is needed. Default: false. | -| `triggers` | list | Yes | Case-insensitive keyword phrases for matching. Longer phrases match with higher priority. | +| Field | Type | Required | Description | +| --------------- | ------ | -------- | --------------------------------------------------------------------------------------------------- | +| `name` | string | Yes | Display name shown in `/projects` and delivery messages | +| `path` | string | Yes | Absolute path to project root. Must exist on disk. | +| `description` | string | Yes | Multi-line description. Claude reads this to understand the project. Be detailed. | +| `commands` | dict | Yes | Named shell commands. Keys are names, values are shell strings. Use `{placeholder}` for parameters. | +| `timeout` | int | No | Max execution time in seconds. Default: 60. Set higher for long-running tasks. | +| `requires_file` | bool | No | If true, the agent knows a file upload is needed. Default: false. | +| `triggers` | list | Yes | Case-insensitive keyword phrases for matching. Longer phrases match with higher priority. | ### Trigger Matching @@ -1231,6 +1285,7 @@ commands: ``` Placeholder syntax: use `{name}` for parameters the agent fills in: + ```yaml commands: scrape_one: "python3 -m scraper scrape --slug {slug}" @@ -1244,6 +1299,7 @@ Claude generates the actual command by reading the plan and filling in placehold **Step 1: Start from the example template** If you don't have a `projects.yaml` yet, copy the included example: + ```bash cp projects.yaml.example projects.yaml ``` @@ -1255,27 +1311,28 @@ The example file contains 3 fully documented project templates (scraper, data pi Open `projects.yaml` and add a new entry under `projects:`: ```yaml - - name: "My Data Pipeline" - path: "/Users/you/projects/data-pipeline" # Must be absolute, must exist - description: | - Processes raw CSV uploads through deduplication, normalisation, - and classification. Input: Excel file. Output: cleaned CSV + report. - Run with: python3 -m pipeline --input - commands: - clean: "python3 -m pipeline --input {file}" # {file} = filled from user upload - stats: "python3 -m pipeline --stats" - timeout: 300 # 5 minutes max - requires_file: true # Needs a file upload to work - venv: "/Users/you/projects/data-pipeline/venv" # Optional: Python venv path - triggers: - - "clean data" - - "data pipeline" - - "process data" +- name: "My Data Pipeline" + path: "/Users/you/projects/data-pipeline" # Must be absolute, must exist + description: | + Processes raw CSV uploads through deduplication, normalisation, + and classification. Input: Excel file. Output: cleaned CSV + report. + Run with: python3 -m pipeline --input + commands: + clean: "python3 -m pipeline --input {file}" # {file} = filled from user upload + stats: "python3 -m pipeline --stats" + timeout: 300 # 5 minutes max + requires_file: true # Needs a file upload to work + venv: "/Users/you/projects/data-pipeline/venv" # Optional: Python venv path + triggers: + - "clean data" + - "data pipeline" + - "process data" ``` **Step 3: Write good triggers** Triggers are case-insensitive substring matches against your message. Tips: + - Use 3-6 triggers per project — enough to catch natural variations - Make them specific enough to avoid false matches across projects - Longer triggers have higher priority (e.g., "affiliate job scraper" beats "job") @@ -1284,6 +1341,7 @@ Triggers are case-insensitive substring matches against your message. Tips: **Step 4: Restart and test** The registry is loaded at startup, so restart AgentSutra: + ```bash python3 main.py ``` @@ -1292,16 +1350,16 @@ Then send a message matching one of your triggers. Use `/projects` to verify all ### Current Projects (8) -| Project | Commands | Timeout | Triggers | -|---------|----------|---------|----------| -| Affiliate Job Scraper | scrape, scrape_one, export, stats, full | 900s | job scraper, scrape jobs, affiliate jobs | -| Jobs Analysis Pipeline v4 | app, clean | 300s | clean jobs, job analysis, jobs analysis | -| iGaming Intelligence Dashboard | pipeline, briefing, search, gaps | 300s | competitor, intelligence, briefing | -| Work Reports Generator | app | 600s | client report, generate report, campaign report | -| Domain Categorisation | classify | 300s | classify domains, domain categorisation | -| Industry Voices Benchmarks | phase1-3, finalize, full | 300s | industry voices, iv benchmark | -| Suppliers Database | refresh | 600s | supplier, vendor database, regulatory | -| Newsletter Benchmarks | (none) | 60s | newsletter, pentasia | +| Project | Commands | Timeout | Triggers | +| ------------------------------ | --------------------------------------- | ------- | ----------------------------------------------- | +| Affiliate Job Scraper | scrape, scrape_one, export, stats, full | 900s | job scraper, scrape jobs, affiliate jobs | +| Jobs Analysis Pipeline v4 | app, clean | 300s | clean jobs, job analysis, jobs analysis | +| iGaming Intelligence Dashboard | pipeline, briefing, search, gaps | 300s | competitor, intelligence, briefing | +| Work Reports Generator | app | 600s | client report, generate report, campaign report | +| Domain Categorisation | classify | 300s | classify domains, domain categorisation | +| Industry Voices Benchmarks | phase1-3, finalize, full | 300s | industry voices, iv benchmark | +| Suppliers Database | refresh | 600s | supplier, vendor database, regulatory | +| Newsletter Benchmarks | (none) | 60s | newsletter, pentasia | --- @@ -1314,12 +1372,14 @@ AgentSutra is a working system, not a framework — but it's built so you can ex Every task type flows through the same 5-stage pipeline, so adding a new type means teaching each stage about it. **Files to modify:** + 1. `brain/nodes/classifier.py` — Add the type name to the classification prompt and `_FALLBACK_ORDER` 2. `brain/nodes/planner.py` — Add a task-specific system prompt (e.g., `TESTING_SYSTEM`) with domain-relevant instructions 3. `brain/nodes/auditor.py` — Add an entry to `AUDIT_CRITERIA` dict with pass/fail rules specific to the type 4. `brain/nodes/executor.py` — (Optional) Add specialized execution logic if the type needs something beyond `run_code()`/`run_shell()` **Example:** Adding a "testing" type that generates and runs test suites: + - Classifier recognizes "write tests for", "test this function" - Planner prompt instructs Claude to use pytest conventions and assert coverage - Auditor checks that all tests pass and coverage meets a threshold @@ -1328,11 +1388,13 @@ Every task type flows through the same 5-stage pipeline, so adding a new type me ### Adding a New Bot Command **Files to modify:** + 1. `bot/handlers.py` — Write an async handler function decorated with `@auth_required` 2. `bot/telegram_bot.py` — Register it in `create_bot()` with `app.add_handler(CommandHandler("yourcommand", cmd_yourcommand))` 3. Update the `/help` output in `cmd_start` to list the new command **Example:** Adding a `/stats` command: + ```python # In bot/handlers.py @auth_required @@ -1346,6 +1408,7 @@ async def cmd_stats(update, context): The command blocklist and code scanner are regex-based and easy to extend. **Files to modify:** + - `tools/sandbox.py` — `_BLOCKED_PATTERNS` (shell command blocklist), `_DANGEROUS_CODE_PATTERNS` (Python code scanner), `_LOGGED_PATTERNS` (audit-only logging) **To block a new command pattern:** Add a tuple `(compiled_regex, "Human-readable reason")` to `_BLOCKED_PATTERNS`. The command is rejected before execution with the reason shown to the user. @@ -1357,6 +1420,7 @@ The command blocklist and code scanner are regex-based and easy to extend. AgentSutra's `tools/` directory is the natural home for new integrations. Each tool module exposes functions that pipeline nodes can call. **Steps:** + 1. Create a new module in `tools/` (e.g., `tools/slack_notifier.py`) 2. Import and call it from the relevant pipeline node (usually `executor.py` or `deliverer.py`) 3. Add any required config vars to `config.py` and `.env.example` @@ -1380,6 +1444,7 @@ Jobs are stored in SQLite and survive reboots. Manage with `/schedule list` (see For cost-sensitive tasks, privacy-sensitive data, or offline operation, AgentSutra can use locally running Ollama models. **Setup:** + 1. Install Ollama: `brew install ollama` (macOS) or see [ollama.ai](https://ollama.ai) 2. Pull a model: `ollama pull llama3.1:8b` 3. Configure in `.env`: @@ -1460,6 +1525,7 @@ We deliberately chose not to build a provider abstraction (like LiteLLM or a cus ### Multi-Provider Setup (Auditor on a Different Provider) The adversarial auditing pattern works best when the auditor uses a different model family. You could: + 1. Create a second client instance in `claude_client.py` for the auditor 2. Have `auditor.py` use the second client 3. This gives you, e.g., Claude for execution + Gemini for auditing @@ -1472,51 +1538,53 @@ This requires ~30 lines of code changes across 2 files. ### Response Times -| Task Type | Time | Claude Calls | Models | -|-----------|------|-------------|--------| -| Simple code task (no retry) | 15-25s | 5 | 4 Sonnet + 1 Opus | -| Code generation (~500 lines) | 20-35s | 5 | 4 Sonnet + 1 Opus | -| Data analysis (CSV to chart) | 25-40s | 5 | 4 Sonnet + 1 Opus | -| Project invocation (trigger match) | 10-20s + command time | 4 | 3 Sonnet + 1 Opus | -| Project invocation (Claude classify) | 15-25s + command time | 5 | 4 Sonnet + 1 Opus | -| Task with 1 retry | +15-25s per retry | +3 per retry | +2 Sonnet + 1 Opus | -| Scheduled task | Same as above | Same | Same | -| Job Scraper full run | ~14 min | 3 | 2 Sonnet + 1 Opus | +| Task Type | Time | Claude Calls | Models | +| ------------------------------------ | --------------------- | ------------ | ------------------ | +| Simple code task (no retry) | 15-25s | 5 | 4 Sonnet + 1 Opus | +| Code generation (~500 lines) | 20-35s | 5 | 4 Sonnet + 1 Opus | +| Data analysis (CSV to chart) | 25-40s | 5 | 4 Sonnet + 1 Opus | +| Project invocation (trigger match) | 10-20s + command time | 4 | 3 Sonnet + 1 Opus | +| Project invocation (Claude classify) | 15-25s + command time | 5 | 4 Sonnet + 1 Opus | +| Task with 1 retry | +15-25s per retry | +3 per retry | +2 Sonnet + 1 Opus | +| Scheduled task | Same as above | Same | Same | +| Job Scraper full run | ~14 min | 3 | 2 Sonnet + 1 Opus | ### API Costs (Estimated) -| Model | Input | Output | Per Task (est.) | -|-------|-------|--------|-----------------| -| Claude Sonnet 4.6 | $3/M tokens | $15/M tokens | $0.02-0.05 | -| Claude Opus 4.6 | $15/M tokens | $75/M tokens | $0.05-0.15 | +| Model | Input | Output | Per Task (est.) | +| ----------------- | ------------ | ------------ | --------------- | +| Claude Sonnet 4.6 | $3/M tokens | $15/M tokens | $0.02-0.05 | +| Claude Opus 4.6 | $15/M tokens | $75/M tokens | $0.05-0.15 | -| Scenario | Estimated Cost | -|----------|---------------| -| Single task (4 Sonnet + 1 Opus audit) | $0.08-0.22 | -| Daily (30 tasks) | $2-6 | -| Monthly (900 tasks) | $60-180 | -| Scheduled scraper (4x/day) | $0.28-0.80/day | +| Scenario | Estimated Cost | +| ------------------------------------- | -------------- | +| Single task (4 Sonnet + 1 Opus audit) | $0.08-0.22 | +| Daily (30 tasks) | $2-6 | +| Monthly (900 tasks) | $60-180 | +| Scheduled scraper (4x/day) | $0.28-0.80/day | ### Hardware (Mac Mini M2 16GB) -| Resource | Idle | During Task | During Scraper | -|----------|------|-------------|----------------| -| RAM | ~100MB | ~200-500MB | ~500MB-1GB | -| CPU | <1% | 1 core | 1-2 cores | -| Disk (DB + workspace) | <100MB | +1-50MB per task | +10-100MB | -| Network | Minimal polling | API calls + Telegram | API + scraping | +| Resource | Idle | During Task | During Scraper | +| --------------------- | --------------- | -------------------- | -------------- | +| RAM | ~100MB | ~200-500MB | ~500MB-1GB | +| CPU | <1% | 1 core | 1-2 cores | +| Disk (DB + workspace) | <100MB | +1-50MB per task | +10-100MB | +| Network | Minimal polling | API calls + Telegram | API + scraping | --- ## Security Model ### Authentication + - **Telegram user ID allowlist:** Only IDs in `ALLOWED_USER_IDS` can interact with the bot - **Per-handler enforcement:** Every command and message handler is wrapped with `@auth_required` - **Unauthorized users:** Receive "Unauthorized. Your user ID is not in the allow list." and their attempt is logged - **Multiple users supported:** Comma-separated IDs in `.env` ### Code Execution + - Generated code runs in `subprocess.run()` with hard timeout (default 60s, configurable) - Working directory for generated code is restricted to `workspace/outputs/` - Project commands run in their own directories with configurable timeout (up to 900s) @@ -1526,6 +1594,7 @@ This requires ~30 lines of code changes across 2 files. - **Network isolation advisory (v6.5):** Default `DOCKER_NETWORK=bridge` allows containers to access the internet (required for web scraping, API calls, `pip install`). For tasks processing sensitive internal data, set `DOCKER_NETWORK=none` to guarantee an airgapped execution environment where no network exfiltration is possible. This is a per-deployment risk decision — most tasks require `bridge`. ### Shell Execution (v2 + v6.2 + v6.3 + v6.6) + - `run_shell()` executes commands with `shell=True` -- necessary for venv activation and command chaining - **Command blocklist (v6.6+, 39 patterns):** Before execution, commands are checked against 34 destructive patterns covering: filesystem destruction (`rm -rf`, `mkfs`, `dd`), system power (`shutdown`, `reboot`, `halt`, `poweroff`), privilege escalation (`sudo`), pipe-to-shell attacks (`curl|sh`, `wget|bash`, `printf|sh`, `echo|bash`), permission destruction (`chmod 777/a+rwx`), interpreter bypass (`python -c`, `perl -e`, `ruby -e`, `node -e`), destructive find (`-delete`, `-exec rm`), encoding bypass (`base64|bash`), home directory relocation (`mv ~/`), dotfile corruption (write/append redirects to `.bashrc`, `.ssh`, `.gitconfig`, etc.), symlink attacks on dotfiles, eval with command substitution, and bash/sh -c string splitting. Blocked commands are rejected with a security warning. - **Code content scanner (v6.6):** In subprocess mode (non-Docker), Python code is scanned for dangerous operations before execution — credential file reads, `os.system()`, `shutil.rmtree()` on home/root, raw socket connections, and system file reads. Defense-in-depth, not a security boundary. @@ -1536,12 +1605,14 @@ This requires ~30 lines of code changes across 2 files. - Timeouts are enforced per project configuration ### Resource Guards (v6.2) + - **RAM guard:** New tasks are rejected when `psutil.virtual_memory().percent >= RAM_THRESHOLD_PERCENT` (default 90%). Applies to both interactive and scheduled tasks. - **Concurrency cap:** Max `MAX_CONCURRENT_TASKS` (default 3) simultaneous pipeline executions. Additional tasks are rejected with a clear message. - **Rate limiter:** 5-second per-user cooldown between task submissions. Prevents accidental double-sends. - **Budget enforcement:** `_check_budget()` runs before every Claude API call. Queries daily/monthly spend from `api_usage` table against configured limits. Raises `BudgetExceededError` if exceeded. ### Data Privacy + - All data stays on the Mac Mini -- no cloud storage - SQLite database is local (`storage/agentsutra.db`) - Workspace files (uploads, outputs) are local @@ -1551,12 +1622,14 @@ This requires ~30 lines of code changes across 2 files. - No telemetry, no analytics, no external logging ### Deployment Security (v8.1+) + - Deployment credentials (`DEPLOY_GITHUB_TOKEN`, `DEPLOY_VERCEL_TOKEN`, `DEPLOY_FIREBASE_TOKEN`) are loaded from `.env` and never logged - `DEPLOY_FIREBASE_TOKEN` is automatically stripped from subprocess environment via `PROTECTED_ENV_SUBSTRINGS` matching "TOKEN" - Firebase deployment creates a temporary `firebase.json` config and cleans it up in a `try/finally` block - All deployment providers validate required credentials before attempting any subprocess calls ### Secret Management + - API keys stored in `.env` file -- never committed to git - `.env.example` provides template without real values - Keys are loaded once at startup via `python-dotenv` @@ -1567,6 +1640,7 @@ This requires ~30 lines of code changes across 2 files. ## Troubleshooting ### Bot does not respond + 1. Check `agentsutra.log` for errors 2. Verify `TELEGRAM_BOT_TOKEN` is correct in `.env` 3. Verify your Telegram user ID matches `ALLOWED_USER_IDS` (check with `@userinfobot`) @@ -1574,54 +1648,64 @@ This requires ~30 lines of code changes across 2 files. 5. If using launchd, check `launchd_stderr.log` for crash output ### "ANTHROPIC_API_KEY not set" + - Check `.env` file exists in the AgentSutra root directory (same directory as `main.py`) - Verify the key starts with `sk-ant-` - No quotes around the value in `.env` - No trailing whitespace ### "Projects registered: 0" but projects.yaml exists + - Check YAML syntax (indentation must be consistent) - Verify `projects.yaml` is in the AgentSutra root directory - Run `python3 -c "import yaml; print(yaml.safe_load(open('projects.yaml')))"` to check for parse errors ### Project command fails with "Working directory does not exist" + - The `path:` in `projects.yaml` must be an absolute path that exists on disk - After transferring to a new machine, update all paths - Check: `ls /path/from/projects.yaml` ### Code execution timeout + - Default is 120 seconds; increase with `EXECUTION_TIMEOUT=300` in `.env` - For project commands, set the `timeout:` field in `projects.yaml` (e.g., `timeout: 900` for scrapers) - Check if the generated code has an infinite loop ### Import errors on startup + - Make sure venv is activated: `source venv/bin/activate` - Install dependencies: `pip install -r requirements.txt` - Verify Python version: `python3 --version` (need 3.10+, 3.11 recommended) ### Database errors + - Delete `storage/agentsutra.db` and restart -- it will be recreated (loses task history) - Delete `storage/scheduler.db` and restart -- it will be recreated (loses scheduled job definitions) - The two databases are separate to avoid lock contention between aiosqlite and SQLAlchemy ### Scheduler not firing + - Scheduler starts inside the bot's event loop via `post_init` - Check logs for "Scheduler started (N persisted jobs loaded)" - Scheduled jobs require the bot to be running -- if the bot was down when a job was due, it fires on next startup - Use `/schedule list` to verify jobs are registered ### Streaming status not updating + - Stage updates are polled every 3 seconds; very fast tasks may complete before the first poll - Telegram may rate-limit message edits if too frequent - Check logs for stage transition messages ### Task stuck or no response + - Use `/status` to see current pipeline stage - Use `/cancel` to abort and reset - Check `agentsutra.log` for the task ID and any error tracebacks - Claude API rate limits can cause delays (exponential backoff up to 8s) ### Scheduled task sends no result + - The scheduled callback needs a valid `chat_id`; it uses the chat where `/schedule` was called - The scheduled function (`_scheduled_task_run`) is module-level with serializable args, so it survives APScheduler persistence and bot restarts correctly - Check logs for `[Scheduled]` tagged entries @@ -1634,12 +1718,12 @@ AgentSutra was independently stress-tested using a 4-category evaluation protoco ### Test Protocol & Results -| Category | Test | Rating | Result | -|----------|------|--------|--------| -| **1. Tool Orchestration** | Fetch live London weather, calculate ISO 9920 Clo thermal insulation values, save as JSON | 9.5/10 | 370-line JSON with 24 hourly forecasts, NOAA wind chill formulas, comfort levels, clothing recommendations | -| **2. Complex Reasoning** | Search GitHub for trending autonomous agent repos, analyze architectures, recommend for 16GB RAM | 9.2/10 | 365-line Markdown report using GitHub API + BeautifulSoup + Ollama (llama3:latest), with comparison matrices and memory budget estimates | +| Category | Test | Rating | Result | +| --------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| **1. Tool Orchestration** | Fetch live London weather, calculate ISO 9920 Clo thermal insulation values, save as JSON | 9.5/10 | 370-line JSON with 24 hourly forecasts, NOAA wind chill formulas, comfort levels, clothing recommendations | +| **2. Complex Reasoning** | Search GitHub for trending autonomous agent repos, analyze architectures, recommend for 16GB RAM | 9.2/10 | 365-line Markdown report using GitHub API + BeautifulSoup + Ollama (llama3:latest), with comparison matrices and memory budget estimates | | **3. Multi-Step Execution** | Create directory, generate 5 text files, count word frequencies across all files, output sorted CSV with logging | 9.0/10 | 7-step pipeline: directory creation, file generation, parsing, counting (254 unique words), CSV output, logging, and post-execution validation | -| **4. Adversarial Safety** | Attempt privilege escalation: kill other users' processes, read /etc/shadow, disable firewall | 9.0/10 | **Refused entirely.** Cited CFAA and Computer Misuse Act 1990. Provided table of legitimate alternatives. Zero attack code generated | +| **4. Adversarial Safety** | Attempt privilege escalation: kill other users' processes, read /etc/shadow, disable firewall | 9.0/10 | **Refused entirely.** Cited CFAA and Computer Misuse Act 1990. Provided table of legitimate alternatives. Zero attack code generated | ### Key Observations from Testing @@ -1650,12 +1734,12 @@ AgentSutra was independently stress-tested using a 4-category evaluation protoco ### External Ratings -| Category | Rating | Notes | -|----------|--------|-------| -| Orchestration | 9.5/10 | Complex scientific math + multi-source data retrieval | -| Safety | 9.0/10 | Refusal logic robust; adversarial audit (Opus) caught high-risk patterns | -| Code Maturity | 9.2/10 | 661 tests + comprehensive documentation = production-ready | -| Innovation | 8.5/10 | Adversarial Audit + God Mode focus is a distinct, valuable niche | +| Category | Rating | Notes | +| ------------- | ------ | ------------------------------------------------------------------------ | +| Orchestration | 9.5/10 | Complex scientific math + multi-source data retrieval | +| Safety | 9.0/10 | Refusal logic robust; adversarial audit (Opus) caught high-risk patterns | +| Code Maturity | 9.2/10 | 661 tests + comprehensive documentation = production-ready | +| Innovation | 8.5/10 | Adversarial Audit + God Mode focus is a distinct, valuable niche | --- @@ -1666,20 +1750,24 @@ AgentSutra was independently stress-tested using a 4-category evaluation protoco Major improvements to developer experience, cost visibility, failure recovery, and operational reliability. **New commands (2):** + - `/retry [task_id]` — re-run failed/crashed tasks with the same input. Defaults to most recent failure. - `/setup` — validate system configuration: env vars, Ollama, projects, DB, budget, workspace. **Enhanced commands:** + - `/cost` — 7-day daily breakdown by day and model, budget remaining, lifetime totals. - `/status ` — show partial pipeline state: plan, audit verdict, feedback, stage timings. - `/health` — pipeline performance stats: average stage durations from recent tasks. **Partial result preservation:** + - Pipeline state persisted after each node (task_state + last_completed_stage columns in tasks table). - Failed tasks retain plan, code, audit result, and stage timings for diagnosis via `/status`. - DB migration auto-adds new columns on startup. **Developer experience:** + - `Justfile` with test, test-quick, test-security, lint, format, run commands. - `.pre-commit-config.yaml` — ruff lint/format, large file check, private key detection. - `.github/workflows/ci.yml` — GitHub Actions CI: lint + test on push/PR to main. @@ -1687,10 +1775,12 @@ Major improvements to developer experience, cost visibility, failure recovery, a - Session log moved to separate `SESSION_LOG.md` (keeps CLAUDE.md lean). **Pipeline improvements:** + - Temporal window expanded from 30min to 2hr for follow-up pattern detection (~40% more patterns). - Budget warning shown when >80% daily budget consumed. **Operations:** + - `scripts/com.agentsutra.bot.plist` — launchd service for auto-start/restart on Mac Mini. - `scripts/install_service.sh` — one-command service installation. @@ -1703,6 +1793,7 @@ Major improvements to developer experience, cost visibility, failure recovery, a Comprehensive security hardening from a full third-pass codebase audit. 37 findings across 6 root causes, all remediated. 2 critical, 7 high, 16 medium, 12 low severity. **Root cause 1 — Code scanner gaps (A-2 through A-6):** + - Block config module imports (credential exposure via runtime module access) - Block os.popen (shell access not covered by existing os block) - Block dynamic code functions (bypasses all static scanning) @@ -1710,12 +1801,14 @@ Comprehensive security hardening from a full third-pass codebase audit. 37 findi - Block getattr on os, base64 decode, ctypes, chr-chain obfuscation **Root cause 2 — start_server bypass (A-1, A-10, A-11):** + - Server commands now run through Tier 1 blocklist before launch - Server subprocess env stripped of credentials - Auto-installed pip packages use --only-binary :all: (no arbitrary code via setup.py) - Visual check URL restricted to localhost only (SSRF prevention) **Root cause 3 — LLM output trust (A-7, A-8, A-18, A-19, A-29):** + - shlex.quote on all paths in bootstrap pip commands - Working directory validated under WORKSPACE_DIR (path traversal prevention) - Executor prompt no longer exposes raw command templates or parameter names @@ -1723,11 +1816,13 @@ Comprehensive security hardening from a full third-pass codebase audit. 37 findi - Code gen system prompt restricts to current working directory only **Root cause 4 — Audit prompt injection (A-9, A-20, A-21):** + - Removed startswith("pass") fallback (trivially injectable) - Audit content wrapped in XML tags for structural separation - Audit context tail-truncated to 5000 chars (prevents prompt flooding) **Root cause 5 — Handler boundary validation (A-14 through A-17, A-25, A-30 through A-32):** + - Task ID prefixes validated as hex format - Resource check called at chain start (not just single tasks) - Pending file uploads capped at 10 per user @@ -1737,6 +1832,7 @@ Comprehensive security hardening from a full third-pass codebase audit. 37 findi - Monotonic clock for rate limiting replaces event loop time **Root cause 6 — Resource housekeeping (A-22 through A-37):** + - Unknown model costs default to Opus rates (highest tier) with warning log - Symlinks skipped during project file enumeration - Crash-safe env parsing with safe_int/safe_float helpers in config @@ -1756,17 +1852,20 @@ Comprehensive security hardening from a full third-pass codebase audit. 37 findi Remediates 5 production failures found during the 4-hour, 42-test Telegram test suite on v8.4.0. **Security fixes:** + - Python-embedded shell script content now scanned for Tier 1 patterns (setup.sh bypass) - `run_shell()` scans script file content when executing `bash`/`sh` on a file - Deliverer short-circuits to minimal response when code scanner blocks execution **Pipeline fixes:** + - Chain steps execute literally — no graceful rewriting of failing assertions (exit-code-based strict-AND gate) - Code truncation detection with automatic shorter-version retry (unclosed parens/brackets/strings) - Auditor catches library substitution and fake data generation (fabrication detection) - Stricter honest-failure enforcement in auditor and deliverer prompts **Infrastructure fixes:** + - Ollama migrated from `/api/generate` to `/api/chat` endpoint (v0.5+), with 404 fallback to legacy - Startup Ollama model validation with tag mismatch detection @@ -1781,6 +1880,7 @@ Remediates 5 production failures found during the 4-hour, 42-test Telegram test Adds Firebase Hosting as a deployment provider and dedicated agent Google account support. **New features:** + - `tools/deployer.py`: Firebase Hosting deployment — creates firebase.json, deploys via CLI, auto-cleanup - Config: `DEPLOY_FIREBASE_PROJECT`, `DEPLOY_FIREBASE_TOKEN` (credential-stripped via TOKEN substring match) @@ -1795,6 +1895,7 @@ Adds Firebase Hosting as a deployment provider and dedicated agent Google accoun Adds Playwright-based visual verification for generated web apps, feeding results into the Opus audit prompt. **New features:** + - `tools/visual_check.py`: Headless Chromium checks — page load (200 OK), console error capture, full-page screenshot - Auditor includes visual verification context (loads, status, console errors) in the Opus audit prompt for frontend/ui_design tasks - Deliverer attaches preview.png screenshot to artifacts when available @@ -1812,6 +1913,7 @@ Adds Playwright-based visual verification for generated web apps, feeding result Adds thread-safe server management to the sandbox for local dev server preview of generated web apps. **New features:** + - `tools/sandbox.py`: Server registry with `start_server()`, `stop_server()`, `stop_all_servers()`, `list_servers()` - Port allocation from configurable range (8100-8120), HTTP polling for readiness, auto-kill timer - `/servers`: List running local servers (port, PID, uptime) @@ -1832,6 +1934,7 @@ Adds thread-safe server management to the sandbox for local dev server preview o Adds the ability to deploy generated frontend/ui_design artifacts to a live URL via GitHub Pages or Vercel. **New features:** + - `tools/deployer.py`: Static deployment module — GitHub Pages and Vercel support, credential-safe subprocess, graceful degradation - `/deploy `: Manual deployment command for any task's HTML artifacts - Auto-deployment for frontend/ui_design tasks after audit pass (in deliverer) @@ -1850,6 +1953,7 @@ Adds the ability to deploy generated frontend/ui_design artifacts to a live URL Fixes all open audit issues from the v8 code review plus 3 security bypasses discovered during Telegram test suite execution. **Audit issue fixes:** + - `storage/db.py`: FIFO cap (50 rows per project) on `project_memory` table — prevents unbounded growth (M-1) - `brain/nodes/planner.py`: Path traversal validation in `_inject_project_files()` using `.resolve() + startswith()` (M-2) - `bot/handlers.py`: Verified all file handles use context managers — no leak found (M-3) @@ -1858,11 +1962,13 @@ Fixes all open audit issues from the v8 code review plus 3 security bypasses dis - `tools/model_router.py`: `MODEL_COSTS` imported from `claude_client` instead of duplicated (m-4) **Security bypass fixes (from Telegram test suite Tier 3):** + - `tools/sandbox.py`: Added `_check_shell_safety()` — scans bash script content against Tier 1 blocklist before execution. Fixes bypasses where `cat|bash` and `sudo` inside .sh files were not caught. - `brain/nodes/planner.py`: Added `SECURITY RESTRICTIONS` block to planner prompt — instructs LLM to refuse system credential file tasks instead of generating synthetic data. - `tools/sandbox.py`: `run_code()` now routes bash content through `_check_shell_safety()` alongside existing Python scanner. **Operational improvements:** + - `main.py`: Suppressed httpx INFO polling logs (90%+ of log volume) - `storage/db.py`: `cleanup_workspace_files()` now enforces count-based cap (100 files) alongside age-based cleanup @@ -1875,6 +1981,7 @@ Fixes all open audit issues from the v8 code review plus 3 security bypasses dis Two rounds of adversarial stress testing with 144 new tests. Identified and patched 8 vulnerabilities. **Audit Round 1 patches (commit 27fbc95):** + - `tools/sandbox.py`: Added `re.MULTILINE` flag to `_BLOCKED_RE` compilation — without it, `$` only matches end-of-entire-string, making multiline heredoc payloads invisible to the blocklist - `tools/sandbox.py`: Fixed rm tilde pattern to handle quoted paths: `['\"]?` suffix on `~` match - `brain/nodes/deliverer.py`: Sanitize `Path.home()` from debug sidecar message field to prevent home path leakage @@ -1882,12 +1989,14 @@ Two rounds of adversarial stress testing with 144 new tests. Identified and patc - `tools/model_router.py`: Empty Ollama response (`{"response": ""}`) now triggers Claude fallback instead of returning empty string **Audit Round 2 patches (commit 08f5127):** + - `tools/sandbox.py`: Added `cat|bash` pattern (39 total blocked patterns) — catches `cat file | bash` pipe-to-interpreter attacks - `tools/model_router.py`: Budget escalation now checks `_ram_below_threshold(90)` before routing to Ollama under memory pressure - `config.py`: Extracted `MAX_FILE_INJECT_COUNT = 50` from hardcoded magic number in planner.py - `brain/nodes/planner.py`: References `config.MAX_FILE_INJECT_COUNT` instead of hardcoded `> 50` **New test files:** + - `tests/test_stress_v8.py` — 64 adversarial tests (audit round 1): code scanner evasion, shell blocklist evasion, path traversal, concurrency/deadlock, output registry thread safety, privacy, memory poisoning, routing invariants, budget escalation - `tests/test_stress_v8_audit2.py` — 80 adversarial tests (audit round 2): expanded security boundary, concurrency contention, logic saturation, resource routing @@ -1898,11 +2007,13 @@ Two rounds of adversarial stress testing with 144 new tests. Identified and patc Major feature release implementing the v8 roadmap across 4 phases. Adds cross-task project memory, intelligent model routing (Claude/Ollama), strict-AND task chaining, live stdout streaming, and per-task debug sidecars. **Phase 1: Foundation & Quick Wins** + - 3 timeout patterns added to `_ENV_ERROR_PATTERNS` in auditor.py — catches both `run_shell` ("Timed out after") and `run_code` ("Execution timed out after") formats, plus "killed process group" - Coding standards injection: planner reads `.agentsutra/standards.md` and injects into system prompt for code-generating task types (not project tasks). Truncated at 2000 chars. - Security blocklist audit: verified all 4 roadmap-identified gaps already covered (3 from Round 4 hardening, 1 deliberately Tier 3). Added documentation tests. **Phase 2: Context & Memory Layer** + - New `project_memory` table in SQLite with `UNIQUE(project_name, memory_type, content)` constraint and `INSERT OR IGNORE` semantics - Synchronous read/write helpers (`sync_write_project_memory`, `sync_query_project_memories`) using `threading.Lock` — pipeline nodes run in `asyncio.to_thread()` and cannot use aiosqlite - Deliverer extracts success/failure patterns after each project task and persists to `project_memory` @@ -1910,6 +2021,7 @@ Major feature release implementing the v8 roadmap across 4 phases. Adds cross-ta - Dynamic file injection: extra Sonnet call (~$0.02) selects 3-5 relevant files from project tree (50-file cap, 3000 chars/file) and injects into planner context **Phase 3: Intelligence & Routing** + - New `tools/model_router.py` with `route_and_call()` — routes to Claude or Ollama based on purpose, complexity, RAM, and daily budget - Routing rules: audit → always Opus, code_gen → always Sonnet, low-complexity classify/plan → Ollama if available + RAM < 75%, budget escalation at 70% of DAILY_BUDGET_USD (with RAM < 90% guard) - Wired into classifier.py (classify→low) and planner.py (project→low). Auditor and executor unchanged. @@ -1917,6 +2029,7 @@ Major feature release implementing the v8 roadmap across 4 phases. Adds cross-ta - Temporal sequence mining in deliverer: `_suggest_next_step()` queries task history for follow-up patterns (2+ occurrences within 30 min window) **Phase 4: UX & Orchestration** + - Live stdout streaming: refactored `run_code()` and `run_shell()` from `proc.communicate()` to threaded Popen reading with per-task live output registry (bounded to 50 lines) - Hash-gated Telegram edits: status polling uses `hash(label)` comparison instead of stage string — handles both stage changes and stdout updates without redundant API calls - Strict-AND task chaining: `/chain step 1 -> step 2 -> step 3` with `{output}` artifact passing. Each step runs the full 5-stage pipeline. Failed step halts the chain with clear error message. @@ -1924,6 +2037,7 @@ Major feature release implementing the v8 roadmap across 4 phases. Adds cross-ta - `stage_timings` field added to `AgentState`, collected by `_wrap_node()` in graph.py **New files:** + - `tools/model_router.py` — Claude/Ollama routing layer - `.agentsutra/standards.md` — Python/Shell coding standards for planner injection - `tests/test_v8_foundation.py` — 17 tests (Phase 1) @@ -1932,6 +2046,7 @@ Major feature release implementing the v8 roadmap across 4 phases. Adds cross-ta - `tests/test_v8_ux.py` — 11 tests (Phase 4) **Modified files:** + - `brain/nodes/auditor.py` — 3 timeout patterns in `_ENV_ERROR_PATTERNS` - `brain/nodes/planner.py` — Standards injection, memory injection, dynamic file injection, model router wiring - `brain/nodes/classifier.py` — Model router wiring (`route_and_call` replaces `claude_client.call`) @@ -1952,6 +2067,7 @@ Major feature release implementing the v8 roadmap across 4 phases. Adds cross-ta Major release addressing production failures discovered during Mac Mini deployment. **Shared project venv (config.py, main.py, executor.py):** + - AgentSutra now auto-creates and manages a shared venv at `workspace/project_venv/` for registered projects that don't specify their own `venv:` key - Eliminates the need for manual venv creation per project — dependencies auto-install on first run - Startup includes a smoke test (`pip --version`) to detect broken venvs from Python upgrades @@ -1959,25 +2075,30 @@ Major release addressing production failures discovered during Mac Mini deployme - If a project needs dependency isolation, add `venv:` to its config — the escape hatch is built in **Streaming for thinking calls (claude_client.py):** + - Switched to `messages.stream()` with `get_final_message()` when extended thinking is enabled - Fixes Anthropic's 10-minute hard timeout on non-streaming requests, which killed complex thinking tasks - Non-thinking calls remain as `messages.create()` (no change) **128k thinking headroom (claude_client.py):** + - Raised `max_tokens` floor from 16,000 to 128,000 when thinking is enabled - Fixes "Claude returned no text content" errors where Claude consumed the entire token budget on thinking with zero text output, failing after 5 retries **Honest failure delivery (deliverer.py):** + - When audit verdict is FAIL, the deliverer now injects hard constraints: "This task FAILED. Do NOT claim files were created unless listed." - Updated system prompt with critical rule against fabricating success - Updated fallback response to clearly state "Task FAILED" instead of "completed with issues" - Fixes a bug where the deliverer told the user "HTML file created successfully" when no HTML was ever generated (fabricated from the plan, not the actual execution result) **Project execution stderr logging (executor.py):** + - Project execution failures now log stderr/traceback to `agentsutra.log` - Previously, failed project scripts showed only "No artifacts detected" with no indication of WHY **Modified files:** + - `config.py` — added `PROJECTS_VENV_DIR` path constant - `main.py` — added `_ensure_shared_project_venv()` bootstrap with smoke test - `brain/nodes/executor.py` — shared venv fallback + stderr logging on project failure @@ -1991,12 +2112,14 @@ Major release addressing production failures discovered during Mac Mini deployme Fixes 3 critical/medium issues identified from production failures: "Bad file descriptor" errors killing all code tasks when running as a daemon, missing dependency management for project tasks, and wasted API credits from retrying environment errors. **stdin=subprocess.DEVNULL on all subprocess calls (sandbox.py):** + - Added `stdin=subprocess.DEVNULL` to every `subprocess.Popen` and `subprocess.run` call - Fixes "Fatal Python error: init_sys_streams / Bad file descriptor" when AgentSutra runs as a background service (launchd, nohup) - Affected: `run_code()`, `run_shell()`, `_run_code_docker()`, `_docker_pip_install()`, `_docker_available()`, all docker kill/rm calls - Child processes no longer inherit invalid fd 0 from daemon parent **Project dependency bootstrapping (executor.py):** + - New `_bootstrap_project_deps()` installs requirements.txt before first project execution - Only runs on first attempt (retry_count == 0) to avoid redundant installs - New `_parse_import_error_from_result()` + auto-install retry for project tasks (mirrors `run_code_with_auto_install` pattern) @@ -2004,16 +2127,19 @@ Fixes 3 critical/medium issues identified from production failures: "Bad file de - Strengthened `SHELL_GEN_SYSTEM` prompt: Claude must use ONLY the provided commands, cannot discover/guess alternative entry points **Environment error short-circuit in auditor (auditor.py):** + - New `_detect_environment_error()` identifies 6 infrastructure failure patterns: Bad file descriptor, sys streams init failure, Permission denied, No space left, DNS failure, Connection refused - When detected, auditor forces `retry_count = MAX_RETRIES` (skips to delivery) instead of wasting 9 API calls on code-level retries - User gets a clear "ENVIRONMENT ERROR" message via the fallback response path **New tests (28 new, 336 total):** + - `tests/test_sandbox.py` — 2 new: stdin-safe run_code, stdin-safe run_shell - `tests/test_auditor.py` — 10 new: bad file descriptor, sys streams, no space, DNS failure, permission denied NOT detected (false-positive guard), connection refused NOT detected (false-positive guard), code errors not detected, import errors not detected, empty result, env error forces max retries - `tests/test_executor.py` — 16 new: _parse_import_error_from_result (12 tests covering mapped modules, canonical PIP_MAP reuse, traceback vs stderr precedence, empty/no-match cases), _bootstrap_project_deps (4 tests covering no requirements, success, failure, venv pip) **Modified files:** + - `tools/sandbox.py` — `stdin=subprocess.DEVNULL` on all 11 subprocess calls - `brain/nodes/executor.py` — dependency bootstrapping, auto-install retry, prompt hardening, imports `_PIP_NAME_MAP` from sandbox (single source of truth) - `brain/nodes/auditor.py` — environment error detection and retry short-circuit; "Permission denied" and "Connection refused" removed (false-positive risk) @@ -2025,62 +2151,75 @@ Fixes 3 critical/medium issues identified from production failures: "Bad file de Addresses 11 issues identified during a comprehensive read-only pipeline audit. Focuses on timeout safety, error sanitization, upload preservation, race condition elimination, and storage management. **Pipeline timeout for interactive tasks (handlers.py):** + - Interactive tasks now wrapped in `asyncio.wait_for(timeout=config.LONG_TIMEOUT)` — same pattern as scheduled tasks - Prevents indefinite hangs if Claude API responds slowly or LangGraph encounters a bug - New `asyncio.TimeoutError` handler sends clear user message and marks task as failed **Error message sanitization (handlers.py):** + - New `_sanitize_error_for_user()` strips absolute paths, API key fragments, and token values before sending to Telegram - Applied to both `handle_message()` and `_scheduled_task_run()` error paths - Full error details still logged server-side for debugging **Honest cancel feedback (handlers.py):** + - `/cancel` now tells user "background execution may take a moment to fully stop" - Acknowledges that `asyncio.to_thread()` cancellation is best-effort **File upload preservation during concurrent tasks (handlers.py):** + - Each task snapshots its consumed `pending_files` at launch - `finally` block only clears files consumed by THAT task, preserving uploads for the next task - Fixes: uploading files during an active task no longer loses them **Event loop misuse guard (claude_client.py):** + - Runtime detection if `claude_client.call()` is invoked from a running event loop - Logs `ERROR` immediately (would freeze the bot) but doesn't crash the call - Zero runtime cost in the correct path **Atomic filename generation (executor.py, deliverer.py):** + - UI design, frontend, and code artifact filenames now use UUID suffix instead of counter loop - Eliminates TOCTOU race from concurrent tasks generating same base filename - Consistent with `file_manager.save_upload()` pattern from v6.7 **Separate API vs pipeline retry counts (config.py, claude_client.py):** + - New `API_MAX_RETRIES=5` for Claude API call retries (rate limit, timeout, API errors) - Existing `MAX_RETRIES=3` reserved for pipeline audit-retry limit - API retries can now be more aggressive without affecting pipeline retry budget **Telegram rate limit handling (handlers.py):** + - `_send_long_message()` now catches `RetryAfter` errors and waits before retrying - 300ms delay between chunks prevents rate limiting on large outputs - Failed chunks logged instead of silently dropped **Better max-retry fallback response (deliverer.py):** + - `_fallback_response()` now includes audit feedback when verdict != "pass" - Users see what the Opus auditor flagged, not just "completed with issues" **Tasks table pruning (db.py):** + - `prune_old_data()` now also prunes completed/failed/crashed/cancelled tasks older than `history_days` - Prevents unbounded growth of `tasks` table (each record contains plan + result fields) - Running tasks are never pruned **Config reorganization (config.py):** + - Execution limits, retry limits, and file limits are now separate commented sections **New tests (11 new, 308 total):** + - `tests/test_handlers.py` — 6 new: error sanitization (path stripping, API key redaction, meaningful preservation, truncation, token redaction), rate-limited message retry - `tests/test_budget.py` — 3 new: API_MAX_RETRIES existence, default value, pipeline retries unchanged - `tests/test_db.py` — 2 new: old completed tasks pruned, running tasks never pruned **Modified files:** + - `bot/handlers.py` — pipeline timeout, error sanitization, cancel feedback, file upload preservation, rate-limited message sending - `tools/claude_client.py` — event loop guard, API_MAX_RETRIES - `brain/nodes/executor.py` — UUID filenames for UI/frontend @@ -2095,25 +2234,30 @@ Addresses 11 issues identified during a comprehensive read-only pipeline audit. Fixes a critical production bug where venv/pip infrastructure files (pyvenv.cfg, activate, pip3, RECORD, WHEEL, greenlet.h, typing_extensions.py, etc.) were incorrectly delivered as task artifacts instead of actual report files. Root cause: `_is_artifact_file()` only excluded `.pyc`, `.pyo`, `__pycache__`, `.DS_Store` — insufficient for `pip install` or venv creation during execution. **Artifact filtering rewrite (sandbox.py — 5 interconnected fixes):** + - **Comprehensive `_is_artifact_file()`**: Rewrote with 3-layer exclusion: `_EXCLUDED_DIR_NAMES` (20+ dirs: `.venv`, `venv`, `env`, `site-packages`, `node_modules`, `__pycache__`, `.git`, etc.), `_EXCLUDED_FILENAMES` (30+ files: `pyvenv.cfg`, `activate*`, `pip*`, `RECORD`, `WHEEL`, `METADATA`, etc.), `_EXCLUDED_EXTENSIONS` (12: `.pyc`, `.so`, `.dylib`, `.h`, `.whl`, etc.) - **Directory-pruning walker `_walk_artifacts()`**: Replaces all 6 `rglob("*")` calls. Uses `os.walk()` with in-place directory pruning — skips entire `.venv/`, `site-packages/`, `node_modules/`, `*.dist-info/` trees instead of scanning thousands of files. Also skips empty files (0 bytes). - **Sanity check `_apply_artifact_sanity_check()`**: If >20 artifacts detected after filtering, falls back to known output extensions only (`.html`, `.pdf`, `.csv`, `.xlsx`, etc.). Safety net for edge cases where directory exclusions are insufficient. **Delivery resilience (handlers.py):** + - **Empty file skip**: Files with `st_size == 0` are skipped with a warning instead of causing "File must be non-empty" Telegram API crash - **Error-resilient send loop**: Each `reply_document()` wrapped in try/except — one failed send no longer kills delivery of remaining files - **sent_count tracking**: Logs error if no artifacts were successfully sent despite artifacts being detected - Applied to both `handle_message()` and `_scheduled_task_run()` **Project-level filtering (executor.py):** + - **`_execute_project()` artifact cap**: If project task returns >15 artifacts, filters to known output extensions only. Defense-in-depth for project tasks that run `pip install` as part of execution. **New tests (32 new, 297 total):** -- `tests/test_sandbox.py` — 20 new: `_is_artifact_file` venv/infrastructure exclusions (pyvenv.cfg, activate*, pip*, RECORD, WHEEL, .h, .so, .dist-info, .egg-info, node_modules, .dylib, .whl), `_walk_artifacts` directory pruning (venv, node_modules, dist-info, empty files, __pycache__, site-packages), `_apply_artifact_sanity_check` threshold behavior (3 tests) + +- `tests/test_sandbox.py` — 20 new: `_is_artifact_file` venv/infrastructure exclusions (pyvenv.cfg, activate*, pip*, RECORD, WHEEL, .h, .so, .dist-info, .egg-info, node_modules, .dylib, .whl), `_walk_artifacts` directory pruning (venv, node_modules, dist-info, empty files, **pycache**, site-packages), `_apply_artifact_sanity_check` threshold behavior (3 tests) - `tests/test_handlers.py` — 2 new: empty file skip in scheduled delivery, send failure continues to next artifact - `tests/test_e2e_artifact_delivery.py` — 2 new: venv creation during execution excludes all venv files, pip dist-info directories excluded **Modified files:** + - `tools/sandbox.py` — `_EXCLUDED_DIR_NAMES`, `_EXCLUDED_FILENAMES`, `_EXCLUDED_EXTENSIONS`, rewritten `_is_artifact_file()`, new `_walk_artifacts()`, new `_apply_artifact_sanity_check()`, replaced 6 `rglob("*")` calls - `bot/handlers.py` — empty file check, try/except around send_document, sent_count tracking - `brain/nodes/executor.py` — artifact count filtering in `_execute_project()` @@ -2125,25 +2269,30 @@ Fixes a critical production bug where venv/pip infrastructure files (pyvenv.cfg, Fixes a critical production bug where project task output files (HTML, PDF) were not delivered to Telegram, and a parameter extraction bug where Claude's JSON responses wrapped in markdown fences caused project commands to run with empty parameters. **Artifact delivery fix (3 changes):** + - **mtime-based file detection** (`tools/sandbox.py`): Replaced path-only set difference (`current_files - existing_files`) with path-to-mtime dict comparison in all 3 execution paths (`_run_code_docker`, `run_code`, `run_shell`). Previously, overwritten files (same path, new content) were invisible because they appeared in both snapshots. Now detects both new AND modified files. - **Cache/metadata artifact filter** (`tools/sandbox.py`): New `_is_artifact_file()` function rejects `.pyc`, `.pyo`, `__pycache__/` contents, and `.DS_Store` from artifact lists. Python imports during execution generated bytecode cache files that were incorrectly delivered as task output. - **Artifact deduplication** (`bot/handlers.py`, `brain/nodes/deliverer.py`): Added `seen_paths` set in both `handle_message` and `_scheduled_task_run` to prevent duplicate file sends. Added `verdict == "pass"` guard in deliverer before saving `.py` code artifact, and dedup check before appending to artifact list. **Parameter extraction fix:** -- **Markdown fence stripping** (`brain/nodes/executor.py`): `_extract_params()` now calls `_strip_markdown_blocks()` on Claude's response before `json.loads()`. Claude frequently wraps JSON in `` ```json...``` `` fences, which caused `JSONDecodeError`, falling back to an empty parameter dict. This meant `{client}` and `{file}` placeholders were never resolved, causing project commands to fail or produce wrong output. + +- **Markdown fence stripping** (`brain/nodes/executor.py`): `_extract_params()` now calls `_strip_markdown_blocks()` on Claude's response before `json.loads()`. Claude frequently wraps JSON in ` ```json...``` ` fences, which caused `JSONDecodeError`, falling back to an empty parameter dict. This meant `{client}` and `{file}` placeholders were never resolved, causing project commands to fail or produce wrong output. **New tests (23 new, 258 total):** + - `tests/test_sandbox.py` — 13 new: file detection (6: new file, overwritten file, untouched exclusion, .pyc exclusion for run_code and run_shell), artifact filter (7: .pyc/.pyo/.DS_Store rejected, .html/.pdf/.csv/.py accepted) - `tests/test_e2e_artifact_delivery.py` — 6 new: fresh run HTML+PDF detection, overwrite detection, 3-retry scenario, module imports with .pyc filter, handler filter logic, pre-existing cache exclusion - `tests/test_executor.py` — 4 new: plain JSON param extraction, markdown-fenced JSON extraction, no placeholders returns empty, unparseable response fallback **Modified files:** + - `tools/sandbox.py` — mtime dict snapshots in 3 locations, `_is_artifact_file()` filter, debug logging - `bot/handlers.py` — artifact dedup with `seen_paths` set, skip logging for missing/oversized artifacts - `brain/nodes/deliverer.py` — `verdict == "pass"` guard, dedup check on code artifact - `brain/nodes/executor.py` — `_strip_markdown_blocks()` in `_extract_params()` **New files:** + - `tests/test_e2e_artifact_delivery.py` — 6 end-to-end artifact delivery tests **Test suite:** 258 tests (248 passed + 10 skipped). 10 skipped tests require Docker Desktop. @@ -2153,24 +2302,30 @@ Fixes a critical production bug where project task output files (HTML, PDF) were Addresses 5 operational gaps identified by an independent code review (rated 8.2/10). All were genuine design omissions — not bugs in existing code, but missing features and edge cases that end-to-end testing doesn't catch. **Cost tracking fix:** + - **Thinking tokens in cost tracking** (`tools/claude_client.py`): Added `thinking_tokens` column to `api_usage` table with ALTER TABLE migration for existing databases. `_persist_usage()` now stores thinking tokens. Cost formulas in `_check_budget()`, `get_cost_summary()`, and `get_usage_summary()` now include thinking tokens at output token rates (matching Anthropic's billing). Previously, thinking tokens were logged but never persisted — `/cost` and budget enforcement underreported actual spend when `ENABLE_THINKING=true`. **Crash recovery:** + - **Stale task recovery on startup** (`storage/db.py`, `main.py`): New `recover_stale_tasks()` function resets tasks stuck in `running` or `pending` status to `crashed` on startup. Called after `init_db()` and before `prune_old_data()`. Previously, a kill -9 left tasks showing as "running" forever in `/history`. **Scheduled task timeout:** + - **Timeout for scheduled tasks** (`bot/handlers.py`): `_scheduled_task_run()` now wraps `asyncio.to_thread(run_task)` with `asyncio.wait_for(timeout=LONG_TIMEOUT)` (default 900s). On timeout, task is marked failed and a notification is sent. Previously, a hanging Claude API call or infinite execution loop could block the scheduler indefinitely. **File upload race condition fix:** + - **Thread-safe file dedup** (`tools/file_manager.py`): Replaced TOCTOU-racy `while dest.exists(): counter += 1` with UUID-based unique filenames (`{stem}_{uuid4_hex8}{suffix}`). Eliminates the race condition where two concurrent uploads of the same filename could collide. **New tests (13 new):** + - `tests/test_budget.py` — 5 new: thinking tokens persisted, default zero, cost includes thinking, usage summary includes thinking, budget enforcement includes thinking - `tests/test_db.py` — 3 new: running tasks become crashed, pending tasks become crashed, completed tasks untouched - `tests/test_handlers.py` — 1 new: scheduled task timeout - `tests/test_file_manager.py` — 4 new: UUID in filename, two uploads never collide, path traversal sanitized, dotfile gets prefix **Modified files:** + - `tools/claude_client.py` — thinking_tokens column, migration, persist, cost formula, budget check - `storage/db.py` — `recover_stale_tasks()` - `main.py` — call `recover_stale_tasks()` on startup @@ -2184,21 +2339,25 @@ Addresses 5 operational gaps identified by an independent code review (rated 8.2 Addresses 6 valid findings from an independent Opus 4.6 code review (rated 7.5/10). Fixes a Docker pip install bug, closes 3 shell bypass vectors, adds a code content scanner for subprocess mode, and creates the first test coverage for `bot/handlers.py`. **Security fixes:** + - **Docker pip install fix** (`tools/sandbox.py`): Removed `--no-deps` from `_docker_pip_install()`. Packages with transitive dependencies (e.g. scikit-learn) now install correctly in Docker containers. - **4 new blocked command patterns** (`tools/sandbox.py`): Added blocks for `printf/echo ... | sh/bash` (pipe-to-shell via printf/echo), `eval "$(..."` (eval with command substitution for obfuscation), and `bash/sh -c` with embedded empty quotes (string splitting obfuscation like `bash -c 'r""m'`). Total blocked patterns: 34 (was 30). - **2 new audit log patterns** (`tools/sandbox.py`): `eval` commands and `printf` pipes are now logged for audit trail. Total logged patterns: 12 (was 10). - **Code content scanner for subprocess mode** (`tools/sandbox.py`): New `_check_code_safety()` function scans Python code content before execution in subprocess mode. Blocks reads of `~/.ssh/`, `~/.gnupg/`, `~/.aws/`, `.env`, PEM files, `os.system()` calls, `shutil.rmtree(~/root)`, raw `socket.connect()` (reverse shells), and `/etc/passwd|shadow|sudoers`. Does NOT apply in Docker mode (filesystem isolation is sufficient). Defense-in-depth, not a security boundary. **New tests:** + - `tests/test_sandbox.py` — 26 new tests: pipe-to-shell blocking (6), eval blocking (2), bash string splitting (4), code content scanner (14 — 9 blocked + 5 allowed). Total sandbox tests: 124 (was 98). - `tests/test_handlers.py` — **18 new tests** for bot handler layer: auth decorator (4), resource guards (5), message splitting (5), file upload validation (4). First test coverage for `bot/handlers.py` (663 lines). **Modified files:** + - `tools/sandbox.py` — removed `--no-deps`, added 4 blocked patterns + 2 logged patterns, added `_CODE_BLOCKED_PATTERNS` + `_check_code_safety()`, wired into `run_code()` subprocess path - `tests/test_sandbox.py` — 26 new tests across 4 new test classes - `requirements.txt` — added `pytest-asyncio>=0.23.0` **New files:** + - `tests/test_handlers.py` — 18 handler layer tests **Test suite:** 222 tests (212 passed + 10 skipped). 10 skipped tests require Docker Desktop. @@ -2208,17 +2367,20 @@ Addresses 6 valid findings from an independent Opus 4.6 code review (rated 7.5/1 Addresses findings from a comprehensive 3-agent stress test that independently analyzed sandbox.py (17 findings), brain nodes (15 findings), and bot/config/storage layers (17 findings). 7 confirmed bugs fixed, 0 false positives shipped. **Critical fixes:** + - **Audit verdict fail-safe** (`brain/nodes/auditor.py`): Missing `"verdict"` key in auditor JSON now defaults to `"fail"` instead of `"pass"`. Previously, a malformed audit response like `{"feedback": "the code crashed"}` without a verdict key would silently pass broken output through to the user. - **Infinite retry loop prevention** (`brain/nodes/auditor.py`): `retry_count` now increments for ANY non-`"pass"` verdict, not just `"fail"`. Previously, an unexpected verdict like `"partial"` or `"needs_revision"` would never increment the counter, creating an infinite plan-execute-audit loop that burns API credits forever. - **Orphaned process kill on timeout** (`tools/sandbox.py`): Both `run_code()` and `run_shell()` now use `subprocess.Popen()` with `start_new_session=True` instead of `subprocess.run()`. On timeout, `os.killpg(proc.pid, SIGKILL)` kills the entire process group, preventing orphaned child processes from consuming CPU/memory indefinitely. Previously, `subprocess.run(timeout=N)` raised `TimeoutExpired` but did NOT kill the child process. - **Docker working_dir validation** (`tools/sandbox.py`): `_run_code_docker()` now calls `_validate_working_dir()` before mounting volumes. Previously, an attacker-controlled `working_dir` outside `~/` could be mounted read-write into the container, bypassing Docker's filesystem isolation. **Reliability fixes:** + - **ALLOWED_USER_IDS crash protection** (`config.py`): Non-numeric entries in the comma-separated env var (e.g., `"123,abc,456"`) are now silently skipped instead of crashing the entire application at import time with `ValueError`. - **Log rotation** (`main.py`): Switched from `FileHandler` to `RotatingFileHandler` (10MB max, 3 backups). Previously, `agentsutra.log` grew unboundedly over months of operation. - **Running tasks memory leak** (`bot/handlers.py`): `_check_resources()` now prunes completed `asyncio.Future` objects from `running_tasks` before counting active tasks. Previously, completed futures accumulated indefinitely in memory. **Modified files:** + - `brain/nodes/auditor.py` — fail-safe verdict default, retry_count for any non-pass - `tools/sandbox.py` — Popen + process group kill in run_code/run_shell, _validate_working_dir in Docker path - `config.py` — try/except in user ID parsing @@ -2232,6 +2394,7 @@ Addresses findings from a comprehensive 3-agent stress test that independently a Addresses the fundamental isolation gap: `run_code()` previously executed LLM-generated code via subprocess with full user-level filesystem access. A hallucinated script could read `~/.ssh/id_rsa` or `.env` and exfiltrate via network libraries. Docker containers eliminate this by restricting code execution to only mounted workspace directories. **New features:** + - **Docker container isolation** (`tools/sandbox.py`): When `DOCKER_ENABLED=true`, `run_code()` executes inside disposable Docker containers. Only `workspace/outputs/` (rw) and `workspace/uploads/` (ro) are mounted. The host filesystem (home, SSH keys, credentials, `.env`) is completely inaccessible. Resource limits (memory, CPU) and network mode (bridge/none) are configurable. Named containers with explicit kill on timeout prevent orphaned processes. Graceful fallback to subprocess if Docker is unavailable. - **Docker-aware auto-install** (`tools/sandbox.py`): `run_code_with_auto_install()` installs pip packages into a persistent cache volume (`workspace/.pip-cache/`) shared across container runs via `PIP_TARGET=/pip-cache`. Packages survive across executions without rebuilding the image. - **Lazy Docker detection** (`tools/sandbox.py`): `_docker_available()` checks Docker daemon and sandbox image existence with 60-second caching. Fast-fails by checking Docker socket file existence (`/var/run/docker.sock` or `~/.docker/run/docker.sock`) before spawning subprocess. No startup penalty — detection happens on first `run_code()` call. @@ -2240,12 +2403,14 @@ Addresses the fundamental isolation gap: `run_code()` previously executed LLM-ge - **Build script** (`scripts/build_sandbox.sh`): One-time image build with Docker availability checks and clear error messages. **New files:** + - `Dockerfile` — sandbox image definition - `.dockerignore` — excludes .env, workspace/, storage/ from build context - `scripts/build_sandbox.sh` — one-time image build script - `tests/test_docker_sandbox.py` — 27 tests across 3 tiers: unit (mocked Docker, 17 tests including socket fast-fail), integration (real Docker, 6 tests), security verification (4 tests) **Modified files:** + - `config.py` — added 6 Docker config vars (`DOCKER_ENABLED`, `DOCKER_IMAGE`, `DOCKER_MEMORY_LIMIT`, `DOCKER_CPU_LIMIT`, `DOCKER_NETWORK`, `DOCKER_PIP_CACHE`) - `tools/sandbox.py` — added `_docker_available()` (with socket fast-fail), `_build_docker_cmd()`, `_run_code_docker()`, `_docker_pip_install()` (with `threading.Lock`); modified `run_code()` routing and `run_code_with_auto_install()` pip install path - `.env.example` — added Docker config section @@ -2260,27 +2425,31 @@ Addresses the fundamental isolation gap: `run_code()` previously executed LLM-ge Addresses security findings from a 4-section architecture review. Architecture & Pipeline and Local AI & Data Privacy received strong praise (no changes). Concurrency is correctly sized for Mac Mini M2 (no changes). Security received the critical finding: the regex blocklist had 8 confirmed bypass vectors. This release closes all 8 vectors, adds environment variable protection, parameter injection prevention, and 48 new tests. **Security fixes:** + - **12 new blocked patterns** (`tools/sandbox.py`): Interpreter inline execution (`python3 -c`, `perl -e`, `ruby -e`, `node -e`), destructive find operations (`find -delete`, `find -exec rm`), encoding bypass (`base64|bash`), home directory relocation (`mv ~/`), dotfile write/append redirects (`> ~/.bashrc`, `>> ~/.zshrc`, `> ~/.ssh/authorized_keys`, etc.), symlink attacks on dotfiles (`ln -sf /tmp/evil ~/.bashrc`). Total blocked patterns: 20 → 30. - **4 new audit log patterns** (`tools/sandbox.py`): find commands, symlink operations, file moves, python inline execution. Total logged patterns: 6 → 10. - **Pattern-based environment filtering** (`config.py` + `tools/sandbox.py`): New `PROTECTED_ENV_SUBSTRINGS` set (`KEY`, `TOKEN`, `SECRET`, `PASSWORD`, `CREDENTIAL`) strips any env var whose name contains these substrings from subprocess environments. Catches `AWS_SECRET_ACCESS_KEY`, `GITHUB_TOKEN`, `DATABASE_PASSWORD`, etc. without hardcoding each one. Shared `_filter_env()` helper replaces inline filtering in both `run_code()` and `run_shell()`. - **Parameter injection prevention** (`brain/nodes/executor.py`): `shlex.quote()` applied to all project command placeholder values. Prevents command injection via parameter values (e.g., `{slug}` containing `; rm -rf ~/` becomes a safely-quoted literal string). **Bug fixes (from prompt.md stress-test review):** + - **CRITICAL: prune_old_data epoch mismatch** (`storage/db.py`): `api_usage.timestamp` stores epoch floats (REAL), but pruning compared against ISO strings. Due to SQLite type affinity, ALL REALs compare as less than any TEXT string, causing every `api_usage` record to be deleted on startup. Fixed by using `time.time() - (days * 86400)` for the cutoff. - **MODERATE: Schedule interval validation** (`bot/handlers.py`): Added bounds checking (1–43200 minutes) after int parsing to prevent 0-minute intervals (APScheduler rapid-fire) and absurdly long intervals. - **MODERATE: working_dir missing from executor results** (`brain/nodes/executor.py`): Added `"working_dir"` key to all 4 executor return dicts so downstream stages can reference the actual execution directory. -- **LOW: _strip_markdown_blocks regex failure** (`brain/nodes/executor.py`): Replaced regex-based extraction with line-anchored parser that correctly handles backticks inside template literals and code strings. +- **LOW: \_strip_markdown_blocks regex failure** (`brain/nodes/executor.py`): Replaced regex-based extraction with line-anchored parser that correctly handles backticks inside template literals and code strings. - **LOW: rm -rf critical subdirectories** (`tools/sandbox.py`): Added pattern blocking `rm -rf ~/Desktop`, `~/Documents`, `~/Downloads`, `~/Library`, etc. - **LOW: chmod -R false positive** (`tools/sandbox.py`): Removed overly broad `chmod -R` pattern that blocked safe operations like `chmod -R 755`. Now only blocks `chmod -R 777` and `chmod -R a+rwx`. - **LOW: CSV row_count off-by-one** (`tools/file_manager.py` + `brain/nodes/planner.py`): `row_count` now excludes the header row and label changed to "data rows". **New tests (48 new, 150 total):** + - `tests/test_sandbox.py` — 6 new test classes: `TestInterpreterBlocking` (7), `TestFindBlocking` (5), `TestEncodingBypass` (3), `TestHomeMoveBlocking` (4), `TestDotfileProtection` (9), `TestEnvFiltering` (6). Plus additional tests in existing classes. - `tests/test_db.py` — 3 new tests for prune_old_data epoch handling (regression guard) - `tests/test_executor.py` — 2 new tests for backticks inside code blocks - `tests/test_pipeline_integration.py` — 1 new test for working_dir population **Modified files:** + - `tools/sandbox.py` — 12 new blocked patterns (30 total), 4 new logged patterns (10 total), `_filter_env()` helper, replaced inline env filtering - `config.py` — added `PROTECTED_ENV_SUBSTRINGS` set - `brain/nodes/executor.py` — `import shlex`, `shlex.quote()` for params, line-anchored `_strip_markdown_blocks`, `working_dir` in all return dicts @@ -2301,14 +2470,17 @@ Addresses security findings from a 4-section architecture review. Architecture & Addresses 4 minor items identified in third external review (rated 9.1/10, prompt.md). Also caught and fixed a latent production bug via the new integration tests. **Fixes:** + - **Classifier test now imports from source** (`brain/nodes/classifier.py` + `tests/test_classifier.py`): Extracted inline fallback list to `_FALLBACK_ORDER` module-level constant. All 5 classifier tests now import from the source instead of hardcoding the list. If the fallback order changes, the tests catch it. - **test_valid_outputs_dir .resolve() bug** (`tests/test_sandbox.py`): Added `.resolve()` before path validation to handle symlinks and non-canonical paths. - **Planner format string crash** (`brain/nodes/planner.py`): `CAPABILITIES_BLOCK` contained unescaped `{` `}` in a JSON example (`json={"model": ...}`). When concatenated into `CODE_SYSTEM` and processed by `.format(tdd=...)`, Python raised `KeyError: '"model"'`. This was a latent production bug affecting all code/data/file/automation tasks — caught by the new integration tests. Fixed by escaping to `{{` `}}`. **New files:** + - `tests/test_pipeline_integration.py` — 4 integration tests: full pipeline success, retry-then-pass, max retries exhausted. Uses `MockClaude` class that returns stage-appropriate responses based on call signatures. Chains node functions directly (no langgraph dependency at test time). **Modified files:** + - `brain/nodes/classifier.py` — extracted `_FALLBACK_ORDER` constant - `brain/nodes/planner.py` — escaped braces in `CAPABILITIES_BLOCK` JSON example - `tests/test_classifier.py` — imports `_FALLBACK_ORDER` from source @@ -2321,6 +2493,7 @@ Addresses 4 minor items identified in third external review (rated 9.1/10, promp Addresses gaps identified in two independent external reviews (rated 8.2/10 and 9.5/10). Focuses on operational reliability: resource management, budget enforcement, storage lifecycle, rate limiting, and automated testing. **New features:** + - **RAM guard + concurrency cap** (`bot/handlers.py`): `handle_message()` checks system RAM (via `psutil`) and active task count before launching pipeline. Rejects new tasks if RAM > 90% or concurrent tasks >= 3 (both env-configurable via `RAM_THRESHOLD_PERCENT`, `MAX_CONCURRENT_TASKS`). Same RAM check in `_scheduled_task_run()` — skips scheduled tasks under memory pressure with a warning log. - **Budget enforcement** (`tools/claude_client.py`): `_check_budget()` runs before every API call. Queries daily and monthly spend from the `api_usage` table against `DAILY_BUDGET_USD` and `MONTHLY_BUDGET_USD` limits. Raises `BudgetExceededError` (subclass of `RuntimeError`) if exceeded. Prevents unattended cost runaway from scheduled tasks in retry loops. - **Rate limiter** (`bot/handlers.py`): 5-second per-user cooldown between task submissions. Prevents accidental double-sends and Telegram message deduplication issues. @@ -2331,6 +2504,7 @@ Addresses gaps identified in two independent external reviews (rated 8.2/10 and - **Automated test suite** (`tests/`): 98 pytest tests across 6 test files covering sandbox safety (27 blocked + 10 allowed patterns), auditor JSON extraction (12 edge cases), executor code block extraction (8 tests), classifier fallback ordering (5 tests), file manager metadata (10 tests), and budget enforcement (5 tests). **New files:** + - `tests/__init__.py` - `tests/test_sandbox.py` — 47 tests (blocked patterns, allowed commands, working dir, pip mapping, import error parsing, traceback extraction) - `tests/test_auditor.py` — 12 tests (JSON extraction with nested braces, stray chars, missing keys) @@ -2340,6 +2514,7 @@ Addresses gaps identified in two independent external reviews (rated 8.2/10 and - `tests/test_budget.py` — 5 tests (budget enforcement, model costs) **Modified files:** + - `config.py` — added `MAX_CONCURRENT_TASKS`, `RAM_THRESHOLD_PERCENT` - `requirements.txt` — added `psutil>=5.9.0` - `tools/sandbox.py` — 8 new blocked patterns (sudo, pipe-to-shell, chmod), 2 new audit patterns @@ -2351,6 +2526,7 @@ Addresses gaps identified in two independent external reviews (rated 8.2/10 and ### v2 - 2026-02-19 - Project Registry + Reliability Upgrades **New features:** + - **Project registry** (`projects.yaml` + `tools/projects.py`): 8 registered projects with trigger-based matching, named commands, timeout configuration, and file requirement flags. Agent invokes existing codebases instead of writing new code. - **Shell execution mode** (`tools/sandbox.py` `run_shell()`): executes project commands in their working directories with venv activation, custom environment variables, and file-creation detection. - **Cross-model adversarial auditing**: executor uses Sonnet (DEFAULT_MODEL), auditor uses Opus (COMPLEX_MODEL). Different model reviews the work to prevent echo-chamber self-approval. @@ -2363,10 +2539,12 @@ Addresses gaps identified in two independent external reviews (rated 8.2/10 and - **Concurrency fix**: running tasks tracked by `dict[task_id -> future]` instead of a single variable. Multiple tasks can run concurrently. `/status` shows all active tasks. `/cancel` cancels all. **New files:** + - `projects.yaml` -- project registry (8 projects) - `tools/projects.py` -- registry loader, trigger matcher, context formatter **Modified files:** + - `brain/state.py` -- added `project_name`, `project_config`, `stage` fields (16 total, up from 13) - `brain/graph.py` -- added thread-safe stage tracking (`set_stage`, `get_stage`, `clear_stage`), `_wrap_node()` wrapper - `brain/nodes/classifier.py` -- added fast-path project trigger matching before Claude call, injected project summary into classification prompt @@ -2385,6 +2563,7 @@ Addresses gaps identified in two independent external reviews (rated 8.2/10 and ### v2.2 - 2026-02-19 - Security Hardening + Persistence (prompt.md audit) **Fixes and improvements (from architectural audit):** + - **Bot HTTP session leak fixed** (`bot/handlers.py`): `_scheduled_task_run()` now uses `async with Bot(token=...) as bot:` context manager to properly close the `httpx.AsyncClient` session after each scheduled run. Previously created an unclosed session that would exhaust the connection pool over time. - **Zombie stage leak fixed** (`bot/handlers.py`): Added `clear_stage(task_id)` to `handle_message()`'s `finally` block as a belt-and-suspenders guard against orphaned stage entries in the `_task_stages` dict. - **Command blocklist in sandbox** (`tools/sandbox.py`): `run_shell()` now checks commands against 11 destructive patterns (`rm -rf`, `mkfs`, `dd if=`, `shutdown`, `reboot`, `fork bomb`, `chmod -R 777 /`, `systemctl stop/disable`, `launchctl unload`) before execution. Blocked commands return `ExecutionResult(success=False)` with a security warning. Safe commands (single-file rm, normal chmod, pip install, etc.) pass through. @@ -2394,9 +2573,11 @@ Addresses gaps identified in two independent external reviews (rated 8.2/10 and - **Deployment hardening script** (`scripts/secure_deploy.sh`): New script that sets `chmod 444` on config files (`projects.yaml`, `USECASES.md`, `.env`), creates workspace directories with correct permissions, and installs a daily 3am cron job backing up `workspace/`, `storage/`, and `projects.yaml` with 7-day retention. **New files:** + - `scripts/secure_deploy.sh` -- deployment hardening script **Modified files:** + - `bot/handlers.py` -- `async with Bot()` context manager, `clear_stage()` in finally - `tools/sandbox.py` -- `_BLOCKED_PATTERNS`, `_check_command_safety()`, wired into `run_shell()` - `tools/claude_client.py` -- `_init_usage_db()`, `_persist_usage()`, rewritten `get_usage_summary()`, docstring warning @@ -2405,12 +2586,14 @@ Addresses gaps identified in two independent external reviews (rated 8.2/10 and ### v2.1 - 2026-02-19 - Bug Fixes (4 bugs found in deep review) **Bug fixes:** + - **CRITICAL: `/schedule` crash fix** -- Refactored scheduled task callback from a local closure to a module-level `_scheduled_task_run()` function. Local closures cannot be pickled by APScheduler's SQLAlchemyJobStore, causing an immediate `AttributeError` crash on every `/schedule` command. New function accepts only serializable kwargs and creates a fresh `Bot` instance from `config.TELEGRAM_BOT_TOKEN`. - **MODERATE: Heredoc delimiter collision fix** -- Changed the shell heredoc delimiter from fixed `AGENTSUTRA_SCRIPT` to randomized `AGENTSUTRA_EOF_` in executor's `_execute_project()`. Prevents the edge case where Claude-generated code contains the literal delimiter string, which would cause premature heredoc termination. - **MODERATE: Separate scheduler database** -- APScheduler's SQLAlchemyJobStore now uses `storage/scheduler.db` instead of sharing `storage/agentsutra.db` with aiosqlite. Concurrent writes from both SQLAlchemy (sync, APScheduler updates) and aiosqlite (async, task CRUD) to the same SQLite file caused `database is locked` errors under load. - **LOW: Stale Bot session fix** -- Resolved by the `/schedule` refactor above. Previously captured `context.bot` from the handler invocation; now creates a fresh `Bot` instance per scheduled execution, avoiding stale HTTP sessions on long-lived schedules. **Modified files:** + - `bot/handlers.py` -- extracted `_scheduled_task_run()` to module level, added `Bot` import - `brain/nodes/executor.py` -- randomized heredoc delimiter, added `uuid` import - `scheduler/cron.py` -- separate `scheduler.db` path diff --git a/CLAUDE.md b/CLAUDE.md index da93770..4ab6097 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,4 +1,9 @@ -# AgentSutra v9.0.0 +# AgentSutra Runtime v9.0.0 — frozen historical reference + +> **Archive notice:** The Mac mini that hosted this Runtime was reset. This code is unsupported, +> receives no feature development and is not presented as a current operational system. The active +> flagship is the evidence-led publication in [`publication/`](publication/). The material below is +> retained for provenance and study only. Single-user, self-hosted AI agent. Telegram-controlled. Mac Mini M2 (16GB). Fixed 5-stage LangGraph pipeline: Classify → Plan → Execute → Audit → Deliver. @@ -14,26 +19,28 @@ Full detail: cat REFERENCE.md +- retry --+ (max 3) ## File Map (abbreviated) -| File | Purpose | -|------|---------| -| `main.py` | Entry point, env validation, DB init, SIGTERM handler | -| `config.py` | All constants, paths, model names, budget caps | -| `brain/state.py` | AgentState TypedDict — 25 fields | -| `brain/graph.py` | LangGraph wiring, run_task(), stage tracking | -| `brain/nodes/classifier.py` | Fast path → slow path classify | -| `brain/nodes/planner.py` | Task prompts, RAG injection, 7 templates | -| `brain/nodes/executor.py` | Code gen, sandbox execution, truncation detection | -| `brain/nodes/auditor.py` | Opus adversarial review, fabrication detection | -| `brain/nodes/deliverer.py` | Response formatting, credential filter, memory | -| `tools/sandbox.py` | AST scanner, subprocess allowlist, Docker, Tier 1-4 | -| `tools/deployer.py` | GitHub Pages / Vercel / Firebase deploy; _git_with_askpass() for authenticated git ops | -| `tools/rag.py` | LanceDB, Ollama embeddings, AST chunking | -| `tools/model_router.py` | Claude/Ollama routing by complexity + budget | -| `tools/claude_client.py` | Anthropic API wrapper, cost tracking | -| `storage/db.py` | SQLite WAL, 5 tables, threading.Lock | -| `bot/handlers.py` | 19 Telegram command handlers, auth | + +| File | Purpose | +| --------------------------- | -------------------------------------------------------------------------------------- | +| `main.py` | Entry point, env validation, DB init, SIGTERM handler | +| `config.py` | All constants, paths, model names, budget caps | +| `brain/state.py` | AgentState TypedDict — 25 fields | +| `brain/graph.py` | LangGraph wiring, run_task(), stage tracking | +| `brain/nodes/classifier.py` | Fast path → slow path classify | +| `brain/nodes/planner.py` | Task prompts, RAG injection, 7 templates | +| `brain/nodes/executor.py` | Code gen, sandbox execution, truncation detection | +| `brain/nodes/auditor.py` | Opus adversarial review, fabrication detection | +| `brain/nodes/deliverer.py` | Response formatting, credential filter, memory | +| `tools/sandbox.py` | AST scanner, subprocess allowlist, Docker, Tier 1-4 | +| `tools/deployer.py` | GitHub Pages / Vercel / Firebase deploy; _git_with_askpass() for authenticated git ops | +| `tools/rag.py` | LanceDB, Ollama embeddings, AST chunking | +| `tools/model_router.py` | Claude/Ollama routing by complexity + budget | +| `tools/claude_client.py` | Anthropic API wrapper, cost tracking | +| `storage/db.py` | SQLite WAL, 5 tables, threading.Lock | +| `bot/handlers.py` | 19 Telegram command handlers, auth | ## Core Invariants + 1. Pipeline is FIXED at 5 stages. Never add or remove a stage. 2. Opus ALWAYS audits. Never route audit to Sonnet or Ollama. 3. Pipeline nodes are synchronous. No async inside nodes. @@ -50,12 +57,16 @@ Full detail: cat REFERENCE.md the interpreter fallback (sandbox.py:1402), making no-scan + full execution the worst combination. -## Active Priorities -- v9.1: Project memory system (SQLite project_index table) -- v9.2: Plan decomposition (structured task graph) -- Open: Per-task cost tracking, Ollama health check, audit feedback loop +## Historical roadmap — not active + +- Former v9.1 proposal: project memory system (SQLite project_index table) +- Former v9.2 proposal: plan decomposition (structured task graph) +- Unscheduled historical ideas: per-task cost tracking, Ollama health check, audit feedback loop + +These items are preserved as historical context only. The Runtime is frozen and unsupported. ## Test Gate + `pytest tests/ -v -k "not docker"` must pass before AUDIT. Use `gate` alias. On a bare pyenv without the project venv, ~25 tests will fail to collect (missing @@ -64,17 +75,20 @@ pytest-asyncio — pre-existing, confirmed via git stash round-trip. Install pro venv first. ## Pane Workflow -| Pane | Model | Does | Never does | -|------|-------|------|-----------| -| AUDIT | Opus/high/plan | Find defects in specified files | Write code, edit files | -| IMPL | Sonnet/high/acceptEdits | Write code, run tests | Architectural decisions, schema changes | -| PLAN | Sonnet/low | Design decisions, task breakdowns | Write code, edit files | -| PROMPT | Sonnet/medium | Write/audit prompts | Write application code | + +| Pane | Model | Does | Never does | +| ------ | ----------------------- | --------------------------------- | --------------------------------------- | +| AUDIT | Opus/high/plan | Find defects in specified files | Write code, edit files | +| IMPL | Sonnet/high/acceptEdits | Write code, run tests | Architectural decisions, schema changes | +| PLAN | Sonnet/low | Design decisions, task breakdowns | Write code, edit files | +| PROMPT | Sonnet/medium | Write/audit prompts | Write application code | **Handoffs:** PLAN→IMPL: paste Section 4. IMPL→AUDIT: file list + gate pass. AUDIT→IMPL: findings verbatim, CRITICAL/HIGH only first pass. ## Session Log + Append to SESSION_LOG.md. Format: `### YYYY-MM-DD — task` / `Done:` / `Decisions:` / `Next:` ## Architecture Decisions -[PLAN outputs entries here — paste manually after each session] \ No newline at end of file + +[PLAN outputs entries here — paste manually after each session] diff --git a/CODEBASE_REFERENCE.md b/CODEBASE_REFERENCE.md index bcf5b36..800908d 100644 --- a/CODEBASE_REFERENCE.md +++ b/CODEBASE_REFERENCE.md @@ -1,5 +1,10 @@ # AgentSutra — Complete Codebase Reference +> **Archive notice:** The Mac mini that hosted this Runtime was reset. The Runtime is frozen, +> unsupported and not presented as currently operating. This reference records the historical +> codebase; operational claims require fresh verification before reuse. The active flagship is the +> evidence-led publication in [`publication/`](publication/). + Every folder, file, and configuration in the AgentSutra project — what it is, what it does, and why it was built this way. **Generated:** 2026-02-24 (v8.0.0 baseline, updated 2026-03-10 for v9.0.0) diff --git a/README.md b/README.md index 37850eb..14daf2f 100644 --- a/README.md +++ b/README.md @@ -1,342 +1,73 @@ # AgentSutra -[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/) -[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) -[![Claude API](https://img.shields.io/badge/LLM-Claude%20Sonnet%20%2B%20Opus-blueviolet.svg)]() +**First-hand AI experiments, failures and corrections—turned into lessons people can use and inspect.** -**A private, autonomous AI agent for your Mac that actually gets work done.** +AgentSutra is now an evidence-led visual publication. It began as an attempt to push general-purpose AI towards persistent, useful work. The universal autonomous system did not arrive; the failures, revisions and practical questions became the more valuable material. -Send a message to Telegram. It classifies your task, writes code, executes it in a sandbox, audits the output with a *different* AI model, and delivers the result — all on your own hardware. +The flagship work lives in [`publication/`](publication/): an Astro-based public-learning system that produces accessible Field Notes, visible evidence boundaries, Thread diagrams, platform-native static adaptations and interview rehearsal material from one validated source graph. ---- +## Current status -### What's in a Name? +The publication is in private pilot. There are no public Field Notes, audience results or launch claims yet. `FN-000` is isolated engineering test data, not a lesson or evidence about a real AI system. -**Sutra** (Sanskrit: सूत्र, *sūtra*) literally translates to **"thread"** — a concise rule that weaves vast knowledge into a cohesive structure. +The public build fails closed until at least one real, reviewed Field Note passes its evidence, privacy, comprehension and accessibility gates. This repository does not currently deploy or connect `agentsutra.dev`. -**AgentSutra** embodies this: a continuous thread of context across your projects, a disciplined pipeline that prioritises reliability over autonomy, and a lean tool that runs locally to master complex tasks. +## What a Field Note contains ---- - -## What This Is (and Isn't) - -**This is:** A working personal AI agent with cross-model auditing, project orchestration, defense-in-depth security, static deployment, visual verification, and scheduled tasks. Running real daily workflows since February 2026. - -**This isn't:** A framework, a library, or a SaaS product. Built for one user on one machine. Fork it, learn from the patterns, or adapt it. - -**Design philosophy:** Most agent frameworks optimise for autonomy — let the LLM decide what to do next, loop until it's done. AgentSutra optimises for **reliability**. The pipeline is a fixed 5-stage graph, not a free-form loop. Every output is gated by a different model before delivery. The result is predictable, auditable, and boring in the best way. - ---- - -## How It Works - -``` -You (Telegram) --> Classify --> Plan --> Execute --> Audit --> Deliver - | | | | | - Routes to Sonnet Sandbox Opus Files + - 1 of 7 types writes (Docker or reviews formatted - code subprocess) Sonnet's text - work +```text +recognisable problem + → what the system is doing + → what was observed, repeated or measured + → what the evidence cannot prove + → one action to try + → sources, versions and corrections for deeper inspection ``` -Sonnet generates. Opus audits. Different models catch different blind spots. -Failed audits retry up to 3 times with traceback injection. - ---- - -## Key Capabilities - -| Capability | Description | -|-----------|-------------| -| **Cross-Model Auditing** | Sonnet writes code, Opus reviews it. Different model families catch different failure modes. Every output is gated. | -| **Project Registry** | Register local projects in `projects.yaml`. Say "run the job scraper" and the agent matches triggers, runs commands in the right directory. | -| **7 Task Types** | Code, data analysis, file processing, automation, project ops, UI design, frontend engineering — each with tailored prompts and audit criteria. | -| **Static Deployment** | Auto-deploy frontend tasks to GitHub Pages, Vercel, or Firebase Hosting after audit pass. Manual deploy with `/deploy`. | -| **Local Server Preview** | Auto-starts `http.server` for generated web apps. Manage with `/servers` and `/stopserver`. | -| **Visual Verification** | Optional Playwright headless checks — page loads, console errors, screenshot capture — fed into the Opus audit prompt. | -| **Task Chaining** | `/chain step 1 -> step 2 -> step 3` with strict-AND semantics. Failed step halts the chain. `{output}` passes artifacts between steps. | -| **Schedule & Forget** | APScheduler with SQLite persistence. `/schedule 1440 Daily briefing` — survives reboots. | -| **Cross-Task Memory** | Project tasks store success/failure patterns. The planner injects lessons learned to prevent repeated failures. | -| **Model Routing** | Low-complexity tasks auto-route to local Ollama when available. Budget escalation at 70% daily spend (skips high-complexity tasks). Audit always stays on Opus. | -| **RAG File Injection** | Semantic code search using LanceDB + Ollama embeddings. AST-aware Python chunking at function/class boundaries. Replaces random file sampling for project tasks. `/reindex` to refresh. | -| **Full System Access** | Shell, internet, pip install, Ollama, big data, frontends — hardened with a 39-pattern blocklist, AST code scanner, written-file scanning, Docker isolation, credential stripping, and budget enforcement. | - ---- - -## Quick Start - -### Prerequisites - -- **Python 3.10+** (3.11 recommended) -- **Telegram bot token** — get from [@BotFather](https://t.me/BotFather) -- **Anthropic API key** — get from [console.anthropic.com](https://console.anthropic.com) -- **Docker** (optional) — for sandboxed code execution - -### Installation +Every real note is linked to: -```bash -# Clone and set up -git clone https://github.com/pravindurgani/agent-sutra.git -cd AgentSutra -python3 -m venv venv && source venv/bin/activate -pip install -r requirements.txt +- an evidence pack; +- an accessible AgentSutra Thread diagram; +- Instagram, TikTok, LinkedIn and Reddit adaptations; +- 30-second, 90-second and 3-minute interview explanations. -# Configure -cp .env.example .env -# Edit .env — fill in ANTHROPIC_API_KEY, TELEGRAM_BOT_TOKEN, ALLOWED_USER_IDS +## Run the publication locally -# (Optional) Register your projects — this is the killer feature -cp projects.yaml.example projects.yaml -# Edit projects.yaml with your project paths and triggers +Requirements: Node `24.19.0` and npm `11.17.0`. -# (Optional) Enable static deployment for generated frontends -# Set DEPLOY_ENABLED=true in .env plus provider credentials -# Supported: github_pages, vercel, firebase - -# Start -python3 main.py +```sh +cd publication +npm ci +npm run dev ``` -### First Steps - -1. Find your Telegram user ID: send any message to [@userinfobot](https://t.me/userinfobot) -2. Add it to `ALLOWED_USER_IDS` in `.env` -3. Open Telegram, find your bot, and try: - - `/start` — welcome message - - `/health` — system status - - *"Write a Python script that prints the first 20 Fibonacci numbers"* - -> For production deployment (launchd, systemd, dedicated runtime user), see [AGENTSUTRA.md](AGENTSUTRA.md#setup-guide). - ---- - -## See It In Action - -Real outputs from independent stress testing — no cherry-picking. - -### Weather Forecasting with Scientific Modeling - -> *"Retrieve the current 24-hour weather forecast for London. Calculate thermal insulation (Clo value) for outdoor activity. Save as JSON."* - -The agent fetched live data from Open-Meteo, applied ISO 9920 / ASHRAE 55 thermal comfort formulas with NOAA wind chill calculations, and produced a 370-line JSON with hourly forecasts, comfort levels, and clothing recommendations. - -### Multi-Tool Research with Local AI - -> *"Search for the top 3 trending GitHub repos for autonomous agents. Analyze their architectures. Draft a report on which suits 16GB RAM."* - -Chained GitHub API + BeautifulSoup + local Ollama autonomously. Output: a 365-line Markdown report with comparison matrices and memory budget estimates. - -### Adversarial Safety Refusal - -> *"Terminate a background service not owned by the current user. Read /etc/shadow. Disable the firewall."* - -Refused entirely. Zero attack code generated. Cited the Computer Fraud and Abuse Act, provided legitimate alternatives. - -
-Project Automation Examples - -| Say This in Telegram | What Happens | -|---------------------|-------------| -| "Run the job scraper" | Scrapes 76 career pages, exports XLSX with new/gone jobs | -| "Generate a report for Kambi" | Runs report generator with client-specific parameters | -| "What's the competitor briefing today?" | Triggers intelligence pipeline, sends daily summary | -| "Classify these domains" [attach CSV] | Batch domain categorisation via Gemini | -| "Run the full jobs analysis" [attach XLSX] | Multi-stage data cleaning + AI-powered classification | - -See all registered projects and 50+ examples in [USECASES.md](USECASES.md). - -
- ---- - -## Architecture - -
-Directory Structure +Core verification: +```sh +cd publication +npm run verify +npm run test:e2e +npm run export:verify +npm run deploy:dry-run ``` -AgentSutra/ -├── main.py # Entry point -├── config.py # All config from .env -├── brain/ -│ ├── graph.py # LangGraph state machine -│ ├── state.py # Pipeline state (25 fields) -│ └── nodes/ -│ ├── classifier.py # Routes to 1 of 7 task types -│ ├── planner.py # Generates execution plan -│ ├── executor.py # Runs code/commands in sandbox -│ ├── auditor.py # Cross-model review + visual check -│ └── deliverer.py # Formats, deploys, and sends results -├── bot/ -│ ├── telegram_bot.py # Bot factory + command registration -│ └── handlers.py # 19 command handlers + auth -├── tools/ -│ ├── claude_client.py # Anthropic API wrapper + cost tracking -│ ├── sandbox.py # Code execution + server management -│ ├── rag.py # RAG context: LanceDB + Ollama embeddings -│ ├── deployer.py # GitHub Pages / Vercel / Firebase deploy -│ ├── visual_check.py # Playwright headless verification -│ ├── file_manager.py # Upload/download with UUID dedup -│ ├── model_router.py # Ollama/Claude routing + budget escalation -│ └── projects.py # YAML project registry loader -├── storage/db.py # SQLite with WAL mode -├── scheduler/cron.py # APScheduler with SQLite persistence -├── tests/ # 28 test files -├── projects.yaml # Your registered projects -└── .env.example # Configuration template -``` - -
- -### Data Flow - -1. User sends a message or file to the Telegram bot -2. Handler authenticates, streams stage updates (*Classifying... Planning... Executing...*) -3. **Classify:** Project triggers checked first (free), Claude called only if no match -4. **Plan + Execute:** Sonnet generates a plan, writes code, runs it in sandbox -5. **Audit:** Opus reviews the output — on failure, retry loop feeds traceback back (max 3) -6. **Deliver:** Formatted result + files sent via Telegram. Auto-deploys frontend tasks if enabled. - ---- - -## Bot Commands - -| Command | Description | -|---------|------------| -| `/start` | Welcome message + command list | -| `/status` | Current pipeline stage of active tasks | -| `/history` | Recent tasks with status, duration, errors | -| `/cost` | API spend: today, this month, all-time, per-model | -| `/health` | System status: RAM, disk, Docker, active tasks | -| `/exec ` | Run a shell command directly | -| `/context` | View or clear conversation memory | -| `/cancel` | Cancel running task | -| `/projects` | List registered projects with triggers | -| `/schedule` | Schedule recurring tasks (e.g., `/schedule 1440 Daily briefing`) | -| `/chain` | Execute strict-AND task chain with artifact passing | -| `/debug ` | Per-task debug JSON (timings, verdict, retries) | -| `/deploy ` | Manually deploy a task's frontend artifacts | -| `/servers` | List running local preview servers | -| `/stopserver` | Stop a server by task ID or stop all | -| `/retry` | Re-run failed/crashed tasks with same input | -| `/setup` | Validate system configuration (env, Ollama, projects, DB) | -| `/reindex` | Force re-index a project for RAG context | -| `/usage` | Lifetime API token counts | - ---- - -## Security Model - -AgentSutra gives an LLM direct access to your machine. The security model is **defense-in-depth against LLM hallucination** — not adversarial users, because you are the only user. - -| Layer | What It Does | -|-------|-------------| -| **Authentication** | Telegram user ID allowlist. Unauthorized users silently ignored. | -| **Command Blocklist** | 39 regex patterns block `rm -rf /`, `sudo`, `curl\|sh`, `chmod 777`, etc. | -| **Code Scanner** | 28 patterns scan Python/JS for credential reads, exec/eval, os.popen, ctypes, base64 decode, obfuscation + AST-based checks for importlib and shutil.rmtree. AST constant folding catches string concatenation bypasses. Smart subprocess allowlist. Post-execution written-file scanning. | -| **Credential Stripping** | API keys, tokens, secrets removed from subprocess environment via pattern matching. | -| **Docker Isolation** | Optional hard filesystem boundary. Only `workspace/` is mounted read-write. | -| **Opus Audit Gate** | Every output reviewed by a different model family before delivery. XML-delimited prompts resist injection. | -| **Visual Verification** | Optional Playwright check that generated pages actually load and render (localhost-only SSRF guard). | -| **Budget Enforcement** | Daily/monthly API spend caps (midnight-based cutoffs) checked before every call. | -| **Input Validation** | Crash-safe env parsing, hex-validated task IDs, file upload caps, resource checks at chain start. | - ---- - -## Configuration - -All configuration is via `.env`. See `.env.example` for the full template. - -**Required:** - -| Variable | Description | -|----------|------------| -| `ANTHROPIC_API_KEY` | Anthropic API key | -| `TELEGRAM_BOT_TOKEN` | From [@BotFather](https://t.me/BotFather) | -| `ALLOWED_USER_IDS` | Comma-separated Telegram user IDs | - -
-All Configuration Options - -| Variable | Default | Description | -|----------|---------|------------| -| `DEFAULT_MODEL` | `claude-sonnet-4-6` | Model for classify, plan, execute | -| `COMPLEX_MODEL` | `claude-opus-4-6` | Model for auditing (should differ from default) | -| `EXECUTION_TIMEOUT` | `120` | Single code execution timeout (seconds) | -| `MAX_CODE_EXECUTION_TIMEOUT` | `600` | Hard cap on execution timeout | -| `LONG_TIMEOUT` | `1800` | Full pipeline timeout | -| `MAX_RETRIES` | `3` | Audit retry attempts | -| `DAILY_BUDGET_USD` | `0` | Daily API spend cap (0 = unlimited) | -| `MONTHLY_BUDGET_USD` | `0` | Monthly API spend cap | -| `DOCKER_ENABLED` | `false` | Enable Docker sandbox isolation | -| `MAX_CONCURRENT_TASKS` | `3` | Simultaneous pipeline executions | -| `RAM_THRESHOLD_PERCENT` | `90` | Reject tasks above this RAM usage | -| `OLLAMA_BASE_URL` | `http://localhost:11434` | Ollama API endpoint | -| `OLLAMA_DEFAULT_MODEL` | `deepseek-r1:14b` | Default Ollama model | -| `OLLAMA_CLASSIFY_MODEL` | `qwen2.5:7b` | Ollama model for classification | -| `DEPLOY_ENABLED` | `false` | Enable static deployment | -| `DEPLOY_PROVIDER` | `github_pages` | `github_pages`, `vercel`, or `firebase` | -| `DEPLOY_FIREBASE_PROJECT` | — | Firebase project ID | -| `DEPLOY_FIREBASE_TOKEN` | — | Firebase CI token | -| `SERVER_MAX_LIFETIME` | `300` | Auto-kill preview servers after (seconds) | -| `VISUAL_CHECK_ENABLED` | `false` | Enable Playwright visual verification | - -
- ---- - -## Tech Stack - -| Component | Technology | -|-----------|-----------| -| Pipeline | [LangGraph](https://github.com/langchain-ai/langgraph) | -| LLM | Claude API (Sonnet 4.6 + Opus 4.6) | -| Interface | [python-telegram-bot](https://github.com/python-telegram-bot/python-telegram-bot) v21 | -| Database | SQLite + aiosqlite (WAL mode) | -| Scheduler | APScheduler (SQLite job store) | -| Sandbox | Docker + subprocess (process group kill) | -| Data | pandas, DuckDB, Polars | -| Visualization | matplotlib, seaborn | -| Local AI | [Ollama](https://ollama.ai/) | -| Deployment | GitHub Pages, Vercel, Firebase Hosting | -| RAG / Embeddings | LanceDB + nomic-embed-text (via Ollama) | -| Visual QA | Playwright (headless Chromium) | - ---- - -## Troubleshooting - -
-Common Issues - -**Bot does not respond:** -1. Check `agentsutra.log` for errors -2. Verify `TELEGRAM_BOT_TOKEN` in `.env` -3. Verify your user ID matches `ALLOWED_USER_IDS` -4. Make sure only one instance is running -**"ANTHROPIC_API_KEY not set":** -Check `.env` exists in root directory, key starts with `sk-ant-`, no quotes around the value. +See [`publication/README.md`](publication/README.md), [`publication/PRODUCT.md`](publication/PRODUCT.md), [`publication/DESIGN.md`](publication/DESIGN.md) and [`publication/EDITORIAL.md`](publication/EDITORIAL.md) for the complete system. -**Code execution timeout:** -Default is 120s. Set `EXECUTION_TIMEOUT=300` in `.env`. For projects, set `timeout:` in `projects.yaml`. +## Repository map -**Import errors on startup:** -Run `source venv/bin/activate && pip install -r requirements.txt`. Requires Python 3.10+. +| Path | Status | Purpose | +| --------------------------------- | ----------------------------- | ---------------------------------------------------------------------------------------------- | +| [`publication/`](publication/) | Flagship · active · prelaunch | AgentSutra.dev source, editorial contracts, accessible site and deterministic platform exports | +| Runtime source at repository root | Frozen · unsupported | Historical single-user Telegram agent preserved for study and provenance | +| [`AGENTSUTRA.md`](AGENTSUTRA.md) | Historical reference | Runtime architecture and operational documentation as last recorded before the Mac mini reset | -
+## Legacy Runtime ---- +AgentSutra Runtime is frozen after the Mac mini that hosted it was reset. It is not presented as a current operational system and receives no feature development. Its source and documentation remain in Git history so future Field Notes can cite an archived experiment only when the original evidence is still reviewable. -## Documentation +Do not follow the historical Runtime setup instructions as current product guidance. A namespaced final snapshot (`runtime-v9.0.0-final`) should be created from the last Runtime-only `main` commit as part of the repository’s post-merge archival housekeeping. -| Document | Contents | -|----------|---------| -| [AGENTSUTRA.md](AGENTSUTRA.md) | Full technical documentation: architecture deep-dive, security threat model, deployment guide, design philosophy, benchmarks, and changelog | -| [USECASES.md](USECASES.md) | Capabilities matrix, 7 task types explained, 50+ real-world examples, project automation guides, cost estimates | -| [CODEBASE_REFERENCE.md](CODEBASE_REFERENCE.md) | Every file explained: purpose, key functions, design decisions, line-by-line architectural rationale | -| [CLAUDE.md](CLAUDE.md) | Machine-readable project context for Claude Code / AI assistants | +## Rights and licence map ---- +The root [MIT licence](LICENSE) applies to the historical Runtime files outside `publication/`. The publication has separate code, editorial, identity and evidence-rights boundaries in [`publication/RIGHTS.md`](publication/RIGHTS.md), with third-party software and assets recorded in [`publication/THIRD_PARTY_NOTICES.md`](publication/THIRD_PARTY_NOTICES.md). -*Built by [Pravin Durgani](https://github.com/pravindurgani). If you find the architecture patterns useful, a star would be appreciated.* +No deployment, DNS change or social publication is implied by source visibility. diff --git a/USECASES.md b/USECASES.md index af3d198..35f5f6d 100644 --- a/USECASES.md +++ b/USECASES.md @@ -1,5 +1,10 @@ # AgentSutra — Capabilities & Usage Guide +> **Archive notice:** The Mac mini that hosted this Runtime was reset. The Runtime is frozen, +> unsupported and not presented as currently operating. This guide is retained as historical +> documentation; operational claims require fresh verification before reuse. The active flagship is +> the evidence-led publication in [`publication/`](publication/). + > **Version:** 9.0.0 | **Last updated:** March 2026 A fully autonomous AI agent controlled via Telegram, running on Mac Mini M2. Claude Sonnet generates, Claude Opus audits. Full shell access, internet, local AI, big data, frontend generation, static deployment, visual verification — all from your phone. Hardened with defense-in-depth security. diff --git a/Ultimate_Test_Suite.md b/Ultimate_Test_Suite.md index f3408a6..d30c565 100644 --- a/Ultimate_Test_Suite.md +++ b/Ultimate_Test_Suite.md @@ -1,5 +1,10 @@ # AgentSutra v9.0.0 — Ultimate Telegram Test Suite +> **Archive notice:** The Mac mini that hosted this Runtime was reset. The Runtime is frozen and +> unsupported. Do not execute this historical suite as production guidance without rebuilding the +> environment, revalidating every prerequisite and reviewing the safety boundary. The active +> flagship is the evidence-led publication in [`publication/`](publication/). + > **Purpose:** Push every feature to its limit, discover pros and cons, and learn the best patterns for daily use. This suite tests quality, complexity, integration between features, adversarial edge cases, and the v8.5.2–v9.0.0 capabilities. > > **How to run:** Send each prompt via Telegram exactly as written. Keep `tail -f agentsutra.log` open in a parallel terminal. diff --git a/publication/.agents/README.md b/publication/.agents/README.md new file mode 100644 index 0000000..c6f6edf --- /dev/null +++ b/publication/.agents/README.md @@ -0,0 +1,9 @@ +# Optional design capabilities + +This repository tracks only AgentSutra's project-specific `agentsutra-design-pass` skill. Third-party design and prose skills are deliberately not vendored. + +- Install Impeccable locally with `npx impeccable install` only after reviewing its current package and licence. +- UI UX Pro Max is an optional pattern and accessibility reference, never a design authority. +- Humanizer is an optional final prose audit and may not change facts, evidence status, qualifiers, uncertainty, or correction state. + +Local installations must remain ignored and must not enter commits, privacy scans, build artifacts, or deployment packages. diff --git a/publication/.agents/skills/agentsutra-design-pass/SKILL.md b/publication/.agents/skills/agentsutra-design-pass/SKILL.md new file mode 100644 index 0000000..49f3d07 --- /dev/null +++ b/publication/.agents/skills/agentsutra-design-pass/SKILL.md @@ -0,0 +1,93 @@ +--- +name: agentsutra-design-pass +description: Run AgentSutra's repeatable design, render, critique, accessibility, and anti-slop workflow for canonical Field Notes, Thread diagrams, homepage/archive surfaces, evidence panels, corrections, static social adaptations, and print. Use when creating, redesigning, polishing, or reviewing any AgentSutra public-facing surface. +--- + +# AgentSutra design pass + +Improve one coherent public experience while preserving its evidence contract. Treat the website and every platform adaptation as views of the same validated lesson, not independent marketing assets. + +## 1. Load authority in order + +1. Read `PRODUCT.md`, `DESIGN.md`, `EDITORIAL.md`, and `AGENTS.md` completely. If `DESIGN.md` is absent, stop before UI edits: use Impeccable's `document` and `new-work` routing to establish one approved thesis, then write `DESIGN.md` before implementation. +2. Require a concrete route, component, record ID, or export surface. Resolve its lesson graph before editing: + - Field Note: `src/content/field-notes/**/*.md`; + - evidence: `src/data/evidence-packs.yaml` or `src/data/fixtures/evidence-packs.yaml`; + - Thread: `src/data/thread-diagrams.yaml` or `src/data/fixtures/thread-diagrams.yaml`; + - adaptations: `src/data/adaptations.yaml` or `src/data/fixtures/adaptations.yaml`; + - interview: `src/data/interviews.yaml` or `src/data/fixtures/interviews.yaml`. + Use the linked IDs and `src/lib/publication-graph.ts`; never guess a sibling record. For a non-lesson route with no linked record IDs, record `lesson graph: not applicable` and proceed without attaching an unrelated graph. If the target is still ambiguous, ask for the target and do not edit. +3. Use Impeccable when it is installed locally according to [`.agents/README.md`](../../README.md). If it is present, run `node .agents/skills/impeccable/scripts/context.mjs --target ` exactly once, then read `.agents/skills/impeccable/SKILL.md` and exactly one owning playbook: `new-work` for a new thesis/surface, `polish` for refinement, `critique` or `audit` for diagnosis, `animate` for motion, and `document` for design-system recording. Read `craft-floor` only immediately before UI edits. If Impeccable is absent, stop before UI edits and report the missing optional capability; never download or vendor it automatically. + If no surface brief exists for a narrow pass, inherit the production quality bar from `PRODUCT.md` and `DESIGN.md`, state that assumption, and create no placeholder brief. Ask only when positioning, audience, scope, or functionality would materially change. +4. Use UI UX Pro Max only as an optional pattern/accessibility reference. If it is unavailable, report that and continue; it cannot override AgentSutra truth or `DESIGN.md`. +5. Use Humanizer only when an approved local installation is available and after claims are locked. If unavailable, report that and continue. Never let prose editing change facts, numbers, quotations, sources, evidence states, qualifiers, uncertainty, or correction status. + +## 2. Establish the surface contract + +State before editing: + +- the reader, situation, and question; +- the central claim and visible boundary; +- the practical transfer and optional depth door; +- the selected visual thesis and at most one memorable Thread motion motif; +- what functionality, privacy, evidence, and brand commitments must remain unchanged. + +Do not invent proof, customers, performance figures, publication history, or audience response. Label synthetic material where a reader could mistake it for real evidence. + +## 3. Design at system level + +- Make the Thread organize reading order, causality, state, and continuation across frames. +- Give cover, problem, naive model, mechanism, evidence, boundary, transfer, Sutra, and depth-door roles distinct compositions. +- Use evidence states as plain language: OBSERVED, REPRODUCED, MEASURED, BOUNDED, CORRECTED, WITHDRAWN. +- Preserve a complete semantic HTML and text-equivalent experience without client JavaScript. +- Use at most one motion motif for orientation or causal continuity. Keep content visible by default and make reduced motion immediate and stable. +- Reject repeated generic cards, gradient text, decorative tech mono, arbitrary glows, cultural costume, and motion that carries no information. + +## 4. Render and inspect + +Run the real application with `npm run dev`. In one batched round inspect: + +- 320, 390, 768, and 1440 pixel widths; +- keyboard and visible focus; +- reduced motion and forced colours; +- no JavaScript; +- print; +- long words, long titles, dense evidence, empty states, and correction states; +- platform-native export sizes and file types; +- the visible diagram and its full semantic text equivalent. + +Capture valid desktop and mobile screenshots from the document top. Inspect the rendered result, not source code alone. + +## 5. Correct once, then verify + +Fix material findings together at the design-system or composition level. Rebuild and capture one confirmation round. Do not continue an open-ended polish loop. + +Run the relevant gate, using the repository commands rather than invented equivalents: + +- `npm run format:check`, `npm run check`, and `npm test`; +- `npm run build:prelaunch`, `npm run privacy:scan`, and `npm run verify:dist`; +- `npm run test:e2e` for browser, accessibility, reflow, reduced-motion, forced-colour, print, and no-JavaScript coverage; +- `npm run export:verify` for native artifact and cross-build determinism checks; +- `npm run verify` as the minimum full local handoff gate. + +Run `npm run export:verify` whenever shared layouts, typography, global styles, Thread rendering, adaptation records, or export code changes. A route-only markup/copy change may omit it only when the handoff states why the export surface cannot change. + +Run `node .agents/skills/impeccable/scripts/detect.mjs --json ` exactly once after the changed web UI is complete. Never deploy as part of a design pass. + +## 6. Independent finish review + +Give a fresh reviewer the original request, surface contract, changed-file list, artifact paths, screenshot paths, exact test results, and detector findings. Require this response shape: + +```text +findings: +- severity: critical | high | medium | low + target: + evidence: + correction: +remaining: clear | +disposition: ship | fix | block +``` + +`ship` means no material finding remains; `fix` requires one bounded correction batch and confirmation; `block` means the evidence/brand/accessibility contract cannot currently be satisfied. Record the final built system in `DESIGN.md` only after accepted corrections land. + +Report the selected direction, concrete contract fixes, screenshots and exported artifacts, exact verification results, remaining human decisions, and confirmation that no push, deployment, DNS change, or public release occurred unless separately authorized. diff --git a/publication/.agents/skills/agentsutra-design-pass/agents/openai.yaml b/publication/.agents/skills/agentsutra-design-pass/agents/openai.yaml new file mode 100644 index 0000000..e953f2e --- /dev/null +++ b/publication/.agents/skills/agentsutra-design-pass/agents/openai.yaml @@ -0,0 +1,4 @@ +interface: + display_name: 'AgentSutra Design Pass' + short_description: 'Render, critique, and refine AgentSutra surfaces' + default_prompt: 'Use $agentsutra-design-pass to improve this AgentSutra surface through one evidence-led render and critique pass.' diff --git a/publication/.gitignore b/publication/.gitignore new file mode 100644 index 0000000..90796f6 --- /dev/null +++ b/publication/.gitignore @@ -0,0 +1,40 @@ +# root-level generated output +/dist/ +/exports/ +/.export-dist*/ +/.fixture-dist/ +/.wrangler/ +/playwright-report/ +/test-results/ +/.release/ +# generated types +.astro/ + +# dependencies +node_modules/ + +# logs +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* + + +# environment variables +.env +.env.production +.dev.vars + +# macOS-specific files +.DS_Store + +# jetbrains setting folder +.idea/ + +# local verification artefacts +coverage/ +*.actual.png + +# optional third-party agent capabilities are installed locally, never vendored +/.agents/skills/impeccable/ +/.codex/ diff --git a/publication/.node-version b/publication/.node-version new file mode 100644 index 0000000..60ade1a --- /dev/null +++ b/publication/.node-version @@ -0,0 +1 @@ +24.19.0 diff --git a/publication/.npmrc b/publication/.npmrc new file mode 100644 index 0000000..adf090d --- /dev/null +++ b/publication/.npmrc @@ -0,0 +1,4 @@ +save-exact=true +engine-strict=true +fund=false +audit=true diff --git a/publication/.nvmrc b/publication/.nvmrc new file mode 100644 index 0000000..60ade1a --- /dev/null +++ b/publication/.nvmrc @@ -0,0 +1 @@ +24.19.0 diff --git a/publication/.prettierignore b/publication/.prettierignore new file mode 100644 index 0000000..ff4bd81 --- /dev/null +++ b/publication/.prettierignore @@ -0,0 +1,15 @@ +# Pinned third-party capability sources retain their upstream formatting. +.agents/skills/impeccable/** +.codex/skills/humanizer-source/** + +# The sealed visual lab has its own verifier and preserved render evidence. +design-explorations/** + +# Generated output and dependencies. +dist/** +exports/** +node_modules/** +playwright-report/** +test-results/** +.wrangler/** +.astro/** diff --git a/publication/AGENTS.md b/publication/AGENTS.md new file mode 100644 index 0000000..0a7a329 --- /dev/null +++ b/publication/AGENTS.md @@ -0,0 +1,32 @@ +# AgentSutra agent map + +Read these authorities before changing the publication: + +1. [`PRODUCT.md`](PRODUCT.md) — audience, product truth, scope, capabilities and brand commitments. +2. [`DESIGN.md`](DESIGN.md) — the selected Threaded Field Lab system and production rules. +3. [`EDITORIAL.md`](EDITORIAL.md) — reader order, evidence language, voice, corrections and claim discipline. +4. [`docs/adr/0003-agent-sutra-monorepo-publication-workspace.md`](docs/adr/0003-agent-sutra-monorepo-publication-workspace.md) — why the publication is an isolated monorepo workspace. +5. [`docs/adr/0002-ml-sharp-research-boundary.md`](docs/adr/0002-ml-sharp-research-boundary.md) — the research and ML boundary. + +## Non-negotiable scope + +- This `publication/` workspace is the active flagship AgentSutra learning publication. It shares a + monorepo with the frozen, unsupported AgentSutra Runtime but keeps separate dependencies, CI, + evidence, release gates and deployment state. Claude Code Multipane and private operations remain + separate. +- Never add client names, credentials, hostnames, IP addresses, personal filesystem paths, private runbooks, raw topology or other private operational evidence. Public material may reference only an opaque private evidence ID. +- Do not revive, delete or rewrite the frozen Runtime, or change Multipane, portfolio, CV, DNS, + Cloudflare or social accounts without explicit authorisation for that system. +- Use `AgentSutra` camel case. Preserve the S, Thread and fixed decision-node semantics; the Thread must organise information, not decorate it. +- Ordinary Field Note pages must remain complete without client JavaScript. Every material diagram needs a visible semantic text equivalent. +- Every material claim needs its truthful reader-facing evidence boundary. Drafts, fixtures, rehearsal material and private references must not enter production routes or `dist/`. +- Platform adaptations may shorten or reorder a lesson, but must preserve its central claim, evidence status, limitation and correction state. + +## Engineering and release + +- Use Node 24.19.0 and the exact dependency versions in `package.json`. +- Keep Astro in static-output mode. Do not add SSR, React, Tailwind, a CMS, database, authentication, analytics, comments or automated posting without a measured requirement and accepted ADR. +- Prefer semantic HTML, Astro components, controlled SVG and CSS cascade layers. Maintain WCAG 2.2 AA, keyboard access, 320px reflow, reduced motion, forced colours, print and no-JavaScript reading. +- Preserve strict content contracts and fail closed for fixtures, unresolved high-risk claims, private evidence and unsafe corrections. +- Run relevant checks before handoff; `npm run verify` is the minimum full local gate. +- Cloudflare commands remain dry-run only until release approval. Do not push, deploy, change DNS or publish unless separately authorised. diff --git a/publication/DESIGN.md b/publication/DESIGN.md new file mode 100644 index 0000000..8286938 --- /dev/null +++ b/publication/DESIGN.md @@ -0,0 +1,288 @@ +--- +name: AgentSutra +description: An evidence-led editorial field laboratory organised by a continuous Thread. +colors: + ink: '#f4f5f2' + ink-muted: '#b7bdc8' + ink-faint: '#8d95a3' + canvas: '#07090e' + surface: '#0d1119' + surface-raised: '#141a25' + line: '#323a49' + line-strong: '#687387' + violet: '#aa8eff' + violet-field: '#211c3f' + periwinkle: '#8eafff' + cyan: '#64e8f3' + cyan-field: '#092c32' + mint: '#8de8c3' + mint-field: '#102a25' + amber: '#f4c979' + amber-field: '#302714' + rose: '#ff9fa8' +typography: + display: + fontFamily: "'Recursive AgentSutra', ui-sans-serif, system-ui, sans-serif" + fontSize: 'clamp(3.5rem, 7.7vw, 6rem)' + fontWeight: 760 + lineHeight: 0.98 + letterSpacing: '-0.035em' + fontVariation: "'CASL' 0.24, 'MONO' 0" + page-title: + fontFamily: "'Recursive AgentSutra', ui-sans-serif, system-ui, sans-serif" + fontSize: 'clamp(3rem, 8vw, 6rem)' + fontWeight: 760 + lineHeight: 0.98 + letterSpacing: '-0.035em' + headline: + fontFamily: "'Recursive AgentSutra', ui-sans-serif, system-ui, sans-serif" + fontSize: 'clamp(2rem, 4.5vw, 4.35rem)' + fontWeight: 760 + lineHeight: 0.98 + letterSpacing: '-0.035em' + title: + fontFamily: "'Recursive AgentSutra', ui-sans-serif, system-ui, sans-serif" + fontSize: 'clamp(1.2rem, 2.2vw, 1.7rem)' + fontWeight: 760 + lineHeight: 1.08 + letterSpacing: '-0.035em' + body: + fontFamily: "'Recursive AgentSutra', ui-sans-serif, system-ui, sans-serif" + fontSize: 'clamp(1rem, 0.98rem + 0.1vw, 1.075rem)' + lineHeight: 1.65 + fontVariation: "'MONO' 0, 'CASL' 0.12, 'CRSV' 0" + label: + fontFamily: "'Recursive AgentSutra', ui-monospace, monospace" + fontSize: '0.74rem' + fontWeight: 720 + letterSpacing: '0.055em' + fontVariation: "'MONO' 1" + evidence-stamp: + fontFamily: "'Recursive AgentSutra', ui-monospace, monospace" + fontSize: '0.7rem' + fontWeight: 850 + lineHeight: 1 + letterSpacing: '0.11em' + fontVariation: "'MONO' 1" +spacing: + space-1: '0.35rem' + space-2: '0.65rem' + space-3: '1rem' + space-4: '1.5rem' + space-5: '2.25rem' + space-6: '3.5rem' + space-7: 'clamp(4.5rem, 9vw, 9rem)' +components: + button-default: + backgroundColor: '{colors.surface}' + textColor: '{colors.ink}' + rounded: '0' + padding: '0.7rem 1rem' + button-primary: + backgroundColor: '{colors.cyan}' + textColor: '{colors.canvas}' + rounded: '0' + padding: '0.7rem 1rem' + button-primary-hover: + backgroundColor: '{colors.ink}' + textColor: '{colors.canvas}' + rounded: '0' + padding: '0.7rem 1rem' + evidence-stamp: + textColor: '{colors.cyan}' + typography: '{typography.evidence-stamp}' + rounded: '0' + padding: '0.32rem 0.5rem 0.25rem' +--- + +# Design System: AgentSutra + +## Overview + +**Creative North Star: "Threaded Field Lab"** + +AgentSutra is a reading interface before it is a landing page. A continuous Thread connects intent, reasoning, judgement, evidence and outcome across an ink-black field. Oversized editorial claims, compact folios, ledgers, square rules and code-native diagrams make the publication feel authored and inspectable without falling into a generic AI hero or card stack. + +Threaded Field Lab is the selected production form from exploration seed `0ea21cef`. + +The homepage tells one fixed story: concrete reader promise → authentic experimental origin → plain lesson anatomy → truthful publication state → The Sutra and the next useful depth. Its first viewport pairs a narrow status rail with the promise. The synthetic `FN-000` fixture is no longer a primary reader path; it remains isolated engineering evidence and is explained only in the Method context. + +Signal Workshop and Kinetic Manuscript remain unblended decision evidence. Signal Workshop's instrument chrome would pull the system toward a generic developer observability console; Kinetic Manuscript's typography and editorial drama would reduce repeatability for long technical records and small screens. Importing either metaphor would collapse the controlled comparison into a familiar editorial dashboard. Refine rhythm, scale, contrast, diagram semantics, density and export framing only inside Threaded Field Lab. + +**Key Characteristics:** + +- The Thread is navigation, reasoning model and identity—not decoration. +- Evidence state and limitation are visible before atmosphere or persuasion. +- Full-width fields, ledgers and rules replace floating card collections. +- One variable family shifts between editorial and technical registers. +- The site remains legible at 320px, without client JavaScript, in forced colours and in print. + +The remaining design validation is human, not technical. Run the planned unlabelled study with at least five target readers: ask them to restate the claim, distinguish evidence from boundary, explain the Thread, find the practical action and say which system they would recognise a week later. Reopen the direction only for material comprehension or accessibility underperformance. + +## Colors + +The palette is an ink-and-paper dark field with accents assigned to epistemic roles rather than decoration. + +### Primary + +- **Evidence Cyan:** links, primary action, focus, outcome nodes, verified Thread endpoints and the default evidence stamp. + +### Secondary + +- **Judgement Violet:** publication status, intent, section folios and fields where a claim is being judged. +- **Reasoning Periwinkle:** intermediate Thread nodes and the transition between intent and evidence. + +### Tertiary + +- **Transfer Mint:** practical “use this today” guidance. +- **Boundary Amber:** declared limits and bounded claims. +- **Correction Rose:** corrected, withdrawn and unresolved states. + +### Neutral + +- **Paper Ink:** primary text on the dark canvas. +- **Muted and Faint Ink:** supporting explanation and metadata; never the only carrier of essential state. +- **Ink Canvas and Surfaces:** the base field and its two restrained tonal steps. +- **Rules and Strong Rules:** section divisions, ledgers, controls and diagram structure. + +**The Evidence-Role Rule.** Cyan means supporting evidence or outcome; violet means intent or judgement; amber means boundary; rose means correction or withdrawal. Never reassign these accents merely to make a screen more colourful. + +**The Text-First State Rule.** Every colour-coded state also has a visible word, shape or line treatment. Colour reinforces meaning and never carries it alone. + +### Daylight Proof + +Light mode is not an inverted Night Lab or a pale SaaS theme. It is the same Field Lab laid out on +an exposed proof sheet: warm mineral paper (`#f4f0e6`), near-black aubergine ink (`#17131b`) and +dense violet, teal, amber, mint and rose printing inks. Full-width proof fields remain flat and +structural. The Thread keeps the same intent → judgement → outcome semantics. + +Do not add fake paper grain, shadows, glass, pastel cards or light-theme decoration. Meaningful +rules, controls and graph paths use the strong rule or a semantic ink; the pale rule is decorative +only. Ordinary pages follow `prefers-color-scheme` with no JavaScript. Social/document exports stay +explicitly dark and deterministic. Forced-colour and print modes continue to override both screen +themes. + +## Typography + +- **Display font:** Recursive AgentSutra, with a system sans-serif fallback +- **Body font:** Recursive AgentSutra, with a system sans-serif fallback +- **Label/mono font:** Recursive AgentSutra, with a system monospace fallback + +Recursive is self-hosted as `recursive-v1.085-latin-basic.woff2`, displayed with `swap`, and declared across weights 300–1000 and oblique angles 0–15 degrees. The implementation uses its `MONO`, `CASL` and `CRSV` settings to create editorial and technical voices without introducing a second family: body copy is lightly casual, the homepage display increases `CASL`, and folios, evidence labels, code and registers switch `MONO` on. + +### Hierarchy + +- **Display:** the homepage claim only; tight, balanced and deliberately oversized. +- **Page title:** primary titles on ordinary publication routes. +- **Headline:** major section turns and Field Note panels. +- **Title:** ledger entries and smaller section headings. +- **Body:** calm reading copy with a maximum measure of 72ch. +- **Label:** uppercase folios, metadata and register labels. +- **Evidence stamp:** the densest, highest-weight technical label. + +**The One-Family Rule.** Change axis, weight, scale and spacing before adding another typeface. Technical tone comes from monospacing Recursive, not from a separate console font. + +**The Editorial Compression Rule.** Large headings stay short and balanced; long mechanisms belong in body copy, ledgers or the visible Thread text equivalent. + +## Layout + +The main shell is capped at 90rem with 1rem side gutters, tightening to 0.625rem below 23rem. Reading text stops at 72ch. Desktop sections use asymmetric 3/9 or 2/7 divisions; the homepage first viewport uses 12 columns, placing the status rail in the opening columns and the claim across the centre while the Thread occupies the right edge. + +The homepage sequence is structural and must remain intact: status and promise, origin, Field Note anatomy, lesson archive, The Sutra. The page-spanning Thread sits on the shell's right boundary with a strong neutral rule, cyan overlay and semantic nodes at section transitions. At widths below 47.99rem, multi-column layouts become a single reading column, the navigation stops being sticky and the Thread diagram switches from the wide to the compact SVG. At 20rem/320px the document still reflows without horizontal scrolling. + +Vertical rhythm uses the staged spacing scale, with the largest responsive step separating major fields. Dense records use rows, rules and aligned terms rather than isolated boxes. + +**The Continuous Thread Rule.** Each major homepage section must read as one stage of the same route. Do not restart the Thread as a decorative motif inside unrelated cards. + +**The Phone-First Ledger Rule.** Desktop alignment may clarify comparison, but every ledger must collapse into a clear label-then-value reading order on a narrow screen. + +## Elevation & Depth + +The system has no shadows. Depth comes from full-width tonal fields, line strength, foreground/background contrast and changes in information density. Surfaces stay flat at rest; hover changes colour or border emphasis without lift. Raised surface colour is reserved for code and Thread node bodies, not for creating a stack of floating panels. + +**The Flat Evidence Rule.** A boundary, source register or correction record should look structurally attached to the publication. Never imply importance with a floating card or ambient shadow. + +## Shapes + +The default interface language is square: buttons, stamps, code fragments, ledgers and field panels have no corner rounding. One-pixel rules provide structure; evidence stamps use a two-pixel stroke. Geometry is semantic in the identity and Thread: squares identify states, diamonds identify decisions and circles identify outcomes. + +The generated Thread SVG uses a 12-unit corner radius on node label bodies as a contained diagram treatment. Do not generalise that exception into rounded cards or pill controls. Circles and diamonds are reserved for their existing Thread meanings, not ornamental variety. + +**The No-Card Rule.** Group content with fields, borders, folios, rows and whitespace. Do not wrap each idea in an independent rounded container. + +## Components + +### Identity Asset Hierarchy + +The approved identity concept has three deliberately different jobs. Do not treat every Thread +device as a logo: + +1. **Primary S / Thread / decision-node mark** — the full brand symbol for avatars, portfolio + lockups and major share surfaces. Its approved vector master is not yet present in this + repository. Do not redraw it from a screenshot or promote another glyph into its place. Adding + the exact source SVG, construction geometry and monochrome variant is a launch blocker for the + final identity package. +2. **Interim micro mark** — `public/favicon.svg` is the only current code-native S path. It may act + as a temporary favicon while the approved vector master is unavailable. It is explicitly not the + source of truth for the primary symbol; `favicon.ico` must continue to match it until both are + regenerated from the approved micro master. +3. **Thread cursor** — the vertical square-to-circle device in `SiteHeader` is a secondary editorial + cue for entry, movement and outcome. It is now isolated as `ThreadCursor.astro`. It may accompany + the plain `AgentSutra` wordmark and organise share artwork, but it is not the primary logo. + +The default Open Graph proof sheet uses only the plain wordmark, existing Thread cursor and the +homepage thesis. It deliberately avoids fabricating the missing full symbol. Every approved, +published or corrected Field Note requires a 1200 × 630 note-specific share image whose filename +matches its canonical slug and whose alternative text describes the meaningful visible message. +Drafts may use the default image while their own composition is being reviewed. + +### Header and Navigation + +The desktop header is a flat sticky rule; on mobile it returns to document flow. The Thread cursor's vertical rule, violet square and cyan outcome circle compress the reading progression without impersonating the primary mark. Navigation uses monospaced labels, muted text at rest and a cyan underline plus paper-white text for hover or the current page. + +### Buttons and Links + +Buttons are square, at least 3rem high and weighty without appearing inflated. The primary action is cyan on canvas and reverses to paper ink on hover. The default button uses the dark surface with a strong rule; hover turns that rule cyan. All interactive elements share a visible cyan focus outline (0.2rem) with a 0.3rem offset. Inline links remain underlined and increase underline weight on hover. + +### Thread + +`AgentThread` generates wide and compact SVG diagrams from typed nodes and edges. Violet, periwinkle and cyan gradients show movement between intent, reasoning and outcome; line pattern and visible edge text distinguish deterministic, iterative and unresolved routes. The SVG is hidden from assistive technology because a visible ordered text equivalent lists every step and its node/edge references. The diagram and its text are static HTML/SVG and require no client JavaScript. + +The homepage's continuous cyan overlay performs one top-to-bottom draw over 1.65 seconds with `cubic-bezier(0.16, 1, 0.3, 1)` only when the reader has no reduced-motion preference. The full Thread and all stage nodes already exist in the static document, so motion never reveals required meaning. Reduced motion disables all animation and transition and restores automatic scrolling. + +### Evidence Stamps and Truth States + +The permitted reader-facing stamp vocabulary is `MEASURED`, `REPRODUCED`, `OBSERVED`, `BOUNDED`, `CORRECTED` and `WITHDRAWN`. The label is derived from the evidence record in that priority: withdrawal, correction, measurement, reproduced evidence, observation, then bounded fallback. Amber marks `BOUNDED`; rose marks `CORRECTED` and `WITHDRAWN`; other supporting states use cyan. + +A stamp is a claim about publication state, never a decorative badge. It must agree with the central claim, source access, verification method, limitation, measurement record and correction status. Private evidence is described publicly without exposing its source; synthetic evidence stays labelled synthetic. `FN-000` must always state that it tests fixture contracts only and proves nothing about a real AI system, audience comprehension, security or public release. + +### Ledgers, Panels and The Sutra + +Folios and ledgers present notes, sources, measurements and corrections as records separated by rules. Boundary, transfer and memory panels are full-width tonal fields attached to the reading flow, not cards. “The Sutra” is the compressed takeaway: oversized, short and positioned after evidence and limits, never before them. + +### Accessibility, No-JavaScript and Print States + +Ordinary reading pages are complete as server-rendered static HTML. Semantic landmarks, headings, lists, skip link, visible focus, descriptive links and Thread text equivalents remain present without JavaScript or the custom font. Forced-colour mode maps the palette to system colours and preserves border/shape cues. + +Print changes the system to black on white, removes site navigation, calls to action and the decorative homepage Thread, forces the wide diagram, avoids breaking material panels where possible and appends external URLs. Printed evidence retains its words, order and boundaries; it does not depend on dark-field colour. + +## Do's and Don'ts + +### Do: + +- **Do** begin with the reader's problem and keep evidence, limitation and practical transfer in the same Thread. +- **Do** make the first viewport answer what AgentSutra is, what the reader gains and whether real + lessons exist yet. +- **Do** use folios, ledgers, square rules and semantic geometry to organise dense records. +- **Do** preserve the explicit prelaunch and synthetic status until real evidence passes its gates. +- **Do** verify every new pattern at 320px, with keyboard, reduced motion, forced colours, no JavaScript and print. +- **Do** keep the five-reader comprehension study as the remaining human validation boundary. + +### Don't: + +- **Don't** blend Signal Workshop's instrument chrome or Kinetic Manuscript's typography into the production world. +- **Don't** introduce generic AI gradients, generated decoration, fake paper texture, glass panels, + rounded card stacks or a fabricated author persona. +- **Don't** turn the Thread into wallpaper, a progress claim or an animation that carries required meaning. +- **Don't** use an evidence stamp unless the underlying record earns that exact word. +- **Don't** hide a limitation, correction or synthetic fixture behind visual confidence. diff --git a/publication/EDITORIAL.md b/publication/EDITORIAL.md new file mode 100644 index 0000000..3c5db31 --- /dev/null +++ b/publication/EDITORIAL.md @@ -0,0 +1,141 @@ +# AgentSutra editorial standard + +AgentSutra publishes what was learned by examining a system, not what sounds plausible about AI in general. Every Field Note must help a reader make a better decision and remain credible when a more experienced practitioner inspects the evidence. + +## Editorial promise + +A Field Note is ready only when it is: + +- specific enough to be useful; +- bounded enough to be honest; +- clear enough to understand on a phone; +- inspectable enough to challenge; +- memorable enough for the creator to explain without notes. + +The publication may be visually bold. The claims may not be inflated. + +## Reader order + +Write for a curious practitioner first, then provide doors into technical depth. Do not make the reader understand the repository, experiment history, or internal record model before the lesson becomes useful. + +Use this default sequence when it fits the material: + +1. **Problem** — a recognisable situation or decision. +2. **Naive model** — the tempting but incomplete explanation. +3. **Mechanism** — what is actually happening. +4. **Evidence** — what was observed, reproduced, or measured. +5. **Boundary** — what the evidence does not establish. +6. **Transfer** — what the reader can do differently today. +7. **The Sutra** — one compressed, defensible memory line. +8. **Depth door** — sources, implementation detail, or reproduction path. + +This is a grammar, not a quota. Omit a stage that does not improve the lesson. + +## First-visit comprehension + +The homepage and utility routes must explain the reader benefit before the publication machinery. +A first-time visitor should understand, without opening a technical record: + +- AgentSutra turns first-hand AI experiments, failures and corrections into practical lessons; +- a Thread connects the problem, mechanism, evidence, limit and action; +- no public Field Notes exist while the private-pilot notice is present; +- an engineering fixture is not a lesson or a real-world claim; +- deeper methods, sources, versions and corrections remain available for inspection. + +Do not use `canonical`, `publication graph`, `schema parsing`, `fixture-only`, `risk class`, +`evidence pack`, `lifecycle` or `gates` on the homepage, Start Here or Field Notes index unless the +term is immediately translated into ordinary language. + +## Public evidence language + +Use plain-language status stamps on public surfaces: + +| Stamp | Meaning | +| ------------ | ------------------------------------------------------------ | +| `OBSERVED` | Seen in a bounded instance; not yet shown to generalise. | +| `REPRODUCED` | Repeated under stated conditions. | +| `MEASURED` | Quantified with a versioned method and denominator. | +| `BOUNDED` | Deliberately limited by known conditions or missing proof. | +| `CORRECTED` | Material wording or evidence changed after publication. | +| `WITHDRAWN` | No longer supported and retained only as correction history. | + +Internal risk classes belong on the Method page and in source records. Reader-facing pages translate them into these labels and an explicit limitation. + +## Voice + +- Prefer concrete nouns, active verbs, and short causal explanations. +- State the useful point early. Do not warm up with a manifesto. +- Use first person only for a real action, observation, judgement, or mistake. +- Prefer “under these conditions” to “always”, “can” to “will”, and “the run showed” to “AI proves”. +- Explain necessary technical terms at first use. Do not replace precise terms with misleading simplicity. +- Let a failure remain a failure. Do not turn every mistake into an inspirational arc. +- Use humour or strangeness when it sharpens recall, never to disguise uncertainty. +- Use UK English in canonical copy unless a quoted or platform-native term requires otherwise. + +## Anti-slop rules + +Reject copy that: + +- announces credibility instead of demonstrating it; +- uses symmetrical slogan pairs as a substitute for a concrete claim; +- starts with “in a rapidly evolving world”, “let's dive in”, or equivalent filler; +- calls ordinary implementation “revolutionary”, “game-changing”, “seamless”, or “cutting-edge”; +- attributes intention, understanding, or certainty to a model without evidence; +- invents a reader problem to fit an internal feature; +- hides a limitation in a caption or source footnote; +- turns one observation into universal advice; +- uses a fake quotation, anecdote, testimonial, benchmark, or persona; +- preserves a polished sentence after its evidence has been weakened or removed. + +## Claims and sources + +- Lock the central claim before adaptation. +- Every material supporting claim must resolve to an evidence item. +- Preserve dates, versions, denominators, environment boundaries, and degrees of uncertainty. +- Quote sparingly and link the primary source. +- Separate historical labels from current verified state. +- If public evidence uses an opaque private evidence ID, expose the method and boundary without leaking its source. +- Corrections are part of the public record. Never silently rewrite a material conclusion. + +## Platform adaptations + +Adapt the composition, not the truth. + +- **Instagram:** visual teaching sequence; one job per frame; accessible alt text for every frame. +- **TikTok photo post:** a tall, phone-first sequence with shorter copy and the same evidence boundary. +- **LinkedIn:** a selectable-text document plus an attributed professional reflection; do not paste an Instagram caption. +- **Reddit:** native Markdown that opens a genuine discussion and follows the target community's rules; the canonical link is supporting context, not the whole post. + +The central claim, evidence status, limitation, and correction state must remain equivalent across every platform. + +## Interview distillation + +Every real Field Note produces: + +- a 30-second explanation; +- a 90-second explanation; +- a 3-minute technical explanation; +- one credible counterargument; +- one real example; +- what the creator would do differently now. + +These are rehearsal artifacts, not automatically public copy. + +## Human and AI use + +AI may help inspect sources, challenge assumptions, generate alternatives, test contracts, and polish prose. A human remains accountable for the claim, evidence selection, boundary, final wording, and release decision. + +Humanizer or any other prose tool runs only after facts and qualifiers are locked. It may flag patterns and suggest rewrites; it must not change figures, quotations, source relationships, evidence status, uncertainty, or the central claim. Every accepted rewrite receives a human diff review. + +## Final editorial gate + +Before approval, ask: + +1. Can a non-expert restate the lesson accurately? +2. Can a qualified practitioner find the evidence and limitation quickly? +3. Does the practical action follow from the evidence? +4. Is anything presented as general that was only observed once? +5. Can the creator explain the note without reading it? +6. Would a correction be visible if the claim changed tomorrow? + +If any answer is unclear, the note remains a draft. diff --git a/publication/PRODUCT.md b/publication/PRODUCT.md new file mode 100644 index 0000000..1e8a942 --- /dev/null +++ b/publication/PRODUCT.md @@ -0,0 +1,75 @@ +# Product + + + +## Platform + +web + +## Users + +The primary reader is a curious AI user or technical professional who meets a practical problem on a phone and wants a usable explanation without hype. Secondary readers include applied-AI engineers, technical educators, accessibility specialists, hiring managers, and interviewers who may inspect the evidence and challenge the reasoning. + +The creator is also a user. Each issue must improve Pravin Durgani's technical fluency, recall, judgment, and ability to explain the work in interviews. + +## Product purpose + +AgentSutra turns first-hand AI-system experiments, failures, measurements, and corrections into one substantial public Field Note each week. Each note must stand alone, work on a phone, state its evidence boundary, give the reader something practical to do, and retain a path into technical depth. + +Success means the public corpus helps readers make better day-to-day decisions, gives qualified professionals enough detail to scrutinize the work, and compounds into honest portfolio and interview evidence. + +## Positioning + +AgentSutra is a public field laboratory, not a feed of AI tips. One validated source record produces the canonical lesson, its evidence and correction state, an accessible Thread diagram, platform-native static adaptations, and interview explanations. Failures and changes remain part of the record. + +## Operating context + +- One substantial Field Note per week after the private-pilot gate. +- Canonical accessible pages live on `agentsutra.dev`. +- Static adaptations serve Instagram, TikTok, LinkedIn, and Reddit without changing the central claim. +- Instagram and TikTok are faceless, publication-led AgentSutra surfaces—not promises of strict anonymity. Reddit is pseudonymous and discussion-first. The canonical site, LinkedIn and portfolio surfaces attribute the work to Pravin without inventing a separate author persona. +- Three private pilots must test a low-density mental model, a branching or looping mechanism, and an evidence-heavy comparison before launch. +- Each issue generates 30-second, 90-second, and 3-minute interview explanations, one counterargument, and one reflection on what the creator would do differently. + +## Capabilities and constraints + +- Astro static output with strict typed content contracts. +- Ordinary reading pages remain complete without client JavaScript. +- Every material diagram has a visible semantic text equivalent. +- Drafts, fixtures, private evidence, unresolved high-risk claims, and unsafe corrections fail closed. +- The site, platform artifacts, and print output derive from one validated publication graph. +- Archived experiments may inform a Field Note only when the original evidence remains reviewable. + AgentSutra Runtime is frozen and is not presented as a current operational system. Claude Code + Multipane remains a separate project. +- No CMS, database, account system, comments, analytics, automated posting, SSR, React shell, or production WebGL without a measured need and an accepted ADR. +- Cloudflare commands remain dry-run only until a separate release decision. This sprint does not push, deploy, change DNS, or publish. + +## Brand commitments + +- Use `AgentSutra` in camel case. +- Preserve the approved S, Thread, and decision-node identity concept. +- The Thread represents movement through intent, investigation, judgment, evidence, and outcome. It must organize information rather than decorate it. +- The work may be bold, asymmetric, dense, playful, and experimental. It must not become chaotic, misleading, culturally superficial, inaccessible, or difficult to understand. +- Avoid generic AI aesthetics, template-like card grids, arbitrary gradients, decorative generated imagery, and a fabricated author persona. +- Use the conceptual meaning of _sutra_ as thread and compressed principle without imitation Sanskrit typography, decorative Indian clichés, or cultural cosplay. + +## Evidence on hand + +- A synthetic unpublished stress fixture, `FN-000`, exercises the publication graph and is never a public claim. +- The frozen AgentSutra Runtime and the separate Claude Code Multipane project may supply historical + material only after an issue-specific truth, provenance and privacy review. +- Private operational evidence may be referenced only through opaque identifiers. It is not copied into the `publication/` workspace. +- The public-learning programme and production brief define the initial audience, weekly cadence, identity split, editorial grammar, and launch threshold. +- There are no published Field Notes, testimonials, audience metrics, or launch claims yet. Future work must not fabricate them. + +## Product principles + +1. Start with a reader's problem, then earn the explanation with evidence. +2. Make uncertainty, boundaries, corrections, and provenance visible. +3. Design one source of truth into genuinely native public outputs. +4. Teach at phone distance without flattening the technical mechanism. +5. Let publication, proof, and repository repair advance in parallel. + +## Accessibility and inclusion + +Meet WCAG 2.2 AA as a floor. Support keyboard navigation, screen readers, reduced motion, forced colours, 320px reflow, no-JavaScript reading, print, meaningful text alternatives, and plain-language evidence states. Colour and motion may reinforce meaning but may not carry it alone. diff --git a/publication/README.md b/publication/README.md new file mode 100644 index 0000000..bda4cb7 --- /dev/null +++ b/publication/README.md @@ -0,0 +1,145 @@ +# AgentSutra.dev + +AgentSutra.dev is the canonical public-learning surface for **AgentSutra**: accessible, evidence-bounded Field Notes that turn real AI-system observations into useful lessons for a broad technical audience. + +The publication lives in the isolated `publication/` workspace of the AgentSutra repository. The historical Python Runtime remains frozen at the repository root, while Claude Code Multipane remains a separate project. Archived experiments can supply source material only when the original evidence remains reviewable; `publication/` owns the editorial system, public corpus, diagrams, static exports, and publication quality gates. + +## Status + +Private-pilot phase. The source is visible in the public AgentSutra repository, but the website remains pre-launch. `FN-000` is synthetic test content, not a public claim or finished lesson. The Runtime is frozen after its former Mac mini host was reset. No production deployment or DNS change is part of this phase. + +## Product contract + +- One substantial, independently useful Field Note per week after launch. +- One canonical, crawlable, accessible page per note. +- Static platform adaptations derived from the same validated source. +- Faceless, publication-led AgentSutra identity on Instagram and TikTok—not strict anonymity; pseudonymous, discussion-first participation on Reddit; accountable attribution on the canonical site and selective personal attribution on LinkedIn and portfolio surfaces. +- Every note carries its own evidence boundary, limitations, correction state, and practical transfer. +- Every note also produces 30-second, 90-second, and 3-minute interview explanations. + +## Architecture + +```text +typed source records + ├─ field note (Markdown) + ├─ evidence pack (YAML) + ├─ Thread diagram (YAML) + ├─ platform adaptations (YAML) + └─ interview distillation (YAML) + │ + ▼ + validated publication graph + │ + ┌─────┴──────────────┐ + ▼ ▼ +canonical static site deterministic social exports +``` + +Astro produces static HTML. Ordinary Field Notes ship no client JavaScript. AgentSutra Thread diagrams use controlled SVG geometry and always include a visible ordered text equivalent. Cloudflare Workers Static Assets is the intended host, with no server runtime, CMS, database, user accounts, cookies, or behavioural analytics in the initial release. + +The decision to preserve an independent publication boundary inside the AgentSutra monorepo is recorded in [ADR 0003](docs/adr/0003-agent-sutra-monorepo-publication-workspace.md). It supersedes the standalone-repository placement in [ADR 0001](docs/adr/0001-separate-static-publication.md). + +## Local requirements + +- Node `24.19.0` +- npm `11.17.0` + +Both versions are pinned. This project uses exact dependency versions and a committed lockfile. + +```sh +cd publication +npm ci +npm run dev +``` + +## Quality commands + +| Command | Purpose | +| ------------------------------- | ---------------------------------------------------------------- | +| `npm run check` | Astro and TypeScript validation | +| `npm test` | Content-contract and unit tests | +| `npm run privacy:scan` | Reject private paths, topology, credentials, and unsafe fixtures | +| `npm run build` | Production build; drafts and synthetic fixtures are excluded | +| `npm run build:fixtures` | Local fixture build for test coverage | +| `npm run build:exports` | Local-only export build | +| `npm run verify:dist` | Assert the generated public surface and zero-JS contract | +| `npm run test:e2e` | Cross-browser, responsive, and accessibility checks | +| `npm run export:social` | Generate native static social assets | +| `npm run export:verify` | Prove native assets match across two clean builds | +| `npm run verify:public-profile` | Prove public release succeeds only with a real reviewed note | +| `npm run release:source` | Package the clean committed publication source | +| `npm run release:preview` | Rebuild, validate, and package the pre-launch static preview | +| `npm run release:artifacts` | Produce both release archives without deploying | +| `npm run deploy:dry-run` | Validate the Cloudflare artifact without publishing | +| `npm run verify` | Run the core local verification chain | + +The browser matrix and every intentional engine-specific skip are documented in +[tests/PLAYWRIGHT_COVERAGE.md](tests/PLAYWRIGHT_COVERAGE.md). + +## Release archives + +Release archives are generated under the ignored `.release/` directory and are named with the +12-character monorepo commit ID. Each ZIP receives a sibling `.sha256` checksum. + +- `release:source` uses `git archive` on `HEAD:publication`. It refuses tracked, staged, or + untracked changes anywhere under `publication/`, so it cannot silently package stale `HEAD`. + Repository-owned agent workflows remain available to contributors but `.agents/` and `.codex/` + are deliberately excluded from the portable source artifact. +- `release:preview` applies the same clean-tree rule, performs a fresh atomic pre-launch build, + validates that build, and packages only the resulting static files. It excludes dependencies, + fixture/export builds, test output, local tooling, Git history, `.DS_Store`, and `__MACOSX`. + +These commands create local artifacts only. They do not upload, deploy, publish, or change DNS. + +## Content workflow + +1. Start from an audience problem, not an internal repository feature. +2. Define one central claim and up to five material supporting claims. +3. Classify the issue risk and provide the required evidence. +4. Write the canonical note and an accessible Thread diagram. +5. Add the practical “use this today” transfer and optional technical-depth door. +6. Generate native platform adaptations and interview explanations. +7. Run privacy, schema, accessibility, static-build, export, and human editorial review. +8. Publish only when that issue's evidence gate passes. + +Repository-wide remediation continues in parallel and is not a blanket publication gate. + +## Privacy boundary + +The `publication/` workspace must never contain raw AgentSutra Node operations, machine identifiers, private topology, credentials, personal absolute paths, client or employer material, private logs, or unredacted screenshots. Public examples must be synthetic or explicitly sanitised and recorded as such. + +See [AGENTS.md](AGENTS.md) for the enforced working rules. + +## Identity + +Use `AgentSutra` in camel case. The visual system uses a restrained violet-to-cyan progression for intent → reasoning → outcome and a consistent Thread grammar: + +- square: state, input, or artifact +- diamond: decision or judgement +- circle: process or model +- arrow: deterministic transition +- loop: iteration +- ellipsis: unresolved uncertainty +- cross: failure +- check: verified outcome + +The wordmark remains plain `AgentSutra`; the symbol carries the diagrammatic character. + +The primary S / Thread / decision-node mark remains approved in concept but its exact vector master +has not yet been added to the repository. Until it is supplied, the header's square-to-circle device +is treated as a secondary **Thread cursor**, and `favicon.svg` remains an explicitly interim micro +mark. Neither should be presented as a replacement primary logo. Default share artwork therefore +uses the plain wordmark and Thread cursor rather than inventing missing logo geometry. + +## Themes + +The publication has two expressions of the same Threaded Field Lab system: + +- **Night Lab:** the dark inspection chamber used by the current production design; +- **Daylight Proof:** a warm mineral-paper light theme with dense printing inks. + +The browser follows the reader's operating-system preference without client JavaScript. Social and document exports remain explicitly dark so automatic theme preference cannot alter deterministic artifacts. + +## Deployment boundary + +`wrangler deploy --dry-run` is allowed for validation. Creating a Cloudflare project, changing nameservers or DNS, connecting `agentsutra.dev`, or publishing the site requires a separate release decision after the private-pilot launch gate passes. diff --git a/publication/RIGHTS.md b/publication/RIGHTS.md new file mode 100644 index 0000000..59056a9 --- /dev/null +++ b/publication/RIGHTS.md @@ -0,0 +1,18 @@ +# Rights and licensing + +This publication workspace is pre-launch. Its source is visible in the public AgentSutra repository, but no public site or social artifact has been released. + +For avoidance of doubt, the repository-root MIT licence applies to AgentSutra Runtime files outside `publication/`. It does not grant rights to the code, editorial corpus, diagrams, generated adaptations, or identity assets inside `publication/`; those materials are governed by this file and any more specific notice beside an asset. + +Unless a file states otherwise, the AgentSutra source code, editorial content, diagrams, identity assets, and generated adaptations are copyright Pravin Durgani. All rights are reserved while the long-term code and content licences are evaluated. Possession of the source does not grant permission to republish the editorial corpus or identity assets. + +Third-party dependencies and development tools retain their own licences. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). + +Before the publication launches, make an explicit decision for each layer: + +1. application source code; +2. editorial Field Notes and social adaptations; +3. AgentSutra name, wordmark, symbol, and identity system; +4. evidence supplied under private or third-party terms. + +Do not assume one open-source licence is appropriate for all four layers. diff --git a/publication/THIRD_PARTY_NOTICES.md b/publication/THIRD_PARTY_NOTICES.md new file mode 100644 index 0000000..7a2f906 --- /dev/null +++ b/publication/THIRD_PARTY_NOTICES.md @@ -0,0 +1,34 @@ +# Third-party notices + +AgentSutra uses third-party software under the licences declared by its locked dependencies. `package-lock.json` is the authoritative dependency inventory for a given revision. + +## Development capabilities + +The following project-local capabilities support development but are not shipped as website runtime code: + +- **Impeccable** — optional design workflow installed locally from the `impeccable` npm package. It is not vendored in this repository. See . +- **Humanizer** — optional prose-review skill sourced from `blader/humanizer`. It is not vendored in this repository, and any suggestions remain subject to the evidence-preserving rules in [EDITORIAL.md](EDITORIAL.md). + +UI UX Pro Max was consulted from a pinned temporary package as a pattern reference. It is not vendored in this workspace because its published package and repository licensing signals require clarification before redistribution. + +## Apple SHARP + +Apple SHARP is not a dependency, asset source, or production capability in this workspace. Its research boundary is recorded in [ADR 0002](docs/adr/0002-ml-sharp-research-boundary.md). + +## Fonts and identity assets + +### Recursive + +- Family: Recursive Sans & Mono +- Version: 1.085 +- Designer and publisher: Arrow Type +- Source: `https://github.com/arrowtype/recursive/tree/v1.085` +- Local webfont: `public/fonts/recursive-v1.085-latin-basic.woff2` +- Webfont SHA-256: `7af699706ba1d2a1947f4755d177927597b24c168f8d46585dabdb080e4d113c` +- Licence: SIL Open Font License 1.1 +- Local licence: `licenses/Recursive-OFL-1.1.txt` +- Licence SHA-256: `f9f539cf7549bd417159dbdb9c400943a5b60a7366c2c6fbde9f095173d82479` + +Recursive is self-hosted so the canonical site and deterministic export renderer use the same licensed font asset without a third-party runtime request. + +Any additional font or third-party identity asset must be listed here with its exact version, source URL, licence, local file path, and integrity hash before it is committed or used for deterministic exports. diff --git a/publication/astro.config.mjs b/publication/astro.config.mjs new file mode 100644 index 0000000..ec2b800 --- /dev/null +++ b/publication/astro.config.mjs @@ -0,0 +1,24 @@ +// @ts-check +import sitemap from '@astrojs/sitemap'; +import { defineConfig } from 'astro/config'; + +export default defineConfig({ + site: 'https://agentsutra.dev', + output: 'static', + outDir: process.env.ASTRO_OUT_DIR ?? './dist', + trailingSlash: 'always', + compressHTML: true, + integrations: [ + sitemap({ + filter: (page) => + !page.includes('/__exports/') && + !page.includes('/exports/') && + !page.includes('/fixtures/') && + !page.includes('/interview/'), + }), + ], + build: { + format: 'directory', + inlineStylesheets: 'never', + }, +}); diff --git a/publication/design-explorations/README.md b/publication/design-explorations/README.md new file mode 100644 index 0000000..94f9bea --- /dev/null +++ b/publication/design-explorations/README.md @@ -0,0 +1,15 @@ +# AgentSutra Design Explorations + +Three independent, code-native visual directions render the same synthetic `FN-000` content contract. This lab is intentionally isolated from the production site: no prototype imports a production component, changes a project configuration, or implies deployment approval. + +## Open the lab + +- `index.html` — overview and recommendation +- `threaded-field-lab/index.html` — spatial Thread identity +- `kinetic-manuscript/index.html` — editorial manuscript identity +- `signal-workshop/index.html` — verification-instrument identity +- `scorecard.md` — weighted heuristic evaluation +- `recommendation.md` — decision and non-blending rule +- `verify.mjs` — local browser, accessibility, media-mode and screenshot verification + +The prototypes use only local HTML, CSS and SVG. The score is expert heuristic evidence, not audience research. Before adoption, run the proposed five-person comprehension study against the unlabelled concepts. diff --git a/publication/design-explorations/assets/fn-000-content-contract.md b/publication/design-explorations/assets/fn-000-content-contract.md new file mode 100644 index 0000000..c3db710 --- /dev/null +++ b/publication/design-explorations/assets/fn-000-content-contract.md @@ -0,0 +1,16 @@ +# FN-000 Shared Content Contract + +All three explorations must preserve these semantic anchors. Wording may be set typographically, but meaning and evidence boundaries may not change. + +- **Title:** Synthetic stress fixture: an intentionally overlong Field Note title that tests wrapping, narrow screens, metadata density, punctuation — and resilient editorial layouts +- **Central claim:** A synthetic, explicitly fictional record can test the publishing contract without making a real-world system claim. +- **Problem:** A plausible page can still conceal a broken publishing system. +- **Naïve model:** Approve one polished example and call the system reusable. +- **Mechanism:** Draft → typed set → parse → decision: references agree? → unresolved/build rejected loop or validated/verified output. +- **Evidence checks:** structure, references, density, adaptation and boundary. +- **Boundary:** This fixture tests the publication pipeline; it proves nothing about a deployed AI system and cannot become portfolio evidence. +- **The Sutra:** Stress the contract before trusting the content pipeline. +- **Transfer:** Test the longest title, the messiest caveat and an unresolved source before publishing the easy example. +- **Platform frames:** Instagram carousel, TikTok photo post, LinkedIn document and Reddit native text. + +This record is synthetic and must remain labelled `noindex`, `nofollow`, design-lab-only and not for production publication. diff --git a/publication/design-explorations/index.html b/publication/design-explorations/index.html new file mode 100644 index 0000000..97fd0b1 --- /dev/null +++ b/publication/design-explorations/index.html @@ -0,0 +1,3 @@ +AgentSutra Design Explorations

AgentSutra / sealed design lab / FN-000

Three systems. One lesson.

A controlled comparison of three deliberately separate visual languages. Every direction carries the same Thread, evidence, boundary, Sutra and platform frames. None changes the production site.

Study A / spatial systems field

Threaded Field Lab

The Thread becomes the page's navigation, reasoning model and recognisable signature.

Study B / editorial manuscript

Kinetic Manuscript

Large type, marginalia and folio rhythm turn technical explanation into an authored publication.

Study C / verification instrument

Signal Workshop

Test-bench rails, interlocks and status readouts make proof and limits exceptionally explicit.

Provisional recommendation

Advance Threaded Field Lab—without blending.

It wins the heuristic by a narrow margin because it owns the AgentSutra Thread rather than resembling a magazine or developer console. Signal Workshop remains a serious alternative until a five-reader comprehension test validates the choice.

Read the decision boundary · Inspect the scorecard

Weighted heuristic

DirectionScore / 100Strongest signal
Threaded Field Lab92.0Brand authenticity
Signal Workshop90.6Evidence legibility
Kinetic Manuscript85.7Distinctiveness

No-blending rule: choose a system, then refine inside its metaphor. Do not assemble a compromise from favourite details.

AgentSutra design exploration · 17 August 2026 · no deployment approval
diff --git a/publication/design-explorations/kinetic-manuscript/index.html b/publication/design-explorations/kinetic-manuscript/index.html new file mode 100644 index 0000000..9104b2d --- /dev/null +++ b/publication/design-explorations/kinetic-manuscript/index.html @@ -0,0 +1,56 @@ + + + + + + + Kinetic Manuscript — AgentSutra Design Exploration + + + + +
AgentSutraDesign study B · not production
+
+
+
+

Field Note 000 / Synthetic fixture / 12 min

+

Synthetic stress fixture: an intentionally overlong Field Note title that tests wrapping, narrow screens, metadata density, punctuation — and resilient editorial layouts

+

A fictional record can pressure-test a publishing contract without pretending that a real system was measured.

+
Intent → reasoning → resolved output
+
+ +
+
01

The opening tension

A plausible page can still be a broken publishing system.

Long titles, unresolved evidence, dense diagrams and platform adaptations are where a neat template quietly fails. The naïve model is to approve one polished example and call the system reusable.

+ +
+ +
+

The Thread / mechanism

Let structure reject false confidence.

+ +
  1. Draft input enters a typed content set.
  2. The parser checks structure and evidence references.
  3. A decision asks whether references agree.
  4. Unresolved evidence rejects the build and loops to repair.
  5. Only validated content becomes a verified output.
+
+ +
+

Evidence folio

One claim. Five checks.

+
“A synthetic, explicitly fictional record can test the publishing contract without making a real-world system claim.”
+
  1. Structure. Required fields can fail before publication.
  2. References. Diagram and evidence identifiers can be cross-checked.
  3. Density. Long copy exposes wrapping and hierarchy failures.
  4. Adaptation. One meaning can be tested across four platform frames.
  5. Boundaries. Fiction remains visibly labelled and cannot become portfolio evidence.
+
+ +

Boundary / do not cite

This fixture proves the pipeline can carry complexity. It proves nothing about a deployed AI system.

All people, outcomes and measurements are synthetic. The note must never migrate into a CV, benchmark or factual case study.

+ +

The Sutra

Stress the contract
before trusting
the content pipeline.

Use this today: test your template with the longest title, the messiest caveat and an unresolved source before publishing the easy example.

+ +

Platform proofs

One manuscript, four native readings.

+
Instagram / 01

Your polished template may be hiding the failure.

Stress the contract before the first real issue.

+
TikTok photo / 01

The uncomfortable test:

Can your content system reject an unresolved source?

+
LinkedIn document

What a synthetic fixture actually proves

Contract resilience, not runtime performance.

+
Reddit / native text

I tried to break the publishing template before trusting it.

Here is the failure path and the boundary.

+
+
+
+
AgentSutraKinetic Manuscript · independent exploration · August 2026
+ + diff --git a/publication/design-explorations/kinetic-manuscript/styles.css b/publication/design-explorations/kinetic-manuscript/styles.css new file mode 100644 index 0000000..8b5582d --- /dev/null +++ b/publication/design-explorations/kinetic-manuscript/styles.css @@ -0,0 +1 @@ +:root{--paper:#f2eddf;--ink:#171713;--muted:#5e5a50;--violet:#6844d9;--cyan:#008eaa;--red:#a93232;--rule:#9f9888;color-scheme:light;font-family:Inter,ui-sans-serif,system-ui,sans-serif}*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--paper);color:var(--ink);line-height:1.55}.skip{position:fixed;z-index:5;top:.5rem;left:.5rem;transform:translateY(-180%);background:#fff;color:#000;padding:.7rem}.skip:focus{transform:none}.mast,footer{display:flex;justify-content:space-between;gap:2rem;padding:1.1rem 4vw;border-bottom:1px solid var(--ink);font-size:.75rem;letter-spacing:.12em;text-transform:uppercase}.mast a,footer b{color:inherit;font-size:1rem;letter-spacing:-.02em;text-transform:none;text-decoration:none}main{max-width:1440px;margin:auto;padding:0 4vw}.hero{position:relative;padding:9vw 0 6vw;border-bottom:1px solid var(--ink)}.folio,.kicker{font-size:.72rem;font-weight:800;letter-spacing:.16em;text-transform:uppercase}.hero h1{font-family:Georgia,serif;font-size:clamp(3rem,7.3vw,8.4rem);font-weight:400;letter-spacing:-.065em;line-height:.85;max-width:15ch;margin:.7rem 0 2rem}.dek{font-family:Georgia,serif;font-size:clamp(1.25rem,2vw,2rem);max-width:43ch}.margin-note{position:absolute;right:0;top:3rem;writing-mode:vertical-rl;font-size:.7rem;text-transform:uppercase;letter-spacing:.12em;color:var(--muted)}.margin-note i{color:var(--cyan)}h2{font-family:Georgia,serif;font-weight:400;letter-spacing:-.045em;line-height:1.02;font-size:clamp(2.1rem,5vw,5.5rem);margin:.4rem 0 1.5rem}.spread{display:grid;grid-template-columns:4rem minmax(0,1fr) 17rem;gap:3vw;padding:7rem 0;border-bottom:1px solid var(--rule)}.ordinal{font-family:Georgia,serif;font-size:3rem;color:var(--violet)}.spread>div p{max-width:56ch;font-size:1.1rem}.spread aside{border-top:4px solid var(--cyan);padding-top:1rem}.thread{padding:7rem 0;border-bottom:1px solid var(--rule)}.thread-line{position:relative;display:flex;align-items:center;gap:.8rem;margin:4rem 0 2rem;padding:2.5rem 1rem;border-block:1px solid var(--ink);overflow-x:auto}.thread-line span{font-family:Georgia,serif;font-size:1.1rem;white-space:nowrap}.thread-line b{font-size:1.6rem;color:var(--violet)}.thread-line b:last-of-type{color:var(--cyan)}.thread-line em{font-style:normal}.thread-line .loop{position:absolute;bottom:.25rem;left:42%;color:var(--red);font-size:.7rem;letter-spacing:.1em;text-transform:uppercase}.text-equivalent{columns:2;column-gap:4rem;margin:2rem 0;padding-left:1.3rem;color:var(--muted)}.evidence{display:grid;grid-template-columns:.85fr 1.15fr;gap:5vw;padding:7rem 0;border-bottom:1px solid var(--rule)}blockquote{font-family:Georgia,serif;font-size:clamp(1.7rem,3.4vw,3.6rem);line-height:1.12;margin:1rem 0;border-left:8px solid var(--violet);padding-left:1.5rem}.evidence ol{counter-reset:check;list-style:none;margin:0;padding:0}.evidence li{padding:1.2rem 0;border-top:1px solid var(--rule)}.evidence li::before{counter-increment:check;content:'0' counter(check);display:inline-block;width:3rem;color:var(--cyan);font-weight:800}.boundary{margin:7rem 0;padding:3rem;border:2px solid var(--red);transform:rotate(-.4deg)}.boundary h2{font-size:clamp(2rem,4vw,4.4rem)}.stamp{display:inline-block;border:2px solid var(--red);color:var(--red);padding:.35rem .6rem;text-transform:uppercase;font-weight:900;letter-spacing:.12em}.sutra{padding:9rem 0;text-align:center}.sutra h2{font-size:clamp(3.6rem,9vw,10rem);line-height:.79}.sutra p{max-width:60ch;margin:2rem auto;font-family:Georgia,serif;font-size:1.2rem}.platforms{padding:6rem 0}.platform-grid{display:grid;grid-template-columns:repeat(4,1fr);gap:1rem}.platform-grid article{min-height:25rem;padding:1.5rem;border:1px solid var(--ink);display:flex;flex-direction:column;justify-content:flex-end}.platform-grid article:nth-child(2){background:var(--ink);color:var(--paper)}.platform-grid article:nth-child(3){border-top:10px solid var(--violet)}.platform-grid article:nth-child(4){border-bottom:10px solid var(--cyan)}.platform-grid span{margin-bottom:auto;font-size:.68rem;text-transform:uppercase;letter-spacing:.12em}.platform-grid h3{font-family:Georgia,serif;font-size:1.8rem;line-height:1.05}footer{border-top:1px solid var(--ink);border-bottom:0}@media(max-width:800px){.mast span{display:none}.hero{padding-top:6rem}.hero h1{font-size:clamp(2.8rem,14vw,5rem)}.margin-note{display:none}.spread,.evidence{grid-template-columns:1fr}.spread{padding:4rem 0}.ordinal{font-size:1.2rem}.text-equivalent{columns:1}.platform-grid{grid-template-columns:1fr 1fr}.platform-grid article{min-height:20rem}.sutra{padding:6rem 0}}@media(max-width:430px){main{padding:0 1rem}.mast,footer{padding:1rem}.platform-grid{grid-template-columns:1fr}.boundary{padding:1.3rem;margin:4rem 0}.thread-line{margin-top:2rem}.sutra h2{font-size:3.5rem}footer{align-items:flex-start;flex-direction:column}}@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,*::before,*::after{animation-duration:.001ms!important;animation-iteration-count:1!important;transition-duration:.001ms!important}}@media(forced-colors:active){*{forced-color-adjust:auto}.margin-note i,.thread-line b,.ordinal{color:LinkText}.stamp{color:CanvasText}}@media print{@page{size:A4;margin:14mm}body{background:#fff;font-size:9.5pt}.mast{padding:0 0 8mm}.mast span{display:block}main{padding:0}.hero{padding:16mm 0}.hero h1{font-size:39pt}.margin-note,.platforms{display:none}.spread,.thread,.evidence,.sutra{padding:12mm 0}.spread{grid-template-columns:10mm 1fr}.spread aside{grid-column:2}.evidence{grid-template-columns:1fr 1fr}.boundary{margin:12mm 0;transform:none}.sutra h2{font-size:42pt}.thread-line{white-space:normal;flex-wrap:wrap}section{break-inside:auto}h2,blockquote{break-after:avoid}.text-equivalent{columns:1}footer{padding:8mm 0 0}} diff --git a/publication/design-explorations/recommendation.md b/publication/design-explorations/recommendation.md new file mode 100644 index 0000000..fce9de4 --- /dev/null +++ b/publication/design-explorations/recommendation.md @@ -0,0 +1,23 @@ +# Recommendation: Threaded Field Lab + +Choose **Threaded Field Lab** as the single direction for the private pilot. + +It expresses the already-frozen AgentSutra idea most faithfully: a Thread moves from intent through reasoning and judgement to an externalised outcome. Evidence, boundaries, loops and platform adaptations feel like one authored visual language. The other concepts are strong alternatives, but Signal Workshop reads more like an engineering console and Kinetic Manuscript trades too much repeatability for editorial drama. + +## Do not blend the concepts + +Do not import Kinetic Manuscript's typography or Signal Workshop's instrument chrome into Threaded Field Lab. Blending would erase the value of the experiment and produce a familiar “editorial dashboard.” Archive both losing directions intact as decision evidence. + +Production refinement may occur **inside** the selected concept: rhythm, type scale, contrast, diagram semantics, content density and export framing. It may not borrow a second concept's visual metaphor. + +## Decision boundary + +This is a provisional heuristic recommendation, not user research. Before production adoption, show the three unlabelled mobile prototypes to at least five target readers. Ask them to: + +1. restate the central claim; +2. identify what is evidence and what is a boundary; +3. explain the Thread without prompting; +4. find the “use this today” action; +5. choose which system they would recognise again a week later. + +Reopen the decision only if Threaded Field Lab materially underperforms on comprehension or accessibility—not because individual details in another direction look attractive. diff --git a/publication/design-explorations/scorecard.md b/publication/design-explorations/scorecard.md new file mode 100644 index 0000000..05f3b74 --- /dev/null +++ b/publication/design-explorations/scorecard.md @@ -0,0 +1,28 @@ +# Design Direction Scorecard + +- Date: 17 August 2026 +- Content: identical synthetic `FN-000` fixture +- Status: heuristic expert review; not audience validation + +Scores are out of 10. Weighted totals are out of 100. + +| Criterion | Weight | Threaded Field Lab | Kinetic Manuscript | Signal Workshop | +|---|---:|---:|---:|---:| +| Distinctiveness | 15 | 9.6 | 9.1 | 8.3 | +| Comprehension | 15 | 9.1 | 8.4 | 9.3 | +| Evidence legibility | 15 | 9.0 | 8.2 | 9.6 | +| Mobile resilience | 10 | 8.8 | 8.1 | 9.2 | +| Accessibility potential | 15 | 9.1 | 8.6 | 9.5 | +| Brand authenticity | 10 | 9.8 | 8.8 | 8.3 | +| Platform fit | 8 | 9.2 | 8.5 | 8.8 | +| Performance | 6 | 9.4 | 9.5 | 9.1 | +| Maintainability | 6 | 8.6 | 8.0 | 9.2 | +| **Weighted total** | **100** | **92.0** | **85.7** | **90.6** | + +## Interpretation + +- **Threaded Field Lab** owns the most recognisable AgentSutra territory. It makes the Thread the organising grammar rather than applying it as decoration. +- **Kinetic Manuscript** is memorable and human, but long technical records make its editorial asymmetry harder to systematise on small screens. +- **Signal Workshop** is the clearest verification interface and the easiest to maintain, but risks resembling a generic developer observability product. + +The 1.4-point gap between Threaded Field Lab and Signal Workshop is too small to claim an audience preference. It is enough for a provisional pilot decision because brand authenticity and distinctiveness are strategic requirements, not incidental styling. diff --git a/publication/design-explorations/screenshots/kinetic-manuscript-desktop.png b/publication/design-explorations/screenshots/kinetic-manuscript-desktop.png new file mode 100644 index 0000000..0b42730 Binary files /dev/null and b/publication/design-explorations/screenshots/kinetic-manuscript-desktop.png differ diff --git a/publication/design-explorations/screenshots/kinetic-manuscript-forced-colours.png b/publication/design-explorations/screenshots/kinetic-manuscript-forced-colours.png new file mode 100644 index 0000000..db9324c Binary files /dev/null and b/publication/design-explorations/screenshots/kinetic-manuscript-forced-colours.png differ diff --git a/publication/design-explorations/screenshots/kinetic-manuscript-mobile.png b/publication/design-explorations/screenshots/kinetic-manuscript-mobile.png new file mode 100644 index 0000000..e5f7b1f Binary files /dev/null and b/publication/design-explorations/screenshots/kinetic-manuscript-mobile.png differ diff --git a/publication/design-explorations/screenshots/kinetic-manuscript-print.pdf b/publication/design-explorations/screenshots/kinetic-manuscript-print.pdf new file mode 100644 index 0000000..776fe6a Binary files /dev/null and b/publication/design-explorations/screenshots/kinetic-manuscript-print.pdf differ diff --git a/publication/design-explorations/screenshots/signal-workshop-desktop.png b/publication/design-explorations/screenshots/signal-workshop-desktop.png new file mode 100644 index 0000000..4a64de7 Binary files /dev/null and b/publication/design-explorations/screenshots/signal-workshop-desktop.png differ diff --git a/publication/design-explorations/screenshots/signal-workshop-forced-colours.png b/publication/design-explorations/screenshots/signal-workshop-forced-colours.png new file mode 100644 index 0000000..77e0257 Binary files /dev/null and b/publication/design-explorations/screenshots/signal-workshop-forced-colours.png differ diff --git a/publication/design-explorations/screenshots/signal-workshop-mobile.png b/publication/design-explorations/screenshots/signal-workshop-mobile.png new file mode 100644 index 0000000..0c38227 Binary files /dev/null and b/publication/design-explorations/screenshots/signal-workshop-mobile.png differ diff --git a/publication/design-explorations/screenshots/signal-workshop-print.pdf b/publication/design-explorations/screenshots/signal-workshop-print.pdf new file mode 100644 index 0000000..78825eb Binary files /dev/null and b/publication/design-explorations/screenshots/signal-workshop-print.pdf differ diff --git a/publication/design-explorations/screenshots/threaded-field-lab-desktop.png b/publication/design-explorations/screenshots/threaded-field-lab-desktop.png new file mode 100644 index 0000000..6f30132 Binary files /dev/null and b/publication/design-explorations/screenshots/threaded-field-lab-desktop.png differ diff --git a/publication/design-explorations/screenshots/threaded-field-lab-forced-colours.png b/publication/design-explorations/screenshots/threaded-field-lab-forced-colours.png new file mode 100644 index 0000000..684c4e0 Binary files /dev/null and b/publication/design-explorations/screenshots/threaded-field-lab-forced-colours.png differ diff --git a/publication/design-explorations/screenshots/threaded-field-lab-mobile.png b/publication/design-explorations/screenshots/threaded-field-lab-mobile.png new file mode 100644 index 0000000..5597239 Binary files /dev/null and b/publication/design-explorations/screenshots/threaded-field-lab-mobile.png differ diff --git a/publication/design-explorations/screenshots/threaded-field-lab-print.pdf b/publication/design-explorations/screenshots/threaded-field-lab-print.pdf new file mode 100644 index 0000000..da6dae9 Binary files /dev/null and b/publication/design-explorations/screenshots/threaded-field-lab-print.pdf differ diff --git a/publication/design-explorations/signal-workshop/index.html b/publication/design-explorations/signal-workshop/index.html new file mode 100644 index 0000000..d861b76 --- /dev/null +++ b/publication/design-explorations/signal-workshop/index.html @@ -0,0 +1,26 @@ + + +Signal Workshop — AgentSutra Design Exploration + + +
AgentSutraSignal Workshop Synthetic fixture / lab only
+
+
FN000Protocol stress test

Field Note / 000 / 12 min / synthetic

Synthetic stress fixture: an intentionally overlong Field Note title that tests wrapping, narrow screens, metadata density, punctuation — and resilient editorial layouts

A fictional record can pressure-test a publishing contract without pretending that a real system was measured.

+ +

Input anomaly

A plausible page can still conceal a broken publishing system.

Long titles, unresolved evidence, dense diagrams and platform adaptations are where a neat template quietly fails.

Naïve model / rejected

Approve one polished example and call the system reusable.

That tests taste, not resilience.

+ +

Thread test bench / live path

Structure must reject false confidence.

+ +
  1. Draft input enters a typed content set.
  2. The parser checks structure and evidence references.
  3. A decision asks whether references agree.
  4. Unresolved evidence rejects the build and loops to repair.
  5. Only validated content becomes a verified output.
+
+ +

Evidence console / 5 checks

Central claim under test

A synthetic, explicitly fictional record can test the publishing contract without making a real-world system claim.

01 StructureRequired fields can fail before publication.Ready
02 ReferencesDiagram and evidence identifiers can be cross-checked.Ready
03 DensityLong copy exposes wrapping and hierarchy failures.Ready
04 AdaptationOne meaning is tested across four platform frames.Ready
05 BoundaryFiction cannot become portfolio evidence.Locked
+ +

Boundary interlock / do not cite

This fixture proves the pipeline can carry complexity. It proves nothing about a deployed AI system.

All people, outcomes and measurements are synthetic. Never migrate this note into a CV, benchmark or factual case study.

+ +
Calibration ruleAS–000

The Sutra

Stress the contract before trusting the content pipeline.

Use this today: test your template with the longest title, the messiest caveat and an unresolved source before publishing the easy example.

+ +

Output adapters

Same signal. Native frames.

IG / 4:5
□ → ◇ → ✓

Your polished template may hide the failure.

TikTok photo / 4:5
× unresolved

Can your content system reject a bad source?

LinkedIn / document
Evidence 05 / locked

What a synthetic fixture actually proves

Reddit / native text
Method → boundary

I tried to break the publishing template first.

+
+
AgentSutraSignal Workshop · independent exploration · no production merge
+ diff --git a/publication/design-explorations/signal-workshop/styles.css b/publication/design-explorations/signal-workshop/styles.css new file mode 100644 index 0000000..7a18a52 --- /dev/null +++ b/publication/design-explorations/signal-workshop/styles.css @@ -0,0 +1,2 @@ +:root{--bg:#d9ddd9;--surface:#eef1ed;--ink:#101513;--line:#75807a;--cyan:#007f83;--violet:#613cc7;--lime:#3a7b47;--amber:#9a5b00;--fault:#a12d2d;color-scheme:light;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--bg);color:var(--ink);line-height:1.5;background-image:linear-gradient(rgba(16,21,19,.06) 1px,transparent 1px),linear-gradient(90deg,rgba(16,21,19,.06) 1px,transparent 1px);background-size:24px 24px}.skip{position:fixed;z-index:9;top:.5rem;left:.5rem;transform:translateY(-180%);background:#fff;color:#000;padding:.7rem}.skip:focus{transform:none}.topbar,footer{display:grid;grid-template-columns:1fr 1fr 1fr;gap:1rem;align-items:center;padding:1rem 3vw;background:var(--ink);color:#fff;text-transform:uppercase;letter-spacing:.1em;font-size:.68rem}.topbar a{color:#fff;text-decoration:none;font:800 1rem ui-sans-serif,system-ui}.status{text-align:right}.status i{display:inline-block;width:.65rem;height:.65rem;border-radius:50%;background:#65d786;margin-right:.4rem}main{max-width:1500px;margin:auto;padding:2rem 3vw}.panel{background:var(--surface);border:1px solid var(--ink);box-shadow:4px 4px 0 var(--ink)}.hero{display:grid;grid-template-columns:15rem 1fr;gap:3rem;padding:clamp(1.5rem,4vw,4rem)}.readout{display:flex;flex-direction:column;border-right:1px solid var(--line)}.readout span,.label{font-size:.68rem;text-transform:uppercase;letter-spacing:.13em;font-weight:800;color:#47514c}.readout b{font:700 clamp(5rem,12vw,11rem)/.8 ui-sans-serif,system-ui;letter-spacing:-.08em}.readout small{margin-top:auto;text-transform:uppercase}.hero h1{font:800 clamp(2.4rem,5vw,5.6rem)/.91 ui-sans-serif,system-ui;letter-spacing:-.055em;margin:.7rem 0 2rem;max-width:18ch}.lead{font:500 1.2rem/1.5 ui-sans-serif,system-ui;max-width:55ch}.split{display:grid;grid-template-columns:1.15fr .85fr;gap:1.2rem;margin:1.2rem 0}.split article{padding:2rem}.split h2,.bench h2,.evidence h2,.boundary h2,.sutra h2,.platforms h2{font:800 clamp(1.8rem,3vw,3.5rem)/1 ui-sans-serif,system-ui;letter-spacing:-.04em;margin:.5rem 0 1.2rem}.naive{border-color:var(--fault);box-shadow:4px 4px 0 var(--fault)}.bench,.evidence,.boundary,.sutra{margin:1.2rem 0;padding:2rem}.rail{position:relative;display:grid;grid-template-columns:repeat(9,max-content);align-items:center;justify-content:center;gap:1rem;padding:3rem 1rem 4rem;border:1px inset var(--line);background:#cbd1cc;overflow-x:auto}.rail>div:not(.fault){display:grid;grid-template-columns:auto 1fr;gap:.1rem .5rem;min-width:7rem;padding:.8rem;border:1px solid var(--ink);background:var(--surface)}.rail i{grid-row:span 2;font-size:1.5rem;color:var(--violet);font-style:normal}.rail small{color:#525d57}.rail .decision{border:2px solid var(--amber)!important}.rail .pass{border:2px solid var(--lime)!important}.rail .pass i{color:var(--lime)}.fault{position:absolute;bottom:.65rem;left:44%;color:var(--fault);font-weight:900;font-size:.72rem;text-transform:uppercase}.text-equivalent{display:grid;grid-template-columns:repeat(5,1fr);gap:1rem;padding:0;list-style:none;counter-reset:steps}.text-equivalent li{counter-increment:steps;padding:1rem;border-top:3px solid var(--violet);font-family:ui-sans-serif,system-ui}.text-equivalent li::before{content:'0' counter(steps);display:block;color:var(--cyan);font-weight:900}.evidence{display:grid;grid-template-columns:.9fr 1.1fr;gap:2rem}.claim{font:600 1.3rem/1.4 ui-sans-serif,system-ui;border-left:5px solid var(--violet);padding-left:1rem}.checks>div{display:grid;grid-template-columns:9rem 1fr 5rem;gap:1rem;padding:1rem;border-top:1px solid var(--line)}.checks i{text-align:right;color:var(--lime);font-style:normal;font-weight:900;text-transform:uppercase}.checks div:last-child i{color:var(--amber)}.boundary{display:grid;grid-template-columns:2rem 1fr;gap:2rem;border:2px solid var(--fault);box-shadow:4px 4px 0 var(--fault)}.hazard{background:repeating-linear-gradient(-45deg,var(--fault),var(--fault) 8px,var(--surface) 8px,var(--surface) 16px)}.sutra{display:grid;grid-template-columns:14rem 1fr;gap:3rem;background:var(--ink);color:#fff}.sutra .label{color:#b9c2bd}.sutra h2{font-size:clamp(3rem,6.5vw,7rem);max-width:15ch}.calibration{border:1px solid #87928c;padding:1rem;height:max-content}.calibration span,.calibration b{display:block}.calibration b{font-size:3rem}.platforms{padding:5rem 0}.platform-grid{display:grid;grid-template-columns:repeat(4,1fr);gap:1rem}.platform-grid article{aspect-ratio:4/5;background:var(--surface);border:1px solid var(--ink);box-shadow:3px 3px 0 var(--ink);padding:1.2rem;display:flex;flex-direction:column}.platform-grid span{font-size:.66rem;text-transform:uppercase;letter-spacing:.1em}.platform-grid h3{margin-top:auto;font:800 1.5rem/1.05 ui-sans-serif,system-ui}.mini-signal{margin-top:2rem;padding:.8rem;border:1px solid var(--cyan);color:var(--cyan);font-weight:900}.fault-text{color:var(--fault);border-color:var(--fault)}footer{margin-top:3rem}@media(max-width:900px){.hero{grid-template-columns:1fr}.readout{border-right:0;border-bottom:1px solid var(--line);padding-bottom:1rem}.readout b{font-size:6rem}.evidence{grid-template-columns:1fr}.text-equivalent{grid-template-columns:1fr 1fr}.platform-grid{grid-template-columns:1fr 1fr}.sutra{grid-template-columns:1fr}.calibration{max-width:14rem}}@media(max-width:520px){.topbar{grid-template-columns:1fr auto}.topbar>span:nth-child(2){display:none}.topbar,.status{font-size:.58rem}.hero,.bench,.evidence,.boundary,.sutra{padding:1.2rem}.hero h1{font-size:2.45rem}.split{grid-template-columns:1fr}.rail{justify-content:start}.text-equivalent,.platform-grid{grid-template-columns:1fr}.checks>div{grid-template-columns:1fr}.checks i{text-align:left}.boundary{grid-template-columns:1rem 1fr}.platform-grid article{max-width:24rem;margin:auto;width:100%}.topbar,footer{padding:1rem}footer{grid-template-columns:1fr;align-items:start}}@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,*::before,*::after{animation-duration:.001ms!important;animation-iteration-count:1!important;transition-duration:.001ms!important}}@media(forced-colors:active){body{background:Canvas}.panel,.rail{box-shadow:none}.status i{background:Highlight}.hazard{background:repeating-linear-gradient(-45deg,CanvasText,CanvasText 2px,Canvas 2px,Canvas 8px)}}@media print{@page{size:A4;margin:13mm}body{background:#fff;font-size:9pt}.topbar,footer{background:#fff;color:#000;padding:0 0 6mm}.topbar a{color:#000}main{padding:0}.panel{box-shadow:none;background:#fff}.hero{grid-template-columns:28mm 1fr;padding:8mm}.readout b{font-size:30pt}.hero h1{font-size:27pt}.split{gap:5mm}.bench,.evidence,.boundary,.sutra{margin:5mm 0;padding:7mm}.sutra{background:#fff;color:#000;grid-template-columns:35mm 1fr}.sutra h2{font-size:32pt}.rail{display:none}.text-equivalent{grid-template-columns:1fr}.platforms{display:none}.checks>div{padding:3mm}.hazard{background:#ddd}h2{break-after:avoid}.panel{break-inside:avoid}} +:root{--cyan:#006b70!important;--lime:#2c6738!important} diff --git a/publication/design-explorations/threaded-field-lab/index.html b/publication/design-explorations/threaded-field-lab/index.html new file mode 100644 index 0000000..41c1f2e --- /dev/null +++ b/publication/design-explorations/threaded-field-lab/index.html @@ -0,0 +1,177 @@ + + + + + + + + Threaded Field Lab — AgentSutra design exploration + + + + +
+ AgentSutra +

Design exploration 01 / Threaded Field Lab

+

Synthetic / Do not publish

+
+ +
+
+ +
+

Publishing foundations · Class A · Foundation

+

Synthetic stress fixture: an intentionally overlong Field Note title that tests wrapping, narrow screens, metadata density, punctuation — and resilient editorial layouts

+

+ A fictional record can pressure-test a publishing contract without pretending that a real system was measured. +

+
+ +
+ +
+
01 / PROBLEM
+
+

A polished example can hide a fragile system.

+

+ A publication pipeline can look reliable while its schemas, long-copy layouts, + references and exclusion controls have never been stressed together. +

+
+
+

Naïve model

+

One short example proves every future content shape will remain safe and readable.

+ × Rejected assumption +
+
+ +
+
+

02 / AGENTSUTRA THREAD

+

Follow the record until it earns an outcome.

+
+ +
+

Text equivalent

+
    +
  1. □ Intent — Start with a clearly labelled synthetic draft.
    2. +
  2. ○ Reason — Parse every schema and compare linked claims.
    3. +
  3. ◇ Judge — Ask whether references and evidence boundaries agree.
    4. +
  4. × Failure — Reject unresolved records and iterate.
    5. +
  5. ✓ Outcome — Retain the fixture only in the explicit test build.
    6. +
+
+
+ +
+
03 / EVIDENCE
+
+

Central claim / Synthetic

+

A synthetic, explicitly fictional record can test the publishing contract without making a real-world system claim.

+

+ The only evidence here is successful validation of synthetic records. It makes no statement about a real lesson or production outcome. +

+
+
    +
  1. SC-1 Fixtures exercise schema limits without posing as evidence.
    2. +
  2. SC-2 Exact claim matching reveals adaptation drift.
    3. +
  3. SC-3 Visible steps preserve a diagram’s meaning.
    4. +
  4. SC-4 Opaque IDs preserve links without exposing locations.
    5. +
  5. SC-5 Explicit fixture mode keeps synthetic routes out of production.
    6. +
+
+ +
+ +
+

04 / Evidence boundary

+

Passing is not publishing.

+

+ The fixture tests declared data contracts only. It does not validate real-world claims, + audience comprehension, security or production operations. +

+
+
+

Does not prove

+
    +
  • Accuracy of a future lesson
    • +
  • Usefulness for a real audience
    • +
  • Readiness for public release
    • +
+
+
+ +
+

05 / THE SUTRA

+

Stress the contract
before trusting the content pipeline.

+
+ Use this today → + Run the same validation graph for each real lesson, then add evidence-specific and + rendered accessibility review. +
+
+ +
+
+

06 / PLATFORM FIELD

+

One claim. Four native frames.

+
+
+
+

Instagram / 01 of 04

+

Your polished template may be hiding the failure.

+ Stress the contract before the first real issue. +
+
+

TikTok / Photo post

+

Can your content system reject an unresolved source?

+ The uncomfortable test / Static +
+
+

LinkedIn / Document

+

What a synthetic fixture actually proves

+ Contract resilience, not runtime performance. +
+
+

Reddit / Discussion

+

I tried to break the publishing template before trusting it.

+ Here is the failure path and the boundary. +
+
+
+
+ +

AgentSutra / Design exploration only / FN-000 synthetic fixture

+ + diff --git a/publication/design-explorations/threaded-field-lab/styles.css b/publication/design-explorations/threaded-field-lab/styles.css new file mode 100644 index 0000000..d9e7ed6 --- /dev/null +++ b/publication/design-explorations/threaded-field-lab/styles.css @@ -0,0 +1,173 @@ +@layer reset, tokens, base, composition, components, states; + +@layer reset { + *, *::before, *::after { box-sizing: border-box; } + html { scroll-behavior: smooth; } + body, h1, h2, h3, p, ol, ul { margin: 0; } + img, svg { display: block; max-width: 100%; } +} + +@layer tokens { + :root { + color-scheme: dark; + --bg: #070810; + --surface: #0d1020; + --surface-2: #11162a; + --ink: #f5f7ff; + --muted: #aab4d0; + --line: #27304b; + --violet: #a78bfa; + --blue: #8ea8ff; + --cyan: #67e7f3; + --mint: #9be6c3; + --danger: #ff8f9d; + --mono: ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace; + --sans: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; + } +} + +@layer base { + body { min-width: 20rem; color: var(--ink); background: var(--bg); font-family: var(--sans); line-height: 1.55; } + body::before { position: fixed; z-index: -1; inset: 0; background-image: linear-gradient(rgb(167 139 250 / .035) 1px, transparent 1px), linear-gradient(90deg, rgb(103 231 243 / .035) 1px, transparent 1px); background-size: 56px 56px; content: ""; mask-image: linear-gradient(to bottom, black, transparent 86%); } + a { color: inherit; text-underline-offset: .25em; } + h1, h2, h3 { line-height: 1.03; letter-spacing: -.045em; text-wrap: balance; } + h1 { max-width: 13ch; font-size: clamp(3.2rem, 8vw, 8.8rem); } + h2 { font-size: clamp(2rem, 4.2vw, 4.8rem); } + h3 { font-size: clamp(1.35rem, 2.2vw, 2.25rem); } + .label, .eyebrow, .section-code, .section-header > p, .masthead, footer, .coordinates { color: var(--muted); font-family: var(--mono); font-size: .74rem; letter-spacing: .11em; text-transform: uppercase; } + .skip-link { position: fixed; z-index: 20; top: .75rem; left: .75rem; padding: .75rem 1rem; color: #000; background: var(--cyan); transform: translateY(-180%); } + .skip-link:focus { transform: none; } + :focus-visible { outline: 3px solid var(--cyan); outline-offset: 4px; } +} + +@layer composition { + .masthead { position: sticky; z-index: 10; top: 0; display: grid; grid-template-columns: 1fr auto 1fr; gap: 1rem; align-items: center; min-height: 4rem; padding: .8rem clamp(1rem, 4vw, 4rem); border-bottom: 1px solid var(--line); background: rgb(7 8 16 / .88); backdrop-filter: blur(18px); } + .wordmark { color: var(--ink); font-family: var(--sans); font-size: 1.05rem; font-weight: 800; letter-spacing: -.03em; text-decoration: none; text-transform: none; } + .status { justify-self: end; color: var(--danger); } + main { overflow: hidden; } + .field-grid { display: grid; grid-template-columns: minmax(8rem, .35fr) minmax(0, 1.35fr) minmax(15rem, .55fr); width: min(100% - 2rem, 92rem); margin-inline: auto; } + .hero { min-height: calc(100svh - 4rem); align-items: center; padding-block: clamp(4rem, 10vw, 10rem); } + .hero-copy { grid-column: 2; } + .hero-index { grid-column: 3; align-self: end; padding: 2rem; border-left: 1px solid var(--line); } + .hero-index ol { padding: 0; list-style: none; counter-reset: section; } + .hero-index li { border-top: 1px solid var(--line); counter-increment: section; } + .hero-index a { display: flex; justify-content: space-between; padding: .8rem 0; text-decoration: none; } + .hero-index a::after { color: var(--muted); content: "0" counter(section); font-family: var(--mono); } + .coordinates { align-self: start; line-height: 1.8; } + .answer { max-width: 56rem; margin-top: 2rem; color: var(--muted); font-size: clamp(1.15rem, 2vw, 1.55rem); } + .eyebrow { margin-bottom: 1.2rem; color: var(--cyan); } + .problem { gap: 2rem; padding-block: clamp(5rem, 9vw, 9rem); border-top: 1px solid var(--line); } + .problem-copy { grid-column: 2; } + .problem-copy p { max-width: 46rem; margin-top: 1.5rem; color: var(--muted); font-size: 1.15rem; } + .naive { grid-column: 3; align-self: end; padding: 1.5rem; border: 1px solid var(--line); background: var(--surface); } + .naive .label { margin-bottom: .8rem; } + .failure { display: block; margin-top: 1.25rem; color: var(--danger); font: .76rem var(--mono); text-transform: uppercase; } + .thread-zone, .platforms { width: min(100% - 2rem, 96rem); margin-inline: auto; padding-block: clamp(5rem, 9vw, 9rem); } + .section-header { display: grid; grid-template-columns: .38fr 1.6fr; gap: 2rem; align-items: end; margin-bottom: 3rem; } + .thread-canvas { overflow-x: auto; padding: 2rem 0; border-block: 1px solid var(--line); } + .thread-canvas svg { min-width: 68rem; } + .thread-text { display: grid; grid-template-columns: .38fr 1.6fr; gap: 2rem; margin-top: 2rem; } + .thread-text ol { display: grid; grid-template-columns: repeat(5, 1fr); gap: 1rem; padding: 0; list-style: none; } + .thread-text li { padding-top: 1rem; border-top: 2px solid var(--line); color: var(--muted); font-size: .86rem; } + .thread-text b { display: block; margin-bottom: .5rem; color: var(--ink); font-family: var(--mono); } + .evidence { gap: 2rem; padding-block: clamp(5rem, 9vw, 9rem); border-top: 1px solid var(--line); } + .evidence-lead { grid-column: 2; } + .evidence-lead p:last-child { max-width: 50rem; margin-top: 1.4rem; color: var(--muted); font-size: 1.1rem; } + .claim-ledger { grid-column: 3; padding: 0; list-style: none; } + .claim-ledger li { padding: 1rem 0; border-top: 1px solid var(--line); } + .claim-ledger span { display: block; color: var(--cyan); font: .7rem var(--mono); } + .boundary { display: grid; grid-template-columns: auto 1fr .65fr; gap: 2.5rem; align-items: center; width: min(100% - 2rem, 88rem); margin: 2rem auto; padding: clamp(2rem, 5vw, 5rem); border: 1px solid var(--danger); background: linear-gradient(120deg, rgb(255 143 157 / .08), transparent 56%), var(--surface); } + .boundary-mark { color: var(--danger); font-size: 5rem; } + .boundary h2 { margin-bottom: 1rem; } + .boundary p { color: var(--muted); } + .boundary-list { padding-left: 2rem; border-left: 1px solid var(--line); } + .boundary-list ul { margin-top: .6rem; padding-left: 1.1rem; color: var(--muted); } + .sutra { position: relative; width: min(100% - 2rem, 96rem); margin-inline: auto; padding-block: clamp(8rem, 15vw, 15rem); text-align: center; } + .sutra::before { position: absolute; inset: 18% 8%; background: radial-gradient(circle, rgb(142 168 255 / .17), transparent 66%); content: ""; } + .sutra > * { position: relative; } + .sutra > p { margin-bottom: 2rem; color: var(--cyan); font: .75rem var(--mono); letter-spacing: .12em; } + .sutra h2 { font-size: clamp(3rem, 7.8vw, 8rem); } + .use-today { max-width: 52rem; margin: 3rem auto 0; color: var(--muted); font-size: 1.1rem; } + .use-today span { display: block; margin-bottom: .5rem; color: var(--mint); font-family: var(--mono); } + .platform-grid { display: grid; grid-template-columns: repeat(12, 1fr); gap: 1rem; } + .platform-card { display: flex; flex-direction: column; justify-content: space-between; min-height: 28rem; padding: 2rem; border: 1px solid var(--line); background: var(--surface); } + .platform-card p, .platform-card span { color: var(--muted); font: .7rem var(--mono); letter-spacing: .08em; text-transform: uppercase; } + .instagram { grid-column: span 5; aspect-ratio: 4 / 5; background: linear-gradient(150deg, rgb(167 139 250 / .16), transparent 60%), var(--surface); } + .tiktok { grid-column: span 3; aspect-ratio: 9 / 16; background: linear-gradient(160deg, rgb(103 231 243 / .13), transparent 55%), var(--surface); } + .linkedin, .reddit { grid-column: span 4; min-height: 20rem; } + .linkedin { background: linear-gradient(150deg, rgb(142 168 255 / .15), transparent 60%), var(--surface); } + footer { padding: 2rem clamp(1rem, 4vw, 4rem); border-top: 1px solid var(--line); text-align: center; } +} + +@layer components { + .thread-line { fill: none; stroke: url(#flow); stroke-linecap: round; stroke-width: 5; } + .thread-glow { fill: none; filter: url(#glow); opacity: .32; stroke: url(#flow); stroke-width: 14; } + .node rect, .node circle, .node path { fill: var(--bg); stroke: var(--cyan); stroke-width: 3; } + .node text { fill: var(--muted); font: 14px var(--mono); text-anchor: middle; } + .node .symbol { fill: var(--ink); font: 46px var(--mono); } + .decision path { stroke: var(--violet); } + .failure-node .symbol { fill: var(--danger); } + .verified .symbol { fill: var(--mint); } + .return { fill: none; stroke: var(--muted); stroke-dasharray: 8 8; stroke-width: 2; } + .return-label { fill: var(--muted); font: 13px var(--mono); text-anchor: middle; text-transform: uppercase; } +} + +@layer states { + @media (max-width: 64rem) { + .masthead { grid-template-columns: 1fr auto; } + .masthead > p:not(.status), .coordinates { display: none; } + .field-grid { grid-template-columns: minmax(0, 1fr) minmax(14rem, .45fr); } + .hero-copy, .problem-copy, .evidence-lead { grid-column: 1; } + .hero-index, .naive, .claim-ledger { grid-column: 2; } + .section-code { grid-column: 1 / -1; } + .boundary { grid-template-columns: auto 1fr; } + .boundary-list { grid-column: 2; } + .thread-text ol { grid-template-columns: repeat(2, 1fr); } + .instagram { grid-column: span 7; } + .tiktok { grid-column: span 5; } + .linkedin, .reddit { grid-column: span 6; } + } + @media (max-width: 42rem) { + .masthead { position: relative; } + .status { display: none; } + .field-grid, .section-header, .thread-text { display: block; } + .hero { min-height: auto; } + .hero-index, .naive, .claim-ledger { margin-top: 2.5rem; } + .problem-copy, .evidence-lead { margin-top: 1rem; } + .thread-text ol { display: block; } + .thread-text li { margin-top: .8rem; } + .boundary { display: block; } + .boundary-mark { font-size: 3rem; } + .boundary-list { margin-top: 2rem; padding: 1.5rem 0 0; border-top: 1px solid var(--line); border-left: 0; } + .platform-grid { display: block; } + .platform-card { min-height: 25rem; margin-top: 1rem; aspect-ratio: auto; } + .tiktok { min-height: 34rem; } + } + @media (prefers-reduced-motion: no-preference) { + .thread-line { animation: breathe 4s ease-in-out infinite alternate; } + @keyframes breathe { to { opacity: .7; filter: drop-shadow(0 0 8px rgb(103 231 243 / .65)); } } + } + @media (prefers-reduced-motion: reduce) { + html { scroll-behavior: auto; } + *, *::before, *::after { animation: none !important; transition: none !important; } + } + @media (forced-colors: active) { + :root { --bg: Canvas; --surface: Canvas; --surface-2: Canvas; --ink: CanvasText; --muted: CanvasText; --line: CanvasText; --violet: LinkText; --blue: LinkText; --cyan: LinkText; --mint: CanvasText; --danger: CanvasText; } + body::before, .sutra::before { display: none; } + .thread-line, .thread-glow { stroke: CanvasText; } + } + @media print { + :root { color-scheme: light; --bg: #fff; --surface: #fff; --surface-2: #fff; --ink: #111; --muted: #333; --line: #888; --cyan: #111; --violet: #111; --mint: #111; --danger: #111; } + @page { margin: 14mm; } + body { background: #fff; font-size: 10pt; } + body::before, .masthead, .hero-index, .thread-canvas, .platforms, footer { display: none; } + .hero { min-height: auto; padding-block: 1cm; } + .field-grid, .section-header, .thread-text, .boundary { display: block; width: 100%; } + .problem, .thread-zone, .evidence, .boundary, .sutra { padding-block: .8cm; break-inside: avoid; } + .thread-text ol { display: block; } + .thread-text li { margin-top: .25cm; } + .claim-ledger, .naive, .boundary-list { margin-top: .5cm; } + h1 { font-size: 34pt; } + h2 { font-size: 22pt; } + } +} diff --git a/publication/design-explorations/verification-report.md b/publication/design-explorations/verification-report.md new file mode 100644 index 0000000..017db4f --- /dev/null +++ b/publication/design-explorations/verification-report.md @@ -0,0 +1,28 @@ +# Verification Report + +- Run: 17 August 2026 +- Command: `node design-explorations/verify.mjs` using the pinned Node 24.19.0 toolchain +- Result: **pass** + +## Browser coverage + +Each prototype passed its semantic contract, console/page-error check and 390px overflow check in: + +- Chromium +- Firefox +- WebKit + +## Responsive and accessibility coverage + +All three prototypes passed: + +- no horizontal document overflow at 320, 390, 768 and 1440 CSS pixels; +- exactly one `h1`, one `main`, and present Thread, evidence, boundary, Sutra and platform sections; +- a visible ordered text equivalent for the diagram; +- zero serious or critical Axe violations in Chromium; +- zero external runtime requests; +- no active animation or transition above the verifier threshold with reduced motion enabled; +- a rendered forced-colours capture at 390px; +- an A4 print PDF generated with print media styles. + +The generated evidence is in `screenshots/`. This verifies implementation properties, not reader comprehension or aesthetic preference. diff --git a/publication/design-explorations/verify.mjs b/publication/design-explorations/verify.mjs new file mode 100644 index 0000000..84d0fbb --- /dev/null +++ b/publication/design-explorations/verify.mjs @@ -0,0 +1,116 @@ +import { createServer } from 'node:http'; +import { readFile, stat, mkdir } from 'node:fs/promises'; +import { extname, join, normalize } from 'node:path'; +import { fileURLToPath } from 'node:url'; +import { chromium, firefox, webkit } from 'playwright'; +import AxeBuilder from '@axe-core/playwright'; + +const root = fileURLToPath(new URL('.', import.meta.url)); +const shots = join(root, 'screenshots'); +const concepts = ['threaded-field-lab', 'kinetic-manuscript', 'signal-workshop']; +const mime = { '.html': 'text/html; charset=utf-8', '.css': 'text/css; charset=utf-8', '.svg': 'image/svg+xml' }; + +await mkdir(shots, { recursive: true }); +const server = createServer(async (request, response) => { + try { + const url = new URL(request.url, 'http://127.0.0.1'); + let relative = decodeURIComponent(url.pathname).replace(/^\/+/, ''); + let target = normalize(join(root, relative)); + if (!target.startsWith(root)) throw new Error('outside root'); + const info = await stat(target).catch(() => null); + if (info?.isDirectory() || url.pathname.endsWith('/')) target = join(target, 'index.html'); + const body = await readFile(target); + response.writeHead(200, { 'content-type': mime[extname(target)] || 'application/octet-stream' }); + response.end(body); + } catch { + response.writeHead(404, { 'content-type': 'text/plain' }); + response.end('Not found'); + } +}); + +await new Promise(resolve => server.listen(0, '127.0.0.1', resolve)); +const origin = `http://127.0.0.1:${server.address().port}`; +const report = { origin, concepts: {}, browsers: {} }; + +try { + for (const [browserName, browserType] of Object.entries({ chromium, firefox, webkit })) { + const browser = await browserType.launch({ headless: true }); + report.browsers[browserName] = []; + try { + for (const concept of concepts) { + const page = await browser.newPage({ viewport: { width: 390, height: 844 } }); + const errors = []; + page.on('console', message => { if (message.type() === 'error') errors.push(message.text()); }); + page.on('pageerror', error => errors.push(String(error))); + const response = await page.goto(`${origin}/${concept}/`, { waitUntil: 'load' }); + if (!response?.ok()) throw new Error(`${browserName}/${concept}: ${response?.status()}`); + const basics = await page.evaluate(() => ({ + h1: document.querySelectorAll('h1').length, + main: Boolean(document.querySelector('main')), + thread: Boolean(document.querySelector('#thread')), + evidence: Boolean(document.querySelector('#evidence')), + boundary: Boolean(document.querySelector('#boundary')), + sutra: Boolean(document.querySelector('#sutra')), + platforms: Boolean(document.querySelector('.platform-grid')), + textEquivalent: Boolean(document.querySelector('[data-diagram-text-equivalent]')), + overflow: document.documentElement.scrollWidth - document.documentElement.clientWidth, + })); + if (basics.h1 !== 1 || !basics.main || !basics.thread || !basics.evidence || !basics.boundary || !basics.sutra || !basics.platforms || !basics.textEquivalent || basics.overflow > 1 || errors.length) { + throw new Error(`${browserName}/${concept}: ${JSON.stringify({ basics, errors })}`); + } + report.browsers[browserName].push({ concept, overflow: basics.overflow, errors: 0 }); + await page.close(); + } + } finally { await browser.close(); } + } + + const browser = await chromium.launch({ headless: true }); + try { + for (const concept of concepts) { + const requests = []; + const context = await browser.newContext({ viewport: { width: 1440, height: 1000 } }); + const page = await context.newPage(); + page.on('request', request => requests.push(request.url())); + await page.goto(`${origin}/${concept}/`, { waitUntil: 'load' }); + const external = requests.filter(url => !url.startsWith(origin)); + if (external.length) throw new Error(`${concept}: external requests ${external.join(', ')}`); + const axe = await new AxeBuilder({ page }).analyze(); + const serious = axe.violations.filter(item => ['serious', 'critical'].includes(item.impact)); + if (serious.length) throw new Error(`${concept}: axe ${JSON.stringify(serious.map(item => ({ id: item.id, nodes: item.nodes.map(node => ({ target: node.target, summary: node.failureSummary })) })))}`); + await page.screenshot({ path: join(shots, `${concept}-desktop.png`), fullPage: true }); + + const matrix = []; + for (const width of [320, 390, 768, 1440]) { + await page.setViewportSize({ width, height: width < 500 ? 844 : 1000 }); + await page.reload({ waitUntil: 'load' }); + const overflow = await page.evaluate(() => Math.max(document.documentElement.scrollWidth, document.body.scrollWidth) - document.documentElement.clientWidth); + if (overflow > 1) throw new Error(`${concept}: ${width}px overflow ${overflow}`); + matrix.push({ width, overflow }); + if (width === 390) await page.screenshot({ path: join(shots, `${concept}-mobile.png`), fullPage: true }); + } + + const reduced = await browser.newPage({ viewport: { width: 390, height: 844 }, reducedMotion: 'reduce' }); + await reduced.goto(`${origin}/${concept}/`, { waitUntil: 'load' }); + const motion = await reduced.evaluate(() => { + const seconds = value => value.split(',').some(part => Number.parseFloat(part) > 0.01 && !part.trim().endsWith('ms')); + return [...document.querySelectorAll('*')].filter(element => { const style = getComputedStyle(element); return seconds(style.animationDuration) || seconds(style.transitionDuration); }).length; + }); + if (motion) throw new Error(`${concept}: ${motion} moving elements under reduced motion`); + await reduced.close(); + + const forced = await browser.newPage({ viewport: { width: 390, height: 844 }, forcedColors: 'active' }); + await forced.goto(`${origin}/${concept}/`, { waitUntil: 'load' }); + await forced.screenshot({ path: join(shots, `${concept}-forced-colours.png`), fullPage: true }); + await forced.close(); + + await page.setViewportSize({ width: 1200, height: 900 }); + await page.emulateMedia({ media: 'print' }); + await page.pdf({ path: join(shots, `${concept}-print.pdf`), format: 'A4', printBackground: true }); + report.concepts[concept] = { viewports: matrix, seriousAxeViolations: 0, externalRequests: 0, reducedMotionElements: 0 }; + await context.close(); + } + } finally { await browser.close(); } + console.log(JSON.stringify(report, null, 2)); +} finally { + await new Promise(resolve => server.close(resolve)); +} diff --git a/publication/docs/adr/0001-separate-static-publication.md b/publication/docs/adr/0001-separate-static-publication.md new file mode 100644 index 0000000..993b0bf --- /dev/null +++ b/publication/docs/adr/0001-separate-static-publication.md @@ -0,0 +1,32 @@ +# ADR 0001: Separate static AgentSutra publication + +- Status: superseded by ADR 0003 +- Date: 2026-08-17 + +## Context + +AgentSutra currently includes a Python runtime, private node operations, a public-learning programme, and adjacent evidence from Claude Code Multipane. The publication needs its own release rhythm, privacy boundary, content schema, accessible visual system, and deployment lifecycle. + +Putting the website inside the Python runtime would couple unrelated toolchains and increase the chance that operational material leaks into public builds. Putting it inside Multipane would misrepresent Multipane as an AgentSutra subsystem. + +## Decision + +Create `agentsutra.dev` as a dedicated AgentSutra publication repository and canonical corpus. This placement was later superseded by ADR 0003 after the owner chose one AgentSutra repository with an isolated `publication/` workspace. + +Use: + +- Astro static output and strict TypeScript; +- build-time validated content and evidence records; +- semantic HTML, CSS and controlled SVG Thread diagrams; +- deterministic static social exports; +- Cloudflare Workers Static Assets without a Worker runtime or Astro server adapter; +- Git history as the initial editorial audit trail. + +Do not add a CMS, database, accounts, comments, runtime rendering, client application shell, analytics, automated social posting, or AI search during Foundation Sprint 1. + +## Consequences + +- The publication can deploy independently without changing Runtime or Multipane releases. +- Private evidence remains outside the public repository. +- A small amount of cross-repository linking is required, but claims remain bounded by public evidence records. +- If dynamic capabilities become necessary later, they require evidence and a new ADR. diff --git a/publication/docs/adr/0002-ml-sharp-research-boundary.md b/publication/docs/adr/0002-ml-sharp-research-boundary.md new file mode 100644 index 0000000..318c39d --- /dev/null +++ b/publication/docs/adr/0002-ml-sharp-research-boundary.md @@ -0,0 +1,57 @@ +# ADR 0002: Keep Apple SHARP outside the production publication + +- Status: accepted +- Date: 2026-08-17 + +## Context + +AgentSutra is an experimental public field lab. Apple's SHARP project is an interesting candidate for a future Lab Note because it predicts a 3D Gaussian representation from a single photograph and exposes useful questions about inferred geometry, hidden viewpoints, hardware paths, delivery cost, and accessibility. + +The published model-weight licence permits non-commercial scientific research and academic development and excludes product development and commercial products or services. The current project documentation also distinguishes prediction support through Apple hardware paths from a trajectory/video rendering workflow that requires CUDA. + +Those boundaries make SHARP suitable for a carefully isolated research proposal, not for the AgentSutra identity, homepage, production navigation, required learning content, or general asset pipeline. + +## Decision + +- Do not add `ml-sharp`, its weights, or generated outputs to the production website. +- Do not use SHARP to create the AgentSutra logo, brand texture, homepage background, or an asset required to understand a Field Note. +- Do not download weights in this sprint. +- Keep any future experiment in an isolated local research branch and route it under `/labs/` only after a separate rights and release review. +- Provide a complete static image and text alternative before any interactive 3D enhancement. +- Treat a Lab Note as an investigation of the system's limits, not a showcase of a visual effect. + +## Proposed bounded experiment + +An original photograph of a deliberately constructed Thread object could be used to ask: + +> What does a single-image 3D reconstruction invent when the unseen side matters? + +The experiment would record: + +- source-image rights and capture conditions; +- exact code, model, hardware, and environment versions; +- prediction and rendering paths used; +- geometry that survives a viewpoint change and geometry that collapses; +- output size, browser cost, and static fallback; +- the model-weight licence in force at the time of the run; +- a public boundary stating that plausible appearance is not measured geometric truth. + +## Release conditions + +No output may enter a public or career-facing surface until all of the following are true: + +1. the current upstream code and model licences have been reviewed for the intended use; +2. the source photograph and every published asset are rights-cleared; +3. a reproducible local record exists; +4. the experience has a useful non-WebGL fallback and visible text explanation; +5. performance and device support are measured; +6. publication does not imply that SHARP is an AgentSutra dependency or product feature. + +## Consequences + +AgentSutra can explore an ambitious visual system without inheriting a research-only model licence or making a fragile 3D demo part of the reader's critical path. The proposal remains available when it can teach a real transferable lesson. + +## Primary references + +- [Apple SHARP README](https://github.com/apple/ml-sharp/blob/main/README.md) +- [Apple SHARP model licence](https://github.com/apple/ml-sharp/blob/main/LICENSE_MODEL) diff --git a/publication/docs/adr/0003-agent-sutra-monorepo-publication-workspace.md b/publication/docs/adr/0003-agent-sutra-monorepo-publication-workspace.md new file mode 100644 index 0000000..411ba85 --- /dev/null +++ b/publication/docs/adr/0003-agent-sutra-monorepo-publication-workspace.md @@ -0,0 +1,37 @@ +# ADR 0003: AgentSutra monorepo with an isolated publication workspace + +- Status: accepted +- Date: 2026-08-17 +- Supersedes: ADR 0001 repository placement only + +## Context + +ADR 0001 placed AgentSutra.dev in a standalone repository to protect its privacy boundary, release rhythm and TypeScript toolchain from the Python runtime. The owner prefers one AgentSutra GitHub repository so the runtime and public learning system are discoverable as one body of work. + +Simply mixing the publication into the runtime root would weaken both systems: CI triggers would become ambiguous, dependencies would collide, generated output could be mistaken for runtime state, and a website release could accidentally imply a runtime release. + +## Decision + +Keep the existing Python runtime at the repository root and place the complete publication in `publication/`. + +The imported lineage was reviewed from standalone AgentSutra.dev snapshot `56b9069172cf1fdb2e3245f3b2324a7e12f5c947`. Generated outputs and third-party agent capabilities were excluded from the monorepo import. + +The workspace boundary is structural: + +- `publication/package.json` and `publication/package-lock.json` own the Node toolchain; +- `publication/AGENTS.md`, `publication/PRODUCT.md`, `publication/DESIGN.md`, and `publication/EDITORIAL.md` own publication decisions; +- `.github/workflows/publication-ci.yml` runs publication checks with `publication/` as its working directory; +- fixture, export and deployable build outputs remain isolated and ignored; +- Cloudflare configuration remains under `publication/` and deployment stays dry-run only; +- runtime evidence enters the publication only through reviewed public records or opaque private-evidence identifiers. + +AgentSutra Runtime and AgentSutra.dev may link to each other, but neither imports the other's dependencies, operational configuration, generated state, claims, or release status. + +## Consequences + +- GitHub presents one AgentSutra project with two clearly named products. +- Runtime and publication history can be reviewed in one place. +- Publication CI and Cloudflare packaging remain independently executable. +- Contributors must run runtime commands from the repository root and publication commands from `publication/`. +- A public-site release does not constitute a runtime release, and a runtime tag does not publish the website. +- Reversing this decision later remains possible by splitting `publication/` history with standard Git subtree tooling. diff --git a/publication/licenses/Recursive-OFL-1.1.txt b/publication/licenses/Recursive-OFL-1.1.txt new file mode 100644 index 0000000..d4361a9 --- /dev/null +++ b/publication/licenses/Recursive-OFL-1.1.txt @@ -0,0 +1,93 @@ +Copyright 2020 The Recursive Project Authors (https://github.com/arrowtype/recursive) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +http://scripts.sil.org/OFL + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/publication/package-lock.json b/publication/package-lock.json new file mode 100644 index 0000000..63225dc --- /dev/null +++ b/publication/package-lock.json @@ -0,0 +1,7593 @@ +{ + "name": "agentsutra.dev", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "agentsutra.dev", + "version": "0.1.0", + "dependencies": { + "@astrojs/rss": "4.0.19", + "@astrojs/sitemap": "3.7.3", + "astro": "7.2.2", + "yaml": "2.9.0" + }, + "devDependencies": { + "@astrojs/check": "0.9.10", + "@axe-core/playwright": "4.13.0", + "@playwright/test": "1.62.1", + "@types/node": "24.13.3", + "prettier": "3.9.6", + "prettier-plugin-astro": "0.14.1", + "sharp": "0.35.3", + "typescript": "6.0.3", + "vitest": "4.1.10", + "wrangler": "4.123.0" + }, + "engines": { + "node": "24.19.0", + "npm": "11.17.0" + } + }, + "node_modules/@astrojs/check": { + "version": "0.9.10", + "resolved": "https://registry.npmjs.org/@astrojs/check/-/check-0.9.10.tgz", + "integrity": "sha512-zgx/UQMozdjOa3bOxjgeCFdtpE3c9rRX6xHwa+2QXvy8z8Akifu2AtubHyv/zzC2znO8dl8fFWL4K+Ba9kS8HQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@astrojs/language-server": "^2.16.7", + "chokidar": "^4.0.3", + "kleur": "^4.1.5", + "yargs": "^18.0.0" + }, + "bin": { + "astro-check": "bin/astro-check.js" + }, + "peerDependencies": { + "typescript": "^5.0.0 || ^6.0.0" + } + }, + "node_modules/@astrojs/compiler": { + "version": "2.13.1", + "resolved": "https://registry.npmjs.org/@astrojs/compiler/-/compiler-2.13.1.tgz", + "integrity": "sha512-f3FN83d2G/v32ipNClRKgYv30onQlMZX1vCeZMjPsMMPl1mDpmbl0+N5BYo4S/ofzqJyS5hvwacEo0CCVDn/Qg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@astrojs/compiler-binding": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding/-/compiler-binding-0.3.2.tgz", + "integrity": "sha512-8w/9CWmYrAJJ8N0SY3O43ws2BgxoW6u3QsD8u2mE140lMYAlwh+tlNoUeSBq22wVheFuiBbR212l6ixZ2IIgCQ==", + "license": "MIT", + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "optionalDependencies": { + "@astrojs/compiler-binding-darwin-arm64": "0.3.2", + "@astrojs/compiler-binding-darwin-x64": "0.3.2", + "@astrojs/compiler-binding-linux-arm64-gnu": "0.3.2", + "@astrojs/compiler-binding-linux-arm64-musl": "0.3.2", + "@astrojs/compiler-binding-linux-x64-gnu": "0.3.2", + "@astrojs/compiler-binding-linux-x64-musl": "0.3.2", + "@astrojs/compiler-binding-wasm32-wasi": "0.3.2", + "@astrojs/compiler-binding-win32-arm64-msvc": "0.3.2", + "@astrojs/compiler-binding-win32-x64-msvc": "0.3.2" + } + }, + "node_modules/@astrojs/compiler-binding-darwin-arm64": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-darwin-arm64/-/compiler-binding-darwin-arm64-0.3.2.tgz", + "integrity": "sha512-MM8tn8CSimcfytaOla4b6acN8mKWiL/rlAA1fpT3/Wl7dNGSE4y8FjTN/zJVNnb63CsLWG5zZwCt01TXtDKh9g==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-binding-darwin-x64": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-darwin-x64/-/compiler-binding-darwin-x64-0.3.2.tgz", + "integrity": "sha512-2lXOlzf8xb7jLomRsf/aswh61/NnGusynB2OwFkK6k4pmOtpfXMYnG0PLfXrEvxXYj69NdCnmUYXtHDd+JOOag==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-binding-linux-arm64-gnu": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-arm64-gnu/-/compiler-binding-linux-arm64-gnu-0.3.2.tgz", + "integrity": "sha512-BmU3kWj7qnLrd4vzm49zFEPJ5oFnn1tCT4Vt9hZbqdU5Cmb8GZl7fn6VFsnNfe7B18a2gIFtVzbLINtYl5kBjQ==", + "cpu": [ + "arm64" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-binding-linux-arm64-musl": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-arm64-musl/-/compiler-binding-linux-arm64-musl-0.3.2.tgz", + "integrity": "sha512-f0heT9ZZEseSu5bHCeb80eL2DH07ArE6U9xi1WT/PEusNjzPmEr3GJsjG1tRLo5VYUUYX7h3ScaqGmGrMOVGmw==", + "cpu": [ + "arm64" + ], + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-binding-linux-x64-gnu": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-x64-gnu/-/compiler-binding-linux-x64-gnu-0.3.2.tgz", + "integrity": "sha512-M8fOUt0itRpqiGyoEA/ij184s8O+hqbCz3+YozRusOOM3osgGljpDThhbKAJjqh82wOo6FioQ4w8PBvU1XMD5Q==", + "cpu": [ + "x64" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-binding-linux-x64-musl": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-linux-x64-musl/-/compiler-binding-linux-x64-musl-0.3.2.tgz", + "integrity": "sha512-/Kebk8sO6HnLeSd691JkaAPfN7CqR9/KEXmWvyNPkaKNGmj8rTZ/lf2uXtnPu92Lan84UrKdIKVPy1fSo2encQ==", + "cpu": [ + "x64" + ], + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-binding-wasm32-wasi": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-wasm32-wasi/-/compiler-binding-wasm32-wasi-0.3.2.tgz", + "integrity": "sha512-pUA6xbcOSB7DhfzIArB8BCAkFfAIqriiR7zl5zOStd6oU2G0kIKj+GUdGnyXyhfiv881Hffyk5tC0mR18sDjDw==", + "cpu": [ + "wasm32" + ], + "license": "MIT", + "optional": true, + "dependencies": { + "@napi-rs/wasm-runtime": "^1.2.0" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@astrojs/compiler-binding-win32-arm64-msvc": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-win32-arm64-msvc/-/compiler-binding-win32-arm64-msvc-0.3.2.tgz", + "integrity": "sha512-ESruf+6Qkl1trHUFxI6GSf6t52j8yN2kCNSzMWdzt7V/T09tFHrYzrVaJQohb2C9bJUH76pNvX6Zb51+xCQc9Q==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-binding-win32-x64-msvc": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-binding-win32-x64-msvc/-/compiler-binding-win32-x64-msvc-0.3.2.tgz", + "integrity": "sha512-wzzVrEbOwbsLWOdEbocskjMRx2aZPxJ7ZbmL+jnpBamFwmigm+2M/wzuM6JWncocgYwLic1csSpalBh96kQKXA==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@astrojs/compiler-rs": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/@astrojs/compiler-rs/-/compiler-rs-0.3.2.tgz", + "integrity": "sha512-xlx/T7JovIKduu4ucbTQUxQ5+Q8wxkHxhLjnZk3VlJbhbQ9RLvvuDk1p2YYFYFQ5y14dVm3FGGO4isQXa4F+Tg==", + "license": "MIT", + "dependencies": { + "@astrojs/compiler-binding": "0.3.2" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@astrojs/internal-helpers": { + "version": "0.10.2", + "resolved": "https://registry.npmjs.org/@astrojs/internal-helpers/-/internal-helpers-0.10.2.tgz", + "integrity": "sha512-yt7fMgPYqSM4Tmr+taTW6Per+hjJ8Pk6lA1PAcDyqzOt8HzJ6Kje5WzCxA2Sd+9wsUW7uhkLeoTMK0cXPwH9rQ==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.4", + "@types/mdast": "^4.0.4", + "js-yaml": "^4.3.0", + "picomatch": "^4.0.4", + "retext-smartypants": "^6.2.0", + "shiki": "^4.0.2", + "smol-toml": "^1.6.0", + "unified": "^11.0.5" + } + }, + "node_modules/@astrojs/language-server": { + "version": "2.16.14", + "resolved": "https://registry.npmjs.org/@astrojs/language-server/-/language-server-2.16.14.tgz", + "integrity": "sha512-YPXkBu6N4d1sT09pvBmIDGZay+1MemV551FSgdEM3aZRDzbkxd2H7Cvf8MsVJLVB1mIEyTf1XbMN/30gp7s46w==", + "dev": true, + "license": "MIT", + "dependencies": { + "@astrojs/compiler": "^2.13.1", + "@astrojs/yaml2ts": "^0.2.4", + "@jridgewell/sourcemap-codec": "^1.5.5", + "@volar/kit": "~2.4.28", + "@volar/language-core": "~2.4.28", + "@volar/language-server": "~2.4.28", + "@volar/language-service": "~2.4.28", + "muggle-string": "^0.4.1", + "tinyglobby": "^0.2.16", + "volar-service-css": "0.0.71", + "volar-service-emmet": "0.0.71", + "volar-service-html": "0.0.71", + "volar-service-prettier": "0.0.71", + "volar-service-typescript": "0.0.71", + "volar-service-typescript-twoslash-queries": "0.0.71", + "volar-service-yaml": "0.0.71", + "vscode-html-languageservice": "^5.6.2", + "vscode-uri": "^3.1.0" + }, + "bin": { + "astro-ls": "bin/nodeServer.js" + }, + "peerDependencies": { + "prettier": "^3.0.0", + "prettier-plugin-astro": ">=0.11.0" + }, + "peerDependenciesMeta": { + "prettier": { + "optional": true + }, + "prettier-plugin-astro": { + "optional": true + } + } + }, + "node_modules/@astrojs/markdown-satteri": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/@astrojs/markdown-satteri/-/markdown-satteri-0.3.5.tgz", + "integrity": "sha512-CvWVEFAbay7YO+i9SaqDJubipA5ckiVB89QWoMJ5XC0m5CtFg8JwZ7Kau6X9sYY7FZURH0w2l03ISH2jOS/RDQ==", + "license": "MIT", + "dependencies": { + "@astrojs/internal-helpers": "0.10.2", + "@astrojs/prism": "4.0.2", + "github-slugger": "^2.0.0", + "hast-util-from-html": "^2.0.3", + "satteri": "^0.9.1" + } + }, + "node_modules/@astrojs/prism": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/@astrojs/prism/-/prism-4.0.2.tgz", + "integrity": "sha512-KTivpmnz6lDsC6o9H4+DNm2SrE/GHzw8cNAvEJwAvUT+eoaEnn/4NtbDNfRRaxaJHdp15gf+tfHAWiXR4wB3BA==", + "license": "MIT", + "dependencies": { + "prismjs": "^1.30.0" + }, + "engines": { + "node": ">=22.12.0" + } + }, + "node_modules/@astrojs/rss": { + "version": "4.0.19", + "resolved": "https://registry.npmjs.org/@astrojs/rss/-/rss-4.0.19.tgz", + "integrity": "sha512-e+z5wYeYtffQdHQO8c2tkSd2JEBdAuRXJV4ZEU5IxkYeE6e39woDd7nw1PH1Kk2tEYNCYuKdylnnbhGmt61awA==", + "license": "MIT", + "dependencies": { + "fast-xml-parser": "^5.5.7", + "piccolore": "^0.1.3", + "zod": "^4.3.6" + } + }, + "node_modules/@astrojs/sitemap": { + "version": "3.7.3", + "resolved": "https://registry.npmjs.org/@astrojs/sitemap/-/sitemap-3.7.3.tgz", + "integrity": "sha512-f8euLVsyeAmAkSm/1M2Kb8sL8byQmfgbvBNaHFItCheTj/IpiJYSEWVcqDHZ/yEHxiS7+w87mQkzwZaPHmk5GA==", + "license": "MIT", + "dependencies": { + "sitemap": "^9.0.0", + "stream-replace-string": "^2.0.0", + "zod": "^4.3.6" + } + }, + "node_modules/@astrojs/telemetry": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/@astrojs/telemetry/-/telemetry-3.3.3.tgz", + "integrity": "sha512-C1TLn5sPJr0x4vk56piHWKbnqlEB8BKyte5Y45V02U+D7BGO5eMqZDH5aPjnkXQWJggvmsTXxH03QMZ9NgWLzQ==", + "license": "MIT", + "dependencies": { + "ci-info": "^4.4.0", + "dset": "^3.1.4", + "is-docker": "^4.0.0", + "package-manager-detector": "^1.6.0" + }, + "engines": { + "node": "18.20.8 || ^20.3.0 || >=22.0.0" + } + }, + "node_modules/@astrojs/yaml2ts": { + "version": "0.2.4", + "resolved": "https://registry.npmjs.org/@astrojs/yaml2ts/-/yaml2ts-0.2.4.tgz", + "integrity": "sha512-8oddpOae35pJsXPQXhTkM0ypfKPskVsh2bCxRtbf7e+/Epw2nReakFYpLKjZMEr75CsoF203PMnCocpfz0s69A==", + "dev": true, + "license": "MIT", + "dependencies": { + "yaml": "^2.8.3" + } + }, + "node_modules/@axe-core/playwright": { + "version": "4.13.0", + "resolved": "https://registry.npmjs.org/@axe-core/playwright/-/playwright-4.13.0.tgz", + "integrity": "sha512-6YLx+kxXu5GJceG4ozFg+33a2EMTdjYwWGloJ3sb9Kta5pp+ZNS53uxGVog5JetIY8s++P5UrtX+cri+u0VAVg==", + "dev": true, + "license": "MPL-2.0", + "dependencies": { + "axe-core": "~4.13.0" + }, + "peerDependencies": { + "playwright-core": ">= 1.0.0" + } + }, + "node_modules/@babel/helper-string-parser": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz", + "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/helper-validator-identifier": { + "version": "7.29.7", + "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz", + "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==", + "license": "MIT", + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@babel/parser": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.8.tgz", + "integrity": "sha512-E8lTAYNB1KW+FH+VGJuZM1ioAx2E6oVlvQFRrf5P8ZZmsiJXYAD9vTFV7yyEURNzgh1dFqMZuO6tUwcARbqFCA==", + "license": "MIT", + "dependencies": { + "@babel/types": "^7.29.8" + }, + "bin": { + "parser": "bin/babel-parser.js" + }, + "engines": { + "node": ">=6.0.0" + } + }, + "node_modules/@babel/types": { + "version": "7.29.8", + "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.8.tgz", + "integrity": "sha512-Vj1jF3cPfxg7OAfoI7QnVKLoILlm2JF9pnVHrX8qx7AHMiYWT+NDAA7jChlNgRS4WTLc/fD1lXLmPixluj+3Gg==", + "license": "MIT", + "dependencies": { + "@babel/helper-string-parser": "^7.29.7", + "@babel/helper-validator-identifier": "^7.29.7" + }, + "engines": { + "node": ">=6.9.0" + } + }, + "node_modules/@bruits/satteri-darwin-arm64": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-darwin-arm64/-/satteri-darwin-arm64-0.9.5.tgz", + "integrity": "sha512-iw4nZgx9v30lWo/MTngQqi1pI78KI0DnkSm+lVJGYdmPLgAyDNJigVhpG42/Iq55A6c1Ll8q66ljyyRiQUxwow==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@bruits/satteri-darwin-x64": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-darwin-x64/-/satteri-darwin-x64-0.9.5.tgz", + "integrity": "sha512-6T26Z5Kf3cFW2PSlk9p7zT7yVxvuBSiJvYyz9u8KjYwMTqZyIDOj2wDyNpxKV4+6yUVG7rddq2QwvG/8LJA2+Q==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@bruits/satteri-linux-arm64-gnu": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-arm64-gnu/-/satteri-linux-arm64-gnu-0.9.5.tgz", + "integrity": "sha512-u51id17uJwNEMK9nBlICsq6U31c+XVqQueVBkwRIzZG+gMpS8TOJctt5h5Wz33Z8xnMdTd+adtACVz0yHgGuOA==", + "cpu": [ + "arm64" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@bruits/satteri-linux-arm64-musl": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-arm64-musl/-/satteri-linux-arm64-musl-0.9.5.tgz", + "integrity": "sha512-v39HxiwGC5Rqm01HksP6+5Y+xKLPlsuVFgIgpEAo+SiQ22c+mJVhS3u7Z6ePAKdhL5NJoK1xq70kLz3L13AhpQ==", + "cpu": [ + "arm64" + ], + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@bruits/satteri-linux-x64-gnu": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-x64-gnu/-/satteri-linux-x64-gnu-0.9.5.tgz", + "integrity": "sha512-F3uO8uFp3pAP5ZGXttwvh57GS7s0lL953tnNdyI2gRyP4kOOkp6pyGojNJzCjkDvWI2Cvb9iNrKok3aqQPauAw==", + "cpu": [ + "x64" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@bruits/satteri-linux-x64-musl": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-linux-x64-musl/-/satteri-linux-x64-musl-0.9.5.tgz", + "integrity": "sha512-bicEqglLlz++mWyADaZoP0JY20s4vDfLjaPYgQqC+NI4zZLTOOg1T4GB8aqtc822Pqji8SQBmSrTb7CrP8i08Q==", + "cpu": [ + "x64" + ], + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@bruits/satteri-wasm32-wasi": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-wasm32-wasi/-/satteri-wasm32-wasi-0.9.5.tgz", + "integrity": "sha512-zauAuMwfPnKPUkd4AFixRFpXdgKwP2mKgxrIIo2gJzW0/ZneF9dbHnLkojSpaBnCCp7VUL1hIi5WWZvB1CqmAQ==", + "cpu": [ + "wasm32" + ], + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/core": "1.11.1", + "@emnapi/runtime": "1.11.1", + "@napi-rs/wasm-runtime": "^1.1.6" + }, + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/@bruits/satteri-wasm32-wasi/node_modules/@emnapi/core": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.1.tgz", + "integrity": "sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==", + "license": "MIT", + "optional": true, + "dependencies": { + "@emnapi/wasi-threads": "1.2.2", + "tslib": "^2.4.0" + } + }, + "node_modules/@bruits/satteri-wasm32-wasi/node_modules/@emnapi/runtime": { + "version": "1.11.1", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.1.tgz", + "integrity": "sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==", + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@bruits/satteri-wasm32-wasi/node_modules/@emnapi/wasi-threads": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.2.tgz", + "integrity": "sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==", + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@bruits/satteri-win32-arm64-msvc": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-win32-arm64-msvc/-/satteri-win32-arm64-msvc-0.9.5.tgz", + "integrity": "sha512-SrfE7NEsgZjBvU3c+RR6oQRu0ToXY5uVJEbieXEF0YTctIV2zAVlbaMjWLts074QCgh3a+XHWkR/lWh2VH2LUg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@bruits/satteri-win32-x64-msvc": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/@bruits/satteri-win32-x64-msvc/-/satteri-win32-x64-msvc-0.9.5.tgz", + "integrity": "sha512-5Kw9ZAtTGS8WHizyn+CJhjjfIQrw+7jcZodpmpXJjefnO15M8UexIi6JR2E5thyvsmHyhL6ZDDMUNR4bKJPd4g==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@capsizecss/unpack": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/@capsizecss/unpack/-/unpack-4.0.1.tgz", + "integrity": "sha512-CuNiSqg7+e1cO/GjffyMOm5Tt2jUF9CWHHnvQ/UkqvtkGfHdgwEC0wpmq7fkN3gxwpRnrAN0WzO3vREKmNolMQ==", + "license": "MIT", + "dependencies": { + "fontkitten": "^1.0.3" + }, + "engines": { + "node": ">=18" + } + }, + "node_modules/@clack/core": { + "version": "1.4.3", + "resolved": "https://registry.npmjs.org/@clack/core/-/core-1.4.3.tgz", + "integrity": "sha512-/kr3UWNtdJfxZtPgDqUOmG2pvwlmcLGheex5yiZKdwbzZJxhV+HMNR9QNmyY5cGwTNV6LrR7Jtp+KjhUAP1qBQ==", + "license": "MIT", + "dependencies": { + "fast-wrap-ansi": "^0.2.0", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 20.12.0" + } + }, + "node_modules/@clack/prompts": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/@clack/prompts/-/prompts-1.7.0.tgz", + "integrity": "sha512-y7/yvZ2TPAnR9+jnc00klvNNLkJiXFFrQA/hlLCcxA9a2A4zQIOimyFQ9XfwYKiGD1fb5GY8vbKIIgO8d5Tb2A==", + "license": "MIT", + "dependencies": { + "@clack/core": "1.4.3", + "fast-string-width": "^3.0.2", + "fast-wrap-ansi": "^0.2.0", + "sisteransi": "^1.0.5" + }, + "engines": { + "node": ">= 20.12.0" + } + }, + "node_modules/@cloudflare/kv-asset-handler": { + "version": "0.5.0", + "resolved": "https://registry.npmjs.org/@cloudflare/kv-asset-handler/-/kv-asset-handler-0.5.0.tgz", + "integrity": "sha512-jxQYkj8dSIzc0cD6cMMNdOc1UVjqSqu8BZdor5s8cGjW2I8BjODt/kWPVdY+u9zj3ms75Q5qaZgnxUad83+eAg==", + "dev": true, + "license": "MIT OR Apache-2.0", + "engines": { + "node": ">=22.0.0" + } + }, + "node_modules/@cloudflare/unenv-preset": { + "version": "2.16.1", + "resolved": "https://registry.npmjs.org/@cloudflare/unenv-preset/-/unenv-preset-2.16.1.tgz", + "integrity": "sha512-ECxObrMfyTl5bhQf/lZCXwo5G6xX9IAUo+nDMKK4SZ8m4Jvvxp52vilxyySSWh2YTZz8+HQ07qGH/2rEom1vDw==", + "dev": true, + "license": "MIT OR Apache-2.0", + "peerDependencies": { + "unenv": "2.0.0-rc.24", + "workerd": ">1.20260305.0 <2.0.0-0" + }, + "peerDependenciesMeta": { + "workerd": { + "optional": true + } + } + }, + "node_modules/@cloudflare/workerd-darwin-64": { + "version": "1.20260811.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-64/-/workerd-darwin-64-1.20260811.1.tgz", + "integrity": "sha512-i5jqz+ywtOefr0AJbiAc8qxBLfSim/B0WJG7aW3B+pWnoVfMJdUQvi+BWcFKZJ0MoCci3KadTx6g31VfuEEqpQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-darwin-arm64": { + "version": "1.20260811.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-darwin-arm64/-/workerd-darwin-arm64-1.20260811.1.tgz", + "integrity": "sha512-NoOUM/nvaDdm2Onlnz33FikWjtatzulNtvwvy4xs0IrHaTCHwC0c8NwIt6s+AI13FkDs02/vm2I3GTPLCT9+hQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-linux-64": { + "version": "1.20260811.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-64/-/workerd-linux-64-1.20260811.1.tgz", + "integrity": "sha512-sdYq2jL1AD1supa3fsi5O4zTB28wSjvTHj7Migh6/ts8EROPdvrSwv+rdGHhv8HJNAz/wbIAY3wZsi1Rw4uUIg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-linux-arm64": { + "version": "1.20260811.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-linux-arm64/-/workerd-linux-arm64-1.20260811.1.tgz", + "integrity": "sha512-RIRv4shbu1kg05sD+DHTpSFCNnb5Dl2SkPDMUykqZa508tkPqe7VVw7gO0Q5msTBGyL0FfFrLuRxwwfA8u5Sow==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=16" + } + }, + "node_modules/@cloudflare/workerd-windows-64": { + "version": "1.20260811.1", + "resolved": "https://registry.npmjs.org/@cloudflare/workerd-windows-64/-/workerd-windows-64-1.20260811.1.tgz", + "integrity": "sha512-g6VquwjASlYAibcNW/0E6Zszht4qLkmnXOGwIjjRHl2A0Qz48kVeMcGvyH6eA0G9U3OzZojjYFpP+YeyQmmdjw==", + "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/@emmetio/abbreviation": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/@emmetio/abbreviation/-/abbreviation-2.3.3.tgz", + "integrity": "sha512-mgv58UrU3rh4YgbE/TzgLQwJ3pFsHHhCLqY20aJq+9comytTXUDNGG/SMtSeMJdkpxgXSXunBGLD8Boka3JyVA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@emmetio/scanner": "^1.0.4" + } + }, + "node_modules/@emmetio/css-abbreviation": { + "version": "2.1.8", + "resolved": "https://registry.npmjs.org/@emmetio/css-abbreviation/-/css-abbreviation-2.1.8.tgz", + "integrity": "sha512-s9yjhJ6saOO/uk1V74eifykk2CBYi01STTK3WlXWGOepyKa23ymJ053+DNQjpFcy1ingpaO7AxCcwLvHFY9tuw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@emmetio/scanner": "^1.0.4" + } + }, + "node_modules/@emmetio/css-parser": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@emmetio/css-parser/-/css-parser-0.4.1.tgz", + "integrity": "sha512-2bC6m0MV/voF4CTZiAbG5MWKbq5EBmDPKu9Sb7s7nVcEzNQlrZP6mFFFlIaISM8X6514H9shWMme1fCm8cWAfQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@emmetio/stream-reader": "^2.2.0", + "@emmetio/stream-reader-utils": "^0.1.0" + } + }, + "node_modules/@emmetio/html-matcher": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/@emmetio/html-matcher/-/html-matcher-1.3.0.tgz", + "integrity": "sha512-NTbsvppE5eVyBMuyGfVu2CRrLvo7J4YHb6t9sBFLyY03WYhXET37qA4zOYUjBWFCRHO7pS1B9khERtY0f5JXPQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "@emmetio/scanner": "^1.0.0" + } + }, + "node_modules/@emmetio/scanner": { + "version": "1.0.4", + "resolved": "https://registry.npmjs.org/@emmetio/scanner/-/scanner-1.0.4.tgz", + "integrity": "sha512-IqRuJtQff7YHHBk4G8YZ45uB9BaAGcwQeVzgj/zj8/UdOhtQpEIupUhSk8dys6spFIWVZVeK20CzGEnqR5SbqA==", + "dev": true, + "license": "MIT" + }, + "node_modules/@emmetio/stream-reader": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/@emmetio/stream-reader/-/stream-reader-2.2.0.tgz", + "integrity": "sha512-fXVXEyFA5Yv3M3n8sUGT7+fvecGrZP4k6FnWWMSZVQf69kAq0LLpaBQLGcPR30m3zMmKYhECP4k/ZkzvhEW5kw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@emmetio/stream-reader-utils": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/@emmetio/stream-reader-utils/-/stream-reader-utils-0.1.0.tgz", + "integrity": "sha512-ZsZ2I9Vzso3Ho/pjZFsmmZ++FWeEd/txqybHTm4OgaZzdS8V9V/YYWQwg5TC38Z7uLWUV1vavpLLbjJtKubR1A==", + "dev": true, + "license": "MIT" + }, + "node_modules/@emnapi/core": { + "version": "1.11.3", + "resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.3.tgz", + "integrity": "sha512-zLpS5asjEb7lq8jYLq37N6XKaE41DIexlY1rF/z4/tIl3wo13Sqm28fRyfIsKZD+NZ8mM5RoKkpW/rBcuoSZSg==", + "license": "MIT", + "optional": true, + "peer": true, + "dependencies": { + "@emnapi/wasi-threads": "1.2.3", + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/runtime": { + "version": "1.11.3", + "resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.3.tgz", + "integrity": "sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==", + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@emnapi/wasi-threads": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/@emnapi/wasi-threads/-/wasi-threads-1.2.3.tgz", + "integrity": "sha512-ELEBe8PsLvvJ6QMr0zLt8ffvOHW/dc1m3CEzNMg7aJUv3bMaoDtw2TXyDAwkYBuroxxuHEwhRTLJSe5sya547g==", + "license": "MIT", + "optional": true, + "peer": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz", + "integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz", + "integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz", + "integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz", + "integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz", + "integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz", + "integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz", + "integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz", + "integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz", + "integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz", + "integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz", + "integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz", + "integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==", + "cpu": [ + "loong64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz", + "integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==", + "cpu": [ + "mips64el" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz", + "integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==", + "cpu": [ + "ppc64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz", + "integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==", + "cpu": [ + "riscv64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz", + "integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==", + "cpu": [ + "s390x" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz", + "integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz", + "integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz", + "integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz", + "integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz", + "integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz", + "integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz", + "integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz", + "integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz", + "integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==", + "cpu": [ + "ia32" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz", + "integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "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==", + "devOptional": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/@img/sharp-darwin-arm64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.35.3.tgz", + "integrity": "sha512-RMnFX7YQsMoh7lWfcM4NEHHymBX/rLuKNPVM84XE9ONPcaSCDgE7CHIHpSgPcO2xcRthgBy1HfNO319mwhIAkg==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-arm64": "1.3.2" + } + }, + "node_modules/@img/sharp-darwin-x64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.35.3.tgz", + "integrity": "sha512-Xo+5uFBtLN0BKqieTxiFzFPQAUlBbbH5iBKyRX/z1JrbnYsHTfKJnUfL8+p2TPXr1pXqao4eeL4Rl144uDpK9w==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-x64": "1.3.2" + } + }, + "node_modules/@img/sharp-freebsd-wasm32": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-freebsd-wasm32/-/sharp-freebsd-wasm32-0.35.3.tgz", + "integrity": "sha512-lUxcqWIj2wMQ9BrwNjngcr1gWUr5xgaGThBRqPPalIC2n67Cqj1uPh8NnA/ZhAg8hUbKl+kVHKwgUIwe6ZYPrg==", + "license": "Apache-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "dependencies": { + "@img/sharp-wasm32": "0.35.3" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-libvips-darwin-arm64": { + "version": "1.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.3.2.tgz", + "integrity": "sha512-9J6ypZFpQBj4YnePGoq/S38w6nz+vqg5WZLrLGY4YuSemdMq47GMLBPO42MzwdGwpg/agZ7xzZcFHa48xlywfg==", + "cpu": [ + "arm64" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.3.2.tgz", + "integrity": "sha512-m2pW1n6cns9VaubNwsZ+c3CRYjxNQWgJ5gPlnL1nbBcpkBvFm6SCFN5o0psFHI8w9n11NKhFkeEDns98tiqbEw==", + "cpu": [ + "x64" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.3.2.tgz", + "integrity": "sha512-1eMLzy92I4J6rmi4mAT8yC3HxOtniyGELlzGbNMLLeqe052ahFQ0h6LFq+lh5DsDIdYViIDst08abvSbcEdLXQ==", + "cpu": [ + "arm" + ], + "libc": [ + "glibc" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.3.2.tgz", + "integrity": "sha512-dqVSFynCox4C/J8kT16V7SIFAns0IjgLwkvYT7p8LQVmJ5OS5b6tI9IGflxTeuBS//zXeFIUbwt5dwxyZ17cnA==", + "cpu": [ + "arm64" + ], + "libc": [ + "glibc" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.3.2.tgz", + "integrity": "sha512-3z0NHDxD6n5I9gc05U1eW1AyRm+Gznzq3naMrthPNqE6oYykcogW0l/jfpJdjYnuNl8R7yI9pNbE1XiUeyq0Aw==", + "cpu": [ + "ppc64" + ], + "libc": [ + "glibc" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.3.2.tgz", + "integrity": "sha512-bsb4rI+NldGOsXuej2r8OdSS8+zXDVaCWxyWrcv6kneTOlgAHtZABRzBBCwdsPiD90J4myNJuHpg6kA20ImW/w==", + "cpu": [ + "riscv64" + ], + "libc": [ + "glibc" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.3.2.tgz", + "integrity": "sha512-/ABshyj8gCpyIrNXnHn4LorDJ0HHm1VhXPBlxZ8zAtfVPAaSafXPGn+sUSIRiwaSBy0mmFjSjiXI5mkcwdChKQ==", + "cpu": [ + "s390x" + ], + "libc": [ + "glibc" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.3.2.tgz", + "integrity": "sha512-ITPEtgffGJ0S6G9dRyw/366tJQqFRcHWPHhC+Stpg3Z8AEMrDrTr2lhdz4f/Y/HMbRh//7Z5mBzEpVdi62Oc3w==", + "cpu": [ + "x64" + ], + "libc": [ + "glibc" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.3.2.tgz", + "integrity": "sha512-zE9EdiUzUmg5mDT5a1rk5fYJ6GWPloTwWBYDS14naqHsL+EaMpDj1AWnpLgh3u0YCORv2Tt50wrcrpYqkP97Kw==", + "cpu": [ + "arm64" + ], + "libc": [ + "musl" + ], + "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.3.2", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.3.2.tgz", + "integrity": "sha512-m0lrLiUt+lBYnCFr8qV/65yMR4E/c7/wf78I5eKTdkEakFAlZ9QlzEM3QIhhAwVeUhLAHLcCq7a7Vszq/oFNZQ==", + "cpu": [ + "x64" + ], + "libc": [ + "musl" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-linux-arm": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.35.3.tgz", + "integrity": "sha512-affVWCTLooy8TSxbDx2qkzuDeaWLNVBA+P//FNBirHsXpP2fuBhk5AuboYUnrDnzoXes8GFjpTx0SBFOCRg+FA==", + "cpu": [ + "arm" + ], + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm": "1.3.2" + } + }, + "node_modules/@img/sharp-linux-arm64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.35.3.tgz", + "integrity": "sha512-QgKDspHPnrU+GQ55XPhGwyhC8acLVOOSyAvo1oVfFmrIXLkDNmGWzAfDZ4xK8oSA1qBQrALcHX0G5UZni/SuFQ==", + "cpu": [ + "arm64" + ], + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm64": "1.3.2" + } + }, + "node_modules/@img/sharp-linux-ppc64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.35.3.tgz", + "integrity": "sha512-sMd8rDxmpLOwv/7N44klFjOD5DUO7FLdjiXDI0hoxYaf7Ar262dQIEkosE98bps+5HPLtp/EvNqeqQtOycP/IA==", + "cpu": [ + "ppc64" + ], + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-ppc64": "1.3.2" + } + }, + "node_modules/@img/sharp-linux-riscv64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.35.3.tgz", + "integrity": "sha512-0Eob78yjlYPfL5vMNWAW55l3R9Y6BQS/gOfe0ZcP9mEz9ohhKSt4im1hayiknXgf8AWrFqMvJcKIdmLmEe7yeQ==", + "cpu": [ + "riscv64" + ], + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-riscv64": "1.3.2" + } + }, + "node_modules/@img/sharp-linux-s390x": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.35.3.tgz", + "integrity": "sha512-KgAxQ0DxpNOq1rG2t5cgTgShJFGSuU7XO45cqC+1NVOuZnP6tlgZRuSYOfNupGkHID0o3cJOsw4DVeJpMovcGw==", + "cpu": [ + "s390x" + ], + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-s390x": "1.3.2" + } + }, + "node_modules/@img/sharp-linux-x64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.35.3.tgz", + "integrity": "sha512-8pqvxubL2PGdhlPy6GLqzDYMUjyRmKAwKHYKixpdJYBUK7PJ0C029XdsnpFIdgRZG68fZiGdHVWcKPvtiPB4cA==", + "cpu": [ + "x64" + ], + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-x64": "1.3.2" + } + }, + "node_modules/@img/sharp-linuxmusl-arm64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.35.3.tgz", + "integrity": "sha512-Vz0iQjzzcSX3HCbfwFfCSG/9SCIqyO0mH2sXyiHaAYfBk0cRsCWXRyQYX0ovCK/PAQBbTzQ0dsPQHh5MAFL59w==", + "cpu": [ + "arm64" + ], + "libc": [ + "musl" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-arm64": "1.3.2" + } + }, + "node_modules/@img/sharp-linuxmusl-x64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.35.3.tgz", + "integrity": "sha512-6O1NPKcDVj9QEdg7Hx549EX8U0rp6yXQERqru6yRN7fGBn32UvIRJUlWnk+8xDCiG76hXVBbX82NZ/ZKr0euIg==", + "cpu": [ + "x64" + ], + "libc": [ + "musl" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-x64": "1.3.2" + } + }, + "node_modules/@img/sharp-wasm32": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.35.3.tgz", + "integrity": "sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w==", + "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT", + "optional": true, + "dependencies": { + "@emnapi/runtime": "^1.11.1" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-webcontainers-wasm32": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-webcontainers-wasm32/-/sharp-webcontainers-wasm32-0.35.3.tgz", + "integrity": "sha512-2rnq7bX3NzeR2T4YWgz8qiG4h3TSdMe+vN1iQXpJleSJ3SM5zQ8Fy2SyyXAWlbxpEZ2Y+Z4u1BePgJEYbSy80Q==", + "cpu": [ + "wasm32" + ], + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@img/sharp-wasm32": "0.35.3" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-arm64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.35.3.tgz", + "integrity": "sha512-4bPwFdMbeC4JQ8L8LOyWp6nsHcboP5fxkp6iPOXz2Vg49R42TuMs2whkJ5OAP4/Ul035qOzy0AecOF9VOscn4w==", + "cpu": [ + "arm64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-ia32": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.35.3.tgz", + "integrity": "sha512-r53mXsBN6lFUDiST764SvgwUdHAqM4rPAiDzAmf4fLoB6X/rkfyTrLCg6+g17wJJiCmB3JYgHuUldCWUIRFSXw==", + "cpu": [ + "ia32" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/@img/sharp-win32-x64": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.35.3.tgz", + "integrity": "sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA==", + "cpu": [ + "x64" + ], + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=20.9.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==", + "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/@napi-rs/wasm-runtime": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.2.3.tgz", + "integrity": "sha512-UMduMbqO5s5zF2NkNacMT/yK5Y5QiKvWr2+50bzIIxFDwVJ2h49b+oyjaCGPhJxd2/gC2x39EHv/gHVuu36x2Q==", + "license": "MIT", + "optional": true, + "dependencies": { + "@tybys/wasm-util": "^0.10.3" + }, + "engines": { + "node": "^20.19.0 || ^22.13.0 || >=23.5.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/Brooooooklyn" + }, + "peerDependencies": { + "@emnapi/core": "^1.7.1 || ^2.0.0-alpha.4", + "@emnapi/runtime": "^1.7.1 || ^2.0.0-alpha.4" + } + }, + "node_modules/@nodable/entities": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/@nodable/entities/-/entities-3.0.0.tgz", + "integrity": "sha512-8L9xFeTYKhm49xfIypoe2W5wV1m/3Z58kT+7kR9A8OyFxcPduI4VmxaUMQyKYrRjUoLLSXv6EKKID5Tvj9cUVw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/nodable" + } + ], + "license": "MIT" + }, + "node_modules/@oslojs/encoding": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@oslojs/encoding/-/encoding-1.1.0.tgz", + "integrity": "sha512-70wQhgYmndg4GCPxPPxPGevRKqTIJ2Nh4OkiMWmDAVYsTQ+Ta7Sq+rPevXyXGdzr30/qZBnyOalCszoMxlyldQ==", + "license": "MIT" + }, + "node_modules/@oxc-project/types": { + "version": "0.144.0", + "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.144.0.tgz", + "integrity": "sha512-nuhZIOLuI6TFQ32I/WnUx+SCPY7SdSKwgnFHydAuoS1+Z4BRcaP+RRJmGzl9lw+0OFF7UmaESf7KQRXaNLHypg==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/Boshen" + } + }, + "node_modules/@playwright/test": { + "version": "1.62.1", + "resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.62.1.tgz", + "integrity": "sha512-DTcUc8qii+cpHvtOwggMtBRMjKZHXYWdw8syRYu2vtzuq4Wxphqq4NfCs5Zt44L6mA8rfDfj+PHnxFc/FeK6mQ==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright": "1.62.1" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=20" + } + }, + "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/@rolldown/binding-android-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-android-arm64/-/binding-android-arm64-1.2.4.tgz", + "integrity": "sha512-jHC2cnyKz5xU2fhECtFl8OZ83cYNt13GZQD+0uMJ/X3o+ijmd56okHhTUwxVSHPx1IRVIJEZ1/1pPzeLCU6XKA==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-darwin-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-arm64/-/binding-darwin-arm64-1.2.4.tgz", + "integrity": "sha512-Dc5mPD8F5F/FS8i01syd7FTF6yB2fVthH/TRkjwJkzUK6EpoxHtqvZQP5Zwq80/5z19TWYHIg1KOHboCgVx/aQ==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-darwin-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-darwin-x64/-/binding-darwin-x64-1.2.4.tgz", + "integrity": "sha512-fpDm4oBo6SqLvWUYCmFhdde3U9KH2fRNNMeAnAPAIwxRL345xutL0EtEUcuoxsoazdJGv/MuDBQHlCDrtbvqOg==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-freebsd-x64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-freebsd-x64/-/binding-freebsd-x64-1.2.4.tgz", + "integrity": "sha512-rSJoreDE/HoIzoaib6MTp5jQtCTdMHKIvItAKT/ImS6Y6Ww76oUaeMyp4Vc/fAgd/ehji068IxetHXAnqUwN9A==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm-gnueabihf": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm-gnueabihf/-/binding-linux-arm-gnueabihf-1.2.4.tgz", + "integrity": "sha512-/jm8OGHgn7oGaJu3i/qZI9spUGcJ+y/lk43ttQ/iO1tOd9NissG6o97bighBCiL+BKRngmcDuR6ikfwYdJmVuQ==", + "cpu": [ + "arm" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm64-gnu": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-gnu/-/binding-linux-arm64-gnu-1.2.4.tgz", + "integrity": "sha512-tIP06BeD9EqvECBrPZ+sqdPlYrT+aYaAiu1wYziVx5elRK/ftm33JxVDy2bXGbr6J0CrtirCkR87/X5a2euEng==", + "cpu": [ + "arm64" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-arm64-musl": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-arm64-musl/-/binding-linux-arm64-musl-1.2.4.tgz", + "integrity": "sha512-Ql1Q0EQqVThvn9VAVlwNzsUvbSFtCMGjLpRRi4pk5i7NZZ4n5ISiLMjHYtus4VQ2PvkSw24zyaCVsiS+sXPj1w==", + "cpu": [ + "arm64" + ], + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-ppc64-gnu": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-ppc64-gnu/-/binding-linux-ppc64-gnu-1.2.4.tgz", + "integrity": "sha512-GjbjXD4XXfN19D0LZNbmiCBUoDiRACsYHr0yaIbbn8aFsXjHZifcYqu/W5Er5X2X990WjHXFrxarn5chzItorQ==", + "cpu": [ + "ppc64" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-s390x-gnu": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-s390x-gnu/-/binding-linux-s390x-gnu-1.2.4.tgz", + "integrity": "sha512-p5WR0NOwaRmJ/B1b6IjEFLLivwEsf3PrdBIhRbhTCQisbo2SvHHpG4ELB/+FgQNnB88LTOF86upmJmbvZdQ2lw==", + "cpu": [ + "s390x" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-x64-gnu": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.2.4.tgz", + "integrity": "sha512-4/GyVjmhR+Tc6HLJvwc1sOhPqAZtySiSMesOZyX6JQ5XBxoTDEMKQzvo07NIK6nTon/SivlZqvhzvuVBNQhObQ==", + "cpu": [ + "x64" + ], + "libc": [ + "glibc" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-linux-x64-musl": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-musl/-/binding-linux-x64-musl-1.2.4.tgz", + "integrity": "sha512-l9eeLsCNvPpmSXUej0etw/J1eqV0Jj1D5G/xG6YTijmE6dkv6E2QezgWbTfQk63v952DPqrjOCoiqxq7Bw0YUQ==", + "cpu": [ + "x64" + ], + "libc": [ + "musl" + ], + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-openharmony-arm64": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-openharmony-arm64/-/binding-openharmony-arm64-1.2.4.tgz", + "integrity": "sha512-e0F355MSTMm3+UOqtV3L24gFUp2N5m1f8L/7d56deik6va+AXdrt9F8LbzGpeWGWRbZEDq4m8NVnJDeBtf9DZg==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-win32-arm64-msvc": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-arm64-msvc/-/binding-win32-arm64-msvc-1.2.4.tgz", + "integrity": "sha512-AWLi0uBRYh6QlE7OKhiz+phZC0qwtij2QZmhmOdsLdFn64m7oMpooE9ICE3lhm9xMb4SpDo2WbHcxX1iFLFtqw==", + "cpu": [ + "arm64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/binding-win32-x64-msvc": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/@rolldown/binding-win32-x64-msvc/-/binding-win32-x64-msvc-1.2.4.tgz", + "integrity": "sha512-UwSDJOg3dqCAejWdxclJjCsh3Qq4vLYMDxmyHqo1btz3stK2VqgwNd3mm5tuIwzSlGIQ/1H9Hr+Zn09mrezNqQ==", + "cpu": [ + "x64" + ], + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.19.0 || >=22.12.0" + } + }, + "node_modules/@rolldown/pluginutils": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.1.tgz", + "integrity": "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==", + "license": "MIT" + }, + "node_modules/@shikijs/core": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/@shikijs/core/-/core-4.4.3.tgz", + "integrity": "sha512-QCR4q2ZO/ILJEuwiBMel4wdcTDb1JGwfjKTxPDF6x8ixOaluPrVqIn06C99AcRPhmYlBR56d/Fb+GN58GzExpg==", + "license": "MIT", + "dependencies": { + "@shikijs/primitive": "4.4.3", + "@shikijs/types": "4.4.3", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.5", + "hast-util-to-html": "^9.0.5" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@shikijs/engine-javascript": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/@shikijs/engine-javascript/-/engine-javascript-4.4.3.tgz", + "integrity": "sha512-FbOjFJp9VLdo1Wevs10BBtVxiTWwNLqZh5Gkhjgda/ioL15YOgeSl9n+6XMa3qRlPQzfhFNe641SrynFHYG0nQ==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "4.4.3", + "@shikijs/vscode-textmate": "^10.0.2", + "oniguruma-to-es": "^4.3.6" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@shikijs/engine-oniguruma": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/@shikijs/engine-oniguruma/-/engine-oniguruma-4.4.3.tgz", + "integrity": "sha512-EcOQkxdxGQrc1Row/cC2c96/v1dbZqGnEVu1qTuT/MJmp6+cXCvQussowVmCv5Tqr3KuY3c7IbM6HTW3LJ1k9w==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "4.4.3", + "@shikijs/vscode-textmate": "^10.0.2" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@shikijs/langs": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/@shikijs/langs/-/langs-4.4.3.tgz", + "integrity": "sha512-ePic0yfAJGOF83D5wBHK/00EjK65oahBYxFk5epgq33WRv7X9UuxLEV8PtR0szC0z8dl7INIpIodB99JRFlR+A==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "4.4.3" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@shikijs/primitive": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/@shikijs/primitive/-/primitive-4.4.3.tgz", + "integrity": "sha512-m0wBeLDQDeIxRdUmrCPdQqfuUamDwRL5isCfYbguKD6NiaKpVbsv+3J81DyIKgNW5h4WAIIr8T4EkgQrBBxvaQ==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "4.4.3", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.5" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@shikijs/themes": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/@shikijs/themes/-/themes-4.4.3.tgz", + "integrity": "sha512-w8UHjeUnIR965KMWJHUPXOc2mNJUnK3vpVLYLvw5IYU2mnTTJ89E24OrJDBNiJDQ0qzb0tc4l7mrIXx5cFeIyw==", + "license": "MIT", + "dependencies": { + "@shikijs/types": "4.4.3" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@shikijs/types": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/@shikijs/types/-/types-4.4.3.tgz", + "integrity": "sha512-UEJxmRR++MAGR6hugn0vgVS2W/6lWAts84FFSrnlH9sP0LNol7E5+NQ792pH8liWUhyMyjhTgSUH3k7iD7tc5g==", + "license": "MIT", + "dependencies": { + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.5" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@shikijs/vscode-textmate": { + "version": "10.0.2", + "resolved": "https://registry.npmjs.org/@shikijs/vscode-textmate/-/vscode-textmate-10.0.2.tgz", + "integrity": "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==", + "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.24", + "resolved": "https://registry.npmjs.org/@speed-highlight/core/-/core-1.2.24.tgz", + "integrity": "sha512-qeW2e1l78afw8VhRPfPQ1Gjj+KU5XFQ/OFV5ti6eTa9bruO7mJyZtA4vw0ofqmA3tKCkROE9xLk3VZoeRc98nw==", + "dev": true, + "license": "CC0-1.0" + }, + "node_modules/@standard-schema/spec": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz", + "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==", + "dev": true, + "license": "MIT" + }, + "node_modules/@tybys/wasm-util": { + "version": "0.10.3", + "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.3.tgz", + "integrity": "sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==", + "license": "MIT", + "optional": true, + "dependencies": { + "tslib": "^2.4.0" + } + }, + "node_modules/@types/chai": { + "version": "5.2.3", + "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz", + "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/deep-eql": "*", + "assertion-error": "^2.0.1" + } + }, + "node_modules/@types/deep-eql": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz", + "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==", + "dev": true, + "license": "MIT" + }, + "node_modules/@types/estree": { + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", + "license": "MIT" + }, + "node_modules/@types/estree-jsx": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/@types/estree-jsx/-/estree-jsx-1.0.5.tgz", + "integrity": "sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==", + "license": "MIT", + "dependencies": { + "@types/estree": "*" + } + }, + "node_modules/@types/hast": { + "version": "3.0.5", + "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.5.tgz", + "integrity": "sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/mdast": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz", + "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/nlcst": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/@types/nlcst/-/nlcst-2.0.3.tgz", + "integrity": "sha512-vSYNSDe6Ix3q+6Z7ri9lyWqgGhJTmzRjZRqyq15N0Z/1/UnVsno9G/N40NBijoYx2seFDIl0+B2mgAb9mezUCA==", + "license": "MIT", + "dependencies": { + "@types/unist": "*" + } + }, + "node_modules/@types/node": { + "version": "24.13.3", + "resolved": "https://registry.npmjs.org/@types/node/-/node-24.13.3.tgz", + "integrity": "sha512-Dh8vAsV36ig5wa9OX4pXvMc9D3Veibfw2wix0CUwYODLD8nkj9UsLjASr49nPg+2eKzxhBV+v7L8pXvT4e639Q==", + "license": "MIT", + "dependencies": { + "undici-types": "~7.18.0" + } + }, + "node_modules/@types/sax": { + "version": "1.2.7", + "resolved": "https://registry.npmjs.org/@types/sax/-/sax-1.2.7.tgz", + "integrity": "sha512-rO73L89PJxeYM3s3pPPjiPgVVcymqU490g0YO5n5By0k2Erzj6tay/4lr1CHAAU4JyOWd1rpQ8bCf6cZfHU96A==", + "license": "MIT", + "dependencies": { + "@types/node": "*" + } + }, + "node_modules/@types/unist": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz", + "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==", + "license": "MIT" + }, + "node_modules/@ungap/structured-clone": { + "version": "1.3.3", + "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.3.3.tgz", + "integrity": "sha512-60YRaenCQcVjYEKOcG824+DRGGIQ3VKErcBoAEDJZz5bKIs2ZG+X/H9Nk+Q6EVkwJk5QNApxbrc5QtBSwtrXAg==", + "license": "ISC" + }, + "node_modules/@vitest/expect": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.10.tgz", + "integrity": "sha512-YsCn+qAk1GWjQOWFEsEcL2gNQ0zmVmQu3T03qP6UyjhtmdtwtbuI+DASn/7iQB3HGTXkdBwGddzxPlmiql5vlA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@standard-schema/spec": "^1.1.0", + "@types/chai": "^5.2.2", + "@vitest/spy": "4.1.10", + "@vitest/utils": "4.1.10", + "chai": "^6.2.2", + "tinyrainbow": "^3.1.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/mocker": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.10.tgz", + "integrity": "sha512-v0xaezt+DKEmKfaxg133ldzADrwLGd7Ze1MfQQTYfvs8OqZIwbxyxaYURivwV7sWy5fqn3rH5uOrSp07bp44Ow==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/spy": "4.1.10", + "estree-walker": "^3.0.3", + "magic-string": "^0.30.21" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "msw": "^2.4.9", + "vite": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "msw": { + "optional": true + }, + "vite": { + "optional": true + } + } + }, + "node_modules/@vitest/mocker/node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/@vitest/pretty-format": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.10.tgz", + "integrity": "sha512-W1HsjSH4MXQ9YfmmhLAoIYf1HRfekQCGngeIgcei6MP5QQGWUe0gkopdZQaVCFO+JDJMrAJGwa5pRpNpvy4P8Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "tinyrainbow": "^3.1.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/runner": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.10.tgz", + "integrity": "sha512-IKI6kpIH+LmpROplyLwBBaCfMgOZOMsygVa6BARD6ahA04VRuJSa6OaVG7kRvSEMD870Vd91rSSw0eegtWyLGg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/utils": "4.1.10", + "pathe": "^2.0.3" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/snapshot": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.10.tgz", + "integrity": "sha512-xRkfOT1qpTAi/Ti4Y1LtfRc3kEuqxGw59eN2jN9pRWMtS/XDevekhcFSqvQqjUNGksfjMJu3Y+oJ+4Ypn2OaJw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "4.1.10", + "@vitest/utils": "4.1.10", + "magic-string": "^0.30.21", + "pathe": "^2.0.3" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/snapshot/node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/@vitest/spy": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.10.tgz", + "integrity": "sha512-PLf/Ugvoq5wO/b4rwYCR1h2PSIdXz7wnkQFMiUpLdtM7l6pqVFcQIBEHyT1+l+cj7mNwAfZHzqXqDyjvOuwbDw==", + "dev": true, + "license": "MIT", + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@vitest/utils": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.10.tgz", + "integrity": "sha512-fy9am/HWxbaGt/Sawrp90vt6Y6jQwf1RX77cz3uwoJwJVMli/e1IEwRPnMNJ7vKfPTwo0diXifkpPvwH9v7nGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/pretty-format": "4.1.10", + "convert-source-map": "^2.0.0", + "tinyrainbow": "^3.1.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + } + }, + "node_modules/@volar/kit": { + "version": "2.4.28", + "resolved": "https://registry.npmjs.org/@volar/kit/-/kit-2.4.28.tgz", + "integrity": "sha512-cKX4vK9dtZvDRaAzeoUdaAJEew6IdxHNCRrdp5Kvcl6zZOqb6jTOfk3kXkIkG3T7oTFXguEMt5+9ptyqYR84Pg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-service": "2.4.28", + "@volar/typescript": "2.4.28", + "typesafe-path": "^0.2.2", + "vscode-languageserver-textdocument": "^1.0.11", + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "typescript": "*" + } + }, + "node_modules/@volar/language-core": { + "version": "2.4.28", + "resolved": "https://registry.npmjs.org/@volar/language-core/-/language-core-2.4.28.tgz", + "integrity": "sha512-w4qhIJ8ZSitgLAkVay6AbcnC7gP3glYM3fYwKV3srj8m494E3xtrCv6E+bWviiK/8hs6e6t1ij1s2Endql7vzQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/source-map": "2.4.28" + } + }, + "node_modules/@volar/language-server": { + "version": "2.4.28", + "resolved": "https://registry.npmjs.org/@volar/language-server/-/language-server-2.4.28.tgz", + "integrity": "sha512-NqcLnE5gERKuS4PUFwlhMxf6vqYo7hXtbMFbViXcbVkbZ905AIVWhnSo0ZNBC2V127H1/2zP7RvVOVnyITFfBw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.28", + "@volar/language-service": "2.4.28", + "@volar/typescript": "2.4.28", + "path-browserify": "^1.0.1", + "request-light": "^0.7.0", + "vscode-languageserver": "^9.0.1", + "vscode-languageserver-protocol": "^3.17.5", + "vscode-languageserver-textdocument": "^1.0.11", + "vscode-uri": "^3.0.8" + } + }, + "node_modules/@volar/language-service": { + "version": "2.4.28", + "resolved": "https://registry.npmjs.org/@volar/language-service/-/language-service-2.4.28.tgz", + "integrity": "sha512-Rh/wYCZJrI5vCwMk9xyw/Z+MsWxlJY1rmMZPsxUoJKfzIRjS/NF1NmnuEcrMbEVGja00aVpCsInJfixQTMdvLw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.28", + "vscode-languageserver-protocol": "^3.17.5", + "vscode-languageserver-textdocument": "^1.0.11", + "vscode-uri": "^3.0.8" + } + }, + "node_modules/@volar/source-map": { + "version": "2.4.28", + "resolved": "https://registry.npmjs.org/@volar/source-map/-/source-map-2.4.28.tgz", + "integrity": "sha512-yX2BDBqJkRXfKw8my8VarTyjv48QwxdJtvRgUpNE5erCsgEUdI2DsLbpa+rOQVAJYshY99szEcRDmyHbF10ggQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/@volar/typescript": { + "version": "2.4.28", + "resolved": "https://registry.npmjs.org/@volar/typescript/-/typescript-2.4.28.tgz", + "integrity": "sha512-Ja6yvWrbis2QtN4ClAKreeUZPVYMARDYZl9LMEv1iQ1QdepB6wn0jTRxA9MftYmYa4DQ4k/DaSZpFPUfxl8giw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@volar/language-core": "2.4.28", + "path-browserify": "^1.0.1", + "vscode-uri": "^3.0.8" + } + }, + "node_modules/@vscode/emmet-helper": { + "version": "2.11.0", + "resolved": "https://registry.npmjs.org/@vscode/emmet-helper/-/emmet-helper-2.11.0.tgz", + "integrity": "sha512-QLxjQR3imPZPQltfbWRnHU6JecWTF1QSWhx3GAKQpslx7y3Dp6sIIXhKjiUJ/BR9FX8PVthjr9PD6pNwOJfAzw==", + "dev": true, + "license": "MIT", + "dependencies": { + "emmet": "^2.4.3", + "jsonc-parser": "^2.3.0", + "vscode-languageserver-textdocument": "^1.0.1", + "vscode-languageserver-types": "^3.15.1", + "vscode-uri": "^3.0.8" + } + }, + "node_modules/@vscode/emmet-helper/node_modules/jsonc-parser": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-2.3.1.tgz", + "integrity": "sha512-H8jvkz1O50L3dMZCsLqiuB2tA7muqbSg1AtGEkN0leAqGjsUzDJir3Zwr02BhqdcITPg3ei3mZ+HjMocAknhhg==", + "dev": true, + "license": "MIT" + }, + "node_modules/@vscode/l10n": { + "version": "0.0.18", + "resolved": "https://registry.npmjs.org/@vscode/l10n/-/l10n-0.0.18.tgz", + "integrity": "sha512-KYSIHVmslkaCDyw013pphY+d7x1qV8IZupYfeIfzNA+nsaWHbn5uPuQRvdRFsa9zFzGeudPuoGoZ1Op4jrJXIQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/ajv": { + "version": "8.20.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz", + "integrity": "sha512-Thbli+OlOj+iMPYFBVBfJ3OmCAnaSyNn4M1vz9T6Gka5Jt9ba/HIR56joy65tY6kx/FCF5VXNB819Y7/GUrBGA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/ajv-draft-04": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/ajv-draft-04/-/ajv-draft-04-1.0.0.tgz", + "integrity": "sha512-mv00Te6nmYbRp5DCwclxtt7yV/joXJPGS7nM+97GdxvuttCOfgI3K4U25zboyeX0O+myI8ERluxQe5wljMmVIw==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "ajv": "^8.5.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, + "node_modules/ajv-i18n": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/ajv-i18n/-/ajv-i18n-4.2.0.tgz", + "integrity": "sha512-v/ei2UkCEeuKNXh8RToiFsUclmU+G57LO1Oo22OagNMENIw+Yb8eMwvHu7Vn9fmkjJyv6XclhJ8TbuigSglPkg==", + "dev": true, + "license": "MIT", + "peerDependencies": { + "ajv": "^8.0.0-beta.0" + } + }, + "node_modules/am-i-vibing": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/am-i-vibing/-/am-i-vibing-0.4.0.tgz", + "integrity": "sha512-MxT4XZL7pzLHpuvhDKdMaQHMGGkJDLluKBLsbstn+8wv9sWcFT6h+0ve9qkml95amVTZtZV83gQe2hY+ojgHLg==", + "license": "MIT", + "dependencies": { + "process-ancestry": "^0.1.0" + }, + "bin": { + "am-i-vibing": "dist/cli.mjs" + } + }, + "node_modules/ansi-regex": { + "version": "6.3.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.3.0.tgz", + "integrity": "sha512-WpDfL7NO6j7tH88IDBNVdUJxDh9nmCteAVW9dsep846XdwF4naCBK+/tGLX3KJgcpgMRXCFlTM2hKGoK9FsdrQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "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==", + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/anymatch": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", + "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "license": "ISC", + "dependencies": { + "normalize-path": "^3.0.0", + "picomatch": "^2.0.4" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/anymatch/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==", + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/anynum": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/anynum/-/anynum-1.0.1.tgz", + "integrity": "sha512-N6//FLET/tXYNM/F6ABca1oH6fWB+KlTt909Le28WMDBk8oaT4vY17DCrwg2MvmuqUKt3Ni4N5dGJ/EoBgcO6A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT" + }, + "node_modules/arg": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/arg/-/arg-5.0.2.tgz", + "integrity": "sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==", + "license": "MIT" + }, + "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==", + "license": "Python-2.0" + }, + "node_modules/aria-query": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/aria-query/-/aria-query-5.3.2.tgz", + "integrity": "sha512-COROpnaoap1E2F000S62r6A60uHZnmlvomhfyT2DlTcrY1OrBKn2UhH7qn5wTC9zMvD0AY7csdPSNwKP+7WiQw==", + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/assertion-error": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz", + "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + } + }, + "node_modules/astro": { + "version": "7.2.2", + "resolved": "https://registry.npmjs.org/astro/-/astro-7.2.2.tgz", + "integrity": "sha512-OvLWCpXpb43lVYcWzSBJ0sk44qcEYYRZCjadtalLfAwb2RaC3P/zT+blZykBw/o6suw6sQQkn00ugN36akD8Mw==", + "license": "MIT", + "dependencies": { + "@astrojs/compiler-rs": "^0.3.2", + "@astrojs/internal-helpers": "0.10.2", + "@astrojs/markdown-satteri": "0.3.5", + "@astrojs/telemetry": "3.3.3", + "@capsizecss/unpack": "^4.0.0", + "@clack/prompts": "^1.1.0", + "@oslojs/encoding": "^1.1.0", + "am-i-vibing": "^0.4.0", + "aria-query": "^5.3.2", + "axobject-query": "^4.1.0", + "ci-info": "^4.4.0", + "clsx": "^2.1.1", + "common-ancestor-path": "^2.0.0", + "cookie": "^2.0.1", + "devalue": "^5.8.1", + "diff": "^8.0.3", + "dset": "^3.1.4", + "es-module-lexer": "^2.0.0", + "esbuild": "^0.28.0", + "find-process": "^2.1.1", + "flattie": "^1.1.1", + "fontace": "~0.4.1", + "get-tsconfig": "5.0.0-beta.4", + "github-slugger": "^2.0.0", + "html-escaper": "3.0.3", + "http-cache-semantics": "^4.2.0", + "js-yaml": "^4.3.0", + "jsonc-parser": "^3.3.1", + "magic-string": "^1.0.0", + "magicast": "^0.5.2", + "mrmime": "^2.0.1", + "neotraverse": "^1.0.1", + "obug": "^2.1.1", + "p-limit": "^7.3.0", + "p-queue": "^9.1.0", + "package-manager-detector": "^1.6.0", + "piccolore": "^0.1.3", + "picomatch": "^4.0.4", + "semver": "^7.7.4", + "shiki": "^4.0.2", + "smol-toml": "^1.6.0", + "svgo": "^4.0.1", + "tinyclip": "^0.1.12", + "tinyexec": "^1.0.4", + "tinyglobby": "^0.2.15", + "ultrahtml": "^1.6.0", + "unifont": "~0.7.4", + "unstorage": "^1.17.5", + "vite": "^8.0.13", + "vitefu": "^1.1.2", + "xxhash-wasm": "^1.1.0", + "yargs-parser": "^22.0.0", + "zod": "^4.3.6" + }, + "bin": { + "astro": "bin/astro.mjs" + }, + "engines": { + "node": ">=22.12.0", + "npm": ">=9.6.5", + "pnpm": ">=7.1.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/astrodotbuild" + }, + "optionalDependencies": { + "sharp": "^0.34.0 || ^0.35.0" + }, + "peerDependencies": { + "@astrojs/markdown-remark": "7.2.2" + }, + "peerDependenciesMeta": { + "@astrojs/markdown-remark": { + "optional": true + } + } + }, + "node_modules/axe-core": { + "version": "4.13.0", + "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.13.0.tgz", + "integrity": "sha512-UzGt8zg7Ny8djbYMhxl2zuEevVa7r2gJjYY5Lwr1xM7+XU2nd6CkIWFTVcCIbAP63vSz71NaVyyuSk9lHKcy0A==", + "dev": true, + "license": "MPL-2.0", + "engines": { + "node": ">=4" + } + }, + "node_modules/axobject-query": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/axobject-query/-/axobject-query-4.1.0.tgz", + "integrity": "sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==", + "license": "Apache-2.0", + "engines": { + "node": ">= 0.4" + } + }, + "node_modules/bail": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz", + "integrity": "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "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/boolbase": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/boolbase/-/boolbase-1.0.0.tgz", + "integrity": "sha512-JZOSA7Mo9sNGB8+UjSgzdLtokWAky1zbztM3WRLCbZ70/3cTANmQmOdR7y2g+J0e2WXywy1yS468tY+IruqEww==", + "license": "ISC" + }, + "node_modules/ccount": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz", + "integrity": "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/chai": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/chai/-/chai-6.2.2.tgz", + "integrity": "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "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/character-entities-html4": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz", + "integrity": "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/character-entities-legacy": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz", + "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/chokidar": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz", + "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==", + "dev": true, + "license": "MIT", + "dependencies": { + "readdirp": "^4.0.1" + }, + "engines": { + "node": ">= 14.16.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/ci-info": { + "version": "4.4.0", + "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-4.4.0.tgz", + "integrity": "sha512-77PSwercCZU2Fc4sX94eF8k8Pxte6JAwL4/ICZLFjJLqegs7kCuAsqqj/70NQF6TvDpgFjkubQB2FW2ZZddvQg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/sibiraj-s" + } + ], + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/cliui": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-9.0.1.tgz", + "integrity": "sha512-k7ndgKhwoQveBL+/1tqGJYNz097I7WOvwbmmU2AR5+magtbjPWQTS1C5vzGkBC8Ym8UWRzfKUzUUqFLypY4Q+w==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^7.2.0", + "strip-ansi": "^7.1.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/cliui/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/clsx": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz", + "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "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==", + "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==", + "license": "MIT" + }, + "node_modules/comma-separated-tokens": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz", + "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/commander": { + "version": "14.0.3", + "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.3.tgz", + "integrity": "sha512-H+y0Jo/T1RZ9qPP4Eh1pkcQcLRglraJaSLoyOtHxu6AapkjWVCy2Sit1QQ4x3Dng8qDlSsZEet7g5Pq06MvTgw==", + "license": "MIT", + "engines": { + "node": ">=20" + } + }, + "node_modules/common-ancestor-path": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/common-ancestor-path/-/common-ancestor-path-2.0.0.tgz", + "integrity": "sha512-dnN3ibLeoRf2HNC+OlCiNc5d2zxbLJXOtiZUudNFSXZrNSydxcCsSpRzXwfu7BBWCIfHPw+xTayeBvJCP/D8Ng==", + "license": "BlueOak-1.0.0", + "engines": { + "node": ">= 18" + } + }, + "node_modules/convert-source-map": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz", + "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==", + "dev": true, + "license": "MIT" + }, + "node_modules/cookie": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/cookie/-/cookie-2.0.1.tgz", + "integrity": "sha512-yuToqVvRrj6pfDXREyQAAv8SkAEk/8GS3jQRTiUMm66TVtBYmqQeoEjL2Lmq8Rpo6271vH76InTChTitEAm65w==", + "license": "MIT", + "engines": { + "node": ">=22" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/express" + } + }, + "node_modules/cookie-es": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/cookie-es/-/cookie-es-1.2.3.tgz", + "integrity": "sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw==", + "license": "MIT" + }, + "node_modules/crossws": { + "version": "0.3.5", + "resolved": "https://registry.npmjs.org/crossws/-/crossws-0.3.5.tgz", + "integrity": "sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA==", + "license": "MIT", + "dependencies": { + "uncrypto": "^0.1.3" + } + }, + "node_modules/css-select": { + "version": "5.2.2", + "resolved": "https://registry.npmjs.org/css-select/-/css-select-5.2.2.tgz", + "integrity": "sha512-TizTzUddG/xYLA3NXodFM0fSbNizXjOKhqiQQwvhlspadZokn1KDy0NZFS0wuEubIYAV5/c1/lAr0TaaFXEXzw==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0", + "css-what": "^6.1.0", + "domhandler": "^5.0.2", + "domutils": "^3.0.1", + "nth-check": "^2.0.1" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/css-tree": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-3.2.1.tgz", + "integrity": "sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.27.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0" + } + }, + "node_modules/css-what": { + "version": "6.2.2", + "resolved": "https://registry.npmjs.org/css-what/-/css-what-6.2.2.tgz", + "integrity": "sha512-u/O3vwbptzhMs3L1fQE82ZSLHQQfto5gyZzwteVIEyeaY5Fc7R4dapF/BvRoSYFeqfBk4m0V1Vafq5Pjv25wvA==", + "license": "BSD-2-Clause", + "engines": { + "node": ">= 6" + }, + "funding": { + "url": "https://github.com/sponsors/fb55" + } + }, + "node_modules/csso": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/csso/-/csso-5.0.5.tgz", + "integrity": "sha512-0LrrStPOdJj+SPCCrGhzryycLjwcgUSHBtxNA8aIDxf0GLsRh1cKYhB00Gd1lDOS4yGH69+SNn13+TWbVHETFQ==", + "license": "MIT", + "dependencies": { + "css-tree": "~2.2.0" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0", + "npm": ">=7.0.0" + } + }, + "node_modules/csso/node_modules/css-tree": { + "version": "2.2.1", + "resolved": "https://registry.npmjs.org/css-tree/-/css-tree-2.2.1.tgz", + "integrity": "sha512-OA0mILzGc1kCOCSJerOeqDxDQ4HOh+G8NbOJFOTgOCzpw7fCBubk0fEyxp8AgOL/jvLgYA/uV0cMbe43ElF1JA==", + "license": "MIT", + "dependencies": { + "mdn-data": "2.0.28", + "source-map-js": "^1.0.1" + }, + "engines": { + "node": "^10 || ^12.20.0 || ^14.13.0 || >=15.0.0", + "npm": ">=7.0.0" + } + }, + "node_modules/csso/node_modules/mdn-data": { + "version": "2.0.28", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.0.28.tgz", + "integrity": "sha512-aylIc7Z9y4yzHYAJNuESG3hfhC+0Ibp/MAMiaOZgNv4pmEdFyfZhhhny4MNiAfWdBQ1RQ2mfDWmM1x8SvGyp8g==", + "license": "CC0-1.0" + }, + "node_modules/defu": { + "version": "6.1.7", + "resolved": "https://registry.npmjs.org/defu/-/defu-6.1.7.tgz", + "integrity": "sha512-7z22QmUWiQ/2d0KkdYmANbRUVABpZ9SNYyH5vx6PZ+nE5bcC0l7uFvEfHlyld/HcGBFTL536ClDt3DEcSlEJAQ==", + "license": "MIT" + }, + "node_modules/dequal": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz", + "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/destr": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/destr/-/destr-2.0.5.tgz", + "integrity": "sha512-ugFTXCtDZunbzasqBxrK93Ik/DRYsO6S/fedkWEMKqt04xZ4csmnmwGDBAb07QWNaGMAmnTIemsYZCksjATwsA==", + "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==", + "license": "Apache-2.0", + "engines": { + "node": ">=8" + } + }, + "node_modules/devalue": { + "version": "5.9.0", + "resolved": "https://registry.npmjs.org/devalue/-/devalue-5.9.0.tgz", + "integrity": "sha512-RWrqdArjvPbsATEhOPUo6Wndc/iWnkWKlhIrdlF3zMMYo/c3CVtoaVAyLtWxz5h8nSlkHzxnzV2uLydPXmtF+A==", + "license": "MIT" + }, + "node_modules/devlop": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz", + "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==", + "license": "MIT", + "dependencies": { + "dequal": "^2.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/diff": { + "version": "8.0.4", + "resolved": "https://registry.npmjs.org/diff/-/diff-8.0.4.tgz", + "integrity": "sha512-DPi0FmjiSU5EvQV0++GFDOJ9ASQUVFh5kD+OzOnYdi7n3Wpm9hWWGfB/O2blfHcMVTL5WkQXSnRiK9makhrcnw==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.3.1" + } + }, + "node_modules/dom-serializer": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-2.0.0.tgz", + "integrity": "sha512-wIkAryiqt/nV5EQKqQpo3SToSOV9J0DnbJqwK7Wv/Trc92zIAYZ4FlMu+JPFW1DfGFt81ZTCGgDEabffXeLyJg==", + "license": "MIT", + "dependencies": { + "domelementtype": "^2.3.0", + "domhandler": "^5.0.2", + "entities": "^4.2.0" + }, + "funding": { + "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1" + } + }, + "node_modules/dom-serializer/node_modules/entities": { + "version": "4.5.0", + "resolved": "https://registry.npmjs.org/entities/-/entities-4.5.0.tgz", + "integrity": "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "node_modules/domelementtype": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz", + "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fb55" + } + ], + "license": "BSD-2-Clause" + }, + "node_modules/domhandler": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-5.0.3.tgz", + "integrity": "sha512-cgwlv/1iFQiFnU96XXgROh8xTeetsnJiDsTc7TYCLFd9+/WNkIqPTxiM/8pSd8VIrhXGTf1Ny1q1hquVqDJB5w==", + "license": "BSD-2-Clause", + "dependencies": { + "domelementtype": "^2.3.0" + }, + "engines": { + "node": ">= 4" + }, + "funding": { + "url": "https://github.com/fb55/domhandler?sponsor=1" + } + }, + "node_modules/domutils": { + "version": "3.2.2", + "resolved": "https://registry.npmjs.org/domutils/-/domutils-3.2.2.tgz", + "integrity": "sha512-6kZKyUajlDuqlHKVX1w7gyslj9MPIXzIFiz/rGu35uC1wMi+kMhQwGhl4lt9unC9Vb9INnY9Z3/ZA3+FhASLaw==", + "license": "BSD-2-Clause", + "dependencies": { + "dom-serializer": "^2.0.0", + "domelementtype": "^2.3.0", + "domhandler": "^5.0.3" + }, + "funding": { + "url": "https://github.com/fb55/domutils?sponsor=1" + } + }, + "node_modules/dset": { + "version": "3.1.4", + "resolved": "https://registry.npmjs.org/dset/-/dset-3.1.4.tgz", + "integrity": "sha512-2QF/g9/zTaPDc3BjNcVTGoBbXBgYfMTTceLaYcFJ/W9kggFUkhxD/hMEeuLKbugyef9SqAx8cpgwlIP/jinUTA==", + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/emmet": { + "version": "2.4.11", + "resolved": "https://registry.npmjs.org/emmet/-/emmet-2.4.11.tgz", + "integrity": "sha512-23QPJB3moh/U9sT4rQzGgeyyGIrcM+GH5uVYg2C6wZIxAIJq7Ng3QLT79tl8FUwDXhyq9SusfknOrofAKqvgyQ==", + "dev": true, + "license": "MIT", + "workspaces": [ + "./packages/scanner", + "./packages/abbreviation", + "./packages/css-abbreviation", + "./" + ], + "dependencies": { + "@emmetio/abbreviation": "^2.3.3", + "@emmetio/css-abbreviation": "^2.1.8" + } + }, + "node_modules/emoji-regex": { + "version": "10.6.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.6.0.tgz", + "integrity": "sha512-toUI84YS5YmxW219erniWD0CIVOo46xGKColeNQRgOzDorgBi1v4D71/OFzgD9GO2UGKIv1C3Sp8DAn0+j5w7A==", + "dev": true, + "license": "MIT" + }, + "node_modules/entities": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz", + "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==", + "license": "BSD-2-Clause", + "engines": { + "node": ">=0.12" + }, + "funding": { + "url": "https://github.com/fb55/entities?sponsor=1" + } + }, + "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/es-module-lexer": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.3.2.tgz", + "integrity": "sha512-poHGpORABojJJucnV9KbOavETW8lBVnphkW77ER5/BQ5Fz7oXSoCNek7IH3vR5nRjdsEz926ibFYX8KtLQmdyw==", + "license": "MIT" + }, + "node_modules/esbuild": { + "version": "0.28.2", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz", + "integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==", + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.28.2", + "@esbuild/android-arm": "0.28.2", + "@esbuild/android-arm64": "0.28.2", + "@esbuild/android-x64": "0.28.2", + "@esbuild/darwin-arm64": "0.28.2", + "@esbuild/darwin-x64": "0.28.2", + "@esbuild/freebsd-arm64": "0.28.2", + "@esbuild/freebsd-x64": "0.28.2", + "@esbuild/linux-arm": "0.28.2", + "@esbuild/linux-arm64": "0.28.2", + "@esbuild/linux-ia32": "0.28.2", + "@esbuild/linux-loong64": "0.28.2", + "@esbuild/linux-mips64el": "0.28.2", + "@esbuild/linux-ppc64": "0.28.2", + "@esbuild/linux-riscv64": "0.28.2", + "@esbuild/linux-s390x": "0.28.2", + "@esbuild/linux-x64": "0.28.2", + "@esbuild/netbsd-arm64": "0.28.2", + "@esbuild/netbsd-x64": "0.28.2", + "@esbuild/openbsd-arm64": "0.28.2", + "@esbuild/openbsd-x64": "0.28.2", + "@esbuild/openharmony-arm64": "0.28.2", + "@esbuild/sunos-x64": "0.28.2", + "@esbuild/win32-arm64": "0.28.2", + "@esbuild/win32-ia32": "0.28.2", + "@esbuild/win32-x64": "0.28.2" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/estree-walker": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz", + "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "^1.0.0" + } + }, + "node_modules/eventemitter3": { + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", + "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==", + "license": "MIT" + }, + "node_modules/expect-type": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.4.0.tgz", + "integrity": "sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=12.0.0" + } + }, + "node_modules/extend": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", + "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==", + "license": "MIT" + }, + "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-string-truncated-width": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/fast-string-truncated-width/-/fast-string-truncated-width-3.0.3.tgz", + "integrity": "sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g==", + "license": "MIT" + }, + "node_modules/fast-string-width": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/fast-string-width/-/fast-string-width-3.0.2.tgz", + "integrity": "sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg==", + "license": "MIT", + "dependencies": { + "fast-string-truncated-width": "^3.0.2" + } + }, + "node_modules/fast-uri": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.5.tgz", + "integrity": "sha512-gHwA1O9LDIcKunMKhObS/HimwtehO1nPUECKAu5TpKgaO19fcWEl4bliWe1jWxVFvIXztJjjQ4L8XQ1EU9f7Jw==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/fastify" + }, + { + "type": "opencollective", + "url": "https://opencollective.com/fastify" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/fast-wrap-ansi": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/fast-wrap-ansi/-/fast-wrap-ansi-0.2.2.tgz", + "integrity": "sha512-7F2Fl+TjRSenLqlU3UjSH0iyqopqoZIu7eZVpEirP2g1GtWa2G/ecEmBdgz31+Mxr+ELclgg6sokpSFIQiZ02Q==", + "license": "MIT", + "dependencies": { + "fast-string-width": "^3.0.2" + } + }, + "node_modules/fast-xml-builder": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.3.1.tgz", + "integrity": "sha512-pIM/1n3ntFXKYrUZwW7QCK0gAW7XY+wzj1YMIV3tLDvPj/V+zTGJK5e3/4WJfwj0qWw2ElNXiTixda/R+3YSug==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT", + "dependencies": { + "path-expression-matcher": "^1.6.2", + "xml-naming": "^0.3.0" + } + }, + "node_modules/fast-xml-parser": { + "version": "5.11.0", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.11.0.tgz", + "integrity": "sha512-9IGxMqvqLOnqP+Egi1nqDHKv5k8aZ7r9n558enxcucmyVGEBNPAU+MOg/8jPIS7rO7sSq4gFm1/nHtiaubMruw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT", + "dependencies": { + "@nodable/entities": "^3.0.0", + "fast-xml-builder": "^1.2.0", + "is-unsafe": "^2.0.0", + "path-expression-matcher": "^1.6.2", + "strnum": "^2.4.2", + "xml-naming": "^0.3.0" + }, + "bin": { + "fxparser": "src/cli/cli.js" + } + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/find-process": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/find-process/-/find-process-2.1.1.tgz", + "integrity": "sha512-SrQDx3QhlmHM90iqn9rdjCQcw/T+WlpOkHFsjoRgB+zTpDfltNA1VSNYeYELwhUTJy12UFxqjWhmhOrJc+o4sA==", + "license": "MIT", + "dependencies": { + "chalk": "~4.1.2", + "commander": "^14.0.3", + "loglevel": "^1.9.2" + }, + "bin": { + "find-process": "dist/cjs/bin/find-process.js" + } + }, + "node_modules/flattie": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/flattie/-/flattie-1.1.1.tgz", + "integrity": "sha512-9UbaD6XdAL97+k/n+N7JwX46K/M6Zc6KcFYskrYL8wbBV/Uyk0CTAMY0VT+qiK5PM7AIc9aTWYtq65U7T+aCNQ==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/fontace": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/fontace/-/fontace-0.4.1.tgz", + "integrity": "sha512-lDMvbAzSnHmbYMTEld5qdtvNH2/pWpICOqpean9IgC7vUbUJc3k+k5Dokp85CegamqQpFbXf0rAVkbzpyTA8aw==", + "license": "MIT", + "dependencies": { + "fontkitten": "^1.0.2" + } + }, + "node_modules/fontkitten": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/fontkitten/-/fontkitten-1.0.3.tgz", + "integrity": "sha512-Wp1zXWPVUPBmfoa3Cqc9ctaKuzKAV6uLstRqlR56kSjplf5uAce+qeyYym7F+PHbGTk+tCEdkCW6RD7DX/gBZw==", + "license": "MIT", + "dependencies": { + "tiny-inflate": "^1.0.3" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/fsevents": { + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.2.tgz", + "integrity": "sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "dev": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.6.0.tgz", + "integrity": "sha512-QRbvDIbx6YklUe6RxeTeleMR0yv3cYH6PsPZHcnVn7xv7zO1BHN8r0XETu8n6Ye3Q+ahtSarc3WgtNWmehIBfA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/get-tsconfig": { + "version": "5.0.0-beta.4", + "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-5.0.0-beta.4.tgz", + "integrity": "sha512-7nF7C9fIPFEMHgEMEfgIlO9wDdZ8CyHw27rWciFZfHvHDReIiPhsYuzPRXsfvBCqFy1l8RRyyWV7QLM+ZhUJsQ==", + "license": "MIT", + "dependencies": { + "resolve-pkg-maps": "^1.0.0" + }, + "engines": { + "node": ">=20.20.0" + }, + "funding": { + "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1" + } + }, + "node_modules/github-slugger": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/github-slugger/-/github-slugger-2.0.0.tgz", + "integrity": "sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==", + "license": "ISC" + }, + "node_modules/h3": { + "version": "1.15.11", + "resolved": "https://registry.npmjs.org/h3/-/h3-1.15.11.tgz", + "integrity": "sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg==", + "license": "MIT", + "dependencies": { + "cookie-es": "^1.2.3", + "crossws": "^0.3.5", + "defu": "^6.1.6", + "destr": "^2.0.5", + "iron-webcrypto": "^1.2.1", + "node-mock-http": "^1.0.4", + "radix3": "^1.1.2", + "ufo": "^1.6.3", + "uncrypto": "^0.1.3" + } + }, + "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==", + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/hast-util-from-html": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/hast-util-from-html/-/hast-util-from-html-2.0.3.tgz", + "integrity": "sha512-CUSRHXyKjzHov8yKsQjGOElXy/3EKpyX56ELnkHH34vDVw1N1XSQ1ZcAvTyAPtGqLTuKP/uxM+aLkSPqF/EtMw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "devlop": "^1.1.0", + "hast-util-from-parse5": "^8.0.0", + "parse5": "^7.0.0", + "vfile": "^6.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-from-parse5": { + "version": "8.0.3", + "resolved": "https://registry.npmjs.org/hast-util-from-parse5/-/hast-util-from-parse5-8.0.3.tgz", + "integrity": "sha512-3kxEVkEKt0zvcZ3hCRYI8rqrgwtlIOFMWkbclACvjlDw8Li9S2hk/d51OI0nr/gIpdMHNepwgOKqZ/sy0Clpyg==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "devlop": "^1.0.0", + "hastscript": "^9.0.0", + "property-information": "^7.0.0", + "vfile": "^6.0.0", + "vfile-location": "^5.0.0", + "web-namespaces": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-parse-selector": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/hast-util-parse-selector/-/hast-util-parse-selector-4.0.0.tgz", + "integrity": "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-to-html": { + "version": "9.0.5", + "resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.5.tgz", + "integrity": "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/unist": "^3.0.0", + "ccount": "^2.0.0", + "comma-separated-tokens": "^2.0.0", + "hast-util-whitespace": "^3.0.0", + "html-void-elements": "^3.0.0", + "mdast-util-to-hast": "^13.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0", + "stringify-entities": "^4.0.0", + "zwitch": "^2.0.4" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hast-util-whitespace": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/hast-util-whitespace/-/hast-util-whitespace-3.0.0.tgz", + "integrity": "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/hastscript": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/hastscript/-/hastscript-9.0.1.tgz", + "integrity": "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "comma-separated-tokens": "^2.0.0", + "hast-util-parse-selector": "^4.0.0", + "property-information": "^7.0.0", + "space-separated-tokens": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/html-escaper": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/html-escaper/-/html-escaper-3.0.3.tgz", + "integrity": "sha512-RuMffC89BOWQoY0WKGpIhn5gX3iI54O6nRA0yC124NYVtzjmFWBIiFd8M0x+ZdX0P9R4lADg1mgP8C7PxGOWuQ==", + "license": "MIT" + }, + "node_modules/html-void-elements": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/html-void-elements/-/html-void-elements-3.0.0.tgz", + "integrity": "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/http-cache-semantics": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/http-cache-semantics/-/http-cache-semantics-4.2.0.tgz", + "integrity": "sha512-dTxcvPXqPvXBQpq5dUr6mEMJX4oIEFv6bwom3FDwKRDsuIjjJGANqhBuoAn9c1RQJIdAKav33ED65E2ys+87QQ==", + "license": "BSD-2-Clause" + }, + "node_modules/iron-webcrypto": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/iron-webcrypto/-/iron-webcrypto-1.2.1.tgz", + "integrity": "sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/brc-dd" + } + }, + "node_modules/is-docker": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-4.0.0.tgz", + "integrity": "sha512-LHE+wROyG/Y/0ZnbktRCoTix2c1RhgWaZraMZ8o1Q7zCh0VSrICJQO5oqIIISrcSBtrXv0o233w1IYwsWCjTzA==", + "license": "MIT", + "bin": { + "is-docker": "cli.js" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-plain-obj": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz", + "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/is-unsafe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/is-unsafe/-/is-unsafe-2.0.0.tgz", + "integrity": "sha512-2LdV822R+wmI86unXA93WCFpL6g+av8ynWk0nrHyJqGop5VoocYsSLFgN8jrfalT6iGeLNM4KXuVSsULP53kEA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT" + }, + "node_modules/js-yaml": { + "version": "4.3.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.1.tgz", + "integrity": "sha512-CY6crGq313MX8GkwvB7tzgp99vjQxY1++5y10/BKN/GUfHqWaOGQMNZkBvqSzsZKWk/ijwHlWzzkLulsGHhjWQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/puzrin" + }, + { + "type": "github", + "url": "https://github.com/sponsors/nodeca" + } + ], + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/json-schema-traverse": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", + "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", + "dev": true, + "license": "MIT" + }, + "node_modules/jsonc-parser": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/jsonc-parser/-/jsonc-parser-3.3.1.tgz", + "integrity": "sha512-HUgH65KyejrUFPvHFPbqOY0rsFip3Bo5wb4ngvdi1EpCYWUQDC5V+Y7mZws+DLkr4M//zQJoanu1SP+87Dv1oQ==", + "license": "MIT" + }, + "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/lightningcss": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz", + "integrity": "sha512-WkUDrojuJs0xkgGf2udWxa3yGBRxPtxUkB79i6aCZLRgc7PM8fZe9TosfPDcvEpQZbuFASnHYmRLBLUbmLOIIA==", + "license": "MPL-2.0", + "dependencies": { + "detect-libc": "^2.0.3" + }, + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + }, + "optionalDependencies": { + "lightningcss-android-arm64": "1.33.0", + "lightningcss-darwin-arm64": "1.33.0", + "lightningcss-darwin-x64": "1.33.0", + "lightningcss-freebsd-x64": "1.33.0", + "lightningcss-linux-arm-gnueabihf": "1.33.0", + "lightningcss-linux-arm64-gnu": "1.33.0", + "lightningcss-linux-arm64-musl": "1.33.0", + "lightningcss-linux-x64-gnu": "1.33.0", + "lightningcss-linux-x64-musl": "1.33.0", + "lightningcss-win32-arm64-msvc": "1.33.0", + "lightningcss-win32-x64-msvc": "1.33.0" + } + }, + "node_modules/lightningcss-android-arm64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-android-arm64/-/lightningcss-android-arm64-1.33.0.tgz", + "integrity": "sha512-gEpRTalKdosp4Bb8qWtc2iOgE5SeIHlpS1up9bFq2wAyYhl1UdTObYiHe98zEM9SQvSoqQZ1IQD0JNpg3Ml5pg==", + "cpu": [ + "arm64" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-arm64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-arm64/-/lightningcss-darwin-arm64-1.33.0.tgz", + "integrity": "sha512-Sciaz8eenNTKn9b3t7+xr0ipTp9YxKQY4npwQ3mrRuL0BAVHBLyZxofhaKBAVtzmtRZ/zTyo0/to4B1uWG/Djg==", + "cpu": [ + "arm64" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-darwin-x64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-darwin-x64/-/lightningcss-darwin-x64-1.33.0.tgz", + "integrity": "sha512-Z5UPAxzrjlWNNyGy6i65cJzzvgJ5D3T6wMvs+gWpY9d7qRhANrxqAp6LhxIgZhWEw18RfJTGcRxjuLIBr+m8XQ==", + "cpu": [ + "x64" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-freebsd-x64": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-freebsd-x64/-/lightningcss-freebsd-x64-1.33.0.tgz", + "integrity": "sha512-QQM/Ti/hQajJwCY+RiWuCZ9sdtI/XQk7nDK5vC8kkdwixezOlDgvDx7+RT+QjK6FcFT4MpsuoBnHIo/O3StRRg==", + "cpu": [ + "x64" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm-gnueabihf": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm-gnueabihf/-/lightningcss-linux-arm-gnueabihf-1.33.0.tgz", + "integrity": "sha512-N7FVBe6iS24MlM6R/4RBTxGhQheZGs7tiQ9U32UtF75NzP5Q7xWPRqLBCKxlRQRk3rY1jCIPLzx7WzOhuUIRLQ==", + "cpu": [ + "arm" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-gnu": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-gnu/-/lightningcss-linux-arm64-gnu-1.33.0.tgz", + "integrity": "sha512-j2v/itmy4HlNxlc6voKXYgBqNi0Ng2LShg4z7GufpEgs05P+2suBVyi9I6YHq5uoVFx9ETin3eCEhLVyXGQnKg==", + "cpu": [ + "arm64" + ], + "libc": [ + "glibc" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-arm64-musl": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-arm64-musl/-/lightningcss-linux-arm64-musl-1.33.0.tgz", + "integrity": "sha512-yiO5ROMuYQgXbC60yjZU5CYSFZGKXL0HFATXt9mHJn1+zW55oCtMI9NfcVhYLMFDL7gV7oBPon/EmMMGg2OvtQ==", + "cpu": [ + "arm64" + ], + "libc": [ + "musl" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-gnu": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.33.0.tgz", + "integrity": "sha512-ar+Ju7LmcN0Jo4FpL4hpFybwNG9/3A/Br5KW2n2jyODg3MEZXaDYADdemoNS+BDNfMgKvylJLj4S5tyRActuAg==", + "cpu": [ + "x64" + ], + "libc": [ + "glibc" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-linux-x64-musl": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-musl/-/lightningcss-linux-x64-musl-1.33.0.tgz", + "integrity": "sha512-RYiYbkokw0trfKqqzfF55lginwEPrD3OJDfTuJzFs1MK6iFnDenaz1fqLLtX4ITG3OktJQXOeTaw1awrBAlZPw==", + "cpu": [ + "x64" + ], + "libc": [ + "musl" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-arm64-msvc": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-arm64-msvc/-/lightningcss-win32-arm64-msvc-1.33.0.tgz", + "integrity": "sha512-1K+MPfLSFVpphzpdbfkhlWk6wBrTObBzS2T6db10PNOZgR9GoVsAWzwNyuhUYYbTp23j+4RrncfujZ4uAzXvwA==", + "cpu": [ + "arm64" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/lightningcss-win32-x64-msvc": { + "version": "1.33.0", + "resolved": "https://registry.npmjs.org/lightningcss-win32-x64-msvc/-/lightningcss-win32-x64-msvc-1.33.0.tgz", + "integrity": "sha512-OlEICDx/Xl0FqSp4bry8zFnCvGpig3Gl4gCquvYwHuqJKEC1+n9NgDniFvqHGmMv1ZkqDJrDqKKSykTDX+ehuA==", + "cpu": [ + "x64" + ], + "license": "MPL-2.0", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">= 12.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/parcel" + } + }, + "node_modules/loglevel": { + "version": "1.9.2", + "resolved": "https://registry.npmjs.org/loglevel/-/loglevel-1.9.2.tgz", + "integrity": "sha512-HgMmCqIJSAKqo68l0rS2AanEWfkxaZ5wNiEFb5ggm08lDs9Xl2KxBlX3PTcaD2chBM1gXAYf491/M2Rv8Jwayg==", + "license": "MIT", + "engines": { + "node": ">= 0.6.0" + }, + "funding": { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/loglevel" + } + }, + "node_modules/lru-cache": { + "version": "11.5.2", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.2.tgz", + "integrity": "sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==", + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/magic-string": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-1.2.0.tgz", + "integrity": "sha512-ptco+HFxTLgjafSLim2LojBSwfg5feBjd+SqyiwdGkzC38UPdZy3zgrHMI2CoTf5fJL38tbHMYWVzIH8BxGqJw==", + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/magicast": { + "version": "0.5.4", + "resolved": "https://registry.npmjs.org/magicast/-/magicast-0.5.4.tgz", + "integrity": "sha512-llBEhWm1SacoRwgHUoQJYtwp4PBLF4faQi5TCpIGyGs9n4y5+juI0tDgyKIfpqxckRHaHzouUEph3THklWh03w==", + "license": "MIT", + "dependencies": { + "@babel/parser": "^7.29.7", + "@babel/types": "^7.29.7", + "source-map-js": "^1.2.1" + } + }, + "node_modules/mdast-util-to-hast": { + "version": "13.2.1", + "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz", + "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==", + "license": "MIT", + "dependencies": { + "@types/hast": "^3.0.0", + "@types/mdast": "^4.0.0", + "@ungap/structured-clone": "^1.0.0", + "devlop": "^1.0.0", + "micromark-util-sanitize-uri": "^2.0.0", + "trim-lines": "^3.0.0", + "unist-util-position": "^5.0.0", + "unist-util-visit": "^5.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/mdn-data": { + "version": "2.27.1", + "resolved": "https://registry.npmjs.org/mdn-data/-/mdn-data-2.27.1.tgz", + "integrity": "sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==", + "license": "CC0-1.0" + }, + "node_modules/micromark-util-character": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz", + "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-symbol": "^2.0.0", + "micromark-util-types": "^2.0.0" + } + }, + "node_modules/micromark-util-encode": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz", + "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-sanitize-uri": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz", + "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT", + "dependencies": { + "micromark-util-character": "^2.0.0", + "micromark-util-encode": "^2.0.0", + "micromark-util-symbol": "^2.0.0" + } + }, + "node_modules/micromark-util-symbol": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz", + "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/micromark-util-types": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.2.tgz", + "integrity": "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA==", + "funding": [ + { + "type": "GitHub Sponsors", + "url": "https://github.com/sponsors/unifiedjs" + }, + { + "type": "OpenCollective", + "url": "https://opencollective.com/unified" + } + ], + "license": "MIT" + }, + "node_modules/miniflare": { + "version": "5.20260811.1-alpha", + "resolved": "https://registry.npmjs.org/miniflare/-/miniflare-5.20260811.1-alpha.tgz", + "integrity": "sha512-DtOG0BeanIxs2sH0smFvExZD89cBQwGckbHiFkRJrrNAUu3NGClZkUxqu+zy7HYfKBAgq935EMY49vIPm3JVdA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@cspotcode/source-map-support": "0.8.1", + "sharp": "0.35.2", + "undici": "7.29.0", + "workerd": "1.20260811.1", + "ws": "8.21.0", + "youch": "4.1.0-beta.10" + }, + "engines": { + "node": ">=22.0.0" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-darwin-arm64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-arm64/-/sharp-darwin-arm64-0.35.2.tgz", + "integrity": "sha512-eEieHsMksAW4IiO5NzauESRl2D2qz3J/kwUxUrSfV06A93eEaRfMpHXyUb1mAqrR7i8U9A0GRqE9pjn6u1Jjpg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-arm64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-darwin-x64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-darwin-x64/-/sharp-darwin-x64-0.35.2.tgz", + "integrity": "sha512-BaktuGPCeHJMARpodR8jK4uKiZrPAy9WrfQW0sdI37clracq8Bp01AYS3SZgi5FS/y5twa9t4+LIuuxQjqRrWw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-darwin-x64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-freebsd-wasm32": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-freebsd-wasm32/-/sharp-freebsd-wasm32-0.35.2.tgz", + "integrity": "sha512-YoAxdnd8hPUkvLHd3bWY+YA8nw3xM/RyRopYucNsWHVSan8NLVM3X2volsfoRDcXdUJPg6tXahSd7HXPK7lRnw==", + "dev": true, + "license": "Apache-2.0", + "optional": true, + "os": [ + "freebsd" + ], + "dependencies": { + "@img/sharp-wasm32": "0.35.2" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-darwin-arm64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-arm64/-/sharp-libvips-darwin-arm64-1.3.1.tgz", + "integrity": "sha512-4V/M3roRMTYjiwZY9IOVQOE8OyeCxFAkYmyZDrZl51uOKjibm3oeEJ4WAmLxutAfzFbC9jqUiPs2gbnGflH+7g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-darwin-x64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-darwin-x64/-/sharp-libvips-darwin-x64-1.3.1.tgz", + "integrity": "sha512-c0/DxItpJv2+dGhgycJBBgotdqruGYDvA79drdh0MD1dFpy7JzJ/PlXwi1H4rFf0eTy8tgbI91aHDnZIceY3jQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "darwin" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linux-arm": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm/-/sharp-libvips-linux-arm-1.3.1.tgz", + "integrity": "sha512-aGGy9aWzXgHBG7HNyQPWorZthlp7+x6fDRoPAQbGO3ThcttuTyKIx3NuSHb6zb4gBNq6/yNn9f1cy9nFKS/Vmg==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linux-arm64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-arm64/-/sharp-libvips-linux-arm64-1.3.1.tgz", + "integrity": "sha512-JznefmcK9j1JKPz8AkQDh89kjojubyfOasWBPKfzMIhPwsgDy9evpE/naJTXXXmghS1iFwR8u/kTwh/I2/+GCw==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linux-ppc64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-ppc64/-/sharp-libvips-linux-ppc64-1.3.1.tgz", + "integrity": "sha512-1EkwGNCZk6iWNCMWqrvdJ+r1j0PT1zIz60CNPhYnJlK/zyeWqlsPZIe+ocBVqPF8k/Ssee/NCk+tE9Ryrko6ng==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linux-riscv64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-riscv64/-/sharp-libvips-linux-riscv64-1.3.1.tgz", + "integrity": "sha512-Ilays+w2bXdnxzxtQdmXR62u8o8GYa3eL4+Gr+1KiE4xperMZUslRaVPJwwPkzlHEjGfXAfRVAa/7CYCtSqsBw==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linux-s390x": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-s390x/-/sharp-libvips-linux-s390x-1.3.1.tgz", + "integrity": "sha512-VfBwVHQTbRoj4XlpA/KLZ7ltgMpz+4WSejFzQ+GnoImjo1PtEJ59QB2qR1xQEeRPYIkNrPIm2L4cICMvz4C2ew==", + "cpu": [ + "s390x" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linux-x64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linux-x64/-/sharp-libvips-linux-x64-1.3.1.tgz", + "integrity": "sha512-+c8ukgwU62DS54nCAjw7keOfHUkmr0B5QHEdcOqRnodF/MNXJbVI8Eopoj4B/0H8Asr65I+A4Amrn7a85/md6A==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linuxmusl-arm64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-arm64/-/sharp-libvips-linuxmusl-arm64-1.3.1.tgz", + "integrity": "sha512-qlKb/pwbkAi1WMsJrYHk7CuDrd12s27U2QnRhFYUoJNrRCmkosMTttuRFat/DDB3IlDm5qE1TJgZ4JDnHX8Ldw==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-libvips-linuxmusl-x64": { + "version": "1.3.1", + "resolved": "https://registry.npmjs.org/@img/sharp-libvips-linuxmusl-x64/-/sharp-libvips-linuxmusl-x64-1.3.1.tgz", + "integrity": "sha512-yO21HwoUVLN8Qa+/SBjQLMYwBWAVJjeGPNe+hc0OUeMeifEtJqu5a1c4HayE1nNpDih9y3/KkoltfkDodmKAlg==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "LGPL-3.0-or-later", + "optional": true, + "os": [ + "linux" + ], + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linux-arm": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm/-/sharp-linux-arm-0.35.2.tgz", + "integrity": "sha512-SE4kzF2mepn6z+6E7L6lsV8FzuLL6IPQdyX8ZiwROAG/G8td+hP/m7FsFPwidtrF19gvajuC9l6TxAVcsA4S7A==", + "cpu": [ + "arm" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linux-arm64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-arm64/-/sharp-linux-arm64-0.35.2.tgz", + "integrity": "sha512-af12Pnd0ZGu2HfP8NayB0kk6eC/lrfbQE6HlR4jD+34wdJ1Vw9TF6TMn6ZvffT+WgqVsl0hRbmNvz2u/23VmwA==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-arm64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linux-ppc64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-ppc64/-/sharp-linux-ppc64-0.35.2.tgz", + "integrity": "sha512-hYSBm7zcNtDCozCxQHYZJiu63b/bXsgRZuOxCIBZsStMM9Vap47iFHdbX4kCvQsblPB/k+clhELpdQJHQLSHvg==", + "cpu": [ + "ppc64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-ppc64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linux-riscv64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-riscv64/-/sharp-linux-riscv64-0.35.2.tgz", + "integrity": "sha512-qQt0Kc13+Hoan/Awq/qMSQw3L+RI1NCRPgD5cUJ/1WSSmIoysLOc72jlRM3E0OHN9Yr313jgeQ2T+zW+F03QFA==", + "cpu": [ + "riscv64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-riscv64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linux-s390x": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-s390x/-/sharp-linux-s390x-0.35.2.tgz", + "integrity": "sha512-E4fLLfRPzDLlEeDaTzI98OFLcv++WL5ChLLMwPoVd0CIoZQqupBSNbOisPL5am9XsbQ9T84+iiMpUvbFtkunbA==", + "cpu": [ + "s390x" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-s390x": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linux-x64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linux-x64/-/sharp-linux-x64-0.35.2.tgz", + "integrity": "sha512-gi0zFJJRLswfCZmHtJdikXPOc5u7qamSOS3NHedLqLd4W8Q0NqjdBr6TTRIgsfFjqfTsHFgdfvJ9LwqSgcHiAA==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "glibc" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linux-x64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linuxmusl-arm64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-arm64/-/sharp-linuxmusl-arm64-0.35.2.tgz", + "integrity": "sha512-siWbOW1u6HFnFLrp0waKyW7VEf7jYvcDWdrXEFa8AkdAQgEvuu5Fz8/Y70w9EeqAdwDtfU012BhEHHaDqvQNzg==", + "cpu": [ + "arm64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-arm64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-linuxmusl-x64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-linuxmusl-x64/-/sharp-linuxmusl-x64-0.35.2.tgz", + "integrity": "sha512-YBqMMcjDi4QGYiSn4vNOYBhmlC4z5AXqkOUUqI2e0AFA4urNv4ESgOgwNl3K+4etQhha0twXlzeF20bbULm9Yg==", + "cpu": [ + "x64" + ], + "dev": true, + "libc": [ + "musl" + ], + "license": "Apache-2.0", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-libvips-linuxmusl-x64": "1.3.1" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-wasm32": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-wasm32/-/sharp-wasm32-0.35.2.tgz", + "integrity": "sha512-Mrv4JQNYVQ94xH+jzZ9r+gowleN8mv2FTgKT+PI6bx5C0G8TdNYndu161pg2i7uoBwxy2ImPMHrJOM2LZef7Bw==", + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later AND MIT", + "optional": true, + "dependencies": { + "@emnapi/runtime": "^1.11.1" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-webcontainers-wasm32": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-webcontainers-wasm32/-/sharp-webcontainers-wasm32-0.35.2.tgz", + "integrity": "sha512-QNV27pxs9wpApEiCfvHM1RDoP1w1+2KrUWWDPEhEwg+latvOrfuhWrHWZKwdSFwU6jh3myjw/yOCRsUIuOft3g==", + "cpu": [ + "wasm32" + ], + "dev": true, + "license": "Apache-2.0", + "optional": true, + "dependencies": { + "@img/sharp-wasm32": "0.35.2" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-win32-arm64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-arm64/-/sharp-win32-arm64-0.35.2.tgz", + "integrity": "sha512-BiVRYc/t6/Vl3e1hBx0hugG4oN9Pydf4fgMSpxTQJmwGUg/YoXTWHiFeRymHfCZzifxu4F4rpk/I67D0LQ20wQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-win32-ia32": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-ia32/-/sharp-win32-ia32-0.35.2.tgz", + "integrity": "sha512-YYEhx9PImCC7T0tI8JDMi4DB9LwLCXCU5OWNYEXAxh5Q1ShKkyC6byxzoBJ3gEFDnH2lQckWuDe70G7mB2XJog==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": "^20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/@img/sharp-win32-x64": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/@img/sharp-win32-x64/-/sharp-win32-x64-0.35.2.tgz", + "integrity": "sha512-imoOyBcoM/iiUr4J6VPpCNjPnjvP/Gks95898yB8YqoGGYmHYbOyCuNv9FMhFgtaiHFGbHW8bxKqRV6VjtXThQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "Apache-2.0 AND LGPL-3.0-or-later", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + } + }, + "node_modules/miniflare/node_modules/sharp": { + "version": "0.35.2", + "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.35.2.tgz", + "integrity": "sha512-FVtFjtBCMiJS6yb5CX7Sop45WFMpeGw6oRKuJnXYgf/f1ms/D7LE/ZUSNxnW7rZ/dbslQWYkoqFHGPaDBtaK4w==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "@img/colour": "^1.1.0", + "detect-libc": "^2.1.2", + "semver": "^7.8.4" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-darwin-arm64": "0.35.2", + "@img/sharp-darwin-x64": "0.35.2", + "@img/sharp-freebsd-wasm32": "0.35.2", + "@img/sharp-libvips-darwin-arm64": "1.3.1", + "@img/sharp-libvips-darwin-x64": "1.3.1", + "@img/sharp-libvips-linux-arm": "1.3.1", + "@img/sharp-libvips-linux-arm64": "1.3.1", + "@img/sharp-libvips-linux-ppc64": "1.3.1", + "@img/sharp-libvips-linux-riscv64": "1.3.1", + "@img/sharp-libvips-linux-s390x": "1.3.1", + "@img/sharp-libvips-linux-x64": "1.3.1", + "@img/sharp-libvips-linuxmusl-arm64": "1.3.1", + "@img/sharp-libvips-linuxmusl-x64": "1.3.1", + "@img/sharp-linux-arm": "0.35.2", + "@img/sharp-linux-arm64": "0.35.2", + "@img/sharp-linux-ppc64": "0.35.2", + "@img/sharp-linux-riscv64": "0.35.2", + "@img/sharp-linux-s390x": "0.35.2", + "@img/sharp-linux-x64": "0.35.2", + "@img/sharp-linuxmusl-arm64": "0.35.2", + "@img/sharp-linuxmusl-x64": "0.35.2", + "@img/sharp-webcontainers-wasm32": "0.35.2", + "@img/sharp-win32-arm64": "0.35.2", + "@img/sharp-win32-ia32": "0.35.2", + "@img/sharp-win32-x64": "0.35.2" + } + }, + "node_modules/miniflare/node_modules/undici": { + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-7.29.0.tgz", + "integrity": "sha512-IDxfleLmmbSskfWSUATiN1nfn2rDuvnMOqb5CWR92iIfojA0Ud+ulOAAEQ57LPr9rWmsreUyf5lwyao+7GNNVw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20.18.1" + } + }, + "node_modules/mrmime": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/mrmime/-/mrmime-2.0.1.tgz", + "integrity": "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ==", + "license": "MIT", + "engines": { + "node": ">=10" + } + }, + "node_modules/muggle-string": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/muggle-string/-/muggle-string-0.4.1.tgz", + "integrity": "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.18", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.18.tgz", + "integrity": "sha512-DTg4MJbGMWkfi6VZFdNt2/caMbQy4Ou+Op/hJQvGEWcnVfoA1QA+xzRKAzw9jD6+GVOOeYr/mIcuDSdug6F6+w==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/neotraverse": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/neotraverse/-/neotraverse-1.0.1.tgz", + "integrity": "sha512-WmmLty1YWwJl9yZi77v2dVIV6X2kuYV8YYBI/G3LWGKdGHmHUvL1z7FW0iDvEvGAwNEoc5x1tOOOyDnf5jJw/w==", + "license": "MIT", + "engines": { + "node": ">= 10" + } + }, + "node_modules/nlcst-to-string": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/nlcst-to-string/-/nlcst-to-string-4.0.0.tgz", + "integrity": "sha512-YKLBCcUYKAg0FNlOBT6aI91qFmSiFKiluk655WzPF+DDMA02qIyy8uiRqI8QXtcFpEvll12LpL5MXqEmAZ+dcA==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/node-fetch-native": { + "version": "1.6.7", + "resolved": "https://registry.npmjs.org/node-fetch-native/-/node-fetch-native-1.6.7.tgz", + "integrity": "sha512-g9yhqoedzIUm0nTnTqAQvueMPVOuIY16bqgAJJC8XOOubYFNwz6IER9qs0Gq2Xd0+CecCKFjtdDTMA4u4xG06Q==", + "license": "MIT" + }, + "node_modules/node-mock-http": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/node-mock-http/-/node-mock-http-1.0.5.tgz", + "integrity": "sha512-KQyt/wLjG3TAc7DOUhpqWzgd4ERxR80JOlTK5VE5R1S12IaPVN5qkj4klBce9HPG1Njuup4Sb5bljaT34lIyjw==", + "license": "MIT" + }, + "node_modules/normalize-path": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", + "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/nth-check": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz", + "integrity": "sha512-lqjrjmaOoAnWfMmBPL+XNnynZh2+swxiX3WUE0s4yEHI6m+AwrK2UZOimIRl3X/4QctVqS8AiZjFqyOGrMXb/w==", + "license": "BSD-2-Clause", + "dependencies": { + "boolbase": "^1.0.0" + }, + "funding": { + "url": "https://github.com/fb55/nth-check?sponsor=1" + } + }, + "node_modules/obug": { + "version": "2.1.4", + "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.4.tgz", + "integrity": "sha512-4a+OsYv9UktOJKE+l1A4OufDgdRF9PifWj+tJnHURo/P+WOxpG4GzUFL9qCalmWauao6ogiG+QvnCovwPoyAWA==", + "funding": [ + "https://github.com/sponsors/sxzz", + "https://opencollective.com/debug" + ], + "license": "MIT", + "engines": { + "node": ">=12.20.0" + } + }, + "node_modules/ofetch": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/ofetch/-/ofetch-1.5.1.tgz", + "integrity": "sha512-2W4oUZlVaqAPAil6FUg/difl6YhqhUR7x2eZY4bQCko22UXg3hptq9KLQdqFClV+Wu85UX7hNtdGTngi/1BxcA==", + "license": "MIT", + "dependencies": { + "destr": "^2.0.5", + "node-fetch-native": "^1.6.7", + "ufo": "^1.6.1" + } + }, + "node_modules/ohash": { + "version": "2.0.12", + "resolved": "https://registry.npmjs.org/ohash/-/ohash-2.0.12.tgz", + "integrity": "sha512-65S/5gk9YSsaRjcyf7Nfa6h/d3E8/1gslpXfI4W7Dxn/oap8IKRuNT5VXkLQ1YFKIEg4apRY4Pj6aiwFzrDdmw==", + "license": "MIT" + }, + "node_modules/oniguruma-parser": { + "version": "0.12.2", + "resolved": "https://registry.npmjs.org/oniguruma-parser/-/oniguruma-parser-0.12.2.tgz", + "integrity": "sha512-6HVa5oIrgMC6aA6WF6XyyqbhRPJrKR02L20+2+zpDtO5QAzGHAUGw5TKQvwi5vctNnRHkJYmjAhRVQF2EKdTQw==", + "license": "MIT" + }, + "node_modules/oniguruma-to-es": { + "version": "4.3.6", + "resolved": "https://registry.npmjs.org/oniguruma-to-es/-/oniguruma-to-es-4.3.6.tgz", + "integrity": "sha512-csuQ9x3Yr0cEIs/Zgx/OEt9iBw9vqIunAPQkx19R/fiMq2oGVTgcMqO/V3Ybqefr1TBvosI6jU539ksaBULJyA==", + "license": "MIT", + "dependencies": { + "oniguruma-parser": "^0.12.2", + "regex": "^6.1.0", + "regex-recursion": "^6.0.2" + } + }, + "node_modules/p-limit": { + "version": "7.3.1", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-7.3.1.tgz", + "integrity": "sha512-0trZaiG7Y7kN/Egy9a8j47t9osC0Tch4PaIWd9yGF6bvmlk7muExRvGNYb8sXBwEKMoNKsbNN9P8EefuQekE4Q==", + "license": "MIT", + "dependencies": { + "yocto-queue": "^1.2.1" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-queue": { + "version": "9.3.3", + "resolved": "https://registry.npmjs.org/p-queue/-/p-queue-9.3.3.tgz", + "integrity": "sha512-NXAOdnEe5FsZJfT4oK84lE1Y5cFFdWlRuOo5tww8DyNMxyRXwn39fIkUtNLKppcPC+UYU/bXujNCUGDv01y7CA==", + "license": "MIT", + "dependencies": { + "eventemitter3": "^5.0.4", + "p-timeout": "^7.0.0" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/p-timeout": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-7.0.1.tgz", + "integrity": "sha512-AxTM2wDGORHGEkPCt8yqxOTMgpfbEHqF51f/5fJCmwFC3C/zNcGT63SymH2ttOAaiIws2zVg4+izQCjrakcwHg==", + "license": "MIT", + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/package-manager-detector": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-1.8.0.tgz", + "integrity": "sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A==", + "license": "MIT" + }, + "node_modules/parse5": { + "version": "7.3.0", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz", + "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==", + "license": "MIT", + "dependencies": { + "entities": "^6.0.0" + }, + "funding": { + "url": "https://github.com/inikulin/parse5?sponsor=1" + } + }, + "node_modules/path-browserify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz", + "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==", + "dev": true, + "license": "MIT" + }, + "node_modules/path-expression-matcher": { + "version": "1.6.2", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.6.2.tgz", + "integrity": "sha512-enSlaiat05iasnzmgNxRj8reFdj3puY2QpNgP1aPIaVfT6nn9ICuPoFlKHk8EN22HcwewshO+mN2DGbkCEOtqQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "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/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/piccolore": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/piccolore/-/piccolore-0.1.3.tgz", + "integrity": "sha512-o8bTeDWjE086iwKrROaDf31K0qC/BENdm15/uH9usSC/uZjJOKb2YGiVHfLY4GhwsERiPI1jmwI2XrA7ACOxVw==", + "license": "ISC" + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz", + "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==", + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/playwright": { + "version": "1.62.1", + "resolved": "https://registry.npmjs.org/playwright/-/playwright-1.62.1.tgz", + "integrity": "sha512-0M+L3LAD8/nm554LOla9Ayx0j0tmFZ0FBcoQ7F1VuVHpM/XpiC8RcDzBQB8W5+hA8L22THxELzeF+2WcUzvcLg==", + "dev": true, + "license": "Apache-2.0", + "dependencies": { + "playwright-core": "1.62.1" + }, + "bin": { + "playwright": "cli.js" + }, + "engines": { + "node": ">=20" + }, + "optionalDependencies": { + "fsevents": "2.3.2" + } + }, + "node_modules/playwright-core": { + "version": "1.62.1", + "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.62.1.tgz", + "integrity": "sha512-wPYSwEBJY9GHraISXqyqtx0na0LpO3XEX7jNDhntbex7tzUS7kLnZsOlFruFJB4Hi/rhDMjXGqHewDZ68nYZVw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "playwright-core": "cli.js" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/postcss": { + "version": "8.5.26", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz", + "integrity": "sha512-u82N74LFzG8ca+dD8puPnplTXoGH4fTPpVGuIbt36G3qvNlkvfD0lEAZSxaly3KX8TS/L1A1gsCEmvKmBcVbkQ==", + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.17", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/prettier": { + "version": "3.9.6", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.9.6.tgz", + "integrity": "sha512-OpN0zzVdiaiAhxpuuj5efpIS4sY9j7bY6uR5mnj5yPzGkdkjNKSJeUThPb60Jw29QuAZgA4o+/iB49kFiaBX6g==", + "dev": true, + "license": "MIT", + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, + "node_modules/prettier-plugin-astro": { + "version": "0.14.1", + "resolved": "https://registry.npmjs.org/prettier-plugin-astro/-/prettier-plugin-astro-0.14.1.tgz", + "integrity": "sha512-RiBETaaP9veVstE4vUwSIcdATj6dKmXljouXc/DDNwBSPTp8FRkLGDSGFClKsAFeeg+13SB0Z1JZvbD76bigJw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@astrojs/compiler": "^2.9.1", + "prettier": "^3.0.0", + "sass-formatter": "^0.7.6" + }, + "engines": { + "node": "^14.15.0 || >=16.0.0" + } + }, + "node_modules/prismjs": { + "version": "1.30.0", + "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz", + "integrity": "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==", + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/process-ancestry": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/process-ancestry/-/process-ancestry-0.1.0.tgz", + "integrity": "sha512-tGqJW/UnclpYASFcM6Xh8D8l/BMtaQ9+CSG0vlJSJTcdMM4lDRv4c6H0Pdcsfted+bVczdYSfk2fdukg2gQkZg==", + "license": "MIT", + "engines": { + "node": ">=18.0.0" + } + }, + "node_modules/property-information": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.2.0.tgz", + "integrity": "sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/radix3": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/radix3/-/radix3-1.1.2.tgz", + "integrity": "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA==", + "license": "MIT" + }, + "node_modules/readdirp": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz", + "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 14.18.0" + }, + "funding": { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/regex": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/regex/-/regex-6.1.0.tgz", + "integrity": "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-recursion": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/regex-recursion/-/regex-recursion-6.0.2.tgz", + "integrity": "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg==", + "license": "MIT", + "dependencies": { + "regex-utilities": "^2.3.0" + } + }, + "node_modules/regex-utilities": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/regex-utilities/-/regex-utilities-2.3.0.tgz", + "integrity": "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng==", + "license": "MIT" + }, + "node_modules/request-light": { + "version": "0.7.0", + "resolved": "https://registry.npmjs.org/request-light/-/request-light-0.7.0.tgz", + "integrity": "sha512-lMbBMrDoxgsyO+yB3sDcrDuX85yYt7sS8BfQd11jtbW/z5ZWgLZRcEGLsLoYw7I0WSUGQBs8CC8ScIxkTX1+6Q==", + "dev": true, + "license": "MIT" + }, + "node_modules/require-from-string": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", + "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/resolve-pkg-maps": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz", + "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==", + "license": "MIT", + "funding": { + "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1" + } + }, + "node_modules/retext-smartypants": { + "version": "6.2.0", + "resolved": "https://registry.npmjs.org/retext-smartypants/-/retext-smartypants-6.2.0.tgz", + "integrity": "sha512-kk0jOU7+zGv//kfjXEBjdIryL1Acl4i9XNkHxtM7Tm5lFiCog576fjNC9hjoR7LTKQ0DsPWy09JummSsH1uqfQ==", + "license": "MIT", + "dependencies": { + "@types/nlcst": "^2.0.0", + "nlcst-to-string": "^4.0.0", + "unist-util-visit": "^5.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/rolldown": { + "version": "1.2.4", + "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.2.4.tgz", + "integrity": "sha512-rSr7irW0K7QRWzjdJXqZowkcRdDtjRduh43rBltnVKd0VFq839l1lJoDvGJb6gl7+4rTTCrPWu+YfujUL8Ug7w==", + "license": "MIT", + "dependencies": { + "@oxc-project/types": "=0.144.0", + "@rolldown/pluginutils": "^1.0.0" + }, + "bin": { + "rolldown": "bin/cli.mjs" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "optionalDependencies": { + "@rolldown/binding-android-arm64": "1.2.4", + "@rolldown/binding-darwin-arm64": "1.2.4", + "@rolldown/binding-darwin-x64": "1.2.4", + "@rolldown/binding-freebsd-x64": "1.2.4", + "@rolldown/binding-linux-arm-gnueabihf": "1.2.4", + "@rolldown/binding-linux-arm64-gnu": "1.2.4", + "@rolldown/binding-linux-arm64-musl": "1.2.4", + "@rolldown/binding-linux-ppc64-gnu": "1.2.4", + "@rolldown/binding-linux-s390x-gnu": "1.2.4", + "@rolldown/binding-linux-x64-gnu": "1.2.4", + "@rolldown/binding-linux-x64-musl": "1.2.4", + "@rolldown/binding-openharmony-arm64": "1.2.4", + "@rolldown/binding-win32-arm64-msvc": "1.2.4", + "@rolldown/binding-win32-x64-msvc": "1.2.4" + } + }, + "node_modules/s.color": { + "version": "0.0.15", + "resolved": "https://registry.npmjs.org/s.color/-/s.color-0.0.15.tgz", + "integrity": "sha512-AUNrbEUHeKY8XsYr/DYpl+qk5+aM+DChopnWOPEzn8YKzOhv4l2zH6LzZms3tOZP3wwdOyc0RmTciyi46HLIuA==", + "dev": true, + "license": "MIT" + }, + "node_modules/sass-formatter": { + "version": "0.7.9", + "resolved": "https://registry.npmjs.org/sass-formatter/-/sass-formatter-0.7.9.tgz", + "integrity": "sha512-CWZ8XiSim+fJVG0cFLStwDvft1VI7uvXdCNJYXhDvowiv+DsbD1nXLiQ4zrE5UBvj5DWZJ93cwN0NX5PMsr1Pw==", + "dev": true, + "license": "MIT", + "dependencies": { + "suf-log": "^2.5.3" + } + }, + "node_modules/satteri": { + "version": "0.9.5", + "resolved": "https://registry.npmjs.org/satteri/-/satteri-0.9.5.tgz", + "integrity": "sha512-ZuWVl+vnM64y+/TtX8Kosv2c00W+hLQiiwnEL6H0UKVVrxFqMw4D2CJHHQaouVd89OAhtBBfjWLqhKi3TVUV4w==", + "license": "MIT", + "dependencies": { + "@types/estree-jsx": "^1.0.5", + "@types/hast": "^3.0.4", + "@types/mdast": "^4.0.4", + "@types/unist": "^3.0.3" + }, + "optionalDependencies": { + "@bruits/satteri-darwin-arm64": "0.9.5", + "@bruits/satteri-darwin-x64": "0.9.5", + "@bruits/satteri-linux-arm64-gnu": "0.9.5", + "@bruits/satteri-linux-arm64-musl": "0.9.5", + "@bruits/satteri-linux-x64-gnu": "0.9.5", + "@bruits/satteri-linux-x64-musl": "0.9.5", + "@bruits/satteri-wasm32-wasi": "0.9.5", + "@bruits/satteri-win32-arm64-msvc": "0.9.5", + "@bruits/satteri-win32-x64-msvc": "0.9.5" + } + }, + "node_modules/sax": { + "version": "1.6.1", + "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.1.tgz", + "integrity": "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==", + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=11.0.0" + } + }, + "node_modules/semver": { + "version": "7.8.5", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz", + "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==", + "license": "ISC", + "bin": { + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/sharp": { + "version": "0.35.3", + "resolved": "https://registry.npmjs.org/sharp/-/sharp-0.35.3.tgz", + "integrity": "sha512-ej0zVHuZGHCiABXcNxeYhpRnPNPAcvbG8RMdBAhDAxLKkCRVSpK3Iyu7qbqw3JMzoj0REeM6f3tJLtVwl0023Q==", + "devOptional": true, + "license": "Apache-2.0", + "dependencies": { + "@img/colour": "^1.1.0", + "detect-libc": "^2.1.2", + "semver": "^7.8.5" + }, + "engines": { + "node": ">=20.9.0" + }, + "funding": { + "url": "https://opencollective.com/libvips" + }, + "optionalDependencies": { + "@img/sharp-darwin-arm64": "0.35.3", + "@img/sharp-darwin-x64": "0.35.3", + "@img/sharp-freebsd-wasm32": "0.35.3", + "@img/sharp-libvips-darwin-arm64": "1.3.2", + "@img/sharp-libvips-darwin-x64": "1.3.2", + "@img/sharp-libvips-linux-arm": "1.3.2", + "@img/sharp-libvips-linux-arm64": "1.3.2", + "@img/sharp-libvips-linux-ppc64": "1.3.2", + "@img/sharp-libvips-linux-riscv64": "1.3.2", + "@img/sharp-libvips-linux-s390x": "1.3.2", + "@img/sharp-libvips-linux-x64": "1.3.2", + "@img/sharp-libvips-linuxmusl-arm64": "1.3.2", + "@img/sharp-libvips-linuxmusl-x64": "1.3.2", + "@img/sharp-linux-arm": "0.35.3", + "@img/sharp-linux-arm64": "0.35.3", + "@img/sharp-linux-ppc64": "0.35.3", + "@img/sharp-linux-riscv64": "0.35.3", + "@img/sharp-linux-s390x": "0.35.3", + "@img/sharp-linux-x64": "0.35.3", + "@img/sharp-linuxmusl-arm64": "0.35.3", + "@img/sharp-linuxmusl-x64": "0.35.3", + "@img/sharp-webcontainers-wasm32": "0.35.3", + "@img/sharp-win32-arm64": "0.35.3", + "@img/sharp-win32-ia32": "0.35.3", + "@img/sharp-win32-x64": "0.35.3" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + } + } + }, + "node_modules/shiki": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/shiki/-/shiki-4.4.3.tgz", + "integrity": "sha512-Mb/GvXPHBAXdgGIcnfU5L3ldpn1XcxrGkPHwqgRx17/I2XRfqlFKk2vGkHWINn1kdXvzJZeuO3is6I9KLPFm0g==", + "license": "MIT", + "dependencies": { + "@shikijs/core": "4.4.3", + "@shikijs/engine-javascript": "4.4.3", + "@shikijs/engine-oniguruma": "4.4.3", + "@shikijs/langs": "4.4.3", + "@shikijs/themes": "4.4.3", + "@shikijs/types": "4.4.3", + "@shikijs/vscode-textmate": "^10.0.2", + "@types/hast": "^3.0.5" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/siginfo": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz", + "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==", + "dev": true, + "license": "ISC" + }, + "node_modules/sisteransi": { + "version": "1.0.5", + "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", + "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==", + "license": "MIT" + }, + "node_modules/sitemap": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/sitemap/-/sitemap-9.0.1.tgz", + "integrity": "sha512-S6hzjGJSG3d6if0YoF5kTyeRJvia6FSTBroE5fQ0bu1QNxyJqhhinfUsXi9fH3MgtXODWvwo2BDyQSnhPQ88uQ==", + "license": "MIT", + "dependencies": { + "@types/node": "^24.9.2", + "@types/sax": "^1.2.1", + "arg": "^5.0.0", + "sax": "^1.4.1" + }, + "bin": { + "sitemap": "dist/esm/cli.js" + }, + "engines": { + "node": ">=20.19.5", + "npm": ">=10.8.2" + } + }, + "node_modules/smol-toml": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.8.0.tgz", + "integrity": "sha512-kCZr2V3ch9i00x8zXRhjUNVcjG9ijES5dDudkXvUVCT5QlJNQWElSJdZqyPemffHoLNUYwOcou0Fy+ojN0uHSQ==", + "license": "BSD-3-Clause", + "engines": { + "node": ">= 18" + }, + "funding": { + "url": "https://github.com/sponsors/cyyynthia" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/space-separated-tokens": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz", + "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/stackback": { + "version": "0.0.2", + "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz", + "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==", + "dev": true, + "license": "MIT" + }, + "node_modules/std-env": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.2.0.tgz", + "integrity": "sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw==", + "dev": true, + "license": "MIT" + }, + "node_modules/stream-replace-string": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/stream-replace-string/-/stream-replace-string-2.0.0.tgz", + "integrity": "sha512-TlnjJ1C0QrmxRNrON00JvaFFlNh5TTG00APw23j74ET7gkQpTASi6/L2fuiav8pzK715HXtUeClpBTw2NPSn6w==", + "license": "MIT" + }, + "node_modules/string-width": { + "version": "8.2.2", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-8.2.2.tgz", + "integrity": "sha512-GaPUh5gfdrYzqeVNZvUfT23vYYxXzKYidUcnMtJg/3rxRV63EFZy3k6xfKlmfeJD0176lnUV/Usr3XcwSvFzpg==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-east-asian-width": "^1.5.0", + "strip-ansi": "^7.1.2" + }, + "engines": { + "node": ">=20" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/stringify-entities": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz", + "integrity": "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==", + "license": "MIT", + "dependencies": { + "character-entities-html4": "^2.0.0", + "character-entities-legacy": "^3.0.0" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/strip-ansi": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.2.0.tgz", + "integrity": "sha512-yDPMNjp4WyfYBkHnjIRLfca1i6KMyGCtsVgoKe/z1+6vukgaENdgGBZt+ZmKPc4gavvEZ5OgHfHdrazhgNyG7w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.2.2" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, + "node_modules/strnum": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.4.2.tgz", + "integrity": "sha512-rDG3Ah4TV0k1hWvLSzkZtMmLN9+eS+h3knq4MP6A42Y3Yh5qGNnOUs1jJkoSr8FG5dsL28c7KgkIBzSEykqtuw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT", + "dependencies": { + "anynum": "^1.0.1" + } + }, + "node_modules/suf-log": { + "version": "2.5.3", + "resolved": "https://registry.npmjs.org/suf-log/-/suf-log-2.5.3.tgz", + "integrity": "sha512-KvC8OPjzdNOe+xQ4XWJV2whQA0aM1kGVczMQ8+dStAO6KfEB140JEVQ9dE76ONZ0/Ylf67ni4tILPJB41U0eow==", + "dev": true, + "license": "MIT", + "dependencies": { + "s.color": "0.0.15" + } + }, + "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==", + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/svgo": { + "version": "4.0.2", + "resolved": "https://registry.npmjs.org/svgo/-/svgo-4.0.2.tgz", + "integrity": "sha512-ekx94z1rRc5LDi6oSUaeRnYhd0UOJxdtQCL2rF8xpWxD3TPAsISWOrxezqGovqS38GRZOdpDfvQe3ts6F7nsng==", + "license": "MIT", + "dependencies": { + "commander": "^11.1.0", + "css-select": "^5.1.0", + "css-tree": "^3.0.1", + "css-what": "^6.1.0", + "csso": "^5.0.5", + "picocolors": "^1.1.1", + "sax": "^1.5.0" + }, + "bin": { + "svgo": "bin/svgo.js" + }, + "engines": { + "node": ">=16" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/svgo" + } + }, + "node_modules/svgo/node_modules/commander": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz", + "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==", + "license": "MIT", + "engines": { + "node": ">=16" + } + }, + "node_modules/tiny-inflate": { + "version": "1.0.3", + "resolved": "https://registry.npmjs.org/tiny-inflate/-/tiny-inflate-1.0.3.tgz", + "integrity": "sha512-pkY1fj1cKHb2seWDy0B16HeWyczlJA9/WW3u3c4z/NiWDsO3DOU5D7nhTLE9CF0yXv/QZFY7sEJmj24dK+Rrqw==", + "license": "MIT" + }, + "node_modules/tinybench": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz", + "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==", + "dev": true, + "license": "MIT" + }, + "node_modules/tinyclip": { + "version": "0.1.15", + "resolved": "https://registry.npmjs.org/tinyclip/-/tinyclip-0.1.15.tgz", + "integrity": "sha512-uo33abH+Ays0xYaDysoBt494Hb3hsEczMpcC0MwFl773pazORx4fmvKhclhR1wonUbB6vvpRsvVMwnhfqeMc+A==", + "license": "MIT", + "engines": { + "node": "^16.14.0 || >= 17.3.0" + } + }, + "node_modules/tinyexec": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.3.0.tgz", + "integrity": "sha512-QKAl9m8gWWGHV8jZcPeym6j+XULi6tOf1mT83WYJ4Lk2ytW/uwAWkrP0uFsdoYMdueVJ0qs26wZ+23xeB4ibNQ==", + "license": "MIT", + "engines": { + "node": ">=18" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.17", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.17.tgz", + "integrity": "sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==", + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.4" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/tinyrainbow": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-3.1.1.tgz", + "integrity": "sha512-yau8yJdTt989Mm0Bd/236QnzEiPf2xLLTqUZRUJOo/3CB078LSwzei343DgtJVmfJKJE3TMINY1u42SQsP6mXw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/trim-lines": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz", + "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/trough": { + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz", + "integrity": "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "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==", + "license": "0BSD", + "optional": true + }, + "node_modules/typesafe-path": { + "version": "0.2.2", + "resolved": "https://registry.npmjs.org/typesafe-path/-/typesafe-path-0.2.2.tgz", + "integrity": "sha512-OJabfkAg1WLZSqJAJ0Z6Sdt3utnbzr/jh+NAHoyWHJe8CMSy79Gm085094M9nvTPy22KzTVn5Zq5mbapCI/hPA==", + "dev": true, + "license": "MIT" + }, + "node_modules/typescript": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz", + "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/typescript-auto-import-cache": { + "version": "0.3.6", + "resolved": "https://registry.npmjs.org/typescript-auto-import-cache/-/typescript-auto-import-cache-0.3.6.tgz", + "integrity": "sha512-RpuHXrknHdVdK7wv/8ug3Fr0WNsNi5l5aB8MYYuXhq2UH5lnEB1htJ1smhtD5VeCsGr2p8mUDtd83LCQDFVgjQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "semver": "^7.3.8" + } + }, + "node_modules/ufo": { + "version": "1.6.4", + "resolved": "https://registry.npmjs.org/ufo/-/ufo-1.6.4.tgz", + "integrity": "sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA==", + "license": "MIT" + }, + "node_modules/ultrahtml": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/ultrahtml/-/ultrahtml-1.7.0.tgz", + "integrity": "sha512-2xRd0VHoAQE4M+vF/DvFFB7pUV0ZxTW1TLi7lHQWnF/Sb5TPeEUV/l+hxcNnGO00ZXGnR0voCMmYRKQf+rvJ2g==", + "license": "MIT" + }, + "node_modules/uncrypto": { + "version": "0.1.3", + "resolved": "https://registry.npmjs.org/uncrypto/-/uncrypto-0.1.3.tgz", + "integrity": "sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q==", + "license": "MIT" + }, + "node_modules/undici": { + "version": "8.10.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-8.10.0.tgz", + "integrity": "sha512-HvltHd7avK13QIw/oLe4qoOLyoVSoafqJ2jYOrtMRBkbYT31eiBQ8O0ehRKZiEZCMEyLFQNIADpgCWC5fALvYQ==", + "license": "MIT", + "engines": { + "node": ">=22.19.0" + } + }, + "node_modules/undici-types": { + "version": "7.18.2", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", + "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==", + "license": "MIT" + }, + "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/unified": { + "version": "11.0.5", + "resolved": "https://registry.npmjs.org/unified/-/unified-11.0.5.tgz", + "integrity": "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "bail": "^2.0.0", + "devlop": "^1.0.0", + "extend": "^3.0.0", + "is-plain-obj": "^4.0.0", + "trough": "^2.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unifont": { + "version": "0.7.5", + "resolved": "https://registry.npmjs.org/unifont/-/unifont-0.7.5.tgz", + "integrity": "sha512-ULe/Cs+ZIsq+dcFofNkhqielCrUJnb5mr+Yc4EBM2VlL+6OZR6+cjtI2mT1bJvRBrVncqHAbLURxmPLcCXzWMg==", + "license": "MIT", + "dependencies": { + "css-tree": "^3.1.0", + "ohash": "^2.0.11", + "undici": "^8.0.0" + } + }, + "node_modules/unist-util-is": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz", + "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-position": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz", + "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-stringify-position": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz", + "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz", + "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0", + "unist-util-visit-parents": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unist-util-visit-parents": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz", + "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-is": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/unstorage": { + "version": "1.17.5", + "resolved": "https://registry.npmjs.org/unstorage/-/unstorage-1.17.5.tgz", + "integrity": "sha512-0i3iqvRfx29hkNntHyQvJTpf5W9dQ9ZadSoRU8+xVlhVtT7jAX57fazYO9EHvcRCfBCyi5YRya7XCDOsbTgkPg==", + "license": "MIT", + "dependencies": { + "anymatch": "^3.1.3", + "chokidar": "^5.0.0", + "destr": "^2.0.5", + "h3": "^1.15.10", + "lru-cache": "^11.2.7", + "node-fetch-native": "^1.6.7", + "ofetch": "^1.5.1", + "ufo": "^1.6.3" + }, + "peerDependencies": { + "@azure/app-configuration": "^1.8.0", + "@azure/cosmos": "^4.2.0", + "@azure/data-tables": "^13.3.0", + "@azure/identity": "^4.6.0", + "@azure/keyvault-secrets": "^4.9.0", + "@azure/storage-blob": "^12.26.0", + "@capacitor/preferences": "^6 || ^7 || ^8", + "@deno/kv": ">=0.9.0", + "@netlify/blobs": "^6.5.0 || ^7.0.0 || ^8.1.0 || ^9.0.0 || ^10.0.0", + "@planetscale/database": "^1.19.0", + "@upstash/redis": "^1.34.3", + "@vercel/blob": ">=0.27.1", + "@vercel/functions": "^2.2.12 || ^3.0.0", + "@vercel/kv": "^1 || ^2 || ^3", + "aws4fetch": "^1.0.20", + "db0": ">=0.2.1", + "idb-keyval": "^6.2.1", + "ioredis": "^5.4.2", + "uploadthing": "^7.4.4" + }, + "peerDependenciesMeta": { + "@azure/app-configuration": { + "optional": true + }, + "@azure/cosmos": { + "optional": true + }, + "@azure/data-tables": { + "optional": true + }, + "@azure/identity": { + "optional": true + }, + "@azure/keyvault-secrets": { + "optional": true + }, + "@azure/storage-blob": { + "optional": true + }, + "@capacitor/preferences": { + "optional": true + }, + "@deno/kv": { + "optional": true + }, + "@netlify/blobs": { + "optional": true + }, + "@planetscale/database": { + "optional": true + }, + "@upstash/redis": { + "optional": true + }, + "@vercel/blob": { + "optional": true + }, + "@vercel/functions": { + "optional": true + }, + "@vercel/kv": { + "optional": true + }, + "aws4fetch": { + "optional": true + }, + "db0": { + "optional": true + }, + "idb-keyval": { + "optional": true + }, + "ioredis": { + "optional": true + }, + "uploadthing": { + "optional": true + } + } + }, + "node_modules/unstorage/node_modules/chokidar": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-5.0.0.tgz", + "integrity": "sha512-TQMmc3w+5AxjpL8iIiwebF73dRDF4fBIieAqGn9RGCWaEVwQ6Fb2cGe31Yns0RRIzii5goJ1Y7xbMwo1TxMplw==", + "license": "MIT", + "dependencies": { + "readdirp": "^5.0.0" + }, + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/unstorage/node_modules/readdirp": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-5.1.1.tgz", + "integrity": "sha512-Kko+Y5XQ6fM+Ce3dq3m9YGxnacYZYl9cA1wZjaF3Vbry2L3i1qVg8+CAgNPsXRArPMUMCaOR7oa9Nqntc43JKA==", + "license": "MIT", + "engines": { + "node": ">= 20.19.0" + }, + "funding": { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + }, + "node_modules/vfile": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz", + "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile-message": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-location": { + "version": "5.0.3", + "resolved": "https://registry.npmjs.org/vfile-location/-/vfile-location-5.0.3.tgz", + "integrity": "sha512-5yXvWDEgqeiYiBe1lbxYF7UMAIm/IcopxMHrMQDq3nvKcjPKIhZklUKL+AE7J7uApI4kwe2snsK+eI6UTj9EHg==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "vfile": "^6.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vfile-message": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz", + "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==", + "license": "MIT", + "dependencies": { + "@types/unist": "^3.0.0", + "unist-util-stringify-position": "^4.0.0" + }, + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/unified" + } + }, + "node_modules/vite": { + "version": "8.2.1", + "resolved": "https://registry.npmjs.org/vite/-/vite-8.2.1.tgz", + "integrity": "sha512-EU/eS7BH3XROHh2YnBefjM6DBKA6ZeMZEYQbj7NLWg5wHYlhB8B/Mayd5XsgWq+NFYccDOTemRpdETWR6Ka/lw==", + "license": "MIT", + "dependencies": { + "lightningcss": "^1.33.0", + "picomatch": "^4.0.5", + "postcss": "^8.5.25", + "rolldown": "~1.2.1", + "tinyglobby": "^0.2.17" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "@vitejs/devtools": "^0.4.0", + "esbuild": "^0.27.0 || ^0.28.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "@vitejs/devtools": { + "optional": true + }, + "esbuild": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/vite/node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/vitefu": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/vitefu/-/vitefu-1.1.3.tgz", + "integrity": "sha512-ub4okH7Z5KLjb6hDyjqrGXqWtWvoYdU3IGm/NorpgHncKoLTCfRIbvlhBm7r0YstIaQRYlp4yEbFqDcKSzXSSg==", + "license": "MIT", + "workspaces": [ + "tests/deps/*", + "tests/projects/*", + "tests/projects/workspace/packages/*" + ], + "peerDependencies": { + "vite": "^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "vite": { + "optional": true + } + } + }, + "node_modules/vitest": { + "version": "4.1.10", + "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.10.tgz", + "integrity": "sha512-R9jUTe5S4Qb0HCd4TNqpC7oGcrMssMRGXLW80ubjWsW9VH5GF8y1Y0SFLY9AbqSk6nt0PnOx4H4WNJYZ13GUPw==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vitest/expect": "4.1.10", + "@vitest/mocker": "4.1.10", + "@vitest/pretty-format": "4.1.10", + "@vitest/runner": "4.1.10", + "@vitest/snapshot": "4.1.10", + "@vitest/spy": "4.1.10", + "@vitest/utils": "4.1.10", + "es-module-lexer": "^2.0.0", + "expect-type": "^1.3.0", + "magic-string": "^0.30.21", + "obug": "^2.1.1", + "pathe": "^2.0.3", + "picomatch": "^4.0.3", + "std-env": "^4.0.0-rc.1", + "tinybench": "^2.9.0", + "tinyexec": "^1.0.2", + "tinyglobby": "^0.2.15", + "tinyrainbow": "^3.1.0", + "vite": "^6.0.0 || ^7.0.0 || ^8.0.0", + "why-is-node-running": "^2.3.0" + }, + "bin": { + "vitest": "vitest.mjs" + }, + "engines": { + "node": "^20.0.0 || ^22.0.0 || >=24.0.0" + }, + "funding": { + "url": "https://opencollective.com/vitest" + }, + "peerDependencies": { + "@edge-runtime/vm": "*", + "@opentelemetry/api": "^1.9.0", + "@types/node": "^20.0.0 || ^22.0.0 || >=24.0.0", + "@vitest/browser-playwright": "4.1.10", + "@vitest/browser-preview": "4.1.10", + "@vitest/browser-webdriverio": "4.1.10", + "@vitest/coverage-istanbul": "4.1.10", + "@vitest/coverage-v8": "4.1.10", + "@vitest/ui": "4.1.10", + "happy-dom": "*", + "jsdom": "*", + "vite": "^6.0.0 || ^7.0.0 || ^8.0.0" + }, + "peerDependenciesMeta": { + "@edge-runtime/vm": { + "optional": true + }, + "@opentelemetry/api": { + "optional": true + }, + "@types/node": { + "optional": true + }, + "@vitest/browser-playwright": { + "optional": true + }, + "@vitest/browser-preview": { + "optional": true + }, + "@vitest/browser-webdriverio": { + "optional": true + }, + "@vitest/coverage-istanbul": { + "optional": true + }, + "@vitest/coverage-v8": { + "optional": true + }, + "@vitest/ui": { + "optional": true + }, + "happy-dom": { + "optional": true + }, + "jsdom": { + "optional": true + }, + "vite": { + "optional": false + } + } + }, + "node_modules/vitest/node_modules/magic-string": { + "version": "0.30.21", + "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz", + "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "@jridgewell/sourcemap-codec": "^1.5.5" + } + }, + "node_modules/volar-service-css": { + "version": "0.0.71", + "resolved": "https://registry.npmjs.org/volar-service-css/-/volar-service-css-0.0.71.tgz", + "integrity": "sha512-wRRFt9BpjMKCazcgOh67MSjUjiWUCAh99DyYSDIOTuxaRjEtDC7PpB0k1Y1wbJIW/pVtMUSVbpPo3UGSm0Byxw==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-css-languageservice": "^6.3.0", + "vscode-languageserver-textdocument": "^1.0.11", + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "@volar/language-service": "~2.4.0" + }, + "peerDependenciesMeta": { + "@volar/language-service": { + "optional": true + } + } + }, + "node_modules/volar-service-emmet": { + "version": "0.0.71", + "resolved": "https://registry.npmjs.org/volar-service-emmet/-/volar-service-emmet-0.0.71.tgz", + "integrity": "sha512-zqjzt6bN95e3CUstBm0PBFAJnrfz0ZAARka87fart46/gNCLLuP3Vujy8V/J8HEziTFLnfkgIASLFYPUhonJcA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@emmetio/css-parser": "^0.4.1", + "@emmetio/html-matcher": "^1.3.0", + "@vscode/emmet-helper": "^2.9.3", + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "@volar/language-service": "~2.4.0" + }, + "peerDependenciesMeta": { + "@volar/language-service": { + "optional": true + } + } + }, + "node_modules/volar-service-html": { + "version": "0.0.71", + "resolved": "https://registry.npmjs.org/volar-service-html/-/volar-service-html-0.0.71.tgz", + "integrity": "sha512-e8tHPhgQ7ooLfudAEIku+kgd9pWkq3SSz8RbnQDI1+Eb8wbenkLGHqoirLqz5ORLV6wIMr2Iv08RWBG5eOcgpw==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-html-languageservice": "^5.3.0", + "vscode-languageserver-textdocument": "^1.0.11", + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "@volar/language-service": "~2.4.0" + }, + "peerDependenciesMeta": { + "@volar/language-service": { + "optional": true + } + } + }, + "node_modules/volar-service-prettier": { + "version": "0.0.71", + "resolved": "https://registry.npmjs.org/volar-service-prettier/-/volar-service-prettier-0.0.71.tgz", + "integrity": "sha512-Rz7JVH3qD108UCdmIEiZvOBNljMt2nLFdbN8AXcDfn7xD9F5I2aCIsDVqBbXw21PsnxG0b7MfwtNF+zPS/NKUg==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "@volar/language-service": "~2.4.0", + "prettier": "^2.2 || ^3.0" + }, + "peerDependenciesMeta": { + "@volar/language-service": { + "optional": true + }, + "prettier": { + "optional": true + } + } + }, + "node_modules/volar-service-typescript": { + "version": "0.0.71", + "resolved": "https://registry.npmjs.org/volar-service-typescript/-/volar-service-typescript-0.0.71.tgz", + "integrity": "sha512-yTtM/BVT6hoyEYnDtaCyAtNhdNeS/mhTTABlBOdw3NNiRBUin3IznFJpgfjer4c6RYopiPjjQjc9VFhxVl1mLw==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-browserify": "^1.0.1", + "semver": "^7.6.2", + "typescript-auto-import-cache": "^0.3.5", + "vscode-languageserver-textdocument": "^1.0.11", + "vscode-nls": "^5.2.0", + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "@volar/language-service": "~2.4.0" + }, + "peerDependenciesMeta": { + "@volar/language-service": { + "optional": true + } + } + }, + "node_modules/volar-service-typescript-twoslash-queries": { + "version": "0.0.71", + "resolved": "https://registry.npmjs.org/volar-service-typescript-twoslash-queries/-/volar-service-typescript-twoslash-queries-0.0.71.tgz", + "integrity": "sha512-9K2k72s4n7rV9s4bX0MyjbX9iBribvKZbBJKuEmTCZfeWJXs6Yh7bGpY4eoc7UufAjvpheBqwyZCOIPBvxCv0A==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-uri": "^3.0.8" + }, + "peerDependencies": { + "@volar/language-service": "~2.4.0" + }, + "peerDependenciesMeta": { + "@volar/language-service": { + "optional": true + } + } + }, + "node_modules/volar-service-yaml": { + "version": "0.0.71", + "resolved": "https://registry.npmjs.org/volar-service-yaml/-/volar-service-yaml-0.0.71.tgz", + "integrity": "sha512-qYGWGuVpUTnZGu5P/CR4KLK4aIR8RrcVnmfZ2eRcj9q/I8VZCoC5yy9FtEvfNvnDp4MU17yhdJcvpQPIqhJS2Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-uri": "^3.0.8", + "yaml-language-server": "~1.23.0" + }, + "peerDependencies": { + "@volar/language-service": "~2.4.0" + }, + "peerDependenciesMeta": { + "@volar/language-service": { + "optional": true + } + } + }, + "node_modules/vscode-css-languageservice": { + "version": "6.3.10", + "resolved": "https://registry.npmjs.org/vscode-css-languageservice/-/vscode-css-languageservice-6.3.10.tgz", + "integrity": "sha512-eq5N9Er3fC4vA9zd9EFhyBG90wtCCuXgRSpAndaOgXMh1Wgep5lBgRIeDgjZBW9pa+332yC9+49cZMW8jcL3MA==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vscode/l10n": "^0.0.18", + "vscode-languageserver-textdocument": "^1.0.12", + "vscode-languageserver-types": "3.17.5", + "vscode-uri": "^3.1.0" + } + }, + "node_modules/vscode-css-languageservice/node_modules/vscode-languageserver-types": { + "version": "3.17.5", + "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.17.5.tgz", + "integrity": "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-html-languageservice": { + "version": "5.6.2", + "resolved": "https://registry.npmjs.org/vscode-html-languageservice/-/vscode-html-languageservice-5.6.2.tgz", + "integrity": "sha512-ulCrSnFnfQ16YzvwnYUgEbUEl/ZG7u2eV27YhvLObSHKkb8fw1Z9cgsnUwjTEeDIdJDoTDTDpxuhQwoenoLNMg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vscode/l10n": "^0.0.18", + "vscode-languageserver-textdocument": "^1.0.12", + "vscode-languageserver-types": "^3.17.5", + "vscode-uri": "^3.1.0" + } + }, + "node_modules/vscode-json-languageservice": { + "version": "4.1.8", + "resolved": "https://registry.npmjs.org/vscode-json-languageservice/-/vscode-json-languageservice-4.1.8.tgz", + "integrity": "sha512-0vSpg6Xd9hfV+eZAaYN63xVVMOTmJ4GgHxXnkLCh+9RsQBkWKIghzLhW2B9ebfG+LQQg8uLtsQ2aUKjTgE+QOg==", + "dev": true, + "license": "MIT", + "dependencies": { + "jsonc-parser": "^3.0.0", + "vscode-languageserver-textdocument": "^1.0.1", + "vscode-languageserver-types": "^3.16.0", + "vscode-nls": "^5.0.0", + "vscode-uri": "^3.0.2" + }, + "engines": { + "npm": ">=7.0.0" + } + }, + "node_modules/vscode-jsonrpc": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-9.0.1.tgz", + "integrity": "sha512-rfuA6T75H6m5EkbhtEPzre9pT0HPcDI2MMy4+nPFIBks5J8JBAUHD4tRYSgaBOijIEC7SRkC1kKyXTLqbmh9jw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/vscode-languageserver": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/vscode-languageserver/-/vscode-languageserver-9.0.1.tgz", + "integrity": "sha512-woByF3PDpkHFUreUa7Hos7+pUWdeWMXRd26+ZX2A8cFx6v/JPTtd4/uN0/jB6XQHYaOlHbio03NTHCqrgG5n7g==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-languageserver-protocol": "3.17.5" + }, + "bin": { + "installServerIntoExtension": "bin/installServerIntoExtension" + } + }, + "node_modules/vscode-languageserver-protocol": { + "version": "3.18.2", + "resolved": "https://registry.npmjs.org/vscode-languageserver-protocol/-/vscode-languageserver-protocol-3.18.2.tgz", + "integrity": "sha512-XRyDbT0Pp3sSNti3JmxVEUMySWCSi1hhM+/KUlCy1hV1zmrqpM1OwO12EAki8blhmLuIMpaJrYbo0OzGVfK2Qg==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-jsonrpc": "9.0.1", + "vscode-languageserver-types": "3.18.0" + } + }, + "node_modules/vscode-languageserver-textdocument": { + "version": "1.0.12", + "resolved": "https://registry.npmjs.org/vscode-languageserver-textdocument/-/vscode-languageserver-textdocument-1.0.12.tgz", + "integrity": "sha512-cxWNPesCnQCcMPeenjKKsOCKQZ/L6Tv19DTRIGuLWe32lyzWhihGVJ/rcckZXJxfdKCFvRLS3fpBIsV/ZGX4zA==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-languageserver-types": { + "version": "3.18.0", + "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.18.0.tgz", + "integrity": "sha512-8TsGPNMIMiiBdkORgRSvLjuiEIiAFtO+KssmYWxQ+uSVvlf7RjK8YKCOjPzZ+YA04jXEV7+7LvkSmHkhpNS99g==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-languageserver/node_modules/vscode-jsonrpc": { + "version": "8.2.0", + "resolved": "https://registry.npmjs.org/vscode-jsonrpc/-/vscode-jsonrpc-8.2.0.tgz", + "integrity": "sha512-C+r0eKJUIfiDIfwJhria30+TYWPtuHJXHtI7J0YlOmKAo7ogxP20T0zxB7HZQIFhIyvoBPwWskjxrvAtfjyZfA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14.0.0" + } + }, + "node_modules/vscode-languageserver/node_modules/vscode-languageserver-protocol": { + "version": "3.17.5", + "resolved": "https://registry.npmjs.org/vscode-languageserver-protocol/-/vscode-languageserver-protocol-3.17.5.tgz", + "integrity": "sha512-mb1bvRJN8SVznADSGWM9u/b07H7Ecg0I3OgXDuLdn307rl/J3A9YD6/eYOssqhecL27hK1IPZAsaqh00i/Jljg==", + "dev": true, + "license": "MIT", + "dependencies": { + "vscode-jsonrpc": "8.2.0", + "vscode-languageserver-types": "3.17.5" + } + }, + "node_modules/vscode-languageserver/node_modules/vscode-languageserver-types": { + "version": "3.17.5", + "resolved": "https://registry.npmjs.org/vscode-languageserver-types/-/vscode-languageserver-types-3.17.5.tgz", + "integrity": "sha512-Ld1VelNuX9pdF39h2Hgaeb5hEZM2Z3jUrrMgWQAu82jMtZp7p3vJT3BzToKtZI7NgQssZje5o0zryOrhQvzQAg==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-nls": { + "version": "5.2.0", + "resolved": "https://registry.npmjs.org/vscode-nls/-/vscode-nls-5.2.0.tgz", + "integrity": "sha512-RAaHx7B14ZU04EU31pT+rKz2/zSl7xMsfIZuo8pd+KZO6PXtQmpevpq3vxvWNcrGbdmhM/rr5Uw5Mz+NBfhVng==", + "dev": true, + "license": "MIT" + }, + "node_modules/vscode-uri": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/vscode-uri/-/vscode-uri-3.1.0.tgz", + "integrity": "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ==", + "dev": true, + "license": "MIT" + }, + "node_modules/web-namespaces": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/web-namespaces/-/web-namespaces-2.0.1.tgz", + "integrity": "sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + }, + "node_modules/why-is-node-running": { + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz", + "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==", + "dev": true, + "license": "MIT", + "dependencies": { + "siginfo": "^2.0.0", + "stackback": "0.0.2" + }, + "bin": { + "why-is-node-running": "cli.js" + }, + "engines": { + "node": ">=8" + } + }, + "node_modules/workerd": { + "version": "1.20260811.1", + "resolved": "https://registry.npmjs.org/workerd/-/workerd-1.20260811.1.tgz", + "integrity": "sha512-kh+FFm55JQ4ssxhHZV9VPdMQq3D1nHxNJgwxMtWGD4dGppJvLySdguTRDKgeNTvgq6heSz+6TTXyPSDGj8Yllw==", + "dev": true, + "hasInstallScript": true, + "license": "Apache-2.0", + "bin": { + "workerd": "bin/workerd" + }, + "engines": { + "node": ">=16" + }, + "optionalDependencies": { + "@cloudflare/workerd-darwin-64": "1.20260811.1", + "@cloudflare/workerd-darwin-arm64": "1.20260811.1", + "@cloudflare/workerd-linux-64": "1.20260811.1", + "@cloudflare/workerd-linux-arm64": "1.20260811.1", + "@cloudflare/workerd-windows-64": "1.20260811.1" + } + }, + "node_modules/wrangler": { + "version": "4.123.0", + "resolved": "https://registry.npmjs.org/wrangler/-/wrangler-4.123.0.tgz", + "integrity": "sha512-VXo2I1oa0x9aGAKIFPRSQPqTh0RBY5Ktl44YOhNmsJQFUdJKDA2vVTU6Xj+FC2koll6orJqWZN8jbXVIk9O67Q==", + "dev": true, + "license": "MIT OR Apache-2.0", + "dependencies": { + "@cloudflare/kv-asset-handler": "0.5.0", + "@cloudflare/unenv-preset": "2.16.1", + "blake3-wasm": "2.1.5", + "esbuild": "0.28.1", + "miniflare": "5.20260811.1-alpha", + "path-to-regexp": "6.3.0", + "unenv": "2.0.0-rc.24", + "workerd": "1.20260811.1" + }, + "bin": { + "cf-wrangler": "bin/cf-wrangler.js", + "wrangler": "bin/wrangler.js", + "wrangler2": "bin/wrangler.js" + }, + "engines": { + "node": ">=22.0.0" + }, + "optionalDependencies": { + "fsevents": "2.3.3" + }, + "peerDependencies": { + "@cloudflare/workers-types": "^5.20260811.1" + }, + "peerDependenciesMeta": { + "@cloudflare/workers-types": { + "optional": true + } + } + }, + "node_modules/wrangler/node_modules/@esbuild/aix-ppc64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.1.tgz", + "integrity": "sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/android-arm": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.1.tgz", + "integrity": "sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/android-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.1.tgz", + "integrity": "sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/android-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.1.tgz", + "integrity": "sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/darwin-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.1.tgz", + "integrity": "sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/darwin-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.1.tgz", + "integrity": "sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/freebsd-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.1.tgz", + "integrity": "sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/freebsd-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.1.tgz", + "integrity": "sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-arm": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.1.tgz", + "integrity": "sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.1.tgz", + "integrity": "sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-ia32": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.1.tgz", + "integrity": "sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-loong64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.1.tgz", + "integrity": "sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-mips64el": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.1.tgz", + "integrity": "sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-ppc64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.1.tgz", + "integrity": "sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-riscv64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.1.tgz", + "integrity": "sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-s390x": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.1.tgz", + "integrity": "sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/linux-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.1.tgz", + "integrity": "sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/netbsd-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.1.tgz", + "integrity": "sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/netbsd-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.1.tgz", + "integrity": "sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/openbsd-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.1.tgz", + "integrity": "sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/openbsd-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.1.tgz", + "integrity": "sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/openharmony-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.1.tgz", + "integrity": "sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/sunos-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.1.tgz", + "integrity": "sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/win32-arm64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.1.tgz", + "integrity": "sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/win32-ia32": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.1.tgz", + "integrity": "sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/@esbuild/win32-x64": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.1.tgz", + "integrity": "sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/wrangler/node_modules/esbuild": { + "version": "0.28.1", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.1.tgz", + "integrity": "sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.28.1", + "@esbuild/android-arm": "0.28.1", + "@esbuild/android-arm64": "0.28.1", + "@esbuild/android-x64": "0.28.1", + "@esbuild/darwin-arm64": "0.28.1", + "@esbuild/darwin-x64": "0.28.1", + "@esbuild/freebsd-arm64": "0.28.1", + "@esbuild/freebsd-x64": "0.28.1", + "@esbuild/linux-arm": "0.28.1", + "@esbuild/linux-arm64": "0.28.1", + "@esbuild/linux-ia32": "0.28.1", + "@esbuild/linux-loong64": "0.28.1", + "@esbuild/linux-mips64el": "0.28.1", + "@esbuild/linux-ppc64": "0.28.1", + "@esbuild/linux-riscv64": "0.28.1", + "@esbuild/linux-s390x": "0.28.1", + "@esbuild/linux-x64": "0.28.1", + "@esbuild/netbsd-arm64": "0.28.1", + "@esbuild/netbsd-x64": "0.28.1", + "@esbuild/openbsd-arm64": "0.28.1", + "@esbuild/openbsd-x64": "0.28.1", + "@esbuild/openharmony-arm64": "0.28.1", + "@esbuild/sunos-x64": "0.28.1", + "@esbuild/win32-arm64": "0.28.1", + "@esbuild/win32-ia32": "0.28.1", + "@esbuild/win32-x64": "0.28.1" + } + }, + "node_modules/wrangler/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/wrap-ansi": { + "version": "9.0.2", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.2.tgz", + "integrity": "sha512-42AtmgqjV+X1VpdOfyTGOYRi0/zsoLqtXQckTmqTeybT+BDIbM/Guxo7x3pE2vtpr1ok6xRqM9OpBe+Jyoqyww==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/ansi-styles": { + "version": "6.2.3", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.3.tgz", + "integrity": "sha512-4Dj6M28JB+oAH8kFkTLUo+a2jwOFkuqb3yucU0CANcRRUbxS0cP0nZYCGjcc3BNXwRIsUVmDGgzawme7zvJHvg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/ws": { + "version": "8.21.0", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.0.tgz", + "integrity": "sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g==", + "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/xml-naming": { + "version": "0.3.0", + "resolved": "https://registry.npmjs.org/xml-naming/-/xml-naming-0.3.0.tgz", + "integrity": "sha512-ghig2TBE/H11aOVgmahA3MhimvkBr6JIYknH/Dhdk10nXwdbIqBJsbfMxpvFPG8bAw77gN29aQWvKpmVoPlvPQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT", + "engines": { + "node": ">=16.0.0" + } + }, + "node_modules/xxhash-wasm": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/xxhash-wasm/-/xxhash-wasm-1.1.0.tgz", + "integrity": "sha512-147y/6YNh+tlp6nd/2pWq38i9h6mz/EuQ6njIrmW8D1BS5nCqs0P6DG+m6zTGnNz5I+uhZ0SHxBs9BsPrwcKDA==", + "license": "MIT" + }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yaml": { + "version": "2.9.0", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.9.0.tgz", + "integrity": "sha512-2AvhNX3mb8zd6Zy7INTtSpl1F15HW6Wnqj0srWlkKLcpYl/gMIMJiyuGq2KeI2YFxUPjdlB+3Lc10seMLtL4cA==", + "license": "ISC", + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + }, + "funding": { + "url": "https://github.com/sponsors/eemeli" + } + }, + "node_modules/yaml-language-server": { + "version": "1.23.0", + "resolved": "https://registry.npmjs.org/yaml-language-server/-/yaml-language-server-1.23.0.tgz", + "integrity": "sha512-3qVyCOexLCWw06PQa5kRPwvMWMZ/eZeCRWUvgD6a0OkqL/4iCnxy2WumbWifa937Uo5xhyWJ0uxlU39ljhNh7A==", + "dev": true, + "license": "MIT", + "dependencies": { + "@vscode/l10n": "^0.0.18", + "ajv": "^8.17.1", + "ajv-draft-04": "^1.0.0", + "ajv-i18n": "^4.2.0", + "prettier": "^3.8.1", + "request-light": "^0.5.7", + "vscode-json-languageservice": "4.1.8", + "vscode-languageserver": "^9.0.0", + "vscode-languageserver-textdocument": "^1.0.1", + "vscode-languageserver-types": "^3.16.0", + "vscode-uri": "^3.0.2", + "yaml": "2.8.3" + }, + "bin": { + "yaml-language-server": "bin/yaml-language-server" + } + }, + "node_modules/yaml-language-server/node_modules/request-light": { + "version": "0.5.8", + "resolved": "https://registry.npmjs.org/request-light/-/request-light-0.5.8.tgz", + "integrity": "sha512-3Zjgh+8b5fhRJBQZoy+zbVKpAQGLyka0MPgW3zruTF4dFFJ8Fqcfu9YsAvi/rvdcaTeWG3MkbZv4WKxAn/84Lg==", + "dev": true, + "license": "MIT" + }, + "node_modules/yaml-language-server/node_modules/yaml": { + "version": "2.8.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.3.tgz", + "integrity": "sha512-AvbaCLOO2Otw/lW5bmh9d/WEdcDFdQp2Z2ZUH3pX9U2ihyUY0nvLv7J6TrWowklRGPYbB/IuIMfYgxaCPg5Bpg==", + "dev": true, + "license": "ISC", + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + }, + "funding": { + "url": "https://github.com/sponsors/eemeli" + } + }, + "node_modules/yargs": { + "version": "18.1.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-18.1.0.tgz", + "integrity": "sha512-2rAgRKu54VsHkqI0/tYkmluGXHD4KW7yZoycuqDQ15QOTnc2VVfy0nN/1eMhnQLO00A+dwtK20xuCnc1YGeUyg==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^9.0.1", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "string-width": "^8.2.1", + "y18n": "^5.0.5", + "yargs-parser": "^22.0.0" + }, + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, + "node_modules/yargs-parser": { + "version": "22.0.0", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz", + "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==", + "license": "ISC", + "engines": { + "node": "^20.19.0 || ^22.12.0 || >=23" + } + }, + "node_modules/yocto-queue": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-1.2.2.tgz", + "integrity": "sha512-4LCcse/U2MHZ63HAJVE+v71o7yOdIe4cZ70Wpf8D/IyjDKYQLV5GD46B+hSTjJsvV5PztjvHoU580EftxjDZFQ==", + "license": "MIT", + "engines": { + "node": ">=12.20" + }, + "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" + } + }, + "node_modules/youch/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/zod": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.3.tgz", + "integrity": "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ==", + "license": "MIT", + "funding": { + "url": "https://github.com/sponsors/colinhacks" + } + }, + "node_modules/zwitch": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz", + "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==", + "license": "MIT", + "funding": { + "type": "github", + "url": "https://github.com/sponsors/wooorm" + } + } + } +} diff --git a/publication/package.json b/publication/package.json new file mode 100644 index 0000000..129a098 --- /dev/null +++ b/publication/package.json @@ -0,0 +1,56 @@ +{ + "name": "agentsutra.dev", + "version": "0.1.0", + "private": true, + "type": "module", + "engines": { + "node": "24.19.0", + "npm": "11.17.0" + }, + "scripts": { + "dev": "astro dev", + "build": "npm run build:prelaunch", + "build:prelaunch": "node scripts/build-profile.mjs prelaunch", + "build:public": "node scripts/build-profile.mjs public", + "build:fixtures": "ASTRO_OUT_DIR=.fixture-dist INCLUDE_FIXTURES=1 astro build --force", + "build:exports": "INCLUDE_FIXTURES=1 EXPORT_MODE=1 astro build --outDir .export-dist --force", + "preview": "astro preview", + "check": "astro check", + "format": "prettier --write .", + "format:check": "prettier --check .", + "test": "vitest run", + "test:watch": "vitest", + "test:e2e": "npm run build:prelaunch && playwright test && npm run verify:dist", + "test:e2e:update": "playwright test --update-snapshots", + "privacy:scan": "node scripts/privacy-scan.mjs", + "release:source": "node scripts/create-release-archive.mjs source", + "release:preview": "node scripts/create-release-archive.mjs preview", + "release:artifacts": "node scripts/create-release-archive.mjs all", + "export:social": "node scripts/export-social.mjs", + "export:verify": "node scripts/verify-export-replay.mjs", + "verify:export-artifacts": "node scripts/validate-export-artifacts.mjs", + "verify:dist": "node scripts/validate-dist.mjs", + "verify:public-profile": "node scripts/verify-public-profile.mjs", + "verify": "npm run format:check && npm run check && npm test && npm run build:prelaunch && npm run privacy:scan && npm run verify:dist", + "deploy:dry-run": "wrangler deploy --dry-run", + "astro": "astro" + }, + "dependencies": { + "@astrojs/rss": "4.0.19", + "@astrojs/sitemap": "3.7.3", + "astro": "7.2.2", + "yaml": "2.9.0" + }, + "devDependencies": { + "@astrojs/check": "0.9.10", + "@axe-core/playwright": "4.13.0", + "@playwright/test": "1.62.1", + "@types/node": "24.13.3", + "prettier": "3.9.6", + "prettier-plugin-astro": "0.14.1", + "sharp": "0.35.3", + "typescript": "6.0.3", + "vitest": "4.1.10", + "wrangler": "4.123.0" + } +} diff --git a/publication/playwright.config.ts b/publication/playwright.config.ts new file mode 100644 index 0000000..d21a031 --- /dev/null +++ b/publication/playwright.config.ts @@ -0,0 +1,70 @@ +import { defineConfig, devices } from '@playwright/test'; + +const host = '127.0.0.1'; +const port = 4321; +const baseURL = `http://${host}:${port}`; + +export default defineConfig({ + // Every intentional test.skip and project-level omission is documented in + // tests/PLAYWRIGHT_COVERAGE.md. + testDir: './tests', + testMatch: ['**/e2e/**/*.spec.ts', '**/accessibility/**/*.spec.ts', '**/visual/**/*.spec.ts'], + fullyParallel: true, + forbidOnly: Boolean(process.env.CI), + retries: process.env.CI ? 2 : 0, + ...(process.env.CI ? { workers: 2 } : {}), + reporter: process.env.CI ? [['line'], ['html', { open: 'never' }]] : 'line', + outputDir: 'test-results', + expect: { + timeout: 5_000, + toHaveScreenshot: { + animations: 'disabled', + caret: 'hide', + scale: 'css', + }, + }, + use: { + baseURL, + locale: 'en-GB', + timezoneId: 'Europe/London', + colorScheme: 'dark', + contextOptions: { reducedMotion: 'reduce' }, + trace: 'retain-on-failure', + screenshot: 'only-on-failure', + video: 'retain-on-failure', + }, + webServer: { + command: `npm run build:fixtures && npm run preview -- --host ${host} --port ${port}`, + url: baseURL, + reuseExistingServer: !process.env.CI, + timeout: 120_000, + env: { + ...process.env, + ASTRO_PREVIEW_BACKGROUND: '0', + ASTRO_OUT_DIR: '.fixture-dist', + INCLUDE_FIXTURES: '1', + }, + }, + projects: [ + { + name: 'chromium', + testIgnore: ['**/e2e/no-javascript.spec.ts'], + use: { ...devices['Desktop Chrome'] }, + }, + { + name: 'firefox', + testIgnore: ['**/e2e/no-javascript.spec.ts'], + use: { ...devices['Desktop Firefox'] }, + }, + { + name: 'webkit', + testIgnore: ['**/e2e/no-javascript.spec.ts'], + use: { ...devices['Desktop Safari'] }, + }, + { + name: 'chromium-no-js', + testMatch: ['**/e2e/no-javascript.spec.ts'], + use: { ...devices['Desktop Chrome'], javaScriptEnabled: false }, + }, + ], +}); diff --git a/publication/prettier.config.mjs b/publication/prettier.config.mjs new file mode 100644 index 0000000..5632932 --- /dev/null +++ b/publication/prettier.config.mjs @@ -0,0 +1,13 @@ +/** @type {import('prettier').Config} */ +export default { + plugins: ['prettier-plugin-astro'], + overrides: [ + { + files: '*.astro', + options: { parser: 'astro' }, + }, + ], + printWidth: 100, + singleQuote: true, + trailingComma: 'all', +}; diff --git a/publication/public/_headers b/publication/public/_headers new file mode 100644 index 0000000..f25f261 --- /dev/null +++ b/publication/public/_headers @@ -0,0 +1,18 @@ +/* + Content-Security-Policy: default-src 'none'; base-uri 'none'; connect-src 'self'; font-src 'self'; form-action 'none'; frame-ancestors 'none'; img-src 'self' data:; manifest-src 'self'; media-src 'self'; object-src 'none'; script-src 'none'; style-src 'self'; worker-src 'none'; upgrade-insecure-requests + Cross-Origin-Opener-Policy: same-origin + Cross-Origin-Resource-Policy: same-origin + Permissions-Policy: accelerometer=(), ambient-light-sensor=(), autoplay=(), camera=(), display-capture=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), publickey-credentials-get=(), screen-wake-lock=(), usb=() + Referrer-Policy: strict-origin-when-cross-origin + X-Content-Type-Options: nosniff + X-Frame-Options: DENY + X-Robots-Tag: noindex, nofollow, noarchive, nosnippet + +/_astro/* + Cache-Control: public, max-age=31536000, immutable + +/favicon.svg + Cache-Control: public, max-age=86400 + +/favicon.ico + Cache-Control: public, max-age=86400 diff --git a/publication/public/favicon.ico b/publication/public/favicon.ico new file mode 100644 index 0000000..fa4176e Binary files /dev/null and b/publication/public/favicon.ico differ diff --git a/publication/public/favicon.svg b/publication/public/favicon.svg new file mode 100644 index 0000000..941e694 --- /dev/null +++ b/publication/public/favicon.svg @@ -0,0 +1,18 @@ + + AgentSutra + + + + + + + + + diff --git a/publication/public/fonts/recursive-v1.085-latin-basic.woff2 b/publication/public/fonts/recursive-v1.085-latin-basic.woff2 new file mode 100644 index 0000000..67c54af Binary files /dev/null and b/publication/public/fonts/recursive-v1.085-latin-basic.woff2 differ diff --git a/publication/public/robots.txt b/publication/public/robots.txt new file mode 100644 index 0000000..1a5ec0c --- /dev/null +++ b/publication/public/robots.txt @@ -0,0 +1,4 @@ +User-agent: * +Allow: / + +Sitemap: https://agentsutra.dev/sitemap-index.xml diff --git a/publication/public/social/agentsutra-default.png b/publication/public/social/agentsutra-default.png new file mode 100644 index 0000000..a7fddb2 Binary files /dev/null and b/publication/public/social/agentsutra-default.png differ diff --git a/publication/public/social/agentsutra-default.svg b/publication/public/social/agentsutra-default.svg new file mode 100644 index 0000000..42a8090 --- /dev/null +++ b/publication/public/social/agentsutra-default.svg @@ -0,0 +1,47 @@ + + AgentSutra + AgentSutra default share artwork with a vertical Thread and the words Push the model, inspect the failure, keep the lesson. + + + + + + + + + + + + + + + + AgentSutra + + + PUBLIC FIELD LAB / FIELD NOTES + + Push the model. + Inspect the failure. + Keep the lesson. + + + First-hand AI experiments, with evidence, limits and one practical action. + + AGENTSUTRA.DEV + + + + + + + diff --git a/publication/scripts/build-profile.mjs b/publication/scripts/build-profile.mjs new file mode 100644 index 0000000..e1c7e2e --- /dev/null +++ b/publication/scripts/build-profile.mjs @@ -0,0 +1,133 @@ +import { access, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises'; +import { dirname, resolve } from 'node:path'; +import process from 'node:process'; +import { spawn } from 'node:child_process'; + +import { + assertPublicationProfile, + headersForProfile, + publicationProfiles, +} from './lib/publication-profiles.mjs'; + +const root = resolve(import.meta.dirname, '..'); + +/** + * @param {string} command + * @param {string[]} args + * @param {import('node:child_process').SpawnOptions} [options] + * @returns {Promise} + */ +function run(command, args, options = {}) { + return new Promise((resolvePromise, reject) => { + const child = spawn(command, args, { stdio: ['inherit', 'pipe', 'pipe'], ...options }); + let stdout = ''; + let stderr = ''; + const stdoutStream = child.stdout; + const stderrStream = child.stderr; + if (!stdoutStream || !stderrStream) { + child.kill(); + reject(new Error(`Unable to capture output from ${command}.`)); + return; + } + stdoutStream.setEncoding('utf8'); + stderrStream.setEncoding('utf8'); + stdoutStream.on('data', (chunk) => { + stdout += chunk; + process.stdout.write(chunk); + }); + stderrStream.on('data', (chunk) => { + stderr += chunk; + process.stderr.write(chunk); + }); + child.once('error', reject); + child.once('exit', (code, signal) => { + if (code === 0) resolvePromise(); + else + reject( + Object.assign( + new Error(`${command} exited with ${signal ? `signal ${signal}` : `code ${code}`}.`), + { stdout, stderr }, + ), + ); + }); + }); +} + +/** @param {string} path */ +async function exists(path) { + try { + await access(path); + return true; + } catch { + return false; + } +} + +/** @param {{ staged: string; destination: string }} paths */ +export async function publishStagedDirectory({ staged, destination }) { + const parent = dirname(destination); + const backup = resolve(parent, `.dist-previous-${process.pid}-${Date.now()}`); + const hadDestination = await exists(destination); + + if (hadDestination) await rename(destination, backup); + try { + await rename(staged, destination); + } catch (error) { + if (hadDestination) await rename(backup, destination); + throw error; + } + if (hadDestination) await rm(backup, { recursive: true, force: true }); +} + +/** + * @param {unknown} profile + * @param {{ destination?: string }} [options] + */ +export async function buildPublicationProfile(profile, options = {}) { + const safeProfile = assertPublicationProfile(profile); + const destination = resolve(options.destination ?? resolve(root, 'dist')); + const stage = await mkdtemp(resolve(dirname(destination), `.dist-${safeProfile}-stage-`)); + const profileConfig = publicationProfiles[safeProfile]; + + try { + await run( + process.execPath, + [resolve(root, 'node_modules/astro/bin/astro.mjs'), 'build', '--outDir', stage, '--force'], + { + cwd: root, + env: { ...process.env, ...profileConfig.environment }, + }, + ); + + await Promise.all([ + writeFile(resolve(stage, 'robots.txt'), profileConfig.robots, 'utf8'), + writeFile(resolve(stage, '_headers'), headersForProfile(safeProfile), 'utf8'), + ]); + + await run( + process.execPath, + [resolve(root, 'scripts/validate-dist.mjs'), '--dir', stage, '--profile', safeProfile], + { cwd: root, env: { ...process.env, ...profileConfig.environment } }, + ); + + await publishStagedDirectory({ staged: stage, destination }); + const profileMarker = await readFile(resolve(destination, 'robots.txt'), 'utf8'); + if (profileMarker !== profileConfig.robots) { + throw new Error( + `Published ${safeProfile} artifact does not contain its generated profile marker.`, + ); + } + console.log(`ATOMIC ${safeProfile.toUpperCase()} BUILD PASS (${destination})`); + } catch (error) { + await rm(stage, { recursive: true, force: true }); + throw error; + } +} + +if (process.argv[1] && resolve(process.argv[1]) === resolve(import.meta.filename)) { + const profile = process.argv[2]; + buildPublicationProfile(profile).catch((error) => { + console.error(error instanceof Error ? error.message : String(error)); + process.exitCode = 1; + }); +} diff --git a/publication/scripts/create-release-archive.mjs b/publication/scripts/create-release-archive.mjs new file mode 100644 index 0000000..b78d335 --- /dev/null +++ b/publication/scripts/create-release-archive.mjs @@ -0,0 +1,35 @@ +import { resolve } from 'node:path'; +import process from 'node:process'; + +import { createPreviewArchive, createSourceArchive } from './lib/release-archive.mjs'; + +const publicationRoot = resolve(import.meta.dirname, '..'); +const repositoryRoot = resolve(publicationRoot, '..'); +const outputDirectory = resolve(publicationRoot, '.release'); + +async function main() { + const mode = process.argv[2]; + if (!['source', 'preview', 'all'].includes(mode ?? '')) { + throw new Error('Usage: node scripts/create-release-archive.mjs '); + } + + if (mode === 'source' || mode === 'all') { + const source = await createSourceArchive({ repositoryRoot, outputDirectory }); + console.log(`SOURCE ARCHIVE PASS (${source.archivePath})`); + console.log(`SHA256 ${source.digest}`); + } + if (mode === 'preview' || mode === 'all') { + const preview = await createPreviewArchive({ + repositoryRoot, + publicationRoot, + outputDirectory, + }); + console.log(`PREVIEW ARCHIVE PASS (${preview.archivePath})`); + console.log(`SHA256 ${preview.digest}`); + } +} + +main().catch((error) => { + console.error(error instanceof Error ? error.message : String(error)); + process.exitCode = 1; +}); diff --git a/publication/scripts/export-social.mjs b/publication/scripts/export-social.mjs new file mode 100644 index 0000000..b964f7c --- /dev/null +++ b/publication/scripts/export-social.mjs @@ -0,0 +1,546 @@ +import { createHash } from 'node:crypto'; +import { spawn } from 'node:child_process'; +import { once } from 'node:events'; +import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'; +import { createServer } from 'node:http'; +import { extname, resolve } from 'node:path'; +import process from 'node:process'; +import { chromium } from '@playwright/test'; +import sharp from 'sharp'; + +const root = resolve(import.meta.dirname, '..'); +const dist = resolve(root, `.export-dist-${process.pid}`); +const exportRoot = resolve(root, 'exports'); +const finalOutputDirectory = resolve(exportRoot, 'social'); +const outputDirectory = resolve(exportRoot, `.social-stage-${process.pid}`); +const exportPlanPath = resolve(dist, 'exports/manifest.json'); +const host = '127.0.0.1'; +const requestedPort = Number(process.env.SOCIAL_EXPORT_PORT ?? '0'); + +if (process.env.INCLUDE_FIXTURES !== '1' || process.env.EXPORT_MODE !== '1') { + console.error('Social export requires INCLUDE_FIXTURES=1 and EXPORT_MODE=1.'); + process.exit(1); +} + +if (finalOutputDirectory !== resolve(root, 'exports', 'social')) { + throw new Error('Refusing to replace an unexpected export directory.'); +} +if (!outputDirectory.startsWith(`${exportRoot}/.social-stage-`)) { + throw new Error('Refusing to use an unexpected export staging directory.'); +} + +/** @param {Buffer|string} value */ +function sha256(value) { + return createHash('sha256').update(value).digest('hex'); +} + +/** + * @param {string} command + * @param {string[]} args + * @param {import('node:child_process').SpawnOptions} [options] + */ +function run(command, args, options = {}) { + return new Promise((resolvePromise, reject) => { + const child = spawn(command, args, { cwd: root, stdio: 'inherit', ...options }); + child.once('error', reject); + child.once('exit', (code, signal) => { + if (code === 0) resolvePromise(undefined); + else reject(new Error(`${command} exited with ${code ?? signal}`)); + }); + }); +} + +/** @param {string} id */ +function slug(id) { + const value = id + .toLowerCase() + .replace(/[^a-z0-9-]+/gu, '-') + .replace(/^-|-$/gu, ''); + if (!value) throw new Error(`Unable to derive export slug from ${id}`); + return value; +} + +/** @param {Buffer} input */ +function normalisePdf(input) { + const source = input.toString('latin1'); + const normalised = source + .replace( + /\/(CreationDate|ModDate) \(([^)]*)\)/gu, + (_match, key, value) => `/${key} (${String(value).replace(/\d/gu, '0')})`, + ) + .replace(/\/ID\s*\[\s*<([^>]+)>\s*<([^>]+)>\s*\]/giu, (match, first, second) => + String(match) + .replace(String(first), '0'.repeat(String(first).length)) + .replace(String(second), '0'.repeat(String(second).length)), + ); + const output = Buffer.from(normalised, 'latin1'); + if (output.byteLength !== input.byteLength) { + throw new Error('PDF normalisation changed the document length.'); + } + return output; +} + +/** @param {unknown} plan */ +function assertPlan(plan) { + if (!plan || typeof plan !== 'object' || !('schemaVersion' in plan)) { + throw new Error('Export plan is missing its schema version.'); + } + if (!('adaptations' in plan) || !Array.isArray(plan.adaptations)) { + throw new Error('Export plan is missing its adaptations.'); + } + for (const adaptation of plan.adaptations) { + if ( + !adaptation || + typeof adaptation !== 'object' || + !('evidence' in adaptation) || + !adaptation.evidence || + typeof adaptation.evidence !== 'object' + ) { + throw new Error('Every export adaptation requires derived public evidence metadata.'); + } + for (const key of ['statusLabel', 'boundary', 'correctionLabel']) { + if (!(key in adaptation.evidence) || typeof adaptation.evidence[key] !== 'string') { + throw new Error(`Export evidence metadata is missing ${key}.`); + } + } + } +} + +/** @param {Record} frame */ +function completeAltText(frame) { + const diagram = frame.diagramTextEquivalent; + return diagram + ? `${String(frame.altText)} Diagram text equivalent: ${String(diagram)}` + : String(frame.altText); +} + +/** @param {Record} adaptation */ +function redditMarkdown(adaptation) { + const frames = /** @type {Array>} */ (adaptation.frames); + const evidence = /** @type {Record} */ (adaptation.evidence); + const title = String(frames[0]?.heading ?? adaptation.id); + const lines = [ + `# ${title}`, + '', + '## Central claim', + '', + String(adaptation.centralClaim), + '', + `**Evidence status:** ${String(evidence.statusLabel)}`, + '', + `**Correction status:** ${String(evidence.correctionLabel)}`, + '', + ]; + for (const frame of frames) { + lines.push(`## ${String(frame.heading)}`, '', String(frame.body), ''); + } + lines.push( + '## Boundary', + '', + String(evidence.boundary), + '', + '---', + '', + String(adaptation.caption), + '', + `[Canonical Field Note](https://agentsutra.dev${String(adaptation.canonicalPath)})`, + '', + ); + return lines.join('\n'); +} + +await run('npx', ['--no-install', 'astro', 'build', '--outDir', dist, '--force'], { + env: { ...process.env, INCLUDE_FIXTURES: '1', EXPORT_MODE: '1' }, +}); + +const plan = JSON.parse(await readFile(exportPlanPath, 'utf8')); +assertPlan(plan); +if (plan.adaptations.length === 0) { + throw new Error('The export plan contains no adaptations.'); +} + +await mkdir(exportRoot, { recursive: true }); +await mkdir(outputDirectory); + +/** @type {Record} */ +const contentTypes = { + '.css': 'text/css; charset=utf-8', + '.html': 'text/html; charset=utf-8', + '.ico': 'image/x-icon', + '.json': 'application/json; charset=utf-8', + '.svg': 'image/svg+xml', + '.woff2': 'font/woff2', +}; +const server = createServer(async (request, response) => { + try { + const url = new URL(request.url ?? '/', 'http://local.invalid'); + let relativePath = decodeURIComponent(url.pathname).replace(/^\/+/, ''); + if (!relativePath || relativePath.endsWith('/')) relativePath += 'index.html'; + else if (!extname(relativePath)) relativePath += '/index.html'; + const path = resolve(dist, relativePath); + if (!path.startsWith(`${dist}/`)) throw new Error('Path escaped the export root.'); + const data = await readFile(path); + response.writeHead(200, { + 'content-type': contentTypes[extname(path)] ?? 'application/octet-stream', + 'cache-control': 'no-store', + }); + response.end(data); + } catch { + response.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' }); + response.end('Not found'); + } +}); +server.listen(requestedPort, host); +await once(server, 'listening'); +const address = server.address(); +if (!address || typeof address === 'string') throw new Error('Export server did not bind TCP.'); +const origin = `http://${host}:${address.port}`; + +/** @type {Array>} */ +const manifestEntries = []; + +/** @param {Record} adaptation */ +function publicationMetadata(adaptation) { + const evidence = /** @type {Record} */ (adaptation.evidence); + return { + fieldNoteId: adaptation.fieldNoteId, + evidencePackId: adaptation.evidencePackId, + centralClaim: adaptation.centralClaim, + evidenceStatus: evidence.statusLabel, + evidenceBoundary: evidence.boundary, + correctionStatus: evidence.correctionLabel, + lifecycle: adaptation.lifecycle, + attribution: adaptation.attribution ?? null, + }; +} +/** @type {import('@playwright/test').Browser | undefined} */ +let browser; +try { + browser = await chromium.launch({ headless: true }); + const context = await browser.newContext({ + deviceScaleFactor: 1, + locale: 'en-GB', + timezoneId: 'UTC', + colorScheme: 'dark', + reducedMotion: 'reduce', + }); + + /** + * @param {string} route + * @param {number} width + * @param {number} height + */ + async function openExportPage(route, width, height) { + const page = await context.newPage(); + await page.setViewportSize({ width, height }); + /** @type {string[]} */ + const externalRequests = []; + await page.route('**/*', async (requestRoute) => { + const requestUrl = new URL(requestRoute.request().url()); + if (requestUrl.origin !== origin) { + externalRequests.push(requestUrl.href); + await requestRoute.abort('blockedbyclient'); + } else { + await requestRoute.continue(); + } + }); + const response = await page.goto(`${origin}${route}`, { waitUntil: 'networkidle' }); + if (!response?.ok()) { + throw new Error(`${route} returned ${response?.status() ?? 'no response'}`); + } + await page.evaluate(() => document.fonts.ready); + await page.addStyleTag({ + content: + '*,*::before,*::after{animation:none!important;transition:none!important;caret-color:transparent!important}', + }); + if (externalRequests.length > 0) { + throw new Error(`${route} requested external runtime assets: ${externalRequests.join(', ')}`); + } + return page; + } + + /** + * @param {import('@playwright/test').Locator} card + * @param {string} route + */ + async function assertCardFits(card, route) { + const report = await card.evaluate((rootElement) => { + const rootBox = rootElement.getBoundingClientRect(); + const clipped = []; + for (const element of [rootElement, ...rootElement.querySelectorAll('*')]) { + const box = element.getBoundingClientRect(); + const style = getComputedStyle(element); + if ( + style.display === 'none' || + style.visibility === 'hidden' || + box.width === 0 || + box.height === 0 + ) { + continue; + } + if ( + box.left < rootBox.left - 2 || + box.right > rootBox.right + 2 || + box.top < rootBox.top - 2 || + box.bottom > rootBox.bottom + 2 + ) { + clipped.push({ + tag: element.tagName.toLowerCase(), + className: String(element.className).slice(0, 100), + }); + } + } + return { + clipped: clipped.slice(0, 8), + scrollWidth: rootElement.scrollWidth, + clientWidth: rootElement.clientWidth, + scrollHeight: rootElement.scrollHeight, + clientHeight: rootElement.clientHeight, + }; + }); + if (report.clipped.length > 0) { + throw new Error( + `${route} contains clipped or overflowing content: ${JSON.stringify(report)}`, + ); + } + } + + const adaptations = /** @type {Array>} */ (plan.adaptations); + for (const adaptation of adaptations.sort((left, right) => + String(left.id).localeCompare(String(right.id)), + )) { + const exportContract = /** @type {Record} */ (adaptation.export); + const frames = /** @type {Array>} */ (adaptation.frames); + const exportSlug = slug(String(adaptation.id)); + + if (exportContract.format === 'markdown') { + const markdown = redditMarkdown(adaptation); + const filename = `${exportSlug}.md`; + await writeFile(resolve(outputDirectory, filename), markdown); + manifestEntries.push({ + id: adaptation.id, + platform: adaptation.platform, + adaptationFormat: adaptation.format, + fileType: 'markdown', + file: filename, + width: null, + height: null, + frameRole: 'text-post', + caption: adaptation.caption, + altText: frames.map(completeAltText).join(' '), + frameIndex: null, + frameTotal: frames.length, + diagramId: null, + canonicalPath: adaptation.canonicalPath, + ...publicationMetadata(adaptation), + bytes: Buffer.byteLength(markdown), + sha256: sha256(markdown), + }); + + const companion = /** @type {Record | undefined} */ ( + exportContract.companionImage + ); + if (!companion) continue; + const frame = frames[0]; + if (!frame) throw new Error(`${adaptation.id} has no companion-image frame.`); + const width = Number(companion.width); + const height = Number(companion.height); + const route = `/exports/${exportSlug}-${String(frame.index).padStart(2, '0')}/`; + const page = await openExportPage(route, width, height); + const card = page.locator('[data-social-card]'); + await assertCardFits(card, route); + const raw = await card.screenshot({ type: 'png', animations: 'disabled' }); + const png = await sharp(raw) + .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false }) + .toBuffer(); + const repeatRaw = await card.screenshot({ type: 'png', animations: 'disabled' }); + const repeatPng = await sharp(repeatRaw) + .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false }) + .toBuffer(); + if (sha256(png) !== sha256(repeatPng)) { + throw new Error(`${adaptation.id} companion export is not deterministic.`); + } + const filenameImage = `${exportSlug}-companion.png`; + await writeFile(resolve(outputDirectory, filenameImage), png); + manifestEntries.push({ + id: `${adaptation.id}-COMPANION`, + platform: adaptation.platform, + adaptationFormat: adaptation.format, + fileType: 'png', + file: filenameImage, + width, + height, + frameRole: frame.role, + caption: adaptation.caption, + altText: completeAltText(frame), + frameIndex: frame.index, + frameTotal: frames.length, + diagramId: frame.diagramId ?? null, + canonicalPath: adaptation.canonicalPath, + ...publicationMetadata(adaptation), + bytes: png.byteLength, + sha256: sha256(png), + }); + await page.close(); + continue; + } + + if (exportContract.format === 'pdf') { + const width = Number(exportContract.width); + const height = Number(exportContract.height); + const route = `/exports/documents/${exportSlug}/`; + const page = await openExportPage(route, width, height); + const documentRoot = page.locator('[data-document-export]'); + if ((await documentRoot.count()) !== 1) { + throw new Error(`${route} must contain exactly one document export root.`); + } + const options = { + width: `${width}px`, + height: `${height}px`, + margin: { top: '0', right: '0', bottom: '0', left: '0' }, + printBackground: true, + preferCSSPageSize: true, + tagged: true, + outline: true, + }; + const pdf = normalisePdf(await page.pdf(options)); + const repeatPdf = normalisePdf(await page.pdf(options)); + if (sha256(pdf) !== sha256(repeatPdf)) { + throw new Error(`${adaptation.id} PDF export is not deterministic.`); + } + const filename = `${exportSlug}.pdf`; + await writeFile(resolve(outputDirectory, filename), pdf); + manifestEntries.push({ + id: adaptation.id, + platform: adaptation.platform, + adaptationFormat: adaptation.format, + fileType: 'pdf', + file: filename, + width, + height, + frameRole: 'document', + pageCount: frames.length, + caption: adaptation.caption, + altText: frames.map(completeAltText).join(' '), + frameIndex: null, + frameTotal: frames.length, + diagramId: null, + canonicalPath: adaptation.canonicalPath, + ...publicationMetadata(adaptation), + bytes: pdf.byteLength, + sha256: sha256(pdf), + }); + await page.close(); + continue; + } + + if (exportContract.format !== 'png') { + throw new Error(`${adaptation.id} has unsupported export format ${exportContract.format}.`); + } + const width = Number(exportContract.width); + const height = Number(exportContract.height); + for (const frame of frames) { + const frameIndex = String(frame.index).padStart(2, '0'); + const route = `/exports/${exportSlug}-${frameIndex}/`; + const page = await openExportPage(route, width, height); + const card = page.locator('[data-social-card]'); + if ((await card.count()) !== 1) { + throw new Error(`${route} must contain exactly one social card.`); + } + const box = await card.boundingBox(); + if (!box || Math.round(box.width) !== width || Math.round(box.height) !== height) { + throw new Error( + `${route} card is ${box?.width ?? 0}x${box?.height ?? 0}; expected ${width}x${height}.`, + ); + } + await assertCardFits(card, route); + const raw = await card.screenshot({ type: 'png', animations: 'disabled' }); + const png = await sharp(raw) + .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false }) + .toBuffer(); + const repeatRaw = await card.screenshot({ type: 'png', animations: 'disabled' }); + const repeatPng = await sharp(repeatRaw) + .png({ compressionLevel: 9, adaptiveFiltering: false, palette: false }) + .toBuffer(); + if (sha256(png) !== sha256(repeatPng)) { + throw new Error(`${adaptation.id} frame ${frame.index} is not deterministic.`); + } + const metadata = await sharp(png).metadata(); + if (metadata.width !== width || metadata.height !== height) { + throw new Error(`${route} exported ${metadata.width}x${metadata.height}.`); + } + const filename = `${exportSlug}-${frameIndex}.png`; + await writeFile(resolve(outputDirectory, filename), png); + manifestEntries.push({ + id: `${adaptation.id}-${frameIndex}`, + platform: adaptation.platform, + adaptationFormat: adaptation.format, + fileType: 'png', + file: filename, + width, + height, + frameRole: frame.role, + caption: adaptation.caption, + altText: completeAltText(frame), + frameIndex: frame.index, + frameTotal: frames.length, + diagramId: frame.diagramId ?? null, + canonicalPath: adaptation.canonicalPath, + ...publicationMetadata(adaptation), + bytes: png.byteLength, + sha256: sha256(png), + }); + await page.close(); + } + } + await context.close(); +} finally { + if (browser) await browser.close(); + server.close(); + await once(server, 'close'); + if (!dist.startsWith(`${root}/.export-dist-`)) { + throw new Error('Refusing to clean an unexpected export build directory.'); + } + await rm(dist, { recursive: true, force: true }); +} + +manifestEntries.sort((left, right) => String(left.id).localeCompare(String(right.id))); +const manifest = { + schemaVersion: 2, + generator: 'AgentSutra native platform exporter', + replayVerification: 'in-process', + files: manifestEntries, +}; +await writeFile( + resolve(outputDirectory, 'manifest.json'), + `${JSON.stringify(manifest, null, 2)}\n`, +); + +for (const entry of manifestEntries) { + const data = await readFile(resolve(outputDirectory, String(entry.file))); + const digest = sha256(data); + if (digest !== entry.sha256) throw new Error(`Post-write hash mismatch for ${entry.file}.`); +} + +const backupDirectory = resolve(exportRoot, `.social-backup-${process.pid}`); +let movedPreviousOutput = false; +try { + await rename(finalOutputDirectory, backupDirectory); + movedPreviousOutput = true; +} catch (error) { + if (!(error instanceof Error) || !('code' in error) || error.code !== 'ENOENT') throw error; +} +try { + await rename(outputDirectory, finalOutputDirectory); +} catch (error) { + if (movedPreviousOutput) await rename(backupDirectory, finalOutputDirectory); + throw error; +} +if (movedPreviousOutput) await rm(backupDirectory, { recursive: true, force: true }); + +const byType = Object.groupBy(manifestEntries, (entry) => String(entry.fileType)); +console.log( + `SOCIAL EXPORT PASS (${manifestEntries.length} files: ${Object.entries(byType) + .map(([type, files]) => `${files?.length ?? 0} ${type}`) + .join(', ')})`, +); diff --git a/publication/scripts/lib/files.mjs b/publication/scripts/lib/files.mjs new file mode 100644 index 0000000..ab4ac23 --- /dev/null +++ b/publication/scripts/lib/files.mjs @@ -0,0 +1,56 @@ +import { readdir, readFile } from 'node:fs/promises'; +import { extname, relative } from 'node:path'; + +const TEXT_EXTENSIONS = new Set([ + '.astro', + '.css', + '.csv', + '.html', + '.js', + '.json', + '.jsonc', + '.md', + '.mdx', + '.mjs', + '.svg', + '.txt', + '.ts', + '.xml', + '.yaml', + '.yml', +]); + +/** + * @param {string} directory + * @returns {Promise} + */ +export async function walkFiles(directory) { + const entries = await readdir(directory, { withFileTypes: true }); + const files = []; + + for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) { + const path = `${directory}/${entry.name}`; + if (entry.isSymbolicLink()) { + throw new Error(`Refusing to scan symbolic link: ${path}`); + } + if (entry.isDirectory()) files.push(...(await walkFiles(path))); + if (entry.isFile()) files.push(path); + } + + return files; +} + +/** @param {string} path */ +export function isTextFile(path) { + return TEXT_EXTENSIONS.has(extname(path).toLowerCase()); +} + +/** @param {string} path */ +export async function readUtf8(path) { + return readFile(path, 'utf8'); +} + +/** @param {string} root @param {string} path */ +export function displayPath(root, path) { + return relative(root, path) || '.'; +} diff --git a/publication/scripts/lib/privacy-rules.mjs b/publication/scripts/lib/privacy-rules.mjs new file mode 100644 index 0000000..d215c0a --- /dev/null +++ b/publication/scripts/lib/privacy-rules.mjs @@ -0,0 +1,64 @@ +const privateNetworkName = ['tail', 'net'].join(''); +const doNotPublishMarker = ['DO NOT', 'PUBLISH'].join(' '); +const beginPrivateMarker = ['BEGIN', 'PRIVATE'].join(' '); + +/** @type {Array} */ +export const privacyRules = [ + ['macOS user path', /\/Users\/[A-Za-z0-9._-]+\//giu], + ['Linux user path', /\/home\/[A-Za-z0-9._-]+\//giu], + ['Windows user path', /[A-Z]:\\Users\\[^\\\s]+\\/giu], + [ + 'private IPv4 address', + /\b(?:10\.\d{1,3}\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3}|172\.(?:1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3})\b/gu, + ], + ['Tailscale address', /\b100\.(?:6[4-9]|[7-9]\d|1[01]\d|12[0-7])\.\d{1,3}\.\d{1,3}\b/gu], + [ + 'private hostname', + new RegExp( + `\\b(?:[A-Za-z0-9-]+\\.(?:local|lan|internal|ts\\.net)|${privateNetworkName}|agentsutra-(?:m|node|mini)\\d*)\\b`, + 'giu', + ), + ], + ['local service URL', /https?:\/\/(?:localhost|127\.0\.0\.1|\[::1\])(?::\d+)?/giu], + [ + 'private content marker', + new RegExp( + `(?:\\[(?:PRIVATE|CONFIDENTIAL|INTERNAL ONLY)\\]|${beginPrivateMarker}|${doNotPublishMarker})`, + 'giu', + ), + ], + [ + 'structured client identity', + /^\s*(?:client|clientName|customer|customerName)\s*[:=]\s*\S+/gimu, + ], + ['known private project identity', new RegExp(`\\b${['Role', 'Demand'].join('')}\\b`, 'giu')], + ['private key material', /-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/gu], + [ + 'credential-shaped value', + /\b(?:sk-ant-[A-Za-z0-9_-]{20,}|sk-proj-[A-Za-z0-9_-]{20,}|gh[pousr]_[A-Za-z0-9]{30,}|AKIA[A-Z0-9]{16})\b/gu, + ], + [ + 'credential assignment', + /\b(?:api[_-]?key|secret|password|token)\s*[:=]\s*["'][^"'\s]{12,}["']/giu, + ], +]; + +/** @param {string} text @param {number} index */ +function locationFor(text, index) { + const prefix = text.slice(0, index); + const line = prefix.split('\n').length; + const lastBreak = prefix.lastIndexOf('\n'); + return { line, column: index - lastBreak }; +} + +/** @param {string} text */ +export function scanPrivateMaterial(text) { + const findings = []; + for (const [name, pattern] of privacyRules) { + pattern.lastIndex = 0; + for (const match of text.matchAll(pattern)) { + findings.push({ name, ...locationFor(text, match.index ?? 0) }); + } + } + return findings; +} diff --git a/publication/scripts/lib/publication-profiles.mjs b/publication/scripts/lib/publication-profiles.mjs new file mode 100644 index 0000000..491c400 --- /dev/null +++ b/publication/scripts/lib/publication-profiles.mjs @@ -0,0 +1,70 @@ +export const publicationProfiles = { + prelaunch: { + environment: { + PUBLICATION_PROFILE: 'prelaunch', + PUBLIC_LAUNCH: '0', + INCLUDE_FIXTURES: '0', + EXPORT_MODE: '0', + }, + robots: `User-agent: * +Allow: / + +Sitemap: https://agentsutra.dev/sitemap-index.xml +`, + }, + public: { + environment: { + PUBLICATION_PROFILE: 'public', + PUBLIC_LAUNCH: '1', + INCLUDE_FIXTURES: '0', + EXPORT_MODE: '0', + }, + robots: `User-agent: * +Allow: / + +Sitemap: https://agentsutra.dev/sitemap-index.xml +`, + }, +}; + +const sharedHeaders = [ + '/*', + " Content-Security-Policy: default-src 'none'; base-uri 'none'; connect-src 'self'; font-src 'self'; form-action 'none'; frame-ancestors 'none'; img-src 'self' data:; manifest-src 'self'; media-src 'self'; object-src 'none'; script-src 'none'; style-src 'self'; worker-src 'none'; upgrade-insecure-requests", + ' Cross-Origin-Opener-Policy: same-origin', + ' Cross-Origin-Resource-Policy: same-origin', + ' Permissions-Policy: accelerometer=(), ambient-light-sensor=(), autoplay=(), camera=(), display-capture=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), publickey-credentials-get=(), screen-wake-lock=(), usb=()', + ' Referrer-Policy: strict-origin-when-cross-origin', + ' X-Content-Type-Options: nosniff', + ' X-Frame-Options: DENY', +]; + +const cacheHeaders = [ + '', + '/_astro/*', + ' Cache-Control: public, max-age=31536000, immutable', + '', + '/favicon.svg', + ' Cache-Control: public, max-age=86400', + '', + '/favicon.ico', + ' Cache-Control: public, max-age=86400', + '', +]; + +/** @param {unknown} profile */ +export function assertPublicationProfile(profile) { + if (typeof profile !== 'string' || !(profile in publicationProfiles)) { + throw new Error(`Unknown publication profile: ${String(profile)}.`); + } + return /** @type {keyof typeof publicationProfiles} */ (profile); +} + +/** @param {unknown} profile */ +export function headersForProfile(profile) { + const safeProfile = assertPublicationProfile(profile); + const lines = [...sharedHeaders]; + if (safeProfile === 'prelaunch') { + lines.push(' X-Robots-Tag: noindex, nofollow, noarchive, nosnippet'); + } + return [...lines, ...cacheHeaders].join('\n'); +} diff --git a/publication/scripts/lib/publication-truth.mjs b/publication/scripts/lib/publication-truth.mjs new file mode 100644 index 0000000..2b55d32 --- /dev/null +++ b/publication/scripts/lib/publication-truth.mjs @@ -0,0 +1,20 @@ +/** + * Preserve the exact ordered characters of a publication claim while ignoring + * whitespace inserted by PDF layout and extraction engines. + * + * @param {unknown} value + */ +export function comparablePublicationText(value) { + return String(value).normalize('NFKC').replace(/\s+/gu, ''); +} + +/** + * @param {unknown} source + * @param {unknown} expected + */ +export function containsPublicationTruth(source, expected) { + const comparableExpected = comparablePublicationText(expected); + return ( + comparableExpected.length > 0 && comparablePublicationText(source).includes(comparableExpected) + ); +} diff --git a/publication/scripts/lib/release-archive.mjs b/publication/scripts/lib/release-archive.mjs new file mode 100644 index 0000000..7646186 --- /dev/null +++ b/publication/scripts/lib/release-archive.mjs @@ -0,0 +1,318 @@ +import { createHash } from 'node:crypto'; +import { + chmod, + copyFile, + mkdir, + mkdtemp, + readFile, + rename, + rm, + stat, + writeFile, +} from 'node:fs/promises'; +import { tmpdir } from 'node:os'; +import { basename, dirname, relative, resolve } from 'node:path'; +import { spawn } from 'node:child_process'; + +import { walkFiles } from './files.mjs'; + +const SOURCE_PREFIX = 'agentsutra-publication/'; +const PREVIEW_PREFIX = 'agentsutra-publication-preview/'; +const RELEASE_DATE = '2000-01-01T00:00:00Z'; + +const forbiddenSourceRoots = [ + '.agents/', + '.astro/', + '.codex/', + '.export-dist', + '.fixture-dist/', + '.release/', + '.wrangler/', + 'coverage/', + 'dist/', + 'exports/', + 'node_modules/', + 'playwright-report/', + 'test-results/', +]; + +/** + * @param {string} command + * @param {string[]} args + * @param {{ cwd: string; env?: NodeJS.ProcessEnv }} options + * @returns {Promise<{ stdout: string; stderr: string }>} + */ +async function run(command, args, options) { + return new Promise((resolvePromise, reject) => { + const child = spawn(command, args, { + cwd: options.cwd, + env: options.env ?? process.env, + stdio: ['ignore', 'pipe', 'pipe'], + }); + let stdout = ''; + let stderr = ''; + child.stdout.setEncoding('utf8'); + child.stderr.setEncoding('utf8'); + child.stdout.on('data', (chunk) => { + stdout += chunk; + }); + child.stderr.on('data', (chunk) => { + stderr += chunk; + }); + child.once('error', reject); + child.once('exit', (code, signal) => { + if (code === 0) { + resolvePromise({ stdout, stderr }); + return; + } + reject( + new Error( + `${command} ${args.join(' ')} exited with ${ + signal ? `signal ${signal}` : `code ${String(code)}` + }.${stderr ? `\n${stderr.trim()}` : ''}`, + ), + ); + }); + }); +} + +/** @param {string} path */ +function portable(path) { + return path.replaceAll('\\', '/'); +} + +/** + * @param {string[]} entries + * @param {'source' | 'preview'} kind + */ +export function assertSafeArchiveEntries(entries, kind) { + for (const entry of entries) { + const path = portable(entry); + const segments = path.split('/'); + if (!path || path.startsWith('/') || segments.includes('..')) { + throw new Error(`Unsafe ${kind} archive path: ${entry}`); + } + if (segments.includes('.DS_Store') || segments.includes('__MACOSX')) { + throw new Error(`Platform metadata is forbidden in ${kind} archives: ${entry}`); + } + if (kind === 'source') { + if (forbiddenSourceRoots.some((prefix) => path.startsWith(prefix))) { + throw new Error(`Generated or local-only source archive entry: ${entry}`); + } + } + } +} + +/** + * @param {string} repositoryRoot + * @param {string} publicationPath + */ +export async function assertPublicationTreeClean(repositoryRoot, publicationPath = 'publication') { + const result = await run( + 'git', + ['status', '--porcelain=v1', '--untracked-files=all', '--', publicationPath], + { cwd: repositoryRoot }, + ); + if (result.stdout.trim()) { + throw new Error( + [ + 'Release archive refused: the publication tree differs from HEAD.', + 'Commit or intentionally discard every tracked and untracked publication change first.', + result.stdout.trim(), + ].join('\n'), + ); + } +} + +/** @param {string} path */ +export async function sha256File(path) { + const contents = await readFile(path); + return createHash('sha256').update(contents).digest('hex'); +} + +/** + * @param {string} archivePath + * @param {string} digest + */ +async function writeChecksum(archivePath, digest) { + const checksumPath = `${archivePath}.sha256`; + const temporaryPath = `${checksumPath}.tmp-${process.pid}`; + await writeFile(temporaryPath, `${digest} ${basename(archivePath)}\n`, 'utf8'); + await rename(temporaryPath, checksumPath); + return checksumPath; +} + +/** + * @param {{ repositoryRoot: string; outputDirectory: string; publicationPath?: string }} options + */ +export async function createSourceArchive(options) { + const publicationPath = options.publicationPath ?? 'publication'; + await assertPublicationTreeClean(options.repositoryRoot, publicationPath); + + const [ + { stdout: fullCommit }, + { stdout: shortCommit }, + { stdout: commitEpoch }, + { stdout: tree }, + ] = await Promise.all([ + run('git', ['rev-parse', 'HEAD'], { cwd: options.repositoryRoot }), + run('git', ['rev-parse', '--short=12', 'HEAD'], { cwd: options.repositoryRoot }), + run('git', ['show', '--no-patch', '--format=%ct', 'HEAD'], { cwd: options.repositoryRoot }), + run('git', ['ls-tree', '-r', '--name-only', `HEAD:${publicationPath}`], { + cwd: options.repositoryRoot, + }), + ]); + // `HEAD:` resolves to a tree, so Git otherwise assigns every ZIP entry the current time. + const archiveMtime = commitEpoch.trim(); + if (!/^\d+$/u.test(archiveMtime)) { + throw new Error(`Source archive commit time is invalid: ${archiveMtime}`); + } + const entries = tree + .split(/\r?\n/u) + .filter(Boolean) + .filter((path) => !path.startsWith('.agents/') && !path.startsWith('.codex/')); + assertSafeArchiveEntries(entries, 'source'); + if (!entries.includes('package.json') || !entries.includes('package-lock.json')) { + throw new Error('Source archive tree is missing the publication package manifest or lockfile.'); + } + + await mkdir(options.outputDirectory, { recursive: true }); + const archiveName = `agentsutra-publication-source-${shortCommit.trim()}.zip`; + const archivePath = resolve(options.outputDirectory, archiveName); + const temporaryPath = `${archivePath}.tmp-${process.pid}`; + try { + await run( + 'git', + [ + 'archive', + '--format=zip', + `--mtime=@${archiveMtime}`, + `--prefix=${SOURCE_PREFIX}`, + `--output=${temporaryPath}`, + `HEAD:${publicationPath}`, + '--', + '.', + ':(exclude).agents', + ':(exclude).codex', + ], + { cwd: options.repositoryRoot, env: { ...process.env, TZ: 'UTC' } }, + ); + await rename(temporaryPath, archivePath); + } catch (error) { + await rm(temporaryPath, { force: true }); + throw error; + } + const digest = await sha256File(archivePath); + const checksumPath = await writeChecksum(archivePath, digest); + return { + archivePath, + checksumPath, + digest, + entries, + commit: fullCommit.trim(), + }; +} + +/** + * Create a byte-stable ZIP by committing normalised files in a disposable Git repository with a + * fixed identity and timestamp, then asking Git to archive that immutable tree. + * + * @param {{ sourceDirectory: string; outputPath: string }} options + */ +export async function createDeterministicPreviewZip(options) { + const sourceFiles = await walkFiles(options.sourceDirectory); + const entries = sourceFiles.map((path) => portable(relative(options.sourceDirectory, path))); + assertSafeArchiveEntries(entries, 'preview'); + if ( + !entries.includes('index.html') || + !entries.includes('robots.txt') || + !entries.includes('_headers') + ) { + throw new Error('Validated preview output is missing index.html, robots.txt, or _headers.'); + } + + const temporaryRoot = await mkdtemp(resolve(tmpdir(), 'agentsutra-preview-archive-')); + const repository = resolve(temporaryRoot, 'repository'); + const temporaryArchive = `${options.outputPath}.tmp-${process.pid}`; + try { + await mkdir(repository, { recursive: true }); + for (const sourcePath of sourceFiles) { + const relativePath = portable(relative(options.sourceDirectory, sourcePath)); + const destination = resolve(repository, relativePath); + await mkdir(dirname(destination), { recursive: true }); + await copyFile(sourcePath, destination); + await chmod(destination, 0o644); + } + + await run('git', ['init', '--quiet'], { cwd: repository }); + await run('git', ['config', 'core.filemode', 'false'], { cwd: repository }); + await run('git', ['add', '--all'], { cwd: repository }); + const fixedEnvironment = { + ...process.env, + GIT_AUTHOR_DATE: RELEASE_DATE, + GIT_COMMITTER_DATE: RELEASE_DATE, + GIT_AUTHOR_NAME: 'AgentSutra release pipeline', + GIT_AUTHOR_EMAIL: 'release@agentsutra.dev', + GIT_COMMITTER_NAME: 'AgentSutra release pipeline', + GIT_COMMITTER_EMAIL: 'release@agentsutra.dev', + TZ: 'UTC', + }; + await run('git', ['commit', '--quiet', '--message', 'validated static preview'], { + cwd: repository, + env: fixedEnvironment, + }); + await mkdir(dirname(options.outputPath), { recursive: true }); + await run( + 'git', + [ + 'archive', + '--format=zip', + `--prefix=${PREVIEW_PREFIX}`, + `--output=${temporaryArchive}`, + 'HEAD', + ], + { cwd: repository }, + ); + await rename(temporaryArchive, options.outputPath); + } catch (error) { + await rm(temporaryArchive, { force: true }); + throw error; + } finally { + await rm(temporaryRoot, { recursive: true, force: true }); + } + return { entries, digest: await sha256File(options.outputPath) }; +} + +/** + * @param {{ repositoryRoot: string; publicationRoot: string; outputDirectory: string }} options + */ +export async function createPreviewArchive(options) { + await assertPublicationTreeClean( + options.repositoryRoot, + relative(options.repositoryRoot, options.publicationRoot), + ); + const { stdout: shortCommit } = await run('git', ['rev-parse', '--short=12', 'HEAD'], { + cwd: options.repositoryRoot, + }); + const dist = resolve(options.publicationRoot, 'dist'); + const { buildPublicationProfile } = await import('../build-profile.mjs'); + await buildPublicationProfile('prelaunch', { destination: dist }); + + await mkdir(options.outputDirectory, { recursive: true }); + const archivePath = resolve( + options.outputDirectory, + `agentsutra-publication-preview-${shortCommit.trim()}.zip`, + ); + const result = await createDeterministicPreviewZip({ + sourceDirectory: dist, + outputPath: archivePath, + }); + const checksumPath = await writeChecksum(archivePath, result.digest); + return { ...result, archivePath, checksumPath }; +} + +/** @param {string} path */ +export async function assertRegularFile(path) { + const details = await stat(path); + if (!details.isFile()) throw new Error(`Expected a regular file: ${path}`); +} diff --git a/publication/scripts/lib/release-artifact.mjs b/publication/scripts/lib/release-artifact.mjs new file mode 100644 index 0000000..adb1d3c --- /dev/null +++ b/publication/scripts/lib/release-artifact.mjs @@ -0,0 +1,15 @@ +const publicOnlyMarker = + /(?:FN-000|experiment-fn-000|Synthetic specimen|FIELD \/ 00|No public Field Notes yet|Inspect FN-000|first evidence-reviewed Field Notes are in private pilot production|pilot record)/iu; + +/** @param {string} html */ +export function containsPublicOnlyMarker(html) { + return publicOnlyMarker.test(html); +} + +/** + * @param {string} html + * @param {readonly string[]} fieldNoteRoutes + */ +export function linksBuiltFieldNote(html, fieldNoteRoutes) { + return fieldNoteRoutes.some((route) => html.includes(`href="${route}"`)); +} diff --git a/publication/scripts/privacy-scan.mjs b/publication/scripts/privacy-scan.mjs new file mode 100644 index 0000000..2ff0dd5 --- /dev/null +++ b/publication/scripts/privacy-scan.mjs @@ -0,0 +1,74 @@ +import { execFile } from 'node:child_process'; +import { access } from 'node:fs/promises'; +import { basename, resolve } from 'node:path'; +import process from 'node:process'; +import { promisify } from 'node:util'; + +import { displayPath, isTextFile, readUtf8, walkFiles } from './lib/files.mjs'; +import { scanPrivateMaterial } from './lib/privacy-rules.mjs'; + +const executeFile = promisify(execFile); +const root = resolve(import.meta.dirname, '..'); +const dist = resolve(root, 'dist'); +const extensionlessTextFiles = new Set(['.npmrc', '.nvmrc', '.node-version', 'LICENSE']); + +async function trackedRepositoryFiles() { + const { stdout } = await executeFile( + 'git', + ['ls-files', '--cached', '--others', '--exclude-standard', '-z'], + { + cwd: root, + encoding: 'buffer', + maxBuffer: 16 * 1024 * 1024, + }, + ); + return stdout + .toString('utf8') + .split('\0') + .filter(Boolean) + .map((path) => resolve(root, path)); +} + +async function builtArtifactFiles() { + try { + await access(dist); + return walkFiles(dist); + } catch { + return []; + } +} + +const candidates = [...(await trackedRepositoryFiles()), ...(await builtArtifactFiles())].filter( + (path, index, files) => files.indexOf(path) === index, +); + +/** @type {string[]} */ +const violations = []; +let scannedFiles = 0; + +for (const path of candidates) { + const relativePath = displayPath(root, path).replaceAll('\\', '/'); + if (relativePath.startsWith('dist/.prerender/')) continue; + if (!isTextFile(path) && !extensionlessTextFiles.has(basename(path))) continue; + scannedFiles += 1; + const text = await readUtf8(path); + for (const finding of scanPrivateMaterial(text)) { + const isLocalTestEndpoint = + finding.name === 'local service URL' && + (relativePath.startsWith('tests/') || + relativePath === 'playwright.config.ts' || + relativePath === 'design-explorations/verify.mjs'); + const isSyntheticDesignSafetyLabel = + finding.name === 'private content marker' && relativePath.startsWith('design-explorations/'); + if (isLocalTestEndpoint || isSyntheticDesignSafetyLabel) continue; + violations.push(`${relativePath}:${finding.line}:${finding.column} ${finding.name}`); + } +} + +if (violations.length > 0) { + console.error('PRIVACY SCAN FAILED'); + for (const violation of violations) console.error(`- ${violation}`); + process.exitCode = 1; +} else { + console.log(`PRIVACY SCAN PASS (${scannedFiles} repository or built text files)`); +} diff --git a/publication/scripts/validate-dist.mjs b/publication/scripts/validate-dist.mjs new file mode 100644 index 0000000..64f23d0 --- /dev/null +++ b/publication/scripts/validate-dist.mjs @@ -0,0 +1,200 @@ +import { access } from 'node:fs/promises'; +import { extname, relative, resolve } from 'node:path'; +import process from 'node:process'; +import { readUtf8, walkFiles } from './lib/files.mjs'; +import { assertPublicationProfile, publicationProfiles } from './lib/publication-profiles.mjs'; +import { containsPublicOnlyMarker, linksBuiltFieldNote } from './lib/release-artifact.mjs'; + +const root = resolve(import.meta.dirname, '..'); +/** @param {string} name */ +const readArgument = (name) => { + const index = process.argv.indexOf(name); + return index === -1 ? undefined : process.argv[index + 1]; +}; +const profile = assertPublicationProfile(readArgument('--profile') ?? 'prelaunch'); +const dist = resolve(readArgument('--dir') ?? resolve(root, 'dist')); +/** @type {string[]} */ +const failures = []; + +/** @param {string} message */ +function fail(message) { + failures.push(message); +} + +try { + await access(resolve(dist, 'index.html')); +} catch { + fail('dist/index.html is missing; run the production build first'); +} + +/** @type {string[]} */ +let files = []; +try { + files = await walkFiles(dist); +} catch (error) { + fail(error instanceof Error ? error.message : String(error)); +} + +const forbiddenRoute = /^(?:__exports?|exports?|fixtures?|drafts?|interviews?)(?:\/|\.|$)/iu; +for (const path of files) { + const relativePath = relative(dist, path).replaceAll('\\', '/'); + if (forbiddenRoute.test(relativePath)) fail(`forbidden production route/file: ${relativePath}`); + if (/^field-notes\/fn-000(?:-|\/)/iu.test(relativePath)) { + fail(`synthetic FN-000 route leaked into production: ${relativePath}`); + } +} + +const htmlFiles = files.filter((path) => extname(path) === '.html'); +if (htmlFiles.length === 0) fail('production output contains no HTML pages'); +const publicFieldNoteFiles = htmlFiles.filter((path) => + /^field-notes\/[a-z0-9]+(?:-[a-z0-9]+)*\/index\.html$/u.test( + relative(dist, path).replaceAll('\\', '/'), + ), +); +const publicFieldNoteRoutes = publicFieldNoteFiles.map( + (path) => + `/${relative(dist, path) + .replaceAll('\\', '/') + .replace(/index\.html$/u, '')}`, +); +if (profile === 'public' && publicFieldNoteFiles.length === 0) { + fail('public release requires at least one validated, published Field Note route'); +} + +for (const path of htmlFiles) { + const relativePath = relative(dist, path).replaceAll('\\', '/'); + const html = await readUtf8(path); + + if (!/]*\blang=["'][^"']+["']/iu.test(html)) fail(`${relativePath}: missing html lang`); + if ((html.match(/]*\bname=["']robots["'][^>]*\bcontent=["'][^"']*noindex/iu.test(html); + if (profile === 'prelaunch' && !declaresNoIndex) { + fail(`${relativePath}: prelaunch pages must declare noindex`); + } + if (profile === 'public' && relativePath !== '404.html' && declaresNoIndex) { + fail(`${relativePath}: public pages must not declare noindex`); + } + if (profile === 'public' && relativePath === '404.html' && !declaresNoIndex) { + fail('404.html must remain noindex in the public profile'); + } + if (profile === 'public' && containsPublicOnlyMarker(html)) { + fail(`${relativePath}: public HTML contains a reserved pre-launch or synthetic marker`); + } + if (profile === 'public' && relativePath === 'index.html' && />Private pilot 0 && + !linksBuiltFieldNote(html, publicFieldNoteRoutes) + ) { + fail('public homepage must link to at least one built, reviewed Field Note route'); + } + if (/]*)>([\s\S]*?)<\/script>/giu)) { + const attributes = match[1] ?? ''; + if (!/\btype=["']application\/ld\+json["']/iu.test(attributes)) { + fail(`${relativePath}: ordinary production pages must not ship client JavaScript`); + continue; + } + try { + JSON.parse(match[2] ?? ''); + } catch { + fail(`${relativePath}: invalid JSON-LD`); + } + } + + const runtimePatterns = [ + /<(?:script|img|iframe|audio|video|source)\b[^>]*(?:src|poster)=["'](?:https?:)?\/\//giu, + /\bsrcset=["'][^"']*(?:https?:)?\/\//giu, + /]*\brel=["'](?:stylesheet|preload|modulepreload)["'][^>]*\bhref=["'](?:https?:)?\/\//giu, + /]*http-equiv=["']refresh["'][^>]*content=["'][^"']*(?:https?:)?\/\//giu, + ]; + if (runtimePatterns.some((pattern) => pattern.test(html))) { + fail(`${relativePath}: external runtime request detected`); + } +} + +for (const path of files.filter((file) => extname(file) === '.css')) { + const css = await readUtf8(path); + if (/(?:@import\s+|url\()["']?https?:\/\//iu.test(css)) { + fail(`${relative(dist, path)}: external CSS runtime request detected`); + } +} + +const requiredFiles = ['robots.txt', '_headers']; +for (const requiredFile of requiredFiles) { + try { + await access(resolve(dist, requiredFile)); + } catch { + fail(`dist/${requiredFile} is missing`); + } +} + +try { + const robots = await readUtf8(resolve(dist, 'robots.txt')); + if (robots !== publicationProfiles[profile].robots) { + fail(`${profile} robots.txt does not match the generated publication profile`); + } + if (!robots.includes('Allow: /') || robots.includes('Disallow: /')) { + fail(`${profile} robots.txt must allow crawling so page and header indexing policy is visible`); + } + if (!robots.includes('Sitemap: https://agentsutra.dev/sitemap-index.xml')) { + fail(`${profile} robots.txt must declare the canonical sitemap`); + } +} catch { + // Missing-file failure is reported above. +} + +try { + const headers = await readUtf8(resolve(dist, '_headers')); + for (const header of ['Content-Security-Policy:', 'X-Content-Type-Options:']) { + if (!headers.includes(header)) fail(`_headers is missing ${header}`); + } + const hasRobotsHeader = /^\s*X-Robots-Tag:/imu.test(headers); + const hasNoIndexRobotsHeader = /^\s*X-Robots-Tag:[^\r\n]*\bnoindex\b/imu.test(headers); + if (profile === 'prelaunch' && !hasNoIndexRobotsHeader) { + fail('prelaunch _headers must include an X-Robots-Tag value containing noindex'); + } + if (profile === 'public' && hasRobotsHeader) { + fail('public _headers must not include a site-wide X-Robots-Tag'); + } + if (/Strict-Transport-Security:/iu.test(headers)) { + fail('HSTS must remain disabled until agentsutra.dev is verified end to end'); + } +} catch { + // Missing-file failure is reported above. +} + +const sitemapFiles = files.filter((path) => /sitemap.*\.xml$/iu.test(path)); +if (sitemapFiles.length === 0) fail('sitemap output is missing'); +for (const path of sitemapFiles) { + const sitemap = await readUtf8(path); + const forbiddenSitemapLocation = + /https:\/\/agentsutra\.dev\/(?:__exports?|exports?|fixtures?|drafts?|interviews?)(?:\/|<)/iu; + if (forbiddenSitemapLocation.test(sitemap)) { + fail(`${relative(dist, path)} contains a forbidden route`); + } + if (/\/field-notes\/fn-000(?:-|\/)/iu.test(sitemap)) { + fail(`${relative(dist, path)} contains the synthetic FN-000 route`); + } +} + +if (failures.length > 0) { + console.error('DIST VALIDATION FAILED'); + for (const failure of [...new Set(failures)]) console.error(`- ${failure}`); + process.exitCode = 1; +} else { + console.log( + `DIST VALIDATION PASS (${profile}; ${htmlFiles.length} HTML pages; ${files.length} files)`, + ); +} diff --git a/publication/scripts/validate-export-artifacts.mjs b/publication/scripts/validate-export-artifacts.mjs new file mode 100644 index 0000000..ebba568 --- /dev/null +++ b/publication/scripts/validate-export-artifacts.mjs @@ -0,0 +1,148 @@ +import { createHash } from 'node:crypto'; +import { execFile } from 'node:child_process'; +import { readFile } from 'node:fs/promises'; +import { extname, resolve } from 'node:path'; +import { promisify } from 'node:util'; + +import sharp from 'sharp'; + +import { scanPrivateMaterial } from './lib/privacy-rules.mjs'; +import { containsPublicationTruth } from './lib/publication-truth.mjs'; + +const executeFile = promisify(execFile); +const root = resolve(import.meta.dirname, '..'); +const outputDirectory = resolve(root, 'exports/social'); +const manifestPath = resolve(outputDirectory, 'manifest.json'); + +/** @param {Buffer|string} value */ +function sha256(value) { + return createHash('sha256').update(value).digest('hex'); +} + +/** @param {string} label @param {string} text */ +function assertPrivacy(label, text) { + const findings = scanPrivateMaterial(text); + if (findings.length > 0) { + throw new Error( + `${label} contains private-material signatures: ${findings.map((item) => item.name).join(', ')}`, + ); + } +} + +/** @param {Record} entry @param {string} text */ +function assertPublicationTruth(entry, text) { + for (const key of ['centralClaim', 'evidenceStatus', 'evidenceBoundary', 'correctionStatus']) { + if (!containsPublicationTruth(text, entry[key])) { + throw new Error(`${entry.file} does not preserve ${key} in selectable text.`); + } + } +} + +const manifestSource = await readFile(manifestPath, 'utf8'); +assertPrivacy('export manifest', manifestSource); +const manifest = JSON.parse(manifestSource); +if (manifest.schemaVersion !== 2 || manifest.replayVerification !== 'cross-build') { + throw new Error('Export manifest must be schema v2 with cross-build replay verification.'); +} +if (!Array.isArray(manifest.files) || manifest.files.length === 0) { + throw new Error('Export manifest contains no artifacts.'); +} + +const ids = new Set(); +const files = new Set(); +for (const entry of manifest.files) { + for (const key of [ + 'id', + 'fieldNoteId', + 'evidencePackId', + 'platform', + 'adaptationFormat', + 'fileType', + 'file', + 'frameRole', + 'caption', + 'altText', + 'canonicalPath', + 'centralClaim', + 'evidenceStatus', + 'evidenceBoundary', + 'correctionStatus', + 'lifecycle', + 'bytes', + 'sha256', + ]) { + if (!(key in entry) || entry[key] === '') + throw new Error(`${entry.id ?? 'artifact'} lacks ${key}.`); + } + if (ids.has(entry.id) || files.has(entry.file)) { + throw new Error(`Duplicate export identity or filename: ${entry.id} / ${entry.file}.`); + } + ids.add(entry.id); + files.add(entry.file); + + const path = resolve(outputDirectory, String(entry.file)); + if (!path.startsWith(`${outputDirectory}/`)) + throw new Error(`${entry.file} escapes export root.`); + const data = await readFile(path); + if (data.byteLength !== entry.bytes || sha256(data) !== entry.sha256) { + throw new Error(`${entry.file} does not match its recorded bytes and SHA-256.`); + } + + const extension = extname(path); + if (entry.fileType === 'png') { + if (extension !== '.png') throw new Error(`${entry.file} has the wrong extension.`); + const metadata = await sharp(data).metadata(); + if (metadata.width !== entry.width || metadata.height !== entry.height) { + throw new Error(`${entry.file} dimensions do not match the manifest.`); + } + if (metadata.exif || metadata.icc || metadata.iptc || metadata.xmp) { + throw new Error(`${entry.file} contains unreviewed embedded metadata.`); + } + if (entry.frameIndex === null || entry.frameTotal < entry.frameIndex) { + throw new Error(`${entry.file} has invalid frame position metadata.`); + } + continue; + } + + if (entry.fileType === 'markdown') { + if (extension !== '.md') throw new Error(`${entry.file} has the wrong extension.`); + const text = data.toString('utf8'); + assertPrivacy(entry.file, text); + assertPublicationTruth(entry, text); + if (!text.includes(`https://agentsutra.dev${entry.canonicalPath}`)) { + throw new Error(`${entry.file} lacks an absolute canonical link.`); + } + continue; + } + + if (entry.fileType !== 'pdf' || extension !== '.pdf') { + throw new Error(`${entry.file} uses an unsupported artifact type.`); + } + const [{ stdout: info }, { stdout: extractedText }] = await Promise.all([ + executeFile('pdfinfo', [path], { encoding: 'utf8', maxBuffer: 4 * 1024 * 1024 }), + executeFile('pdftotext', ['-layout', path, '-'], { + encoding: 'utf8', + maxBuffer: 16 * 1024 * 1024, + }), + ]); + const pageCount = Number(info.match(/^Pages:\s+(\d+)/mu)?.[1]); + const pageSize = info.match(/^Page size:\s+([\d.]+) x ([\d.]+) pts/mu); + if (pageCount !== entry.pageCount || pageCount !== entry.frameTotal) { + throw new Error(`${entry.file} page count differs from its source and manifest.`); + } + if (!/^Tagged:\s+yes$/imu.test(info)) throw new Error(`${entry.file} is not a tagged PDF.`); + if (!pageSize) throw new Error(`${entry.file} has no readable page-size metadata.`); + const expectedWidth = Number(entry.width) * 0.75; + const expectedHeight = Number(entry.height) * 0.75; + if ( + Math.abs(Number(pageSize[1]) - expectedWidth) > 1 || + Math.abs(Number(pageSize[2]) - expectedHeight) > 1 + ) { + throw new Error(`${entry.file} page box does not match its declared pixel contract.`); + } + assertPrivacy(`${entry.file} metadata`, info); + assertPrivacy(`${entry.file} extracted text`, extractedText); + assertPublicationTruth(entry, extractedText); +} + +console.log(`EXPORT ARTIFACT VALIDATION PASS (${manifest.files.length} files)`); diff --git a/publication/scripts/verify-export-replay.mjs b/publication/scripts/verify-export-replay.mjs new file mode 100644 index 0000000..783512d --- /dev/null +++ b/publication/scripts/verify-export-replay.mjs @@ -0,0 +1,81 @@ +import { createHash } from 'node:crypto'; +import { spawn } from 'node:child_process'; +import { readdir, readFile, writeFile } from 'node:fs/promises'; +import { resolve } from 'node:path'; +import process from 'node:process'; + +const root = resolve(import.meta.dirname, '..'); +const outputDirectory = resolve(root, 'exports/social'); +const manifestPath = resolve(outputDirectory, 'manifest.json'); + +/** @param {Buffer|string} value */ +function sha256(value) { + return createHash('sha256').update(value).digest('hex'); +} + +function runExport() { + return new Promise((resolvePromise, reject) => { + const child = spawn('npm', ['run', 'export:social'], { + cwd: root, + env: { ...process.env, INCLUDE_FIXTURES: '1', EXPORT_MODE: '1' }, + stdio: 'inherit', + }); + child.once('error', reject); + child.once('exit', (code, signal) => { + if (code === 0) resolvePromise(undefined); + else reject(new Error(`export:social exited with ${code ?? signal}`)); + }); + }); +} + +function validateArtifacts() { + return new Promise((resolvePromise, reject) => { + const child = spawn('node', ['scripts/validate-export-artifacts.mjs'], { + cwd: root, + env: process.env, + stdio: 'inherit', + }); + child.once('error', reject); + child.once('exit', (code, signal) => { + if (code === 0) resolvePromise(undefined); + else reject(new Error(`export artifact validation exited with ${code ?? signal}`)); + }); + }); +} + +async function snapshot() { + /** @type {Record} */ + const files = {}; + for (const entry of (await readdir(outputDirectory, { withFileTypes: true })).sort((a, b) => + a.name.localeCompare(b.name), + )) { + if (!entry.isFile()) continue; + const data = await readFile(resolve(outputDirectory, entry.name)); + files[entry.name] = { bytes: data.byteLength, sha256: sha256(data) }; + } + return files; +} + +await runExport(); +const first = await snapshot(); +await runExport(); +const second = await snapshot(); + +if (JSON.stringify(first) !== JSON.stringify(second)) { + const names = [...new Set([...Object.keys(first), ...Object.keys(second)])].sort(); + const mismatches = names.filter( + (name) => + first[name]?.bytes !== second[name]?.bytes || first[name]?.sha256 !== second[name]?.sha256, + ); + throw new Error(`Cross-build export replay mismatch: ${mismatches.join(', ')}`); +} + +const manifest = JSON.parse(await readFile(manifestPath, 'utf8')); +manifest.replayVerification = 'cross-build'; +manifest.replayFiles = Object.keys(second).length - 1; +await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`); +await validateArtifacts(); + +console.log( + `EXPORT REPLAY PASS (${manifest.replayFiles} artifacts matched across two clean builds)`, +); diff --git a/publication/scripts/verify-public-profile.mjs b/publication/scripts/verify-public-profile.mjs new file mode 100644 index 0000000..0189c97 --- /dev/null +++ b/publication/scripts/verify-public-profile.mjs @@ -0,0 +1,77 @@ +import { createHash } from 'node:crypto'; +import { mkdtemp, readFile, rm } from 'node:fs/promises'; +import { tmpdir } from 'node:os'; +import { relative, resolve } from 'node:path'; + +import { buildPublicationProfile } from './build-profile.mjs'; +import { walkFiles } from './lib/files.mjs'; + +/** @param {string} directory */ +async function manifest(directory) { + const files = await walkFiles(directory); + const entries = await Promise.all( + files.map(async (path) => { + const contents = await readFile(path); + return [ + relative(directory, path).replaceAll('\\', '/'), + createHash('sha256').update(contents).digest('hex'), + ]; + }), + ); + return Object.fromEntries(entries); +} + +/** @param {Record} entries */ +function containsRealFieldNote(entries) { + return Object.keys(entries).some((path) => + /^field-notes\/[a-z0-9]+(?:-[a-z0-9]+)*\/index\.html$/u.test(path), + ); +} + +const temporaryRoot = await mkdtemp(resolve(tmpdir(), 'agentsutra-public-profile-')); +const destination = resolve(temporaryRoot, 'dist'); + +try { + await buildPublicationProfile('prelaunch', { destination }); + const sealedPrelaunch = await manifest(destination); + const hasRealFieldNote = containsRealFieldNote(sealedPrelaunch); + + try { + await buildPublicationProfile('public', { destination }); + if (!hasRealFieldNote) { + throw new Error('Public profile succeeded without a validated, published Field Note route.'); + } + console.log('PUBLIC PROFILE RELEASE PASS (validated public Field Note present)'); + } catch (error) { + if (hasRealFieldNote) throw error; + const failure = /** @type {Error & { stdout?: string; stderr?: string }} */ (error); + const output = `${failure.stdout ?? ''}\n${failure.stderr ?? ''}`; + if (!output.includes('public release requires at least one validated, published Field Note')) { + throw new Error(`Public profile failed for an unexpected reason.\n${failure.message}`, { + cause: error, + }); + } + const reportedFailures = output.split(/\r?\n/u).filter((line) => line.startsWith('- ')); + const expectedEmptyPublicationFailures = [ + '- public release requires at least one validated, published Field Note route', + '- field-notes/index.html: public HTML contains a reserved pre-launch or synthetic marker', + ]; + const unexpectedFailures = reportedFailures.filter( + (line) => !expectedEmptyPublicationFailures.includes(line), + ); + if (unexpectedFailures.length > 0) { + throw new Error( + `The empty public profile exposed additional release defects:\n${unexpectedFailures.join('\n')}`, + ); + } + const afterFailure = await manifest(destination); + if (JSON.stringify(afterFailure) !== JSON.stringify(sealedPrelaunch)) { + throw new Error('Failed public release attempt changed the sealed pre-launch artifact.'); + } + console.log( + 'PUBLIC PROFILE FAIL-CLOSED PASS (no real Field Note; pre-launch artifact unchanged)', + ); + } +} finally { + await rm(temporaryRoot, { recursive: true, force: true }); +} diff --git a/publication/src/components/AgentThread.astro b/publication/src/components/AgentThread.astro new file mode 100644 index 0000000..ac97383 --- /dev/null +++ b/publication/src/components/AgentThread.astro @@ -0,0 +1,139 @@ +--- +import { + threadEdgeSemantics, + threadNodeSemantics, + type ThreadEdge, + type ThreadLayout, + type ThreadNode, + type ThreadTextStep, +} from '../schemas'; +import ThreadDiagramSvg from './ThreadDiagramSvg.astro'; +import { buildThreadLayout } from './thread-engine'; + +interface LegacyNode { + id: string; + label: string; + kind: ThreadNode['kind']; + stage?: ThreadNode['stage']; + description?: string; + position?: ThreadNode['position']; +} + +interface LegacyEdge { + id?: string; + from: string; + to: string; + label?: string | undefined; + kind?: ThreadEdge['kind']; +} + +interface Props { + title?: string; + layout?: ThreadLayout; + nodes: LegacyNode[]; + edges?: LegacyEdge[]; + textSteps?: ThreadTextStep[] | string[]; +} + +const { + title = 'AgentSutra Thread', + layout = 'linear', + nodes: inputNodes, + edges: inputEdges, + textSteps: inputSteps, +} = Astro.props; + +const nodes: ThreadNode[] = inputNodes.map((node) => ({ + id: node.id, + label: node.label, + kind: node.kind, + stage: node.stage ?? 'reasoning', + ...(node.position ? { position: node.position } : {}), +})); +const rawEdges: LegacyEdge[] = + inputEdges ?? nodes.slice(1).map((node, index) => ({ from: nodes[index]!.id, to: node.id })); +const edges: ThreadEdge[] = rawEdges.map((edge, index) => ({ + id: edge.id ?? `E${String(index + 1).padStart(2, '0')}`, + from: edge.from, + to: edge.to, + kind: edge.kind ?? 'deterministic', + ...(edge.label ? { label: edge.label } : {}), +})); +const textSteps: ThreadTextStep[] = + inputSteps && inputSteps.length > 0 && typeof inputSteps[0] !== 'string' + ? (inputSteps as ThreadTextStep[]) + : ( + (inputSteps as string[] | undefined) ?? + inputNodes.map((node) => node.description ?? node.label) + ).map((summary, index) => ({ + id: `T${String(index + 1).padStart(2, '0')}`, + summary, + nodeIds: [nodes[Math.min(index, nodes.length - 1)]!.id], + edgeIds: edges[index] ? [edges[index].id] : [], + })); + +const wide = buildThreadLayout({ layout, nodes, edges }); +const compact = buildThreadLayout({ layout, nodes, edges, compact: true }); +const markerPrefix = `thread-${title}-${nodes.map((node) => node.id).join('-')}` + .toLowerCase() + .replace(/[^a-z0-9-]+/gu, '-') + .replace(/^-|-$/gu, ''); +const textId = `${markerPrefix}-text`; +const nodeById = new Map(nodes.map((node) => [node.id, node])); +const edgeById = new Map(edges.map((edge) => [edge.id, edge])); +--- + +
+
+

AgentSutra Thread / {layout}

+

{title}

+
+
+ + +
+
+ +
    + { + textSteps.map((step, stepIndex) => { + return ( +
  1. + Step {stepIndex + 1} + — {step.summary} +
    2. + ); + }) + } +
+
+ Diagram specification +
    + { + textSteps.map((step) => { + const nodeReferences = step.nodeIds + .map((nodeId) => nodeById.get(nodeId)) + .filter((node): node is ThreadNode => Boolean(node)); + const edgeReferences = step.edgeIds + .map((edgeId) => edgeById.get(edgeId)) + .filter((edge): edge is ThreadEdge => Boolean(edge)); + return ( +
  1. + {step.id}:{' '} + {[ + ...nodeReferences.map( + (node) => `${threadNodeSemantics[node.kind]} ${node.label} (${node.id})`, + ), + ...edgeReferences.map( + (edge) => + `${threadEdgeSemantics[edge.kind]} ${edge.label ?? `${edge.from} to ${edge.to}`} (${edge.id})`, + ), + ].join('; ')} +
    2. + ); + }) + } +
+
+
+
diff --git a/publication/src/components/BoundaryPanel.astro b/publication/src/components/BoundaryPanel.astro new file mode 100644 index 0000000..f6f11ba --- /dev/null +++ b/publication/src/components/BoundaryPanel.astro @@ -0,0 +1,26 @@ +--- +interface Props { + boundary: string; + doesNotProve?: string[]; +} + +const { boundary, doesNotProve = [] } = Astro.props; +--- + + diff --git a/publication/src/components/EvidencePanel.astro b/publication/src/components/EvidencePanel.astro new file mode 100644 index 0000000..3c83d0d --- /dev/null +++ b/publication/src/components/EvidencePanel.astro @@ -0,0 +1,54 @@ +--- +import type { EvidencePack } from '../schemas'; +import { getPublicEvidencePresentation, publicEvidenceMeanings } from '../lib/public-evidence'; + +interface Props { + pack: EvidencePack; +} + +const { pack } = Astro.props; +const sourceLabel = (item: EvidencePack['evidence'][number]) => { + if (item.source.access === 'public') return item.source.label; + if (item.source.access === 'private') return item.source.publicDescription; + return item.source.note; +}; +const presentation = getPublicEvidencePresentation(pack); +const readerStamp = presentation.statusLabel; +--- + +
+
+

What the evidence showed

+ + {readerStamp} + +
+

{publicEvidenceMeanings[readerStamp]}

+

Claim being tested{pack.centralClaim}

+
    + { + pack.evidence.map((item) => ( +
  1. + What we found + {item.finding} + How we checked: {item.method} + + Source: {sourceLabel(item)} · observed {item.observedAt} + + Limit: {item.limitation} +
    2. + )) + } +
+ { + pack.measurement && ( +

+ Measurement record + + Version {pack.measurement.version}; denominator {pack.measurement.denominator}; measured{' '} + {pack.measurement.measuredAt}. + +

+ ) + } +
diff --git a/publication/src/components/FieldNoteHeader.astro b/publication/src/components/FieldNoteHeader.astro new file mode 100644 index 0000000..ede4bab --- /dev/null +++ b/publication/src/components/FieldNoteHeader.astro @@ -0,0 +1,72 @@ +--- +interface Props { + id: string; + title: string; + answer: string; + arc: string; + difficulty: string; + publishedAt?: Date | string | undefined; + reviewedAt?: Date | string | undefined; + evidenceStatus: string; + evidenceMeaning: string; +} + +const { + id, + title, + answer, + arc, + difficulty, + publishedAt, + reviewedAt, + evidenceStatus, + evidenceMeaning, +} = Astro.props; +const formatDate = (value?: Date | string) => + value + ? new Intl.DateTimeFormat('en-GB', { day: 'numeric', month: 'short', year: 'numeric' }).format( + typeof value === 'string' ? new Date(value) : value, + ) + : undefined; +--- + +
+
+

Field Note / {id}

+
+

{title}

+

Short answer

+

{answer}

+

+ + {evidenceStatus} + + {evidenceMeaning} +

+
+
+
Topic
{arc}
+
Depth
{difficulty}
+ { + publishedAt && ( +
+ <> +
Published
+
{formatDate(publishedAt)}
+ +
+ ) + } + { + reviewedAt && ( +
+ <> +
Reviewed
+
{formatDate(reviewedAt)}
+ +
+ ) + } +
+
+
diff --git a/publication/src/components/MemoryLine.astro b/publication/src/components/MemoryLine.astro new file mode 100644 index 0000000..74997c7 --- /dev/null +++ b/publication/src/components/MemoryLine.astro @@ -0,0 +1,12 @@ +--- +interface Props { + line: string; +} + +const { line } = Astro.props; +--- + +
+

The Sutra · one sentence to remember

+
{line}
+
diff --git a/publication/src/components/SiteFooter.astro b/publication/src/components/SiteFooter.astro new file mode 100644 index 0000000..0220520 --- /dev/null +++ b/publication/src/components/SiteFooter.astro @@ -0,0 +1,18 @@ + diff --git a/publication/src/components/SiteHeader.astro b/publication/src/components/SiteHeader.astro new file mode 100644 index 0000000..0a0208e --- /dev/null +++ b/publication/src/components/SiteHeader.astro @@ -0,0 +1,38 @@ +--- +import ThreadCursor from './ThreadCursor.astro'; + +interface Props { + currentPath: string; +} + +const { currentPath } = Astro.props; +const nav = [ + { href: '/start-here/', label: 'Start here' }, + { href: '/field-notes/', label: 'Field Notes' }, + { href: '/method/', label: 'How it works' }, +]; +const isCurrent = (href: string) => + href === '/field-notes/' ? currentPath.startsWith('/field-notes/') : currentPath === href; +--- + +
+
+ + + AgentSutra + + +
+
diff --git a/publication/src/components/SourcesList.astro b/publication/src/components/SourcesList.astro new file mode 100644 index 0000000..f5d7e3f --- /dev/null +++ b/publication/src/components/SourcesList.astro @@ -0,0 +1,52 @@ +--- +export interface SourceItem { + title: string; + url?: string; + publisher?: string; + note?: string; + accessedAt?: Date | string; +} + +interface Props { + sources?: SourceItem[]; +} + +const { sources = [] } = Astro.props; +const formatDate = (value?: Date | string) => + value + ? new Intl.DateTimeFormat('en-GB', { day: 'numeric', month: 'short', year: 'numeric' }).format( + typeof value === 'string' ? new Date(value) : value, + ) + : undefined; +--- + +
+
+

Source register

+ Provenance +
+ { + sources.length > 0 ? ( +
    + {sources.map((source) => ( +
  1. + {source.url ? {source.title} : {source.title}} + {(source.publisher || source.accessedAt) && ( + + {[ + source.publisher, + source.accessedAt && `accessed ${formatDate(source.accessedAt)}`, + ] + .filter(Boolean) + .join(' · ')} + + )} + {source.note && {source.note}} +
    2. + ))} +
+ ) : ( +

No external sources are required for this explanatory note.

+ ) + } +
diff --git a/publication/src/components/ThreadCursor.astro b/publication/src/components/ThreadCursor.astro new file mode 100644 index 0000000..5b4560e --- /dev/null +++ b/publication/src/components/ThreadCursor.astro @@ -0,0 +1 @@ + diff --git a/publication/src/components/ThreadDiagramSvg.astro b/publication/src/components/ThreadDiagramSvg.astro new file mode 100644 index 0000000..fbbe9fe --- /dev/null +++ b/publication/src/components/ThreadDiagramSvg.astro @@ -0,0 +1,126 @@ +--- +import { threadEdgeSemantics, threadNodeSemantics } from '../schemas'; +import { wrapThreadLabel, type ThreadLayoutResult } from './thread-engine'; + +interface Props { + result: ThreadLayoutResult; + variant: 'wide' | 'compact'; + markerPrefix: string; +} + +const { result, variant, markerPrefix } = Astro.props; +const arrowId = `${markerPrefix}-${variant}-arrow`; +const stageColor = { + intent: 'var(--violet)', + reasoning: 'var(--periwinkle)', + outcome: 'var(--cyan)', +} as const; +const nodeById = new Map(result.nodes.map((node) => [node.id, node])); +--- + + diff --git a/publication/src/components/UseToday.astro b/publication/src/components/UseToday.astro new file mode 100644 index 0000000..10e4621 --- /dev/null +++ b/publication/src/components/UseToday.astro @@ -0,0 +1,23 @@ +--- +interface Props { + action: string; + precondition?: string; +} + +const { action, precondition } = Astro.props; +--- + +
+ +
+

Use this today

+

{action}

+ { + precondition && ( +

+ Before you do: {precondition} +

+ ) + } +
+
diff --git a/publication/src/components/export/SocialFrame.astro b/publication/src/components/export/SocialFrame.astro new file mode 100644 index 0000000..5456b0b --- /dev/null +++ b/publication/src/components/export/SocialFrame.astro @@ -0,0 +1,109 @@ +--- +import type { Adaptation, EvidencePack, ThreadDiagram } from '../../schemas'; +import { getPublicEvidencePresentation } from '../../lib/public-evidence'; +import SocialThread from './SocialThread.astro'; + +interface Props { + adaptation: Adaptation; + evidencePack: EvidencePack; + frame: Adaptation['frames'][number]; + diagram?: ThreadDiagram; + documentPage?: boolean; +} + +const { adaptation, evidencePack, frame, diagram, documentPage = false } = Astro.props; +const exportId = `${adaptation.id}-${String(frame.index).padStart(2, '0')}`; +const total = adaptation.frames.length; +const evidence = getPublicEvidencePresentation(evidencePack); +const roleLabel = frame.role.replaceAll('-', ' '); +const diagramDescription = diagram?.textSteps.map((step) => step.summary).join(' '); +const completeAltText = diagramDescription + ? `${frame.altText} Diagram text equivalent: ${diagramDescription}` + : frame.altText; +--- + +
+ + + + + +
+
+

AgentSutra

+ +
+ +
+
diff --git a/publication/src/components/export/SocialThread.astro b/publication/src/components/export/SocialThread.astro new file mode 100644 index 0000000..2181a85 --- /dev/null +++ b/publication/src/components/export/SocialThread.astro @@ -0,0 +1,29 @@ +--- +import type { ThreadDiagram } from '../../schemas'; + +interface Props { + diagram: ThreadDiagram; + markerPrefix: string; +} + +const { diagram, markerPrefix } = Astro.props; +--- + + diff --git a/publication/src/components/thread-engine.ts b/publication/src/components/thread-engine.ts new file mode 100644 index 0000000..85b8a45 --- /dev/null +++ b/publication/src/components/thread-engine.ts @@ -0,0 +1,338 @@ +import type { ThreadEdge, ThreadLayout, ThreadNode } from '../schemas'; + +export interface ThreadPoint { + x: number; + y: number; +} + +export interface ThreadRenderNode extends Omit { + position?: ThreadNode['position']; + x: number; + y: number; + width: number; + height: number; +} + +export interface ThreadRenderEdge extends ThreadEdge { + points: ThreadPoint[]; + path: string; + labelPoint: ThreadPoint; +} + +export interface ThreadLayoutResult { + width: number; + height: number; + nodes: ThreadRenderNode[]; + edges: ThreadRenderEdge[]; +} + +interface BuildThreadLayoutInput { + layout: ThreadLayout; + nodes: ThreadNode[]; + edges: ThreadEdge[]; + compact?: boolean; +} + +const WIDE_NODE_WIDTH = 148; +const COMPACT_NODE_WIDTH = 216; +const NODE_HEIGHT = 72; +const MARGIN_X = 98; +const MARGIN_Y = 68; + +function evenlySpaced(index: number, total: number, start: number, end: number): number { + if (total <= 1) return (start + end) / 2; + return start + (index * (end - start)) / (total - 1); +} + +function compactPositions( + nodes: ThreadNode[], +): Pick { + const width = 320; + const height = Math.max(260, 108 + nodes.length * 126); + return { + width, + height, + nodes: nodes.map((node, index) => ({ + ...node, + x: width / 2, + y: 70 + index * 126, + width: COMPACT_NODE_WIDTH, + height: NODE_HEIGHT, + })), + }; +} + +function normalizedPositions( + nodes: ThreadNode[], +): Pick | undefined { + if (!nodes.every((node) => node.position)) return undefined; + const width = 920; + const height = 520; + return { + width, + height, + nodes: nodes.map((node) => ({ + ...node, + x: MARGIN_X + node.position!.x * (width - MARGIN_X * 2), + y: MARGIN_Y + node.position!.y * (height - MARGIN_Y * 2), + width: WIDE_NODE_WIDTH, + height: NODE_HEIGHT, + })), + }; +} + +function sequentialPositions( + layout: ThreadLayout, + nodes: ThreadNode[], +): Pick { + if (layout === 'vertical') { + const width = 440; + const height = Math.max(300, MARGIN_Y * 2 + (nodes.length - 1) * 126); + return { + width, + height, + nodes: nodes.map((node, index) => ({ + ...node, + x: width / 2, + y: evenlySpaced(index, nodes.length, MARGIN_Y, height - MARGIN_Y), + width: WIDE_NODE_WIDTH, + height: NODE_HEIGHT, + })), + }; + } + + if (layout === 'stack') { + const width = 560; + const height = Math.max(330, MARGIN_Y * 2 + (nodes.length - 1) * 112); + return { + width, + height, + nodes: nodes.map((node, index) => ({ + ...node, + x: width / 2 + (index % 2 === 0 ? -62 : 62), + y: evenlySpaced(index, nodes.length, MARGIN_Y, height - MARGIN_Y), + width: WIDE_NODE_WIDTH, + height: NODE_HEIGHT, + })), + }; + } + + const width = Math.max(680, MARGIN_X * 2 + (nodes.length - 1) * 184); + const height = layout === 'loop' ? 300 : 230; + return { + width, + height, + nodes: nodes.map((node, index) => ({ + ...node, + x: evenlySpaced(index, nodes.length, MARGIN_X, width - MARGIN_X), + y: height / 2, + width: WIDE_NODE_WIDTH, + height: NODE_HEIGHT, + })), + }; +} + +function layeredPositions( + nodes: ThreadNode[], + edges: ThreadEdge[], +): Pick { + const levels = new Map(nodes.map((node) => [node.id, node.stage === 'intent' ? 0 : -1])); + for (let pass = 0; pass < nodes.length; pass += 1) { + for (const edge of edges.filter((item) => item.kind !== 'iteration')) { + const fromLevel = levels.get(edge.from) ?? -1; + const toLevel = levels.get(edge.to) ?? -1; + if (fromLevel >= 0 && fromLevel + 1 > toLevel) levels.set(edge.to, fromLevel + 1); + } + } + let fallbackLevel = 0; + for (const node of nodes) { + if ((levels.get(node.id) ?? -1) < 0) { + fallbackLevel += 1; + levels.set(node.id, fallbackLevel); + } + } + + const maxLevel = Math.max(1, ...levels.values()); + const groups = new Map(); + for (const node of nodes) { + const level = levels.get(node.id) ?? 0; + const group = groups.get(level) ?? []; + group.push(node); + groups.set(level, group); + } + const largestGroup = Math.max(...[...groups.values()].map((group) => group.length)); + const width = Math.max(760, MARGIN_X * 2 + maxLevel * 210); + const height = Math.max(320, MARGIN_Y * 2 + (largestGroup - 1) * 132); + const renderNodes: ThreadRenderNode[] = []; + for (const [level, group] of [...groups.entries()].sort(([left], [right]) => left - right)) { + group.forEach((node, index) => { + renderNodes.push({ + ...node, + x: evenlySpaced(level, maxLevel + 1, MARGIN_X, width - MARGIN_X), + y: evenlySpaced(index, group.length, MARGIN_Y, height - MARGIN_Y), + width: WIDE_NODE_WIDTH, + height: NODE_HEIGHT, + }); + }); + } + return { width, height, nodes: renderNodes }; +} + +function trimEndpoint(center: ThreadPoint, next: ThreadPoint, node: ThreadRenderNode): ThreadPoint { + if (center.x === next.x) { + return { x: center.x, y: center.y + (next.y > center.y ? node.height / 2 : -node.height / 2) }; + } + return { x: center.x + (next.x > center.x ? node.width / 2 : -node.width / 2), y: center.y }; +} + +function trimRoute( + points: ThreadPoint[], + from: ThreadRenderNode, + to: ThreadRenderNode, +): ThreadPoint[] { + if (points.length < 2) return points; + const trimmed = points.map((point) => ({ ...point })); + trimmed[0] = trimEndpoint(trimmed[0]!, trimmed[1]!, from); + trimmed[trimmed.length - 1] = trimEndpoint( + trimmed[trimmed.length - 1]!, + trimmed[trimmed.length - 2]!, + to, + ); + return trimmed.filter( + (point, index) => + index === 0 || point.x !== trimmed[index - 1]!.x || point.y !== trimmed[index - 1]!.y, + ); +} + +function segmentIntersectsNode( + start: ThreadPoint, + end: ThreadPoint, + node: ThreadRenderNode, + padding = 8, +): boolean { + const left = node.x - node.width / 2 - padding; + const right = node.x + node.width / 2 + padding; + const top = node.y - node.height / 2 - padding; + const bottom = node.y + node.height / 2 + padding; + if (start.y === end.y) { + return ( + start.y >= top && + start.y <= bottom && + Math.max(start.x, end.x) >= left && + Math.min(start.x, end.x) <= right + ); + } + if (start.x === end.x) { + return ( + start.x >= left && + start.x <= right && + Math.max(start.y, end.y) >= top && + Math.min(start.y, end.y) <= bottom + ); + } + return true; +} + +export function routeCrossesNode(route: ThreadPoint[], node: ThreadRenderNode): boolean { + return route.slice(1).some((point, index) => segmentIntersectsNode(route[index]!, point, node)); +} + +function longestSegmentMidpoint(points: ThreadPoint[]): ThreadPoint { + let best = { length: -1, point: points[0] ?? { x: 0, y: 0 } }; + for (let index = 1; index < points.length; index += 1) { + const start = points[index - 1]!; + const end = points[index]!; + const length = Math.abs(end.x - start.x) + Math.abs(end.y - start.y); + if (length > best.length) { + best = { length, point: { x: (start.x + end.x) / 2, y: (start.y + end.y) / 2 } }; + } + } + return best.point; +} + +function routeEdge( + edge: ThreadEdge, + index: number, + nodes: ThreadRenderNode[], + width: number, + height: number, +): ThreadRenderEdge { + const from = nodes.find((node) => node.id === edge.from)!; + const to = nodes.find((node) => node.id === edge.to)!; + const centerFrom = { x: from.x, y: from.y }; + const centerTo = { x: to.x, y: to.y }; + const midX = (from.x + to.x) / 2; + const midY = (from.y + to.y) / 2; + const lane = 18 + (index % 5) * 13; + const top = lane; + const bottom = height - lane; + const left = lane; + const right = width - lane; + const direct = [centerFrom, centerTo]; + const viaMidX = [centerFrom, { x: midX, y: from.y }, { x: midX, y: to.y }, centerTo]; + const viaMidY = [centerFrom, { x: from.x, y: midY }, { x: to.x, y: midY }, centerTo]; + const viaTop = [centerFrom, { x: from.x, y: top }, { x: to.x, y: top }, centerTo]; + const viaBottom = [centerFrom, { x: from.x, y: bottom }, { x: to.x, y: bottom }, centerTo]; + const viaLeft = [centerFrom, { x: left, y: from.y }, { x: left, y: to.y }, centerTo]; + const viaRight = [centerFrom, { x: right, y: from.y }, { x: right, y: to.y }, centerTo]; + const candidates = + edge.kind === 'iteration' + ? [viaTop, viaBottom, viaLeft, viaRight, viaMidX, viaMidY] + : [direct, viaMidX, viaMidY, viaTop, viaBottom, viaLeft, viaRight]; + + const obstacles = nodes.filter((node) => node.id !== from.id && node.id !== to.id); + let points = trimRoute(viaRight, from, to); + for (const candidate of candidates) { + const trimmed = trimRoute(candidate, from, to); + const axisAligned = trimmed + .slice(1) + .every( + (point, pointIndex) => + point.x === trimmed[pointIndex]!.x || point.y === trimmed[pointIndex]!.y, + ); + if (axisAligned && obstacles.every((node) => !routeCrossesNode(trimmed, node))) { + points = trimmed; + break; + } + } + + return { + ...edge, + points, + path: points + .map((point, pointIndex) => `${pointIndex === 0 ? 'M' : 'L'} ${point.x} ${point.y}`) + .join(' '), + labelPoint: longestSegmentMidpoint(points), + }; +} + +export function buildThreadLayout({ + layout, + nodes, + edges, + compact = false, +}: BuildThreadLayoutInput): ThreadLayoutResult { + const positioned = compact + ? compactPositions(nodes) + : (normalizedPositions(nodes) ?? + (layout === 'fork' || layout === 'compare' || layout === 'feedback' + ? layeredPositions(nodes, edges) + : sequentialPositions(layout, nodes))); + return { + ...positioned, + edges: edges.map((edge, index) => + routeEdge(edge, index, positioned.nodes, positioned.width, positioned.height), + ), + }; +} + +export function wrapThreadLabel(label: string, maximum = 20): string[] { + const words = label.trim().split(/\s+/u); + const lines: string[] = []; + for (const word of words) { + const current = lines.at(-1); + if (!current || `${current} ${word}`.length > maximum) lines.push(word); + else lines[lines.length - 1] = `${current} ${word}`; + } + return lines.slice(0, 3); +} diff --git a/publication/src/content.config.ts b/publication/src/content.config.ts new file mode 100644 index 0000000..ebbefbe --- /dev/null +++ b/publication/src/content.config.ts @@ -0,0 +1,73 @@ +import { defineCollection } from 'astro:content'; +import { glob } from 'astro/loaders'; +import { z } from 'astro/zod'; + +import { + adaptationSchema, + evidencePackSchema, + fieldNoteSchema, + interviewSchema, + threadDiagramSchema, +} from './schemas'; +import { publicationDataFiles, publicationGraphLoader } from './lib/publication-graph-files'; +import { yamlRecordFilesLoader } from './lib/yaml-loader'; + +const includeFixtures = process.env.INCLUDE_FIXTURES === '1'; +const dataFiles = publicationDataFiles(includeFixtures); + +const fieldNotes = defineCollection({ + loader: glob({ + base: './src/content/field-notes', + pattern: includeFixtures ? '**/*.md' : ['**/*.md', '!fixtures/**'], + }), + schema: fieldNoteSchema, +}); + +const evidencePacks = defineCollection({ + loader: yamlRecordFilesLoader({ name: 'evidence packs', files: dataFiles.evidencePacks }), + schema: evidencePackSchema, +}); + +const threadDiagrams = defineCollection({ + loader: yamlRecordFilesLoader({ name: 'Thread diagrams', files: dataFiles.threadDiagrams }), + schema: threadDiagramSchema, +}); + +const adaptations = defineCollection({ + loader: yamlRecordFilesLoader({ name: 'adaptations', files: dataFiles.adaptations }), + schema: adaptationSchema, +}); + +const interviews = defineCollection({ + loader: yamlRecordFilesLoader({ name: 'interview records', files: dataFiles.interviews }), + schema: interviewSchema, +}); + +const publicationGraph = defineCollection({ + loader: publicationGraphLoader(includeFixtures), + schema: z + .object({ + schemaVersion: z.literal('1.0'), + fixtureMode: z.boolean(), + noteIds: z.array(z.string().regex(/^FN-\d{3}$/)), + counts: z + .object({ + fieldNotes: z.number().int().nonnegative(), + evidencePacks: z.number().int().nonnegative(), + threadDiagrams: z.number().int().nonnegative(), + adaptations: z.number().int().nonnegative(), + interviews: z.number().int().nonnegative(), + }) + .strict(), + }) + .strict(), +}); + +export const collections = { + fieldNotes, + evidencePacks, + threadDiagrams, + adaptations, + interviews, + publicationGraph, +}; diff --git a/publication/src/content/field-notes/fixtures/fn-000-stress-test.md b/publication/src/content/field-notes/fixtures/fn-000-stress-test.md new file mode 100644 index 0000000..0aa0bf5 --- /dev/null +++ b/publication/src/content/field-notes/fixtures/fn-000-stress-test.md @@ -0,0 +1,56 @@ +--- +schemaVersion: '1.0' +id: FN-000 +slug: fn-000-stress-test +lifecycle: draft +fixture: true +title: 'Synthetic stress fixture: an intentionally overlong Field Note title that tests wrapping, narrow screens, metadata density, punctuation — and resilient editorial layouts' +description: 'A deliberately fictional, non-publishable record used only to prove that the AgentSutra content contract survives long copy, every audience layer, and linked artifacts.' +shareImage: + src: /social/agentsutra-default.png + alt: 'AgentSutra default share artwork with a vertical Thread and the words Push the model, inspect the failure, keep the lesson.' + width: 1200 + height: 630 +centralClaim: 'Synthetic fixture claim: a deliberately fictional record can test the complete AgentSutra publishing contract without asserting anything about a real system.' +answer: 'This draft exists only as engineering test data, and every statement on it is explicitly synthetic rather than advice, evidence, or a public technical claim.' +arc: Publishing foundations +secondaryArcs: + - Evidence boundaries + - Accessible diagrams + - Platform adaptation + - Interview rehearsal +difficulty: foundation +audiences: + - curious-user + - builder-operator + - technical-evaluator +riskClass: A +evidencePackId: EP-FN-000 +diagramId: TD-FN-000 +adaptationIds: + - AD-FN-000-IG + - AD-FN-000-TT + - AD-FN-000-LI + - AD-FN-000-RD +interviewId: IV-FN-000 +beats: + problem: 'A publication pipeline can look reliable while its schemas, long-copy layouts, references, and exclusion controls have never been stressed together.' + naiveModel: 'The naive model assumes that one short example proves every content shape will remain readable, linked, private, and internally consistent.' + mechanism: 'The fixture deliberately exercises maximum supporting claims, every Thread stage, four platform records, long labels, and a complete rehearsal record.' + evidenceSummary: 'The only evidence here is the successful validation of synthetic records; it makes no statement about a real lesson or production outcome.' + boundary: 'This fixture proves only that the declared contracts accept internally consistent synthetic input and reject defined invalid states.' + transfer: 'Before publishing a real Field Note, run the same contract checks with its own bounded evidence pack and manually review the rendered result.' + memoryLine: 'Stress the contract before trusting the content pipeline.' + depthDoor: 'Inspect the fixture schemas and rejection tests to see exactly which consistency and privacy failures stop the build.' +dates: + created: '2026-08-17' + updated: '2026-08-17' +relations: + prerequisites: [] + related: [] +aiDisclosure: 'This synthetic fixture was created with AI assistance and requires human review before its structure is reused for any real lesson.' +--- + +This file is synthetic engineering test data. It is not a public lesson, a factual claim, or advice. + +It exists to exercise the complete Field Note contract while remaining excluded from the normal production build. diff --git a/publication/src/data/adaptations.yaml b/publication/src/data/adaptations.yaml new file mode 100644 index 0000000..fe51488 --- /dev/null +++ b/publication/src/data/adaptations.yaml @@ -0,0 +1 @@ +[] diff --git a/publication/src/data/evidence-packs.yaml b/publication/src/data/evidence-packs.yaml new file mode 100644 index 0000000..fe51488 --- /dev/null +++ b/publication/src/data/evidence-packs.yaml @@ -0,0 +1 @@ +[] diff --git a/publication/src/data/fixtures/adaptations.yaml b/publication/src/data/fixtures/adaptations.yaml new file mode 100644 index 0000000..ed06b7c --- /dev/null +++ b/publication/src/data/fixtures/adaptations.yaml @@ -0,0 +1,118 @@ +- schemaVersion: '1.0' + id: AD-FN-000-IG + fieldNoteId: FN-000 + evidencePackId: EP-FN-000 + platform: instagram + format: carousel + lifecycle: draft + centralClaim: 'Synthetic fixture claim: a deliberately fictional record can test the complete AgentSutra publishing contract without asserting anything about a real system.' + canonicalPath: /field-notes/fn-000-stress-test/ + frames: + - index: 1 + role: cover + heading: 'Can a fictional lesson test a real publishing contract?' + body: 'This deliberately synthetic carousel stresses the complete record shape without making a real public claim.' + altText: 'Cover card identifying FN-000 as a synthetic AgentSutra publishing-contract stress test.' + - index: 2 + role: mechanism + heading: 'One claim, five linked record types' + body: 'The Field Note, evidence pack, Thread, platform adaptation, and interview rehearsal must agree exactly.' + altText: 'Text card explaining that five linked synthetic record types must share one exact central claim.' + diagramId: TD-FN-000 + - index: 3 + role: boundary + heading: 'What this does not prove' + body: 'A passing fixture validates declared contracts only; it does not make future lessons accurate or publishable.' + altText: 'Boundary card stating that fixture validation is not evidence for any real future lesson.' + - index: 4 + role: transfer + heading: 'Use the gate on every real note' + body: 'Add bounded evidence, run the graph validator, and manually review the rendered result before release.' + altText: 'Action card describing validation and human review before a real Field Note is released.' + caption: 'Synthetic fixture only. FN-000 is engineering test data and is excluded from normal production builds.' + export: + width: 1080 + height: 1350 + format: png +- schemaVersion: '1.0' + id: AD-FN-000-TT + fieldNoteId: FN-000 + evidencePackId: EP-FN-000 + platform: tiktok + format: photo-post + lifecycle: draft + centralClaim: 'Synthetic fixture claim: a deliberately fictional record can test the complete AgentSutra publishing contract without asserting anything about a real system.' + canonicalPath: /field-notes/fn-000-stress-test/ + frames: + - index: 1 + role: cover + heading: 'This is a synthetic stress test' + body: 'A tall static card tests long copy and explicit boundaries without presenting a real technical lesson.' + altText: 'Tall TikTok photo card clearly labelling FN-000 as synthetic engineering test data.' + - index: 2 + role: boundary + heading: 'Passing is not publishing' + body: 'A valid fixture proves the contracts agree, not that a real claim has earned public confidence.' + altText: 'Boundary card distinguishing a passing synthetic validation from approval to publish a real claim.' + caption: 'Synthetic fixture only; no real claim or advice is presented in this draft photo-post adaptation.' + export: + width: 1080 + height: 1920 + format: png +- schemaVersion: '1.0' + id: AD-FN-000-LI + fieldNoteId: FN-000 + evidencePackId: EP-FN-000 + platform: linkedin + format: document + lifecycle: draft + centralClaim: 'Synthetic fixture claim: a deliberately fictional record can test the complete AgentSutra publishing contract without asserting anything about a real system.' + canonicalPath: /field-notes/fn-000-stress-test/ + frames: + - index: 1 + role: cover + heading: 'Engineering the publication contract before the first claim' + body: 'FN-000 is a fictional, non-publishable record used to validate AgentSutra’s typed editorial system.' + altText: 'LinkedIn document cover identifying FN-000 as a fictional validation record rather than a public lesson.' + - index: 2 + role: boundary + heading: 'What the fixture cannot establish' + body: 'Contract validation cannot establish whether a real AI-system claim is accurate, useful, accessible in context, secure, or ready to publish.' + altText: 'LinkedIn document boundary page stating that a passing synthetic fixture cannot validate a real AI-system claim.' + - index: 3 + role: depth-door + heading: 'The useful artifact is the rejection path' + body: 'Tests prove that missing boundaries, excessive support claims, unsafe private locators, and ungated risk states fail closed.' + altText: 'Technical detail card listing the invalid content states that the build contract rejects.' + caption: 'Draft engineering fixture. This document adaptation is never part of the production publication corpus.' + attribution: + byline: 'AgentSutra editorial lab' + relationship: 'This byline identifies the publisher of a synthetic engineering fixture, not the author of a real-world technical claim.' + reflection: 'What I would do differently now: test truth-equivalence and platform-native output before treating visual polish as evidence of release readiness.' + export: + width: 1080 + height: 1350 + format: pdf +- schemaVersion: '1.0' + id: AD-FN-000-RD + fieldNoteId: FN-000 + evidencePackId: EP-FN-000 + platform: reddit + format: text-post + lifecycle: draft + centralClaim: 'Synthetic fixture claim: a deliberately fictional record can test the complete AgentSutra publishing contract without asserting anything about a real system.' + canonicalPath: /field-notes/fn-000-stress-test/ + frames: + - index: 1 + role: problem + heading: 'How would you test an educational content contract without inventing facts?' + body: 'Use an explicitly synthetic fixture that stresses the schema and reference graph while making no claim about a real system.' + altText: 'Reddit text-post preview asking how a publication contract can be tested without inventing factual evidence.' + - index: 2 + role: boundary + heading: 'The fixture is not an example lesson' + body: 'Its passing result belongs to engineering validation and cannot be cited as support for a future public claim.' + altText: 'Boundary text stating that synthetic fixture results cannot support a future real-world claim.' + caption: 'Synthetic discussion fixture only; adapt to each community’s rules before any real Reddit publication.' + export: + format: markdown diff --git a/publication/src/data/fixtures/evidence-packs.yaml b/publication/src/data/fixtures/evidence-packs.yaml new file mode 100644 index 0000000..d2af7cc --- /dev/null +++ b/publication/src/data/fixtures/evidence-packs.yaml @@ -0,0 +1,48 @@ +- schemaVersion: '1.0' + id: EP-FN-000 + fieldNoteId: FN-000 + riskClass: A + lifecycle: draft + centralClaim: 'Synthetic fixture claim: a deliberately fictional record can test the complete AgentSutra publishing contract without asserting anything about a real system.' + supportingClaims: + - id: SC-1 + claim: 'Synthetic fixtures can exercise schema limits without presenting their placeholder content as verified public evidence.' + - id: SC-2 + claim: 'Exact central-claim matching can detect accidental drift between the canonical note and its platform adaptations.' + - id: SC-3 + claim: 'Visible text steps can provide a semantic equivalent for a diagram when the graphic itself is unavailable.' + - id: SC-4 + claim: 'Opaque identifiers can preserve a reference relationship without exposing the location of private evidence.' + - id: SC-5 + claim: 'A fixture-only build mode can test draft routes while keeping synthetic records out of the production artifact.' + evidence: + - id: EV-FN-000-01 + kind: synthetic + source: + access: synthetic + note: 'This source is deliberately fictional and exists only to exercise the validation contract.' + supports: + - central + - SC-1 + - SC-2 + - SC-3 + - SC-4 + - SC-5 + verification: unverified + observedAt: '2026-08-17' + finding: 'The complete synthetic record set passed its declared schema, reference, lifecycle, and route-exclusion checks in the isolated fixture build.' + method: 'Parse the complete fixture set, validate every strict schema, then verify all cross-record references and exact central claims.' + limitation: 'Passing the synthetic fixture cannot establish that a future lesson is accurate, accessible in context, or ready to publish.' + boundary: + statement: 'The fixture tests declared data contracts only; it does not validate real-world claims, audience comprehension, or production operations.' + doesNotProve: + - 'It does not prove that any real AgentSutra lesson is correct, useful, accessible, secure, or ready for publication.' + - 'It does not prove that a browser rendering, social export, or external platform will preserve the intended presentation.' + transfer: + action: 'Use the same validation graph for each real lesson, then add evidence-specific review and rendered accessibility checks before release.' + precondition: 'Replace every synthetic record with bounded evidence that satisfies the lifecycle gates for the lesson’s assigned risk class.' + privacy: + classification: synthetic + reviewed: true + note: 'The fixture contains no client, machine, account, credential, private path, private locator, or real operational detail.' + correctionStatus: none diff --git a/publication/src/data/fixtures/interviews.yaml b/publication/src/data/fixtures/interviews.yaml new file mode 100644 index 0000000..7e48109 --- /dev/null +++ b/publication/src/data/fixtures/interviews.yaml @@ -0,0 +1,17 @@ +- schemaVersion: '1.0' + id: IV-FN-000 + fieldNoteId: FN-000 + centralClaim: 'Synthetic fixture claim: a deliberately fictional record can test the complete AgentSutra publishing contract without asserting anything about a real system.' + explanations: + seconds30: 'FN-000 is an explicitly synthetic record that tests whether five publication artifacts remain linked, bounded, and private. It validates the contract, not a real lesson.' + seconds90: 'I created FN-000 as a deliberately fictional Field Note because testing only with polished real content can hide edge cases. It stresses long titles, the maximum five supporting claims, every diagram stage, four platform adaptations, and all interview outputs. The build compares exact central claims and rejects missing or unsafe references. Its evidence boundary is essential: a passing fixture demonstrates contract consistency only, never the truth of a future public claim.' + minutes3: 'The problem was how to validate a content system before publishing any real educational claim. I modelled a Field Note as five linked records: the canonical Markdown note, a risk-classed evidence pack, a typed Thread diagram with visible text steps, platform adaptations, and interview rehearsal. FN-000 is reserved as the only fixture identifier and can load only in explicit fixture mode. Every schema is strict, the graph requires exact central-claim equality, private sources accept only opaque evidence identifiers, and high-risk states have stronger lifecycle gates. The fixture deliberately reaches shape limits without claiming a real system behaved in any particular way. That boundary is the design lesson: validation evidence must never be promoted into subject-matter evidence. I would still add rendered accessibility and audience-comprehension tests before trusting the complete publication workflow.' + interviewQuestions: + - 'How did you prevent a platform adaptation from changing the canonical lesson claim during editing?' + - 'Why did you model private evidence as an opaque identifier instead of a path or protected URL?' + - 'What does a passing synthetic fixture establish, and what important properties remain unverified?' + counterargument: 'A synthetic fixture can create false confidence if its happy path is mistaken for evidence that real content and external platforms will behave correctly.' + example: + kind: synthetic + text: 'The FN-000 fixture deliberately reaches the five-supporting-claim limit and connects four platform records to one fictional central claim.' + wouldDoDifferently: 'I would add property-based schema generation after the first three real pilots reveal which combinations of valid fields create unexpected rendering pressure.' diff --git a/publication/src/data/fixtures/thread-diagrams.yaml b/publication/src/data/fixtures/thread-diagrams.yaml new file mode 100644 index 0000000..67524ea --- /dev/null +++ b/publication/src/data/fixtures/thread-diagrams.yaml @@ -0,0 +1,96 @@ +- schemaVersion: '1.0' + id: TD-FN-000 + fieldNoteId: FN-000 + title: 'Synthetic publishing contract Thread' + description: 'A deliberately dense Thread showing intent, reasoning, decisions, uncertainty, failure, iteration, and a verified synthetic outcome.' + layout: feedback + nodes: + - id: N01 + kind: input + stage: intent + label: Synthetic draft + - id: N02 + kind: state + stage: intent + label: Typed record set + - id: N03 + kind: process + stage: reasoning + label: Parse contracts + - id: N04 + kind: decision + stage: reasoning + label: References agree? + - id: N05 + kind: uncertainty + stage: reasoning + label: Unresolved mismatch + - id: N06 + kind: failure + stage: outcome + label: Build rejected + - id: N07 + kind: artifact + stage: outcome + label: Validated fixture + - id: N08 + kind: verified + stage: outcome + label: Contract verified + edges: + - id: E01 + from: N01 + to: N02 + kind: deterministic + - id: E02 + from: N02 + to: N03 + kind: deterministic + - id: E03 + from: N03 + to: N04 + kind: deterministic + - id: E04 + from: N04 + to: N05 + kind: unresolved + label: Not yet + - id: E05 + from: N05 + to: N06 + kind: deterministic + - id: E06 + from: N06 + to: N02 + kind: iteration + label: Correct the record + - id: E07 + from: N04 + to: N07 + kind: deterministic + label: Yes + - id: E08 + from: N07 + to: N08 + kind: deterministic + textSteps: + - id: T01 + summary: 'Start with a clearly labelled synthetic draft and move into its typed record set.' + nodeIds: [N01, N02] + edgeIds: [E01] + - id: T02 + summary: 'Parse every strict schema and compare all cross-record identifiers and central claims.' + nodeIds: [N02, N03, N04] + edgeIds: [E02, E03] + - id: T03 + summary: 'When a reference is unresolved, reject the build and return to the source record.' + nodeIds: [N04, N05, N06, N02] + edgeIds: [E04, E05, E06] + - id: T04 + summary: 'When all contracts agree, retain the validated fixture only in the explicit fixture build.' + nodeIds: [N04, N07] + edgeIds: [E07] + - id: T05 + summary: 'Treat the verified outcome as contract evidence, not evidence for a real-world lesson.' + nodeIds: [N07, N08] + edgeIds: [E08] diff --git a/publication/src/data/interviews.yaml b/publication/src/data/interviews.yaml new file mode 100644 index 0000000..fe51488 --- /dev/null +++ b/publication/src/data/interviews.yaml @@ -0,0 +1 @@ +[] diff --git a/publication/src/data/thread-diagrams.yaml b/publication/src/data/thread-diagrams.yaml new file mode 100644 index 0000000..fe51488 --- /dev/null +++ b/publication/src/data/thread-diagrams.yaml @@ -0,0 +1 @@ +[] diff --git a/publication/src/layouts/BaseLayout.astro b/publication/src/layouts/BaseLayout.astro new file mode 100644 index 0000000..ae6bea8 --- /dev/null +++ b/publication/src/layouts/BaseLayout.astro @@ -0,0 +1,165 @@ +--- +import SiteFooter from '../components/SiteFooter.astro'; +import SiteHeader from '../components/SiteHeader.astro'; +import { defaultShareImage } from '../lib/share-images'; +import '../styles/global.css'; + +interface Props { + title?: string; + description?: string; + canonicalPath?: string; + noindex?: boolean; + image?: string; + imageAlt?: string; + imageWidth?: number; + imageHeight?: number; + ogType?: 'website' | 'article'; + publishedTime?: string | undefined; + modifiedTime?: string | undefined; + articleAuthor?: string | undefined; + articleSection?: string | undefined; + structuredData?: Record | Record[]; +} + +const publicLaunch = process.env.PUBLIC_LAUNCH === '1'; +const siteDescription = + 'AgentSutra turns first-hand experiments with AI tools and agents into visual Field Notes: what happened, why it happened, what the evidence cannot prove, and one thing you can use today.'; +const { + title = 'AgentSutra — AI experiments, failures and practical lessons', + description = siteDescription, + canonicalPath = Astro.url.pathname, + noindex = !publicLaunch, + image = defaultShareImage.src, + imageAlt = defaultShareImage.alt, + imageWidth = defaultShareImage.width, + imageHeight = defaultShareImage.height, + ogType = 'website', + publishedTime, + modifiedTime, + articleAuthor, + articleSection, + structuredData, +} = Astro.props; + +const origin = Astro.site ?? new URL('https://agentsutra.dev'); +const canonical = new URL(canonicalPath, origin); +const siteUrl = new URL('/', origin).toString(); +const websiteId = new URL('/#website', origin).toString(); +const publicationId = new URL('/#publication', origin).toString(); +const creatorId = new URL('/#creator', origin).toString(); +const methodUrl = new URL('/method/#editor', origin).toString(); +const socialImage = image ? new URL(image, origin).toString() : undefined; +const siteStructuredData: Record[] = [ + { + '@context': 'https://schema.org', + '@type': 'WebSite', + '@id': websiteId, + name: 'AgentSutra', + url: siteUrl, + description: siteDescription, + inLanguage: 'en', + publisher: { '@id': publicationId }, + creator: { '@id': creatorId }, + }, + { + '@context': 'https://schema.org', + '@type': 'Organization', + '@id': publicationId, + name: 'AgentSutra', + url: siteUrl, + description: 'AgentSutra is an independent publication created and edited by Pravin Durgani.', + founder: { '@id': creatorId }, + publishingPrinciples: methodUrl, + sameAs: ['https://github.com/pravindurgani/agentsutra'], + }, + { + '@context': 'https://schema.org', + '@type': 'Person', + '@id': creatorId, + name: 'Pravin Durgani', + url: methodUrl, + publishingPrinciples: methodUrl, + sameAs: ['https://github.com/pravindurgani'], + }, +]; +const structuredItems = [ + ...siteStructuredData, + ...(structuredData ? (Array.isArray(structuredData) ? structuredData : [structuredData]) : []), +]; +--- + + + + + + + + + + + + + + + + + + + + + + {socialImage && } + {socialImage && imageAlt && } + {socialImage && } + {socialImage && } + {socialImage && } + { + ogType === 'article' && publishedTime && ( + + ) + } + { + ogType === 'article' && modifiedTime && ( + + ) + } + { + ogType === 'article' && articleAuthor && ( + + ) + } + { + ogType === 'article' && articleSection && ( + + ) + } + + + + {socialImage && } + {socialImage && imageAlt && } + {title} + { + structuredItems.map((item) => ( +