Browse Docs
Catalog
Config
Stacks
Operate
Docs

Known Gaps We Surface

watch does not mean ignore. It means the project has evidence and a named limitation, but should not present the path as solved. View source markdown.

UNOFFICIAL/EXPERIMENTAL. Some findings are not product wins yet. They are useful because they are visible, named, and backed by a receipt instead of surprising a user later.

The rule is simple:

If the path is awkward, incomplete, or unsafe by default, mark it watch or
blocked and explain the route to fix it.

Current Watch Findings

FindingWhy it mattersEvidence
Fixed placeholder credentialsA deterministic demo password is useful for repeatable renders, but it must not look like a generated production secret.default credential check
cub-direct no prunePlain apply does not delete objects removed from desired state. Argo CD and Flux remove omitted objects only when pruning is enabled; cub-direct needs a prune/delete-set path.prune gap proof
cub-direct CRD orderingA first install that applies CRDs and custom resources together can fail unless CRDs are installed and established first.CRD ordering gap
cub-scout drift field coverageDrift detection is valuable, but field coverage must be stated. The current proof catches some drift and misses container env-var drift.drift detection gap
SSA conflict ergonomicsServer-side apply can protect manual live edits by reporting a conflict, but the user needs a plain reconcile or force path.SSA conflict gap

How To Read These

blocked means the path needs a prerequisite, model change, product change, or explicit refusal before a user should rely on it.

The useful product behavior is not pretending these gaps are gone. The useful behavior is making them part of the workflow: visible before delivery, linked to evidence, and routed to the next fix.

Generated from the committed markdown file docs/user/known-gaps-we-surface.md. The source file is the authoritative version.