anhedral 0.1.0 → 0.1.1

package/README.md

@@ -9,31 +9,31 @@ Opinionated init CLI for product teams shipping with Next.js, Expo, Fastify, Dri
 
 ## Usage
 
-Run the CLI directly without installing it globally:
+Run the latest published CLI directly without installing it globally:
 
 ```sh
-pnpm dlx anhedral init next
-pnpm dlx anhedral init next-fullstack
-pnpm dlx anhedral init expo-fullstack
-pnpm dlx anhedral init backend
+pnpm dlx anhedral@latest init next
+pnpm dlx anhedral@latest init next-fullstack
+pnpm dlx anhedral@latest init expo-fullstack
+pnpm dlx anhedral@latest init backend
 ```
 
 ```sh
-npx anhedral init next
-npx anhedral init next-fullstack
-npx anhedral init expo-fullstack
-npx anhedral init backend
+npx anhedral@latest init next
+npx anhedral@latest init next-fullstack
+npx anhedral@latest init expo-fullstack
+npx anhedral@latest init backend
 ```
 
 Global install also works:
 
 ```sh
-pnpm add -g anhedral
+pnpm add -g anhedral@latest
 anhedral init next
 ```
 
 ```sh
-npm install -g anhedral
+npm install -g anhedral@latest
 anhedral init next
 ```
 
@@ -58,8 +58,66 @@ pnpm test:all
 
 This package is published once to the npm registry. `pnpm`, `npm`, `yarn`, and `bun` users all install that same published package.
 
+Manual local publish still works:
+
 ```sh
 pnpm build
 pnpm test:all
 npm publish
 ```
+
+GitHub Actions release automation is also configured in `.github/workflows/release.yml`.
+
+Recommended release flow:
+
+```sh
+pnpm release:check
+npm version patch
+git push --follow-tags
+```
+
+The release workflow will publish on tags like `v0.1.1`. For npm trusted publishing, configure the package on npmjs.com to trust the `release.yml` workflow in `anhedral/anhedral-init`.
+
+## Maintenance
+
+This repo is now maintained in two lanes:
+
+- `stable`: the default user-facing toolchain, pinned to known-good upstream CLI versions in `src/toolchain.ts`.
+- `latest`: an early-warning lane that tracks upstream scaffold tools without pinning, so breakage is detected before it reaches the default path.
+
+The practical rule is simple: detect drift on `latest`, verify it, then promote the pinned `stable` versions only after the e2e matrix passes.
+
+### Recommended automation
+
+- Renovate is configured in `renovate.json` to keep this repo's own dependencies current.
+- GitHub Actions CI runs on pushes and pull requests in `.github/workflows/ci.yml`.
+- Weekly toolchain drift checks run in `.github/workflows/toolchain-drift.yml` for both `stable` and `latest`.
+- Tagged releases publish through `.github/workflows/release.yml`.
+- Stable toolchain pins in `src/toolchain.ts` are annotated so Renovate can open PRs when upstream scaffold CLIs publish updates.
+- `prepublishOnly` stays strict. Every publish still runs `pnpm test:all`.
+
+### Upgrade workflow
+
+Use this sequence when Renovate opens a dependency or toolchain PR:
+
+```sh
+pnpm install --frozen-lockfile
+pnpm test
+pnpm test:e2e
+npm pack --dry-run
+```
+
+If you want to validate upstream scaffold drift manually, use the explicit latest-lane script:
+
+```sh
+pnpm test:e2e:latest
+```
+
+When a toolchain pin PR passes and the generated outputs look good, update the `verifiedAt` date in `src/toolchain.ts` and release normally.
+
+### Release policy
+
+- Publish `patch` releases for scaffold fixes, dependency bumps, and safer defaults.
+- Publish `minor` releases for new stacks, new flags, or new generated capabilities.
+- Publish `major` releases for breaking CLI changes or incompatible generated-project structure changes.
+- Never publish from a dirty worktree.

package/dist/branding.d.ts

@@ -1,3 +1,5 @@
 export declare const ANHEDRAL_LOGO_FILE_NAME = "anhedral.svg";
 export declare const ANHEDRAL_LOGO_PUBLIC_PATH = "/anhedral.svg";
+export declare const ANHEDRAL_FAVICON_FILE_NAME = "favicon.ico";
 export declare function writeAnhedralLogo(root: string): void;
+export declare function writeAnhedralWebBranding(root: string): void;

package/dist/branding.js

@@ -1,9 +1,17 @@
-import { readFileSync } from 'node:fs';
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { writeFile } from './util.js';
 export const ANHEDRAL_LOGO_FILE_NAME = 'anhedral.svg';
 export const ANHEDRAL_LOGO_PUBLIC_PATH = `/${ANHEDRAL_LOGO_FILE_NAME}`;
+export const ANHEDRAL_FAVICON_FILE_NAME = 'favicon.ico';
 const ANHEDRAL_LOGO_SVG = readFileSync(new URL('../anhedral.svg', import.meta.url), 'utf8');
+const ANHEDRAL_FAVICON = readFileSync(new URL(`../${ANHEDRAL_FAVICON_FILE_NAME}`, import.meta.url));
 export function writeAnhedralLogo(root) {
     writeFile(path.join(root, 'public', ANHEDRAL_LOGO_FILE_NAME), ANHEDRAL_LOGO_SVG);
 }
+export function writeAnhedralWebBranding(root) {
+    writeAnhedralLogo(root);
+    const faviconPath = path.join(root, 'app', ANHEDRAL_FAVICON_FILE_NAME);
+    mkdirSync(path.dirname(faviconPath), { recursive: true });
+    writeFileSync(faviconPath, ANHEDRAL_FAVICON);
+}

package/dist/commands.js

@@ -21,7 +21,7 @@ export function getDefaultWebInitCommand(toolchain, projectName) {
 export function getDefaultWebDependencyCommands() {
     return [
         {
-            cmd: 'pnpm add @clerk/nextjs @clerk/ui drizzle-orm @neondatabase/serverless stripe @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner',
+            cmd: 'pnpm add @clerk/nextjs drizzle-orm @neondatabase/serverless stripe @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner',
             skippable: true,
         },
         {