specweave 0.32.0 → 0.32.3

package/dist/src/types/model-selection.d.ts

@@ -6,13 +6,15 @@
  * - Phase detection (planning vs execution vs review)
  * - User overrides (manual model selection)
  *
- * Achieves 60-70% cost savings by using Haiku for execution, Sonnet for planning.
+ * Strategy (Opus 4.5 Default):
+ * - Haiku: Simple/cheap operations, translations, mechanical tasks
+ * - Opus: Default for complex work, analysis, architecture, planning
  */
 /**
  * Available AI models
- * - sonnet: Latest Sonnet 4.5 (planning, complex analysis)
- * - haiku: Latest Haiku 4.5 (execution, simple tasks)
- * - opus: Latest Opus (rare, critical decisions)
+ * - opus: Latest Opus 4.5 (default - planning, analysis, complex work)
+ * - haiku: Latest Haiku 4.5 (simple tasks, translations, cheap ops)
+ * - sonnet: Sonnet 4 (legacy, rarely used)
  * - auto: System decides based on context
  */
 export type Model = 'sonnet' | 'haiku' | 'opus' | 'auto';

package/dist/src/types/model-selection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../../src/types/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,eAAe,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,wBAAwB,GAAG,aAAa,GAAG,UAAU,CAAC;IACzH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD"}
+{"version":3,"file":"model-selection.d.ts","sourceRoot":"","sources":["../../../src/types/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,eAAe,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,wBAAwB,GAAG,aAAa,GAAG,UAAU,CAAC;IACzH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD"}

package/dist/src/types/model-selection.js

@@ -6,7 +6,9 @@
  * - Phase detection (planning vs execution vs review)
  * - User overrides (manual model selection)
  *
- * Achieves 60-70% cost savings by using Haiku for execution, Sonnet for planning.
+ * Strategy (Opus 4.5 Default):
+ * - Haiku: Simple/cheap operations, translations, mechanical tasks
+ * - Opus: Default for complex work, analysis, architecture, planning
  */
 export {};
 //# sourceMappingURL=model-selection.js.map

package/dist/src/types/model-selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../../../src/types/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}
+{"version":3,"file":"model-selection.js","sourceRoot":"","sources":["../../../src/types/model-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/src/utils/docs-validator.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Documentation Pre-Render Validator
+ *
+ * Validates markdown/MDX files BEFORE Docusaurus server starts.
+ * Catches issues proactively so users don't see cryptic webpack errors.
+ *
+ * Validates:
+ * 1. YAML frontmatter syntax
+ * 2. MDX/JSX compatibility (unquoted attrs, self-closing tags)
+ * 3. Broken internal links
+ * 4. Duplicate files/routes
+ * 5. Invalid file names
+ *
+ * @module utils/docs-validator
+ */
+import { Logger } from './logger.js';
+/**
+ * Issue severity levels
+ */
+export type IssueSeverity = 'error' | 'warning' | 'info';
+/**
+ * Single validation issue
+ */
+export interface ValidationIssue {
+    file: string;
+    line?: number;
+    severity: IssueSeverity;
+    type: string;
+    message: string;
+    autoFixable: boolean;
+    fix?: () => void;
+}
+/**
+ * Validation result summary
+ */
+export interface ValidationResult {
+    valid: boolean;
+    totalFiles: number;
+    errors: number;
+    warnings: number;
+    infos: number;
+    issues: ValidationIssue[];
+    fixedCount: number;
+}
+/**
+ * Validator options
+ */
+export interface DocsValidatorOptions {
+    docsPath: string;
+    autoFix?: boolean;
+    logger?: Logger;
+    /** File extensions to validate */
+    extensions?: string[];
+    /** Paths to ignore (relative to docsPath) */
+    ignorePaths?: string[];
+}
+/**
+ * Documentation Pre-Render Validator
+ *
+ * Use before starting Docusaurus to catch issues early.
+ *
+ * @example
+ * ```typescript
+ * const validator = new DocsValidator({
+ *   docsPath: '.specweave/docs/internal',
+ *   autoFix: true
+ * });
+ * const result = await validator.validate();
+ * if (!result.valid) {
+ *   console.log('Fix issues before starting docs server');
+ * }
+ * ```
+ */
+export declare class DocsValidator {
+    private docsPath;
+    private autoFix;
+    private logger;
+    private extensions;
+    private ignorePaths;
+    private issues;
+    private fixedCount;
+    constructor(options: DocsValidatorOptions);
+    /**
+     * Run all validations
+     */
+    validate(): Promise<ValidationResult>;
+    /**
+     * Collect all markdown files recursively
+     */
+    private collectFiles;
+    /**
+     * Validate a single file
+     */
+    private validateFile;
+    /**
+     * Validate YAML frontmatter syntax
+     */
+    private validateFrontmatter;
+    /**
+     * Validate MDX/JSX compatibility
+     */
+    private validateMdxContent;
+    /**
+     * Check for duplicate routes (same normalized path)
+     */
+    private checkDuplicateRoutes;
+    /**
+     * Validate file naming conventions
+     */
+    private validateFileName;
+    /**
+     * Validate internal links between documents
+     */
+    private validateInternalLinks;
+    /**
+     * Build the validation result
+     */
+    private buildResult;
+    /**
+     * Format validation result for display
+     */
+    static formatResult(result: ValidationResult): string;
+}
+/**
+ * Quick validation function for scripts
+ */
+export declare function validateDocs(docsPath: string, options?: {
+    autoFix?: boolean;
+    logger?: Logger;
+}): Promise<ValidationResult>;
+//# sourceMappingURL=docs-validator.d.ts.map

package/dist/src/utils/docs-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-validator.d.ts","sourceRoot":"","sources":["../../../src/utils/docs-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAGpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,EAAE,oBAAoB;IAQzC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAkC3C;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;YACW,YAAY;IAiC1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwE3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2D1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqCxB;;OAEG;YACW,qBAAqB;IAmGnC;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;CA6GtD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,gBAAgB,CAAC,CAO3B"}