pz-cli 5.0.0__py3-none-any.whl

pz_core/authoring/templates/app/static_app_js.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def app_static_app_js_template(app_id: str) -> str:
+    return dedent(
+        f"""\
+        async function load{app_id.title().replace("_", "")}Demo() {{
+          const response = await fetch("/api/example");
+          if (!response.ok) {{
+            throw new Error("demo_api_request_failed");
+          }}
+          return response.json();
+        }}
+
+        load{app_id.title().replace("_", "")}Demo().catch(() => {{
+          // Demo only. Replace with real UI handling when the page is wired in.
+        }});
+        """
+    )
+
+
+__all__ = ["app_static_app_js_template"]

pz_core/authoring/templates/app/static_readme.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def app_static_readme_template(app_id: str) -> str:
+    return dedent(
+        f"""\
+        # {app_id} static asset examples
+
+        Static files here belong to the view layer. They are packaged resources only.
+
+        Rules:
+
+        - Frontend assets should focus on presentation and progressive enhancement.
+        - Data interaction should prefer AJAX + backend APIs instead of embedding a second business pipeline in frontend code.
+        - Static assets are not referenced by default and should be attached through the app's template, page profile, or a documented resource owner protocol.
+
+        Demo snippet:
+
+        ```css
+        /* Demo only. Not linked by any generated template. */
+        [data-owner="{app_id}"] {{
+          display: block;
+        }}
+        ```
+        """
+    )
+
+
+__all__ = ["app_static_readme_template"]

pz_core/authoring/templates/app/template_config_page.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def app_template_config_page_template(app_id: str) -> str:
+    return dedent(
+        f"""\
+        {{
+          "name": "{app_id}_index",
+          "version": "page_center.page.v1",
+          "description": "{app_id} scaffold page template",
+          "index": "{app_id}/index.html",
+          "template_id": "{app_id}_index",
+          "client_translation_scopes": [],
+          "shared_bundle_ids": [],
+          "page_type_bundle_ids": []
+        }}
+        """
+    )
+
+
+__all__ = ["app_template_config_page_template"]

pz_core/authoring/templates/app/template_index_html.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def app_template_index_html_template(app_id: str) -> str:
+    return dedent(
+        f"""\
+        <!doctype html>
+        <html lang="en">
+          <head>
+            <meta charset="utf-8" />
+            <meta name="viewport" content="width=device-width, initial-scale=1" />
+            <title>{app_id} page template</title>
+          </head>
+          <body>
+            <main data-owner="{app_id}">
+              <h1>{app_id} page template</h1>
+              <p>This template is part of the view layer. Keep business rules in backend APIs.</p>
+            </main>
+            <script src="/static/{app_id}/app.js"></script>
+          </body>
+        </html>
+        """
+    )
+
+
+__all__ = ["app_template_index_html_template"]

pz_core/authoring/templates/app/templates_readme.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def app_templates_readme_template(app_id: str) -> str:
+    return dedent(
+        f"""\
+        # {app_id} template examples
+
+        Templates in this directory are the view layer under the MVC authoring convention.
+
+        Rules:
+
+        - Keep templates focused on presentation.
+        - Do not bury core business rules or long-lived data orchestration in template scripts.
+        - Use AJAX + backend APIs for data reads, writes, and state changes whenever possible.
+        - A route or page declaration must explicitly reference a template before it participates in runtime behavior.
+
+        Demo snippet:
+
+        ```html
+        {{# Demo only. No generated route points to this template. #}}
+        <section data-owner="{app_id}">
+          <h1>{{{{ title }}}}</h1>
+        </section>
+        ```
+        """
+    )
+
+
+__all__ = ["app_templates_readme_template"]

pz_core/authoring/templates/app/urls.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def app_urls_template(app_id: str) -> str:
+    return dedent(
+        f"""\
+        from __future__ import annotations
+
+        from pz_foundation.routing import mount, path
+
+        from .public import create_demo_mount_app
+        from .views import demo_page
+
+
+        app_name = "{app_id}"
+
+        urlpatterns = (
+            # `path(...)` 用于声明当前 app 自己提供的普通 HTTP 路由。
+            # 这里只需要写路径、处理函数和名称，具体路由构建由 pz_foundation.routing 统一完成。
+            path("/{app_id.replace('_', '-')}/demo/", demo_page, name="{app_id}:demo-page"),
+            # `mount(...)` 用于把一个独立子应用挂到某个前缀下。
+            # 当你有管理后台、代理应用或需要单独生命周期的子应用时，用这种方式声明。
+            mount(
+                "/{app_id.replace('_', '-')}/mounted-demo",
+                app=create_demo_mount_app,
+                namespace="{app_id}.mounted_demo",
+                name="{app_id}:mounted-demo",
+            ),
+        )
+        """
+    )
+
+
+__all__ = ["app_urls_template"]

pz_core/authoring/templates/app/views.py

@@ -0,0 +1,36 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def app_views_template(app_id: str) -> str:
+    return dedent(
+        f"""\
+        from __future__ import annotations
+
+        from fastapi.responses import HTMLResponse
+
+
+        # 页面入口函数示例。
+        # 这里负责返回展示内容；需要数据时，前端应优先通过 AJAX 调后端 API。
+        async def demo_page() -> HTMLResponse:
+            return HTMLResponse(
+                \"\"\"<!doctype html>
+                <html lang="en">
+                  <head>
+                    <meta charset="utf-8" />
+                    <title>{app_id} demo</title>
+                  </head>
+                  <body>
+                    <main data-owner="{app_id}">
+                      <h1>{app_id} demo page</h1>
+                      <p>Presentation stays in the frontend. Data interaction should prefer AJAX + backend APIs.</p>
+                    </main>
+                  </body>
+                </html>\"\"\"
+            )
+        """
+    )
+
+
+__all__ = ["app_views_template"]

pz_core/authoring/templates/project/__init__.py

@@ -0,0 +1 @@
+from __future__ import annotations

pz_core/authoring/templates/project/agents.py

@@ -0,0 +1,51 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def project_agents_template(
+    *,
+    pz_docs_readme: str | None = None,
+    pz_design_docs_dir: str | None = None,
+    pz_pz_commands_doc: str | None = None,
+) -> str:
+    docs_readme = pz_docs_readme or "docs/README.md"
+    design_docs_dir = pz_design_docs_dir or "docs/pz规范与使用"
+    pz_commands_doc = pz_pz_commands_doc or "docs/pz命令总览.md"
+    return dedent(
+        f"""\
+        ## 子包设计文档约束
+
+        - 任何方案开始前，应先按当前宿主 source-root 解析规则阅读正式文档：`pz` 基础包看相对文档 `{docs_readme}` 与 `{design_docs_dir}/`；本地业务包看项目根 `apps/<app_id>/docs/README.md` 与 `apps/<app_id>/docs/设计文档.md`；共享子包看对应 `[tool.uv.sources].<distribution>` 解析出的 `docs/README.md` 与 `docs/设计文档.md`。只有在确实找不到正式答案时，才允许基于现有上下文做谨慎推断。
+
+        ## PZ 资源覆盖正式结论
+
+        - 资源覆盖是文件级覆盖，顺序只看 `installed_apps`，后出现 app 覆盖前者同相对路径。
+        - 同名 CSS 资源覆盖必须继承上游组件 CSS 的稳定合同：新增业务 app 或新增覆盖文件时，应先以被覆盖的上游 CSS 作为基线，再收敛品牌变量、视觉样式和必要布局；不得只重写一小部分通用选择器而漏掉上游模板/JS 暴露的专用 class、data 状态、hover/focus/active、响应式分支或可访问性状态。
+        - 修改已有覆盖 CSS 前，必须对照上游同名 CSS 检查组件专用规则是否已同步；若业务确实要改变表现，也必须保留选择器和状态语义，避免让元素退回到不完整的通用样式。
+
+        ## pz 设计哲学
+
+        - 单一基础包：`pz` 是唯一正式基础包，也是唯一可独立启动的包；不要再发明第二套 core、第二套主 CLI、第二套宿主基础壳。
+        - 最小子包平权：除 `pz` 外，正式运行单位只有最小子包；官方能力、业务能力、本地 app 必须走同一套最小子包装配模型。
+        - 约定优先：目录名、import 包名、distribution、`app_id`、`installed_apps` 写法、环境命令都必须按统一规则收敛。
+        - 单一真相源：路由、settings、公开 surface、安装单位、环境选择、扩展声明、启动入口都必须有唯一正式真相源。
+        - 编译先于运行：运行时装配必须先形成统一 `RuntimePlan` / `SettingsSnapshot` / manifest，再进入 Web、CLI、worker 副作用阶段。
+        - 分层清晰：`pz` 只放稳定合同、发现协议、编译与通用启动协议；官方实现优先放 `pz_contrib`，业务实现优先放 app 层。
+        - 正式入口唯一：宿主启动统一走 `pz run = pz run develop = pz run dev`、`pz run test`、`pz run product`；环境选择变量唯一正式入口仍是 `PZ_ENV`。
+
+        ## pz 开发约定
+
+        - 硬约束：项目启动、配置更新都走 `pz`；具体命令统一查相对文档 `{pz_commands_doc}`。
+        - 保持约定优先：能通过既有目录结构、文件命名、公开面和正式命令解决的问题，不要再引入第二套配置、第二套路径或特判分支。
+        - 一个问题只保留一个正式且完整的解决方案；不要长期并存两套入口、两套协议、两套实现，也不要重复造轮子。
+        - 面向对象开发优先组合而不是继承；只有在稳定的 is-a 合同明确成立时才引入继承层级。
+        - 保持单一职责：模块、类、service、provider 各自只承担一个清晰职责，不要把 settings、路由、运行时副作用和业务编排揉在一起。
+        - 保持依赖倒置：上层编排依赖稳定协议、抽象和正式公开面，不直接依赖别的 app 的内部实现。
+        - 保持开闭原则：新增能力优先通过正式扩展点、provider、strategy 或 app/public surface 扩展，而不是改核心链路打补丁。
+        - 保持接口隔离与可替换性：不要暴露胖接口；子类、实现类、provider 必须遵守父协议，能被稳定替换而不改变调用方语义。
+        """
+    )
+
+
+__all__ = ["project_agents_template"]

pz_core/authoring/templates/project/apps_container_readme.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def apps_container_readme_template() -> str:
+    return dedent(
+        """\
+        # Local Apps Container
+
+        `apps/` is a source container, not a second runtime namespace.
+        Each child directory under `apps/<app_id>/` is still a formal minimal package.
+
+        ## Daily workflow
+
+        - Create a new local app with `pz startapp <slug>`.
+        - Pull an existing source checkout with `pz dev add <repo-or-app-or-dir>`.
+        - Put a managed checkout on the project business branch with `pz dev branch <repo-or-app>`; use `--base-branch main` only when explicitly required.
+        - Refresh a clean business branch with `pz dev update <repo-or-app>`.
+        - Remove a binding with `pz dev unlink <binding>`; add `--delete-checkout` only when the final clean checkout is safe to delete.
+        - Most day-to-day edits stay inside `apps/<app_id>/<app_id>/`.
+        - The files you will touch most often are `apps.py`, `urls.py`, `settings.py`, `configs/default.jsonc` templates, and `public.py`.
+        - Put page declarations under `pages/`, for example `pages/base.jsonc` or `pages/<namespace>/<page>.jsonc`.
+        - For page-oriented apps, follow the MVC authoring convention: `models.py` for data models, `templates/` and `static/` for view resources, route entry functions as controllers.
+        - Frontend code should stay presentation-focused; prefer AJAX + backend APIs for data interaction.
+        - Only touch package-root `pyproject.toml` when package metadata or dependencies change.
+
+        ## Formal boundary
+
+        - `main.py` remains the only host entrypoint.
+        - `pz.jsonc` keeps `"installed_apps": ["apps"]`; do not replace it with per-app path hacks.
+        - Do not flatten the package layout or create local shadow host shells inside app packages.
+        """
+    )
+
+
+__all__ = ["apps_container_readme_template"]

pz_core/authoring/templates/project/main_py.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def main_py_template() -> str:
+    return dedent(
+        """\
+        from __future__ import annotations
+
+        import uvicorn
+
+        from pz_core.app import create_host_app
+        from pz_core.utils import (
+            read_env_bool,
+            read_env_int,
+            read_env_string,
+            resolve_host_project_shortcuts,
+            resolve_host_reload_dirs,
+            resolve_project_dir,
+        )
+
+        def create_app():
+            return create_host_app(project_dir=resolve_project_dir())
+
+
+        def main() -> int:
+            project_dir = resolve_project_dir()
+            shortcuts = resolve_host_project_shortcuts(project_dir=project_dir)
+            reload_enabled = read_env_bool(shortcuts.app_reload, "APP_RELOAD")
+            configured_workers = max(1, read_env_int(shortcuts.app_workers, "APP_WORKERS"))
+            workers = 1 if reload_enabled else configured_workers
+            use_import_string = reload_enabled or workers > 1
+            app_target = "main:create_app" if use_import_string else create_app
+            uvicorn.run(
+                app_target,
+                host=read_env_string(shortcuts.app_host, "APP_HOST"),
+                port=read_env_int(shortcuts.app_port, "APP_PORT"),
+                reload=reload_enabled,
+                reload_dirs=resolve_host_reload_dirs(project_dir=project_dir) if reload_enabled else None,
+                workers=workers,
+                loop=read_env_string("asyncio", "UVICORN_LOOP"),
+                http=read_env_string("auto", "UVICORN_HTTP_IMPL"),
+                log_level=read_env_string("info", "UVICORN_LOG_LEVEL"),
+                proxy_headers=read_env_bool(True, "UVICORN_PROXY_HEADERS"),
+                forwarded_allow_ips=read_env_string("*", "UVICORN_FORWARDED_ALLOW_IPS"),
+                access_log=read_env_bool(True, "UVICORN_ACCESS_LOG"),
+                factory=True,
+            )
+            return 0
+
+
+        if __name__ == "__main__":
+            raise SystemExit(main())
+        """
+    )
+
+
+__all__ = ["main_py_template"]

pz_core/authoring/templates/project/project_env.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def project_env_template() -> str:
+    return dedent(
+        """\
+        # Shared secrets only.
+        # Non-sensitive project and app settings belong in `pz.jsonc`
+        # or `pz_core.{PZ_ENV}.jsonc`.
+
+        # App-specific secrets belong to the owning app documentation and
+        # settings schema. Add only the variables required by installed apps.
+        """
+    )
+
+
+__all__ = ["project_env_template"]

pz_core/authoring/templates/project/pyproject.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def project_pyproject_template(project_name: str) -> str:
+    distribution = project_name.replace("_", "-")
+    return dedent(
+        f"""\
+        [project]
+        name = "{distribution}"
+        version = "0.1.0"
+        requires-python = ">=3.11"
+        dependencies = [
+          "pz-cli==5.0.0",
+        ]
+
+        [tool.uv]
+        package = false
+
+        [tool.uv.sources]
+        """
+    )
+
+
+__all__ = ["project_pyproject_template"]

pz_core/authoring/templates/project/pz_env_env.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def _pz_env_secret_override_block() -> str:
+    return dedent(
+        """\
+
+        # Secret overrides for this pz_env
+        # Add app-specific secret overrides only when this pz_env differs from `.env`.
+        """
+    )
+
+
+def pz_env_env_template(env_name: str) -> str:
+    normalized = env_name.strip().lower()
+    if normalized == "develop":
+        return dedent(
+            """\
+            # develop pz_env overrides
+            #
+            # This file is loaded only after runtime pz_env has already been fixed.
+            # develop is the default pz_env.
+            # Non-sensitive develop overrides belong in `pz.develop.jsonc`.
+            # Keep this file for develop-only secrets when they differ from `.env`.
+            """
+        ) + _pz_env_secret_override_block()
+    if normalized == "test":
+        return dedent(
+            """\
+            # test pz_env overrides
+            #
+            # This file is loaded only after runtime pz_env has already been fixed.
+            # Use this file for automated tests, CI, or isolated verification runs.
+            # Non-sensitive test overrides belong in `pz.test.jsonc`.
+            # Keep this file for test-only secrets when they differ from `.env`.
+            """
+        ) + _pz_env_secret_override_block()
+    if normalized == "product":
+        return dedent(
+            """\
+            # product pz_env overrides
+            #
+            # This file is loaded only after runtime pz_env has already been fixed.
+            # product must be selected explicitly in the startup command.
+            # Example: pz run product
+            # Non-sensitive product overrides belong in `pz.product.jsonc`.
+            # Keep this file for product-only secrets when they differ from `.env`.
+            """
+        ) + _pz_env_secret_override_block()
+
+    return dedent(
+        f"""\
+        # {normalized} pz_env overrides
+        #
+        # This file is loaded only after runtime pz_env has already been fixed.
+        # Put only values that should differ from `.env`.
+        # Examples:
+        # project__base_url=
+        """
+    ) + _pz_env_secret_override_block()
+
+
+__all__ = ["pz_env_env_template"]

pz_core/authoring/templates/project/pz_env_jsonc.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+from typing import Any
+
+from pz_core.utils import dump_jsonc_document
+
+
+def _pz_env_override_payload(
+    *,
+    base_url: str,
+    app_reload: bool,
+    app_workers: int,
+    extra_project: dict[str, Any] | None = None,
+) -> dict[str, Any]:
+    project_payload: dict[str, Any] = {
+        "base_url": base_url,
+        "app_reload": app_reload,
+        "app_workers": app_workers,
+    }
+    if extra_project:
+        project_payload.update(extra_project)
+    return {"project": project_payload}
+
+
+def _annotate_project_base_url_comment(document: str) -> str:
+    marker = '    "base_url": '
+    comment = (
+        "    // Single service base URL. Local/IP URLs may be adjusted by explicit\n"
+        "    // APP_HOST or APP_PORT runtime overrides; domain URLs stay canonical.\n"
+    )
+    if marker not in document:
+        return document
+    return document.replace(marker, comment + marker, 1)
+
+
+def pz_env_jsonc_template(env_name: str) -> str:
+    normalized = env_name.strip().lower()
+    if normalized == "develop":
+        payload = _pz_env_override_payload(
+            base_url="http://127.0.0.1:8000",
+            app_reload=False,
+            app_workers=1,
+        )
+        return _annotate_project_base_url_comment(dump_jsonc_document(payload))
+
+    if normalized == "test":
+        payload = _pz_env_override_payload(
+            base_url="http://127.0.0.1:8000",
+            app_reload=False,
+            app_workers=1,
+        )
+        return _annotate_project_base_url_comment(dump_jsonc_document(payload))
+
+    if normalized == "product":
+        payload = _pz_env_override_payload(
+            base_url="https://your-domain.example",
+            app_reload=False,
+            app_workers=1,
+            extra_project={
+                "static_target_path": "",
+                "static_target_owner": "",
+            },
+        )
+        return _annotate_project_base_url_comment(dump_jsonc_document(payload))
+
+    return dump_jsonc_document({})
+
+
+__all__ = ["pz_env_jsonc_template"]

pz_core/authoring/templates/project/pz_jsonc.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+from ...project_defaults import build_project_scaffold_payload
+from pz_core.utils import dump_jsonc_document
+
+
+def pz_jsonc_template() -> str:
+    payload = build_project_scaffold_payload(installed_apps=["apps"])
+    return dump_jsonc_document(payload, managed_paths=("installed_apps",))
+
+
+__all__ = ["pz_jsonc_template"]

pz_core/authoring/templates/project/readme.py

@@ -0,0 +1,94 @@
+from __future__ import annotations
+
+from ..shared import dedent
+
+
+def project_readme_template() -> str:
+    return dedent(
+        """\
+        # Minimal PZ Project
+
+        This project was prepared by a grouped pz init command.
+        CLI 初始化入口固定为分组命令；新开发项目正式入口是 `pz dev init --clone-sources --project-dir .`，已有受管 `apps/.sources/pz` checkout 时可省略 `--clone-sources`；已有目录补齐骨架才使用 `pz env init --project-dir .`。
+
+        ## Layout
+
+        - `pyproject.toml`: project environment dependencies and exact managed source bindings
+        - `main.py`: the single host entrypoint
+        - `AGENTS.md`: local development rules for this project
+        - `pz.jsonc`: installed app declarations
+        - `pz.develop.jsonc` / `pz.test.jsonc` / `pz.product.jsonc`: pz_env-specific project overrides
+        - `.env`: default secrets template
+        - `.env.develop` / `.env.test` / `.env.product`: pz_env-specific env overrides
+        - `apps/`: local minimal-app container directory discovered by `"installed_apps": ["apps"]`
+        - `apps/README.md`: daily development guide for local minimal apps
+
+        ## Command Boundary
+
+        - `pz dev init` is the formal new-project orchestration command. It creates or reuses the scaffold, ensures one default local app, binds only the official `pz` bootstrap repository, reconciles the single editable `pz-cli` UV source, refreshes managed settings, and finishes the final `pz env install` pass so `pz run` can start directly.
+        - `pz env install` is the atomic initial-environment command. It creates or reuses the project `.venv`, then runs the first dependency sync for the project root and discovered authoring roots.
+        - `pz env init` is only for an existing directory that needs the formal scaffold files, managed settings blocks, AGENTS refresh, or a resync pass. It does not replace `pz dev init` for a fresh development project.
+
+        ## Next steps
+
+        1. If this directory is meant to become a fresh development project, finish the formal setup first:
+
+           ```bash
+           pz dev init --clone-sources --project-dir .
+           ```
+
+           首次执行会从 `develop` 创建当前业务分支并绑定官方 `pz` 最小仓库；只有明确需要从 `main` 起分支时才加 `--base-branch main`。命令随后完成最终 `env install`。
+
+        2. Create a local minimal app:
+
+           ```bash
+           pz startapp demo
+           ```
+
+        3. Add released app dependencies with `pz app add <app_id>` when the project should consume published packages.
+
+        4. Pull local development source with `pz dev add <repo-or-app-or-dir>` when a package needs direct source edits.
+
+        5. Ensure an existing managed checkout uses the project business branch with `pz dev branch <repo-or-app>`; then use `pz dev update <repo-or-app>` for upstream fast-forward updates.
+
+        6. Confirm `pz.jsonc` still contains `"installed_apps": ["apps"]`.
+
+        7. Put shared secrets in `.env`, and only put pz_env-specific overrides in `.env.develop` / `.env.test` / `.env.product`.
+
+        8. Use `apps/README.md` and each app package `README.md` as the daily edit index.
+
+        9. Extend project root commands in `pz.jsonc` through the root `commands` object when the project itself needs npm-like shortcuts.
+
+           ```jsonc
+           {
+             "commands": {
+               "hello": "echo hello",
+               "lint": ["python", "-m", "pytest", "-q"]
+             }
+           }
+           ```
+
+        10. Start the host:
+
+           ```bash
+           pz run
+           pz run develop
+           pz run dev
+           pz run test
+           pz run product
+           ```
+
+        ## Rules
+
+        - Keep `main.py` as the only host entrypoint.
+        - Keep local apps under `apps/<app_id>/`.
+        - Treat `apps/` as a source container, not as a second runtime namespace.
+        - Use `pz app add` for published dependencies, `pz dev add` for local source checkouts or directories, `pz dev branch` for business-branch preparation, and `pz dev update` for safe fast-forward refreshes.
+        - App default templates belong in each app's `<app_id>/configs/default.jsonc`; only `pz settings init/update` reads them.
+        - Runtime code reads generated project config through `settings_center.settings.<app_id>.<field>`.
+        - Shared functionality should live in installed packages, not shadow directories inside this project.
+        """
+    )
+
+
+__all__ = ["project_readme_template"]

pz_core/authoring/templates/project/root_gitkeep.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+
+def root_gitkeep_template() -> str:
+    return ""
+
+
+__all__ = ["root_gitkeep_template"]