@tamai/hub-cli 0.1.2 → 0.1.3
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 +22 -0
- package/commands/project-update.mjs +70 -31
- package/lib/args.mjs +33 -5
- package/lib/format.mjs +36 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -74,6 +74,28 @@ hub project help
|
|
|
74
74
|
|
|
75
75
|
`show` / `claim` / `report` / `note` の `<id>` には**記録番号**(`150` / `#150`)も渡せる(`context_ref` が `docs/records/150-…` のタスクを一覧から引く。番号は repo ごとの採番なので別 repo と重なることがあり、そのときは今いる作業ツリーに記録ファイルがある方を採り、割り切れなければ候補を出して止まる)。
|
|
76
76
|
|
|
77
|
+
### `project update` の参照リンクは URL を貼るだけでよい
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
hub project update kki-website --add-link https://www.kki.ac.jp/
|
|
81
|
+
hub project update kki-website --add-link "テスト=https://stg.example.test/" --link-role preview
|
|
82
|
+
hub project update kki-website --remove-link-url https://stg.example.test/
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
`--add-link` は `http(s)` で始まる値を **URL 単独**と見なす(ラベルと URL の判別は `=` で割るより先に
|
|
86
|
+
行うので、`https://x.test/?a=1` が「ラベル `?a`」に割れることはない)。ラベルを省くと hub 側が
|
|
87
|
+
URL から決める。`"<ラベル>=<URL>"` の形は従来どおり最初の `=` で分ける。
|
|
88
|
+
|
|
89
|
+
`--link-role` は同じコマンドの `--add-link` 全部に付く役割で、任意指定。値は `production` /
|
|
90
|
+
`preview` / `admin` / `docs` / `minutes` / `code` / `files` / `communication` / `other`。
|
|
91
|
+
**CLI は URL から役割を推さない**(判別は Worker 側で行い、CLI は語彙の打ち間違いだけを手元で弾く)。
|
|
92
|
+
|
|
93
|
+
削除はラベル完全一致の `--remove-link` と、URL 完全一致の `--remove-link-url` の 2 つ。
|
|
94
|
+
ラベルの重複は許すので(自動ラベルは重なりうる)、同じラベルが 2 本あるときは
|
|
95
|
+
`--remove-link-url` で指す。逆に**同じ URL の重複は拒否する**。
|
|
96
|
+
入力した URL は資格情報を抱えていることがあるため、**どのエラー文にも再掲しない**
|
|
97
|
+
(何番目の `--add-link` か・既存側のラベルだけを出す)。
|
|
98
|
+
|
|
77
99
|
### `--repo-card` の出力先は cwd 基準
|
|
78
100
|
|
|
79
101
|
```bash
|
|
@@ -1,51 +1,79 @@
|
|
|
1
|
-
import { PROJECT_KINDS, cliError, requireSinglePositional, usageError } from "../lib/args.mjs";
|
|
2
|
-
import { printProjectResult } from "../lib/format.mjs";
|
|
1
|
+
import { PROJECT_KINDS, PROJECT_LINK_ROLES, cliError, requireSinglePositional, usageError } from "../lib/args.mjs";
|
|
2
|
+
import { printProjectResult, toProjectLinkInput } from "../lib/format.mjs";
|
|
3
|
+
|
|
4
|
+
/** `--add-link` の値がURL単独かどうか。**= で割るより先に見る**(指示 §5.6・Astra High 4)。 */
|
|
5
|
+
const URL_ONLY = /^https?:\/\//i;
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* 入力URLをエラー文へ再掲しない(Astra High 6)。URLは資格情報(`?token=…`)を抱えていることが
|
|
9
|
+
* あり、stderr へ出すとエージェントのtranscriptと端末ログに消せない形で積み上がる。
|
|
10
|
+
* 位置で指せば人は自分の打った引数を見に行ける。
|
|
11
|
+
*/
|
|
12
|
+
const ordinal = (index) => `${index + 1} 番目`;
|
|
3
13
|
|
|
4
14
|
export const projectUpdateCommand = {
|
|
5
15
|
name: "update",
|
|
6
16
|
options: {
|
|
7
|
-
allowed: ["name", "repo", "slug", "kind", "add-link", "remove-link", "clear-links"],
|
|
17
|
+
allowed: ["name", "repo", "slug", "kind", "add-link", "link-role", "remove-link", "remove-link-url", "clear-links"],
|
|
8
18
|
boolean: ["clear-links"],
|
|
9
|
-
repeatable: ["add-link", "remove-link"],
|
|
19
|
+
repeatable: ["add-link", "remove-link", "remove-link-url"],
|
|
10
20
|
},
|
|
11
21
|
async run({ options, positional, flags, dependencies, api }) {
|
|
12
22
|
const slug = requireSinglePositional(positional, "プロジェクトslug");
|
|
13
|
-
|
|
23
|
+
// --link-role は語彙だけを見る。どのroleが妥当かの判別はWorkerの仕事で、CLIはしない(§5.6)
|
|
24
|
+
let linkRole = null;
|
|
25
|
+
if (flags["link-role"]) {
|
|
26
|
+
if (!flags["add-link"]) throw usageError("--link-role は --add-link と一緒に指定してください");
|
|
27
|
+
linkRole = options["link-role"].trim();
|
|
28
|
+
if (!PROJECT_LINK_ROLES.includes(linkRole)) {
|
|
29
|
+
throw usageError(`--link-role は ${PROJECT_LINK_ROLES.join(" / ")} のいずれかです`);
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
const hasLinkChange = flags["add-link"] || flags["remove-link"] || flags["remove-link-url"] || flags["clear-links"];
|
|
14
34
|
if (!flags.name && !flags.repo && !flags.slug && !flags.kind && !hasLinkChange) {
|
|
15
|
-
throw usageError("--name / --repo / --slug / --kind / --add-link / --remove-link / --clear-links のいずれかを指定してください");
|
|
35
|
+
throw usageError("--name / --repo / --slug / --kind / --add-link / --remove-link / --remove-link-url / --clear-links のいずれかを指定してください");
|
|
16
36
|
}
|
|
17
37
|
if (flags.kind && !PROJECT_KINDS.includes(options.kind)) {
|
|
18
38
|
throw usageError(`--kind は ${PROJECT_KINDS.join(" / ")} のいずれかです`);
|
|
19
39
|
}
|
|
20
|
-
if (flags["clear-links"] && (flags["add-link"] || flags["remove-link"])) {
|
|
21
|
-
throw usageError("--clear-links と --add-link / --remove-link は同時に指定できません");
|
|
40
|
+
if (flags["clear-links"] && (flags["add-link"] || flags["remove-link"] || flags["remove-link-url"])) {
|
|
41
|
+
throw usageError("--clear-links と --add-link / --remove-link / --remove-link-url は同時に指定できません");
|
|
22
42
|
}
|
|
23
43
|
|
|
24
|
-
const addLinks = options["add-link"].map((entry) => {
|
|
25
|
-
const
|
|
26
|
-
|
|
27
|
-
|
|
44
|
+
const addLinks = options["add-link"].map((entry, index) => {
|
|
45
|
+
const raw = entry.trim();
|
|
46
|
+
// URL単独。ラベルはWorkerが埋めるので送らない(`https://x.test/?a=1` を割らないためでもある)
|
|
47
|
+
if (URL_ONLY.test(raw)) return linkRole === null ? { url: raw } : { url: raw, role: linkRole };
|
|
48
|
+
const at = raw.indexOf("=");
|
|
49
|
+
const label = at === -1 ? "" : raw.slice(0, at).trim();
|
|
50
|
+
const url = at === -1 ? "" : raw.slice(at + 1).trim();
|
|
28
51
|
if (label === "" || url === "") {
|
|
29
|
-
throw cliError(`--add-link は "<ラベル>=<URL>"
|
|
52
|
+
throw cliError(`--add-link は <URL> か "<ラベル>=<URL>" の形で指定してください(${ordinal(index)})`);
|
|
30
53
|
}
|
|
31
|
-
return { label, url };
|
|
54
|
+
return linkRole === null ? { label, url } : { label, url, role: linkRole };
|
|
32
55
|
});
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
56
|
+
|
|
57
|
+
// 同一コマンド内のURL重複。**ラベルの重複は許す**(Workerも許している。CLIだけが拒否していた)
|
|
58
|
+
const addedAt = new Map();
|
|
59
|
+
addLinks.forEach((link, index) => {
|
|
60
|
+
const first = addedAt.get(link.url);
|
|
36
61
|
if (first !== undefined) {
|
|
37
|
-
throw cliError(
|
|
38
|
-
`--add-link のラベルが重複しています: ${link.label}\n`
|
|
39
|
-
+ ` 1つ目: ${first}\n 2つ目: ${link.url}`,
|
|
40
|
-
);
|
|
62
|
+
throw cliError(`--add-link に同じURLが複数あります(${ordinal(first)} と ${ordinal(index)})`);
|
|
41
63
|
}
|
|
42
|
-
|
|
43
|
-
}
|
|
64
|
+
addedAt.set(link.url, index);
|
|
65
|
+
});
|
|
66
|
+
|
|
44
67
|
const removeLabels = options["remove-link"].map((entry) => {
|
|
45
68
|
const label = entry.trim();
|
|
46
69
|
if (label === "") throw cliError("--remove-link に空のラベルは指定できません");
|
|
47
70
|
return label;
|
|
48
71
|
});
|
|
72
|
+
const removeUrls = options["remove-link-url"].map((entry) => {
|
|
73
|
+
const url = entry.trim();
|
|
74
|
+
if (url === "") throw cliError("--remove-link-url に空のURLは指定できません");
|
|
75
|
+
return url;
|
|
76
|
+
});
|
|
49
77
|
|
|
50
78
|
const current = await api(`/api/projects/${encodeURIComponent(slug)}`);
|
|
51
79
|
if (!Number.isSafeInteger(current?.item?.version) || current.item.version < 1) {
|
|
@@ -63,25 +91,36 @@ export const projectUpdateCommand = {
|
|
|
63
91
|
}
|
|
64
92
|
if (flags.kind) body.kind = options.kind;
|
|
65
93
|
if (hasLinkChange) {
|
|
94
|
+
// 応答形(system / role_inferred 付き)のまま送り返さない。§3.5 の入力形へ戻してから触る
|
|
66
95
|
const currentLinks = Array.isArray(current.item.links) ? current.item.links : [];
|
|
67
|
-
let links =
|
|
96
|
+
let links = currentLinks.map((link) => toProjectLinkInput(link));
|
|
97
|
+
const remaining = () => links.map((link) => link.label).filter(Boolean).join("、") || "(なし)";
|
|
68
98
|
for (const label of removeLabels) {
|
|
69
|
-
const matched = links.filter((link) => link
|
|
99
|
+
const matched = links.filter((link) => link.label === label);
|
|
100
|
+
if (matched.length === 0) {
|
|
101
|
+
throw cliError(`該当するリンクがありません: ${label}\n現在のリンク: ${remaining()}`);
|
|
102
|
+
}
|
|
103
|
+
if (matched.length > 1) {
|
|
104
|
+
throw cliError(`ラベル「${label}」のリンクが${matched.length}件あり曖昧です。--remove-link-url <URL> で個別に指定してください`);
|
|
105
|
+
}
|
|
106
|
+
links = links.filter((link) => link !== matched[0]);
|
|
107
|
+
}
|
|
108
|
+
for (const url of removeUrls) {
|
|
109
|
+
const matched = links.filter((link) => link.url === url);
|
|
70
110
|
if (matched.length === 0) {
|
|
71
|
-
|
|
72
|
-
throw cliError(`該当するリンクがありません: ${label}\n現在のリンク: ${labels || "(なし)"}`);
|
|
111
|
+
throw cliError(`該当するURLのリンクがありません。\n現在のリンク: ${remaining()}`);
|
|
73
112
|
}
|
|
74
113
|
if (matched.length > 1) {
|
|
75
|
-
throw cliError(
|
|
114
|
+
throw cliError(`同じURLのリンクが${matched.length}件あるため、どれを消すか決められません。画面で個別に選んでください`);
|
|
76
115
|
}
|
|
77
116
|
links = links.filter((link) => link !== matched[0]);
|
|
78
117
|
}
|
|
79
118
|
for (const link of addLinks) {
|
|
80
|
-
const conflict = links.find((existing) => existing
|
|
119
|
+
const conflict = links.find((existing) => existing.url === link.url);
|
|
81
120
|
if (conflict) {
|
|
82
121
|
throw cliError(
|
|
83
|
-
|
|
84
|
-
+
|
|
122
|
+
`同じURLのリンクが既にあります: ${conflict.label ?? "(ラベルなし)"}\n`
|
|
123
|
+
+ "置き換えるなら同じコマンドで --remove-link-url してから --add-link してください",
|
|
85
124
|
);
|
|
86
125
|
}
|
|
87
126
|
links.push(link);
|
package/lib/args.mjs
CHANGED
|
@@ -1,6 +1,26 @@
|
|
|
1
1
|
/** プロジェクトの区分。共有範囲のvisibility(private|team)とは別の軸。 */
|
|
2
2
|
export const PROJECT_KINDS = ["work", "private"];
|
|
3
3
|
|
|
4
|
+
/**
|
|
5
|
+
* 参照リンクの役割(`2026-09-16 プロジェクト参照リンクの実装指示.md` §1.2 の9語)。
|
|
6
|
+
*
|
|
7
|
+
* **CLIが持つのは語彙だけで、判別はしない。** URLやラベルから role を推すのは Worker の仕事で
|
|
8
|
+
* (同 §2 の判別純関数)、CLIは人が `--link-role` で明示した値をそのまま送る。ここに置くのは
|
|
9
|
+
* 「GETより前に打ち間違いを弾く」ためだけである(往復してから400を読むより速い)。
|
|
10
|
+
* 語が増えたら Worker の `PROJECT_LINK_ROLES` と同時に直すこと。
|
|
11
|
+
*/
|
|
12
|
+
export const PROJECT_LINK_ROLES = [
|
|
13
|
+
"production",
|
|
14
|
+
"preview",
|
|
15
|
+
"admin",
|
|
16
|
+
"docs",
|
|
17
|
+
"minutes",
|
|
18
|
+
"code",
|
|
19
|
+
"files",
|
|
20
|
+
"communication",
|
|
21
|
+
"other",
|
|
22
|
+
];
|
|
23
|
+
|
|
4
24
|
export const DEFAULT_BASE_URL = "https://dash.tamaitakamasa.com";
|
|
5
25
|
|
|
6
26
|
export const TASK_USAGE = `使い方:
|
|
@@ -32,7 +52,9 @@ export const PROJECT_USAGE = `使い方:
|
|
|
32
52
|
hub project create <slug> --name <text> [--kind work|private] [--repo <text>] [--json]
|
|
33
53
|
hub project update <slug> [--name <text>] [--repo <text>] [--slug <new-slug>]
|
|
34
54
|
[--kind work|private]
|
|
35
|
-
[--add-link
|
|
55
|
+
[--add-link <URL>]... [--add-link "<ラベル>=<URL>"]...
|
|
56
|
+
[--link-role <role>]
|
|
57
|
+
[--remove-link "<ラベル>"]... [--remove-link-url <URL>]...
|
|
36
58
|
[--clear-links] [--json]
|
|
37
59
|
hub project move <slug> (--after <slug> | --top) [--json]
|
|
38
60
|
hub project sync-registry [--json]
|
|
@@ -40,10 +62,16 @@ export const PROJECT_USAGE = `使い方:
|
|
|
40
62
|
create はslugを自動生成しない。既存に倣ってkebabの英字で指定する(例 pc-setup)。
|
|
41
63
|
move はピン留めしたプロジェクトの並び替え。--top で先頭、--after で指定slugの直後。
|
|
42
64
|
update の --repo に空文字(--repo "")を渡すとrepoをクリアする。
|
|
43
|
-
--add-link
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
--
|
|
65
|
+
--add-link は <URL> だけでもよい(ラベルはhub側がURLから決める)。http(s) で始まる値は
|
|
66
|
+
URL単独と見なすので ?a=1 のようなクエリを持つURLも壊れない。
|
|
67
|
+
"<ラベル>=<URL>" の形なら最初の = でラベルとURLに分ける(URL側の = や ?a=1&b=2 はそのまま)。
|
|
68
|
+
--link-role は同じコマンドの --add-link 全部に付ける役割。省略時はhub側が候補を決める。
|
|
69
|
+
指定できるのは production / preview / admin / docs / minutes / code / files /
|
|
70
|
+
communication / other のいずれか。
|
|
71
|
+
追加は末尾へ・繰り返し指定可。ラベルの重複は許し、同じURLの重複は拒否する。
|
|
72
|
+
--remove-link はラベル完全一致(該当なし・複数該当はエラー)。複数該当は --remove-link-url で消す。
|
|
73
|
+
--remove-link-url はURL完全一致で1件だけ消す(該当なし・複数該当はエラー)。
|
|
74
|
+
--clear-links は全消し(--add-link / --remove-link / --remove-link-url と同時指定不可)。
|
|
47
75
|
--kind は仕事/プライベートの区分(既定 work)。共有範囲のvisibilityとは別。
|
|
48
76
|
list は既定で全件出す(--kind を付けたときだけ絞る)。
|
|
49
77
|
オプションは --name=value の形でも書ける(値が -- で始まるときはこの形で渡す)。
|
package/lib/format.mjs
CHANGED
|
@@ -60,12 +60,47 @@ export function projectLines(project, { includeLinks = false } = {}) {
|
|
|
60
60
|
for (const link of project.links) {
|
|
61
61
|
const label = String(link?.label ?? "").replace(/\s+/g, " ").trim();
|
|
62
62
|
const url = String(link?.url ?? "").trim();
|
|
63
|
-
lines.push(`- ${label}: ${url}`);
|
|
63
|
+
lines.push(`- ${label}${linkBadge(link)}: ${url}`);
|
|
64
64
|
}
|
|
65
65
|
}
|
|
66
66
|
return lines;
|
|
67
67
|
}
|
|
68
68
|
|
|
69
|
+
/**
|
|
70
|
+
* `[system/role]` の印(指示 §5.6)。role がWorkerの候補(`role_inferred: true`)なら `?` を付ける。
|
|
71
|
+
* 印が付かないのは system も role も無いときだけ —— 旧いAPIの応答をそのまま読めるようにしてある。
|
|
72
|
+
*/
|
|
73
|
+
function linkBadge(link) {
|
|
74
|
+
const system = typeof link?.system === "string" ? link.system.trim() : "";
|
|
75
|
+
const role = typeof link?.role === "string" ? link.role.trim() : "";
|
|
76
|
+
if (system === "" && role === "") return "";
|
|
77
|
+
const marked = role === "" ? "" : `${role}${link?.role_inferred === true ? "?" : ""}`;
|
|
78
|
+
if (system === "") return ` [${marked}]`;
|
|
79
|
+
return marked === "" ? ` [${system}]` : ` [${system}/${marked}]`;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* APIから受け取った links の要素を、PATCHの入力形 `{label, url, role?}` へ戻す(指示 §3.5)。
|
|
84
|
+
*
|
|
85
|
+
* 落とすものが2つある。`system` は**入力で受けない**(書き手はWorkerだけ)。`role_inferred: true`
|
|
86
|
+
* の `role` は**Workerが出した候補**であって人が決めた値ではないので、送り返すと候補が確定情報に
|
|
87
|
+
* 化ける。read-modify-write で配列を全置換する以上、ここで落とさないと「CLIで1本足しただけ」で
|
|
88
|
+
* 既存26本の候補roleが全部確定してしまう。
|
|
89
|
+
*
|
|
90
|
+
* SPA側(`dash/app/features/projects/model.ts` の `toProjectLinkInput`)に同じ規則の実装がある。
|
|
91
|
+
* CLIはTSをimportしないので共有していない。**片方だけ直さないこと**(規則はテストで固定してある)。
|
|
92
|
+
*/
|
|
93
|
+
export function toProjectLinkInput(link) {
|
|
94
|
+
const input = {};
|
|
95
|
+
const label = String(link?.label ?? "").trim();
|
|
96
|
+
// 空ラベルはキーごと落とす(APIは空文字を400にし、キーが無ければURLから既定ラベルを埋める)
|
|
97
|
+
if (label !== "") input.label = label;
|
|
98
|
+
input.url = String(link?.url ?? "").trim();
|
|
99
|
+
const role = typeof link?.role === "string" ? link.role.trim() : "";
|
|
100
|
+
if (role !== "" && link?.role_inferred !== true) input.role = role;
|
|
101
|
+
return input;
|
|
102
|
+
}
|
|
103
|
+
|
|
69
104
|
export function printProjectResult(payload, json, stdout, kind) {
|
|
70
105
|
if (json) {
|
|
71
106
|
stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
|