Metadata-Version: 2.4
Name: alignment_memory
Version: 0.1.53
Summary: Session-based conversation log CLI (JSONL).
Author-email: "A.B" <dev@ab.example>
License: MIT
Project-URL: Homepage, https://example.com/alignment_memory
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.4; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Dynamic: license-file

﻿# ALIGNMENT MEMORY (CLI)

가벼운 **세션 기반 대화 로그** 저장/검색 툴입니다. 각 세션은 **12자리 hex ID**로 생성되며(JSONL 라인 저장), 검색/요약/내보내기 등을 지원합니다.

# ALIGNBEING — `alignment_memory` (A.B 모듈 / Class1)

> 세션 기반 **정렬 기억(Alignment Memory)** 컴포넌트.
> **Windows/PowerShell 1st** 설계, 선택적 모듈 임포트 패턴, pre-commit/ruff/format/mypy/pytest 완비.

## Quickstart

### 0) 요구사항
- Python 3.10–3.12
- Windows(권장) 또는 Ubuntu
- PowerShell(로컬 작업 시)

### 1) 설치 (로컬 개발)
```powershell
py -3.11 -m pip install -U pip
py -3.11 -m pip install -e .
## Install

```bash
pip install -U alignment_memory
# 실행 명령: alm
alm --help

Class1.filter_events(..., tz='local'|'utc'|'+09:00') 지원

AB_TZ_OFFSET="+09:00" 환경변수로 기본 로컬 오프셋 오버라이드 가능

<!-- BEGIN: 2025-08-17 Sales-Ready v0.1.53 -->

## 2025-08-17 — Sales-Ready 준비 (v0.1.53)

**프로젝트:** ALIGNBEING / `alignment_memory` (A.B 모듈)
**상태:** pre-commit(ruff/format/mypy) + pytest 통과, CLI 안정화, 선택적 모듈 임포트 적용
**플랫폼:** Windows/PowerShell 우선

### Quickstart (PowerShell)

```powershell
# 개발 설치
python -m pip install -U pip
python -m pip install -e .

# (선택) 라이선스 키: 풀 모드
setx AB_LICENSE_KEY "YOUR-LICENSE-KEY"   # 새 PowerShell에서 반영

# 동작 확인
python -m alignment_memory.cli smoke

# 세션 예시
python -m alignment_memory.cli init
python -m alignment_memory.cli add  --sid YYYYMMDD-001 --role user --text "hello"
python -m alignment_memory.cli list --sid YYYYMMDD-001 --tail 10
python -m alignment_memory.cli export --sid YYYYMMDD-001 --out YYYYMMDD-001.csv

<!-- BEGIN: 2025-08-17 Sales-Ready v0.1.53 -->

## 2025-08-17 — Sales-Ready 준비 (v0.1.53)

**프로젝트:** ALIGNBEING / `alignment_memory` (A.B 모듈)
**상태:** pre-commit(ruff/format/mypy) + pytest 통과, CLI 안정화, 선택적 모듈 임포트 적용
**플랫폼:** Windows/PowerShell 우선

### Quickstart (PowerShell)

```powershell
python -m pip install -U pip
python -m pip install -e .

# (선택) 라이선스 키: 풀 모드
setx AB_LICENSE_KEY "YOUR-LICENSE-KEY"   # 새 PowerShell에서 반영

# 동작 확인
python -m alignment_memory.cli smoke

# 세션 예시
python -m alignment_memory.cli init
python -m alignment_memory.cli add  --sid YYYYMMDD-001 --role user --text "hello"
python -m alignment_memory.cli list --sid YYYYMMDD-001 --tail 10
python -m alignment_memory.cli export --sid YYYYMMDD-001 --out YYYYMMDD-001.csv
