@dzhechkov/harness-core 0.3.5 → 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

@@ -16,6 +16,12 @@ export { checkUpstream, loadSourcesManifest } from './sync-upstream.js';
 export type { SyncUpstreamReport, UpstreamCheckResult, SourcesManifest } 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 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';
 //# sourceMappingURL=index.d.ts.map

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,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

@@ -14,4 +14,7 @@ export { createSkill } from './create-skill.js';
 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"}
+{"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/publish.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Automated publish — discovers changed packages, bumps patch versions,
+ * builds, and publishes to npm.
+ *
+ * @packageDocumentation
+ */
+/** Result for a single package publish attempt. */
+export interface PublishResult {
+    readonly name: string;
+    readonly oldVersion: string;
+    readonly newVersion: string;
+    readonly status: 'published' | 'skipped' | 'error';
+    readonly error?: string | undefined;
+}
+/** Full publish report. */
+export interface PublishReport {
+    readonly packages: readonly PublishResult[];
+    readonly published: number;
+    readonly skipped: number;
+    readonly errors: number;
+    readonly dryRun: boolean;
+}
+/** Discover all publishable @dzhechkov packages. */
+export declare function discoverPackages(monorepoRoot: string): {
+    name: string;
+    dir: string;
+    version: string;
+}[];
+/** Publish packages that have changes since last publish. */
+export declare function publishPackages(monorepoRoot: string, opts?: {
+    dryRun?: boolean | undefined;
+    filter?: string[] | undefined;
+    bumpOnly?: boolean | undefined;
+}): PublishReport;
+//# sourceMappingURL=publish.d.ts.map

package/dist/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../src/publish.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AASD,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAavG;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B,GACL,aAAa,CA4Df"}

package/dist/publish.js

@@ -0,0 +1,87 @@
+/**
+ * Automated publish — discovers changed packages, bumps patch versions,
+ * builds, and publishes to npm.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+/** Bump patch version: 0.3.11 → 0.3.12 */
+function bumpPatch(version) {
+    const parts = version.split('.');
+    const patch = parseInt(parts[2] ?? '0', 10);
+    return `${parts[0]}.${parts[1]}.${patch + 1}`;
+}
+/** Discover all publishable @dzhechkov packages. */
+export function discoverPackages(monorepoRoot) {
+    const baseDir = join(monorepoRoot, 'packages', '@dzhechkov');
+    if (!existsSync(baseDir))
+        return [];
+    return readdirSync(baseDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => {
+        const pkgPath = join(baseDir, e.name, 'package.json');
+        if (!existsSync(pkgPath))
+            return undefined;
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return { name: pkg.name, dir: join(baseDir, e.name), version: pkg.version };
+    })
+        .filter((p) => p !== undefined);
+}
+/** Publish packages that have changes since last publish. */
+export function publishPackages(monorepoRoot, opts = {}) {
+    const packages = discoverPackages(monorepoRoot);
+    const results = [];
+    const filtered = opts.filter && opts.filter.length > 0
+        ? packages.filter((p) => opts.filter.some((f) => p.name.includes(f) || p.dir.includes(f)))
+        : packages;
+    for (const pkg of filtered) {
+        const oldVersion = pkg.version;
+        const newVersion = bumpPatch(oldVersion);
+        if (opts.dryRun) {
+            results.push({ name: pkg.name, oldVersion, newVersion, status: 'skipped' });
+            continue;
+        }
+        try {
+            // Bump version in package.json
+            const pkgJsonPath = join(pkg.dir, 'package.json');
+            const pkgJson = readFileSync(pkgJsonPath, 'utf-8');
+            writeFileSync(pkgJsonPath, pkgJson.replace(`"version": "${oldVersion}"`, `"version": "${newVersion}"`));
+            if (opts.bumpOnly) {
+                results.push({ name: pkg.name, oldVersion, newVersion, status: 'published' });
+                continue;
+            }
+            // Build if has build script
+            const parsed = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+            if (parsed.scripts?.['build']) {
+                execSync('pnpm build', { cwd: pkg.dir, stdio: 'pipe', encoding: 'utf-8' });
+            }
+            // Publish
+            execSync('pnpm publish --access public --no-git-checks', {
+                cwd: pkg.dir,
+                stdio: 'pipe',
+                encoding: 'utf-8',
+                env: { ...process.env },
+            });
+            results.push({ name: pkg.name, oldVersion, newVersion, status: 'published' });
+        }
+        catch (err) {
+            results.push({
+                name: pkg.name,
+                oldVersion,
+                newVersion,
+                status: 'error',
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return {
+        packages: results,
+        published: results.filter((r) => r.status === 'published').length,
+        skipped: results.filter((r) => r.status === 'skipped').length,
+        errors: results.filter((r) => r.status === 'error').length,
+        dryRun: opts.dryRun === true,
+    };
+}
+//# sourceMappingURL=publish.js.map

package/dist/publish.js.map

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

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.5",
+  "version": "0.3.7",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",
@@ -26,9 +26,9 @@
   "dependencies": {
     "yaml": "^2.0.0",
     "@dzhechkov/adapter-claude": "0.2.0",
+    "@dzhechkov/adapter-codex": "0.2.0",
     "@dzhechkov/adapter-hermes": "0.2.0",
     "@dzhechkov/adapter-opencode": "0.2.0",
-    "@dzhechkov/adapter-codex": "0.2.0",
     "@dzhechkov/adapter-openclaude": "0.1.0",
     "@dzhechkov/core": "0.2.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

@@ -18,5 +18,11 @@ export { checkUpstream, loadSourcesManifest } from './sync-upstream.js';
 export type { SyncUpstreamReport, UpstreamCheckResult, SourcesManifest } 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 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/publish.ts

@@ -0,0 +1,121 @@
+/**
+ * Automated publish — discovers changed packages, bumps patch versions,
+ * builds, and publishes to npm.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+
+/** Result for a single package publish attempt. */
+export interface PublishResult {
+  readonly name: string;
+  readonly oldVersion: string;
+  readonly newVersion: string;
+  readonly status: 'published' | 'skipped' | 'error';
+  readonly error?: string | undefined;
+}
+
+/** Full publish report. */
+export interface PublishReport {
+  readonly packages: readonly PublishResult[];
+  readonly published: number;
+  readonly skipped: number;
+  readonly errors: number;
+  readonly dryRun: boolean;
+}
+
+/** Bump patch version: 0.3.11 → 0.3.12 */
+function bumpPatch(version: string): string {
+  const parts = version.split('.');
+  const patch = parseInt(parts[2] ?? '0', 10);
+  return `${parts[0]}.${parts[1]}.${patch + 1}`;
+}
+
+/** Discover all publishable @dzhechkov packages. */
+export function discoverPackages(monorepoRoot: string): { name: string; dir: string; version: string }[] {
+  const baseDir = join(monorepoRoot, 'packages', '@dzhechkov');
+  if (!existsSync(baseDir)) return [];
+
+  return readdirSync(baseDir, { withFileTypes: true })
+    .filter((e) => e.isDirectory())
+    .map((e) => {
+      const pkgPath = join(baseDir, e.name, 'package.json');
+      if (!existsSync(pkgPath)) return undefined;
+      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8')) as { name: string; version: string };
+      return { name: pkg.name, dir: join(baseDir, e.name), version: pkg.version };
+    })
+    .filter((p): p is { name: string; dir: string; version: string } => p !== undefined);
+}
+
+/** Publish packages that have changes since last publish. */
+export function publishPackages(
+  monorepoRoot: string,
+  opts: {
+    dryRun?: boolean | undefined;
+    filter?: string[] | undefined;
+    bumpOnly?: boolean | undefined;
+  } = {},
+): PublishReport {
+  const packages = discoverPackages(monorepoRoot);
+  const results: PublishResult[] = [];
+  const filtered = opts.filter && opts.filter.length > 0
+    ? packages.filter((p) => opts.filter!.some((f) => p.name.includes(f) || p.dir.includes(f)))
+    : packages;
+
+  for (const pkg of filtered) {
+    const oldVersion = pkg.version;
+    const newVersion = bumpPatch(oldVersion);
+
+    if (opts.dryRun) {
+      results.push({ name: pkg.name, oldVersion, newVersion, status: 'skipped' });
+      continue;
+    }
+
+    try {
+      // Bump version in package.json
+      const pkgJsonPath = join(pkg.dir, 'package.json');
+      const pkgJson = readFileSync(pkgJsonPath, 'utf-8');
+      writeFileSync(pkgJsonPath, pkgJson.replace(`"version": "${oldVersion}"`, `"version": "${newVersion}"`));
+
+      if (opts.bumpOnly) {
+        results.push({ name: pkg.name, oldVersion, newVersion, status: 'published' });
+        continue;
+      }
+
+      // Build if has build script
+      const parsed = JSON.parse(readFileSync(pkgJsonPath, 'utf-8')) as { scripts?: Record<string, string> };
+      if (parsed.scripts?.['build']) {
+        execSync('pnpm build', { cwd: pkg.dir, stdio: 'pipe', encoding: 'utf-8' });
+      }
+
+      // Publish
+      execSync('pnpm publish --access public --no-git-checks', {
+        cwd: pkg.dir,
+        stdio: 'pipe',
+        encoding: 'utf-8',
+        env: { ...process.env },
+      });
+
+      results.push({ name: pkg.name, oldVersion, newVersion, status: 'published' });
+    } catch (err) {
+      results.push({
+        name: pkg.name,
+        oldVersion,
+        newVersion,
+        status: 'error',
+        error: err instanceof Error ? err.message : String(err),
+      });
+    }
+  }
+
+  return {
+    packages: results,
+    published: results.filter((r) => r.status === 'published').length,
+    skipped: results.filter((r) => r.status === 'skipped').length,
+    errors: results.filter((r) => r.status === 'error').length,
+    dryRun: opts.dryRun === true,
+  };
+}

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,
+  };
+}