create-factory 0.0.1 → 0.0.3-alpha.0

package/CHANGELOG.md

@@ -1,7 +1,25 @@
-# mastra-factory
+# create-factory
+
+## 0.0.3-alpha.0
+
+### Patch Changes
+
+- Added the `create-factory` CLI. It scaffolds a Mastra Software Factory project: enter a project name and the CLI clones the template, installs dependencies, and initializes git. Configuration (model providers, integrations, database) happens in the web UI on first load. ([#19609](https://github.com/mastra-ai/mastra/pull/19609))
+
+  ```bash
+  npm create factory my-factory
+  cd my-factory
+  npm run dev
+  ```
+
+## 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/LICENSE.md

@@ -0,0 +1,30 @@
+Portions of this software are licensed as follows:
+
+- All content that resides under any directory named "ee/" within this
+  repository, including but not limited to:
+  - `packages/core/src/auth/ee/`
+  - `packages/server/src/server/auth/ee/`
+    is licensed under the license defined in `ee/LICENSE`.
+
+- All third-party components incorporated into the Mastra Software are
+  licensed under the original license provided by the owner of the
+  applicable component.
+
+- Content outside of the above-mentioned directories or restrictions is
+  available under the "Apache License 2.0" as defined below.
+
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

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 using published local monorepo versions 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.3-alpha.0",
+  "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": {
@@ -38,5 +38,19 @@
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
     "posthog-node": "^5.37.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.1",
+    "eslint": "^10.4.1",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "4.1.10",
+    "@internal/lint": "0.0.114"
+  },
+  "scripts": {
+    "build": "tsup --silent --config tsup.config.ts",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint ."
   }
-}
+}