@dewtech/dare-cli 2.16.0 → 3.0.0

package/dist/skills/commands/update.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `dare skill update <name[@version]>` — update an installed skill.
+ *
+ * Usage:
+ *   dare skill update dare-ax             # update to latest
+ *   dare skill update dare-ax@1.1.0       # update to specific version
+ *   dare skill update dare-ax --dry-run   # show diff without changing
+ *   dare skill update dare-ax --json
+ *
+ * Behaviour:
+ *   1. Parse `name@version` (defaults to registry version if no version given).
+ *   2. Verify skill is installed (read manifest).
+ *   3. Compare installed version vs. target version.
+ *   4. If equal → "already up to date", exit 0.
+ *   5. If different → remove old entry, install new entry in manifest.
+ *
+ * @module skills/commands/update
+ */
+import { Command } from 'commander';
+export interface UpdateResult {
+    name: string;
+    from: string | null;
+    to: string;
+    updated: boolean;
+    alreadyUpToDate: boolean;
+    notInstalled: boolean;
+    dryRun: boolean;
+    error?: string;
+}
+export declare const skillUpdateCommand: Command;
+//# sourceMappingURL=update.d.ts.map

package/dist/skills/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/skills/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD,eAAO,MAAM,kBAAkB,SAmH3B,CAAC"}

package/dist/skills/commands/update.js

@@ -0,0 +1,132 @@
+/**
+ * `dare skill update <name[@version]>` — update an installed skill.
+ *
+ * Usage:
+ *   dare skill update dare-ax             # update to latest
+ *   dare skill update dare-ax@1.1.0       # update to specific version
+ *   dare skill update dare-ax --dry-run   # show diff without changing
+ *   dare skill update dare-ax --json
+ *
+ * Behaviour:
+ *   1. Parse `name@version` (defaults to registry version if no version given).
+ *   2. Verify skill is installed (read manifest).
+ *   3. Compare installed version vs. target version.
+ *   4. If equal → "already up to date", exit 0.
+ *   5. If different → remove old entry, install new entry in manifest.
+ *
+ * @module skills/commands/update
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { registry } from '../registry.js';
+import { LocalRegistry } from '../registry-local.js';
+import { ManifestReader, ManifestWriter } from '../manifest.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Parses `name[@version]` into { name, version }.
+ * Version defaults to `null` (meaning "use registry latest").
+ */
+function parsePackageSpec(spec) {
+    const atIdx = spec.lastIndexOf('@');
+    if (atIdx > 0) {
+        return { name: spec.slice(0, atIdx), version: spec.slice(atIdx + 1) || null };
+    }
+    return { name: spec, version: null };
+}
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+export const skillUpdateCommand = new Command('update')
+    .description('Update an installed skill to a newer version')
+    .argument('<name>', 'Skill name with optional version (e.g. dare-ax or dare-ax@1.1.0)')
+    .option('--dry-run', 'Show version diff without making changes', false)
+    .option('--json', 'Output as JSON (machine-readable)', false)
+    .action(async (spec, options) => {
+    const cwd = process.cwd();
+    const { name, version: requestedVersion } = parsePackageSpec(spec);
+    const result = {
+        name,
+        from: null,
+        to: '',
+        updated: false,
+        alreadyUpToDate: false,
+        notInstalled: false,
+        dryRun: options.dryRun,
+    };
+    // ── 1. Verify skill exists in registry (mock or local) ───────────────────
+    const mockSkill = registry.findByName(name);
+    const localRegistry = new LocalRegistry();
+    const localSkill = localRegistry.find(name);
+    const registrySkill = mockSkill ?? (localSkill ? { ...localSkill, dependencies: {}, published_at: localSkill.published_at ?? new Date().toISOString(), size_kb: localSkill.size_kb ?? 0 } : undefined);
+    if (!registrySkill) {
+        result.error = `Skill "${name}" not found in the registry.`;
+        if (options.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        }
+        else {
+            console.error(chalk.red(`\n  ${result.error}`));
+            console.error(chalk.gray('  Run `dare skill list` to see available skills.\n'));
+        }
+        process.exit(1);
+    }
+    const targetVersion = requestedVersion ?? registrySkill.version;
+    result.to = targetVersion;
+    // ── 2. Verify skill is installed ─────────────────────────────────────────
+    const reader = new ManifestReader();
+    const manifest = reader.readOrEmpty(cwd);
+    const installed = manifest.skills.find((s) => s.name === name);
+    if (!installed) {
+        result.notInstalled = true;
+        result.error = `Skill "${name}" is not installed. Run \`dare skill add ${name}\` first.`;
+        if (options.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        }
+        else {
+            console.error(chalk.red(`\n  ${result.error}\n`));
+        }
+        process.exit(1);
+    }
+    result.from = installed.version;
+    // ── 3. Compare versions ──────────────────────────────────────────────────
+    if (installed.version === targetVersion) {
+        result.alreadyUpToDate = true;
+        if (options.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        }
+        else {
+            console.log(chalk.gray(`\n  ${chalk.cyan(name)} is already at v${targetVersion} — nothing to do.\n`));
+        }
+        return;
+    }
+    // ── 4. Dry run ───────────────────────────────────────────────────────────
+    if (options.dryRun) {
+        if (options.json) {
+            process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        }
+        else {
+            console.log(chalk.bold.yellow('\n  Dry run — no changes will be made.\n'));
+            console.log(`  Would update ${chalk.cyan(name)}: ` +
+                `${chalk.gray('v' + installed.version)} → ${chalk.green('v' + targetVersion)}\n`);
+        }
+        return;
+    }
+    // ── 5. Perform update ────────────────────────────────────────────────────
+    const writer = new ManifestWriter();
+    const newEntry = {
+        name,
+        version: targetVersion,
+        enabled: installed.enabled,
+        dependsOn: installed.dependsOn,
+    };
+    writer.addSkill(cwd, newEntry); // addSkill does upsert by name
+    result.updated = true;
+    if (options.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    }
+    else {
+        console.log(chalk.green(`\n  Updated ${chalk.bold(name)}: v${installed.version} → v${targetVersion}\n`));
+    }
+});
+//# sourceMappingURL=update.js.map

package/dist/skills/commands/update.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `dare skill` — skill package management for DARE projects.
+ *
+ * Subcommands:
+ *   list [--installed] [--json]                          list registry or installed skills
+ *   info <name> [--json]                                 show skill details
+ *   add <name[@version]> [--dry-run] [--json]            install a skill
+ *   remove <name> [--force] [--json]                     uninstall a skill
+ *   update <name[@version]> [--dry-run] [--json]         update an installed skill
+ *   publish <path> [--dry-run] [--json]                  publish a skill to local registry
+ *
+ * @module skills
+ */
+import { Command } from 'commander';
+export declare const skillCommand: Command;
+export { ManifestReader, ManifestWriter } from './manifest.js';
+export type { Manifest, SkillEntry } from './manifest.js';
+export { Registry, registry } from './registry.js';
+export type { RegistrySkill } from './registry.js';
+export { LocalRegistry } from './registry-local.js';
+export type { LocalRegistrySkill } from './registry-local.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,YAAY,SAOS,CAAC;AAGnC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,33 @@
+/**
+ * `dare skill` — skill package management for DARE projects.
+ *
+ * Subcommands:
+ *   list [--installed] [--json]                          list registry or installed skills
+ *   info <name> [--json]                                 show skill details
+ *   add <name[@version]> [--dry-run] [--json]            install a skill
+ *   remove <name> [--force] [--json]                     uninstall a skill
+ *   update <name[@version]> [--dry-run] [--json]         update an installed skill
+ *   publish <path> [--dry-run] [--json]                  publish a skill to local registry
+ *
+ * @module skills
+ */
+import { Command } from 'commander';
+import { skillListCommand } from './commands/list.js';
+import { skillInfoCommand } from './commands/info.js';
+import { skillAddCommand } from './commands/add.js';
+import { skillRemoveCommand } from './commands/remove.js';
+import { skillUpdateCommand } from './commands/update.js';
+import { skillPublishCommand } from './commands/publish.js';
+export const skillCommand = new Command('skill')
+    .description('Manage DARE skills for this project (add, remove, list, info, update, publish)')
+    .addCommand(skillListCommand)
+    .addCommand(skillInfoCommand)
+    .addCommand(skillAddCommand)
+    .addCommand(skillRemoveCommand)
+    .addCommand(skillUpdateCommand)
+    .addCommand(skillPublishCommand);
+// Re-export lower-level utilities so other modules can import from 'skills/index'.
+export { ManifestReader, ManifestWriter } from './manifest.js';
+export { Registry, registry } from './registry.js';
+export { LocalRegistry } from './registry-local.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,gFAAgF,CAAC;KAC7F,UAAU,CAAC,gBAAgB,CAAC;KAC5B,UAAU,CAAC,gBAAgB,CAAC;KAC5B,UAAU,CAAC,eAAe,CAAC;KAC3B,UAAU,CAAC,kBAAkB,CAAC;KAC9B,UAAU,CAAC,kBAAkB,CAAC;KAC9B,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAEnC,mFAAmF;AACnF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/skills/manifest.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Manifest — reads and writes `.dare/skills.yml`
+ *
+ * Source of truth for all installed skills in a DARE project.
+ * Format is intentionally human-readable but managed by the CLI (ADR-01).
+ *
+ * @module skills/manifest
+ */
+export interface SkillEntry {
+    name: string;
+    version: string;
+    enabled: boolean;
+    dependsOn?: string[];
+}
+export interface Manifest {
+    skills: SkillEntry[];
+}
+export declare class ManifestReader {
+    /**
+     * Returns true when a manifest file exists at the given project root.
+     */
+    exists(projectPath: string): boolean;
+    /**
+     * Reads and parses the manifest.
+     * Throws a descriptive error when the file is absent or malformed.
+     */
+    read(projectPath: string): Manifest;
+    /**
+     * Reads the manifest if it exists, or returns an empty one.
+     */
+    readOrEmpty(projectPath: string): Manifest;
+    private _validate;
+}
+export declare class ManifestWriter {
+    private readonly _reader;
+    /**
+     * Writes (overwrites) the full manifest to disk.
+     * Creates `.dare/` directory if it does not exist.
+     */
+    write(projectPath: string, manifest: Manifest): void;
+    /**
+     * Adds a skill entry to the manifest.
+     * If the skill already exists (same name), it is replaced.
+     */
+    addSkill(projectPath: string, skill: SkillEntry): void;
+    /**
+     * Removes a skill entry by name.
+     * No-op if the skill is not present.
+     */
+    removeSkill(projectPath: string, skillName: string): void;
+    /** Convert to a plain object that yaml serialises predictably. */
+    private _toSerializable;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/skills/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/skills/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAoBD,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIpC;;;OAGG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAuBnC;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ;IAS1C,OAAO,CAAC,SAAS;CAqDlB;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAEhD;;;OAGG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAYpD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAatD;;;OAGG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAQzD,kEAAkE;IAClE,OAAO,CAAC,eAAe;CAexB"}

package/dist/skills/manifest.js

@@ -0,0 +1,162 @@
+/**
+ * Manifest — reads and writes `.dare/skills.yml`
+ *
+ * Source of truth for all installed skills in a DARE project.
+ * Format is intentionally human-readable but managed by the CLI (ADR-01).
+ *
+ * @module skills/manifest
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MANIFEST_DIR = '.dare';
+const MANIFEST_FILE = 'skills.yml';
+function manifestPath(projectPath) {
+    return path.join(projectPath, MANIFEST_DIR, MANIFEST_FILE);
+}
+const HEADER_COMMENT = '# .dare/skills.yml — Managed by DARE CLI. Do not edit manually.\n';
+// ---------------------------------------------------------------------------
+// ManifestReader
+// ---------------------------------------------------------------------------
+export class ManifestReader {
+    /**
+     * Returns true when a manifest file exists at the given project root.
+     */
+    exists(projectPath) {
+        return fs.pathExistsSync(manifestPath(projectPath));
+    }
+    /**
+     * Reads and parses the manifest.
+     * Throws a descriptive error when the file is absent or malformed.
+     */
+    read(projectPath) {
+        const filePath = manifestPath(projectPath);
+        if (!fs.pathExistsSync(filePath)) {
+            throw new Error(`Manifest not found at ${filePath}. Run 'dare skill add <name>' to create one.`);
+        }
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        let parsed;
+        try {
+            parsed = parseYaml(raw);
+        }
+        catch (err) {
+            throw new Error(`Failed to parse ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return this._validate(parsed, filePath);
+    }
+    /**
+     * Reads the manifest if it exists, or returns an empty one.
+     */
+    readOrEmpty(projectPath) {
+        if (!this.exists(projectPath)) {
+            return { skills: [] };
+        }
+        return this.read(projectPath);
+    }
+    // ---- private -------------------------------------------------------------
+    _validate(raw, filePath) {
+        if (typeof raw !== 'object' || raw === null) {
+            throw new Error(`${filePath}: expected an object at top level, got ${typeof raw}.`);
+        }
+        const obj = raw;
+        if (!Array.isArray(obj['skills'])) {
+            throw new Error(`${filePath}: 'skills' must be an array.`);
+        }
+        const skills = obj['skills'].map((item, idx) => {
+            if (typeof item !== 'object' || item === null) {
+                throw new Error(`${filePath}: skills[${idx}] must be an object.`);
+            }
+            const entry = item;
+            if (typeof entry['name'] !== 'string' || !entry['name']) {
+                throw new Error(`${filePath}: skills[${idx}].name must be a non-empty string.`);
+            }
+            if (typeof entry['version'] !== 'string' || !entry['version']) {
+                throw new Error(`${filePath}: skills[${idx}].version must be a non-empty string.`);
+            }
+            if (typeof entry['enabled'] !== 'boolean') {
+                throw new Error(`${filePath}: skills[${idx}].enabled must be a boolean.`);
+            }
+            const skill = {
+                name: entry['name'],
+                version: entry['version'],
+                enabled: entry['enabled'],
+            };
+            if (Array.isArray(entry['dependsOn'])) {
+                skill.dependsOn = entry['dependsOn'].map((d, i) => {
+                    if (typeof d !== 'string') {
+                        throw new Error(`${filePath}: skills[${idx}].dependsOn[${i}] must be a string.`);
+                    }
+                    return d;
+                });
+            }
+            return skill;
+        });
+        return { skills };
+    }
+}
+// ---------------------------------------------------------------------------
+// ManifestWriter
+// ---------------------------------------------------------------------------
+export class ManifestWriter {
+    constructor() {
+        this._reader = new ManifestReader();
+    }
+    /**
+     * Writes (overwrites) the full manifest to disk.
+     * Creates `.dare/` directory if it does not exist.
+     */
+    write(projectPath, manifest) {
+        const filePath = manifestPath(projectPath);
+        fs.ensureDirSync(path.dirname(filePath));
+        const yamlBody = stringifyYaml(this._toSerializable(manifest), {
+            indent: 2,
+            lineWidth: 120,
+        });
+        fs.writeFileSync(filePath, HEADER_COMMENT + yamlBody, 'utf-8');
+    }
+    /**
+     * Adds a skill entry to the manifest.
+     * If the skill already exists (same name), it is replaced.
+     */
+    addSkill(projectPath, skill) {
+        const manifest = this._reader.readOrEmpty(projectPath);
+        const idx = manifest.skills.findIndex((s) => s.name === skill.name);
+        if (idx >= 0) {
+            manifest.skills[idx] = skill;
+        }
+        else {
+            manifest.skills.push(skill);
+        }
+        this.write(projectPath, manifest);
+    }
+    /**
+     * Removes a skill entry by name.
+     * No-op if the skill is not present.
+     */
+    removeSkill(projectPath, skillName) {
+        const manifest = this._reader.readOrEmpty(projectPath);
+        manifest.skills = manifest.skills.filter((s) => s.name !== skillName);
+        this.write(projectPath, manifest);
+    }
+    // ---- private -------------------------------------------------------------
+    /** Convert to a plain object that yaml serialises predictably. */
+    _toSerializable(manifest) {
+        return {
+            skills: manifest.skills.map((s) => {
+                const entry = {
+                    name: s.name,
+                    version: s.version,
+                    enabled: s.enabled,
+                };
+                if (s.dependsOn && s.dependsOn.length > 0) {
+                    entry['dependsOn'] = s.dependsOn;
+                }
+                return entry;
+            }),
+        };
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/skills/manifest.js.map

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

package/dist/skills/registry-local.d.ts

@@ -0,0 +1,67 @@
+/**
+ * LocalRegistry — persistent skill registry stored in `~/.dare/registry/`.
+ *
+ * Directory layout:
+ *
+ * ```
+ * ~/.dare/registry/
+ * ├── index.json                  # { skills: [{ name, version, description, ... }] }
+ * ├── dare-ax/
+ * │   └── 1.0.0/
+ * │       ├── skill.yml
+ * │       └── index.ts
+ * └── dare-layered-design/
+ *     └── 1.0.0/
+ *         └── ...
+ * ```
+ *
+ * This acts as a local publish target that `dare skill publish` writes to, and
+ * `dare skill add` falls back to when the remote mock registry has no match.
+ *
+ * @module skills/registry-local
+ */
+export interface LocalRegistrySkill {
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    license: string;
+    homepage?: string;
+    repository?: string;
+    keywords?: string[];
+    dare_version?: string;
+    published_at?: string;
+    size_kb?: number;
+    source: 'local';
+}
+export declare class LocalRegistry {
+    private readonly _root;
+    constructor(root?: string);
+    /**
+     * Returns all skills in the local registry index.
+     */
+    list(): LocalRegistrySkill[];
+    /**
+     * Finds a skill by name (and optionally an exact version).
+     * Returns `null` when not found.
+     */
+    find(name: string, version?: string): LocalRegistrySkill | null;
+    /**
+     * Publishes a skill from `skillPath` into the local registry.
+     *
+     * Copies all files (excluding node_modules/, dist/, .git/) from `skillPath`
+     * into `~/.dare/registry/<name>/<version>/` and updates `index.json`.
+     */
+    publish(skillPath: string, meta: LocalRegistrySkill): void;
+    /**
+     * Installs a skill from the local registry into a project.
+     *
+     * Copies files from `~/.dare/registry/<name>/<version>/` into
+     * `<targetProjectPath>/packages/skills/<name>/`.
+     */
+    install(name: string, version: string, targetProjectPath: string): void;
+    private _indexPath;
+    private _readIndex;
+    private _writeIndex;
+}
+//# sourceMappingURL=registry-local.d.ts.map

package/dist/skills/registry-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-local.d.ts","sourceRoot":"","sources":["../../src/skills/registry-local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAqBD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,CAAC,EAAE,MAAM;IAMzB;;OAEG;IACH,IAAI,IAAI,kBAAkB,EAAE;IAI5B;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAkB/D;;;;;OAKG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI;IA0B1D;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAevE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,WAAW;CAIpB"}