leerness 1.9.264 → 1.9.266
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/CHANGELOG.md +44 -0
- package/README.md +3 -3
- package/bin/harness.js +260 -4
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,49 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.9.266 — 2026-06-01 — UR-0021 2단계: dispatch 슬래시 명령 자동 주입 + handoff 노출 + MCP 73
|
|
4
|
+
|
|
5
|
+
**🤖 서브에이전트 dispatch/handoff 에 각 에이전트 슬래시 명령을 자동 노출 — "알맞은 슬래시 명령으로 작업" (사용자 명시 UR-0021 2단계).**
|
|
6
|
+
|
|
7
|
+
### 배경
|
|
8
|
+
1단계(1.9.265)에서 레지스트리·CLI·`_agentSlashHint` 헬퍼를 구축. 2단계는 사용자 요구 핵심 — "서브에이전트 호출 시 각 에이전트에 알맞는 슬래시 명령이 적절히 사용" — 을 실제 dispatch 경로 + 세션 시작(handoff)에 연결.
|
|
9
|
+
|
|
10
|
+
### 구현
|
|
11
|
+
1. **`agents dispatch <task> --to <id>` 슬래시 힌트 주입** — 실행 명령 아래에 대상 에이전트 슬래시 명령 노출 (subcommand 타입은 "하위명령" 라벨).
|
|
12
|
+
2. **`agents multi` 슬래시 힌트** — 각 에이전트 명령마다 `🤖 슬래시: ...` 한 줄 + `--json` 에 `slashCommands` 필드 (`{ <id>: { invoke, commands[] } }`).
|
|
13
|
+
3. **handoff 본문 활성 에이전트 슬래시 섹션** — env flag(`LEERNESS_ENABLE_*`) 활성 에이전트별 슬래시 명령 요약. **spawn 없이 env 점검만** (handoff 속도 보존, 오버헤드 측정값 ~0). 활성 0이면 미노출.
|
|
14
|
+
4. **MCP 73번째 도구 `leerness_slash_commands`** — 외부 AI(메인)가 sub-agent 호출 전 각 에이전트 슬래시 명령 회수. 인자 `{ path?, agent? }`.
|
|
15
|
+
5. **grok 범위 메모**: grok 은 슬래시 레지스트리에 포함(CLI/MCP/hint 조회 가능)되나, 아직 `EXTERNAL_AGENTS` 정식 provider 는 아님 → dispatch/handoff 활성 목록은 claude/codex/agy/copilot/ollama 기준. grok 정식 provider 승격(install 흐름 1~5 선택지 확장 포함)은 별도 후속 task.
|
|
16
|
+
|
|
17
|
+
### stress-v211 — **21/21 PASS · 100%**
|
|
18
|
+
- 1.9.266 (8): MCP 73·handoff 노출/비노출·MCP round-trip(grok/전체)·dispatch·multi·json 주입 경로·hint
|
|
19
|
+
- 성능 (2): cold start + handoff 활성 섹션 오버헤드 측정(WITH−WITHOUT delta, ~0)
|
|
20
|
+
- 누적 회귀 (11): 1.9.207~265 (slash-commands CLI·레지스트리·record·shellGuard JSON·handoff 12필드·selftest 17·require.main·agy/gemini·ps5-chain·_isSecretKey·CJK)
|
|
21
|
+
|
|
22
|
+
## 1.9.265 — 2026-06-01 — UR-0021 1단계: CLI 에이전트 슬래시 명령어 레지스트리 (claude/codex/agy/grok/copilot)
|
|
23
|
+
|
|
24
|
+
**🤖 각 CLI AI 에이전트의 슬래시 명령어를 큐레이션·기록하고, 서브에이전트 호출 시 알맞게 참조 (사용자 명시 UR-0021 1단계).**
|
|
25
|
+
|
|
26
|
+
### 배경
|
|
27
|
+
codex/agy/claude/grok 등 CLI 로 구동되는 AI 에이전트는 각자 다른 슬래시 명령(`/init`, `/compact`, `/diff` …)을 쓴다. 서브에이전트로 dispatch 할 때 각 에이전트에 맞는 슬래시 명령을 알맞게 써야 작업이 제대로 된다. 이를 위해 명령어를 항상 최신화·기록하는 레지스트리가 필요. (review-request: ✓ 진행 안전 / reuse: 기존 레지스트리 없음 — 신규)
|
|
28
|
+
|
|
29
|
+
### 구현 (1단계 — 레지스트리 + CLI + dispatch 헬퍼)
|
|
30
|
+
1. **`AGENT_SLASH_COMMANDS` 빌트인 레지스트리** — claude(13)/codex(10)/agy(6)/**grok(6)**/copilot(3). 각 명령 `{cmd, desc}` + `asOf` 버전 + `invoke`(slash|subcommand) + `note`.
|
|
31
|
+
- **Grok CLI** 사용자 명시 반영 (`/help /clear /model /new /login /exit`)
|
|
32
|
+
- copilot 은 슬래시가 아닌 `gh copilot <sub>` 하위명령 → `invoke: 'subcommand'` 라벨
|
|
33
|
+
2. **항상 최신화 3중 경로**: (1) 빌트인은 릴리스마다 갱신(`asOf`), (2) 사용자 `.harness/agent-slash-commands.json` override 병합(기존 agent 명령 교체 + 신규 agent 추가), (3) [2~3단계 예정] CLI `--help` probe 자동 refresh.
|
|
34
|
+
3. **`leerness slash-commands [agent]` CLI**: 전체/단일 목록 · `--json` · `--record`(워크스페이스 기록) · `--detect`(설치된 CLI 표시) · 별칭 `slash`/`agent-slash`.
|
|
35
|
+
4. **`_agentSlashHint(root, agentId)` 헬퍼 export** — 서브에이전트 dispatch 시 주입할 1줄 요약 + 명령 배열 (2단계에서 agents multi/agent 가 활용).
|
|
36
|
+
5. **selftest 2종 추가** (15→17): 레지스트리 5종 보유 + hint 요약/하위명령 라벨.
|
|
37
|
+
|
|
38
|
+
### 2~3단계 예정
|
|
39
|
+
- 2단계: `agents multi`/`agent` dispatch 시 대상 에이전트 슬래시 명령 자동 주입 + handoff 노출
|
|
40
|
+
- 3단계: 설치된 CLI 의 `--help`/`/help` 를 probe 해 레지스트리 자동 refresh
|
|
41
|
+
|
|
42
|
+
### stress-v210 — **26/26 PASS · 100%**
|
|
43
|
+
- 1.9.265 (13): 레지스트리 5종·grok·load/merge(builtin/user/신규)·record·hint·copilot subcommand·CLI list/json/record/unknown
|
|
44
|
+
- 성능 (2): cold start avg 370ms · load 100회 4ms
|
|
45
|
+
- 누적 회귀 (11): 1.9.207~264 (selftest 17·shellGuard JSON·handoff 12필드·MCP 72·shell-guard·require.main·agy/gemini·CJK·_isSecretKey·path-setup)
|
|
46
|
+
|
|
3
47
|
## 1.9.264 — 2026-06-01 — shellGuard JSON 12번째 통합 필드 (handoff/session close/health) + session close 본문 셸 요약
|
|
4
48
|
|
|
5
49
|
**🐚 UR-0020 셸 실패 메모리를 `--json` 표면 3 명령에 일관되게 통합 — 외부 AI/자동화가 셸 호환성 상태를 구조적으로 소비.**
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> **AI 코딩 에이전트의 거짓 완료·중복·망각·충돌을 막아주는 검수·기억·협업 CLI 하네스.**
|
|
4
4
|
|
|
5
|
-
[](https://www.npmjs.com/package/leerness) [](https://www.npmjs.com/package/leerness) []() []() []() []() []() []() []() []() []() []() []() []()
|
|
6
6
|
|
|
7
7
|
```
|
|
8
8
|
╔══════════════════════════════════════════════════════════════╗
|
|
@@ -12,9 +12,9 @@
|
|
|
12
12
|
║ ██║ ██╔══╝ ██╔══╝ ██╔══██╗██║╚██╗██║██╔══╝ ╚════██║ ║
|
|
13
13
|
║ ███████╗███████╗███████╗██║ ██║██║ ╚████║███████╗███████║ ║
|
|
14
14
|
║ ╚══════╝╚══════╝╚══════╝╚═╝ ╚═╝╚═╝ ╚═══╝╚══════╝╚══════╝ ║
|
|
15
|
-
║ v1.9.
|
|
15
|
+
║ v1.9.266 AI Agent Reliability Harness + Sandbox ║
|
|
16
16
|
║ verify · remember · orchestrate · audit · sandbox · drift ║
|
|
17
|
-
║
|
|
17
|
+
║ 🤖 dispatch 슬래시 주입 + MCP 73 (UR-0021 2단계 · R222) ║
|
|
18
18
|
╚══════════════════════════════════════════════════════════════╝
|
|
19
19
|
```
|
|
20
20
|
|
package/bin/harness.js
CHANGED
|
@@ -7,7 +7,7 @@ const cp = require('child_process');
|
|
|
7
7
|
const os = require('os'); // 1.9.178: _publishToNpm 에서 os.tmpdir() 사용 (전역 import)
|
|
8
8
|
const readline = require('readline');
|
|
9
9
|
|
|
10
|
-
const VERSION = '1.9.
|
|
10
|
+
const VERSION = '1.9.266';
|
|
11
11
|
|
|
12
12
|
// 1.9.184: DEP0190 (child_process shell: true) deprecation warning 억제 (사용자 명시).
|
|
13
13
|
// leerness 는 cross-platform PATH resolution 을 위해 shell: true 를 의도적으로 사용 (claude.cmd / ollama.cmd 등 Windows .cmd 처리).
|
|
@@ -2905,6 +2905,8 @@ function _selfTestCases() {
|
|
|
2905
2905
|
{ name: '_unixPathBlock: 멱등 마커 + export', run: () => { const b = _unixPathBlock('/x/bin'); return b.includes('managed') && /export PATH="\$PATH:\/x\/bin"/.test(b); } },
|
|
2906
2906
|
{ name: '_shellGuardAnalyze: PS5.1 && → ps5-chain error', run: () => { const r = _shellGuardAnalyze('a && b', { shell: 'powershell', psVersion: '5' }); return r.issues.some(i => i.rule === 'ps5-chain' && i.severity === 'error'); } },
|
|
2907
2907
|
{ name: '_shellGuardAnalyze: bash && → 문제 없음', run: () => _shellGuardAnalyze('a && b', { shell: 'bash' }).issues.length === 0 },
|
|
2908
|
+
{ name: 'AGENT_SLASH_COMMANDS: claude/codex/agy/grok/copilot 5종 + 명령 보유', run: () => { const ids = Object.keys(AGENT_SLASH_COMMANDS); return ['claude', 'codex', 'agy', 'grok', 'copilot'].every(id => ids.includes(id) && AGENT_SLASH_COMMANDS[id].commands.length > 0); } },
|
|
2909
|
+
{ name: '_agentSlashHint: grok 슬래시 요약 + copilot 하위명령 라벨', run: () => { const g = _agentSlashHint('.', 'grok'); const c = _agentSlashHint('.', 'copilot'); return !!g && g.count > 0 && /Grok/.test(g.summary) && !!c && c.invoke === 'subcommand' && /하위명령/.test(c.summary); } },
|
|
2908
2910
|
{ name: 'VERSION 형식 (x.y.z)', run: () => /^\d+\.\d+\.\d+$/.test(VERSION) }
|
|
2909
2911
|
];
|
|
2910
2912
|
}
|
|
@@ -3560,6 +3562,7 @@ function commandsCmd(root) {
|
|
|
3560
3562
|
{ cmd: 'resume [path]', desc: 'auto-resume-plan 적용 (1.9.203)' },
|
|
3561
3563
|
{ cmd: 'route <task-type>', desc: '작업 유형 분류 (11종)' },
|
|
3562
3564
|
{ cmd: 'agents list|check|quota|dispatch|multi', desc: '외부 AI CLI 오케스트레이션' },
|
|
3565
|
+
{ cmd: 'slash-commands [agent] [--json --record --detect]', desc: 'CLI 에이전트 슬래시 명령 레지스트리 (1.9.265, UR-0021)' },
|
|
3563
3566
|
{ cmd: 'review-request "<request>"', desc: '사용자 요청 사전 검토 (1.9.176)' },
|
|
3564
3567
|
{ cmd: 'review <file> --persona <ids>', desc: '페르소나 리뷰 (1.9.29)' },
|
|
3565
3568
|
{ cmd: 'brainstorm "<topic>" [--include-code]', desc: '워크스페이스 회수 + 코드 grep' }
|
|
@@ -7953,6 +7956,31 @@ function handoff(root) {
|
|
|
7953
7956
|
}
|
|
7954
7957
|
} catch {}
|
|
7955
7958
|
|
|
7959
|
+
// 1.9.266 (UR-0021 2단계): 활성(env 활성화) CLI 에이전트별 슬래시 명령 요약 — sub-agent dispatch 시 알맞은 슬래시 참조
|
|
7960
|
+
// spawn 없이 env flag 만 점검 (handoff 속도 보존). 활성 에이전트 0 이면 미노출.
|
|
7961
|
+
try {
|
|
7962
|
+
const enabledAgents = EXTERNAL_AGENTS.filter(a => {
|
|
7963
|
+
const v = process.env[a.envFlag];
|
|
7964
|
+
return v && v !== '0' && String(v).toLowerCase() !== 'false';
|
|
7965
|
+
});
|
|
7966
|
+
if (enabledAgents.length > 0) {
|
|
7967
|
+
const isTtyS = process.stdout && process.stdout.isTTY;
|
|
7968
|
+
const cyS = s => isTtyS ? `\x1b[36m${s}\x1b[0m` : s;
|
|
7969
|
+
const dmS = s => isTtyS ? `\x1b[2m${s}\x1b[0m` : s;
|
|
7970
|
+
log('');
|
|
7971
|
+
log(cyS(`## 🤖 CLI 에이전트 슬래시 명령 (1.9.265~266, UR-0021)`));
|
|
7972
|
+
log(dmS(` 활성 에이전트 ${enabledAgents.length}개 — sub-agent 호출 시 각자 슬래시 명령 사용:`));
|
|
7973
|
+
for (const a of enabledAgents) {
|
|
7974
|
+
const hint = _agentSlashHint(root, a.id);
|
|
7975
|
+
if (hint && hint.commands.length) {
|
|
7976
|
+
const top = hint.commands.slice(0, 8).map(c => c.cmd).join(' ');
|
|
7977
|
+
log(dmS(` ${a.id.padEnd(8)} ${top}${hint.invoke === 'subcommand' ? ' (하위명령)' : ''}`));
|
|
7978
|
+
}
|
|
7979
|
+
}
|
|
7980
|
+
log(dmS(` → 전체/기록/최신화: leerness slash-commands [agent] [--record]`));
|
|
7981
|
+
}
|
|
7982
|
+
} catch {}
|
|
7983
|
+
|
|
7956
7984
|
// 1.9.245: API skill cache 자동 참조 (사용자 명시 UR-0015)
|
|
7957
7985
|
// 현재 task 키워드 기반으로 .harness/api-skills/ 매칭 → 사용자가 정리해둔 API 문서 자동 노출
|
|
7958
7986
|
try {
|
|
@@ -10050,6 +10078,204 @@ const EXTERNAL_AGENTS = [
|
|
|
10050
10078
|
installCmd: 'curl -fsSL https://ollama.com/install.sh | sh (또는 https://ollama.com/download)', installHint: 'ollama serve 실행 + ollama pull <model>' }
|
|
10051
10079
|
];
|
|
10052
10080
|
|
|
10081
|
+
// 1.9.265 (사용자 명시 UR-0021): CLI AI 에이전트별 슬래시 명령어 레지스트리.
|
|
10082
|
+
// 목적: 각 CLI (claude/codex/agy/grok/copilot) 의 슬래시 명령어를 큐레이션·기록하고, 서브에이전트 dispatch 시 알맞게 참조.
|
|
10083
|
+
// "항상 최신화" 3중 경로: (1) 빌트인은 leerness 릴리스마다 갱신(asOf), (2) 사용자 .harness/agent-slash-commands.json override 병합,
|
|
10084
|
+
// (3) [2~3단계 예정] CLI `--help`/`/help` probe 자동 refresh. 0-dep·offline-first 라서 1단계는 (1)+(2) 큐레이션 기반.
|
|
10085
|
+
// 주의: 외부 CLI 의 슬래시 명령은 버전마다 변동 → asOf 표기 + 사용자 override 우선. type='subcommand' 는 슬래시가 아닌 하위명령(예: gh copilot).
|
|
10086
|
+
const AGENT_SLASH_COMMANDS = {
|
|
10087
|
+
claude: {
|
|
10088
|
+
label: 'Anthropic Claude Code', asOf: '1.9.265', invoke: 'slash',
|
|
10089
|
+
commands: [
|
|
10090
|
+
{ cmd: '/help', desc: '명령 목록' },
|
|
10091
|
+
{ cmd: '/clear', desc: '대화 컨텍스트 초기화' },
|
|
10092
|
+
{ cmd: '/compact', desc: '대화 압축 (컨텍스트 절약)' },
|
|
10093
|
+
{ cmd: '/init', desc: 'CLAUDE.md 생성/갱신' },
|
|
10094
|
+
{ cmd: '/model', desc: '모델 전환' },
|
|
10095
|
+
{ cmd: '/review', desc: 'PR/변경 리뷰' },
|
|
10096
|
+
{ cmd: '/agents', desc: '서브에이전트 관리' },
|
|
10097
|
+
{ cmd: '/mcp', desc: 'MCP 서버 상태/관리' },
|
|
10098
|
+
{ cmd: '/memory', desc: '메모리 파일 편집' },
|
|
10099
|
+
{ cmd: '/permissions', desc: '권한 설정' },
|
|
10100
|
+
{ cmd: '/cost', desc: '토큰 비용 표시' },
|
|
10101
|
+
{ cmd: '/resume', desc: '이전 세션 재개' },
|
|
10102
|
+
{ cmd: '/config', desc: '설정' }
|
|
10103
|
+
]
|
|
10104
|
+
},
|
|
10105
|
+
codex: {
|
|
10106
|
+
label: 'OpenAI Codex CLI', asOf: '1.9.265', invoke: 'slash',
|
|
10107
|
+
commands: [
|
|
10108
|
+
{ cmd: '/init', desc: '프로젝트 컨텍스트 초기화' },
|
|
10109
|
+
{ cmd: '/compact', desc: '대화 압축' },
|
|
10110
|
+
{ cmd: '/diff', desc: '작업 트리 diff 표시' },
|
|
10111
|
+
{ cmd: '/mention', desc: '파일 멘션/첨부' },
|
|
10112
|
+
{ cmd: '/status', desc: '세션 상태/사용량' },
|
|
10113
|
+
{ cmd: '/model', desc: '모델 전환' },
|
|
10114
|
+
{ cmd: '/approvals', desc: '승인 모드 변경 (sandbox)' },
|
|
10115
|
+
{ cmd: '/new', desc: '새 대화 시작' },
|
|
10116
|
+
{ cmd: '/clear', desc: '컨텍스트 초기화' },
|
|
10117
|
+
{ cmd: '/quit', desc: '종료' }
|
|
10118
|
+
]
|
|
10119
|
+
},
|
|
10120
|
+
agy: {
|
|
10121
|
+
label: 'Google Antigravity CLI', asOf: '1.9.265', invoke: 'slash',
|
|
10122
|
+
note: '큐레이션(best-effort) — agy CLI 는 신규 도구라 슬래시 명령이 변동 가능. --refresh(2단계) 또는 사용자 override 권장.',
|
|
10123
|
+
commands: [
|
|
10124
|
+
{ cmd: '/help', desc: '명령 목록' },
|
|
10125
|
+
{ cmd: '/init', desc: '워크스페이스 초기화' },
|
|
10126
|
+
{ cmd: '/model', desc: '모델 전환' },
|
|
10127
|
+
{ cmd: '/new', desc: '새 세션' },
|
|
10128
|
+
{ cmd: '/clear', desc: '컨텍스트 초기화' },
|
|
10129
|
+
{ cmd: '/status', desc: '상태 표시' }
|
|
10130
|
+
]
|
|
10131
|
+
},
|
|
10132
|
+
grok: {
|
|
10133
|
+
label: 'xAI Grok CLI', asOf: '1.9.265', invoke: 'slash',
|
|
10134
|
+
note: '커뮤니티/공식 Grok CLI 들 (예: @vibe-kit/grok-cli) 기준 큐레이션 — 배포판마다 차이 가능. 사용자 override 권장.',
|
|
10135
|
+
commands: [
|
|
10136
|
+
{ cmd: '/help', desc: '명령 목록' },
|
|
10137
|
+
{ cmd: '/clear', desc: '대화 초기화' },
|
|
10138
|
+
{ cmd: '/model', desc: '모델 전환 (grok-beta 등)' },
|
|
10139
|
+
{ cmd: '/new', desc: '새 대화' },
|
|
10140
|
+
{ cmd: '/login', desc: 'xAI API 키 로그인' },
|
|
10141
|
+
{ cmd: '/exit', desc: '종료' }
|
|
10142
|
+
]
|
|
10143
|
+
},
|
|
10144
|
+
copilot: {
|
|
10145
|
+
label: 'GitHub Copilot CLI (gh copilot)', asOf: '1.9.265', invoke: 'subcommand',
|
|
10146
|
+
note: '슬래시가 아닌 gh 하위명령. 호출 형식: gh copilot <sub> "<질의>".',
|
|
10147
|
+
commands: [
|
|
10148
|
+
{ cmd: 'suggest', desc: '명령/코드 제안 (gh copilot suggest "...")' },
|
|
10149
|
+
{ cmd: 'explain', desc: '명령 설명 (gh copilot explain "...")' },
|
|
10150
|
+
{ cmd: 'config', desc: 'gh copilot 설정' }
|
|
10151
|
+
]
|
|
10152
|
+
}
|
|
10153
|
+
};
|
|
10154
|
+
function _agentSlashFile(root) { return path.join(absRoot(root), '.harness', 'agent-slash-commands.json'); }
|
|
10155
|
+
// 사용자 override 병합 — .harness/agent-slash-commands.json 에 동일 agent id 가 있으면 commands 를 교체(최신화).
|
|
10156
|
+
// 파일 형식: { schemaVersion:1, agents: { <id>: { label?, asOf?, invoke?, note?, commands:[{cmd,desc}] } } }
|
|
10157
|
+
function _loadAgentSlashCommands(root) {
|
|
10158
|
+
const merged = {};
|
|
10159
|
+
for (const [id, def] of Object.entries(AGENT_SLASH_COMMANDS)) {
|
|
10160
|
+
merged[id] = { id, label: def.label, asOf: def.asOf, invoke: def.invoke || 'slash', note: def.note || null, source: 'builtin', commands: def.commands.slice() };
|
|
10161
|
+
}
|
|
10162
|
+
try {
|
|
10163
|
+
const f = _agentSlashFile(root);
|
|
10164
|
+
if (exists(f)) {
|
|
10165
|
+
const j = JSON.parse(read(f));
|
|
10166
|
+
const userAgents = (j && j.agents && typeof j.agents === 'object') ? j.agents : {};
|
|
10167
|
+
for (const [id, def] of Object.entries(userAgents)) {
|
|
10168
|
+
if (!def || !Array.isArray(def.commands)) continue;
|
|
10169
|
+
const cmds = def.commands.filter(c => c && typeof c.cmd === 'string').map(c => ({ cmd: c.cmd, desc: c.desc || '' }));
|
|
10170
|
+
merged[id] = {
|
|
10171
|
+
id,
|
|
10172
|
+
label: def.label || (merged[id] && merged[id].label) || id,
|
|
10173
|
+
asOf: def.asOf || (merged[id] && merged[id].asOf) || null,
|
|
10174
|
+
invoke: def.invoke || (merged[id] && merged[id].invoke) || 'slash',
|
|
10175
|
+
note: def.note || (merged[id] && merged[id].note) || null,
|
|
10176
|
+
source: merged[id] ? 'builtin+user' : 'user',
|
|
10177
|
+
commands: cmds.length ? cmds : (merged[id] ? merged[id].commands : [])
|
|
10178
|
+
};
|
|
10179
|
+
}
|
|
10180
|
+
}
|
|
10181
|
+
} catch {}
|
|
10182
|
+
return merged;
|
|
10183
|
+
}
|
|
10184
|
+
// 워크스페이스 기록 — 빌트인 레지스트리를 .harness/agent-slash-commands.json 으로 출력 (사용자가 편집해 최신화 가능).
|
|
10185
|
+
// 기존 사용자 override 가 있으면 보존(병합 결과 기록). force 시 빌트인으로 덮어쓰기.
|
|
10186
|
+
function _recordAgentSlashCommands(root, opts = {}) {
|
|
10187
|
+
const f = _agentSlashFile(root);
|
|
10188
|
+
let agents;
|
|
10189
|
+
if (opts.force || !exists(f)) {
|
|
10190
|
+
agents = {};
|
|
10191
|
+
for (const [id, def] of Object.entries(AGENT_SLASH_COMMANDS)) {
|
|
10192
|
+
agents[id] = { label: def.label, asOf: def.asOf, invoke: def.invoke || 'slash', note: def.note || undefined, commands: def.commands.slice() };
|
|
10193
|
+
}
|
|
10194
|
+
} else {
|
|
10195
|
+
const merged = _loadAgentSlashCommands(root);
|
|
10196
|
+
agents = {};
|
|
10197
|
+
for (const [id, def] of Object.entries(merged)) {
|
|
10198
|
+
agents[id] = { label: def.label, asOf: def.asOf, invoke: def.invoke, note: def.note || undefined, commands: def.commands };
|
|
10199
|
+
}
|
|
10200
|
+
}
|
|
10201
|
+
mkdirp(path.dirname(f));
|
|
10202
|
+
writeUtf8(f, JSON.stringify({ schemaVersion: 1, recordedAt: new Date().toISOString(), agents }, null, 2) + '\n');
|
|
10203
|
+
return { file: f, agentCount: Object.keys(agents).length };
|
|
10204
|
+
}
|
|
10205
|
+
// dispatch 참조용 — 특정 agent 의 슬래시 명령어 힌트 (서브에이전트 프롬프트에 주입할 1줄 요약 + 배열).
|
|
10206
|
+
// 2단계에서 agents multi/agent dispatch 가 이 헬퍼로 각 에이전트에 맞는 슬래시 명령을 안내.
|
|
10207
|
+
function _agentSlashHint(root, agentId) {
|
|
10208
|
+
const all = _loadAgentSlashCommands(root);
|
|
10209
|
+
const def = all[agentId];
|
|
10210
|
+
if (!def) return null;
|
|
10211
|
+
const top = def.commands.slice(0, 8).map(c => c.cmd).join(' ');
|
|
10212
|
+
const invokeNote = def.invoke === 'subcommand' ? ' (슬래시 아님, 하위명령)' : '';
|
|
10213
|
+
return {
|
|
10214
|
+
agent: agentId,
|
|
10215
|
+
label: def.label,
|
|
10216
|
+
invoke: def.invoke,
|
|
10217
|
+
count: def.commands.length,
|
|
10218
|
+
commands: def.commands,
|
|
10219
|
+
summary: `${def.label}${invokeNote}: ${top}${def.commands.length > 8 ? ' …' : ''}`
|
|
10220
|
+
};
|
|
10221
|
+
}
|
|
10222
|
+
// 1.9.265 (UR-0021): leerness slash-commands [agent] [--json --record --detect]
|
|
10223
|
+
// 인자 없음 → 전체 에이전트 슬래시 명령 목록. <agent> → 단일. --record → 워크스페이스 기록. --detect → 설치된 CLI 만 표시.
|
|
10224
|
+
function slashCommandsCmd(root, agentArg, opts = {}) {
|
|
10225
|
+
const all = _loadAgentSlashCommands(root);
|
|
10226
|
+
// --detect: 실제 PATH 에 설치된 CLI 만 (EXTERNAL_AGENTS bin 기준)
|
|
10227
|
+
let installed = null;
|
|
10228
|
+
if (opts.detect) {
|
|
10229
|
+
installed = {};
|
|
10230
|
+
for (const a of EXTERNAL_AGENTS) {
|
|
10231
|
+
try { const r = cp.spawnSync(a.bin, a.versionArgs || ['--version'], { encoding: 'utf8', timeout: 4000 }); installed[a.id] = !r.error && (r.status === 0 || !!(r.stdout || '').trim()); }
|
|
10232
|
+
catch { installed[a.id] = false; }
|
|
10233
|
+
}
|
|
10234
|
+
}
|
|
10235
|
+
// --record: 워크스페이스에 기록
|
|
10236
|
+
if (opts.record) {
|
|
10237
|
+
const res = _recordAgentSlashCommands(root, { force: opts.force });
|
|
10238
|
+
if (opts.json) { log(JSON.stringify({ recorded: true, file: res.file, agentCount: res.agentCount }, null, 2)); return; }
|
|
10239
|
+
log(`✓ 슬래시 명령어 레지스트리 기록: ${res.file} (${res.agentCount} 에이전트)`);
|
|
10240
|
+
log(` → 사용자 편집으로 최신화 가능 (agents.<id>.commands 배열)`);
|
|
10241
|
+
return;
|
|
10242
|
+
}
|
|
10243
|
+
const ids = agentArg ? [agentArg] : Object.keys(all);
|
|
10244
|
+
if (agentArg && !all[agentArg]) {
|
|
10245
|
+
if (opts.json) { log(JSON.stringify({ error: `unknown agent: ${agentArg}`, known: Object.keys(all) }, null, 2)); return; }
|
|
10246
|
+
fail(`알 수 없는 에이전트: ${agentArg} (가능: ${Object.keys(all).join(', ')})`);
|
|
10247
|
+
return;
|
|
10248
|
+
}
|
|
10249
|
+
if (opts.json) {
|
|
10250
|
+
const out = { schemaVersion: 1, agents: {} };
|
|
10251
|
+
for (const id of ids) {
|
|
10252
|
+
const d = all[id];
|
|
10253
|
+
out.agents[id] = { label: d.label, asOf: d.asOf, invoke: d.invoke, note: d.note, source: d.source, count: d.commands.length, commands: d.commands };
|
|
10254
|
+
if (installed) out.agents[id].installed = !!installed[id];
|
|
10255
|
+
}
|
|
10256
|
+
log(JSON.stringify(out, null, 2));
|
|
10257
|
+
return;
|
|
10258
|
+
}
|
|
10259
|
+
const isTty = process.stdout && process.stdout.isTTY;
|
|
10260
|
+
const cy = s => isTty ? `\x1b[36m${s}\x1b[0m` : s;
|
|
10261
|
+
const gr = s => isTty ? `\x1b[32m${s}\x1b[0m` : s;
|
|
10262
|
+
const yl = s => isTty ? `\x1b[33m${s}\x1b[0m` : s;
|
|
10263
|
+
const dm = s => isTty ? `\x1b[2m${s}\x1b[0m` : s;
|
|
10264
|
+
log(cy(`# leerness slash-commands (1.9.265, UR-0021) — CLI 에이전트별 슬래시 명령어`));
|
|
10265
|
+
log(dm(` 서브에이전트 호출 시 각 에이전트에 맞는 슬래시 명령을 참조하세요. 사용자 override: ${_agentSlashFile(root)}`));
|
|
10266
|
+
log('');
|
|
10267
|
+
for (const id of ids) {
|
|
10268
|
+
const d = all[id];
|
|
10269
|
+
const instLabel = installed ? (installed[id] ? gr(' [설치됨]') : dm(' [미설치]')) : '';
|
|
10270
|
+
const srcLabel = d.source === 'builtin' ? '' : yl(` [${d.source}]`);
|
|
10271
|
+
log(`${cy('▸ ' + id)} — ${d.label}${instLabel}${srcLabel} ${dm('(asOf ' + (d.asOf || '?') + ', ' + d.commands.length + '개' + (d.invoke === 'subcommand' ? ', 하위명령' : '') + ')')}`);
|
|
10272
|
+
if (d.note) log(dm(` ⓘ ${d.note}`));
|
|
10273
|
+
for (const c of d.commands) log(` ${gr((c.cmd || '').padEnd(14))} ${dm(c.desc || '')}`);
|
|
10274
|
+
log('');
|
|
10275
|
+
}
|
|
10276
|
+
log(dm(` 기록: leerness slash-commands --record · 단일: leerness slash-commands claude · 설치 감지: --detect`));
|
|
10277
|
+
}
|
|
10278
|
+
|
|
10053
10279
|
// 1.9.157: Provider Registry — 사용자 정의 provider 동적 추가 (.harness/providers.json)
|
|
10054
10280
|
// 빌트인 5종 (EXTERNAL_AGENTS) + 사용자 정의를 merge. OpenRouter / Bedrock / Groq 등 새 CLI 즉시 흡수 가능.
|
|
10055
10281
|
// 파일 형식: { "schemaVersion": 1, "providers": [{ id, bin, envFlag, versionArgs, desc, installHint }] }
|
|
@@ -11111,7 +11337,9 @@ function agentsCmd(root, sub, ...args) {
|
|
|
11111
11337
|
log(JSON.stringify({
|
|
11112
11338
|
task, count: ready.length,
|
|
11113
11339
|
agents: ready.map(x => ({ id: x.def.id, version: x.status.version })),
|
|
11114
|
-
commands: ready.map(x => _dispatchCommand(x.def.id, task, writeMode))
|
|
11340
|
+
commands: ready.map(x => _dispatchCommand(x.def.id, task, writeMode)),
|
|
11341
|
+
// 1.9.266 (UR-0021 2단계): 각 에이전트 슬래시 명령 힌트 — sub-agent 가 알맞은 슬래시 사용
|
|
11342
|
+
slashCommands: ready.reduce((acc, x) => { const h = _agentSlashHint(root, x.def.id); if (h) acc[x.def.id] = { invoke: h.invoke, commands: h.commands.map(c => c.cmd) }; return acc; }, {})
|
|
11115
11343
|
}, null, 2));
|
|
11116
11344
|
return;
|
|
11117
11345
|
}
|
|
@@ -11127,6 +11355,11 @@ function agentsCmd(root, sub, ...args) {
|
|
|
11127
11355
|
log('```sh');
|
|
11128
11356
|
log(_dispatchCommand(def.id, task, writeMode));
|
|
11129
11357
|
log('```');
|
|
11358
|
+
// 1.9.266 (UR-0021 2단계): 에이전트별 슬래시 명령 힌트
|
|
11359
|
+
try {
|
|
11360
|
+
const hint = _agentSlashHint(root, def.id);
|
|
11361
|
+
if (hint && hint.commands.length) log(` 🤖 슬래시: ${hint.commands.slice(0, 8).map(c => c.cmd).join(' ')}${hint.invoke === 'subcommand' ? ' (하위명령)' : ''}`);
|
|
11362
|
+
} catch {}
|
|
11130
11363
|
log('');
|
|
11131
11364
|
}
|
|
11132
11365
|
log('## 정책 (1.9.152 / 1.9.156)');
|
|
@@ -11187,6 +11420,17 @@ function agentsCmd(root, sub, ...args) {
|
|
|
11187
11420
|
} else if (target === 'copilot') {
|
|
11188
11421
|
log(`gh copilot suggest "${q}"`);
|
|
11189
11422
|
}
|
|
11423
|
+
// 1.9.266 (UR-0021 2단계): 대상 에이전트의 슬래시 명령 힌트 — sub-agent 작업 시 알맞은 슬래시 명령 참조
|
|
11424
|
+
try {
|
|
11425
|
+
const hint = _agentSlashHint(root, target);
|
|
11426
|
+
if (hint && hint.commands.length) {
|
|
11427
|
+
log('');
|
|
11428
|
+
log(`## 🤖 ${target} 슬래시 명령 (1.9.265, UR-0021)`);
|
|
11429
|
+
if (hint.invoke === 'subcommand') log(` ※ 슬래시가 아닌 하위명령: ${hint.commands.map(c => c.cmd).join(' / ')}`);
|
|
11430
|
+
else log(` 세션 내 사용 가능: ${hint.commands.slice(0, 10).map(c => c.cmd).join(' ')}`);
|
|
11431
|
+
log(` → 전체/기록: leerness slash-commands ${target} [--record]`);
|
|
11432
|
+
}
|
|
11433
|
+
} catch {}
|
|
11190
11434
|
log('');
|
|
11191
11435
|
log(`## 정책 (1.9.36)`);
|
|
11192
11436
|
log(` - leerness는 외부 CLI를 자동 호출하지 않음 (사용자 명시적 실행)`);
|
|
@@ -16107,7 +16351,8 @@ function mcpServeCmd(root) {
|
|
|
16107
16351
|
{ name: 'leerness_env_info', description: '1.9.241 (사용자 명시 UR-0014) — 환경 종합 정보 회수. OS / 언어 (LANG, 코드페이지) / 한국어 Windows / 하드웨어 / 터미널 (TTY, PowerShell 버전) / 도구 버전 (git, npm, python). 외부 AI 가 환경 호환성을 미리 인지 → 인코딩 오류 예방. 응답: { os, node, locale, hardware, terminal, tools }. 인자: { path?, encodingCheck? }. encodingCheck: true 시 셸 스크립트 (.ps1/.bat/.cmd/.sh) BOM 없는 비-ASCII 위험 감지', inputSchema: { type: 'object', properties: { path: { type: 'string' }, encodingCheck: { type: 'boolean' } } } },
|
|
16108
16352
|
{ name: 'leerness_api_skill', description: '1.9.245 (사용자 명시 UR-0015) — API 문서·관련링크 자동 캐시. 공식 API 문서 URL을 fetch 하고 1단계 same-domain 관련 링크까지 정리 → .harness/api-skills/<id>.md 저장. 후속 같은 API 관련 작업 시 자동 참조. 응답: list (skills 배열) / show (전체 본문) / match (task 매칭 결과). 인자: { path?, sub ("list"|"show"|"match"|"add"|"drop"), url? (add), id? (show/drop), query? (match), direction? (add: 구현 방향 텍스트) }. 외부 AI가 "이 프로젝트 어떤 API 문서가 정리되어 있나?" / "내 작업과 매칭되는 API skill 있나?" 회수.', inputSchema: { type: 'object', properties: { path: { type: 'string' }, sub: { type: 'string', enum: ['list', 'show', 'match', 'add', 'drop'] }, url: { type: 'string' }, id: { type: 'string' }, query: { type: 'string' }, direction: { type: 'string' } }, required: ['sub'] } },
|
|
16109
16353
|
{ name: 'leerness_selftest', description: '1.9.258/259 — 설치된 leerness 바이너리의 코어 함수(보안 _isSecretKey / 버전 compareVer / 인코딩 _classifyCJK 등) 무결성 자가 검증. 응답: { version, total, pass, fail, ok, results[] }. 외부 AI/CI 가 "이 leerness 설치가 정상인가?(npx 캐시 손상·부분 설치 감지)" 를 1초 내 확인. 인자: 없음.', inputSchema: { type: 'object', properties: {} } },
|
|
16110
|
-
{ name: 'leerness_shell_guard', description: '1.9.260/261 (사용자 명시 UR-0020) — 터미널 명령 셸 호환성 린터. 외부 AI 가 명령을 실행하기 전에 셸 호환성 문제를 사전 점검. 예: Windows PowerShell 5.1 은 && / || 미지원 → A; if ($?) { B } 제안. 6 규칙(ps5-chain/ps-devnull/ps-inline-env/ps-rm-rf/cmd-semicolon/ps-version-unknown) + 과거 실패 회수(.harness/shell-failures.json). 응답: { shell, psVersion, issues[{rule,severity,detail,suggestion}], pastSame, pastSimilar, ok }. 인자: { command (required), path? }. 현재 셸/PS 버전 자동 감지.', inputSchema: { type: 'object', properties: { command: { type: 'string' }, path: { type: 'string' } }, required: ['command'] } }
|
|
16354
|
+
{ name: 'leerness_shell_guard', description: '1.9.260/261 (사용자 명시 UR-0020) — 터미널 명령 셸 호환성 린터. 외부 AI 가 명령을 실행하기 전에 셸 호환성 문제를 사전 점검. 예: Windows PowerShell 5.1 은 && / || 미지원 → A; if ($?) { B } 제안. 6 규칙(ps5-chain/ps-devnull/ps-inline-env/ps-rm-rf/cmd-semicolon/ps-version-unknown) + 과거 실패 회수(.harness/shell-failures.json). 응답: { shell, psVersion, issues[{rule,severity,detail,suggestion}], pastSame, pastSimilar, ok }. 인자: { command (required), path? }. 현재 셸/PS 버전 자동 감지.', inputSchema: { type: 'object', properties: { command: { type: 'string' }, path: { type: 'string' } }, required: ['command'] } },
|
|
16355
|
+
{ name: 'leerness_slash_commands', description: '1.9.265/266 (사용자 명시 UR-0021) — CLI AI 에이전트별 슬래시 명령어 레지스트리. 외부 AI(메인)가 sub-agent(codex/agy/claude/grok/copilot)를 호출할 때 각 에이전트에 알맞는 슬래시 명령을 참조. 빌트인 + 사용자 .harness/agent-slash-commands.json override 병합. 응답: { agents: { <id>: { label, asOf, invoke(slash|subcommand), note, source, count, commands[{cmd,desc}] } } }. 인자: { path?, agent? (생략 시 전체) }. agent 지정 시 단일.', inputSchema: { type: 'object', properties: { path: { type: 'string' }, agent: { type: 'string' } } } }
|
|
16111
16356
|
];
|
|
16112
16357
|
|
|
16113
16358
|
function send(obj) {
|
|
@@ -16318,6 +16563,10 @@ function mcpServeCmd(root) {
|
|
|
16318
16563
|
// 1.9.261 (1.9.260, UR-0020): 터미널 명령 셸 호환성 린터
|
|
16319
16564
|
cliArgs = ['shell-guard', String(args.command || ''), '--path', targetPath, '--json'];
|
|
16320
16565
|
break;
|
|
16566
|
+
case 'leerness_slash_commands':
|
|
16567
|
+
// 1.9.266 (1.9.265, UR-0021): CLI 에이전트 슬래시 명령 레지스트리
|
|
16568
|
+
cliArgs = ['slash-commands', ...(args.agent ? [String(args.agent)] : []), '--path', targetPath, '--json'];
|
|
16569
|
+
break;
|
|
16321
16570
|
default:
|
|
16322
16571
|
return send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Unknown tool: ${name}` } });
|
|
16323
16572
|
}
|
|
@@ -20196,6 +20445,11 @@ async function main() {
|
|
|
20196
20445
|
const exitRaw = arg('--exit', null);
|
|
20197
20446
|
return shellGuardCmd(arg('--path', process.cwd()), cmdArg, { record: has('--record'), exit: exitRaw != null ? parseInt(exitRaw, 10) : null, json: has('--json') });
|
|
20198
20447
|
}
|
|
20448
|
+
// 1.9.265: leerness slash-commands [agent] — CLI 에이전트별 슬래시 명령어 레지스트리 (사용자 명시 UR-0021)
|
|
20449
|
+
if (cmd === 'slash-commands' || cmd === 'slash' || cmd === 'agent-slash') {
|
|
20450
|
+
const agentArg = args[1] && !args[1].startsWith('-') ? args[1] : null;
|
|
20451
|
+
return slashCommandsCmd(arg('--path', process.cwd()), agentArg, { json: has('--json'), record: has('--record'), force: has('--force'), detect: has('--detect') });
|
|
20452
|
+
}
|
|
20199
20453
|
// 1.9.245: API skill cache — 공식 문서·관련링크 자동 정리 (사용자 명시 UR-0015)
|
|
20200
20454
|
if (cmd === 'api-skill') return apiSkillCmd(arg('--path', process.cwd()), args[1] || 'help');
|
|
20201
20455
|
// 1.9.208: leerness constraints <list|check|add> — 플랫폼/API 제약 사전 체크 (사용자 명시)
|
|
@@ -20361,5 +20615,7 @@ module.exports = {
|
|
|
20361
20615
|
// 1.9.260: shell-guard — 셸 호환성 린터 (UR-0020) 순수 분석 함수 — 단위 테스트
|
|
20362
20616
|
_shellGuardAnalyze, _detectShellCtx, shellGuardCmd,
|
|
20363
20617
|
// 1.9.263: shell 실패 메모리 + 환경 버전 변동 (UR-0020 3단계) — handoff 통합 단위 테스트
|
|
20364
|
-
_shellFailuresPath, _loadShellFailures, _recordShellFailure, _shellEnvDrift
|
|
20618
|
+
_shellFailuresPath, _loadShellFailures, _recordShellFailure, _shellEnvDrift,
|
|
20619
|
+
// 1.9.265: CLI 에이전트 슬래시 명령어 레지스트리 (UR-0021 1단계) — 단위 테스트
|
|
20620
|
+
AGENT_SLASH_COMMANDS, _agentSlashFile, _loadAgentSlashCommands, _recordAgentSlashCommands, _agentSlashHint, slashCommandsCmd
|
|
20365
20621
|
};
|