Compare commits

..

18 Commits

Author SHA1 Message Date
AI-Agent 25045d4ff1 fix: update ROADMAP.md stale issue reference from #174 to #231
Validate Flux manifests / kustomize-build (pull_request) Failing after 20s
Issue #174 (Add VIN Decoder metrics instrumentation) is closed .
The live-cluster verification of VIN Decoder metrics/ServiceMonitor
is now tracked by #231 (open).

Closes leeworks-agents/api-company#233
2026-06-07 15:01:30 +00:00
AI-Manager 7a45bfc369 Merge pull request 'docs: update STATUS.md for 2026-06-07 triage cycle #232' (#232) from feature/triage-2026-06-07-cycle232 into main
Validate Flux manifests / kustomize-build (push) Failing after 21s
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 43s
2026-06-07 10:03:01 +00:00
AI-Agent 273a41e1fe docs: update STATUS.md for 2026-06-07 triage cycle #232
Validate Flux manifests / kustomize-build (pull_request) Failing after 23s
- 28 agent-ready issues reviewed (27 previously known + new #231)
- Issue #231 triaged: @qa-engineer — VIN Decoder metrics live-cluster
  verification; BLOCKED on #218 (Flux not active)
- kustomize build flux/ PASS
- 0 open PRs
2026-06-07 10:02:32 +00:00
AI-Manager 23dfec20a1 Merge pull request 'fix: add named port 'http' to vin-decoder Service and container for ServiceMonitor scraping' (#230) from feature/fix-vin-decoder-servicemonitor-port into main
Validate Flux manifests / kustomize-build (push) Failing after 21s
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 37s
2026-06-07 05:06:43 +00:00
AI-Agent cc7172d563 fix: add named port 'http' to vin-decoder Service and container for ServiceMonitor compatibility
Validate Flux manifests / kustomize-build (pull_request) Failing after 20s
The ServiceMonitor at flux/vin-decoder/servicemonitor.yaml references port
by name ('http'), but the Service had anonymous port 80 -> 3000 and the
container had no named port. Prometheus ServiceMonitor port matching requires
the port name to match between the Service and the ServiceMonitor spec.

Adds:
- name: http to the containerPort (port 3000)
- name: http to the Service port (port 80 -> targetPort 3000)

This allows the kube-prometheus-stack ServiceMonitor to correctly scrape
/metrics from vin-decoder pods.

Closes leeworks-agents/api-company#174
2026-06-07 05:06:10 +00:00
AI-Manager 695dac91c4 Merge pull request 'docs: update STATUS.md for 2026-06-07 triage cycle' (#229) from feature/triage-2026-06-07 into main
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 34s
Validate Flux manifests / kustomize-build (push) Failing after 24s
2026-06-07 00:05:47 +00:00
AI-Agent b2d33a56c4 docs: update STATUS.md for 2026-06-07 triage cycle
Validate Flux manifests / kustomize-build (pull_request) Failing after 25s
- Updated last-updated date to 2026-06-07
- Added Completed This Cycle section for 2026-06-07 triage
- All 27 agent-ready issues triaged and commented
- 0 new issues, 0 closed, 0 PRs, kustomize build PASS
- Critical path unchanged: #47, #218, #33/#106/#150
2026-06-07 00:05:23 +00:00
AI-Agent 8c2cce576e chore: sprint planning cycle #227 — STATUS.md updated (2026-06-06)
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 59s
Validate Flux manifests / kustomize-build (push) Failing after 38s
Full ROADMAP cross-reference: all 18 unchecked items grounded in open issues, zero gaps.
Staleness check: oldest issue #3/#4 is 19 days old (< 30-day threshold), zero closures.
Label audit: all labels correct from prior cycle, zero changes.
kustomize build flux/ = PASS.
2026-06-06 20:25:07 +00:00
AI-Manager 9c2f228f0c Merge pull request 'docs: update ROADMAP.md Flux wiring entry to reference active tracker #218' (#228) from feature/issue-227-roadmap-flux-ref into main
Validate Flux manifests / kustomize-build (push) Failing after 13s
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 41s
2026-06-06 20:02:10 +00:00
AI-Agent 1f8014113f docs: update ROADMAP.md Flux wiring ref from closed #2/#187 to active #218
Validate Flux manifests / kustomize-build (pull_request) Failing after 22s
Replace closed issue references (#2, #187) on the Phase 0 Flux
GitRepository entry with the current active tracker #218, which awaits
operator merge of 0xWheatyz/Talos PR #14 to activate Flux GitOps.

Closes leeworks-agents/api-company#227
2026-06-06 20:01:49 +00:00
AI-Manager 9470207b07 Merge pull request 'docs: update STATUS.md for 2026-06-06 triage cycle (#226)' (#226) from feature/issue-226-triage-cycle-2026-06-06 into main
Validate Flux manifests / kustomize-build (push) Failing after 21s
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 37s
2026-06-06 15:07:01 +00:00
AI-Agent 04a6185824 docs: update STATUS.md for 2026-06-06 triage cycle (#226)
Validate Flux manifests / kustomize-build (pull_request) Failing after 25s
- Triaged all 27 open agent-ready issues; all confirmed blocked on operator
  tasks (create 0xWheatyz/api-company #47, merge Talos PR #14 #218, DNS #33)
- 0 new issues, 0 closures, 0 PRs, kustomize build flux/ = PASS
- Added Completed This Cycle entry for Triage Cycle #226
2026-06-06 15:06:34 +00:00
AI-Manager cde5122702 Merge pull request 'docs: update secrets-checklist.md item #4 for Alertmanager dual consumer (#224)' (#225) from feature/issue-224-secrets-checklist-alertmanager-dual-consumer into main
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 44s
Validate Flux manifests / kustomize-build (push) Failing after 21s
2026-06-06 10:02:53 +00:00
AI-Agent c7b44b9da6 docs: update secrets-checklist.md item #4 for Alertmanager dual consumer
Validate Flux manifests / kustomize-build (pull_request) Failing after 33s
gatus-slack-webhook (monitoring) is now consumed by two components:
1. Gatus (flux/monitoring/gatus-helmrelease.yaml) - public status-page alerts
2. Alertmanager (flux/monitoring/helmrelease.yaml via alertmanagerSpec.secrets)
   - SLO / firing-alert Slack notifications (enabled by PR #212 / issue #210)

Updates:
- Checklist item #4: mention both Gatus AND Alertmanager Slack SLO alerts
- Secret Details §4: add Consumers row + dual-consumer note explaining
  alertmanagerSpec.secrets mounts this secret and the slack_api_url_file path
- Dependency order: note Alertmanager is also unblocked by item #4

Closes leeworks-agents/api-company#224
2026-06-06 10:02:04 +00:00
AI-Manager 691fe45c13 Merge pull request 'docs: update STATUS.md for 2026-06-06 sprint planning cycle (#221)' (#223) from feature/issue-221-status-update-2026-06-06 into main
Validate Flux manifests / kustomize-build (push) Failing after 7s
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 54s
2026-06-06 05:03:20 +00:00
AI-Agent 14433e7741 docs: update STATUS.md for 2026-06-06 sprint planning cycle (#221)
Validate Flux manifests / kustomize-build (pull_request) Failing after 22s
- Set Completed This Cycle to Sprint Planning Cycle #221
- Record 0 new issues, 0 closures, 3 label changes (blocked on #106/#150, P1→P2 on #203)
- Update Current Blockers date to 2026-06-06
- kustomize build flux/ = PASS

Closes leeworks-agents/api-company#221
2026-06-06 05:02:53 +00:00
AI-Manager a5aeaf64df Merge pull request 'docs: update STATUS.md blockers — replace closed #187/#90 with open #218' (#220) from feature/issue-219-status-update-blockers into main
Build Docs Site / Aggregate OpenAPI Specs (push) Failing after 46s
Validate Flux manifests / kustomize-build (push) Failing after 16s
2026-06-06 00:04:09 +00:00
AI-Agent 58c6e28ea5 docs: update STATUS.md blockers — replace closed #187/#90 with #218, update Critical Path
Validate Flux manifests / kustomize-build (pull_request) Failing after 51s
Closes leeworks-agents/api-company#219

- Current Blockers item 8: removed P1 #187 and P1 #90 (both closed);
  replaced with P1 #218 (Operator: merge 0xWheatyz/Talos upstream PR #14
  to activate Flux GitOps for api-company)
- Critical Path item 2: updated from #90 reference to #218
- Added Completed This Cycle entry for #219
- kustomize build flux/ = PASS
2026-06-06 00:03:40 +00:00
4 changed files with 76 additions and 14 deletions
+2 -2
View File
@@ -6,7 +6,7 @@ Cross-repo milestones. Per-API phases live in each API repo's ROADMAP.md.
## Phase 0 — Orientation (one-time)
- [x] Audit cluster: nodes, namespaces, ingress, Flux state → `docs/cluster-audit.md` (issue #36 — closed ✅)
- [ ] Add Flux GitRepository + Kustomization watching `leeworks-agents/api-company` — issue #2 (Talos PR implementation: issue #187)
- [ ] Add Flux GitRepository + Kustomization watching `leeworks-agents/api-company` — issue #218 (fork PR #399 merged to leeworks-agents/Talos; awaiting operator merge of 0xWheatyz/Talos PR #14)
- [ ] Deploy `gitea-act-runner` in cluster via Flux HelmRelease (`flux/gitea-runner/`) — issue #3
- [ ] Stand up `registry.leeworks.dev` (container registry) — required before any API CI works — issue #4
- [ ] Validate ESO HelmRelease deployment and ExternalSecret sync for all 4 API namespaces — issue #178
@@ -29,7 +29,7 @@ Per-API: implement Fastify/FastAPI service matching `openapi.yaml` exactly. Rapi
- [ ] Gatus public status page at `status.leeworks.dev` — issue #8
- [x] Instrument every API with `api_requests_total`, `api_response_duration_seconds`, `api_data_freshness_seconds` (issue #27 — closed ✅)
- [x] Add Prometheus metrics endpoint to holidays service (issue #180 — closed ✅)
- [ ] Verify VIN Decoder metrics endpoint and ServiceMonitor scrape config — issue #174
- [ ] Verify VIN Decoder metrics endpoint and ServiceMonitor scrape config — issue #231
- [x] VIN Decoder metrics instrumentation + Grafana dashboard (issue #129 — closed ✅)
- [x] VIN Decoder Gatus health check (issue #134 — closed ✅)
- [x] Enable Alertmanager in kube-prometheus-stack + configure Slack receiver for SLO alerts (issue #210 — closed ✅)
+63 -6
View File
@@ -1,6 +1,6 @@
# Company Status
_Last updated: 2026-06-05_
_Last updated: 2026-06-07_
## APIs
| API | Spec | Code | Deployed | Listed on RapidAPI | Paying Users | MRR |
@@ -24,7 +24,65 @@ Legend: [x]=done, [~]=in-progress, [ ]=not started
- **VIN Decoder manifests:** `flux/vin-decoder/` — Flux HelmRelease + Kustomization committed (issue #140)
- **Alertmanager:** `flux/monitoring/helmrelease.yaml` — enabled with Slack receiver config (`gatus-slack-webhook` secret); PR #212 open (issue #210)
## Completed This Cycle (2026-06-05Sprint Planning Cycle #215)
## Completed This Cycle (2026-06-07Triage Cycle #232)
- **Triage** — All 28 open `agent-ready` issues reviewed and commented with current status (2026-06-07).
- **All issues confirmed blocked** on the same critical-path operator tasks: #47 (create `0xWheatyz/api-company`), #218 (merge Talos PR #14), #33/#106/#150 (DNS).
- **No agent-implementable work found** — all open issues are either manual operator tasks or gated on Flux/cluster activation; kubectl unreachable from agent environment.
- **1 new issue triaged** — #231 commented with @qa-engineer assessment; BLOCKED on #218.
- **0 new issues created** — no gaps found; all ROADMAP items remain grounded in open issues.
- **0 issues closed** — no stale issues.
- **0 label changes** — all existing labels correct.
- **0 open PRs** — nothing to review or merge.
- **`kustomize build flux/` = PASS** — no manifest regressions.
- **Critical path unchanged:** (1) Operator creates `0xWheatyz/api-company` (#47), (2) Operator merges `0xWheatyz/Talos` PR #14 (#218), (3) Operator configures DNS for all 8 subdomains (#33, #106, #150).
## Completed Previous Cycle (2026-06-06 — Sprint Planning Cycle #227)
- **Sprint Planning** — Full ROADMAP cross-reference + backlog triage completed (2026-06-06).
- **ROADMAP cross-reference:** All 18 unchecked items confirmed grounded in open issues — **zero gaps**.
- Phase 0: #3, #4, #66, #76#83, #126#128, #173, #178, #179, #203, #218 — all tracked.
- Phase 4: #7, #8, #174 — all tracked.
- Phase 5: #30 — tracked.
- Phase 6: #19, #33, #44, #106, #116, #139, #150, #151, #161, #166, #167 — all tracked.
- **Staleness check:** Oldest open issue is #3 / #4 from 2026-05-18 (19 days) — **below 30-day threshold; zero closures**.
- **Label audit:** All priority/complexity labels confirmed correct from cycle #221 audit — **zero changes**.
- **0 new issues created** — no roadmap gaps found.
- **0 issues closed** — no stale issues.
- **0 label changes** — all existing labels correct.
- **`kustomize build flux/` = PASS** — no manifest regressions.
- **Critical path unchanged:** (1) Operator creates `0xWheatyz/api-company` (#47), (2) Operator merges `0xWheatyz/Talos` PR #14 (#218), (3) Operator configures DNS for all 8 subdomains (#33, #106, #150).
## Completed Previous Cycle (2026-06-06 — Triage Cycle #226)
- **Triage** — All 28 open `agent-ready` issues reviewed and commented with current status (2026-06-06).
- **All issues confirmed blocked** on the same critical-path operator tasks: #47 (create `0xWheatyz/api-company`), #218 (merge Talos PR #14), #33/#106/#150 (DNS).
- **No agent-implementable work found** — all open issues are either manual operator tasks or gated on Flux/cluster activation.
- **0 new issues created** — no gaps found; all ROADMAP items are grounded in open issues.
- **0 issues closed** — no issues are stale or resolvable by agent action.
- **0 PRs open** — nothing to review or merge.
- **`kustomize build flux/` = PASS** — no manifest regressions.
- **Current critical path unchanged:** (1) Operator creates `0xWheatyz/api-company` (#47), (2) Operator merges `0xWheatyz/Talos` PR #14 (#218), (3) Operator configures DNS for all 8 subdomains (#33, #106, #150).
## Completed Previous Cycle (2026-06-06 — Sprint Planning Cycle #221)
- **#221** — STATUS.md updated for 2026-06-06 sprint planning cycle (this entry). Last-updated date confirmed 2026-06-06.
- **0 new issues created** — all ROADMAP unchecked items confirmed grounded in open issues (35 open issues, zero gaps).
- **0 issues closed** — oldest open issue is #3 from 2026-05-18 (19 days < 30-day stale threshold).
- **3 label changes:**
- #106 (grafana.leeworks.dev DNS): added `blocked` label (missing despite dependency on #47)
- #150 (vin.leeworks.dev DNS): added `blocked` label (missing despite dependency on #47)
- #203 (ClusterIssuer verification): downgraded P1 → P2 (gated on DNS #33, not a first-order blocker)
- **Critical path unchanged:** Operator must (1) create `0xWheatyz/api-company` (#47), (2) merge upstream Talos PR #14 (#218) to activate Flux, (3) configure DNS (#33, #106, #150).
- **`kustomize build flux/` = PASS** — no manifest regressions.
## Completed Previous Cycle (2026-06-06 — Docs Cycle #219)
- **#219** — STATUS.md Current Blockers updated: removed closed issues #187 and #90; replaced with open issue #218 (Operator: merge 0xWheatyz/Talos upstream PR #14 to activate Flux GitOps for api-company). Critical Path item 2 updated to reference #218. `kustomize build flux/` = PASS.
## Completed Previous Cycle (2026-06-05 — Sprint Planning Cycle #215)
- **#215** — STATUS.md updated for 2026-06-05 sprint planning cycle (this entry). Last-updated date confirmed 2026-06-05.
- **1 new issue created:** #214 (ROADMAP.md Phase 4 Alertmanager annotation — documentation gap filed).
@@ -145,7 +203,7 @@ Legend: [x]=done, [~]=in-progress, [ ]=not started
- **PR #160 closed** — had merge conflicts and ROADMAP.md regressions (unchecked completed items). Clean fix applied here.
- **`kustomize build flux/` = PASS** — no regressions.
## Current Blockers (as of 2026-06-04)
## Current Blockers (as of 2026-06-06)
In dependency order — operator tasks unless noted:
@@ -156,8 +214,7 @@ In dependency order — operator tasks unless noted:
5. **P1 #83** — Configure `GITEA_TOKEN` Actions secret in zip-enrichment, holidays, air-quality repos (operator)
6. **P1 #126** — Configure `GITEA_TOKEN` Actions secret in vin-decoder repo (operator — depends on #122 ✅)
7. **P1 #127** — Create `gitea-registry` imagePullSecret in `vin-decoder` namespace (operator)
8. **P1 #187**Merge upstream PR #14 on 0xWheatyz/Talos to activate Flux for api-company (operator) — Fork PR #399 already MERGED to leeworks-agents/Talos; upstream PR #14 is the critical gate; unblocks #2, #3, #4, #66 chain
9. **P1 #90** — Wire Flux GitRepository + Kustomization for api-company in `0xWheatyz/Talos` (superseded by #187; upstream PR #14 pending operator merge)
8. **P1 #218**Operator: merge 0xWheatyz/Talos upstream PR #14 to activate Flux GitOps for api-company — Fork PR #399 already MERGED to leeworks-agents/Talos; upstream PR #14 is the critical gate; unblocks #2, #3, #4, #66 chain (replaces closed #187 and #90)
10. **P2 #80** — Create `gitea-image-automation-token` secret in `flux-system` namespace (operator) — enables Flux image automation
11. **P2 #173** — Create ESO source secrets in `external-secrets` namespace for RapidAPI proxy-secret syncing (operator) — blocks ESO sync
12. **P2 #174** — VIN Decoder metrics instrumentation in `leeworks-agents/vin-decoder` repo (agent task, depends on #18 deploy)
@@ -204,7 +261,7 @@ In dependency order — operator tasks unless noted:
See **Current Blockers** section above for the full ordered list as of 2026-06-01.
1. **Create `0xWheatyz/api-company` repo** (#47) — **highest priority, unblocks everything**
2. **Add api-company Flux source to Talos** (#90) — needs Talos PR, reference manifests at `flux/api-company-source/`
2. **Merge upstream Talos PR #14 to activate Flux for api-company** (#218) — manifests already committed; operator must merge 0xWheatyz/Talos PR #14
3. **Create `gitea-leeworks-agents-token` secret** in `flux-system` (#76)
4. **Create `gitea-runner-token` secret** in `gitea-runner` (#77)
5. **Enable Gitea packages + DNS for `registry.leeworks.dev`** (#4)
+7 -4
View File
@@ -12,7 +12,7 @@ Follow this list top-to-bottom; each step unblocks the next.
- [ ] 1. `gitea-leeworks-agents-token` (flux-system) — unblocks Flux GitRepository auth
- [ ] 2. `gitea-runner-token` (gitea-runner) — unblocks Gitea Actions runner registration
- [ ] 3. `grafana-admin` (monitoring) — unblocks Grafana login
- [ ] 4. `gatus-slack-webhook` (monitoring) — unblocks Gatus alert notifications
- [ ] 4. `gatus-slack-webhook` (monitoring) — unblocks Gatus alert notifications AND Alertmanager Slack SLO alerts
- [ ] 5. `GITEA_TOKEN` in each API repo's Actions Secrets — unblocks CI image push
- [ ] 6. Gitea packages enabled + DNS record for `registry.leeworks.dev` — unblocks image push to registry
- [ ] 7. Add api-company Flux source + kustomization to 0xWheatyz/Talos — unblocks all GitOps reconciliation
@@ -92,9 +92,12 @@ Grafana will be accessible at `https://grafana.leeworks.dev` (login: `admin` / `
|-----------|-------|
| Name | `gatus-slack-webhook` |
| Namespace | `monitoring` |
| Purpose | Gatus posts downtime alerts to a Slack channel via incoming webhook |
| Purpose | Gatus posts downtime alerts to a Slack channel via incoming webhook. Also mounted by Alertmanager (`alertmanagerSpec.secrets`) to send SLO / firing-alert Slack notifications. |
| Source | Slack → Your workspace → Apps → Incoming Webhooks → Add to Slack → copy webhook URL |
| Unblocks | Issue #8 (Gatus status page at `status.leeworks.dev`) |
| Unblocks | Issue #8 (Gatus status page at `status.leeworks.dev`); Alertmanager Slack receiver (issue #210) |
| Consumers | **Two components** share this secret: (1) **Gatus** (`flux/monitoring/gatus-helmrelease.yaml`) — public status-page alerts; (2) **Alertmanager** (`flux/monitoring/helmrelease.yaml` via `alertmanagerSpec.secrets`) — SLO / firing-alert Slack notifications |
> **Note (dual consumer):** Creating this one secret (`gatus-slack-webhook` in the `monitoring` namespace) unblocks **both** Gatus alert delivery AND Alertmanager's Slack receiver. The Alertmanager configuration references this secret at `global.slack_api_url_file: /etc/alertmanager/secrets/gatus-slack-webhook/url` (enabled in PR #212 / issue #210).
```bash
kubectl create secret generic gatus-slack-webhook \
@@ -266,7 +269,7 @@ kubectl create secret generic rapidapi-proxy-secret \
1 (gitea-leeworks-token) → Flux can pull this repo over HTTPS
2 (gitea-runner-token) → runner online → CI runs
3 (grafana-admin) → Grafana login works
4 (gatus-slack-webhook) → Gatus alerting works
4 (gatus-slack-webhook) → Gatus alerting works + Alertmanager Slack SLO alerts
5 + 6 (GITEA_TOKEN + registry packages) → CI pushes images → API services deploy
8 (gitea-registry) → pods can pull images from registry.leeworks.dev → services start
9 (gitea-image-automation-token) → Flux ImageUpdateAutomation pushes tag-update commits
+4 -2
View File
@@ -37,7 +37,8 @@ spec:
- name: vin-decoder
image: registry.leeworks.dev/vin-decoder/api:latest # {"$imagepolicy": "flux-system:vin-decoder"}
ports:
- containerPort: 3000
- name: http
containerPort: 3000
env:
- name: RAPIDAPI_PROXY_SECRET
valueFrom:
@@ -72,7 +73,8 @@ spec:
selector:
app: vin-decoder
ports:
- port: 80
- name: http
port: 80
targetPort: 3000
- apiVersion: networking.k8s.io/v1
kind: Ingress