rtfct 0.1.0

package/src/presets/github.ts

@@ -0,0 +1,194 @@
+/**
+ * GitHub Preset Resolution — Fetching Codices from the Cloud
+ *
+ * Enables downloading presets from GitHub repositories.
+ */
+
+import type { Preset, PresetFile } from "./index";
+
+export interface GitHubPresetRef {
+  owner: string;
+  repo: string;
+  ref: string; // branch, tag, or commit (default: main)
+}
+
+/**
+ * Parse a GitHub preset reference string.
+ * Formats:
+ *   - "owner/repo" -> uses "main" branch
+ *   - "owner/repo@branch" -> uses specified branch/tag/commit
+ */
+export const parseGitHubRef = (name: string): GitHubPresetRef | null => {
+  // Check for @ symbol for branch specification
+  const atIndex = name.indexOf("@");
+
+  let ownerRepo: string;
+  let ref = "main";
+
+  if (atIndex !== -1) {
+    ownerRepo = name.slice(0, atIndex);
+    ref = name.slice(atIndex + 1);
+    if (!ref) {
+      return null; // Invalid: "owner/repo@" with no branch
+    }
+  } else {
+    ownerRepo = name;
+  }
+
+  const parts = ownerRepo.split("/");
+  if (parts.length !== 2) {
+    return null;
+  }
+
+  const [owner, repo] = parts;
+  if (!owner || !repo) {
+    return null;
+  }
+
+  return { owner, repo, ref };
+};
+
+/**
+ * Fetch a file from GitHub raw content.
+ */
+const fetchGitHubFile = async (
+  ref: GitHubPresetRef,
+  path: string
+): Promise<string | null> => {
+  const url = `https://raw.githubusercontent.com/${ref.owner}/${ref.repo}/${ref.ref}/${path}`;
+
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      return null;
+    }
+    return await response.text();
+  } catch {
+    return null;
+  }
+};
+
+/**
+ * Fetch the directory listing from GitHub API.
+ */
+const fetchGitHubDirectory = async (
+  ref: GitHubPresetRef,
+  path: string = ""
+): Promise<string[]> => {
+  const url = `https://api.github.com/repos/${ref.owner}/${ref.repo}/contents/${path}?ref=${ref.ref}`;
+
+  try {
+    const response = await fetch(url, {
+      headers: {
+        Accept: "application/vnd.github.v3+json",
+        "User-Agent": "rtfct-cli",
+      },
+    });
+
+    if (!response.ok) {
+      return [];
+    }
+
+    const data = (await response.json()) as Array<{
+      type: string;
+      path: string;
+      name: string;
+    }>;
+
+    const files: string[] = [];
+
+    for (const item of data) {
+      if (item.type === "file") {
+        files.push(item.path);
+      } else if (item.type === "dir") {
+        // Recursively fetch directory contents
+        const subFiles = await fetchGitHubDirectory(ref, item.path);
+        files.push(...subFiles);
+      }
+    }
+
+    return files;
+  } catch {
+    return [];
+  }
+};
+
+/**
+ * Resolve a GitHub preset reference to a Preset object.
+ */
+export const resolveGitHubPreset = async (
+  name: string
+): Promise<{ success: true; preset: Preset } | { success: false; error: string }> => {
+  const ref = parseGitHubRef(name);
+
+  if (!ref) {
+    return {
+      success: false,
+      error: `Invalid GitHub preset format: ${name}. Use "owner/repo" or "owner/repo@branch".`,
+    };
+  }
+
+  // First, fetch the manifest.json
+  const manifestContent = await fetchGitHubFile(ref, "manifest.json");
+
+  if (!manifestContent) {
+    return {
+      success: false,
+      error: `Could not fetch manifest.json from ${name}. Ensure the repository exists and contains a valid preset.`,
+    };
+  }
+
+  let manifest: Preset["manifest"];
+  try {
+    manifest = JSON.parse(manifestContent);
+  } catch {
+    return {
+      success: false,
+      error: `Invalid manifest.json in ${name}. The file must be valid JSON.`,
+    };
+  }
+
+  // Validate manifest has required fields
+  if (!manifest.name || !manifest.version || !manifest.generated_paths) {
+    return {
+      success: false,
+      error: `Invalid manifest.json in ${name}. Missing required fields (name, version, generated_paths).`,
+    };
+  }
+
+  // Fetch all files in the repository (excluding manifest.json)
+  const allFiles = await fetchGitHubDirectory(ref);
+
+  if (allFiles.length === 0) {
+    return {
+      success: false,
+      error: `Could not fetch file list from ${name}. Check if the repository is accessible.`,
+    };
+  }
+
+  // Filter out manifest.json and fetch content for each file
+  const presetFiles: PresetFile[] = [];
+
+  for (const filePath of allFiles) {
+    // Skip manifest.json and hidden files
+    if (filePath === "manifest.json" || filePath.startsWith(".")) {
+      continue;
+    }
+
+    const content = await fetchGitHubFile(ref, filePath);
+    if (content !== null) {
+      presetFiles.push({
+        path: filePath,
+        content,
+      });
+    }
+  }
+
+  const preset: Preset = {
+    name: manifest.name,
+    manifest,
+    files: presetFiles,
+  };
+
+  return { success: true, preset };
+};

package/src/presets/index.ts

@@ -0,0 +1,154 @@
+/**
+ * The Preset System — Codex Resolution and Installation
+ *
+ * Resolves preset names to Codex content and writes them to projects.
+ */
+
+import { mkdir, writeFile } from "fs/promises";
+import { join } from "path";
+
+import { BASE_PRESET } from "./base";
+import { ZIG_PRESET } from "./zig";
+import { TYPESCRIPT_PRESET } from "./typescript";
+import { ELIXIR_PRESET } from "./elixir";
+import { parseGitHubRef, resolveGitHubPreset } from "./github";
+
+export interface PresetFile {
+  path: string;
+  content: string;
+}
+
+export interface Preset {
+  name: string;
+  manifest: {
+    name: string;
+    version: string;
+    description: string;
+    depends?: string[];
+    generated_paths: string[];
+  };
+  files: PresetFile[];
+}
+
+export type ResolveResult =
+  | { success: true; preset: Preset }
+  | { success: false; error: string };
+
+export type AsyncResolveResult = Promise<ResolveResult>;
+
+type BuiltInPresetName = "base" | "zig" | "typescript" | "elixir";
+
+const BUILT_IN_PRESETS: Record<BuiltInPresetName, Preset> = {
+  base: BASE_PRESET,
+  zig: ZIG_PRESET,
+  typescript: TYPESCRIPT_PRESET,
+  elixir: ELIXIR_PRESET,
+};
+
+// Re-export base preset for direct use by init command
+export { BASE_PRESET } from "./base";
+
+/**
+ * Resolve a preset name to a Preset object (synchronous, built-in only).
+ */
+export const resolvePresetSync = (name: string): ResolveResult => {
+  const lowerName = name.toLowerCase();
+
+  if (lowerName in BUILT_IN_PRESETS) {
+    return {
+      success: true,
+      preset: BUILT_IN_PRESETS[lowerName as BuiltInPresetName],
+    };
+  }
+
+  return {
+    success: false,
+    error: `Unknown built-in preset: ${name}. Available: base, zig, typescript, elixir`,
+  };
+};
+
+/**
+ * Resolve a preset name to a Preset object.
+ * Supports built-in presets, GitHub presets (owner/repo), and local presets.
+ */
+export const resolvePreset = async (name: string): AsyncResolveResult => {
+  const lowerName = name.toLowerCase();
+
+  // Check built-in presets first
+  if (lowerName in BUILT_IN_PRESETS) {
+    return {
+      success: true,
+      preset: BUILT_IN_PRESETS[lowerName as BuiltInPresetName],
+    };
+  }
+
+  // Check local paths (not yet supported)
+  if (name.startsWith("./") || name.startsWith("/")) {
+    return {
+      success: false,
+      error: `Local presets not yet supported: ${name}`,
+    };
+  }
+
+  // Check for GitHub preset format (owner/repo or owner/repo@branch)
+  if (name.includes("/")) {
+    const ref = parseGitHubRef(name);
+    if (ref) {
+      return await resolveGitHubPreset(name);
+    }
+    return {
+      success: false,
+      error: `Invalid GitHub preset format: ${name}. Use "owner/repo" or "owner/repo@branch".`,
+    };
+  }
+
+  return {
+    success: false,
+    error: `Unknown preset: ${name}. Available: base, zig, typescript, elixir, or use owner/repo for GitHub presets.`,
+  };
+};
+
+/**
+ * Write a preset to a project's .project/presets/ directory.
+ */
+export const writePreset = async (
+  projectDir: string,
+  preset: Preset
+): Promise<void> => {
+  const presetDir = join(projectDir, ".project", "presets", preset.name);
+
+  // Create the preset directory
+  await mkdir(presetDir, { recursive: true });
+
+  // Write the manifest
+  await writeFile(
+    join(presetDir, "manifest.json"),
+    JSON.stringify(preset.manifest, null, 2)
+  );
+
+  // Write all preset files
+  for (const file of preset.files) {
+    const filePath = join(presetDir, file.path);
+    const fileDir = join(filePath, "..");
+    await mkdir(fileDir, { recursive: true });
+    await writeFile(filePath, file.content);
+  }
+};
+
+/**
+ * Check if a preset is already installed in a project.
+ */
+export const isPresetInstalled = async (
+  projectDir: string,
+  presetName: string
+): Promise<boolean> => {
+  const presetDir = join(projectDir, ".project", "presets", presetName);
+
+  try {
+    const { stat } = await import("fs/promises");
+    const stats = await stat(presetDir);
+    return stats.isDirectory();
+  } catch {
+    return false;
+  }
+};