@poping/yome 0.0.2 → 0.0.3

package/dist/yomeSkills/doctor.js

@@ -0,0 +1,152 @@
+// `yome skill doctor` — sanity-check the local registry.
+//
+// Detects:
+//   - Skills present on disk but with broken / missing yome-skill.json
+//   - Stale .index.json (entries that no longer have a backing dir)
+//   - Capability grants for skills whose declared system_capabilities have
+//     since shrunk (orphan grants — safe but noisy)
+//   - Dev-link symlinks pointing at deleted source dirs
+//   - Missing .install-meta.json (legacy; warn-only — can't update)
+//
+// Exit codes: 0 = no issues, 1 = at least one issue.
+//
+// `doctor` does NOT fix anything by itself — it just reports. The user
+// follows up with `yome skill uninstall <slug>` or `yome skill install
+// <source> --force` as appropriate.
+import { existsSync, readdirSync, statSync, lstatSync, readlinkSync } from 'fs';
+import { join } from 'path';
+import { getYomeSkillsRoot } from './paths.js';
+import { readManifest } from './manifest.js';
+import { readInstallMeta } from './installMeta.js';
+import { readAllowedCapabilities, normaliseDeclared, KNOWN_CAPABILITIES, } from './capabilities.js';
+import { readIndex } from './skillsIndex.js';
+function listInstallDirs() {
+    const root = getYomeSkillsRoot();
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    for (const owner of readdirSync(root)) {
+        if (owner.startsWith('.'))
+            continue;
+        const ownerPath = join(root, owner);
+        if (!statSync(ownerPath).isDirectory())
+            continue;
+        for (const name of readdirSync(ownerPath)) {
+            if (name.startsWith('.'))
+                continue;
+            const dir = join(ownerPath, name);
+            const lst = lstatSync(dir);
+            const isLink = lst.isSymbolicLink();
+            const linkTarget = isLink ? readlinkSync(dir) : undefined;
+            // Only treat as a real install if it's a directory or a symlink to one.
+            try {
+                const target = isLink ? statSync(dir) : lst;
+                if (!target.isDirectory())
+                    continue;
+            }
+            catch {
+                // Broken symlink — surface this as an issue below.
+                out.push({ slug: `@${owner}/${name}`, dir, isLink: true, linkTarget });
+                continue;
+            }
+            out.push({ slug: `@${owner}/${name}`, dir, isLink, linkTarget });
+        }
+    }
+    return out;
+}
+export function runDoctor() {
+    const issues = [];
+    const installs = listInstallDirs();
+    const seenSlugs = new Set();
+    for (const it of installs) {
+        seenSlugs.add(it.slug);
+        // Broken symlink (dev-link target deleted)
+        if (it.isLink) {
+            try {
+                statSync(it.dir);
+            }
+            catch {
+                issues.push({
+                    level: 'error',
+                    slug: it.slug,
+                    path: it.dir,
+                    message: `dev-link points at deleted target ${it.linkTarget}`,
+                });
+                continue;
+            }
+        }
+        // Manifest readable + slug consistent
+        const m = readManifest(it.dir);
+        if (!m) {
+            issues.push({
+                level: 'error',
+                slug: it.slug,
+                path: it.dir,
+                message: 'yome-skill.json missing or unparseable',
+            });
+            continue;
+        }
+        if (m.slug !== it.slug) {
+            issues.push({
+                level: 'error',
+                slug: it.slug,
+                path: it.dir,
+                message: `slug mismatch — directory says ${it.slug} but manifest says ${m.slug}`,
+            });
+        }
+        // install-meta presence (legacy installs may lack it)
+        if (!readInstallMeta(it.slug)) {
+            issues.push({
+                level: 'warning',
+                slug: it.slug,
+                message: '.install-meta.json missing — `yome skill update` will not know how to refresh this skill',
+            });
+        }
+        // Capability grants vs current declared set
+        const allowed = readAllowedCapabilities(it.slug);
+        if (allowed) {
+            const declared = new Set(normaliseDeclared(m.system_capabilities));
+            const orphan = allowed.allowed.filter(c => !declared.has(c));
+            if (orphan.length > 0) {
+                issues.push({
+                    level: 'warning',
+                    slug: it.slug,
+                    message: `granted capabilities not declared in current manifest: ${orphan.join(', ')} — consider \`yome skill perms ${it.slug} --revoke=<cap>\``,
+                });
+            }
+            // Also surface any grant for a cap we no longer recognise
+            const unknown = allowed.allowed.filter(c => !KNOWN_CAPABILITIES.includes(c));
+            if (unknown.length > 0) {
+                issues.push({
+                    level: 'warning',
+                    slug: it.slug,
+                    message: `granted unknown capabilities: ${unknown.join(', ')} (CLI version mismatch?)`,
+                });
+            }
+        }
+    }
+    // Index stale check
+    const idx = readIndex();
+    if (idx) {
+        for (const entry of idx.skills) {
+            if (!seenSlugs.has(entry.slug)) {
+                issues.push({
+                    level: 'warning',
+                    slug: entry.slug,
+                    message: '.index.json lists this skill but no install dir was found — run `yome skill list` to refresh',
+                });
+            }
+        }
+    }
+    console.log('DOCTOR REPORT:', JSON.stringify({
+        ok: issues.filter(i => i.level === 'error').length === 0,
+        scanned: installs.length,
+        issues,
+    }, null, 2));
+    return {
+        ok: issues.filter(i => i.level === 'error').length === 0,
+        scanned: installs.length,
+        issues,
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/yomeSkills/doctor.js.map

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

package/dist/yomeSkills/enable.d.ts

@@ -0,0 +1,8 @@
+export interface ToggleResult {
+    ok: boolean;
+    slug: string;
+    state?: 'enabled' | 'disabled';
+    reason?: string;
+}
+export declare function isSkillDisabled(slug: string): boolean;
+export declare function setSkillEnabled(slug: string, enabled: boolean): ToggleResult;

package/dist/yomeSkills/enable.js

@@ -0,0 +1,67 @@
+// `yome skill enable / disable <slug>` — toggle whether the agent
+// runtime should load this installed skill.
+//
+// We persist state as a sentinel file `.yome-disabled` inside the skill's
+// install directory. Rationale (vs a central registry.json):
+//   - zero schema migration; uninstall just `rm -rf` the dir, taking the
+//     sentinel with it.
+//   - works for dev-linked skills too (the flag lives on the symlink
+//     target's view but writing is naturally scoped per-skill).
+//
+// `isSkillDisabled()` is exported so the loader (Server side) can read
+// the same flag once we wire the generated registry to honour it.
+import { existsSync, writeFileSync, unlinkSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { installPathForSlug } from './paths.js';
+import { refreshIndex } from './skillsIndex.js';
+const DISABLED_MARKER = '.yome-disabled';
+function markerPath(slug) {
+    const dir = installPathForSlug(slug);
+    if (!dir)
+        return null;
+    return join(dir, DISABLED_MARKER);
+}
+export function isSkillDisabled(slug) {
+    const m = markerPath(slug);
+    if (!m)
+        return false;
+    return existsSync(m);
+}
+export function setSkillEnabled(slug, enabled) {
+    const m = markerPath(slug);
+    if (!m)
+        return { ok: false, slug, reason: 'invalid slug shape (expected @owner/name)' };
+    const dir = dirname(m);
+    if (!existsSync(dir)) {
+        return { ok: false, slug, reason: `skill not installed at ${dir}` };
+    }
+    if (enabled) {
+        if (existsSync(m)) {
+            try {
+                unlinkSync(m);
+            }
+            catch (e) {
+                return { ok: false, slug, reason: e.message };
+            }
+        }
+        try {
+            refreshIndex();
+        }
+        catch { /* best effort */ }
+        return { ok: true, slug, state: 'enabled' };
+    }
+    // disabling: write a tiny marker (no schema needed inside)
+    try {
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(m, `disabled at ${new Date().toISOString()}\n`, { mode: 0o644 });
+    }
+    catch (e) {
+        return { ok: false, slug, reason: e.message };
+    }
+    try {
+        refreshIndex();
+    }
+    catch { /* best effort */ }
+    return { ok: true, slug, state: 'disabled' };
+}
+//# sourceMappingURL=enable.js.map

package/dist/yomeSkills/enable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable.js","sourceRoot":"","sources":["../../src/yomeSkills/enable.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,4CAA4C;AAC5C,EAAE;AACF,0EAA0E;AAC1E,6DAA6D;AAC7D,yEAAyE;AACzE,wBAAwB;AACxB,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,uEAAuE;AACvE,kEAAkE;AAElE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,eAAe,GAAG,gBAAgB,CAAC;AASzC,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAgB;IAC5D,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,2CAA2C,EAAE,CAAC;IACxF,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,0BAA0B,GAAG,EAAE,EAAE,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC;gBAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC;YAAC,YAAY,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IACD,2DAA2D;IAC3D,IAAI,CAAC;QACH,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,CAAC,EAAE,eAAe,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAG,CAAW,CAAC,OAAO,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC;QAAC,YAAY,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC/C,CAAC"}

package/dist/yomeSkills/hubPing.d.ts

@@ -0,0 +1 @@
+export declare function pingHubInstall(slug: string): Promise<void>;

package/dist/yomeSkills/hubPing.js

@@ -0,0 +1,41 @@
+// Best-effort ping to the hub so install_count goes up.
+//
+// Intentionally:
+//   - never throws (catches everything)
+//   - never blocks longer than ~3s
+//   - does nothing if YOME_HUB_PING_DISABLED=1 or YOME_HUB_BASE points
+//     at a non-http(s) value
+//   - silent on success, only logs on failure when YOME_VERBOSE=1
+//
+// The hub endpoint /api/hub/skills/<slug>/install is anonymous (rate-limited
+// per IP) so we don't need to send any credentials.
+//
+// Returns a promise the caller MAY await. The CLI awaits a short bounded
+// time so the request actually leaves the box before the process exits;
+// other callers can ignore the promise.
+const DEFAULT_HUB_BASE = 'https://yome.work';
+export function pingHubInstall(slug) {
+    if (process.env.YOME_HUB_PING_DISABLED === '1')
+        return Promise.resolve();
+    if (!slug)
+        return Promise.resolve();
+    const base = (process.env.YOME_HUB_BASE || DEFAULT_HUB_BASE).replace(/\/$/, '');
+    if (!/^https?:\/\//.test(base))
+        return Promise.resolve();
+    const url = `${base}/api/hub/skills/${encodeURIComponent(slug)}/install`;
+    const verbose = process.env.YOME_VERBOSE === '1';
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 3000);
+    return fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'User-Agent': 'yome-cli/0.1' },
+        body: '{}',
+        signal: ctrl.signal,
+    })
+        .then((r) => { if (verbose)
+        console.error(`hub ping ${slug}: ${r.status}`); })
+        .catch((e) => { if (verbose)
+        console.error(`hub ping ${slug} failed: ${e.message}`); })
+        .finally(() => clearTimeout(timer));
+}
+//# sourceMappingURL=hubPing.js.map

package/dist/yomeSkills/hubPing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubPing.js","sourceRoot":"","sources":["../../src/yomeSkills/hubPing.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iBAAiB;AACjB,wCAAwC;AACxC,mCAAmC;AACnC,uEAAuE;AACvE,6BAA6B;AAC7B,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,oDAAoD;AACpD,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,wCAAwC;AAExC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAE7C,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,GAAG;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACzE,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAEzD,MAAM,GAAG,GAAG,GAAG,IAAI,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,CAAC;IAEjD,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAEnD,OAAO,KAAK,CAAC,GAAG,EAAE;QAChB,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE;QAC7E,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;SACC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SAC7E,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,YAAa,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACjG,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/yomeSkills/install.d.ts

@@ -0,0 +1,18 @@
+export interface InstallOptions {
+    /** Overwrite an existing install of the same slug. */
+    force?: boolean;
+    /** Print verbose progress. */
+    verbose?: boolean;
+    /** Skip the capability prompt — auto-grant everything declared. CI / scripted use. */
+    yes?: boolean;
+    /** Skip blacklist check (NEVER do this in production). Default false. */
+    skipBlacklist?: boolean;
+}
+export interface InstallResult {
+    ok: boolean;
+    slug?: string;
+    installedAt?: string;
+    copiedFiles?: number;
+    reason?: string;
+}
+export declare function installFromLocal(source: string, opts?: InstallOptions): Promise<InstallResult>;

package/dist/yomeSkills/install.js

@@ -0,0 +1,143 @@
+// `yome skill install <source>` — install a skill into ~/.yome/skills/.
+//
+// During Phase 1 (per spec 8.5) we support local-path installs only:
+//   yome skill install ./skills/yome-skill-ppt
+//   yome skill install /abs/path/to/yome-skill-foo
+// Phase 2 will add registry / git installs:
+//   yome skill install @yome/ppt           (registry resolution)
+//   yome skill install github:owner/repo   (git clone)
+//
+// Install strategy:
+//   - Read source/yome-skill.json, validate slug+domain+version
+//   - Compute install path ~/.yome/skills/<owner>/<name>/
+//   - If already installed and not --force, error out
+//   - Recursively copy source → install path (skip node_modules / .git / dist)
+//   - Done; no post-install hooks in this phase
+import { copyFileSync, existsSync, mkdirSync, readdirSync, renameSync, rmSync, statSync } from 'fs';
+import { join, resolve } from 'path';
+import { readManifest, validateManifest } from './manifest.js';
+import { installPathForSlug, parseSlug } from './paths.js';
+import { writeInstallMeta } from './installMeta.js';
+import { decideCapabilities, writeAllowedCapabilities } from './capabilities.js';
+import { refreshIndex } from './skillsIndex.js';
+import { pingBlacklist } from './blacklist.js';
+const IGNORE = new Set(['node_modules', '.git', 'dist', '.DS_Store', '.next', '.turbo', 'coverage']);
+function copyDir(src, dest, log) {
+    let count = 0;
+    if (!existsSync(dest))
+        mkdirSync(dest, { recursive: true });
+    for (const entry of readdirSync(src)) {
+        if (IGNORE.has(entry))
+            continue;
+        const s = join(src, entry);
+        const d = join(dest, entry);
+        const st = statSync(s);
+        if (st.isDirectory()) {
+            count += copyDir(s, d, log);
+        }
+        else if (st.isFile()) {
+            copyFileSync(s, d);
+            log?.(`  + ${entry}`);
+            count++;
+        }
+    }
+    return count;
+}
+export async function installFromLocal(source, opts = {}) {
+    const abs = resolve(source);
+    if (!existsSync(abs))
+        return { ok: false, reason: `source path does not exist: ${abs}` };
+    if (!statSync(abs).isDirectory())
+        return { ok: false, reason: `source is not a directory: ${abs}` };
+    const manifest = readManifest(abs);
+    if (!manifest)
+        return { ok: false, reason: `${abs}/yome-skill.json missing or unreadable` };
+    const v = validateManifest(manifest);
+    if (!v.ok)
+        return { ok: false, reason: `manifest invalid: ${v.errors.join('; ')}` };
+    const slugParts = parseSlug(manifest.slug);
+    if (!slugParts)
+        return { ok: false, reason: `slug "${manifest.slug}" is malformed` };
+    const dest = installPathForSlug(manifest.slug);
+    if (!dest)
+        return { ok: false, reason: `cannot derive install path for ${manifest.slug}` };
+    // Blacklist gate — done before we touch the filesystem.
+    if (!opts.skipBlacklist) {
+        try {
+            const hit = await pingBlacklist(manifest.slug);
+            if (hit) {
+                return {
+                    ok: false,
+                    reason: `${manifest.slug} is on the yome.work blacklist (${hit.reason})${hit.detail ? `: ${hit.detail}` : ''}`,
+                };
+            }
+        }
+        catch { /* offline → ignore, conservative no-block */ }
+    }
+    // Capability prompt — done before we touch the filesystem so a
+    // declined install leaves no trace.
+    const decision = await decideCapabilities(manifest.slug, manifest.system_capabilities, { assumeYes: opts.yes });
+    if (!decision.ok) {
+        return { ok: false, reason: decision.reason ?? 'capability grant declined' };
+    }
+    if (existsSync(dest)) {
+        if (!opts.force) {
+            return { ok: false, reason: `${manifest.slug} already installed at ${dest} (use --force to overwrite)` };
+        }
+        // Move the existing install aside as the rollback snapshot. We keep
+        // exactly ONE previous version (per spec 11.4-D "保留最近 2 个版本").
+        // The snapshot lives next to the install dir so it shares the slug's
+        // capability grant / parent directory layout.
+        try {
+            const snap = `${dest}.previous`;
+            if (existsSync(snap))
+                rmSync(snap, { recursive: true, force: true });
+            // os.rename is atomic; if it fails (cross-filesystem etc) we fall
+            // back to copy-then-delete via a recursive helper inlined below.
+            try {
+                renameSync(dest, snap);
+            }
+            catch {
+                copyDir(dest, snap);
+                rmSync(dest, { recursive: true, force: true });
+            }
+        }
+        catch {
+            // If snapshotting fails for any reason we still proceed — losing
+            // rollback ability is better than losing the install itself.
+            try {
+                rmSync(dest, { recursive: true, force: true });
+            }
+            catch { /* ignore */ }
+        }
+    }
+    const log = opts.verbose ? (s) => process.stdout.write(s + '\n') : undefined;
+    const copied = copyDir(abs, dest, log);
+    // Persist how we got here so `yome skill update` can replay later.
+    try {
+        writeInstallMeta(manifest.slug, {
+            source: `local:${abs}`,
+            installed_at: new Date().toISOString(),
+            manifest_version: manifest.version,
+        });
+    }
+    catch { /* best effort */ }
+    // Write the capability grant alongside the install meta.
+    try {
+        if (decision.granted)
+            writeAllowedCapabilities(manifest.slug, decision.granted);
+    }
+    catch { /* best effort */ }
+    // Refresh the fast lookup index.
+    try {
+        refreshIndex();
+    }
+    catch { /* best effort */ }
+    return {
+        ok: true,
+        slug: manifest.slug,
+        installedAt: dest,
+        copiedFiles: copied,
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/yomeSkills/install.js.map

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

package/dist/yomeSkills/installGithub.d.ts

@@ -0,0 +1,26 @@
+import { type InstallOptions, type InstallResult } from './install.js';
+export interface ParsedGithubSource {
+    owner: string;
+    repo: string;
+    ref?: string;
+    subPath?: string;
+    /** The https clone URL we will hand to `git clone`. */
+    cloneUrl: string;
+}
+export declare function parseGithubSource(source: string): ParsedGithubSource | null;
+export declare function isGithubSource(source: string): boolean;
+interface GithubInstallExtra {
+    /** When set, after install we recompute sha256 of the install dir and
+     *  compare against this value. Mismatch → uninstall + error.
+     *  When omitted (e.g. older publish without sha256), verification is skipped. */
+    expectedSha256?: string | null;
+    /** Disable post-install sha256 verification entirely (dev/debug). */
+    skipVerify?: boolean;
+}
+/**
+ * Clone the repo into a tmp dir, then delegate to `installFromLocal`. Always
+ * cleans up the tmp clone, even on failure. If `expectedSha256` is provided,
+ * we verify the installed bytes match before declaring success.
+ */
+export declare function installFromGithub(source: string, opts?: InstallOptions & GithubInstallExtra): Promise<InstallResult>;
+export {};