@hastycapybara/tasks-cli 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/NOTICE.md +23 -0
- package/README.md +28 -0
- package/dist/tasksmd.cjs +136 -0
- package/package.json +42 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 HastyCapybara (W.Leester)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/NOTICE.md
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# 제3자 고지 (Third-party notices)
|
|
2
|
+
|
|
3
|
+
## Obsidian Tasks
|
|
4
|
+
|
|
5
|
+
`src/core/`의 태스크 파싱·직렬화, 반복(recurrence), 긴급도(urgency), 쿼리 로직 일부는
|
|
6
|
+
[Obsidian Tasks](https://github.com/obsidian-tasks-group/obsidian-tasks)에서 이식했거나 그 구현을 참고했습니다.
|
|
7
|
+
Copyright (c) 2021 Martin Schenck and Clare Macrae, MIT 라이선스.
|
|
8
|
+
|
|
9
|
+
이식한 파일에는 상단 주석으로 출처를 표시했습니다:
|
|
10
|
+
`src/core/recurrence/Recurrence.ts`, `src/core/task/Urgency.ts`, `src/core/task/statusPresets.ts`,
|
|
11
|
+
`tests/core/task/obsidian-port.test.ts`, `tests/core/recurrence/Recurrence.test.ts`, `tests/core/task/Urgency.test.ts`.
|
|
12
|
+
|
|
13
|
+
MIT 라이선스 전문은 `LICENSE`와 같습니다. 이 프로젝트는 Obsidian Tasks 프로젝트나 Obsidian(Dynalist Inc.)과
|
|
14
|
+
관련이 없으며, 그들의 보증을 받지 않았습니다.
|
|
15
|
+
|
|
16
|
+
## 런타임 의존성
|
|
17
|
+
|
|
18
|
+
| 패키지 | 라이선스 | 용도 |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| [dayjs](https://github.com/iamkun/dayjs) | MIT | 날짜 계산 |
|
|
21
|
+
| [rrule](https://github.com/jkbrzt/rrule) | BSD-3-Clause | 반복 규칙 해석 |
|
|
22
|
+
| [ignore](https://github.com/kaelzhang/node-ignore) | MIT | `.gitignore` 규칙 적용 |
|
|
23
|
+
| [svelte](https://github.com/sveltejs/svelte) (웹뷰 번들에 포함) | MIT | 웹뷰 UI |
|
package/README.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# @hastycapybara/tasks-cli
|
|
2
|
+
|
|
3
|
+
Tasks for Markdown의 명령줄 도구입니다. 편집기를 띄우지 않고 마크다운 폴더의 태스크를 조회하고 만들고 완료합니다. 확장과 같은 코드(`@hastycapybara/tasks-core`)를 쓰므로 완료일·반복 다음 회차·필드 순서가 편집기에서 한 것과 똑같습니다.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
npx @hastycapybara/tasks-cli query "not done
|
|
7
|
+
due before today" --root ~/notes --md
|
|
8
|
+
|
|
9
|
+
tasksmd add "월간 결산 #업무 ⏫ 📅 2026-10-05" --file notes/inbox.md
|
|
10
|
+
tasksmd done notes/todo.md:12 --expect "- [ ] 원문 줄" # 줄이 바뀌었으면 거부(STALE_LINE)
|
|
11
|
+
tasksmd set notes/todo.md:12 --due 2026-10-20 --priority 1
|
|
12
|
+
tasksmd postpone notes/todo.md:12 "next monday"
|
|
13
|
+
tasksmd query "not done" --json | jq '.tasks[] | select(.priority == "0") | .description'
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
- `--root`(기본 현재 폴더) 아래의 `.md`/`.markdown`을 `.gitignore`와 `tasksmd.exclude`를 존중해 훑습니다. 설정은 `<root>/.vscode/settings.json`의 `tasksmd.*`를 읽습니다(전역 필터, 완료일 기록, 반복 삽입 위치, 사용자 정의 상태 등).
|
|
17
|
+
- 줄 번호는 사람이 읽는 1부터 시작하는 번호입니다. 출력은 터미널이면 마크다운, 파이프면 JSON이 기본이고 `--json`/`--md`로 고정합니다.
|
|
18
|
+
- 파일을 직접 고칩니다. 편집기에 저장하지 않은 변경이 있는 파일을 고치면 편집기가 "덮어쓸까요?"를 물을 수 있으니 저장한 뒤 쓰세요. `--expect`로 줄 원문을 함께 주면 그사이 바뀐 줄을 덮어쓰지 않습니다.
|
|
19
|
+
- 종료 코드: 0 성공, 1 실행 오류(`NOT_FOUND`, `STALE_LINE`, `INVALID_QUERY`, `IO`), 2 인자 오류.
|
|
20
|
+
|
|
21
|
+
## MCP 서버 (AI 에이전트)
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
claude mcp add tasks -- npx -y @hastycapybara/tasks-cli mcp --root "$PWD"
|
|
25
|
+
```
|
|
26
|
+
등록 후 Claude Code에 "이번 주 마감인 업무 태스크 중 안 끝난 거 보여주고 계약서 검토는 완료 처리해 줘"처럼 말하면 `tasks_query`, `tasks_set_status` 도구가 호출됩니다. 도구 목록과 인자는 저장소의 docs/api.md 8절에 있습니다.
|
|
27
|
+
|
|
28
|
+
라이선스 MIT. 태스크 문법과 핵심 로직 일부는 [Obsidian Tasks](https://github.com/obsidian-tasks-group/obsidian-tasks)(MIT)에서 이식했습니다(동봉된 NOTICE.md). Obsidian과 관련이 없습니다.
|