create-guren-app 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-guren-app",
3
- "version": "1.2.0",
3
+ "version": "1.3.0",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -33,3 +33,7 @@ MAIL_FROM_NAME="${APP_NAME}"
33
33
  # OAUTH_GOOGLE_CLIENT_ID=
34
34
  # OAUTH_GOOGLE_CLIENT_SECRET=
35
35
  # OAUTH_GOOGLE_REDIRECT_URI=http://localhost:3333/auth/google/callback
36
+
37
+ # OAUTH_DISCORD_CLIENT_ID=
38
+ # OAUTH_DISCORD_CLIENT_SECRET=
39
+ # OAUTH_DISCORD_REDIRECT_URI=http://localhost:3333/auth/discord/callback
@@ -0,0 +1,47 @@
1
+ ---
2
+ kind: adr
3
+ status: accepted
4
+ entities: []
5
+ related: []
6
+ ---
7
+
8
+ # Record architecture decisions
9
+
10
+ ## Context
11
+
12
+ Code shows *what* the system does; it cannot show *why*. Decisions —
13
+ business rules, trade-offs, rejected alternatives — live in people's
14
+ heads and get lost. AI coding agents working on this codebase have the
15
+ same problem: without recorded decisions they can only infer intent.
16
+
17
+ ## Decision
18
+
19
+ We record significant decisions as numbered ADRs in this directory,
20
+ created with:
21
+
22
+ ```bash
23
+ bunx guren make:adr "Title of the decision"
24
+ bunx guren make:adr "Title" --entity Invoice # prefills the links below
25
+ ```
26
+
27
+ Each ADR declares what it governs in its frontmatter:
28
+
29
+ - `entities: [Invoice]` — model class names the decision affects.
30
+ `bunx guren context Invoice` then surfaces this ADR to anyone (human
31
+ or agent) working on that model.
32
+ - `related: [app/Http/Controllers/InvoiceController.ts]` — files or
33
+ globs the decision touches.
34
+ - `status:` — `draft` → `accepted`; mark `superseded` when replaced
35
+ (and write the replacement).
36
+
37
+ Once declared, the links are verified: `bunx guren check` reports a
38
+ renamed file a doc points at, or a removed model a doc names, as a
39
+ failure, and `bunx guren check --docs` gates CI on it (non-zero exit).
40
+ Keep frontmatter current in the same change that moves the code.
41
+
42
+ ## Consequences
43
+
44
+ Decisions stay discoverable from the code they govern, at the cost of
45
+ writing them down and keeping links fresh — declared links are checked,
46
+ so they can be trusted. (An ADR with no links, like this one, is valid;
47
+ it simply isn't surfaced by `guren context`.)
@@ -1,6 +1,11 @@
1
1
  import { defineConfig } from 'drizzle-kit'
2
2
 
3
3
  export default defineConfig({
4
+ // `guren make:module` wires each modules/<name>/db/schema.ts into this
5
+ // file automatically via a re-export, so this single path is enough by
6
+ // default. If you'd rather point drizzle-kit at every module schema
7
+ // directly instead, `schema` also accepts an array of paths/globs, e.g.
8
+ // schema: ['./db/schema.ts', './modules/*/db/schema.ts'].
4
9
  schema: './db/schema.ts',
5
10
  out: './db/migrations',
6
11
  dialect: 'sqlite',
@@ -4,8 +4,8 @@
4
4
  "private": true,
5
5
  "type": "module",
6
6
  "scripts": {
7
- "dev": "bun run codegen && bun run dev:server",
8
- "dev:server": "bun bin/serve.ts",
7
+ "dev": "bun run codegen && GUREN_MCP=1 bun run dev:server",
8
+ "dev:server": "bun --hot bin/serve.ts",
9
9
  "codegen": "bunx guren codegen --routes routes/api.ts --force",
10
10
  "typecheck": "tsc --noEmit",
11
11
  "db:make": "bunx guren make:migration",
@@ -37,5 +37,9 @@ MAIL_FROM_NAME="${APP_NAME}"
37
37
  # OAUTH_GOOGLE_CLIENT_SECRET=
38
38
  # OAUTH_GOOGLE_REDIRECT_URI=http://localhost:3333/auth/google/callback
39
39
 
40
+ # OAUTH_DISCORD_CLIENT_ID=
41
+ # OAUTH_DISCORD_CLIENT_SECRET=
42
+ # OAUTH_DISCORD_REDIRECT_URI=http://localhost:3333/auth/discord/callback
43
+
40
44
  # Optional: point to an already-running external Vite dev server.
41
45
  # VITE_DEV_SERVER_URL=http://localhost:5173
@@ -0,0 +1,47 @@
1
+ ---
2
+ kind: adr
3
+ status: accepted
4
+ entities: []
5
+ related: []
6
+ ---
7
+
8
+ # Record architecture decisions
9
+
10
+ ## Context
11
+
12
+ Code shows *what* the system does; it cannot show *why*. Decisions —
13
+ business rules, trade-offs, rejected alternatives — live in people's
14
+ heads and get lost. AI coding agents working on this codebase have the
15
+ same problem: without recorded decisions they can only infer intent.
16
+
17
+ ## Decision
18
+
19
+ We record significant decisions as numbered ADRs in this directory,
20
+ created with:
21
+
22
+ ```bash
23
+ bunx guren make:adr "Title of the decision"
24
+ bunx guren make:adr "Title" --entity Invoice # prefills the links below
25
+ ```
26
+
27
+ Each ADR declares what it governs in its frontmatter:
28
+
29
+ - `entities: [Invoice]` — model class names the decision affects.
30
+ `bunx guren context Invoice` then surfaces this ADR to anyone (human
31
+ or agent) working on that model.
32
+ - `related: [app/Http/Controllers/InvoiceController.ts]` — files or
33
+ globs the decision touches.
34
+ - `status:` — `draft` → `accepted`; mark `superseded` when replaced
35
+ (and write the replacement).
36
+
37
+ Once declared, the links are verified: `bunx guren check` reports a
38
+ renamed file a doc points at, or a removed model a doc names, as a
39
+ failure, and `bunx guren check --docs` gates CI on it (non-zero exit).
40
+ Keep frontmatter current in the same change that moves the code.
41
+
42
+ ## Consequences
43
+
44
+ Decisions stay discoverable from the code they govern, at the cost of
45
+ writing them down and keeping links fresh — declared links are checked,
46
+ so they can be trusted. (An ADR with no links, like this one, is valid;
47
+ it simply isn't surfaced by `guren context`.)
@@ -1,6 +1,11 @@
1
1
  import { defineConfig } from 'drizzle-kit'
2
2
 
3
3
  export default defineConfig({
4
+ // `guren make:module` wires each modules/<name>/db/schema.ts into this
5
+ // file automatically via a re-export, so this single path is enough by
6
+ // default. If you'd rather point drizzle-kit at every module schema
7
+ // directly instead, `schema` also accepts an array of paths/globs, e.g.
8
+ // schema: ['./db/schema.ts', './modules/*/db/schema.ts'].
4
9
  schema: './db/schema.ts',
5
10
  out: './db/migrations',
6
11
  dialect: 'sqlite',
@@ -5,8 +5,8 @@
5
5
  "type": "module",
6
6
  "scripts": {
7
7
  "codegen": "bunx guren codegen --force",
8
- "dev": "bun run codegen && bun run dev:server",
9
- "dev:server": "bun bin/serve.ts",
8
+ "dev": "bun run codegen && GUREN_MCP=1 bun run dev:server",
9
+ "dev:server": "bun --hot bin/serve.ts",
10
10
  "typecheck": "tsc --noEmit",
11
11
  "build": "bun run codegen && bunx vite build",
12
12
  "preview": "NODE_ENV=production bun bin/serve.ts",