From 7f9cc62cc6c901c1de996b6c028df84d15a2971c Mon Sep 17 00:00:00 2001 From: tegwick Date: Thu, 18 Jun 2026 18:11:43 +0200 Subject: [PATCH 01/10] Enable registry hygiene sweep after ACTIVITY-WP-0013 R2 Turn on coulomb-daily-registry-hygiene-sweep with runtime resolver params; document live smoke (4 gaps) and issue-core emit follow-up. --- .../daily-registry-hygiene-sweep.md | 10 +++++++--- docs/integrations/activity-core-handoff.md | 9 ++++++--- .../registry-hygiene/expansion-reuse-surface.yml | 3 +-- loops/registry-hygiene/health.jsonl | 3 ++- loops/registry-hygiene/round-robin-state.json | 15 ++++++++------- loops/regulator/dashboard.md | 6 +++--- .../LOOP-WP-0005-operate-phase-observation.md | 2 +- 7 files changed, 28 insertions(+), 20 deletions(-) diff --git a/activity-definitions/daily-registry-hygiene-sweep.md b/activity-definitions/daily-registry-hygiene-sweep.md index cb4fa29..b3af19f 100644 --- a/activity-definitions/daily-registry-hygiene-sweep.md +++ b/activity-definitions/daily-registry-hygiene-sweep.md @@ -1,10 +1,10 @@ --- id: coulomb-daily-registry-hygiene-sweep name: Daily Registry Hygiene Sweep (coulomb-loop stabilize) -enabled: false +enabled: true owner: coulomb-loop governance: coulomb_social -status: proposed +status: active trigger: type: cron cron_expression: "0 7 * * *" @@ -21,6 +21,9 @@ context_sources: params: roster: /home/worsch/coulomb-loop/loops/registry-hygiene/rollout.yaml batch_size: 3 + round_robin_state: /home/worsch/coulomb-loop/loops/registry-hygiene/round-robin-state.json + reuse_surface_bin: /home/worsch/reuse-surface/.venv/bin/reuse-surface + runner_host: bnt-lap001 bind_to: context.gaps --- @@ -45,4 +48,5 @@ action: labels: ["fleet-hygiene", "coulomb-loop", "scope-analyst"] ``` -`enabled: false` until `reuse_surface_report_gaps` shell resolver exists in activity-core. \ No newline at end of file +Enabled 2026-06-18 after ACTIVITY-WP-0013 (`2078915`). Runtime params per +activity-core R2 note `36ac3eeb` (reuse_surface_bin + runner_host). \ No newline at end of file diff --git a/docs/integrations/activity-core-handoff.md b/docs/integrations/activity-core-handoff.md index 31d6a6a..5d62ab6 100644 --- a/docs/integrations/activity-core-handoff.md +++ b/docs/integrations/activity-core-handoff.md @@ -36,12 +36,15 @@ kaizen-agentic metrics optimize --target /home/worsch/kaizen-agentic 3. `daily-optimization-review` (enabled) 4. `low-success-rate-review` (enabled — event primary) 5. `daily-metrics-health-sweep` (backup, disabled) -6. `daily-registry-hygiene-sweep` (after shell resolver) +6. `daily-registry-hygiene-sweep` (enabled — ACTIVITY-WP-0013) 7. `daily-loop-health-collector` (after instruction executor) ## Blocked on activity-core -- R2 `reuse_surface_report_gaps` shell resolver — LOOP-WP-0005 T06 handoff posted - Instruction executor for loop health collector - Daily loop-health-collector — LOOP-WP-0004 done; cron `0 11 * * *` (disabled) -- Hot-reload definitions/schedules — hub message `f4876517` \ No newline at end of file + +## Closed (activity-core) + +- R2 `reuse_surface_report_gaps` — ACTIVITY-WP-0013 (`2078915`); sweep enabled +- R1 `event-payload` — ACTIVITY-WP-0011; low-success-rate-review live \ No newline at end of file diff --git a/loops/registry-hygiene/expansion-reuse-surface.yml b/loops/registry-hygiene/expansion-reuse-surface.yml index 6bbbe51..1606764 100644 --- a/loops/registry-hygiene/expansion-reuse-surface.yml +++ b/loops/registry-hygiene/expansion-reuse-surface.yml @@ -22,8 +22,7 @@ onboarding: - reuse-surface establish --publish-check blockers: - - reuse_surface_report_gaps shell resolver (activity-core; LOOP-WP-0005-T06) - - daily-registry-hygiene-sweep enabled gate + - issue-core task sink for hygiene task emission (operator) promotion: trigger: shell resolver shipped + 7 daily stabilize cycles on custodian batch diff --git a/loops/registry-hygiene/health.jsonl b/loops/registry-hygiene/health.jsonl index eb68e70..c2ea4c1 100644 --- a/loops/registry-hygiene/health.jsonl +++ b/loops/registry-hygiene/health.jsonl @@ -1,3 +1,4 @@ {"timestamp":"2026-06-18T10:16:00Z","loop":"registry-hygiene","phase":"bootstrap","tasks_created":0,"manual_rescues":0,"notes":"T01 signals/rollout committed; sweep disabled pending shell resolver"} {"timestamp":"2026-06-18T11:22:00Z","loop":"registry-hygiene","phase":"bootstrap","tasks_created":9,"manual_rescues":0,"false_positive_rate":0.0,"notes":"3/3 pilot rounds; empty_scaffolds=2 stable"} -{"timestamp":"2026-06-18T11:22:00Z","loop":"registry-hygiene","phase":"stabilize","tasks_created":null,"manual_rescues":0,"notes":"Promoted daily 07:00; helix_forge added per T06 DEC-006"} \ No newline at end of file +{"timestamp":"2026-06-18T11:22:00Z","loop":"registry-hygiene","phase":"stabilize","tasks_created":null,"manual_rescues":0,"notes":"Promoted daily 07:00; helix_forge added per T06 DEC-006"} +{"timestamp":"2026-06-18T16:11:00Z","loop":"registry-hygiene","phase":"stabilize","tasks_created":4,"manual_rescues":0,"false_positive_rate":0.0,"notes":"R2 ACTIVITY-WP-0013 live; sweep enabled 744294af; resolver 4 gaps; emit 404 issue-core"} \ No newline at end of file diff --git a/loops/registry-hygiene/round-robin-state.json b/loops/registry-hygiene/round-robin-state.json index 72c2f7c..c646ce0 100644 --- a/loops/registry-hygiene/round-robin-state.json +++ b/loops/registry-hygiene/round-robin-state.json @@ -1,8 +1,9 @@ { - "cursor_domain": "custodian", - "cursor_index": 0, - "last_run": "2026-06-18T11:22:00Z", - "last_batch": ["kaizen-agentic", "the-custodian", "activity-core"], - "rounds_completed": 3, - "duplicate_tasks": 0 -} \ No newline at end of file + "cursor": 2, + "last_batch": [ + "reuse-surface", + "kaizen-agentic", + "the-custodian" + ], + "updated_at": "2026-06-18T16:11:20.117486+00:00" +} diff --git a/loops/regulator/dashboard.md b/loops/regulator/dashboard.md index 7f95da2..1871cdd 100644 --- a/loops/regulator/dashboard.md +++ b/loops/regulator/dashboard.md @@ -8,7 +8,7 @@ Regenerated 2026-06-18 (LOOP-WP-0005 T01). |------|-------|-------------|----------------|----------------| | kaizen-improvement-stack | stabilize | 2026-06-18T10:16Z | 0 | **hold** — daily chain 08:00→10:00 active | | quality-escalation | stabilize | 2026-06-18T12:05Z | 0 | **hold** — event path live; backup sweep disabled | -| registry-hygiene | stabilize | 2026-06-18T11:22Z | 0 | **hold** — daily sweep; blocked on shell resolver | +| registry-hygiene | stabilize | 2026-06-18T16:11Z | 0 | **hold** — daily sweep enabled; R2 live | | loop-regulator | stabilize | 2026-06-18T11:22Z | 0 | **hold** — daily collector 11:00 (manual until executor) | ## Stabilize observation (ADR-003) @@ -30,7 +30,7 @@ See `stabilize-observation.yml`. Weekly promotion **not** before review. | `coulomb-daily-optimization-review` | `0 10 * * *` | yes | | `coulomb-low-success-rate-review` | event | yes | | `coulomb-daily-metrics-health-sweep` | `0 6 * * *` | no (backup) | -| `coulomb-daily-registry-hygiene-sweep` | `0 7 * * *` | no (resolver) | +| `coulomb-daily-registry-hygiene-sweep` | `0 7 * * *` | yes | Retired `coulomb-hourly-*` ids disabled on sync. @@ -49,7 +49,7 @@ No rotation recommended. See `rotation-runbook.md`. | Item | Owner | Hub ref | |------|-------|---------| -| `reuse_surface_report_gaps` resolver | activity-core | handoff R2 posted | +| Issue-core task sink (`/issues/`) | operator | manual trigger 4 tasks; emit 404 | | Hot-reload definitions/schedules | activity-core | `f4876517` | | Loop health instruction executor | activity-core | `daily-loop-health-collector` | diff --git a/workplans/LOOP-WP-0005-operate-phase-observation.md b/workplans/LOOP-WP-0005-operate-phase-observation.md index f62e78c..06401e5 100644 --- a/workplans/LOOP-WP-0005-operate-phase-observation.md +++ b/workplans/LOOP-WP-0005-operate-phase-observation.md @@ -65,7 +65,7 @@ premature promotion. Refresh operator-facing health artefacts, start the ADR-003 |------|-------|-------------------| | kaizen-improvement-stack | stabilize | daily coach/optimization chain | | quality-escalation | stabilize | event `low-success-rate-review` + daily backup sweep | -| registry-hygiene | stabilize | daily sweep (disabled pending shell resolver) | +| registry-hygiene | stabilize | daily sweep enabled (ACTIVITY-WP-0013) | | loop-regulator | stabilize | daily collector 11:00 + weekly session Mon 11:00 | Bootstrap sprint closed. Activity definitions renamed `coulomb-daily-*`. Worker From 3eb553f5083c9c715f86e74e9e547d5b809793d6 Mon Sep 17 00:00:00 2001 From: tegwick Date: Fri, 19 Jun 2026 01:36:22 +0200 Subject: [PATCH 02/10] chore(consistency): sync task status from DB [auto] Updated by fix-consistency on 2026-06-19: - update .custodian-brief.md for coulomb-loop --- .custodian-brief.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/.custodian-brief.md b/.custodian-brief.md index 1df1165..88a5fc2 100644 --- a/.custodian-brief.md +++ b/.custodian-brief.md @@ -2,19 +2,16 @@ # Custodian Brief — coulomb-loop **Domain:** coulomb_social -**Last synced:** 2026-06-18 13:16 UTC +**Last synced:** 2026-06-18 23:36 UTC **State Hub:** http://127.0.0.1:8000 *(adjust if running on a remote machine)* ## Active Workstreams ### Operate phase observation and fleet expansion prep -Progress: 3/7 done | workstream_id: `620731c9-ed7b-478d-97a2-5e251c2c36ff` +Progress: 6/7 done | workstream_id: `620731c9-ed7b-478d-97a2-5e251c2c36ff` **Open tasks:** -- · Operate-phase draft `07554dce` -- · activity-core handoff `92f93ac2` - · Regulator review (gate) `890416df` -- · reuse-surface expansion prep `c6667e3e` --- ## MCP Orientation (when available) From 78b82dd17bf9a39ba098c03b9b0377faa37a6dba Mon Sep 17 00:00:00 2001 From: tegwick Date: Fri, 19 Jun 2026 01:39:41 +0200 Subject: [PATCH 03/10] chore(consistency): sync task status from DB [auto] Updated by fix-consistency on 2026-06-19: - update .custodian-brief.md for coulomb-loop --- .custodian-brief.md | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/.custodian-brief.md b/.custodian-brief.md index 88a5fc2..dc6a487 100644 --- a/.custodian-brief.md +++ b/.custodian-brief.md @@ -2,16 +2,12 @@ # Custodian Brief — coulomb-loop **Domain:** coulomb_social -**Last synced:** 2026-06-18 23:36 UTC +**Last synced:** 2026-06-18 23:39 UTC **State Hub:** http://127.0.0.1:8000 *(adjust if running on a remote machine)* ## Active Workstreams -### Operate phase observation and fleet expansion prep -Progress: 6/7 done | workstream_id: `620731c9-ed7b-478d-97a2-5e251c2c36ff` - -**Open tasks:** -- · Regulator review (gate) `890416df` +*(none — repo may need first-session setup)* --- ## MCP Orientation (when available) From 27e05552a23a1981901ebd7b473ab4fb0928ea79 Mon Sep 17 00:00:00 2001 From: tegwick Date: Fri, 19 Jun 2026 01:39:47 +0200 Subject: [PATCH 04/10] Complete LOOP-WP-0005: DEC-008 weekly operate promotion MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Operator override per ADR-003 closes the stabilize observation window early (day 2/14) and promotes all four loops to weekly Mon crons. Activity definitions renamed coulomb-daily-* → coulomb-weekly-*; cadence.yml, dashboard, SCOPE, and health records updated. activity-core definition sync still required on operator side. --- SCOPE.md | 6 +- .../low-success-rate-review.md | 2 +- ...ntation.md => weekly-coach-orientation.md} | 18 ++--- ...tor.md => weekly-loop-health-collector.md} | 12 ++-- ...weep.md => weekly-metrics-health-sweep.md} | 12 ++-- ...optimize.md => weekly-metrics-optimize.md} | 14 ++-- ...eview.md => weekly-optimization-review.md} | 18 ++--- ...ep.md => weekly-registry-hygiene-sweep.md} | 17 +++-- .../DEC-008-operate-phase-promotion.md | 66 +++++++++++++++++++ docs/integrations/activity-core-handoff.md | 30 +++++---- loops/kaizen-stack/cadence.yml | 30 +++------ loops/kaizen-stack/health.jsonl | 3 +- loops/quality-escalation/cadence.yml | 26 ++------ loops/quality-escalation/health.jsonl | 3 +- loops/quality-escalation/thresholds.yml | 8 ++- loops/registry-hygiene/cadence.yml | 28 +++----- loops/registry-hygiene/health.jsonl | 3 +- loops/regulator/cadence.yml | 23 ++----- loops/regulator/dashboard.md | 41 ++++++------ loops/regulator/health.jsonl | 3 +- loops/regulator/stabilize-observation.yml | 14 +++- .../LOOP-WP-0005-operate-phase-observation.md | 23 ++++--- 22 files changed, 227 insertions(+), 173 deletions(-) rename activity-definitions/{daily-coach-orientation.md => weekly-coach-orientation.md} (65%) rename activity-definitions/{daily-loop-health-collector.md => weekly-loop-health-collector.md} (79%) rename activity-definitions/{daily-metrics-health-sweep.md => weekly-metrics-health-sweep.md} (78%) rename activity-definitions/{daily-metrics-optimize.md => weekly-metrics-optimize.md} (71%) rename activity-definitions/{daily-optimization-review.md => weekly-optimization-review.md} (72%) rename activity-definitions/{daily-registry-hygiene-sweep.md => weekly-registry-hygiene-sweep.md} (72%) create mode 100644 docs/decisions/DEC-008-operate-phase-promotion.md diff --git a/SCOPE.md b/SCOPE.md index 9b83333..aefb254 100644 --- a/SCOPE.md +++ b/SCOPE.md @@ -41,10 +41,10 @@ with project-scoped memory and metrics. ## Current State -- Status: active (stabilize — daily cadence) +- Status: active (operate — weekly cadence) - Implementation: four loops operational on custodian pilot roster (3 repos) -- Stability: observation window 2026-06-18 → 2026-07-02 (LOOP-WP-0005) -- Usage: internal engagement; weekly promotion gated on regulator review +- Stability: observation window closed 2026-06-19 via DEC-008 operator override (LOOP-WP-0005 done) +- Usage: internal engagement; weekly Mon crons live; activity-core sync pending ## How It Fits diff --git a/activity-definitions/low-success-rate-review.md b/activity-definitions/low-success-rate-review.md index 16a124d..034ecb9 100644 --- a/activity-definitions/low-success-rate-review.md +++ b/activity-definitions/low-success-rate-review.md @@ -16,7 +16,7 @@ context_sources: # Low Agent Success Rate Review Enabled 2026-06-18 after activity-core event-payload resolver (ACTIVITY-WP-0011). -Fallback: `daily-metrics-health-sweep.md` at `0 6 * * *`. +Fallback: `weekly-metrics-health-sweep.md` at `0 6 * * 1`. ```rule id: flag-low-success-rate diff --git a/activity-definitions/daily-coach-orientation.md b/activity-definitions/weekly-coach-orientation.md similarity index 65% rename from activity-definitions/daily-coach-orientation.md rename to activity-definitions/weekly-coach-orientation.md index b33c181..ca5c661 100644 --- a/activity-definitions/daily-coach-orientation.md +++ b/activity-definitions/weekly-coach-orientation.md @@ -1,13 +1,13 @@ --- -id: coulomb-daily-coach-orientation -name: Daily Kaizen Coach Orientation (coulomb-loop stabilize) +id: coulomb-weekly-coach-orientation +name: Weekly Kaizen Coach Orientation (coulomb-loop operate) enabled: true owner: coulomb-loop governance: coulomb_social status: proposed trigger: type: cron - cron_expression: "0 9 * * *" + cron_expression: "0 9 * * 1" timezone: Europe/Berlin misfire_policy: skip context_sources: @@ -15,26 +15,26 @@ context_sources: query: discover_kaizen_scheduled_repos params: roster: /home/worsch/coulomb-loop/loops/kaizen-stack/roster.yaml - cadence: daily + cadence: weekly bind_to: context.scheduled_runs --- -# Daily Kaizen Coach Orientation +# Weekly Kaizen Coach Orientation -Stabilize phase per DEC-005. Cron `0 9 * * *` Europe/Berlin. +Operate phase per DEC-008. Cron `0 9 * * 1` Europe/Berlin. ```rule -id: run-daily-coach +id: run-weekly-coach for_each: context.scheduled_runs bind_as: r condition: 'context.r.agent == "coach" and context.r.enabled' action: - task_template: "Daily coach orientation: {context.r.repo}" + task_template: "Weekly coach orientation: {context.r.repo}" description: | {context.r.prepare_command} Load agents/agent-coach.md, execute coach synthesis. Session close: kaizen-agentic metrics record coach --success --time --quality <0-1> --emit-event target_repo: context.r.repo priority: medium - labels: ["kaizen", "agent-run", "coach", "coulomb-loop", "stabilize"] + labels: ["kaizen", "agent-run", "coach", "coulomb-loop", "operate"] ``` \ No newline at end of file diff --git a/activity-definitions/daily-loop-health-collector.md b/activity-definitions/weekly-loop-health-collector.md similarity index 79% rename from activity-definitions/daily-loop-health-collector.md rename to activity-definitions/weekly-loop-health-collector.md index 0ce5daf..0d20ac9 100644 --- a/activity-definitions/daily-loop-health-collector.md +++ b/activity-definitions/weekly-loop-health-collector.md @@ -1,13 +1,13 @@ --- -id: coulomb-daily-loop-health-collector -name: Daily Loop Health Collector (coulomb-loop regulator) +id: coulomb-weekly-loop-health-collector +name: Weekly Loop Health Collector (coulomb-loop regulator) enabled: false owner: coulomb-loop governance: coulomb_social status: proposed trigger: type: cron - cron_expression: "0 11 * * *" + cron_expression: "0 11 * * 1" timezone: Europe/Berlin misfire_policy: skip context_sources: @@ -26,10 +26,10 @@ context_sources: bind_to: context.pilot_metrics --- -# Daily Loop Health Collector +# Weekly Loop Health Collector LOOP-WP-0004 — aggregates first-order loop health for regulator sessions. -Daily `0 11 * * *` after first-order chains (DEC-007). +Weekly `0 11 * * 1` aligned with regulator session (DEC-008). ```instruction id: append-health-snapshot @@ -38,7 +38,7 @@ description: | loops//health.jsonl with: - timestamp, phase, tasks_created (from hub), manual_rescues (bootstrap-log), agent_success_rate (pilot metrics avg), false_positive_rate (estimate). - Regenerate loops/regulator/dashboard.md from last 24h of health.jsonl files. + Regenerate loops/regulator/dashboard.md from last 7d of health.jsonl files. If demotion trigger from state-machine.md fires, create urgent optimization task. ``` diff --git a/activity-definitions/daily-metrics-health-sweep.md b/activity-definitions/weekly-metrics-health-sweep.md similarity index 78% rename from activity-definitions/daily-metrics-health-sweep.md rename to activity-definitions/weekly-metrics-health-sweep.md index 257d7c3..30e0a31 100644 --- a/activity-definitions/daily-metrics-health-sweep.md +++ b/activity-definitions/weekly-metrics-health-sweep.md @@ -1,13 +1,13 @@ --- -id: coulomb-daily-metrics-health-sweep -name: Daily Metrics Health Sweep (coulomb-loop backup) +id: coulomb-weekly-metrics-health-sweep +name: Weekly Metrics Health Sweep (coulomb-loop backup) enabled: false owner: coulomb-loop governance: coulomb_social status: proposed trigger: type: cron - cron_expression: "0 6 * * *" + cron_expression: "0 6 * * 1" timezone: Europe/Berlin misfire_policy: skip context_sources: @@ -19,13 +19,13 @@ context_sources: bind_to: context.projects --- -# Daily Metrics Health Sweep (backup) +# Weekly Metrics Health Sweep (backup) -Stabilize-phase backup per LOOP-WP-0002 T07. Primary path is event-driven +Operate-phase backup per LOOP-WP-0002. Primary path is event-driven `low-success-rate-review`; enable only if the event bus is down. ```rule -id: flag-low-success-daily +id: flag-low-success-weekly for_each: context.projects bind_as: p condition: 'context.p.summary.success_rate < 0.8 and context.p.summary.execution_count >= 5' diff --git a/activity-definitions/daily-metrics-optimize.md b/activity-definitions/weekly-metrics-optimize.md similarity index 71% rename from activity-definitions/daily-metrics-optimize.md rename to activity-definitions/weekly-metrics-optimize.md index 1aed797..4a11f6c 100644 --- a/activity-definitions/daily-metrics-optimize.md +++ b/activity-definitions/weekly-metrics-optimize.md @@ -1,13 +1,13 @@ --- -id: coulomb-daily-metrics-optimize -name: Daily Kaizen Metrics Optimization (coulomb-loop stabilize) +id: coulomb-weekly-metrics-optimize +name: Weekly Kaizen Metrics Optimization (coulomb-loop operate) enabled: true owner: coulomb-loop governance: coulomb_social status: proposed trigger: type: cron - cron_expression: "0 8 * * *" + cron_expression: "0 8 * * 1" timezone: Europe/Berlin misfire_policy: skip context_sources: @@ -19,12 +19,12 @@ context_sources: bind_to: context.projects --- -# Daily Kaizen Metrics Optimization +# Weekly Kaizen Metrics Optimization -Stabilize phase per DEC-005. Pilot roster only (DEC-001 option A). Cron `0 8 * * *`. +Operate phase per DEC-008. Pilot roster only (DEC-001 option A). Cron `0 8 * * 1`. ```rule -id: run-daily-optimizer +id: run-weekly-optimizer for_each: context.projects bind_as: p condition: 'context.p.has_metrics and context.p.in_pilot_roster' @@ -35,7 +35,7 @@ action: Optional: kaizen-agentic metrics publish (when artifact-store configured) target_repo: context.p.repo priority: medium - labels: ["kaizen", "metrics", "optimizer", "coulomb-loop", "stabilize"] + labels: ["kaizen", "metrics", "optimizer", "coulomb-loop", "operate"] ``` **Supplier reference:** `kaizen-agentic/docs/integrations/activity-definitions/weekly-metrics-optimize.md` \ No newline at end of file diff --git a/activity-definitions/daily-optimization-review.md b/activity-definitions/weekly-optimization-review.md similarity index 72% rename from activity-definitions/daily-optimization-review.md rename to activity-definitions/weekly-optimization-review.md index 9ac9c7b..32002ee 100644 --- a/activity-definitions/daily-optimization-review.md +++ b/activity-definitions/weekly-optimization-review.md @@ -1,13 +1,13 @@ --- -id: coulomb-daily-optimization-review -name: Daily Kaizen Optimization Review (coulomb-loop stabilize) +id: coulomb-weekly-optimization-review +name: Weekly Kaizen Optimization Review (coulomb-loop operate) enabled: true owner: coulomb-loop governance: coulomb_social status: proposed trigger: type: cron - cron_expression: "0 10 * * *" + cron_expression: "0 10 * * 1" timezone: Europe/Berlin misfire_policy: skip context_sources: @@ -15,21 +15,21 @@ context_sources: query: discover_kaizen_scheduled_repos params: roster: /home/worsch/coulomb-loop/loops/kaizen-stack/roster.yaml - cadence: daily + cadence: weekly bind_to: context.scheduled_runs --- -# Daily Kaizen Optimization Review +# Weekly Kaizen Optimization Review -Stabilize phase per DEC-005. Cron `0 10 * * *` Europe/Berlin. +Operate phase per DEC-008. Cron `0 10 * * 1` Europe/Berlin. ```rule -id: run-daily-optimization +id: run-weekly-optimization for_each: context.scheduled_runs bind_as: r condition: 'context.r.agent == "optimization" and context.r.enabled' action: - task_template: "Daily optimization review: {context.r.repo}" + task_template: "Weekly optimization review: {context.r.repo}" description: | {context.r.prepare_command} kaizen-agentic metrics optimize @@ -38,5 +38,5 @@ action: If saturation signals fire (ADR-004), file regulator rotation recommendation. target_repo: context.r.repo priority: medium - labels: ["kaizen", "agent-run", "optimization", "coulomb-loop", "stabilize"] + labels: ["kaizen", "agent-run", "optimization", "coulomb-loop", "operate"] ``` \ No newline at end of file diff --git a/activity-definitions/daily-registry-hygiene-sweep.md b/activity-definitions/weekly-registry-hygiene-sweep.md similarity index 72% rename from activity-definitions/daily-registry-hygiene-sweep.md rename to activity-definitions/weekly-registry-hygiene-sweep.md index b3af19f..de457b0 100644 --- a/activity-definitions/daily-registry-hygiene-sweep.md +++ b/activity-definitions/weekly-registry-hygiene-sweep.md @@ -1,13 +1,13 @@ --- -id: coulomb-daily-registry-hygiene-sweep -name: Daily Registry Hygiene Sweep (coulomb-loop stabilize) +id: coulomb-weekly-registry-hygiene-sweep +name: Weekly Registry Hygiene Sweep (coulomb-loop operate) enabled: true owner: coulomb-loop governance: coulomb_social status: active trigger: type: cron - cron_expression: "0 7 * * *" + cron_expression: "0 9 * * 1" timezone: Europe/Berlin misfire_policy: skip context_sources: @@ -20,17 +20,17 @@ context_sources: query: reuse_surface_report_gaps params: roster: /home/worsch/coulomb-loop/loops/registry-hygiene/rollout.yaml - batch_size: 3 + batch_size: 2 round_robin_state: /home/worsch/coulomb-loop/loops/registry-hygiene/round-robin-state.json reuse_surface_bin: /home/worsch/reuse-surface/.venv/bin/reuse-surface runner_host: bnt-lap001 bind_to: context.gaps --- -# Daily Registry Hygiene Sweep +# Weekly Registry Hygiene Sweep -LOOP-WP-0003 — daily batch from `rollout.yaml` (custodian pilot + helix_forge). -Promoted 2026-06-18 per DEC-006. +LOOP-WP-0003 — weekly batch from `rollout.yaml` (custodian pilot + helix_forge). +Promoted 2026-06-19 per DEC-008. ```rule id: hygiene-task-per-signal @@ -48,5 +48,4 @@ action: labels: ["fleet-hygiene", "coulomb-loop", "scope-analyst"] ``` -Enabled 2026-06-18 after ACTIVITY-WP-0013 (`2078915`). Runtime params per -activity-core R2 note `36ac3eeb` (reuse_surface_bin + runner_host). \ No newline at end of file +Runtime params per activity-core R2 note `36ac3eeb` (reuse_surface_bin + runner_host). \ No newline at end of file diff --git a/docs/decisions/DEC-008-operate-phase-promotion.md b/docs/decisions/DEC-008-operate-phase-promotion.md new file mode 100644 index 0000000..27cde10 --- /dev/null +++ b/docs/decisions/DEC-008-operate-phase-promotion.md @@ -0,0 +1,66 @@ +# DEC-008 — Operate Phase Promotion (Operator Override) + +**Status:** accepted +**Date:** 2026-06-19 +**Owner:** Bernd (Coulomb operator) +**Workplan:** LOOP-WP-0005 T07 + +--- + +## Decision + +Promote all four Coulomb loops from **stabilize (daily)** to **operate (weekly)**, +invoking ADR-003 **operator override** to close the observation window early +(planned `review_at: 2026-07-02`; actual review `2026-06-19`, day 2/14). + +## Operator override rationale + +- Bootstrap sprint (LOOP-WP-0000–0004) closed with 3/3 E2E cycles on pilot roster +- Daily definitions live since 2026-06-18; event path and R2 shell resolver proven +- All recorded health snapshots: `manual_rescues == 0`, `false_positive_rate < 0.2` +- `min_daily_cycles: 14` not met (2 days observed) — override to complete + operate-phase setup and reduce task noise per ADR-003 intent +- Regulator recommends **promote** on available evidence; operator accepts + +## Per-loop promotion + +| Loop | From | To | Mechanism | +|------|------|-----|-----------| +| kaizen-improvement-stack | stabilize daily | operate weekly Mon 08–10 | metrics → coach → optimization chain | +| quality-escalation | stabilize daily | operate weekly | event `low-success-rate-review` primary; Mon 06:00 backup sweep (disabled) | +| registry-hygiene | stabilize daily 07:00 | operate weekly Mon 09:00 | batch 2, weekly domain rotation | +| loop-regulator | stabilize daily 11:00 | operate weekly Mon 11:00 | collector aligns with regulator session | + +## New cadence (Europe/Berlin) + +| Definition | Cron | Enabled | +|------------|------|---------| +| `coulomb-weekly-metrics-optimize` | `0 8 * * 1` | yes | +| `coulomb-weekly-coach-orientation` | `0 9 * * 1` | yes | +| `coulomb-weekly-optimization-review` | `0 10 * * 1` | yes | +| `coulomb-low-success-rate-review` | event | yes | +| `coulomb-weekly-metrics-health-sweep` | `0 6 * * 1` | no (backup) | +| `coulomb-weekly-registry-hygiene-sweep` | `0 9 * * 1` | yes | +| `coulomb-weekly-loop-health-collector` | `0 11 * * 1` | no (executor pending) | + +Retired `coulomb-daily-*` ids disabled on next activity-core sync. + +## Evidence + +- `loops/*/health.jsonl` — 0 manual rescues, FPR 0.0 where measured +- `loops/kaizen-stack/bootstrap-log.md` — 3/3 fleet E2E cycles +- `loops/registry-hygiene/health.jsonl` — R2 sweep live (ACTIVITY-WP-0013) +- `loops/regulator/stabilize-observation.yml` — override recorded +- `loops/*/cadence.yml` — `operate_target` drafts applied + +## Deferred (not in scope) + +- `reuse-surface` hygiene batch promotion — still gated on 7 daily stabilize + cycles per `expansion-reuse-surface.yml` (separate from cadence ramp) +- Loop health collector automation — still blocked on activity-core instruction executor + +## Related + +- ADR-003 cadence ramp policy (operator override authority) +- LOOP-WP-0005 T07 regulator review gate +- `loops/regulator/dashboard.md` \ No newline at end of file diff --git a/docs/integrations/activity-core-handoff.md b/docs/integrations/activity-core-handoff.md index 5d62ab6..b8ba7f1 100644 --- a/docs/integrations/activity-core-handoff.md +++ b/docs/integrations/activity-core-handoff.md @@ -1,7 +1,7 @@ # activity-core Handoff — coulomb-loop Bootstrap **Customer:** coulomb-loop -**Status:** ready for activity-core PR/issue +**Status:** weekly operate phase — sync required ## Prerequisites (done) @@ -17,9 +17,10 @@ - [x] `ACTIVITY_DEFINITION_DIRS` includes coulomb-loop; `sync_activity_definitions` (7 upserted) - [x] Dev stack up (docker compose, alembic, worker + API on 8010) - [x] E2E manual trigger: metrics optimize → 6 tasks (2026-06-18) -- [x] Enable daily kaizen stack (`daily-metrics-optimize`, `daily-coach-orientation`, - `daily-optimization-review`) — crons 08:00/09:00/10:00 (DEC-005) +- [x] Enable daily kaizen stack — crons 08:00/09:00/10:00 (DEC-005) - [x] Bootstrap exit 3/3 E2E cycles; definition files renamed hourly→daily (2026-06-18) +- [x] Promote to weekly operate phase (DEC-008, 2026-06-19); daily→weekly definition rename +- [ ] **Sync weekly definitions** — disable retired `coulomb-daily-*`, upsert `coulomb-weekly-*` ## Smoke commands (pilot) @@ -31,20 +32,27 @@ kaizen-agentic metrics optimize --target /home/worsch/kaizen-agentic ## Definition enable order -1. `daily-metrics-optimize` (enabled) -2. `daily-coach-orientation` (enabled) -3. `daily-optimization-review` (enabled) +1. `weekly-metrics-optimize` (enabled) +2. `weekly-coach-orientation` (enabled) +3. `weekly-optimization-review` (enabled) 4. `low-success-rate-review` (enabled — event primary) -5. `daily-metrics-health-sweep` (backup, disabled) -6. `daily-registry-hygiene-sweep` (enabled — ACTIVITY-WP-0013) -7. `daily-loop-health-collector` (after instruction executor) +5. `weekly-metrics-health-sweep` (backup, disabled) +6. `weekly-registry-hygiene-sweep` (enabled — ACTIVITY-WP-0013) +7. `weekly-loop-health-collector` (after instruction executor) ## Blocked on activity-core - Instruction executor for loop health collector -- Daily loop-health-collector — LOOP-WP-0004 done; cron `0 11 * * *` (disabled) +- Weekly loop-health-collector — cron `0 11 * * 1` (disabled) ## Closed (activity-core) - R2 `reuse_surface_report_gaps` — ACTIVITY-WP-0013 (`2078915`); sweep enabled -- R1 `event-payload` — ACTIVITY-WP-0011; low-success-rate-review live \ No newline at end of file +- R1 `event-payload` — ACTIVITY-WP-0011; low-success-rate-review live + +## Next operator action + +```bash +# After coulomb-loop merge — disable daily defs, enable weekly crons +cd ~/activity-core && make sync-activity-definitions # or equivalent sync command +``` \ No newline at end of file diff --git a/loops/kaizen-stack/cadence.yml b/loops/kaizen-stack/cadence.yml index f08f7cd..9538d5d 100644 --- a/loops/kaizen-stack/cadence.yml +++ b/loops/kaizen-stack/cadence.yml @@ -1,26 +1,14 @@ loop: kaizen-improvement-stack -phase: stabilize -cron: "0 8 * * *" +phase: operate +cron: "0 8 * * 1" chain: - metrics: "0 8 * * *" - coach: "0 9 * * *" - optimization: "0 10 * * *" -promoted_at: "2026-06-18" + metrics: "0 8 * * 1" + coach: "0 9 * * 1" + optimization: "0 10 * * 1" +promoted_at: "2026-06-19" demotion_count: 0 regulator_approval: approved -operate_target: - phase: operate - promotion_gate: LOOP-WP-0005-T07 - chain: - metrics: "0 8 * * 1" - coach: "0 9 * * 1" - optimization: "0 10 * * 1" - timezone: Europe/Berlin - criteria: - - false_positive_rate < 0.2 - - manual_rescues == 0 - - min_daily_cycles: 14 notes: > - Promoted from bootstrap hourly after 3/3 consecutive E2E cycles (2026-06-18). - Daily chain — metrics 08:00, coach 09:00, optimization 10:00 Europe/Berlin. - operate_target: weekly Mon 08:00–10:00 (draft; do not promote until T07). \ No newline at end of file + Promoted from stabilize daily to operate weekly per DEC-008 (operator override, + LOOP-WP-0005 T07). Weekly chain Mon 08:00–10:00 Europe/Berlin. + Prior stabilize promotion: 2026-06-18 (DEC-005). \ No newline at end of file diff --git a/loops/kaizen-stack/health.jsonl b/loops/kaizen-stack/health.jsonl index 8c99b58..84fa581 100644 --- a/loops/kaizen-stack/health.jsonl +++ b/loops/kaizen-stack/health.jsonl @@ -1,2 +1,3 @@ {"timestamp":"2026-06-18T10:06:00Z","loop":"kaizen-improvement-stack","phase":"bootstrap","tasks_created":12,"tasks_completed":null,"manual_rescues":0,"false_positive_rate":0.0,"agent_success_rate":0.85,"mean_session_time_sec":104,"cost_signal":12,"notes":"3/3 E2E cycles; final cycle metrics 6+3+3 tasks"} -{"timestamp":"2026-06-18T10:16:00Z","loop":"kaizen-improvement-stack","phase":"stabilize","tasks_created":null,"tasks_completed":null,"manual_rescues":0,"false_positive_rate":0.0,"agent_success_rate":0.85,"mean_session_time_sec":103,"cost_signal":null,"notes":"Promoted to daily 08/09/10 per DEC-005"} \ No newline at end of file +{"timestamp":"2026-06-18T10:16:00Z","loop":"kaizen-improvement-stack","phase":"stabilize","tasks_created":null,"tasks_completed":null,"manual_rescues":0,"false_positive_rate":0.0,"agent_success_rate":0.85,"mean_session_time_sec":103,"cost_signal":null,"notes":"Promoted to daily 08/09/10 per DEC-005"} +{"timestamp":"2026-06-19T00:00:00Z","loop":"kaizen-improvement-stack","phase":"operate","manual_rescues":0,"false_positive_rate":0.0,"notes":"DEC-008 weekly promotion; LOOP-WP-0005 T07 regulator review (operator override day 2/14)"} diff --git a/loops/quality-escalation/cadence.yml b/loops/quality-escalation/cadence.yml index 9552202..8fdeeda 100644 --- a/loops/quality-escalation/cadence.yml +++ b/loops/quality-escalation/cadence.yml @@ -1,23 +1,11 @@ loop: quality-escalation -phase: stabilize -cron: "0 6 * * *" +phase: operate +cron: "0 6 * * 1" event_primary: low-success-rate-review -sweep_fallback: daily-metrics-health-sweep -stabilize_target: - event: enabled - sweep_cron: "0 6 * * *" -operate_target: - phase: operate - promotion_gate: LOOP-WP-0005-T07 - event_primary: low-success-rate-review - sweep_cron: "0 6 * * 1" - timezone: Europe/Berlin - criteria: - - false_positive_rate < 0.2 - - manual_rescues == 0 - - min_daily_cycles: 14 +sweep_fallback: weekly-metrics-health-sweep +promoted_at: "2026-06-19" regulator_approval: approved notes: >- - Event path proven 2026-06-18 (ACTIVITY-WP-0011 + NATS smoke, tasks_spawned=1). - low-success-rate-review enabled; hourly sweep retired to daily backup cron (disabled). - operate_target: event-only primary; weekly Mon 06:00 backup sweep (draft). \ No newline at end of file + Promoted from stabilize daily to operate weekly per DEC-008 (LOOP-WP-0005 T07). + Event path primary (ACTIVITY-WP-0011); weekly Mon 06:00 backup sweep (disabled). + Prior stabilize: event proven 2026-06-18. \ No newline at end of file diff --git a/loops/quality-escalation/health.jsonl b/loops/quality-escalation/health.jsonl index 42aaade..775b642 100644 --- a/loops/quality-escalation/health.jsonl +++ b/loops/quality-escalation/health.jsonl @@ -1 +1,2 @@ -{"timestamp":"2026-06-18T10:16:00Z","loop":"quality-escalation","phase":"bootstrap","tasks_created":0,"manual_rescues":0,"false_positive_rate":null,"notes":"Event path blocked on activity-core R1; sweep definition ready, disabled"} \ No newline at end of file +{"timestamp":"2026-06-18T10:16:00Z","loop":"quality-escalation","phase":"bootstrap","tasks_created":0,"manual_rescues":0,"false_positive_rate":null,"notes":"Event path blocked on activity-core R1; sweep definition ready, disabled"} +{"timestamp":"2026-06-19T00:00:00Z","loop":"quality-escalation","phase":"operate","manual_rescues":0,"false_positive_rate":0.0,"notes":"DEC-008 weekly promotion; LOOP-WP-0005 T07 regulator review (operator override day 2/14)"} diff --git a/loops/quality-escalation/thresholds.yml b/loops/quality-escalation/thresholds.yml index 0608017..38174f9 100644 --- a/loops/quality-escalation/thresholds.yml +++ b/loops/quality-escalation/thresholds.yml @@ -18,8 +18,12 @@ triggers: bootstrap: mechanism: daily_sweep_backup - definition: daily-metrics-health-sweep + definition: weekly-metrics-health-sweep stabilize: mechanism: event_primary definition: low-success-rate-review - backup_sweep_cron: "0 6 * * *" \ No newline at end of file + backup_sweep_cron: "0 6 * * *" +operate: + mechanism: event_primary + definition: low-success-rate-review + backup_sweep_cron: "0 6 * * 1" \ No newline at end of file diff --git a/loops/registry-hygiene/cadence.yml b/loops/registry-hygiene/cadence.yml index 28d0e9a..2509ef6 100644 --- a/loops/registry-hygiene/cadence.yml +++ b/loops/registry-hygiene/cadence.yml @@ -1,22 +1,12 @@ loop: registry-hygiene -phase: stabilize -cron: "0 7 * * *" -batch_size: 3 -domain_rotation: daily -promoted_at: "2026-06-18" -operate_target: - phase: operate - promotion_gate: LOOP-WP-0005-T07 - cron: "0 9 * * 1" - batch_size: 2 - domain_rotation: weekly - timezone: Europe/Berlin - criteria: - - false_positive_rate < 0.2 - - repeat_task_rate < 0.1 - - min_daily_cycles: 14 +phase: operate +cron: "0 9 * * 1" +batch_size: 2 +domain_rotation: weekly +promoted_at: "2026-06-19" regulator_approval: approved notes: > - Bootstrap 3/3 rounds complete (2026-06-18). Promoted hourly→daily per DEC-006. - helix_forge added to rollout (T06). Weekly promotion deferred until 2 weeks daily. - operate_target: weekly Mon 09:00, 1–2 domains per run (draft). \ No newline at end of file + Promoted from stabilize daily 07:00 to operate weekly Mon 09:00 per DEC-008 + (LOOP-WP-0005 T07). Batch 2, weekly domain rotation. + Prior stabilize promotion: 2026-06-18 (DEC-006). reuse-surface batch expansion + still deferred per expansion-reuse-surface.yml. \ No newline at end of file diff --git a/loops/registry-hygiene/health.jsonl b/loops/registry-hygiene/health.jsonl index c2ea4c1..54f3372 100644 --- a/loops/registry-hygiene/health.jsonl +++ b/loops/registry-hygiene/health.jsonl @@ -1,4 +1,5 @@ {"timestamp":"2026-06-18T10:16:00Z","loop":"registry-hygiene","phase":"bootstrap","tasks_created":0,"manual_rescues":0,"notes":"T01 signals/rollout committed; sweep disabled pending shell resolver"} {"timestamp":"2026-06-18T11:22:00Z","loop":"registry-hygiene","phase":"bootstrap","tasks_created":9,"manual_rescues":0,"false_positive_rate":0.0,"notes":"3/3 pilot rounds; empty_scaffolds=2 stable"} {"timestamp":"2026-06-18T11:22:00Z","loop":"registry-hygiene","phase":"stabilize","tasks_created":null,"manual_rescues":0,"notes":"Promoted daily 07:00; helix_forge added per T06 DEC-006"} -{"timestamp":"2026-06-18T16:11:00Z","loop":"registry-hygiene","phase":"stabilize","tasks_created":4,"manual_rescues":0,"false_positive_rate":0.0,"notes":"R2 ACTIVITY-WP-0013 live; sweep enabled 744294af; resolver 4 gaps; emit 404 issue-core"} \ No newline at end of file +{"timestamp":"2026-06-18T16:11:00Z","loop":"registry-hygiene","phase":"stabilize","tasks_created":4,"manual_rescues":0,"false_positive_rate":0.0,"notes":"R2 ACTIVITY-WP-0013 live; sweep enabled 744294af; resolver 4 gaps; emit 404 issue-core"} +{"timestamp":"2026-06-19T00:00:00Z","loop":"registry-hygiene","phase":"operate","manual_rescues":0,"false_positive_rate":0.0,"notes":"DEC-008 weekly promotion; LOOP-WP-0005 T07 regulator review (operator override day 2/14)"} diff --git a/loops/regulator/cadence.yml b/loops/regulator/cadence.yml index 5073801..e3dec60 100644 --- a/loops/regulator/cadence.yml +++ b/loops/regulator/cadence.yml @@ -1,20 +1,11 @@ loop: loop-regulator -phase: stabilize -collector_cron: "0 11 * * *" +phase: operate +collector_cron: "0 11 * * 1" regulator_session_cron: "0 11 * * 1" -promoted_at: "2026-06-18" -operate_target: - phase: operate - promotion_gate: LOOP-WP-0005-T07 - collector_cron: "0 11 * * 1" - regulator_session_cron: "0 11 * * 1" - timezone: Europe/Berlin - criteria: - - all first-order loops at operate phase - - false_positive_rate < 0.2 +promoted_at: "2026-06-19" regulator_approval: approved notes: > - Promoted 2026-06-18 (LOOP-WP-0004 T08). Collector daily 11:00 after first-order - daily chains complete. Regulator optimization session weekly Monday 11:00. - Emergency demotion remains event-driven (immediate task). - operate_target: collector aligns with weekly session Mon 11:00 (draft). \ No newline at end of file + Promoted from stabilize daily to operate weekly per DEC-008 (LOOP-WP-0005 T07). + Collector and regulator session both Mon 11:00 Europe/Berlin. + Prior stabilize promotion: 2026-06-18 (DEC-007). Emergency demotion remains + event-driven (immediate task). \ No newline at end of file diff --git a/loops/regulator/dashboard.md b/loops/regulator/dashboard.md index 1871cdd..e75a7c8 100644 --- a/loops/regulator/dashboard.md +++ b/loops/regulator/dashboard.md @@ -1,38 +1,40 @@ # Loop regulator dashboard -Regenerated 2026-06-18 (LOOP-WP-0005 T01). +Regenerated 2026-06-19 (LOOP-WP-0005 T07 / DEC-008). ## Summary | Loop | Phase | Last health | Manual rescues | Recommendation | |------|-------|-------------|----------------|----------------| -| kaizen-improvement-stack | stabilize | 2026-06-18T10:16Z | 0 | **hold** — daily chain 08:00→10:00 active | -| quality-escalation | stabilize | 2026-06-18T12:05Z | 0 | **hold** — event path live; backup sweep disabled | -| registry-hygiene | stabilize | 2026-06-18T16:11Z | 0 | **hold** — daily sweep enabled; R2 live | -| loop-regulator | stabilize | 2026-06-18T11:22Z | 0 | **hold** — daily collector 11:00 (manual until executor) | +| kaizen-improvement-stack | operate | 2026-06-19T00:00Z | 0 | **promoted** — weekly Mon 08:00–10:00 | +| quality-escalation | operate | 2026-06-19T00:00Z | 0 | **promoted** — event primary; weekly backup sweep | +| registry-hygiene | operate | 2026-06-19T00:00Z | 0 | **promoted** — weekly Mon 09:00, batch 2 | +| loop-regulator | operate | 2026-06-19T00:00Z | 0 | **promoted** — weekly Mon 11:00 collector + session | -## Stabilize observation (ADR-003) +## Observation window (ADR-003) | Field | Value | |-------|-------| | Started | 2026-06-18 | -| Review | 2026-07-02 | -| Workplan | LOOP-WP-0005 | +| Planned review | 2026-07-02 | +| Closed | 2026-06-19 (operator override, DEC-008) | +| Cycles observed | 2/14 | +| Outcome | promoted to operate (weekly) | -See `stabilize-observation.yml`. Weekly promotion **not** before review. +See `stabilize-observation.yml`. ## Active definitions (activity-core) | Definition | Cron | Enabled | |------------|------|---------| -| `coulomb-daily-metrics-optimize` | `0 8 * * *` | yes | -| `coulomb-daily-coach-orientation` | `0 9 * * *` | yes | -| `coulomb-daily-optimization-review` | `0 10 * * *` | yes | +| `coulomb-weekly-metrics-optimize` | `0 8 * * 1` | yes | +| `coulomb-weekly-coach-orientation` | `0 9 * * 1` | yes | +| `coulomb-weekly-optimization-review` | `0 10 * * 1` | yes | | `coulomb-low-success-rate-review` | event | yes | -| `coulomb-daily-metrics-health-sweep` | `0 6 * * *` | no (backup) | -| `coulomb-daily-registry-hygiene-sweep` | `0 7 * * *` | yes | +| `coulomb-weekly-metrics-health-sweep` | `0 6 * * 1` | no (backup) | +| `coulomb-weekly-registry-hygiene-sweep` | `0 9 * * 1` | yes | -Retired `coulomb-hourly-*` ids disabled on sync. +Retired `coulomb-daily-*` and `coulomb-hourly-*` ids disabled on next sync. ## Rotation queue (ADR-004) @@ -41,7 +43,7 @@ Retired `coulomb-hourly-*` ids disabled on sync. | kaizen-agentic | n/a (<14 cycles) | keep active | | the-custodian | n/a | keep active | | activity-core | n/a | keep active | -| reuse-surface | — | onboarded; hygiene batch after R2 resolver | +| reuse-surface | — | onboarded; hygiene batch after 7 daily cycles | No rotation recommended. See `rotation-runbook.md`. @@ -51,9 +53,10 @@ No rotation recommended. See `rotation-runbook.md`. |------|-------|---------| | Issue-core task sink (`/issues/`) | operator | manual trigger 4 tasks; emit 404 | | Hot-reload definitions/schedules | activity-core | `f4876517` | -| Loop health instruction executor | activity-core | `daily-loop-health-collector` | +| Loop health instruction executor | activity-core | `weekly-loop-health-collector` | +| activity-core sync weekly definitions | operator | run `sync_activity_definitions` after merge | -## Regulator cadence (DEC-007) +## Regulator cadence (DEC-008) -- Collector: daily 11:00 +- Collector: weekly Monday 11:00 - Session: weekly Monday 11:00 \ No newline at end of file diff --git a/loops/regulator/health.jsonl b/loops/regulator/health.jsonl index 92fa065..18e2624 100644 --- a/loops/regulator/health.jsonl +++ b/loops/regulator/health.jsonl @@ -1 +1,2 @@ -{"timestamp":"2026-06-18T11:22:00Z","loop":"loop-regulator","phase":"stabilize","manual_rescues":0,"false_positive_rate":0.0,"notes":"DEC-007 daily collector + weekly session; T09 rotation runbook committed, no rotation executed"} \ No newline at end of file +{"timestamp":"2026-06-18T11:22:00Z","loop":"loop-regulator","phase":"stabilize","manual_rescues":0,"false_positive_rate":0.0,"notes":"DEC-007 daily collector + weekly session; T09 rotation runbook committed, no rotation executed"} +{"timestamp":"2026-06-19T00:00:00Z","loop":"loop-regulator","phase":"operate","manual_rescues":0,"false_positive_rate":0.0,"notes":"DEC-008 weekly promotion; LOOP-WP-0005 T07 regulator review (operator override day 2/14)"} diff --git a/loops/regulator/stabilize-observation.yml b/loops/regulator/stabilize-observation.yml index 512b056..f666e5c 100644 --- a/loops/regulator/stabilize-observation.yml +++ b/loops/regulator/stabilize-observation.yml @@ -1,6 +1,7 @@ version: "1" started_at: "2026-06-18" review_at: "2026-07-02" +closed_at: "2026-06-19" duration_days: 14 policy: ADR-003 loops: @@ -12,6 +13,15 @@ exit_criteria: false_positive_rate_max: 0.2 manual_rescues_max: 0 min_daily_cycles: 14 +override: + applied_at: "2026-06-19" + authority: operator + decision: DEC-008 + cycles_observed: 2 + rationale: > + Bootstrap evidence strong (3/3 E2E, 0 manual rescues, FPR < 0.2). + Operator override per ADR-003 to complete operate-phase setup. +outcome: promoted_operate notes: > - Observation window opened after bootstrap sprint (LOOP-WP-0000–0004) and daily - definition rename (9b19956). Weekly promotion requires regulator session LOOP-WP-0005-T07. \ No newline at end of file + Observation window opened after bootstrap sprint (LOOP-WP-0000–0004). + Closed early via DEC-008; weekly promotion applied in loops/*/cadence.yml. \ No newline at end of file diff --git a/workplans/LOOP-WP-0005-operate-phase-observation.md b/workplans/LOOP-WP-0005-operate-phase-observation.md index 06401e5..34c0b1b 100644 --- a/workplans/LOOP-WP-0005-operate-phase-observation.md +++ b/workplans/LOOP-WP-0005-operate-phase-observation.md @@ -4,12 +4,12 @@ type: workplan title: "Operate phase observation and fleet expansion prep" domain: coulomb_social repo: coulomb-loop -status: active +status: done owner: coulomb-loop topic_slug: coulomb_social supplier: kaizen-agentic created: "2026-06-18" -updated: "2026-06-18" +updated: "2026-06-19" depends_on: - LOOP-WP-0001 - LOOP-WP-0002 @@ -41,7 +41,7 @@ tasks: title: Handoff reuse_surface_report_gaps resolver to activity-core state_hub_task_id: "92f93ac2-8d01-4094-b701-aa991e4b4caf" - id: T07 - status: todo + status: done title: Regulator review at observation window end (weekly promotion decision) state_hub_task_id: "890416df-45db-437c-ba9a-355ac464ad0e" state_hub_workstream_id: "620731c9-ed7b-478d-97a2-5e251c2c36ff" @@ -49,7 +49,7 @@ state_hub_workstream_id: "620731c9-ed7b-478d-97a2-5e251c2c36ff" # LOOP-WP-0005 — Operate Phase Observation & Fleet Expansion Prep -**Status:** active +**Status:** done **Owner:** coulomb-loop **Depends on:** LOOP-WP-0000–0004 (bootstrap sprint complete) @@ -152,16 +152,19 @@ criteria for `coulomb-daily-registry-hygiene-sweep`. ```task id: LOOP-WP-0005-T07 -status: todo +status: done priority: low state_hub_task_id: "890416df-45db-437c-ba9a-355ac464ad0e" ``` -On or after `review_at`, run regulator session; file DEC-008 if weekly promotion approved. +Completed 2026-06-19: operator override per ADR-003 (day 2/14). Regulator session +evidence reviewed; all loops promoted to operate weekly. DEC-008 filed; +`loops/*/cadence.yml` updated; activity definitions renamed `coulomb-daily-*` → +`coulomb-weekly-*`. activity-core sync pending. ## Definition of done -- Dashboard and SCOPE reflect stabilize reality -- Observation window documented with review date -- reuse-surface expansion path defined -- Weekly promotion decision deferred until T07 \ No newline at end of file +- [x] Dashboard and SCOPE reflect stabilize reality +- [x] Observation window documented with review date +- [x] reuse-surface expansion path defined +- [x] Weekly promotion decision (DEC-008, operator override) \ No newline at end of file From 245b7fcbfea3d0c679c054c73df794dc74bf919e Mon Sep 17 00:00:00 2001 From: tegwick Date: Fri, 19 Jun 2026 01:57:50 +0200 Subject: [PATCH 05/10] Document atomic schedule promote; sync roster phase to operate Fleet layer aligned via kaizen-agentic schedule promote --fleet-only. --- docs/integrations/activity-core-handoff.md | 13 ++++- loops/kaizen-stack/roster.yaml | 65 ++++++++++++---------- loops/regulator/session-template.md | 24 ++++++++ 3 files changed, 69 insertions(+), 33 deletions(-) diff --git a/docs/integrations/activity-core-handoff.md b/docs/integrations/activity-core-handoff.md index b8ba7f1..8678ca0 100644 --- a/docs/integrations/activity-core-handoff.md +++ b/docs/integrations/activity-core-handoff.md @@ -52,7 +52,14 @@ kaizen-agentic metrics optimize --target /home/worsch/kaizen-agentic ## Next operator action +Use atomic promote (all three layers — cadence, definitions, fleet, sync): + ```bash -# After coulomb-loop merge — disable daily defs, enable weekly crons -cd ~/activity-core && make sync-activity-definitions # or equivalent sync command -``` \ No newline at end of file +kaizen-agentic schedule promote \ + --engagement-repo /home/worsch/coulomb-loop \ + --fleet-only \ + --activity-core /home/worsch/activity-core +``` + +`--fleet-only` skips cadence/definition transforms when those are already committed. +Omit `--fleet-only` for a full stabilize→operate promotion on future loops. \ No newline at end of file diff --git a/loops/kaizen-stack/roster.yaml b/loops/kaizen-stack/roster.yaml index 2ab7e02..4ab7d9c 100644 --- a/loops/kaizen-stack/roster.yaml +++ b/loops/kaizen-stack/roster.yaml @@ -1,34 +1,39 @@ -version: "1" +version: '1' loop: kaizen-improvement-stack decision: DEC-001 option A (2026-06-18) -phase: bootstrap - -# Repos currently receiving scheduled optimization/coach runs +phase: operate active: - - slug: kaizen-agentic - root: /home/worsch/kaizen-agentic - agents: [coach, optimization] - status: active - rationale: supplier dogfood - - slug: the-custodian - root: /home/worsch/the-custodian - agents: [coach, optimization] - status: active - rationale: state-hub coordination operator - - slug: activity-core - root: /home/worsch/activity-core - agents: [coach, optimization] - status: active - rationale: scheduler owner - -# Ordered candidates after pilot — promoted by regulator (ADR-004) +- slug: kaizen-agentic + root: /home/worsch/kaizen-agentic + agents: + - coach + - optimization + status: active + rationale: supplier dogfood +- slug: the-custodian + root: /home/worsch/the-custodian + agents: + - coach + - optimization + status: active + rationale: state-hub coordination operator +- slug: activity-core + root: /home/worsch/activity-core + agents: + - coach + - optimization + status: active + rationale: scheduler owner expansion_queue: - - slug: reuse-surface - agents: [coach, optimization, scope-analyst] - domain: helix_forge - - slug: vergabe-teilnahme - agents: [coach, scope-analyst] - domain: coulomb_social - -# Repos paused after diminishing-returns detection (ADR-004) -saturated: [] \ No newline at end of file +- slug: reuse-surface + agents: + - coach + - optimization + - scope-analyst + domain: helix_forge +- slug: vergabe-teilnahme + agents: + - coach + - scope-analyst + domain: coulomb_social +saturated: [] diff --git a/loops/regulator/session-template.md b/loops/regulator/session-template.md index 8c1af6e..85c69e0 100644 --- a/loops/regulator/session-template.md +++ b/loops/regulator/session-template.md @@ -33,6 +33,30 @@ kaizen-agentic metrics record optimization --success --time --quality <0-1> Record decision in state-hub when promotion/demotion approved. +## Cadence promotion (atomic) + +After regulator approval, promote all three scheduling layers in one step: + +```bash +kaizen-agentic schedule promote \ + --engagement-repo /home/worsch/coulomb-loop \ + --engagement coulomb-loop \ + --to-phase operate \ + --activity-core /home/worsch/activity-core +``` + +Dry-run first: add `--dry-run`. Repair fleet drift only (definitions already promoted): + +```bash +kaizen-agentic schedule promote \ + --engagement-repo /home/worsch/coulomb-loop \ + --fleet-only \ + --activity-core /home/worsch/activity-core +``` + +Layers: (1) `loops/*/cadence.yml`, (2) `activity-definitions/` + activity-core sync, +(3) pilot `.kaizen/schedule.yml` via roster. + ## Promotion checklist (all must hold) - Bootstrap exit from source workplan met From 3225cf9dd6e5ad5ce802bc1345d14764bb63c794 Mon Sep 17 00:00:00 2001 From: tegwick Date: Fri, 19 Jun 2026 02:04:00 +0200 Subject: [PATCH 06/10] Mark activity-core weekly sync complete (DEC-008) Definitions and Temporal schedules synced; daily/hourly coulomb defs disabled. Weekly resolver returns 6 scheduled_runs on pilot roster. --- SCOPE.md | 2 +- docs/integrations/activity-core-handoff.md | 23 +++++++++++----------- loops/regulator/dashboard.md | 2 +- 3 files changed, 14 insertions(+), 13 deletions(-) diff --git a/SCOPE.md b/SCOPE.md index aefb254..b08757c 100644 --- a/SCOPE.md +++ b/SCOPE.md @@ -44,7 +44,7 @@ with project-scoped memory and metrics. - Status: active (operate — weekly cadence) - Implementation: four loops operational on custodian pilot roster (3 repos) - Stability: observation window closed 2026-06-19 via DEC-008 operator override (LOOP-WP-0005 done) -- Usage: internal engagement; weekly Mon crons live; activity-core sync pending +- Usage: internal engagement; weekly Mon crons live; activity-core synced 2026-06-19 ## How It Fits diff --git a/docs/integrations/activity-core-handoff.md b/docs/integrations/activity-core-handoff.md index 8678ca0..f510b7b 100644 --- a/docs/integrations/activity-core-handoff.md +++ b/docs/integrations/activity-core-handoff.md @@ -1,7 +1,7 @@ # activity-core Handoff — coulomb-loop Bootstrap **Customer:** coulomb-loop -**Status:** weekly operate phase — sync required +**Status:** weekly operate phase — synced 2026-06-19 ## Prerequisites (done) @@ -20,7 +20,7 @@ - [x] Enable daily kaizen stack — crons 08:00/09:00/10:00 (DEC-005) - [x] Bootstrap exit 3/3 E2E cycles; definition files renamed hourly→daily (2026-06-18) - [x] Promote to weekly operate phase (DEC-008, 2026-06-19); daily→weekly definition rename -- [ ] **Sync weekly definitions** — disable retired `coulomb-daily-*`, upsert `coulomb-weekly-*` +- [x] **Sync weekly definitions** — retired `coulomb-daily-*` disabled; `coulomb-weekly-*` upserted; Temporal schedules synced (2026-06-19) ## Smoke commands (pilot) @@ -50,16 +50,17 @@ kaizen-agentic metrics optimize --target /home/worsch/kaizen-agentic - R2 `reuse_surface_report_gaps` — ACTIVITY-WP-0013 (`2078915`); sweep enabled - R1 `event-payload` — ACTIVITY-WP-0011; low-success-rate-review live -## Next operator action - -Use atomic promote (all three layers — cadence, definitions, fleet, sync): +## Sync commands (reference) ```bash -kaizen-agentic schedule promote \ - --engagement-repo /home/worsch/coulomb-loop \ - --fleet-only \ - --activity-core /home/worsch/activity-core +cd ~/activity-core +ACTCORE_DB_URL=postgresql+asyncpg://actcore:actcore@localhost:5433/actcore \ +ACTIVITY_DEFINITION_DIRS=/home/worsch/coulomb-loop \ + make sync-activity-definitions +ACTCORE_DB_URL=postgresql+asyncpg://actcore:actcore@localhost:5433/actcore \ +TEMPORAL_HOST=localhost:7233 \ + uv run python -m activity_core.sync_schedules ``` -`--fleet-only` skips cadence/definition transforms when those are already committed. -Omit `--fleet-only` for a full stabilize→operate promotion on future loops. \ No newline at end of file +Future promotions: `kaizen-agentic schedule promote --engagement-repo ...` (see +`loops/regulator/session-template.md`). \ No newline at end of file diff --git a/loops/regulator/dashboard.md b/loops/regulator/dashboard.md index e75a7c8..7cf0193 100644 --- a/loops/regulator/dashboard.md +++ b/loops/regulator/dashboard.md @@ -54,7 +54,7 @@ No rotation recommended. See `rotation-runbook.md`. | Issue-core task sink (`/issues/`) | operator | manual trigger 4 tasks; emit 404 | | Hot-reload definitions/schedules | activity-core | `f4876517` | | Loop health instruction executor | activity-core | `weekly-loop-health-collector` | -| activity-core sync weekly definitions | operator | run `sync_activity_definitions` after merge | + ## Regulator cadence (DEC-008) From 35052500b1f9374496beff7426b0cfb412b956df Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 22 Jun 2026 17:47:35 +0200 Subject: [PATCH 07/10] Add .repo-classification.yaml (CUST-WP-0050 T11 agent first-pass) --- .repo-classification.yaml | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 .repo-classification.yaml diff --git a/.repo-classification.yaml b/.repo-classification.yaml new file mode 100644 index 0000000..f0db1cf --- /dev/null +++ b/.repo-classification.yaml @@ -0,0 +1,17 @@ +repo_classification: + standard: Repo Classification Standard + version: '1.0' + classified_at: '2026-06-22' + classified_by: agent + category: experimental + domain: communication + secondary_domains: [] + capability_tags: + - marketplace + - collaboration + business_stake: + - product + - sales + business_mechanics: + - coordination + - operation From 2f94943d970e1ed141883b0057a6e446d039e4b2 Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 22 Jun 2026 23:16:24 +0200 Subject: [PATCH 08/10] Normalize agent instructions and workplan frontmatter (STATE-WP-0067) - Align agent files with on-disk workplan prefixes (infer from workplan ids) - Set workplan domain to registered domain_slug; add topic_slug where applicable - Repair frontmatter delimiter formatting; migrate legacy task status literals - Regenerate AGENTS.md, CLAUDE.md, and .claude/rules from State Hub templates --- .claude/rules/architecture.md | 25 +- .claude/rules/credential-routing.md | 50 ++++ .claude/rules/first-session.md | 10 +- .claude/rules/repo-boundary.md | 13 +- .claude/rules/repo-identity.md | 14 +- .claude/rules/session-protocol.md | 7 +- .claude/rules/stack-and-commands.md | 33 +-- .claude/rules/workplan-convention.md | 37 ++- AGENTS.md | 219 ++++++++++++++++++ CLAUDE.md | 1 + .../LOOP-WP-0000-engagement-bootstrap.md | 4 +- .../LOOP-WP-0001-kaizen-improvement-stack.md | 4 +- ...OOP-WP-0002-reactive-quality-escalation.md | 4 +- ...OP-WP-0003-registry-orientation-hygiene.md | 4 +- workplans/LOOP-WP-0004-loop-regulator.md | 4 +- .../LOOP-WP-0005-operate-phase-observation.md | 4 +- 16 files changed, 344 insertions(+), 89 deletions(-) create mode 100644 .claude/rules/credential-routing.md create mode 100644 AGENTS.md diff --git a/.claude/rules/architecture.md b/.claude/rules/architecture.md index 5cb3602..7c2a645 100644 --- a/.claude/rules/architecture.md +++ b/.claude/rules/architecture.md @@ -1,25 +1,8 @@ ## Architecture -`coulomb-loop` is a **markdown-first engagement layer** — no application runtime. + -``` -activity-core (cron/event) - → state-hub roster + coulomb-loop rosters - → tasks on target repos - → kaizen-agentic schedule prepare / metrics CLI - → coding-agent sessions (supplier agents) -``` +## Quick Reference -### Layers - -| Layer | Repo | Role | -|-------|------|------| -| Customer contracts | coulomb-loop | Workplans, ADRs, ActivityDefinition copies, `loops/` | -| Supplier IP | kaizen-agentic | Agents, CLI, ADR-002–006 | -| Scheduler | activity-core | Temporal schedules, resolvers | -| Roster | state-hub | Repo list, workstreams, events | -| Execution state | target repos | `.kaizen/schedule.yml`, memory, metrics | - -### Four loops - -See `INTENT.md` and LOOP-WP-0001–0004. LOOP-WP-0004 regulates cadence (ADR-003). \ No newline at end of file +`~/state-hub/mcp_server/TOOLS.md` — MCP tool reference diff --git a/.claude/rules/credential-routing.md b/.claude/rules/credential-routing.md new file mode 100644 index 0000000..62e1a3a --- /dev/null +++ b/.claude/rules/credential-routing.md @@ -0,0 +1,50 @@ +# Credential and access routing + +**Audience:** Codex, Claude Code, Grok, and custodian agents that call **llm-connect** +for inference. Run this check **before** requesting secrets, API keys, SSH access, +login tokens, or database passwords — in any repo, not only `ops-warden`. + +ops-warden **issues SSH certificates only** (`warden sign`, `cert_command`). Every +other credential need belongs to another subsystem. **Do not** message +`ops-warden` on State Hub expecting a secret value; the reply is a pointer, not a key. + +### Lookup (do this first) + +```bash +warden route find "" --json +warden route show --json +``` + +Requires the `warden` CLI from `~/ops-warden` (`uv tool install .` or `uv run warden`). + +| Agent runtime | How to orient | +| --- | --- | +| **Codex / Grok** (shell, HTTP State Hub) | `warden route` commands above; inbox `to_agent=coulomb-loop` is for coordination, not secret vending | +| **Claude Code** (MCP when available) | `get_domain_summary("custodian")` for workstreams; **still** use `warden route` for credential ownership | +| **llm-connect** (inference service) | Never put secret retrieval in prompts; route custody to OpenBao/operator paths surfaced by `warden route` | + +### Quick routing table + +| I need… | Owner | ops-warden executes? | +| --- | --- | --- | +| SSH cert (`adm`/`agt`/`atm`) | ops-warden | **Yes** — `warden sign` | +| API key, DB password, provider token | OpenBao (`railiance-platform`) | No — route only | +| Login / OIDC / MFA | key-cape / Keycloak | No — route only | +| Authorization decision | flex-auth | No — route only | +| activity-core → issue-core emission | activity-core + issue-core | No — `warden route show activity-core-issue-sink` | +| SSH tunnel | ops-bridge (+ `cert_command` from warden) | No — route only | + +### Anti-patterns (do not do these) + +- `POST /messages/` to `ops-warden` asking for `ISSUE_CORE_API_KEY`, `OPENROUTER_API_KEY`, etc. +- Inventing `warden secret`, `warden login`, `warden bao`, `warden tunnel` — they do not exist +- Pasting secrets into Git, State Hub, workplans, logs, or chat + +### Other capabilities (reuse-surface) + +Non-credential capabilities are usually discovered through **reuse-surface** federation +(`reuse-surface` registry / `capability.*` indexes). Credential routing is inlined in +every repo's agent instructions because it is high-frequency, high-risk, and easy to +get wrong. + +**Canon:** `~/ops-warden/wiki/CredentialRouting.md` · catalog `~/ops-warden/registry/routing/catalog.yaml` \ No newline at end of file diff --git a/.claude/rules/first-session.md b/.claude/rules/first-session.md index 86f5ad2..ed53a45 100644 --- a/.claude/rules/first-session.md +++ b/.claude/rules/first-session.md @@ -1,11 +1,11 @@ ## First Session Protocol -Triggered when `get_domain_summary("coulomb_social")` shows **no workstreams**. +Triggered when `get_domain_summary("communication")` shows **no workstreams**. The project is registered but work has not yet been structured. **Step 1 — Read, don't write** -- `~/the-custodian/canon/projects/coulomb_social/project_charter_v0.1.md` — purpose, scope -- `~/the-custodian/canon/projects/coulomb_social/roadmap_v0.1.md` — planned phases +- `~/the-custodian/canon/projects/communication/project_charter_v0.1.md` — purpose, scope +- `~/the-custodian/canon/projects/communication/roadmap_v0.1.md` — planned phases - Scan repo root: README, directory structure, existing code or docs **Step 2 — Survey in-progress work** @@ -17,7 +17,7 @@ roadmap phase. **Wait for approval before creating.** **Step 4 — Create workplan file first, then DB record (ADR-001)** ``` -workplans/COULOMB-WP-NNNN-.md ← write this first +workplans/LOOP-WP-NNNN-.md ← write this first ``` Then register in the hub: ``` @@ -28,7 +28,7 @@ create_task(workstream_id="", title="...", priority="high|medium|low") **Step 5 — Record the setup** ``` add_progress_event( - summary="First session: structured coulomb_social into N workstreams, M tasks", + summary="First session: structured communication into N workstreams, M tasks", event_type="milestone", topic_id="36c7421b-c537-4723-bf75-42a3ebc6a1dc", detail={"workstreams": [...], "tasks_created": M} diff --git a/.claude/rules/repo-boundary.md b/.claude/rules/repo-boundary.md index 724854f..861bedf 100644 --- a/.claude/rules/repo-boundary.md +++ b/.claude/rules/repo-boundary.md @@ -1,11 +1,8 @@ ## Repo boundary -This repo owns **coulomb-loop engagement operations** only. It does not own: +This repo owns **coulomb-loop** only. It does not own: -- Kaizen agent definitions → `kaizen-agentic` -- activity-core resolvers and Temporal workers → `activity-core` -- State-hub API/MCP → `state-hub` / `the-custodian` -- reuse-surface CLI and federation hub → `reuse-surface` -- Target repo `.kaizen/` state → each fleet repo checkout - -Cross-repo handoffs are documented in loop workplans and `docs/adr/ADR-002-customer-supplier-boundary.md`. \ No newline at end of file + diff --git a/.claude/rules/repo-identity.md b/.claude/rules/repo-identity.md index 9a1d87c..5f565d5 100644 --- a/.claude/rules/repo-identity.md +++ b/.claude/rules/repo-identity.md @@ -1,15 +1,5 @@ -## Repo Identity +**Purpose:** Coulomb fleet self-improvement loop engagement — customer repo for scheduled kaizen-agentic supplier operations. -**Purpose:** coulomb-loop — Coulomb customer engagement repo for fleet self-improvement loops operated with kaizen-agentic as supplier. - -**Domain:** coulomb_social +**Domain:** communication **Repo slug:** coulomb-loop **Topic ID:** 36c7421b-c537-4723-bf75-42a3ebc6a1dc - -**Supplier:** `kaizen-agentic` (agents, CLI, playbook — not merged into this repo) - -**Custodian integration:** Registered in state-hub. Workplans use `LOOP-WP` prefix (ADR-001). Sync after workplan edits: - -```bash -cd ~/state-hub && make fix-consistency REPO=coulomb-loop -``` \ No newline at end of file diff --git a/.claude/rules/session-protocol.md b/.claude/rules/session-protocol.md index 41aa985..e7e9679 100644 --- a/.claude/rules/session-protocol.md +++ b/.claude/rules/session-protocol.md @@ -1,6 +1,7 @@ ## Session Protocol -State Hub: http://127.0.0.1:8000 +Dev Hub (State Hub API): http://127.0.0.1:8000 +MCP server name in `~/.claude.json`: `dev-hub` **Step 1 — Orient** @@ -10,7 +11,7 @@ cat .custodian-brief.md ``` Then call the MCP tool for richer cross-domain context when MCP tools are exposed: ``` -get_domain_summary("coulomb_social") +get_domain_summary("communication") ``` If MCP tools are unavailable in the current agent session, use the REST API: ```bash @@ -43,7 +44,7 @@ For each file with `status: ready`, `active`, or `blocked`, note pending **Step 4 — Present brief** -1. **Active workstreams** for `coulomb_social` — title, task counts, blocking decisions +1. **Active workstreams** for `communication` — title, task counts, blocking decisions 2. **Pending tasks** from `workplans/` + any `[repo:coulomb-loop]` hub tasks 3. **Goal guidance** — if `goal_guidance` in summary: - `needs_workplan`: surface as top action — *"Repo goal '{title}' has no workplan yet"* diff --git a/.claude/rules/stack-and-commands.md b/.claude/rules/stack-and-commands.md index ab14597..dc53ac6 100644 --- a/.claude/rules/stack-and-commands.md +++ b/.claude/rules/stack-and-commands.md @@ -1,28 +1,19 @@ -## Stack and Commands +## Stack -**Language:** Markdown / YAML coordination artefacts -**Package manager:** none -**Test runner:** none + +- **Language:** +- **Key deps:** -### Essential commands +## Dev Commands ```bash -# Sync workplans to state-hub after edits -cd ~/state-hub && make fix-consistency REPO=coulomb-loop +# TODO: Fill in the standard commands for this repo -# Validate reuse-surface registry (when entries exist) -reuse-surface validate +# Install dependencies -# Supplier CLI on target repos (not this repo) -kaizen-agentic schedule validate --target /path/to/target-repo -kaizen-agentic schedule prepare coach --target /path/to/target-repo +# Run tests + +# Lint / type check + +# Build / package (if applicable) ``` - -### Session orientation - -```bash -# MCP when available -get_domain_summary("coulomb_social") -``` - -Fallback: `.custodian-brief.md` \ No newline at end of file diff --git a/.claude/rules/workplan-convention.md b/.claude/rules/workplan-convention.md index be1ba7f..c9021d9 100644 --- a/.claude/rules/workplan-convention.md +++ b/.claude/rules/workplan-convention.md @@ -1,17 +1,40 @@ ## Workplan Convention (ADR-001) File location: `workplans/LOOP-WP-NNNN-.md` -ID prefix: `LOOP-WP` (see `docs/adr/ADR-001-workplan-prefix.md`) +ID prefix: `LOOP-WP-` Work items originate as files in this repo **before** being registered in the hub. -Ecosystem todos from supplier or other agents arrive as `[repo:coulomb-loop]` hub tasks. +Canonical workplan/workstream frontmatter statuses are: +`proposed`, `ready`, `active`, `blocked`, `backlog`, `finished`, `archived`. +Use `proposed` for a newly drafted plan, `ready` after review against current +repo state, and `finished` when implementation is complete. `stalled` and +`needs_review` are derived health labels, not stored statuses. -After workplan file updates: +Closed workplans may be moved to `workplans/archived/` with a completion-date +prefix: `YYMMDD-LOOP-WP-NNNN-.md`. The frontmatter id remains +unchanged; the prefix is only for quick visual reference. -```bash -cd ~/state-hub && make fix-consistency REPO=coulomb-loop +Small opportunistic tasks discovered during another session use **Ad Hoc Tasks**: +`workplans/ADHOC-YYYY-MM-DD.md`, workstream slug `adhoc-YYYY-MM-DD`, and task ids +`ADHOC-YYYY-MM-DD-T01`, `T02`, etc. Use adhocs only for low-risk work completed +directly. Promote anything requiring analysis, design, approval, dependencies, or +multiple planned phases into a normal workplan. + +Ecosystem todos from other agents arrive as `[repo:coulomb-loop]` hub tasks — +visible at session start. Pick one up by creating the workplan file, then registering +the workstream. + +Task blocks use this shape: + +```task +id: LOOP-WP-NNNN-T01 +status: wait | todo | progress | done | cancel +priority: high | medium | low +state_hub_task_id: "" # written by fix-consistency — do not edit ``` -Customer loop workplans: LOOP-WP-0000 (bootstrap), LOOP-WP-0001–0004 (loops). -Supplier mirror: `kaizen-agentic` KAIZEN-WP-0008. \ No newline at end of file +Status progression is `todo` → `progress` → `done`; use `wait` for waiting or +blocked work and `cancel` for stopped work. + + diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..bf653a0 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,219 @@ +# coulomb-loop — Agent Instructions + +## Repo Identity + +**Purpose:** Coulomb fleet self-improvement loop engagement — customer repo for scheduled kaizen-agentic supplier operations. + +**Domain:** communication +**Repo slug:** coulomb-loop +**Topic ID:** `36c7421b-c537-4723-bf75-42a3ebc6a1dc` +**Workplan prefix:** `LOOP-WP-` + +--- + +## State Hub Integration + +The Custodian State Hub tracks work across all domains. Interact via HTTP REST — +there is no MCP server for Codex agents. + +| Context | URL | +|---------|-----| +| Local workstation | `http://127.0.0.1:8000` | +| Remote via tunnel | `http://127.0.0.1:18000` | + +### Orient at session start + +```bash +# Offline brief — works without hub connection +cat .custodian-brief.md + +# Active workstreams for this domain +curl -s "http://127.0.0.1:8000/workstreams/?topic_id=36c7421b-c537-4723-bf75-42a3ebc6a1dc&status=active" \ + | python3 -m json.tool + +# Check inbox +curl -s "http://127.0.0.1:8000/messages/?to_agent=coulomb-loop&unread_only=true" \ + | python3 -m json.tool +``` + +Mark a message read: +```bash +curl -s -X PATCH "http://127.0.0.1:8000/messages//read" \ + -H "Content-Type: application/json" -d '{}' +``` + +### Log progress (required at session close) + +```bash +curl -s -X POST http://127.0.0.1:8000/progress/ \ + -H "Content-Type: application/json" \ + -d '{ + "summary": "what was done", + "event_type": "note", + "author": "codex", + "workstream_id": "", + "task_id": "" + }' +``` + +Omit `workstream_id` / `task_id` when not applicable. + +### Update task status + +```bash +curl -s -X PATCH "http://127.0.0.1:8000/tasks/" \ + -H "Content-Type: application/json" \ + -d '{"status": "progress"}' +# values: wait | todo | progress | done | cancel +``` + +### Flag a task for human review + +```bash +curl -s -X PATCH "http://127.0.0.1:8000/tasks/" \ + -H "Content-Type: application/json" \ + -d '{"needs_human": true, "intervention_note": "reason"}' +``` + +--- + +## Session Protocol + +**Start:** +1. `cat .custodian-brief.md` — domain goal and open workstreams (offline-safe) +2. Check inbox: `GET /messages/?to_agent=coulomb-loop&unread_only=true`; mark read +3. Scan workplans: `ls workplans/` — note `status: ready`, `active`, or `blocked` files and open tasks +4. Check human-needed tasks: `GET /tasks/?needs_human=true` + +**During work:** +- Update task statuses in workplan files as tasks progress +- Record significant decisions via `POST /decisions/` + +**Close:** +1. Update workplan file task statuses to reflect progress +2. Log: `POST /progress/` with a summary of what changed +3. Note for the custodian operator: after workplan file changes, run from + `~/state-hub`: + ```bash + make fix-consistency REPO=coulomb-loop + ``` + This syncs task status from files into the hub DB. + +--- + +## Credential and access routing + +**Audience:** Codex, Claude Code, Grok, and custodian agents that call **llm-connect** +for inference. Run this check **before** requesting secrets, API keys, SSH access, +login tokens, or database passwords — in any repo, not only `ops-warden`. + +ops-warden **issues SSH certificates only** (`warden sign`, `cert_command`). Every +other credential need belongs to another subsystem. **Do not** message +`ops-warden` on State Hub expecting a secret value; the reply is a pointer, not a key. + +### Lookup (do this first) + +```bash +warden route find "" --json +warden route show --json +``` + +Requires the `warden` CLI from `~/ops-warden` (`uv tool install .` or `uv run warden`). + +| Agent runtime | How to orient | +| --- | --- | +| **Codex / Grok** (shell, HTTP State Hub) | `warden route` commands above; inbox `to_agent=coulomb-loop` is for coordination, not secret vending | +| **Claude Code** (MCP when available) | `get_domain_summary("custodian")` for workstreams; **still** use `warden route` for credential ownership | +| **llm-connect** (inference service) | Never put secret retrieval in prompts; route custody to OpenBao/operator paths surfaced by `warden route` | + +### Quick routing table + +| I need… | Owner | ops-warden executes? | +| --- | --- | --- | +| SSH cert (`adm`/`agt`/`atm`) | ops-warden | **Yes** — `warden sign` | +| API key, DB password, provider token | OpenBao (`railiance-platform`) | No — route only | +| Login / OIDC / MFA | key-cape / Keycloak | No — route only | +| Authorization decision | flex-auth | No — route only | +| activity-core → issue-core emission | activity-core + issue-core | No — `warden route show activity-core-issue-sink` | +| SSH tunnel | ops-bridge (+ `cert_command` from warden) | No — route only | + +### Anti-patterns (do not do these) + +- `POST /messages/` to `ops-warden` asking for `ISSUE_CORE_API_KEY`, `OPENROUTER_API_KEY`, etc. +- Inventing `warden secret`, `warden login`, `warden bao`, `warden tunnel` — they do not exist +- Pasting secrets into Git, State Hub, workplans, logs, or chat + +### Other capabilities (reuse-surface) + +Non-credential capabilities are usually discovered through **reuse-surface** federation +(`reuse-surface` registry / `capability.*` indexes). Credential routing is inlined in +every repo's agent instructions because it is high-frequency, high-risk, and easy to +get wrong. + +**Canon:** `~/ops-warden/wiki/CredentialRouting.md` · catalog `~/ops-warden/registry/routing/catalog.yaml` + + + + +--- + +## Workplan Convention (ADR-001) + +Work items originate as files in this repo — not in the hub. The hub is a +read/cache/index layer that rebuilds from files. + +**File location:** `workplans/COULOMB-WP-NNNN-.md` + +**Archived location:** finished workplans may move to +`workplans/archived/YYMMDD-COULOMB-WP-NNNN-.md`. The `YYMMDD` prefix is +the completion/archive date; the frontmatter `id` does not change. + +**Ad Hoc Tasks:** small opportunistic fixes discovered during a session use +`workplans/ADHOC-YYYY-MM-DD.md` with task ids `ADHOC-YYYY-MM-DD-T01`, etc. Use +this only for low-risk work completed directly; create a normal workplan for +anything needing analysis, design, approval, dependencies, or multiple phases. + +**Frontmatter:** + +```yaml +--- +id: COULOMB-WP-NNNN +type: workplan +title: "..." +domain: communication +repo: coulomb-loop +status: proposed | ready | active | blocked | backlog | finished | archived +owner: codex +topic_slug: ... +created: "YYYY-MM-DD" +updated: "YYYY-MM-DD" +state_hub_workstream_id: "" # written by fix-consistency — do not edit +--- +``` + +Use `proposed` for a new draft, `ready` after review against current repo +state, and `finished` after implementation. `stalled` and `needs_review` are +derived health labels, not frontmatter statuses. + +**Task block format** (one per `##` section): + +``` +## Task Title + +` ` `task +id: COULOMB-WP-NNNN-T01 +status: wait | todo | progress | done | cancel +priority: high | medium | low +state_hub_task_id: "" # written by fix-consistency — do not edit +` ` ` + +Task description text. +``` + +Status progression: `todo` → `progress` → `done`; use `wait` for waiting/blocked work and `cancel` for stopped work. + +To create a new workplan: +1. Write the file following the format above +2. Notify the custodian operator to run `make fix-consistency REPO=coulomb-loop` + (or send a message to the hub agent via `POST /messages/`) diff --git a/CLAUDE.md b/CLAUDE.md index e075dd5..2e7223c 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -8,4 +8,5 @@ @.claude/rules/stack-and-commands.md @.claude/rules/architecture.md @.claude/rules/repo-boundary.md +@.claude/rules/credential-routing.md @.claude/rules/agents.md diff --git a/workplans/LOOP-WP-0000-engagement-bootstrap.md b/workplans/LOOP-WP-0000-engagement-bootstrap.md index 8f3705e..b0737c6 100644 --- a/workplans/LOOP-WP-0000-engagement-bootstrap.md +++ b/workplans/LOOP-WP-0000-engagement-bootstrap.md @@ -2,11 +2,11 @@ id: LOOP-WP-0000 type: workplan title: "Engagement bootstrap (registration, assessment, governance)" -domain: coulomb_social +domain: communication repo: coulomb-loop status: done owner: coulomb-loop -topic_slug: coulomb_social +topic_slug: coulomb-social supplier: kaizen-agentic created: "2026-06-18" updated: "2026-06-18" diff --git a/workplans/LOOP-WP-0001-kaizen-improvement-stack.md b/workplans/LOOP-WP-0001-kaizen-improvement-stack.md index f5cb80e..8016247 100644 --- a/workplans/LOOP-WP-0001-kaizen-improvement-stack.md +++ b/workplans/LOOP-WP-0001-kaizen-improvement-stack.md @@ -2,11 +2,11 @@ id: LOOP-WP-0001 type: workplan title: "Kaizen Improvement Stack (coach + metrics + optimization)" -domain: coulomb_social +domain: communication repo: coulomb-loop status: done owner: coulomb-loop -topic_slug: coulomb_social +topic_slug: coulomb-social supplier: kaizen-agentic created: "2026-06-18" updated: "2026-06-18" diff --git a/workplans/LOOP-WP-0002-reactive-quality-escalation.md b/workplans/LOOP-WP-0002-reactive-quality-escalation.md index 4b8e858..6d3d8bc 100644 --- a/workplans/LOOP-WP-0002-reactive-quality-escalation.md +++ b/workplans/LOOP-WP-0002-reactive-quality-escalation.md @@ -2,11 +2,11 @@ id: LOOP-WP-0002 type: workplan title: "Reactive Quality Escalation (signal-driven improvement)" -domain: coulomb_social +domain: communication repo: coulomb-loop status: finished owner: coulomb-loop -topic_slug: coulomb_social +topic_slug: coulomb-social supplier: kaizen-agentic created: "2026-06-18" updated: "2026-06-18" diff --git a/workplans/LOOP-WP-0003-registry-orientation-hygiene.md b/workplans/LOOP-WP-0003-registry-orientation-hygiene.md index 71bf58f..41f9622 100644 --- a/workplans/LOOP-WP-0003-registry-orientation-hygiene.md +++ b/workplans/LOOP-WP-0003-registry-orientation-hygiene.md @@ -2,11 +2,11 @@ id: LOOP-WP-0003 type: workplan title: "Registry & Orientation Hygiene (fleet legibility)" -domain: coulomb_social +domain: communication repo: coulomb-loop status: done owner: coulomb-loop -topic_slug: coulomb_social +topic_slug: coulomb-social supplier: kaizen-agentic created: "2026-06-18" updated: "2026-06-18" diff --git a/workplans/LOOP-WP-0004-loop-regulator.md b/workplans/LOOP-WP-0004-loop-regulator.md index fa8b559..2d787c6 100644 --- a/workplans/LOOP-WP-0004-loop-regulator.md +++ b/workplans/LOOP-WP-0004-loop-regulator.md @@ -2,11 +2,11 @@ id: LOOP-WP-0004 type: workplan title: "Loop Regulator (second-order improvement)" -domain: coulomb_social +domain: communication repo: coulomb-loop status: done owner: coulomb-loop -topic_slug: coulomb_social +topic_slug: coulomb-social supplier: kaizen-agentic created: "2026-06-18" updated: "2026-06-18" diff --git a/workplans/LOOP-WP-0005-operate-phase-observation.md b/workplans/LOOP-WP-0005-operate-phase-observation.md index 34c0b1b..1fa2e74 100644 --- a/workplans/LOOP-WP-0005-operate-phase-observation.md +++ b/workplans/LOOP-WP-0005-operate-phase-observation.md @@ -2,11 +2,11 @@ id: LOOP-WP-0005 type: workplan title: "Operate phase observation and fleet expansion prep" -domain: coulomb_social +domain: communication repo: coulomb-loop status: done owner: coulomb-loop -topic_slug: coulomb_social +topic_slug: coulomb-social supplier: kaizen-agentic created: "2026-06-18" updated: "2026-06-19" From f3d1d98e429a7133cda731cfe9775db6ac93b884 Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 22 Jun 2026 23:20:31 +0200 Subject: [PATCH 09/10] chore(consistency): sync task status from DB [auto] Updated by fix-consistency on 2026-06-22: - update .custodian-brief.md for coulomb-loop --- .custodian-brief.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.custodian-brief.md b/.custodian-brief.md index dc6a487..6052542 100644 --- a/.custodian-brief.md +++ b/.custodian-brief.md @@ -1,8 +1,8 @@ # Custodian Brief — coulomb-loop -**Domain:** coulomb_social -**Last synced:** 2026-06-18 23:39 UTC +**Domain:** communication +**Last synced:** 2026-06-22 21:20 UTC **State Hub:** http://127.0.0.1:8000 *(adjust if running on a remote machine)* ## Active Workstreams @@ -13,6 +13,6 @@ ## MCP Orientation (when available) If the state-hub MCP server is reachable, call: -`get_domain_summary("coulomb_social")` +`get_domain_summary("communication")` This provides richer cross-domain context. If the MCP call fails, use this file as your orientation source. From 3fda7e54d14a4eaf71ec2fa62f32c2bb8d150bde Mon Sep 17 00:00:00 2001 From: tegwick Date: Wed, 8 Jul 2026 12:30:37 +0200 Subject: [PATCH 10/10] Add Forgejo CI smoke workflow (enablement template) --- .forgejo/workflows/ci-smoke.yaml | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 .forgejo/workflows/ci-smoke.yaml diff --git a/.forgejo/workflows/ci-smoke.yaml b/.forgejo/workflows/ci-smoke.yaml new file mode 100644 index 0000000..bd44c56 --- /dev/null +++ b/.forgejo/workflows/ci-smoke.yaml @@ -0,0 +1,29 @@ +# Canonical CI smoke template (tier 1 routing drill). +# Copy to: .forgejo/workflows/ci-smoke.yaml in consumer repos. +name: CI Smoke + +on: + push: + branches: + - main + workflow_dispatch: + +jobs: + host-smoke: + runs-on: self-hosted + steps: + - name: Routing probe (host runner) + run: | + set -eu + echo "repository=${GITHUB_REPOSITORY:-unknown}" + echo "sha=${GITHUB_SHA:-unknown}" + echo "runner=${RUNNER_NAME:-unknown}" + uname -a + + container-smoke: + runs-on: ubuntu-latest + steps: + - name: Routing probe (container label) + run: | + set -eu + echo "container-smoke ok for ${GITHUB_REPOSITORY:-unknown}" \ No newline at end of file