@tamai/hub-cli 0.1.4 → 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 CHANGED
@@ -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
- // **ここには判定を置かない。** 旧 `tools/hub.mjs` は末尾で
6
- // `import.meta.url === pathToFileURL(process.argv[1]).href` を比べて「直接実行か」を決めていた。
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
 
@@ -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: options.slug, item, dependencies });
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 -- "--で始まる題" の順で渡す。
package/lib/cli.mjs CHANGED
@@ -1,8 +1,8 @@
1
- // hub CLI の本体(タスク52 / 指示書v4「CLIが唯一の実装」・記録147で `tools/hub.mjs` から移設)。
1
+ // hub CLI の本体(タスク52 / 指示書v4「CLIが唯一の実装」・記録147でnpm配布化)。
2
2
  // エージェント・人間の双方がhubを操作する唯一の道具。スキルやMCPを足す場合も
3
3
  // ここを呼ぶだけの薄いラッパにし、ロジックを二重に持たないこと。
4
4
  //
5
- // hub task <verb> ... タスク操作(旧 tools/task.mjs と同機能)
5
+ // hub task <verb> ... タスク操作
6
6
  // hub project <verb> ... プロジェクト操作(読み取り + 作成・更新)
7
7
  //
8
8
  // 全サブコマンドが `--json` を受け付け、付けると生のAPI応答をそのまま出力する。
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
- const name = slugify(slug ?? "") || slugify(item.title) || `task-${item.id.slice(-6).toLowerCase()}`;
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,6 +1,6 @@
1
1
  {
2
2
  "name": "@tamai/hub-cli",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "description": "CLI for the hub personal dashboard: D1-backed task board and project registry.",
5
5
  "type": "module",
6
6
  "license": "UNLICENSED",