feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185

Merged
KrisBraun merged 11 commits into
mainfrom
facet-extraction-foundation
Jun 9, 2026
Merged

feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom
facet-extraction-foundation

Conversation

@KrisBraun

@KrisBraunKrisBraun commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Summary

Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.

What's here

  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).

Design notes

  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.

Test Plan

  • @plotday/email-classifier: 17 unit tests
  • gmail connector: 23 tests (incl. 3 new facet tests)
  • slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes

🤖 Generated with Claude Code

KrisBraunand others added 11 commits June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun merged commit 4fde471 into mainJun 9, 2026
1 check passed
@KrisBraun
KrisBraun deleted the facet-extraction-foundation branch June 9, 2026 02:11
@github-actionsgithub-actionsBot mentioned this pull request Jun 9, 2026
Merged
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185
Merged
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Jun 9, 2026
Merged
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Conversation
@KrisBraun
@KrisBraunKrisBraun
commented
Jun 9, 2026

Copy link


Copy Markdown

Contributor
Summary
Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.
What's here
  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).
Design notes
  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.
Test Plan
  • @plotday/email-classifier: 17 unit tests
  •  gmail connector: 23 tests (incl. 3 new facet tests)
  •  slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes
🤖 Generated with Claude Code
KrisBraunand others
added 11 commits
June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun
merged commit 4fde471
into
mainJun 9, 2026

1 check passed

@KrisBraun
KrisBraun
deleted the

facet-extraction-foundation

branch
June 9, 2026 02:11
@github-actionsgithub-actionsBot
mentioned this pull request
Jun 9, 2026
 Merged

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185
Merged
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Jun 9, 2026
Merged
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Conversation
@KrisBraun
@KrisBraunKrisBraun
commented
Jun 9, 2026

Copy link


Copy Markdown

Contributor
Summary
Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.
What's here
  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).
Design notes
  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.
Test Plan
  • @plotday/email-classifier: 17 unit tests
  •  gmail connector: 23 tests (incl. 3 new facet tests)
  •  slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes
🤖 Generated with Claude Code
KrisBraunand others
added 11 commits
June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun
merged commit 4fde471
into
mainJun 9, 2026

1 check passed

@KrisBraun
KrisBraun
deleted the

facet-extraction-foundation

branch
June 9, 2026 02:11
@github-actionsgithub-actionsBot
mentioned this pull request
Jun 9, 2026
 Merged

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185
Merged
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Jun 9, 2026
Merged
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Conversation
@KrisBraun
@KrisBraunKrisBraun
commented
Jun 9, 2026

Copy link


Copy Markdown

Contributor
Summary
Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.
What's here
  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).
Design notes
  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.
Test Plan
  • @plotday/email-classifier: 17 unit tests
  •  gmail connector: 23 tests (incl. 3 new facet tests)
  •  slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes
🤖 Generated with Claude Code
KrisBraunand others
added 11 commits
June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun
merged commit 4fde471
into
mainJun 9, 2026

1 check passed

@KrisBraun
KrisBraun
deleted the

facet-extraction-foundation

branch
June 9, 2026 02:11
@github-actionsgithub-actionsBot
mentioned this pull request
Jun 9, 2026
 Merged

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185
Merged
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Jun 9, 2026
Merged
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Conversation
@KrisBraun
@KrisBraunKrisBraun
commented
Jun 9, 2026

Copy link


Copy Markdown

Contributor
Summary
Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.
What's here
  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).
Design notes
  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.
Test Plan
  • @plotday/email-classifier: 17 unit tests
  •  gmail connector: 23 tests (incl. 3 new facet tests)
  •  slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes
🤖 Generated with Claude Code
KrisBraunand others
added 11 commits
June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun
merged commit 4fde471
into
mainJun 9, 2026

1 check passed

@KrisBraun
KrisBraun
deleted the

facet-extraction-foundation

branch
June 9, 2026 02:11
@github-actionsgithub-actionsBot
mentioned this pull request
Jun 9, 2026
 Merged

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185
Merged
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Jun 9, 2026
Merged
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Conversation
@KrisBraun
@KrisBraunKrisBraun
commented
Jun 9, 2026

Copy link


Copy Markdown

Contributor
Summary
Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.
What's here
  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).
Design notes
  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.
Test Plan
  • @plotday/email-classifier: 17 unit tests
  •  gmail connector: 23 tests (incl. 3 new facet tests)
  •  slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes
🤖 Generated with Claude Code
KrisBraunand others
added 11 commits
June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun
merged commit 4fde471
into
mainJun 9, 2026

1 check passed

@KrisBraun
KrisBraun
deleted the

facet-extraction-foundation

branch
June 9, 2026 02:11
@github-actionsgithub-actionsBot
mentioned this pull request
Jun 9, 2026
 Merged

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185
Merged
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Jun 9, 2026
Merged
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Conversation
@KrisBraun
@KrisBraunKrisBraun
commented
Jun 9, 2026

Copy link


Copy Markdown

Contributor
Summary
Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.
What's here
  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).
Design notes
  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.
Test Plan
  • @plotday/email-classifier: 17 unit tests
  •  gmail connector: 23 tests (incl. 3 new facet tests)
  •  slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes
🤖 Generated with Claude Code
KrisBraunand others
added 11 commits
June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun
merged commit 4fde471
into
mainJun 9, 2026

1 check passed

@KrisBraun
KrisBraun
deleted the

facet-extraction-foundation

branch
June 9, 2026 02:11
@github-actionsgithub-actionsBot
mentioned this pull request
Jun 9, 2026
 Merged

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission - #185
Merged
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Jun 9, 2026
Merged
feat: thread facets — SDK vocabulary + @plotday/email-classifier + gmail/slack emission#185
KrisBraun merged 11 commits into
mainfrom 
facet-extraction-foundation
Conversation
@KrisBraun
@KrisBraunKrisBraun
commented
Jun 9, 2026

Copy link


Copy Markdown

Contributor
Summary
Part 1 (the public-submodule half) of facet-based thread classification — distilling each thread into lightweight, queryable facets so focuses can sort by the kind of message and who it's from, not just the topic. This PR adds the producing side; it ships with zero runtime behavior change (facets just start populating — nothing consumes them yet). The consuming side (the classifier gate, LLM filter derivation) lives in the core repo and lands separately, with the submodule pointer bumped after this merges.
What's here
  • @plotday/twister/facets (new export): Format (chat|message|reading|notification|receipt|invoice|promotion), Automation (human|automated), Reach (direct|list), and ThreadFacets. NewLink gains an optional facets field so connectors can emit them. (Changeset included — minor.)
  • @plotday/email-classifier (new shared package under libs/): a pure, unit-tested classifyEmail(signals) → ThreadFacets mapping normalized email signals (List-Id/List-Unsubscribe, Precedence, Auto-Submitted, Return-Path, sender, recipient count, subject, body length, Gmail category labels) to facets. Reusable by gmail/outlook/apple-mail.
  • Gmail assembles EmailSignals from message headers/labels/body and emits link.facets.
  • Slack emits facets via a small source-specific helper (bot/subtype → automation; channel-id prefix → reach; text length → chat/message).
Design notes
  • Best-effort / fail-open: a connector sets a facet only when a heuristic is confident, else leaves it null; the consumer never gates on a null facet.
  • Mailing-list mail is treated as automated in the shared classifier (so all email connectors inherit it); the connector adapters stay pure signal-mappers.
Test Plan
  • @plotday/email-classifier: 17 unit tests
  •  gmail connector: 23 tests (incl. 3 new facet tests)
  •  slack connector: 18 tests (incl. 6 new facet tests)
  • twister typechecks; validate-changesets passes
🤖 Generated with Claude Code
KrisBraunand others
added 11 commits
June 8, 2026 16:04
@KrisBraun
feat(twister): add ThreadFacets facet vocabulary export
012df5b
@KrisBraun
feat(twister): add NewLink.facets
5a8bab6
@KrisBraun
chore(email-classifier): scaffold shared package
29f4484
@KrisBraun
feat(email-classifier): classifyEmail heuristics
f12bab1
@KrisBraun
refactor(email-classifier): tighten promo regex, add null-format test
2d1f1a9
@KrisBraun@claude
feat(gmail): emit thread facets from email signals
01046d8
Adds gmailFacets() signal extractor + classifyEmail integration, and sets
plotThread.facets at the saveLink site from the thread's first non-draft message.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@KrisBraun
refactor(email-classifier): mailing-list mail is automated in shared …
5f03e87
…classifier; gmail-facets pure mapper
@KrisBraun
fix(gmail): use full body length + quote-aware recipient parsing for …
e454f93
…facets
@KrisBraun@claude
feat(slack): emit thread facets per message/channel
d2b8133
Adds slackFacets() helper that classifies format (chat vs message by length),
automation (human vs bot via bot_id/subtype/missing user), and reach (direct vs
list via channelId C-prefix heuristic). Wired at all three saveLink sites in
processMessageThreads, refreshSlackThread, and saveStarredThread.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@KrisBraun
docs(slack): clarify channel-prefix reach inference; add facet edge-c…
bff775e
…ase tests
@KrisBraun
chore: update pnpm-lock for @plotday/email-classifier
ab099b3
@KrisBraun
KrisBraun
merged commit 4fde471
into
mainJun 9, 2026

1 check passed

@KrisBraun
KrisBraun
deleted the

facet-extraction-foundation

branch
June 9, 2026 02:11
@github-actionsgithub-actionsBot
mentioned this pull request
Jun 9, 2026
 Merged

Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment

Reviewers


No reviews


Assignees


No one assigned


Labels


None yet


Projects


None yet


Milestone


No milestone


Development

Successfully merging this pull request may close these issues.

1 participant

@KrisBraun