tempora-cli 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,47 @@
+# tempora-cli
+
+A fast, language-agnostic CLI that bootstraps your project from a curated vault of community templates — no setup, no guesswork.
+
+## Install
+
+```bash
+npm install -g tempora-cli
+```
+
+## Usage
+
+**Guided mode:**
+```bash
+tempora init
+```
+
+**Direct mode:**
+```bash
+tempora init next-tailwind my-app
+```
+
+**Scaffold into current folder:**
+```bash
+tempora init next-tailwind .
+```
+
+**Browse template info:**
+```bash
+tempora info next-tailwind
+```
+
+## Requirements
+
+- Node.js 18+
+- git
+- npm
+
+## Links
+
+- [Documentation](https://tempora.vercel.app)
+- [GitHub](https://github.com/DidIrb/tempora)
+- [npm](https://www.npmjs.com/package/tempora-cli)
+
+## License
+
+MIT © Tempora

package/dist/index.js

@@ -0,0 +1,372 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import { createRequire as createRequire2 } from "module";
+
+// src/commands/init.ts
+import ora from "ora";
+
+// src/utils/logger.ts
+import pc from "picocolors";
+var logger = {
+  info: (msg) => console.log(pc.cyan("  info ") + msg),
+  success: (msg) => console.log(pc.green("  \u2714 ") + msg),
+  warn: (msg) => console.log(pc.yellow("  warn ") + msg),
+  error: (msg) => console.error(pc.red("  \u2716 ") + msg),
+  log: (msg) => console.log("  " + msg)
+};
+
+// src/utils/versionCheck.ts
+import { createRequire } from "module";
+import pc2 from "picocolors";
+var require2 = createRequire(import.meta.url);
+var { version: current } = require2("../package.json");
+async function checkVersion() {
+  try {
+    const res = await fetch("https://registry.npmjs.org/tempora-cli/latest", {
+      signal: AbortSignal.timeout(3e3)
+    });
+    if (!res.ok) return;
+    const { version: latest } = await res.json();
+    if (!current || !latest || current === latest) return;
+    const [curMajor, curMinor] = current.split(".").map(Number);
+    const [latMajor, latMinor] = latest.split(".").map(Number);
+    const isMinorOrMajor = latMajor > curMajor || latMajor === curMajor && latMinor > curMinor;
+    if (!isMinorOrMajor) return;
+    console.log("");
+    console.log("  " + pc2.bgYellow(pc2.black(" UPDATE ")) + " " + pc2.dim(current) + " \u2192 " + pc2.green(pc2.bold(latest)));
+    console.log("  " + pc2.dim("Run: ") + pc2.cyan("npm install -g tempora-cli"));
+    console.log("  " + pc2.dim("https://www.npmjs.com/package/tempora-cli"));
+    console.log("");
+  } catch {
+  }
+}
+
+// src/utils/antiOverwrite.ts
+import fs from "fs";
+import path from "path";
+import inquirer from "inquirer";
+async function resolveTargetDir(directory) {
+  const target = path.resolve(process.cwd(), directory ?? ".");
+  if (!fs.existsSync(target)) {
+    return { targetDir: target, overwrite: false };
+  }
+  const entries = fs.readdirSync(target).filter((f) => f !== ".git" && f !== ".DS_Store");
+  if (entries.length === 0) {
+    return { targetDir: target, overwrite: false };
+  }
+  logger.warn(`Directory "${path.basename(target)}" is not empty.`);
+  const { proceed } = await inquirer.prompt([
+    {
+      type: "confirm",
+      name: "proceed",
+      message: "Proceeding may overwrite existing files. Continue?",
+      default: false
+    }
+  ]);
+  if (!proceed) {
+    logger.error("Aborted. No files were changed.");
+    return null;
+  }
+  return { targetDir: target, overwrite: true };
+}
+
+// src/utils/downloader.ts
+import fs2 from "fs";
+import path2 from "path";
+import { execSync } from "child_process";
+import { fileURLToPath } from "url";
+
+// src/config.ts
+var org = "DidIrb";
+var repo = "tempora";
+var branch = "main";
+var config = {
+  github: {
+    org,
+    repo,
+    branch,
+    apiBase: `https://api.github.com/repos/${org}/${repo}/contents`,
+    rawBase: `https://raw.githubusercontent.com/${org}/${repo}/${branch}`,
+    registryUrl: `https://raw.githubusercontent.com/${org}/${repo}/${branch}/registry.json`
+  },
+  docs: {
+    url: "https://tempora.dev/templates"
+  }
+};
+
+// src/utils/downloader.ts
+var __dirname = path2.dirname(fileURLToPath(import.meta.url));
+function findLocalTemplatesDir() {
+  let current2 = __dirname;
+  for (let i = 0; i < 6; i++) {
+    const candidate = path2.join(current2, "templates");
+    if (fs2.existsSync(candidate)) return candidate;
+    current2 = path2.dirname(current2);
+  }
+  return null;
+}
+function copyDirLocal(srcDir, destDir, overwrite) {
+  fs2.mkdirSync(destDir, { recursive: true });
+  for (const entry of fs2.readdirSync(srcDir, { withFileTypes: true })) {
+    const srcPath = path2.join(srcDir, entry.name);
+    const destPath = path2.join(destDir, entry.name);
+    if (entry.isDirectory()) {
+      copyDirLocal(srcPath, destPath, overwrite);
+    } else {
+      if (!overwrite && fs2.existsSync(destPath)) continue;
+      fs2.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+function cloneTemplateSparse(templatePath, targetDir, overwrite) {
+  const repoUrl = `https://github.com/${config.github.org}/${config.github.repo}.git`;
+  const tmpDir = path2.join(targetDir, ".tempora-tmp");
+  try {
+    execSync("git --version", { stdio: "pipe" });
+  } catch {
+    throw new Error(
+      "git is not installed or not available on your PATH.\nTempora requires git to download templates. Install it from https://git-scm.com and try again."
+    );
+  }
+  try {
+    fs2.mkdirSync(tmpDir, { recursive: true });
+    try {
+      execSync(`git clone --filter=blob:none --sparse --depth=1 ${repoUrl} .`, {
+        cwd: tmpDir,
+        stdio: "pipe"
+      });
+    } catch {
+      throw new Error(
+        "Could not connect to GitHub to download the template.\nCheck your internet connection and try again."
+      );
+    }
+    try {
+      execSync(`git sparse-checkout set ${templatePath}`, {
+        cwd: tmpDir,
+        stdio: "pipe"
+      });
+    } catch {
+      throw new Error(
+        `Failed to checkout template path "${templatePath}" from the repository.
+The template may have been moved or removed. Run "tempora init" to browse available templates.`
+      );
+    }
+    const clonedTemplatePath = path2.join(tmpDir, templatePath);
+    if (!fs2.existsSync(clonedTemplatePath)) {
+      throw new Error(`Template path "${templatePath}" not found in repository.`);
+    }
+    copyDirLocal(clonedTemplatePath, targetDir, overwrite);
+  } finally {
+    fs2.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+async function downloadTemplate(template, targetDir, overwrite, spinner) {
+  const localTemplatesDir = findLocalTemplatesDir();
+  if (localTemplatesDir) {
+    if (spinner) spinner.text = "Copying template from local...";
+    await new Promise((r) => setTimeout(r, 50));
+    const relativeParts = template.path.replace(/^templates\//, "").split("/");
+    const localSrc = path2.join(localTemplatesDir, ...relativeParts);
+    if (fs2.existsSync(localSrc)) {
+      copyDirLocal(localSrc, targetDir, overwrite);
+      return;
+    }
+  }
+  if (spinner) spinner.text = `Downloading ${template.name} from GitHub...`;
+  await new Promise((r) => setTimeout(r, 50));
+  cloneTemplateSparse(template.path, targetDir, overwrite);
+}
+
+// src/utils/postInstall.ts
+import path3 from "path";
+var DEFAULT_NEXT_STEPS = ["pnpm install", "pnpm dev"];
+function printPostInstall(template, targetDir) {
+  const isCwd = path3.resolve(targetDir) === path3.resolve(process.cwd());
+  const dirName = isCwd ? null : path3.basename(targetDir);
+  const steps = template.nextSteps ?? DEFAULT_NEXT_STEPS;
+  logger.log(`
+  ${template.description}
+`);
+  logger.log("  Next steps:\n");
+  if (dirName) {
+    logger.log(`    cd ${dirName}`);
+  }
+  for (const step of steps) {
+    logger.log(`    ${step}`);
+  }
+  logger.log("");
+}
+
+// src/utils/registry.ts
+import fs3 from "fs";
+import path4 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __dirname2 = path4.dirname(fileURLToPath2(import.meta.url));
+function loadRegistry() {
+  const registryPath = path4.resolve(__dirname2, "./registry.json");
+  if (!fs3.existsSync(registryPath)) {
+    throw new Error("Registry not found. Please rebuild the CLI with npm run build.");
+  }
+  const raw = fs3.readFileSync(registryPath, "utf-8");
+  return JSON.parse(raw);
+}
+
+// src/utils/guided.ts
+import inquirer2 from "inquirer";
+var MAX_RESULTS = 4;
+async function runGuidedSelection(registry) {
+  const languages = Object.keys(registry.byLanguage);
+  if (languages.length === 0) {
+    logger.error("No templates found in registry.");
+    logger.log(`Browse templates at ${config.docs.url}`);
+    return null;
+  }
+  const { language } = await inquirer2.prompt([{
+    type: "list",
+    name: "language",
+    message: "What language?",
+    choices: languages
+  }]);
+  const languageIds = registry.byLanguage[language] ?? [];
+  const availableCategories = Object.entries(registry.byCategory).filter(([, ids]) => ids.some((id) => languageIds.includes(id))).map(([cat]) => cat);
+  if (availableCategories.length === 0) {
+    logger.error(`No templates found for language: ${language}`);
+    logger.log(`Browse templates at ${config.docs.url}`);
+    return null;
+  }
+  const { category } = await inquirer2.prompt([{
+    type: "list",
+    name: "category",
+    message: "What category?",
+    choices: availableCategories
+  }]);
+  const categoryIds = registry.byCategory[category] ?? [];
+  const afterCategory = languageIds.filter((id) => categoryIds.includes(id));
+  const availableLibraries = Object.entries(registry.byLibrary).filter(([, ids]) => ids.some((id) => afterCategory.includes(id))).map(([lib]) => lib);
+  if (availableLibraries.length === 0) {
+    logger.error(`No templates found for ${language} / ${category}`);
+    logger.log(`Browse templates at ${config.docs.url}`);
+    return null;
+  }
+  const { library } = await inquirer2.prompt([{
+    type: "list",
+    name: "library",
+    message: "What library or framework?",
+    choices: availableLibraries
+  }]);
+  const libraryIds = registry.byLibrary[library] ?? [];
+  const matchedIds = afterCategory.filter((id) => libraryIds.includes(id));
+  if (matchedIds.length === 0) {
+    logger.error(`No templates found for ${language} / ${category} / ${library}`);
+    logger.log(`Browse templates at ${config.docs.url}`);
+    return null;
+  }
+  const hasMore = matchedIds.length > MAX_RESULTS;
+  const visibleIds = matchedIds.slice(0, MAX_RESULTS);
+  const choices = visibleIds.map((id) => ({
+    name: `${registry.templates[id].name} \u2014 ${registry.templates[id].description}`,
+    value: id
+  }));
+  if (hasMore) {
+    logger.log(`
+  Showing ${MAX_RESULTS} of ${matchedIds.length} templates.`);
+    logger.log(`  See all at ${config.docs.url}
+`);
+  }
+  const { templateId } = await inquirer2.prompt([{
+    type: "list",
+    name: "templateId",
+    message: "Pick a template:",
+    choices
+  }]);
+  return registry.templates[templateId] ?? null;
+}
+
+// src/commands/init.ts
+function registerInitCommand(program2) {
+  program2.command("init [template] [directory]").description("Scaffold a new project from a Tempora template").action(async (template, directory) => {
+    const spinner = ora();
+    try {
+      const registry = loadRegistry();
+      let resolvedTemplate = template;
+      let resolvedDirectory = directory;
+      if (!resolvedTemplate) {
+        const entry2 = await runGuidedSelection(registry);
+        if (!entry2) return;
+        resolvedTemplate = entry2.id;
+      }
+      const entry = registry.templates[resolvedTemplate];
+      if (!entry) {
+        logger.error(`Template "${resolvedTemplate}" not found.`);
+        logger.log(`Browse all templates at ${config.docs.url}`);
+        process.exit(1);
+      }
+      const result = await resolveTargetDir(resolvedDirectory);
+      if (!result) return;
+      const { targetDir, overwrite } = result;
+      await new Promise((r) => setTimeout(r, 100));
+      spinner.start();
+      await downloadTemplate(entry, targetDir, overwrite, spinner);
+      spinner.succeed(`${entry.name} scaffolded successfully!`);
+      printPostInstall(entry, targetDir);
+      await checkVersion();
+    } catch (err) {
+      spinner.stop();
+      logger.error(err instanceof Error ? err.message : "Something went wrong.");
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/info.ts
+function registerInfoCommand(program2) {
+  program2.command("info <template>").description("Show details about a specific template").action(async (template) => {
+    try {
+      const registry = loadRegistry();
+      const entry = registry.templates[template];
+      if (!entry) {
+        logger.error(`Template "${template}" not found.`);
+        logger.log("Run tempora init to browse available templates.");
+        process.exit(1);
+      }
+      logger.log("");
+      logger.log(`  ${entry.name}`);
+      logger.log(`  ${entry.description}`);
+      logger.log("");
+      logger.log(`  Language  ${entry.language}`);
+      logger.log(`  Category  ${entry.category}`);
+      logger.log(`  Library   ${entry.library}`);
+      logger.log(`  Version   ${entry.version}`);
+      logger.log(`  Tags      ${entry.tags.join(", ")}`);
+      logger.log("");
+      if (entry.nextSteps && entry.nextSteps.length > 0) {
+        logger.log("  Next steps after scaffolding:");
+        for (const step of entry.nextSteps) {
+          logger.log(`    ${step}`);
+        }
+        logger.log("");
+      }
+      await checkVersion();
+    } catch (err) {
+      logger.error(err instanceof Error ? err.message : "Something went wrong.");
+      process.exit(1);
+    }
+  });
+}
+
+// src/index.ts
+var require3 = createRequire2(import.meta.url);
+var { version } = require3("../package.json");
+var program = new Command();
+program.name("tempora").description("Scaffold projects from curated templates").version(version, "-v, --version", "Show the current version").addHelpText("after", `
+Examples:
+  $ tempora init next-tailwind my-app
+  $ tempora init next-tailwind .
+  $ tempora init
+  $ tempora info next-tailwind
+  `);
+registerInitCommand(program);
+registerInfoCommand(program);
+program.parse(process.argv);

package/dist/registry.json

@@ -0,0 +1,93 @@
+{
+  "version": "1.0.0",
+  "updatedAt": "2026-06-28T01:10:10.949Z",
+  "templates": {
+    "angular-starter": {
+      "id": "angular-starter",
+      "name": "Angular Starter",
+      "language": "typescript",
+      "category": "frontend",
+      "library": "angular",
+      "description": "Angular 17 standalone components with TypeScript and Angular CLI preconfigured.",
+      "tags": [
+        "angular",
+        "typescript",
+        "frontend",
+        "spa"
+      ],
+      "version": "1.0.0",
+      "nextSteps": [
+        "npm install",
+        "ng serve"
+      ],
+      "path": "templates/typescript/frontend/angular/angular-starter"
+    },
+    "next-tailwind": {
+      "id": "next-tailwind",
+      "name": "Next.js + Tailwind",
+      "language": "typescript",
+      "category": "frontend",
+      "library": "nextjs",
+      "description": "Next.js 14 app router with Tailwind CSS and Prettier preconfigured.",
+      "tags": [
+        "nextjs",
+        "tailwind",
+        "typescript",
+        "react"
+      ],
+      "version": "1.0.0",
+      "nextSteps": [
+        "pnpm install",
+        "pnpm dev"
+      ],
+      "path": "templates/typescript/frontend/nextjs/next-tailwind"
+    },
+    "nextjs-tailwind": {
+      "id": "nextjs-tailwind",
+      "name": "Next.js + Tailwind",
+      "language": "typescript",
+      "category": "fullstack",
+      "library": "tailwind",
+      "description": "Next.js 14 app router with Tailwind CSS and Prettier preconfigured.",
+      "tags": [
+        "nextjs",
+        "tailwind",
+        "typescript",
+        "react"
+      ],
+      "version": "1.0.0",
+      "nextSteps": [
+        "pnpm install",
+        "pnpm dev"
+      ],
+      "path": "templates/typescript/nextjs-tailwind"
+    }
+  },
+  "byLanguage": {
+    "typescript": [
+      "angular-starter",
+      "next-tailwind",
+      "nextjs-tailwind"
+    ]
+  },
+  "byCategory": {
+    "frontend": [
+      "angular-starter",
+      "next-tailwind"
+    ],
+    "fullstack": [
+      "nextjs-tailwind"
+    ]
+  },
+  "byLibrary": {
+    "angular": [
+      "angular-starter"
+    ],
+    "nextjs": [
+      "next-tailwind"
+    ],
+    "tailwind": [
+      "nextjs-tailwind"
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempora-cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Tempora CLI — scaffold projects from curated templates",
   "license": "MIT",
   "type": "module",
@@ -14,7 +14,8 @@
   "files": [
     "bin",
     "dist",
-    "registry.json"
+    "registry.json",
+    "README.md"
   ],
   "dependencies": {
     "chalk": "^5.3.0",

package/registry.json

@@ -0,0 +1,93 @@
+{
+  "version": "1.0.0",
+  "updatedAt": "2026-06-28T01:10:10.949Z",
+  "templates": {
+    "angular-starter": {
+      "id": "angular-starter",
+      "name": "Angular Starter",
+      "language": "typescript",
+      "category": "frontend",
+      "library": "angular",
+      "description": "Angular 17 standalone components with TypeScript and Angular CLI preconfigured.",
+      "tags": [
+        "angular",
+        "typescript",
+        "frontend",
+        "spa"
+      ],
+      "version": "1.0.0",
+      "nextSteps": [
+        "npm install",
+        "ng serve"
+      ],
+      "path": "templates/typescript/frontend/angular/angular-starter"
+    },
+    "next-tailwind": {
+      "id": "next-tailwind",
+      "name": "Next.js + Tailwind",
+      "language": "typescript",
+      "category": "frontend",
+      "library": "nextjs",
+      "description": "Next.js 14 app router with Tailwind CSS and Prettier preconfigured.",
+      "tags": [
+        "nextjs",
+        "tailwind",
+        "typescript",
+        "react"
+      ],
+      "version": "1.0.0",
+      "nextSteps": [
+        "pnpm install",
+        "pnpm dev"
+      ],
+      "path": "templates/typescript/frontend/nextjs/next-tailwind"
+    },
+    "nextjs-tailwind": {
+      "id": "nextjs-tailwind",
+      "name": "Next.js + Tailwind",
+      "language": "typescript",
+      "category": "fullstack",
+      "library": "tailwind",
+      "description": "Next.js 14 app router with Tailwind CSS and Prettier preconfigured.",
+      "tags": [
+        "nextjs",
+        "tailwind",
+        "typescript",
+        "react"
+      ],
+      "version": "1.0.0",
+      "nextSteps": [
+        "pnpm install",
+        "pnpm dev"
+      ],
+      "path": "templates/typescript/nextjs-tailwind"
+    }
+  },
+  "byLanguage": {
+    "typescript": [
+      "angular-starter",
+      "next-tailwind",
+      "nextjs-tailwind"
+    ]
+  },
+  "byCategory": {
+    "frontend": [
+      "angular-starter",
+      "next-tailwind"
+    ],
+    "fullstack": [
+      "nextjs-tailwind"
+    ]
+  },
+  "byLibrary": {
+    "angular": [
+      "angular-starter"
+    ],
+    "nextjs": [
+      "next-tailwind"
+    ],
+    "tailwind": [
+      "nextjs-tailwind"
+    ]
+  }
+}