Add skit-analyze implementation plan and dependencies

- Add comprehensive plan for skit-analyze CLI tool (Docs/skit-analyze-plan.md)
- Tool will auto-generate updated SyntaxKit library from DSL specifications
- Uses Claude API to analyze gaps and generate implementation code
- Add ConfigKeyKit to Sources/ for configuration management
- Add swift-configuration documentation for reference
- Input: folder with dsl.swift + expected.swift (AST auto-generated)
- Output: updated SyntaxKit library ready to build

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: leogdion

.claude/https_-swiftpackageindex.com-apple-swift-configuration-1.0.0-documentation-configuration.md

@@ -0,0 +1,61 @@
+//
+//  Command.swift
+//  ConfigKeyKit
+//
+//  Created by Leo Dion.
+//  Copyright © 2026 BrightDigit.
+//
+//  Permission is hereby granted, free of charge, to any person
+//  obtaining a copy of this software and associated documentation
+//  files (the "Software"), to deal in the Software without
+//  restriction, including without limitation the rights to use,
+//  copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the
+//  Software is furnished to do so, subject to the following
+//  conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+//  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+//  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+//  OTHER DEALINGS IN THE SOFTWARE.
+//
+
+import Foundation
+
+/// Generic protocol for CLI commands using Swift Configuration
+public protocol Command: Sendable {
+    /// Associated configuration type for this command
+    associatedtype Config: ConfigurationParseable
+    
+    /// Command name for CLI parsing
+    static var commandName: String { get }
+    
+    /// Abstract description of the command
+    static var abstract: String { get }
+    
+    /// Detailed help text for the command
+    static var helpText: String { get }
+    
+    /// Initialize command with configuration
+    init(config: Config)
+
+    /// Execute the command asynchronously
+    func execute() async throws
+
+    /// Create a command instance with configuration
+    static func createInstance() async throws -> Self
+}
+
+public extension Command {
+    /// Print help information for this command
+    static func printHelp() {
+        print(helpText)
+    }
+}

Docs/skit-analyze-plan.md

@@ -0,0 +1,39 @@
+//
+//  CommandConfiguration.swift
+//  ConfigKeyKit
+//
+//  Created by Leo Dion.
+//  Copyright © 2026 BrightDigit.
+//
+//  Permission is hereby granted, free of charge, to any person
+//  obtaining a copy of this software and associated documentation
+//  files (the "Software"), to deal in the Software without
+//  restriction, including without limitation the rights to use,
+//  copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the
+//  Software is furnished to do so, subject to the following
+//  conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+//  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+//  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+//  OTHER DEALINGS IN THE SOFTWARE.
+//
+
+/// Command configuration for identifying and routing commands
+public struct CommandConfiguration {
+    public let commandName: String
+    public let abstract: String
+    
+    public init(commandName: String, abstract: String) {
+        self.commandName = commandName
+        self.abstract = abstract
+    }
+}

Sources/ConfigKeyKit/Command.swift

@@ -0,0 +1,74 @@
+//
+//  CommandLineParser.swift
+//  ConfigKeyKit
+//
+//  Created by Leo Dion.
+//  Copyright © 2026 BrightDigit.
+//
+//  Permission is hereby granted, free of charge, to any person
+//  obtaining a copy of this software and associated documentation
+//  files (the "Software"), to deal in the Software without
+//  restriction, including without limitation the rights to use,
+//  copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the
+//  Software is furnished to do so, subject to the following
+//  conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+//  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+//  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+//  OTHER DEALINGS IN THE SOFTWARE.
+//
+
+import Foundation
+
+/// Command line argument parser for Swift Configuration integration
+public struct CommandLineParser {
+    private let arguments: [String]
+    
+    public init(arguments: [String] = CommandLine.arguments) {
+        self.arguments = arguments
+    }
+    
+    /// Parse the command name from command line arguments
+    public func parseCommandName() -> String? {
+        // Skip the executable name (first argument)
+        guard arguments.count > 1 else { return nil }
+        let commandCandidate = arguments[1]
+        
+        // If it starts with '--', it's not a command but a global option
+        if commandCandidate.hasPrefix("--") {
+            return nil
+        }
+        
+        return commandCandidate
+    }
+    
+    /// Get all arguments after the command name for command-specific parsing
+    public func commandArguments() -> [String] {
+        guard arguments.count > 1 else { return [] }
+        let commandName = arguments[1]
+        
+        // If first argument is an option, return all arguments for global parsing
+        if commandName.hasPrefix("--") {
+            return Array(arguments.dropFirst())
+        }
+        
+        // Return arguments after command name
+        return Array(arguments.dropFirst(2))
+    }
+    
+    /// Check if help was requested
+    public func isHelpRequested() -> Bool {
+        arguments.contains { arg in
+            arg == "--help" || arg == "-h" || arg == "help"
+        }
+    }
+}

Sources/ConfigKeyKit/CommandConfiguration.swift

@@ -0,0 +1,88 @@
+//
+//  CommandRegistry.swift
+//  ConfigKeyKit
+//
+//  Created by Leo Dion.
+//  Copyright © 2026 BrightDigit.
+//
+//  Permission is hereby granted, free of charge, to any person
+//  obtaining a copy of this software and associated documentation
+//  files (the "Software"), to deal in the Software without
+//  restriction, including without limitation the rights to use,
+//  copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the
+//  Software is furnished to do so, subject to the following
+//  conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+//  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+//  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+//  OTHER DEALINGS IN THE SOFTWARE.
+//
+
+import Foundation
+
+/// Actor-based registry for managing available commands
+public actor CommandRegistry {
+    private var registeredCommands: [String: any Command.Type] = [:]
+    private var commandMetadata: [String: CommandMetadata] = [:]
+
+    /// Metadata about a command
+    public struct CommandMetadata: Sendable {
+        public let commandName: String
+        public let abstract: String
+        public let helpText: String
+    }
+
+    /// Shared instance
+    public static let shared = CommandRegistry()
+
+    // Internal initializer for testability - allows tests to create isolated instances
+    internal init() {}
+
+    /// Register a command type with the registry
+    public func register<T: Command>(_ commandType: T.Type) {
+        registeredCommands[T.commandName] = commandType
+        commandMetadata[T.commandName] = CommandMetadata(
+            commandName: T.commandName,
+            abstract: T.abstract,
+            helpText: T.helpText
+        )
+    }
+
+    /// Get all registered command names
+    public var availableCommands: [String] {
+        Array(registeredCommands.keys).sorted()
+    }
+
+    /// Get command metadata
+    public func metadata(for name: String) -> CommandMetadata? {
+        commandMetadata[name]
+    }
+
+    /// Get command type for the given name
+    public func commandType(named name: String) -> (any Command.Type)? {
+        return registeredCommands[name]
+    }
+
+    /// Create a command instance dynamically with automatic config parsing
+    public func createCommand(named name: String) async throws -> any Command {
+        guard let commandType = registeredCommands[name] else {
+            throw CommandRegistryError.unknownCommand(name)
+        }
+
+        return try await commandType.createInstance()
+    }
+
+    /// Check if a command is registered
+    public func isRegistered(_ name: String) -> Bool {
+        return registeredCommands[name] != nil
+    }
+}

Sources/ConfigKeyKit/CommandLineParser.swift

@@ -0,0 +1,42 @@
+//
+//  CommandRegistryError.swift
+//  ConfigKeyKit
+//
+//  Created by Leo Dion.
+//  Copyright © 2026 BrightDigit.
+//
+//  Permission is hereby granted, free of charge, to any person
+//  obtaining a copy of this software and associated documentation
+//  files (the "Software"), to deal in the Software without
+//  restriction, including without limitation the rights to use,
+//  copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the
+//  Software is furnished to do so, subject to the following
+//  conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+//  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+//  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+//  OTHER DEALINGS IN THE SOFTWARE.
+//
+
+public import Foundation
+
+/// Errors that can occur in command registry operations
+public enum CommandRegistryError: Error, LocalizedError {
+    case unknownCommand(String)
+    
+    public var errorDescription: String? {
+        switch self {
+        case .unknownCommand(let name):
+            return "Unknown command: \(name)"
+        }
+    }
+}

Sources/ConfigKeyKit/CommandRegistry.swift

@@ -0,0 +1,72 @@
+//
+//  ConfigKey+Bool.swift
+//  MistDemo
+//
+//  Created by Leo Dion.
+//  Copyright © 2026 BrightDigit.
+//
+//  Permission is hereby granted, free of charge, to any person
+//  obtaining a copy of this software and associated documentation
+//  files (the "Software"), to deal in the Software without
+//  restriction, including without limitation the rights to use,
+//  copy, modify, merge, publish, distribute, sublicense, and/or
+//  sell copies of the Software, and to permit persons to whom the
+//  Software is furnished to do so, subject to the following
+//  conditions:
+//
+//  The above copyright notice and this permission notice shall be
+//  included in all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+//  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+//  OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+//  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+//  HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+//  WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+//  FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+//  OTHER DEALINGS IN THE SOFTWARE.
+//
+
+import Foundation
+
+// MARK: - Specialized Initializers for Booleans
+
+extension ConfigKey where Value == Bool {
+  /// Non-optional default value accessor for booleans
+  @available(*, deprecated, message: "Use defaultValue directly instead")
+  public var boolDefault: Bool {
+    defaultValue  // Already non-optional!
+  }
+
+  /// Initialize a boolean configuration key with non-optional default
+  /// - Parameters:
+  ///   - cli: Command-line argument name
+  ///   - env: Environment variable name
+  ///   - defaultVal: Default value (defaults to false)
+  public init(cli: String, env: String, default defaultVal: Bool = false) {
+    self.baseKey = nil
+    self.styles = [:]
+    var keys: [ConfigKeySource: String] = [:]
+    keys[.commandLine] = cli
+    keys[.environment] = env
+    self.explicitKeys = keys
+    self.defaultValue = defaultVal
+  }
+
+  /// Initialize a boolean configuration key from base string
+  /// - Parameters:
+  ///   - base: Base key string (e.g., "sync.verbose")
+  ///   - envPrefix: Prefix for environment variable (defaults to nil)
+  ///   - defaultVal: Default value (defaults to false)
+  public init(_ base: String, envPrefix: String? = nil, default defaultVal: Bool = false) {
+    self.baseKey = base
+    self.styles = [
+      .commandLine: StandardNamingStyle.dotSeparated,
+      .environment: StandardNamingStyle.screamingSnakeCase(prefix: envPrefix),
+    ]
+    self.explicitKeys = [:]
+    self.defaultValue = defaultVal
+  }
+}
+
+// Application-specific boolean key helpers should be added in application code