@dzhechkov/harness-core 0.3.1 → 0.3.3

package/dist/index.d.ts

@@ -12,4 +12,6 @@ export * from './operations.js';
 export * from './workflows.js';
 export { createSkill } from './create-skill.js';
 export type { CreateSkillOptions, CreateSkillResult } from './create-skill.js';
+export { checkUpstream, loadSourcesManifest } from './sync-upstream.js';
+export type { SyncUpstreamReport, UpstreamCheckResult, SourcesManifest } from './sync-upstream.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"}
+{"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"}

package/dist/index.js

@@ -11,4 +11,5 @@ export * from './targets.js';
 export * from './operations.js';
 export * from './workflows.js';
 export { createSkill } from './create-skill.js';
+export { checkUpstream, loadSourcesManifest } from './sync-upstream.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"}
+{"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"}

package/dist/sync-upstream.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Upstream sync — fetches SKILL.md from origin repos defined in sources.json
+ * and reports which skills have upstream changes.
+ *
+ * @packageDocumentation
+ */
+/** A single skill's source mapping. */
+export interface SkillSource {
+    readonly path: string;
+    readonly version?: string | undefined;
+    readonly trust?: string | undefined;
+    readonly note?: string | undefined;
+}
+/** The origin repo metadata. */
+export interface OriginMeta {
+    readonly repo: string;
+    readonly url: string;
+    readonly branch: string;
+    readonly license: string;
+    readonly author: string;
+    readonly canonicalized: string;
+}
+/** The sources.json schema. */
+export interface SourcesManifest {
+    readonly origin: OriginMeta;
+    readonly skills: Record<string, SkillSource>;
+}
+/** Result of checking one skill against upstream. */
+export interface UpstreamCheckResult {
+    readonly skillId: string;
+    readonly originPath: string;
+    readonly status: 'up-to-date' | 'changed' | 'fetch-error' | 'local-missing';
+    readonly localLines?: number | undefined;
+    readonly upstreamLines?: number | undefined;
+    readonly error?: string | undefined;
+}
+/** Result of a full upstream sync check. */
+export interface SyncUpstreamReport {
+    readonly origin: OriginMeta;
+    readonly checked: number;
+    readonly changed: number;
+    readonly upToDate: number;
+    readonly errors: number;
+    readonly skills: readonly UpstreamCheckResult[];
+}
+/** Load sources.json from a skills package directory. */
+export declare function loadSourcesManifest(packageDir: string): SourcesManifest | undefined;
+/**
+ * Check all skills in a sources.json manifest against their upstream.
+ * Compares line counts as a quick diff indicator (full diff would be too verbose).
+ */
+export declare function checkUpstream(packageDir: string): Promise<SyncUpstreamReport | undefined>;
+//# sourceMappingURL=sync-upstream.d.ts.map

package/dist/sync-upstream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-upstream.d.ts","sourceRoot":"","sources":["../src/sync-upstream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC9C;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,eAAe,CAAC;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAED,yDAAyD;AACzD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAKnF;AA6BD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAiD/F"}

package/dist/sync-upstream.js

@@ -0,0 +1,89 @@
+/**
+ * Upstream sync — fetches SKILL.md from origin repos defined in sources.json
+ * and reports which skills have upstream changes.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Load sources.json from a skills package directory. */
+export function loadSourcesManifest(packageDir) {
+    const sourcesPath = join(packageDir, 'sources.json');
+    if (!existsSync(sourcesPath))
+        return undefined;
+    const raw = readFileSync(sourcesPath, 'utf-8');
+    return JSON.parse(raw);
+}
+/** Build the raw GitHub URL for a skill's SKILL.md. */
+function rawUrl(origin, skillPath) {
+    return `https://raw.githubusercontent.com/${origin.repo}/${origin.branch}/${skillPath}`;
+}
+/** Fetch text content from a URL with timeout. */
+async function fetchText(url, timeoutMs = 10000) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => { controller.abort(); }, timeoutMs);
+        const response = await fetch(url, { signal: controller.signal });
+        clearTimeout(timer);
+        if (!response.ok) {
+            return { ok: false, text: '', error: `HTTP ${response.status}` };
+        }
+        const text = await response.text();
+        return { ok: true, text };
+    }
+    catch (err) {
+        return { ok: false, text: '', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** Count non-empty lines in text. */
+function lineCount(text) {
+    return text.split('\n').length;
+}
+/**
+ * Check all skills in a sources.json manifest against their upstream.
+ * Compares line counts as a quick diff indicator (full diff would be too verbose).
+ */
+export async function checkUpstream(packageDir) {
+    const manifest = loadSourcesManifest(packageDir);
+    if (!manifest)
+        return undefined;
+    const results = [];
+    for (const [skillId, source] of Object.entries(manifest.skills)) {
+        const localSkillMd = join(packageDir, skillId, 'SKILL.md');
+        if (!existsSync(localSkillMd)) {
+            results.push({ skillId, originPath: source.path, status: 'local-missing' });
+            continue;
+        }
+        const localText = readFileSync(localSkillMd, 'utf-8');
+        const url = rawUrl(manifest.origin, source.path);
+        const upstream = await fetchText(url);
+        if (!upstream.ok) {
+            results.push({
+                skillId,
+                originPath: source.path,
+                status: 'fetch-error',
+                error: upstream.error,
+            });
+            continue;
+        }
+        const localLines = lineCount(localText);
+        const upstreamLines = lineCount(upstream.text);
+        const changed = localLines !== upstreamLines;
+        results.push({
+            skillId,
+            originPath: source.path,
+            status: changed ? 'changed' : 'up-to-date',
+            localLines,
+            upstreamLines,
+        });
+    }
+    return {
+        origin: manifest.origin,
+        checked: results.length,
+        changed: results.filter((r) => r.status === 'changed').length,
+        upToDate: results.filter((r) => r.status === 'up-to-date').length,
+        errors: results.filter((r) => r.status === 'fetch-error' || r.status === 'local-missing').length,
+        skills: results,
+    };
+}
+//# sourceMappingURL=sync-upstream.js.map

package/dist/sync-upstream.js.map

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

package/dist/targets.d.ts

@@ -13,6 +13,7 @@ export declare const TARGETS: {
     readonly codex: Adapter;
     readonly opencode: Adapter;
     readonly hermes: Adapter;
+    readonly openclaude: Adapter;
 };
 /** A valid `--target` name. */
 export type TargetName = keyof typeof TARGETS;

package/dist/targets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;CAKwB,CAAC;AAE7C,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C,uCAAuC;AACvC,eAAO,MAAM,YAAY,EAA2B,UAAU,EAAE,CAAC;AAEjE,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D"}
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;CAMwB,CAAC;AAE7C,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C,uCAAuC;AACvC,eAAO,MAAM,YAAY,EAA2B,UAAU,EAAE,CAAC;AAEjE,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D"}

package/dist/targets.js

@@ -7,6 +7,7 @@ import { claudeAdapter } from '@dzhechkov/adapter-claude';
 import { codexAdapter } from '@dzhechkov/adapter-codex';
 import { hermesAdapter } from '@dzhechkov/adapter-hermes';
 import { opencodeAdapter } from '@dzhechkov/adapter-opencode';
+import { openclaudeAdapter } from '@dzhechkov/adapter-openclaude';
 /**
  * The targets the harness can initialise. The key is the CLI `--target` name
  * (`claude-code`, not `claude`); the value is the adapter that emits for it.
@@ -16,6 +17,7 @@ export const TARGETS = {
     codex: codexAdapter,
     opencode: opencodeAdapter,
     hermes: hermesAdapter,
+    openclaude: openclaudeAdapter,
 };
 /** Every supported `--target` name. */
 export const TARGET_NAMES = Object.keys(TARGETS);

package/dist/targets.js.map

@@ -1 +1 @@
-{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,aAAa;CACqB,CAAC;AAK7C,uCAAuC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAiB,CAAC;AAEjE,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,eAAe;IACzB,MAAM,EAAE,aAAa;IACrB,UAAU,EAAE,iBAAiB;CACa,CAAC;AAK7C,uCAAuC;AACvC,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAiB,CAAC;AAEjE,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC"}

package/package.json

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

package/src/index.ts

@@ -14,3 +14,5 @@ export * from './operations.js';
 export * from './workflows.js';
 export { createSkill } from './create-skill.js';
 export type { CreateSkillOptions, CreateSkillResult } from './create-skill.js';
+export { checkUpstream, loadSourcesManifest } from './sync-upstream.js';
+export type { SyncUpstreamReport, UpstreamCheckResult, SourcesManifest } from './sync-upstream.js';

package/src/sync-upstream.ts

@@ -0,0 +1,143 @@
+/**
+ * Upstream sync — fetches SKILL.md from origin repos defined in sources.json
+ * and reports which skills have upstream changes.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** A single skill's source mapping. */
+export interface SkillSource {
+  readonly path: string;
+  readonly version?: string | undefined;
+  readonly trust?: string | undefined;
+  readonly note?: string | undefined;
+}
+
+/** The origin repo metadata. */
+export interface OriginMeta {
+  readonly repo: string;
+  readonly url: string;
+  readonly branch: string;
+  readonly license: string;
+  readonly author: string;
+  readonly canonicalized: string;
+}
+
+/** The sources.json schema. */
+export interface SourcesManifest {
+  readonly origin: OriginMeta;
+  readonly skills: Record<string, SkillSource>;
+}
+
+/** Result of checking one skill against upstream. */
+export interface UpstreamCheckResult {
+  readonly skillId: string;
+  readonly originPath: string;
+  readonly status: 'up-to-date' | 'changed' | 'fetch-error' | 'local-missing';
+  readonly localLines?: number | undefined;
+  readonly upstreamLines?: number | undefined;
+  readonly error?: string | undefined;
+}
+
+/** Result of a full upstream sync check. */
+export interface SyncUpstreamReport {
+  readonly origin: OriginMeta;
+  readonly checked: number;
+  readonly changed: number;
+  readonly upToDate: number;
+  readonly errors: number;
+  readonly skills: readonly UpstreamCheckResult[];
+}
+
+/** Load sources.json from a skills package directory. */
+export function loadSourcesManifest(packageDir: string): SourcesManifest | undefined {
+  const sourcesPath = join(packageDir, 'sources.json');
+  if (!existsSync(sourcesPath)) return undefined;
+  const raw = readFileSync(sourcesPath, 'utf-8');
+  return JSON.parse(raw) as SourcesManifest;
+}
+
+/** Build the raw GitHub URL for a skill's SKILL.md. */
+function rawUrl(origin: OriginMeta, skillPath: string): string {
+  return `https://raw.githubusercontent.com/${origin.repo}/${origin.branch}/${skillPath}`;
+}
+
+/** Fetch text content from a URL with timeout. */
+async function fetchText(url: string, timeoutMs: number = 10000): Promise<{ ok: boolean; text: string; error?: string }> {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => { controller.abort(); }, timeoutMs);
+    const response = await fetch(url, { signal: controller.signal });
+    clearTimeout(timer);
+    if (!response.ok) {
+      return { ok: false, text: '', error: `HTTP ${response.status}` };
+    }
+    const text = await response.text();
+    return { ok: true, text };
+  } catch (err) {
+    return { ok: false, text: '', error: err instanceof Error ? err.message : String(err) };
+  }
+}
+
+/** Count non-empty lines in text. */
+function lineCount(text: string): number {
+  return text.split('\n').length;
+}
+
+/**
+ * Check all skills in a sources.json manifest against their upstream.
+ * Compares line counts as a quick diff indicator (full diff would be too verbose).
+ */
+export async function checkUpstream(packageDir: string): Promise<SyncUpstreamReport | undefined> {
+  const manifest = loadSourcesManifest(packageDir);
+  if (!manifest) return undefined;
+
+  const results: UpstreamCheckResult[] = [];
+
+  for (const [skillId, source] of Object.entries(manifest.skills)) {
+    const localSkillMd = join(packageDir, skillId, 'SKILL.md');
+
+    if (!existsSync(localSkillMd)) {
+      results.push({ skillId, originPath: source.path, status: 'local-missing' });
+      continue;
+    }
+
+    const localText = readFileSync(localSkillMd, 'utf-8');
+    const url = rawUrl(manifest.origin, source.path);
+    const upstream = await fetchText(url);
+
+    if (!upstream.ok) {
+      results.push({
+        skillId,
+        originPath: source.path,
+        status: 'fetch-error',
+        error: upstream.error,
+      });
+      continue;
+    }
+
+    const localLines = lineCount(localText);
+    const upstreamLines = lineCount(upstream.text);
+    const changed = localLines !== upstreamLines;
+
+    results.push({
+      skillId,
+      originPath: source.path,
+      status: changed ? 'changed' : 'up-to-date',
+      localLines,
+      upstreamLines,
+    });
+  }
+
+  return {
+    origin: manifest.origin,
+    checked: results.length,
+    changed: results.filter((r) => r.status === 'changed').length,
+    upToDate: results.filter((r) => r.status === 'up-to-date').length,
+    errors: results.filter((r) => r.status === 'fetch-error' || r.status === 'local-missing').length,
+    skills: results,
+  };
+}

package/src/targets.ts

@@ -8,6 +8,7 @@ import { claudeAdapter } from '@dzhechkov/adapter-claude';
 import { codexAdapter } from '@dzhechkov/adapter-codex';
 import { hermesAdapter } from '@dzhechkov/adapter-hermes';
 import { opencodeAdapter } from '@dzhechkov/adapter-opencode';
+import { openclaudeAdapter } from '@dzhechkov/adapter-openclaude';
 import type { Adapter } from '@dzhechkov/core';
 
 /**
@@ -19,6 +20,7 @@ export const TARGETS = {
   codex: codexAdapter,
   opencode: opencodeAdapter,
   hermes: hermesAdapter,
+  openclaude: openclaudeAdapter,
 } as const satisfies Record<string, Adapter>;
 
 /** A valid `--target` name. */