You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Docs/Public_Roadmap_3.0.md
+55Lines changed: 55 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -190,6 +190,50 @@ Planned export options:
190
190
- Export as plain text.
191
191
- Generate context packs for tools such as ChatGPT, Claude, or other AI assistants.
192
192
193
+
Planned file format conventions:
194
+
195
+
Core user files:
196
+
197
+
-`.md` for normal notes, phase notes, task notes, and plan notes, with optional YAML front matter.
198
+
-`.context.md` for human-readable context files.
199
+
-`.jam.md` for human-readable AI Jam sessions.
200
+
-`.context.json` for structured context import/export.
201
+
-`.jam.json` for structured AI Jam state or resumable sessions.
202
+
-`.orchkdb` for a full Orchestrana knowledge archive.
203
+
204
+
Pack and archive files:
205
+
206
+
-`.context.zip` for a context pack with `.context.md`, `.context.json`, assets, and a manifest.
207
+
-`.jam.zip` for an AI Jam pack with `.jam.md`, `.jam.json`, assets, and a manifest.
208
+
-`.phase.zip` for a focus phase or session pack with notes, decisions, blockers, and timer metadata.
209
+
-`.workspace.zip` for a workspace context pack with current goals, tasks, plans, notes, and summaries.
210
+
-`.orchbackup.zip` for a user backup archive used for app data export/import.
211
+
212
+
Structured JSON files inside packs:
213
+
214
+
-`manifest.json` for pack metadata, version, app build, and schema version.
215
+
-`context.json` for normalized context records.
216
+
-`jam.json` for AI Jam graph/session state.
217
+
-`notes.index.json` for note indexes and backlinks.
218
+
-`tasks.snapshot.json` for task state snapshots.
219
+
-`focus.sessions.json` for focus session history.
220
+
-`workspace.summary.json` for current workspace summaries.
221
+
-`pkb.records.json` for PKB knowledge records.
222
+
-`assets.index.json` for images and files referenced by notes or Jam sessions.
223
+
224
+
Optional human-readable files inside packs:
225
+
226
+
-`README.md` to explain what is inside the export.
227
+
-`notes.md` for exported notes.
228
+
-`context.md` for a readable context summary.
229
+
-`jam.md` for a readable Jam transcript or structure.
230
+
-`workspace.md` for a readable workspace summary.
231
+
-`decisions.md` for decisions captured during work.
232
+
-`open-questions.md` for unresolved questions.
233
+
-`next-actions.md` for suggested next actions.
234
+
235
+
The public extension surface should stay small. Most complexity should live inside ZIP packs with `manifest.json` so exported data remains portable without creating too many custom extensions.
236
+
193
237
Example context pack sections:
194
238
195
239
- User goal.
@@ -282,6 +326,17 @@ Planned rules:
282
326
- JSON export.
283
327
- Plain text export.
284
328
- External AI context packs.
329
+
- Markdown notes with YAML front matter.
330
+
- Human-readable `.context.md` context files.
331
+
- Human-readable `.jam.md` AI Jam files.
332
+
- Structured `.context.json` context exports.
333
+
- Structured `.jam.json` AI Jam exports.
334
+
- Complete `.orchkdb` knowledge archives.
335
+
- Portable `.jam.zip` AI Jam packs.
336
+
- Portable `.context.zip` context packs.
337
+
- Import from Orchestrana context files.
338
+
- Import from Orchestrana AI Jam files.
339
+
- Archive restore for Personal Knowledge Base data.
@@ -53,8 +53,15 @@ <h1 class="switchable-head" data-en="A calm open-source focus app for macOS" dat
53
53
<pclass="lede switchable" data-en="Orchestrana is a lightweight focus tool designed for people who want to work without distraction. It combines a clean timer, gentle focus flow sessions, and task awareness in a quiet interface.<br><br>Open-source core, thoughtfully evolving." data-zh="Orchestrana 是一个轻量级专注工具，为希望减少干扰、安静工作的用户设计。它结合了计时器、专注节奏模式和任务管理，界面简洁，不打扰你的工作。<br><br>核心开源，持续演进。">Orchestrana is a lightweight focus tool designed for people who want to work without distraction. It combines a clean timer, gentle focus flow sessions, and task awareness in a quiet interface.<br><br>Open-source core, thoughtfully evolving.</p>
54
54
<pclass="micro-hint" data-en="Try pressing the tomato" data-zh="试着点一下番茄">Try pressing the tomato</p>
<aclass="ghost-btn" href="https://github.com/T-1234567890/orchestrana-app" target="_blank" rel="noreferrer" data-i18n-key="view_github">View on GitHub</a>
56
+
<aclass="app-store-badge" href="https://apps.apple.com/app/orchestrana/id6758972580" target="_blank" rel="noreferrer" aria-label="Download on the Mac App Store">
57
+
<imgsrc="screenshots/Download_on_the_Mac_App_Store_Badge_US-UK_RGB_blk_092917.svg" alt="Download on the Mac App Store">
<imgalt="Orchestrana™ - Not just a timer — a system for focus and thinking | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1137252&theme=light&t=1778245895075">
<h2data-en="Official Apple preview builds are now available" data-zh="苹果官方预览版本现已可用">Official Apple preview builds are now available</h2>
168
+
<h2data-en="Now available on the App Store" data-zh="现已登陆 App Store">Now available on the App Store</h2>
156
169
</div>
157
-
<pclass="muted" data-en="Join the waitlist to request an invite." data-zh="加入等待名单以申请邀请。">Join the waitlist to request an invite.</p>
170
+
<pclass="muted" data-en="Download Orchestrana directly from the Mac App Store." data-zh="直接从 Mac App Store 下载 Orchestrana。">Download Orchestrana directly from the Mac App Store.</p>
<aclass="app-store-badge" href="https://apps.apple.com/app/orchestrana/id6758972580" target="_blank" rel="noreferrer" aria-label="Download on the Mac App Store">
173
+
<imgsrc="screenshots/Download_on_the_Mac_App_Store_Badge_US-UK_RGB_blk_092917.svg" alt="Download on the Mac App Store">
174
+
</a>
160
175
</div>
161
-
<pclass="waitlist-note" data-en="Invites are sent in batches to prevent spam." data-zh="邀请将分批发送，以防止滥用。">Invites are sent in batches to prevent spam.</p>
176
+
<pclass="waitlist-note" data-en="Latest builds are distributed through Apple's store." data-zh="最新版本通过 Apple 商店分发。">Latest builds are distributed through Apple's store.</p>
162
177
</div>
163
178
</section>
164
179
@@ -313,11 +328,13 @@ <h2 data-en="Documentation is part of the open development process." data-zh="
<h2data-en="Download latest version from TestFlight." data-zh="从 TestFlight 下载最新版本。">Download latest version from TestFlight.</h2>
318
-
<pclass="muted" data-en="macOS may warn about unsigned apps. This is expected for open-source software." data-zh="macOS 可能提示未签名应用，这是开源软件的正常行为。">macOS may warn about unsigned apps. This is expected for open-source software.</p>
<h2data-en="Now available on the App Store." data-zh="现已登陆 App Store。">Now available on the App Store.</h2>
333
+
<pclass="muted" data-en="Get the latest Mac build from the App Store." data-zh="从 App Store 获取最新 Mac 版本。">Get the latest Mac build from the App Store.</p>
<aclass="app-store-badge" href="https://apps.apple.com/app/orchestrana/id6758972580" target="_blank" rel="noreferrer" aria-label="Download on the Mac App Store">
336
+
<imgsrc="screenshots/Download_on_the_Mac_App_Store_Badge_US-UK_RGB_blk_092917.svg" alt="Download on the Mac App Store">
<pclass="join-card-subtitle" data-en="Download the current release" data-zh="下载当前版本">Download the current release</p>
360
+
<pclass="join-card-support" data-en="Get the latest version from Apple's store" data-zh="从 Apple 商店获取最新版本">Get the latest version from Apple's store</p>
0 commit comments