timsquad 2.1.0 → 3.4.0

package/dist/lib/ast-parser.js

@@ -0,0 +1,282 @@
+/**
+ * AST Parser using @swc/core
+ * 파일의 mechanical 코드 구조를 추출: classes, interfaces, methods, imports/exports
+ * 토큰 비용: 0 (로컬 파일 파싱)
+ */
+import { parse } from '@swc/core';
+import path from 'path';
+import { readFile } from '../utils/fs.js';
+/**
+ * Parse a single file and extract mechanical structure
+ */
+export async function parseFile(filePath) {
+    const content = await readFile(filePath);
+    const ext = path.extname(filePath);
+    const isJsx = ext === '.jsx' || ext === '.tsx';
+    const syntax = ext === '.jsx' || ext === '.js' ? 'ecmascript' : 'typescript';
+    const module = await parse(content, {
+        syntax,
+        ...(syntax === 'typescript' ? { tsx: isJsx, decorators: true } : { jsx: isJsx, decorators: true }),
+    });
+    const totalLines = content.split('\n').length;
+    const classes = [];
+    const interfaces = [];
+    const exports = [];
+    const imports = [];
+    const methods = {};
+    for (const item of module.body) {
+        switch (item.type) {
+            case 'ImportDeclaration': {
+                const names = item.specifiers.map((s) => {
+                    if (s.type === 'ImportDefaultSpecifier')
+                        return 'default';
+                    if (s.type === 'ImportNamespaceSpecifier')
+                        return '*';
+                    return s.local?.value || '';
+                }).filter(Boolean);
+                imports.push({ module: item.source.value, names });
+                break;
+            }
+            case 'ExportDeclaration': {
+                const decl = item.declaration;
+                processDeclaration(decl, content, classes, interfaces, exports, methods, true);
+                break;
+            }
+            case 'ExportDefaultDeclaration': {
+                const decl = item.decl;
+                if (decl?.identifier?.value) {
+                    exports.push(decl.identifier.value);
+                }
+                else {
+                    exports.push('default');
+                }
+                break;
+            }
+            case 'ExportNamedDeclaration': {
+                const specifiers = item.specifiers || [];
+                for (const s of specifiers) {
+                    const name = s.exported?.value || s.orig?.value;
+                    if (name)
+                        exports.push(name);
+                }
+                break;
+            }
+            default: {
+                // Non-exported top-level declarations
+                processDeclaration(item, content, classes, interfaces, exports, methods, false);
+                break;
+            }
+        }
+    }
+    const dependencies = imports.map(i => i.module);
+    return { totalLines, classes, interfaces, exports, imports, dependencies, methods };
+}
+function processDeclaration(decl, content, classes, interfaces, exports, methods, isExported) {
+    if (!decl?.type)
+        return;
+    switch (decl.type) {
+        case 'ClassDeclaration': {
+            const className = decl.identifier?.value;
+            if (className) {
+                classes.push(className);
+                if (isExported)
+                    exports.push(className);
+            }
+            // Extract class methods
+            for (const member of decl.body || []) {
+                if (member.type === 'ClassMethod') {
+                    const method = extractClassMethod(member, content, isExported);
+                    if (method) {
+                        methods[method.name] = { mechanical: method };
+                    }
+                }
+            }
+            break;
+        }
+        case 'TsInterfaceDeclaration': {
+            const ifaceName = decl.id?.value;
+            if (ifaceName) {
+                interfaces.push(ifaceName);
+                if (isExported)
+                    exports.push(ifaceName);
+            }
+            break;
+        }
+        case 'FunctionDeclaration': {
+            const funcName = decl.identifier?.value;
+            if (funcName) {
+                if (isExported)
+                    exports.push(funcName);
+                const method = extractFunction(decl, content, isExported);
+                if (method) {
+                    methods[method.name] = { mechanical: method };
+                }
+            }
+            break;
+        }
+        case 'TsTypeAliasDeclaration': {
+            const typeName = decl.id?.value;
+            if (typeName && isExported)
+                exports.push(typeName);
+            break;
+        }
+        case 'TsEnumDeclaration': {
+            const enumName = decl.id?.value;
+            if (enumName && isExported)
+                exports.push(enumName);
+            break;
+        }
+        case 'VariableDeclaration': {
+            for (const d of decl.declarations || []) {
+                const varName = d.id?.value;
+                if (varName && isExported)
+                    exports.push(varName);
+                // Arrow function variable: const foo = async (x: T) => { ... }
+                if (d.init?.type === 'ArrowFunctionExpression' && varName) {
+                    const method = extractArrowFunction(varName, d.init, content, isExported);
+                    if (method) {
+                        methods[method.name] = { mechanical: method };
+                    }
+                }
+            }
+            break;
+        }
+    }
+}
+function extractClassMethod(member, content, classIsExported) {
+    const name = member.key?.value;
+    if (!name)
+        return null;
+    const fn = member.function;
+    if (!fn)
+        return null;
+    const startLine = byteOffsetToLine(content, member.span.start);
+    const endLine = byteOffsetToLine(content, member.span.end);
+    const params = extractParams(fn.params, content);
+    const returnType = extractReturnType(fn.returnType, content);
+    const isAsync = fn.async || false;
+    const isPrivate = member.accessibility === 'private' || member.accessibility === 'protected';
+    const decorators = extractDecorators(member.decorators);
+    return {
+        name,
+        startLine,
+        endLine,
+        params,
+        returnType,
+        isAsync,
+        isExported: classIsExported && !isPrivate,
+        ...(decorators.length > 0 ? { decorators } : {}),
+    };
+}
+function extractFunction(decl, content, isExported) {
+    const name = decl.identifier?.value;
+    if (!name)
+        return null;
+    const startLine = byteOffsetToLine(content, decl.span.start);
+    const endLine = byteOffsetToLine(content, decl.span.end);
+    const params = extractParams(decl.params, content);
+    const returnType = extractReturnType(decl.returnType, content);
+    const isAsync = decl.async || false;
+    const decorators = extractDecorators(decl.decorators);
+    return {
+        name,
+        startLine,
+        endLine,
+        params,
+        returnType,
+        isAsync,
+        isExported,
+        ...(decorators.length > 0 ? { decorators } : {}),
+    };
+}
+function extractArrowFunction(name, init, content, isExported) {
+    const startLine = byteOffsetToLine(content, init.span.start);
+    const endLine = byteOffsetToLine(content, init.span.end);
+    const params = extractParams(init.params, content);
+    const returnType = extractReturnType(init.returnType, content);
+    const isAsync = init.async || false;
+    return {
+        name,
+        startLine,
+        endLine,
+        params,
+        returnType,
+        isAsync,
+        isExported,
+    };
+}
+function extractParams(params, content) {
+    if (!params)
+        return [];
+    return params.map((p) => {
+        const pat = p.pat || p;
+        const name = pat.value || pat.left?.value || '...';
+        const typeAnn = pat.typeAnnotation?.typeAnnotation;
+        if (typeAnn) {
+            const typeStr = extractTypeString(typeAnn, content);
+            return `${name}: ${typeStr}`;
+        }
+        return name;
+    });
+}
+function extractReturnType(returnType, content) {
+    if (!returnType?.typeAnnotation)
+        return 'void';
+    return extractTypeString(returnType.typeAnnotation, content);
+}
+function extractTypeString(typeNode, content) {
+    if (!typeNode)
+        return 'unknown';
+    switch (typeNode.type) {
+        case 'TsKeywordType':
+            return typeNode.kind;
+        case 'TsTypeReference': {
+            const name = typeNode.typeName?.value || 'unknown';
+            if (typeNode.typeParams?.params?.length) {
+                const params = typeNode.typeParams.params.map((p) => extractTypeString(p, content));
+                return `${name}<${params.join(', ')}>`;
+            }
+            return name;
+        }
+        case 'TsArrayType':
+            return `${extractTypeString(typeNode.elemType, content)}[]`;
+        case 'TsUnionType':
+            return typeNode.types.map((t) => extractTypeString(t, content)).join(' | ');
+        case 'TsIntersectionType':
+            return typeNode.types.map((t) => extractTypeString(t, content)).join(' & ');
+        case 'TsLiteralType':
+            return String(typeNode.literal?.value ?? 'literal');
+        case 'TsTypeLiteral':
+            return 'object';
+        case 'TsFunctionType':
+            return 'Function';
+        case 'TsTupleType':
+            return `[${(typeNode.elemTypes || []).map((t) => extractTypeString(t.ty || t, content)).join(', ')}]`;
+        case 'TsParenthesizedType':
+            return `(${extractTypeString(typeNode.typeAnnotation, content)})`;
+        default:
+            // Fallback: extract from source text
+            if (typeNode.span) {
+                return content.substring(typeNode.span.start, typeNode.span.end).trim() || 'unknown';
+            }
+            return 'unknown';
+    }
+}
+function extractDecorators(decorators) {
+    if (!decorators?.length)
+        return [];
+    return decorators.map((d) => {
+        const expr = d.expression;
+        if (expr?.type === 'Identifier')
+            return `@${expr.value}`;
+        if (expr?.type === 'CallExpression' && expr.callee?.value)
+            return `@${expr.callee.value}`;
+        return '@unknown';
+    }).filter(Boolean);
+}
+function byteOffsetToLine(content, offset) {
+    // SWC span offsets are 0-based byte offsets
+    const before = content.substring(0, offset);
+    return before.split('\n').length;
+}
+//# sourceMappingURL=ast-parser.js.map

package/dist/lib/ast-parser.js.map

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

package/dist/lib/compile-rules.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Compile rules for SSOT → agent-facing spec transformation.
+ *
+ * Rules are declarative: define source, split strategy, output location,
+ * and required fields for schema validation.
+ * No AI interpretation — deterministic structural extraction only.
+ */
+/** How to split a source document into multiple spec files */
+export type SplitStrategy = 'h2' | 'h3' | 'none';
+/** Where compiled output goes within controller skill */
+export type OutputTarget = 'references' | 'rules';
+/** A single compile rule mapping SSOT source → spec output */
+export interface CompileRule {
+    /** SSOT filename without extension (e.g., 'service-spec') */
+    source: string;
+    /** Output target directory within controller skill */
+    output: OutputTarget;
+    /** How to split the document */
+    splitBy: SplitStrategy;
+    /** Output filename pattern. Available vars: {section}, {method}, {path}, {entity} */
+    filenamePattern: string;
+    /** Required fields in each section for schema validation */
+    requiredFields: string[];
+    /** Human-readable description */
+    description: string;
+}
+/** Metadata embedded in compiled spec files */
+export interface CompileMarker {
+    /** Original SSOT file path (relative to .timsquad/) */
+    source: string;
+    /** Section anchor in source (e.g., 'POST-auth-login') */
+    section: string;
+    /** MD5 hash of source section content */
+    ssotHash: string;
+    /** ISO 8601 compilation timestamp */
+    compiledAt: string;
+}
+/** Manifest entry for stale detection */
+export interface ManifestEntry {
+    source: string;
+    ssotHash: string;
+    compiledAt: string;
+    outputFiles: string[];
+}
+/** Full compile manifest */
+export interface CompileManifest {
+    version: string;
+    compiledAt: string;
+    entries: ManifestEntry[];
+}
+/**
+ * Default compile rules for all SSOT document types.
+ * Rules match SSOT template structure (H2=domain, H3=endpoint, H4=detail).
+ */
+export declare const COMPILE_RULES: CompileRule[];
+/**
+ * Get compile rules for a given set of SSOT documents.
+ * Filters rules to only include sources that exist.
+ */
+export declare function getCompileRules(availableSsotDocs: string[]): CompileRule[];
+/**
+ * Get the default compile rule for SSOT documents not in COMPILE_RULES.
+ * Falls back to a generic no-split rule.
+ */
+export declare function getDefaultRule(source: string): CompileRule;
+//# sourceMappingURL=compile-rules.d.ts.map

package/dist/lib/compile-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-rules.d.ts","sourceRoot":"","sources":["../../src/lib/compile-rules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAEjD,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,OAAO,CAAC;AAElD,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,YAAY,CAAC;IACrB,gCAAgC;IAChC,OAAO,EAAE,aAAa,CAAC;IACvB,qFAAqF;IACrF,eAAe,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,WAAW,EAyEtC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,iBAAiB,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAQ1E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAS1D"}

package/dist/lib/compile-rules.js

@@ -0,0 +1,114 @@
+/**
+ * Compile rules for SSOT → agent-facing spec transformation.
+ *
+ * Rules are declarative: define source, split strategy, output location,
+ * and required fields for schema validation.
+ * No AI interpretation — deterministic structural extraction only.
+ */
+/**
+ * Default compile rules for all SSOT document types.
+ * Rules match SSOT template structure (H2=domain, H3=endpoint, H4=detail).
+ */
+export const COMPILE_RULES = [
+    {
+        source: 'service-spec',
+        output: 'references',
+        splitBy: 'h3',
+        filenamePattern: '{section}.spec.md',
+        requiredFields: ['Endpoint', 'Request', 'Response'],
+        description: 'API 엔드포인트별 분할 (H3 = 개별 API)',
+    },
+    {
+        source: 'data-design',
+        output: 'references',
+        splitBy: 'h2',
+        filenamePattern: '{section}.spec.md',
+        requiredFields: ['Fields'],
+        description: '엔티티별 분할 (H2 = 테이블/모델)',
+    },
+    {
+        source: 'error-codes',
+        output: 'references',
+        splitBy: 'none',
+        filenamePattern: 'error-codes.spec.md',
+        requiredFields: ['Code', 'HTTP', 'Description'],
+        description: '에러 코드 전체 (분할 없음)',
+    },
+    {
+        source: 'requirements',
+        output: 'rules',
+        splitBy: 'none',
+        filenamePattern: 'completion-criteria.md',
+        requiredFields: ['ID', 'Priority'],
+        description: '요건 목록 → 완료 기준 규칙',
+    },
+    {
+        source: 'functional-spec',
+        output: 'references',
+        splitBy: 'h2',
+        filenamePattern: '{section}.spec.md',
+        requiredFields: [],
+        description: '기능 시나리오별 분할',
+    },
+    {
+        source: 'ui-ux-spec',
+        output: 'references',
+        splitBy: 'h2',
+        filenamePattern: '{section}.spec.md',
+        requiredFields: [],
+        description: 'UI/UX 화면별 분할',
+    },
+    {
+        source: 'security-spec',
+        output: 'rules',
+        splitBy: 'none',
+        filenamePattern: 'security-constraints.md',
+        requiredFields: [],
+        description: '보안 요건 → 제약 규칙',
+    },
+    {
+        source: 'test-spec',
+        output: 'references',
+        splitBy: 'none',
+        filenamePattern: 'test-spec.spec.md',
+        requiredFields: [],
+        description: '테스트 명세 (분할 없음)',
+    },
+    {
+        source: 'data-design',
+        output: 'references',
+        splitBy: 'h2',
+        filenamePattern: '{section}.spec.md',
+        requiredFields: ['Fields'],
+        description: '데이터 모델별 분할',
+    },
+];
+/**
+ * Get compile rules for a given set of SSOT documents.
+ * Filters rules to only include sources that exist.
+ */
+export function getCompileRules(availableSsotDocs) {
+    // Deduplicate rules by source (first rule wins)
+    const seen = new Set();
+    return COMPILE_RULES.filter((rule) => {
+        if (seen.has(rule.source))
+            return false;
+        seen.add(rule.source);
+        return availableSsotDocs.includes(rule.source);
+    });
+}
+/**
+ * Get the default compile rule for SSOT documents not in COMPILE_RULES.
+ * Falls back to a generic no-split rule.
+ */
+export function getDefaultRule(source) {
+    return {
+        source,
+        output: 'references',
+        splitBy: 'none',
+        filenamePattern: `${source}.spec.md`,
+        requiredFields: [],
+        description: `${source} (기본 규칙, 분할 없음)`,
+    };
+}
+//# sourceMappingURL=compile-rules.js.map

package/dist/lib/compile-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-rules.js","sourceRoot":"","sources":["../../src/lib/compile-rules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmDH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C;QACE,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,mBAAmB;QACpC,cAAc,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;QACnD,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,mBAAmB;QACpC,cAAc,EAAE,CAAC,QAAQ,CAAC;QAC1B,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,MAAM;QACf,eAAe,EAAE,qBAAqB;QACtC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC;QAC/C,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,MAAM;QACf,eAAe,EAAE,wBAAwB;QACzC,cAAc,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;QAClC,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,mBAAmB;QACpC,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,aAAa;KAC3B;IACD;QACE,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,mBAAmB;QACpC,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,cAAc;KAC5B;IACD;QACE,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,MAAM;QACf,eAAe,EAAE,yBAAyB;QAC1C,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,eAAe;KAC7B;IACD;QACE,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,MAAM;QACf,eAAe,EAAE,mBAAmB;QACpC,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,gBAAgB;KAC9B;IACD;QACE,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,mBAAmB;QACpC,cAAc,EAAE,CAAC,QAAQ,CAAC;QAC1B,WAAW,EAAE,YAAY;KAC1B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,iBAA2B;IACzD,gDAAgD;IAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO;QACL,MAAM;QACN,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,MAAM;QACf,eAAe,EAAE,GAAG,MAAM,UAAU;QACpC,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,GAAG,MAAM,iBAAiB;KACxC,CAAC;AACJ,CAAC"}

package/dist/lib/compiler.d.ts

@@ -0,0 +1,105 @@
+/**
+ * SSOT Compiler: Transforms human-written SSOT documents into
+ * agent-facing spec files for the controller skill (Context DI).
+ *
+ * Design principles:
+ * - Deterministic extraction only (no AI interpretation)
+ * - Section markers for traceability (source, hash, timestamp)
+ * - Schema validation for completeness checking
+ * - Stale detection via compile manifest
+ */
+import { type CompileRule, type CompileManifest, type CompileMarker } from './compile-rules.js';
+/** A parsed section from an SSOT markdown document */
+export interface ParsedSection {
+    /** Heading text (e.g., "2.1 로그인") */
+    heading: string;
+    /** Heading level (2 = H2, 3 = H3) */
+    level: number;
+    /** Full content including heading and body */
+    content: string;
+    /** Slugified anchor (e.g., "POST-auth-login") */
+    anchor: string;
+    /** Parent section heading (for H3 under H2) */
+    parent?: string;
+}
+/** Validation result for a compiled spec */
+export interface ValidationResult {
+    source: string;
+    totalSections: number;
+    validSections: number;
+    missingFields: Array<{
+        section: string;
+        fields: string[];
+    }>;
+    score: number;
+}
+/** Overall compile result */
+export interface CompileResult {
+    success: boolean;
+    compiled: Array<{
+        source: string;
+        outputFiles: string[];
+    }>;
+    validations: ValidationResult[];
+    skipped: string[];
+    errors: string[];
+}
+/**
+ * Parse a markdown document into sections by heading level.
+ */
+export declare function parseMarkdownSections(content: string, splitBy: 'h2' | 'h3'): ParsedSection[];
+/**
+ * Slugify a heading into a URL-safe anchor.
+ * "2.1 로그인" → "2-1-로그인"
+ * "POST /auth/login" → "POST-auth-login"
+ */
+export declare function slugify(text: string): string;
+/**
+ * Check if a section contains the required fields.
+ * Looks for field names in table headers or bold text.
+ */
+export declare function validateSectionFields(content: string, requiredFields: string[]): string[];
+/** Generate section markers as HTML comments */
+export declare function generateMarkers(marker: CompileMarker): string;
+/** Compute MD5 hash of content */
+export declare function computeHash(content: string): string;
+/**
+ * Compile a single SSOT document according to its rule.
+ * Returns list of output file paths (relative to controller skill dir).
+ */
+export declare function compileSsotDocument(ssotPath: string, rule: CompileRule, controllerDir: string, sourceName: string): Promise<{
+    outputFiles: string[];
+    validation: ValidationResult;
+}>;
+/**
+ * Compile all SSOT documents in a project.
+ *
+ * @param projectRoot Project root directory
+ * @param controllerDir Path to controller skill dir (.claude/skills/controller)
+ * @returns CompileResult with all outputs and validation
+ */
+export declare function compileAll(projectRoot: string, controllerDir: string): Promise<CompileResult>;
+/**
+ * Load existing manifest. Returns null if not found.
+ */
+export declare function loadManifest(controllerDir: string): Promise<CompileManifest | null>;
+/**
+ * Check which SSOT documents are stale (changed since last compile).
+ */
+export declare function checkStale(projectRoot: string, controllerDir: string): Promise<Array<{
+    source: string;
+    reason: string;
+}>>;
+/**
+ * Parse agent prerequisites from agent markdown files.
+ * Extracts from <prerequisites> XML tag.
+ */
+export declare function parseAgentPrerequisites(content: string): string[];
+/**
+ * Validate that all agent prerequisites can be resolved from compiled specs.
+ */
+export declare function validateDependencyGraph(projectRoot: string, controllerDir: string): Promise<Array<{
+    agent: string;
+    missing: string[];
+}>>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/lib/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/lib/compiler.ts"],"names":[],"mappings":"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"}