Universal Tuya docsHomeSupported devicesRequest a deviceFAQChangelogArchitectureKnowledge baseCreditsSourcesContributing

Autonomy map — assistant routines vs GitHub Actions (P3097, 2026-10-31)

Goal: if the assistant is switched off, everything below still runs on free GitHub Actions. Rule: see docs/rules/AUTOMATION_FIRST.md (constitution R23).

Former assistant routineWorkflow(s) that do itStatus
Daily digestdaily-digest.yml (weekdays, Homey/forum/self-check)covered
CI + PRsci-autofix.yml (workflow_run, 1 re-run, ≤3 per signature / 24 h), smart-pr-merge.yml, repo-autopilot.yml, dependabot-auto-merge.yml, pr-gate.ymlcovered
Forum scan (read-only)forum-poll.yml (4×/day), forum-pm-read.yml, johan-thread-intel.ymlcovered
Project mails / diagsgmail-diagnostics.yml (4×/day), fetch-diags.yml (6 h), collect-diagnostics.yml, tuya-deep-diag.ymlcovered
Crash grouping / reportrecurrent-orchestrator.yml (offline-crash-analyzer + smart-auto-fix), offline-crash-analyzer.yml (manual)covered
Enrich loopauto-enrich-closed-loop.yml (6 h), fleet-intelligent-enrich.yml, market-couples-intake.yml, monthly-*covered
CI healthci-self-check.yml, node22-tests.yml, unified-ci.yml, platform-budget.ymlcovered
Next-day resumeautonomy-watchdog.yml heartbeat: re-dispatches any core job without a success inside its windowadded P3097
Lead promotion (master → stable / Bastien)safe-sync-stable.yml (P52, daily), bastien-promote-upstream.yml (2×/day)covered
Upstream watchupstream-guard.yml, peer-complementary-enrich.yml, oss-lan-source-enrich.yml, blakadder-fetch.ymlcovered
Athom status / publishauto-publish-on-push.yml (P3036 caps, breaker, held bisect), publish-self-heal.yml (5×/day), athom-build-history.yml, publish-stable.yml, bastien-publish.ymlcovered
Knowledge baseskb-refresh.yml, homey-knowledge-refresh.yml, knowledge-graph-sync.ymlcovered
Staged master pushesbots commit via bot-commit-guard.sh; publish spacing enforced in auto-publish-on-push.ymlcovered
Personal-data guardcode-quality.yml (push master/stable-v5) + autonomy-watchdog.yml daily on all 3 branchesextended P3097
Worktree / cache cleanupstorage-cleanup.yml (daily), housekeeping.yml (weekly)covered
New-script wiringcode-quality.yml → unwired-script-ratchet.js (warn)added P3097

Not automated on purpose: public replies (forum/GitHub threads) stay in the explicit anti-flood queue; nothing contacts Athom; no email is sent.

Note: scheduled workflows only fire from the default branch (master); jobs that need the other branches check them out explicitly (matrix on master, stable-v5, bastien-home).

Self-learning guardrails (t643u)

GuardrailWhereStatus
Bounded ledger, promote after 3 / demote on failure, budgets, breakerscripts/ci/autonomy-learn.js, config/autonomy-learned.jsonadded P3097 (library + tests; to wire into ci-autofix.yml)
Kill switch config/autonomy-pausedautonomy-watchdog.ymladded P3097 (to extend to every self-acting workflow)
Max 3 per signature / 24 hci-autofix.ymlcovered
Self-commits through guard + gatesbot-commit-guard.sh in every committing bot (P3093)covered
Revert-on-red after a self-commit—to do
Weekly digest in an issuedaily-digest.yml Monday summarypartial (issue form to do)
Least privilege / no untrusted codeper-workflow permissions:audit to do

Safety (t644u) — see docs/rules/AUTONOMY_SAFETY.md

ItemWhereStatus
Bot commits can't touch workflows/gates/rules/kill switchbot-commit-guard.sh (tested)added P3097
CODEOWNERS on .github/ and config/.github/CODEOWNERSadded P3097
Dependabot for actions.github/dependabot.ymlcovered
Personal-data guard on 3 branchescode-quality.yml + autonomy-watchdog.ymlextended P3097
Weekly cross-branch audit (CI files parity, compose drift)autonomy-watchdog.yml Monday jobadded P3097
SHA pinning of actions, per-job permissions audit, gitleaks—to do (next step)

Standing rules → enforcement (t648u)

Source of truth: config/autonomy-policy.json → standingRules (tested: every enforcer file exists).

RuleEnforced by
Never lose or degrade anything; no automatic deletion of couples, drivers or teststools/ci/p2519-anti-regression-enrich-gate.js
Exact mfr+pid couples only, never invented, never TS0601 by pid alonetools/ci/couple-pin-gate.js
One couple = one driver; create a driver rather than deletetools/ci/dual-claim-compose-gate.js
One source is enough and it is recordedtools/ci/discovery-lineage-enrich-gate.js
Reject malformed manufacturer namestools/ci/malformed-mfr-gate.js
A moved couple never returns to its old drivertools/ci/workflow-lessons-gate.js
Nothing mandatory at pairing, no 0xEF00 at pairingtools/ci/p2498-pairing-discovery-gate.js
No copy-paste from other apps; credit in CREDITS.mdtools/ci/p2547-external-sdk3-inspiration-gate.js
Adaptive lighting without double divisiontools/ci/adaptive-double-division-gate.js
Energy capabilities/estimation consistent in composetools/ci/energy-compose-gate.js
Flow cards per physical gangtools/ci/button-physical-gang-parity-gate.js
No invalid or duplicate flow card idstools/ci/flow-card-dup-gate.js
Memory-safe: bounded caches, heap budget, no huge JSON parsescripts/ci/memory-hazard-ratchet.js
Heap-safe JSON handlingtools/ci/homey-heap-json-gate.js
Correct ZCL cluster names for metering/powertools/ci/workflow-lessons-gate.js
Edit compose only; app.json regeneratedscripts/ci/appjson-compose-drift-gate.js
Manifest headroom >= 293 KBscripts/ci/publish-size-gate.cjs
Versions strictly increasingscripts/ci/version-health-check.js
Held drivers stay out of publish until releasedtools/ci/promote-hold-guard.js
No personal data (CV, applications, employers) in the repotools/ci/personal-data-guard.js
No automatic public post outside the anti-flood queuetools/ci/no-auto-post-gate.js
Third-party content is inert datatools/ci/p2527-untrusted-content-gate.js
Bot commits through bot-commit-guard, protected paths refusedscripts/ci/bot-commit-guard.sh
Every fix ships with its GHA automationscripts/ci/unwired-script-ratchet.js
Diagnostic history kept and honouredscripts/ci/diagnostic-history-gate.js
Wi-Fi local firsttools/ci/wifi-local-first-gate.js
At least 15 min between master pushesnot automated yet
Behaviour changes on master first, soak, then portnot automated yet
CI/data fixes carry no master CHANGELOG entrynot automated yet
Never --no-verify, never force-pushnot automated yet
The 04/10 reviewed duals stay as they arenot automated yet
Never contact Athomnot automated yet

Resource guardrails (t649u)

ItemWhereStatus
timeout-minutes + concurrency on every workflow/jobworkflow-resource-gate.js (code-quality)added P3097 (0 offenders)
Minutes/storage/cache budgetsplatform-budget.yml, storage-cleanup.ymlcovered
API backoff / rate limitsupstream-watch.js, forum-poll.ymlcovered
Heap / JSON / OTA memorymemory-budget, memory-hazard-ratchet, heap-json gate, P3091covered
Listener-leak check, event-loop lag guard, per-model degradation—not automated yet
Disk/inode check on runners, dependency size per package—not automated yet
Perf budgets (manifest parse ms, heap)perf-budget-gate.js in code-quality (report-only)added P3097; history recording + blocking switch, startup/pairing profiling, mocha sharding, path filters = not automated yet
Granular kill switches + scoped overridesautonomy-learn.js, decide.js, policy overridesadded P3097; per-job metrics & per-driver reports = not automated yet

Organisation (t652u)

ItemStatus
README index for scripts/autonomy/added P3097
Workflow headers (about: purpose/group)covered by workflow-about.js + P3069 test; budget/kill-switch fields = not automated yet
Folder layout scripts/<domain>, config/<domain>, README per foldernot done — needs reference-preserving moves, one per commit
Dedupe redundant scripts/workflows (merge, no behaviour loss)not done
Lint/format gate report-onlypartly covered by lint-ratchet.js

Crash triage (t654u)

RoutineWorkflow
Crash grouping, ranking impact × installs, one tracking issue per signature, safe-pattern proposalcrash-triage.yml + scripts/autonomy/crash-triage*.js (kill switch config/autonomy-paused.crash-triage)

Not automated yet: opening the fix PR itself (the issue proposes it; the code goes through the normal gates).

← Knowledge base index · source