@tjdals12/agent-bolt 1.4.0 → 1.5.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.
Files changed (86) hide show
  1. package/README.ko.md +86 -8
  2. package/README.md +86 -8
  3. package/dist/catalog/commands/catalog/new/new-guideline.d.ts.map +1 -1
  4. package/dist/catalog/commands/catalog/new/new-guideline.js +1 -0
  5. package/dist/catalog/commands/catalog/new/new-guideline.js.map +1 -1
  6. package/dist/catalog/commands/catalog/validate-catalog.d.ts.map +1 -1
  7. package/dist/catalog/commands/catalog/validate-catalog.js +20 -6
  8. package/dist/catalog/commands/catalog/validate-catalog.js.map +1 -1
  9. package/dist/catalog/commands/show-item.d.ts +6 -0
  10. package/dist/catalog/commands/show-item.d.ts.map +1 -1
  11. package/dist/catalog/commands/show-item.js +2 -1
  12. package/dist/catalog/commands/show-item.js.map +1 -1
  13. package/dist/catalog/commands/sync.d.ts +6 -2
  14. package/dist/catalog/commands/sync.d.ts.map +1 -1
  15. package/dist/catalog/commands/sync.js +29 -4
  16. package/dist/catalog/commands/sync.js.map +1 -1
  17. package/dist/catalog/config/schema.d.ts +20 -0
  18. package/dist/catalog/config/schema.d.ts.map +1 -1
  19. package/dist/catalog/config/schema.js +5 -0
  20. package/dist/catalog/config/schema.js.map +1 -1
  21. package/dist/catalog/content/item/find-detail.d.ts.map +1 -1
  22. package/dist/catalog/content/item/find-detail.js +1 -0
  23. package/dist/catalog/content/item/find-detail.js.map +1 -1
  24. package/dist/catalog/content/item/model.d.ts +2 -4
  25. package/dist/catalog/content/item/model.d.ts.map +1 -1
  26. package/dist/catalog/content/item/parse-summary.d.ts.map +1 -1
  27. package/dist/catalog/content/item/parse-summary.js +1 -0
  28. package/dist/catalog/content/item/parse-summary.js.map +1 -1
  29. package/dist/catalog/content/item/schema.d.ts +7 -0
  30. package/dist/catalog/content/item/schema.d.ts.map +1 -1
  31. package/dist/catalog/content/item/schema.js +2 -0
  32. package/dist/catalog/content/item/schema.js.map +1 -1
  33. package/dist/catalog/install/adapters/claude.adapter.d.ts.map +1 -1
  34. package/dist/catalog/install/adapters/claude.adapter.js +35 -6
  35. package/dist/catalog/install/adapters/claude.adapter.js.map +1 -1
  36. package/dist/catalog/install/adapters/codex.adapter.d.ts.map +1 -1
  37. package/dist/catalog/install/adapters/codex.adapter.js +22 -1
  38. package/dist/catalog/install/adapters/codex.adapter.js.map +1 -1
  39. package/dist/catalog/install/adapters/copilot.adapter.d.ts.map +1 -1
  40. package/dist/catalog/install/adapters/copilot.adapter.js +39 -3
  41. package/dist/catalog/install/adapters/copilot.adapter.js.map +1 -1
  42. package/dist/catalog/install/adapters/cursor.adapter.d.ts.map +1 -1
  43. package/dist/catalog/install/adapters/cursor.adapter.js +38 -11
  44. package/dist/catalog/install/adapters/cursor.adapter.js.map +1 -1
  45. package/dist/catalog/install/adapters/opencode.adapter.d.ts.map +1 -1
  46. package/dist/catalog/install/adapters/opencode.adapter.js +22 -1
  47. package/dist/catalog/install/adapters/opencode.adapter.js.map +1 -1
  48. package/dist/catalog/install/apply.d.ts.map +1 -1
  49. package/dist/catalog/install/apply.js +21 -1
  50. package/dist/catalog/install/apply.js.map +1 -1
  51. package/dist/catalog/install/diff.d.ts.map +1 -1
  52. package/dist/catalog/install/diff.js +18 -1
  53. package/dist/catalog/install/diff.js.map +1 -1
  54. package/dist/catalog/install/lockfile/items.d.ts +1 -1
  55. package/dist/catalog/install/lockfile/items.d.ts.map +1 -1
  56. package/dist/catalog/install/lockfile/items.js +16 -4
  57. package/dist/catalog/install/lockfile/items.js.map +1 -1
  58. package/dist/catalog/install/managed-block/group.d.ts.map +1 -1
  59. package/dist/catalog/install/managed-block/group.js +18 -1
  60. package/dist/catalog/install/managed-block/group.js.map +1 -1
  61. package/dist/catalog/install/managed-block/render.d.ts +1 -0
  62. package/dist/catalog/install/managed-block/render.d.ts.map +1 -1
  63. package/dist/catalog/install/managed-block/render.js +3 -0
  64. package/dist/catalog/install/managed-block/render.js.map +1 -1
  65. package/dist/catalog/install/model.d.ts +12 -0
  66. package/dist/catalog/install/model.d.ts.map +1 -1
  67. package/dist/catalog/install/plan.d.ts.map +1 -1
  68. package/dist/catalog/install/plan.js +58 -3
  69. package/dist/catalog/install/plan.js.map +1 -1
  70. package/dist/catalog/install/reference.d.ts +12 -0
  71. package/dist/catalog/install/reference.d.ts.map +1 -0
  72. package/dist/catalog/install/reference.js +47 -0
  73. package/dist/catalog/install/reference.js.map +1 -0
  74. package/dist/cli/views/catalog/new/new-guideline.d.ts.map +1 -1
  75. package/dist/cli/views/catalog/new/new-guideline.js +6 -1
  76. package/dist/cli/views/catalog/new/new-guideline.js.map +1 -1
  77. package/dist/cli/views/show-item.d.ts.map +1 -1
  78. package/dist/cli/views/show-item.js +14 -6
  79. package/dist/cli/views/show-item.js.map +1 -1
  80. package/dist/cli/views/sync.d.ts.map +1 -1
  81. package/dist/cli/views/sync.js +8 -2
  82. package/dist/cli/views/sync.js.map +1 -1
  83. package/package.json +1 -1
  84. package/skills/agent-bolt/SKILL.md +24 -10
  85. package/skills/agent-bolt/references/catalog-config-schema.md +13 -3
  86. package/skills/agent-bolt/references/json-responses.md +19 -3
package/README.ko.md CHANGED
@@ -72,15 +72,15 @@ Run `agent-bolt sync` to update it.
72
72
 
73
73
  AgentBolt는 각 아이템을 대상 에이전트가 기대하는 위치에 설치합니다.
74
74
 
75
- | 에이전트 | `--tools` | 스킬 | 서브 에이전트 | 가이드라인 |
76
- | -------------- | ---------- | ------------------- | ------------------- | ----------------------- |
77
- | Claude Code | `claude` | `.claude/skills/` | `.claude/agents/` | `.claude/rules/` |
78
- | Codex | `codex` | `.codex/skills/` | `.codex/agents/` | `AGENTS.md` (관리 블록) |
79
- | Cursor | `cursor` | `.cursor/skills/` | `.cursor/agents/` | `.cursor/rules/` |
80
- | GitHub Copilot | `copilot` | `.github/skills/` | `.github/agents/` | `.github/instructions/` |
81
- | OpenCode | `opencode` | `.opencode/skills/` | `.opencode/agents/` | `AGENTS.md` (관리 블록) |
75
+ | 에이전트 | `--tools` | 스킬 | 서브 에이전트 | 가이드라인 |
76
+ | -------------- | ---------- | ------------------- | ------------------- | --------------------------------- |
77
+ | Claude Code | `claude` | `.claude/skills/` | `.claude/agents/` | `CLAUDE.md` |
78
+ | Codex | `codex` | `.codex/skills/` | `.codex/agents/` | `AGENTS.md` (관리 블록) |
79
+ | Cursor | `cursor` | `.cursor/skills/` | `.cursor/agents/` | `AGENTS.md` |
80
+ | GitHub Copilot | `copilot` | `.github/skills/` | `.github/agents/` | `.github/copilot-instructions.md` |
81
+ | OpenCode | `opencode` | `.opencode/skills/` | `.opencode/agents/` | `AGENTS.md` (관리 블록) |
82
82
 
83
- Codex와 OpenCode는 같은 `AGENTS.md`를 읽기 때문에, 둘 다 사용하면 두 에이전트의 가이드라인이 그 한 파일의 관리 블록에 함께 담깁니다.
83
+ Codex와 OpenCode, Cursor는 같은 `AGENTS.md`를 읽기 때문에, 함께 사용하면 각 에이전트의 가이드라인이 그 한 파일의 관리 블록에 함께 담깁니다.
84
84
 
85
85
  ## 시작하기
86
86
 
@@ -456,6 +456,80 @@ location: .
456
456
  ...
457
457
  ```
458
458
 
459
+ 각 아이템은 JSON 메타데이터 파일과 Markdown 본문으로 구성됩니다. 메타데이터에는 아이템의 이름·설명·본문 경로와 타입별 설정을 작성합니다.
460
+
461
+ **스킬 — `skill.json`**
462
+
463
+ ```jsonc
464
+ {
465
+ // 아이템 식별자 (아이템 디렉터리명과 같은 kebab-case)
466
+ "name": "create-commit",
467
+ // 아이템 설명
468
+ "description": "커밋 메시지 작성과 커밋 실행",
469
+ // 본문 파일 경로 (아이템 디렉터리 기준)
470
+ "instructions": "./instructions.md",
471
+ // 선택: 함께 설치할 파일·디렉터리. 생략하면 []
472
+ "assets": ["references/"],
473
+ // 선택: 각 에이전트의 설치 파일에 반영할 추가 설정
474
+ "toolConfig": {
475
+ "claude": {
476
+ "disable-model-invocation": true,
477
+ },
478
+ },
479
+ }
480
+ ```
481
+
482
+ **서브 에이전트 — `agent.json`**
483
+
484
+ ```jsonc
485
+ {
486
+ // 아이템 식별자 (아이템 디렉터리명과 같은 kebab-case)
487
+ "name": "code-reviewer",
488
+ // 아이템 설명
489
+ "description": "코드 품질과 유지보수성 검토",
490
+ // 본문 파일 경로 (아이템 디렉터리 기준)
491
+ "instructions": "./prompt.md",
492
+ // 선택: 각 에이전트의 설치 파일에 반영할 추가 설정
493
+ "toolConfig": {
494
+ "claude": {
495
+ "model": "opus",
496
+ },
497
+ },
498
+ }
499
+ ```
500
+
501
+ **가이드라인 — `guideline.json`**
502
+
503
+ ```jsonc
504
+ {
505
+ // 아이템 식별자 (아이템 디렉터리명과 같은 kebab-case)
506
+ "name": "commit-rules",
507
+ // 카탈로그 탐색용 설명
508
+ "description": "커밋 메시지 작성 규칙",
509
+ // 본문 파일 경로 (아이템 디렉터리 기준)
510
+ "body": "./content.md",
511
+ // 지침 파일에 가이드라인 링크와 함께 삽입할 문구
512
+ // recommended.load가 reference이면 필수
513
+ "usage": "커밋 메시지를 작성하기 전에 읽고 따르세요.",
514
+ // 기본값으로 사용되는 권장 설치 설정
515
+ "recommended": {
516
+ // 본문을 지침 파일에 직접 삽입합니다.
517
+ "load": "always",
518
+
519
+ // 본문을 별도 파일로 설치하고 지침 파일에 링크와 usage를 기록합니다.
520
+ "load": "reference",
521
+ // 설치 디렉터리 (프로젝트 루트 기준)
522
+ "path": "docs/guidelines",
523
+
524
+ // glob 패턴에 해당하는 파일을 작업할 때 적용합니다.
525
+ // Claude, Cursor, Copilot에서 권장합니다.
526
+ "load": "conditional",
527
+ // 적용할 파일 패턴
528
+ "glob": ["src/**/*.ts"],
529
+ },
530
+ }
531
+ ```
532
+
459
533
  ### 카탈로그 검증하기
460
534
 
461
535
  `catalog validate`로 카탈로그를 검사합니다. 매니페스트가 스키마에 맞는지, 본문과 에셋 파일이 모두 있는지, 이름과 디렉터리가 일치하는지 등을 확인합니다.
@@ -535,6 +609,10 @@ packs:
535
609
  # always: 항상 적용
536
610
  commit-rules:
537
611
  load: always
612
+ # reference: 필요할 때 참조
613
+ review-guidelines:
614
+ load: reference
615
+ path: docs/guidelines
538
616
  # conditional: glob 패턴의 파일에만 적용
539
617
  react-conventions:
540
618
  load: conditional
package/README.md CHANGED
@@ -72,15 +72,15 @@ If the instructions file (e.g. `AGENTS.md`) doesn't exist yet, AgentBolt creates
72
72
 
73
73
  AgentBolt installs each item into the location its target agent expects.
74
74
 
75
- | Agent | `--tools` | Skills | Subagents | Guidelines |
76
- | -------------- | ---------- | ------------------- | ------------------- | --------------------------- |
77
- | Claude Code | `claude` | `.claude/skills/` | `.claude/agents/` | `.claude/rules/` |
78
- | Codex | `codex` | `.codex/skills/` | `.codex/agents/` | `AGENTS.md` (managed block) |
79
- | Cursor | `cursor` | `.cursor/skills/` | `.cursor/agents/` | `.cursor/rules/` |
80
- | GitHub Copilot | `copilot` | `.github/skills/` | `.github/agents/` | `.github/instructions/` |
81
- | OpenCode | `opencode` | `.opencode/skills/` | `.opencode/agents/` | `AGENTS.md` (managed block) |
75
+ | Agent | `--tools` | Skills | Subagents | Guidelines |
76
+ | -------------- | ---------- | ------------------- | ------------------- | --------------------------------- |
77
+ | Claude Code | `claude` | `.claude/skills/` | `.claude/agents/` | `CLAUDE.md` |
78
+ | Codex | `codex` | `.codex/skills/` | `.codex/agents/` | `AGENTS.md` (managed block) |
79
+ | Cursor | `cursor` | `.cursor/skills/` | `.cursor/agents/` | `AGENTS.md` |
80
+ | GitHub Copilot | `copilot` | `.github/skills/` | `.github/agents/` | `.github/copilot-instructions.md` |
81
+ | OpenCode | `opencode` | `.opencode/skills/` | `.opencode/agents/` | `AGENTS.md` (managed block) |
82
82
 
83
- Codex and OpenCode both read the shared `AGENTS.md`, so enabling both puts their guidelines in a single managed block in that one file.
83
+ Codex, OpenCode, and Cursor all read the shared `AGENTS.md`, so enabling them together puts their guidelines in a single managed block in that one file.
84
84
 
85
85
  ## Getting started
86
86
 
@@ -456,6 +456,80 @@ location: .
456
456
  ...
457
457
  ```
458
458
 
459
+ Each item consists of a JSON metadata file and a Markdown body. The metadata defines its name, description, body path, and type-specific settings.
460
+
461
+ **Skill — `skill.json`**
462
+
463
+ ```jsonc
464
+ {
465
+ // item identifier (kebab-case, matching the item directory name)
466
+ "name": "create-commit",
467
+ // item description
468
+ "description": "Write commit messages and create commits",
469
+ // body file path (relative to the item directory)
470
+ "instructions": "./instructions.md",
471
+ // optional: files and directories to install alongside the body. Defaults to []
472
+ "assets": ["references/"],
473
+ // optional: additional settings to include in each agent's installed file
474
+ "toolConfig": {
475
+ "claude": {
476
+ "disable-model-invocation": true,
477
+ },
478
+ },
479
+ }
480
+ ```
481
+
482
+ **Subagent — `agent.json`**
483
+
484
+ ```jsonc
485
+ {
486
+ // item identifier (kebab-case, matching the item directory name)
487
+ "name": "code-reviewer",
488
+ // item description
489
+ "description": "Review code quality and maintainability",
490
+ // body file path (relative to the item directory)
491
+ "instructions": "./prompt.md",
492
+ // optional: additional settings to include in each agent's installed file
493
+ "toolConfig": {
494
+ "claude": {
495
+ "model": "opus",
496
+ },
497
+ },
498
+ }
499
+ ```
500
+
501
+ **Guideline — `guideline.json`**
502
+
503
+ ```jsonc
504
+ {
505
+ // item identifier (kebab-case, matching the item directory name)
506
+ "name": "commit-rules",
507
+ // description for browsing the catalog
508
+ "description": "Commit message conventions",
509
+ // body file path (relative to the item directory)
510
+ "body": "./content.md",
511
+ // text to insert alongside the guideline link in the instructions file
512
+ // required when recommended.load is reference
513
+ "usage": "Read and follow these guidelines before writing a commit message.",
514
+ // recommended installation settings used as defaults
515
+ "recommended": {
516
+ // insert the body directly into the instructions file.
517
+ "load": "always",
518
+
519
+ // install the body as a separate file and add a link and usage to the instructions file.
520
+ "load": "reference",
521
+ // installation directory (relative to the project root)
522
+ "path": "docs/guidelines",
523
+
524
+ // apply when working on files matching the glob patterns.
525
+ // Recommended for Claude, Cursor, and Copilot.
526
+ "load": "conditional",
527
+ // file patterns to match
528
+ "glob": ["src/**/*.ts"],
529
+ },
530
+ }
531
+ ```
532
+
459
533
  ### Validate the catalog
460
534
 
461
535
  Use `catalog validate` to check the catalog — that manifests match the schema, that body and asset files are all present, that names line up with their directories, and so on.
@@ -535,6 +609,10 @@ packs:
535
609
  # always: applied at all times
536
610
  commit-rules:
537
611
  load: always
612
+ # reference: consulted when needed
613
+ review-guidelines:
614
+ load: reference
615
+ path: docs/guidelines
538
616
  # conditional: applied only to files matching the glob
539
617
  react-conventions:
540
618
  load: conditional
@@ -1 +1 @@
1
- {"version":3,"file":"new-guideline.d.ts","sourceRoot":"","sources":["../../../../../src/catalog/commands/catalog/new/new-guideline.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9D,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,UAAmB,KAAK,EAAE,QAAQ,CAYhC;CACH"}
1
+ {"version":3,"file":"new-guideline.d.ts","sourceRoot":"","sources":["../../../../../src/catalog/commands/catalog/new/new-guideline.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9D,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,UAAmB,KAAK,EAAE,QAAQ,CAahC;CACH"}
@@ -9,6 +9,7 @@ export class NewGuidelineCommand extends NewItemCommand {
9
9
  buildManifest: ({ name, description, bodyRef }) => ({
10
10
  name,
11
11
  description,
12
+ usage: 'TODO: describe when to read this guideline',
12
13
  body: bodyRef,
13
14
  recommended: { load: 'always' },
14
15
  }),
@@ -1 +1 @@
1
- {"version":3,"file":"new-guideline.js","sourceRoot":"","sources":["../../../../../src/catalog/commands/catalog/new/new-guideline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAC;AAE9D,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAClC,KAAK,GAAa;QACnC,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,2BAA2B;QAC7C,cAAc,EAAE,uBAAuB;QACvC,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI;YACJ,WAAW;YACX,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAChC,CAAC;QACF,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE,0BAA0B;KACxC,CAAC;CACH"}
1
+ {"version":3,"file":"new-guideline.js","sourceRoot":"","sources":["../../../../../src/catalog/commands/catalog/new/new-guideline.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAC;AAE9D,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IAClC,KAAK,GAAa;QACnC,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,2BAA2B;QAC7C,cAAc,EAAE,uBAAuB;QACvC,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI;YACJ,WAAW;YACX,KAAK,EAAE,4CAA4C;YACnD,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAChC,CAAC;QACF,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE,0BAA0B;KACxC,CAAC;CACH"}
@@ -1 +1 @@
1
- {"version":3,"file":"validate-catalog.d.ts","sourceRoot":"","sources":["../../../../src/catalog/commands/catalog/validate-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAmBtF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC,CAAC;AAEF,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,qBAAqB,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IA4D/F,MAAM,CAAC,MAAM,EAAE;QAAE,qBAAqB,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;;;;;;IAWjF,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,aAAa;CAkEtB"}
1
+ {"version":3,"file":"validate-catalog.d.ts","sourceRoot":"","sources":["../../../../src/catalog/commands/catalog/validate-catalog.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,QAAQ,EAEd,MAAM,gCAAgC,CAAC;AAmBxC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,eAAe,EAAE,CAAC;CACrC,CAAC;AAEF,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG;QAAE,qBAAqB,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IA4D/F,MAAM,CAAC,MAAM,EAAE;QAAE,qBAAqB,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;;;;;;IAWjF,OAAO,CAAC,YAAY;IAkDpB,OAAO,CAAC,aAAa;CAiFtB"}
@@ -1,6 +1,6 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
- import { ITEM_TYPES } from '#catalog/content/item/model.js';
3
+ import { ITEM_TYPES, } from '#catalog/content/item/model.js';
4
4
  import { AGENTS_DIR_NAME, CATALOG_MANIFEST_FILENAME, GUIDELINES_DIR_NAME, PACKS_DIR_NAME, SKILLS_DIR_NAME, } from '#catalog/content/schema.js';
5
5
  import { loadCatalog } from '#catalog/content/load.js';
6
6
  import { listPackDirs, parsePackSummary } from '#catalog/content/pack/parse.js';
@@ -118,22 +118,18 @@ export class ValidateCatalogCommand {
118
118
  const packName = path.basename(packDir);
119
119
  let typeDir;
120
120
  let manifestFileName;
121
- let findItem;
122
121
  switch (itemType) {
123
122
  case 'skills':
124
123
  typeDir = path.join(packDir, SKILLS_DIR_NAME);
125
124
  manifestFileName = SKILL_MANIFEST_FILENAME;
126
- findItem = findSkill;
127
125
  break;
128
126
  case 'agents':
129
127
  typeDir = path.join(packDir, AGENTS_DIR_NAME);
130
128
  manifestFileName = AGENT_MANIFEST_FILENAME;
131
- findItem = findAgent;
132
129
  break;
133
130
  case 'guidelines':
134
131
  typeDir = path.join(packDir, GUIDELINES_DIR_NAME);
135
132
  manifestFileName = GUIDELINE_MANIFEST_FILENAME;
136
- findItem = findGuideline;
137
133
  break;
138
134
  }
139
135
  const itemDirs = listItemDirs(typeDir);
@@ -142,7 +138,25 @@ export class ValidateCatalogCommand {
142
138
  for (const itemDir of itemDirs) {
143
139
  const itemName = path.basename(itemDir);
144
140
  try {
145
- const item = findItem(catalogDir, packName, itemName);
141
+ let item;
142
+ if (itemType === 'guidelines') {
143
+ item = findGuideline(catalogDir, packName, itemName);
144
+ if (item !== null) {
145
+ if (item.recommended.load === 'reference' && item.usage === undefined) {
146
+ itemValidationIssues.push({
147
+ severity: 'error',
148
+ location: path.relative(catalogDir, path.join(itemDir, manifestFileName)),
149
+ message: "Missing required field 'usage' for recommended.load 'reference'.\nDescribe when an agent should read this guideline.",
150
+ });
151
+ }
152
+ }
153
+ }
154
+ else if (itemType === 'skills') {
155
+ item = findSkill(catalogDir, packName, itemName);
156
+ }
157
+ else {
158
+ item = findAgent(catalogDir, packName, itemName);
159
+ }
146
160
  if (item === null) {
147
161
  itemValidationIssues.push({
148
162
  severity: 'error',
@@ -1 +1 @@
1
- {"version":3,"file":"validate-catalog.js","sourceRoot":"","sources":["../../../../src/catalog/commands/catalog/validate-catalog.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"validate-catalog.js","sourceRoot":"","sources":["../../../../src/catalog/commands/catalog/validate-catalog.ts"],"names":[],"mappings":"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"}
@@ -37,6 +37,7 @@ export declare class ShowItemCommand {
37
37
  name: string;
38
38
  path: string;
39
39
  }[];
40
+ usage?: undefined;
40
41
  recommended?: undefined;
41
42
  body?: undefined;
42
43
  bodyPath?: undefined;
@@ -48,6 +49,7 @@ export declare class ShowItemCommand {
48
49
  instructions: string;
49
50
  instructionsPath: string;
50
51
  assets?: undefined;
52
+ usage?: undefined;
51
53
  recommended?: undefined;
52
54
  body?: undefined;
53
55
  bodyPath?: undefined;
@@ -55,11 +57,15 @@ export declare class ShowItemCommand {
55
57
  type: string;
56
58
  name: string;
57
59
  description: string;
60
+ usage: string | undefined;
58
61
  recommended: {
59
62
  load: "always";
60
63
  } | {
61
64
  load: "conditional";
62
65
  glob: string[];
66
+ } | {
67
+ load: "reference";
68
+ path: string;
63
69
  };
64
70
  body: string;
65
71
  bodyPath: string;
@@ -1 +1 @@
1
- {"version":3,"file":"show-item.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/show-item.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAQxF,MAAM,MAAM,SAAS,GAAG;KACrB,CAAC,IAAI,QAAQ,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;QAAC,UAAU,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC;CAC1F,CAAC,QAAQ,CAAC,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAMnE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IA6D5C,MAAM,CAAC,MAAM,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuD9B"}
1
+ {"version":3,"file":"show-item.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/show-item.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAQxF,MAAM,MAAM,SAAS,GAAG;KACrB,CAAC,IAAI,QAAQ,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;QAAC,UAAU,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC;CAC1F,CAAC,QAAQ,CAAC,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAMnE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IA6D5C,MAAM,CAAC,MAAM,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwD9B"}
@@ -91,11 +91,12 @@ export class ShowItemCommand {
91
91
  };
92
92
  }
93
93
  case 'guidelines': {
94
- const { name, description, recommended, body, bodyPath } = item;
94
+ const { name, description, usage, recommended, body, bodyPath } = item;
95
95
  return {
96
96
  type: 'guideline',
97
97
  name,
98
98
  description,
99
+ usage,
99
100
  recommended,
100
101
  body,
101
102
  bodyPath,
@@ -1 +1 @@
1
- {"version":3,"file":"show-item.js","sourceRoot":"","sources":["../../../src/catalog/commands/show-item.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"show-item.js","sourceRoot":"","sources":["../../../src/catalog/commands/show-item.ts"],"names":[],"mappings":"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"}
@@ -9,7 +9,10 @@ export type ToolSyncResult = {
9
9
  };
10
10
  changes: SyncChange[];
11
11
  };
12
- export type SyncResult = ToolSyncResult[];
12
+ export type SyncResult = {
13
+ toolSyncResults: ToolSyncResult[];
14
+ warnings: string[];
15
+ };
13
16
  export declare class SyncCommand {
14
17
  execute(projectPath: string): SyncResult;
15
18
  toJson(result: SyncResult): {
@@ -22,7 +25,8 @@ export declare class SyncCommand {
22
25
  };
23
26
  changes: SyncChange[];
24
27
  }[];
28
+ warnings: string[];
25
29
  };
26
- private buildSyncResult;
30
+ private buildToolSyncResults;
27
31
  }
28
32
  //# sourceMappingURL=sync.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/sync.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAuB,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;AAE1C,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU;IAYxC,MAAM,CAAC,MAAM,EAAE,UAAU;;;;wBAtBf,MAAM;wBACN,MAAM;4BACF,MAAM;;;;;IA0BpB,OAAO,CAAC,eAAe;CAiBxB"}
1
+ {"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/catalog/commands/sync.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAuB,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU;IAoCxC,MAAM,CAAC,MAAM,EAAE,UAAU;;;;wBAjDf,MAAM;wBACN,MAAM;4BACF,MAAM;;;;;;IAuDpB,OAAO,CAAC,oBAAoB;CAiB7B"}
@@ -1,5 +1,6 @@
1
1
  import { buildCatalogConfigPath } from '#core/paths.js';
2
2
  import { loadConfig } from '#catalog/config/load.js';
3
+ import { DEFAULT_GUIDELINE_USAGE } from '#catalog/install/reference.js';
3
4
  import { computePlan } from '#catalog/install/plan.js';
4
5
  import { applyPlan } from '#catalog/install/apply.js';
5
6
  export class SyncCommand {
@@ -7,16 +8,40 @@ export class SyncCommand {
7
8
  const configPath = buildCatalogConfigPath(projectPath);
8
9
  const config = loadConfig(configPath);
9
10
  const toolPlans = computePlan(projectPath, config);
11
+ const warnings = [];
12
+ const checkedGuidelineIds = new Set();
13
+ for (const { renderedGuidelines } of toolPlans) {
14
+ for (const { kind, sourceAlias, packName, guidelineName, usage } of renderedGuidelines) {
15
+ if (kind !== 'reference-file')
16
+ continue;
17
+ if (usage !== undefined)
18
+ continue;
19
+ const guidelineId = `${sourceAlias}/${packName}/${guidelineName}`;
20
+ if (checkedGuidelineIds.has(guidelineId))
21
+ continue;
22
+ checkedGuidelineIds.add(guidelineId);
23
+ warnings.push([
24
+ `Guideline '${guidelineId}' is missing usage.`,
25
+ '',
26
+ ` Using fallback text: "${DEFAULT_GUIDELINE_USAGE}"`,
27
+ '',
28
+ ' Set usage in .agent-bolt/catalog-config.yml to customize this text:',
29
+ ` packs.${sourceAlias}.${packName}.guidelines.${guidelineName}.usage`,
30
+ ].join('\n'));
31
+ }
32
+ }
10
33
  const changeSet = applyPlan(projectPath, toolPlans);
11
- const syncResult = this.buildSyncResult(toolPlans, changeSet);
12
- return syncResult;
34
+ const toolSyncResults = this.buildToolSyncResults(toolPlans, changeSet);
35
+ return { toolSyncResults, warnings };
13
36
  }
14
37
  toJson(result) {
38
+ const { toolSyncResults, warnings } = result;
15
39
  return {
16
- tools: result.map(({ tool, counts, changes }) => ({ tool, counts, changes })),
40
+ tools: toolSyncResults.map(({ tool, counts, changes }) => ({ tool, counts, changes })),
41
+ warnings,
17
42
  };
18
43
  }
19
- buildSyncResult(toolPlans, changeSet) {
44
+ buildToolSyncResults(toolPlans, changeSet) {
20
45
  return toolPlans.map((toolPlan) => {
21
46
  const { tool, renderedSkills, renderedAgents, renderedGuidelines } = toolPlan;
22
47
  const counts = {
@@ -1 +1 @@
1
- {"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/catalog/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAgBtD,MAAM,OAAO,WAAW;IACtB,OAAO,CAAC,WAAmB;QACzB,MAAM,UAAU,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEpD,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE9D,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,MAAkB;QACvB,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;SAC9E,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,SAAqB,EAAE,SAAoB;QACjE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,QAAQ,CAAC;YAC9E,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,UAAU,EAAE,kBAAkB,CAAC,MAAM;aACtC,CAAC;YACF,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAEtC,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,OAAO;aACR,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
1
+ {"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/catalog/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAmBtD,MAAM,OAAO,WAAW;IACtB,OAAO,CAAC,WAAmB;QACzB,MAAM,UAAU,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QAEtC,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9C,KAAK,MAAM,EAAE,kBAAkB,EAAE,IAAI,SAAS,EAAE,CAAC;YAC/C,KAAK,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,kBAAkB,EAAE,CAAC;gBACvF,IAAI,IAAI,KAAK,gBAAgB;oBAAE,SAAS;gBACxC,IAAI,KAAK,KAAK,SAAS;oBAAE,SAAS;gBAElC,MAAM,WAAW,GAAG,GAAG,WAAW,IAAI,QAAQ,IAAI,aAAa,EAAE,CAAC;gBAClE,IAAI,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC;oBAAE,SAAS;gBAEnD,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAErC,QAAQ,CAAC,IAAI,CACX;oBACE,cAAc,WAAW,qBAAqB;oBAC9C,EAAE;oBACF,2BAA2B,uBAAuB,GAAG;oBACrD,EAAE;oBACF,uEAAuE;oBACvE,aAAa,WAAW,IAAI,QAAQ,eAAe,aAAa,QAAQ;iBACzE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;YACJ,CAAC;QACH,CAAC;QACD,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEpD,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAExE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,MAAkB;QACvB,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC7C,OAAO;YACL,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YACtF,QAAQ;SACT,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,SAAqB,EAAE,SAAoB;QACtE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,QAAQ,CAAC;YAC9E,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,UAAU,EAAE,kBAAkB,CAAC,MAAM;aACtC,CAAC;YACF,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAEtC,OAAO;gBACL,IAAI;gBACJ,MAAM;gBACN,OAAO;aACR,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -5,6 +5,10 @@ export declare const GuidelineSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObj
5
5
  }, z.core.$strip>, z.ZodObject<{
6
6
  load: z.ZodLiteral<"conditional">;
7
7
  glob: z.ZodArray<z.ZodString>;
8
+ }, z.core.$strip>, z.ZodObject<{
9
+ load: z.ZodLiteral<"reference">;
10
+ path: z.ZodString;
11
+ usage: z.ZodOptional<z.ZodString>;
8
12
  }, z.core.$strip>], "load">;
9
13
  export declare const PackSelectionSchema: z.ZodObject<{
10
14
  skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -14,6 +18,10 @@ export declare const PackSelectionSchema: z.ZodObject<{
14
18
  }, z.core.$strip>, z.ZodObject<{
15
19
  load: z.ZodLiteral<"conditional">;
16
20
  glob: z.ZodArray<z.ZodString>;
21
+ }, z.core.$strip>, z.ZodObject<{
22
+ load: z.ZodLiteral<"reference">;
23
+ path: z.ZodString;
24
+ usage: z.ZodOptional<z.ZodString>;
17
25
  }, z.core.$strip>], "load">>>;
18
26
  }, z.core.$strip>;
19
27
  export declare const SourcesSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -33,6 +41,10 @@ export declare const SourcePacksSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
33
41
  }, z.core.$strip>, z.ZodObject<{
34
42
  load: z.ZodLiteral<"conditional">;
35
43
  glob: z.ZodArray<z.ZodString>;
44
+ }, z.core.$strip>, z.ZodObject<{
45
+ load: z.ZodLiteral<"reference">;
46
+ path: z.ZodString;
47
+ usage: z.ZodOptional<z.ZodString>;
36
48
  }, z.core.$strip>], "load">>>;
37
49
  }, z.core.$strip>>;
38
50
  export declare const PacksSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -43,6 +55,10 @@ export declare const PacksSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodStri
43
55
  }, z.core.$strip>, z.ZodObject<{
44
56
  load: z.ZodLiteral<"conditional">;
45
57
  glob: z.ZodArray<z.ZodString>;
58
+ }, z.core.$strip>, z.ZodObject<{
59
+ load: z.ZodLiteral<"reference">;
60
+ path: z.ZodString;
61
+ usage: z.ZodOptional<z.ZodString>;
46
62
  }, z.core.$strip>], "load">>>;
47
63
  }, z.core.$strip>>>;
48
64
  export declare const ConfigSchema: z.ZodObject<{
@@ -71,6 +87,10 @@ export declare const ConfigSchema: z.ZodObject<{
71
87
  }, z.core.$strip>, z.ZodObject<{
72
88
  load: z.ZodLiteral<"conditional">;
73
89
  glob: z.ZodArray<z.ZodString>;
90
+ }, z.core.$strip>, z.ZodObject<{
91
+ load: z.ZodLiteral<"reference">;
92
+ path: z.ZodString;
93
+ usage: z.ZodOptional<z.ZodString>;
74
94
  }, z.core.$strip>], "load">>>;
75
95
  }, z.core.$strip>>>>;
76
96
  }, z.core.$strip>;
@@ -1 +1 @@
1
- {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/catalog/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,IAAI,CAAC;AAOhC,eAAO,MAAM,wBAAwB;;;;;2BAGnC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;4BAAqC,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;kBAA4C,CAAC;AAE3E,eAAO,MAAM,WAAW;;;;;;;;;mBAA0C,CAAC;AAEnE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQvB,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/catalog/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc,IAAI,CAAC;AAOhC,eAAO,MAAM,wBAAwB;;;;;;;;;2BAQnC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;4BAAqC,CAAC;AAEhE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;kBAA4C,CAAC;AAE3E,eAAO,MAAM,WAAW;;;;;;;;;;;;;mBAA0C,CAAC;AAEnE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQvB,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}
@@ -9,6 +9,11 @@ const NameSchema = z
9
9
  export const GuidelineSelectionSchema = z.discriminatedUnion('load', [
10
10
  z.object({ load: z.literal('always') }),
11
11
  z.object({ load: z.literal('conditional'), glob: z.array(z.string()).min(1) }),
12
+ z.object({
13
+ load: z.literal('reference'),
14
+ path: z.string().trim().min(1),
15
+ usage: z.string().min(1).optional(),
16
+ }),
12
17
  ]);
13
18
  export const PackSelectionSchema = z.object({
14
19
  skills: z.array(NameSchema).default([]),
@@ -1 +1 @@
1
- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/catalog/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAClD,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,KAAK,CAAC,YAAY,EAAE,uEAAuE,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,WAAW,EAAE,yBAAyB;QACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;KACjE,CAAC;IACF,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC;IAC7F,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/B,CAAC,CAAC"}
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/catalog/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAClD,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,KAAK,CAAC,YAAY,EAAE,uEAAuE,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;QAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KACpC,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,WAAW,EAAE,yBAAyB;QACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;KACjE,CAAC;IACF,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC;IAC7F,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/B,CAAC,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"find-detail.d.ts","sourceRoot":"","sources":["../../../../src/catalog/content/item/find-detail.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQ1D,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAyC/F;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAyB/F;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,SAAS,GAAG,IAAI,CA+BlB"}
1
+ {"version":3,"file":"find-detail.d.ts","sourceRoot":"","sources":["../../../../src/catalog/content/item/find-detail.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAQ1D,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAyC/F;AAED,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAyB/F;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,SAAS,GAAG,IAAI,CAgClB"}
@@ -86,6 +86,7 @@ export function findGuideline(catalogDir, packName, guidelineName) {
86
86
  name: manifest.name,
87
87
  description: manifest.description,
88
88
  recommended: manifest.recommended,
89
+ usage: manifest.usage,
89
90
  body,
90
91
  bodyPath,
91
92
  };