@dzhechkov/harness-core 0.2.0

package/dist/skills.js

@@ -0,0 +1,87 @@
+/**
+ * Skill discovery + loading — the consolidated filesystem loader.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { ClaudeSkillFrontmatterSchema, parseSkillDocument } from '@dzhechkov/core';
+/** Recursively list every file under `dir`. */
+function walkFiles(dir) {
+    const out = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            out.push(...walkFiles(full));
+        else if (entry.isFile())
+            out.push(full);
+    }
+    return out;
+}
+/** Return the ids of every `<skillsDir>/<id>/SKILL.md`, sorted. */
+export function discoverSkillIds(skillsDir) {
+    if (!existsSync(skillsDir))
+        return [];
+    return readdirSync(skillsDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && existsSync(join(skillsDir, entry.name, 'SKILL.md')))
+        .map((entry) => entry.name)
+        .sort();
+}
+/** Discover every skill in `skillsDir`, returning id + description. */
+export function listSkills(skillsDir) {
+    return discoverSkillIds(skillsDir).map((id) => {
+        const document = parseSkillDocument(readFileSync(join(skillsDir, id, 'SKILL.md'), 'utf-8'));
+        const frontmatter = ClaudeSkillFrontmatterSchema.parse(parseYaml(document.frontmatterYaml));
+        return { id, description: frontmatter.description };
+    });
+}
+/** Get detailed info about a single skill without loading all assets. */
+export function getSkillInfo(skillsDir, id) {
+    const skillDir = join(skillsDir, id);
+    const skillMdPath = join(skillDir, 'SKILL.md');
+    if (!existsSync(skillMdPath))
+        return undefined;
+    const document = parseSkillDocument(readFileSync(skillMdPath, 'utf-8'));
+    const fm = parseYaml(document.frontmatterYaml);
+    const parsed = ClaudeSkillFrontmatterSchema.parse(fm);
+    const assetPaths = walkFiles(skillDir)
+        .filter((p) => p !== skillMdPath)
+        .map((p) => relative(skillDir, p).split('\\').join('/'))
+        .sort();
+    return {
+        id,
+        description: parsed.description,
+        name: parsed.name ?? id,
+        trustTier: fm['trust_tier'],
+        version: parsed.version,
+        assetCount: assetPaths.length,
+        assetPaths,
+        frontmatter: fm,
+    };
+}
+/**
+ * Load one `<skillsDir>/<id>/` directory into a {@link CanonicalSkill}: its
+ * `SKILL.md` document plus every other file as a bundled asset.
+ *
+ * @throws if the skill directory has no `SKILL.md`.
+ */
+export function loadSkillFromDir(skillsDir, id) {
+    const skillDir = join(skillsDir, id);
+    const skillMdPath = join(skillDir, 'SKILL.md');
+    if (!existsSync(skillMdPath)) {
+        throw new Error(`skill not found: ${JSON.stringify(id)} (looked in ${skillsDir})`);
+    }
+    const document = parseSkillDocument(readFileSync(skillMdPath, 'utf-8'));
+    const frontmatter = ClaudeSkillFrontmatterSchema.parse(parseYaml(document.frontmatterYaml));
+    const assets = walkFiles(skillDir)
+        .filter((path) => path !== skillMdPath)
+        .map((path) => ({
+        path: relative(skillDir, path).split('\\').join('/'),
+        encoding: 'utf-8',
+        content: readFileSync(path, 'utf-8'),
+    }))
+        .sort((a, b) => a.path.localeCompare(b.path));
+    return { id, frontmatter, document, assets };
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/targets.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `--target` names → platform adapters.
+ *
+ * @packageDocumentation
+ */
+import type { Adapter } from '@dzhechkov/core';
+/**
+ * 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.
+ */
+export declare const TARGETS: {
+    readonly 'claude-code': Adapter;
+    readonly codex: Adapter;
+    readonly opencode: Adapter;
+    readonly hermes: Adapter;
+};
+/** A valid `--target` name. */
+export type TargetName = keyof typeof TARGETS;
+/** Every supported `--target` name. */
+export declare const TARGET_NAMES: TargetName[];
+/** Type guard: is `value` a supported `--target` name? */
+export declare function isTargetName(value: string): value is TargetName;
+//# sourceMappingURL=targets.d.ts.map

package/dist/targets.d.ts.map

@@ -0,0 +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"}

package/dist/targets.js

@@ -0,0 +1,26 @@
+/**
+ * `--target` names → platform adapters.
+ *
+ * @packageDocumentation
+ */
+import { claudeAdapter } from '@dzhechkov/adapter-claude';
+import { codexAdapter } from '@dzhechkov/adapter-codex';
+import { hermesAdapter } from '@dzhechkov/adapter-hermes';
+import { opencodeAdapter } from '@dzhechkov/adapter-opencode';
+/**
+ * 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.
+ */
+export const TARGETS = {
+    'claude-code': claudeAdapter,
+    codex: codexAdapter,
+    opencode: opencodeAdapter,
+    hermes: hermesAdapter,
+};
+/** Every supported `--target` name. */
+export const TARGET_NAMES = Object.keys(TARGETS);
+/** Type guard: is `value` a supported `--target` name? */
+export function isTargetName(value) {
+    return Object.prototype.hasOwnProperty.call(TARGETS, value);
+}
+//# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -0,0 +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"}

package/dist/workflows.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Dynamic workflow templates for Opus 4.8+ orchestration.
+ *
+ * Per ADR-005: workflows live in the orchestration layer only.
+ * They generate JS scripts that Claude Code's dynamic workflow engine executes.
+ * Core schema, adapters, and skill content remain model-agnostic.
+ *
+ * @packageDocumentation
+ */
+/** A workflow template — generates a JS orchestration script from parameters. */
+export interface WorkflowTemplate {
+    readonly name: string;
+    readonly description: string;
+    readonly generate: (options: WorkflowOptions) => string;
+}
+/** Options passed to workflow generation. */
+export interface WorkflowOptions {
+    readonly projectRoot: string;
+    readonly dryRun?: boolean;
+    readonly packages?: readonly string[];
+}
+/** All registered workflow templates. */
+export declare const WORKFLOWS: Record<string, WorkflowTemplate>;
+/** Valid workflow names. */
+export declare const WORKFLOW_NAMES: string[];
+/** Look up a workflow by name. */
+export declare function getWorkflow(name: string): WorkflowTemplate | undefined;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAC;CACzD;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAsFD,yCAAyC;AACzC,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAKtD,CAAC;AAEF,4BAA4B;AAC5B,eAAO,MAAM,cAAc,UAAyB,CAAC;AAErD,kCAAkC;AAClC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEtE"}

package/dist/workflows.js

@@ -0,0 +1,103 @@
+/**
+ * Dynamic workflow templates for Opus 4.8+ orchestration.
+ *
+ * Per ADR-005: workflows live in the orchestration layer only.
+ * They generate JS scripts that Claude Code's dynamic workflow engine executes.
+ * Core schema, adapters, and skill content remain model-agnostic.
+ *
+ * @packageDocumentation
+ */
+const coverageLift = {
+    name: 'coverage-lift',
+    description: 'Lift Tier-A package coverage to ≥95% using parallel agents per package.',
+    generate: (opts) => `
+// Dynamic Workflow: Coverage Lift
+// Generated for: ${opts.projectRoot}
+// Per ADR-005: orchestration only — no adapter/core changes
+
+const tierA = ${JSON.stringify(opts.packages ?? [
+        'core', 'memory', 'harness-core', 'harness-cli',
+        'harness-presets', 'mcp-server-tools',
+        'adapter-claude', 'adapter-codex', 'adapter-opencode', 'adapter-hermes',
+        'skills-qe',
+    ])};
+
+const tasks = tierA.map(pkg => ({
+  name: \`coverage-\${pkg}\`,
+  description: \`Lift @dzhechkov/\${pkg} to ≥95% line coverage. Run: pnpm --filter @dzhechkov/\${pkg} test -- --coverage. Add tests for uncovered lines.\`,
+}));
+
+// Claude Code dynamic workflow engine will:
+// 1. Spawn one agent per task (up to 16 concurrent)
+// 2. Each agent reads coverage, writes tests, re-runs coverage
+// 3. Results aggregated when all agents complete
+export default { tasks, maxConcurrency: 4${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+const mutationKill = {
+    name: 'mutation-kill',
+    description: 'Kill surviving mutants across core packages using parallel Stryker runs.',
+    generate: (opts) => `
+// Dynamic Workflow: Mutation Kill
+// Generated for: ${opts.projectRoot}
+
+const packages = ${JSON.stringify(opts.packages ?? ['core', 'memory', 'harness-core'])};
+
+const tasks = packages.map(pkg => ({
+  name: \`mutate-\${pkg}\`,
+  description: \`Run Stryker on @dzhechkov/\${pkg}, analyze survivors, write tests to kill them. Target: ≥80% mutation score.\`,
+}));
+
+export default { tasks, maxConcurrency: 3${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+const canonicalize = {
+    name: 'canonicalize',
+    description: 'Canonicalize packages from vendored directories into @dzhechkov/* namespace.',
+    generate: (opts) => `
+// Dynamic Workflow: Canonicalize
+// Generated for: ${opts.projectRoot}
+
+const tasks = [
+  { name: 'discover', description: 'Scan vendored directories for un-canonicalized packages.' },
+  { name: 'copy', description: 'Copy discovered packages to packages/@dzhechkov/. Exclude node_modules, .git, runtime state.' },
+  { name: 'metadata', description: 'Add publishConfig, repository, homepage to each package.json.' },
+  { name: 'verify', description: 'Run byte-level diff between source and canonical. 0 missing, 0 changed.' },
+  { name: 'test', description: 'Run canonical-packages structural tests. All must pass.' },
+];
+
+export default { tasks, maxConcurrency: 2${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+const securityAudit = {
+    name: 'security-audit',
+    description: 'Run adversarial security audit with parallel boundary scanning.',
+    generate: (opts) => `
+// Dynamic Workflow: Security Audit
+// Generated for: ${opts.projectRoot}
+
+const tasks = [
+  { name: 'npm-audit', description: 'Run pnpm audit, capture baseline.' },
+  { name: 'gitleaks', description: 'Run gitleaks detect, document findings.' },
+  { name: 'boundaries', description: 'Verify all 8 input boundaries have runtime guards.' },
+  { name: 'payloads', description: 'Test aidefence payloads against boundaries.' },
+  { name: 'report', description: 'Generate security-audit.md with 6 H2 sections.' },
+];
+
+export default { tasks, maxConcurrency: 3${opts.dryRun ? ', dryRun: true' : ''} };
+`.trim(),
+};
+/** All registered workflow templates. */
+export const WORKFLOWS = {
+    'coverage-lift': coverageLift,
+    'mutation-kill': mutationKill,
+    'canonicalize': canonicalize,
+    'security-audit': securityAudit,
+};
+/** Valid workflow names. */
+export const WORKFLOW_NAMES = Object.keys(WORKFLOWS);
+/** Look up a workflow by name. */
+export function getWorkflow(name) {
+    return WORKFLOWS[name];
+}
+//# sourceMappingURL=workflows.js.map

package/dist/workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.js","sourceRoot":"","sources":["../src/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,YAAY,GAAqB;IACrC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,yEAAyE;IACtF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;;oBAEF,IAAI,CAAC,WAAW;;;gBAGpB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI;QAC5C,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa;QAC/C,iBAAiB,EAAE,kBAAkB;QACrC,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB;QACvE,WAAW;KACZ,CAAC;;;;;;;;;;;2CAWuC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE;CAC7E,CAAC,IAAI,EAAE;CACP,CAAC;AAEF,MAAM,YAAY,GAAqB;IACrC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,0EAA0E;IACvF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;;oBAEF,IAAI,CAAC,WAAW;;mBAEjB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;;;;;;;2CAO3C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE;CAC7E,CAAC,IAAI,EAAE;CACP,CAAC;AAEF,MAAM,YAAY,GAAqB;IACrC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,8EAA8E;IAC3F,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;;oBAEF,IAAI,CAAC,WAAW;;;;;;;;;;2CAUO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE;CAC7E,CAAC,IAAI,EAAE;CACP,CAAC;AAEF,MAAM,aAAa,GAAqB;IACtC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,iEAAiE;IAC9E,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;;oBAEF,IAAI,CAAC,WAAW;;;;;;;;;;2CAUO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE;CAC7E,CAAC,IAAI,EAAE;CACP,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAqC;IACzD,eAAe,EAAE,YAAY;IAC7B,eAAe,EAAE,YAAY;IAC7B,cAAc,EAAE,YAAY;IAC5B,gBAAgB,EAAE,aAAa;CAChC,CAAC;AAEF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAErD,kCAAkC;AAClC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@dzhechkov/harness-core",
+  "version": "0.2.0",
+  "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
+  "type": "module",
+  "license": "MIT",
+  "author": "dzhechko",
+  "keywords": [
+    "agent-skills",
+    "harness",
+    "claude-code"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "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/core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/djd1m/dz-harness-hub.git",
+    "directory": "packages/@dzhechkov/harness-core"
+  },
+  "homepage": "https://github.com/djd1m/dz-harness-hub/tree/main/packages/@dzhechkov/harness-core#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/apply.ts

@@ -0,0 +1,57 @@
+/**
+ * The additive disk writer — the only part of the harness that writes files.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+
+import type { EmitResult } from '@dzhechkov/core';
+
+/** Options for {@link applyEmitResult}. */
+export interface ApplyOptions {
+  /** Root directory the emit's relative paths are written under. */
+  readonly targetRoot: string;
+  /** Overwrite files that already exist. Default `false` — purely additive. */
+  readonly force?: boolean;
+}
+
+/** The outcome of {@link applyEmitResult}. */
+export interface ApplyReport {
+  /** Files written (created, or overwritten under `force`). */
+  readonly written: string[];
+  /** Files left untouched because they already existed and `force` was off. */
+  readonly skipped: string[];
+}
+
+/**
+ * Write an adapter {@link EmitResult} to disk under `targetRoot`.
+ *
+ * **Additive (ADR-001):** creates files and parent directories, never deletes,
+ * and never overwrites an existing file unless `force` is `true`. A file that
+ * already exists (without `force`) is reported in `skipped`, not `written`.
+ *
+ * @throws if an emit path is absolute or contains a `..` segment.
+ */
+export function applyEmitResult(emit: EmitResult, options: ApplyOptions): ApplyReport {
+  const written: string[] = [];
+  const skipped: string[] = [];
+
+  for (const file of emit.files) {
+    if (file.path.startsWith('/') || file.path.split('/').includes('..')) {
+      throw new Error(`apply: refusing unsafe emit path ${JSON.stringify(file.path)}`);
+    }
+    const absolutePath = join(options.targetRoot, file.path);
+    if (existsSync(absolutePath) && options.force !== true) {
+      skipped.push(file.path);
+      continue;
+    }
+    mkdirSync(dirname(absolutePath), { recursive: true });
+    const data = file.encoding === 'base64' ? Buffer.from(file.content, 'base64') : file.content;
+    writeFileSync(absolutePath, data);
+    written.push(file.path);
+  }
+
+  return { written, skipped };
+}

package/src/index.ts

@@ -0,0 +1,14 @@
+/**
+ * `@dzhechkov/harness-core` — shared harness logic behind `@dzhechkov/harness-cli`.
+ *
+ * @packageDocumentation
+ */
+
+/** Package version. Kept in sync with `package.json`. */
+export const HARNESS_CORE_VERSION = '0.1.0';
+
+export * from './skills.js';
+export * from './apply.js';
+export * from './targets.js';
+export * from './operations.js';
+export * from './workflows.js';