@wairon/cli 5.1.1-dev.103 → 5.1.1-dev.105

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
@@ -515,6 +515,16 @@ declare const ConformanceRuleConfigSchema: z.ZodObject<{
515
515
  }[];
516
516
  revisit?: string | undefined;
517
517
  }>, "many">>;
518
+ /**
519
+ * Opt-in strictness for teams that want CI to say "every designed component
520
+ * has code": every implementation must have begun (some file it names
521
+ * exists). When true, SOURCE_FILE_PLANNED and MISSING_SOURCE_PATH are
522
+ * reported at error, naming this setting, instead of as notices. Off by
523
+ * default, so a design-only tree passes `validate --ci`. Code-conformance
524
+ * tuning like the rest of `rules.conformance`: it enters the analyzer's
525
+ * digest, never the gate identity, so switching it never stales a lock.
526
+ */
527
+ requireCode: z.ZodOptional<z.ZodBoolean>;
518
528
  }, "strip", z.ZodTypeAny, {
519
529
  sourceRoots?: string[] | undefined;
520
530
  exclude?: string[] | undefined;
@@ -531,6 +541,7 @@ declare const ConformanceRuleConfigSchema: z.ZodObject<{
531
541
  }[];
532
542
  revisit?: string | undefined;
533
543
  }[] | undefined;
544
+ requireCode?: boolean | undefined;
534
545
  }, {
535
546
  sourceRoots?: string[] | undefined;
536
547
  exclude?: string[] | undefined;
@@ -547,6 +558,7 @@ declare const ConformanceRuleConfigSchema: z.ZodObject<{
547
558
  }[];
548
559
  revisit?: string | undefined;
549
560
  }[] | undefined;
561
+ requireCode?: boolean | undefined;
550
562
  }>;
551
563
  type ConformanceRuleConfig = z.infer<typeof ConformanceRuleConfigSchema>;
552
564
  /**
@@ -908,6 +920,16 @@ declare const RulesConfigSchema: z.ZodObject<{
908
920
  }[];
909
921
  revisit?: string | undefined;
910
922
  }>, "many">>;
923
+ /**
924
+ * Opt-in strictness for teams that want CI to say "every designed component
925
+ * has code": every implementation must have begun (some file it names
926
+ * exists). When true, SOURCE_FILE_PLANNED and MISSING_SOURCE_PATH are
927
+ * reported at error, naming this setting, instead of as notices. Off by
928
+ * default, so a design-only tree passes `validate --ci`. Code-conformance
929
+ * tuning like the rest of `rules.conformance`: it enters the analyzer's
930
+ * digest, never the gate identity, so switching it never stales a lock.
931
+ */
932
+ requireCode: z.ZodOptional<z.ZodBoolean>;
911
933
  }, "strip", z.ZodTypeAny, {
912
934
  sourceRoots?: string[] | undefined;
913
935
  exclude?: string[] | undefined;
@@ -924,6 +946,7 @@ declare const RulesConfigSchema: z.ZodObject<{
924
946
  }[];
925
947
  revisit?: string | undefined;
926
948
  }[] | undefined;
949
+ requireCode?: boolean | undefined;
927
950
  }, {
928
951
  sourceRoots?: string[] | undefined;
929
952
  exclude?: string[] | undefined;
@@ -940,6 +963,7 @@ declare const RulesConfigSchema: z.ZodObject<{
940
963
  }[];
941
964
  revisit?: string | undefined;
942
965
  }[] | undefined;
966
+ requireCode?: boolean | undefined;
943
967
  }>>;
944
968
  /** Project-default design depth (see DesignDepthSchema); subsystems may override. */
945
969
  designDepth: z.ZodOptional<z.ZodEnum<["components", "interfaces", "implementations", "narratives"]>>;
@@ -1002,6 +1026,7 @@ declare const RulesConfigSchema: z.ZodObject<{
1002
1026
  }[];
1003
1027
  revisit?: string | undefined;
1004
1028
  }[] | undefined;
1029
+ requireCode?: boolean | undefined;
1005
1030
  } | undefined;
1006
1031
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
1007
1032
  }, {
@@ -1063,6 +1088,7 @@ declare const RulesConfigSchema: z.ZodObject<{
1063
1088
  }[];
1064
1089
  revisit?: string | undefined;
1065
1090
  }[] | undefined;
1091
+ requireCode?: boolean | undefined;
1066
1092
  } | undefined;
1067
1093
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
1068
1094
  }>;
@@ -1262,25 +1288,22 @@ type ExternalSource = z.infer<typeof ExternalSourceSchema>;
1262
1288
  declare const ExternalDeclarationSchema: z.ZodObject<{
1263
1289
  /** The producer's project id; defaults to the alias. Plain string: a malformed id is REPORTED, never unreadable. */
1264
1290
  project: z.ZodOptional<z.ZodString>;
1265
- source: z.ZodOptional<z.ZodObject<{
1266
- path: z.ZodOptional<z.ZodString>;
1267
- hosted: z.ZodOptional<z.ZodString>;
1268
- /** A git repository URL holding the producer (stage 8). */
1269
- git: z.ZodOptional<z.ZodString>;
1270
- /** git only: the branch or tag a pin or an update follows; never read by a verdict. */
1271
- ref: z.ZodOptional<z.ZodString>;
1272
- /** git members only: the full commit the member is pinned at (an external's commit is its pin's). */
1273
- commit: z.ZodOptional<z.ZodString>;
1274
- /** git only: the producer's root inside the repository. */
1275
- dir: z.ZodOptional<z.ZodString>;
1276
- }, "strip", z.ZodTypeAny, {
1291
+ /**
1292
+ * Where the producer is found, in either form: the one location string
1293
+ * members use (`../geo-sdk`, `hosted:<id>`, `<git url>`, `<git url>#<commit>`
1294
+ * — a `#<commit>` read as the ref the pin follows) or the object form
1295
+ * ({ path } | { hosted } | { git, ref?, dir? }). Read leniently: any shape
1296
+ * loads, and one that is not a source is the declaration's problem
1297
+ * (readExternalSource), never a configuration that fails to load.
1298
+ */
1299
+ source: z.ZodOptional<z.ZodType<string | {
1277
1300
  path?: string | undefined;
1278
1301
  hosted?: string | undefined;
1279
1302
  git?: string | undefined;
1280
1303
  ref?: string | undefined;
1281
1304
  commit?: string | undefined;
1282
1305
  dir?: string | undefined;
1283
- }, {
1306
+ }, z.ZodTypeDef, string | {
1284
1307
  path?: string | undefined;
1285
1308
  hosted?: string | undefined;
1286
1309
  git?: string | undefined;
@@ -1304,7 +1327,7 @@ declare const ExternalDeclarationSchema: z.ZodObject<{
1304
1327
  description: z.ZodOptional<z.ZodString>;
1305
1328
  }, "strip", z.ZodTypeAny, {
1306
1329
  project?: string | undefined;
1307
- source?: {
1330
+ source?: string | {
1308
1331
  path?: string | undefined;
1309
1332
  hosted?: string | undefined;
1310
1333
  git?: string | undefined;
@@ -1316,7 +1339,7 @@ declare const ExternalDeclarationSchema: z.ZodObject<{
1316
1339
  description?: string | undefined;
1317
1340
  }, {
1318
1341
  project?: string | undefined;
1319
- source?: {
1342
+ source?: string | {
1320
1343
  path?: string | undefined;
1321
1344
  hosted?: string | undefined;
1322
1345
  git?: string | undefined;
@@ -1492,25 +1515,22 @@ declare const ProjectConfigSchema: z.ZodObject<{
1492
1515
  externals: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
1493
1516
  /** The producer's project id; defaults to the alias. Plain string: a malformed id is REPORTED, never unreadable. */
1494
1517
  project: z.ZodOptional<z.ZodString>;
1495
- source: z.ZodOptional<z.ZodObject<{
1496
- path: z.ZodOptional<z.ZodString>;
1497
- hosted: z.ZodOptional<z.ZodString>;
1498
- /** A git repository URL holding the producer (stage 8). */
1499
- git: z.ZodOptional<z.ZodString>;
1500
- /** git only: the branch or tag a pin or an update follows; never read by a verdict. */
1501
- ref: z.ZodOptional<z.ZodString>;
1502
- /** git members only: the full commit the member is pinned at (an external's commit is its pin's). */
1503
- commit: z.ZodOptional<z.ZodString>;
1504
- /** git only: the producer's root inside the repository. */
1505
- dir: z.ZodOptional<z.ZodString>;
1506
- }, "strip", z.ZodTypeAny, {
1518
+ /**
1519
+ * Where the producer is found, in either form: the one location string
1520
+ * members use (`../geo-sdk`, `hosted:<id>`, `<git url>`, `<git url>#<commit>`
1521
+ * — a `#<commit>` read as the ref the pin follows) or the object form
1522
+ * ({ path } | { hosted } | { git, ref?, dir? }). Read leniently: any shape
1523
+ * loads, and one that is not a source is the declaration's problem
1524
+ * (readExternalSource), never a configuration that fails to load.
1525
+ */
1526
+ source: z.ZodOptional<z.ZodType<string | {
1507
1527
  path?: string | undefined;
1508
1528
  hosted?: string | undefined;
1509
1529
  git?: string | undefined;
1510
1530
  ref?: string | undefined;
1511
1531
  commit?: string | undefined;
1512
1532
  dir?: string | undefined;
1513
- }, {
1533
+ }, z.ZodTypeDef, string | {
1514
1534
  path?: string | undefined;
1515
1535
  hosted?: string | undefined;
1516
1536
  git?: string | undefined;
@@ -1534,7 +1554,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
1534
1554
  description: z.ZodOptional<z.ZodString>;
1535
1555
  }, "strip", z.ZodTypeAny, {
1536
1556
  project?: string | undefined;
1537
- source?: {
1557
+ source?: string | {
1538
1558
  path?: string | undefined;
1539
1559
  hosted?: string | undefined;
1540
1560
  git?: string | undefined;
@@ -1546,7 +1566,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
1546
1566
  description?: string | undefined;
1547
1567
  }, {
1548
1568
  project?: string | undefined;
1549
- source?: {
1569
+ source?: string | {
1550
1570
  path?: string | undefined;
1551
1571
  hosted?: string | undefined;
1552
1572
  git?: string | undefined;
@@ -2054,6 +2074,16 @@ declare const ProjectConfigSchema: z.ZodObject<{
2054
2074
  }[];
2055
2075
  revisit?: string | undefined;
2056
2076
  }>, "many">>;
2077
+ /**
2078
+ * Opt-in strictness for teams that want CI to say "every designed component
2079
+ * has code": every implementation must have begun (some file it names
2080
+ * exists). When true, SOURCE_FILE_PLANNED and MISSING_SOURCE_PATH are
2081
+ * reported at error, naming this setting, instead of as notices. Off by
2082
+ * default, so a design-only tree passes `validate --ci`. Code-conformance
2083
+ * tuning like the rest of `rules.conformance`: it enters the analyzer's
2084
+ * digest, never the gate identity, so switching it never stales a lock.
2085
+ */
2086
+ requireCode: z.ZodOptional<z.ZodBoolean>;
2057
2087
  }, "strip", z.ZodTypeAny, {
2058
2088
  sourceRoots?: string[] | undefined;
2059
2089
  exclude?: string[] | undefined;
@@ -2070,6 +2100,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2070
2100
  }[];
2071
2101
  revisit?: string | undefined;
2072
2102
  }[] | undefined;
2103
+ requireCode?: boolean | undefined;
2073
2104
  }, {
2074
2105
  sourceRoots?: string[] | undefined;
2075
2106
  exclude?: string[] | undefined;
@@ -2086,6 +2117,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2086
2117
  }[];
2087
2118
  revisit?: string | undefined;
2088
2119
  }[] | undefined;
2120
+ requireCode?: boolean | undefined;
2089
2121
  }>>;
2090
2122
  /** Project-default design depth (see DesignDepthSchema); subsystems may override. */
2091
2123
  designDepth: z.ZodOptional<z.ZodEnum<["components", "interfaces", "implementations", "narratives"]>>;
@@ -2148,6 +2180,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2148
2180
  }[];
2149
2181
  revisit?: string | undefined;
2150
2182
  }[] | undefined;
2183
+ requireCode?: boolean | undefined;
2151
2184
  } | undefined;
2152
2185
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
2153
2186
  }, {
@@ -2209,6 +2242,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2209
2242
  }[];
2210
2243
  revisit?: string | undefined;
2211
2244
  }[] | undefined;
2245
+ requireCode?: boolean | undefined;
2212
2246
  } | undefined;
2213
2247
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
2214
2248
  }>>;
@@ -2506,6 +2540,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2506
2540
  }[];
2507
2541
  revisit?: string | undefined;
2508
2542
  }[] | undefined;
2543
+ requireCode?: boolean | undefined;
2509
2544
  } | undefined;
2510
2545
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
2511
2546
  };
@@ -2530,7 +2565,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2530
2565
  description?: string | undefined;
2531
2566
  externals?: Record<string, {
2532
2567
  project?: string | undefined;
2533
- source?: {
2568
+ source?: string | {
2534
2569
  path?: string | undefined;
2535
2570
  hosted?: string | undefined;
2536
2571
  git?: string | undefined;
@@ -2597,7 +2632,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2597
2632
  description?: string | undefined;
2598
2633
  externals?: Record<string, {
2599
2634
  project?: string | undefined;
2600
- source?: {
2635
+ source?: string | {
2601
2636
  path?: string | undefined;
2602
2637
  hosted?: string | undefined;
2603
2638
  git?: string | undefined;
@@ -2699,6 +2734,7 @@ declare const ProjectConfigSchema: z.ZodObject<{
2699
2734
  }[];
2700
2735
  revisit?: string | undefined;
2701
2736
  }[] | undefined;
2737
+ requireCode?: boolean | undefined;
2702
2738
  } | undefined;
2703
2739
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
2704
2740
  } | undefined;
@@ -2853,6 +2889,23 @@ interface DeclaredExternal {
2853
2889
  /** The declaration's `use` as written, deduplicated in first-seen order; empty when it imports nothing. */
2854
2890
  use: string[];
2855
2891
  }
2892
+ /** The forms an external's `source` is accepted in, as a refusal names them. */
2893
+ declare const EXTERNAL_SOURCE_FORMS = "a location string (`../sibling`, `hosted:<id>`, `<git url>` or `<git url>#<commit>`) or an object ({ path } | { hosted } | { git, ref?, dir? })";
2894
+ /** An external's source as read: its object form, normalized, or why it cannot be read. */
2895
+ interface ReadExternalSource {
2896
+ /** The object form; absent when nothing usable was written. */
2897
+ source?: ExternalSource;
2898
+ /** Why the source cannot be used as written — the declaration's problem, never a load failure. */
2899
+ problem?: string;
2900
+ }
2901
+ /**
2902
+ * external_declaration.source read leniently: the location string or the
2903
+ * object form, normalized into the object form. A source of the wrong shape,
2904
+ * one naming none or several of path/hosted/git, one naming `commit`, or a
2905
+ * string the grammar refuses is answered as the problem — never thrown — so a
2906
+ * configuration holding it still loads and every other external still shows.
2907
+ */
2908
+ declare function readExternalSource(written: unknown): ReadExternalSource;
2856
2909
  /** One `use` entry: `*`, or a public name of [a-z0-9-_]+. */
2857
2910
  declare const USE_ENTRY_RE: RegExp;
2858
2911
  /**
@@ -3679,6 +3732,15 @@ declare function assertProjectInitialized(): void;
3679
3732
  interface StateId {
3680
3733
  algorithm: string;
3681
3734
  digest: string;
3735
+ /**
3736
+ * On a gate identity only: the same gate identity computed under the
3737
+ * algorithm the bound project's lock record was taken with, when that is the
3738
+ * previous (full-content, format-2) algorithm this release can still
3739
+ * recompute. Present only while the record on disk carries it, so such a
3740
+ * lock is judged exactly as it was taken. Never recorded: a lock writes
3741
+ * algorithm and digest alone.
3742
+ */
3743
+ asRecorded?: StateId;
3682
3744
  }
3683
3745
  /**
3684
3746
  * Deterministic CONTENT StateId over the current (request-scoped) project's
@@ -3695,6 +3757,18 @@ declare function computeStateId(): StateId;
3695
3757
  * marker as computeStateId, so for a project with no members the two agree.
3696
3758
  */
3697
3759
  declare function computeOwnStateId(): StateId;
3760
+ /**
3761
+ * state_hash.ownDesign — the DESIGN identity of the bound project's own specs:
3762
+ * exactly ownTree's selection, storage-independence and ordering, but each
3763
+ * spec digested in its design view — an implementation, a type and a
3764
+ * component through their type's designView (code linkage and timestamps
3765
+ * out), every other kind with its timestamps out (canonicalize drops them).
3766
+ * A part's implementation needs no re-expression from the part's root: the
3767
+ * paths are linkage, and the view leaves them out. Algorithm marker
3768
+ * `sha256-design`, so it never compares equal to a content identity. The
3769
+ * content half of the gate identity from lock format 3 on.
3770
+ */
3771
+ declare function computeOwnDesignStateId(): StateId;
3698
3772
 
3699
3773
  /** primitive | named | list | set | map | optional | union | async | applied | result. */
3700
3774
  type TypeForm = 'primitive' | 'named' | 'list' | 'set' | 'map' | 'optional' | 'union' | 'async' | 'applied' | 'result';
@@ -4158,6 +4232,16 @@ interface CodeIndex {
4158
4232
  * written down in the code.
4159
4233
  */
4160
4234
  forwardsOf(path: string, name: string, container?: string): ForwardedName[];
4235
+ /**
4236
+ * Whether realization has BEGUN for whatever names these files: true when at
4237
+ * least one of them resolves to a file the run analyzed or could read (any
4238
+ * status but missing or escaped). The one definition every code rule shares
4239
+ * — an implementation has begun when any file it names (its sourcePath or a
4240
+ * method's) exists, a type when its own file or a method's exists; a simPath
4241
+ * harness does not count, it follows the code it wires. Before that a named
4242
+ * file is planned, not missing. Pure: over the index's own facts.
4243
+ */
4244
+ holdsAny(files: string[]): boolean;
4161
4245
  }
4162
4246
  /** One (file, name) a republished name resolves to (forwarded_name). */
4163
4247
  interface ForwardedName {
@@ -4995,6 +5079,7 @@ declare const ProfileDefSchema: z.ZodObject<{
4995
5079
  }[];
4996
5080
  revisit?: string | undefined;
4997
5081
  }>, "many">>;
5082
+ requireCode: z.ZodOptional<z.ZodBoolean>;
4998
5083
  }, "strip", z.ZodTypeAny, {
4999
5084
  sourceRoots?: string[] | undefined;
5000
5085
  exclude?: string[] | undefined;
@@ -5011,6 +5096,7 @@ declare const ProfileDefSchema: z.ZodObject<{
5011
5096
  }[];
5012
5097
  revisit?: string | undefined;
5013
5098
  }[] | undefined;
5099
+ requireCode?: boolean | undefined;
5014
5100
  }, {
5015
5101
  sourceRoots?: string[] | undefined;
5016
5102
  exclude?: string[] | undefined;
@@ -5027,6 +5113,7 @@ declare const ProfileDefSchema: z.ZodObject<{
5027
5113
  }[];
5028
5114
  revisit?: string | undefined;
5029
5115
  }[] | undefined;
5116
+ requireCode?: boolean | undefined;
5030
5117
  }>>>;
5031
5118
  designDepth: z.ZodOptional<z.ZodOptional<z.ZodEnum<["components", "interfaces", "implementations", "narratives"]>>>;
5032
5119
  }, "strip", z.ZodTypeAny, {
@@ -5088,6 +5175,7 @@ declare const ProfileDefSchema: z.ZodObject<{
5088
5175
  }[];
5089
5176
  revisit?: string | undefined;
5090
5177
  }[] | undefined;
5178
+ requireCode?: boolean | undefined;
5091
5179
  } | undefined;
5092
5180
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
5093
5181
  }, {
@@ -5149,6 +5237,7 @@ declare const ProfileDefSchema: z.ZodObject<{
5149
5237
  }[];
5150
5238
  revisit?: string | undefined;
5151
5239
  }[] | undefined;
5240
+ requireCode?: boolean | undefined;
5152
5241
  } | undefined;
5153
5242
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
5154
5243
  }>>;
@@ -5226,6 +5315,7 @@ declare const ProfileDefSchema: z.ZodObject<{
5226
5315
  }[];
5227
5316
  revisit?: string | undefined;
5228
5317
  }[] | undefined;
5318
+ requireCode?: boolean | undefined;
5229
5319
  } | undefined;
5230
5320
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
5231
5321
  } | undefined;
@@ -5289,6 +5379,7 @@ declare const ProfileDefSchema: z.ZodObject<{
5289
5379
  }[];
5290
5380
  revisit?: string | undefined;
5291
5381
  }[] | undefined;
5382
+ requireCode?: boolean | undefined;
5292
5383
  } | undefined;
5293
5384
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
5294
5385
  } | undefined;
@@ -5805,6 +5896,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
5805
5896
  }[];
5806
5897
  revisit?: string | undefined;
5807
5898
  }>, "many">>;
5899
+ requireCode: z.ZodOptional<z.ZodBoolean>;
5808
5900
  }, "strip", z.ZodTypeAny, {
5809
5901
  sourceRoots?: string[] | undefined;
5810
5902
  exclude?: string[] | undefined;
@@ -5821,6 +5913,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
5821
5913
  }[];
5822
5914
  revisit?: string | undefined;
5823
5915
  }[] | undefined;
5916
+ requireCode?: boolean | undefined;
5824
5917
  }, {
5825
5918
  sourceRoots?: string[] | undefined;
5826
5919
  exclude?: string[] | undefined;
@@ -5837,6 +5930,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
5837
5930
  }[];
5838
5931
  revisit?: string | undefined;
5839
5932
  }[] | undefined;
5933
+ requireCode?: boolean | undefined;
5840
5934
  }>>>;
5841
5935
  designDepth: z.ZodOptional<z.ZodOptional<z.ZodEnum<["components", "interfaces", "implementations", "narratives"]>>>;
5842
5936
  }, "strip", z.ZodTypeAny, {
@@ -5898,6 +5992,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
5898
5992
  }[];
5899
5993
  revisit?: string | undefined;
5900
5994
  }[] | undefined;
5995
+ requireCode?: boolean | undefined;
5901
5996
  } | undefined;
5902
5997
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
5903
5998
  }, {
@@ -5959,6 +6054,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
5959
6054
  }[];
5960
6055
  revisit?: string | undefined;
5961
6056
  }[] | undefined;
6057
+ requireCode?: boolean | undefined;
5962
6058
  } | undefined;
5963
6059
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
5964
6060
  }>>;
@@ -6036,6 +6132,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
6036
6132
  }[];
6037
6133
  revisit?: string | undefined;
6038
6134
  }[] | undefined;
6135
+ requireCode?: boolean | undefined;
6039
6136
  } | undefined;
6040
6137
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
6041
6138
  } | undefined;
@@ -6099,6 +6196,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
6099
6196
  }[];
6100
6197
  revisit?: string | undefined;
6101
6198
  }[] | undefined;
6199
+ requireCode?: boolean | undefined;
6102
6200
  } | undefined;
6103
6201
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
6104
6202
  } | undefined;
@@ -6454,6 +6552,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
6454
6552
  }[];
6455
6553
  revisit?: string | undefined;
6456
6554
  }[] | undefined;
6555
+ requireCode?: boolean | undefined;
6457
6556
  } | undefined;
6458
6557
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
6459
6558
  } | undefined;
@@ -6583,6 +6682,7 @@ declare const DeclarativePackSchema: z.ZodObject<{
6583
6682
  }[];
6584
6683
  revisit?: string | undefined;
6585
6684
  }[] | undefined;
6685
+ requireCode?: boolean | undefined;
6586
6686
  } | undefined;
6587
6687
  designDepth?: "components" | "interfaces" | "implementations" | "narratives" | undefined;
6588
6688
  } | undefined;
@@ -7077,6 +7177,14 @@ interface ValidationIssue {
7077
7177
  * root. Absent on the owner's own run.
7078
7178
  */
7079
7179
  project?: string;
7180
+ /**
7181
+ * True on a finding reported beside a gate rather than by it — the live
7182
+ * comparison of an external with its producer (family_validator.advise).
7183
+ * Printed and counted with its severity, but never part of a failure
7184
+ * decision: `valid` and `validate --ci` both ignore it, because the pin is
7185
+ * the reproducible gate and a live producer is not.
7186
+ */
7187
+ advisory?: boolean;
7080
7188
  }
7081
7189
  interface ValidationResult {
7082
7190
  valid: boolean;
@@ -7100,6 +7208,12 @@ interface ValidationResult {
7100
7208
  * and on a family run.
7101
7209
  */
7102
7210
  analysis?: CodeAnalysis;
7211
+ /**
7212
+ * A family run only: the aliases of the bound project's externals the run
7213
+ * composed as part of its gate (their producers in reach) — the advisory
7214
+ * live comparison skips them, so they get no second word.
7215
+ */
7216
+ composed?: string[];
7103
7217
  }
7104
7218
  /**
7105
7219
  * project_verdict — one project's line in a family run: which project it is,
@@ -7230,7 +7344,7 @@ declare function builtinProjectKinds(): string[];
7230
7344
  /**
7231
7345
  * The gate identity a lock records and every staleness check compares
7232
7346
  * (ispec_validator/ivalidator_portal.computeGateStateId): the project's OWN
7233
- * content identity, the design doctrine, its own consumed contract inputs, its
7347
+ * DESIGN identity (code linkage and timestamps out), the design doctrine, its own consumed contract inputs, its
7234
7348
  * `composition`, and each direct member's composition subject — read from the
7235
7349
  * member's own lock record, never recomputed and never its specs. So a
7236
7350
  * parent's identity costs its own tree plus one lock file per direct member,
@@ -7306,6 +7420,31 @@ interface CodeAnalysis {
7306
7420
  warnings: number;
7307
7421
  notices: number;
7308
7422
  }
7423
+ /**
7424
+ * spec_digest_reading — which reading of a spec file a lock record's per-spec
7425
+ * digests were taken in. `content`: the raw text, line endings normalized —
7426
+ * what every record written before format 3 carries (the field absent).
7427
+ * `design`: the spec's design view (code linkage and timestamps out) in
7428
+ * canonical form, so a sourcePath, a whitespace edit or a no-op re-save never
7429
+ * moves it.
7430
+ */
7431
+ type SpecDigestReading = 'content' | 'design';
7432
+ /**
7433
+ * lock_reexpression — provenance on a lock record a tool carried into a newer
7434
+ * reading after PROVING the design is the one approved (its own earlier
7435
+ * identity, recomputed over the tree as it stands, matched), rather than a
7436
+ * human re-approving it. Who approved and when stay the human's.
7437
+ */
7438
+ interface LockReexpression {
7439
+ /** ISO-8601 time of the re-expression. */
7440
+ at: string;
7441
+ /** The gate algorithm the record carried before. */
7442
+ fromAlgorithm: string;
7443
+ /** The per-spec digest reading the record carried before. */
7444
+ fromReading: SpecDigestReading;
7445
+ /** The command that re-expressed it (e.g. `wairon doctor --fix`), never a person. */
7446
+ by: string;
7447
+ }
7309
7448
  /** A project's approval state as seen from its own root. */
7310
7449
  type ProjectApprovalState = 'approved' | 'drifted' | 'never';
7311
7450
  /** How a parent's lock pinned a member. */
@@ -7403,8 +7542,26 @@ interface LockRecord {
7403
7542
  * one release as the member pins; never written from stage 5 on.
7404
7543
  */
7405
7544
  children?: Record<string, string>;
7406
- /** The record format: 2 from stage 5 on; absent means format 1. */
7545
+ /**
7546
+ * The record format: 3 from the release in which code linkage left the
7547
+ * approval (stateId under the design gate algorithm, `specs` in the design
7548
+ * reading), 2 from stage 5 on, absent means format 1. A format-2 record stays
7549
+ * valid as written: it is judged under its own algorithm (StateId.asRecorded)
7550
+ * and its own reading until it is re-locked or re-expressed.
7551
+ */
7407
7552
  format?: number;
7553
+ /**
7554
+ * The reading `specs` was digested in: `design` on every record written from
7555
+ * format 3 on, absent on an earlier record (raw-content digests). A reader
7556
+ * compares the tree in the reading the record names, never in another.
7557
+ */
7558
+ specsReading?: SpecDigestReading;
7559
+ /**
7560
+ * Present when a tool carried this record into the current reading and gate
7561
+ * algorithm after proving the design unchanged (doctor --fix), instead of a
7562
+ * human re-approving it.
7563
+ */
7564
+ reexpressed?: LockReexpression;
7408
7565
  /**
7409
7566
  * Each DIRECT member, keyed by alias → its composition subject and approval
7410
7567
  * state as they stood when this project locked. Present (possibly empty) on
@@ -8220,7 +8377,8 @@ interface LockStatus {
8220
8377
  /**
8221
8378
  * Resolve the project's lock into one of three honest states, comparing the
8222
8379
  * recorded gate identity against the one the caller computed now
8223
- * (validator_portal.computeGateStateId). Nothing is hashed here: the gate
8380
+ * (validator_portal.computeGateStateId) — or, for a format-2 record, against
8381
+ * its asRecorded reading. Nothing is hashed here: the gate
8224
8382
  * identity is the validator's, because the doctrine it covers is the
8225
8383
  * validator's rule set.
8226
8384
  *
@@ -15149,6 +15307,57 @@ declare function storedTypeMethod<M extends StoredTypeMethod>(method: M): Stored
15149
15307
  declare function typeSourceFiles(type: Pick<TypeSpec, 'sourcePath'> & {
15150
15308
  methods?: ReadonlyArray<Pick<TypeMethod, 'sourcePath'>>;
15151
15309
  }): string[];
15310
+ /** Each schema's fields, split into the design (approved) and the code linkage (not approved). */
15311
+ declare const DESIGN_VIEW_FIELDS: {
15312
+ readonly implementation: {
15313
+ readonly linkage: readonly ["sourcePath", "simPath", "injectedParams", "conformance", "createdAt", "updatedAt"];
15314
+ readonly design: readonly ["id", "name", "description", "contract", "technologies", "methods", "detail", "previousIds", "lint", "ext", "status"];
15315
+ };
15316
+ readonly implementationMethod: {
15317
+ readonly linkage: readonly ["sourcePath", "symbol", "exportedVia", "conformance"];
15318
+ readonly design: readonly ["name", "narrative", "detail", "intent", "calls", "ext"];
15319
+ };
15320
+ readonly type: {
15321
+ readonly linkage: readonly ["sourcePath", "symbol", "createdAt", "updatedAt"];
15322
+ readonly design: readonly ["kind", "id", "name", "description", "subsystem", "group", "fields", "methods", "componentClass", "invariants", "database", "table", "linkedEntity", "previousIds", "lint", "ext", "params", "returns", "values", "holds"];
15323
+ };
15324
+ readonly typeMethod: {
15325
+ readonly linkage: readonly ["sourcePath", "symbol"];
15326
+ readonly design: readonly ["name", "signature", "params", "returns", "description"];
15327
+ };
15328
+ readonly component: {
15329
+ readonly linkage: readonly ["externalLinks", "createdAt", "updatedAt"];
15330
+ readonly design: readonly ["id", "name", "description", "subsystem", "componentType", "owns", "dependsOn", "portalType", "basePath", "auth", "dispatch", "mounts", "durability", "dependencyClass", "emits", "subscribesTo", "patterns", "variant", "previousIds", "lint", "ext", "status"];
15331
+ };
15332
+ readonly portalMount: {
15333
+ readonly linkage: readonly ["via"];
15334
+ readonly design: readonly ["portal", "prefixes"];
15335
+ };
15336
+ };
15337
+ /**
15338
+ * implementation_spec.designView — this implementation as the approval sees it:
15339
+ * its own sourcePath, simPath, injectedParams and conformance tier, each
15340
+ * method's sourcePath, symbol, exportedVia and conformance tier, and the
15341
+ * timestamps left out. Everything else — the contract, technologies, the
15342
+ * detail dial, each method's narrative, intent and calls, the rename trace,
15343
+ * lint, ext, status — stays. Pure: a sourcePath added, moved or removed never
15344
+ * changes it. Reads a stored (raw) spec as readily as a loaded one.
15345
+ */
15346
+ declare function implementationDesignView<T extends object>(impl: T): T;
15347
+ /**
15348
+ * type_spec.designView — this type as the approval sees it: its own sourcePath
15349
+ * and symbol, each method's sourcePath and symbol, and the timestamps left
15350
+ * out; its fields, methods' signatures and descriptions, invariants, values,
15351
+ * holds, rename trace, lint and ext stay. Pure.
15352
+ */
15353
+ declare function typeDesignView<T extends object>(type: T): T;
15354
+ /**
15355
+ * component_spec.designView — this component as the approval sees it: each
15356
+ * mount's `via` (the router entry the portal's file exports, held to code by
15357
+ * UNREALIZED_EXPORT_HANDLE), its externalLinks and the timestamps left out. A
15358
+ * mount's portal and prefixes, and every other field, stay. Pure.
15359
+ */
15360
+ declare function componentDesignView<T extends object>(component: T): T;
15152
15361
  declare const SurfaceOriginSchema: z.ZodEnum<["generated", "exchanged", "authored"]>;
15153
15362
  type SurfaceOrigin = z.infer<typeof SurfaceOriginSchema>;
15154
15363
  /** A self-contained type definition embedded in a snapshot (closure member). */
@@ -15204,6 +15413,12 @@ declare const SurfaceTypeDefSchema: z.ZodObject<{
15204
15413
  }>, "many">>;
15205
15414
  /** A named scalar's one primitive, in place of fields; only on a value-object that declares it. */
15206
15415
  holds: z.ZodOptional<z.ZodString>;
15416
+ /**
15417
+ * The type's rename trace as the producer recorded it (previousIds), so a
15418
+ * consumer pinned to a former name reads a rename rather than a removal.
15419
+ * Provenance, never signature: it enters no digest. Absent when never renamed.
15420
+ */
15421
+ formerly: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
15207
15422
  }, "strip", z.ZodTypeAny, {
15208
15423
  id: string;
15209
15424
  name: string;
@@ -15226,6 +15441,7 @@ declare const SurfaceTypeDefSchema: z.ZodObject<{
15226
15441
  }[] | undefined;
15227
15442
  returns?: string | undefined;
15228
15443
  holds?: string | undefined;
15444
+ formerly?: string[] | undefined;
15229
15445
  }, {
15230
15446
  id: string;
15231
15447
  name: string;
@@ -15248,6 +15464,7 @@ declare const SurfaceTypeDefSchema: z.ZodObject<{
15248
15464
  kind?: string | undefined;
15249
15465
  returns?: string | undefined;
15250
15466
  holds?: string | undefined;
15467
+ formerly?: string[] | undefined;
15251
15468
  }>;
15252
15469
  type SurfaceTypeDef = z.infer<typeof SurfaceTypeDefSchema>;
15253
15470
  /** A type the producer exports by name (a typeDef export); its definition is in the type closure. */
@@ -15278,7 +15495,11 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15278
15495
  type: z.ZodDefault<z.ZodString>;
15279
15496
  /** Local name of the backing Portal in the producing project. */
15280
15497
  component: z.ZodString;
15281
- /** Full contract methods (params, returns, guarantees, effect, endpoint), resolved: a snapshot names no producer-internal source. */
15498
+ /**
15499
+ * Full contract methods (params, returns, guarantees, effect, endpoint),
15500
+ * resolved: a snapshot names no producer-internal source. A renamed method
15501
+ * carries its former names as `formerly` (provenance, outside every digest).
15502
+ */
15282
15503
  methods: z.ZodDefault<z.ZodArray<z.ZodObject<{
15283
15504
  name: z.ZodString;
15284
15505
  description: z.ZodString;
@@ -15437,6 +15658,8 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15437
15658
  } & {
15438
15659
  signature: z.ZodString;
15439
15660
  returns: z.ZodString;
15661
+ } & {
15662
+ formerly: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
15440
15663
  }, "strip", z.ZodTypeAny, {
15441
15664
  name: string;
15442
15665
  description: string;
@@ -15493,6 +15716,7 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15493
15716
  caller?: string | undefined;
15494
15717
  } | undefined;
15495
15718
  previousNames?: string[] | undefined;
15719
+ formerly?: string[] | undefined;
15496
15720
  }, {
15497
15721
  name: string;
15498
15722
  description: string;
@@ -15549,6 +15773,7 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15549
15773
  caller?: string | undefined;
15550
15774
  } | undefined;
15551
15775
  previousNames?: string[] | undefined;
15776
+ formerly?: string[] | undefined;
15552
15777
  }>, "many">>;
15553
15778
  /** The backing portal's capability dispatch table, when generic-dispatch. */
15554
15779
  dispatch: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -15637,6 +15862,15 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15637
15862
  componentType: z.ZodOptional<z.ZodString>;
15638
15863
  /** The L3 interface the export narrows to, when it narrows. */
15639
15864
  interface: z.ZodOptional<z.ZodString>;
15865
+ /**
15866
+ * The rename trace behind the entry's public name: the former public names
15867
+ * the producer's rename trace (the narrowed interface's, else the backing
15868
+ * component's previousIds) records. Carried into the pin snapshot and the
15869
+ * surface export so a consumer can follow a rename instead of reading a
15870
+ * delete plus an add. Provenance, never signature: it enters neither
15871
+ * memberDigest nor contentDigest. Absent when never renamed.
15872
+ */
15873
+ formerly: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
15640
15874
  }, "strip", z.ZodTypeAny, {
15641
15875
  id: string;
15642
15876
  type: string;
@@ -15697,6 +15931,7 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15697
15931
  caller?: string | undefined;
15698
15932
  } | undefined;
15699
15933
  previousNames?: string[] | undefined;
15934
+ formerly?: string[] | undefined;
15700
15935
  }[];
15701
15936
  component: string;
15702
15937
  details: string;
@@ -15729,6 +15964,7 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15729
15964
  capability: string;
15730
15965
  description?: string | undefined;
15731
15966
  }[] | undefined;
15967
+ formerly?: string[] | undefined;
15732
15968
  }, {
15733
15969
  id: string;
15734
15970
  name: string;
@@ -15791,6 +16027,7 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15791
16027
  caller?: string | undefined;
15792
16028
  } | undefined;
15793
16029
  previousNames?: string[] | undefined;
16030
+ formerly?: string[] | undefined;
15794
16031
  }[] | undefined;
15795
16032
  interface?: string | undefined;
15796
16033
  componentType?: string | undefined;
@@ -15821,6 +16058,7 @@ declare const SurfaceContractEntrySchema: z.ZodObject<{
15821
16058
  capability: string;
15822
16059
  description?: string | undefined;
15823
16060
  }[] | undefined;
16061
+ formerly?: string[] | undefined;
15824
16062
  }>;
15825
16063
  type SurfaceContractEntry = z.infer<typeof SurfaceContractEntrySchema>;
15826
16064
  declare const SurfaceSnapshotSchema: z.ZodObject<{
@@ -15841,7 +16079,11 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
15841
16079
  type: z.ZodDefault<z.ZodString>;
15842
16080
  /** Local name of the backing Portal in the producing project. */
15843
16081
  component: z.ZodString;
15844
- /** Full contract methods (params, returns, guarantees, effect, endpoint), resolved: a snapshot names no producer-internal source. */
16082
+ /**
16083
+ * Full contract methods (params, returns, guarantees, effect, endpoint),
16084
+ * resolved: a snapshot names no producer-internal source. A renamed method
16085
+ * carries its former names as `formerly` (provenance, outside every digest).
16086
+ */
15845
16087
  methods: z.ZodDefault<z.ZodArray<z.ZodObject<{
15846
16088
  name: z.ZodString;
15847
16089
  description: z.ZodString;
@@ -16000,6 +16242,8 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16000
16242
  } & {
16001
16243
  signature: z.ZodString;
16002
16244
  returns: z.ZodString;
16245
+ } & {
16246
+ formerly: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
16003
16247
  }, "strip", z.ZodTypeAny, {
16004
16248
  name: string;
16005
16249
  description: string;
@@ -16056,6 +16300,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16056
16300
  caller?: string | undefined;
16057
16301
  } | undefined;
16058
16302
  previousNames?: string[] | undefined;
16303
+ formerly?: string[] | undefined;
16059
16304
  }, {
16060
16305
  name: string;
16061
16306
  description: string;
@@ -16112,6 +16357,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16112
16357
  caller?: string | undefined;
16113
16358
  } | undefined;
16114
16359
  previousNames?: string[] | undefined;
16360
+ formerly?: string[] | undefined;
16115
16361
  }>, "many">>;
16116
16362
  /** The backing portal's capability dispatch table, when generic-dispatch. */
16117
16363
  dispatch: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -16200,6 +16446,15 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16200
16446
  componentType: z.ZodOptional<z.ZodString>;
16201
16447
  /** The L3 interface the export narrows to, when it narrows. */
16202
16448
  interface: z.ZodOptional<z.ZodString>;
16449
+ /**
16450
+ * The rename trace behind the entry's public name: the former public names
16451
+ * the producer's rename trace (the narrowed interface's, else the backing
16452
+ * component's previousIds) records. Carried into the pin snapshot and the
16453
+ * surface export so a consumer can follow a rename instead of reading a
16454
+ * delete plus an add. Provenance, never signature: it enters neither
16455
+ * memberDigest nor contentDigest. Absent when never renamed.
16456
+ */
16457
+ formerly: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
16203
16458
  }, "strip", z.ZodTypeAny, {
16204
16459
  id: string;
16205
16460
  type: string;
@@ -16260,6 +16515,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16260
16515
  caller?: string | undefined;
16261
16516
  } | undefined;
16262
16517
  previousNames?: string[] | undefined;
16518
+ formerly?: string[] | undefined;
16263
16519
  }[];
16264
16520
  component: string;
16265
16521
  details: string;
@@ -16292,6 +16548,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16292
16548
  capability: string;
16293
16549
  description?: string | undefined;
16294
16550
  }[] | undefined;
16551
+ formerly?: string[] | undefined;
16295
16552
  }, {
16296
16553
  id: string;
16297
16554
  name: string;
@@ -16354,6 +16611,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16354
16611
  caller?: string | undefined;
16355
16612
  } | undefined;
16356
16613
  previousNames?: string[] | undefined;
16614
+ formerly?: string[] | undefined;
16357
16615
  }[] | undefined;
16358
16616
  interface?: string | undefined;
16359
16617
  componentType?: string | undefined;
@@ -16384,6 +16642,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16384
16642
  capability: string;
16385
16643
  description?: string | undefined;
16386
16644
  }[] | undefined;
16645
+ formerly?: string[] | undefined;
16387
16646
  }>, "many">>;
16388
16647
  /** Transitive type closure of every exported signature and exported type — self-contained. */
16389
16648
  types: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -16438,6 +16697,12 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16438
16697
  }>, "many">>;
16439
16698
  /** A named scalar's one primitive, in place of fields; only on a value-object that declares it. */
16440
16699
  holds: z.ZodOptional<z.ZodString>;
16700
+ /**
16701
+ * The type's rename trace as the producer recorded it (previousIds), so a
16702
+ * consumer pinned to a former name reads a rename rather than a removal.
16703
+ * Provenance, never signature: it enters no digest. Absent when never renamed.
16704
+ */
16705
+ formerly: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
16441
16706
  }, "strip", z.ZodTypeAny, {
16442
16707
  id: string;
16443
16708
  name: string;
@@ -16460,6 +16725,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16460
16725
  }[] | undefined;
16461
16726
  returns?: string | undefined;
16462
16727
  holds?: string | undefined;
16728
+ formerly?: string[] | undefined;
16463
16729
  }, {
16464
16730
  id: string;
16465
16731
  name: string;
@@ -16482,6 +16748,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16482
16748
  kind?: string | undefined;
16483
16749
  returns?: string | undefined;
16484
16750
  holds?: string | undefined;
16751
+ formerly?: string[] | undefined;
16485
16752
  }>, "many">>;
16486
16753
  /** The producing project's effective id, beside the display-oriented projectName. */
16487
16754
  projectId: z.ZodOptional<z.ZodString>;
@@ -16569,6 +16836,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16569
16836
  caller?: string | undefined;
16570
16837
  } | undefined;
16571
16838
  previousNames?: string[] | undefined;
16839
+ formerly?: string[] | undefined;
16572
16840
  }[];
16573
16841
  component: string;
16574
16842
  details: string;
@@ -16601,6 +16869,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16601
16869
  capability: string;
16602
16870
  description?: string | undefined;
16603
16871
  }[] | undefined;
16872
+ formerly?: string[] | undefined;
16604
16873
  }[];
16605
16874
  types: {
16606
16875
  id: string;
@@ -16624,6 +16893,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16624
16893
  }[] | undefined;
16625
16894
  returns?: string | undefined;
16626
16895
  holds?: string | undefined;
16896
+ formerly?: string[] | undefined;
16627
16897
  }[];
16628
16898
  projectName: string;
16629
16899
  origin: "generated" | "exchanged" | "authored";
@@ -16704,6 +16974,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16704
16974
  caller?: string | undefined;
16705
16975
  } | undefined;
16706
16976
  previousNames?: string[] | undefined;
16977
+ formerly?: string[] | undefined;
16707
16978
  }[] | undefined;
16708
16979
  interface?: string | undefined;
16709
16980
  componentType?: string | undefined;
@@ -16734,6 +17005,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16734
17005
  capability: string;
16735
17006
  description?: string | undefined;
16736
17007
  }[] | undefined;
17008
+ formerly?: string[] | undefined;
16737
17009
  }[] | undefined;
16738
17010
  types?: {
16739
17011
  id: string;
@@ -16757,6 +17029,7 @@ declare const SurfaceSnapshotSchema: z.ZodObject<{
16757
17029
  kind?: string | undefined;
16758
17030
  returns?: string | undefined;
16759
17031
  holds?: string | undefined;
17032
+ formerly?: string[] | undefined;
16760
17033
  }[] | undefined;
16761
17034
  audience?: string | undefined;
16762
17035
  stateId?: string | undefined;
@@ -16977,8 +17250,53 @@ interface ExternalPin {
16977
17250
  /** Why an alias was unresolved or unreachable, or which used members could not be pinned. */
16978
17251
  detail?: string;
16979
17252
  }
17253
+ /**
17254
+ * external_request — what `wairon externals add` and sdd_add_external ask for:
17255
+ * one external to declare in the bound project's `.wai/project.yaml`, written
17256
+ * exactly as a person would say it.
17257
+ */
17258
+ interface ExternalRequest {
17259
+ /** The alias the project's specs will reference it by (`alias::name`). */
17260
+ alias: string;
17261
+ /** Where the producer is, in the one location grammar; omitted when the family provides it. */
17262
+ source?: string;
17263
+ /** The producer's project id when it differs from the alias. */
17264
+ project?: string;
17265
+ /** git only: the branch, tag or full commit the pin follows. */
17266
+ ref?: string;
17267
+ /** git only: the producer's root inside the repository. */
17268
+ dir?: string;
17269
+ /** Public names to import bare (`*` for all). */
17270
+ use?: string[];
17271
+ /** What the producer is to this project. */
17272
+ description?: string;
17273
+ /** Pin it right after declaring it (default true). */
17274
+ pin?: boolean;
17275
+ /** Answer what would be declared, writing nothing. */
17276
+ dryRun?: boolean;
17277
+ }
17278
+ /**
17279
+ * external_addition — the answer to declaring one external: what was written
17280
+ * (or would be, on a dry run), the producer it reached and the pin — or why
17281
+ * nothing was written, as one sentence naming the accepted form.
17282
+ */
17283
+ interface ExternalAddition {
17284
+ alias: string;
17285
+ /** Whether `.wai/project.yaml` now carries the declaration (false on a refusal and on a dry run). */
17286
+ written: boolean;
17287
+ /** The declaration as written (object form, normalized); null on a refusal. */
17288
+ declaration: ExternalDeclaration | null;
17289
+ /** The producer's project id as the producer answered to it. */
17290
+ project?: string;
17291
+ /** The pin taken right after, when asked. */
17292
+ pin?: ExternalPin | null;
17293
+ /** Why nothing was written, in one sentence naming the accepted form. */
17294
+ refusal?: string;
17295
+ /** Set when the declaration was written but its producer could not be read: why, and that nothing was pinned. */
17296
+ unreachable?: string;
17297
+ }
16980
17298
  /** The verdict on one used member of a pinned external. */
16981
- type ExternalUseState = 'unchanged' | 'changed' | 'removed' | 'unlocked' | 'unavailable';
17299
+ type ExternalUseState = 'unchanged' | 'changed' | 'removed' | 'unlocked' | 'unavailable' | 'renamed';
16982
17300
  /** external_use_status — the verdict on one used member of one pinned external. */
16983
17301
  interface ExternalUseStatus {
16984
17302
  publicName?: string;
@@ -16987,6 +17305,12 @@ interface ExternalUseStatus {
16987
17305
  /** EXTERNAL_CHECK_UNAVAILABLE on an unavailable entry — never a pass. */
16988
17306
  code?: string;
16989
17307
  detail?: string;
17308
+ /**
17309
+ * On a renamed use: the public name (and member, as `name.member`) the live
17310
+ * producer's rename trace carries the used name forward to — what the
17311
+ * consumer's references should now name.
17312
+ */
17313
+ renamedTo?: string;
16990
17314
  }
16991
17315
  /** external_status — the status of one declared external. */
16992
17316
  interface ExternalStatus {
@@ -36318,7 +36642,7 @@ type DesignExport = z.infer<typeof DesignExportSchema>;
36318
36642
 
36319
36643
  declare const DEFAULT_TARGET_DIRS: Record<string, string>;
36320
36644
  declare function defaultTargetConfig(type: 'claude' | 'gemini' | 'agy' | 'cursor' | 'copilot' | 'codex'): BuiltinTargetConfig;
36321
- declare const WAIRON_VERSION = "5.1.1-dev.103";
36645
+ declare const WAIRON_VERSION = "5.1.1-dev.105";
36322
36646
  declare const GITHUB_REPO = "SYW-Apps/Waffle-AIron";
36323
36647
  declare const ARCHITECT_AGENT_ID = "agent-architect";
36324
36648
  declare const ARCHITECT_TEMPLATE_ID = "architect";
@@ -36341,9 +36665,11 @@ declare function saveTopologyConfig(config: TopologyConfig): void;
36341
36665
  /**
36342
36666
  * iexternal_producers.resolveDeclared — every declared external of the bound
36343
36667
  * project, and every referenced project member it declares (stage 8), bound to
36344
- * its producer, each with the project's usage of it by public name.
36668
+ * its producer, each with the project's usage of it by public name. Offline,
36669
+ * nothing touches the network: a git external is bound unreachable with the
36670
+ * reason that `wairon externals status` fetches it.
36345
36671
  */
36346
- declare function resolveDeclared(): ExternalBinding[];
36672
+ declare function resolveDeclared(offline?: boolean): ExternalBinding[];
36347
36673
 
36348
36674
  /**
36349
36675
  * ipart_context.excerpt — with a part's root bound: the ParentExcerpt it can
@@ -37116,6 +37442,18 @@ declare function approvalRecord(root?: string): LockRecord | null;
37116
37442
  * which is the behaviour a project has before anyone has gated it.
37117
37443
  */
37118
37444
  declare function settledSpecPaths(root?: string): Set<string> | null;
37445
+ /**
37446
+ * approval_comparison.reexpress — the record on file carried into the design
37447
+ * reading WITHOUT a new approval, when that is provably sound: a record that
37448
+ * names no design reading (format 2) whose stateId equals gate.asRecorded —
37449
+ * the identity it certified, recomputed over the tree as it stands, so nothing
37450
+ * it covered moved. Keeps lockedAt, lockedBy, the validation and code results,
37451
+ * the members' pins and the provenance exactly; replaces stateId with the gate
37452
+ * (asRecorded dropped), specs with the design-reading capture, and adds
37453
+ * `reexpressed`. Null when there is nothing to carry or it cannot be proven.
37454
+ * Writes nothing: the caller writes the answer.
37455
+ */
37456
+ declare function reexpress(gate: StateId): LockRecord | null;
37119
37457
  /**
37120
37458
  * What the lock says about the tree as it stands: the sentence to show, and
37121
37459
  * whether it is drift.
@@ -37641,7 +37979,8 @@ declare function listSnapshots(): SurfaceSnapshot[];
37641
37979
  declare function getSnapshot(projectName: string): SurfaceSnapshot | null;
37642
37980
  declare function removeSnapshot(projectName: string): boolean;
37643
37981
  declare function pinExternals(aliases?: string[]): ExternalPin[];
37644
- declare function getExternalsStatus(): ExternalStatus[];
37982
+ /** isurface_portal.getExternalsStatus — each declared external's pin against its live producer; offline, no producer is read over the network. */
37983
+ declare function getExternalsStatus(offline?: boolean): ExternalStatus[];
37645
37984
  declare function listExternals(): ExternalListing[];
37646
37985
  declare function listPinnedExternals(): PinnedExternal[];
37647
37986
  /** isurface_portal.pinnedParent — a part's pinned parent, from its own .wai/externals files only (stage 8); null at a project. */
@@ -37664,4 +38003,4 @@ declare function schemaFingerprint(): string;
37664
38003
  */
37665
38004
  declare function loadProjectConfig(): ProjectConfig;
37666
38005
 
37667
- export { AI_PATHS, ARCHITECT_AGENT_ID, ARCHITECT_TEMPLATE_ID, type AgentBrief, AgentBriefSchema, type AgentRecord, AgentRecordSchema, type AgentStatus, AgentStatusSchema, type AgentTemplate, AgentTemplateSchema, type AnalysisGrade, type ApiKeyLocation, ApiKeyLocationSchema, type ApprovalDiff, type ApprovalVerdict, type ArchProfile, type AuthoredReference, BACKEND_COMMANDS, BUILTIN_PROFILES, type BoundaryItem, BoundaryItemSchema, type BuildContextOptions, type BuiltinTarget, type BuiltinTargetConfig, BuiltinTargetConfigSchema, BuiltinTargetSchema, BundleNotFoundError, type CallSiteFact, type CarriedDebt, type CarriedDebtKind, CarriedDebtKindSchema, CarriedDebtSchema, type CarriedFinding, type CarriedFindingEntry, CarriedFindingSchema, type CatchClause, CatchClauseSchema, ChainingMigrationRefusedError, ClaudeExporter, type ClaudeExporterOptions, type CodeIndex, type CodeModel, type ComplexityRuleConfig, ComplexityRuleConfigSchema, type ComponentRename, type ComponentSpec, ComponentSpecSchema, type ComponentType, ComponentTypeSchema, type CompositionConfig, CompositionConfigSchema, ConfigValidationError, type ConformanceRuleConfig, ConformanceRuleConfigSchema, type ConformanceTier, ConformanceTierSchema, type CrossProjectReference, CustomExporter, type CustomTarget, type CustomTargetConfig, CustomTargetConfigSchema, CustomTargetSchema, DEFAULT_TARGET_DIRS, DESIGN_APPROVALS, DESIGN_DEPENDENCY_ROLES, DESIGN_FORMAT, DESIGN_FORMAT_VERSION, type DatabaseSpec, DatabaseSpecSchema, type DeclarativePack, type DeclaredCall, type DeclaredExternal, type DeclaredMember, type DependencyClass, DependencyClassSchema, type DependencyEdge, type DependencyEdges, type DesignApproval, DesignApprovalSchema, type DesignComponent, DesignComponentSchema, type DesignDependency, type DesignDependencyRole, DesignDependencyRoleSchema, DesignDependencySchema, type DesignDepth, DesignDepthSchema, type DesignExport, type DesignExportEntry, DesignExportEntrySchema, DesignExportSchema, type DesignField, DesignFieldSchema, type DesignImplementation, DesignImplementationSchema, type DesignInterface, DesignInterfaceSchema, type DesignMethod, type DesignMethodBody, DesignMethodBodySchema, DesignMethodSchema, type DesignParam, DesignParamSchema, type DesignProject, DesignProjectSchema, type DesignSource, DesignSourceSchema, type DesignSubsystem, DesignSubsystemSchema, type DesignType, type DesignTypeRef, DesignTypeRefSchema, DesignTypeSchema, type DetectedDomainCandidate, type DiagramConfig, DiagramConfigSchema, type DiagramLineStyle, DiagramLineStyleSchema, type DiagramView, DiagramViewSchema, type DispatchBinding, DispatchBindingSchema, DoctorOptionsError, type DocumentationRuleConfig, DocumentationRuleConfigSchema, type Domain, DomainSchema, type DomainType, DomainTypeSchema, type Durability, DurabilitySchema, EXTERNAL_ALIAS_RE, type EdgeReach, type Endpoint, EndpointSchema, type EnumValue, EnumValueSchema, type EventBinding, EventBindingSchema, type ExportAliasFact, type ExportContext, type ExportKind, type ExportProblem, type ExportProblemKind, type ExportResult, type ExportTableLevel, type ExportUsage, type ExportUse, type Exporter, type ExtData, ExtDataSchema, type ExtensionPack, type ExternalBinding, type ExternalDeclaration, ExternalDeclarationSchema, type ExternalLink, ExternalLinkSchema, type ExternalLinkType, ExternalLinkTypeSchema, type ExternalListing, type ExternalLockEntry, ExternalLockEntrySchema, type ExternalPin, type ExternalPinOutcome, type ExternalRelation, type ExternalRole, type ExternalSource, type ExternalSourceKind, ExternalSourceSchema, type ExternalStatus, type ExternalUseState, type ExternalUseStatus, type ExternalsLock, ExternalsLockSchema, FULL_COMMIT_RE, type FamilyProblemKind, type FamilySwitches, type FindingDeclaration, FindingDeclarationSchema, type FindingParts, type ForeignFieldRepair, type ForwardedName, type FunctionBodyFact, GITHUB_REPO, GeminiExporter, type GenerateOptions, type GenerateSummary, type GroupSpec, GroupSpecSchema, type Guarantee, GuaranteeSchema, HOLDABLE_PRIMITIVES, type HostedRecordLookup, type HttpMethod, HttpMethodSchema, type ImplementationSpec, ImplementationSpecSchema, type ImportBindingFact, type ImportGraph, type ImportSection, type InstalledPack, type InterfaceSpec, InterfaceSpecSchema, type InternalizeDestination, type InternalizeResult, type Invariant, InvariantSchema, type InvocationKind, InvocationKindSchema, type IssueSeverity, type LegacySpecFile, type LifecycleEntrypoint, LifecycleEntrypointSchema, type LifecyclePhase, LifecyclePhaseSchema, type LintAllow, LintAllowSchema, type LintConfig, LintConfigSchema, type LoadedExtensions, type LoadedPackSkill, type LockRecord, type LockStatus, type LogLevel, type LoopKind, LoopKindSchema, type MemberAdvance, type MemberCreation, type MemberDeclaration, MemberDeclarationSchema, type MemberKind, type MemberPin, type MemberSource, type MemberStorage, type MethodEffect, MethodEffectSchema, type MethodImplementation, MethodImplementationSchema, type MethodLike, type MethodParam, MethodParamSchema, type MethodRename, type MethodSignature, MethodSignatureSchema, type MountForm, type NamedOpenApiSpec, NamedOpenApiSpecSchema, type NamingRuleConfig, NamingRuleConfigSchema, type NarrativeDetail, NarrativeDetailSchema, type NarrativeStep, NarrativeStepSchema, type NarrativeStepType, NarrativeStepTypeSchema, type OAuthFlow, OAuthFlowSchema, type OutputTarget, OutputTargetSchema, type OwnershipIndex, PATTERN_TYPES, PRIMITIVE_TYPES, PROJECT_ID_RE, PROJECT_KINDS, PUBLIC_NAME_RE, type PackDiagnosis, type PackEntry, type PackPath, type PackRef, type PackRequirement, PackRequirementSchema, type PackScope, type PackSelection, PackSelectionSchema, type ParallelBranch, ParallelBranchSchema, type ParameterFact, type ParentExcerpt, ParentExcerptSchema, type ParsedMemberSource, type PartOf, PartOfSchema, type PathsConfig, PathsConfigSchema, type PatternRef, PatternRefSchema, type PinnedExternal, type PinnedParent, type PortalAuth, PortalAuthSchema, type PortalAuthScheme, PortalAuthSchemeSchema, type PortalMount, PortalMountSchema, type PortalType, PortalTypeSchema, PreviousIdsSchema, PreviousNamesSchema, ProfileSelectionSubjectSchema, type ProjectBinding, type ProjectBindingVia, type ProjectConfig, ProjectConfigSchema, type ProjectFamily, type ProjectFamilyProblem, type ProjectIdOrigin, type ProjectIdSource, type ProjectIdentity, type ProjectIdentityProblem, type ProjectImport, type ProjectNode, ProjectNotInitializedError, type ProjectProfileSelection, ProjectProfileSelectionSchema, type ProjectRelations, type PromoteResult, type PublicInterface, PublicInterfaceSchema, type PublicInterfaceType, PublicInterfaceTypeSchema, RETIRED_STEREOTYPES, type ReadableProject, type RealizationIndex, type ReexportBindingFact, type ReferenceBinding, type ReferenceEdit, type ReferenceForm, type ReferenceLanding, type ReferenceResolution, type Registry, RegistrySchema, type RelationHealth, type RenameTraceHolders, type RequirementItem, RequirementItemSchema, type ResolutionOutcome, type ResolvedBody, type ResolvedDetail, type ResolvedExport, type ResolvedExportTable, type ResolvedExternal, ResolvedInterfaceSpecSchema, type ResolvedMethod, ResolvedMethodSignatureSchema, ResolvedTypeMethodSchema, ResolvedTypeSpecSchema, type RouteFact, type RuleCode, type RuleContext, type RuleJudgement, type RuleScope, type RulesConfig, RulesConfigSchema, SCAN_EXCLUDE_DIRS, SDD_RULES, SEMANTIC_GUARANTEES, STEP_COMMON_FIELDS, STEP_LABEL_TWINS, STEP_TYPE_FIELDS, SUPPORTED_ALIASES, SURFACE_AUDIENCES, type ScopeFilterOptions, type SddRule, type Severity, type ShapeMemberFact, type ShapeOrigin, type SignatureFacts, type SignatureResolution, type SignatureSourceFact, type SignatureTextRepair, type SourceFileFacts, type SourceFileStatus, type SpecId, type SpecIdKind, SpecIdSchema, type SpecIndex, type SpecScanOptions, type SpecStatus, SpecStatusSchema, type SpecialistRetirement, type SpecialistRetype, type StaleSignatureText, type StateId, type StatusDecor, type StatusOptions, type StatusReport, type StepConfigCode, type StepConfigProblem, type StepConfigVerdict, type StepGraph, type StoredInterfaceSpec, type StoredMethodSignature, StoredMethodSignatureSchema, type StoredTypeMethod, StoredTypeMethodSchema, type StoredTypeSpec, type SubsystemSpec, SubsystemSpecSchema, type SubsystemWriteRule, type SupportedAlias, type SurfaceAudience, SurfaceAudienceSchema, type SurfaceContractEntry, SurfaceContractEntrySchema, type SurfaceOrigin, SurfaceOriginSchema, type SurfaceRefResolution, type SurfaceSnapshot, SurfaceSnapshotSchema, type SurfaceTypeDef, SurfaceTypeDefSchema, type SurfaceTypeExport, SurfaceTypeExportSchema, type SwitchCase, SwitchCaseSchema, type SyncResult, type SystemPublicInterface, SystemPublicInterfaceSchema, type SystemSpec, SystemSpecSchema, type TargetConfig, TargetConfigSchema, type Technology, TechnologySchema, type Template, TemplateNotFoundError, TemplateSchema, type TopologyConfig, TopologyConfigSchema, type Transport, TransportSchema, type TreeExportResult, type TreeImportOptions, type TreeImportResult, type TrustedLink, TrustedLinkSchema, type TypeCanonicalization, type TypeDialect, type TypeEnumProposal, type TypeExpression, type TypeExpressionProblem, TypeExpressionSchema, type TypeField, TypeFieldSchema, type TypeForm, type TypeKind, TypeKindSchema, type TypeMethod, TypeMethodSchema, type TypeParse, type TypePosition, type TypeProblemCode, type TypeRename, type TypeRespelling, type TypeShapeFact, type TypeSpec, TypeSpecSchema, type TypeSpellingFacts, type TypeSpellingRepair, type TypedSpecKind, USE_ENTRY_RE, WAIRON_MANAGED_BANNER, WAIRON_MANAGED_MARKER, WAIRON_VERSION, type WaiPaths, WaironError, type WriteReach, activeTargetTypes, addDomain, admits, advanceMember, aiDir, aiDirAt, aiPathsAt, aliasTargetOf, ambiguityMessage, approvalKeyIn, approvalRecord, approvalVerdict, assertContainedProjectPath, assertProjectInitialized, backendCommand, backfillChainedSubprojectConfigs, backupBeside, bodySitesOf, buildCanvasDataModel, buildProjectGraph, buildRuleContext, builtinProfileIds, builtinProjectKinds, callSitesOf, canonicalTypeRef, canonicalTypeText, captureApprovedSpecs, checkDeclarativePack, clearLoaderIssues, cognitiveScore, complexityLevel, composeAgentBrief, composeRuleSequence, computeGateStateId, computeOwnStateId, computeStateId, computeStateIdAt, conceptNoun, consumedContractInputs, containedPathOf, contentDigest, createAgentRecord, createEmptyRegistry, createEmptyTopologyConfig, createMember, createProjectConfig, currentRootBinding, declareExternal, declareMember, declaredExternals, declaredMembers, declaredPackNames, declaredProfileIds, declares, declaresGlobalPacks, defaultConformanceTier, defaultNarrativeDetail, defaultPackSelections, defaultTargetConfig, deleteSpec, demoteMember, dependencyCycles, deregisterPackRef, deriveExecutionProfile, deriveMethodSignature, deriveTypeSignature, derivedDocPaths, describeProject, detectDomainCandidates, diagnoseProjectPacks, diagramSetIndex, dialectOf, diffAgainstApproval, diffSize, discoverPacks, dryRunSerializeSpecs, effectiveDetail, effectiveProjectId, emptyExtensions, emptyTypeSpellingFacts, ensureDir, ensureProjectInitialized, excerpt as excerptParent, exportDesign, exportSpecTree, exportSurface, exportTargetKey, exportUsage, externalizeSubsystem, extractTypeIdentifiers, factsFor, familyApprovals, familyNode, familyRelations, fieldTypeRefs, fieldTypesOf, findChainingParent, findChainingSubprojectsMissingConfig, findLegacySpecFiles, findProjectRoot, findSystemRoot, findTestsReferencing, fromProjectRoot, generateAgent, generateAll, generateComponentDiagram, generateDiagramSet, generateSequenceDiagram, getExporter, getExternalsStatus, getHostedLookup, getLoaderIssues, getProjectRoot, getProjectRootOverride, getRequestParentReach, getRequestProjectRoot, getSnapshot, getStatusReport, getWriteReach, globalGuideFilePath, globalPacksDir, globalPacksEnabled, globalTemplatesDir, hasContext, hasFunctionBody, headNoun, holdsState, implementationSourceFiles, importBindingOf, importNames, importSpecTree, importSurface, injectGuide, installPackFromDirectory, interfaceCanonicalTypes, interfaceGenericParameters, internalizeMember, isDraftSubsystem, isLogic, isOutsideRoot, isOwnComponentEntry, isPart, isPattern, isProjectInitialized, isProvidedBy, isRetired, isTypeVocabulary, judgesCode, keyIn, landReference, languageOfSourcePath, lineEndingFor, listDirectChainedSubprojects, listExternals, listFiles, listFilesRecursive, listInstalledPacks, listPinnedExternals, listRules, listSnapshots, loadComponentSpec, loadComponentSpecs, loadExtensionPacks, loadExtensions, loadFor as loadExtensionsFor, loadImplementationSpec, loadImplementationSpecs, loadInterfaceSpec, loadInterfaceSpecs, loadProjectConfig, loadProjectExtensions, loadProjectVariants, loadRegistry, loadSpec, loadSpecGraph, loadSubsystemSpec, loadSubsystemSpecs, loadSystemSpec, loadTopologyConfig, loadTypeSpec, loadTypeSpecs, localApprover, localGuideFilePath, localTypesOf, logger, makeScopeFilter, markSelectionsBundled, matchTypeRef, measurePackDoctrine, measurePackImpact, memberDeclarationOf, memberDigest, memberLocationOf, memberTypesOf, methodGenericParameters, methodSourceFile, methodTypeRefs, moveMember, moveMethods, moveMountToMembers, nameKey, namesAnInteger, narrativeStepForeignFields, normalizeReferences, ownerOf, packDirEntry, packEntryLabel, packEntryRef, manifestOf as packManifest, packStoreDir, parseDeclarativePack, parseDeclaredCall, parseMemberSource, parseTypeExpression, parseTypePosition, parseYaml, passesIntentFloor, pathExists, pathKey, pinExternals, pinInstalledPacksAsSelections, pinnedParent, producerOf, projectConfigExists, graph as projectFamily, projectIdentity, promoteMember, provisionProject, qualifiedTypeId, rangeProblem, readCodeAnnotation, readFileOrNull, readJsonFile, readLockRecord, readLockState, readStampVersion, readYamlFile, recordProfileSelection, registerExporter, registerPackRef, reinjectLocalGuides, relationHealth, removeDomain, removeExternal, removeMember, removePackSelection, removeSnapshot, renameAlias, renameComponent, renameProjectId as renameId, renameMethod, renameType, renderDiagram, repairForeignStepFields, repairSignatures, repairTypeSpellings, repointExternal, requiredPolicies, resolveAgentTopology, resolveBudget, resolveChainingParent, resolveDomains, resolveExpectedOutputPaths, resolveDeclared as resolveExternals, resolveImport, resolveInstalledPack, resolveProjectBinding, resolveProjectExports, resolveSignatures, resolveSubprojectForNamespace, resolveSubsystemExports, resolveVariantGuidance, retireSpecialists, returnTypeOf, rewriteReferences, runWithHostedLookup, runWithProjectBinding, runWithProjectRoot, sameContract, saveSpec, saveTopologyConfig, scanAllSpecs, schemaFingerprint, selectsFamily, serializeYaml, setExecutionTier, setProjectId as setId, setLogLevel, setProjectRoot, setProjectType, settledSpecPaths, signatureFacts, signatureTypeRefs, specIndexRetiredBy, specPathsInScope, splitNamespace, stepConfigVerdict, stepFieldsFor, stepGraph, storedMethodSignature, storedTypeMethod, syncContextFiles, technologyName, technologyTokens, toMarkdown, typeBindingOf, typeCanonicalTypes, typeDialectFor, typeGenericParameters, typeIsMany, typeMatchesRef, typeNamedRefs, typeProblemEnumProposal, typeProblemIntProposal, typeSourceFiles, typeSpellingFacts, uninstallPack, updateMember, updateSpec, upsertPackSelection, validateAsComplete, validateComponentCandidate, validateFamily, validateProject, validateProjectConfig, validateRegistry, withLineEndings, withPack, writeFile, writeFileIfChanged, writeJsonFile, writeLockRecord, writeReachDenials, writeReachPermits, writeRootGuideDelegator, writeYamlFile, writtenTypeRefs };
38006
+ export { AI_PATHS, ARCHITECT_AGENT_ID, ARCHITECT_TEMPLATE_ID, type AgentBrief, AgentBriefSchema, type AgentRecord, AgentRecordSchema, type AgentStatus, AgentStatusSchema, type AgentTemplate, AgentTemplateSchema, type AnalysisGrade, type ApiKeyLocation, ApiKeyLocationSchema, type ApprovalDiff, type ApprovalVerdict, type ArchProfile, type AuthoredReference, BACKEND_COMMANDS, BUILTIN_PROFILES, type BoundaryItem, BoundaryItemSchema, type BuildContextOptions, type BuiltinTarget, type BuiltinTargetConfig, BuiltinTargetConfigSchema, BuiltinTargetSchema, BundleNotFoundError, type CallSiteFact, type CarriedDebt, type CarriedDebtKind, CarriedDebtKindSchema, CarriedDebtSchema, type CarriedFinding, type CarriedFindingEntry, CarriedFindingSchema, type CatchClause, CatchClauseSchema, ChainingMigrationRefusedError, ClaudeExporter, type ClaudeExporterOptions, type CodeIndex, type CodeModel, type ComplexityRuleConfig, ComplexityRuleConfigSchema, type ComponentRename, type ComponentSpec, ComponentSpecSchema, type ComponentType, ComponentTypeSchema, type CompositionConfig, CompositionConfigSchema, ConfigValidationError, type ConformanceRuleConfig, ConformanceRuleConfigSchema, type ConformanceTier, ConformanceTierSchema, type CrossProjectReference, CustomExporter, type CustomTarget, type CustomTargetConfig, CustomTargetConfigSchema, CustomTargetSchema, DEFAULT_TARGET_DIRS, DESIGN_APPROVALS, DESIGN_DEPENDENCY_ROLES, DESIGN_FORMAT, DESIGN_FORMAT_VERSION, DESIGN_VIEW_FIELDS, type DatabaseSpec, DatabaseSpecSchema, type DeclarativePack, type DeclaredCall, type DeclaredExternal, type DeclaredMember, type DependencyClass, DependencyClassSchema, type DependencyEdge, type DependencyEdges, type DesignApproval, DesignApprovalSchema, type DesignComponent, DesignComponentSchema, type DesignDependency, type DesignDependencyRole, DesignDependencyRoleSchema, DesignDependencySchema, type DesignDepth, DesignDepthSchema, type DesignExport, type DesignExportEntry, DesignExportEntrySchema, DesignExportSchema, type DesignField, DesignFieldSchema, type DesignImplementation, DesignImplementationSchema, type DesignInterface, DesignInterfaceSchema, type DesignMethod, type DesignMethodBody, DesignMethodBodySchema, DesignMethodSchema, type DesignParam, DesignParamSchema, type DesignProject, DesignProjectSchema, type DesignSource, DesignSourceSchema, type DesignSubsystem, DesignSubsystemSchema, type DesignType, type DesignTypeRef, DesignTypeRefSchema, DesignTypeSchema, type DetectedDomainCandidate, type DiagramConfig, DiagramConfigSchema, type DiagramLineStyle, DiagramLineStyleSchema, type DiagramView, DiagramViewSchema, type DispatchBinding, DispatchBindingSchema, DoctorOptionsError, type DocumentationRuleConfig, DocumentationRuleConfigSchema, type Domain, DomainSchema, type DomainType, DomainTypeSchema, type Durability, DurabilitySchema, EXTERNAL_ALIAS_RE, EXTERNAL_SOURCE_FORMS, type EdgeReach, type Endpoint, EndpointSchema, type EnumValue, EnumValueSchema, type EventBinding, EventBindingSchema, type ExportAliasFact, type ExportContext, type ExportKind, type ExportProblem, type ExportProblemKind, type ExportResult, type ExportTableLevel, type ExportUsage, type ExportUse, type Exporter, type ExtData, ExtDataSchema, type ExtensionPack, type ExternalAddition, type ExternalBinding, type ExternalDeclaration, ExternalDeclarationSchema, type ExternalLink, ExternalLinkSchema, type ExternalLinkType, ExternalLinkTypeSchema, type ExternalListing, type ExternalLockEntry, ExternalLockEntrySchema, type ExternalPin, type ExternalPinOutcome, type ExternalRelation, type ExternalRequest, type ExternalRole, type ExternalSource, type ExternalSourceKind, ExternalSourceSchema, type ExternalStatus, type ExternalUseState, type ExternalUseStatus, type ExternalsLock, ExternalsLockSchema, FULL_COMMIT_RE, type FamilyProblemKind, type FamilySwitches, type FindingDeclaration, FindingDeclarationSchema, type FindingParts, type ForeignFieldRepair, type ForwardedName, type FunctionBodyFact, GITHUB_REPO, GeminiExporter, type GenerateOptions, type GenerateSummary, type GroupSpec, GroupSpecSchema, type Guarantee, GuaranteeSchema, HOLDABLE_PRIMITIVES, type HostedRecordLookup, type HttpMethod, HttpMethodSchema, type ImplementationSpec, ImplementationSpecSchema, type ImportBindingFact, type ImportGraph, type ImportSection, type InstalledPack, type InterfaceSpec, InterfaceSpecSchema, type InternalizeDestination, type InternalizeResult, type Invariant, InvariantSchema, type InvocationKind, InvocationKindSchema, type IssueSeverity, type LegacySpecFile, type LifecycleEntrypoint, LifecycleEntrypointSchema, type LifecyclePhase, LifecyclePhaseSchema, type LintAllow, LintAllowSchema, type LintConfig, LintConfigSchema, type LoadedExtensions, type LoadedPackSkill, type LockRecord, type LockStatus, type LogLevel, type LoopKind, LoopKindSchema, type MemberAdvance, type MemberCreation, type MemberDeclaration, MemberDeclarationSchema, type MemberKind, type MemberPin, type MemberSource, type MemberStorage, type MethodEffect, MethodEffectSchema, type MethodImplementation, MethodImplementationSchema, type MethodLike, type MethodParam, MethodParamSchema, type MethodRename, type MethodSignature, MethodSignatureSchema, type MountForm, type NamedOpenApiSpec, NamedOpenApiSpecSchema, type NamingRuleConfig, NamingRuleConfigSchema, type NarrativeDetail, NarrativeDetailSchema, type NarrativeStep, NarrativeStepSchema, type NarrativeStepType, NarrativeStepTypeSchema, type OAuthFlow, OAuthFlowSchema, type OutputTarget, OutputTargetSchema, type OwnershipIndex, PATTERN_TYPES, PRIMITIVE_TYPES, PROJECT_ID_RE, PROJECT_KINDS, PUBLIC_NAME_RE, type PackDiagnosis, type PackEntry, type PackPath, type PackRef, type PackRequirement, PackRequirementSchema, type PackScope, type PackSelection, PackSelectionSchema, type ParallelBranch, ParallelBranchSchema, type ParameterFact, type ParentExcerpt, ParentExcerptSchema, type ParsedMemberSource, type PartOf, PartOfSchema, type PathsConfig, PathsConfigSchema, type PatternRef, PatternRefSchema, type PinnedExternal, type PinnedParent, type PortalAuth, PortalAuthSchema, type PortalAuthScheme, PortalAuthSchemeSchema, type PortalMount, PortalMountSchema, type PortalType, PortalTypeSchema, PreviousIdsSchema, PreviousNamesSchema, ProfileSelectionSubjectSchema, type ProjectBinding, type ProjectBindingVia, type ProjectConfig, ProjectConfigSchema, type ProjectFamily, type ProjectFamilyProblem, type ProjectIdOrigin, type ProjectIdSource, type ProjectIdentity, type ProjectIdentityProblem, type ProjectImport, type ProjectNode, ProjectNotInitializedError, type ProjectProfileSelection, ProjectProfileSelectionSchema, type ProjectRelations, type PromoteResult, type PublicInterface, PublicInterfaceSchema, type PublicInterfaceType, PublicInterfaceTypeSchema, RETIRED_STEREOTYPES, type ReadExternalSource, type ReadableProject, type RealizationIndex, type ReexportBindingFact, type ReferenceBinding, type ReferenceEdit, type ReferenceForm, type ReferenceLanding, type ReferenceResolution, type Registry, RegistrySchema, type RelationHealth, type RenameTraceHolders, type RequirementItem, RequirementItemSchema, type ResolutionOutcome, type ResolvedBody, type ResolvedDetail, type ResolvedExport, type ResolvedExportTable, type ResolvedExternal, ResolvedInterfaceSpecSchema, type ResolvedMethod, ResolvedMethodSignatureSchema, ResolvedTypeMethodSchema, ResolvedTypeSpecSchema, type RouteFact, type RuleCode, type RuleContext, type RuleJudgement, type RuleScope, type RulesConfig, RulesConfigSchema, SCAN_EXCLUDE_DIRS, SDD_RULES, SEMANTIC_GUARANTEES, STEP_COMMON_FIELDS, STEP_LABEL_TWINS, STEP_TYPE_FIELDS, SUPPORTED_ALIASES, SURFACE_AUDIENCES, type ScopeFilterOptions, type SddRule, type Severity, type ShapeMemberFact, type ShapeOrigin, type SignatureFacts, type SignatureResolution, type SignatureSourceFact, type SignatureTextRepair, type SourceFileFacts, type SourceFileStatus, type SpecId, type SpecIdKind, SpecIdSchema, type SpecIndex, type SpecScanOptions, type SpecStatus, SpecStatusSchema, type SpecialistRetirement, type SpecialistRetype, type StaleSignatureText, type StateId, type StatusDecor, type StatusOptions, type StatusReport, type StepConfigCode, type StepConfigProblem, type StepConfigVerdict, type StepGraph, type StoredInterfaceSpec, type StoredMethodSignature, StoredMethodSignatureSchema, type StoredTypeMethod, StoredTypeMethodSchema, type StoredTypeSpec, type SubsystemSpec, SubsystemSpecSchema, type SubsystemWriteRule, type SupportedAlias, type SurfaceAudience, SurfaceAudienceSchema, type SurfaceContractEntry, SurfaceContractEntrySchema, type SurfaceOrigin, SurfaceOriginSchema, type SurfaceRefResolution, type SurfaceSnapshot, SurfaceSnapshotSchema, type SurfaceTypeDef, SurfaceTypeDefSchema, type SurfaceTypeExport, SurfaceTypeExportSchema, type SwitchCase, SwitchCaseSchema, type SyncResult, type SystemPublicInterface, SystemPublicInterfaceSchema, type SystemSpec, SystemSpecSchema, type TargetConfig, TargetConfigSchema, type Technology, TechnologySchema, type Template, TemplateNotFoundError, TemplateSchema, type TopologyConfig, TopologyConfigSchema, type Transport, TransportSchema, type TreeExportResult, type TreeImportOptions, type TreeImportResult, type TrustedLink, TrustedLinkSchema, type TypeCanonicalization, type TypeDialect, type TypeEnumProposal, type TypeExpression, type TypeExpressionProblem, TypeExpressionSchema, type TypeField, TypeFieldSchema, type TypeForm, type TypeKind, TypeKindSchema, type TypeMethod, TypeMethodSchema, type TypeParse, type TypePosition, type TypeProblemCode, type TypeRename, type TypeRespelling, type TypeShapeFact, type TypeSpec, TypeSpecSchema, type TypeSpellingFacts, type TypeSpellingRepair, type TypedSpecKind, USE_ENTRY_RE, WAIRON_MANAGED_BANNER, WAIRON_MANAGED_MARKER, WAIRON_VERSION, type WaiPaths, WaironError, type WriteReach, activeTargetTypes, addDomain, admits, advanceMember, aiDir, aiDirAt, aiPathsAt, aliasTargetOf, ambiguityMessage, approvalKeyIn, approvalRecord, approvalVerdict, assertContainedProjectPath, assertProjectInitialized, backendCommand, backfillChainedSubprojectConfigs, backupBeside, bodySitesOf, buildCanvasDataModel, buildProjectGraph, buildRuleContext, builtinProfileIds, builtinProjectKinds, callSitesOf, canonicalTypeRef, canonicalTypeText, captureApprovedSpecs, checkDeclarativePack, clearLoaderIssues, cognitiveScore, complexityLevel, componentDesignView, composeAgentBrief, composeRuleSequence, computeGateStateId, computeOwnDesignStateId as computeOwnDesignId, computeOwnStateId, computeStateId, computeStateIdAt, conceptNoun, consumedContractInputs, containedPathOf, contentDigest, createAgentRecord, createEmptyRegistry, createEmptyTopologyConfig, createMember, createProjectConfig, currentRootBinding, declareExternal, declareMember, declaredExternals, declaredMembers, declaredPackNames, declaredProfileIds, declares, declaresGlobalPacks, defaultConformanceTier, defaultNarrativeDetail, defaultPackSelections, defaultTargetConfig, deleteSpec, demoteMember, dependencyCycles, deregisterPackRef, deriveExecutionProfile, deriveMethodSignature, deriveTypeSignature, derivedDocPaths, describeProject, detectDomainCandidates, diagnoseProjectPacks, diagramSetIndex, dialectOf, diffAgainstApproval, diffSize, discoverPacks, dryRunSerializeSpecs, effectiveDetail, effectiveProjectId, emptyExtensions, emptyTypeSpellingFacts, ensureDir, ensureProjectInitialized, excerpt as excerptParent, exportDesign, exportSpecTree, exportSurface, exportTargetKey, exportUsage, externalizeSubsystem, extractTypeIdentifiers, factsFor, familyApprovals, familyNode, familyRelations, fieldTypeRefs, fieldTypesOf, findChainingParent, findChainingSubprojectsMissingConfig, findLegacySpecFiles, findProjectRoot, findSystemRoot, findTestsReferencing, fromProjectRoot, generateAgent, generateAll, generateComponentDiagram, generateDiagramSet, generateSequenceDiagram, getExporter, getExternalsStatus, getHostedLookup, getLoaderIssues, getProjectRoot, getProjectRootOverride, getRequestParentReach, getRequestProjectRoot, getSnapshot, getStatusReport, getWriteReach, globalGuideFilePath, globalPacksDir, globalPacksEnabled, globalTemplatesDir, hasContext, hasFunctionBody, headNoun, holdsState, implementationDesignView, implementationSourceFiles, importBindingOf, importNames, importSpecTree, importSurface, injectGuide, installPackFromDirectory, interfaceCanonicalTypes, interfaceGenericParameters, internalizeMember, isDraftSubsystem, isLogic, isOutsideRoot, isOwnComponentEntry, isPart, isPattern, isProjectInitialized, isProvidedBy, isRetired, isTypeVocabulary, judgesCode, keyIn, landReference, languageOfSourcePath, lineEndingFor, listDirectChainedSubprojects, listExternals, listFiles, listFilesRecursive, listInstalledPacks, listPinnedExternals, listRules, listSnapshots, loadComponentSpec, loadComponentSpecs, loadExtensionPacks, loadExtensions, loadFor as loadExtensionsFor, loadImplementationSpec, loadImplementationSpecs, loadInterfaceSpec, loadInterfaceSpecs, loadProjectConfig, loadProjectExtensions, loadProjectVariants, loadRegistry, loadSpec, loadSpecGraph, loadSubsystemSpec, loadSubsystemSpecs, loadSystemSpec, loadTopologyConfig, loadTypeSpec, loadTypeSpecs, localApprover, localGuideFilePath, localTypesOf, logger, makeScopeFilter, markSelectionsBundled, matchTypeRef, measurePackDoctrine, measurePackImpact, memberDeclarationOf, memberDigest, memberLocationOf, memberTypesOf, methodGenericParameters, methodSourceFile, methodTypeRefs, moveMember, moveMethods, moveMountToMembers, nameKey, namesAnInteger, narrativeStepForeignFields, normalizeReferences, ownerOf, packDirEntry, packEntryLabel, packEntryRef, manifestOf as packManifest, packStoreDir, parseDeclarativePack, parseDeclaredCall, parseMemberSource, parseTypeExpression, parseTypePosition, parseYaml, passesIntentFloor, pathExists, pathKey, pinExternals, pinInstalledPacksAsSelections, pinnedParent, producerOf, projectConfigExists, graph as projectFamily, projectIdentity, promoteMember, provisionProject, qualifiedTypeId, rangeProblem, readCodeAnnotation, readExternalSource, readFileOrNull, readJsonFile, readLockRecord, readLockState, readStampVersion, readYamlFile, recordProfileSelection, reexpress, registerExporter, registerPackRef, reinjectLocalGuides, relationHealth, removeDomain, removeExternal, removeMember, removePackSelection, removeSnapshot, renameAlias, renameComponent, renameProjectId as renameId, renameMethod, renameType, renderDiagram, repairForeignStepFields, repairSignatures, repairTypeSpellings, repointExternal, requiredPolicies, resolveAgentTopology, resolveBudget, resolveChainingParent, resolveDomains, resolveExpectedOutputPaths, resolveDeclared as resolveExternals, resolveImport, resolveInstalledPack, resolveProjectBinding, resolveProjectExports, resolveSignatures, resolveSubprojectForNamespace, resolveSubsystemExports, resolveVariantGuidance, retireSpecialists, returnTypeOf, rewriteReferences, runWithHostedLookup, runWithProjectBinding, runWithProjectRoot, sameContract, saveSpec, saveTopologyConfig, scanAllSpecs, schemaFingerprint, selectsFamily, serializeYaml, setExecutionTier, setProjectId as setId, setLogLevel, setProjectRoot, setProjectType, settledSpecPaths, signatureFacts, signatureTypeRefs, specIndexRetiredBy, specPathsInScope, splitNamespace, stepConfigVerdict, stepFieldsFor, stepGraph, storedMethodSignature, storedTypeMethod, syncContextFiles, technologyName, technologyTokens, toMarkdown, typeBindingOf, typeCanonicalTypes, typeDesignView, typeDialectFor, typeGenericParameters, typeIsMany, typeMatchesRef, typeNamedRefs, typeProblemEnumProposal, typeProblemIntProposal, typeSourceFiles, typeSpellingFacts, uninstallPack, updateMember, updateSpec, upsertPackSelection, validateAsComplete, validateComponentCandidate, validateFamily, validateProject, validateProjectConfig, validateRegistry, withLineEndings, withPack, writeFile, writeFileIfChanged, writeJsonFile, writeLockRecord, writeReachDenials, writeReachPermits, writeRootGuideDelegator, writeYamlFile, writtenTypeRefs };