@infodb/p3 0.1.0 → 0.2.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/README.md +1 -1
- package/docs/architecture.md +8 -5
- package/docs/how-to-use.md +3 -3
- package/docs/installation.md +18 -9
- package/package.json +1 -1
- package/src/cli/help.ts +2 -2
- package/src/cli/project.ts +17 -10
- package/src/core/store/locate.ts +4 -4
package/README.md
CHANGED
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
管理したいリポジトリの中で:
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
pnpx @infodb/p3 init --agents #
|
|
34
|
+
pnpx @infodb/p3 init --agents # データのフォルダ(既定はリポジトリの .p3。外にも置ける)を決めて個人設定に登録する。AI 向けの指示とスキル(Claude Code・Codex)も置く
|
|
35
35
|
pnpx @infodb/p3 chatgpt login # Preflight に使う ChatGPT プランに接続する(ブラウザが開く)
|
|
36
36
|
pnpx @infodb/p3 codex update # Codex のイメージを作る(初回は数分)
|
|
37
37
|
pnpx @infodb/p3 serve # http://localhost:4310 を開き、要望を書いて Preflight → タスク化
|
package/docs/architecture.md
CHANGED
|
@@ -42,8 +42,10 @@ Preflight で扱う要望が、プロジェクトで行う作業の粒度にな
|
|
|
42
42
|
## プロジェクトの置き場所と個人設定
|
|
43
43
|
|
|
44
44
|
管理したいシステムは、本体・ドキュメント・基盤のように **複数のリポジトリに分かれている** ことが多い。
|
|
45
|
-
|
|
46
|
-
|
|
45
|
+
プロジェクトのデータは **データのフォルダ** に置き、操作するプロジェクトはその場所ではなく個人設定の登録で決める。
|
|
46
|
+
`p3 init` の既定は本体のリポジトリのルート(git のメインの作業ツリー)の `.p3/` で、ふつうのプロジェクトはそれでよい。
|
|
47
|
+
公開できない要望を含むときや、横断するリポジトリのどれとも別に管理したいときは、`--dir` でリポジトリの外
|
|
48
|
+
(例: `~/p3-data/myapp`、チームで同期するフォルダ)に置く。どちらでも同じに動く(既定は `init` の入口だけが持つ)。
|
|
47
49
|
|
|
48
50
|
| 何を | どこに | 共有 |
|
|
49
51
|
| --- | --- | --- |
|
|
@@ -66,7 +68,8 @@ Preflight で扱う要望が、プロジェクトで行う作業の粒度にな
|
|
|
66
68
|
プロジェクトを開く前に、読むだけの操作(`cli/readOnly.ts` の `readsOnly`。載っていない操作は変える操作として扱う)以外を止める。
|
|
67
69
|
案内の文は `locate.ts` の `onlyRegistrationNotice`(明示の方法と移る先を示す)
|
|
68
70
|
- 使う人はフォルダや実行パスを意識しない前提で、セットアップは2段階まで・エラーは次にすることを示す、を守る
|
|
69
|
-
-
|
|
71
|
+
- 個人設定に登録していないリポジトリの中の `.p3/` も、今いる場所から上へ辿って読める(`via: legacy`。デモ・テスト・登録前の clone)。
|
|
72
|
+
登録していれば今いる場所(`cwd`)で決まる
|
|
70
73
|
- 個人設定の書き換えは、ロック(`config.yaml.lock`)の中で最新のファイルを読み、対象の項目(プロジェクト1つの登録・
|
|
71
74
|
`ui.theme`)だけを変えて書く(`updateUserConfig`)。init・project add / rm・テーマの保存が同じ経路を通るので、
|
|
72
75
|
CLI と serve が同時に書いても消し合わない。壊れた YAML・読めないファイルは書かずにエラーにする(無いのとは区別する)。
|
|
@@ -549,8 +552,8 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
549
552
|
### 解決したこと
|
|
550
553
|
|
|
551
554
|
- **ID の衝突** — 要望は作成日 + 乱数、タスクは要望の中の連番にしたので、別々の人が作った要望どうしは衝突しない
|
|
552
|
-
- **状態がブランチごとに分岐する** —
|
|
553
|
-
git
|
|
555
|
+
- **状態がブランチごとに分岐する** — データは1つのデータのフォルダに書く(リポジトリの中の `.p3/` なら
|
|
556
|
+
git のメインの作業ツリーのものに書き、要望の作業ツリーの `.p3/` は使わない)。要望の作業ツリーの中で実行しても書き込み先は1か所で、今の要望は今いる参照先のブランチから決まる
|
|
554
557
|
|
|
555
558
|
### 残っている課題
|
|
556
559
|
|
package/docs/how-to-use.md
CHANGED
|
@@ -168,7 +168,7 @@ p3 request set k7m3x status=done # 要望を完了済にする(
|
|
|
168
168
|
| 1 | `dir` | `--dir <データのフォルダ>` を付けた |
|
|
169
169
|
| 2 | `project` | `--project <名前>` を付けた |
|
|
170
170
|
| 3 | `cwd` | 登録した参照先(サブフォルダ・その git の作業ツリーを含む)か、データのフォルダの中 |
|
|
171
|
-
| 4 | `legacy` |
|
|
171
|
+
| 4 | `legacy` | 個人設定に登録していないリポジトリの中の `.p3/`(登録する前の clone など。登録すれば 3 で決まる) |
|
|
172
172
|
| 5 | `only` | 登録が1つだけなので、どこからでもそれ(今いる場所とは関係なく決まる) |
|
|
173
173
|
|
|
174
174
|
決まらなければ、登録済みのプロジェクトと選び方を出す。AI 向けの指示では、`via` が `cwd` でなければ操作を止めて人に確かめる。
|
|
@@ -440,7 +440,7 @@ p3 render 画面.html --width 1280 # 画面.png ができる(幅 32
|
|
|
440
440
|
DB は無く、1タスク = 1 Markdown ファイル。人・AI・Codex が直接編集しても整合する(書き込みは直前に読み直し、古い rev なら止める)。
|
|
441
441
|
|
|
442
442
|
```
|
|
443
|
-
<データのフォルダ>/
|
|
443
|
+
<データのフォルダ>/ (既定はリポジトリのルートの .p3/。外に置いたなら例: ~/p3-data/myapp)
|
|
444
444
|
project.yaml プロジェクト設定
|
|
445
445
|
requests/
|
|
446
446
|
261009-k7m3x/ 要望のフォルダ(作成日 + 乱数5文字。タイトルが変わっても変わらない)
|
|
@@ -498,7 +498,7 @@ AI にも CLI を使わせる(認証を持たせずに済む)。`p3 init --a
|
|
|
498
498
|
プロジェクトでも読まれ、関係ない作業で p3 を操作しかねない。
|
|
499
499
|
|
|
500
500
|
**P3 を新しくしたとき**: 置いたスキルと追記は、手で直した分を消さないよう上書きしない。登録済みのリポジトリで
|
|
501
|
-
`p3 init --agents --project <名前> --dir
|
|
501
|
+
`p3 init --agents --project <名前> --dir <データのフォルダ>`(ルートの `.p3` なら `--dir` は省ける)をもう一度実行すると、登録とデータはそのままで、スキルの場所ごとに
|
|
502
502
|
無ければ置き、「最新です」か「同梱の版と違う」かを出す。片方(以前の版で置いた `.claude/skills` だけなど)しか無ければ、
|
|
503
503
|
足りない方が置かれる。違うものは同梱の原本と見比べて手で直す(追記は見出しがあれば足さないので、最新の内容は
|
|
504
504
|
[docs/architecture.md](architecture.md) の「AI エージェントへの指示」と見比べる)。
|
package/docs/installation.md
CHANGED
|
@@ -70,36 +70,45 @@ docker version --format 'Client {{.Client.Version}} / Server {{.Server.Version}}
|
|
|
70
70
|
|
|
71
71
|
## 4. プロジェクトを作る(か参加する)
|
|
72
72
|
|
|
73
|
-
管理したいリポジトリの中で `p3 init` を実行し、プロジェクト名と **データを置くフォルダ**
|
|
74
|
-
|
|
75
|
-
|
|
73
|
+
管理したいリポジトリの中で `p3 init` を実行し、プロジェクト名と **データを置くフォルダ** を決める。データのフォルダの既定は
|
|
74
|
+
**リポジトリのルートの `.p3`**(git のメインの作業ツリーの直下。サブフォルダや要望の作業ツリーから実行してもそこ。git 管理外なら
|
|
75
|
+
実行した場所の `.p3`)で、ふつうはこのまま Enter で決める。
|
|
76
|
+
|
|
77
|
+
公開できない要望を含むときや、複数のリポジトリにまたがるプロジェクトをどのリポジトリとも別に管理したいときは、リポジトリの外の
|
|
78
|
+
フォルダを指定する(例: `~/p3-data/myapp`。チームで共有するなら同期するフォルダ)。相対パスは実行した場所から、`~` はホームから。
|
|
79
|
+
DevContainer で外に置くときは、ホストから見える(バインドマウントされた)場所にする。
|
|
76
80
|
|
|
77
81
|
```bash
|
|
78
82
|
cd ~/src/myapp
|
|
79
83
|
p3 init --agents
|
|
80
84
|
# プロジェクト名(切り替えに使う短い名前) [myapp]:
|
|
81
|
-
#
|
|
85
|
+
# データを置くフォルダ(相対パスは今いる場所から。リポジトリの外も指定できます) [/home/me/src/myapp/.p3]:
|
|
82
86
|
# 何を作っているプロジェクトか(Preflight の前提になります): 社内向けの経費精算アプリ
|
|
83
87
|
# 最初に読むドキュメント(カンマ区切り。Preflight が評価の前に読みます) [docs, README.md]:
|
|
84
88
|
# Preflight で重視する観点・制約(任意): 個人情報を扱う変更は必ずリスクに挙げる
|
|
85
89
|
|
|
86
|
-
# AI やスクリプトからは引数で(--yes
|
|
90
|
+
# AI やスクリプトからは引数で(--yes で質問しない。--dir を付けなければリポジトリのルートの .p3)
|
|
91
|
+
p3 init --yes --agents --project myapp --description "社内向けの経費精算アプリ"
|
|
92
|
+
|
|
93
|
+
# リポジトリの外に置くなら --dir で指定する
|
|
87
94
|
p3 init --yes --agents --project myapp --dir ~/p3-data/myapp --description "社内向けの経費精算アプリ"
|
|
88
95
|
```
|
|
89
96
|
|
|
90
97
|
- データのフォルダには `project.yaml` と空の `requests/` ができる。このリポジトリは **本体の参照先**(Preflight が読むリポジトリ。
|
|
91
98
|
最初に読む・作業先にできる)として登録される
|
|
92
|
-
- 既にあるデータのフォルダ(ほかの人が作って共有したもの)を指したときは、作らずに **参加**
|
|
99
|
+
- 既にあるデータのフォルダ(ほかの人が作って共有したもの)を指したときは、作らずに **参加** だけする(データは書き換えない)。
|
|
100
|
+
リポジトリの `.p3` に入れて共有しているなら `p3 init` だけで、リポジトリの外のフォルダなら `--dir <そのフォルダ>` を付ける
|
|
101
|
+
- 既定の `.p3` を git に入れるか(`.gitignore` に書くか)は自分で決める。p3 は `.gitignore` を書き換えず、データをコミットもしない
|
|
93
102
|
- `--agents` を付けると、AI エージェント向けの使い方を `AGENTS.md`(無ければ `CLAUDE.md`)に追記し、同じスキルを
|
|
94
103
|
`.claude/skills/p3/SKILL.md`(Claude Code)と `.agents/skills/p3/SKILL.md`(Codex)に置く。置いたファイルはリポジトリに入れて共有する。
|
|
95
|
-
登録済みのリポジトリでも `p3 init --agents --project <名前> --dir
|
|
104
|
+
登録済みのリポジトリでも `p3 init --agents --project <名前> --dir <データのフォルダ>`(ルートの `.p3` なら `--dir` は省ける)をもう一度実行すれば、登録はそのままで足りない方だけを置く
|
|
96
105
|
- 登録はこのマシンの **個人設定**(`~/.config/infodb-p3/config.yaml`。`XDG_CONFIG_HOME` があればその下。共有しない)に入る
|
|
97
106
|
|
|
98
107
|
確かめる:
|
|
99
108
|
|
|
100
109
|
```bash
|
|
101
110
|
p3 whoami
|
|
102
|
-
# プロジェクト myapp /home/me/
|
|
111
|
+
# プロジェクト myapp /home/me/src/myapp/.p3
|
|
103
112
|
# 決まり方 cwd(今いる場所)
|
|
104
113
|
# 今いる参照先 myapp ブランチ main
|
|
105
114
|
# 変更者 human:<git の user.name>
|
|
@@ -230,7 +239,7 @@ DevContainer で「対応あり」にならなければ 5. を見直す。評価
|
|
|
230
239
|
| Preflight | 「Usage limit reached」 | ChatGPT の Manage usage(https://chatgpt.com/settings/usage) | 上限が戻るのを待つ |
|
|
231
240
|
| Preflight・画面 | 個人設定を読めない(YAML の行と直すファイル) | `~/.config/infodb-p3/config.yaml` | 書き間違いを直す。serve はそのままで次の Preflight から効く |
|
|
232
241
|
| CLI | プロジェクトが決まらない | `p3 whoami`、`p3 project` | `--project <名前>`、または `p3 project add <名前> <フォルダ>` |
|
|
233
|
-
| CLI・serve | 「データのフォルダがありません」「データのフォルダに project.yaml がありません」 | `p3 project ls` の登録先、フォルダを移していないか、共有ドライブ(同期するフォルダ)がつながっているか | つながっていなければつないでやり直す。移したなら `p3 project rm <名前>` → `p3 project add <名前> <正しいフォルダ>`(rm はデータを消さない。そのあと `p3 repo path` で手元のリポジトリを登録し直す)。新しく作るなら管理したいリポジトリの中で `p3 init --project
|
|
242
|
+
| CLI・serve | 「データのフォルダがありません」「データのフォルダに project.yaml がありません」 | `p3 project ls` の登録先、フォルダを移していないか、共有ドライブ(同期するフォルダ)がつながっているか | つながっていなければつないでやり直す。移したなら `p3 project rm <名前>` → `p3 project add <名前> <正しいフォルダ>`(rm はデータを消さない。そのあと `p3 repo path` で手元のリポジトリを登録し直す)。新しく作るなら管理したいリポジトリの中で `p3 init --project <名前>`(外に置くなら `--dir <フォルダ>`) |
|
|
234
243
|
| 画面 | 開けない | serve のログ、ポートの転送 | 4310 を転送する。`serve.port` を変えたら転送先も変える |
|
|
235
244
|
|
|
236
245
|
## 設定の決まり
|
package/package.json
CHANGED
package/src/cli/help.ts
CHANGED
|
@@ -8,8 +8,8 @@ export const HELP = `p3(infodb p3)— 要望ごとにフォルダを分け
|
|
|
8
8
|
|
|
9
9
|
プロジェクト
|
|
10
10
|
init 管理したいリポジトリの中で実行。データのフォルダを作り(既にあれば参加し)、個人設定に登録する。
|
|
11
|
-
|
|
12
|
-
--project 名前 --dir
|
|
11
|
+
このリポジトリを本体の参照先として登録する。データの既定はリポジトリのルートの .p3
|
|
12
|
+
--project 名前 --dir フォルダ(外に置くとき。相対は今いる場所から)--repo-name 参照先の名前(既定はフォルダ名)--description
|
|
13
13
|
--instructions 観点 --agents --yes
|
|
14
14
|
project [ls | add <名前> <フォルダ> | rm <名前>] 個人設定のプロジェクト
|
|
15
15
|
config [set キー=値 ...] 設定の表示・変更(name description branchPattern instructions)
|
package/src/cli/project.ts
CHANGED
|
@@ -15,6 +15,7 @@ import { addRepo, checkFolder, RepoAdminError, removeRepo, setLocalRepoPath, upd
|
|
|
15
15
|
import { Workspace as WorkspaceStore } from "../core/store/workspace.ts";
|
|
16
16
|
import { requestWorkstreams } from "../shared/workTarget.ts";
|
|
17
17
|
import type { Workspace } from "../core/store/workspace.ts";
|
|
18
|
+
import { DATA_DIR_NAME } from "../core/store/locate.ts";
|
|
18
19
|
import { loadUserConfig, PROJECT_NAME, setProjectNode, updateUserConfig, userConfigPath } from "../core/userConfig.ts";
|
|
19
20
|
|
|
20
21
|
/** プロジェクトの初期設定・設定変更、変更者と「今の要望」の判定(CLI) */
|
|
@@ -176,7 +177,7 @@ export interface InitOptions {
|
|
|
176
177
|
cwd: string;
|
|
177
178
|
/** 個人設定に登録する名前(既定: リポジトリのフォルダ名) */
|
|
178
179
|
project?: string;
|
|
179
|
-
/**
|
|
180
|
+
/** データを置くフォルダ(既定はリポジトリのルートの .p3。端末では聞く)。相対パスは実行した場所から */
|
|
180
181
|
dir?: string;
|
|
181
182
|
name?: string;
|
|
182
183
|
description?: string;
|
|
@@ -185,11 +186,15 @@ export interface InitOptions {
|
|
|
185
186
|
yes?: boolean;
|
|
186
187
|
/** このリポジトリの参照先の名前(既定はフォルダ名) */
|
|
187
188
|
repoName?: string;
|
|
189
|
+
/** 対話の問い(既定は端末の readline。テストが答えを渡す)。渡すと対話として聞く */
|
|
190
|
+
prompt?: (question: string) => Promise<string>;
|
|
188
191
|
}
|
|
189
192
|
|
|
190
193
|
/**
|
|
191
194
|
* p3 init。管理したいリポジトリの中で実行する。
|
|
192
|
-
* -
|
|
195
|
+
* - データを置くフォルダに project.yaml と requests/ を作る。既定はリポジトリのルート(git のメインの作業ツリー。
|
|
196
|
+
* git 管理外なら実行した場所)の .p3。サブフォルダや追加の作業ツリーから実行してもルートの .p3 にする。
|
|
197
|
+
* 公開できないデータや、リポジトリと別に管理したいときは --dir でリポジトリの外を指せる
|
|
193
198
|
* - 既に作られたフォルダ(他の人が作って共有したもの)を指したら、作らずに参加だけする
|
|
194
199
|
* - どちらの場合も個人設定に「プロジェクト名 → フォルダ・手元のリポジトリ」を登録する。以後はリポジトリの中なら指定が要らない
|
|
195
200
|
* 端末から実行すると対話式で聞き、--yes か非対話(AI・スクリプト)なら引数と推測した既定値で作る。
|
|
@@ -198,21 +203,23 @@ export async function init(o: InitOptions): Promise<string> {
|
|
|
198
203
|
const root = repoRoot(o.cwd);
|
|
199
204
|
const user = await loadUserConfig();
|
|
200
205
|
|
|
201
|
-
const interactive = !o.yes && process.stdin.isTTY && process.stdout.isTTY;
|
|
202
|
-
const rl = interactive ? createInterface({ input: process.stdin, output: process.stdout }) : undefined;
|
|
206
|
+
const interactive = !o.yes && (!!o.prompt || (process.stdin.isTTY && process.stdout.isTTY));
|
|
207
|
+
const rl = interactive && !o.prompt ? createInterface({ input: process.stdin, output: process.stdout }) : undefined;
|
|
208
|
+
const question = o.prompt ?? (rl ? (q: string) => rl.question(q) : undefined);
|
|
203
209
|
const ask = async (q: string, def: string) => {
|
|
204
|
-
if (!
|
|
205
|
-
const a = (await
|
|
210
|
+
if (!question) return def;
|
|
211
|
+
const a = (await question(`${q}${def ? ` [${def}]` : ""}: `)).trim();
|
|
206
212
|
return a || def;
|
|
207
213
|
};
|
|
208
214
|
|
|
209
215
|
try {
|
|
210
|
-
if (
|
|
216
|
+
if (question) console.log(`p3 のプロジェクトを作ります(リポジトリ: ${root})\n(Enter で [ ] 内の既定値)\n`);
|
|
211
217
|
const key = await ask("プロジェクト名(切り替えに使う短い名前)", o.project ?? slugifyName(basename(root)) ?? "project");
|
|
212
218
|
if (!PROJECT_NAME.test(key)) throw new UsageError(`プロジェクト名は英数字と . _ - で: ${key}`);
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
219
|
+
// 未指定ならルートの .p3(既定値は絶対パスで見せる)。指定したパス(相対は実行した場所から)はそのまま使い、外にも置ける。
|
|
220
|
+
// 明示した空のパスは未指定と分けて断る
|
|
221
|
+
if (o.dir !== undefined && !o.dir.trim()) throw new UsageError("--dir が空です。既定(リポジトリのルートの .p3)にするなら --dir を付けずに実行してください");
|
|
222
|
+
const dir = resolvePath(o.cwd, o.dir ?? (await ask("データを置くフォルダ(相対パスは今いる場所から。リポジトリの外も指定できます)", join(root, DATA_DIR_NAME))));
|
|
216
223
|
|
|
217
224
|
const registered = user.projects[key];
|
|
218
225
|
if (registered && registered.dir !== dir) throw new UsageError(`プロジェクト名「${key}」は別のフォルダで登録済みです: ${registered.dir}`);
|
package/src/core/store/locate.ts
CHANGED
|
@@ -4,7 +4,7 @@ import { stat } from "node:fs/promises";
|
|
|
4
4
|
import { dirname, join, resolve, sep } from "node:path";
|
|
5
5
|
import type { UserConfig } from "../userConfig.ts";
|
|
6
6
|
|
|
7
|
-
/**
|
|
7
|
+
/** p3 init がデータを置く既定のフォルダ名(リポジトリのルートの直下) */
|
|
8
8
|
export const DATA_DIR_NAME = ".p3";
|
|
9
9
|
|
|
10
10
|
export interface ResolvedProject {
|
|
@@ -93,7 +93,7 @@ export function onlyRegistrationNotice(p: ResolvedProject, write: boolean): stri
|
|
|
93
93
|
* 1. --dir <フォルダ> データのフォルダを直接指す
|
|
94
94
|
* 2. --project <名前> 個人設定に登録したプロジェクト
|
|
95
95
|
* 3. 今いる場所 登録したプロジェクトのデータのフォルダか、そのリポジトリ(作業ツリーを含む)の中
|
|
96
|
-
* 4. リポジトリの中の .p3/
|
|
96
|
+
* 4. リポジトリの中の .p3/ 個人設定に登録していないとき(git のメインの作業ツリー → 上へ辿る。デモ・登録前の clone など)
|
|
97
97
|
* 5. 登録が1つだけ それを使う
|
|
98
98
|
*/
|
|
99
99
|
export function resolveProject(o: { cwd: string; dir?: string; project?: string; user: UserConfig }): ResolvedProject {
|
|
@@ -135,7 +135,7 @@ export function resolveProject(o: { cwd: string; dir?: string; project?: string;
|
|
|
135
135
|
throw new ProjectNotResolvedError(
|
|
136
136
|
entries.length
|
|
137
137
|
? `操作するプロジェクトが決まりません(今いる場所: ${o.cwd})。\n${listing(o.user)}`
|
|
138
|
-
: "プロジェクトがまだありません。管理したいリポジトリの中で次を実行してください:\n p3 init --project
|
|
138
|
+
: "プロジェクトがまだありません。管理したいリポジトリの中で次を実行してください:\n p3 init --project <名前>(データはリポジトリのルートの .p3。外に置くなら --dir <フォルダ>)",
|
|
139
139
|
);
|
|
140
140
|
}
|
|
141
141
|
|
|
@@ -153,7 +153,7 @@ function listing(user: UserConfig): string {
|
|
|
153
153
|
const inside = (path: string, dir: string) => path === dir || path.startsWith(dir.endsWith(sep) ? dir : dir + sep);
|
|
154
154
|
|
|
155
155
|
/**
|
|
156
|
-
* リポジトリの中の .p3/
|
|
156
|
+
* リポジトリの中の .p3/ を探す(個人設定に登録していないとき。登録していれば 3. の今いる場所で決まる)。
|
|
157
157
|
* 要望ごとの作業ツリーの中で実行しても、git のメインの作業ツリーの .p3/ を使う(各作業ツリーの .p3/ はブランチ時点の写し)。
|
|
158
158
|
*/
|
|
159
159
|
export function findDataDir(cwd: string): string | undefined {
|