@lythos/cold-pool
v0.15.3
Published
Cold pool service layer — dedicated resource holder for skill repositories with intent/plan/execute primitives. Single owner of git side-effects; consumed by deck/curator/arena.
Maintainers
Readme
@lythos/cold-pool
Cold pool service layer for the lythoskill ecosystem.
Status: stable — public API
What this is
A dedicated resource-holder package for the cold pool — the local cache of
skill repositories at ~/.agents/skill-repos/ (configurable). This package
is the only layer in the ecosystem that holds git side-effects.
deck / curator / arena consume it instead of running git clone themselves.
CLI Commands
# Scan cold pool for unreferenced repos
bunx @lythos/[email protected] prune [--yes] [--dry-run]
# Validate lock file against cold pool
bunx @lythos/[email protected] validate [--lock ./skill-deck.lock]Architecture
Three layers, sharing the project's intent → plan → execute pattern
(cortex/wiki/01-patterns/2026-05-04-intent-plan-execute-fractal-architecture-pattern.md):
- Resource layer —
ColdPoolclass holds path, metadata index (MetadataDB), reconcile entry. Read-only accessors:resolveDir(),has(),list(). - Plan layer —
buildFetchPlan(coldPool, locator) → FetchPlan,buildValidationPlan(coldPool, locator) → ValidationReport,buildReconcilePlan(coldPool, desired) → ReconcilePlan. Pure data, no side effects, dry-run printable. - Execute layer —
executeFetchPlan(plan, io: FetchIO),executeReconcilePlan(plan, io: ReconcileIO). IO is injectable; defaults to real git operations. Tests swap mocks.
Locator
Per ADR-20260502012643244, locators are FQ-only:
host.tld/owner/repo[/skill]— remote skill (monorepo, flat, or arbitrary subdir)localhost/me/<skill>— local-only skill, no remote origin (host/owner/repo aligned)
Bare names and owner/repo shorthand are rejected — parseLocator returns null.
Granularity boundary
skill-deck.lock is working-set granularity (per-skill in .claude/skills/).
The cold pool reconciliation runs at repo+ref granularity (per cloned
repository at a specific commit). The two are not conflated. See
ADR-20260507021957847.
Package status
This is internal monorepo infrastructure during the 0.9.x line. Public
npm publish + stable API targeted for 0.10.0. See
EPIC-20260507020846020 for the rollout plan.
