@dzhechkov/harness-core 0.3.34 → 0.3.36

package/dist/bundle.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Emit minimal, self-contained skill bundles for a generic external consumer
+ * (e.g. a LangGraph app that loads skills via its own `load_skill`).
+ *
+ * A bundle is the portable agentskills.io skill directory — `SKILL.md`
+ * (YAML frontmatter + instructions, verbatim) plus `references/`, `scripts/`,
+ * and `assets/` — with the dz-internal QA artifacts (`schemas/`, `evals/`,
+ * `sources.json`) stripped. No `manifest.json` is written (the consumer builds
+ * its own file-manifest on load); the skill describes instructions + resources,
+ * not graph nodes.
+ *
+ * @packageDocumentation
+ */
+/** Options for {@link bundleSkills}. */
+export interface BundleOptions {
+    /** Skill ids to bundle. */
+    readonly ids: readonly string[];
+    /** Directories to resolve the ids from (first match wins). */
+    readonly skillsDirs: readonly string[];
+    /** Root to write bundles under — each lands at `<outRoot>/skills/<id>/`. */
+    readonly outRoot: string;
+    /** Overwrite existing files. */
+    readonly force?: boolean;
+}
+/** Per-skill outcome of {@link bundleSkills}. */
+export interface BundledSkill {
+    readonly id: string;
+    readonly written: number;
+    readonly skipped: number;
+    readonly warnings: readonly string[];
+}
+/** Outcome of {@link bundleSkills}. */
+export interface BundleResult {
+    readonly bundled: BundledSkill[];
+    /** Ids not found in any `skillsDirs`. */
+    readonly missing: string[];
+}
+/**
+ * Resolve each id from `skillsDirs`, emit it as a minimal bundle under
+ * `<outRoot>/skills/<id>/`, and write it to disk. Idempotent (skips existing
+ * files unless `force`). Returns what was written + any unresolved ids.
+ */
+export declare function bundleSkills(opts: BundleOptions): BundleResult;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA6CH,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IACjC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CA6B9D"}

package/dist/bundle.js

@@ -0,0 +1,86 @@
+/**
+ * Emit minimal, self-contained skill bundles for a generic external consumer
+ * (e.g. a LangGraph app that loads skills via its own `load_skill`).
+ *
+ * A bundle is the portable agentskills.io skill directory — `SKILL.md`
+ * (YAML frontmatter + instructions, verbatim) plus `references/`, `scripts/`,
+ * and `assets/` — with the dz-internal QA artifacts (`schemas/`, `evals/`,
+ * `sources.json`) stripped. No `manifest.json` is written (the consumer builds
+ * its own file-manifest on load); the skill describes instructions + resources,
+ * not graph nodes.
+ *
+ * @packageDocumentation
+ */
+import { emitSkillTree } from '@dzhechkov/core';
+import { applyEmitResult } from './apply.js';
+import { loadSkillFromDir } from './skills.js';
+/** Files excluded from a bundle — dz-internal, not part of a portable skill. */
+function isInternalArtifact(path) {
+    return /(^|\/)(schemas|evals)\//.test(path) || path.endsWith('/sources.json') || path === 'sources.json';
+}
+/**
+ * Detect Claude-Code host coupling the consumer must adapt (advisory) — including
+ * **cross-skill references** (a composite that loads sibling skills by path). Those
+ * sibling skills are separate bundles; if they aren't bundled too, the skill won't
+ * work standalone in a generic runtime, so they're surfaced loudly.
+ */
+function hostCouplingWarnings(id, skillMd, bundledIds) {
+    const w = [];
+    // Cross-skill references: `.claude/skills/<sub>/...` or `/mnt/skills/{user,public}/<sub>/...`.
+    // These are the load-bearing dependency for composites (e.g. analyst-manual-full → explore,
+    // goap-research-ed25519, problem-solver-enhanced). Only warn about sub-skills NOT already in
+    // this bundle set — if they're all bundled, the set is self-contained.
+    const subs = new Set();
+    for (const m of skillMd.matchAll(/(?:\.claude\/skills|\/mnt\/skills\/(?:user|public))\/([a-z0-9][a-z0-9-]*)/g)) {
+        if (m[1] !== undefined && m[1] !== id)
+            subs.add(m[1]);
+    }
+    const missing = [...subs].filter((s) => !bundledIds.has(s)).sort();
+    if (missing.length > 0) {
+        w.push(`${id}: depends on sub-skill(s) ${missing.join(', ')} NOT in this bundle — add them ` +
+            `(--select …,${missing.join(',')}) or this skill won't load them standalone`);
+    }
+    if (/\/mnt\/skills\//.test(skillMd)) {
+        w.push(`${id}: references absolute /mnt/skills/... paths — rewrite to bundle-relative paths (e.g. just the skill id) for your runtime`);
+    }
+    if (/\bview\(\)/.test(skillMd)) {
+        w.push(`${id}: uses view() (Claude-Code file-read) — inline the reference or expose a file-read tool`);
+    }
+    return w;
+}
+/**
+ * Resolve each id from `skillsDirs`, emit it as a minimal bundle under
+ * `<outRoot>/skills/<id>/`, and write it to disk. Idempotent (skips existing
+ * files unless `force`). Returns what was written + any unresolved ids.
+ */
+export function bundleSkills(opts) {
+    const found = new Set();
+    const bundledIds = new Set(opts.ids);
+    const bundled = [];
+    for (const id of opts.ids) {
+        if (found.has(id))
+            continue;
+        for (const dir of opts.skillsDirs) {
+            let skill;
+            try {
+                skill = loadSkillFromDir(dir, id);
+            }
+            catch {
+                continue; // not in this dir — try the next
+            }
+            found.add(id);
+            const emit = emitSkillTree(skill, { skillsRoot: 'skills' });
+            const files = emit.files.filter((f) => !isInternalArtifact(f.path));
+            const skillMd = files.find((f) => f.path.endsWith('/SKILL.md'))?.content;
+            const warnings = [
+                ...emit.warnings,
+                ...(typeof skillMd === 'string' ? hostCouplingWarnings(id, skillMd, bundledIds) : []),
+            ];
+            const applied = applyEmitResult({ files, warnings: [] }, { targetRoot: opts.outRoot, force: opts.force === true });
+            bundled.push({ id, written: applied.written.length, skipped: applied.skipped.length, warnings });
+            break;
+        }
+    }
+    return { bundled, missing: [...opts.ids].filter((id) => !found.has(id)) };
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

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

package/dist/index.d.ts

@@ -7,6 +7,8 @@
 export declare const HARNESS_CORE_VERSION: string;
 export * from './skills.js';
 export * from './apply.js';
+export { bundleSkills } from './bundle.js';
+export type { BundleOptions, BundleResult, BundledSkill } from './bundle.js';
 export * from './targets.js';
 export * from './operations.js';
 export * from './workflows.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -8,6 +8,7 @@ import { createRequire } from 'node:module';
 export const HARNESS_CORE_VERSION = createRequire(import.meta.url)('../package.json').version;
 export * from './skills.js';
 export * from './apply.js';
+export { bundleSkills } from './bundle.js';
 export * from './targets.js';
 export * from './operations.js';
 export * from './workflows.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAC9B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAErF,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,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,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,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE5N,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAC9B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAErF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,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,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,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,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE5N,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACnH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.3.34",
+  "version": "0.3.36",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",
@@ -30,9 +30,9 @@
     "@dzhechkov/adapter-openclaude": "^0.1.0",
     "@dzhechkov/adapter-opencode": "^0.2.0",
     "yaml": "^2.0.0",
-    "@dzhechkov/memory": "0.2.5",
+    "@dzhechkov/adapter-copilot": "0.1.1",
     "@dzhechkov/core": "0.2.4",
-    "@dzhechkov/adapter-copilot": "0.1.1"
+    "@dzhechkov/memory": "0.2.5"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/src/bundle.ts

@@ -0,0 +1,119 @@
+/**
+ * Emit minimal, self-contained skill bundles for a generic external consumer
+ * (e.g. a LangGraph app that loads skills via its own `load_skill`).
+ *
+ * A bundle is the portable agentskills.io skill directory — `SKILL.md`
+ * (YAML frontmatter + instructions, verbatim) plus `references/`, `scripts/`,
+ * and `assets/` — with the dz-internal QA artifacts (`schemas/`, `evals/`,
+ * `sources.json`) stripped. No `manifest.json` is written (the consumer builds
+ * its own file-manifest on load); the skill describes instructions + resources,
+ * not graph nodes.
+ *
+ * @packageDocumentation
+ */
+
+import { emitSkillTree } from '@dzhechkov/core';
+import { applyEmitResult } from './apply.js';
+import { loadSkillFromDir } from './skills.js';
+
+/** Files excluded from a bundle — dz-internal, not part of a portable skill. */
+function isInternalArtifact(path: string): boolean {
+  return /(^|\/)(schemas|evals)\//.test(path) || path.endsWith('/sources.json') || path === 'sources.json';
+}
+
+/**
+ * Detect Claude-Code host coupling the consumer must adapt (advisory) — including
+ * **cross-skill references** (a composite that loads sibling skills by path). Those
+ * sibling skills are separate bundles; if they aren't bundled too, the skill won't
+ * work standalone in a generic runtime, so they're surfaced loudly.
+ */
+function hostCouplingWarnings(id: string, skillMd: string, bundledIds: ReadonlySet<string>): string[] {
+  const w: string[] = [];
+
+  // Cross-skill references: `.claude/skills/<sub>/...` or `/mnt/skills/{user,public}/<sub>/...`.
+  // These are the load-bearing dependency for composites (e.g. analyst-manual-full → explore,
+  // goap-research-ed25519, problem-solver-enhanced). Only warn about sub-skills NOT already in
+  // this bundle set — if they're all bundled, the set is self-contained.
+  const subs = new Set<string>();
+  for (const m of skillMd.matchAll(/(?:\.claude\/skills|\/mnt\/skills\/(?:user|public))\/([a-z0-9][a-z0-9-]*)/g)) {
+    if (m[1] !== undefined && m[1] !== id) subs.add(m[1]);
+  }
+  const missing = [...subs].filter((s) => !bundledIds.has(s)).sort();
+  if (missing.length > 0) {
+    w.push(
+      `${id}: depends on sub-skill(s) ${missing.join(', ')} NOT in this bundle — add them ` +
+      `(--select …,${missing.join(',')}) or this skill won't load them standalone`,
+    );
+  }
+
+  if (/\/mnt\/skills\//.test(skillMd)) {
+    w.push(`${id}: references absolute /mnt/skills/... paths — rewrite to bundle-relative paths (e.g. just the skill id) for your runtime`);
+  }
+  if (/\bview\(\)/.test(skillMd)) {
+    w.push(`${id}: uses view() (Claude-Code file-read) — inline the reference or expose a file-read tool`);
+  }
+  return w;
+}
+
+/** Options for {@link bundleSkills}. */
+export interface BundleOptions {
+  /** Skill ids to bundle. */
+  readonly ids: readonly string[];
+  /** Directories to resolve the ids from (first match wins). */
+  readonly skillsDirs: readonly string[];
+  /** Root to write bundles under — each lands at `<outRoot>/skills/<id>/`. */
+  readonly outRoot: string;
+  /** Overwrite existing files. */
+  readonly force?: boolean;
+}
+
+/** Per-skill outcome of {@link bundleSkills}. */
+export interface BundledSkill {
+  readonly id: string;
+  readonly written: number;
+  readonly skipped: number;
+  readonly warnings: readonly string[];
+}
+
+/** Outcome of {@link bundleSkills}. */
+export interface BundleResult {
+  readonly bundled: BundledSkill[];
+  /** Ids not found in any `skillsDirs`. */
+  readonly missing: string[];
+}
+
+/**
+ * Resolve each id from `skillsDirs`, emit it as a minimal bundle under
+ * `<outRoot>/skills/<id>/`, and write it to disk. Idempotent (skips existing
+ * files unless `force`). Returns what was written + any unresolved ids.
+ */
+export function bundleSkills(opts: BundleOptions): BundleResult {
+  const found = new Set<string>();
+  const bundledIds = new Set(opts.ids);
+  const bundled: BundledSkill[] = [];
+
+  for (const id of opts.ids) {
+    if (found.has(id)) continue;
+    for (const dir of opts.skillsDirs) {
+      let skill;
+      try {
+        skill = loadSkillFromDir(dir, id);
+      } catch {
+        continue; // not in this dir — try the next
+      }
+      found.add(id);
+      const emit = emitSkillTree(skill, { skillsRoot: 'skills' });
+      const files = emit.files.filter((f) => !isInternalArtifact(f.path));
+      const skillMd = files.find((f) => f.path.endsWith('/SKILL.md'))?.content;
+      const warnings = [
+        ...emit.warnings,
+        ...(typeof skillMd === 'string' ? hostCouplingWarnings(id, skillMd, bundledIds) : []),
+      ];
+      const applied = applyEmitResult({ files, warnings: [] }, { targetRoot: opts.outRoot, force: opts.force === true });
+      bundled.push({ id, written: applied.written.length, skipped: applied.skipped.length, warnings });
+      break;
+    }
+  }
+
+  return { bundled, missing: [...opts.ids].filter((id) => !found.has(id)) };
+}

package/src/index.ts

@@ -12,6 +12,8 @@ export const HARNESS_CORE_VERSION: string =
 
 export * from './skills.js';
 export * from './apply.js';
+export { bundleSkills } from './bundle.js';
+export type { BundleOptions, BundleResult, BundledSkill } from './bundle.js';
 export * from './targets.js';
 export * from './operations.js';
 export * from './workflows.js';