@mnstry/atelier 0.2.0-alpha.1 → 0.2.0-alpha.11

package/src/server/local-sidecar.mjs

@@ -5,9 +5,17 @@ import fs from 'node:fs'
 import http from 'node:http'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
+import {
+  atomicReplacePrivateText,
+  ensureContainedPrivateDirectory,
+  readRegularTextNoFollow,
+} from '../project/private-state.mjs'
 import {
   expectedOriginForRequest,
   htmlDocumentHeaders,
+  isLoopbackHost,
+  loadPublishedWorkspaceManifest,
+  publishedStaticPathVerdict,
   requestHeader,
   resolveWorkspacePath,
   staticHeaders,
@@ -22,6 +30,10 @@ import {
   renderProposalListPageHtml,
 } from '../ui/html-primitives.mjs'
 
+import { createReviewStore } from '../collaboration/review-store.mjs'
+import { loadBoundRun, currentRunEligibility } from '../readiness-protocols/evidence.mjs'
+import { renderReviewPage } from '../ui/review-page.mjs'
+
 export const ATELIER_CONTEXT_SCHEMA = 'atelier-context@v1'
 export const ATELIER_PRESENCE_SCHEMA = 'atelier-presence@v1'
 export const ATELIER_RESOLVE_SCHEMA = 'atelier-resolve@v1'
@@ -43,39 +55,37 @@ function nowMs() {
 
 function readJsonFile(file, fallback) {
   try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'))
+    return JSON.parse(readRegularTextNoFollow(file))
   } catch {
     return fallback
   }
 }
 
 function secureWriteJson(file, payload, mode = 0o600) {
-  fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 })
-  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`
-  fs.writeFileSync(tmp, `${JSON.stringify(payload, null, 2)}\n`, { mode })
-  fs.renameSync(tmp, file)
-  try {
-    fs.chmodSync(file, mode)
-  } catch {
-    // Best effort on filesystems that do not support chmod.
-  }
+  atomicReplacePrivateText(file, `${JSON.stringify(payload, null, 2)}\n`, mode)
 }
 
 function readOrCreateNonce(noncePath) {
-  const existing = fs.existsSync(noncePath) ? fs.readFileSync(noncePath, 'utf8').trim() : ''
+  let existing = ''
+  if (fs.existsSync(noncePath)) {
+    const stat = fs.lstatSync(noncePath)
+    if (!stat.isFile()) throw new Error('nonce state leaf is not a regular file')
+    existing = readRegularTextNoFollow(noncePath).trim()
+  }
   if (/^[a-f0-9]{64}$/.test(existing)) return existing
   const nonce = crypto.randomBytes(32).toString('hex')
-  fs.writeFileSync(noncePath, `${nonce}\n`, { mode: 0o600 })
+  atomicReplacePrivateText(noncePath, `${nonce}\n`)
   return nonce
 }
 
-function json(res, code, obj) {
+function json(res, code, obj, headers = {}) {
   const body = Buffer.from(`${JSON.stringify(obj, null, 2)}\n`)
   res.writeHead(code, {
     'Content-Type': 'application/json; charset=utf-8',
     'Content-Length': String(body.length),
     'Cache-Control': 'no-store',
     'X-Content-Type-Options': 'nosniff',
+    ...headers,
   })
   res.end(body)
 }
@@ -200,21 +210,40 @@ function doctorEnvelope() {
 export function createAtelierSidecarServer({
   workspaceRoot = process.cwd(),
   stateDir = workspaceRoot,
+  reviewProject = null,
   port = 0,
   presenceTtlMs = Number(process.env.ATELIER_PRESENCE_TTL_MS || 5 * 60 * 1000),
 } = {}) {
   const root = path.resolve(workspaceRoot)
   const rootReal = fs.realpathSync(root)
+  const stateDirReal = ensureContainedPrivateDirectory({
+    workspaceRoot: root,
+    directory: stateDir,
+    label: 'Atelier state directory',
+  })
+  const publication = loadPublishedWorkspaceManifest(root)
+  const review = reviewProject ? createReviewStore(reviewProject) : null
   const workspaceId = workspaceIdForRoot(root)
-  const noncePath = path.join(stateDir, '.atelier-nonce')
-  const presencePath = path.join(stateDir, '.atelier-presence.json')
+  const noncePath = path.join(stateDirReal, '.atelier-nonce')
+  const presencePath = path.join(stateDirReal, '.atelier-presence.json')
   const mutationNonce = readOrCreateNonce(noncePath)
   const proposals = createProposalStore({
     workspaceRoot: root,
-    proposalsDir: path.join(stateDir, '.atelier-proposals'),
+    proposalsDir: path.join(stateDirReal, '.atelier-proposals'),
     workspaceId,
   })
 
+  function resolvePublishedPath({ rel, requireFile = false, requireHtml = false } = {}) {
+    const resolved = resolveWorkspacePath({
+      workspaceRoot: root,
+      workspaceRootReal: rootReal,
+      rel,
+      requireFile,
+      requireHtml,
+    })
+    return publishedStaticPathVerdict({ resolved, publication })
+  }
+
   function readPresence() {
     const presence = readJsonFile(presencePath, defaultPresence())
     return {
@@ -229,12 +258,7 @@ export function createAtelierSidecarServer({
   }
 
   function recordView(rel, hints = {}) {
-    const resolved = resolveWorkspacePath({
-      workspaceRoot: root,
-      workspaceRootReal: rootReal,
-      rel,
-      requireHtml: true,
-    })
+    const resolved = resolvePublishedPath({ rel, requireHtml: true })
     if (!resolved.ok) return { ok: false, error: 'unknown workspace html file' }
     const entry = {
       sessionId: cleanIdentity(hints.sessionId, 120),
@@ -295,12 +319,7 @@ export function createAtelierSidecarServer({
     const viewId = cleanIdentity(url.searchParams.get('viewId'), 120)
     const rel = cleanIdentity(url.searchParams.get('path') || 'index.html', 500)
     const expectedWorkspaceId = cleanIdentity(url.searchParams.get('expectedWorkspaceId'), 120)
-    const resolved = resolveWorkspacePath({
-      workspaceRoot: root,
-      workspaceRootReal: rootReal,
-      rel,
-      requireHtml: true,
-    })
+    const resolved = resolvePublishedPath({ rel, requireHtml: true })
     const current = resolveCurrentContext({ sessionId })
     const workspaceVerified = Boolean(expectedWorkspaceId && expectedWorkspaceId === workspaceId)
     const caps = capabilityContract()
@@ -353,12 +372,31 @@ export function createAtelierSidecarServer({
       json(res, 400, { ok: false, error: error.message })
       return
     }
+    // Browsers send Origin on POST; same-origin GET normally omits it. Keep
+    // the strict origin gate for nonce disclosure instead of relaxing the
+    // existing session-auth GET contract or accepting unclassified reads.
+    if (review && url.pathname === '/api/review/session') {
+      if (!trustedMutationRequest(req.headers) || !body || Array.isArray(body) || Object.keys(body).length) {
+        json(res, 403, { ok: false, error: 'review session requires a same-origin empty request' })
+        return
+      }
+      const published = resolvePublishedPath({ rel: 'index.html', requireHtml: true })
+      if (!published.ok) { json(res, 404, { ok: false, error: 'published workspace unavailable' }); return }
+      json(res, 200, { ok: true, schema: ATELIER_SESSION_AUTH_SCHEMA, workspaceId, mutationNonce })
+      return
+    }
     const auth = requireMutationAuth(req, body, mutationNonce)
     if (!auth.ok) {
       json(res, auth.status, { ok: false, error: auth.error })
       return
     }
 
+    if (review && url.pathname === '/api/review/contributions') {
+      const result = review.contribute(body)
+      json(res, result.status, result)
+      return
+    }
+
     if (url.pathname === '/api/seen') {
       const result = recordView(body.rel || body.path, body)
       json(res, 200, result.ok ? { ok: true, entry: result.entry } : result)
@@ -366,12 +404,7 @@ export function createAtelierSidecarServer({
     }
 
     if (url.pathname === '/api/proposals') {
-      const resolved = resolveWorkspacePath({
-        workspaceRoot: root,
-        workspaceRootReal: rootReal,
-        rel: body.path || body.rel,
-        requireHtml: true,
-      })
+      const resolved = resolvePublishedPath({ rel: body.path || body.rel, requireHtml: true })
       if (!resolved.ok) {
         json(res, 200, { ok: false, error: 'unknown workspace html file' })
         return
@@ -392,6 +425,7 @@ export function createAtelierSidecarServer({
         schema: result.record.schema,
         workspaceId,
         proposal: result.record.proposal,
+        diagnostics: result.diagnostics,
       })
       return
     }
@@ -416,6 +450,7 @@ export function createAtelierSidecarServer({
         proposal: result.record.proposal,
         diff: result.record.diff,
         copyable: result.record.copyable,
+        diagnostics: result.diagnostics,
       })
       return
     }
@@ -430,12 +465,7 @@ export function createAtelierSidecarServer({
     }
 
     const rel = url.pathname === '/' ? 'index.html' : url.pathname.slice(1)
-    const resolved = resolveWorkspacePath({
-      workspaceRoot: root,
-      workspaceRootReal: rootReal,
-      rel,
-      requireFile: true,
-    })
+    const resolved = resolvePublishedPath({ rel, requireFile: true })
     if (!resolved.ok) {
       text(res, resolved.status || 403, `${resolved.error || 'forbidden'}\n`)
       return
@@ -463,11 +493,40 @@ export function createAtelierSidecarServer({
       return
     }
 
+    if (!['GET', 'HEAD', 'POST'].includes(req.method || '')) {
+      json(res, 405, { ok: false, error: 'method not allowed' }, { Allow: 'GET, HEAD, POST' })
+      return
+    }
+
+    if (!trustedReadRequest(req.headers, { expectedOrigin })) {
+      json(res, 403, { ok: false, error: 'cross-origin or unclassified request refused' })
+      return
+    }
+
     if (req.method === 'POST') {
       await handlePost(req, res, url)
       return
     }
 
+    if (review && url.pathname === '/review') {
+      const body = renderReviewPage()
+      res.writeHead(200, htmlDocumentHeaders(Buffer.byteLength(body)))
+      res.end(body)
+      return
+    }
+    if (review && url.pathname.startsWith('/api/review/')) {
+      let result
+      if (url.pathname === '/api/review/records') result = review.records()
+      else if (url.pathname === '/api/review/document') result = review.document(url.searchParams.get('repo'), url.searchParams.get('path'))
+      else if (url.pathname === '/api/review/run') {
+        const bound = loadBoundRun(reviewProject, url.searchParams.get('id'))
+        result = bound.ok ? {...bound, current:currentRunEligibility(reviewProject,bound)} : bound
+      } else if (url.pathname === '/api/review/handoff') result = review.handoff(url.searchParams.get('id'))
+      else result = {ok:false,status:404,error:'unknown review action'}
+      json(res, result.status, result)
+      return
+    }
+
     if (url.pathname === '/api/health') {
       json(res, 200, { ok: true, workspaceId })
       return
@@ -478,12 +537,7 @@ export function createAtelierSidecarServer({
         return
       }
       const rel = url.searchParams.get('path') || 'index.html'
-      const resolved = resolveWorkspacePath({
-        workspaceRoot: root,
-        workspaceRootReal: rootReal,
-        rel,
-        requireHtml: true,
-      })
+      const resolved = resolvePublishedPath({ rel, requireHtml: true })
       if (!resolved.ok) {
         json(res, 404, { ok: false, error: 'unknown workspace html file' })
         return
@@ -509,12 +563,7 @@ export function createAtelierSidecarServer({
       return
     }
     if (url.pathname === '/api/resolve') {
-      const resolved = resolveWorkspacePath({
-        workspaceRoot: root,
-        workspaceRootReal: rootReal,
-        rel: url.searchParams.get('path') || 'index.html',
-        requireHtml: true,
-      })
+      const resolved = resolvePublishedPath({ rel: url.searchParams.get('path') || 'index.html', requireHtml: true })
       json(res, resolved.ok ? 200 : (resolved.status || 404), {
         ok: resolved.ok,
         schema: ATELIER_RESOLVE_SCHEMA,
@@ -533,37 +582,49 @@ export function createAtelierSidecarServer({
       return
     }
     if (url.pathname === '/api/proposals') {
+      const listed = proposals.listProposals()
+      if (!listed.ok) {
+        json(res, listed.status, { ok: false, error: listed.error, diagnostics: listed.diagnostics })
+        return
+      }
       json(res, 200, {
         ok: true,
         schema: 'atelier-proposals@v1',
         workspaceId,
-        proposals: proposals.listProposals(),
+        proposals: listed.proposals,
       })
       return
     }
     const proposalReadMatch = url.pathname.match(/^\/api\/proposals\/([^/]+)$/)
     if (proposalReadMatch) {
-      const record = proposals.readProposal(proposalReadMatch[1])
-      json(res, record ? 200 : 404, record ? {
+      const result = proposals.readProposal(proposalReadMatch[1])
+      const record = result.record
+      json(res, result.ok ? 200 : result.status, result.ok ? {
         ok: true,
         schema: record.schema,
         workspaceId,
         proposal: record.proposal,
         diff: record.diff,
         copyable: record.copyable,
-      } : { ok: false, error: 'proposal not found' })
+      } : { ok: false, error: result.error, diagnostics: result.diagnostics })
       return
     }
     if (url.pathname === '/proposals') {
-      const body = renderProposalListPageHtml(proposals.listProposals())
+      const listed = proposals.listProposals()
+      if (!listed.ok) {
+        text(res, listed.status, `${listed.error}\n`)
+        return
+      }
+      const body = renderProposalListPageHtml(listed.proposals)
       res.writeHead(200, htmlDocumentHeaders(Buffer.byteLength(body)))
       res.end(body)
       return
     }
     const proposalPageMatch = url.pathname.match(/^\/proposals\/([^/]+)$/)
     if (proposalPageMatch) {
-      const body = renderProposalDetailPageHtml(proposals.readProposal(proposalPageMatch[1]))
-      res.writeHead(200, htmlDocumentHeaders(Buffer.byteLength(body)))
+      const result = proposals.readProposal(proposalPageMatch[1])
+      const body = renderProposalDetailPageHtml(result.record)
+      res.writeHead(result.ok ? 200 : result.status, htmlDocumentHeaders(Buffer.byteLength(body)))
       res.end(body)
       return
     }
@@ -595,8 +656,12 @@ export function createAtelierSidecarServer({
     workspaceRootReal: rootReal,
     workspaceId,
     mutationNonce,
+    publication,
     proposals,
     listen(listenPort = port, host = '127.0.0.1') {
+      if (!isLoopbackHost(host)) {
+        return Promise.reject(new Error(`non-loopback listen host refused: ${host}`))
+      }
       // A busy port is an ordinary condition, not a crash: surface it as a
       // rejection the CLI can print, instead of an unhandled 'error' event.
       return new Promise((resolve, reject) => {
@@ -615,6 +680,7 @@ export function createAtelierSidecarServer({
       })
     },
     close() {
+      if (!server.listening) return Promise.resolve()
       return new Promise((resolve, reject) => {
         server.close((error) => {
           if (error) reject(error)

package/src/server/security.mjs

@@ -37,6 +37,9 @@ export const LOOPBACK_HOSTS = new Set([
   '[::1]',
 ])
 
+export const ATELIER_MANIFEST_SCHEMA = 'mnstry.atelier-manifest@v1'
+export const PUBLISHED_STATIC_EXTENSIONS = new Set(['.html', '.js', '.mjs', '.css', '.svg', '.png', '.jpg', '.jpeg', '.webp'])
+
 export function parseHostHeader(value) {
   const raw = String(value || '').trim().toLowerCase()
   if (!raw) return ''
@@ -66,7 +69,7 @@ export function expectedOriginForRequest(headers, fallbackPort = null) {
 }
 
 export function sameOrigin(origin, expectedOrigin) {
-  if (!origin) return true
+  if (!origin) return false
   if (!expectedOrigin) return false
   try {
     return new URL(origin).origin === new URL(expectedOrigin).origin
@@ -77,7 +80,7 @@ export function sameOrigin(origin, expectedOrigin) {
 
 export function trustedFetchSite(headers) {
   const value = requestHeader(headers, 'sec-fetch-site').toLowerCase()
-  return value === '' || value === 'none' || value === 'same-origin' || value === 'same-site'
+  return value === 'none' || value === 'same-origin'
 }
 
 export function trustedHost(headers) {
@@ -85,11 +88,92 @@ export function trustedHost(headers) {
 }
 
 export function trustedReadRequest(headers, { expectedOrigin = expectedOriginForRequest(headers) } = {}) {
-  return trustedHost(headers) && sameOrigin(requestHeader(headers, 'origin'), expectedOrigin)
+  const origin = requestHeader(headers, 'origin')
+  return trustedHost(headers) && trustedFetchSite(headers) && (!origin || sameOrigin(origin, expectedOrigin))
 }
 
 export function trustedMutationRequest(headers, { expectedOrigin = expectedOriginForRequest(headers) } = {}) {
-  return trustedReadRequest(headers, { expectedOrigin }) && trustedFetchSite(headers)
+  const origin = requestHeader(headers, 'origin')
+  return Boolean(origin) && trustedReadRequest(headers, { expectedOrigin }) && sameOrigin(origin, expectedOrigin)
+}
+
+function manifestPathValue(value) {
+  if (typeof value === 'string') return value
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return ''
+  return value.path || value.output || value.href || ''
+}
+
+function secretShapedPath(value) {
+  return /(?:^|[._-])(?:secret|credential|token|password|nonce|private[._-]?key)(?:$|[._-])/i.test(value)
+    || /(?:^|\/)\.env(?:\.|$)/i.test(value)
+}
+
+function addManifestPath(paths, value, label) {
+  const candidate = manifestPathValue(value)
+  const normalized = normalizeWorkspacePath(candidate, { defaultFile: '' })
+  if (!candidate || !normalized.ok || /^[a-z][a-z0-9+.-]*:/i.test(candidate)) {
+    throw new Error(`atelier.manifest.json ${label} must be a workspace-relative path`)
+  }
+  if (deniedStaticStatePath(normalized.path) || normalized.path.split('/').some((segment) => segment.startsWith('.')) || secretShapedPath(normalized.path)) {
+    throw new Error(`atelier.manifest.json ${label} enrolls a hidden, state, or secret-shaped path`)
+  }
+  if (!PUBLISHED_STATIC_EXTENSIONS.has(path.extname(normalized.path).toLowerCase())) {
+    throw new Error(`atelier.manifest.json ${label} enrolls an unsupported static file type`)
+  }
+  paths.add(normalized.path)
+}
+
+export function loadPublishedWorkspaceManifest(workspaceRoot) {
+  const root = path.resolve(workspaceRoot)
+  const rootReal = fs.realpathSync(root)
+  const manifestPath = path.join(root, 'atelier.manifest.json')
+  if (!fs.existsSync(manifestPath)) throw new Error('served workspace must contain generated atelier.manifest.json')
+  const manifestReal = fs.realpathSync(manifestPath)
+  if (!pathContainedBy(rootReal, manifestReal)) throw new Error('atelier.manifest.json realpath escapes served workspace')
+  let manifest
+  try {
+    manifest = JSON.parse(fs.readFileSync(manifestReal, 'utf8'))
+  } catch (error) {
+    throw new Error(`atelier.manifest.json must be valid JSON: ${error.message}`)
+  }
+  if (manifest?.schema !== ATELIER_MANIFEST_SCHEMA) {
+    throw new Error(`atelier.manifest.json schema must be ${ATELIER_MANIFEST_SCHEMA}`)
+  }
+  const paths = new Set()
+  if (typeof manifest.entry !== 'string') throw new Error('atelier.manifest.json entry must be a workspace-relative HTML path')
+  addManifestPath(paths, manifest.entry, 'entry')
+  if (path.extname(manifest.entry).toLowerCase() !== '.html') throw new Error('atelier.manifest.json entry must be an HTML file')
+  for (const key of ['files', 'assets']) {
+    if (manifest[key] == null) continue
+    if (!Array.isArray(manifest[key])) throw new Error(`atelier.manifest.json ${key} must be an array`)
+    for (const [index, value] of manifest[key].entries()) addManifestPath(paths, value, `${key}[${index}]`)
+  }
+  for (const rel of paths) {
+    const resolved = resolveWorkspacePath({ workspaceRoot: root, workspaceRootReal: rootReal, rel, requireFile: true })
+    if (!resolved.ok) throw new Error(`atelier.manifest.json enrolled path is unavailable: ${rel}`)
+    const realRel = path.relative(rootReal, resolved.real).replaceAll('\\', '/')
+    if (realRel !== rel) throw new Error(`atelier.manifest.json enrolled path must not be a symlink: ${rel}`)
+  }
+  return Object.freeze({ manifest, manifestPath: manifestReal, paths })
+}
+
+export function publishedStaticPathVerdict({ resolved, publication } = {}) {
+  if (!resolved?.ok) return resolved
+  const realRel = path.relative(resolved.workspaceRootReal, resolved.real).replaceAll('\\', '/')
+  const segments = realRel.split('/')
+  if (segments.some((segment) => segment.startsWith('.')) || deniedStaticStatePath(realRel)) {
+    return { ok: false, status: 403, error: 'hidden or local state path is not published', path: resolved.path }
+  }
+  if (realRel === 'atelier.manifest.json' || secretShapedPath(realRel)) {
+    return { ok: false, status: 403, error: 'secret-shaped path is not published', path: resolved.path }
+  }
+  if (!PUBLISHED_STATIC_EXTENSIONS.has(path.extname(realRel).toLowerCase())) {
+    return { ok: false, status: 403, error: 'static file type is not published', path: resolved.path }
+  }
+  if (!publication?.paths?.has(realRel)) {
+    return { ok: false, status: 404, error: 'path is not enrolled by atelier.manifest.json', path: resolved.path }
+  }
+  return resolved
 }
 
 export function pathContainedBy(root, candidate) {
@@ -191,6 +275,7 @@ export function resolveWorkspacePath({
     real,
     stat,
     workspaceContained: true,
+    workspaceRootReal,
   }
 }
 

package/src/server/server.mjs

@@ -17,6 +17,7 @@ export async function runServerCommand(argv = process.argv.slice(2)) {
   const sidecar = createAtelierSidecarServer({
     workspaceRoot: project.outputRoot,
     stateDir: project.outputRoot,
+    reviewProject: argv.includes('--review') ? project : null,
     // argv > PORT env > default. Supervisors that assign a free port (preview
     // panes, dev harnesses) pass it via PORT, and an Atelier that ignores that
     // fights whatever already holds the canonical port instead of coexisting.
@@ -26,11 +27,12 @@ export async function runServerCommand(argv = process.argv.slice(2)) {
   if (args.smoke) {
     const address = await sidecar.listen()
     const base = `http://127.0.0.1:${address.port}`
+    const headers = { Origin: base, 'Sec-Fetch-Site': 'same-origin' }
     // @atelier-egress-local-computed
-    const health = await fetch(`${base}/api/health`).then((res) => res.json())
+    const health = await fetch(`${base}/api/health`, { headers }).then((res) => res.json())
     if (!health.ok) throw new Error('health check failed')
     // @atelier-egress-local-computed
-    const page = await fetch(`${base}/index.html`).then((res) => res.text())
+    const page = await fetch(`${base}/`, { headers }).then((res) => res.text())
     if (!page.includes('<meta name="mnstry:atelier"')) throw new Error('projection smoke failed')
     await sidecar.close()
     console.log('[atelier:browser:smoke] local projection and health endpoint passed')