@skaile/workspaces 0.25.0 → 0.27.0

package/dist/factory-assets/skills/skaile-author-asset/SKILL.md

@@ -0,0 +1,239 @@
+---
+name: "skaile-author-asset"
+description: "Use when an asset author needs to build a skill in a local library and publish it. Covers the source/library/store model, structuring a repo into domains, the SKILL.md format, and the .skaile-source.yaml manifest (v1 glob vs v2 author-shipped inventory) and publish flow via the skaile CLI."
+metadata:
+  version: "0.1.0"
+  tags:
+    - "authoring"
+    - "skill"
+    - "library"
+    - "publish"
+    - "manifest"
+    - "domain"
+    - "ai-assets"
+    - "asset-manager"
+  stage: "alpha"
+  requires:
+    - "skill:authoring-skaile-assets"
+---
+
+# Author an AI-Asset
+
+How to author a **skill** (or any asset kind) in a local library, structure the
+repository into **domains**, write the `.skaile-source.yaml` **manifest**, and
+**publish** it through the store.
+
+For the canonical skill folder layout and frontmatter spec, read the companion
+**[authoring-skaile-assets]** skill first. This skill adds the
+library/manifest/publish lifecycle on top of it.
+
+## The three nouns
+
+Everything below maps to one of three concepts. Keep them straight:
+
+| Noun        | What it is                                                        | Holds bytes? |
+| ----------- | ----------------------------------------------------------------- | ------------ |
+| **source**  | A GitHub repo of AI-assets (yours, your team's, a third party's). | Yes          |
+| **library** | A registered place *on your machine* where you author/hold assets.| Yes          |
+| **store**   | A remote catalog of **manifests** that point at sources.          | No — pointers only |
+
+The store never hosts asset bytes. It returns a pointer triple — upstream repo
+URL + pinned commit SHA + per-file SHA256 — and the bytes are fetched directly
+from GitHub and hash-verified on install.
+
+## Asset kinds
+
+A skill is one of several discoverable kinds. Each is recognized by a filename
+glob:
+
+| Kind         | Discovery pattern                              |
+| ------------ | ---------------------------------------------- |
+| `skill`      | `**/SKILL.md`                                  |
+| `agent`      | `**/agent.yaml` or `**/AGENT.md`               |
+| `contract`   | `**/CONTRACT.md`                               |
+| `flow`       | `**/*.flow.yaml` / `**/*.flow.json`            |
+| `connector`  | `**/CONNECTOR.md`                              |
+| `prompt`     | `**/*.prompt.md`                               |
+| `preset`     | `**/*.preset.yaml`                             |
+| `mcp-server` | `**/MCP.md`                                    |
+| `knowledge`  | `**/knowledge.yaml` / `**/knowledge/index.yaml`|
+
+## 1. Create a library and scaffold the skill
+
+```bash
+# One-time: register a personal authoring library at ~/.skaile/libraries/personal
+skaile library init personal
+
+# Scaffold a new asset inside the default (or named) library
+skaile library create skill my-skill --library personal
+```
+
+Libraries live at `~/.skaile/libraries/<name>/`; the local index that tracks
+them is `~/.skaile/index.db` (SQLite — never hand-edit it).
+
+## 2. Structure: domains
+
+A **domain** is the **first-level directory** of an asset repo. It groups
+related assets and defines the publisher namespace. Lay out assets by
+`<domain>/<kind-plural>/<name>/`:
+
+```
+my-assets/                       # repo root (a "source")
+├── .skaile-source.yaml          # manifest (see §4)
+├── research/                    # DOMAIN  → publisher @research
+│   ├── DOMAIN.md                # domain description (recommended)
+│   ├── skills/
+│   │   ├── brief/SKILL.md
+│   │   └── summarize/SKILL.md
+│   ├── agents/
+│   │   └── analyst/agent.yaml
+│   └── contracts/
+│       └── brief-format/CONTRACT.md
+└── ops/                         # DOMAIN  → publisher @ops
+    └── skills/...
+```
+
+With `publisher_default: '@<domain>'` in the manifest, every asset under
+`research/` is published as `@research/<name>`. Override per-path with
+`publisher_overrides`. Use `domain-builder` to scaffold a new domain.
+
+## 3. Write the SKILL.md
+
+A skill is `SKILL.md` = YAML frontmatter + a markdown body (the body is the
+prompt injected to the LLM). Only `name` and `description` are required; all
+skaile-specific fields go inside `metadata:` per `skill-builder-contract`.
+Optional companions in the same folder: `validator.py` (deterministic
+MUST/NEVER/CHECKLIST rules), `CLI.md`, `references/`, and nested sub-skills.
+
+```yaml
+---
+name: brief
+description: Generate a concise project brief from a research question
+metadata:
+  version: "1.0.0"
+  author: skaile
+  tags: [research, brief]
+  stage: alpha          # alpha | beta | stable | deprecated
+  requires:             # cross-asset dependencies (optional)
+    - "@research/brief-format@^2"
+---
+
+# Brief
+
+## When to use
+...
+
+## How it works
+1. ...
+```
+
+Keep the body tight — it ships as a prompt.
+
+## 4. The manifest — `.skaile-source.yaml`
+
+One file at the **repo root** declares how the repo maps to publisher
+namespaces. Two modes:
+
+### v1 — glob mode (default)
+
+Discovery walks the tree, matches kind globs, and resolves publishers from the
+template. Use this while a repo is evolving fast.
+
+```yaml
+version: 1
+publisher_default: '@<domain>'   # <domain> → first-level dir name
+default_ref: main
+publisher_overrides:
+  - path: research-contracts/
+    publisher: '@research-contracts'
+```
+
+### v2 — author-shipped inventory (pinned)
+
+Add an `assets:` block and bump to `version: 2`. Discovery then treats the
+block as authoritative: it **skips the glob walk**, uses your curated `files[]`
+filter, your per-entry publisher, your `requires[]` graph, and verifies your
+`sha256`. Use this for reproducible, signed, audit-friendly releases.
+
+```yaml
+version: 2
+publisher_default: '@<domain>'
+default_ref: main
+assets:
+  - path: research/skills/brief    # relative to repo root
+    kind: skill
+    publisher: '@research'         # required per entry
+    name: brief
+    version: 1.0.0
+    sha256: "<64-hex>"             # optional locally, REQUIRED to publish
+    files:                         # explicit; no wildcards; ≥1
+      - SKILL.md
+      - validator.py
+      - references/template.md
+    requires:
+      - "@research/brief-format@^2"
+    metadata:
+      description: Generates a project brief
+      keywords: [research, brief]
+```
+
+**Never hand-edit the `assets:` block.** Generate it from the asset files (this
+is what `source-manifest-builder` automates):
+
+```bash
+skaile source build-manifest --path ./my-assets            # preview
+skaile source build-manifest --path ./my-assets --diff     # show drift (CI-friendly, non-zero on drift)
+skaile source build-manifest --path ./my-assets --write    # write the manifest
+skaile source verify-manifest --path ./my-assets --strict  # verify before commit/publish
+```
+
+Hash = sort `files[]` lexicographically, then SHA256 over
+`<relpath>\0<content>\0` per file. Author-computed hashes are wire-compatible
+with server-computed ones. Missing files are a hard error in manifest mode.
+
+## 5. Publish
+
+```bash
+# Attach a GitHub remote so the library is store-publishable
+skaile library link personal https://github.com/you/my-assets
+
+# Push bytes to GitHub + register the manifest in the store, atomically
+skaile library publish @research/brief@1.0.0
+
+# Or register a manifest for bytes already on GitHub (no push)
+skaile library register @research/brief@1.0.0
+
+# Retract a catalog entry
+skaile library yank @research/brief@1.0.0
+```
+
+Consumers then install pointer-only: `skaile install @research/brief@1.0.0`
+fetches from your repo at the pinned commit and verifies SHA256 per file.
+
+## Dev-only assets — `dev_paths` + `--dev`
+
+A package can ship two sets of assets: **public** skills its consumers want
+(conventionally under `ai-assets/`), and skills only useful for developing *the
+project itself* — scaffolders, validators, skill-on-skill tooling (under
+`ai-assets-dev/`). The dev set should be **excluded from a normal run** and
+pulled in only when a contributor opts in.
+
+- **Folder name:** keep dev assets under one top-level folder named
+  **`ai-assets-dev/`** (intention-revealing; treat the `-dev` suffix as
+  reserved).
+- **Mechanism:** declare it in `.skaile-source.yaml` under `dev_paths`:
+
+  ```yaml
+  version: 1
+  publisher_default: '@<domain>'
+  dev_paths:               # excluded from a normal discovery run
+    - ai-assets-dev
+  ```
+
+  Normal sync → `ai-assets-dev/` is skipped. `skaile source sync <name> --dev`
+  (or `skaile source add <url> --dev`) re-includes it and indexes the dev
+  assets so `manage` / `install` / `add` can see them. Re-sync without `--dev`
+  to drop them again. Matching is whole-segment, so `ai-assets-dev` excludes
+  `ai-assets-dev/…` but not a sibling like `ai-assets-development`.
+
+  Full guide: `docs/discovery/dev-assets.md`.

package/dist/factory-assets/skills/skaile-manage-workspace/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: "skaile-manage-workspace"
+description: "Use when managing a skaile workspace from the command line: init/install a project, add/remove/list/search assets, work with sources and libraries, the interactive manage TUI, patches, sessions, and catalog config. Wraps the `skaile` CLI workspace surface."
+metadata:
+  version: "0.1.0"
+  tags:
+    - "cli"
+    - "workspace"
+    - "install"
+    - "assets"
+    - "sources"
+    - "libraries"
+    - "manage"
+    - "asset-manager"
+  stage: "alpha"
+  requires:
+    - "skill:authoring-skaile-assets"
+---
+
+# Manage a Skaile Workspace
+
+How to drive a skaile **workspace** with the `skaile` CLI. A workspace is a
+project directory configured by `skaile.yaml` (team config, committed) and
+`.skaile/settings.json` (personal config, gitignored). Deployed assets are
+tracked in `.skaile/deployed.yaml`.
+
+Pass `--project-dir <path>` to any command to target a workspace other than the
+current directory.
+
+## Project lifecycle
+
+```bash
+skaile init [dir]            # initialize a workspace (writes skaile.yaml, ~/.skaile/config.yaml)
+skaile setup                 # interactive provider/model setup wizard
+skaile install               # install deps declared in skaile.yaml
+skaile install --locked      # install exactly what's pinned
+skaile check                 # report unmet requirements
+skaile clean [--all] [--dry-run]   # remove skaile-managed assets
+skaile config show|get|set <k> <v> # personal settings (driver, model, provider, apiKey.<provider>)
+skaile path                  # show resolved paths
+```
+
+`skaile config set` only accepts personal keys. Project keys (framework,
+paths, resources) live in `skaile.yaml` and are hand-edited.
+
+## Assets in a workspace
+
+`skaile <noun>` works across kinds (`skill`, `agent`, `prompt`, `flow`,
+`bundle`, `contract`); the unified verbs:
+
+```bash
+skaile add <ref> [--global]      # add to skaile.yaml + deploy
+skaile remove <ref> [--global]   # remove from skaile.yaml + undeploy
+skaile list [kind]               # list deployed assets
+skaile show <kind> <name>        # print raw asset content
+skaile search [kind] [query]     # search across all sources
+skaile info <ref>                # metadata, deps, deploy status
+skaile why <ref>                 # why is this installed (dep chain)
+skaile tree                      # dependency tree
+skaile outdated [name]           # assets behind their source
+skaile update [name]             # refresh catalog cache + re-deploy outdated
+skaile diff <ref>                # deployed vs source diff
+skaile doctor [name]             # scan for broken deps
+skaile create <name> [--kind k]  # scaffold a new asset
+skaile history [limit]           # recent actions
+```
+
+`<ref>` is `@publisher/name` optionally pinned with `@version`.
+
+### Pointer-only install from the catalog
+
+```bash
+skaile install @research/brief@1.0.0
+```
+
+Resolves the install manifest from the configured catalog, fetches file bytes
+directly from the upstream GitHub source at the pinned commit, verifies per-file
++ composite SHA256, and records the instance.
+
+## The manage TUI
+
+```bash
+skaile manage
+```
+
+Interactive terminal UI. Tabs: **Assets** (browse + queue install/remove,
+grouped by source and nested domain folder), **Sources**, **Libraries**,
+**Pending** (staged changes), **Sync**. Keys: `↑↓`/`jk` navigate,
+`←/→` collapse/expand, `space`/`+`/`-` select, `a`/`Enter` apply, `s` sync,
+`i` info, `Tab` switch view, `q`/`Esc` quit.
+
+## Sources (third-party / team repos)
+
+```bash
+skaile source add <git-url>      # clone + register a github source (~/.skaile/sources/<name>)
+skaile source list               # registered sources
+skaile source show <name>
+skaile source remove <name>
+skaile source sync [name]        # re-fetch upstream changes
+skaile source build-manifest --path <p> [--diff|--write]   # author-shipped inventory
+skaile source verify-manifest --path <p> --strict
+```
+
+## Libraries (your authoring places)
+
+```bash
+skaile library init <name>             # create ~/.skaile/libraries/<name>
+skaile library link <name> <git-url>   # attach a github remote (makes it publishable)
+skaile library create <kind> <name>    # scaffold a new asset
+skaile library list|status|show <name>
+skaile library default <name>          # set default
+skaile library commit|pull|push|sync <name>   # git ops
+skaile library publish <ref>           # push + register manifest atomically
+```
+
+See the `skaile-author-asset` skill for the full authoring + publish flow.
+
+## Patches (edit an installed asset, contribute back)
+
+```bash
+skaile patch extract <ref>   # extract asset for local editing
+skaile patch commit <ref>    # generate a .patch file
+skaile patch submit <ref>    # apply to source repo + prepare a PR
+skaile patch remove <ref>    # remove after upstream merge
+```
+
+## Running & sessions
+
+```bash
+skaile run <flow-or-text>    # run a flow, or send a one-shot prompt
+skaile repl                  # interactive agent REPL
+skaile resume                # resume last session
+skaile serve                 # start the WebSocket agent server
+skaile session list|show|switch|delete <run-id>
+skaile session logs <session-id>    # structured debug logs (local SQLite or remote tRPC)
+skaile status                # current session state
+skaile logs [--follow] [--filter]   # tail container logs
+```
+
+## Catalog config
+
+Machine-global config lives at `~/.skaile/config.yaml`:
+
+```yaml
+catalog:
+  url: "https://skaile.store"   # or "local" to disable remote resolution
+  framing: "trpc"               # "trpc" (skaile.store) or "rest" (forge-store)
+  cache_ttl: 86400              # seconds; 0 = air-gapped
+```
+
+`skaile init` bootstraps it with defaults. A project `skaile.yaml` can override
+catalog settings per-workspace.
+
+## Dev-only assets
+
+A source can mark assets meant only for developing the project itself (those
+under `ai-assets-dev/`) as dev-only via `dev_paths` in its `.skaile-source.yaml`.
+A normal sync excludes them; `--dev` on the sync re-includes them:
+
+```bash
+skaile source sync <name> --dev   # index dev_paths assets into the catalog
+skaile source add <url> --dev     # clone + index including dev assets
+```
+
+Once indexed with `--dev`, the dev assets show up in `manage` / `install` /
+`add` like any other. Re-sync without `--dev` to drop them. See the
+`skaile-author-asset` skill and `docs/discovery/dev-assets.md` for the
+folder-naming and `dev_paths:` convention.

package/dist/{flows-DYFTPCPM.js → flows-L3GHQD7F.js}

@@ -1,7 +1,7 @@
-export { flowFindFlowForSession, flowGetSession, flowList, flowListSessions, flowShow } from './chunk-2XY6732A.js';
-import './chunk-HK5FRWG6.js';
+export { flowFindFlowForSession, flowGetSession, flowList, flowListSessions, flowShow } from './chunk-UIZKIUC6.js';
 import './chunk-XCBG2KDC.js';
+import './chunk-HK5FRWG6.js';
 import './chunk-X5YPJV4N.js';
 import './chunk-NSBPE2FW.js';
-//# sourceMappingURL=flows-DYFTPCPM.js.map
-//# sourceMappingURL=flows-DYFTPCPM.js.map
+//# sourceMappingURL=flows-L3GHQD7F.js.map
+//# sourceMappingURL=flows-L3GHQD7F.js.map

package/dist/{flows-DYFTPCPM.js.map → flows-L3GHQD7F.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"flows-DYFTPCPM.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"flows-L3GHQD7F.js"}

package/dist/helpers-F4NZ66VD.js

@@ -0,0 +1,4 @@
+export { KIND_COL_WIDTH, S, colorRef, fitWidth, formatRelativeTime, kindColor, kindColorPad, logErr, logInfo, logOk, logWarn } from './chunk-GYPA2Q7F.js';
+import './chunk-NSBPE2FW.js';
+//# sourceMappingURL=helpers-F4NZ66VD.js.map
+//# sourceMappingURL=helpers-F4NZ66VD.js.map

package/dist/{helpers-LTN3HMD3.js.map → helpers-F4NZ66VD.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"helpers-LTN3HMD3.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"helpers-F4NZ66VD.js"}

package/dist/library/index.js

@@ -1,18 +1,20 @@
-export { CatalogCache, CatalogConfigSchema, CatalogHttpError, DuplicateLibraryNameError, DuplicateSubscriptionError, GitSyncDriver, InstanceHasConsumersError, InstanceNotFoundError, InterpolationError, KNOWN_ASSET_KINDS, KnowledgeManifestSchema, LIBRARY_BACKENDS, LIBRARY_OWNERSHIPS, LIBRARY_STRUCTURES, LOCAL_CATALOG_URL, LibraryConfigSchema, LibraryError, LibraryInstanceRefSchema, LibraryManager, LibrarySectionSchema, LibrarySyncError, LocalCatalogSource, LocalIndex, LocalSyncDriver, LockFileSchema, LockSubscriptionSchema, OfflineError, OperationNotPermittedError, PIN_POLICIES, PinPolicySchema, PresetAppliedSchema, PresetExpandedSchema, RemoteCatalogSource, RequiresEdgeSchema, RestCatalogSource, SidecarGit, SkaileConfigSchema, SourceNotFoundError, SubscriptionNotFoundError, TarballHashMismatchError, UserLibraryNotFoundError, WorkspaceConfigV2Schema, applyNonStructuralUpgrade, applyPreset, applyPresetFromData, classifyRef, createEmptyLockFile, deriveSlug, detectChanges, detectNestedPresetRefs, detectWorkspaceVersion, evaluateUpgrade, extractLibraryInstanceId, extractReferencedKeys, filterKey, getConfigDefaults, getDefaultValue, getSidecarRoot, getStoreManifestsDir, getStoreRoot, hasInterpolationTokens, installFromManifest, interpolate, isLocalCatalogUrl, isSecretPlaceholder, knowledgeKindProvider, listSidecarSlugsOnDisk, loadLockFile, loadWorkspaceV2, migrateSidecarsToStoreIfNeeded, migrateWorkspaceConfig, parsePreset, parsePresetYaml, parseWorkspaceV2, projectConfigPath, queryInstancePickerChoices, resolveAllItems, resolveConfig, resolveIndexPath, resolveItem, resolveLibraryDir, resolvePin, resolveSidecarPaths, saveConfig, saveLockFile, saveWorkspaceV2, sha256Hex, skaileHomeDir, storeSecrets, trpcGetUrl, userConfigPath, validateAllPlaceholders, validateKnowledge, validateNestingDepth, validatePlaceholder, writeManifestIfMissing } from '../chunk-DCAWIRD6.js';
+export { CatalogCache, CatalogConfigSchema, CatalogHttpError, DuplicateLibraryNameError, DuplicateSubscriptionError, GitSyncDriver, InstanceHasConsumersError, InstanceNotFoundError, InterpolationError, KNOWN_ASSET_KINDS, KnowledgeManifestSchema, LIBRARY_BACKENDS, LIBRARY_OWNERSHIPS, LIBRARY_STRUCTURES, LOCAL_CATALOG_URL, LibraryConfigSchema, LibraryError, LibraryInstanceRefSchema, LibraryManager, LibrarySectionSchema, LibrarySyncError, LocalCatalogSource, LocalIndex, LocalSyncDriver, LockFileSchema, LockSubscriptionSchema, OfflineError, OperationNotPermittedError, PIN_POLICIES, PinPolicySchema, PresetAppliedSchema, PresetExpandedSchema, RemoteCatalogSource, RequiresEdgeSchema, RestCatalogSource, SidecarGit, SkaileConfigSchema, SourceNotFoundError, SubscriptionNotFoundError, TarballHashMismatchError, UserLibraryNotFoundError, WorkspaceConfigV2Schema, applyNonStructuralUpgrade, applyPreset, applyPresetFromData, classifyRef, createEmptyLockFile, deriveSlug, detectChanges, detectNestedPresetRefs, detectWorkspaceVersion, evaluateUpgrade, extractLibraryInstanceId, extractReferencedKeys, filterKey, getConfigDefaults, getDefaultValue, getSidecarRoot, getStoreManifestsDir, getStoreRoot, hasInterpolationTokens, interpolate, isLocalCatalogUrl, isSecretPlaceholder, knowledgeKindProvider, listSidecarSlugsOnDisk, loadLockFile, loadWorkspaceV2, migrateSidecarsToStoreIfNeeded, migrateWorkspaceConfig, parsePreset, parsePresetYaml, parseWorkspaceV2, projectConfigPath, queryInstancePickerChoices, resolveAllItems, resolveConfig, resolveIndexPath, resolveItem, resolveLibraryDir, resolvePin, resolveSidecarPaths, saveConfig, saveLockFile, saveWorkspaceV2, sha256Hex, skaileHomeDir, storeSecrets, trpcGetUrl, userConfigPath, validateAllPlaceholders, validateKnowledge, validateNestingDepth, validatePlaceholder, writeManifestIfMissing } from '../chunk-WRRYESHC.js';
+import '../chunk-JIQLLZ65.js';
+export { installFromManifest } from '../chunk-Z3XXKR5E.js';
 export { GITHUB_PAT_ENV, fetchAssetFilesFromGitHub } from '../chunk-R7FOF242.js';
-import '../chunk-KT3CK26V.js';
 import '../chunk-OKRUTSG7.js';
-import '../chunk-XVL22AWE.js';
-import '../chunk-K5GBV4SA.js';
-import '../chunk-KLNL7QHN.js';
-import '../chunk-UD4ZLXGS.js';
-import '../chunk-3QTZWPGH.js';
-import '../chunk-GL45UNVS.js';
-import '../chunk-WIAHJOMG.js';
+import '../chunk-M4KLIEIJ.js';
+import '../chunk-FWHOU3CX.js';
+import '../chunk-3QQSSRYN.js';
+import '../chunk-IERB3UXJ.js';
+import '../chunk-2FS4FPZ7.js';
+import '../chunk-IEJ5IOC3.js';
 import '../chunk-JKNWJ64A.js';
 import '../chunk-O4JH3KUE.js';
+import '../chunk-K5GBV4SA.js';
+import '../chunk-ZAP2BDHG.js';
 import '../chunk-24UIWON4.js';
-import '../chunk-NELZIQ2E.js';
+import '../chunk-QDJKE557.js';
 import '../chunk-NSBPE2FW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/library/install.d.ts

@@ -0,0 +1,2 @@
+// Auto-generated by _scripts/emit-dts-sidecars.ts — do not edit by hand.
+export * from "./src/install/index.js";

package/dist/library/install.js

@@ -0,0 +1,16 @@
+export { installFromManifest } from '../chunk-Z3XXKR5E.js';
+export { GITHUB_PAT_ENV, fetchAssetFilesFromGitHub } from '../chunk-R7FOF242.js';
+import '../chunk-M4KLIEIJ.js';
+import '../chunk-FWHOU3CX.js';
+import '../chunk-3QQSSRYN.js';
+import '../chunk-IERB3UXJ.js';
+import '../chunk-2FS4FPZ7.js';
+import '../chunk-IEJ5IOC3.js';
+import '../chunk-JKNWJ64A.js';
+import '../chunk-O4JH3KUE.js';
+import '../chunk-K5GBV4SA.js';
+import '../chunk-ZAP2BDHG.js';
+import '../chunk-24UIWON4.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=install.js.map
+//# sourceMappingURL=install.js.map

package/dist/library/install.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"install.js"}

package/dist/library/src/install/index.d.ts

@@ -0,0 +1,3 @@
+export { installFromManifest, type AssetFetcher, type InstallOpts, type InstallResult, } from "./install-from-manifest.js";
+export { GITHUB_PAT_ENV, fetchAssetFilesFromGitHub, type FetchOpts, } from "./source-fetch-github.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/library/src/install/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../library/src/install/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,KAAK,SAAS,GACf,MAAM,0BAA0B,CAAC"}

package/dist/library/src/library.d.ts

@@ -187,6 +187,8 @@ export interface UpdateInstanceInput {
  * @docLink packages/library/concepts#instance
  */
 export interface InstanceFilter {
+    /** Filter to a specific asset kind. */
+    kind?: AssetKind;
     /** Filter by asset definition ref. */
     defRef?: string;
     /** Filter by pin policy. */

package/dist/library/src/library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../library/src/library.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../library/src/library.ts"],"names":[],"mappings":"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"}

package/dist/library/src/local/library.d.ts

@@ -118,6 +118,8 @@ export declare class LocalIndex implements IAssetIndex {
     }>;
     getInstance(id: string): Promise<Instance | null>;
     listInstances(filter?: InstanceFilter): Promise<Instance[]>;
+    /** Map every cached asset def's version-stripped ref base to its kind. */
+    private buildInstanceKindMap;
     updateInstance(id: string, patch: UpdateInstanceInput): Promise<Instance>;
     deleteInstance(id: string, opts?: {
         cascade?: boolean;

package/dist/library/src/local/library.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../../library/src/local/library.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../../../library/src/local/library.ts"],"names":[],"mappings":"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"}

package/dist/library/src/local/local-catalog-source.d.ts

@@ -21,7 +21,7 @@ export interface LocalCatalogSourceOptions {
     /**
      * Absolute path to a sidecar directory carrying a local-overlay manifest
      * (`~/.skaile/sources/<slug>/`). When set, discovery merges the sidecar's
-     * `.skaile-source.yaml` on top of the in-repo config before dispatch.
+     * `skaile.manifest.yaml` on top of the in-repo config before dispatch.
      *
      * Typically populated by `openLibrary()`-based callers reading
      * `source.sidecarPath` from the registered source row.
@@ -47,6 +47,7 @@ export declare class LocalCatalogSource implements ICatalogSource {
     constructor(library: LocalIndex, sourceId: string, rootPath: string, registry?: IAssetKindRegistry | undefined, options?: LocalCatalogSourceOptions);
     resolve(ref: string): Promise<CatalogAsset | null>;
     listAssets(filter?: CatalogAssetFilter): Promise<CatalogAsset[]>;
+    listVersions(ref: string): Promise<string[]>;
     fetchTarball(_ref: string, _sha256: string): Promise<Uint8Array>;
     listSources(): Promise<CatalogSourceInfo[]>;
     /**

package/dist/library/src/local/local-catalog-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-catalog-source.d.ts","sourceRoot":"","sources":["../../../../library/src/local/local-catalog-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAKrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAP5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAGnB,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,kBAAkB,YAAA,EAC9C,OAAO,CAAC,EAAE,yBAAyB;IAM/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMlD,UAAU,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUhE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMhE,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIjD;;;;;;;;;;OAUG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAwD9E"}
+{"version":3,"file":"local-catalog-source.d.ts","sourceRoot":"","sources":["../../../../library/src/local/local-catalog-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAKrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAP5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAGnB,OAAO,EAAE,UAAU,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,kBAAkB,YAAA,EAC9C,OAAO,CAAC,EAAE,yBAAyB;IAM/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAMlD,UAAU,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUhE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB5C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMhE,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIjD;;;;;;;;;;OAUG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAwD9E"}

package/dist/library/src/local/sidecar-paths.d.ts

@@ -3,7 +3,7 @@
  *
  * `~/.skaile/sources/` is a single git repo containing one subdirectory per
  * registered sidecar. Each subdirectory carries the local-overlay manifest
- * (`.skaile-source.yaml`), a provenance README, and a lock file.
+ * (`skaile.manifest.yaml`), a provenance README, and a lock file.
  *
  * Path resolution honors the `SKAILE_HOME` env var (defaults to `~/.skaile`)
  * mirroring the style used by `SKAILE_LIBRARIES_DIR` (which already overrides
@@ -24,11 +24,11 @@ export interface SidecarPaths {
     rootDir: string;
     /** Per-source sidecar dir: `<rootDir>/<slug>`. */
     sidecarDir: string;
-    /** Manifest file: `<sidecarDir>/.skaile-source.yaml`. */
+    /** Manifest file: `<sidecarDir>/skaile.manifest.yaml`. */
     manifestFile: string;
     /** Provenance README: `<sidecarDir>/README.md`. */
     readmeFile: string;
-    /** Lock file: `<sidecarDir>/.skaile-source.lock.json`. */
+    /** Lock file: `<sidecarDir>/skaile.manifest.lock.json`. */
     lockFile: string;
 }
 /**
@@ -58,7 +58,7 @@ export declare function resolveSidecarPaths(slug: string): SidecarPaths;
  * collision resolution against the set of slugs already in use.
  *
  * Derivation order (per PR-3 § D.1):
- *   1. `name:` field of the upstream `.skaile-source.yaml` (if non-empty)
+ *   1. `name:` field of the upstream source config (if non-empty)
  *   2. `path.basename(sourcePath)` (fallback)
  *
  * Collision suffix: `-2`, `-3`, ... appended until unique against

package/dist/library/src/local/sidecar-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar-paths.d.ts","sourceRoot":"","sources":["../../../../library/src/local/sidecar-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAMjE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAU9D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,EAC7C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC9B,MAAM,CAoBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAUjD"}
+{"version":3,"file":"sidecar-paths.d.ts","sourceRoot":"","sources":["../../../../library/src/local/sidecar-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAMjE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAU9D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,EAC7C,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC9B,MAAM,CAoBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAUjD"}

package/dist/library/src/local/store-paths.d.ts

@@ -27,9 +27,10 @@ export declare function getStoreRoot(): string;
 /** Manifests subdir: `<store>/manifests/`. */
 export declare function getStoreManifestsDir(): string;
 /**
- * Move every `~/.skaile/sources/<slug>/.skaile-source.yaml` into
- * `~/.skaile/store/manifests/<slug>.yaml`, initialise the store as a git
- * repo, and write a marker so the migration is a no-op on subsequent runs.
+ * Move every `~/.skaile/sources/<slug>/skaile.manifest.yaml` (or the legacy
+ * `.skaile-source.yaml` for sidecars minted before the file-split rename) into
+ * `~/.skaile/store/manifests/<slug>.yaml`, initialise the store as a git repo,
+ * and write a marker so the migration is a no-op on subsequent runs.
  *
  * Idempotent. Cheap to call (single `existsSync` for the marker on the hot
  * path). Errors are swallowed and logged to stderr — a partial migration