@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (166) hide show
  1. package/CLAUDE.md +446 -1730
  2. package/README.md +515 -516
  3. package/bin/morph-spec.js +366 -294
  4. package/bin/task-manager.js +429 -368
  5. package/bin/validate.js +369 -268
  6. package/content/.claude/commands/morph-apply.md +221 -158
  7. package/content/.claude/commands/morph-deploy.md +529 -0
  8. package/content/.claude/commands/morph-preflight.md +227 -0
  9. package/content/.claude/commands/morph-proposal.md +122 -101
  10. package/content/.claude/commands/morph-status.md +86 -86
  11. package/content/.claude/commands/morph-troubleshoot.md +122 -0
  12. package/content/.claude/skills/infra/azure-deploy-specialist.md +699 -0
  13. package/content/.claude/skills/level-0-meta/README.md +7 -0
  14. package/content/.claude/skills/level-0-meta/code-review.md +226 -0
  15. package/content/.claude/skills/level-0-meta/morph-checklist.md +117 -0
  16. package/content/.claude/skills/level-0-meta/simulation-checklist.md +77 -0
  17. package/content/.claude/skills/level-1-workflows/README.md +7 -0
  18. package/content/.claude/skills/level-1-workflows/morph-replicate.md +213 -0
  19. package/content/.claude/{commands/morph-clarify.md → skills/level-1-workflows/phase-clarify.md} +131 -184
  20. package/content/.claude/{commands/morph-design.md → skills/level-1-workflows/phase-design.md} +213 -275
  21. package/content/.claude/skills/level-1-workflows/phase-setup.md +106 -0
  22. package/content/.claude/skills/level-1-workflows/phase-tasks.md +164 -0
  23. package/content/.claude/{commands/morph-uiux.md → skills/level-1-workflows/phase-uiux.md} +169 -211
  24. package/content/.claude/skills/level-2-domains/README.md +14 -0
  25. package/content/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +192 -0
  26. package/content/.claude/skills/{specialists → level-2-domains/architecture}/po-pm-advisor.md +197 -197
  27. package/content/.claude/skills/level-2-domains/architecture/standards-architect.md +156 -0
  28. package/content/.claude/skills/level-2-domains/backend/dotnet-senior.md +287 -0
  29. package/content/.claude/skills/level-2-domains/backend/ef-modeler.md +113 -0
  30. package/content/.claude/skills/level-2-domains/backend/hangfire-orchestrator.md +126 -0
  31. package/content/.claude/skills/level-2-domains/backend/ms-agent-expert.md +109 -0
  32. package/content/.claude/skills/level-2-domains/frontend/blazor-builder.md +210 -0
  33. package/content/.claude/skills/level-2-domains/frontend/nextjs-expert.md +154 -0
  34. package/content/.claude/skills/level-2-domains/frontend/ui-ux-designer.md +191 -0
  35. package/content/.claude/skills/{specialists → level-2-domains/infrastructure}/azure-architect.md +142 -142
  36. package/content/.claude/skills/level-2-domains/infrastructure/bicep-architect.md +126 -0
  37. package/content/.claude/skills/level-2-domains/infrastructure/container-specialist.md +131 -0
  38. package/content/.claude/skills/level-2-domains/infrastructure/devops-engineer.md +119 -0
  39. package/content/.claude/skills/level-2-domains/integrations/asaas-financial.md +130 -0
  40. package/content/.claude/skills/level-2-domains/integrations/azure-identity.md +142 -0
  41. package/content/.claude/skills/level-2-domains/integrations/clerk-auth.md +108 -0
  42. package/content/.claude/skills/level-2-domains/integrations/resend-email.md +119 -0
  43. package/content/.claude/skills/level-2-domains/quality/code-analyzer.md +235 -0
  44. package/content/.claude/skills/level-2-domains/quality/testing-specialist.md +126 -0
  45. package/content/.claude/skills/level-3-technologies/README.md +7 -0
  46. package/content/.claude/skills/level-4-patterns/README.md +7 -0
  47. package/content/.claude/skills/specialists/prompt-engineer.md +189 -0
  48. package/content/.claude/skills/specialists/seo-growth-hacker.md +320 -0
  49. package/content/.morph/config/agents.json +762 -242
  50. package/content/.morph/config/config.template.json +122 -108
  51. package/content/.morph/docs/workflows/design-impl.md +37 -0
  52. package/content/.morph/docs/workflows/enforcement-pipeline.md +668 -0
  53. package/content/.morph/docs/workflows/fast-track.md +29 -0
  54. package/content/.morph/docs/workflows/full-morph.md +76 -0
  55. package/content/.morph/docs/workflows/standard.md +44 -0
  56. package/content/.morph/docs/workflows/ui-refresh.md +39 -0
  57. package/content/.morph/examples/scheduled-reports/decisions.md +158 -0
  58. package/content/.morph/examples/scheduled-reports/proposal.md +95 -0
  59. package/content/.morph/examples/scheduled-reports/spec.md +267 -0
  60. package/content/.morph/hooks/README.md +348 -239
  61. package/content/.morph/hooks/pre-commit-agents.sh +24 -24
  62. package/content/.morph/hooks/task-completed.js +73 -0
  63. package/content/.morph/hooks/teammate-idle.js +68 -0
  64. package/content/.morph/schemas/tasks.schema.json +220 -0
  65. package/content/.morph/standards/agent-framework-blazor-ui.md +359 -0
  66. package/content/.morph/standards/agent-framework-production.md +410 -0
  67. package/content/.morph/standards/agent-framework-setup.md +413 -453
  68. package/content/.morph/standards/agent-framework-workflows.md +349 -0
  69. package/content/.morph/standards/agent-teams-workflow.md +474 -0
  70. package/content/.morph/standards/architecture.md +325 -325
  71. package/content/.morph/standards/azure.md +605 -379
  72. package/content/.morph/standards/dotnet10-migration.md +520 -494
  73. package/content/.morph/templates/CONTEXT-FEATURE.md +276 -0
  74. package/content/.morph/templates/CONTEXT.md +170 -0
  75. package/content/.morph/templates/agent.cs +163 -172
  76. package/content/.morph/templates/clarify-questions.md +159 -0
  77. package/content/.morph/templates/contracts/Commands.cs +74 -0
  78. package/content/.morph/templates/contracts/Entities.cs +25 -0
  79. package/content/.morph/templates/contracts/Queries.cs +74 -0
  80. package/content/.morph/templates/contracts/README.md +74 -0
  81. package/content/.morph/templates/decisions.md +123 -106
  82. package/content/.morph/templates/infra/azure-pipelines-deploy.yml +480 -0
  83. package/content/.morph/templates/infra/deploy-checklist.md +426 -0
  84. package/content/.morph/templates/proposal.md +141 -155
  85. package/content/.morph/templates/recap.md +94 -105
  86. package/content/.morph/templates/simulation.md +353 -0
  87. package/content/.morph/templates/spec.md +149 -148
  88. package/content/.morph/templates/state.template.json +222 -222
  89. package/content/.morph/templates/tasks.md +257 -235
  90. package/content/.morph/templates/ui-components.md +362 -276
  91. package/content/CLAUDE.md +150 -442
  92. package/detectors/structure-detector.js +245 -250
  93. package/docs/README.md +144 -149
  94. package/docs/getting-started.md +301 -302
  95. package/docs/installation.md +361 -361
  96. package/docs/validation-checklist.md +265 -266
  97. package/package.json +80 -80
  98. package/src/commands/advance-phase.js +266 -0
  99. package/src/commands/analyze-blazor-concurrency.js +193 -0
  100. package/src/commands/deploy.js +780 -0
  101. package/src/commands/detect-agents.js +167 -0
  102. package/src/commands/doctor.js +356 -280
  103. package/src/commands/generate-context.js +40 -0
  104. package/src/commands/init.js +258 -245
  105. package/src/commands/lint-fluent.js +352 -0
  106. package/src/commands/rollback-phase.js +185 -0
  107. package/src/commands/session-summary.js +291 -0
  108. package/src/commands/task.js +78 -75
  109. package/src/commands/troubleshoot.js +222 -0
  110. package/src/commands/update.js +192 -159
  111. package/src/commands/validate-blazor-state.js +210 -0
  112. package/src/commands/validate-blazor.js +156 -0
  113. package/src/commands/validate-css.js +84 -0
  114. package/src/commands/validate-phase.js +221 -0
  115. package/src/lib/blazor-concurrency-analyzer.js +288 -0
  116. package/src/lib/blazor-state-validator.js +291 -0
  117. package/src/lib/blazor-validator.js +374 -0
  118. package/src/lib/complexity-analyzer.js +441 -292
  119. package/src/lib/context-generator.js +513 -0
  120. package/src/lib/continuous-validator.js +421 -440
  121. package/src/lib/css-validator.js +352 -0
  122. package/src/lib/decision-constraint-loader.js +109 -0
  123. package/src/lib/design-system-detector.js +187 -0
  124. package/src/lib/design-system-scaffolder.js +299 -0
  125. package/src/lib/hook-executor.js +256 -0
  126. package/src/lib/recap-generator.js +205 -0
  127. package/src/lib/spec-validator.js +258 -0
  128. package/src/lib/standards-context-injector.js +287 -0
  129. package/src/lib/state-manager.js +397 -340
  130. package/src/lib/team-orchestrator.js +322 -0
  131. package/src/lib/troubleshoot-grep.js +194 -0
  132. package/src/lib/troubleshoot-index.js +144 -0
  133. package/src/lib/validation-runner.js +283 -0
  134. package/src/lib/validators/contract-compliance-validator.js +273 -0
  135. package/src/lib/validators/design-system-validator.js +231 -0
  136. package/src/utils/file-copier.js +187 -139
  137. package/content/.claude/commands/morph-costs.md +0 -206
  138. package/content/.claude/commands/morph-setup.md +0 -100
  139. package/content/.claude/commands/morph-tasks.md +0 -319
  140. package/content/.claude/skills/infra/bicep-architect.md +0 -419
  141. package/content/.claude/skills/infra/container-specialist.md +0 -437
  142. package/content/.claude/skills/infra/devops-engineer.md +0 -405
  143. package/content/.claude/skills/integrations/asaas-financial.md +0 -333
  144. package/content/.claude/skills/integrations/azure-identity.md +0 -309
  145. package/content/.claude/skills/integrations/clerk-auth.md +0 -290
  146. package/content/.claude/skills/specialists/ai-system-architect.md +0 -604
  147. package/content/.claude/skills/specialists/cost-guardian.md +0 -110
  148. package/content/.claude/skills/specialists/ef-modeler.md +0 -211
  149. package/content/.claude/skills/specialists/hangfire-orchestrator.md +0 -255
  150. package/content/.claude/skills/specialists/ms-agent-expert.md +0 -263
  151. package/content/.claude/skills/specialists/standards-architect.md +0 -78
  152. package/content/.claude/skills/specialists/ui-ux-designer.md +0 -1100
  153. package/content/.claude/skills/stacks/dotnet-blazor.md +0 -606
  154. package/content/.claude/skills/stacks/dotnet-nextjs.md +0 -402
  155. package/content/.claude/skills/stacks/shopify.md +0 -445
  156. package/content/.morph/config/azure-pricing.json +0 -70
  157. package/content/.morph/config/azure-pricing.schema.json +0 -50
  158. package/content/.morph/hooks/pre-commit-costs.sh +0 -91
  159. package/docs/api/cost-calculator.js.html +0 -513
  160. package/docs/api/design-system-generator.js.html +0 -382
  161. package/docs/api/global.html +0 -5263
  162. package/docs/api/index.html +0 -96
  163. package/docs/api/state-manager.js.html +0 -423
  164. package/src/commands/cost.js +0 -181
  165. package/src/commands/update-pricing.js +0 -206
  166. package/src/lib/cost-calculator.js +0 -429
package/docs/api/cost-calculator.js.html DELETED
@@ -1,513 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
-
5
- <meta charset="utf-8">
6
- <title>cost-calculator.js - MORPH-SPEC API Documentation</title>
7
-
8
- <meta name="description" content="API documentation for MORPH-SPEC Framework libraries" />
9
-
10
- <meta name="keywords" content="morph-spec, api, documentation, blazor, dotnet, framework" />
11
- <meta name="keyword" content="morph-spec, api, documentation, blazor, dotnet, framework" />
12
-
13
-
14
-
15
- <script src="scripts/prettify/prettify.js"></script>
16
- <script src="scripts/prettify/lang-css.js"></script>
17
- <!--[if lt IE 9]>
18
- <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
19
- <![endif]-->
20
- <link type="text/css" rel="stylesheet" href="styles/prettify.css">
21
- <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
22
- <script src="scripts/nav.js" defer></script>
23
-
24
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
25
- </head>
26
- <body>
27
-
28
- <input type="checkbox" id="nav-trigger" class="nav-trigger" />
29
- <label for="nav-trigger" class="navicon-button x">
30
- <div class="navicon"></div>
31
- </label>
32
-
33
- <label for="nav-trigger" class="overlay"></label>
34
-
35
- <nav >
36
-
37
- <input type="text" id="nav-search" placeholder="Search" />
38
-
39
-
40
- <h2><a href="index.html">Home</a></h2><h2><a href="https://github.com/lucasPolymorphism/morph-spec-framework" target="_blank" class="menu-item" id="repository" >GitHub</a></h2><h2><a href="https://www.npmjs.com/package/@polymorphism-tech/morph-spec" target="_blank" class="menu-item" id="npm" >npm</a></h2><h3>Global</h3><ul><li><a href="global.html#AZURE_PRICING">AZURE_PRICING</a></li><li><a href="global.html#addAgent">addAgent</a></li><li><a href="global.html#addCheckpoint">addCheckpoint</a></li><li><a href="global.html#calculateBicepCost">calculateBicepCost</a></li><li><a href="global.html#calculateResourceCost">calculateResourceCost</a></li><li><a href="global.html#calculateTotalCosts">calculateTotalCosts</a></li><li><a href="global.html#ensureFeature">ensureFeature</a></li><li><a href="global.html#generateCSS">generateCSS</a></li><li><a href="global.html#generateDesignSystem">generateDesignSystem</a></li><li><a href="global.html#generateFluentTheme">generateFluentTheme</a></li><li><a href="global.html#generateMudTheme">generateMudTheme</a></li><li><a href="global.html#getFeature">getFeature</a></li><li><a href="global.html#getStatePath">getStatePath</a></li><li><a href="global.html#getSummary">getSummary</a></li><li><a href="global.html#initState">initState</a></li><li><a href="global.html#listFeatures">listFeatures</a></li><li><a href="global.html#loadAzurePricing">loadAzurePricing</a></li><li><a href="global.html#loadCostConfig">loadCostConfig</a></li><li><a href="global.html#loadState">loadState</a></li><li><a href="global.html#markOutput">markOutput</a></li><li><a href="global.html#parseBicepFile">parseBicepFile</a></li><li><a href="global.html#parseBicepFiles">parseBicepFiles</a></li><li><a href="global.html#parseColors">parseColors</a></li><li><a href="global.html#parseDesignSystem">parseDesignSystem</a></li><li><a href="global.html#parseSpacing">parseSpacing</a></li><li><a href="global.html#parseTypography">parseTypography</a></li><li><a href="global.html#removeAgent">removeAgent</a></li><li><a href="global.html#saveState">saveState</a></li><li><a href="global.html#stateExists">stateExists</a></li><li><a href="global.html#updateFeature">updateFeature</a></li><li><a href="global.html#updateFeatureMultiple">updateFeatureMultiple</a></li></ul>
41
-
42
- </nav>
43
-
44
- <div id="main">
45
-
46
- <h1 class="page-title">cost-calculator.js</h1>
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
- <section>
55
- <article>
56
- <pre class="prettyprint source linenums"><code>/**
57
- * MORPH-SPEC Cost Calculator Library
58
- *
59
- * Calculates Azure infrastructure costs from Bicep files.
60
- * Used both by CLI commands and internal automation.
61
- */
62
-
63
- import { readFileSync, existsSync } from 'fs';
64
- import { join, dirname } from 'path';
65
- import { globSync } from 'glob';
66
- import { fileURLToPath } from 'url';
67
-
68
- const __filename = fileURLToPath(import.meta.url);
69
- const __dirname = dirname(__filename);
70
-
71
- // ============================================================================
72
- // PRICING TABLE LOADER
73
- // ============================================================================
74
-
75
- /**
76
- * Load Azure pricing from JSON file
77
- * @param {string} pricingPath - Optional custom pricing file path
78
- * @returns {Object} Pricing table
79
- */
80
- export function loadAzurePricing(pricingPath = null) {
81
- const defaultPath = join(__dirname, '..', '..', 'content', '.morph', 'config', 'azure-pricing.json');
82
- const pathToTry = pricingPath || defaultPath;
83
-
84
- if (!existsSync(pathToTry)) {
85
- // Fallback to hardcoded pricing (backwards compatibility)
86
- return AZURE_PRICING_FALLBACK;
87
- }
88
-
89
- try {
90
- const content = readFileSync(pathToTry, 'utf8');
91
- const pricingData = JSON.parse(content);
92
- return pricingData.resources || {};
93
- } catch (err) {
94
- console.warn(`Warning: Could not load pricing from ${pathToTry}: ${err.message}`);
95
- return AZURE_PRICING_FALLBACK;
96
- }
97
- }
98
-
99
- /**
100
- * Fallback pricing table (hardcoded for backwards compatibility)
101
- * @private
102
- */
103
- const AZURE_PRICING_FALLBACK = {
104
- // Azure SQL Database
105
- 'Microsoft.Sql/servers/databases': {
106
- 'Free': 0,
107
- 'Basic': 4.99,
108
- 'S0': 14.72,
109
- 'S1': 29.44,
110
- 'S2': 73.61,
111
- 'S3': 147.22,
112
- 'S4': 294.44,
113
- 'P1': 465.00,
114
- 'P2': 930.00,
115
- 'GP_Gen5_2': 328.00,
116
- 'GP_Gen5_4': 656.00,
117
- 'BC_Gen5_2': 1092.00,
118
- },
119
-
120
- // Azure Container Apps
121
- 'Microsoft.App/containerApps': {
122
- 'Consumption': 0,
123
- 'Consumption_Active': 5.00,
124
- 'Dedicated_D2': 55.00,
125
- 'Dedicated_D4': 110.00,
126
- },
127
-
128
- // Azure Storage Account
129
- 'Microsoft.Storage/storageAccounts': {
130
- 'Standard_LRS': 0.02,
131
- 'Standard_GRS': 0.05,
132
- 'Premium_LRS': 0.15,
133
- },
134
-
135
- // Azure Application Insights
136
- 'Microsoft.Insights/components': {
137
- 'Free': 0,
138
- 'Basic': 2.30,
139
- },
140
-
141
- // Azure Key Vault
142
- 'Microsoft.KeyVault/vaults': {
143
- 'Standard': 0.03,
144
- 'Premium': 1.00,
145
- },
146
-
147
- // Azure Cosmos DB
148
- 'Microsoft.DocumentDB/databaseAccounts': {
149
- 'Serverless': 0,
150
- 'Provisioned_400RU': 23.36,
151
- 'Provisioned_1000RU': 58.40,
152
- },
153
-
154
- // Azure App Service
155
- 'Microsoft.Web/serverfarms': {
156
- 'F1': 0,
157
- 'D1': 9.67,
158
- 'B1': 13.14,
159
- 'B2': 26.28,
160
- 'S1': 69.35,
161
- 'P1v2': 146.00,
162
- },
163
-
164
- // Azure Service Bus
165
- 'Microsoft.ServiceBus/namespaces': {
166
- 'Basic': 0.05,
167
- 'Standard': 10.00,
168
- 'Premium': 677.00,
169
- },
170
-
171
- // Azure Redis Cache
172
- 'Microsoft.Cache/redis': {
173
- 'C0': 16.06,
174
- 'C1': 61.32,
175
- 'C2': 122.63,
176
- 'P1': 486.00,
177
- },
178
-
179
- // Azure Functions (Consumption Plan)
180
- 'Microsoft.Web/sites': {
181
- 'Consumption': 0,
182
- 'Premium_EP1': 146.00,
183
- }
184
- };
185
-
186
- // ============================================================================
187
- // PRICING TABLE - Azure (East US 2 / Brazil South)
188
- // ============================================================================
189
-
190
- /**
191
- * Azure pricing table (loaded from JSON)
192
- * @deprecated Use loadAzurePricing() for custom pricing paths
193
- */
194
- export const AZURE_PRICING = loadAzurePricing();
195
-
196
- // ============================================================================
197
- // DEFAULT CONFIGURATION
198
- // ============================================================================
199
-
200
- export const DEFAULT_LIMITS = {
201
- freeTierOnly: 0,
202
- withApproval: 10,
203
- requiresADR: 10
204
- };
205
-
206
- // ============================================================================
207
- // CONFIGURATION LOADER
208
- // ============================================================================
209
-
210
- /**
211
- * Load cost configuration from config.json
212
- * @param {string} configPath - Optional custom config path
213
- * @returns {Object} Cost configuration
214
- */
215
- export function loadCostConfig(configPath = null) {
216
- const defaultPath = join(process.cwd(), '.morph/config/config.json');
217
- const templatePath = join(process.cwd(), 'content/.morph/config/config.template.json');
218
-
219
- const pathsToTry = [
220
- configPath,
221
- defaultPath,
222
- templatePath
223
- ].filter(Boolean);
224
-
225
- for (const path of pathsToTry) {
226
- if (existsSync(path)) {
227
- try {
228
- const content = readFileSync(path, 'utf8');
229
- const config = JSON.parse(content);
230
-
231
- if (config.costs &amp;&amp; config.costs.limits) {
232
- return {
233
- limits: config.costs.limits,
234
- enforcement: config.costs.enforcement || {},
235
- currency: config.costs.currency || 'USD',
236
- region: config.costs.pricing?.region || 'eastus2'
237
- };
238
- }
239
- } catch (err) {
240
- // Continue to next path
241
- }
242
- }
243
- }
244
-
245
- // Fallback to defaults
246
- return {
247
- limits: DEFAULT_LIMITS,
248
- enforcement: {
249
- blockCommitsAboveLimit: true,
250
- requireADRInDecisionsMd: true,
251
- alertOnApproach: 0.8
252
- },
253
- currency: 'USD',
254
- region: 'eastus2'
255
- };
256
- }
257
-
258
- // ============================================================================
259
- // BICEP PARSER
260
- // ============================================================================
261
-
262
- /**
263
- * Parse Bicep file and extract resources with SKUs
264
- * @param {string} filePath - Path to Bicep file
265
- * @returns {Array} Array of resource objects
266
- */
267
- export function parseBicepFile(filePath) {
268
- if (!existsSync(filePath)) {
269
- throw new Error(`File not found: ${filePath}`);
270
- }
271
-
272
- const content = readFileSync(filePath, 'utf8');
273
- const resources = [];
274
-
275
- // Regex para extrair resources com conteúdo completo (inclui blocos aninhados)
276
- // Formato: resource &lt;name> '&lt;type>@&lt;apiVersion>' = { ... }
277
- const resourceRegex = /resource\s+(\w+)\s+'([^']+)@[^']+'\s*=\s*\{/g;
278
-
279
- let match;
280
- while ((match = resourceRegex.exec(content)) !== null) {
281
- const [, name, type] = match;
282
- const startIndex = match.index + match[0].length;
283
-
284
- // Encontrar o fechamento do bloco { }
285
- let braceCount = 1;
286
- let endIndex = startIndex;
287
-
288
- while (braceCount > 0 &amp;&amp; endIndex &lt; content.length) {
289
- if (content[endIndex] === '{') braceCount++;
290
- if (content[endIndex] === '}') braceCount--;
291
- endIndex++;
292
- }
293
-
294
- const body = content.substring(startIndex, endIndex - 1);
295
-
296
- // Extrair SKU (dentro de bloco sku: { name: '...' })
297
- const skuBlockMatch = /sku:\s*\{([^}]+)\}/s.exec(body);
298
- let sku = null;
299
-
300
- if (skuBlockMatch) {
301
- const skuBlock = skuBlockMatch[1];
302
- const skuNameMatch = /name:\s*'([^']+)'/s.exec(skuBlock);
303
- sku = skuNameMatch ? skuNameMatch[1] : null;
304
- }
305
-
306
- // Extrair tier (alternativa, fora ou dentro do bloco sku)
307
- if (!sku) {
308
- const tierMatch = /tier:\s*'([^']+)'/s.exec(body);
309
- sku = tierMatch ? tierMatch[1] : null;
310
- }
311
-
312
- // Extrair minReplicas (Container Apps, deep nested)
313
- const minReplicasMatch = /minReplicas:\s*(\d+)/s.exec(body);
314
- const minReplicas = minReplicasMatch ? parseInt(minReplicasMatch[1], 10) : null;
315
-
316
- resources.push({
317
- name,
318
- type,
319
- sku,
320
- minReplicas,
321
- file: filePath
322
- });
323
- }
324
-
325
- return resources;
326
- }
327
-
328
- /**
329
- * Parse multiple Bicep files (supports glob patterns)
330
- * @param {string|Array} patterns - File path(s) or glob pattern(s)
331
- * @returns {Array} Array of all resources
332
- */
333
- export function parseBicepFiles(patterns) {
334
- const patternArray = Array.isArray(patterns) ? patterns : [patterns];
335
- const allResources = [];
336
-
337
- for (const pattern of patternArray) {
338
- // Se for glob pattern, expandir
339
- const files = pattern.includes('*')
340
- ? globSync(pattern, { absolute: true })
341
- : [pattern];
342
-
343
- for (const file of files) {
344
- try {
345
- const resources = parseBicepFile(file);
346
- allResources.push(...resources);
347
- } catch (err) {
348
- // Silently skip files with errors (let caller handle)
349
- console.warn(`Warning: Could not parse ${file}: ${err.message}`);
350
- }
351
- }
352
- }
353
-
354
- return allResources;
355
- }
356
-
357
- // ============================================================================
358
- // COST CALCULATOR
359
- // ============================================================================
360
-
361
- /**
362
- * Calculate cost of a single resource
363
- * @param {Object} resource - Resource object with type, sku, minReplicas
364
- * @returns {Object} Cost result with cost, warning, estimated, details
365
- */
366
- export function calculateResourceCost(resource) {
367
- const pricing = AZURE_PRICING[resource.type];
368
-
369
- if (!pricing) {
370
- return {
371
- cost: 0,
372
- warning: `Unknown resource type: ${resource.type}`,
373
- estimated: false
374
- };
375
- }
376
-
377
- // Special case: Container Apps with minReplicas
378
- if (resource.type === 'Microsoft.App/containerApps') {
379
- const sku = resource.minReplicas > 0 ? 'Consumption_Active' : 'Consumption';
380
- const cost = pricing[sku] || 0;
381
-
382
- return {
383
- cost,
384
- warning: null,
385
- estimated: true,
386
- details: `minReplicas: ${resource.minReplicas}, scale-to-zero: ${resource.minReplicas === 0}`
387
- };
388
- }
389
-
390
- // General case: lookup by SKU
391
- if (resource.sku &amp;&amp; pricing[resource.sku] !== undefined) {
392
- return {
393
- cost: pricing[resource.sku],
394
- warning: null,
395
- estimated: true
396
- };
397
- }
398
-
399
- // SKU not found
400
- return {
401
- cost: 0,
402
- warning: `Unknown SKU '${resource.sku}' for ${resource.type}`,
403
- estimated: false
404
- };
405
- }
406
-
407
- /**
408
- * Calculate total costs of all resources
409
- * @param {Array} resources - Array of resource objects
410
- * @param {Object} costConfig - Cost configuration
411
- * @returns {Object} Cost calculation result
412
- */
413
- export function calculateTotalCosts(resources, costConfig) {
414
- let total = 0;
415
- const breakdown = [];
416
- const warnings = [];
417
-
418
- for (const resource of resources) {
419
- const result = calculateResourceCost(resource);
420
-
421
- total += result.cost;
422
-
423
- breakdown.push({
424
- name: resource.name,
425
- type: resource.type,
426
- sku: resource.sku || 'N/A',
427
- cost: result.cost,
428
- file: resource.file,
429
- estimated: result.estimated,
430
- details: result.details
431
- });
432
-
433
- if (result.warning) {
434
- warnings.push(result.warning);
435
- }
436
-
437
- // Warning para recursos caros
438
- if (result.cost > costConfig.limits.withApproval) {
439
- warnings.push(
440
- `Resource '${resource.name}' (${resource.type} ${resource.sku}) costs $${result.cost.toFixed(2)}/month - exceeds approval threshold!`
441
- );
442
- }
443
- }
444
-
445
- return {
446
- monthly: parseFloat(total.toFixed(2)),
447
- currency: costConfig.currency,
448
- region: costConfig.region,
449
- breakdown,
450
- warnings,
451
- limits: costConfig.limits,
452
- requiresApproval: total > costConfig.limits.freeTierOnly,
453
- requiresADR: total > costConfig.limits.requiresADR,
454
- isFreeTier: total === 0
455
- };
456
- }
457
-
458
- /**
459
- * Calculate costs from Bicep file(s) - Main entry point
460
- * @param {string|Array} bicepFiles - Bicep file path(s) or glob pattern(s)
461
- * @param {Object} options - Options
462
- * @param {string} options.configPath - Optional custom config path
463
- * @returns {Object} Complete cost calculation result
464
- */
465
- export function calculateBicepCost(bicepFiles, options = {}) {
466
- const costConfig = loadCostConfig(options.configPath);
467
- const resources = parseBicepFiles(bicepFiles);
468
-
469
- if (resources.length === 0) {
470
- return {
471
- monthly: 0,
472
- currency: costConfig.currency,
473
- region: costConfig.region,
474
- breakdown: [],
475
- warnings: ['No resources found in Bicep files'],
476
- limits: costConfig.limits,
477
- requiresApproval: false,
478
- requiresADR: false,
479
- isFreeTier: true
480
- };
481
- }
482
-
483
- return calculateTotalCosts(resources, costConfig);
484
- }
485
- </code></pre>
486
- </article>
487
- </section>
488
-
489
-
490
-
491
-
492
-
493
-
494
- </div>
495
-
496
- <br class="clear">
497
-
498
- <footer>
499
- Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
500
- </footer>
501
-
502
- <script>prettyPrint();</script>
503
- <script src="scripts/polyfill.js"></script>
504
- <script src="scripts/linenumber.js"></script>
505
-
506
- <script src="scripts/search.js" defer></script>
507
-
508
-
509
- <script src="scripts/collapse.js" defer></script>
510
-
511
-
512
- </body>
513
- </html>