pointfree-docs 0.1.0 → 0.2.0

package/dist/lib/repos.js

@@ -4,7 +4,7 @@
 import { simpleGit } from "simple-git";
 import { existsSync, mkdirSync } from "fs";
 import { join } from "path";
-import { PATHS } from "../config.js";
+import { PATHS, EXAMPLES_CONFIG, EPISODES_CONFIG } from "../config.js";
 /**
  * Clone a library repository (sparse checkout, docs only)
  */
@@ -34,6 +34,58 @@ export async function cloneLibrary(lib) {
     await repoGit.raw(["sparse-checkout", "set", ...lib.docsPaths]);
     console.log(`  ✓ Cloned ${lib.shortName}`);
 }
+/**
+ * Clone TCA examples (CaseStudies, SyncUps, etc.)
+ */
+export async function cloneExamples() {
+    const repoDir = join(PATHS.reposDir, EXAMPLES_CONFIG.name);
+    // Ensure repos directory exists
+    if (!existsSync(PATHS.reposDir)) {
+        mkdirSync(PATHS.reposDir, { recursive: true });
+    }
+    if (existsSync(repoDir)) {
+        console.log(`  Repository already exists: ${EXAMPLES_CONFIG.name}`);
+        return;
+    }
+    console.log(`  Cloning ${EXAMPLES_CONFIG.repo} (examples)...`);
+    const git = simpleGit();
+    // Sparse checkout: only download examples directories
+    await git.clone(`https://github.com/${EXAMPLES_CONFIG.repo}.git`, repoDir, [
+        "--depth",
+        "1",
+        "--filter=blob:none",
+        "--sparse",
+    ]);
+    const repoGit = simpleGit(repoDir);
+    // Set up sparse checkout to only get the examples folders
+    await repoGit.raw(["sparse-checkout", "init", "--cone"]);
+    await repoGit.raw(["sparse-checkout", "set", ...EXAMPLES_CONFIG.paths]);
+    console.log(`  ✓ Cloned examples`);
+}
+/**
+ * Clone episode code samples
+ */
+export async function cloneEpisodes() {
+    const repoDir = join(PATHS.reposDir, EPISODES_CONFIG.name);
+    // Ensure repos directory exists
+    if (!existsSync(PATHS.reposDir)) {
+        mkdirSync(PATHS.reposDir, { recursive: true });
+    }
+    if (existsSync(repoDir)) {
+        console.log(`  Repository already exists: ${EPISODES_CONFIG.name}`);
+        return;
+    }
+    console.log(`  Cloning ${EPISODES_CONFIG.repo} (episodes)...`);
+    console.log(`  ⚠ Note: This may take a while (350+ episodes)...`);
+    const git = simpleGit();
+    // Full clone with depth 1 and blob filter for efficiency
+    await git.clone(`https://github.com/${EPISODES_CONFIG.repo}.git`, repoDir, [
+        "--depth",
+        "1",
+        "--filter=blob:none",
+    ]);
+    console.log(`  ✓ Cloned episodes`);
+}
 /**
  * Update a library repository
  */
@@ -61,12 +113,78 @@ export async function updateLibrary(lib) {
         return false;
     }
 }
+/**
+ * Update examples repository
+ */
+export async function updateExamples() {
+    const repoDir = join(PATHS.reposDir, EXAMPLES_CONFIG.name);
+    if (!existsSync(repoDir)) {
+        console.log(`  Examples not found. Run 'pf-docs init --examples' first.`);
+        return false;
+    }
+    console.log(`  Updating examples...`);
+    const git = simpleGit(repoDir);
+    try {
+        const pullResult = await git.pull();
+        if (pullResult.summary.changes > 0) {
+            console.log(`  ✓ Updated examples (${pullResult.summary.changes} changes)`);
+            return true;
+        }
+        else {
+            console.log(`  ✓ Examples are up to date`);
+            return false;
+        }
+    }
+    catch (error) {
+        console.error(`  ✗ Failed to update examples:`, error);
+        return false;
+    }
+}
+/**
+ * Update episodes repository
+ */
+export async function updateEpisodes() {
+    const repoDir = join(PATHS.reposDir, EPISODES_CONFIG.name);
+    if (!existsSync(repoDir)) {
+        console.log(`  Episodes not found. Run 'pf-docs init --episodes' first.`);
+        return false;
+    }
+    console.log(`  Updating episodes...`);
+    const git = simpleGit(repoDir);
+    try {
+        const pullResult = await git.pull();
+        if (pullResult.summary.changes > 0) {
+            console.log(`  ✓ Updated episodes (${pullResult.summary.changes} changes)`);
+            return true;
+        }
+        else {
+            console.log(`  ✓ Episodes are up to date`);
+            return false;
+        }
+    }
+    catch (error) {
+        console.error(`  ✗ Failed to update episodes:`, error);
+        return false;
+    }
+}
 /**
  * Get all local paths to a library's docs
  */
 export function getDocsPaths(lib) {
     return lib.docsPaths.map((docsPath) => join(PATHS.reposDir, lib.name, docsPath));
 }
+/**
+ * Get all local paths to examples
+ */
+export function getExamplesPaths() {
+    return EXAMPLES_CONFIG.paths.map((path) => join(PATHS.reposDir, EXAMPLES_CONFIG.name, path));
+}
+/**
+ * Get local path to episodes
+ */
+export function getEpisodesPath() {
+    return join(PATHS.reposDir, EPISODES_CONFIG.name);
+}
 /**
  * Check if a library is cloned
  */
@@ -74,3 +192,17 @@ export function isLibraryCloned(lib) {
     const repoDir = join(PATHS.reposDir, lib.name);
     return existsSync(repoDir);
 }
+/**
+ * Check if examples are cloned
+ */
+export function areExamplesCloned() {
+    const repoDir = join(PATHS.reposDir, EXAMPLES_CONFIG.name);
+    return existsSync(repoDir);
+}
+/**
+ * Check if episodes are cloned
+ */
+export function areEpisodesCloned() {
+    const repoDir = join(PATHS.reposDir, EPISODES_CONFIG.name);
+    return existsSync(repoDir);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pointfree-docs",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI tool for searching Point-Free library documentation",
   "type": "module",
   "bin": {
@@ -33,10 +33,10 @@
   "license": "MIT",
   "dependencies": {
     "better-sqlite3": "^11.0.0",
+    "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "glob": "^10.3.0",
-    "simple-git": "^3.22.0",
-    "chalk": "^5.3.0"
+    "simple-git": "^3.22.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.9",