@skaile/workspaces 6.14.0 → 6.16.0

package/dist/asset-manager/src/config/core.d.ts

@@ -0,0 +1,297 @@
+import { type AiComponent, type HarnessName, type LockFile, type LockFileEntry, type SourceClone, type StoreFetcher } from "@skaile/workspaces/core";
+import { type AssetFetcher } from "@skaile/workspaces/library";
+import type { IAssetKindRegistry } from "@skaile/workspaces/plugins";
+import { type DeployOptions } from "../installer.js";
+import type { StoreNotChecked } from "../shared/types.js";
+/** A source whose origin `outdated` could not fetch, so its behind count was not checked (p1820). */
+export interface UnreachableSource {
+    /** Short name of the source (`<owner>/<repo>` of its URL). */
+    name: string;
+    url: string;
+    /** One line why: the fetch error, or why the clone was not compared with its origin at all. */
+    reason: string;
+    /** Set when no fetch was tried: the clone's origin is another repository, or it holds no git checkout. */
+    notCompared?: true;
+}
+/**
+ * Options for constructing an {@link AssetManager}.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface AssetManagerOptions {
+    /** Absolute or relative path to the workspace root (must contain `skaile.yaml`). */
+    projectDir: string;
+    /**
+     * The process's asset-kind registry — the only authority on which kinds exist.
+     * Typed frontmatter whose `type:` is not registered is reported, not catalogued.
+     */
+    registry: IAssetKindRegistry;
+    /**
+     * Agent framework to target for asset deployment.
+     * Determines which framework directories (``.claude/``, ``.omp/``, etc.) are used.
+     * Defaults to the harness the project is configured for (`skaile.yaml`
+     * `agent-config.default.harness`, `.skaile/settings.json`), else `"claude-code"`.
+     */
+    harness?: HarnessName;
+    /**
+     * When `true`, the manager operates in **global cross-harness** mode: config
+     * SSOT, lock, cache, and history root at `~/.skaile` (not the project), the
+     * `dependencies:` manifest edits target `~/.skaile/skaile.yaml`, and deploy
+     * fans out to every harness in {@link harnesses}. When `false` (default),
+     * everything is project-scoped against the single {@link harness}.
+     */
+    global?: boolean;
+    /**
+     * Global-mode harness set the deploy fans out to. When omitted in global mode,
+     * resolved from `~/.skaile/skaile.yaml` `global_harnesses:` else auto-detection
+     * (`resolveGlobalHarnesses`). Ignored in project mode. A `--harness` filter
+     * narrows this to a subset.
+     */
+    harnesses?: HarnessName[];
+    /** @deprecated Use `harnesses`. Honoured only when `harnesses` is absent; removed in the next major. */
+    backends?: HarnessName[];
+    /**
+     * Catalog read-protocol fetcher used to resolve store-published assets. When
+     * omitted, one is built per call from the configured stores
+     * (`RemoteCatalogSource`). Injected mainly by tests to stay network-free.
+     */
+    storeFetcher?: StoreFetcher;
+    /**
+     * Byte fetcher used to fetch a store asset's files at its pinned commit before
+     * deploy. When omitted, the production GitHub fetcher is used. Injected by
+     * tests to stay network-free.
+     */
+    assetFetcher?: AssetFetcher;
+    /**
+     * Overrides the global `catalog.url` used as a store fallback when the project
+     * declares no `stores:`. `"local"` disables the fallback; project `stores:` are
+     * still asked. `""` (`update --no-catalog`) asks no store at all, project `stores:`
+     * included. When omitted, the URL is read from `~/.skaile/config.yaml` (`resolveConfig`).
+     */
+    catalogUrl?: string;
+    /**
+     * Overrides the index SQLite path read by {@link AssetManager.reportSoftDeps}
+     * (default `~/.skaile/index.db` via `resolveIndexPath`). Injected by tests to
+     * read a seeded index without touching the user's real one.
+     */
+    indexPath?: string;
+    /**
+     * Receives the warning printed when {@link AssetManager.add} picks one ref out of several
+     * local libraries (which library was chosen and why); no other method warns. Defaults to
+     * `console.warn`
+     * with a `skaile:` prefix. A CLI with a live spinner passes a collector and
+     * prints the lines after the spinner stops, so frames can't overwrite them.
+     */
+    onLibraryCollision?: (message: string, keys?: readonly string[]) => void;
+    /**
+     * An `add` that meets several colliding assets prints one summary line by default; `true`
+     * prints each asset's full message (`skaile add --verbose`). A single collision always
+     * prints in full.
+     */
+    verboseCollisions?: boolean;
+}
+/** State fields, constructor, harness rows, state paths. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmCore {
+    protected abstract sameDeclaredAsset(dep: unknown, ref: string): boolean;
+    protected abstract tryReadLock(): LockFile | null;
+    /** Resolved absolute path to the workspace root. */
+    readonly projectDir: string;
+    /** Harness all deploy operations target (a `HarnessName`). */
+    readonly harness: HarnessName;
+    /** Whether this instance operates in global-install mode. */
+    readonly global: boolean;
+    /** Asset-kind registry shared with the host (one instance per process). */
+    readonly registry: IAssetKindRegistry;
+    protected _knownKinds?: ReadonlySet<string>;
+    /** Explicit global-harness override (global mode only); else auto-resolved. */
+    protected readonly harnessesOverride?: HarnessName[];
+    protected readonly legacyCopiesRemoved: string[];
+    protected readonly legacyCopiesKept: string[];
+    /** Injected catalog fetcher (tests / custom); falls back to a built one. */
+    protected readonly injectedStoreFetcher?: StoreFetcher;
+    /** Injected byte fetcher for store staging; falls back to GitHub. */
+    protected readonly injectedAssetFetcher?: AssetFetcher;
+    /** Injected global catalog URL override for the no-project-store fallback. */
+    protected readonly catalogUrlOverride?: string;
+    /** Injected index SQLite path override (tests); else the default index.db. */
+    protected readonly indexPathOverride?: string;
+    /** Sink for cross-library collision warnings; else `console.warn`. */
+    protected readonly onLibraryCollision?: (message: string, keys?: readonly string[]) => void;
+    /** Print every colliding asset's full message instead of one summary ({@link AssetManagerOptions.verboseCollisions}). */
+    protected readonly verboseCollisions: boolean;
+    /** Store URLs whose failed version lookup was already reported (one warning per URL). */
+    protected readonly warnedStoreVersionLookups: Set<string>;
+    /** Whether each store answers: one process asks a dead store once (`processStoreProbe`). */
+    protected readonly storeProbe: import("@skaile/workspaces/library").StoreProbe;
+    /** Stores a lookup could not reach (store URL -> one line why); `add` reports them instead of "not found". */
+    protected readonly storeFailures: Map<string, string>;
+    /** The agent `add` is about to bind to an instance: its deploy writes no file named after the asset. */
+    protected pendingAgentBinding: string | undefined;
+    /** Source origins `outdated` could not fetch; read once through {@link takeUnreachableSources}. */
+    protected readonly unreachableSources: UnreachableSource[];
+    /** Store-origin refs `outdated` could not check; read once through {@link takeStoreNotChecked}. */
+    protected readonly storeUnchecked: StoreNotChecked[];
+    /** How many store lookups failed so far; a lookup that moved it failed. */
+    protected storeFailureCount: number;
+    /** Set while a lookup reports its own failure: the generic one-line warning stays off. */
+    protected quietStoreLookups: boolean;
+    /** Store URLs a lookup failed on because the client is air-gapped (`cache_ttl: 0`), not because the store is down. */
+    protected readonly airGappedStores: Set<string>;
+    /** Sources a provenance walk had to skip (source URL → why); one warning per source. */
+    protected readonly skippedSources: Map<string, string>;
+    /** `onSourceError` of every provenance walk: name the source once, leave it out, go on. */
+    protected readonly reportSourceError: (clone: SourceClone, err: unknown) => void;
+    constructor(opts: AssetManagerOptions);
+    /** Registered kind names — the `knownKinds` argument of the manifest scanners. */
+    protected get knownKinds(): ReadonlySet<string>;
+    /**
+     * The harness component dir a kind installs into (its provider's
+     * `installTarget`), or `undefined` for composition-only kinds, which are only
+     * cached in the store cache and composed at session start.
+     */
+    protected installTarget(kind: string): AiComponent | undefined;
+    /**
+     * Root for this manager's **state** — config SSOT, lock, cache, history.
+     * `~/.skaile` in global mode (the cross-harness SSOT), else the project dir.
+     * Deploy dirs are unaffected; they come from `HARNESS_TARGETS[target]`.
+     */
+    protected get stateRoot(): string;
+    /**
+     * The harnesses a global deploy fans out to: the explicit `harnesses` override (a `--harness`
+     * filter), else the explicit `global_harnesses:` of `~/.skaile/skaile.yaml`, else every harness
+     * whose root dir exists under `~` plus the harness the project is configured for (a project on
+     * a harness whose dir does not exist yet still gets its user-scope assets). In project mode
+     * this is exactly `[harness]`, so the shared fan-out loop degenerates to the
+     * single-target path.
+     */
+    protected targetHarnesses(): HarnessName[];
+    /** The global harness set without a `--harness` filter (see {@link AssetManager.targetHarnesses}). */
+    protected defaultGlobalHarnesses(): HarnessName[];
+    /**
+     * `global_asset_harnesses:` of `~/.skaile/skaile.yaml`: the harnesses `add --global --harness`
+     * limited an entry to, keyed by the declared ref without its pin. An entry with no row goes to
+     * every global harness. Global mode only.
+     */
+    protected readEntryHarnesses(): Record<string, HarnessName[]>;
+    /** The harnesses recorded for `kind:name` (`publisher` must agree when both sides have one). */
+    protected entryHarnessRecord(kind: string, name: string, publisher?: string): HarnessName[] | undefined;
+    /** Keep the entries a recorded `--harness` limit sends to `target` (all of them in project mode). */
+    protected entriesForHarness<E extends {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }>(entries: E[], target: HarnessName): E[];
+    /**
+     * The harness a 5.12.0 `add --global --harness omp` left as the asset's only copy: the copy sits
+     * under the 5.12.0 omp folder (`~/.omp/skills`) and no other default harness holds one. That
+     * folder is the only real 5.12.0 evidence: a current `add --global` writes no row either, so a
+     * lone copy elsewhere may be a copy the user deleted or a harness added later (p1442).
+     */
+    protected legacySingleCopyHarness(component: AiComponent, name: string, all: readonly HarnessName[]): HarnessName[];
+    /**
+     * Whether `~/.skaile/skaile.yaml` is a 5.12.0 record: it exists and has no
+     * `global_asset_harnesses:` key yet, so {@link inferLegacyHarnessSubsets} has not run.
+     */
+    protected isLegacyHarnessRecord(): boolean;
+    /**
+     * A 5.12.0 global record has no `global_asset_harnesses:` key, yet `add --global --harness omp`
+     * wrote one copy only, under `~/.omp/skills`. On the first global `install`, an entry whose only
+     * copy sits there (see {@link legacySingleCopyHarness}) is omp's subset (OQ6): record it, so the
+     * install does not fan the asset out to harnesses the user never asked for (p1442). Nothing is
+     * inferred without that evidence, once the key exists (an entry without a row then means "every
+     * harness"), or with one default harness. Global mode only; returns the rows written.
+     */
+    protected inferLegacyHarnessSubsets<E extends {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }>(entries: readonly E[]): Array<{
+        ref: string;
+        harnesses: HarnessName[];
+    }>;
+    /**
+     * Set (or, with `harnesses` undefined, clear) the harness row of `ref` in the parsed
+     * `~/.skaile/skaile.yaml` `raw`. Returns whether `raw` changed.
+     */
+    protected setEntryHarnessRow(raw: Record<string, unknown>, ref: string, harnesses: HarnessName[] | undefined): boolean;
+    /** The harness row of `kind:name` (publisher must agree when both sides have one) in the parsed `raw`. */
+    protected harnessRowIn(raw: Record<string, unknown>, id: {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }): HarnessName[] | undefined;
+    /**
+     * The harness row `add --global --harness <requested>` leaves for `ref`: the recorded set plus
+     * `requested`. An asset declared with no row goes to every global harness, so its set is that
+     * default; `undefined` (no row) when `requested` is already part of it. A new asset gets
+     * `requested` alone.
+     */
+    protected widenedHarnessRow(raw: Record<string, unknown>, ref: string, requested: readonly HarnessName[], declared: boolean): HarnessName[] | undefined;
+    /**
+     * After `add --global --harness X`: widen the row of every other entry of the add that has one
+     * (a requirement declared on its own with `--harness`), so the copy now deployed into X stays
+     * managed. Entries with no row already go to every harness.
+     */
+    protected widenDependencyRows(entries: readonly {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }[], requested: {
+        kind: string;
+        name: string;
+    }): void;
+    /**
+     * `add --global --harness X --only`: name each harness that leaves the asset's set but still
+     * holds a copy. The copy stays on disk; `remove --global --harness <h>` deletes it.
+     */
+    protected reportDroppedCopies(target: {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }, onDropped: (ref: string, harness: HarnessName, path: string) => void): void;
+    /**
+     * The source origins the last {@link outdated} call could not fetch (name, URL, why). Their
+     * behind count was not checked, so the CLI must not call the project up to date (p1820).
+     */
+    takeUnreachableSources(): UnreachableSource[];
+    /**
+     * The refs the last {@link outdated} call could not check because their store did not answer
+     * (`unreachable`) or the client is air-gapped (`air-gapped`): `outdated`, `check` and `doctor`
+     * name them and fail on `unreachable` instead of calling the project up to date.
+     */
+    takeStoreNotChecked(): StoreNotChecked[];
+    /**
+     * The harnesses `add` / `install` deploy into: `[harness]` for a project, the global
+     * harness set (see {@link AssetManager.targetHarnesses}) for a global manager.
+     */
+    deployTargets(): HarnessName[];
+    protected get storeCacheDir(): string;
+    protected get reposDir(): string;
+    /**
+     * Project-scoped cache dirs rooted at `.skaile/cache/` (`store`, `sources`)
+     * relative to `projectDir`. Reading is a side effect: it triggers lazy
+     * migration of the legacy `.skaile/{store-cache,repos}` dirs.
+     */
+    get projectCacheDirs(): {
+        store: string;
+        sources: string;
+    };
+    protected get lockPath(): string;
+    protected get patchDir(): string;
+    /** Deploy options for one harness. In global mode, `harness` is the
+     * fan-out target (not the constructor's `harness`, which is project-only). */
+    protected deployOptsFor(target: HarnessName, link?: boolean, onSecretFile?: (ref: string, path: string) => void, composed?: Pick<DeployOptions, "lockAssets"> & {
+        refresh: boolean;
+        onDrift: (ref: string, composeRef: string) => void;
+    }): DeployOptions;
+    /** Agent name → the `../` compose folder files its lock entry records (`LockEntry.composed`). */
+    protected composedRecords(): Map<string, LockFileEntry[]>;
+    /** `install`'s `Missing:` line for a `../` compose folder the library moved past the lock. */
+    protected composedDriftLine(agentRef: string, composeRef: string): string;
+    /**
+     * Names of the `mcp-server` assets the lock holds (the declaration ids, unscoped); a missing
+     * `.mcp.json` entry of one counts as drift even before skaile owned it.
+     */
+    protected lockedMcpNames(): Set<string>;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/asset-manager/src/config/core.d.ts.map

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

package/dist/asset-manager/src/config/edit.d.ts

@@ -0,0 +1,161 @@
+import { type CatalogEntry, type LockFile, type SourceDeclaration } from "@skaile/workspaces/core";
+import { type HistoryEntry } from "../history.js";
+import { type ScaffoldOptions } from "../installer.js";
+import { AmOmpSweep } from "../omp-sweep.js";
+/** Create, clean, history, skaile.yaml edits, agent bindings. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmConfigEdit extends AmOmpSweep {
+    abstract listDeployed(kind?: string): CatalogEntry[];
+    /**
+     * Create a minimal asset scaffold directory (delegates to {@link createScaffold}).
+     *
+     * @param name - Asset name (also used as the directory name).
+     * @param kind - Asset kind: `skill` | `agent` | `preset` | `flow` | `prompt` | `contract`.
+     * @param destDir - Parent directory to create the asset in.
+     * @param opts - Optional scaffold content (`description`).
+     * @returns `{ ok: true, path }` on success, `{ ok: false, path: errorMessage }` if the
+     *   directory already exists or `kind` has no scaffold template.
+     */
+    create(name: string, kind: string, destDir: string, opts?: ScaffoldOptions): {
+        ok: boolean;
+        path: string;
+    };
+    /**
+     * Return recent asset action history entries, newest first.
+     *
+     * @param limit - Maximum number of entries to return. Defaults to `20`.
+     * @returns Array of {@link HistoryEntry} objects in reverse-chronological order.
+     */
+    history(limit?: number): HistoryEntry[];
+    /**
+     * Erase all asset action history for this workspace.
+     */
+    clearHistory(): void;
+    /**
+     * Remove deployed assets tracked by the lock file and report unmanaged ones.
+     *
+     * With `opts.all`, also deletes `.skaile/history.yaml`, `.skaile/patches/`,
+     * `.skaile/cache/sources/`, and `skaile.lock.yaml` — effectively resetting the
+     * workspace to a pre-install state.
+     *
+     * @param opts - Optional cleanup options.
+     * @param opts.all - When `true`, remove all Skaile-managed state in addition to deployed assets.
+     * @returns Object with `removed` (successfully cleaned refs), `skipped` (with reasons),
+     *   and `unmanaged` (deployed assets not in the lock file).
+     */
+    clean(opts?: {
+        all?: boolean;
+    }): {
+        removed: string[];
+        skipped: Array<{
+            ref: string;
+            reason: string;
+        }>;
+        unmanaged: string[];
+    };
+    /**
+     * `clean --global`: remove the copy of every asset the global lock tracks from each global
+     * harness (and the old `~/.omp/<dir>` copy), keeping `~/.skaile/skaile.yaml`. With `all`, the
+     * global lock goes too.
+     */
+    protected cleanGlobal(opts?: {
+        all?: boolean;
+    }): {
+        removed: string[];
+        skipped: Array<{
+            ref: string;
+            reason: string;
+        }>;
+        unmanaged: string[];
+    };
+    /**
+     * Remove the deployed dir of every asset tracked by the lock; missing dirs
+     * still count as removed. Returns the list of cleaned refs.
+     */
+    protected cleanLockedDeployedAssets(lock: LockFile | null): string[];
+    /**
+     * Report deployed assets not tracked by the lock file. Deployed assets are
+     * keyed by <kind>:<name>; lock canonical refs are mapped to that shape.
+     */
+    protected collectUnmanagedAssets(lock: LockFile | null): string[];
+    /** Delete all Skaile-managed state: history file, patches/, cache/sources/, lock. */
+    protected removeAllManagedState(): void;
+    /**
+     * Add a dependency ref to the manifest `dependencies:` if not already present.
+     * Project mode edits `<projectDir>/skaile.yaml`; global mode edits the
+     * user-scope SSOT `~/.skaile/skaile.yaml`, **bootstrapping** the file (and its
+     * parent dir) when absent so `skaile add --global` works on a fresh machine.
+     */
+    protected addDependencyToConfig(ref: string, only?: boolean): void;
+    /**
+     * Whether the declared `dep` names the same asset (kind, publisher, name) as
+     * `ref`, ignoring the version pin. A publisher must agree on both sides —
+     * unlike {@link removeDependencyFromConfig}, a bare `kind:name` never replaces a
+     * publisher-qualified line. Unparseable entries only match on string equality.
+     */
+    protected sameDeclaredAsset(dep: unknown, ref: string): boolean;
+    /**
+     * Remove a dependency ref from the manifest `dependencies:`. Targets the same
+     * file as {@link addDependencyToConfig} (`~/.skaile/skaile.yaml` in global mode).
+     *
+     * @returns `true` when a declaration was removed.
+     */
+    protected removeDependencyFromConfig(target: {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }): boolean;
+    /**
+     * Whether `target` is an agent that an agent instance of `skaile.yaml` binds and no
+     * `dependencies:` line names. Project mode only.
+     */
+    protected boundOnlyByInstance(target: {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }): boolean;
+    /**
+     * The locked agents an agent instance binds (`agents.<id>.ref`, `agent.definition`) that
+     * `declared` does not name, as version-less `agent:@publisher/name`. An agent no lock entry
+     * holds is left out: `install` does not add what the user never added (`skaile add` does).
+     */
+    protected lockedAgentBindings(declared: readonly string[]): string[];
+    /**
+     * Bind the agent `skaile add agent:<ref>` just added as an instance `agents.<name>:
+     * {ref: agent:@publisher/name}` of `skaile.yaml`, so `run --instance <name>` and the repl
+     * banner hint work at once. An agent that an instance or `agent:` already binds, or an id
+     * `agents:` already holds, is left as it is. Project mode only.
+     *
+     * @returns the instance id and ref bound; the id with `keptRef` (what that id binds instead)
+     * when the id is taken by another agent; `undefined` when nothing was bound and nothing needs saying.
+     */
+    protected bindAgentInstance(entries: ReadonlyArray<{
+        kind: string;
+        name: string;
+        publisher?: string;
+    }>, parsed: {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }, write?: boolean): {
+        id: string;
+        ref: string;
+        keptRef?: string;
+    } | undefined;
+    /** The refs `skaile.yaml` binds agent instances to: every `agents.<id>.ref` and `agent.definition`. Project mode only. */
+    protected declaredAgentInstanceRefs(): string[];
+    /**
+     * Drop the agent instances of `skaile.yaml` (`agents.<id>`, or the `agent.definition`
+     * default) whose `ref` binds to `target`, and the native agent files an install rendered for
+     * them. Only an `agent` target has bindings; project mode only. A `ref` without a publisher
+     * matches any publisher, and a pin is ignored.
+     *
+     * @returns `true` when a binding was removed.
+     */
+    protected removeAgentBindings(target: {
+        kind: string;
+        name: string;
+        publisher?: string;
+    }): boolean;
+    protected resolveRepoDir(decl: SourceDeclaration, name: string): string | null;
+}
+//# sourceMappingURL=edit.d.ts.map

package/dist/asset-manager/src/config/edit.d.ts.map

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