Skip to content

docs(research): full research set — use-case & shape, market/form-factor, identity, integrations - #16

Closed
gnanirahulnutakki wants to merge 1 commit into
mainfrom
docs/research
Closed

docs(research): full research set — use-case & shape, market/form-factor, identity, integrations#16
gnanirahulnutakki wants to merge 1 commit into
mainfrom
docs/research

Conversation

@gnanirahulnutakki

Copy link
Copy Markdown
Member

What this is

The complete research set answering: what should Sith be so DevOps/Platform/SRE/MLOps engineers reach for it by default, and what form should it take? Four cited reports under docs/research/, salvaged and synthesised from a research pass across five workstreams (identity/connections/security, connectors/MCP/AI-governance, global+China+India pains, tool/cost landscape, and form factor/DX). Every load-bearing claim carries a primary-source URL; devops-portal is treated as lessons-learned, not a template.

File Covers
USE-CASE-AND-SHAPE.md The synthesis — executive answer, form factor, prioritized roadmap, carry/discard/net-new, plan edits
market-and-form-factor.md Pains (global/China/India), the Lens/form-factor story, the OSS+paid tool landscape, cost, multi-cloud
identity-connections-security.md Four connection modes, brokered-access prior art, short-lived creds, custody, supply-chain/audit bar
integrations-and-ai-governance.md Connector-framework design, per-tool integration surfaces, MCP state, the governed-agent white space

The one-paragraph answer

Sith should be the tool an engineer reaches for the moment they operate more than one Kubernetes cluster — first as a fast local client that shows their whole fleet from the kubeconfigs already on their laptop, then, for a team, as a self-hosted control plane that lets many operators and their AI agents see and act across that fleet without anyone holding standing admin credentials. It is one product with two faces on one shared engine: a single-user local "fleet IDE" that installs in one command with no account, no server, and no telemetry; and a self-hosted hub that federates the same fleet over outbound-only OCM minions, gates every write through an external policy decision point (Ardur), and records who did what and why. The position Sith owns is governed action across a fleet — typed, signed, approval-gated cluster operations applied identically to humans and to AI agents, which the research found empty across every incumbent. The thing that gets it adopted is the local mode, because the one empty OSS slot is a no-account, no-telemetry, aggregated multi-cluster client (k9s is one-context-at-a-time; Headlamp is per-cluster-centric; Lens has an account wall; the only tool that aggregates clusters, Aptakube, is closed and paid), and every install is a hub candidate.

Recommended form factor

One Go binary, one embedded web frontend, three run modes: sith (CLI), sith ui (local single-user fleet IDE, kubeconfig-direct, no account/telemetry), sith hub (the same UI served multi-user with OCM minions + governance). Cache-first render from a local informer/watch cache (never spinner-first). Tauri desktop shell — not Electron — as a fast-follow. The local mode's centre of gravity is the fleet (aggregation, cross-cluster correlation, staleness), not the pod — it is not another single-cluster console.

Prioritized roadmap (anti-sprawl)

  • Wedge: local fleet-IDE mode · source-agnostic read federation + cross-cluster correlation · minions + multi-auth · governance spine (Workspace/RLS/signed-token authz/audit+decision ledger) day one · first governed write gitops.open-pr via Ardur · no-god-key custody + cosign/SLSA-L2/SBOM.
  • Fast-follow: governed MCP server (Claude/Codex compatibility) · policy federation (waves/multi-approver/abstention + live-mutation verbs) · connector framework (out-of-process gRPC, 3 fixed kinds) generalizing the day-1 six (Argo CD/Flux/Helm/Prometheus/Loki/GitHub) · cost read-overlay (OpenCost rollup + GPU columns) · multi-cloud enum/cred-mint incl. ACK/CCE/TKE · air-gap/multi-arch packaging · Tauri shell.
  • Later: long-tail read connectors (Datadog/Splunk/Elastic/Terraform) · ITSM typed actions (Jira/Zendesk) · Sith as MCP client · governing LangChain/LangGraph agents (as MCP clients of Sith) · OpenShift-specific views.
  • Explicitly not now: tool-UI re-skinning/proxying · telemetry lake · metering/optimization engine · agent-orchestration framework · IDP/portal/scorecards/DORA · GitOps reconciler · scheduler · Fluentd/Fluent-bit as sources · exec/free-form apply/Secret/RBAC mutation · running SPIRE.

Concrete plan edits (in USE-CASE-AND-SHAPE.md §6)

  • SCOPE (the key edit): refine "single-cluster console — out of scope" to "another single-cluster console," and add in-scope "aggregated multi-cluster local fleet client (the adoption on-ramp)." This resolves the apparent contradiction with the "Lens IDE better than Lens" ask.
  • CHARTER: two wedges (adoption = local client; durable = governed action federation), individual operator as top-of-funnel, an adoption success criterion.
  • ARCHITECTURE: three run-modes, source-abstract read federation (local kubeconfig or OCM spoke), four-mode identity model, connector framework, cost overlay, cosign/SLSA/SBOM, SPIFFE-without-SPIRE.
  • ROADMAP/EPICS: early local-mode track on the P1 engine; new epics E11 (local fleet client), E12 (connector framework), E13 (cost overlay); amend E2 (local source), E9 (multi-arch/air-gap/signing), E7/E8.

Notes for the reviewer

…ntity, integrations

Salvage and synthesis of the research pass (workstreams A–E). Four cited
reports under docs/research/:

- USE-CASE-AND-SHAPE.md — synthesis: executive answer, recommended form factor,
  a ruthlessly prioritized capability roadmap (wedge / fast-follow / later /
  not-now), a carry/discard/net-new table vs devops-portal, and concrete
  CHARTER/ARCHITECTURE/ROADMAP/EPICS edits.
- market-and-form-factor.md — practitioner pains (global, China, India), the
  Lens/form-factor story, the OSS-and-paid tool landscape, cost, and multi-cloud
  (workstreams A/B/C/F/G).
- identity-connections-security.md — the four connection modes, brokered-access
  prior art, short-lived-credential consensus, custody, and the
  supply-chain/audit bar (workstream D).
- integrations-and-ai-governance.md — connector-framework design, per-tool
  integration surfaces, MCP protocol state, and the governed-agent white space
  (workstream E).

Every load-bearing claim carries a primary-source URL.
@gnanirahulnutakki

Copy link
Copy Markdown
Member Author

Superseded by the tested dev-to-main Slice 0 release PR #51. The consolidated planning/research content and runnable foundation are now on main at 08c1f9b.

@gnanirahulnutakki
gnanirahulnutakki deleted the docs/research branch July 10, 2026 19:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant