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>
)
}