Skip to content

Latest commit

 

History

History
55 lines (40 loc) · 2.48 KB

File metadata and controls

55 lines (40 loc) · 2.48 KB

VS Code extension (planned)

Status: planned / design note. A future surface, not yet released. It would be a thin client over the REST API or a bundled CLI — no new analysis logic.

Goal

Bring read-only analysis into the editor, where operators already read logs and edit manifests. Right-click a log, a selection, or a manifest and get ranked root causes, read-only diagnostic commands, and suggested fixes in a side panel.

Proposed features

  • Analyze file / selection — command-palette and context-menu actions that send the active file or selection to the engine.
  • Inline manifest validation — run validate on YAML/Kubernetes/Terraform files and show issues as editor diagnostics (squiggles), using ValidationIssue.line/path.
  • Explain on hover/lookup — select an error name (e.g. CrashLoopBackOff) and explain it.
  • Results panel — a webview rendering the AnalysisResult sections; diagnostic commands are copy-only (never executed) to preserve the read-only guarantee. See Security.
  • Terminal output capture — analyze the last command's output.

Proposed settings

Setting Description
devopsAi.mode cli (bundled) or api (remote endpoint)
devopsAi.apiUrl REST API base URL when in api mode
devopsAi.enrich Enable LLM enrichment
devopsAi.provider Provider name

Provider keys come from the environment / OS keychain, never stored in settings. See Configuration.

Architecture

flowchart LR
    VSC["VS Code extension"] -->|file / selection| Client["client (api or cli)"]
    Client --> Engine["AnalysisEngine<br/>(REST API or bundled CLI)"]
    Engine --> Panel["Results webview<br/>(AnalysisResult)"]
Loading

Like every surface, it adapts I/O only — the shared engine does the work, so results match the CLI, SDK, and API.

Read-only by design

Suggested diagnostic commands are shown as copyable text and never run by the extension. Fixes are presented as guidance/snippets the developer applies deliberately.

Feedback

Interested? Open an issue (see Contributing) and follow https://devopsaitoolkit.com/newsletter.