@heyai-rules/pilo-masterkit 2.1.0 → 3.1.0

package/.agent/rules/kotlin/testing.md

@@ -1,128 +1,128 @@
----
-paths:
-  - "**/*.kt"
-  - "**/*.kts"
----
-# Kotlin Testing
-
-> This file extends [common/testing.md](../common/testing.md) with Kotlin and Android/KMP-specific content.
-
-## Test Framework
-
-- **kotlin.test** for multiplatform (KMP) — `@Test`, `assertEquals`, `assertTrue`
-- **JUnit 4/5** for Android-specific tests
-- **Turbine** for testing Flows and StateFlow
-- **kotlinx-coroutines-test** for coroutine testing (`runTest`, `TestDispatcher`)
-
-## ViewModel Testing with Turbine
-
-```kotlin
-@Test
-fun `loading state emitted then data`() = runTest {
-    val repo = FakeItemRepository()
-    repo.addItem(testItem)
-    val viewModel = ItemListViewModel(GetItemsUseCase(repo))
-
-    viewModel.state.test {
-        assertEquals(ItemListState(), awaitItem())     // initial state
-        viewModel.onEvent(ItemListEvent.Load)
-        assertTrue(awaitItem().isLoading)               // loading
-        assertEquals(listOf(testItem), awaitItem().items) // loaded
-    }
-}
-```
-
-## Fakes Over Mocks
-
-Prefer hand-written fakes over mocking frameworks:
-
-```kotlin
-class FakeItemRepository : ItemRepository {
-    private val items = mutableListOf<Item>()
-    var fetchError: Throwable? = null
-
-    override suspend fun getAll(): Result<List<Item>> {
-        fetchError?.let { return Result.failure(it) }
-        return Result.success(items.toList())
-    }
-
-    override fun observeAll(): Flow<List<Item>> = flowOf(items.toList())
-
-    fun addItem(item: Item) { items.add(item) }
-}
-```
-
-## Coroutine Testing
-
-```kotlin
-@Test
-fun `parallel operations complete`() = runTest {
-    val repo = FakeRepository()
-    val result = loadDashboard(repo)
-    advanceUntilIdle()
-    assertNotNull(result.items)
-    assertNotNull(result.stats)
-}
-```
-
-Use `runTest` — it auto-advances virtual time and provides `TestScope`.
-
-## Ktor MockEngine
-
-```kotlin
-val mockEngine = MockEngine { request ->
-    when (request.url.encodedPath) {
-        "/api/items" -> respond(
-            content = Json.encodeToString(testItems),
-            headers = headersOf(HttpHeaders.ContentType, ContentType.Application.Json.toString())
-        )
-        else -> respondError(HttpStatusCode.NotFound)
-    }
-}
-
-val client = HttpClient(mockEngine) {
-    install(ContentNegotiation) { json() }
-}
-```
-
-## Room/SQLDelight Testing
-
-- Room: Use `Room.inMemoryDatabaseBuilder()` for in-memory testing
-- SQLDelight: Use `JdbcSqliteDriver(JdbcSqliteDriver.IN_MEMORY)` for JVM tests
-
-```kotlin
-@Test
-fun `insert and query items`() = runTest {
-    val driver = JdbcSqliteDriver(JdbcSqliteDriver.IN_MEMORY)
-    Database.Schema.create(driver)
-    val db = Database(driver)
-
-    db.itemQueries.insert("1", "Sample Item", "description")
-    val items = db.itemQueries.getAll().executeAsList()
-    assertEquals(1, items.size)
-}
-```
-
-## Test Naming
-
-Use backtick-quoted descriptive names:
-
-```kotlin
-@Test
-fun `search with empty query returns all items`() = runTest { }
-
-@Test
-fun `delete item emits updated list without deleted item`() = runTest { }
-```
-
-## Test Organization
-
-```
-src/
-├── commonTest/kotlin/     # Shared tests (ViewModel, UseCase, Repository)
-├── androidUnitTest/kotlin/ # Android unit tests (JUnit)
-├── androidInstrumentedTest/kotlin/  # Instrumented tests (Room, UI)
-└── iosTest/kotlin/        # iOS-specific tests
-```
-
-Minimum test coverage: ViewModel + UseCase for every feature.
+---
+paths:
+  - "**/*.kt"
+  - "**/*.kts"
+---
+# Kotlin Testing
+
+> This file extends [common/testing.md](../common/testing.md) with Kotlin and Android/KMP-specific content.
+
+## Test Framework
+
+- **kotlin.test** for multiplatform (KMP) — `@Test`, `assertEquals`, `assertTrue`
+- **JUnit 4/5** for Android-specific tests
+- **Turbine** for testing Flows and StateFlow
+- **kotlinx-coroutines-test** for coroutine testing (`runTest`, `TestDispatcher`)
+
+## ViewModel Testing with Turbine
+
+```kotlin
+@Test
+fun `loading state emitted then data`() = runTest {
+    val repo = FakeItemRepository()
+    repo.addItem(testItem)
+    val viewModel = ItemListViewModel(GetItemsUseCase(repo))
+
+    viewModel.state.test {
+        assertEquals(ItemListState(), awaitItem())     // initial state
+        viewModel.onEvent(ItemListEvent.Load)
+        assertTrue(awaitItem().isLoading)               // loading
+        assertEquals(listOf(testItem), awaitItem().items) // loaded
+    }
+}
+```
+
+## Fakes Over Mocks
+
+Prefer hand-written fakes over mocking frameworks:
+
+```kotlin
+class FakeItemRepository : ItemRepository {
+    private val items = mutableListOf<Item>()
+    var fetchError: Throwable? = null
+
+    override suspend fun getAll(): Result<List<Item>> {
+        fetchError?.let { return Result.failure(it) }
+        return Result.success(items.toList())
+    }
+
+    override fun observeAll(): Flow<List<Item>> = flowOf(items.toList())
+
+    fun addItem(item: Item) { items.add(item) }
+}
+```
+
+## Coroutine Testing
+
+```kotlin
+@Test
+fun `parallel operations complete`() = runTest {
+    val repo = FakeRepository()
+    val result = loadDashboard(repo)
+    advanceUntilIdle()
+    assertNotNull(result.items)
+    assertNotNull(result.stats)
+}
+```
+
+Use `runTest` — it auto-advances virtual time and provides `TestScope`.
+
+## Ktor MockEngine
+
+```kotlin
+val mockEngine = MockEngine { request ->
+    when (request.url.encodedPath) {
+        "/api/items" -> respond(
+            content = Json.encodeToString(testItems),
+            headers = headersOf(HttpHeaders.ContentType, ContentType.Application.Json.toString())
+        )
+        else -> respondError(HttpStatusCode.NotFound)
+    }
+}
+
+val client = HttpClient(mockEngine) {
+    install(ContentNegotiation) { json() }
+}
+```
+
+## Room/SQLDelight Testing
+
+- Room: Use `Room.inMemoryDatabaseBuilder()` for in-memory testing
+- SQLDelight: Use `JdbcSqliteDriver(JdbcSqliteDriver.IN_MEMORY)` for JVM tests
+
+```kotlin
+@Test
+fun `insert and query items`() = runTest {
+    val driver = JdbcSqliteDriver(JdbcSqliteDriver.IN_MEMORY)
+    Database.Schema.create(driver)
+    val db = Database(driver)
+
+    db.itemQueries.insert("1", "Sample Item", "description")
+    val items = db.itemQueries.getAll().executeAsList()
+    assertEquals(1, items.size)
+}
+```
+
+## Test Naming
+
+Use backtick-quoted descriptive names:
+
+```kotlin
+@Test
+fun `search with empty query returns all items`() = runTest { }
+
+@Test
+fun `delete item emits updated list without deleted item`() = runTest { }
+```
+
+## Test Organization
+
+```
+src/
+├── commonTest/kotlin/     # Shared tests (ViewModel, UseCase, Repository)
+├── androidUnitTest/kotlin/ # Android unit tests (JUnit)
+├── androidInstrumentedTest/kotlin/  # Instrumented tests (Room, UI)
+└── iosTest/kotlin/        # iOS-specific tests
+```
+
+Minimum test coverage: ViewModel + UseCase for every feature.

package/.agent/rules/perl/coding-style.md

@@ -1,46 +1,46 @@
----
-paths:
-  - "**/*.pl"
-  - "**/*.pm"
-  - "**/*.t"
-  - "**/*.psgi"
-  - "**/*.cgi"
----
-# Perl Coding Style
-
-> This file extends [common/coding-style.md](../common/coding-style.md) with Perl-specific content.
-
-## Standards
-
-- Always `use v5.36` (enables `strict`, `warnings`, `say`, subroutine signatures)
-- Use subroutine signatures — never unpack `@_` manually
-- Prefer `say` over `print` with explicit newlines
-
-## Immutability
-
-- Use **Moo** with `is => 'ro'` and `Types::Standard` for all attributes
-- Never use blessed hashrefs directly — always use Moo/Moose accessors
-- **OO override note**: Moo `has` attributes with `builder` or `default` are acceptable for computed read-only values
-
-## Formatting
-
-Use **perltidy** with these settings:
-
-```
--i=4    # 4-space indent
--l=100  # 100 char line length
--ce     # cuddled else
--bar    # opening brace always right
-```
-
-## Linting
-
-Use **perlcritic** at severity 3 with themes: `core`, `pbp`, `security`.
-
-```bash
-perlcritic --severity 3 --theme 'core || pbp || security' lib/
-```
-
-## Reference
-
-See skill: `perl-patterns` for comprehensive modern Perl idioms and best practices.
+---
+paths:
+  - "**/*.pl"
+  - "**/*.pm"
+  - "**/*.t"
+  - "**/*.psgi"
+  - "**/*.cgi"
+---
+# Perl Coding Style
+
+> This file extends [common/coding-style.md](../common/coding-style.md) with Perl-specific content.
+
+## Standards
+
+- Always `use v5.36` (enables `strict`, `warnings`, `say`, subroutine signatures)
+- Use subroutine signatures — never unpack `@_` manually
+- Prefer `say` over `print` with explicit newlines
+
+## Immutability
+
+- Use **Moo** with `is => 'ro'` and `Types::Standard` for all attributes
+- Never use blessed hashrefs directly — always use Moo/Moose accessors
+- **OO override note**: Moo `has` attributes with `builder` or `default` are acceptable for computed read-only values
+
+## Formatting
+
+Use **perltidy** with these settings:
+
+```
+-i=4    # 4-space indent
+-l=100  # 100 char line length
+-ce     # cuddled else
+-bar    # opening brace always right
+```
+
+## Linting
+
+Use **perlcritic** at severity 3 with themes: `core`, `pbp`, `security`.
+
+```bash
+perlcritic --severity 3 --theme 'core || pbp || security' lib/
+```
+
+## Reference
+
+See skill: `perl-patterns` for comprehensive modern Perl idioms and best practices.

package/.agent/rules/perl/hooks.md

@@ -1,22 +1,22 @@
----
-paths:
-  - "**/*.pl"
-  - "**/*.pm"
-  - "**/*.t"
-  - "**/*.psgi"
-  - "**/*.cgi"
----
-# Perl Hooks
-
-> This file extends [common/hooks.md](../common/hooks.md) with Perl-specific content.
-
-## PostToolUse Hooks
-
-Configure in `~/.claude/settings.json`:
-
-- **perltidy**: Auto-format `.pl` and `.pm` files after edit
-- **perlcritic**: Run lint check after editing `.pm` files
-
-## Warnings
-
-- Warn about `print` in non-script `.pm` files — use `say` or a logging module (e.g., `Log::Any`)
+---
+paths:
+  - "**/*.pl"
+  - "**/*.pm"
+  - "**/*.t"
+  - "**/*.psgi"
+  - "**/*.cgi"
+---
+# Perl Hooks
+
+> This file extends [common/hooks.md](../common/hooks.md) with Perl-specific content.
+
+## PostToolUse Hooks
+
+Configure in `~/.claude/settings.json`:
+
+- **perltidy**: Auto-format `.pl` and `.pm` files after edit
+- **perlcritic**: Run lint check after editing `.pm` files
+
+## Warnings
+
+- Warn about `print` in non-script `.pm` files — use `say` or a logging module (e.g., `Log::Any`)

package/.agent/rules/perl/patterns.md

@@ -1,76 +1,76 @@
----
-paths:
-  - "**/*.pl"
-  - "**/*.pm"
-  - "**/*.t"
-  - "**/*.psgi"
-  - "**/*.cgi"
----
-# Perl Patterns
-
-> This file extends [common/patterns.md](../common/patterns.md) with Perl-specific content.
-
-## Repository Pattern
-
-Use **DBI** or **DBIx::Class** behind an interface:
-
-```perl
-package MyApp::Repo::User;
-use Moo;
-
-has dbh => (is => 'ro', required => 1);
-
-sub find_by_id ($self, $id) {
-    my $sth = $self->dbh->prepare('SELECT * FROM users WHERE id = ?');
-    $sth->execute($id);
-    return $sth->fetchrow_hashref;
-}
-```
-
-## DTOs / Value Objects
-
-Use **Moo** classes with **Types::Standard** (equivalent to Python dataclasses):
-
-```perl
-package MyApp::DTO::User;
-use Moo;
-use Types::Standard qw(Str Int);
-
-has name  => (is => 'ro', isa => Str, required => 1);
-has email => (is => 'ro', isa => Str, required => 1);
-has age   => (is => 'ro', isa => Int);
-```
-
-## Resource Management
-
-- Always use **three-arg open** with `autodie`
-- Use **Path::Tiny** for file operations
-
-```perl
-use autodie;
-use Path::Tiny;
-
-my $content = path('config.json')->slurp_utf8;
-```
-
-## Module Interface
-
-Use `Exporter 'import'` with `@EXPORT_OK` — never `@EXPORT`:
-
-```perl
-use Exporter 'import';
-our @EXPORT_OK = qw(parse_config validate_input);
-```
-
-## Dependency Management
-
-Use **cpanfile** + **carton** for reproducible installs:
-
-```bash
-carton install
-carton exec prove -lr t/
-```
-
-## Reference
-
-See skill: `perl-patterns` for comprehensive modern Perl patterns and idioms.
+---
+paths:
+  - "**/*.pl"
+  - "**/*.pm"
+  - "**/*.t"
+  - "**/*.psgi"
+  - "**/*.cgi"
+---
+# Perl Patterns
+
+> This file extends [common/patterns.md](../common/patterns.md) with Perl-specific content.
+
+## Repository Pattern
+
+Use **DBI** or **DBIx::Class** behind an interface:
+
+```perl
+package MyApp::Repo::User;
+use Moo;
+
+has dbh => (is => 'ro', required => 1);
+
+sub find_by_id ($self, $id) {
+    my $sth = $self->dbh->prepare('SELECT * FROM users WHERE id = ?');
+    $sth->execute($id);
+    return $sth->fetchrow_hashref;
+}
+```
+
+## DTOs / Value Objects
+
+Use **Moo** classes with **Types::Standard** (equivalent to Python dataclasses):
+
+```perl
+package MyApp::DTO::User;
+use Moo;
+use Types::Standard qw(Str Int);
+
+has name  => (is => 'ro', isa => Str, required => 1);
+has email => (is => 'ro', isa => Str, required => 1);
+has age   => (is => 'ro', isa => Int);
+```
+
+## Resource Management
+
+- Always use **three-arg open** with `autodie`
+- Use **Path::Tiny** for file operations
+
+```perl
+use autodie;
+use Path::Tiny;
+
+my $content = path('config.json')->slurp_utf8;
+```
+
+## Module Interface
+
+Use `Exporter 'import'` with `@EXPORT_OK` — never `@EXPORT`:
+
+```perl
+use Exporter 'import';
+our @EXPORT_OK = qw(parse_config validate_input);
+```
+
+## Dependency Management
+
+Use **cpanfile** + **carton** for reproducible installs:
+
+```bash
+carton install
+carton exec prove -lr t/
+```
+
+## Reference
+
+See skill: `perl-patterns` for comprehensive modern Perl patterns and idioms.

package/.agent/rules/perl/security.md

@@ -1,69 +1,69 @@
----
-paths:
-  - "**/*.pl"
-  - "**/*.pm"
-  - "**/*.t"
-  - "**/*.psgi"
-  - "**/*.cgi"
----
-# Perl Security
-
-> This file extends [common/security.md](../common/security.md) with Perl-specific content.
-
-## Taint Mode
-
-- Use `-T` flag on all CGI/web-facing scripts
-- Sanitize `%ENV` (`$ENV{PATH}`, `$ENV{CDPATH}`, etc.) before any external command
-
-## Input Validation
-
-- Use allowlist regex for untainting — never `/(.*)/s`
-- Validate all user input with explicit patterns:
-
-```perl
-if ($input =~ /\A([a-zA-Z0-9_-]+)\z/) {
-    my $clean = $1;
-}
-```
-
-## File I/O
-
-- **Three-arg open only** — never two-arg open
-- Prevent path traversal with `Cwd::realpath`:
-
-```perl
-use Cwd 'realpath';
-my $safe_path = realpath($user_path);
-die "Path traversal" unless $safe_path =~ m{\A/allowed/directory/};
-```
-
-## Process Execution
-
-- Use **list-form `system()`** — never single-string form
-- Use **IPC::Run3** for capturing output
-- Never use backticks with variable interpolation
-
-```perl
-system('grep', '-r', $pattern, $directory);  # safe
-```
-
-## SQL Injection Prevention
-
-Always use DBI placeholders — never interpolate into SQL:
-
-```perl
-my $sth = $dbh->prepare('SELECT * FROM users WHERE email = ?');
-$sth->execute($email);
-```
-
-## Security Scanning
-
-Run **perlcritic** with the security theme at severity 4+:
-
-```bash
-perlcritic --severity 4 --theme security lib/
-```
-
-## Reference
-
-See skill: `perl-security` for comprehensive Perl security patterns, taint mode, and safe I/O.
+---
+paths:
+  - "**/*.pl"
+  - "**/*.pm"
+  - "**/*.t"
+  - "**/*.psgi"
+  - "**/*.cgi"
+---
+# Perl Security
+
+> This file extends [common/security.md](../common/security.md) with Perl-specific content.
+
+## Taint Mode
+
+- Use `-T` flag on all CGI/web-facing scripts
+- Sanitize `%ENV` (`$ENV{PATH}`, `$ENV{CDPATH}`, etc.) before any external command
+
+## Input Validation
+
+- Use allowlist regex for untainting — never `/(.*)/s`
+- Validate all user input with explicit patterns:
+
+```perl
+if ($input =~ /\A([a-zA-Z0-9_-]+)\z/) {
+    my $clean = $1;
+}
+```
+
+## File I/O
+
+- **Three-arg open only** — never two-arg open
+- Prevent path traversal with `Cwd::realpath`:
+
+```perl
+use Cwd 'realpath';
+my $safe_path = realpath($user_path);
+die "Path traversal" unless $safe_path =~ m{\A/allowed/directory/};
+```
+
+## Process Execution
+
+- Use **list-form `system()`** — never single-string form
+- Use **IPC::Run3** for capturing output
+- Never use backticks with variable interpolation
+
+```perl
+system('grep', '-r', $pattern, $directory);  # safe
+```
+
+## SQL Injection Prevention
+
+Always use DBI placeholders — never interpolate into SQL:
+
+```perl
+my $sth = $dbh->prepare('SELECT * FROM users WHERE email = ?');
+$sth->execute($email);
+```
+
+## Security Scanning
+
+Run **perlcritic** with the security theme at severity 4+:
+
+```bash
+perlcritic --severity 4 --theme security lib/
+```
+
+## Reference
+
+See skill: `perl-security` for comprehensive Perl security patterns, taint mode, and safe I/O.