feat(init): add 'struct init' to scaffold a basic .struct.yaml with hooks, files, and folders\n\n- Creates .struct.yaml in target directory (non-destructive; skips if exists)\n- Includes pre_hooks/post_hooks with echo, README in files, and run-struct workflow in folders\n- Tests cover file creation and skip behavior\n\nRefs: #97

Author: httpdss

struct_module/commands/init.py

@@ -0,0 +1,52 @@
+from struct_module.commands import Command
+import os
+import textwrap
+
+BASIC_STRUCT_YAML = textwrap.dedent(
+    """
+    # Generated by `struct init`
+    # Edit as needed to customize your project bootstrap
+
+    pre_hooks:
+      - echo "Starting struct generation"
+
+    post_hooks:
+      - echo "Struct generation completed"
+
+    files:
+      - README.md: |
+          # Project
+
+          Initialized with struct.
+
+    folders:
+      - ./:
+          struct:
+            - github/workflows/run-struct
+    """
+).lstrip()
+
+class InitCommand(Command):
+  def __init__(self, parser):
+    super().__init__(parser)
+    parser.description = "Initialize a basic .struct.yaml in the target directory"
+    parser.add_argument('path', nargs='?', default='.', help='Directory to initialize (default: current directory)')
+    parser.set_defaults(func=self.execute)
+
+  def execute(self, args):
+    base_path = os.path.abspath(args.path or '.')
+    target = os.path.join(base_path, '.struct.yaml')
+
+    os.makedirs(base_path, exist_ok=True)
+
+    # If file exists, do not overwrite without explicit confirmation behavior (keep simple: skip)
+    if os.path.exists(target):
+      self.logger.info(f".struct.yaml already exists at {target}, skipping creation")
+      print(f"⚠️  .struct.yaml already exists at: {target}")
+      return
+
+    with open(target, 'w') as f:
+      f.write(BASIC_STRUCT_YAML)
+
+    print("✅ Created .struct.yaml")
+    print(f" - {target}")

struct_module/main.py

@@ -31,6 +31,10 @@ def main():
     GenerateSchemaCommand(subparsers.add_parser('generate-schema', help='Generate JSON schema for available structures'))
     MCPCommand(subparsers.add_parser('mcp', help='MCP (Model Context Protocol) support'))
 
+    # init to create a basic .struct.yaml
+    from struct_module.commands.init import InitCommand
+    InitCommand(subparsers.add_parser('init', help='Initialize a basic .struct.yaml in the target directory'))
+
     # completion installer
     from struct_module.commands.completion import CompletionCommand
     CompletionCommand(subparsers.add_parser('completion', help='Manage shell completions'))

tests/test_init_command.py

@@ -0,0 +1,48 @@
+import argparse
+import os
+from unittest.mock import patch
+
+from struct_module.commands.init import InitCommand, BASIC_STRUCT_YAML
+
+
+def test_init_creates_struct_yaml(tmp_path):
+    parser = argparse.ArgumentParser()
+    cmd = InitCommand(parser)
+
+    target_dir = tmp_path / "proj"
+    args = parser.parse_args([str(target_dir)])
+
+    with patch('builtins.print') as mock_print:
+        cmd.execute(args)
+
+    struct_file = target_dir / '.struct.yaml'
+    assert struct_file.exists()
+
+    content = struct_file.read_text()
+    # Basic checks for key sections
+    assert 'pre_hooks:' in content
+    assert 'post_hooks:' in content
+    assert 'files:' in content
+    assert 'README.md' in content
+    assert 'folders:' in content
+    assert 'github/workflows/run-struct' in content
+
+
+def test_init_skips_if_exists(tmp_path):
+    parser = argparse.ArgumentParser()
+    cmd = InitCommand(parser)
+
+    target_dir = tmp_path / "proj"
+    target_dir.mkdir(parents=True)
+    existing = target_dir / '.struct.yaml'
+    existing.write_text('files: []\n')
+
+    args = parser.parse_args([str(target_dir)])
+
+    with patch('builtins.print') as mock_print:
+        cmd.execute(args)
+        # Should not overwrite existing file
+        assert existing.read_text() == 'files: []\n'
+        # Should print a message about skipping
+        printed = "\n".join(c.args[0] for c in mock_print.call_args_list)
+        assert '.struct.yaml already exists' in printed