@libar-dev/architect 1.0.0-pre.3

package/dist/api/process-state.js

@@ -0,0 +1,308 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern ProcessStateAPI
+ * @architect-status active
+ * @architect-implements PhaseStateMachineValidation
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ * @architect-uses MasterDataset, FSMValidator
+ *
+ * ## Process State API - Programmatic Query Interface
+ *
+ * TypeScript interface for querying project state.
+ * Designed for Claude Code integration and programmatic access.
+ *
+ * ### When to Use
+ *
+ * - When querying patterns by status, phase, or relationships
+ * - When validating FSM transitions before making changes
+ * - When building dashboards or reports on delivery progress
+ * - When Claude Code needs real-time delivery state (prefer over reading Markdown)
+ *
+ * ### Key Features
+ *
+ * - **Status Queries**: Get patterns by status, counts, distributions
+ * - **Phase Queries**: Get phase progress, active phases, patterns
+ * - **FSM Queries**: Validate transitions, check protection levels
+ * - **Pattern Queries**: Find patterns, get dependencies, deliverables
+ * - **Timeline Queries**: Group by quarter, get current work, roadmap
+ *
+ * ### Usage
+ *
+ * ```typescript
+ * import { createProcessStateAPI } from "@libar-dev/architect";
+ *
+ * const api = createProcessStateAPI(masterDataset);
+ *
+ * // Get current work
+ * const active = api.getCurrentWork();
+ *
+ * // Check transition
+ * if (api.isValidTransition("roadmap", "active")) {
+ *   console.log("Can start work");
+ * }
+ * ```
+ */
+import { isPatternComplete, isPatternActive, isPatternPlanned, } from '../taxonomy/normalized-status.js';
+import { validateTransition, getProtectionSummary, isValidTransition, getValidTransitionsFrom, } from '../validation/fsm/index.js';
+import { findPatternByName } from './pattern-helpers.js';
+// =============================================================================
+// Process State API Implementation
+// =============================================================================
+/**
+ * Create a ProcessStateAPI instance from a MasterDataset
+ *
+ * @param dataset - The MasterDataset to wrap
+ * @returns ProcessStateAPI instance
+ */
+export function createProcessStateAPI(dataset) {
+    // Helper to find patterns by exact FSM status
+    function filterByExactStatus(status) {
+        return dataset.patterns.filter((p) => p.status === status);
+    }
+    // Helper to convert MasterPhaseGroup to PhaseGroup
+    function convertPhaseGroup(mpg) {
+        return {
+            phaseNumber: mpg.phaseNumber,
+            phaseName: mpg.phaseName,
+            patterns: mpg.patterns,
+            counts: mpg.counts,
+        };
+    }
+    // Build relationship index if not present
+    const relationshipIndex = dataset.relationshipIndex ?? {};
+    return {
+        // ─────────────────────────────────────────────────────────────────────
+        // Status Queries
+        // ─────────────────────────────────────────────────────────────────────
+        getPatternsByNormalizedStatus(status) {
+            return dataset.byStatus[status];
+        },
+        getPatternsByStatus(status) {
+            return filterByExactStatus(status);
+        },
+        getStatusCounts() {
+            return { ...dataset.counts };
+        },
+        getStatusDistribution() {
+            const total = dataset.counts.total === 0 ? 1 : dataset.counts.total;
+            return {
+                counts: { ...dataset.counts },
+                percentages: {
+                    completed: Math.round((dataset.counts.completed / total) * 100),
+                    active: Math.round((dataset.counts.active / total) * 100),
+                    planned: Math.round((dataset.counts.planned / total) * 100),
+                },
+            };
+        },
+        getCompletionPercentage() {
+            const total = dataset.counts.total === 0 ? 1 : dataset.counts.total;
+            return Math.round((dataset.counts.completed / total) * 100);
+        },
+        // ─────────────────────────────────────────────────────────────────────
+        // Phase Queries
+        // ─────────────────────────────────────────────────────────────────────
+        getPatternsByPhase(phase) {
+            const phaseGroup = dataset.byPhase.find((p) => p.phaseNumber === phase);
+            return phaseGroup?.patterns ?? [];
+        },
+        getPhaseProgress(phase) {
+            const phaseGroup = dataset.byPhase.find((p) => p.phaseNumber === phase);
+            if (!phaseGroup)
+                return undefined;
+            const total = phaseGroup.counts.total === 0 ? 1 : phaseGroup.counts.total;
+            return {
+                phaseNumber: phaseGroup.phaseNumber,
+                phaseName: phaseGroup.phaseName,
+                completed: phaseGroup.counts.completed,
+                active: phaseGroup.counts.active,
+                planned: phaseGroup.counts.planned,
+                total: phaseGroup.counts.total,
+                completionPercentage: Math.round((phaseGroup.counts.completed / total) * 100),
+            };
+        },
+        getActivePhases() {
+            return dataset.byPhase.filter((p) => p.counts.active > 0).map(convertPhaseGroup);
+        },
+        getAllPhases() {
+            return dataset.byPhase.map(convertPhaseGroup);
+        },
+        // ─────────────────────────────────────────────────────────────────────
+        // FSM Queries
+        // ─────────────────────────────────────────────────────────────────────
+        isValidTransition(from, to) {
+            return isValidTransition(from, to);
+        },
+        checkTransition(from, to) {
+            const result = validateTransition(from, to);
+            return {
+                from: result.from,
+                to: result.to,
+                valid: result.valid,
+                error: result.error,
+                validAlternatives: result.validAlternatives,
+            };
+        },
+        getValidTransitionsFrom(status) {
+            return getValidTransitionsFrom(status);
+        },
+        getProtectionInfo(status) {
+            const summary = getProtectionSummary(status);
+            return {
+                status,
+                level: summary.level,
+                description: summary.description,
+                canAddDeliverables: summary.canAddDeliverables,
+                requiresUnlock: summary.requiresUnlock,
+            };
+        },
+        // ─────────────────────────────────────────────────────────────────────
+        // Pattern Queries
+        // ─────────────────────────────────────────────────────────────────────
+        getPattern(name) {
+            return findPatternByName(dataset.patterns, name);
+        },
+        getPatternDependencies(name) {
+            const entry = relationshipIndex[name];
+            if (!entry) {
+                // Try to find by scanning patterns
+                const pattern = this.getPattern(name);
+                if (!pattern)
+                    return undefined;
+                return {
+                    dependsOn: pattern.dependsOn ?? [],
+                    enables: pattern.enables ?? [],
+                    uses: pattern.uses ?? [],
+                    usedBy: pattern.usedBy ?? [],
+                };
+            }
+            return {
+                dependsOn: entry.dependsOn,
+                enables: entry.enables,
+                uses: entry.uses,
+                usedBy: entry.usedBy,
+            };
+        },
+        getPatternRelationships(name) {
+            const entry = relationshipIndex[name];
+            if (!entry) {
+                // Try to find by scanning patterns
+                const pattern = this.getPattern(name);
+                if (!pattern)
+                    return undefined;
+                return {
+                    dependsOn: pattern.dependsOn ?? [],
+                    enables: pattern.enables ?? [],
+                    uses: pattern.uses ?? [],
+                    usedBy: pattern.usedBy ?? [],
+                    implementsPatterns: pattern.implementsPatterns ?? [],
+                    implementedBy: [],
+                    extendsPattern: pattern.extendsPattern,
+                    extendedBy: [],
+                    seeAlso: pattern.seeAlso ?? [],
+                    apiRef: pattern.apiRef ?? [],
+                };
+            }
+            return {
+                dependsOn: entry.dependsOn,
+                enables: entry.enables,
+                uses: entry.uses,
+                usedBy: entry.usedBy,
+                implementsPatterns: entry.implementsPatterns,
+                implementedBy: entry.implementedBy,
+                extendsPattern: entry.extendsPattern,
+                extendedBy: entry.extendedBy,
+                seeAlso: entry.seeAlso,
+                apiRef: entry.apiRef,
+            };
+        },
+        getRelatedPatterns(name) {
+            const entry = relationshipIndex[name];
+            if (!entry) {
+                const pattern = this.getPattern(name);
+                return pattern?.seeAlso ?? [];
+            }
+            return entry.seeAlso;
+        },
+        getApiReferences(name) {
+            const entry = relationshipIndex[name];
+            if (!entry) {
+                const pattern = this.getPattern(name);
+                return pattern?.apiRef ?? [];
+            }
+            return entry.apiRef;
+        },
+        getPatternDeliverables(name) {
+            const pattern = this.getPattern(name);
+            if (!pattern?.deliverables)
+                return [];
+            return pattern.deliverables.map((d) => ({
+                name: d.name,
+                status: d.status,
+                tests: d.tests,
+                location: d.location,
+                finding: d.finding,
+                release: d.release,
+            }));
+        },
+        getPatternsByCategory(category) {
+            return dataset.byCategory[category] ?? [];
+        },
+        getCategories() {
+            return Object.entries(dataset.byCategory)
+                .map(([category, patterns]) => ({
+                category,
+                count: patterns.length,
+            }))
+                .sort((a, b) => b.count - a.count);
+        },
+        // ─────────────────────────────────────────────────────────────────────
+        // Timeline Queries
+        // ─────────────────────────────────────────────────────────────────────
+        getPatternsByQuarter(quarter) {
+            return dataset.byQuarter[quarter] ?? [];
+        },
+        getQuarters() {
+            return Object.entries(dataset.byQuarter)
+                .map(([quarter, patterns]) => {
+                const counts = {
+                    completed: patterns.filter((p) => isPatternComplete(p.status)).length,
+                    active: patterns.filter((p) => isPatternActive(p.status)).length,
+                    planned: patterns.filter((p) => isPatternPlanned(p.status)).length,
+                    total: patterns.length,
+                };
+                return { quarter, patterns, counts };
+            })
+                .sort((a, b) => a.quarter.localeCompare(b.quarter));
+        },
+        getCurrentWork() {
+            return filterByExactStatus('active');
+        },
+        getRoadmapItems() {
+            const roadmap = filterByExactStatus('roadmap');
+            const deferred = filterByExactStatus('deferred');
+            return [...roadmap, ...deferred];
+        },
+        getRecentlyCompleted(limit = 10) {
+            const completed = filterByExactStatus('completed');
+            // Sort by completion date if available
+            return completed
+                .filter((p) => p.completed)
+                .sort((a, b) => {
+                const dateA = a.completed ?? '';
+                const dateB = b.completed ?? '';
+                return dateB.localeCompare(dateA); // Descending
+            })
+                .slice(0, limit);
+        },
+        // ─────────────────────────────────────────────────────────────────────
+        // Raw Access
+        // ─────────────────────────────────────────────────────────────────────
+        getMasterDataset() {
+            return dataset;
+        },
+    };
+}
+//# sourceMappingURL=process-state.js.map

package/dist/api/process-state.js.map

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

package/dist/api/rules-query.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern RulesQueryModule
+ * @architect-status completed
+ * @architect-implements ProcessAPILayeredExtraction
+ * @architect-product-area DataAPI
+ * @architect-uses BusinessRulesCodec, CodecHelpers
+ *
+ * ## RulesQueryModule - Business Rules Domain Query
+ *
+ * Pure query function for business rules extracted from Gherkin Rule: blocks.
+ * Groups rules by product area, phase, and feature pattern.
+ *
+ * Target: src/api/rules-query.ts
+ * See: DD-4 (ProcessAPILayeredExtraction)
+ *
+ * **When to Use:** When querying business rules and invariants from Gherkin specs via the `rules` CLI subcommand.
+ */
+import type { RuntimeMasterDataset } from '../generators/pipeline/index.js';
+export interface RulesFilters {
+    productArea: string | null;
+    patternName: string | null;
+    onlyInvariants: boolean;
+}
+export interface RuleOutput {
+    readonly name: string;
+    readonly invariant: string | undefined;
+    readonly rationale: string | undefined;
+    readonly verifiedBy: readonly string[];
+    readonly scenarioCount: number;
+}
+export interface RulesQueryResult {
+    readonly productAreas: ReadonlyArray<{
+        readonly productArea: string;
+        readonly ruleCount: number;
+        readonly invariantCount: number;
+        readonly phases: ReadonlyArray<{
+            readonly phase: string;
+            readonly features: ReadonlyArray<{
+                readonly pattern: string;
+                readonly source: string;
+                readonly rules: readonly RuleOutput[];
+            }>;
+        }>;
+    }>;
+    readonly totalRules: number;
+    readonly totalInvariants: number;
+    readonly allRuleNames: readonly string[];
+    readonly hint?: string;
+}
+/**
+ * Query business rules from the MasterDataset, grouped by product area,
+ * phase, and feature pattern.
+ *
+ * DD-4: Pure function taking RuntimeMasterDataset and RulesFilters.
+ * All Map/Set construction lives here, not in the CLI handler.
+ */
+export declare function queryBusinessRules(dataset: RuntimeMasterDataset, filters: RulesFilters): RulesQueryResult;
+//# sourceMappingURL=rules-query.d.ts.map

package/dist/api/rules-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-query.d.ts","sourceRoot":"","sources":["../../src/api/rules-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAM5E,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;QACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;YAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;gBAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;aACvC,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,YAAY,GACpB,gBAAgB,CAoKlB"}

package/dist/api/rules-query.js

@@ -0,0 +1,154 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern RulesQueryModule
+ * @architect-status completed
+ * @architect-implements ProcessAPILayeredExtraction
+ * @architect-product-area DataAPI
+ * @architect-uses BusinessRulesCodec, CodecHelpers
+ *
+ * ## RulesQueryModule - Business Rules Domain Query
+ *
+ * Pure query function for business rules extracted from Gherkin Rule: blocks.
+ * Groups rules by product area, phase, and feature pattern.
+ *
+ * Target: src/api/rules-query.ts
+ * See: DD-4 (ProcessAPILayeredExtraction)
+ *
+ * **When to Use:** When querying business rules and invariants from Gherkin specs via the `rules` CLI subcommand.
+ */
+import { parseBusinessRuleAnnotations } from '../renderable/codecs/helpers.js';
+import { deduplicateScenarioNames } from '../renderable/codecs/business-rules.js';
+import { QueryApiError } from './types.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Query Function
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Query business rules from the MasterDataset, grouped by product area,
+ * phase, and feature pattern.
+ *
+ * DD-4: Pure function taking RuntimeMasterDataset and RulesFilters.
+ * All Map/Set construction lives here, not in the CLI handler.
+ */
+export function queryBusinessRules(dataset, filters) {
+    // Collect patterns with rules, applying filters
+    let patternsWithRules = dataset.patterns.filter((p) => p.rules !== undefined && p.rules.length > 0);
+    if (filters.productArea !== null) {
+        const area = filters.productArea.toLowerCase();
+        patternsWithRules = patternsWithRules.filter((p) => p.productArea?.toLowerCase() === area);
+    }
+    if (filters.patternName !== null) {
+        const name = filters.patternName.toLowerCase();
+        patternsWithRules = patternsWithRules.filter((p) => p.name.toLowerCase() === name);
+    }
+    // Build structured output grouped by product area → phase → feature
+    const areaMap = new Map();
+    let totalRules = 0;
+    let totalInvariants = 0;
+    const allRuleNames = [];
+    for (const pattern of patternsWithRules) {
+        const area = pattern.productArea ?? 'Platform';
+        const phase = pattern.phase !== undefined
+            ? `Phase ${String(pattern.phase)}`
+            : (pattern.release ?? 'Uncategorized');
+        if (!areaMap.has(area)) {
+            areaMap.set(area, { features: new Map() });
+        }
+        const areaGroup = areaMap.get(area);
+        if (areaGroup === undefined) {
+            throw new Error(`Invariant violation: areaMap missing key "${area}" after set`);
+        }
+        const featureKey = `${phase}::${pattern.name}`;
+        if (!areaGroup.features.has(featureKey)) {
+            areaGroup.features.set(featureKey, {
+                pattern: pattern.name,
+                source: pattern.source.file,
+                phase,
+                rules: [],
+            });
+        }
+        const feature = areaGroup.features.get(featureKey);
+        if (feature === undefined) {
+            throw new Error(`Invariant violation: features map missing key "${featureKey}" after set`);
+        }
+        // rules guaranteed non-empty by patternsWithRules filter above
+        if (pattern.rules === undefined) {
+            throw new Error(`Invariant violation: pattern "${pattern.name}" passed rules filter but has no rules`);
+        }
+        for (const rule of pattern.rules) {
+            let annotations;
+            try {
+                annotations = parseBusinessRuleAnnotations(rule.description);
+            }
+            catch (err) {
+                throw new QueryApiError('INVALID_ARGUMENT', `Failed to parse rule "${rule.name}" in "${pattern.name}": ${err instanceof Error ? err.message : String(err)}`);
+            }
+            if (filters.onlyInvariants && annotations.invariant === undefined) {
+                continue;
+            }
+            feature.rules.push({
+                name: rule.name,
+                invariant: annotations.invariant,
+                rationale: annotations.rationale,
+                verifiedBy: deduplicateScenarioNames(rule.scenarioNames, annotations.verifiedBy),
+                scenarioCount: rule.scenarioCount,
+            });
+            totalRules++;
+            if (annotations.invariant !== undefined) {
+                totalInvariants++;
+            }
+            allRuleNames.push(rule.name);
+        }
+    }
+    // Build hint when filters match nothing
+    let hint;
+    if (totalRules === 0 && (filters.productArea !== null || filters.patternName !== null)) {
+        const availableAreas = [
+            ...new Set(dataset.patterns
+                .filter((p) => p.rules !== undefined && p.rules.length > 0)
+                .map((p) => p.productArea ?? 'Platform')),
+        ];
+        hint =
+            filters.productArea !== null
+                ? `No rules found for product area "${filters.productArea}". Areas with rules: ${availableAreas.join(', ')}`
+                : `No rules found for pattern "${String(filters.patternName)}".`;
+    }
+    // Build final grouped output
+    const productAreas = [...areaMap.entries()].map(([areaName, areaGroup]) => {
+        const phaseMap = new Map();
+        let areaRuleCount = 0;
+        let areaInvariantCount = 0;
+        for (const feature of areaGroup.features.values()) {
+            if (feature.rules.length === 0)
+                continue;
+            if (!phaseMap.has(feature.phase)) {
+                phaseMap.set(feature.phase, []);
+            }
+            phaseMap.get(feature.phase)?.push({
+                pattern: feature.pattern,
+                source: feature.source,
+                rules: feature.rules,
+            });
+            areaRuleCount += feature.rules.length;
+            areaInvariantCount += feature.rules.filter((r) => r.invariant !== undefined).length;
+        }
+        const phases = [...phaseMap.entries()].map(([phaseName, features]) => ({
+            phase: phaseName,
+            features,
+        }));
+        return {
+            productArea: areaName,
+            ruleCount: areaRuleCount,
+            invariantCount: areaInvariantCount,
+            phases,
+        };
+    });
+    return {
+        productAreas: productAreas.filter((a) => a.ruleCount > 0),
+        totalRules,
+        totalInvariants,
+        allRuleNames,
+        ...(hint !== undefined ? { hint } : {}),
+    };
+}
+//# sourceMappingURL=rules-query.js.map

package/dist/api/rules-query.js.map

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

package/dist/api/scope-validator.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @architect
+ * @architect-pattern ScopeValidatorImpl
+ * @architect-status completed
+ * @architect-implements DataAPIDesignSessionSupport
+ * @architect-uses ProcessStateAPI, MasterDataset, StubResolverImpl
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-target src/api/scope-validator.ts
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer application
+ *
+ * ## ScopeValidator — Pre-flight Session Readiness Checker
+ *
+ * Pure function composition over ProcessStateAPI and MasterDataset.
+ * Runs a checklist of prerequisite validations before starting a
+ * design or implementation session.
+ *
+ * **When to Use:** When running pre-flight checks before a session via the `scope-validate` CLI subcommand.
+ */
+import type { ProcessStateAPI } from './process-state.js';
+import type { MasterDataset } from '../validation-schemas/master-dataset.js';
+export type CheckSeverity = 'PASS' | 'BLOCKED' | 'WARN';
+export type ScopeCheckId = 'dependencies-completed' | 'stubs-from-deps-exist' | 'deliverables-defined' | 'fsm-allows-transition' | 'design-decisions-recorded' | 'executable-specs-set';
+export interface ValidationCheck {
+    readonly id: ScopeCheckId;
+    readonly label: string;
+    readonly severity: CheckSeverity;
+    readonly detail: string;
+    readonly blockerNames?: readonly string[];
+}
+export type ScopeType = 'implement' | 'design';
+export interface ScopeValidationOptions {
+    readonly patternName: string;
+    readonly scopeType: ScopeType;
+    readonly baseDir: string;
+    /** When true, WARN checks are promoted to BLOCKED (DD-4, matches lint-process --strict). */
+    readonly strict?: boolean;
+}
+export interface ScopeValidationResult {
+    readonly pattern: string;
+    readonly scopeType: ScopeType;
+    readonly checks: readonly ValidationCheck[];
+    readonly verdict: 'ready' | 'blocked' | 'warnings';
+    readonly blockerCount: number;
+    readonly warnCount: number;
+}
+export declare function validateScope(api: ProcessStateAPI, dataset: MasterDataset, options: ScopeValidationOptions): ScopeValidationResult;
+export declare function formatScopeValidation(result: ScopeValidationResult): string;
+export declare function checkDependenciesCompleted(api: ProcessStateAPI, patternName: string): ValidationCheck;
+export declare function checkDeliverablesDefined(api: ProcessStateAPI, patternName: string): ValidationCheck;
+export declare function checkFsmAllowsTransition(api: ProcessStateAPI, patternName: string): ValidationCheck;
+export declare function checkDesignDecisionsRecorded(dataset: MasterDataset, patternName: string): ValidationCheck;
+export declare function checkExecutableSpecsSet(api: ProcessStateAPI, patternName: string): ValidationCheck;
+export declare function checkStubsFromDepsExist(dataset: MasterDataset, patternName: string, baseDir: string): ValidationCheck;
+//# sourceMappingURL=scope-validator.d.ts.map

package/dist/api/scope-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-validator.d.ts","sourceRoot":"","sources":["../../src/api/scope-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAW7E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,MAAM,YAAY,GACpB,wBAAwB,GACxB,uBAAuB,GACvB,sBAAsB,GACtB,uBAAuB,GACvB,2BAA2B,GAC3B,sBAAsB,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAYD,wBAAgB,aAAa,CAC3B,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA8CvB;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA+B3E;AAMD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,GAClB,eAAe,CAsCjB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,GAClB,eAAe,CAkBjB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,GAClB,eAAe,CA4CjB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,GAClB,eAAe,CA8BjB;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,eAAe,EACpB,WAAW,EAAE,MAAM,GAClB,eAAe,CAkBjB;AAMD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,eAAe,CAmDjB"}