git-repokit 0.9.12__tar.gz → 0.10.1__tar.gz

{git_repokit-0.9.12/git_repokit.egg-info → git_repokit-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-repokit
-Version: 0.9.12
+Version: 0.10.1
 Summary: Create standardized Git repositories: language presets, licenses, GitHub setup, and a private notes vault
 Author: Dustin Darcy
 License-Expression: MIT
@@ -58,10 +58,10 @@ Dynamic: license-file
 A full create (the [Quick Start](#-quick-start) below) produces:
 
 - **The structure:** README, CONTRIBUTING, CHANGELOG, LICENSE, `.gitignore`, `.gitattributes`, `docs/`, `tests/`, `scripts/`, and, if you ask for them, ROADMAP, a funding file, Dependabot, a stale-issue policy and PR and release templates.
-- **The code for its language:** a Python package with `pyproject.toml` and a CLI, a CMake or Visual Studio C/C++ project, a TypeScript npm package, a Claude Code plugin, and more. Each comes with tests, a CI workflow and a VS Code debug configuration that work from the first commit. See [Languages and layers](docs/Languages-and-Layers.md).
+- **The code for its language:** a Python package with `pyproject.toml` and a CLI, a CMake or Visual Studio C/C++ project, a TypeScript npm package, a Claude Code plugin, a Paradox game mod (Crusader Kings III and others), and more. Each comes with tests, a CI workflow and a VS Code debug configuration where it has something to run, from the first commit. The project's settings name its languages, so the hooks run the right checks. See [Languages and layers](docs/Languages-and-Layers.md).
 - **A README that names the project:** the real GitHub owner, badges for the release, the Python or Node minimum and the license, install and test commands for the preset, and a License section at the end.
 - **The tooling:** [git-repokit-common](https://github.com/DazzleTools/git-repokit-common) vendored at `scripts/repokit-common/`, with git hooks that keep version numbers in step, keep private files out of public commits, and run the tests before a push.
-- **A private vault:** `private/` is its own git repository, ignored by the project, for notes, design documents and postmortems. It starts with a map, an index for an oracle session and a to-do board. See [The vault](docs/The-Vault.md).
+- **A private vault:** `private/` is its own git repository, ignored by the project, for notes, design documents, postmortems, conversations (`convos/`) and old revisions (`revisions/`); run logs go to `private/logs/`, kept on disk and never versioned. It starts with a map, an index for an oracle session and a to-do board. See [The vault](docs/The-Vault.md).
 - **The repository on GitHub** (with `--github`): created with your `gh` login and pushed. It gets the standard labels, Roadmap and Quick Notes as issues #1 and #2 (pinned), discussions and topics. See [GitHub setup](docs/GitHub-Setup.md).
 
 ## 📦 Installation
@@ -173,6 +173,9 @@ repokit create my-app --with c-cpp/msbuild --license gpl-3.0-or-later
 # A TypeScript npm package
 repokit create my-lib --language js-ts --license mpl-2.0
 
+# A Crusader Kings III mod: the mod in mod/, the repository's own files above it
+repokit create my-mod --language paradox --license mit
+
 # A one-file Python script, no packaging, given away to the public domain
 repokit create my-script --with python/script --license unlicense
 

{git_repokit-0.9.12 → git_repokit-0.10.1}/README.md

@@ -17,10 +17,10 @@
 A full create (the [Quick Start](#-quick-start) below) produces:
 
 - **The structure:** README, CONTRIBUTING, CHANGELOG, LICENSE, `.gitignore`, `.gitattributes`, `docs/`, `tests/`, `scripts/`, and, if you ask for them, ROADMAP, a funding file, Dependabot, a stale-issue policy and PR and release templates.
-- **The code for its language:** a Python package with `pyproject.toml` and a CLI, a CMake or Visual Studio C/C++ project, a TypeScript npm package, a Claude Code plugin, and more. Each comes with tests, a CI workflow and a VS Code debug configuration that work from the first commit. See [Languages and layers](docs/Languages-and-Layers.md).
+- **The code for its language:** a Python package with `pyproject.toml` and a CLI, a CMake or Visual Studio C/C++ project, a TypeScript npm package, a Claude Code plugin, a Paradox game mod (Crusader Kings III and others), and more. Each comes with tests, a CI workflow and a VS Code debug configuration where it has something to run, from the first commit. The project's settings name its languages, so the hooks run the right checks. See [Languages and layers](docs/Languages-and-Layers.md).
 - **A README that names the project:** the real GitHub owner, badges for the release, the Python or Node minimum and the license, install and test commands for the preset, and a License section at the end.
 - **The tooling:** [git-repokit-common](https://github.com/DazzleTools/git-repokit-common) vendored at `scripts/repokit-common/`, with git hooks that keep version numbers in step, keep private files out of public commits, and run the tests before a push.
-- **A private vault:** `private/` is its own git repository, ignored by the project, for notes, design documents and postmortems. It starts with a map, an index for an oracle session and a to-do board. See [The vault](docs/The-Vault.md).
+- **A private vault:** `private/` is its own git repository, ignored by the project, for notes, design documents, postmortems, conversations (`convos/`) and old revisions (`revisions/`); run logs go to `private/logs/`, kept on disk and never versioned. It starts with a map, an index for an oracle session and a to-do board. See [The vault](docs/The-Vault.md).
 - **The repository on GitHub** (with `--github`): created with your `gh` login and pushed. It gets the standard labels, Roadmap and Quick Notes as issues #1 and #2 (pinned), discussions and topics. See [GitHub setup](docs/GitHub-Setup.md).
 
 ## 📦 Installation
@@ -132,6 +132,9 @@ repokit create my-app --with c-cpp/msbuild --license gpl-3.0-or-later
 # A TypeScript npm package
 repokit create my-lib --language js-ts --license mpl-2.0
 
+# A Crusader Kings III mod: the mod in mod/, the repository's own files above it
+repokit create my-mod --language paradox --license mit
+
 # A one-file Python script, no packaging, given away to the public domain
 repokit create my-script --with python/script --license unlicense
 

{git_repokit-0.9.12 → git_repokit-0.10.1/git_repokit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-repokit
-Version: 0.9.12
+Version: 0.10.1
 Summary: Create standardized Git repositories: language presets, licenses, GitHub setup, and a private notes vault
 Author: Dustin Darcy
 License-Expression: MIT
@@ -58,10 +58,10 @@ Dynamic: license-file
 A full create (the [Quick Start](#-quick-start) below) produces:
 
 - **The structure:** README, CONTRIBUTING, CHANGELOG, LICENSE, `.gitignore`, `.gitattributes`, `docs/`, `tests/`, `scripts/`, and, if you ask for them, ROADMAP, a funding file, Dependabot, a stale-issue policy and PR and release templates.
-- **The code for its language:** a Python package with `pyproject.toml` and a CLI, a CMake or Visual Studio C/C++ project, a TypeScript npm package, a Claude Code plugin, and more. Each comes with tests, a CI workflow and a VS Code debug configuration that work from the first commit. See [Languages and layers](docs/Languages-and-Layers.md).
+- **The code for its language:** a Python package with `pyproject.toml` and a CLI, a CMake or Visual Studio C/C++ project, a TypeScript npm package, a Claude Code plugin, a Paradox game mod (Crusader Kings III and others), and more. Each comes with tests, a CI workflow and a VS Code debug configuration where it has something to run, from the first commit. The project's settings name its languages, so the hooks run the right checks. See [Languages and layers](docs/Languages-and-Layers.md).
 - **A README that names the project:** the real GitHub owner, badges for the release, the Python or Node minimum and the license, install and test commands for the preset, and a License section at the end.
 - **The tooling:** [git-repokit-common](https://github.com/DazzleTools/git-repokit-common) vendored at `scripts/repokit-common/`, with git hooks that keep version numbers in step, keep private files out of public commits, and run the tests before a push.
-- **A private vault:** `private/` is its own git repository, ignored by the project, for notes, design documents and postmortems. It starts with a map, an index for an oracle session and a to-do board. See [The vault](docs/The-Vault.md).
+- **A private vault:** `private/` is its own git repository, ignored by the project, for notes, design documents, postmortems, conversations (`convos/`) and old revisions (`revisions/`); run logs go to `private/logs/`, kept on disk and never versioned. It starts with a map, an index for an oracle session and a to-do board. See [The vault](docs/The-Vault.md).
 - **The repository on GitHub** (with `--github`): created with your `gh` login and pushed. It gets the standard labels, Roadmap and Quick Notes as issues #1 and #2 (pinned), discussions and topics. See [GitHub setup](docs/GitHub-Setup.md).
 
 ## 📦 Installation
@@ -173,6 +173,9 @@ repokit create my-app --with c-cpp/msbuild --license gpl-3.0-or-later
 # A TypeScript npm package
 repokit create my-lib --language js-ts --license mpl-2.0
 
+# A Crusader Kings III mod: the mod in mod/, the repository's own files above it
+repokit create my-mod --language paradox --license mit
+
 # A one-file Python script, no packaging, given away to the public domain
 repokit create my-script --with python/script --license unlicense
 

{git_repokit-0.9.12 → git_repokit-0.10.1}/git_repokit.egg-info/SOURCES.txt

@@ -133,6 +133,12 @@ repokit/templates/layers/archetypes/js-ts/script/.vscode/launch.json
 repokit/templates/layers/archetypes/js-ts/script/tests/version.test.js
 repokit/templates/layers/archetypes/js-ts/ts/package.json
 repokit/templates/layers/archetypes/js-ts/ts/tsconfig.json
+repokit/templates/layers/archetypes/paradox/ck3/.repokit-common.toml
+repokit/templates/layers/archetypes/paradox/ck3/mod/descriptor.mod
+repokit/templates/layers/archetypes/paradox/clausewitz/mod/localisation/english/__RK_SNAKE___l_english.yml
+repokit/templates/layers/archetypes/paradox/descriptor-mod/mod/descriptor.mod
+repokit/templates/layers/archetypes/paradox/descriptor-mod/mod/thumbnail.png
+repokit/templates/layers/archetypes/paradox/jomini/mod/localization/english/__RK_SNAKE___l_english.yml
 repokit/templates/layers/archetypes/python/claude-plugin/.repokit-common.toml
 repokit/templates/layers/archetypes/python/claude-plugin/VERSION
 repokit/templates/layers/archetypes/python/claude-plugin/.github/workflows/ci-python.yml
@@ -168,6 +174,10 @@ repokit/templates/layers/languages/js-ts/.repokit-common.toml
 repokit/templates/layers/languages/js-ts/VERSION
 repokit/templates/layers/languages/js-ts/.github/workflows/ci-js-ts.yml
 repokit/templates/layers/languages/js-ts/.vscode/launch.json
+repokit/templates/layers/languages/paradox/.gitattributes.rkappend
+repokit/templates/layers/languages/paradox/.repokit-common.toml
+repokit/templates/layers/languages/paradox/VERSION
+repokit/templates/layers/languages/paradox/docs/modding.md
 repokit/templates/layers/languages/python/.gitignore.rkappend
 repokit/templates/layers/languages/python/.github/workflows/ci-python.yml
 repokit/templates/layers/languages/python/.vscode/launch.json
@@ -195,6 +205,7 @@ tests/test_guardrails.py
 tests/test_hermetic.py
 tests/test_hook_encoding.py
 tests/test_hook_patterns.py
+tests/test_languages_setting.py
 tests/test_layer_action_pins.py
 tests/test_layers.py
 tests/test_layers_c_cpp.py
@@ -209,6 +220,7 @@ tests/test_license_cli.py
 tests/test_licenses.py
 tests/test_new_default.py
 tests/test_packaging.py
+tests/test_paradox.py
 tests/test_private_branch_create.py
 tests/test_readme_blocks.py
 tests/test_run_tests_driver.py

{git_repokit-0.9.12 → git_repokit-0.10.1}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "setuptools.build_meta"
 # PyPI's trusted publisher is registered for this name (DazzleTools/git-repokit,
 # publish.yml, environment pypi); the command stays `repokit`
 name = "git-repokit"
-version = "0.9.12"
+version = "0.10.1"
 description = "Create standardized Git repositories: language presets, licenses, GitHub setup, and a private notes vault"
 readme = "README.md"
 license = "MIT"

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/common_kit.py

@@ -124,6 +124,30 @@ def private_branch_settings(private_branch: Optional[str], private_paths: List[s
     return settings
 
 
+def languages_setting(languages: List[str], layer_folders: List[str]) -> List[str]:
+    """The `languages` value a create writes for git-repokit-common's hooks.
+
+    repokit's language names mapped to repokit-common's, in the composed
+    order (the first is primary): js-ts is "typescript" when the ts layer is
+    part of the composition, else "javascript"; python, c-cpp and paradox
+    are the same names; generic and the `any` pseudo-language add nothing.
+    Writing it, rather than leaving the hooks to detect it from the root,
+    keeps a project whose markers sit in a subfolder (a plugin in plugin/)
+    from reading as Python (design 2026-10-30__08-28-15, Addendum 2).
+    """
+    out: List[str] = []
+    for lang in languages:
+        if lang == "js-ts":
+            name = "typescript" if any(f.endswith("js-ts/ts") for f in layer_folders) else "javascript"
+        elif lang in ("python", "c-cpp", "paradox"):
+            name = lang
+        else:
+            continue
+        if name not in out:
+            out.append(name)
+    return out
+
+
 def _toml_list(values: List[str]) -> str:
     return "[" + ", ".join('"' + v.replace("\\", "\\\\").replace('"', '\\"') + '"' for v in values) + "]"
 

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/config.py

@@ -59,12 +59,11 @@ class ConfigManager:
             # replaces them with the chosen strategy's values
             "branches": list(BRANCH_STRATEGIES[DEFAULT_BRANCH_STRATEGY]["branches"]),
             "worktrees": list(BRANCH_STRATEGIES[DEFAULT_BRANCH_STRATEGY]["worktrees"]),
+            # convos/, revisions/ and logs/ live in private/ since 0.10.0
+            # (vault.PRIVATE_STRUCTURE), not at the project root
             "directories": [
-                "convos",
                 "docs",
-                "logs",
                 "private",
-                "revisions",
                 "scripts",
                 "tests",
             ],

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/defaults.py

@@ -180,15 +180,17 @@ def strategy_push_branches(name: str) -> List[str]:
 DEFAULT_BRANCH_STRATEGIES = {name: strategy_branch_list(name) for name in BRANCH_STRATEGIES}
 
 # Default directory profiles - centralized from directory_profiles.py
+# convos/, revisions/ and logs/ are made inside private/ (vault.PRIVATE_STRUCTURE)
+# since 0.10.0, never at the project root; DEFAULT_PRIVATE_DIRS still names
+# them, so a root folder an older project has stays out of public history.
 DEFAULT_DIRECTORY_PROFILES = {
     "minimal": ["src", "tests", "docs"],
     "standard": [
-        "src", "tests", "docs", "scripts", "config", 
-        "logs", "private", "convos", "revisions"
+        "src", "tests", "docs", "scripts", "config", "private"
     ],
     "complete": [
-        "src", "tests", "docs", "scripts", "config", "logs", 
-        "private", "convos", "revisions", "data", "examples", 
+        "src", "tests", "docs", "scripts", "config",
+        "private", "data", "examples",
         "tools", "resources", "assets"
     ]
 }

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/layers.py

@@ -376,14 +376,22 @@ def catalogue_lines(manifest: Dict[str, Any], language: Optional[str] = None) ->
         head = f"{lang}:" + (f"  (planned: {entry.get('description', '')})" if entry.get("stub") else "")
         lines.append(head)
         default = entry.get("default")
+        planned = []
         for key in sorted(k for k in manifest["archetypes"] if k.startswith(lang + "/")):
             preset = manifest["archetypes"][key]
             if preset.get("stub"):
-                lines.append(f"  {key:28} (planned: {preset.get('description', '')})")
+                if language:
+                    lines.append(f"  {key:28} (planned: {preset.get('description', '')})")
+                else:
+                    planned.append(key.split("/", 1)[1])
             else:
                 parts = [f.split("/", 2)[-1] for f in preset.get("layers", [])]
                 mark = "  <- default" if key == default else ""
                 lines.append(f"  {key:28} = {', '.join(parts)}{mark}")
+        if planned:
+            # The overview keeps one screen (AC-10): a language's planned presets
+            # share a line; `repokit list <lang>` shows each with its description.
+            lines.append(f"  {'planned:':28} {', '.join(planned)}")
         for facet, spec in facets:
             if facet == "language":
                 continue

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/repo_manager.py

@@ -247,7 +247,8 @@ class RepoManager:
         # Create standard subdirectories
         standard_dirs = self.config.get(
             "directories",
-            ["convos", "docs", "logs", "private", "revisions", "scripts", "tests"],
+            # convos/, revisions/, logs/: in private/ since 0.10.0 (vault.py)
+            ["docs", "private", "scripts", "tests"],
         )
 
         for directory in standard_dirs:
@@ -981,6 +982,15 @@ class RepoManager:
             print(f"Note: .vscode/ holds {resolution.languages[0]}'s debug configurations; "
                   f"{', '.join(others)}'s were not merged in (add them to .vscode/launch.json by hand)")
         self.logger.info(f"Code-type layers {', '.join(resolution.layers)}: {len(written)} files")
+
+        # Say what the project is, for git-repokit-common's hooks: the languages
+        # it was composed from, written unless a layer's settings already name
+        # them (paradox, c-cpp). Detection stays the hooks' fallback for
+        # adopted projects; a created one should not depend on it.
+        from . import common_kit
+        langs = common_kit.languages_setting(resolution.languages, resolution.layers)
+        if langs:
+            common_kit.write_settings(self.repo_root, {"languages": langs})
         for note in resolution.notes:
             # Once, to the person: a composition no preset vouches for (with
             # the tokens it was assembled from), or a language left bare.

git_repokit-0.10.1/repokit/templates/layers/archetypes/paradox/ck3/.repokit-common.toml

@@ -0,0 +1,28 @@
+# git-repokit-common settings for __RK_PROJECT__, a Crusader Kings III mod.
+#
+# The mod itself is mod/: the folder the game loads and the one a Workshop
+# upload ships. Everything else (this file, VERSION, scripts/, tests/,
+# private/) stays above it and never reaches the game or the Workshop.
+#
+# The version lives in VERSION; the vendored tool at scripts/repokit-common/
+# keeps mod/descriptor.mod's version line in step with it (a pattern target:
+# only the version text changes, the file's bytes otherwise untouched).
+#
+# The hooks: languages = ["paradox"] runs the paradox profile -- on push
+# ck3-tiger when it is installed (advisory, never blocking), on commit a check
+# that localization .yml files keep their UTF-8 BOM -- and no Python checks.
+
+[tool.repokit-common]
+version-source = "VERSION"
+changelog = "CHANGELOG.md"
+repo-url = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+tag-prefix = "v"
+tag-format = "human"
+private-patterns = ["private/", "local/", ".env"]
+languages = ["paradox"]
+paradox-game = "ck3"
+
+[[tool.repokit-common.extra-targets]]
+path = "mod/descriptor.mod"
+pattern = '^version="([^"]*)"\r?$'
+format = "base"

git_repokit-0.10.1/repokit/templates/layers/archetypes/paradox/ck3/mod/descriptor.mod

@@ -0,0 +1,6 @@
+version="0.1.0"
+tags={
+	"Utilities"
+}
+name="__RK_PROJECT__"
+supported_version="1.20.*"

git_repokit-0.10.1/repokit/templates/layers/archetypes/paradox/clausewitz/mod/localisation/english/__RK_SNAKE___l_english.yml

@@ -0,0 +1,2 @@
+l_english:
+ __RK_SNAKE___name:0 "__RK_PROJECT__"

git_repokit-0.10.1/repokit/templates/layers/archetypes/paradox/descriptor-mod/mod/descriptor.mod

@@ -0,0 +1,9 @@
+# Set supported_version to the game version this mod is made for: "1.20.*" for
+# Crusader Kings III 1.20, for example. "*" loads on any version, with the
+# launcher's warning. version follows the VERSION file (sync-versions.py).
+version="0.1.0"
+tags={
+	"Utilities"
+}
+name="__RK_PROJECT__"
+supported_version="*"

git_repokit-0.10.1/repokit/templates/layers/archetypes/paradox/jomini/mod/localization/english/__RK_SNAKE___l_english.yml

@@ -0,0 +1,2 @@
+l_english:
+ __RK_SNAKE___name:0 "__RK_PROJECT__"

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/templates/layers/languages/js-ts/.repokit-common.toml

@@ -3,9 +3,10 @@
 # A JavaScript/TypeScript project keeps its version in package.json; the
 # vendored tooling at scripts/repokit-common/ treats the plain VERSION file as
 # the source and package.json (and any other manifest a layer adds) as a
-# target it keeps in step, so one bump moves every copy. The product
-# languages are not listed here on purpose: the hooks detect them from the
-# root (package.json -> javascript, tsconfig.json -> typescript).
+# target it keeps in step, so one bump moves every copy. `repokit create`
+# adds the product's `languages` below (typescript with the ts layer, else
+# javascript); the hooks' detection from the root (package.json, tsconfig.json)
+# is only their fallback, and it cannot see a plugin's markers in plugin/.
 
 [tool.repokit-common]
 version-source = "VERSION"

git_repokit-0.10.1/repokit/templates/layers/languages/paradox/.gitattributes.rkappend

@@ -0,0 +1,12 @@
+
+# Paradox mod files: the game reads their bytes as they are -- a localization
+# file without its UTF-8 BOM is skipped, and line endings stay as written --
+# so git must never convert them on checkout or commit.
+mod/**/*.txt -text
+mod/**/*.yml -text
+mod/**/*.mod -text
+mod/**/*.gui -text
+mod/**/*.gfx -text
+mod/**/*.asset -text
+mod/**/*.shader -text
+mod/**/*.csv -text

git_repokit-0.10.1/repokit/templates/layers/languages/paradox/.repokit-common.toml

@@ -0,0 +1,29 @@
+# git-repokit-common settings for __RK_PROJECT__, a Paradox game mod.
+#
+# The mod itself is mod/: the folder the game loads and the one a Workshop
+# upload ships. Everything else (this file, VERSION, scripts/, tests/,
+# private/) stays above it and never reaches the game or the Workshop.
+#
+# The version lives in VERSION; the vendored tool at scripts/repokit-common/
+# keeps mod/descriptor.mod's version line in step with it (a pattern target:
+# only the version text changes, the file's bytes otherwise untouched).
+#
+# The hooks: languages = ["paradox"] runs the paradox profile -- on push the
+# game's Tiger linter when it is installed (advisory, never blocking), on
+# commit a check that localization .yml files keep their UTF-8 BOM -- and
+# no Python checks. Set paradox-game to your game to choose the linter.
+
+[tool.repokit-common]
+version-source = "VERSION"
+changelog = "CHANGELOG.md"
+repo-url = "https://github.com/__RK_ORG__/__RK_PROJECT__"
+tag-prefix = "v"
+tag-format = "human"
+private-patterns = ["private/", "local/", ".env"]
+languages = ["paradox"]
+# paradox-game = "ck3"     # ck3, vic3 or imperator have a Tiger linter
+
+[[tool.repokit-common.extra-targets]]
+path = "mod/descriptor.mod"
+pattern = '^version="([^"]*)"\r?$'
+format = "base"

git_repokit-0.10.1/repokit/templates/layers/languages/paradox/VERSION

@@ -0,0 +1 @@
+0.1.0

git_repokit-0.10.1/repokit/templates/layers/languages/paradox/docs/modding.md

@@ -0,0 +1,34 @@
+# Working on __RK_PROJECT__
+
+This repository holds a Paradox game mod. The mod itself is `mod/`: the folder the game loads, and the folder a Workshop upload ships. Everything else stays above it, so it never reaches the game or the Workshop.
+
+## Load the working copy in the game
+
+The game finds a local mod through a small pointer file in its Documents folder, `Documents\Paradox Interactive\<Game>\mod\__RK_PROJECT__.mod`. For Crusader Kings III, `<Game>` is `Crusader Kings III`. Write it once, with any editor:
+
+```
+name="__RK_PROJECT__"
+path="C:/path/to/__RK_PROJECT__/mod"
+supported_version="1.20.*"
+```
+
+`path` names this repository's `mod/` folder, with forward slashes. Then enable the mod in the game's launcher. git-repokit never writes this file, and never touches the launcher's own files: they belong to the game.
+
+## Version
+
+The version lives in `VERSION`, and `mod/descriptor.mod`'s `version="..."` line follows it:
+
+```
+python scripts/repokit-common/sync-versions.py --bump patch
+```
+
+Only that line changes. `supported_version`, the encoding and the line endings stay as they were.
+
+## Checks
+
+- **On push:** the game's [Tiger](https://github.com/amtep/tiger) linter (`ck3-tiger`, `vic3-tiger`, `imperator-tiger`) runs on the mod when it is on PATH. The push shows Tiger's summary line, and the full report goes to `.git/repokit-<linter>.txt`. Findings never block. Set `paradox-game` in `.repokit-common.toml` to choose the linter.
+- **On commit:** a localization `.yml` saved without a UTF-8 BOM is refused. The game would skip it without an error, and its keys would show raw in the game.
+
+## Encoding
+
+Keep localization files as **UTF-8 with BOM**, and script files as the game expects. `.gitattributes` stops git from converting anything under `mod/`.

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/templates/layers/manifest.toml

@@ -63,6 +63,17 @@ default = "c-cpp/cmake-app"
 layers = ["languages/js-ts"]
 default = "js-ts/node-package"
 
+# Paradox game mods (Crusader Kings III, Victoria 3, Stellaris, ...). The mod
+# itself is mod/, the folder the game loads and a Workshop upload ships; the
+# repository's own files stay above it. The facets are the existing ones
+# (design 2026-10-30__08-28-15, Addendum 2): the engine is the script's
+# dialect (jomini, clausewitz), the descriptor kind is how the mod is packaged
+# (build), the game is what it is (purpose) -- ranked so the game's files are
+# applied last and win.
+[languages.paradox]
+layers = ["languages/paradox"]
+default = "paradox/ck3"
+
 # A pseudo-language: the folder prefix for layer files several languages share
 # (the Claude plugin's manifests and marketplace README). Never a project
 # language: --language refuses it, `repokit list` and the bare-name lookup do
@@ -211,6 +222,69 @@ facet = "framework"
 stub = true
 description = "Qt 6: find_package(Qt6), qt_add_executable, windeployqt"
 
+# paradox: engine layers carry engine-wide files only (the localization folder,
+# spelled as the engine spells it); the game layer owns the game's descriptor
+# and settings and overrides the generic ones.
+
+[layers."paradox/jomini"]
+facet = "dialect"
+description = "the Jomini engine (Crusader Kings III, Imperator, Victoria 3, Europa Universalis V): mod/localization/english/ with a UTF-8 BOM"
+
+[layers."paradox/clausewitz"]
+facet = "dialect"
+description = "the Clausewitz engine (Stellaris, Hearts of Iron IV, Europa Universalis IV): mod/localisation/english/ with a UTF-8 BOM"
+
+[layers."paradox/descriptor-mod"]
+facet = "build"
+description = "a descriptor.mod in mod/ (version, name, tags, supported_version) and a thumbnail.png"
+
+[layers."paradox/metadata-json"]
+facet = "build"
+stub = true
+description = "Victoria 3's .metadata/metadata.json in place of descriptor.mod (planned with paradox/vic3)"
+
+[layers."paradox/ck3"]
+facet = "purpose"
+implies = ["jomini", "descriptor-mod"]
+overrides = ["mod/descriptor.mod", ".repokit-common.toml"]
+description = "a Crusader Kings III mod: supported_version 1.20.*, paradox-game = \"ck3\" (ck3-tiger on push)"
+
+[layers."paradox/vic3"]
+facet = "purpose"
+stub = true
+implies = ["jomini", "metadata-json"]
+description = "a Victoria 3 mod (planned)"
+
+[layers."paradox/imperator"]
+facet = "purpose"
+stub = true
+implies = ["jomini", "descriptor-mod"]
+description = "an Imperator: Rome mod (planned)"
+
+[layers."paradox/eu5"]
+facet = "purpose"
+stub = true
+implies = ["jomini"]
+description = "a Europa Universalis V mod (planned; its descriptor is not confirmed)"
+
+[layers."paradox/stellaris"]
+facet = "purpose"
+stub = true
+implies = ["clausewitz", "descriptor-mod"]
+description = "a Stellaris mod (planned)"
+
+[layers."paradox/hoi4"]
+facet = "purpose"
+stub = true
+implies = ["clausewitz", "descriptor-mod"]
+description = "a Hearts of Iron IV mod (planned; its descriptor must have no BOM)"
+
+[layers."paradox/eu4"]
+facet = "purpose"
+stub = true
+implies = ["clausewitz", "descriptor-mod"]
+description = "a Europa Universalis IV mod (planned)"
+
 # ---------------------------------------------------------------- presets
 # `layers` lists layer folders in apply order; `languages` is implied by the key.
 
@@ -300,3 +374,42 @@ description = "Library with install/export targets and a package config (starts
 [archetypes."c-cpp/qt"]
 stub = true
 description = "Qt 6 app: find_package(Qt6), qt_add_executable, windeployqt (starts from cmake-app)"
+
+[archetypes."paradox/ck3"]
+languages = ["paradox"]
+layers = ["archetypes/paradox/jomini", "archetypes/paradox/descriptor-mod", "archetypes/paradox/ck3"]
+description = "a Crusader Kings III mod in mod/: descriptor.mod for 1.20, English localization with its BOM, a thumbnail; VERSION kept in step with the descriptor; ck3-tiger on push"
+
+[archetypes."paradox/jomini"]
+languages = ["paradox"]
+layers = ["archetypes/paradox/jomini", "archetypes/paradox/descriptor-mod"]
+description = "a mod for any Jomini game (Crusader Kings III, Imperator, ...): a generic descriptor.mod (supported_version \"*\") and mod/localization/; set paradox-game for its linter"
+
+[archetypes."paradox/clausewitz"]
+languages = ["paradox"]
+layers = ["archetypes/paradox/clausewitz", "archetypes/paradox/descriptor-mod"]
+description = "a mod for any Clausewitz game (Stellaris, Hearts of Iron IV, Europa Universalis IV): a generic descriptor.mod and mod/localisation/"
+
+[archetypes."paradox/vic3"]
+stub = true
+description = "a Victoria 3 mod (.metadata/metadata.json)"
+
+[archetypes."paradox/imperator"]
+stub = true
+description = "an Imperator: Rome mod"
+
+[archetypes."paradox/eu5"]
+stub = true
+description = "a Europa Universalis V mod"
+
+[archetypes."paradox/stellaris"]
+stub = true
+description = "a Stellaris mod"
+
+[archetypes."paradox/hoi4"]
+stub = true
+description = "a Hearts of Iron IV mod (a descriptor without BOM)"
+
+[archetypes."paradox/eu4"]
+stub = true
+description = "a Europa Universalis IV mod"

{git_repokit-0.9.12 → git_repokit-0.10.1}/repokit/vault.py

@@ -24,9 +24,16 @@ PRIVATE_STRUCTURE = [
     "claude",
     "claude/commits",
     "claude/issues",
+    "convos",
     "docs",
+    "logs",
     "notes",
+    "revisions",
 ]
+# convos/, revisions/ and logs/ were project-root folders until 0.10.0, held
+# out of public history only by ignore rules and the pre-commit guard; inside
+# the vault they cannot reach a public remote at all (djdarcy, 2026-10-31).
+# logs/ is run output, so the vault ignores it (PRIVATE_GITIGNORE_SECTIONS).
 
 # What the vault ignores (private_init.PRIVATE_GITIGNORE_SECTIONS)
 PRIVATE_GITIGNORE_SECTIONS = [
@@ -35,6 +42,7 @@ PRIVATE_GITIGNORE_SECTIONS = [
     ("OS", [".DS_Store", "Thumbs.db", "desktop.ini"]),
     ("Temp files", ["*.tmp", "*.bak"]),
     ("Agent working state -- written by tools, never versioned", [".gauntlet/"]),
+    ("Run logs -- program output, kept on disk and never versioned", ["logs/"]),
 ]
 
 # What the parent project ignores besides private/ itself

{git_repokit-0.9.12 → git_repokit-0.10.1}/tests/test_directory_profiles.py

@@ -293,20 +293,30 @@ class TestConfigManagerDirectoryProfiles(unittest.TestCase):
         self.assertIn("local", private_dirs)
 
     def test_backward_compatibility(self):
-        """Test backward compatibility when no profile is specified."""
-        # No profile specified, should use defaults
-        self.config_manager.cli_config = {"name": "testproject"}
-        self.config_manager.config = self.config_manager._merge_configs()
-        self.config_manager.resolve_directory_profiles()
-        
-        dirs = self.config_manager.config.get("directories", [])
-        # Should have default directories
-        self.assertIn("convos", dirs)
-        self.assertIn("docs", dirs)
-        self.assertIn("logs", dirs)
-        self.assertIn("private", dirs)
-        self.assertIn("scripts", dirs)
-        self.assertIn("tests", dirs)
+        """No profile: the default directories. Run from an empty folder: the
+        config manager reads a .repokit.json in the current directory, and in
+        git-repokit's own checkout that record (2025) still lists convos/, logs/
+        and revisions/ -- which kept this test green whatever the defaults said.
+        Since 0.10.0 those three live in private/, never at the project root."""
+        cwd = os.getcwd()
+        os.chdir(tempfile.mkdtemp())
+        try:
+            manager = ConfigManager()
+            manager.cli_config = {"name": "testproject"}
+            manager.config = manager._merge_configs()
+            manager.resolve_directory_profiles()
+        finally:
+            os.chdir(cwd)
+        dirs = manager.config.get("directories", [])
+        for d in ("docs", "private", "scripts", "tests"):
+            self.assertIn(d, dirs)
+        for d in ("convos", "logs", "revisions"):
+            self.assertNotIn(d, dirs)
+        for profile in ("standard", "complete"):
+            listed = DirectoryProfileManager().profiles[profile]
+            self.assertFalse({"convos", "logs", "revisions"} & set(listed), profile)
+        # still protected: an older project's root folders stay out of public history
+        self.assertTrue({"convos", "logs", "revisions"} <= set(manager.config["private_dirs"]))
 
 
 if __name__ == "__main__":