@elevasis/core 0.6.0 → 0.7.0

package/src/scaffold-registry/schema.ts

@@ -0,0 +1,144 @@
+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
+ * - typed-id: typed-ID constants that encode semantic naming decisions
+ * - sync-preservation: external-template files with a declared sync tier
+ * - vibe-gated: paths protected by the pre-edit-vibe-gate hook
+ * - sdk-cli-generator: SDK CLI generators (generate-docs-index, generate-resources, etc.)
+ * - 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',
+  'typed-id',
+  'sync-preservation',
+  'vibe-gated',
+  'sdk-cli-generator',
+  'validator',
+  'other'
+])
+
+export type ScaffoldEntryKind = z.infer<typeof ScaffoldEntryKindSchema>
+
+// ---------------------------------------------------------------------------
+// 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(),
+
+  /**
+   * Optionally narrow the kind of this specific scaffold reference, when it
+   * differs from the parent entry's kind.
+   */
+  kind: ScaffoldEntryKindSchema.optional(),
+
+  /**
+   * Human-readable hint shown in reminder messages.
+   */
+  hint: z.string().optional()
+})
+
+export type ScaffoldRef = z.infer<typeof ScaffoldRefSchema>
+
+// ---------------------------------------------------------------------------
+// Registry entry
+// ---------------------------------------------------------------------------
+
+export const ScaffoldRegistryEntrySchema = z.object({
+  /**
+   * Stable slug identifier for this entry (kebab-case).
+   * Referenced by hooks, CI checks, and the /scaffold verify skill.
+   */
+  id: z
+    .string()
+    .min(1)
+    .regex(/^[a-z0-9-]+$/, 'id must be kebab-case'),
+
+  /**
+   * The primary kind of this entry.
+   */
+  kind: ScaffoldEntryKindSchema,
+
+  /**
+   * Glob patterns (or exact paths) that, when edited, should trigger a
+   * reminder for the associated scaffolds. Uses micromatch / glob semantics.
+   */
+  sources: z.array(z.string().min(1)).min(1, 'At least one source pattern is required'),
+
+  /**
+   * Downstream artifacts that need attention when a source changes.
+   */
+  dependents: z.array(ScaffoldRefSchema).min(1, 'At least one dependent is required'),
+
+  /**
+   * Package or app path that owns this scaffold surface.
+   * Examples: "packages/core", "apps/api", "external/_template"
+   */
+  owner: z.string().min(1),
+
+  /**
+   * Free-form notes. Required when kind is "other".
+   */
+  notes: z.string().optional(),
+
+  /**
+   * The shell command used to regenerate this entry's outputs.
+   *
+   * Required for `kind: autogen` entries once Step 6 migration lands.
+   * Optional now so harness scaffolding (Step 5) can land before migrating
+   * existing generators. Validated as a non-empty string when present.
+   *
+   * Example: `"pnpm navigation:generate"`, `"pnpm scaffold:sync"`
+   */
+  regen: z.string().min(1).optional(),
+
+  /**
+   * Per-entry reminder throttle override in milliseconds.
+   * Defaults to the hook-level default (5 minutes = 300_000 ms) when omitted.
+   */
+  cooldown_ms: z.number().int().positive().optional(),
+
+  /**
+   * When true, the PostToolUse reminder hook will automatically run the `regen`
+   * command after emitting the reminder, rather than just advising the user.
+   * Defaults to false (advisory only). Only meaningful when `regen` is also set.
+   */
+  auto_regen: z.boolean().optional()
+})
+
+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>

package/src/supabase/database.types.ts

@@ -1267,10 +1267,8 @@ export type Database = {
       }
       deployments: {
         Row: {
-          compiled_docs: Json | null
           created_at: string
           deployment_version: string | null
-          documentation: Json | null
           error_message: string | null
           id: string
           organization_id: string
@@ -1282,10 +1280,8 @@ export type Database = {
           updated_at: string
         }
         Insert: {
-          compiled_docs?: Json | null
           created_at?: string
           deployment_version?: string | null
-          documentation?: Json | null
           error_message?: string | null
           id?: string
           organization_id: string
@@ -1297,10 +1293,8 @@ export type Database = {
           updated_at?: string
         }
         Update: {
-          compiled_docs?: Json | null
           created_at?: string
           deployment_version?: string | null
-          documentation?: Json | null
           error_message?: string | null
           id?: string
           organization_id?: string
@@ -1812,6 +1806,13 @@ export type Database = {
           updated_at?: string
         }
         Relationships: [
+          {
+            foreignKeyName: "fk_milestones_project"
+            columns: ["project_id"]
+            isOneToOne: false
+            referencedRelation: "prj_projects"
+            referencedColumns: ["id"]
+          },
           {
             foreignKeyName: "prj_milestones_organization_id_fkey"
             columns: ["organization_id"]
@@ -1872,6 +1873,34 @@ export type Database = {
           type?: string
         }
         Relationships: [
+          {
+            foreignKeyName: "fk_notes_created_by"
+            columns: ["created_by"]
+            isOneToOne: false
+            referencedRelation: "users"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "fk_notes_milestone"
+            columns: ["milestone_id"]
+            isOneToOne: false
+            referencedRelation: "prj_milestones"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "fk_notes_project"
+            columns: ["project_id"]
+            isOneToOne: false
+            referencedRelation: "prj_projects"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "fk_notes_task"
+            columns: ["task_id"]
+            isOneToOne: false
+            referencedRelation: "prj_tasks"
+            referencedColumns: ["id"]
+          },
           {
             foreignKeyName: "prj_notes_created_by_fkey"
             columns: ["created_by"]
@@ -1962,6 +1991,20 @@ export type Database = {
           updated_at?: string
         }
         Relationships: [
+          {
+            foreignKeyName: "fk_projects_company"
+            columns: ["client_company_id"]
+            isOneToOne: false
+            referencedRelation: "acq_companies"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "fk_projects_deal"
+            columns: ["deal_id"]
+            isOneToOne: false
+            referencedRelation: "acq_deals"
+            referencedColumns: ["id"]
+          },
           {
             foreignKeyName: "prj_projects_client_company_id_fkey"
             columns: ["client_company_id"]
@@ -2044,6 +2087,27 @@ export type Database = {
           updated_at?: string
         }
         Relationships: [
+          {
+            foreignKeyName: "fk_tasks_milestone"
+            columns: ["milestone_id"]
+            isOneToOne: false
+            referencedRelation: "prj_milestones"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "fk_tasks_parent"
+            columns: ["parent_task_id"]
+            isOneToOne: false
+            referencedRelation: "prj_tasks"
+            referencedColumns: ["id"]
+          },
+          {
+            foreignKeyName: "fk_tasks_project"
+            columns: ["project_id"]
+            isOneToOne: false
+            referencedRelation: "prj_projects"
+            referencedColumns: ["id"]
+          },
           {
             foreignKeyName: "prj_tasks_milestone_id_fkey"
             columns: ["milestone_id"]