mirror of
https://github.com/nexu-io/open-design.git
synced 2026-09-20 06:15:06 +08:00
Tom Huang
bc6a246c65
* feat(deck): enhance slide deck functionality with speaker notes and navigation improvements - Added a switch for including speaker notes in slide decks, defaulting to true. - Updated keyboard navigation to include 'R' for resetting to the first slide. - Implemented click navigation for half-slide transitions. - Enhanced the deck framework to support hidden programmatic prev/next controls. - Improved handling of file inputs in question forms to support file submissions. This update aims to improve user experience in creating and presenting slide decks, ensuring better accessibility and functionality. * feat(artifacts): enforce semantic naming for user-facing deliverables - Updated guidelines to require semantic filenames derived from user briefs for new artifacts, moving away from defaulting to `index.html`. - Enhanced documentation to clarify naming conventions for HTML files, emphasizing the use of descriptive names like `investor-pitch-deck.html`. - Adjusted prompts and hints across the system to reflect these changes, ensuring consistency in user-facing outputs. - Improved test coverage to validate the new naming conventions and ensure proper implementation in various contexts. This update aims to enhance clarity and usability in project file management, promoting better organization and user experience. * feat(file-viewer): enhance speaker notes display and improve file workspace functionality - Updated the speaker notes section to include a styled placeholder for empty notes, improving user experience. - Changed the icon in the file workspace from "slides" to "panel-left" for better clarity. - Introduced new sub-category filtering options in the file workspace, enhancing organization and navigation. - Improved styling for the page creator search input and added visual feedback for loading states. These changes aim to enhance usability and visual consistency across the file viewer and workspace components. * test(web): align workspace tests with pages switcher * test(e2e): open design files through pages menu * fix(deck): keep source mode reachable * fix(workspace): restore uploaded file tabs * feat(deck-thumbnail): implement virtualized thumbnail rail for improved performance - Introduced a new `DeckThumbnailRail` component to optimize the rendering of deck thumbnails, reducing memory usage and improving load times. - Enhanced the `FileViewer` to integrate the new thumbnail rail, allowing for lazy loading of thumbnails based on viewport visibility. - Added tests for the `DeckThumbnailRail` to ensure correct functionality and caching behavior. - Updated styles for better visual consistency and performance during thumbnail rendering. These changes aim to enhance user experience by providing a smoother and more efficient way to navigate through deck slides. * feat(deck): enhance deck rendering with thumbnail support and keyboard shortcuts - Integrated `DeckSlideThumbnail` for rendering individual slides in a shadow root, improving performance and reducing main-thread load. - Updated `DeckThumbnailRail` to utilize the new thumbnail component, allowing for efficient slide navigation. - Implemented keyboard shortcuts for deck navigation, enhancing user experience during presentations. - Added tests for `buildDeckRenderInput` to ensure proper functionality of the deck stage fallback. - Improved styling for loading states in the viewer, providing a smoother visual experience. These changes aim to optimize the deck viewing experience by reducing resource consumption and enhancing interactivity. * feat(deck): improve thumbnail loading and speaker notes editing experience - Refactored `DeckSlideThumbnail` to enhance loading states with a new shimmer effect, improving visual feedback during thumbnail rendering. - Updated `DeckThumbnailRail` to manage loading states for thumbnails, ensuring a smoother user experience. - Simplified the speaker notes editing interface by removing the toggle switch, allowing direct editing from the notes body. - Enhanced accessibility by adding roles and focus states to speaker notes elements. - Added tests to verify the new loading states and speaker notes functionality. These changes aim to optimize the user experience in deck navigation and speaker notes management, providing a more intuitive and responsive interface. * feat(file-viewer): enhance version export functionality and speaker notes interaction - Introduced new export options for file versions, including PDF and image formats, improving the ability to download and share content. - Implemented a streamlined process for exporting version content, with progress indicators and error handling for a better user experience. - Enhanced speaker notes editing by refining event handling to prevent unintended focus shifts, ensuring a smoother editing experience. - Updated styles for improved visual consistency in the file version download interface. - Added tests to verify the functionality of version exports and speaker notes interactions. These changes aim to optimize the file viewer's usability and enhance the overall experience when managing and exporting project files. * fix(web): polish export menus and creator filters * fix(file-viewer): fall back to preview exports * test(file-viewer): cover version export fallbacks * test(file-viewer): assert loading skeleton by role * fix(file-viewer): restore html source mode affordance * fix(file-viewer): capture full version fallback snapshots * docs: trim slides handoff eof * test(exports): cover full preview snapshot requests * test(file-viewer): account for snapshot options arg * refactor(file-viewer, file-workspace): streamline export functions and enhance page creator dialog visibility * test(file-workspace): enhance slide template creation and mock plugin responses * feat(export): add support for versioned exports and enhance HTML export functionality * feat(export): implement versioned export support across multiple formats and enhance related tests * feat(file-viewer): enhance manual edit functionality with commit sequence tracking and add test for inline text session saving * style(speaker-notes): update filmstrip and thumb-frame styles for improved responsiveness and add corresponding tests * feat(file-viewer): enhance comment composer functionality with portal metrics and improve draw toolbar layout for mobile views * feat(analytics): track slide deck viewing experience Add analytics for the new deck/slides experience introduced in this PR: the deck viewer surface, in-deck slide navigation, thumbnail rail, and speaker-notes authoring. Presentation entry stays on the existing present_popover click to avoid double-counting. - contracts: DeckViewerSurfaceViewProps (surface_view), DeckViewerClickProps (ui_click), SpeakerNotesSaveResultProps (new speaker_notes_save_result event), wired into the event unions. - web: track* wrappers + fire helpers in FileViewer — deck_viewer surface_view on deck mount, slide_prev/next/reset, thumbnail_select, thumbnail_rail_toggle (expand/collapse), speaker_notes_edit, and speaker_notes_save_result (preview + presenter surfaces). - tests: deck analytics suite asserting the emitted (event, props) pairs. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * feat(file-viewer, file-workspace): enhance export toast functionality and improve localization for page creation * feat(home-view, plugins-home-section, agent-skill): update default facet preference, enhance category selection handling, and improve localization support - Set `preferDefaultFacet` to true in HomeView component for better user experience. - Introduced `handlePickCategory` function in PluginsHomeSection to manage category selection based on card layout visibility. - Updated PRIMARY_CATEGORIES to reflect the new order and added localization for titles and descriptions in adaptAgentSkill. - Enhanced tests to verify the correct handling of display copy and tags from SKILL frontmatter. * feat(plugins-home, file-workspace): introduce commercial category labels and enhance deck handling - Added a new module for resolving and localizing commercial category labels for plugins. - Updated the FileWorkspace and PluginCard components to display the commercial category label on deck cards. - Enhanced the PageCreatorPresetFrame to adjust frame classes based on deck presets. - Refactored subcategory handling in facets to align with the new commercial category taxonomy. - Improved localization support for new category labels across multiple languages. * feat(deck-preview): implement deck preview scaling and enhance home hero layout - Introduced `useDeckPreviewScale` hook to manage scaling of deck previews within a fixed 1280×720 logical viewport, ensuring proportional rendering across various templates. - Updated `FileWorkspace`, `HomeHero`, and `PluginCard` components to utilize the new scaling functionality for improved visual consistency. - Enhanced the layout of the home hero section to accommodate new subtype chips and descriptions, including a "More" dropdown for overflow handling. - Improved localization support for new UI elements across multiple languages. * fix(PreviewModal): clarify sidebar prop documentation and update test description - Updated the documentation for the `PreviewSidebar` interface to specify that the sidebar's stage-edge handles are not shown when the sidebar prop is absent. - Modified the test suite description for `PreviewModal` to be more concise and relevant. * test(e2e): select prototype visual card --------- Co-authored-by: free666799 <293857035+free666799@users.noreply.github.com> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
604 lines
21 KiB
HTML
604 lines
21 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<title>Write an Architecture Review like a World-Class Staff Engineer - Product management</title>
|
||
<link href="https://fonts.googleapis.com/css2?family=Inter+Tight:wght@400;500;700;900&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
|
||
<style>
|
||
/* Sea Indigo - locked palette: bg #0a0e1a / ink #f5f5f7 / accent #5ac8fa */
|
||
:root{
|
||
--bg:#0a0e1a;
|
||
--ink:#f5f5f7;
|
||
--ink-dim:rgba(245,245,247,.68);
|
||
--ink-faint:rgba(245,245,247,.56);
|
||
--accent:#5ac8fa;
|
||
--line:rgba(245,245,247,.14);
|
||
--ease:cubic-bezier(.16,1,.3,1);
|
||
}
|
||
html,body{margin:0;padding:0}
|
||
body{
|
||
font-family:'Inter Tight',system-ui,sans-serif;
|
||
background:#020306;
|
||
height:100vh;
|
||
display:flex;align-items:center;justify-content:center;
|
||
overflow:hidden;
|
||
}
|
||
.stage{
|
||
width:1920px;height:1080px;
|
||
flex:none;
|
||
transform:scale(0.625);
|
||
transform-origin:center center;
|
||
position:relative;
|
||
background:var(--bg);
|
||
color:var(--ink);
|
||
/* single-accent ambient glow, cyan family only */
|
||
background-image:
|
||
radial-gradient(circle at 18% 82%, rgba(90,200,250,.10) 0%, transparent 50%),
|
||
radial-gradient(circle at 84% 22%, rgba(90,200,250,.045) 0%, transparent 55%);
|
||
}
|
||
/* ---- multi-slide canvas: stacked sections, one active ---- */
|
||
.slide{
|
||
position:absolute;inset:0;
|
||
padding:160px;
|
||
box-sizing:border-box;
|
||
display:flex;flex-direction:column;justify-content:space-between;
|
||
opacity:0;visibility:hidden;
|
||
transition:opacity .4s var(--ease), visibility .4s;
|
||
}
|
||
.slide.active{opacity:1;visibility:visible}
|
||
.mono{font-family:'JetBrains Mono',ui-monospace,monospace}
|
||
.accent{color:var(--accent)}
|
||
.meta{
|
||
display:flex;align-items:baseline;justify-content:space-between;
|
||
font-size:17px;text-transform:uppercase;
|
||
}
|
||
.meta-top{letter-spacing:.18em;color:var(--ink-dim);
|
||
border-bottom:1px solid var(--line);padding-bottom:28px}
|
||
.meta-bottom{letter-spacing:.18em;color:var(--ink-faint);
|
||
border-top:1px solid var(--line);padding-top:28px}
|
||
.meta-bottom .link{color:var(--accent)}
|
||
.kicker{
|
||
font-size:19px;letter-spacing:.22em;text-transform:uppercase;
|
||
color:var(--accent);
|
||
}
|
||
/* signature underline device */
|
||
.u{box-shadow:inset 0 -10px 0 0 rgba(90,200,250,.45)}
|
||
h1{
|
||
margin:36px 0 0;
|
||
font-size:160px;
|
||
font-weight:900;
|
||
line-height:.98;
|
||
letter-spacing:-.025em;
|
||
}
|
||
h1 .cloud{color:var(--accent)}
|
||
h1 .desk{
|
||
font-style:normal;
|
||
box-shadow:inset 0 -10px 0 0 rgba(90,200,250,.45);
|
||
}
|
||
.sub{
|
||
margin:56px 0 0;
|
||
font-size:36px;
|
||
font-weight:400;
|
||
color:var(--ink-dim);
|
||
max-width:1380px;
|
||
line-height:1.45;
|
||
}
|
||
/* staggered entrance: transform + opacity only */
|
||
.reveal{opacity:0;transform:translateY(24px)}
|
||
.slide.active .reveal{animation:reveal .8s var(--ease) forwards}
|
||
.slide.active .d1{animation-delay:.05s}
|
||
.slide.active .d2{animation-delay:.13s}
|
||
.slide.active .d3{animation-delay:.21s}
|
||
.slide.active .d4{animation-delay:.29s}
|
||
.slide.active .d5{animation-delay:.37s}
|
||
@keyframes reveal{to{opacity:1;transform:translateY(0)}}
|
||
@media (prefers-reduced-motion: reduce){
|
||
.slide{transition:none}
|
||
.reveal,.slide.active .reveal{animation:none;opacity:1;transform:none}
|
||
}
|
||
|
||
/* ---- 02 · asymmetric split ---- */
|
||
.split{display:flex;align-items:flex-end;gap:120px}
|
||
.split-main{flex:1 1 auto}
|
||
.split h2{
|
||
margin:36px 0 0;
|
||
font-size:120px;font-weight:900;line-height:1.0;letter-spacing:-.02em;
|
||
}
|
||
.split-aside{
|
||
flex:0 0 460px;
|
||
align-self:flex-start;
|
||
margin-top:96px;
|
||
border-left:1px solid var(--line);
|
||
padding-left:48px;
|
||
}
|
||
.split-aside p{
|
||
margin:0 0 36px;
|
||
font-size:28px;line-height:1.55;color:var(--ink-dim);font-weight:400;
|
||
}
|
||
.split-aside .tags{
|
||
font-size:18px;letter-spacing:.18em;color:var(--accent);margin:0;
|
||
}
|
||
|
||
/* ---- 03 · full-bleed section break ---- */
|
||
.break-wrap{align-self:flex-start}
|
||
.break-wrap h2{
|
||
margin:40px 0 0;
|
||
font-size:220px;font-weight:900;line-height:.95;letter-spacing:-.02em;
|
||
}
|
||
.break-sub{
|
||
margin:48px 0 0;
|
||
font-size:36px;color:var(--ink-dim);font-weight:400;
|
||
}
|
||
|
||
/* ---- 04 · oversized numeral stat ---- */
|
||
.stat-row{display:flex;align-items:baseline;gap:64px;margin-top:40px}
|
||
.stat-num{
|
||
font-size:220px;font-weight:900;letter-spacing:-.03em;line-height:1;
|
||
box-shadow:inset 0 -14px 0 0 rgba(90,200,250,.45);
|
||
}
|
||
.stat-label{
|
||
font-size:48px;font-weight:400;color:var(--ink-dim);
|
||
}
|
||
.stat-foot{
|
||
margin:72px 0 0;
|
||
font-size:22px;letter-spacing:.14em;color:var(--ink-faint);text-transform:uppercase;
|
||
}
|
||
.stat-foot b{color:var(--ink);font-weight:500}
|
||
|
||
/* ---- 05 · three-column evidence ---- */
|
||
.cols3{
|
||
display:grid;grid-template-columns:1fr 1fr 1fr;gap:80px;
|
||
margin-top:64px;
|
||
}
|
||
.col{border-top:1px solid var(--line);padding-top:44px}
|
||
.col-num{
|
||
font-size:88px;font-weight:900;letter-spacing:-.02em;line-height:1;
|
||
color:var(--accent);
|
||
}
|
||
.col-name{
|
||
margin-top:20px;
|
||
font-size:36px;font-weight:700;
|
||
}
|
||
.col-desc{
|
||
margin:24px 0 0;
|
||
font-size:24px;line-height:1.55;color:var(--ink-dim);font-weight:400;
|
||
}
|
||
|
||
/* ---- 06 · comparison spread ---- */
|
||
.cmp-row{display:flex;align-items:baseline;gap:96px;margin-top:56px}
|
||
.cmp-label{font-size:18px;letter-spacing:.18em;text-transform:uppercase;color:var(--ink-faint)}
|
||
.cmp-label.on{color:var(--accent)}
|
||
.cmp-old{
|
||
font-size:120px;font-weight:900;letter-spacing:-.02em;line-height:1;
|
||
color:var(--ink-faint);margin-top:28px;
|
||
text-decoration:line-through;
|
||
text-decoration-color:rgba(90,200,250,.55);
|
||
text-decoration-thickness:8px;
|
||
}
|
||
.cmp-new{
|
||
font-size:220px;font-weight:900;letter-spacing:-.03em;line-height:1;
|
||
margin-top:28px;
|
||
box-shadow:inset 0 -14px 0 0 rgba(90,200,250,.45);
|
||
}
|
||
.cmp-arrow{font-size:88px;color:var(--accent);font-weight:400;align-self:center}
|
||
.cmp-sub{margin-top:28px;font-size:24px;color:var(--ink-dim);font-weight:400}
|
||
.cmp-foot{
|
||
margin:64px 0 0;
|
||
font-size:22px;letter-spacing:.14em;color:var(--accent);
|
||
}
|
||
|
||
/* ---- 07 · flow built from positioned blocks ---- */
|
||
.flow{position:relative;height:560px;margin-top:48px}
|
||
.node{
|
||
position:absolute;box-sizing:border-box;
|
||
border:1px solid var(--line);
|
||
padding:36px 40px;
|
||
background:rgba(245,245,247,.03);
|
||
}
|
||
.node.on{border-color:rgba(90,200,250,.65)}
|
||
.node .n{font-size:18px;letter-spacing:.18em;color:var(--accent)}
|
||
.node h3{margin:18px 0 0;font-size:36px;font-weight:700;line-height:1.1}
|
||
.node p{margin:16px 0 0;font-size:22px;line-height:1.5;color:var(--ink-dim);font-weight:400}
|
||
.edge{
|
||
position:absolute;height:1px;background:rgba(90,200,250,.5);
|
||
transform-origin:0 0;
|
||
}
|
||
|
||
/* ---- 08 · editorial long-quote ---- */
|
||
.quote-wrap{padding-left:200px;position:relative;align-self:flex-start;max-width:1340px}
|
||
.qmark{
|
||
position:absolute;left:0;top:-40px;
|
||
font-size:220px;font-weight:900;color:var(--accent);line-height:1;
|
||
}
|
||
blockquote{
|
||
margin:0;
|
||
font-size:64px;font-weight:700;line-height:1.3;letter-spacing:-.01em;
|
||
}
|
||
.cite{
|
||
margin-top:56px;
|
||
font-size:19px;letter-spacing:.22em;text-transform:uppercase;color:var(--ink-faint);
|
||
}
|
||
|
||
/* ---- 09 · principles list ---- */
|
||
.list-head{
|
||
margin:36px 0 0;
|
||
font-size:88px;font-weight:900;letter-spacing:-.02em;line-height:1.02;
|
||
}
|
||
.plist{list-style:none;margin:72px 0 0;padding:0}
|
||
.plist li{
|
||
display:grid;grid-template-columns:120px 420px 1fr;align-items:baseline;
|
||
border-top:1px solid var(--line);
|
||
padding:30px 0;
|
||
}
|
||
.pnum{font-size:19px;letter-spacing:.18em;color:var(--accent)}
|
||
.pname{font-size:36px;font-weight:700}
|
||
.pdesc{font-size:24px;color:var(--ink-dim);font-weight:400}
|
||
|
||
/* ---- 10 · closing CTA ---- */
|
||
.cta-head{
|
||
margin:36px 0 0;
|
||
font-size:160px;font-weight:900;line-height:.98;letter-spacing:-.025em;
|
||
}
|
||
.cta-links{
|
||
display:flex;gap:80px;margin-top:88px;
|
||
}
|
||
.cta-link .ch{font-size:18px;letter-spacing:.18em;color:var(--ink-faint);text-transform:uppercase}
|
||
.cta-link .cv{margin-top:14px;font-size:26px;color:var(--accent)}
|
||
|
||
@media print{
|
||
body{display:block}
|
||
.stage{transform:none}
|
||
.slide{position:relative;opacity:1;visibility:visible}
|
||
}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div class="stage">
|
||
|
||
<!-- 01 · full-bleed question cover -->
|
||
<section class="slide active" data-slide-id="1">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№01 / 10</span>
|
||
</header>
|
||
|
||
<div>
|
||
<div class="kicker mono reveal d1">Decision Needed — RFC-014</div>
|
||
<h1 class="reveal d2">
|
||
Local daemon<br/>
|
||
architecture: lock it,<br/>
|
||
or keep it <span class="desk">open</span>?
|
||
</h1>
|
||
<p class="sub reveal d3">
|
||
This review recommends freezing the daemon + agent-runtime data boundary before v1.0 GA. Staff eng, tech leads, and security sign off below.
|
||
</p>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">github.com/nexu-io/open-design</span>
|
||
<span>00 : 00 : 00</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 02 · asymmetric split: statement + narrow aside -->
|
||
<section class="slide" data-slide-id="2">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№02 / 10</span>
|
||
</header>
|
||
|
||
<div class="split">
|
||
<div class="split-main">
|
||
<div class="kicker mono reveal d1">The Problem</div>
|
||
<h2 class="reveal d2">
|
||
Three teams.<br/>
|
||
Three runtimes.<br/>
|
||
<span class="u">Zero agreement.</span>
|
||
</h2>
|
||
</div>
|
||
<aside class="split-aside reveal d3">
|
||
<p>
|
||
Desktop, web, and packaged builds each spawn the agent runtime
|
||
differently today. Namespace collisions and orphaned sidecars
|
||
account for 41% of this quarter's P1 tickets.
|
||
</p>
|
||
<p>Every new agent adapter re-derives its own data path instead of inheriting one resolved root.</p>
|
||
<p class="tags mono">OD_DATA_DIR · SIDECAR-PROTO · P1 × 41%</p>
|
||
</aside>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">github.com/nexu-io/open-design</span>
|
||
<span>00 : 02 : 40</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 03 · full-bleed section break -->
|
||
<section class="slide" data-slide-id="3">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№03 / 10</span>
|
||
</header>
|
||
|
||
<div class="break-wrap">
|
||
<div class="kicker mono reveal d1">Part 01 — The Pain</div>
|
||
<h2 class="reveal d2">DRIFT<span class="accent">.</span></h2>
|
||
<p class="break-sub reveal d3">What happens when every surface guesses its own data root.</p>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">discord.gg/mHAjSMV6gz</span>
|
||
<span>00 : 05 : 05</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 04 · oversized numeral stat -->
|
||
<section class="slide" data-slide-id="4">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№04 / 10</span>
|
||
</header>
|
||
|
||
<div>
|
||
<div class="kicker mono reveal d1">Incident History</div>
|
||
<div class="stat-row reveal d2">
|
||
<span class="stat-num">6</span>
|
||
<span class="stat-label">sidecar identity clashes this quarter</span>
|
||
</div>
|
||
<p class="stat-foot mono reveal d3">
|
||
<b>3 of 6</b> traced to a runtime writing outside RUNTIME_DATA_DIR — root cause, not symptom.
|
||
</p>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">github.com/nexu-io/open-design</span>
|
||
<span>00 : 07 : 30</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 05 · three-column evidence grid -->
|
||
<section class="slide" data-slide-id="5">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№05 / 10</span>
|
||
</header>
|
||
|
||
<div>
|
||
<div class="kicker mono reveal d1">Options On The Table</div>
|
||
<div class="cols3">
|
||
<div class="col reveal d1">
|
||
<div class="col-num">A</div>
|
||
<div class="col-name">status quo</div>
|
||
<p class="col-desc">Each app resolves OD_DATA_DIR itself. Fast to ship, impossible to audit.</p>
|
||
</div>
|
||
<div class="col reveal d2">
|
||
<div class="col-num">B</div>
|
||
<div class="col-name">shared config file</div>
|
||
<p class="col-desc">One JSON on disk every app reads. Removes drift but adds a second source of truth.</p>
|
||
</div>
|
||
<div class="col reveal d3">
|
||
<div class="col-num">C</div>
|
||
<div class="col-name">daemon-resolved root</div>
|
||
<p class="col-desc">server.ts resolves OD_DATA_DIR once into RUNTIME_DATA_DIR; every path derives from it.</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">github.com/nexu-io/open-design</span>
|
||
<span>00 : 10 : 15</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 06 · comparison spread: the bill -->
|
||
<section class="slide" data-slide-id="6">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№06 / 10</span>
|
||
</header>
|
||
|
||
<div>
|
||
<div class="kicker mono reveal d1">The Tradeoff</div>
|
||
<div class="cmp-row">
|
||
<div class="reveal d2">
|
||
<div class="cmp-label mono">Shared config file (Option B)</div>
|
||
<div class="cmp-old">2 wk</div>
|
||
<div class="cmp-sub">ship time, new failure mode</div>
|
||
</div>
|
||
<div class="cmp-arrow reveal d3">→</div>
|
||
<div class="reveal d4">
|
||
<div class="cmp-label mono on">Daemon-resolved root (Option C)</div>
|
||
<div class="cmp-new">5 wk</div>
|
||
<div class="cmp-sub">one truth source, harder to bypass</div>
|
||
</div>
|
||
</div>
|
||
<p class="cmp-foot mono reveal d5">2wk → 5wk (+3wk) · PAY THE MIGRATION ONCE, NOT PER INCIDENT</p>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">x.com/nexudotio</span>
|
||
<span>00 : 13 : 00</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 07 · flow built from positioned blocks -->
|
||
<section class="slide" data-slide-id="7">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№07 / 10</span>
|
||
</header>
|
||
|
||
<div>
|
||
<div class="kicker mono reveal d1">The Recommendation</div>
|
||
<div class="flow">
|
||
<div class="node reveal d2" style="left:0;top:30px;width:430px">
|
||
<div class="n mono">01 · RESOLVE</div>
|
||
<h3>server.ts owns it</h3>
|
||
<p>OD_DATA_DIR is read exactly once, at daemon startup, into RUNTIME_DATA_DIR.</p>
|
||
</div>
|
||
<div class="edge" style="left:430px;top:160px;width:212px;transform:rotate(33deg)"></div>
|
||
<div class="node on reveal d3" style="left:610px;top:190px;width:460px">
|
||
<div class="n mono">02 · DERIVE</div>
|
||
<h3>Every path descends</h3>
|
||
<p>PROJECTS_DIR, ARTIFACTS_DIR, SQLite, MCP tokens — all constants of RUNTIME_DATA_DIR.</p>
|
||
</div>
|
||
<div class="edge" style="left:1070px;top:330px;width:200px;transform:rotate(36deg)"></div>
|
||
<div class="node reveal d4" style="left:1190px;top:360px;width:410px">
|
||
<div class="n mono">03 · INHERIT</div>
|
||
<h3>Agents don't guess</h3>
|
||
<p>Subprocesses receive the resolved root as OD_DATA_DIR; adapters stop inventing their own.</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">github.com/nexu-io/open-design</span>
|
||
<span>00 : 16 : 20</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 08 · editorial long-quote -->
|
||
<section class="slide" data-slide-id="8">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№08 / 10</span>
|
||
</header>
|
||
|
||
<div class="quote-wrap">
|
||
<div class="qmark reveal d1">“</div>
|
||
<blockquote class="reveal d2">
|
||
If a change needs a data-path rule not covered here, request a
|
||
core-maintainer decision — <span class="u">don't invent a new convention</span>.
|
||
</blockquote>
|
||
<div class="cite mono reveal d3">— Architecture review · daemon data directory contract, decision record</div>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">discord.gg/mHAjSMV6gz</span>
|
||
<span>00 : 19 : 45</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 09 · principles list -->
|
||
<section class="slide" data-slide-id="9">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№09 / 10</span>
|
||
</header>
|
||
|
||
<div>
|
||
<h2 class="list-head reveal d1">Lock these four, <span class="u">nothing else</span>.</h2>
|
||
<ul class="plist">
|
||
<li class="reveal d2">
|
||
<span class="pnum mono">01</span>
|
||
<span class="pname">Single root</span>
|
||
<span class="pdesc">RUNTIME_DATA_DIR is the only daemon data-root truth source — no exceptions.</span>
|
||
</li>
|
||
<li class="reveal d3">
|
||
<span class="pnum mono">02</span>
|
||
<span class="pname">Named exceptions only</span>
|
||
<span class="pdesc">OD_MEDIA_CONFIG_DIR and OD_LEGACY_DATA_DIR are the sole sanctioned overrides.</span>
|
||
</li>
|
||
<li class="reveal d4">
|
||
<span class="pnum mono">03</span>
|
||
<span class="pname">Inherited, not inferred</span>
|
||
<span class="pdesc">Agent subprocesses receive OD_DATA_DIR from the daemon; they never resolve their own.</span>
|
||
</li>
|
||
<li class="reveal d5">
|
||
<span class="pnum mono">04</span>
|
||
<span class="pname">Escape hatches banned</span>
|
||
<span class="pdesc">Cwd-relative defaults and per-adapter data-root helpers are blocked in review, not just noted.</span>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">github.com/nexu-io/open-design</span>
|
||
<span>00 : 22 : 10</span>
|
||
</footer>
|
||
</section>
|
||
|
||
<!-- 10 · closing CTA -->
|
||
<section class="slide" data-slide-id="10">
|
||
<header class="meta meta-top mono">
|
||
<span>OPEN DESIGN · DECK · OPEN-SLIDE CANVAS</span>
|
||
<span>SEA INDIGO</span>
|
||
<span>№10 / 10</span>
|
||
</header>
|
||
|
||
<div>
|
||
<div class="kicker mono reveal d1">Closing</div>
|
||
<h2 class="cta-head reveal d2">Run it <span class="u">tonight</span>.</h2>
|
||
<div class="cta-links reveal d3">
|
||
<div class="cta-link">
|
||
<div class="ch mono">Star & fork</div>
|
||
<div class="cv mono">github.com/nexu-io/open-design</div>
|
||
</div>
|
||
<div class="cta-link">
|
||
<div class="ch mono">Community</div>
|
||
<div class="cv mono">discord.gg/mHAjSMV6gz</div>
|
||
</div>
|
||
<div class="cta-link">
|
||
<div class="ch mono">Updates</div>
|
||
<div class="cv mono">x.com/nexudotio</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<footer class="meta meta-bottom mono">
|
||
<span>1920 × 1080 · CANVAS · KBD ← →</span>
|
||
<span class="link">github.com/nexu-io/open-design</span>
|
||
<span>00 : 24 : 30</span>
|
||
</footer>
|
||
</section>
|
||
|
||
</div>
|
||
|
||
<script>
|
||
// keyboard left/right + hash sync (#1 .. #10)
|
||
(function(){
|
||
var slides = Array.prototype.slice.call(document.querySelectorAll('.slide'));
|
||
var cur = 0;
|
||
function show(i){
|
||
i = Math.max(0, Math.min(slides.length - 1, i));
|
||
if (i === cur && slides[cur].classList.contains('active')) return;
|
||
slides[cur].classList.remove('active');
|
||
cur = i;
|
||
slides[cur].classList.add('active');
|
||
var h = '#' + (cur + 1);
|
||
if (location.hash !== h) history.replaceState(null, '', h);
|
||
}
|
||
function fromHash(){
|
||
var n = parseInt(location.hash.slice(1), 10);
|
||
if (n >= 1 && n <= slides.length) show(n - 1);
|
||
}
|
||
addEventListener('keydown', function(e){
|
||
if (e.key === 'ArrowRight' || e.key === 'PageDown' || e.key === ' ') show(cur + 1);
|
||
else if (e.key === 'ArrowLeft' || e.key === 'PageUp') show(cur - 1);
|
||
});
|
||
addEventListener('hashchange', fromHash);
|
||
fromHash();
|
||
})();
|
||
</script>
|
||
|
||
</body>
|
||
</html>
|