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
@@ -0,0 +1,190 @@
'use client'
import { useState, useTransition } from 'react'
import { useRouter } from 'next/navigation'
import Link from 'next/link'
import {
updateIncidentStatus,
addIncidentUpdate,
appealIncident,
} from '@/lib/actions'
import type { IncidentStatus } from '@/lib/types'
import { incidentStatuses, incidentUpdateVisibilities } from '@/lib/validations'
type Props = {
incidentId: string
status: IncidentStatus
isAdminOrBoard: boolean
isReporter: boolean
hasAppeal: boolean
appealProposalId: string | null
}
export function IncidentActions({
incidentId,
status,
isAdminOrBoard,
isReporter,
hasAppeal,
appealProposalId,
}: Props) {
const router = useRouter()
const [isPending, startTransition] = useTransition()
const [error, setError] = useState('')
// Add-update form
const [updateBody, setUpdateBody] = useState('')
const [updateVisibility, setUpdateVisibility] = useState<string>('all_parties')
// Status transition form (admin/board)
const [newStatus, setNewStatus] = useState<IncidentStatus>(status)
const [disposition, setDisposition] = useState('')
// Appeal form (reporter)
const [appealTitle, setAppealTitle] = useState('')
const [appealBody, setAppealBody] = useState('')
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()
})
}
const canAppeal = isReporter && status === 'decided' && !hasAppeal
return (
<div className="space-y-3">
{isAdminOrBoard && (
<div className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Update status
</p>
<div className="space-y-3">
<select
value={newStatus}
onChange={e => setNewStatus(e.target.value as IncidentStatus)}
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"
>
{incidentStatuses.map(s => (
<option key={s} value={s}>{s.replace(/_/g, ' ')}</option>
))}
</select>
{(newStatus === 'decided' || newStatus === 'closed') && (
<textarea
value={disposition}
onChange={e => setDisposition(e.target.value)}
rows={4}
maxLength={20000}
placeholder="Disposition / reasoning (visible to reporter)"
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"
/>
)}
<button
type="button"
disabled={isPending || newStatus === status}
onClick={() =>
run(() => updateIncidentStatus(incidentId, newStatus, disposition || null), () => setDisposition(''))
}
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 ? 'Saving...' : 'Apply status'}
</button>
</div>
</div>
)}
<div className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Post an update
</p>
<div className="space-y-3">
<textarea
value={updateBody}
onChange={e => setUpdateBody(e.target.value)}
rows={4}
maxLength={20000}
placeholder="Add information, ask a question, share a decision."
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"
/>
{isAdminOrBoard && (
<select
value={updateVisibility}
onChange={e => setUpdateVisibility(e.target.value)}
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"
>
{incidentUpdateVisibilities.map(v => (
<option key={v} value={v}>{v.replace(/_/g, ' ')}</option>
))}
</select>
)}
<button
type="button"
disabled={isPending || !updateBody.trim()}
onClick={() =>
run(
() => addIncidentUpdate({ incidentId, body: updateBody, visibility: updateVisibility }),
() => setUpdateBody(''),
)
}
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 ? 'Posting...' : 'Post update'}
</button>
</div>
</div>
{canAppeal && (
<div className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Request membership appeal
</p>
<p className="font-sans text-xs text-muted-foreground mb-3">
Creates a draft proposal that members can vote on. You will still need to open it
for voting; that gives you time to refine the language.
</p>
<div className="space-y-3">
<input
type="text"
value={appealTitle}
onChange={e => setAppealTitle(e.target.value)}
maxLength={200}
placeholder="Appeal of dismissed complaint"
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"
/>
<textarea
value={appealBody}
onChange={e => setAppealBody(e.target.value)}
rows={4}
maxLength={20000}
placeholder="Why the membership should overturn the board's decision."
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"
/>
<button
type="button"
disabled={isPending || !appealTitle.trim()}
onClick={() => run(() => appealIncident({ incidentId, title: appealTitle, body: appealBody }))}
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 ? 'Filing appeal...' : 'File appeal'}
</button>
</div>
</div>
)}
{hasAppeal && appealProposalId && (
<div className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-2">Appeal</p>
<Link href={`/proposals/${appealProposalId}`} className="font-sans text-sm text-primary hover:underline">
View the appeal proposal →
</Link>
</div>
)}
{error && <p className="font-mono text-xs text-red-500">{error}</p>}
</div>
)
}
+123
View File
@@ -0,0 +1,123 @@
import Link from 'next/link'
import { redirect, notFound } from 'next/navigation'
import { createClient } from '@/lib/supabase/server'
import type { Incident, IncidentUpdateRow } from '@/lib/types'
import { IncidentActions } from './incident-actions'
import { MarkdownBody } from '@/components/markdown'
export const dynamic = 'force-dynamic'
export default async function IncidentDetailPage({ params }: { params: Promise<{ id: string }> }) {
const { id } = 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('id, space_id, role, display_name')
.eq('user_id', user.id)
.in('status', ['current', 'unverified', 'late'])
.maybeSingle()
if (!member?.space_id) redirect('/signup')
const { data: incidentRaw } = await supabase
.from('incidents')
.select('*')
.eq('id', id)
.eq('space_id', member.space_id)
.maybeSingle()
if (!incidentRaw) notFound()
const incident = incidentRaw as unknown as Incident
const isAdminOrBoard = member.role === 'admin' || member.role === 'board'
const isReporter = incident.reporter_id === member.id
const { data: updatesRaw } = await supabase
.from('incident_updates')
.select('*')
.eq('incident_id', incident.id)
.order('created_at', { ascending: true })
const updates = (updatesRaw ?? []) as unknown as IncidentUpdateRow[]
const decisionMakers = incident.decision_maker_ids.length
? await supabase
.from('space_members')
.select('id, display_name')
.in('id', incident.decision_maker_ids)
: { data: [] as Array<{ id: string; display_name: string | null }> }
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="/incidents" className="text-white/70 hover:text-white font-sans text-sm">
← Incidents
</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-2">{incident.title}</h1>
<p className="font-mono text-[10px] text-muted-foreground mb-4">
{incident.category} · {incident.severity} · status: {incident.status.replace(/_/g, ' ')}
{incident.is_anonymous ? ' · filed anonymously' : ''}
{' · '}
filed {new Date(incident.created_at).toLocaleString()}
</p>
<MarkdownBody content={incident.body} />
</header>
{incident.disposition && (
<section className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Disposition
</p>
<MarkdownBody content={incident.disposition} />
{decisionMakers.data && decisionMakers.data.length > 0 && (
<p className="font-mono text-[10px] text-muted-foreground mt-3">
Decision: {decisionMakers.data.map(m => m.display_name ?? 'Unknown').join(', ')}
{incident.decided_at ? ` · ${new Date(incident.decided_at).toLocaleString()}` : ''}
</p>
)}
</section>
)}
<section className="bg-card rounded border border-border p-5">
<p className="font-mono text-[10px] tracking-widest text-muted-foreground uppercase mb-3">
Updates ({updates.length})
</p>
{updates.length === 0 ? (
<p className="font-sans text-sm text-muted-foreground">No updates posted yet.</p>
) : (
<ul className="divide-y divide-border">
{updates.map(u => (
<li key={u.id} className="py-3">
<div className="flex items-center gap-2 mb-1">
<span className="font-sans text-sm font-medium text-foreground">{u.author_name ?? 'Unknown'}</span>
<span className="font-mono text-[10px] text-muted-foreground">
{u.visibility.replace(/_/g, ' ')}
</span>
<span className="font-mono text-[10px] text-muted-foreground/60 ml-auto">
{new Date(u.created_at).toLocaleString()}
</span>
</div>
<MarkdownBody content={u.body} />
</li>
))}
</ul>
)}
</section>
<IncidentActions
incidentId={incident.id}
status={incident.status}
isAdminOrBoard={isAdminOrBoard}
isReporter={isReporter}
hasAppeal={incident.appeal_proposal_id !== null}
appealProposalId={incident.appeal_proposal_id}
/>
</div>
</div>
)
}