질문하면 근거로 답하는 PKM, 구조와 구현 방법

#!/bin/zsh
set -euo pipefail
APP="build/Second Brain.app"
rm -rf "$APP"
mkdir -p "$APP/Contents/MacOS" "$APP/Contents/Resources"

swiftc -O -swift-version 5 -target arm64-apple-macos14.0 \
  -framework AppKit -framework SwiftUI -framework Carbon \
  -framework ServiceManagement -framework ApplicationServices \
  -o "$APP/Contents/MacOS/SecondBrain" SecondBrain/*.swift

cat > "$APP/Contents/Info.plist" <<PLIST
<?xml version="1.0" encoding="UTF-8"?>
<plist version="1.0"><dict>
  <key>CFBundleName</key><string>Second Brain</string>
  <key>CFBundleIdentifier</key><string>com.example.secondbrain</string>
  <key>CFBundleExecutable</key><string>SecondBrain</string>
  <key>CFBundlePackageType</key><string>APPL</string>
  <key>LSMinimumSystemVersion</key><string>14.0</string>
  <key>LSUIElement</key><true/>
  <key>NSAccessibilityUsageDescription</key>
  <string>⌘ 두 번을 알아보려고 modifier 키 상태만 봅니다.</string>
</dict></plist>
PLIST

# 인증서가 있으면 그걸로, 없으면 ad-hoc
if security find-identity -v -p codesigning | grep -q "Apple Development"; then
  codesign --force --deep -s "Apple Development" "$APP"
else
  codesign --force --deep -s - "$APP"
fi

pkill -x SecondBrain 2>/dev/null || true
rm -rf "$HOME/Applications/Second Brain.app"
cp -R "$APP" "$HOME/Applications/"
open "$HOME/Applications/Second Brain.app"

struct DoubleTapDetector {
    enum Input { case modifiers(command: Bool, others: Bool), otherKey, mouse }
    var maxTapDuration: TimeInterval = 0.25 // 한 번 누르고 떼는 데 걸리는 시간
    var maxGap: TimeInterval = 0.30         // 첫 탭을 뗀 뒤 두 번째까지
    private var cmdDown = false, cmdDownAt: TimeInterval = 0
    private var tainted = false, lastTapUpAt: TimeInterval?

    /// true면 지금 입력 창을 연다
    mutating func handle(_ input: Input, at t: TimeInterval) -> Bool {
        switch input {
        case .otherKey, .mouse:                 // ⌘C 같은 조합이면 무효
            if cmdDown { tainted = true }
            lastTapUpAt = nil
            return false
        case let .modifiers(command, others):
            if command && !cmdDown {           // ⌘ 누름
                cmdDown = true; cmdDownAt = t; tainted = others
                if let last = lastTapUpAt, t - last > maxGap { lastTapUpAt = nil }
                return false
            }
            if command && cmdDown { tainted = true; lastTapUpAt = nil; return false }
            if !command && cmdDown {           // ⌘ 뗌
                cmdDown = false
                let clean = !tainted && !others && (t - cmdDownAt) <= maxTapDuration
                tainted = false
                guard clean else { lastTapUpAt = nil; return false }
                if lastTapUpAt != nil { lastTapUpAt = nil; return true } // 두 번째 탭
                lastTapUpAt = t
                return false
            }
            if others { lastTapUpAt = nil }
            return false
        }
    }
}

monitor = NSEvent.addGlobalMonitorForEvents(
    matching: [.flagsChanged, .keyDown, .leftMouseDown, .rightMouseDown]
) { e in
    let input: DoubleTapDetector.Input
    switch e.type {
    case .flagsChanged:
        let f = e.modifierFlags.intersection(.deviceIndependentFlagsMask)
        input = .modifiers(command: f.contains(.command),
                           others: !f.intersection([.shift, .option, .control, .function]).isEmpty)
    case .keyDown: input = .otherKey   // 어떤 키인지는 보지 않는다
    default: input = .mouse
    }
    if detector.handle(input, at: e.timestamp) { toggle() }
}
// 입력 창이 앞에 있을 때는 전역 모니터가 자기 앱 이벤트를 못 봐서
// addLocalMonitorForEvents도 같이 붙인다

final class KBPanel: NSPanel {
    override var canBecomeKey: Bool { true }  // 테두리 없는 창도 글자 입력을 받게
}

panel = KBPanel(contentRect: NSRect(x: 0, y: 0, width: 760, height: 64),
                styleMask: [.borderless, .nonactivatingPanel, .fullSizeContentView],
                backing: .buffered, defer: false)
panel.level = .floating                       // 다른 앱 위에
panel.collectionBehavior = [.canJoinAllSpaces, .fullScreenAuxiliary, .transient]
panel.isOpaque = false
panel.backgroundColor = .clear                // 둥근 모서리는 SwiftUI 쪽에서 그린다
panel.hasShadow = true
panel.contentView = NSHostingView(rootView: SearchPanelView(model: model))

// 마우스가 있는 화면의 아래 가운데, 아래 가장자리는 고정하고 답이 생기면 위로 자란다
let vf = screen.visibleFrame
let width = min(1000, max(640, vf.width * 0.6), vf.width - 32)
panel.setFrame(NSRect(x: vf.midX - width / 2, y: vf.minY + screen.frame.height * 0.09,
                      width: width, height: panel.frame.height), display: false)

#!/bin/sh
# main이 바뀌면 빌드 요청 파일 하나를 남긴다
hit=""
while read -r old new ref; do
  [ "$ref" = "refs/heads/main" ] && hit="$new"
done
[ -n "$hit" ] || exit 0
queue="$HOME/second-brain/build-queue"
mkdir -p "$queue"
: >"$queue/$(date +%s)-$(echo "$hit" | cut -c1-12)"

[Unit]
Description=빌드 요청 감시

[Path]
DirectoryNotEmpty=%h/second-brain/build-queue
Unit=second-brain-build.service

[Install]
WantedBy=default.target

[Unit]
Description=main → Quartz 사이트 + 질문 서버 문서

[Service]
Type=oneshot
ExecStart=%h/second-brain/bin/build.sh
Nice=15
IOSchedulingClass=idle

projects/
  프로젝트-a/
    index.md
    배포-환경.md
    cases/
      로그인-오류.md
team/
  frontend/
me/
personal/
archive/

---
id: projecta.deploy        # 바뀌지 않는 ID (영역.주제)
title: 프로젝트 A 배포 환경과 절차
project: projecta          # 또는 team, me, personal
type: topic                # overview | topic | case | timeline | profile
status: 적용               # 사례는 해결 또는 미해결
valid_from: 2026-03-02     # 지금 내용이 유효해진 날 (모르면 생략)
last_confirmed: 2026-10-14 # 마지막으로 맞다고 확인한 날
tags: [배포, 환경]
sources:                   # 선택. 회의, 웹 페이지, 직접 입력 같은 근거
  - "직접 입력 2026-10-14"
my_role: 구현              # 구현 | 리뷰 | 논의 | 보고 | 없음
---

# 제목

## 지금
- 현재 유효한 내용을 표나 목록으로 짧게

## 왜
- 그렇게 정한 이유, 당시 조건

## 내 기여
- 내가 한 일

## 이력
- 2026-08-20: 이전 내용 → 바뀐 내용 (이유)

## 미확인
- 근거가 부족한 것

# 제목

## 증상
- 언제, 어느 환경에서, 무엇이 보였는지

## 원인
- 확인된 원인

## 해결
- 실제로 한 조치, 명령, 바꾼 설정

## 재발 방지
- 다음에 같은 일이 없게 바꾼 것