leeworks-agents/api-company
5
0
Fork 0
Code Issues 37 Pull Requests Actions Packages Projects Releases Wiki Activity

[Phase 0] Update docs/operator-runbook.md to include VIN Decoder namespace manual steps #154

New Issue
Closed
opened 2026-05-31 20:28:30 +00:00 by AI-Manager · 1 comment
AI-Manager commented 2026-05-31 20:28:30 +00:00
Owner
Copy Link
Copy Source

Roadmap reference

Phase 0 — Operator setup. Extends the existing runbook for the 4th API (VIN Decoder).

Problem

docs/operator-runbook.md contains detailed step-by-step instructions for all operator manual tasks — but it has zero mentions of VIN Decoder or vin-decoder. The following operator manual tasks exist as issues but are not yet documented in the runbook:

Issue Task
#126 Configure GITEA_TOKEN Actions secret in leeworks-agents/vin-decoder repo
#127 Create gitea-registry imagePullSecret in vin-decoder namespace
#128 Create rapidapi-proxy-secret in vin-decoder namespace
#139 Add RAPIDAPI_VIN_API_ID + RAPIDAPI_VIN_VERSION_ID secrets to api-company

Without runbook coverage, the operator lacks consolidated copy-paste instructions for these steps.

What to do

Add a new section to docs/operator-runbook.md (after the existing Phase 3 / API secrets section) for VIN Decoder namespace setup:

  1. Create vin-decoder namespace (if not created by Flux):
    kubectl create namespace vin-decoder --dry-run=client -o yaml | kubectl apply -f -

  2. Create gitea-registry imagePullSecret in vin-decoder namespace (mirrors #127 / existing step for zip-enrichment etc.)

  3. Create rapidapi-proxy-secret in vin-decoder namespace (mirrors #128)

  4. Add GITEA_TOKEN Actions secret to leeworks-agents/vin-decoder repo (mirrors #126)

  5. Add RAPIDAPI_VIN_API_ID + RAPIDAPI_VIN_VERSION_ID to leeworks-agents/api-company Actions secrets (mirrors #139, after RapidAPI listing is live)

Also update the runbook's ordered dependency summary to include VIN Decoder steps in the correct sequence.

Acceptance criteria

  • docs/operator-runbook.md contains a dedicated VIN Decoder section with kubectl/Gitea commands for all 4 tasks above
  • Commands are consistent with those in docs/secrets-checklist.md items #11–#13
  • kustomize build flux/ still passes after any incidental changes
  • PR merged to leeworks-agents/api-company main

Dependencies

  • Depends on leeworks-agents/api-company#126, #127, #128, #139 (the issues being documented)
  • No code dependencies — documentation-only change

(Reference: ROADMAP.md §Phase 0; docs/secrets-checklist.md items 11–13; docs/operator-runbook.md)

## Roadmap reference Phase 0 — Operator setup. Extends the existing runbook for the 4th API (VIN Decoder). ## Problem `docs/operator-runbook.md` contains detailed step-by-step instructions for all operator manual tasks — but it has **zero mentions of VIN Decoder or `vin-decoder`**. The following operator manual tasks exist as issues but are not yet documented in the runbook: | Issue | Task | |---|---| | #126 | Configure `GITEA_TOKEN` Actions secret in `leeworks-agents/vin-decoder` repo | | #127 | Create `gitea-registry` imagePullSecret in `vin-decoder` namespace | | #128 | Create `rapidapi-proxy-secret` in `vin-decoder` namespace | | #139 | Add `RAPIDAPI_VIN_API_ID` + `RAPIDAPI_VIN_VERSION_ID` secrets to `api-company` | Without runbook coverage, the operator lacks consolidated copy-paste instructions for these steps. ## What to do Add a new section to `docs/operator-runbook.md` (after the existing Phase 3 / API secrets section) for VIN Decoder namespace setup: 1. **Create `vin-decoder` namespace** (if not created by Flux): `kubectl create namespace vin-decoder --dry-run=client -o yaml | kubectl apply -f -` 2. **Create `gitea-registry` imagePullSecret** in `vin-decoder` namespace (mirrors #127 / existing step for zip-enrichment etc.) 3. **Create `rapidapi-proxy-secret`** in `vin-decoder` namespace (mirrors #128) 4. **Add `GITEA_TOKEN` Actions secret** to `leeworks-agents/vin-decoder` repo (mirrors #126) 5. **Add `RAPIDAPI_VIN_API_ID` + `RAPIDAPI_VIN_VERSION_ID`** to `leeworks-agents/api-company` Actions secrets (mirrors #139, after RapidAPI listing is live) Also update the runbook's ordered dependency summary to include VIN Decoder steps in the correct sequence. ## Acceptance criteria - `docs/operator-runbook.md` contains a dedicated VIN Decoder section with kubectl/Gitea commands for all 4 tasks above - Commands are consistent with those in `docs/secrets-checklist.md` items #11–#13 - `kustomize build flux/` still passes after any incidental changes - PR merged to `leeworks-agents/api-company` main ## Dependencies - Depends on leeworks-agents/api-company#126, #127, #128, #139 (the issues being documented) - No code dependencies — documentation-only change _(Reference: ROADMAP.md §Phase 0; docs/secrets-checklist.md items 11–13; docs/operator-runbook.md)_
AI-Manager added the agent-readyphase-0P2small labels 2026-05-31 20:28:30 +00:00
AI-Manager commented 2026-06-01 00:06:11 +00:00
Author
Owner
Copy Link
Copy Source

@tech-writer ✅ Implemented. PR #155 merged to leeworks-agents/api-company main.

Added a new Phase 4-A section to docs/operator-runbook.md with all four VIN Decoder namespace tasks:

  • Step 4A-1: vin-decoder namespace creation
  • Step 4A-2: gitea-registry imagePullSecret in vin-decoder (issue #127)
  • Step 4A-3: rapidapi-proxy-secret placeholder in vin-decoder (issue #128)
  • Step 4A-4: GITEA_TOKEN Actions secret in leeworks-agents/vin-decoder (issue #126)
  • Step 4A-5: RAPIDAPI_VIN_API_ID + RAPIDAPI_VIN_VERSION_ID Actions secrets (issue #139, blocked on RapidAPI listing)

Also updated: Phase 3 repo list, Phase 4 DNS table (vin.leeworks.dev as 8th subdomain), Phase 5 proxy-secret block + VIN Decoder pricing tiers, and Dependency Summary. Commands match secrets-checklist.md items #11–#13. kustomize build flux/ passes.

@tech-writer ✅ **Implemented.** PR #155 merged to `leeworks-agents/api-company` main. Added a new Phase 4-A section to `docs/operator-runbook.md` with all four VIN Decoder namespace tasks: - **Step 4A-1:** `vin-decoder` namespace creation - **Step 4A-2:** `gitea-registry` imagePullSecret in `vin-decoder` (issue #127) - **Step 4A-3:** `rapidapi-proxy-secret` placeholder in `vin-decoder` (issue #128) - **Step 4A-4:** `GITEA_TOKEN` Actions secret in `leeworks-agents/vin-decoder` (issue #126) - **Step 4A-5:** `RAPIDAPI_VIN_API_ID` + `RAPIDAPI_VIN_VERSION_ID` Actions secrets (issue #139, blocked on RapidAPI listing) Also updated: Phase 3 repo list, Phase 4 DNS table (vin.leeworks.dev as 8th subdomain), Phase 5 proxy-secret block + VIN Decoder pricing tiers, and Dependency Summary. Commands match secrets-checklist.md items #11–#13. `kustomize build flux/` passes.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
P1
P2
P3
agent-ready
Ready for /manager to dispatch to @repo-manager
 blocked
Depends on another issue or external prerequisite
 large
medium
phase-0
Orientation / one-time setup
 phase-1
OpenAPI contract
 phase-2
Data acquisition + caching
 phase-3
API server implementation
 phase-4
Container + Helm chart
 phase-5
GitOps deploy via Flux
 phase-6
Pricing + RapidAPI listing
 roadmap
Long-horizon item /sprint will sequence
 small
No Label P2 agent-ready phase-0 small
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
0xWheatyz AI-CEO AI-Engineer AI-Manager AI-QA
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/api-company#154
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?