ghost-github-portfolio 0.2.0

package/README.md

@@ -0,0 +1,210 @@
+<p align="center">
+  <img src="docs/images/banner.svg" alt="Ghost GitHub Portfolio banner" width="900"/>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/ghost-github-portfolio"><img src="https://img.shields.io/npm/v/ghost-github-portfolio?style=flat-square&logo=npm" alt="npm"></a>
+  <a href="https://hub.docker.com/r/drumsergio/ghost-github-portfolio"><img src="https://img.shields.io/docker/pulls/drumsergio/ghost-github-portfolio?style=flat-square&logo=docker" alt="Docker Pulls"></a>
+  <a href="https://github.com/GeiserX/ghost-github-portfolio/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/GeiserX/ghost-github-portfolio/ci.yml?style=flat-square&logo=github&label=CI" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/GeiserX/ghost-github-portfolio?style=flat-square" alt="License"></a>
+  <a href="https://github.com/GeiserX/ghost-github-portfolio/stargazers"><img src="https://img.shields.io/github/stars/GeiserX/ghost-github-portfolio?style=flat-square&logo=github" alt="Stars"></a>
+</p>
+
+<p align="center"><strong>Auto-sync your GitHub repositories to a Ghost CMS portfolio page.</strong></p>
+
+---
+
+## What it does
+
+`ghost-github-portfolio` fetches your public GitHub repositories, sorts them by stars, generates beautiful portfolio cards with banners and badges, and pushes the result to a Ghost page via the Admin API.
+
+Run it daily via cron, GitHub Actions, or Docker to keep your portfolio always up to date.
+
+**Features:**
+
+- Fetches repos sorted by stars, filtered by configurable minimum
+- Auto-detects banner images (`docs/images/banner.svg`, `media/banner.svg`, etc.)
+- Dynamic shields.io badges (stars, forks, license, Docker pulls, website, awesome-list)
+- Per-repo overrides (custom description, badges, Docker image, tech stack)
+- Ghost lexical editor format (the current Ghost editor)
+- Dry-run mode for previewing changes
+- Runs as CLI, Docker container, or GitHub Action
+
+## Quick start
+
+### 1. Install
+
+```bash
+# npm (global)
+npm install -g ghost-github-portfolio
+
+# npx (no install)
+npx ghost-github-portfolio
+
+# Docker
+docker pull drumsergio/ghost-github-portfolio:0.2.0
+```
+
+### 2. Create a config
+
+```bash
+ghost-github-portfolio init
+```
+
+This generates a `config.yml` with all available options. Edit it with your GitHub username and Ghost API credentials.
+
+### 3. Get your Ghost Admin API key
+
+1. Go to your Ghost Admin panel > **Settings** > **Integrations**
+2. Create a new **Custom Integration**
+3. Copy the **Admin API Key** (format: `KEY_ID:SECRET`)
+
+### 4. Run
+
+```bash
+# Preview (no changes to Ghost)
+ghost-github-portfolio sync --config config.yml --dry-run --verbose
+
+# Sync to Ghost
+ghost-github-portfolio sync --config config.yml --verbose
+```
+
+## Configuration
+
+```yaml
+github:
+  username: YOUR_GITHUB_USERNAME
+  # token: ghp_xxx  # Optional: higher rate limits (env: GHOST_GITHUB_TOKEN)
+
+ghost:
+  url: https://your-ghost-blog.com
+  adminApiKey: "KEY_ID:SECRET_HEX"
+  pageSlug: portfolio   # or pageId: "hex_id"
+
+portfolio:
+  minStars: 2
+  maxRepos: 50
+  includeForked: false
+  badgeStyle: for-the-badge  # flat, flat-square, for-the-badge, plastic, social
+  showBanner: true
+  centerContent: true
+  defaultBannerPath: docs/images/banner.svg
+
+  bannerPaths:
+    awesome-spain: media/banner.svg  # Override per repo
+
+  excludeRepos:
+    - .github
+
+  repos:
+    my-project:
+      description: "Custom description"
+      dockerImage: myuser/my-project  # Adds Docker pulls badge
+      techStack: "Python, Docker, Redis"
+      badges:
+        - type: website
+          url: https://my-project.com
+        - type: awesome-list
+        - type: platform
+          label: macOS
+          logo: apple
+        - type: docs
+          url: https://docs.my-project.com
+        - type: custom
+          label: MCP
+          value: Official Registry
+          color: E6522C
+
+  footer:
+    showStats: true
+    showViewAll: true
+```
+
+### Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `GHOST_GITHUB_TOKEN` | GitHub token for private repos / higher rate limits |
+| `GHOST_ADMIN_API_KEY` | Ghost Admin API key (overrides config file) |
+
+## Docker
+
+```bash
+docker run --rm \
+  -v /path/to/config.yml:/config/config.yml \
+  drumsergio/ghost-github-portfolio:0.2.0
+```
+
+### Docker Compose (daily cron)
+
+```yaml
+services:
+  ghost-portfolio:
+    image: drumsergio/ghost-github-portfolio:0.2.0
+    volumes:
+      - ./config.yml:/config/config.yml:ro
+    # Run daily at 6 AM via external cron or restart policy
+```
+
+## GitHub Action
+
+Create `.github/workflows/portfolio.yml` in any repo:
+
+```yaml
+name: Update Portfolio
+
+on:
+  schedule:
+    - cron: "0 6 * * *"  # Daily at 6 AM UTC
+  workflow_dispatch:       # Manual trigger
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - run: npx ghost-github-portfolio sync --config config.yml --verbose
+        env:
+          GHOST_GITHUB_TOKEN: ${{ secrets.GHOST_GITHUB_TOKEN }}
+```
+
+Store `config.yml` in the repo (without secrets) and use environment variables for the API keys.
+
+## How it works
+
+1. **Fetches** all public repos for the configured GitHub user via the REST API
+2. **Filters** by minimum stars, excludes forks and blocklisted repos
+3. **Sorts** by star count (descending)
+4. **Detects** banner images by checking common paths (`docs/images/banner.svg`, `media/banner.svg`, etc.)
+5. **Generates** HTML cards with: banner, name, dynamic badges, description, tech stack
+6. **Composes** a Ghost lexical JSON document (the format Ghost's editor uses internally)
+7. **Updates** the target Ghost page via the Admin API with JWT authentication
+
+Badges are dynamic (served by shields.io) — stars, forks, and Docker pulls update automatically on every page view without re-running the tool.
+
+## Badge types
+
+| Type | Auto-detected | Description |
+|------|--------------|-------------|
+| Stars | Yes | Always shown |
+| Forks | Yes | Always shown |
+| License | Yes | From GitHub repo metadata |
+| Docker pulls | Config | Set `dockerImage` in repo overrides |
+| Website | Yes | From GitHub homepage field |
+| Awesome list | Yes | If repo has `awesome-list` topic |
+| Docs | Yes | If homepage is a GitHub Pages URL |
+| Platform | Config | Custom platform badge (macOS, Linux, etc.) |
+| Custom | Config | Any shields.io-compatible badge |
+
+## Roadmap
+
+See [docs/ROADMAP.md](docs/ROADMAP.md) for the full roadmap — themes, multi-CMS support, AI features, analytics, team portfolios, and more.
+
+## License
+
+[GPL-3.0](LICENSE)

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from "./types.js";
+export declare function loadConfig(path: string): Config;
+export declare function generateExampleConfig(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAmB,MAAM,YAAY,CAAC;AAgB1D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkD/C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAsD9C"}

package/dist/config.js

@@ -0,0 +1,116 @@
+import { readFileSync } from "node:fs";
+import { parse } from "yaml";
+const DEFAULT_PORTFOLIO = {
+    minStars: 2,
+    maxRepos: 50,
+    excludeRepos: [],
+    includeForked: false,
+    badgeStyle: "for-the-badge",
+    showBanner: true,
+    centerContent: true,
+    defaultBannerPath: "docs/images/banner.svg",
+    bannerPaths: {},
+    repos: {},
+    footer: { showStats: true, showViewAll: true },
+};
+export function loadConfig(path) {
+    const raw = readFileSync(path, "utf-8");
+    const parsed = parse(raw);
+    if (!parsed.github || !parsed.github.username) {
+        throw new Error("Config: github.username is required");
+    }
+    if (!parsed.ghost || !parsed.ghost.url) {
+        throw new Error("Config: ghost.url is required");
+    }
+    if (!parsed.ghost.adminApiKey) {
+        throw new Error("Config: ghost.adminApiKey is required");
+    }
+    const ghost = parsed.ghost;
+    if (!ghost.pageId && !ghost.pageSlug) {
+        throw new Error("Config: ghost.pageId or ghost.pageSlug is required");
+    }
+    const github = parsed.github;
+    const portfolio = (parsed.portfolio ?? {});
+    // Env var overrides (GHOST_GITHUB_TOKEN only — GITHUB_TOKEN is not used to
+    // avoid picking up unrelated tokens from gh CLI or CI environments)
+    const ghToken = github.token ?? process.env.GHOST_GITHUB_TOKEN;
+    const ghostKey = ghost.adminApiKey ?? process.env.GHOST_ADMIN_API_KEY;
+    return {
+        github: {
+            username: github.username,
+            token: ghToken,
+        },
+        ghost: {
+            url: ghost.url.replace(/\/$/, ""),
+            adminApiKey: ghostKey,
+            pageId: ghost.pageId,
+            pageSlug: ghost.pageSlug,
+        },
+        portfolio: {
+            ...DEFAULT_PORTFOLIO,
+            ...portfolio,
+            footer: { ...DEFAULT_PORTFOLIO.footer, ...portfolio.footer },
+            bannerPaths: {
+                ...DEFAULT_PORTFOLIO.bannerPaths,
+                ...portfolio.bannerPaths,
+            },
+            repos: { ...DEFAULT_PORTFOLIO.repos, ...portfolio.repos },
+        },
+    };
+}
+export function generateExampleConfig() {
+    return `# ghost-github-portfolio configuration
+github:
+  username: YOUR_GITHUB_USERNAME
+  # token: ghp_xxx  # Optional: for private repos or higher rate limits (env: GHOST_GITHUB_TOKEN)
+
+ghost:
+  url: https://your-ghost-blog.com
+  adminApiKey: "KEY_ID:SECRET_HEX"  # From Ghost Admin > Integrations (env: GHOST_ADMIN_API_KEY)
+  pageSlug: portfolio               # Update this page (or use pageId for the hex ID)
+
+portfolio:
+  minStars: 2          # Only show repos with at least this many stars
+  maxRepos: 50         # Maximum number of repos to display
+  includeForked: false # Skip forked repos
+  badgeStyle: for-the-badge  # shields.io style: flat, flat-square, for-the-badge, plastic, social
+  showBanner: true     # Show repo banner images (SVG/PNG from the repo)
+  centerContent: true  # Center project names and badges
+
+  defaultBannerPath: docs/images/banner.svg  # Default location to look for banners
+
+  # Override banner path for specific repos
+  bannerPaths:
+    # awesome-spain: media/banner.svg
+
+  excludeRepos:
+    - .github          # Profile config repo
+    # - my-private-project
+
+  # Per-repo overrides
+  repos: {}
+    # my-project:
+    #   description: "Custom description (overrides GitHub)"
+    #   dockerImage: drumsergio/my-project  # Adds Docker pulls badge
+    #   techStack: "Python, Docker, Redis"
+    #   bannerPath: assets/banner.png
+    #   badges:
+    #     - type: website
+    #       url: https://my-project.com
+    #     - type: awesome-list
+    #     - type: platform
+    #       label: macOS
+    #       logo: apple
+    #     - type: docs
+    #       url: https://docs.my-project.com
+    #     - type: custom
+    #       label: MCP
+    #       value: Official Registry
+    #       color: E6522C
+
+  footer:
+    showStats: true    # Show total stars and repo count
+    showViewAll: true  # Show "View All Repositories" link
+`;
+}
+//# 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,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAG7B,MAAM,iBAAiB,GAAoB;IACzC,QAAQ,EAAE,CAAC;IACX,QAAQ,EAAE,EAAE;IACZ,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,wBAAwB;IAC3C,WAAW,EAAE,EAAE;IACf,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;CAC/C,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAA4B,CAAC;IAErD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAE,MAAM,CAAC,MAAkC,CAAC,QAAQ,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAE,MAAM,CAAC,KAAiC,CAAC,GAAG,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,CAAE,MAAM,CAAC,KAAiC,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAgC,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAgC,CAAC;IACvD,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA6B,CAAC;IAEvE,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/D,MAAM,QAAQ,GACX,KAAK,CAAC,WAAsB,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAEnE,OAAO;QACL,MAAM,EAAE;YACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,OAAO;SACf;QACD,KAAK,EAAE;YACL,GAAG,EAAG,KAAK,CAAC,GAAc,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAC7C,WAAW,EAAE,QAAQ;YACrB,MAAM,EAAE,KAAK,CAAC,MAA4B;YAC1C,QAAQ,EAAE,KAAK,CAAC,QAA8B;SAC/C;QACD,SAAS,EAAE;YACT,GAAG,iBAAiB;YACpB,GAAG,SAAS;YACZ,MAAM,EAAE,EAAE,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE;YAC5D,WAAW,EAAE;gBACX,GAAG,iBAAiB,CAAC,WAAW;gBAChC,GAAG,SAAS,CAAC,WAAW;aACzB;YACD,KAAK,EAAE,EAAE,GAAG,iBAAiB,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE;SAC1D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC;AACF,CAAC"}

package/dist/generator.d.ts

@@ -0,0 +1,5 @@
+import type { Config, GitHubRepo, LexicalDocument } from "./types.js";
+export declare function generateCard(repo: GitHubRepo, bannerUrl: string | null, config: Config): string;
+export declare function generateFooter(repos: GitHubRepo[], config: Config): string | null;
+export declare function buildLexical(cards: string[], footer: string | null): LexicalDocument;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,eAAe,EAEhB,MAAM,YAAY,CAAC;AAyGpB,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,EAAE,MAAM,GACb,MAAM,CA0DR;AAuCD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAoDf;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,eAAe,CA0BjB"}

package/dist/generator.js

@@ -0,0 +1,204 @@
+function shieldsUrl(label, value, color, style, logo) {
+    const encoded = `${encodeURIComponent(label)}-${encodeURIComponent(value)}-${color}`;
+    let url = `https://img.shields.io/badge/${encoded}?style=${style}`;
+    if (logo)
+        url += `&logo=${logo}&logoColor=white`;
+    return url;
+}
+function buildBadges(repo, config) {
+    const style = config.portfolio.badgeStyle;
+    const overrides = config.portfolio.repos[repo.name];
+    const badges = [];
+    // Stars
+    badges.push(`<img src="https://img.shields.io/github/stars/${repo.full_name}?style=${style}" alt="Stars">`);
+    // Forks
+    badges.push(`<img src="https://img.shields.io/github/forks/${repo.full_name}?style=${style}" alt="Forks">`);
+    // License
+    if (repo.license) {
+        badges.push(`<img src="https://img.shields.io/github/license/${repo.full_name}?style=${style}" alt="License">`);
+    }
+    // Docker pulls (from config override)
+    const dockerImage = overrides?.dockerImage;
+    if (dockerImage) {
+        badges.push(`<a href="https://hub.docker.com/r/${dockerImage}"><img src="https://img.shields.io/docker/pulls/${dockerImage}?style=${style}" alt="Docker Pulls"></a>`);
+    }
+    // Website badge (from GitHub homepage or config)
+    const homepage = repo.homepage;
+    if (homepage &&
+        !homepage.includes("hub.docker.com") &&
+        !homepage.includes("github.io")) {
+        const domain = new URL(homepage).hostname;
+        badges.push(`<a href="${homepage}"><img src="${shieldsUrl("website", domain, "blue", style)}" alt="Website"></a>`);
+    }
+    // Custom badges from config
+    if (overrides?.badges) {
+        for (const badge of overrides.badges) {
+            badges.push(renderCustomBadge(badge, style));
+        }
+    }
+    // Auto-detect awesome-list from topics
+    if (repo.topics.includes("awesome-list") &&
+        !overrides?.badges?.some((b) => b.type === "awesome-list")) {
+        badges.push(`<img src="${shieldsUrl("awesome", "list", "fc60a8", style, "awesomelists")}" alt="Awesome List">`);
+    }
+    // Docs badge for GitHub Pages
+    if (homepage?.includes("github.io") &&
+        !overrides?.badges?.some((b) => b.type === "docs")) {
+        badges.push(`<a href="${homepage}"><img src="${shieldsUrl("docs", "online", "blue", style)}" alt="Docs"></a>`);
+    }
+    return badges;
+}
+function renderCustomBadge(badge, style) {
+    switch (badge.type) {
+        case "website":
+            return `<a href="${badge.url}"><img src="${shieldsUrl("website", badge.label ?? new URL(badge.url).hostname, badge.color ?? "blue", style)}" alt="Website"></a>`;
+        case "docker":
+            return `<a href="https://hub.docker.com/r/${badge.label}"><img src="https://img.shields.io/docker/pulls/${badge.label}?style=${style}" alt="Docker Pulls"></a>`;
+        case "awesome-list":
+            return `<img src="${shieldsUrl("awesome", "list", badge.color ?? "fc60a8", style, "awesomelists")}" alt="Awesome List">`;
+        case "platform":
+            return `<img src="${shieldsUrl("platform", badge.label ?? "unknown", badge.color ?? "000", style, badge.logo)}" alt="Platform">`;
+        case "docs":
+            return `<a href="${badge.url}"><img src="${shieldsUrl("docs", badge.label ?? "online", badge.color ?? "blue", style)}" alt="Docs"></a>`;
+        case "custom":
+            return `<img src="${shieldsUrl(badge.label ?? "", badge.value ?? "", badge.color ?? "grey", style, badge.logo)}" alt="${badge.label}">`;
+    }
+}
+export function generateCard(repo, bannerUrl, config) {
+    const overrides = config.portfolio.repos[repo.name];
+    const center = config.portfolio.centerContent;
+    const align = center ? ' style="text-align:center;"' : "";
+    const flexJustify = center ? " justify-content:center;" : "";
+    const parts = [];
+    // Banner
+    if (bannerUrl) {
+        parts.push(`<a href="${repo.html_url}" rel="noreferrer"${center ? ' style="display:block; text-align:center;"' : ""}>` +
+            `<img src="${bannerUrl}" alt="${repo.name} banner" style="width:100%; max-width:900px; border-radius:8px; margin-bottom:12px; display:block;${center ? " margin-left:auto; margin-right:auto;" : ""}">` +
+            `</a>`);
+    }
+    // Title
+    parts.push(`<h3${align}><a href="${repo.html_url}" rel="noreferrer">${repo.name}</a></h3>`);
+    // Badges
+    const badges = buildBadges(repo, config);
+    parts.push(`<div style="display:flex; gap:4px; align-items:center; flex-wrap:wrap;${flexJustify}">`, `  ${badges.join("\n  ")}`, `</div>`);
+    // Description
+    const description = overrides?.description ?? repo.description;
+    if (description) {
+        parts.push(`<p><em>${escapeHtml(description)}</em></p>`);
+    }
+    // Key features (from config only)
+    if (overrides?.keyFeatures?.length) {
+        parts.push(`<p><strong>Key Features:</strong></p>`);
+        parts.push(`<ul>`);
+        for (const feature of overrides.keyFeatures) {
+            parts.push(`<li>${escapeHtml(feature)}</li>`);
+        }
+        parts.push(`</ul>`);
+    }
+    // Tech stack
+    const techStack = overrides?.techStack ?? inferTechStack(repo);
+    if (techStack) {
+        parts.push(`<p><strong>Tech Stack:</strong>&nbsp;${escapeHtml(techStack)}</p>`);
+    }
+    // Separator
+    parts.push(`<hr>`);
+    return parts.join("\n");
+}
+function inferTechStack(repo) {
+    const languages = [];
+    if (repo.language)
+        languages.push(repo.language);
+    // Add relevant topics as tech
+    const techTopics = repo.topics.filter((t) => [
+        "docker",
+        "kubernetes",
+        "helm",
+        "nextjs",
+        "react",
+        "vue",
+        "svelte",
+        "fastapi",
+        "flask",
+        "express",
+        "nestjs",
+        "terraform",
+        "ansible",
+        "mcp",
+        "jellyfin",
+        "telegram",
+        "swift",
+        "macos",
+        "nodejs",
+    ].includes(t.toLowerCase()));
+    const topicLabels = techTopics.map((t) => t.charAt(0).toUpperCase() + t.slice(1));
+    const all = [...new Set([...languages, ...topicLabels])];
+    return all.length > 0 ? all.join(", ") : null;
+}
+export function generateFooter(repos, config) {
+    if (!config.portfolio.footer.showStats && !config.portfolio.footer.showViewAll)
+        return null;
+    const center = config.portfolio.centerContent;
+    const align = center ? ' style="text-align:center;"' : "";
+    const listStyle = center
+        ? ' style="list-style:none; padding:0; text-align:center;"'
+        : "";
+    const parts = [];
+    parts.push(`<h2${align}>GitHub Stats</h2>`);
+    if (config.portfolio.footer.showStats) {
+        const totalStars = repos.reduce((s, r) => s + r.stargazers_count, 0);
+        const totalRepos = repos.length;
+        const languages = [
+            ...new Set(repos.map((r) => r.language).filter(Boolean)),
+        ];
+        const focusAreas = [
+            ...new Set(repos.flatMap((r) => r.topics).filter(Boolean)),
+        ]
+            .slice(0, 8)
+            .map((t) => t.charAt(0).toUpperCase() + t.slice(1));
+        parts.push(`<ul${listStyle}>`);
+        parts.push(`<li><strong>Total Stars (featured):</strong>&nbsp;${totalStars}+</li>`);
+        parts.push(`<li><strong>Featured Repositories:</strong>&nbsp;${totalRepos}</li>`);
+        if (languages.length > 0) {
+            parts.push(`<li><strong>Primary Languages:</strong>&nbsp;${languages.join(", ")}</li>`);
+        }
+        if (focusAreas.length > 0) {
+            parts.push(`<li><strong>Focus Areas:</strong>&nbsp;${focusAreas.join(", ")}</li>`);
+        }
+        parts.push(`</ul>`);
+    }
+    if (config.portfolio.footer.showViewAll) {
+        parts.push(`<p${align}><a href="https://github.com/${config.github.username}?tab=repositories"><strong>View All Repositories &rarr;</strong></a></p>`);
+    }
+    return parts.join("\n");
+}
+export function buildLexical(cards, footer) {
+    const children = [];
+    // Opening separator
+    children.push({ type: "horizontalrule", version: 1 });
+    // Project cards
+    for (const card of cards) {
+        children.push({ type: "html", version: 1, html: card });
+    }
+    // Footer
+    if (footer) {
+        children.push({ type: "html", version: 1, html: footer });
+    }
+    return {
+        root: {
+            children,
+            direction: "ltr",
+            format: "",
+            indent: 0,
+            type: "root",
+            version: 1,
+        },
+    };
+}
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/ghost.d.ts

@@ -0,0 +1,12 @@
+import type { Config, LexicalDocument } from "./types.js";
+export declare function generateJwt(apiKey: string): string;
+interface GhostPage {
+    id: string;
+    updated_at: string;
+    title: string;
+    lexical: string;
+}
+export declare function fetchPage(config: Config): Promise<GhostPage>;
+export declare function updatePage(config: Config, pageId: string, updatedAt: string, lexical: LexicalDocument): Promise<GhostPage>;
+export {};
+//# sourceMappingURL=ghost.d.ts.map

package/dist/ghost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost.d.ts","sourceRoot":"","sources":["../src/ghost.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA6BlD;AAUD,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAqBlE;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CA0BpB"}

package/dist/ghost.js

@@ -0,0 +1,71 @@
+import { createHmac } from "node:crypto";
+import { fetchWithRetry } from "./http.js";
+export function generateJwt(apiKey) {
+    const [keyId, secretHex] = apiKey.split(":");
+    if (!keyId || !secretHex) {
+        throw new Error('Invalid Ghost Admin API key format. Expected "KEY_ID:SECRET_HEX"');
+    }
+    const secret = Buffer.from(secretHex, "hex");
+    const now = Math.floor(Date.now() / 1000);
+    const header = Buffer.from(JSON.stringify({ alg: "HS256", kid: keyId, typ: "JWT" }))
+        .toString("base64url")
+        .replace(/=+$/, "");
+    const payload = Buffer.from(JSON.stringify({ iat: now, exp: now + 300, aud: "/admin/" }))
+        .toString("base64url")
+        .replace(/=+$/, "");
+    const signature = createHmac("sha256", secret)
+        .update(`${header}.${payload}`)
+        .digest("base64url")
+        .replace(/=+$/, "");
+    return `${header}.${payload}.${signature}`;
+}
+function ghostHeaders(apiKey) {
+    return {
+        Authorization: `Ghost ${generateJwt(apiKey)}`,
+        "Content-Type": "application/json",
+        "User-Agent": "Mozilla/5.0 ghost-github-portfolio",
+    };
+}
+export async function fetchPage(config) {
+    const { url, adminApiKey, pageId, pageSlug } = config.ghost;
+    let endpoint;
+    if (pageId) {
+        endpoint = `${url}/ghost/api/admin/pages/${pageId}/`;
+    }
+    else {
+        endpoint = `${url}/ghost/api/admin/pages/slug/${pageSlug}/`;
+    }
+    const res = await fetchWithRetry(endpoint, {
+        headers: ghostHeaders(adminApiKey),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Ghost API error ${res.status}: ${body}`);
+    }
+    const data = (await res.json());
+    return data.pages[0];
+}
+export async function updatePage(config, pageId, updatedAt, lexical) {
+    const { url, adminApiKey } = config.ghost;
+    const endpoint = `${url}/ghost/api/admin/pages/${pageId}/`;
+    const body = {
+        pages: [
+            {
+                lexical: JSON.stringify(lexical),
+                updated_at: updatedAt,
+            },
+        ],
+    };
+    const res = await fetchWithRetry(endpoint, {
+        method: "PUT",
+        headers: ghostHeaders(adminApiKey),
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Ghost update error ${res.status}: ${text}`);
+    }
+    const data = (await res.json());
+    return data.pages[0];
+}
+//# sourceMappingURL=ghost.js.map

package/dist/ghost.js.map

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