@maycombhq/sdk 2.0.0-beta.3 → 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.
Files changed (88) hide show
  1. package/npm/core/ai-decisions.d.ts +373 -0
  2. package/npm/core/api.d.ts +15888 -3797
  3. package/npm/core/app-memory.d.ts +69 -0
  4. package/npm/core/assistant-actor.d.ts +28 -7
  5. package/npm/core/audit.d.ts +174 -0
  6. package/npm/core/canary.d.ts +369 -0
  7. package/npm/core/cancel.d.ts +20 -0
  8. package/npm/core/catalog.d.ts +220 -66
  9. package/npm/core/change-types-migrate.d.ts +14 -0
  10. package/npm/core/cite.d.ts +88 -6
  11. package/npm/core/contract-check.d.ts +276 -0
  12. package/npm/core/curated.d.ts +10 -0
  13. package/npm/core/decision-batches.d.ts +29 -0
  14. package/npm/core/declarable-routes.d.ts +52 -0
  15. package/npm/core/declared-links.d.ts +210 -0
  16. package/npm/core/eol.d.ts +5 -0
  17. package/npm/core/fact-paths.d.ts +14 -0
  18. package/npm/core/facts-callers.d.ts +23 -1
  19. package/npm/core/facts-carry.d.ts +8 -2
  20. package/npm/core/facts-deps.d.ts +85 -0
  21. package/npm/core/facts-join-prototype.d.ts +66 -4
  22. package/npm/core/facts-join-vendor.d.ts +67 -7
  23. package/npm/core/facts-join.d.ts +476 -2
  24. package/npm/core/facts-terms.d.ts +108 -0
  25. package/npm/core/facts.d.ts +155 -1
  26. package/npm/core/field-places.d.ts +109 -0
  27. package/npm/core/file-pool.d.ts +84 -0
  28. package/npm/core/fs.d.ts +205 -7
  29. package/npm/core/glob-plain.d.ts +34 -0
  30. package/npm/core/glob.d.ts +14 -0
  31. package/npm/core/hash-cache.d.ts +53 -0
  32. package/npm/core/host-questions.d.ts +273 -1
  33. package/npm/core/identity.d.ts +20 -8
  34. package/npm/core/index.d.ts +38 -0
  35. package/npm/core/initialisms.d.ts +62 -0
  36. package/npm/core/kept-files.d.ts +17 -0
  37. package/npm/core/light.d.ts +5 -0
  38. package/npm/core/link-candidates.d.ts +224 -0
  39. package/npm/core/link-evidence.d.ts +212 -0
  40. package/npm/core/log.d.ts +2 -0
  41. package/npm/core/manifest-edit.d.ts +83 -6
  42. package/npm/core/merge.d.ts +28 -0
  43. package/npm/core/metarepo.d.ts +26 -1
  44. package/npm/core/migrate.d.ts +3 -2
  45. package/npm/core/org-notes.d.ts +180 -0
  46. package/npm/core/orgpack-defaults.d.ts +30 -6
  47. package/npm/core/orgpack-load.d.ts +24 -0
  48. package/npm/core/paths.d.ts +23 -0
  49. package/npm/core/printer.d.ts +18 -0
  50. package/npm/core/process-trees.d.ts +109 -0
  51. package/npm/core/profile-migrate.d.ts +13 -0
  52. package/npm/core/question-order.d.ts +23 -0
  53. package/npm/core/question-owners.d.ts +57 -0
  54. package/npm/core/question-proposals.d.ts +77 -0
  55. package/npm/core/question-roles.d.ts +84 -0
  56. package/npm/core/questions.d.ts +123 -6
  57. package/npm/core/record-cache.d.ts +122 -2
  58. package/npm/core/repo-files.d.ts +66 -0
  59. package/npm/core/repo-reads.d.ts +44 -0
  60. package/npm/core/roles-migrate.d.ts +10 -0
  61. package/npm/core/run-log.d.ts +341 -0
  62. package/npm/core/runtime-migrate.d.ts +18 -0
  63. package/npm/core/schema/ai.d.ts +61 -13
  64. package/npm/core/schema/common.d.ts +32 -8
  65. package/npm/core/schema/component-type.d.ts +193 -0
  66. package/npm/core/schema/conventions.d.ts +80 -0
  67. package/npm/core/schema/dialect.d.ts +12 -12
  68. package/npm/core/schema/fact-corrections.d.ts +112 -2
  69. package/npm/core/schema/facts.d.ts +743 -23
  70. package/npm/core/schema/frameworks.d.ts +12 -12
  71. package/npm/core/schema/kinds.d.ts +230 -66
  72. package/npm/core/schema/orgpack.d.ts +248 -24
  73. package/npm/core/schema/question.d.ts +281 -5
  74. package/npm/core/schema/reading-rules.d.ts +51 -0
  75. package/npm/core/schema/repo-type.d.ts +20 -2
  76. package/npm/core/schema/review.d.ts +30 -9
  77. package/npm/core/schema/scan-verify.d.ts +77 -0
  78. package/npm/core/schema/version.d.ts +4 -1
  79. package/npm/core/schema/workspace.d.ts +29 -11
  80. package/npm/core/setup-edit.d.ts +107 -0
  81. package/npm/core/shared-maps.d.ts +146 -0
  82. package/npm/core/stack-helpers.d.ts +32 -0
  83. package/npm/core/version-order.d.ts +14 -0
  84. package/npm/fs-repo.d.ts +2 -1
  85. package/npm/index.js +14248 -6710
  86. package/npm/listing.d.ts +14 -0
  87. package/npm/sandbox.d.ts +2 -1
  88. package/package.json +1 -1
@@ -71,8 +71,41 @@ export declare const Approver: z.ZodObject<{
71
71
  groups: z.ZodDefault<z.ZodArray<z.ZodString>>;
72
72
  people: z.ZodDefault<z.ZodArray<z.ZodString>>;
73
73
  }, z.core.$strict>;
74
+ /**
75
+ * roles.yaml version 2 (ADR 0140) adds `teams`: who is on each team a repo manifest's `owner`
76
+ * names, so a question goes to the team that owns its repo and a person can list their own.
77
+ * Words, not permissions: nothing is allowed or refused by team. The rest of the file stays
78
+ * deprecated (ADR 0073). A version-1 file is read as it is; `teams` needs version 2.
79
+ */
80
+ /**
81
+ * Version 3 (ADR 0191) adds who takes each role on a change, so a new change's owners are
82
+ * suggested: a team's `roles` (each built-in or custom role id with the team's people who take
83
+ * it, for the changes on that team's repos) and the file's `defaults` (the organisation's person
84
+ * for a role when no team owning the change's repos names one). Both optional; a person accepts a
85
+ * suggestion, nothing is written by itself. A version-1 or version-2 file reads as it is.
86
+ */
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;
93
+ export declare const Team: z.ZodObject<{
94
+ id: z.ZodString;
95
+ name: z.ZodOptional<z.ZodString>;
96
+ people: z.ZodDefault<z.ZodArray<z.ZodString>>;
97
+ roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
98
+ }, z.core.$strict>;
99
+ export type Team = z.infer<typeof Team>;
74
100
  export declare const Roles: z.ZodObject<{
75
- schemaVersion: z.ZodLiteral<1>;
101
+ schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
102
+ teams: z.ZodDefault<z.ZodArray<z.ZodObject<{
103
+ id: z.ZodString;
104
+ name: z.ZodOptional<z.ZodString>;
105
+ people: z.ZodDefault<z.ZodArray<z.ZodString>>;
106
+ roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
107
+ }, z.core.$strict>>>;
108
+ defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
76
109
  custom: z.ZodDefault<z.ZodArray<z.ZodObject<{
77
110
  id: z.ZodString;
78
111
  name: z.ZodString;
@@ -168,6 +201,7 @@ export declare const ChangeType: z.ZodObject<{
168
201
  snow: "snow";
169
202
  }>>;
170
203
  lenses: z.ZodDefault<z.ZodArray<z.ZodEnum<{
204
+ release: "release";
171
205
  true: "true";
172
206
  complete: "complete";
173
207
  safe: "safe";
@@ -178,7 +212,6 @@ export declare const ChangeType: z.ZodObject<{
178
212
  ux: "ux";
179
213
  delivery: "delivery";
180
214
  "code-and-test": "code-and-test";
181
- release: "release";
182
215
  }>>>;
183
216
  approvals: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
184
217
  release: "release";
@@ -231,6 +264,7 @@ export declare const ChangeTypes: z.ZodObject<{
231
264
  snow: "snow";
232
265
  }>>;
233
266
  lenses: z.ZodDefault<z.ZodArray<z.ZodEnum<{
267
+ release: "release";
234
268
  true: "true";
235
269
  complete: "complete";
236
270
  safe: "safe";
@@ -241,7 +275,6 @@ export declare const ChangeTypes: z.ZodObject<{
241
275
  ux: "ux";
242
276
  delivery: "delivery";
243
277
  "code-and-test": "code-and-test";
244
- release: "release";
245
278
  }>>>;
246
279
  approvals: z.ZodDefault<z.ZodRecord<z.ZodEnum<{
247
280
  release: "release";
@@ -279,6 +312,21 @@ export declare function fastPathOf(type: {
279
312
  fast: boolean;
280
313
  why: "type" | "brief" | "brief-standard" | "brief-not-allowed" | "standard";
281
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;
282
330
  /**
283
331
  * The gate whose critic reviews the fast path's step (ADR 0113): the type's fastGate, else the
284
332
  * first gate of its last phase before build, else of its first phase. Undefined when gates.yaml
@@ -414,6 +462,13 @@ export declare const IntegrationPattern: z.ZodObject<{
414
462
  }>;
415
463
  }, z.core.$strict>;
416
464
  export type IntegrationPattern = z.infer<typeof IntegrationPattern>;
465
+ /**
466
+ * Review round 49: why git wouldn't take a wiki's `ref` as a branch or tag name, or undefined
467
+ * when it would. Git's own rules (git check-ref-format), and never a leading `-`, so the name
468
+ * can't be read as an option. Beta.18 took any name; round 13 narrowed it to letters, digits and
469
+ * `._/-`, which refused names git takes (`v2.1+hotfix`, `feature@x`); this takes them again.
470
+ */
471
+ export declare function gitRefProblem(ref: string): string | undefined;
417
472
  /** Suggested source kinds (ADR 0083). Tags are free text: an organisation adds its own. */
418
473
  export declare const SOURCE_KIND_SUGGESTIONS: readonly ["enterprise-architecture", "integration-patterns", "platform-runbook", "security-standard", "change-process", "framework"];
419
474
  /**
@@ -737,10 +792,10 @@ export type AssistantId = z.infer<typeof AssistantId>;
737
792
  export declare const STEP_CLASSES: readonly ["read", "draft", "critic", "knowledge", "quick"];
738
793
  export declare const StepClass: z.ZodEnum<{
739
794
  read: "read";
795
+ quick: "quick";
740
796
  draft: "draft";
741
797
  critic: "critic";
742
798
  knowledge: "knowledge";
743
- quick: "quick";
744
799
  }>;
745
800
  export type StepClass = z.infer<typeof StepClass>;
746
801
  /**
@@ -749,9 +804,67 @@ export type StepClass = z.infer<typeof StepClass>;
749
804
  * step on the one model; `atticus upgrade` moves it to version 2 (`runtime-v2`), changing nothing
750
805
  * else.
751
806
  */
752
- export declare const RUNTIME_SCHEMA_VERSION: 2;
807
+ export declare const RUNTIME_SCHEMA_VERSION: 4;
808
+ /**
809
+ * runtime.yaml version 4 (ADR 0181): whether the AI decides, itself, what it can (a loose call's
810
+ * pairing with an API, an option question about a target on file), shown as the AI's, or only
811
+ * proposes for a person, as before. `propose` until the organisation turns it on in a pull
812
+ * request. `minPrecision`: the share right of the AI's decisions a sample audit must show
813
+ * (ADR 0148); below it, deciding pauses back to propose and Home says why. Configuration, not a
814
+ * safety rule: a human still approves every write to shared systems, and the AI never decides a
815
+ * free-text question, a scope wider than the repo, an org-pack change, a gate or anything a
816
+ * person only may do.
817
+ */
818
+ export declare const DecideSettings: z.ZodObject<{
819
+ links: z.ZodDefault<z.ZodEnum<{
820
+ auto: "auto";
821
+ propose: "propose";
822
+ }>>;
823
+ questions: z.ZodDefault<z.ZodEnum<{
824
+ auto: "auto";
825
+ propose: "propose";
826
+ }>>;
827
+ minPrecision: z.ZodDefault<z.ZodNumber>;
828
+ }, z.core.$strict>;
829
+ export type DecideSettings = z.infer<typeof DecideSettings>;
830
+ export declare const DECIDE_DEFAULTS: DecideSettings;
831
+ /** runtime.yaml's decide section with its defaults (ADR 0181). */
832
+ export declare function decideOf(runtime: {
833
+ decide?: Partial<DecideSettings> | undefined;
834
+ } | undefined): DecideSettings;
835
+ /**
836
+ * runtime.yaml version 3 (ADR 0171): how Atticus starts the GitHub Copilot language server in its
837
+ * Agent Client Protocol mode, for `copilot-acp`. Only how to start it, which model to ask for and
838
+ * the caps: what the session may read, write and run is fixed in code (rule 6), never here.
839
+ * - command: the server's program and any words before `--acp` (no shell), as one line; a path
840
+ * with spaces in double quotes. Default `npx --yes @github/copilot-language-server`.
841
+ * - model: the model id to ask the server for, when it offers a choice.
842
+ * - maxTurns: the most tool calls one session may make before Atticus cancels it (default 200).
843
+ * - timeoutMs: the longest one session may take (default 30 minutes).
844
+ */
845
+ export declare const CopilotAcpSettings: z.ZodObject<{
846
+ command: z.ZodOptional<z.ZodString>;
847
+ model: z.ZodOptional<z.ZodString>;
848
+ maxTurns: z.ZodOptional<z.ZodNumber>;
849
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
850
+ }, z.core.$strict>;
851
+ export type CopilotAcpSettings = z.infer<typeof CopilotAcpSettings>;
852
+ export declare const COPILOT_ACP_DEFAULTS: {
853
+ readonly command: "npx --yes @github/copilot-language-server";
854
+ readonly maxTurns: 200;
855
+ readonly timeoutMs: number;
856
+ };
857
+ /** runtime.yaml's copilotAcp section with its defaults (ADR 0171). */
858
+ export declare function copilotAcpOf(runtime: {
859
+ copilotAcp?: CopilotAcpSettings | undefined;
860
+ } | undefined): {
861
+ command: string;
862
+ model?: string;
863
+ maxTurns: number;
864
+ timeoutMs: number;
865
+ };
753
866
  export declare const Runtime: z.ZodObject<{
754
- schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
867
+ schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>;
755
868
  assistants: z.ZodObject<{
756
869
  allowed: z.ZodArray<z.ZodEnum<{
757
870
  copilot: "copilot";
@@ -779,18 +892,26 @@ export declare const Runtime: z.ZodObject<{
779
892
  "text-only": "text-only";
780
893
  off: "off";
781
894
  }>>;
782
- modes: z.ZodDefault<z.ZodObject<{
895
+ modes: z.ZodDefault<z.ZodPipe<z.ZodObject<{
783
896
  allowed: z.ZodArray<z.ZodEnum<{
784
897
  model: "model";
785
898
  "hand-off": "hand-off";
786
899
  "headless-claude-code": "headless-claude-code";
900
+ "copilot-acp": "copilot-acp";
787
901
  }>>;
788
- default: z.ZodEnum<{
902
+ default: z.ZodOptional<z.ZodEnum<{
789
903
  model: "model";
790
904
  "hand-off": "hand-off";
791
905
  "headless-claude-code": "headless-claude-code";
792
- }>;
793
- }, z.core.$strict>>;
906
+ "copilot-acp": "copilot-acp";
907
+ }>>;
908
+ }, z.core.$strict>, z.ZodTransform<{
909
+ allowed: ("model" | "hand-off" | "headless-claude-code" | "copilot-acp")[];
910
+ default: "model" | "hand-off" | "headless-claude-code" | "copilot-acp";
911
+ }, {
912
+ allowed: ("model" | "hand-off" | "headless-claude-code" | "copilot-acp")[];
913
+ default?: "model" | "hand-off" | "headless-claude-code" | "copilot-acp" | undefined;
914
+ }>>>;
794
915
  models: z.ZodDefault<z.ZodObject<{
795
916
  allowed: z.ZodDefault<z.ZodArray<z.ZodString>>;
796
917
  recommended: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -831,46 +952,93 @@ export declare const Runtime: z.ZodObject<{
831
952
  expansion: z.ZodDefault<z.ZodBoolean>;
832
953
  rerank: z.ZodDefault<z.ZodBoolean>;
833
954
  }, z.core.$strict>>;
955
+ copilotAcp: z.ZodOptional<z.ZodObject<{
956
+ command: z.ZodOptional<z.ZodString>;
957
+ model: z.ZodOptional<z.ZodString>;
958
+ maxTurns: z.ZodOptional<z.ZodNumber>;
959
+ timeoutMs: z.ZodOptional<z.ZodNumber>;
960
+ }, z.core.$strict>>;
961
+ decide: z.ZodOptional<z.ZodObject<{
962
+ links: z.ZodDefault<z.ZodEnum<{
963
+ auto: "auto";
964
+ propose: "propose";
965
+ }>>;
966
+ questions: z.ZodDefault<z.ZodEnum<{
967
+ auto: "auto";
968
+ propose: "propose";
969
+ }>>;
970
+ minPrecision: z.ZodDefault<z.ZodNumber>;
971
+ }, z.core.$strict>>;
834
972
  telemetry: z.ZodDefault<z.ZodObject<{
835
973
  enabled: z.ZodDefault<z.ZodBoolean>;
836
974
  }, z.core.$strict>>;
837
975
  adapters: z.ZodDefault<z.ZodObject<{
838
- workTracker: z.ZodOptional<z.ZodObject<{
976
+ workTracker: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodEnum<{
977
+ [x: string]: string;
978
+ }>, z.ZodTransform<{
979
+ type: string;
980
+ settings: Record<string, string | number | boolean | string[]>;
981
+ }, string>>, z.ZodObject<{
839
982
  type: z.ZodEnum<{
840
983
  [x: string]: string;
841
984
  }>;
842
985
  settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
843
- }, z.core.$strict>>;
844
- serviceDesk: z.ZodOptional<z.ZodObject<{
986
+ }, z.core.$strict>]>>;
987
+ serviceDesk: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodEnum<{
988
+ [x: string]: string;
989
+ }>, z.ZodTransform<{
990
+ type: string;
991
+ settings: Record<string, string | number | boolean | string[]>;
992
+ }, string>>, z.ZodObject<{
845
993
  type: z.ZodEnum<{
846
994
  [x: string]: string;
847
995
  }>;
848
996
  settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
849
- }, z.core.$strict>>;
850
- gitHost: z.ZodOptional<z.ZodObject<{
997
+ }, z.core.$strict>]>>;
998
+ gitHost: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodEnum<{
999
+ [x: string]: string;
1000
+ }>, z.ZodTransform<{
1001
+ type: string;
1002
+ settings: Record<string, string | number | boolean | string[]>;
1003
+ }, string>>, z.ZodObject<{
851
1004
  type: z.ZodEnum<{
852
1005
  [x: string]: string;
853
1006
  }>;
854
1007
  settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
855
- }, z.core.$strict>>;
856
- wiki: z.ZodOptional<z.ZodObject<{
1008
+ }, z.core.$strict>]>>;
1009
+ wiki: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodEnum<{
1010
+ [x: string]: string;
1011
+ }>, z.ZodTransform<{
1012
+ type: string;
1013
+ settings: Record<string, string | number | boolean | string[]>;
1014
+ }, string>>, z.ZodObject<{
857
1015
  type: z.ZodEnum<{
858
1016
  [x: string]: string;
859
1017
  }>;
860
1018
  settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
861
- }, z.core.$strict>>;
862
- notify: z.ZodOptional<z.ZodObject<{
1019
+ }, z.core.$strict>]>>;
1020
+ notify: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodEnum<{
1021
+ [x: string]: string;
1022
+ }>, z.ZodTransform<{
1023
+ type: string;
1024
+ settings: Record<string, string | number | boolean | string[]>;
1025
+ }, string>>, z.ZodObject<{
863
1026
  type: z.ZodEnum<{
864
1027
  [x: string]: string;
865
1028
  }>;
866
1029
  settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
867
- }, z.core.$strict>>;
868
- design: z.ZodOptional<z.ZodObject<{
1030
+ }, z.core.$strict>]>>;
1031
+ design: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodEnum<{
1032
+ [x: string]: string;
1033
+ }>, z.ZodTransform<{
1034
+ type: string;
1035
+ settings: Record<string, string | number | boolean | string[]>;
1036
+ }, string>>, z.ZodObject<{
869
1037
  type: z.ZodEnum<{
870
1038
  [x: string]: string;
871
1039
  }>;
872
1040
  settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
873
- }, z.core.$strict>>;
1041
+ }, z.core.$strict>]>>;
874
1042
  model: z.ZodOptional<z.ZodObject<{
875
1043
  type: z.ZodUnion<readonly [z.ZodEnum<{
876
1044
  mock: "mock";
@@ -923,9 +1091,9 @@ export declare const SkillMeta: z.ZodObject<{
923
1091
  source: z.ZodString;
924
1092
  status: z.ZodDefault<z.ZodEnum<{
925
1093
  retired: "retired";
1094
+ stale: "stale";
926
1095
  active: "active";
927
1096
  draft: "draft";
928
- stale: "stale";
929
1097
  }>>;
930
1098
  reviewedAt: z.ZodOptional<z.ZodISODate>;
931
1099
  }, z.core.$strict>;
@@ -1130,8 +1298,47 @@ export declare const DeclaredCall: z.ZodObject<{
1130
1298
  route: z.ZodOptional<z.ZodString>;
1131
1299
  }, z.core.$strict>;
1132
1300
  export type DeclaredCall = z.infer<typeof DeclaredCall>;
1301
+ /**
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.
1306
+ */
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;
1133
1340
  export declare const Profile: z.ZodObject<{
1134
- schemaVersion: z.ZodLiteral<1>;
1341
+ schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
1135
1342
  platform: z.ZodString;
1136
1343
  name: z.ZodString;
1137
1344
  systems: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1144,6 +1351,7 @@ export declare const Profile: z.ZodObject<{
1144
1351
  }>;
1145
1352
  owner: z.ZodOptional<z.ZodString>;
1146
1353
  aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
1354
+ topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
1147
1355
  tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
1148
1356
  calls: z.ZodOptional<z.ZodArray<z.ZodObject<{
1149
1357
  as: z.ZodOptional<z.ZodEnum<{
@@ -1163,5 +1371,21 @@ export declare const Profile: z.ZodObject<{
1163
1371
  retire: z.ZodDefault<z.ZodArray<z.ZodString>>;
1164
1372
  }, z.core.$strict>>;
1165
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>>>;
1166
1390
  }, z.core.$strict>;
1167
1391
  export type Profile = z.infer<typeof Profile>;