@dzhechkov/harness-core 0.2.0 → 0.3.0

package/dist/create-skill.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Skill scaffolder — creates a complete SKILL.md directory structure.
+ *
+ * Generates: SKILL.md (agentskills.io frontmatter), schemas/output.json,
+ * scripts/validate-config.json. Optionally: evals/, references/.
+ *
+ * @packageDocumentation
+ */
+/** Options for skill creation. */
+export interface CreateSkillOptions {
+    /** Skill id (kebab-case directory name). */
+    readonly name: string;
+    /** One-line description for SKILL.md frontmatter. */
+    readonly description: string;
+    /** Parent directory where skill dir will be created. Default: `.claude/skills`. */
+    readonly skillsDir?: string | undefined;
+    /** Include evals/ directory with template. */
+    readonly withEvals?: boolean | undefined;
+    /** Include references/ directory. */
+    readonly withReferences?: boolean | undefined;
+    /** Trust tier (1-3). Default: 1. */
+    readonly trustTier?: number | undefined;
+}
+/** Result of skill creation. */
+export interface CreateSkillResult {
+    readonly skillDir: string;
+    readonly filesCreated: readonly string[];
+    readonly alreadyExists: boolean;
+}
+/**
+ * Create a new skill directory with all required files.
+ *
+ * Returns the list of created files. If the skill directory already exists,
+ * returns `alreadyExists: true` and creates nothing.
+ */
+export declare function createSkill(opts: CreateSkillOptions): CreateSkillResult;
+//# sourceMappingURL=create-skill.d.ts.map

package/dist/create-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skill.d.ts","sourceRoot":"","sources":["../src/create-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,qCAAqC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9C,oCAAoC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AA4ED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAyCvE"}

package/dist/create-skill.js

@@ -0,0 +1,121 @@
+/**
+ * Skill scaffolder — creates a complete SKILL.md directory structure.
+ *
+ * Generates: SKILL.md (agentskills.io frontmatter), schemas/output.json,
+ * scripts/validate-config.json. Optionally: evals/, references/.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Generate SKILL.md content with agentskills.io frontmatter. */
+function generateSkillMd(opts) {
+    const tier = opts.trustTier ?? 1;
+    return `---
+name: "${opts.name}"
+description: "${opts.description}"
+trust_tier: ${tier}
+trust_tier_label: "${tier === 3 ? 'Verified' : tier === 2 ? 'Validated' : 'Structured'}"
+validation:
+  schema_path: schemas/output.json
+  validator_path: scripts/validate-config.json
+---
+
+# ${opts.name}
+
+${opts.description}
+
+## When to use
+
+Use when [describe the trigger conditions].
+
+## Protocol
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+## Output
+
+Structured output per \`schemas/output.json\`.
+`;
+}
+/** Generate output schema template. */
+function generateOutputSchema(name) {
+    return JSON.stringify({
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        title: `${name} output`,
+        type: 'object',
+        properties: {
+            status: { type: 'string', enum: ['success', 'failure', 'partial'] },
+            summary: { type: 'string' },
+            artifacts: { type: 'array', items: { type: 'string' } },
+        },
+        required: ['status', 'summary'],
+    }, null, 2);
+}
+/** Generate validate-config.json template. */
+function generateValidateConfig(name) {
+    return JSON.stringify({
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        title: `${name} config validation`,
+        type: 'object',
+        properties: {
+            enabled: { type: 'boolean', default: true },
+        },
+    }, null, 2);
+}
+/** Generate eval template. */
+function generateEval(name) {
+    return `# ${name} evaluation
+# Run: aqe eval ${name}
+
+test_cases:
+  - name: "basic invocation"
+    input: "Run ${name}"
+    expected:
+      status: success
+      summary_contains: "${name}"
+`;
+}
+/**
+ * Create a new skill directory with all required files.
+ *
+ * Returns the list of created files. If the skill directory already exists,
+ * returns `alreadyExists: true` and creates nothing.
+ */
+export function createSkill(opts) {
+    const skillsDir = opts.skillsDir ?? '.claude/skills';
+    const skillDir = join(skillsDir, opts.name);
+    const filesCreated = [];
+    if (existsSync(skillDir)) {
+        return { skillDir, filesCreated: [], alreadyExists: true };
+    }
+    // Create directories
+    mkdirSync(join(skillDir, 'schemas'), { recursive: true });
+    mkdirSync(join(skillDir, 'scripts'), { recursive: true });
+    // SKILL.md
+    const skillMdPath = join(skillDir, 'SKILL.md');
+    writeFileSync(skillMdPath, generateSkillMd(opts));
+    filesCreated.push('SKILL.md');
+    // schemas/output.json
+    writeFileSync(join(skillDir, 'schemas', 'output.json'), generateOutputSchema(opts.name));
+    filesCreated.push('schemas/output.json');
+    // scripts/validate-config.json
+    writeFileSync(join(skillDir, 'scripts', 'validate-config.json'), generateValidateConfig(opts.name));
+    filesCreated.push('scripts/validate-config.json');
+    // Optional: evals/
+    if (opts.withEvals !== false) {
+        mkdirSync(join(skillDir, 'evals'), { recursive: true });
+        writeFileSync(join(skillDir, 'evals', `${opts.name}.yaml`), generateEval(opts.name));
+        filesCreated.push(`evals/${opts.name}.yaml`);
+    }
+    // Optional: references/
+    if (opts.withReferences) {
+        mkdirSync(join(skillDir, 'references'), { recursive: true });
+        writeFileSync(join(skillDir, 'references', '.gitkeep'), '');
+        filesCreated.push('references/.gitkeep');
+    }
+    return { skillDir, filesCreated, alreadyExists: false };
+}
+//# sourceMappingURL=create-skill.js.map

package/dist/create-skill.js.map

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

package/dist/index.d.ts

@@ -10,4 +10,6 @@ export * from './apply.js';
 export * from './targets.js';
 export * from './operations.js';
 export * from './workflows.js';
+export { createSkill } from './create-skill.js';
+export type { CreateSkillOptions, CreateSkillResult } from './create-skill.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"}
+{"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"}

package/dist/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",

package/src/create-skill.ts

@@ -0,0 +1,157 @@
+/**
+ * Skill scaffolder — creates a complete SKILL.md directory structure.
+ *
+ * Generates: SKILL.md (agentskills.io frontmatter), schemas/output.json,
+ * scripts/validate-config.json. Optionally: evals/, references/.
+ *
+ * @packageDocumentation
+ */
+
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/** Options for skill creation. */
+export interface CreateSkillOptions {
+  /** Skill id (kebab-case directory name). */
+  readonly name: string;
+  /** One-line description for SKILL.md frontmatter. */
+  readonly description: string;
+  /** Parent directory where skill dir will be created. Default: `.claude/skills`. */
+  readonly skillsDir?: string | undefined;
+  /** Include evals/ directory with template. */
+  readonly withEvals?: boolean | undefined;
+  /** Include references/ directory. */
+  readonly withReferences?: boolean | undefined;
+  /** Trust tier (1-3). Default: 1. */
+  readonly trustTier?: number | undefined;
+}
+
+/** Result of skill creation. */
+export interface CreateSkillResult {
+  readonly skillDir: string;
+  readonly filesCreated: readonly string[];
+  readonly alreadyExists: boolean;
+}
+
+/** Generate SKILL.md content with agentskills.io frontmatter. */
+function generateSkillMd(opts: CreateSkillOptions): string {
+  const tier = opts.trustTier ?? 1;
+  return `---
+name: "${opts.name}"
+description: "${opts.description}"
+trust_tier: ${tier}
+trust_tier_label: "${tier === 3 ? 'Verified' : tier === 2 ? 'Validated' : 'Structured'}"
+validation:
+  schema_path: schemas/output.json
+  validator_path: scripts/validate-config.json
+---
+
+# ${opts.name}
+
+${opts.description}
+
+## When to use
+
+Use when [describe the trigger conditions].
+
+## Protocol
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+## Output
+
+Structured output per \`schemas/output.json\`.
+`;
+}
+
+/** Generate output schema template. */
+function generateOutputSchema(name: string): string {
+  return JSON.stringify({
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    title: `${name} output`,
+    type: 'object',
+    properties: {
+      status: { type: 'string', enum: ['success', 'failure', 'partial'] },
+      summary: { type: 'string' },
+      artifacts: { type: 'array', items: { type: 'string' } },
+    },
+    required: ['status', 'summary'],
+  }, null, 2);
+}
+
+/** Generate validate-config.json template. */
+function generateValidateConfig(name: string): string {
+  return JSON.stringify({
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    title: `${name} config validation`,
+    type: 'object',
+    properties: {
+      enabled: { type: 'boolean', default: true },
+    },
+  }, null, 2);
+}
+
+/** Generate eval template. */
+function generateEval(name: string): string {
+  return `# ${name} evaluation
+# Run: aqe eval ${name}
+
+test_cases:
+  - name: "basic invocation"
+    input: "Run ${name}"
+    expected:
+      status: success
+      summary_contains: "${name}"
+`;
+}
+
+/**
+ * Create a new skill directory with all required files.
+ *
+ * Returns the list of created files. If the skill directory already exists,
+ * returns `alreadyExists: true` and creates nothing.
+ */
+export function createSkill(opts: CreateSkillOptions): CreateSkillResult {
+  const skillsDir = opts.skillsDir ?? '.claude/skills';
+  const skillDir = join(skillsDir, opts.name);
+  const filesCreated: string[] = [];
+
+  if (existsSync(skillDir)) {
+    return { skillDir, filesCreated: [], alreadyExists: true };
+  }
+
+  // Create directories
+  mkdirSync(join(skillDir, 'schemas'), { recursive: true });
+  mkdirSync(join(skillDir, 'scripts'), { recursive: true });
+
+  // SKILL.md
+  const skillMdPath = join(skillDir, 'SKILL.md');
+  writeFileSync(skillMdPath, generateSkillMd(opts));
+  filesCreated.push('SKILL.md');
+
+  // schemas/output.json
+  writeFileSync(join(skillDir, 'schemas', 'output.json'), generateOutputSchema(opts.name));
+  filesCreated.push('schemas/output.json');
+
+  // scripts/validate-config.json
+  writeFileSync(join(skillDir, 'scripts', 'validate-config.json'), generateValidateConfig(opts.name));
+  filesCreated.push('scripts/validate-config.json');
+
+  // Optional: evals/
+  if (opts.withEvals !== false) {
+    mkdirSync(join(skillDir, 'evals'), { recursive: true });
+    writeFileSync(join(skillDir, 'evals', `${opts.name}.yaml`), generateEval(opts.name));
+    filesCreated.push(`evals/${opts.name}.yaml`);
+  }
+
+  // Optional: references/
+  if (opts.withReferences) {
+    mkdirSync(join(skillDir, 'references'), { recursive: true });
+    writeFileSync(join(skillDir, 'references', '.gitkeep'), '');
+    filesCreated.push('references/.gitkeep');
+  }
+
+  return { skillDir, filesCreated, alreadyExists: false };
+}

package/src/index.ts

@@ -12,3 +12,5 @@ export * from './apply.js';
 export * from './targets.js';
 export * from './operations.js';
 export * from './workflows.js';
+export { createSkill } from './create-skill.js';
+export type { CreateSkillOptions, CreateSkillResult } from './create-skill.js';