feat: governance kernel, deployment hardening, local-dev stack

Adds proposals + proposal_votes + policies + incidents + incident_updates
tables with full RLS, async voting flow, dismissal-appeal pathway,
versioned policies with provenance, and an anonymous-incident token mode.
Adds per-space configurable areas, financial visibility settings, member
self-profile + COI disclosure, and a mission statement that renders in
the app footer.

Reorganises lib/actions.ts into per-domain files (tasks, projects,
members, payments, contacts, knowledge-base, secrets, area-leads,
settings, imports, proposals, incidents, policies, areas) plus a barrel.
Adds lib/permissions.ts and lib/auth-helpers.ts so action bodies stop
duplicating the user-to-member-to-role check. Wires every action that has
a Zod schema; introduces a flexibleDateTime preprocessor so HTML date
pickers no longer hit "Invalid datetime".

Hardens RLS: drops NOT NULL on space_members.user_id for offline members,
adds a privilege-escalation trigger that blocks self-edits to role / tier
/ status / approved / has_card_access / space_id, closes four
cross-tenant holes in the governance kernel, and adds a partial unique
index so two admins cannot concurrently activate two drafts of the same
policy slug.

Ships every deployment artifact: Dockerfile, docker-compose,
.do/app.yaml, .env.example, /api/health, plus a managed-Supabase guide
(docs/DEPLOYMENT.md), an end-to-end self-hosted Droplet guide
(docs/DEPLOY_DO_SELFHOSTED.md), and a Supabase-CLI local-dev quickstart
(docs/LOCAL_DEV.md). Replaces middleware.ts with proxy.ts for Next.js 16.
Adds scripts/schema.sql as the canonical idempotent full deploy plus
fourteen numbered incremental migrations.

Adds scripts/seed.sql so a fresh local DB renders something instead of
empty pages: a demo space, five members across all roles, a v1 code of
conduct, three proposals in different states with seven votes already
cast, an open incident, a project, three tasks, a KB entry, and matching
activity-log rows.

Replaces v0-generated test scaffolding with 266 real tests across
__tests__/{actions,auth-helpers,components,governance,permissions,
security,utils,validations}.test.ts. Adds react-markdown + remark-gfm
for proposal / incident / policy body rendering. Deletes four dead v0
fix-* scripts, the unused components/app-shell.tsx, and the duplicate
app/auth/login/page.tsx.

Routes (31 total): /api/health, /api/paypal/sync, /auth/callback, /,
/login, /signup, /signup/confirm, /dashboard, /tasks, /projects,
/members, /payments, /financials, /contacts, /ops, /ops/[id], /ops/new,
/proposals, /proposals/[id], /proposals/new, /incidents, /incidents/[id],
/incidents/new, /policies, /policies/[slug], /policies/new, /profile,
/recruitment, /settings, /comms, /import.

Full pass-by-pass history is in docs/HANDOFF.md; the roadmap is in
docs/GOVERNANCE_FEATURES.md.
This commit is contained in:
Moheeb Zara
2026-05-14 04:52:11 -07:00
parent 8b9128704b
commit ea8d7a5f91
99 changed files with 13823 additions and 1940 deletions
+108
View File
@@ -0,0 +1,108 @@
import Link from 'next/link'
import { redirect, notFound } from 'next/navigation'
import { createClient } from '@/lib/supabase/server'
import type { Policy } from '@/lib/types'
import { PolicyActions } from './policy-actions'
import { MarkdownBody } from '@/components/markdown'
export const dynamic = 'force-dynamic'
export default async function PolicyDetailPage({ params }: { params: Promise<{ slug: string }> }) {
const { slug } = await params
const supabase = await createClient()
const { data: { user } } = await supabase.auth.getUser()
if (!user) redirect('/login')
const { data: member } = await supabase
.from('space_members')
.select('space_id, role')
.eq('user_id', user.id)
.in('status', ['current', 'unverified', 'late'])
.maybeSingle()
if (!member?.space_id) redirect('/signup')
const { data: versionsRaw } = await supabase
.from('policies')
.select('*')
.eq('space_id', member.space_id)
.eq('slug', slug)
.order('version', { ascending: false })
const versions = (versionsRaw ?? []) as unknown as Policy[]
if (versions.length === 0) notFound()
// Pick the currently-active version, or the latest version, for the primary view.
const current = versions.find(p => p.status === 'active') ?? versions[0]
const isAdminOrBoard = member.role === 'admin' || member.role === 'board'
return (
<div className="min-h-screen bg-background">
<div className="bg-sidebar px-4 md:px-6 py-3 flex items-center gap-3">
<Link href="/policies" className="text-white/70 hover:text-white font-sans text-sm">
← Policies
</Link>
</div>
<div className="p-4 md:p-6 max-w-3xl space-y-6">
<header className="bg-card rounded border border-border p-5">
<h1 className="font-sans text-xl font-semibold text-foreground mb-1">{current.title}</h1>
<p className="font-mono text-[10px] text-muted-foreground">
{current.slug}
{current.section_ref ? ` · §${current.section_ref}` : ''}
{' · v'}{current.version}
{' · '}
{current.status}
{current.effective_at ? ` · effective ${new Date(current.effective_at).toLocaleDateString()}` : ''}
</p>
</header>
{current.body_plain && (
<section className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-2">
Plain language
</p>
<MarkdownBody content={current.body_plain} />
</section>
)}
<section className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-2">
Formal text
</p>
<MarkdownBody content={current.body_formal} />
</section>
{isAdminOrBoard && (
<PolicyActions policy={current} />
)}
<section className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Version history ({versions.length})
</p>
<ul className="divide-y divide-border">
{versions.map(v => (
<li key={v.id} className="py-2 flex items-center justify-between">
<div>
<p className="font-sans text-sm">v{v.version} · {v.status}</p>
<p className="font-mono text-[10px] text-muted-foreground">
created {new Date(v.created_at).toLocaleDateString()}
{v.effective_at ? ` · effective ${new Date(v.effective_at).toLocaleDateString()}` : ''}
{v.adopted_by_proposal_id ? (
<>
{' · '}
<Link href={`/proposals/${v.adopted_by_proposal_id}`} className="text-primary hover:underline">
adopted by proposal
</Link>
</>
) : ''}
</p>
</div>
</li>
))}
</ul>
</section>
</div>
</div>
)
}
@@ -0,0 +1,134 @@
'use client'
import { useState, useTransition } from 'react'
import { useRouter } from 'next/navigation'
import { supersedePolicy, updatePolicyStatus } from '@/lib/actions'
import { policyStatuses } from '@/lib/validations'
import type { Policy } from '@/lib/types'
export function PolicyActions({ policy }: { policy: Policy }) {
const router = useRouter()
const [isPending, startTransition] = useTransition()
const [error, setError] = useState('')
const [showSupersede, setShowSupersede] = useState(false)
const [newBody, setNewBody] = useState(policy.body_formal)
const [newPlain, setNewPlain] = useState(policy.body_plain ?? '')
function run<T>(fn: () => Promise<T>, after?: () => void) {
setError('')
startTransition(async () => {
const r = (await fn()) as unknown as { error?: string }
if (r && r.error) setError(r.error)
else after?.()
router.refresh()
})
}
return (
<div className="space-y-3">
<div className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Manage
</p>
<div className="flex flex-wrap gap-2">
{policy.status !== 'active' && (
<button
type="button"
disabled={isPending}
onClick={() => run(() => updatePolicyStatus(policy.id, 'active'))}
className="font-sans text-xs border border-border px-3 py-1.5 rounded hover:border-primary hover:text-primary"
>
Activate v{policy.version}
</button>
)}
{policy.status === 'active' && (
<>
<button
type="button"
onClick={() => setShowSupersede(s => !s)}
className="font-sans text-xs border border-border px-3 py-1.5 rounded hover:border-primary hover:text-primary"
>
{showSupersede ? 'Cancel supersede' : 'Supersede with new version'}
</button>
<button
type="button"
disabled={isPending}
onClick={() => run(() => updatePolicyStatus(policy.id, 'deprecated'))}
className="font-sans text-xs border border-border px-3 py-1.5 rounded hover:border-orange-500 hover:text-orange-600"
>
Deprecate
</button>
</>
)}
{policyStatuses
.filter(s => s !== policy.status && s !== 'active')
.map(s => (
<button
key={s}
type="button"
disabled={isPending}
onClick={() => run(() => updatePolicyStatus(policy.id, s))}
className="font-sans text-xs border border-border px-3 py-1.5 rounded text-muted-foreground hover:text-foreground"
>
Set {s}
</button>
))}
</div>
</div>
{showSupersede && (
<div className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Supersede v{policy.version} with v{policy.version + 1}
</p>
<div className="space-y-3">
<div>
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">
Plain language (optional)
</label>
<textarea
value={newPlain}
onChange={e => setNewPlain(e.target.value)}
rows={4}
maxLength={100000}
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
/>
</div>
<div>
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">
Formal text
</label>
<textarea
value={newBody}
onChange={e => setNewBody(e.target.value)}
rows={12}
maxLength={100000}
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
/>
</div>
<button
type="button"
disabled={isPending}
onClick={() =>
run(
() =>
supersedePolicy({
policyId: policy.id,
body_formal: newBody,
body_plain: newPlain || null,
}),
() => setShowSupersede(false),
)
}
className="bg-primary text-white font-sans text-sm font-medium px-4 py-2 rounded hover:bg-primary/90 transition disabled:opacity-50"
>
{isPending ? 'Creating draft...' : 'Create draft v' + (policy.version + 1)}
</button>
</div>
</div>
)}
{error && <p className="font-mono text-xs text-red-500">{error}</p>}
</div>
)
}
+135
View File
@@ -0,0 +1,135 @@
'use client'
import { useState } from 'react'
import { useRouter } from 'next/navigation'
import Link from 'next/link'
import { createPolicy } from '@/lib/actions'
export function NewPolicyForm() {
const router = useRouter()
const [slug, setSlug] = useState('')
const [title, setTitle] = useState('')
const [sectionRef, setSectionRef] = useState('')
const [bodyFormal, setBodyFormal] = useState('')
const [bodyPlain, setBodyPlain] = useState('')
const [error, setError] = useState('')
const [submitting, setSubmitting] = useState(false)
async function handleSubmit(e: React.FormEvent) {
e.preventDefault()
setSubmitting(true)
setError('')
const result = await createPolicy({
slug,
title,
section_ref: sectionRef || null,
body_formal: bodyFormal,
body_plain: bodyPlain || null,
})
if ('error' in result && result.error) {
setError(result.error)
setSubmitting(false)
return
}
router.push(`/policies/${slug}`)
}
return (
<form onSubmit={handleSubmit} className="space-y-5 bg-card rounded border border-border p-5">
<div className="grid md:grid-cols-2 gap-4">
<div>
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">
Slug
</label>
<input
type="text"
value={slug}
onChange={e => setSlug(e.target.value.toLowerCase().replace(/[^a-z0-9-]/g, ''))}
maxLength={80}
required
pattern="[a-z0-9-]+"
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
placeholder="bylaws"
/>
</div>
<div>
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">
Section reference (optional)
</label>
<input
type="text"
value={sectionRef}
onChange={e => setSectionRef(e.target.value)}
maxLength={80}
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
placeholder="Article III §2"
/>
</div>
</div>
<div>
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">
Title
</label>
<input
type="text"
value={title}
onChange={e => setTitle(e.target.value)}
maxLength={200}
required
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
placeholder="Bylaws"
/>
</div>
<div>
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">
Plain-language summary (optional)
</label>
<textarea
value={bodyPlain}
onChange={e => setBodyPlain(e.target.value)}
rows={4}
maxLength={100000}
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary"
placeholder="In short: be excellent to each other and pay your dues."
/>
</div>
<div>
<label className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase block mb-1">
Formal text
</label>
<textarea
value={bodyFormal}
onChange={e => setBodyFormal(e.target.value)}
rows={16}
maxLength={100000}
className="w-full bg-background border border-border text-foreground font-sans text-sm rounded px-3 py-2 focus:outline-none focus:border-primary font-mono"
placeholder="WHEREAS..."
/>
</div>
{error && <p className="font-mono text-xs text-red-500">{error}</p>}
<div className="flex items-center justify-end gap-3">
<Link
href="/policies"
className="font-sans text-sm text-muted-foreground hover:text-foreground"
>
Cancel
</Link>
<button
type="submit"
disabled={submitting || !slug.trim() || !title.trim()}
className="bg-primary text-white font-sans text-sm font-medium px-4 py-2 rounded hover:bg-primary/90 transition disabled:opacity-50"
>
{submitting ? 'Saving...' : 'Save as draft v1'}
</button>
</div>
</form>
)
}
+31
View File
@@ -0,0 +1,31 @@
import { redirect } from 'next/navigation'
import { createClient } from '@/lib/supabase/server'
import { NewPolicyForm } from './new-policy-form'
export const dynamic = 'force-dynamic'
export default async function NewPolicyPage() {
const supabase = await createClient()
const { data: { user } } = await supabase.auth.getUser()
if (!user) redirect('/login')
const { data: member } = await supabase
.from('space_members')
.select('space_id, role')
.eq('user_id', user.id)
.in('status', ['current', 'unverified', 'late'])
.maybeSingle()
if (!member?.space_id) redirect('/signup')
if (member.role !== 'admin' && member.role !== 'board') redirect('/policies')
return (
<div className="min-h-screen bg-background">
<div className="bg-sidebar px-4 md:px-6 py-3">
<h1 className="text-white font-sans text-lg font-semibold">New policy</h1>
</div>
<div className="p-4 md:p-6 max-w-2xl">
<NewPolicyForm />
</div>
</div>
)
}
+101
View File
@@ -0,0 +1,101 @@
import Link from 'next/link'
import { redirect } from 'next/navigation'
import { createClient } from '@/lib/supabase/server'
import type { Policy, PolicyStatus } from '@/lib/types'
export const dynamic = 'force-dynamic'
const STATUS_STYLE: Record<PolicyStatus, string> = {
draft: 'text-muted-foreground bg-muted',
active: 'text-primary bg-primary/10',
deprecated: 'text-orange-600 bg-orange-50',
superseded: 'text-muted-foreground bg-muted',
}
export default async function PoliciesPage() {
const supabase = await createClient()
const { data: { user } } = await supabase.auth.getUser()
if (!user) redirect('/login')
const { data: member } = await supabase
.from('space_members')
.select('space_id, role')
.eq('user_id', user.id)
.in('status', ['current', 'unverified', 'late'])
.maybeSingle()
if (!member?.space_id) redirect('/signup')
const { data: policiesRaw } = await supabase
.from('policies')
.select('*')
.eq('space_id', member.space_id)
.order('slug', { ascending: true })
.order('version', { ascending: false })
const all = (policiesRaw ?? []) as unknown as Policy[]
// For each slug, show the highest-version active row; fall back to highest-version overall.
const bySlug = new Map<string, Policy>()
for (const p of all) {
const existing = bySlug.get(p.slug)
if (!existing) bySlug.set(p.slug, p)
else if (p.status === 'active' && existing.status !== 'active') bySlug.set(p.slug, p)
else if (p.status === existing.status && p.version > existing.version) bySlug.set(p.slug, p)
}
const summary = Array.from(bySlug.values()).sort((a, b) => a.slug.localeCompare(b.slug))
const isAdminOrBoard = member.role === 'admin' || member.role === 'board'
return (
<div className="min-h-screen bg-background">
<div className="bg-sidebar px-4 md:px-6 py-3 flex items-center justify-between">
<h1 className="text-white font-sans text-lg font-semibold">Policies</h1>
{isAdminOrBoard && (
<Link
href="/policies/new"
className="bg-primary text-white text-xs font-sans px-3 py-1.5 rounded hover:bg-primary/90 transition"
>
New policy
</Link>
)}
</div>
<div className="p-4 md:p-6 max-w-4xl">
<div className="bg-card rounded border border-border divide-y divide-border">
{summary.length === 0 ? (
<div className="px-4 py-12 text-center">
<p className="font-sans text-sm text-muted-foreground mb-1">No policies yet.</p>
<p className="font-mono text-[10px] text-muted-foreground">
Bylaws, code of conduct, station rules. Each lives here with full version history.
</p>
</div>
) : (
summary.map(p => (
<Link
key={p.slug}
href={`/policies/${p.slug}`}
className="block px-4 py-3 hover:bg-muted transition"
>
<div className="flex items-start gap-3">
<div className="flex-1 min-w-0">
<div className="flex items-center gap-2 mb-1">
<p className="font-sans text-sm font-medium text-foreground truncate">{p.title}</p>
<span className={`font-mono text-[10px] tracking-widest uppercase px-1.5 py-0.5 rounded ${STATUS_STYLE[p.status]}`}>
{p.status}
</span>
</div>
<p className="font-mono text-[10px] text-muted-foreground">
{p.slug}
{p.section_ref ? ` · §${p.section_ref}` : ''}
{' · v'}{p.version}
</p>
</div>
</div>
</Link>
))
)}
</div>
</div>
</div>
)
}