Jakob Wennberg
ec27228a8e
Em dashes (—) and en dashes (–) had spread across comments, docs, tests, and a few UI strings, reading as AI-generated boilerplate rather than house style. Replaced each with punctuation matching its context: colon for explanatory clauses, comma for asides, plain hyphen for numeric/legal ranges (e.g. "21-23§"), "to"/"till" for date ranges, parentheses for paired-dash asides. messages/en.json and messages/sv.json were fixed by hand together to keep sv/en in sync. Left untouched where the dash is the functional subject rather than decorative punctuation: date-range-parser.ts's separator regex, charset-repair.ts's CP1252 byte-mapping table (and its test), the SIE encoding mojibake docs, generic-csv.ts's minus-sign normalizer, the agent system-prompt files that already instruct against em dashes, and a golden iXBRL test fixture compared byte-for-byte. Also fixes two bugs surfaced along the way: an off-by-one in ApiKeysPanel's scope-label split (a leftover from an earlier partial pass), and a charset-repair test that had lost the literal en-dash it exists to verify. Regenerated the agent atom seed migration (skills:generate) since 27 SKILL.md files changed. Added a CLAUDE.md rule against em/en dashes, with an explicit carve-out for the functional-dash cases above. Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
73 lines
3.3 KiB
TypeScript
73 lines
3.3 KiB
TypeScript
/**
|
|
* One-shot script that exports the registry-derived docs content (errors +
|
|
* reference) plus the static Connect-with-Claude page as TypeScript modules
|
|
* into the gnubok-website repo.
|
|
*
|
|
* Run with `npx tsx scripts/export-docs-to-website.mts`. Re-run whenever
|
|
* structured-errors, the v1 endpoint registry, or connect-claude materially
|
|
* changes.
|
|
*/
|
|
import { writeFileSync, mkdirSync } from 'node:fs'
|
|
import { dirname, resolve } from 'node:path'
|
|
|
|
const errors = await import('@/lib/docs/content/errors')
|
|
const reference = await import('@/lib/docs/content/reference')
|
|
const connectClaude = await import('@/lib/docs/content/connect-claude')
|
|
|
|
const buildErrorReferenceMd = errors.buildErrorReferenceMd ?? (errors as any).default?.buildErrorReferenceMd
|
|
const buildResourcePages = reference.buildResourcePages ?? (reference as any).default?.buildResourcePages
|
|
const buildReferenceOverviewMd = reference.buildReferenceOverviewMd ?? (reference as any).default?.buildReferenceOverviewMd
|
|
|
|
if (!buildErrorReferenceMd || !buildResourcePages || !buildReferenceOverviewMd) {
|
|
console.error('Missing builder exports. Inspect:', {
|
|
errorsKeys: Object.keys(errors),
|
|
referenceKeys: Object.keys(reference),
|
|
})
|
|
process.exit(1)
|
|
}
|
|
|
|
const WEBSITE = resolve('/Users/jakobwennberg/gnubok-website')
|
|
|
|
function write(rel: string, content: string) {
|
|
const out = resolve(WEBSITE, rel)
|
|
mkdirSync(dirname(out), { recursive: true })
|
|
writeFileSync(out, content)
|
|
console.log(`wrote ${out} (${content.length} chars)`)
|
|
}
|
|
|
|
const errorsMd = buildErrorReferenceMd()
|
|
write(
|
|
'lib/docs/content/errors.generated.ts',
|
|
`// AUTO-GENERATED from erp-base: do not hand-edit.\n// Regenerate via \`npx tsx scripts/export-docs-to-website.mts\` in erp-base.\nexport const ERRORS_MD = ${JSON.stringify(errorsMd)}\n`,
|
|
)
|
|
|
|
const refOverview = buildReferenceOverviewMd()
|
|
const refPages = buildResourcePages()
|
|
const slugs = refPages.map((p: { slug: string }) => p.slug)
|
|
|
|
const pagesPayload = refPages.map((p: { slug: string; label: string; description: string; markdown: string }) => ({
|
|
slug: p.slug,
|
|
label: p.label,
|
|
description: p.description,
|
|
markdown: p.markdown,
|
|
}))
|
|
|
|
write(
|
|
'lib/docs/content/reference.generated.ts',
|
|
`// AUTO-GENERATED from erp-base: do not hand-edit.\n// Regenerate via \`npx tsx scripts/export-docs-to-website.mts\` in erp-base.\n\nexport const REFERENCE_OVERVIEW_MD = ${JSON.stringify(refOverview)}\n\nexport interface ResourcePage {\n slug: string\n label: string\n description: string\n markdown: string\n}\n\nexport const RESOURCE_SLUGS: readonly string[] = ${JSON.stringify(
|
|
slugs,
|
|
)} as const\n\nexport const RESOURCE_PAGES: ResourcePage[] = ${JSON.stringify(pagesPayload, null, 2)}\n\nexport function findResourcePage(slug: string): ResourcePage | undefined {\n return RESOURCE_PAGES.find((p) => p.slug === slug)\n}\n`,
|
|
)
|
|
|
|
const connectClaudeMd = connectClaude.CONNECT_CLAUDE_MD
|
|
if (!connectClaudeMd) {
|
|
console.error('Missing CONNECT_CLAUDE_MD export. Inspect:', { connectClaudeKeys: Object.keys(connectClaude) })
|
|
process.exit(1)
|
|
}
|
|
write(
|
|
'lib/docs/content/connect-claude.generated.ts',
|
|
`// AUTO-GENERATED from erp-base: do not hand-edit.\n// Regenerate via \`npx tsx scripts/export-docs-to-website.mts\` in erp-base.\nexport const CONNECT_CLAUDE_MD = ${JSON.stringify(connectClaudeMd)}\n`,
|
|
)
|
|
|
|
console.log('done.')
|