@lunora/cli 1.0.0-alpha.2 → 1.0.0-alpha.3

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { runCli } from './packem_shared/COMMANDS-1V_KEx35.mjs';
+import { runCli } from './packem_shared/COMMANDS-CHw4zOZ9.mjs';
 
 try {
   const code = await runCli();

package/dist/index.d.mts

@@ -572,14 +572,22 @@ interface InitCommandOptions {
   * and the auth-provider sub-select.
   */
   prompt?: Pick<OfferDeps, "multiSelect" | "select">;
+  /**
+  * Override the git ref (branch, tag, or commit) the default template source
+  * is fetched from. Takes precedence over the version-derived ref. Ignored
+  * when `source` or `from` is set.
+  */
+  ref?: string;
   /** Local registry root for the offer's `runAddCommand` (offline / tests). Mirrors `from` but for registry items. */
   registryFrom?: string;
   /** Override the remote registry source base for the offer (default `gh:anolilab/lunora/registry`). */
   registrySource?: string;
   /**
   * Override the remote source giget downloads from. Default:
-  * `gh:anolilab/lunora/templates/&lt;templateType>#v&lt;cliVersion>`. Tests
-  * typically use `from` instead to skip the network.
+  * `gh:anolilab/lunora/templates/&lt;templateType>#&lt;ref>`, where `&lt;ref>` is
+  * the `ref` option when set, else derived from the CLI version (pre-release
+  * channels → their branch, stable → `main`). Tests typically use `from`
+  * instead to skip the network.
   */
   source?: string;
   templateType?: Template;
@@ -707,6 +715,8 @@ interface AddCommandOptions {
   out?: string;
   /** Force-overwrite existing files (take the incoming copy) instead of skipping/conflicting. */
   overwrite?: boolean;
+  /** Override the git ref (branch, tag, or commit) items are fetched from (default: version-derived); appended to the `source` base when that is set. Ignored when `from` is set. */
+  ref?: string;
   /** Override the remote registry source base (default gh:anolilab/lunora/registry). */
   source?: string;
   /** Skip the package.json mutation confirmation prompt. */

package/dist/index.d.ts

@@ -572,14 +572,22 @@ interface InitCommandOptions {
   * and the auth-provider sub-select.
   */
   prompt?: Pick<OfferDeps, "multiSelect" | "select">;
+  /**
+  * Override the git ref (branch, tag, or commit) the default template source
+  * is fetched from. Takes precedence over the version-derived ref. Ignored
+  * when `source` or `from` is set.
+  */
+  ref?: string;
   /** Local registry root for the offer's `runAddCommand` (offline / tests). Mirrors `from` but for registry items. */
   registryFrom?: string;
   /** Override the remote registry source base for the offer (default `gh:anolilab/lunora/registry`). */
   registrySource?: string;
   /**
   * Override the remote source giget downloads from. Default:
-  * `gh:anolilab/lunora/templates/&lt;templateType>#v&lt;cliVersion>`. Tests
-  * typically use `from` instead to skip the network.
+  * `gh:anolilab/lunora/templates/&lt;templateType>#&lt;ref>`, where `&lt;ref>` is
+  * the `ref` option when set, else derived from the CLI version (pre-release
+  * channels → their branch, stable → `main`). Tests typically use `from`
+  * instead to skip the network.
   */
   source?: string;
   templateType?: Template;
@@ -707,6 +715,8 @@ interface AddCommandOptions {
   out?: string;
   /** Force-overwrite existing files (take the incoming copy) instead of skipping/conflicting. */
   overwrite?: boolean;
+  /** Override the git ref (branch, tag, or commit) items are fetched from (default: version-derived); appended to the `source` base when that is set. Ignored when `from` is set. */
+  ref?: string;
   /** Override the remote registry source base (default gh:anolilab/lunora/registry). */
   source?: string;
   /** Skip the package.json mutation confirmation prompt. */

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { COMMANDS, VERSION, runCli } from './packem_shared/COMMANDS-1V_KEx35.mjs';
+export { COMMANDS, VERSION, runCli } from './packem_shared/COMMANDS-CHw4zOZ9.mjs';
 export { runCodegenCommand } from './packem_chunks/runCodegenCommand.mjs';
 export { DEFAULT_IMPORT_BATCH_SIZE, runExportCommand, runImportCommand } from './packem_shared/DEFAULT_IMPORT_BATCH_SIZE-Ck-2bU08.mjs';
 export { runDeployCommand } from './packem_chunks/runDeployCommand.mjs';
@@ -16,4 +16,4 @@ export { createRecordingSpawner, defaultSpawner } from './packem_shared/defaultS
 export { default as parseManifest } from './packem_shared/parseManifest--vZf2FY1.mjs';
 export { REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, validateWranglerProject as validateWrangler, validateWranglerConfig } from '@lunora/config';
 export { buildRegistryIndex } from './packem_shared/buildRegistryIndex-BcYe607_.mjs';
-export { runAddCommand, runBuildIndexCommand, runRegistryViewCommand } from './packem_shared/runAddCommand-BZGkRnBs.mjs';
+export { r as runAddCommand, a as runBuildIndexCommand, b as runRegistryViewCommand } from './packem_shared/commands-DIQ3nf0C.mjs';

package/dist/packem_chunks/handler.mjs

@@ -3,7 +3,7 @@ import { findWranglerFile, promptSelect } from '@lunora/config';
 import { join } from '@visulima/path';
 import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
 import { n as normalizeFeature, E as EMAIL_ITEM, D as DEFAULT_AUTH_ITEM, p as promptAuthProvider, A as AUTH_PROVIDER_OPTIONS } from '../packem_shared/features-ocSSpZtS.mjs';
-import { runAddCommand } from '../packem_shared/runAddCommand-BZGkRnBs.mjs';
+import { r as runAddCommand } from '../packem_shared/commands-DIQ3nf0C.mjs';
 
 const providerToItem = (provider) => {
   const value = provider.trim().toLowerCase();
@@ -54,6 +54,7 @@ const runAddFeature = async (options) => {
     from: options.from,
     logger: options.logger,
     names: [...items],
+    ref: options.ref,
     source: options.source,
     yes: true
   });
@@ -67,6 +68,7 @@ const execute = defineHandler(async ({ argument, cwd, logger, options }) => {
     from: options.from,
     logger,
     provider: options.provider,
+    ref: options.ref,
     source: options.source,
     yes: options.yes === true
   });

package/dist/packem_chunks/handler16.mjs

@@ -1,5 +1,5 @@
 import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
-import { runAddCommand, runRegistryViewCommand, runBuildIndexCommand } from '../packem_shared/runAddCommand-BZGkRnBs.mjs';
+import { r as runAddCommand, b as runRegistryViewCommand, a as runBuildIndexCommand } from '../packem_shared/commands-DIQ3nf0C.mjs';
 
 const execute = defineHandler(({ argument, cwd, logger, options }) => {
   const subcommand = argument[0];
@@ -15,12 +15,13 @@ const execute = defineHandler(({ argument, cwd, logger, options }) => {
       logger,
       names,
       overwrite: options.overwrite === true,
+      ref: options.ref,
       source: options.source,
       yes: options.yes === true
     });
   }
   if (subcommand === "list") {
-    return runAddCommand({ cwd, from: options.from, json: options.json === true, list: true, logger, names: [], source: options.source });
+    return runAddCommand({ cwd, from: options.from, json: options.json === true, list: true, logger, names: [], ref: options.ref, source: options.source });
   }
   if (subcommand === "view") {
     return runRegistryViewCommand({
@@ -28,6 +29,7 @@ const execute = defineHandler(({ argument, cwd, logger, options }) => {
       from: options.from,
       logger,
       names,
+      ref: options.ref,
       source: options.source
     });
   }

package/dist/packem_chunks/runInitCommand.mjs

@@ -1,6 +1,5 @@
 import { existsSync, mkdirSync, writeFileSync, readdirSync, mkdtempSync, rmSync, readFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { fileURLToPath } from 'node:url';
 import { detectFramework as detectFramework$1, isInteractive, promptSelect, promptMultiSelect } from '@lunora/config';
 import { walkSync } from '@visulima/fs';
 import { resolve, join as join$1, relative, dirname as dirname$1 } from '@visulima/path';
@@ -9,8 +8,8 @@ import { join, dirname } from 'node:path';
 import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
 import MagicString from 'magic-string';
 import { Project, SyntaxKind } from 'ts-morph';
+import { c as resolveSourceRef, r as runAddCommand } from '../packem_shared/commands-DIQ3nf0C.mjs';
 import { p as promptAuthProvider, E as EMAIL_ITEM } from '../packem_shared/features-ocSSpZtS.mjs';
-import { runAddCommand } from '../packem_shared/runAddCommand-BZGkRnBs.mjs';
 
 const GITHUB_CONTENT = `name: Deploy
 
@@ -324,32 +323,6 @@ export const send = mutation
     });
 `;
 const DEFAULT_SOURCE_BASE = "gh:anolilab/lunora/templates";
-const DEFAULT_SOURCE_REF_FALLBACK = "alpha";
-const resolveCliVersion = () => {
-  try {
-    let directory = dirname$1(fileURLToPath(import.meta.url));
-    for (let index = 0; index < 5; index += 1) {
-      const candidate = join$1(directory, "package.json");
-      if (existsSync(candidate)) {
-        const parsed = JSON.parse(readFileSync(candidate, "utf8"));
-        if (parsed.name === "@lunora/cli" && typeof parsed.version === "string") {
-          return parsed.version;
-        }
-      }
-      const parent = dirname$1(directory);
-      if (parent === directory) {
-        break;
-      }
-      directory = parent;
-    }
-  } catch {
-  }
-  return "0.0.0";
-};
-const resolveDefaultSourceRef = () => {
-  const version = resolveCliVersion();
-  return version === "0.0.0" ? DEFAULT_SOURCE_REF_FALLBACK : `v${version}`;
-};
 const isTextFile = (filePath) => {
   const lastDot = filePath.lastIndexOf(".");
   if (lastDot === -1) {
@@ -383,11 +356,11 @@ const copyTemplate = (sourceDirectory, target, name) => {
   }
   return written;
 };
-const resolveTemplateSource = (templateType, source) => {
+const resolveTemplateSource = (templateType, source, ref) => {
   if (source !== void 0 && source.length > 0) {
     return source;
   }
-  return `${DEFAULT_SOURCE_BASE}/${templateType}#${resolveDefaultSourceRef()}`;
+  return `${DEFAULT_SOURCE_BASE}/${templateType}#${resolveSourceRef(ref)}`;
 };
 const isSafeSource = (source) => {
   if (source.includes("..")) {
@@ -412,11 +385,12 @@ const scaffoldFromLocal = (fromRoot, templateType, target, name, logger) => {
   logScaffoldSuccess(logger, written, target, name);
   return { code: 0, files: written, target };
 };
-const scaffoldFromRemote = async (source, templateType, target, name, logger) => {
+const scaffoldFromRemote = async (options) => {
+  const { logger, name, ref, source, target, templateType } = options;
   const stagingRoot = mkdtempSync(join$1(tmpdir(), "lunora-init-fetch-"));
   const stagingDirectory = join$1(stagingRoot, "template");
   try {
-    const remote = resolveTemplateSource(templateType, source);
+    const remote = resolveTemplateSource(templateType, source, ref);
     logger.info(`fetching template from ${remote}`);
     const downloaded = await downloadTemplate(remote, {
       cwd: stagingRoot,
@@ -566,6 +540,7 @@ const maybeOfferExtras = async (options, projectDirectory) => {
       from: options.registryFrom,
       logger: options.logger,
       names: [...names],
+      ref: options.ref,
       source: options.registrySource,
       yes: true
     });
@@ -607,7 +582,7 @@ const scaffoldNewProject = async (options, cwd) => {
     );
     return { code: 1, files: [], target };
   }
-  return scaffoldFromRemote(options.source, templateType, target, name, options.logger);
+  return scaffoldFromRemote({ logger: options.logger, name, ref: options.ref, source: options.source, target, templateType });
 };
 const runInitCommand = async (options) => {
   const cwd = options.cwd ?? process.cwd();
@@ -643,10 +618,11 @@ const execute = defineHandler(({ argument, cwd, logger, options }) => {
     interactive: options.interactive === true ? true : void 0,
     logger,
     name: argument[0],
+    ref: options.ref,
     source: options.source,
     templateType: template,
     yes: options.yes === true
   });
 });
 
-export { execute, isTemplate, runInitCommand };
+export { execute, isTemplate, resolveTemplateSource, runInitCommand };

package/dist/packem_shared/{COMMANDS-1V_KEx35.mjs → COMMANDS-CHw4zOZ9.mjs}

@@ -15,7 +15,8 @@ const addCommand = {
     ["lunora add auth --provider clerk", "Add Clerk auth without prompting"],
     ["lunora add email", "Add transactional email (Cloudflare Email Workers + dev mail catcher)"],
     ["lunora add storage", "Add the R2 storage registry item"],
-    ["lunora add crons", "Add the scheduled-jobs registry item"]
+    ["lunora add crons", "Add the scheduled-jobs registry item"],
+    ["lunora add storage --ref alpha", "Add an item from the alpha branch's registry"]
   ],
   group: "Project",
   loader: () => import('../packem_chunks/handler.mjs').then((m) => {
@@ -27,6 +28,11 @@ const addCommand = {
     { description: "Skip the provider prompt and use the default (email & password)", name: "yes", type: Boolean },
     { description: "Local registry root (offline; expects <name>/ subdirs)", name: "from", type: String },
     { description: "Override the remote registry source base (e.g. gh:owner/repo/registry)", name: "source", type: String },
+    {
+      description: "Fetch items from a git ref (branch, tag, or commit), e.g. --ref alpha. Overrides the version-derived default",
+      name: "ref",
+      type: String
+    },
     { description: "Permit --source values outside gh:/github:/https://", name: "allow-unsafe-source", type: Boolean }
   ]
 };
@@ -342,6 +348,7 @@ const initCommand = {
     ["lunora init my-app", "Scaffold with the default (vite) template"],
     ["lunora init my-app -t tanstack-start-react", "Scaffold a TanStack Start (React) app"],
     ["lunora init my-app -t tanstack-start-solid", "Scaffold a TanStack Start (Solid) app"],
+    ["lunora init my-app --ref alpha", "Scaffold from the alpha branch's templates"],
     ["lunora init --here", "Add Lunora to the current project"],
     ["lunora init my-app --ci github", "Scaffold + add a GitHub Actions deploy pipeline"],
     ["lunora init my-app --ci gitlab", "Scaffold + add a GitLab CI deploy pipeline"]
@@ -369,6 +376,11 @@ const initCommand = {
       name: "source",
       type: String
     },
+    {
+      description: "Fetch templates from a git ref (branch, tag, or commit), e.g. --ref alpha. Overrides the version-derived default",
+      name: "ref",
+      type: String
+    },
     {
       description: "Permit --source values outside gh:/github:/https:// (e.g. local file://)",
       name: "allow-unsafe-source",
@@ -541,6 +553,11 @@ const registryCommand = {
     { description: "add: skip the package.json mutation confirmation prompt", name: "yes", type: Boolean },
     { description: "Local registry root (offline; expects <name>/ subdirs)", name: "from", type: String },
     { description: "Override the remote registry source base (e.g. gh:owner/repo/registry)", name: "source", type: String },
+    {
+      description: "Fetch items from a git ref (branch, tag, or commit), e.g. --ref alpha. Overrides the version-derived default",
+      name: "ref",
+      type: String
+    },
     { description: "Permit --source values outside gh:/github:/https://", name: "allow-unsafe-source", type: Boolean },
     { description: "Emit JSON output (add plan / list)", name: "json", type: Boolean },
     { description: "build: output path for the catalog (default <root>/index.json)", name: "out", type: String },

package/dist/packem_shared/{runAddCommand-BZGkRnBs.mjs → commands-DIQ3nf0C.mjs}

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync, mkdtempSync, rmSync } from 'node:fs';
-import { join, dirname } from '@visulima/path';
+import { dirname, join } from '@visulima/path';
 import { DEV_VARS_FILE, parseDevVariableEntries, promptYesNo } from '@lunora/config';
 import { modify, applyEdits, parse } from 'jsonc-parser';
 import { collectCatalog, buildRegistryIndex } from './buildRegistryIndex-BcYe607_.mjs';
@@ -7,8 +7,59 @@ import { insertSchemaExtension } from './insertSchemaExtension-BuzF6-t2.mjs';
 import { createHash } from 'node:crypto';
 import { tmpdir } from 'node:os';
 import { downloadTemplate } from 'giget';
+import { fileURLToPath } from 'node:url';
 import parseManifest from './parseManifest--vZf2FY1.mjs';
 
+const DEFAULT_SOURCE_REF_FALLBACK = "alpha";
+const STABLE_BRANCH = "main";
+const PRERELEASE_CHANNEL_BRANCHES = /* @__PURE__ */ new Set(["alpha", "beta", "next"]);
+const SAFE_REF = /^[\w./@-]+$/;
+const isSafeRef = (ref) => !ref.includes("..") && SAFE_REF.test(ref);
+const resolveCliVersion = () => {
+  try {
+    let directory = dirname(fileURLToPath(import.meta.url));
+    for (let index = 0; index < 6; index += 1) {
+      const candidate = join(directory, "package.json");
+      if (existsSync(candidate)) {
+        const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+        if (parsed.name === "@lunora/cli" && typeof parsed.version === "string") {
+          return parsed.version;
+        }
+      }
+      const parent = dirname(directory);
+      if (parent === directory) {
+        break;
+      }
+      directory = parent;
+    }
+  } catch {
+  }
+  return "0.0.0";
+};
+const resolveVersionRef = (version) => {
+  if (version === "0.0.0") {
+    return DEFAULT_SOURCE_REF_FALLBACK;
+  }
+  const core = version.split("+")[0] ?? version;
+  const dashIndex = core.indexOf("-");
+  if (dashIndex !== -1) {
+    const [channel] = core.slice(dashIndex + 1).split(".");
+    if (channel !== void 0 && PRERELEASE_CHANNEL_BRANCHES.has(channel)) {
+      return channel;
+    }
+  }
+  return STABLE_BRANCH;
+};
+const resolveSourceRef = (ref) => {
+  if (ref !== void 0 && ref.length > 0) {
+    if (!isSafeRef(ref)) {
+      throw new Error(`invalid --ref "${ref}" — a ref may contain letters, digits, ".", "_", "-", "/", "@" and must not contain "..".`);
+    }
+    return ref;
+  }
+  return resolveVersionRef(resolveCliVersion());
+};
+
 const applyDeps = (deps, projectRoot, logger, section = "dependencies") => {
   const entries = Object.entries(deps);
   if (entries.length === 0) {
@@ -379,7 +430,6 @@ const reconcileItems = (items, cwd, logger, reconcileOptions = {}) => {
 };
 
 const DEFAULT_SOURCE_BASE = "gh:anolilab/lunora/registry";
-const DEFAULT_SOURCE_REF = "alpha";
 const VALID_ITEM_NAME = /^[A-Za-z0-9][\w-]*$/u;
 const assertSafeItemName = (name) => {
   if (!VALID_ITEM_NAME.test(name)) {
@@ -431,7 +481,7 @@ const resolveItemDirectory = async (name, options) => {
     }, directory };
   }
   const base = options.source ?? DEFAULT_SOURCE_BASE;
-  return fetchToStaging(`${base}/${name}#${DEFAULT_SOURCE_REF}`, "item", options.logger);
+  return fetchToStaging(`${base}/${name}#${resolveSourceRef(options.ref)}`, "item", options.logger);
 };
 const resolveRegistryRoot = async (options) => {
   if (options.from !== void 0) {
@@ -442,7 +492,7 @@ const resolveRegistryRoot = async (options) => {
     }, root: options.from };
   }
   const base = options.source ?? DEFAULT_SOURCE_BASE;
-  const { cleanup, directory } = await fetchToStaging(`${base}#${DEFAULT_SOURCE_REF}`, "registry", options.logger);
+  const { cleanup, directory } = await fetchToStaging(`${base}#${resolveSourceRef(options.ref)}`, "registry", options.logger);
   return { cleanup, root: directory };
 };
 const readManifest = (itemDirectory, name) => {
@@ -690,4 +740,4 @@ const runBuildIndexCommand = async (options) => {
   return empty;
 };
 
-export { runAddCommand, runBuildIndexCommand, runListCommand, runRegistryViewCommand };
+export { runBuildIndexCommand as a, runRegistryViewCommand as b, resolveSourceRef as c, runListCommand as d, runAddCommand as r };

package/dist/packem_shared/runAddCommand-3I3JFZUG.mjs

@@ -0,0 +1,4 @@
+import 'node:fs';
+import '@visulima/path';
+export { r as runAddCommand, a as runBuildIndexCommand, d as runListCommand, b as runRegistryViewCommand } from './commands-DIQ3nf0C.mjs';
+import './buildRegistryIndex-BcYe607_.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/cli",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.3",
   "description": "The Lunora CLI: init, dev, deploy, codegen, run, reset, and migrate commands",
   "keywords": [
     "agent-skills",
@@ -53,12 +53,12 @@
   "dependencies": {
     "@bomb.sh/tab": "0.0.17",
     "@lunora/codegen": "1.0.0-alpha.2",
-    "@lunora/config": "1.0.0-alpha.2",
+    "@lunora/config": "1.0.0-alpha.3",
     "@lunora/container": "1.0.0-alpha.1",
-    "@lunora/d1": "1.0.0-alpha.2",
+    "@lunora/d1": "1.0.0-alpha.3",
     "@lunora/seed": "1.0.0-alpha.1",
     "@lunora/server": "1.0.0-alpha.1",
-    "@lunora/studio": "1.0.0-alpha.1",
+    "@lunora/studio": "1.0.0-alpha.2",
     "@lunora/values": "1.0.0-alpha.1",
     "@visulima/cerebro": "3.0.0-alpha.32",
     "@visulima/fs": "5.0.0-alpha.32",