@geoly-ai/social-hub-cli 0.0.2 → 0.0.4

package/dist/skills/github-source.js

@@ -0,0 +1,198 @@
+import { createHash } from "node:crypto";
+import { spawnSync } from "node:child_process";
+import { createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { hashDirectory, loadManifestFromDir } from "./manifest.js";
+/** Default upstream for Social Hub skills in geoly-reddit monorepo. */
+export const DEFAULT_GITHUB_REPO = "geoly-ai/geoly-reddit";
+export const DEFAULT_SKILLS_SUBPATH = "social-ops-hub/skills";
+export const DEFAULT_GITHUB_REF = "main";
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+export function parseGithubRepo(repo) {
+    const trimmed = repo
+        .trim()
+        .replace(/^git@github\.com:/, "")
+        .replace(/^https:\/\/github\.com\//, "")
+        .replace(/\.git$/, "");
+    const parts = trimmed.split("/").filter(Boolean);
+    if (parts.length < 2) {
+        throw new Error(`Invalid GitHub repo: ${repo} (expected owner/name)`);
+    }
+    return { owner: parts[0], name: parts[1] };
+}
+export function githubCacheDir(owner, name, ref) {
+    return join(homedir(), ".cache", "social-hub", "skills", "github", owner, name, ref);
+}
+export function githubTarballUrl(owner, name, ref) {
+    return `https://codeload.github.com/${owner}/${name}/tar.gz/${encodeURIComponent(ref)}`;
+}
+function readCacheMeta(cacheDir) {
+    const metaPath = join(cacheDir, ".github-source.json");
+    if (!existsSync(metaPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(metaPath, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeCacheMeta(cacheDir, meta) {
+    writeFileSync(join(cacheDir, ".github-source.json"), `${JSON.stringify(meta, null, 2)}\n`, "utf8");
+}
+export function cacheIsFresh(meta, ttlMs = CACHE_TTL_MS) {
+    const fetchedAt = Date.parse(meta.fetchedAt);
+    if (Number.isNaN(fetchedAt))
+        return false;
+    return Date.now() - fetchedAt < ttlMs;
+}
+export function resolveGithubOptions(opts = {}) {
+    return {
+        repo: opts.repo ?? process.env["SOCIAL_HUB_SKILLS_REPO"] ?? DEFAULT_GITHUB_REPO,
+        ref: opts.ref ?? process.env["SOCIAL_HUB_SKILLS_REF"] ?? DEFAULT_GITHUB_REF,
+        skillsSubpath: opts.skillsSubpath ?? process.env["SOCIAL_HUB_SKILLS_PATH"] ?? DEFAULT_SKILLS_SUBPATH,
+        refresh: opts.refresh ?? false,
+        token: opts.token ?? process.env["GITHUB_TOKEN"] ?? process.env["GH_TOKEN"] ?? "",
+    };
+}
+async function downloadToFile(url, dest, token) {
+    const headers = {
+        "User-Agent": "social-hub-cli",
+        Accept: "application/octet-stream",
+    };
+    if (token?.trim()) {
+        headers.Authorization = `Bearer ${token.trim()}`;
+    }
+    const res = await fetch(url, { headers, redirect: "follow" });
+    if (!res.ok) {
+        if (res.status === 404) {
+            throw new Error(`GitHub repo or ref not found (404). Check --repo/--ref. ` +
+                "Private repos require GITHUB_TOKEN (or GH_TOKEN).");
+        }
+        if (res.status === 401 || res.status === 403) {
+            throw new Error(`GitHub download unauthorized (${res.status}). Set GITHUB_TOKEN for private repos.`);
+        }
+        throw new Error(`GitHub download failed (${res.status}) for ${url}`);
+    }
+    if (!res.body) {
+        throw new Error(`GitHub download returned empty body for ${url}`);
+    }
+    mkdirSync(join(dest, ".."), { recursive: true });
+    await pipeline(Readable.fromWeb(res.body), createWriteStream(dest));
+}
+function extractTarGz(archivePath, destDir) {
+    mkdirSync(destDir, { recursive: true });
+    const result = spawnSync("tar", ["-xzf", archivePath, "-C", destDir], {
+        encoding: "utf8",
+    });
+    if (result.status !== 0) {
+        throw new Error(`Failed to extract GitHub tarball: ${result.stderr || result.stdout}`);
+    }
+}
+export function findSkillsRootInExtract(extractDir, skillsSubpath) {
+    const normalized = skillsSubpath.replace(/^\/+/, "");
+    const direct = join(extractDir, normalized);
+    if (existsSync(join(direct, "manifest.json"))) {
+        return direct;
+    }
+    for (const entry of readdirSync(extractDir)) {
+        const nested = join(extractDir, entry, normalized);
+        if (existsSync(join(nested, "manifest.json"))) {
+            return nested;
+        }
+    }
+    throw new Error(`Could not find skills/manifest.json at "${skillsSubpath}" in GitHub archive. ` +
+        "Check --repo-path or SOCIAL_HUB_SKILLS_PATH.");
+}
+async function fetchGithubSkillsTree(opts) {
+    const { owner, name } = parseGithubRepo(opts.repo);
+    const cacheDir = githubCacheDir(owner, name, opts.ref);
+    const skillsRoot = join(cacheDir, "skills");
+    const existingMeta = readCacheMeta(cacheDir);
+    if (!opts.refresh &&
+        existingMeta &&
+        cacheIsFresh(existingMeta) &&
+        existsSync(join(skillsRoot, "manifest.json"))) {
+        return { skillsRoot, meta: existingMeta };
+    }
+    const url = githubTarballUrl(owner, name, opts.ref);
+    const staging = join(cacheDir, ".staging");
+    const archivePath = join(cacheDir, "archive.tar.gz");
+    rmSync(staging, { recursive: true, force: true });
+    rmSync(skillsRoot, { recursive: true, force: true });
+    mkdirSync(cacheDir, { recursive: true });
+    await downloadToFile(url, archivePath, opts.token || undefined);
+    extractTarGz(archivePath, staging);
+    const extractedSkillsRoot = findSkillsRootInExtract(staging, opts.skillsSubpath);
+    mkdirSync(skillsRoot, { recursive: true });
+    copyDir(extractedSkillsRoot, skillsRoot);
+    rmSync(staging, { recursive: true, force: true });
+    rmSync(archivePath, { force: true });
+    const digest = hashDirectory(skillsRoot);
+    const meta = {
+        repo: opts.repo,
+        ref: opts.ref,
+        skillsSubpath: opts.skillsSubpath,
+        fetchedAt: new Date().toISOString(),
+        digest,
+        tarballUrl: url,
+    };
+    writeCacheMeta(cacheDir, meta);
+    return { skillsRoot, meta };
+}
+function copyDir(src, dest) {
+    mkdirSync(dest, { recursive: true });
+    for (const name of readdirSync(src, { withFileTypes: true })) {
+        const from = join(src, name.name);
+        const to = join(dest, name.name);
+        if (name.isDirectory()) {
+            copyDir(from, to);
+        }
+        else if (name.isFile()) {
+            writeFileSync(to, readFileSync(from));
+        }
+    }
+}
+export async function resolveGithubSource(opts = {}) {
+    const resolved = resolveGithubOptions(opts);
+    const { skillsRoot, meta } = await fetchGithubSkillsTree(resolved);
+    const manifest = loadManifestFromDir(skillsRoot);
+    const { owner, name } = parseGithubRepo(resolved.repo);
+    return {
+        kind: "github",
+        ref: `github://${owner}/${name}@${resolved.ref}`,
+        version: manifest.cliVersion,
+        skillsRoot,
+        manifest,
+        digest: meta.digest,
+        remote: {
+            repo: resolved.repo,
+            ref: resolved.ref,
+            skillsPath: resolved.skillsSubpath,
+            cachedAt: meta.fetchedAt,
+            cacheDir: githubCacheDir(owner, name, resolved.ref),
+        },
+    };
+}
+export function clearGithubCache(repo, ref) {
+    const base = join(homedir(), ".cache", "social-hub", "skills", "github");
+    if (!existsSync(base))
+        return 0;
+    if (!repo) {
+        rmSync(base, { recursive: true, force: true });
+        return 1;
+    }
+    const { owner, name } = parseGithubRepo(repo);
+    const target = ref ? githubCacheDir(owner, name, ref) : join(base, owner, name);
+    if (!existsSync(target))
+        return 0;
+    rmSync(target, { recursive: true, force: true });
+    return 1;
+}
+export function sha256Hex(input) {
+    return createHash("sha256").update(input).digest("hex");
+}
+//# sourceMappingURL=github-source.js.map

package/dist/skills/github-source.js.map

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

package/dist/skills/github-source.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=github-source.test.d.ts.map

package/dist/skills/github-source.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-source.test.d.ts","sourceRoot":"","sources":["../../src/skills/github-source.test.ts"],"names":[],"mappings":""}

package/dist/skills/github-source.test.js

@@ -0,0 +1,46 @@
+import { describe, expect, it } from "vitest";
+import { cacheIsFresh, githubCacheDir, githubTarballUrl, parseGithubRepo, resolveGithubOptions, } from "./github-source.js";
+describe("github-source", () => {
+    it("parses owner/name repo strings", () => {
+        expect(parseGithubRepo("geoly-ai/geoly-reddit")).toEqual({
+            owner: "geoly-ai",
+            name: "geoly-reddit",
+        });
+        expect(parseGithubRepo("https://github.com/foo/bar.git")).toEqual({
+            owner: "foo",
+            name: "bar",
+        });
+    });
+    it("builds tarball url", () => {
+        expect(githubTarballUrl("geoly-ai", "geoly-reddit", "main")).toBe("https://codeload.github.com/geoly-ai/geoly-reddit/tar.gz/main");
+    });
+    it("uses env defaults in resolveGithubOptions", () => {
+        const prevRepo = process.env["SOCIAL_HUB_SKILLS_REPO"];
+        process.env["SOCIAL_HUB_SKILLS_REPO"] = "acme/skills-repo";
+        try {
+            const opts = resolveGithubOptions({});
+            expect(opts.repo).toBe("acme/skills-repo");
+            expect(opts.skillsSubpath).toContain("skills");
+        }
+        finally {
+            if (prevRepo === undefined)
+                delete process.env["SOCIAL_HUB_SKILLS_REPO"];
+            else
+                process.env["SOCIAL_HUB_SKILLS_REPO"] = prevRepo;
+        }
+    });
+    it("detects fresh cache metadata", () => {
+        expect(cacheIsFresh({
+            repo: "geoly-ai/geoly-reddit",
+            ref: "main",
+            skillsSubpath: "social-ops-hub/skills",
+            fetchedAt: new Date().toISOString(),
+            digest: "sha256:abc",
+            tarballUrl: "https://example.com",
+        })).toBe(true);
+    });
+    it("computes stable cache dir", () => {
+        expect(githubCacheDir("geoly-ai", "geoly-reddit", "main")).toContain("geoly-ai/geoly-reddit/main");
+    });
+});
+//# sourceMappingURL=github-source.test.js.map

package/dist/skills/github-source.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-source.test.js","sourceRoot":"","sources":["../../src/skills/github-source.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC;YACvD,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;QACH,MAAM,CAAC,eAAe,CAAC,gCAAgC,CAAC,CAAC,CAAC,OAAO,CAAC;YAChE,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAC/D,+DAA+D,CAChE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,GAAG,kBAAkB,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;;gBACpE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,GAAG,QAAQ,CAAC;QACxD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CACJ,YAAY,CAAC;YACX,IAAI,EAAE,uBAAuB;YAC7B,GAAG,EAAE,MAAM;YACX,aAAa,EAAE,uBAAuB;YACtC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,qBAAqB;SAClC,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAClE,4BAA4B,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/skills/install-planner.d.ts

@@ -0,0 +1,18 @@
+import type { InstallMethod, InstallPlan, InstallTarget, PlanAction, SkillSource } from "./types.js";
+export type PlannerOptions = {
+    action: PlanAction;
+    source: SkillSource;
+    targets: InstallTarget[];
+    skillIds?: string[];
+    method?: InstallMethod;
+    force?: boolean;
+    onlyManaged?: boolean;
+};
+export declare function buildInstallPlan(opts: PlannerOptions): InstallPlan;
+export declare function summarizePlan(plan: InstallPlan): {
+    install: number;
+    update: number;
+    remove: number;
+    skipped: number;
+};
+//# sourceMappingURL=install-planner.d.ts.map

package/dist/skills/install-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-planner.d.ts","sourceRoot":"","sources":["../../src/skills/install-planner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,UAAU,EACV,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAkFlE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAOA"}

package/dist/skills/install-planner.js

@@ -0,0 +1,91 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { hashSkillDir, resolveSkills } from "./manifest.js";
+import { readState } from "./state-store.js";
+export function buildInstallPlan(opts) {
+    const skills = resolveSkills(opts.source.skillsRoot, opts.source.manifest, opts.skillIds);
+    const method = opts.method ?? "copy";
+    const items = [];
+    const skipped = [];
+    for (const target of opts.targets) {
+        const state = readState(target.dir);
+        for (const skill of skills) {
+            const toDir = join(target.dir, skill.id);
+            const fromDir = skill.skillDir;
+            const exists = existsSync(toDir);
+            const managed = state?.skills.some((s) => s.id === skill.id) ?? false;
+            const checksum = hashSkillDir(fromDir);
+            const installed = state?.skills.find((s) => s.id === skill.id);
+            const needsUpdate = !installed || installed.checksum !== checksum || installed.skillVersion !== (skill.skillVersion ?? opts.source.version);
+            let action = opts.action;
+            if (action === "install" && exists && managed && needsUpdate) {
+                action = "update";
+            }
+            if (action === "update" && (!exists || !managed)) {
+                skipped.push({
+                    skillId: skill.id,
+                    targetDir: toDir,
+                    reason: !exists ? "not installed" : "not managed by social-hub",
+                });
+                continue;
+            }
+            if (action === "install" && exists && !managed && !opts.force) {
+                skipped.push({
+                    skillId: skill.id,
+                    targetDir: toDir,
+                    reason: "exists from unknown source (use --force)",
+                });
+                continue;
+            }
+            if (action === "install" && exists && managed && !needsUpdate) {
+                skipped.push({
+                    skillId: skill.id,
+                    targetDir: toDir,
+                    reason: "already up to date",
+                });
+                continue;
+            }
+            if (action === "update" && exists && managed && !needsUpdate) {
+                skipped.push({
+                    skillId: skill.id,
+                    targetDir: toDir,
+                    reason: "already up to date",
+                });
+                continue;
+            }
+            if (action === "remove") {
+                if (!exists) {
+                    skipped.push({ skillId: skill.id, targetDir: toDir, reason: "not installed" });
+                    continue;
+                }
+                if (!managed && !opts.force) {
+                    skipped.push({
+                        skillId: skill.id,
+                        targetDir: toDir,
+                        reason: "not managed by social-hub (use --force)",
+                    });
+                    continue;
+                }
+            }
+            items.push({
+                action,
+                skillId: skill.id,
+                target,
+                fromDir,
+                toDir,
+                method,
+                overwrite: opts.force ?? false,
+            });
+        }
+    }
+    return { source: opts.source, items, skipped };
+}
+export function summarizePlan(plan) {
+    return {
+        install: plan.items.filter((i) => i.action === "install" || i.action === "reinstall").length,
+        update: plan.items.filter((i) => i.action === "update").length,
+        remove: plan.items.filter((i) => i.action === "remove").length,
+        skipped: plan.skipped.length,
+    };
+}
+//# sourceMappingURL=install-planner.js.map

package/dist/skills/install-planner.js.map

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

package/dist/skills/install-planner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install-planner.test.d.ts.map

package/dist/skills/install-planner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-planner.test.d.ts","sourceRoot":"","sources":["../../src/skills/install-planner.test.ts"],"names":[],"mappings":""}

package/dist/skills/install-planner.test.js

@@ -0,0 +1,41 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { describe, expect, it } from "vitest";
+import { buildInstallPlan } from "./install-planner.js";
+import { resolveLocalSource } from "./source-resolver.js";
+describe("install-planner", () => {
+    it("plans install into custom directory", () => {
+        const root = join(tmpdir(), `social-hub-skills-test-${Date.now()}`);
+        mkdirSync(join(root, "demo-skill"), { recursive: true });
+        writeFileSync(join(root, "manifest.json"), JSON.stringify({
+            version: 1,
+            package: "test",
+            cliVersion: "0.0.3",
+            repository: "test",
+            skills: [{ id: "demo-skill", path: "demo-skill", description: "demo" }],
+        }));
+        writeFileSync(join(root, "demo-skill", "SKILL.md"), "---\nname: demo-skill\ndescription: demo\n---\n# Demo\n");
+        const source = resolveLocalSource(root);
+        const targetDir = join(root, "out");
+        const plan = buildInstallPlan({
+            action: "install",
+            source,
+            targets: [
+                {
+                    agentId: "custom",
+                    label: "Custom",
+                    dir: targetDir,
+                    scope: "project",
+                    installMode: "standalone",
+                },
+            ],
+            skillIds: ["demo-skill"],
+            method: "copy",
+        });
+        expect(plan.items).toHaveLength(1);
+        expect(plan.items[0]?.action).toBe("install");
+        expect(plan.items[0]?.toDir).toBe(join(targetDir, "demo-skill"));
+    });
+});
+//# sourceMappingURL=install-planner.test.js.map

package/dist/skills/install-planner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-planner.test.js","sourceRoot":"","sources":["../../src/skills/install-planner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,0BAA0B,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACpE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAC3B,IAAI,CAAC,SAAS,CAAC;YACb,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,OAAO;YACnB,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;SACxE,CAAC,CACH,CAAC;QACF,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,CAAC,EACpC,yDAAyD,CAC1D,CAAC;QAEF,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,gBAAgB,CAAC;YAC5B,MAAM,EAAE,SAAS;YACjB,MAAM;YACN,OAAO,EAAE;gBACP;oBACE,OAAO,EAAE,QAAQ;oBACjB,KAAK,EAAE,QAAQ;oBACf,GAAG,EAAE,SAAS;oBACd,KAAK,EAAE,SAAS;oBAChB,WAAW,EAAE,YAAY;iBAC1B;aACF;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;YACxB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/skills/installer.d.ts

@@ -0,0 +1,10 @@
+import type { InstallPlan, PlanItem } from "./types.js";
+export type ExecuteResult = {
+    applied: PlanItem[];
+    errors: {
+        item: PlanItem;
+        error: string;
+    }[];
+};
+export declare function executePlan(plan: InstallPlan): ExecuteResult;
+//# sourceMappingURL=installer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/skills/installer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAuB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC;IACpB,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7C,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAkB5D"}

package/dist/skills/installer.js

@@ -0,0 +1,108 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, symlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { hashSkillDir } from "./manifest.js";
+import { applyClaudePluginLayout } from "./marketplace-adapters/claude-plugin.js";
+import { mergeStateRecord, readState, writeState } from "./state-store.js";
+export function executePlan(plan) {
+    const applied = [];
+    const errors = [];
+    for (const item of plan.items) {
+        try {
+            if (item.action === "remove") {
+                removeSkill(item);
+            }
+            else {
+                installSkill(item, plan);
+            }
+            applied.push(item);
+        }
+        catch (e) {
+            errors.push({ item, error: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return { applied, errors };
+}
+function installSkill(item, plan) {
+    mkdirSync(dirname(item.toDir), { recursive: true });
+    if (existsSync(item.toDir)) {
+        rmSync(item.toDir, { recursive: true, force: true });
+    }
+    if (item.method === "symlink") {
+        symlinkSync(item.fromDir, item.toDir, "dir");
+    }
+    else {
+        copyDir(item.fromDir, item.toDir);
+    }
+    if (item.target.installMode === "plugin" && item.target.agentId === "claude-code") {
+        applyClaudePluginLayout(item.target.dir, plan.source.version);
+    }
+    const checksum = hashSkillDir(item.fromDir);
+    const state = readState(item.target.dir) ?? {
+        source: plan.source.kind,
+        package: "@geoly-ai/social-hub-cli",
+        version: plan.source.version,
+        sourceDigest: plan.source.digest,
+        installedAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        skills: [],
+    };
+    mergeStateRecord(state, {
+        id: item.skillId,
+        skillVersion: plan.source.version,
+        checksum,
+        targetAgent: item.target.agentId,
+        targetDir: item.toDir,
+        installMode: item.target.installMode,
+        installedFiles: listRelativeFiles(item.toDir),
+        updatedAt: new Date().toISOString(),
+    });
+    writeState(item.target.dir, state);
+}
+function removeSkill(item) {
+    if (existsSync(item.toDir)) {
+        rmSync(item.toDir, { recursive: true, force: true });
+    }
+    const state = readState(item.target.dir);
+    if (state) {
+        state.skills = state.skills.filter((s) => s.id !== item.skillId);
+        state.updatedAt = new Date().toISOString();
+        if (state.skills.length === 0) {
+            rmSync(stateFilePath(item.target.dir), { force: true });
+        }
+        else {
+            writeState(item.target.dir, state);
+        }
+    }
+}
+function stateFilePath(targetDir) {
+    return join(targetDir, ".social-hub-skills.json");
+}
+function copyDir(src, dest) {
+    mkdirSync(dest, { recursive: true });
+    for (const name of readdirSync(src)) {
+        const from = join(src, name);
+        const to = join(dest, name);
+        const st = statSync(from);
+        if (st.isDirectory()) {
+            copyDir(from, to);
+        }
+        else {
+            writeFileSync(to, readFileSync(from));
+        }
+    }
+}
+function listRelativeFiles(dir, base = dir) {
+    const out = [];
+    for (const name of readdirSync(dir)) {
+        const full = join(dir, name);
+        const st = statSync(full);
+        if (st.isDirectory()) {
+            out.push(...listRelativeFiles(full, base));
+        }
+        else {
+            out.push(full.slice(base.length + 1));
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=installer.js.map

package/dist/skills/installer.js.map

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

package/dist/skills/manifest.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedSkill, SkillsManifest } from "./types.js";
+export declare function parseFrontmatter(content: string): Record<string, string>;
+export declare function loadManifestFromDir(skillsRoot: string): SkillsManifest;
+export declare function validateManifest(manifest: SkillsManifest, skillsRoot: string): void;
+export declare function resolveSkills(skillsRoot: string, manifest: SkillsManifest, filterIds?: string[]): ResolvedSkill[];
+export declare function hashDirectory(dir: string): string;
+export declare function hashFile(path: string): string;
+export declare function hashSkillDir(skillDir: string): string;
+//# 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":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAsB,cAAc,EAAE,MAAM,YAAY,CAAC;AAIpF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxE;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAKtE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAoBnF;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,EACxB,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,aAAa,EAAE,CAMjB;AAkBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI7C;AAgBD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD"}