qfai 1.9.0 → 1.9.2

package/dist/index.d.cts

@@ -37,7 +37,7 @@ type ValidationCounts = {
     warning: number;
     error: number;
 };
-type ValidationProfile = "discussion" | "sdd" | "prototyping" | "atdd" | "tdd" | "verify" | "full";
+type ValidationProfile = "discussion" | "sdd" | "prototyping" | "atdd" | "tdd" | "verify" | "full" | "saas-package";
 type ValidationTraceability = {
     sc: ScCoverage;
     testFiles: TestFileScan;
@@ -165,10 +165,16 @@ type QfaiPrototypingCalibrationConfig = {
 type QfaiPrototypingExecutionConfig = {
     targetUrl?: string | null;
     /**
-     * Browser tool handed to the AI evaluator sub-agent. The only accepted
-     * value is `"playwright-cli"`.
+     * Browser tool handed to the AI evaluator sub-agent.
+     *
+     * Accepted values during the deprecation window:
+     *   - `"playwright"` (primary, post-1.9.x default).
+     *   - `"playwright-cli"` (deprecated; sunset 1.10.0). When chosen,
+     *     the doctor probe emits `D-DEPRECATED-PROBE` (severity warning).
+     *
+     * At sunset only `"playwright"` is accepted.
      */
-    browserTool: "playwright-cli";
+    browserTool: "playwright" | "playwright-cli";
 };
 type QfaiPrototypingConfig = {
     calibration?: QfaiPrototypingCalibrationConfig;
@@ -180,6 +186,37 @@ type QfaiPrototypingConfig = {
      * e.g. `"0001"`.
      */
     primarySpecId?: string;
+    /**
+     * CHG-006 second-wave loop posture discriminator.
+     *
+     *   - `convergence` (default): every prototyping gate applies at the
+     *     declared severity (today's behavior).
+     *   - `exploration`: medium gate relaxation — soft-rubric gates
+     *     (axes-exceptional, design-compliance drift) downgrade error →
+     *     warning. Schema / path / license (exit 66) gates stay hard
+     *     error.
+     *
+     * Overridden per-run by `qfai prototyping iterate --mode <value>`.
+     * Optional; absence defaults to `convergence`.
+     */
+    mode?: "convergence" | "exploration";
+};
+type QfaiReviewConfig = {
+    /**
+     * Stale review-pack TTL (calendar days) used by `qfai doctor --clean`
+     * to decide whether to move `.qfai/review/<ts>/` packs into
+     * `.qfai/review/_archive/<ts>/`. Default (when unset) is applied at
+     * the call-site by `REVIEW_STALE_TTL_DAYS_DEFAULT`.
+     */
+    staleTtlDays?: number;
+};
+type QfaiAtddConfig = {
+    /**
+     * Number of consecutive un-skip + re-skip cycles tolerated before the
+     * scaffold-cycle escalation fires. Default (when unset) is applied at
+     * the call-site. Pre-positioned for the spec-0008 ATDD scaffold slice.
+     */
+    scaffoldEscalateCycles?: number;
 };
 type QfaiConfig = {
     paths: QfaiPaths;
@@ -187,6 +224,8 @@ type QfaiConfig = {
     output: QfaiOutputConfig;
     uiux?: QfaiUiuxConfig;
     prototyping?: QfaiPrototypingConfig;
+    review?: QfaiReviewConfig;
+    atdd?: QfaiAtddConfig;
     baseBranch?: string;
 };
 type ConfigPathKey = keyof QfaiPaths;
@@ -894,4 +933,4 @@ declare function parseDesignMd(text: string): ParseResult;
 declare function validateDesignMd(d: DesignMd): ValidationIssue[];
 declare function hashDesignMd(text: string): string;
 
-export { ARCHETYPES, type Archetype, type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DecisionGuardrail, type DecisionGuardrailEntry, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, FONT_KEYS, type FailOn, type FontKey, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OrphanContractsPolicy, type OutputFormat, PROTOTYPING_SUPPORTED_SURFACES, type ParseError, type ParseResult, type PrototypingBrowserTool, type PrototypingSurface, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRoundLifecycle, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, SHADOW_KEYS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TraceabilitySeverity, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, checkDecisionGuardrails, createReportData, defaultConfig, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, hashDesignMd, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isSupportedPrototypingSurface, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, parseDesignMd, requiresVisualBrowserEvidence, resolvePath, resolveToolVersion, runBrowserQaOrchestrated, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateDesignMd, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };
+export { ARCHETYPES, type Archetype, type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DecisionGuardrail, type DecisionGuardrailEntry, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, FONT_KEYS, type FailOn, type FontKey, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OrphanContractsPolicy, type OutputFormat, PROTOTYPING_SUPPORTED_SURFACES, type ParseError, type ParseResult, type PrototypingBrowserTool, type PrototypingSurface, type QfaiAtddConfig, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiReviewConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRoundLifecycle, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, SHADOW_KEYS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TraceabilitySeverity, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, checkDecisionGuardrails, createReportData, defaultConfig, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, hashDesignMd, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isSupportedPrototypingSurface, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, parseDesignMd, requiresVisualBrowserEvidence, resolvePath, resolveToolVersion, runBrowserQaOrchestrated, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateDesignMd, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };

package/dist/index.d.ts

@@ -37,7 +37,7 @@ type ValidationCounts = {
     warning: number;
     error: number;
 };
-type ValidationProfile = "discussion" | "sdd" | "prototyping" | "atdd" | "tdd" | "verify" | "full";
+type ValidationProfile = "discussion" | "sdd" | "prototyping" | "atdd" | "tdd" | "verify" | "full" | "saas-package";
 type ValidationTraceability = {
     sc: ScCoverage;
     testFiles: TestFileScan;
@@ -165,10 +165,16 @@ type QfaiPrototypingCalibrationConfig = {
 type QfaiPrototypingExecutionConfig = {
     targetUrl?: string | null;
     /**
-     * Browser tool handed to the AI evaluator sub-agent. The only accepted
-     * value is `"playwright-cli"`.
+     * Browser tool handed to the AI evaluator sub-agent.
+     *
+     * Accepted values during the deprecation window:
+     *   - `"playwright"` (primary, post-1.9.x default).
+     *   - `"playwright-cli"` (deprecated; sunset 1.10.0). When chosen,
+     *     the doctor probe emits `D-DEPRECATED-PROBE` (severity warning).
+     *
+     * At sunset only `"playwright"` is accepted.
      */
-    browserTool: "playwright-cli";
+    browserTool: "playwright" | "playwright-cli";
 };
 type QfaiPrototypingConfig = {
     calibration?: QfaiPrototypingCalibrationConfig;
@@ -180,6 +186,37 @@ type QfaiPrototypingConfig = {
      * e.g. `"0001"`.
      */
     primarySpecId?: string;
+    /**
+     * CHG-006 second-wave loop posture discriminator.
+     *
+     *   - `convergence` (default): every prototyping gate applies at the
+     *     declared severity (today's behavior).
+     *   - `exploration`: medium gate relaxation — soft-rubric gates
+     *     (axes-exceptional, design-compliance drift) downgrade error →
+     *     warning. Schema / path / license (exit 66) gates stay hard
+     *     error.
+     *
+     * Overridden per-run by `qfai prototyping iterate --mode <value>`.
+     * Optional; absence defaults to `convergence`.
+     */
+    mode?: "convergence" | "exploration";
+};
+type QfaiReviewConfig = {
+    /**
+     * Stale review-pack TTL (calendar days) used by `qfai doctor --clean`
+     * to decide whether to move `.qfai/review/<ts>/` packs into
+     * `.qfai/review/_archive/<ts>/`. Default (when unset) is applied at
+     * the call-site by `REVIEW_STALE_TTL_DAYS_DEFAULT`.
+     */
+    staleTtlDays?: number;
+};
+type QfaiAtddConfig = {
+    /**
+     * Number of consecutive un-skip + re-skip cycles tolerated before the
+     * scaffold-cycle escalation fires. Default (when unset) is applied at
+     * the call-site. Pre-positioned for the spec-0008 ATDD scaffold slice.
+     */
+    scaffoldEscalateCycles?: number;
 };
 type QfaiConfig = {
     paths: QfaiPaths;
@@ -187,6 +224,8 @@ type QfaiConfig = {
     output: QfaiOutputConfig;
     uiux?: QfaiUiuxConfig;
     prototyping?: QfaiPrototypingConfig;
+    review?: QfaiReviewConfig;
+    atdd?: QfaiAtddConfig;
     baseBranch?: string;
 };
 type ConfigPathKey = keyof QfaiPaths;
@@ -894,4 +933,4 @@ declare function parseDesignMd(text: string): ParseResult;
 declare function validateDesignMd(d: DesignMd): ValidationIssue[];
 declare function hashDesignMd(text: string): string;
 
-export { ARCHETYPES, type Archetype, type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DecisionGuardrail, type DecisionGuardrailEntry, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, FONT_KEYS, type FailOn, type FontKey, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OrphanContractsPolicy, type OutputFormat, PROTOTYPING_SUPPORTED_SURFACES, type ParseError, type ParseResult, type PrototypingBrowserTool, type PrototypingSurface, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRoundLifecycle, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, SHADOW_KEYS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TraceabilitySeverity, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, checkDecisionGuardrails, createReportData, defaultConfig, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, hashDesignMd, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isSupportedPrototypingSurface, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, parseDesignMd, requiresVisualBrowserEvidence, resolvePath, resolveToolVersion, runBrowserQaOrchestrated, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateDesignMd, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };
+export { ARCHETYPES, type Archetype, type AtddCodeTraceabilityResult, type AtddForbiddenRef, type AtddSpecRefs, type AtddTestKind, type AtddTraceabilityMissing, type AtddTraceabilityScan, type AtddUnknownRef, type AtddUnknownRefKind, BROWSER_QA_PHASES, COLOR_KEYS, type ColorKey, type ConfigLoadResult, type ConfigPathKey, type ConfigSearchResult, DISCUSSION_NON_UI_SURFACES, DISCUSSION_UI_BEARING_SURFACES, type DecisionGuardrail, type DecisionGuardrailEntry, type DesignMd, type DesignMdColors, type DesignMdFonts, type DesignMdRadius, type DesignMdShadow, FONT_KEYS, type FailOn, type FontKey, type GuardrailCheckResult, type GuardrailIssue, type GuardrailIssueSeverity, type GuardrailLoadError, type GuardrailLoadResult, type GuardrailType, ID_PREFIXES, type IdFormatPrefix, type IdPrefix, type Issue, type IssueCategory, type IssueLocation, type IssueSeverity, type OrphanContractsPolicy, type OutputFormat, PROTOTYPING_SUPPORTED_SURFACES, type ParseError, type ParseResult, type PrototypingBrowserTool, type PrototypingSurface, type QfaiAtddConfig, type QfaiConfig, type QfaiOutputConfig, type QfaiPaths, type QfaiPrototypingCalibrationConfig, type QfaiPrototypingConfig, type QfaiPrototypingExecutionConfig, type QfaiReviewConfig, type QfaiUiuxAuditConfig, type QfaiUiuxConfig, type QfaiValidationConfig, RADIUS_KEYS, type RadiusKey, type ReportChangeType, type ReportChangeTypeSummary, type ReportChangeTypeWarning, type ReportContractCoverage, type ReportData, type ReportDeltaCoverage, type ReportFullHarnessExecution, type ReportGuardrailItem, type ReportGuardrails, type ReportIds, type ReportPrototypingSummary, type ReportRoundLifecycle, type ReportRuleFinding, type ReportSpecContractRefs, type ReportSpecCoverage, type ReportSummary, type ReportSurfaceClassification, type ReportTddCoverage, type ReportTddCoverageSpec, type ReportTestStrategy, type ReportTraceability, type ReportWaivers, type RunSddPreflightOptions, SHADOW_KEYS, type SddPreflightResult, type SddPreflightSource, type SddPreflightStatus, type ShadowKey, type TraceabilitySeverity, VISUAL_BROWSER_SURFACES, type ValidationCounts, type ValidationIssue, type ValidationOptions, type ValidationProfile, type ValidationResult, type ValidationTraceability, type ValidationWaiverAction, type ValidationWaiverDowngradeTo, type ValidationWaiverEntry, type ValidationWaiverMatch, type ValidationWaiverScope, type ValidationWaiverSeverity, type ValidationWaiverSuppressed, type ValidationWaivers, checkDecisionGuardrails, createReportData, defaultConfig, evaluateAtddCodeTraceability, extractAcSpecNumber, extractAllIds, extractBrSpecNumber, extractCapSpecNumber, extractCaseSpecNumber, extractDecisionGuardrailsFromMarkdown, extractIds, extractInvalidIds, extractScSpecNumber, extractSpecNumber, extractUsSpecNumber, filterDecisionGuardrailsByKeyword, findConfigRoot, formatGuardrailsForLlm, formatReportJson, formatReportMarkdown, getConfigPath, hashDesignMd, isDiscussionUiBearingSurfaceType, isNonUiDiscussionSurface, isSupportedPrototypingSurface, isValidPrototypingSurface, lintSql, loadConfig, loadDecisionGuardrails, normalizeDecisionGuardrails, parseDesignMd, requiresVisualBrowserEvidence, resolvePath, resolveToolVersion, runBrowserQaOrchestrated, runRenderCapture, runSddPreflight, sortDecisionGuardrails, summarizeBrowserQaResult, validateAtddCodeTraceability, validateContracts, validateDefinedIds, validateDesignMd, validateLayeredTraceability, validateOrphanProhibition, validateProject, validateSpecSplitByCapability, validateTraceability };