@ludecker/aaac 1.1.6 → 1.2.0

package/templates/cursor/skills/shared/remediation/orchestrator/contract.yaml

@@ -0,0 +1,116 @@
+version: 1
+command: remediate-app
+orchestrator: remediate-app
+description: Campaign loop — Fallow, check swarm, fix waves, regression gates, debt sweep, satisfaction
+
+phases:
+  - campaign_init
+  - scan
+  - check_swarm
+  - plan_waves
+  - execute
+  - debt_sweep
+  - satisfaction_gate
+  - report
+
+requires:
+  - remediation
+  - discovery
+  - check
+  - execution
+  - testing
+  - verification
+  - reporting
+
+invariants:
+  exit_3_is_continue: true
+  wave_gate_mode: regression
+  debt_gate_mode: strict
+  validate_before_report: true
+
+blocking_gates:
+  - verify_wave_regression_after_each_fix
+  - remediator_subloop_per_wave
+  - debt_sweep_strict_mandatory
+  - satisfaction_threshold
+
+remediator:
+  gate_script: remediation/remediator-gate.mjs
+  debt_sweep_script: remediation/debt-sweep-gate.mjs
+  validate_script: remediation/validate-campaign-complete.mjs
+  baseline_script: remediation/capture-verify-baseline.mjs
+  wave_snapshot_script: remediation/capture-wave-snapshot.mjs
+  classify_script: remediation/classify-verify-failure.mjs
+  dispatch_rules: remediation/dispatch-rules.json
+  agent: agents/remediation-remediator.md
+  exit_codes:
+    promote: 0
+    block: 1
+    runtime_error: 2
+    remediate_required: 3
+  defaults:
+    max_remediator_attempts_per_wave: 3
+    max_remediator_attempts_per_debt_round: 3
+    max_debt_sweep_rounds: 10
+    wave_gate_mode: regression
+
+artifacts:
+  campaign_init: [artifacts/campaign.json, artifacts/verify_baseline.json, artifacts/autonomous_bootstrap.json]
+  scan: [artifacts/fallow_scan.json, artifacts/fallow_dupes.json, artifacts/fallow_health.json, artifacts/fallow_scan_bundle.json, artifacts/fallow_classification.json]
+  check_swarm: [artifacts/check_synthesis.md, artifacts/dispatch-queue.yaml, artifacts/check_app_validate.yaml, artifacts/check_architecture_fitness.yaml, artifacts/protected_paths.yaml, artifacts/check_swarm_merge.json]
+  plan_waves: [artifacts/plan_waves.yaml]
+  execute: [artifacts/execute_waves.yaml]
+  debt_sweep: [artifacts/debt_sweep.json, artifacts/verify_debt.json]
+  satisfaction_gate: [artifacts/satisfaction.json, artifacts/satisfaction_loop_gate.json]
+  report: [artifacts/report.md]
+
+scripts:
+  init: remediation/init-campaign.mjs
+  baseline: remediation/capture-verify-baseline.mjs
+  wave_snapshot: remediation/capture-wave-snapshot.mjs
+  fallow_scan: remediation/fallow-scan.mjs
+  verify: remediation/verify-remediation-iteration.mjs
+  remediator_gate: remediation/remediator-gate.mjs
+  debt_sweep: remediation/debt-sweep-gate.mjs
+  satisfaction_loop: remediation/satisfaction-loop-gate.mjs
+  repair_fallow_start: remediation/repair-fallow-start-baseline.mjs
+  validate_complete: remediation/validate-campaign-complete.mjs
+  classify_failure: remediation/classify-verify-failure.mjs
+  satisfaction: remediation/compute-satisfaction.mjs
+  journal: remediation/record-iteration-step.mjs
+  bootstrap_autonomous: remediation/bootstrap-autonomous.mjs
+  runner: remediation/remediation-runner.mjs
+  runner_health: remediation/runner-health-check.mjs
+
+satisfaction_weights:
+  fallow_dead_code: 0.25
+  fallow_dupes: 0.10
+  fallow_health: 0.05
+  structural_clean: 0.15
+  unit_tests: 0.15
+  build: 0.10
+  e2e: 0.20
+
+defaults:
+  max_iterations: 5
+  max_waves_per_iteration: 3
+  max_remediator_attempts_per_wave: 3
+  max_remediator_attempts_per_debt_round: 3
+  max_debt_sweep_rounds: 10
+  wave_gate_mode: regression
+  satisfaction_threshold: 85
+  scope: whole-repo
+  autonomous_max_iterations: 10
+  autonomous_satisfaction_threshold: 100
+
+autonomous:
+  enabled_when:
+    - intent_token: autonomous
+    - satisfaction_threshold_gte: 100
+    - max_iterations_gte: 10
+  disabled_when:
+    - intent_token: manual
+  skill: skills/shared/remediation/babysit/SKILL.md
+  bootstrap_script: remediation/bootstrap-autonomous.mjs
+  runner_script: remediation/remediation-runner.mjs
+  health_script: remediation/runner-health-check.mjs

package/templates/docs/agentic_architecture.md

@@ -49,6 +49,7 @@ Without a domain overlay, commands route to **generic verb orchestrators** (`ver
 | `test-module` / `test-function` | Verify behavior |
 | `update-doc` | Update architecture documentation (no code) |
 | `release-app` | Phased release swarm (git push + deploy steps) |
+| `remediate-app` | Long-running tech-debt campaign (Fallow + fix waves + satisfaction loop) |
 
 See [`.cursor/aaac/ontology.md`](../.cursor/aaac/ontology.md) for the full verb × object matrix (~130 commands).