@aisdlc/core 1.3.2 → 1.4.1

package/dist/index.d.cts

@@ -731,9 +731,62 @@ interface DashboardResult {
         autonomyDistribution: Record<string, number>;
         traceabilityRatio: number;
         bddCoverageRatio: number;
+        userManualCoverageRatio?: number;
+        productionManualCoverageRatio?: number;
+        manualsCount?: number;
     };
     html: string;
 }
+interface ManualDocumentItem {
+    id: string;
+    type: 'user-manual' | 'production-manual';
+    title: string;
+    status: string;
+    version: string;
+    appliesToVersion: string;
+    filePath: string;
+    targetAudience: string[];
+    allowedRoles: string[];
+    journeysCovered: string[];
+    useCasesCovered: string[];
+    componentsCovered: string[];
+    enclavesInvolved: string[];
+    body: string;
+}
+interface ManualsCoverageSummary {
+    totalJourneys: number;
+    coveredJourneys: number;
+    uncoveredJourneys: string[];
+    totalUseCases: number;
+    coveredUseCases: number;
+    uncoveredUseCases: string[];
+    userCoveragePct: number;
+    totalComponents: number;
+    coveredComponents: number;
+    uncoveredComponents: string[];
+    totalEnclaves: number;
+    coveredEnclaves: number;
+    uncoveredEnclaves: string[];
+    productionCoveragePct: number;
+}
+interface ManualsVerificationOptions {
+    rootDir?: string;
+    branch?: string;
+    profile?: ChangeProfile;
+    strict?: boolean;
+}
+interface ManualsVerificationResult {
+    success: boolean;
+    status: 'PASSED' | 'WARNING' | 'FAILED';
+    enforcementMode: 'ADVISORY' | 'STRICT_RELEASE';
+    branch: string;
+    profile: ChangeProfile;
+    userManuals: ManualDocumentItem[];
+    productionManuals: ManualDocumentItem[];
+    coverage: ManualsCoverageSummary;
+    warnings: string[];
+    violations: string[];
+}
 
 /**
  * AI-SDLC: Deterministic Quality Gate Engine (Polyglot Support)
@@ -899,10 +952,25 @@ interface ScanOptions {
     productionOnly?: boolean;
 }
 declare function isToolAvailable(toolName: string): boolean;
-declare function normalizeSpdxLicense(raw: any): string;
+declare function normalizeSpdxLicense(raw: unknown): string;
 declare function findLicenseFile(pkgDir: string): string | undefined;
 declare function resolveLicenseFromFile(licenseFilePath?: string): string | undefined;
-declare function readPackageJson(filePath: string): any | null;
+interface PackageJsonInfo {
+    name?: string;
+    version?: string;
+    license?: unknown;
+    licenses?: unknown;
+    repository?: string | {
+        url?: string;
+    };
+    author?: string | {
+        name?: string;
+    };
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+declare function readPackageJson(filePath: string): PackageJsonInfo | null;
 declare function extractDirectDepNames(rootDir: string, productionOnly?: boolean): Set<string>;
 declare function processPackageDir(pkgDir: string, directNames: Set<string>, seen: Map<string, ScannedDependency>): void;
 declare function scanSubdirectories(baseDir: string, directNames: Set<string>, seen: Map<string, ScannedDependency>): void;
@@ -987,9 +1055,6 @@ interface JsonSchemaRule {
     format?: string;
     [key: string]: unknown;
 }
-/**
- * Deterministic JSON Schema validator matching Draft 2020-12 core specifications
- */
 declare function validateAgainstSchema(value: unknown, schema: JsonSchemaRule, propPath?: string): string[];
 declare function resolveSchemaForArtifact(frontmatter: Record<string, unknown>, rootDir: string): {
     schemaPath: string;
@@ -1007,6 +1072,15 @@ declare function detectProfileFromChange(changeDir: string): ChangeProfile;
 declare function isPathProtectedFromPatch(filePath: string): boolean;
 declare function verifyProgressiveFriction(options?: ProgressiveFrictionOptions): ProgressiveFrictionResult;
 
+/**
+ * AI-SDLC: Operational Manuals (MAN-USER & MAN-PROD) Coverage & Progressive Gate Verifier
+ * Audits presence and coverage of User Manuals (JRN-*, UC-*) and Production Manuals (CMP-*, SEC-ENC-*).
+ * Enforces non-blocking ADVISORY warnings during daily development and STRICT blocking on release/* or critical changes.
+ */
+
+declare function scanManualsInWorkspace(rootDir: string): ManualDocumentItem[];
+declare function verifyManuals(options?: ManualsVerificationOptions): ManualsVerificationResult;
+
 /**
  * AI-SDLC: Deterministic Duplicate Requirements Verifier (Shift-Left Pre-Implementation Gate)
  *
@@ -1220,6 +1294,10 @@ declare function formatCommitTrailers(trailers: Partial<CommitTrailers>): string
  * when not explicitly declared in commit trailers.
  */
 declare function inferMissingTrailers(trailers: CommitTrailers, linesAdded: number, linesDeleted: number): CommitTrailers;
+/**
+ * Resolves a git reference (branch or commit), checking common branch prefixes if not directly found.
+ */
+declare function resolveGitRef(cwd: string, ref: string): string;
 /**
  * Extracts all commit records and their KPIs in a git revision range (e.g. main..HEAD).
  */
@@ -1293,6 +1371,10 @@ interface PrKpiAggregation {
 }
 declare const KPI_SUMMARY_START_TAG = "<!-- AI-SDLC-KPI-SUMMARY-START -->";
 declare const KPI_SUMMARY_END_TAG = "<!-- AI-SDLC-KPI-SUMMARY-END -->";
+/**
+ * Aggregates a collection of commit KPI records into a unified PR KPI aggregation.
+ */
+declare function aggregateCommitKpiRecords(records: CommitKpiRecord[], baseRef?: string, headRef?: string): PrKpiAggregation;
 /**
  * Aggregates all commit KPIs in the revision range of a Pull Request.
  */
@@ -1369,6 +1451,7 @@ declare function formatReleaseKpiMarkdown(report: ReleaseKpiReport): string;
  */
 declare function writeReleaseKpiReport(report: ReleaseKpiReport, options?: {
     outputDir?: string;
+    rootDir?: string;
 }): {
     markdownPath: string;
     jsonPath: string;
@@ -1387,6 +1470,11 @@ declare function resolveCytoscapePath(): string | null;
  */
 declare function getCytoscapeScript(): string;
 
+/**
+ * AI-SDLC: Cytoscape Graph Elements Builder
+ * Scans workspace artifacts and RTM traceability to build Graph Elements for Cytoscape.js.
+ */
+
 interface GraphElementsResult {
     elements: CytoscapeElement[];
     nodesByLayer: Record<GraphNodeLayer, number>;
@@ -1397,6 +1485,29 @@ interface GraphElementsResult {
  * Builds the graph elements (nodes & edges) for Cytoscape.js.
  */
 declare function buildGraphElements(rootDir?: string): GraphElementsResult;
+
+/**
+ * AI-SDLC: Dashboard HTML Renderer
+ * Generates modular offline HTML for Cytoscape Graph, RTM 360°, Quality Gates, and KPIs.
+ */
+
+interface DashboardMetricsData {
+    gate: QualityGateResult;
+    gov: GovernanceResult;
+    cov: TestingCoverageResult;
+    codeCoverage: CodeCoverageSummary | null;
+    trace: TraceabilityResult;
+    manuals: ManualsVerificationResult;
+    history: DashboardHistoricalKpi[];
+    activePrKpi: PrKpiAggregation | null;
+    activeBranch: string;
+    branchTelemetries?: Record<string, PrKpiAggregation>;
+    totalTelemetry?: PrKpiAggregation | null;
+}
+declare function renderAutonomyModeSection(mode: string, statusIcon: string, count: number, roleDescription: string, allTasks?: TaskSummary[]): string;
+declare function renderManualsTab(manuals: ManualsVerificationResult): string;
+declare function renderDashboardHtml(graphData: GraphElementsResult, metricsData: DashboardMetricsData, title?: string): string;
+
 /**
  * Loads historical KPI records from reports/releases/ directory.
  */
@@ -1410,14 +1521,13 @@ declare function collectDashboardMetrics(rootDir: string): {
     cov: TestingCoverageResult;
     codeCoverage: CodeCoverageSummary | null;
     trace: TraceabilityResult;
+    manuals: ManualsVerificationResult;
     history: DashboardHistoricalKpi[];
     activePrKpi: PrKpiAggregation | null;
     activeBranch: string;
+    branchTelemetries: Record<string, PrKpiAggregation>;
+    totalTelemetry: PrKpiAggregation | null;
 };
-/**
- * Renders the HTML string for the interactive dashboard.
- */
-declare function renderDashboardHtml(graphData: GraphElementsResult, metricsData: ReturnType<typeof collectDashboardMetrics>, title?: string): string;
 /**
  * Main function to generate the dashboard report.
  */
@@ -1512,13 +1622,6 @@ interface SpecCatalogScope {
     newItems: SpecCatalogNewItem[];
     affectedItems: SpecCatalogAffectedItem[];
 }
-/**
- * Parses a spec.md using the canonical template format to extract:
- * - Section 1.1: existing catalog items that are MODIFIED or DEPRECATED
- * - Section 1.2: new catalog items to be physically materialized
- *
- * Returns empty arrays when the spec uses the simplified format (no 1.1 / 1.2 headings).
- */
 declare function parseSpecCatalogScope(specContent: string): SpecCatalogScope;
 declare function findChangeWorkspaceDir(rootDir: string, changeId: string): string | null;
 declare function integrateSddChange(options: SddIntegrationOptions): SddIntegrationResult;
@@ -1634,7 +1737,7 @@ declare const STARTER_VSCODE_MCP = "{\n  \"servers\": {\n    \"ai-sdlc\": {\n
 
 declare const VALID_CI_PROVIDERS: readonly ["github", "gitlab", "azure", "bitbucket"];
 type SupportedCiProvider = (typeof VALID_CI_PROVIDERS)[number];
-declare const STARTER_QUALITY_POLICY = "# ==============================================================================\n# AI-SDLC: Software Quality, Coding Rules & Release Gate Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nenforcement_mode: \"STRICT\"\n\nscope:\n  target_directories:\n    - \"src\"\n    - \"lib\"\n    - \"examples\"\n    - \"tests\"\n  supported_extensions:\n    - \".ts\"\n    - \".js\"\n    - \".py\"\n    - \".java\"\n    - \".go\"\n    - \".cs\"\n    - \".rs\"\n    - \".cpp\"\n    - \".c\"\n  exclude_patterns:\n    - \"node_modules\"\n    - \"__pycache__\"\n    - \".pytest_cache\"\n    - \"target\"\n    - \"bin\"\n    - \"obj\"\n    - \".git\"\n    - \"reports\"\n    - \"dist\"\n    - \".changeset\"\n\nthresholds:\n  cyclomatic_complexity:\n    max_per_function: 10\n  cognitive_complexity:\n    max_per_function: 15\n  maintainability_index:\n    min_acceptable_score: 50.0\n  function_length:\n    max_function_lines: 40\n";
+declare const STARTER_QUALITY_POLICY = "# ==============================================================================\n# AI-SDLC: Software Quality, Coding Rules & Release Gate Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nenforcement_mode: \"STRICT\"\n\nscope:\n  target_directories:\n    - \"src\"\n    - \"lib\"\n  supported_extensions:\n    - \".ts\"\n    - \".js\"\n    - \".py\"\n    - \".java\"\n    - \".go\"\n    - \".cs\"\n    - \".rs\"\n    - \".cpp\"\n    - \".c\"\n  exclude_patterns:\n    - \"node_modules\"\n    - \"__pycache__\"\n    - \".pytest_cache\"\n    - \"target\"\n    - \"bin\"\n    - \"obj\"\n    - \".git\"\n    - \"reports\"\n    - \"dist\"\n    - \".changeset\"\n    - \"examples\"\n    - \"scratch\"\n    - \"templates\"\n\nthresholds:\n  cyclomatic_complexity:\n    max_per_function: 10\n  cognitive_complexity:\n    max_per_function: 15\n  maintainability_index:\n    min_acceptable_score: 50.0\n  function_length:\n    max_function_lines: 40\n";
 declare const STARTER_LICENSE_POLICY = "# ==============================================================================\n# AI-SDLC: Open Source License Compliance & Governance Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\ndefault_action: \"DENY\"\n\ncategories:\n  permissive_free:\n    action: \"ALLOW\"\n    description: \"Permissive commercial use licenses. Attribution only required.\"\n    spdx_identifiers:\n      - \"MIT\"\n      - \"Apache-2.0\"\n      - \"BSD-2-Clause\"\n      - \"BSD-3-Clause\"\n      - \"ISC\"\n      - \"Unlicense\"\n      - \"CC0-1.0\"\n      - \"0BSD\"\n\n  weak_copyleft_conditional:\n    action: \"REVIEW_REQUIRED\"\n    description: \"Allowed only as dynamically linked decoupled libraries.\"\n    spdx_identifiers:\n      - \"LGPL-2.1-only\"\n      - \"LGPL-3.0-only\"\n      - \"MPL-2.0\"\n\n  strong_copyleft_viral:\n    action: \"DENY\"\n    description: \"Forbidden due to viral copyleft forcing source code disclosure.\"\n    spdx_identifiers:\n      - \"GPL-2.0-only\"\n      - \"GPL-3.0-only\"\n      - \"AGPL-3.0-only\"\n      - \"AGPL-3.0-or-later\"\n\n  commercial_acquisition_required:\n    action: \"COMMERCIAL_APPROVAL_REQUIRED\"\n    description: \"Source-available code requiring commercial license for SaaS deployment.\"\n    spdx_identifiers:\n      - \"SSPL-1.0\"\n      - \"BSL-1.1\"\n";
 declare const STARTER_TASK_TEMPLATE = "---\ntasks:\n  - id: \"TSK-001-setup\"\n    title: \"Initial component setup\"\n    complexity: \"LOW\"\n    risk-level: \"LOW\"\n    autonomy-mode: \"AUTONOMOUS\"\n    assigned-to: \"agent-developer\"\n    status: \"PENDING\"\n    verification:\n      method: \"COMMAND_VERIFICATION\"\n      command-or-criteria: \"pnpm test\"\n---\n\n# Task Plan: Component\n";
 declare const STARTER_REQUIREMENT_TEMPLATE = "---\nid: \"FR-SAMPLE-001\"\ntype: \"requirement\"\ntitle: \"Sample Feature\"\nstatus: \"active\"\nversion: \"1.0.0\"\ncategory: \"functional\"\nderives-from:\n  - \"UC-SAMPLE-USECASE\"\nverifiable-by: \"cucumber-bdd\"\nacceptance-format: \"gherkin\"\ncucumber-tags:\n  - \"@FR-SAMPLE-001\"\n---\n\n# Requirement: Sample Feature\n\n```gherkin\nFeature: Sample Feature\n  Scenario: Basic execution\n    Given system is ready\n    When user triggers action\n    Then system responds with 200 OK\n```\n";
@@ -1678,4 +1781,4 @@ declare function initProject(options?: InitProjectOptions): InitProjectResult;
 
 declare function walkMdFiles(dir: string, fileList?: string[], excludeDirs?: string[]): string[];
 
-export { ALL_ARCHITECTURE_TEMPLATES, type ActiveTaskMatch, type AgentTarget, type AnalysisResult, type ArchTemplateDef, type ArchitectureGranularity, type ArtifactFrontmatter, type ArtifactSchemaOptions, type ArtifactSchemaResult, type ArtifactSchemaViolation, type ArtifactValidationResult, type AuthorIdentity, type AuthorKpiSummary, type AutonomyMode, BRANCH_PATTERNS, type BranchClassificationResult, type BranchHierarchyPlan, type BranchValidationError, type BranchValidationSuccess, type BugRecordSummary, type ChangeDetectionOptions, type ChangeDetectionResult, type ChangeProfile, type CiProvider, type CodeCoverageSummary, type CommitKpiRecord, type CommitTrailers, type CycloneDxBom, type CycloneDxComponent, type CycloneDxLicense, type CytoscapeEdgeData, type CytoscapeElement, type CytoscapeNodeData, DEFAULT_EXCLUDED_PATTERNS, DEFAULT_EXCLUDES, DEFAULT_EXTENSIONS, DEFAULT_SAST_EXCLUDES, type DashboardHistoricalKpi, type DashboardOptions, type DashboardResult, type DiffLineItem, type DuplicateIssue, type DuplicateIssueType, type DuplicateSeverity, type DuplicateVerifierOptions, type DuplicateVerifierResult, type ExtractedFeature, type FunctionMetrics, GENERAL_SOURCE_EXTENSIONS, type GherkinExtractionOptions, type GherkinExtractionResult, type GherkinSyncCheckResult, type GitCheckoutTaskOptions, type GitCheckoutTaskResult, type GovernanceOptions, type GovernanceResult, type GraphElementsResult, type GraphNodeLayer, type GraphNodeStatus, type GraphNodeType, type HookInstallResult, type InitProjectOptions, type InitProjectResult, type JsonSchemaRule, KPI_SUMMARY_END_TAG, KPI_SUMMARY_START_TAG, type LicensePolicy, type LicenseVerificationOptions, type LicenseVerificationResult, type LicenseViolation, type ModelDefectStats, OpenSpecAdapter, PREPARE_COMMIT_MSG_SCRIPT, PROMPT_INJECTION_SIGNATURES, PROTECTED_BYPASS_PATTERNS, type PdacDrift, type PdacGraphOptions, type PdacGraphResult, type PdacNode, type PdacSyncDetail, type PdacSyncOptions, type PdacSyncResult, type PrKpiAggregation, type PreflightCheckOptions, type PreflightCheckResult, type PreflightGateSummary, type ProductHandoff, type ProductHandoffSubgraph, type ProgressiveFrictionOptions, type ProgressiveFrictionResult, type PromptInjectionFinding, type QualityGateOptions, type QualityGateResult, type QualityPolicy, type QualityReportOptions, type QualityReportResult, type QualityThresholds, type ReleaseKpiReport, type RequirementAuditItem, type ResolvedCiEnv, SAST_RULES, SECRET_RULES, SPECIALIZED_AGENT_TEMPLATES, STARTER_ANTIGRAVITY_MCP, STARTER_ANTIGRAVITY_RULES, STARTER_ARCH_ADR, STARTER_ARCH_ARCHITECTURE_CONSTRAINTS, STARTER_ARCH_COMPONENT, STARTER_ARCH_CONTEXT_AND_SCOPE, STARTER_ARCH_CROSS_CUTTING_CONCEPTS, STARTER_ARCH_DEPLOYMENT_VIEW, STARTER_ARCH_GLOSSARY, STARTER_ARCH_INTRODUCTION_AND_GOALS, STARTER_ARCH_LEVEL_1_WHITEBOX, STARTER_ARCH_QUALITY_REQUIREMENTS, STARTER_ARCH_RISKS_AND_TECHNICAL_DEBT, STARTER_ARCH_RUNTIME_VIEW, STARTER_ARCH_SOLUTION_STRATEGY, STARTER_AZURE_PIPELINES, STARTER_BITBUCKET_PIPELINES, STARTER_CLAUDE_RULES, STARTER_COPILOT_RULES, STARTER_CURSOR_CORE_RULES, STARTER_CURSOR_MCP, STARTER_CURSOR_PRODUCT_RULES, STARTER_CURSOR_QUALITY_RULES, STARTER_GITHUB_CI, STARTER_GITHUB_SDD_INTEGRATE, STARTER_GITLAB_CI, STARTER_LICENSE_POLICY, STARTER_QUALITY_POLICY, STARTER_REQUIREMENT_TEMPLATE, STARTER_TASK_TEMPLATE, STARTER_VSCODE_MCP, STARTER_WORKFLOW_HANDOFF_TEMPLATE, type SastFindingType, type SastRule, type SastSeverity, type SastVerifierOptions, type SastVerifierResult, type SastViolation, type SbomGenerateOptions, type ScaTool, type ScanOptions, type ScannedDependency, type ScannedRequirement, type SddAdapter, type SddChangeScaffoldOptions, type SddChangeScaffoldResult, type SddDepositOptions, type SddFramework, type SddIntegrationAudit, type SddIntegrationOptions, type SddIntegrationResult, type SddValidationResult, type SddWorkspaceInfo, type SecretFindingType, type SecretRule, type SecretVerifierOptions, type SecretVerifierResult, type SecretViolation, type SpecCatalogScope, SpecKitAdapter, type SpecializedAgentTemplate, type SupportedCiProvider, TYPE_TO_SCHEMA_MAP, type TaskAuditItem, type TaskItem, type TaskLocateResult, type TaskSummary, type TaskVerification, type TestingCoverageOptions, type TestingCoverageResult, type TraceabilityOptions, type TraceabilityResult, type TraceabilityRow, VALID_AGENT_TARGETS, VALID_ARCHITECTURE_GRANULARITIES, VALID_AUTONOMY_MODES, VALID_CHANGE_PROFILES, VALID_CI_PROVIDERS, aggregatePrKpis, aggregateReleaseKpis, appendRevisionHistoryRow, buildCycloneDxComponent, buildFeatureFileContent, buildGraphElements, calculateJaccardSimilarity, calculateMetrics, calculateRating, calculateShannonEntropy, checkGherkinInSync, checkoutTaskBranch, classifyBranch, collectAgentFiles, collectDashboardMetrics, collectHistoricalKpis, computeCanonicalSha256, computeSha256, createDefaultQualityPolicy, depositProductHandoffSidecar, detectActiveChangeForIntegration, detectAuthorIdentity, detectLanguage, detectProfileFromChange, detectPromptInjection, emitCiOutput, evaluateCompoundLicense, evaluateSingleDependency, extractCitations, extractCommitKpisFromRange, extractDirectDepNames, extractFeatureTags, extractFrontmatter, extractFunctions, extractFunctionsBraceLanguages, extractFunctionsPolyglot, extractFunctionsPython, extractFunctionsTypeScriptAst, extractGherkinBlock, extractGherkinFeatures, extractNormativeText, findChangeWorkspaceDir, findLicenseFile, formatCommitTrailers, formatPrKpiMarkdown, formatReleaseKpiMarkdown, generateBranchHierarchyPlan, generateCycloneDxSbom, generateDashboardReport, generateDuplicatesReportMarkdown, generateGovernanceReportMarkdown, generateLicenseReportMarkdown, generatePdacReportMarkdown, generateQualityReport, generateSastReportMarkdown, generateSecretsReportMarkdown, generateTestingCoverageReportMarkdown, generateThirdPartyNotices, generateTraceabilityReportMarkdown, getArchitectureTemplates, getCytoscapeScript, getGitDiffLines, getNextCorrelativeNumber, getSddAdapter, inferArtifactTypeFromId, inferMissingTrailers, initProject, injectKpisIntoPrBody, installGitHooks, integrateSddChange, isGitleaksInstalled, isPathProtectedFromPatch, isPlaceholderOrIgnored, isRequirementArtifact, isSemgrepInstalled, isToolAvailable, loadProductHandoffSidecar, locateTaskInActiveChanges, maskSecret, normalizeSpdxLicense, parseCommitTrailers, parseFrontmatter, parseFrontmatterId, parseGenericDoc, parseLicensePolicy, parseMarkdownFrontmatter, parseQualityPolicy, parseRequirementFile, parseSpecCatalogScope, parseTasksDoc, parseTasksFromContent, processPackageDir, readCodeCoverageSummary, readPackageJson, renderAntigravityAgentFile, renderClaudeAgentFile, renderCopilotAgentFile, renderCursorAgentFile, renderDashboardHtml, resolveAgentTargets, resolveBranchHierarchy, resolveCiEnvironment, resolveCytoscapePath, resolveFeatureFilePath, resolveLicenseFromFile, resolveSchemaForArtifact, resolveTargetFiles, runGitleaksCli, runSemgrepCli, scaffoldSddChange, scanAllProductHandoffs, scanAllTestArtifacts, scanContentForSecrets, scanFileForSast, scanInstalledLicenses, scanPnpmStore, scanSubdirectories, scanWithNativeFs, scanWithSyft, scanWithTrivy, slugify, syncPdacDigests, tokenizeTitle, updateCitationsInContent, validateAgainstSchema, validateArtifactSchema, verifyArtifactDuplicates, verifyArtifactsSchemas, verifyLicenses, verifyPdacGraph, verifyProgressiveFriction, verifyQualityGate, verifySast, verifySddIntegration, verifySecrets, verifyTasksGovernance, verifyTestingCoverage, verifyTraceability, walkDir, walkMdFiles, walkProjectFiles, walkSourceFiles, walkTaskFiles, writeCycloneDxSbom, writeReleaseKpiReport, writeThirdPartyNotices };
+export { ALL_ARCHITECTURE_TEMPLATES, type ActiveTaskMatch, type AgentTarget, type AnalysisResult, type ArchTemplateDef, type ArchitectureGranularity, type ArtifactFrontmatter, type ArtifactSchemaOptions, type ArtifactSchemaResult, type ArtifactSchemaViolation, type ArtifactValidationResult, type AuthorIdentity, type AuthorKpiSummary, type AutonomyMode, BRANCH_PATTERNS, type BranchClassificationResult, type BranchHierarchyPlan, type BranchValidationError, type BranchValidationSuccess, type BugRecordSummary, type ChangeDetectionOptions, type ChangeDetectionResult, type ChangeProfile, type CiProvider, type CodeCoverageSummary, type CommitKpiRecord, type CommitTrailers, type CycloneDxBom, type CycloneDxComponent, type CycloneDxLicense, type CytoscapeEdgeData, type CytoscapeElement, type CytoscapeNodeData, DEFAULT_EXCLUDED_PATTERNS, DEFAULT_EXCLUDES, DEFAULT_EXTENSIONS, DEFAULT_SAST_EXCLUDES, type DashboardHistoricalKpi, type DashboardOptions, type DashboardResult, type DiffLineItem, type DuplicateIssue, type DuplicateIssueType, type DuplicateSeverity, type DuplicateVerifierOptions, type DuplicateVerifierResult, type ExtractedFeature, type FunctionMetrics, GENERAL_SOURCE_EXTENSIONS, type GherkinExtractionOptions, type GherkinExtractionResult, type GherkinSyncCheckResult, type GitCheckoutTaskOptions, type GitCheckoutTaskResult, type GovernanceOptions, type GovernanceResult, type GraphElementsResult, type GraphNodeLayer, type GraphNodeStatus, type GraphNodeType, type HookInstallResult, type InitProjectOptions, type InitProjectResult, type JsonSchemaRule, KPI_SUMMARY_END_TAG, KPI_SUMMARY_START_TAG, type LicensePolicy, type LicenseVerificationOptions, type LicenseVerificationResult, type LicenseViolation, type ManualDocumentItem, type ManualsCoverageSummary, type ManualsVerificationOptions, type ManualsVerificationResult, type ModelDefectStats, OpenSpecAdapter, PREPARE_COMMIT_MSG_SCRIPT, PROMPT_INJECTION_SIGNATURES, PROTECTED_BYPASS_PATTERNS, type PackageJsonInfo, type PdacDrift, type PdacGraphOptions, type PdacGraphResult, type PdacNode, type PdacSyncDetail, type PdacSyncOptions, type PdacSyncResult, type PrKpiAggregation, type PreflightCheckOptions, type PreflightCheckResult, type PreflightGateSummary, type ProductHandoff, type ProductHandoffSubgraph, type ProgressiveFrictionOptions, type ProgressiveFrictionResult, type PromptInjectionFinding, type QualityGateOptions, type QualityGateResult, type QualityPolicy, type QualityReportOptions, type QualityReportResult, type QualityThresholds, type ReleaseKpiReport, type RequirementAuditItem, type ResolvedCiEnv, SAST_RULES, SECRET_RULES, SPECIALIZED_AGENT_TEMPLATES, STARTER_ANTIGRAVITY_MCP, STARTER_ANTIGRAVITY_RULES, STARTER_ARCH_ADR, STARTER_ARCH_ARCHITECTURE_CONSTRAINTS, STARTER_ARCH_COMPONENT, STARTER_ARCH_CONTEXT_AND_SCOPE, STARTER_ARCH_CROSS_CUTTING_CONCEPTS, STARTER_ARCH_DEPLOYMENT_VIEW, STARTER_ARCH_GLOSSARY, STARTER_ARCH_INTRODUCTION_AND_GOALS, STARTER_ARCH_LEVEL_1_WHITEBOX, STARTER_ARCH_QUALITY_REQUIREMENTS, STARTER_ARCH_RISKS_AND_TECHNICAL_DEBT, STARTER_ARCH_RUNTIME_VIEW, STARTER_ARCH_SOLUTION_STRATEGY, STARTER_AZURE_PIPELINES, STARTER_BITBUCKET_PIPELINES, STARTER_CLAUDE_RULES, STARTER_COPILOT_RULES, STARTER_CURSOR_CORE_RULES, STARTER_CURSOR_MCP, STARTER_CURSOR_PRODUCT_RULES, STARTER_CURSOR_QUALITY_RULES, STARTER_GITHUB_CI, STARTER_GITHUB_SDD_INTEGRATE, STARTER_GITLAB_CI, STARTER_LICENSE_POLICY, STARTER_QUALITY_POLICY, STARTER_REQUIREMENT_TEMPLATE, STARTER_TASK_TEMPLATE, STARTER_VSCODE_MCP, STARTER_WORKFLOW_HANDOFF_TEMPLATE, type SastFindingType, type SastRule, type SastSeverity, type SastVerifierOptions, type SastVerifierResult, type SastViolation, type SbomGenerateOptions, type ScaTool, type ScanOptions, type ScannedDependency, type ScannedRequirement, type SddAdapter, type SddChangeScaffoldOptions, type SddChangeScaffoldResult, type SddDepositOptions, type SddFramework, type SddIntegrationAudit, type SddIntegrationOptions, type SddIntegrationResult, type SddValidationResult, type SddWorkspaceInfo, type SecretFindingType, type SecretRule, type SecretVerifierOptions, type SecretVerifierResult, type SecretViolation, type SpecCatalogScope, SpecKitAdapter, type SpecializedAgentTemplate, type SupportedCiProvider, TYPE_TO_SCHEMA_MAP, type TaskAuditItem, type TaskItem, type TaskLocateResult, type TaskSummary, type TaskVerification, type TestingCoverageOptions, type TestingCoverageResult, type TraceabilityOptions, type TraceabilityResult, type TraceabilityRow, VALID_AGENT_TARGETS, VALID_ARCHITECTURE_GRANULARITIES, VALID_AUTONOMY_MODES, VALID_CHANGE_PROFILES, VALID_CI_PROVIDERS, aggregateCommitKpiRecords, aggregatePrKpis, aggregateReleaseKpis, appendRevisionHistoryRow, buildCycloneDxComponent, buildFeatureFileContent, buildGraphElements, calculateJaccardSimilarity, calculateMetrics, calculateRating, calculateShannonEntropy, checkGherkinInSync, checkoutTaskBranch, classifyBranch, collectAgentFiles, collectDashboardMetrics, collectHistoricalKpis, computeCanonicalSha256, computeSha256, createDefaultQualityPolicy, depositProductHandoffSidecar, detectActiveChangeForIntegration, detectAuthorIdentity, detectLanguage, detectProfileFromChange, detectPromptInjection, emitCiOutput, evaluateCompoundLicense, evaluateSingleDependency, extractCitations, extractCommitKpisFromRange, extractDirectDepNames, extractFeatureTags, extractFrontmatter, extractFunctions, extractFunctionsBraceLanguages, extractFunctionsPolyglot, extractFunctionsPython, extractFunctionsTypeScriptAst, extractGherkinBlock, extractGherkinFeatures, extractNormativeText, findChangeWorkspaceDir, findLicenseFile, formatCommitTrailers, formatPrKpiMarkdown, formatReleaseKpiMarkdown, generateBranchHierarchyPlan, generateCycloneDxSbom, generateDashboardReport, generateDuplicatesReportMarkdown, generateGovernanceReportMarkdown, generateLicenseReportMarkdown, generatePdacReportMarkdown, generateQualityReport, generateSastReportMarkdown, generateSecretsReportMarkdown, generateTestingCoverageReportMarkdown, generateThirdPartyNotices, generateTraceabilityReportMarkdown, getArchitectureTemplates, getCytoscapeScript, getGitDiffLines, getNextCorrelativeNumber, getSddAdapter, inferArtifactTypeFromId, inferMissingTrailers, initProject, injectKpisIntoPrBody, installGitHooks, integrateSddChange, isGitleaksInstalled, isPathProtectedFromPatch, isPlaceholderOrIgnored, isRequirementArtifact, isSemgrepInstalled, isToolAvailable, loadProductHandoffSidecar, locateTaskInActiveChanges, maskSecret, normalizeSpdxLicense, parseCommitTrailers, parseFrontmatter, parseFrontmatterId, parseGenericDoc, parseLicensePolicy, parseMarkdownFrontmatter, parseQualityPolicy, parseRequirementFile, parseSpecCatalogScope, parseTasksDoc, parseTasksFromContent, processPackageDir, readCodeCoverageSummary, readPackageJson, renderAntigravityAgentFile, renderAutonomyModeSection, renderClaudeAgentFile, renderCopilotAgentFile, renderCursorAgentFile, renderDashboardHtml, renderManualsTab, resolveAgentTargets, resolveBranchHierarchy, resolveCiEnvironment, resolveCytoscapePath, resolveFeatureFilePath, resolveGitRef, resolveLicenseFromFile, resolveSchemaForArtifact, resolveTargetFiles, runGitleaksCli, runSemgrepCli, scaffoldSddChange, scanAllProductHandoffs, scanAllTestArtifacts, scanContentForSecrets, scanFileForSast, scanInstalledLicenses, scanManualsInWorkspace, scanPnpmStore, scanSubdirectories, scanWithNativeFs, scanWithSyft, scanWithTrivy, slugify, syncPdacDigests, tokenizeTitle, updateCitationsInContent, validateAgainstSchema, validateArtifactSchema, verifyArtifactDuplicates, verifyArtifactsSchemas, verifyLicenses, verifyManuals, verifyPdacGraph, verifyProgressiveFriction, verifyQualityGate, verifySast, verifySddIntegration, verifySecrets, verifyTasksGovernance, verifyTestingCoverage, verifyTraceability, walkDir, walkMdFiles, walkProjectFiles, walkSourceFiles, walkTaskFiles, writeCycloneDxSbom, writeReleaseKpiReport, writeThirdPartyNotices };

package/dist/index.d.ts

@@ -731,9 +731,62 @@ interface DashboardResult {
         autonomyDistribution: Record<string, number>;
         traceabilityRatio: number;
         bddCoverageRatio: number;
+        userManualCoverageRatio?: number;
+        productionManualCoverageRatio?: number;
+        manualsCount?: number;
     };
     html: string;
 }
+interface ManualDocumentItem {
+    id: string;
+    type: 'user-manual' | 'production-manual';
+    title: string;
+    status: string;
+    version: string;
+    appliesToVersion: string;
+    filePath: string;
+    targetAudience: string[];
+    allowedRoles: string[];
+    journeysCovered: string[];
+    useCasesCovered: string[];
+    componentsCovered: string[];
+    enclavesInvolved: string[];
+    body: string;
+}
+interface ManualsCoverageSummary {
+    totalJourneys: number;
+    coveredJourneys: number;
+    uncoveredJourneys: string[];
+    totalUseCases: number;
+    coveredUseCases: number;
+    uncoveredUseCases: string[];
+    userCoveragePct: number;
+    totalComponents: number;
+    coveredComponents: number;
+    uncoveredComponents: string[];
+    totalEnclaves: number;
+    coveredEnclaves: number;
+    uncoveredEnclaves: string[];
+    productionCoveragePct: number;
+}
+interface ManualsVerificationOptions {
+    rootDir?: string;
+    branch?: string;
+    profile?: ChangeProfile;
+    strict?: boolean;
+}
+interface ManualsVerificationResult {
+    success: boolean;
+    status: 'PASSED' | 'WARNING' | 'FAILED';
+    enforcementMode: 'ADVISORY' | 'STRICT_RELEASE';
+    branch: string;
+    profile: ChangeProfile;
+    userManuals: ManualDocumentItem[];
+    productionManuals: ManualDocumentItem[];
+    coverage: ManualsCoverageSummary;
+    warnings: string[];
+    violations: string[];
+}
 
 /**
  * AI-SDLC: Deterministic Quality Gate Engine (Polyglot Support)
@@ -899,10 +952,25 @@ interface ScanOptions {
     productionOnly?: boolean;
 }
 declare function isToolAvailable(toolName: string): boolean;
-declare function normalizeSpdxLicense(raw: any): string;
+declare function normalizeSpdxLicense(raw: unknown): string;
 declare function findLicenseFile(pkgDir: string): string | undefined;
 declare function resolveLicenseFromFile(licenseFilePath?: string): string | undefined;
-declare function readPackageJson(filePath: string): any | null;
+interface PackageJsonInfo {
+    name?: string;
+    version?: string;
+    license?: unknown;
+    licenses?: unknown;
+    repository?: string | {
+        url?: string;
+    };
+    author?: string | {
+        name?: string;
+    };
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+declare function readPackageJson(filePath: string): PackageJsonInfo | null;
 declare function extractDirectDepNames(rootDir: string, productionOnly?: boolean): Set<string>;
 declare function processPackageDir(pkgDir: string, directNames: Set<string>, seen: Map<string, ScannedDependency>): void;
 declare function scanSubdirectories(baseDir: string, directNames: Set<string>, seen: Map<string, ScannedDependency>): void;
@@ -987,9 +1055,6 @@ interface JsonSchemaRule {
     format?: string;
     [key: string]: unknown;
 }
-/**
- * Deterministic JSON Schema validator matching Draft 2020-12 core specifications
- */
 declare function validateAgainstSchema(value: unknown, schema: JsonSchemaRule, propPath?: string): string[];
 declare function resolveSchemaForArtifact(frontmatter: Record<string, unknown>, rootDir: string): {
     schemaPath: string;
@@ -1007,6 +1072,15 @@ declare function detectProfileFromChange(changeDir: string): ChangeProfile;
 declare function isPathProtectedFromPatch(filePath: string): boolean;
 declare function verifyProgressiveFriction(options?: ProgressiveFrictionOptions): ProgressiveFrictionResult;
 
+/**
+ * AI-SDLC: Operational Manuals (MAN-USER & MAN-PROD) Coverage & Progressive Gate Verifier
+ * Audits presence and coverage of User Manuals (JRN-*, UC-*) and Production Manuals (CMP-*, SEC-ENC-*).
+ * Enforces non-blocking ADVISORY warnings during daily development and STRICT blocking on release/* or critical changes.
+ */
+
+declare function scanManualsInWorkspace(rootDir: string): ManualDocumentItem[];
+declare function verifyManuals(options?: ManualsVerificationOptions): ManualsVerificationResult;
+
 /**
  * AI-SDLC: Deterministic Duplicate Requirements Verifier (Shift-Left Pre-Implementation Gate)
  *
@@ -1220,6 +1294,10 @@ declare function formatCommitTrailers(trailers: Partial<CommitTrailers>): string
  * when not explicitly declared in commit trailers.
  */
 declare function inferMissingTrailers(trailers: CommitTrailers, linesAdded: number, linesDeleted: number): CommitTrailers;
+/**
+ * Resolves a git reference (branch or commit), checking common branch prefixes if not directly found.
+ */
+declare function resolveGitRef(cwd: string, ref: string): string;
 /**
  * Extracts all commit records and their KPIs in a git revision range (e.g. main..HEAD).
  */
@@ -1293,6 +1371,10 @@ interface PrKpiAggregation {
 }
 declare const KPI_SUMMARY_START_TAG = "<!-- AI-SDLC-KPI-SUMMARY-START -->";
 declare const KPI_SUMMARY_END_TAG = "<!-- AI-SDLC-KPI-SUMMARY-END -->";
+/**
+ * Aggregates a collection of commit KPI records into a unified PR KPI aggregation.
+ */
+declare function aggregateCommitKpiRecords(records: CommitKpiRecord[], baseRef?: string, headRef?: string): PrKpiAggregation;
 /**
  * Aggregates all commit KPIs in the revision range of a Pull Request.
  */
@@ -1369,6 +1451,7 @@ declare function formatReleaseKpiMarkdown(report: ReleaseKpiReport): string;
  */
 declare function writeReleaseKpiReport(report: ReleaseKpiReport, options?: {
     outputDir?: string;
+    rootDir?: string;
 }): {
     markdownPath: string;
     jsonPath: string;
@@ -1387,6 +1470,11 @@ declare function resolveCytoscapePath(): string | null;
  */
 declare function getCytoscapeScript(): string;
 
+/**
+ * AI-SDLC: Cytoscape Graph Elements Builder
+ * Scans workspace artifacts and RTM traceability to build Graph Elements for Cytoscape.js.
+ */
+
 interface GraphElementsResult {
     elements: CytoscapeElement[];
     nodesByLayer: Record<GraphNodeLayer, number>;
@@ -1397,6 +1485,29 @@ interface GraphElementsResult {
  * Builds the graph elements (nodes & edges) for Cytoscape.js.
  */
 declare function buildGraphElements(rootDir?: string): GraphElementsResult;
+
+/**
+ * AI-SDLC: Dashboard HTML Renderer
+ * Generates modular offline HTML for Cytoscape Graph, RTM 360°, Quality Gates, and KPIs.
+ */
+
+interface DashboardMetricsData {
+    gate: QualityGateResult;
+    gov: GovernanceResult;
+    cov: TestingCoverageResult;
+    codeCoverage: CodeCoverageSummary | null;
+    trace: TraceabilityResult;
+    manuals: ManualsVerificationResult;
+    history: DashboardHistoricalKpi[];
+    activePrKpi: PrKpiAggregation | null;
+    activeBranch: string;
+    branchTelemetries?: Record<string, PrKpiAggregation>;
+    totalTelemetry?: PrKpiAggregation | null;
+}
+declare function renderAutonomyModeSection(mode: string, statusIcon: string, count: number, roleDescription: string, allTasks?: TaskSummary[]): string;
+declare function renderManualsTab(manuals: ManualsVerificationResult): string;
+declare function renderDashboardHtml(graphData: GraphElementsResult, metricsData: DashboardMetricsData, title?: string): string;
+
 /**
  * Loads historical KPI records from reports/releases/ directory.
  */
@@ -1410,14 +1521,13 @@ declare function collectDashboardMetrics(rootDir: string): {
     cov: TestingCoverageResult;
     codeCoverage: CodeCoverageSummary | null;
     trace: TraceabilityResult;
+    manuals: ManualsVerificationResult;
     history: DashboardHistoricalKpi[];
     activePrKpi: PrKpiAggregation | null;
     activeBranch: string;
+    branchTelemetries: Record<string, PrKpiAggregation>;
+    totalTelemetry: PrKpiAggregation | null;
 };
-/**
- * Renders the HTML string for the interactive dashboard.
- */
-declare function renderDashboardHtml(graphData: GraphElementsResult, metricsData: ReturnType<typeof collectDashboardMetrics>, title?: string): string;
 /**
  * Main function to generate the dashboard report.
  */
@@ -1512,13 +1622,6 @@ interface SpecCatalogScope {
     newItems: SpecCatalogNewItem[];
     affectedItems: SpecCatalogAffectedItem[];
 }
-/**
- * Parses a spec.md using the canonical template format to extract:
- * - Section 1.1: existing catalog items that are MODIFIED or DEPRECATED
- * - Section 1.2: new catalog items to be physically materialized
- *
- * Returns empty arrays when the spec uses the simplified format (no 1.1 / 1.2 headings).
- */
 declare function parseSpecCatalogScope(specContent: string): SpecCatalogScope;
 declare function findChangeWorkspaceDir(rootDir: string, changeId: string): string | null;
 declare function integrateSddChange(options: SddIntegrationOptions): SddIntegrationResult;
@@ -1634,7 +1737,7 @@ declare const STARTER_VSCODE_MCP = "{\n  \"servers\": {\n    \"ai-sdlc\": {\n
 
 declare const VALID_CI_PROVIDERS: readonly ["github", "gitlab", "azure", "bitbucket"];
 type SupportedCiProvider = (typeof VALID_CI_PROVIDERS)[number];
-declare const STARTER_QUALITY_POLICY = "# ==============================================================================\n# AI-SDLC: Software Quality, Coding Rules & Release Gate Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nenforcement_mode: \"STRICT\"\n\nscope:\n  target_directories:\n    - \"src\"\n    - \"lib\"\n    - \"examples\"\n    - \"tests\"\n  supported_extensions:\n    - \".ts\"\n    - \".js\"\n    - \".py\"\n    - \".java\"\n    - \".go\"\n    - \".cs\"\n    - \".rs\"\n    - \".cpp\"\n    - \".c\"\n  exclude_patterns:\n    - \"node_modules\"\n    - \"__pycache__\"\n    - \".pytest_cache\"\n    - \"target\"\n    - \"bin\"\n    - \"obj\"\n    - \".git\"\n    - \"reports\"\n    - \"dist\"\n    - \".changeset\"\n\nthresholds:\n  cyclomatic_complexity:\n    max_per_function: 10\n  cognitive_complexity:\n    max_per_function: 15\n  maintainability_index:\n    min_acceptable_score: 50.0\n  function_length:\n    max_function_lines: 40\n";
+declare const STARTER_QUALITY_POLICY = "# ==============================================================================\n# AI-SDLC: Software Quality, Coding Rules & Release Gate Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\nenforcement_mode: \"STRICT\"\n\nscope:\n  target_directories:\n    - \"src\"\n    - \"lib\"\n  supported_extensions:\n    - \".ts\"\n    - \".js\"\n    - \".py\"\n    - \".java\"\n    - \".go\"\n    - \".cs\"\n    - \".rs\"\n    - \".cpp\"\n    - \".c\"\n  exclude_patterns:\n    - \"node_modules\"\n    - \"__pycache__\"\n    - \".pytest_cache\"\n    - \"target\"\n    - \"bin\"\n    - \"obj\"\n    - \".git\"\n    - \"reports\"\n    - \"dist\"\n    - \".changeset\"\n    - \"examples\"\n    - \"scratch\"\n    - \"templates\"\n\nthresholds:\n  cyclomatic_complexity:\n    max_per_function: 10\n  cognitive_complexity:\n    max_per_function: 15\n  maintainability_index:\n    min_acceptable_score: 50.0\n  function_length:\n    max_function_lines: 40\n";
 declare const STARTER_LICENSE_POLICY = "# ==============================================================================\n# AI-SDLC: Open Source License Compliance & Governance Policy\n# ==============================================================================\nversion: \"1.0\"\nproject: \"Standard AI-SDLC Project\"\ndefault_action: \"DENY\"\n\ncategories:\n  permissive_free:\n    action: \"ALLOW\"\n    description: \"Permissive commercial use licenses. Attribution only required.\"\n    spdx_identifiers:\n      - \"MIT\"\n      - \"Apache-2.0\"\n      - \"BSD-2-Clause\"\n      - \"BSD-3-Clause\"\n      - \"ISC\"\n      - \"Unlicense\"\n      - \"CC0-1.0\"\n      - \"0BSD\"\n\n  weak_copyleft_conditional:\n    action: \"REVIEW_REQUIRED\"\n    description: \"Allowed only as dynamically linked decoupled libraries.\"\n    spdx_identifiers:\n      - \"LGPL-2.1-only\"\n      - \"LGPL-3.0-only\"\n      - \"MPL-2.0\"\n\n  strong_copyleft_viral:\n    action: \"DENY\"\n    description: \"Forbidden due to viral copyleft forcing source code disclosure.\"\n    spdx_identifiers:\n      - \"GPL-2.0-only\"\n      - \"GPL-3.0-only\"\n      - \"AGPL-3.0-only\"\n      - \"AGPL-3.0-or-later\"\n\n  commercial_acquisition_required:\n    action: \"COMMERCIAL_APPROVAL_REQUIRED\"\n    description: \"Source-available code requiring commercial license for SaaS deployment.\"\n    spdx_identifiers:\n      - \"SSPL-1.0\"\n      - \"BSL-1.1\"\n";
 declare const STARTER_TASK_TEMPLATE = "---\ntasks:\n  - id: \"TSK-001-setup\"\n    title: \"Initial component setup\"\n    complexity: \"LOW\"\n    risk-level: \"LOW\"\n    autonomy-mode: \"AUTONOMOUS\"\n    assigned-to: \"agent-developer\"\n    status: \"PENDING\"\n    verification:\n      method: \"COMMAND_VERIFICATION\"\n      command-or-criteria: \"pnpm test\"\n---\n\n# Task Plan: Component\n";
 declare const STARTER_REQUIREMENT_TEMPLATE = "---\nid: \"FR-SAMPLE-001\"\ntype: \"requirement\"\ntitle: \"Sample Feature\"\nstatus: \"active\"\nversion: \"1.0.0\"\ncategory: \"functional\"\nderives-from:\n  - \"UC-SAMPLE-USECASE\"\nverifiable-by: \"cucumber-bdd\"\nacceptance-format: \"gherkin\"\ncucumber-tags:\n  - \"@FR-SAMPLE-001\"\n---\n\n# Requirement: Sample Feature\n\n```gherkin\nFeature: Sample Feature\n  Scenario: Basic execution\n    Given system is ready\n    When user triggers action\n    Then system responds with 200 OK\n```\n";
@@ -1678,4 +1781,4 @@ declare function initProject(options?: InitProjectOptions): InitProjectResult;
 
 declare function walkMdFiles(dir: string, fileList?: string[], excludeDirs?: string[]): string[];
 
-export { ALL_ARCHITECTURE_TEMPLATES, type ActiveTaskMatch, type AgentTarget, type AnalysisResult, type ArchTemplateDef, type ArchitectureGranularity, type ArtifactFrontmatter, type ArtifactSchemaOptions, type ArtifactSchemaResult, type ArtifactSchemaViolation, type ArtifactValidationResult, type AuthorIdentity, type AuthorKpiSummary, type AutonomyMode, BRANCH_PATTERNS, type BranchClassificationResult, type BranchHierarchyPlan, type BranchValidationError, type BranchValidationSuccess, type BugRecordSummary, type ChangeDetectionOptions, type ChangeDetectionResult, type ChangeProfile, type CiProvider, type CodeCoverageSummary, type CommitKpiRecord, type CommitTrailers, type CycloneDxBom, type CycloneDxComponent, type CycloneDxLicense, type CytoscapeEdgeData, type CytoscapeElement, type CytoscapeNodeData, DEFAULT_EXCLUDED_PATTERNS, DEFAULT_EXCLUDES, DEFAULT_EXTENSIONS, DEFAULT_SAST_EXCLUDES, type DashboardHistoricalKpi, type DashboardOptions, type DashboardResult, type DiffLineItem, type DuplicateIssue, type DuplicateIssueType, type DuplicateSeverity, type DuplicateVerifierOptions, type DuplicateVerifierResult, type ExtractedFeature, type FunctionMetrics, GENERAL_SOURCE_EXTENSIONS, type GherkinExtractionOptions, type GherkinExtractionResult, type GherkinSyncCheckResult, type GitCheckoutTaskOptions, type GitCheckoutTaskResult, type GovernanceOptions, type GovernanceResult, type GraphElementsResult, type GraphNodeLayer, type GraphNodeStatus, type GraphNodeType, type HookInstallResult, type InitProjectOptions, type InitProjectResult, type JsonSchemaRule, KPI_SUMMARY_END_TAG, KPI_SUMMARY_START_TAG, type LicensePolicy, type LicenseVerificationOptions, type LicenseVerificationResult, type LicenseViolation, type ModelDefectStats, OpenSpecAdapter, PREPARE_COMMIT_MSG_SCRIPT, PROMPT_INJECTION_SIGNATURES, PROTECTED_BYPASS_PATTERNS, type PdacDrift, type PdacGraphOptions, type PdacGraphResult, type PdacNode, type PdacSyncDetail, type PdacSyncOptions, type PdacSyncResult, type PrKpiAggregation, type PreflightCheckOptions, type PreflightCheckResult, type PreflightGateSummary, type ProductHandoff, type ProductHandoffSubgraph, type ProgressiveFrictionOptions, type ProgressiveFrictionResult, type PromptInjectionFinding, type QualityGateOptions, type QualityGateResult, type QualityPolicy, type QualityReportOptions, type QualityReportResult, type QualityThresholds, type ReleaseKpiReport, type RequirementAuditItem, type ResolvedCiEnv, SAST_RULES, SECRET_RULES, SPECIALIZED_AGENT_TEMPLATES, STARTER_ANTIGRAVITY_MCP, STARTER_ANTIGRAVITY_RULES, STARTER_ARCH_ADR, STARTER_ARCH_ARCHITECTURE_CONSTRAINTS, STARTER_ARCH_COMPONENT, STARTER_ARCH_CONTEXT_AND_SCOPE, STARTER_ARCH_CROSS_CUTTING_CONCEPTS, STARTER_ARCH_DEPLOYMENT_VIEW, STARTER_ARCH_GLOSSARY, STARTER_ARCH_INTRODUCTION_AND_GOALS, STARTER_ARCH_LEVEL_1_WHITEBOX, STARTER_ARCH_QUALITY_REQUIREMENTS, STARTER_ARCH_RISKS_AND_TECHNICAL_DEBT, STARTER_ARCH_RUNTIME_VIEW, STARTER_ARCH_SOLUTION_STRATEGY, STARTER_AZURE_PIPELINES, STARTER_BITBUCKET_PIPELINES, STARTER_CLAUDE_RULES, STARTER_COPILOT_RULES, STARTER_CURSOR_CORE_RULES, STARTER_CURSOR_MCP, STARTER_CURSOR_PRODUCT_RULES, STARTER_CURSOR_QUALITY_RULES, STARTER_GITHUB_CI, STARTER_GITHUB_SDD_INTEGRATE, STARTER_GITLAB_CI, STARTER_LICENSE_POLICY, STARTER_QUALITY_POLICY, STARTER_REQUIREMENT_TEMPLATE, STARTER_TASK_TEMPLATE, STARTER_VSCODE_MCP, STARTER_WORKFLOW_HANDOFF_TEMPLATE, type SastFindingType, type SastRule, type SastSeverity, type SastVerifierOptions, type SastVerifierResult, type SastViolation, type SbomGenerateOptions, type ScaTool, type ScanOptions, type ScannedDependency, type ScannedRequirement, type SddAdapter, type SddChangeScaffoldOptions, type SddChangeScaffoldResult, type SddDepositOptions, type SddFramework, type SddIntegrationAudit, type SddIntegrationOptions, type SddIntegrationResult, type SddValidationResult, type SddWorkspaceInfo, type SecretFindingType, type SecretRule, type SecretVerifierOptions, type SecretVerifierResult, type SecretViolation, type SpecCatalogScope, SpecKitAdapter, type SpecializedAgentTemplate, type SupportedCiProvider, TYPE_TO_SCHEMA_MAP, type TaskAuditItem, type TaskItem, type TaskLocateResult, type TaskSummary, type TaskVerification, type TestingCoverageOptions, type TestingCoverageResult, type TraceabilityOptions, type TraceabilityResult, type TraceabilityRow, VALID_AGENT_TARGETS, VALID_ARCHITECTURE_GRANULARITIES, VALID_AUTONOMY_MODES, VALID_CHANGE_PROFILES, VALID_CI_PROVIDERS, aggregatePrKpis, aggregateReleaseKpis, appendRevisionHistoryRow, buildCycloneDxComponent, buildFeatureFileContent, buildGraphElements, calculateJaccardSimilarity, calculateMetrics, calculateRating, calculateShannonEntropy, checkGherkinInSync, checkoutTaskBranch, classifyBranch, collectAgentFiles, collectDashboardMetrics, collectHistoricalKpis, computeCanonicalSha256, computeSha256, createDefaultQualityPolicy, depositProductHandoffSidecar, detectActiveChangeForIntegration, detectAuthorIdentity, detectLanguage, detectProfileFromChange, detectPromptInjection, emitCiOutput, evaluateCompoundLicense, evaluateSingleDependency, extractCitations, extractCommitKpisFromRange, extractDirectDepNames, extractFeatureTags, extractFrontmatter, extractFunctions, extractFunctionsBraceLanguages, extractFunctionsPolyglot, extractFunctionsPython, extractFunctionsTypeScriptAst, extractGherkinBlock, extractGherkinFeatures, extractNormativeText, findChangeWorkspaceDir, findLicenseFile, formatCommitTrailers, formatPrKpiMarkdown, formatReleaseKpiMarkdown, generateBranchHierarchyPlan, generateCycloneDxSbom, generateDashboardReport, generateDuplicatesReportMarkdown, generateGovernanceReportMarkdown, generateLicenseReportMarkdown, generatePdacReportMarkdown, generateQualityReport, generateSastReportMarkdown, generateSecretsReportMarkdown, generateTestingCoverageReportMarkdown, generateThirdPartyNotices, generateTraceabilityReportMarkdown, getArchitectureTemplates, getCytoscapeScript, getGitDiffLines, getNextCorrelativeNumber, getSddAdapter, inferArtifactTypeFromId, inferMissingTrailers, initProject, injectKpisIntoPrBody, installGitHooks, integrateSddChange, isGitleaksInstalled, isPathProtectedFromPatch, isPlaceholderOrIgnored, isRequirementArtifact, isSemgrepInstalled, isToolAvailable, loadProductHandoffSidecar, locateTaskInActiveChanges, maskSecret, normalizeSpdxLicense, parseCommitTrailers, parseFrontmatter, parseFrontmatterId, parseGenericDoc, parseLicensePolicy, parseMarkdownFrontmatter, parseQualityPolicy, parseRequirementFile, parseSpecCatalogScope, parseTasksDoc, parseTasksFromContent, processPackageDir, readCodeCoverageSummary, readPackageJson, renderAntigravityAgentFile, renderClaudeAgentFile, renderCopilotAgentFile, renderCursorAgentFile, renderDashboardHtml, resolveAgentTargets, resolveBranchHierarchy, resolveCiEnvironment, resolveCytoscapePath, resolveFeatureFilePath, resolveLicenseFromFile, resolveSchemaForArtifact, resolveTargetFiles, runGitleaksCli, runSemgrepCli, scaffoldSddChange, scanAllProductHandoffs, scanAllTestArtifacts, scanContentForSecrets, scanFileForSast, scanInstalledLicenses, scanPnpmStore, scanSubdirectories, scanWithNativeFs, scanWithSyft, scanWithTrivy, slugify, syncPdacDigests, tokenizeTitle, updateCitationsInContent, validateAgainstSchema, validateArtifactSchema, verifyArtifactDuplicates, verifyArtifactsSchemas, verifyLicenses, verifyPdacGraph, verifyProgressiveFriction, verifyQualityGate, verifySast, verifySddIntegration, verifySecrets, verifyTasksGovernance, verifyTestingCoverage, verifyTraceability, walkDir, walkMdFiles, walkProjectFiles, walkSourceFiles, walkTaskFiles, writeCycloneDxSbom, writeReleaseKpiReport, writeThirdPartyNotices };
+export { ALL_ARCHITECTURE_TEMPLATES, type ActiveTaskMatch, type AgentTarget, type AnalysisResult, type ArchTemplateDef, type ArchitectureGranularity, type ArtifactFrontmatter, type ArtifactSchemaOptions, type ArtifactSchemaResult, type ArtifactSchemaViolation, type ArtifactValidationResult, type AuthorIdentity, type AuthorKpiSummary, type AutonomyMode, BRANCH_PATTERNS, type BranchClassificationResult, type BranchHierarchyPlan, type BranchValidationError, type BranchValidationSuccess, type BugRecordSummary, type ChangeDetectionOptions, type ChangeDetectionResult, type ChangeProfile, type CiProvider, type CodeCoverageSummary, type CommitKpiRecord, type CommitTrailers, type CycloneDxBom, type CycloneDxComponent, type CycloneDxLicense, type CytoscapeEdgeData, type CytoscapeElement, type CytoscapeNodeData, DEFAULT_EXCLUDED_PATTERNS, DEFAULT_EXCLUDES, DEFAULT_EXTENSIONS, DEFAULT_SAST_EXCLUDES, type DashboardHistoricalKpi, type DashboardOptions, type DashboardResult, type DiffLineItem, type DuplicateIssue, type DuplicateIssueType, type DuplicateSeverity, type DuplicateVerifierOptions, type DuplicateVerifierResult, type ExtractedFeature, type FunctionMetrics, GENERAL_SOURCE_EXTENSIONS, type GherkinExtractionOptions, type GherkinExtractionResult, type GherkinSyncCheckResult, type GitCheckoutTaskOptions, type GitCheckoutTaskResult, type GovernanceOptions, type GovernanceResult, type GraphElementsResult, type GraphNodeLayer, type GraphNodeStatus, type GraphNodeType, type HookInstallResult, type InitProjectOptions, type InitProjectResult, type JsonSchemaRule, KPI_SUMMARY_END_TAG, KPI_SUMMARY_START_TAG, type LicensePolicy, type LicenseVerificationOptions, type LicenseVerificationResult, type LicenseViolation, type ManualDocumentItem, type ManualsCoverageSummary, type ManualsVerificationOptions, type ManualsVerificationResult, type ModelDefectStats, OpenSpecAdapter, PREPARE_COMMIT_MSG_SCRIPT, PROMPT_INJECTION_SIGNATURES, PROTECTED_BYPASS_PATTERNS, type PackageJsonInfo, type PdacDrift, type PdacGraphOptions, type PdacGraphResult, type PdacNode, type PdacSyncDetail, type PdacSyncOptions, type PdacSyncResult, type PrKpiAggregation, type PreflightCheckOptions, type PreflightCheckResult, type PreflightGateSummary, type ProductHandoff, type ProductHandoffSubgraph, type ProgressiveFrictionOptions, type ProgressiveFrictionResult, type PromptInjectionFinding, type QualityGateOptions, type QualityGateResult, type QualityPolicy, type QualityReportOptions, type QualityReportResult, type QualityThresholds, type ReleaseKpiReport, type RequirementAuditItem, type ResolvedCiEnv, SAST_RULES, SECRET_RULES, SPECIALIZED_AGENT_TEMPLATES, STARTER_ANTIGRAVITY_MCP, STARTER_ANTIGRAVITY_RULES, STARTER_ARCH_ADR, STARTER_ARCH_ARCHITECTURE_CONSTRAINTS, STARTER_ARCH_COMPONENT, STARTER_ARCH_CONTEXT_AND_SCOPE, STARTER_ARCH_CROSS_CUTTING_CONCEPTS, STARTER_ARCH_DEPLOYMENT_VIEW, STARTER_ARCH_GLOSSARY, STARTER_ARCH_INTRODUCTION_AND_GOALS, STARTER_ARCH_LEVEL_1_WHITEBOX, STARTER_ARCH_QUALITY_REQUIREMENTS, STARTER_ARCH_RISKS_AND_TECHNICAL_DEBT, STARTER_ARCH_RUNTIME_VIEW, STARTER_ARCH_SOLUTION_STRATEGY, STARTER_AZURE_PIPELINES, STARTER_BITBUCKET_PIPELINES, STARTER_CLAUDE_RULES, STARTER_COPILOT_RULES, STARTER_CURSOR_CORE_RULES, STARTER_CURSOR_MCP, STARTER_CURSOR_PRODUCT_RULES, STARTER_CURSOR_QUALITY_RULES, STARTER_GITHUB_CI, STARTER_GITHUB_SDD_INTEGRATE, STARTER_GITLAB_CI, STARTER_LICENSE_POLICY, STARTER_QUALITY_POLICY, STARTER_REQUIREMENT_TEMPLATE, STARTER_TASK_TEMPLATE, STARTER_VSCODE_MCP, STARTER_WORKFLOW_HANDOFF_TEMPLATE, type SastFindingType, type SastRule, type SastSeverity, type SastVerifierOptions, type SastVerifierResult, type SastViolation, type SbomGenerateOptions, type ScaTool, type ScanOptions, type ScannedDependency, type ScannedRequirement, type SddAdapter, type SddChangeScaffoldOptions, type SddChangeScaffoldResult, type SddDepositOptions, type SddFramework, type SddIntegrationAudit, type SddIntegrationOptions, type SddIntegrationResult, type SddValidationResult, type SddWorkspaceInfo, type SecretFindingType, type SecretRule, type SecretVerifierOptions, type SecretVerifierResult, type SecretViolation, type SpecCatalogScope, SpecKitAdapter, type SpecializedAgentTemplate, type SupportedCiProvider, TYPE_TO_SCHEMA_MAP, type TaskAuditItem, type TaskItem, type TaskLocateResult, type TaskSummary, type TaskVerification, type TestingCoverageOptions, type TestingCoverageResult, type TraceabilityOptions, type TraceabilityResult, type TraceabilityRow, VALID_AGENT_TARGETS, VALID_ARCHITECTURE_GRANULARITIES, VALID_AUTONOMY_MODES, VALID_CHANGE_PROFILES, VALID_CI_PROVIDERS, aggregateCommitKpiRecords, aggregatePrKpis, aggregateReleaseKpis, appendRevisionHistoryRow, buildCycloneDxComponent, buildFeatureFileContent, buildGraphElements, calculateJaccardSimilarity, calculateMetrics, calculateRating, calculateShannonEntropy, checkGherkinInSync, checkoutTaskBranch, classifyBranch, collectAgentFiles, collectDashboardMetrics, collectHistoricalKpis, computeCanonicalSha256, computeSha256, createDefaultQualityPolicy, depositProductHandoffSidecar, detectActiveChangeForIntegration, detectAuthorIdentity, detectLanguage, detectProfileFromChange, detectPromptInjection, emitCiOutput, evaluateCompoundLicense, evaluateSingleDependency, extractCitations, extractCommitKpisFromRange, extractDirectDepNames, extractFeatureTags, extractFrontmatter, extractFunctions, extractFunctionsBraceLanguages, extractFunctionsPolyglot, extractFunctionsPython, extractFunctionsTypeScriptAst, extractGherkinBlock, extractGherkinFeatures, extractNormativeText, findChangeWorkspaceDir, findLicenseFile, formatCommitTrailers, formatPrKpiMarkdown, formatReleaseKpiMarkdown, generateBranchHierarchyPlan, generateCycloneDxSbom, generateDashboardReport, generateDuplicatesReportMarkdown, generateGovernanceReportMarkdown, generateLicenseReportMarkdown, generatePdacReportMarkdown, generateQualityReport, generateSastReportMarkdown, generateSecretsReportMarkdown, generateTestingCoverageReportMarkdown, generateThirdPartyNotices, generateTraceabilityReportMarkdown, getArchitectureTemplates, getCytoscapeScript, getGitDiffLines, getNextCorrelativeNumber, getSddAdapter, inferArtifactTypeFromId, inferMissingTrailers, initProject, injectKpisIntoPrBody, installGitHooks, integrateSddChange, isGitleaksInstalled, isPathProtectedFromPatch, isPlaceholderOrIgnored, isRequirementArtifact, isSemgrepInstalled, isToolAvailable, loadProductHandoffSidecar, locateTaskInActiveChanges, maskSecret, normalizeSpdxLicense, parseCommitTrailers, parseFrontmatter, parseFrontmatterId, parseGenericDoc, parseLicensePolicy, parseMarkdownFrontmatter, parseQualityPolicy, parseRequirementFile, parseSpecCatalogScope, parseTasksDoc, parseTasksFromContent, processPackageDir, readCodeCoverageSummary, readPackageJson, renderAntigravityAgentFile, renderAutonomyModeSection, renderClaudeAgentFile, renderCopilotAgentFile, renderCursorAgentFile, renderDashboardHtml, renderManualsTab, resolveAgentTargets, resolveBranchHierarchy, resolveCiEnvironment, resolveCytoscapePath, resolveFeatureFilePath, resolveGitRef, resolveLicenseFromFile, resolveSchemaForArtifact, resolveTargetFiles, runGitleaksCli, runSemgrepCli, scaffoldSddChange, scanAllProductHandoffs, scanAllTestArtifacts, scanContentForSecrets, scanFileForSast, scanInstalledLicenses, scanManualsInWorkspace, scanPnpmStore, scanSubdirectories, scanWithNativeFs, scanWithSyft, scanWithTrivy, slugify, syncPdacDigests, tokenizeTitle, updateCitationsInContent, validateAgainstSchema, validateArtifactSchema, verifyArtifactDuplicates, verifyArtifactsSchemas, verifyLicenses, verifyManuals, verifyPdacGraph, verifyProgressiveFriction, verifyQualityGate, verifySast, verifySddIntegration, verifySecrets, verifyTasksGovernance, verifyTestingCoverage, verifyTraceability, walkDir, walkMdFiles, walkProjectFiles, walkSourceFiles, walkTaskFiles, writeCycloneDxSbom, writeReleaseKpiReport, writeThirdPartyNotices };