Dandelion Mané teamdandelion

Mirascope Registry Sync Tool Spec

Purpose

Enable consuming projects to maintain automatic synchronization with mirascope/ui as the single source of truth, departing from shadcn's "copy then own" philosophy in favor of "sync and stay current."

Core Philosophy

mirascope/ui is SoT: Components should stay in sync with upstream
Explicit tracking: Clear visibility into what comes from registry vs local code
Automated updates: Enable daily sync checks and PR automation
Selective sync: Only update components you've chosen to use

	import argparse
	import asyncio
	import inspect
	import json
	import logging
	import time
	from abc import ABC, abstractmethod
	from pathlib import Path
	from typing import Literal

	class PuzzleSolution(BaseModel):
	weekly: int
	monthly_min: int
	monthly_max: int

	puzzle = inspect.cleandoc("""A factory produces 5 widgets every
	weekday, and 3 widgets per day on weekends, and one extra widget on Mondays.
	How many widgets are produced in a week?

	Each month has four weeks, and one holiday (which may be any day of the week).

	[
	{
	"tokenID": "40000000",
	"traits": [
	"All Algobots",
	"Colour: Orange",
	"Headphones: Supra-aural",
	"Bodywork: Block",
	"Component: X",
	"State: Idle"

	export type Tag = string;
	export type UUID = string;

	type EditorNode = {\|
	+uuid: UUID,
	+tags: $ReadOnlyArray<Tag>,
	+title: string,
	+description: string,
	+connections: $ReadOnlyArray<EditorConnection>,
	+timestamp: TimestampMs \| null,