DefStream 0.1.12__tar.gz → 0.1.14__tar.gz

defstream-0.1.14/.github/ISSUE_TEMPLATE/01.feature.yml

@@ -0,0 +1,39 @@
+name: 기능 제안
+description: 추가하거나 개선할 기능을 제안합니다.
+labels:
+  - feature
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        해결하려는 문제와 제안하는 사용 경험을 중심으로 작성해 주세요.
+  - type: textarea
+    id: problem
+    attributes:
+      label: 해결하려는 문제
+      description: 현재 어떤 불편이나 제약이 있는지 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 제안하는 해결 방법
+      description: 원하는 기능과 기대하는 동작을 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 고려한 대안
+      description: 고려한 다른 방법이나 우회 방법이 있다면 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: additional
+    attributes:
+      label: 추가 정보
+      description: 예제, 참고 자료 등 제안의 맥락을 이해하는 데 도움이 되는 정보를 적어 주세요.
+    validations:
+      required: false

defstream-0.1.14/.github/ISSUE_TEMPLATE/02.bug.yml

@@ -0,0 +1,64 @@
+name: 버그/오류 제보
+description: 예상과 다르게 동작하거나 오류가 발생하는 문제를 제보합니다.
+labels:
+  - bug
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        재현 가능한 버그를 제보해 주세요. 로그나 설정을 첨부할 때 토큰, 비밀번호,
+        개인정보 등 민감한 정보는 반드시 삭제해 주세요.
+  - type: input
+    id: version
+    attributes:
+      label: 버전
+      description: 사용 중인 버전 또는 커밋을 입력해 주세요.
+      placeholder: 예) 0.1.12
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: 기대한 동작
+      description: 어떤 결과를 기대했는지 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: 실제 동작
+      description: 실제로 발생한 결과를 설명해 주세요. 오류가 표시되면 메시지도 포함해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 재현 방법
+      description: 문제를 재현하는 단계나 최소 코드 예제를 작성해 주세요.
+      placeholder: |
+        1. 다음 설정으로 Worker를 시작합니다.
+        2. 특정 메시지를 전달합니다.
+        3. 오류가 발생합니다.
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: 실행 환경
+      description: Python 버전, 운영체제, 브로커 및 관련 어댑터 버전을 입력해 주세요.
+      placeholder: |
+        - Python:
+        - 운영체제:
+        - 브로커:
+        - 어댑터:
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: 추가 정보
+      description: 관련 로그나 스크린샷 등 문제 파악에 도움이 되는 정보를 적어 주세요.
+    validations:
+      required: false

defstream-0.1.14/.github/ISSUE_TEMPLATE/03.fix.yml

@@ -0,0 +1,57 @@
+name: 변경 제안
+description: 일반 변경이나 핫픽스의 목적과 범위를 정리합니다.
+labels:
+  - fix
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        일반 변경이나 긴급 수정이 필요한 핫픽스를 제안할 때 사용해 주세요.
+        재현 가능한 기존 결함은 버그/오류 제보 양식을 이용해 주세요.
+  - type: dropdown
+    id: change_type
+    attributes:
+      label: 변경 유형
+      description: 제안하는 변경의 성격을 선택해 주세요.
+      options:
+        - 일반 변경
+        - 핫픽스
+    validations:
+      required: true
+  - type: textarea
+    id: purpose
+    attributes:
+      label: 변경 목적
+      description: 왜 이 변경이 필요한지, 해결하려는 불편이나 상황을 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: proposed_changes
+    attributes:
+      label: 제안하는 변경 내용
+      description: 무엇을 어떻게 바꾸면 좋을지 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: 영향 범위
+      description: 영향을 받는 기능, 사용자, 호환성 또는 설정을 알고 있다면 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: hotfix_context
+    attributes:
+      label: 긴급 수정 정보
+      description: 핫픽스인 경우 긴급한 이유, 영향받는 버전 및 임시 대응 방법을 적어 주세요.
+    validations:
+      required: false
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: 완료 기준
+      description: 변경이 완료되었다고 판단할 수 있는 조건이나 검증 방법을 적어 주세요.
+    validations:
+      required: false

defstream-0.1.14/.github/ISSUE_TEMPLATE/04.task.yml

@@ -0,0 +1,40 @@
+name: 작업 제안
+description: 리소스 변경, 문서화 등 소스 코드 변경이 아닌 작업을 정리합니다.
+labels:
+  - task
+projects:
+  - yong5eon/7
+body:
+  - type: markdown
+    attributes:
+      value: >
+        리소스 변경, 문서 작성·정리 등 소스 코드를 변경하지 않는 작업에 사용해 주세요.
+        기능 추가, 버그 제보 또는 소스 코드 변경은 해당 이슈 양식을 이용해 주세요.
+  - type: textarea
+    id: purpose
+    attributes:
+      label: 작업 목적
+      description: 이 작업이 필요한 이유와 기대하는 효과를 설명해 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: scope
+    attributes:
+      label: 작업 내용 및 대상
+      description: 수행할 작업과 대상 리소스, 문서 또는 경로를 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: 완료 기준
+      description: 작업이 완료되었다고 판단할 수 있는 결과물이나 확인 방법을 적어 주세요.
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: 관련 자료 및 주의사항
+      description: 참고 링크, 관련 이슈, 사전 준비나 주의사항이 있다면 적어 주세요.
+    validations:
+      required: false

defstream-0.1.14/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

defstream-0.1.14/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## 변경 내용
+
+<!-- 무엇을 왜 변경했는지 간단히 요약해 주세요. -->
+
+## 변경 유형
+
+- [ ] 버그 수정 및 일반 변경, 핫픽스 처리
+- [ ] 기능 추가
+- [ ] 호환성에 영향을 주는 변경
+- [ ] 문서 또는 예제 변경
+- [ ] 기타
+
+## 검증
+
+<!-- 실행한 테스트와 결과를 작성해 주세요. 테스트를 실행하지 않았다면 사유를 적어 주세요. -->
+
+- [ ] 관련 테스트를 실행했습니다.
+- [ ] 문서와 예제를 확인했습니다.
+
+## 확인 사항
+
+- [ ] 변경 범위가 요청 사항에 한정되어 있습니다.
+- [ ] 공개 API나 기존 동작에 영향을 주는 경우 변경 내용과 마이그레이션 방법을 설명했습니다.
+- [ ] 민감 정보나 불필요한 디버깅 코드를 포함하지 않았습니다.

{defstream-0.1.12 → defstream-0.1.14}/.github/workflows/ci.yml

@@ -33,6 +33,7 @@ jobs:
       core_ref: ${{ steps.refs.outputs.core_ref }}
       rabbitmq_ref: ${{ steps.refs.outputs.rabbitmq_ref }}
       redis_ref: ${{ steps.refs.outputs.redis_ref }}
+      test_required: ${{ steps.test_paths.outputs.required }}
     steps:
       - uses: actions/checkout@v7
         with:
@@ -42,6 +43,28 @@ jobs:
         uses: actions/setup-python@v7
         with:
           python-version: '3.13'
+      - name: Detect test-relevant changes
+        id: test_paths
+        run: |
+          python - <<'PY'
+          from json import loads
+          from os import environ
+          from pathlib import Path
+          from subprocess import check_output
+
+          required = True
+          if environ['GITHUB_EVENT_NAME'] == 'pull_request':
+              event = loads(Path(environ['GITHUB_EVENT_PATH']).read_text(encoding='utf-8'))
+              base = event['pull_request']['base']['sha']
+              changed = check_output([
+                  'git', 'diff', '--name-only', '--no-renames', '-z',
+                  f'{base}...{environ["GITHUB_SHA"]}', '--', 'samples/', 'src/', 'tests/', 'setup.py',
+              ])
+              required = bool(changed)
+          with Path(environ['GITHUB_OUTPUT']).open('a', encoding='utf-8') as output:
+              output.write(f'required={str(required).lower()}\n')
+          print(f'Test-relevant changes: {required}')
+          PY
       - name: Check complete push range and plan version
         id: changes
         env:
@@ -224,6 +247,7 @@ jobs:
   test:
     name: Test Python ${{ matrix.python }}
     needs: changes
+    if: needs.changes.outputs.test_required == 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 25
     strategy:
@@ -384,8 +408,12 @@ jobs:
       - name: Test installed package
         run: |
           cd "$RUNNER_TEMP"
+          test_directory=test
+          if [ "$PROJECT" = "DefStream" ]; then
+            test_directory=tests
+          fi
           "$RUNNER_TEMP/installed/bin/python" -m unittest discover \
-            -s "$GITHUB_WORKSPACE/packages/$PROJECT/test" -p 'test_*.py' -v
+            -s "$GITHUB_WORKSPACE/packages/$PROJECT/$test_directory" -p 'test_*.py' -v
 
       - name: Set up Node for core UI tests
         if: env.PROJECT == 'DefStream'
@@ -395,7 +423,7 @@ jobs:
 
       - name: Test core UI
         if: env.PROJECT == 'DefStream'
-        run: node --test packages/DefStream/test/test_dashboard_ui.cjs
+        run: node --test packages/DefStream/tests/test_dashboard_ui.cjs
 
       - name: Preserve verified release distributions
         if: needs.changes.outputs.release == 'true' && matrix.python == '3.13'

{defstream-0.1.12 → defstream-0.1.14}/.gitignore

@@ -53,10 +53,8 @@ tmp/
 .git/
 
 # GitHub specific files
-.github/
-!/.github/
-/.github/*
-!/.github/workflows/
+.github/instructions
+.github/instructions/
 
 # GitLab specific files
 .gitlab/

{defstream-0.1.12 → defstream-0.1.14}/DefStream.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.12
+Version: 0.1.14
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -109,8 +109,8 @@ ProcessPool은 `spawn` 자식 프로세스를 사용하므로 부모의 핸들
 자식도 로그를 출력하려면 import 가능한 `PoolSetup` 구현에서 같은 설정을 적용하고
 `ProcessPool(..., setups=...)`로 전달하세요. 자식 초기화 훅이 실행되기 전의 DEBUG·INFO는
 그 설정으로 수신할 수 없습니다.
-[RabbitMQ 작업 예제의 LoggingSetup](./sample/Worker/RabbitMQ/Tasks.py)과
-[부모·자식 설정 예제](./sample/Worker/RabbitMQ/Worker.py)를 참고하세요.
+[RabbitMQ 작업 예제의 LoggingSetup](./samples/Worker/RabbitMQ/Tasks.py)과
+[부모·자식 설정 예제](./samples/Worker/RabbitMQ/Worker.py)를 참고하세요.
 기존 애플리케이션에서는 이미 설정한 핸들러를 반복 추가하지 않도록 초기화 위치를 관리해야 합니다.
 
 ## 설치
@@ -671,9 +671,9 @@ Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용
 
 ## 예제와 라이선스
 
-- [브로커 없이 실행하는 Worker 예제](./sample/Worker/Sample.py)
-- [RabbitMQ Worker·RPC 클라이언트 예제](./sample/Worker/RabbitMQ)
-- [Redis Worker 예제](./sample/Worker/Redis/Sample.py)
+- [브로커 없이 실행하는 Worker 예제](./samples/Worker/Sample.py)
+- [RabbitMQ Worker·RPC 클라이언트 예제](./samples/Worker/RabbitMQ)
+- [Redis Worker 예제](./samples/Worker/Redis/Sample.py)
 - [릴리즈와 변경 내역](https://github.com/yong5eon/DefStream/releases)
 
 GNU GPL v3 라이선스를 사용합니다. 자세한 조건은 [LICENSE](./LICENSE)를 확인하세요.

{defstream-0.1.12 → defstream-0.1.14}/DefStream.egg-info/SOURCES.txt

@@ -3,12 +3,22 @@ LICENSE
 README.en.md
 README.md
 setup.py
+.github/PULL_REQUEST_TEMPLATE.md
+.github/ISSUE_TEMPLATE/01.feature.yml
+.github/ISSUE_TEMPLATE/02.bug.yml
+.github/ISSUE_TEMPLATE/03.fix.yml
+.github/ISSUE_TEMPLATE/04.task.yml
+.github/ISSUE_TEMPLATE/config.yml
 .github/workflows/ci.yml
 DefStream.egg-info/PKG-INFO
 DefStream.egg-info/SOURCES.txt
 DefStream.egg-info/dependency_links.txt
 DefStream.egg-info/requires.txt
 DefStream.egg-info/top_level.txt
+issues/bug/16/IMPLEMENTS.md
+issues/bug/16/ISSUE.md
+issues/bug/16/README.md
+issues/bug/16/REQUIREMENTS.md
 issues/feature/1/IMPLEMENTS.md
 issues/feature/1/README.md
 issues/feature/1/REQUIREMENTS.md
@@ -22,6 +32,10 @@ issues/fix/10/IMPLEMENTS.md
 issues/fix/10/README.md
 issues/fix/10/REQUIREMENTS.md
 issues/fix/13/README.md
+issues/fix/21/IMPLEMENTS.md
+issues/fix/21/ISSUE.md
+issues/fix/21/README.md
+issues/fix/21/REQUIREMENTS.md
 issues/fix/3/IMPLEMENTS.md
 issues/fix/3/README.md
 issues/fix/3/REQUIREMENTS.md
@@ -29,12 +43,15 @@ issues/fix/3/ci.refs.json
 issues/fix/6/IMPLEMENTS.md
 issues/fix/6/README.md
 issues/fix/6/REQUIREMENTS.md
-sample/Broker/Sample.py
-sample/Worker/Sample.py
-sample/Worker/RabbitMQ/Client.py
-sample/Worker/RabbitMQ/Tasks.py
-sample/Worker/RabbitMQ/Worker.py
-sample/Worker/Redis/Sample.py
+issues/task/18/IMPLEMENTS.md
+issues/task/18/README.md
+issues/task/18/REQUIREMENTS.md
+samples/Broker/Sample.py
+samples/Worker/Sample.py
+samples/Worker/RabbitMQ/Client.py
+samples/Worker/RabbitMQ/Tasks.py
+samples/Worker/RabbitMQ/Worker.py
+samples/Worker/Redis/Sample.py
 src/__init__.py
 src/Broker/Configuration.py
 src/Broker/Connection.py
@@ -86,21 +103,22 @@ src/Worker/Specification.py
 src/Worker/Startup.py
 src/Worker/Worker.py
 src/Worker/__init__.py
-test/test_dashboard.py
-test/test_dashboard_ui.cjs
-test/test_descriptor.py
-test/test_inspector.py
-test/test_inspector_console.py
-test/test_inspector_logging.py
-test/test_lifecycle_hooks.py
-test/test_logging.py
-test/test_pool_callbacks.py
-test/test_process_signals.py
-test/test_protocol_contracts.py
-test/test_release_workflow.py
-test/test_runner_hooks.py
-test/test_specifications.py
-test/test_task_messages.py
-test/test_task_priorities.py
-test/test_worker.py
-test/test_worker_startup.py
+tests/test_dashboard.py
+tests/test_dashboard_ui.cjs
+tests/test_descriptor.py
+tests/test_inspector.py
+tests/test_inspector_console.py
+tests/test_inspector_logging.py
+tests/test_lifecycle_hooks.py
+tests/test_logging.py
+tests/test_pool_callbacks.py
+tests/test_process_signals.py
+tests/test_protocol_contracts.py
+tests/test_release_workflow.py
+tests/test_runner_hooks.py
+tests/test_specifications.py
+tests/test_task_messages.py
+tests/test_task_priorities.py
+tests/test_validator_patterns.py
+tests/test_worker.py
+tests/test_worker_startup.py

{defstream-0.1.12 → defstream-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: DefStream
-Version: 0.1.12
+Version: 0.1.14
 Summary: Synchronous message processing with pluggable broker adapters
 Home-page: https://github.com/yong5eon/DefStream
 Author: Heo Yongseon
@@ -109,8 +109,8 @@ ProcessPool은 `spawn` 자식 프로세스를 사용하므로 부모의 핸들
 자식도 로그를 출력하려면 import 가능한 `PoolSetup` 구현에서 같은 설정을 적용하고
 `ProcessPool(..., setups=...)`로 전달하세요. 자식 초기화 훅이 실행되기 전의 DEBUG·INFO는
 그 설정으로 수신할 수 없습니다.
-[RabbitMQ 작업 예제의 LoggingSetup](./sample/Worker/RabbitMQ/Tasks.py)과
-[부모·자식 설정 예제](./sample/Worker/RabbitMQ/Worker.py)를 참고하세요.
+[RabbitMQ 작업 예제의 LoggingSetup](./samples/Worker/RabbitMQ/Tasks.py)과
+[부모·자식 설정 예제](./samples/Worker/RabbitMQ/Worker.py)를 참고하세요.
 기존 애플리케이션에서는 이미 설정한 핸들러를 반복 추가하지 않도록 초기화 위치를 관리해야 합니다.
 
 ## 설치
@@ -671,9 +671,9 @@ Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용
 
 ## 예제와 라이선스
 
-- [브로커 없이 실행하는 Worker 예제](./sample/Worker/Sample.py)
-- [RabbitMQ Worker·RPC 클라이언트 예제](./sample/Worker/RabbitMQ)
-- [Redis Worker 예제](./sample/Worker/Redis/Sample.py)
+- [브로커 없이 실행하는 Worker 예제](./samples/Worker/Sample.py)
+- [RabbitMQ Worker·RPC 클라이언트 예제](./samples/Worker/RabbitMQ)
+- [Redis Worker 예제](./samples/Worker/Redis/Sample.py)
 - [릴리즈와 변경 내역](https://github.com/yong5eon/DefStream/releases)
 
 GNU GPL v3 라이선스를 사용합니다. 자세한 조건은 [LICENSE](./LICENSE)를 확인하세요.

{defstream-0.1.12 → defstream-0.1.14}/README.en.md

@@ -27,15 +27,66 @@ Configure execution, acknowledgements, failure policies, and monitoring without
 - [Lifecycle hooks](#lifecycle-hooks)
 - [Request/reply contracts and validation](#requestreply-contracts-and-validation)
 - [Health checks and task console](#health-checks-and-task-console)
+- [Logging](#logging)
 - [Broker selection and operational considerations](#broker-selection-and-operational-considerations)
 - [Examples and license](#examples-and-license)
 
-## 로깅 지원
+## Logging
 
-클래스별 표준 로거와 사용자 주도 핸들러 설정을 지원합니다.
-샘플은 `Sample` 및 `DefStream` 계층만 출력하며, ProcessPool 자식은 별도 setup 훅으로
-출력을 설정합니다. Worker의 시작 배너는 유지됩니다.
-로거 이름, 선택 수신, 예외 메시지 주의사항과 프로세스 설정은 [로깅 안내](./README.md#로깅)를 참고하세요.
+DefStream records messages through standard `logging` without configuring handlers,
+formatters, or levels. Select the sources your application needs. The samples
+output only the `Sample` and `DefStream` logger hierarchies, replacing their
+`print()` calls with logging. The Worker's existing startup banner is still
+printed regardless of logging configuration.
+
+```python
+from logging import DEBUG, Filter, Formatter, StreamHandler, getLogger
+
+sources = (Filter('Sample'), Filter('DefStream'))
+handler = StreamHandler()
+handler.setFormatter(Formatter(
+  '%(asctime)s %(processName)s %(name)s %(levelname)s %(message)s'
+))
+handler.addFilter(lambda record: any(source.filter(record) for source in sources))
+root = getLogger()
+root.setLevel(DEBUG)
+root.addHandler(handler)
+
+logger = getLogger('Sample')
+logger.info('Application started')
+```
+
+Apply filters to the **handler**, not the root logger. `Filter('DefStream')`
+includes `DefStream` and names below `DefStream.`, but not `DefStreamExtra`.
+This configuration is an example for a standalone application; it does not change
+output from other handlers already installed. To receive only broker logs, select
+`DefStream.Broker.Implements.RabbitMQ` or `DefStream.Broker.Implements.Redis`
+instead of `DefStream`.
+
+- The class member `logger` uses `DefStream.Worker`, `DefStream.Run`,
+  `DefStream.Executor`, `DefStream.Pool`, `DefStream.ThreadPool`, and
+  `DefStream.ProcessPool`.
+- Shared Pool methods also use the concrete pool's logger member. User subclasses
+  inherit the default name and can explicitly override `logger`.
+- Inspector, Server, and RequestHandler share `DefStream.Inspector`.
+  HTTP request receipt is DEBUG; response status and transmission results are INFO.
+  Extension-specific logs use `DefStream.Inspector.Extensions.<extension name>`.
+- Normal per-message processing is DEBUG, lifecycle events are INFO, events
+  requiring attention are WARNING, and processing failures are ERROR.
+  Bodies, results, and credentials are excluded from the default log context.
+- Without any handlers, Python's `lastResort` may write WARNING and higher to
+  stderr. Do not put sensitive values in user exception messages: failure
+  tracebacks include those messages.
+
+ProcessPool uses `spawn` child processes, so parent handlers are not automatically
+inherited. To receive child logs, apply the same configuration in an importable
+`PoolSetup` implementation and pass it through `ProcessPool(..., setups=...)`.
+That configuration cannot capture DEBUG and INFO logs emitted before the child
+setup hook runs. See
+[LoggingSetup in the RabbitMQ task example](./samples/Worker/RabbitMQ/Tasks.py)
+and the [parent/child configuration example](./samples/Worker/RabbitMQ/Worker.py).
+In existing applications, choose the initialization location carefully to avoid
+adding the same handlers repeatedly.
 
 ## Installation
 
@@ -610,9 +661,9 @@ For a class-based factory, you can inherit `BrokerFactory` and implement `__call
 
 ## Examples and license
 
-- [Worker without an external broker](./sample/Worker/Sample.py)
-- [RabbitMQ Worker and RPC client](./sample/Worker/RabbitMQ)
-- [Redis Worker](./sample/Worker/Redis/Sample.py)
+- [Worker without an external broker](./samples/Worker/Sample.py)
+- [RabbitMQ Worker and RPC client](./samples/Worker/RabbitMQ)
+- [Redis Worker](./samples/Worker/Redis/Sample.py)
 - [Releases and change history](https://github.com/yong5eon/DefStream/releases)
 
 Licensed under GNU GPL v3. See [LICENSE](./LICENSE) for the terms.

{defstream-0.1.12 → defstream-0.1.14}/README.md

@@ -76,8 +76,8 @@ ProcessPool은 `spawn` 자식 프로세스를 사용하므로 부모의 핸들
 자식도 로그를 출력하려면 import 가능한 `PoolSetup` 구현에서 같은 설정을 적용하고
 `ProcessPool(..., setups=...)`로 전달하세요. 자식 초기화 훅이 실행되기 전의 DEBUG·INFO는
 그 설정으로 수신할 수 없습니다.
-[RabbitMQ 작업 예제의 LoggingSetup](./sample/Worker/RabbitMQ/Tasks.py)과
-[부모·자식 설정 예제](./sample/Worker/RabbitMQ/Worker.py)를 참고하세요.
+[RabbitMQ 작업 예제의 LoggingSetup](./samples/Worker/RabbitMQ/Tasks.py)과
+[부모·자식 설정 예제](./samples/Worker/RabbitMQ/Worker.py)를 참고하세요.
 기존 애플리케이션에서는 이미 설정한 핸들러를 반복 추가하지 않도록 초기화 위치를 관리해야 합니다.
 
 ## 설치
@@ -638,9 +638,9 @@ Console의 `broker` 인자는 `DefStream.Broker.BrokerFactory` 계약을 사용
 
 ## 예제와 라이선스
 
-- [브로커 없이 실행하는 Worker 예제](./sample/Worker/Sample.py)
-- [RabbitMQ Worker·RPC 클라이언트 예제](./sample/Worker/RabbitMQ)
-- [Redis Worker 예제](./sample/Worker/Redis/Sample.py)
+- [브로커 없이 실행하는 Worker 예제](./samples/Worker/Sample.py)
+- [RabbitMQ Worker·RPC 클라이언트 예제](./samples/Worker/RabbitMQ)
+- [Redis Worker 예제](./samples/Worker/Redis/Sample.py)
 - [릴리즈와 변경 내역](https://github.com/yong5eon/DefStream/releases)
 
 GNU GPL v3 라이선스를 사용합니다. 자세한 조건은 [LICENSE](./LICENSE)를 확인하세요.

defstream-0.1.14/issues/bug/16/IMPLEMENTS.md

@@ -0,0 +1,32 @@
+# Inspector Console 사용자 지정 Task 이름 버그 수정 기록
+
+## 구현 개요
+
+[요구사항 명세서](./REQUIREMENTS.md)에 따라 Inspector Console이 작업 목록과
+동일한 작업 ID를 사용해 등록된 Task를 찾고, 잘못된 요청의 구체적인 원인을
+경고 로그에서 확인할 수 있도록 수정했다.
+
+## 주요 변경
+
+- `Console.execute()`의 Task 검색과 중복 검사를 모두 `task.__name__`에서
+  `task.name` 비교로 변경했다. 작업 이름을 사용자 지정한 경우에도
+  Specifications 문서와 Console UI가 전달하는 ID로 올바른 Task를 식별한다.
+- 잘못된 입력을 거부하는 경고 로그에 예외 종류와 예외 메시지를 함께 기록한다.
+- `test_inspector_console.py`에 사용자 지정 ID의 발행 성공, 중복 ID 거부,
+  미등록 ID의 오류 로그 내용을 확인하는 회귀 테스트를 추가했다.
+- RabbitMQ·Redis 실서버 테스트의 요청 ID도 실제 등록된 하위 Task의 `Live.name`을
+  사용하도록 했다. 클래스의 `__name__`(`Live`)와 Worker에 등록하는 유효 작업
+  이름은 같다고 가정할 수 없으며, 이전의 하드코딩은 요청을 400으로 거부하게 했다.
+
+## 검증
+
+DefStream 테스트 디렉터리에서 Python 3.12.10으로 다음 명령을 실행했다.
+
+```powershell
+$env:PYTHONIOENCODING = 'utf-8'
+..\..\.venv\Scripts\python.exe -m unittest test_inspector_console test_inspector_logging
+```
+
+Inspector Console 및 로깅 관련 테스트 28개가 통과했고, 선택 통합 테스트 2개는
+건너뛰었다. 변경된 두 Python 파일의 `compile()` 문법 검사와
+`git diff --check`도 통과했다. 브로커 실서버 통합 검증은 수행하지 않았다.

defstream-0.1.14/issues/bug/16/ISSUE.md

@@ -0,0 +1,19 @@
+# Inspector Console에서 사용자 지정 Task 이름으로 요청 시 큐 발행 전에 거부됨
+
+## 버전
+
+0.1.12
+
+## 내용
+
+Inspector Console이 Task 목록에 표시하는 이름과 실제 Task를 찾는 기준이 다릅니다.
+
+Specifications.document()은 task.name을 작업 ID로 사용합니다. Console UI는 이 ID를 선택해 요청을 보내지만, Console.execute()는 등록된 작업을 찾을 때 task.__name__과 요청의 task 값을 비교합니다.
+
+예를 들어 Orbis Split은 Split.name이 ETL.OBS.Split이고 Split.__name__은 Split입니다. 따라서 UI에서 선택한 작업 ID ETL.OBS.Split과 Console의 비교 값 Split이 일치하지 않아 Unknown registered task 오류가 발생합니다. 이 검사는 브로커에 연결하거나 메시지를 발행하기 전에 수행되므로 요청은 큐에 도달하지 않습니다.
+
+또한 Console 경고 로그에는 구체적인 오류 메시지 대신 예외 종류만 기록되어 원인을 파악하기 어렵습니다.
+
+기대 동작: Console이 Task 목록을 만들 때와 동일하게 task.name을 기준으로 작업을 찾아야 합니다. 중복 여부 검사도 같은 기준을 사용해야 합니다.
+
+실제 동작: Console이 task.__name__을 기준으로 작업을 찾아 사용자 지정 이름을 사용하는 Task를 거부합니다.

defstream-0.1.14/issues/bug/16/README.md

@@ -0,0 +1,12 @@
+# Inspector Console 사용자 지정 Task 이름 처리
+
+Inspector Console이 작업 목록에 표시한 ID로 Task를 찾도록 수정했습니다.
+따라서 `ETL.OBS.Split`처럼 클래스 이름과 다른 사용자 지정 Task 이름으로도
+요청을 보낼 수 있습니다. 동일한 작업 ID가 중복 등록된 경우에는 모호한 작업
+실행을 막기 위해 요청을 거부합니다.
+
+잘못된 요청은 기존처럼 거부되며, 경고 로그에 예외 종류와 구체적인 원인이 함께
+기록됩니다.
+
+세부 내용은 [요구사항 명세서](./REQUIREMENTS.md)와
+[구현 및 검증 기록](./IMPLEMENTS.md)을 참고하세요.