generator-folklore 3.0.55 → 3.0.57

package/lib/generators/agents/index.js

@@ -22,7 +22,7 @@ class AgentsGenerator extends _generator.default {
     const hasPackageJson = this.fs.exists(this.destinationPath('package.json'));
     const existingContent = this.fs.exists(destPath) ? this.fs.read(destPath) : '';
     const separator = '\n\n---\n\n';
-    const parts = [this.fs.read(this.templatePath('general.md')), hasComposerJson ? this.fs.read(this.templatePath('laravel.md')) : null, hasPackageJson ? this.fs.read(this.templatePath('frontend.md')) : null, hasComposerJson ? this.fs.read(this.templatePath('serve-laravel.md')) : null, !hasComposerJson && hasPackageJson ? this.fs.read(this.templatePath('serve-html.md')) : null, this.fs.read(this.templatePath('after.md'))].filter(it => it !== null).join(separator);
+    const parts = [this.fs.read(this.templatePath('general.md')), this.fs.read(this.templatePath('workflow.md')), hasComposerJson ? this.fs.read(this.templatePath('laravel.md')) : null, hasPackageJson ? this.fs.read(this.templatePath('frontend.md')) : null, hasComposerJson ? this.fs.read(this.templatePath('serve-laravel.md')) : null, !hasComposerJson && hasPackageJson ? this.fs.read(this.templatePath('serve-html.md')) : null, this.fs.read(this.templatePath('after.md'))].filter(it => it !== null).join(separator);
     const newContent = existingContent.length > 0 ? `${existingContent}${separator}${parts}` : parts;
     this.fs.write(destPath, newContent);
   }

package/lib/generators/agents/templates/general.md

@@ -8,8 +8,8 @@ This file defines how coding agents should work in this repository.
 
 ## Language Rules
 
-- Write all code, comments, identifiers, commit messages, and technical docs in English.
-- User-facing chat can be in French, but repository content stays in English.
+- Everything written for people is in French: conversations, GitHub issues and their comments, pull request titles, bodies and review comments.
+- Code is always in English: identifiers, comments, file names, and commit messages.
 
 ## Editing Guidelines
 

package/lib/generators/agents/templates/serve-html.md

@@ -7,6 +7,7 @@ Without a backend, the dev server serves the project directly on `localhost`.
 
 Notes:
 
+- The `dev` configuration of `.claude/launch.json` runs these steps for Claude Code's browser preview.
 - Options reach `flklr` from `package.json` (`build` key), the environment (`FLKLR_*`) and the command line, the command line winning. Leave `package.json` as is and pass overrides on the command line.
 - HTTP avoids the dev server's self-signed certificate, which browsers reject. Use the default HTTPS only when a feature requires a secure context the browser won't grant to `localhost`.
 - Stop the dev server once testing is done.

package/lib/generators/agents/templates/serve-laravel.md

@@ -8,6 +8,7 @@ Always test a Laravel project through its `.test` domain, never `localhost`: som
 
 Notes:
 
+- The `dev` configuration of `.claude/launch.json` runs these steps for Claude Code's browser preview.
 - Options reach `flklr` from `package.json` (`build` key), the environment (`FLKLR_*`) and the command line, the command line winning. Leave `package.json` as is and pass overrides on the command line.
 - On a certificate error, see [Fixing Valet certificates](#fixing-valet-certificates) rather than switching to `localhost` or plain HTTP.
 - Stop the dev server once testing is done.

package/lib/generators/agents/templates/workflow.md

@@ -0,0 +1,43 @@
+## Development Workflow
+
+Branching follows Gitflow, kept light. `develop` is where development happens: every commit and every merge lands there first. `main` is production: it only receives `develop` when deploying to prod. The backlog is the repository's GitHub Issues; pull requests are where reviewed work lands. Most day-to-day work skips both: the issue/PR flow exists to run work in parallel and to review what deserves it, not to slow down small changes.
+
+On GitHub, `develop` is the default branch (so PRs target it and `Closes #<number>` closes issues on merge), and the `bug`, `enhancement` and `in-progress` labels exist.
+
+### Commit straight to `develop` (default)
+
+- Small changes asked for directly in conversation: fixes, style or copy tweaks, translations, content. The request was reviewed by being asked for.
+- Documentation, comments and config with no runtime effect.
+- Run the checks before committing. Never push unless asked.
+
+### Use an issue and a PR
+
+- A feature or a chunk of work that spans several sessions, or needs a written plan.
+- Work meant to run in parallel with other sessions.
+- Risky or broad changes: migrations, refactors, dependencies, routing, or any diff the maintainer would want to read.
+- Anything started from an existing issue.
+
+What decides the flow is where the request came from and what it touches, not the size of the diff. When unsure, ask.
+
+### Working an issue
+
+1. Read the issue and its comments first; they may change the plan.
+2. Add the `in-progress` label before starting: it stops a second session from picking the same issue. Remove it if the work is abandoned.
+3. For an `enhancement`, write a short plan in the issue body before coding. `bug` issues skip the plan.
+4. One branch per issue, prefixed by its type: `feature/<number>-<slug>` for an `enhancement`, `bug/<number>-<slug>` for a `bug` (other types follow the same pattern, e.g. `docs/`, `refactor/`). Branch from an up-to-date `develop`, in its own worktree under `.claude/worktrees/<number>-<slug>` so parallel sessions don't share a checkout.
+5. Run the checks, push and open the PR against `develop` with `Closes #<number>` in its body, without asking. If the change couldn't be verified in the session, list the test scenario as a checkbox list in the PR body.
+6. The issue closes when the PR merges into `develop`, never just because code was pushed. Remove the worktree (`git worktree remove`) once merged.
+
+Something out of scope noticed along the way becomes a new issue (title, context, files involved) rather than growing the current change. Every issue carries a type label: `bug` or `enhancement`.
+
+### Releasing to production
+
+When deploying, merge `develop` into `main` (only when asked). An urgent fix for prod goes on a `hotfix/<slug>` branch from `main`, merged into `main` and then into `develop` so the two don't diverge.
+
+### Checks
+
+Run the project's lint, format, typecheck and test scripts (see `package.json` and `composer.json`) on what changed. When the codebase has pre-existing errors, a check passes when it reports nothing new in the files touched.
+
+### Rules live in this file
+
+Rules that always apply to this project (workflow, conventions, setup) are written here, not in an agent's private memory, so every session and every teammate shares them.

package/lib/generators/claude/index.js

@@ -0,0 +1,55 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _chalk = _interopRequireDefault(require("chalk"));
+var _generator = _interopRequireDefault(require("../../lib/generator"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const launchArgs = {
+  laravel: ['run', 'server', '--', '--no-open'],
+  html: ['run', 'server', '--', '--server', 'http', '--no-open']
+};
+const defaultUrls = {
+  laravel: 'https://localhost:8080',
+  html: 'http://localhost:8080'
+};
+class ClaudeGenerator extends _generator.default {
+  constructor(...args) {
+    super(...args);
+    this.option('type', {
+      type: String,
+      desc: 'Project type: laravel (served through its .test domain) or html (served on localhost)',
+      defaults: 'html'
+    });
+    this.option('url', {
+      type: String,
+      desc: 'Url opened by the browser preview (defaults to the dev server url)'
+    });
+  }
+  prompting() {
+    if (this.options.quiet) {
+      return;
+    }
+    console.log(_chalk.default.yellow('\n----------------------'));
+    console.log('Claude Code Generator');
+    console.log(_chalk.default.yellow('----------------------\n'));
+  }
+  writing() {
+    const type = this.options.type === 'laravel' ? 'laravel' : 'html';
+    const url = (this.options.url || defaultUrls[type]).replace(/\/$/, '');
+    this.fs.writeJSON(this.destinationPath('.claude/launch.json'), {
+      version: '0.0.1',
+      configurations: [{
+        name: 'dev',
+        runtimeExecutable: 'npm',
+        runtimeArgs: launchArgs[type],
+        port: 8080,
+        url
+      }]
+    }, null, 4);
+    this.fs.copy(this.templatePath(`settings-${type}.json`), this.destinationPath('.claude/settings.json'));
+  }
+}
+exports.default = ClaudeGenerator;

package/lib/generators/claude/templates/settings-html.json

@@ -0,0 +1,31 @@
+{
+    "permissions": {
+        "allow": [
+            "Bash(npm run lint*)",
+            "Bash(npm run format*)",
+            "Bash(npm run typecheck)",
+            "Bash(npm run test*)",
+            "Bash(npm test*)",
+            "Bash(npm run server*)",
+            "Bash(npx prettier *)",
+            "Bash(npx eslint *)",
+            "Bash(npx stylelint *)",
+            "Bash(npx tsc --noEmit*)",
+            "Bash(gh issue view *)",
+            "Bash(gh issue list*)",
+            "Bash(gh issue create *)",
+            "Bash(gh issue edit *)",
+            "Bash(gh issue comment *)",
+            "Bash(gh pr view*)",
+            "Bash(gh pr list*)",
+            "Bash(gh pr diff*)",
+            "Bash(gh pr checks*)",
+            "Bash(gh pr create *)",
+            "Bash(gh pr edit *)",
+            "Bash(gh pr comment *)"
+        ],
+        "ask": [
+            "Bash(git push*)"
+        ]
+    }
+}

package/lib/generators/claude/templates/settings-laravel.json

@@ -0,0 +1,36 @@
+{
+    "permissions": {
+        "allow": [
+            "Bash(npm run lint*)",
+            "Bash(npm run format*)",
+            "Bash(npm run typecheck)",
+            "Bash(npm run test*)",
+            "Bash(npm test*)",
+            "Bash(npm run server*)",
+            "Bash(npx prettier *)",
+            "Bash(npx eslint *)",
+            "Bash(npx stylelint *)",
+            "Bash(npx tsc --noEmit*)",
+            "Bash(php artisan test*)",
+            "Bash(npx flklr certificates*)",
+            "Bash(npx flklr certs*)",
+            "Bash(gh issue view *)",
+            "Bash(gh issue list*)",
+            "Bash(gh issue create *)",
+            "Bash(gh issue edit *)",
+            "Bash(gh issue comment *)",
+            "Bash(gh pr view*)",
+            "Bash(gh pr list*)",
+            "Bash(gh pr diff*)",
+            "Bash(gh pr checks*)",
+            "Bash(gh pr create *)",
+            "Bash(gh pr edit *)",
+            "Bash(gh pr comment *)"
+        ],
+        "ask": [
+            "Bash(npx flklr certificates*--fix*)",
+            "Bash(npx flklr certs*--fix*)",
+            "Bash(git push*)"
+        ]
+    }
+}

package/lib/generators/html-project/index.js

@@ -154,6 +154,10 @@ class HTMLProjectGenerator extends _generator.default {
       'src-path': srcPath,
       quiet: true
     });
+    this.composeWith('folklore:claude', {
+      type: 'html',
+      quiet: true
+    });
     this.log('merging with folklore build');
     this.composeWith('folklore:build', {
       'src-path': srcPath,

package/lib/generators/html-project/templates/gitignore

@@ -34,3 +34,7 @@ node_modules
 /.sass-cache
 /.tmp
 /dist
+
+# Claude Code (shared settings and launch config are tracked)
+/.claude/settings.local.json
+/.claude/worktrees/

package/lib/generators/laravel-project/index.js

@@ -249,6 +249,14 @@ class LaravelProjectGenerator extends _generator.default {
       quiet: true,
       'skip-install': true
     });
+    this.composeWith('folklore:claude', {
+      type: 'laravel',
+      url: _lodashEs.default.template(_lodashEs.default.get(this.options, 'local-url'))({
+        project_host: this.options['project-host'],
+        project_name: this.options['project-name']
+      }),
+      quiet: true
+    });
     if (this.options.mediatheque) {
       this.composeWith('folklore:laravel-mediatheque', {
         'project-name': this.options['project-name'],
@@ -263,6 +271,11 @@ class LaravelProjectGenerator extends _generator.default {
         quiet: true
       });
     }
+
+    // Composed last so its writing runs once composer.json and package.json exist
+    this.composeWith('folklore:agents', {
+      quiet: true
+    });
   }
   get writing() {
     return {

package/lib/generators/laravel-project/templates/gitignore

@@ -22,7 +22,8 @@
 Homestead.json
 Homestead.yaml
 Thumbs.db
-/.claude
+/.claude/settings.local.json
+/.claude/worktrees/
 
 /public/static
 /public/asset-manifest.json

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "generator-folklore",
-    "version": "3.0.55",
+    "version": "3.0.57",
     "description": "Yeoman generator for projects at Folklore",
     "keywords": [
         "yeoman-generator"
@@ -40,5 +40,5 @@
         "yeoman-generator": "5.9.0",
         "yeoman-remote": "^1.0.1"
     },
-    "gitHead": "47b0be3c067e8ff829ed3f2bd713852cb5450c50"
+    "gitHead": "33526a939c8f63b563cdfd0560bb7ef5434eaa00"
 }