@rch4com/agent-setup 1.10.0 → 1.11.1
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/LICENSE +21 -21
- package/README.md +199 -199
- package/install.mjs +163 -163
- package/lib/args.mjs +276 -276
- package/lib/bootstrap/adapter.mjs +96 -96
- package/lib/bootstrap/apply.mjs +380 -380
- package/lib/bootstrap/flow.mjs +140 -140
- package/lib/bootstrap/record.mjs +154 -154
- package/lib/bootstrap/templates.mjs +148 -148
- package/lib/bootstrap/text.mjs +19 -19
- package/lib/catalog.mjs +234 -234
- package/lib/claude-plugins.mjs +64 -64
- package/lib/clis.mjs +111 -111
- package/lib/context.mjs +66 -66
- package/lib/deps.mjs +17 -17
- package/lib/design-md/catalog.json +454 -454
- package/lib/design-md/catalog.mjs +266 -266
- package/lib/design-md/flow.mjs +192 -192
- package/lib/design-md/open.mjs +51 -51
- package/lib/design-md/providers/awesome-design-md.mjs +124 -124
- package/lib/design-md/providers/index.mjs +9 -9
- package/lib/design-md/scan.mjs +295 -295
- package/lib/engine.mjs +115 -115
- package/lib/gitignore.mjs +18 -18
- package/lib/i18n/catalog/en.mjs +431 -426
- package/lib/i18n/catalog/ko.mjs +416 -411
- package/lib/i18n/detect.mjs +39 -39
- package/lib/i18n/index.mjs +93 -93
- package/lib/items/mcp.codebase-memory.mjs +6 -6
- package/lib/items/mcp.notion.mjs +6 -6
- package/lib/items/mcp.supabase.mjs +6 -6
- package/lib/items/mcp.vercel.mjs +6 -6
- package/lib/items/plugin.bkit.mjs +5 -3
- package/lib/items/plugin.ecc.mjs +17 -2
- package/lib/items/plugin.mattpocock-skills.mjs +18 -8
- package/lib/items/plugin.ponytail.mjs +106 -104
- package/lib/items/plugin.superpowers.mjs +7 -4
- package/lib/items/plugin.understand-anything.mjs +13 -2
- package/lib/items/skill.diagram-design.mjs +14 -0
- package/lib/items/skill.gsd.mjs +46 -44
- package/lib/items/skill.gstack.mjs +54 -54
- package/lib/jsonfile.mjs +40 -40
- package/lib/status.mjs +93 -93
- package/lib/tomlfile.mjs +60 -60
- package/lib/tui/detail.mjs +127 -127
- package/lib/tui/progress.mjs +160 -160
- package/lib/tui/render.mjs +268 -268
- package/lib/tui/rows.mjs +317 -317
- package/lib/tui/run.mjs +396 -396
- package/lib/tui/state.mjs +249 -249
- package/lib/update.mjs +85 -85
- package/lib/width.mjs +115 -115
- package/package.json +36 -36
|
@@ -1,148 +1,148 @@
|
|
|
1
|
-
// setup-agents.ps1의 here-string 내용을 옮긴 단일 출처.
|
|
2
|
-
// 여기만 고치면 모든 OS가 같은 파일을 만든다.
|
|
3
|
-
|
|
4
|
-
export const AGENTS_TEMPLATE = `# Repository Instructions
|
|
5
|
-
|
|
6
|
-
## Scope
|
|
7
|
-
|
|
8
|
-
These instructions apply only to this repository.
|
|
9
|
-
|
|
10
|
-
## Required workflow
|
|
11
|
-
|
|
12
|
-
1. Inspect the relevant existing implementation before editing.
|
|
13
|
-
2. Make the smallest change that satisfies the requirement.
|
|
14
|
-
3. Add or update tests for behavior changes.
|
|
15
|
-
4. Run focused verification first, then the full repository checks.
|
|
16
|
-
5. Report anything that could not be verified.
|
|
17
|
-
|
|
18
|
-
## Repository commands
|
|
19
|
-
|
|
20
|
-
Document the actual commands used by this repository:
|
|
21
|
-
|
|
22
|
-
- Install:
|
|
23
|
-
- Build:
|
|
24
|
-
- Test:
|
|
25
|
-
- Lint:
|
|
26
|
-
- Full verification:
|
|
27
|
-
|
|
28
|
-
## Rules
|
|
29
|
-
|
|
30
|
-
- Do not modify files outside this repository.
|
|
31
|
-
- Do not add production dependencies without explicit approval.
|
|
32
|
-
- Do not edit generated files directly.
|
|
33
|
-
- Never commit credentials, access tokens, or connection strings.`
|
|
34
|
-
|
|
35
|
-
export const CLAUDE_BLOCK = `<!-- agent-kit:begin -->
|
|
36
|
-
@AGENTS.md
|
|
37
|
-
<!-- agent-kit:end -->`
|
|
38
|
-
|
|
39
|
-
export const GEMINI_BLOCK = `<!-- agent-kit:begin -->
|
|
40
|
-
@./AGENTS.md
|
|
41
|
-
<!-- agent-kit:end -->`
|
|
42
|
-
|
|
43
|
-
export const SKILL_README = `# Shared repository skills
|
|
44
|
-
|
|
45
|
-
Create each shared skill in:
|
|
46
|
-
|
|
47
|
-
\`.agents/skills/<skill-name>/SKILL.md\`
|
|
48
|
-
|
|
49
|
-
Use portable Agent Skills frontmatter:
|
|
50
|
-
|
|
51
|
-
\`\`\`yaml
|
|
52
|
-
---
|
|
53
|
-
name: example-skill
|
|
54
|
-
description: Explain when this skill should be used.
|
|
55
|
-
---
|
|
56
|
-
\`\`\`
|
|
57
|
-
|
|
58
|
-
Claude Code, Kiro, and Grok Build receive these skills through project-local
|
|
59
|
-
adapters at \`.claude/skills\`, \`.kiro/skills\`, and \`.grok/skills\`. Codex,
|
|
60
|
-
Gemini CLI, OpenCode, Kilo Code, Kimi Code, Antigravity, GitHub Copilot CLI,
|
|
61
|
-
and VS Code Copilot discover \`.agents/skills\` directly.`
|
|
62
|
-
|
|
63
|
-
export const EXAMPLE_SKILL = `---
|
|
64
|
-
name: repository-check
|
|
65
|
-
description: Verify repository changes by reviewing the diff and running the documented build, test, and lint commands. Use before reporting implementation work as complete.
|
|
66
|
-
---
|
|
67
|
-
|
|
68
|
-
# Repository check
|
|
69
|
-
|
|
70
|
-
1. Read \`AGENTS.md\`.
|
|
71
|
-
2. Review the complete working-tree diff.
|
|
72
|
-
3. Run the smallest relevant checks first.
|
|
73
|
-
4. Run the repository's documented full verification command.
|
|
74
|
-
5. Report failures, skipped checks, and remaining risks.`
|
|
75
|
-
|
|
76
|
-
export const AGENT_KIT_README = `# Repository-local agent setup
|
|
77
|
-
|
|
78
|
-
This directory documents files generated or used by the bootstrap scripts.
|
|
79
|
-
|
|
80
|
-
The installer bootstrap:
|
|
81
|
-
|
|
82
|
-
- finds the current Git repository root;
|
|
83
|
-
- refuses to write outside that repository;
|
|
84
|
-
- creates only project-scoped configuration;
|
|
85
|
-
- never writes to user-home or system-wide agent configuration;
|
|
86
|
-
- preserves existing configuration files;
|
|
87
|
-
- adds a small managed import block to \`CLAUDE.md\` and \`GEMINI.md\`;
|
|
88
|
-
- exposes \`.agents/skills\` to Claude Code, Kiro, and Grok Build through
|
|
89
|
-
local adapters;
|
|
90
|
-
- adds \`chat.useAgentsMdFile\` to \`.vscode/settings.json\` only when the key
|
|
91
|
-
is absent, so VS Code Copilot reads the shared \`AGENTS.md\`;
|
|
92
|
-
- relies on the native support of Kilo Code, Kimi Code, Antigravity, GitHub
|
|
93
|
-
Copilot CLI, and VS Code Copilot for \`AGENTS.md\` and \`.agents/skills\`.`
|
|
94
|
-
|
|
95
|
-
export const CLAUDE_SETTINGS = `{}`
|
|
96
|
-
|
|
97
|
-
export const CODEX_CONFIG = `# Repository-local Codex configuration.
|
|
98
|
-
# Personal or machine-wide defaults belong outside this repository.
|
|
99
|
-
project_doc_max_bytes = 65536`
|
|
100
|
-
|
|
101
|
-
export const GEMINI_SETTINGS = `{
|
|
102
|
-
"skills": {
|
|
103
|
-
"enabled": true
|
|
104
|
-
},
|
|
105
|
-
"security": {
|
|
106
|
-
"folderTrust": {
|
|
107
|
-
"enabled": true
|
|
108
|
-
},
|
|
109
|
-
"disableAlwaysAllow": true,
|
|
110
|
-
"enablePermanentToolApproval": false
|
|
111
|
-
}
|
|
112
|
-
}`
|
|
113
|
-
|
|
114
|
-
export const GROK_CONFIG = `# Repository-local Grok Build configuration.
|
|
115
|
-
# Project scope supports mcp_servers, plugins, and permission rules only.
|
|
116
|
-
# Personal or machine-wide defaults belong in ~/.grok/config.toml.
|
|
117
|
-
# Grok Build reads the root AGENTS.md natively.`
|
|
118
|
-
|
|
119
|
-
export const OPENCODE_CONFIG = `{
|
|
120
|
-
"$schema": "https://opencode.ai/config.json"
|
|
121
|
-
}`
|
|
122
|
-
|
|
123
|
-
export const KILO_CONFIG = `{
|
|
124
|
-
// Project-local Kilo Code configuration.
|
|
125
|
-
// Kilo Code automatically loads ./AGENTS.md and ./.agents/skills/.
|
|
126
|
-
}`
|
|
127
|
-
|
|
128
|
-
export const KIRO_MCP_CONFIG = `{
|
|
129
|
-
"mcpServers": {}
|
|
130
|
-
}`
|
|
131
|
-
|
|
132
|
-
export const KIMI_MCP_CONFIG = `{
|
|
133
|
-
"mcpServers": {}
|
|
134
|
-
}`
|
|
135
|
-
|
|
136
|
-
export const COPILOT_MCP_CONFIG = `{
|
|
137
|
-
"mcpServers": {}
|
|
138
|
-
}`
|
|
139
|
-
|
|
140
|
-
// 모델·추론 강도·컨텍스트 티어를 저장소 단위로 고정하는 공유 설정 자리.
|
|
141
|
-
// 구체적인 값은 팀이 정한다. 개인 오버라이드는 settings.local.json이며
|
|
142
|
-
// .gitignore 대상이다.
|
|
143
|
-
export const COPILOT_SETTINGS = `{}`
|
|
144
|
-
|
|
145
|
-
// VS Code는 최상위 키가 servers다 (Copilot CLI의 mcpServers와 다르다).
|
|
146
|
-
export const VSCODE_MCP_CONFIG = `{
|
|
147
|
-
"servers": {}
|
|
148
|
-
}`
|
|
1
|
+
// setup-agents.ps1의 here-string 내용을 옮긴 단일 출처.
|
|
2
|
+
// 여기만 고치면 모든 OS가 같은 파일을 만든다.
|
|
3
|
+
|
|
4
|
+
export const AGENTS_TEMPLATE = `# Repository Instructions
|
|
5
|
+
|
|
6
|
+
## Scope
|
|
7
|
+
|
|
8
|
+
These instructions apply only to this repository.
|
|
9
|
+
|
|
10
|
+
## Required workflow
|
|
11
|
+
|
|
12
|
+
1. Inspect the relevant existing implementation before editing.
|
|
13
|
+
2. Make the smallest change that satisfies the requirement.
|
|
14
|
+
3. Add or update tests for behavior changes.
|
|
15
|
+
4. Run focused verification first, then the full repository checks.
|
|
16
|
+
5. Report anything that could not be verified.
|
|
17
|
+
|
|
18
|
+
## Repository commands
|
|
19
|
+
|
|
20
|
+
Document the actual commands used by this repository:
|
|
21
|
+
|
|
22
|
+
- Install:
|
|
23
|
+
- Build:
|
|
24
|
+
- Test:
|
|
25
|
+
- Lint:
|
|
26
|
+
- Full verification:
|
|
27
|
+
|
|
28
|
+
## Rules
|
|
29
|
+
|
|
30
|
+
- Do not modify files outside this repository.
|
|
31
|
+
- Do not add production dependencies without explicit approval.
|
|
32
|
+
- Do not edit generated files directly.
|
|
33
|
+
- Never commit credentials, access tokens, or connection strings.`
|
|
34
|
+
|
|
35
|
+
export const CLAUDE_BLOCK = `<!-- agent-kit:begin -->
|
|
36
|
+
@AGENTS.md
|
|
37
|
+
<!-- agent-kit:end -->`
|
|
38
|
+
|
|
39
|
+
export const GEMINI_BLOCK = `<!-- agent-kit:begin -->
|
|
40
|
+
@./AGENTS.md
|
|
41
|
+
<!-- agent-kit:end -->`
|
|
42
|
+
|
|
43
|
+
export const SKILL_README = `# Shared repository skills
|
|
44
|
+
|
|
45
|
+
Create each shared skill in:
|
|
46
|
+
|
|
47
|
+
\`.agents/skills/<skill-name>/SKILL.md\`
|
|
48
|
+
|
|
49
|
+
Use portable Agent Skills frontmatter:
|
|
50
|
+
|
|
51
|
+
\`\`\`yaml
|
|
52
|
+
---
|
|
53
|
+
name: example-skill
|
|
54
|
+
description: Explain when this skill should be used.
|
|
55
|
+
---
|
|
56
|
+
\`\`\`
|
|
57
|
+
|
|
58
|
+
Claude Code, Kiro, and Grok Build receive these skills through project-local
|
|
59
|
+
adapters at \`.claude/skills\`, \`.kiro/skills\`, and \`.grok/skills\`. Codex,
|
|
60
|
+
Gemini CLI, OpenCode, Kilo Code, Kimi Code, Antigravity, GitHub Copilot CLI,
|
|
61
|
+
and VS Code Copilot discover \`.agents/skills\` directly.`
|
|
62
|
+
|
|
63
|
+
export const EXAMPLE_SKILL = `---
|
|
64
|
+
name: repository-check
|
|
65
|
+
description: Verify repository changes by reviewing the diff and running the documented build, test, and lint commands. Use before reporting implementation work as complete.
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
# Repository check
|
|
69
|
+
|
|
70
|
+
1. Read \`AGENTS.md\`.
|
|
71
|
+
2. Review the complete working-tree diff.
|
|
72
|
+
3. Run the smallest relevant checks first.
|
|
73
|
+
4. Run the repository's documented full verification command.
|
|
74
|
+
5. Report failures, skipped checks, and remaining risks.`
|
|
75
|
+
|
|
76
|
+
export const AGENT_KIT_README = `# Repository-local agent setup
|
|
77
|
+
|
|
78
|
+
This directory documents files generated or used by the bootstrap scripts.
|
|
79
|
+
|
|
80
|
+
The installer bootstrap:
|
|
81
|
+
|
|
82
|
+
- finds the current Git repository root;
|
|
83
|
+
- refuses to write outside that repository;
|
|
84
|
+
- creates only project-scoped configuration;
|
|
85
|
+
- never writes to user-home or system-wide agent configuration;
|
|
86
|
+
- preserves existing configuration files;
|
|
87
|
+
- adds a small managed import block to \`CLAUDE.md\` and \`GEMINI.md\`;
|
|
88
|
+
- exposes \`.agents/skills\` to Claude Code, Kiro, and Grok Build through
|
|
89
|
+
local adapters;
|
|
90
|
+
- adds \`chat.useAgentsMdFile\` to \`.vscode/settings.json\` only when the key
|
|
91
|
+
is absent, so VS Code Copilot reads the shared \`AGENTS.md\`;
|
|
92
|
+
- relies on the native support of Kilo Code, Kimi Code, Antigravity, GitHub
|
|
93
|
+
Copilot CLI, and VS Code Copilot for \`AGENTS.md\` and \`.agents/skills\`.`
|
|
94
|
+
|
|
95
|
+
export const CLAUDE_SETTINGS = `{}`
|
|
96
|
+
|
|
97
|
+
export const CODEX_CONFIG = `# Repository-local Codex configuration.
|
|
98
|
+
# Personal or machine-wide defaults belong outside this repository.
|
|
99
|
+
project_doc_max_bytes = 65536`
|
|
100
|
+
|
|
101
|
+
export const GEMINI_SETTINGS = `{
|
|
102
|
+
"skills": {
|
|
103
|
+
"enabled": true
|
|
104
|
+
},
|
|
105
|
+
"security": {
|
|
106
|
+
"folderTrust": {
|
|
107
|
+
"enabled": true
|
|
108
|
+
},
|
|
109
|
+
"disableAlwaysAllow": true,
|
|
110
|
+
"enablePermanentToolApproval": false
|
|
111
|
+
}
|
|
112
|
+
}`
|
|
113
|
+
|
|
114
|
+
export const GROK_CONFIG = `# Repository-local Grok Build configuration.
|
|
115
|
+
# Project scope supports mcp_servers, plugins, and permission rules only.
|
|
116
|
+
# Personal or machine-wide defaults belong in ~/.grok/config.toml.
|
|
117
|
+
# Grok Build reads the root AGENTS.md natively.`
|
|
118
|
+
|
|
119
|
+
export const OPENCODE_CONFIG = `{
|
|
120
|
+
"$schema": "https://opencode.ai/config.json"
|
|
121
|
+
}`
|
|
122
|
+
|
|
123
|
+
export const KILO_CONFIG = `{
|
|
124
|
+
// Project-local Kilo Code configuration.
|
|
125
|
+
// Kilo Code automatically loads ./AGENTS.md and ./.agents/skills/.
|
|
126
|
+
}`
|
|
127
|
+
|
|
128
|
+
export const KIRO_MCP_CONFIG = `{
|
|
129
|
+
"mcpServers": {}
|
|
130
|
+
}`
|
|
131
|
+
|
|
132
|
+
export const KIMI_MCP_CONFIG = `{
|
|
133
|
+
"mcpServers": {}
|
|
134
|
+
}`
|
|
135
|
+
|
|
136
|
+
export const COPILOT_MCP_CONFIG = `{
|
|
137
|
+
"mcpServers": {}
|
|
138
|
+
}`
|
|
139
|
+
|
|
140
|
+
// 모델·추론 강도·컨텍스트 티어를 저장소 단위로 고정하는 공유 설정 자리.
|
|
141
|
+
// 구체적인 값은 팀이 정한다. 개인 오버라이드는 settings.local.json이며
|
|
142
|
+
// .gitignore 대상이다.
|
|
143
|
+
export const COPILOT_SETTINGS = `{}`
|
|
144
|
+
|
|
145
|
+
// VS Code는 최상위 키가 servers다 (Copilot CLI의 mcpServers와 다르다).
|
|
146
|
+
export const VSCODE_MCP_CONFIG = `{
|
|
147
|
+
"servers": {}
|
|
148
|
+
}`
|
package/lib/bootstrap/text.mjs
CHANGED
|
@@ -1,19 +1,19 @@
|
|
|
1
|
-
// 정규화와 해시의 단일 출처.
|
|
2
|
-
//
|
|
3
|
-
// 파일을 쓸 때와 "우리가 쓴 그대로인가"를 판정할 때 같은 정규화를 써야 한다.
|
|
4
|
-
// 둘이 갈리면 갓 쓴 파일조차 드리프트로 보고된다. 그래서 이 모듈을 최하위에
|
|
5
|
-
// 두고 apply.mjs(쓰기)와 record.mjs(판정)가 함께 import한다 — 한쪽에만
|
|
6
|
-
// 정규화 규칙을 두면 두 모듈이 서로를 import하는 순환이 생긴다.
|
|
7
|
-
//
|
|
8
|
-
// 부트스트랩 그래프에 속하므로 node: 내장 모듈만 쓴다.
|
|
9
|
-
import { createHash } from 'node:crypto'
|
|
10
|
-
|
|
11
|
-
// 두 OS가 같은 파일을 만들도록 항상 LF + 끝 개행 1개로 정규화한다.
|
|
12
|
-
export function normalizeBody(text) {
|
|
13
|
-
return text.replace(/\r\n/g, '\n').trim() + '\n'
|
|
14
|
-
}
|
|
15
|
-
|
|
16
|
-
// 정규화한 내용의 해시. 워킹트리 줄바꿈이 CRLF든 LF든 같은 값이 나온다.
|
|
17
|
-
export function hashBody(text) {
|
|
18
|
-
return `sha256:${createHash('sha256').update(normalizeBody(text), 'utf8').digest('hex')}`
|
|
19
|
-
}
|
|
1
|
+
// 정규화와 해시의 단일 출처.
|
|
2
|
+
//
|
|
3
|
+
// 파일을 쓸 때와 "우리가 쓴 그대로인가"를 판정할 때 같은 정규화를 써야 한다.
|
|
4
|
+
// 둘이 갈리면 갓 쓴 파일조차 드리프트로 보고된다. 그래서 이 모듈을 최하위에
|
|
5
|
+
// 두고 apply.mjs(쓰기)와 record.mjs(판정)가 함께 import한다 — 한쪽에만
|
|
6
|
+
// 정규화 규칙을 두면 두 모듈이 서로를 import하는 순환이 생긴다.
|
|
7
|
+
//
|
|
8
|
+
// 부트스트랩 그래프에 속하므로 node: 내장 모듈만 쓴다.
|
|
9
|
+
import { createHash } from 'node:crypto'
|
|
10
|
+
|
|
11
|
+
// 두 OS가 같은 파일을 만들도록 항상 LF + 끝 개행 1개로 정규화한다.
|
|
12
|
+
export function normalizeBody(text) {
|
|
13
|
+
return text.replace(/\r\n/g, '\n').trim() + '\n'
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
// 정규화한 내용의 해시. 워킹트리 줄바꿈이 CRLF든 LF든 같은 값이 나온다.
|
|
17
|
+
export function hashBody(text) {
|
|
18
|
+
return `sha256:${createHash('sha256').update(normalizeBody(text), 'utf8').digest('hex')}`
|
|
19
|
+
}
|