sailfork 0.2.0 → 0.3.0

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/AGENTS.md CHANGED
@@ -108,6 +108,8 @@ const repo = sf.repo("acme/api");
108
108
 
109
109
  ### issues
110
110
 
111
+ - `sf.issues.answer(input)`: Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease. Scope `repo:write`, write, retry idempotent.
112
+ - `sf.issues.ask(input)`: Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access. Scope `repo:write`, write, retry once.
111
113
  - `sf.issues.claim(input)`: Delegate an issue to yourself or your agent for a lease, or renew the lease. The issue returns to ready if the lease lapses. Scope `repo:write`, write, retry idempotent.
112
114
  - `sf.issues.close(input)`: Close an issue with a reason, after posting an optional comment. Without a `reason` it is `done`, or `duplicate` when `duplicateOf` names the issue it repeats. Scope `repo:write`, destructive, retry idempotent.
113
115
  - `sf.issues.comment(input)`: Comment on an issue, or post a progress update as whoever holds its lease. Scope `repo:write`, write, retry idempotent.
@@ -128,6 +130,7 @@ const repo = sf.repo("acme/api");
128
130
  - `sf.issues.similar(input)`: Check for issues the title reads like, open ones closest first, to look through before filing a duplicate. Scope `repo:read`, read, retry safe.
129
131
  - `sf.issues.start(input)`: Claim an issue and open a caisson on its branch, or return the live caisson already working on it. Safe to repeat. Scope `repo:write`, write, retry idempotent.
130
132
  - `sf.issues.subscribe(input)`: Follow an issue to be notified of its activity, or stop following it. Needs only read access. Scope `repo:read`, write, retry idempotent.
133
+ - `sf.issues.unask(input)`: Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access. Scope `repo:write`, write, retry idempotent.
131
134
  - `sf.issues.unreact(input)`: Take your reaction back from an issue. Scope `repo:read`, write, retry idempotent.
132
135
  - `sf.issues.update(input)`: Change any field of an issue. A field left out stays; `null` clears the ones that can be cleared. An issue's author may change its words and whether it is open without write access. Scope `repo:write`, write, retry idempotent.
133
136
 
package/LICENSE CHANGED
@@ -1,19 +1,21 @@
1
- Sailfork CLI License
1
+ MIT License
2
2
 
3
- Copyright (c) 2026 Sailfork. All rights reserved.
3
+ Copyright (c) 2026 Sailfork
4
4
 
5
- Sailfork grants you a free, non-exclusive, non-transferable, revocable license to download, install and run the
6
- unmodified `sailfork` command line binaries, and the `git-remote-sailfork` helper they include, as released by
7
- Sailfork, for the purpose of using the Sailfork service, and to copy those unmodified binaries together with this
8
- license and THIRD-PARTY-NOTICES for that purpose.
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
9
11
 
10
- You may not modify, decompile or reverse engineer the binaries, sell or sublicense them, or remove this license or
11
- THIRD-PARTY-NOTICES from a copy. All rights not granted here are reserved.
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
12
14
 
13
- The binaries include third-party open source components. Each is licensed under its own terms, listed in
14
- THIRD-PARTY-NOTICES. Nothing in this license limits the rights those licenses give you for those components.
15
-
16
- THE BINARIES ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF
17
- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL SAILFORK BE LIABLE FOR
18
- ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
19
- CONNECTION WITH THE BINARIES OR THEIR USE.
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/dist/index.cjs CHANGED
@@ -604,7 +604,7 @@ async function resolveToken(host, option) {
604
604
  }
605
605
 
606
606
  // src/core/version.ts
607
- var VERSION = "0.2.0";
607
+ var VERSION = "0.3.0";
608
608
  var API_VERSION = "2026-12-01";
609
609
 
610
610
  // src/core/client.ts
@@ -1705,6 +1705,32 @@ var ops = {
1705
1705
  long: false,
1706
1706
  paginated: false
1707
1707
  },
1708
+ "issues.answer": {
1709
+ id: "issues.answer",
1710
+ method: "POST",
1711
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}/answer",
1712
+ pathParams: ["owner", "repo", "number", "id"],
1713
+ queryParams: [],
1714
+ bodyParams: ["choices", "text"],
1715
+ effect: "write",
1716
+ retry: "idempotent",
1717
+ held: false,
1718
+ long: false,
1719
+ paginated: false
1720
+ },
1721
+ "issues.ask": {
1722
+ id: "issues.ask",
1723
+ method: "POST",
1724
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks",
1725
+ pathParams: ["owner", "repo", "number"],
1726
+ queryParams: [],
1727
+ bodyParams: ["kind", "text", "options", "recommended", "other"],
1728
+ effect: "write",
1729
+ retry: "none",
1730
+ held: false,
1731
+ long: false,
1732
+ paginated: false
1733
+ },
1708
1734
  "issues.claim": {
1709
1735
  id: "issues.claim",
1710
1736
  method: "POST",
@@ -1965,6 +1991,19 @@ var ops = {
1965
1991
  long: false,
1966
1992
  paginated: false
1967
1993
  },
1994
+ "issues.unask": {
1995
+ id: "issues.unask",
1996
+ method: "DELETE",
1997
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}",
1998
+ pathParams: ["owner", "repo", "number", "id"],
1999
+ queryParams: [],
2000
+ bodyParams: [],
2001
+ effect: "write",
2002
+ retry: "idempotent",
2003
+ held: false,
2004
+ long: false,
2005
+ paginated: false
2006
+ },
1968
2007
  "issues.unreact": {
1969
2008
  id: "issues.unreact",
1970
2009
  method: "DELETE",
@@ -2971,6 +3010,12 @@ class IssuesResource {
2971
3010
  constructor(core) {
2972
3011
  this.core = core;
2973
3012
  }
3013
+ answer(input, opts) {
3014
+ return this.core.request(ops["issues.answer"], input, opts);
3015
+ }
3016
+ ask(input, opts) {
3017
+ return this.core.request(ops["issues.ask"], input, opts);
3018
+ }
2974
3019
  claim(input, opts) {
2975
3020
  return this.core.request(ops["issues.claim"], input, opts);
2976
3021
  }
@@ -3032,6 +3077,9 @@ class IssuesResource {
3032
3077
  subscribe(input, opts) {
3033
3078
  return this.core.request(ops["issues.subscribe"], input, opts);
3034
3079
  }
3080
+ unask(input, opts) {
3081
+ return this.core.request(ops["issues.unask"], input, opts);
3082
+ }
3035
3083
  unreact(input, opts) {
3036
3084
  return this.core.request(ops["issues.unreact"], input, opts);
3037
3085
  }
@@ -3584,6 +3632,12 @@ class RepoIssuesResource {
3584
3632
  this.core = core;
3585
3633
  this.bound = bound;
3586
3634
  }
3635
+ answer(input, opts) {
3636
+ return this.core.request(ops["issues.answer"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3637
+ }
3638
+ ask(input, opts) {
3639
+ return this.core.request(ops["issues.ask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3640
+ }
3587
3641
  claim(input, opts) {
3588
3642
  return this.core.request(ops["issues.claim"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3589
3643
  }
@@ -3642,6 +3696,9 @@ class RepoIssuesResource {
3642
3696
  subscribe(input, opts) {
3643
3697
  return this.core.request(ops["issues.subscribe"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3644
3698
  }
3699
+ unask(input, opts) {
3700
+ return this.core.request(ops["issues.unask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3701
+ }
3645
3702
  unreact(input, opts) {
3646
3703
  return this.core.request(ops["issues.unreact"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3647
3704
  }
package/dist/index.js CHANGED
@@ -500,7 +500,7 @@ async function resolveToken(host, option) {
500
500
  }
501
501
 
502
502
  // src/core/version.ts
503
- var VERSION = "0.2.0";
503
+ var VERSION = "0.3.0";
504
504
  var API_VERSION = "2026-12-01";
505
505
 
506
506
  // src/core/client.ts
@@ -1601,6 +1601,32 @@ var ops = {
1601
1601
  long: false,
1602
1602
  paginated: false
1603
1603
  },
1604
+ "issues.answer": {
1605
+ id: "issues.answer",
1606
+ method: "POST",
1607
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}/answer",
1608
+ pathParams: ["owner", "repo", "number", "id"],
1609
+ queryParams: [],
1610
+ bodyParams: ["choices", "text"],
1611
+ effect: "write",
1612
+ retry: "idempotent",
1613
+ held: false,
1614
+ long: false,
1615
+ paginated: false
1616
+ },
1617
+ "issues.ask": {
1618
+ id: "issues.ask",
1619
+ method: "POST",
1620
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks",
1621
+ pathParams: ["owner", "repo", "number"],
1622
+ queryParams: [],
1623
+ bodyParams: ["kind", "text", "options", "recommended", "other"],
1624
+ effect: "write",
1625
+ retry: "none",
1626
+ held: false,
1627
+ long: false,
1628
+ paginated: false
1629
+ },
1604
1630
  "issues.claim": {
1605
1631
  id: "issues.claim",
1606
1632
  method: "POST",
@@ -1861,6 +1887,19 @@ var ops = {
1861
1887
  long: false,
1862
1888
  paginated: false
1863
1889
  },
1890
+ "issues.unask": {
1891
+ id: "issues.unask",
1892
+ method: "DELETE",
1893
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}",
1894
+ pathParams: ["owner", "repo", "number", "id"],
1895
+ queryParams: [],
1896
+ bodyParams: [],
1897
+ effect: "write",
1898
+ retry: "idempotent",
1899
+ held: false,
1900
+ long: false,
1901
+ paginated: false
1902
+ },
1864
1903
  "issues.unreact": {
1865
1904
  id: "issues.unreact",
1866
1905
  method: "DELETE",
@@ -2867,6 +2906,12 @@ class IssuesResource {
2867
2906
  constructor(core) {
2868
2907
  this.core = core;
2869
2908
  }
2909
+ answer(input, opts) {
2910
+ return this.core.request(ops["issues.answer"], input, opts);
2911
+ }
2912
+ ask(input, opts) {
2913
+ return this.core.request(ops["issues.ask"], input, opts);
2914
+ }
2870
2915
  claim(input, opts) {
2871
2916
  return this.core.request(ops["issues.claim"], input, opts);
2872
2917
  }
@@ -2928,6 +2973,9 @@ class IssuesResource {
2928
2973
  subscribe(input, opts) {
2929
2974
  return this.core.request(ops["issues.subscribe"], input, opts);
2930
2975
  }
2976
+ unask(input, opts) {
2977
+ return this.core.request(ops["issues.unask"], input, opts);
2978
+ }
2931
2979
  unreact(input, opts) {
2932
2980
  return this.core.request(ops["issues.unreact"], input, opts);
2933
2981
  }
@@ -3480,6 +3528,12 @@ class RepoIssuesResource {
3480
3528
  this.core = core;
3481
3529
  this.bound = bound;
3482
3530
  }
3531
+ answer(input, opts) {
3532
+ return this.core.request(ops["issues.answer"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3533
+ }
3534
+ ask(input, opts) {
3535
+ return this.core.request(ops["issues.ask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3536
+ }
3483
3537
  claim(input, opts) {
3484
3538
  return this.core.request(ops["issues.claim"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3485
3539
  }
@@ -3538,6 +3592,9 @@ class RepoIssuesResource {
3538
3592
  subscribe(input, opts) {
3539
3593
  return this.core.request(ops["issues.subscribe"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3540
3594
  }
3595
+ unask(input, opts) {
3596
+ return this.core.request(ops["issues.unask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3597
+ }
3541
3598
  unreact(input, opts) {
3542
3599
  return this.core.request(ops["issues.unreact"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
3543
3600
  }
package/dist/tools.cjs CHANGED
@@ -801,6 +801,32 @@ var ops = {
801
801
  long: false,
802
802
  paginated: false
803
803
  },
804
+ "issues.answer": {
805
+ id: "issues.answer",
806
+ method: "POST",
807
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}/answer",
808
+ pathParams: ["owner", "repo", "number", "id"],
809
+ queryParams: [],
810
+ bodyParams: ["choices", "text"],
811
+ effect: "write",
812
+ retry: "idempotent",
813
+ held: false,
814
+ long: false,
815
+ paginated: false
816
+ },
817
+ "issues.ask": {
818
+ id: "issues.ask",
819
+ method: "POST",
820
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks",
821
+ pathParams: ["owner", "repo", "number"],
822
+ queryParams: [],
823
+ bodyParams: ["kind", "text", "options", "recommended", "other"],
824
+ effect: "write",
825
+ retry: "none",
826
+ held: false,
827
+ long: false,
828
+ paginated: false
829
+ },
804
830
  "issues.claim": {
805
831
  id: "issues.claim",
806
832
  method: "POST",
@@ -1061,6 +1087,19 @@ var ops = {
1061
1087
  long: false,
1062
1088
  paginated: false
1063
1089
  },
1090
+ "issues.unask": {
1091
+ id: "issues.unask",
1092
+ method: "DELETE",
1093
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}",
1094
+ pathParams: ["owner", "repo", "number", "id"],
1095
+ queryParams: [],
1096
+ bodyParams: [],
1097
+ effect: "write",
1098
+ retry: "idempotent",
1099
+ held: false,
1100
+ long: false,
1101
+ paginated: false
1102
+ },
1064
1103
  "issues.unreact": {
1065
1104
  id: "issues.unreact",
1066
1105
  method: "DELETE",
@@ -4537,6 +4576,171 @@ cursor at or behind the stored one leaves it as it is, so two readers cannot rew
4537
4576
  tab: "tab"
4538
4577
  }
4539
4578
  },
4579
+ {
4580
+ name: "issue_answer",
4581
+ op: "issues.answer",
4582
+ description: "Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease.",
4583
+ schema: {
4584
+ additionalProperties: false,
4585
+ description: "Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for\n`multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the\nissue's lease.",
4586
+ properties: {
4587
+ choices: {
4588
+ default: [],
4589
+ description: "The labels of the options picked.",
4590
+ items: {
4591
+ type: "string"
4592
+ },
4593
+ type: "array"
4594
+ },
4595
+ id: {
4596
+ description: "The question's id, from the issue's context.",
4597
+ type: "string"
4598
+ },
4599
+ number: {
4600
+ description: "Issue number.",
4601
+ format: "int64",
4602
+ type: "integer"
4603
+ },
4604
+ org: {
4605
+ description: "The repository's owner: a user or an org handle.",
4606
+ type: "string"
4607
+ },
4608
+ repo: {
4609
+ description: "The repository's name.",
4610
+ type: "string"
4611
+ },
4612
+ text: {
4613
+ default: "",
4614
+ description: "The answer in your own words.",
4615
+ type: "string"
4616
+ }
4617
+ },
4618
+ required: [
4619
+ "org",
4620
+ "repo",
4621
+ "number",
4622
+ "id"
4623
+ ],
4624
+ type: "object"
4625
+ },
4626
+ renames: {
4627
+ choices: "choices",
4628
+ id: "id",
4629
+ number: "number",
4630
+ org: "owner",
4631
+ repo: "repo",
4632
+ text: "text"
4633
+ }
4634
+ },
4635
+ {
4636
+ name: "issue_ask",
4637
+ op: "issues.ask",
4638
+ description: "Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access.",
4639
+ schema: {
4640
+ $defs: {
4641
+ AskKind: {
4642
+ description: "How a person answers an [`IssueAsk`]: `single` (one option), `multi` (any number of options) or `text` (free text).",
4643
+ enum: [
4644
+ "single",
4645
+ "multi",
4646
+ "text"
4647
+ ],
4648
+ type: "string"
4649
+ },
4650
+ AskOptionInput: {
4651
+ anyOf: [
4652
+ {
4653
+ type: "string"
4654
+ },
4655
+ {
4656
+ $ref: "#/$defs/IssueAskOption"
4657
+ }
4658
+ ],
4659
+ description: "An option as an asker writes it: its label alone, or the label with a description."
4660
+ },
4661
+ IssueAskOption: {
4662
+ properties: {
4663
+ description: {
4664
+ type: [
4665
+ "string",
4666
+ "null"
4667
+ ]
4668
+ },
4669
+ label: {
4670
+ type: "string"
4671
+ }
4672
+ },
4673
+ required: [
4674
+ "label"
4675
+ ],
4676
+ type: "object"
4677
+ }
4678
+ },
4679
+ additionalProperties: false,
4680
+ description: "Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single`\ntakes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take\nfree text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's\nlease or write access.",
4681
+ properties: {
4682
+ kind: {
4683
+ $ref: "#/$defs/AskKind",
4684
+ description: "`single` (pick one option), `multi` (pick any) or `text` (free text)."
4685
+ },
4686
+ number: {
4687
+ description: "Issue number.",
4688
+ format: "int64",
4689
+ type: "integer"
4690
+ },
4691
+ options: {
4692
+ default: [],
4693
+ description: "The choices of a `single` or `multi` question, 2 to 10, each a label or `{label, description}`; none for\n`text`.",
4694
+ items: {
4695
+ $ref: "#/$defs/AskOptionInput"
4696
+ },
4697
+ type: "array"
4698
+ },
4699
+ org: {
4700
+ description: "The repository's owner: a user or an org handle.",
4701
+ type: "string"
4702
+ },
4703
+ other: {
4704
+ default: false,
4705
+ description: "true lets a `single` or `multi` question also take an answer in the person's own words.",
4706
+ type: "boolean"
4707
+ },
4708
+ recommended: {
4709
+ description: "The label of the option you suggest.",
4710
+ type: [
4711
+ "string",
4712
+ "null"
4713
+ ]
4714
+ },
4715
+ repo: {
4716
+ description: "The repository's name.",
4717
+ type: "string"
4718
+ },
4719
+ text: {
4720
+ description: "The whole question, in Markdown, with what the person needs to answer it (up to 2000 characters).",
4721
+ type: "string"
4722
+ }
4723
+ },
4724
+ required: [
4725
+ "org",
4726
+ "repo",
4727
+ "number",
4728
+ "kind",
4729
+ "text"
4730
+ ],
4731
+ type: "object"
4732
+ },
4733
+ renames: {
4734
+ kind: "kind",
4735
+ number: "number",
4736
+ options: "options",
4737
+ org: "owner",
4738
+ other: "other",
4739
+ recommended: "recommended",
4740
+ repo: "repo",
4741
+ text: "text"
4742
+ }
4743
+ },
4540
4744
  {
4541
4745
  name: "issue_claim",
4542
4746
  op: "issues.claim",
@@ -5727,6 +5931,47 @@ repository.`,
5727
5931
  repo: "repo"
5728
5932
  }
5729
5933
  },
5934
+ {
5935
+ name: "issue_unask",
5936
+ op: "issues.unask",
5937
+ description: "Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access.",
5938
+ schema: {
5939
+ description: `Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need
5940
+ the issue's lease or write access.`,
5941
+ properties: {
5942
+ id: {
5943
+ description: "The question's id, from the issue's context.",
5944
+ type: "string"
5945
+ },
5946
+ number: {
5947
+ description: "Issue number.",
5948
+ format: "int64",
5949
+ type: "integer"
5950
+ },
5951
+ org: {
5952
+ description: "The repository's owner: a user or an org handle.",
5953
+ type: "string"
5954
+ },
5955
+ repo: {
5956
+ description: "The repository's name.",
5957
+ type: "string"
5958
+ }
5959
+ },
5960
+ required: [
5961
+ "org",
5962
+ "repo",
5963
+ "number",
5964
+ "id"
5965
+ ],
5966
+ type: "object"
5967
+ },
5968
+ renames: {
5969
+ id: "id",
5970
+ number: "number",
5971
+ org: "owner",
5972
+ repo: "repo"
5973
+ }
5974
+ },
5730
5975
  {
5731
5976
  name: "issue_update",
5732
5977
  op: "issues.update",