pi-declaw 0.2.0

package/playground/assets/licenses/paseo-plain-LICENSE

@@ -0,0 +1,211 @@
+Copyright (c) 2025-present Mohamed Boudra
+
+Portions of this software are licensed as follows:
+
+* Third-party components incorporated into Paseo remain licensed under
+  the licenses provided by their respective copyright holders.
+* Except for those third-party components, Paseo is licensed under the
+  Apache License, Version 2.0, reproduced below.
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/playground/assets/licenses/squirrel-mode-LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thiago Matajs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/playground/build.ts

@@ -0,0 +1,180 @@
+import { readFile, mkdir, writeFile, copyFile, cp, rm } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { renderComparison } from "./markdown.ts";
+import { renderUnifiedDiff } from "./unified.ts";
+import { STYLE_IDS } from "../src/domain/styles.ts";
+
+export const DEFAULT_CASE_ID = "verbose-explanation";
+
+export interface Source {
+  label: string; url?: string; relationship: "Inspired by" | "Adapted from" | "Local preset";
+}
+export interface Recording {
+  runId: string; recordedAt: string; model: string; promptVersion: string;
+  context: "answer"; promptSource: "paseo-plain-v5" | "plain-lab-2" | "package-v4";
+  systemHash?: string;
+}
+export type Attribution = Omit<Source, "relationship"> & { relationship: Source["relationship"] | "Prompt from" };
+export interface Snapshot {
+  version: 1 | 2; recordedAt: string; runId: string; model: string; thinking: "low";
+  promptVersion: string; synthetic: true;
+  modes: { id: string; label: string; description: string; source: Source }[];
+  cases: {
+    id: string; label: string; title: string; sourceTitle: string; request: string;
+    original: string; mustKeep: string[]; reviewFacts: string[]; pitfalls: string[];
+    variants: { mode: string; text: string; recording?: Recording }[];
+  }[];
+}
+const sourceDir = dirname(fileURLToPath(import.meta.url));
+const CASES = ["local-vs-prod", "verbose-explanation", "ordered-recovery", "comparison-table"];
+const LEGACY_MODES = STYLE_IDS.filter(id => id !== "slye");
+export const escapeHtml = (s: string) => s.replace(/[&<>"']/g, c => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]!);
+export const countWords = (text: string) => text.trim() ? text.trim().split(/\s+/u).length : 0;
+export function scriptJson(value: unknown): string {
+  return JSON.stringify(value).replace(/[<>&\u2028\u2029]/g, c => `\\u${c.charCodeAt(0).toString(16).padStart(4, "0")}`);
+}
+function assertText(value: unknown, name: string): asserts value is string {
+  if (typeof value !== "string" || !value.trim() || value.length > 32_000) throw new Error(`Invalid ${name}: expected nonempty text, at most 32,000 characters`);
+}
+export function validateSnapshot(value: unknown): asserts value is Snapshot {
+  if (!value || typeof value !== "object") throw new Error("Invalid snapshot");
+  const s = value as Snapshot;
+  if (![1, 2].includes(s.version) || s.synthetic !== true || s.thinking !== "low") throw new Error("Expected a synthetic snapshot with low thinking");
+  const modes = s.version === 2 ? STYLE_IDS : LEGACY_MODES;
+  for (const key of ["recordedAt", "runId", "model", "promptVersion"] as const) assertText(s[key], key);
+  if (!Number.isFinite(Date.parse(s.recordedAt))) throw new Error("Invalid recording date");
+  if (!Array.isArray(s.modes) || JSON.stringify(s.modes.map(m => m.id)) !== JSON.stringify(modes)) throw new Error("Expected the packaged styles in order");
+  for (const mode of s.modes) {
+    assertText(mode.label, "mode label"); assertText(mode.description, "mode description");
+    const source = mode.source;
+    if (!source || !["Inspired by", "Adapted from", "Local preset"].includes(source.relationship)) throw new Error("Invalid source relationship");
+    assertText(source.label, "source label");
+    if (source.url !== undefined) {
+      assertText(source.url, "source URL");
+      const url = new URL(source.url);
+      if (url.protocol !== "https:" || url.hostname !== "github.com" || url.username || url.password || url.port) throw new Error("Expected HTTPS github.com source URL without credentials");
+    }
+    if (mode.id === "terse" && (source.relationship !== "Local preset" || source.url !== undefined)) throw new Error("Terse must be a local preset without a URL");
+  }
+  if (!Array.isArray(s.cases) || JSON.stringify(s.cases.map(c => c.id)) !== JSON.stringify(CASES)) throw new Error("Expected the four curated cases in order");
+  for (const c of s.cases) {
+    for (const key of ["label", "title", "sourceTitle", "request", "original"] as const) assertText(c[key], key);
+    for (const key of ["mustKeep", "reviewFacts", "pitfalls"] as const) {
+      if (!Array.isArray(c[key])) throw new Error(`Invalid ${key}`);
+      c[key].forEach(t => assertText(t, key));
+    }
+    if (!Array.isArray(c.variants) || JSON.stringify(c.variants.map(v => v.mode)) !== JSON.stringify(modes)) throw new Error(`Incomplete variants: ${c.id}`);
+    c.variants.forEach(v => {
+      assertText(v.text, "saved rewrite");
+      if (s.version === 2 && (v.recording?.promptSource !== "package-v4" || !/^[a-f0-9]{64}$/.test(v.recording.systemHash ?? ""))) throw new Error("Current demos require packaged-engine recordings and prompt hashes for every style");
+      if (v.recording !== undefined) {
+        const r = v.recording;
+        if (!r || r.context !== "answer" || !["paseo-plain-v5", "plain-lab-2", "package-v4"].includes(r.promptSource) ||
+            (r.promptSource !== "package-v4" && v.mode !== "plain")) throw new Error("Expected a recognized package recording");
+        for (const key of ["recordedAt", "runId", "model", "promptVersion"] as const) assertText(r[key], `recording ${key}`);
+        if (!Number.isFinite(Date.parse(r.recordedAt))) throw new Error("Invalid variant recording date");
+      }
+    });
+  }
+}
+export function renderAttribution(source: Attribution): string {
+  if (source.relationship === "Local preset") return "Local preset";
+  return `${escapeHtml(source.relationship)} ${source.url ? `<a href="${escapeHtml(source.url)}">${escapeHtml(source.label)}</a>` : escapeHtml(source.label)}`;
+}
+export function compileSnapshot(snapshot: Snapshot) {
+  validateSnapshot(snapshot);
+  return {
+    version: snapshot.version, recordedAt: snapshot.recordedAt, runId: snapshot.runId,
+    defaultCaseId: DEFAULT_CASE_ID,
+    model: snapshot.model, promptVersion: snapshot.promptVersion, thinking: snapshot.thinking, synthetic: true,
+    modes: snapshot.modes,
+    cases: snapshot.cases.map(c => ({
+      id: c.id, label: c.label, title: c.title, request: c.request, original: c.original,
+      originalWords: countWords(c.original),
+      variants: c.variants.map(v => {
+        const comparison = renderComparison(c.original, v.text);
+        const source = snapshot.modes.find(m => m.id === v.mode)!.source;
+        const attribution: Attribution = v.recording?.promptSource === "paseo-plain-v5"
+          ? { label: "scowalt/paseo-plain", url: "https://github.com/scowalt/paseo-plain", relationship: "Prompt from" }
+          : { ...source, ...(v.mode === "plain" && v.recording?.promptSource !== "package-v4" ? { relationship: "Inspired by" as const } : {}) };
+        return {
+          mode: v.mode, text: v.text, words: countWords(v.text),
+          ...(v.recording ? { recording: { ...v.recording } } : {}),
+          attribution, attributionHtml: renderAttribution(attribution),
+          ...comparison,
+          ...renderUnifiedDiff(comparison.beforeHtml, comparison.afterHtml),
+          missingExactText: c.mustKeep.filter(text => !v.text.includes(text)),
+        };
+      }),
+    })),
+  };
+}
+export function renderEvidence(snapshot: Snapshot, compiled = compileSnapshot(snapshot)): string {
+  const esc = escapeHtml;
+  const sections = snapshot.cases.map((c, i) => {
+    const compiledCase = compiled.cases[i];
+    return `<section id="${esc(c.id)}"><h2>${esc(c.label)}</h2><p>${esc(c.sourceTitle)}</p>
+      <details><summary>Request, review facts, and known pitfalls</summary><h3>Request</h3><p>${esc(c.request)}</p><h3>Review facts</h3><ul>${c.reviewFacts.map(f => `<li>${esc(f)}</li>`).join("")}</ul><h3>Watch for</h3><ul>${c.pitfalls.map(f => `<li>${esc(f)}</li>`).join("")}</ul></details>
+      ${compiledCase.variants.map(v => `<details class="evidence-variant"><summary>${esc(snapshot.modes.find(m => m.id === v.mode)!.label)} <span>${compiledCase.originalWords} → ${v.words} words</span></summary>
+        <p class="source-attribution">${v.attributionHtml}</p>
+        <p>${esc((v.recording ?? snapshot).model)} · ${esc((v.recording ?? snapshot).recordedAt)} · ${esc((v.recording ?? snapshot).promptVersion)} · Run: ${esc((v.recording ?? snapshot).runId)}${v.recording ? ` · Context: ${esc(v.recording.context)} · Prompt source: ${esc(v.recording.promptSource)}` : " · Legacy snapshot recording"}</p>
+        <p class="check-note">${v.missingExactText.length ? `Missing exact strings: ${v.missingExactText.map(esc).join(", ")}` : "Required exact strings present. This is not a semantic-fidelity verdict."} ${v.changed ? "" : "Output is identical to the original."}</p>
+        <div class="evidence-pair"><div><h3>Original</h3><div class="prose">${v.beforeHtml}</div></div><div><h3>${esc(snapshot.modes.find(m => m.id === v.mode)!.label)}</h3><div class="prose">${v.afterHtml}</div></div></div></details>`).join("")}</section>`;
+  }).join("\n");
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'self'; font-src 'self'; base-uri 'none'; form-action 'none'"><title>Declaw — recorded evidence</title><link rel="stylesheet" href="styles.css"><link rel="stylesheet" href="evidence.css"></head><body class="evidence-page" data-inspecting="true"><main><a class="back-link" href="index.html">← Back to playground</a><h1>Recorded evidence.</h1><p>Four synthetic inputs. ${snapshot.cases.reduce((total, c) => total + c.variants.length, 0)} saved model outputs, preserved verbatim. This static view keeps the review facts next to the comparisons; the private lab remains separate.</p><p>Recording details are listed per output. Older outputs use the snapshot’s original recording details.</p><p>Strike-through marks source deletions; underlines mark rewrite additions. Moves can appear on both sides. Formatting-only edits may not be marked. Exact strings and word counts cannot establish equivalent meaning.</p><p><a href="samples.json" download>Download the source snapshot</a></p><nav aria-label="Evidence examples">${snapshot.cases.map(c => `<a href="#${esc(c.id)}">${esc(c.label)}</a>`).join("")}</nav>${sections}</main></body></html>`;
+}
+export function renderCredits(snapshot: Snapshot, template: string): string {
+  const plain = snapshot.cases.flatMap(c => c.variants.filter(v => v.mode === "plain"));
+  const packaged = snapshot.version === 2 && plain.length > 0 && plain.every(v => v.recording?.promptSource === "package-v4");
+  const legacy = plain.some(v => !v.recording || v.recording.promptSource === "plain-lab-2");
+  const provenance = packaged
+    ? "These recordings use the installed package’s six styles, shared meaning-preservation rules and exact-text protection. Paseo Plain and Speak Like You Eat combine pinned source prompts with those shared rules."
+    : legacy
+      ? "This snapshot includes Plain recordings from an earlier local prompt, not Scott’s exact writing prompt. The historical four-call upstream comparison failed fidelity review and was not promoted. Each output’s attribution identifies its source."
+      : "Plain recordings marked “Prompt from” use the pinned upstream writing prompt. Each output’s recording details identify its source.";
+  const replacements = {
+    "<!-- RECORDING_PROVENANCE -->": `<p>${provenance} See <a href="evidence.html">recorded evidence</a>. Source identity does not guarantee preserved meaning.</p>`,
+    "<!-- SLYE_CREDIT -->": snapshot.modes.some(m => m.id === "slye")
+      ? '<p>Speak Like You Eat uses the stable v1.1.0 prompt from <a href="https://github.com/wtfzambo/speak-like-you-eat">wtfzambo/speak-like-you-eat</a>, with the package’s shared preservation rules. <a href="assets/licenses/speak-like-you-eat-LICENSE">MIT license</a>.</p>' : "",
+  };
+  for (const [marker, text] of Object.entries(replacements)) {
+    if (template.split(marker).length !== 2) throw new Error(`Expected one credits marker: ${marker}`);
+    template = template.replace(marker, () => text);
+  }
+  return template;
+}
+export async function build(outputDir = resolve(sourceDir, "../dist/playground")): Promise<string> {
+  const source = await readFile(resolve(sourceDir, "samples.json"), "utf8");
+  const snapshot: unknown = JSON.parse(source);
+  validateSnapshot(snapshot);
+  const compiled = compileSnapshot(snapshot);
+  const first = compiled.cases.find(c => c.id === DEFAULT_CASE_ID)!, variant = first.variants[0];
+  let html = await readFile(resolve(sourceDir, "index.html"), "utf8");
+  const replacements: Record<string, string> = {
+    "<!-- INITIAL_SOURCE -->": variant.beforeHtml,
+    "<!-- INITIAL_REWRITE -->": variant.afterHtml,
+    "<!-- INITIAL_ATTRIBUTION -->": variant.attributionHtml,
+    "<!-- MODE_BUTTONS -->": snapshot.modes.map((mode, index) => `<button class="rail-button" data-mode="${escapeHtml(mode.id)}" aria-pressed="${index === 0}" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#${({ plain: 'i-document', terse: 'i-prose', adhd: 'i-action', squirrel: 'i-branch', ste: 'i-code', slye: 'i-document' } as Record<string, string>)[mode.id]}"/></svg>${escapeHtml(mode.label)}</button>`).join('\n'),
+  };
+  for (const [marker, text] of Object.entries(replacements)) {
+    if (html.split(marker).length !== 2) throw new Error(`Expected one template marker: ${marker}`);
+    html = html.replace(marker, () => text);
+  }
+  await mkdir(outputDir, { recursive: true });
+  await writeFile(resolve(outputDir, "index.html"), html);
+  await writeFile(resolve(outputDir, "data.js"), `"use strict";\nglobalThis.PLAIN_DEMO = ${scriptJson(compiled)};\n`);
+  await writeFile(resolve(outputDir, "samples.json"), source);
+  await writeFile(resolve(outputDir, "evidence.html"), renderEvidence(snapshot, compiled));
+  await writeFile(resolve(outputDir, ".nojekyll"), "");
+  await writeFile(resolve(outputDir, "credits.html"), renderCredits(snapshot, await readFile(resolve(sourceDir, "credits.html"), "utf8")));
+  for (const file of ["styles.css", "app.js", "evidence.css"]) await copyFile(resolve(sourceDir, file), resolve(outputDir, file));
+  // Remove the retired hold/lock controller from existing build directories too.
+  await rm(resolve(outputDir, "interaction.js"), { force: true });
+  await cp(resolve(sourceDir, "assets"), resolve(outputDir, "assets"), { recursive: true });
+  await copyFile(resolve(sourceDir, "../licenses/speak-like-you-eat-LICENSE"), resolve(outputDir, "assets/licenses/speak-like-you-eat-LICENSE"));
+  return outputDir;
+}
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  build().then(path => console.log(`Static playground: ${path}/index.html`)).catch(error => { console.error(error); process.exitCode = 1; });
+}

package/playground/credits.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'self'; font-src 'self'; base-uri 'none'; form-action 'none'"><title>Credits — Declaw</title><link rel="stylesheet" href="styles.css"><link rel="stylesheet" href="evidence.css"></head>
+<body class="evidence-page"><main>
+<a class="back-link" href="index.html">Back to Declaw</a>
+<h1>Credits</h1>
+<p>Paseo Plain: <a href="https://github.com/scowalt/paseo-plain">Scott’s scowalt/paseo-plain</a>. The extension vendors its pinned v5 prompt, which includes wording adapted from <a href="https://github.com/gvzdv/claudish-to-english">Claudish to English</a> by Mike Gvozdev. <a href="assets/licenses/paseo-plain-LICENSE">Apache-2.0 license</a>; <a href="assets/licenses/Claudish-MIT.txt">Claudish MIT license</a>.</p>
+<!-- RECORDING_PROVENANCE -->
+<p>I Have ADHD, Squirrel Mode, and ASD-STE100 use adapted writing rules, not the complete upstream tools. Terse is a local preset. Attribution does not imply endorsement.</p>
+<!-- SLYE_CREDIT -->
+<p>I Have ADHD adapts <a href="https://github.com/ayghri/i-have-adhd">ayghri/i-have-adhd</a>. <a href="assets/licenses/i-have-adhd-LICENSE">MIT license</a>.</p>
+<p>Squirrel Mode adapts <a href="https://github.com/thgMatajs/squirrel-mode">thgMatajs/squirrel-mode</a>. <a href="assets/licenses/squirrel-mode-LICENSE">MIT license</a>.</p>
+<p>ASD-STE100 adapts <a href="https://github.com/danyuchn/asd-ste100-skill">danyuchn/asd-ste100-skill</a>. <a href="assets/licenses/asd-ste100-skill-LICENSE">MIT license</a>. It is STE-inspired, not certified STE.</p>
+<p>Typeface: <a href="https://github.com/vercel/geist-font">Geist</a>. <a href="assets/licenses/Geist-OFL.txt">SIL Open Font License</a>.</p>
+</main></body></html>

package/playground/diff.ts

@@ -0,0 +1,65 @@
+export interface DiffPart { kind: "equal" | "remove" | "add"; text: string }
+export interface WordDiff { parts: DiffPart[]; granularity: "word" | "block" }
+
+const MAX_CHARS = 100_000;
+const MAX_CELLS = 2_000_000; // At most 8 MiB for the alignment table.
+const tokens = (text: string) => text.match(/\s+|[\p{L}\p{N}_]+|[^\s\p{L}\p{N}_]/gu) ?? [];
+
+/** Lossless word/punctuation/whitespace diff. Moves appear as removal + addition.
+ * Large inputs fall back to coarse changed blocks rather than unbounded LCS work.
+ * Filtering out additions reconstructs before; filtering out removals reconstructs after.
+ */
+export function diffWords(before: string, after: string): WordDiff {
+  const parts: DiffPart[] = [];
+  const append = (kind: DiffPart["kind"], text: string) => {
+    if (!text) return;
+    const last = parts.at(-1);
+    if (last?.kind === kind) last.text += text;
+    else parts.push({ kind, text });
+  };
+  if (before === after) {
+    append("equal", before);
+    return { parts, granularity: "word" };
+  }
+  if (before.length + after.length > MAX_CHARS) {
+    append("remove", before);
+    append("add", after);
+    return { parts, granularity: "block" };
+  }
+  const left = tokens(before), right = tokens(after);
+  let prefix = 0, suffix = 0;
+  while (prefix < left.length && prefix < right.length && left[prefix] === right[prefix]) prefix++;
+  while (suffix < left.length - prefix && suffix < right.length - prefix &&
+    left[left.length - suffix - 1] === right[right.length - suffix - 1]) suffix++;
+  append("equal", left.slice(0, prefix).join(""));
+  const a = left.slice(prefix, left.length - suffix), b = right.slice(prefix, right.length - suffix);
+  const columns = b.length + 1;
+  const cells = (a.length + 1) * columns;
+  let granularity: WordDiff["granularity"] = "word";
+  if (cells > MAX_CELLS) {
+    append("remove", a.join(""));
+    append("add", b.join(""));
+    granularity = "block";
+  } else {
+    const lengths = new Uint32Array(cells);
+    for (let i = a.length - 1; i >= 0; i--) {
+      for (let j = b.length - 1; j >= 0; j--) {
+        lengths[i * columns + j] = a[i] === b[j]
+          ? 1 + lengths[(i + 1) * columns + j + 1]
+          : Math.max(lengths[(i + 1) * columns + j], lengths[i * columns + j + 1]);
+      }
+    }
+    let i = 0, j = 0;
+    while (i < a.length || j < b.length) {
+      if (i < a.length && j < b.length && a[i] === b[j]) {
+        append("equal", a[i++]); j++;
+      } else if (i < a.length && (j === b.length || lengths[(i + 1) * columns + j] >= lengths[i * columns + j + 1])) {
+        append("remove", a[i++]);
+      } else {
+        append("add", b[j++]);
+      }
+    }
+  }
+  append("equal", suffix ? left.slice(-suffix).join("") : "");
+  return { parts, granularity };
+}

package/playground/evidence.css

@@ -0,0 +1 @@
+.evidence-page main{display:block;max-width:1200px;margin:auto;padding:40px 28px 80px;line-height:1.7}.evidence-page h1{font-size:36px;letter-spacing:-.03em;font-weight:580;margin:28px 0 12px}.evidence-page main>p{max-width:80ch;color:var(--muted)}.back-link{font-size:14px;color:var(--accent);text-underline-offset:4px}.evidence-page nav{display:flex;flex-wrap:wrap;gap:12px 24px;margin:30px 0 45px}.evidence-page nav a{padding-block:8px;min-height:44px}.evidence-page section{margin:42px 0;scroll-margin-top:24px}.evidence-page section>h2{font-size:26px;letter-spacing:-.025em;font-weight:550;margin-bottom:8px}.evidence-page section>p{margin-top:0;color:var(--muted)}.evidence-page details{border-top:1px solid var(--line);padding:10px 0}.evidence-page summary{padding:10px 0;min-height:44px;cursor:pointer}.evidence-page summary span{font-size:12px;color:var(--muted);margin-left:15px}.evidence-pair{display:grid;grid-template-columns:1fr 1fr;gap:42px;padding:12px 0 28px}.evidence-pair>div{min-width:0}.evidence-pair>div>h3{font-size:13px;color:var(--muted);margin:0 0 24px;font-weight:500}.evidence-pair .prose{margin:0}.check-note{font-size:12px;color:var(--muted);max-width:85ch}.evidence-page details>ul{max-width:80ch;color:var(--muted)}@media(max-width:760px){.evidence-page main{padding:24px 20px 50px;height:auto}.evidence-page h1{font-size:30px}.evidence-pair{grid-template-columns:1fr;gap:32px}.evidence-pair .prose{font-size:15px}}

package/playground/index.html

@@ -0,0 +1,96 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+  <meta name="theme-color" content="#111214">
+  <meta name="description" content="Declaw: compare an original AI answer with a clearer rewrite.">
+  <meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'self'; style-src 'self'; font-src 'self'; img-src 'self' data:; connect-src 'none'; base-uri 'none'; form-action 'none'">
+  <title>Declaw</title>
+  <link rel="icon" type="image/png" href="assets/declaw-favicon.png">
+  <link rel="preload" href="assets/geist.woff2" as="font" type="font/woff2" crossorigin>
+  <link rel="stylesheet" href="styles.css">
+  <script src="data.js" defer></script>
+  <script src="app.js" defer></script>
+</head>
+<body data-side="rewrite" data-view="reading">
+<!-- User revision supersedes the original comp's scale and inspection mechanics.
+     Show the writing, not an explanation of the demo. Small Control Rail; no hero
+     or method popup. One Show changes toggle reveals a unified block/word diff.
+     Mobile uses native page scrolling. Source and saved outputs remain unchanged. -->
+<a class="skip-link" href="#workspace">Skip to answer</a>
+<svg class="icon-definitions" aria-hidden="true" xmlns="http://www.w3.org/2000/svg"><defs>
+  <symbol id="i-document" viewBox="0 0 24 24"><path d="M14 3H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9zM14 3v6h6M8 13h8M8 17h6"/></symbol>
+  <symbol id="i-prose" viewBox="0 0 24 24"><path d="M4 5h16M4 10h16M4 15h16M4 20h10"/></symbol>
+  <symbol id="i-steps" viewBox="0 0 24 24"><path d="m3 5 2 2 3-4m3 2h10M3 12l2 2 3-4m3 2h10M3 19l2 2 3-4m3 2h10"/></symbol>
+  <symbol id="i-compare" viewBox="0 0 24 24"><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M12 4v16M3 10h18"/></symbol>
+  <symbol id="i-action" viewBox="0 0 24 24"><path d="m8 4 11 8-11 8z"/></symbol>
+  <symbol id="i-branch" viewBox="0 0 24 24"><path d="M6 5v10a4 4 0 0 0 4 4h2M6 11h7a5 5 0 0 0 5-5"/><circle cx="6" cy="4" r="2"/><circle cx="18" cy="4" r="2"/><circle cx="14" cy="19" r="2"/></symbol>
+  <symbol id="i-code" viewBox="0 0 24 24"><path d="m7 7-5 5 5 5m10-10 5 5-5 5m-3-14-4 18"/></symbol>
+  <symbol id="i-diff" viewBox="0 0 24 24"><path d="M4 7h6M7 4v6M14 7h6M4 17h6M14 17h6M3 12h18"/></symbol>
+  <symbol id="i-copy" viewBox="0 0 24 24"><rect x="8" y="8" width="12" height="13" rx="2"/><path d="M15 8V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v10a2 2 0 0 0 2 2h3"/></symbol>
+  <symbol id="i-external" viewBox="0 0 24 24"><path d="M14 4h6v6M20 4l-9 9M18 13v5a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h5"/></symbol>
+</defs></svg>
+<div class="app-shell">
+  <aside class="rail" aria-label="Examples and reading modes">
+    <h1 class="wordmark"><img src="assets/declaw-wordmark-white.png" width="1315" height="234" alt="Declaw"></h1>
+    <nav class="rail-group" aria-label="Examples" data-picker-group>
+      <h2>Examples</h2>
+      <button class="rail-button" data-case="local-vs-prod" aria-pressed="false" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#i-document"/></svg>Status update</button>
+      <button class="rail-button" data-case="verbose-explanation" aria-pressed="true" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#i-prose"/></svg>Long-form prose</button>
+      <button class="rail-button" data-case="ordered-recovery" aria-pressed="false" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#i-steps"/></svg>Recovery procedure</button>
+      <button class="rail-button" data-case="comparison-table" aria-pressed="false" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#i-compare"/></svg>Tradeoffs</button>
+    </nav>
+    <nav class="rail-group modes" aria-label="Reading modes" data-picker-group>
+      <h2>Mode</h2>
+      <!-- MODE_BUTTONS -->
+    </nav>
+    <div class="rail-footer">
+      <a class="action-link primary-link" href="https://github.com/jzlosman/declaw#install" target="_blank" rel="noreferrer">Try Declaw in Pi <svg class="icon" aria-hidden="true"><use href="#i-external"/></svg></a>
+      <a class="action-link" href="https://github.com/jzlosman/declaw" target="_blank" rel="noreferrer">View source on GitHub <svg class="icon" aria-hidden="true"><use href="#i-external"/></svg></a>
+      <a class="credits-link" href="credits.html">Credits</a>
+    </div>
+  </aside>
+  <main>
+    <header class="mobile-controls">
+      <h1 class="wordmark"><img src="assets/declaw-e.png" width="227" height="228" alt="Declaw"></h1>
+      <select id="example-select" aria-label="Example" data-interactive disabled><option value="verbose-explanation">Long-form prose</option></select>
+      <select id="mode-select" aria-label="Reading mode" data-interactive disabled><option value="plain">Paseo Plain</option></select>
+    </header>
+    <section class="workspace" id="workspace" tabindex="-1" aria-label="Answer comparison">
+      <div class="workspace-toolbar">
+        <h2 id="case-label">Long-form prose</h2>
+        <button class="diff-toggle" data-diff aria-pressed="false" aria-controls="unified-panel" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#i-diff"/></svg><span id="diff-label">Show changes</span></button>
+      </div>
+      <p class="source-attribution" id="source-attribution"><!-- INITIAL_ATTRIBUTION --></p>
+      <div class="mobile-tabs" role="tablist" aria-label="Answer">
+        <button id="tab-original" role="tab" data-side="original" aria-selected="false" aria-controls="original-panel" tabindex="-1" data-interactive disabled>Original</button>
+        <button id="tab-rewrite" role="tab" data-side="rewrite" aria-selected="true" aria-controls="rewrite-panel" data-interactive disabled>Rewrite</button>
+      </div>
+      <div class="documents">
+        <section class="document-panel original-panel" id="original-panel" aria-labelledby="original-label">
+          <header class="document-header"><h3 id="original-label">Original</h3><button class="icon-button copy-button" data-copy="original" aria-label="Copy original Markdown" title="Copy original Markdown" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#i-copy"/></svg></button></header>
+          <div class="reading-scroll" id="original-scroll" tabindex="0" aria-label="Original answer"><div class="prose" id="original-content"><!-- INITIAL_SOURCE --></div></div>
+        </section>
+        <section class="document-panel rewrite-panel" id="rewrite-panel" aria-labelledby="rewrite-label">
+          <header class="document-header"><h3 id="rewrite-label">Paseo Plain</h3><span class="unchanged-note" id="unchanged-note" hidden>Unchanged</span><button class="icon-button copy-button" data-copy="rewrite" aria-label="Copy rewritten Markdown" title="Copy rewritten Markdown" data-interactive disabled><svg class="icon" aria-hidden="true"><use href="#i-copy"/></svg></button></header>
+          <div class="reading-scroll" id="rewrite-scroll" tabindex="0" aria-label="Rewritten answer"><div class="prose" id="rewrite-content"><!-- INITIAL_REWRITE --></div></div>
+        </section>
+      </div>
+      <section id="unified-panel" class="unified-panel" aria-labelledby="unified-label" hidden>
+        <header class="document-header"><h3 id="unified-label">Changes</h3><div class="diff-legend"><span class="removed-key">Removed</span><span class="added-key">Added</span></div><span id="no-changes" class="unchanged-note" hidden>No wording changes</span></header>
+        <div class="reading-scroll" id="unified-scroll" tabindex="0" aria-label="Combined removals and additions"><div id="unified-content" class="unified-content"></div></div>
+      </section>
+    </section>
+    <div class="mobile-links">
+      <a class="action-link primary-link" href="https://github.com/jzlosman/declaw#install" target="_blank" rel="noreferrer">Try Declaw in Pi <svg class="icon" aria-hidden="true"><use href="#i-external"/></svg></a>
+      <a class="action-link" href="https://github.com/jzlosman/declaw" target="_blank" rel="noreferrer">View source on GitHub <svg class="icon" aria-hidden="true"><use href="#i-external"/></svg></a>
+    </div>
+    <a class="credits-link mobile-credits" href="credits.html">Credits</a>
+    <noscript><p class="fallback">Enable JavaScript to switch examples. <a href="evidence.html">View all examples</a>.</p></noscript>
+    <p class="fallback" id="fatal-error" hidden>Examples could not load. <a href="evidence.html">Open the static version</a>.</p>
+  </main>
+</div>
+<p class="sr-only" id="announcer" role="status" aria-live="polite" aria-atomic="true"></p>
+</body>
+</html>