create-pmos 0.55.1 → 0.55.3

package/workspace/public/pm/frame-copy.js

@@ -56,6 +56,56 @@ export const COPY = {
     skillsHead: 'Start from a skill',
     noSkills: 'No skills to start from.',
     skillsUnread: 'The skills list did not load.',
+    sideTabs: 'Show the sessions as a list at the side',
+    topTabs: 'Show the sessions as a strip on top',
+    // 0.55.1 — the dock's session list (dock-sessions.js)
+    ds: {
+      notLinked: 'Not linked',
+      scheduled: 'Scheduled',
+      openTabs: 'Open',
+      none: 'No sessions yet. Press Session to start one.',
+      group: 'Show the sessions of',
+      ended: 'ended',
+      open: (n) => 'Open ' + n,
+      more: (n) => 'Name, initiative and type of work of ' + n,
+      end: (n) => 'End ' + n,
+      endFront: 'End the session in front, or close the tab in front',
+      endAsk: (n) => 'End “' + n + '”?',
+      endYes: 'End',
+      cancel: 'Cancel',
+      endFailed: 'The session could not be ended.',
+      endedOne: (n) => 'Ended “' + n + '”.',
+      endedTree: (n, b) => 'Ended “' + n + '”. Its working copy on ' + b + ' is still there.',
+      removeCopy: 'Remove working copy',
+      copyRemoved: (b) => 'Removed the working copy of ' + b + '. The branch is kept.',
+      copyKept: (why) => 'The working copy stays: ' + why,
+      newFor: (t) => 'New session for ' + t,
+      newTitle: 'New session',
+      newSub: 'Name it, pick where it runs, then pick how it starts.',
+      name: 'Name',
+      namePh: 'Empty: named after the skill and initiative',
+      forLabel: 'For',
+      noInitiative: 'No initiative',
+      on: 'On',
+      auto: (where) => 'Automatic: ' + where,
+      mainTree: (b) => 'main tree' + (b ? ' (' + b + ')' : ''),
+      newFolder: (b) => 'new working copy on ' + b,
+      newBranch: 'New branch…',
+      branchName: 'Branch name',
+      needBranch: 'Type a name for the new branch.',
+      startHead: 'Start',
+      blank: 'Blank session',
+      blankMeta: (cli, tier) => (cli === 'claude' ? 'Claude' : 'Shell') + (cli === 'claude' && tier !== 'auto' ? ' · ' + tier : '') + ' · from Settings',
+      skillsLoading: 'Reading the skills…',
+      refused: 'The workspace server refused, without saying why.',
+      metaTitle: 'Session',
+      type: 'Type of work',
+      noType: 'No type',
+      initiative: 'Initiative',
+      save: 'Save',
+      saveFailed: 'Nothing was saved.',
+      types: { research: 'Research', prototype: 'Prototype', prd: 'PRD', build: 'Build', review: 'Review', report: 'Report', general: 'General' },
+    },
   },
   detail: { close: 'Close the detail' },
   phone: {

package/workspace/public/pm/icons.js

@@ -1,6 +1,6 @@
 /* pm/icons.js — the lucide icons the Breakdown uses (D86 point 6).
  *
- * The 29 symbols live in one vendored sprite, /vendor/lucide-sprite.js, generated from lucide-static 1.52.0 (see
+ * The 35 symbols live in one vendored sprite, /vendor/lucide-sprite.js, generated from lucide-static 1.52.0 (see
  * workspace/third-party/README.md). `ensureSprite()` loads it once and puts it in the overlay layer; `icon(name)` returns
  * an <svg> that points at one symbol. Icons are decoration only: every one is aria-hidden, and a control that shows only
  * an icon carries its own aria-label (primitives.js `iconButton` refuses to build one without).

package/workspace/public/pm/panel-tabs.js

@@ -35,7 +35,8 @@ import { mountDoc, disposeDoc, docText } from './tab-doc.js';
 import { mountWeb, promptWeb } from './tab-web.js';
 import { newSessionBlock, openNewSession } from './panel-newsess.js';
 import { boardOf, currentProduct } from './board-read.js';
-import { field, button, toast, ensureComponentsCss } from './primitives.js';
+import { field, button, iconButton, toast, ensureComponentsCss } from './primitives.js';
+import { COPY } from './frame-copy.js';
 import { COPY as PAL } from './palette-copy.js';
 import { askChoice } from './dialogs.js';
 import { icon, ensureSprite } from './icons.js';
@@ -1084,7 +1085,11 @@ function keepSessionsLive(shown) {
 let dockMod = null;
 const inFrame = () => !!(window.pmApp && window.pmApp.frame && window.pmApp.frame.on);
 import('./dock.js').then((m) => { dockMod = m; if (inFrame()) setState({}); }).catch(() => { dockMod = null; });
+/* 0.55.1 — the dock lists SESSIONS grouped by initiative (dock-sessions.js), in the frame and live mode only. */
+let dsMod = null;
+if (!FIXTURE) import('./dock-sessions.js').then((m) => { dsMod = m; if (inFrame()) setState({}); }).catch(() => { dsMod = null; });
 let dockParts = null;
+let dockOrient = null;
 function frameDock() {
   if (!dockMod || !inFrame()) return null;
   const repo = currentProduct();
@@ -1094,17 +1099,28 @@ function frameDock() {
       ws,
       session: dockMod.sessionMenuButton({
         ws,
-        newSession: () => newSession(),
-        withOptions: (d) => { openNewSession(selSlug(), { agent: d.cli }); setState({ newSessTier: d.tier }); },
-        openSkill: (sk) => openTab({ id: 'skill:' + sk.id, kind: 'skill', title: sk.label || sk.skill || sk.id, skillId: sk.id, repo: state.product || null, slug: null, role: 'SKILL' }),
+        open: () => (dsMod ? dsMod.openNewSessionSheet(currentProduct(), { initiative: null }) : newSession()),
       }),
       fold: dockParts ? dockParts.fold : dockMod.foldButton({ fold: () => window.pmApp.frame.foldDock() }),
       focus: dockParts ? dockParts.focus : dockMod.focusButton({ toggle: () => window.pmApp.frame.toggleFocus() }),
     };
   }
-  if (isMobile()) return { session: dockParts.session, fold: null, focus: null };
+  if (isMobile()) return { session: dockParts.session, fold: null, focus: null, orient: null };
   dockMod.paintFocus(dockParts.focus, !!window.pmApp.frame.dockMax);
-  return { session: dockParts.session, fold: dockParts.fold, focus: dockParts.focus };
+  // the tabs-on-top / tabs-at-side switch, icon only in the frame (0.55.1); drawn per paint because its icon follows the mode
+  // one element across paints, so the keyboard focus stays on it; only its icon and name follow the mode
+  const v = !!state.tabsVertical;
+  if (!dockOrient) {
+    dockOrient = iconButton({ icon: 'panel-left', ariaLabel: COPY.dock.sideTabs,
+      onClick: () => setState({ tabsVertical: !state.tabsVertical, dsEnding: null }), attrs: { 'data-tabs': 'orient' } });
+  }
+  const oname = v ? 'panel-top' : 'panel-left';
+  const cur = dockOrient.querySelector('[data-icon]');
+  if (!cur || cur.getAttribute('data-icon') !== oname) dockOrient.replaceChildren(icon(oname));
+  const olabel = v ? COPY.dock.topTabs : COPY.dock.sideTabs;
+  dockOrient.setAttribute('aria-label', olabel);
+  dockOrient.title = olabel;
+  return { session: dockParts.session, fold: dockParts.fold, focus: dockParts.focus, orient: dockOrient };
 }
 
 /**
@@ -1277,6 +1293,8 @@ export function renderTabs(host) {
   const oi = vertical ? 'arrow-left-right' : 'arrow-up-down';
   if (!orientIcon.firstChild || orientIcon.firstChild.getAttribute('data-icon') !== oi) orientIcon.replaceChildren(icon(oi));
   orientBtn.title = vertical ? 'show the tabs as a strip above the panes' : 'show the tabs as a list at the left of the panes';
+  const ds = fr && dsMod ? currentProduct() : null;   // the frame's session list (0.55.1); null = the tab list as before
+  const notListed = (listed) => visTabs.filter((t) => !(t.kind === 'term' && t.sessionId && listed.has(t.sessionId)));
   if (vertical) {
     tabBar.setAttribute('style', CK_VBAR);
     const V_BTN = CK_BTN.replace('margin:0 0 4px', 'margin:0') + ';justify-content:start';
@@ -1314,10 +1332,25 @@ export function renderTabs(host) {
     setChildren(tabBar, [
       ...visTabs.map((t) => tabNode(t, act, splitTab)),
       fr ? fr.session : newSessionBtn,
-      FIXTURE ? null : newWebBtn,
+      FIXTURE || fr ? null : newWebBtn,
       !FIXTURE && state.webNotice ? el('span', { 'data-r5': 'notice', style: 'align-self:center;font-size:11px;color:var(--destructive);padding:0 6px' }, state.webNotice) : null,
-      newSessionOptsBtn,
-      canSplit ? splitBtn : null,
+      fr ? null : newSessionOptsBtn,
+      canSplit && (!fr || state.splitId) ? splitBtn : null,
+    ]);
+  }
+
+  /* 0.55.1 — in the frame the bar lists SESSIONS by initiative (dock-sessions.js); the tabs that are not sessions follow
+   * under "Open". The bar keeps the style the branch above gave it; only its children change. Web, options and split left
+   * the frame's dock (split stays only to undo one already made). */
+  if (ck && ds) {
+    const others = notListed(dsMod.listedSessionIds(ds));
+    setChildren(tabBar, vertical ? [
+      fr.session,
+      ...dsMod.railNodes(ds, others.map((t) => cockpitTabNode(t, act, splitTab, true))),
+      el('div', { 'data-tabs': 'vcontrols', class: 'fr-ds-foot' }, state.splitId ? splitBtn : null, fr.orient, fr.focus, fr.fold),
+    ] : [
+      ...dsMod.stripNodes(ds, others.map((t) => cockpitTabNode(t, act, splitTab))),
+      state.splitId ? splitBtn : null, fr.orient, fr.focus, fr.fold,
     ]);
   }
 
@@ -1325,7 +1358,9 @@ export function renderTabs(host) {
   if (tabBar.scrollTop !== keepY) tabBar.scrollTop = keepY;
   // When the tab in front changes, the bar scrolls just enough to show it, so a tab opened at the far end of a crowded strip or a
   // long list is seen. Only the bar's own offset is moved (not scrollIntoView, which would also scroll the panels around it).
-  if (ck && act && act.id !== lastFrontId) {
+  // …and when the bar itself changed (the session list landed, or the orientation flipped): the tab may be off screen
+  const frontKey = act ? act.id + '|' + (ds ? 'ds' : '') + (vertical ? 'v' : 'h') : null;
+  if (ck && act && frontKey !== lastFrontId) {
     const n = [...tabBar.querySelectorAll('[data-tab]')].find((x) => x.getAttribute('data-tab') === act.id);
     if (n) {
       const b = tabBar.getBoundingClientRect(), r = n.getBoundingClientRect();
@@ -1336,7 +1371,7 @@ export function renderTabs(host) {
       else if (r.right > b.right) tabBar.scrollLeft += r.right - b.right;
     }
   }
-  lastFrontId = act ? act.id : null;
+  lastFrontId = frontKey;
 
   // ── panes ──
   reapClosedPanes();

package/workspace/public/pm/tab-term.js

@@ -241,8 +241,20 @@ export function requestSpawn(opts) {
   return new Promise((resolve) => {
     const req = {
       kind: 'ask', resolve, notice: null, settled: false, timer: null, sent: false,
-      msg: {
+      /* `start: true` (0.55.1, the dock's new-session sheet) sends the one-click `start` message instead: the server's
+       * start policy then picks the tree — the initiative's own branch, made the first time, or the main tree when
+       * there is no initiative — and nothing about branches is decided here. */
+      msg: o.start ? {
+        t: 'start', name: o.name, agent: o.agent || 'shell', ws: o.ws,
+        ...(o.initiative ? { initiative: o.initiative } : {}),
+        profile: o.profile === undefined ? null : o.profile,
+        ...(o.skill ? { skill: o.skill } : {}),
+        ...(o.workType ? { workType: o.workType } : {}),
+        ...(o.tier ? { tier: o.tier } : {}),
+      } : {
         t: 'new',
+        ...(o.skill ? { skill: o.skill } : {}),
+        ...(o.workType ? { workType: o.workType } : {}),
         name: o.name,
         agent: o.agent || 'shell',
         ws: o.ws,

package/workspace/public/pm/today-copy.js

@@ -128,7 +128,11 @@ export const COPY = {
     unreached: 'The workspace did not answer.',
     refused: (why) => `Nothing changed. ${why}`,
     oldServer: 'This workspace server has no day run yet. Only your goals show.',
-    panels: { calendar: 'Calendar', jobs: 'Jobs', goals: 'Goals for today', mentions: 'Mentions since yesterday', detail: 'Detail' },
+    panels: { summary: 'Agent results', calendar: 'Calendar', jobs: 'Jobs', goals: 'Goals for today', mentions: 'Mentions since yesterday', waiting: 'Also waiting for you', detail: 'Detail' },
+    summary: (c) => [c.review ? `${c.review} ${c.review === 1 ? 'draft waits' : 'drafts wait'} for you` : null, c.done ? `${c.done} done` : null,
+      c.working ? `${c.working} working` : null, c.failed ? `${c.failed} failed` : null].filter(Boolean).join(' · ') || 'No agent job yet.',
+    summaryAll: (n) => `All ${n} agent ${n === 1 ? 'job has' : 'jobs have'} a result.`,
+    waitingHint: 'Outcome checks, reports and sessions from your repositories, outside today\'s jobs.',
     now: (at) => `now ${at}`,
     noCalendar: 'No events read for today.',
     noJobs: 'No jobs yet. Press Prepare my day. Each job shows here; select one to see what it needs.',

package/workspace/public/pm/today-day.js

@@ -378,6 +378,38 @@ function jobsPanel(ctx) {
     el('ul', { class: 'td-day__rows' }, ...l.map((j) => jobRow(ctx, j))))));
 }
 
+/* The coordinator's view of the run: what every agent job came back with, in one place. The server runs the jobs as one
+ * session each and keeps their state; this reads that state, so it needs no session of its own. */
+function summaryPanel(ctx) {
+  const { m } = ctx;
+  const ts = m.tasks;
+  if (!ts.length) return null;
+  const c = { review: 0, done: 0, working: 0, failed: 0 };
+  for (const t of ts) {
+    if (t.status === 'review') c.review++;
+    else if (t.status === 'done' || t.status === 'sent') c.done++;
+    else if (t.status === 'failed') c.failed++;
+    else c.working++;
+  }
+  const finished = ts.filter((t) => t.status !== 'waiting' && t.status !== 'working' && t.status !== 'sending');
+  const byTask = new Map(m.jobs.filter((j) => j.task).map((j) => [j.task.id, j]));
+  const rows = finished.map((t) => {
+    const j = byTask.get(t.id);
+    const what = t.status === 'failed' ? t.error : t.sent && t.sent.link ? t.sent.link : t.draft ? t.draft.summary : '';
+    return j ? rowBtn(ctx, 'job', j.id, { lead: '·', title: j.title, meta: what || '', trail: statusPill(j) }) : null;
+  }).filter(Boolean);
+  return panel('summary', null,
+    el('p', { class: 'td-day__note', 'data-day': 'summary' }, c.working ? D.summary(c) : D.summaryAll(ts.length) + ' ' + D.summary(c)),
+    rows.length ? el('ul', { class: 'td-day__rows', 'data-day-list': 'summary' }, ...rows) : null);
+}
+
+/* What waits for the PM outside today's jobs (the Today cards: outcome checks, reports, sessions). Today hands its list
+ * in, so the cards keep their own controls and the open day shows one layout. */
+function waitingPanel(owed) {
+  if (!owed || !owed.list) return null;
+  return panel('waiting', owed.count ? String(owed.count) : null, note(D.waitingHint), owed.list, owed.more || null);
+}
+
 function goalsPanel(ctx) {
   const { m } = ctx;
   return panel('goals', D.goalsCount(m.goals.filter((g) => g.status === 'open').length, m.maxGoals), goalRows(ctx), goalAdd(ctx));
@@ -721,7 +753,7 @@ function fold(open) {
 }
 
 /** The section. `ws` is the repository the day run belongs to; `openIni(id)` opens an initiative of it. */
-export function daySection({ ws, setState, openIni } = {}) {
+export function daySection({ ws, setState, openIni, owed } = {}) {
   if (FIXTURE) return null;
   // like Today's own feeds, a read that lands re-renders only while the section is on the page: a hidden Today must not
   // cause a whole-page render under whatever the PM is doing elsewhere
@@ -755,7 +787,7 @@ export function daySection({ ws, setState, openIni } = {}) {
     c.error ? el('p', { class: 'td-day__run td-day__run--failed', role: 'status', 'data-day': 'error' }, D.refused(c.error)) : null,
     m.d && m.d.legacy ? note(D.oldServer) : null,
     el('div', { class: 'td-day__cols' },
-      el('div', { class: 'td-day__left' }, calendar(ctx), jobsPanel(ctx), goalsPanel(ctx), mentionsPanel(ctx)),
+      el('div', { class: 'td-day__left' }, summaryPanel(ctx), calendar(ctx), jobsPanel(ctx), goalsPanel(ctx), mentionsPanel(ctx), waitingPanel(owed)),
       detail(ctx)));
 }
 

package/workspace/public/vendor/lucide-sprite.js

@@ -1,5 +1,5 @@
 /* lucide-sprite.js — GENERATED by workspace/third-party/build-lucide-sprite.js from lucide-static 1.52.0.
- * Do not edit by hand. The icons: grip-vertical, plus, check, square, square-check-big, x, undo-2, flag, bot, chevron-right, chevron-down, ellipsis, circle-alert, history, arrow-up, arrow-down, diamond, settings, search, refresh-cw, chevron-left, sun, moon, arrow-left, arrow-right, globe, columns-2, arrow-up-down, arrow-left-right.
+ * Do not edit by hand. The icons: grip-vertical, plus, check, square, square-check-big, x, undo-2, flag, bot, chevron-right, chevron-down, ellipsis, circle-alert, history, arrow-up, arrow-down, diamond, settings, search, refresh-cw, chevron-left, sun, moon, arrow-left, arrow-right, globe, columns-2, arrow-up-down, arrow-left-right, panel-top, panel-left, maximize-2, minimize-2, git-branch, clock.
  *
  * ISC License
  *
@@ -75,5 +75,11 @@ export const SPRITE = '<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true
   + '<symbol id="lucide-columns-2" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="18" height="18" x="3" y="3" rx="2" /><path d="M12 3v18" /></symbol>'
   + '<symbol id="lucide-arrow-up-down" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m21 16-4 4-4-4" /><path d="M17 20V4" /><path d="m3 8 4-4 4 4" /><path d="M7 4v16" /></symbol>'
   + '<symbol id="lucide-arrow-left-right" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M8 3 4 7l4 4" /><path d="M4 7h16" /><path d="m16 21 4-4-4-4" /><path d="M20 17H4" /></symbol>'
+  + '<symbol id="lucide-panel-top" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="18" height="18" x="3" y="3" rx="2" /><path d="M3 9h18" /></symbol>'
+  + '<symbol id="lucide-panel-left" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="18" height="18" x="3" y="3" rx="2" /><path d="M9 3v18" /></symbol>'
+  + '<symbol id="lucide-maximize-2" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 3h6v6" /><path d="m21 3-7 7" /><path d="m3 21 7-7" /><path d="M9 21H3v-6" /></symbol>'
+  + '<symbol id="lucide-minimize-2" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m14 10 7-7" /><path d="M20 10h-6V4" /><path d="m3 21 7-7" /><path d="M4 14h6v6" /></symbol>'
+  + '<symbol id="lucide-git-branch" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 6a9 9 0 0 0-9 9V3" /><circle cx="18" cy="6" r="3" /><circle cx="6" cy="18" r="3" /></symbol>'
+  + '<symbol id="lucide-clock" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10" /><path d="M12 6v6l4 2" /></symbol>'
   + '</svg>';
-export const ICONS = ["grip-vertical","plus","check","square","square-check-big","x","undo-2","flag","bot","chevron-right","chevron-down","ellipsis","circle-alert","history","arrow-up","arrow-down","diamond","settings","search","refresh-cw","chevron-left","sun","moon","arrow-left","arrow-right","globe","columns-2","arrow-up-down","arrow-left-right"];
+export const ICONS = ["grip-vertical","plus","check","square","square-check-big","x","undo-2","flag","bot","chevron-right","chevron-down","ellipsis","circle-alert","history","arrow-up","arrow-down","diamond","settings","search","refresh-cw","chevron-left","sun","moon","arrow-left","arrow-right","globe","columns-2","arrow-up-down","arrow-left-right","panel-top","panel-left","maximize-2","minimize-2","git-branch","clock"];

package/workspace/server.js

@@ -85,6 +85,7 @@ const repoWatch = require('./lib/repo-watch.js');
 tsSettings.adoptEnv(process.env);   // D79 — take the env key into memory and delete it, before anything is spawned
 const scheduleLogic = require('./lib/schedule-logic');
 const { safeFirstInput } = require('./lib/prompt-input');
+const firstInput = require('./lib/first-input');
 const transcriptsLib = require('./lib/transcripts');
 const initiativeFiles = require('./lib/initiative-files');
 const { deriveNextSteps } = require('./lib/next-steps');
@@ -2391,6 +2392,7 @@ function persist(s) {
     meta.initiative = s.initiative == null ? null : s.initiative;
     meta.attributedBy = s.attributedBy || null;
   }
+  if (s.workType) meta.workType = s.workType;
   try {
     fs.writeFileSync(path.join(SESS_DIR, s.id + '.json'), JSON.stringify(meta));
     fs.writeFileSync(path.join(SESS_DIR, s.id + '.scrollback'), s.buf);
@@ -2703,6 +2705,7 @@ function sessionList() {
       // make an inference indistinguishable from a record — the exact confusion this field removes.
       initiative: 'initiative' in s ? (s.initiative == null ? null : s.initiative) : null,
       attributed_by: 'initiative' in s ? (s.attributedBy || null) : null,
+      work_type: s.workType || null,
       profile_id: 'profile' in s ? (s.profile == null ? null : s.profile) : null,
       profile_line: profilesLib.profileLine(
         !('profile' in s) ? undefined
@@ -3095,7 +3098,27 @@ function resolveProfileForSpawn(id) {
       : `profile "${id}" is not among the descriptors in ${read.dir} — PMOS will not substitute another` };
 }
 
-function spawnSession({ name, agent, cwd, ws, origin, initialInput, profile, initiative, modelAsk, planItem }) {
+/* The type of work a session is doing (0.55.1): the dock shows it under the session's name. Set by what started the
+ * session (a skill, a schedule) or chosen by the PM; changed later from the session's ⋯ sheet. Optional: a session
+ * with none shows nothing, and a session started before this field existed restores with none. */
+const WORK_TYPES = Object.freeze(['research', 'prototype', 'prd', 'build', 'review', 'report', 'general']);
+const workTypeOrNull = (v) => (WORK_TYPES.includes(String(v || '').toLowerCase()) ? String(v).toLowerCase() : null);
+
+/* Starting a session FROM a skill (0.55.1): the same launch a scheduled run makes (fireSchedule), on the PM's press —
+ * the skill's agent, its prompt (filing contract retargeted for this workspace) as the first input, and its tier. */
+function skillLaunch(wsIdArg, skillId) {
+  const w = getWs(wsIdArg) || homeWorkspace();
+  const root = w ? w.root : SELF_ROOT;
+  const tasks = loadTasks(root);
+  const id = String(skillId || '');
+  const task = tasks.find((t) => t.id === id) || tasks.find((t) => t.skill === id) || null;
+  if (!task) return { ok: false, error: `no skill named ${id.slice(0, 60)} in this repository` };
+  const prompt = task.prompt ? skillStore.retargetFiling(task.prompt, filingContract(w)) : null;
+  return { ok: true, agent: task.agent || 'claude', initialInput: prompt ? prompt + '\r' : null,
+    modelAsk: { skillTier: task.tier || null, skill: task.skill } };
+}
+
+function spawnSession({ name, agent, cwd, ws, origin, initialInput, profile, initiative, modelAsk, planItem, workType }) {
   const id = nextSessionId();
   /* pm-os-absorb Run 1 — every AGENT session gets a token, `<id>.<8 hex>`, in its environment as PMOS_SESSION, and
    * PMOS_BIN, this workspace's own bin/pmos.js. `pmos item` run inside it is then attributed `agent:<token>` (the token
@@ -3113,7 +3136,9 @@ function spawnSession({ name, agent, cwd, ws, origin, initialInput, profile, ini
   // a scheduled run tags the session with its origin, and feeds the skill invocation as first input
   const tag = origin || null;
   // safeFirstInput: a first input that begins with `/` is read by the agent as a slash command, not as the task.
-  const feed = (s) => { if (initialInput && s && s.pty) { try { setTimeout(() => { try { s.pty.write(safeFirstInput(initialInput)); } catch {} }, 700); } catch {} } };
+  // firstInput.deliver waits until the agent is ready to read, types the prompt, then presses Enter as its own key
+  // (lib/first-input.js): a burst written at a fixed 700 ms was lost or left unsent while the agent was still starting.
+  const feed = (s) => { if (initialInput && s && s.pty) { try { firstInput.deliver(s, safeFirstInput(initialInput)); } catch {} } };
   // shell gets a real fallback to `sh`; agent CLIs run as-is (harness untouched), NO fallback —
   // falling back from `claude` to `sh` would be a lie.
   const cmd = isShell ? (commandExists(SHELL) ? SHELL : 'sh') : agent;
@@ -3141,6 +3166,8 @@ function spawnSession({ name, agent, cwd, ws, origin, initialInput, profile, ini
   // Hand to agent: the breakdown item this session was started for, or null. Set only by /api/plan-items/handoff/go.
   base.plan_item = planItem || null;
   base.token = sessionToken;
+  const wt = workTypeOrNull(workType);
+  if (wt) base.workType = wt;
 
   /* WHICH MODEL (D75). Resolved once, here, with the profile, so the record can say only what was applied.
    * Three states are kept apart — not asked, applied, and "this binary has no model control" — and a choice that
@@ -3259,7 +3286,7 @@ function spawnSession({ name, agent, cwd, ws, origin, initialInput, profile, ini
 // A FAILED git operation in a real repo must never spawn a session on the wrong branch (rubric
 // hard floor): we return {ok:false} and spawn nothing. Kept as its own function so the
 // git-then-maybe-spawn contract is unit-testable without a WS client.
-function spawnWithBranch({ name, agent, cwd, ws, branch, createBranch, isolate, profile, initiative, modelAsk, origin, initialInput, planItem }) {
+function spawnWithBranch({ name, agent, cwd, ws, branch, createBranch, isolate, profile, initiative, modelAsk, origin, initialInput, planItem, workType }) {
   const w = getWs(ws);
   if (!w) return { ok: false, error: 'no workspace' };
   // The profile is checked BEFORE any git operation. A composer that picked a profile PMOS cannot
@@ -3306,7 +3333,7 @@ function spawnWithBranch({ name, agent, cwd, ws, branch, createBranch, isolate,
       broadcast({ t: 'branch', ws: w.id, ...gitInfo.branchInfo(w.root) });   // let every client refresh the chip
     }
   }
-  const s = spawnSession({ name, agent: agent || 'shell', cwd, ws: targetWs, profile: pres.id, initiative, modelAsk, origin, initialInput, planItem });
+  const s = spawnSession({ name, agent: agent || 'shell', cwd, ws: targetWs, profile: pres.id, initiative, modelAsk, origin, initialInput, planItem, workType });
   // The co-tenancy fact, on the ordinary path too. Note where this sits: OUTSIDE the `if (branch)`
   // block above. The isolate default already computes that other sessions would be disturbed — and
   // then the whole git block is skipped when no branch was picked, which is the common path and the
@@ -3409,7 +3436,7 @@ function startPreview({ initiative, repoKey, ws }) {
 // One click. Resolves the policy, then hands the SAME seam spawnWithBranch already exposes the
 // branch/isolate decision it made — so the inherited hard floor (a failed git operation spawns
 // nothing) is enforced in exactly one place and is not re-implemented here.
-function startWork({ initiative, repoKey, ws, agent, name, profile, origin, initialInput, planItem }) {
+function startWork({ initiative, repoKey, ws, agent, name, profile, origin, initialInput, planItem, workType, modelAsk }) {
   const key = repoKeyFor({ repoKey, ws });
   if (!key) return { ok: false, error: 'no repository selected' };
   const trees = treesOfRepo(key);
@@ -3437,6 +3464,8 @@ function startWork({ initiative, repoKey, ws, agent, name, profile, origin, init
     origin, initialInput,
     // Hand to agent (pm-os-absorb Run 1): only /api/plan-items/handoff/go passes it.
     planItem,
+    // 0.55.1 — the dock's new-session sheet: the type of work, and a skill's model ask.
+    workType, modelAsk: modelAsk || null,
   });
   if (!r.ok) return r;
   return { ok: true, session: r.session, notice: r.notice || plan.why, plan: plan.plan };
@@ -3621,8 +3650,15 @@ function daySkillPrompt(run, skillId) {
 function startDayTask(run, t, now) {
   const sk = daySkillPrompt(run, 'day-task');
   let s = null;
-  if (!sk.error) {
-    const prompt = `${sk.prompt}\n\nThis run: /day-task ${t.id} ${t.mode} — read the task first with: pmos proactive day show ${t.id}`;
+  const line = `This run: /day-task ${t.id} ${t.mode} — read the task first with: pmos proactive day show ${t.id}`;
+  // The session that did the task's last step is used again while it is open: it has the skill and the task in its
+  // context already, so only this run's line is typed into it, and the PM keeps one session per job.
+  const prev = t.prev_session && sessions.get(t.prev_session);
+  if (!sk.error && prev && prev.state !== 'exited' && prev.pty) {
+    try { firstInput.deliver(prev, line + '\r'); s = prev; } catch { s = null; }
+  }
+  if (!sk.error && !s) {
+    const prompt = `${sk.prompt}\n\n${line}`;
     s = spawnSession({ name: `${t.title} · day task`, agent: sk.task.agent || 'claude', ws: sk.w ? sk.w.id : run.ws, origin: 'day-task', initialInput: prompt + '\r',
       modelAsk: { scheduleTier: null, skillTier: sk.task.tier || null, skill: sk.task.skill } });
   }
@@ -6280,6 +6316,25 @@ async function handleRequest(req, res) {
     boardCache.invalidate(root);
     return json(res, { ok: true, id, lane, previous: before, changed: true });
   }
+  if (p === '/api/session/meta' && req.method === 'POST') {
+    // 0.55.1 — the dock's ⋯ sheet: a session's NAME and TYPE OF WORK. Labels only: no checkout, no respawn. The
+    // initiative has its own route (below) because it carries provenance; these two are just what the PM calls it.
+    let body = {};
+    try { body = JSON.parse((await readBody(req)) || '{}'); }
+    catch { return json(res, { ok: false, error: 'invalid JSON body' }, 400); }
+    const g = pmGuard.requirePmPress(req, body, { act: 'bind' });
+    if (!g.ok) return json(res, { ok: false, error: g.error }, g.status);
+    const s = sessions.get(String(body.id || ''));
+    if (!s) return json(res, { ok: false, error: 'no such session' }, 404);
+    if ('workType' in body) {
+      const wt = body.workType === null || body.workType === '' ? null : workTypeOrNull(body.workType);
+      if (body.workType && !wt) return json(res, { ok: false, error: 'type of work must be one of ' + WORK_TYPES.join(', ') }, 400);
+      if (wt) s.workType = wt; else delete s.workType;
+    }
+    if (typeof body.name === 'string' && body.name.trim()) renameSession(s.id, body.name);
+    persist(s); pushSessions();
+    return json(res, { ok: true, id: s.id, name: s.name, work_type: s.workType || null });
+  }
   if (p === '/api/session/initiative' && req.method === 'POST') {
     /* Bind a RUNNING session to an initiative — the PM's own word about work already in flight
      * (workspace-session-attribution R3/R8).
@@ -7902,9 +7957,13 @@ wss.on('connection', (ws) => {
       // `initiative` is what the client has always held and never sent: `＋ session` is clicked on
       // an initiative row, the tab carries its `slug`, and the spawn message named three other
       // fields. An absent or unusable value leaves the session unattributed — never a refused spawn.
-      const r = spawnWithBranch({ name: m.name, agent: m.agent, cwd: m.cwd, ws: m.ws, branch: m.branch, createBranch: m.createBranch, isolate: m.isolate, profile: m.profile, initiative: wsBindable(ws, m.initiative),
+      // 0.55.1 — a session started FROM a skill: the skill's agent, prompt and tier, resolved here and never sent.
+      const sk = m.skill ? skillLaunch(m.ws, m.skill) : null;
+      if (sk && !sk.ok) { ws.send(JSON.stringify({ t: 'error', error: 'skill: ' + sk.error })); return; }
+      const r = spawnWithBranch({ name: m.name, agent: sk ? sk.agent : m.agent, cwd: m.cwd, ws: m.ws, branch: m.branch, createBranch: m.createBranch, isolate: m.isolate, profile: m.profile, initiative: wsBindable(ws, m.initiative),
         // D75 — what the composer chose (a tier, or a model), carried like the profile. Absent = not asked.
-        modelAsk: (m.tier || m.model) ? { explicit: { tier: m.tier, model: m.model, effort: m.effort } } : null });
+        modelAsk: sk ? sk.modelAsk : ((m.tier || m.model) ? { explicit: { tier: m.tier, model: m.model, effort: m.effort } } : null),
+        initialInput: sk ? sk.initialInput : null, workType: m.workType });
       // A refused profile is its own sentence, not "branch: …" — the composer's error line names
       // what PMOS could not read, and nothing was started.
       if (!r.ok) { ws.send(JSON.stringify({ t: 'error', error: (/^(profile|model choice) /.test(r.error || '') ? '' : 'branch: ') + r.error })); return; }
@@ -7916,8 +7975,13 @@ wss.on('connection', (ws) => {
       // repo-first R1 — the one-click path. It carries an INITIATIVE (or none) and a repository,
       // never a branch and never an isolate flag: those are the policy's to decide, and a client
       // that could still send them would be a second place the rule lives.
+      const sk = m.skill ? skillLaunch(m.ws, m.skill) : null;
+      if (sk && !sk.ok) { ws.send(JSON.stringify({ t: 'error', error: 'skill: ' + sk.error })); return; }
       const r = startWork({ initiative: wsBindable(ws, m.initiative), repoKey: m.repoKey, ws: m.ws,
-        agent: m.agent, name: m.name, profile: m.profile });
+        agent: sk ? sk.agent : m.agent, name: m.name, profile: m.profile,
+        initialInput: sk ? sk.initialInput : null, workType: m.workType,
+        // a blank session from the dock carries the Settings tier (D75); a skill's own tier wins
+        modelAsk: sk ? sk.modelAsk : (m.tier ? { explicit: { tier: m.tier } } : null) });
       if (!r.ok) { ws.send(JSON.stringify({ t: 'error', error: (/^profile /.test(r.error || '') ? '' : 'start: ') + r.error })); return; }
       if (r.notice) ws.send(JSON.stringify({ t: 'notice', notice: r.notice }));
       ws.send(JSON.stringify({ t: 'created', id: r.session.id }));

package/workspace/test-lists/workspace-phone-command.json

@@ -0,0 +1,5 @@
+{
+  "_comment": "workspace-phone-command: `pmos phone` — lib/phone-cli.js reading the startup banner back, and the real launcher's reuse, restart and Tailscale-refused paths on a scratch port.",
+  "modules": ["phone-command.test.js"],
+  "seconds": { "phone-command.test.js": 4 }
+}

package/workspace/third-party/README.md

@@ -12,7 +12,7 @@ The workspace runs with no network (D62). Two third-party browser files are comm
 | Package | Version | Licence | Tarball | Tarball sha256 | Shipped file |
 |---|---|---|---|---|---|
 | sortablejs | 1.15.7 | MIT | https://registry.npmjs.org/sortablejs/-/sortablejs-1.15.7.tgz | `66cbfc8fa18860783584fe0c346baf6cbf3399da72d23d21053425ba232abed4` | `public/vendor/Sortable.min.js`: an unmodified copy of `package/Sortable.min.js` (45 478 bytes, sha256 `bf4241bc73fef7f11c59a283a69fe8051cdd31c6d8ff5a2b9ba219e7831fcf76`; npm integrity `sha512-Kk8wLQPlS+yi1ZEf48a4+fzHa4yxjC30M/Sr2AnQu+f/MPwvvX9XjZ6OWejiz8crBsLwSq8GHqaxaET7u6ux0A==`) |
-| lucide-static | 1.52.0 | ISC, plus the Feather MIT notice | https://registry.npmjs.org/lucide-static/-/lucide-static-1.52.0.tgz | `4d2aa079171e4eba4c704844b8b0c9edb6e4cfb2fb8bd86f7b14353994f04a87` | `public/vendor/lucide-sprite.js`: generated by `build-lucide-sprite.js` (11 930 bytes, sha256 `692b332b79456b0fa8a47ef813a2ce54d6f5f47d00e41e85277d6ecd39e6a38b`). It holds 29 icons: grip-vertical, plus, check, square, square-check-big, x, undo-2, flag, bot, chevron-right, chevron-down, ellipsis, circle-alert, history, arrow-up, arrow-down, diamond, then the eight the frame's chrome draws (Run 3): settings, search, refresh-cw, chevron-left, sun, moon, arrow-left, arrow-right, then globe, columns-2, arrow-up-down and arrow-left-right for the dock strip's web, split and orientation chips (Run 3, C6) |
+| lucide-static | 1.52.0 | ISC, plus the Feather MIT notice | https://registry.npmjs.org/lucide-static/-/lucide-static-1.52.0.tgz | `4d2aa079171e4eba4c704844b8b0c9edb6e4cfb2fb8bd86f7b14353994f04a87` | `public/vendor/lucide-sprite.js`: generated by `build-lucide-sprite.js` (13 525 bytes, sha256 `3bb7ec3369206ff1bc8c6ae5dfd91c5d99e5ec89c4357d18b744b594ea366447`). It holds 35 icons: grip-vertical, plus, check, square, square-check-big, x, undo-2, flag, bot, chevron-right, chevron-down, ellipsis, circle-alert, history, arrow-up, arrow-down, diamond, then the eight the frame's chrome draws (Run 3): settings, search, refresh-cw, chevron-left, sun, moon, arrow-left, arrow-right, then globe, columns-2, arrow-up-down and arrow-left-right for the dock strip's web, split and orientation chips (Run 3, C6), then panel-top, panel-left, maximize-2, minimize-2, git-branch and clock for the dock's icon controls and session rows (0.54.2) |
 
 The licences are in this folder: [sortablejs-1.15.7.LICENSE](sortablejs-1.15.7.LICENSE) and [lucide-static-1.52.0.LICENSE](lucide-static-1.52.0.LICENSE). The sprite also carries the lucide licence text as its first comment.