@skillkit/resources 1.8.0

package/dist/commands/index.js

@@ -0,0 +1,265 @@
+// src/commands/manifest.ts
+var COMMAND_TEMPLATES = [
+  {
+    id: "tdd",
+    name: "TDD Workflow",
+    description: "Test-Driven Development workflow: RED \u2192 GREEN \u2192 REFACTOR",
+    category: "testing",
+    trigger: "/tdd",
+    agent: "tdd-guide",
+    prompt: `Start TDD workflow for the requested feature or fix.
+
+Follow the RED \u2192 GREEN \u2192 REFACTOR cycle:
+
+1. **RED**: Write a failing test that describes the expected behavior
+2. **GREEN**: Write the minimum code needed to pass the test
+3. **REFACTOR**: Improve the code while keeping tests green
+
+Guidelines:
+- One test at a time
+- Tests should be small and focused
+- Commit after each GREEN phase
+- Keep refactoring incremental
+
+Start by asking: What behavior should we test first?`,
+    examples: [
+      "/tdd add validation to user form",
+      "/tdd implement search functionality"
+    ]
+  },
+  {
+    id: "plan",
+    name: "Implementation Planning",
+    description: "Create a detailed implementation plan before coding",
+    category: "planning",
+    trigger: "/plan",
+    agent: "planner",
+    prompt: `Create an implementation plan for the requested feature or change.
+
+Include:
+1. Requirements analysis
+2. Current state assessment
+3. Proposed approach with alternatives
+4. Step-by-step implementation tasks
+5. Risk assessment and mitigations
+6. Verification criteria
+
+Wait for plan approval before any implementation.`,
+    examples: [
+      "/plan add user authentication",
+      "/plan refactor payment module"
+    ]
+  },
+  {
+    id: "e2e",
+    name: "E2E Test Generation",
+    description: "Generate and run end-to-end tests with Playwright",
+    category: "testing",
+    trigger: "/e2e",
+    agent: "e2e-runner",
+    prompt: `Generate E2E tests for the specified user journey.
+
+Process:
+1. Analyze the user flow to test
+2. Generate Playwright test code
+3. Run the test
+4. Capture screenshots/videos if needed
+5. Report results
+
+Focus on testing critical user paths with reliable selectors.`,
+    examples: [
+      "/e2e test user login flow",
+      "/e2e test checkout process"
+    ]
+  },
+  {
+    id: "learn",
+    name: "Extract Learnings",
+    description: "Extract reusable patterns from the current session",
+    category: "learning",
+    trigger: "/learn",
+    prompt: `Analyze the current session and extract reusable patterns.
+
+Look for:
+1. Error fixes that could apply to similar situations
+2. Workarounds for library/framework quirks
+3. Effective debugging approaches
+4. Project-specific conventions discovered
+
+Format each learning as:
+- Problem: What issue was encountered
+- Solution: How it was resolved
+- Context: When this applies
+- Example: Code snippet if relevant
+
+Ask for approval before saving patterns.`,
+    examples: [
+      "/learn from this debugging session",
+      "/learn extract patterns from recent fixes"
+    ]
+  },
+  {
+    id: "build-fix",
+    name: "Build Error Resolution",
+    description: "Fix build errors with minimal changes",
+    category: "development",
+    trigger: "/build-fix",
+    agent: "build-error-resolver",
+    prompt: `Fix the current build/type errors.
+
+Process:
+1. Run the build to capture all errors
+2. Analyze each error's root cause
+3. Apply minimal fixes (no refactoring)
+4. Verify the build passes
+5. Run tests to ensure no regressions
+
+Focus on getting the build green quickly with the smallest possible changes.`,
+    examples: [
+      "/build-fix",
+      "/build-fix typescript errors"
+    ]
+  },
+  {
+    id: "code-review",
+    name: "Code Review",
+    description: "Review code changes for quality and security",
+    category: "review",
+    trigger: "/code-review",
+    agent: "code-reviewer",
+    prompt: `Review the specified code changes.
+
+Check for:
+1. Correctness and edge cases
+2. Security vulnerabilities
+3. Performance issues
+4. Code quality and maintainability
+5. Test coverage
+
+Provide actionable feedback prioritized by severity.`,
+    examples: [
+      "/code-review recent changes",
+      "/code-review src/auth/"
+    ]
+  },
+  {
+    id: "security-review",
+    name: "Security Review",
+    description: "Audit code for security vulnerabilities",
+    category: "review",
+    trigger: "/security-review",
+    agent: "security-reviewer",
+    prompt: `Perform a security audit of the specified code.
+
+Check for:
+1. OWASP Top 10 vulnerabilities
+2. Hardcoded secrets or credentials
+3. Input validation issues
+4. Authentication/authorization flaws
+5. Data exposure risks
+
+Report findings with severity and remediation steps.`,
+    examples: [
+      "/security-review",
+      "/security-review src/api/"
+    ]
+  },
+  {
+    id: "checkpoint",
+    name: "Create Checkpoint",
+    description: "Create a verification checkpoint for current state",
+    category: "workflow",
+    trigger: "/checkpoint",
+    prompt: `Create a checkpoint to verify the current implementation state.
+
+1. Summarize changes made so far
+2. Run all relevant tests
+3. Check build status
+4. Note any pending issues
+5. Save context for potential recovery
+
+This helps ensure work can be resumed or rolled back if needed.`,
+    examples: [
+      "/checkpoint before major refactor",
+      "/checkpoint feature complete"
+    ]
+  },
+  {
+    id: "verify",
+    name: "Verification Loop",
+    description: "Run comprehensive verification of recent changes",
+    category: "workflow",
+    trigger: "/verify",
+    prompt: `Run verification loop for recent changes.
+
+Steps:
+1. Type check (tsc --noEmit)
+2. Lint check (eslint)
+3. Unit tests
+4. Build verification
+5. Integration tests (if applicable)
+
+Report status and any failures that need attention.`,
+    examples: [
+      "/verify",
+      "/verify all"
+    ]
+  },
+  {
+    id: "cleanup",
+    name: "Code Cleanup",
+    description: "Remove dead code and consolidate duplicates",
+    category: "development",
+    trigger: "/cleanup",
+    agent: "refactor-cleaner",
+    prompt: `Analyze and clean up the codebase.
+
+1. Run dead code analysis (knip, ts-prune)
+2. Identify unused exports and dependencies
+3. Find duplicate code patterns
+4. Remove with verification
+5. Update imports as needed
+
+Make incremental changes with tests passing at each step.`,
+    examples: [
+      "/cleanup",
+      "/cleanup src/utils/"
+    ]
+  }
+];
+var COMMAND_MANIFEST = {
+  version: 1,
+  commands: COMMAND_TEMPLATES
+};
+
+// src/commands/index.ts
+function getCommandTemplates() {
+  return COMMAND_TEMPLATES;
+}
+function getCommandTemplate(id) {
+  return COMMAND_TEMPLATES.find((c) => c.id === id) || null;
+}
+function getCommandByTrigger(trigger) {
+  const normalizedTrigger = trigger.startsWith("/") ? trigger : `/${trigger}`;
+  return COMMAND_TEMPLATES.find((c) => c.trigger === normalizedTrigger) || null;
+}
+function getCommandTemplatesByCategory(category) {
+  return COMMAND_TEMPLATES.filter((c) => c.category === category);
+}
+function getCommandTemplateIds() {
+  return COMMAND_TEMPLATES.map((c) => c.id);
+}
+function getCommandTriggers() {
+  return COMMAND_TEMPLATES.map((c) => c.trigger);
+}
+export {
+  COMMAND_MANIFEST,
+  COMMAND_TEMPLATES,
+  getCommandByTrigger,
+  getCommandTemplate,
+  getCommandTemplateIds,
+  getCommandTemplates,
+  getCommandTemplatesByCategory,
+  getCommandTriggers
+};
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/commands/manifest.ts","../../src/commands/index.ts"],"sourcesContent":["import type { CommandTemplate, CommandManifest } from './types.js';\n\nexport const COMMAND_TEMPLATES: CommandTemplate[] = [\n  {\n    id: 'tdd',\n    name: 'TDD Workflow',\n    description: 'Test-Driven Development workflow: RED → GREEN → REFACTOR',\n    category: 'testing',\n    trigger: '/tdd',\n    agent: 'tdd-guide',\n    prompt: `Start TDD workflow for the requested feature or fix.\n\nFollow the RED → GREEN → REFACTOR cycle:\n\n1. **RED**: Write a failing test that describes the expected behavior\n2. **GREEN**: Write the minimum code needed to pass the test\n3. **REFACTOR**: Improve the code while keeping tests green\n\nGuidelines:\n- One test at a time\n- Tests should be small and focused\n- Commit after each GREEN phase\n- Keep refactoring incremental\n\nStart by asking: What behavior should we test first?`,\n    examples: [\n      '/tdd add validation to user form',\n      '/tdd implement search functionality',\n    ],\n  },\n  {\n    id: 'plan',\n    name: 'Implementation Planning',\n    description: 'Create a detailed implementation plan before coding',\n    category: 'planning',\n    trigger: '/plan',\n    agent: 'planner',\n    prompt: `Create an implementation plan for the requested feature or change.\n\nInclude:\n1. Requirements analysis\n2. Current state assessment\n3. Proposed approach with alternatives\n4. Step-by-step implementation tasks\n5. Risk assessment and mitigations\n6. Verification criteria\n\nWait for plan approval before any implementation.`,\n    examples: [\n      '/plan add user authentication',\n      '/plan refactor payment module',\n    ],\n  },\n  {\n    id: 'e2e',\n    name: 'E2E Test Generation',\n    description: 'Generate and run end-to-end tests with Playwright',\n    category: 'testing',\n    trigger: '/e2e',\n    agent: 'e2e-runner',\n    prompt: `Generate E2E tests for the specified user journey.\n\nProcess:\n1. Analyze the user flow to test\n2. Generate Playwright test code\n3. Run the test\n4. Capture screenshots/videos if needed\n5. Report results\n\nFocus on testing critical user paths with reliable selectors.`,\n    examples: [\n      '/e2e test user login flow',\n      '/e2e test checkout process',\n    ],\n  },\n  {\n    id: 'learn',\n    name: 'Extract Learnings',\n    description: 'Extract reusable patterns from the current session',\n    category: 'learning',\n    trigger: '/learn',\n    prompt: `Analyze the current session and extract reusable patterns.\n\nLook for:\n1. Error fixes that could apply to similar situations\n2. Workarounds for library/framework quirks\n3. Effective debugging approaches\n4. Project-specific conventions discovered\n\nFormat each learning as:\n- Problem: What issue was encountered\n- Solution: How it was resolved\n- Context: When this applies\n- Example: Code snippet if relevant\n\nAsk for approval before saving patterns.`,\n    examples: [\n      '/learn from this debugging session',\n      '/learn extract patterns from recent fixes',\n    ],\n  },\n  {\n    id: 'build-fix',\n    name: 'Build Error Resolution',\n    description: 'Fix build errors with minimal changes',\n    category: 'development',\n    trigger: '/build-fix',\n    agent: 'build-error-resolver',\n    prompt: `Fix the current build/type errors.\n\nProcess:\n1. Run the build to capture all errors\n2. Analyze each error's root cause\n3. Apply minimal fixes (no refactoring)\n4. Verify the build passes\n5. Run tests to ensure no regressions\n\nFocus on getting the build green quickly with the smallest possible changes.`,\n    examples: [\n      '/build-fix',\n      '/build-fix typescript errors',\n    ],\n  },\n  {\n    id: 'code-review',\n    name: 'Code Review',\n    description: 'Review code changes for quality and security',\n    category: 'review',\n    trigger: '/code-review',\n    agent: 'code-reviewer',\n    prompt: `Review the specified code changes.\n\nCheck for:\n1. Correctness and edge cases\n2. Security vulnerabilities\n3. Performance issues\n4. Code quality and maintainability\n5. Test coverage\n\nProvide actionable feedback prioritized by severity.`,\n    examples: [\n      '/code-review recent changes',\n      '/code-review src/auth/',\n    ],\n  },\n  {\n    id: 'security-review',\n    name: 'Security Review',\n    description: 'Audit code for security vulnerabilities',\n    category: 'review',\n    trigger: '/security-review',\n    agent: 'security-reviewer',\n    prompt: `Perform a security audit of the specified code.\n\nCheck for:\n1. OWASP Top 10 vulnerabilities\n2. Hardcoded secrets or credentials\n3. Input validation issues\n4. Authentication/authorization flaws\n5. Data exposure risks\n\nReport findings with severity and remediation steps.`,\n    examples: [\n      '/security-review',\n      '/security-review src/api/',\n    ],\n  },\n  {\n    id: 'checkpoint',\n    name: 'Create Checkpoint',\n    description: 'Create a verification checkpoint for current state',\n    category: 'workflow',\n    trigger: '/checkpoint',\n    prompt: `Create a checkpoint to verify the current implementation state.\n\n1. Summarize changes made so far\n2. Run all relevant tests\n3. Check build status\n4. Note any pending issues\n5. Save context for potential recovery\n\nThis helps ensure work can be resumed or rolled back if needed.`,\n    examples: [\n      '/checkpoint before major refactor',\n      '/checkpoint feature complete',\n    ],\n  },\n  {\n    id: 'verify',\n    name: 'Verification Loop',\n    description: 'Run comprehensive verification of recent changes',\n    category: 'workflow',\n    trigger: '/verify',\n    prompt: `Run verification loop for recent changes.\n\nSteps:\n1. Type check (tsc --noEmit)\n2. Lint check (eslint)\n3. Unit tests\n4. Build verification\n5. Integration tests (if applicable)\n\nReport status and any failures that need attention.`,\n    examples: [\n      '/verify',\n      '/verify all',\n    ],\n  },\n  {\n    id: 'cleanup',\n    name: 'Code Cleanup',\n    description: 'Remove dead code and consolidate duplicates',\n    category: 'development',\n    trigger: '/cleanup',\n    agent: 'refactor-cleaner',\n    prompt: `Analyze and clean up the codebase.\n\n1. Run dead code analysis (knip, ts-prune)\n2. Identify unused exports and dependencies\n3. Find duplicate code patterns\n4. Remove with verification\n5. Update imports as needed\n\nMake incremental changes with tests passing at each step.`,\n    examples: [\n      '/cleanup',\n      '/cleanup src/utils/',\n    ],\n  },\n];\n\nexport const COMMAND_MANIFEST: CommandManifest = {\n  version: 1,\n  commands: COMMAND_TEMPLATES,\n};\n","import { COMMAND_TEMPLATES, COMMAND_MANIFEST } from './manifest.js';\nimport type { CommandTemplate, CommandCategory, CommandManifest } from './types.js';\n\nexport type { CommandTemplate, CommandCategory, CommandManifest };\nexport { COMMAND_TEMPLATES, COMMAND_MANIFEST };\n\nexport function getCommandTemplates(): CommandTemplate[] {\n  return COMMAND_TEMPLATES;\n}\n\nexport function getCommandTemplate(id: string): CommandTemplate | null {\n  return COMMAND_TEMPLATES.find(c => c.id === id) || null;\n}\n\nexport function getCommandByTrigger(trigger: string): CommandTemplate | null {\n  const normalizedTrigger = trigger.startsWith('/') ? trigger : `/${trigger}`;\n  return COMMAND_TEMPLATES.find(c => c.trigger === normalizedTrigger) || null;\n}\n\nexport function getCommandTemplatesByCategory(category: CommandCategory): CommandTemplate[] {\n  return COMMAND_TEMPLATES.filter(c => c.category === category);\n}\n\nexport function getCommandTemplateIds(): string[] {\n  return COMMAND_TEMPLATES.map(c => c.id);\n}\n\nexport function getCommandTriggers(): string[] {\n  return COMMAND_TEMPLATES.map(c => c.trigger);\n}\n"],"mappings":"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","names":[]}

package/dist/guidelines/index.d.ts

@@ -0,0 +1,28 @@
+type GuidelineCategory = 'security' | 'code-style' | 'testing' | 'git' | 'performance' | 'custom';
+interface Guideline {
+    id: string;
+    name: string;
+    description: string;
+    category: GuidelineCategory;
+    content: string;
+    priority: number;
+    enabled: boolean;
+    scope: 'global' | 'project';
+}
+interface GuidelineManifest {
+    version: number;
+    guidelines: Guideline[];
+}
+
+declare const BUILTIN_GUIDELINES: Guideline[];
+declare const GUIDELINE_MANIFEST: GuidelineManifest;
+
+declare function getBuiltinGuidelines(): Guideline[];
+declare function getBuiltinGuideline(id: string): Guideline | null;
+declare function getGuidelinesByCategory(category: GuidelineCategory): Guideline[];
+declare function getGuidelineIds(): string[];
+declare function getGuidelineContent(id: string): string | null;
+declare function getEnabledGuidelines(): Guideline[];
+declare function getGuidelinesSortedByPriority(): Guideline[];
+
+export { BUILTIN_GUIDELINES, GUIDELINE_MANIFEST, type Guideline, type GuidelineCategory, type GuidelineManifest, getBuiltinGuideline, getBuiltinGuidelines, getEnabledGuidelines, getGuidelineContent, getGuidelineIds, getGuidelinesByCategory, getGuidelinesSortedByPriority };

package/dist/guidelines/index.js

@@ -0,0 +1,215 @@
+// src/guidelines/manifest.ts
+var BUILTIN_GUIDELINES = [
+  {
+    id: "security",
+    name: "Security Guidelines",
+    description: "Security best practices and vulnerability prevention",
+    category: "security",
+    priority: 10,
+    enabled: true,
+    scope: "global",
+    content: `## Security Guidelines
+
+### Input Validation
+- Validate all user input on the server side
+- Use allowlists over denylists when possible
+- Sanitize data before use in queries, commands, or output
+
+### Authentication & Authorization
+- Never store passwords in plain text
+- Use secure session management
+- Implement proper authorization checks on every endpoint
+- Use HTTPS for all communications
+
+### Data Protection
+- Encrypt sensitive data at rest and in transit
+- Never log sensitive information
+- Use environment variables for secrets
+- Implement proper access controls
+
+### Common Vulnerabilities to Prevent
+- SQL Injection: Use parameterized queries
+- XSS: Encode output, use CSP headers
+- CSRF: Use anti-CSRF tokens
+- Command Injection: Avoid shell commands with user input`
+  },
+  {
+    id: "code-style",
+    name: "Code Style Guidelines",
+    description: "Code formatting and style conventions",
+    category: "code-style",
+    priority: 7,
+    enabled: true,
+    scope: "global",
+    content: `## Code Style Guidelines
+
+### Naming Conventions
+- Use descriptive, meaningful names
+- camelCase for variables and functions
+- PascalCase for classes and types
+- SCREAMING_SNAKE_CASE for constants
+
+### Code Organization
+- One concept per file
+- Group related code together
+- Keep files under 300 lines when practical
+- Use barrel exports (index.ts) for public APIs
+
+### Functions
+- Single responsibility principle
+- Keep functions under 30 lines when practical
+- Use early returns to reduce nesting
+- Avoid side effects in pure functions
+
+### Comments
+- Don't comment obvious code
+- Explain "why" not "what"
+- Keep comments up to date
+- Use JSDoc for public APIs`
+  },
+  {
+    id: "testing",
+    name: "Testing Guidelines",
+    description: "Testing best practices and coverage requirements",
+    category: "testing",
+    priority: 8,
+    enabled: true,
+    scope: "global",
+    content: `## Testing Guidelines
+
+### Test Coverage
+- Aim for 80%+ code coverage
+- 100% coverage for critical paths
+- Don't sacrifice quality for coverage metrics
+
+### Test Structure
+- Arrange, Act, Assert (AAA) pattern
+- One concept per test
+- Descriptive test names that explain behavior
+- Independent tests (no shared state)
+
+### Test Types
+- Unit tests for business logic
+- Integration tests for component interactions
+- E2E tests for critical user flows
+
+### Test Quality
+- Tests should be deterministic
+- Fast execution (< 100ms for unit tests)
+- Easy to understand and maintain
+- Test behavior, not implementation`
+  },
+  {
+    id: "git",
+    name: "Git Workflow Guidelines",
+    description: "Version control best practices",
+    category: "git",
+    priority: 6,
+    enabled: true,
+    scope: "global",
+    content: `## Git Workflow Guidelines
+
+### Commits
+- Write clear, concise commit messages
+- Use conventional commits format
+- One logical change per commit
+- Don't commit generated files or secrets
+
+### Branches
+- Use feature branches
+- Keep branches short-lived
+- Delete branches after merge
+- Protect main/master branch
+
+### Pull Requests
+- Keep PRs focused and small
+- Write meaningful descriptions
+- Request reviews from appropriate people
+- Address all review comments
+
+### Commit Message Format
+\`\`\`
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+\`\`\`
+
+Types: feat, fix, docs, style, refactor, test, chore`
+  },
+  {
+    id: "performance",
+    name: "Performance Guidelines",
+    description: "Performance optimization best practices",
+    category: "performance",
+    priority: 5,
+    enabled: true,
+    scope: "global",
+    content: `## Performance Guidelines
+
+### General Principles
+- Measure before optimizing
+- Optimize critical paths first
+- Consider time/space tradeoffs
+- Profile in production-like environments
+
+### Database
+- Use indexes appropriately
+- Avoid N+1 queries
+- Paginate large result sets
+- Cache frequently accessed data
+
+### Frontend
+- Minimize bundle size
+- Lazy load when appropriate
+- Optimize images and assets
+- Use efficient rendering patterns
+
+### Backend
+- Use connection pooling
+- Implement appropriate caching
+- Async operations where beneficial
+- Monitor and alert on performance`
+  }
+];
+var GUIDELINE_MANIFEST = {
+  version: 1,
+  guidelines: BUILTIN_GUIDELINES
+};
+
+// src/guidelines/index.ts
+function getBuiltinGuidelines() {
+  return BUILTIN_GUIDELINES;
+}
+function getBuiltinGuideline(id) {
+  return BUILTIN_GUIDELINES.find((g) => g.id === id) || null;
+}
+function getGuidelinesByCategory(category) {
+  return BUILTIN_GUIDELINES.filter((g) => g.category === category);
+}
+function getGuidelineIds() {
+  return BUILTIN_GUIDELINES.map((g) => g.id);
+}
+function getGuidelineContent(id) {
+  const guideline = getBuiltinGuideline(id);
+  return guideline?.content || null;
+}
+function getEnabledGuidelines() {
+  return BUILTIN_GUIDELINES.filter((g) => g.enabled);
+}
+function getGuidelinesSortedByPriority() {
+  return [...BUILTIN_GUIDELINES].sort((a, b) => b.priority - a.priority);
+}
+export {
+  BUILTIN_GUIDELINES,
+  GUIDELINE_MANIFEST,
+  getBuiltinGuideline,
+  getBuiltinGuidelines,
+  getEnabledGuidelines,
+  getGuidelineContent,
+  getGuidelineIds,
+  getGuidelinesByCategory,
+  getGuidelinesSortedByPriority
+};
+//# sourceMappingURL=index.js.map

package/dist/guidelines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/guidelines/manifest.ts","../../src/guidelines/index.ts"],"sourcesContent":["import type { Guideline, GuidelineManifest } from './types.js';\n\nexport const BUILTIN_GUIDELINES: Guideline[] = [\n  {\n    id: 'security',\n    name: 'Security Guidelines',\n    description: 'Security best practices and vulnerability prevention',\n    category: 'security',\n    priority: 10,\n    enabled: true,\n    scope: 'global',\n    content: `## Security Guidelines\n\n### Input Validation\n- Validate all user input on the server side\n- Use allowlists over denylists when possible\n- Sanitize data before use in queries, commands, or output\n\n### Authentication & Authorization\n- Never store passwords in plain text\n- Use secure session management\n- Implement proper authorization checks on every endpoint\n- Use HTTPS for all communications\n\n### Data Protection\n- Encrypt sensitive data at rest and in transit\n- Never log sensitive information\n- Use environment variables for secrets\n- Implement proper access controls\n\n### Common Vulnerabilities to Prevent\n- SQL Injection: Use parameterized queries\n- XSS: Encode output, use CSP headers\n- CSRF: Use anti-CSRF tokens\n- Command Injection: Avoid shell commands with user input`,\n  },\n  {\n    id: 'code-style',\n    name: 'Code Style Guidelines',\n    description: 'Code formatting and style conventions',\n    category: 'code-style',\n    priority: 7,\n    enabled: true,\n    scope: 'global',\n    content: `## Code Style Guidelines\n\n### Naming Conventions\n- Use descriptive, meaningful names\n- camelCase for variables and functions\n- PascalCase for classes and types\n- SCREAMING_SNAKE_CASE for constants\n\n### Code Organization\n- One concept per file\n- Group related code together\n- Keep files under 300 lines when practical\n- Use barrel exports (index.ts) for public APIs\n\n### Functions\n- Single responsibility principle\n- Keep functions under 30 lines when practical\n- Use early returns to reduce nesting\n- Avoid side effects in pure functions\n\n### Comments\n- Don't comment obvious code\n- Explain \"why\" not \"what\"\n- Keep comments up to date\n- Use JSDoc for public APIs`,\n  },\n  {\n    id: 'testing',\n    name: 'Testing Guidelines',\n    description: 'Testing best practices and coverage requirements',\n    category: 'testing',\n    priority: 8,\n    enabled: true,\n    scope: 'global',\n    content: `## Testing Guidelines\n\n### Test Coverage\n- Aim for 80%+ code coverage\n- 100% coverage for critical paths\n- Don't sacrifice quality for coverage metrics\n\n### Test Structure\n- Arrange, Act, Assert (AAA) pattern\n- One concept per test\n- Descriptive test names that explain behavior\n- Independent tests (no shared state)\n\n### Test Types\n- Unit tests for business logic\n- Integration tests for component interactions\n- E2E tests for critical user flows\n\n### Test Quality\n- Tests should be deterministic\n- Fast execution (< 100ms for unit tests)\n- Easy to understand and maintain\n- Test behavior, not implementation`,\n  },\n  {\n    id: 'git',\n    name: 'Git Workflow Guidelines',\n    description: 'Version control best practices',\n    category: 'git',\n    priority: 6,\n    enabled: true,\n    scope: 'global',\n    content: `## Git Workflow Guidelines\n\n### Commits\n- Write clear, concise commit messages\n- Use conventional commits format\n- One logical change per commit\n- Don't commit generated files or secrets\n\n### Branches\n- Use feature branches\n- Keep branches short-lived\n- Delete branches after merge\n- Protect main/master branch\n\n### Pull Requests\n- Keep PRs focused and small\n- Write meaningful descriptions\n- Request reviews from appropriate people\n- Address all review comments\n\n### Commit Message Format\n\\`\\`\\`\n<type>(<scope>): <description>\n\n[optional body]\n\n[optional footer]\n\\`\\`\\`\n\nTypes: feat, fix, docs, style, refactor, test, chore`,\n  },\n  {\n    id: 'performance',\n    name: 'Performance Guidelines',\n    description: 'Performance optimization best practices',\n    category: 'performance',\n    priority: 5,\n    enabled: true,\n    scope: 'global',\n    content: `## Performance Guidelines\n\n### General Principles\n- Measure before optimizing\n- Optimize critical paths first\n- Consider time/space tradeoffs\n- Profile in production-like environments\n\n### Database\n- Use indexes appropriately\n- Avoid N+1 queries\n- Paginate large result sets\n- Cache frequently accessed data\n\n### Frontend\n- Minimize bundle size\n- Lazy load when appropriate\n- Optimize images and assets\n- Use efficient rendering patterns\n\n### Backend\n- Use connection pooling\n- Implement appropriate caching\n- Async operations where beneficial\n- Monitor and alert on performance`,\n  },\n];\n\nexport const GUIDELINE_MANIFEST: GuidelineManifest = {\n  version: 1,\n  guidelines: BUILTIN_GUIDELINES,\n};\n","import { BUILTIN_GUIDELINES, GUIDELINE_MANIFEST } from './manifest.js';\nimport type { Guideline, GuidelineCategory, GuidelineManifest } from './types.js';\n\nexport type { Guideline, GuidelineCategory, GuidelineManifest };\nexport { BUILTIN_GUIDELINES, GUIDELINE_MANIFEST };\n\nexport function getBuiltinGuidelines(): Guideline[] {\n  return BUILTIN_GUIDELINES;\n}\n\nexport function getBuiltinGuideline(id: string): Guideline | null {\n  return BUILTIN_GUIDELINES.find(g => g.id === id) || null;\n}\n\nexport function getGuidelinesByCategory(category: GuidelineCategory): Guideline[] {\n  return BUILTIN_GUIDELINES.filter(g => g.category === category);\n}\n\nexport function getGuidelineIds(): string[] {\n  return BUILTIN_GUIDELINES.map(g => g.id);\n}\n\nexport function getGuidelineContent(id: string): string | null {\n  const guideline = getBuiltinGuideline(id);\n  return guideline?.content || null;\n}\n\nexport function getEnabledGuidelines(): Guideline[] {\n  return BUILTIN_GUIDELINES.filter(g => g.enabled);\n}\n\nexport function getGuidelinesSortedByPriority(): Guideline[] {\n  return [...BUILTIN_GUIDELINES].sort((a, b) => b.priority - a.priority);\n}\n"],"mappings":";AAEO,IAAM,qBAAkC;AAAA,EAC7C;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBX;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBX;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBX;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA8BX;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,UAAU;AAAA,IACV,SAAS;AAAA,IACT,OAAO;AAAA,IACP,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBX;AACF;AAEO,IAAM,qBAAwC;AAAA,EACnD,SAAS;AAAA,EACT,YAAY;AACd;;;AC9KO,SAAS,uBAAoC;AAClD,SAAO;AACT;AAEO,SAAS,oBAAoB,IAA8B;AAChE,SAAO,mBAAmB,KAAK,OAAK,EAAE,OAAO,EAAE,KAAK;AACtD;AAEO,SAAS,wBAAwB,UAA0C;AAChF,SAAO,mBAAmB,OAAO,OAAK,EAAE,aAAa,QAAQ;AAC/D;AAEO,SAAS,kBAA4B;AAC1C,SAAO,mBAAmB,IAAI,OAAK,EAAE,EAAE;AACzC;AAEO,SAAS,oBAAoB,IAA2B;AAC7D,QAAM,YAAY,oBAAoB,EAAE;AACxC,SAAO,WAAW,WAAW;AAC/B;AAEO,SAAS,uBAAoC;AAClD,SAAO,mBAAmB,OAAO,OAAK,EAAE,OAAO;AACjD;AAEO,SAAS,gCAA6C;AAC3D,SAAO,CAAC,GAAG,kBAAkB,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACvE;","names":[]}

package/dist/hooks/index.d.ts

@@ -0,0 +1,30 @@
+type HookTemplateCategory = 'security' | 'quality' | 'workflow' | 'productivity';
+type HookEvent = 'session:start' | 'session:resume' | 'session:end' | 'file:open' | 'file:save' | 'file:create' | 'file:delete' | 'task:start' | 'task:complete' | 'commit:pre' | 'commit:post' | 'error:occur' | 'test:fail' | 'test:pass' | 'build:start' | 'build:fail' | 'build:success';
+interface HookTemplate {
+    id: string;
+    name: string;
+    description: string;
+    category: HookTemplateCategory;
+    event: HookEvent;
+    matcher?: string;
+    command: string;
+    timeout?: number;
+    blocking?: boolean;
+    variables?: Record<string, string>;
+}
+interface HookTemplateManifest {
+    version: number;
+    templates: HookTemplate[];
+}
+
+declare const HOOK_TEMPLATES: HookTemplate[];
+declare const HOOK_TEMPLATE_MANIFEST: HookTemplateManifest;
+
+declare function getHookTemplates(): HookTemplate[];
+declare function getHookTemplate(id: string): HookTemplate | null;
+declare function getHookTemplatesByCategory(category: HookTemplateCategory): HookTemplate[];
+declare function getHookTemplatesByEvent(event: HookEvent): HookTemplate[];
+declare function getHookTemplateIds(): string[];
+declare function formatHookCommand(template: HookTemplate, variables?: Record<string, string>): string;
+
+export { HOOK_TEMPLATES, HOOK_TEMPLATE_MANIFEST, type HookEvent, type HookTemplate, type HookTemplateCategory, type HookTemplateManifest, formatHookCommand, getHookTemplate, getHookTemplateIds, getHookTemplates, getHookTemplatesByCategory, getHookTemplatesByEvent };