@qodo/sdk 0.13.4 → 2.0.0-next.1

package/dist/skills/sources/index.js

@@ -0,0 +1,471 @@
+/**
+ * Per-source-type discovery walkers.
+ *
+ * Each walker takes a `SkillSource` config entry and resolves the list of
+ * skill directories that source contributes. The manager then parses +
+ * validates each directory and assembles the catalog with shadowing
+ * and FQN namespacing.
+ *
+ * Walkers do NOT parse `SKILL.md` content — they only locate directories.
+ * Per-source error handling is best-effort: a missing source resolves to
+ * an empty list with no error; an unreadable source surfaces an
+ * `sdk.skill.error` event with `severity: 'error'` so the manager can
+ * include it in telemetry without poisoning other sources' contributions.
+ */
+import { promises as fs } from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { findSkillDirectories, findSkillDirectoriesWithLegacyPluginLayout, safeRealPath, walkAncestors, } from './walk.js';
+export function defaultWalkerEnv() {
+    return {
+        cwd: process.cwd(),
+        homedir: os.homedir(),
+        env: process.env,
+    };
+}
+/**
+ * Dispatch by source `type`. Unknown types are rejected; the caller is
+ * expected to validate `SkillsConfig.sources` at construction time.
+ */
+export async function walkSource(source, env) {
+    switch (source.type) {
+        case 'project':
+            return walkProject(source, env);
+        case 'config':
+            return walkConfig(source, env);
+        case 'user':
+            return walkUser(source, env);
+        case 'package':
+            return walkPackage(source, env);
+        case 'cli-fetched':
+            return walkCliFetched(source, env);
+        case 'bundled':
+            return walkBundled(source, env);
+    }
+}
+// ---------------------------------------------------------------------------
+// project — walks CWD upward for `.qodo/skills/` directories
+// ---------------------------------------------------------------------------
+async function walkProject(source, env) {
+    const errors = [];
+    // Explicit `path` short-circuits the ancestor walk.
+    if (source.path !== undefined) {
+        const resolved = await safeRealPath(path.resolve(env.cwd, source.path));
+        if (resolved === null) {
+            return { source, skills: [], errors };
+        }
+        try {
+            const skills = await findSkillDirectories(resolved);
+            return { source, skills, errors };
+        }
+        catch (err) {
+            errors.push({ path: resolved, message: errorMessage(err) });
+            return { source, skills: [], errors };
+        }
+    }
+    // Default: walk ancestors for `.qodo/skills/`.
+    const ancestors = await walkAncestors(env.cwd, path.join('.qodo', 'skills'));
+    // Inclusive: every ancestor's `.qodo/skills` contributes; closer ones win
+    // ties at the manager's shadowing step (the manager processes the list
+    // in array order so the first entry has precedence).
+    const all = [];
+    for (const ancestor of ancestors) {
+        try {
+            const skills = await findSkillDirectories(ancestor);
+            all.push(...skills);
+        }
+        catch (err) {
+            errors.push({ path: ancestor, message: errorMessage(err) });
+        }
+    }
+    return { source, skills: all, errors };
+}
+// ---------------------------------------------------------------------------
+// config — single explicit path (no glob expansion in this surface)
+// ---------------------------------------------------------------------------
+async function walkConfig(source, env) {
+    const errors = [];
+    const resolved = await safeRealPath(path.resolve(env.cwd, source.path));
+    if (resolved === null) {
+        // Per skills-edge-cases.md §1.1 — empty source is silent, not an error.
+        return { source, skills: [], errors };
+    }
+    try {
+        const skills = await findSkillDirectoriesWithLegacyPluginLayout(resolved);
+        return { source, skills, errors };
+    }
+    catch (err) {
+        errors.push({ path: resolved, message: errorMessage(err) });
+        return { source, skills: [], errors };
+    }
+}
+// ---------------------------------------------------------------------------
+// user — `~/.qodo/skills/` (or `$XDG_CONFIG_HOME/qodo/skills/`)
+// ---------------------------------------------------------------------------
+async function walkUser(source, env) {
+    const errors = [];
+    let basePath;
+    if (source.path !== undefined) {
+        basePath = path.isAbsolute(source.path)
+            ? source.path
+            : path.resolve(env.cwd, source.path);
+    }
+    else {
+        const xdg = env.env['XDG_CONFIG_HOME'];
+        if (xdg !== undefined && xdg.length > 0) {
+            basePath = path.join(xdg, 'qodo', 'skills');
+        }
+        else {
+            basePath = path.join(env.homedir, '.qodo', 'skills');
+        }
+    }
+    const resolved = await safeRealPath(basePath);
+    if (resolved === null) {
+        return { source, skills: [], errors };
+    }
+    try {
+        const skills = await findSkillDirectories(resolved);
+        return { source, skills, errors };
+    }
+    catch (err) {
+        errors.push({ path: resolved, message: errorMessage(err) });
+        return { source, skills: [], errors };
+    }
+}
+// ---------------------------------------------------------------------------
+// package — npm package declaring `qodoSkills` in `package.json`
+// ---------------------------------------------------------------------------
+async function walkPackage(source, env) {
+    const errors = [];
+    // F6: validate `packageName` before any `path.join`. A value containing
+    // path separators, `..`, `.`, drive prefixes, or empty segments can
+    // make the resolved package root land outside `node_modules` —
+    // adjacent to the (already-fixed) qodoSkills containment escape.
+    if (!isValidPackageName(source.packageName)) {
+        errors.push({
+            message: `package source "${source.packageName}" is not a valid npm package name`,
+        });
+        return { source, skills: [], errors, resolvedVendor: source.packageName };
+    }
+    // Walk upward looking for `node_modules/<packageName>/` so monorepos and
+    // hoisted installs both work.
+    const candidateRoots = nodeModulesCandidateRoots(env.cwd);
+    let pkgRoot = null;
+    for (const root of candidateRoots) {
+        const candidate = path.join(root, source.packageName);
+        const real = await safeRealPath(candidate);
+        if (real !== null) {
+            pkgRoot = real;
+            break;
+        }
+    }
+    if (pkgRoot === null) {
+        return { source, skills: [], errors, resolvedVendor: source.packageName };
+    }
+    let pkgJson = {};
+    try {
+        const raw = await fs.readFile(path.join(pkgRoot, 'package.json'), 'utf-8');
+        pkgJson = JSON.parse(raw);
+    }
+    catch (err) {
+        errors.push({ path: pkgRoot, message: `package.json unreadable: ${errorMessage(err)}` });
+        return { source, skills: [], errors, resolvedVendor: source.packageName };
+    }
+    const skillsField = pkgJson.qodoSkills;
+    const skillsPaths = [];
+    if (source.path !== undefined) {
+        skillsPaths.push(source.path);
+    }
+    else if (typeof skillsField === 'string') {
+        skillsPaths.push(skillsField);
+    }
+    else if (Array.isArray(skillsField)) {
+        for (const entry of skillsField) {
+            if (typeof entry === 'string')
+                skillsPaths.push(entry);
+        }
+    }
+    // Resolve the canonical package root once so the containment check
+    // below has a stable anchor — `pkgRoot` was already canonicalised
+    // upstream via `safeRealPath`, but recompute to be defensive
+    // against symlinked node_modules trees.
+    const pkgRootReal = await safeRealPath(pkgRoot);
+    if (pkgRootReal === null) {
+        return { source, skills: [], errors, resolvedVendor: source.packageName };
+    }
+    const all = [];
+    for (const relative of skillsPaths) {
+        const root = path.resolve(pkgRoot, relative);
+        const real = await safeRealPath(root);
+        if (real === null)
+            continue;
+        // Containment: the resolved canonical directory must stay within
+        // the package root. A malicious or buggy package can set
+        // `qodoSkills: "../../.."` to redirect discovery.
+        const rel = path.relative(pkgRootReal, real);
+        if (rel.startsWith('..') || path.isAbsolute(rel)) {
+            errors.push({
+                path: real,
+                message: `package "${source.packageName}" qodoSkills entry "${relative}" escapes the package root`,
+            });
+            continue;
+        }
+        try {
+            const skills = await findSkillDirectoriesWithLegacyPluginLayout(real);
+            all.push(...skills);
+        }
+        catch (err) {
+            errors.push({ path: real, message: errorMessage(err) });
+        }
+    }
+    return { source, skills: all, errors, resolvedVendor: source.packageName };
+}
+/**
+ * Validate an npm package name before it gets `path.join`-ed onto a
+ * `node_modules` root. This is *not* the canonical npm name regex
+ * (that allows things we don't need), it's an allowlist of:
+ *
+ *   - unscoped: `name` — one-to-many of `[a-z0-9._-]`, must start with
+ *     `[a-z0-9_]` (npm allows leading `-` but it's rarely used and
+ *     creates argv parsing ambiguity; reject for our purposes).
+ *   - scoped: `@scope/name` where both segments match the unscoped rule.
+ *
+ * Rejects: empty input, leading `.`, path separators (`/` outside the
+ * exactly-one scoped separator, any `\\`), `..`, absolute paths, drive
+ * prefixes (`C:`), and any character outside the allowlist.
+ */
+export function isValidPackageName(name) {
+    if (typeof name !== 'string' || name.length === 0 || name.length > 214) {
+        return false;
+    }
+    // Reject windows-style drive prefixes and any backslash.
+    if (name.includes('\\'))
+        return false;
+    // Reject absolute paths outright.
+    if (path.isAbsolute(name))
+        return false;
+    const segmentPattern = /^[a-z0-9_][a-z0-9._-]*$/;
+    if (name.startsWith('@')) {
+        const slash = name.indexOf('/');
+        if (slash < 0)
+            return false;
+        const scope = name.slice(1, slash);
+        const rest = name.slice(slash + 1);
+        if (!segmentPattern.test(scope))
+            return false;
+        // The "rest" must contain no further `/` and pass the segment check.
+        if (rest.includes('/'))
+            return false;
+        return segmentPattern.test(rest);
+    }
+    // Unscoped — must match the segment pattern exactly and contain no `/`.
+    if (name.includes('/'))
+        return false;
+    return segmentPattern.test(name);
+}
+/** All `node_modules/` ancestors above `cwd`, near-first. */
+function nodeModulesCandidateRoots(cwd) {
+    const out = [];
+    let current = path.resolve(cwd);
+    const root = path.parse(current).root;
+    for (let i = 0; i < 64; i += 1) {
+        out.push(path.join(current, 'node_modules'));
+        if (current === root)
+            break;
+        const next = path.dirname(current);
+        if (next === current)
+            break;
+        current = next;
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// cli-fetched — `~/.qodo/installed-skills/<vendor>/<name>/` (or all of them)
+// ---------------------------------------------------------------------------
+async function walkCliFetched(source, env) {
+    const errors = [];
+    const baseDir = path.join(env.homedir, '.qodo', 'installed-skills');
+    if (source.ref !== undefined) {
+        const segments = source.ref.split('/');
+        // Reject `..`, `.`, empty, and separator-bearing segments so a
+        // malicious or buggy consumer config can't redirect discovery
+        // outside `installed-skills`.
+        for (const segment of segments) {
+            if (segment.length === 0 ||
+                segment === '.' ||
+                segment === '..' ||
+                segment.includes('\\') ||
+                path.isAbsolute(segment)) {
+                errors.push({
+                    message: `cli-fetched ref "${source.ref}" contains an invalid segment ${JSON.stringify(segment)}`,
+                });
+                return { source, skills: [], errors };
+            }
+        }
+        const refPath = path.join(baseDir, ...segments);
+        const real = await safeRealPath(refPath);
+        if (real === null)
+            return { source, skills: [], errors };
+        // Containment: re-canonicalise the base and verify the resolved
+        // ref path stays within it. Catches symlink redirection that
+        // segment validation alone would miss.
+        const baseReal = await safeRealPath(baseDir);
+        if (baseReal !== null) {
+            const rel = path.relative(baseReal, real);
+            if (rel.startsWith('..') || path.isAbsolute(rel)) {
+                errors.push({
+                    path: real,
+                    message: `cli-fetched ref "${source.ref}" escapes ${baseDir}`,
+                });
+                return { source, skills: [], errors };
+            }
+        }
+        try {
+            const skills = await findSkillDirectories(real);
+            return { source, skills, errors, resolvedVendor: segments[0] };
+        }
+        catch (err) {
+            errors.push({ path: real, message: errorMessage(err) });
+            return { source, skills: [], errors, resolvedVendor: segments[0] };
+        }
+    }
+    // No ref → walk every `<vendor>/<name>` under installed-skills.
+    const real = await safeRealPath(baseDir);
+    if (real === null)
+        return { source, skills: [], errors };
+    let entries;
+    try {
+        entries = await fs.readdir(real, { withFileTypes: true });
+    }
+    catch (err) {
+        errors.push({ path: real, message: errorMessage(err) });
+        return { source, skills: [], errors };
+    }
+    const all = [];
+    for (const vendorEntry of entries) {
+        if (!vendorEntry.isDirectory() || vendorEntry.name.startsWith('.'))
+            continue;
+        const vendorDir = path.join(real, vendorEntry.name);
+        try {
+            const skills = await findSkillDirectories(vendorDir);
+            all.push(...skills);
+        }
+        catch (err) {
+            errors.push({ path: vendorDir, message: errorMessage(err) });
+        }
+    }
+    return { source, skills: all, errors };
+}
+// ---------------------------------------------------------------------------
+// bundled — `<sdk-package>/skills/` next to `dist/`
+// ---------------------------------------------------------------------------
+async function walkBundled(source, env) {
+    const errors = [];
+    // The bundled source ships first-party skills authored under the SDK
+    // repo root in `bundled-skills/`. Two layouts are accepted:
+    //
+    //   - Source-tree layout — `<sdk-root>/bundled-skills/<name>/SKILL.md`.
+    //     Used when the package is consumed via `file:` / linked workspace
+    //     or when tests run against the unbuilt repo.
+    //   - Built-tree layout — `<sdk-root>/dist/skills/<name>/SKILL.md` or
+    //     `<sdk-root>/skills/<name>/SKILL.md`. Used when the package is
+    //     consumed from a published tarball or any environment that doesn't
+    //     ship the `bundled-skills/` source directory.
+    //
+    // Test fixtures override the auto-discovery with an explicit `path`;
+    // the first walkable layout wins (no merging, so duplicate skill names
+    // across layouts don't shadow each other).
+    // Explicit `path` short-circuits the auto-discovery — test fixtures
+    // use this to point at a specific bundled root.
+    if (source.path !== undefined) {
+        const explicit = path.isAbsolute(source.path)
+            ? source.path
+            : path.resolve(env.cwd, source.path);
+        return walkBundledCandidate(source, explicit, errors);
+    }
+    const here = path.dirname(new URL(import.meta.url).pathname);
+    const root = await findSdkPackageRoot(here);
+    if (root === null) {
+        return { source, skills: [], errors };
+    }
+    const candidates = [
+        path.join(root, 'bundled-skills'),
+        path.join(root, 'dist', 'skills'),
+        path.join(root, 'skills'),
+    ];
+    // Walk every candidate in priority order and return the first one
+    // that actually surfaces skills; if every candidate is empty, fall
+    // back to the last walkable candidate (so the errors / empty-skills
+    // payload still carries a meaningful path for telemetry).
+    // A naive "first existing path wins" would lock onto an empty
+    // candidate and never consult later fallbacks.
+    let firstWalkable = null;
+    for (const candidate of candidates) {
+        const result = await walkBundledCandidate(source, candidate, []);
+        if (result.skills.length > 0) {
+            // Merge accumulated walker errors from earlier (unused) candidates
+            // — none yet here, but the shape is uniform with the explicit
+            // path branch above.
+            return { ...result, errors };
+        }
+        if (firstWalkable === null && result.errors.length === 0) {
+            // Walkable (path resolved) but empty — remember as fallback.
+            firstWalkable = result;
+        }
+    }
+    if (firstWalkable !== null) {
+        return { ...firstWalkable, errors };
+    }
+    return { source, skills: [], errors };
+}
+/**
+ * Walk a single candidate bundled root. Returns an empty `skills` list
+ * (no errors) when the path doesn't resolve; returns a populated
+ * `errors` list when readdir/stat actually fail. The caller (single
+ * top-level `walkBundled`) decides whether to try the next fallback
+ * based on the empty-skills outcome.
+ */
+async function walkBundledCandidate(source, candidate, errors) {
+    const real = await safeRealPath(candidate);
+    if (real === null) {
+        return { source, skills: [], errors };
+    }
+    try {
+        const skills = await findSkillDirectories(real);
+        return { source, skills, errors };
+    }
+    catch (err) {
+        return {
+            source,
+            skills: [],
+            errors: [...errors, { path: real, message: errorMessage(err) }],
+        };
+    }
+}
+async function findSdkPackageRoot(start) {
+    let current = start;
+    for (let i = 0; i < 16; i += 1) {
+        const candidate = path.join(current, 'package.json');
+        try {
+            const raw = await fs.readFile(candidate, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (typeof parsed.name === 'string' && parsed.name === '@qodo/sdk') {
+                return current;
+            }
+        }
+        catch {
+            // ignore — keep walking up
+        }
+        const next = path.dirname(current);
+        if (next === current)
+            break;
+        current = next;
+    }
+    return null;
+}
+function errorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    return String(err);
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/sources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/skills/sources/index.ts"],"names":[],"mappings":"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"}

package/dist/skills/sources/walk.browser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Filesystem walker — browser stub. The Node version uses `node:fs` to
+ * enumerate skill directories; the browser stub returns empty results
+ * for every call. See `../manager.browser.ts` for the rationale.
+ */
+export declare const SYMLINK_HOP_CAP = 8;
+export interface WalkedSkill {
+    readonly dirPath: string;
+    readonly skillFilePath: string;
+    readonly mtimeMs: number;
+    readonly size: number;
+}
+export declare function findSkillDirectories(_root: string): Promise<WalkedSkill[]>;
+export declare function findSkillDirectoriesWithLegacyPluginLayout(_root: string): Promise<WalkedSkill[]>;
+export declare function safeRealPath(_p: string): Promise<string | null>;
+export declare function walkAncestors(_cwd: string, _segment: string): Promise<string[]>;
+//# sourceMappingURL=walk.browser.d.ts.map

package/dist/skills/sources/walk.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.browser.d.ts","sourceRoot":"","sources":["../../../src/skills/sources/walk.browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAE1E;AAED,wBAAgB,0CAA0C,CACxD,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAExB;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE/D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE/E"}

package/dist/skills/sources/walk.browser.js

@@ -0,0 +1,19 @@
+/**
+ * Filesystem walker — browser stub. The Node version uses `node:fs` to
+ * enumerate skill directories; the browser stub returns empty results
+ * for every call. See `../manager.browser.ts` for the rationale.
+ */
+export const SYMLINK_HOP_CAP = 8;
+export function findSkillDirectories(_root) {
+    return Promise.resolve([]);
+}
+export function findSkillDirectoriesWithLegacyPluginLayout(_root) {
+    return Promise.resolve([]);
+}
+export function safeRealPath(_p) {
+    return Promise.resolve(null);
+}
+export function walkAncestors(_cwd, _segment) {
+    return Promise.resolve([]);
+}
+//# sourceMappingURL=walk.browser.js.map

package/dist/skills/sources/walk.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.browser.js","sourceRoot":"","sources":["../../../src/skills/sources/walk.browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AASjC,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,KAAa;IAEb,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB;IAC1D,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/skills/sources/walk.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared filesystem walker for skill sources.
+ *
+ * Sits below the per-source-type walkers in `./project.ts`, `./user.ts`,
+ * etc. Each `SKILL.md` discovered yields a `WalkedSkill` carrying:
+ *
+ *   - `dirPath` — absolute path to the skill's directory.
+ *   - `skillFilePath` — absolute path to the `SKILL.md`.
+ *   - `mtimeMs` — modification time of `SKILL.md` for slim-index ordering.
+ *
+ * Per `skills-edge-cases.md` §1.9 / §1.10 symlinks are bounded:
+ *
+ *   - Symlink resolution count per skill is capped at `SYMLINK_HOP_CAP`.
+ *   - A symlink resolving outside the skill directory's tree is rejected
+ *     before any read.
+ *
+ * The walker never reads `SKILL.md` body content — it surfaces existence
+ * + mtime only. The parser (`../parser.ts`) handles the actual read.
+ */
+/** Per-skill symlink-resolution cap. Mirrors POSIX `O_NOFOLLOW`-style behavior. */
+export declare const SYMLINK_HOP_CAP = 8;
+export interface WalkedSkill {
+    readonly dirPath: string;
+    readonly skillFilePath: string;
+    readonly mtimeMs: number;
+    /**
+     * File size in bytes from `fs.stat`. The manager enforces the
+     * `SKILL_FILE_HARD_BYTES` cap before `fs.readFile` to defend against
+     * unbounded reads of third-party SKILL.md files.
+     */
+    readonly size: number;
+}
+/**
+ * Walk a single directory non-recursively and return every immediate
+ * sub-directory that contains a `SKILL.md` (or `skill.md`) file. The
+ * walker treats each subdirectory as one skill — supporting files
+ * (`reference.md`, `scripts/`, `assets/`) ride along but aren't surfaced
+ * by this walker.
+ *
+ * Errors thrown by the underlying `readdir` are propagated to the caller
+ * so the source-type walker can attach `sdk.skill.error` events with the
+ * source identity.
+ */
+export declare function findSkillDirectories(root: string): Promise<WalkedSkill[]>;
+/**
+ * Variant for sources whose root layout is "directory contains many
+ * subdirectories AND each subdirectory may itself contain skill
+ * subdirectories" — e.g. a glob expansion like `plugins/*\/skills`. The
+ * walker does NOT recurse arbitrarily deep; it probes exactly one level
+ * down from each immediate child.
+ *
+ * Pragmatically: if `root/foo/SKILL.md` exists, `foo` is a skill;
+ * otherwise the walker checks `root/foo/skills/` (legacy plugin layout).
+ */
+export declare function findSkillDirectoriesWithLegacyPluginLayout(root: string): Promise<WalkedSkill[]>;
+/**
+ * Walk a path with symlink-resolution and return its canonical absolute
+ * form, or `null` if the path doesn't exist or cannot be canonicalised.
+ */
+export declare function safeRealPath(p: string): Promise<string | null>;
+/**
+ * Walk upward from `cwd` looking for ancestor directories that contain a
+ * `<segment>` directory (typically `.qodo/skills` for the project source).
+ * Returns the matching ancestor paths in nearest-first order. Caller
+ * applies the precedence rule for ties.
+ */
+export declare function walkAncestors(cwd: string, segment: string): Promise<string[]>;
+//# sourceMappingURL=walk.d.ts.map

package/dist/skills/sources/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../../src/skills/sources/walk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,mFAAmF;AACnF,eAAO,MAAM,eAAe,IAAI,CAAC;AAcjC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgC/E;AAED;;;;;;;;;GASG;AACH,wBAAsB,0CAA0C,CAC9D,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,EAAE,CAAC,CAyBxB;AA8ED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMpE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB"}