@ai-coders/context 0.6.1 → 0.7.1

package/dist/generators/shared/structures/skills/definitions.js

@@ -0,0 +1,427 @@
+"use strict";
+/**
+ * Skill structure definitions with static default content
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.securityAuditSkillStructure = exports.apiDesignSkillStructure = exports.featureBreakdownSkillStructure = exports.bugInvestigationSkillStructure = exports.refactoringSkillStructure = exports.documentationSkillStructure = exports.testGenerationSkillStructure = exports.codeReviewSkillStructure = exports.prReviewSkillStructure = exports.commitMessageSkillStructure = void 0;
+const factory_1 = require("./factory");
+// ============================================================================
+// Default Content Definitions
+// ============================================================================
+const commitMessageContent = {
+    whenToUse: `Use this skill when:
+- Creating git commits after code changes
+- Writing commit messages for staged changes
+- Following conventional commit format for the project`,
+    instructions: `1. Review the staged changes using \`git diff --staged\`
+2. Identify the type of change (feat, fix, docs, style, refactor, test, chore)
+3. Determine the scope (component, module, or area affected)
+4. Write a concise subject line (50 chars max, imperative mood)
+5. Add body if needed to explain "why" not "what"
+6. Reference issue numbers if applicable`,
+    examples: `**Feature commit:**
+\`\`\`
+feat(auth): add password reset functionality
+
+Implement forgot password flow with email verification.
+Users can now reset their password via email link.
+
+Closes #123
+\`\`\`
+
+**Bug fix commit:**
+\`\`\`
+fix(api): handle null response in user lookup
+
+Previously threw TypeError when user not found.
+Now returns 404 with appropriate error message.
+
+Fixes #456
+\`\`\``,
+    guidelines: `- Use imperative mood: "add" not "added" or "adds"
+- Keep subject line under 50 characters
+- Separate subject from body with blank line
+- Use body to explain why, not what (code shows what)
+- Reference issues with "Closes #X" or "Fixes #X"
+- One logical change per commit
+- Don't end subject line with period`,
+};
+const prReviewContent = {
+    whenToUse: `Use this skill when:
+- Reviewing a pull request before merge
+- Providing feedback on proposed changes
+- Validating PR meets project standards`,
+    instructions: `1. Read the PR description to understand the goal
+2. Review the linked issue(s) for context
+3. Check that tests are included and passing
+4. Review code changes file by file
+5. Verify documentation is updated if needed
+6. Leave constructive feedback with specific suggestions
+7. Approve, request changes, or comment based on findings`,
+    examples: `**Approval comment:**
+\`\`\`
+Looks good! Clean implementation with comprehensive tests.
+
+Minor suggestion: Consider extracting the validation logic
+in \`UserService.ts:45\` into a separate function for reusability.
+
+Approved ✅
+\`\`\`
+
+**Request changes:**
+\`\`\`
+Good progress, but a few items need attention:
+
+1. Missing test for error handling in \`fetchUser()\`
+2. The new endpoint needs documentation in the API docs
+3. Consider adding input validation for the email field
+
+Please address these and I'll re-review.
+\`\`\``,
+    guidelines: `- Start with understanding the PR's goal
+- Be constructive and specific in feedback
+- Distinguish between required changes and suggestions
+- Test the changes locally if complex
+- Check for security implications
+- Verify backward compatibility
+- Approve only when confident in the changes`,
+};
+const codeReviewContent = {
+    whenToUse: `Use this skill when:
+- Reviewing code changes for quality
+- Checking adherence to coding standards
+- Identifying potential bugs or issues`,
+    instructions: `1. Understand the context and purpose of the code
+2. Check for correctness and logic errors
+3. Evaluate code structure and organization
+4. Look for potential performance issues
+5. Check for security vulnerabilities
+6. Verify error handling is appropriate
+7. Assess readability and maintainability`,
+    examples: `**Code quality feedback:**
+\`\`\`
+// Before: Nested callbacks
+fetchUser(id, (user) => {
+  fetchPosts(user.id, (posts) => {
+    render(posts);
+  });
+});
+
+// Suggestion: Use async/await
+const user = await fetchUser(id);
+const posts = await fetchPosts(user.id);
+render(posts);
+\`\`\`
+
+**Security feedback:**
+\`\`\`
+// Issue: SQL injection vulnerability
+const query = \`SELECT * FROM users WHERE id = \${userId}\`;
+
+// Fix: Use parameterized query
+const query = 'SELECT * FROM users WHERE id = ?';
+db.query(query, [userId]);
+\`\`\``,
+    guidelines: `- Focus on the most impactful issues first
+- Explain why something is a problem
+- Provide concrete suggestions for improvement
+- Consider the developer's experience level
+- Balance thoroughness with pragmatism
+- Praise good patterns when you see them`,
+};
+const testGenerationContent = {
+    whenToUse: `Use this skill when:
+- Writing tests for new functionality
+- Adding tests for bug fixes (regression tests)
+- Improving test coverage for existing code`,
+    instructions: `1. Identify the function/component to test
+2. List the behaviors that need testing
+3. Write tests for happy path scenarios
+4. Add tests for edge cases and boundaries
+5. Include error handling tests
+6. Mock external dependencies appropriately
+7. Verify tests are deterministic and isolated`,
+    examples: `**Unit test example:**
+\`\`\`typescript
+describe('calculateTotal', () => {
+  it('should sum item prices correctly', () => {
+    const items = [{ price: 10 }, { price: 20 }];
+    expect(calculateTotal(items)).toBe(30);
+  });
+
+  it('should return 0 for empty array', () => {
+    expect(calculateTotal([])).toBe(0);
+  });
+
+  it('should handle negative prices', () => {
+    const items = [{ price: 10 }, { price: -5 }];
+    expect(calculateTotal(items)).toBe(5);
+  });
+});
+\`\`\``,
+    guidelines: `- Test behavior, not implementation
+- Use descriptive test names that explain what and why
+- Follow Arrange-Act-Assert pattern
+- Keep tests independent and isolated
+- Don't test external libraries
+- Mock at the boundary, not everywhere
+- Aim for fast, reliable tests`,
+};
+const documentationContent = {
+    whenToUse: `Use this skill when:
+- Documenting new features or APIs
+- Updating docs for code changes
+- Creating README or getting started guides`,
+    instructions: `1. Identify the target audience
+2. Determine what needs to be documented
+3. Write clear, concise explanations
+4. Include working code examples
+5. Add any necessary diagrams or visuals
+6. Review for clarity and completeness
+7. Verify examples work with current code`,
+    examples: `**Function documentation:**
+\`\`\`typescript
+/**
+ * Calculates the total price of items in a cart.
+ *
+ * @param items - Array of cart items with price property
+ * @returns The sum of all item prices
+ * @throws {Error} If items is not an array
+ *
+ * @example
+ * const total = calculateTotal([{ price: 10 }, { price: 20 }]);
+ * // Returns: 30
+ */
+function calculateTotal(items: CartItem[]): number
+\`\`\``,
+    guidelines: `- Write for your audience's knowledge level
+- Lead with the most important information
+- Include working, copy-pasteable examples
+- Keep documentation close to the code
+- Update docs in the same PR as code changes
+- Use consistent formatting and terminology`,
+};
+const refactoringContent = {
+    whenToUse: `Use this skill when:
+- Improving code structure without changing behavior
+- Reducing code duplication
+- Simplifying complex logic`,
+    instructions: `1. Ensure adequate test coverage exists
+2. Identify the specific improvement to make
+3. Make one type of change at a time
+4. Run tests after each change
+5. Commit frequently with clear messages
+6. Verify no behavior changes occurred`,
+    examples: `**Extract function:**
+\`\`\`typescript
+// Before: Inline validation logic
+if (email && email.includes('@') && email.length > 5) {
+  // process email
+}
+
+// After: Extracted to function
+function isValidEmail(email: string): boolean {
+  return email && email.includes('@') && email.length > 5;
+}
+
+if (isValidEmail(email)) {
+  // process email
+}
+\`\`\``,
+    guidelines: `- Never refactor without tests
+- Small steps, frequent commits
+- One refactoring type per commit
+- If tests break, you changed behavior
+- Use IDE refactoring tools when available
+- Keep the PR focused and reviewable`,
+};
+const bugInvestigationContent = {
+    whenToUse: `Use this skill when:
+- Investigating reported bugs
+- Diagnosing unexpected behavior
+- Finding the root cause of issues`,
+    instructions: `1. Reproduce the bug consistently
+2. Gather information (logs, stack traces, steps)
+3. Identify when the bug was introduced (git bisect)
+4. Form a hypothesis about the cause
+5. Verify hypothesis with debugging
+6. Document the root cause
+7. Plan the fix approach`,
+    examples: `**Bug investigation notes:**
+\`\`\`
+## Bug: User profile fails to load
+
+### Reproduction:
+1. Log in as any user
+2. Navigate to /profile
+3. Error: "Cannot read property 'name' of undefined"
+
+### Investigation:
+- Stack trace points to ProfilePage.tsx:25
+- API returns 200 but empty body when session expired
+- Bug introduced in commit abc123 (session refactor)
+
+### Root cause:
+Session middleware not checking token expiration correctly.
+Returns empty response instead of 401.
+
+### Fix approach:
+Update session middleware to return 401 when token expired.
+\`\`\``,
+    guidelines: `- Always reproduce before investigating
+- Check recent changes that might relate
+- Use debugger and logging strategically
+- Document your findings
+- Consider if bug exists elsewhere
+- Write a regression test with the fix`,
+};
+const featureBreakdownContent = {
+    whenToUse: `Use this skill when:
+- Planning new feature implementation
+- Breaking large tasks into smaller pieces
+- Creating implementation roadmap`,
+    instructions: `1. Understand the full feature requirements
+2. Identify the main components needed
+3. Break into independent, testable tasks
+4. Identify dependencies between tasks
+5. Order tasks by dependency and priority
+6. Add acceptance criteria to each task
+7. Flag any unknowns or risks`,
+    examples: `**Feature breakdown example:**
+\`\`\`
+## Feature: User Authentication
+
+### Task 1: Database schema
+- Add users table with email, password_hash, created_at
+- Add sessions table with user_id, token, expires_at
+- Acceptance: Migrations run successfully
+
+### Task 2: Registration endpoint
+- POST /api/auth/register
+- Validate email format and password strength
+- Hash password before storing
+- Acceptance: Can create user, returns 201
+
+### Task 3: Login endpoint
+- POST /api/auth/login
+- Verify credentials, create session
+- Return JWT token
+- Acceptance: Can login, receive valid token
+
+### Dependencies:
+Task 2 requires Task 1
+Task 3 requires Task 1
+\`\`\``,
+    guidelines: `- Each task should be independently testable
+- Tasks should be small enough to complete in a day
+- Clearly state acceptance criteria
+- Identify and document dependencies
+- Flag technical risks or unknowns early
+- Consider parallel work opportunities`,
+};
+const apiDesignContent = {
+    whenToUse: `Use this skill when:
+- Designing new API endpoints
+- Restructuring existing APIs
+- Planning API versioning strategy`,
+    instructions: `1. Define the resources and their relationships
+2. Choose appropriate HTTP methods
+3. Design URL structure following REST conventions
+4. Define request/response schemas
+5. Plan error handling and status codes
+6. Consider pagination, filtering, sorting
+7. Document the API specification`,
+    examples: `**RESTful API design:**
+\`\`\`
+# Users API
+
+GET    /api/v1/users          # List users (paginated)
+POST   /api/v1/users          # Create user
+GET    /api/v1/users/:id      # Get user by ID
+PUT    /api/v1/users/:id      # Update user
+DELETE /api/v1/users/:id      # Delete user
+
+# Nested resources
+GET    /api/v1/users/:id/posts    # Get user's posts
+
+# Response format
+{
+  "data": { ... },
+  "meta": { "page": 1, "total": 100 }
+}
+
+# Error format
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Email is required",
+    "details": [...]
+  }
+}
+\`\`\``,
+    guidelines: `- Use nouns for resources, not verbs
+- Use proper HTTP methods and status codes
+- Version your API from the start
+- Be consistent in naming and structure
+- Provide clear error messages
+- Document all endpoints
+- Consider rate limiting and caching`,
+};
+const securityAuditContent = {
+    whenToUse: `Use this skill when:
+- Reviewing code for security vulnerabilities
+- Assessing authentication/authorization
+- Checking for OWASP top 10 issues`,
+    instructions: `1. Review authentication implementation
+2. Check authorization on all endpoints
+3. Look for injection vulnerabilities
+4. Verify input validation and sanitization
+5. Check for sensitive data exposure
+6. Review dependency security
+7. Document findings with severity`,
+    examples: `**Security audit findings:**
+\`\`\`
+## Security Audit Report
+
+### Critical
+1. SQL Injection in UserController.ts:45
+   - Query constructed with string concatenation
+   - Fix: Use parameterized queries
+
+### High
+2. Missing authentication on /api/admin/*
+   - Admin routes accessible without auth
+   - Fix: Add auth middleware
+
+### Medium
+3. Sensitive data in logs
+   - Passwords logged in debug mode
+   - Fix: Sanitize logs, remove sensitive fields
+
+### Recommendations
+- Enable security headers (HSTS, CSP)
+- Implement rate limiting
+- Add input validation middleware
+\`\`\``,
+    guidelines: `- Check OWASP top 10 vulnerabilities
+- Never trust user input
+- Review authentication carefully
+- Verify authorization on all routes
+- Check for sensitive data exposure
+- Scan dependencies for known vulnerabilities
+- Document findings with clear severity levels`,
+};
+// ============================================================================
+// Skill Structure Exports
+// ============================================================================
+exports.commitMessageSkillStructure = (0, factory_1.createSkillStructure)('commit-message', 'Commit Message', 'Generates conventional commit messages following project conventions', 'Focus on conventional commits format, clear descriptions, and linking to issues.', commitMessageContent);
+exports.prReviewSkillStructure = (0, factory_1.createSkillStructure)('pr-review', 'PR Review', 'Reviews pull requests for quality, completeness, and adherence to standards', 'Focus on code quality, test coverage, documentation, and potential issues.', prReviewContent);
+exports.codeReviewSkillStructure = (0, factory_1.createSkillStructure)('code-review', 'Code Review', 'Reviews code changes for quality and best practices', 'Focus on maintainability, performance, security, and style consistency.', codeReviewContent);
+exports.testGenerationSkillStructure = (0, factory_1.createSkillStructure)('test-generation', 'Test Generation', 'Generates comprehensive tests for code', 'Focus on unit tests, edge cases, mocking strategies, and test organization.', testGenerationContent);
+exports.documentationSkillStructure = (0, factory_1.createSkillStructure)('documentation', 'Documentation', 'Creates and updates documentation', 'Focus on clarity, examples, API documentation, and keeping docs current.', documentationContent);
+exports.refactoringSkillStructure = (0, factory_1.createSkillStructure)('refactoring', 'Refactoring', 'Refactors code to improve structure and maintainability', 'Focus on small incremental changes, test coverage, and preserving behavior.', refactoringContent);
+exports.bugInvestigationSkillStructure = (0, factory_1.createSkillStructure)('bug-investigation', 'Bug Investigation', 'Investigates and diagnoses bugs', 'Focus on reproduction, root cause analysis, and fix verification.', bugInvestigationContent);
+exports.featureBreakdownSkillStructure = (0, factory_1.createSkillStructure)('feature-breakdown', 'Feature Breakdown', 'Breaks down features into implementable tasks', 'Focus on clear requirements, dependencies, and estimation.', featureBreakdownContent);
+exports.apiDesignSkillStructure = (0, factory_1.createSkillStructure)('api-design', 'API Design', 'Designs APIs following best practices', 'Focus on RESTful design, versioning, error handling, and documentation.', apiDesignContent);
+exports.securityAuditSkillStructure = (0, factory_1.createSkillStructure)('security-audit', 'Security Audit', 'Audits code for security vulnerabilities', 'Focus on OWASP top 10, input validation, authentication, and authorization.', securityAuditContent);
+//# sourceMappingURL=definitions.js.map

package/dist/generators/shared/structures/skills/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/skills/definitions.ts"],"names":[],"mappings":"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"}

package/dist/generators/shared/structures/skills/factory.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Factory function for creating skill structures
+ */
+import { ScaffoldStructure } from '../types';
+/**
+ * Default content overrides for specific sections
+ */
+export interface SkillDefaultContent {
+    whenToUse?: string;
+    instructions?: string;
+    examples?: string;
+    guidelines?: string;
+}
+/**
+ * Create a skill structure with standard sections
+ */
+export declare function createSkillStructure(skillSlug: string, title: string, description: string, additionalContext?: string, defaultContent?: SkillDefaultContent): ScaffoldStructure;
+//# sourceMappingURL=factory.d.ts.map

package/dist/generators/shared/structures/skills/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/skills/factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAmB,MAAM,UAAU,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,cAAc,CAAC,EAAE,mBAAmB,GACnC,iBAAiB,CAyDnB"}

package/dist/generators/shared/structures/skills/factory.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Factory function for creating skill structures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkillStructure = createSkillStructure;
+/**
+ * Map of section headings to content keys
+ */
+const SECTION_KEY_MAP = {
+    'When to Use': 'whenToUse',
+    'Instructions': 'instructions',
+    'Examples': 'examples',
+    'Guidelines': 'guidelines',
+};
+/**
+ * Create a skill structure with standard sections
+ */
+function createSkillStructure(skillSlug, title, description, additionalContext, defaultContent) {
+    const sections = [
+        {
+            heading: 'When to Use',
+            order: 1,
+            contentType: 'prose',
+            guidance: `Briefly describe when this skill should be activated: ${description}`,
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Instructions',
+            order: 2,
+            contentType: 'list',
+            guidance: 'Step-by-step instructions for executing this skill. Be specific and actionable.',
+            exampleContent: '1. First step\n2. Second step\n3. Third step',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Examples',
+            order: 3,
+            contentType: 'code-block',
+            guidance: 'Provide concrete examples of how to use this skill. Include input and expected output.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Guidelines',
+            order: 4,
+            contentType: 'list',
+            guidance: 'Best practices and guidelines for using this skill effectively.',
+            required: true,
+            headingLevel: 2,
+        },
+    ];
+    // Apply default content to sections
+    if (defaultContent) {
+        for (const section of sections) {
+            const key = SECTION_KEY_MAP[section.heading];
+            if (key && defaultContent[key]) {
+                section.defaultContent = defaultContent[key];
+            }
+        }
+    }
+    return {
+        fileType: 'skill',
+        documentName: skillSlug,
+        title,
+        description,
+        tone: 'instructional',
+        audience: 'ai-agents',
+        sections,
+        additionalContext,
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/generators/shared/structures/skills/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/skills/factory.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA2BH,oDA+DC;AA5ED;;GAEG;AACH,MAAM,eAAe,GAA8C;IACjE,aAAa,EAAE,WAAW;IAC1B,cAAc,EAAE,cAAc;IAC9B,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,YAAY;CAC3B,CAAC;AAEF;;GAEG;AACH,SAAgB,oBAAoB,CAClC,SAAiB,EACjB,KAAa,EACb,WAAmB,EACnB,iBAA0B,EAC1B,cAAoC;IAEpC,MAAM,QAAQ,GAAsB;QAClC;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yDAAyD,WAAW,EAAE;YAChF,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,iFAAiF;YAC3F,cAAc,EAAE,8CAA8C;YAC9D,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,wFAAwF;YAClG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,iEAAiE;YAC3E,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;KACF,CAAC;IAEF,oCAAoC;IACpC,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,YAAY,EAAE,SAAS;QACvB,KAAK;QACL,WAAW;QACX,IAAI,EAAE,eAAe;QACrB,QAAQ,EAAE,WAAW;QACrB,QAAQ;QACR,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/generators/shared/structures/skills/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Skill structure exports
+ */
+export { createSkillStructure } from './factory';
+export { commitMessageSkillStructure, prReviewSkillStructure, codeReviewSkillStructure, testGenerationSkillStructure, documentationSkillStructure, refactoringSkillStructure, bugInvestigationSkillStructure, featureBreakdownSkillStructure, apiDesignSkillStructure, securityAuditSkillStructure, } from './definitions';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/shared/structures/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,8BAA8B,EAC9B,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,eAAe,CAAC"}

package/dist/generators/shared/structures/skills/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Skill structure exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.securityAuditSkillStructure = exports.apiDesignSkillStructure = exports.featureBreakdownSkillStructure = exports.bugInvestigationSkillStructure = exports.refactoringSkillStructure = exports.documentationSkillStructure = exports.testGenerationSkillStructure = exports.codeReviewSkillStructure = exports.prReviewSkillStructure = exports.commitMessageSkillStructure = exports.createSkillStructure = void 0;
+var factory_1 = require("./factory");
+Object.defineProperty(exports, "createSkillStructure", { enumerable: true, get: function () { return factory_1.createSkillStructure; } });
+var definitions_1 = require("./definitions");
+Object.defineProperty(exports, "commitMessageSkillStructure", { enumerable: true, get: function () { return definitions_1.commitMessageSkillStructure; } });
+Object.defineProperty(exports, "prReviewSkillStructure", { enumerable: true, get: function () { return definitions_1.prReviewSkillStructure; } });
+Object.defineProperty(exports, "codeReviewSkillStructure", { enumerable: true, get: function () { return definitions_1.codeReviewSkillStructure; } });
+Object.defineProperty(exports, "testGenerationSkillStructure", { enumerable: true, get: function () { return definitions_1.testGenerationSkillStructure; } });
+Object.defineProperty(exports, "documentationSkillStructure", { enumerable: true, get: function () { return definitions_1.documentationSkillStructure; } });
+Object.defineProperty(exports, "refactoringSkillStructure", { enumerable: true, get: function () { return definitions_1.refactoringSkillStructure; } });
+Object.defineProperty(exports, "bugInvestigationSkillStructure", { enumerable: true, get: function () { return definitions_1.bugInvestigationSkillStructure; } });
+Object.defineProperty(exports, "featureBreakdownSkillStructure", { enumerable: true, get: function () { return definitions_1.featureBreakdownSkillStructure; } });
+Object.defineProperty(exports, "apiDesignSkillStructure", { enumerable: true, get: function () { return definitions_1.apiDesignSkillStructure; } });
+Object.defineProperty(exports, "securityAuditSkillStructure", { enumerable: true, get: function () { return definitions_1.securityAuditSkillStructure; } });
+//# sourceMappingURL=index.js.map

package/dist/generators/shared/structures/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/skills/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAAiD;AAAxC,+GAAA,oBAAoB,OAAA;AAC7B,6CAWuB;AAVrB,0HAAA,2BAA2B,OAAA;AAC3B,qHAAA,sBAAsB,OAAA;AACtB,uHAAA,wBAAwB,OAAA;AACxB,2HAAA,4BAA4B,OAAA;AAC5B,0HAAA,2BAA2B,OAAA;AAC3B,wHAAA,yBAAyB,OAAA;AACzB,6HAAA,8BAA8B,OAAA;AAC9B,6HAAA,8BAA8B,OAAA;AAC9B,sHAAA,uBAAuB,OAAA;AACvB,0HAAA,2BAA2B,OAAA"}

package/dist/generators/shared/structures/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Type definitions for scaffold structures
+ */
+import { ScaffoldFileType } from '../../../types/scaffoldFrontmatter';
+/**
+ * Content type for a section
+ */
+export type ScaffoldContentType = 'prose' | 'list' | 'code-block' | 'table' | 'checklist' | 'diagram';
+/**
+ * Tone for document generation
+ */
+export type ScaffoldTone = 'technical' | 'conversational' | 'formal' | 'instructional';
+/**
+ * Target audience
+ */
+export type ScaffoldAudience = 'developers' | 'ai-agents' | 'architects' | 'mixed';
+/**
+ * A section within a scaffold structure
+ */
+export interface ScaffoldSection {
+    /** Section heading (H2 or H3) */
+    heading: string;
+    /** Display order (1-based) */
+    order: number;
+    /** What type of content this section should contain */
+    contentType: ScaffoldContentType;
+    /** Instructions for AI on what to include */
+    guidance: string;
+    /** Optional example of expected content */
+    exampleContent?: string;
+    /** Whether this section is required */
+    required: boolean;
+    /** Heading level (2 = H2, 3 = H3) */
+    headingLevel?: 2 | 3;
+    /** Static default content when not autoFilled. Provides useful template content that works for any project. */
+    defaultContent?: string;
+}
+/**
+ * Complete scaffold structure definition
+ */
+export interface ScaffoldStructure {
+    /** File type */
+    fileType: ScaffoldFileType;
+    /** Document identifier (e.g., 'project-overview', 'code-reviewer') */
+    documentName: string;
+    /** Display title for the document */
+    title: string;
+    /** Brief description of document purpose */
+    description: string;
+    /** Writing tone */
+    tone: ScaffoldTone;
+    /** Target audience */
+    audience: ScaffoldAudience;
+    /** Ordered sections */
+    sections: ScaffoldSection[];
+    /** Related documents to cross-link */
+    linkTo?: string[];
+    /** Additional context for AI generation */
+    additionalContext?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generators/shared/structures/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/generators/shared/structures/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GACP,MAAM,GACN,YAAY,GACZ,OAAO,GACP,WAAW,GACX,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,gBAAgB,GAChB,QAAQ,GACR,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,mBAAmB,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,+GAA+G;IAC/G,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,sBAAsB;IACtB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}

package/dist/generators/shared/structures/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions for scaffold structures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/generators/shared/structures/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/generators/shared/structures/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/generators/shared/structures/validation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validation functions for scaffold structures
+ */
+import { ScaffoldStructure } from './types';
+/**
+ * Validate that a structure is well-formed
+ */
+export declare function validateStructure(structure: ScaffoldStructure): string[];
+/**
+ * Validate all structures in the registry
+ */
+export declare function validateAllStructures(): Map<string, string[]>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/generators/shared/structures/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/generators/shared/structures/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,EAAE,CA8BxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAW7D"}