memory recall

무엇을 하는 명령인가

memory recall은 작업을 다시 이어가기 위해 필요한 패킷을 복원합니다. 현재 working memory에서 시작하고, 정확한 HEAD snapshot을 사용할 수 있을 때 query와 context pack이 쓰는 동일한 strict retrieval 결과와 goal에 맞는 recall 전용 artifact overlay를 덧붙입니다.

언제 쓰는가 / 언제 쓰지 않는가

언제 쓰는가

중단된 작업을 다시 시작할 때
open loop, constraint, related decision, next action을 한 패킷으로 보고 싶을 때

언제 쓰지 않는가

일반 저장소 검색만 필요할 때. query를 사용하십시오.
working state 없이 retrieval pack만 필요할 때. context pack을 사용하십시오.

기본 구문

pnpm ragit memory recall <goal> \
  [--view minimal|default|full] [--format text|json|both] \
  [--cwd <path>]

인자와 옵션

<goal>: 다시 이어갈 작업 목표입니다.
--view minimal|default|full: retrieval detail 투영 수준을 조절합니다.
--format text|json|both: 출력 형식을 선택합니다.
--cwd <path>: 다른 저장소를 대상으로 실행합니다.

입력/출력 계약

입력은 positional 인자만 사용합니다.
JSON 출력에는 goal, constraints, openLoops, relatedDecisions, retrievedHits, nextActions, latestSessionId, sourceHeadSha, snapshotSha, snapshot, createdAt, warnings가 포함됩니다.
snapshot은 시도한 ref, 확인 가능한 resolved SHA, selection mode, status, branch, detached state, dirty-worktree state를 보고합니다.
retrievedHits에는 snapshot hit와 artifact-origin hit가 함께 들어올 수 있지만, 여전히 전체 이력을 재생하지 않고 선택된 packet만 반환합니다.
--view minimal은 에이전트 재개 흐름의 기본값으로 가장 적합합니다.
--view default는 읽기성과 상세의 균형을 맞춥니다.
--view full은 retrieval hit의 richer text가 꼭 필요할 때만 사용하십시오.

대표 사용 예시

사람용 터미널 예시:

pnpm ragit memory recall "resume auth flow"

에이전트 호출 예시:

pnpm ragit memory recall "resume auth flow" --view minimal --format json

실패/주의 사항

memory recall 품질은 working memory 품질에 크게 의존합니다. wrap이 빈약하면 recall도 약해집니다.
이 명령은 전체 세션 로그를 재생하지 않습니다. 의도적으로 선택된 패킷만 복원합니다.
Exact snapshot retrieval이 manifest/store 누락, invalid, incompatible, 반복된 repository movement 때문에 불가능하면 recall은 snapshotSha: null, snapshot.status: unavailable, operational error code가 포함된 warning을 반환합니다.
Degraded recall은 working memory와 reviewed artifact-derived content만 사용합니다. Embedding이나 canonical store 호출 없이 순위를 계산하며, 해당 hit를 snapshot-backed durable knowledge로 해석하면 안 됩니다.
query와 context pack은 이 방식으로 degrade하지 않고 strict 상태를 유지합니다.