create-factory 0.0.1 → 0.0.2

package/CHANGELOG.md

@@ -1,7 +1,13 @@
-# mastra-factory
+# create-factory
+
+## 0.0.2
+
+### Patch Changes
+
+- First real scaffold release for `npm create factory`. Clones the softwarefactory template, installs dependencies, initializes git, and prints next steps. Configuration (model providers, database, integrations) happens in the web UI on first load.
 
 ## 0.0.1
 
 ### Patch Changes
 
-- Initial public package name claim for `mastra-factory`. Scaffold a Mastra Software Factory project with `npx mastra-factory`.
+- Initial public package name claim.

package/README.md

@@ -0,0 +1,49 @@
+# create-factory
+
+Scaffolding CLI for the **Mastra Software Factory** — an open-source, agent-powered software delivery environment built on [Mastra](https://mastra.ai).
+
+```bash
+npm create factory
+```
+
+The CLI is intentionally minimal: it asks for a project name, clones the [softwarefactory-template](https://github.com/mastra-ai/softwarefactory-template), installs dependencies, and initializes git. That's it — run `npm run dev` and finish setup (model providers, integrations, database) from the web UI on first load. An "auth with the Mastra platform" step is planned as a follow-up.
+
+## Flags
+
+```text
+npm create factory [project-name] -- [options]
+
+    --default              Non-interactive: default name
+    --template-ref <ref>   Pin a template repo tag/branch
+    --template-dir <dir>   Use a local template directory (development)
+-t, --timeout [ms]         Timeout for dependency installation
+```
+
+## Development (monorepo)
+
+This package lives in the `mastra-ai/mastra` monorepo at `mastracode/mastra-factory`. Releases go through the monorepo's changesets release train (it is un-ignored in `.changeset/config.json`) — add a changeset with your change and the train versions and publishes it.
+
+```bash
+pnpm --filter ./mastracode/mastra-factory build   # bundle src -> dist
+pnpm --filter ./mastracode/mastra-factory test    # vitest
+node bin/cli.mjs my-app --default --template-dir ./template-out
+```
+
+### Template sync
+
+`scripts/sync-template.mjs` generates the template tree from `mastracode/web`:
+
+- `link:` deps → caret ranges on published versions (anchored on local monorepo versions by default, verified on npm; `--tag latest` for stable dist-tags)
+- monorepo tsconfig → standalone, test files/deps stripped, user-facing scripts
+- checked-in `template/README.md` → user-facing README (version tokens filled at sync)
+- `.env.schema` → `.env.example` (varlock decorators removed)
+
+Syncing to [softwarefactory-template](https://github.com/mastra-ai/softwarefactory-template) is automated, mirroring the `templates/*` process: the `sync-softwarefactory-template` workflow regenerates the template (`--tag latest`) and force-pushes it on every push to `main` that touches `mastracode/web`, the sync script, or `template/README.md`. The monorepo is the source of truth — direct commits to the template repo get overwritten.
+
+```bash
+node scripts/sync-template.mjs            # writes ./template-out (local development)
+```
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -52,7 +52,7 @@ var Analytics = class {
       this.client?.capture({
         distinctId: this.distinctId,
         event,
-        properties: { ...properties, cli: "mastra-factory", version: this.version }
+        properties: { ...properties, cli: "create-factory", version: this.version }
       });
     } catch {
     }
@@ -226,20 +226,14 @@ async function create(args) {
 You can retry manually: cd ${projectName} && ${packageManager} install`
     );
   }
-  let initGit = true;
-  if (!args.useDefaults) {
-    initGit = await p.confirm({ message: "Initialize a git repository?", initialValue: true });
-  }
-  if (!p.isCancel(initGit) && initGit) {
-    try {
-      await runInherit("git", ["init", "-q"], { cwd: projectPath });
-      await runInherit("git", ["add", "-A"], { cwd: projectPath });
-      await runInherit("git", ["commit", "-q", "-m", "Initial commit from mastra-factory"], {
-        cwd: projectPath
-      });
-    } catch {
-      p.log.warn("git init failed \u2014 you can initialize the repository yourself later.");
-    }
+  try {
+    await runInherit("git", ["init", "-q"], { cwd: projectPath });
+    await runInherit("git", ["add", "-A"], { cwd: projectPath });
+    await runInherit("git", ["commit", "-q", "-m", "Initial commit from create-factory"], {
+      cwd: projectPath
+    });
+  } catch {
+    p.log.warn("git init failed \u2014 you can initialize the repository yourself later.");
   }
   args.analytics.trackEvent("sf_create_completed", {
     package_manager: packageManager,
@@ -270,7 +264,7 @@ var pkg = JSON.parse(
 );
 var analytics = new Analytics(pkg.version);
 var program = new Command();
-program.name("mastra-factory").description("Create a Mastra Software Factory project").version(pkg.version, "-v, --version").argument("[project-name]", "Directory name of the project").option("--default", "Non-interactive: default name, init git").option("--template-ref <ref>", "Pin a template repo tag/branch").option("--template-dir <dir>", "Use a local template directory instead of cloning (development)").option("-t, --timeout [ms]", "Timeout for dependency installation in ms").action(async (projectNameArg, args) => {
+program.name("create-factory").description("Create a Mastra Software Factory project").version(pkg.version, "-v, --version").argument("[project-name]", "Directory name of the project").option("--default", "Non-interactive: default name").option("--template-ref <ref>", "Pin a template repo tag/branch").option("--template-dir <dir>", "Use a local template directory instead of cloning (development)").option("-t, --timeout [ms]", "Timeout for dependency installation in ms").action(async (projectNameArg, args) => {
   let timeout;
   if (args.timeout !== void 0) {
     timeout = args.timeout === true ? 6e4 : Number(args.timeout);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-factory",
-  "version": "0.0.1",
-  "description": "Create a Mastra Software Factory project. Placeholder package claiming the name; use npx mastra-factory or npm create factory.",
+  "version": "0.0.2",
+  "description": "Create a Mastra Software Factory project: an agent-powered software delivery environment built on Mastra. Run `npm create factory` to scaffold and get started.",
   "type": "module",
   "license": "Apache-2.0",
   "bin": {
@@ -12,6 +12,13 @@
     "dist",
     "CHANGELOG.md"
   ],
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "prepack": "npm run build",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint ."
+  },
   "engines": {
     "node": ">=20"
   },
@@ -38,5 +45,13 @@
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
     "posthog-node": "^5.37.0"
+  },
+  "devDependencies": {
+    "@internal/lint": "workspace:*",
+    "@types/node": "22.20.1",
+    "eslint": "^10.4.1",
+    "tsup": "^8.5.1",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
   }
 }