Full-application audit (5 parallel read-only audits). Two agent
"blockers" were false alarms and verified as already-correct. Real
findings fixed:
- Self-escalation (BLOCKER): migration 024 + schema.sql section 16
extend prevent_member_self_role_change to also block a
non-privileged member changing their own tier_id (self tier
upgrade) and onboarding_completed_at (skipping required
code-of-conduct via a raw PostgREST call). finishOnboarding and
skipOnboarding now set onboarding_completed_at through the service
client AFTER their server-side required-steps check, so the
legitimate path is unaffected.
- Cross-tenant write scoping: added .eq('space_id', member.space_id)
to updateForumThread, deleteForumThread, editComment, deleteComment,
deleteChannel, renameChannel (RLS-only -> defence-in-depth).
- generateInviteCode: crypto.getRandomValues, widened to 8 chars
(was Math.random, ~21 bits, enumerable under the join rate limit).
- SafeMarkdown: dropped iframe and the global style attribute
(no unsandboxed embeds / UI-redress); markdown + safe HTML stay.
- /settings: server-side admin redirect before fetching space and
integration config (was client-hidden only).
- app/(app)/layout.tsx: export const dynamic = 'force-dynamic'.
- Bounded queries: loadComments .limit(500), tasks .limit(2000).
Backlog from the audit is tracked in HANDOFF (import Zod schemas,
types/database.ts + docs regen, email lowercasing, unauthorized-
handling consistency, KB-modal ACL hookup).
271/271 tests pass. Build clean. Migrations 023 + 024 idempotent,
apply via deploy.sh on next deploy.
8.4 KiB
8.4 KiB
Changelog
All notable changes to this project are documented here. Format follows Keep a Changelog and the project loosely follows Semantic Versioning.
[Unreleased]
Added
- Customizable permissions, per-item Ops ACLs, area-lead roles (migration 023, additive and backward compatible):
- Customize -> Permissions: a role x permission grid. Admin holds everything implicitly and cannot be locked out. Grants per built-in/custom role.
- Per-item access control on Ops secrets (and KB/processes via the same infra): pick which roles, multiple, can access an item. Empty = existing default visibility. Secrets/KB SELECT policies were rewritten as
existing-rule OR acl-match, so nothing changes until an admin sets an ACL. - Customize -> Area leads: create area-lead roles, see Vacant until assigned, assign/unassign a member from a picker. The assigned member effectively holds that role, so any Ops item whose access list includes it opens to them.
- SECURITY DEFINER helpers
user_effective_rolesanduser_has_permission.
Security
- Closed two member self-escalation paths: a non-privileged member can no longer change their own
tier_idoronboarding_completed_aton thespace_membersrow (migration 024 extends the self-change trigger). Onboarding completion now goes through the service client after server-side validation. - Added in-code space scoping to forum/comment/channel mutations (defence-in-depth on top of RLS).
- Invite codes are now cryptographically random and wider.
SafeMarkdownno longer allowsiframeor arbitrarystyle(no unsandboxed embeds or UI-redress)./settingsis gated server-side to admins before any space/integration data is fetched.
Fixed
revealSecretno longer silently returns the stale plaintext column when a row is marked encrypted but has no ciphertext; it surfaces the corruption instead.upsertAreaLeadrejects a null/empty area code (Postgres treats NULLs as distinct in unique constraints, which had allowed duplicate area-lead rows).
Changed
- Landing page rebuilt in the
/resourceseditorial aesthetic: scoped dark theme (IBM Plex Mono + Libre Baskerville, lime accent, faint grid), a server component (~150 lines, down from a 539-line client monolith), and split intocomponents/landing/*. Added a single-row resource showcase of six square tiles with the project SVG logos.
Fixed
- Knowledge base search no longer crashes the Ops page.
filteredLeadsreferenced a non-existentmember_namecolumn; the resultingundefined.toLowerCase()threw on every keystroke because the filter memos recompute on shared search state across tabs. All Ops filter predicates are now null-safe.
Added
docs/PERMISSIONS_DESIGN.md: design for customizable permissions, per-item Ops ACLs, and area-lead roles (next focused pass; security-sensitive RLS work, intentionally not bundled with UI changes).
Added (continued)
- Customize hub at
/customize(admin/board): a dedicated home for per-space customization with a section rail (Roles, Membership tiers, Areas, Invite codes, Onboarding), split into one focused module per panel. Replaces the overloaded Settings tab strip. - Roles editor: rename and recolor the five built-in roles, and create/edit/delete custom org-structure roles. Renamed roles now display (sidebar user card; helper
lib/role-labels.ts). - Invite share links: copy a one-click
/signup?invite=CODElink in addition to the bare code; the signup page prefills the code and preselects join mode from?invite=.
Changed
- Brand mark reverted to the terminal
>_glyph (components/brand-mark.tsx) across the landing nav/footer, onboarding header, and favicon.AtlasLogoremains only on the resources project page. - Settings slimmed to Space, Integrations, and Webhooks. Roles, Tiers, Areas, Invites, and Onboarding moved to
/customize.
Added (continued)
- Configurable member onboarding: a new member who joins via invite code is walked through an admin-defined sequence of steps at
/onboardingbefore reaching the app. Built-in step types: welcome, code of conduct (required acknowledgement), profile, dues/payment nudge. Admins can add custom content steps with sanitized markdown/HTML, reorder, enable/disable, and mark steps required from Settings -> Onboarding. Founders skip the member flow (their onboarding is space configuration). Existing members were backfilled as completed so nobody is trapped. Server-side enforcement of required steps. New tables:space_onboarding_steps; new columnsspace_members.onboarding_completed_atandonboarding_progress. SafeMarkdowncomponent (react-markdown + remark-gfm + rehype-raw + rehype-sanitize) for rendering admin-authored markdown/HTML without XSS.docs/UX_AND_PERSONAS.md: persona model and the UX audit that drove onboarding.bioadded to the self-service profile schema.- Forum at
/forum: top-level discussion threads with categories, pinning, locking. Author or admin/board can edit; admin can delete. - Polymorphic comment threads on proposals, incidents, and policies. New
commentstable keyed on(entity_type, entity_id). Renders markdown. - User-creatable chat channels: inline "+ New channel" form in
/comms(name, description, type). RLS now allows any member to create; default channels stay protected. - Custom membership tiers with prices: new
space_tierstable per space. Settings -> Tiers tab to list, create, edit (including inline price edit), archive, and delete custom tiers. Built-inplus/basic/associatetiers seed on space creation and on existing spaces via backfill.space_members.tier_idFK backfilled from the legacy enum. - Customizable role labels and custom org roles:
space_role_labels(rename/recolor built-ins per space) andspace_custom_roles(non-privileged extra labels) with member m2m. Server actions wired; UI surface pending in a follow-up. - Multi-code invites:
space_inviteswith per-code expiry, max-use cap, and enable/disable. Legacyspaces.invite_codebackfilled as a permanent enabled invite. Settings -> Invites tab to manage.joinSpacehonors any valid invite and incrementsuses_count. - Knowledge base markdown rendering: clicking a KB entry opens a modal that renders
contentas markdown via react-markdown + remark-gfm. - AtlasLogo as the brand mark: replaces the terminal icon on the landing nav and footer;
public/logo.svgis the favicon. - Live site link in
README.md: https://hackerspace.sh.
Changed
- Secrets vault is now encrypted at rest: AES-256-GCM with a per-secret IV using a
SECRETS_ENCRYPTION_KEYenv var. The /ops list endpoint no longer sends plaintext or ciphertext to the client. A newrevealSecret(id)server action is the only path to plaintext and writes asecret.revealedrow toactivity_log. Existing legacy plaintext rows continue to work.
Added (continued)
- Production deployment to a self-hosted DigitalOcean Droplet with automatic HTTPS via Caddy and Let's Encrypt.
- GitHub Actions workflow that pushes a deploy on every commit to
main. Migrations are applied automatically via_migrations_appliedtracking. - Daily encrypted
pg_dumpallbackup cron, retained 14 days, written to the persistent block volume. - Resend SMTP integration for transactional email (GoTrue).
- Open-source release scaffolding:
LICENSE(MIT),CONTRIBUTING.md,SECURITY.md,CHANGELOG.md, refreshedREADME.md,docs/WEBHOOKS.md. - GitHub repository link on the landing page.
- Webhook signing secret is now displayed in the settings UI with show/hide and copy-to-clipboard.
Changed
- Mobile responsiveness pass on the Kanban board, members table, payments table, proposal voting grids, and the landing mini board preview.
membersdirectory now respects themember_directory_visibilityspace setting for non-admin viewers.lib/actions/settings.tsnow persistsmission_statementalongside the rest of the space metadata.
Removed
@vercel/analyticsdependency and all references to Vercel hosting. The project is self-hosted on a Droplet.- Dead v0 codegen artifacts.
Fixed
- Auth container crash-loop on first boot caused by an empty
DISABLE_SIGNUPenv value. - Kong port-binding race that left
supabase.hackerspace.shreturning 502 after a fresh stack bring-up.
[0.1.0] - 2026-03-10
Initial pre-production cut. See docs/HANDOFF.md for the full session-by-session history of work prior to the open-source release.