@shanyucoder/flowgrid 0.1.0

package/adapters/nuxt4/codegen/runners/lib/naming.mjs

@@ -0,0 +1,246 @@
+/**
+ * Naming helpers for portal-gen (entity hotel → Hotel, hotels, useHotelList).
+ */
+
+import { feLayoutForProfile } from '../../../../shared/fe-layout-profiles.mjs'
+
+export function toPascalCase(value) {
+  return String(value)
+    .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ''))
+    .replace(/^(.)/, (m) => m.toUpperCase())
+}
+
+export function toCamelCase(value) {
+  const pascal = toPascalCase(value)
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1)
+}
+
+export function toKebabCase(value) {
+  return String(value)
+    .replace(/([a-z])([A-Z])/g, '$1-$2')
+    .replace(/[\s_]+/g, '-')
+    .toLowerCase()
+}
+
+export function pluralize(entity) {
+  if (entity.endsWith('y') && !/[aeiou]y$/i.test(entity)) {
+    return `${entity.slice(0, -1)}ies`
+  }
+  if (entity.endsWith('s')) return entity
+  return `${entity}s`
+}
+
+/**
+ * Resolve filesystem / type namespace so chain-hotel and admin hotel do not collide.
+ * Priority: codegen.namespace → distinct codegen.module → codegen.entity
+ */
+export function resolveCodegenNamespace(codegen = {}) {
+  if (codegen.namespace) {
+    return toKebabCase(codegen.namespace)
+  }
+
+  const entityKebab = toKebabCase(codegen.entity ?? 'entity')
+  const moduleKebab = codegen.module ? toKebabCase(codegen.module) : pluralize(entityKebab)
+  const entityPlural = pluralize(entityKebab)
+
+  if (moduleKebab !== entityPlural) {
+    if (moduleKebab.endsWith('s')) {
+      return moduleKebab.slice(0, -1)
+    }
+    return moduleKebab
+  }
+
+  return entityKebab
+}
+
+/**
+ * Build prototype mock rows from list endpoint response.data[0] when present.
+ * @param {Record<string, unknown>} spec
+ */
+export function buildMockRowsFromSpec(spec, title = 'Item') {
+  const listEp = listEndpoint(spec)
+  const sample = listEp?.response?.data?.[0]
+  if (!sample || typeof sample !== 'object' || isOpenApiShape(sample)) {
+    return [
+      { id: 1, name: `${title} A`, managers: [{ id: 101, full_name: 'Manager A' }] },
+      { id: 2, name: `${title} B`, managers: [{ id: 102, full_name: 'Manager B' }] },
+      { id: 3, name: `${title} C`, managers: [{ id: 103, full_name: 'Manager C' }] }
+    ]
+  }
+
+  const clone = (suffix) => hydrateMockRow(sample, title, suffix)
+  return [clone(1), clone(2), clone(3)]
+}
+
+function isOpenApiShape(sample) {
+  return Object.values(sample).some((value) => {
+    if (typeof value === 'string') {
+      return ['number', 'string', 'boolean'].includes(value) || value.includes('|')
+    }
+    if (Array.isArray(value) && value[0] && typeof value[0] === 'object') {
+      return isOpenApiShape(value[0])
+    }
+    return false
+  })
+}
+
+function hydrateMockRow(sample, title, suffix) {
+  const row = {}
+
+  for (const [key, value] of Object.entries(sample)) {
+    if (key === 'id') {
+      row.id = suffix
+      continue
+    }
+    if (key === 'name') {
+      row.name = `${title} ${String.fromCharCode(64 + suffix)}`
+      continue
+    }
+    if (key === 'managers' && Array.isArray(value)) {
+      row.managers = value.map((manager, index) => ({
+        id: suffix * 10 + index + 1,
+        full_name: `Manager ${String.fromCharCode(64 + suffix)}${index + 1}`
+      }))
+      continue
+    }
+    if (typeof value === 'string') {
+      row[key] = value.includes('|') ? null : value
+      continue
+    }
+    row[key] = value
+  }
+
+  return row
+}
+
+export function routeToPagePath(routePath, profile) {
+  const layout = feLayoutForProfile(profile)
+  const trimmed = String(routePath ?? '').replace(/^\//, '').replace(/\/$/, '')
+  if (layout === 'root') {
+    return String(profile).trim() === 'not-found' ? 'pages/not-found.vue' : 'pages/error.vue'
+  }
+  if (layout === 'dashboard') {
+    return trimmed ? `pages/${trimmed}/index.vue` : 'pages/index.vue'
+  }
+  const group = layout
+  if (!trimmed) return `pages/(${group})/index.vue`
+  return `pages/(${group})/${trimmed}/index.vue`
+}
+
+export function zodFieldForColumn(column) {
+  const key = column.key
+  if (key === 'id') return 'fields.id'
+  if (key === 'email') return 'fields.email'
+  if (key === 'status') return 'fields.status.optional()'
+  if (key === 'managers') {
+    return 'z.array(z.object({ id: fields.id, full_name: fields.optionalNullableString }))'
+  }
+  if (key.endsWith('_at') || key.includes('date')) return 'fields.createdAt'
+  if (column.type === 'number') return 'z.number()'
+  return 'fields.optionalNullableString'
+}
+
+export function zodFieldForFormField(field, commonMessages = {}) {
+  const schema = buildFormFieldSchema(field, commonMessages)
+  return schema
+}
+
+function buildFormFieldSchema(field = {}, commonMessages = {}) {
+  if (field.key === 'email') return applyNullability('fields.email', field)
+
+  let schema = baseFieldSchema(field)
+  schema = applyValidation(schema, field, commonMessages)
+  schema = applyNullability(schema, field)
+  return schema
+}
+
+function baseFieldSchema(field) {
+  const kind = baseFieldKind(field)
+
+  if (kind === 'number') return 'z.coerce.number().int()'
+  if (kind === 'boolean') return 'z.boolean()'
+  if (kind === 'array') return 'z.array(z.union([z.string(), z.number()]))'
+  return 'z.string()'
+}
+
+function baseFieldKind(field) {
+  const type = String(field.type ?? '').toLowerCase()
+  const widget = String(field.widget ?? '').toLowerCase()
+
+  if (type === 'int' || widget === 'number') return 'number'
+  if (type === 'bool' || widget === 'checkbox' || widget === 'switch') return 'boolean'
+  if (type === 'array' || widget === 'multiselect') return 'array'
+  if (type === 'date') return 'string'
+  return 'string'
+}
+
+function applyValidation(schema, field, commonMessages = {}) {
+  const validation = field.validation ?? {}
+  const kind = baseFieldKind(field)
+  const requiredMessage = messageFor(field, 'required', commonMessages)
+
+  let out = schema
+
+  if (field.required && kind === 'string') {
+    out = `z.string().min(1${requiredMessage ? `, { message: ${JSON.stringify(requiredMessage)} }` : ''})`
+  }
+
+  if (typeof validation.minLength === 'number' && kind === 'string') {
+    const msg = messageFor(field, 'minLength', commonMessages)
+    out = `${out}.min(${validation.minLength}${msg ? `, { message: ${JSON.stringify(msg)} }` : ''})`
+  }
+
+  if (typeof validation.maxLength === 'number' && kind === 'string') {
+    const msg = messageFor(field, 'maxLength', commonMessages)
+    out = `${out}.max(${validation.maxLength}${msg ? `, { message: ${JSON.stringify(msg)} }` : ''})`
+  }
+
+  if (typeof validation.pattern === 'string' && kind === 'string') {
+    const msg = messageFor(field, 'pattern', commonMessages)
+    out = `${out}.regex(new RegExp(${JSON.stringify(validation.pattern)})${msg ? `, { message: ${JSON.stringify(msg)} }` : ''})`
+  }
+
+  if (typeof validation.min === 'number' && (kind === 'number' || kind === 'array')) {
+    const msg = messageFor(field, 'min', commonMessages)
+    out = `${out}.min(${validation.min}${msg ? `, { message: ${JSON.stringify(msg)} }` : ''})`
+  }
+
+  if (typeof validation.max === 'number' && (kind === 'number' || kind === 'array')) {
+    const msg = messageFor(field, 'max', commonMessages)
+    out = `${out}.max(${validation.max}${msg ? `, { message: ${JSON.stringify(msg)} }` : ''})`
+  }
+
+  if (field.required && kind === 'array') {
+    const minMsg = requiredMessage ? `, { message: ${JSON.stringify(requiredMessage)} }` : ''
+    out = `${out}.min(1${minMsg})`
+  }
+
+  return out
+}
+
+function applyNullability(schema, field) {
+  let out = schema
+  if (field.nullable) out += '.nullable()'
+  if (!field.required) out += '.optional()'
+  return out
+}
+
+function messageFor(field, key, commonMessages = {}) {
+  const fieldMessages = field.messages ?? {}
+  const value = fieldMessages[key] ?? commonMessages[key]
+  return typeof value === 'string' && value.trim() ? value.trim() : ''
+}
+
+export function listEndpoint(spec) {
+  const endpoints = spec.api?.endpoints ?? []
+  return (
+    endpoints.find((e) => e.action === 'list') ??
+    endpoints.find((e) => /search|list/i.test(e.path ?? '')) ??
+    endpoints[0]
+  )
+}
+
+export function createEndpoint(spec) {
+  const endpoints = spec.api?.endpoints ?? []
+  return endpoints.find((e) => e.action === 'create') ?? endpoints.find((e) => e.method === 'POST')
+}

package/adapters/nuxt4/codegen/runners/lib/page-lifecycle.mjs

@@ -0,0 +1,254 @@
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises'
+import path from 'node:path'
+
+export const REGISTRY_REL = 'registries/page-lifecycle.registry.json'
+const DOC_REL = 'docs/operational/PAGE-LIFECYCLE.md'
+const STAGE_ORDER = ['design-spec', 'prototype', 'test', 'wire']
+
+/**
+ * pages/hotels/index.vue → /hotels
+ * @param {string} relativePagePath
+ */
+export function routePathFromPageFile(relativePagePath) {
+  const normalized = relativePagePath.replace(/\\/g, '/')
+  if (normalized === 'pages/not-found.vue') return '/404'
+  if (normalized === 'pages/error.vue') return '/error'
+  const match = normalized.match(/^pages\/(?:\((?:auth|public)\)\/)?(.+)\/index\.vue$/)
+  if (!match) return null
+  return `/${match[1]}`
+}
+
+export function normalizeRoutePath(routePath) {
+  if (!routePath) return '/'
+  const trimmed = routePath.trim()
+  if (trimmed === '/') return '/'
+  return trimmed.startsWith('/') ? trimmed.replace(/\/$/, '') || '/' : `/${trimmed}`
+}
+
+/**
+ * @param {string} requested
+ * @param {string | undefined} existingStage
+ * @param {{ allowDowngrade?: boolean }} options
+ */
+export function resolveLifecycleStage(requested, existingStage, options = {}) {
+  if (!existingStage) return requested
+  if (options.allowDowngrade) return requested
+
+  const reqIdx = STAGE_ORDER.indexOf(requested)
+  const curIdx = STAGE_ORDER.indexOf(existingStage)
+  if (reqIdx === -1) return existingStage
+  if (curIdx === -1) return requested
+  return curIdx > reqIdx ? existingStage : requested
+}
+
+async function loadRegistry(root) {
+  const registryPath = path.join(root, REGISTRY_REL)
+  try {
+    return { data: JSON.parse(await readFile(registryPath, 'utf8')), registryPath }
+  } catch {
+    return { data: { routes: {} }, registryPath }
+  }
+}
+
+async function saveRegistry(root, data) {
+  const registryPath = path.join(root, REGISTRY_REL)
+  await mkdir(path.dirname(registryPath), { recursive: true })
+  await writeFile(registryPath, `${JSON.stringify(data, null, 2)}\n`, 'utf8')
+  await renderPageLifecycleDoc(root, data)
+  return registryPath
+}
+
+/**
+ * @param {string} root
+ * @param {{ routePath: string, specFile?: string, title?: string, stage?: string, note?: string, allowDowngrade?: boolean }} entry
+ */
+export async function upsertPageLifecycle(root, entry) {
+  const { data } = await loadRegistry(root)
+  const routePath = normalizeRoutePath(entry.routePath)
+  const existing = data.routes[routePath]
+  const stage = resolveLifecycleStage(entry.stage ?? 'prototype', existing?.stage, {
+    allowDowngrade: entry.allowDowngrade
+  })
+
+  data.routes[routePath] = {
+    stage,
+    spec:
+      !entry.specFile || entry.specFile === 'manual'
+        ? (existing?.spec ?? entry.specFile)
+        : entry.specFile.replace(/\\/g, '/'),
+    title: entry.title ?? existing?.title,
+    updatedAt: new Date().toISOString(),
+    note: entry.note ?? existing?.note
+  }
+
+  await saveRegistry(root, data)
+  return { registryPath: REGISTRY_REL, routePath, stage }
+}
+
+/**
+ * Hạ stage sau portal:remove — mặc định design-spec (chưa có prototype).
+ * @param {string} root
+ * @param {string} routePath
+ * @param {{ specFile?: string, note?: string }} meta
+ */
+export async function demotePageLifecycle(root, routePath, meta = {}) {
+  return upsertPageLifecycle(root, {
+    routePath,
+    specFile: meta.specFile ?? 'manual',
+    stage: 'design-spec',
+    allowDowngrade: true,
+    note: meta.note ?? 'Prototype code removed — chạy portal:gen để tạo lại.'
+  })
+}
+
+/**
+ * Đồng bộ registry từ mọi codegen.manifest.json + kiểm tra page còn trên disk.
+ * @param {string} root
+ */
+export async function syncPageLifecycleFromManifests(root) {
+  const { data } = await loadRegistry(root)
+  const manifests = await listManifestFiles(root)
+  const touched = new Set()
+
+  for (const manifestPath of manifests) {
+    const manifest = JSON.parse(await readFile(manifestPath, 'utf8'))
+    const pageEntry = manifest.files?.find((f) => f.layer === 'page')
+    if (!pageEntry?.path) continue
+
+    const routePath = routePathFromPageFile(pageEntry.path)
+    if (!routePath) continue
+
+    touched.add(routePath)
+    const pageExists = await fileExists(path.join(root, pageEntry.path))
+    const existing = data.routes[routePath]
+    const stage = pageExists
+      ? resolveLifecycleStage('prototype', existing?.stage)
+      : resolveLifecycleStage('design-spec', existing?.stage, { allowDowngrade: true })
+
+    data.routes[routePath] = {
+      stage,
+      spec: manifest.specFile?.replace(/\\/g, '/') ?? existing?.spec ?? 'unknown',
+      title: existing?.title,
+      updatedAt: new Date().toISOString(),
+      note: pageExists ? existing?.note : 'Page file missing — sync demoted to design-spec.'
+    }
+  }
+
+  for (const [routePath, entry] of Object.entries(data.routes)) {
+    if (touched.has(routePath)) continue
+    if (entry.stage !== 'prototype') continue
+
+    const specFileAbs = entry.spec ? path.join(root, entry.spec) : null
+    const specDir = specFileAbs ? path.dirname(specFileAbs) : null
+    const featureDir = specDir ? (path.basename(specDir) === 'ir' ? path.dirname(specDir) : specDir) : null
+    const manifestPath = featureDir ? path.join(featureDir, 'generated', 'codegen.manifest.json') : null
+    const manifest = manifestPath && (await fileExists(manifestPath))
+      ? JSON.parse(await readFile(manifestPath, 'utf8'))
+      : null
+    const pagePath = manifest?.files?.find((f) => f.layer === 'page')?.path
+    const pageExists = pagePath ? await fileExists(path.join(root, pagePath)) : false
+
+    if (!pageExists) {
+      data.routes[routePath] = {
+        ...entry,
+        stage: 'design-spec',
+        updatedAt: new Date().toISOString(),
+        note: 'Prototype page removed — sync demoted to design-spec.'
+      }
+    }
+  }
+
+  await saveRegistry(root, data)
+  return { updated: Object.keys(data.routes).length, manifests: manifests.length }
+}
+
+async function listManifestFiles(root) {
+  const files = []
+  const featuresDir = path.join(root, 'surfaces')
+
+  async function walk(dir) {
+    let entries = []
+    try {
+      entries = await readdir(dir, { withFileTypes: true })
+    } catch {
+      return
+    }
+
+    for (const entry of entries) {
+      const entryPath = path.join(dir, entry.name)
+      if (entry.isDirectory()) {
+        await walk(entryPath)
+        continue
+      }
+      if (entry.name === 'codegen.manifest.json') {
+        files.push(entryPath)
+      }
+    }
+  }
+
+  await walk(featuresDir)
+  return files.sort()
+}
+
+async function fileExists(filePath) {
+  try {
+    await readFile(filePath)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * @param {string} root
+ * @param {{ routes: Record<string, { stage: string, spec: string, title?: string, updatedAt: string, note?: string }> }} data
+ */
+export async function renderPageLifecycleDoc(root, data) {
+  const rows = Object.entries(data.routes)
+    .sort(([a], [b]) => a.localeCompare(b))
+    .map(([route, entry]) => {
+      const auth = entry.stage === 'wire' ? 'required' : 'bypass'
+      const note = entry.note ? ` ${entry.note}` : ''
+      return `| ${route} | ${entry.stage} | ${auth} | \`${entry.spec}\` | ${entry.title ?? '—'} | ${entry.updatedAt.slice(0, 10)} |${note ? '' : ''}`
+    })
+
+  const markdown = `# Page lifecycle registry
+
+Nguồn máy đọc: \`registries/page-lifecycle.registry.json\`.
+
+**Tự cập nhật:** \`portal:gen\` → \`prototype\`; \`portal:remove\` → \`design-spec\`; \`pnpm portal:lifecycle sync\` quét manifest + page trên disk.
+
+## Bước chính (không ghi sub-step)
+
+| Stage | Ý nghĩa | Auth trên dev |
+|-------|---------|---------------|
+| \`design-spec\` | Spec/testcase có; chưa có prototype code | bypass |
+| \`prototype\` | UI + mock API (\`portal:gen\`) | bypass |
+| \`test\` | E2E/unit pass (vẫn mock API) | bypass |
+| \`wire\` | Ghép API thật xong | **required** |
+
+**Quy tắc:** \`stage\` = bước cao nhất đã đạt. Sửa spec / re-grill không tự hạ stage. \`portal:remove\` hoặc \`lifecycle sync\` (page mất) hạ về \`design-spec\`.
+
+\`\`\`bash
+pnpm portal:lifecycle sync
+pnpm portal:lifecycle set /hotels test
+pnpm portal:remove --spec docs/features/.../feature.spec.yaml
+\`\`\`
+
+## Routes
+
+| Path | Stage | Auth | Spec | Title | Updated |
+|------|-------|------|------|-------|---------|
+${rows.length ? rows.join('\n') : '| _—_ | — | — | — | — | — |'}
+
+## Liên quan
+
+- Auth bypass: mọi stage **trừ** \`wire\` — \`middleware/auth.global.ts\`
+- Xóa code: \`pnpm portal:remove --spec <file>\`
+- Session handoff: \`.harness/progress.md\`
+`
+
+  const docPath = path.join(root, DOC_REL)
+  await mkdir(path.dirname(docPath), { recursive: true })
+  await writeFile(docPath, markdown, 'utf8')
+}