yjcli 0.1.2__tar.gz → 0.1.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yjcli
-Version: 0.1.2
+Version: 0.1.4
 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.
 
@@ -125,10 +129,11 @@ Edit `AGENTS.md` only; do not edit `CLAUDE.md` by hand. Use `migrate` when upgra
 
 - `platform add` only creates platform roots (no services, no skills/Makefile — use `service add` / `sync`).
 - `service add` needs the platform root first (`init` or `platform add`).
-- Non-interactive: pass `-t` / `--all` / `-p` / `-n` as needed.
+- Non-interactive: pass `-t` / `--all` / `-p` / `-n` as needed, and pass
+  `--yes` for every `sync` command.
 - `doctor` checks the **installed package** assets, not your target repo.
 - `sync skills` / `sync all` remove legacy `.cursor/rules` and `.claude/rules` if present.
-- `sync migrate` also overwrites `AGENTS.md` from the package (destructive); requires `--yes` when non-interactive.
+- `sync migrate` also overwrites `AGENTS.md` from the package (destructive).
 
 ## Commands
 

{yjcli-0.1.2 → yjcli-0.1.4}/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.
 
@@ -100,10 +104,11 @@ Edit `AGENTS.md` only; do not edit `CLAUDE.md` by hand. Use `migrate` when upgra
 
 - `platform add` only creates platform roots (no services, no skills/Makefile — use `service add` / `sync`).
 - `service add` needs the platform root first (`init` or `platform add`).
-- Non-interactive: pass `-t` / `--all` / `-p` / `-n` as needed.
+- Non-interactive: pass `-t` / `--all` / `-p` / `-n` as needed, and pass
+  `--yes` for every `sync` command.
 - `doctor` checks the **installed package** assets, not your target repo.
 - `sync skills` / `sync all` remove legacy `.cursor/rules` and `.claude/rules` if present.
-- `sync migrate` also overwrites `AGENTS.md` from the package (destructive); requires `--yes` when non-interactive.
+- `sync migrate` also overwrites `AGENTS.md` from the package (destructive).
 
 ## Commands
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "yjcli"
-version = "0.1.2"
+version = "0.1.4"
 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.4}/src/yjcli/commands/sync.py

@@ -6,6 +6,7 @@ from pathlib import Path
 
 import typer
 
+from yjcli.modules.prompt import abort
 from yjcli.services import sync as sync_svc
 
 app = typer.Typer(
@@ -18,6 +19,26 @@ app = typer.Typer(
 )
 
 
+def _confirm_sync(*, yes: bool, target: str) -> bool:
+    if yes:
+        return True
+    while True:
+        try:
+            answer = typer.prompt(
+                f"{target} files will be overwritten. Continue? [y/n]",
+                default=None,
+                show_default=False,
+            ).strip().lower()
+        except (EOFError, typer.Abort):
+            abort("non-interactive stdin; pass --yes")
+        if answer == "y":
+            return True
+        if answer == "n":
+            typer.echo("sync cancelled.")
+            return False
+        typer.echo("Enter y or n.", err=True)
+
+
 @app.command("agents")
 def sync_agents(
     path: Path = typer.Option(
@@ -28,8 +49,11 @@ def sync_agents(
         dir_okay=True,
         resolve_path=True,
     ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation."),
 ) -> None:
     """Overwrite CLAUDE.md from AGENTS.md (edit AGENTS.md only)."""
+    if not _confirm_sync(yes=yes, target="Agent mirror"):
+        return
     sync_svc.sync_agents(path)
 
 
@@ -43,8 +67,11 @@ def sync_skills(
         dir_okay=True,
         resolve_path=True,
     ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation."),
 ) -> None:
     """Overwrite .cursor/.claude/.agents skills from the yjcli package."""
+    if not _confirm_sync(yes=yes, target="Skill"):
+        return
     sync_svc.sync_skills(path, force=True)
 
 
@@ -58,8 +85,11 @@ def sync_make(
         dir_okay=True,
         resolve_path=True,
     ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation."),
 ) -> None:
     """Overwrite root Makefile/make.bat and installed platforms' run.sh/run.bat."""
+    if not _confirm_sync(yes=yes, target="Make and run script"):
+        return
     sync_svc.sync_make(path, force=True)
 
 
@@ -73,11 +103,14 @@ def sync_all(
         dir_okay=True,
         resolve_path=True,
     ),
+    yes: bool = typer.Option(False, "--yes", "-y", help="Skip confirmation."),
 ) -> None:
     """Sync AGENTS.md → CLAUDE.md, skills, make files, and platform run scripts.
 
     Does not overwrite AGENTS.md from the package (use `sync migrate` for that).
     """
+    if not _confirm_sync(yes=yes, target="Agent mirror, skill, make, and run script"):
+        return
     sync_svc.sync_all(path, force=True)
 
 
@@ -95,7 +128,7 @@ def sync_migrate(
         False,
         "--yes",
         "-y",
-        help="Skip confirmation (required when stdin is not a TTY).",
+        help="Skip confirmation.",
     ),
 ) -> None:
     """Force-replace agent wiring from the package (destructive upgrade).
@@ -104,4 +137,6 @@ def sync_migrate(
     Makefile/make.bat, platform run scripts, TOOLS.md, .gitignore,
     .claude/settings.json. Removes legacy .cursor/rules, .claude/rules, .agent.
     """
-    sync_svc.sync_migrate(path, yes=yes)
+    if not _confirm_sync(yes=yes, target="Agent wiring and root template"):
+        return
+    sync_svc.sync_migrate(path)

{yjcli-0.1.2 → yjcli-0.1.4}/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.4/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.4}/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.4}/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.4/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.4}/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.4}/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 → yjcli-0.1.4}/src/yjcli/services/sync.py

@@ -9,7 +9,7 @@ import typer
 
 from yjcli.modules import paths
 from yjcli.modules.constants import PLATFORMS
-from yjcli.modules.fsutil import copy_file, copy_tree, ensure_real_dir, is_interactive
+from yjcli.modules.fsutil import copy_file, copy_tree, ensure_real_dir
 from yjcli.modules.prompt import abort
 
 _SKILL_DEST_RELS = (
@@ -114,25 +114,13 @@ def sync_all(root: Path, *, force: bool = True) -> None:
     sync_make(root, force=force)
 
 
-def sync_migrate(root: Path, *, yes: bool = False) -> None:
+def sync_migrate(root: Path) -> None:
     """Force-replace agent wiring + root templates from the package (destructive).
 
     Unlike `sync all`, this overwrites `AGENTS.md` from the package template,
     wipes skill directories (drops stale skills), removes legacy rules / `.agent`,
     and refreshes Claude settings + TOOLS.md / .gitignore / make scripts.
     """
-    if not yes:
-        if not is_interactive():
-            abort("migrate requires --yes in non-interactive mode")
-        answer = typer.prompt(
-            "migrate overwrites AGENTS.md, skills, Makefile, TOOLS.md, "
-            ".gitignore, .claude/settings.json; removes legacy rules/.agent. "
-            "Continue? [y/N]",
-            default="N",
-        )
-        if answer.strip().lower() not in {"y", "yes"}:
-            abort("migrate cancelled")
-
     typer.echo("== migrate: strip legacy ==")
     _remove_legacy_rules_dirs(root)
     _remove_path(root, Path(".agent"), label="legacy")

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=""