@maycombhq/sdk 2.0.0-beta.27.1 → 2.0.0-beta.28.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/npm/core/api.d.ts +534 -1
- package/npm/core/cancel.d.ts +7 -0
- package/npm/core/declared-links.d.ts +44 -1
- package/npm/core/facts-join.d.ts +14 -0
- package/npm/core/fs.d.ts +7 -0
- package/npm/core/link-candidates.d.ts +50 -1
- package/npm/core/printer.d.ts +16 -2
- package/npm/core/record-cache.d.ts +10 -0
- package/npm/index.js +226 -13
- package/package.json +1 -1
package/npm/core/api.d.ts
CHANGED
|
@@ -566,8 +566,42 @@ import { z } from "zod";
|
|
|
566
566
|
* one edited by hand refuses the run, 409 code `assistant-files-edited`). A run's view carries
|
|
567
567
|
* `problems`: a repo the run stopped on after two Copilot sessions added nothing, with what
|
|
568
568
|
* verify rejected and why. Additive only.
|
|
569
|
+
* 3.13.0 (beta.28, the owner's decisions of 2026-11-12): Delete this link on the canvas. POST
|
|
570
|
+
* /api/links/delete writes a curated suppress (`{ action: suppress, target: <Interface id>,
|
|
571
|
+
* value: null }`, as `atticus catalog edits --curate` writes for a deleted generated file) of
|
|
572
|
+
* every Interface behind a link, then builds, as one local job; GET /api/links/deleted lists the
|
|
573
|
+
* links deleted so, and POST /api/links/deleted/undo removes one's decisions and builds again.
|
|
574
|
+
* Edit the map: POST /api/map/edits takes the changes staged on the canvas (deletes as above,
|
|
575
|
+
* adds as POST /api/declared-links writes them, redirects as both), checks them all (422 with
|
|
576
|
+
* `problems` by place, nothing written), writes them, then builds once, as one local job whose
|
|
577
|
+
* result is `MapEditsResult` (with the caller repos they touch). A problem may carry
|
|
578
|
+
* `problems`. Additive only.
|
|
579
|
+
* 3.14.0 (beta.28.1, "nothing slow runs silently"): the Connect panel's read and its preview as
|
|
580
|
+
* jobs. GET /api/links/candidates with `job=1` and POST /api/links/connect with `job: true`
|
|
581
|
+
* answer 202 JobAccepted at once; the job prints each step (its progress message is the last
|
|
582
|
+
* line it said), Stop (POST /api/jobs/{jobId}/cancel) ends it between steps, and its result's
|
|
583
|
+
* `answer` is the answer the request gives without `job` (or `problem`, refused). Without
|
|
584
|
+
* `job`, both answer as before. GET /api/facts/{repo}/preview takes `job=1` the same way (the
|
|
585
|
+
* panel after a correction). Additive only.
|
|
586
|
+
* Also in 3.14.0 (beta.28.1, field report 4): connecting two boxes never dead-ends. GET
|
|
587
|
+
* /api/links/candidates lists every call of A: one that has an arrow drawn is `joined` (with
|
|
588
|
+
* `joins`, the box it goes to), to move from the same panel; one the join ties to something no
|
|
589
|
+
* arrow is drawn for is `undrawn`, as loose as one that joins nothing; one placed outside to a
|
|
590
|
+
* target no box draws is listed `outside` with `joins`, where before it was left out; one with
|
|
591
|
+
* an arrow to this very box is `here` (`now`, its API: a pairing with that API is refused,
|
|
592
|
+
* 409); one a person paired with the box it goes to says who (`pairedBy`). POST
|
|
593
|
+
* /api/declared-links (and Edit the map's adds) from a box no System of the profiles is (a repo
|
|
594
|
+
* the manifest lists with no System) adds that System to the repo's profile first, and says so
|
|
595
|
+
* (`created`), and Undo of its last declaration takes that System away again (`removed`).
|
|
596
|
+
* Additive only.
|
|
597
|
+
* Also in 3.14.0 (beta.28.1, field report 5): Apply (POST /api/facts/{repo}/apply) writes the kept facts
|
|
598
|
+
* with the rejected ones left out (`verify --write` exit 3): its job ends done, code 0, and
|
|
599
|
+
* its result (`FactsApplyResult`) carries `leftOut`, how many facts were left out, beside the
|
|
600
|
+
* lines naming each with the file to fix it in. Additive only. Apply to every repo (POST
|
|
601
|
+
* /api/facts/apply-all) the same: a repo that wrote with facts left out is applied, and its
|
|
602
|
+
* result carries `leftOut` (all repos) and `leftOutRepos` (how many repos left some out).
|
|
569
603
|
*/
|
|
570
|
-
export declare const API_VERSION = "3.
|
|
604
|
+
export declare const API_VERSION = "3.14.0";
|
|
571
605
|
export declare const DEFAULT_PORT = 4321;
|
|
572
606
|
/** RFC 9457 problem details, used for every error. */
|
|
573
607
|
/**
|
|
@@ -601,6 +635,10 @@ export declare const Problem: z.ZodObject<{
|
|
|
601
635
|
file: z.ZodString;
|
|
602
636
|
}, z.core.$strip>>>;
|
|
603
637
|
code: z.ZodOptional<z.ZodString>;
|
|
638
|
+
problems: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
639
|
+
edit: z.ZodNumber;
|
|
640
|
+
message: z.ZodString;
|
|
641
|
+
}, z.core.$strip>>>;
|
|
604
642
|
}, z.core.$strip>;
|
|
605
643
|
export declare const CatalogRecord: z.ZodUnion<[z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]]>;
|
|
606
644
|
export declare const RecordPage: z.ZodObject<{
|
|
@@ -4604,6 +4642,469 @@ export declare const CatalogPruneRequest: z.ZodObject<{
|
|
|
4604
4642
|
count: z.ZodNumber;
|
|
4605
4643
|
plan: z.ZodString;
|
|
4606
4644
|
}, z.core.$strict>;
|
|
4645
|
+
/**
|
|
4646
|
+
* 3.13.0 (beta.28, the owner's decision of 2026-11-12): Delete this link on the canvas. POST
|
|
4647
|
+
* /api/links/delete takes every Interface behind a link (GET /api/graph/edge-calls when the view
|
|
4648
|
+
* lists fewer) and its two ends' names, as the inline confirm listed them.
|
|
4649
|
+
*/
|
|
4650
|
+
export declare const LinkDeleteRequest: z.ZodObject<{
|
|
4651
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4652
|
+
from: z.ZodString;
|
|
4653
|
+
to: z.ZodString;
|
|
4654
|
+
}, z.core.$strict>;
|
|
4655
|
+
export type LinkDeleteRequestT = z.infer<typeof LinkDeleteRequest>;
|
|
4656
|
+
/** 3.13.0: GET /api/links/deleted, the links deleted on the canvas, each with its decisions. */
|
|
4657
|
+
export declare const DeletedLinksView: z.ZodObject<{
|
|
4658
|
+
links: z.ZodArray<z.ZodObject<{
|
|
4659
|
+
from: z.ZodString;
|
|
4660
|
+
to: z.ZodString;
|
|
4661
|
+
calls: z.ZodNumber;
|
|
4662
|
+
by: z.ZodString;
|
|
4663
|
+
at: z.ZodString;
|
|
4664
|
+
gone: z.ZodOptional<z.ZodBoolean>;
|
|
4665
|
+
redirect: z.ZodOptional<z.ZodBoolean>;
|
|
4666
|
+
decisions: z.ZodArray<z.ZodObject<{
|
|
4667
|
+
id: z.ZodString;
|
|
4668
|
+
target: z.ZodString;
|
|
4669
|
+
file: z.ZodString;
|
|
4670
|
+
gone: z.ZodOptional<z.ZodBoolean>;
|
|
4671
|
+
}, z.core.$strip>>;
|
|
4672
|
+
}, z.core.$strip>>;
|
|
4673
|
+
}, z.core.$strip>;
|
|
4674
|
+
export type DeletedLinksViewT = z.infer<typeof DeletedLinksView>;
|
|
4675
|
+
/** 3.13.0: POST /api/links/deleted/undo, Bring back: the decisions of one deleted link. */
|
|
4676
|
+
export declare const LinkUndeleteRequest: z.ZodObject<{
|
|
4677
|
+
decisions: z.ZodArray<z.ZodString>;
|
|
4678
|
+
}, z.core.$strict>;
|
|
4679
|
+
export type LinkUndeleteRequestT = z.infer<typeof LinkUndeleteRequest>;
|
|
4680
|
+
/**
|
|
4681
|
+
* 3.13.0 (beta.28, Edit the map): a link added on the canvas, exactly what Declare a link… writes
|
|
4682
|
+
* (POST /api/declared-links, without `preview`): a topic the system publishes or listens on, or a
|
|
4683
|
+
* gateway route it calls, in the profile that has the system.
|
|
4684
|
+
*/
|
|
4685
|
+
export declare const MapEditAdd: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
4686
|
+
kind: z.ZodLiteral<"topic">;
|
|
4687
|
+
system: z.ZodString;
|
|
4688
|
+
topic: z.ZodString;
|
|
4689
|
+
side: z.ZodEnum<{
|
|
4690
|
+
publishes: "publishes";
|
|
4691
|
+
listens: "listens";
|
|
4692
|
+
}>;
|
|
4693
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4694
|
+
kind: z.ZodLiteral<"call">;
|
|
4695
|
+
system: z.ZodString;
|
|
4696
|
+
route: z.ZodString;
|
|
4697
|
+
}, z.core.$strict>], "kind">;
|
|
4698
|
+
export type MapEditAddT = z.infer<typeof MapEditAdd>;
|
|
4699
|
+
/**
|
|
4700
|
+
* 3.13.0: a link added from a repo's box, exactly what Connect to… writes (POST /api/links/connect
|
|
4701
|
+
* without `rule` and `preview`): the person's pairing of each of the repo's calls named with an
|
|
4702
|
+
* API of the other box, one `link` line each in `facts/<from>.corrections.jsonl` (ADR 0174).
|
|
4703
|
+
*/
|
|
4704
|
+
export declare const MapEditPair: z.ZodObject<{
|
|
4705
|
+
from: z.ZodString;
|
|
4706
|
+
to: z.ZodObject<{
|
|
4707
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
4708
|
+
system: z.ZodOptional<z.ZodString>;
|
|
4709
|
+
}, z.core.$strict>;
|
|
4710
|
+
pairs: z.ZodArray<z.ZodObject<{
|
|
4711
|
+
call: z.ZodString;
|
|
4712
|
+
api: z.ZodString;
|
|
4713
|
+
}, z.core.$strip>>;
|
|
4714
|
+
}, z.core.$strict>;
|
|
4715
|
+
export type MapEditPairT = z.infer<typeof MapEditPair>;
|
|
4716
|
+
/**
|
|
4717
|
+
* 3.13.0: one change staged on the canvas. `delete` is Delete this link's (every Interface behind
|
|
4718
|
+
* the link and its two ends); an add is Declare a link…'s (`add`, from a system's box) or Connect
|
|
4719
|
+
* to…'s (`pair`, from a repo's box); `redirect` is a delete and an add together, one row.
|
|
4720
|
+
*/
|
|
4721
|
+
/**
|
|
4722
|
+
* 3.13.0: an arrow taken away, as Delete this link takes it: every Interface behind it (an empty
|
|
4723
|
+
* list is said as the change's problem, by its place) and its two ends.
|
|
4724
|
+
*/
|
|
4725
|
+
export declare const MapEditDelete: z.ZodObject<{
|
|
4726
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4727
|
+
from: z.ZodString;
|
|
4728
|
+
to: z.ZodString;
|
|
4729
|
+
}, z.core.$strict>;
|
|
4730
|
+
export declare const MapEdit: z.ZodUnion<readonly [z.ZodObject<{
|
|
4731
|
+
kind: z.ZodLiteral<"delete">;
|
|
4732
|
+
delete: z.ZodObject<{
|
|
4733
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4734
|
+
from: z.ZodString;
|
|
4735
|
+
to: z.ZodString;
|
|
4736
|
+
}, z.core.$strict>;
|
|
4737
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4738
|
+
kind: z.ZodLiteral<"add">;
|
|
4739
|
+
add: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
4740
|
+
kind: z.ZodLiteral<"topic">;
|
|
4741
|
+
system: z.ZodString;
|
|
4742
|
+
topic: z.ZodString;
|
|
4743
|
+
side: z.ZodEnum<{
|
|
4744
|
+
publishes: "publishes";
|
|
4745
|
+
listens: "listens";
|
|
4746
|
+
}>;
|
|
4747
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4748
|
+
kind: z.ZodLiteral<"call">;
|
|
4749
|
+
system: z.ZodString;
|
|
4750
|
+
route: z.ZodString;
|
|
4751
|
+
}, z.core.$strict>], "kind">;
|
|
4752
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4753
|
+
kind: z.ZodLiteral<"add">;
|
|
4754
|
+
pair: z.ZodObject<{
|
|
4755
|
+
from: z.ZodString;
|
|
4756
|
+
to: z.ZodObject<{
|
|
4757
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
4758
|
+
system: z.ZodOptional<z.ZodString>;
|
|
4759
|
+
}, z.core.$strict>;
|
|
4760
|
+
pairs: z.ZodArray<z.ZodObject<{
|
|
4761
|
+
call: z.ZodString;
|
|
4762
|
+
api: z.ZodString;
|
|
4763
|
+
}, z.core.$strip>>;
|
|
4764
|
+
}, z.core.$strict>;
|
|
4765
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4766
|
+
kind: z.ZodLiteral<"redirect">;
|
|
4767
|
+
delete: z.ZodObject<{
|
|
4768
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4769
|
+
from: z.ZodString;
|
|
4770
|
+
to: z.ZodString;
|
|
4771
|
+
}, z.core.$strict>;
|
|
4772
|
+
add: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
4773
|
+
kind: z.ZodLiteral<"topic">;
|
|
4774
|
+
system: z.ZodString;
|
|
4775
|
+
topic: z.ZodString;
|
|
4776
|
+
side: z.ZodEnum<{
|
|
4777
|
+
publishes: "publishes";
|
|
4778
|
+
listens: "listens";
|
|
4779
|
+
}>;
|
|
4780
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4781
|
+
kind: z.ZodLiteral<"call">;
|
|
4782
|
+
system: z.ZodString;
|
|
4783
|
+
route: z.ZodString;
|
|
4784
|
+
}, z.core.$strict>], "kind">;
|
|
4785
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4786
|
+
kind: z.ZodLiteral<"redirect">;
|
|
4787
|
+
delete: z.ZodObject<{
|
|
4788
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4789
|
+
from: z.ZodString;
|
|
4790
|
+
to: z.ZodString;
|
|
4791
|
+
}, z.core.$strict>;
|
|
4792
|
+
pair: z.ZodObject<{
|
|
4793
|
+
from: z.ZodString;
|
|
4794
|
+
to: z.ZodObject<{
|
|
4795
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
4796
|
+
system: z.ZodOptional<z.ZodString>;
|
|
4797
|
+
}, z.core.$strict>;
|
|
4798
|
+
pairs: z.ZodArray<z.ZodObject<{
|
|
4799
|
+
call: z.ZodString;
|
|
4800
|
+
api: z.ZodString;
|
|
4801
|
+
}, z.core.$strip>>;
|
|
4802
|
+
}, z.core.$strict>;
|
|
4803
|
+
}, z.core.$strict>]>;
|
|
4804
|
+
export type MapEditT = z.infer<typeof MapEdit>;
|
|
4805
|
+
/** 3.13.0: POST /api/map/edits, every change staged, applied together with one build. */
|
|
4806
|
+
export declare const MapEditsRequest: z.ZodObject<{
|
|
4807
|
+
edits: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
4808
|
+
kind: z.ZodLiteral<"delete">;
|
|
4809
|
+
delete: z.ZodObject<{
|
|
4810
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4811
|
+
from: z.ZodString;
|
|
4812
|
+
to: z.ZodString;
|
|
4813
|
+
}, z.core.$strict>;
|
|
4814
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4815
|
+
kind: z.ZodLiteral<"add">;
|
|
4816
|
+
add: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
4817
|
+
kind: z.ZodLiteral<"topic">;
|
|
4818
|
+
system: z.ZodString;
|
|
4819
|
+
topic: z.ZodString;
|
|
4820
|
+
side: z.ZodEnum<{
|
|
4821
|
+
publishes: "publishes";
|
|
4822
|
+
listens: "listens";
|
|
4823
|
+
}>;
|
|
4824
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4825
|
+
kind: z.ZodLiteral<"call">;
|
|
4826
|
+
system: z.ZodString;
|
|
4827
|
+
route: z.ZodString;
|
|
4828
|
+
}, z.core.$strict>], "kind">;
|
|
4829
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4830
|
+
kind: z.ZodLiteral<"add">;
|
|
4831
|
+
pair: z.ZodObject<{
|
|
4832
|
+
from: z.ZodString;
|
|
4833
|
+
to: z.ZodObject<{
|
|
4834
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
4835
|
+
system: z.ZodOptional<z.ZodString>;
|
|
4836
|
+
}, z.core.$strict>;
|
|
4837
|
+
pairs: z.ZodArray<z.ZodObject<{
|
|
4838
|
+
call: z.ZodString;
|
|
4839
|
+
api: z.ZodString;
|
|
4840
|
+
}, z.core.$strip>>;
|
|
4841
|
+
}, z.core.$strict>;
|
|
4842
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4843
|
+
kind: z.ZodLiteral<"redirect">;
|
|
4844
|
+
delete: z.ZodObject<{
|
|
4845
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4846
|
+
from: z.ZodString;
|
|
4847
|
+
to: z.ZodString;
|
|
4848
|
+
}, z.core.$strict>;
|
|
4849
|
+
add: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
4850
|
+
kind: z.ZodLiteral<"topic">;
|
|
4851
|
+
system: z.ZodString;
|
|
4852
|
+
topic: z.ZodString;
|
|
4853
|
+
side: z.ZodEnum<{
|
|
4854
|
+
publishes: "publishes";
|
|
4855
|
+
listens: "listens";
|
|
4856
|
+
}>;
|
|
4857
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4858
|
+
kind: z.ZodLiteral<"call">;
|
|
4859
|
+
system: z.ZodString;
|
|
4860
|
+
route: z.ZodString;
|
|
4861
|
+
}, z.core.$strict>], "kind">;
|
|
4862
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
4863
|
+
kind: z.ZodLiteral<"redirect">;
|
|
4864
|
+
delete: z.ZodObject<{
|
|
4865
|
+
interfaces: z.ZodArray<z.ZodString>;
|
|
4866
|
+
from: z.ZodString;
|
|
4867
|
+
to: z.ZodString;
|
|
4868
|
+
}, z.core.$strict>;
|
|
4869
|
+
pair: z.ZodObject<{
|
|
4870
|
+
from: z.ZodString;
|
|
4871
|
+
to: z.ZodObject<{
|
|
4872
|
+
repo: z.ZodOptional<z.ZodString>;
|
|
4873
|
+
system: z.ZodOptional<z.ZodString>;
|
|
4874
|
+
}, z.core.$strict>;
|
|
4875
|
+
pairs: z.ZodArray<z.ZodObject<{
|
|
4876
|
+
call: z.ZodString;
|
|
4877
|
+
api: z.ZodString;
|
|
4878
|
+
}, z.core.$strip>>;
|
|
4879
|
+
}, z.core.$strict>;
|
|
4880
|
+
}, z.core.$strict>]>>;
|
|
4881
|
+
}, z.core.$strict>;
|
|
4882
|
+
export type MapEditsRequestT = z.infer<typeof MapEditsRequest>;
|
|
4883
|
+
/** 3.13.0: a 422 of POST /api/map/edits: each change that can't be made, by its place (from 0). */
|
|
4884
|
+
export declare const MapEditProblem: z.ZodObject<{
|
|
4885
|
+
edit: z.ZodNumber;
|
|
4886
|
+
message: z.ZodString;
|
|
4887
|
+
}, z.core.$strip>;
|
|
4888
|
+
export type MapEditProblemT = z.infer<typeof MapEditProblem>;
|
|
4889
|
+
/**
|
|
4890
|
+
* 3.13.0: the result of POST /api/map/edits's job (GET /api/jobs/{id}'s `result`): its code and
|
|
4891
|
+
* lines, each change's outcome by its place (`saved`; `failed`, with why; `taken-back`, written
|
|
4892
|
+
* then removed because a later one failed; `not-tried`), whether the catalog was built, the
|
|
4893
|
+
* caller repos the changes touch (each deleted link's caller's repo, each pairing's repo, each
|
|
4894
|
+
* declaration's system's repos in the manifests) for one Copilot Read it again, the repos a new
|
|
4895
|
+
* link still waits on, and a refused build's listing.
|
|
4896
|
+
*/
|
|
4897
|
+
export declare const MapEditsResult: z.ZodObject<{
|
|
4898
|
+
code: z.ZodNumber;
|
|
4899
|
+
lines: z.ZodArray<z.ZodString>;
|
|
4900
|
+
edits: z.ZodArray<z.ZodObject<{
|
|
4901
|
+
edit: z.ZodNumber;
|
|
4902
|
+
kind: z.ZodEnum<{
|
|
4903
|
+
delete: "delete";
|
|
4904
|
+
redirect: "redirect";
|
|
4905
|
+
add: "add";
|
|
4906
|
+
}>;
|
|
4907
|
+
state: z.ZodEnum<{
|
|
4908
|
+
failed: "failed";
|
|
4909
|
+
saved: "saved";
|
|
4910
|
+
"taken-back": "taken-back";
|
|
4911
|
+
"not-tried": "not-tried";
|
|
4912
|
+
}>;
|
|
4913
|
+
message: z.ZodOptional<z.ZodString>;
|
|
4914
|
+
}, z.core.$strip>>;
|
|
4915
|
+
built: z.ZodBoolean;
|
|
4916
|
+
callers: z.ZodArray<z.ZodString>;
|
|
4917
|
+
waitsOn: z.ZodArray<z.ZodString>;
|
|
4918
|
+
refused: z.ZodOptional<z.ZodObject<{
|
|
4919
|
+
reasons: z.ZodArray<z.ZodEnum<{
|
|
4920
|
+
"nothing-read": "nothing-read";
|
|
4921
|
+
empty: "empty";
|
|
4922
|
+
"unexplained-removals": "unexplained-removals";
|
|
4923
|
+
"large-removals": "large-removals";
|
|
4924
|
+
"hand-edits": "hand-edits";
|
|
4925
|
+
"not-upgraded": "not-upgraded";
|
|
4926
|
+
}>>;
|
|
4927
|
+
message: z.ZodString;
|
|
4928
|
+
removals: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4929
|
+
path: z.ZodString;
|
|
4930
|
+
kind: z.ZodString;
|
|
4931
|
+
id: z.ZodString;
|
|
4932
|
+
repos: z.ZodArray<z.ZodString>;
|
|
4933
|
+
explainedBy: z.ZodArray<z.ZodString>;
|
|
4934
|
+
reasons: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
4935
|
+
input: "input";
|
|
4936
|
+
build: "build";
|
|
4937
|
+
archived: "archived";
|
|
4938
|
+
manifest: "manifest";
|
|
4939
|
+
curated: "curated";
|
|
4940
|
+
slot: "slot";
|
|
4941
|
+
}>>>;
|
|
4942
|
+
inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4943
|
+
what: z.ZodEnum<{
|
|
4944
|
+
other: "other";
|
|
4945
|
+
inputs: "inputs";
|
|
4946
|
+
"org-pack": "org-pack";
|
|
4947
|
+
proposals: "proposals";
|
|
4948
|
+
shared: "shared";
|
|
4949
|
+
answers: "answers";
|
|
4950
|
+
pairings: "pairings";
|
|
4951
|
+
curated: "curated";
|
|
4952
|
+
traffic: "traffic";
|
|
4953
|
+
federated: "federated";
|
|
4954
|
+
}>;
|
|
4955
|
+
path: z.ZodString;
|
|
4956
|
+
}, z.core.$strip>>>;
|
|
4957
|
+
}, z.core.$strip>>>;
|
|
4958
|
+
unexplained: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4959
|
+
path: z.ZodString;
|
|
4960
|
+
kind: z.ZodString;
|
|
4961
|
+
id: z.ZodString;
|
|
4962
|
+
repos: z.ZodArray<z.ZodString>;
|
|
4963
|
+
explainedBy: z.ZodArray<z.ZodString>;
|
|
4964
|
+
reasons: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
4965
|
+
input: "input";
|
|
4966
|
+
build: "build";
|
|
4967
|
+
archived: "archived";
|
|
4968
|
+
manifest: "manifest";
|
|
4969
|
+
curated: "curated";
|
|
4970
|
+
slot: "slot";
|
|
4971
|
+
}>>>;
|
|
4972
|
+
inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4973
|
+
what: z.ZodEnum<{
|
|
4974
|
+
other: "other";
|
|
4975
|
+
inputs: "inputs";
|
|
4976
|
+
"org-pack": "org-pack";
|
|
4977
|
+
proposals: "proposals";
|
|
4978
|
+
shared: "shared";
|
|
4979
|
+
answers: "answers";
|
|
4980
|
+
pairings: "pairings";
|
|
4981
|
+
curated: "curated";
|
|
4982
|
+
traffic: "traffic";
|
|
4983
|
+
federated: "federated";
|
|
4984
|
+
}>;
|
|
4985
|
+
path: z.ZodString;
|
|
4986
|
+
}, z.core.$strip>>>;
|
|
4987
|
+
}, z.core.$strip>>>;
|
|
4988
|
+
allowRemovals: z.ZodOptional<z.ZodNumber>;
|
|
4989
|
+
edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4990
|
+
path: z.ZodString;
|
|
4991
|
+
how: z.ZodEnum<{
|
|
4992
|
+
added: "added";
|
|
4993
|
+
changed: "changed";
|
|
4994
|
+
deleted: "deleted";
|
|
4995
|
+
}>;
|
|
4996
|
+
}, z.core.$strip>>>;
|
|
4997
|
+
discardEdits: z.ZodOptional<z.ZodNumber>;
|
|
4998
|
+
unread: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4999
|
+
repo: z.ZodString;
|
|
5000
|
+
why: z.ZodString;
|
|
5001
|
+
}, z.core.$strip>>>;
|
|
5002
|
+
command: z.ZodString;
|
|
5003
|
+
plan: z.ZodOptional<z.ZodString>;
|
|
5004
|
+
}, z.core.$strip>>;
|
|
5005
|
+
}, z.core.$strip>;
|
|
5006
|
+
export type MapEditsResultT = z.infer<typeof MapEditsResult>;
|
|
5007
|
+
/**
|
|
5008
|
+
* 3.14.0: the result of POST /api/facts/{repo}/apply's job (GET /api/jobs/{id}'s `result`): its
|
|
5009
|
+
* code and the lines verify printed; `refused`, the listing of a build that waits for a confirm;
|
|
5010
|
+
* `leftOut` (beta.28.1), how many rejected facts the write left out (the lines name each); `next`,
|
|
5011
|
+
* a step to take first (Sync the repos).
|
|
5012
|
+
*/
|
|
5013
|
+
export declare const FactsApplyResult: z.ZodObject<{
|
|
5014
|
+
code: z.ZodNumber;
|
|
5015
|
+
lines: z.ZodArray<z.ZodString>;
|
|
5016
|
+
refused: z.ZodOptional<z.ZodObject<{
|
|
5017
|
+
reasons: z.ZodArray<z.ZodEnum<{
|
|
5018
|
+
"nothing-read": "nothing-read";
|
|
5019
|
+
empty: "empty";
|
|
5020
|
+
"unexplained-removals": "unexplained-removals";
|
|
5021
|
+
"large-removals": "large-removals";
|
|
5022
|
+
"hand-edits": "hand-edits";
|
|
5023
|
+
"not-upgraded": "not-upgraded";
|
|
5024
|
+
}>>;
|
|
5025
|
+
message: z.ZodString;
|
|
5026
|
+
removals: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
5027
|
+
path: z.ZodString;
|
|
5028
|
+
kind: z.ZodString;
|
|
5029
|
+
id: z.ZodString;
|
|
5030
|
+
repos: z.ZodArray<z.ZodString>;
|
|
5031
|
+
explainedBy: z.ZodArray<z.ZodString>;
|
|
5032
|
+
reasons: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
5033
|
+
input: "input";
|
|
5034
|
+
build: "build";
|
|
5035
|
+
archived: "archived";
|
|
5036
|
+
manifest: "manifest";
|
|
5037
|
+
curated: "curated";
|
|
5038
|
+
slot: "slot";
|
|
5039
|
+
}>>>;
|
|
5040
|
+
inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
5041
|
+
what: z.ZodEnum<{
|
|
5042
|
+
other: "other";
|
|
5043
|
+
inputs: "inputs";
|
|
5044
|
+
"org-pack": "org-pack";
|
|
5045
|
+
proposals: "proposals";
|
|
5046
|
+
shared: "shared";
|
|
5047
|
+
answers: "answers";
|
|
5048
|
+
pairings: "pairings";
|
|
5049
|
+
curated: "curated";
|
|
5050
|
+
traffic: "traffic";
|
|
5051
|
+
federated: "federated";
|
|
5052
|
+
}>;
|
|
5053
|
+
path: z.ZodString;
|
|
5054
|
+
}, z.core.$strip>>>;
|
|
5055
|
+
}, z.core.$strip>>>;
|
|
5056
|
+
unexplained: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
5057
|
+
path: z.ZodString;
|
|
5058
|
+
kind: z.ZodString;
|
|
5059
|
+
id: z.ZodString;
|
|
5060
|
+
repos: z.ZodArray<z.ZodString>;
|
|
5061
|
+
explainedBy: z.ZodArray<z.ZodString>;
|
|
5062
|
+
reasons: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
5063
|
+
input: "input";
|
|
5064
|
+
build: "build";
|
|
5065
|
+
archived: "archived";
|
|
5066
|
+
manifest: "manifest";
|
|
5067
|
+
curated: "curated";
|
|
5068
|
+
slot: "slot";
|
|
5069
|
+
}>>>;
|
|
5070
|
+
inputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
5071
|
+
what: z.ZodEnum<{
|
|
5072
|
+
other: "other";
|
|
5073
|
+
inputs: "inputs";
|
|
5074
|
+
"org-pack": "org-pack";
|
|
5075
|
+
proposals: "proposals";
|
|
5076
|
+
shared: "shared";
|
|
5077
|
+
answers: "answers";
|
|
5078
|
+
pairings: "pairings";
|
|
5079
|
+
curated: "curated";
|
|
5080
|
+
traffic: "traffic";
|
|
5081
|
+
federated: "federated";
|
|
5082
|
+
}>;
|
|
5083
|
+
path: z.ZodString;
|
|
5084
|
+
}, z.core.$strip>>>;
|
|
5085
|
+
}, z.core.$strip>>>;
|
|
5086
|
+
allowRemovals: z.ZodOptional<z.ZodNumber>;
|
|
5087
|
+
edits: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
5088
|
+
path: z.ZodString;
|
|
5089
|
+
how: z.ZodEnum<{
|
|
5090
|
+
added: "added";
|
|
5091
|
+
changed: "changed";
|
|
5092
|
+
deleted: "deleted";
|
|
5093
|
+
}>;
|
|
5094
|
+
}, z.core.$strip>>>;
|
|
5095
|
+
discardEdits: z.ZodOptional<z.ZodNumber>;
|
|
5096
|
+
unread: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
5097
|
+
repo: z.ZodString;
|
|
5098
|
+
why: z.ZodString;
|
|
5099
|
+
}, z.core.$strip>>>;
|
|
5100
|
+
command: z.ZodString;
|
|
5101
|
+
plan: z.ZodOptional<z.ZodString>;
|
|
5102
|
+
}, z.core.$strip>>;
|
|
5103
|
+
leftOut: z.ZodOptional<z.ZodNumber>;
|
|
5104
|
+
leftOutRepos: z.ZodOptional<z.ZodNumber>;
|
|
5105
|
+
next: z.ZodOptional<z.ZodUnknown>;
|
|
5106
|
+
}, z.core.$strip>;
|
|
5107
|
+
export type FactsApplyResultT = z.infer<typeof FactsApplyResult>;
|
|
4607
5108
|
/**
|
|
4608
5109
|
* 3.12.0 (ADR 0195 point 6): GET /api/build/upgrade, the upgrade to source slots as a dry run,
|
|
4609
5110
|
* exactly what `atticus upgrade --json` lists under `slots`: every file `atticus upgrade --yes`
|
|
@@ -5867,6 +6368,17 @@ export declare const VerifyPreviewView: z.ZodObject<{
|
|
|
5867
6368
|
head: z.ZodString;
|
|
5868
6369
|
commit: z.ZodString;
|
|
5869
6370
|
}, z.core.$strip>>;
|
|
6371
|
+
confirm: z.ZodOptional<z.ZodObject<{
|
|
6372
|
+
removals: z.ZodOptional<z.ZodNumber>;
|
|
6373
|
+
edits: z.ZodOptional<z.ZodNumber>;
|
|
6374
|
+
refused: z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
6375
|
+
"nothing-read": "nothing-read";
|
|
6376
|
+
empty: "empty";
|
|
6377
|
+
"unexplained-removals": "unexplained-removals";
|
|
6378
|
+
}>>>;
|
|
6379
|
+
upgrade: z.ZodOptional<z.ZodLiteral<true>>;
|
|
6380
|
+
command: z.ZodOptional<z.ZodString>;
|
|
6381
|
+
}, z.core.$strip>>;
|
|
5870
6382
|
staleCorrections: z.ZodArray<z.ZodString>;
|
|
5871
6383
|
}, z.core.$strip>>;
|
|
5872
6384
|
unavailable: z.ZodOptional<z.ZodEnum<{
|
|
@@ -13108,10 +13620,16 @@ export declare const CandidateCallView: z.ZodObject<{
|
|
|
13108
13620
|
outside: "outside";
|
|
13109
13621
|
left: "left";
|
|
13110
13622
|
missed: "missed";
|
|
13623
|
+
joined: "joined";
|
|
13111
13624
|
unresolved: "unresolved";
|
|
13625
|
+
undrawn: "undrawn";
|
|
13626
|
+
here: "here";
|
|
13112
13627
|
}>;
|
|
13113
13628
|
why: z.ZodOptional<z.ZodString>;
|
|
13114
13629
|
paired: z.ZodOptional<z.ZodString>;
|
|
13630
|
+
joins: z.ZodOptional<z.ZodString>;
|
|
13631
|
+
now: z.ZodOptional<z.ZodString>;
|
|
13632
|
+
pairedBy: z.ZodOptional<z.ZodString>;
|
|
13115
13633
|
suggestion: z.ZodOptional<z.ZodObject<{
|
|
13116
13634
|
api: z.ZodString;
|
|
13117
13635
|
score: z.ZodNumber;
|
|
@@ -13172,10 +13690,16 @@ export declare const LinkCandidatesView: z.ZodObject<{
|
|
|
13172
13690
|
outside: "outside";
|
|
13173
13691
|
left: "left";
|
|
13174
13692
|
missed: "missed";
|
|
13693
|
+
joined: "joined";
|
|
13175
13694
|
unresolved: "unresolved";
|
|
13695
|
+
undrawn: "undrawn";
|
|
13696
|
+
here: "here";
|
|
13176
13697
|
}>;
|
|
13177
13698
|
why: z.ZodOptional<z.ZodString>;
|
|
13178
13699
|
paired: z.ZodOptional<z.ZodString>;
|
|
13700
|
+
joins: z.ZodOptional<z.ZodString>;
|
|
13701
|
+
now: z.ZodOptional<z.ZodString>;
|
|
13702
|
+
pairedBy: z.ZodOptional<z.ZodString>;
|
|
13179
13703
|
suggestion: z.ZodOptional<z.ZodObject<{
|
|
13180
13704
|
api: z.ZodString;
|
|
13181
13705
|
score: z.ZodNumber;
|
|
@@ -13916,6 +14440,7 @@ export declare const ConnectLinksRequest: z.ZodObject<{
|
|
|
13916
14440
|
}, z.core.$strip>>>;
|
|
13917
14441
|
rule: z.ZodOptional<z.ZodBoolean>;
|
|
13918
14442
|
preview: z.ZodOptional<z.ZodBoolean>;
|
|
14443
|
+
job: z.ZodOptional<z.ZodBoolean>;
|
|
13919
14444
|
}, z.core.$strip>;
|
|
13920
14445
|
export declare const ConnectLinksResult: z.ZodObject<{
|
|
13921
14446
|
written: z.ZodBoolean;
|
|
@@ -14000,6 +14525,14 @@ export declare const FileChangeResult: z.ZodObject<{
|
|
|
14000
14525
|
}, z.core.$strip>>;
|
|
14001
14526
|
verify: z.ZodString;
|
|
14002
14527
|
commit: z.ZodString;
|
|
14528
|
+
created: z.ZodOptional<z.ZodObject<{
|
|
14529
|
+
system: z.ZodString;
|
|
14530
|
+
file: z.ZodString;
|
|
14531
|
+
}, z.core.$strip>>;
|
|
14532
|
+
removed: z.ZodOptional<z.ZodObject<{
|
|
14533
|
+
system: z.ZodString;
|
|
14534
|
+
file: z.ZodString;
|
|
14535
|
+
}, z.core.$strip>>;
|
|
14003
14536
|
}, z.core.$strip>;
|
|
14004
14537
|
/**
|
|
14005
14538
|
* ADR 0179: a stroke drawn on the canvas for a change (a call, a topic, a table, a step removed
|
package/npm/core/cancel.d.ts
CHANGED
|
@@ -3,6 +3,13 @@ export declare class CancelledError extends Error {
|
|
|
3
3
|
}
|
|
4
4
|
/** Run `fn` with `signal` as the signal of everything it starts. */
|
|
5
5
|
export declare function withSignal<T>(signal: AbortSignal, fn: () => Promise<T>): Promise<T>;
|
|
6
|
+
/** Run `fn` with `commit` as what `commitCurrent()` inside it calls. */
|
|
7
|
+
export declare function withCommit<T>(commit: () => void, fn: () => Promise<T>): Promise<T>;
|
|
8
|
+
/**
|
|
9
|
+
* Say the job this code runs in has started writing: Stop is no longer heard. True when a job
|
|
10
|
+
* heard it (it says a late Stop itself); false outside one.
|
|
11
|
+
*/
|
|
12
|
+
export declare function commitCurrent(): boolean;
|
|
6
13
|
/** The signal of the job this code runs in, if it runs in one. */
|
|
7
14
|
export declare function currentSignal(): AbortSignal | undefined;
|
|
8
15
|
/** Stop here when the job was cancelled. */
|
|
@@ -31,6 +31,12 @@ export declare class DeclareError extends Error {
|
|
|
31
31
|
readonly code: "not-found" | "invalid" | "exists";
|
|
32
32
|
constructor(code: "not-found" | "invalid" | "exists", message: string);
|
|
33
33
|
}
|
|
34
|
+
/**
|
|
35
|
+
* The re-review of beta.28.1: a short hash of the System as the canvas added it, in its comment,
|
|
36
|
+
* so Undo takes it away only while it is still exactly that (no field a person changed since).
|
|
37
|
+
*/
|
|
38
|
+
export declare const addedHash: (s: Record<string, unknown>) => string;
|
|
39
|
+
export declare const addedComment: (by: string, at: string, hash: string) => string;
|
|
34
40
|
/** The comment a declaration carries: which side, who and when. */
|
|
35
41
|
export declare const declaredComment: (by: string, at: string, side?: "publishes" | "listens") => string;
|
|
36
42
|
/**
|
|
@@ -41,19 +47,56 @@ export declare function declareLink(root: string, d: Declared, o: {
|
|
|
41
47
|
by: string;
|
|
42
48
|
at: string;
|
|
43
49
|
preview?: boolean;
|
|
50
|
+
/**
|
|
51
|
+
* Beta.28.1 (field report 4): a system no profile has yet, which the canvas draws for a repo
|
|
52
|
+
* the manifest lists with no System of the profiles (the box takes the repo's id, or the
|
|
53
|
+
* manifest's `system`): added to its platform's profile in the same write, so a person
|
|
54
|
+
* declaring a link from that box never has to make the System first.
|
|
55
|
+
*/
|
|
56
|
+
create?: {
|
|
57
|
+
platform: string;
|
|
58
|
+
name?: string;
|
|
59
|
+
owner?: string;
|
|
60
|
+
};
|
|
44
61
|
}): Promise<{
|
|
45
62
|
rel: string;
|
|
46
63
|
changes: LineChange[];
|
|
47
64
|
written: boolean;
|
|
65
|
+
/** Beta.28: the file's bytes this write started from (what a take-back puts back). */
|
|
66
|
+
before: string;
|
|
67
|
+
/** The bytes it wrote (what a take-back expects to find). */
|
|
68
|
+
wrote?: string;
|
|
69
|
+
/** Beta.28.1: the system added to the profile first (`create`), when it had none. */
|
|
70
|
+
created?: string;
|
|
48
71
|
}>;
|
|
49
|
-
/**
|
|
72
|
+
/**
|
|
73
|
+
* Beta.28.1 (field hunt G5): `after`, a whole document as the yaml library writes it, with every
|
|
74
|
+
* line it has unchanged from `before` (the file as written, LF) given back as `before` wrote it:
|
|
75
|
+
* a flow list's padding (`[dv, qa, prod]`), its quotes, its spacing. `before` as the library
|
|
76
|
+
* writes it is lined up with `before` line for line (the library keeps the lines and comments of
|
|
77
|
+
* a document it only reads); a line of `after` that is one of those, in order, is that line of
|
|
78
|
+
* `before`. Where the two don't line up (the library joined or split a line), `after` as it is.
|
|
79
|
+
*/
|
|
80
|
+
export declare function keepUntouchedLines(written: string, after: string): string;
|
|
81
|
+
/**
|
|
82
|
+
* Undo: remove a declared topic or call from the system's list, exactly that one. Beta.28 (the
|
|
83
|
+
* review of Edit the map): only that item's lines go (and the list's key when it was the last),
|
|
84
|
+
* every other byte of the profile as it was: its comments, its flow lists, its version.
|
|
85
|
+
*/
|
|
50
86
|
export declare function undeclareLink(root: string, d: {
|
|
51
87
|
kind: "topic" | "call";
|
|
52
88
|
system: string;
|
|
53
89
|
value: string;
|
|
90
|
+
}, o?: {
|
|
91
|
+
/** A pairing or an answer names the system: a System the canvas added for it stays. */
|
|
92
|
+
inUse?: boolean;
|
|
54
93
|
}): Promise<{
|
|
55
94
|
rel: string;
|
|
56
95
|
changes: LineChange[];
|
|
96
|
+
before: string;
|
|
97
|
+
wrote: string;
|
|
98
|
+
/** S3: the System the canvas added, taken away with its last declaration. */
|
|
99
|
+
removed?: string;
|
|
57
100
|
}>;
|
|
58
101
|
/** A system's declarations, with who and when where the canvas wrote them. */
|
|
59
102
|
export declare function declaredOf(root: string, system: string): Promise<{
|
package/npm/core/facts-join.d.ts
CHANGED
|
@@ -608,6 +608,20 @@ export declare function keyRefIn(s: string | undefined): {
|
|
|
608
608
|
} | undefined;
|
|
609
609
|
/** Join every call of the estate's facts to the entry that serves it, or say why not. */
|
|
610
610
|
export declare function joinFacts(input: JoinFactsInput): FactsJoinResult;
|
|
611
|
+
/**
|
|
612
|
+
* Beta.28.1 (the review of "nothing slow runs silently"): joinFacts, giving way every
|
|
613
|
+
* JOIN_YIELD_EVERY calls, so a caller that awaits `tick` between (joinFactsAsync) lets a
|
|
614
|
+
* heartbeat, a Console line or a Stop through during a long join. The same join either way.
|
|
615
|
+
*/
|
|
616
|
+
export declare function joinFactsAsync(input: JoinFactsInput, tick: () => Promise<void>): Promise<FactsJoinResult>;
|
|
617
|
+
/** How many calls the join reads between two points where it gives way. */
|
|
618
|
+
export declare const JOIN_YIELD_EVERY = 200;
|
|
619
|
+
/** Work written as steps (a generator that yields where it may give way), run to its end. */
|
|
620
|
+
export declare function runSteps<T>(g: Generator<void, T, void>): T;
|
|
621
|
+
/** The same, awaiting `tick` at each point it may give way. */
|
|
622
|
+
export declare function runStepsAsync<T>(g: Generator<void, T, void>, tick: () => Promise<void>): Promise<T>;
|
|
623
|
+
/** joinFacts as steps: see joinFactsAsync. */
|
|
624
|
+
export declare function joinFactsSteps(input: JoinFactsInput): Generator<void, FactsJoinResult, void>;
|
|
611
625
|
/** The path a joined Interface records: the entry's, normalised (a gRPC or SOAP name as written). */
|
|
612
626
|
export declare function servedPath(e: Entry): string;
|
|
613
627
|
/** A gateway route's GatewayRoute id: `gw-<component>-<method>-<path>`, no dots (as a hop names one). */
|
package/npm/core/fs.d.ts
CHANGED
|
@@ -6,6 +6,13 @@
|
|
|
6
6
|
* it is retried a few times before giving up.
|
|
7
7
|
*/
|
|
8
8
|
export declare function writeFileAtomic(path: string, data: string | Uint8Array): Promise<void>;
|
|
9
|
+
/**
|
|
10
|
+
* Copy a file the way `writeFileAtomic` writes one: to a temporary file beside the target, then
|
|
11
|
+
* renamed over it. The copy is made by the system (a copy-on-write clone where the file system
|
|
12
|
+
* has them, APFS, Btrfs or XFS; else a copy in the kernel), so the bytes never pass through
|
|
13
|
+
* JavaScript (beta.28.1: a 60-repo estate's build.json is 180 MB).
|
|
14
|
+
*/
|
|
15
|
+
export declare function copyFileAtomic(from: string, path: string): Promise<void>;
|
|
9
16
|
/** A file changed on disk between being read and being written back: nothing was written. */
|
|
10
17
|
export declare class FileChangedError extends Error {
|
|
11
18
|
readonly path: string;
|
|
@@ -8,7 +8,23 @@ import type { Fact } from "./schema/facts.js";
|
|
|
8
8
|
*/
|
|
9
9
|
export type LooseStatus = "asked" | "missed" | "left" | "outside" | "unresolved"
|
|
10
10
|
/** Already paired by a person with an API of this box. */
|
|
11
|
-
| "paired"
|
|
11
|
+
| "paired"
|
|
12
|
+
/**
|
|
13
|
+
* Beta.28.1: the join ties it to another box (or this one) and an arrow is drawn for it:
|
|
14
|
+
* listed so it can be moved here from the same panel, never ticked unseen.
|
|
15
|
+
*/
|
|
16
|
+
| "joined"
|
|
17
|
+
/**
|
|
18
|
+
* Beta.28.1: the join ties it to something, and no arrow is drawn for it (its own component,
|
|
19
|
+
* or no Interface of it on the canvas): as loose as a call that joins nothing.
|
|
20
|
+
*/
|
|
21
|
+
| "undrawn"
|
|
22
|
+
/**
|
|
23
|
+
* The review of beta.28.1 (S2): the join ties it to this very box and an arrow is drawn for it
|
|
24
|
+
* (`now` the API it goes to): it goes here already, so nothing is suggested for it, and a
|
|
25
|
+
* pairing with the API it goes to would be a redundant line (refused).
|
|
26
|
+
*/
|
|
27
|
+
| "here";
|
|
12
28
|
export interface CandidateApi {
|
|
13
29
|
/** The entry's fact id, or the operation's id in the spec. */
|
|
14
30
|
id: string;
|
|
@@ -33,6 +49,18 @@ export interface CandidateCall {
|
|
|
33
49
|
why?: string;
|
|
34
50
|
/** For paired: the API it is paired with. */
|
|
35
51
|
paired?: string;
|
|
52
|
+
/**
|
|
53
|
+
* Beta.28.1: the box the join ties it to now (a repo, or an outside target), for a call that
|
|
54
|
+
* is joined, undrawn or outside: where it goes, or would go, before it is moved.
|
|
55
|
+
*/
|
|
56
|
+
joins?: string;
|
|
57
|
+
/** For here: the API of this box it goes to now (an entry's fact id), when the join names one. */
|
|
58
|
+
now?: string;
|
|
59
|
+
/**
|
|
60
|
+
* The review of beta.28.1 (N3): who paired it with the box it goes to now (another box): a
|
|
61
|
+
* pairing here replaces that person's word, which the panel says before it is written.
|
|
62
|
+
*/
|
|
63
|
+
pairedBy?: string;
|
|
36
64
|
suggestion?: {
|
|
37
65
|
api: string;
|
|
38
66
|
score: number;
|
|
@@ -100,4 +128,25 @@ export declare function linkCandidates(o: {
|
|
|
100
128
|
};
|
|
101
129
|
/** A's settings by key (its config facts with a value), to fill a call's `${key}` in. */
|
|
102
130
|
settings?: Readonly<Record<string, string>>;
|
|
131
|
+
/**
|
|
132
|
+
* Beta.28.1: whether the canvas draws a join's arrow (its Interface is in the catalog). A join
|
|
133
|
+
* of a call to its own component is never drawn, whatever this says. Default: every other is.
|
|
134
|
+
*/
|
|
135
|
+
drawn?: (j: FactsJoinResult["joins"][number]) => boolean;
|
|
136
|
+
/**
|
|
137
|
+
* Beta.28.1: whether the canvas draws a call placed outside the estate to this target (an
|
|
138
|
+
* outside system of the profile takes it). Default: none is, so the call is listed loose.
|
|
139
|
+
*/
|
|
140
|
+
drawnOutside?: (target: string, call: string) => boolean;
|
|
141
|
+
/**
|
|
142
|
+
* Whether a repo, a component or a system is drawn in the box connected to (a repo's own id,
|
|
143
|
+
* its components; a system's repos and their components). Default: the box's own id only.
|
|
144
|
+
*/
|
|
145
|
+
inBox?: (name: string) => boolean;
|
|
146
|
+
/**
|
|
147
|
+
* The review of beta.28.1 (S4): the box the built catalog draws a call's arrow to (an
|
|
148
|
+
* Interface current in it citing the call's line), for a call the join doesn't place: the
|
|
149
|
+
* canvas is what the person sees, so a drawn call is never listed as loose.
|
|
150
|
+
*/
|
|
151
|
+
drawnTo?: (call: string) => string | undefined;
|
|
103
152
|
}): LinkCandidates;
|
package/npm/core/printer.d.ts
CHANGED
|
@@ -1,4 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ADR 0187: where a line printed by a command goes besides its own output, while it runs inside
|
|
3
|
+
* the app's job. The job (in the server) sets the printer; the command line's `main`, and the
|
|
4
|
+
* app's routes that run a command's code, pass each line they print to `printToCurrent`. Outside
|
|
5
|
+
* a job there is no printer and nothing happens. No schema here: the command line loads it first.
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* Beta.28.1: how a line is printed. `now`: a progress line (a step of long work), sent to the
|
|
9
|
+
* Console at once rather than in the next batch of lines, so it is there before the step's work
|
|
10
|
+
* keeps the thread.
|
|
11
|
+
*/
|
|
12
|
+
export interface PrintOptions {
|
|
13
|
+
now?: boolean;
|
|
14
|
+
}
|
|
1
15
|
/** Run `work` with every line printed inside it (at any depth, across awaits) going to `print`. */
|
|
2
|
-
export declare function withPrinter<T>(print: (line: string) => void, work: () => T): T;
|
|
16
|
+
export declare function withPrinter<T>(print: (line: string, o?: PrintOptions) => void, work: () => T): T;
|
|
3
17
|
/** Print a line to the job this code runs in, if any. */
|
|
4
|
-
export declare function printToCurrent(line: string): void;
|
|
18
|
+
export declare function printToCurrent(line: string, o?: PrintOptions): void;
|
|
@@ -23,6 +23,9 @@ export interface Parsed<T> {
|
|
|
23
23
|
rel: string;
|
|
24
24
|
value?: T;
|
|
25
25
|
problem?: string;
|
|
26
|
+
/** With `withStats`: the file's size and time (ms, floored) as this read found them (-1: none). */
|
|
27
|
+
size?: number;
|
|
28
|
+
mtimeMs?: number;
|
|
26
29
|
}
|
|
27
30
|
/** What a caller's parse says about one file. */
|
|
28
31
|
export type ParseOutcome<T> = {
|
|
@@ -49,4 +52,11 @@ export declare function readParsedFiles<T>(o: {
|
|
|
49
52
|
parse: (text: string, rel: string) => ParseOutcome<T>;
|
|
50
53
|
/** The root of the metarepo this run is working in; none means no cache (read-only). */
|
|
51
54
|
cacheRoot?: string;
|
|
55
|
+
/**
|
|
56
|
+
* False: the parses kept under `cacheRoot` are read, and nothing is written there (a preview,
|
|
57
|
+
* which writes nothing: beta.28.1, it parsed a 100,000-record catalog from its files).
|
|
58
|
+
*/
|
|
59
|
+
keep?: boolean;
|
|
60
|
+
/** Each file's size and time with its parse (beta.28.1: a write matches them to its own read). */
|
|
61
|
+
withStats?: boolean;
|
|
52
62
|
}): Promise<Parsed<T>[]>;
|
package/npm/index.js
CHANGED
|
@@ -6032,7 +6032,12 @@ var Problem = z31.object({
|
|
|
6032
6032
|
* 3.12.0 (beta.27): which refusal it is, where one status has more than one the app tells
|
|
6033
6033
|
* apart (an owner question's send: 409 `being-sent` or `already-sent`).
|
|
6034
6034
|
*/
|
|
6035
|
-
code: z31.string().optional()
|
|
6035
|
+
code: z31.string().optional(),
|
|
6036
|
+
/**
|
|
6037
|
+
* 3.13.0 (beta.28): a 422 of POST /api/map/edits: each staged change that can't be made, by its
|
|
6038
|
+
* place in the list (from 0), with why. Nothing was written.
|
|
6039
|
+
*/
|
|
6040
|
+
problems: z31.array(z31.object({ edit: z31.number().int().nonnegative(), message: z31.string() })).optional()
|
|
6036
6041
|
});
|
|
6037
6042
|
var Kind3 = z31.enum(RECORD_KINDS);
|
|
6038
6043
|
var CatalogRecord2 = z31.union(RECORD_KINDS.map((k) => RECORD_SCHEMAS[k]));
|
|
@@ -7108,6 +7113,103 @@ var CatalogPruneRequest = z31.strictObject({
|
|
|
7108
7113
|
/** GET /api/build/prune's `plan`. */
|
|
7109
7114
|
plan: z31.string().regex(/^[0-9a-f]{64}$/)
|
|
7110
7115
|
});
|
|
7116
|
+
var LinkDeleteRequest = z31.strictObject({
|
|
7117
|
+
interfaces: z31.array(z31.string().min(1).max(300)).min(1).max(5e3),
|
|
7118
|
+
from: z31.string().min(1).max(200),
|
|
7119
|
+
to: z31.string().min(1).max(200)
|
|
7120
|
+
});
|
|
7121
|
+
var DeletedLinksView = z31.object({
|
|
7122
|
+
links: z31.array(z31.object({
|
|
7123
|
+
from: z31.string(),
|
|
7124
|
+
to: z31.string(),
|
|
7125
|
+
/** How many calls the link had when it was deleted. */
|
|
7126
|
+
calls: z31.number().int().nonnegative(),
|
|
7127
|
+
by: z31.string(),
|
|
7128
|
+
at: z31.string(),
|
|
7129
|
+
/** No Interface of it would be drawn now even without the suppress (its code moved on). */
|
|
7130
|
+
gone: z31.boolean().optional(),
|
|
7131
|
+
/** Taken away by a redirect of Edit the map, its new link added in the same change. */
|
|
7132
|
+
redirect: z31.boolean().optional(),
|
|
7133
|
+
/** One curated suppress per Interface, in catalog/curated/curateddecision/. */
|
|
7134
|
+
decisions: z31.array(z31.object({
|
|
7135
|
+
id: z31.string(),
|
|
7136
|
+
target: z31.string(),
|
|
7137
|
+
file: z31.string(),
|
|
7138
|
+
/** The build no longer makes this Interface: the suppress takes nothing away. */
|
|
7139
|
+
gone: z31.boolean().optional()
|
|
7140
|
+
}))
|
|
7141
|
+
}))
|
|
7142
|
+
});
|
|
7143
|
+
var LinkUndeleteRequest = z31.strictObject({
|
|
7144
|
+
decisions: z31.array(z31.string().regex(/^[a-z0-9][a-z0-9._-]{0,120}$/)).min(1).max(500)
|
|
7145
|
+
});
|
|
7146
|
+
var MapEditAdd = z31.discriminatedUnion("kind", [
|
|
7147
|
+
z31.strictObject({
|
|
7148
|
+
kind: z31.literal("topic"),
|
|
7149
|
+
system: z31.string().min(1).max(200),
|
|
7150
|
+
topic: z31.string().min(1).max(300),
|
|
7151
|
+
side: z31.enum(["publishes", "listens"])
|
|
7152
|
+
}),
|
|
7153
|
+
z31.strictObject({
|
|
7154
|
+
kind: z31.literal("call"),
|
|
7155
|
+
system: z31.string().min(1).max(200),
|
|
7156
|
+
route: z31.string().min(1).max(300)
|
|
7157
|
+
})
|
|
7158
|
+
]);
|
|
7159
|
+
var MapEditPair = z31.strictObject({
|
|
7160
|
+
from: z31.string().min(1).max(200),
|
|
7161
|
+
/** The other box: a repo of the manifest or an outside system (Connect to…'s `to`). */
|
|
7162
|
+
to: z31.strictObject({ repo: z31.string().min(1).optional(), system: z31.string().min(1).optional() }).refine((b) => !!b.repo !== !!b.system, { message: "name a repo or a system" }),
|
|
7163
|
+
pairs: z31.array(z31.object({ call: z31.string().min(1), api: z31.string().min(1) })).min(1).max(500)
|
|
7164
|
+
});
|
|
7165
|
+
var MapEditDelete = z31.strictObject({
|
|
7166
|
+
interfaces: z31.array(z31.string().min(1).max(300)).max(5e3),
|
|
7167
|
+
from: z31.string().min(1).max(200),
|
|
7168
|
+
to: z31.string().min(1).max(200)
|
|
7169
|
+
});
|
|
7170
|
+
var MapEdit = z31.union([
|
|
7171
|
+
z31.strictObject({ kind: z31.literal("delete"), delete: MapEditDelete }),
|
|
7172
|
+
z31.strictObject({ kind: z31.literal("add"), add: MapEditAdd }),
|
|
7173
|
+
z31.strictObject({ kind: z31.literal("add"), pair: MapEditPair }),
|
|
7174
|
+
z31.strictObject({ kind: z31.literal("redirect"), delete: MapEditDelete, add: MapEditAdd }),
|
|
7175
|
+
z31.strictObject({ kind: z31.literal("redirect"), delete: MapEditDelete, pair: MapEditPair })
|
|
7176
|
+
]);
|
|
7177
|
+
var MapEditsRequest = z31.strictObject({ edits: z31.array(MapEdit).min(1).max(100) });
|
|
7178
|
+
var MapEditProblem = z31.object({
|
|
7179
|
+
edit: z31.number().int().nonnegative(),
|
|
7180
|
+
message: z31.string()
|
|
7181
|
+
});
|
|
7182
|
+
var MapEditsResult = z31.object({
|
|
7183
|
+
code: z31.number().int(),
|
|
7184
|
+
lines: z31.array(z31.string()),
|
|
7185
|
+
edits: z31.array(z31.object({
|
|
7186
|
+
edit: z31.number().int().nonnegative(),
|
|
7187
|
+
kind: z31.enum(["delete", "add", "redirect"]),
|
|
7188
|
+
state: z31.enum(["saved", "failed", "taken-back", "not-tried"]),
|
|
7189
|
+
message: z31.string().optional()
|
|
7190
|
+
})),
|
|
7191
|
+
built: z31.boolean(),
|
|
7192
|
+
callers: z31.array(z31.string()),
|
|
7193
|
+
/**
|
|
7194
|
+
* The repos a new link is joined through that aren't read from their facts yet (a pairing's
|
|
7195
|
+
* other repo, a declared call's gateway): the link is drawn once they are. Callers are left out.
|
|
7196
|
+
*/
|
|
7197
|
+
waitsOn: z31.array(z31.string()),
|
|
7198
|
+
/**
|
|
7199
|
+
* The build refused after the changes were saved (a large removal it lists, a hand edit): its
|
|
7200
|
+
* listing, as Apply's job gives it, which Set up › Scans › Catalog builds confirms.
|
|
7201
|
+
*/
|
|
7202
|
+
refused: BuildRefusalView.optional()
|
|
7203
|
+
});
|
|
7204
|
+
var FactsApplyResult = z31.object({
|
|
7205
|
+
code: z31.number().int(),
|
|
7206
|
+
lines: z31.array(z31.string()),
|
|
7207
|
+
refused: BuildRefusalView.optional(),
|
|
7208
|
+
leftOut: z31.number().int().positive().optional(),
|
|
7209
|
+
/** Apply to every repo's (POST /api/facts/apply-all): how many repos left facts out. */
|
|
7210
|
+
leftOutRepos: z31.number().int().positive().optional(),
|
|
7211
|
+
next: z31.unknown().optional()
|
|
7212
|
+
});
|
|
7111
7213
|
var CatalogUpgradeView = z31.object({
|
|
7112
7214
|
pending: z31.boolean(),
|
|
7113
7215
|
records: z31.number().int(),
|
|
@@ -7523,6 +7625,22 @@ var VerifyPreviewView = z31.object({
|
|
|
7523
7625
|
}).optional(),
|
|
7524
7626
|
/** The checkout's HEAD is past the facts' commit: verify reads the changed files' facts again. */
|
|
7525
7627
|
headMoved: z31.object({ head: z31.string(), commit: z31.string() }).optional(),
|
|
7628
|
+
/**
|
|
7629
|
+
* 3.14.0 (beta.28.1): what the Apply's guards will say (ADR 0195 point 4), absent when it
|
|
7630
|
+
* writes without a word. It waits for a person's confirm when its build removes more than
|
|
7631
|
+
* the guard's limit (`removals`, how many it lists) or files under catalog/generated were
|
|
7632
|
+
* changed by hand (`edits`, how many), with the command that confirms exactly them; it
|
|
7633
|
+
* refuses whatever is confirmed when `refused` lists reasons (removals nothing explains,
|
|
7634
|
+
* an empty build, nothing read), and no command is given; on a catalog from before the
|
|
7635
|
+
* slots (`upgrade`) the command is `atticus upgrade`.
|
|
7636
|
+
*/
|
|
7637
|
+
confirm: z31.object({
|
|
7638
|
+
removals: z31.number().int().optional(),
|
|
7639
|
+
edits: z31.number().int().optional(),
|
|
7640
|
+
refused: z31.array(z31.enum(["nothing-read", "empty", "unexplained-removals"])).optional(),
|
|
7641
|
+
upgrade: z31.literal(true).optional(),
|
|
7642
|
+
command: z31.string().optional()
|
|
7643
|
+
}).optional(),
|
|
7526
7644
|
/** Corrections on file that meet no fact in this read (kept, applied when it is read again). */
|
|
7527
7645
|
staleCorrections: z31.array(z31.string())
|
|
7528
7646
|
}).optional(),
|
|
@@ -9463,9 +9581,30 @@ var CandidateCallView = z31.object({
|
|
|
9463
9581
|
method: z31.string().optional(),
|
|
9464
9582
|
path: z31.string(),
|
|
9465
9583
|
at: z31.string(),
|
|
9466
|
-
|
|
9584
|
+
/**
|
|
9585
|
+
* 3.14: `joined`, a call with an arrow drawn already, listed so it can be moved to this box;
|
|
9586
|
+
* `undrawn`, a call the join ties to something no arrow is drawn for, as loose as any;
|
|
9587
|
+
* `here`, a call with an arrow to this very box (`now` its API), never suggested again.
|
|
9588
|
+
*/
|
|
9589
|
+
status: z31.enum([
|
|
9590
|
+
"asked",
|
|
9591
|
+
"missed",
|
|
9592
|
+
"left",
|
|
9593
|
+
"outside",
|
|
9594
|
+
"unresolved",
|
|
9595
|
+
"paired",
|
|
9596
|
+
"joined",
|
|
9597
|
+
"undrawn",
|
|
9598
|
+
"here"
|
|
9599
|
+
]),
|
|
9467
9600
|
why: z31.string().optional(),
|
|
9468
9601
|
paired: z31.string().optional(),
|
|
9602
|
+
/** 3.14: the box the call goes to now (a repo, or an outside target), before it is moved. */
|
|
9603
|
+
joins: z31.string().optional(),
|
|
9604
|
+
/** 3.14: for `here`, the API of this box the call goes to now. */
|
|
9605
|
+
now: z31.string().optional(),
|
|
9606
|
+
/** 3.14: who paired the call with the box it goes to now, when a person did. */
|
|
9607
|
+
pairedBy: z31.string().optional(),
|
|
9469
9608
|
suggestion: CandidateSuggestion.optional(),
|
|
9470
9609
|
/** 2.57: the APIs it most likely is, best first, at most three. */
|
|
9471
9610
|
suggestions: z31.array(CandidateSuggestion).max(3).optional(),
|
|
@@ -9910,7 +10049,12 @@ var ConnectLinksRequest = z31.object({
|
|
|
9910
10049
|
/** Answer A's open target question with /** to B, so calls read later follow it too. */
|
|
9911
10050
|
rule: z31.boolean().optional(),
|
|
9912
10051
|
/** Say what it would write and what the next verify --write changes; write nothing. */
|
|
9913
|
-
preview: z31.boolean().optional()
|
|
10052
|
+
preview: z31.boolean().optional(),
|
|
10053
|
+
/**
|
|
10054
|
+
* 3.14.0 (beta.28.1): run it as a job (202 and its id at once; its steps are the job's lines,
|
|
10055
|
+
* Stop ends it between them, and its result `answer` is this request's result, or `problem`).
|
|
10056
|
+
*/
|
|
10057
|
+
job: z31.boolean().optional()
|
|
9914
10058
|
});
|
|
9915
10059
|
var ConnectLinksResult = z31.object({
|
|
9916
10060
|
written: z31.boolean(),
|
|
@@ -9968,7 +10112,17 @@ var FileChangeResult = z31.object({
|
|
|
9968
10112
|
written: z31.boolean(),
|
|
9969
10113
|
files: z31.array(z31.object({ file: z31.string(), changes: z31.array(LineChangeView) })),
|
|
9970
10114
|
verify: z31.string(),
|
|
9971
|
-
commit: z31.string()
|
|
10115
|
+
commit: z31.string(),
|
|
10116
|
+
/**
|
|
10117
|
+
* 3.14: the System added to a profile first, for a declaration from a box no profile had (a
|
|
10118
|
+
* repo the manifest lists with no System): the person is told it was added, and where.
|
|
10119
|
+
*/
|
|
10120
|
+
created: z31.object({ system: z31.string(), file: z31.string() }).optional(),
|
|
10121
|
+
/**
|
|
10122
|
+
* 3.14: the System the canvas added for a declaration, taken away with its last one (Undo):
|
|
10123
|
+
* the person is told it went, and from where.
|
|
10124
|
+
*/
|
|
10125
|
+
removed: z31.object({ system: z31.string(), file: z31.string() }).optional()
|
|
9972
10126
|
});
|
|
9973
10127
|
var SketchStrokeRequest = z31.object({
|
|
9974
10128
|
stroke: z31.object({ kind: z31.enum(["call", "topic", "table", "remove", "retarget", "undo", "retire"]) }).passthrough(),
|
|
@@ -11482,6 +11636,56 @@ var OPS = {
|
|
|
11482
11636
|
errors: [400, 409]
|
|
11483
11637
|
}
|
|
11484
11638
|
},
|
|
11639
|
+
"/api/links/delete": {
|
|
11640
|
+
post: {
|
|
11641
|
+
id: "deleteLink",
|
|
11642
|
+
summary: "3.13.0 (beta.28): Delete this link as a local job: a curated suppress of each Interface named (the decision atticus catalog edits --curate writes for a deleted file), in catalog/curated/curateddecision/, then atticus catalog build. 404 when one isn't an Interface of the catalog now",
|
|
11643
|
+
tag: "scans",
|
|
11644
|
+
body: LinkDeleteRequest,
|
|
11645
|
+
ok: {
|
|
11646
|
+
status: 202,
|
|
11647
|
+
schema: "JobAccepted",
|
|
11648
|
+
description: "Started: its job's result is the code and the lines it printed"
|
|
11649
|
+
},
|
|
11650
|
+
errors: [400, 404, 409]
|
|
11651
|
+
}
|
|
11652
|
+
},
|
|
11653
|
+
"/api/links/deleted": {
|
|
11654
|
+
get: {
|
|
11655
|
+
id: "getDeletedLinks",
|
|
11656
|
+
summary: "3.13.0 (beta.28): the links deleted on the canvas, each with its curated suppresses. Reads files only",
|
|
11657
|
+
tag: "scans",
|
|
11658
|
+
ok: { status: 200, schema: "DeletedLinksView", description: "OK" }
|
|
11659
|
+
}
|
|
11660
|
+
},
|
|
11661
|
+
"/api/links/deleted/undo": {
|
|
11662
|
+
post: {
|
|
11663
|
+
id: "undeleteLink",
|
|
11664
|
+
summary: "3.13.0 (beta.28): Bring back a deleted link as a local job: its decisions removed, then atticus catalog build. 404 when one isn't a link deleted on the canvas",
|
|
11665
|
+
tag: "scans",
|
|
11666
|
+
body: LinkUndeleteRequest,
|
|
11667
|
+
ok: {
|
|
11668
|
+
status: 202,
|
|
11669
|
+
schema: "JobAccepted",
|
|
11670
|
+
description: "Started: its job's result is the code and the lines it printed"
|
|
11671
|
+
},
|
|
11672
|
+
errors: [400, 404, 409]
|
|
11673
|
+
}
|
|
11674
|
+
},
|
|
11675
|
+
"/api/map/edits": {
|
|
11676
|
+
post: {
|
|
11677
|
+
id: "applyMapEdits",
|
|
11678
|
+
summary: "3.13.0 (beta.28): Edit the map's Apply my changes as a local job: every change staged on the canvas checked first (422 with problems by place, nothing written), then each delete's curated suppresses and each add's declaration written, then atticus catalog build once. A write that fails takes back those before it and builds nothing. Its job's result is MapEditsResult",
|
|
11679
|
+
tag: "scans",
|
|
11680
|
+
body: MapEditsRequest,
|
|
11681
|
+
ok: {
|
|
11682
|
+
status: 202,
|
|
11683
|
+
schema: "JobAccepted",
|
|
11684
|
+
description: "Started: its job's result is MapEditsResult"
|
|
11685
|
+
},
|
|
11686
|
+
errors: [400, 409, 422]
|
|
11687
|
+
}
|
|
11688
|
+
},
|
|
11485
11689
|
"/api/facts/{repo}": {
|
|
11486
11690
|
get: {
|
|
11487
11691
|
id: "getRepoFacts",
|
|
@@ -11518,8 +11722,13 @@ var OPS = {
|
|
|
11518
11722
|
id: "previewVerifyWrite",
|
|
11519
11723
|
summary: "After a correction: the commands to run (atticus verify <repo> --write, then the git steps with the exact files) and what that write will change in the facts and the catalog (links moved, added, removed; facts dropped or edited), computed in-process without writing (ADR 0149)",
|
|
11520
11724
|
tag: "workspace",
|
|
11521
|
-
params: [
|
|
11725
|
+
params: [
|
|
11726
|
+
p("repo"),
|
|
11727
|
+
q("fact", str3, "The fact corrected, for the branch and commit message"),
|
|
11728
|
+
q("job", str3, "3.14.0: 1 runs the preview as a job (202 JobAccepted; its steps are its lines, Stop ends it between them, its result `answer` is this view or `problem`)")
|
|
11729
|
+
],
|
|
11522
11730
|
ok: { status: 200, schema: "VerifyPreviewView", description: "OK" },
|
|
11731
|
+
alsoOk: { status: 202, schema: "JobAccepted", description: "Started as a job (`job=1`)" },
|
|
11523
11732
|
errors: [400, 404]
|
|
11524
11733
|
}
|
|
11525
11734
|
},
|
|
@@ -11640,14 +11849,14 @@ var OPS = {
|
|
|
11640
11849
|
"/api/facts/{repo}/apply": {
|
|
11641
11850
|
post: {
|
|
11642
11851
|
id: "applyFacts",
|
|
11643
|
-
summary: "2.65.0 (ADR 0183): run atticus verify <repo> --write, as Apply after an answer or a correction; 3.12.0: with the counts that confirm a refused build",
|
|
11852
|
+
summary: "2.65.0 (ADR 0183): run atticus verify <repo> --write, as Apply after an answer or a correction; 3.12.0: with the counts that confirm a refused build; 3.14.0: a rejected fact is left out and the rest written (leftOut in the result)",
|
|
11644
11853
|
tag: "workspace",
|
|
11645
11854
|
params: [p("repo")],
|
|
11646
11855
|
body: FactsApplyRequest,
|
|
11647
11856
|
ok: {
|
|
11648
11857
|
status: 202,
|
|
11649
11858
|
schema: "JobAccepted",
|
|
11650
|
-
description: "Started: its job's result is the code and the lines verify printed"
|
|
11859
|
+
description: "Started: its job's result is FactsApplyResult: the code and the lines verify printed, a refused build's listing, and (3.14.0) leftOut, how many rejected facts the write left out"
|
|
11651
11860
|
},
|
|
11652
11861
|
// 2.68.0: 409 while another local step (Apply, Propose, Bring in) runs.
|
|
11653
11862
|
errors: [400, 409]
|
|
@@ -12081,19 +12290,22 @@ var OPS = {
|
|
|
12081
12290
|
params: [
|
|
12082
12291
|
q("from", str3, "Box A: the caller's repo"),
|
|
12083
12292
|
q("to", str3, "Box B: a repo of the manifest"),
|
|
12084
|
-
q("system", str3, "Box B: an outside system of the profile (instead of to)")
|
|
12293
|
+
q("system", str3, "Box B: an outside system of the profile (instead of to)"),
|
|
12294
|
+
q("job", str3, "3.14.0: 1 runs the read as a job (202 JobAccepted; its steps are its lines, Stop ends it between them, its result `answer` is this view or `problem`)")
|
|
12085
12295
|
],
|
|
12086
12296
|
ok: { status: 200, schema: "LinkCandidatesView", description: "OK" },
|
|
12297
|
+
alsoOk: { status: 202, schema: "JobAccepted", description: "Started as a job (`job=1`)" },
|
|
12087
12298
|
errors: [400, 404]
|
|
12088
12299
|
}
|
|
12089
12300
|
},
|
|
12090
12301
|
"/api/links/connect": {
|
|
12091
12302
|
post: {
|
|
12092
12303
|
id: "connectLinks",
|
|
12093
|
-
summary: "Pair box A's calls with box B's APIs (ADR 0174, G1): a link line per pair in A's corrections, and with rule a /** answer; with preview, what it would write and the next verify --write changes",
|
|
12304
|
+
summary: "Pair box A's calls with box B's APIs (ADR 0174, G1): a link line per pair in A's corrections, and with rule a /** answer; with preview, what it would write and the next verify --write changes. 3.14.0: with `job: true`, 202 JobAccepted at once; the job's result `answer` is this result, or `problem`",
|
|
12094
12305
|
tag: "views",
|
|
12095
12306
|
body: ConnectLinksRequest,
|
|
12096
12307
|
ok: { status: 200, schema: "ConnectLinksResult", description: "OK" },
|
|
12308
|
+
alsoOk: { status: 202, schema: "JobAccepted", description: "Started as a job (`job: true`)" },
|
|
12097
12309
|
errors: [400, 404, 409, 422]
|
|
12098
12310
|
}
|
|
12099
12311
|
},
|
|
@@ -12148,7 +12360,7 @@ var OPS = {
|
|
|
12148
12360
|
ok: {
|
|
12149
12361
|
status: 202,
|
|
12150
12362
|
schema: "JobAccepted",
|
|
12151
|
-
description: "Started: its job's result is the code and the lines verify printed"
|
|
12363
|
+
description: "Started: its job's result is FactsApplyResult: the code and the lines verify printed, and (3.14.0) leftOut and leftOutRepos when repos wrote with rejected facts left out (applied, code 0)"
|
|
12152
12364
|
},
|
|
12153
12365
|
errors: [409]
|
|
12154
12366
|
}
|
|
@@ -13901,6 +14113,7 @@ var SPEC_CACHE_VERSION = `spec@${FLOW_SCHEMA_VERSION}.${SPEC_HEADER_SCHEMA_VERSI
|
|
|
13901
14113
|
// packages/core/dist/cancel.js
|
|
13902
14114
|
import { AsyncLocalStorage as AsyncLocalStorage2 } from "node:async_hooks";
|
|
13903
14115
|
var store = new AsyncLocalStorage2();
|
|
14116
|
+
var commits = new AsyncLocalStorage2();
|
|
13904
14117
|
|
|
13905
14118
|
// packages/core/dist/assistant-actor.js
|
|
13906
14119
|
init_ai();
|
|
@@ -14470,13 +14683,13 @@ function fsScanCache(dir) {
|
|
|
14470
14683
|
throw new Error(`unsafe repo name: ${repo}`);
|
|
14471
14684
|
const keep = new Set(keepCommits);
|
|
14472
14685
|
let removed = 0;
|
|
14473
|
-
let
|
|
14686
|
+
let commits2;
|
|
14474
14687
|
try {
|
|
14475
|
-
|
|
14688
|
+
commits2 = await readdir2(join3(dir, repo));
|
|
14476
14689
|
} catch {
|
|
14477
14690
|
return 0;
|
|
14478
14691
|
}
|
|
14479
|
-
for (const c of
|
|
14692
|
+
for (const c of commits2) {
|
|
14480
14693
|
if (!keep.has(c)) {
|
|
14481
14694
|
await rm(join3(dir, repo, c), { recursive: true, force: true });
|
|
14482
14695
|
removed++;
|
package/package.json
CHANGED