@skaile/workspaces 0.8.5

package/dist/asset-manager/src/catalog-deployer.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Platform-triggered asset deployment.
+ *
+ * Takes catalog entries (with source_path relative to ai-assets/) and deploys
+ * them to a session's .claude/skills/ directory. Handles skill context injection
+ * and catalog priority-based name resolution.
+ */
+/**
+ * A single user-facing input parameter declared in a SKILL.md.
+ *
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export interface InputSpec {
+    /** Input parameter key used in skill invocation. */
+    key: string;
+    /** Whether the input must be provided before running the skill. */
+    required?: boolean;
+    /** Question string shown to the user when collecting this input. */
+    prompt?: string;
+    /** Short display label for UI forms. */
+    label?: string;
+    /** Input data type hint (e.g. `"string"`, `"number"`, `"file"`). */
+    type?: string;
+    /** Additional guidance text shown alongside the input field. */
+    hint?: string;
+}
+/**
+ * A compiled catalog entry (skill or flow).
+ *
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export interface CatalogEntryCompiled {
+    /** Unique ID in `domain/name` form (e.g. `skaileup-conceptualization/cf_overview`). */
+    id: string;
+    /** Asset kind. */
+    kind: "skill" | "flow";
+    /** Human-readable asset name. */
+    name: string;
+    /** One-line description. */
+    description: string;
+    /** Semantic version string. */
+    version: string;
+    /** Maturity stage. */
+    stage: "alpha" | "beta" | "stable";
+    /** Searchable keywords. */
+    keywords: string[];
+    /** User-facing input specifications. */
+    inputs: InputSpec[];
+    /** Domain directory name. */
+    source_domain: string;
+    /** Asset path relative to assetsRoot. */
+    source_path: string;
+    /** Optional icon identifier. */
+    icon?: string;
+    /** Flow-only: required skill names. */
+    required_skills?: string[];
+    /** Flow-only: optional skill names. */
+    optional_skills?: string[];
+}
+/**
+ * Options controlling how platform-triggered skill deployment is performed.
+ *
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export interface DeployFromCatalogOptions {
+    /** Root directory of ai-assets (where `source_path` in catalog entries is relative to). */
+    assetsRoot: string;
+    /** Target directory for deployed skills (e.g. `/workspace/.claude/skills/`). */
+    skillsDir: string;
+    /** Optional context markdown appended to the deployed skill directory as `CONTEXT.md`. */
+    context?: string;
+}
+/**
+ * Result of a platform-triggered batch skill deployment.
+ *
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export interface DeployResult {
+    /** IDs of catalog entries successfully deployed. */
+    deployed: string[];
+    /** IDs of catalog entries skipped (non-skill kinds). */
+    skipped: string[];
+    /** Error messages for entries that could not be deployed. */
+    errors: string[];
+}
+/**
+ * Deploy a single catalog entry to the session skills directory.
+ *
+ * Copies the entire skill source directory into `skillsDir/<entry.name>/`.
+ * If `context` is provided, a separate `CONTEXT.md` is written alongside
+ * `SKILL.md` so the source file is never modified.
+ *
+ * Only `skill` entries are deployable; other kinds return an error.
+ *
+ * @param entry - Compiled catalog entry to deploy.
+ * @param options - Deployment target and optional context.
+ * @returns `{ success: true }` on success, `{ success: false, error }` on failure.
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export declare function deployCatalogEntry(entry: CatalogEntryCompiled, options: DeployFromCatalogOptions): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Remove a deployed skill directory from the session skills directory.
+ *
+ * @param name - Skill name (directory basename under `skillsDir`).
+ * @param skillsDir - Absolute path to the session skills directory.
+ * @returns `true` if the skill was found and removed; `false` if it was not deployed.
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export declare function undeployCatalogEntry(name: string, skillsDir: string): boolean;
+/**
+ * Deploy multiple catalog entries in a single batch operation.
+ *
+ * Non-skill entries (flows, agents, etc.) are automatically skipped and
+ * recorded in `result.skipped`. Deployment failures are collected in
+ * `result.errors` without aborting the rest of the batch.
+ *
+ * @param entries - Compiled catalog entries to deploy.
+ * @param options - Deployment target and optional context.
+ * @returns Aggregated {@link DeployResult} with deployed, skipped, and error lists.
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export declare function deployAll(entries: CatalogEntryCompiled[], options: DeployFromCatalogOptions): DeployResult;
+/**
+ * Resolve a flow's skill dependencies from the full catalog entry list.
+ *
+ * Partitions `flow.required_skills` and `flow.optional_skills` into resolved
+ * entries and a list of names that could not be found. Missing optional skills
+ * are silently ignored (they do not appear in `missing`).
+ *
+ * @param flow - Compiled flow entry whose skill dependencies should be resolved.
+ * @param allEntries - Full set of compiled catalog entries to search.
+ * @returns Object containing resolved `required` entries, resolved `optional` entries,
+ *   and `missing` skill names that were listed as required but not found.
+ * @docLink packages/asset-manager/concepts#catalog-deployer
+ */
+export declare function resolveFlowSkills(flow: CatalogEntryCompiled, allEntries: CatalogEntryCompiled[]): {
+    required: CatalogEntryCompiled[];
+    optional: CatalogEntryCompiled[];
+    missing: string[];
+};
+//# sourceMappingURL=catalog-deployer.d.ts.map

package/dist/asset-manager/src/catalog-deployer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-deployer.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/catalog-deployer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wCAAwC;IACxC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,2FAA2F;IAC3F,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,wBAAwB,GAChC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA8BtC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,EAAE,wBAAwB,GAChC,YAAY,CAkBd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,oBAAoB,EAC1B,UAAU,EAAE,oBAAoB,EAAE,GACjC;IAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB3F"}

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

@@ -0,0 +1,133 @@
+/**
+ * Git contribution workflow — commit, push, PR for repo changes.
+ *
+ * Enables editing assets in cloned repos and contributing changes back upstream.
+ */
+/**
+ * A single file that has been modified in a repository working tree.
+ *
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export interface LocalChange {
+    /** Short git status code (e.g. `"M"`, `"A"`, `"D"`). */
+    status: string;
+    /** Path to the changed file, relative to the repository root. */
+    path: string;
+}
+/**
+ * Comparison between a local repository clone and its upstream remote.
+ *
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export interface ForkComparison {
+    /** Number of commits the local clone is ahead of the upstream branch. */
+    ahead: number;
+    /** Number of commits the local clone is behind the upstream branch. */
+    behind: number;
+    /** Files changed in local commits not yet pushed to upstream. */
+    aheadFiles: string[];
+    /** Files changed in upstream commits not yet pulled locally. */
+    behindFiles: string[];
+    /** Error message if the comparison could not be performed. */
+    error?: string;
+}
+/**
+ * Result of a repository sync operation.
+ *
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export interface SyncResult {
+    /** Number of catalog entries found after syncing. */
+    count: number;
+    /** Error message when the sync failed. */
+    error?: string;
+}
+/**
+ * List uncommitted changes in a local repository clone.
+ *
+ * @param repoDir - Absolute path to the repository root.
+ * @returns Array of changed files with their git status codes. Returns `[]` when the
+ *   directory is not a git repository or `git status` fails.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function localChanges(repoDir: string): LocalChange[];
+/**
+ * Return `true` when the repository has uncommitted changes.
+ *
+ * @param repoDir - Absolute path to the repository root.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function hasLocalChanges(repoDir: string): boolean;
+/**
+ * Return the unified diff of all uncommitted changes in the repository.
+ *
+ * @param repoDir - Absolute path to the repository root.
+ * @returns Unified diff output from `git diff HEAD`, or `""` when there are no changes
+ *   or the directory is not a git repository.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function getDiff(repoDir: string): string;
+/**
+ * Stage all changes and create a commit in the repository clone.
+ *
+ * If `branch` is provided, creates or switches to that branch before committing.
+ *
+ * @param repoDir - Absolute path to the repository root.
+ * @param message - Git commit message.
+ * @param branch - Branch name to create or switch to before committing.
+ * @returns `[true, commitOutput]` on success, `[false, errorMessage]` on failure.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function commitChanges(repoDir: string, message: string, branch?: string): [boolean, string];
+/**
+ * Push a local branch to a remote URL (adds it as a `"fork"` git remote).
+ *
+ * @param repoDir - Absolute path to the repository root.
+ * @param remoteUrl - Remote URL to push to (e.g. a GitHub fork's HTTPS/SSH URL).
+ * @param branch - Local branch name to push.
+ * @returns `[true, ""]` on success, `[false, errorMessage]` on failure.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function pushToRemote(repoDir: string, remoteUrl: string, branch: string): [boolean, string];
+/**
+ * Open a pull request on GitHub using the `gh` CLI.
+ *
+ * @param upstreamUrl - GitHub repository URL or `owner/repo` identifier.
+ * @param title - Pull request title.
+ * @param body - Pull request description (Markdown).
+ * @param head - Branch name containing the changes.
+ * @param base - Base branch to merge into. Defaults to `"main"`.
+ * @returns `[true, prUrl]` on success, `[false, errorMessage]` on failure.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function createPr(upstreamUrl: string, title: string, body: string, head: string, base?: string): [boolean, string];
+/**
+ * Compare a local repository clone with its upstream remote.
+ *
+ * Temporarily registers `upstream` as the `"upstream"` git remote, fetches the
+ * specified branch, and counts diverging commits in both directions.
+ *
+ * @param repoDir - Absolute path to the local repository clone.
+ * @param upstream - Remote URL of the upstream repository.
+ * @param branch - Branch to compare against. Defaults to `"main"`.
+ * @returns {@link ForkComparison} with ahead/behind counts and changed file lists.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function compareWithUpstream(repoDir: string, upstream: string, branch?: string): ForkComparison;
+/**
+ * List files added or modified locally compared with an upstream branch.
+ *
+ * Fetches the upstream branch and returns only the files that exist in the local
+ * branch but not in upstream (additions and modifications, not deletions).
+ *
+ * @param repoDir - Absolute path to the local repository clone.
+ * @param upstream - Remote URL of the upstream repository.
+ * @param branch - Upstream branch to compare against. Defaults to `"main"`.
+ * @returns Object with `files` list and an optional `error` string on failure.
+ * @docLink packages/asset-manager/api-reference#contrib
+ */
+export declare function listAdditions(repoDir: string, upstream: string, branch?: string): {
+    files: string[];
+    error?: string;
+};
+//# sourceMappingURL=contrib.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contrib.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/contrib.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gEAAgE;IAChE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAQ3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAI/C;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,CAAC,OAAO,EAAE,MAAM,CAAC,CAanB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,CAAC,OAAO,EAAE,MAAM,CAAC,CAWnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,SAAS,GACZ,CAAC,OAAO,EAAE,MAAM,CAAC,CAqBnB;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAS,GACd,cAAc,CA0ChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAS,GACd;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAqBrC"}

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

@@ -0,0 +1,111 @@
+/**
+ * Framework fragments — conditional system prompt sections injected by the
+ * agent renderer at install time.
+ *
+ * Each fragment explains a specific aspect of the agent framework to the agent.
+ * Fragments are conditional (return null when context is empty) and overridable
+ * per project via skaile.yaml `agent.fragments`.
+ */
+/**
+ * A skill installed into the agent's ability directory, referenced in the system prompt.
+ *
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export interface AbilityRef {
+    /** Skill name used as the slash command (e.g. `"code-review"`). */
+    name: string;
+    /** One-line description shown in the `## Installed Abilities` section. */
+    description: string;
+}
+/**
+ * A contract file installed alongside skills, referenced by path in the system prompt.
+ *
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export interface ContractRef {
+    /** Contract name for display purposes. */
+    name: string;
+    /** Path relative to workspace root, e.g. `".claude/skills/iron-laws/CONTRACT.md"`. */
+    relativePath: string;
+}
+/**
+ * A data connector declared in `skaile.yaml` resources.
+ *
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export interface ConnectorRef {
+    /** Connector ID as declared in `skaile.yaml`. */
+    id: string;
+    /** Connector driver type (e.g. `"postgres"`, `"redis"`, `"sqlite"`). */
+    driver: string;
+    /** Declared access level (`"read-only"` or `"read-write"`). */
+    access: string;
+}
+/**
+ * Context passed to each fragment function at render time.
+ *
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export interface FragmentContext {
+    /** Agent framework ID (e.g. `"claude-code"`, `"omp"`, `"codex"`). */
+    framework: string;
+    /** Relative path to the framework's skill/ability directory, e.g. `".claude/skills"`. */
+    skillsDir: string;
+    /** Relative path to the framework's agent directory, e.g. `".claude/agents"`. */
+    agentsDir: string;
+    /** Sub-agent names from `manifest.requires[]`. */
+    subAgents: string[];
+    /** Connectors declared in `skaile.yaml`. */
+    connectors: ConnectorRef[];
+    /** Resolved ability refs (installed skills). */
+    abilityRefs: AbilityRef[];
+    /** Resolved contract refs (installed alongside skills). */
+    contractRefs: ContractRef[];
+}
+/**
+ * Identifier for a built-in system prompt fragment.
+ * - `"agent-mode"` — describes whether the agent is a sole agent or an orchestrator.
+ * - `"handoff"` — delegation guidelines injected when sub-agents are declared.
+ * - `"skill-discovery"` — skill directory location injected when abilities are installed.
+ * - `"connector-usage"` — connected resources list injected when connectors are declared.
+ *
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export type FragmentId = "agent-mode" | "handoff" | "skill-discovery" | "connector-usage";
+/**
+ * Registry of all built-in fragment functions keyed by {@link FragmentId}.
+ *
+ * Each function receives a {@link FragmentContext} and returns the fragment markdown
+ * to inject, or `null` when the fragment's condition is not met (e.g. `"handoff"`
+ * returns `null` when there are no sub-agents).
+ *
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export declare const BUILT_IN_FRAGMENTS: Record<FragmentId, (ctx: FragmentContext) => string | null>;
+/**
+ * Resolve all framework fragments for the rendered system prompt.
+ *
+ * Applies per-project overrides from `skaile.yaml` `agent.fragments`:
+ * - `true` / absent → include built-in fragment (default)
+ * - `false` → omit fragment
+ * - `string` → load markdown from path relative to `workspaceRoot`
+ *
+ * @param ctx - Fragment context built from the agent manifest and workspace config.
+ * @param overrides - Per-project overrides map from `skaile.yaml` `agent.fragments`.
+ * @param workspaceRoot - Absolute path to the workspace root (for resolving custom fragment paths).
+ * @returns Ordered list of resolved fragment markdown strings to inject into the system prompt.
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export declare function resolveFragments(ctx: FragmentContext, overrides: Record<string, boolean | string> | undefined, workspaceRoot: string): string[];
+/**
+ * Load prompt-extension files declared under `skaile.yaml` `agent.prompt-extensions`.
+ *
+ * Paths are relative to `workspaceRoot`. Missing files are silently skipped.
+ *
+ * @param paths - Array of relative file paths from `skaile.yaml` `agent.prompt-extensions`.
+ * @param workspaceRoot - Absolute path to the workspace root.
+ * @returns Non-empty content strings for each file that exists and is non-empty.
+ * @docLink packages/asset-manager/api-reference#fragments
+ */
+export declare function loadPromptExtensions(paths: string[] | undefined, workspaceRoot: string): string[];
+//# sourceMappingURL=fragments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/fragments.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4CAA4C;IAC5C,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,gDAAgD;IAChD,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AA0F1F;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,GAAG,IAAI,CAK1F,CAAC;AAIF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,eAAe,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,GAAG,SAAS,EACvD,aAAa,EAAE,MAAM,GACpB,MAAM,EAAE,CA4BV;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CASjG"}

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

@@ -0,0 +1,52 @@
+/**
+ * Project-local action history — tracks add/remove/update actions.
+ * Stored at .skaile/history.yaml within the project directory.
+ */
+/**
+ * A single record in the project's asset action history.
+ *
+ * @docLink packages/asset-manager/api-reference#history
+ */
+export interface HistoryEntry {
+    /** Asset ref in `kind:name` form (e.g. `skill:my-skill`). */
+    ref: string;
+    /** Action performed on the asset. */
+    action: "add" | "remove" | "update";
+    /** ISO 8601 timestamp of when the action was recorded. */
+    timestamp: string;
+    /** Whether this action was performed in project scope or global-install scope. */
+    context: "project" | "global";
+}
+/**
+ * Load all history entries from `.skaile/history.yaml` in the project directory.
+ *
+ * @param projectDir - Absolute path to the workspace root.
+ * @returns Array of history entries, oldest first. Returns `[]` when the file does not exist.
+ * @docLink packages/asset-manager/api-reference#history
+ */
+export declare function loadHistory(projectDir: string): HistoryEntry[];
+/**
+ * Append a single action to the history log, capping the total at 500 entries.
+ *
+ * @param projectDir - Absolute path to the workspace root.
+ * @param entry - The history entry to record.
+ * @docLink packages/asset-manager/api-reference#history
+ */
+export declare function appendHistory(projectDir: string, entry: HistoryEntry): void;
+/**
+ * Return the most recent history entries, newest first.
+ *
+ * @param projectDir - Absolute path to the workspace root.
+ * @param limit - Maximum number of entries to return. Defaults to `20`.
+ * @returns Most recent entries in reverse-chronological order.
+ * @docLink packages/asset-manager/api-reference#history
+ */
+export declare function getRecentHistory(projectDir: string, limit?: number): HistoryEntry[];
+/**
+ * Erase all history entries by writing an empty list to `.skaile/history.yaml`.
+ *
+ * @param projectDir - Absolute path to the workspace root.
+ * @docLink packages/asset-manager/api-reference#history
+ */
+export declare function clearHistory(projectDir: string): void;
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../asset-manager/src/history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC/B;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAiB9D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAO3E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAIrD"}