drafted 1.24.2 → 1.24.4

package/mcp/widgets/canvas-overview.html

@@ -1,229 +0,0 @@
-<style>
-  :root {
-    --bg: #fafafa;
-    --card: #fff;
-    --border: #e5e7eb;
-    --muted: #6b7280;
-    --text: #1a1a2e;
-    --accent: #533afd;
-    --accent-light: #ede9fe;
-  }
-  * { box-sizing: border-box; margin: 0; padding: 0; }
-  html, body { height: 100%; }
-  body {
-    font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-    background: var(--bg);
-    color: var(--text);
-    padding: 16px 18px;
-  }
-  .header {
-    display: flex;
-    justify-content: space-between;
-    align-items: baseline;
-    margin-bottom: 14px;
-  }
-  .header .title { font-size: 14px; font-weight: 600; }
-  .header .meta { font-size: 12px; color: var(--muted); }
-  .header a {
-    color: var(--accent);
-    text-decoration: none;
-    font-weight: 500;
-    font-size: 12px;
-    margin-left: 12px;
-  }
-  .header a:hover { text-decoration: underline; }
-
-  .layer {
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-radius: 10px;
-    padding: 12px 14px;
-    margin-bottom: 10px;
-  }
-  .layer h3 {
-    font-size: 12px;
-    font-weight: 600;
-    color: var(--muted);
-    text-transform: uppercase;
-    letter-spacing: 0.04em;
-    margin-bottom: 8px;
-    display: flex;
-    justify-content: space-between;
-  }
-  .layer h3 .count {
-    background: var(--accent-light);
-    color: var(--accent);
-    padding: 1px 8px;
-    border-radius: 999px;
-    font-size: 10px;
-  }
-  .frames {
-    display: flex;
-    flex-wrap: wrap;
-    gap: 6px;
-  }
-  .frame {
-    background: var(--bg);
-    border: 1px solid var(--border);
-    border-radius: 6px;
-    padding: 6px 10px;
-    font-size: 12px;
-    color: var(--text);
-    text-decoration: none;
-    display: inline-flex;
-    align-items: center;
-    gap: 6px;
-    transition: border-color 0.15s, color 0.15s;
-  }
-  .frame:hover {
-    border-color: var(--accent);
-    color: var(--accent);
-  }
-  .frame .lane {
-    color: var(--muted);
-    font-size: 11px;
-  }
-  .empty {
-    text-align: center;
-    color: var(--muted);
-    font-size: 13px;
-    padding: 32px;
-  }
-  .project {
-    background: var(--card);
-    border: 1px solid var(--border);
-    border-radius: 10px;
-    padding: 12px 14px;
-    margin-bottom: 8px;
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    text-decoration: none;
-    color: inherit;
-    transition: border-color 0.15s;
-  }
-  .project:hover { border-color: var(--accent); }
-  .project .name { font-weight: 500; font-size: 14px; }
-  .project .desc { font-size: 12px; color: var(--muted); margin-top: 2px; }
-  .project .badge {
-    font-size: 11px;
-    background: var(--accent-light);
-    color: var(--accent);
-    padding: 2px 8px;
-    border-radius: 999px;
-  }
-</style>
-
-<div class="header">
-  <div>
-    <div class="title" id="title">Loading…</div>
-    <div class="meta" id="subtitle"></div>
-  </div>
-  <a id="open" href="#" target="_blank" rel="noopener" hidden>Open in canvas →</a>
-</div>
-<div id="root"></div>
-
-<script>
-  function escapeHtml(s) {
-    return String(s).replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
-  }
-
-  // Derive the Drafted server origin from payload URLs (frameUrl, canvasUrl) so the
-  // widget deep-links correctly on local installs and hosted servers alike — never
-  // hardcode https://drafted.live (breaks localhost/self-hosted deployments).
-  function serverOrigin(sc) {
-    const candidates = [
-      sc.canvasUrl, sc.serverUrl,
-      ...(Array.isArray(sc.projects) ? sc.projects.map(p => p.canvasUrl).filter(Boolean) : []),
-      ...(Array.isArray(sc.projects) ? sc.projects.map(p => p.frameUrl).filter(Boolean) : []),
-      ...(Array.isArray(sc.entries) ? sc.entries.map(e => e.frameUrl).filter(Boolean) : []),
-    ];
-    for (const u of candidates) {
-      try { return new URL(u).origin; } catch { /* keep looking */ }
-    }
-    return 'https://drafted.live';
-  }
-
-  function renderProjects(projects, activeId, origin) {
-    if (!projects?.length) return '<div class="empty">No projects yet. Use project(action="create") to start one.</div>';
-    return projects.slice(0, 30).map(p => {
-      const isActive = p.id === activeId;
-      const url = p.slug ? `${origin}/project/${escapeHtml(p.slug)}` : '#';
-      return `
-        <a class="project" href="${url}" target="_blank" rel="noopener">
-          <div>
-            <div class="name">${escapeHtml(p.name || p.slug || 'Untitled')}</div>
-            ${p.description ? `<div class="desc">${escapeHtml(p.description)}</div>` : ''}
-          </div>
-          ${isActive ? '<span class="badge">active</span>' : ''}
-        </a>
-      `;
-    }).join('');
-  }
-
-  function renderLayers(byLayer) {
-    if (!byLayer || !Object.keys(byLayer).length) return '<div class="empty">No frames in this view.</div>';
-    return Object.entries(byLayer).map(([layer, frames]) => `
-      <div class="layer">
-        <h3>${escapeHtml(layer)} <span class="count">${frames.length}</span></h3>
-        <div class="frames">
-          ${frames.slice(0, 24).map(f => `
-            <a class="frame" href="${escapeHtml(f.frameUrl || '#')}" target="_blank" rel="noopener">
-              <span>${escapeHtml(f.label || f.filename || f.path || '?')}</span>
-              ${f.lane && f.lane !== 'default' ? `<span class="lane">${escapeHtml(f.lane)}</span>` : ''}
-            </a>
-          `).join('')}
-        </div>
-      </div>
-    `).join('');
-  }
-
-  function render(payload) {
-    const sc = payload?.structuredContent || {};
-    const root = document.getElementById('root');
-
-    // project(action="list") shape
-    if (Array.isArray(sc.projects)) {
-      document.getElementById('title').textContent = `${sc.projects.length} project${sc.projects.length === 1 ? '' : 's'}`;
-      document.getElementById('subtitle').textContent = sc.activeProject ? 'One active' : 'None active — use project(action="open") to switch';
-      root.innerHTML = renderProjects(sc.projects, sc.activeProject, serverOrigin(sc));
-      return;
-    }
-
-    // ls shape
-    if (sc.byLayer || sc.entries) {
-      const byLayer = sc.byLayer || groupByLayer(sc.entries || []);
-      const total = Object.values(byLayer).reduce((sum, arr) => sum + arr.length, 0);
-      document.getElementById('title').textContent = sc.project || 'Project canvas';
-      document.getElementById('subtitle').textContent = `${total} frame${total === 1 ? '' : 's'} · ${Object.keys(byLayer).length} layer${Object.keys(byLayer).length === 1 ? '' : 's'}`;
-      if (sc.canvasUrl) {
-        const link = document.getElementById('open');
-        link.href = sc.canvasUrl;
-        link.hidden = false;
-      }
-      root.innerHTML = renderLayers(byLayer);
-      return;
-    }
-
-    root.innerHTML = '<div class="empty">No data to display.</div>';
-  }
-
-  function groupByLayer(entries) {
-    const out = {};
-    for (const e of entries) {
-      const layer = e.layer || 'unsorted';
-      (out[layer] ??= []).push(e);
-    }
-    return out;
-  }
-
-  window.addEventListener('message', (event) => {
-    const msg = event.data;
-    if (!msg || typeof msg !== 'object') return;
-    if (msg.method === 'ui/notifications/tool-result' && msg.params?.result) {
-      render(msg.params.result);
-    }
-  });
-
-  if (window.openai?.toolResult) render(window.openai.toolResult);
-</script>

package/mcp/widgets/frame-preview.html

@@ -1,162 +0,0 @@
-<style>
-  :root {
-    --bg: #fafafa;
-    --card: #fff;
-    --border: #e5e7eb;
-    --muted: #6b7280;
-    --text: #1a1a2e;
-    --accent: #533afd;
-  }
-  * { box-sizing: border-box; margin: 0; padding: 0; }
-  html, body { height: 100%; }
-  body {
-    font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-    background: var(--bg);
-    color: var(--text);
-    display: flex;
-    flex-direction: column;
-  }
-  .header {
-    display: flex;
-    justify-content: space-between;
-    align-items: center;
-    padding: 10px 14px;
-    border-bottom: 1px solid var(--border);
-    background: var(--card);
-    font-size: 13px;
-  }
-  .header .path {
-    font-family: 'SF Mono', 'Menlo', monospace;
-    color: var(--muted);
-    font-size: 12px;
-  }
-  .header .meta {
-    color: var(--muted);
-    font-size: 11px;
-  }
-  .header a {
-    color: var(--accent);
-    text-decoration: none;
-    font-weight: 500;
-    margin-left: 12px;
-  }
-  .header a:hover { text-decoration: underline; }
-  .stage {
-    flex: 1;
-    overflow: auto;
-    background: var(--card);
-  }
-  iframe {
-    width: 100%;
-    min-height: 480px;
-    border: 0;
-    display: block;
-  }
-  img.preview {
-    max-width: 100%;
-    height: auto;
-    display: block;
-    margin: 0 auto;
-  }
-  .empty {
-    padding: 40px;
-    text-align: center;
-    color: var(--muted);
-    font-size: 13px;
-  }
-  .markdown-body {
-    padding: 24px 32px;
-    max-width: 760px;
-    margin: 0 auto;
-    line-height: 1.6;
-  }
-  .markdown-body pre {
-    background: #f3f4f6;
-    padding: 12px 16px;
-    border-radius: 6px;
-    overflow-x: auto;
-    font-size: 13px;
-  }
-</style>
-
-<div class="header">
-  <span class="path" id="path">Loading frame…</span>
-  <span>
-    <span class="meta" id="meta"></span>
-    <a id="open" href="#" target="_blank" rel="noopener" hidden>Open in canvas →</a>
-  </span>
-</div>
-<div class="stage" id="stage">
-  <div class="empty">Waiting for frame data…</div>
-</div>
-
-<script>
-  function escapeHtml(s) {
-    return String(s).replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
-  }
-
-  function render(payload) {
-    const sc = payload?.structuredContent || {};
-    const meta = payload?._meta || {};
-    const path = sc.path || sc.frameId || sc.id || 'Frame';
-    const sizeBits = [];
-    if (sc.width && sc.height) sizeBits.push(`${sc.width}×${sc.height}`);
-    if (sc.contentType) sizeBits.push(sc.contentType.split('/').pop());
-    if (sc.layer) sizeBits.push(sc.layer);
-
-    document.getElementById('path').textContent = path;
-    document.getElementById('meta').textContent = sizeBits.join(' · ');
-    const openLink = document.getElementById('open');
-    if (sc.frameUrl) {
-      openLink.href = sc.frameUrl;
-      openLink.hidden = false;
-    }
-
-    const stage = document.getElementById('stage');
-    stage.innerHTML = '';
-
-    // Image (PNG screenshot, asset)
-    if (sc.imageUrl || meta.imageUrl) {
-      const img = document.createElement('img');
-      img.className = 'preview';
-      img.src = sc.imageUrl || meta.imageUrl;
-      img.alt = path;
-      stage.appendChild(img);
-      return;
-    }
-
-    // HTML frame — render in sandboxed srcdoc iframe
-    const html = meta.frameHtml || sc.content;
-    const ctype = (sc.contentType || '').toLowerCase();
-    if (html) {
-      if (ctype.includes('markdown') || path.toLowerCase().endsWith('.md')) {
-        // Render markdown as preformatted text — keeps it readable without a parser dep
-        const div = document.createElement('div');
-        div.className = 'markdown-body';
-        div.innerHTML = '<pre>' + escapeHtml(html) + '</pre>';
-        stage.appendChild(div);
-      } else {
-        const iframe = document.createElement('iframe');
-        iframe.setAttribute('sandbox', 'allow-same-origin');
-        iframe.srcdoc = html;
-        if (sc.height && Number(sc.height) > 480) iframe.style.minHeight = sc.height + 'px';
-        stage.appendChild(iframe);
-      }
-      return;
-    }
-
-    stage.innerHTML = '<div class="empty">No content to preview. The tool result did not include frame HTML.</div>';
-  }
-
-  // MCP Apps bridge: listen for ui/notifications/tool-result
-  window.addEventListener('message', (event) => {
-    const msg = event.data;
-    if (!msg || typeof msg !== 'object') return;
-    if (msg.method === 'ui/notifications/tool-result' && msg.params?.result) {
-      render(msg.params.result);
-    }
-  });
-
-  // Some hosts send the initial payload synchronously — try reading it now too
-  if (window.openai?.toolResult) render(window.openai.toolResult);
-</script>

package/plugin/commands/create-project.md

@@ -1,20 +0,0 @@
----
-description: Start a new project — or a reusable template — with proper search of knowledge and skills first
-argument-hint: <project name and what you want to do>
----
-
-Spin up a project on the surface, or generalize one into a reusable template. Goal: $ARGUMENTS
-
-First ask: **a new project, or a reusable template?** (This command does both.)
-
-Search before creating (also satisfies the gates):
-1. `fs(search, path="/o/<org>/wiki", query="<terms>")` for relevant knowledge. [G1]
-2. `fs(search, path="/o/<org>/skills", query="<topic>")` for procedures that should be attached. [G2/G3]
-
-Then:
-- Create the project — a project is a folder: `fs(mkdir, path="/o/<org>/projects/<name>")`. It starts with **no layers**; you define them by writing into them.
-- `fs(write, path="/o/<org>/projects/<name>/<layer>/<lane>/brief.md", content=...)` a real brief at the earliest layer (goal, audience, constraints — 6-12 lines, not a placeholder). The layer + lane auto-create.
-- Attach the relevant skills you found; anchor any that agents must read before they write.
-- `fs(ls, path="/o/<org>/projects/<name>")` to confirm the structure, and hand the user the `projectUrl` from the response.
-
-For a **template**: build the layer structure + anchored guidance, then note how to fork it next time. Don't speculatively fill downstream frames — wait for direction.

package/plugin/commands/create-skill.md

@@ -1,18 +0,0 @@
----
-description: Capture a repeatable procedure as an org skill — with proper knowledge and prior-art search
-argument-hint: <what the procedure is for>
----
-
-Turn a repeatable way of working into a Drafted skill so every future agent in the org follows it. Procedure: $ARGUMENTS
-
-Do the searches first (they also satisfy the gates):
-1. `fs(search, path="/o/<org>/wiki", query="<terms>")` for relevant org knowledge the procedure should reference. [G1]
-2. `fs(search, path="/o/<org>/skills", query="<topic>")` for prior art — an existing skill to improve instead of duplicating. [G2 — also enforced on writing a new skill.] If a close match exists, prefer `/drafted:improve-skill`.
-
-Then define a PROPER procedure, not a vague note:
-- a clear trigger ("when to use this"),
-- ordered, concrete steps,
-- success criteria / what "done right" looks like,
-- written in the second person so any agent can follow it directly. Keep it sharp (~40 lines).
-
-Show the draft to the user with a proposed `name` (Title Case), one-line `description`, `tags` (3-5), and `triggerPatterns`. After approval, write it with `fs(write, path="/o/<org>/skills/<slug>", content=...)` — the slug is derived from the name. Confirm with the slug and note it will auto-surface on matching tasks.

package/plugin/commands/extract.md

@@ -1,16 +0,0 @@
----
-description: Deposit what this session produced into the harness — knowledge, a skill, and/or a template
-argument-hint: <optional: what to capture>
----
-
-Session-end deposit. Harvest what's durable from this conversation back into the harness so the next session starts smarter. Focus: $ARGUMENTS
-
-Review the session, then **present the user options for which store(s) to deposit into** — don't auto-decide. Offer any that apply:
-
-- **Knowledge → wiki** — durable facts, decisions, or findings worth keeping. Search first (`fs(search, path="/o/<org>/wiki", ...)`) to avoid fragmenting, then `fs(write, path="/o/<org>/wiki/<path>", ...)`.
-- **Procedure → skill** — a repeatable way of working that emerged. Follow `/drafted:create-skill`.
-- **Template → surface** — a reusable project structure that emerged. Build it as a project via `fs(mkdir, ...)` + frames.
-
-Show the user the candidate deposits per store, let them pick which to keep, then write the chosen ones with their approval. Confirm what landed where.
-
-One command, all three stores — because at session end the human shouldn't have to remember which store is which.

package/plugin/commands/improve-project-harness.md

@@ -1,16 +0,0 @@
----
-description: Turn corrections you made in a project into enforced gates (anchors, attached skills, layer rules)
-argument-hint: <optional: the correction to enforce>
----
-
-When the user had to correct the work in this project, codify the correction so future work is compelled to comply. This is the nurture → enforce bridge. Correction: $ARGUMENTS
-
-1. Identify the recurring correction(s) or standing rule from this session.
-2. Choose the right Drafted-side gate per correction (each counts toward the project's context budget):
-   - **Project anchor** — a brief, constraint, or style guide that must be in context project-wide: `fs(write, path="/o/<org>/projects/<project>/<layer>/<lane>/<file>", content=...)` it, then anchor it so it is listed as suggested reading (not enforced). [G5]
-   - **Attached skill** — a procedure that must be loaded before work: `/drafted:create-skill` (or `fs(search, path="/o/<org>/skills", ...)` for an existing one), then ask the user to anchor it to the project (Skills view > Anchoring, effect Enforce; an agent cannot do this itself, and attaching a skill alone does not gate). Writes in that scope are then refused until the skill is read. [G4]
-   - **Layer rule** — a standing instruction for one stage: set that layer's rules (an AGENTS.md in the layer) so they are surfaced when work happens there. [G6]
-3. Propose which mechanism for each correction, confirm with the user, then apply.
-4. Confirm what is now enforced — only an anchored skill gates writes; a project anchor and a layer rule do not.
-
-Keep within the project's context budget — if a deposit would exceed it, tighten existing gates instead of piling on.

package/plugin/commands/improve-skill.md

@@ -1,14 +0,0 @@
----
-description: Fix a skill you noticed is inefficient, wrong, or missing a step
-argument-hint: <which skill, and what's off>
----
-
-Improve an existing org skill when it underperformed in practice. Skill / issue: $ARGUMENTS
-
-1. `fs(search, path="/o/<org>/skills", query="<slug>")` then `fs(read, path="/o/<org>/skills/<slug>")` the skill in question — read it fully.
-2. Pinpoint the inefficiency: a missing step, a wrong instruction, an ambiguous trigger, or a step that wastes effort.
-3. Propose the specific edit to the user — show before/after of the changed steps.
-4. After approval, `fs(write, path="/o/<org>/skills/<slug>", content=<updated>)` — writing an existing skill updates it (the version bumps automatically). If it was archived, writing restores it.
-5. Confirm what changed so the next agent benefits.
-
-Skills are the org's stable processes — every fix compounds across everyone who uses them.

package/plugin/commands/improve-wiki.md

@@ -1,14 +0,0 @@
----
-description: Fix the wiki — reconcile stale, wrong, fragmented, or contradictory knowledge
-argument-hint: <what's wrong, or the topic to clean up>
----
-
-Improve the org wiki when knowledge has drifted. Issue/topic: $ARGUMENTS
-
-1. `fs(search, path="/o/<org>/wiki", query="<terms>")` (3-5 paraphrased queries) and `fs(read, path="/o/<org>/wiki/<path>")` the affected pages — don't trust titles, open them.
-2. Diagnose: duplicate pages, a stale fact, a contradiction, or knowledge fragmented across pages.
-3. Propose the fix to the user: consolidate duplicates, correct the fact, reconcile the contradiction, or re-link fragments.
-4. Apply with `fs(write, path="/o/<org>/wiki/<path>", content=<updated>)` (hashline `edit` for surgical changes) or `fs(mv, path="/o/<org>/wiki/<from>", to="/o/<org>/wiki/<to>")` (which rewrites inbound links). Check what links to a page before moving or archiving it.
-5. Never hard-delete — `fs(rm, path="/o/<org>/wiki/<path>")` moves a page to the archive folder.
-
-Leave the wiki more coherent than you found it — fewer, sharper, better-linked pages.

package/plugin/commands/ingest.md

@@ -1,20 +0,0 @@
----
-description: Bring knowledge into the wiki — from a research output, existing documents, or by interrogating you
-argument-hint: <optional: what to ingest, or a source>
----
-
-Feed durable knowledge into the org wiki. Source/intent: $ARGUMENTS
-
-First decide WHAT to ingest. If it's obvious from the conversation (a research run just finished, or the user named a source), use that. Otherwise ask which of these three modes fits:
-
-1. **A research producible** — the output of a research run (a provider-native `/deep-research` or similar). Structure it into wiki pages.
-2. **Existing documents** — the user points at local / remote / connected folders. Scour them (spawn sub-agents if there are many) for relevant material, shortlist, confirm, then ingest the right ones. Folder scour needs file access (desktop / Cowork); on web, use connected sources.
-3. **Interrogate the user** (grill-me) — when the knowledge is in their head. Interview relentlessly, walking ONE branch of the decision tree at a time and proposing your recommended answer at each step, until you reach shared understanding. Then structure what you captured.
-
-Then deposit:
-- `fs(search, path="/o/<org>/wiki", query="<terms>")` first (3-5 paraphrased queries) so you don't fragment existing pages.
-- Propose the page set to the user before writing.
-- Write with `fs(write, path="/o/<org>/wiki/<path>", content=...)` per page. Cross-link related pages.
-- Confirm what landed where, with the page links.
-
-The wiki is the org's durable knowledge — write for the next agent and teammate, not just this session.

package/plugin/commands/onboard-drafted.md

@@ -1,18 +0,0 @@
----
-description: First-run setup — orient to Drafted and bootstrap the harness (wiki, skills, first project)
-argument-hint: <optional: what you want to start working on>
----
-
-Onboard the user to Drafted — a producibles harness that compounds across three primitives: knowledge (the wiki), procedures (skills), and the project surface. Goal/context: $ARGUMENTS
-
-This is the over-arching prime command: orient, then seed all three stores so every later session starts smart.
-
-1. **Orient** — in 3-4 lines explain the loop: you *prime* from the harness (the system makes you search the wiki, and refuses a write until you have read the skills anchored to where you are working), you *build*, then you *compound* (deposit what you learned). The more it's used, the less searching and the more stable the work. Drafted is navigated like a filesystem — one `fs` tool, three roots: `/wiki`, `/skills`, `/projects`.
-2. **Name the org** — the org is an address, not a cursor: address wiki/skills with `org=...` on the call, and projects self-derive their org from the path. Never rely on an "active" org: a project-less create by a multi-org user is refused rather than guessed.
-3. **Find the work (ask first).** Make your first question permission, offering three scopes, narrowest first: (a) "tell me what you're working on this week" (nothing is read), (b) one folder they point you to, (c) recent files plus their inbox, Drive and calendar. Option (c) needs `gws` signed in; check it as the `drafted` skill's *Source material from Google* section describes, and if it isn't, offer `! drafted google-setup`. Say plainly what stays on their machine (everything you read) and what reaches Drafted (only what they pick). Read headers before bodies. Then write one frame, **Your work, mapped**: the 3-7 strongest candidates for a Drafted project, each with why it fits (many artifacts, several people, a recurring process, a decision to make), its source links, and the project it would become. Let the user pick.
-4. **Seed knowledge** — run the `/drafted:ingest` flow: help the user point at existing business materials (folders, docs, past research, the sources behind the candidate they picked) or interrogate them for tacit knowledge, and land durable pages in the wiki.
-5. **Seed procedures** — from those materials and the conversation, surface 1-3 candidate SOPs. For the most valuable, run the `/drafted:create-skill` flow.
-6. **Seed the surface** — run the `/drafted:create-project` flow for the candidate the user picked, or their immediate piece of work (or a reusable template).
-7. Close by showing what now exists (wiki pages, skills, project) and restate the one-line loop: prime → build → compound.
-
-Keep it guided and conversational — one step at a time, confirming before each deposit. Don't dump everything at once.