feat(propose): require a Proposal Commitment acknowledgment

Adds a public commitment proposers acknowledge before submitting, and
records that acknowledgment in the proposal description that goes onchain.

- New /propose/terms page (EN + PT-BR) with the 7-clause commitment
- Checkbox on the preview step, gating the submit button
- One-line footer appended to the description, always English and version
  stamped, so the record stays searchable and auditable across the DAO

The form schema keeps `termsAccepted` optional because ActionForms saves
each transaction through the whole form's handleSubmit — requiring it there
would block adding the transactions needed to reach the checkbox. The hard
requirement lives in proposalSubmissionSchema, which the server action
parses, so the client cannot skip it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: r4topunk

messages/en/metadata.json

@@ -111,5 +111,9 @@
   "migrate": {
     "title": "Gnars Migration — Gnars DAO",
     "description": "Consolidate your scattered Zora coins into $gnars in one batched flow. Routed through ZORA, with a burn on every migration to strengthen $gnars liquidity."
+  },
+  "proposeTerms": {
+    "title": "Proposal Commitment — Gnars DAO",
+    "description": "The public commitment every proposer acknowledges before submitting a proposal to Gnars DAO."
   }
 }

messages/en/propose.json

@@ -225,7 +225,10 @@
     "failedToSubmit": "Failed to submit proposal",
     "thirdwebNotConfigured": "Thirdweb client not configured",
     "connectWalletToSubmit": "Connect wallet to submit a proposal",
-    "pleaseFixErrors": "Please fix validation errors before submitting"
+    "pleaseFixErrors": "Please fix validation errors before submitting",
+    "termsLabel": "I have read and accept the <link>Gnars Proposal Commitment</link>",
+    "termsHint": "A short note recording this acknowledgment is appended to your proposal description.",
+    "termsRequired": "You must accept the Proposal Commitment before submitting."
   },
   "droposalBuilder": {
     "media": {
@@ -295,5 +298,43 @@
     },
     "breadcrumbCreate": "Create Proposal",
     "breadcrumbTemplates": "Templates"
+  },
+  "terms": {
+    "title": "Proposal Commitment",
+    "subtitle": "A public commitment, not a legal contract. It is enforced by transparency and reputation, not by courts.",
+    "intro": "By submitting a proposal to Gnars DAO, you acknowledge the following.",
+    "callout": "Gnars is built on action over talk. Approval is not just access to funds — it is trust from the community.",
+    "clauses": {
+      "goodFaith": {
+        "title": "Good faith",
+        "body": "I have described the scope, timeline, budget, and deliverables of this proposal accurately, and I intend to execute it as written."
+      },
+      "treasuryRespect": {
+        "title": "Treasury respect",
+        "body": "Treasury funds are community resources, not casual capital. If this proposal is approved, I will keep spending aligned with the approved plan."
+      },
+      "noSilence": {
+        "title": "No silence",
+        "body": "I will post progress updates as propdates while the work is in flight, and I will report delays, blockers, or changes in scope publicly and early — before trust breaks."
+      },
+      "proofOfWork": {
+        "title": "Proof of work",
+        "body": "Updates will include evidence the work exists: links, commits, repos, files, media, transactions, or live pages."
+      },
+      "finalReport": {
+        "title": "Final report",
+        "body": "When the work is done, I will post a closing report covering what was delivered, how the budget was used, what remains reusable, and what I learned."
+      },
+      "openByDefault": {
+        "title": "Open by default",
+        "body": "Where applicable, code, media, documentation, and creative outputs will be delivered CC0 or open-source. Any part that cannot be shared openly is disclosed in the proposal itself."
+      },
+      "proportionalSafeguards": {
+        "title": "Proportional safeguards",
+        "body": "I understand that larger requests may be expected to use milestone-based releases, shared custody, or both, and that voters will weigh this when deciding."
+      }
+    },
+    "versionLabel": "Version {version}",
+    "backToPropose": "Back to creating a proposal"
   }
 }

messages/pt-br/metadata.json

@@ -111,5 +111,9 @@
   "migrate": {
     "title": "Migração Gnars — Gnars DAO",
     "description": "Consolide suas coins da Zora espalhadas em $gnars em um fluxo em lote. Roteado via ZORA, com queima a cada migração para fortalecer a liquidez de $gnars."
+  },
+  "proposeTerms": {
+    "title": "Compromisso de Proposta — Gnars DAO",
+    "description": "O compromisso público que todo proponente aceita antes de enviar uma proposta para a Gnars DAO."
   }
 }

messages/pt-br/propose.json

@@ -225,7 +225,10 @@
     "failedToSubmit": "Falha ao enviar proposta",
     "thirdwebNotConfigured": "Cliente Thirdweb não configurado",
     "connectWalletToSubmit": "Conecte a wallet para enviar uma proposta",
-    "pleaseFixErrors": "Por favor, corrija os erros de validação antes de enviar"
+    "pleaseFixErrors": "Por favor, corrija os erros de validação antes de enviar",
+    "termsLabel": "Li e aceito o <link>Compromisso de Proposta da Gnars</link>",
+    "termsHint": "Uma linha registrando esse aceite é anexada à descrição da sua proposta.",
+    "termsRequired": "Você precisa aceitar o Compromisso de Proposta antes de enviar."
   },
   "droposalBuilder": {
     "media": {
@@ -295,5 +298,43 @@
     },
     "breadcrumbCreate": "Criar Proposta",
     "breadcrumbTemplates": "Templates"
+  },
+  "terms": {
+    "title": "Compromisso de Proposta",
+    "subtitle": "Um compromisso público, não um contrato legal. Vale por transparência e reputação, não por tribunal.",
+    "intro": "Ao enviar uma proposta para a Gnars DAO, você reconhece o seguinte.",
+    "callout": "A Gnars é feita de ação, não de discurso. Aprovação não é só acesso a fundos — é confiança da comunidade.",
+    "clauses": {
+      "goodFaith": {
+        "title": "Boa-fé",
+        "body": "Descrevi o escopo, o prazo, o orçamento e as entregas desta proposta de forma honesta, e pretendo executá-la como está escrito."
+      },
+      "treasuryRespect": {
+        "title": "Respeito ao tesouro",
+        "body": "O tesouro é recurso da comunidade, não dinheiro solto. Se esta proposta for aprovada, mantenho os gastos alinhados com o plano aprovado."
+      },
+      "noSilence": {
+        "title": "Sem sumiço",
+        "body": "Vou postar updates de progresso como propdates enquanto o trabalho estiver rolando, e avisar sobre atrasos, bloqueios ou mudança de escopo em público e cedo — antes de quebrar a confiança."
+      },
+      "proofOfWork": {
+        "title": "Prova de trabalho",
+        "body": "Os updates vêm com evidência de que o trabalho existe: links, commits, repositórios, arquivos, mídia, transações ou páginas no ar."
+      },
+      "finalReport": {
+        "title": "Relatório final",
+        "body": "Quando terminar, posto um relatório de fechamento contando o que foi entregue, como o orçamento foi usado, o que fica reutilizável e o que aprendi."
+      },
+      "openByDefault": {
+        "title": "Aberto por padrão",
+        "body": "Quando fizer sentido, código, mídia, documentação e outputs criativos saem em CC0 ou open-source. O que não puder ser aberto fica declarado na própria proposta."
+      },
+      "proportionalSafeguards": {
+        "title": "Salvaguardas proporcionais",
+        "body": "Entendo que pedidos maiores podem exigir liberação por milestone, custódia compartilhada ou ambos, e que quem vota vai levar isso em conta."
+      }
+    },
+    "versionLabel": "Versão {version}",
+    "backToPropose": "Voltar para criar proposta"
   }
 }

src/app/[locale]/propose/actions.ts

@@ -1,14 +1,15 @@
 "use server";
 
 import { z } from "zod";
-import { proposalSchema } from "@/components/proposals/schema";
+import { proposalSchema, proposalSubmissionSchema } from "@/components/proposals/schema";
 import { ipfsToGatewayUrl } from "@/lib/pinata";
+import { PROPOSAL_COMMITMENT_FOOTER } from "@/lib/proposal-commitment";
 import { encodeTransactions } from "@/lib/proposal-utils";
 
 type ProposalFormValues = z.infer<typeof proposalSchema>;
 
 export async function createProposalAction(formData: ProposalFormValues) {
-  const validationResult = proposalSchema.safeParse(formData);
+  const validationResult = proposalSubmissionSchema.safeParse(formData);
   if (!validationResult.success) {
     throw new Error("Invalid proposal data");
   }
@@ -27,7 +28,12 @@ export async function createProposalAction(formData: ProposalFormValues) {
     formattedDescription = `![Banner](${imageUrl})\n\n${description}`;
   }
 
-  // 3. Format: Title && Description
+  // 3. Record the Proposal Commitment acknowledgment. `proposalSchema` already
+  // rejected anything without `termsAccepted`, so reaching here means the
+  // proposer opted in on the preview step.
+  formattedDescription = `${formattedDescription}${PROPOSAL_COMMITMENT_FOOTER}`;
+
+  // 4. Format: Title && Description
   // Nouns Builder uses && as separator (NOT $$ or #)
   const fullDescription = `${title}&&${formattedDescription}`;
 

src/app/[locale]/propose/terms/page.tsx

@@ -0,0 +1,99 @@
+import type { Metadata } from "next";
+import { getTranslations, setRequestLocale } from "next-intl/server";
+import { ArrowLeft } from "lucide-react";
+import { Link } from "@/i18n/navigation";
+import {
+  PROPOSAL_COMMITMENT_CLAUSES,
+  PROPOSAL_COMMITMENT_VERSION,
+} from "@/lib/proposal-commitment";
+
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ locale: string }>;
+}): Promise<Metadata> {
+  const { locale } = await params;
+  const t = await getTranslations({ locale, namespace: "metadata.proposeTerms" });
+  const path = "/propose/terms";
+  const canonical = locale === "en" ? path : `/pt-br${path}`;
+  return {
+    title: t("title"),
+    description: t("description"),
+    alternates: {
+      canonical,
+      languages: {
+        en: path,
+        "pt-br": `/pt-br${path}`,
+        "x-default": path,
+      },
+    },
+    openGraph: {
+      title: t("title"),
+      description: t("description"),
+      locale: locale === "pt-br" ? "pt_BR" : "en_US",
+      type: "article",
+    },
+    twitter: {
+      card: "summary_large_image",
+      title: t("title"),
+      description: t("description"),
+    },
+  };
+}
+
+interface ProposeTermsPageProps {
+  params: Promise<{ locale: string }>;
+}
+
+export default async function ProposeTermsPage({ params }: ProposeTermsPageProps) {
+  const { locale } = await params;
+  setRequestLocale(locale);
+  const t = await getTranslations("propose.terms");
+
+  return (
+    <div className="py-8">
+      <article className="max-w-2xl mx-auto">
+        <header>
+          <h1 className="text-3xl font-bold">{t("title")}</h1>
+          <p className="text-muted-foreground mt-2 text-balance">{t("subtitle")}</p>
+        </header>
+
+        <p className="mt-6">{t("intro")}</p>
+
+        <p className="mt-6 border-l-2 border-primary pl-4 text-muted-foreground italic">
+          {t("callout")}
+        </p>
+
+        <ol className="mt-8 space-y-6">
+          {PROPOSAL_COMMITMENT_CLAUSES.map((clause, index) => (
+            <li key={clause} className="flex gap-4">
+              <span
+                aria-hidden
+                className="shrink-0 font-mono text-sm text-muted-foreground pt-0.5 tabular-nums"
+              >
+                {String(index + 1).padStart(2, "0")}
+              </span>
+              <div className="space-y-1">
+                <h2 className="font-semibold">{t(`clauses.${clause}.title`)}</h2>
+                <p className="text-muted-foreground text-pretty">{t(`clauses.${clause}.body`)}</p>
+              </div>
+            </li>
+          ))}
+        </ol>
+
+        <footer className="mt-10 border-t pt-4 flex flex-wrap items-center justify-between gap-3 text-sm">
+          <span className="font-mono text-muted-foreground">
+            {t("versionLabel", { version: PROPOSAL_COMMITMENT_VERSION })}
+          </span>
+          <Link
+            href="/propose"
+            className="inline-flex items-center gap-2 text-muted-foreground hover:text-foreground transition-colors"
+          >
+            <ArrowLeft className="h-4 w-4" />
+            {t("backToPropose")}
+          </Link>
+        </footer>
+      </article>
+    </div>
+  );
+}

src/components/proposals/ProposalPreview.tsx

@@ -22,10 +22,12 @@ import { useProposalEligibilityContext } from "@/components/proposals/ProposalEl
 import { Alert, AlertDescription } from "@/components/ui/alert";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent } from "@/components/ui/card";
+import { Checkbox } from "@/components/ui/checkbox";
 import { createProposalAction } from "@/app/[locale]/propose/actions";
 import { useProposalIndexing } from "@/hooks/use-proposal-indexing";
 import { useUserAddress } from "@/hooks/use-user-address";
 import { useWriteAccount } from "@/hooks/use-write-account";
+import { Link } from "@/i18n/navigation";
 import { DAO_ADDRESSES } from "@/lib/config";
 import { ipfsToGatewayUrl } from "@/lib/pinata";
 import { encodeTransactions } from "@/lib/proposal-utils";
@@ -107,6 +109,7 @@ export function ProposalPreview() {
   const {
     getValues,
     handleSubmit,
+    setValue,
     formState: { errors },
   } = useFormContext<ProposalFormValues>();
   const [isActionPending, startTransition] = useTransition();
@@ -162,13 +165,26 @@ export function ProposalPreview() {
       }
     };
 
-    if (data.title && data.description) {
+    // The prepared description includes the commitment footer, so it only
+    // exists once the proposer has accepted — matching what goes onchain.
+    if (data.title && data.description && data.termsAccepted) {
       generateDescription();
     }
   }, [data]);
 
   const handleFormSubmit = async (formData: ProposalFormValues) => {
     console.log("handleFormSubmit called with data:", formData);
+
+    // The commitment is optional in the form schema (see schema.ts) so that
+    // saving a transaction doesn't trip on it — enforce it here, at the only
+    // point where it actually matters.
+    if (formData.termsAccepted !== true) {
+      const detail = t("preview.termsRequired");
+      setValidationError(detail);
+      toast.error(detail);
+      return;
+    }
+
     setValidationError(null);
     setHash(undefined);
     setIsConfirming(false);
@@ -349,6 +365,7 @@ export function ProposalPreview() {
     eligibility.hasThreshold === true &&
     Boolean(data.title) &&
     (data.transactions?.length ?? 0) > 0 &&
+    data.termsAccepted === true &&
     !isActionPending &&
     !isWalletPending &&
     !isConfirming &&
@@ -541,6 +558,41 @@ export function ProposalPreview() {
             </Alert>
           )}
 
+          <div className="mb-4 rounded-lg border p-4">
+            <div className="flex items-start gap-3">
+              <Checkbox
+                id="terms-accepted"
+                checked={data.termsAccepted === true}
+                onCheckedChange={(checked) =>
+                  setValue("termsAccepted", checked === true, {
+                    shouldValidate: true,
+                    shouldDirty: true,
+                  })
+                }
+                className="mt-0.5"
+              />
+              <div className="space-y-1">
+                <label
+                  htmlFor="terms-accepted"
+                  className="text-sm font-medium leading-snug cursor-pointer"
+                >
+                  {t.rich("preview.termsLabel", {
+                    link: (chunks) => (
+                      <Link
+                        href="/propose/terms"
+                        target="_blank"
+                        className="underline underline-offset-4 hover:text-primary"
+                      >
+                        {chunks}
+                      </Link>
+                    ),
+                  })}
+                </label>
+                <p className="text-xs text-muted-foreground">{t("preview.termsHint")}</p>
+              </div>
+            </div>
+          </div>
+
           {isConnected && eligibility.hasThreshold === true && (
             <Button
               onClick={(e) => {

src/components/proposals/ProposalWizard.tsx

@@ -38,6 +38,7 @@ export function ProposalWizard() {
       description: "",
       bannerImage: undefined,
       transactions: [],
+      termsAccepted: false,
     },
     mode: "onChange",
   });

src/components/proposals/schema.ts

@@ -200,6 +200,25 @@ export const proposalSchema = z.object({
    * TemplateDetailsForm mirrors these into `description` as compiled markdown.
    */
   templateFields: z.record(z.string(), z.unknown()).optional(),
+  /**
+   * Proposal Commitment acknowledgment, checked on the preview step.
+   *
+   * Optional *here* on purpose: `ActionForms` saves each transaction through
+   * this form's `handleSubmit`, so a required field would block adding the very
+   * transactions the user needs before the checkbox is reachable. The hard
+   * requirement lives in `proposalSubmissionSchema` below, which is what the
+   * server action parses.
+   */
+  termsAccepted: z.boolean().optional(),
+});
+
+/**
+ * Strict schema for the actual `propose()` call. Enforces the Proposal
+ * Commitment acknowledgment so the server action cannot compose an onchain
+ * description for a proposal that never opted in.
+ */
+export const proposalSubmissionSchema = proposalSchema.extend({
+  termsAccepted: z.literal(true, { message: "You must accept the Proposal Commitment" }),
 });
 
 // Types