@senpi/runtime 3.0.6-dev.runtime-phase-2.20260630134536 → 3.0.6-dev.runtime-phase-2.20260630182800

package/dist/skills-manager/skills-manifest.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "defaults": {
+    "repo": "https://github.com/Senpi-ai/senpi-skills",
+    "branch": "main"
+  },
+  "skills": [
+    { "name": "senpi-trading-runtime", "branch": "strategy-v2", "maxMajor": 3 },
+    { "name": "senpi-strategy-author", "branch": "strategy-v2", "maxMajor": 1 },
+    { "name": "senpi-strategy-discover", "branch": "strategy-v2", "maxMajor": 2 },
+    { "name": "senpi-strategy-ops", "branch": "strategy-v2", "maxMajor": 2 },
+    { "name": "senpi-portfolio", "branch": "strategy-v2", "maxMajor": 1 },
+    { "name": "senpi-smart-money", "branch": "strategy-v2", "maxMajor": 1 },
+    { "name": "senpi-trader-research", "branch": "strategy-v2", "maxMajor": 1 }
+  ]
+}

package/dist/skills-manager/types.d.ts

@@ -1,4 +1,26 @@
 export type SkillUpdateKind = "none" | "patch" | "minor" | "major" | "unknown";
+/**
+ * Per-skill source override. Lets an operator/QA point one skill at a
+ * different repo/branch/path than the manifest declares — e.g. testing a skill
+ * on a feature branch without editing the checked-in manifest.
+ *
+ * A per-skill `branch` override **beats** the global `SENPI_SKILLS_BRANCH`
+ * env knob (per-skill intent wins over the force-all knob); only the
+ * `SENPI_SKILLS_BRANCH_<NAME>` per-skill env var outranks it. See
+ * `resolveSkillSource` for the full precedence.
+ */
+export interface SkillSourceOverride {
+    repo?: string;
+    branch?: string;
+    /** Pin to a commit SHA, or `"latest"` to track the branch tip. */
+    commit?: string;
+    path?: string;
+    /**
+     * Auto-update major-version ceiling for this skill (overrides the manifest).
+     * See {@link import("./manifest.js").SkillManifestEntry.maxMajor}.
+     */
+    maxMajor?: number;
+}
 /** Minimal logger interface accepted throughout the skills-manager package. */
 export interface LoggerLike {
     info(...args: unknown[]): void;
@@ -21,7 +43,21 @@ export interface RawSkillsManagerConfig {
      * `DEFAULT_SKILLS_DIRS` when omitted, null, an empty array, or wrong-typed.
      */
     skillsDir?: string | string[];
+    /**
+     * @deprecated Ignored. The managed skill set is defined solely by the
+     * manifest (`skills-manifest.json`). This field is tolerated for backward
+     * compatibility with existing configs but no longer affects which skills are
+     * managed. Use `overrides` to retarget a skill's source, or `enabled: false`
+     * to disable the manager.
+     */
     skills?: string[];
+    /**
+     * Per-skill source overrides keyed by skill name. Optional. Each entry may
+     * override `repo`, `branch`, and/or `path` for that skill (e.g.
+     * `{ "senpi-strategy-ops": { "branch": "strategy-v2" } }`). The global
+     * `SENPI_SKILLS_BRANCH` env var still takes precedence over these.
+     */
+    overrides?: Record<string, SkillSourceOverride>;
 }
 /** Resolved config — all fields have safe defaults filled in. */
 export interface SkillsManagerConfig {
@@ -36,16 +72,19 @@ export interface SkillsManagerConfig {
      */
     skillsDir: string[];
     /**
-     * Skill names this coordinator manages.
-     *
-     * Resolution rules in `resolveSkillsManagerConfig`:
-     * - Field omitted in raw config → defaults to `DEFAULT_MANAGED_SKILLS`
-     *   (currently `["senpi-trading-runtime"]`).
-     * - Explicit non-empty array → uses those names.
-     * - Explicit empty array `[]` → discovery mode: scan subdirs under
-     *   `skillsDir`.
+     * @deprecated Ignored by the coordinator. The managed skill set is the
+     * manifest set (`getManifestSkillNames`), full stop. Still resolved here
+     * (defaults to the manifest names) for backward-compatible config shape, but
+     * nothing reads it to define the set. To disable the manager use
+     * `enabled: false`; to retarget a skill's source use `overrides`.
      */
     skills: string[];
+    /**
+     * Per-skill source overrides (repo/branch/path), keyed by skill name.
+     * Always present after resolution (defaults to `{}`). See
+     * {@link SkillSourceOverride}.
+     */
+    overrides: Record<string, SkillSourceOverride>;
 }
 /** Per-skill state persisted across gateway restarts. */
 export interface SkillState {
@@ -64,9 +103,6 @@ export interface SkillState {
      */
     latestVersion: string | null;
     lastCheckedAt: string | null;
-    lastAppliedVersion: string | null;
-    /** Dedup key: if remote major version matches this, skip re-notification. */
-    lastNotifiedMajorVersion: string | null;
     consecutiveFailures: number;
     lastFailureAt: string | null;
     lastFailureReason: string | null;
@@ -97,29 +133,19 @@ export interface SkillSnapshot {
     lastCheckedAt: string | null;
     consecutiveFailures: number;
     lastFailureReason: string | null;
+    /**
+     * True when the latest observed remote major exceeds the installed major —
+     * i.e. a major upgrade is available but not yet installed (gated unless the
+     * skill's `maxMajor` ceiling authorizes it). Surfaced by `senpi skills status`
+     * so pending majors are visible without notifications.
+     */
+    majorPending: boolean;
 }
 /** Result of a version check for a single skill. */
 export interface SkillVersionInfo {
     localVersion: string | null;
     remoteVersion: string | null;
     updateKind: SkillUpdateKind;
-    /**
-     * Short description parsed from the **remote** SKILL.md frontmatter (the
-     * version the user is being notified about), surfaced back to the
-     * coordinator so notification text can include an "About:" line that
-     * reflects the upcoming version rather than the potentially-stale local
-     * copy.
-     *
-     * Null when:
-     * - The remote fetch returned 404 (skill not in the remote repo).
-     * - The remote SKILL.md is present but its frontmatter has no
-     *   `description` field.
-     *
-     * Optional in the interface for backward compatibility with injected
-     * test deps that only return version data; the real `checkSkillVersion`
-     * always populates it (possibly null) on every return path.
-     */
-    remoteDescription?: string | null;
 }
 /** Injectable overrides used in unit tests to avoid network and git calls. */
 export interface SkillsUpdateCoordinatorDeps {
@@ -130,7 +156,7 @@ export interface SkillsUpdateCoordinatorDeps {
      * `skillsDirs` is the search-path array from the resolved config; the real
      * `checkSkillVersion` tries each in order when reading SKILL.md.
      */
-    checkSkillVersion?: (skillsDirs: readonly string[], skillName: string, rawBaseUrl: string, logger?: LoggerLike) => Promise<SkillVersionInfo>;
+    checkSkillVersion?: (skillsDirs: readonly string[], skillName: string, rawBaseUrl: string, logger?: LoggerLike, remotePath?: string) => Promise<SkillVersionInfo>;
     /**
      * Override clone + install — receives the list of skill names that need
      * updating and the config. Defaults to real cloneSkillsRepo + installSkill.
@@ -138,13 +164,18 @@ export interface SkillsUpdateCoordinatorDeps {
     cloneAndInstall?: (skills: string[], config: SkillsManagerConfig) => Promise<Map<string, string | null>>;
     /** Override bootstrap — avoids real git clone in unit tests. */
     bootstrapSkillsIfNeeded?: (config: SkillsManagerConfig, logger: LoggerLike) => Promise<void>;
+    /**
+     * Override the managed skill set. **Test-only seam** — production always
+     * uses the manifest (`getManifestSkillNames`). Lets unit tests drive the set
+     * without a fixture manifest on disk.
+     */
+    listManagedSkills?: () => string[];
 }
 /** Constructor options for {@link SkillsUpdateCoordinator}. */
 export interface SkillsUpdateCoordinatorOptions {
     config: SkillsManagerConfig;
     stateDir: string;
     logger: LoggerLike;
-    notify: (message: string) => Promise<void>;
     deps?: SkillsUpdateCoordinatorDeps;
 }
 /**

package/dist/skills-manager/types.d.ts.map

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

package/dist/skills-manager/utils.d.ts

@@ -1,17 +1,19 @@
 import type { RawSkillsManagerConfig, SkillsManagerConfig, SkillsManagerState, SkillState } from "./types.js";
 /**
  * Canonical default list of managed skill names when the user omits the
- * `skills` field. Kept in sync with the JSON Schema default in
- * `openclaw.plugin.json` (configSchema.properties.skillsManager.default.skills).
+ * `skills` field — sourced from the **manifest** (`skills-manifest.json`), the
+ * single source of truth for the managed set. No longer a hardcoded list.
  *
  * Semantics for the resolved `skills` array:
- * - Field omitted entirely → defaults to this list. New installs and partial
- *   configs like `{ enabled: true }` get the canonical skill bootstrapped
- *   automatically without requiring users to repeat the array in JSON.
+ * - Field omitted entirely → defaults to the manifest skill set. Partial
+ *   configs like `{ enabled: true }` get every manifest skill bootstrapped
+ *   automatically without repeating the array in JSON.
  * - Field present and non-empty → use the provided names (filtered for
- *   non-empty strings).
- * - Field present and explicitly empty (`"skills": []`) → discovery mode:
- *   scan subdirs under `skillsDir`.
+ *   non-empty strings) as a subset/override; each still resolves its source
+ *   (repo/branch/path) from the manifest.
+ * - Field present and explicitly empty (`"skills": []`) → legacy discovery
+ *   mode: scan subdirs under `skillsDir`. Retained for backward compatibility;
+ *   the manifest is the preferred source.
  */
 export declare const DEFAULT_MANAGED_SKILLS: readonly string[];
 /**
@@ -43,24 +45,6 @@ export declare function createDefaultSkillsManagerState(): SkillsManagerState;
 export declare function createDefaultSkillState(name: string): SkillState;
 /** Formats an unknown thrown value as a short string for log messages. */
 export declare function formatErr(e: unknown): string;
-/**
- * Parse a positive integer from an env-var string, falling back to the
- * supplied default on anything unparseable, zero, or negative.
- *
- * Used to load numeric env-overridable constants in `constants.ts` (e.g.
- * `TELEGRAM_NOTIFICATION_BUDGET_CHARS`) without throwing at module load
- * time when the env var is bogus — matches the rest of `constants.ts`'s
- * "default wins on bad input, never crash startup" style.
- *
- * Examples:
- *   parseEnvPositiveInt("8000",   4000)  // 8000  (valid override)
- *   parseEnvPositiveInt("abc",    4000)  // 4000  (unparseable → default)
- *   parseEnvPositiveInt("0",      4000)  // 4000  (zero → default)
- *   parseEnvPositiveInt("-100",   4000)  // 4000  (negative → default)
- *   parseEnvPositiveInt("",       4000)  // 4000  (empty → default)
- *   parseEnvPositiveInt(undefined, 4000) // 4000  (unset → default)
- */
-export declare function parseEnvPositiveInt(envValue: string | undefined, defaultValue: number): number;
 /**
  * Normalise the raw `skillsDir` value into a non-empty `string[]` (the
  * "search path" form used internally).

package/dist/skills-manager/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/skills-manager/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAA8B,CAAC;AAEnF;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,EAAE,sBAAsB,GAAG,IAAI,GACpC,mBAAmB,CAcrB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,IAAI,kBAAkB,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAYhE;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAI9F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAc3D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/skills-manager/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAA4B,CAAC;AAEjF;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,EAAE,sBAAsB,GAAG,IAAI,GACpC,mBAAmB,CAqBrB;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,IAAI,kBAAkB,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAUhE;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAc3D"}

package/dist/skills-manager/utils.js

@@ -1,19 +1,22 @@
 import { DEFAULT_SKILLS_DIRS } from "./constants.js";
+import { getManifestSkillNames } from "./manifest.js";
 /**
  * Canonical default list of managed skill names when the user omits the
- * `skills` field. Kept in sync with the JSON Schema default in
- * `openclaw.plugin.json` (configSchema.properties.skillsManager.default.skills).
+ * `skills` field — sourced from the **manifest** (`skills-manifest.json`), the
+ * single source of truth for the managed set. No longer a hardcoded list.
  *
  * Semantics for the resolved `skills` array:
- * - Field omitted entirely → defaults to this list. New installs and partial
- *   configs like `{ enabled: true }` get the canonical skill bootstrapped
- *   automatically without requiring users to repeat the array in JSON.
+ * - Field omitted entirely → defaults to the manifest skill set. Partial
+ *   configs like `{ enabled: true }` get every manifest skill bootstrapped
+ *   automatically without repeating the array in JSON.
  * - Field present and non-empty → use the provided names (filtered for
- *   non-empty strings).
- * - Field present and explicitly empty (`"skills": []`) → discovery mode:
- *   scan subdirs under `skillsDir`.
+ *   non-empty strings) as a subset/override; each still resolves its source
+ *   (repo/branch/path) from the manifest.
+ * - Field present and explicitly empty (`"skills": []`) → legacy discovery
+ *   mode: scan subdirs under `skillsDir`. Retained for backward compatibility;
+ *   the manifest is the preferred source.
  */
-export const DEFAULT_MANAGED_SKILLS = ["senpi-trading-runtime"];
+export const DEFAULT_MANAGED_SKILLS = getManifestSkillNames();
 /**
  * Parses and normalises the raw `skillsManager` config block from the plugin
  * config into a fully-resolved {@link SkillsManagerConfig}.
@@ -37,6 +40,12 @@ export function resolveSkillsManagerConfig(value) {
         skills: Array.isArray(raw.skills)
             ? raw.skills.filter((s) => typeof s === "string" && s.length > 0)
             : [...DEFAULT_MANAGED_SKILLS],
+        // Per-skill source overrides — pass through when a plain object, else {}.
+        overrides: raw.overrides !== null &&
+            typeof raw.overrides === "object" &&
+            !Array.isArray(raw.overrides)
+            ? raw.overrides
+            : {},
     };
 }
 /**
@@ -62,8 +71,6 @@ export function createDefaultSkillState(name) {
         installedVersion: null,
         latestVersion: null,
         lastCheckedAt: null,
-        lastAppliedVersion: null,
-        lastNotifiedMajorVersion: null,
         consecutiveFailures: 0,
         lastFailureAt: null,
         lastFailureReason: null,
@@ -73,29 +80,6 @@ export function createDefaultSkillState(name) {
 export function formatErr(e) {
     return e instanceof Error ? e.message : String(e);
 }
-/**
- * Parse a positive integer from an env-var string, falling back to the
- * supplied default on anything unparseable, zero, or negative.
- *
- * Used to load numeric env-overridable constants in `constants.ts` (e.g.
- * `TELEGRAM_NOTIFICATION_BUDGET_CHARS`) without throwing at module load
- * time when the env var is bogus — matches the rest of `constants.ts`'s
- * "default wins on bad input, never crash startup" style.
- *
- * Examples:
- *   parseEnvPositiveInt("8000",   4000)  // 8000  (valid override)
- *   parseEnvPositiveInt("abc",    4000)  // 4000  (unparseable → default)
- *   parseEnvPositiveInt("0",      4000)  // 4000  (zero → default)
- *   parseEnvPositiveInt("-100",   4000)  // 4000  (negative → default)
- *   parseEnvPositiveInt("",       4000)  // 4000  (empty → default)
- *   parseEnvPositiveInt(undefined, 4000) // 4000  (unset → default)
- */
-export function parseEnvPositiveInt(envValue, defaultValue) {
-    if (envValue === undefined || envValue === "")
-        return defaultValue;
-    const n = parseInt(envValue, 10);
-    return Number.isFinite(n) && n > 0 ? n : defaultValue;
-}
 /**
  * Normalise the raw `skillsDir` value into a non-empty `string[]` (the
  * "search path" form used internally).

package/dist/skills-manager/utils.js.map

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

package/dist/skills-manager/version-manager.d.ts

@@ -26,111 +26,41 @@ export declare function normalizeVersion(v: string): string;
  * Returns null when the frontmatter block is absent or the field is missing.
  */
 export declare function parseSkillMdVersion(content: string): string | null;
-/**
- * Extract the `description` value from a SKILL.md YAML frontmatter block.
- *
- * Skill descriptions can be authored a few different ways. This helper
- * handles the real-world shapes that appear in the senpi-skills repo today:
- *
- *   1. Single-line, double-quoted:
- *        description: "Configure, deploy, ..."
- *   2. Single-line, single-quoted or unquoted:
- *        description: Manage runtimes ...
- *   3. YAML block scalar (folded or literal, optional chomping indicator):
- *        description: >
- *          A short summary
- *          continues on this line.
- *        description: >-       # strip trailing newlines (this PR's senpi-skills repo)
- *          A short summary
- *        description: |        # literal — preserves newlines (collapsed to spaces here)
- *          A short summary
- *        description: |+       # keep trailing newlines (same handling)
- *
- *      The block scalar header is `[>|][-+]?` per the YAML 1.2 spec:
- *      `>` = folded, `|` = literal; `-` strips trailing newlines,
- *      `+` keeps them, no indicator clips. For notification rendering we
- *      always collapse to a single line joined by spaces, so the chomping
- *      indicator only affects whether we match the block-scalar branch.
- *
- * Returns null when the field is absent or the frontmatter block is missing.
- *
- * Note: kept as a regex extractor rather than introducing a full YAML
- * parse here — `parseSkillMdVersion` uses the same approach, and skill
- * frontmatters are constrained enough that the regex covers the shapes we
- * actually encounter. If we ever adopt a full YAML parser for this file,
- * both helpers should switch together.
- */
-export declare function parseSkillMdDescription(content: string): string | null;
-/**
- * Read both the installed version and description for a skill from its local
- * SKILL.md. Shared core for `readLocalVersion` and `readLocalDescription` so a
- * tick that needs both pays a single file read per dir rather than two.
- *
- * Multi-dir search path: tries each entry in order and returns the first
- * readable SKILL.md's parsed fields. Either field may be null if absent in
- * the frontmatter — that's distinct from "no SKILL.md found at all" (which
- * returns nulls only after every dir has been tried).
- */
-export declare function readLocalSkillMetadata(skillsDir: string | readonly string[], skillName: string, logger?: LoggerLike): Promise<{
-    version: string | null;
-    description: string | null;
-}>;
 /**
  * Read the installed version for a skill from its local SKILL.md.
  *
- * Accepts either a single dir (legacy callers) or an array of dirs (new
+ * Accepts either a single dir (legacy callers) or an array of dirs (the
  * multi-dir search path). When given an array, tries each entry in order and
- * returns the first non-null match — this mirrors the documented behaviour
- * that `skillsDir[0]` is the *primary* (writes go here) and the remaining
- * entries are read-only fallbacks scanned during version checks.
- *
- * Returns null when no readable SKILL.md is found across any of the
- * candidate dirs, or when the version field is absent. Logs a warning per
- * dir for unexpected errors (anything other than ENOENT).
+ * returns the first readable SKILL.md's parsed version — this mirrors the
+ * documented behaviour that `skillsDir[0]` is the *primary* (writes go here)
+ * and the remaining entries are read-only fallbacks scanned during version
+ * checks.
+ *
+ * The first readable SKILL.md wins even if its version field is absent — a
+ * present-but-versionless file is meaningful state (skill predates versioning),
+ * not a "not found" signal that should let the next dir override it. Returns
+ * null when no readable SKILL.md is found across any candidate dir, or when the
+ * version field is absent. Logs a warning per dir for unexpected errors
+ * (anything other than ENOENT).
  */
 export declare function readLocalVersion(skillsDir: string | readonly string[], skillName: string, logger?: LoggerLike): Promise<string | null>;
 /**
- * Read the installed description for a skill from its local SKILL.md.
- * Multi-dir search path semantics identical to `readLocalVersion`.
- *
- * Returns null when no readable SKILL.md is found across any of the
- * candidate dirs, or when the description field is absent.
- */
-export declare function readLocalDescription(skillsDir: string | readonly string[], skillName: string, logger?: LoggerLike): Promise<string | null>;
-/**
- * Fetch the remote SKILL.md for a skill and return both the version and the
- * description in one network round-trip.
- *
- * Notification text uses the description from the **remote** SKILL.md (not
- * the local one) so the "About:" line reflects the version the user is being
- * asked about — a description on disk for v1.x may be stale relative to the
- * v2.0.0 the major-update notification is announcing.
+ * Fetch the remote SKILL.md for a skill and return its version.
  *
- * Returns null fields when the skill does not exist in the remote repo
- * (HTTP 404) — that's a legitimate state ("skill removed or not yet
- * published"), not an error, so it should not pollute failure counters.
- * Both fields may also be null when the remote SKILL.md is present but
- * its frontmatter omits the corresponding field.
+ * Returns null when the skill does not exist in the remote repo (HTTP 404) —
+ * that's a legitimate state ("skill removed or not yet published"), not an
+ * error, so it should not pollute failure counters. Also null when the remote
+ * SKILL.md is present but its frontmatter omits the version field.
  *
  * Throws on transient/operational failures (network errors, timeouts, 5xx
  * responses, body-parse failures) so the caller's failure-recording path can
  * fire.
  *
+ * @param remotePath Subdirectory inside the repo holding the skill (manifest
+ *   `path`); defaults to the skill name (monorepo convention).
  * @param fetchImpl Injectable for unit testing — defaults to global `fetch`.
  */
-export declare function fetchRemoteSkillMetadata(skillName: string, rawBaseUrl?: string, fetchImpl?: typeof fetch): Promise<{
-    version: string | null;
-    description: string | null;
-}>;
-/**
- * Fetch the remote SKILL.md for a skill and return its version.
- *
- * Thin wrapper over {@link fetchRemoteSkillMetadata} kept for backward
- * compatibility with callers (and tests) that only need the version field.
- * New code that wants both version + description in a single round-trip
- * should call `fetchRemoteSkillMetadata` directly.
- */
-export declare function fetchRemoteVersion(skillName: string, rawBaseUrl?: string, fetchImpl?: typeof fetch): Promise<string | null>;
+export declare function fetchRemoteVersion(skillName: string, rawBaseUrl?: string, fetchImpl?: typeof fetch, remotePath?: string): Promise<string | null>;
 /**
  * Compare the local and remote versions for a skill and return a classified diff.
  *
@@ -142,5 +72,5 @@ export declare function fetchRemoteVersion(skillName: string, rawBaseUrl?: strin
  * - Remote version is absent or unparseable → "unknown", caller should log and
  *   skip.
  */
-export declare function checkSkillVersion(skillsDir: string | readonly string[], skillName: string, rawBaseUrl?: string, fetchImpl?: typeof fetch, logger?: LoggerLike): Promise<SkillVersionInfo>;
+export declare function checkSkillVersion(skillsDir: string | readonly string[], skillName: string, rawBaseUrl?: string, fetchImpl?: typeof fetch, logger?: LoggerLike, remotePath?: string): Promise<SkillVersionInfo>;
 //# sourceMappingURL=version-manager.d.ts.map

package/dist/skills-manager/version-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-manager.d.ts","sourceRoot":"","sources":["../../src/skills-manager/version-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6CtE;AASD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CA2BjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAA4B,EACxC,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAkCjE;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAA4B,EACxC,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAA4B,EACxC,SAAS,GAAE,OAAO,KAAa,EAC/B,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAgD3B"}
+{"version":3,"file":"version-manager.d.ts","sourceRoot":"","sources":["../../src/skills-manager/version-manager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAA4B,EACxC,SAAS,GAAE,OAAO,KAAa,EAC/B,UAAU,GAAE,MAAkB,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoCxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAA4B,EACxC,SAAS,GAAE,OAAO,KAAa,EAC/B,MAAM,CAAC,EAAE,UAAU,EACnB,UAAU,GAAE,MAAkB,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAyC3B"}