pi-declaw 0.2.0

package/ARCHITECTURE.md

@@ -0,0 +1,90 @@
+# Declaw architecture
+
+## Bounded context
+
+Declaw owns the **Answer Rewriting** bounded context. Its authority is the completed
+assistant answer. It does not own the main agent conversation, provider credentials,
+model selection, Pi navigation, or browser-generated output.
+
+```text
+Pi command/UI ──► application action ──► domain plan
+      ▲                    │                 │
+      │                    │                 ├── StyleCatalog
+      │                    │                 └── Preservation policy
+      │                    ▼
+      └── DisplayWriter ◄── accepted result ◄─ RewriteModel
+```
+
+## Dependency rule
+
+```text
+domain / policy       → no Pi, model SDK, filesystem, network, or UI
+application actions   → depend on domain and ports
+adapters              → implement ports and translate external shapes
+composition root      → wires built-ins, registered plugins, and adapters
+```
+
+The files map to this boundary as follows:
+
+- `src/domain/styles.ts`: style identity, plugin catalog, status, and request composition.
+- `src/domain/preservation.ts`: host-owned exact-text protection and validation.
+- `src/domain/rewrite.ts`: rewrite policy, limits, and domain outcomes.
+- `src/plugin-api.ts`: framework-free plugin port and registration bridge.
+- `src/plugins/built-in/*`: one self-contained module per built-in plugin; each owns its
+  prompt, provenance, and payload adapter. `src/plugins/built-in/index.ts` only aggregates them.
+- `src/application/rewrite.ts`: rewrite use case and explicit completion/publication ports.
+- `src/adapters/pi.ts`: Pi message/session/request translation.
+- `src/adapters/model.ts`: Pi model/auth/provider translation and model selection.
+- `src/adapters/settings.ts`: filesystem preference adapter.
+- `index.ts`: composition root, lifecycle wiring, command registration, and display projection.
+- `playground/`: static projection of saved recordings; never a model adapter.
+
+## Actions and effects
+
+| Action | Reads | Effects | Success projection |
+|---|---|---|---|
+| Rewrite latest answer | current branch, style, model settings | isolated model call, then append custom entry | display-only rewrite |
+| Choose style | style catalog, current preference | preference file write | future rewrite default |
+| Choose model | Pi model registry/auth | preference file write | future rewrite provider |
+| List plugins | catalog, status file | none | status text |
+| Manage plugins | catalog, status file | status file write | active/disabled catalog |
+
+The rewrite path masks exact source spans, builds a plan, calls the model, validates
+returned tokens, and only then appends a custom entry. The original answer is never
+mutated or reintroduced as a model message.
+
+## Plugin lifecycle
+
+1. Pi loads the Declaw package and any installed style packages.
+2. Each style package registers a versioned, framework-free plugin contract.
+3. Declaw validates plugin identity, style namespace, provenance, and collisions.
+4. `/declaw list` shows all registered plugins and status.
+5. `/declaw manage` persists `active` or `disabled` status.
+6. Only active styles enter `/declaw style` and rewrite resolution.
+7. Display entries save style snapshots so plugin removal does not break history.
+
+The six built-in styles are six built-in plugin records. Third-party plugins use a
+namespaced style ID such as `pirate/pirate`. The process-wide registration bridge
+handles Pi extension load order; explicit package installation remains the trust boundary.
+
+## Outcome model
+
+- **Accepted** — output passes completion, unchanged-text, and exact-preservation checks.
+- **Rejected** — output is incomplete, unchanged, oversized, or damages protected text.
+- **Cancelled** — user or Pi lifecycle cancels the attempt; nothing is appended.
+- **Indeterminate** — provider/network failure leaves the external outcome unknown;
+  the original remains authoritative and no display entry is appended.
+
+These outcomes are deliberately not collapsed into a boolean. The provider adapter
+owns provider-specific errors; the domain owns semantic acceptance.
+
+## Test strategy
+
+- Domain tests: style identity, plugin namespace, collision, status, payload composition,
+  masking, and preservation.
+- Application tests: fake completion gateway, rejection, cancellation, and no-write behavior.
+- Adapter tests: Pi message normalization, provider serialization, filesystem settings,
+  and custom-entry rendering.
+- Composition tests: built-in registration, external registration, `/declaw` alias,
+  status persistence, and disabled-style selection.
+- Static-site tests: saved snapshots only; no plugin or provider execution in the browser.

package/GLOSSARY.md

@@ -0,0 +1,48 @@
+# Declaw glossary
+
+Declaw's bounded context is **Answer Rewriting**: turning a completed assistant
+answer into an alternate reading without changing the conversation or pretending
+that shorter means better.
+
+## Domain language
+
+- **Source answer** — the immutable completed assistant answer selected for rewriting.
+- **Source entry ID** — Pi identity of the source answer. It prevents a late result
+  from being attached to a different branch or newer answer.
+- **Reading style** — a named presentation policy, such as Terse or SLYE.
+- **Style definition** — a style's stable ID, label, provenance, instructions, and
+  protected-answer payload formatter.
+- **Style plugin** — a trusted package contribution containing one or more definitions.
+- **Style catalog** — the host-owned registry that validates IDs, namespaces,
+  collisions, provenance, and active/disabled status.
+- **Style snapshot** — style label, plugin ID, and plugin version saved with a
+  display entry so historical entries remain readable after plugin removal.
+- **Protected answer** — source text with exact spans replaced by temporary tokens.
+- **Rewrite request** — protected answer plus style instructions and selected model.
+- **Rewrite attempt** — one isolated, tool-free provider invocation.
+- **Rewrite result** — accepted text, unchanged text, preservation rejection,
+  cancellation, or operational failure.
+- **Display rewrite** — a Pi custom entry rendered to the user but excluded from
+  future agent context.
+
+## Application language
+
+- **Action** — an intentional user request: `RewriteLatestAnswer`, `ChooseStyle`,
+  `ChooseModel`, `ListPlugins`, or `ManagePlugins`.
+- **Port** — an application-owned capability required from the outside world:
+  answer reading, model completion, preferences, clock/identity, and display writing.
+- **Adapter** — an implementation of a port: Pi session, Pi provider, filesystem,
+  or TUI adapter.
+- **Effect** — an observable side effect: provider call, preference write, or
+  `pi.appendEntry`. Effects happen after deterministic validation and planning.
+- **Projection** — a representation for a consumer. The display rewrite is a
+  projection, not a new assistant message.
+- **Provenance** — where a style or output came from and how it relates to its source.
+- **Indeterminate** — an operational outcome where the provider result cannot be
+  known. It is not the same as a semantic rejection.
+
+## Non-domain concerns
+
+Pi model IDs, OAuth, headers, filesystem paths, terminal widgets, package loading,
+and GitHub Pages are infrastructure concerns. They may be represented at adapters,
+but they are not reading-style policy.

package/LICENSE

@@ -0,0 +1,201 @@
+                                 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/NOTICE

@@ -0,0 +1,30 @@
+This package includes writing prompts and code from the following projects.
+The package's original code is licensed under Apache-2.0. Third-party components
+retain their own licenses and copyright notices.
+
+Paseo Plain — Copyright 2026 scowalt.
+Repository license: Apache-2.0, retaining original Paseo notices.
+See src/plugins/built-in/paseo-plain/upstream/NOTICE and
+src/plugins/built-in/paseo-plain/upstream/LICENSE.
+The local preservation.ts adaptation changes command recognition. The upstream
+source extracts remain under the Paseo Plain plugin's upstream/ directory.
+
+Claudish to English — Copyright (c) 2026 Mike Gvozdev. MIT.
+Retained wording in the Paseo Plain prompt. See
+src/plugins/built-in/paseo-plain/upstream/Claudish-MIT.txt.
+
+I Have ADHD — Copyright (c) 2026 Ayoub Ghriss. MIT.
+See licenses/i-have-adhd-LICENSE.
+
+Squirrel Mode — Copyright (c) 2026 Thiago Matajs. MIT.
+See licenses/squirrel-mode-LICENSE.
+
+ASD-STE100 skill — Copyright (c) 2026 Dustin Yuchen Teng. MIT.
+See licenses/asd-ste100-skill-LICENSE. The official ASD standard and dictionary
+are not included, and no certified compliance is claimed.
+
+Speak Like You Eat — Copyright (c) 2026 wtfzambo. MIT.
+See licenses/speak-like-you-eat-LICENSE.
+
+All styles add the package's shared meaning-preservation rules. The sources do
+not endorse this package. Pinned revisions and adaptations: SOURCES.md.

package/PLUGIN_GUIDE.md

@@ -0,0 +1,142 @@
+# Build a Declaw style plugin
+
+> **Agent-first prompt:** Copy this section into your coding agent when you want to
+> add a rewriting style to Declaw.
+>
+> ```text
+> You are adding a Declaw style plugin. Read PLUGIN_GUIDE.md and the Declaw plugin
+> API before editing code. Create a separate Pi package. Keep the plugin framework-
+> free and deterministic: it may provide style instructions and format the already-
+> protected answer, but it must not call a model, read files, use Pi context, add
+> tools, or perform side effects. Use a namespaced style ID. Preserve every fact,
+> condition, actor, modality, number, command, link, procedure step, and table
+> relationship. Add focused tests for registration, request formatting, and the
+> plugin's distinctive voice. Do not fabricate demo output. Run the plugin tests,
+> then install the package explicitly with Pi and verify `/declaw list`,
+> `/declaw manage`, and `/declaw style`.
+> ```
+
+## What a plugin is
+
+A plugin is a normal Pi package that registers one or more Declaw reading styles.
+Declaw supplies the preservation policy, protected-text validation, model gateway,
+Pi session integration, display-only storage, cancellation, and status management.
+The plugin supplies only a style identity, provenance, style instructions, and a
+pure function that formats the protected answer for the model envelope.
+
+Pi extensions run with full system permissions. The Declaw contract is a clean
+architecture boundary, not a security sandbox. Review plugin source before installing.
+
+## Minimal package
+
+```text
+declaw-style-pirate/
+├── package.json
+├── index.ts
+├── style.ts
+└── style.test.ts
+```
+
+`package.json`:
+
+```json
+{
+  "name": "declaw-style-pirate",
+  "version": "1.0.0",
+  "type": "module",
+  "keywords": ["pi-package", "declaw-style"],
+  "dependencies": {
+    "pi-declaw": "^0.2.0"
+  },
+  "pi": {
+    "extensions": ["./index.ts"]
+  }
+}
+```
+
+The dependency is used only for the framework-free `pi-declaw/plugin-api` contract.
+Pin a release or commit for a published plugin.
+
+`style.ts`:
+
+```ts
+import type { DeclawStylePlugin } from "pi-declaw/plugin-api";
+
+export const plugin: DeclawStylePlugin = {
+  apiVersion: 1,
+  id: "pirate",
+  name: "Pirate styles",
+  version: "1.0.0",
+  status: "active",
+  styles: [{
+    id: "pirate/pirate",
+    name: "Pirate",
+    description: "Salty wording without loss of meaning.",
+    relationship: "Local preset",
+    instructions: [
+      "Use a playful pirate voice.",
+      "Keep the answer's level of certainty and ownership unchanged.",
+      "Do not add nautical facts, claims, or jokes that change the answer.",
+    ].join("\\n"),
+    buildUserPayload: (protectedAnswer) =>
+      JSON.stringify({ assistantMessage: protectedAnswer }),
+  }],
+};
+```
+
+`index.ts`:
+
+```ts
+import { registerDeclawPlugin } from "pi-declaw/plugin-api";
+import { plugin } from "./style.ts";
+
+export default function () {
+  registerDeclawPlugin(plugin);
+}
+```
+
+The plugin extension can load before or after Declaw. Registration is buffered by a
+stable process-wide bridge, so extension load order does not change the catalog.
+
+## Rules
+
+- Use a stable plugin ID and a style ID under that namespace: `pirate/pirate`.
+- Use `Local preset` when there is no upstream source. Use `Adapted from` or
+  `Prompt from` only with a real `https://` source URL.
+- `instructions` describe presentation only. The host appends its preservation policy.
+- `buildUserPayload` receives protected text. Copy it exactly once; do not unmask it.
+- Do not import `@earendil-works/pi-coding-agent`, `@earendil-works/pi-ai`, Node
+  filesystem APIs, network clients, clocks, randomness, or environment variables.
+- Do not answer the source text, execute quoted commands, add tools, or claim work.
+- Keep optional actions optional, preserve procedure order, and retain table structure.
+- A plugin's `status` is only its default. The user can disable it at runtime.
+
+## Install and operate
+
+```sh
+pi install git:github.com/example/declaw-style-pirate@v1
+```
+
+After restart or `/reload`:
+
+```text
+/declaw list       # show every plugin, its status, and its styles
+/declaw manage     # toggle active/disabled
+/declaw style      # choose an active style
+/declaw pirate/pirate  # one-off rewrite
+```
+
+Declaw stores user-managed plugin status in
+`~/.pi/agent/declaw/plugins.json`. Disabled plugins remain visible in `/declaw list`
+but cannot be selected for rewriting. Existing display entries retain a style snapshot
+so removing a plugin does not erase their historical label.
+
+## Verification checklist
+
+1. Test the plugin with a fake protected answer containing a path, URL, number,
+   optional action, condition, and ordered steps.
+2. Assert the payload preserves the protected answer exactly.
+3. Assert the style is distinctive without adding claims.
+4. Install it in a disposable Pi profile.
+5. Verify `/declaw list`, disable and re-enable it, and confirm `/declaw style` updates.
+6. Never publish model recordings until a human has reviewed semantic fidelity.

package/README.md

@@ -0,0 +1,161 @@
+<h1>
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="playground/assets/declaw-wordmark-white.png">
+  <img src="playground/assets/declaw-wordmark-charcoal.png" alt="Declaw" width="420">
+</picture>
+</h1>
+
+[![CI](https://github.com/jzlosman/declaw/actions/workflows/ci.yml/badge.svg)](https://github.com/jzlosman/declaw/actions/workflows/ci.yml)
+[![GitHub Pages](https://github.com/jzlosman/declaw/actions/workflows/pages.yml/badge.svg)](https://github.com/jzlosman/declaw/actions/workflows/pages.yml)
+[![License](https://img.shields.io/github/license/jzlosman/declaw)](LICENSE)
+[![Stars](https://img.shields.io/github/stars/jzlosman/declaw)](https://github.com/jzlosman/declaw/stargazers)
+[![Forks](https://img.shields.io/github/forks/jzlosman/declaw)](https://github.com/jzlosman/declaw/network/members)
+
+Make a completed AI answer easier to read.
+
+Declaw rewrites the latest answer in a style you choose. The original stays intact.
+The rewrite appears as a display-only entry. It never enters the agent's context.
+
+## Install
+
+Install the package from npm:
+
+```sh
+pi install npm:pi-declaw
+```
+
+For the source repository instead:
+
+```sh
+pi install git:github.com/jzlosman/declaw
+```
+
+Then run `/reload` in Pi and use `/declaw`.
+
+## Use
+
+```text
+/declaw              Rewrite the latest answer with your saved style.
+/declaw style        Choose and save a style.
+/declaw <style-id>   Rewrite once with a specific style.
+/declaw model        Choose the separate rewrite model.
+/declaw list        List installed styles/plugins and active status.
+/declaw manage      Enable or disable a style plugin.
+```
+
+Example:
+
+```text
+/declaw slye
+```
+
+Press **Esc** to cancel. Declaw never rewrites automatically.
+
+## Styles
+
+| ID | Style | Source |
+| --- | --- | --- |
+| `plain` | Paseo Plain | [scowalt/paseo-plain](https://github.com/scowalt/paseo-plain) |
+| `terse` | Terse | Local preset |
+| `adhd` | I Have ADHD | [ayghri/i-have-adhd](https://github.com/ayghri/i-have-adhd) |
+| `squirrel` | Squirrel Mode | [thgMatajs/squirrel-mode](https://github.com/thgMatajs/squirrel-mode) |
+| `ste` | ASD-STE100 | [danyuchn/asd-ste100-skill](https://github.com/danyuchn/asd-ste100-skill) |
+| `slye` | Speak Like You Eat | [wtfzambo/speak-like-you-eat](https://github.com/wtfzambo/speak-like-you-eat) |
+
+The six styles are shipped as built-in plugins. You do not install separate packages
+for them. Additional styles can be installed as independent Pi packages; see
+[`PLUGIN_GUIDE.md`](PLUGIN_GUIDE.md) for an agent-first recipe.
+
+Some styles adapt rules from their sources. They are not complete ports or official
+certifications. Source attribution does not imply endorsement.
+
+## Plugin architecture
+
+Declaw owns the preservation policy, model gateway, Pi session boundary, and display-only
+projection. A plugin owns only its style instructions and protected-answer envelope.
+Plugin IDs are stable, styles are namespaced, collisions are rejected, and user status
+is persisted independently of plugin code. Disabled plugins remain visible in
+`/declaw list` but are unavailable to `/declaw style`.
+
+Read [`GLOSSARY.md`](GLOSSARY.md) for the domain vocabulary and
+[`ARCHITECTURE.md`](ARCHITECTURE.md) for ports, adapters, actions, and effects.
+
+## What Declaw preserves
+
+Declaw protects exact text before the model sees the answer. This includes:
+
+- commands
+- paths and links
+- code
+- quotations
+- numbers
+- names and other technical text
+
+It rejects a rewrite when protected text is missing, duplicated, reordered, or invented.
+It also preserves meaning rules such as:
+
+- `may` must not become `will`;
+- a proposed assistant action must not become a user instruction;
+- prerequisites must not become broader;
+- recommendation reasons must remain attached; and
+- useful tables must remain tables.
+
+These checks reduce errors. They cannot prove that a model preserved every meaning.
+Read important rewrites against the original.
+
+## Privacy and limits
+
+Each request sends one protected answer to the selected rewrite model. It does not
+send conversation history, earlier requests, project files, tools, or reasoning.
+
+Declaw uses its own model and style settings. It does not change the main agent's
+model or thinking level. The default rewrite model is:
+
+```text
+openai-codex/gpt-5.6-luna · low thinking
+```
+
+Provider charges apply. You must be authenticated to the selected provider.
+Provider retries are disabled. Requests time out after 60 seconds.
+
+Declaw requires Pi's terminal UI. It does not rewrite incomplete answers, tool-call
+results, answers over 32,000 characters, or overlapping requests.
+
+Rewrites are saved in the Pi session file as display-only entries. They remain visible
+after reload, but Pi does not send them back to the agent or include them in compaction.
+
+## Playground
+
+The static playground uses saved outputs. It makes no browser model calls and collects
+no visitor credentials or analytics.
+
+```sh
+npm run build:playground
+open dist/playground/index.html
+```
+
+The public snapshot contains reviewed historical recordings from the earlier
+five-style demo. It is labeled as historical and does not include SLYE output.
+The site is live; do not treat the examples as a guarantee of semantic fidelity.
+
+The private generation and review lab is kept outside this repository. Source pins,
+licenses, and adaptations are documented in [SOURCES.md](SOURCES.md).
+
+## Development
+
+```sh
+npm test
+npm run build:playground
+```
+
+Tests use synthetic answers and fake model responses. They do not make live model calls.
+
+The GitHub Pages workflow is active at `.github/workflows/pages.yml`. It builds only
+`dist/playground/`. The public repository is
+[jzlosman/declaw](https://github.com/jzlosman/declaw), and Pages is available at
+[jzlosman.github.io/declaw](https://jzlosman.github.io/declaw/).
+
+## License
+
+Declaw is Apache-2.0. Third-party prompts and rules retain their original licenses.
+See [`LICENSE`](LICENSE), [`NOTICE`](NOTICE), the source-specific `upstream/` directories under `src/plugins/built-in/`, and `licenses/`.