@tjdals12/agent-bolt 1.1.0 → 1.2.0-next.2

package/README.ko.md

@@ -192,18 +192,22 @@ $ agent-bolt add-pack --source=common --packs=common
 ...
 ```
 
+`--packs`를 빼면 이름을 입력하는 대신 패키지를 목록에서 골라 추가합니다. `--source`까지 빼면 완전 대화형으로 동작해, 카탈로그를 고르고 그 패키지를 선택한 뒤 다른 카탈로그로 옮겨 가며 계속 추가할 수 있습니다. `remove-pack`도 같은 방식으로 패키지를 삭제합니다.
+
 `add-item`으로 패키지에서 특정 아이템만 추가합니다.
 
 ```text
 $ agent-bolt add-item --source=common --pack=backend --skills=nestjs-expert
 
 ▌ Agent Bolt: Added 1 item to common/backend
-  (created pack backend in common)
+  (added new pack 'backend' in source 'common')
 
   + 🔧 nestjs-expert
 ...
 ```
 
+아이템 옵션을 빼면 아이템을 목록에서 골라 추가합니다. `--pack`까지 빼면 팩을 먼저 고르고, `--source`까지 빼면 완전 대화형으로 동작해 소스와 팩을 오가며 계속 추가할 수 있습니다.
+
 `remove-pack`·`remove-item`으로 추가한 패키지·아이템을 삭제합니다.
 
 ```text
@@ -215,6 +219,8 @@ $ agent-bolt remove-item --source=common --pack=common --skills=pr-review
 ...
 ```
 
+아이템 옵션을 빼면 아이템을 목록에서 골라 제거합니다. `--pack`까지 빼면 팩을 먼저 고르고, `--source`까지 빼면 완전 대화형으로 동작해 소스와 팩을 오가며 계속 제거할 수 있습니다.
+
 이 명령들은 설정 파일을 바꿀 뿐입니다. 실제 설치는 `sync`에서 이루어집니다.
 
 ### 에이전트에 설치하기
@@ -546,58 +552,66 @@ agent-bolt show-item --source <alias> --pack <name> --item <name> [options]
 패키지 전체를 설정에 추가합니다.
 
 ```text
-agent-bolt add-pack --source <alias> --packs <list>
+agent-bolt add-pack [--source <alias>] [--packs <list>]
 ```
 
-| 옵션               | 설명                            | 필수/선택 | 기본값 |
-| ------------------ | ------------------------------- | --------- | ------ |
-| `--source <alias>` | 대상 카탈로그                   | 필수      | —      |
-| `--packs <list>`   | 추가할 패키지 이름. 콤마로 구분 | 필수      | —      |
+| 옵션               | 설명                            | 필수/선택 | 기본값      |
+| ------------------ | ------------------------------- | --------- | ----------- |
+| `--source <alias>` | 대상 카탈로그                   | 선택      | 대화형 선택 |
+| `--packs <list>`   | 추가할 패키지 이름. 콤마로 구분 | 선택      | 대화형 선택 |
+
+`--packs`를 생략하면 패키지를 대화형으로 고르고, `--source`까지 생략하면 카탈로그를 먼저 고른 뒤 여러 source를 오가며 반복합니다. `--packs`는 `--source`와 함께 써야 합니다.
 
 ### `agent-bolt add-item`
 
 특정 아이템만 설정에 추가합니다. 패키지 항목이 없으면 만들어 둡니다.
 
 ```text
-agent-bolt add-item --source <alias> --pack <name> [options]
+agent-bolt add-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| 옵션                  | 설명                                   | 필수/선택 | 기본값 |
-| --------------------- | -------------------------------------- | --------- | ------ |
-| `--source <alias>`    | 대상 카탈로그                          | 필수      | —      |
-| `--pack <name>`       | 대상 패키지                            | 필수      | —      |
-| `--skills <list>`     | 추가할 스킬 이름. 콤마로 구분          | 선택      | —      |
-| `--agents <list>`     | 추가할 서브 에이전트 이름. 콤마로 구분 | 선택      | —      |
-| `--guidelines <list>` | 추가할 가이드라인 이름. 콤마로 구분    | 선택      | —      |
+| 옵션                  | 설명                                   | 필수/선택 | 기본값      |
+| --------------------- | -------------------------------------- | --------- | ----------- |
+| `--source <alias>`    | 대상 카탈로그                          | 선택      | 대화형 선택 |
+| `--pack <name>`       | 대상 패키지                            | 선택      | 대화형 선택 |
+| `--skills <list>`     | 추가할 스킬 이름. 콤마로 구분          | 선택      | —           |
+| `--agents <list>`     | 추가할 서브 에이전트 이름. 콤마로 구분 | 선택      | —           |
+| `--guidelines <list>` | 추가할 가이드라인 이름. 콤마로 구분    | 선택      | —           |
+
+아이템 옵션을 생략하면 아이템을 대화형으로 고르고, `--pack`까지 생략하면 팩을 먼저 고르며, `--source`까지 생략하면 여러 source를 오가며 반복합니다. `--pack`은 `--source`와, 아이템 옵션은 `--pack`과 함께 써야 합니다.
 
 ### `agent-bolt remove-pack`
 
 설정에서 패키지 전체를 제거합니다.
 
 ```text
-agent-bolt remove-pack --source <alias> --packs <list>
+agent-bolt remove-pack [--source <alias>] [--packs <list>]
 ```
 
-| 옵션               | 설명                            | 필수/선택 | 기본값 |
-| ------------------ | ------------------------------- | --------- | ------ |
-| `--source <alias>` | 대상 카탈로그                   | 필수      | —      |
-| `--packs <list>`   | 제거할 패키지 이름. 콤마로 구분 | 필수      | —      |
+| 옵션               | 설명                            | 필수/선택 | 기본값      |
+| ------------------ | ------------------------------- | --------- | ----------- |
+| `--source <alias>` | 대상 카탈로그                   | 선택      | 대화형 선택 |
+| `--packs <list>`   | 제거할 패키지 이름. 콤마로 구분 | 선택      | 대화형 선택 |
+
+`--packs`를 생략하면 패키지를 대화형으로 고르고, `--source`까지 생략하면 카탈로그를 먼저 고른 뒤 여러 source를 오가며 반복합니다. `--packs`는 `--source`와 함께 써야 합니다.
 
 ### `agent-bolt remove-item`
 
 설정에서 특정 아이템을 제거합니다.
 
 ```text
-agent-bolt remove-item --source <alias> --pack <name> [options]
+agent-bolt remove-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| 옵션                  | 설명                                   | 필수/선택 | 기본값 |
-| --------------------- | -------------------------------------- | --------- | ------ |
-| `--source <alias>`    | 대상 카탈로그                          | 필수      | —      |
-| `--pack <name>`       | 대상 패키지                            | 필수      | —      |
-| `--skills <list>`     | 제거할 스킬 이름. 콤마로 구분          | 선택      | —      |
-| `--agents <list>`     | 제거할 서브 에이전트 이름. 콤마로 구분 | 선택      | —      |
-| `--guidelines <list>` | 제거할 가이드라인 이름. 콤마로 구분    | 선택      | —      |
+| 옵션                  | 설명                                   | 필수/선택 | 기본값      |
+| --------------------- | -------------------------------------- | --------- | ----------- |
+| `--source <alias>`    | 대상 카탈로그                          | 선택      | 대화형 선택 |
+| `--pack <name>`       | 대상 패키지                            | 선택      | 대화형 선택 |
+| `--skills <list>`     | 제거할 스킬 이름. 콤마로 구분          | 선택      | —           |
+| `--agents <list>`     | 제거할 서브 에이전트 이름. 콤마로 구분 | 선택      | —           |
+| `--guidelines <list>` | 제거할 가이드라인 이름. 콤마로 구분    | 선택      | —           |
+
+아이템 옵션을 생략하면 아이템을 대화형으로 고르고, `--pack`까지 생략하면 팩을 먼저 고르며, `--source`까지 생략하면 여러 source를 오가며 반복합니다. `--pack`은 `--source`와, 아이템 옵션은 `--pack`과 함께 써야 합니다.
 
 ### `agent-bolt sync`
 

package/README.md

@@ -192,18 +192,22 @@ $ agent-bolt add-pack --source=common --packs=common
 ...
 ```
 
+Omit `--packs` to pick packages from a checklist instead of typing their names. Omit `--source` too and `add-pack` goes fully interactive: choose a catalog, pick its packages, then keep going with another catalog until you're done. `remove-pack` works the same way for dropping packages.
+
 Use `add-item` to add just specific items from a package.
 
 ```text
 $ agent-bolt add-item --source=common --pack=backend --skills=nestjs-expert
 
 ▌ Agent Bolt: Added 1 item to common/backend
-  (created pack backend in common)
+  (added new pack 'backend' in source 'common')
 
   + 🔧 nestjs-expert
 ...
 ```
 
+Omit the item options to pick items from a checklist. Omit `--pack` too and `add-item` picks a pack first; omit `--source` as well and it goes fully interactive, looping over sources and packs until you're done.
+
 Use `remove-pack` and `remove-item` to drop packages or items you've added.
 
 ```text
@@ -215,6 +219,8 @@ $ agent-bolt remove-item --source=common --pack=common --skills=pr-review
 ...
 ```
 
+Omit the item options to pick items from a checklist. Omit `--pack` too and `remove-item` picks a pack first; omit `--source` as well and it goes fully interactive, looping over sources and packs until you're done.
+
 These commands only edit your config file. The actual installation happens with `sync`.
 
 ### Install into your agents
@@ -546,58 +552,66 @@ agent-bolt show-item --source <alias> --pack <name> --item <name> [options]
 Adds an entire package to your config.
 
 ```text
-agent-bolt add-pack --source <alias> --packs <list>
+agent-bolt add-pack [--source <alias>] [--packs <list>]
 ```
 
-| Option             | Description                               | Required | Default |
-| ------------------ | ----------------------------------------- | -------- | ------- |
-| `--source <alias>` | Target catalog                            | Required | —       |
-| `--packs <list>`   | Names of packages to add. Comma-separated | Required | —       |
+| Option             | Description                               | Required | Default            |
+| ------------------ | ----------------------------------------- | -------- | ------------------ |
+| `--source <alias>` | Target catalog                            | Optional | Interactive prompt |
+| `--packs <list>`   | Names of packages to add. Comma-separated | Optional | Interactive prompt |
+
+Omitting `--packs` picks packages interactively; omitting `--source` as well picks the catalog first and then loops over sources. `--packs` requires `--source`.
 
 ### `agent-bolt add-item`
 
 Adds specific items to your config. Creates the package entry if it doesn't exist yet.
 
 ```text
-agent-bolt add-item --source <alias> --pack <name> [options]
+agent-bolt add-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| Option                | Description                                 | Required | Default |
-| --------------------- | ------------------------------------------- | -------- | ------- |
-| `--source <alias>`    | Target catalog                              | Required | —       |
-| `--pack <name>`       | Target package                              | Required | —       |
-| `--skills <list>`     | Names of skills to add. Comma-separated     | Optional | —       |
-| `--agents <list>`     | Names of subagents to add. Comma-separated  | Optional | —       |
-| `--guidelines <list>` | Names of guidelines to add. Comma-separated | Optional | —       |
+| Option                | Description                                 | Required | Default            |
+| --------------------- | ------------------------------------------- | -------- | ------------------ |
+| `--source <alias>`    | Target catalog                              | Optional | Interactive prompt |
+| `--pack <name>`       | Target package                              | Optional | Interactive prompt |
+| `--skills <list>`     | Names of skills to add. Comma-separated     | Optional | —                  |
+| `--agents <list>`     | Names of subagents to add. Comma-separated  | Optional | —                  |
+| `--guidelines <list>` | Names of guidelines to add. Comma-separated | Optional | —                  |
+
+Omitting the item options picks items interactively; omitting `--pack` too picks a pack first; omitting `--source` as well loops over sources. `--pack` requires `--source`, and the item options require `--pack`.
 
 ### `agent-bolt remove-pack`
 
 Removes an entire package from your config.
 
 ```text
-agent-bolt remove-pack --source <alias> --packs <list>
+agent-bolt remove-pack [--source <alias>] [--packs <list>]
 ```
 
-| Option             | Description                                  | Required | Default |
-| ------------------ | -------------------------------------------- | -------- | ------- |
-| `--source <alias>` | Target catalog                               | Required | —       |
-| `--packs <list>`   | Names of packages to remove. Comma-separated | Required | —       |
+| Option             | Description                                  | Required | Default            |
+| ------------------ | -------------------------------------------- | -------- | ------------------ |
+| `--source <alias>` | Target catalog                               | Optional | Interactive prompt |
+| `--packs <list>`   | Names of packages to remove. Comma-separated | Optional | Interactive prompt |
+
+Omitting `--packs` picks packages interactively; omitting `--source` as well picks the catalog first and then loops over sources. `--packs` requires `--source`.
 
 ### `agent-bolt remove-item`
 
 Removes specific items from your config.
 
 ```text
-agent-bolt remove-item --source <alias> --pack <name> [options]
+agent-bolt remove-item [--source <alias>] [--pack <name>] [options]
 ```
 
-| Option                | Description                                    | Required | Default |
-| --------------------- | ---------------------------------------------- | -------- | ------- |
-| `--source <alias>`    | Target catalog                                 | Required | —       |
-| `--pack <name>`       | Target package                                 | Required | —       |
-| `--skills <list>`     | Names of skills to remove. Comma-separated     | Optional | —       |
-| `--agents <list>`     | Names of subagents to remove. Comma-separated  | Optional | —       |
-| `--guidelines <list>` | Names of guidelines to remove. Comma-separated | Optional | —       |
+| Option                | Description                                    | Required | Default            |
+| --------------------- | ---------------------------------------------- | -------- | ------------------ |
+| `--source <alias>`    | Target catalog                                 | Optional | Interactive prompt |
+| `--pack <name>`       | Target package                                 | Optional | Interactive prompt |
+| `--skills <list>`     | Names of skills to remove. Comma-separated     | Optional | —                  |
+| `--agents <list>`     | Names of subagents to remove. Comma-separated  | Optional | —                  |
+| `--guidelines <list>` | Names of guidelines to remove. Comma-separated | Optional | —                  |
+
+Omitting the item options picks items interactively; omitting `--pack` too picks a pack first; omitting `--source` as well loops over sources. `--pack` requires `--source`, and the item options require `--pack`.
 
 ### `agent-bolt sync`
 

package/dist/catalog/commands/add-item.d.ts

@@ -1,25 +1,41 @@
 import { type ItemType } from '#catalog/content/item/model.js';
-export type AddItemResult = {
-    sourceAlias: string;
+import type { ProgressReporter } from '#core/progress.js';
+export type AddedItemPack = {
     packName: string;
     packCreated: boolean;
     addedItems: Record<ItemType, string[]>;
     skippedItems: Record<ItemType, string[]>;
 };
+export type AddedItemSourceResult = {
+    sourceAlias: string;
+    packs: AddedItemPack[];
+};
+export type AddItemResult = {
+    results: AddedItemSourceResult[];
+    failures: string[];
+};
 export declare class AddItemCommand {
-    private readonly _source;
-    private readonly _pack;
+    private readonly _source?;
+    private readonly _pack?;
     private readonly _skills?;
     private readonly _agents?;
     private readonly _guidelines?;
     constructor(options: {
-        source: string;
-        pack: string;
+        source?: string;
+        pack?: string;
         skills?: string;
         agents?: string;
         guidelines?: string;
     });
-    execute(projectPath: string): AddItemResult;
+    execute(projectPath: string, reporter: ProgressReporter): Promise<AddItemResult>;
+    private addItemsFromSource;
+    private mergePackInto;
+    private addItemsToPack;
+    private resolveCatalogDetail;
+    private promptSourceSelection;
+    private promptPackSelection;
+    private promptItemSelection;
+    private countAddedItems;
     private parseItemNames;
 }
 //# sourceMappingURL=add-item.d.ts.map

package/dist/catalog/commands/add-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-item.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/add-item.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAG3E,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAE1B,OAAO,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAQD,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa;IAwI3C,OAAO,CAAC,cAAc;CAQvB"}
+{"version":3,"file":"add-item.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/add-item.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;gBAE1B,OAAO,EAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAQK,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;YA0GxE,kBAAkB;IA2EhC,OAAO,CAAC,aAAa;YAcP,cAAc;IA2H5B,OAAO,CAAC,oBAAoB;YAwBd,qBAAqB;YA6BrB,mBAAmB;YAkCnB,mBAAmB;IAgFjC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,cAAc;CAQvB"}