@maycombhq/sdk 2.0.0-beta.22 → 2.0.0-beta.24
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/npm/core/api.d.ts +3075 -317
- package/npm/core/cite.d.ts +9 -2
- package/npm/core/facts-deps.d.ts +55 -0
- package/npm/core/facts-join.d.ts +94 -8
- package/npm/core/fs.d.ts +8 -0
- package/npm/core/host-questions.d.ts +105 -0
- package/npm/core/index.d.ts +5 -0
- package/npm/core/kept-files.d.ts +17 -0
- package/npm/core/light.d.ts +2 -0
- package/npm/core/log.d.ts +2 -0
- package/npm/core/manifest-edit.d.ts +21 -3
- package/npm/core/metarepo.d.ts +8 -0
- package/npm/core/orgpack-defaults.d.ts +3 -1
- package/npm/core/printer.d.ts +4 -0
- package/npm/core/question-owners.d.ts +4 -0
- package/npm/core/question-roles.d.ts +64 -4
- package/npm/core/questions.d.ts +28 -3
- package/npm/core/roles-migrate.d.ts +4 -3
- package/npm/core/run-log.d.ts +165 -0
- package/npm/core/schema/ai.d.ts +2 -2
- package/npm/core/schema/dialect.d.ts +12 -12
- package/npm/core/schema/fact-corrections.d.ts +7 -0
- package/npm/core/schema/facts.d.ts +268 -4
- package/npm/core/schema/frameworks.d.ts +10 -10
- package/npm/core/schema/orgpack.d.ts +22 -6
- package/npm/core/schema/question.d.ts +55 -2
- package/npm/core/schema/review.d.ts +2 -2
- package/npm/core/schema/scan-verify.d.ts +80 -45
- package/npm/core/setup-edit.d.ts +107 -0
- package/npm/index.js +6428 -4882
- package/package.json +1 -1
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
export declare const FACT_KINDS: readonly ["entry", "call", "store", "field", "deploy", "config", "framework", "flow", "term", "component"];
|
|
2
|
+
export declare const FACT_KINDS: readonly ["entry", "call", "store", "field", "deploy", "config", "framework", "flow", "term", "component", "artifact", "dependency"];
|
|
3
3
|
export type FactKind = (typeof FACT_KINDS)[number];
|
|
4
4
|
/** A fact's id: any slug the assistant chooses; the projection makes catalog ids from the claim. */
|
|
5
5
|
export declare const FactId: z.ZodString;
|
|
@@ -422,12 +422,15 @@ export declare const DeployFact: z.ZodObject<{
|
|
|
422
422
|
* 1: the shapes of ADR 0124 and its addenda. 2: a deploy fact's `host`, `basePath` and `exposes`.
|
|
423
423
|
* 3 (ADR 0163): the `term` kind, and a call's `auth`, `authCite`, `tls` and `tlsCite`.
|
|
424
424
|
* 4 (ADR 0180): the `component` kind, what a component is.
|
|
425
|
+
* 5 (ADR 0192): the `artifact` and `dependency` kinds, a component's build coordinates and what
|
|
426
|
+
* it builds on. A version-4 file reads unchanged: both are new kinds, nothing else moved.
|
|
425
427
|
*/
|
|
426
|
-
export declare const FACTS_SCHEMA_VERSION:
|
|
428
|
+
export declare const FACTS_SCHEMA_VERSION: 5;
|
|
427
429
|
export declare const SETTING_KINDS: readonly ["timeout", "retry", "circuit-breaker", "rate-limit", "pool", "cache-ttl", "feature-flag", "config", "schedule"];
|
|
428
430
|
/**
|
|
429
|
-
* Whether a key and its value look like a secret: the key
|
|
430
|
-
* and the value is neither a reference to where the
|
|
431
|
+
* Whether a key and its value look like a secret: a name the key gives (its last part, a
|
|
432
|
+
* bracketed name) ends in a secret word, and the value is neither a reference to where the
|
|
433
|
+
* secret lives nor a flag or a mode.
|
|
431
434
|
*/
|
|
432
435
|
export declare function looksLikeSecret(key: string, value: string | undefined): boolean;
|
|
433
436
|
export declare const ConfigFact: z.ZodObject<{
|
|
@@ -762,6 +765,113 @@ export declare const ComponentFact: z.ZodObject<{
|
|
|
762
765
|
}>>;
|
|
763
766
|
kind: z.ZodLiteral<"component">;
|
|
764
767
|
}, z.core.$strict>;
|
|
768
|
+
/**
|
|
769
|
+
* What a component's build publishes (ADR 0192): its own coordinates, `group` and `name` (a
|
|
770
|
+
* pom's project `<groupId>` and `<artifactId>`, a Gradle project's `group` and name). `cite` is the
|
|
771
|
+
* line that writes the name (the project's own `<artifactId>`, `rootProject.name`); the line that
|
|
772
|
+
* writes the group, when it is another (the project's `<groupId>`, the `<parent>`'s when the
|
|
773
|
+
* project inherits it, `group = '...'` in build.gradle), goes in `cite.with`, as does the
|
|
774
|
+
* version's. The verifier reads the build file to check each is what that line says, and that
|
|
775
|
+
* the name is the project's own, never a dependency's or a parent's.
|
|
776
|
+
*
|
|
777
|
+
* Nothing is projected into catalog C1 from it, as with a framework fact: the views read it, and
|
|
778
|
+
* the estate's dependency join (`joinDependencies`) pairs it with the `dependency` facts that name
|
|
779
|
+
* the same coordinates.
|
|
780
|
+
*/
|
|
781
|
+
export declare const ArtifactFact: z.ZodObject<{
|
|
782
|
+
group: z.ZodString;
|
|
783
|
+
name: z.ZodString;
|
|
784
|
+
version: z.ZodOptional<z.ZodString>;
|
|
785
|
+
id: z.ZodString;
|
|
786
|
+
repo: z.ZodString;
|
|
787
|
+
commit: z.ZodString;
|
|
788
|
+
component: z.ZodOptional<z.ZodString>;
|
|
789
|
+
cite: z.ZodObject<{
|
|
790
|
+
file: z.ZodString;
|
|
791
|
+
line: z.ZodNumber;
|
|
792
|
+
value: z.ZodString;
|
|
793
|
+
quote: z.ZodOptional<z.ZodString>;
|
|
794
|
+
with: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
795
|
+
file: z.ZodString;
|
|
796
|
+
line: z.ZodNumber;
|
|
797
|
+
value: z.ZodString;
|
|
798
|
+
}, z.core.$strict>>>;
|
|
799
|
+
}, z.core.$strict>;
|
|
800
|
+
verified: z.ZodDefault<z.ZodEnum<{
|
|
801
|
+
line: "line";
|
|
802
|
+
none: "none";
|
|
803
|
+
person: "person";
|
|
804
|
+
sample: "sample";
|
|
805
|
+
}>>;
|
|
806
|
+
by: z.ZodDefault<z.ZodEnum<{
|
|
807
|
+
person: "person";
|
|
808
|
+
assistant: "assistant";
|
|
809
|
+
reader: "reader";
|
|
810
|
+
}>>;
|
|
811
|
+
conf: z.ZodDefault<z.ZodEnum<{
|
|
812
|
+
inferred: "inferred";
|
|
813
|
+
declared: "declared";
|
|
814
|
+
}>>;
|
|
815
|
+
kind: z.ZodLiteral<"artifact">;
|
|
816
|
+
}, z.core.$strict>;
|
|
817
|
+
/** A dependency's scope (ADR 0192): Maven's, or what a Gradle configuration means. */
|
|
818
|
+
export declare const DEPENDENCY_SCOPES: readonly ["compile", "runtime", "provided", "test", "import"];
|
|
819
|
+
export type DependencyScope = (typeof DEPENDENCY_SCOPES)[number];
|
|
820
|
+
/**
|
|
821
|
+
* A build dependency a component declares (ADR 0192): the `group` and `name` of what it builds
|
|
822
|
+
* on, as the build file declares it in its dependencies (not a dependency-management block, a
|
|
823
|
+
* plugin or an exclusion). `cite` is the line that writes the name (the dependency's
|
|
824
|
+
* `<artifactId>`, a Gradle `implementation 'g:a:v'` line); the dependency's `<groupId>` line, when
|
|
825
|
+
* it is another, goes in `cite.with`. `scope` is the declared scope, left out for the default
|
|
826
|
+
* (compile). The dependency belongs to the component whose build file cites it: a module's pom
|
|
827
|
+
* is its module's.
|
|
828
|
+
*
|
|
829
|
+
* Every dependency is recorded, the organisation's own or not: which one is the estate's own is
|
|
830
|
+
* the dependency join's to say, from the coordinates the estate's `artifact` facts publish.
|
|
831
|
+
*/
|
|
832
|
+
export declare const DependencyFact: z.ZodObject<{
|
|
833
|
+
group: z.ZodString;
|
|
834
|
+
name: z.ZodString;
|
|
835
|
+
version: z.ZodOptional<z.ZodString>;
|
|
836
|
+
scope: z.ZodOptional<z.ZodEnum<{
|
|
837
|
+
runtime: "runtime";
|
|
838
|
+
compile: "compile";
|
|
839
|
+
provided: "provided";
|
|
840
|
+
test: "test";
|
|
841
|
+
import: "import";
|
|
842
|
+
}>>;
|
|
843
|
+
id: z.ZodString;
|
|
844
|
+
repo: z.ZodString;
|
|
845
|
+
commit: z.ZodString;
|
|
846
|
+
component: z.ZodOptional<z.ZodString>;
|
|
847
|
+
cite: z.ZodObject<{
|
|
848
|
+
file: z.ZodString;
|
|
849
|
+
line: z.ZodNumber;
|
|
850
|
+
value: z.ZodString;
|
|
851
|
+
quote: z.ZodOptional<z.ZodString>;
|
|
852
|
+
with: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
853
|
+
file: z.ZodString;
|
|
854
|
+
line: z.ZodNumber;
|
|
855
|
+
value: z.ZodString;
|
|
856
|
+
}, z.core.$strict>>>;
|
|
857
|
+
}, z.core.$strict>;
|
|
858
|
+
verified: z.ZodDefault<z.ZodEnum<{
|
|
859
|
+
line: "line";
|
|
860
|
+
none: "none";
|
|
861
|
+
person: "person";
|
|
862
|
+
sample: "sample";
|
|
863
|
+
}>>;
|
|
864
|
+
by: z.ZodDefault<z.ZodEnum<{
|
|
865
|
+
person: "person";
|
|
866
|
+
assistant: "assistant";
|
|
867
|
+
reader: "reader";
|
|
868
|
+
}>>;
|
|
869
|
+
conf: z.ZodDefault<z.ZodEnum<{
|
|
870
|
+
inferred: "inferred";
|
|
871
|
+
declared: "declared";
|
|
872
|
+
}>>;
|
|
873
|
+
kind: z.ZodLiteral<"dependency">;
|
|
874
|
+
}, z.core.$strict>;
|
|
765
875
|
export declare const Fact: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
766
876
|
entryType: z.ZodEnum<{
|
|
767
877
|
function: "function";
|
|
@@ -1319,6 +1429,83 @@ export declare const Fact: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
1319
1429
|
declared: "declared";
|
|
1320
1430
|
}>>;
|
|
1321
1431
|
kind: z.ZodLiteral<"component">;
|
|
1432
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
1433
|
+
group: z.ZodString;
|
|
1434
|
+
name: z.ZodString;
|
|
1435
|
+
version: z.ZodOptional<z.ZodString>;
|
|
1436
|
+
id: z.ZodString;
|
|
1437
|
+
repo: z.ZodString;
|
|
1438
|
+
commit: z.ZodString;
|
|
1439
|
+
component: z.ZodOptional<z.ZodString>;
|
|
1440
|
+
cite: z.ZodObject<{
|
|
1441
|
+
file: z.ZodString;
|
|
1442
|
+
line: z.ZodNumber;
|
|
1443
|
+
value: z.ZodString;
|
|
1444
|
+
quote: z.ZodOptional<z.ZodString>;
|
|
1445
|
+
with: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1446
|
+
file: z.ZodString;
|
|
1447
|
+
line: z.ZodNumber;
|
|
1448
|
+
value: z.ZodString;
|
|
1449
|
+
}, z.core.$strict>>>;
|
|
1450
|
+
}, z.core.$strict>;
|
|
1451
|
+
verified: z.ZodDefault<z.ZodEnum<{
|
|
1452
|
+
line: "line";
|
|
1453
|
+
none: "none";
|
|
1454
|
+
person: "person";
|
|
1455
|
+
sample: "sample";
|
|
1456
|
+
}>>;
|
|
1457
|
+
by: z.ZodDefault<z.ZodEnum<{
|
|
1458
|
+
person: "person";
|
|
1459
|
+
assistant: "assistant";
|
|
1460
|
+
reader: "reader";
|
|
1461
|
+
}>>;
|
|
1462
|
+
conf: z.ZodDefault<z.ZodEnum<{
|
|
1463
|
+
inferred: "inferred";
|
|
1464
|
+
declared: "declared";
|
|
1465
|
+
}>>;
|
|
1466
|
+
kind: z.ZodLiteral<"artifact">;
|
|
1467
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
1468
|
+
group: z.ZodString;
|
|
1469
|
+
name: z.ZodString;
|
|
1470
|
+
version: z.ZodOptional<z.ZodString>;
|
|
1471
|
+
scope: z.ZodOptional<z.ZodEnum<{
|
|
1472
|
+
runtime: "runtime";
|
|
1473
|
+
compile: "compile";
|
|
1474
|
+
provided: "provided";
|
|
1475
|
+
test: "test";
|
|
1476
|
+
import: "import";
|
|
1477
|
+
}>>;
|
|
1478
|
+
id: z.ZodString;
|
|
1479
|
+
repo: z.ZodString;
|
|
1480
|
+
commit: z.ZodString;
|
|
1481
|
+
component: z.ZodOptional<z.ZodString>;
|
|
1482
|
+
cite: z.ZodObject<{
|
|
1483
|
+
file: z.ZodString;
|
|
1484
|
+
line: z.ZodNumber;
|
|
1485
|
+
value: z.ZodString;
|
|
1486
|
+
quote: z.ZodOptional<z.ZodString>;
|
|
1487
|
+
with: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1488
|
+
file: z.ZodString;
|
|
1489
|
+
line: z.ZodNumber;
|
|
1490
|
+
value: z.ZodString;
|
|
1491
|
+
}, z.core.$strict>>>;
|
|
1492
|
+
}, z.core.$strict>;
|
|
1493
|
+
verified: z.ZodDefault<z.ZodEnum<{
|
|
1494
|
+
line: "line";
|
|
1495
|
+
none: "none";
|
|
1496
|
+
person: "person";
|
|
1497
|
+
sample: "sample";
|
|
1498
|
+
}>>;
|
|
1499
|
+
by: z.ZodDefault<z.ZodEnum<{
|
|
1500
|
+
person: "person";
|
|
1501
|
+
assistant: "assistant";
|
|
1502
|
+
reader: "reader";
|
|
1503
|
+
}>>;
|
|
1504
|
+
conf: z.ZodDefault<z.ZodEnum<{
|
|
1505
|
+
inferred: "inferred";
|
|
1506
|
+
declared: "declared";
|
|
1507
|
+
}>>;
|
|
1508
|
+
kind: z.ZodLiteral<"dependency">;
|
|
1322
1509
|
}, z.core.$strict>], "kind">;
|
|
1323
1510
|
export type Fact = z.infer<typeof Fact>;
|
|
1324
1511
|
export type FactOf<K extends FactKind> = Extract<Fact, {
|
|
@@ -1882,4 +2069,81 @@ export declare const FactsFile: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<
|
|
|
1882
2069
|
declared: "declared";
|
|
1883
2070
|
}>>;
|
|
1884
2071
|
kind: z.ZodLiteral<"component">;
|
|
2072
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
2073
|
+
group: z.ZodString;
|
|
2074
|
+
name: z.ZodString;
|
|
2075
|
+
version: z.ZodOptional<z.ZodString>;
|
|
2076
|
+
id: z.ZodString;
|
|
2077
|
+
repo: z.ZodString;
|
|
2078
|
+
commit: z.ZodString;
|
|
2079
|
+
component: z.ZodOptional<z.ZodString>;
|
|
2080
|
+
cite: z.ZodObject<{
|
|
2081
|
+
file: z.ZodString;
|
|
2082
|
+
line: z.ZodNumber;
|
|
2083
|
+
value: z.ZodString;
|
|
2084
|
+
quote: z.ZodOptional<z.ZodString>;
|
|
2085
|
+
with: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
2086
|
+
file: z.ZodString;
|
|
2087
|
+
line: z.ZodNumber;
|
|
2088
|
+
value: z.ZodString;
|
|
2089
|
+
}, z.core.$strict>>>;
|
|
2090
|
+
}, z.core.$strict>;
|
|
2091
|
+
verified: z.ZodDefault<z.ZodEnum<{
|
|
2092
|
+
line: "line";
|
|
2093
|
+
none: "none";
|
|
2094
|
+
person: "person";
|
|
2095
|
+
sample: "sample";
|
|
2096
|
+
}>>;
|
|
2097
|
+
by: z.ZodDefault<z.ZodEnum<{
|
|
2098
|
+
person: "person";
|
|
2099
|
+
assistant: "assistant";
|
|
2100
|
+
reader: "reader";
|
|
2101
|
+
}>>;
|
|
2102
|
+
conf: z.ZodDefault<z.ZodEnum<{
|
|
2103
|
+
inferred: "inferred";
|
|
2104
|
+
declared: "declared";
|
|
2105
|
+
}>>;
|
|
2106
|
+
kind: z.ZodLiteral<"artifact">;
|
|
2107
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
2108
|
+
group: z.ZodString;
|
|
2109
|
+
name: z.ZodString;
|
|
2110
|
+
version: z.ZodOptional<z.ZodString>;
|
|
2111
|
+
scope: z.ZodOptional<z.ZodEnum<{
|
|
2112
|
+
runtime: "runtime";
|
|
2113
|
+
compile: "compile";
|
|
2114
|
+
provided: "provided";
|
|
2115
|
+
test: "test";
|
|
2116
|
+
import: "import";
|
|
2117
|
+
}>>;
|
|
2118
|
+
id: z.ZodString;
|
|
2119
|
+
repo: z.ZodString;
|
|
2120
|
+
commit: z.ZodString;
|
|
2121
|
+
component: z.ZodOptional<z.ZodString>;
|
|
2122
|
+
cite: z.ZodObject<{
|
|
2123
|
+
file: z.ZodString;
|
|
2124
|
+
line: z.ZodNumber;
|
|
2125
|
+
value: z.ZodString;
|
|
2126
|
+
quote: z.ZodOptional<z.ZodString>;
|
|
2127
|
+
with: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
2128
|
+
file: z.ZodString;
|
|
2129
|
+
line: z.ZodNumber;
|
|
2130
|
+
value: z.ZodString;
|
|
2131
|
+
}, z.core.$strict>>>;
|
|
2132
|
+
}, z.core.$strict>;
|
|
2133
|
+
verified: z.ZodDefault<z.ZodEnum<{
|
|
2134
|
+
line: "line";
|
|
2135
|
+
none: "none";
|
|
2136
|
+
person: "person";
|
|
2137
|
+
sample: "sample";
|
|
2138
|
+
}>>;
|
|
2139
|
+
by: z.ZodDefault<z.ZodEnum<{
|
|
2140
|
+
person: "person";
|
|
2141
|
+
assistant: "assistant";
|
|
2142
|
+
reader: "reader";
|
|
2143
|
+
}>>;
|
|
2144
|
+
conf: z.ZodDefault<z.ZodEnum<{
|
|
2145
|
+
inferred: "inferred";
|
|
2146
|
+
declared: "declared";
|
|
2147
|
+
}>>;
|
|
2148
|
+
kind: z.ZodLiteral<"dependency">;
|
|
1885
2149
|
}, z.core.$strict>], "kind">>;
|
|
@@ -63,10 +63,10 @@ export declare const FrameworkClient: z.ZodObject<{
|
|
|
63
63
|
}, z.core.$strict>;
|
|
64
64
|
/** Languages the house-framework extractor reads (js covers JavaScript and TypeScript). */
|
|
65
65
|
export declare const FrameworkLanguage: z.ZodEnum<{
|
|
66
|
-
python: "python";
|
|
67
|
-
go: "go";
|
|
68
66
|
js: "js";
|
|
69
67
|
csharp: "csharp";
|
|
68
|
+
python: "python";
|
|
69
|
+
go: "go";
|
|
70
70
|
}>;
|
|
71
71
|
/** A call that reaches another system (ADR 0055). */
|
|
72
72
|
export declare const FrameworkCall: z.ZodObject<{
|
|
@@ -99,10 +99,10 @@ export declare const FrameworkCall: z.ZodObject<{
|
|
|
99
99
|
receiver: z.ZodOptional<z.ZodString>;
|
|
100
100
|
from: z.ZodOptional<z.ZodString>;
|
|
101
101
|
language: z.ZodOptional<z.ZodEnum<{
|
|
102
|
-
python: "python";
|
|
103
|
-
go: "go";
|
|
104
102
|
js: "js";
|
|
105
103
|
csharp: "csharp";
|
|
104
|
+
python: "python";
|
|
105
|
+
go: "go";
|
|
106
106
|
}>>;
|
|
107
107
|
source: z.ZodObject<{
|
|
108
108
|
kind: z.ZodEnum<{
|
|
@@ -132,10 +132,10 @@ export declare const FrameworkRoute: z.ZodObject<{
|
|
|
132
132
|
receiver: z.ZodOptional<z.ZodString>;
|
|
133
133
|
from: z.ZodOptional<z.ZodString>;
|
|
134
134
|
language: z.ZodOptional<z.ZodEnum<{
|
|
135
|
-
python: "python";
|
|
136
|
-
go: "go";
|
|
137
135
|
js: "js";
|
|
138
136
|
csharp: "csharp";
|
|
137
|
+
python: "python";
|
|
138
|
+
go: "go";
|
|
139
139
|
}>>;
|
|
140
140
|
source: z.ZodObject<{
|
|
141
141
|
kind: z.ZodEnum<{
|
|
@@ -273,10 +273,10 @@ export declare const FrameworkModel: z.ZodObject<{
|
|
|
273
273
|
receiver: z.ZodOptional<z.ZodString>;
|
|
274
274
|
from: z.ZodOptional<z.ZodString>;
|
|
275
275
|
language: z.ZodOptional<z.ZodEnum<{
|
|
276
|
-
python: "python";
|
|
277
|
-
go: "go";
|
|
278
276
|
js: "js";
|
|
279
277
|
csharp: "csharp";
|
|
278
|
+
python: "python";
|
|
279
|
+
go: "go";
|
|
280
280
|
}>>;
|
|
281
281
|
source: z.ZodObject<{
|
|
282
282
|
kind: z.ZodEnum<{
|
|
@@ -305,10 +305,10 @@ export declare const FrameworkModel: z.ZodObject<{
|
|
|
305
305
|
receiver: z.ZodOptional<z.ZodString>;
|
|
306
306
|
from: z.ZodOptional<z.ZodString>;
|
|
307
307
|
language: z.ZodOptional<z.ZodEnum<{
|
|
308
|
-
python: "python";
|
|
309
|
-
go: "go";
|
|
310
308
|
js: "js";
|
|
311
309
|
csharp: "csharp";
|
|
310
|
+
python: "python";
|
|
311
|
+
go: "go";
|
|
312
312
|
}>>;
|
|
313
313
|
source: z.ZodObject<{
|
|
314
314
|
kind: z.ZodEnum<{
|
|
@@ -77,20 +77,30 @@ export declare const Approver: z.ZodObject<{
|
|
|
77
77
|
* Words, not permissions: nothing is allowed or refused by team. The rest of the file stays
|
|
78
78
|
* deprecated (ADR 0073). A version-1 file is read as it is; `teams` needs version 2.
|
|
79
79
|
*/
|
|
80
|
-
|
|
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;
|
|
81
88
|
export declare const Team: z.ZodObject<{
|
|
82
89
|
id: z.ZodString;
|
|
83
90
|
name: z.ZodOptional<z.ZodString>;
|
|
84
91
|
people: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
92
|
+
roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
|
|
85
93
|
}, z.core.$strict>;
|
|
86
94
|
export type Team = z.infer<typeof Team>;
|
|
87
95
|
export declare const Roles: z.ZodObject<{
|
|
88
|
-
schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
|
|
96
|
+
schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
|
|
89
97
|
teams: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
90
98
|
id: z.ZodString;
|
|
91
99
|
name: z.ZodOptional<z.ZodString>;
|
|
92
100
|
people: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
101
|
+
roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
|
|
93
102
|
}, z.core.$strict>>>;
|
|
103
|
+
defaults: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
|
|
94
104
|
custom: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
95
105
|
id: z.ZodString;
|
|
96
106
|
name: z.ZodString;
|
|
@@ -862,20 +872,26 @@ export declare const Runtime: z.ZodObject<{
|
|
|
862
872
|
"text-only": "text-only";
|
|
863
873
|
off: "off";
|
|
864
874
|
}>>;
|
|
865
|
-
modes: z.ZodDefault<z.ZodObject<{
|
|
875
|
+
modes: z.ZodDefault<z.ZodPipe<z.ZodObject<{
|
|
866
876
|
allowed: z.ZodArray<z.ZodEnum<{
|
|
867
877
|
model: "model";
|
|
868
878
|
"hand-off": "hand-off";
|
|
869
879
|
"headless-claude-code": "headless-claude-code";
|
|
870
880
|
"copilot-acp": "copilot-acp";
|
|
871
881
|
}>>;
|
|
872
|
-
default: z.ZodEnum<{
|
|
882
|
+
default: z.ZodOptional<z.ZodEnum<{
|
|
873
883
|
model: "model";
|
|
874
884
|
"hand-off": "hand-off";
|
|
875
885
|
"headless-claude-code": "headless-claude-code";
|
|
876
886
|
"copilot-acp": "copilot-acp";
|
|
877
|
-
}
|
|
878
|
-
}, z.core.$strict
|
|
887
|
+
}>>;
|
|
888
|
+
}, z.core.$strict>, z.ZodTransform<{
|
|
889
|
+
allowed: ("model" | "hand-off" | "headless-claude-code" | "copilot-acp")[];
|
|
890
|
+
default: "model" | "hand-off" | "headless-claude-code" | "copilot-acp";
|
|
891
|
+
}, {
|
|
892
|
+
allowed: ("model" | "hand-off" | "headless-claude-code" | "copilot-acp")[];
|
|
893
|
+
default?: "model" | "hand-off" | "headless-claude-code" | "copilot-acp" | undefined;
|
|
894
|
+
}>>>;
|
|
879
895
|
models: z.ZodDefault<z.ZodObject<{
|
|
880
896
|
allowed: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
881
897
|
recommended: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
|
|
@@ -33,7 +33,15 @@ import { z } from "zod";
|
|
|
33
33
|
* question: `askedOf` (the team or person a person's Ask routed it to) and `finding` (the gap it
|
|
34
34
|
* asks about, by change, gate, round and id). Both optional.
|
|
35
35
|
*/
|
|
36
|
-
|
|
36
|
+
/**
|
|
37
|
+
* Version 6 (ADR 0191, routing by what a question asks) adds two optional fields: `asks`, what the
|
|
38
|
+
* question asks (business, design or delivery), which the AI tags when it raises it and which
|
|
39
|
+
* decides the role that owns it (business → the product owner, or the business analyst from the
|
|
40
|
+
* stories on; design → the architect; delivery → the tech lead); and `routed`, a person's
|
|
41
|
+
* re-routing of it to another role (from which, by whom, when), with `role` holding the new one.
|
|
42
|
+
* Version-1 to version-5 files read as before and come back as version 6 in memory.
|
|
43
|
+
*/
|
|
44
|
+
export declare const QUESTION_SCHEMA_VERSION: 6;
|
|
37
45
|
/**
|
|
38
46
|
* ADR 0181 part 4: who owns a question on a change, by the phase that raised it. The product owner
|
|
39
47
|
* (Define), the architect (Design), the business analyst (Plan's stories) and the tech lead (Plan's
|
|
@@ -47,6 +55,31 @@ export declare const QuestionRole: z.ZodEnum<{
|
|
|
47
55
|
analysis: "analysis";
|
|
48
56
|
}>;
|
|
49
57
|
export type QuestionRole = z.infer<typeof QuestionRole>;
|
|
58
|
+
/**
|
|
59
|
+
* ADR 0191: what a question asks, by its level. `business`: what the change must do for whom (a
|
|
60
|
+
* rule, a limit, what happens when money is short); `design`: how the estate does it (a call, a
|
|
61
|
+
* timeout, a topic, a circuit breaker); `delivery`: how and when it is built and shipped (a repo, a
|
|
62
|
+
* migration's order, a test). The AI tags each question it raises; a person can re-route it.
|
|
63
|
+
*/
|
|
64
|
+
export declare const QUESTION_ASKS: readonly ["business", "design", "delivery"];
|
|
65
|
+
export declare const QuestionAsks: z.ZodEnum<{
|
|
66
|
+
business: "business";
|
|
67
|
+
delivery: "delivery";
|
|
68
|
+
design: "design";
|
|
69
|
+
}>;
|
|
70
|
+
export type QuestionAsks = z.infer<typeof QuestionAsks>;
|
|
71
|
+
/** ADR 0191: a person moved a question to another role: from which, by whom, when. */
|
|
72
|
+
export declare const QuestionRouted: z.ZodObject<{
|
|
73
|
+
from: z.ZodOptional<z.ZodEnum<{
|
|
74
|
+
product: "product";
|
|
75
|
+
architecture: "architecture";
|
|
76
|
+
delivery: "delivery";
|
|
77
|
+
analysis: "analysis";
|
|
78
|
+
}>>;
|
|
79
|
+
by: z.ZodString;
|
|
80
|
+
at: z.ZodISODateTime;
|
|
81
|
+
}, z.core.$strict>;
|
|
82
|
+
export type QuestionRouted = z.infer<typeof QuestionRouted>;
|
|
50
83
|
/**
|
|
51
84
|
* ADR 0181: the runtimes whose runs Atticus records, so a decision can name its run: a Copilot
|
|
52
85
|
* session Atticus started (`copilot-acp`), or a hand-off run Atticus prepared for the person's
|
|
@@ -187,7 +220,7 @@ export declare const QuestionAnswer: z.ZodObject<{
|
|
|
187
220
|
}, z.core.$strict>;
|
|
188
221
|
export type QuestionAnswer = z.infer<typeof QuestionAnswer>;
|
|
189
222
|
export declare const Question: z.ZodObject<{
|
|
190
|
-
schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>]>;
|
|
223
|
+
schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>]>;
|
|
191
224
|
id: z.ZodString;
|
|
192
225
|
askedBy: z.ZodObject<{
|
|
193
226
|
step: z.ZodString;
|
|
@@ -223,6 +256,21 @@ export declare const Question: z.ZodObject<{
|
|
|
223
256
|
delivery: "delivery";
|
|
224
257
|
analysis: "analysis";
|
|
225
258
|
}>>;
|
|
259
|
+
asks: z.ZodOptional<z.ZodEnum<{
|
|
260
|
+
business: "business";
|
|
261
|
+
delivery: "delivery";
|
|
262
|
+
design: "design";
|
|
263
|
+
}>>;
|
|
264
|
+
routed: z.ZodOptional<z.ZodObject<{
|
|
265
|
+
from: z.ZodOptional<z.ZodEnum<{
|
|
266
|
+
product: "product";
|
|
267
|
+
architecture: "architecture";
|
|
268
|
+
delivery: "delivery";
|
|
269
|
+
analysis: "analysis";
|
|
270
|
+
}>>;
|
|
271
|
+
by: z.ZodString;
|
|
272
|
+
at: z.ZodISODateTime;
|
|
273
|
+
}, z.core.$strict>>;
|
|
226
274
|
askedOf: z.ZodOptional<z.ZodString>;
|
|
227
275
|
finding: z.ZodOptional<z.ZodObject<{
|
|
228
276
|
change: z.ZodString;
|
|
@@ -362,6 +410,11 @@ export declare const QuestionDraft: z.ZodObject<{
|
|
|
362
410
|
delivery: "delivery";
|
|
363
411
|
analysis: "analysis";
|
|
364
412
|
}>>;
|
|
413
|
+
asks: z.ZodOptional<z.ZodEnum<{
|
|
414
|
+
business: "business";
|
|
415
|
+
delivery: "delivery";
|
|
416
|
+
design: "design";
|
|
417
|
+
}>>;
|
|
365
418
|
sameAs: z.ZodOptional<z.ZodObject<{
|
|
366
419
|
id: z.ZodString;
|
|
367
420
|
verdict: z.ZodEnum<{
|
|
@@ -404,8 +404,8 @@ export declare const FindingEvidence: z.ZodObject<{
|
|
|
404
404
|
export: "export";
|
|
405
405
|
manual: "manual";
|
|
406
406
|
}>, z.ZodEnum<{
|
|
407
|
-
catalog: "catalog";
|
|
408
407
|
artifact: "artifact";
|
|
408
|
+
catalog: "catalog";
|
|
409
409
|
rule: "rule";
|
|
410
410
|
}>]>;
|
|
411
411
|
record: z.ZodOptional<z.ZodString>;
|
|
@@ -510,8 +510,8 @@ export declare const Finding: z.ZodObject<{
|
|
|
510
510
|
export: "export";
|
|
511
511
|
manual: "manual";
|
|
512
512
|
}>, z.ZodEnum<{
|
|
513
|
-
catalog: "catalog";
|
|
514
513
|
artifact: "artifact";
|
|
514
|
+
catalog: "catalog";
|
|
515
515
|
rule: "rule";
|
|
516
516
|
}>]>;
|
|
517
517
|
record: z.ZodOptional<z.ZodString>;
|