@arcbridge/core 0.3.0 → 0.3.1

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.
package/dist/index.d.ts CHANGED
@@ -44,7 +44,7 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
44
44
  csproj?: string | undefined;
45
45
  }>, "many">>;
46
46
  platforms: z.ZodDefault<z.ZodArray<z.ZodEnum<["claude", "copilot", "gemini", "codex"]>, "many">>;
47
- quality_priorities: z.ZodDefault<z.ZodArray<z.ZodEnum<["security", "performance", "accessibility", "reliability", "maintainability"]>, "many">>;
47
+ quality_priorities: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
48
48
  indexing: z.ZodDefault<z.ZodObject<{
49
49
  include: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
50
50
  exclude: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -92,11 +92,11 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
92
92
  }, "strip", z.ZodTypeAny, {
93
93
  auto_detect_drift: boolean;
94
94
  drift_severity_threshold: "info" | "warning" | "error";
95
- propose_updates_on: "session-end" | "phase-complete" | "manual";
95
+ propose_updates_on: "manual" | "session-end" | "phase-complete";
96
96
  }, {
97
97
  auto_detect_drift?: boolean | undefined;
98
98
  drift_severity_threshold?: "info" | "warning" | "error" | undefined;
99
- propose_updates_on?: "session-end" | "phase-complete" | "manual" | undefined;
99
+ propose_updates_on?: "manual" | "session-end" | "phase-complete" | undefined;
100
100
  }>>;
101
101
  }, "strip", z.ZodTypeAny, {
102
102
  schema_version: 1;
@@ -110,7 +110,7 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
110
110
  csproj?: string | undefined;
111
111
  }[];
112
112
  platforms: ("claude" | "copilot" | "gemini" | "codex")[];
113
- quality_priorities: ("security" | "performance" | "accessibility" | "reliability" | "maintainability")[];
113
+ quality_priorities: string[];
114
114
  indexing: {
115
115
  include: string[];
116
116
  exclude: string[];
@@ -130,7 +130,7 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
130
130
  sync: {
131
131
  auto_detect_drift: boolean;
132
132
  drift_severity_threshold: "info" | "warning" | "error";
133
- propose_updates_on: "session-end" | "phase-complete" | "manual";
133
+ propose_updates_on: "manual" | "session-end" | "phase-complete";
134
134
  };
135
135
  }, {
136
136
  project_name: string;
@@ -144,7 +144,7 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
144
144
  csproj?: string | undefined;
145
145
  }[] | undefined;
146
146
  platforms?: ("claude" | "copilot" | "gemini" | "codex")[] | undefined;
147
- quality_priorities?: ("security" | "performance" | "accessibility" | "reliability" | "maintainability")[] | undefined;
147
+ quality_priorities?: string[] | undefined;
148
148
  indexing?: {
149
149
  include?: string[] | undefined;
150
150
  exclude?: string[] | undefined;
@@ -164,19 +164,28 @@ declare const ArcBridgeConfigSchema: z.ZodObject<{
164
164
  sync?: {
165
165
  auto_detect_drift?: boolean | undefined;
166
166
  drift_severity_threshold?: "info" | "warning" | "error" | undefined;
167
- propose_updates_on?: "session-end" | "phase-complete" | "manual" | undefined;
167
+ propose_updates_on?: "manual" | "session-end" | "phase-complete" | undefined;
168
168
  } | undefined;
169
169
  }>;
170
170
  type ArcBridgeConfig = z.infer<typeof ArcBridgeConfigSchema>;
171
171
  type Service = z.infer<typeof ServiceSchema>;
172
172
 
173
- declare const QualityCategorySchema: z.ZodEnum<["security", "performance", "accessibility", "reliability", "maintainability"]>;
173
+ /**
174
+ * Quality categories. Accepts any lowercase kebab-case string for extensibility.
175
+ * Common categories (inspired by ISO/IEC 25010): reliability, usability, security,
176
+ * maintainability, portability, compatibility, performance, and accessibility
177
+ * (often a sub-characteristic of usability, but commonly tracked separately).
178
+ * Projects can define custom categories like: data-integrity, compliance, auditability.
179
+ */
180
+ declare const QualityCategorySchema: z.ZodString;
181
+ /** Description for quality_priorities fields — reused in config schema and MCP tools */
182
+ declare const QUALITY_PRIORITIES_DESCRIPTION: string;
174
183
  declare const QualityPrioritySchema: z.ZodEnum<["must", "should", "could"]>;
175
184
  declare const QualityScenarioStatusSchema: z.ZodEnum<["passing", "failing", "untested", "partial"]>;
176
185
  declare const QualityScenarioSchema: z.ZodObject<{
177
186
  id: z.ZodString;
178
187
  name: z.ZodString;
179
- category: z.ZodEnum<["security", "performance", "accessibility", "reliability", "maintainability"]>;
188
+ category: z.ZodString;
180
189
  priority: z.ZodEnum<["must", "should", "could"]>;
181
190
  scenario: z.ZodString;
182
191
  expected: z.ZodString;
@@ -186,25 +195,25 @@ declare const QualityScenarioSchema: z.ZodObject<{
186
195
  verification: z.ZodEnum<["automatic", "manual", "semi-automatic"]>;
187
196
  status: z.ZodDefault<z.ZodEnum<["passing", "failing", "untested", "partial"]>>;
188
197
  }, "strip", z.ZodTypeAny, {
189
- name: string;
190
- status: "passing" | "failing" | "untested" | "partial";
191
- expected: string;
192
198
  id: string;
193
- category: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
199
+ name: string;
200
+ category: string;
194
201
  priority: "must" | "should" | "could";
195
202
  scenario: string;
203
+ expected: string;
204
+ status: "passing" | "failing" | "untested" | "partial";
196
205
  linked_code: string[];
197
206
  linked_tests: string[];
198
207
  linked_blocks: string[];
199
- verification: "manual" | "automatic" | "semi-automatic";
208
+ verification: "automatic" | "manual" | "semi-automatic";
200
209
  }, {
201
- name: string;
202
- expected: string;
203
210
  id: string;
204
- category: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
211
+ name: string;
212
+ category: string;
205
213
  priority: "must" | "should" | "could";
206
214
  scenario: string;
207
- verification: "manual" | "automatic" | "semi-automatic";
215
+ expected: string;
216
+ verification: "automatic" | "manual" | "semi-automatic";
208
217
  status?: "passing" | "failing" | "untested" | "partial" | undefined;
209
218
  linked_code?: string[] | undefined;
210
219
  linked_tests?: string[] | undefined;
@@ -214,22 +223,22 @@ declare const QualityScenariosFileSchema: z.ZodObject<{
214
223
  schema_version: z.ZodDefault<z.ZodLiteral<1>>;
215
224
  last_updated: z.ZodString;
216
225
  quality_goals: z.ZodArray<z.ZodObject<{
217
- id: z.ZodEnum<["security", "performance", "accessibility", "reliability", "maintainability"]>;
226
+ id: z.ZodString;
218
227
  priority: z.ZodNumber;
219
228
  description: z.ZodString;
220
229
  }, "strip", z.ZodTypeAny, {
221
- id: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
230
+ id: string;
222
231
  priority: number;
223
232
  description: string;
224
233
  }, {
225
- id: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
234
+ id: string;
226
235
  priority: number;
227
236
  description: string;
228
237
  }>, "many">;
229
238
  scenarios: z.ZodArray<z.ZodObject<{
230
239
  id: z.ZodString;
231
240
  name: z.ZodString;
232
- category: z.ZodEnum<["security", "performance", "accessibility", "reliability", "maintainability"]>;
241
+ category: z.ZodString;
233
242
  priority: z.ZodEnum<["must", "should", "could"]>;
234
243
  scenario: z.ZodString;
235
244
  expected: z.ZodString;
@@ -239,25 +248,25 @@ declare const QualityScenariosFileSchema: z.ZodObject<{
239
248
  verification: z.ZodEnum<["automatic", "manual", "semi-automatic"]>;
240
249
  status: z.ZodDefault<z.ZodEnum<["passing", "failing", "untested", "partial"]>>;
241
250
  }, "strip", z.ZodTypeAny, {
242
- name: string;
243
- status: "passing" | "failing" | "untested" | "partial";
244
- expected: string;
245
251
  id: string;
246
- category: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
252
+ name: string;
253
+ category: string;
247
254
  priority: "must" | "should" | "could";
248
255
  scenario: string;
256
+ expected: string;
257
+ status: "passing" | "failing" | "untested" | "partial";
249
258
  linked_code: string[];
250
259
  linked_tests: string[];
251
260
  linked_blocks: string[];
252
- verification: "manual" | "automatic" | "semi-automatic";
261
+ verification: "automatic" | "manual" | "semi-automatic";
253
262
  }, {
254
- name: string;
255
- expected: string;
256
263
  id: string;
257
- category: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
264
+ name: string;
265
+ category: string;
258
266
  priority: "must" | "should" | "could";
259
267
  scenario: string;
260
- verification: "manual" | "automatic" | "semi-automatic";
268
+ expected: string;
269
+ verification: "automatic" | "manual" | "semi-automatic";
261
270
  status?: "passing" | "failing" | "untested" | "partial" | undefined;
262
271
  linked_code?: string[] | undefined;
263
272
  linked_tests?: string[] | undefined;
@@ -267,38 +276,38 @@ declare const QualityScenariosFileSchema: z.ZodObject<{
267
276
  schema_version: 1;
268
277
  last_updated: string;
269
278
  quality_goals: {
270
- id: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
279
+ id: string;
271
280
  priority: number;
272
281
  description: string;
273
282
  }[];
274
283
  scenarios: {
275
- name: string;
276
- status: "passing" | "failing" | "untested" | "partial";
277
- expected: string;
278
284
  id: string;
279
- category: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
285
+ name: string;
286
+ category: string;
280
287
  priority: "must" | "should" | "could";
281
288
  scenario: string;
289
+ expected: string;
290
+ status: "passing" | "failing" | "untested" | "partial";
282
291
  linked_code: string[];
283
292
  linked_tests: string[];
284
293
  linked_blocks: string[];
285
- verification: "manual" | "automatic" | "semi-automatic";
294
+ verification: "automatic" | "manual" | "semi-automatic";
286
295
  }[];
287
296
  }, {
288
297
  last_updated: string;
289
298
  quality_goals: {
290
- id: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
299
+ id: string;
291
300
  priority: number;
292
301
  description: string;
293
302
  }[];
294
303
  scenarios: {
295
- name: string;
296
- expected: string;
297
304
  id: string;
298
- category: "security" | "performance" | "accessibility" | "reliability" | "maintainability";
305
+ name: string;
306
+ category: string;
299
307
  priority: "must" | "should" | "could";
300
308
  scenario: string;
301
- verification: "manual" | "automatic" | "semi-automatic";
309
+ expected: string;
310
+ verification: "automatic" | "manual" | "semi-automatic";
302
311
  status?: "passing" | "failing" | "untested" | "partial" | undefined;
303
312
  linked_code?: string[] | undefined;
304
313
  linked_tests?: string[] | undefined;
@@ -321,8 +330,8 @@ declare const BuildingBlockSchema: z.ZodObject<{
321
330
  responsibility: z.ZodString;
322
331
  service: z.ZodDefault<z.ZodString>;
323
332
  }, "strip", z.ZodTypeAny, {
324
- name: string;
325
333
  id: string;
334
+ name: string;
326
335
  level: number;
327
336
  code_paths: string[];
328
337
  interfaces: string[];
@@ -332,8 +341,8 @@ declare const BuildingBlockSchema: z.ZodObject<{
332
341
  service: string;
333
342
  parent_id?: string | undefined;
334
343
  }, {
335
- name: string;
336
344
  id: string;
345
+ name: string;
337
346
  level: number;
338
347
  responsibility: string;
339
348
  parent_id?: string | undefined;
@@ -359,8 +368,8 @@ declare const BuildingBlocksFrontmatterSchema: z.ZodObject<{
359
368
  responsibility: z.ZodString;
360
369
  service: z.ZodDefault<z.ZodString>;
361
370
  }, "strip", z.ZodTypeAny, {
362
- name: string;
363
371
  id: string;
372
+ name: string;
364
373
  level: number;
365
374
  code_paths: string[];
366
375
  interfaces: string[];
@@ -370,8 +379,8 @@ declare const BuildingBlocksFrontmatterSchema: z.ZodObject<{
370
379
  service: string;
371
380
  parent_id?: string | undefined;
372
381
  }, {
373
- name: string;
374
382
  id: string;
383
+ name: string;
375
384
  level: number;
376
385
  responsibility: string;
377
386
  parent_id?: string | undefined;
@@ -386,8 +395,8 @@ declare const BuildingBlocksFrontmatterSchema: z.ZodObject<{
386
395
  section: "building-blocks";
387
396
  last_synced: string;
388
397
  blocks: {
389
- name: string;
390
398
  id: string;
399
+ name: string;
391
400
  level: number;
392
401
  code_paths: string[];
393
402
  interfaces: string[];
@@ -401,8 +410,8 @@ declare const BuildingBlocksFrontmatterSchema: z.ZodObject<{
401
410
  section: "building-blocks";
402
411
  last_synced: string;
403
412
  blocks: {
404
- name: string;
405
413
  id: string;
414
+ name: string;
406
415
  level: number;
407
416
  responsibility: string;
408
417
  parent_id?: string | undefined;
@@ -427,17 +436,17 @@ declare const PhaseSchema: z.ZodObject<{
427
436
  started_at: z.ZodOptional<z.ZodString>;
428
437
  completed_at: z.ZodOptional<z.ZodString>;
429
438
  }, "strip", z.ZodTypeAny, {
439
+ id: string;
430
440
  name: string;
431
441
  status: "planned" | "in-progress" | "complete" | "blocked";
432
- id: string;
433
442
  description: string;
434
443
  phase_number: number;
435
444
  gate_requirements: string[];
436
445
  started_at?: string | undefined;
437
446
  completed_at?: string | undefined;
438
447
  }, {
439
- name: string;
440
448
  id: string;
449
+ name: string;
441
450
  description: string;
442
451
  phase_number: number;
443
452
  status?: "planned" | "in-progress" | "complete" | "blocked" | undefined;
@@ -454,8 +463,8 @@ declare const TaskSchema: z.ZodObject<{
454
463
  acceptance_criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
455
464
  completed_at: z.ZodOptional<z.ZodString>;
456
465
  }, "strip", z.ZodTypeAny, {
457
- status: "in-progress" | "blocked" | "todo" | "done" | "cancelled";
458
466
  id: string;
467
+ status: "in-progress" | "blocked" | "todo" | "done" | "cancelled";
459
468
  quality_scenarios: string[];
460
469
  title: string;
461
470
  acceptance_criteria: string[];
@@ -482,17 +491,17 @@ declare const PhasesFileSchema: z.ZodObject<{
482
491
  started_at: z.ZodOptional<z.ZodString>;
483
492
  completed_at: z.ZodOptional<z.ZodString>;
484
493
  }, "strip", z.ZodTypeAny, {
494
+ id: string;
485
495
  name: string;
486
496
  status: "planned" | "in-progress" | "complete" | "blocked";
487
- id: string;
488
497
  description: string;
489
498
  phase_number: number;
490
499
  gate_requirements: string[];
491
500
  started_at?: string | undefined;
492
501
  completed_at?: string | undefined;
493
502
  }, {
494
- name: string;
495
503
  id: string;
504
+ name: string;
496
505
  description: string;
497
506
  phase_number: number;
498
507
  status?: "planned" | "in-progress" | "complete" | "blocked" | undefined;
@@ -503,9 +512,9 @@ declare const PhasesFileSchema: z.ZodObject<{
503
512
  }, "strip", z.ZodTypeAny, {
504
513
  schema_version: 1;
505
514
  phases: {
515
+ id: string;
506
516
  name: string;
507
517
  status: "planned" | "in-progress" | "complete" | "blocked";
508
- id: string;
509
518
  description: string;
510
519
  phase_number: number;
511
520
  gate_requirements: string[];
@@ -514,8 +523,8 @@ declare const PhasesFileSchema: z.ZodObject<{
514
523
  }[];
515
524
  }, {
516
525
  phases: {
517
- name: string;
518
526
  id: string;
527
+ name: string;
519
528
  description: string;
520
529
  phase_number: number;
521
530
  status?: "planned" | "in-progress" | "complete" | "blocked" | undefined;
@@ -537,8 +546,8 @@ declare const TaskFileSchema: z.ZodObject<{
537
546
  acceptance_criteria: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
538
547
  completed_at: z.ZodOptional<z.ZodString>;
539
548
  }, "strip", z.ZodTypeAny, {
540
- status: "in-progress" | "blocked" | "todo" | "done" | "cancelled";
541
549
  id: string;
550
+ status: "in-progress" | "blocked" | "todo" | "done" | "cancelled";
542
551
  quality_scenarios: string[];
543
552
  title: string;
544
553
  acceptance_criteria: string[];
@@ -557,8 +566,8 @@ declare const TaskFileSchema: z.ZodObject<{
557
566
  schema_version: 1;
558
567
  phase_id: string;
559
568
  tasks: {
560
- status: "in-progress" | "blocked" | "todo" | "done" | "cancelled";
561
569
  id: string;
570
+ status: "in-progress" | "blocked" | "todo" | "done" | "cancelled";
562
571
  quality_scenarios: string[];
563
572
  title: string;
564
573
  acceptance_criteria: string[];
@@ -593,17 +602,17 @@ declare const AdrFrontmatterSchema: z.ZodObject<{
593
602
  quality_scenarios: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
594
603
  superseded_by: z.ZodOptional<z.ZodString>;
595
604
  }, "strip", z.ZodTypeAny, {
605
+ id: string;
596
606
  status: "proposed" | "accepted" | "deprecated" | "superseded";
597
607
  date: string;
598
- id: string;
599
608
  quality_scenarios: string[];
600
609
  title: string;
601
610
  affected_blocks: string[];
602
611
  affected_files: string[];
603
612
  superseded_by?: string | undefined;
604
613
  }, {
605
- date: string;
606
614
  id: string;
615
+ date: string;
607
616
  title: string;
608
617
  status?: "proposed" | "accepted" | "deprecated" | "superseded" | undefined;
609
618
  quality_scenarios?: string[] | undefined;
@@ -1144,4 +1153,4 @@ declare function loadConfig(projectRoot: string): {
1144
1153
  error: string | null;
1145
1154
  };
1146
1155
 
1147
- export { type ActivityRow, type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type AggregatedRow, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type Database, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExportFormat, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type InsertActivityParams, type LatestQualitySnapshot, type LoadRolesResult, type MetricsResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type QueryMetricsParams, type ScenarioTestResult, type Service, type SessionTotals, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addPhaseToYaml, addTaskToYaml, applyInferences, deletePhaseFromYaml, deleteTaskFromYaml, detectDrift, detectProjectLanguage, discoverDotnetServices, exportMetrics, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getSessionTotals, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, insertActivity, loadConfig, loadRole, loadRoles, migrate, openDatabase, openMemoryDatabase, queryMetrics, refreshFromDocs, resolveRef, scopeToProject, setSyncCommit, suppressSqliteWarning, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, transaction, verifyScenarios, writeDriftLog };
1156
+ export { type ActivityRow, type AdrFrontmatter, AdrFrontmatterSchema, type AgentRole, AgentRoleSchema, type AggregatedRow, type ArcBridgeConfig, ArcBridgeConfigSchema, type BuildingBlock, BuildingBlockSchema, type BuildingBlocksFrontmatter, BuildingBlocksFrontmatterSchema, CURRENT_SCHEMA_VERSION, type ChangedFile, type Database, type DotnetProjectInfo, type DriftEntry, type DriftKind, type DriftOptions, type DriftSeverity, type ExportFormat, type ExtractedSymbol, type GenerateDatabaseResult, type GitRef, type IndexResult, type IndexerOptions, type InitProjectInput, type InsertActivityParams, type LatestQualitySnapshot, type LoadRolesResult, type MetricsResult, type Phase, PhaseSchema, type PhasesFile, PhasesFileSchema, type ProjectLanguage, QUALITY_PRIORITIES_DESCRIPTION, QualityCategorySchema, QualityPrioritySchema, type QualityScenario, QualityScenarioSchema, QualityScenarioStatusSchema, type QualityScenariosFile, QualityScenariosFileSchema, type QueryMetricsParams, type ScenarioTestResult, type Service, type SessionTotals, type SymbolKind, type Task, type TaskFile, TaskFileSchema, type TaskInferenceResult, TaskSchema, type TestOutcome, type VerifyResult, addPhaseToYaml, addTaskToYaml, applyInferences, deletePhaseFromYaml, deleteTaskFromYaml, detectDrift, detectProjectLanguage, discoverDotnetServices, exportMetrics, generateAgentRoles, generateArc42, generateConfig, generateDatabase, generatePlan, generateSyncFiles, getChangedFiles, getHeadSha, getSessionTotals, getUncommittedChanges, indexPackageDependencies, indexProject, inferTaskStatuses, initializeSchema, insertActivity, loadConfig, loadRole, loadRoles, migrate, openDatabase, openMemoryDatabase, queryMetrics, refreshFromDocs, resolveRef, scopeToProject, setSyncCommit, suppressSqliteWarning, syncPhaseToYaml, syncScenarioToYaml, syncTaskToYaml, transaction, verifyScenarios, writeDriftLog };