Package manager panel

Platform spec feature

Package manager panel

Back to VS Code extension ◎ Open in platform map

Spec standingStandard

Owner

Piotr Mikstacki pmikstacki@cybernomad.it

Submitter

Piotr Mikstacki pmikstacki@cybernomad.it

Current document

ADRs (2)

1. 0001-single-pckg-client-boundary pckgClient boundary Accepted

   pckgClient boundary

   Context

   HTTP scatter.

   Decision

   HTTP via pckgClient.ts only.

   Consequences

   Shared auth.

   Verification anchors

   Grep fetch in packages/.

   Open full ADR page

2. 0002-cli-for-lock-mutations CLI for lock Accepted

   CLI for lock

   Context

   Lock integrity.

   Decision

   Use beskid fetch/lock via CLI.

   Consequences

   Shared resolver.

   Verification anchors

   Panel CLI invocations.

   Open full ADR page

Articles

• Contracts and edge cases pckgClient HTTP rules, authentication, caching, and package command contracts. article Standard Reviewed Thu May 21
• Decisions record (legacy index) Migration index for package manager panel ADRs. article Standard Reviewed Fri May 22
• Design model PackageTreeItem sections, pckgClient surface, cache keys, and Packages view chrome. article Standard Reviewed Thu May 21
• Examples Corelib locked dependencies and registry search in the Packages view. article Standard Reviewed Thu May 21
• Flow and algorithm Package search, details expansion, fetch/lock, and focus-driven refresh sequences. article Standard Reviewed Thu May 21

History

0 revisions (git unavailable at build; counts may be empty)

Open full history on GitHub

No commits recorded for this path.

Completeness

OKfeature · 5 SpecSection(s) · 0 H2 heading(s)

Section id	Required	Found
what-this-feature-specifies	yes	yes
implementation-anchors	yes	yes

Full tree: run pnpm verify:platform-spec-layout (writes src/generated/platform-spec-layout-report.json).

Related spec docs

• Area
  VS Code extension

  Parent area

• Feature
  pckg client contract

  HTTP shapes

• Feature
  Extension surface

  Commands and status bar

What this feature specifies

Packages activity-bar view: local dependency listing and registry browse/search with cached pckg HTTP and CLI fetch/lock.

Implementation anchors

• beskid_vscode/src/packages/pckgClient.ts, PackageManagerProvider.ts
• beskid_vscode/src/cli/beskidCliRunner.ts
• pckg/src/Server/Features/Packages/Contracts.cs

Contract statement

The package manager panel (beskidPackagesView) provides two persistent sections: This project (declared + Project.lock entries from LSP) and Registry search (debounced pckg HTTP with TTL cache). Lock/fetch mutations run through the Beskid CLI (beskid fetch, beskid lock) with progress on the shared status bar.

Inputs and outputs

API	Endpoint / command
Search	GET /api/search?q=&limit=
Details	GET /api/packages/{name}
Local deps	beskid.getProjectDependencies
Fetch / lock	beskid fetch, beskid lock (CLI, --project cwd = focused project root)

Registry base URL resolution order: workspace default registry from beskid.getWorkspaceSummary → beskid.pckg.baseUrl → http://localhost:5000.

Decisions

No open decisions. D-TOOL-VSC-0001 (pckgClient boundary), 0002 (CLI for fetch/lock)—see adr/ and the ADRs tab.

Articles

• pckgClient boundarypckgClient boundary
• Contracts and edge casespckgClient HTTP rules, authentication, caching, and package command contracts.
• Decisions record (legacy index)Migration index for package manager panel ADRs.
• Design modelPackageTreeItem sections, pckgClient surface, cache keys, and Packages view chrome.
• ExamplesCorelib locked dependencies and registry search in the Packages view.
• Flow and algorithmPackage search, details expansion, fetch/lock, and focus-driven refresh sequences.