yjcli 0.0.1__py3-none-any.whl

yjcli/data/skills/yj-backend-service/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: yj-backend-service
+description: >-
+  Single deployable backend service architecture (non-MSA). Use when editing
+  backend-service/** or browser-extension/native_*/**. Language-agnostic.
+  Optional server-templating/SSR is an add-on chapter, not a separate platform.
+  Do not use for backend/ (MSA), frontend/, mobile-app/, pc-app/, cli/, or
+  browser-extension UI/background (non-native_*) paths.
+---
+
+# yj-backend-service
+
+Requires `yj-arch-core`. Scope: **`backend-service/`** and **`browser-extension/native_*/`**.
+
+## Shape
+
+```text
+backend-service/
+  scripts/              # platform-level only
+  {service_name}/
+    apps/               # entry
+    services/           # flow
+    domains/            # domain (if this process owns persistence)
+    modules/            # infra
+    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.
+
+`HOST`/`PORT` are **optional** here — add them to `.env.*` only when the process actually listens.
+
+## Default (API / worker / native host)
+
+Roles: `entry`, `flow`, `domain` (if persistence), `infra`. No `view`.
+
+```text
+entry  = apps/{app_name}/main.{ext}
+flow   = services/{feature}/dto.{ext} + service.{ext}
+domain = domains/{domain}/model.{ext} (+ repository/rules/errors/types)
+infra  = modules/{module}.{ext}
+```
+
+Same import rules as core: entry→flow→domain→infra. Handlers stay thin.
+
+### domain (when persistence exists)
+
+File responsibilities:
+
+- `model.{ext}`: internal domain model, entity, schema, or data shape.
+- `repository.{ext}`: persistence and retrieval using the domain model.
+- `rules.{ext}`: domain-specific decision rules and pure validations (optional).
+- `errors.{ext}` / `types.{ext}`: domain errors and value types (optional).
+
+Rules:
+
+- No HTTP/transport/template types in domain.
+- Domains must not import apps or services.
+- No domain→domain imports; compose in flow.
+- Do not duplicate the same responsibility across multiple domains.
+
+### Relation domain
+
+Same rule as MSA: when two first-class domains have a managed relationship, add `domains/{relation_domain}/` for relationship mechanics only; compose related domains in a service. The relation domain must not import the related domains directly.
+
+### Remote-only process
+
+If the process has **no** local persistence (proxy/native host that only calls remote APIs): skip `domains/`; keep clients in `modules`, rules in `services`.
+
+## Optional: server templating (SSR/MPA)
+
+Templating is an **option**, not the folder identity. Enable only when the service must render HTML.
+
+When enabled, add role `view`:
+
+```text
+view = views/{feature}/{page}.html | views/layouts/* | views/partials/*
+```
+
+Extra rules:
+
+- Handlers: parse → call flow → build template context → render. No DB in handlers.
+- flow returns plain data / view models — never HTML.
+- templates: presentation only; no DB/service/domain calls.
+- If the service is JSON-API only, do **not** create `views/`.
+
+Guide when adding SSR later:
+
+1. Add template engine wiring in `modules` + `apps`.
+2. Add `views/` layout/partials.
+3. Keep existing API flows reusable; do not fork business logic into templates.
+
+## native_host notes
+
+- Lives under `browser-extension/native_{name}/`.
+- Follow this skill's structure; messaging contract with the extension is infra/entry concern.
+- Do not put Chrome extension UI code inside `native_*`.
+
+## Editing scope
+
+- One `{service_name}` (or one `native_{name}`) only.
+- Do not apply MSA/proto rules from `yj-backend-msa` unless the user migrates the unit into `backend/`.

yjcli/data/skills/yj-browser-extension/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: yj-browser-extension
+description: >-
+  Browser extension architecture (MV3, JS/TS). Use when editing
+  browser-extension/** except native_*/** paths. Covers background, content
+  scripts, and popup/options as one extension service with multiple contexts.
+  For browser-extension/native_*/**, use yj-backend-service instead. Do not use
+  for frontend/, mobile-app/, pc-app/, backend/, backend-service/, or cli/.
+---
+
+# yj-browser-extension
+
+Requires `yj-arch-core`. Scope: **`browser-extension/`** excluding **`native_*/`**.
+
+## Shape
+
+```text
+browser-extension/
+  scripts/            # platform-level only
+  {extension_name}/
+    manifest.json
+    src/
+      background/     # privileged entry + flow
+      content/        # view/adapters per site
+      popup/          # view
+      lib/            # infra
+  native_{name}/      # NOT this skill → yj-backend-service
+```
+
+One `{extension_name}` = one extension service (multi-context, not microservices).
+
+## Contexts
+
+```text
+background = entry + flow (chrome.* privileges, message router)
+content    = view/DOM adapter (per site)
+popup/options = view
+lib        = infra
+```
+
+No `domain` in the extension itself. Durable state → `chrome.storage` or a companion `native_*` / remote backend.
+
+### background
+
+- Listeners register and route to `services/{feature}`.
+- Orchestrate downloads, DNR, fetch, native messaging from flow — not from raw listeners with business logic.
+- MV3 background is a **non-persistent service worker**: do not rely on module-level globals surviving restarts. Persist durable state in `chrome.storage` (or native host / remote backend).
+
+### content
+
+- One module per site/target. Message background for privileged work.
+- Split isolated vs MAIN world only when page globals are required.
+
+### popup/options
+
+- UI only; talk to background via messaging.
+
+## native_host
+
+- Folder name: `native_{name}/` under `browser-extension/`.
+- Architecture: **`yj-backend-service`** (single local process).
+- When editing `native_*`, do not apply extension UI rules; load `yj-backend-service`.
+- Extension ↔ host contract stays explicit (native messaging / local HTTP).
+
+## Import direction
+
+```text
+content/popup -> messaging -> background entry -> background flow -> lib / chrome.*
+lib must not import background/content/popup
+```
+
+Forbidden: content↔content business coupling; UI calling privileged chrome APIs that belong in background.
+
+## Editing scope
+
+- One `{extension_name}` context at a time when possible.
+- Companion host changes → switch to `yj-backend-service`.

yjcli/data/skills/yj-cli/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: yj-cli
+description: >-
+  Single CLI application architecture, language-agnostic. Use only when editing
+  cli/**. Commands are routes; optional domains only when the CLI owns local
+  persistence. Do not use for backend/, backend-service/, frontend/,
+  mobile-app/, pc-app/, or browser-extension/.
+---
+
+# yj-cli
+
+Requires `yj-arch-core`. Scope: **`cli/` only**.
+
+## Shape
+
+```text
+cli/
+  scripts/       # platform-level only
+  {app_name}/
+    apps/        # entry — command tree
+    services/    # flow
+    domains/     # only if persistence-owning
+    modules/     # infra
+```
+
+One `{app_name}` = one CLI service.
+
+## Two shapes
+
+```text
+persistence-owning cli  -> uses domain (local db/files)
+remote-client cli       -> no domain; clients in modules; rules in services
+```
+
+## Roles
+
+```text
+entry  = apps/{app_name}/main.{ext} (+ optional command group files same package)
+flow   = services/{feature}/dto.{ext} + service.{ext}
+domain = domains/{domain}/...   # persistence-owning only
+infra  = modules/{module}.{ext} # config, http, db, output formatters
+```
+
+### entry
+
+- Build root command, register subcommands, wire deps, dispatch.
+- Command handlers: parse flags/args → call flow → format output. No business logic / no direct domain.
+
+### flow
+
+- Feature operations. Return data or domain errors; do not print or parse argv.
+- Reuse across commands; do not create one service per command automatically.
+
+### domain
+
+- Only when CLI persists locally. No knowledge of flags/stdout formats.
+
+### infra
+
+- Printing helpers OK; **what** to print is decided in the command (entry).
+
+## Import direction
+
+```text
+entry -> flow -> domain -> infra
+entry -> infra
+flow  -> infra
+```
+
+Forbidden: command→domain/db/http directly; service→stdout/argv; cross-platform source imports.
+
+## Editing scope
+
+- `cli/{app_name}/` only.
+- Native messaging hosts that belong to extensions live under `browser-extension/native_*` and use `yj-backend-service`, not this skill — unless the user places a pure CLI under `cli/`.

yjcli/data/skills/yj-frontend/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: yj-frontend
+description: >-
+  Single frontend app architecture. Required stack: Vite + React + TypeScript +
+  react-router. Use only when editing frontend/**. Feature-level flow/view
+  separation; no domain folder by default. No plain .env. Do not use for
+  mobile-app/, pc-app/, backend/, backend-service/, cli/, or browser-extension/.
+---
+
+# yj-frontend
+
+Requires `yj-arch-core`. Scope: **`frontend/` only**.
+
+## Required stack
+
+**Vite + React + TypeScript + react-router** (mandatory).  
+Do not scaffold CRA, Next.js, Webpack-only, or non-Vite bundlers unless the user explicitly overrides.
+
+## Shape
+
+```text
+frontend/
+  scripts/                 # platform-level only
+  {app_name}/
+    src/
+      main.tsx, App.tsx          # entry
+      stores/, api/              # flow
+      pages/, components/        # view
+      lib/, hooks/               # infra
+```
+
+One `{app_name}` = one web app. No micro-frontends unless the user requests it.
+
+## Roles
+
+```text
+entry = src/main.tsx, src/App.tsx (routes)
+flow  = stores + api per feature
+view  = pages + feature components (+ generated ui primitives)
+infra = lib/*, hooks/*
+```
+
+**No `src/domains/` by default.** Model = API types; rules = store/container.  
+Exception: heavy client-only persistence/engine logic only.
+
+## Rules
+
+- Follow `yj-arch-core` env names; listen apps need `HOST`/`PORT`. No plain `.env`.
+- `npm start` / local mode must mean local-dev — do not silently point bare start at development/production deploy envs.
+- Store calls `api`; pages/components do not call network directly.
+- Container route wires store + router; presentational page takes props only.
+- Routes declared at entry — do not scatter route tables.
+- Generated UI primitives: do not hand-edit or duplicate.
+- Consume backend contracts via generated client or `backend/proto/dist/{lang}` — never copy `.proto` into frontend.
+
+## Import direction
+
+```text
+entry -> view
+view (container) -> flow (store)
+store -> api -> infra
+view (presentational) -> props only
+```
+
+## Editing scope
+
+- Stay inside `frontend/{app_name}/` (and linked contract dist if needed).
+- Do not load Electron/Flutter skills for React web work.

yjcli/data/skills/yj-mobile-app/SKILL.md

@@ -0,0 +1,63 @@
+---
+name: yj-mobile-app
+description: >-
+  Single mobile app architecture (Flutter). Use only when editing mobile-app/**.
+  Same base architecture as frontend (entry/flow/view/infra, no domain by
+  default) with Flutter/Dart primitives. Do not use for frontend/, pc-app/,
+  backend/, backend-service/, cli/, or browser-extension/.
+---
+
+# yj-mobile-app
+
+Requires `yj-arch-core`. Scope: **`mobile-app/` only**.
+
+Stack: **Flutter (Dart)** + the repo's router/state choices (e.g. go_router, riverpod).
+
+## Shape
+
+```text
+mobile-app/
+  scripts/                   # platform-level only
+  {app_name}/
+    lib/
+      main.dart, router.dart       # entry
+      providers/{feature}_*.dart   # flow
+      api/{feature}_api.dart       # flow
+      screens/...                  # view
+      widgets/...                  # view
+      lib/ or core/                # infra
+```
+
+One `{app_name}` = one mobile service.
+
+## Roles (same base as frontend)
+
+```text
+entry = main + router
+flow  = providers + api
+view  = screens (container) + presentational views/widgets
+infra = shared clients/formatters/utils
+```
+
+**No `lib/domain/` by default.** Exception: offline DB/engine-heavy client logic.
+
+## Rules
+
+- Provider/store calls api; widgets do not call network directly.
+- Container screen watches providers and passes plain props to presentational widgets.
+- Routes declared at entry.
+- Prefer symlink/consume `backend/proto/dist/dart` for MSA contracts when present. Do not copy `.proto` into the app.
+
+## Import direction
+
+```text
+entry -> view
+view (container) -> flow
+flow -> api -> infra
+view (presentational) -> constructor params only
+```
+
+## Editing scope
+
+- `mobile-app/{app_name}/` only (+ linked proto dist if needed).
+- Do not apply React/Electron folder conventions here.

yjcli/data/skills/yj-pc-app/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: yj-pc-app
+description: >-
+  Single Electron desktop app architecture. Use only when editing pc-app/**.
+  Stack may resemble frontend (React/TS) in the renderer, but process split
+  (main/preload/renderer) is mandatory and different from frontend/. Do not use
+  for frontend/, mobile-app/, backend/, backend-service/, cli/, or
+  browser-extension/.
+---
+
+# yj-pc-app
+
+Requires `yj-arch-core`. Scope: **`pc-app/` only**.
+
+Stack: **Electron** + TypeScript; renderer typically React + react-router (same UI stack family as frontend, different architecture).
+
+## Shape
+
+```text
+pc-app/
+  scripts/         # platform-level only
+  {app_name}/
+    main/          # privileged process (backend-like)
+    preload/       # bridge only
+    renderer/      # UI (frontend-like)
+```
+
+One `{app_name}` = one desktop service.
+
+## Processes
+
+### main (`entry`, `flow`, `domain?`, `infra`)
+
+```text
+entry  = main/index.ts          # lifecycle, window, ipc registration
+flow   = main/services/{feature}.ts
+domain = main/domains/{domain}/ # only if main owns real fs/db persistence
+infra  = main/modules/{module}.ts
+```
+
+- ipc handlers thin → call flow.
+- Do not expose Node/fs directly to renderer.
+
+### preload (`infra` bridge)
+
+- `contextBridge` API only; thin `ipcRenderer.invoke` wrappers.
+- No business logic. Keep channel/payload contract aligned with main + renderer api.
+
+### renderer (`entry`, `flow`, `view`, `infra` — no domain)
+
+```text
+entry = renderer/src/main.tsx, App.tsx
+flow  = stores + api (api talks to window bridge, not raw fetch to Node)
+view  = pages/components
+infra = lib/, hooks/
+```
+
+Same container/presentational split as frontend. No `renderer/src/domains/`.
+
+## Import direction
+
+```text
+main entry -> main flow -> main domain -> main infra
+renderer view -> renderer store -> renderer api -> preload bridge
+renderer must not import Node/Electron/fs
+```
+
+## Contracts
+
+- Prefer local ipc contract types shared carefully inside the app.
+- If a future lang/client can consume `backend/proto/dist/{lang}`, symlink that dist — do not copy proto sources. Electron renderer often will not use gRPC stubs directly; do not force it.
+
+## Environment gotchas
+
+- Electron binary not auto-downloaded (`Error: Electron uninstall` / missing `node_modules/electron/dist`): `electron@42+` dropped the `postinstall` lifecycle script, so `npm install` may not fetch the binary.
+  - One-off: `npx install-electron` (or `node node_modules/electron/install.js`).
+  - Permanent: app `package.json` → `"scripts": { "postinstall": "install-electron" }` (real npm lifecycle name; `postinstall:electron` does **not** run).
+  - Note: recent Electron majors may require a newer Node (check the package engines).
+
+## Editing scope
+
+- Stay in `pc-app/{app_name}/` and the process you are changing.
+- Do not use `yj-frontend` as a substitute; renderer likeness ≠ same skill.

yjcli/data/templates/.gitignore

@@ -0,0 +1,196 @@
+# =============================================================================
+# Canonical gitignore (copied to repo root by `yjcli init`)
+# Platforms: backend, backend-service, frontend, mobile-app, pc-app, cli,
+#            browser-extension (+ native hosts)
+# =============================================================================
+
+# ----- OS -----
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+Desktop.ini
+
+# ----- Editors / IDE -----
+.idea/
+*.iml
+*.ipr
+*.iws
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json.example
+*.swp
+*.swo
+*~
+.project
+.classpath
+.settings/
+.history/
+
+# ----- Environment (commit .env.examples only) -----
+.env
+.env.*
+!.env.examples
+
+# ----- Logs / debug -----
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+*.pid
+*.seed
+
+# ----- Dependencies -----
+node_modules/
+jspm_packages/
+bower_components/
+.pnpm-store/
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# Python
+.venv/
+venv/
+ENV/
+env/
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+.eggs/
+*.egg
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+.coverage
+.coverage.*
+htmlcov/
+.hypothesis/
+
+# ----- Build / output -----
+dist/
+build/
+out/
+output/
+target/
+*.o
+*.a
+*.so
+*.dylib
+*.dll
+*.exe
+*.app
+*.jar
+*.war
+*.class
+
+# Go
+bin/
+*.test
+*.out
+coverage.out
+vendor/
+
+# Java / Kotlin / Gradle / Maven
+.gradle/
+*.class
+hs_err_pid*
+
+# Dart / Flutter
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+**/doc/api/
+**/ios/Flutter/Flutter.framework
+**/ios/Flutter/Flutter.podspec
+**/ios/Pods/
+**/android/.gradle/
+**/android/local.properties
+**/android/app/debug
+**/android/app/profile
+**/android/app/release
+*.iml
+
+# Electron / desktop packaging
+*.asar
+release/
+releases/
+*.dmg
+*.AppImage
+*.snap
+*.nupkg
+
+# Vite / frontend caches
+.vite/
+.turbo/
+.cache/
+.parcel-cache/
+.eslintcache
+.stylelintcache
+*.tsbuildinfo
+.next/
+.nuxt/
+.svelte-kit/
+
+# ----- Test / coverage -----
+coverage/
+*.lcov
+.nyc_output/
+test-results/
+playwright-report/
+.mocha/
+
+# ----- Local runtime / data -----
+.data/
+data/
+tmp/
+temp/
+*.tmp
+*.temp
+.run.pid
+**/.run.pid
+*.db
+*.db-shm
+*.db-wal
+*.sqlite
+*.sqlite3
+
+# ----- Secrets / keys (never commit) -----
+*.pem
+*.key
+*.p12
+*.pfx
+id_rsa
+id_rsa.pub
+credentials.json
+service-account*.json
+secrets/
+.secrets/
+
+# ----- Protobuf generated (keep sources; ignore accidental local dumps) -----
+# Prefer committing language dists under backend/proto/dist/{lang}/ when intentional.
+# Uncomment if generated stubs must stay local-only:
+# backend/proto/dist/
+
+# ----- Misc -----
+*.bak
+*.orig
+*.rej
+.terraform/
+*.tfstate
+*.tfstate.*
+.direnv/
+.envrc.local