Develop

.devcontainer/devcontainer.json

@@ -0,0 +1,26 @@
+{
+    "name": "Go Dev Container",
+    "image": "mcr.microsoft.com/devcontainers/go:1-1.24-bookworm",
+    "features": {
+        "ghcr.io/devcontainers/features/docker-in-docker:2": {}
+    },
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "golang.go",
+                "ms-azuretools.vscode-docker",
+                "ms-azuretools.vscode-containers",
+                "ms-vscode-remote.remote-containers",
+                "DigitalBrainstem.javascript-ejs-support",
+                "mhutchie.git-graph",
+                "shadowdara.samfile",
+                "bradlc.vscode-tailwindcss",
+                "github.vscode-github-actions"
+            ]
+        }
+    },
+    "forwardPorts": [
+        8080
+    ],
+    "postCreateCommand": "go mod download"
+}

.finder/shema/finder-template.v2.schema.json

@@ -9,7 +9,11 @@
     },
     "name": {
       "type": "string",
-      "description": "Name of the folder or template."
+      "description": "Name pattern of the folder or template (exact name or glob)."
+    },
+    "name_regex": {
+      "type": "string",
+      "description": "Optional regular expression matched against the folder name (Go RE2)."
     },
     "folders": {
       "type": "array",
@@ -41,6 +45,7 @@
       "type": "object",
       "properties": {
         "name": { "type": "string" },
+        "name_regex": { "type": "string" },
         "existence": {
           "type": "string",
           "enum": ["required", "forbidden", "optional"],
@@ -54,6 +59,7 @@
       "properties": {
         "description": { "type": "string" },
         "name": { "type": "string" },
+        "name_regex": { "type": "string" },
         "folders": {
           "type": "array",
           "items": { "$ref": "#/definitions/folder" }

.finder/templates/folderimages.json5

@@ -3,9 +3,9 @@
   "description": "search for folders with images",
   "files": [
     {
-      "name": "(?:\\.(?:j(?:p(?:eg?|g)|if|fif?|xl)|png|gif|webp|a(?:vif|png)|svg|bmp|ico|tiff|hei[cf]))$"
+      "name_regex": "(?:\\.(?:j(?:p(?:eg?|g)|if|fif?|xl)|png|gif|webp|a(?:vif|png)|svg|bmp|ico|tiff|hei[cf]))$"
     }
   ],
-  "min_version": "0.3.17",
+  "min_version": "0.3.18",
   "mdnote_base64": "IyBUZW1wbGF0ZSB0byBzZWFyY2ggYWxsIGltYWdlIGZpbGVzCgojIyMgYmFja3VwIGZvciB0aGUgcmVnZXggY3JlYXRvcjoKCmBgYApleUoySWpveExDSmhJam9pTG1wd1oxeHVMbXB3WldkY2JpNXFjR1ZjYmk1cWFXWmNiaTVxWm1sbVhHNHVhbVpwWEc0dWNHNW5YRzR1WjJsbVhHNHVkMlZpY0Z4dUxtRjJhV1pjYmk1emRtZGNiaTVoY0c1blhHNHVZbTF3WEc0dWFXTnZYRzR1ZEdsbVpseHVMbXA0YkZ4dUxtaGxhV05jYmk1b1pXbG1JaXdpWkNJNklpSXNJbTBpT2lKbGJtUnpWMmwwYUNJc0lta2lPbVpoYkhObGZRPT0KYGBg"
 }

.finder/templates/test_name_regex.json5

@@ -0,0 +1,11 @@
+{
+  "name": "*",
+  "name_regex": "^project-[0-9]+$",
+  "description": "test name_regex matching",
+  "files": [
+    {
+      "name_regex": "^main\\.py$",
+      "existence": "required"
+    }
+  ]
+}

.gitattributes

@@ -9,9 +9,9 @@
 # mark samfile as shell
 samfile linguist-language=Shell
 
-go.work linguist-language=go
-go.mod linguist-language=go
-go.sum linguist-language=go
+go.work linguist-language=Go
+go.mod linguist-language=Go
+go.sum linguist-language=Go
 
 docker-compose.yml linguist-language=Dockerfile
 
@@ -29,3 +29,7 @@ docker-compose.yml linguist-language=Dockerfile
 /npm/site/src/templates.js linguist-vendored
 
 /.obsidian/** linguist-vendored
+
+/install2.sh linguist-vendored
+
+/.github/temp-stuff-idk linguist-vendored

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -6,29 +6,61 @@ body:
   - type: markdown
     attributes:
       value: |
-        Thanks for taking the time to file a bug report! Please answer the questions below.
-  - type: input
+        Thanks for taking the time to file a bug report! Please fill in as much detail as you can.
+
+  - type: textarea
     id: description
     attributes:
       label: Describe the bug
       description: What did you expect to happen? What happened instead?
       placeholder: "Detailed bug description"
+    validations:
       required: true
-  - type: input
+
+  - type: textarea
     id: steps
     attributes:
       label: Steps to Reproduce
       description: Provide step-by-step instructions to reproduce the bug
       placeholder: |
-        1. …
-        2. …
+        1. Run `./finder <template>` in ...
+        2. ...
+    validations:
+      required: true
+
   - type: input
     id: environment
     attributes:
       label: Environment
-      description: OS, version, go version, etc.
+      description: OS, finder version (`./finder --version`), Go version (if building from source)
+      placeholder: "Windows 11, finder 0.3.17, Go 1.22"
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        ---
+        ## Template-related bug?
+
+        If the bug is about a specific Finder template, please also fill in the sections below.
+
+  - type: input
+    id: template_name
+    attributes:
+      label: Affected template
+      description: Name of the template, e.g. `django` — leave empty if this is not template-related
+      placeholder: "django"
+
+  - type: textarea
+    id: template_content
+    attributes:
+      label: Template file
+      description: Paste the JSON5 template and describe the folder it should have matched (or link to the file)
+      render: json
+
   - type: textarea
     id: logs
     attributes:
       label: Logs / Screenshots
-      description: Paste any error messages or screenshots
+      description: Paste any error messages, terminal output, or screenshots

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -7,23 +7,31 @@ body:
     attributes:
       value: |
         Suggest a new feature or improvement. Please describe why this change is needed.
-  - type: input
+
+        > **Tip:** Looking for a new Finder template? Please use the dedicated **🧩 New Finder Template** issue form instead — it collects everything needed to review a template quickly.
+
+  - type: textarea
     id: goal
     attributes:
       label: What is the goal?
       description: Summarize the suggestion in your own words
+      placeholder: "Finder should be able to detect ..."
+    validations:
       required: true
+
   - type: textarea
     id: motivation
     attributes:
       label: Motivation and Context
       description: Why is this change valuable? What problem does it solve?
+
   - type: textarea
     id: implementation
     attributes:
       label: Possible Implementation
-      description: Optional ideas how this could be implemented
-  - type: input
+      description: Optional ideas on how this could be implemented
+
+  - type: textarea
     id: alternatives
     attributes:
       label: Alternatives considered

.github/ISSUE_TEMPLATE/new_template.yml

@@ -0,0 +1,91 @@
+name: 🧩 New Finder Template
+description: Propose or contribute a new Finder template (JSON5)
+title: "[TEMPLATE] <template-name>"
+labels: ["template", "enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for contributing a new Finder template! Templates are JSON5 files that describe a project type so Finder can detect it.
+
+        **Useful references:**
+        - Template authoring guide: [`AGENTS.md`](../../AGENTS.md)
+        - Custom templates guide: [`CUSTOM_TEMPLATES.md`](../../CUSTOM_TEMPLATES.md)
+        - JSON schemas: `.finder/shema/`
+
+  - type: input
+    id: template_name
+    attributes:
+      label: Template name
+      description: The filename without `.json5` becomes the template name, e.g. `my-template`
+      placeholder: "my-template"
+    validations:
+      required: true
+
+  - type: textarea
+    id: template_description
+    attributes:
+      label: Description
+      description: Short human-readable explanation of the project type this template matches
+      placeholder: "A monorepo using pnpm workspaces with apps/ and packages/"
+    validations:
+      required: true
+
+  - type: textarea
+    id: match_signals
+    attributes:
+      label: Match signals
+      description: The smallest set of reliable files and folders that uniquely identify this project type
+      value: |
+        Files:
+        - ...
+
+        Folders:
+        - ...
+    validations:
+      required: true
+
+  - type: input
+    id: tags
+    attributes:
+      label: Suggested tags
+      description: Comma-separated tags for discoverability
+      placeholder: "node, typescript, monorepo"
+
+  - type: textarea
+    id: template_content
+    attributes:
+      label: Template content (JSON5)
+      description: 'Paste the full valid JSON5 template. Use `name: "*"` unless a narrower pattern is necessary.'
+      render: json
+      placeholder: |
+        {
+          description: "My project type",
+          name: "*",
+          files: ["package.json"],
+          tags: ["my-tag"],
+          min_version: "0.3.16",
+        }
+    validations:
+      required: true
+
+  - type: textarea
+    id: validation
+    attributes:
+      label: Validation output
+      description: Paste the output of the validation commands below, if possible
+      render: shell
+      placeholder: |
+        ./finder check
+        ./finder <template-name>
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: Valid `.json5` file matching the schema in `.finder/shema/`
+        - label: '`name` set to `"*"` unless a narrower pattern is intentional'
+        - label: Minimal and specific required files/folders — no generic markers
+        - label: Includes a clear `description` and useful `tags`
+        - label: Validated with `./finder check`

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,31 +1,69 @@
 ## 📌 Summary
 
 <!-- Briefly describe what this PR does -->
-*Describe the change in a few sentences*
+
+_Describe the change in a few sentences_
 
 ## 🔍 Related Issue
 
 <!-- Link the issue this PR resolves, if applicable -->
+
 Closes #
 
 ## 🛠 Proposed Changes
 
 <!-- List the changes made -->
+
 - Change 1
 - Change 2
-- ...
+- …
 
 ## 🧪 Testing
 
 <!-- How has this been tested? Steps and results -->
+
 1. …
 2. …
 
+---
+
+## 🧩 Finder Template Changes
+
+<!--
+  Fill this section out when this PR adds or changes a Finder template.
+  Templates are JSON5 files that describe a project type so Finder can detect it.
+  Built-in templates live in `templates/`, custom templates in `.finder/templates/`.
+  Schema files: `.finder/shema/`.
+-->
+
+### Template checklist
+
+- [ ] Template is a valid `.json5` file
+- [ ] Template matches the schema in `.finder/shema/` (`finder-template.schema.json` / `finder-template.v2.schema.json`)
+- [ ] `name` is `"*"` unless a narrower pattern is intentional
+- [ ] Requires only the minimal set of files/folders needed to identify the project type
+- [ ] Includes a clear `description` and useful `tags`
+- [ ] Avoids generic markers that cause false positives (e.g. `README.md` alone)
+- [ ] Validated with `./finder check`
+- [ ] Tested against a real folder with `./finder <template-name>`
+- [ ] Documentation updated (`CUSTOM_TEMPLATES.md`, `tags.md`) if applicable
+
+### Validation output
+
+<!-- Paste the output of these commands -->
+
+```
+./finder check
+./finder <template-name>
+```
+
+---
+
 ## 📸 Screenshots (if applicable)
 
 <!-- UI / behavior changes – include screenshots or GIFs -->
 
-## ✅ Checklist
+## ✅ Final Checklist
 
 - [ ] PR title is descriptive
 - [ ] Changes are tested

.github/temp-stuff-idk/c-shortcut/build.bat

@@ -0,0 +1,2 @@
+cl /O2 /Ob3 /Oi /Ot /GL /Gy /MD /GF /DNDEBUG /arch:AVX2 shortcut.c /link /LTCG /OPT:REF /OPT:ICF
+dumpbin /headers main.exe

.github/temp-stuff-idk/c-shortcut/config.txt

@@ -0,0 +1,7 @@
+name=Max
+age=25
+city=Berlin
+l=hallo
+lol=pnpm
+
+main.exe=finder