feat(transformer): add 'status' frontmatter field for section state (#90) (#91)

Transformer:
- Add SectionStatusSchema enum (active|repealed|reserved|omitted|transferred|renumbered)
- Add detectSectionStatus() function to derive status from heading text
- Generate status field in YAML frontmatter for every section
- Export new types and function

Content Collection:
- Add status field to schema with 'active' default for backwards compat

Frontend (statute + browse):
- Use entry.data.status as primary check with title-based fallback
- Eliminates fragile string matching as sole detection method
- Single source of truth for status in the transformer

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: williamzujkowski

apps/web/src/content.config.ts

@@ -11,6 +11,7 @@ const statutes = defineCollection({
     current_through: z.string(),
     classification: z.string(),
     generated_at: z.string().optional(),
+    status: z.enum(['active', 'repealed', 'reserved', 'omitted', 'transferred', 'renumbered']).default('active'),
   }),
 });
 

apps/web/src/pages/browse/[title]/[chapter].astro

@@ -66,11 +66,12 @@ const base = import.meta.env.BASE_URL;
     <ul class="divide-y divide-gray-200 rounded-lg border border-gray-200 dark:divide-gray-800 dark:border-gray-800">
       {sortedSections.map((entry) => {
         const sTitle = entry.data.title;
-        const isRepealed = sTitle.includes('Repealed');
-        const isReserved = sTitle.includes('Reserved');
-        const isOmitted = sTitle.includes('Omitted');
-        const isTransferred = sTitle.includes('Transferred') && !sTitle.includes('Transferred or reemployed');
-        const isRenumbered = sTitle.includes('Renumbered');
+        const status = entry.data.status ?? 'active';
+        const isRepealed = status === 'repealed' || sTitle.includes('Repealed');
+        const isReserved = status === 'reserved' || sTitle.includes('Reserved');
+        const isOmitted = status === 'omitted' || sTitle.includes('Omitted');
+        const isTransferred = status === 'transferred' || (sTitle.includes('Transferred') && !sTitle.includes('Transferred or reemployed'));
+        const isRenumbered = status === 'renumbered' || sTitle.includes('Renumbered');
         const isInactive = isRepealed || isReserved || isOmitted || isTransferred || isRenumbered;
         return (
           <li>

apps/web/src/pages/statute/[...slug].astro

@@ -62,12 +62,13 @@ const formattedDate = generated_at
   ? new Date(generated_at).toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' })
   : undefined;
 
-// Repealed / Reserved / Omitted / Transferred / Renumbered detection
-const isRepealed = entry.data.title.includes('Repealed');
-const isReserved = entry.data.title.includes('Reserved');
-const isOmitted = entry.data.title.includes('Omitted');
-const isTransferred = entry.data.title.includes('Transferred') && !entry.data.title.includes('Transferred or reemployed');
-const isRenumbered = entry.data.title.includes('Renumbered');
+// Section status — use frontmatter field with title-based fallback for pre-status data
+const status = entry.data.status ?? 'active';
+const isRepealed = status === 'repealed' || entry.data.title.includes('Repealed');
+const isReserved = status === 'reserved' || entry.data.title.includes('Reserved');
+const isOmitted = status === 'omitted' || entry.data.title.includes('Omitted');
+const isTransferred = status === 'transferred' || (entry.data.title.includes('Transferred') && !entry.data.title.includes('Transferred or reemployed'));
+const isRenumbered = status === 'renumbered' || entry.data.title.includes('Renumbered');
 ---
 
 <BaseLayout

packages/transformer/src/index.ts

@@ -10,8 +10,10 @@ export {
   nestingDepthFor,
   reformatInlineLists,
   FrontmatterSchema,
+  SectionStatusSchema,
+  detectSectionStatus,
 } from './markdown-generator.js';
-export type { Frontmatter, MarkdownFile } from './markdown-generator.js';
+export type { Frontmatter, MarkdownFile, SectionStatus } from './markdown-generator.js';
 export { USLM_ELEMENTS, USLM_NAMESPACE, INDENT_PER_LEVEL, MAX_NESTING_DEPTH } from './constants.js';
 export { createLogger } from '@civic-source/shared';
 export { extractTextFromNodes, findElements, getAttributes, getElementName } from './xml-utils.js';

packages/transformer/src/markdown-generator.ts

@@ -2,6 +2,13 @@ import { z } from 'zod';
 import { USLM_ELEMENTS, INDENT_PER_LEVEL, MAX_NESTING_DEPTH } from './constants.js';
 import { extractTextFromNodes, findElements } from './xml-utils.js';
 
+/** Section status — derived from heading text during transformation */
+export const SectionStatusSchema = z.enum([
+  'active', 'repealed', 'reserved', 'omitted', 'transferred', 'renumbered',
+]);
+
+export type SectionStatus = z.infer<typeof SectionStatusSchema>;
+
 /** Zod schema for YAML frontmatter validation */
 export const FrontmatterSchema = z.object({
   title: z.string().min(1),
@@ -11,10 +18,21 @@ export const FrontmatterSchema = z.object({
   current_through: z.string().default('Unknown'),
   classification: z.string().min(1),
   generated_at: z.string().min(1),
+  status: SectionStatusSchema.default('active'),
 });
 
 export type Frontmatter = z.infer<typeof FrontmatterSchema>;
 
+/** Detect section status from heading text */
+export function detectSectionStatus(heading: string): SectionStatus {
+  if (heading.includes('Repealed')) return 'repealed';
+  if (heading.includes('Reserved')) return 'reserved';
+  if (heading.includes('Omitted')) return 'omitted';
+  if (heading.includes('Renumbered')) return 'renumbered';
+  if (heading.includes('Transferred') && !heading.includes('Transferred or reemployed')) return 'transferred';
+  return 'active';
+}
+
 /** A generated markdown file with its path and content */
 export interface MarkdownFile {
   /** Relative path: statutes/title-{n}/chapter-{n}/section-{n}.md */
@@ -139,6 +157,7 @@ export function generateFrontmatter(data: Frontmatter): string {
     `current_through: "${data.current_through}"`,
     `classification: "${data.classification}"`,
     `generated_at: "${data.generated_at}"`,
+    `status: "${data.status}"`,
     '---',
     '',
   ];
@@ -282,14 +301,16 @@ export function generateMarkdownForSection(
   const uscTitle = parseInt(titleNum, 10) || 0;
   const chapterInt = parseInt(chapterNum, 10) || 0;
 
+  const sectionTitle = `Section ${sectionNum}${heading ? ' - ' + heading : ''}`;
   const frontmatter = FrontmatterSchema.parse({
-    title: `Section ${sectionNum}${heading ? ' - ' + heading : ''}`,
+    title: sectionTitle,
     usc_title: Math.max(uscTitle, 1),
     usc_section: sectionNum,
     chapter: chapterInt,
     current_through: currentThrough || 'Unknown',
     classification: `${titleNum} U.S.C. \u00A7 ${sectionNum}`,
     generated_at: now,
+    status: detectSectionStatus(sectionTitle),
   });
 
   let body = generateSectionBody(sectionChildren);