yjcli 0.0.4__tar.gz → 0.0.6__tar.gz

{yjcli-0.0.4 → yjcli-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yjcli
-Version: 0.0.4
+Version: 0.0.6
 Summary: Scaffold platforms, services, and AI agent wiring (Cursor/Claude) for YJ architecture repos.
 Project-URL: Homepage, https://github.com/yseiren87/yjcli
 Project-URL: Repository, https://github.com/yseiren87/yjcli
@@ -27,14 +27,14 @@ Description-Content-Type: text/markdown
 
 CLI that scaffolds YJ platform folders, services, and Cursor/Claude agent wiring.
 
-Templates, skills, and rules ship inside the package and are **copied** into the target repo.
+Templates, skills, rules, and root make files ship inside the package and are **copied** into the target repo.
 
 ## Install
 
 ```bash
 uv tool install yjcli
 # pin a version:
-uv tool install yjcli==0.0.3
+uv tool install yjcli==0.0.5
 
 yjcli --version
 yjcli -h
@@ -53,8 +53,12 @@ uv tool uninstall yjcli
 uv tool install yjcli
 cd /path/to/your-repo
 yjcli init --all
+yjcli add service -p backend -n api
 # edit AGENTS.md, then:
 yjcli sync agents
+
+make backend                 # start all backend services
+make backend NAME=api        # start one service
 ```
 
 ## Platforms
@@ -68,7 +72,23 @@ Use with `-p` / `--platform` (repeatable):
 - `AGENTS.md`, `CLAUDE.md` (mirror of `AGENTS.md`)
 - `.cursor/` / `.claude/` skills, rules, and Claude `settings.json`
 - Root `Makefile`, `make.bat`, `TOOLS.md`, `.gitignore`
-- Selected platform roots (and shared `scripts/` helpers)
+- Selected platform roots (`*/scripts/run.sh` / `run.bat`)
+
+## Run (`make`)
+
+Platform targets are discovered from `*/scripts/run.sh` (after `add platform`). No Makefile edits when adding services.
+
+```bash
+make <platform>                 # all services under that platform (concurrent)
+make <platform> NAME=<service>  # one service
+make help
+
+# Windows:
+make.bat <platform>
+make.bat <platform> NAME=<service>
+```
+
+Examples: `make backend`, `make backend NAME=api`.
 
 ## Sync
 
@@ -77,7 +97,8 @@ Use with `-p` / `--platform` (repeatable):
 | `yjcli sync agents` | After editing `AGENTS.md` — refreshes `CLAUDE.md` |
 | `yjcli sync skills` | Refresh packaged skills only |
 | `yjcli sync rules` | Refresh packaged rules only |
-| `yjcli sync all` | After upgrading `yjcli` — agents + skills + rules |
+| `yjcli sync make` | Overwrite root `Makefile` / `make.bat` and each installed platform’s `scripts/run.sh` · `run.bat` |
+| `yjcli sync all` | After upgrading `yjcli` — agents + skills + rules + make (+ platform run scripts) |
 
 Edit `AGENTS.md` only; do not edit `CLAUDE.md` by hand.
 
@@ -91,6 +112,7 @@ Edit `AGENTS.md` only; do not edit `CLAUDE.md` by hand.
 - `add service` needs the platform root first (`init` or `add platform`).
 - Non-interactive use requires flags (`-p` / `-n` / `--all`, etc.); omit them only in a TTY prompt.
 - `doctor` checks the **installed package** assets, not your target repo.
+- Services are discovered by directory; `add service` does not edit `run.sh` / `Makefile`.
 
 ## Commands
 
@@ -110,6 +132,7 @@ yjcli add service -p backend -n api
 yjcli sync agents
 yjcli sync skills
 yjcli sync rules
+yjcli sync make
 yjcli sync all
 yjcli doctor
 ```

{yjcli-0.0.4 → yjcli-0.0.6}/README.md

@@ -2,14 +2,14 @@
 
 CLI that scaffolds YJ platform folders, services, and Cursor/Claude agent wiring.
 
-Templates, skills, and rules ship inside the package and are **copied** into the target repo.
+Templates, skills, rules, and root make files ship inside the package and are **copied** into the target repo.
 
 ## Install
 
 ```bash
 uv tool install yjcli
 # pin a version:
-uv tool install yjcli==0.0.3
+uv tool install yjcli==0.0.5
 
 yjcli --version
 yjcli -h
@@ -28,8 +28,12 @@ uv tool uninstall yjcli
 uv tool install yjcli
 cd /path/to/your-repo
 yjcli init --all
+yjcli add service -p backend -n api
 # edit AGENTS.md, then:
 yjcli sync agents
+
+make backend                 # start all backend services
+make backend NAME=api        # start one service
 ```
 
 ## Platforms
@@ -43,7 +47,23 @@ Use with `-p` / `--platform` (repeatable):
 - `AGENTS.md`, `CLAUDE.md` (mirror of `AGENTS.md`)
 - `.cursor/` / `.claude/` skills, rules, and Claude `settings.json`
 - Root `Makefile`, `make.bat`, `TOOLS.md`, `.gitignore`
-- Selected platform roots (and shared `scripts/` helpers)
+- Selected platform roots (`*/scripts/run.sh` / `run.bat`)
+
+## Run (`make`)
+
+Platform targets are discovered from `*/scripts/run.sh` (after `add platform`). No Makefile edits when adding services.
+
+```bash
+make <platform>                 # all services under that platform (concurrent)
+make <platform> NAME=<service>  # one service
+make help
+
+# Windows:
+make.bat <platform>
+make.bat <platform> NAME=<service>
+```
+
+Examples: `make backend`, `make backend NAME=api`.
 
 ## Sync
 
@@ -52,7 +72,8 @@ Use with `-p` / `--platform` (repeatable):
 | `yjcli sync agents` | After editing `AGENTS.md` — refreshes `CLAUDE.md` |
 | `yjcli sync skills` | Refresh packaged skills only |
 | `yjcli sync rules` | Refresh packaged rules only |
-| `yjcli sync all` | After upgrading `yjcli` — agents + skills + rules |
+| `yjcli sync make` | Overwrite root `Makefile` / `make.bat` and each installed platform’s `scripts/run.sh` · `run.bat` |
+| `yjcli sync all` | After upgrading `yjcli` — agents + skills + rules + make (+ platform run scripts) |
 
 Edit `AGENTS.md` only; do not edit `CLAUDE.md` by hand.
 
@@ -66,6 +87,7 @@ Edit `AGENTS.md` only; do not edit `CLAUDE.md` by hand.
 - `add service` needs the platform root first (`init` or `add platform`).
 - Non-interactive use requires flags (`-p` / `-n` / `--all`, etc.); omit them only in a TTY prompt.
 - `doctor` checks the **installed package** assets, not your target repo.
+- Services are discovered by directory; `add service` does not edit `run.sh` / `Makefile`.
 
 ## Commands
 
@@ -85,6 +107,7 @@ yjcli add service -p backend -n api
 yjcli sync agents
 yjcli sync skills
 yjcli sync rules
+yjcli sync make
 yjcli sync all
 yjcli doctor
 ```

{yjcli-0.0.4 → yjcli-0.0.6}/pyproject.toml

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

{yjcli-0.0.4 → yjcli-0.0.6}/src/yjcli/commands/sync.py

@@ -1,4 +1,4 @@
-"""yjcli sync <what> — refresh agent docs / skills / rules."""
+"""yjcli sync <what> — refresh agent docs / skills / rules / make."""
 
 from __future__ import annotations
 
@@ -9,7 +9,7 @@ import typer
 from yjcli.services import sync as sync_svc
 
 app = typer.Typer(
-    help="Sync AGENTS.md mirror, skills, or rules into the target repo.",
+    help="Sync AGENTS.md mirror, skills, rules, or Makefile/make.bat into the target repo.",
     no_args_is_help=True,
     context_settings={"help_option_names": ["-h", "--help"]},
 )
@@ -60,6 +60,21 @@ def sync_rules(
     sync_svc.sync_rules(path, force=True)
 
 
+@app.command("make")
+def sync_make(
+    path: Path = typer.Option(
+        Path("."),
+        "--path",
+        help="Target repository root (default: cwd).",
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True,
+    ),
+) -> None:
+    """Overwrite root Makefile/make.bat and installed platforms' run.sh/run.bat."""
+    sync_svc.sync_make(path, force=True)
+
+
 @app.command("all")
 def sync_all(
     path: Path = typer.Option(
@@ -71,5 +86,5 @@ def sync_all(
         resolve_path=True,
     ),
 ) -> None:
-    """Sync AGENTS.md → CLAUDE.md, skills, and rules together."""
+    """Sync AGENTS.md → CLAUDE.md, skills, rules, make files, and platform run scripts."""
     sync_svc.sync_all(path, force=True)

{yjcli-0.0.4 → yjcli-0.0.6}/src/yjcli/data/skills/yj-arch-core/SKILL.md

@@ -40,7 +40,9 @@ browser-extension/    # yj-browser-extension
 - `backend/proto/` is reserved (see yj-backend-msa).
 - `browser-extension/native_{name}/` → **yj-backend-service**.
 - Do not invent new platform roots or put app code at repo root.
-- Do not add per-service `scripts/` or edit root Makefile for each new service.
+- Do not add per-service `scripts/` or edit root Makefile for each new service/platform.
+  Root `make <platform>` starts all services under that platform (concurrent); `NAME=<service>` runs one.
+  Platforms are discovered via `*/scripts/run.sh`; services via sibling dirs (no script edits on `add service`).
 
 ## Environment (guardrails only)
 
@@ -49,8 +51,12 @@ Allowed files at each service root (no plain `.env`):
 `.env.local-dev` · `.env.development` · `.env.production` · `.env.examples`
 
 - Do not invent alternate names (including Vite `.env` / `.env.local`) unless a thin loader maps to this set.
-- Env field sets come from `templates/platform/<platform>/`. `browser-extension/native_*` uses the `backend-service` templates. Do not invent fields/filenames outside those templates.
-- `HOST`/`PORT` are only required when the service actually listens (e.g. backend MSA, frontend). For `backend-service` they are optional — add only if needed.
+- 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)
+  - `app`: `cli`, `mobile-app`, `pc-app`, `browser-extension` (NAME/VERSION only)
+  Do not invent fields/filenames outside those templates.
+- `HOST`/`PORT` are required for `listen`. For `worker` they are optional — add only if needed.
 - Commit `.env.examples` only; never commit the other three.
 - Local platform `run.*` uses `.env.local-dev` only — do not hardcode HOST/PORT in scripts.
 

{yjcli-0.0.4 → yjcli-0.0.6}/src/yjcli/data/skills/yj-backend-service/SKILL.md

@@ -25,7 +25,7 @@ backend-service/
     views/              # optional — only if SSR/templating enabled
 ```
 
-`browser-extension/native_{name}/` uses the same roles and the same env templates as `backend-service` (scaffolded from `templates/platform/backend-service/`). Prefer calling it a native host service, not an MSA node, unless the user explicitly adopts MSA.
+`browser-extension/native_{name}/` uses the same roles and the `worker` env templates as `backend-service`. Prefer calling it a native host service, not an MSA node, unless the user explicitly adopts MSA.
 
 `HOST`/`PORT` are **optional** here — add them to `.env.*` only when the process actually listens.
 

{yjcli-0.0.4 → yjcli-0.0.6}/src/yjcli/data/templates/AGENTS.md

@@ -17,7 +17,7 @@ Paths from `yjcli init` are fixed; add platform/app rows with `<path>` / `<role>
 | `AGENTS.md` | Agent / contributor guide (this file) |
 | `CLAUDE.md` | Mirror of `AGENTS.md` — do not edit; refresh with `yjcli sync agents` |
 | `TOOLS.md` | Release-tools feature spec (version / deploy / git) |
-| `Makefile` | Root run entry (`make run PLATFORM=… NAME=…`) |
+| `Makefile` | Root run entry — `make <platform>` (all services) or `NAME=<service>` (one); platforms auto-discovered |
 | `make.bat` | Windows counterpart of root Makefile |
 | `.gitignore` | Canonical ignore rules |
 | `.cursor/skills/` | Cursor skills (copied from package) |

yjcli-0.0.6/src/yjcli/data/templates/Makefile

@@ -0,0 +1,31 @@
+# Platform targets are discovered from */scripts/run.sh (after yjcli add platform).
+# Usage:
+#   make <platform>                 # all services under that platform (concurrent)
+#   make <platform> NAME=<service>  # one service
+
+PLATFORMS := $(patsubst %/scripts/run.sh,%,$(wildcard */scripts/run.sh))
+
+.PHONY: help $(PLATFORMS)
+
+help:
+	@echo "Usage:"
+	@echo "  make <platform>                 # start all services concurrently"
+	@echo "  make <platform> NAME=<service>  # start one service"
+	@echo ""
+	@echo "Available platforms (dirs with scripts/run.sh):"
+	@if [ -z "$(PLATFORMS)" ]; then \
+		echo "  (none — run: yjcli add platform)"; \
+	else \
+		for p in $(PLATFORMS); do echo "  $$p"; done; \
+	fi
+	@echo ""
+	@echo "Example: make backend"
+	@echo "         make backend NAME=api"
+
+$(PLATFORMS):
+	@test -x "$@/scripts/run.sh" || (echo "missing: $@/scripts/run.sh"; exit 1)
+	@if [ -n "$(NAME)" ]; then \
+		"$@/scripts/run.sh" "$(NAME)" $(ARGS); \
+	else \
+		"$@/scripts/run.sh" $(ARGS); \
+	fi

{yjcli-0.0.4 → yjcli-0.0.6}/src/yjcli/data/templates/TOOLS.md

@@ -51,11 +51,12 @@ Out of scope: app business logic, scaffold of product code, editor agent rules (
 | ID | Requirement |
 |----|-------------|
 | S1 | No secrets in git. Tokens only via I9/I10/I11. |
-| S2 | Destructive steps (publish, push, tag) require explicit confirmation, default **No**. |
-| S3 | User can abort the whole flow with a clear cancel word (recommend `exit`) on any prompt. |
+| S2 | Destructive steps (publish, push, tag) require **explicit** confirmation (`y`/`n`). No default answer. |
+| S3 | User can abort the whole flow with `exit` on any prompt (clean exit). |
 | S4 | Steps are logged with clear section boundaries (readable in a terminal). |
 | S5 | Missing config/secrets → fail with actionable message (what to set, where). |
 | S6 | Do not force-overwrite existing git tags matching I12 unless the project explicitly opts in (default: **fail**). |
+| S7 | Interactive answers: yes/no prompts accept only `y`/`n`/`exit` (also `yes`/`no`). Empty or other input → **re-ask** (never treat Enter as No/Yes). Free-text prompts: empty → re-ask unless the step allows empty; `exit` cancels. |
 
 ---
 
@@ -69,7 +70,7 @@ Out of scope: app business logic, scaffold of product code, editor agent rules (
 | V2 | Support bumps: `major` → `X+1.0.0`, `minor` → `X.Y+1.0`, `fix` → `X.Y.Z+1`. |
 | V3 | After bump, write I2; if I3 is non-empty, update those to the same version. |
 | V4 | Optional: show latest version from production target I7 when query is possible; if unavailable, warn and continue. |
-| V5 | Interactive bump: ask whether to bump; if yes, ask `major`/`minor`/`fix` (invalid/empty → re-ask; cancel per S3). |
+| V5 | Interactive bump: ask whether to bump (S7); if yes, ask `major`/`minor`/`fix` (invalid/empty → re-ask; cancel per S3). |
 | V6 | Non-interactive mode (optional): accept bump kind via flags/env; do not hang on stdin. |
 
 ### 3.2 Acceptance
@@ -88,14 +89,14 @@ Out of scope: app business logic, scaffold of product code, editor agent rules (
 | D1 | **Test**: run project-defined verification before publish (unit/smoke/e2e — project chooses). Fail stops the pipeline. |
 | D2 | **Build**: produce publishable artifact(s) for I7 (and I8 if used). |
 | D3 | **Validate** (recommended): dry-run or registry check when the ecosystem supports it. |
-| D4 | **Confirm** then **Publish** to I7 using I10. Default confirm = No. |
+| D4 | **Confirm** then **Publish** to I7 using I10. Confirm per S7 (`y`/`n`/`exit`; no default). |
 | D5 | Provide a **staging path** when I8 exists: publish to I8 without requiring a version bump or git push (unless project opts in). |
 | D6 | Production path may optionally chain into C3 after successful publish (project chooses). |
 
 ### 4.2 Acceptance
 
 - Failed D1 or D2 → no publish.
-- Declined confirm → no publish, exit cleanly.
+- Confirm `n` → no publish, abort. Confirm empty/garbage → re-ask. `exit` → clean cancel.
 - Missing I10 → fail per S5.
 
 ---
@@ -108,15 +109,16 @@ Out of scope: app business logic, scaffold of product code, editor agent rules (
 |----|----------|
 | G1 | Operate only on git root I4. |
 | G2 | Show status: branch, remote I6, current version (I2), whether tag I12(version) exists. |
-| G3 | **Commit** (optional): if working tree dirty, ask to commit; require non-empty message; cancel per S3. If clean, skip. |
-| G4 | **Tag**: create tag from I12 + current I2 version; if exists → fail (S6). |
-| G5 | **Push**: push current branch + new tag to I6. |
+| G3 | **Commit**: if working tree dirty, ask to commit (S7). `n` or cancel → **stop** (no tag/push). Require non-empty message. If clean, proceed without a new commit. |
+| G4 | **Tag**: create tag from I12 + current I2 version; confirm per S7; if exists → fail (S6). |
+| G5 | **Push**: confirm per S7, then push current branch + new tag to I6. |
 | G6 | Auth: non-interactive for scripted use (PAT from I11 for HTTPS, or SSH agent). Do not open browser login flows in the happy path. |
 | G7 | Never persist raw tokens into remote URLs in git config. |
 
 ### 5.2 Acceptance
 
-- Clean tree + new version tag → tag created and pushed when confirmed.
+- Clean tree + new version tag → tag created and pushed when confirmed (`y`).
+- Dirty tree + commit declined (`n`) → no tag, no push.
 - Existing tag → fail, no force-push by default.
 - Missing I11 when HTTPS PAT is required → fail per S5.
 

yjcli-0.0.6/src/yjcli/data/templates/make.bat

@@ -0,0 +1,48 @@
+@echo off
+setlocal EnableExtensions EnableDelayedExpansion
+
+if /I "%~1"=="" goto help
+if /I "%~1"=="help" goto help
+
+set "PLATFORM=%~1"
+if not exist "%PLATFORM%\scripts\run.bat" (
+  echo Unknown target: %PLATFORM%
+  echo Expected: %PLATFORM%\scripts\run.bat ^(yjcli add platform^)
+  exit /b 1
+)
+
+set "NAME="
+shift
+:parse
+if "%~1"=="" goto run_exec
+set "ARG=%~1"
+if /I "%ARG:~0,5%"=="NAME=" set "NAME=%ARG:~5%"
+shift
+goto parse
+
+:run_exec
+if "%NAME%"=="" (
+  call "%PLATFORM%\scripts\run.bat"
+) else (
+  call "%PLATFORM%\scripts\run.bat" "%NAME%"
+)
+exit /b %ERRORLEVEL%
+
+:help
+echo Usage:
+echo   make.bat ^<platform^>                 # all services ^(separate windows^)
+echo   make.bat ^<platform^> NAME=^<service^>  # one service
+echo.
+echo Available platforms (dirs with scripts\run.bat):
+set "FOUND="
+for /d %%D in (*) do (
+  if exist "%%D\scripts\run.bat" (
+    echo   %%D
+    set "FOUND=1"
+  )
+)
+if not defined FOUND echo   ^(none — run: yjcli add platform^)
+echo.
+echo Example: make.bat backend
+echo          make.bat backend NAME=api
+exit /b 0

{yjcli-0.0.4/src/yjcli/data/templates/platform/frontend → yjcli-0.0.6/src/yjcli/data/templates/platform/envs/listen}/.env.development

@@ -1,4 +1,4 @@
 NAME=__NAME__
 VERSION=0.1.0
 HOST=0.0.0.0
-PORT=5173
+PORT=__PORT__

{yjcli-0.0.4/src/yjcli/data/templates/platform/frontend → yjcli-0.0.6/src/yjcli/data/templates/platform/envs/listen}/.env.local-dev

@@ -1,4 +1,4 @@
 NAME=__NAME__
 VERSION=0.1.0
 HOST=127.0.0.1
-PORT=5173
+PORT=__PORT__

{yjcli-0.0.4/src/yjcli/data/templates/platform/backend → yjcli-0.0.6/src/yjcli/data/templates/platform/envs/listen}/.env.production

@@ -1,4 +1,4 @@
 NAME=__NAME__
 VERSION=0.1.0
 HOST=0.0.0.0
-PORT=8080
+PORT=__PORT__

{yjcli-0.0.4 → yjcli-0.0.6}/src/yjcli/data/templates/platform/scripts/run.bat

@@ -3,14 +3,7 @@ setlocal EnableExtensions EnableDelayedExpansion
 set "PLATFORM_DIR=%~dp0.."
 cd /d "%PLATFORM_DIR%"
 
-if "%~1"=="" (
-  echo Usage: scripts\run.bat ^<service_name^> [args...]
-  echo Available services:
-  for /d %%D in (*) do (
-    if /I not "%%~nxD"=="scripts" if /I not "%%~nxD"=="proto" echo   %%~nxD
-  )
-  exit /b 1
-)
+if "%~1"=="" goto run_all
 
 set "NAME=%~1"
 shift
@@ -41,12 +34,12 @@ for /f "usebackq tokens=1* delims==" %%A in (`findstr /R "^[A-Za-z_][A-Za-z0-9_]
   set "%%A=%%B"
 )
 
-echo env: %ENV_FILE%
+echo [%NAME%] env: %ENV_FILE%
 
 if defined PORT (
   call :kill_by_port %PORT%
 ) else (
-  echo PORT unset in .env.local-dev; using pidfile fallback
+  echo [%NAME%] PORT unset in .env.local-dev; using pidfile fallback
 )
 call :kill_by_pidfile
 
@@ -65,9 +58,27 @@ if exist "package.json" (
   exit /b %ERRORLEVEL%
 )
 
-echo Service '%NAME%' exists but has no run convention yet.
+echo [%NAME%] exists but has no run convention yet.
 exit /b 1
 
+:run_all
+set "ANY="
+for /d %%D in (*) do (
+  if /I not "%%~nxD"=="scripts" if /I not "%%~nxD"=="proto" (
+    if exist "%%D\.env.local-dev" (
+      echo starting %%~nxD
+      start "%%~nxD" cmd /c "cd /d "%PLATFORM_DIR%" && call scripts\run.bat %%~nxD"
+      set "ANY=1"
+    )
+  )
+)
+if not defined ANY (
+  echo no services under %PLATFORM_DIR% ^(run: yjcli add service^)
+  exit /b 1
+)
+echo All services started in separate windows.
+exit /b 0
+
 :kill_by_port
 set "KPORT=%~1"
 for /f "tokens=5" %%P in ('netstat -ano ^| findstr /R ":%KPORT% .*LISTENING"') do (