@usequark/quark-create-app 1.23.11 → 1.23.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024, Quark Contributors
+
+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.

package/README.md

@@ -1,4 +1,4 @@
-# @techstream/quark-create-app CLI
+# @usequark/quark-create-app CLI
 
 Scaffold a new Quark project with sensible defaults for full-stack JavaScript development.
 
@@ -6,10 +6,10 @@ Scaffold a new Quark project with sensible defaults for full-stack JavaScript de
 
 ```bash
 # Interactive — prompts for project name, description, and options
-npx @techstream/quark-create-app@latest
+npx @usequark/quark-create-app@latest
 
 # Non-interactive — provide project name as argument
-npx @techstream/quark-create-app@latest my-awesome-app
+npx @usequark/quark-create-app@latest my-awesome-app
 ```
 
 The CLI scaffolds a complete project structure with:
@@ -41,26 +41,26 @@ The CLI detects this, prints a warning, and skips git initialisation so a nested
 
 ```bash
 # Create a new project (interactive or with name argument)
-npx @techstream/quark-create-app@latest
-npx @techstream/quark-create-app@latest my-app
+npx @usequark/quark-create-app@latest
+npx @usequark/quark-create-app@latest my-app
 
 # Add a package to an existing project
-npx @techstream/quark-create-app add jobs
+npx @usequark/quark-create-app add jobs
 
 # Print an embedded skill for a feature
-npx @techstream/quark-create-app skill bookings
+npx @usequark/quark-create-app skill bookings
 
 # Update Quark packages in an existing project
-npx @techstream/quark-create-app update
+npx @usequark/quark-create-app update
 
 # Check for available updates without applying them
-npx @techstream/quark-create-app update --check
+npx @usequark/quark-create-app update --check
 
 # Report drift in scaffold-managed files without overwriting anything
-npx @techstream/quark-create-app update --scaffold-check
+npx @usequark/quark-create-app update --scaffold-check
 
 # Fail CI when scaffold drift is detected
-npx @techstream/quark-create-app update --scaffold-check --fail-on-drift
+npx @usequark/quark-create-app update --scaffold-check --fail-on-drift
 ```
 
 Aliases:
@@ -78,7 +78,7 @@ When run without arguments, the CLI prompts for:
 4. **Public signup** — allow self-service user registration
 
 ```bash
-npx @techstream/quark-create-app@latest
+npx @usequark/quark-create-app@latest
 # ? Project name: my-app
 # ? Describe your app: A platform for booking salon appointments
 # ? Include background jobs (emails, webhooks, scheduled tasks)? Yes
@@ -90,7 +90,7 @@ npx @techstream/quark-create-app@latest
 Skip all prompts with flags:
 
 ```bash
-npx @techstream/quark-create-app@latest my-app --no-prompts
+npx @usequark/quark-create-app@latest my-app --no-prompts
 ```
 
 ### Packages
@@ -99,13 +99,13 @@ Specify which optional packages to include (default: `ui,jobs`; valid: `ui`, `jo
 
 ```bash
 # Only include UI package
-npx @techstream/quark-create-app@latest my-app --no-prompts --packages ui
+npx @usequark/quark-create-app@latest my-app --no-prompts --packages ui
 
 # Include both UI and Jobs
-npx @techstream/quark-create-app@latest my-app --no-prompts --packages ui,jobs
+npx @usequark/quark-create-app@latest my-app --no-prompts --packages ui,jobs
 
 # Minimal setup (no optional packages)
-npx @techstream/quark-create-app@latest my-app --no-prompts --packages ""
+npx @usequark/quark-create-app@latest my-app --no-prompts --packages ""
 ```
 
 `ui` is always included automatically as a required dependency.
@@ -115,7 +115,7 @@ npx @techstream/quark-create-app@latest my-app --no-prompts --packages ""
 Seed the `MAIN.md` brief from a flag:
 
 ```bash
-npx @techstream/quark-create-app@latest my-app --no-prompts --prompt "A booking platform for salons"
+npx @usequark/quark-create-app@latest my-app --no-prompts --prompt "A booking platform for salons"
 ```
 
 ### Signup
@@ -123,7 +123,7 @@ npx @techstream/quark-create-app@latest my-app --no-prompts --prompt "A booking
 Control public self-service signup (default: `enabled`):
 
 ```bash
-npx @techstream/quark-create-app@latest my-app --no-prompts --signup disabled
+npx @usequark/quark-create-app@latest my-app --no-prompts --signup disabled
 ```
 
 ### skill command
@@ -132,12 +132,12 @@ Print an embedded skill for a feature:
 
 ```bash
 # Print the bookings skill
-npx @techstream/quark-create-app@latest skill bookings
+npx @usequark/quark-create-app@latest skill bookings
 
 # Print a core skill (model, endpoint, dashboard)
-npx @techstream/quark-create-app@latest skill model
-npx @techstream/quark-create-app@latest skill endpoint
-npx @techstream/quark-create-app@latest skill dashboard
+npx @usequark/quark-create-app@latest skill model
+npx @usequark/quark-create-app@latest skill endpoint
+npx @usequark/quark-create-app@latest skill dashboard
 ```
 
 Available skills: `model`, `endpoint`, `dashboard`, `bookings`, `crm`, `cms`, `ai`.
@@ -148,7 +148,7 @@ Create the project structure without running package installation:
 
 ```bash
 # Create project but skip pnpm install
-npx @techstream/quark-create-app@latest my-app --no-prompts --skip-install
+npx @usequark/quark-create-app@latest my-app --no-prompts --skip-install
 
 # Useful for CI/CD where you'll install dependencies separately
 ```
@@ -159,14 +159,14 @@ Control whether to remove Docker volumes from previous cleanup:
 
 ```bash
 # Keep Docker working directories (useful in CI/CD)
-npx @techstream/quark-create-app@latest my-app --no-prompts --skip-docker
+npx @usequark/quark-create-app@latest my-app --no-prompts --skip-docker
 ```
 
 ### Complete Example: Full Automation
 
 ```bash
 # Create, install, and setup everything automatically
-npx @techstream/quark-create-app@latest my-app \
+npx @usequark/quark-create-app@latest my-app \
   --no-prompts \
   --packages ui,jobs \
   && cd my-app \
@@ -177,7 +177,7 @@ npx @techstream/quark-create-app@latest my-app \
 
 ## Common Tasks
 
-- **Update Quark packages**: `quark-update` or `pnpm update @techstream/quark-*`
+- **Update Quark packages**: `quark-update` or `pnpm update @usequark/quark-*`
 - **Check for updates**: `quark-update --check`
 - **Review scaffold drift**: `quark-update --scaffold-check`
 - **Fail CI on scaffold drift**: `quark-update --scaffold-check --fail-on-drift`

package/package.json

@@ -1,56 +1,56 @@
 {
-	"name": "@usequark/quark-create-app",
-	"version": "1.23.11",
-	"description": "CLI to scaffold new Quark projects with Next.js, Prisma, BullMQ, and Railway deployment",
-	"type": "module",
-	"homepage": "https://github.com/usequark/quark#readme",
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/usequark/quark.git",
-		"directory": "packages/cli"
-	},
-	"bugs": {
-		"url": "https://github.com/usequark/quark/issues"
-	},
-	"author": "Quark Contributors",
-	"bin": {
-		"quark": "src/index.js",
-		"quark-create-app": "src/index.js",
-		"create-quark-app": "src/index.js",
-		"quark-update": "src/index.js"
-	},
-	"files": [
-		"src",
-		"templates",
-		"README.md"
-	],
-	"scripts": {
-		"sync-templates": "node scripts/sync-templates.js",
-		"sync-templates:check": "node scripts/sync-templates.js --check",
-		"regen-migration": "node scripts/regenerate-template-migration.js",
-		"smoke:published": "node scripts/smoke-published.js",
-		"test": "node test-cli.js && node --test src/utils.test.js && node --test src/prepare-hooks.test.js && node --test src/scaffold-output.test.js && node --test src/template-scripts.test.js && node --test src/scaffold-guards.test.js && node --test src/worker-dockerfile.test.js && node --test src/dependabot-config.test.js && node --test 'src/deploy/**/*.test.js' && node --test --test-concurrency=1 'src/deploy/**/*.integration.test.js'",
-		"test:build": "node test-build.js",
-		"test:e2e": "node test-e2e.js",
-		"test:e2e:full": "node test-e2e-full.js",
-		"test:integration": "node test-integration.js",
-		"test:flags": "node --test test-flags.js",
-		"test:all": "node test-all.js",
-		"check:perf": "node scripts/check-e2e-perf.js"
-	},
-	"dependencies": {
-		"chalk": "^6.0.0",
-		"commander": "^15.0.0",
-		"execa": "^10.0.1",
-		"fs-extra": "^11.4.1",
-		"prompts": "^2.4.2"
-	},
-	"publishConfig": {
-		"registry": "https://registry.npmjs.org",
-		"access": "public"
-	},
-	"engines": {
-		"node": ">=22.13.0"
-	},
-	"license": "MIT"
-}
+  "name": "@usequark/quark-create-app",
+  "version": "1.23.12",
+  "description": "CLI to scaffold new Quark projects with Next.js, Prisma, BullMQ, and Railway deployment",
+  "type": "module",
+  "homepage": "https://github.com/usequark/quark#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/usequark/quark.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/usequark/quark/issues"
+  },
+  "author": "Quark Contributors",
+  "bin": {
+    "quark": "src/index.js",
+    "quark-create-app": "src/index.js",
+    "create-quark-app": "src/index.js",
+    "quark-update": "src/index.js"
+  },
+  "files": [
+    "src",
+    "templates",
+    "README.md"
+  ],
+  "dependencies": {
+    "chalk": "^6.0.0",
+    "commander": "^15.0.0",
+    "execa": "^10.0.1",
+    "fs-extra": "^11.4.1",
+    "prompts": "^2.4.2"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "sync-templates": "node scripts/sync-templates.js",
+    "sync-templates:check": "node scripts/sync-templates.js --check",
+    "regen-migration": "node scripts/regenerate-template-migration.js",
+    "smoke:published": "node scripts/smoke-published.js",
+    "test": "node test-cli.js && node --test src/utils.test.js && node --test src/prepare-hooks.test.js && node --test src/scaffold-output.test.js && node --test src/template-scripts.test.js && node --test src/scaffold-guards.test.js && node --test src/worker-dockerfile.test.js && node --test src/dependabot-config.test.js && node --test 'src/deploy/**/*.test.js' && node --test --test-concurrency=1 'src/deploy/**/*.integration.test.js'",
+    "test:build": "node test-build.js",
+    "test:e2e": "node test-e2e.js",
+    "test:e2e:full": "node test-e2e-full.js",
+    "test:integration": "node test-integration.js",
+    "test:flags": "node --test test-flags.js",
+    "test:all": "node test-all.js",
+    "check:perf": "node scripts/check-e2e-perf.js"
+  }
+}

package/src/index.js

@@ -352,7 +352,7 @@ function buildFeatureRows(features) {
 		.map((feature) => rows[feature]);
 
 	if (selectedRows.length === 0) {
-		return "| Optional scaffolded features | None selected yet | Add one later with `npx @techstream/quark-create-app add <feature>` |";
+		return "| Optional scaffolded features | None selected yet | Add one later with `npx @usequark/quark-create-app add <feature>` |";
 	}
 
 	return selectedRows.join("\n");
@@ -411,7 +411,7 @@ function formatFeatureSummary(features) {
 }
 
 /**
- * Registry pin for @techstream/quark-core in scaffolded apps.
+ * Registry pin for @usequark/quark-core in scaffolded apps.
  * Mirrors sync-templates.js CORE_VERSION_PIN (major.0.0 from baked templates).
  */
 function getCoreVersionPin() {
@@ -419,7 +419,7 @@ function getCoreVersionPin() {
 		const webPkg = fs.readJSONSync(
 			path.join(templatesDir, "base-project/apps/web/package.json"),
 		);
-		const pin = webPkg?.dependencies?.["@techstream/quark-core"];
+		const pin = webPkg?.dependencies?.["@usequark/quark-core"];
 		if (typeof pin === "string" && pin !== "workspace:*") {
 			return pin;
 		}
@@ -430,21 +430,21 @@ function getCoreVersionPin() {
 }
 
 /**
- * Replace @techstream/quark-* workspace deps with @scope/* for local packages.
+ * Replace @usequark/quark-* workspace deps with @scope/* for local packages.
  * Also removes deps for packages that were not selected.
- * @techstream/quark-core is a published registry package — rewrite workspace:*
+ * @usequark/quark-core is a published registry package — rewrite workspace:*
  * to the registry pin instead of deleting or rescoping it.
  */
 function replaceDepsScope(deps, scope, selectedPackages) {
 	if (!deps) return;
 	for (const [key, value] of Object.entries(deps)) {
-		if (key.startsWith("@techstream/quark-") && value === "workspace:*") {
+		if (key.startsWith("@usequark/quark-") && value === "workspace:*") {
 			// Published registry package — keep name, pin to registry version.
-			if (key === "@techstream/quark-core") {
+			if (key === "@usequark/quark-core") {
 				deps[key] = getCoreVersionPin();
 				continue;
 			}
-			const packageName = key.replace("@techstream/quark-", "");
+			const packageName = key.replace("@usequark/quark-", "");
 			delete deps[key];
 			// Only keep the dep if the package was selected (or is always required)
 			if (
@@ -490,9 +490,9 @@ async function patchNextConfig(webDir, scope, selectedPackages) {
 }
 
 /**
- * Replace @techstream/quark-* import paths in all .js source files
+ * Replace @usequark/quark-* import paths in all .js source files
  * for workspace packages (db, jobs, ui, config) with @scope/* equivalents.
- * Registry packages (@techstream/quark-core) are left untouched.
+ * Registry packages (@usequark/quark-core) are left untouched.
  */
 async function replaceImportsInSourceFiles(dir, scope) {
 	const workspacePackages = ["db", "jobs", "ui", "config"];
@@ -512,7 +512,7 @@ async function replaceImportsInSourceFiles(dir, scope) {
 			let changed = false;
 
 			for (const pkg of workspacePackages) {
-				const pattern = new RegExp(`@techstream/quark-${pkg}`, "g");
+				const pattern = new RegExp(`@usequark/quark-${pkg}`, "g");
 				if (pattern.test(content)) {
 					content = content.replace(pattern, `@${scope}/${pkg}`);
 					changed = true;
@@ -1694,7 +1694,7 @@ STORAGE_PROVIDER=local
 
 			console.log(
 				chalk.dim(
-					`  📖 github.com/usequark/quark  •  Updates: npx @techstream/quark-create-app update\n`,
+					`  📖 github.com/usequark/quark  •  Updates: npx @usequark/quark-create-app update\n`,
 				),
 			);
 		} catch (error) {
@@ -2635,7 +2635,7 @@ program
  * Read the installed version of a package from node_modules.
  * Returns null if the package is not installed.
  * @param {string} cwd - Project root
- * @param {string} packageName - e.g. "@techstream/quark-core"
+ * @param {string} packageName - e.g. "@usequark/quark-core"
  * @returns {Promise<string|null>}
  */
 async function getInstalledVersion(cwd, packageName) {
@@ -2713,8 +2713,8 @@ program
 
 		// The packages this command manages
 		const MANAGED_PACKAGES = [
-			"@techstream/quark-core",
-			"@techstream/quark-create-app",
+			"@usequark/quark-core",
+			"@usequark/quark-create-app",
 		];
 
 		// Snapshot installed versions before any update
@@ -2726,7 +2726,7 @@ program
 		console.log(chalk.cyan(`Scaffolded:      ${quarkLink.scaffoldedDate}`));
 		console.log(
 			chalk.cyan(
-				`Installed core:  ${before["@techstream/quark-core"] ?? quarkLink.quarkVersion ?? "unknown"}\n`,
+				`Installed core:  ${before["@usequark/quark-core"] ?? quarkLink.quarkVersion ?? "unknown"}\n`,
 			),
 		);
 
@@ -2818,7 +2818,7 @@ program
 
 			// Persist the new core version - keep previous on failure, never write garbage
 			const newCoreVersion =
-				after["@techstream/quark-core"] ?? quarkLink.quarkVersion;
+				after["@usequark/quark-core"] ?? quarkLink.quarkVersion;
 			quarkLink.quarkVersion = newCoreVersion;
 			quarkLink.updatedDate = new Date().toISOString();
 			await fs.writeFile(quarkLinkPath, JSON.stringify(quarkLink, null, "	"));

package/src/mobile-template.test.js

@@ -66,7 +66,7 @@ test("mobile package.json has no monorepo workspace refs in devDependencies", ()
 	if (pkg.devDependencies) {
 		for (const dep of Object.keys(pkg.devDependencies)) {
 			assert.ok(
-				!dep.startsWith("@techstream/quark-"),
+				!dep.startsWith("@usequark/quark-"),
 				`mobile devDependencies has monorepo ref: ${dep}`,
 			);
 		}

package/src/scaffold-output.test.js

@@ -96,6 +96,56 @@ describe("scaffold output placeholders", () => {
 		);
 	});
 
+	// Guards the scope rewrite itself. replaceDepsScope and
+	// replaceImportsInSourceFiles map the framework scope onto the project's own
+	// scope for db/jobs/ui/config, and leave the published quark-core registry
+	// dependency alone on purpose.
+	//
+	// db, jobs, ui and config are local-only workspace packages and have never
+	// been published to any registry, so a framework-scoped reference surviving
+	// into generated output produces a project that cannot install. Nothing else
+	// catches that: the placeholder test above only looks for __QUARK_ and
+	// @myquark, so a rewrite rule that silently stopped matching - because a
+	// template and its rule drifted apart - left every test in this repo green
+	// while every scaffolded app was broken.
+	//
+	// Both scopes are asserted. @techstream is the pre-rename scope and must not
+	// appear at all; @usequark is the current one and must not appear for the
+	// local-only packages, though @usequark/quark-core is expected and correct.
+	//
+	// Scoped to files that participate in module resolution. Markdown and .mdc
+	// instruction files legitimately name the framework scope in order to tell an
+	// agent never to import it - .cursor/rules/quark.mdc ships exactly that
+	// prohibition, alongside deliberately-wrong import examples. Prose cannot
+	// break an install; an import or a dependency can.
+	it("never leaks a framework-scoped reference to a local-only package", () => {
+		const RESOLVABLE = /\.(js|jsx|mjs|cjs|ts|tsx)$/;
+		const localOnly = /@(techstream|usequark)\/quark-(db|jobs|ui|config)\b/;
+		const offenders = [];
+
+		for (const file of collectFiles(projectDir)) {
+			const rel = path.relative(projectDir, file);
+			const base = path.basename(file);
+			if (base !== "package.json" && !RESOLVABLE.test(base)) continue;
+
+			let content;
+			try {
+				content = fs.readFileSync(file, "utf-8");
+			} catch {
+				continue;
+			}
+			if (localOnly.test(content)) {
+				offenders.push(rel);
+			}
+		}
+
+		assert.deepStrictEqual(
+			offenders,
+			[],
+			`local-only packages must be rewritten to the project scope; leaked in: ${offenders.join(", ")}`,
+		);
+	});
+
 	it("rewrites the DB import in AI prompts to the project scope", () => {
 		const page = fs.readFileSync(
 			path.join(projectDir, "apps/web/src/app/page.js"),

package/src/template-scripts.test.js

@@ -115,7 +115,7 @@ describe("check-loading.mjs", () => {
 		writeFile(
 			dir,
 			"apps/web/src/app/metrics/page.js",
-			'import { prisma } from "@techstream/quark-db";\n\nexport default function Page() {\n\treturn null;\n}\n',
+			'import { prisma } from "@usequark/quark-db";\n\nexport default function Page() {\n\treturn null;\n}\n',
 		);
 
 		const result = runScript(dir, "scripts/check-loading.mjs");

package/src/utils.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import { execa } from "execa";
 
 /**
- * Shared utilities for @techstream/quark-create-app
+ * Shared utilities for @usequark/quark-create-app
  */
 
 export function sleep(ms) {

package/templates/base-project/.cursor/rules/quark.mdc

@@ -15,10 +15,10 @@ Scaffolded: __QUARK_SCAFFOLD_DATE__
 1. **ESM only.** Always `import`/`export`. Never `require()` or `module.exports`.
 2. **No authored TypeScript.** Plain `.js` and `.jsx` files only - no repo-authored `.ts`, `.tsx`, or type annotations. Generated code is the only exception.
 3. **Validate everything at boundaries.** Server Actions and API routes must use Zod. No raw `req.body` access without parsing.
-4. **Use AppError at runtime boundaries.** Throw `AppError` / `ValidationError` / `NotFoundError` from `@techstream/quark-core/errors` in application/runtime code. Native `Error` is reserved for library, bootstrap, CLI, and test code.
-5. **Log with createLogger in runtime code.** Use `createLogger(name)` from `@techstream/quark-core` for application/runtime code. Console output is reserved for bootstrap, CLI, and test code.
+4. **Use AppError at runtime boundaries.** Throw `AppError` / `ValidationError` / `NotFoundError` from `@usequark/quark-core/errors` in application/runtime code. Native `Error` is reserved for library, bootstrap, CLI, and test code.
+5. **Log with createLogger in runtime code.** Use `createLogger(name)` from `@usequark/quark-core` for application/runtime code. Console output is reserved for bootstrap, CLI, and test code.
 6. **DB models always have timestamps.** Every Prisma model: `createdAt DateTime @default(now())` + `updatedAt DateTime @updatedAt`.
-7. **Workspace import scope.** Use `@__QUARK_SCOPE__/*` for local packages. Never `@techstream/quark-db`, `@techstream/quark-config`, etc.
+7. **Workspace import scope.** Use `@__QUARK_SCOPE__/*` for local packages. Never `@usequark/quark-db`, `@usequark/quark-config`, etc.
 8. **Co-located tests.** `feature.test.js` lives next to `feature.js`. Tests use `node --test` - no Jest, no Vitest.
 
 ---
@@ -32,16 +32,16 @@ import { loadConfig }            from "@__QUARK_SCOPE__/config";
 import { Button, Card, Input }   from "@__QUARK_SCOPE__/ui";
 import { JOB_TYPES }             from "@__QUARK_SCOPE__/jobs";
 
-// ✅ Published runtime - @techstream/quark-core:
-import { AppError, ValidationError, NotFoundError } from "@techstream/quark-core/errors";
-import { createLogger, getCurrentSession }          from "@techstream/quark-core";
-import { createQueue, addJob }                      from "@techstream/quark-core";
-import { metrics, cache, storage }                  from "@techstream/quark-core";
+// ✅ Published runtime - @usequark/quark-core:
+import { AppError, ValidationError, NotFoundError } from "@usequark/quark-core/errors";
+import { createLogger, getCurrentSession }          from "@usequark/quark-core";
+import { createQueue, addJob }                      from "@usequark/quark-core";
+import { metrics, cache, storage }                  from "@usequark/quark-core";
 
 // ❌ Never:
 import { Button } from "@/components/ui/button";     // wrong path convention
-import { prisma } from "@techstream/quark-db";        // wrong scope for workspace pkg
-import something  from "@techstream/quark-config";    // wrong scope for workspace pkg
+import { prisma } from "@usequark/quark-db";        // wrong scope for workspace pkg
+import something  from "@usequark/quark-config";    // wrong scope for workspace pkg
 ```
 
 ---
@@ -63,8 +63,8 @@ import something  from "@techstream/quark-config";    // wrong scope for workspa
 ```javascript
 "use server";
 import { z } from "zod";
-import { ValidationError, AppError } from "@techstream/quark-core/errors";
-import { getCurrentSession, createLogger } from "@techstream/quark-core";
+import { ValidationError, AppError } from "@usequark/quark-core/errors";
+import { getCurrentSession, createLogger } from "@usequark/quark-core";
 import { prisma } from "@__QUARK_SCOPE__/db";
 
 const log = createLogger("action:example");
@@ -89,8 +89,8 @@ export async function createExample(formData) {
 
 ```javascript
 import { NextResponse } from "next/server";
-import { AppError } from "@techstream/quark-core/errors";
-import { createLogger } from "@techstream/quark-core";
+import { AppError } from "@usequark/quark-core/errors";
+import { createLogger } from "@usequark/quark-core";
 
 const log = createLogger("api:example");
 
@@ -119,7 +119,7 @@ export async function GET(request) {
 ## Auth
 
 ```javascript
-import { getCurrentSession } from "@techstream/quark-core";
+import { getCurrentSession } from "@usequark/quark-core";
 
 const session = await getCurrentSession();       // null if unauthenticated
 if (!session) redirect("/login");                // Server Component
@@ -133,13 +133,13 @@ if (session.user.role !== "ADMIN") throw new AppError("Forbidden", 403);
 
 ```javascript
 // Dispatch (from Server Action or API route):
-import { createQueue, addJob } from "@techstream/quark-core";
+import { createQueue, addJob } from "@usequark/quark-core";
 import { JOB_TYPES } from "@__QUARK_SCOPE__/jobs";
 const queue = createQueue("default");
 await addJob(queue, JOB_TYPES.MY_JOB, { userId });
 
 // Handle (apps/worker/src/handlers/):
-import { createLogger } from "@techstream/quark-core";
+import { createLogger } from "@usequark/quark-core";
 const log = createLogger("job:my-job");
 export async function handleMyJob({ data }) { log.info("processing", data); }
 ```

package/templates/base-project/.github/copilot-instructions.md

@@ -16,10 +16,10 @@
 - **ESM only** - `import`/`export` everywhere. Never `require()`.
 - **No authored TypeScript** - `.js` and `.jsx` only. Generated code may emit typed artifacts, but project code should not add `.ts` or `.tsx` sources.
 - **Validate at every boundary** - Zod schemas on all Server Actions and API routes.
-- **Errors** - `AppError` / `ValidationError` from `@techstream/quark-core/errors` in app/runtime code. Native `Error` is acceptable in library, bootstrap, CLI, and test code.
-- **Logging** - `createLogger(name)` from `@techstream/quark-core` in app/runtime code. Console output is acceptable in bootstrap, CLI, and test code.
+- **Errors** - `AppError` / `ValidationError` from `@usequark/quark-core/errors` in app/runtime code. Native `Error` is acceptable in library, bootstrap, CLI, and test code.
+- **Logging** - `createLogger(name)` from `@usequark/quark-core` in app/runtime code. Console output is acceptable in bootstrap, CLI, and test code.
 - **DB models** - Always add `createdAt` and `updatedAt` to every Prisma model.
-- **Workspace imports** - Use `@__QUARK_SCOPE__/*` for local packages (`db`, `config`, `ui`, `jobs`). Never `@techstream/quark-db` etc.
+- **Workspace imports** - Use `@__QUARK_SCOPE__/*` for local packages (`db`, `config`, `ui`, `jobs`). Never `@usequark/quark-db` etc.
 - **Tests** - Co-located `*.test.js`, run with `node --test`.
 
 ## Import Patterns
@@ -32,8 +32,8 @@ import { Button, Card, Input }   from "@__QUARK_SCOPE__/ui";
 import { JOB_TYPES }             from "@__QUARK_SCOPE__/jobs";
 
 // Published runtime:
-import { AppError, ValidationError } from "@techstream/quark-core/errors";
-import { createLogger, getCurrentSession, createQueue, addJob } from "@techstream/quark-core";
+import { AppError, ValidationError } from "@usequark/quark-core/errors";
+import { createLogger, getCurrentSession, createQueue, addJob } from "@usequark/quark-core";
 ```
 
 ## UI & Design System

package/templates/base-project/.github/skills/project-context/SKILL.md

@@ -12,7 +12,7 @@ This is a Quark-based full-stack JavaScript application.
 | Property | Value |
 |---|---|
 | **Scope** | `@__QUARK_SCOPE__` |
-| **Framework** | Quark (scaffolded from `@techstream/quark-create-app`) |
+| **Framework** | Quark (scaffolded from `@usequark/quark-create-app`) |
 | **Scaffolded** | __QUARK_SCAFFOLD_DATE__ |
 
 ## Project Structure
@@ -50,11 +50,11 @@ __QUARK_OPTIONAL_PACKAGES__├── docker-compose.yml
 
 - **ESM only** - use `import`/`export`, never `require`.
 - **No authored TypeScript** - plain `.js` and `.jsx` files. Generated code may emit typed artifacts, but project code should not add `.ts` or `.tsx` sources.
-- **Imports:** Use `@techstream/quark-core` for published utilities. Use `@__QUARK_SCOPE__/*` for local packages (db, config, ui, jobs).
+- **Imports:** Use `@usequark/quark-core` for published utilities. Use `@__QUARK_SCOPE__/*` for local packages (db, config, ui, jobs).
 - **Tests:** Co-located `*.test.js` files, run with `node --test`.
 - **Validation:** Zod schemas for all Server Actions and API routes.
-- **Errors:** Use `AppError` / `ValidationError` from `@techstream/quark-core/errors` in app/runtime code. Native `Error` is acceptable in library, bootstrap, CLI, and test code.
-- **Logging:** Use `createLogger(name)` from `@techstream/quark-core` in app/runtime code. Console output is acceptable in bootstrap, CLI, and test code.
+- **Errors:** Use `AppError` / `ValidationError` from `@usequark/quark-core/errors` in app/runtime code. Native `Error` is acceptable in library, bootstrap, CLI, and test code.
+- **Logging:** Use `createLogger(name)` from `@usequark/quark-core` in app/runtime code. Console output is acceptable in bootstrap, CLI, and test code.
 - **Database models:** Always include `createdAt`/`updatedAt`.
 - **Environment:** All env vars validated in `packages/config/src/validate-env.js`.
 - **Analytics:** Optional Umami support lives in `apps/web/src/lib/analytics/*`. The public env contract uses only `NEXT_PUBLIC_UMAMI_URL`, `NEXT_PUBLIC_UMAMI_WEBSITE_ID`, and `NEXT_PUBLIC_UMAMI_REPLAY_ENABLED`; replay uses a local rrweb recorder, and dormant helpers exist for dashboard-generated Umami Links, Pixels, and marketing-email snippets.
@@ -86,8 +86,8 @@ docker compose up -d  # Start infrastructure
 ## Updating Quark Core
 
 ```bash
-npx @techstream/quark-create-app update   # Update core infrastructure
-pnpm update @techstream/quark-core        # Or update directly
+npx @usequark/quark-create-app update   # Update core infrastructure
+pnpm update @usequark/quark-core        # Or update directly
 ```
 
 ---