docs: record CLI runner release and move NeoMutt guidance [skip ci]
This commit is contained in:
1 parent
8733645747
commit
7187af42ed
5 files changed
+54
-111
No files matched your search
@@ -1,109 +1,10 @@
|
||||
# neomuttとpages CLIによるタスク管理
|
||||
# NeoMutt連携ドキュメントの移転
|
||||
|
||||
メールからタスクを作り、作業の開始・終了を記録し、個人アドレス帳をneomuttの宛先補完に使う。先に通常の端末でpages-cliを設定してログインする。neomuttの設定やシェル履歴にトークンを書かない。
|
||||
NeoMuttとpages CLIによるメールからのタスク作成、作業時間の記録・レポート、日次メール設定、連絡先の宛先補完の利用手順は、独立した公開リポジトリへ移転した。
|
||||
|
||||
```sh
|
||||
pages configure --origin https://pages.anya.jp --username YOUR_USERNAME
|
||||
pages login --oidc --no-browser
|
||||
pages task --help
|
||||
```
|
||||
- [NeoMuttとタスク・連絡先の操作ガイド](https://git.anya.jp/anya/pages-cli/src/branch/main/docs/neomutt.md)
|
||||
- [NeoMutt設定ファイル例](https://git.anya.jp/anya/pages-cli/src/branch/main/examples/neomuttrc)
|
||||
- [CLIの接続・保存・安全性の契約](https://git.anya.jp/anya/pages-cli/src/branch/main/docs/client-contract.md)
|
||||
- [CLIリポジトリと配布物](https://git.anya.jp/anya/pages-cli)
|
||||
|
||||
別接続を使うときは `pages --profile NAME task ...`。保存セッションはprivateなプロファイルファイルを使い、処理中はプロファイルロックを取得する。
|
||||
|
||||
## メールから作成
|
||||
|
||||
```sh
|
||||
pages task from-mail < message.eml
|
||||
pages task from-mail --project '開発 計画' --due 2026-11-03 < message.eml
|
||||
# 本文を保存してよいメールに限り明示する
|
||||
pages task from-mail --include-body < message.eml
|
||||
```
|
||||
|
||||
既定では件名をタスク名、From・Date・Message-IDをメモにする。本文と添付はアップロードしない。include-bodyはplain text本文だけを追加し、HTML画像・添付・外部URLは取得しない。1通2 MiB、メモ16 KiBが上限。件名が300 UTF-8 bytesを超える場合は `--title '短い件名'` で指定する。
|
||||
|
||||
同じ接続・本人・Message-IDから同じrequest_idを作るため、同じメールの再取り込みで重複しない。Message-IDなしはメール全体のSHA-256を使う。同じメールを別の独立タスクにもしたい場合は `task add` を使う。
|
||||
|
||||
`~/.config/neomutt/neomuttrc` の例。pagesの絶対パスはインストール先に合わせる。件名等をシェルコマンド文字列に展開せず、メールを標準入力で渡す。
|
||||
|
||||
```muttrc
|
||||
set pipe_split = yes
|
||||
set pipe_decode = no
|
||||
macro index,pager ,t "<pipe-message>/home/anya/.local/bin/pages task from-mail<enter>" "Create PagesWiki task"
|
||||
```
|
||||
|
||||
`,` → `t` で選択メールを取り込む。pipe_splitは複数メールを1つのMIME入力へ連結しないため、pipe_decode=noはCLI側でMIMEを解釈するための設定。既存のpipe操作にも影響するので、自分の設定と合わせて確認する。[NeoMutt設定リファレンス](https://neomutt.org/guide/reference.html)を参照。
|
||||
|
||||
## 通信失敗と再送
|
||||
|
||||
CLIは作成要求を送信前にprivateなセッションファイルへ保持する。失敗時に表示するrequest_idで明示的に再送する。
|
||||
|
||||
```sh
|
||||
pages task retry REQUEST_UUID
|
||||
```
|
||||
|
||||
最大20件を保留でき、成功した要求はローカルから削除する。同じ本人への再ログインで保留分を維持する。別アカウントへ切り替える場合は別プロファイルを使う。認証済みセッションがない状態からの完全オフライン入力受付ではない。
|
||||
|
||||
サーバーで保存された直後に応答が失われても、同じrequest_idで再送すれば既存タスクが返る。保留要求を書き換えて再送すると412になる。セッションファイルにはトークンもあるため、デバッグ目的で内容を貼り付けない。
|
||||
|
||||
## 計画と実績
|
||||
|
||||
```sh
|
||||
pages task project-add '開発 計画'
|
||||
pages task projects
|
||||
pages task preferences --project '開発 計画' --due-days 3 --review-days 1 --estimate 60 --complexity 2
|
||||
pages task add '設計をレビュー' --estimate 120 --planned 2026-11-02
|
||||
pages task list --view today
|
||||
pages task update TASK_UUID --due 2026-11-04
|
||||
pages task start TASK_UUID
|
||||
pages task status
|
||||
pages task stop
|
||||
pages task done TASK_UUID
|
||||
pages task report --from 2026-11-01 --to 2026-12-01
|
||||
pages task report --from 2026-11-01 --to 2026-12-01 --json
|
||||
```
|
||||
|
||||
stopは作業記録の終了、doneはタスクの完了。両者は独立している。見積は分単位、complexityは1〜5。期間のtoは含まない。CSV等への後処理にはJSONを使う。APIはドメインのタイムゾーンで日付を集計する。
|
||||
|
||||
日次メールを設定する例。SMTP設定と本人のメール登録が必要で、CLIを実行しただけでは第三者へ送信しない。
|
||||
|
||||
```sh
|
||||
pages task preferences --digest on --at 09:00 --timezone Asia/Tokyo
|
||||
pages task preferences --digest off
|
||||
```
|
||||
|
||||
## neomuttの宛先補完
|
||||
|
||||
```sh
|
||||
pages contacts list --query 田中
|
||||
pages contacts import contact.vcf
|
||||
pages contacts export CONTACT_UUID > contact.vcf
|
||||
pages contacts query 田中 --neomutt
|
||||
```
|
||||
|
||||
```muttrc
|
||||
set query_command = "/home/anya/.local/bin/pages contacts query --neomutt -- %s"
|
||||
bind editor <Tab> complete-query
|
||||
```
|
||||
|
||||
neomuttは%sをシェル用に引用するので、%sをさらに引用符で囲まない。出力は先頭の状態行と、メール・名前・所属のタブ区切り。`--`は検索語をCLIオプションとして解釈させないために付ける。標準のCtrl-Tによる補完を残したい場合はbind行を省略する。[外部アドレス検索](https://neomutt.org/guide/advancedusage.html#query)、[query_command](https://neomutt.org/guide/reference.html#query-command)。
|
||||
|
||||
連絡先は本人のDomain内だけを検索し、最大100件。メールアドレスのない連絡先は候補に出ない。ログイン切れの場合は通常の端末で再ログインする。書き出したvCardには非公開情報が含まれるため、ファイル権限と保存先を確認する。
|
||||
|
||||
## HTTPクライアントから使う
|
||||
|
||||
`POST https://pages.anya.jp/_/api/v1/extension/organizer.tasks/capture`
|
||||
|
||||
Content-Typeはapplication/json、AuthorizationはBearerセッション。例示UUIDは要求ごとに生成し、通信再送時だけ同じものを使う。
|
||||
|
||||
```json
|
||||
{
|
||||
"request_id": "884587b2-6ae5-4aef-86d0-fd21dac39d1c",
|
||||
"title": "メールで依頼された内容を確認",
|
||||
"notes": "Message-ID: <example@example.invalid>",
|
||||
"estimate_minutes": 30,
|
||||
"complexity": 2,
|
||||
"due_on": "2026-11-03"
|
||||
}
|
||||
```
|
||||
|
||||
成功は201とitem。認証切れ401、権限不足403、要求IDの内容競合412、不正入力422。トークンをクエリ文字列に含めず、HTTPSで送る。詳細は [タスクと連絡先の設計](../design/ja/task-productivity-contacts.md) を参照。
|
||||
利用者向け手順と設定例の正本はpages-cli側とし、このページは既存リンクの移転案内として残す。サーバーAPI・権限・DB・通知ジョブの設計は引き続き[タスクと連絡先の設計](../design/ja/task-productivity-contacts.md)で管理する。PagesWiki側の `pages-cli/` はHTTP結合テスト用の固定スナップショットであり、独立CLIの配布元ではない。
|
||||
Reference in new issue
Block a user