@elevasis/core 0.12.0 → 0.14.0

package/src/scaffold-registry/index.ts

@@ -142,9 +142,7 @@ export function compileScaffoldRegistry(): ScaffoldRegistry {
 
   const emptySources = findEmptySourcePatterns(registry, root)
   if (emptySources.length > 0) {
-    const formatted = emptySources
-      .map((source) => `  [${source.entryId}] ${source.pattern}`)
-      .join('\n')
+    const formatted = emptySources.map((source) => `  [${source.entryId}] ${source.pattern}`).join('\n')
     throw new Error(
       `scaffold-registry: ${emptySources.length} source pattern(s) match no files or directories:\n${formatted}\n` +
         `Fix the stale source glob, create the scaffold surface, or add explicit registry support for intentional empty patterns.`
@@ -235,14 +233,17 @@ export function loadScaffoldRegistryFast(): ScaffoldRegistry {
 
 /**
  * Return all entries whose `sources` contain at least one pattern that matches
- * the given file path. Pattern matching is a simple substring/glob-prefix check
- * suitable for hook use; Step 3 will upgrade to full micromatch when the hook
- * is implemented.
+ * the given file path AND whose `excludes` contain no pattern that matches.
+ * Pattern matching is a simple substring/glob-prefix check suitable for hook
+ * use; Step 3 will upgrade to full micromatch when the hook is implemented.
  */
 export function findMatchingEntries(registry: ScaffoldRegistry, filePath: string): ScaffoldRegistryEntry[] {
-  return registry.entries.filter((entry) =>
-    entry.sources.some((pattern) => scaffoldPathMatchesPattern(filePath, pattern))
-  )
+  return registry.entries.filter((entry) => {
+    const sourceMatch = entry.sources.some((pattern) => scaffoldPathMatchesPattern(filePath, pattern))
+    if (!sourceMatch) return false
+    const excluded = (entry.excludes ?? []).some((pattern) => scaffoldPathMatchesPattern(filePath, pattern))
+    return !excluded
+  })
 }
 
 // ---------------------------------------------------------------------------

package/src/scaffold-registry/schema.ts

@@ -1,25 +1,19 @@
-import { z } from 'zod'
-
-// ---------------------------------------------------------------------------
-// Kind taxonomy
-// ---------------------------------------------------------------------------
-
-/**
- * The kind of scaffold entry:
- *
- * - autogen: fully derivable from source; regen command is the fix
- * - manual-scaffold: hand-authored structure that must be updated on source change
+import { z } from 'zod'
+
+// ---------------------------------------------------------------------------
+// Kind taxonomy
+// ---------------------------------------------------------------------------
+
+/**
+ * The kind of scaffold entry:
+ *
+ * - autogen: fully derivable from source; regen command is the fix
+ * - manual-scaffold: hand-authored structure that must be updated on source change
  * - sync-preservation: external-template files with a declared sync tier
  * - validator: drift-detection scripts or CI checks (meta.json pages[] validators, etc.)
  * - other: escape hatch; requires free-form notes
  */
-export const ScaffoldEntryKindSchema = z.enum([
-  'autogen',
-  'manual-scaffold',
-  'sync-preservation',
-  'validator',
-  'other'
-])
+export const ScaffoldEntryKindSchema = z.enum(['autogen', 'manual-scaffold', 'sync-preservation', 'validator', 'other'])
 
 export type ScaffoldEntryKind = z.infer<typeof ScaffoldEntryKindSchema>
 
@@ -55,35 +49,35 @@ export type ExternalSyncStrategy = z.infer<typeof ExternalSyncStrategySchema>
 export const ExternalSyncDeletePolicySchema = z.enum(['none', 'manifest-only'])
 
 export type ExternalSyncDeletePolicy = z.infer<typeof ExternalSyncDeletePolicySchema>
-
-// ---------------------------------------------------------------------------
-// Scaffold reference (a single downstream artifact that needs attention)
-// ---------------------------------------------------------------------------
-
-export const ScaffoldRefSchema = z.object({
-  /**
-   * File path, glob, or symbolic target (e.g. "docs: sync-preservation-matrix").
-   * Symbolic targets begin with "docs:" or "autogen-target:".
-   */
-  path: z.string().min(1),
-
-  /**
-   * Command to regenerate, or "manual" if human judgment is required.
-   */
-  regen: z.string().min(1).optional(),
-
+
+// ---------------------------------------------------------------------------
+// Scaffold reference (a single downstream artifact that needs attention)
+// ---------------------------------------------------------------------------
+
+export const ScaffoldRefSchema = z.object({
+  /**
+   * File path, glob, or symbolic target (e.g. "docs: sync-preservation-matrix").
+   * Symbolic targets begin with "docs:" or "autogen-target:".
+   */
+  path: z.string().min(1),
+
+  /**
+   * Command to regenerate, or "manual" if human judgment is required.
+   */
+  regen: z.string().min(1).optional(),
+
   /**
    * Human-readable hint shown in reminder messages.
    */
-  hint: z.string().optional()
-})
-
-export type ScaffoldRef = z.infer<typeof ScaffoldRefSchema>
-
-// ---------------------------------------------------------------------------
-// Registry entry
-// ---------------------------------------------------------------------------
-
+  hint: z.string().optional()
+})
+
+export type ScaffoldRef = z.infer<typeof ScaffoldRefSchema>
+
+// ---------------------------------------------------------------------------
+// Registry entry
+// ---------------------------------------------------------------------------
+
 export const ScaffoldRegistryEntrySchema = z
   .object({
     /**
@@ -106,6 +100,18 @@ export const ScaffoldRegistryEntrySchema = z
      */
     sources: z.array(z.string().min(1)).min(1, 'At least one source pattern is required'),
 
+    /**
+     * Optional glob patterns that suppress this entry's reminder when the
+     * touched file matches. Applied after `sources`: a path that matches any
+     * `sources` pattern AND any `excludes` pattern is treated as no-match.
+     *
+     * Use case: a broad source glob (e.g. `apps/docs/content/docs/**\/*.mdx`)
+     * that should not fire on a sub-tree where the dependent scaffold does not
+     * apply (e.g. `apps/docs/content/docs/in-progress/**`, where MDX docs do
+     * not take meta.json files).
+     */
+    excludes: z.array(z.string().min(1)).optional(),
+
     /**
      * Downstream artifacts that need attention when a source changes.
      */
@@ -217,21 +223,21 @@ export const ScaffoldRegistryEntrySchema = z
       }
     }
   })
-
-export type ScaffoldRegistryEntry = z.infer<typeof ScaffoldRegistryEntrySchema>
-
-// ---------------------------------------------------------------------------
-// Top-level registry document
-// ---------------------------------------------------------------------------
-
-export const ScaffoldRegistrySchema = z.object({
-  /**
-   * Schema version for forward-compatibility detection.
-   * Bump when the shape changes in a breaking way.
-   */
-  version: z.string().default('1'),
-
-  entries: z.array(ScaffoldRegistryEntrySchema).min(1)
-})
-
-export type ScaffoldRegistry = z.infer<typeof ScaffoldRegistrySchema>
+
+export type ScaffoldRegistryEntry = z.infer<typeof ScaffoldRegistryEntrySchema>
+
+// ---------------------------------------------------------------------------
+// Top-level registry document
+// ---------------------------------------------------------------------------
+
+export const ScaffoldRegistrySchema = z.object({
+  /**
+   * Schema version for forward-compatibility detection.
+   * Bump when the shape changes in a breaking way.
+   */
+  version: z.string().default('1'),
+
+  entries: z.array(ScaffoldRegistryEntrySchema).min(1)
+})
+
+export type ScaffoldRegistry = z.infer<typeof ScaffoldRegistrySchema>