create-objectstack 6.1.1 → 6.3.0

package/dist/index.js

@@ -3,554 +3,46 @@ import { Command } from "commander";
 import chalk from "chalk";
 import fs from "fs";
 import path from "path";
+import os from "os";
 import { execSync } from "child_process";
 import { fileURLToPath } from "url";
+import { pipeline } from "stream/promises";
+import { createGunzip } from "zlib";
+import { createWriteStream, createReadStream } from "fs";
+import { mkdtemp, rm } from "fs/promises";
+import * as tar from "tar";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = path.dirname(__filename);
-var TEMPLATES_DIR = path.resolve(__dirname, "templates");
+var BUNDLED_TEMPLATES_DIR = path.resolve(__dirname, "templates");
+var REMOTE_REPO = "objectstack-ai/templates";
+var REMOTE_BRANCH = "main";
+var REMOTE_TARBALL_URL = `https://codeload.github.com/${REMOTE_REPO}/tar.gz/refs/heads/${REMOTE_BRANCH}`;
 var TEMPLATES = {
-  "minimal-api": {
-    description: "Server + memory driver + 1 object + REST API",
-    files: {
-      "objectstack.config.ts": (name) => `import { defineStack } from '@objectstack/spec';
-import * as objects from './src/objects';
-
-export default defineStack({
-  manifest: {
-    id: 'com.example.${name}',
-    namespace: '${name}',
-    version: '0.1.0',
-    type: 'app',
-    name: '${toTitleCase(name)}',
-    description: '${toTitleCase(name)} \u2014 built with ObjectStack',
+  blank: {
+    description: "Minimal starter \u2014 one object, REST API, ready to extend",
+    source: { kind: "bundled", dir: "blank" }
   },
-
-  objects: Object.values(objects),
-
-  api: {
-    rest: { enabled: true, basePath: '/api' },
+  todo: {
+    description: "Universal task & project management starter",
+    source: { kind: "remote", pkg: "todo" }
   },
-});
-`,
-      "package.json": (name) => JSON.stringify({
-        name,
-        version: "0.1.0",
-        private: true,
-        type: "module",
-        scripts: {
-          dev: "objectstack dev",
-          start: "objectstack serve",
-          build: "objectstack compile",
-          validate: "objectstack validate",
-          typecheck: "tsc --noEmit"
-        },
-        dependencies: {
-          "@objectstack/spec": "^3.0.0",
-          "@objectstack/runtime": "^3.0.0",
-          "@objectstack/driver-memory": "^3.0.0",
-          "@objectstack/plugin-hono-server": "^3.0.0"
-        },
-        devDependencies: {
-          "@objectstack/cli": "^3.0.0",
-          "typescript": "^5.3.0"
-        }
-      }, null, 2) + "\n",
-      "tsconfig.json": () => JSON.stringify({
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          strict: true,
-          esModuleInterop: true,
-          skipLibCheck: true,
-          outDir: "dist",
-          rootDir: ".",
-          declaration: true
-        },
-        include: ["*.ts", "src/**/*"],
-        exclude: ["dist", "node_modules"]
-      }, null, 2) + "\n",
-      "src/objects/task.ts": () => `import * as Data from '@objectstack/spec/data';
-
-const task: Data.Object = {
-  name: 'task',
-  label: 'Task',
-  ownership: 'own',
-  fields: {
-    title: {
-      type: 'text',
-      label: 'Title',
-      required: true,
-    },
-    description: {
-      type: 'textarea',
-      label: 'Description',
-    },
-    status: {
-      type: 'select',
-      label: 'Status',
-      options: [
-        { label: 'Open', value: 'open' },
-        { label: 'In Progress', value: 'in_progress' },
-        { label: 'Done', value: 'done' },
-      ],
-      defaultValue: 'open',
-    },
-    due_date: {
-      type: 'date',
-      label: 'Due Date',
-    },
+  compliance: {
+    description: "Compliance posture & evidence management (SOC2 / ISO27001)",
+    source: { kind: "remote", pkg: "compliance" }
   },
-};
-
-export default task;
-`,
-      "src/objects/index.ts": () => `export { default as task } from './task';
-`,
-      ".gitignore": () => `node_modules/
-dist/
-*.tsbuildinfo
-`,
-      "README.md": (name) => `# ${toTitleCase(name)}
-
-Built with [ObjectStack](https://objectstack.com).
-
-## Quick Start
-
-\`\`\`bash
-# Install dependencies
-npm install
-
-# Start development server
-npm run dev
-
-# Validate configuration
-npm run validate
-\`\`\`
-
-## Project Structure
-
-- \`objectstack.config.ts\` \u2014 Stack definition (objects, API, settings)
-- \`src/objects/\` \u2014 Object definitions
-- \`dist/\` \u2014 Compiled output
-
-## Learn More
-
-- [ObjectStack Documentation](https://objectstack.com/docs)
-`
-    }
-  },
-  "full-stack": {
-    description: "Server + UI + auth + 3 CRM objects",
-    files: {
-      "objectstack.config.ts": (name) => `import { defineStack } from '@objectstack/spec';
-import * as objects from './src/objects';
-import * as apps from './src/apps';
-
-export default defineStack({
-  manifest: {
-    id: 'com.example.${name}',
-    namespace: '${name}',
-    version: '0.1.0',
-    type: 'app',
-    name: '${toTitleCase(name)}',
-    description: '${toTitleCase(name)} CRM \u2014 built with ObjectStack',
+  content: {
+    description: "Content marketing pipeline \u2014 editorial calendar & channel ROI",
+    source: { kind: "remote", pkg: "content" }
   },
-
-  objects: Object.values(objects),
-  apps: Object.values(apps),
-
-  api: {
-    rest: { enabled: true, basePath: '/api' },
+  contracts: {
+    description: "Post-signature CLM \u2014 approvals, obligations, renewals",
+    source: { kind: "remote", pkg: "contracts" }
   },
-});
-`,
-      "package.json": (name) => JSON.stringify({
-        name,
-        version: "0.1.0",
-        private: true,
-        type: "module",
-        scripts: {
-          dev: "objectstack dev",
-          start: "objectstack serve",
-          build: "objectstack compile",
-          validate: "objectstack validate",
-          typecheck: "tsc --noEmit"
-        },
-        dependencies: {
-          "@objectstack/spec": "^3.0.0",
-          "@objectstack/runtime": "^3.0.0",
-          "@objectstack/driver-memory": "^3.0.0",
-          "@objectstack/plugin-hono-server": "^3.0.0",
-          "@objectstack/plugin-auth": "^3.0.0"
-        },
-        devDependencies: {
-          "@objectstack/cli": "^3.0.0",
-          "typescript": "^5.3.0"
-        }
-      }, null, 2) + "\n",
-      "tsconfig.json": () => JSON.stringify({
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          strict: true,
-          esModuleInterop: true,
-          skipLibCheck: true,
-          outDir: "dist",
-          rootDir: ".",
-          declaration: true
-        },
-        include: ["*.ts", "src/**/*"],
-        exclude: ["dist", "node_modules"]
-      }, null, 2) + "\n",
-      "src/objects/contact.ts": () => `import * as Data from '@objectstack/spec/data';
-
-const contact: Data.Object = {
-  name: 'contact',
-  label: 'Contact',
-  ownership: 'own',
-  fields: {
-    first_name: {
-      type: 'text',
-      label: 'First Name',
-      required: true,
-    },
-    last_name: {
-      type: 'text',
-      label: 'Last Name',
-      required: true,
-    },
-    email: {
-      type: 'text',
-      label: 'Email',
-    },
-    phone: {
-      type: 'text',
-      label: 'Phone',
-    },
-    company: {
-      type: 'lookup',
-      label: 'Company',
-      reference: 'company',
-    },
-  },
-};
-
-export default contact;
-`,
-      "src/objects/company.ts": () => `import * as Data from '@objectstack/spec/data';
-
-const company: Data.Object = {
-  name: 'company',
-  label: 'Company',
-  ownership: 'own',
-  fields: {
-    name: {
-      type: 'text',
-      label: 'Company Name',
-      required: true,
-    },
-    website: {
-      type: 'text',
-      label: 'Website',
-    },
-    industry: {
-      type: 'select',
-      label: 'Industry',
-      options: [
-        { label: 'Technology', value: 'technology' },
-        { label: 'Finance', value: 'finance' },
-        { label: 'Healthcare', value: 'healthcare' },
-        { label: 'Other', value: 'other' },
-      ],
-    },
-  },
-};
-
-export default company;
-`,
-      "src/objects/deal.ts": () => `import * as Data from '@objectstack/spec/data';
-
-const deal: Data.Object = {
-  name: 'deal',
-  label: 'Deal',
-  ownership: 'own',
-  fields: {
-    name: {
-      type: 'text',
-      label: 'Deal Name',
-      required: true,
-    },
-    amount: {
-      type: 'number',
-      label: 'Amount',
-    },
-    stage: {
-      type: 'select',
-      label: 'Stage',
-      options: [
-        { label: 'Prospecting', value: 'prospecting' },
-        { label: 'Qualification', value: 'qualification' },
-        { label: 'Proposal', value: 'proposal' },
-        { label: 'Closed Won', value: 'closed_won' },
-        { label: 'Closed Lost', value: 'closed_lost' },
-      ],
-      defaultValue: 'prospecting',
-    },
-    contact: {
-      type: 'lookup',
-      label: 'Contact',
-      reference: 'contact',
-    },
-    company: {
-      type: 'lookup',
-      label: 'Company',
-      reference: 'company',
-    },
-    close_date: {
-      type: 'date',
-      label: 'Close Date',
-    },
-  },
-};
-
-export default deal;
-`,
-      "src/objects/index.ts": () => `export { default as contact } from './contact';
-export { default as company } from './company';
-export { default as deal } from './deal';
-`,
-      "src/views/contact_list.ts": () => `import * as UI from '@objectstack/spec/ui';
-
-const contactList: UI.View = {
-  name: 'contact_list',
-  label: 'All Contacts',
-  object: 'contact',
-  type: 'list',
-  columns: ['first_name', 'last_name', 'email', 'phone', 'company'],
-};
-
-export default contactList;
-`,
-      "src/views/company_list.ts": () => `import * as UI from '@objectstack/spec/ui';
-
-const companyList: UI.View = {
-  name: 'company_list',
-  label: 'All Companies',
-  object: 'company',
-  type: 'list',
-  columns: ['name', 'website', 'industry'],
-};
-
-export default companyList;
-`,
-      "src/views/deal_list.ts": () => `import * as UI from '@objectstack/spec/ui';
-
-const dealList: UI.View = {
-  name: 'deal_list',
-  label: 'All Deals',
-  object: 'deal',
-  type: 'list',
-  columns: ['name', 'amount', 'stage', 'contact', 'close_date'],
-};
-
-export default dealList;
-`,
-      "src/apps/crm.ts": () => `import * as UI from '@objectstack/spec/ui';
-
-const crm: UI.App = {
-  name: 'crm',
-  label: 'CRM',
-  description: 'Customer Relationship Management',
-  navigation: [
-    { type: 'object', object: 'contact', label: 'Contacts' },
-    { type: 'object', object: 'company', label: 'Companies' },
-    { type: 'object', object: 'deal', label: 'Deals' },
-  ],
-};
-
-export default crm;
-`,
-      "src/apps/index.ts": () => `export { default as crm } from './crm';
-`,
-      ".gitignore": () => `node_modules/
-dist/
-*.tsbuildinfo
-`,
-      "README.md": (name) => `# ${toTitleCase(name)}
-
-A full-stack CRM application built with [ObjectStack](https://objectstack.com).
-
-## Quick Start
-
-\`\`\`bash
-npm install
-npm run dev
-\`\`\`
-
-## Project Structure
-
-- \`objectstack.config.ts\` \u2014 Stack definition
-- \`src/objects/\` \u2014 Data objects (Contact, Company, Deal)
-- \`src/views/\` \u2014 List views
-- \`src/apps/crm.ts\` \u2014 CRM app with navigation
-
-## Learn More
-
-- [ObjectStack Documentation](https://objectstack.com/docs)
-`
-    }
-  },
-  plugin: {
-    description: "Plugin skeleton with test setup",
-    files: {
-      "objectstack.config.ts": (name) => `import { defineStack } from '@objectstack/spec';
-import * as objects from './src/objects';
-
-export default defineStack({
-  manifest: {
-    id: 'com.objectstack.plugin-${name}',
-    namespace: 'plugin_${name}',
-    version: '0.1.0',
-    type: 'plugin',
-    name: '${toTitleCase(name)} Plugin',
-    description: 'ObjectStack Plugin: ${toTitleCase(name)}',
-  },
-
-  objects: Object.values(objects),
-});
-`,
-      "package.json": (name) => JSON.stringify({
-        name: `@objectstack/plugin-${name}`,
-        version: "0.1.0",
-        description: `ObjectStack Plugin: ${toTitleCase(name)}`,
-        main: "dist/index.js",
-        types: "dist/index.d.ts",
-        type: "module",
-        scripts: {
-          build: "tsc",
-          dev: "tsc --watch",
-          test: "vitest run",
-          validate: "objectstack validate",
-          typecheck: "tsc --noEmit"
-        },
-        keywords: ["objectstack", "plugin", name],
-        author: "",
-        license: "MIT",
-        dependencies: {
-          "@objectstack/spec": "^3.0.0"
-        },
-        devDependencies: {
-          "@types/node": "^22.0.0",
-          "typescript": "^5.3.0",
-          "vitest": "^4.0.0"
-        }
-      }, null, 2) + "\n",
-      "tsconfig.json": () => JSON.stringify({
-        compilerOptions: {
-          target: "ES2022",
-          module: "ESNext",
-          moduleResolution: "bundler",
-          strict: true,
-          esModuleInterop: true,
-          skipLibCheck: true,
-          outDir: "dist",
-          rootDir: ".",
-          declaration: true
-        },
-        include: ["*.ts", "src/**/*"],
-        exclude: ["dist", "node_modules"]
-      }, null, 2) + "\n",
-      "src/index.ts": (name) => `/**
- * ${toTitleCase(name)} Plugin for ObjectStack
- *
- * Entry point \u2014 re-exports all plugin metadata.
- */
-export * as objects from './objects';
-`,
-      "src/objects/sample.ts": (name) => `import * as Data from '@objectstack/spec/data';
-
-const sample: Data.Object = {
-  name: '${name}_sample',
-  label: '${toTitleCase(name)} Sample',
-  ownership: 'own',
-  fields: {
-    name: {
-      type: 'text',
-      label: 'Name',
-      required: true,
-    },
-  },
-};
-
-export default sample;
-`,
-      "src/objects/index.ts": () => `export { default as sample } from './sample';
-`,
-      "test/sample.test.ts": (name) => `import { describe, it, expect } from 'vitest';
-import sample from '../src/objects/sample';
-
-describe('${name} plugin', () => {
-  it('should export a valid sample object', () => {
-    expect(sample).toBeDefined();
-    expect(sample.name).toBe('${name}_sample');
-    expect(sample.fields).toHaveProperty('name');
-  });
-});
-`,
-      ".gitignore": () => `node_modules/
-dist/
-*.tsbuildinfo
-`,
-      "README.md": (name) => `# @objectstack/plugin-${name}
-
-ObjectStack Plugin: ${toTitleCase(name)}
-
-## Installation
-
-\`\`\`bash
-npm install @objectstack/plugin-${name}
-\`\`\`
-
-## Usage
-
-\`\`\`typescript
-import { defineStack } from '@objectstack/spec';
-
-export default defineStack({
-  plugins: [
-    '@objectstack/plugin-${name}',
-  ],
-});
-\`\`\`
-
-## Development
-
-\`\`\`bash
-# Run tests
-npm test
-
-# Build
-npm run build
-
-# Validate metadata
-npm run validate
-\`\`\`
-
-## License
-
-MIT
-`
-    }
+  procurement: {
+    description: "Source-to-pay \u2014 vendors, POs, receipts, invoice matching",
+    source: { kind: "remote", pkg: "procurement" }
   }
 };
-function readTemplate(filename) {
-  return fs.readFileSync(path.join(TEMPLATES_DIR, filename), "utf-8");
-}
-var AI_CONFIG_FILES = {
-  ".github/copilot-instructions.md": (name) => readTemplate("copilot-instructions.md").replaceAll("{{PROJECT_NAME}}", name).replaceAll("{{PROJECT_TITLE}}", toTitleCase(name))
-};
 function toTitleCase(str) {
   return str.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
@@ -574,16 +66,132 @@ function printStep(msg) {
 function printWarning(msg) {
   console.log(chalk.yellow(`  \u26A0 ${msg}`));
 }
-var program = new Command().name("create-objectstack").description("Create a new ObjectStack project").version("3.0.0").argument("[name]", "Project name (defaults to current directory name)").option(
+function detectPackageManager() {
+  try {
+    execSync("pnpm --version", { stdio: "ignore" });
+    return "pnpm";
+  } catch {
+    return "npm";
+  }
+}
+function copyDir(src, dest, collected, rel = "") {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    const relPath = rel ? `${rel}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath, collected, relPath);
+    } else if (entry.isFile()) {
+      fs.copyFileSync(srcPath, destPath);
+      collected.push(relPath);
+    }
+  }
+}
+function loadBundled(templateDir, targetDir) {
+  const src = path.join(BUNDLED_TEMPLATES_DIR, templateDir);
+  if (!fs.existsSync(src)) {
+    throw new Error(`Bundled template missing on disk: ${src}`);
+  }
+  const collected = [];
+  copyDir(src, targetDir, collected);
+  return collected;
+}
+async function downloadTarball(url, destFile) {
+  const res = await fetch(url, { redirect: "follow" });
+  if (!res.ok || !res.body) {
+    throw new Error(`Download failed: ${url} (${res.status})`);
+  }
+  const out = createWriteStream(destFile);
+  for await (const chunk of res.body) {
+    out.write(chunk);
+  }
+  await new Promise((resolve, reject) => {
+    out.end((err) => err ? reject(err) : resolve());
+  });
+}
+async function loadRemote(pkgName, targetDir) {
+  const tmp = await mkdtemp(path.join(os.tmpdir(), "create-objectstack-"));
+  try {
+    const tarball = path.join(tmp, "templates.tar.gz");
+    printStep(`Fetching template "${pkgName}" from ${REMOTE_REPO}@${REMOTE_BRANCH}\u2026`);
+    await downloadTarball(REMOTE_TARBALL_URL, tarball);
+    fs.mkdirSync(targetDir, { recursive: true });
+    const collected = [];
+    await pipeline(
+      createReadStream(tarball),
+      createGunzip(),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      tar.extract({
+        cwd: targetDir,
+        strip: 3,
+        filter: (p) => {
+          const parts = p.split("/");
+          return parts[1] === "packages" && parts[2] === pkgName && parts.length > 3;
+        },
+        onentry: (entry) => {
+          if (entry.type === "File") {
+            const parts = entry.path.split("/").slice(3);
+            if (parts.length > 0) collected.push(parts.join("/"));
+          }
+        }
+      })
+    );
+    if (collected.length === 0) {
+      throw new Error(
+        `Template "${pkgName}" not found in ${REMOTE_REPO}@${REMOTE_BRANCH} (expected packages/${pkgName}/).`
+      );
+    }
+    return collected;
+  } finally {
+    await rm(tmp, { recursive: true, force: true });
+  }
+}
+function rewriteProjectIdentity(targetDir, projectName) {
+  const title = toTitleCase(projectName);
+  const pkgPath = path.join(targetDir, "package.json");
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      pkg.name = projectName;
+      fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+    } catch {
+    }
+  }
+  const manifestPath = path.join(targetDir, "objectstack.manifest.json");
+  if (fs.existsSync(manifestPath)) {
+    try {
+      const m = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+      m.name = projectName;
+      m.displayName = title;
+      fs.writeFileSync(manifestPath, JSON.stringify(m, null, 2) + "\n");
+    } catch {
+    }
+  }
+  const configPath = path.join(targetDir, "objectstack.config.ts");
+  if (fs.existsSync(configPath)) {
+    let cfg = fs.readFileSync(configPath, "utf8");
+    cfg = cfg.replace(/(\bid:\s*)(['"`])[^'"`]*\2/, `$1$2${projectName}$2`);
+    cfg = cfg.replace(/(\bname:\s*)(['"`])[^'"`]*\2/, `$1$2${title}$2`);
+    fs.writeFileSync(configPath, cfg);
+  }
+  const readmePath = path.join(targetDir, "README.md");
+  if (fs.existsSync(readmePath)) {
+    let md = fs.readFileSync(readmePath, "utf8");
+    md = md.replace(/^#\s+.*$/m, `# ${title}`);
+    fs.writeFileSync(readmePath, md);
+  }
+}
+var program = new Command().name("create-objectstack").description("Create a new ObjectStack environment").version("6.2.0").argument("[name]", "Environment name (defaults to current directory name)").option(
   "-t, --template <template>",
-  "Project template: minimal-api, full-stack, plugin",
-  "minimal-api"
-).option("--skip-install", "Skip dependency installation").action(async (name, options) => {
+  `Template: ${Object.keys(TEMPLATES).join(", ")}`,
+  "blank"
+).option("--skip-install", "Skip dependency installation").option("--skip-skills", "Skip installing ObjectStack AI skills").action(async (name, options) => {
   console.log("");
   console.log(chalk.bold.cyan("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"));
-  console.log(chalk.bold.cyan("  \u2551") + chalk.bold("   \u25C6 Create ObjectStack ") + chalk.dim("v3.0") + chalk.bold.cyan("       \u2551"));
+  console.log(chalk.bold.cyan("  \u2551") + chalk.bold("   \u25C6 Create ObjectStack ") + chalk.dim("v6.x") + chalk.bold.cyan("       \u2551"));
   console.log(chalk.bold.cyan("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D"));
-  printHeader("New Project");
+  printHeader("New Environment");
   const template = TEMPLATES[options.template];
   if (!template) {
     printError(`Unknown template: ${options.template}`);
@@ -594,7 +202,7 @@ var program = new Command().name("create-objectstack").description("Create a new
   const projectName = name || path.basename(cwd);
   const targetDir = name ? path.resolve(cwd, name) : cwd;
   const isCurrentDir = targetDir === cwd;
-  printKV("Project", projectName);
+  printKV("Environment", projectName);
   printKV("Template", `${options.template} \u2014 ${template.description}`);
   printKV("Directory", targetDir);
   console.log("");
@@ -605,25 +213,22 @@ var program = new Command().name("create-objectstack").description("Create a new
       process.exit(1);
     }
   }
-  const createdFiles = [];
   try {
-    if (!fs.existsSync(targetDir)) {
-      fs.mkdirSync(targetDir, { recursive: true });
-    }
-    const allFiles = { ...template.files, ...AI_CONFIG_FILES };
-    for (const [filePath, contentFn] of Object.entries(allFiles)) {
-      const fullPath = path.join(targetDir, filePath);
-      const dir = path.dirname(fullPath);
-      if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-      }
-      fs.writeFileSync(fullPath, contentFn(projectName));
-      createdFiles.push(filePath);
+    fs.mkdirSync(targetDir, { recursive: true });
+    let createdFiles;
+    if (template.source.kind === "bundled") {
+      createdFiles = loadBundled(template.source.dir, targetDir);
+    } else {
+      createdFiles = await loadRemote(template.source.pkg, targetDir);
     }
+    rewriteProjectIdentity(targetDir, projectName);
     console.log(chalk.bold("  Created files:"));
-    for (const f of createdFiles) {
+    for (const f of createdFiles.slice(0, 20)) {
       console.log(chalk.green(`    + ${f}`));
     }
+    if (createdFiles.length > 20) {
+      console.log(chalk.dim(`    \u2026 and ${createdFiles.length - 20} more`));
+    }
     console.log("");
     if (!options.skipInstall) {
       printStep("Installing dependencies...");
@@ -636,7 +241,7 @@ var program = new Command().name("create-objectstack").description("Create a new
         console.log("");
       }
     }
-    if (!options.skipInstall) {
+    if (!options.skipInstall && !options.skipSkills) {
       printStep("Installing AI skills for your coding agent...");
       try {
         execSync("npx -y skills add objectstack-ai/framework --all", {
@@ -651,7 +256,7 @@ var program = new Command().name("create-objectstack").description("Create a new
         console.log("");
       }
     }
-    printSuccess("Project created!");
+    printSuccess("Environment created!");
     console.log("");
     console.log(chalk.bold("  Next steps:"));
     if (!isCurrentDir) {
@@ -662,23 +267,16 @@ var program = new Command().name("create-objectstack").description("Create a new
     }
     console.log(chalk.dim("    npm run dev           # Start development server"));
     console.log(chalk.dim("    npm run validate      # Check configuration"));
-    if (options.skipInstall) {
+    if (options.skipInstall || options.skipSkills) {
       console.log("");
       console.log(chalk.bold("  AI Skills (recommended):"));
       console.log(chalk.dim("    npx skills add objectstack-ai/framework"));
     }
     console.log("");
   } catch (error) {
-    printError(error.message || String(error));
+    const msg = error instanceof Error ? error.message : String(error);
+    printError(msg);
     process.exit(1);
   }
 });
-function detectPackageManager() {
-  try {
-    execSync("pnpm --version", { stdio: "ignore" });
-    return "pnpm";
-  } catch {
-    return "npm";
-  }
-}
 program.parse();

package/dist/templates/blank/README.md

@@ -0,0 +1,27 @@
+# Blank Starter
+
+Minimal ObjectStack environment — a clean slate for building.
+
+## Getting started
+
+```bash
+pnpm install
+pnpm dev
+```
+
+The REST API is served at `http://localhost:3000/api`.
+
+## Layout
+
+- `objectstack.config.ts` — environment manifest (objects, API, plugins)
+- `src/objects/` — object definitions (one file per object)
+
+## Next steps
+
+- Add an object: see the `objectstack-data` skill.
+- Add a view or app: see `objectstack-ui`.
+- Add a flow or automation: see `objectstack-automation`.
+- Add an AI agent: see `objectstack-ai`.
+
+Skills live in `skills/` in the ObjectStack framework repo and in the in-IDE
+assistant catalog.

package/dist/templates/blank/objectstack.config.ts

@@ -0,0 +1,19 @@
+import { defineStack } from '@objectstack/spec';
+import * as objects from './src/objects/index.js';
+
+export default defineStack({
+  manifest: {
+    id: 'blank',
+    version: '0.1.0',
+    type: 'app',
+    name: 'Blank Starter',
+    description: 'Minimal ObjectStack environment — a clean slate for building.',
+  },
+  objects: Object.values(objects),
+  api: {
+    rest: {
+      enabled: true,
+      basePath: '/api',
+    },
+  },
+});

package/dist/templates/blank/objectstack.manifest.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://schemas.objectstack.dev/template-manifest.json",
+  "name": "blank",
+  "specVersion": "^6.0.0",
+  "displayName": "Blank Starter",
+  "description": "Minimal ObjectStack environment with a single object — a clean slate for building.",
+  "category": "starter",
+  "isStarter": true,
+  "skills": ["objectstack-platform", "objectstack-data"],
+  "readmePath": "README.md",
+  "scaffold": {
+    "variables": {
+      "appName": { "type": "string", "prompt": "Application name", "default": "my-app" }
+    }
+  }
+}

package/dist/templates/blank/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "objectstack-blank",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "objectstack serve --watch",
+    "start": "objectstack serve",
+    "build": "objectstack build",
+    "validate": "objectstack validate",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@objectstack/spec": "^6.0.0",
+    "@objectstack/runtime": "^6.0.0",
+    "@objectstack/driver-memory": "^6.0.0",
+    "@objectstack/plugin-hono-server": "^6.0.0"
+  },
+  "devDependencies": {
+    "@objectstack/cli": "^6.0.0",
+    "typescript": "^5.3.0"
+  }
+}

package/dist/templates/blank/src/objects/index.ts

@@ -0,0 +1 @@
+export { Note } from './note.object.js';

package/dist/templates/blank/src/objects/note.object.ts

@@ -0,0 +1,28 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { ObjectSchema, Field } from '@objectstack/spec/data';
+
+export const Note = ObjectSchema.create({
+  name: 'note',
+  label: 'Note',
+  pluralLabel: 'Notes',
+  icon: 'sticky-note',
+  description: 'A short note — the starter object for a blank environment.',
+
+  fields: {
+    title: Field.text({
+      label: 'Title',
+      required: true,
+      searchable: true,
+      maxLength: 200,
+    }),
+    body: Field.longText({
+      label: 'Body',
+    }),
+  },
+
+  enable: {
+    apiEnabled: true,
+    searchable: true,
+  },
+});

package/dist/templates/blank/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": false,
+    "noEmit": true,
+    "isolatedModules": true
+  },
+  "include": ["objectstack.config.ts", "src/**/*"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-objectstack",
-  "version": "6.1.1",
+  "version": "6.3.0",
   "description": "Create a new ObjectStack project — npx create-objectstack",
   "bin": {
     "create-objectstack": "./bin/create-objectstack.js"
@@ -16,10 +16,12 @@
   "license": "Apache-2.0",
   "dependencies": {
     "chalk": "^5.6.2",
-    "commander": "^14.0.3"
+    "commander": "^14.0.3",
+    "tar": "^7.4.3"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
+    "@types/tar": "^6.1.13",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3"
   },