@ai-coders/context 0.6.1 → 0.7.1

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

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * 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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Types
+__exportStar(require("./types"), exports);
+// Documentation structures
+__exportStar(require("./documentation"), exports);
+// Agent structures
+__exportStar(require("./agents"), exports);
+// Skill structures
+__exportStar(require("./skills"), exports);
+// Plan structures
+__exportStar(require("./plans"), exports);
+// Registry & utilities
+__exportStar(require("./registry"), exports);
+__exportStar(require("./validation"), exports);
+__exportStar(require("./serialization"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/generators/shared/structures/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,2BAA2B;AAC3B,kDAAgC;AAEhC,mBAAmB;AACnB,2CAAyB;AAEzB,mBAAmB;AACnB,2CAAyB;AAEzB,kBAAkB;AAClB,0CAAwB;AAExB,uBAAuB;AACvB,6CAA2B;AAC3B,+CAA6B;AAC7B,kDAAgC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Plan structure exports
+ */
+export { planStructure } from './planStructure';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/plans/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Plan structure exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planStructure = void 0;
+var planStructure_1 = require("./planStructure");
+Object.defineProperty(exports, "planStructure", { enumerable: true, get: function () { return planStructure_1.planStructure; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/plans/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/dist/generators/shared/structures/plans/planStructure.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Plan structure definition
+ */
+import { ScaffoldStructure } from '../types';
+export declare const planStructure: ScaffoldStructure;
+//# sourceMappingURL=planStructure.d.ts.map

package/dist/generators/shared/structures/plans/planStructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planStructure.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/plans/planStructure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,aAAa,EAAE,iBAyD3B,CAAC"}

package/dist/generators/shared/structures/plans/planStructure.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Plan structure definition
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planStructure = void 0;
+exports.planStructure = {
+    fileType: 'plan',
+    documentName: 'implementation-plan',
+    title: 'Implementation Plan',
+    description: 'Detailed implementation plan for a feature or task',
+    tone: 'instructional',
+    audience: 'developers',
+    sections: [
+        {
+            heading: 'Overview',
+            order: 1,
+            contentType: 'prose',
+            guidance: 'Summarize the goal and scope of this implementation plan.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Codebase Context',
+            order: 2,
+            contentType: 'prose',
+            guidance: 'Describe the relevant parts of the codebase, architecture layers, and key components.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Implementation Phases',
+            order: 3,
+            contentType: 'list',
+            guidance: 'Break down implementation into phases mapped to PREVC (Planning, Review, Execution, Validation, Confirmation).',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Agent Assignments',
+            order: 4,
+            contentType: 'list',
+            guidance: 'List which agents are responsible for which phases.',
+            required: true,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Documentation Updates',
+            order: 5,
+            contentType: 'list',
+            guidance: 'List documentation files that need to be updated.',
+            required: false,
+            headingLevel: 2,
+        },
+        {
+            heading: 'Risks & Mitigations',
+            order: 6,
+            contentType: 'list',
+            guidance: 'Identify potential risks and mitigation strategies.',
+            required: false,
+            headingLevel: 2,
+        },
+    ],
+};
+//# sourceMappingURL=planStructure.js.map

package/dist/generators/shared/structures/plans/planStructure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planStructure.js","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/plans/planStructure.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIU,QAAA,aAAa,GAAsB;IAC9C,QAAQ,EAAE,MAAM;IAChB,YAAY,EAAE,qBAAqB;IACnC,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,oDAAoD;IACjE,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE;QACR;YACE,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,2DAA2D;YACrE,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,kBAAkB;YAC3B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,OAAO;YACpB,QAAQ,EAAE,uFAAuF;YACjG,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,gHAAgH;YAC1H,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,qDAAqD;YAC/D,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,uBAAuB;YAChC,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,mDAAmD;YAC7D,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;QACD;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,CAAC;YACR,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,qDAAqD;YAC/D,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,CAAC;SAChB;KACF;CACF,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Scaffold structures registry and lookup functions
+ */
+import { ScaffoldFileType } from '../../../types/scaffoldFrontmatter';
+import { ScaffoldStructure } from './types';
+/**
+ * All scaffold structures indexed by document name
+ */
+export declare const SCAFFOLD_STRUCTURES: Record<string, ScaffoldStructure>;
+/**
+ * Get scaffold structure by name
+ */
+export declare function getScaffoldStructure(name: string): ScaffoldStructure | undefined;
+/**
+ * Get all structures of a specific file type
+ */
+export declare function getStructuresByType(fileType: ScaffoldFileType): ScaffoldStructure[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/generators/shared/structures/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAM5C;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CA6CjE,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,iBAAiB,EAAE,CAEnF"}

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

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Scaffold structures registry and lookup functions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCAFFOLD_STRUCTURES = void 0;
+exports.getScaffoldStructure = getScaffoldStructure;
+exports.getStructuresByType = getStructuresByType;
+const docStructures = __importStar(require("./documentation"));
+const agentStructures = __importStar(require("./agents"));
+const skillStructures = __importStar(require("./skills"));
+const plans_1 = require("./plans");
+/**
+ * All scaffold structures indexed by document name
+ */
+exports.SCAFFOLD_STRUCTURES = {
+    // Documentation
+    'project-overview': docStructures.projectOverviewStructure,
+    'architecture': docStructures.architectureStructure,
+    'development-workflow': docStructures.developmentWorkflowStructure,
+    'testing-strategy': docStructures.testingStrategyStructure,
+    'tooling': docStructures.toolingStructure,
+    'security': docStructures.securityStructure,
+    'glossary': docStructures.glossaryStructure,
+    'data-flow': docStructures.dataFlowStructure,
+    'onboarding': docStructures.onboardingStructure,
+    'api-reference': docStructures.apiReferenceStructure,
+    'migration': docStructures.migrationStructure,
+    'troubleshooting': docStructures.troubleshootingStructure,
+    // Agents
+    'code-reviewer': agentStructures.codeReviewerStructure,
+    'bug-fixer': agentStructures.bugFixerStructure,
+    'feature-developer': agentStructures.featureDeveloperStructure,
+    'refactoring-specialist': agentStructures.refactoringSpecialistStructure,
+    'test-writer': agentStructures.testWriterStructure,
+    'documentation-writer': agentStructures.documentationWriterStructure,
+    'performance-optimizer': agentStructures.performanceOptimizerStructure,
+    'security-auditor': agentStructures.securityAuditorStructure,
+    'backend-specialist': agentStructures.backendSpecialistStructure,
+    'frontend-specialist': agentStructures.frontendSpecialistStructure,
+    'architect-specialist': agentStructures.architectSpecialistStructure,
+    'devops-specialist': agentStructures.devopsSpecialistStructure,
+    'database-specialist': agentStructures.databaseSpecialistStructure,
+    'mobile-specialist': agentStructures.mobileSpecialistStructure,
+    // Skills
+    'commit-message': skillStructures.commitMessageSkillStructure,
+    'pr-review': skillStructures.prReviewSkillStructure,
+    'code-review': skillStructures.codeReviewSkillStructure,
+    'test-generation': skillStructures.testGenerationSkillStructure,
+    'documentation': skillStructures.documentationSkillStructure,
+    'refactoring': skillStructures.refactoringSkillStructure,
+    'bug-investigation': skillStructures.bugInvestigationSkillStructure,
+    'feature-breakdown': skillStructures.featureBreakdownSkillStructure,
+    'api-design': skillStructures.apiDesignSkillStructure,
+    'security-audit': skillStructures.securityAuditSkillStructure,
+    // Plans
+    'implementation-plan': plans_1.planStructure,
+};
+/**
+ * Get scaffold structure by name
+ */
+function getScaffoldStructure(name) {
+    return exports.SCAFFOLD_STRUCTURES[name];
+}
+/**
+ * Get all structures of a specific file type
+ */
+function getStructuresByType(fileType) {
+    return Object.values(exports.SCAFFOLD_STRUCTURES).filter(s => s.fileType === fileType);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/generators/shared/structures/registry.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8DH,oDAEC;AAKD,kDAEC;AAnED,+DAAiD;AACjD,0DAA4C;AAC5C,0DAA4C;AAC5C,mCAAwC;AAExC;;GAEG;AACU,QAAA,mBAAmB,GAAsC;IACpE,gBAAgB;IAChB,kBAAkB,EAAE,aAAa,CAAC,wBAAwB;IAC1D,cAAc,EAAE,aAAa,CAAC,qBAAqB;IACnD,sBAAsB,EAAE,aAAa,CAAC,4BAA4B;IAClE,kBAAkB,EAAE,aAAa,CAAC,wBAAwB;IAC1D,SAAS,EAAE,aAAa,CAAC,gBAAgB;IACzC,UAAU,EAAE,aAAa,CAAC,iBAAiB;IAC3C,UAAU,EAAE,aAAa,CAAC,iBAAiB;IAC3C,WAAW,EAAE,aAAa,CAAC,iBAAiB;IAC5C,YAAY,EAAE,aAAa,CAAC,mBAAmB;IAC/C,eAAe,EAAE,aAAa,CAAC,qBAAqB;IACpD,WAAW,EAAE,aAAa,CAAC,kBAAkB;IAC7C,iBAAiB,EAAE,aAAa,CAAC,wBAAwB;IAEzD,SAAS;IACT,eAAe,EAAE,eAAe,CAAC,qBAAqB;IACtD,WAAW,EAAE,eAAe,CAAC,iBAAiB;IAC9C,mBAAmB,EAAE,eAAe,CAAC,yBAAyB;IAC9D,wBAAwB,EAAE,eAAe,CAAC,8BAA8B;IACxE,aAAa,EAAE,eAAe,CAAC,mBAAmB;IAClD,sBAAsB,EAAE,eAAe,CAAC,4BAA4B;IACpE,uBAAuB,EAAE,eAAe,CAAC,6BAA6B;IACtE,kBAAkB,EAAE,eAAe,CAAC,wBAAwB;IAC5D,oBAAoB,EAAE,eAAe,CAAC,0BAA0B;IAChE,qBAAqB,EAAE,eAAe,CAAC,2BAA2B;IAClE,sBAAsB,EAAE,eAAe,CAAC,4BAA4B;IACpE,mBAAmB,EAAE,eAAe,CAAC,yBAAyB;IAC9D,qBAAqB,EAAE,eAAe,CAAC,2BAA2B;IAClE,mBAAmB,EAAE,eAAe,CAAC,yBAAyB;IAE9D,SAAS;IACT,gBAAgB,EAAE,eAAe,CAAC,2BAA2B;IAC7D,WAAW,EAAE,eAAe,CAAC,sBAAsB;IACnD,aAAa,EAAE,eAAe,CAAC,wBAAwB;IACvD,iBAAiB,EAAE,eAAe,CAAC,4BAA4B;IAC/D,eAAe,EAAE,eAAe,CAAC,2BAA2B;IAC5D,aAAa,EAAE,eAAe,CAAC,yBAAyB;IACxD,mBAAmB,EAAE,eAAe,CAAC,8BAA8B;IACnE,mBAAmB,EAAE,eAAe,CAAC,8BAA8B;IACnE,YAAY,EAAE,eAAe,CAAC,uBAAuB;IACrD,gBAAgB,EAAE,eAAe,CAAC,2BAA2B;IAE7D,QAAQ;IACR,qBAAqB,EAAE,qBAAa;CACrC,CAAC;AAEF;;GAEG;AACH,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,OAAO,2BAAmB,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,QAA0B;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,2BAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Serialization functions for scaffold structures
+ */
+import { ScaffoldStructure } from './types';
+/**
+ * Serialize a scaffold structure to markdown content with section headings,
+ * guidance comments, and example content.
+ * Used for CLI mode to provide useful templates for manual filling.
+ */
+export declare function serializeStructureAsMarkdown(structure: ScaffoldStructure): string;
+/**
+ * Serialize a scaffold structure to a readable format for AI context
+ */
+export declare function serializeStructureForAI(structure: ScaffoldStructure): string;
+//# sourceMappingURL=serialization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../../src/generators/shared/structures/serialization.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAmB,MAAM,SAAS,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAuBjF;AA0DD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAgD5E"}

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

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Serialization functions for scaffold structures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeStructureAsMarkdown = serializeStructureAsMarkdown;
+exports.serializeStructureForAI = serializeStructureForAI;
+/**
+ * Serialize a scaffold structure to markdown content with section headings,
+ * guidance comments, and example content.
+ * Used for CLI mode to provide useful templates for manual filling.
+ */
+function serializeStructureAsMarkdown(structure) {
+    const lines = [];
+    const sortedSections = [...structure.sections].sort((a, b) => a.order - b.order);
+    for (const section of sortedSections) {
+        lines.push(formatSectionAsMarkdown(section));
+        lines.push('');
+    }
+    // Add cross-references section if present
+    if (structure.linkTo && structure.linkTo.length > 0) {
+        lines.push('## Related Resources');
+        lines.push('');
+        lines.push('<!-- Link to related documents for cross-navigation. -->');
+        lines.push('');
+        for (const link of structure.linkTo) {
+            lines.push(`- [${link}](./${link})`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a single section as markdown with heading, guidance, and example/placeholder content.
+ */
+function formatSectionAsMarkdown(section) {
+    const lines = [];
+    // Create heading with appropriate level
+    const headingLevel = section.headingLevel || 2;
+    const headingPrefix = '#'.repeat(headingLevel);
+    lines.push(`${headingPrefix} ${section.heading}`);
+    lines.push('');
+    // Prefer defaultContent (static useful content) over guidance + placeholder
+    if (section.defaultContent) {
+        lines.push(section.defaultContent);
+        return lines.join('\n');
+    }
+    // Add guidance as HTML comment
+    lines.push(`<!-- ${section.guidance} -->`);
+    lines.push('');
+    // Add example content or placeholder based on content type
+    if (section.exampleContent) {
+        lines.push(section.exampleContent);
+    }
+    else {
+        lines.push(getPlaceholderForContentType(section.contentType, section.required));
+    }
+    return lines.join('\n');
+}
+/**
+ * Get appropriate placeholder text based on content type.
+ */
+function getPlaceholderForContentType(contentType, required) {
+    const requiredNote = required ? '' : ' (optional)';
+    switch (contentType) {
+        case 'prose':
+            return `_Add descriptive content here${requiredNote}._`;
+        case 'list':
+            return `- _Item 1${requiredNote}_\n- _Item 2_\n- _Item 3_`;
+        case 'code-block':
+            return '```\n// Add code example here\n```';
+        case 'table':
+            return '| Column 1 | Column 2 | Column 3 |\n|----------|----------|----------|\n| _value_ | _value_ | _value_ |';
+        case 'checklist':
+            return `- [ ] _Task 1${requiredNote}_\n- [ ] _Task 2_\n- [ ] _Task 3_`;
+        case 'diagram':
+            return '```mermaid\ngraph TD\n    A[Start] --> B[End]\n```';
+        default:
+            return `_Add content here${requiredNote}._`;
+    }
+}
+/**
+ * Serialize a scaffold structure to a readable format for AI context
+ */
+function serializeStructureForAI(structure) {
+    const lines = [];
+    lines.push(`# Document Structure: ${structure.title}`);
+    lines.push('');
+    lines.push(`**Type:** ${structure.fileType}`);
+    lines.push(`**Tone:** ${structure.tone}`);
+    lines.push(`**Audience:** ${structure.audience}`);
+    lines.push(`**Description:** ${structure.description}`);
+    if (structure.additionalContext) {
+        lines.push(`**Additional Context:** ${structure.additionalContext}`);
+    }
+    lines.push('');
+    lines.push('## Required Sections');
+    lines.push('');
+    const sortedSections = [...structure.sections].sort((a, b) => a.order - b.order);
+    for (const section of sortedSections) {
+        const requiredLabel = section.required ? '(REQUIRED)' : '(optional)';
+        const level = section.headingLevel || 2;
+        const headingPrefix = '#'.repeat(level);
+        lines.push(`### ${section.order}. ${headingPrefix} ${section.heading} ${requiredLabel}`);
+        lines.push(`- **Content Type:** ${section.contentType}`);
+        lines.push(`- **Guidance:** ${section.guidance}`);
+        if (section.exampleContent) {
+            lines.push('- **Example:**');
+            lines.push('```');
+            lines.push(section.exampleContent);
+            lines.push('```');
+        }
+        lines.push('');
+    }
+    if (structure.linkTo && structure.linkTo.length > 0) {
+        lines.push('## Cross-References');
+        lines.push('Link to these related documents where appropriate:');
+        for (const link of structure.linkTo) {
+            lines.push(`- ${link}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=serialization.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Skill structure definitions with static default content
+ */
+export declare const commitMessageSkillStructure: import("..").ScaffoldStructure;
+export declare const prReviewSkillStructure: import("..").ScaffoldStructure;
+export declare const codeReviewSkillStructure: import("..").ScaffoldStructure;
+export declare const testGenerationSkillStructure: import("..").ScaffoldStructure;
+export declare const documentationSkillStructure: import("..").ScaffoldStructure;
+export declare const refactoringSkillStructure: import("..").ScaffoldStructure;
+export declare const bugInvestigationSkillStructure: import("..").ScaffoldStructure;
+export declare const featureBreakdownSkillStructure: import("..").ScaffoldStructure;
+export declare const apiDesignSkillStructure: import("..").ScaffoldStructure;
+export declare const securityAuditSkillStructure: import("..").ScaffoldStructure;
+//# sourceMappingURL=definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../../../src/generators/shared/structures/skills/definitions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAucH,eAAO,MAAM,2BAA2B,gCAMvC,CAAC;AAEF,eAAO,MAAM,sBAAsB,gCAMlC,CAAC;AAEF,eAAO,MAAM,wBAAwB,gCAMpC,CAAC;AAEF,eAAO,MAAM,4BAA4B,gCAMxC,CAAC;AAEF,eAAO,MAAM,2BAA2B,gCAMvC,CAAC;AAEF,eAAO,MAAM,yBAAyB,gCAMrC,CAAC;AAEF,eAAO,MAAM,8BAA8B,gCAM1C,CAAC;AAEF,eAAO,MAAM,8BAA8B,gCAM1C,CAAC;AAEF,eAAO,MAAM,uBAAuB,gCAMnC,CAAC;AAEF,eAAO,MAAM,2BAA2B,gCAMvC,CAAC"}