yjcli 0.1.2__tar.gz → 0.1.3__tar.gz

{yjcli-0.1.2 → yjcli-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yjcli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Scaffold platforms, services, and AI agent wiring (Cursor/Claude/Codex) for YJ architecture repos.
 Project-URL: Homepage, https://github.com/yseiren87/yjcli
 Project-URL: Repository, https://github.com/yseiren87/yjcli
@@ -92,6 +92,10 @@ Operating rules (skill routing, output discipline) are in `AGENTS.md` — not in
 
 Platform targets are discovered from `*/scripts/run.sh` (after `init` / `platform add`).
 Each service declares its local command as `RUN_COMMAND` in `.env.local-dev`.
+New services include `.env.local-dev`, `.env.development`, `.env.production`, and
+`.env.examples`. Only `.env.local-dev` and `.env.examples` are required;
+development/production may be removed and other `.env.<environment>` files may
+be added. Commit `.env.examples` only.
 The platform runner executes that repository-owned declaration instead of
 inferring npm, uv, Go, or another language/runtime from project manifests.
 

{yjcli-0.1.2 → yjcli-0.1.3}/README.md

@@ -67,6 +67,10 @@ Operating rules (skill routing, output discipline) are in `AGENTS.md` — not in
 
 Platform targets are discovered from `*/scripts/run.sh` (after `init` / `platform add`).
 Each service declares its local command as `RUN_COMMAND` in `.env.local-dev`.
+New services include `.env.local-dev`, `.env.development`, `.env.production`, and
+`.env.examples`. Only `.env.local-dev` and `.env.examples` are required;
+development/production may be removed and other `.env.<environment>` files may
+be added. Commit `.env.examples` only.
 The platform runner executes that repository-owned declaration instead of
 inferring npm, uv, Go, or another language/runtime from project manifests.
 

{yjcli-0.1.2 → yjcli-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "yjcli"
-version = "0.1.2"
+version = "0.1.3"
 description = "Scaffold platforms, services, and AI agent wiring (Cursor/Claude/Codex) for YJ architecture repos."
 readme = "README.md"
 requires-python = ">=3.12"

{yjcli-0.1.2 → yjcli-0.1.3}/src/yjcli/data/skills/yj-arch-core/SKILL.md

@@ -53,18 +53,29 @@ browser-extension/    # yj-browser-extension
 
 ## Environment (guardrails only)
 
-Allowed files at each service root (no plain `.env`):
+Required files at each service root (no plain `.env`):
 
-`.env.local-dev` · `.env.development` · `.env.production` · `.env.examples`
+`.env.local-dev` · `.env.examples`
 
-- Do not invent alternate names (including Vite `.env` / `.env.local`) unless a thin loader maps to this set.
+- New services also start with `.env.development` and `.env.production`, but these
+  are optional. Remove them when unused or add environments such as `.env.staging`,
+  `.env.test`, or `.env.qa` as the project requires. Environment files must follow
+  the `.env.<environment>` naming pattern; do not use plain `.env` or Vite's
+  `.env.local` convention unless a thin loader maps it to this structure.
 - Env field sets come from `templates/platform/envs/<kind>/` via platform mapping (`listen` / `worker` / `app`).
   - `listen`: `backend` (PORT 8080), `frontend` (PORT 5173)
-  - `worker`: `backend-service`, `browser-extension/native_*` (HOST/PORT optional comments)
+  - `worker`: `backend-service`, `browser-extension/native_*` (HOST/PORT optional)
   - `app`: `cli`, `mobile-app`, `pc-app`, `browser-extension` (NAME/VERSION only)
-  Do not invent fields/filenames outside those templates.
+  Do not invent fields outside those templates; environment filenames remain
+  extensible through the `.env.<environment>` pattern above.
 - `HOST`/`PORT` are required for `listen`. For `worker` they are optional — add only if needed.
-- Commit `.env.examples` only; never commit the other three.
+- `.env.examples` is the committed field contract. Format every entry as one
+  comment line followed by one empty `FIELD=` line, with one blank line between
+  entries.
+- Every other `.env.<environment>` file lists populated `FIELD=value` lines
+  consecutively, without field-description comments or separator blank lines.
+- Commit `.env.examples` only; never commit `.env.local-dev` or any other
+  environment value file.
 - Local platform `run.*` uses `.env.local-dev` only — do not hardcode HOST/PORT in scripts.
 - Each service declares its repository-owned local `RUN_COMMAND` in `.env.local-dev`.
   Platform `run.*` must execute that declaration and must not infer commands from

yjcli-0.1.3/src/yjcli/data/templates/platform/envs/app/.env.local-dev

@@ -0,0 +1,3 @@
+NAME=__NAME__
+VERSION=0.1.0
+RUN_COMMAND=""

{yjcli-0.1.2 → yjcli-0.1.3}/src/yjcli/data/templates/platform/envs/listen/.env.local-dev

@@ -2,5 +2,4 @@ NAME=__NAME__
 VERSION=0.1.0
 HOST=127.0.0.1
 PORT=__PORT__
-# Repository-owned local command; quote values containing spaces.
 RUN_COMMAND=""

{yjcli-0.1.2 → yjcli-0.1.3}/src/yjcli/data/templates/platform/envs/worker/.env.examples

@@ -4,11 +4,11 @@ NAME=
 # Semver or build version
 VERSION=
 
-# Optional listen bind (add only when this service exposes a port)
-# HOST=
+# Optional listen bind
+HOST=
 
-# Optional listen port (add only when this service exposes a port)
-# PORT=
+# Optional listen port
+PORT=
 
 # Local command used only by platform scripts/run.* (.env.local-dev)
 RUN_COMMAND=

yjcli-0.1.3/src/yjcli/data/templates/platform/envs/worker/.env.local-dev

@@ -0,0 +1,3 @@
+NAME=__NAME__
+VERSION=0.1.0
+RUN_COMMAND=""

{yjcli-0.1.2 → yjcli-0.1.3}/src/yjcli/data/templates/platform/frontend/vite.config.ts

@@ -1,7 +1,7 @@
 import { defineConfig, loadEnv } from "vite";
 import react from "@vitejs/plugin-react";
 
-// Env files (yj-arch-core): .env.local-dev | .env.development | .env.production
+// Env files (yj-arch-core): required .env.local-dev plus optional .env.<environment> files.
 // Loaded via Vite --mode (no plain .env).
 // Platform run.* always exports values from .env.local-dev before RUN_COMMAND.
 

{yjcli-0.1.2 → yjcli-0.1.3}/src/yjcli/services/scaffold.py

@@ -19,7 +19,9 @@ from yjcli.modules.prompt import abort, select_existing_platform, select_platfor
 from yjcli.services import wiring
 
 _SERVICE_NAME_RE = re.compile(r"^[A-Za-z0-9_][A-Za-z0-9_-]*$")
-_ENV_FILE_NAMES = (
+# New services start with these files. Projects may remove development/production
+# or add other .env.<environment> files; examples and local-dev remain required.
+_DEFAULT_ENV_FILE_NAMES = (
     ".env.local-dev",
     ".env.development",
     ".env.production",
@@ -77,7 +79,7 @@ def _copy_env_templates(platform: str, name: str, dest: Path) -> None:
         abort(f"missing env template dir: {src}")
 
     replace = {"__NAME__": name, **extra}
-    for filename in _ENV_FILE_NAMES:
+    for filename in _DEFAULT_ENV_FILE_NAMES:
         file = src / filename
         if not file.is_file():
             abort(f"missing env template: {file}")

yjcli-0.1.2/src/yjcli/data/templates/platform/envs/app/.env.local-dev

@@ -1,4 +0,0 @@
-NAME=__NAME__
-VERSION=0.1.0
-# Repository-owned local command; quote values containing spaces.
-RUN_COMMAND=""

yjcli-0.1.2/src/yjcli/data/templates/platform/envs/worker/.env.local-dev

@@ -1,4 +0,0 @@
-NAME=__NAME__
-VERSION=0.1.0
-# Repository-owned local command; quote values containing spaces.
-RUN_COMMAND=""