@dzhechkov/harness-core 0.2.0

package/README.md

@@ -0,0 +1,24 @@
+# @dzhechkov/harness-core
+
+Shared logic for the DZ harness — the engine behind `@dzhechkov/harness-cli`
+and any other consumer.
+
+## What it provides
+
+| Module | Exports | Purpose |
+|---|---|---|
+| `skills` | `loadSkillFromDir`, `listSkills`, `discoverSkillIds` | Read skill directories into `CanonicalSkill` objects |
+| `apply` | `applyEmitResult` | Write an adapter `EmitResult` to disk — **additively** |
+| `targets` | `TARGETS`, `TargetName`, `isTargetName` | `--target` name → platform adapter |
+| `operations` | `runInit`, `runSync`, `runVerify`, `runDoctor` | The harness operations, returning structured reports |
+
+## The additive guarantee
+
+`applyEmitResult` is the only part of the harness that writes to disk. It is
+**additive** (ADR-001): it creates new files and directories, it never deletes,
+and it never overwrites an existing file unless `force: true` is passed
+explicitly. Operations that would overwrite are reported as `skipped`.
+
+## Status
+
+`0.1.0` — alpha, part of the `extended-a-migration` feature (Phase 6).

package/dist/apply.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The additive disk writer — the only part of the harness that writes files.
+ *
+ * @packageDocumentation
+ */
+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 declare function applyEmitResult(emit: EmitResult, options: ApplyOptions): ApplyReport;
+//# sourceMappingURL=apply.d.ts.map

package/dist/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,CAoBpF"}

package/dist/apply.js

@@ -0,0 +1,36 @@
+/**
+ * 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';
+/**
+ * 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, options) {
+    const written = [];
+    const skipped = [];
+    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 };
+}
+//# sourceMappingURL=apply.js.map

package/dist/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../src/apply.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAoB1C;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB,EAAE,OAAqB;IACrE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7F,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `@dzhechkov/harness-core` — shared harness logic behind `@dzhechkov/harness-cli`.
+ *
+ * @packageDocumentation
+ */
+/** Package version. Kept in sync with `package.json`. */
+export declare 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * `@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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/operations.d.ts

@@ -0,0 +1,126 @@
+/**
+ * The harness operations — `init`, `sync`, `verify`, `doctor` — as pure-ish
+ * functions returning structured reports. `@dzhechkov/harness-cli` is a thin
+ * argv shell over these.
+ *
+ * @packageDocumentation
+ */
+import type { TargetName } from './targets.js';
+/** Options for {@link runInit}. */
+export interface InitOptions {
+    readonly target: TargetName;
+    /** Source directory of canonical skills. */
+    readonly skillsDir: string;
+    /** Project root the platform tree is written under. */
+    readonly projectRoot: string;
+    /** Overwrite existing files. Default `false` — additive. */
+    readonly force?: boolean;
+    /** When set, install only these skill ids (a preset selection). */
+    readonly select?: readonly string[];
+}
+/** Per-skill outcome of {@link runInit}. */
+export interface InitSkillResult {
+    readonly id: string;
+    readonly written: string[];
+    readonly skipped: string[];
+    readonly warnings: string[];
+}
+/** The outcome of {@link runInit}. */
+export interface InitReport {
+    readonly target: TargetName;
+    readonly skillsDir: string;
+    readonly projectRoot: string;
+    readonly skills: InitSkillResult[];
+}
+/** Compile every skill in `skillsDir` for `target` and apply it under `projectRoot`. */
+export declare function runInit(options: InitOptions): Promise<InitReport>;
+/** Options for {@link runVerify}. */
+export interface VerifyOptions {
+    readonly skillsDir: string;
+    /** Target to verify against. Default `claude-code`. */
+    readonly target?: TargetName;
+}
+/** Per-skill outcome of {@link runVerify}. */
+export interface VerifySkillResult {
+    readonly id: string;
+    readonly ok: boolean;
+    readonly errors: string[];
+    readonly warnings: string[];
+}
+/** The outcome of {@link runVerify}. */
+export interface VerifyReport {
+    readonly target: TargetName;
+    readonly skillsDir: string;
+    readonly total: number;
+    readonly valid: number;
+    readonly skills: VerifySkillResult[];
+}
+/** Compile every skill for `target` and report whether each verifies. */
+export declare function runVerify(options: VerifyOptions): Promise<VerifyReport>;
+/** Options for {@link runSync}. */
+export interface SyncOptions {
+    /** Canonical skill pack directory (single source). */
+    readonly canonicalDir?: string;
+    /** Multiple canonical pack directories (multi-source). Takes precedence over canonicalDir. */
+    readonly canonicalDirs?: readonly string[];
+    /** Project root containing the legacy `.claude/skills` tree. */
+    readonly projectRoot: string;
+    /** Report only, write nothing. */
+    readonly dryRun?: boolean;
+    /** Overwrite drifted legacy files. Default `false`. */
+    readonly force?: boolean;
+}
+/** Per-skill outcome of {@link runSync}. */
+export interface SyncSkillResult {
+    readonly id: string;
+    readonly status: 'in-sync' | 'missing' | 'drift';
+    readonly written: string[];
+}
+/** The outcome of {@link runSync}. */
+export interface SyncReport {
+    readonly dryRun: boolean;
+    readonly skills: SyncSkillResult[];
+    readonly summary: {
+        total: number;
+        inSync: number;
+        missing: number;
+        drift: number;
+    };
+}
+/** Compare each canonical skill (compiled for Claude Code) to the legacy tree. */
+export declare function runSync(options: SyncOptions): Promise<SyncReport>;
+/** A detected legacy CLI installation. */
+export interface MigrateDetection {
+    readonly manifest: string;
+    readonly version: string;
+    readonly components: string[];
+    readonly fileCount: number;
+}
+/** The outcome of {@link runMigrate}. */
+export interface MigrateReport {
+    readonly projectRoot: string;
+    readonly detections: MigrateDetection[];
+    readonly skillsFound: number;
+    readonly recommendation: string;
+}
+/** Detect keysarium/bto/etc installations and report migration path. */
+export declare function runMigrate(options: {
+    projectRoot: string;
+}): MigrateReport;
+/** A single {@link runDoctor} check. */
+export interface DoctorCheck {
+    readonly name: string;
+    readonly ok: boolean;
+    readonly detail: string;
+}
+/** The outcome of {@link runDoctor}. */
+export interface DoctorReport {
+    readonly node: string;
+    readonly checks: DoctorCheck[];
+    readonly ok: boolean;
+}
+/** Report environment diagnostics for the harness. */
+export declare function runDoctor(options: {
+    projectRoot: string;
+}): Promise<DoctorReport>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

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

package/dist/operations.js

@@ -0,0 +1,247 @@
+/**
+ * The harness operations — `init`, `sync`, `verify`, `doctor` — as pure-ish
+ * functions returning structured reports. `@dzhechkov/harness-cli` is a thin
+ * argv shell over these.
+ *
+ * @packageDocumentation
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { claudeAdapter } from '@dzhechkov/adapter-claude';
+import { applyEmitResult } from './apply.js';
+import { discoverSkillIds, loadSkillFromDir } from './skills.js';
+import { TARGETS } from './targets.js';
+/** Compile every skill in `skillsDir` for `target` and apply it under `projectRoot`. */
+export async function runInit(options) {
+    const adapter = TARGETS[options.target];
+    const skills = [];
+    const selection = options.select;
+    const ids = discoverSkillIds(options.skillsDir).filter((id) => selection === undefined || selection.includes(id));
+    for (const id of ids) {
+        const skill = loadSkillFromDir(options.skillsDir, id);
+        const emit = await adapter.compile(skill, { targetRoot: options.projectRoot });
+        const applied = applyEmitResult(emit, {
+            targetRoot: options.projectRoot,
+            force: options.force === true,
+        });
+        skills.push({ id, written: applied.written, skipped: applied.skipped, warnings: [...emit.warnings] });
+    }
+    return { target: options.target, skillsDir: options.skillsDir, projectRoot: options.projectRoot, skills };
+}
+/** Compile every skill for `target` and report whether each verifies. */
+export async function runVerify(options) {
+    const target = options.target ?? 'claude-code';
+    const adapter = TARGETS[target];
+    const skills = [];
+    for (const id of discoverSkillIds(options.skillsDir)) {
+        try {
+            const skill = loadSkillFromDir(options.skillsDir, id);
+            const emit = await adapter.compile(skill, { targetRoot: '.' });
+            const result = await adapter.verify(emit);
+            skills.push({ id, ok: result.ok, errors: [...result.errors], warnings: [...result.warnings] });
+        }
+        catch (error) {
+            skills.push({
+                id,
+                ok: false,
+                errors: [error instanceof Error ? error.message : String(error)],
+                warnings: [],
+            });
+        }
+    }
+    return {
+        target,
+        skillsDir: options.skillsDir,
+        total: skills.length,
+        valid: skills.filter((skill) => skill.ok).length,
+        skills,
+    };
+}
+/** Compare each canonical skill (compiled for Claude Code) to the legacy tree. */
+export async function runSync(options) {
+    const dirs = options.canonicalDirs ?? (options.canonicalDir ? [options.canonicalDir] : []);
+    const skills = [];
+    for (const canonicalDir of dirs) {
+        for (const id of discoverSkillIds(canonicalDir)) {
+            const skill = loadSkillFromDir(canonicalDir, id);
+            const emit = await claudeAdapter.compile(skill, { targetRoot: options.projectRoot });
+            let differ = false;
+            let missing = false;
+            for (const file of emit.files) {
+                const absolutePath = join(options.projectRoot, file.path);
+                if (!existsSync(absolutePath))
+                    missing = true;
+                else if (readFileSync(absolutePath, 'utf-8') !== file.content)
+                    differ = true;
+            }
+            const status = differ ? 'drift' : missing ? 'missing' : 'in-sync';
+            let written = [];
+            const shouldWrite = status === 'missing' || (status === 'drift' && options.force === true);
+            if (options.dryRun !== true && shouldWrite) {
+                written = applyEmitResult(emit, {
+                    targetRoot: options.projectRoot,
+                    force: status === 'drift',
+                }).written;
+            }
+            skills.push({ id, status, written });
+        }
+    }
+    return {
+        dryRun: options.dryRun === true,
+        skills,
+        summary: {
+            total: skills.length,
+            inSync: skills.filter((skill) => skill.status === 'in-sync').length,
+            missing: skills.filter((skill) => skill.status === 'missing').length,
+            drift: skills.filter((skill) => skill.status === 'drift').length,
+        },
+    };
+}
+/** Detect keysarium/bto/etc installations and report migration path. */
+export function runMigrate(options) {
+    const root = options.projectRoot;
+    const detections = [];
+    // Check for known manifests
+    const manifests = ['.keysarium.json', '.bto.json', '.analyst-manual.json', '.edu-site.json', '.transcript-site.json', '.feature-adr.json'];
+    for (const manifest of manifests) {
+        const path = join(root, manifest);
+        if (existsSync(path)) {
+            try {
+                const data = JSON.parse(readFileSync(path, 'utf-8'));
+                detections.push({
+                    manifest,
+                    version: data.version ?? 'unknown',
+                    components: data.components ?? [],
+                    fileCount: Array.isArray(data.files) ? data.files.length : 0,
+                });
+            }
+            catch {
+                detections.push({ manifest, version: 'parse-error', components: [], fileCount: 0 });
+            }
+        }
+    }
+    // Count skills in .claude/skills
+    const skillsDir = join(root, '.claude', 'skills');
+    let skillsFound = 0;
+    if (existsSync(skillsDir)) {
+        skillsFound = readdirSync(skillsDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory() && existsSync(join(skillsDir, e.name, 'SKILL.md')))
+            .length;
+    }
+    let recommendation;
+    if (detections.length === 0) {
+        recommendation = 'No legacy installations detected. Use `dz init` to install skills.';
+    }
+    else if (detections.length === 1) {
+        const d = detections[0];
+        recommendation = `Found ${d.manifest} (v${d.version}, ${d.fileCount} files). Skills are already in .claude/skills/ — use \`dz sync\` to manage them canonically.`;
+    }
+    else {
+        recommendation = `Found ${detections.length} legacy manifests. Skills coexist in .claude/skills/. Run \`dz doctor\` to verify health, then \`dz sync\` to adopt canonical management.`;
+    }
+    return { projectRoot: root, detections, skillsFound, recommendation };
+}
+/** Report environment diagnostics for the harness. */
+export async function runDoctor(options) {
+    const checks = [];
+    const root = options.projectRoot;
+    // 1. Node version
+    const nodeMajor = Number(process.versions.node.split('.')[0] ?? '0');
+    checks.push({ name: 'node >= 20', ok: nodeMajor >= 20, detail: `node ${process.version}` });
+    // 2. Key directories
+    for (const dir of ['.claude/skills', 'packages/@dzhechkov/skills-meta']) {
+        checks.push({
+            name: `${dir} present`,
+            ok: existsSync(join(root, dir)),
+            detail: dir,
+        });
+    }
+    // 3. Adapter resolvability
+    const adapters = ['adapter-claude', 'adapter-codex', 'adapter-hermes', 'adapter-opencode'];
+    const foundAdapters = adapters.filter((a) => existsSync(join(root, 'packages/@dzhechkov', a)));
+    checks.push({
+        name: 'adapters present',
+        ok: foundAdapters.length === 4,
+        detail: `${foundAdapters.length}/4 adapters found`,
+    });
+    // 4. Package version consistency
+    const pkgsDir = join(root, 'packages/@dzhechkov');
+    if (existsSync(pkgsDir)) {
+        const versions = new Map();
+        let consistent = true;
+        let detail = '';
+        try {
+            const entries = readdirSync(pkgsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const pjPath = join(pkgsDir, entry.name, 'package.json');
+                if (!existsSync(pjPath))
+                    continue;
+                const pj = JSON.parse(readFileSync(pjPath, 'utf-8'));
+                if (pj.version)
+                    versions.set(entry.name, pj.version);
+            }
+            const uniqueVersions = new Set(versions.values());
+            detail = `${versions.size} packages, ${uniqueVersions.size} unique version(s)`;
+            // Warn if more than 10 unique versions (some variation is expected in a large monorepo)
+            if (uniqueVersions.size > 10) {
+                consistent = false;
+                detail += ' — high version divergence';
+            }
+        }
+        catch {
+            consistent = false;
+            detail = 'failed to read package versions';
+        }
+        checks.push({ name: 'package versions', ok: consistent, detail });
+    }
+    // 5. Config lint (.agentic-qe/config.yaml)
+    const configPath = join(root, '.agentic-qe', 'config.yaml');
+    if (existsSync(configPath)) {
+        try {
+            const { parse: parseYaml } = await import('yaml');
+            const content = readFileSync(configPath, 'utf-8');
+            const parsed = parseYaml(content);
+            const hasProject = typeof parsed?.project === 'string';
+            checks.push({
+                name: 'aqe config valid',
+                ok: hasProject,
+                detail: hasProject ? `project: ${parsed.project}` : 'missing project field',
+            });
+        }
+        catch (error) {
+            checks.push({
+                name: 'aqe config valid',
+                ok: false,
+                detail: `parse error: ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+    }
+    else {
+        checks.push({ name: 'aqe config valid', ok: true, detail: 'no .agentic-qe/config.yaml (optional)' });
+    }
+    // 6. SQLite memory backend probe
+    try {
+        const { createRequire } = await import('node:module');
+        const req = createRequire(join(root, 'package.json'));
+        req.resolve('better-sqlite3');
+        checks.push({ name: 'sqlite backend', ok: true, detail: 'better-sqlite3 available' });
+    }
+    catch {
+        checks.push({ name: 'sqlite backend', ok: true, detail: 'better-sqlite3 not installed (JSON fallback)' });
+    }
+    // 7. Skills directory health
+    const skillsDir = join(root, '.claude', 'skills');
+    if (existsSync(skillsDir)) {
+        const skillDirs = readdirSync(skillsDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+        const withSkillMd = skillDirs.filter((e) => existsSync(join(skillsDir, e.name, 'SKILL.md')));
+        checks.push({
+            name: 'skills health',
+            ok: withSkillMd.length === skillDirs.length,
+            detail: `${withSkillMd.length}/${skillDirs.length} skill dirs have SKILL.md`,
+        });
+    }
+    return { node: process.version, checks, ok: checks.every((check) => check.ok) };
+}
+//# sourceMappingURL=operations.js.map

package/dist/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAoCvC,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAoB;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IACjC,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CACpD,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAC1D,CAAC;IACF,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/E,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE;YACpC,UAAU,EAAE,OAAO,CAAC,WAAW;YAC/B,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI;SAC9B,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;AAC5G,CAAC;AA8BD,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,MAAM,GAAe,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,EAAE,IAAI,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACjG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE;gBACF,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChE,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO;QACL,MAAM;QACN,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM;QAChD,MAAM;KACP,CAAC;AACJ,CAAC;AAkCD,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAoB;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3F,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,MAAM,YAAY,IAAI,IAAI,EAAE,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,gBAAgB,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YAErF,IAAI,MAAM,GAAG,KAAK,CAAC;YACnB,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;oBAAE,OAAO,GAAG,IAAI,CAAC;qBACzC,IAAI,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO;oBAAE,MAAM,GAAG,IAAI,CAAC;YAC/E,CAAC;YACD,MAAM,MAAM,GAA8B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YAE7F,IAAI,OAAO,GAAa,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;YAC3F,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC3C,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE;oBAC9B,UAAU,EAAE,OAAO,CAAC,WAAW;oBAC/B,KAAK,EAAE,MAAM,KAAK,OAAO;iBAC1B,CAAC,CAAC,OAAO,CAAC;YACb,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;IAAA,CAAC;IACF,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI;QAC/B,MAAM;QACN,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YACnE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;YACpE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM;SACjE;KACF,CAAC;AACJ,CAAC;AAsBD,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,OAAgC;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IACjC,MAAM,UAAU,GAAuB,EAAE,CAAC;IAE1C,4BAA4B;IAC5B,MAAM,SAAS,GAAG,CAAC,iBAAiB,EAAE,WAAW,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,mBAAmB,CAAC,CAAC;IAC3I,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;gBACrD,UAAU,CAAC,IAAI,CAAC;oBACd,QAAQ;oBACR,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS;oBAClC,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,EAAE;oBACjC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,WAAW,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC1D,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;aACjF,MAAM,CAAC;IACZ,CAAC;IAED,IAAI,cAAsB,CAAC;IAC3B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,cAAc,GAAG,oEAAoE,CAAC;IACxF,CAAC;SAAM,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAE,CAAC;QACzB,cAAc,GAAG,SAAS,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,SAAS,8FAA8F,CAAC;IACpK,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,SAAS,UAAU,CAAC,MAAM,2IAA2I,CAAC;IACzL,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;AACxE,CAAC;AAoBD,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAgC;IAC9D,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjC,kBAAkB;IAClB,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,SAAS,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE5F,qBAAqB;IACrB,KAAK,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,iCAAiC,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,GAAG,GAAG,UAAU;YACtB,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC/B,MAAM,EAAE,GAAG;SACZ,CAAC,CAAC;IACL,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,CAAC,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IAC3F,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,kBAAkB;QACxB,EAAE,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC;QAC9B,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,mBAAmB;KACnD,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC3C,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;oBAAE,SAAS;gBACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;gBACzD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAClC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBACrD,IAAI,EAAE,CAAC,OAAO;oBAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,OAAiB,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,cAAc,cAAc,CAAC,IAAI,oBAAoB,CAAC;YAC/E,wFAAwF;YACxF,IAAI,cAAc,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;gBAC7B,UAAU,GAAG,KAAK,CAAC;gBACnB,MAAM,IAAI,4BAA4B,CAAC;YACzC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,KAAK,CAAC;YACnB,MAAM,GAAG,iCAAiC,CAAC;QAC7C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,2CAA2C;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAC5D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YAClC,MAAM,UAAU,GAAG,OAAO,MAAM,EAAE,OAAO,KAAK,QAAQ,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kBAAkB;gBACxB,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,uBAAuB;aAC5E,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kBAAkB;gBACxB,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,gBAAgB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACjF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,uCAAuC,EAAE,CAAC,CAAC;IACvG,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC;QACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,6BAA6B;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACjG,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QAC7F,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,eAAe;YACrB,EAAE,EAAE,WAAW,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;YAC3C,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,2BAA2B;SAC7E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AAClF,CAAC"}

package/dist/skills.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Skill discovery + loading — the consolidated filesystem loader.
+ *
+ * @packageDocumentation
+ */
+import type { CanonicalSkill } from '@dzhechkov/core';
+/** A discovered skill — id plus its description, for listings. */
+export interface SkillSummary {
+    readonly id: string;
+    readonly description: string;
+}
+/** Detailed skill info. */
+export interface SkillInfo {
+    readonly id: string;
+    readonly description: string;
+    readonly name: string;
+    readonly trustTier: number | undefined;
+    readonly version: string | number | undefined;
+    readonly assetCount: number;
+    readonly assetPaths: string[];
+    readonly frontmatter: Record<string, unknown>;
+}
+/** Return the ids of every `<skillsDir>/<id>/SKILL.md`, sorted. */
+export declare function discoverSkillIds(skillsDir: string): string[];
+/** Discover every skill in `skillsDir`, returning id + description. */
+export declare function listSkills(skillsDir: string): SkillSummary[];
+/** Get detailed info about a single skill without loading all assets. */
+export declare function getSkillInfo(skillsDir: string, id: string): SkillInfo | undefined;
+/**
+ * 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 declare function loadSkillFromDir(skillsDir: string, id: string): CanonicalSkill;
+//# sourceMappingURL=skills.d.ts.map

package/dist/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../src/skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAElE,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/C;AAaD,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5D;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAM5D;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAqBjF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,CAiB9E"}