@cleocode/caamp 2026.5.82 → 2026.5.84

package/dist/{hooks-5EXBKPII.js → hooks-ZN3C4WCK.js}

@@ -24,8 +24,8 @@ import {
   toNative,
   toNativeBatch,
   translateToAll
-} from "./chunk-SV33CE5X.js";
-import "./chunk-OCI4RYI5.js";
+} from "./chunk-QKC2JRSG.js";
+import "./chunk-H5YXR2DC.js";
 export {
   CANONICAL_HOOK_EVENTS,
   HOOK_CATEGORIES,
@@ -53,4 +53,4 @@ export {
   toNativeBatch,
   translateToAll
 };
-//# sourceMappingURL=hooks-5EXBKPII.js.map
+//# sourceMappingURL=hooks-ZN3C4WCK.js.map

package/dist/index.d.ts

@@ -2,6 +2,205 @@ import { WorktreeHandle } from '@cleocode/cant';
 import { PlatformPaths, SystemInfo } from '@cleocode/paths';
 export { PlatformPaths, SystemInfo } from '@cleocode/paths';
 
+/**
+ * `cleo skills doctor bridge` — single bridge symlink + per-skill symlink removal.
+ *
+ * @remarks
+ * Implements the canonical discovery topology described in
+ * `docs/architecture/SG-CLEO-SKILLS-architecture-v3.md` §1:
+ *
+ * - `~/.cleo/skills/<name>/` is the per-user install root (Sphere A + B).
+ * - `~/.claude/skills/agents-shared/<name>` is a symlink INTO `~/.cleo/skills/`
+ *   for each installed skill — Claude Code's hardcoded discovery mount.
+ * - `~/.agents/skills` is the SINGLE bridge symlink → `~/.claude/skills/agents-shared`
+ *   used by every non-Claude harness (Cursor, Aider, Codeium, etc.).
+ *
+ * The bridge command takes a host machine from any pre-v3 state and:
+ *
+ * 1. Ensures `~/.claude/skills/agents-shared/` exists (mkdir -p).
+ * 2. Creates a symlink under `agents-shared/` for every skill currently in
+ *    `~/.cleo/skills/` whose target is missing or wrong.
+ * 3. Atomically replaces `~/.agents/skills` with a symlink to
+ *    `~/.claude/skills/agents-shared`. If the existing `~/.agents/skills` is a
+ *    REAL directory with contents, the command refuses without `--force` and
+ *    backs up to `~/.cleo/backups/agents-skills-pre-bridge-YYYYMMDD-HHmmss/`
+ *    when `--force` is supplied.
+ * 4. Rips per-skill symlinks under `~/.claude/skills/*` that point OUTSIDE
+ *    `agents-shared/` (orphans from the old per-skill fan-out model).
+ *
+ * The handler is pure-functional with a dependency-injected `homeDir` so it
+ * can be exercised against tmpfs fixtures in unit tests without touching the
+ * real user environment.
+ *
+ * @see {@link docs/architecture/SG-CLEO-SKILLS-architecture-v3.md} §1
+ * @task T9655
+ * @epic T9571
+ * @public
+ */
+
+/**
+ * One symlink that was created (or would be created in `--dry-run`).
+ *
+ * @public
+ */
+interface BridgeSymlinkRecord {
+    /** Skill basename, e.g. `ct-orchestrator`. */
+    name: string;
+    /** Absolute path of the symlink under `~/.claude/skills/agents-shared/`. */
+    linkPath: string;
+    /** Absolute path of the symlink target inside `~/.cleo/skills/`. */
+    target: string;
+}
+/**
+ * One per-skill symlink that was removed (or would be removed in `--dry-run`).
+ *
+ * @public
+ */
+interface PerSkillSymlinkRemoval {
+    /** Absolute path of the symlink that was removed. */
+    linkPath: string;
+    /** Resolved target the symlink pointed at, or `null` when unreadable. */
+    previousTarget: string | null;
+}
+/**
+ * LAFS-shaped result payload emitted by {@link runDoctorBridge}.
+ *
+ * @public
+ */
+interface DoctorBridgeResult {
+    /** Whether this run materially changed disk state. `false` on idempotent re-runs. */
+    bridgeCreated: boolean;
+    /**
+     * Whether `~/.agents/skills` is now a symlink to `~/.claude/skills/agents-shared`.
+     *
+     * @remarks
+     * Always `true` after a successful run. `false` only when `--dry-run` was
+     * requested and the bridge had to be created.
+     */
+    bridgeSymlinkActive: boolean;
+    /** Symlinks created under `~/.claude/skills/agents-shared/` (or planned in dry-run). */
+    perSkillSymlinksCreated: BridgeSymlinkRecord[];
+    /** Per-skill symlinks under `~/.claude/skills/*` that were removed (or planned). */
+    perSkillSymlinksRemoved: PerSkillSymlinkRemoval[];
+    /**
+     * Absolute backup path when the existing `~/.agents/skills` real dir was
+     * relocated to make room for the bridge symlink. `null` when no backup was
+     * needed.
+     */
+    backupPath: string | null;
+    /** `true` when `--dry-run` was passed and no disk state was mutated. */
+    dryRun: boolean;
+    /** Resolved skills root, e.g. `~/.cleo/skills`. */
+    skillsRoot: string;
+    /** Resolved bridge target, e.g. `~/.claude/skills/agents-shared`. */
+    bridgeTarget: string;
+    /** Resolved bridge symlink path, e.g. `~/.agents/skills`. */
+    bridgePath: string;
+}
+/**
+ * Dependency-injected options accepted by {@link runDoctorBridge}.
+ *
+ * @public
+ */
+interface DoctorBridgeOptions {
+    /**
+     * Override the home directory. Defaults to {@link homedir}.
+     *
+     * @remarks
+     * Tests pass a tmpfs root so the bridge logic can be exercised end-to-end
+     * without touching the real user environment.
+     */
+    homeDir?: string;
+    /**
+     * Allow the command to clobber an existing real `~/.agents/skills` directory.
+     *
+     * @remarks
+     * When `false` (the default) and `~/.agents/skills` is a non-empty real
+     * directory, the command refuses with `E_AGENTS_SKILLS_REAL_DIR` to preserve
+     * user data. When `true`, the directory is moved to
+     * `~/.cleo/backups/agents-skills-pre-bridge-<ts>/` before the bridge symlink
+     * is created.
+     *
+     * @defaultValue `false`
+     */
+    force?: boolean;
+    /**
+     * Plan-only mode. When `true`, no disk state is mutated; the result still
+     * lists what WOULD happen.
+     *
+     * @defaultValue `false`
+     */
+    dryRun?: boolean;
+}
+/**
+ * Error thrown when {@link runDoctorBridge} refuses to clobber a real
+ * `~/.agents/skills` directory and `--force` was not passed.
+ *
+ * @public
+ */
+declare class AgentsSkillsRealDirError extends Error {
+    /** LAFS error code surfaced by the CLI. */
+    readonly code: "E_AGENTS_SKILLS_REAL_DIR";
+    /** Resolved path of the offending real directory. */
+    readonly agentsSkillsPath: string;
+    /** Number of immediate entries in the offending directory. */
+    readonly entryCount: number;
+    /**
+     * Construct an `AgentsSkillsRealDirError`.
+     *
+     * @param agentsSkillsPath - Path to the real `~/.agents/skills` directory.
+     * @param entryCount - Number of entries inside the directory.
+     */
+    constructor(agentsSkillsPath: string, entryCount: number);
+}
+/**
+ * Generate a deterministic backup-suffix timestamp `YYYYMMDD-HHmmss` (UTC).
+ *
+ * @remarks
+ * Pulled out as a helper so callers (and tests) can deterministically compute
+ * the expected backup path without re-implementing the format. The string is
+ * UTC so backups taken on different machines round-trip identically.
+ *
+ * @returns Timestamp suffix string for backup directory naming.
+ */
+declare function buildBackupTimestamp(): string;
+/**
+ * Execute the bridge flow described in the module docblock.
+ *
+ * @remarks
+ * Order of operations:
+ *
+ * 1. Ensure `~/.claude/skills/agents-shared/` exists.
+ * 2. For each skill in `~/.cleo/skills/`, ensure
+ *    `~/.claude/skills/agents-shared/<name>` → `~/.cleo/skills/<name>` exists.
+ * 3. Rip every per-skill entry under `~/.claude/skills/` that is a symlink
+ *    pointing OUTSIDE `agents-shared/` — those are orphans from the old
+ *    per-skill fan-out model and must be deleted.
+ * 4. Replace `~/.agents/skills` with a symlink to `~/.claude/skills/agents-shared`.
+ *    If it is currently a real directory, refuse unless `options.force` is
+ *    `true`, in which case back up to
+ *    `~/.cleo/backups/agents-skills-pre-bridge-<ts>/` first.
+ *
+ * Idempotency invariant: re-running on a fully-bridged tree returns
+ * `{ bridgeCreated: false, bridgeSymlinkActive: true, perSkillSymlinksCreated: [], perSkillSymlinksRemoved: [], backupPath: null }`.
+ *
+ * @param options - Dependency-injected options (homeDir / force / dry-run).
+ * @returns Materialized {@link DoctorBridgeResult} reflecting the run.
+ * @throws AgentsSkillsRealDirError when `~/.agents/skills` is a non-empty real
+ *   directory and `options.force` is not set.
+ *
+ * @example
+ * ```typescript
+ * import { runDoctorBridge } from '@cleocode/caamp';
+ *
+ * const result = await runDoctorBridge({ homeDir: '/tmp/test-home' });
+ * console.log(result.perSkillSymlinksCreated.length); // # of new bridge symlinks
+ * ```
+ *
+ * @public
+ */
+declare function runDoctorBridge(options?: DoctorBridgeOptions): Promise<DoctorBridgeResult>;
+
 /**
  * Priority tier identifier stored in registry.json.
  *
@@ -3002,10 +3201,103 @@ declare function removeConfig(filePath: string, format: ConfigFormat, key: strin
 /**
  * Skill installer - canonical + symlink model
  *
- * Skills are stored once in a canonical location (.agents/skills/<name>/)
- * and symlinked to each target agent's skills directory.
+ * Skills are stored once in a canonical location (`~/.cleo/skills/<name>/`
+ * per architecture-v3 §1, with legacy `~/.local/share/agents/skills/` as a
+ * read-only fallback for one release cycle) and symlinked to each target
+ * agent's skills directory.
+ *
+ * @task T9659
+ * @epic T9571
+ * @saga T9560
  */
 
+/**
+ * Source-type discriminator emitted with {@link SkillRowData}.
+ *
+ * @remarks
+ * Mirrors the `source_type` column on the `skills` table defined in
+ * architecture-v3 §4. Kept as a local string-literal union (NOT a
+ * `@cleocode/core` import) so caamp stays free of a circular dep on core —
+ * the dispatch layer in `packages/cleo/` is responsible for plugging the
+ * `upsertSkillRow` callback that consumes this shape.
+ *
+ * @public
+ */
+type SkillRowSourceType = 'canonical' | 'user' | 'community' | 'agent-created';
+/**
+ * Provenance payload emitted by {@link installSkill} after a successful copy.
+ *
+ * @remarks
+ * The CAAMP installer ONLY emits this shape — it never writes to
+ * `skills.db` directly. The dispatch layer in `packages/cleo/` (where it's
+ * legal to import from `@cleocode/core`) plugs an `upsertSkillRow` callback
+ * via {@link InstallSkillOptions.recordRow}. This keeps caamp free of a
+ * `@cleocode/core` dependency (mirrors the migration callback pattern
+ * established by T9653 — see `migration.ts`).
+ *
+ * @public
+ */
+interface SkillRowData {
+    /** Skill folder basename (matches `skills.name` column). */
+    name: string;
+    /** Resolved canonical install path under `~/.cleo/skills/<name>/`. */
+    installPath: string;
+    /** Source URL or identifier (matches `skills.source_url`). */
+    sourceUrl: string | null;
+    /**
+     * Source provenance discriminator (matches `skills.source_type`).
+     *
+     * @remarks
+     * Set to `'canonical'` for skills whose name appears in the bundled
+     * Sphere A manifest; `'community'` for marketplace / GitHub-clone installs;
+     * `'user'` for everything else (local-path installs, library installs).
+     * Architecture-v3 §4 enumerates the full set.
+     */
+    sourceType: SkillRowSourceType;
+}
+/**
+ * Optional knobs accepted by {@link installSkill}.
+ *
+ * @remarks
+ * Encoded as an interface so future T-STORE follow-ups (e.g. `pinned`,
+ * `version`) can be added without churning the call sites.
+ *
+ * @public
+ */
+interface InstallSkillOptions {
+    /**
+     * Per-install sink invoked after a successful canonical copy.
+     *
+     * @remarks
+     * Caamp NEVER imports `@cleocode/core` directly — the dispatch layer in
+     * `packages/cleo/` plugs `upsertSkillRow` here so installs are recorded
+     * to `~/.cleo/skills.db`. Defaults to a no-op when omitted. May be sync
+     * or async; thrown errors propagate to the caller.
+     */
+    recordRow?: (row: SkillRowData) => Promise<void> | void;
+    /**
+     * Explicit `sourceUrl` to record on the row.
+     *
+     * @remarks
+     * When omitted, falls back to the `sourcePath` argument. Callers that
+     * resolve a library or marketplace identifier (e.g. `library:ct-foo` or
+     * `https://github.com/owner/repo`) BEFORE copying to a tmpdir should set
+     * this so the row preserves the original provenance string instead of
+     * the disposable filesystem path.
+     */
+    sourceUrl?: string | null;
+    /**
+     * Explicit `sourceType` to record on the row.
+     *
+     * @remarks
+     * When omitted, the type is heuristically inferred from
+     * {@link InstallSkillOptions.sourceUrl} (or `sourcePath` as a fallback)
+     * via {@link inferSkillSourceType}. Dispatch-layer callers that know the
+     * authoritative provenance (e.g. catalog → `'canonical'`, GitHub URL →
+     * `'community'`) SHOULD set this explicitly to bypass the heuristic.
+     */
+    sourceType?: SkillRowSourceType;
+}
 /**
  * Result of installing a skill to the canonical location and linking to agents.
  *
@@ -3032,6 +3324,29 @@ interface SkillInstallResult {
     /** Whether at least one agent was successfully linked. */
     success: boolean;
 }
+/**
+ * Heuristic source-type classifier for installs that don't carry an explicit
+ * `source_type`.
+ *
+ * @remarks
+ * Pure string inspection — keeps the installer free of network calls and
+ * filesystem reads. The dispatch layer can ALWAYS override the result by
+ * passing an explicit row through {@link InstallSkillOptions.recordRow}.
+ *
+ * Classification rules:
+ *
+ * 1. `library:<name>` → `'canonical'` (installed from the bundled Sphere A
+ *    skill library — `packages/skills/skills/`).
+ * 2. `github.com` / `gitlab.com` / scoped `@author/name` → `'community'`.
+ * 3. Anything else (local paths, opaque values) → `'user'`.
+ *
+ * @param sourceUrl - The source identifier passed to {@link installSkill}.
+ *   `null` is treated as `'user'`.
+ * @returns The inferred source-type discriminator.
+ *
+ * @public
+ */
+declare function inferSkillSourceType(sourceUrl: string | null | undefined): SkillRowSourceType;
 /**
  * Install a skill from a local path to the canonical location and link to agents.
  *
@@ -3039,24 +3354,45 @@ interface SkillInstallResult {
  * Copies the skill directory to the canonical skills directory and creates symlinks
  * (or copies on Windows) from each provider's skills directory to the canonical path.
  *
+ * **T9659** — when `options.recordRow` is supplied, the callback is invoked
+ * with a {@link SkillRowData} payload after the canonical copy lands and
+ * BEFORE provider linking. This is the integration seam that the cleo
+ * dispatch layer uses to plug `upsertSkillRow` from
+ * `@cleocode/core/store/skills-db` into `~/.cleo/skills.db`. The row is
+ * recorded regardless of whether subsequent provider linking succeeds — the
+ * canonical install is itself the durable artefact.
+ *
  * @param sourcePath - Local path to the skill directory to install
  * @param skillName - Name for the installed skill
  * @param providers - Target providers to link the skill to
  * @param isGlobal - Whether to link to global or project skill directories
  * @param projectDir - Project directory (defaults to `process.cwd()`)
+ * @param options - Optional callbacks (incl. `recordRow` for `skills.db`)
  * @returns Install result with linked agents and any errors
  *
  * @example
  * ```typescript
- * const result = await installSkill("/tmp/my-skill", "my-skill", providers, true, "/my/project");
- * if (result.success) {
- *   console.log(`Linked to: ${result.linkedAgents.join(", ")}`);
- * }
+ * const result = await installSkill(
+ *   "/tmp/my-skill",
+ *   "my-skill",
+ *   providers,
+ *   true,
+ *   "/my/project",
+ *   {
+ *     recordRow: async (row) => upsertSkillRow({
+ *       name: row.name,
+ *       installPath: row.installPath,
+ *       sourceType: row.sourceType,
+ *       sourceUrl: row.sourceUrl,
+ *       installedAt: new Date().toISOString(),
+ *     }),
+ *   },
+ * );
  * ```
  *
  * @public
  */
-declare function installSkill(sourcePath: string, skillName: string, providers: Provider[], isGlobal: boolean, projectDir?: string): Promise<SkillInstallResult>;
+declare function installSkill(sourcePath: string, skillName: string, providers: Provider[], isGlobal: boolean, projectDir?: string, options?: InstallSkillOptions): Promise<SkillInstallResult>;
 /**
  * Remove a skill from the canonical location and all agent symlinks.
  *
@@ -5630,20 +5966,73 @@ declare function getAgentsHome(): string;
  * @public
  */
 declare function getProjectAgentsDir(projectRoot?: string): string;
+/**
+ * Reset the cached deprecation-warning flag.
+ *
+ * @remarks
+ * Test-only seam. Production code should never call this.
+ *
+ * @internal
+ */
+declare function _resetLegacySkillsWarning(): void;
+/**
+ * Returns the canonical user-machine skills install root.
+ *
+ * @remarks
+ * Per architecture-v3 §1 the new SSoT for ALL installed skills is
+ * `~/.cleo/skills/` (replacing the legacy XDG path
+ * `~/.local/share/agents/skills/`). This resolver implements the migration
+ * contract: it ALWAYS returns the new SSoT when it exists, falls through to
+ * the legacy path as a read-only fallback for one release cycle, and
+ * defaults to the new SSoT on a fresh install so first-write lands in the
+ * correct location.
+ *
+ * Resolution order:
+ *
+ * 1. `~/.cleo/skills/` (new SSoT — preferred). Returned when it exists.
+ * 2. `getAgentsHome()/skills` (legacy XDG via `AGENTS_HOME` /
+ *    `~/.local/share/agents/skills/`). Returned when the new SSoT is missing
+ *    but the legacy directory exists. Emits a one-shot stderr deprecation
+ *    warning so the user is prompted to migrate.
+ * 3. `~/.cleo/skills/` (new SSoT) on a fresh install when neither exists,
+ *    so first-write creates the correct directory.
+ *
+ * **Test override:** when the `AGENTS_HOME` env var is set explicitly (the
+ * primary test seam used by `skills-installer.test.ts`), the resolver SKIPS
+ * step 1 and returns `getAgentsHome()/skills` directly. This preserves the
+ * existing test surface (tmpdirs via `AGENTS_HOME`) while production paths
+ * resolve through the new SSoT chain.
+ *
+ * @returns Absolute path to the resolved canonical skills directory
+ *
+ * @example
+ * ```typescript
+ * const dir = getCanonicalSkillsRoot();
+ * // Fresh install:                  "/home/user/.cleo/skills"
+ * // Legacy install + warning:       "/home/user/.local/share/agents/skills"
+ * // Test (AGENTS_HOME=/tmp/foo):    "/tmp/foo/skills"
+ * ```
+ *
+ * @task T9659
+ * @public
+ */
+declare function getCanonicalSkillsRoot(): string;
 /**
  * Returns the canonical skills storage directory path.
  *
  * @remarks
  * Skills are stored once in this canonical directory and symlinked into
  * provider-specific locations. This is the single source of truth for
- * installed skill files.
+ * installed skill files. **T9659 — this now delegates to
+ * {@link getCanonicalSkillsRoot} so the SSoT is `~/.cleo/skills/` with the
+ * legacy XDG path as a read-only fallback per architecture-v3 §1.**
  *
  * @returns The absolute path to the canonical skills directory
  *
  * @example
  * ```typescript
  * const dir = getCanonicalSkillsDir();
- * // e.g., "/home/user/.local/share/caamp/skills"
+ * // e.g., "/home/user/.cleo/skills" (new SSoT)
  * ```
  *
  * @public
@@ -8331,4 +8720,4 @@ declare function parseSource(input: string): ParsedSource;
  */
 declare function isMarketplaceScoped(input: string): boolean;
 
-export { type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, CANONICAL_HOOK_EVENTS, type CaampBlock, type CaampLockFile, type CanonicalEventDefinition, type CanonicalHookEvent, type CantProfileCounts, type CantProfileEntry, type CantValidationDiagnostic, type ConfigFormat, type CrossProviderMatrix, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, DEFAULT_EXCLUSIVITY_MODE, type DedupeResult, type DetectionCacheOptions, type DetectionResult, EXCLUSIVITY_MODE_ENV_VAR, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type ExclusivityMode, type GlobalOptions, HOOK_CATEGORIES, type Harness, type HarnessScope, type HookCategory, type HookEvent, type HookHandlerType, type HookMapping, type HookSupportResult, type HookSystemType, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallMcpServerOptions, type InstallMcpServerResult, type InstructionUpdateSummary, type KnownProviderAgentFolderId, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpConfigFormat, type McpDetectionEntry, type McpScope, type McpServerConfig, type McpServerEntriesByProvider, type McpServerEntry, type McpTransportType, type NormalizedHookEvent, type NormalizedRecommendationCriteria, type ParsedSource, PiHarness, PiRequiredError, type Provider, type ProviderCapabilities, type ProviderHarnessCapability, type ProviderHookProfile, type ProviderHookSummary, type ProviderHooksCapability, type ProviderMcpCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type RegistryHarnessKind, type RegistryHookCatalog, type RegistryHookFormat, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ResolveDefaultTargetProvidersOptions, type SkillBatchOperation, type SkillEntry, type SkillInstallResult, type SkillIntegrityResult, type SkillIntegrityStatus, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SubagentHandle, type SubagentResult, type SubagentTask, type TransportType, type ValidateCantProfileResult, type ValidationIssue, type ValidationResult, type WriteAgentFileOptions, type WriteAgentFileResult, _resetPlatformPathsCache, buildHookMatrix, buildInjectionContent, buildLibraryFromFiles, buildSkillsMap, catalog, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkInjection, checkSkillIntegrity, checkSkillUpdate, clearRegisteredLibrary, dedupeFile, dedupeFiles, deepMerge, detectAllProviders, detectMcpInstallations, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllCanonicalEvents, getAllHarnesses, getAllProviders, getCanonicalEvent, getCanonicalEventsByCategory, getCanonicalSkillsDir, getCommonEvents, getCommonHookEvents, getEffectiveSkillsPaths, getExclusivityMode, getHarnessFor, getHookConfigPath, getHookMappingsVersion, getHookSupport, getHookSystemType, getInstalledProviders, getInstructionFiles, getLockFilePath, getMappedProviderIds, getNestedValue, getPlatformLocations, getPlatformPaths, getPrimaryHarness, getPrimaryProvider, getProjectAgentsDir, getProvider, getProviderAgentFolder, getProviderCapabilities, getProviderCount, getProviderHookProfile, getProviderInstructionReferences, getProviderOnlyEvents, getProviderSummary, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getProvidersForEvent, getRegistryVersion, getSpawnCapableProviders, getSupportedEvents, getSystemInfo, getTrackedSkills, getUnsupportedEvents, groupByInstructFile, inject, injectAll, installBatchWithRollback, installMcpServer, installSkill, isCaampOwnedSkill, isExclusivityMode, isMarketplaceScoped, isQuiet, isVerbose, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeRecommendationCriteria, parseCaampBlocks, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, recommendSkills, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpServer, removeMcpServerFromAll, removeSkill, removeSkillFromLock, resetDetectionCache, resetExclusivityModeOverride, resolveAlias, resolveDefaultTargetProviders, resolveMcpConfigPath, resolveNativeEvent, resolveProviderSkillsDirs, resolveRegistryTemplatePath, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setExclusivityMode, setQuiet, setVerbose, shouldOverrideSkill, supportsHook, toCanonical, toNative, toNativeBatch, toSarif, tokenizeCriteriaValue, translateToAll, updateInstructionsSingleOperation, validateInstructionIntegrity, validateRecommendationCriteria, validateSkill, writeAgentFileToAllProviders, writeConfig };
+export { AgentsSkillsRealDirError, type AuditFinding, type AuditResult, type AuditRule, type AuditSeverity, type BatchInstallOptions, type BatchInstallResult, type BridgeSymlinkRecord, CANONICAL_HOOK_EVENTS, type CaampBlock, type CaampLockFile, type CanonicalEventDefinition, type CanonicalHookEvent, type CantProfileCounts, type CantProfileEntry, type CantValidationDiagnostic, type ConfigFormat, type CrossProviderMatrix, type CtDispatchMatrix, type CtManifest, type CtManifestSkill, type CtProfileDefinition, type CtSkillEntry, type CtValidationIssue, type CtValidationResult, DEFAULT_EXCLUSIVITY_MODE, type DedupeResult, type DetectionCacheOptions, type DetectionResult, type DoctorBridgeOptions, type DoctorBridgeResult, EXCLUSIVITY_MODE_ENV_VAR, type EnsureProviderInstructionFileOptions, type EnsureProviderInstructionFileResult, type ExclusivityMode, type GlobalOptions, HOOK_CATEGORIES, type Harness, type HarnessScope, type HookCategory, type HookEvent, type HookHandlerType, type HookMapping, type HookSupportResult, type HookSystemType, type InjectionCheckResult, type InjectionStatus, type InjectionTemplate, type InstallMcpServerOptions, type InstallMcpServerResult, type InstallSkillOptions, type InstructionUpdateSummary, type KnownProviderAgentFolderId, type LockEntry, MarketplaceClient, type MarketplaceResult, type MarketplaceSearchResult, type MarketplaceSkill, type McpConfigFormat, type McpDetectionEntry, type McpScope, type McpServerConfig, type McpServerEntriesByProvider, type McpServerEntry, type McpTransportType, type NormalizedHookEvent, type NormalizedRecommendationCriteria, type ParsedSource, type PerSkillSymlinkRemoval, PiHarness, PiRequiredError, type Provider, type ProviderCapabilities, type ProviderHarnessCapability, type ProviderHookProfile, type ProviderHookSummary, type ProviderHooksCapability, type ProviderMcpCapability, type ProviderPriority, type ProviderSkillsCapability, type ProviderSpawnCapability, type ProviderStatus, RECOMMENDATION_ERROR_CODES, type RankedSkillRecommendation, type RecommendSkillsResult, type RecommendationCriteriaInput, type RecommendationErrorCode, type RecommendationOptions, type RecommendationReason, type RecommendationReasonCode, type RecommendationScoreBreakdown, type RecommendationValidationIssue, type RecommendationValidationResult, type RecommendationWeights, type RegistryHarnessKind, type RegistryHookCatalog, type RegistryHookFormat, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ResolveDefaultTargetProvidersOptions, type SkillBatchOperation, type SkillEntry, type SkillInstallResult, type SkillIntegrityResult, type SkillIntegrityStatus, type SkillLibrary, type SkillLibraryDispatchMatrix, type SkillLibraryEntry, type SkillLibraryManifest, type SkillLibraryManifestSkill, type SkillLibraryProfile, type SkillLibraryValidationIssue, type SkillLibraryValidationResult, type SkillMetadata, type SkillRowData, type SkillRowSourceType, type SkillsPrecedence, type SourceType, type SpawnAdapter, type SpawnMechanism, type SpawnOptions, type SpawnResult, type SubagentHandle, type SubagentResult, type SubagentTask, type TransportType, type ValidateCantProfileResult, type ValidationIssue, type ValidationResult, type WriteAgentFileOptions, type WriteAgentFileResult, _resetLegacySkillsWarning, _resetPlatformPathsCache, buildBackupTimestamp, buildHookMatrix, buildInjectionContent, buildLibraryFromFiles, buildSkillsMap, catalog, checkAllInjections, checkAllSkillIntegrity, checkAllSkillUpdates, checkInjection, checkSkillIntegrity, checkSkillUpdate, clearRegisteredLibrary, dedupeFile, dedupeFiles, deepMerge, detectAllProviders, detectMcpInstallations, detectProjectProviders, detectProvider, discoverSkill, discoverSkills, ensureAllProviderInstructionFiles, ensureDir, ensureProviderInstructionFile, formatSkillRecommendations, generateInjectionContent, generateSkillsSection, getAgentsConfigPath, getAgentsHome, getAgentsInstructFile, getAgentsLinksDir, getAgentsMcpDir, getAgentsMcpServersPath, getAgentsSpecDir, getAgentsWikiDir, getAllCanonicalEvents, getAllHarnesses, getAllProviders, getCanonicalEvent, getCanonicalEventsByCategory, getCanonicalSkillsDir, getCanonicalSkillsRoot, getCommonEvents, getCommonHookEvents, getEffectiveSkillsPaths, getExclusivityMode, getHarnessFor, getHookConfigPath, getHookMappingsVersion, getHookSupport, getHookSystemType, getInstalledProviders, getInstructionFiles, getLockFilePath, getMappedProviderIds, getNestedValue, getPlatformLocations, getPlatformPaths, getPrimaryHarness, getPrimaryProvider, getProjectAgentsDir, getProvider, getProviderAgentFolder, getProviderCapabilities, getProviderCount, getProviderHookProfile, getProviderInstructionReferences, getProviderOnlyEvents, getProviderSummary, getProvidersByHookEvent, getProvidersByInstructFile, getProvidersByPriority, getProvidersBySkillsPrecedence, getProvidersBySpawnCapability, getProvidersByStatus, getProvidersForEvent, getRegistryVersion, getSpawnCapableProviders, getSupportedEvents, getSystemInfo, getTrackedSkills, getUnsupportedEvents, groupByInstructFile, inferSkillSourceType, inject, injectAll, installBatchWithRollback, installMcpServer, installSkill, isCaampOwnedSkill, isExclusivityMode, isMarketplaceScoped, isQuiet, isVerbose, listAllMcpServers, listCanonicalSkills, listMcpServers, loadLibraryFromModule, normalizeRecommendationCriteria, parseCaampBlocks, parseInjectionContent, parseSkillFile, parseSource, providerSupports, providerSupportsById, rankSkills, readConfig, recommendSkills, recordSkillInstall, registerSkillLibrary, registerSkillLibraryFromPath, removeConfig, removeInjection, removeMcpServer, removeMcpServerFromAll, removeSkill, removeSkillFromLock, resetDetectionCache, resetExclusivityModeOverride, resolveAlias, resolveDefaultTargetProviders, resolveMcpConfigPath, resolveNativeEvent, resolveProviderSkillsDirs, resolveRegistryTemplatePath, runDoctorBridge, scanDirectory, scanFile, scoreSkillRecommendation, searchSkills, selectProvidersByMinimumPriority, setExclusivityMode, setQuiet, setVerbose, shouldOverrideSkill, supportsHook, toCanonical, toNative, toNativeBatch, toSarif, tokenizeCriteriaValue, translateToAll, updateInstructionsSingleOperation, validateInstructionIntegrity, validateRecommendationCriteria, validateSkill, writeAgentFileToAllProviders, writeConfig };

package/dist/index.js

@@ -1,10 +1,12 @@
 import {
+  AgentsSkillsRealDirError,
   DEFAULT_EXCLUSIVITY_MODE,
   EXCLUSIVITY_MODE_ENV_VAR,
   MarketplaceClient,
   PiHarness,
   PiRequiredError,
   RECOMMENDATION_ERROR_CODES,
+  buildBackupTimestamp,
   buildLibraryFromFiles,
   catalog_exports,
   checkAllSkillUpdates,
@@ -26,6 +28,7 @@ import {
   getNestedValue,
   getPrimaryHarness,
   getTrackedSkills,
+  inferSkillSourceType,
   installBatchWithRollback,
   installMcpServer,
   installSkill,
@@ -56,6 +59,7 @@ import {
   resetExclusivityModeOverride,
   resolveDefaultTargetProviders,
   resolveMcpConfigPath,
+  runDoctorBridge,
   scanDirectory,
   scanFile,
   scoreSkillRecommendation,
@@ -70,7 +74,7 @@ import {
   validateRecommendationCriteria,
   validateSkill,
   writeConfig
-} from "./chunk-4W35AEYA.js";
+} from "./chunk-QSJSM57K.js";
 import {
   buildInjectionContent,
   buildSkillsMap,
@@ -110,7 +114,7 @@ import {
   removeInjection,
   resolveAlias,
   writeAgentFileToAllProviders
-} from "./chunk-OPUPNLUJ.js";
+} from "./chunk-PGETUTYZ.js";
 import {
   CANONICAL_HOOK_EVENTS,
   HOOK_CATEGORIES,
@@ -136,8 +140,9 @@ import {
   toNative,
   toNativeBatch,
   translateToAll
-} from "./chunk-SV33CE5X.js";
+} from "./chunk-QKC2JRSG.js";
 import {
+  _resetLegacySkillsWarning,
   _resetPlatformPathsCache,
   getAgentsConfigPath,
   getAgentsHome,
@@ -148,6 +153,7 @@ import {
   getAgentsSpecDir,
   getAgentsWikiDir,
   getCanonicalSkillsDir,
+  getCanonicalSkillsRoot,
   getLockFilePath,
   getPlatformLocations,
   getPlatformPaths,
@@ -155,7 +161,7 @@ import {
   getSystemInfo,
   resolveProviderSkillsDirs,
   resolveRegistryTemplatePath
-} from "./chunk-OCI4RYI5.js";
+} from "./chunk-H5YXR2DC.js";
 
 // src/core/skills/integrity.ts
 import { existsSync, lstatSync, readlinkSync } from "fs";
@@ -273,7 +279,7 @@ function shouldOverrideSkill(skillName, incomingSource, existingEntry) {
   return true;
 }
 async function validateInstructionIntegrity(providers, projectDir, scope, expectedContent) {
-  const { checkAllInjections: checkAllInjections2 } = await import("./injector-F4EHB3CZ.js");
+  const { checkAllInjections: checkAllInjections2 } = await import("./injector-QPOIJVOR.js");
   const results = await checkAllInjections2(providers, projectDir, scope, expectedContent);
   const issues = [];
   for (const result of results) {
@@ -300,6 +306,7 @@ async function validateInstructionIntegrity(providers, projectDir, scope, expect
   return issues;
 }
 export {
+  AgentsSkillsRealDirError,
   CANONICAL_HOOK_EVENTS,
   DEFAULT_EXCLUSIVITY_MODE,
   EXCLUSIVITY_MODE_ENV_VAR,
@@ -308,7 +315,9 @@ export {
   PiHarness,
   PiRequiredError,
   RECOMMENDATION_ERROR_CODES,
+  _resetLegacySkillsWarning,
   _resetPlatformPathsCache,
+  buildBackupTimestamp,
   buildHookMatrix,
   buildInjectionContent,
   buildLibraryFromFiles,
@@ -350,6 +359,7 @@ export {
   getCanonicalEvent,
   getCanonicalEventsByCategory,
   getCanonicalSkillsDir,
+  getCanonicalSkillsRoot,
   getCommonEvents,
   getCommonHookEvents,
   getEffectiveSkillsPaths,
@@ -391,6 +401,7 @@ export {
   getTrackedSkills,
   getUnsupportedEvents,
   groupByInstructFile,
+  inferSkillSourceType,
   inject,
   injectAll,
   installBatchWithRollback,
@@ -432,6 +443,7 @@ export {
   resolveNativeEvent,
   resolveProviderSkillsDirs,
   resolveRegistryTemplatePath,
+  runDoctorBridge,
   scanDirectory,
   scanFile,
   scoreSkillRecommendation,