← 목록
기타 2026-07-03 4KB 읽기 4분

flex.crowny.org 플렉스집사 — 브리핑·응답 엔진 + 일일 보고서 엔진

개요

flex.crowny.org "플렉스집사" 서비스의 순수 한선씨 코어 엔진 2종을 구현:
  1. 전화 브리핑·회원 발화 응답 분류/기록 엔진
  2. 현장 사진 선별 + 일일 보고서 생성 엔진
두 엔진 모두 CLI(환경변수 입력 → stdout 단일 JSON 라인) 계약을 따르며, 플렉스견적서버/기존 서비스에는 손대지 않음(touchedExistingFiles=[]).

무엇을 했는지

1) 집사 엔진 (libs/플렉스집사.한선 + 집사CLI.한선)

  • FLEX_MODE=브리핑: 프로필(꿈목표)+패턴(격식도)+오늘 할일(PSV) 읽어 전화 브리핑 발화 스크립트 생성.
  • 격식도 3단계(≥7/4~6/≤3)에 따라 어미만 다르게(사실은 불변) — 인사/꿈목표 리마인드/할일 우선순위 순차 안내(최우선 1건 강조)/마무리로 구성.
  • FLEX_MODE=응답: 회원 발화(STT 텍스트) → 셀코어 룰 스타일 순차 매칭으로 분류(완료보고/할일추가/의사결정/기타).
  • 완료보고 시 할일명 앞 2~4글자 매칭으로 해당 할일 상태를 완료로 갱신.
  • 할일추가 시 발화에서 항목명 추출(추가/까먹지/해야/새로 단서 기반) → 할일 PSV에 append(번호=최대+1, 우선2).
  • 모든 응답을 기록_ PSV에 발화 원문 + 분류 요약 2줄 append.
  • 격식도별 응답 발화문 생성.
  • 2) 보고서 엔진 (libs/플렉스보고서.한선 + 보고서CLI.한선)

    • 할일 PSV → 달성률(완료×100/전체, 0나눔 가드), 완료/미완료 이름 목록.
    • 기록 PSV → 의사결정 목록, 발화 하이라이트(완료보고+의사결정).
    • 사진메타 PSV → 최대 6장 선별: 설명 있는 사진 우선(시간순) + 나머지는 시간순 균등 샘플(처음/중간/끝 등분 인덱싱). 선별된 항목은 사진메타 파일에 선별=1로 갱신.
    • 격식도 어미(하였습니다/했어요/함) 적용한 본문 3문장.
    • state/보고서_<id>_<날짜>.json 저장 + stdout 동일 JSON(ok:true 포함).

    발견한 버그(수정 완료)

    발화분류 초기 순서에서 완료보고 약신호 "했어"를 먼저 체크하다 보니 "결정했어요"(의사결정 문장) 오분류 발생 — "정했"/"결정"도 "했어"의 부분집합이라 우선순위 충돌. 완료보고 강신호(끝냈/완료/마쳤) → 의사결정(결정/하기로/정했/선택) → 할일추가(해야/추가/새로/까먹지) → 완료보고 약신호(했어) 순으로 재배치해 해결. 실측 테스트로 검증.

    관련 파일

    • /Users/ef/crowny-flex/libs/플렉스집사.한선
    • /Users/ef/crowny-flex/집사CLI.한선
    • /Users/ef/crowny-flex/libs/플렉스보고서.한선
    • /Users/ef/crowny-flex/보고서CLI.한선
    • 빌드 산출물: /Users/ef/crowny-flex/build/집사.toau, /Users/ef/crowny-flex/build/보고서.toau
    • 참조(재사용 설계): /Users/ef/crowny-butler/libs/아침브리핑.한선, 인식기록.한선, 보고서화.한선

    한선씨 VM 함정(실제 부딪힌 것)

    • 가져오기 경로는 컴파일 진입파일(CLI.한선) 기준 CWD 상대로 통일 해석됨(파일별 상대경로 아님) — 진입점이 crowny-flex 루트이므로 libs/ 내부 파일끼리도 서로 가져오기 "libs/파일.한선"으로 참조해야 함. bare 파일명은 크라우니어 컴파일러 자체 libs/(문자열.한선 등)에서만 자동 해석됨.
    • x = x + 함수호출() 누적 금지 트랩 회피(모든 함수 결과는 임시변수 경유).
    • 배열 인덱스 갱신은 설정()으로만(bracket 대입 금지).

    잔여 이슈

    • 다른 세션이 crowny-flex에서 병행으로 온보딩.toau, 패턴.toau, 플렉스서버.toau, 추출.toau, 세션.psv, 회원.psv, 사진_*.b64 등 더 넓은 플렉스집사 인프라(회원가입/세션/사진업로드)를 구축 중인 것으로 관찰됨(state/ 디렉토리에서 확인, 2026-07-03 12시경). 이번 작업은 요청받은 4개 파일(집사·보고서 엔진)만 격리해 작성했고 그쪽 파일은 건드리지 않음 — 두 작업의 배선(라우팅/서버 연동)은 별도 통합 필요.
    • 항목추출()의 발화→할일명 파싱은 휴리스틱(단서어 앞/뒤 절단) — 실제 STT 발화 패턴이 다양해지면 정밀도 보강 필요.