yjcli 0.1.0__tar.gz → 0.1.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yjcli
-Version: 0.1.0
+Version: 0.1.2
 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
@@ -78,12 +78,22 @@ Use with `-t` / `--type` (repeatable on `init` / `platform add`):
 - Root `Makefile`, `make.bat`, `TOOLS.md`, `.gitignore`
 - Selected platform roots (`*/scripts/run.sh` / `run.bat`)
 
+The root `Makefile` / `make.bat` is the repository-owned extension point for
+project automation. Projects may add commands such as `<platform>-build` or
+`<platform>-deploy` and reuse optional `NAME=<service>` selection. Defining and
+implementing init/install/build/deploy behavior is the project's responsibility;
+yjcli does not generate action scripts. Do not add per-service `scripts/`
+directories or per-service Makefiles.
+
 Operating rules (skill routing, output discipline) are in `AGENTS.md` — not in
 `.cursor/rules` / `.claude/rules`.
 
 ## Run (`make`)
 
 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`.
+The platform runner executes that repository-owned declaration instead of
+inferring npm, uv, Go, or another language/runtime from project manifests.
 
 ```bash
 make <platform>                 # all services under that platform (concurrent)

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

@@ -53,12 +53,22 @@ Use with `-t` / `--type` (repeatable on `init` / `platform add`):
 - Root `Makefile`, `make.bat`, `TOOLS.md`, `.gitignore`
 - Selected platform roots (`*/scripts/run.sh` / `run.bat`)
 
+The root `Makefile` / `make.bat` is the repository-owned extension point for
+project automation. Projects may add commands such as `<platform>-build` or
+`<platform>-deploy` and reuse optional `NAME=<service>` selection. Defining and
+implementing init/install/build/deploy behavior is the project's responsibility;
+yjcli does not generate action scripts. Do not add per-service `scripts/`
+directories or per-service Makefiles.
+
 Operating rules (skill routing, output discipline) are in `AGENTS.md` — not in
 `.cursor/rules` / `.claude/rules`.
 
 ## Run (`make`)
 
 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`.
+The platform runner executes that repository-owned declaration instead of
+inferring npm, uv, Go, or another language/runtime from project manifests.
 
 ```bash
 make <platform>                 # all services under that platform (concurrent)

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

@@ -1,6 +1,6 @@
 [project]
 name = "yjcli"
-version = "0.1.0"
+version = "0.1.2"
 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.0 → yjcli-0.1.2}/src/yjcli/data/skills/yj-arch-core/SKILL.md

@@ -41,9 +41,14 @@ 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/platform.
+- Do not create a `Makefile` inside any service folder, including generic `run`,
+  `install`, or `help` targets. Do not add per-service `scripts/`.
   Root `make <platform>` starts all services under that platform (concurrent); `NAME=<service>` runs one.
-  Platforms via `*/scripts/run.sh`; services via `yjcli service add` (sibling dirs; no Makefile edits).
+  Platforms run via `*/scripts/run.*`; services are sibling dirs created with `yjcli service add`.
+- The root `Makefile` / `make.bat` is repository-owned and may be extended. Prefer
+  `<platform>-<action> [NAME=<service>]` when an action should target all services
+  or one service (for example, `backend-deploy`). The repository owns and implements
+  actions such as init/install/build/deploy; yjcli does not generate action scripts.
 
 
 ## Environment (guardrails only)
@@ -61,6 +66,9 @@ Allowed files at each service root (no plain `.env`):
 - `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.
+- 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
+  `package.json`, `pyproject.toml`, `go.mod`, or other language/runtime manifests.
 
 ## Skill routing
 

{yjcli-0.1.0 → yjcli-0.1.2}/src/yjcli/data/templates/.gitignore

@@ -35,6 +35,14 @@ Desktop.ini
 .env.*
 !.env.examples
 
+# Keep yjcli's packaged env source templates when this file lives under data/templates.
+# These paths do not match generated service env files in a target repository.
+!platform/envs/
+!platform/envs/*/
+!platform/envs/*/.env.local-dev
+!platform/envs/*/.env.development
+!platform/envs/*/.env.production
+
 # ----- Logs / debug -----
 logs/
 *.log

{yjcli-0.1.0 → yjcli-0.1.2}/src/yjcli/data/templates/AGENTS.md

@@ -57,8 +57,8 @@ Paths from `yjcli init` are fixed; add platform/app rows with `<path>` / `<role>
 | `AGENTS.md` | Agent / contributor guide (this file) — source of truth |
 | `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 <platform>` (all services) or `NAME=<service>` (one); platforms auto-discovered |
-| `make.bat` | Windows counterpart of root Makefile |
+| `Makefile` | Extensible root entry — `make <platform>` (all services) or `NAME=<service>` (one); repository may add `<platform>-<action>` targets |
+| `make.bat` | Extensible Windows counterpart of root Makefile |
 | `.gitignore` | Canonical ignore rules |
 | `.cursor/skills/` | Cursor skills (copied from package) |
 | `.claude/skills/` | Claude skills (copied from package) |

{yjcli-0.1.0 → yjcli-0.1.2}/src/yjcli/data/templates/Makefile

@@ -2,6 +2,9 @@
 # Usage:
 #   make <platform>                 # all services under that platform (concurrent)
 #   make <platform> NAME=<service>  # one service
+# Extend this root file for repository-owned work when needed. A useful pattern
+# is <platform>-<action> with the same optional NAME selector, for example
+# `make backend-deploy [NAME=api]`. yjcli does not define those actions.
 
 PLATFORMS := $(patsubst %/scripts/run.sh,%,$(wildcard */scripts/run.sh))
 

{yjcli-0.1.0 → yjcli-0.1.2}/src/yjcli/data/templates/make.bat

@@ -1,5 +1,7 @@
 @echo off
 setlocal EnableExtensions EnableDelayedExpansion
+rem Extend this root file with repository-owned platform-action commands as needed,
+rem for example: make.bat backend-deploy NAME=api. yjcli does not define them.
 
 if /I "%~1"=="" goto help
 if /I "%~1"=="help" goto help

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

@@ -0,0 +1,8 @@
+# Service display name
+NAME=
+
+# Semver or build version
+VERSION=
+
+# Local command used only by platform scripts/run.* (.env.local-dev)
+RUN_COMMAND=

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

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

{yjcli-0.1.0 → yjcli-0.1.2}/src/yjcli/data/templates/platform/envs/listen/.env.examples

@@ -9,3 +9,6 @@ HOST=
 
 # Listen port
 PORT=
+
+# Local command used only by platform scripts/run.* (.env.local-dev)
+RUN_COMMAND=

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

@@ -0,0 +1,6 @@
+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.0 → yjcli-0.1.2}/src/yjcli/data/templates/platform/envs/worker/.env.examples

@@ -9,3 +9,6 @@ VERSION=
 
 # Optional listen port (add only when this service exposes a port)
 # PORT=
+
+# Local command used only by platform scripts/run.* (.env.local-dev)
+RUN_COMMAND=

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

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

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

@@ -3,7 +3,7 @@ import react from "@vitejs/plugin-react";
 
 // Env files (yj-arch-core): .env.local-dev | .env.development | .env.production
 // Loaded via Vite --mode (no plain .env).
-// Platform run.sh always uses .env.local-dev and may pass --host/--port.
+// Platform run.* always exports values from .env.local-dev before RUN_COMMAND.
 
 export default defineConfig(({ mode }) => {
   const env = loadEnv(mode, process.cwd(), "");

{yjcli-0.1.0 → yjcli-0.1.2}/src/yjcli/data/templates/platform/scripts/run.bat

@@ -1,5 +1,6 @@
 @echo off
 setlocal EnableExtensions EnableDelayedExpansion
+rem The service owns RUN_COMMAND; this runner does not infer a language/runtime.
 set "PLATFORM_DIR=%~dp0.."
 cd /d "%PLATFORM_DIR%"
 
@@ -31,7 +32,8 @@ if not exist "%ENV_FILE%" (
 
 rem Load KEY=VALUE from .env.local-dev
 for /f "usebackq tokens=1* delims==" %%A in (`findstr /R "^[A-Za-z_][A-Za-z0-9_]*=" "%ENV_FILE%"`) do (
-  set "%%A=%%B"
+  rem %%~B removes optional dotenv quotes while preserving the value text.
+  set "%%A=%%~B"
 )
 
 echo [%NAME%] env: %ENV_FILE%
@@ -45,21 +47,15 @@ call :kill_by_pidfile
 
 cd /d "%SERVICE_DIR%"
 
-if exist "Makefile" (
-  make run %*
-  exit /b %ERRORLEVEL%
-)
-
-if exist "package.json" (
-  set "EXTRA="
-  if defined HOST set "EXTRA=!EXTRA! --host %HOST%"
-  if defined PORT set "EXTRA=!EXTRA! --port %PORT%"
-  call npm start -- !EXTRA! %*
-  exit /b %ERRORLEVEL%
+if not defined RUN_COMMAND (
+  echo [%NAME%] RUN_COMMAND is unset in %ENV_FILE%
+  echo Declare the service-owned local command, for example: RUN_COMMAND=your-command --flag
+  exit /b 1
 )
 
-echo [%NAME%] exists but has no run convention yet.
-exit /b 1
+echo [%NAME%] command: !RUN_COMMAND!
+call !RUN_COMMAND! %*
+exit /b %ERRORLEVEL%
 
 :run_all
 set "ANY="

{yjcli-0.1.0 → yjcli-0.1.2}/src/yjcli/data/templates/platform/scripts/run.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 # Run service(s) under this platform.
 # Always loads {service}/.env.local-dev (never development/production).
+# The service owns RUN_COMMAND; this runner does not infer a language/runtime.
 # Usage:
 #   ./scripts/run.sh                 # all services concurrently
 #   ./scripts/run.sh <service> [args...]
@@ -111,44 +112,18 @@ run_one() {
     exit "$code"
   }
 
-  cd "$SERVICE_DIR"
-
-  if [ -f "Makefile" ]; then
-    export HOST="${HOST:-}"
-    export PORT="${PORT:-}"
-    start_and_track make run "$@"
-  fi
-
-  if [ -f "package.json" ]; then
-    export HOST="${HOST:-}"
-    export PORT="${PORT:-}"
-    local -a extra=()
-    if [ -n "${HOST:-}" ]; then
-      extra+=(--host "$HOST")
-    fi
-    if [ -n "${PORT:-}" ]; then
-      extra+=(--port "$PORT")
-    fi
-    if npm run | grep -qE '^  start$'; then
-      if [ "${#extra[@]}" -gt 0 ]; then
-        start_and_track npm start -- "${extra[@]}" "$@"
-      else
-        start_and_track npm start -- "$@"
-      fi
-    fi
-    if npm run | grep -qE '^  dev$'; then
-      if [ "${#extra[@]}" -gt 0 ]; then
-        start_and_track npm run dev -- "${extra[@]}" "$@"
-      else
-        start_and_track npm run dev -- "$@"
-      fi
-    fi
-    start_and_track npm start -- "$@"
+  if [ -z "${RUN_COMMAND:-}" ]; then
+    echo "[$NAME] RUN_COMMAND is unset in $ENV_FILE"
+    echo "Declare the service-owned local command, for example: RUN_COMMAND=\"your-command --flag\""
+    return 1
   fi
 
-  echo "[$NAME] exists at $SERVICE_DIR"
-  echo "No run convention found yet (add Makefile target 'run' or package.json scripts)."
-  return 1
+  cd "$SERVICE_DIR"
+  echo "[$NAME] command: $RUN_COMMAND"
+  # RUN_COMMAND is trusted, repository-owned configuration. Execute it through
+  # the platform shell so one contract works for any repository-selected tool.
+  # Extra arguments supplied after the service name are appended as "$@".
+  start_and_track bash -c "$RUN_COMMAND \"\$@\"" yjcli-run "$@"
 }
 
 run_all() {

yjcli-0.1.0/src/yjcli/data/templates/platform/envs/app/.env.examples

@@ -1,5 +0,0 @@
-# Service display name
-NAME=
-
-# Semver or build version
-VERSION=

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

@@ -1,2 +0,0 @@
-NAME=__NAME__
-VERSION=0.1.0

yjcli-0.1.0/src/yjcli/data/templates/platform/envs/listen/.env.local-dev

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

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

@@ -1,2 +0,0 @@
-NAME=__NAME__
-VERSION=0.1.0