[EPIC][v1.0.0] Mac向けenterprise product release Definition of Done

[tuzuminami]

Release verdict

現状は No-go。このepicは main@c4a13c4a022bc92b2a6ce359c6a317a957333262（2026-07-20時点） とGitHub Issue stateを基準に、Mac向けenterprise product levelのv1.0.0へ必要なrelease workを束ねる。

v1.0の製品境界

• macOS local-first OSS、Apache-2.0
• 非エンジニアがDMG→Applications→double clickで利用
• runtime外部通信、telemetry、analytics、remote crash upload、update checkを追加しない
• keystroke、password、input body、screenshot、screen/video、microphone、cameraを取得しない
• LLM解析は実装しない
• LLMがMermaid Markdownを作れるprivacy-safe handoff bundleの生成まで
• PM4Pyを使わずlocal process mining
• browser extensionはv1.0対象外（Improvement: ブラウザ拡張の技術プレビュー範囲と権限UIを設計する #61）
• 改善roadmap UIはcore release後（Improvement: 改善ロードマップをWebUI上で優先度管理できるようにする #65）

完了済み基盤（PRでclose済み）

• [P0][Legal] Apache-2.0 LICENSEを公式全文へ修復しGitHubのlicense検出を回復する #74 Apache-2.0公式全文とlicense detection
• [P0][Security] Local API全体を認証しlocalhost CSRFと不正ローカル操作を防止する #75 Local API全体認証とlocalhost CSRF対策
• [P0][Security] import/exportのファイル操作をTauriの明示選択scopeに限定する #77 scoped file read/write
• [P0][Storage] versioned SQLite migration・upgrade・rollback・integrity gateを実装する #80 SQLite migration / rollback / integrity
• [P0][CI] macOS品質gate・required checks・main保護を導入する #81 CI / required checks / main protection
• [P0][Export] LLMがMermaid Markdownを生成できるversioned handoff bundleを実装する #82 manual Mermaid LLM handoff bundle（後続のintegrity補強 [P1][Handoff Integrity] source dataset fingerprintとprocess artifact hashを分離しLLM handoffのtraceabilityを保証する #119 は未完）
• [P0][macOS][Security] Tauriがlocal sidecarを所有するruntime基盤を先行実装する #107 Tauriがlocal sidecarを所有するruntime基盤（自己完結.app [P0][macOS] backendと記録agentを同梱した自己完結.appのlifecycleを実装する #78 は未完）
• Improvement: 大量イベント向けの性能ベンチマークとUI負荷対策を追加する #58 大量event性能benchmark / UI負荷対策

これらはclosedであっても、後続Issueの変更後に#85/#115のrelease gateで再検証する。

P0 release blockers

• [P0][Supply Chain] SBOM・transitive license・脆弱性・artifact provenanceをrelease gateにする #84 SBOM / transitive license / vulnerability / provenance
• [P0][Public Boundary] secret・PII・local path・release artifact scanをCI化する #104 public-boundary/release scan
• [P0][Security][Governance] v1.0のlocal-first trust boundary脅威モデルと検証マトリクスを確定する #114 local-first trust-boundary threat model / control matrix
• [P0][Network] loopback bindとruntime外部通信禁止をfail-closedで強制する #90 fail-closed loopback/runtime network
• [P0][Storage][Security] local data・DB・logs・runtime secretを最小権限で保護する #92 local filesystem/secret permissions
• [P0][Privacy] user・case・source参照をdataset-scoped keyed pseudonymへ置換する #91 dataset-scoped keyed pseudonym
• [P0][Privacy] maskingを安全なデータ境界にしraw PIIをAPI・保存・exportから除去する #76 safe DTOとraw PII遮断
• [P0][Security] CSV・Mermaid・Markdown・draw.io出力を文法別にescapeしinjectionを防止する #89 output-format injection hardening
• [P0][Consent] versioned consent receipt・purpose limitation・withdrawalをデータmodelへ追加する #93 consent receipt/purpose/withdrawal
• [P0][Consent] 実際の収集設定と一致する参加者向け説明書をローカル生成する #64 consent explanation
• [P0][Privacy][Import UX] CSV/JSONの列名を安全なmapping tokenへ変換し、previewからraw schema metadataを除去する #132 safe import mapping token / raw schema metadata removal
• [P0][Import] CSV/JSON importの破壊的replaceを明示mode・impact preview・transactionへ置換する #116 CSV/JSON importの明示mode・impact preview・atomic commit
• [P0][Storage] 永続化commit失敗時のin-memory phantom stateを排除し全mutationをatomicにする #117 永続化commit失敗時のphantom state排除（PR #123で完了）
• [P0][Storage] project/案件単位でデータセットを完全分離する #40 project/案件分離
• [P0][Privacy UX] sample dataと実記録のprovenanceを明示し実データの誤削除を防止する #118 sampleと実記録のprovenance・誤削除防止
• [P0][Privacy][Storage] 保持期間ポリシーと自動削除を検証可能にする #53 retention実行と削除検証
• [P0][Privacy][Operations] アンインストールと全データ削除をscope付きで安全に完結する #54 safe uninstall / all-data deletion
• [P0][Storage] 暗号化・検証可能なローカルbackup/restore/migrationを提供する #52 encrypted backup / restore / migration
• [P0][Mining UX] 案件スコープのラベル付けルールをUIで安全に編集・検証する #44 non-code labeling rules
• [P0][Privacy][Export] activity・app・手動labelの外部共有分類と小標本再識別抑止を導入する #133 external-share classification / small-cell disclosure control
• [P0][Mining] case/session推定と時間集計をgolden datasetで検証可能にする #83 case/session推定・時間集計・analysis receipt（完了）
• [P0][macOS] backendと記録agentを同梱した自己完結.appのlifecycleを実装する #78 self-contained .app runtime
• [P0][UX] Finder file picker・drag and drop・save dialogでpath入力を不要にする #79 Finder file UX
• [P0][UX] 非エンジニア向けに復旧action付きエラー体験を統一する #63 beginner recovery errors
• [P0][macOS][Security] 署名・notarization前提の配布パイプラインを整備する #57 Developer ID / Hardened Runtime / notarization
• [P0][Quality] packaged .appのclean Mac E2Eとv1 release acceptanceを強制する #85 packaged clean-Mac E2E / release acceptance

P1 enterprise quality gates

Analysis / deliverables

• [P1][Mining UX] バリアント分析を比較可能なevidence付き画面・exportにする #46 variant comparison
• [P1][Mining] ボトルネック候補を根拠・限界・改善仮説付きで説明可能にする #47 bottleneck evidence/hypothesis
• [P1][Mining] アプリ切替を往復・中断・集中時間のevidenceとして分析・共有する #48 app switching/interruption/focus
• [P1][Export UX] コンサル提出用のprivacy-safe成果物パッケージを生成する #50 consulting deliverable package
• [P1][Report UX] 日英のevidence付き報告書テンプレート・編集・再生成を提供する #51 report templates/editor
• [P1][Contract] API・backup・export schemaをversioningし互換性policyを定義する #86 API/backup/export schema compatibility
• [P1][Analysis] findingsから元evidence・coverage・confidenceへtraceできるようにする #99 finding evidence/coverage/confidence
• [P1][Analysis] project・期間・case・activity filterを全画面と全exportで一貫適用する #100 consistent analysis filters
• [P1][Handoff Integrity] source dataset fingerprintとprocess artifact hashを分離しLLM handoffのtraceabilityを保証する #119 source dataset fingerprint / handoff artifact integrity

Security / privacy / governance

• [P1][Security] import・HTTP・分析・exportにresource limitとcancelを導入する #88 resource limits and cancellation
• [P1][Audit] privacy-preserving local監査logと明示生成support bundleを実装する #94 privacy-safe audit/support bundle
• [P1][Enterprise] MDM配布可能なoffline policy profileとmanaged設定を設計する #96 offline managed policy/MDM
• [P1][OSS] SECURITY・CONTRIBUTING・CODE_OF_CONDUCT・SUPPORT・templateを整備する #103 OSS community/security policy

Reliability / UX / operations

• [P1][Operations UX] ワンクリックのprivacy-safe診断レポートと復旧導線を提供する #55 downloadable diagnostics
• [P1][Accessibility] キーボード・VoiceOver・視覚的理解で主要journeyを完走可能にする #59 accessibility/keyboard
• [P1][i18n] 日英の用語・翻訳完全性・表示品質をrelease gate化する #60 i18n glossary/coverage
• [P1][Reliability] crash・orphan process・SQLite corruptionをlocal recovery flowで復旧する #87 crash/orphan/DB recovery
• [P1][Recording] sleep/wake・clock change・agent crashでもsessionを正しく復旧する #95 sleep/wake/clock/crash recording
• [P1][UX] 長時間import・analysis・exportをbackground job化し進捗・cancel・retryを提供する #97 background progress/cancel/retry
• [P1][Privacy UX] 常時見える記録indicator・privacy zone・emergency pauseを追加する #98 visible recording/privacy controls
• [P1][Release] version・SemVer・upgrade・rollback・support matrixをv1.0へ統一する #101 version/upgrade/rollback/support matrix
• [P1][Docs] 公開feature matrixを実装・UI・READMEと自動同期する #102 feature matrix/docs sync
• [P1][Quality] critical-path coverage・failure-injection・test skip policyをrelease gate化する #115 critical-path coverage / failure injection / test-skip policy
• [P1][UX][Data Safety] event編集・exclude・split・merge・bulk操作にrevision付きundo/redoを提供する #120 revisioned undo/redo for destructive edits
• [P1][Storage][UX] stale revisionを拒否するmutation receiptとoptimistic concurrencyを実装する #122 optimistic concurrency / mutation receipt
• [P1][macOS][Privacy UX] permission preflight・revocation・import-only fallbackを実装する #124 macOS permission lifecycle / import-only fallback
• [P1][UX][IA] 初心者向けのタスク進行ナビゲーションと段階的な分析画面を設計する #125 beginner task navigation / progressive disclosure
• [P1][UX][LLM Handoff] Mermaid用の手動LLM受け渡しをreview wizard化する #126 manual Mermaid handoff review wizard
• [P1][Privacy][Export] 保存先の同期・network・removable mediaを判定するmanaged export policyを導入する #127 managed export destination policy
• [P1][Privacy Governance] participant access・correction・withdrawal/delete requestをproject scopeで処理する #128 participant access/correction/withdrawal request
• [P1][Operability] disk capacity budget・reserved-space preflight・orphan staging cleanupを実装する #129 disk capacity / staging lifecycle
• [P1][Recording Reliability] agent→API outage時のbounded queue・backpressure・visible safe pauseを実装する #130 recording outage queue / safe pause

Critical path

1. Public/release foundation: [P0][Legal] Apache-2.0 LICENSEを公式全文へ修復しGitHubのlicense検出を回復する #74 → [P0][CI] macOS品質gate・required checks・main保護を導入する #81 → [P0][Supply Chain] SBOM・transitive license・脆弱性・artifact provenanceをrelease gateにする #84 → [P0][Public Boundary] secret・PII・local path・release artifact scanをCI化する #104
2. Trust boundary: [P0][Security] Local API全体を認証しlocalhost CSRFと不正ローカル操作を防止する #75 / [P0][Security] import/exportのファイル操作をTauriの明示選択scopeに限定する #77 → [P0][Security][Governance] v1.0のlocal-first trust boundary脅威モデルと検証マトリクスを確定する #114 → [P0][Network] loopback bindとruntime外部通信禁止をfail-closedで強制する #90 / [P0][Storage][Security] local data・DB・logs・runtime secretを最小権限で保護する #92 → [P0][Privacy] user・case・source参照をdataset-scoped keyed pseudonymへ置換する #91 → [P0][Privacy] maskingを安全なデータ境界にしraw PIIをAPI・保存・exportから除去する #76 → [P0][Security] CSV・Mermaid・Markdown・draw.io出力を文法別にescapeしinjectionを防止する #89
3. Consent and lifecycle: [P0][Storage] project/案件単位でデータセットを完全分離する #40 → [P0][Consent] versioned consent receipt・purpose limitation・withdrawalをデータmodelへ追加する #93 → [P0][Consent] 実際の収集設定と一致する参加者向け説明書をローカル生成する #64 / [P0][Privacy][Storage] 保持期間ポリシーと自動削除を検証可能にする #53 → [P0][Privacy][Operations] アンインストールと全データ削除をscope付きで安全に完結する #54 / [P1][Audit] privacy-preserving local監査logと明示生成support bundleを実装する #94 / [P1][Privacy Governance] participant access・correction・withdrawal/delete requestをproject scopeで処理する #128; [P0][Storage][Security] local data・DB・logs・runtime secretを最小権限で保護する #92 / [P0][Privacy] user・case・source参照をdataset-scoped keyed pseudonymへ置換する #91 → [P0][Storage] 暗号化・検証可能なローカルbackup/restore/migrationを提供する #52 → [P1][Contract] API・backup・export schemaをversioningし互換性policyを定義する #86
4. Safe import and mining evidence: [P0][Privacy] maskingを安全なデータ境界にしraw PIIをAPI・保存・exportから除去する #76 → [P0][Privacy][Import UX] CSV/JSONの列名を安全なmapping tokenへ変換し、previewからraw schema metadataを除去する #132 → [P0][UX] Finder file picker・drag and drop・save dialogでpath入力を不要にする #79 → [P0][Import] CSV/JSON importの破壊的replaceを明示mode・impact preview・transactionへ置換する #116; [P0][Privacy] maskingを安全なデータ境界にしraw PIIをAPI・保存・exportから除去する #76 → [P0][Mining UX] 案件スコープのラベル付けルールをUIで安全に編集・検証する #44 → [P1][Analysis] project・期間・case・activity filterを全画面と全exportで一貫適用する #100 → [P1][Analysis] findingsから元evidence・coverage・confidenceへtraceできるようにする #99 → [P1][Mining UX] バリアント分析を比較可能なevidence付き画面・exportにする #46 / [P1][Mining] ボトルネック候補を根拠・限界・改善仮説付きで説明可能にする #47 / [P1][Mining] アプリ切替を往復・中断・集中時間のevidenceとして分析・共有する #48
5. External artifacts: [P0][Privacy] maskingを安全なデータ境界にしraw PIIをAPI・保存・exportから除去する #76 / [P0][Security] CSV・Mermaid・Markdown・draw.io出力を文法別にescapeしinjectionを防止する #89 / [P0][Privacy] user・case・source参照をdataset-scoped keyed pseudonymへ置換する #91 / [P0][Storage][Security] local data・DB・logs・runtime secretを最小権限で保護する #92 / [P1][Analysis] findingsから元evidence・coverage・confidenceへtraceできるようにする #99 / [P1][Analysis] project・期間・case・activity filterを全画面と全exportで一貫適用する #100 / [P1][Handoff Integrity] source dataset fingerprintとprocess artifact hashを分離しLLM handoffのtraceabilityを保証する #119 / [P0][Privacy][Export] activity・app・手動labelの外部共有分類と小標本再識別抑止を導入する #133 → [P1][UX][LLM Handoff] Mermaid用の手動LLM受け渡しをreview wizard化する #126 → [P1][Export UX] コンサル提出用のprivacy-safe成果物パッケージを生成する #50 / [P1][Report UX] 日英のevidence付き報告書テンプレート・編集・再生成を提供する #51. [P1][Privacy][Export] 保存先の同期・network・removable mediaを判定するmanaged export policyを導入する #127 is a shared export-destination gate.
6. Mac product: [P0][macOS][Security] Tauriがlocal sidecarを所有するruntime基盤を先行実装する #107 → [P0][macOS] backendと記録agentを同梱した自己完結.appのlifecycleを実装する #78 → [P0][macOS][Security] 署名・notarization前提の配布パイプラインを整備する #57 → [P0][Quality] packaged .appのclean Mac E2Eとv1 release acceptanceを強制する #85. [P1][Recording] sleep/wake・clock change・agent crashでもsessionを正しく復旧する #95 / [P1][Privacy UX] 常時見える記録indicator・privacy zone・emergency pauseを追加する #98 / [P1][macOS][Privacy UX] permission preflight・revocation・import-only fallbackを実装する #124 / [P1][Recording Reliability] agent→API outage時のbounded queue・backpressure・visible safe pauseを実装する #130 attach to the same recording lifecycle; [P0][UX] 非エンジニア向けに復旧action付きエラー体験を統一する #63 / [P1][UX][IA] 初心者向けのタスク進行ナビゲーションと段階的な分析画面を設計する #125 make the journey non-engineer-safe.
7. Cross-cutting quality: [P1][Security] import・HTTP・分析・exportにresource limitとcancelを導入する #88 supplies bounded resource/cancel primitives to [P1][UX] 長時間import・analysis・exportをbackground job化し進捗・cancel・retryを提供する #97; [P1][Storage][UX] stale revisionを拒否するmutation receiptとoptimistic concurrencyを実装する #122 supplies mutation receipts to [P1][UX][Data Safety] event編集・exclude・split・merge・bulk操作にrevision付きundo/redoを提供する #120; [P1][Accessibility] キーボード・VoiceOver・視覚的理解で主要journeyを完走可能にする #59 / [P1][i18n] 日英の用語・翻訳完全性・表示品質をrelease gate化する #60 / [P1][Quality] critical-path coverage・failure-injection・test skip policyをrelease gate化する #115 validate all critical journeys. [P1][OSS] SECURITY・CONTRIBUTING・CODE_OF_CONDUCT・SUPPORT・templateを整備する #103 / [P1][Release] version・SemVer・upgrade・rollback・support matrixをv1.0へ統一する #101 / [P1][Docs] 公開feature matrixを実装・UI・READMEと自動同期する #102 complete the public release boundary.

Definition of Done

• P0/P1 checklistがすべてclose、または本epicにowner・理由・期限・user impactを持つ明示的なrelease exceptionが記録される
• ./scripts/test.sh、./scripts/lint.sh、./scripts/check_licenses.sh、./scripts/check_no_external_network.sh とCI required checksがpass
• packaged artifactでinstall→first run→record/import→analyze→manual LLM handoff export→delete→quitを完走
• signed/notarized/stapled artifact、SBOM、NOTICE、checksum、provenanceを検証
• safe exportとsupport bundleにcanary PII/secretが0件
• v0.1 dataのbackup/migration/rollbackを検証
• Apple Siliconを必須検証し、Intel対応有無をrelease notesへ明記
• README/日本語版/feature matrix/known limitations/support policyが実装と一致
• tag/release/publishは別途Tuzumiの明示承認があるまで実行しない

Claude Code運用ルール

• 1 Issue = 1 branch / PRを基本とし、本文の対象・非対象・依存関係を越えて実装を広げない。
• 実装前に関連Issue、current main、schema/version、既存testを確認する。closed Issueのコードを前提にせず、acceptanceを現行treeで再検証する。
• 各PRには Closes #<issue>、変更したcontract、実行した検証、残余risk、docs更新を記載する。
• runtimeのnetwork、LLM、telemetry、recording禁止項目、OSS license境界を変更してはいけない。曖昧な判断は docs/OPEN_QUESTIONS.md に残す。
• release/tag/publishはこのepicをcloseしても自動で実行しない。

検証記録

各IssueはPR、test evidence、残リスク、docs更新をリンクする。release candidate判定はこのepicへ Go / No-go / Conditional go として残す。

2026-07-20 バックログ整合更新

新規 release blocker

• [P0][Privacy][Import UX] CSV/JSONの列名を安全なmapping tokenへ変換し、previewからraw schema metadataを除去する #132 import previewのraw column header / JSON keyを短命mapping tokenへ置換する。#76のsafe DTOをpreviewにも適用するP0。
• [P0][Privacy][Export] activity・app・手動labelの外部共有分類と小標本再識別抑止を導入する #133 activity・app・manual/rule labelとrare/small-cell aggregateの外部共有を分類・抑止する。manual LLM handoffを含む外部artifactのP0。

優先度と順序の補正

• #76のraw PII境界を閉じるため、[P0][Security] CSV・Mermaid・Markdown・draw.io出力を文法別にescapeしinjectionを防止する #89 output-format injection、[P0][Network] loopback bindとruntime外部通信禁止をfail-closedで強制する #90 local-only runtime、[P0][Privacy] user・case・source参照をdataset-scoped keyed pseudonymへ置換する #91 keyed pseudonym、[P0][Storage][Security] local data・DB・logs・runtime secretを最小権限で保護する #92 local data/key permission、[P0][Consent] versioned consent receipt・purpose limitation・withdrawalをデータmodelへ追加する #93 versioned consent、[P0][Public Boundary] secret・PII・local path・release artifact scanをCI化する #104 public boundary scan、[P0][Security][Governance] v1.0のlocal-first trust boundary脅威モデルと検証マトリクスを確定する #114 threat modelをP0として先行する。
• Mac配布は #107 → #78 → #57 → #85。#78と#57の相互依存を置かない。
• manual Mermaid handoffは #76/#86/#89/#91/#92/#99/#100/#119/#127/#133 → #126 → #50。#105は全Issueを追跡するepicであり子Issueの依存先にしない。
• README/UI/release noteの配布・署名・対応arch表現は、[P1][Release] version・SemVer・upgrade・rollback・support matrixをv1.0へ統一する #101/#102で実artifact evidenceから生成・検証し、未達featureをproduction-readyと表示しない。

このepicのDefinition of Doneにある「P0/P1をすべてcloseまたは明示exception」は維持する。release/tag/publishはTuzumiの別途明示承認なしに行わない。

2026-07-20 release-tracking correction

• Baseline is main@c4a13c4a022bc92b2a6ce359c6a317a957333262. The v1.0.0 milestone has 56 open issues: this epic, 23 P0 blockers, and 32 P1 quality gates. Improvement: ブラウザ拡張の技術プレビュー範囲と権限UIを設計する #61 and Improvement: 改善ロードマップをWebUI上で優先度管理できるようにする #65 remain P2 and outside the milestone.
• PR feat: enforce privacy-safe event boundary #134 is the only open implementation PR. It is linked as Closes #76, but its macos-core performance smoke is failing (100000 events: summary generation exceeded 5.0 seconds). Do not close [P0][Privacy] maskingを安全なデータ境界にしraw PIIをAPI・保存・exportから除去する #76 manually; first restore the existing Improvement: 大量イベント向けの性能ベンチマークとUI負荷対策を追加する #58 performance gate, push, obtain green checks, and merge so GitHub closes [P0][Privacy] maskingを安全なデータ境界にしraw PIIをAPI・保存・exportから除去する #76 from the PR evidence.
• No P1 item is deferred from v1.0.0. A child issue may be closed only with an implementation PR, its acceptance evidence, updated docs, and residual-risk record; labels or roadmap text alone are not completion evidence.

[tuzuminami]

Release-tracking update: #122 をP1として追加。#117でatomic commitとfailure/recoveryを完了後、#122でdurable revision、expected_revision、operation ledger、409 stale revisionを実装して、複数画面・response-loss時のlast-writer-winsを排除する。