@skaile/workspaces 6.14.0 → 6.16.0

package/dist/asset-manager/src/read/state.d.ts

@@ -0,0 +1,265 @@
+import { type CatalogEntry, type HarnessName, type LockFile, type SourceDeclaration } from "@skaile/workspaces/core";
+import { type DeployableEntry } from "../installer.js";
+import { AmMcpRender } from "../mcp-render.js";
+import type { DeclaredAsset, IncompleteDeploy } from "../shared/types.js";
+import type { OutdatedEntry } from "./outdated.js";
+/**
+ * A tracked asset whose copy still sits in the project dirs of a harness the
+ * project no longer deploys to. See {@link AssetManager.listStaleHarnessCopies}.
+ */
+export interface StaleHarnessCopy {
+    /** The harness whose dir holds the stale copy. */
+    harness: HarnessName;
+    kind: string;
+    name: string;
+    /** Absolute path of the stale copy. */
+    path: string;
+    /**
+     * `true` when skaile wrote this copy, so `harness set --clean` may delete it: its bytes equal
+     * the copy the active harness holds now, or (an agent, whose shape differs per harness) the
+     * lock records the asset. `false` for a folder the user made: it is named and kept (p1671).
+     */
+    skaileWrote: boolean;
+}
+/**
+ * @deprecated Use {@link StaleHarnessCopy}, which also names the harness of the stale copy.
+ */
+export interface LegacyDeployedAsset {
+    kind: string;
+    name: string;
+    /** Absolute path of the stale copy. */
+    path: string;
+}
+/**
+ * A global declared dependency from `~/.skaile/skaile.yaml`, reconciled against
+ * **one** harness's global deploy dir. The same ref yields one entry per global
+ * harness (see {@link AssetManager.globalState}) so an asset can read `installed`
+ * for `claude-code` and `drift`/`declared` for `codex` simultaneously.
+ */
+export interface HarnessDeclaredAsset extends DeclaredAsset {
+    /** The global harness this state was reconciled against. */
+    harness: HarnessName;
+}
+/**
+ * Thrown by {@link AssetManager.listDeclared} when the project has no
+ * `skaile.yaml`. The CLI maps this to a `skaile init` hint.
+ */
+export declare class MissingManifestError extends Error {
+    readonly projectDir: string;
+    constructor(projectDir: string);
+}
+/**
+ * Live sync status for a repository.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface RepoStatusInfo {
+    /** Repository name as declared in `skaile.yaml`. */
+    name: string;
+    /** How the repo is sourced. */
+    kind: "local" | "remote" | "linked";
+    /** Number of commits the local clone is behind the remote. */
+    behind: number;
+    /** `true` when the local clone matches the remote HEAD. */
+    upToDate: boolean;
+    /** Error message when status check failed. */
+    error?: string;
+}
+/**
+ * A single deployed asset shown in the workspace overview.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface OverviewEntry {
+    /** Asset kind (`skill`, `agent`, `prompt`, `flow`, `contract`). */
+    kind: string;
+    /** Asset name. */
+    name: string;
+    /** Publisher that provides this asset (from the lock file; `"unknown"` when unresolvable). */
+    publisher: string;
+    /** Version string from the lock file. */
+    version: string;
+    /**
+     * Sync status relative to the source repository.
+     * - `"synced"` — local clone matches remote HEAD
+     * - `"outdated"` — local clone is behind the remote
+     * - `"local"` — sourced from a local path, no remote to compare
+     * - `"error"` — status check failed
+     * - `"unknown"` — repository not found or lock entry missing
+     */
+    syncStatus: string;
+}
+/**
+ * Aggregated workspace overview returned by `AssetManager.overview()`.
+ *
+ * @docLink packages/asset-manager/concepts#asset-manager
+ */
+export interface OverviewResult {
+    /** Entries grouped by publisher, sorted alphabetically. Each group is sorted by kind then name. */
+    byPublisher: Map<string, OverviewEntry[]>;
+    /** Total number of deployed assets. */
+    total: number;
+    /** Sync status for each configured repository. */
+    repos: RepoStatusInfo[];
+}
+/** Search, info, listDeployed, listDeclared, globalState, overview. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmReadState extends AmMcpRender {
+    protected abstract declaredPresetGaps(declared: readonly string[], lock: LockFile | null): Promise<Map<string, Array<{
+        ref: string;
+        resolvable: boolean;
+    }>>>;
+    abstract outdated(): Promise<OutdatedEntry[]>;
+    /**
+     * Search the catalog across all configured repositories.
+     *
+     * @param query - Substring to match against entry names and descriptions (case-insensitive).
+     *   Omit to return all entries.
+     * @param kind - Filter by asset kind (`"skill"`, `"agent"`, `"prompt"`, `"flow"`, `"contract"`).
+     *   Omit to return all kinds.
+     * @returns Array of matching {@link CatalogEntry} objects from all accessible repositories.
+     */
+    search(query?: string, kind?: string): Promise<CatalogEntry[]>;
+    /**
+     * On-disk root + config slug for every declared (and the implicit factory)
+     * source that has a local clone. Companion to {@link search}: callers that
+     * need to relate a scanned entry back to its source root (e.g. to stamp
+     * plugin grouping) can't recover the root from the flat
+     * {@link CatalogEntry} list `search` returns.
+     */
+    searchRepoRoots(): {
+        repoName: string;
+        root: string;
+    }[];
+    /**
+     * Look up a single asset's full catalog entry.
+     *
+     * Accepts a bare `kind:name` ref (no publisher) in addition to the fully-qualified
+     * `kind:@publisher/name` form — {@link listDeployed} emits publisher-less refs and
+     * {@link doctor} passes them straight to this method.
+     *
+     * @param ref - Asset ref in `kind:name`, `kind:@publisher/name`, or `repo/kind:name` form.
+     * @returns The matching {@link CatalogEntry}, or `null` when not found.
+     */
+    info(ref: string): Promise<DeployableEntry | null>;
+    /**
+     * List all assets currently deployed in the workspace (or global cache).
+     *
+     * Scans the framework deploy directories rather than the lock file, so it
+     * also returns assets that were installed manually or outside of `skaile install`.
+     *
+     * @param kind - Filter by asset kind. Omit to return all kinds.
+     * @returns Shallow {@link CatalogEntry} objects (description and version will be empty).
+     */
+    listDeployed(kind?: string): CatalogEntry[];
+    /**
+     * Absolute path → sha256 of every native agent file the lock records under `rendered:`. A
+     * `harness set` rewrites the lock for the new harness, so a caller that cleans up afterwards
+     * reads this first and hands it to {@link AssetManager.listStaleHarnessCopies}.
+     */
+    lockedRenderedHashes(): Map<string, string>;
+    /**
+     * Tracked assets (`skaile.lock.yaml` or declared in `skaile.yaml`) whose copy
+     * still sits in the project dirs of another harness (`.claude/…`, `.omp/…`,
+     * `.codex/…`) although this manager deploys to {@link AssetManager.harness}.
+     * A project that moved with `skaile harness set` holds orphans there that
+     * `remove` / `clean` / `list` no longer look at.
+     *
+     * Read-only: nothing is deleted. Empty for global mode and for kinds whose
+     * dir is shared with the active target (flows).
+     *
+     * @param opts.renderedBefore - {@link AssetManager.lockedRenderedHashes} of the lock as it was
+     *   before the move to this harness. An agent copy counts as skaile's only when it matches a
+     *   hash the lock (now or then) recorded for its path.
+     * @returns One {@link StaleHarnessCopy} per stale copy, sorted by harness, kind, then name.
+     */
+    listStaleHarnessCopies(opts?: {
+        renderedBefore?: ReadonlyMap<string, string>;
+    }): StaleHarnessCopy[];
+    /**
+     * @deprecated Use {@link AssetManager.listStaleHarnessCopies}, which covers every
+     * other harness folder. This returns only its `.claude/` rows (the old default
+     * deploy dir), in the old shape.
+     */
+    listLegacyClaudeDeployed(): LegacyDeployedAsset[];
+    /**
+     * List the **declared** top-level dependencies from `skaile.yaml`, each tagged
+     * with a reconciliation {@link DeclaredState}:
+     *
+     * - `declared` — in `skaile.yaml`, not yet resolved into the lock.
+     * - `installed` — declared + locked, and (for kinds with an `installTarget`)
+     *   materialized on disk. An `mcp-server` is instead checked against the
+     *   declarations the runner would actually wire (store-staged or materialized
+     *   `MCP.md`); the remaining composition-only kinds (no `installTarget`) count as
+     *   installed once locked — they are resolved at session start with no harness
+     *   footprint here.
+     * - `drift` — declared + locked but the deployed files are missing on disk.
+     * - `invalid` — the `dependencies:` entry isn't a parseable canonical ref. Only
+     *   surfaced in the unfiltered listing (a `kind` filter can't classify it).
+     *
+     * Transitive (lock-only) deps are excluded by construction — only the declared
+     * set is walked, so a lock entry with no matching `dependencies:` ref never shows.
+     *
+     * @param kind - Filter by asset kind. Omit to return all kinds.
+     * @returns One {@link DeclaredAsset} per declared dep (after the optional kind filter), plus
+     *   one per locked agent that only an agent instance of `skaile.yaml` binds.
+     * @throws {MissingManifestError} when the project has no `skaile.yaml`.
+     * @throws {Error} with a `migrate-skaile-manifest` hint on legacy `repositories:` / `ai_resources:` keys.
+     */
+    listDeclared(kind?: string): Promise<DeclaredAsset[]>;
+    /**
+     * One note per locked library asset whose library went back to an older version than the lock
+     * (`library is at 0.1.0, locked 0.3.0`). Not drift: `install` keeps the lock and only `update`
+     * moves it, so `check` and `doctor` print the note as a `!` line and still exit 0 (p1257).
+     * Empty for a global manager or when the libraries cannot be read.
+     */
+    libraryOlderNotices(): Promise<string[]>;
+    /**
+     * Locked assets whose deployed directory lacks files the deploy writes — a deleted
+     * `build.py` / `scripts/` helper next to an intact `SKILL.md`. The expected set is the file
+     * set the lock covers: a library entry's files (every file under its manifest `root:`), a
+     * source or store entry's `files[]` (the asset's whole file set at the locked commit). Only
+     * presence is checked, so a local edit never counts. An asset with no deployed directory is
+     * not listed (`listDeclared` reports it as drift); an agent is rendered, not copied, so it
+     * has no file mirror to compare. `skaile install` restores what is listed.
+     *
+     * @returns One {@link IncompleteDeploy} per affected asset; empty when healthy
+     *   or when the project has no lock.
+     */
+    incompleteDeploys(): Promise<IncompleteDeploy[]>;
+    /**
+     * Per-harness reconciliation of the **global** declared deps
+     * (`~/.skaile/skaile.yaml`) against each global harness's deploy dir. The
+     * global twin of {@link listDeclared}: the same `declared` / `installed` /
+     * `drift` / `invalid` vocabulary, but one row **per (ref, harness)** so an
+     * asset can be `installed` for `claude-code` and `drift`/`declared` for
+     * `codex` at once.
+     *
+     * Reads the SSOT + the global lock (`~/.skaile/skaile.lock.yaml`) — construct
+     * the manager with `global: true`. Unlike `listDeclared`, a missing SSOT is
+     * **not** an error: it yields an empty list (a fresh machine has no globals).
+     *
+     * @param opts.harness - Reconcile against this one harness only (the
+     *   `--harness` filter); omit for every harness in {@link targetHarnesses}.
+     * @param opts.kind - Filter by asset kind.
+     * @returns One {@link HarnessDeclaredAsset} per declared dep × harness.
+     * @throws {Error} on legacy keys in `~/.skaile/skaile.yaml` (migration hint).
+     */
+    globalState(opts?: {
+        harness?: HarnessName;
+        /** @deprecated Use `harness`. Honoured only when `harness` is absent; removed in the next major. */
+        backend?: HarnessName;
+        kind?: string;
+    }): HarnessDeclaredAsset[];
+    /**
+     * Build an aggregated workspace overview with publisher grouping and sync status.
+     *
+     * Combines deployed assets, lock file metadata, and live repository status
+     * into a single structured result. Used by `skaile status`.
+     *
+     * @returns {@link OverviewResult} with entries grouped by publisher and per-repo sync status.
+     */
+    overview(): OverviewResult;
+    /** Collect live sync status for every configured repository, keyed by name. */
+    protected buildRepoStatuses(repositories: Record<string, SourceDeclaration>): Map<string, RepoStatusInfo>;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/asset-manager/src/read/state.d.ts.map

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

package/dist/asset-manager/src/renderers.d.ts

@@ -12,6 +12,7 @@
  * Removed (no bridge harness): cursor, roo, github-copilot, gemini, amp.
  * Add them back when a bridge harness is implemented.
  */
+import { type AgentPromptMemoryBlock, type AgentPromptPart, type AgentPromptSectionsInput } from "@skaile/workspaces/core";
 import { type AgentLifecycle, type AgentManifest } from "@skaile/workspaces/types/manifests";
 import type { AbilityRef, ContractRef } from "./fragments.js";
 export type { AgentManifest };
@@ -42,7 +43,11 @@ export interface AgentRenderInput {
     /** Resolved framework fragment markdown blocks (agent-mode, handoff, skill-discovery, etc.). */
     frameworkFragments: string[];
     /** Per-project prompt extension markdown blocks loaded from `skaile.yaml` `agent.prompt-extensions`. */
-    promptExtensions: string[];
+    promptExtensions: readonly AgentPromptPart[];
+    /** Inline blocks the agent composes (`composes:` rulesets, prompts, …), baked into the prompt after the contracts. */
+    composed?: readonly AgentPromptPart[];
+    /** Memory blocks with their seed content, baked into the prompt as `<MEMORY>`. */
+    memory?: readonly AgentPromptMemoryBlock[];
     /** `standing` (long-running identity) or `role` (short-lived, callable). */
     lifecycle: AgentLifecycle;
     /** Names of the skills the agent composes (`composes[{kind: skill}]`), as installed. */
@@ -74,6 +79,11 @@ export interface AgentRenderResult {
  * @docLink packages/asset-manager/api-reference#renderers
  */
 export type AgentRenderer = (input: AgentRenderInput) => AgentRenderResult;
+/**
+ * The prompt inputs of a render input: the one input set `assembleAgent` takes, whoever asks for
+ * the prompt (the renderers here, `skaile run --dry-run --print-prompt`).
+ */
+export declare function agentPromptInput(input: Pick<AgentRenderInput, "soul" | "rules" | "duties" | "abilityRefs" | "contractRefs" | "frameworkFragments" | "promptExtensions" | "composed" | "memory">): AgentPromptSectionsInput;
 /**
  * Render a GitAgent to Claude Code's `.claude/agents/<name>.md` format.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/renderers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI9D,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,EAAE,aAAa,CAAC;IACxB,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sDAAsD;IACtD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uDAAuD;IACvD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,mGAAmG;IACnG,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kGAAkG;IAClG,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,gGAAgG;IAChG,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,wGAAwG;IACxG,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,SAAS,EAAE,cAAc,CAAC;IAC1B,wFAAwF;IACxF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gIAAgI;IAChI,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,iBAAiB,CAAC;AAoL3E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,aA6EhC,CAAC;AA2BF,sGAAsG;AACtG,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,EAAE,aAkD3B,CAAC;AAiBF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,EAAE,aA+FzB,CAAC;AAIF,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAGxC;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,GAAU,GACd,iBAAiB,CAanB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAIzD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAkBV"}
+{"version":3,"file":"renderers.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/renderers.ts"],"names":[],"mappings":"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"}

package/dist/asset-manager/src/resolve/guards.d.ts

@@ -0,0 +1,167 @@
+import { type CatalogEntry, type HarnessName, type ProvenanceCandidate, type SourceDeclaration } from "@skaile/workspaces/core";
+import { type DeployableEntry } from "../installer.js";
+import type { FolderIdentity, LibraryIndexSnapshot, LockedLibrary } from "../shared/types.js";
+import { AmResolveScan } from "./scan.js";
+/** Where a ref that misses went when its publisher changed: see {@link AssetManager.publisherChangeHints}. */
+interface PublisherChange {
+    /** The lock holds the same kind + name under this other publisher, from the library that now publishes it elsewhere. */
+    lockedAs?: string;
+    /** A registered library holds the same kind + name under another publisher: its ref and library name. */
+    moved?: {
+        ref: string;
+        library?: string;
+    };
+}
+/** One asset that several registered libraries hold, as an `add` met it. */
+interface LibraryCollision {
+    /** `kind:@publisher/name`. */
+    key: string;
+    libraries: string[];
+    /** `library (version)` per holder. */
+    held: string[];
+    chosen: string;
+    version: string;
+    /** Libraries holding the chosen version with other bytes. */
+    differing: string[];
+}
+/** Publisher change findings, library collisions, folder-collision asserts. One layer of the `AssetManager` class chain (see `asset-manager/CLAUDE.md`). */
+export declare abstract class AmResolveGuards extends AmResolveScan {
+    protected abstract lockedLibrary(origin: {
+        name: string;
+        url?: string;
+        sha256?: string;
+    }, snap: LibraryIndexSnapshot | null, asset?: {
+        kind: string;
+        publisher: string;
+        name: string;
+    }): LockedLibrary;
+    /**
+     * Where each missed publisher-qualified ref went when its publisher changed, for every
+     * ref at once (one library scan, one lock read):
+     * - `moved` when a registered library holds the same kind + name under another publisher.
+     *   When the lock ties the missed ref to a library, only that library is looked at (an
+     *   asset of the same name in another library is a different asset). Without a lock
+     *   entry, a library asset the project already declares or locks under its own ref is
+     *   not offered, and two candidate publishers are ambiguous: no hint;
+     * - `lockedAs` when the lock holds the same kind + name under another publisher, records
+     *   the library it came from, and that library now holds the asset under yet another
+     *   publisher than the locked one. An unrelated asset that merely shares kind + name does
+     *   not qualify.
+     *
+     * @param refs - Missed refs; a trailing `(reason)` after the first space is ignored.
+     * @returns one finding per ref that has one. Never warns.
+     */
+    protected publisherChangeFindings(refs: string[]): Promise<Map<string, PublisherChange>>;
+    /**
+     * Explain misses caused by a publisher change, as parenthesized hint text per ref:
+     * `did you mean <ref>?` when a registered library holds the same kind + name under
+     * another publisher, and `locked as <lockRef>; run skaile install to re-resolve` when
+     * the lock holds it under the library's previous publisher (see
+     * {@link AssetManager.publisherChangeFindings}).
+     *
+     * @param refs - Missed refs; a trailing `(reason)` after the first space is ignored.
+     * @returns hint text per ref, only for refs that have one. Never warns.
+     */
+    protected publisherChangeHints(refs: string[]): Promise<Record<string, string>>;
+    /**
+     * What the user has to change for each ref that is locked from a library but resolves
+     * nowhere any more, where `skaile install` cannot help: the library is not registered
+     * (renamed away or removed), the library now publishes the asset under another
+     * publisher, or the library no longer holds it. A ref the lock does not tie to a
+     * library has no entry.
+     *
+     * @param refs - Declared or locked refs, `kind:@publisher/name` (a trailing `(reason)`
+     *   after the first space is ignored).
+     * @returns a phrase per ref that follows the ref name, without parentheses.
+     */
+    protected unresolvedFixes(refs: string[]): Promise<Map<string, string>>;
+    /**
+     * A ref pinned to a version its library never held (`#9.9.9`): the thing to change is the pin
+     * in `skaile.yaml`, not the library (p1096). Sets the fix and returns `true` when it applies.
+     */
+    protected pinNeverHeld(ref: string, plain: string, lookup: LockedLibrary, out: Map<string, string>): Promise<boolean>;
+    /**
+     * The ref a library now holds a flow under when a project still locks it by the slug of the
+     * flow's `name:` (5.12.0 named a flow by `name:`; later releases name it by `id:`), or
+     * `undefined` when `kind` is no flow, the library is not at hand or no flow of it matches.
+     */
+    protected renamedFlowRef(lookup: LockedLibrary, publisher: string | undefined, kind: string, name: string): Promise<string | undefined>;
+    /** Collision messages already printed by this instance (one warning per ref + library set). */
+    protected readonly warnedLibraryCollisions: Set<string>;
+    /**
+     * Collisions of one `add`, held back until {@link flushLibraryCollisions} so a dependency
+     * tree that touches several colliding assets prints one summary, not one line per asset
+     * (p1097). `null` outside an `add`: a collision then warns at once.
+     */
+    protected collisionBatch: Map<string, LibraryCollision> | null;
+    /**
+     * Warn once when `key` is held by more than one library: names every library
+     * with its version and the one chosen, so a silent pick can't surprise.
+     */
+    protected warnLibraryCollision(key: string, candidates: Array<{
+        entry: CatalogEntry;
+        library: string;
+    }>, chosen: {
+        entry: CatalogEntry;
+        library: string;
+    }, differing?: string[]): void;
+    /** Print each distinct collision message once; the sink also gets the keys it names. */
+    protected emitLibraryCollision(msg: string, keys: readonly string[]): void;
+    /**
+     * End the batch of {@link collisionBatch}: one collision prints its full message; several
+     * print one summary (how many libraries and assets, the library each asset came from, the
+     * assets whose bytes differ). `verboseCollisions` prints every asset's full message instead.
+     */
+    protected flushLibraryCollisions(): void;
+    /** Kind, name and bare publisher of a deploy entry; the publisher comes from its canonical ref. */
+    protected entryIdentity(entry: CatalogEntry): FolderIdentity;
+    /**
+     * Refuse to lock a source commit another machine cannot check out. A commit made in the clone
+     * itself (or one `source sync` could not fast-forward past) is in no remote branch: the lock
+     * would name bytes nobody else has, and `install --locked` there could not restore them.
+     * Linked (dev-override) and user-owned local sources are never checked: their lock is
+     * machine-local by choice.
+     *
+     * @param resolved - Candidates about to be locked.
+     * @param repositories - Source declarations of the project.
+     * @throws With `<url> clone has unpublished commit <sha>` and the way out.
+     */
+    protected assertSourceCommitsPublished(resolved: readonly ProvenanceCandidate[], repositories: Record<string, SourceDeclaration>): void;
+    /**
+     * Refuse assets of one kind and name from different publishers: they deploy into the
+     * same folder, so the later one would silently overwrite the earlier. Throws one line
+     * naming the folder and the asset that holds it.
+     *
+     * @param incoming - Assets about to be deployed. Two of them clashing is refused.
+     * @param held - Assets the project already declares or has locked; one of them
+     *   clashing with an incoming asset is refused when its folder is on disk.
+     */
+    protected assertNoFolderCollision(incoming: FolderIdentity[], held?: FolderIdentity[]): void;
+    /**
+     * Refuse to deploy over a folder (or agent file) the project did not put there: it is on disk,
+     * but no lock entry of the same kind and name owns it, so it is the user's own work and the
+     * deploy would replace it and `remove` would delete it. Throws one line naming the folder.
+     *
+     * A folder the deploy would rewrite with the same content is adopted silently (the way back
+     * from `asset import`: the project's own copy is what the library now holds): every file in
+     * it is shipped by the asset with the same bytes, or the same body and an asset frontmatter
+     * that only adds to the folder's (import normalizes it). Nothing is lost then.
+     *
+     * @param incoming - Assets about to be deployed, with the entry whose bytes would be written
+     *   when there is one.
+     * @param owned - Assets the lock holds; one of the same kind and name, from any publisher,
+     *   owns the folder (a publisher clash is {@link assertNoFolderCollision}'s refusal).
+     */
+    protected assertNoUnownedFolder(incoming: Array<{
+        id: FolderIdentity;
+        entry?: DeployableEntry | null;
+    }>, owned: FolderIdentity[]): Promise<void>;
+    /**
+     * Whether deploying `entry` over the folder already in `target` loses nothing: the folder
+     * holds no file the asset does not ship, and each of its files equals the asset's, or is a
+     * markdown file with the same body whose frontmatter the asset's only extends.
+     */
+    protected deployWouldOnlyRewriteSame(entry: DeployableEntry, target: HarnessName): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=guards.d.ts.map

package/dist/asset-manager/src/resolve/guards.d.ts.map

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