feat(guardian): add guardian package - code quality analyzer

Add @puaros/guardian package v0.1.0 - code quality guardian for vibe coders and enterprise teams.

Features:
- Hardcode detection (magic numbers, magic strings)
- Circular dependency detection
- Naming convention enforcement (Clean Architecture)
- Architecture violation detection
- CLI tool with comprehensive reporting
- 159 tests with 80%+ coverage
- Smart suggestions for fixes
- Built for AI-assisted development

Built with Clean Architecture and DDD principles.
Works with Claude, GPT, Copilot, Cursor, and any AI coding assistant.

packages/guardian/src/domain/services/IFileScanner.ts

@@ -0,0 +1,15 @@
+export interface FileScanOptions {
+    rootDir: string
+    include?: string[]
+    exclude?: string[]
+    extensions?: string[]
+}
+
+/**
+ * Interface for scanning project files
+ * Allows infrastructure implementations without domain coupling
+ */
+export interface IFileScanner {
+    scan(options: FileScanOptions): Promise<string[]>
+    readFile(filePath: string): Promise<string>
+}