@jack200714/mafw 4.5.1 → 4.5.2

package/.opencode/skills/ui-ux-pro-max/scripts/search.py

@@ -1,162 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
-Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
-       python search.py "<query>" --design-system [-p "Project Name"]
-       python search.py "<query>" --design-system --persist [-p "Project Name"] --output-dir "<project-root>" [--page "dashboard"]
-       python search.py "<query>" --design-system --variance 8 --motion 9 --density 7
-
-Domains: style, color, chart, landing, product, ux, typography, google-fonts, icons, gsap, react, web
-Stacks: react, nextjs, vue, svelte, astro, swiftui, react-native, flutter, nuxtjs, nuxt-ui,
-        html-tailwind, shadcn, jetpack-compose, threejs, angular, laravel
-
-Design dials (1-10, only with --design-system):
-  --variance   DESIGN_VARIANCE: 1=centered/minimal, 10=bold/asymmetric
-  --motion     MOTION_INTENSITY: 1=subtle, 10=complex; attaches a GSAP snippet from motion.csv
-  --density    VISUAL_DENSITY: 1=spacious, 10=dense/dashboard; overrides the spacing scale
-
-Persistence (Master + Overrides pattern):
-  --persist      Save design system to design-system/<project-slug>/MASTER.md
-  --output-dir   Directory the design-system/ folder is created under (defaults to cwd --
-                 always pass this explicitly, pointed at the project root)
-  --page         Also create a page-specific override file in design-system/<project-slug>/pages/
-  --force        Overwrite an existing MASTER.md (without this, persistence is skipped
-                 if MASTER.md already exists, so prior design decisions aren't lost)
-"""
-
-import argparse
-import json as json_module
-import sys
-import io
-from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, UNTRUNCATED_COLS, search, search_stack
-from design_system import generate_design_system
-
-# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
-if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
-    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
-if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
-    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
-
-TRUNCATE_AT = 300
-
-
-def format_output(result, full=False):
-    """Format results for Claude consumption (token-optimized)"""
-    if "error" in result:
-        return f"Error: {result['error']}"
-
-    output = []
-    if result.get("stack"):
-        output.append("## UI Pro Max Stack Guidelines")
-        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
-    else:
-        output.append("## UI Pro Max Search Results")
-        domain_note = result['domain']
-        if result.get("auto_detected"):
-            domain_note += " (auto-detected"
-            if result.get("runner_up_domain"):
-                domain_note += f", runner-up: {result['runner_up_domain']}"
-            domain_note += ")"
-        output.append(f"**Domain:** {domain_note} | **Query:** {result['query']}")
-    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
-
-    if result['count'] == 0:
-        output.append(
-            "No matches. This is not a match with an empty value -- the query "
-            "did not hit the database. Retry with broader/different keywords "
-            "before falling back to general defaults, and say explicitly that "
-            "no database match was found if you do fall back."
-        )
-        suggestions = result.get("suggestions") or []
-        if suggestions:
-            output.append(f"**Closest known terms:** {', '.join(suggestions)}")
-        return "\n".join(output)
-
-    for i, row in enumerate(result['results'], 1):
-        output.append(f"### Result {i}")
-        for key, value in row.items():
-            value_str = str(value)
-            if not full and key not in UNTRUNCATED_COLS and len(value_str) > TRUNCATE_AT:
-                value_str = value_str[:TRUNCATE_AT] + "..."
-            output.append(f"- **{key}:** {value_str}")
-        output.append("")
-
-    return "\n".join(output)
-
-
-if __name__ == "__main__":
-    parser = argparse.ArgumentParser(description="UI Pro Max Search")
-    parser.add_argument("query", help="Search query")
-    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
-    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help=f"Stack-specific search. Available: {', '.join(AVAILABLE_STACKS)}")
-    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
-    parser.add_argument("--json", action="store_true", help="Output as JSON")
-    parser.add_argument("--full", action="store_true", help="Do not truncate long field values in text output")
-    # Design system generation
-    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
-    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
-    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system (ignored if --json)")
-    # Persistence (Master + Overrides pattern)
-    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/<project-slug>/MASTER.md (creates hierarchical structure)")
-    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/<project-slug>/pages/")
-    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory -- pass this explicitly, pointed at the project root)")
-    parser.add_argument("--force", action="store_true", help="Overwrite an existing MASTER.md when persisting (default: skip if it already exists)")
-    # Design dials (1-10), only applied with --design-system
-    parser.add_argument("--variance", type=int, choices=range(1, 11), metavar="1-10", help="DESIGN_VARIANCE dial: 1=centered/minimal, 10=bold/asymmetric (only with --design-system)")
-    parser.add_argument("--motion", type=int, choices=range(1, 11), metavar="1-10", help="MOTION_INTENSITY dial: 1=subtle, 10=complex; pulls a matching GSAP snippet from motion.csv (only with --design-system)")
-    parser.add_argument("--density", type=int, choices=range(1, 11), metavar="1-10", help="VISUAL_DENSITY dial: 1=spacious, 10=dense/dashboard; overrides the spacing scale (only with --design-system)")
-
-    args = parser.parse_args()
-
-    # Design system takes priority
-    if args.design_system:
-        result = generate_design_system(
-            args.query,
-            args.project_name,
-            args.format,
-            persist=args.persist,
-            page=args.page,
-            output_dir=args.output_dir,
-            variance=args.variance,
-            motion=args.motion,
-            density=args.density,
-            force=args.force,
-        )
-
-        if args.json:
-            print(json_module.dumps(
-                {"design_system": result["design_system"], "persistence": result["persistence"]},
-                indent=2, ensure_ascii=False,
-            ))
-        else:
-            print(result["text"])
-
-            if args.persist:
-                persistence = result["persistence"] or {}
-                print("\n" + "=" * 60)
-                if persistence.get("status") == "skipped_exists":
-                    print(f"⚠️  {persistence.get('message', 'MASTER.md already exists; not overwritten.')}")
-                else:
-                    ds_dir = persistence.get("design_system_dir", "design-system/<project>")
-                    print(f"✅ Design system persisted to {ds_dir}/")
-                    for f in persistence.get("created_files", []):
-                        print(f"   📄 {f}")
-                    print("")
-                    print(f"📖 Usage: When building a page, check {ds_dir}/pages/[page].md first.")
-                    print("   If it exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
-                print("=" * 60)
-    # Stack search
-    elif args.stack:
-        result = search_stack(args.query, args.stack, args.max_results)
-        if args.json:
-            print(json_module.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result, full=args.full))
-    # Domain search
-    else:
-        result = search(args.query, args.domain, args.max_results)
-        if args.json:
-            print(json_module.dumps(result, indent=2, ensure_ascii=False))
-        else:
-            print(format_output(result, full=args.full))

package/.opencode/skills/ui-ux-pro-max/scripts/tests/test_core.py

@@ -1,134 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Stdlib-only regression tests for core.py / design_system.py (unittest, not
-pytest -- this project ships with zero external dependencies and the tests
-shouldn't add one).
-
-Run with:
-    python -m unittest discover -s scripts/tests -v
-or directly:
-    python scripts/tests/test_core.py
-"""
-
-import sys
-import tempfile
-import unittest
-from pathlib import Path
-
-SCRIPTS_DIR = Path(__file__).resolve().parent.parent
-sys.path.insert(0, str(SCRIPTS_DIR))
-
-from core import BM25, detect_domain, search, search_stack, CSV_CONFIG, AVAILABLE_STACKS
-from design_system import generate_design_system, persist_design_system, DesignSystemGenerator
-
-
-class TestTokenizer(unittest.TestCase):
-    def test_short_domain_terms_are_kept(self):
-        bm25 = BM25()
-        tokens = bm25.tokenize("UI and UX design with 3D and AI")
-        self.assertIn("ui", tokens)
-        self.assertIn("3d", tokens)
-        self.assertIn("ai", tokens)
-
-    def test_stopwords_removed(self):
-        bm25 = BM25()
-        tokens = bm25.tokenize("this is for the team to do")
-        for stopword in ("is", "for", "the", "to", "do"):
-            self.assertNotIn(stopword, tokens)
-
-    def test_synonym_normalization(self):
-        bm25 = BM25()
-        self.assertEqual(bm25.tokenize("e-commerce store"), bm25.tokenize("ecommerce store"))
-        self.assertEqual(bm25.tokenize("dark-mode toggle"), bm25.tokenize("dark toggle"))
-
-
-class TestSearchDomains(unittest.TestCase):
-    """Known query -> expected top-domain sanity checks (not exact-row pinning,
-    since data can grow; these assert the engine still finds *something*
-    relevant for each domain's core vocabulary)."""
-
-    def test_ui_is_searchable_in_style_domain(self):
-        result = search("ui minimalism", domain="style", max_results=1)
-        self.assertGreater(result["count"], 0, "literal 'ui' token must be searchable, not filtered by tokenizer")
-
-    def test_accessibility_query_hits_ux(self):
-        result = search("accessibility contrast wcag keyboard", domain="ux", max_results=3)
-        self.assertGreater(result["count"], 0)
-
-    def test_zero_result_query_reports_suggestions_not_error(self):
-        result = search("zzqqxx totally made up gibberish", domain="ux", max_results=2)
-        self.assertEqual(result["count"], 0)
-        self.assertIn("suggestions", result)
-        self.assertNotIn("error", result)
-
-    def test_every_configured_domain_file_exists_and_is_searchable(self):
-        for domain, config in CSV_CONFIG.items():
-            with self.subTest(domain=domain):
-                result = search("design", domain=domain, max_results=1)
-                self.assertNotIn("error", result, f"domain '{domain}' failed: {result.get('error')}")
-
-    def test_every_stack_file_exists_and_is_searchable(self):
-        for stack in AVAILABLE_STACKS:
-            with self.subTest(stack=stack):
-                result = search_stack("performance", stack, max_results=1)
-                self.assertNotIn("error", result, f"stack '{stack}' failed: {result.get('error')}")
-
-
-class TestDomainDetection(unittest.TestCase):
-    def test_style_keywords_route_to_style(self):
-        self.assertEqual(detect_domain("glassmorphism dark ui"), "style")
-
-    def test_accessibility_keywords_route_to_ux(self):
-        self.assertEqual(detect_domain("accessibility contrast wcag"), "ux")
-
-    def test_ambiguous_query_returns_runner_up(self):
-        domain, runner_up = detect_domain("font pairing elegant crypto", return_scores=True)
-        self.assertIsNotNone(domain)
-        # runner_up may be None if the winning domain has no close second --
-        # this just verifies the call shape works without raising.
-
-    def test_empty_query_falls_back_to_style(self):
-        self.assertEqual(detect_domain("...!!!???"), "style")
-
-
-class TestPersistence(unittest.TestCase):
-    def test_persist_then_skip_then_force(self):
-        with tempfile.TemporaryDirectory() as tmp:
-            result = generate_design_system("saas dashboard", "Test Project", persist=True, output_dir=tmp)
-            self.assertEqual(result["persistence"]["status"], "success")
-            master = Path(result["persistence"]["master_file"])
-            self.assertTrue(master.exists())
-            original_content = master.read_text(encoding="utf-8")
-
-            # Second persist without force must not overwrite.
-            result2 = generate_design_system("saas dashboard", "Test Project", persist=True, output_dir=tmp)
-            self.assertEqual(result2["persistence"]["status"], "skipped_exists")
-            self.assertEqual(master.read_text(encoding="utf-8"), original_content)
-
-            # With force=True it must overwrite.
-            result3 = generate_design_system("ecommerce luxury", "Test Project", persist=True, output_dir=tmp, force=True)
-            self.assertEqual(result3["persistence"]["status"], "success")
-
-    def test_persist_writes_only_under_output_dir(self):
-        with tempfile.TemporaryDirectory() as tmp:
-            generate_design_system("saas dashboard", "Scoped Project", persist=True, output_dir=tmp)
-            expected = Path(tmp) / "design-system" / "scoped-project" / "MASTER.md"
-            self.assertTrue(expected.exists())
-
-
-class TestReasoningMatch(unittest.TestCase):
-    def test_known_category_matches_exactly(self):
-        gen = DesignSystemGenerator()
-        rule = gen._find_reasoning_rule("SaaS (General)")
-        self.assertTrue(rule, "exact-match category lookup should not fall through to fuzzy matching")
-
-    def test_unknown_category_falls_back_gracefully(self):
-        gen = DesignSystemGenerator()
-        rule = gen._find_reasoning_rule("Totally Unknown Category XYZ")
-        # Should not raise; may return {} which _apply_reasoning handles with defaults.
-        self.assertIsInstance(rule, dict)
-
-
-if __name__ == "__main__":
-    unittest.main()

package/.opencode/skills/ui-ux-pro-max/scripts/tests/test_design_system_mode.py

@@ -1,159 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Regression tests for color-mode coherence in design_system.py (issue #428).
-
-Style, palette and anti-patterns used to be resolved independently, so a
-dark-primary style could be returned alongside a light palette and a
-"Dark mode by default" anti-pattern.
-
-Stdlib-only (unittest, not pytest) to match test_core.py -- this project ships
-with zero external dependencies.
-
-Run with:
-    python -m unittest discover -s scripts/tests -v
-or directly:
-    python scripts/tests/test_design_system_mode.py
-"""
-
-import sys
-import unittest
-from pathlib import Path
-
-SCRIPTS_DIR = Path(__file__).resolve().parent.parent
-sys.path.insert(0, str(SCRIPTS_DIR))
-
-from design_system import (  # noqa: E402
-    _filter_anti_patterns_for_mode,
-    _palette_is_dark,
-    _query_wants_dark,
-    _relative_luminance,
-    _resolve_color_mode,
-    _select_palette_for_mode,
-    _style_is_dark_primary,
-    DesignSystemGenerator,
-)  # noqa: I001 - private helpers first, public class last
-
-LIGHT_PALETTE = {"Product Type": "SaaS", "Background": "#F8FAFC", "Foreground": "#020617"}
-DARK_PALETTE = {"Product Type": "Fintech/Crypto", "Background": "#0F172A", "Foreground": "#F8FAFC"}
-
-# Verbatim from styles.csv row "Modern Dark (Cinema Mobile)".
-DARK_PRIMARY_STYLE = {
-    "Style Category": "Modern Dark (Cinema Mobile)",
-    "Light Mode ✓": "✓ Light mode only as exception",
-    "Dark Mode ✓": "✓ Dark Mode Primary",
-}
-DUAL_MODE_STYLE = {
-    "Style Category": "Minimalism",
-    "Light Mode ✓": "✓ Full",
-    "Dark Mode ✓": "✓ Full",
-}
-
-
-class TestLuminance(unittest.TestCase):
-    def test_parses_six_and_three_digit_hex(self):
-        self.assertAlmostEqual(_relative_luminance("#FFFFFF"), 1.0, places=6)
-        self.assertAlmostEqual(_relative_luminance("#000000"), 0.0, places=6)
-        self.assertAlmostEqual(_relative_luminance("#FFF"), 1.0, places=6)
-
-    def test_returns_none_for_unparseable(self):
-        for value in ("", "nope", "#12", "#GGGGGG", None):
-            self.assertIsNone(_relative_luminance(value))
-
-    def test_classifies_backgrounds_from_the_shipped_data(self):
-        # Lightest dark background and darkest light background in colors.csv.
-        self.assertTrue(_palette_is_dark({"Background": "#1F2937"}))
-        self.assertFalse(_palette_is_dark({"Background": "#E8ECF1"}))
-
-    def test_missing_background_is_not_dark(self):
-        self.assertFalse(_palette_is_dark({}))
-        self.assertFalse(_palette_is_dark(None))
-
-
-class TestModeResolution(unittest.TestCase):
-    def test_dark_primary_style_detected(self):
-        self.assertTrue(_style_is_dark_primary(DARK_PRIMARY_STYLE))
-
-    def test_dual_mode_style_is_not_dark_primary(self):
-        self.assertFalse(_style_is_dark_primary(DUAL_MODE_STYLE))
-        self.assertFalse(_style_is_dark_primary({}))
-
-    def test_query_keywords(self):
-        self.assertTrue(_query_wants_dark("fintech B2B professional dark mode"))
-        self.assertTrue(_query_wants_dark("gaming app OLED"))
-        self.assertFalse(_query_wants_dark("healthcare clinic booking app"))
-        self.assertFalse(_query_wants_dark(""))
-
-    def test_either_signal_resolves_dark(self):
-        self.assertEqual(_resolve_color_mode("saas dark mode", DUAL_MODE_STYLE), "dark")
-        self.assertEqual(_resolve_color_mode("saas", DARK_PRIMARY_STYLE), "dark")
-        self.assertEqual(_resolve_color_mode("saas", DUAL_MODE_STYLE), "light")
-
-
-class TestPaletteSelection(unittest.TestCase):
-    def test_dark_mode_skips_light_palettes(self):
-        chosen = _select_palette_for_mode([LIGHT_PALETTE, DARK_PALETTE], "dark")
-        self.assertEqual(chosen["Background"], "#0F172A")
-
-    def test_dark_mode_falls_back_to_top_hit_when_no_dark_ramp_exists(self):
-        chosen = _select_palette_for_mode([LIGHT_PALETTE], "dark")
-        self.assertEqual(chosen["Background"], "#F8FAFC")
-
-    def test_light_mode_keeps_the_existing_top_hit_behaviour(self):
-        chosen = _select_palette_for_mode([DARK_PALETTE, LIGHT_PALETTE], "light")
-        self.assertEqual(chosen["Background"], "#0F172A")
-
-    def test_empty_results(self):
-        self.assertEqual(_select_palette_for_mode([], "dark"), {})
-
-
-class TestAntiPatternGating(unittest.TestCase):
-    def test_dark_clause_dropped_others_kept(self):
-        result = _filter_anti_patterns_for_mode(
-            "Excessive animation + Dark mode by default", "dark")
-        self.assertEqual(result, "Excessive animation")
-
-    def test_light_mode_is_a_no_op(self):
-        original = "Excessive animation + Dark mode by default"
-        self.assertEqual(_filter_anti_patterns_for_mode(original, "light"), original)
-
-    def test_unrelated_anti_patterns_survive_dark_mode(self):
-        original = "Complex jargon + Tiny tap targets"
-        self.assertEqual(_filter_anti_patterns_for_mode(original, "dark"), original)
-
-    def test_empty_input(self):
-        self.assertEqual(_filter_anti_patterns_for_mode("", "dark"), "")
-
-
-class TestEndToEndCoherence(unittest.TestCase):
-    """The exact reproduction from issue #428."""
-
-    QUERY = "SaaS invoicing fintech B2B professional dark mode"
-
-    def test_dark_query_gets_a_dark_background(self):
-        ds = DesignSystemGenerator().generate(self.QUERY)
-        background = ds["colors"]["background"]
-        self.assertTrue(
-            _palette_is_dark({"Background": background}),
-            "dark-mode query returned a light background: {}".format(background),
-        )
-
-    def test_dark_query_foreground_is_lighter_than_background(self):
-        ds = DesignSystemGenerator().generate(self.QUERY)
-        background = _relative_luminance(ds["colors"]["background"])
-        foreground = _relative_luminance(ds["colors"]["foreground"])
-        self.assertIsNotNone(background)
-        self.assertIsNotNone(foreground)
-        self.assertGreater(foreground, background)
-
-    def test_dark_query_does_not_advise_against_dark_mode(self):
-        ds = DesignSystemGenerator().generate(self.QUERY)
-        self.assertNotIn("dark mode", ds["anti_patterns"].lower())
-
-    def test_light_query_keeps_a_light_background(self):
-        ds = DesignSystemGenerator().generate("healthcare clinic booking app")
-        self.assertFalse(_palette_is_dark({"Background": ds["colors"]["background"]}))
-
-
-if __name__ == "__main__":
-    unittest.main(verbosity=2)

package/.opencode/skills/ui-ux-pro-max/scripts/validate_data.py

@@ -1,114 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Data integrity guardrail for ui-ux-pro-max. Stdlib-only, no pytest dependency,
-so it can run as a standalone pre-publish/CI check:
-
-    python validate_data.py
-
-Checks, per configured domain/stack CSV:
-  - file exists
-  - header row contains every column referenced in search_cols/output_cols
-  - no duplicate primary-key values (first column) within a file
-  - any "Decision_Rules"-style JSON column parses as JSON
-
-Exits 0 with no output on success; exits 1 and prints every problem found
-on failure (fail-fast is the wrong call here -- a data change can break
-several files at once, so we want the full list in one run).
-"""
-
-import csv
-import json
-import sys
-from pathlib import Path
-
-from core import CSV_CONFIG, STACK_CONFIG, _STACK_COLS, DATA_DIR
-
-# REASONING_FILE lives in design_system.py, not core.py -- redeclared here to
-# avoid a circular import (design_system.py imports core.py).
-REASONING_FILE = "ui-reasoning.csv"
-JSON_COLUMNS = {"Decision_Rules"}
-
-
-def _read_rows(filepath):
-    with open(filepath, "r", encoding="utf-8") as f:
-        reader = csv.DictReader(f)
-        return reader.fieldnames or [], list(reader)
-
-
-def _check_file(label, filepath, search_cols, output_cols, problems):
-    if not filepath.exists():
-        problems.append(f"[{label}] missing file: {filepath}")
-        return
-
-    try:
-        headers, rows = _read_rows(filepath)
-    except (csv.Error, UnicodeDecodeError, OSError) as e:
-        problems.append(f"[{label}] failed to parse {filepath.name}: {e}")
-        return
-
-    header_set = set(headers)
-    for col in set(search_cols) | set(output_cols):
-        if col not in header_set:
-            problems.append(f"[{label}] {filepath.name}: expected column '{col}' not found in header")
-
-    # Only check for duplicates against an actual identifier column ("No" is
-    # the sequential-index convention used across this dataset). The first
-    # CSV column is not reliably a unique key -- e.g. stack files use
-    # "Category", which legitimately repeats across many guideline rows.
-    if "No" in header_set:
-        seen = {}
-        for i, row in enumerate(rows, start=2):  # +1 header, +1 to be 1-indexed
-            key = row.get("No", "")
-            if key in seen:
-                problems.append(
-                    f"[{label}] {filepath.name}: duplicate 'No' value '{key}' on rows {seen[key]} and {i}"
-                )
-            else:
-                seen[key] = i
-    elif label.startswith("stack:"):
-        problems.append(
-            f"[{label}] {filepath.name}: missing 'No' index column present in other stack files "
-            "(schema drift -- harmless for search, but inconsistent with the rest of data/stacks/)"
-        )
-
-    for row_idx, row in enumerate(rows, start=2):
-        for col in JSON_COLUMNS:
-            if col in row and row[col]:
-                try:
-                    json.loads(row[col])
-                except json.JSONDecodeError as e:
-                    problems.append(
-                        f"[{label}] {filepath.name} row {row_idx}: column '{col}' is not valid JSON: {e}"
-                    )
-
-
-def main():
-    problems = []
-
-    for domain, config in CSV_CONFIG.items():
-        _check_file(f"domain:{domain}", DATA_DIR / config["file"],
-                    config["search_cols"], config["output_cols"], problems)
-
-    for stack, config in STACK_CONFIG.items():
-        _check_file(f"stack:{stack}", DATA_DIR / config["file"],
-                    _STACK_COLS["search_cols"], _STACK_COLS["output_cols"], problems)
-
-    reasoning_path = DATA_DIR / REASONING_FILE
-    if reasoning_path.exists():
-        _check_file("reasoning", reasoning_path, ["UI_Category"], ["UI_Category", "Decision_Rules"], problems)
-    else:
-        problems.append(f"[reasoning] missing file: {reasoning_path}")
-
-    if problems:
-        print(f"FAILED: {len(problems)} data integrity issue(s) found:\n")
-        for p in problems:
-            print(f"  - {p}")
-        sys.exit(1)
-
-    print(f"OK: validated {len(CSV_CONFIG)} domain files, {len(STACK_CONFIG)} stack files, and ui-reasoning.csv")
-    sys.exit(0)
-
-
-if __name__ == "__main__":
-    main()

package/dist/hooks/bash-python-guide.d.ts

@@ -1,4 +0,0 @@
-export declare function pythonGuideHook(input: any, output: any): any;
-/** 测试辅助：重置会话去重。 */
-export declare function _resetPythonGuideState(): void;
-//# sourceMappingURL=bash-python-guide.d.ts.map

package/dist/hooks/bash-python-guide.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bash-python-guide.d.ts","sourceRoot":"","sources":["../../src/hooks/bash-python-guide.ts"],"names":[],"mappings":"AAmCA,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CA6B5D;AAED,mBAAmB;AACnB,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/hooks/bash-python-guide.js

@@ -1,67 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pythonGuideHook = pythonGuideHook;
-exports._resetPythonGuideState = _resetPythonGuideState;
-/**
- * bash-python-guide — 温和引导：检测 bash 里的长 Python 内联脚本，提示改用
- * mafw_python（持久内核）。仅"计算型 + 较长"的脚本触发，每会话只提示一次，
- * 避免干扰。
- */
-const GUIDE_NOTE = '[提示] 这是一段较长的 Python 计算脚本。此类计算建议改用 mafw_python 工具（会话持久内核：变量/导入跨调用保持，' +
-    'matplotlib 可直接出图）。bash 适合跑项目脚本/CLI/单行命令。';
-// 会话级去重
-const notifiedSessions = new Set();
-const PY_INLINE_RE = /(?:^|[\n$>])\s*(?:python3?|py)\s+-c\s+['"]/;
-const PY_HEREDOC_RE = /(?:^|[\n$>])\s*(?:python3?|py)\s+[^\n]*<<['"]?(?:EOF|PYTHON|PY)[\s\S]{200,}/;
-function isComputational(code) {
-    const keywords = [
-        'import numpy', 'import pandas', 'import matplotlib', 'import math', 'import statistics',
-        'sum(', 'mean(', 'max(', 'min(', 'sorted(', 'for ', 'lambda ', 'def ', '.mean()', '.sum()',
-        'range(', 'percent', 'average', 'median', 'std(', '计算', '统计', '均值',
-    ];
-    return keywords.some((k) => code.includes(k));
-}
-function messageText(msg) {
-    const parts = Array.isArray(msg?.parts) ? msg.parts : typeof msg?.content === 'string' ? [{ type: 'text', text: msg.content }] : [];
-    return parts
-        .filter((p) => (p?.type === 'text' || p?.type === 'tool') && typeof p.text === 'string')
-        .map((p) => p.text)
-        .join('\n');
-}
-function pythonGuideHook(input, output) {
-    const sessionID = input?.sessionID || '';
-    if (!sessionID || notifiedSessions.has(sessionID))
-        return output;
-    const messages = output?.messages;
-    if (!Array.isArray(messages))
-        return output;
-    for (const msg of messages) {
-        const isUser = msg?.role === 'user' || msg?.info?.role === 'user';
-        const isTool = (msg?.info?.role === 'tool' || msg?.role === 'tool' || msg?.info?.role === 'assistant') && /bash|execute/i.test(String(msg?.info?.name || msg?.name || ''));
-        if (!isUser && !isTool)
-            continue;
-        const text = messageText(msg);
-        if (!text)
-            continue;
-        const matched = PY_INLINE_RE.test(text) || PY_HEREDOC_RE.test(text);
-        if (!matched)
-            continue;
-        // 提取脚本片段做"计算型"判断（截取 python 命令后的内容）
-        const afterCmd = text.replace(/.*(?:python3?|py)\s+-c\s+['"]([^'"]{0,3000})['"]?.*/s, '$1');
-        const scriptSample = afterCmd.length > 30 ? afterCmd : text;
-        if (!isComputational(scriptSample))
-            continue;
-        notifiedSessions.add(sessionID);
-        messages.push({
-            role: 'user',
-            parts: [{ type: 'text', text: GUIDE_NOTE, synthetic: true }],
-        });
-        break;
-    }
-    return output;
-}
-/** 测试辅助：重置会话去重。 */
-function _resetPythonGuideState() {
-    notifiedSessions.clear();
-}
-//# sourceMappingURL=bash-python-guide.js.map

package/dist/hooks/bash-python-guide.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bash-python-guide.js","sourceRoot":"","sources":["../../src/hooks/bash-python-guide.ts"],"names":[],"mappings":"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"}

package/dist/hooks/handoff.d.ts

@@ -1,9 +0,0 @@
-export interface HandoffContext {
-    from: string;
-    to: string;
-    goalId: string;
-    context?: any;
-    projectDir?: string;
-}
-export declare function handoffHook(ctx: HandoffContext): Promise<void>;
-//# sourceMappingURL=handoff.d.ts.map

package/dist/hooks/handoff.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/hooks/handoff.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE"}