@method-ai-hq/sdk 0.0.0-stage → 0.14.2

package/dist/packages/sdk/examples/daily-briefing/briefing_website.py

@@ -0,0 +1,215 @@
+#!/usr/bin/env python3
+"""Build the complete website from the writer's selected content.
+
+Reads accepted prepared data and an Markdown briefing. Never rewrites either.
+"""
+import argparse
+import datetime as dt
+import html
+import json
+import re
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+from urllib.parse import urlsplit
+from briefing_markdown import parse
+from briefing_sessions import social_sessions
+from briefing_progress import progress
+
+TEMPLATES=Path(__file__).resolve().parent/'reader'
+
+
+def load(path):return json.loads(path.read_text())
+def optional(path):return load(path) if path.exists() else []
+def h(value):return html.escape(str(value),quote=True)
+def put(path,text):
+    path.parent.mkdir(parents=True,exist_ok=True);path.write_text(text);path.chmod(0o600)
+def stamp(value):return dt.datetime.fromisoformat(value)
+def clock(value):return stamp(value).strftime('%I:%M %p').lstrip('0')
+def quotes(text):
+    result=[];depth=0;start=0
+    for i,char in enumerate(text):
+        if char=='“':
+            if depth==0:start=i+1
+            depth+=1
+        elif char=='”' and depth:
+            depth-=1
+            if depth==0:result.append(text[start:i])
+    return result
+
+def readable_time(e):
+    time=e['time']
+    return stamp(time['local']).strftime('%b %d · %I:%M %p').replace(' 0',' ') if time['local'] else time['day']
+def host(url):return (urlsplit(url or '').hostname or '').removeprefix('www.').removeprefix('mobile.')
+def safe_url(url):return url if urlsplit(url or '').scheme in ['http','https'] else ''
+
+def render_markdown(texts,marked,source_urls=None):
+    # Original HTML is shown as source text. Links open HTTP(S), anchors, or local website pages.
+    code="""import {marked} from MARKED;
+const escape=s=>s.replaceAll('&','&amp;').replaceAll('<','&lt;').replaceAll('>','&gt;').replaceAll('"','&quot;');
+marked.use({renderer:{html(token){return escape(token.text)},link(token){let label=this.parser.parseInline(token.tokens);let href=token.href;if(href.startsWith('source:')){const ids=href.slice(7).split(',');return ids.map((id,i)=>{if(!Object.hasOwn(sources,id))throw Error('Unknown source record: '+id);return '<a target="_blank" rel="noopener noreferrer" href="'+escape(sources[id])+'">'+(i===0?label:'['+(i+1)+']')+'</a>'}).join(' ')}return /^(https?:|#|[a-zA-Z0-9_-]+[.]html(?:#|$))/.test(href)?'<a target="_blank" rel="noopener noreferrer" href="'+escape(href)+'">'+label+'</a>':label},image(token){return escape(token.text||'Image referenced in saved text')}}});
+let chunks=[];for await(const c of process.stdin)chunks.push(c);const {texts:inputs,sources}=JSON.parse(Buffer.concat(chunks).toString());
+process.stdout.write(JSON.stringify(Object.fromEntries(Object.entries(inputs).map(([key,value])=>[key,marked.parse(value)]))));
+""".replace('MARKED',json.dumps(marked.resolve().as_uri()))
+    return json.loads(subprocess.run(['node','--input-type=module','-e',code],input=json.dumps({'texts':texts,'sources':source_urls or {}}),text=True,capture_output=True,check=True).stdout)
+
+
+def convert_photo(original,target):
+    from PIL import Image, ImageOps
+    from pillow_heif import register_heif_opener
+    register_heif_opener()
+    with Image.open(original) as source:
+        preview=ImageOps.exif_transpose(source)
+        preview.thumbnail((1600,1600))
+        if preview.mode in ('RGBA','LA') or 'transparency' in preview.info:
+            rgba=preview.convert('RGBA');background=Image.new('RGB',rgba.size,'white');background.paste(rgba,mask=rgba.getchannel('A'));preview=background
+        preview.convert('RGB').save(target,format='JPEG',quality=85)
+
+
+def build(prepared,briefing_file,out,marked,day=None,proposal=None):
+    proposal=proposal or parse(briefing_file.read_text(),day,marked)
+    dest=out
+    dest.mkdir(parents=True,exist_ok=True)
+    for name in ['reader.css','reader.js']:shutil.copyfile(TEMPLATES/name,dest/name)
+    raw={f.stem:load(f) for f in (prepared/'records').glob('*.json')}
+    records={cid:data['prepared'] for cid,data in raw.items()}
+    entries={r['entry_id']:r for name in ['timeline.jsonl','untimed.jsonl'] for r in map(json.loads,(prepared/name).read_text().splitlines())}
+    day=proposal['day']
+    title=proposal['title']
+    day_label=dt.date.fromisoformat(day).strftime('%b %d, %Y').replace(' 0',' ').upper()
+    source_ids={cid:r['source_record_ids'] for r in entries.values() for cid in r['source_record_ids']}
+    documents=load(prepared/'metadata/documents.json')
+    doc_by_record={cid:d for d in documents for cid in d['record_ids']}
+    source_ranges=proposal.get('source_ranges',{})
+    texts={cid:e['text'] for cid,e in records.items()}
+    for supplement in proposal.get('supplements',[]):texts[supplement['id']]=supplement['text']
+    for cid,ranges in source_ranges.items():
+        for name,(first,last) in ranges.items():texts[cid+':'+name]='\n'.join(texts[cid].splitlines()[first-1:last])
+    contexts=optional(prepared/'context.json')
+    for c in contexts:
+        data=load(prepared/c['source_json'])
+        for r in data['records']:texts['context-'+(r.get('message_id') or r['id'])]=r['text']
+    def document_page(doc):
+        return 'source-'+Path(doc['path']).stem+'.html'
+    source_urls={cid:document_page(doc)+'#'+cid for cid,doc in doc_by_record.items()}
+    source_urls.update({s['id']:s['id']+'.html' for s in proposal.get('supplements',[])})
+    rendered=render_markdown(texts,marked,source_urls)
+    media={}
+    for asset in optional(prepared/'media.json'):
+        original=prepared/asset['path'];name=Path(asset['path']).stem+'.jpg';target=dest/'media'/name;target.parent.mkdir(exist_ok=True)
+        if not target.exists():
+            convert_photo(original,target)
+        original_target=dest/asset['path'];original_target.parent.mkdir(parents=True,exist_ok=True);shutil.copyfile(original,original_target)
+        for cid in asset['records']:media[cid]={'png':'media/'+name,'original':asset['path']}
+    def photo(cid,caption):
+        asset=media[cid]
+        return f'<figure class="photo"><button data-photo="{h(asset["png"])}" aria-label="Enlarge photo"><img src="{h(asset["png"])}" alt="{h(caption)}" loading="lazy"></button><figcaption>{h(caption)} · <a href="{h(asset["original"])}">Original</a></figcaption></figure>'
+    groups=social_sessions(prepared)
+    browser_rows=[r for r in entries.values() if records[r['source_record_ids'][0]]['source'] in ['browser','google_takeout']]
+    navigation=' · '.join((['<a href="sessions.html">X and Instagram sessions</a>'] if groups else [])+(['<a href="browser.html">All browser visits</a>'] if browser_rows else []))
+    def page(title,body):
+        return f'<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>{h(title)}</title><link rel="stylesheet" href="reader.css"></head><body><nav><a href="index.html">{h(day_label)}</a><span>{navigation}</span></nav><main>{body}</main><dialog><button data-close-photo>Close</button><img alt=""></dialog><script src="reader.js"></script></body></html>'
+    for supplement in proposal.get('supplements',[]):
+        sid=supplement['id'];filename=sid+'.html'
+        put(dest/filename,page(supplement['title'],'<h1>'+h(supplement['title'])+'</h1><div class="source-text">'+rendered[sid]+'</div>'))
+        put(dest/'data'/f'{sid}.json',json.dumps({'id':sid,'html':rendered[sid],'time':'','date':'','speaker':'','basis':'','document':filename,'reading_label':'Full supporting document','ranges':{name:rendered[sid+':'+name] for name in source_ranges.get(sid,{})}},ensure_ascii=False))
+    def speaker(e):
+        role=e['actor_role']
+        if e['source']=='imessage':return 'User' if role=='user_written' else e['attributes'].get('sender') or 'Not supplied'
+        return {'user_written':'User','user':'User','assistant':'Assistant','other_person':'Other person'}.get(role,'')
+    def record_html(cid):
+        e=records[cid];meta=' · '.join(filter(None,[readable_time(e),speaker(e)]))
+        return f'<article class="record" id="{h(cid)}"><div class="record-head">{h(meta)} <a href="records/{h(cid)}.json">Source JSON</a></div><div class="source-text">{rendered[cid]}</div>'+ (photo(cid,'Saved photo') if cid in media else '')+'</article>'
+    for cid,e in records.items():
+        doc=doc_by_record[cid];docname=document_page(doc)
+        basis=('Saved with this activity' if e['text_basis']=='dated_google_activity_title' else 'Browser saved title') if e['source'] in ['browser','google_takeout'] else ''
+        if e.get('post_text_partial'):basis+=' · partial saved title'
+        data={'id':cid,'html':rendered[cid],'time':readable_time(e),'other_sources':[c for c in dict.fromkeys(source_ids.get(cid,[])) if c!=cid],'date':e['time']['day'],'speaker':speaker(e),'basis':basis,'document':docname+'#'+cid,'conversation':doc['kind']=='conversation','reading_label':'Read full conversation' if doc['kind']=='conversation' else 'Read full note' if e['source'] in ['roam','apple_notes'] else 'Read full document','ranges':{name:rendered[cid+':'+name] for name in source_ranges.get(cid,{})}}
+        put(dest/'data'/f'{cid}.json',json.dumps(data,ensure_ascii=False))
+        target=dest/'records'/f'{cid}.json';target.parent.mkdir(exist_ok=True);shutil.copyfile(prepared/'records'/f'{cid}.json',target)
+    for doc in documents:
+        body='<h1>'+h(doc['title'])+'</h1>'
+        body+=''.join(record_html(cid) for cid in doc['record_ids'])
+        put(dest/document_page(doc),page(doc['title'],body))
+    for c in contexts:
+        data=load(prepared/c['source_json']);body='<h1>'+h(c['title'])+'</h1><p class="small">Earlier conversation</p>'
+        for r in data['records']:
+            cid='context-'+(r.get('message_id') or r['id']);body+=f'<article id="{h(cid)}" class="record"><div class="record-head">{h(r.get("occurred_at") or r.get("day") or "Time not supplied")} · {h(r.get("role") or "")}</div><div class="source-text">{rendered[cid]}</div></article>'
+        put(dest/('context-'+c['conversation_id']+'.html'),page(c['title'],body))
+    def cite(ids,key,text='',label=None,range_name=None):
+        return f'<button class="{("source-link" if label else "cite")}" data-ids="{h(json.dumps(ids))}" data-quotes="{h(json.dumps(quotes(text)))}" data-panel="{h(key)}"'+(f' data-range="{h(range_name)}"' if range_name else '')+f' aria-expanded="false" aria-label="{h(label or "Read supporting sources")}">{h(label or ("↗" if key.startswith("event-") else key))}</button>'
+    def selected(row):
+        sources=[(cid,records[cid]) for cid in row['source_record_ids']]
+        dated=[(cid,e) for cid,e in sources if e['text_basis']=='dated_google_activity_title']
+        if dated:
+            titles={re.sub(r'^Visited\s+','',e['text']) for cid,e in dated}
+            if len(titles)>1:return None
+            cid,e=next(((cid,e) for cid,e in dated if not e['text'].startswith('Visited ')),dated[0])
+        else:cid,e=sources[0]
+        url=e['url'] or row.get('url') or ''
+        is_instagram=e['platform']=='Instagram'
+        if e['source']=='browser' and not dated:
+            route=urlsplit(url).path
+            if not re.search(r'/status/\d+|/(?:p|reel)/[^/]+',route):return None
+        text=e.get('post_text') or (e['text'] if is_instagram and not e['text'].startswith('http') else '')
+        text=html.unescape(text)
+        if not text.strip() or text.strip().lower() in ['instagram','instagram photos and videos','home / x','x','twitter']:return None
+        return {'id':row['entry_id'],'cid':cid,'text':text,'author':e.get('post_author') or '','url':url,'partial':e.get('post_text_partial',False),'time':row['time'],'source_ids':row['source_record_ids'],'platform':e['platform']}
+    def post_row(row):
+        sel=selected(row);e=records[row['source_record_ids'][0]];url=(sel or {}).get('url') or row.get('url') or e['url'] or ''
+        ids=row['source_record_ids'];key=row['entry_id']+'-full'
+        title=(sel or {}).get('text') or row.get('url') or row.get('title') or e['event_kind']
+        who=(sel or {}).get('author','');body=h(title)
+        link=safe_url(url)
+        if sel:body='“'+h(title)+'”'
+        if link:body=f'<a class="original" href="{h(link)}" target="_blank" rel="noopener noreferrer">'+body+'</a>'
+        if sel and sel['partial']:body+='<span class="partial" title="The saved post text is incomplete." aria-label="The saved post text is incomplete."> …</span>'
+        if who:body='<strong>'+h(who)+'</strong> '+body
+        time=clock(row['time']) if row['time'] else 'Untimed'
+        return f'<li class="evidence-host" data-entry="{h(row["entry_id"])}"><div class="post"><time datetime="{h(row["time"])}">{h(time)}</time><div class="post-text">'+body+' '+cite(ids,key,'“'+title+'”',label=None)+'</div></div></li>'
+    for g in groups:
+        g['full'].sort(key=lambda r:(stamp(r['time']),records[r['source_record_ids'][0]]['source_order'],r['entry_id']))
+    def session_html(g):
+        label=g['platform']+' '+clock(g['start'])
+        if g['start']!=g['end']:label+='–'+clock(g['end'])
+        label+=f" · {len(g['full'])} records"
+        return f'<section class="session" id="{h(g["id"])}"><h3>{h(label)}</h3><div class="session-preview"><ol class="records">'+''.join(post_row(r) for r in g['social'] if selected(r))+'</ol></div><details class="full-session"><summary>Show all</summary><ol class="records">'+''.join(post_row(r) for r in g['full'])+'</ol></details></section>'
+    put(dest/'sessions.html',page('X and Instagram sessions','<h1>X and Instagram sessions</h1>'+(''.join(session_html(g) for g in groups) or '<p>No saved social sessions for this day.</p>')))
+    if browser_rows: put(dest/'browser.html',page('All browser visits','<h1>All browser visits</h1><ol class="records" style="max-height:none">'+''.join(post_row(r) for r in browser_rows)+'</ol>'))
+    library='<h1>Full documents</h1><ul class="simple-list">'+''.join('<li><a href="'+h(document_page(d))+'">'+h(d['title'])+'</a></li>' for d in documents)+'</ul>'
+    if contexts:library+='<h2>Earlier conversations</h2><ul>'+''.join('<li><a href="context-'+c['conversation_id']+'.html">'+h(c['title'])+'</a></li>' for c in contexts)+'</ul>'
+    put(dest/'documents.html',page('Full documents',library))
+    story=''
+    sessions_by_id={g['id']:g for g in groups}
+    for n,block in enumerate(proposal['blocks'],1):
+        if block.get('session'):
+            session=sessions_by_id.get(block['session'])
+            if session is None:
+                warning='Session link '+block['session']+' was not found. Linking to all saved social sessions.'
+                print(warning,file=sys.stderr)
+                progress(warning)
+                story+='<p>This session link could not be found. <a href="sessions.html">View all saved social sessions</a>.</p>'
+            else:
+                story+=session_html(session)
+            continue
+        body=block['html']
+        if block['type']=='paragraph':body=body.replace('<p>', '<p class="story-p">', 1)
+        for i,citation in enumerate(proposal['citations']):
+            label=citation['label']
+            button=cite(citation['citations'],f'{n}-{i}',text=block['text'],label='Source',range_name=citation.get('source_range'))
+            button=button.replace('>Source</button>', '>'+label+'</button>')
+            body=body.replace(f'<!--briefing-citation-{i}-->',button)
+        for i,asset in enumerate(proposal['photos']):
+            body=body.replace(f'<!--briefing-photo-{i}-->',photo(asset['id'],asset['caption']))
+        story+=f'<div class="evidence-host" id="p{n}">'+body+'</div>'
+    story+='<footer><a href="documents.html">Full documents</a></footer>'
+    put(dest/'index.html',page(title,story))
+    put(dest/'display-groups.json',json.dumps([{'id':g['id'],'parent':g['parent'],'platform':g['platform'],'start':g['start'],'end':g['end'],'full':[r['entry_id'] for r in g['full']]} for g in groups],indent=2))
+    print(json.dumps({'output':str(out),'blocks':len(proposal['blocks']),'display_groups':len(groups),'source_records':len(records)}))
+
+
+if __name__=='__main__':
+    parser=argparse.ArgumentParser(description=__doc__)
+    for name in ['prepared','briefing','out','marked']:parser.add_argument('--'+name,type=Path,required=True)
+    args=parser.parse_args();build(args.prepared,args.briefing,args.out,args.marked)

package/dist/packages/sdk/examples/daily-briefing/checks.json

@@ -0,0 +1,19 @@
+{
+  "sample_output": {
+    "date": "2026-10-09",
+    "input": "sample/ (28 messages, fictional)",
+    "draft": "sample-report.md",
+    "made_by": "Written for this example from the sample records. The example's own scripts then ran on it: calculate_activity_times (briefing_times.py) made the time files, the write_briefing check (briefing_validation.py) passed, and render_and_save (briefing_render.py) built the website in sample-output.zip.",
+    "source_check": {
+      "status": "pass",
+      "reason": "Source links and supporting files are valid.",
+      "evidence": [
+        "29 citations checked.",
+        "2 supporting files checked."
+      ]
+    },
+    "report_sha256": "b37e90f1515c7a052f7b1cdb9188c7f0e070297194f2f1d3b00e37a662fef068",
+    "archive_sha256": "288f4428a1f13ce08a762f5e6e9e52ca50d1e5f528826aa12d9328a74b316d48"
+  },
+  "approved_report_sha256": "588d744b83c0ea53322c8c6d33b1eba50bfdc817b1ae5459118d9d409dce2e3c"
+}

package/dist/packages/sdk/examples/daily-briefing/daily-briefing.method

@@ -0,0 +1,158 @@
+format: method/3.4
+tools:
+  calculate_activity_times:
+    description: Calculate activity times and save time-plan.json and time-estimates.json in this run. Each successful call replaces both files, so supply the complete plan each time. Only the activities in the plan are calculated; choose the records for each. Before you count a message as work, check whether it is an automated prompt. Record in the plan why each record was selected or excluded. Gaps between records and media playback do not show continuous attention. Leave an activity unestimated when the records do not support an estimate.
+    in:
+      day:
+        type: text
+        description: Selected date in YYYY-MM-DD form.
+      timezone:
+        type: text
+        description: Selected named timezone.
+      plan:
+        type: text
+        description: "JSON with activities and not_estimated (short reasons for activities without an estimate). Each activity has id, label, reason, mode, and optional excluded: [{record_ids, reason}]. A field reference is {record_id, field}, where field is a dotted path in the prepared record, such as time.local, time.end, or attributes.msPlayed. Use points with points: [field references], gap_minutes, and optional compare_gaps. This counts first-to-last time in each group; a single point adds zero. Use intervals with intervals: [{start: field reference, end: field reference}]. Record connections between different endpoint records in the activity reason. Intervals are clipped to the day and overlaps count once. Use durations with durations: [field references] and unit: milliseconds, seconds, or minutes. Each selected duration counts once. Supply saved fields, not invented times or calculated totals."
+    out:
+      estimates:
+        type: text
+        description: Calculated durations and the records and assumptions used to calculate them.
+      files:
+        type: list
+        description: Supporting file references to return with the draft.
+        items:
+          type: file
+    run:
+      kind: run
+      runtime: python
+      entrypoint: briefing_times.py
+    effects: []
+name: Write a daily briefing
+goal: Turn one prepared day folder into a complete, cited daily briefing. Follow the approved example for writing and layout, and save the briefing with its website.
+inputs:
+  day:
+    type: text
+    description: Date of the prepared records, in YYYY-MM-DD form.
+  timezone:
+    type: text
+    description: Timezone for those records, such as America/Chicago.
+environment:
+  prepared_day:
+    type: files
+    description: Folder of prepared records for that day. Read-only.
+steps:
+  open_inputs:
+    name: Check the input folders
+    in:
+      day: inputs.day
+      timezone: inputs.timezone
+      prepared_day: environment.prepared_day
+    do:
+      kind: run
+      runtime: python
+      entrypoint: briefing_check_inputs.py
+    out:
+      selected_day:
+        type: record
+        description: Prepared records, date, timezone, and source hash.
+        fields:
+          folder:
+            type: text
+            description: Absolute path to the prepared records.
+          day:
+            type: text
+            description: Selected date in YYYY-MM-DD form.
+          timezone:
+            type: text
+            description: Named timezone used to interpret this day.
+          start:
+            type: text
+            description: README path relative to the prepared folder.
+          source_digest:
+            type: text
+            description: Hash of the prepared files at the start of this run.
+      example:
+        type: record
+        description: The approved example and its complete text.
+        fields:
+          report:
+            type: text
+            description: Complete approved report.
+      session_links:
+        type: text
+        description: Links to saved social sessions for this day. A link on its own line displays that session in the story.
+    purpose: Checks the required record files, date, and timezone. Returns the prepared folder and its source hash, the complete approved report, and saved session links.
+  write_briefing:
+    name: Write the briefing
+    in:
+      selected_day: selected_day
+      example: example
+      session_links: session_links
+    do:
+      kind: agent
+      model: default
+      prompt: |
+        Write the story of {{selected_day.day}} from the records in {{selected_day.folder}}.
+        Follow the complete approved report in example.report for writing and detail.
+        Return Markdown with source links: [label](source:record-id) or [label](source:record-id#L10-L20).
+        Use calculate_activity_times for supported time estimates.
+      tools:
+        - calculate_activity_times
+    out:
+      draft:
+        type: text
+        description: The complete Markdown briefing.
+      supporting_files:
+        type: list
+        items:
+          type: file
+        description: File references returned by the calculator, or an empty list when none were made.
+    check:
+      kind: run
+      runtime: python
+      entrypoint: briefing_validation.py
+    reading:
+      check_name: Check source links
+      check: Checks source IDs, citation line ranges, and supporting file hashes, names, dates, and timezones. Returns pass when those references are valid.
+  render_and_save:
+    name: Render and save the briefing
+    in:
+      selected_day: selected_day
+      draft: draft
+      supporting_files: supporting_files
+    do:
+      kind: run
+      runtime: python
+      entrypoint: briefing_render.py
+    out:
+      saved_briefing:
+        type: file
+        description: Saved briefing receipt with its date, timezone, and file paths.
+      published_website:
+        type: file
+        description: Briefing website with source pages and supporting files.
+        format: method-website
+    purpose: Builds the briefing website and checks its local links and source hash. Saves the website and supporting files under their content hash, reuses an identical saved output, and returns the receipt and website manifest.
+result:
+  briefing: saved_briefing
+  website: published_website
+run_prompt: Run Write a daily briefing for the requested prepared day folder. Read the date and timezone from its records. When finished, open the briefing website and give me the run link.
+files:
+  - briefing_files.py
+  - briefing_times.py
+  - briefing_sessions.py
+  - briefing_check_inputs.py
+  - briefing_artifacts.py
+  - briefing_manifest.py
+  - briefing_progress.py
+  - briefing_validation.py
+  - briefing_render.py
+  - briefing_website.py
+  - briefing_markdown.py
+  - reader/reader.css
+  - reader/reader.js
+  - package.json
+  - package-lock.json
+  - pyproject.toml
+  - uv.lock
+  - vendor/marked.mjs
+  - approved-report.md

package/dist/packages/sdk/examples/daily-briefing/inputs.json

@@ -0,0 +1 @@
+{"day":"2026-05-11","timezone":"America/Chicago"}

package/dist/packages/sdk/examples/daily-briefing/package-lock.json

@@ -0,0 +1,10 @@
+{
+  "name": "method-daily-briefing-example",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "method-daily-briefing-example"
+    }
+  }
+}

package/dist/packages/sdk/examples/daily-briefing/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "method-daily-briefing-example",
+  "private": true
+}

package/dist/packages/sdk/examples/daily-briefing/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+name = "method-daily-briefing"
+version = "1.0.0"
+requires-python = ">=3.11,<3.14"
+dependencies = ["Pillow==12.0.0", "pillow-heif==1.1.1", "tzdata==2025.2"]
+
+[tool.uv]
+package = false

package/dist/packages/sdk/examples/daily-briefing/reader/reader.css

@@ -0,0 +1,35 @@
+:root{--paper:#faf8f3;--ink:#232b28;--muted:#626e66;--accent:#23614b;--line:#d8ded6}*{box-sizing:border-box}body{margin:0;background:var(--paper);color:var(--ink);font:17px/1.7 Georgia,serif}a,button{color:var(--accent)}a{text-underline-offset:3px}button,summary{font:12px/1.5 'Helvetica Neue',sans-serif;cursor:pointer}button{border:0;background:none;padding:0}a:focus-visible,button:focus-visible,summary:focus-visible{outline:2px solid #bd7336;outline-offset:3px}nav{max-width:786px;margin:auto;display:flex;justify-content:space-between;gap:16px;padding:18px 28px;font:12px/1.5 'Helvetica Neue',sans-serif}nav a{text-decoration:none}main{max-width:786px;margin:40px auto;padding:0 28px}.mast{margin-bottom:30px}.eyebrow{text-transform:uppercase;letter-spacing:.13em;font:11px/1.5 'Helvetica Neue',sans-serif;color:var(--accent)}h1{font:normal clamp(38px,6vw,60px)/1.08 Georgia,serif;letter-spacing:-.04em;margin:15px 0 24px}h2{font:normal 27px/1.3 Georgia,serif;margin:40px 0 18px;border-top:1px solid var(--line);padding-top:18px}h3{font:600 13px/1.5 'Helvetica Neue',sans-serif;margin:0 0 7px}.story-p,.tldr{margin:0 0 22px}.tldr{font-size:18px}.cite{font:11px 'Helvetica Neue',sans-serif;vertical-align:super;position:relative;white-space:nowrap;margin-left:3px}.cite::before{content:'';position:absolute;inset:-9px -6px}.passage-button{display:inline-block;margin:0 0 18px}.evidence{font-size:15px;line-height:1.55;margin:4px 0 24px}.evidence[hidden]{display:none}.evidence .close{display:block;margin:0 0 14px}.record{margin:0 0 22px;scroll-margin-top:20px}.record-head{font:12px/1.5 'Helvetica Neue',sans-serif;color:var(--muted);margin-bottom:8px}.record-head a{font-size:11px;margin-left:10px}.source-text p{margin:0 0 12px}.source-text ul,.source-text ol{padding-left:22px}.source-text pre{white-space:pre-wrap;overflow-wrap:anywhere;font:12px/1.5 ui-monospace,monospace}.source-text code{font-size:.85em}.source-text a{overflow-wrap:anywhere}.source-text img{max-width:100%}mark{background:#f0e2ac;color:inherit;padding:0}.session{margin:22px 0 26px;scroll-margin-top:15px}.session h3 span{font-weight:400;color:var(--muted);margin-left:7px}.session-link{text-decoration:none}.post{display:grid;grid-template-columns:68px minmax(0,1fr);gap:10px;margin:0 0 3px;padding:0}.post time{font:11px/1.65 'Helvetica Neue',sans-serif;color:var(--muted);padding-top:2px;font-variant-numeric:tabular-nums}.post .post-text{font:15px/1.45 Georgia,serif;margin:0;overflow-wrap:anywhere}.post strong{font:600 12px/1.45 'Helvetica Neue',sans-serif}.post .cite{vertical-align:baseline}.post details{display:inline}.post summary{display:inline;margin-left:5px}.full-session{margin-top:7px}.full-session>summary{color:var(--accent);width:fit-content}.records{list-style:none;margin:10px 0;padding:0;max-height:65vh;overflow:auto;overscroll-behavior:contain}.records li{padding:0;border:0}.original{color:inherit;text-decoration:none}.original:hover{text-decoration:underline}.navigation-only{font:13px/1.5 'Helvetica Neue',sans-serif;color:var(--muted)}.partial{font:11px/1.5 'Helvetica Neue',sans-serif;color:var(--muted)}.photo{margin:12px 0 25px}.photo button{display:block}.photo img{display:block;width:190px;max-width:100%;height:auto}.photo figcaption{font:11px/1.5 'Helvetica Neue',sans-serif;color:var(--muted);margin-top:6px}dialog{border:0;background:var(--paper);padding:18px;max-width:95vw;max-height:95vh}dialog::backdrop{background:#000a}dialog img{display:block;max-width:86vw;max-height:82vh;width:auto;height:auto}dialog button{margin:0 0 8px}.simple-list{padding:0;list-style:none}.simple-list li{margin:0 0 10px}.small{font:12px/1.5 'Helvetica Neue',sans-serif;color:var(--muted)}footer{margin:40px 0 20px;font:12px/1.5 'Helvetica Neue',sans-serif}code{font-size:.85em}html{scroll-behavior:auto}@media(max-width:600px){main{margin:26px auto;padding:0 18px}nav{padding:15px 18px}.post{grid-template-columns:60px minmax(0,1fr);gap:7px}h1{font-size:42px}}
+
+.track-list{margin-bottom:25px}.track-list>summary{color:var(--accent);width:fit-content}.track-list .simple-list{font-size:15px;line-height:1.5}.track-list .simple-list>li{margin:0 0 3px}
+
+.evidence{margin:0 0 18px;font-size:15px;line-height:1.45}
+.evidence-scroll{max-height:65vh;overflow:auto;overscroll-behavior:contain;scrollbar-width:thin}
+.evidence-scroll:focus-visible{outline:2px solid #bd7336;outline-offset:2px}
+.evidence .record{display:grid;grid-template-columns:68px minmax(0,1fr);gap:10px;margin:0 0 9px;scroll-margin:0}
+.evidence .record>time{font:11px/1.65 'Helvetica Neue',sans-serif;color:var(--muted);padding-top:2px}
+.evidence .record.untimed{display:block}
+.evidence .record.untimed>time{display:none}
+.evidence .record-head{display:flex;align-items:baseline;gap:7px;margin:0 0 3px;font:12px/1.45 'Helvetica Neue',sans-serif}
+.evidence .record-head a{margin:0;text-decoration:none}
+.evidence .source-text p{margin:0 0 6px}
+.evidence .source-text ul,.evidence .source-text ol{margin:0 0 6px;padding-left:20px}
+.evidence .source-text h1,.evidence .source-text h2,.evidence .source-text h3{font:bold 15px/1.45 Georgia,serif;letter-spacing:0;margin:8px 0 4px;padding:0;border:0}
+.evidence .source-text pre{margin:5px 0}
+.evidence .source-text>:last-child{margin-bottom:0}
+.evidence-host:has(>.evidence:not([hidden]))>.story-p{margin-bottom:8px}
+.evidence-host:has(>.evidence:not([hidden]))>.passage-button{margin-bottom:5px}
+@media(max-width:600px){.evidence .record{grid-template-columns:60px minmax(0,1fr);gap:7px}}
+
+.evidence .record-head{float:left;margin-right:6px}.evidence .source-text>p:first-child{display:inline}.evidence .record.untimed .record-head{float:none;margin-right:0}
+
+.source-text table{border-collapse:collapse;margin:6px 0 10px;text-align:left}
+.source-text th,.source-text td{padding:0 12px 2px 0;vertical-align:top}
+.source-text th:last-child,.source-text td:last-child{padding-right:0}
+
+.source-link{font:inherit;text-decoration:underline;text-underline-offset:3px;display:inline;margin:0;padding:0}.evidence-host{overflow-wrap:anywhere}.evidence-host>pre{white-space:pre-wrap}.evidence-host>table{display:block;overflow-x:auto;border-collapse:collapse}.evidence-host>table th,.evidence-host>table td{padding:4px 12px;text-align:left}
+
+.session-preview{max-height:15rem;overflow:hidden;mask-image:linear-gradient(#000 75%,transparent)}
+.session-preview .records{max-height:none;overflow:visible;margin-bottom:0}
+.session:has(>.full-session[open])>.session-preview{display:none}
+.evidence-host>table{overflow-wrap:normal;word-break:normal;max-width:100%}
+.evidence-host>table th,.evidence-host>table td{min-width:9rem}

package/dist/packages/sdk/examples/daily-briefing/reader/reader.js

@@ -0,0 +1,42 @@
+const cache=new Map();
+async function record(id){if(!cache.has(id))cache.set(id,fetch(`data/${id}.json`).then(r=>{if(!r.ok)throw Error('Source could not be opened');return r.json()}));return cache.get(id)}
+function highlight(root,quotes){for(const quote of quotes){if(!quote.trim())continue;const walker=document.createTreeWalker(root,NodeFilter.SHOW_TEXT);const nodes=[];let joined='',node;while(node=walker.nextNode()){if(node.parentElement.closest('mark'))continue;nodes.push({node,start:joined.length});joined+=node.textContent}const normalized=[];let text='';for(let i=0;i<joined.length;i++){if(/\s/.test(joined[i])){if(text.endsWith(' '))continue;text+=' '}else{text+=joined[i]}normalized.push(i)}const q=quote.replace(/\s+/g,' ');const at=text.indexOf(q);if(at<0)continue;const start=normalized[at],end=normalized[at+q.length-1]+1;for(const item of nodes.reverse()){let a=Math.max(0,start-item.start),b=Math.min(item.node.length,end-item.start);if(b<=a)continue;const range=document.createRange();range.setStart(item.node,a);range.setEnd(item.node,b);const mark=document.createElement('mark');range.surroundContents(mark)}}}
+function sourceElement(data,range){
+  const article=document.createElement('article');article.className='record';article.id=data.id;
+  const writing=/^(roam|apple_notes)-/.test(data.id);
+  const time=document.createElement('time');time.textContent=(data.time||'').split(' · ').at(-1);
+  if(!/AM|PM/.test(time.textContent))time.textContent='';
+  if(!time.textContent)article.classList.add('untimed');
+  const body=document.createElement('div');body.className='record-body';
+  const head=document.createElement('div');head.className='record-head';
+  if(!writing&&data.speaker){const speaker=document.createElement('strong');speaker.textContent=data.speaker==='User'?'You':data.speaker==='Assistant'?(data.id.startsWith('codex-')?'Codex':'ChatGPT'):data.speaker;head.append(speaker)}
+  const link=document.createElement('a');link.href=data.document;link.target='_blank';link.rel='noopener';link.textContent=writing?'Full note ↗':'↗';link.title=[data.reading_label,data.basis].filter(Boolean).join(' · ');link.setAttribute('aria-label',data.reading_label);head.append(link);
+  const text=document.createElement('div');text.className='source-text';text.innerHTML=range?data.ranges[range]:data.html;
+  body.append(head,text);article.append(time,body);return article;
+}
+async function openEvidence(button){
+  const host=button.closest('.evidence-host');let panel=host.querySelector(':scope > .evidence');
+  if(!panel){panel=document.createElement('div');panel.className='evidence';host.append(panel)}
+  const isOpen=!panel.hidden&&panel.dataset.owner===button.dataset.panel;
+  host.querySelectorAll('[data-ids]').forEach(b=>{b.setAttribute('aria-expanded','false');if(b.dataset.readLabel)b.textContent=b.dataset.readLabel});
+  panel.dataset.owner=button.dataset.panel;button.setAttribute('aria-expanded',String(!isOpen));
+  if(isOpen){panel.hidden=true;return}
+  panel.hidden=false;const request=Symbol();panel.request=request;panel.replaceChildren();
+  const scroll=document.createElement('div');scroll.className='evidence-scroll';scroll.tabIndex=0;scroll.setAttribute('role','region');scroll.setAttribute('aria-label','Saved sources');
+  panel.append(scroll);
+  try{
+    const ids=JSON.parse(button.dataset.ids),quotes=JSON.parse(button.dataset.quotes||'[]');
+    for(const id of ids){
+      const data=await record(id);if(panel.request!==request||panel.hidden)return;
+      const el=sourceElement(data,button.dataset.range);scroll.append(el);highlight(el.querySelector('.source-text'),quotes);
+      const mark=el.querySelector('mark');
+      if(mark){const a=el.querySelector('.record-head a'),url=new URL(a.href);url.searchParams.set('quote',quotes.find(q=>el.querySelector('.source-text').textContent.includes(q))||mark.textContent);a.href=url}
+    }
+    const first=scroll.querySelector('mark');
+    if(first)scroll.scrollTop=Math.max(0,first.getBoundingClientRect().top-scroll.getBoundingClientRect().top-30);
+  }catch(error){if(panel.request===request&&!panel.hidden)scroll.append(document.createTextNode(error.message))}
+}
+
+document.addEventListener('click',e=>{const button=e.target.closest('[data-ids]');if(button)openEvidence(button);const photo=e.target.closest('[data-photo]');if(photo){const dlg=document.querySelector('dialog');dlg.querySelector('img').src=photo.dataset.photo;dlg.querySelector('img').alt=photo.querySelector('img').alt;dlg.showModal()}});
+document.querySelector('dialog')?.addEventListener('click',e=>{if(e.target.tagName==='DIALOG'||e.target.closest('[data-close-photo]'))e.currentTarget.close()});
+function revealHash(){const id=decodeURIComponent(location.hash.slice(1));if(!id)return;const el=document.getElementById(id);if(el){if(el.classList.contains('session')){const details=el.querySelector('.full-session');if(details)details.open=true}const q=new URLSearchParams(location.search).get('quote');if(q)highlight(el,[q]);(el.querySelector('mark')||el).scrollIntoView({block:'start'})}}window.addEventListener('hashchange',revealHash);revealHash();

package/dist/packages/sdk/examples/daily-briefing/sample/context.json

@@ -0,0 +1 @@
+[]