Files
sam f6ee43bf55 feat(store): project installed package contributions into org resources
An install that stayed in installed_packages left every contribution
unprojected: nothing made a package's workflow a usable org resource, and
nothing stopped it on removal. This lands projection for the workflow family,
the one kind whose org resource, validation and live read path all exist:

- storepkg.Service gains Projections (family -> projector): install resolves
  each projected family's contributed names against the fetched
  layer (FilesFromLayer), applies them, and on failure withdraws and removes
  the half installation; remove withdraws before the record goes, so a failed
  withdrawal keeps the package installed and usable.
- controlplane.WorkflowProjector merges the package's entries into the org's
  workflow-definitions document — the same document the daemon's
  WorkflowDefinitions client reads per dispatch, so a projected workflow is
  usable at the next dispatch and a withdrawn one stops dispatching, without
  restarts. A contributed id displacing an operator's own workflow is refused
  (storepkg.ErrContributionCollision), never silently replaced.
- installed_package_contributions (migration 0023) records the entries a
  package projected, so removal takes exactly its own contributions out.
- stateStoreDeps wires the projector set on the State Store's pool; the
  composition is pinned by the live round-trip test over a real gRPC
  connection.

Prompts, skills, MCP server definitions and default settings remain
unprojected: their contribution formats are not settled by docs/prds/store.md
and are left for their own slices rather than half-wired here.
2026-09-30 08:05:22 +10:00

46 lines
1.2 KiB
Go

package storepkg
import (
"archive/tar"
"bytes"
"compress/gzip"
"errors"
"fmt"
"io"
)
// FilesFromLayer reads an installed package's layer into its files, keyed by
// path. The fetch already validated the layer against Descriptor.Files and
// held it within the package size limit; this recovers the content the
// contributed names point at, plain or gzipped, whichever the package shipped.
func FilesFromLayer(layer []byte) (map[string][]byte, error) {
reader := io.Reader(bytes.NewReader(layer))
if len(layer) >= 2 && layer[0] == 0x1f && layer[1] == 0x8b {
gz, err := gzip.NewReader(reader)
if err != nil {
return nil, fmt.Errorf("read package layer: %w", err)
}
defer func() { _ = gz.Close() }()
reader = gz
}
files := map[string][]byte{}
tarReader := tar.NewReader(reader)
for {
header, err := tarReader.Next()
if errors.Is(err, io.EOF) {
return files, nil
}
if err != nil {
return nil, fmt.Errorf("read package layer: %w", err)
}
if header.Typeflag != tar.TypeReg {
continue
}
content, err := io.ReadAll(tarReader)
if err != nil {
return nil, fmt.Errorf("read package file %q: %w", header.Name, err)
}
files[header.Name] = content
}
}