CompTech AIOps - tracking register

Current issues, milestones, phases, ADRs, and documentation records for the comptech-aiops effort.

This page is the public-safe tracking register for the current work. It names issues, decisions, and artifacts, but does not include secret values.

GitHub Issues

RepoIssuePurposeMilestonePhase
comptech-lab/comptech-aiops#1Establish ADR-driven change control and strict changelog.Phase 0 - Governance Foundationphase:0-foundation
comptech-lab/comptech-aiops#2Register Cloudflare token in GitHub secrets.Phase 0 - Governance Foundationphase:0-foundation
comptech-lab/comptech-aiops#3Inventory ze-tower for platform planning.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#4Provision office MinIO access and buckets.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#5Store MinIO admin details in approved local custody.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#6Record custom portal and direct model serving.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#7Record Go/Gin as portal backend framework.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#8Record React/Vite/TypeScript frontend stack.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#9Clarify ze-tower control-plane boundary.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#10Clarify cluster-resident GitOps controllers.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#11Record agent runtime architecture.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#12Record containerized control plane and network model.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#13Record Phase 1 tooling baseline and scaffold monorepo.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#14Fix validation workflow npm install path.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#15Bootstrap GitHub Actions deployment to ze-tower.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#16Configure deployment secrets and run dry-run deploy.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#17Install the ze-tower self-hosted runner.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#18Run first non-dry-run ze-tower deployment.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#19Remove legacy OpenWebUI container from ze-tower.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#20Record public blog documentation mirror ADR.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#21Define ze-tower backup and restore baseline.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#22Implement encrypted ze-tower backups and first restore drill.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#23Define Restic retention and prune policy.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#24Define office MinIO backup and replication strategy.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#25Define real service contracts for the AIOps platform.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#26Implement contract-shaped service stubs and tests.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#27Add shared service contract helpers.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#28Add Postgres-backed operational tables.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#29Wire portal API to internal service stubs.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#30Implement approval and evidence API behavior.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#31Implement orchestrator approval-wait workflow.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#32Implement RAG ingestion pipeline skeleton.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#33Implement durable RAG metadata and source object storage.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#34Build the operator portal MVP.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#35Expose the operator portal on the trusted ze-tower LAN ingress path.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#36Add deterministic RAG embeddings and Qdrant indexing.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#37Add reviewed RAG knowledge pack and retrieval evaluation fixtures.Phase 1 - Full Platform Foundationphase:1-platform-foundation
comptech-lab/comptech-aiops#38Build the first operator chat console.Phase 1 - Full Platform Foundationphase:1-platform-foundation
zeshaq/comptech-lab#1Add this comptech-aiops docs section to the blog.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#2Refresh this public-safe docs mirror from the canonical repo.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#3Publish public backup and restore baseline.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#4Publish public encrypted backup implementation status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#5Publish public Restic retention policy.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#6Publish public office MinIO backup and replication strategy.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#7Publish public AIOps service contract baseline.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#8Publish public contract-shaped service stub implementation.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#9Publish public shared service contract helper implementation.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#10Publish public Postgres operational store implementation.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#11Publish public portal internal client wiring status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#12Publish public approval and evidence API status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#13Publish public orchestrator approval-wait workflow status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#14Publish public RAG ingestion pipeline status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#15Publish public durable RAG storage status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#16Publish public operator portal MVP status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#17Publish public LAN portal exposure status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#18Publish public RAG semantic indexing status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#19Publish public RAG knowledge pack and retrieval evaluation status.CompTech AIOps Documentationphase:comptech-aiops-docs
zeshaq/comptech-lab#20Publish public operator chat console status.CompTech AIOps Documentationphase:comptech-aiops-docs

ADRs

ADRDecision
0001 - GitHub Repo As Operational MemoryUse the comptech-aiops GitHub repo as durable project memory.
0002 - Local-First RAG On ZE TowerSuperseded historical Open WebUI/Ollama RAG experiment.
0003 - ADR-Driven Change ControlRequire issue, milestone, phase, ADR, and changelog linkage for mutating work.
0004 - GitHub Secrets As Secret CustodyUse GitHub secrets as the project secret custody system until superseded.
0005 - Office MinIO For AIOps Object StorageUse office MinIO as the initial object storage backend.
0006 - Custom Portal And Direct Model ServingUse a custom portal and direct vLLM/TGI-class serving; exclude Open WebUI and Ollama.
0007 - Go Gin For Custom Portal BackendUse Go/Gin for the portal backend/API.
0008 - React Vite TypeScript For Custom Portal FrontendUse React, Vite, TypeScript, TanStack, Tailwind, and live updates.
0009 - ze-tower Control Plane And Target Infrastructure BoundaryKeep ze-tower as control plane; target infrastructure remains external.
0010 - Cluster-Resident GitOps ControllersKeep Argo CD/OpenShift GitOps inside target clusters.
0011 - Agent Runtime ArchitectureUse LangGraph, Temporal, MCP, OPA, LiteLLM, Postgres, Qdrant, and MinIO.
0012 - Containerized AIOps Control Plane On ze-towerRun the AIOps control plane as containers on ze-tower.
0013 - Docker Network Boundary ModelSegment Docker networks by ingress, app, model, observability, and target access.
0014 - Full Phase 1 Tooling BaselineDeploy the full Phase 1 control-plane tooling baseline.
0015 - GitHub Actions Deployment Bootstrap To ze-towerUse manual GitHub Actions deployment bootstrap to ze-tower.
0016 - Public Blog Documentation MirrorKeep this blog section as a public-safe mirror of the canonical repo.
0017 - ze-tower Control Plane Backup And Restore BaselineUse encrypted Restic backups in MinIO and require a restore drill before production-changing authority.
0018 - Restic Retention And Prune PolicyKeep a conservative Phase 1 snapshot set and require explicit apply mode for prune operations.
0019 - Office MinIO Backup And Replication StrategyProtect AIOps MinIO buckets by replication or export to an independent target outside the primary MinIO failure domain.
0020 - AIOps Service Contract BaselineDefine portal, orchestrator, MCP, RAG, evidence, event, and health/readiness contracts.
0021 - Postgres Operational StoreUse Postgres as the first operational store for tasks, approvals, evidence metadata, and audit records.
0022 - Orchestrator Approval-Wait WorkflowLink task enqueue, approval request, operator decision, task transition, and orchestrator resume/stop notifications.
0023 - RAG Ingestion Pipeline BaselineEstablish deterministic source ingestion, chunking, query, and citation behavior before durable RAG storage is wired.
0024 - Durable RAG Storage BaselineStore RAG source, job, and chunk metadata in Postgres and reviewed source object copies in MinIO.
0025 - Operator Portal MVPExpose safe Phase 1 workflows in the custom portal while keeping the Go/Gin portal API as the only frontend-facing boundary.
0026 - LAN Operator Portal IngressExpose only the operator portal ingress gateway on the trusted ze-tower LAN path while keeping internal services hidden.
0027 - RAG Embedding And Qdrant Indexing BaselineUse deterministic local embeddings and Qdrant as the first rebuildable semantic retrieval baseline.
0028 - Reviewed Knowledge Pack And Retrieval Evaluation BaselineTrack reviewed RAG knowledge packs and retrieval evaluation fixtures in GitHub before broad knowledge ingestion.
0029 - Operator Chat ConsoleAdd a planning-only portal chat console that creates tracked tasks, queries RAG, and shows proposed plans with citations.

Changelog Entries

DateIssueSummary
2026-05-22comptech-aiops#1Created strict governance docs, ADR process, issue/PR templates, and changelog.
2026-05-22comptech-aiops#2Registered CLOUDFLARE_API_TOKEN in GitHub secrets and documented the custody decision.
2026-05-22comptech-lab#1Created the public docs section for comptech-aiops.
2026-05-22comptech-aiops#6-#13Recorded the custom portal, frontend/backend stack, runtime architecture, network model, and Phase 1 tooling baseline.
2026-05-22comptech-aiops#15-#18Bootstrapped GitHub Actions deployment, installed the self-hosted runner, and ran the first real ze-tower deployment.
2026-05-22comptech-aiops#19Removed the legacy rag-open-webui container while preserving old data paths.
2026-05-22comptech-aiops#20Added ADR 0016 requiring public blog mirror updates or explicit skip records.
2026-05-22comptech-lab#2Refreshed this public-safe docs mirror from current canonical records.
2026-05-22comptech-aiops#21Added the ze-tower backup and restore baseline, including restore drill gate.
2026-05-22comptech-lab#3Added this public-safe backup and restore baseline page.
2026-05-22comptech-aiops#22Implemented encrypted Restic backups for ze-tower and completed the first restore drill.
2026-05-22comptech-lab#4Refreshed this public-safe backup implementation status.
2026-05-22comptech-aiops#23Defined the Restic retention and prune policy, including dry-run and apply workflow controls.
2026-05-22comptech-lab#5Refreshed this public-safe retention policy status.
2026-05-22comptech-aiops#24Defined the office MinIO backup and replication strategy.
2026-05-22comptech-lab#6Refreshed this public-safe MinIO protection status.
2026-05-22comptech-aiops#25Defined the AIOps service contract baseline.
2026-05-22comptech-lab#7Published this public-safe service contract baseline.
2026-05-22comptech-aiops#26Implemented contract-shaped service stubs and tests, then corrected ingress health routing during deployment verification.
2026-05-22comptech-lab#8Refreshed this public-safe service stub implementation and deployment verification status.
2026-05-22comptech-aiops#27Added shared service contract helpers.
2026-05-22comptech-lab#9Refreshed this public-safe shared helper implementation status.
2026-05-22comptech-aiops#28Added Postgres-backed operational tables.
2026-05-22comptech-lab#10Refreshed this public-safe operational store implementation status.
2026-05-22comptech-aiops#29Wired and deployed portal API calls to internal service stubs.
2026-05-22comptech-lab#11Refreshed this public-safe internal client wiring and deployment verification status.
2026-05-22comptech-aiops#30Implemented and deployed approval and evidence API behavior.
2026-05-22comptech-lab#12Refreshed this public-safe approval and evidence API deployment status.
2026-05-23comptech-aiops#31Implemented and deployed the first orchestrator approval-wait workflow.
2026-05-23comptech-lab#13Refreshed this public-safe approval-wait workflow deployment status.
2026-05-23comptech-aiops#32Implemented and deployed the first RAG ingestion pipeline skeleton.
2026-05-23comptech-lab#14Refreshed this public-safe RAG ingestion pipeline status.
2026-05-23comptech-aiops#33Implemented durable RAG metadata and source object storage.
2026-05-23comptech-lab#15Refreshed this public-safe durable RAG storage status.
2026-05-23comptech-aiops#34Implemented and deployed the first operator portal MVP.
2026-05-23comptech-lab#16Refreshed this public-safe operator portal MVP status.
2026-05-23comptech-aiops#35Exposed the operator portal through a single trusted-LAN ingress path.
2026-05-23comptech-lab#17Refreshed this public-safe LAN portal exposure status.
2026-05-23comptech-aiops#36Added deterministic RAG embeddings, Qdrant indexing, vector-first query, and an index rebuild endpoint.
2026-05-23comptech-lab#18Refreshed this public-safe RAG semantic indexing status.
2026-05-23comptech-aiops#37Added the first reviewed RAG knowledge pack and retrieval evaluation fixture.
2026-05-23comptech-lab#19Refreshed this public-safe RAG knowledge pack and retrieval evaluation status.
2026-05-23comptech-aiops#38Added the first operator chat console with tracked tasks, RAG citations, and planning-only proposed plans.
2026-05-23comptech-lab#20Refreshed this public-safe operator chat console status.

Current Deployment Evidence

  • Canonical commit 8893e8d implemented durable RAG storage; public mirror commit 96ce79d published the public-safe status.
  • Canonical Validate run 26306911760, blog Deploy run 26306911894, and final ze-tower Deploy run 26307228961 passed.
  • ze-tower smoke verified an s3:// RAG source object reference, Postgres-backed job and chunk reads after restarting rag-ingestion, direct RAG query citations, portal /api/v1/knowledge/query citations, and a final health check on 127.0.0.1:8080.
  • The active ze-tower GitHub environment MinIO endpoint secret was corrected to the reachable HTTPS API endpoint through GitHub Actions secret custody. No secret values are published here.
  • Canonical commit d26ceaf implemented the operator portal MVP.
  • Canonical Validate run 26308316770 and ze-tower Deploy run 26308349061 passed.
  • ze-tower smoke verified the rendered portal, readiness dependencies, a non-secret execution task, approval decision, task event history, portal-mediated RAG citation query, inventory route, evidence metadata lookup, and the standard health script.
  • Desktop and mobile browser screenshots rendered the portal successfully through an SSH tunnel to the deployed ingress.
  • Canonical commit 1008d9c exposed the portal ingress on the trusted LAN path; canonical evidence commit 3b5585e recorded the verification.
  • Public mirror commits 5b4df95 and 585019e published this status and evidence.
  • Canonical Validate runs 26309420527 and 26309600604, ze-tower Deploy runs 26309482441 and 26309633259, and blog Deploy runs 26309420781 and 26309600523 passed.
  • LAN smoke verified portal health, readiness, the placeholder operator profile, the direct browser render at desktop and mobile viewport sizes, and the remote health script against the configured LAN bind. Credentials and private raw evidence are not published here.
  • Canonical commit e45119e added deterministic local embeddings, Qdrant indexing, vector-first query with keyword fallback, and an internal index rebuild endpoint. Public mirror commit 6d3f019 published this public-safe status.
  • Canonical Validate run 26310550995, ze-tower Deploy run 26310590640, and blog Deploy run 26310550843 passed.
  • Public-safe smoke verified rag-ingestion readiness with Postgres, MinIO, Qdrant, and deterministic embeddings; a reviewed fixture reached embedding_state: indexed; direct RAG query returned a citation; the index rebuild endpoint reported indexed chunks; portal-mediated knowledge query returned citations; and the standard ze-tower health script passed.
  • Canonical commit 0f5b57f added the first reviewed phase1-control-plane knowledge pack and local retrieval evaluation fixture. Public mirror commit 9bf636e published this public-safe status.
  • Canonical Validate run 26311183879, ze-tower Deploy run 26311226062, and blog Deploy run 26311184138 passed.
  • Public-safe smoke verified LAN readiness, confirmed the synced ze-tower worktree contains the retrieval fixture and evaluator script, and ran the standard remote health script successfully.
  • Canonical commit 8091c11 added the first operator chat console. Public mirror commit 3e2947c published this public-safe status.
  • Canonical Validate run 26312411114, ze-tower Deploy run 26312451974, and blog Deploy run 26312411393 passed.
  • Public-safe smoke verified LAN readiness, a portal chat request that returned a queued tracked task, proposed planning envelope, citations, and the no-target-changing-authority note, a deployed portal browser render, and the standard remote health script.

Open Follow-Ups

  • Choose and implement the independent MinIO replication or export target from ADR 0019.
  • Replace remaining internal service stub responses with contract-compliant orchestrator and MCP gateway behavior.
  • Add target-infrastructure knowledge packs, then compare deterministic local embeddings with a model-backed embedding service after more evaluated packs exist.
  • Add evidence list/search API support for the operator portal.
  • Persist standalone chat session history after the planning-only chat console is deployed and validated.
  • Implement Temporal-backed durable orchestrator runtime behind the approval-wait contract.
  • Decide whether to archive or delete preserved legacy /srv/rag data.
  • Keep this docs section updated, reviewed without change, or explicitly skipped whenever a governed change lands.

Last reviewed: 2026-05-23