@dzhechkov/harness-core 0.3.4 → 0.3.5

package/dist/index.d.ts

@@ -15,5 +15,7 @@ export type { CreateSkillOptions, CreateSkillResult } from './create-skill.js';
 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 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,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,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

@@ -13,4 +13,5 @@ export * from './workflows.js';
 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';
 //# 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"}
+{"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"}

package/dist/registry.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skill registry — indexes all skills across skill packs for search and discovery.
+ *
+ * Scans `packages/@dzhechkov/skills-*` directories, reads SKILL.md frontmatter,
+ * and builds a searchable index.
+ *
+ * @packageDocumentation
+ */
+/** A single skill in the registry. */
+export interface RegistryEntry {
+    readonly id: string;
+    readonly pack: string;
+    readonly description: string;
+    readonly trustTier: number;
+    readonly hasSchema: boolean;
+    readonly hasEvals: boolean;
+    readonly lineCount: number;
+    readonly category: string;
+}
+/** The full registry. */
+export interface Registry {
+    readonly entries: readonly RegistryEntry[];
+    readonly totalSkills: number;
+    readonly totalPacks: number;
+    readonly categories: readonly string[];
+}
+/** Build registry from all skills-* packages. */
+export declare function buildRegistry(monorepoRoot: string): Registry;
+/** Search registry by query (matches id and description, case-insensitive). */
+export declare function searchRegistry(registry: Registry, query: string): readonly RegistryEntry[];
+/** Filter registry by category. */
+export declare function filterByCategory(registry: Registry, category: string): readonly RegistryEntry[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAwBD,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAwC5D;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAK1F;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAE/F"}

package/dist/registry.js

@@ -0,0 +1,84 @@
+/**
+ * Skill registry — indexes all skills across skill packs for search and discovery.
+ *
+ * Scans `packages/@dzhechkov/skills-*` directories, reads SKILL.md frontmatter,
+ * and builds a searchable index.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Extract description from SKILL.md frontmatter. */
+function extractFrontmatter(content) {
+    const descMatch = /^description:\s*"?(.+?)"?\s*$/m.exec(content);
+    const tierMatch = /^trust_tier:\s*(\d)/m.exec(content);
+    return {
+        description: descMatch?.[1] ?? '',
+        trustTier: tierMatch ? parseInt(tierMatch[1] ?? '1', 10) : 1,
+    };
+}
+/** Infer category from pack name. */
+function categoryFromPack(pack) {
+    if (pack.includes('devops'))
+        return 'devops';
+    if (pack.includes('web3'))
+        return 'web3';
+    if (pack.includes('mcp'))
+        return 'mcp';
+    if (pack.includes('qe'))
+        return 'qe';
+    if (pack.includes('meta'))
+        return 'meta';
+    if (pack.includes('bto'))
+        return 'bto';
+    if (pack.includes('health'))
+        return 'health';
+    return 'other';
+}
+/** Build registry from all skills-* packages. */
+export function buildRegistry(monorepoRoot) {
+    const baseDir = join(monorepoRoot, 'packages', '@dzhechkov');
+    if (!existsSync(baseDir))
+        return { entries: [], totalSkills: 0, totalPacks: 0, categories: [] };
+    const entries = [];
+    const packs = readdirSync(baseDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && e.name.startsWith('skills-'));
+    for (const pack of packs) {
+        const packDir = join(baseDir, pack.name);
+        const skillDirs = readdirSync(packDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory() && existsSync(join(packDir, e.name, 'SKILL.md')));
+        for (const skill of skillDirs) {
+            const skillMdPath = join(packDir, skill.name, 'SKILL.md');
+            const content = readFileSync(skillMdPath, 'utf-8');
+            const { description, trustTier } = extractFrontmatter(content);
+            entries.push({
+                id: skill.name,
+                pack: pack.name,
+                description,
+                trustTier,
+                hasSchema: existsSync(join(packDir, skill.name, 'schemas', 'output.json')),
+                hasEvals: existsSync(join(packDir, skill.name, 'evals')),
+                lineCount: content.split('\n').length,
+                category: categoryFromPack(pack.name),
+            });
+        }
+    }
+    entries.sort((a, b) => a.id.localeCompare(b.id));
+    const categories = [...new Set(entries.map((e) => e.category))].sort();
+    return {
+        entries,
+        totalSkills: entries.length,
+        totalPacks: packs.length,
+        categories,
+    };
+}
+/** Search registry by query (matches id and description, case-insensitive). */
+export function searchRegistry(registry, query) {
+    const q = query.toLowerCase();
+    return registry.entries.filter((e) => e.id.toLowerCase().includes(q) || e.description.toLowerCase().includes(q) || e.category.includes(q));
+}
+/** Filter registry by category. */
+export function filterByCategory(registry, category) {
+    return registry.entries.filter((e) => e.category === category);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/package.json

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

package/src/index.ts

@@ -17,4 +17,6 @@ export type { CreateSkillOptions, CreateSkillResult } from './create-skill.js';
 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 type { RegistryEntry, Registry } from './registry.js';
 export type { BenchmarkCheck, BenchmarkScore, BenchmarkReport, CompareResult } from './benchmark.js';

package/src/registry.ts

@@ -0,0 +1,109 @@
+/**
+ * Skill registry — indexes all skills across skill packs for search and discovery.
+ *
+ * Scans `packages/@dzhechkov/skills-*` directories, reads SKILL.md frontmatter,
+ * and builds a searchable index.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** A single skill in the registry. */
+export interface RegistryEntry {
+  readonly id: string;
+  readonly pack: string;
+  readonly description: string;
+  readonly trustTier: number;
+  readonly hasSchema: boolean;
+  readonly hasEvals: boolean;
+  readonly lineCount: number;
+  readonly category: string;
+}
+
+/** The full registry. */
+export interface Registry {
+  readonly entries: readonly RegistryEntry[];
+  readonly totalSkills: number;
+  readonly totalPacks: number;
+  readonly categories: readonly string[];
+}
+
+/** Extract description from SKILL.md frontmatter. */
+function extractFrontmatter(content: string): { description: string; trustTier: number } {
+  const descMatch = /^description:\s*"?(.+?)"?\s*$/m.exec(content);
+  const tierMatch = /^trust_tier:\s*(\d)/m.exec(content);
+  return {
+    description: descMatch?.[1] ?? '',
+    trustTier: tierMatch ? parseInt(tierMatch[1] ?? '1', 10) : 1,
+  };
+}
+
+/** Infer category from pack name. */
+function categoryFromPack(pack: string): string {
+  if (pack.includes('devops')) return 'devops';
+  if (pack.includes('web3')) return 'web3';
+  if (pack.includes('mcp')) return 'mcp';
+  if (pack.includes('qe')) return 'qe';
+  if (pack.includes('meta')) return 'meta';
+  if (pack.includes('bto')) return 'bto';
+  if (pack.includes('health')) return 'health';
+  return 'other';
+}
+
+/** Build registry from all skills-* packages. */
+export function buildRegistry(monorepoRoot: string): Registry {
+  const baseDir = join(monorepoRoot, 'packages', '@dzhechkov');
+  if (!existsSync(baseDir)) return { entries: [], totalSkills: 0, totalPacks: 0, categories: [] };
+
+  const entries: RegistryEntry[] = [];
+  const packs = readdirSync(baseDir, { withFileTypes: true })
+    .filter((e) => e.isDirectory() && e.name.startsWith('skills-'));
+
+  for (const pack of packs) {
+    const packDir = join(baseDir, pack.name);
+    const skillDirs = readdirSync(packDir, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && existsSync(join(packDir, e.name, 'SKILL.md')));
+
+    for (const skill of skillDirs) {
+      const skillMdPath = join(packDir, skill.name, 'SKILL.md');
+      const content = readFileSync(skillMdPath, 'utf-8');
+      const { description, trustTier } = extractFrontmatter(content);
+
+      entries.push({
+        id: skill.name,
+        pack: pack.name,
+        description,
+        trustTier,
+        hasSchema: existsSync(join(packDir, skill.name, 'schemas', 'output.json')),
+        hasEvals: existsSync(join(packDir, skill.name, 'evals')),
+        lineCount: content.split('\n').length,
+        category: categoryFromPack(pack.name),
+      });
+    }
+  }
+
+  entries.sort((a, b) => a.id.localeCompare(b.id));
+  const categories = [...new Set(entries.map((e) => e.category))].sort();
+
+  return {
+    entries,
+    totalSkills: entries.length,
+    totalPacks: packs.length,
+    categories,
+  };
+}
+
+/** Search registry by query (matches id and description, case-insensitive). */
+export function searchRegistry(registry: Registry, query: string): readonly RegistryEntry[] {
+  const q = query.toLowerCase();
+  return registry.entries.filter(
+    (e) => e.id.toLowerCase().includes(q) || e.description.toLowerCase().includes(q) || e.category.includes(q),
+  );
+}
+
+/** Filter registry by category. */
+export function filterByCategory(registry: Registry, category: string): readonly RegistryEntry[] {
+  return registry.entries.filter((e) => e.category === category);
+}