@vibedropio/publisher 0.22.7 → 0.23.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.
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "git-publisher",
|
|
3
3
|
"displayName": "Git Publisher",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.23.0",
|
|
5
5
|
"description": "Publish an app folder to the platform and keep it updated (\"publish my app\", \"update my app\", \"fetch the engineered version\").",
|
|
6
6
|
"author": { "name": "VibeDrop" },
|
|
7
7
|
"keywords": ["git", "publish", "deploy", "serverless"]
|
|
@@ -28,7 +28,7 @@ Every command accepts `--json` and prints exactly one JSON object on stdout. Exi
|
|
|
28
28
|
publisher --version
|
|
29
29
|
```
|
|
30
30
|
|
|
31
|
-
If the command is not found, or the version is older than 0.
|
|
31
|
+
If the command is not found, or the version is older than 0.23.0, install it:
|
|
32
32
|
`npm install -g @vibedropio/publisher@latest` (it needs Node.js 22 (22.12 or later) or Node.js 24). In a Claude Cowork task
|
|
33
33
|
this is normal: the sandbox starts empty every time, so install it without asking. On the person's
|
|
34
34
|
own computer, say in one line that you are installing the publisher. If `npm` itself is missing,
|
|
@@ -111,7 +111,7 @@ then `publisher start <starter> --replaces "<what it replaces>"`.
|
|
|
111
111
|
To say where the folder stands without changing anything:
|
|
112
112
|
|
|
113
113
|
```bash
|
|
114
|
-
publisher
|
|
114
|
+
publisher checkout-status . --json # state + hint; exit 2 means conflict
|
|
115
115
|
```
|
|
116
116
|
|
|
117
117
|
| state | meaning | what to do |
|
package/dist/publisher.cjs
CHANGED
|
@@ -20732,7 +20732,7 @@ async function writeAssociation(repoDir, a) {
|
|
|
20732
20732
|
await setConfig(repoDir, "publisher.remote", a.remote);
|
|
20733
20733
|
}
|
|
20734
20734
|
|
|
20735
|
-
// ../client/src/folder/
|
|
20735
|
+
// ../client/src/folder/checkout.ts
|
|
20736
20736
|
var import_promises2 = require("node:fs/promises");
|
|
20737
20737
|
var import_node_path2 = require("node:path");
|
|
20738
20738
|
var import_node_crypto2 = require("node:crypto");
|
|
@@ -20903,10 +20903,10 @@ async function listPending(repoDir) {
|
|
|
20903
20903
|
return (await openPending(repoDir)).list();
|
|
20904
20904
|
}
|
|
20905
20905
|
|
|
20906
|
-
// ../client/src/folder/
|
|
20907
|
-
var NS = "publisher.
|
|
20906
|
+
// ../client/src/folder/checkout.ts
|
|
20907
|
+
var NS = "publisher.checkout";
|
|
20908
20908
|
var PARTIAL_MARKER = ".gitpub-checkout.json";
|
|
20909
|
-
async function
|
|
20909
|
+
async function getCheckoutMapping(directory) {
|
|
20910
20910
|
const dir = (0, import_node_path2.resolve)(directory);
|
|
20911
20911
|
const section = await getConfigSection(dir, "publisher").catch(() => null);
|
|
20912
20912
|
if (!section) {
|
|
@@ -20945,10 +20945,10 @@ async function writeMapping(dir, m) {
|
|
|
20945
20945
|
await setConfig(dir, `${NS}.checkedoutat`, m.checkedOutAt);
|
|
20946
20946
|
await setConfig(dir, `${NS}.baseadvancedat`, m.baseAdvancedAt);
|
|
20947
20947
|
}
|
|
20948
|
-
async function
|
|
20949
|
-
const m = await
|
|
20948
|
+
async function advanceCheckoutBase(directory, next, now = /* @__PURE__ */ new Date()) {
|
|
20949
|
+
const m = await getCheckoutMapping(directory);
|
|
20950
20950
|
if (!m) {
|
|
20951
|
-
throw new PublisherError("LOCAL_STATE", "not a
|
|
20951
|
+
throw new PublisherError("LOCAL_STATE", "not a checkout (no publisher.checkout mapping)");
|
|
20952
20952
|
}
|
|
20953
20953
|
if (next.generation < m.baseGeneration) {
|
|
20954
20954
|
return m;
|
|
@@ -20966,7 +20966,7 @@ async function noteAcceptedPublication(directory, outcome2, now = /* @__PURE__ *
|
|
|
20966
20966
|
if (outcome2.state !== "accepted" || outcome2.resultGeneration === null) {
|
|
20967
20967
|
return;
|
|
20968
20968
|
}
|
|
20969
|
-
const m = await
|
|
20969
|
+
const m = await getCheckoutMapping(directory).catch(() => null);
|
|
20970
20970
|
if (!m || m.repoId !== outcome2.repoId) {
|
|
20971
20971
|
return;
|
|
20972
20972
|
}
|
|
@@ -20974,11 +20974,11 @@ async function noteAcceptedPublication(directory, outcome2, now = /* @__PURE__ *
|
|
|
20974
20974
|
if (!oid) {
|
|
20975
20975
|
return;
|
|
20976
20976
|
}
|
|
20977
|
-
await
|
|
20977
|
+
await advanceCheckoutBase(directory, { oid, generation: outcome2.resultGeneration }, now);
|
|
20978
20978
|
}
|
|
20979
|
-
async function
|
|
20979
|
+
async function adoptCheckout(client, directory, call2 = {}, now = /* @__PURE__ */ new Date()) {
|
|
20980
20980
|
const dir = (0, import_node_path2.resolve)(directory);
|
|
20981
|
-
const existing = await
|
|
20981
|
+
const existing = await getCheckoutMapping(dir);
|
|
20982
20982
|
if (existing) {
|
|
20983
20983
|
return existing;
|
|
20984
20984
|
}
|
|
@@ -21023,7 +21023,7 @@ async function adoptWorkspace(client, directory, call2 = {}, now = /* @__PURE__
|
|
|
21023
21023
|
checkedOutAt: now.toISOString(),
|
|
21024
21024
|
baseAdvancedAt: now.toISOString()
|
|
21025
21025
|
});
|
|
21026
|
-
return await
|
|
21026
|
+
return await getCheckoutMapping(dir);
|
|
21027
21027
|
}
|
|
21028
21028
|
async function isEmptyDir(p) {
|
|
21029
21029
|
try {
|
|
@@ -21066,7 +21066,7 @@ async function removeStalePartials(target, repoId) {
|
|
|
21066
21066
|
}
|
|
21067
21067
|
return removed;
|
|
21068
21068
|
}
|
|
21069
|
-
async function
|
|
21069
|
+
async function createCheckout(client, opts, call2 = {}, now = /* @__PURE__ */ new Date()) {
|
|
21070
21070
|
const target = (0, import_node_path2.resolve)(opts.directory);
|
|
21071
21071
|
const remote = opts.remote ?? "publisher";
|
|
21072
21072
|
const empty2 = await isEmptyDir(target);
|
|
@@ -21123,7 +21123,7 @@ async function checkoutWorkspace(client, opts, call2 = {}, now = /* @__PURE__ */
|
|
|
21123
21123
|
}
|
|
21124
21124
|
throw e;
|
|
21125
21125
|
}
|
|
21126
|
-
return await
|
|
21126
|
+
return await getCheckoutMapping(target);
|
|
21127
21127
|
}
|
|
21128
21128
|
async function isAncestor(dir, ancestor, descendant) {
|
|
21129
21129
|
const r = await runGit(["merge-base", "--is-ancestor", ancestor, descendant], { cwd: dir, allowFailure: true });
|
|
@@ -21133,9 +21133,9 @@ async function countCommits(dir, range) {
|
|
|
21133
21133
|
const r = await runGit(["rev-list", "--count", range], { cwd: dir, allowFailure: true });
|
|
21134
21134
|
return r.code === 0 ? Number(r.stdout.toString("utf8").trim()) : 0;
|
|
21135
21135
|
}
|
|
21136
|
-
async function
|
|
21136
|
+
async function inspectCheckout(client, directory, call2 = {}) {
|
|
21137
21137
|
const dir = (0, import_node_path2.resolve)(directory);
|
|
21138
|
-
const mapping = await
|
|
21138
|
+
const mapping = await getCheckoutMapping(dir);
|
|
21139
21139
|
const pending = await listPending(dir).catch(() => []);
|
|
21140
21140
|
if (!mapping) {
|
|
21141
21141
|
return {
|
|
@@ -21145,7 +21145,7 @@ async function inspectWorkspace(client, directory, call2 = {}) {
|
|
|
21145
21145
|
remote: null,
|
|
21146
21146
|
pending,
|
|
21147
21147
|
conflicts: [],
|
|
21148
|
-
hint: "not a
|
|
21148
|
+
hint: "not a checkout yet; run sync here (an associated folder adopts itself), or checkout to create one"
|
|
21149
21149
|
};
|
|
21150
21150
|
}
|
|
21151
21151
|
const branchRef = `refs/heads/${mapping.branch}`;
|
|
@@ -21168,7 +21168,7 @@ async function inspectWorkspace(client, directory, call2 = {}) {
|
|
|
21168
21168
|
if (checkedOut !== mapping.branch && !(checkedOut === null && head === null && tip === null)) {
|
|
21169
21169
|
return done(
|
|
21170
21170
|
"detached",
|
|
21171
|
-
checkedOut === null ? `HEAD is detached at ${head?.slice(0, 12) ?? "unknown"}; check out ${mapping.branch} (git checkout ${mapping.branch}) before syncing or publishing` : `branch ${checkedOut} is checked out, the
|
|
21171
|
+
checkedOut === null ? `HEAD is detached at ${head?.slice(0, 12) ?? "unknown"}; check out ${mapping.branch} (git checkout ${mapping.branch}) before syncing or publishing` : `branch ${checkedOut} is checked out, the checkout tracks ${mapping.branch}; check it out before syncing or publishing`
|
|
21172
21172
|
);
|
|
21173
21173
|
}
|
|
21174
21174
|
if (!remoteOid) {
|
|
@@ -21210,16 +21210,16 @@ async function inspectWorkspace(client, directory, call2 = {}) {
|
|
|
21210
21210
|
}
|
|
21211
21211
|
return done(
|
|
21212
21212
|
"conflict",
|
|
21213
|
-
`both sides changed ${merge2.conflicts.map((c) => c.path).join(", ")}; resolve with git merge ${remoteOid} in the
|
|
21213
|
+
`both sides changed ${merge2.conflicts.map((c) => c.path).join(", ")}; resolve with git merge ${remoteOid} in the checkout, then publish`,
|
|
21214
21214
|
merge2.conflicts.map((c) => c.path)
|
|
21215
21215
|
);
|
|
21216
21216
|
}
|
|
21217
|
-
async function
|
|
21217
|
+
async function syncCheckout(client, opts, call2 = {}, now = /* @__PURE__ */ new Date()) {
|
|
21218
21218
|
const dir = (0, import_node_path2.resolve)(opts.directory);
|
|
21219
|
-
await
|
|
21220
|
-
const before = await
|
|
21219
|
+
await adoptCheckout(client, dir, call2, now);
|
|
21220
|
+
const before = await inspectCheckout(client, dir, call2);
|
|
21221
21221
|
if (!before.mapping) {
|
|
21222
|
-
throw new PublisherError("LOCAL_STATE", "not a
|
|
21222
|
+
throw new PublisherError("LOCAL_STATE", "not a checkout; run checkout");
|
|
21223
21223
|
}
|
|
21224
21224
|
const mapping = before.mapping;
|
|
21225
21225
|
const branchRef = `refs/heads/${mapping.branch}`;
|
|
@@ -21246,10 +21246,10 @@ async function syncWorkspace(client, opts, call2 = {}, now = /* @__PURE__ */ new
|
|
|
21246
21246
|
if (before.remote?.oid) {
|
|
21247
21247
|
const tipNow = await revParse(dir, branchRef);
|
|
21248
21248
|
if (tipNow && (tipNow === before.remote.oid || await isAncestor(dir, before.remote.oid, tipNow))) {
|
|
21249
|
-
updated = await
|
|
21249
|
+
updated = await advanceCheckoutBase(dir, { oid: before.remote.oid, generation: before.remote.generation }, now);
|
|
21250
21250
|
}
|
|
21251
21251
|
}
|
|
21252
|
-
const after = applied ? (await
|
|
21252
|
+
const after = applied ? (await inspectCheckout(client, dir, call2)).state : before.state;
|
|
21253
21253
|
return { before, applied, mapping: updated, after };
|
|
21254
21254
|
}
|
|
21255
21255
|
|
|
@@ -23346,26 +23346,26 @@ var Publisher = class {
|
|
|
23346
23346
|
await noteAcceptedPublication(options.repoDir, outcome2);
|
|
23347
23347
|
return outcome2;
|
|
23348
23348
|
}
|
|
23349
|
-
// ----
|
|
23350
|
-
/** Create a NEW editable
|
|
23349
|
+
// ---- checkouts (docs/archive/checkout-parity.md) -------------------------------------------------
|
|
23350
|
+
/** Create a NEW editable checkout (clone + mapping) for a published repository. */
|
|
23351
23351
|
async checkout(options, call2 = {}) {
|
|
23352
|
-
return
|
|
23352
|
+
return createCheckout(this, options, call2);
|
|
23353
23353
|
}
|
|
23354
|
-
/** Make an associated folder a
|
|
23355
|
-
async
|
|
23356
|
-
return
|
|
23354
|
+
/** Make an associated folder a checkout (idempotent); `init` and `sync` both call it. */
|
|
23355
|
+
async adoptCheckout(directory, call2 = {}) {
|
|
23356
|
+
return adoptCheckout(this, directory, call2);
|
|
23357
23357
|
}
|
|
23358
|
-
/** Offline: the persisted
|
|
23359
|
-
async
|
|
23360
|
-
return
|
|
23358
|
+
/** Offline: the persisted checkout mapping, or null. */
|
|
23359
|
+
async checkoutMapping(directory) {
|
|
23360
|
+
return getCheckoutMapping(directory);
|
|
23361
23361
|
}
|
|
23362
|
-
/** Where the
|
|
23363
|
-
async
|
|
23364
|
-
return
|
|
23362
|
+
/** Where the checkout stands relative to the server (decided on real objects). */
|
|
23363
|
+
async checkoutStatus(directory, call2 = {}) {
|
|
23364
|
+
return inspectCheckout(this, directory, call2);
|
|
23365
23365
|
}
|
|
23366
23366
|
/** Fetch and, with `apply`, fast-forward or merge cleanly; advances the base. */
|
|
23367
23367
|
async sync(options, call2 = {}) {
|
|
23368
|
-
return
|
|
23368
|
+
return syncCheckout(this, options, call2);
|
|
23369
23369
|
}
|
|
23370
23370
|
/**
|
|
23371
23371
|
* A creator's whole round trip in one call, so nobody runs git: record their changes, bring in
|
|
@@ -23373,8 +23373,8 @@ var Publisher = class {
|
|
|
23373
23373
|
* having published nothing, on a conflict; the recorded commit stays, so nothing is lost.
|
|
23374
23374
|
*
|
|
23375
23375
|
* Everything that can refuse without touching the folder refuses first: a folder with no
|
|
23376
|
-
* association (or one pinned elsewhere) and a HEAD off the
|
|
23377
|
-
* a commit and then an error. `
|
|
23376
|
+
* association (or one pinned elsewhere) and a HEAD off the checkout branch would otherwise get
|
|
23377
|
+
* a commit and then an error. `syncCheckout` itself still never commits or publishes; this is
|
|
23378
23378
|
* the composition, and the only one.
|
|
23379
23379
|
*/
|
|
23380
23380
|
async syncChanges(options, call2 = {}) {
|
|
@@ -23384,12 +23384,12 @@ var Publisher = class {
|
|
|
23384
23384
|
if (!branch) {
|
|
23385
23385
|
throw new PublisherError("LOCAL_STATE", "HEAD is detached; check out the branch this folder publishes, then run sync again");
|
|
23386
23386
|
}
|
|
23387
|
-
const mapped = await
|
|
23387
|
+
const mapped = await getCheckoutMapping(dir);
|
|
23388
23388
|
if (mapped && mapped.branch !== branch) {
|
|
23389
23389
|
throw new PublisherError("LOCAL_STATE", `branch ${branch} is checked out, but this folder publishes ${mapped.branch}; check it out, then run sync again`);
|
|
23390
23390
|
}
|
|
23391
23391
|
const recorded = await recordChanges({ dir, ...options.message ? { message: options.message } : {} });
|
|
23392
|
-
const reconciled = await
|
|
23392
|
+
const reconciled = await syncCheckout(this, { directory: dir, apply: true }, call2);
|
|
23393
23393
|
const base = { recorded: { commit: recorded.commit, committed: recorded.committed, excluded: recorded.excluded }, reconciled };
|
|
23394
23394
|
if (reconciled.after === "conflict") {
|
|
23395
23395
|
const remote = reconciled.before.remote?.oid ?? null;
|
|
@@ -23767,7 +23767,7 @@ async function discoverEndpoint(portal, fetchImpl = fetch) {
|
|
|
23767
23767
|
}
|
|
23768
23768
|
const endpoint = body?.publishingEndpoint;
|
|
23769
23769
|
if (endpoint === null || endpoint === void 0) {
|
|
23770
|
-
throw new PublisherError("LOCAL_STATE", `${portal} is not set up for publishing; ask
|
|
23770
|
+
throw new PublisherError("LOCAL_STATE", `${portal} is not set up for publishing; ask the administrator of ${portal}, or pass --endpoint`);
|
|
23771
23771
|
}
|
|
23772
23772
|
if (typeof endpoint !== "string" || endpoint.trim() === "") {
|
|
23773
23773
|
throw new PublisherError("UNAVAILABLE", `${portal} answered with something this version does not understand`, { isRetryable: false });
|
|
@@ -23777,7 +23777,7 @@ async function discoverEndpoint(portal, fetchImpl = fetch) {
|
|
|
23777
23777
|
|
|
23778
23778
|
// src/terminal/limited.ts
|
|
23779
23779
|
var REFUSED = /* @__PURE__ */ new Set(["REF_FORBIDDEN", "FORBIDDEN"]);
|
|
23780
|
-
var ASK = "Ask
|
|
23780
|
+
var ASK = "Ask the owner or an admin of the organization.";
|
|
23781
23781
|
var Limited = class _Limited {
|
|
23782
23782
|
/** The lines for a refusal with `code` and `details`, or null when it is not a permission's or names no reason and no maker. */
|
|
23783
23783
|
static hint(code, details) {
|
|
@@ -24309,7 +24309,7 @@ async function finish(ctx, got, clock) {
|
|
|
24309
24309
|
isDefault: named !== null && file2.defaultProfile === named,
|
|
24310
24310
|
server: caps.server,
|
|
24311
24311
|
credentialsFile: path,
|
|
24312
|
-
// Which setting chose that path: a sandbox that keeps only
|
|
24312
|
+
// Which setting chose that path: a sandbox that keeps only one folder needs it to be in that folder.
|
|
24313
24313
|
credentialsFrom: credentialsLocation().from,
|
|
24314
24314
|
timings
|
|
24315
24315
|
});
|
|
@@ -24555,7 +24555,10 @@ async function repositoryForInit(p, endpoint, name, opts = {}) {
|
|
|
24555
24555
|
throw new PublisherError("UNAVAILABLE", `could not confirm that ${portal} publishes to ${endpoint}; run init again`, { isRetryable: true });
|
|
24556
24556
|
}
|
|
24557
24557
|
if (!confirmed2.terminal.includes(APPLICATION_CREATION)) {
|
|
24558
|
-
throw new PublisherError(
|
|
24558
|
+
throw new PublisherError(
|
|
24559
|
+
"UNAVAILABLE",
|
|
24560
|
+
`${portal} cannot make an application from a terminal yet, and a repository needs one; ask the administrator of ${portal} to update it`
|
|
24561
|
+
);
|
|
24559
24562
|
}
|
|
24560
24563
|
const made = await p.createApplication({ portal, name, ...opts.cell === void 0 ? {} : { cell: opts.cell } });
|
|
24561
24564
|
return { repoId: made.repository.repoId, appId: made.appId, placement: made.placement };
|
|
@@ -24571,7 +24574,7 @@ function placementWords(placement) {
|
|
|
24571
24574
|
case "must-pick":
|
|
24572
24575
|
return `this app has no cell yet, so its first publication stops. You can pick: ${placement.offered.join(", ")}. Open the app in the portal and pick one on its Cell tab`;
|
|
24573
24576
|
case "no-cell":
|
|
24574
|
-
return "this app has no cell yet, because you cannot use that cell or any cell.
|
|
24577
|
+
return "this app has no cell yet, because you cannot use that cell or any cell. The owner or an admin can give you one";
|
|
24575
24578
|
case "unavailable":
|
|
24576
24579
|
return "where this app runs could not be asked now. Its first publication asks again";
|
|
24577
24580
|
}
|
|
@@ -24610,14 +24613,14 @@ async function linkFolder(inv, p, endpoint, dir, attach) {
|
|
|
24610
24613
|
await p.getRepository(repoId);
|
|
24611
24614
|
}
|
|
24612
24615
|
await p.associate(dir, repoId);
|
|
24613
|
-
const
|
|
24616
|
+
const checkout2 = await p.adoptCheckout(dir).catch(() => null);
|
|
24614
24617
|
return {
|
|
24615
24618
|
repoId,
|
|
24616
24619
|
appId,
|
|
24617
24620
|
created: attach.repoId === void 0,
|
|
24618
24621
|
placement,
|
|
24619
24622
|
onboarding: onboarding ? { commit: onboarding.commit, committed: onboarding.committed.length, excluded: onboarding.excluded } : null,
|
|
24620
|
-
|
|
24623
|
+
checkout: checkout2 === null ? null : { branch: checkout2.branch, baseOid: checkout2.baseOid, baseGeneration: checkout2.baseGeneration }
|
|
24621
24624
|
};
|
|
24622
24625
|
}
|
|
24623
24626
|
|
|
@@ -24840,8 +24843,8 @@ async function portalAt(endpoint, opts) {
|
|
|
24840
24843
|
}
|
|
24841
24844
|
var REFUSED2 = {
|
|
24842
24845
|
read: "the portal will not show this sign-in the preparation in this organization",
|
|
24843
|
-
answer: "the portal will not let this sign-in answer for this organization (
|
|
24844
|
-
retry: "the portal will not let this sign-in try it again in this organization (
|
|
24846
|
+
answer: "the portal will not let this sign-in answer for this organization (the owner or an admin can, or the app's creator for the first preparation after an adoption)",
|
|
24847
|
+
retry: "the portal will not let this sign-in try it again in this organization (the owner or an admin can, or the app's creator, except for the first preparation after an adoption)"
|
|
24845
24848
|
};
|
|
24846
24849
|
function shown(portal, r, refused) {
|
|
24847
24850
|
switch (r.kind) {
|
|
@@ -25146,7 +25149,7 @@ function syncHint(state, conflicts, marked) {
|
|
|
25146
25149
|
}
|
|
25147
25150
|
}
|
|
25148
25151
|
|
|
25149
|
-
// src/commands/
|
|
25152
|
+
// src/commands/checkout.ts
|
|
25150
25153
|
var fetch2 = {
|
|
25151
25154
|
git: true,
|
|
25152
25155
|
async run(inv) {
|
|
@@ -25168,16 +25171,16 @@ var checkout = {
|
|
|
25168
25171
|
const { p } = await inv.client();
|
|
25169
25172
|
const branch = inv.str("branch");
|
|
25170
25173
|
const m = await p.checkout({ directory: dir, repoId, ...branch ? { branch } : {} }, { onProgress: inv.progress });
|
|
25171
|
-
inv.out({ ok: true,
|
|
25174
|
+
inv.out({ ok: true, checkout: m });
|
|
25172
25175
|
return 0;
|
|
25173
25176
|
}
|
|
25174
25177
|
};
|
|
25175
|
-
var
|
|
25178
|
+
var checkoutStatus = {
|
|
25176
25179
|
git: true,
|
|
25177
25180
|
async run(inv) {
|
|
25178
25181
|
const dir = inv.dirArg(1);
|
|
25179
25182
|
const { p } = await inv.client(dir);
|
|
25180
|
-
const s = await p.
|
|
25183
|
+
const s = await p.checkoutStatus(dir, { onProgress: inv.progress });
|
|
25181
25184
|
inv.out(s);
|
|
25182
25185
|
return s.state === "conflict" ? 2 : 0;
|
|
25183
25186
|
}
|
|
@@ -25390,15 +25393,15 @@ Usage:
|
|
|
25390
25393
|
publisher init [dir] [--name <name>] [--repo <id>] [--cell <cell>]
|
|
25391
25394
|
create (or attach to) a repository, associate this folder; --cell names
|
|
25392
25395
|
where a new app runs
|
|
25393
|
-
and record it as a
|
|
25396
|
+
and record it as a checkout (so sync works here)
|
|
25394
25397
|
publisher publish [dir] [--ref <ref>]... [--force] [--no-wait] publish commits as they are; to save and publish
|
|
25395
25398
|
a change, use sync
|
|
25396
25399
|
publisher status [dir] [--publication <id>] resolve pending/interrupted publications
|
|
25397
25400
|
publisher fetch [dir]
|
|
25398
25401
|
publisher list [--archived] [--after <next>] the apps you published, newest first, each with the
|
|
25399
25402
|
checkout command that brings it into a new folder
|
|
25400
|
-
publisher checkout <dir> --repo <id> [--branch <name>] create a NEW editable
|
|
25401
|
-
publisher
|
|
25403
|
+
publisher checkout <dir> --repo <id> [--branch <name>] create a NEW editable checkout (never overlays a folder)
|
|
25404
|
+
publisher checkout-status [dir] offline mapping + where the checkout stands (real three-way check)
|
|
25402
25405
|
publisher sync [dir] [--message <text>] [--name <app>] THE way to publish: a folder linked to nothing first gets its
|
|
25403
25406
|
application and repository (what init does); then it records the
|
|
25404
25407
|
changes (never .env, keys or node_modules), brings in what
|
|
@@ -25407,7 +25410,7 @@ Usage:
|
|
|
25407
25410
|
nothing published and nothing lost. No git needed
|
|
25408
25411
|
[--mark-conflicts] on a conflict, put both versions in each file, marked,
|
|
25409
25412
|
to edit; the next sync records and publishes the edit
|
|
25410
|
-
[--no-wait]
|
|
25413
|
+
[--no-wait] do not follow the app going live afterwards (received ->
|
|
25411
25414
|
checked -> going live -> live, up to 15 minutes)
|
|
25412
25415
|
[--timeout <seconds>] follow for at most this long; if it is still going, the
|
|
25413
25416
|
result's next.command picks it up
|
|
@@ -25415,7 +25418,7 @@ Usage:
|
|
|
25415
25418
|
publisher follow [dir] --publication <id> follow an accepted publication's run where a sync left it
|
|
25416
25419
|
[--timeout <seconds>] [--until-change] --until-change (sync too): return at the next step, to tell it
|
|
25417
25420
|
publisher question [dir] [--repo <id>] the question the app's preparation waits on, if any,
|
|
25418
|
-
with each option's value (
|
|
25421
|
+
with each option's value (the owner or an admin answers it, or
|
|
25419
25422
|
the app's creator for the first one after an adoption)
|
|
25420
25423
|
publisher answer <question>=<value>... [--repo <id>] answer it from this folder; a value that is not one of
|
|
25421
25424
|
the question's options is refused before anything is sent
|
|
@@ -25429,14 +25432,17 @@ Usage:
|
|
|
25429
25432
|
publisher suggestions what colleagues suggested for this folder's app, still open
|
|
25430
25433
|
publisher suggestion done|decline <id> [--run <id>] close one; sync --answers <id> closes it with that publication
|
|
25431
25434
|
publisher share members|emails|link [--add <emails>] [--remove <emails>]
|
|
25432
|
-
who can open this folder's app (a new app opens only to you
|
|
25433
|
-
the admins
|
|
25435
|
+
who can open this folder's app (a new app opens only to you, the
|
|
25436
|
+
owner, the admins and the people that a grant gives it to, until
|
|
25437
|
+
you share it); new invitees get the link by mail
|
|
25434
25438
|
publisher columns [<id>] the column names of connected data, for the code that reads it;
|
|
25435
|
-
its first rows only to
|
|
25439
|
+
its first rows only to the owner or an admin, where the
|
|
25440
|
+
owner or an admin allowed that for the data
|
|
25436
25441
|
publisher data add <sheet link> [--app <app>] [--name <name>]
|
|
25437
25442
|
connect a Google sheet anyone with the link can view, and
|
|
25438
|
-
turn it on for that app (an app you made, or any as
|
|
25439
|
-
|
|
25443
|
+
turn it on for that app (an app you made, or any app as the
|
|
25444
|
+
owner or an admin); only you, the owner and the admins can use
|
|
25445
|
+
new data until a grant gives access
|
|
25440
25446
|
publisher data remove <id> --app <app> that app stops using that data; the organization keeps it
|
|
25441
25447
|
publisher merge-check [dir] --ours <ref> --theirs <ref> [--apply]
|
|
25442
25448
|
publisher info [dir] repository state as seen by the server
|
|
@@ -25474,7 +25480,7 @@ var COMMANDS = /* @__PURE__ */ new Map([
|
|
|
25474
25480
|
["fetch", fetch2],
|
|
25475
25481
|
["list", list],
|
|
25476
25482
|
["checkout", checkout],
|
|
25477
|
-
["
|
|
25483
|
+
["checkout-status", checkoutStatus],
|
|
25478
25484
|
["sync", sync],
|
|
25479
25485
|
["follow", follow],
|
|
25480
25486
|
["question", question],
|