partweave 0.2.0 → 0.3.1

package/LICENSE

@@ -1,21 +1,201 @@
-MIT License
-
-Copyright (c) 2026 Agrim Sigdel
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Agrim Sigdel
+
+   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/NOTICE

@@ -0,0 +1,16 @@
+partweave
+Copyright 2026 Agrim Sigdel
+
+Created and maintained by Agrim Sigdel <sigdelagrim35@gmail.com>.
+Source: https://github.com/Agrim-Sigdel/partweave
+
+This product is licensed under the Apache License, Version 2.0 (see LICENSE).
+
+"partweave" is a trademark of Agrim Sigdel. The Apache License grants no
+trademark rights (see Section 6): forks and derivative works must not use the
+"partweave" name, logo, or branding to identify themselves or to market a
+derived product. You may of course state, factually, that your work is derived
+from or built on partweave.
+
+Per Section 4(d) of the Apache License, this NOTICE (and the attribution above)
+must be reproduced in any redistribution or derivative work.

package/README.md

@@ -1,5 +1,10 @@
 # partweave — a modular full-stack scaffolder
 
+[![npm version](https://img.shields.io/npm/v/partweave.svg)](https://www.npmjs.com/package/partweave)
+[![CI](https://github.com/Agrim-Sigdel/partweave/actions/workflows/ci.yml/badge.svg)](https://github.com/Agrim-Sigdel/partweave/actions/workflows/ci.yml)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
+[![Node](https://img.shields.io/node/v/partweave.svg)](https://www.npmjs.com/package/partweave)
+
 Generate new projects that contain **only the parts you pick** — a Django server, a
 Next.js web app, an Expo mobile app, and cross-cutting components (auth, storage, docker,
 CI) — all wired together.
@@ -113,6 +118,19 @@ pnpm --filter partweave typecheck  # typecheck the engine
 The generator locates the catalog by walking up from the CLI to find `modules/`.
 Override with `PARTWEAVE_MODULES_DIR=/path/to/modules`.
 
+See **[CONTRIBUTING.md](CONTRIBUTING.md)** for the full setup, project layout, the checks CI
+enforces, and how to add a component.
+
+## Contributing
+
+Contributions are welcome! The highest-leverage change is usually **a new component** — a
+folder under `modules/` with a `module.json`, no engine changes required.
+
+- Read [CONTRIBUTING.md](CONTRIBUTING.md) and the [module contract](docs/module-contract.md).
+- Be kind — this project follows a [Code of Conduct](CODE_OF_CONDUCT.md).
+- Found a security issue? See [SECURITY.md](SECURITY.md) — please report it privately.
+- Release notes live in [CHANGELOG.md](CHANGELOG.md).
+
 ## Releasing
 
 The CLI is published to npm as [`partweave`](https://www.npmjs.com/package/partweave).
@@ -124,6 +142,23 @@ npm version patch --workspace partweave   # bump version + create a matching git
 git push --follow-tags                       # push the tag → CI publishes to npm
 ```
 
-> One-time setup: add an `NPM_TOKEN` (an npm "Automation" access token) to the repo's
-> **Settings → Secrets and variables → Actions**. The `prepack` script copies `modules/` +
-> README + LICENSE into the package, so `npm publish` ships a self-contained CLI.
+> The `prepack` script copies `modules/`, README, LICENSE + NOTICE into the package, so
+> `npm publish` ships a self-contained CLI. Auth is via npm Trusted Publishing (OIDC) —
+> no `NPM_TOKEN` secret is needed (see [`publish.yml`](.github/workflows/publish.yml)).
+
+## Author
+
+Created and maintained by **Agrim Sigdel** — <sigdelagrim35@gmail.com>.
+
+If you build something with partweave, a mention or a link back is always appreciated.
+
+## License
+
+Licensed under the [Apache License 2.0](LICENSE) — permissive and free for commercial use.
+
+- **Projects you generate are yours.** partweave copies template code into your project; you
+  own that output and carry no obligation back to this repo.
+- **Attribution (Apache §4d):** redistributing partweave itself — or a fork of it — must keep
+  the [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE) files intact.
+- **Trademark (Apache §6):** the **partweave** name and branding are reserved. You may fork
+  and even sell the code, but not market a derivative under the "partweave" name.

package/dist/{chunk-2IGBGILB.js → chunk-ANKGMR2Z.js}

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 
 // src/commands/create.ts
+import { spawnSync as spawnSync3 } from "child_process";
 import { existsSync as existsSync5, readdirSync as readdirSync3 } from "fs";
 import { basename, resolve as resolve3 } from "path";
-import { intro, log, note, outro, spinner } from "@clack/prompts";
+import { confirm as confirm3, intro, isCancel as isCancel3, log as log2, note, outro, spinner as spinner2 } from "@clack/prompts";
 import pc2 from "picocolors";
 
 // src/compose.ts
@@ -42,6 +43,13 @@ function parseDep(dep) {
   }
   return { name: dep, version: "latest" };
 }
+function normalizeWorkspaceDeps(deps, workspaceRange) {
+  return deps.map((dep) => {
+    const { name, version } = parseDep(dep);
+    if (version.startsWith("workspace:")) return `${name}@${workspaceRange}`;
+    return dep;
+  });
+}
 function mergePackageJsonDeps(pkgJson, deps, field = "dependencies") {
   if (deps.length === 0) return pkgJson;
   const pkg = JSON.parse(pkgJson);
@@ -180,7 +188,8 @@ function jsPmProfile(name) {
       runAll: (script) => `npm run ${script} --workspaces --if-present`,
       packageManagerField: null,
       usesWorkspaceYaml: false,
-      needsHoistNpmrc: false
+      needsHoisting: false,
+      workspaceRange: "*"
     };
   }
   return {
@@ -190,7 +199,8 @@ function jsPmProfile(name) {
     runAll: (script) => `pnpm -r ${script}`,
     packageManagerField: PNPM_VERSION,
     usesWorkspaceYaml: true,
-    needsHoistNpmrc: true
+    needsHoisting: true,
+    workspaceRange: "workspace:*"
   };
 }
 var PIP_SYNC = "python3 -m venv .venv && .venv/bin/python -m pip install -U pip && .venv/bin/python scripts/sync_deps.py";
@@ -210,6 +220,34 @@ function pyPmProfile(name) {
     needsSyncScript: false
   };
 }
+function jsPmInstallPlan(pm) {
+  if (pm === "npm") return null;
+  return {
+    label: "Enabling pnpm via corepack",
+    cmd: "corepack",
+    args: ["enable", "pnpm"],
+    hint: "corepack enable pnpm   (or: npm i -g pnpm)"
+  };
+}
+function pyPmInstallPlan(pm) {
+  if (pm === "pip") return null;
+  if (process.platform === "win32") {
+    const ps = "irm https://astral.sh/uv/install.ps1 | iex";
+    return {
+      label: "Installing uv",
+      cmd: "powershell",
+      args: ["-ExecutionPolicy", "Bypass", "-c", ps],
+      hint: `powershell -ExecutionPolicy Bypass -c "${ps}"`
+    };
+  }
+  const sh = "curl -LsSf https://astral.sh/uv/install.sh | sh";
+  return {
+    label: "Installing uv",
+    cmd: "sh",
+    args: ["-c", sh],
+    hint: sh
+  };
+}
 function hasCommand(cmd) {
   try {
     const probe = process.platform === "win32" ? spawnSync("where", [cmd], { stdio: "ignore" }) : spawnSync("sh", ["-c", `command -v ${cmd}`], { stdio: "ignore" });
@@ -239,75 +277,231 @@ function buildJsWorkspace(ctx) {
   if (!jsPmProfile(ctx.jsPm).usesWorkspaceYaml) return null;
   const members = jsMembers(ctx);
   if (members.length === 0) return null;
-  return "packages:\n" + members.map((m) => `  - "${m}"`).join("\n") + "\n";
+  let out = "packages:\n" + members.map((m) => `  - "${m}"`).join("\n") + "\n";
+  if (ctx.hasMobile && jsPmProfile(ctx.jsPm).needsHoisting) {
+    out += "\n# Expo / React Native need a flat node_modules layout.\nnodeLinker: hoisted\nshamefullyHoist: true\n";
+  }
+  return out;
 }
-function buildRootPackageJson(ctx) {
+function buildRootPackageJson(ctx, hasDocker) {
   const anyJs = ctx.hasWeb || ctx.hasMobile || ctx.hasShared;
-  if (!anyJs) return null;
+  if (!anyJs && !ctx.hasServer) return null;
   const pm = jsPmProfile(ctx.jsPm);
-  const scripts = {};
-  if (ctx.hasWeb) scripts["dev:web"] = pm.run("web", "dev");
-  if (ctx.hasMobile) scripts["dev:mobile"] = pm.run("mobile", "start");
-  if (ctx.hasApiClient) scripts["gen:api"] = pm.run("@app/api-client", "generate");
-  scripts["typecheck"] = pm.runAll("typecheck");
+  const t = (task) => `node scripts/run.mjs ${task}`;
+  const scripts = { bootstrap: t("bootstrap"), dev: t("dev") };
+  if (ctx.hasWeb) scripts["web"] = t("web");
+  if (ctx.hasMobile) scripts["mobile"] = t("mobile");
+  if (ctx.hasServer) {
+    scripts["server"] = t("server");
+    scripts["migrate"] = t("migrate");
+    scripts["superuser"] = t("superuser");
+    if (hasDocker) {
+      scripts["db:up"] = t("db:up");
+      scripts["db:down"] = t("db:down");
+    }
+  }
+  if (ctx.hasApiClient) scripts["gen:api"] = t("gen:api");
+  if (anyJs) scripts["typecheck"] = pm.runAll("typecheck");
   const pkg = {
     name: ctx.projectSlug,
     version: "0.1.0",
     private: true
   };
-  if (pm.packageManagerField) pkg.packageManager = pm.packageManagerField;
-  if (!pm.usesWorkspaceYaml) pkg.workspaces = jsMembers(ctx);
+  if (anyJs && pm.packageManagerField) pkg.packageManager = pm.packageManagerField;
+  if (anyJs && !pm.usesWorkspaceYaml) pkg.workspaces = jsMembers(ctx);
   pkg.scripts = scripts;
-  pkg.devDependencies = { typescript: "^5.7.2" };
+  if (anyJs) pkg.devDependencies = { typescript: "^5.7.2" };
+  if (anyJs && ctx.jsPm === "pnpm") {
+    const allowed = {};
+    if (ctx.hasMobile) {
+      Object.assign(allowed, {
+        abab: "2",
+        domexception: "4",
+        glob: "7",
+        inflight: "1",
+        rimraf: "3",
+        uuid: "7"
+      });
+    }
+    if (ctx.hasWeb || ctx.hasMobile) {
+      allowed["whatwg-encoding"] = ctx.hasWeb && ctx.hasMobile ? "2 || 3" : ctx.hasWeb ? "3" : "2";
+    }
+    if (Object.keys(allowed).length > 0) {
+      pkg.pnpm = { allowedDeprecatedVersions: allowed };
+    }
+  }
   return JSON.stringify(pkg, null, 2) + "\n";
 }
+function buildTaskRunner(ctx, hasDocker) {
+  const anyJs = ctx.hasWeb || ctx.hasMobile || ctx.hasShared;
+  const npm = ctx.jsPm === "npm";
+  const pip = ctx.pyPm === "pip";
+  const jsInstall = npm ? `run("npm", ["install"])` : `run("pnpm", ["install"])`;
+  const jsRun = (pkg, script) => npm ? `run("npm", ["run", "${script}", "-w", "${pkg}"])` : `run("pnpm", ["--filter", "${pkg}", "${script}"])`;
+  const pyManage = (...sub) => {
+    const args = sub.map((s) => `"${s}"`).join(", ");
+    return ctx.pyPm === "uv" ? `run("uv", ["run", "python", "manage.py", ${args}], SERVER)` : `run(venvPy, ["manage.py", ${args}], SERVER)`;
+  };
+  const serverDev = ctx.pyPm === "uv" ? `["uv", ["run", "python", "manage.py", "runserver", "0.0.0.0:8000"], SERVER]` : `[venvPy, ["manage.py", "runserver", "0.0.0.0:8000"], SERVER]`;
+  const jsDevTuple = (pkg, script) => npm ? `["npm", ["run", "${script}", "-w", "${pkg}"]]` : `["pnpm", ["--filter", "${pkg}", "${script}"]]`;
+  const devTuples = [];
+  if (ctx.hasServer) devTuples.push(serverDev);
+  if (ctx.hasWeb) devTuples.push(jsDevTuple("web", "dev"));
+  if (ctx.hasMobile) devTuples.push(jsDevTuple("mobile", "start"));
+  const needsParallel = devTuples.length > 1;
+  const L = [];
+  L.push(
+    `#!/usr/bin/env node`,
+    `// ${ctx.projectName} \u2014 cross-platform task runner (generated by partweave).`,
+    `// Run a task on any OS:  node scripts/run.mjs <task>`,
+    `// Also available as:     npm run <task>   \xB7   make <task> (on macOS/Linux)`,
+    needsParallel ? `import { spawn, spawnSync } from "node:child_process";` : `import { spawnSync } from "node:child_process";`,
+    `import { existsSync } from "node:fs";`,
+    ``,
+    `const isWin = process.platform === "win32";`,
+    `const SERVER = { cwd: "apps/server" };`
+  );
+  if (ctx.hasServer && pip) {
+    L.push(`const venvPy = isWin ? ".venv\\\\Scripts\\\\python.exe" : ".venv/bin/python";`);
+  }
+  L.push(
+    ``,
+    `// Windows must spawn Node's .cmd shims through a shell; POSIX doesn't.`,
+    `function run(cmd, args = [], opts = {}) {`,
+    `  const r = spawnSync(cmd, args, { stdio: "inherit", shell: isWin, ...opts });`,
+    `  if (r.error) { console.error("\\u2716 " + cmd + ": " + r.error.message); process.exit(1); }`,
+    `  if (r.status) process.exit(r.status);`,
+    `}`,
+    `function has(cmd) {`,
+    `  const p = isWin`,
+    `    ? spawnSync("where", [cmd], { stdio: "ignore" })`,
+    `    : spawnSync("sh", ["-c", "command -v " + cmd], { stdio: "ignore" });`,
+    `  return p.status === 0;`,
+    `}`,
+    ``
+  );
+  if (needsParallel) {
+    L.push(
+      `// Run several long-lived dev servers at once; Ctrl-C stops them all.`,
+      `function parallel(specs) {`,
+      `  const kids = specs.map(([cmd, args, opts = {}]) =>`,
+      `    spawn(cmd, args, { stdio: "inherit", shell: isWin, ...opts }));`,
+      `  const stop = () => kids.forEach((k) => k.kill());`,
+      `  process.on("SIGINT", stop);`,
+      `  process.on("SIGTERM", stop);`,
+      `  kids.forEach((k) => k.on("exit", (code) => { if (code) { stop(); process.exit(code); } }));`,
+      `}`,
+      ``
+    );
+  }
+  const ensure = [];
+  if (anyJs && ctx.jsPm === "pnpm") {
+    ensure.push(
+      `  if (!has("pnpm")) {`,
+      `    console.log("pnpm not found \\u2014 enabling it via corepack\\u2026");`,
+      `    spawnSync("corepack", ["enable", "pnpm"], { stdio: "inherit", shell: isWin });`,
+      `    if (!has("pnpm")) { console.error("Could not enable pnpm. Install it with: npm i -g pnpm"); process.exit(1); }`,
+      `  }`
+    );
+  }
+  if (ctx.hasServer && ctx.pyPm === "uv") {
+    ensure.push(
+      `  if (!has("uv")) {`,
+      `    console.error("uv not found. Install it, then re-run bootstrap:\\n  " + (isWin`,
+      `      ? 'powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"'`,
+      `      : "curl -LsSf https://astral.sh/uv/install.sh | sh"));`,
+      `    process.exit(1);`,
+      `  }`
+    );
+  }
+  if (ctx.hasServer && pip) {
+    ensure.push(
+      `  if (!has("python3") && !has("python")) { console.error("Python 3 not found. Install Python 3.12+ and re-run."); process.exit(1); }`
+    );
+  }
+  L.push(
+    `function ensureTools() {`,
+    ...ensure.length ? ensure : [`  // npm and pip ship with Node and Python respectively.`],
+    `}`,
+    ``
+  );
+  if (ctx.hasServer && pip) {
+    L.push(
+      `function pipSync() {`,
+      `  const py = has("python3") ? "python3" : "python";`,
+      `  run(py, ["-m", "venv", ".venv"], SERVER);`,
+      `  run(venvPy, ["-m", "pip", "install", "-U", "pip"], SERVER);`,
+      `  run(venvPy, ["scripts/sync_deps.py"], SERVER);`,
+      `}`,
+      ``
+    );
+  }
+  L.push(`const tasks = {`);
+  const boot = [`    ensureTools();`];
+  if (anyJs) boot.push(`    ${jsInstall};`);
+  if (ctx.hasServer) boot.push(pip ? `    pipSync();` : `    run("uv", ["sync"], SERVER);`);
+  L.push(`  bootstrap() {`, ...boot, `  },`);
+  if (devTuples.length === 1) {
+    L.push(`  dev() { const [c, a, o = {}] = ${devTuples[0]}; run(c, a, o); },`);
+  } else if (devTuples.length > 1) {
+    L.push(`  dev() { parallel([${devTuples.join(", ")}]); },`);
+  }
+  if (ctx.hasWeb) L.push(`  web() { ${jsRun("web", "dev")}; },`);
+  if (ctx.hasMobile) L.push(`  mobile() { ${jsRun("mobile", "start")}; },`);
+  if (ctx.hasServer) {
+    L.push(`  server() { ${pyManage("runserver", "0.0.0.0:8000")}; },`);
+    L.push(`  migrate() { ${pyManage("migrate")}; },`);
+    L.push(`  superuser() { ${pyManage("createsuperuser")}; },`);
+    if (hasDocker) {
+      L.push(
+        `  "db:up"() {`,
+        `    if (spawnSync("docker", ["info"], { stdio: "ignore", shell: isWin }).status) {`,
+        `      console.error("Docker isn't running \\u2014 start Docker Desktop and retry."); process.exit(1);`,
+        `    }`,
+        `    const env = existsSync(".env") ? ["--env-file", ".env"] : [];`,
+        `    run("docker", ["compose", ...env, "-f", "infra/docker-compose.yml", "up", "-d", "db"]);`,
+        `  },`,
+        `  "db:down"() { run("docker", ["compose", "-f", "infra/docker-compose.yml", "down"]); },`
+      );
+    }
+  }
+  if (ctx.hasApiClient) L.push(`  "gen:api"() { ${jsRun("@app/api-client", "generate")}; },`);
+  L.push(`};`, ``);
+  L.push(
+    `const task = process.argv[2];`,
+    `if (!task || !Object.hasOwn(tasks, task)) {`,
+    `  console.log("Tasks: " + Object.keys(tasks).join(", "));`,
+    `  process.exit(task ? 1 : 0);`,
+    `}`,
+    `tasks[task]();`,
+    ``
+  );
+  return L.join("\n");
+}
 function buildMakefile(ctx, hasDocker) {
-  const js = jsPmProfile(ctx.jsPm);
-  const py = pyPmProfile(ctx.pyPm);
   const L = [];
   const phony = [];
-  const add = (name, body, help) => {
+  const add = (name, task, help) => {
     phony.push(name);
-    L.push(`${name}: ## ${help}`);
-    for (const line of body) L.push(`	${line}`);
-    L.push("");
+    L.push(`${name}: ## ${help}`, `	node scripts/run.mjs ${task}`, "");
   };
-  L.push("# " + ctx.projectName + " \u2014 dev tasks");
+  L.push("# " + ctx.projectName + " \u2014 dev tasks (wrappers around scripts/run.mjs)");
   L.push(".DEFAULT_GOAL := help");
   L.push("");
-  const bootstrap = [];
-  if (ctx.hasWeb || ctx.hasMobile || ctx.hasShared) bootstrap.push(js.install);
-  if (ctx.hasServer) bootstrap.push(`cd apps/server && ${py.syncInServer}`);
-  if (bootstrap.length) add("bootstrap", bootstrap, "install all dependencies");
+  add("bootstrap", "bootstrap", "install all dependencies");
+  add("dev", "dev", "run all dev servers");
   if (ctx.hasServer) {
     if (hasDocker) {
-      add(
-        "db-up",
-        [
-          `@docker info >/dev/null 2>&1 || { echo "Docker isn't running \u2014 start Docker Desktop and wait for it to be ready, then retry."; exit 1; }`,
-          // Load the project's .env (if present) so POSTGRES_* there drive the container.
-          "docker compose $$([ -f .env ] && echo --env-file .env) -f infra/docker-compose.yml up -d db"
-        ],
-        "start Postgres (needs Docker running)"
-      );
-      add("db-down", ["docker compose -f infra/docker-compose.yml down"], "stop Postgres");
+      add("db-up", "db:up", "start Postgres (needs Docker running)");
+      add("db-down", "db:down", "stop Postgres");
     }
-    add("migrate", [`cd apps/server && ${py.run("python manage.py migrate")}`], "run migrations");
-    add(
-      "server",
-      [`cd apps/server && ${py.run("python manage.py runserver 0.0.0.0:8000")}`],
-      "run the Django dev server"
-    );
-    add(
-      "superuser",
-      [`cd apps/server && ${py.run("python manage.py createsuperuser")}`],
-      "create an admin user"
-    );
+    add("migrate", "migrate", "run migrations");
+    add("server", "server", "run the Django dev server");
+    add("superuser", "superuser", "create an admin user");
   }
-  if (ctx.hasWeb) add("web", [js.run("web", "dev")], "run the Next.js dev server");
-  if (ctx.hasMobile) add("mobile", [js.run("mobile", "start")], "run the Expo dev server");
-  if (ctx.hasApiClient)
-    add("gen-api", [js.run("@app/api-client", "generate")], "regenerate the typed API client");
+  if (ctx.hasWeb) add("web", "web", "run the Next.js dev server");
+  if (ctx.hasMobile) add("mobile", "mobile", "run the Expo dev server");
+  if (ctx.hasApiClient) add("gen-api", "gen:api", "regenerate the typed API client");
   L.push(
     "help: ## show this help",
     `	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \\033[36m%-12s\\033[0m %s\\n", $$1, $$2}'`,
@@ -354,16 +548,6 @@ function buildTsconfigBase(ctx) {
     2
   ) + "\n";
 }
-function buildNpmrc(ctx) {
-  if (!ctx.hasMobile) return null;
-  if (!jsPmProfile(ctx.jsPm).needsHoistNpmrc) return null;
-  return [
-    "# Expo / React Native need a flat node_modules layout.",
-    "node-linker=hoisted",
-    "shamefully-hoist=true",
-    ""
-  ].join("\n");
-}
 function buildBaseEnv(ctx) {
   const lines = [
     "# Environment for " + ctx.projectName,
@@ -494,7 +678,10 @@ ${jsCiSteps(ctx)}
 function buildReadme(ctx, modules) {
   const parts = [];
   parts.push(`# ${ctx.projectName}`, "", ctx.description, "");
-  parts.push("Generated with **partweave** \u2014 a modular full-stack scaffolder.", "");
+  parts.push(
+    "Generated with [partweave](https://github.com/Agrim-Sigdel/partweave) \u2014 a modular full-stack scaffolder by Agrim Sigdel.",
+    ""
+  );
   parts.push("## What's inside", "");
   if (ctx.hasServer) parts.push(`- \`apps/server\` \u2014 Django + DRF API (managed by \`${ctx.pyPm}\`)`);
   if (ctx.hasWeb) parts.push("- `apps/web` \u2014 Next.js web app");
@@ -507,10 +694,22 @@ function buildReadme(ctx, modules) {
     for (const m of modules) parts.push(`- **${m.manifest.title}** \u2014 ${m.manifest.description ?? ""}`);
     parts.push("");
   }
-  parts.push("## Getting started", "", "```sh", "make bootstrap");
-  if (ctx.hasServer) parts.push("make db-up && make migrate", "make server   # http://localhost:8000");
-  if (ctx.hasWeb) parts.push("make web      # http://localhost:3000");
-  if (ctx.hasMobile) parts.push("make mobile   # Expo dev server");
+  parts.push(
+    "## Getting started",
+    "",
+    "These `npm run` tasks work the same on macOS, Linux, and Windows (they wrap",
+    "`scripts/run.mjs`). On macOS/Linux you can also use `make <task>`.",
+    "",
+    "```sh",
+    "npm run bootstrap"
+  );
+  const hasDocker = modules.some((m) => m.manifest.id === "docker");
+  if (ctx.hasServer) {
+    if (hasDocker) parts.push("npm run db:up        # start Postgres (needs Docker)");
+    parts.push("npm run migrate", "npm run server   # http://localhost:8000");
+  }
+  if (ctx.hasWeb) parts.push("npm run web      # http://localhost:3000");
+  if (ctx.hasMobile) parts.push("npm run mobile   # Expo dev server");
   parts.push("```", "");
   parts.push("Copy `.env.example` to `.env` and fill in values before running.", "");
   return parts.join("\n");
@@ -729,7 +928,7 @@ function injectIntoFiles(index, anchorId, lines, targetLabel) {
     writeFileSync2(file, next);
   }
 }
-function applyWiring(outDir, targets, modules) {
+function applyWiring(outDir, targets, modules, workspaceRange) {
   const indexes = /* @__PURE__ */ new Map();
   for (const t of targets) {
     indexes.set(t, buildAnchorIndex(join2(outDir, TARGET_DEST[t])));
@@ -753,7 +952,7 @@ function applyWiring(outDir, targets, modules) {
           if (existsSync2(pkgPath)) {
             const merged = mergePackageJsonDeps(
               readFileSync2(pkgPath, "utf8"),
-              wiring.deps
+              normalizeWorkspaceDeps(wiring.deps, workspaceRange)
             );
             writeFileSync2(pkgPath, merged);
           }
@@ -774,17 +973,16 @@ function applyEnv(outDir, modules) {
 function writeStructuralRootFiles(outDir, ctx, modules) {
   const workspace = buildJsWorkspace(ctx);
   if (workspace) writeFileEnsured(join2(outDir, "pnpm-workspace.yaml"), workspace);
-  const rootPkg = buildRootPackageJson(ctx);
+  const hasDocker = modules.some((m) => m.manifest.id === "docker");
+  const rootPkg = buildRootPackageJson(ctx, hasDocker);
   if (rootPkg) writeFileEnsured(join2(outDir, "package.json"), rootPkg);
   const turbo = buildTurboJson(ctx);
   if (turbo) writeFileEnsured(join2(outDir, "turbo.json"), turbo);
   const tsbase = buildTsconfigBase(ctx);
   if (tsbase) writeFileEnsured(join2(outDir, "tsconfig.base.json"), tsbase);
-  const npmrc = buildNpmrc(ctx);
-  if (npmrc) writeFileEnsured(join2(outDir, ".npmrc"), npmrc);
   const pipSync = buildPipSyncScript(ctx);
   if (pipSync) writeFileEnsured(join2(outDir, "apps/server/scripts/sync_deps.py"), pipSync);
-  const hasDocker = modules.some((m) => m.manifest.id === "docker");
+  writeFileEnsured(join2(outDir, "scripts/run.mjs"), buildTaskRunner(ctx, hasDocker));
   writeFileEnsured(join2(outDir, "Makefile"), buildMakefile(ctx, hasDocker));
   writeFileEnsured(join2(outDir, ".env.example"), buildBaseEnv(ctx));
 }
@@ -814,7 +1012,7 @@ function compose(opts) {
       }
     }
   }
-  applyWiring(outDir, wireTargets, modules);
+  applyWiring(outDir, wireTargets, modules, jsPmProfile(ctx.jsPm).workspaceRange);
   applyEnv(outDir, modules);
   if (selection.modules.includes("ci")) {
     for (const [rel, content] of Object.entries(buildCiWorkflows(ctx))) {
@@ -831,6 +1029,43 @@ function compose(opts) {
   return { written, notes };
 }
 
+// src/preflight.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import { confirm, isCancel, log, spinner } from "@clack/prompts";
+function runInstall(plan, probe) {
+  const s = spinner();
+  s.start(plan.label);
+  const r = spawnSync2(plan.cmd, plan.args, {
+    stdio: ["ignore", "ignore", "inherit"],
+    shell: process.platform === "win32"
+  });
+  const ok = r.status === 0 && hasCommand(probe);
+  s.stop(ok ? `${probe} is ready` : `Could not install ${probe}`);
+  return ok;
+}
+async function ensurePm(chosen, fallback, plan, opts) {
+  if (hasCommand(chosen)) return chosen;
+  if (!plan) return chosen;
+  let doInstall = opts.install === true;
+  if (opts.interactive) {
+    const answer = await confirm({
+      message: `${chosen} isn't installed. Install it now?  (${plan.hint})`
+    });
+    doInstall = !isCancel(answer) && answer === true;
+  }
+  if (doInstall && runInstall(plan, chosen)) return chosen;
+  log.warn(
+    `Using ${fallback} instead of ${chosen}. To use ${chosen} later, run:  ${plan.hint}`
+  );
+  return fallback;
+}
+function ensureJsPm(pm, opts) {
+  return ensurePm(pm, "npm", jsPmInstallPlan(pm), opts);
+}
+function ensurePyPm(pm, opts) {
+  return ensurePm(pm, "pip", pyPmInstallPlan(pm), opts);
+}
+
 // src/registry.ts
 import { readdirSync as readdirSync2, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { join as join4 } from "path";
@@ -1004,8 +1239,8 @@ Enable the required app(s) or drop the component(s).`
 // src/prompts.ts
 import {
   cancel,
-  confirm,
-  isCancel,
+  confirm as confirm2,
+  isCancel as isCancel2,
   multiselect,
   select,
   text
@@ -1014,7 +1249,7 @@ import pc from "picocolors";
 import { resolve as resolve2 } from "path";
 var MULTI_HINT = pc.dim("\u2191/\u2193 move \xB7 space toggle \xB7 a all \xB7 enter confirm");
 function bail(v) {
-  if (isCancel(v)) {
+  if (isCancel2(v)) {
     cancel("Cancelled.");
     process.exit(0);
   }
@@ -1092,7 +1327,7 @@ async function promptCreate(registry, defaults) {
     bail(pyRaw);
     pyPm = pyRaw;
   }
-  const ok = await confirm({
+  const ok = await confirm2({
     message: `Scaffold ${apps.join(" + ")}${modules.length ? " with " + modules.join(", ") : ""} into ${outDir}?`
   });
   bail(ok);
@@ -1107,7 +1342,7 @@ async function promptCreate(registry, defaults) {
 function resolvePm(value, allowed, detect, flag) {
   if (value === void 0) return detect();
   if (allowed.includes(value)) return value;
-  log.error(`Invalid ${flag} "${value}". Choose one of: ${allowed.join(", ")}.`);
+  log2.error(`Invalid ${flag} "${value}". Choose one of: ${allowed.join(", ")}.`);
   process.exit(1);
 }
 function appsFromFlags(flags) {
@@ -1149,26 +1384,33 @@ async function runCreate(flags) {
     });
   }
   if (existsSync5(choices.outDir) && readdirSync3(choices.outDir).length > 0 && !flags.force) {
-    log.error(`${choices.outDir} exists and is not empty. Use --force to override.`);
+    log2.error(`${choices.outDir} exists and is not empty. Use --force to override.`);
     process.exit(1);
   }
+  const ensureOpts = { interactive: !nonInteractive, install: flags.install };
+  if (choices.apps.includes("web") || choices.apps.includes("mobile")) {
+    choices.jsPm = await ensureJsPm(choices.jsPm, ensureOpts);
+  }
+  if (choices.apps.includes("server")) {
+    choices.pyPm = await ensurePyPm(choices.pyPm, ensureOpts);
+  }
   let resolved;
   try {
     resolved = resolveModules(registry, choices.modules);
   } catch (err) {
-    log.error(err.message);
+    log2.error(err.message);
     process.exit(1);
   }
   if (resolved.autoAdded.length) {
-    log.info(`Added required components: ${resolved.autoAdded.join(", ")}`);
+    log2.info(`Added required components: ${resolved.autoAdded.join(", ")}`);
   }
   try {
     validateApps(registry, resolved.modules, choices.apps);
   } catch (err) {
-    log.error(err.message);
+    log2.error(err.message);
     process.exit(1);
   }
-  const s = spinner();
+  const s = spinner2();
   s.start("Scaffolding");
   let result;
   try {
@@ -1190,7 +1432,7 @@ async function runCreate(flags) {
     });
   } catch (err) {
     s.stop("Failed");
-    log.error(err.message);
+    log2.error(err.message);
     process.exit(1);
   }
   s.stop(`Created ${result.written.length} files`);
@@ -1201,25 +1443,52 @@ async function runCreate(flags) {
     jsPm: choices.jsPm,
     pyPm: choices.pyPm
   });
+  let installed = false;
+  if (nonInteractive) {
+    installed = flags.install === true;
+  } else {
+    const ans = await confirm3({ message: "Install dependencies now?" });
+    installed = !isCancel3(ans) && ans === true;
+  }
+  if (installed) {
+    log2.step("Installing dependencies (npm run bootstrap)\u2026");
+    const r = spawnSync3("node", ["scripts/run.mjs", "bootstrap"], {
+      cwd: choices.outDir,
+      stdio: "inherit"
+    });
+    if (r.status) {
+      log2.warn("bootstrap didn't finish cleanly \u2014 run `npm run bootstrap` in the project to retry.");
+      installed = false;
+    }
+  }
   const rel = basename(choices.outDir);
-  const steps = [`cd ${rel}`, "make bootstrap"];
-  if (choices.apps.includes("server")) steps.push("make db-up && make migrate", "make server");
-  if (choices.apps.includes("web")) steps.push("make web");
-  if (choices.apps.includes("mobile")) steps.push("make mobile");
-  note(steps.join("\n"), "Next steps");
+  const hasDocker = resolved.modules.includes("docker");
+  const steps = [`cd ${rel}`];
+  if (!installed) steps.push("npm run bootstrap");
+  if (choices.apps.includes("server")) {
+    steps.push(hasDocker ? "npm run db:up && npm run migrate" : "npm run migrate");
+    steps.push("npm run server");
+  }
+  if (choices.apps.includes("web")) steps.push("npm run web");
+  if (choices.apps.includes("mobile")) steps.push("npm run mobile");
+  note(
+    steps.join("\n") + "\n\n" + pc2.dim("These work on macOS, Linux & Windows. On macOS/Linux, `make <task>` works too."),
+    "Next steps"
+  );
   if (result.notes.length) note(result.notes.join("\n"), "Notes");
   outro(pc2.green("Done."));
 }
 
 export {
-  DEFAULT_JS_PM,
-  DEFAULT_PY_PM,
-  jsPmProfile,
-  pyPmProfile,
+  jsPmInstallPlan,
+  pyPmInstallPlan,
+  hasCommand,
   APPS,
   buildContext,
   selectedTargets,
   compose,
+  ensureJsPm,
+  ensurePyPm,
   Registry,
   readProjectManifest,
   writeProjectManifest,
@@ -1227,4 +1496,4 @@ export {
   validateApps,
   runCreate
 };
-//# sourceMappingURL=chunk-2IGBGILB.js.map
+//# sourceMappingURL=chunk-ANKGMR2Z.js.map

package/dist/create-bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCreate
-} from "./chunk-2IGBGILB.js";
+} from "./chunk-ANKGMR2Z.js";
 
 // src/create-bin.ts
 import { Command } from "commander";

package/dist/index.js

@@ -1,20 +1,21 @@
 #!/usr/bin/env node
 import {
   APPS,
-  DEFAULT_JS_PM,
-  DEFAULT_PY_PM,
   Registry,
   buildContext,
   compose,
-  jsPmProfile,
-  pyPmProfile,
+  ensureJsPm,
+  ensurePyPm,
+  hasCommand,
+  jsPmInstallPlan,
+  pyPmInstallPlan,
   readProjectManifest,
   resolveModules,
   runCreate,
   selectedTargets,
   validateApps,
   writeProjectManifest
-} from "./chunk-2IGBGILB.js";
+} from "./chunk-ANKGMR2Z.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -54,13 +55,9 @@ async function runAdd(ids, flags) {
   let manifest = pm;
   if (appIds.length) manifest = addApps(registry, dir, manifest, appIds);
   if (moduleIds.length) manifest = addModules(registry, dir, manifest, moduleIds);
-  const js = jsPmProfile(manifest.jsPm ?? DEFAULT_JS_PM);
-  const py = pyPmProfile(manifest.pyPm ?? DEFAULT_PY_PM);
-  const reinstall = [];
-  if (manifest.apps.some((a) => a === "web" || a === "mobile")) reinstall.push(js.install);
-  if (manifest.apps.includes("server"))
-    reinstall.push(`cd apps/server && ${py.syncInServer} && ${py.run("python manage.py migrate")}`);
-  if (reinstall.length) note(reinstall.join("\n"), "Sync deps");
+  const reinstall = ["npm run bootstrap"];
+  if (manifest.apps.includes("server")) reinstall.push("npm run migrate");
+  note(reinstall.join("\n"), "Sync deps");
   outro(pc.green("Done."));
 }
 function addApps(registry, dir, pm, appIds) {
@@ -135,17 +132,62 @@ function addModules(registry, dir, pm, moduleIds) {
   return updated;
 }
 
+// src/commands/doctor.ts
+import { spawnSync } from "child_process";
+import { resolve as resolve2 } from "path";
+import { intro as intro2, note as note2, outro as outro2 } from "@clack/prompts";
+import pc2 from "picocolors";
+function version(cmd) {
+  const r = spawnSync(cmd, ["--version"], { encoding: "utf8" });
+  if (r.error || r.status !== 0) return null;
+  return (r.stdout || r.stderr || "").trim().split("\n")[0] ?? "";
+}
+async function runDoctor(flags) {
+  intro2(pc2.bgCyan(pc2.black(" partweave ")) + pc2.dim(" doctor"));
+  const dir = resolve2(flags.dir ?? process.cwd());
+  const project = readProjectManifest(dir);
+  const rows = [];
+  const check = (label, cmd, optional = false) => {
+    const v = version(cmd);
+    const ok = v !== null;
+    const mark = ok ? pc2.green("\u2713") : optional ? pc2.yellow("\u25CB") : pc2.red("\u2717");
+    const detail = ok ? pc2.dim(v) : pc2.dim(optional ? "not found (optional)" : "not found");
+    rows.push(`${mark} ${label.padEnd(9)} ${detail}`);
+    return ok;
+  };
+  check("node", "node");
+  check("npm", "npm");
+  check("pnpm", "pnpm", true);
+  check("uv", "uv", true);
+  check("python", process.platform === "win32" ? "python" : "python3", true);
+  check("docker", "docker", true);
+  check("make", "make", true);
+  note2(rows.join("\n"), project ? `Environment for ${project.name}` : "Environment");
+  const jsPm = project?.jsPm ?? "pnpm";
+  const pyPm = project?.pyPm ?? "uv";
+  if (jsPmInstallPlan(jsPm) && !hasCommand(jsPm)) {
+    await ensureJsPm(jsPm, { interactive: true });
+  }
+  if (pyPmInstallPlan(pyPm) && !hasCommand(pyPm)) {
+    await ensurePyPm(pyPm, { interactive: true });
+  }
+  outro2(pc2.green("Done."));
+}
+
 // src/index.ts
 function buildProgram() {
   const program = new Command();
   program.name("partweave").description("A modular full-stack scaffolder \u2014 pick parts, generate only that code.").version("0.1.0");
-  program.command("create", { isDefault: true }).argument("[name]", "project name").description("Scaffold a new project").option("-d, --dir <path>", "target directory").option("--server", "include the Django server").option("--no-server", "exclude the server").option("--web", "include the Next.js web app").option("--no-web", "exclude the web app").option("--mobile", "include the Expo mobile app").option("--no-mobile", "exclude the mobile app").option("--with <ids>", "comma-separated component ids (e.g. auth,docker,ci)").option("--js-pm <pm>", "JS package manager: pnpm | npm (default: auto-detect)").option("--py-pm <pm>", "Python package manager: uv | pip (default: auto-detect)").option("-y, --yes", "skip prompts; use flags/defaults").option("-f, --force", "write into a non-empty directory").action(async (name, opts) => {
+  program.command("create", { isDefault: true }).argument("[name]", "project name").description("Scaffold a new project").option("-d, --dir <path>", "target directory").option("--server", "include the Django server").option("--no-server", "exclude the server").option("--web", "include the Next.js web app").option("--no-web", "exclude the web app").option("--mobile", "include the Expo mobile app").option("--no-mobile", "exclude the mobile app").option("--with <ids>", "comma-separated component ids (e.g. auth,docker,ci)").option("--js-pm <pm>", "JS package manager: pnpm | npm (default: auto-detect)").option("--py-pm <pm>", "Python package manager: uv | pip (default: auto-detect)").option("-y, --yes", "skip prompts; use flags/defaults").option("-f, --force", "write into a non-empty directory").option("--install", "install dependencies after scaffolding (default: ask, off with --yes)").action(async (name, opts) => {
     const flags = { ...opts, name: name ?? opts.name };
     await runCreate(flags);
   });
   program.command("add").argument("<items...>", "apps (server/web/mobile) or component ids to add").description("Add an app or component to an existing generated project").option("-d, --dir <path>", "project directory (default: cwd)").action(async (items, opts) => {
     await runAdd(items, opts);
   });
+  program.command("doctor").description("Check your environment and install any missing package managers").option("-d, --dir <path>", "project directory (default: cwd)").action(async (opts) => {
+    await runDoctor(opts);
+  });
   return program;
 }
 async function main(argv = process.argv) {
@@ -159,6 +201,7 @@ export {
   buildProgram,
   main,
   runAdd,
-  runCreate
+  runCreate,
+  runDoctor
 };
 //# sourceMappingURL=index.js.map

package/modules/_core/mobile/metro.config.js

@@ -13,6 +13,24 @@ config.resolver.nodeModulesPaths = [
   path.resolve(projectRoot, "node_modules"),
   path.resolve(workspaceRoot, "node_modules"),
 ];
-config.resolver.disableHierarchicalLookup = true;
+// Keep Metro's default hierarchical node_modules lookup ON: under npm (and any
+// non-hoisted install) some Expo sub-deps (e.g. expo-asset) resolve from
+// expo/node_modules, and disabling the walk-up breaks bundling them.
+
+// Keep test files out of the native bundle. Expo Router builds a require.context
+// over the whole app/ directory, so a colocated `*.test.tsx` would otherwise get
+// bundled — dragging in @testing-library/react-native and Node built-ins
+// (console, util) that don't exist in the RN runtime, and failing the build.
+// Metro's blockList removes them from resolution (and thus from require.context);
+// Jest doesn't read this config, so `npm test` still finds and runs them.
+config.resolver.blockList = [
+  ...(Array.isArray(config.resolver.blockList)
+    ? config.resolver.blockList
+    : config.resolver.blockList
+      ? [config.resolver.blockList]
+      : []),
+  /\.(test|spec)\.[jt]sx?$/,
+  /[/\\]__tests__[/\\]/,
+];
 
 module.exports = config;

package/modules/_core/mobile/package.json

@@ -29,8 +29,10 @@
     "@testing-library/react-native": "^13.2.0",
     "@types/jest": "^29.5.14",
     "@types/react": "~19.1.10",
+    "babel-preset-expo": "~54.0.7",
     "jest": "^29.7.0",
     "jest-expo": "~54.0.0",
+    "react-test-renderer": "19.1.0",
     "typescript": "~5.9.2"
   }
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "partweave",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "A modular full-stack scaffolder — pick the parts you need (Django server, Next.js web, Expo mobile) and generate only that code, wired together.",
   "type": "module",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
   },
-  "author": "Agrim Sigdel",
+  "author": "Agrim Sigdel <sigdelagrim35@gmail.com>",
   "homepage": "https://github.com/Agrim-Sigdel/partweave#readme",
   "repository": {
     "type": "git",
@@ -41,7 +41,8 @@
     "dist/**/*.js",
     "modules",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE"
   ],
   "scripts": {
     "build": "tsup",