codna 0.1.0__py3-none-any.whl

codna/agent-core/vendor/cline/sdk/examples/cron/daily-code-review.cron.md

@@ -0,0 +1,28 @@
+---
+id: daily-code-review
+title: Daily Code Review
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 9 * * MON-FRI"
+tools: run_commands,read_files
+mode: act
+enabled: true
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 1800
+systemPrompt: You are a precise automation agent that reports only actionable review findings.
+maxIterations: 20
+tags:
+  - automation
+  - review
+metadata:
+  owner: platform
+notesDirectory: /absolute/path/to/notes
+extensions:
+  - rules
+  - skills
+  - plugins
+source: user
+---
+Review the open pull requests, identify the highest-risk changes, run the
+relevant checks if needed, and write a concise summary of findings.

codna/agent-core/vendor/cline/sdk/examples/cron/dead-code-finder.cron.md

@@ -0,0 +1,58 @@
+---
+id: dead-code-finder
+title: Find and Report Dead Code
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 4 * * SUN"
+tools: run_commands,read_files,search_codebase
+mode: plan
+enabled: false
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 2400
+maxIterations: 30
+tags:
+  - automation
+  - quality
+  - refactoring
+metadata:
+  owner: development
+  reportType: analysis
+---
+Scan the codebase for dead code and unused exports:
+
+1. Identify unused exports:
+   - Functions not called within the module or by external modules
+   - Classes with no instantiations
+   - Constants/variables not referenced
+   - Type definitions not used
+
+2. Detect unreachable code patterns:
+   - Statements after return/throw
+   - Unreachable branches in conditionals
+   - Dead try-catch blocks
+   - Unused catch parameters
+
+3. Analyze file-level patterns:
+   - Modules that are never imported
+   - Test files without corresponding implementation
+   - Example/demo code in main codebase
+   - Deprecated or marked-for-removal code
+
+Generate a comprehensive report with:
+- Dead code segments (with file locations and line numbers)
+- Confidence level for each finding (high/medium/low)
+- Safe-to-remove vs requires-review items
+- Estimated code reduction if cleanup is done
+
+Safe removals candidates:
+- Variables only assigned, never read
+- Functions declared but never called
+- Exported items with no external references
+
+Requires review:
+- Code that might be called dynamically
+- Public APIs (check if external consumers exist)
+- Backwards-compatibility concerns
+
+Use plan mode to suggest removals without applying them.

codna/agent-core/vendor/cline/sdk/examples/cron/dependency-check.cron.md

@@ -0,0 +1,35 @@
+---
+id: dependency-check
+title: Weekly Dependency Health Check
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 10 * * MON"
+tools: run_commands,read_files
+mode: act
+enabled: false
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 1800
+maxIterations: 15
+tags:
+  - automation
+  - security
+  - dependencies
+metadata:
+  owner: platform
+---
+Run a comprehensive dependency health check:
+
+1. Check for outdated packages: `npm outdated` (or yarn/pnpm equivalent)
+2. Check for security vulnerabilities: `npm audit` 
+3. List packages with available major version upgrades
+4. Identify unused dependencies (if possible)
+5. Check for dependency conflicts or duplicate packages
+
+Provide a summary report covering:
+- Critical security vulnerabilities (if any)
+- Count of outdated packages by severity (minor, patch, major)
+- Recommended immediate actions
+- Packages safe to update to latest versions
+
+Focus on actionable insights. Ignore known false positives and dev-only dependencies.

codna/agent-core/vendor/cline/sdk/examples/cron/documentation-check.cron.md

@@ -0,0 +1,66 @@
+---
+id: documentation-check
+title: Documentation Coverage Audit
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 5 * * THU"
+tools: run_commands,read_files,search_codebase
+mode: plan
+enabled: false
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 1800
+maxIterations: 25
+tags:
+  - automation
+  - documentation
+  - quality
+metadata:
+  owner: documentation
+  checkAreas:
+    - publicAPIs
+    - complexFunctions
+    - typeDefinitions
+    - modules
+---
+Audit documentation coverage across the codebase:
+
+1. Check public API documentation:
+   - Functions exported from public modules
+   - Classes and interfaces
+   - Type definitions and generics
+   - Decorators and annotations
+
+2. Identify missing documentation:
+   - Public functions without JSDoc comments
+   - Complex functions without explanation
+   - Public types without descriptions
+   - Exported modules without README or header comments
+
+3. Evaluate existing documentation quality:
+   - JSDoc comments without @param or @return tags
+   - Comments that are outdated or misleading
+   - Code samples in docs that may be broken
+   - Links in documentation that point to removed code
+
+4. Analyze documentation structure:
+   - Main README quality and completeness
+   - Architecture documentation
+   - Contributing guide existence
+   - API reference documentation
+   - Changelog maintenance
+
+Generate report with sections:
+- Documentation coverage percentage by module
+- Top 10 undocumented public APIs
+- Types with missing descriptions
+- Files with complex logic needing explanation
+- Outdated documentation instances
+
+Recommendations:
+- High-priority items (public APIs without docs)
+- Documentation style improvements
+- Template suggestions for JSDoc
+- Links that need updating
+
+Use plan mode to suggest improvements without applying changes.

codna/agent-core/vendor/cline/sdk/examples/cron/events/local-manual-test.event.md

@@ -0,0 +1,28 @@
+---
+id: local-manual-test
+title: Local Manual Event Test
+workspaceRoot: /absolute/path/to/repo
+cwd: /absolute/path/to/repo
+event: local.manual_test
+filters:
+  topic: cron-feature-2
+debounceSeconds: 0
+dedupeWindowSeconds: 60
+cooldownSeconds: 0
+maxParallel: 1
+mode: act
+enabled: true
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 300
+maxIterations: 5
+tags:
+  - automation
+  - local-test
+metadata:
+  owner: platform
+  source: local-smoke-test
+---
+Use the normalized trigger event context to confirm event-driven automation is
+working locally. Summarize the event id, subject, topic, and payload message.

codna/agent-core/vendor/cline/sdk/examples/cron/events/local-plugin-event.event.md

@@ -0,0 +1,20 @@
+---
+id: local-plugin-event
+title: Local Plugin Event
+workspaceRoot: /absolute/path/to/repo
+cwd: /absolute/path/to/repo
+event: local.plugin_event
+filters:
+  topic: plugin-demo
+dedupeWindowSeconds: 5
+cooldownSeconds: 5
+maxParallel: 1
+tags:
+  - local
+  - plugin
+  - automation
+metadata:
+  source: examples/plugins/automation-events.ts
+---
+Summarize the local plugin event and report the event subject, topic, and
+message payload.

codna/agent-core/vendor/cline/sdk/examples/cron/events/pr-changelog-check.event.md

@@ -0,0 +1,42 @@
+---
+id: pr-changelog-check
+title: Check for Changelog Updates in PRs
+workspaceRoot: /absolute/path/to/repo
+event: github.pull_request.opened
+filters:
+  repository: your-org/your-repo
+  pullRequest:
+    baseBranch: main
+debounceSeconds: 10
+cooldownSeconds: 60
+maxParallel: 3
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+tags:
+  - automation
+  - github
+  - documentation
+metadata:
+  owner: development
+---
+Automatically check if a PR that modifies code also updates the CHANGELOG:
+
+1. Detect if the PR modifies source files (src/, lib/, etc.)
+2. Check if the PR also includes changes to CHANGELOG.md or relevant changelogs
+3. If significant code changes but no changelog update:
+   - Extract a summary of the changes
+   - Suggest what should be added to CHANGELOG
+   - Request the author to add an entry
+
+4. If CHANGELOG is updated:
+   - Verify the format matches the project style
+   - Check that entry is concise and user-facing
+   - Ensure version number is appropriate
+
+Provide feedback as a comment on the PR:
+- ✅ CHANGELOG properly updated
+- ⚠️  No CHANGELOG changes detected - please add an entry
+- 🤔 CHANGELOG entry format seems off - consider [example]
+
+This helps maintain an up-to-date CHANGELOG without manual reminders.

codna/agent-core/vendor/cline/sdk/examples/cron/events/pr-review.event.md

@@ -0,0 +1,32 @@
+---
+id: pr-review
+title: Review New Pull Requests
+workspaceRoot: /absolute/path/to/repo
+cwd: /absolute/path/to/repo
+event: github.pull_request.opened
+filters:
+  repository: acme/api
+  pullRequest:
+    baseBranch: main
+debounceSeconds: 30
+dedupeWindowSeconds: 600
+cooldownSeconds: 120
+maxParallel: 2
+mode: act
+enabled: true
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 1800
+maxIterations: 20
+tags:
+  - automation
+  - github
+  - review
+metadata:
+  owner: platform
+  source: normalized-event-ingress
+---
+Review the opened pull request from the trigger event context. Summarize the
+highest-risk changes, call out missing tests or migration risks, and recommend
+the next action for the author.

codna/agent-core/vendor/cline/sdk/examples/cron/events/pr-test-coverage.event.md

@@ -0,0 +1,55 @@
+---
+id: pr-test-coverage
+title: Analyze Test Coverage Impact of PR
+workspaceRoot: /absolute/path/to/repo
+event: github.pull_request.synchronize
+filters:
+  repository: your-org/your-repo
+  pullRequest:
+    baseBranch: main
+debounceSeconds: 30
+cooldownSeconds: 120
+maxParallel: 2
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+tags:
+  - automation
+  - github
+  - testing
+metadata:
+  owner: qa
+  checkMetrics:
+    - lineCoverage
+    - branchCoverage
+    - newFilesCoverage
+---
+Analyze test coverage impact when a PR is updated:
+
+1. Checkout the PR branch
+2. Run test coverage: `npm run test:coverage`
+3. Compare coverage to main branch:
+   - Lines added with coverage
+   - Lines added without coverage
+   - Files with decreased coverage
+   - New files with low coverage
+
+4. Generate a coverage impact report showing:
+   - Coverage change percentage
+   - Files with added uncovered code
+   - Critical gaps in new functionality
+   - Suggestions for missing tests
+
+5. Post results as PR comment with:
+   - Overall coverage impact (↑ or ↓)
+   - File-by-file breakdown
+   - Specific line ranges needing tests
+   - Recommendations for test additions
+
+Color code the feedback:
+- 🟢 Coverage improved
+- 🟡 Coverage maintained
+- 🔴 Coverage decreased
+- ⚫ New code without tests
+
+Help maintain test quality standards without blocking the PR.

codna/agent-core/vendor/cline/sdk/examples/cron/performance-baseline.cron.md

@@ -0,0 +1,45 @@
+---
+id: performance-baseline
+title: Track Performance Metrics
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 2 * * *"
+tools: run_commands,read_files,editor
+mode: act
+enabled: false
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 2400
+maxIterations: 20
+tags:
+  - automation
+  - performance
+  - monitoring
+metadata:
+  owner: platform
+  metricsFile: .perf-baseline.json
+---
+Measure and track performance baselines for the project:
+
+1. Build the project and measure build time: `npm run build`
+2. Bundle size analysis (if applicable): Run bundler with size reporting
+3. Cold start time if this is a CLI/server tool
+4. Run performance benchmarks if they exist
+
+Create or update `.perf-baseline.json` with:
+```json
+{
+  "timestamp": "ISO-8601",
+  "buildTime": "milliseconds",
+  "bundleSize": "bytes",
+  "coldStart": "milliseconds",
+  "metrics": {...}
+}
+```
+
+Detect performance regressions:
+- If build time increased by >10%, flag as warning
+- If bundle size increased by >5%, flag as concern
+- Compare to previous day's baseline
+
+Report findings with recommendations for optimization if regressions detected.

codna/agent-core/vendor/cline/sdk/examples/cron/test-coverage-report.cron.md

@@ -0,0 +1,41 @@
+---
+id: test-coverage-report
+title: Generate Test Coverage Report
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 22 * * *"
+tools: run_commands,read_files
+mode: act
+enabled: false
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 2400
+maxIterations: 25
+tags:
+  - automation
+  - testing
+  - quality
+metadata:
+  owner: qa
+  reportFormat: markdown
+---
+Run test suite and generate a coverage report:
+
+1. Run the full test suite: `npm test` or equivalent
+2. Generate coverage report in JSON format: `npm run test:coverage`
+3. Parse the coverage data to identify:
+   - Overall coverage percentage (lines, branches, functions, statements)
+   - Files with coverage below 80%
+   - Files with coverage below 50% (critical)
+   - Coverage trends (if previous reports exist)
+
+Create a markdown summary showing:
+- Overall coverage metrics with visual progress bars
+- Top 5 files needing coverage improvements
+- Test results: total tests, passed, failed, skipped
+- Recommendations for improving test coverage
+
+Include emoji indicators for health status:
+- 🟢 Excellent (>90%)
+- 🟡 Good (70-90%)
+- 🔴 Needs attention (<70%)

codna/agent-core/vendor/cline/sdk/examples/cron/type-check-strict.cron.md

@@ -0,0 +1,44 @@
+---
+id: type-check-strict
+title: Strict TypeScript Type Checking
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 6 * * *"
+tools: run_commands,read_files
+mode: plan
+enabled: false
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 1800
+maxIterations: 20
+tags:
+  - automation
+  - quality
+  - typescript
+metadata:
+  owner: development
+  strictLevel: strict
+---
+Run TypeScript type checking with strict compiler options:
+
+1. Run `tsc --noEmit` with strict mode settings
+2. Collect all type errors and warnings
+3. Categorize errors:
+   - Missing type annotations
+   - Implicit any types
+   - Null/undefined safety issues
+   - Generic type issues
+   - Import/export mismatches
+
+Generate a detailed report showing:
+- Total type errors
+- Errors by category with counts
+- Top 10 files with most type errors
+- Specific recommendations for each category
+
+Suggest improvements:
+- Files that would benefit from JSDoc
+- Places where explicit types would improve clarity
+- Breaking changes if we made types more strict
+
+Use plan mode to suggest fixes without applying them automatically.

codna/agent-core/vendor/cline/sdk/examples/cron/weekly-metrics-summary.cron.md

@@ -0,0 +1,67 @@
+---
+id: weekly-metrics-summary
+title: Weekly Project Metrics Summary
+workspaceRoot: /absolute/path/to/repo
+schedule: "0 17 * * FRI"
+tools: run_commands,read_files,search_codebase
+mode: act
+enabled: false
+modelSelection:
+  providerId: cline
+  modelId: anthropic/claude-opus-4.7
+timeoutSeconds: 1800
+maxIterations: 20
+tags:
+  - automation
+  - metrics
+  - team
+metadata:
+  owner: leadership
+  reportFormat: markdown
+---
+Generate a fun and insightful weekly metrics summary for the team:
+
+Collect metrics from the past 7 days:
+
+1. **Code Activity:**
+   - Total commits this week
+   - Lines added/deleted
+   - Most active contributors
+   - Most modified files
+
+2. **Quality Metrics:**
+   - Test pass rate
+   - Test coverage trend (up/down %)
+   - New issues introduced vs. fixed
+   - Type check errors (trend)
+
+3. **Performance:**
+   - Build time trend
+   - Bundle size changes
+   - Performance regressions detected
+
+4. **Pull Requests:**
+   - PRs opened vs. closed
+   - Average review time
+   - PRs by author
+   - Most reviewed files
+
+5. **Development Velocity:**
+   - Story points completed (if using)
+   - Bugs fixed vs. features added
+   - On-schedule vs. blocked tasks
+
+Create a fun markdown report with:
+- 🏆 Top contributor of the week (most commits/reviews)
+- 📈 Metrics trending up/down with arrows
+- 🎯 Week's accomplishments summary
+- ⚠️  Metrics needing attention
+- 💡 Insights (e.g., "Performance improved 5% this week!")
+- 🔥 "Hot spots" (most frequently modified files)
+
+Include emoji indicators and fun facts:
+- 🚀 Most commits in a single day
+- 👀 Most reviewed PR
+- 🐛 Most bug fixes by individual
+
+Make it celebratory but data-driven. Perfect for team morale on Friday!

codna/agent-core/vendor/cline/sdk/examples/hooks/PostToolUse.py

@@ -0,0 +1,62 @@
+#!/usr/bin/env python3
+"""
+Cline Hook: PostToolUse (Python)
+Logs tool results after execution and enriches with environment context.
+Copy to ~/.cline/hooks/PostToolUse.py and chmod +x
+"""
+
+import sys
+import json
+import os
+import subprocess
+
+def get_git_branch():
+    """Get current git branch if in a repo."""
+    try:
+        result = subprocess.run(
+            ["git", "branch", "--show-current"],
+            capture_output=True,
+            text=True,
+            timeout=2
+        )
+        return result.stdout.strip() if result.returncode == 0 else None
+    except Exception:
+        return None
+
+def main():
+    # Read event payload from stdin
+    try:
+        event = json.load(sys.stdin)
+    except json.JSONDecodeError as e:
+        print(json.dumps({"errorMessage": f"Failed to parse hook input: {e}"}))
+        return
+
+    # Extract tool result information
+    tool_result = event.get("tool_result", {})
+    post_tool_use = event.get("postToolUse", {})
+    tool_name = tool_result.get("name", "unknown")
+    success = post_tool_use.get("success", False)
+    duration_ms = post_tool_use.get("executionTimeMs", 0)
+
+    # Log result
+    status = "✅" if success else "❌"
+    print(f"{status} Tool completed: {tool_name} ({duration_ms}ms)", file=sys.stderr)
+
+    # For run_commands, inject environment context
+    if tool_name == "run_commands":
+        git_branch = get_git_branch()
+        context_parts = []
+
+        if git_branch:
+            context_parts.append(f"git branch: {git_branch}")
+
+        if context_parts:
+            context = "Environment: " + ", ".join(context_parts)
+            print(json.dumps({"context": context}))
+            return
+
+    # Return empty control object
+    print(json.dumps({}))
+
+if __name__ == "__main__":
+    main()

codna/agent-core/vendor/cline/sdk/examples/hooks/PostToolUse.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# Cline Hook: PostToolUse
+# Logs tool results after execution
+# Copy to ~/.cline/hooks/PostToolUse.sh and chmod +x
+
+input=$(cat)
+tool=$(echo "$input" | jq -r '.tool_result.name // "unknown"')
+success=$(echo "$input" | jq -r '.postToolUse.success // false')
+duration=$(echo "$input" | jq -r '.postToolUse.executionTimeMs // 0')
+
+status="✅"
+[ "$success" != "true" ] && status="❌"
+
+echo "$status Tool completed: $tool (${duration}ms)" >&2
+
+# Return empty object (PostToolUse events are informational)
+echo '{}'