codex-rule-maker 0.3.0__tar.gz → 0.4.0__tar.gz

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-rule-maker
-Version: 0.3.0
+Version: 0.4.0
 Summary: CLI tool that generates a .codex folder with AI developer rules and project reference documents.
 Author: codex-rule-maker
 Project-URL: Homepage, https://github.com/Sharon77770/codex_rule_maker
@@ -30,6 +30,8 @@ Dynamic: license-file
 
 # codex-rule-maker
 
+현재 버전: `0.4.0`
+
 `codex-rule-maker`는 프로젝트 루트에 `.codex` 규칙 폴더와 `docs/` 프로젝트 문서 템플릿을 자동 구성하는 Python CLI 도구입니다. 사용자가 프로젝트 이름, 설명, 스택, DB, 인증 여부, 외부 API 여부, 문서화 수준, 문서 언어를 입력하면 Codex가 작업 전에 읽을 개발 규칙과 프로젝트 문서 구조를 생성합니다.
 
 ## 설치
@@ -225,7 +227,8 @@ docs/
 ## 지원 프레임워크 프로필
 
 - `fastapi`: 기능 폴더 하위 controller/service/repository/schema/entity 분리
-- `python`: 기능/도메인 폴더 하위 service/adapter/model/CLI 경계 분리
+- `python`: 프레임워크 없는 Python 프로젝트의 기능/도메인 폴더 하위 service/adapter/model/CLI 경계 분리
+- `typescript-javascript`: 프레임워크 없는 TypeScript/JavaScript 프로젝트의 기능/도메인 폴더 하위 service/adapter/model 경계 분리
 - `springboot`: 기능 package 하위 controller/service/repository/entity/dto 분리
 - `react`: 기능 폴더 하위 page/component/hook/service/store 분리
 - `nextjs`: App Router 유지, 기능 폴더 하위 component/service/repository/type 분리
@@ -237,6 +240,8 @@ docs/
 ```bash
 codex-init --stack fastapi,react
 codex-init --stack python
+codex-init --stack typescript
+codex-init --stack javascript
 codex-init --stack fullstack-fastapi-react
 codex-init --stack nextjs
 ```
@@ -247,7 +252,7 @@ codex-init --stack nextjs
 - `--language en`을 사용하면 영어 문서를 생성합니다.
 - `--docs strict`는 코드 변경 후 문서 업데이트 필수 규칙을 포함합니다.
 - `--auth yes`는 인증/권한 규칙을 포함합니다.
-- `--external-api yes`는 외부 연동 계층 분리 규칙을 포함합니다.
+- `--external-api yes`는 확인된 계약을 기준으로 실제 외부 연동을 구현하기 위한 client/adapter 및 계약 문서 규칙을 포함합니다.
 - `--db mysql`처럼 DB를 지정하면 DB, Repository, Schema 관련 규칙을 포함합니다.
 - 프로젝트 명세 템플릿은 `.codex/ref_docs`가 아니라 `docs/architecture`, `docs/api`, `docs/database`에 생성됩니다.
 

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/README.md

@@ -1,5 +1,7 @@
 # codex-rule-maker
 
+현재 버전: `0.4.0`
+
 `codex-rule-maker`는 프로젝트 루트에 `.codex` 규칙 폴더와 `docs/` 프로젝트 문서 템플릿을 자동 구성하는 Python CLI 도구입니다. 사용자가 프로젝트 이름, 설명, 스택, DB, 인증 여부, 외부 API 여부, 문서화 수준, 문서 언어를 입력하면 Codex가 작업 전에 읽을 개발 규칙과 프로젝트 문서 구조를 생성합니다.
 
 ## 설치
@@ -195,7 +197,8 @@ docs/
 ## 지원 프레임워크 프로필
 
 - `fastapi`: 기능 폴더 하위 controller/service/repository/schema/entity 분리
-- `python`: 기능/도메인 폴더 하위 service/adapter/model/CLI 경계 분리
+- `python`: 프레임워크 없는 Python 프로젝트의 기능/도메인 폴더 하위 service/adapter/model/CLI 경계 분리
+- `typescript-javascript`: 프레임워크 없는 TypeScript/JavaScript 프로젝트의 기능/도메인 폴더 하위 service/adapter/model 경계 분리
 - `springboot`: 기능 package 하위 controller/service/repository/entity/dto 분리
 - `react`: 기능 폴더 하위 page/component/hook/service/store 분리
 - `nextjs`: App Router 유지, 기능 폴더 하위 component/service/repository/type 분리
@@ -207,6 +210,8 @@ docs/
 ```bash
 codex-init --stack fastapi,react
 codex-init --stack python
+codex-init --stack typescript
+codex-init --stack javascript
 codex-init --stack fullstack-fastapi-react
 codex-init --stack nextjs
 ```
@@ -217,7 +222,7 @@ codex-init --stack nextjs
 - `--language en`을 사용하면 영어 문서를 생성합니다.
 - `--docs strict`는 코드 변경 후 문서 업데이트 필수 규칙을 포함합니다.
 - `--auth yes`는 인증/권한 규칙을 포함합니다.
-- `--external-api yes`는 외부 연동 계층 분리 규칙을 포함합니다.
+- `--external-api yes`는 확인된 계약을 기준으로 실제 외부 연동을 구현하기 위한 client/adapter 및 계약 문서 규칙을 포함합니다.
 - `--db mysql`처럼 DB를 지정하면 DB, Repository, Schema 관련 규칙을 포함합니다.
 - 프로젝트 명세 템플릿은 `.codex/ref_docs`가 아니라 `docs/architecture`, `docs/api`, `docs/database`에 생성됩니다.
 

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/codex_builder/cli.py

@@ -10,7 +10,7 @@ from typing import Optional
 from codex_builder.builder import CodexBuilder, CodexBuildError, ExistingCodexError
 from codex_builder.models import ConfigError
 from codex_builder.prompt import PromptAbort, PromptSession
-from codex_builder.profiles import UnknownProfileError, supported_profile_names
+from codex_builder.profiles import UnknownProfileError, supported_profile_labels
 
 
 def build_parser() -> argparse.ArgumentParser:
@@ -22,7 +22,7 @@ def build_parser() -> argparse.ArgumentParser:
     parser.add_argument("--description", help="Short project description.")
     parser.add_argument(
         "--stack",
-        help=f"Comma-separated stack profiles. Supported: {', '.join(supported_profile_names())}.",
+        help=f"Comma-separated stack profiles. Supported: {', '.join(supported_profile_labels())}.",
     )
     parser.add_argument("--db", "--database", dest="database", help="Database name, for example mysql or postgres.")
     parser.add_argument("--auth", help="Whether authentication is used: yes/no.")

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/codex_builder/profiles.py

@@ -109,6 +109,72 @@ PYTHON_PROFILE = FrameworkProfile(
 )
 
 
+TYPESCRIPT_JAVASCRIPT_PROFILE = FrameworkProfile(
+    key="typescript-javascript",
+    display_name="TypeScript/JavaScript",
+    philosophy_ko="일반 TypeScript/JavaScript 프로젝트는 프레임워크 전제 없이 기능/도메인 폴더를 우선하고, 각 기능 내부에서 service, adapter, model 경계를 분리한다.",
+    philosophy_en="General TypeScript/JavaScript projects should prefer feature/domain folders first, then separate service, adapter, and model boundaries without assuming a framework.",
+    architecture_ko=(
+        "패키지는 기능 또는 도메인 책임 기준으로 나누고 각 기능 폴더 하위에 services, adapters, models/types 등을 둔다.",
+        "공통 모듈은 여러 기능에서 공유하는 정책, 설정, utility에만 사용한다.",
+        "실행 진입점은 입력 파싱과 출력 변환만 담당하고 실제 판단은 application/service 계층에 위임한다.",
+        "핵심 도메인 로직은 filesystem, network, environment, process 전역 객체에 직접 의존하지 않게 한다.",
+        "파일, DB, 외부 API, subprocess 연동은 adapter 또는 infrastructure 모듈 뒤에 둔다.",
+        "권장 흐름: Entrypoint -> Application Service -> Domain/Adapter -> External System.",
+    ),
+    architecture_en=(
+        "Split modules by feature or domain responsibility and place services, adapters, and models/types under each feature folder.",
+        "Use shared modules only for policies, settings, and utilities reused by multiple features.",
+        "Runtime entrypoints should parse input and map output only, then delegate decisions to application/services.",
+        "Keep core domain logic independent from filesystem, network, environment, and process globals.",
+        "Put filesystem, database, external API, and subprocess integrations behind adapter or infrastructure modules.",
+        "Recommended flow: Entrypoint -> Application Service -> Domain/Adapter -> External System.",
+    ),
+    framework_rules_ko=(
+        "프레임워크 전역 객체와 import 시점 부수효과에 의존하지 않는 모듈을 작성한다.",
+        "TypeScript는 공개 함수와 클래스의 타입을 명시하고, JavaScript는 필요한 경우 JSDoc으로 계약을 표현한다.",
+        "비동기 오류는 호출자가 처리할 수 있는 명확한 Error 타입과 메시지로 전달한다.",
+        "표준 런타임과 기존 dependency로 충분한 문제에 불필요한 패키지를 추가하지 않는다.",
+        "순수 계산 로직과 I/O 로직을 분리해 테스트와 재사용이 가능하게 한다.",
+    ),
+    framework_rules_en=(
+        "Write modules that do not depend on framework globals or import-time side effects.",
+        "Use explicit types for public TypeScript functions and classes, and express JavaScript contracts with JSDoc when useful.",
+        "Propagate async failures with clear Error types and messages that callers can handle.",
+        "Do not add dependencies when the runtime and existing packages are sufficient.",
+        "Separate pure computation from I/O so logic stays testable and reusable.",
+    ),
+    api_rules_ko=(
+        "공개 함수, 모듈 export, CLI 옵션은 외부 계약으로 보고 이름과 반환 형식을 안정적으로 관리한다.",
+        "외부 입력은 진입점에서 검증하고 내부 model로 변환한 뒤 service 계층에 전달한다.",
+        "공개 모듈의 오류와 비동기 동작은 호출자가 예측할 수 있게 문서화한다.",
+    ),
+    api_rules_en=(
+        "Treat public functions, module exports, and CLI options as external contracts with stable names and return shapes.",
+        "Validate external input at the entrypoint and convert it into internal models before passing it to services.",
+        "Document public module errors and async behavior so callers can predict them.",
+    ),
+    test_rules_ko=(
+        "순수 로직 테스트와 filesystem/network/environment I/O 테스트를 분리한다.",
+        "외부 의존성은 명시적인 test double과 임시 디렉토리로 격리한다.",
+        "CLI 인자, module export, 비동기 오류 경로는 회귀 테스트로 고정한다.",
+    ),
+    test_rules_en=(
+        "Separate pure logic tests from filesystem, network, and environment I/O tests.",
+        "Isolate external dependencies with explicit test doubles and temporary directories.",
+        "Lock down CLI arguments, module exports, and async failure paths with regression tests.",
+    ),
+    directories=(
+        "src/<feature>/services",
+        "src/<feature>/adapters",
+        "src/<feature>/models",
+        "src/shared",
+        "tests",
+        "scripts",
+    ),
+)
+
+
 FASTAPI_PROFILE = FrameworkProfile(
     key="fastapi",
     display_name="FastAPI",
@@ -484,12 +550,12 @@ FULLSTACK_FASTAPI_REACT_PROFILE = FrameworkProfile(
     test_rules_ko=(
         "백엔드 API 테스트와 프론트엔드 service 테스트가 같은 계약을 검증하게 한다.",
         "주요 사용자 흐름은 E2E 또는 통합 테스트 대상으로 둔다.",
-        "API mock은 실제 docs/api/specification.md와 불일치하지 않게 관리한다.",
+        "API contract test는 실제 docs/api/specification.md와 불일치하지 않게 관리한다.",
     ),
     test_rules_en=(
         "Backend API tests and frontend service tests should verify the same contract.",
         "Cover major user flows with E2E or integration tests.",
-        "Keep API mocks aligned with docs/api/specification.md.",
+        "Keep API contract tests aligned with docs/api/specification.md.",
     ),
     directories=(
         "backend/app/features/<feature>/controllers",
@@ -512,6 +578,7 @@ PROFILES: dict[str, FrameworkProfile] = {
     for profile in (
         FASTAPI_PROFILE,
         PYTHON_PROFILE,
+        TYPESCRIPT_JAVASCRIPT_PROFILE,
         SPRINGBOOT_PROFILE,
         REACT_PROFILE,
         NEXTJS_PROFILE,
@@ -526,6 +593,16 @@ PROFILE_ALIASES: dict[str, str] = {
     "plain-python": "python",
     "vanilla-python": "python",
     "general-python": "python",
+    "ts": "typescript-javascript",
+    "js": "typescript-javascript",
+    "typescript": "typescript-javascript",
+    "javascript": "typescript-javascript",
+    "ts-js": "typescript-javascript",
+    "ts/js": "typescript-javascript",
+    "plain-typescript": "typescript-javascript",
+    "plain-javascript": "typescript-javascript",
+    "vanilla-typescript": "typescript-javascript",
+    "vanilla-javascript": "typescript-javascript",
     "fast-api": "fastapi",
     "spring": "springboot",
     "spring-boot": "springboot",
@@ -545,6 +622,12 @@ def supported_profile_names() -> tuple[str, ...]:
     return tuple(PROFILES)
 
 
+def supported_profile_labels() -> tuple[str, ...]:
+    """Return user-facing labels for supported profile choices."""
+
+    return tuple(f"{profile.key} ({profile.display_name})" for profile in PROFILES.values())
+
+
 def canonical_profile_name(name: str) -> str:
     """Normalize a user-provided stack name to a supported profile key."""
 

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/codex_builder/prompt.py

@@ -14,7 +14,7 @@ from codex_builder.constants import (
     DEFAULT_STACK,
 )
 from codex_builder.models import ConfigError, ProjectConfig, parse_yes_no
-from codex_builder.profiles import supported_profile_names
+from codex_builder.profiles import supported_profile_labels
 from codex_builder.validator import (
     validate_docs_level,
     validate_existing_directory,
@@ -149,8 +149,8 @@ class PromptSession:
 
     def prompt_stack(self) -> tuple[str, ...]:
         self._write("지원 프로필:")
-        for profile_name in supported_profile_names():
-            self._write(f"- {profile_name}")
+        for profile_label in supported_profile_labels():
+            self._write(f"- {profile_label}")
 
         while True:
             raw_stack = self.prompt_text("사용 스택", ",".join(DEFAULT_STACK))

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/codex_builder/template_renderer.py

@@ -85,7 +85,7 @@ class TemplateRenderer:
                     "- Do not put all logic in one file for convenience.",
                     "- Do not place business logic in controllers, route handlers, or UI components.",
                     "- Do not return persistence entities directly from public APIs.",
-                    "- Do not complete external integrations with fake implementations.",
+                "- Implement external integrations against their confirmed contracts and keep failure behavior explicit.",
                     "- Do not add core code without documenting the intent when the behavior is non-obvious.",
                 ]
             )
@@ -119,7 +119,7 @@ class TemplateRenderer:
                 "- 편의를 위해 모든 로직을 한 파일에 몰아넣지 않는다.",
                 "- controller, route handler, UI component에 비즈니스 로직을 넣지 않는다.",
                 "- persistence entity를 public API 응답으로 직접 반환하지 않는다.",
-                "- 외부 연동을 가짜 구현으로 완성한 것처럼 만들지 않는다.",
+                "- 외부 연동은 확인된 계약을 기준으로 구현하고 실패 동작을 명시한다.",
                 "- 동작이 비명시적인 핵심 코드에 의도 설명 없이 코드를 추가하지 않는다.",
             ]
         )
@@ -139,7 +139,7 @@ class TemplateRenderer:
                 lines.extend(
                     [
                         "- External API calls must go through a dedicated client/adapter layer.",
-                        "- Do not fake completed external integrations. Leave clear TODOs when credentials or contracts are missing.",
+                        "- Implement confirmed credentials, contracts, schemas, and failure handling together.",
                     ]
                 )
             if config.database:
@@ -160,7 +160,7 @@ class TemplateRenderer:
             lines.extend(
                 [
                     "- 외부 API 호출은 반드시 전용 client/adapter 계층을 통해 수행한다.",
-                    "- 계약이나 인증 정보가 없는 외부 연동은 완성된 것처럼 꾸미지 말고 명확한 TODO를 남긴다.",
+                    "- 외부 연동은 인증 정보, 계약, schema, 실패 처리를 실제 구현과 함께 관리한다.",
                 ]
             )
         if config.database:
@@ -263,7 +263,7 @@ class TemplateRenderer:
                 "[Spacing Rules]",
                 "- Keep method boundaries visually obvious. Use the repository's formatter when it enforces exact blank lines.",
                 "- When the formatter allows manual spacing, keep five blank-line units between methods.",
-                "- Inside a method, separate unrelated logic blocks with two blank-line units when the formatter allows it.",
+                "- Inside a method, separate unrelated logic blocks with three blank-line units when the formatter allows it.",
                 "- If a function signature, expression, query, JSX block, or builder chain spans multiple lines, leave a blank line before starting the next logic block.",
                 "- Do not compress validation, transformation, persistence, and response mapping into one dense block.",
                 "",
@@ -323,7 +323,7 @@ class TemplateRenderer:
                 "[공백 규칙]",
                 "- 메서드 경계는 눈으로 분명히 구분되어야 한다. 정확한 공백 수는 저장소 formatter가 강제하면 formatter를 따른다.",
                 "- formatter가 수동 공백을 허용하면 메서드 간 5칸 공백을 둔다.",
-                "- 메서드 내부의 연관 없는 로직 블록 간에는 formatter가 허용하는 범위에서 2칸 공백을 둔다.",
+                "- 메서드 내부의 연관 없는 로직 블록 간에는 formatter가 허용하는 범위에서 3칸 공백을 둔다.",
                 "- 함수 시그니처, 표현식, 쿼리, JSX block, builder chain이 여러 줄에 걸쳐 작성되면 다음 로직 블록 전에는 반드시 공백을 둔다.",
                 "- validation, transformation, persistence, response mapping을 하나의 빽빽한 블록으로 압축하지 않는다.",
                 "",
@@ -787,34 +787,16 @@ class TemplateRenderer:
                 "- Third-party HTTP APIs or SDKs",
                 "- Any system outside the current repository process",
                 "",
-                "[Rules]",
-                "- Do not implement an integration as complete unless credentials, contract, timeout behavior, and failure mapping are known.",
-                "- When the contract is missing, write only the class/method boundary and leave the body as `pass` or the language equivalent.",
-                "- Add TODO comments that state required input, expected output, upstream endpoint or SDK method, timeout, retry, and error mapping.",
+                "[Implementation]",
+                "- Implement external calls with the confirmed credentials, contract, timeout behavior, and failure mapping.",
                 "- Services call integrations through narrow methods that describe business intent.",
                 "- Convert upstream DTOs into internal DTOs before returning data to callers.",
-                "",
-                "[Python Skeleton]",
-                "```python",
-                "def request_external_job(self, request_dto: ExternalJobRequestDto) -> ExternalJobResponseDto:",
-                '    """Request a job from the external system."""',
-                "    # TODO: define upstream endpoint, request fields, response fields, timeout, retry, and failure mapping.",
-                "    pass",
-                "```",
+                "- Keep request/response schemas and integration documentation synchronized with the implementation.",
                 "",
                 "[Prohibited]",
-                "- Fake API implementations.",
-                "- Random sample data that pretends to be upstream data.",
+                "- Fabricated upstream responses or behavior that bypasses the confirmed contract.",
                 "- Calling external HTTP or SDK code directly from controllers or UI components.",
             ]
-            if not config.external_api_enabled:
-                lines.extend(
-                    [
-                        "",
-                        "[When External APIs Are Added Later]",
-                        "- Update project configuration and docs before introducing the integration.",
-                    ]
-                )
             for profile in profiles:
                 lines.extend(["", f"[{profile.display_name} Integration Notes]"])
                 lines.extend(self._bullets(self._profile_external_rules(profile, config.language)))
@@ -831,34 +813,15 @@ class TemplateRenderer:
             "- Third-party HTTP API 또는 SDK",
             "- 현재 저장소 프로세스 밖의 모든 시스템",
             "",
-            "[규칙]",
-            "- 인증 정보, 계약, timeout, 실패 매핑이 확인되지 않은 연동은 완성 구현으로 작성하지 않는다.",
-            "- 계약이 없으면 class/method 경계만 작성하고 본문은 `pass` 또는 해당 언어의 미구현 표현으로 둔다.",
-            "- TODO 주석에는 필요한 입력, 기대 출력, upstream endpoint 또는 SDK method, timeout, retry, error mapping을 명확히 적는다.",
+            "[구현 규칙]",
+            "- 확인된 인증 정보, 계약, timeout, 실패 매핑을 기준으로 외부 호출을 구현한다.",
             "- Service는 비즈니스 의도를 드러내는 좁은 메서드로 외부 연동을 호출한다.",
             "- Upstream DTO는 내부 DTO로 변환한 뒤 호출자에게 반환한다.",
-            "",
-            "[Python 뼈대]",
-            "```python",
-            "def request_external_job(self, request_dto: ExternalJobRequestDto) -> ExternalJobResponseDto:",
-            '    """외부 시스템에 작업 생성을 요청한다."""',
-            "    # TODO: upstream endpoint, request field, response field, timeout, retry, failure mapping 정의 필요.",
-            "    pass",
-            "```",
+            "- Request/Response schema와 연동 문서는 실제 구현과 함께 갱신한다.",
             "",
             "[금지]",
-            "- 외부 API fake 구현",
-            "- upstream 데이터처럼 보이는 임의 샘플 데이터 생성",
             "- controller 또는 UI component에서 외부 HTTP/SDK 직접 호출",
         ]
-        if not config.external_api_enabled:
-            lines.extend(
-                [
-                    "",
-                    "[나중에 외부 API가 추가되는 경우]",
-                    "- 연동을 도입하기 전에 프로젝트 설정과 문서를 먼저 갱신한다.",
-                ]
-            )
         for profile in profiles:
             lines.extend(["", f"[{profile.display_name} 연동 메모]"])
             lines.extend(self._bullets(self._profile_external_rules(profile, config.language)))
@@ -1606,7 +1569,7 @@ class TemplateRenderer:
                     "   - API design",
                     "   - Service logic",
                     "   - Controller/route/UI boundary work",
-                    "   - External integration skeleton",
+                    "   - External integration",
                     "   - Refactoring",
                     "   - Documentation",
                     "5. Apply the `.codex` rules that match the task type before editing files.",
@@ -1620,7 +1583,7 @@ class TemplateRenderer:
                     "- Do not invent behavior that is not defined by the request or reference documents.",
                     "- Do not treat `.codex/ref_docs` as generated project documentation; it is a user-managed reference space.",
                     "- Keep project specs in root `docs/`.",
-                    "- For external integrations without a confirmed contract, write only class/method boundaries and TODOs; leave the body unimplemented.",
+                    "- For external integrations, implement the confirmed contract through a dedicated client/adapter and keep its documentation synchronized.",
                     "- After code changes, update required documentation in the same task.",
                     "",
                     "Response behavior:",
@@ -1659,7 +1622,7 @@ class TemplateRenderer:
                 "   - API 설계",
                 "   - 서비스 로직 작성",
                 "   - 컨트롤러/라우트/UI 경계 작업",
-                "   - 외부 연동 메서드 뼈대 작성",
+                "   - 외부 연동 구현",
                 "   - 리팩토링",
                 "   - 문서화",
                 "5. 판단한 작업 유형에 맞는 `.codex` 규칙을 우선 적용하라.",
@@ -1674,7 +1637,7 @@ class TemplateRenderer:
                 "- 요청이나 참고 문서에 없는 기능을 임의로 추가하지 않는다.",
                 "- `.codex/ref_docs`를 생성된 프로젝트 명세 위치로 취급하지 않는다. 이 위치는 사용자 관리 참고자료 공간이다.",
                 "- 프로젝트 명세는 프로젝트 루트의 `docs/`에 유지한다.",
-                "- 계약이 확인되지 않은 외부 연동은 class/method 경계와 TODO만 작성하고 본문은 미구현으로 둔다.",
+                "- 외부 연동은 확인된 계약을 전용 client/adapter로 구현하고 관련 문서를 실제 동작과 함께 갱신한다.",
                 "- 코드 수정 후 필요한 문서도 같은 작업 안에서 함께 수정한다.",
                 "",
                 "응답 방식도 아래를 따라라.",
@@ -1853,7 +1816,7 @@ class TemplateRenderer:
                 "fullstack-fastapi-react": (
                     "Backend owns private upstream integrations; frontend calls backend services only.",
                     "Document any backend-to-upstream mapping in docs/api/specification.md when it affects public behavior.",
-                    "Keep frontend mocks aligned with backend API contracts.",
+                    "Keep frontend API contract tests aligned with backend API contracts.",
                 ),
             }
             return rules.get(profile.key, ("Keep external integrations behind framework-appropriate adapter boundaries.",))
@@ -1892,7 +1855,7 @@ class TemplateRenderer:
             "fullstack-fastapi-react": (
                 "Private upstream integration은 backend가 소유하고 frontend는 backend service만 호출한다.",
                 "공개 동작에 영향을 주는 backend-to-upstream mapping은 docs/api/specification.md에 문서화한다.",
-                "Frontend mock은 backend API contract와 불일치하지 않게 관리한다.",
+                "Frontend API contract tests는 backend API contract와 불일치하지 않게 관리한다.",
             ),
         }
         return rules.get(profile.key, ("외부 연동은 framework에 맞는 adapter 경계 뒤에 둔다.",))

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/codex_rule_maker.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-rule-maker
-Version: 0.3.0
+Version: 0.4.0
 Summary: CLI tool that generates a .codex folder with AI developer rules and project reference documents.
 Author: codex-rule-maker
 Project-URL: Homepage, https://github.com/Sharon77770/codex_rule_maker
@@ -30,6 +30,8 @@ Dynamic: license-file
 
 # codex-rule-maker
 
+현재 버전: `0.4.0`
+
 `codex-rule-maker`는 프로젝트 루트에 `.codex` 규칙 폴더와 `docs/` 프로젝트 문서 템플릿을 자동 구성하는 Python CLI 도구입니다. 사용자가 프로젝트 이름, 설명, 스택, DB, 인증 여부, 외부 API 여부, 문서화 수준, 문서 언어를 입력하면 Codex가 작업 전에 읽을 개발 규칙과 프로젝트 문서 구조를 생성합니다.
 
 ## 설치
@@ -225,7 +227,8 @@ docs/
 ## 지원 프레임워크 프로필
 
 - `fastapi`: 기능 폴더 하위 controller/service/repository/schema/entity 분리
-- `python`: 기능/도메인 폴더 하위 service/adapter/model/CLI 경계 분리
+- `python`: 프레임워크 없는 Python 프로젝트의 기능/도메인 폴더 하위 service/adapter/model/CLI 경계 분리
+- `typescript-javascript`: 프레임워크 없는 TypeScript/JavaScript 프로젝트의 기능/도메인 폴더 하위 service/adapter/model 경계 분리
 - `springboot`: 기능 package 하위 controller/service/repository/entity/dto 분리
 - `react`: 기능 폴더 하위 page/component/hook/service/store 분리
 - `nextjs`: App Router 유지, 기능 폴더 하위 component/service/repository/type 분리
@@ -237,6 +240,8 @@ docs/
 ```bash
 codex-init --stack fastapi,react
 codex-init --stack python
+codex-init --stack typescript
+codex-init --stack javascript
 codex-init --stack fullstack-fastapi-react
 codex-init --stack nextjs
 ```
@@ -247,7 +252,7 @@ codex-init --stack nextjs
 - `--language en`을 사용하면 영어 문서를 생성합니다.
 - `--docs strict`는 코드 변경 후 문서 업데이트 필수 규칙을 포함합니다.
 - `--auth yes`는 인증/권한 규칙을 포함합니다.
-- `--external-api yes`는 외부 연동 계층 분리 규칙을 포함합니다.
+- `--external-api yes`는 확인된 계약을 기준으로 실제 외부 연동을 구현하기 위한 client/adapter 및 계약 문서 규칙을 포함합니다.
 - `--db mysql`처럼 DB를 지정하면 DB, Repository, Schema 관련 규칙을 포함합니다.
 - 프로젝트 명세 템플릿은 `.codex/ref_docs`가 아니라 `docs/architecture`, `docs/api`, `docs/database`에 생성됩니다.
 

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codex-rule-maker"
-version = "0.3.0"
+version = "0.4.0"
 description = "CLI tool that generates a .codex folder with AI developer rules and project reference documents."
 readme = "README.md"
 requires-python = ">=3.9"

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/tests/test_builder.py

@@ -72,6 +72,46 @@ def test_python_profile_generation(tmp_path):
     assert "CLI 입력은 domain/service logic에 전달하기 전에 별도 input model로 변환한다" in domain_rules
 
 
+def test_typescript_javascript_profile_generation(tmp_path):
+    config = ProjectConfig(project_name="sample-script", stack=("typescript",))
+
+    CodexBuilder().build(config, target_dir=tmp_path)
+
+    architecture_rules = (tmp_path / ".codex" / "ai_rule_developer" / "ARCHITECTURE_RULES.md").read_text(encoding="utf-8")
+    service_rules = (tmp_path / ".codex" / "ai_rule_developer" / "SERVICE_LAYER_RULES.md").read_text(encoding="utf-8")
+
+    assert "TypeScript/JavaScript" in service_rules
+    assert "Entrypoint -> Application Service -> Domain/Adapter -> External System" in architecture_rules
+    assert "프레임워크 전역 객체" in service_rules
+
+
+def test_spacing_rules_use_three_and_five_units(tmp_path):
+    config = ProjectConfig(project_name="sample-spacing")
+
+    CodexBuilder().build(config, target_dir=tmp_path)
+
+    code_style = (tmp_path / ".codex" / "ai_rule_developer" / "CODE_STYLE_RULES.md").read_text(encoding="utf-8")
+
+    assert "메서드 간 5칸 공백" in code_style
+    assert "로직 블록 간에는 formatter가 허용하는 범위에서 3칸 공백" in code_style
+    assert "2칸 공백" not in code_style
+
+
+def test_external_integration_rules_do_not_defer_to_mock_or_skeleton(tmp_path):
+    config = ProjectConfig(project_name="sample-integration", external_api_enabled=True)
+
+    CodexBuilder().build(config, target_dir=tmp_path)
+
+    integration_rules = (tmp_path / ".codex" / "ai_rule_developer" / "EXTERNAL_INTEGRATION_RULES.md").read_text(encoding="utf-8").lower()
+    start_prompt = (tmp_path / ".codex" / "codex_start_prompt.txt").read_text(encoding="utf-8").lower()
+
+    assert "mock" not in integration_rules
+    assert "skeleton" not in integration_rules
+    assert "pass" not in integration_rules
+    assert "외부 연동 구현" in start_prompt
+    assert "external integration skeleton" not in start_prompt
+
+
 def test_react_profile_generation(tmp_path):
     config = ProjectConfig(project_name="sample-web", stack=("react",))
 

{codex_rule_maker-0.3.0 → codex_rule_maker-0.4.0}/tests/test_cli.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 from typing import Optional
 
-from codex_builder.cli import main
+from codex_builder.cli import build_parser, main
 
 
 def test_cli_generates_with_options_only(tmp_path):
@@ -32,6 +32,14 @@ def test_cli_generates_with_options_only(tmp_path):
     assert (tmp_path / "docs" / "api" / "specification.md").exists()
 
 
+def test_cli_profile_choices_include_plain_python_and_typescript_javascript():
+    help_text = build_parser().format_help()
+
+    assert "python (Python)" in help_text
+    assert "typescript-javascript" in help_text
+    assert "TypeScript/JavaScript" in help_text
+
+
 def test_cli_generates_python_profile(tmp_path):
     result = main(
         [