@ai-coders/context 0.6.1 → 0.7.1

package/dist/generators/shared/structures/documentation/security.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.securityStructure = void 0;
+exports.securityStructure = {
+    fileType: 'doc',
+    documentName: 'security',
+    title: 'Security & Compliance Notes',
+    description: 'Security policies, authentication, secrets management, and compliance requirements',
+    tone: 'formal',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Security & Compliance Notes',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Capture the policies and guardrails that keep this project secure and compliant.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `This document outlines security practices, policies, and guidelines for this project.
+
+**Security Principles**:
+- Defense in depth — Multiple security layers
+- Principle of least privilege — Minimal necessary access
+- Secure by default — Safe configurations out of the box`,
+        },
+        {
+            heading: 'Authentication & Authorization',
+            order: 2,
+            contentType: 'prose',
+            guidance: 'Describe identity providers, token formats, session strategies, and role/permission models.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Authentication**:
+- [Describe authentication mechanism: JWT, sessions, OAuth, etc.]
+- Token/session expiration: [Duration]
+- Refresh strategy: [How tokens are refreshed]
+
+**Authorization**:
+- Permission model: [RBAC, ABAC, etc.]
+- Role definitions: [Admin, User, etc.]
+- Access control enforcement: [Where/how permissions are checked]`,
+        },
+        {
+            heading: 'Secrets & Sensitive Data',
+            order: 3,
+            contentType: 'prose',
+            guidance: 'Document storage locations (vaults, parameter stores), rotation cadence, encryption practices, and data classifications.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Secrets Management**:
+- Storage: Environment variables / secrets manager
+- Never commit secrets to version control
+- Use \`.env.example\` as a template (without real values)
+
+**Sensitive Data Handling**:
+- Encryption at rest: [Yes/No, method]
+- Encryption in transit: TLS 1.2+
+- Data classification: [Public, Internal, Confidential, Restricted]
+
+**Best Practices**:
+- Rotate secrets regularly
+- Use strong, unique passwords
+- Audit access to sensitive data`,
+        },
+        {
+            heading: 'Compliance & Policies',
+            order: 4,
+            contentType: 'list',
+            guidance: 'List applicable standards (GDPR, SOC2, HIPAA, internal policies) and evidence requirements.',
+            required: false,
+            headingLevel: 2,
+            defaultContent: `**Applicable Standards**:
+- [List relevant compliance frameworks]
+
+**Security Policies**:
+- Code review required for all changes
+- Dependency scanning for vulnerabilities
+- Regular security assessments`,
+        },
+        {
+            heading: 'Incident Response',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Note on-call contacts, escalation steps, and tooling for detection, triage, and post-incident analysis.',
+            required: false,
+            headingLevel: 2,
+            defaultContent: `**Reporting Security Issues**:
+- Report security vulnerabilities to [security contact]
+- Do not disclose publicly before fix is available
+
+**Incident Response**:
+1. Identify and contain the issue
+2. Assess impact and scope
+3. Remediate and recover
+4. Document and learn from the incident`,
+        },
+    ],
+    linkTo: ['architecture.md'],
+};
+//# sourceMappingURL=security.js.map

package/dist/generators/shared/structures/documentation/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/security.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,UAAU;IACxB,KAAK,EAAE,6BAA6B;IACpC,WAAW,EAAE,oFAAoF;IACjG,IAAI,EAAE,QAAQ;IACd,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,6BAA6B;YACtC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,kFAAkF;YAC5F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;yDAKmC;SACpD;QACD;YACE,OAAO,EAAE,gCAAgC;YACzC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,6FAA6F;YACvG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;kEAQ4C;SAC7D;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,0HAA0H;YACpI,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;iCAaW;SAC5B;QACD;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,6FAA6F;YACvG,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;+BAMS;SAC1B;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yGAAyG;YACnH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;wCAQkB;SACnC;KACF;IACD,MAAM,EAAE,CAAC,iBAAiB,CAAC;CAC5B,CAAC"}

package/dist/generators/shared/structures/documentation/testing.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const testingStrategyStructure: ScaffoldStructure;
+//# sourceMappingURL=testing.d.ts.map

package/dist/generators/shared/structures/documentation/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBA6HtC,CAAC"}

package/dist/generators/shared/structures/documentation/testing.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testingStrategyStructure = void 0;
+exports.testingStrategyStructure = {
+    fileType: 'doc',
+    documentName: 'testing-strategy',
+    title: 'Testing Strategy',
+    description: 'Test frameworks, patterns, coverage requirements, and quality gates',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Testing Strategy',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Document how quality is maintained across the codebase.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `This document outlines the testing strategy for maintaining code quality.
+
+**Testing Philosophy**:
+- Tests should be fast, isolated, and deterministic
+- Follow the test pyramid: many unit tests, fewer integration tests, minimal E2E tests
+- Test behavior, not implementation details
+- Every bug fix should include a regression test`,
+        },
+        {
+            heading: 'Test Types',
+            order: 2,
+            contentType: 'list',
+            guidance: 'For Unit, Integration, and E2E tests: list frameworks, file naming conventions, and required tooling.',
+            exampleContent: '- **Unit**: Jest, files named `*.test.ts`\n- **Integration**: Describe scenarios\n- **E2E**: Note harnesses or environments',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Unit Tests**:
+- Framework: Jest / Vitest
+- Location: \`__tests__/\` or co-located \`*.test.ts\` files
+- Purpose: Test individual functions and components in isolation
+- Mocking: Use jest mocks for external dependencies
+
+**Integration Tests**:
+- Framework: Jest / Vitest
+- Location: \`tests/integration/\` or \`*.integration.test.ts\`
+- Purpose: Test feature workflows and component interactions
+- Setup: May require test database or external services
+
+**E2E Tests** (if applicable):
+- Framework: Playwright / Cypress
+- Location: \`e2e/\` or \`tests/e2e/\`
+- Purpose: Test critical user paths end-to-end
+- Environment: Requires full application stack`,
+        },
+        {
+            heading: 'Running Tests',
+            order: 3,
+            contentType: 'list',
+            guidance: 'Commands for running all tests, watch mode, and coverage. Use code blocks.',
+            exampleContent: '- All tests: `npm run test`\n- Watch mode: `npm run test -- --watch`\n- Coverage: `npm run test -- --coverage`',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Commands**:
+\`\`\`bash
+# Run all tests
+npm run test
+
+# Run tests in watch mode (for development)
+npm run test -- --watch
+
+# Run tests with coverage report
+npm run test -- --coverage
+
+# Run specific test file
+npm run test -- path/to/file.test.ts
+
+# Run tests matching pattern
+npm run test -- --testNamePattern="pattern"
+\`\`\``,
+        },
+        {
+            heading: 'Quality Gates',
+            order: 4,
+            contentType: 'list',
+            guidance: 'Define minimum coverage expectations. Capture linting or formatting requirements before merging.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Coverage Requirements**:
+- Minimum overall coverage: 80%
+- New code should have higher coverage
+- Critical paths require 100% coverage
+
+**Pre-merge Checks**:
+- [ ] All tests pass
+- [ ] Coverage thresholds met
+- [ ] Linting passes (\`npm run lint\`)
+- [ ] Type checking passes (\`npm run typecheck\`)
+- [ ] Build succeeds (\`npm run build\`)
+
+**CI Pipeline**:
+- Tests run automatically on every PR
+- Coverage reports generated and compared to baseline
+- Failed checks block merge`,
+        },
+        {
+            heading: 'Troubleshooting',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Document flaky suites, long-running tests, or environment quirks.',
+            required: false,
+            headingLevel: 2,
+            defaultContent: `**Common Issues**:
+
+*Tests timing out*:
+- Increase timeout for slow operations
+- Check for unresolved promises
+- Verify mocks are properly configured
+
+*Flaky tests*:
+- Avoid time-dependent assertions
+- Use proper async/await patterns
+- Isolate tests from external state
+
+*Environment issues*:
+- Ensure Node version matches project requirements
+- Clear node_modules and reinstall if dependencies are corrupted
+- Check for conflicting global installations`,
+        },
+    ],
+    linkTo: ['development-workflow.md'],
+};
+//# sourceMappingURL=testing.js.map

package/dist/generators/shared/structures/documentation/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/testing.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,kBAAkB;IAChC,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,qEAAqE;IAClF,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yDAAyD;YACnE,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;iDAM2B;SAC5C;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uGAAuG;YACjH,cAAc,EAAE,6HAA6H;YAC7I,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;;+CAgByB;SAC1C;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,4EAA4E;YACtF,cAAc,EAAE,gHAAgH;YAChI,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;;OAgBf;SACF;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,kGAAkG;YAC5G,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;4BAeM;SACvB;QACD;YACE,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,mEAAmE;YAC7E,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;6CAeuB;SACxC;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,CAAC;CACpC,CAAC"}

package/dist/generators/shared/structures/documentation/tooling.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const toolingStructure: ScaffoldStructure;
+//# sourceMappingURL=tooling.d.ts.map

package/dist/generators/shared/structures/documentation/tooling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/tooling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,gBAAgB,EAAE,iBA6G9B,CAAC"}

package/dist/generators/shared/structures/documentation/tooling.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolingStructure = void 0;
+exports.toolingStructure = {
+    fileType: 'doc',
+    documentName: 'tooling',
+    title: 'Tooling & Productivity Guide',
+    description: 'Scripts, IDE settings, automation, and developer productivity tips',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Tooling & Productivity Guide',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Collect the scripts, automation, and editor settings that keep contributors efficient.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `This guide covers the tools, scripts, and configurations that make development efficient.
+
+Following these setup recommendations ensures a consistent development experience across the team.`,
+        },
+        {
+            heading: 'Required Tooling',
+            order: 2,
+            contentType: 'list',
+            guidance: 'List tools with installation instructions, version requirements, and what they power.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Runtime**:
+- Node.js (v18+ recommended)
+- npm / yarn / pnpm
+
+**Version Management** (recommended):
+- [nvm](https://github.com/nvm-sh/nvm) for Node.js version management
+- \`.nvmrc\` file specifies project Node version
+
+**Installation**:
+\`\`\`bash
+# Using nvm (recommended)
+nvm install
+nvm use
+
+# Install dependencies
+npm install
+\`\`\``,
+        },
+        {
+            heading: 'Recommended Automation',
+            order: 3,
+            contentType: 'prose',
+            guidance: 'Document pre-commit hooks, linting/formatting commands, code generators, or scaffolding scripts. Include shortcuts or watch modes.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Pre-commit Hooks**:
+The project uses [husky](https://typicode.github.io/husky/) for git hooks:
+- Pre-commit: Runs linting and type checking
+- Commit message: Validates commit message format
+
+**Code Quality Commands**:
+\`\`\`bash
+npm run lint          # Check code style
+npm run lint:fix      # Auto-fix style issues
+npm run format        # Format code with Prettier
+npm run typecheck     # TypeScript type checking
+\`\`\`
+
+**Watch Mode**:
+\`\`\`bash
+npm run dev           # Development with hot reload
+npm run test:watch    # Tests in watch mode
+\`\`\``,
+        },
+        {
+            heading: 'IDE / Editor Setup',
+            order: 4,
+            contentType: 'list',
+            guidance: 'List extensions or plugins that catch issues early. Share snippets, templates, or workspace settings.',
+            required: false,
+            headingLevel: 2,
+            defaultContent: `**VS Code Recommended Extensions**:
+- ESLint — Inline linting
+- Prettier — Code formatting
+- TypeScript + JavaScript Language Features — IntelliSense
+- Error Lens — Inline error highlighting
+
+**Workspace Settings**:
+The \`.vscode/\` folder contains shared settings:
+- \`settings.json\` — Editor configuration
+- \`extensions.json\` — Recommended extensions
+- \`launch.json\` — Debug configurations`,
+        },
+        {
+            heading: 'Productivity Tips',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Document terminal aliases, container workflows, or local emulators. Link to shared scripts or dotfiles.',
+            required: false,
+            headingLevel: 2,
+            defaultContent: `**Useful Aliases**:
+\`\`\`bash
+alias nr='npm run'
+alias nrd='npm run dev'
+alias nrt='npm run test'
+\`\`\`
+
+**Quick Commands**:
+- \`npm run build && npm run test\` — Full verification before PR
+- \`npm run clean\` — Clear build artifacts and caches`,
+        },
+    ],
+    linkTo: ['development-workflow.md'],
+};
+//# sourceMappingURL=tooling.js.map

package/dist/generators/shared/structures/documentation/tooling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/tooling.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAsB;IACjD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,SAAS;IACvB,KAAK,EAAE,8BAA8B;IACrC,WAAW,EAAE,oEAAoE;IACjF,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,8BAA8B;YACvC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,wFAAwF;YAClG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;mGAE6E;SAC9F;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uFAAuF;YACjG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;;OAgBf;SACF;QACD;YACE,OAAO,EAAE,wBAAwB;YACjC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,oIAAoI;YAC9I,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;;;OAiBf;SACF;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,uGAAuG;YACjH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;yCAUmB;SACpC;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yGAAyG;YACnH,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;uDASiC;SAClD;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,CAAC;CACpC,CAAC"}

package/dist/generators/shared/structures/documentation/troubleshooting.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const troubleshootingStructure: ScaffoldStructure;
+//# sourceMappingURL=troubleshooting.d.ts.map

package/dist/generators/shared/structures/documentation/troubleshooting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshooting.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/troubleshooting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBAsFtC,CAAC"}

package/dist/generators/shared/structures/documentation/troubleshooting.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.troubleshootingStructure = void 0;
+exports.troubleshootingStructure = {
+    fileType: 'doc',
+    documentName: 'troubleshooting',
+    title: 'Troubleshooting Guide',
+    description: 'Diagnostic procedures and solutions for common issues, designed for both developers and AI agents',
+    tone: 'technical',
+    audience: 'mixed',
+    sections: [
+        {
+            heading: 'Troubleshooting Guide',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Describe the purpose and agent protocol: run diagnostics, match symptoms to patterns, resolve if confident, escalate if uncertain.',
+            exampleContent: '**Agent Protocol:**\n1. Run diagnostic script to gather facts\n2. Match symptoms to known patterns\n3. Execute resolution if confidence high (>80%)\n4. Escalate to human if uncertain\n5. Log all diagnostic steps',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Agent Diagnostic Script',
+            order: 2,
+            contentType: 'code-block',
+            guidance: 'Provide bash script for agents to diagnose system state including application status, errors, resources, services, and processes.',
+            exampleContent: 'Script that checks: health endpoint, recent errors, CPU/memory/disk usage, database/cache connectivity, recent changes, and processes',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Agent Decision Tree',
+            order: 3,
+            contentType: 'diagram',
+            guidance: 'ASCII or Mermaid diagram showing how agents classify issues based on diagnostic output (not responding, database unreachable, errors, performance).',
+            exampleContent: 'App responding? → DB reachable? → Error log entries? → Resource usage normal?',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Common Issues & Solutions',
+            order: 4,
+            contentType: 'prose',
+            guidance: 'Document common issues organized by category (startup, database, performance) with: error detection patterns, agent diagnostic procedures, auto-resolution scripts, and escalation criteria.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Application Won\'t Start',
+            order: 5,
+            contentType: 'list',
+            guidance: 'List common startup issues (port in use, missing modules, missing environment variables) with bash commands for diagnosis and resolution.',
+            exampleContent: '- Port in use: use lsof to find process, kill it, restart app\n- Missing module: clear node_modules and reinstall\n- Missing env var: check .env.example and set required variables',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Performance Issues',
+            order: 6,
+            contentType: 'prose',
+            guidance: 'Document how to diagnose performance problems (high CPU, memory, slow queries) with monitoring commands and optimization steps.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Database Issues',
+            order: 7,
+            contentType: 'prose',
+            guidance: 'Document database connection diagnostics with connection checking procedures and startup attempts for containerized or local databases.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Escalation Criteria',
+            order: 8,
+            contentType: 'prose',
+            guidance: 'Define when agents must escalate: unknown patterns, data corruption risk, security issues, multiple failed attempts, or human approval needed.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Escalation Format',
+            order: 9,
+            contentType: 'code-block',
+            guidance: 'Provide template for structured escalation including issue description, symptoms, diagnostics run, attempted resolutions, and recommendations.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+    linkTo: ['development-workflow.md', 'security.md'],
+};
+//# sourceMappingURL=troubleshooting.js.map

package/dist/generators/shared/structures/documentation/troubleshooting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshooting.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/troubleshooting.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,iBAAiB;IAC/B,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,mGAAmG;IAChH,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,oIAAoI;YAC9I,cAAc,EAAE,qNAAqN;YACrO,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,yBAAyB;YAClC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,mIAAmI;YAC7I,cAAc,EAAE,uIAAuI;YACvJ,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,SAAS;YACtB,QAAQ,EAAE,qJAAqJ;YAC/J,cAAc,EAAE,+EAA+E;YAC/F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,2BAA2B;YACpC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8LAA8L;YACxM,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,2IAA2I;YACrJ,cAAc,EAAE,qLAAqL;YACrM,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,oBAAoB;YAC7B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,iIAAiI;YAC3I,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,yIAAyI;YACnJ,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,gJAAgJ;YAC1J,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,gJAAgJ;YAC1J,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;IACD,MAAM,EAAE,CAAC,yBAAyB,EAAE,aAAa,CAAC;CACnD,CAAC"}

package/dist/generators/shared/structures/documentation/workflow.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldStructure } from '../types';
+export declare const developmentWorkflowStructure: ScaffoldStructure;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/generators/shared/structures/documentation/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,4BAA4B,EAAE,iBA+G1C,CAAC"}

package/dist/generators/shared/structures/documentation/workflow.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.developmentWorkflowStructure = void 0;
+exports.developmentWorkflowStructure = {
+    fileType: 'doc',
+    documentName: 'development-workflow',
+    title: 'Development Workflow',
+    description: 'Day-to-day engineering processes, branching, and contribution guidelines',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Development Workflow',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Outline the day-to-day engineering process for this repository.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `This document outlines the day-to-day engineering process for contributing to this repository.
+
+Following these guidelines ensures consistent code quality and smooth collaboration across the team.`,
+        },
+        {
+            heading: 'Branching & Releases',
+            order: 2,
+            contentType: 'list',
+            guidance: 'Describe the branching model (trunk-based, Git Flow, etc.). Note release cadence and tagging conventions.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Branching Model**: Feature branches off \`main\`
+
+- \`main\` — Production-ready code, always deployable
+- \`feature/*\` — New features and enhancements
+- \`fix/*\` — Bug fixes
+- \`chore/*\` — Maintenance and tooling updates
+
+**Release Process**:
+1. Features are developed in branches
+2. PRs require review and passing CI
+3. Merged PRs are deployed automatically (or tagged for release)
+
+**Versioning**: Semantic versioning (semver) - MAJOR.MINOR.PATCH`,
+        },
+        {
+            heading: 'Local Development',
+            order: 3,
+            contentType: 'list',
+            guidance: 'Commands to install dependencies, run locally, and build for distribution. Use code blocks for commands.',
+            exampleContent: '- Install: `npm install`\n- Run: `npm run dev`\n- Build: `npm run build`',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**Setup**:
+\`\`\`bash
+# Clone and install
+git clone <repository-url>
+cd <project-name>
+npm install
+\`\`\`
+
+**Daily Commands**:
+- \`npm run dev\` — Start development server/watch mode
+- \`npm run build\` — Build for production
+- \`npm run test\` — Run test suite
+- \`npm run lint\` — Check code style
+
+**Before Committing**:
+\`\`\`bash
+npm run lint && npm run test && npm run build
+\`\`\``,
+        },
+        {
+            heading: 'Code Review Expectations',
+            order: 4,
+            contentType: 'prose',
+            guidance: 'Summarize review checklists and required approvals. Reference AGENTS.md for agent collaboration tips.',
+            required: true,
+            headingLevel: 2,
+            defaultContent: `**PR Requirements**:
+- Clear description of changes and motivation
+- Tests for new functionality
+- Documentation updates for API changes
+- Passing CI checks
+
+**Review Checklist**:
+- [ ] Code follows project conventions
+- [ ] Tests cover the changes adequately
+- [ ] No security vulnerabilities introduced
+- [ ] Documentation is updated
+- [ ] Commit messages follow conventions
+
+**Approval**: At least one approving review required before merge.
+
+See [AGENTS.md](../../AGENTS.md) for AI assistant collaboration guidelines.`,
+        },
+        {
+            heading: 'Onboarding Tasks',
+            order: 5,
+            contentType: 'prose',
+            guidance: 'Point newcomers to first issues or starter tickets. Link to internal runbooks or dashboards.',
+            required: false,
+            headingLevel: 2,
+            defaultContent: `**First Steps for New Contributors**:
+1. Read the [Project Overview](./project-overview.md)
+2. Set up local development environment
+3. Run the test suite to verify setup
+4. Look for issues labeled \`good-first-issue\` or \`help-wanted\`
+
+**Helpful Resources**:
+- [Architecture Notes](./architecture.md) — System design overview
+- [Testing Strategy](./testing-strategy.md) — How to write tests
+- [CONTRIBUTING.md](../../CONTRIBUTING.md) — Contribution guidelines`,
+        },
+    ],
+    linkTo: ['testing-strategy.md', 'tooling.md'],
+};
+//# sourceMappingURL=workflow.js.map

package/dist/generators/shared/structures/documentation/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/documentation/workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,4BAA4B,GAAsB;IAC7D,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,sBAAsB;IACpC,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,0EAA0E;IACvF,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,sBAAsB;YAC/B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,iEAAiE;YAC3E,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;qGAE+E;SAChG;QACD;YACE,OAAO,EAAE,sBAAsB;YAC/B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,2GAA2G;YACrH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;iEAY2C;SAC5D;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,0GAA0G;YACpH,cAAc,EAAE,0EAA0E;YAC1F,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;;;OAiBf;SACF;QACD;YACE,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uGAAuG;YACjH,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;;;;;;;4EAesD;SACvE;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,8FAA8F;YACxG,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;YACf,cAAc,EAAE;;;;;;;;;qEAS+C;SAChE;KACF;IACD,MAAM,EAAE,CAAC,qBAAqB,EAAE,YAAY,CAAC;CAC9C,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Scaffold structures index
+ *
+ * This file serves as the main barrel export for all scaffold structures,
+ * providing backward compatibility with the original scaffoldStructures.ts import path.
+ */
+export * from './types';
+export * from './documentation';
+export * from './agents';
+export * from './skills';
+export * from './plans';
+export * from './registry';
+export * from './validation';
+export * from './serialization';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/shared/structures/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}