feat: import private calendar capacity for Week Ahead (Closes #1206)

frontend/dashboard.css

@@ -337,6 +337,20 @@ textarea { resize: vertical; min-height: 120px; }
 .week-review-duplicates { margin:12px 0; padding:12px; border:1px solid #f59e0b; border-radius:10px; background:#2a1c12; }
 .week-review-status { min-height:1.4em; margin:10px 0; }
 #confirm-week-plan { width:100%; min-height:48px; position:sticky; bottom:0; }
+#open-week-capacity-import { width:100%; min-height:44px; margin:8px 0 12px; }
+.week-capacity-import { position:fixed; z-index:121; inset:0; box-sizing:border-box; width:100%; max-width:560px; margin-inline:auto; padding:18px; padding-bottom:calc(18px + env(safe-area-inset-bottom)); background:#0b1526; overflow:auto; overflow-x:hidden; }
+.week-capacity-import[hidden] { display:none; }
+.week-capacity-import > header { display:flex; align-items:flex-start; justify-content:space-between; gap:12px; }
+.week-capacity-import h2 { margin:.2rem 0; }
+.week-capacity-import > label, .week-capacity-hours label { display:grid; min-width:0; gap:6px; margin:12px 0; }
+.week-capacity-import input, .week-capacity-import button { box-sizing:border-box; min-width:0; min-height:44px; max-width:100%; }
+.week-capacity-hours { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); gap:10px; }
+.week-capacity-days { display:grid; gap:8px; margin:10px 0 14px; }
+.week-capacity-day { display:grid; min-width:0; gap:3px; padding:10px; border:1px solid #31577f; border-radius:10px; background:#10233a; overflow-wrap:anywhere; }
+.week-capacity-day span { color:#bfdbfe; font-weight:700; }
+.week-capacity-day small { color:#a9bdd3; }
+#apply-week-capacities { width:100%; min-height:48px; position:sticky; bottom:0; }
+@media (max-width:359px) { .week-capacity-hours { grid-template-columns:1fr; } }
 .week-calendar-handoff h2 { margin-bottom:6px; }
 .week-calendar-days { display:grid; gap:12px; margin:14px 0; }
 .week-calendar-day { min-width:0; padding:12px; border:1px solid #31577f; border-radius:12px; background:#10233a; }

frontend/index.html

@@ -509,11 +509,30 @@
       <div class="small">Final planning step</div>
       <h2 id="week-review-title">Review &amp; rebalance Week Ahead</h2>
       <p class="small muted">Check each day’s load. Move work instead of copying it, then confirm one executable week.</p>
+      <button id="open-week-capacity-import" type="button">Set capacity from calendar</button>
       <div class="week-review-duplicates" id="week-review-duplicates" role="alert" hidden></div>
       <div class="week-review-days" id="week-review-days"></div>
       <div class="small week-review-status" id="week-review-status" role="status" aria-live="polite"></div>
       <button id="confirm-week-plan" type="button">Confirm Week Ahead</button>
     </section>
+    <section class="week-capacity-import" id="week-capacity-import" aria-labelledby="week-capacity-title" hidden>
+      <header><div><div class="small">Private calendar import</div><h2 id="week-capacity-title">Set Week Ahead capacity</h2></div>
+        <button id="cancel-week-capacity-import" type="button">Cancel</button></header>
+      <p class="small muted">Your calendar is read only on this device. Event titles, people, locations, and the file are never saved or uploaded.</p>
+      <label>Calendar file
+        <input id="week-capacity-file" type="file" accept=".ics,text/calendar" />
+      </label>
+      <div class="week-capacity-hours">
+        <label>Workday starts <input id="week-capacity-start" type="time" value="09:00" required /></label>
+        <label>Workday ends <input id="week-capacity-end" type="time" value="17:00" required /></label>
+      </div>
+      <div id="week-capacity-status" class="small" role="status" aria-live="assertive"></div>
+      <section id="week-capacity-review" aria-labelledby="week-capacity-review-title" hidden>
+        <h3 id="week-capacity-review-title">Review available time</h3>
+        <div id="week-capacity-days" class="week-capacity-days"></div>
+        <button id="apply-week-capacities" type="button">Apply seven capacities</button>
+      </section>
+    </section>
     <section class="week-calendar-handoff" id="week-calendar-handoff" aria-labelledby="week-calendar-title" hidden>
       <div class="small">Calendar handoff</div>
       <h2 id="week-calendar-title">Add Week Ahead to calendar</h2>
@@ -2028,6 +2047,7 @@
 <script src="static/plan-today-preview.js"></script>
 <script src="static/tomorrow-plan.js"></script>
 <script src="static/week-calendar.js"></script>
+<script src="static/week-calendar-import.js"></script>
 <script src="static/week-plan.js"></script>
 <script src="static/search-week-plan.js"></script>
 <script src="static/today-sync.js"></script>

frontend/service-worker.js

@@ -125,6 +125,7 @@ const SHELL = [
   BASE + 'static/plan-today-preview.js',
   BASE + 'static/tomorrow-plan.js',
   BASE + 'static/week-calendar.js',
+  BASE + 'static/week-calendar-import.js',
   BASE + 'static/week-plan.js',
   BASE + 'static/search-week-plan.js',
   BASE + 'static/today-sync.js',

frontend/week-calendar-import.js

@@ -0,0 +1,111 @@
+function createWeekCalendarImport() {
+  const maxBytes=1024*1024;
+  function clock(value) {
+    const match=/^(\d{2}):(\d{2})$/.exec(String(value||''));
+    if(!match)return null;
+    const minutes=Number(match[1])*60+Number(match[2]);
+    return Number(match[1])<24&&Number(match[2])<60?minutes:null;
+  }
+  function instant(value) {
+    const match=/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})(Z?)$/.exec(value||'');
+    if(!match)return null;
+    const parts=match.slice(1,7).map(Number);
+    const milliseconds=match[7]?Date.UTC(parts[0],parts[1]-1,parts[2],parts[3],parts[4],parts[5]):
+      new Date(parts[0],parts[1]-1,parts[2],parts[3],parts[4],parts[5]).getTime();
+    return Number.isFinite(milliseconds)?milliseconds:null;
+  }
+  function events(source) {
+    if(typeof source!=='string'||!source.includes('BEGIN:VCALENDAR'))throw new Error('Choose a valid .ics calendar file.');
+    if(new TextEncoder().encode(source).length>maxBytes)throw new Error('Calendar files must be 1 MB or smaller.');
+    const lines=source.replace(/\r\n[ \t]/g,'').split(/\r?\n/);
+    const result=[];let current=null;
+    lines.forEach(line=>{
+      if(line==='BEGIN:VEVENT'){current={};return;}
+      if(line==='END:VEVENT'){
+        if(current?.start!=null&&current?.end>current.start)result.push(current);
+        current=null;return;
+      }
+      if(!current)return;
+      const separator=line.indexOf(':');if(separator<0)return;
+      const name=line.slice(0,separator).split(';')[0],value=line.slice(separator+1);
+      if(name==='DTSTART')current.start=instant(value);
+      if(name==='DTEND')current.end=instant(value);
+    });
+    return result;
+  }
+  function dayBoundary(date,minutes) {
+    const [year,month,day]=date.split('-').map(Number);
+    return new Date(year,month-1,day,Math.floor(minutes/60),minutes%60).getTime();
+  }
+  function review(source,{dates,workdayStart='09:00',workdayEnd='17:00'}={}) {
+    if(!Array.isArray(dates)||dates.length!==7)throw new Error('Week Ahead must contain seven dates.');
+    const startMinute=clock(workdayStart),endMinute=clock(workdayEnd);
+    if(startMinute==null||endMinute==null||endMinute<=startMinute)throw new Error('Working hours must end after they start.');
+    const calendarEvents=events(source);
+    return dates.map(plan_date=>{
+      const start=dayBoundary(plan_date,startMinute),end=dayBoundary(plan_date,endMinute);
+      const ranges=calendarEvents.map(event=>[Math.max(start,event.start),Math.min(end,event.end)])
+        .filter(range=>range[1]>range[0]).sort((left,right)=>left[0]-right[0]);
+      const merged=[];
+      ranges.forEach(range=>{
+        const previous=merged[merged.length-1];
+        if(previous&&range[0]<=previous[1])previous[1]=Math.max(previous[1],range[1]);
+        else merged.push([...range]);
+      });
+      const busy_minutes=Math.round(merged.reduce((total,range)=>total+range[1]-range[0],0)/60000);
+      return {plan_date,busy_minutes,capacity_minutes:endMinute-startMinute-busy_minutes};
+    });
+  }
+  function createWorkflow({controller,qs,onApplied=()=>{}}={}) {
+    let reviewed=null;
+    const root=()=>qs('#week-capacity-import');
+    function clear() {
+      reviewed=null;
+      qs('#week-capacity-file').value='';
+      qs('#week-capacity-review').hidden=true;
+      qs('#week-capacity-days').innerHTML='';
+    }
+    function open() {
+      clear();root().hidden=false;qs('#week-capacity-status').textContent='';
+      qs('#week-capacity-file').focus?.();return true;
+    }
+    function cancel() {clear();root().hidden=true;return true;}
+    function reviewSource(source) {
+      const display=controller.dates();
+      reviewed=review(source,{dates:display.map(item=>item.date),workdayStart:qs('#week-capacity-start').value,
+        workdayEnd:qs('#week-capacity-end').value});
+      qs('#week-capacity-days').innerHTML=reviewed.map((day,index)=>'<article class="week-capacity-day"><strong>'+
+        display[index].label+'</strong><span>'+day.capacity_minutes+' min available</span><small>'+day.busy_minutes+
+        ' min busy during working hours</small></article>').join('');
+      qs('#week-capacity-review').hidden=false;
+      qs('#week-capacity-status').textContent='Review seven capacity totals. Calendar details stay on this device.';
+      return reviewed.map(day=>({...day}));
+    }
+    async function apply() {
+      if(!reviewed||!controller.stageCapacities(reviewed))return false;
+      qs('#apply-week-capacities').disabled=true;
+      try {await controller.flush();cancel();onApplied();return true;}
+      finally {qs('#apply-week-capacities').disabled=false;}
+    }
+    qs('#week-capacity-file')?.addEventListener('change',async event=>{
+      const file=event.currentTarget.files?.[0];if(!file)return;
+      try {
+        if(file.size>maxBytes)throw new Error('Calendar files must be 1 MB or smaller.');
+        reviewSource(await file.text());
+      } catch(error) {clear();qs('#week-capacity-status').textContent=error.message||'Calendar could not be read.';}
+    });
+    qs('#cancel-week-capacity-import')?.addEventListener('click',cancel);
+    qs('#apply-week-capacities')?.addEventListener('click',()=>apply().catch(error=>{
+      qs('#week-capacity-status').textContent=(error.message||'Week Ahead sync is unavailable.')+' Capacities remain saved on this phone.';
+    }));
+    return {open,cancel,review:reviewSource,apply,state:()=>reviewed?reviewed.map(day=>({...day})):null};
+  }
+  function mount(controller,weekWorkflow,qs) {
+    const workflow=createWorkflow({controller,qs,onApplied:weekWorkflow.renderReview});
+    qs('#open-week-capacity-import').addEventListener('click',workflow.open);
+    return workflow;
+  }
+  return {review,createWorkflow,mount};
+}
+const weekCalendarImport=createWeekCalendarImport();
+if(typeof module!=='undefined'&&module.exports)module.exports=weekCalendarImport;

frontend/week-plan.js

@@ -78,6 +78,17 @@ function createWeekPlan({fetchJson,localDate,timeZone,storage,getLogin}={}) {
       estimates:{...(value.estimates||{})},
     }]));
   }
+  function stageCapacities(values) {
+    const available=dates().map(item=>item.date);
+    if(!Array.isArray(values)||values.length!==available.length)return false;
+    const capacities=new Map(values.map(value=>[value?.plan_date,value?.capacity_minutes]));
+    if(capacities.size!==available.length||available.some(date=>{
+      const value=capacities.get(date);return !Number.isInteger(value)||value<0||value>1440;
+    }))return false;
+    return stageDays(available.map(planDate=>{
+      const value=day(planDate);value.capacity_minutes=capacities.get(planDate);return value;
+    }));
+  }
   function review() {
     const assigned=new Map();
     const days=dates().map(item=>{
@@ -330,7 +341,7 @@ function createWeekPlan({fetchJson,localDate,timeZone,storage,getLogin}={}) {
     const label=planned.length?`${items} item${items===1?'':'s'} across ${planned.length} day${planned.length===1?'':'s'}`:'Nothing planned';
     return label+(pending()?' · sync pending':'');
   }
-  return {adopt,state,dates,day,pass,load,saveDay,stageDay,review,move,placement,place,pending,flush,conflict,chooseDay,saveMerged,
+  return {adopt,state,dates,day,pass,load,saveDay,stageDay,stageCapacities,review,move,placement,place,pending,flush,conflict,chooseDay,saveMerged,
     keepLocal,useRemote,promote,reconcile:reconcilePromotion,summary};
 }
 function createWeekPlanWorkflow({controller,qs,getLogin,getItem=()=>null,openPlanner,setReviewMode=()=>{},escapeHtml,escapeAttribute,
@@ -538,13 +549,15 @@ function createWeekPlanWorkflow({controller,qs,getLogin,getItem=()=>null,openPla
       qs('#my-work-action-status').textContent=(error.message||'Week Ahead needs review before promotion.')+' Open Week Ahead to review.';return false;
     }
   }
-  return {open,save,advance,confirm,finish,promote,renderDates,renderConflict,active:()=>Boolean(selectedDate)||reviewing||Boolean(reconciliation),
+  const workflow={open,save,advance,confirm,finish,promote,renderDates,renderReview,renderConflict,active:()=>Boolean(selectedDate)||reviewing||Boolean(reconciliation),
     reviewing:()=>reviewing,selectedDate:()=>selectedDate,
     day:()=>reconciliationDay()||(selectedDate?controller.day(selectedDate):null),
     copy:()=>reconciliation?{title:"Start today's plan",heading:'Unfinished Today + due Week Ahead',available:'Available today',build:'Build combined Today'}:
       (selectedDate?{title:'Plan Week Ahead',heading:selectedDate+', in order',available:'Available this day',build:'Build this day'}:null),
     clear(){selectedDate=null;reviewing=false;editingFromReview=false;reconciliation=null;setReviewMode(false);qs('#week-review').hidden=true;
       const back=qs('#back-to-week-review');if(back)back.hidden=true;renderDates();}};
+  if(typeof weekCalendarImport!=='undefined')weekCalendarImport.mount(controller,workflow,qs);
+  return workflow;
 }
 if(typeof module!=='undefined'&&module.exports){
   module.exports=createWeekPlan;