yjcli 0.0.1__tar.gz

yjcli-0.0.1/.gitignore

@@ -0,0 +1,40 @@
+# Virtual environments
+.venv/
+venv/
+.env/
+.env.*
+!.env.examples
+# Packaged scaffold templates must ship env samples (still ignored in user repos).
+!src/yjcli/data/templates/**/.env.*
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+dist/
+build/
+*.egg
+
+# Test / type / coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+
+# OS / editor
+.DS_Store
+Thumbs.db
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Local tooling
+*.log
+.cache/

yjcli-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yseiren87
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yjcli-0.0.1/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: yjcli
+Version: 0.0.1
+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
+Project-URL: Issues, https://github.com/yseiren87/yjcli/issues
+Author: yseiren87
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,claude,cli,cursor,scaffold
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# yjcli
+
+Self-contained CLI (uv + `pyproject.toml`) that scaffolds YJ platform folders, services, and Cursor/Claude agent wiring.
+
+All templates, skills, and rules ship inside the package (`src/yjcli/data/`).
+
+## Develop
+
+```bash
+cd yjcli
+uv sync
+uv run yjcli --help
+```
+
+## Test / Publish (workspace root)
+
+Sibling `tools/` holds smoke-test and publish helpers (not committed with this package).
+
+```bash
+make test                            # tools/test_yjcli.py smoke checks
+
+# edit tools/.env
+UV_PUBLISH_TOKEN=pypi-...        # https://pypi.org/manage/account/token/
+# UV_PUBLISH_TOKEN_TEST=pypi-... # optional TestPyPI token
+
+make build
+make clean
+make deploy-dry / deploy-test-dry   # uv publish --dry-run
+make deploy-test                    # TestPyPI
+make deploy                         # PyPI
+```
+
+Package version is set in `pyproject.toml` / `src/yjcli/__init__.py`.
+
+## Commands
+
+```bash
+# Bootstrap current directory: AGENTS.md/CLAUDE.md, .cursor/.claude skills+rules,
+# root Makefile/.gitignore, then create selected platform roots.
+uv run yjcli init
+uv run yjcli init --all
+uv run yjcli init -p backend -p frontend
+
+uv run yjcli add platform              # interactive: add missing platforms
+uv run yjcli add platform --all
+uv run yjcli add platform -p cli
+
+uv run yjcli add service               # interactive
+uv run yjcli add service -p backend -n api
+
+uv run yjcli doctor                    # packaged asset sanity check
+uv run yjcli --version
+```
+
+Agent assets are **copied** from the package into the target repo (no `.agent` folder).
+Re-run `yjcli init --force` (or answer overwrite prompts) to refresh skills/rules.

yjcli-0.0.1/README.md

@@ -0,0 +1,56 @@
+# yjcli
+
+Self-contained CLI (uv + `pyproject.toml`) that scaffolds YJ platform folders, services, and Cursor/Claude agent wiring.
+
+All templates, skills, and rules ship inside the package (`src/yjcli/data/`).
+
+## Develop
+
+```bash
+cd yjcli
+uv sync
+uv run yjcli --help
+```
+
+## Test / Publish (workspace root)
+
+Sibling `tools/` holds smoke-test and publish helpers (not committed with this package).
+
+```bash
+make test                            # tools/test_yjcli.py smoke checks
+
+# edit tools/.env
+UV_PUBLISH_TOKEN=pypi-...        # https://pypi.org/manage/account/token/
+# UV_PUBLISH_TOKEN_TEST=pypi-... # optional TestPyPI token
+
+make build
+make clean
+make deploy-dry / deploy-test-dry   # uv publish --dry-run
+make deploy-test                    # TestPyPI
+make deploy                         # PyPI
+```
+
+Package version is set in `pyproject.toml` / `src/yjcli/__init__.py`.
+
+## Commands
+
+```bash
+# Bootstrap current directory: AGENTS.md/CLAUDE.md, .cursor/.claude skills+rules,
+# root Makefile/.gitignore, then create selected platform roots.
+uv run yjcli init
+uv run yjcli init --all
+uv run yjcli init -p backend -p frontend
+
+uv run yjcli add platform              # interactive: add missing platforms
+uv run yjcli add platform --all
+uv run yjcli add platform -p cli
+
+uv run yjcli add service               # interactive
+uv run yjcli add service -p backend -n api
+
+uv run yjcli doctor                    # packaged asset sanity check
+uv run yjcli --version
+```
+
+Agent assets are **copied** from the package into the target repo (no `.agent` folder).
+Re-run `yjcli init --force` (or answer overwrite prompts) to refresh skills/rules.

yjcli-0.0.1/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "yjcli"
+version = "0.0.1"
+description = "Scaffold platforms, services, and AI agent wiring (Cursor/Claude) for YJ architecture repos."
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+  { name = "yseiren87" },
+]
+keywords = ["cli", "scaffold", "cursor", "claude", "agent"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Software Development :: Code Generators",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "typer>=0.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/yseiren87/yjcli"
+Repository = "https://github.com/yseiren87/yjcli"
+Issues = "https://github.com/yseiren87/yjcli/issues"
+
+[project.scripts]
+yjcli = "yjcli.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/yjcli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src",
+  "/README.md",
+  "/LICENSE",
+  "/pyproject.toml",
+]
+
+[tool.uv]
+package = true

yjcli-0.0.1/src/yjcli/__init__.py

@@ -0,0 +1,3 @@
+"""yjcli — platform/service scaffold and agent wiring."""
+
+__version__ = "0.0.1"

yjcli-0.0.1/src/yjcli/__main__.py

@@ -0,0 +1,4 @@
+from yjcli.cli import app
+
+if __name__ == "__main__":
+    app()

yjcli-0.0.1/src/yjcli/cli.py

@@ -0,0 +1,51 @@
+"""Entry: register subcommands (Typer)."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+import typer
+
+from yjcli import __version__
+from yjcli.commands import add
+from yjcli.commands.init_cmd import init_cmd
+from yjcli.services import status
+
+app = typer.Typer(
+    name="yjcli",
+    help="Scaffold YJ platforms/services and Cursor/Claude agent wiring.",
+    no_args_is_help=True,
+)
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        typer.echo(__version__)
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: Optional[bool] = typer.Option(
+        None,
+        "--version",
+        "-V",
+        help="Print version and exit.",
+        callback=_version_callback,
+        is_eager=True,
+    ),
+) -> None:
+    """yjcli root options."""
+
+
+app.command("init")(init_cmd)
+app.add_typer(add.app, name="add")
+
+
+@app.command("doctor")
+def doctor() -> None:
+    """Show packaged template/skill/rule counts."""
+    assets = status.asset_summary()
+    typer.echo("yjcli packaged data:")
+    for key, n in assets.items():
+        typer.echo(f"  {key}: {n} files")

yjcli-0.0.1/src/yjcli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command groups (thin entry handlers)."""

yjcli-0.0.1/src/yjcli/commands/add.py

@@ -0,0 +1,95 @@
+"""yjcli add <resource> — extend an existing repo."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from yjcli.modules.constants import PLATFORMS
+from yjcli.services import scaffold
+
+app = typer.Typer(help="Add a platform or service to the current repo.")
+
+
+@app.command("platform")
+def add_platform(
+    platform: Optional[list[str]] = typer.Option(
+        None,
+        "--platform",
+        "-p",
+        help="Platform to add (repeatable). Interactive if omitted.",
+    ),
+    all_platforms: bool = typer.Option(
+        False,
+        "--all",
+        help="Add all missing platforms.",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing root/agent files without prompting.",
+    ),
+    path: Path = typer.Option(
+        Path("."),
+        "--path",
+        help="Target repository root (default: cwd).",
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True,
+    ),
+) -> None:
+    """Add one or more platform roots from packaged templates."""
+    if all_platforms and platform:
+        typer.echo("error: use either --all or --platform, not both", err=True)
+        raise typer.Exit(code=1)
+    if platform:
+        unknown = [p for p in platform if p not in PLATFORMS]
+        if unknown:
+            typer.echo(
+                f"error: unknown platform(s): {', '.join(unknown)}",
+                err=True,
+            )
+            raise typer.Exit(code=1)
+
+    scaffold.bootstrap(
+        path,
+        platforms=platform,
+        all_platforms=all_platforms,
+        force=force,
+        mode="add",
+    )
+
+
+@app.command("service")
+def add_service(
+    platform: Optional[str] = typer.Option(
+        None,
+        "--platform",
+        "-p",
+        help="Existing platform root. Interactive if omitted.",
+    ),
+    name: Optional[str] = typer.Option(
+        None,
+        "--name",
+        "-n",
+        help="Service/app name. Interactive if omitted.",
+    ),
+    path: Path = typer.Option(
+        Path("."),
+        "--path",
+        help="Target repository root (default: cwd).",
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True,
+    ),
+) -> None:
+    """Add a service/app under an existing platform."""
+    if platform and platform not in PLATFORMS:
+        typer.echo(f"error: unknown platform: {platform}", err=True)
+        typer.echo(f"known: {', '.join(PLATFORMS)}", err=True)
+        raise typer.Exit(code=1)
+
+    scaffold.add_service_flow(path, platform=platform, name=name)

yjcli-0.0.1/src/yjcli/commands/init_cmd.py

@@ -0,0 +1,61 @@
+"""yjcli init — bootstrap the current repo."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from yjcli.modules.constants import PLATFORMS
+from yjcli.services import scaffold
+
+
+def init_cmd(
+    platform: Optional[list[str]] = typer.Option(
+        None,
+        "--platform",
+        "-p",
+        help="Platform to create (repeatable). Interactive if omitted.",
+    ),
+    all_platforms: bool = typer.Option(
+        False,
+        "--all",
+        help="Create all known platforms.",
+    ),
+    force: bool = typer.Option(
+        False,
+        "--force",
+        "-f",
+        help="Overwrite existing root/agent files without prompting.",
+    ),
+    path: Path = typer.Option(
+        Path("."),
+        "--path",
+        help="Target repository root (default: cwd).",
+        file_okay=False,
+        dir_okay=True,
+        resolve_path=True,
+    ),
+) -> None:
+    """Bootstrap root templates, agent wiring, and selected platforms."""
+    if all_platforms and platform:
+        typer.echo("error: use either --all or --platform, not both", err=True)
+        raise typer.Exit(code=1)
+    if platform:
+        unknown = [p for p in platform if p not in PLATFORMS]
+        if unknown:
+            typer.echo(
+                f"error: unknown platform(s): {', '.join(unknown)}",
+                err=True,
+            )
+            typer.echo(f"known: {', '.join(PLATFORMS)}", err=True)
+            raise typer.Exit(code=1)
+
+    scaffold.bootstrap(
+        path,
+        platforms=platform,
+        all_platforms=all_platforms,
+        force=force,
+        mode="init",
+    )

yjcli-0.0.1/src/yjcli/data/claude-rules/output-discipline.md

@@ -0,0 +1,11 @@
+---
+description: Output and documentation discipline - concise table-first results; do not touch docs unless asked
+---
+
+# Output & Docs Discipline
+
+- Present results concisely; summarize as a table when possible.
+- Show only the summary. Do not dump raw execution output, full logs, or intermediate artifacts.
+- No filler, no repeated explanations.
+- Switch to detailed output only when the user explicitly asks (e.g. "자세히"): keep the table first, then add reasoning and key code excerpts.
+- Do not create or modify docs (README, etc.) unless the user explicitly asks. When editing a doc, rewrite it in context so it stays in sync with the code.

yjcli-0.0.1/src/yjcli/data/claude-rules/skill-backend-msa.md

@@ -0,0 +1,9 @@
+---
+description: Route backend/ edits to yj-backend-msa skill
+paths:
+  - "backend/**"
+---
+
+# Skill routing
+
+Read and follow `yj-backend-msa` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/claude-rules/skill-backend-service.md

@@ -0,0 +1,10 @@
+---
+description: Route backend-service/ and native host edits to yj-backend-service skill
+paths:
+  - "backend-service/**"
+  - "browser-extension/native_*/**"
+---
+
+# Skill routing
+
+Read and follow `yj-backend-service` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/claude-rules/skill-browser-extension.md

@@ -0,0 +1,10 @@
+---
+description: Route browser-extension/ (non-native) edits to yj-browser-extension skill
+paths:
+  - "browser-extension/**"
+---
+
+# Skill routing
+
+Read and follow `yj-browser-extension` (with `yj-arch-core`) for extension UI/background/content.
+If the path is `browser-extension/native_*/**`, use `yj-backend-service` instead.

yjcli-0.0.1/src/yjcli/data/claude-rules/skill-cli.md

@@ -0,0 +1,9 @@
+---
+description: Route cli/ edits to yj-cli skill
+paths:
+  - "cli/**"
+---
+
+# Skill routing
+
+Read and follow `yj-cli` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/claude-rules/skill-frontend.md

@@ -0,0 +1,9 @@
+---
+description: Route frontend/ edits to yj-frontend skill
+paths:
+  - "frontend/**"
+---
+
+# Skill routing
+
+Read and follow `yj-frontend` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/claude-rules/skill-mobile-app.md

@@ -0,0 +1,9 @@
+---
+description: Route mobile-app/ edits to yj-mobile-app skill
+paths:
+  - "mobile-app/**"
+---
+
+# Skill routing
+
+Read and follow `yj-mobile-app` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/claude-rules/skill-pc-app.md

@@ -0,0 +1,9 @@
+---
+description: Route pc-app/ edits to yj-pc-app skill
+paths:
+  - "pc-app/**"
+---
+
+# Skill routing
+
+Read and follow `yj-pc-app` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/claude-rules/yj-arch-core.md

@@ -0,0 +1,7 @@
+---
+description: Always load yj-arch-core skill for coding work
+---
+
+# Architecture skill
+
+When creating, modifying, reviewing, or refactoring code, read and follow the project skill `yj-arch-core`, then exactly one matching `yj-*` platform skill for the folder being edited.

yjcli-0.0.1/src/yjcli/data/cursor-rules/output-discipline.mdc

@@ -0,0 +1,12 @@
+---
+description: Output and documentation discipline - concise table-first results; do not touch docs unless asked
+alwaysApply: true
+---
+
+# Output & Docs Discipline
+
+- Present results concisely; summarize as a table when possible.
+- Show only the summary. Do not dump raw execution output, full logs, or intermediate artifacts.
+- No filler, no repeated explanations.
+- Switch to detailed output only when the user explicitly asks (e.g. "자세히"): keep the table first, then reasoning and the key code excerpts.
+- Do not create or modify docs (README, etc.) unless the user explicitly asks. When editing a doc, rewrite it in context so it stays in sync with the code.

yjcli-0.0.1/src/yjcli/data/cursor-rules/skill-backend-msa.mdc

@@ -0,0 +1,9 @@
+---
+description: Route backend/ edits to yj-backend-msa skill
+globs: backend/**
+alwaysApply: false
+---
+
+# Skill routing
+
+Read and follow `yj-backend-msa` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/cursor-rules/skill-backend-service.mdc

@@ -0,0 +1,9 @@
+---
+description: Route backend-service/ and native host edits to yj-backend-service skill
+globs: backend-service/**,browser-extension/native_*/**
+alwaysApply: false
+---
+
+# Skill routing
+
+Read and follow `yj-backend-service` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/cursor-rules/skill-browser-extension.mdc

@@ -0,0 +1,10 @@
+---
+description: Route browser-extension/ (non-native) edits to yj-browser-extension skill
+globs: browser-extension/**
+alwaysApply: false
+---
+
+# Skill routing
+
+Read and follow `yj-browser-extension` (with `yj-arch-core`) for extension UI/background/content.
+If the path is `browser-extension/native_*/**`, use `yj-backend-service` instead.

yjcli-0.0.1/src/yjcli/data/cursor-rules/skill-cli.mdc

@@ -0,0 +1,9 @@
+---
+description: Route cli/ edits to yj-cli skill
+globs: cli/**
+alwaysApply: false
+---
+
+# Skill routing
+
+Read and follow `yj-cli` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/cursor-rules/skill-frontend.mdc

@@ -0,0 +1,9 @@
+---
+description: Route frontend/ edits to yj-frontend skill
+globs: frontend/**
+alwaysApply: false
+---
+
+# Skill routing
+
+Read and follow `yj-frontend` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/cursor-rules/skill-mobile-app.mdc

@@ -0,0 +1,9 @@
+---
+description: Route mobile-app/ edits to yj-mobile-app skill
+globs: mobile-app/**
+alwaysApply: false
+---
+
+# Skill routing
+
+Read and follow `yj-mobile-app` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/cursor-rules/skill-pc-app.mdc

@@ -0,0 +1,9 @@
+---
+description: Route pc-app/ edits to yj-pc-app skill
+globs: pc-app/**
+alwaysApply: false
+---
+
+# Skill routing
+
+Read and follow `yj-pc-app` (with `yj-arch-core`). Do not apply other platform skills.

yjcli-0.0.1/src/yjcli/data/cursor-rules/yj-arch-core.mdc

@@ -0,0 +1,8 @@
+---
+description: Always load yj-arch-core skill for coding work
+alwaysApply: true
+---
+
+# Architecture skill
+
+When creating, modifying, reviewing, or refactoring code, read and follow the project skill `yj-arch-core`, then exactly one matching `yj-*` platform skill for the folder being edited.