@tc9011/skills-manager 0.1.0

package/dist/commands/push.js

@@ -0,0 +1,54 @@
+// src/commands/push.ts
+import { AGENTS_DIR } from '../agents.js';
+import { ensureGitHubToken } from '../auth.js';
+import { CliError } from '../errors.js';
+import { pushSkills, getRepoRemoteUrl, ensureGitRepo, ensureRemote, createGitHubRepo, } from '../git-ops.js';
+import * as p from '@clack/prompts';
+export async function pushCommand(options) {
+    p.intro('skills-manager push');
+    // 1. Check auth
+    const token = await ensureGitHubToken();
+    // 2. Ensure ~/.agents is a git repo (auto-init if needed)
+    await ensureGitRepo(AGENTS_DIR);
+    // 3. Check for existing remote
+    const remote = await getRepoRemoteUrl(AGENTS_DIR);
+    // 4. If no remote, prompt user for repo and configure
+    if (!remote) {
+        const repo = await p.text({
+            message: 'Enter GitHub repo (owner/name):',
+            placeholder: 'e.g. tc9011/my-skills',
+        });
+        if (p.isCancel(repo)) {
+            p.cancel('Push cancelled.');
+            throw new CliError('Push cancelled by user.');
+        }
+        await ensureRemote(AGENTS_DIR, repo);
+        const shouldCreate = await p.confirm({
+            message: 'Create this repo on GitHub? (requires gh CLI)',
+        });
+        if (shouldCreate === true) {
+            createGitHubRepo(repo);
+        }
+    }
+    // 5. Push
+    const spinner = p.spinner();
+    spinner.start('Pushing skills to GitHub...');
+    try {
+        const result = await pushSkills(AGENTS_DIR, options.message, token);
+        spinner.stop(result.committed
+            ? 'Skills pushed successfully!'
+            : 'No changes to push — already up to date.');
+        // Warn about suspicious files that may contain secrets
+        if (result.suspiciousFiles?.length) {
+            p.note(`Suspicious files pushed: ${result.suspiciousFiles.join(', ')}
+Consider adding a .gitignore to ${AGENTS_DIR}.`, '⚠ Warning');
+        }
+    }
+    catch (err) {
+        spinner.stop('Push failed.');
+        p.cancel(String(err));
+        throw new CliError(String(err));
+    }
+    p.outro('Done!');
+}
+//# sourceMappingURL=push.js.map

package/dist/commands/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../src/commands/push.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA6B;IAC7D,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAE/B,gBAAgB;IAChB,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAExC,0DAA0D;IAC1D,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAEhC,+BAA+B;IAC/B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAElD,sDAAsD;IACtD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC;YACxB,OAAO,EAAE,iCAAiC;YAC1C,WAAW,EAAE,uBAAuB;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC5B,MAAM,IAAI,QAAQ,CAAC,yBAAyB,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAErC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;YACnC,OAAO,EAAE,+CAA+C;SACzD,CAAC,CAAC;QAEH,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,UAAU;IACV,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CACV,MAAM,CAAC,SAAS;YACd,CAAC,CAAC,6BAA6B;YAC/B,CAAC,CAAC,0CAA0C,CAC/C,CAAC;QAEF,uDAAuD;QACvD,IAAI,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;YACnC,CAAC,CAAC,IAAI,CACJ,4BAA4B,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;kCACnC,UAAU,GAAG,EACvC,WAAW,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACnB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+export interface SkillsManagerConfig {
+    lastLinkedAgents?: string[];
+}
+/**
+ * Returns the config file path: $XDG_CONFIG_HOME/skills-manager/config.json
+ * Falls back to ~/.config/skills-manager/config.json if XDG_CONFIG_HOME is unset.
+ */
+export declare function getConfigPath(): string;
+/**
+ * Reads the skills-manager config file.
+ * Returns an empty object if the file does not exist or is invalid JSON.
+ */
+export declare function readConfig(configPath?: string): SkillsManagerConfig;
+/**
+ * Writes a partial config update (merges with existing config).
+ * Creates the config directory if it does not exist.
+ */
+export declare function writeConfig(update: Partial<SkillsManagerConfig>, configPath?: string): void;

package/dist/config.js

@@ -0,0 +1,48 @@
+// src/config.ts
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+/**
+ * Returns the config file path: $XDG_CONFIG_HOME/skills-manager/config.json
+ * Falls back to ~/.config/skills-manager/config.json if XDG_CONFIG_HOME is unset.
+ */
+export function getConfigPath() {
+    const configHome = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
+    return join(configHome, 'skills-manager', 'config.json');
+}
+/**
+ * Reads the skills-manager config file.
+ * Returns an empty object if the file does not exist or is invalid JSON.
+ */
+export function readConfig(configPath) {
+    const filePath = configPath ?? getConfigPath();
+    if (!existsSync(filePath)) {
+        return {};
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            return {};
+        }
+        return parsed;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Writes a partial config update (merges with existing config).
+ * Creates the config directory if it does not exist.
+ */
+export function writeConfig(update, configPath) {
+    const filePath = configPath ?? getConfigPath();
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const existing = readConfig(filePath);
+    const merged = { ...existing, ...update };
+    writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAM7E;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC7E,OAAO,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAmB;IAC5C,MAAM,QAAQ,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAA6B,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoC,EAAE,UAAmB;IACnF,MAAM,QAAQ,GAAG,UAAU,IAAI,aAAa,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Custom error class for CLI-level failures.
+ * Thrown by command handlers instead of calling process.exit(1) directly,
+ * enabling testability. Caught at the top-level entrypoint.
+ */
+export declare class CliError extends Error {
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,13 @@
+// src/errors.ts
+/**
+ * Custom error class for CLI-level failures.
+ * Thrown by command handlers instead of calling process.exit(1) directly,
+ * enabling testability. Caught at the top-level entrypoint.
+ */
+export class CliError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CliError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAEhB;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF"}

package/dist/git-ops.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Build a clean GitHub HTTPS remote URL (no embedded credentials).
+ */
+export declare function buildRemoteUrl(repo: string): string;
+/**
+ * Scan a directory (non-recursive) for files that look like secrets.
+ * Returns an array of suspicious filenames.
+ */
+export declare function detectSuspiciousFiles(dir: string): string[];
+/**
+ * Ensure a .gitignore exists in the skills repo with sensible defaults.
+ * Appends missing entries without overwriting user content.
+ */
+export declare function ensureGitignore(dir: string): void;
+/**
+ * Get the remote URL of an existing repo (origin).
+ */
+export declare function getRepoRemoteUrl(dir: string): Promise<string | null>;
+/**
+ * Push: stage all changes, commit with timestamp, push to remote.
+ * Uses token transiently via in-memory authenticated URL — never persisted to .git/config.
+ */
+export declare function pushSkills(dir: string, message?: string, token?: string | null): Promise<{
+    committed: boolean;
+    pushed: boolean;
+    suspiciousFiles?: string[];
+}>;
+/**
+ * Pull: clone if not exists, pull if exists.
+ * Uses token transiently — after clone, resets remote to clean URL.
+ */
+export declare function pullSkills(dir: string, remoteUrl: string, token?: string | null): Promise<{
+    cloned: boolean;
+    pulled: boolean;
+}>;
+/**
+ * Ensure a directory is a git repository. If not, runs `git init`.
+ * Creates the directory if it doesn't exist.
+ */
+export declare function ensureGitRepo(dir: string): Promise<{
+    initialized: boolean;
+}>;
+/**
+ * Ensure origin remote is configured. If not, add it from the given repo slug.
+ * Returns the remote URL and whether it was newly added.
+ */
+export declare function ensureRemote(dir: string, repo: string): Promise<{
+    remoteUrl: string;
+    added: boolean;
+}>;
+/**
+ * Create a GitHub repository using the `gh` CLI.
+ * Throws if `gh` is not installed or the command fails.
+ */
+export declare function createGitHubRepo(repo: string, options?: {
+    isPublic?: boolean;
+}): void;

package/dist/git-ops.js

@@ -0,0 +1,272 @@
+// src/git-ops.ts
+import { simpleGit } from 'simple-git';
+import { existsSync, readdirSync, readFileSync, appendFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+/**
+ * Build a clean GitHub HTTPS remote URL (no embedded credentials).
+ */
+export function buildRemoteUrl(repo) {
+    return `https://github.com/${repo}.git`;
+}
+/** Patterns that suggest secret or credential files. */
+const SUSPICIOUS_PATTERNS = [
+    /^\.env/,
+    /\.key$/,
+    /\.pem$/,
+    /credentials/i,
+    /secret/i,
+    /token/i,
+];
+/**
+ * Scan a directory (non-recursive) for files that look like secrets.
+ * Returns an array of suspicious filenames.
+ */
+export function detectSuspiciousFiles(dir) {
+    try {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        return entries
+            .filter(e => e.isFile() && SUSPICIOUS_PATTERNS.some(p => p.test(e.name)))
+            .map(e => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/** Default patterns that should always be in .gitignore for a skills repo. */
+const GITIGNORE_DEFAULTS = ['.DS_Store'];
+/**
+ * Ensure a .gitignore exists in the skills repo with sensible defaults.
+ * Appends missing entries without overwriting user content.
+ */
+export function ensureGitignore(dir) {
+    const gitignorePath = join(dir, '.gitignore');
+    let existing = '';
+    if (existsSync(gitignorePath)) {
+        existing = readFileSync(gitignorePath, 'utf-8');
+    }
+    const lines = existing.split('\n').map(l => l.trim());
+    const missing = GITIGNORE_DEFAULTS.filter(p => !lines.includes(p));
+    if (missing.length > 0) {
+        const suffix = existing.endsWith('\n') || existing === '' ? '' : '\n';
+        appendFileSync(gitignorePath, suffix + missing.join('\n') + '\n', 'utf-8');
+    }
+}
+/**
+ * Build an authenticated URL for transient use (clone/push/pull).
+ * NEVER persist this — use only in-memory for git operations.
+ */
+function buildAuthUrl(cleanUrl, token) {
+    if (!token)
+        return cleanUrl;
+    // Insert token into https://github.com/... → https://x-access-token:TOKEN@github.com/...
+    return cleanUrl.replace('https://', `https://x-access-token:${token}@`);
+}
+/**
+ * Check if a git repo has uncommitted changes.
+ */
+async function _hasUncommittedChanges(dir) {
+    const git = simpleGit(dir);
+    const status = await git.status();
+    return !status.isClean();
+}
+/**
+ * Get the remote URL of an existing repo (origin).
+ */
+export async function getRepoRemoteUrl(dir) {
+    try {
+        const git = simpleGit(dir);
+        const remotes = await git.getRemotes(true);
+        const origin = remotes.find((r) => r.name === 'origin');
+        return origin?.refs.fetch ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the current branch name of a repo.
+ */
+async function getCurrentBranch(git) {
+    const branch = await git.branchLocal();
+    const current = branch.current || '';
+    // Detached HEAD: simple-git returns a commit hash or empty string.
+    // A valid branch name won't be a 7-40 char hex string.
+    if (!current || /^[0-9a-f]{7,40}$/.test(current)) {
+        return 'main';
+    }
+    return current;
+}
+/**
+ * Detect the remote's default branch (e.g. main vs master).
+ * Falls back to the local branch name if remote info unavailable.
+ */
+async function getRemoteDefaultBranch(git) {
+    try {
+        const raw = await git.raw(['remote', 'show', 'origin']);
+        const match = raw.match(/HEAD branch:\s*(\S+)/);
+        if (match?.[1])
+            return match[1];
+    }
+    catch {
+        // remote show may fail without network; ignore
+    }
+    return getCurrentBranch(git);
+}
+/**
+ * Push: stage all changes, commit with timestamp, push to remote.
+ * Uses token transiently via in-memory authenticated URL — never persisted to .git/config.
+ */
+export async function pushSkills(dir, message, token) {
+    const git = simpleGit(dir);
+    const msg = message ?? `backup: ${new Date().toISOString()}`;
+    // Warn about potential secrets before staging
+    const suspicious = detectSuspiciousFiles(dir);
+    // Stage all
+    // Ensure .gitignore has sensible defaults (.DS_Store etc.)
+    ensureGitignore(dir);
+    await git.add('-A');
+    // Check if anything to commit
+    const status = await git.status();
+    if (status.isClean()) {
+        return { committed: false, pushed: false, suspiciousFiles: suspicious.length > 0 ? suspicious : undefined };
+    }
+    // Commit
+    await git.commit(msg);
+    // Push — if token provided, temporarily set the remote URL with auth, then restore
+    const branch = await getCurrentBranch(git);
+    if (token) {
+        const remotes = await git.getRemotes(true);
+        const origin = remotes.find((r) => r.name === 'origin');
+        const cleanUrl = origin?.refs.push ?? origin?.refs.fetch ?? '';
+        if (!cleanUrl) {
+            throw new Error('No origin remote URL configured — cannot push with authentication.');
+        }
+        const authUrl = buildAuthUrl(cleanUrl, token);
+        try {
+            await git.remote(['set-url', 'origin', authUrl]);
+            await git.push('origin', branch);
+        }
+        finally {
+            // Always restore the clean URL
+            await git.remote(['set-url', 'origin', cleanUrl]);
+        }
+    }
+    else {
+        await git.push('origin', branch);
+    }
+    return { committed: true, pushed: true, suspiciousFiles: suspicious.length > 0 ? suspicious : undefined };
+}
+/**
+ * Pull: clone if not exists, pull if exists.
+ * Uses token transiently — after clone, resets remote to clean URL.
+ */
+export async function pullSkills(dir, remoteUrl, token) {
+    const isRepo = existsSync(join(dir, '.git'));
+    if (!isRepo) {
+        // Clone with auth URL, then reset remote to clean URL
+        const authUrl = buildAuthUrl(remoteUrl, token ?? null);
+        await simpleGit().clone(authUrl, dir);
+        if (token) {
+            // Reset remote to clean URL so token isn't persisted in .git/config
+            const git = simpleGit(dir);
+            await git.remote(['set-url', 'origin', remoteUrl]);
+        }
+        return { cloned: true, pulled: false };
+    }
+    // Pull latest — use remote's default branch (handles main vs master)
+    const git = simpleGit(dir);
+    const branch = await getRemoteDefaultBranch(git);
+    // If HEAD is detached, checkout the target branch first
+    const localBranch = await git.branchLocal();
+    if (!localBranch.current || /^[0-9a-f]{7,40}$/.test(localBranch.current)) {
+        await git.checkout(branch);
+    }
+    const doPull = async () => {
+        try {
+            await git.pull('origin', branch, { '--rebase': null });
+        }
+        catch (err) {
+            // If rebase conflicts, abort and give user a clear message
+            const msg = String(err);
+            if (msg.includes('CONFLICT') || msg.includes('could not apply')) {
+                try {
+                    await git.rebase(['--abort']);
+                }
+                catch { /* already clean */ }
+                throw new Error('Rebase conflict detected. Your local skills have diverged from the remote.\n'
+                    + 'To fix, cd into ~/.agents/ and resolve manually:\n'
+                    + '  cd ~/.agents\n'
+                    + '  git fetch origin\n'
+                    + `  git rebase origin/${branch}   # resolve conflicts, then git rebase --continue\n`
+                    + 'Or force-reset to remote (loses local changes):\n'
+                    + `  git reset --hard origin/${branch}`, { cause: err });
+            }
+            throw err;
+        }
+    };
+    if (token) {
+        const remotes = await git.getRemotes(true);
+        const origin = remotes.find((r) => r.name === 'origin');
+        const cleanUrl = origin?.refs.fetch ?? remoteUrl;
+        const authUrl = buildAuthUrl(cleanUrl, token);
+        try {
+            await git.remote(['set-url', 'origin', authUrl]);
+            await doPull();
+        }
+        finally {
+            await git.remote(['set-url', 'origin', cleanUrl]);
+        }
+    }
+    else {
+        await doPull();
+    }
+    return { cloned: false, pulled: true };
+}
+/**
+ * Ensure a directory is a git repository. If not, runs `git init`.
+ * Creates the directory if it doesn't exist.
+ */
+export async function ensureGitRepo(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    if (existsSync(join(dir, '.git'))) {
+        return { initialized: false };
+    }
+    const git = simpleGit(dir);
+    await git.init();
+    return { initialized: true };
+}
+/**
+ * Ensure origin remote is configured. If not, add it from the given repo slug.
+ * Returns the remote URL and whether it was newly added.
+ */
+export async function ensureRemote(dir, repo) {
+    const git = simpleGit(dir);
+    const remotes = await git.getRemotes(true);
+    const origin = remotes.find((r) => r.name === 'origin');
+    if (origin?.refs.fetch) {
+        return { remoteUrl: origin.refs.fetch, added: false };
+    }
+    const remoteUrl = buildRemoteUrl(repo);
+    await git.remote(['add', 'origin', remoteUrl]);
+    return { remoteUrl, added: true };
+}
+/**
+ * Create a GitHub repository using the `gh` CLI.
+ * Throws if `gh` is not installed or the command fails.
+ */
+export function createGitHubRepo(repo, options) {
+    const visibility = options?.isPublic ? '--public' : '--private';
+    try {
+        execSync(`gh repo create ${repo} ${visibility} --confirm`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (err) {
+        throw new Error(`Failed to create GitHub repository '${repo}': ${String(err)}`, { cause: err });
+    }
+}
+//# sourceMappingURL=git-ops.js.map

package/dist/git-ops.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { CliError } from './errors.js';
+import { pushCommand } from './commands/push.js';
+import { pullCommand } from './commands/pull.js';
+import { linkCommand } from './commands/link.js';
+const program = new Command();
+program
+    .name('skills-manager')
+    .description('Backup and restore AI agent skills to GitHub')
+    .version('0.1.0');
+program
+    .command('push')
+    .description('Push ~/.agents/ (skills + lock file) to GitHub')
+    .option('-m, --message <message>', 'Commit message')
+    .action(pushCommand);
+program
+    .command('pull')
+    .description('Pull ~/.agents/ (skills + lock file) from GitHub')
+    .option('-r, --repo <repo>', 'GitHub repo (owner/name)')
+    .option('--skip-link', 'Skip automatic agent linking after pull')
+    .action(pullCommand);
+program
+    .command('link')
+    .description('Create symlinks from canonical skills to agent directories')
+    .option('-a, --agents <agents...>', 'Agent IDs to link (default: from .skill-lock.json)')
+    .action(linkCommand);
+// Catch CliError from command handlers and exit with code 1
+program.parseAsync().catch((err) => {
+    if (err instanceof CliError) {
+        process.exit(1);
+    }
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,gBAAgB,CAAC;KACtB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gDAAgD,CAAC;KAC7D,MAAM,CAAC,yBAAyB,EAAE,gBAAgB,CAAC;KACnD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;KACvD,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;KAChE,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,4DAA4D,CAAC;KACzE,MAAM,CAAC,0BAA0B,EAAE,oDAAoD,CAAC;KACxF,MAAM,CAAC,WAAW,CAAC,CAAC;AAGvB,4DAA4D;AAC5D,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC1C,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/linker.d.ts

@@ -0,0 +1,23 @@
+export interface LinkResult {
+    skill: string;
+    status: 'created' | 'exists' | 'recreated' | 'skipped';
+    reason?: string;
+}
+/**
+ * Compute relative symlink target from linkPath to targetPath.
+ * This matches how vercel-labs/skills creates relative symlinks.
+ */
+export declare function computeRelativeSymlinkTarget(linkPath: string, targetPath: string): string;
+/**
+ * Create symlinks from agentSkillsDir/<skill> → canonicalDir/<skill>
+ * for each skill name in the list.
+ *
+ * @param canonicalDir - Absolute path to ~/.agents/skills/
+ * @param agentSkillsDir - Absolute path to agent's global skills dir
+ * @param skillNames - List of skill folder names to link
+ */
+export declare function createSkillSymlinks(canonicalDir: string, agentSkillsDir: string, skillNames: string[]): Promise<LinkResult[]>;
+/**
+ * Get all skill folder names from the canonical directory.
+ */
+export declare function listCanonicalSkills(canonicalDir: string): Promise<string[]>;

package/dist/linker.js

@@ -0,0 +1,78 @@
+// src/linker.ts
+import { symlink, lstat, readdir, mkdir, readlink, unlink } from 'node:fs/promises';
+import { join, relative, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Compute relative symlink target from linkPath to targetPath.
+ * This matches how vercel-labs/skills creates relative symlinks.
+ */
+export function computeRelativeSymlinkTarget(linkPath, targetPath) {
+    return relative(dirname(linkPath), targetPath);
+}
+/**
+ * Create symlinks from agentSkillsDir/<skill> → canonicalDir/<skill>
+ * for each skill name in the list.
+ *
+ * @param canonicalDir - Absolute path to ~/.agents/skills/
+ * @param agentSkillsDir - Absolute path to agent's global skills dir
+ * @param skillNames - List of skill folder names to link
+ */
+export async function createSkillSymlinks(canonicalDir, agentSkillsDir, skillNames) {
+    // Ensure agent dir exists
+    await mkdir(agentSkillsDir, { recursive: true });
+    const results = [];
+    for (const skill of skillNames) {
+        const canonicalPath = join(canonicalDir, skill);
+        const linkPath = join(agentSkillsDir, skill);
+        // Check skill exists in canonical
+        if (!existsSync(canonicalPath)) {
+            results.push({ skill, status: 'skipped', reason: `not found in ${canonicalDir}` });
+            continue;
+        }
+        // Check if symlink already exists
+        try {
+            const stats = await lstat(linkPath);
+            if (stats.isSymbolicLink()) {
+                // Verify the symlink points to the correct target
+                const expectedTarget = computeRelativeSymlinkTarget(linkPath, canonicalPath);
+                const actualTarget = await readlink(linkPath);
+                if (actualTarget === expectedTarget) {
+                    results.push({ skill, status: 'exists' });
+                    continue;
+                }
+                // Stale symlink — remove and recreate
+                await unlink(linkPath);
+                const target = computeRelativeSymlinkTarget(linkPath, canonicalPath);
+                await symlink(target, linkPath);
+                results.push({ skill, status: 'recreated', reason: `was pointing to ${actualTarget}` });
+                continue;
+            }
+            // Exists but not a symlink — skip to avoid overwriting
+            results.push({ skill, status: 'skipped', reason: 'path exists but is not a symlink' });
+            continue;
+        }
+        catch {
+            // Doesn't exist — good, we'll create it
+        }
+        // Create relative symlink
+        const target = computeRelativeSymlinkTarget(linkPath, canonicalPath);
+        await symlink(target, linkPath);
+        results.push({ skill, status: 'created' });
+    }
+    return results;
+}
+/**
+ * Get all skill folder names from the canonical directory.
+ */
+export async function listCanonicalSkills(canonicalDir) {
+    try {
+        const entries = await readdir(canonicalDir, { withFileTypes: true });
+        return entries
+            .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+            .map(e => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=linker.js.map

package/dist/linker.js.map

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