/**
 * Canonical SSoT path helpers for the CLEO skill system.
 *
 * @remarks
 * Provides two pure, synchronous helpers that the CAAMP installer, sentient
 * daemon, and `cleo skills` CLI all depend on:
 *
 * 1. {@link resolveSkillsRoot} — resolves the canonical user-machine skills
 *    root: `<cleoHome>/skills` in the platform data dir (T12598; was `~/.cleo/skills/`). Operators with a
 *    pre-v3 install at `~/.local/share/agents/skills/` MUST run
 *    `cleo skills migrate` (see `migration.ts`) to relocate before further
 *    skill operations succeed.
 * 2. {@link is_canonical} — write-guard predicate that returns `true` when a
 *    given skill is owned by the CLEO core team (Sphere A) and must be
 *    treated as read-only on user machines.
 *
 * Both helpers are dependency-injected for db / manifest lookups so they can
 * be safely consumed from environments where `skills.db` is not yet
 * initialized (sentient daemon boot, installer pre-flight, etc.).
 *
 * @see {@link docs/architecture/SG-CLEO-SKILLS-architecture-v3.md} §1, §6
 * @task T9746
 * @epic T9740
 */
/**
 * Source-type discriminator stored in `skills.db` rows.
 *
 * @remarks
 * Mirrors the enum on `skills.source_type` (see architecture-v3.md §4).
 * Treated as `canonical` short-circuits the manifest + path checks in
 * {@link is_canonical}.
 *
 * @public
 */
export type SkillSourceType = 'canonical' | 'user' | 'community' | 'agent-created';
/**
 * Options for {@link is_canonical}.
 *
 * @remarks
 * Both fields are optional — `is_canonical` can be called with no options at
 * all, in which case the predicate falls through to `false`. Callers that
 * have access to `skills.db` or the canonical manifest SHOULD pass the
 * relevant field to get an accurate result.
 *
 * @public
 */
export interface IsCanonicalOptions {
    /**
     * The `source_type` field from the skill's `skills.db` row.
     *
     * @remarks
     * When equal to `'canonical'` the skill is unconditionally treated as a
     * Sphere A canonical skill and the manifest check is skipped.
     */
    dbSourceType?: SkillSourceType | string;
    /**
     * Names of canonical skills loaded from `packages/skills/skills/manifest.json`.
     *
     * @remarks
     * When provided, `is_canonical` checks whether the basename of the resolved
     * skill path is a member of this list — this is the manifest-membership
     * step in the resolution chain.
     */
    manifestNames?: string[];
}
/**
 * Absolute path of the SINGLE bridge symlink at `~/.agents/skills/`.
 *
 * @remarks
 * Per architecture-v3 §1, every non-Claude harness (Cursor, Aider, Codeium,
 * etc.) discovers skills through this one symlink, which points at
 * `~/.claude/skills/agents-shared/` (which in turn fans out into
 * `~/.cleo/skills/`). Centralised here as the SSoT so doctor helpers,
 * adopt-orphans, and any future bridge consumer all agree on the same
 * literal — eliminates the four-site duplication noted in
 * SKILLS-CLEANUP-AUDIT.md Part D.
 *
 * @public
 */
export declare const AGENTS_SKILLS_BRIDGE_PATH: string;
/**
 * Absolute path of Claude Code's hardcoded shared-skills mount at
 * `~/.claude/skills/agents-shared/`.
 *
 * @remarks
 * Per architecture-v3 §1, Claude Code reads skills from this directory
 * verbatim (it is the hardcoded discovery mount). Every other harness
 * traverses {@link AGENTS_SKILLS_BRIDGE_PATH} which is a symlink to this
 * directory. Centralised so doctor helpers do not recompute the literal.
 *
 * @public
 */
export declare const CLAUDE_SKILLS_AGENTS_SHARED_PATH: string;
/**
 * Resolve the canonical user-machine skills root directory.
 *
 * @remarks
 * Returns `<cleoHome>/skills` — the platform data directory from
 * `@cleocode/paths` (`~/.local/share/cleo/skills` on Linux,
 * `~/Library/Application Support/cleo/skills` on macOS,
 * `%LOCALAPPDATA%\cleo\Data\skills` on Windows; `CLEO_HOME` overrides).
 *
 * T12598: this used to return `~/.cleo/skills`, relying on `~/.cleo` being a
 * link to the data directory. Every harness skill link was then written
 * THROUGH that link, so one dangling `~/.cleo` (a Linux target carried to
 * macOS by dotfiles) broke every installed skill in every harness at once.
 * Installs now target the physical directory; `~/.cleo` is only a
 * convenience alias.
 *
 * The returned path is always absolute and is NOT guaranteed to exist on
 * disk — callers are responsible for `mkdirSync` if they need to write into
 * it.
 *
 * @returns Absolute path to `<cleoHome>/skills`.
 * @example
 * ```typescript
 * import { resolveSkillsRoot } from '@cleocode/core';
 * const root = resolveSkillsRoot();
 * // "/home/user/.local/share/cleo/skills" (Linux)
 * ```
 * @public
 */
export declare function resolveSkillsRoot(): string;
/**
 * Whether name-based resolvers may fall back to the bundled skill copy.
 *
 * @remarks
 * Only in the default `CLEO_SKILL_SOURCE` mode (`auto`, or unset).
 * `caamp` means installed skills only and `embedded` means project skills
 * only, so neither may be satisfied from the package (T12646).
 *
 * @returns `true` when the bundled fallback is allowed.
 * @task T12646
 * @public
 */
export declare function bundledSkillFallbackEnabled(): boolean;
/**
 * Resolve the `skills/` directory shipped inside the `@cleocode/skills`
 * package — the read-only source every install copies from.
 *
 * @remarks
 * Name-based resolvers (`resolveSkillPath`, `findSkill`) fall back to this
 * directory when a skill is not installed in {@link resolveSkillsRoot}.
 * Install selection decides what harnesses see; it must not decide whether a
 * spawn prompt can read the protocol it names (T12646: `ct-lead` and several
 * LOOM-stage skills are never installed, so lead spawns and stage guidance
 * degraded to "Skills not installed").
 *
 * Tries Node module resolution first, then walks up from this module looking
 * for a workspace `packages/skills/skills` or an installed
 * `node_modules/@cleocode/skills/skills`. A candidate counts only when its
 * `manifest.json` exists.
 *
 * @returns Absolute path to the bundled skills directory, or `null` when the
 *   package cannot be found.
 * @task T12646
 * @public
 */
export declare function resolveBundledSkillsDir(): string | null;
/**
 * Resolve one bundled skill directory by exact name.
 *
 * @param skillName - Skill directory name (e.g. `ct-lead`).
 * @returns Absolute path to `<bundled>/<skillName>` when it holds a
 *   `SKILL.md`, else `null`.
 * @task T12646
 * @public
 */
export declare function resolveBundledSkillDir(skillName: string): string | null;
/**
 * Determine whether a given skill path refers to a canonical (Sphere A) skill.
 *
 * @remarks
 * Canonical skills are owned by the CLEO core team and MUST be treated as
 * read-only on user machines — the local sentient daemon and any other
 * write paths MUST refuse mutations when this returns `true`.
 *
 * Resolution order (post-T9746, per architecture-v3.md §6):
 *
 * 1. **db short-circuit:** if `options.dbSourceType === 'canonical'`, return
 *    `true` immediately.
 * 2. **manifest membership:** if `options.manifestNames` is provided and the
 *    basename of the resolved path matches any entry, return `true`.
 * 3. Otherwise return `false`. The legacy path-prefix fallback was removed in
 *    T9746 — db row + manifest are now the only signals.
 *
 * The path is `realpathSync`-resolved before comparison so symlinks (e.g.
 * `~/.claude/skills/agents-shared/<name>` → `~/.cleo/skills/<name>`) are
 * compared against their physical targets.
 *
 * @param skillPath - Absolute path to the skill directory under inspection.
 * @param options - Optional DI hooks for db row and canonical-name manifest.
 * @returns `true` when the skill is Sphere A canonical, `false` otherwise.
 *
 * @example
 * ```typescript
 * import { is_canonical } from '@cleocode/core';
 *
 * // db short-circuit
 * is_canonical('/home/user/.cleo/skills/ct-orchestrator', {
 *   dbSourceType: 'canonical',
 * }); // → true
 *
 * // manifest hit
 * is_canonical('/home/user/.cleo/skills/ct-lead', {
 *   manifestNames: ['ct-lead', 'ct-orchestrator'],
 * }); // → true
 *
 * // user skill — not canonical
 * is_canonical('/home/user/.cleo/skills/my-custom-skill', {
 *   dbSourceType: 'user',
 * }); // → false
 * ```
 *
 * @public
 */
export declare function is_canonical(skillPath: string, options?: IsCanonicalOptions): boolean;
//# sourceMappingURL=skill-root.d.ts.map