cc-1c-skills/.claude/skills/subsystem-edit/scripts/subsystem-edit.py

#!/usr/bin/env python3
# subsystem-edit v1.0 — Edit existing 1C subsystem XML
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills

import argparse
import json
import os
import subprocess
import sys
from lxml import etree

MD_NS = "http://v8.1c.ru/8.3/MDClasses"
XR_NS = "http://v8.1c.ru/8.3/xcf/readable"
XSI_NS = "http://www.w3.org/2001/XMLSchema-instance"
V8_NS = "http://v8.1c.ru/8.1/data/core"
XS_NS = "http://www.w3.org/2001/XMLSchema"

NSMAP_WRAPPER = {
    None: MD_NS,
    "xsi": XSI_NS,
    "v8": V8_NS,
    "xr": XR_NS,
    "xs": XS_NS,
}


def localname(el):
    return etree.QName(el.tag).localname


def info(msg):
    print(f"[INFO] {msg}")


def warn(msg):
    print(f"[WARN] {msg}")


def get_child_indent(container):
    """Detect indentation of children inside a container element."""
    if container.text and "\n" in container.text:
        after_nl = container.text.rsplit("\n", 1)[-1]
        if after_nl and not after_nl.strip():
            return after_nl
    for child in container:
        if child.tail and "\n" in child.tail:
            after_nl = child.tail.rsplit("\n", 1)[-1]
            if after_nl and not after_nl.strip():
                return after_nl
    # Fallback: count depth
    depth = 0
    current = container
    while current is not None:
        depth += 1
        current = current.getparent()
    return "\t" * depth


def insert_before_closing(container, new_el, child_indent):
    """Insert new_el before the closing tag of container, with proper indentation."""
    children = list(container)
    if len(children) == 0:
        # Empty element: set text to newline+indent, tail of new_el to newline+parent_indent
        parent_indent = child_indent[:-1] if len(child_indent) > 0 else ""
        container.text = "\r\n" + child_indent
        new_el.tail = "\r\n" + parent_indent
        container.append(new_el)
    else:
        last = children[-1]
        new_el.tail = last.tail
        last.tail = "\r\n" + child_indent
        container.append(new_el)


def remove_with_indent(el):
    """Remove element and clean up surrounding whitespace."""
    parent = el.getparent()
    prev = el.getprevious()
    if prev is not None:
        # Transfer el.tail to prev.tail
        if el.tail and el.tail.strip() == "":
            pass  # just drop extra whitespace
        prev.tail = el.tail if el.tail and el.tail.strip() else (prev.tail or "")
        # Actually try to keep the prev's tail as the closing indent
        # Better approach: set prev.tail to what el.tail was (newline+indent of next or closing)
        if el.tail:
            prev.tail = el.tail
    else:
        # First child: adjust parent.text
        if el.tail:
            parent.text = el.tail
    parent.remove(el)


def expand_self_closing(container, parent_indent):
    """If container is self-closing (no children, no text), add closing whitespace."""
    if len(container) == 0 and not (container.text and container.text.strip()):
        container.text = "\r\n" + parent_indent


def import_fragment(xml_string, doc_root):
    """Parse an XML fragment in the MD namespace context and return elements."""
    wrapper = (
        f'<_W xmlns="{MD_NS}" xmlns:xsi="{XSI_NS}" xmlns:v8="{V8_NS}" '
        f'xmlns:xr="{XR_NS}" xmlns:xs="{XS_NS}">{xml_string}</_W>'
    )
    frag = etree.fromstring(wrapper.encode("utf-8"))
    nodes = []
    for child in frag:
        nodes.append(child)
    return nodes


def parse_value_list(val):
    """Parse a string or JSON array into a list of strings."""
    val = val.strip()
    if val.startswith("["):
        arr = json.loads(val)
        return [str(item) for item in arr]
    return [val]


def save_xml_bom(tree, path):
    xml_bytes = etree.tostring(tree, xml_declaration=True, encoding="UTF-8")
    xml_bytes = xml_bytes.replace(b"encoding='UTF-8'", b'encoding="UTF-8"')
    with open(path, "wb") as f:
        f.write(b"\xef\xbb\xbf")
        f.write(xml_bytes)


def main():
    sys.stdout.reconfigure(encoding="utf-8")
    sys.stderr.reconfigure(encoding="utf-8")
    parser = argparse.ArgumentParser(description="Edit existing 1C subsystem XML", allow_abbrev=False)
    parser.add_argument("-SubsystemPath", required=True)
    parser.add_argument("-DefinitionFile", default=None)
    parser.add_argument("-Operation", default=None, choices=["add-content", "remove-content", "add-child", "remove-child", "set-property"])
    parser.add_argument("-Value", default=None)
    parser.add_argument("-NoValidate", action="store_true")
    args = parser.parse_args()

    # --- Mode validation ---
    if args.DefinitionFile and args.Operation:
        print("Cannot use both -DefinitionFile and -Operation", file=sys.stderr)
        sys.exit(1)
    if not args.DefinitionFile and not args.Operation:
        print("Either -DefinitionFile or -Operation is required", file=sys.stderr)
        sys.exit(1)

    # --- Resolve path ---
    subsystem_path = args.SubsystemPath
    if not os.path.isabs(subsystem_path):
        subsystem_path = os.path.join(os.getcwd(), subsystem_path)

    if os.path.isdir(subsystem_path):
        dir_name = os.path.basename(subsystem_path)
        candidate = os.path.join(subsystem_path, f"{dir_name}.xml")
        sibling = os.path.join(os.path.dirname(subsystem_path), f"{dir_name}.xml")
        if os.path.isfile(candidate):
            subsystem_path = candidate
        elif os.path.isfile(sibling):
            subsystem_path = sibling
        else:
            print(f"No {dir_name}.xml found in directory or as sibling", file=sys.stderr)
            sys.exit(1)

    if not os.path.isfile(subsystem_path):
        fn = os.path.splitext(os.path.basename(subsystem_path))[0]
        pd = os.path.dirname(subsystem_path)
        if fn == os.path.basename(pd):
            c = os.path.join(os.path.dirname(pd), f"{fn}.xml")
            if os.path.isfile(c):
                subsystem_path = c

    if not os.path.isfile(subsystem_path):
        print(f"File not found: {subsystem_path}", file=sys.stderr)
        sys.exit(1)

    resolved_path = os.path.abspath(subsystem_path)

    # --- Load XML ---
    xml_parser = etree.XMLParser(remove_blank_text=False)
    tree = etree.parse(resolved_path, xml_parser)
    xml_root = tree.getroot()

    add_count = 0
    remove_count = 0
    modify_count = 0

    # --- Detect structure ---
    sub = None
    for child in xml_root:
        if isinstance(child.tag, str) and localname(child) == "Subsystem":
            sub = child
            break
    if sub is None:
        print("No <Subsystem> element found", file=sys.stderr)
        sys.exit(1)

    props_el = None
    child_objs_el = None
    for child in sub:
        if not isinstance(child.tag, str):
            continue
        if localname(child) == "Properties":
            props_el = child
        if localname(child) == "ChildObjects":
            child_objs_el = child

    obj_name = ""
    if props_el is not None:
        for child in props_el:
            if isinstance(child.tag, str) and localname(child) == "Name":
                obj_name = (child.text or "").strip()
                break
    info(f"Subsystem: {obj_name}")

    # --- Operations ---
    def do_add_content(items):
        nonlocal add_count
        content_el = None
        for child in props_el:
            if isinstance(child.tag, str) and localname(child) == "Content":
                content_el = child
                break
        if content_el is None:
            print("No <Content> element found", file=sys.stderr)
            sys.exit(1)

        existing = set()
        for child in content_el:
            if isinstance(child.tag, str) and localname(child) == "Item":
                existing.add((child.text or "").strip())

        props_indent = get_child_indent(props_el)
        if len(content_el) == 0 and not (content_el.text and content_el.text.strip()):
            expand_self_closing(content_el, props_indent)
        content_indent = get_child_indent(content_el)

        for item in items:
            if item in existing:
                warn(f"Content already contains: {item}")
                continue
            frag_xml = f'<xr:Item xsi:type="xr:MDObjectRef">{item}</xr:Item>'
            nodes = import_fragment(frag_xml, xml_root)
            if nodes:
                insert_before_closing(content_el, nodes[0], content_indent)
                add_count += 1
                info(f"Added content: {item}")

    def do_remove_content(items):
        nonlocal remove_count
        content_el = None
        for child in props_el:
            if isinstance(child.tag, str) and localname(child) == "Content":
                content_el = child
                break
        if content_el is None:
            print("No <Content> element found", file=sys.stderr)
            sys.exit(1)

        for item in items:
            found = False
            for child in list(content_el):
                if isinstance(child.tag, str) and localname(child) == "Item" and (child.text or "").strip() == item:
                    remove_with_indent(child)
                    remove_count += 1
                    info(f"Removed content: {item}")
                    found = True
                    break
            if not found:
                warn(f"Content item not found: {item}")

    def do_add_child(child_name):
        nonlocal add_count
        if child_objs_el is None:
            print("No <ChildObjects> element found", file=sys.stderr)
            sys.exit(1)

        for child in child_objs_el:
            if isinstance(child.tag, str) and localname(child) == "Subsystem" and (child.text or "").strip() == child_name:
                warn(f"ChildObjects already contains: {child_name}")
                return

        sub_indent = get_child_indent(sub)
        if len(child_objs_el) == 0 and not (child_objs_el.text and child_objs_el.text.strip()):
            expand_self_closing(child_objs_el, sub_indent)
        ci = get_child_indent(child_objs_el)

        new_el = etree.SubElement(child_objs_el, f"{{{MD_NS}}}Subsystem")
        # Actually we need to use insert_before_closing pattern
        child_objs_el.remove(new_el)
        new_el = etree.Element(f"{{{MD_NS}}}Subsystem")
        new_el.text = child_name
        insert_before_closing(child_objs_el, new_el, ci)
        add_count += 1
        info(f"Added child subsystem: {child_name}")

    def do_remove_child(child_name):
        nonlocal remove_count
        if child_objs_el is None:
            print("No <ChildObjects> element found", file=sys.stderr)
            sys.exit(1)

        found = False
        for child in list(child_objs_el):
            if isinstance(child.tag, str) and localname(child) == "Subsystem" and (child.text or "").strip() == child_name:
                remove_with_indent(child)
                remove_count += 1
                info(f"Removed child subsystem: {child_name}")
                found = True
                break
        if not found:
            warn(f"Child subsystem not found: {child_name}")

    def do_set_property(json_val):
        nonlocal modify_count
        prop_def = json.loads(json_val)
        prop_name = str(prop_def["name"])
        prop_value = str(prop_def.get("value", ""))

        prop_el = None
        for child in props_el:
            if isinstance(child.tag, str) and localname(child) == prop_name:
                prop_el = child
                break
        if prop_el is None:
            print(f"Property '{prop_name}' not found in Properties", file=sys.stderr)
            sys.exit(1)

        bool_props = ["IncludeInCommandInterface", "UseOneCommand", "IncludeHelpInContents"]
        if prop_name in bool_props:
            prop_el.text = prop_value.lower()
            # Clear children
            for ch in list(prop_el):
                prop_el.remove(ch)
            modify_count += 1
            info(f"Set {prop_name} = {prop_value}")
            return

        ml_props = ["Synonym", "Explanation"]
        if prop_name in ml_props:
            if not prop_value:
                # Clear - make self-closing
                for ch in list(prop_el):
                    prop_el.remove(ch)
                prop_el.text = None
                modify_count += 1
                info(f"Cleared {prop_name}")
            else:
                for ch in list(prop_el):
                    prop_el.remove(ch)
                indent = get_child_indent(props_el)

                item_el = etree.SubElement(prop_el, f"{{{V8_NS}}}item")
                lang_el = etree.SubElement(item_el, f"{{{V8_NS}}}lang")
                lang_el.text = "ru"
                content_el = etree.SubElement(item_el, f"{{{V8_NS}}}content")
                content_el.text = prop_value

                # Set whitespace
                prop_el.text = "\r\n" + indent + "\t"
                item_el.text = "\r\n" + indent + "\t\t"
                lang_el.tail = "\r\n" + indent + "\t\t"
                content_el.tail = "\r\n" + indent + "\t"
                item_el.tail = "\r\n" + indent

                modify_count += 1
                info(f'Set {prop_name} = "{prop_value}"')
            return

        if prop_name == "Comment":
            for ch in list(prop_el):
                prop_el.remove(ch)
            if not prop_value:
                prop_el.text = None
            else:
                prop_el.text = prop_value
            modify_count += 1
            info(f'Set Comment = "{prop_value}"')
            return

        if prop_name == "Picture":
            for ch in list(prop_el):
                prop_el.remove(ch)
            if not prop_value:
                prop_el.text = None
            else:
                indent = get_child_indent(props_el)
                ref_el = etree.SubElement(prop_el, f"{{{XR_NS}}}Ref")
                ref_el.text = prop_value
                load_el = etree.SubElement(prop_el, f"{{{XR_NS}}}LoadTransparent")
                load_el.text = "false"
                prop_el.text = "\r\n" + indent + "\t"
                ref_el.tail = "\r\n" + indent + "\t"
                load_el.tail = "\r\n" + indent
            modify_count += 1
            info(f'Set Picture = "{prop_value}"')
            return

        # Generic text property
        for ch in list(prop_el):
            prop_el.remove(ch)
        prop_el.text = prop_value
        modify_count += 1
        info(f'Set {prop_name} = "{prop_value}"')

    # --- Execute operations ---
    operations = []
    if args.DefinitionFile:
        def_file = args.DefinitionFile
        if not os.path.isabs(def_file):
            def_file = os.path.join(os.getcwd(), def_file)
        with open(def_file, "r", encoding="utf-8-sig") as fh:
            ops = json.loads(fh.read())
        if isinstance(ops, list):
            operations = ops
        else:
            operations = [ops]
    else:
        operations = [{"operation": args.Operation, "value": args.Value or ""}]

    for op in operations:
        op_name = op.get("operation", args.Operation or "")
        op_value = op.get("value", args.Value or "")

        if op_name == "add-content":
            do_add_content(parse_value_list(op_value))
        elif op_name == "remove-content":
            do_remove_content(parse_value_list(op_value))
        elif op_name == "add-child":
            do_add_child(op_value)
        elif op_name == "remove-child":
            do_remove_child(op_value)
        elif op_name == "set-property":
            do_set_property(op_value)
        else:
            print(f"Unknown operation: {op_name}", file=sys.stderr)
            sys.exit(1)

    # --- Save ---
    save_xml_bom(tree, resolved_path)
    info(f"Saved: {resolved_path}")

    # --- Auto-validate ---
    if not args.NoValidate:
        validate_script = os.path.normpath(os.path.join(os.path.dirname(__file__), "..", "..", "subsystem-validate", "scripts", "subsystem-validate.py"))
        if os.path.isfile(validate_script):
            print()
            print("--- Running subsystem-validate ---")
            subprocess.run([sys.executable, validate_script, "-SubsystemPath", resolved_path])

    # --- Summary ---
    print()
    print("=== subsystem-edit summary ===")
    print(f"  Subsystem: {obj_name}")
    print(f"  Added:     {add_count}")
    print(f"  Removed:   {remove_count}")
    print(f"  Modified:  {modify_count}")
    sys.exit(0)


if __name__ == "__main__":
    main()