relaytask 0.1.0__tar.gz

relaytask-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Swing
+
+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.

relaytask-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: relaytask
+Version: 0.1.0
+Summary: Handoff-native multi-repo task workspace manager
+Author: Swing
+License-Expression: MIT
+Keywords: task,workflow,tmux,textual,agent,handoff,worktree
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.85
+Dynamic: license-file
+
+# RelayTask
+
+Handoff-native multi-repo task workspace manager for agent-driven feature work.
+
+## Install
+
+```bash
+pip install relaytask
+```
+
+## Run
+
+```bash
+relaytask
+relaytask-tui
+```
+
+## Local development
+
+```bash
+./bin/relaytask
+./bin/relaytask-tui
+python3 build_relaytask_bundle.py
+```

relaytask-0.1.0/README.md

@@ -0,0 +1,24 @@
+# RelayTask
+
+Handoff-native multi-repo task workspace manager for agent-driven feature work.
+
+## Install
+
+```bash
+pip install relaytask
+```
+
+## Run
+
+```bash
+relaytask
+relaytask-tui
+```
+
+## Local development
+
+```bash
+./bin/relaytask
+./bin/relaytask-tui
+python3 build_relaytask_bundle.py
+```

relaytask-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "relaytask"
+version = "0.1.0"
+description = "Handoff-native multi-repo task workspace manager"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+  { name = "Swing" }
+]
+keywords = ["task", "workflow", "tmux", "textual", "agent", "handoff", "worktree"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Version Control :: Git",
+  "Topic :: Utilities"
+]
+dependencies = [
+  "textual>=0.85",
+]
+
+[project.scripts]
+relaytask = "relaytask.cli:main"
+relaytask-tui = "relaytask.tui:main"
+
+[tool.setuptools]
+include-package-data = true
+py-modules = []
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["relaytask"]
+namespaces = false
+
+[tool.setuptools.package-data]
+relaytask = ["assets/*"]

relaytask-0.1.0/relaytask/__init__.py

@@ -0,0 +1 @@
+"""RelayTask standalone scripts package."""

relaytask-0.1.0/relaytask/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

relaytask-0.1.0/relaytask/assets/AGENTS.md.template

@@ -0,0 +1,26 @@
+# Task Workspace AGENTS
+
+- 기본 언어: 한글
+- 이 디렉터리는 하나의 작업 컨텍스트를 담는다.
+- 작업 시작 전 `PLAN.md`, `STATUS.json`, `DECISIONS.md`를 먼저 읽는다.
+- 각 repo 내부의 `AGENT.md` 또는 `AGENTS.md`를 추가로 확인한다.
+- repo 내부 가이드라인은 구현 규칙의 기준이며, 이 문서는 태스크 운영 규칙의 기준이다.
+- 다음 작업자는 `STATUS.json`만 보고도 바로 직전 작업을 재개할 수 있어야 한다.
+
+## 작업 목표
+- [이 작업의 한 줄 목표]
+
+## 포함 Repo
+- `repo-a`: [포함 이유]
+- `repo-b`: [포함 이유]
+
+## 참조 가이드
+[참조 가이드 경로 목록]
+
+## 작업 규칙
+- 상위 문서는 task 규칙을 담고, repo 내부 문서는 구현 규칙을 담는다.
+- repo 범위 변경 시 `STATUS.json`과 이 문서를 함께 갱신한다.
+- 중요한 판단은 `DECISIONS.md`에 기록한다.
+- 세션 시작 시 `STATUS.json`의 `current_goal`, `in_progress`, `next_actions`, `resume_steps`를 먼저 최신화한다.
+- 세션 종료 전 `STATUS.json`의 `last_work`, `next_actions`, `resume_steps`를 반드시 갱신한다.
+- `재개 절차`에는 다음 작업자가 바로 실행할 명령, 열 파일, 확인 포인트를 남긴다.

relaytask-0.1.0/relaytask/assets/DECISIONS.md.template

@@ -0,0 +1,5 @@
+# DECISIONS
+
+## YYYY-MM-DD
+- [결정 내용]
+- [이유 또는 영향]

relaytask-0.1.0/relaytask/assets/PLAN.md.template

@@ -0,0 +1,12 @@
+# PLAN
+
+## 목표
+- [작업 목표]
+
+## 작업 범위
+- [ ] [repo-a 작업]
+- [ ] [repo-b 작업]
+- [ ] 통합 검증
+
+## 완료 조건
+- [완료 기준]

relaytask-0.1.0/relaytask/assets/REFS.md.template

@@ -0,0 +1,10 @@
+# REFS
+
+## 목적
+- 이 디렉터리는 최신 기준 브랜치의 읽기 전용 참조 worktree 집합이다.
+- 책임 경계, 호출 흐름, 기존 구현 방식을 확인할 때만 사용한다.
+
+## 규칙
+- 여기서 직접 구현하지 않는다.
+- 구현은 각 task 디렉터리의 feature branch worktree에서 한다.
+- 기준 브랜치명은 repo별로 명시한다.

relaytask-0.1.0/relaytask/assets/STATUS.json.template

@@ -0,0 +1,28 @@
+{
+  "schema_version": 1,
+  "updated_at": "[UPDATED_AT]",
+  "current_goal": [
+    "[CURRENT_GOAL]"
+  ],
+  "completed": [
+    "[COMPLETED]"
+  ],
+  "last_work": [
+    "[LAST_WORK]"
+  ],
+  "in_progress": [
+    "[IN_PROGRESS]"
+  ],
+  "next_actions": [
+    "[NEXT_ACTION_1]",
+    "[NEXT_ACTION_2]"
+  ],
+  "resume_steps": [
+    "[RESUME_STEP_1]",
+    "[RESUME_STEP_2]",
+    "[RESUME_STEP_3]"
+  ],
+  "links": [
+    "[LINK_1]"
+  ]
+}

relaytask-0.1.0/relaytask/assets/SYSTEM_MAP.md.template

@@ -0,0 +1,15 @@
+# SYSTEM MAP
+
+## 개요
+- [시스템 전체를 한두 문장으로 설명]
+
+## Repo Map
+| Repo | 소유 책임 | 소유하지 않는 것 | 보통 같이 보는 Repo | 포함 트리거 |
+|---|---|---|---|---|
+| repo-a | [책임] | [비책임] | [adjacent repos] | [언제 포함하는지] |
+| repo-b | [책임] | [비책임] | [adjacent repos] | [언제 포함하는지] |
+
+## 선택 규칙
+- 도메인 규칙 변경이면 원천 소유 repo를 우선 포함한다.
+- API 조합/응답 형태 변경이면 aggregation/BFF repo를 포함한다.
+- 배포/런타임 검증이 필요하면 그 레이어 repo를 추가한다.

relaytask-0.1.0/relaytask/assets/TASKS.md.template

@@ -0,0 +1,12 @@
+# TASKS
+
+| Task | State | Included Repos | Base / Feature / Promote | PR / Deploy | Last Updated |
+|---|---|---|---|---|---|
+
+## State Guide
+- `planned`: task defined, worktrees not ready
+- `ready`: repos selected, worktrees created
+- `in-progress`: implementation active
+- `review`: PR open or validation running
+- `merged`: merged to mainline/develop
+- `deployed`: runtime promotion completed

relaytask-0.1.0/relaytask/assets/TASK_OVERVIEW.md.template

@@ -0,0 +1,28 @@
+# Task Overview
+
+## Task
+- 이름: [태스크 이름]
+- 상태: [태스크 상태]
+- 요약: [태스크 요약]
+- 브랜치: [태스크 브랜치]
+
+## Selected Repos
+| Repo | Base Branch | Worktree | Guide Snapshot |
+|---|---|---|---|
+[TASK_REPO_ROWS]
+
+## Status Snapshot
+- 현재 목표: [현재 목표]
+- 진행 중: [진행 중]
+- 다음 액션: [다음 액션]
+
+## Files
+- `AGENTS.md`
+- `PLAN.md`
+- `STATUS.json`
+- `DECISIONS.md`
+- `SYSTEM_MAP.md`
+- `.context/repo-guides/`
+
+## Promotion
+- feature -> develop -> main PR

relaytask-0.1.0/relaytask/assets/WORKSPACE.md.template

@@ -0,0 +1,14 @@
+# WORKSPACE
+
+## 이름
+- [워크스페이스 이름]
+
+## 설명
+- [워크스페이스 설명]
+
+## 구성 원칙
+- 이 워크스페이스는 task-first 멀티레포 작업을 관리한다.
+- 상위 `TASKS.md`는 전체 작업 목록을 담는다.
+- 상위 `SYSTEM_MAP.md`는 repo 책임과 선택 기준을 담는다.
+- `refs/`는 읽기 전용 mainline 참조 레이어다.
+- 각 task 디렉터리는 구현과 상태 기록의 단위다.

relaytask-0.1.0/relaytask/assets/WORKSPACE_OVERVIEW.md.template

@@ -0,0 +1,35 @@
+# Workspace Overview
+
+## Workspace
+- 이름: [워크스페이스 이름]
+- 설명: [워크스페이스 설명]
+
+## Layout
+```text
+[워크스페이스 루트]
+  TASKS.md
+  WORKSPACE.md
+  SYSTEM_MAP.md
+  OVERVIEW.md
+  refs/
+  .meta/
+  <task-name>/
+```
+
+## Repo Catalog
+| Repo | Base Branch | Summary | Keywords |
+|---|---|---|---|
+[REPO_CATALOG_ROWS]
+
+## Lifecycle
+1. `workspace-init`
+2. `task-new`
+3. `task-list`
+4. `task-continue`
+5. `task-promote`
+6. `task-release`
+
+## Rules
+- `refs/`는 읽기 전용 참조 레이어다.
+- task별 상태는 각 task의 `STATUS.json`이 최신 기준이다.
+- 전체 현황은 상위 `TASKS.md`에서 본다.