@skaile/workspaces 6.15.0 → 6.16.0

package/dist/asset-manager/src/installer.d.ts.map

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

package/dist/asset-manager/src/lock/copies.d.ts

@@ -0,0 +1,156 @@
+import { type LockFile, type LockFileEntry } from "@skaile/workspaces/core";
+import { AmAgentRender } from "../agent-render.js";
+import { type DeployedDrift } from "../installer.js";
+import type { IncompleteDeploy, LockGap, RestoredAsset, RewrittenAgent } from "../shared/types.js";
+/** Rendered agent files per lock key (path -> sha256) before a deploy; see `unrecordedRenderings`. */
+interface RenderSnapshot {
+    /** The asset-named files of an agent entry whose lock records no `rendered:` (5.11.0 and older). */
+    agent: Map<string, Map<string, string>>;
+    /** The files of agent instances the entry's `rendered:` does not list yet (5.13.0 and older). */
+    instance: Map<string, Map<string, string>>;
+}
+/** WithCopiedFiles, withRenderedAgents, lockedCopyDrift, restoredCopies. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmLockCopies extends AmAgentRender {
+    protected abstract lockedComposeDrift(lock: LockFile, kind: string, name: string): Promise<string | undefined>;
+    abstract otherKindHint(ref: string): Promise<string | undefined>;
+    /**
+     * Record, on every library-origin entry of `lock` that is copied into a harness folder, the
+     * files of the deployed copy and their sha256 (`LockEntry.copied`), so a hand edit is named
+     * even after the library moved past the lock (p1641). Call it after the deploy. An entry that
+     * is unchanged since `prev` keeps its record, or stays without one: the deployed bytes may
+     * carry an edit the deploy did not touch. Project mode only; a `--link` deploy and a patched
+     * asset are not recorded.
+     */
+    protected withCopiedFiles<T extends LockFile>(lock: T, prev: LockFile | null): T;
+    /**
+     * Record, on every agent entry of `lock` that has none, the files the agent's harness
+     * rendering occupies and their sha256. Call it after the deploy, so the bytes hashed are the
+     * ones `install` just wrote; {@link lockedCopyDrift} compares later edits with them.
+     * Entries that carry a record (kept from an earlier lock) are left as they are.
+     *
+     * @param keepComposedOf - The lock an `install` read: an agent whose `../` compose folder is
+     *   not in the cache keeps that lock's `composed:` record. Omitted by `update` and `add`,
+     *   which copy the library's current bytes.
+     */
+    protected withRenderedAgents<T extends LockFile>(lock: T, keepComposedOf?: LockFile | null): T;
+    /**
+     * Make the `rendered:` list of every agent entry say exactly which files belong to it: the
+     * asset-named files of its own rendering (hashes kept as recorded) plus the files of the agent
+     * instances whose `ref` names it (`.claude/agents/default.md`, …) with their current sha256,
+     * so a hand edit of an instance file is drift like one of the asset-named file. A path that is
+     * neither is dropped: an instance that left `skaile.yaml`, or was bound to another agent, no
+     * longer lists its file under the old entry. A file that is another entry's own rendering
+     * stays with that entry; an instance whose `ref` names no locked agent (a path ref) has no
+     * entry to hold its files. Call it after `renderAgentInstances`, which rewrites every
+     * instance file, so the bytes hashed are the ones just written.
+     */
+    protected withInstanceRenderings<T extends LockFile>(lock: T): T;
+    /** Append the regular files under `path` (a file or a directory) to `out`, project-relative with sha256. Symlinks are skipped. */
+    protected hashTree(path: string, out: LockFileEntry[]): void;
+    /** The files of one agent's rendering for the active harness, project-relative, with sha256. */
+    protected renderedAgentFiles(name: string): LockFileEntry[];
+    /**
+     * The lock key of the agent entry an agent instance's `ref` names, or `undefined` when no locked
+     * agent matches (a path ref has no entry).
+     */
+    protected agentKeyOfRef(agentKeys: readonly string[], ref: string): string | undefined;
+    /**
+     * The rendered native files of every locked agent that the lock does not list under
+     * `rendered:` (a lock an older CLI wrote), as path → sha256 per lock key, taken before a
+     * deploy. `check` cannot tell such a file from a stale one, so {@link changedRenderings}
+     * compares it afterwards. `agent` holds the asset-named files of an entry with no `rendered:`
+     * at all (5.11.0 and older); `instance` the files of agent instances the entry's `rendered:`
+     * does not list yet (5.13.0 and older), which the instance render rewrites. Project mode only.
+     */
+    protected unrecordedRenderings(lock: LockFile | null): RenderSnapshot;
+    /**
+     * The notice `check` and `outdated` print for a lock written before it listed the rendered
+     * agent files and the files of agent instances: the next `install`, `add` or `update`
+     * adds the list and rewrites those files from the render, so a hand edit of one is lost.
+     * Empty for a current lock, and in global mode.
+     */
+    legacyLockNotices(): string[];
+    /**
+     * What a deploy changed among the files {@link unrecordedRenderings} saw before it. `rewritten`
+     * is one row per locked agent whose asset-named files differ now: a render the CLI changed (the
+     * 5.12.0 abilities block) otherwise reaches the user as a silent rewrite. `restored` is one row
+     * per agent whose instance files differ now: the render replaced them, a hand edit included.
+     */
+    protected changedRenderings(before: RenderSnapshot): {
+        rewritten: RewrittenAgent[];
+        restored: RestoredAsset[];
+    };
+    /**
+     * The {@link RestoredAsset} rows for the drifted copies (see {@link lockedCopyDrift}) a
+     * deploy just wrote again: those whose ref is among the `deployed` canonical refs.
+     */
+    protected restoredCopies(drifts: ReadonlyArray<{
+        ref: string;
+        key: string;
+        rendered?: true;
+        lockedSha?: ReadonlyMap<string, string>;
+    } & DeployedDrift>, deployed: readonly string[], incomplete?: readonly IncompleteDeploy[]): RestoredAsset[];
+    /**
+     * Hand edits in the deployed copy of a library asset whose library moved past the lock (a
+     * version bump, or an in-place edit of the same version): {@link restoreLibraryLockEntries}
+     * drops such an entry, so {@link lockedCopyDrift} would not see the edit and `update` would
+     * replace the file without a word (p1641). `covered` holds the `kind:@publisher/name` of the
+     * entries that were compared already. The lock's per-file record (`copied:`) names the edited
+     * files; a lock without one (written before it existed) compares the deployed folder with the
+     * one library hash and names the files that also differ from the library's new content.
+     */
+    protected changedLibraryCopyEdits(lock: LockFile, covered: ReadonlySet<string>, patches: Record<string, unknown>): Promise<Array<{
+        ref: string;
+        key: string;
+    } & DeployedDrift & {
+        library: true;
+        libraryChanged: true;
+        unrecorded?: true;
+    }>>;
+    /**
+     * Locked assets whose deployed copy differs from the bytes the lock covers: a file edited by
+     * hand, or a file the asset does not ship. One row per asset, `ref` being `kind:@publisher/name`
+     * and `key` its lock key. The one comparison behind the `modified` gap and the `Restored` lines
+     * of `install`.
+     *
+     * - A library-origin asset is compared with its library's files, but only while those equal the
+     *   locked hash (changed library content is the `content` gap's business), both modified and
+     *   extra files.
+     * - A source asset is compared with the per-file hashes the lock records (modified files only:
+     *   the lock lists what the source covers, not what the deploy copies).
+     *
+     * A `--link` deploy, an asset with a configured patch, and a copy that is missing are not
+     * compared: other gaps cover them. An agent (rendered, not copied) is compared with the
+     * hashes of its rendered files the lock records (`LockEntry.rendered`); its `modified` paths
+     * are project-relative. Project mode only.
+     */
+    protected lockedCopyDrift(): Promise<Array<{
+        ref: string;
+        key: string;
+    } & DeployedDrift & {
+        library: boolean;
+        libraryChanged?: true;
+        /** The lock keeps no per-file record: `modified` is what differs from the library now. */
+        unrecorded?: true;
+        /** Files whose lock hash is wrong: the deployed bytes match the entry's own checksum. */
+        lockWrong?: string[];
+        rendered?: true;
+        lockedSha?: ReadonlyMap<string, string>;
+        /** Project-relative path of an agent instance's file → the instance id. */
+        instanceOf?: ReadonlyMap<string, string>;
+    }>>;
+    /**
+     * Locked assets (declared or required by one) whose deployed copy is gone: `skaile install`
+     * restores them. Same deployability rule as {@link AssetManager.listDeclared}'s `drift`.
+     *
+     * @param named - `kind:name` identities already reported; they are skipped.
+     */
+    protected undeployedLockGaps(lock: LockFile | null, named: ReadonlySet<string>): Promise<LockGap[]>;
+    /**
+     * {@link declaredNoHolderReason} plus, when the name exists under another kind, the same
+     * `It is a skill: skill:@pub/name.` tail `add` and `update` end their not-found line with.
+     */
+    protected declaredNoHolderLine(ref: string): Promise<string>;
+}
+export {};
+//# sourceMappingURL=copies.d.ts.map

package/dist/asset-manager/src/lock/copies.d.ts.map

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

package/dist/asset-manager/src/lock/library.d.ts

@@ -0,0 +1,261 @@
+import { type AssetRef, type CatalogEntry, type LockEntry, type LockFile } from "@skaile/workspaces/core";
+import { type DeployableEntry } from "../installer.js";
+import { AmResolveStores } from "../resolve/stores.js";
+import type { KeptLibraryEntry, KeptLockEntries, LibraryIndexSnapshot, LockedLibrary, PreferLocked } from "../shared/types.js";
+/** Lock(), library lock entries and restore. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmLockLibrary extends AmResolveStores {
+    protected abstract presetRecorded(want: AssetRef): boolean;
+    protected abstract deployedRequirementsOf(id: {
+        kind?: string;
+        name?: string;
+        publisher?: string;
+    }): Promise<string[]>;
+    protected abstract noteStoreFailure(storeUrl: string, err: unknown): string;
+    /**
+     * Library-origin lock entries for the assets {@link resolveLibraryEntries}
+     * matched. The locked version is the one actually deployed: the on-disk
+     * entry's version, falling back to the library index only when the disk entry
+     * carries none — the index lags until the next `skaile library index`, so
+     * preferring it would lock a stale version after an in-place bump. The hash is
+     * computed from the files on disk, so it matches what `install --locked`
+     * re-hashes.
+     *
+     * A git-backed library also records its remote URL. When the previous lock names the
+     * library under another name that {@link lockedLibrary} matched to this one by URL (a
+     * teammate registered the same remote under a different name), the entry keeps the locked
+     * name and URL: the lock does not change because it was installed on another machine. A
+     * library renamed on this machine with `library rename` is locked under its new name.
+     */
+    protected libraryLockEntries(lib: {
+        entries: CatalogEntry[];
+        libraryOf: Map<CatalogEntry, string>;
+    }, relockGit?: boolean): Promise<Record<string, LockEntry>>;
+    /**
+     * The entries a deploy would write into some target harness: those without a current deployed
+     * copy. An intact copy stays as it is, so a library change that does not reach it (a symlink
+     * added next to the files) stops no `install` or `update` (p1857).
+     */
+    protected needingDeploy<T extends CatalogEntry>(entries: readonly T[], link?: boolean): T[];
+    /**
+     * The files of a library asset that git has not committed (edited, new or staged only), as
+     * paths relative to the library root. The asset's own folder, or its one manifest file when it
+     * shares the folder with other assets. Empty when the asset is not in a git work tree.
+     */
+    protected uncommittedAssetFiles(entry: CatalogEntry, libPath: string): string[];
+    /**
+     * Warn when a library with a git remote has uncommitted changes in the folders of the assets
+     * `add` or `install` lock: the lock records the bytes on this disk, which no clone of the
+     * remote holds, so a teammate (or CI) cannot restore them. One line per library naming the
+     * files; the command goes on (OQ5, p1859).
+     */
+    protected warnUncommittedLibraryAssets(lib: {
+        entries: CatalogEntry[];
+        libraryOf: Map<CatalogEntry, string>;
+    }): Promise<void>;
+    /**
+     * Whether every declared ref is locked and no declared pin differs from the locked version:
+     * `skaile.yaml` asks for nothing the lock does not hold. A declared preset counts when the
+     * lock records it.
+     */
+    protected declaredMatchesLock(lock: LockFile, declared: readonly string[]): boolean;
+    /**
+     * Lock keys that `skaile.yaml` still wants: the entries a declared ref names, plus every
+     * entry such an asset requires, transitively. All keys when a `preset:` is declared.
+     */
+    protected declaredLockKeys(lock: LockFile, declared: readonly string[]): Promise<Set<string>>;
+    /**
+     * The `Missing:` lines of every library-origin lock entry whose library cannot supply
+     * assets on this machine (not registered, or registered with its directory gone). Plain
+     * `install` stops on a non-empty list, the same lines `install --locked` prints: it must
+     * not re-resolve a locked asset from another origin. The ONE function that decides "the
+     * locked library is not here", so a store-restore fallback extends it in one place.
+     *
+     * An entry `install --locked` already restored from a store (its library is not registered
+     * here and the store cache holds the locked version, see {@link restoredFromStoreCache}) is no
+     * line: it is returned in `restored`, and plain `install` then restores the lock as
+     * `install --locked` does instead of re-resolving it from another origin (OQ8, p1655).
+     *
+     * Only entries `skaile.yaml` still declares, or that a declared asset requires
+     * (transitively, read from the deployed copy), count. A stale entry nothing declares is
+     * pruned by `install` as usual, so a removed dependency whose library is gone can be
+     * cleaned up. With a declared `preset:` every entry counts: the lock records no edge
+     * from a preset to its items, and the preset's own library may be the one that is gone.
+     *
+     * @param declared - The `dependencies:` refs as written in `skaile.yaml`.
+     */
+    protected unavailableLockedLibraries(lock: LockFile, declared: readonly string[]): Promise<{
+        lines: string[];
+        restored: string[];
+    }>;
+    /**
+     * Re-resolve every library-origin lock entry from its named library, for
+     * `install --locked`. An entry is restored only when its library is still
+     * registered/on disk, still holds the asset, and still offers the locked
+     * version; anything else is reported in `missing` with the reason.
+     *
+     * @param opts.storeFallback - `install --locked` only: an entry whose library is not registered
+     *   here is restored from a store that serves the locked sha256 (OQ8, OQ15, p1490, p1655). The
+     *   lock records the library's remote and hash but no commit and no file list, so the library
+     *   remote itself cannot be fetched at a locked commit; the store pointer names the upstream
+     *   repository and commit that hold exactly the hashed bytes. Reads such as the drift check
+     *   never ask a store.
+     */
+    protected restoreLibraryLockEntries(lock: LockFile, opts?: {
+        storeFallback?: boolean;
+    }): Promise<{
+        entries: DeployableEntry[];
+        missing: string[];
+        viaStore: string[];
+        /** Lock key → where the store says the bytes come from (`<store url> (<upstream>@<commit7>)`). */
+        storeOrigins: Record<string, string>;
+    }>;
+    /**
+     * Whether a library-origin lock entry was restored from a store: its library is not
+     * registered here, and the project's store cache holds the locked version (`install --locked`
+     * fetched it there and SHA-verified every file against the sha256 the lock recorded). Such an
+     * entry is as restorable as a source- or store-origin one: `check`, `doctor` and plain
+     * `install` read its requirements from the deployed copy and do not ask for the library (OQ8,
+     * p1655). An unregistered library that never restored anything here stays a gap.
+     *
+     * This only checks that the cache directory of the locked version is not empty: the bytes were
+     * verified when they were fetched, and a later edit of the deployed copy is the `modified`
+     * drift check's job, not this one's.
+     */
+    protected restoredFromStoreCache(key: string, entry: LockEntry, snap: LibraryIndexSnapshot | null): Promise<boolean>;
+    /**
+     * The store's copy of a library-origin lock entry whose library is not registered here: a
+     * store (project `stores:` or the global catalog) that serves `kind:@publisher/name#version`
+     * under the very sha256 the lock recorded holds the same bytes. The entry is fetched and
+     * verified like any store asset; the lock stays as it is. `null` when the lock has no hash,
+     * no store answers, or the hash differs (OQ15, p1490). `from` names the store and the
+     * upstream repository and commit its pointer gives, for the notice.
+     */
+    protected storeEntryForLockedLibraryAsset(publisher: string, kind: string, name: string, origin: {
+        version: string;
+        sha256?: string;
+    }): Promise<{
+        entry: DeployableEntry;
+        from: string;
+    } | null>;
+    /**
+     * Whether a deployed copy exists for the lock entries `install` kept for the unresolved
+     * `ref`. A kind with no install target has none, except an `mcp-server`: its copy is the
+     * `.mcp.json` entry skaile wrote and the payload that entry points into (p792).
+     */
+    protected keptCopyDeployed(kept: KeptLockEntries, ref: string): Promise<boolean>;
+    /** Whether the deployed copy of a library asset is on disk; a kind with no install target has none to check. */
+    protected lockedCopyDeployed(kind: string, name: string): boolean;
+    /**
+     * The library-origin lock entries `install` keeps when the library holds a newer version:
+     * only `update` moves a locked asset, so `install` restores the locked one (p1095).
+     * Keyed by `<publisher>/<kind>:<name>`. `requires` is what the locked version needs: the
+     * lock's own list, or for a lock that predates the field the deployed copy's requirements,
+     * never the newer library entry's.
+     */
+    protected keepLockedLibraryEntries(lock: LockFile | null): Promise<ReadonlyMap<string, KeptLibraryEntry> | undefined>;
+    /**
+     * How the library `origin` names stands on this machine. THE one lookup of a locked library
+     * ("is it registered here?"): `check`, `outdated`, `install` and `install --locked` all ask it.
+     *
+     * - registered in the index under its name: `ok` at its registered path, or `dir-missing` when
+     *   that directory is gone;
+     * - not registered: a directory `<libraries dir>/<name>` nobody unregistered still counts as a
+     *   hand-made library (`ok`). One `library remove` unregistered without `--purge` does not
+     *   (it stays on disk but no longer resolves), and neither does the reserved `installed` folder.
+     * - otherwise, when the lock recorded the library's remote URL: another registered library
+     *   whose git remote is the same repository (`.git` suffix, trailing `/` and the
+     *   `git@host:o/r` / `https://host/o/r` forms do not matter) and whose directory exists is
+     *   `ok`, with `name` set to the name it is registered under here. The library name is
+     *   machine-local; the remote is what a clone shares.
+     */
+    protected lockedLibrary(origin: {
+        id?: string;
+        name: string;
+        url?: string;
+        sha256?: string;
+    }, snap: LibraryIndexSnapshot | null, asset?: {
+        kind: string;
+        publisher: string;
+        name: string;
+    }): LockedLibrary;
+    /**
+     * Why `install --locked` cannot restore a locked library asset from its library: the library
+     * holds another version than the lock (`library "x" is at 0.1.1, locked 0.1.0`) or the locked
+     * version with other bytes (`library "x" content changed since lock`). Only `update` moves
+     * the lock to it. `undefined` when the library is not here, no longer holds the asset, or
+     * still holds the locked files (the other gaps say what is wrong then).
+     */
+    protected libraryAheadOfLock(origin: {
+        name: string;
+        url?: string;
+        sha256?: string;
+        version?: string;
+    }, asset: {
+        kind: string;
+        publisher: string;
+        name: string;
+    }): Promise<string | undefined>;
+    /** The registered library whose files for `asset` hash to `sha256` (the locked bytes), if any. */
+    protected libraryHoldingLockedBytes(sha256: string, asset: {
+        kind: string;
+        publisher: string;
+        name: string;
+    }, snap: LibraryIndexSnapshot | null): {
+        name: string;
+        path: string;
+    } | undefined;
+    /** On-disk root of the library `origin` names; `null` unless {@link lockedLibrary} says `ok`. */
+    protected libraryPath(origin: {
+        name: string;
+        url?: string;
+    }, snap: LibraryIndexSnapshot | null): string | null;
+    /**
+     * Rename the library every library-origin lock entry names: `library rename <interim> <old>`
+     * puts a library back under its old name, and an entry locked in between would keep the
+     * interim name, so a later "register library again" advice would name a library nobody knows
+     * any more (p893). Nothing is written when no entry names `from`.
+     *
+     * @returns the number of lock entries renamed.
+     */
+    renameLockedLibrary(from: string, to: string): number;
+    /**
+     * The `kind:@publisher/name` identities the lock holds for one `kind` and `name`, whatever
+     * their publisher. `diff` uses it to accept a ref without a publisher only when it names
+     * exactly one locked asset.
+     */
+    lockedRefsNamed(kind: string, name: string): string[];
+    /**
+     * The library a library-origin lock entry of `kind` and `name` (and `publisher`, when given)
+     * resolves to on this machine, or `undefined` when the lock holds no such entry, it is not
+     * from a library, or its library is not here. `info` prints it next to `source:`.
+     */
+    lockedLibraryOf(kind: string, name: string, publisher?: string): Promise<string | undefined>;
+    /**
+     * Where each library-origin lock entry of this project resolves on this machine: identity
+     * `kind:publisher/name` (no scope sigil, no version) → the name the locked library is
+     * registered under here. The name differs from the locked one when the lock's remote URL
+     * matched another registered library ({@link lockedLibrary}). A deployed entry whose library
+     * resolves nowhere (not registered, directory gone) maps to `null`.
+     *
+     * Direct `asset install` entries (`library.installed`) are included and resolved the same
+     * way, but they map to the locked library name when that lookup fails: such a copy sits in
+     * the project and does not depend on the library still being registered. A missing or
+     * unreadable lock yields an empty map. `skaile manage` uses it to tick the right library row.
+     */
+    lockedLibraryNames(): Promise<Map<string, string | null>>;
+    /**
+     * What `update` prefers when libraries tie: the library each lock entry resolves to here
+     * ({@link lockedLibraryNames}, a `library rename` followed) and the sha256 it locked.
+     */
+    protected lockedPreference(): Promise<PreferLocked>;
+    /**
+     * Resolve all declared dependencies and write (or overwrite) `skaile.lock.yaml`.
+     *
+     * Performs repository sync and full dependency resolution without deploying assets.
+     * Use this to regenerate the lock file after manually editing `skaile.yaml`.
+     *
+     * @returns The written {@link LockFile} data.
+     */
+    lock(): Promise<LockFile>;
+}
+//# sourceMappingURL=library.d.ts.map

package/dist/asset-manager/src/lock/library.d.ts.map

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

package/dist/asset-manager/src/mcp-render.d.ts

@@ -0,0 +1,86 @@
+import { AmLockLibrary } from "./lock/library.js";
+import { type McpServerDrift } from "./mcp-config.js";
+import type { RestoredAsset } from "./shared/types.js";
+/** A note about an `mcp-server` that fails nothing. See {@link AssetManager.mcpNotices}. */
+export interface McpNotice {
+    /** The declaration id (`sql`, `@admin/sql`). */
+    id: string;
+    kind: "skipped" | "unset-field";
+    /** With `skipped`: why the server is not written to the MCP config. */
+    reason?: string;
+    /** The `!` line `check` and `doctor` print. */
+    text: string;
+}
+/** MCP config drift, render and notices. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmMcpRender extends AmLockLibrary {
+    /**
+     * The payloads and managed `.mcp.json` entries of the project's **locked** `mcp-server`
+     * assets that differ from what the declarations render (see {@link mcpServerDrift}), one row
+     * per server, named by the lock identity `mcp-server:@publisher/name`; `key` is the lock key.
+     * An `mcp_servers:` entry of `skaile.yaml` is configuration, not a locked asset: it has no
+     * row. Empty for a global manager and for a project that locks no `mcp-server`.
+     */
+    protected mcpDriftRows(): Promise<Array<{
+        ref: string;
+        key: string;
+        drift: McpServerDrift;
+    }>>;
+    /**
+     * What the render wrote for the `mcp-server` asset `name` into the coding agent's MCP
+     * config: the config file and, for a server with a payload, the payload directory
+     * (project-relative). `written` is false when the render left the server out (see
+     * {@link AssetManager.mcpNotices}). `undefined` when the harness has no MCP config skaile
+     * writes (`codex`, `omp`) or for a global manager: the asset is composed at run time only.
+     */
+    mcpRenderFootprint(name: string): Promise<{
+        file: string;
+        payloadDir?: string;
+        written: boolean;
+    } | undefined>;
+    /**
+     * The declared MCP servers whose `.mcp.json` entry skaile wrote and nothing edited, but that
+     * `skaile.yaml` (or a newer asset) now renders differently: the config waits for
+     * `skaile install`. Covers a locked `mcp-server` and an `mcp_servers:` entry alike; the
+     * server is named by its lock identity when it has one, else `mcp-server:<id>`. Empty for a
+     * global manager.
+     */
+    protected mcpPendingRender(): Promise<Array<{
+        ref: string;
+        file: string;
+    }>>;
+    /**
+     * Render the project's declared MCP servers into the harness target's own
+     * native MCP config (`<project>/.mcp.json` for `claude-code`), so the coding
+     * agent sees the same servers skaile's agent loop wires up.
+     *
+     * Project scope only: a `--global` install has no project-scope config to
+     * write, and the coding agent's user scope is a large user-state file this
+     * must not touch. Never fails an install — a render error is warned and
+     * swallowed.
+     *
+     * @returns The payload files and config entries the render wrote back (and the files it
+     *   removed) because they had drifted from the declaration: `install` names them, as it does
+     *   a restored skill file.
+     */
+    protected renderHarnessMcpConfig(): Promise<RestoredAsset[]>;
+    /**
+     * After an `mcp-server` asset left the project: drop what would keep it rendered. Its staged
+     * store bytes under `.skaile/cache/store/<publisher>/mcp-server/<name>/` go (an `mcp_servers:`
+     * entry of the same id would otherwise keep loading them), and so does an `mcp_servers:` entry
+     * that only sets values for it: `env` and the like, with no `command`, `url` or recipe of its
+     * own. An entry that can run alone is the user's own server and stays.
+     *
+     * @returns The dropped `mcp_servers` entries, as `mcp_servers entry "<id>"`.
+     */
+    protected dropRemovedMcpServerSettings(name: string, publishers: readonly string[]): string[];
+    /**
+     * Notes about the project's `mcp-server`s that are not drift and fail nothing: a declared
+     * server skaile does not write to the coding agent's MCP config (`reason` from the last
+     * render), and a required `MCP.md` field nothing sets. `check` and `doctor` print them as
+     * `!` lines; `list` shows the first kind as `skipped`.
+     *
+     * @returns One {@link McpNotice} per note; empty for a global manager.
+     */
+    mcpNotices(): Promise<McpNotice[]>;
+}
+//# sourceMappingURL=mcp-render.d.ts.map

package/dist/asset-manager/src/mcp-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-render.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/mcp-render.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAQL,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,4FAA4F;AAC5F,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC;IAChC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yHAAyH;AACzH,8BAAsB,WAAY,SAAQ,aAAa;IACrD;;;;;;OAMG;cACa,YAAY,IAAI,OAAO,CACrC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC,CAC3D;IA0BD;;;;;;OAMG;IACG,kBAAkB,CACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IAQ/E;;;;;;OAMG;cACa,gBAAgB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAsBjF;;;;;;;;;;;;;OAaG;cACa,sBAAsB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAmDlE;;;;;;;;OAQG;IACH,SAAS,CAAC,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE;IA0B7F;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CA0BzC"}

package/dist/asset-manager/src/omp-sweep.d.ts

@@ -0,0 +1,25 @@
+import { type CatalogEntry } from "@skaile/workspaces/core";
+import { AmCore } from "./config/core.js";
+/** Legacy omp copy sweep and its notices. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmOmpSweep extends AmCore {
+    /**
+     * Delete the copies a 5.12.0 global install left in `~/.omp/skills`, `~/.omp/agents`,
+     * `~/.omp/prompts` and `~/.omp/contracts` (omp reads `~/.omp/agent/<dir>`) for the assets just
+     * deployed into omp's new folder, and remember them for {@link takeLegacyCopiesRemoved} (p744).
+     */
+    protected sweepLegacyOmpCopies(entries: CatalogEntry[]): void;
+    /** The old omp copies the deploys since the last call kept, as skaile did not write them. */
+    takeLegacyCopiesKept(): string[];
+    /**
+     * The old `~/.omp/<dir>/<name>` copies of the globally locked assets that are still on disk
+     * (a 5.12.0 install wrote them; omp reads `~/.omp/agent/<dir>`). Global mode only. `check`,
+     * `doctor` and `clean` with `--global` report or remove them (p911).
+     */
+    staleLegacyOmpCopies(): {
+        ref: string;
+        path: string;
+    }[];
+    /** The old omp copies the deploys since the last call removed (see {@link sweepLegacyOmpCopies}). */
+    takeLegacyCopiesRemoved(): string[];
+}
+//# sourceMappingURL=omp-sweep.d.ts.map

package/dist/asset-manager/src/omp-sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omp-sweep.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/omp-sweep.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAM1C,0HAA0H;AAC1H,8BAAsB,UAAW,SAAQ,MAAM;IAC7C;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAqC7D,6FAA6F;IAC7F,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;;;OAIG;IACH,oBAAoB,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;IAevD,qGAAqG;IACrG,uBAAuB,IAAI,MAAM,EAAE;CAGpC"}