verify / repair / quality-check
유지 관리 명령은 메모리를 건강한 상태로 유지합니다.
verify
engram verify
engram verify --sources
engram verify --sources --json
무결성을 위해 해시를 확인합니다. 수동 편집이나 가져오기 후에 실행하세요.
--sources는 take-control 메모리의 source_files도 source_hashes와 다시 대조하여, 변경되었거나 누락된 항목을 로컬의 gitignore된 .agents/.engram/stale.json에 기록합니다. 오래된 소스 때문에 verify가 실패하는 일은 없습니다. load는 오래된 메모리의 순위를 낮추고 카드 끝에 (stale)을 붙이며, engram take-control --refresh는 해당 메모리에 대한 업데이트를 제안합니다. 소스 경로는 워크스페이스 안에 있어야 하며, 절대 경로, .., 심볼릭 링크와 하드 링크, 비밀 파일, .git, Engram 데이터는 확인되지 않은 항목으로 보고되고 읽지 않습니다. --json에서 skipped는 {key, reason} 객체를 나열합니다. 글로벌 take-control 메모리는 출처가 된 워크스페이스를 기록하며 그 워크스페이스에서만 확인됩니다.
stats
engram stats
engram stats --usage
--usage는 로컬의 gitignore된 .agents/.engram/usage.json을 읽어, 에이전트가 engram load --id로 실제로 가져오는 메모리와 30일 동안 주입되었지만 한 번도 가져오지 않은 메모리를 보여 줍니다.
repair
engram repair
engram rebuild-index
수동 편집이나 가져오기 후에 repair를 사용하면 인덱스 재빌드에서 건너뛴 잘못된 형식의 메모리 파일을 찾을 수 있습니다.
engram repair --move-backups
engram repair workspace --move-backups --confirm
--move-backups는 rules, skills, knowledge에 흩어져 있는 *.bak 마이그레이션 백업을 gitignore된 backups/<kind>-<label>/ 폴더(예: backups/schema-v3/rules/x.md.pre-v3.bak)로 옮기는 계획을 세웁니다. 실제로 옮기려면 --confirm을 추가하세요. 대상 위치에 이미 다른 파일이 있으면 충돌로 보고하고 그대로 둡니다. engram doctor는 이런 파일을 memory.stray_backups로 보고합니다.
quality-check
engram quality-check
모순 후보를 간결하게 보고합니다. 모순 감지는 휴리스틱이며 참고용입니다.
graph
engram graph "package manager"
engram graph --rebuild
아카이브하기 전에 그래프 라우팅을 점검하세요. 수동 편집 후에는 engram graph --rebuild를 실행하세요.
archive
engram archive --reason "Repo migrated to npm." rules/use-pnpm.md
잘못되었거나 대체된 메모리를 아카이브합니다. 감사 가능성을 위해 삭제하지 말고 아카이브를 사용하세요. 파일은 승인 후에야 활성 라우팅에서 빠지며 archive/ 아래에 보존됩니다.
resolve-conflicts
engram resolve-conflicts --dry-run --metacognize
engram resolve-conflicts --metacognize
Engram이 소유한 워크스페이스 메모리 충돌만 미리 보거나 해결합니다. 충돌 처리 후 에이전트가 메모리 폴더를 검토하게 하려면 --metacognize를 추가하세요. 이 명령은 결정적 충돌 처리를 .agents/.engram/ 범위로 제한한 뒤, 간결한 TYPE/TEXT 후보를 위한 워크스페이스 metacognize 소스 팩을 덧붙입니다.
benchmark
engram benchmark
검색 회귀 점검입니다.