@dzhechkov/harness-core 0.3.6 → 0.3.7

package/dist/downloads.d.ts

@@ -0,0 +1,22 @@
+/**
+ * npm download statistics — fetches weekly download counts for all published packages.
+ *
+ * @packageDocumentation
+ */
+/** Download stats for a single package. */
+export interface PackageDownloads {
+    readonly name: string;
+    readonly downloads: number;
+    readonly period: string;
+    readonly error?: string | undefined;
+}
+/** Full downloads report. */
+export interface DownloadsReport {
+    readonly packages: readonly PackageDownloads[];
+    readonly totalDownloads: number;
+    readonly period: string;
+    readonly fetchedAt: string;
+}
+/** Fetch downloads for all given package names. */
+export declare function fetchAllDownloads(packageNames: string[]): Promise<DownloadsReport>;
+//# sourceMappingURL=downloads.d.ts.map

package/dist/downloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.d.ts","sourceRoot":"","sources":["../src/downloads.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,6BAA6B;AAC7B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAuBD,mDAAmD;AACnD,wBAAsB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CASxF"}

package/dist/downloads.js

@@ -0,0 +1,36 @@
+/**
+ * npm download statistics — fetches weekly download counts for all published packages.
+ *
+ * @packageDocumentation
+ */
+/** Fetch weekly downloads for a single npm package. */
+async function fetchDownloads(name) {
+    const period = 'last-week';
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => { controller.abort(); }, 10000);
+        const url = `https://api.npmjs.org/downloads/point/${period}/${encodeURIComponent(name)}`;
+        const resp = await fetch(url, { signal: controller.signal });
+        clearTimeout(timer);
+        if (!resp.ok) {
+            return { name, downloads: 0, period, error: `HTTP ${resp.status}` };
+        }
+        const data = (await resp.json());
+        return { name, downloads: data.downloads, period };
+    }
+    catch (err) {
+        return { name, downloads: 0, period, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** Fetch downloads for all given package names. */
+export async function fetchAllDownloads(packageNames) {
+    const results = await Promise.all(packageNames.map(fetchDownloads));
+    results.sort((a, b) => b.downloads - a.downloads);
+    return {
+        packages: results,
+        totalDownloads: results.reduce((sum, r) => sum + r.downloads, 0),
+        period: 'last-week',
+        fetchedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=downloads.js.map

package/dist/downloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.js","sourceRoot":"","sources":["../src/downloads.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,uDAAuD;AACvD,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,yCAAyC,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpB,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA0B,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACjG,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,YAAsB;IAC5D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAChE,MAAM,EAAE,WAAW;QACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -17,6 +17,10 @@ export type { SyncUpstreamReport, UpstreamCheckResult, SourcesManifest } from '.
 export { benchmarkSkill, benchmarkSkills, compareSkills } from './benchmark.js';
 export { buildRegistry, searchRegistry, filterByCategory } from './registry.js';
 export { discoverPackages, publishPackages } from './publish.js';
+export { fetchAllDownloads } from './downloads.js';
+export type { PackageDownloads, DownloadsReport } from './downloads.js';
+export { discoverInstalled, checkUpgrades } from './upgrade.js';
+export type { InstalledSkill, UpgradeCheck, UpgradeReport } from './upgrade.js';
 export type { PublishResult, PublishReport } from './publish.js';
 export type { RegistryEntry, Registry } from './registry.js';
 export type { BenchmarkCheck, BenchmarkScore, BenchmarkReport, CompareResult } from './benchmark.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -15,4 +15,6 @@ export { checkUpstream, loadSourcesManifest } from './sync-upstream.js';
 export { benchmarkSkill, benchmarkSkills, compareSkills } from './benchmark.js';
 export { buildRegistry, searchRegistry, filterByCategory } from './registry.js';
 export { discoverPackages, publishPackages } from './publish.js';
+export { fetchAllDownloads } from './downloads.js';
+export { discoverInstalled, checkUpgrades } from './upgrade.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/upgrade.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Skill upgrade — detects installed skills and re-applies from canonical source.
+ *
+ * @packageDocumentation
+ */
+/** Info about an installed skill. */
+export interface InstalledSkill {
+    readonly id: string;
+    readonly path: string;
+    readonly size: number;
+    readonly modifiedAt: string;
+    readonly hasFrontmatter: boolean;
+}
+/** Upgrade check for a single skill. */
+export interface UpgradeCheck {
+    readonly id: string;
+    readonly installed: InstalledSkill;
+    readonly canonicalSize: number | undefined;
+    readonly needsUpdate: boolean;
+    readonly reason: string;
+}
+/** Full upgrade report. */
+export interface UpgradeReport {
+    readonly targetDir: string;
+    readonly installed: number;
+    readonly needsUpdate: number;
+    readonly upToDate: number;
+    readonly notInCanonical: number;
+    readonly skills: readonly UpgradeCheck[];
+}
+/** Discover installed skills in a target platform directory. */
+export declare function discoverInstalled(targetDir: string): InstalledSkill[];
+/** Check which installed skills need updates by comparing with canonical sources. */
+export declare function checkUpgrades(targetDir: string, canonicalDirs: string[]): UpgradeReport;
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;CAC1C;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAgBrE;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EAAE,GACtB,aAAa,CAoDf"}

package/dist/upgrade.js

@@ -0,0 +1,77 @@
+/**
+ * Skill upgrade — detects installed skills and re-applies from canonical source.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+/** Discover installed skills in a target platform directory. */
+export function discoverInstalled(targetDir) {
+    if (!existsSync(targetDir))
+        return [];
+    return readdirSync(targetDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && existsSync(join(targetDir, e.name, 'SKILL.md')))
+        .map((e) => {
+        const skillMdPath = join(targetDir, e.name, 'SKILL.md');
+        const stat = statSync(skillMdPath);
+        const content = readFileSync(skillMdPath, 'utf-8');
+        return {
+            id: e.name,
+            path: join(targetDir, e.name),
+            size: stat.size,
+            modifiedAt: stat.mtime.toISOString().slice(0, 10),
+            hasFrontmatter: content.startsWith('---'),
+        };
+    });
+}
+/** Check which installed skills need updates by comparing with canonical sources. */
+export function checkUpgrades(targetDir, canonicalDirs) {
+    const installed = discoverInstalled(targetDir);
+    // Build canonical index: skill id → { dir, size }
+    const canonical = new Map();
+    for (const cDir of canonicalDirs) {
+        if (!existsSync(cDir))
+            continue;
+        const skills = readdirSync(cDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory() && existsSync(join(cDir, e.name, 'SKILL.md')));
+        for (const skill of skills) {
+            const skillMdPath = join(cDir, skill.name, 'SKILL.md');
+            const stat = statSync(skillMdPath);
+            canonical.set(skill.name, { dir: join(cDir, skill.name), size: stat.size });
+        }
+    }
+    const checks = [];
+    for (const inst of installed) {
+        const can = canonical.get(inst.id);
+        if (!can) {
+            checks.push({
+                id: inst.id,
+                installed: inst,
+                canonicalSize: undefined,
+                needsUpdate: false,
+                reason: 'not in canonical (custom or removed)',
+            });
+            continue;
+        }
+        const sizeDiff = Math.abs(inst.size - can.size);
+        const needsUpdate = sizeDiff > 0;
+        checks.push({
+            id: inst.id,
+            installed: inst,
+            canonicalSize: can.size,
+            needsUpdate,
+            reason: needsUpdate
+                ? `size differs (installed: ${inst.size}B, canonical: ${can.size}B, delta: ${sizeDiff}B)`
+                : 'up to date',
+        });
+    }
+    return {
+        targetDir,
+        installed: installed.length,
+        needsUpdate: checks.filter((c) => c.needsUpdate).length,
+        upToDate: checks.filter((c) => !c.needsUpdate && c.canonicalSize !== undefined).length,
+        notInCanonical: checks.filter((c) => c.canonicalSize === undefined).length,
+        skills: checks,
+    };
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/upgrade.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",
@@ -26,11 +26,11 @@
   "dependencies": {
     "yaml": "^2.0.0",
     "@dzhechkov/adapter-claude": "0.2.0",
+    "@dzhechkov/adapter-codex": "0.2.0",
     "@dzhechkov/adapter-hermes": "0.2.0",
-    "@dzhechkov/core": "0.2.0",
     "@dzhechkov/adapter-opencode": "0.2.0",
     "@dzhechkov/adapter-openclaude": "0.1.0",
-    "@dzhechkov/adapter-codex": "0.2.0"
+    "@dzhechkov/core": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/src/downloads.ts

@@ -0,0 +1,54 @@
+/**
+ * npm download statistics — fetches weekly download counts for all published packages.
+ *
+ * @packageDocumentation
+ */
+
+/** Download stats for a single package. */
+export interface PackageDownloads {
+  readonly name: string;
+  readonly downloads: number;
+  readonly period: string;
+  readonly error?: string | undefined;
+}
+
+/** Full downloads report. */
+export interface DownloadsReport {
+  readonly packages: readonly PackageDownloads[];
+  readonly totalDownloads: number;
+  readonly period: string;
+  readonly fetchedAt: string;
+}
+
+/** Fetch weekly downloads for a single npm package. */
+async function fetchDownloads(name: string): Promise<PackageDownloads> {
+  const period = 'last-week';
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => { controller.abort(); }, 10000);
+    const url = `https://api.npmjs.org/downloads/point/${period}/${encodeURIComponent(name)}`;
+    const resp = await fetch(url, { signal: controller.signal });
+    clearTimeout(timer);
+
+    if (!resp.ok) {
+      return { name, downloads: 0, period, error: `HTTP ${resp.status}` };
+    }
+
+    const data = (await resp.json()) as { downloads: number };
+    return { name, downloads: data.downloads, period };
+  } catch (err) {
+    return { name, downloads: 0, period, error: err instanceof Error ? err.message : String(err) };
+  }
+}
+
+/** Fetch downloads for all given package names. */
+export async function fetchAllDownloads(packageNames: string[]): Promise<DownloadsReport> {
+  const results = await Promise.all(packageNames.map(fetchDownloads));
+  results.sort((a, b) => b.downloads - a.downloads);
+  return {
+    packages: results,
+    totalDownloads: results.reduce((sum, r) => sum + r.downloads, 0),
+    period: 'last-week',
+    fetchedAt: new Date().toISOString(),
+  };
+}

package/src/index.ts

@@ -19,6 +19,10 @@ export type { SyncUpstreamReport, UpstreamCheckResult, SourcesManifest } from '.
 export { benchmarkSkill, benchmarkSkills, compareSkills } from './benchmark.js';
 export { buildRegistry, searchRegistry, filterByCategory } from './registry.js';
 export { discoverPackages, publishPackages } from './publish.js';
+export { fetchAllDownloads } from './downloads.js';
+export type { PackageDownloads, DownloadsReport } from './downloads.js';
+export { discoverInstalled, checkUpgrades } from './upgrade.js';
+export type { InstalledSkill, UpgradeCheck, UpgradeReport } from './upgrade.js';
 export type { PublishResult, PublishReport } from './publish.js';
 export type { RegistryEntry, Registry } from './registry.js';
 export type { BenchmarkCheck, BenchmarkScore, BenchmarkReport, CompareResult } from './benchmark.js';

package/src/upgrade.ts

@@ -0,0 +1,113 @@
+/**
+ * Skill upgrade — detects installed skills and re-applies from canonical source.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** Info about an installed skill. */
+export interface InstalledSkill {
+  readonly id: string;
+  readonly path: string;
+  readonly size: number;
+  readonly modifiedAt: string;
+  readonly hasFrontmatter: boolean;
+}
+
+/** Upgrade check for a single skill. */
+export interface UpgradeCheck {
+  readonly id: string;
+  readonly installed: InstalledSkill;
+  readonly canonicalSize: number | undefined;
+  readonly needsUpdate: boolean;
+  readonly reason: string;
+}
+
+/** Full upgrade report. */
+export interface UpgradeReport {
+  readonly targetDir: string;
+  readonly installed: number;
+  readonly needsUpdate: number;
+  readonly upToDate: number;
+  readonly notInCanonical: number;
+  readonly skills: readonly UpgradeCheck[];
+}
+
+/** Discover installed skills in a target platform directory. */
+export function discoverInstalled(targetDir: string): InstalledSkill[] {
+  if (!existsSync(targetDir)) return [];
+  return readdirSync(targetDir, { withFileTypes: true })
+    .filter((e) => e.isDirectory() && existsSync(join(targetDir, e.name, 'SKILL.md')))
+    .map((e) => {
+      const skillMdPath = join(targetDir, e.name, 'SKILL.md');
+      const stat = statSync(skillMdPath);
+      const content = readFileSync(skillMdPath, 'utf-8');
+      return {
+        id: e.name,
+        path: join(targetDir, e.name),
+        size: stat.size,
+        modifiedAt: stat.mtime.toISOString().slice(0, 10),
+        hasFrontmatter: content.startsWith('---'),
+      };
+    });
+}
+
+/** Check which installed skills need updates by comparing with canonical sources. */
+export function checkUpgrades(
+  targetDir: string,
+  canonicalDirs: string[],
+): UpgradeReport {
+  const installed = discoverInstalled(targetDir);
+
+  // Build canonical index: skill id → { dir, size }
+  const canonical = new Map<string, { dir: string; size: number }>();
+  for (const cDir of canonicalDirs) {
+    if (!existsSync(cDir)) continue;
+    const skills = readdirSync(cDir, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && existsSync(join(cDir, e.name, 'SKILL.md')));
+    for (const skill of skills) {
+      const skillMdPath = join(cDir, skill.name, 'SKILL.md');
+      const stat = statSync(skillMdPath);
+      canonical.set(skill.name, { dir: join(cDir, skill.name), size: stat.size });
+    }
+  }
+
+  const checks: UpgradeCheck[] = [];
+
+  for (const inst of installed) {
+    const can = canonical.get(inst.id);
+    if (!can) {
+      checks.push({
+        id: inst.id,
+        installed: inst,
+        canonicalSize: undefined,
+        needsUpdate: false,
+        reason: 'not in canonical (custom or removed)',
+      });
+      continue;
+    }
+
+    const sizeDiff = Math.abs(inst.size - can.size);
+    const needsUpdate = sizeDiff > 0;
+    checks.push({
+      id: inst.id,
+      installed: inst,
+      canonicalSize: can.size,
+      needsUpdate,
+      reason: needsUpdate
+        ? `size differs (installed: ${inst.size}B, canonical: ${can.size}B, delta: ${sizeDiff}B)`
+        : 'up to date',
+    });
+  }
+
+  return {
+    targetDir,
+    installed: installed.length,
+    needsUpdate: checks.filter((c) => c.needsUpdate).length,
+    upToDate: checks.filter((c) => !c.needsUpdate && c.canonicalSize !== undefined).length,
+    notInCanonical: checks.filter((c) => c.canonicalSize === undefined).length,
+    skills: checks,
+  };
+}