@timqi/pier 0.0.29 → 0.1.0

package/skills/pier-tasks/SKILL.md

@@ -3,175 +3,160 @@ name: pier-tasks
 description: Delegate work to Pier subagents with the task tool — one-shot, parallel fan-out, chains, mid-run control. Read before delegating to a subagent, coordinating agents, or running long background work.
 ---
 
-# Orchestrating Pier tasks
-
-## Core model
-
-- Every run executes a persisted task definition. A `run` without `task_id`
-  — a bare `prompt`, or a full `task` draft — creates and runs a one-shot
-  subagent atomically: `kind:"subagent"`, hidden from `list`, named by the
-  prompt's first line. You never file it.
-- **Nothing blocks.** Every operation returns immediately; results, group
-  joins and decision replies arrive as system follow-up messages once your
-  turn ends (batched when several are due). Ending your turn is the only wait.
-- The child session survives the run — `resume` continues it with context
-  intact. `get` polls: `run_id` (full result), `group_id`, or `task_id` (10
-  most recent runs). Lists truncate results at 2000 chars, callbacks at 8000,
-  both saying so; `get run_id` is whole.
-- Limits: a tree is ≤3 runs deep below the session that started it (depth
-  0–2; the fourth `run` errors) and holds ≤16 runs below its root (depth ≥ 1,
-  resumes included) — your direct children are each a root, uncounted. 4
-  agent runs execute at once instance-wide; the rest wait for a slot without
-  error, but the timeout clock starts at queue time, so a run queued behind
-  long ones can time out unstarted.
-- Timeout: 900s default → `failed` / `task timed out`; `timeoutSeconds`
-  1–86400, draft form only. A Pier restart ends queued/running runs as
-  `interrupted` (callback still arrives) and refuses new root runs while
-  draining — retry after.
-
-## Single delegation (the common case)
+# Pier tasks
+
+## Delegate, then wait
 
 ```json
-{"operation":"run","prompt":"Review src/auth/*.ts for injection risks. Output: file:line + issue + fix."}
+{"operation":"run","prompt":"Review src/auth/*.ts. Return file:line, issue, fix."}
 ```
 
-That is the whole call: a fresh session in **your own directory**. `cwd`
-places it elsewhere — absolute, or relative to yours (`"cwd":"../pier.x"` for
-a sibling worktree); it must exist. `launch` picks model/thinking, `name`
-overrides the label, `input` (any JSON) is appended to the prompt as
-`<task_input>`. The `task` draft form is for what the shorthand cannot say —
-`timeoutSeconds`, or `reuse` of an existing session:
+One concern per child. `run` with `prompt` or a full `task` draft atomically
+creates a persisted one-shot (`kind:"subagent"`, hidden from `list`); do not
+`create` it. Name defaults to the prompt's first line; `name` overrides it.
+
+All operations return immediately. Results and decision replies arrive by
+callback; **end your turn after launching work**. Default callbacks are system
+follow-ups, batched when several are due. A long turn delays them; there is no
+status query. The receipt's `next` tells you where/how delivery happens:
+
+- `callback:"origin"` (default): result returns to you after your turn.
+- `callback:"steer"`: interrupts at a step boundary; use when needed mid-turn,
+  not for work you launch and forget. Receipt echoes `callbackMode`.
+- `callback:"none"`: no delivery; means you do not want the result, not pull later.
+- Single-run `callback_session_id`: deliver to another existing session.
+
+Receipts include `runId`, `taskId`, state. Keep IDs: the callback also names
+`Run:`, and there is no lookup by task. `triggerSource` names the actual invoker
+(`agent/manual/cron/watch/task`); the definition's `trigger` is scheduling
+policy (`manual` means on demand).
+
+## Sessions and prompts
+
+- Default `fresh`: clean context. `cwd` defaults to your directory, accepts an
+  absolute path or one relative to yours, and must exist.
+- `reuse`: existing session by `sessionId`; continues its history after it is
+  idle. `launch` applies only to fresh sessions; reused sessions own their
+  model/tools. Children otherwise have your tools, including `task`.
+- **The prompt is the handoff**: no implicit copy of your discussion. Include
+  the goal, current decisions, latest constraints, absolute paths, acceptance
+  criteria, verification and output format. `input` accepts any JSON, appended
+  in `<task_input>`.
+- For more work on an existing result, `resume` that run with a delta prompt;
+  its session/context survives. Start fresh for unrelated work or stale context.
+- Stored role: `run` with `task_id` and optional `input`;
+  `session_mode:"fresh"` overrides a stored reuse policy. Archived tasks refuse.
+
+Use a `task` draft for `timeoutSeconds` or reuse:
 
 ```json
-{"operation":"run","task":{"name":"long build","timeoutSeconds":3600,"action":{"type":"agent","session":{"mode":"fresh","cwd":"/abs/path"},"prompt":"..."}}}
+{"operation":"run","task":{"timeoutSeconds":3600,"action":{"type":"agent","session":{"mode":"reuse","sessionId":"..."},"prompt":"Check the result"}}}
 ```
 
-Omit `trigger` in a draft (anything but `manual` errors); a draft's `callback`
-is ignored on runs you fire — the result comes to you — and matters only for
-`create`d schedules. Returns a run summary (`runId`, `taskId`,
-`state:"queued"`, …); `callback:"none"` silences the result,
-`callback_session_id` routes it to another existing session. A summary's
-`triggerSource` is who fired the run (`agent` / `manual` / `cron` / `watch` /
-`task`); a definition's `trigger` is only its schedule, `manual` meaning
-on-demand — by a human or by you.
-
-- `fresh`: clean context in a `cwd` (yours when omitted) — the normal start.
-  `reuse`: an existing session by id, continuing its history; the run waits
-  for it to go idle. Nothing copies your context into a child: what the child
-  needs, you write down.
-- **The handoff is the prompt.** A child cannot see your discussion, so state
-  the goal, the decisions *currently* in force (not the ones argued out of),
-  late constraints, absolute paths, what "done" means and how to verify it.
-  Writing it is the check — a decision you cannot state in a sentence was not
-  settled.
-- The child inherits your current model unless `launch.model` is set, and has
-  the same tools you do, `task` included. An unknown model id fails the *run*,
-  not the call — the error, with the first available ids, arrives in the
-  callback; an unknown `launch.thinking` fails the call. `launch` applies to
-  `fresh` only — a `reuse` session owns its own model and tools.
-- Stored roles: `run` with `task_id` (+ optional `input`);
-  `session_mode:"fresh"` runs a `reuse`-mode role in a fresh session instead.
-  Archived tasks refuse to run.
-
-## Parallel fan-out (core-joined)
-
-`tasks[]` — 2+ entries, each a prompt string, `{"prompt","cwd"?,"launch"?,
-"name"?}`, a full draft, or `{"task_id":"..."}`; never with `task`, `task_id`
-or `session_mode` — and Pier joins the group in core; you never track run ids:
+Inline drafts may omit `trigger`; only `manual` is allowed. Their nested
+`callback` is ignored: use top-level delivery options above. Nested callbacks
+matter for saved schedules (below).
+
+## Groups and chains
+
+`tasks[]` needs 2+ entries: prompt strings, `{prompt,cwd?,launch?,name?}`, full
+drafts, or `{task_id}`. Do not combine it with `task`, `task_id` or `session_mode`.
+
+```json
+{"operation":"run","tasks":["Review correctness","Review test gaps"],"join":"all"}
+```
+
+- `join:"all"` (default): one callback with every member's name, state and result
+  when all are terminal.
+- `join:"first"`: first **any terminal state**, including failure/overlap skip,
+  wins. Others are cancelled; their sessions remain resumable, IDs in callback.
+- Core owns the join; never hand-aggregate member IDs across turns. Members have
+  no individual callbacks; `none`/`steer` applies to the group. `cancel` and
+  `recover` accept `group_id`. Admission failure (e.g. limit or missing cwd)
+  rolls back the group: nothing runs.
+
+For a chain: launch step 1 → end turn → receive callback → put needed results
+in step 2's self-contained prompt. Branching and retries are your responsibility.
+
+## Model choice
+
+Default: inherit your current model. For harder reasoning, raise
+`launch.thinking` first (`off/minimal/low/medium/high/xhigh/max`). For cheap bulk
+work, choose the same provider's smallest current model with low/off thinking;
+for an independent vendor's opinion, choose its flagship.
+
+Before naming a model, call `{"operation":"models"}`; never use IDs from memory.
+It returns operator pins (`source:"menu"`, intent notes/usual thinking) or the
+live catalog (`source:"catalog"`). Prefer a matching pin and its thinking level.
+`launch.model` overrides inheritance. Unknown model IDs fail the run and report
+available IDs by callback; invalid `launch.thinking` fails the call.
+
+## Control and decisions
+
+`message` must be non-empty, <16 KiB. Controls require ownership: your delegated
+trees, or only descendants when you are a subagent.
+
+- `steer`: interrupt a child with corrections.
+- `follow_up`: queue guidance after its current turn.
+- `resume`: terminal run only; same session, new run ID/callback, same depth,
+  message as prompt. Expires its unanswered decision.
+- `cancel`: run or group; cascades to descendants, terminal runs unchanged.
+
+`steer`/`follow_up` require a non-terminal run; undelivered guidance expires when
+it ends. For finished work use `resume`.
+
+Child → supervisor:
+
+```json
+{"operation":"contact","reason":"decision","message":"Use API A or B?"}
+```
+
+Requires an active delegated Agent run with a supervisor (scheduled cron/watch
+runs have none). `progress` is fire-and-forget; `decision` steers the supervisor
+and permits one open question per run. State what you await and **end your
+turn**, never spin/poll. A finished run with an open question suppresses its
+completion callback: the question is the notification.
+
+Supervisor → child:
 
 ```json
-{"operation":"run","join":"all","tasks":[
-  "Review src/ for correctness bugs. Output: file:line + issue.",
-  {"prompt":"Review the tests for gaps. Output: missing case + file.","cwd":"packages/web"}]}
+{"operation":"reply","message_id":"...","message":"Use API A"}
 ```
 
-- `join:"all"` (default): one aggregated follow-up when every member is
-  terminal — each member's name, state, result.
-- `join:"first"`: the first member to reach *any* terminal state wins, a
-  failure included; the rest are cancelled, their sessions resumable (run ids
-  in the callback).
-- Members send no individual callbacks; `callback:"none"` silences the
-  group's. `get`/`cancel` take `group_id` for the whole group. A member that
-  cannot enqueue (limit, missing `cwd`) rolls the group back — nothing runs.
-
-## Chains
-
-Run step 1, end your turn, receive its callback, splice the needed part into
-step 2's prompt. Children share nothing implicitly — every prompt is
-self-contained: paths, acceptance criteria, output format. Branching and
-retries are your own logic between turns.
-
-## Choosing a model and thinking level
-
-Omit `launch.model` to inherit your own model — the right default. When the
-task profile clearly differs, adjust in this order:
-
-- **Harder reasoning → raise `launch.thinking` first**, on the inherited
-  model (`off` … `minimal` `low` `medium` `high` `xhigh` `max`): no model
-  name needed, usually cheaper than switching models.
-- **Cheap bulk work** (listings, extraction, simple checks) → the same
-  provider's smallest current model, thinking low or off.
-- **Cross-vendor second opinion** → another vendor's flagship.
-
-Never write a model id from memory — catalogs move under you.
-`{"operation":"models"}` is the authority: operator-pinned models when set
-(`source:"menu"`, each with an intent note and often a usual `thinking`
-level), else the curated live catalog (`source:"catalog"`). Prefer a pinned
-entry whose note matches the task and start from its thinking level.
-
-## Mid-run control
-
-- `steer` — interrupt a running child with corrected instructions
-- `follow_up` — queue a message for after its current turn
-- `resume` — continue a finished child in its same session, `message` as the
-  prompt: a new run (new `runId`, own callback, same depth); expires any
-  unanswered decision on that run
-- `cancel` — stop a run, or a whole group via `group_id`; cascades to the
-  run's children; a terminal run is returned unchanged
-
-`steer`/`follow_up` need a non-terminal run (else `resume`); one undelivered
-when the run ends expires. `resume` needs a terminal run. All four accept only
-runs you own — trees you started, or, inside a run, your own descendants.
-`message`: non-empty, <16 KiB.
-
-## Supervisor decisions (as a child)
-
-`{"operation":"contact","reason":"decision","message":"..."}` returns a
-receipt immediately. State what you await and **end your turn** — never spin
-or poll. The answer is steered into your current turn if your run is still
-active; if it finished, Pier resumes your session with the reply as the
-prompt. One open decision per run. `contact` works only inside a run a session
-delegated — a cron/watch run has no supervisor. `reason:"progress"` is
-fire-and-forget status for the parent.
-
-As a parent: the question arrives as a system input with a message id, steered
-into your current turn at the next step boundary so the child does not wait
-out your turn. Answer with `{"operation":"reply","message_id":"...",
-"message":"..."}` — only the addressed supervisor may; same text twice is a
-no-op, different text an error. A run that finished while awaiting your answer
-shows `pendingDecisionId` in `get` and sends no completion callback — the
-question is the notification; your reply resumes it, and that continuation's
-callback comes to you.
-
-## Rules
-
-- One concern per child. For fan-out, let core join via `tasks[]` — never
-  hand-aggregate run ids across turns.
-- **A change to work a child already did → `resume` that run**, not a new
-  child: its session still holds the files it read and the decisions it made,
-  so the message can be a delta ("same file, also handle the empty input").
-  Go `fresh` when the new work shares nothing with the old — different area,
-  different goal — or when that session is long and mostly dead ends: clean
-  context plus a self-contained prompt beats a child sifting its own noise.
-  Lost the `run_id`? `get` with the summary's `task_id` lists that task's
-  recent runs — a one-shot subagent has one too.
-- `create` is for definitions that outlive one job: a schedule (`cron` /
-  `watch`), or a role run by `task_id` again and again. It files a task the
-  operator sees and must archive by hand — never for a one-off; that is `run`
-  with a prompt. `update` takes the whole draft again, `trigger` included. A
-  schedule reports to nobody unless its `callback` is
-  `{"type":"session","sessionId":"..."}` — `origin` is the invoker, which a
-  cron run lacks.
-- Inside a run: Agent tasks only (stored or inline), no `reuse`, no
-  `create`/`update`.
-- After launching work, end your turn. The callback starts your next one.
+Only the addressed supervisor may reply. Same text twice is a no-op; different
+text errors. The answer steers an active child or auto-resumes a terminal one
+with the reply as prompt; the continuation's callback returns to the replier.
+
+## Recover lost information only
+
+`recover` requires `run_id` or `group_id` plus `reason` (e.g. text truncated,
+context lost to compaction). **Never use it to check progress.**
+
+- Run must be terminal and its callback settled: delivered, abandoned, or none.
+  Group members wait for their group callback; a terminal race winner is
+  readable while losers are still cancelling.
+- Whole-group recovery additionally requires every member terminal. An open
+  decision directs you to `reply`. Other premature requests get a refusal
+  that reveals no state.
+- Callbacks truncate each result at 8000 characters; recovered groups truncate
+  member results at 2000. Notes point to `recover run_id`, which returns full
+  text. `none` remains a no-result preference, not a polling workflow.
+
+## Persistence and limits
+
+`create` files an operator-visible definition only for recurring roles or
+cron/watch schedules; the operator must archive it. `update` takes the entire
+draft, including `trigger`. Schedules notify only with nested
+`callback:{"type":"session","sessionId":"..."}`; `origin` needs an invoker,
+which scheduled runs lack.
+
+- Inside a run: Agent actions only (stored/inline), no reuse or create/update.
+- Depth 0–2: at most 3 runs below the invoking session; a fourth errors. Each
+  root allows 16 descendant runs (depth ≥1, resumes included). Your direct
+  children are separate roots and do not count toward that limit.
+- 4 Agent runs execute instance-wide; others queue without error. Timeout
+  starts **at enqueue**, so a run can time out before starting.
+- Default timeout 900s; `timeoutSeconds:1–86400` in draft form only. Timeout
+  reports `failed / task timed out`.
+- Restart marks queued/running runs `interrupted`; callbacks still apply.
+  During drain, new roots are refused: retry after restart.

package/dist/web/public/assets/boards-BIObcQeX.js

@@ -1 +0,0 @@
-import{F as e,G as t,H as n,K as r,P as i,R as a,U as o,g as s,k as c,z as l}from"./index-uFsZkKOQ.js";var u=e=>e.public&&e.token?`/p/${e.slug}-${e.token}/`:`/boards/${e.slug}/`;function d(d,f){let p=[],m=``,h=a(`header`,`sticky top-0 z-30 flex h-10 items-center gap-3 border-b border-neutral-200 bg-white px-4`,a(`span`,`font-medium max-md:hidden`,`Boards`)),g=a(`div`,`px-4 py-5`);d.append(a(`div`,`min-h-0 flex-1 overflow-y-auto`,h,g));async function _(e,t){let i=await r(`/api/boards/${e.slug}`,{public:t},`PATCH`);if(i.ok)return e.token=(await i.json().catch(()=>({}))).token??``,x();m=await n(i,`Could not change ${e.slug}`),await S()}async function v(e){m=await t(`/api/boards/${e}`,`DELETE`,`Could not delete ${e}`)??``,await S()}function y(t){let n=a(`div`,`group flex flex-col gap-1 border-b border-neutral-200/70 px-1 py-2.5 last:border-b-0`),r=document.createElement(`a`);r.className=`truncate font-medium text-neutral-800 hover:text-indigo-700`,r.href=u(t),r.target=`_blank`,r.rel=`noreferrer`,r.textContent=t.title;let i=a(`div`,`flex items-center gap-2`,r,a(`span`,`flex-none font-mono text-[11.5px] text-neutral-400`,t.slug)),o=c(``,``,t.public,e=>{t.public=e,_(t,e)});o.className=`ml-auto flex flex-none cursor-pointer items-center gap-1.5 text-[11.5px] text-neutral-500`,o.append(a(`span`,``,`Public`));let d=s(`Delete`,`flex-none cursor-pointer text-[11.5px] text-neutral-400 opacity-0 transition-opacity hover:text-red-600 group-hover:opacity-100`);d.title=`Renames the folder on disk; nothing is erased`,d.onclick=()=>void v(t.slug);let p=e(`flex-none cursor-pointer text-[11.5px] text-neutral-400 opacity-0 transition-opacity hover:text-indigo-600 group-hover:opacity-100`,()=>`${location.origin}${u(t)}`);p.title=`Copy the board's link`,i.append(o,p,d),n.append(i);let m=a(`div`,`flex flex-wrap items-center gap-x-3 gap-y-1 text-[11.5px] text-neutral-500`);t.description&&m.append(a(`span`,`min-w-0 truncate`,t.description)),m.append(a(`span`,`flex-none text-neutral-400`,l(Date.parse(t.updatedAt))));for(let e of t.sessions){let t=s(e.slice(0,8),`flex-none cursor-pointer font-mono text-indigo-600 hover:underline`);t.title=`Open session ${e}`,t.onclick=()=>f(e),m.append(t)}if(t.public&&t.token){let e=a(`span`,`flex-none font-mono text-neutral-400`,u(t));e.title=`Public URL — anyone holding this link can read the board, no password`,m.append(e)}return n.append(m),n}let b=[{title:`Public`,hint:`Readable at /p/<slug>-<token>/ by anyone holding the link.`,wanted:!0},{title:`Private`,hint:`Reachable from the Console only.`,wanted:!1}];function x(){let e=a(`div`,`mx-auto flex max-w-3xl flex-col`);p.length===0&&e.append(a(`p`,`rounded-xl border border-dashed border-neutral-300 px-4 py-6 text-center text-[12.5px] text-neutral-500`,`No boards yet. Ask an agent to build one — it writes a folder under ~/.pier/boards.`));for(let{title:t,hint:n,wanted:r}of b){let i=p.filter(e=>e.public===r);if(i.length===0)continue;let o=a(`section`,`mb-6`);o.append(a(`h2`,`text-[13px] font-semibold text-neutral-700`,t)),o.append(a(`p`,`mb-1 text-[11.5px] leading-snug text-neutral-500`,n));let s=a(`div`,`rounded-xl border border-neutral-200 bg-white px-3`);s.append(...i.map(y)),o.append(s),e.append(o)}g.replaceChildren(...m?[a(`p`,`mb-3 text-[13px] text-red-600`,m)]:[],e)}async function S(){let e=await o(`/api/boards`,`Could not load boards`);if(!e.ok)return m=e.error,x();p=e.value,x(),m=``}let C=i(d,()=>void S());return window.addEventListener(`focus`,()=>{C.visible&&S()}),C}export{d as createBoardsView};

package/dist/web/public/assets/explorer-C_rSWPNB.js

@@ -1,4 +0,0 @@
-import{I as e,N as t,P as n,R as r,W as i,a,d as o,f as s,i as c,n as l,s as u,u as d,z as f}from"./index-uFsZkKOQ.js";var p=e=>{let t=new Date(e),n=e=>String(e).padStart(2,`0`);return`${t.getFullYear()}-${n(t.getMonth()+1)}-${n(t.getDate())} ${n(t.getHours())}:${n(t.getMinutes())}:${n(t.getSeconds())}`},m=e=>[e.subject,e.body,[[e.author,e.email?`<${e.email}>`:``].filter(Boolean).join(` `),e.at?p(e.at):``].filter(Boolean).join(` · `)].filter(Boolean).join(`
-
-`),h=null;function g(){h&&(h.remove(),h=null,document.removeEventListener(`pointerdown`,g,!0),window.removeEventListener(`scroll`,g,!0))}function ee(e,t){e.onmouseenter=()=>{g();let n=t();if(!n)return;h=r(`div`,`pointer-events-none fixed z-50 max-w-96 whitespace-pre-wrap rounded-lg bg-neutral-800/95 px-3 py-2 font-sans text-[11.5px] leading-snug text-neutral-100 shadow-lg`),h.textContent=n,document.body.append(h),document.addEventListener(`pointerdown`,g,!0),window.addEventListener(`scroll`,g,!0);let i=e.getBoundingClientRect();h.style.left=`${Math.max(8,Math.min(i.left,window.innerWidth-h.offsetWidth-8))}px`,h.style.top=i.bottom+6+h.offsetHeight>window.innerHeight?`${i.top-h.offsetHeight-6}px`:`${i.bottom+6}px`},e.onmouseleave=g}function _(e,t,n){let i=r(`button`,`flex w-full cursor-pointer items-center gap-1.5 px-2 py-1 text-left hover:bg-neutral-100`,r(`span`,`w-3 flex-none text-indigo-600`,e.value===t?`✓`:``),r(`span`,`flex-none font-mono text-[11.5px] text-neutral-800`,e.label??e.value));return e.subject&&i.append(r(`span`,`min-w-0 truncate text-[11px] text-neutral-400`,e.subject)),e.author&&i.append(r(`span`,`ml-auto flex-none pl-1.5 text-[10.5px] text-neutral-400`,`${e.author} · ${e.at?f(e.at):``}`)),ee(i,()=>m(e)),i.onclick=()=>n(e.value),i}function te(e,t,n,i,o){let{base:s,head:l}=n,u=()=>l&&s===`${l}~1`?l:``,d=u()?`commit`:`compare`,f=t.commits[0],p=e=>[...e?[{value:``,label:`Working tree`,subject:`the files on disk, uncommitted changes included`}]:[],{...f,value:`HEAD`},...t.refs.map(e=>({value:e.name,subject:e.subject})),...t.commits.map(e=>({...e,value:e.hash}))],m=r(`div`,`flex w-[38rem] max-w-full flex-col`);function h(){let e=(e,t)=>{let n=r(`button`,`cursor-pointer rounded-full px-2.5 py-0.5 text-[11.5px] ${d===t?`bg-indigo-50 font-medium text-indigo-700`:`text-neutral-500 hover:bg-neutral-100`}`,e);return n.onclick=()=>{d=t,h()},n},n=(e,t,n,i)=>r(`div`,`flex min-w-0 flex-1 flex-col`,r(`div`,`flex-none px-2 pb-0.5 text-[10.5px] font-semibold uppercase tracking-wide text-neutral-400`,e),r(`div`,`min-h-0 flex-1 overflow-y-auto`,...t.map(e=>_(e,n,i)))),a=d===`compare`?r(`div`,`flex h-72 min-h-0 divide-x divide-neutral-200 pb-1`,n(`base`,p(!1),s,e=>{s=e,h(),i(s,l)}),n(`to`,p(!0),l,e=>{l=e,h(),i(s,l)})):r(`div`,`flex h-72 min-h-0 flex-col overflow-y-auto pb-1`,...t.commits.map(e=>_({value:e.hash,...e},u(),e=>{s=`${e}~1`,l=e,c(),i(s,l)}))),f=r(`div`,`flex-none border-t border-neutral-200`,_({value:o,label:`↺ ${o} ↔ Working tree`,subject:`back to the default: the main line's tip vs the files on disk`},s===o&&l===``?o:``,()=>{s=o,l=``,h(),i(s,l)}));m.replaceChildren(r(`div`,`flex flex-none items-center gap-1 border-b border-neutral-200 px-2 py-1.5`,e(`Compare two points`,`compare`),e(`One commit`,`commit`)),a,...d===`compare`?[f]:[])}h(),a(e,m)}var ne=/\.(png|jpe?g|gif|webp|avif|bmp|svg)$/i,v={A:`text-emerald-600`,M:`text-amber-600`,D:`text-red-600`},re=30,y=`pier.filesPrefs`,b=50,x=()=>{try{let e=JSON.parse(localStorage.getItem(y)??`{}`);return e&&typeof e==`object`?e:{}}catch{return{}}},S=e=>{let t=e?x()[e]:void 0;return typeof t?.cwd==`string`&&typeof t.base==`string`&&typeof t.head==`string`?{cwd:t.cwd,base:t.base,head:t.head}:null},ie=(e,t)=>{let n=x();delete n[e],n[e]=t;let r=Object.keys(n);for(let e of r.slice(0,Math.max(0,r.length-b)))delete n[e];try{localStorage.setItem(y,JSON.stringify(n))}catch(e){console.warn(`Files: could not remember this folder`,e)}},ae=(e,t=`indigo`)=>{let n=r(`button`,`min-w-0 cursor-pointer truncate rounded-md px-2 py-0.5 text-left font-mono text-[11.5px] ${t===`indigo`?`bg-indigo-50 font-medium text-indigo-700 hover:bg-indigo-100`:`bg-neutral-100 text-neutral-600 hover:bg-neutral-200`}`,e);return n.type=`button`,n};function C(a,c,f,p){let h=``,g=``,_={branch:null,refs:[],commits:[],worktrees:[]},y=`HEAD`,b=``,x=new Map,C=!0,w=!1,T=[],E=new Set,D=null,O=null,k=r(`header`,`flex h-10 flex-none items-center gap-2 border-b border-neutral-200 bg-white px-3`),A=r(`div`,`flex-none border-b border-neutral-200`),j=r(`div`,`min-h-0 flex-1 overflow-y-auto py-1`),oe=r(`aside`,`flex w-64 flex-none flex-col border-r border-neutral-200 text-[12.5px] max-md:h-2/5 max-md:w-full max-md:border-b max-md:border-r-0`,A,j),M=r(`div`,`h-full min-w-0 overflow-auto`),N=r(`div`,`pointer-events-none absolute inset-y-0 right-0 z-20 hidden w-2`),se=r(`section`,`relative min-h-0 min-w-0 flex-1`,M,N);a.append(k,r(`div`,`flex min-h-0 flex-1 max-md:flex-col`,oe,se));let P=(e,t)=>`/api/explorer/${e}?${new URLSearchParams({root:h,...t})}`,F=(e,t)=>`/api/fs/${e}?${new URLSearchParams({root:h,...t})}`,I=(e,t=`text-neutral-400`)=>r(`p`,`px-4 py-3 text-[12.5px] ${t}`,e),L=e=>{let t=0;for(let n of x.keys())n.startsWith(`${e}/`)&&t++;return t};function R(e,t){let n=new Set(t.map(e=>e.name)),r=e?`${e}/`:``;for(let[e,i]of x){if(i.status!==`D`||!e.startsWith(r))continue;let a=e.slice(r.length).split(`/`)[0];n.has(a)||(n.add(a),t.push({name:a,dir:e.slice(r.length).includes(`/`)}))}let i=t;return C&&_.branch&&(i=t.filter(e=>e.dir?L(`${r}${e.name}`)>0:x.has(`${r}${e.name}`))),i.sort((e,t)=>Number(t.dir)-Number(e.dir)||e.name.localeCompare(t.name)),i.map(e=>e.dir?ce(`${r}${e.name}`,e.name):le(`${r}${e.name}`,e.name))}async function z(e,t){try{let{entries:n}=await i(F(`ls`,{path:t}),`could not list this folder`);e.replaceChildren(...R(t,n)),e.childElementCount||e.append(I(C?`No changes.`:`Empty.`))}catch(n){let r=R(t,[]);r.length?e.replaceChildren(...r):e.replaceChildren(I(String(n),`text-red-600`))}}function ce(t,n){let i=L(t),a=[r(`span`,`truncate`,n)];i&&a.push(r(`span`,`ml-auto flex-none rounded bg-amber-100/80 px-1 font-mono text-[10px] text-amber-700`,String(i)));let{el:o,summary:s}=e(``,a);s.className+=` px-2 py-0.5 hover:bg-neutral-100`;let c=r(`div`,`pl-3`);o.append(c);let l=!1,u=()=>{l||(l=!0,c.append(I(`…`)),z(c,t))};return o.ontoggle=()=>{E[o.open?`add`:`delete`](t),o.open&&u()},(C&&_.branch&&!w||E.has(t))&&(o.open=!0,u()),o}function B(e){O?.classList.remove(`bg-indigo-50`,`text-indigo-700`),O=e,e.classList.add(`bg-indigo-50`,`text-indigo-700`)}function le(e,t){let n=x.get(e)?.status,i=r(`button`,`flex w-full cursor-pointer items-center gap-1.5 px-2 py-0.5 pl-6 text-left hover:bg-neutral-100`,r(`span`,`truncate`,t));return n&&i.append(r(`span`,`ml-auto flex-none font-mono text-[10.5px] font-semibold ${v[n]??`text-neutral-500`}`,n)),i.title=e,e===D&&B(i),i.onclick=()=>{B(i),D=e,de(e)},i}let V=()=>void z(j,``),H=(e,t)=>[...e?[r(`span`,`flex-none font-mono text-[10.5px] font-semibold text-emerald-600`,`+${e}`)]:[],...t?[r(`span`,`flex-none font-mono text-[10.5px] font-semibold text-red-600`,`−${t}`)]:[]];function U(e,n,i){let a=x.get(e),o=r(`div`,`sticky top-0 z-10 flex items-center gap-2 border-b border-neutral-200 bg-white px-4 py-1.5 font-mono text-[11.5px] text-neutral-500`,r(`span`,`truncate`,e));a&&(o.append(r(`span`,`flex-none font-semibold ${v[a.status]??``}`,a.status)),o.append(...H(a.add,a.del)));let s=r(`div`,`ml-auto flex flex-none items-center gap-2`);if(i&&s.append(i),n){let n=document.createElement(`a`);n.className=`flex-none text-neutral-400 hover:text-indigo-700 hover:underline`,n.href=F(`file`,{path:e}),n.download=t(e),n.textContent=`Download`,s.append(n)}return o.append(s),o}function ue(e){let t=0;for(;t<e.length;){if(e[t].tone!==`del`){t++;continue}let n=t;for(;t<e.length&&e[t].tone===`del`;)t++;let r=t;for(;t<e.length&&e[t].tone===`add`;)t++;let i=Math.min(r-n,t-r);for(let t=0;t<i;t++){let i=e[n+t],a=e[r+t],o=Math.min(i.text.length,a.text.length),s=0;for(;s<o&&i.text[s]===a.text[s];)s++;let c=0;for(;c<o-s&&i.text[i.text.length-1-c]===a.text[a.text.length-1-c];)c++;s+c!==0&&(i.mark=[s,i.text.length-c],a.mark=[s,a.text.length-c])}}}let W=ve();function G(){N.classList.add(`hidden`),N.replaceChildren(),W.set([],[])}let K=0,q=e=>e===K;function de(e){let t=++K;return x.has(e)?ye(e,t):fe(e,t)}async function fe(e,t){if(!q(t))return;G();let n=F(`file`,{path:e}),i=r(`div`,`min-w-0`);if(M.classList.remove(`flex`,`flex-col`),M.replaceChildren(U(e,!0),i),ne.test(e)){let e=r(`img`,`max-w-full p-4`);e.src=n,e.onerror=()=>i.replaceChildren(I(`Could not load image.`,`text-red-600`)),i.append(e);return}if(e.toLowerCase().endsWith(`.pdf`)){let t=document.createElement(`iframe`);t.className=`h-full w-full`,t.src=n,M.replaceChildren(U(e,!0),t),M.classList.add(`flex`,`flex-col`);return}i.append(I(`…`));let a=await fetch(n);if(!q(t))return;if(!a.ok){let{error:e}=await a.json().catch(()=>({}));i.replaceChildren(I(e??`HTTP ${a.status}`,`text-red-600`));return}if(!(a.headers.get(`content-type`)??``).startsWith(`text/plain`)){i.replaceChildren(I(`Binary file — use Download.`));return}let c=o(await a.text());if(!q(t))return;let l=await s(e);q(t)&&i.replaceChildren(d(c,l))}function pe(e){let t=[],n=0,r=0,i=!1,a=e.split(`
-`);a.at(-1)===``&&a.pop();for(let e of a){let a=/^@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/.exec(e);if(a){i&&t.push({nums:[``,``],text:`⋯`,tone:``}),[n,r]=[Number(a[1]),Number(a[2])],i=!0;continue}!i||e.startsWith(`\\`)||(e.startsWith(`+`)?t.push({nums:[``,r++],text:e.slice(1),tone:`add`}):e.startsWith(`-`)?t.push({nums:[n++,``],text:e.slice(1),tone:`del`}):t.push({nums:[n++,r++],text:e.slice(1),tone:``}))}return t}function me(e){let t=[];for(let n=0;n<e.length;n++){let r=e[n].tone;if(!r)continue;let i=t.at(-1);i&&i.end===n-1?(i.end=n,(r===`add`&&i.tone===`del`||r===`del`&&i.tone===`add`)&&(i.tone=`mixed`)):t.push({start:n,end:n,tone:r})}return t}let he={add:`bg-emerald-400`,del:`bg-red-400`,mixed:`bg-amber-400`};function ge(e,t,n){N.replaceChildren(...e.map(e=>{let i=r(`button`,`pointer-events-auto absolute w-full cursor-pointer ${he[e.tone]}`);return i.style.top=`${e.start/t*100}%`,i.style.height=`${Math.max(.4,(e.end-e.start+1)/t*100)}%`,i.title=`line ${_e(n,e.start)}`,i.onclick=()=>n[e.start].scrollIntoView({block:`center`}),i})),N.classList.remove(`hidden`)}let _e=(e,t)=>e[t]?.querySelector(`span`)?.textContent?.trim()||String(t+1);function ve(){let e=[],t=[],n=-1,i=r(`span`,`flex-none text-[10.5px] text-neutral-400`),o=r=>{e.length&&(n=(n+r+e.length)%e.length,t[e[n].start].scrollIntoView({block:`center`}),i.textContent=`${n+1}/${e.length}`)},s=()=>e.length>0&&!a.classList.contains(`hidden`),c=(e,t,n,i)=>{let a=r(`button`,`icon-btn flex-none`,e);return a.onclick=()=>o(t),u(a,i,n,()=>o(t),s),a};return{el:r(`div`,`flex flex-none items-center gap-1`,i,c(`↑`,-1,`Previous change`,[`p`,`k`]),c(`↓`,1,`Next change`,[`n`,`j`])),set(r,a){e=r,t=a,n=-1,i.textContent=`${r.length} change${r.length===1?``:`s`}`}}}async function ye(e,t){G(),M.classList.remove(`flex`,`flex-col`);let n=x.get(e)?.status!==`D`;M.replaceChildren(U(e,n),I(`…`));try{let{diff:r}=await i(P(`diff`,{base:y,head:b,file:e,context:`99999`}),`could not read this diff`);if(!q(t))return;if(!r||/^Binary files /m.test(r))return fe(e,t);let a=pe(r);ue(a);let o=await s(e);if(!q(t))return;let c=d(a,o),l=[...c.children],u=me(a);W.set(u,l),M.replaceChildren(U(e,n,W.el),c),ge(u,a.length,l)}catch(n){q(t)&&M.replaceChildren(U(e,!1),I(String(n),`text-red-600`))}}let J=()=>b&&y===`${b}~1`?b:``,be=()=>_.commits.find(e=>e.hash===J())?.subject??``,xe=()=>J()?`${J()} — ${be()||`commit`}`:`${y} ↔ ${b||`working tree`}`,Se=(e,t,n,i)=>{let a=r(`button`,`flex h-6 w-6 flex-none cursor-pointer items-center justify-center rounded-md ${n?`bg-indigo-50 text-indigo-700`:`text-neutral-400 hover:bg-neutral-100 hover:text-neutral-700`}`);return a.innerHTML=e,a.title=t,a.onclick=i,a};function Y(){let e=Se(`<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" class="h-3.5 w-3.5"><path d="M2.5 3h11l-4.25 5v4.5l-2.5 1.25V8L2.5 3z" stroke-linejoin="round"/></svg>`,`Show only files that differ`,C,()=>{C=!C,Y(),V()}),t=Se(`<svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" class="h-3.5 w-3.5"><path d="m4.5 2.5 3.5 3 3.5-3M4.5 13.5l3.5-3 3.5 3" stroke-linecap="round" stroke-linejoin="round"/></svg>`,w?`Restore folders`:`Collapse all folders`,w,()=>{if(w=!w,w)T=[...E],E.clear();else for(let e of T)E.add(e);Y(),V()});if(!_.branch){A.replaceChildren(r(`div`,`flex items-center justify-end gap-1 p-1.5`,t));return}let n=ae(xe());if(J()){let e=_.commits.find(e=>e.hash===J());ee(n,()=>e?m(e):``)}else n.title=`Choose what to diff`;n.onclick=async()=>{await Te(),te(n,_,{base:y,head:b},(e,t)=>{y=e,b=t,Z()},$())};let[i,a]=[0,0];for(let e of x.values())i+=e.add,a+=e.del;A.replaceChildren(r(`div`,`flex flex-col gap-1 p-2`,n,r(`div`,`flex items-center gap-1.5 pl-1`,r(`span`,`text-[11px] text-neutral-400`,`${x.size} changed file${x.size===1?``:`s`}`),...H(i,a),r(`span`,`ml-auto`),e,t)))}let Ce=()=>{g&&h&&ie(g,{cwd:h,base:y,head:b})},X=e=>{let t=e.replace(/~\d+$/,``);return!t||t===`HEAD`||_.refs.some(e=>e.name===t)||_.commits.some(e=>e.hash===t)};async function we(){if(x=new Map,!_.branch)return;let{files:e}=await i(P(`diff`,{base:y,head:b}),`could not read what changed`);for(let t of e)x.set(t.path,{status:t.status,add:t.add,del:t.del});if(x.size<=re)for(let e of x.keys()){let t=e.split(`/`);for(let e=1;e<t.length;e++)E.add(t.slice(0,e).join(`/`))}}async function Z(){Ce();try{await we()}catch(e){Y(),j.replaceChildren(I(String(e),`text-red-600`));return}Y(),V(),D&&de(D)}function Q(){let e=ae(h||`Choose a folder…`,`neutral`);e.className+=` max-w-72`,e.title=`Switch folder`,e.onclick=()=>l(e,_.worktrees.map(e=>({path:e.path,...e.branch?{hint:e.branch}:{}})),h||void 0,f);let t=r(`button`,`icon-btn`,`✕`);t.type=`button`,t.title=`Close Files`,t.setAttribute(`aria-label`,`Close Files`),t.onclick=p,t.classList.add(`ml-auto`),k.replaceChildren(e,r(`span`,`truncate font-mono text-[11.5px] text-neutral-400`,_.branch?`⎇ ${_.branch}`:`no git`),t)}async function Te(){if(h)try{_=await i(P(`git`,{}),`could not read this repository`),Q()}catch(e){M.replaceChildren(I(String(e),`text-red-600`))}}let $=()=>_.refs.some(e=>e.name===`main`)?`main`:_.refs.some(e=>e.name===`master`)?`master`:`HEAD`;async function Ee(){if(Q(),D=null,O=null,E.clear(),G(),M.classList.remove(`flex`,`flex-col`),M.replaceChildren(I(`Select a file.`)),!h){A.replaceChildren(),j.replaceChildren(),M.replaceChildren(I(`No folder yet — pick one from the chip above.`));return}try{_=await i(P(`git`,{}),`could not read this repository`)}catch(e){_={branch:null,refs:[],commits:[],worktrees:[]},M.replaceChildren(I(String(e),`text-red-600`))}let e=S(g),t=e&&e.cwd===h&&X(e.base)&&X(e.head)?e:null;y=t?.base??$(),b=t?.head??``,Q(),await Z()}return n(a,e=>{let t=c(),n=t?.id??``,r=e?.startsWith(`/`)?e:(n===g?h:``)||S(n)?.cwd||t?.cwd||``;if(r===h&&n===g&&j.childElementCount){Q(),Te().then(Z);return}g=n,h=r,Ee()},()=>{G(),M.classList.remove(`flex`,`flex-col`),M.replaceChildren(I(`Select a file.`))})}export{C as createExplorerView};