@tamai/hub-cli 0.1.3 → 0.1.5
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 +4 -1
- package/bin/hub.mjs +2 -4
- package/commands/task-new.mjs +5 -1
- package/lib/args.mjs +2 -2
- package/lib/cli.mjs +4 -6
- package/lib/format.mjs +0 -31
- package/lib/records.mjs +27 -1
- package/package.json +1 -1
- package/commands/project-sync-registry.mjs +0 -17
package/README.md
CHANGED
|
@@ -66,7 +66,7 @@ hub project help
|
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
動詞は `task` が `new` / `add` / `claim` / `next` / `show` / `report` / `note` / `list` / `audit`、
|
|
69
|
-
`project` が `list` / `show` / `create` / `update` / `move
|
|
69
|
+
`project` が `list` / `show` / `create` / `update` / `move`。
|
|
70
70
|
**正確なオプションは常に `--help` を見る**(ここにも、スキルにも写経しない)。
|
|
71
71
|
全動詞が `--json` を受ける。機械が読むときは必ず `--json` を使い、人向けの整形を parse しない。
|
|
72
72
|
|
|
@@ -105,6 +105,9 @@ hub task new '新しいタスク' --project hub --body-file brief.md --repo-card
|
|
|
105
105
|
|
|
106
106
|
`--repo-card` は「D1 へ起票 → `docs/records/NN-slug.md` の雛形 → `context_ref` の紐付け」を
|
|
107
107
|
1 コマンドで行う。**出力先は cwd 基準**である(git リポジトリの中で実行すること)。
|
|
108
|
+
記録ファイル名の slug は題名中の ASCII 英数字から作る。3文字未満の場合と、非ASCII文字を含む題名から
|
|
109
|
+
8文字未満の断片しか残らない場合は、3文字以上のkebab-caseによる `--slug <slug>` を必須とし、
|
|
110
|
+
D1へ起票する前にエラーで止める(例: `--slug project-detail-pc-layout`)。
|
|
108
111
|
|
|
109
112
|
| 実行場所 | 出力先 | `context_ref` |
|
|
110
113
|
| --- | --- | --- |
|
package/bin/hub.mjs
CHANGED
|
@@ -2,10 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
// `hub` コマンドの入口(記録147 / Astra High 1)。
|
|
4
4
|
//
|
|
5
|
-
// **ここには判定を置かない。**
|
|
6
|
-
// `
|
|
7
|
-
// `npm i -g` が張る symlink 経由だと `process.argv[1]` は symlink のパスのまま渡るので
|
|
8
|
-
// この比較が偽になり、**CLIが何も出さずに exit 0 で終わる**(実測: 実体パス447 byte / symlink 0 byte)。
|
|
5
|
+
// **ここには判定を置かない。** `import.meta.url` と `process.argv[1]` を比べる直接実行判定は、
|
|
6
|
+
// `npm i -g` が張る symlink 経由だと偽になり、CLIが何も出さずに exit 0 で終わる。
|
|
9
7
|
// realpath で解決して比べる直し方もあるが、bin を専用ファイルにすれば比較そのものが要らない。
|
|
10
8
|
// 本体(`lib/cli.mjs`)はライブラリとしてだけ読まれ、実行するのはこのファイルだけである。
|
|
11
9
|
|
package/commands/task-new.mjs
CHANGED
|
@@ -3,6 +3,7 @@ import { describeFailure } from "../lib/api.mjs";
|
|
|
3
3
|
import { taskLines } from "../lib/format.mjs";
|
|
4
4
|
import {
|
|
5
5
|
DEFAULT_RECORD_DIR,
|
|
6
|
+
requireRecordSlug,
|
|
6
7
|
resolveRecordTarget,
|
|
7
8
|
resolveTaskProject,
|
|
8
9
|
writeRepoRecord,
|
|
@@ -17,6 +18,9 @@ export const taskNewCommand = {
|
|
|
17
18
|
},
|
|
18
19
|
async run({ options, positional, flags, dependencies, api }) {
|
|
19
20
|
const title = requireSinglePositional(positional, "タイトル");
|
|
21
|
+
const recordSlug = flags["repo-card"]
|
|
22
|
+
? requireRecordSlug(options.slug ?? title, { explicit: options.slug !== undefined })
|
|
23
|
+
: null;
|
|
20
24
|
const target = flags["repo-card"]
|
|
21
25
|
? await resolveRecordTarget(options["repo-card"] || DEFAULT_RECORD_DIR, dependencies)
|
|
22
26
|
: null;
|
|
@@ -48,7 +52,7 @@ export const taskNewCommand = {
|
|
|
48
52
|
);
|
|
49
53
|
} else {
|
|
50
54
|
try {
|
|
51
|
-
record = await writeRepoRecord({ target, slug:
|
|
55
|
+
record = await writeRepoRecord({ target, slug: recordSlug, item, dependencies });
|
|
52
56
|
} catch (error) {
|
|
53
57
|
throw cliError(
|
|
54
58
|
`タスク ${item.id}「${item.title}」は作成済みですが、記録の生成に失敗しました: ${describeFailure(error)}`,
|
package/lib/args.mjs
CHANGED
|
@@ -39,6 +39,7 @@ show / claim / report / note の <id> には記録番号(150 / #150)も指
|
|
|
39
39
|
hub task new は「D1へ起票 → repoに記録の雛形を作成 → context_ref で紐付け」を1コマンドで行う。
|
|
40
40
|
記録には status / owner / priority を書かない(状態の正本はD1だけ)。
|
|
41
41
|
--repo-card はリポジトリ相対のディレクトリのみ。context_ref にはリポジトリルート相対のパスが入る。
|
|
42
|
+
--repo-card で題名からslugを作れない場合は、3文字以上のkebab-caseで --slug <slug> が必要(例: --slug project-detail-pc-layout)。
|
|
42
43
|
hub task audit は done のタスクの context_ref を git と突き合わせ、記録が未コミット・
|
|
43
44
|
未pushのまま done になっていないかを見る(「doneなのに本番に無い」の検出)。
|
|
44
45
|
-- 以降はすべて位置引数になる。-- で始まるタイトルは hub task new --project hub -- "--で始まる題" の順で渡す。
|
|
@@ -57,7 +58,6 @@ export const PROJECT_USAGE = `使い方:
|
|
|
57
58
|
[--remove-link "<ラベル>"]... [--remove-link-url <URL>]...
|
|
58
59
|
[--clear-links] [--json]
|
|
59
60
|
hub project move <slug> (--after <slug> | --top) [--json]
|
|
60
|
-
hub project sync-registry [--json]
|
|
61
61
|
|
|
62
62
|
create はslugを自動生成しない。既存に倣ってkebabの英字で指定する(例 pc-setup)。
|
|
63
63
|
move はピン留めしたプロジェクトの並び替え。--top で先頭、--after で指定slugの直後。
|
|
@@ -80,7 +80,7 @@ export const PROJECT_USAGE = `使い方:
|
|
|
80
80
|
export const USAGE = `使い方:
|
|
81
81
|
hub task <verb> ... タスク操作(new / add / claim / next / show / report / note / list)
|
|
82
82
|
hub task help
|
|
83
|
-
hub project <verb> ... プロジェクト操作(list / show / create / update / move
|
|
83
|
+
hub project <verb> ... プロジェクト操作(list / show / create / update / move)
|
|
84
84
|
hub project help
|
|
85
85
|
hub --version 入っているCLIの版を出す(hub version も同じ)
|
|
86
86
|
|
package/lib/cli.mjs
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
// hub CLI の本体(タスク52 / 指示書v4「CLIが唯一の実装」・記録147で
|
|
1
|
+
// hub CLI の本体(タスク52 / 指示書v4「CLIが唯一の実装」・記録147でnpm配布化)。
|
|
2
2
|
// エージェント・人間の双方がhubを操作する唯一の道具。スキルやMCPを足す場合も
|
|
3
3
|
// ここを呼ぶだけの薄いラッパにし、ロジックを二重に持たないこと。
|
|
4
4
|
//
|
|
5
|
-
// hub task <verb> ...
|
|
6
|
-
// hub project <verb> ... プロジェクト操作(読み取り +
|
|
5
|
+
// hub task <verb> ... タスク操作
|
|
6
|
+
// hub project <verb> ... プロジェクト操作(読み取り + 作成・更新)
|
|
7
7
|
//
|
|
8
8
|
// 全サブコマンドが `--json` を受け付け、付けると生のAPI応答をそのまま出力する。
|
|
9
9
|
//
|
|
@@ -33,7 +33,6 @@ import { projectCreateCommand } from "../commands/project-create.mjs";
|
|
|
33
33
|
import { projectListCommand } from "../commands/project-list.mjs";
|
|
34
34
|
import { projectMoveCommand } from "../commands/project-move.mjs";
|
|
35
35
|
import { projectShowCommand } from "../commands/project-show.mjs";
|
|
36
|
-
import { projectSyncRegistryCommand } from "../commands/project-sync-registry.mjs";
|
|
37
36
|
import { projectUpdateCommand } from "../commands/project-update.mjs";
|
|
38
37
|
import { taskAddCommand } from "../commands/task-add.mjs";
|
|
39
38
|
import { taskAuditCommand } from "../commands/task-audit.mjs";
|
|
@@ -48,7 +47,7 @@ import { defaultRunGit } from "./git.mjs";
|
|
|
48
47
|
|
|
49
48
|
export { configFromEnv, createHubApi } from "./api.mjs";
|
|
50
49
|
export { defaultEnvFilePath, parseEnvFile } from "./api.mjs";
|
|
51
|
-
export { projectLines
|
|
50
|
+
export { projectLines } from "./format.mjs";
|
|
52
51
|
export { auditDoneTasks, formatAuditReport, parseGitStatusPaths, readGitState } from "./git.mjs";
|
|
53
52
|
export {
|
|
54
53
|
DEFAULT_RECORD_DIR,
|
|
@@ -85,7 +84,6 @@ const COMMAND_GROUPS = {
|
|
|
85
84
|
projectListCommand,
|
|
86
85
|
projectMoveCommand,
|
|
87
86
|
projectShowCommand,
|
|
88
|
-
projectSyncRegistryCommand,
|
|
89
87
|
projectUpdateCommand,
|
|
90
88
|
]),
|
|
91
89
|
},
|
package/lib/format.mjs
CHANGED
|
@@ -158,34 +158,3 @@ function formatEventValue(value) {
|
|
|
158
158
|
if (typeof value === "boolean") return value ? "オン" : "オフ";
|
|
159
159
|
return String(value) || "なし";
|
|
160
160
|
}
|
|
161
|
-
|
|
162
|
-
const REGISTRY_STATUS = { active: "active", paused: "dormant", closed: "archived" };
|
|
163
|
-
const REGISTRY_HEADER = `# このファイルは hub の D1 \`projects\` から \`hub project sync-registry\` で生成した派生物。
|
|
164
|
-
# 正本はD1(指示書v4)。手で編集せず、hub側を直してから再生成すること。
|
|
165
|
-
#
|
|
166
|
-
# 注意: D1が持たない項目(client / ローカルrepoパス / obsidian / drive / aliases)は
|
|
167
|
-
# ここには出力されない。既存の project-registry.yml へ貼るときは、これらの行を消さずに
|
|
168
|
-
# slug単位でマージすること(全文置換は情報を落とす)。
|
|
169
|
-
`;
|
|
170
|
-
|
|
171
|
-
function yamlScalar(value) {
|
|
172
|
-
if (value === null || value === undefined || value === "") return "null";
|
|
173
|
-
const text = String(value);
|
|
174
|
-
return /^[\w./@-]+$/.test(text) ? text : JSON.stringify(text);
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
export function toRegistryYaml(items) {
|
|
178
|
-
const blocks = [...items]
|
|
179
|
-
.sort((a, b) => String(a.slug).localeCompare(String(b.slug)))
|
|
180
|
-
.map((item) => {
|
|
181
|
-
const lines = [
|
|
182
|
-
`- slug: ${yamlScalar(item.slug)}`,
|
|
183
|
-
` name: ${yamlScalar(item.name)}`,
|
|
184
|
-
` status: ${REGISTRY_STATUS[item.status] ?? item.status}`,
|
|
185
|
-
` github: ${yamlScalar(item.repo)}`,
|
|
186
|
-
];
|
|
187
|
-
if (item.note) lines.push(` note: ${yamlScalar(item.note)}`);
|
|
188
|
-
return lines.join("\n");
|
|
189
|
-
});
|
|
190
|
-
return `${REGISTRY_HEADER}\n${blocks.join("\n\n")}\n`;
|
|
191
|
-
}
|
package/lib/records.mjs
CHANGED
|
@@ -7,6 +7,12 @@ export const DEFAULT_RECORD_DIR = "docs/records";
|
|
|
7
7
|
export const NOTE_CHUNK_LIMIT = 2_000;
|
|
8
8
|
const NOTE_MARKER_RESERVE = 16;
|
|
9
9
|
const RECORD_NUMBER_ATTEMPTS = 5;
|
|
10
|
+
const MIN_RECORD_SLUG_LENGTH = 3;
|
|
11
|
+
const MIN_MIXED_TITLE_SLUG_LENGTH = 8;
|
|
12
|
+
const KEBAB_CASE_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
|
|
13
|
+
const RECORD_SLUG_ERROR =
|
|
14
|
+
"記録ファイル名のslugを決められません。3文字以上のkebab-caseで --slug <slug> を指定してください"
|
|
15
|
+
+ "(例: --slug project-detail-pc-layout)";
|
|
10
16
|
|
|
11
17
|
export function slugify(title) {
|
|
12
18
|
return String(title)
|
|
@@ -16,6 +22,25 @@ export function slugify(title) {
|
|
|
16
22
|
.slice(0, 60);
|
|
17
23
|
}
|
|
18
24
|
|
|
25
|
+
export function requireRecordSlug(value, { explicit = false } = {}) {
|
|
26
|
+
const source = String(value);
|
|
27
|
+
const slug = slugify(source);
|
|
28
|
+
if (explicit) {
|
|
29
|
+
if (source.length < MIN_RECORD_SLUG_LENGTH || !KEBAB_CASE_PATTERN.test(source)) {
|
|
30
|
+
throw cliError(RECORD_SLUG_ERROR);
|
|
31
|
+
}
|
|
32
|
+
return slug;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
// 多言語題名に残る短いASCIIは、PC/UI/APIのような偶発的な略語である可能性が高い。
|
|
36
|
+
const isShortFragmentFromMixedTitle = /[^\x00-\x7f]/u.test(source)
|
|
37
|
+
&& slug.length < MIN_MIXED_TITLE_SLUG_LENGTH;
|
|
38
|
+
if (slug.length < MIN_RECORD_SLUG_LENGTH || isShortFragmentFromMixedTitle) {
|
|
39
|
+
throw cliError(RECORD_SLUG_ERROR);
|
|
40
|
+
}
|
|
41
|
+
return slug;
|
|
42
|
+
}
|
|
43
|
+
|
|
19
44
|
export function nextRecordNumber(entries) {
|
|
20
45
|
const numbers = entries
|
|
21
46
|
.map((name) => /^(\d+)-/.exec(name)?.[1])
|
|
@@ -128,7 +153,8 @@ export async function writeRepoRecord({ target, slug, item, dependencies }) {
|
|
|
128
153
|
entries = [];
|
|
129
154
|
}
|
|
130
155
|
|
|
131
|
-
|
|
156
|
+
// task-new のPOST前に検証・正規化済みの slug を受け取る契約。ここでは再検証せず、起票後エラーへ化けさせない(呼び出し側が必ず requireRecordSlug を通す)。
|
|
157
|
+
const name = slug;
|
|
132
158
|
const content = recordTemplate({ taskId: item.id, title: item.title });
|
|
133
159
|
const first = Number.parseInt(nextRecordNumber(entries), 10);
|
|
134
160
|
let number = first;
|
package/package.json
CHANGED
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
import { usageError } from "../lib/args.mjs";
|
|
2
|
-
import { toRegistryYaml } from "../lib/format.mjs";
|
|
3
|
-
|
|
4
|
-
export const projectSyncRegistryCommand = {
|
|
5
|
-
name: "sync-registry",
|
|
6
|
-
options: {},
|
|
7
|
-
async run({ options, positional, dependencies, api }) {
|
|
8
|
-
if (positional.length !== 0) throw usageError("sync-registryに位置引数は指定できません");
|
|
9
|
-
const payload = await api("/api/projects");
|
|
10
|
-
const items = payload?.items ?? [];
|
|
11
|
-
if (options.json) {
|
|
12
|
-
dependencies.stdout.write(`${JSON.stringify({ items, yaml: toRegistryYaml(items) }, null, 2)}\n`);
|
|
13
|
-
return;
|
|
14
|
-
}
|
|
15
|
-
dependencies.stdout.write(toRegistryYaml(items));
|
|
16
|
-
},
|
|
17
|
-
};
|