generator-folklore 3.0.56 → 3.0.58

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

@@ -4,11 +4,11 @@ Branching follows Gitflow, kept light. `develop` is where development happens: e
 
 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)
+### Work straight on `develop` (default)
 
-- Small changes asked for directly in conversation: fixes, style or copy tweaks, translations, content. The request was reviewed by being asked for.
+- Small changes asked for directly in conversation: fixes, style or copy tweaks, translations, content.
 - Documentation, comments and config with no runtime effect.
-- Run the checks before committing. Never push unless asked.
+- Run the checks , then stop and leave the changes uncommitted: the maintainer reviews them before they land. Commit only when explicitly asked to. Never push unless asked.
 
 ### Use an issue and a PR
 
@@ -25,7 +25,7 @@ What decides the flow is where the request came from and what it touches, not th
 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.
+5. Commit on the issue branch as the work progresses, without asking: the PR is where the review happens. 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`.

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.56",
+    "version": "3.0.58",
     "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": "588abc69c30c5a8954352431f3aed90375582714"
+    "gitHead": "a4ecca2cee44ea11eb45fcfce91ff64404571ab8"
 }