wiki: deployment-specification page (env-var catalogue + runtime contract)
New top-level page covering the deployment shape for noetl-worker:
runtime contract, NATS layout, KEDA scaling, resources, health
probes, FULL env-var catalogue with the why behind each one,
secrets handling, snowflake node-id derivation, observability,
kind-validation procedure.
Captures the existing env surface (WORKER_ID, WORKER_POOL_NAME,
WORKER_HEARTBEAT_INTERVAL, WORKER_MAX_CONCURRENT,
WORKER_METRICS_BIND, WORKER_NATS_LAG_POLL_INTERVAL,
NOETL_SERVER_URL, NATS_URL/USER/PASSWORD/STREAM/CONSUMER/SUBJECT/
FILTER_SUBJECT, NOETL_SNOWFLAKE_NODE_ID, NOETL_SHARD_ID,
NOETL_NODE_ID, NODE_NAME, NOETL_SNOWFLAKE_EPOCH_MS,
NOETL_KEYCHAIN_ENV_VARS, NOETL_IPC_CACHE_BUDGET_BYTES, HOSTNAME,
RUST_LOG). Several of these had only inline rustdoc coverage
before; this page is the durable single-source-of-truth.
Sidebar gains an "Operations" section linking the new page;
Home references it in the Pages list.
Going forward this page is the single source of truth for env
vars + ports + dependencies; any code change that touches
std::env::var or envy::from_env must update it in the same
change set per the new agents/rules/wiki-maintenance.md Rule 2a
(landing separately on ai-meta).
docs(worker): add nats + mcp tool kinds page + update crate dep in Home
Documents the nats (2.15.0) and mcp (2.16.0) tool kinds from the
worker's dispatch perspective: playbook config shape, credential wiring
via NOETL_KEYCHAIN_ENV_VARS, endpoint resolution (mcp), and the
dynamic registry dispatch path.
Cross-linked from Home.md (Pages section) and _Sidebar.md (Architecture
section). Also bumps the noetl-tools version in the dependency graph
diagram from "2.11" to "2.16".
Tracks noetl/ai-meta#40.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
wiki: worker-credentials page (NOETL_KEYCHAIN_ENV_VARS, noetl/worker#35)
wiki: bump noetl-tools 2.8.7 -> 2.11 + noetl-executor 0.2 -> 0.3 in graph
Reflects the actual deps the worker carries after noetl/worker#32
(picks up the result_fetch tool kind from noetl-tools 2.11).
noetl-executor was already at 0.3.0 since R-1.2 PR-2d-1.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs(wiki): scaffold worker wiki (Home + noetl-executor-adoption + release-pipeline + sidebar)
First substantive content for the noetl-worker wiki. Replaces the
"Welcome to the worker wiki!" stub with a Home page covering crate
architecture, module layout, and pages.
- **Home.md**: dependency graph, module layout table (per-module
link to GitHub source), distribution channels, related repo
cross-links.
- **noetl-executor-adoption.md**: companion to the cli wiki's
executor-crate-architecture page from the worker side. Lists
what the worker imports from noetl-executor today (Operator,
Condition, evaluate_structured_condition), what stays
worker-local (pull-loop control flow per § H.10), and the R-1.2
sub-PR landing history (PR-2c shipped; PR-2d planned).
- **release-pipeline.md**: documents the semantic-release →
release-worker flow, the GitHub-Actions safeguard gotcha
(GITHUB_TOKEN-created tags don't fire workflows), and the fix
pattern noetl/cli uses (#32) which noetl/worker#4 will adopt.
- **_Sidebar.md**: navigation; cross-links to cli + tools +
server + noetl + ops wikis.
Cross-references all use the noetl/<repo>#<NN> format per the
ai-meta cross-repo issue-linking discipline.
Refs noetl/ai-meta#30 -- Appendix H umbrella.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>