@maycombhq/sdk 2.0.0-beta.28.5 → 2.0.0-beta.30

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.
@@ -71,9 +71,9 @@ export declare const FrameworkLanguage: z.ZodEnum<{
71
71
  /** A call that reaches another system (ADR 0055). */
72
72
  export declare const FrameworkCall: z.ZodObject<{
73
73
  kind: z.ZodDefault<z.ZodEnum<{
74
+ "event-subscribe": "event-subscribe";
74
75
  "http-call": "http-call";
75
76
  "event-publish": "event-publish";
76
- "event-subscribe": "event-subscribe";
77
77
  "mq-publish": "mq-publish";
78
78
  "mq-subscribe": "mq-subscribe";
79
79
  }>>;
@@ -245,9 +245,9 @@ export declare const FrameworkModel: z.ZodObject<{
245
245
  }, z.core.$strict>>>;
246
246
  calls: z.ZodDefault<z.ZodArray<z.ZodObject<{
247
247
  kind: z.ZodDefault<z.ZodEnum<{
248
+ "event-subscribe": "event-subscribe";
248
249
  "http-call": "http-call";
249
250
  "event-publish": "event-publish";
250
- "event-subscribe": "event-subscribe";
251
251
  "mq-publish": "mq-publish";
252
252
  "mq-subscribe": "mq-subscribe";
253
253
  }>>;
@@ -85,6 +85,11 @@ export declare const Approver: z.ZodObject<{
85
85
  * suggestion, nothing is written by itself. A version-1 or version-2 file reads as it is.
86
86
  */
87
87
  export declare const ROLES_SCHEMA_VERSION: 3;
88
+ /**
89
+ * A person by their Git handle, as Atticus records `by` (`gitUser`'s handle): one line, no spaces.
90
+ * A team's people, and since ADR 0204's second review who declared an arrow.
91
+ */
92
+ export declare const PersonHandle: z.ZodString;
88
93
  export declare const Team: z.ZodObject<{
89
94
  id: z.ZodString;
90
95
  name: z.ZodOptional<z.ZodString>;
@@ -307,6 +312,21 @@ export declare function fastPathOf(type: {
307
312
  fast: boolean;
308
313
  why: "type" | "brief" | "brief-standard" | "brief-not-allowed" | "standard";
309
314
  };
315
+ /**
316
+ * Whether a change of this type takes the quick path (ADR 0201, with its addendum of
317
+ * 2026-11-18): its only phase before build is plan; its artifacts list specs, as the built-in
318
+ * `quick` does, and neither stories nor a brief; and it is neither small nor a type whose brief
319
+ * may say small (those keep the fast path, ADR 0113). So a change of any type not deliberately
320
+ * shaped like `quick` behaves as it did before the quick path existed. A shape, not a key, so change-types.yaml stays at version 2 and an
321
+ * organisation's own type of that shape is quick too. No stage runs for it: the files its
322
+ * artifacts name are written directly, then handed off once.
323
+ */
324
+ export declare function quickPathOf(type: {
325
+ phases: readonly string[];
326
+ artifacts: readonly string[];
327
+ size?: "standard" | "small" | undefined;
328
+ smallWhenBriefSays?: boolean | undefined;
329
+ }): boolean;
310
330
  /**
311
331
  * The gate whose critic reviews the fast path's step (ADR 0113): the type's fastGate, else the
312
332
  * first gate of its last phase before build, else of its first phase. Undefined when gates.yaml
@@ -1279,14 +1299,46 @@ export declare const DeclaredCall: z.ZodObject<{
1279
1299
  }, z.core.$strict>;
1280
1300
  export type DeclaredCall = z.infer<typeof DeclaredCall>;
1281
1301
  /**
1282
- * profile.yaml's version. 2 (ADR 0162 amendment, review item 15) adds a system's `topics`. A
1283
- * version-1 profile reads as it is and stays valid, so `atticus upgrade` moves nothing; a profile
1284
- * that names topics is at 2 (`migrateProfileText`, the number only), as `addProfileSystem` writes
1285
- * it when an answer puts a topic there.
1302
+ * profile.yaml's version. 2 (ADR 0162 amendment, review item 15) adds a system's `topics`; 3 (ADR
1303
+ * 0204) adds the declared arrows, `links`. A version-1 or 2 profile reads as it is and stays
1304
+ * valid, so `atticus upgrade` moves nothing; a profile is moved up only by the write that needs it
1305
+ * (`migrateProfileText`, the number only): a topic to 2, a declared arrow to 3.
1286
1306
  */
1287
- export declare const PROFILE_SCHEMA_VERSION: 2;
1307
+ export declare const PROFILE_SCHEMA_VERSION: 3;
1308
+ /** The version a system's `topics` needs (ADR 0162 amendment). */
1309
+ export declare const PROFILE_TOPICS_VERSION: 2;
1310
+ /** One end of a declared arrow: a repo of the manifests or a system of the profiles. */
1311
+ export declare const ArrowEnd: z.ZodUnion<readonly [z.ZodObject<{
1312
+ repo: z.ZodString;
1313
+ }, z.core.$strict>, z.ZodObject<{
1314
+ system: z.ZodString;
1315
+ }, z.core.$strict>]>;
1316
+ export type ArrowEnd = z.infer<typeof ArrowEnd>;
1317
+ /**
1318
+ * ADR 0204 (version 3): an arrow a person declares that the code doesn't show, from the caller
1319
+ * to the callee. A person's word, built into an asserted Interface flagged `declared-link` on
1320
+ * every build and never kept on its own; not drawn while the code shows a call the same way.
1321
+ */
1322
+ export declare const DeclaredLink: z.ZodObject<{
1323
+ from: z.ZodUnion<readonly [z.ZodObject<{
1324
+ repo: z.ZodString;
1325
+ }, z.core.$strict>, z.ZodObject<{
1326
+ system: z.ZodString;
1327
+ }, z.core.$strict>]>;
1328
+ to: z.ZodUnion<readonly [z.ZodObject<{
1329
+ repo: z.ZodString;
1330
+ }, z.core.$strict>, z.ZodObject<{
1331
+ system: z.ZodString;
1332
+ }, z.core.$strict>]>;
1333
+ why: z.ZodString;
1334
+ by: z.ZodString;
1335
+ at: z.ZodISODateTime;
1336
+ planned: z.ZodOptional<z.ZodBoolean>;
1337
+ }, z.core.$strict>;
1338
+ export type DeclaredLink = z.infer<typeof DeclaredLink>;
1339
+ export declare const arrowEndKey: (e: ArrowEnd) => string;
1288
1340
  export declare const Profile: z.ZodObject<{
1289
- schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
1341
+ schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
1290
1342
  platform: z.ZodString;
1291
1343
  name: z.ZodString;
1292
1344
  systems: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1319,5 +1371,21 @@ export declare const Profile: z.ZodObject<{
1319
1371
  retire: z.ZodDefault<z.ZodArray<z.ZodString>>;
1320
1372
  }, z.core.$strict>>;
1321
1373
  gates: z.ZodDefault<z.ZodArray<z.ZodString>>;
1374
+ links: z.ZodOptional<z.ZodArray<z.ZodObject<{
1375
+ from: z.ZodUnion<readonly [z.ZodObject<{
1376
+ repo: z.ZodString;
1377
+ }, z.core.$strict>, z.ZodObject<{
1378
+ system: z.ZodString;
1379
+ }, z.core.$strict>]>;
1380
+ to: z.ZodUnion<readonly [z.ZodObject<{
1381
+ repo: z.ZodString;
1382
+ }, z.core.$strict>, z.ZodObject<{
1383
+ system: z.ZodString;
1384
+ }, z.core.$strict>]>;
1385
+ why: z.ZodString;
1386
+ by: z.ZodString;
1387
+ at: z.ZodISODateTime;
1388
+ planned: z.ZodOptional<z.ZodBoolean>;
1389
+ }, z.core.$strict>>>;
1322
1390
  }, z.core.$strict>;
1323
1391
  export type Profile = z.infer<typeof Profile>;
@@ -49,6 +49,25 @@ export declare function questionOfLens(l: Lens): CriticQuestion;
49
49
  * lens covers what it used to review (the architecture lens also reviewed what is now safe).
50
50
  */
51
51
  export declare function lensCovers(l: Lens): CriticQuestion[];
52
+ /**
53
+ * A finding's lens: a rule's lens, or `persona` for a persona's naysayer run as a lens of the
54
+ * critic (ADR 0203 C.3, C3 additive, no bump). Rules' lenses stay as they are.
55
+ */
56
+ export declare const FindingLens: z.ZodEnum<{
57
+ release: "release";
58
+ true: "true";
59
+ complete: "complete";
60
+ safe: "safe";
61
+ ship: "ship";
62
+ business: "business";
63
+ architecture: "architecture";
64
+ story: "story";
65
+ ux: "ux";
66
+ delivery: "delivery";
67
+ "code-and-test": "code-and-test";
68
+ persona: "persona";
69
+ }>;
70
+ export type FindingLens = z.infer<typeof FindingLens>;
52
71
  /** Where a rule comes from. Constitution rules can never be waived. */
53
72
  export declare const Layer: z.ZodEnum<{
54
73
  team: "team";
@@ -475,7 +494,9 @@ export declare const Finding: z.ZodObject<{
475
494
  ux: "ux";
476
495
  delivery: "delivery";
477
496
  "code-and-test": "code-and-test";
497
+ persona: "persona";
478
498
  }>;
499
+ persona: z.ZodOptional<z.ZodString>;
479
500
  severity: z.ZodEnum<{
480
501
  blocking: "blocking";
481
502
  gap: "gap";
@@ -0,0 +1,14 @@
1
+ /**
2
+ * The order of two Atticus versions, and the shape of one. Kept here so the command line (the
3
+ * metarepo's stamp, `atticus status`) and the build (the Atticus a newer build.json names, ADR
4
+ * 0202 point 7) tell newer from older by the same rule.
5
+ */
6
+ /** The shape of an Atticus version: the only value that goes into a command a person copies. */
7
+ export declare const ATTICUS_VERSION_SHAPE: RegExp;
8
+ /** `v` when it has the shape of a version (trimmed), else undefined. */
9
+ export declare const atticusVersionOf: (v: string | undefined) => string | undefined;
10
+ /**
11
+ * Round 38: semver order with pre-releases (2.0.0-beta.30 > 2.0.0-beta.21 > 2.0.0-beta.9, and a
12
+ * release above its pre-releases), so an older beta refuses a metarepo a newer beta upgraded.
13
+ */
14
+ export declare function newerThan(a: string, b: string): boolean;