@runeditrun/rer 0.2.120 → 0.2.122
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/cli/README.md +173 -5
- package/cli/archive.mjs +1 -1
- package/cli/authoring.mjs +1 -1
- package/cli/browser-runtime.mjs +33 -18
- package/cli/business/agent-help.mjs +11 -11
- package/cli/business/agent-verbs.mjs +9 -8
- package/cli/business/api.mjs +11 -7
- package/cli/business/carry.mjs +4 -3
- package/cli/business/choices.mjs +1 -1
- package/cli/business/command.mjs +33 -11
- package/cli/business/connect.mjs +4 -4
- package/cli/business/credential-file.mjs +102 -0
- package/cli/business/errors.mjs +5 -2
- package/cli/business/invocation.mjs +7 -4
- package/cli/business/keychain.mjs +6 -2
- package/cli/business/local-commands.mjs +9 -3
- package/cli/business/mcp-bridge.mjs +2 -1
- package/cli/business/questions.mjs +1 -1
- package/cli/business/run-child.mjs +5 -5
- package/cli/business/run-grant.mjs +27 -8
- package/cli/business/run-mask.mjs +8 -1
- package/cli/business/scan-command.mjs +1 -1
- package/cli/business/service.mjs +4 -2
- package/cli/business/state.mjs +2 -2
- package/cli/checkout-folders.mjs +1 -1
- package/cli/checkout-preparation.mjs +4 -4
- package/cli/command-guidance.mjs +9 -0
- package/cli/companion/command.mjs +4 -3
- package/cli/companion/providers/sandbox.mjs +1 -1
- package/cli/companion/setup.mjs +4 -4
- package/cli/contract.mjs +8 -8
- package/cli/demo.mjs +1 -1
- package/cli/deploy-command.mjs +10 -5
- package/cli/deploy-hook.mjs +3 -2
- package/cli/deploy-inputs.mjs +20 -3
- package/cli/deploy-owner-input.mjs +2 -2
- package/cli/deploy-settings.mjs +14 -0
- package/cli/deploy-source.mjs +1 -1
- package/cli/deploy-variables.mjs +7 -1
- package/cli/deploy.mjs +6 -4
- package/cli/deployment-record.mjs +1 -1
- package/cli/dev-identity.mjs +4 -4
- package/cli/door-clauses.mjs +2 -2
- package/cli/door-mode.mjs +7 -7
- package/cli/door.mjs +7 -7
- package/cli/errors.mjs +15 -1
- package/cli/export-summary.mjs +1 -1
- package/cli/export.mjs +1 -1
- package/cli/hosted-export.mjs +1 -1
- package/cli/hosted-output.mjs +2 -2
- package/cli/human-error.mjs +8 -2
- package/cli/hydration/browser.mjs +1 -1
- package/cli/hydration/check.mjs +1 -1
- package/cli/import-summary.mjs +2 -2
- package/cli/inspect.mjs +9 -4
- package/cli/lifecycle.mjs +10 -10
- package/cli/listen.mjs +1 -1
- package/cli/listing.mjs +1 -1
- package/cli/local-env.mjs +1 -1
- package/cli/local.mjs +4 -4
- package/cli/managed-server.mjs +36 -13
- package/cli/output.mjs +2 -1
- package/cli/owner-entry-ready.mjs +92 -0
- package/cli/parse.mjs +19 -9
- package/cli/port.mjs +3 -3
- package/cli/portability-runtime.mjs +16 -0
- package/cli/portability.mjs +4 -4
- package/cli/production-auth.mjs +4 -2
- package/cli/production-mail.mjs +1 -1
- package/cli/project.mjs +2 -0
- package/cli/rehearse/options.mjs +3 -3
- package/cli/release-candidate.mjs +2 -2
- package/cli/release.mjs +5 -5
- package/cli/server-registry.mjs +3 -3
- package/cli/server-resources.mjs +1 -1
- package/cli/setup-input.mjs +6 -6
- package/cli/signin.mjs +11 -10
- package/cli/site-render.mjs +1 -1
- package/cli/size/schema.mjs +1 -1
- package/cli/size/verify-step.mjs +1 -1
- package/cli/transfers.mjs +4 -4
- package/edition-authoring/api-source.mjs +121 -0
- package/edition-authoring/archive-source.mjs +1 -86
- package/edition-authoring/base-copies.mjs +5 -3
- package/global/CHANGELOG.md +47 -0
- package/global/browser-runtime.mjs +9 -5
- package/global/cli/command.mjs +6 -5
- package/global/cli/install.mjs +6 -3
- package/global/cli/path-link.mjs +11 -22
- package/global/cli/repo-command.mjs +4 -3
- package/global/cli/repository-contract.mjs +3 -3
- package/global/door/command.mjs +39 -38
- package/global/door/control.mjs +3 -3
- package/global/door/pages.mjs +6 -5
- package/global/door/server.mjs +8 -5
- package/global/door/sites.mjs +14 -13
- package/global/launch/capacity.mjs +2 -2
- package/global/launch/dev.mjs +6 -6
- package/global/launch/door.mjs +1 -1
- package/global/launch/facts.mjs +2 -2
- package/global/launch/failure.mjs +1 -1
- package/global/launch/prepare.mjs +3 -3
- package/global/launch/render.mjs +3 -2
- package/global/launch/worker.mjs +1 -1
- package/global/list.mjs +4 -4
- package/global/main.mjs +32 -31
- package/global/registry.mjs +1 -1
- package/global/run.mjs +5 -5
- package/global/update/command.mjs +5 -5
- package/global/update/notice.mjs +1 -1
- package/global/version.mjs +1 -1
- package/install.sh +17 -4
- package/modules/deploy-kit/README.md +11 -3
- package/modules/deploy-kit/asset-health.mjs +6 -4
- package/modules/deploy-kit/cancellation.mjs +26 -0
- package/modules/deploy-kit/d1-import-diagnostics.mjs +3 -2
- package/modules/deploy-kit/deploy.mjs +8 -3
- package/modules/deploy-kit/diagnostics.mjs +11 -4
- package/modules/deploy-kit/health-request.mjs +16 -9
- package/modules/deploy-kit/health.mjs +14 -11
- package/modules/deploy-kit/owner-cli.mjs +55 -25
- package/modules/deploy-kit/owner-remove.mjs +7 -6
- package/modules/deploy-kit/owner-secret-copy.mjs +2 -1
- package/modules/deploy-kit/owner-secret.mjs +8 -5
- package/modules/deploy-kit/owner.mjs +49 -30
- package/modules/deploy-kit/provider-transport.mjs +2 -0
- package/modules/deploy-kit/provider.mjs +10 -9
- package/modules/deploy-kit/readiness-window.mjs +5 -3
- package/modules/deploy-kit/site.mjs +1 -1
- package/modules/deploy-kit/teardown.mjs +5 -4
- package/modules/deploy-kit/validation.mjs +1 -0
- package/modules/deploy-kit/worker.mjs +1 -0
- package/modules/operator-auth/dev/index.mjs +4 -3
- package/modules/operator-auth/dev/sign-in-as.mjs +2 -1
- package/modules/operator-auth/dev-gate.mjs +3 -2
- package/modules/operator-auth/routes.mjs +2 -1
- package/modules/operator-auth/terminal-guidance.mjs +3 -0
- package/onboarding/adapter-settings.mjs +1 -0
- package/onboarding/adapter.mjs +3 -3
- package/onboarding/agent-handoff.mjs +1 -1
- package/onboarding/busy.mjs +1 -1
- package/onboarding/launcher.mjs +1 -1
- package/onboarding/local/environment.mjs +1 -1
- package/onboarding/local/operation.mjs +12 -4
- package/onboarding/local/owner.mjs +2 -2
- package/onboarding/operator-installer.mjs +4 -3
- package/onboarding/operator-migrations.mjs +1 -1
- package/onboarding/operator-prerequisites.mjs +26 -14
- package/onboarding/operator-settings.mjs +28 -0
- package/onboarding/process-diagnostics.mjs +2 -2
- package/onboarding/project-vite.mjs +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
// --from-api retains its snapshot semantics, but acquires immutable Git objects
|
|
2
|
+
// in packs over HTTPS. This spends no GitHub REST core allowance.
|
|
3
|
+
import fs from 'node:fs';
|
|
4
|
+
import os from 'node:os';
|
|
5
|
+
import path from 'node:path';
|
|
6
|
+
import crypto from 'node:crypto';
|
|
7
|
+
import {execFileSync} from 'node:child_process';
|
|
8
|
+
import {hash, safe} from './files.mjs';
|
|
9
|
+
import {offlineRepository} from './offline-git.mjs';
|
|
10
|
+
|
|
11
|
+
const limit = 64 * 1024 * 1024, commit = /^[a-f0-9]{40}$/;
|
|
12
|
+
const objectId = bytes => crypto.createHash('sha1').update(`blob ${bytes.length}\0`).update(bytes).digest('hex');
|
|
13
|
+
|
|
14
|
+
export function apiReader(repository, revision) {
|
|
15
|
+
if (!commit.test(revision)) throw Error('Base API requires an immutable full 40-character commit');
|
|
16
|
+
if (!/^[\w.-]+\/[\w.-]+$/.test(repository)) throw Error('--from-api requires a GitHub Base repository');
|
|
17
|
+
const remote = `https://github.com/${repository}.git`;
|
|
18
|
+
const directory = fs.mkdtempSync(path.join(os.tmpdir(), 'base-api-'));
|
|
19
|
+
const env = Object.fromEntries(Object.entries(process.env).filter(([name]) =>
|
|
20
|
+
!/^GIT_(?:DIR|COMMON_DIR|WORK_TREE|INDEX_FILE|OBJECT_DIRECTORY|ALTERNATE_OBJECT_DIRECTORIES|SHALLOW_FILE|NAMESPACE|QUARANTINE_PATH|REPLACE_REF_BASE)$/.test(name)));
|
|
21
|
+
Object.assign(env, {GIT_NO_REPLACE_OBJECTS: '1', GIT_TERMINAL_PROMPT: '0', GIT_NO_LAZY_FETCH: '1'});
|
|
22
|
+
let local;
|
|
23
|
+
const close = () => { local?.close(); fs.rmSync(directory, {recursive: true, force: true}); };
|
|
24
|
+
const run = (args, input, localOnly = false) => {
|
|
25
|
+
try {
|
|
26
|
+
if (localOnly) local ??= offlineRepository(directory);
|
|
27
|
+
const repository = localOnly ? {root: local.root, env: local.env} : {root: directory, env};
|
|
28
|
+
return execFileSync('git', ['-C', repository.root, '-c', `core.hooksPath=${os.devNull}`, ...args], {
|
|
29
|
+
env: repository.env, input, stdio: ['pipe', 'pipe', 'pipe'], timeout: 60_000, maxBuffer: limit,
|
|
30
|
+
});
|
|
31
|
+
} catch (error) {
|
|
32
|
+
// Identify the exact failed request without echoing transport diagnostics,
|
|
33
|
+
// credential helpers or authenticated URLs from Git's stderr.
|
|
34
|
+
if (args.includes('fetch')) throw Error(`Cannot acquire Base ${revision}: git ${args.join(' ')}${input ? ` (stdin: ${input.trim().split('\n').join(' ')})` : ''} failed; no files were refreshed or copy record changed.`);
|
|
35
|
+
if (error.code === 'ENOBUFS') throw Error('Base API source output exceeds the 64 MiB acquisition limit');
|
|
36
|
+
throw Error(`Cannot read Base ${revision}: git ${args.join(' ')} failed; no files were refreshed or copy record changed.`);
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
const available = new Set(), trees = new Map(), objects = new Map(), ancestry = new Map();
|
|
40
|
+
const ensure = pin => {
|
|
41
|
+
if (!commit.test(pin)) throw Error('Base API requires an immutable full 40-character commit');
|
|
42
|
+
if (available.has(pin)) return;
|
|
43
|
+
let resolved;
|
|
44
|
+
try { resolved = run(['rev-parse', '--verify', `${pin}^{commit}`]).toString().trim(); } catch { /* Acquire only a missing immutable tip. */ }
|
|
45
|
+
if (resolved !== pin) {
|
|
46
|
+
// Full ancestry and trees arrive together. Blob probes use a separate
|
|
47
|
+
// object-store view without remotes: older Git ignores GIT_NO_LAZY_FETCH.
|
|
48
|
+
// Required blobs are acquired explicitly in packs below.
|
|
49
|
+
run(['-c', 'fetch.fsckObjects=true', 'fetch', '--filter=blob:none', '--no-tags', '--no-recurse-submodules', '--', remote, pin]);
|
|
50
|
+
if (run(['rev-parse', '--verify', `${pin}^{commit}`]).toString().trim() !== pin) throw Error('Base did not resolve the immutable commit');
|
|
51
|
+
}
|
|
52
|
+
if (!local) fs.writeFileSync(path.join(directory, 'HEAD'), pin + '\n');
|
|
53
|
+
available.add(pin);
|
|
54
|
+
};
|
|
55
|
+
try { run(['init', '--bare', '--quiet', '--template=', '--object-format=sha1']); }
|
|
56
|
+
catch (error) { close(); throw error; }
|
|
57
|
+
return {
|
|
58
|
+
close,
|
|
59
|
+
historyAvailable: false,
|
|
60
|
+
objectId,
|
|
61
|
+
tree(pin) {
|
|
62
|
+
ensure(pin);
|
|
63
|
+
if (!trees.has(pin)) {
|
|
64
|
+
const entries = new Map();
|
|
65
|
+
for (const line of run(['ls-tree', '-rz', '--full-tree', pin]).toString('utf8').split('\0').filter(Boolean)) {
|
|
66
|
+
const tab = line.indexOf('\t'), [mode, type, object] = line.slice(0, tab).split(' '), name = line.slice(tab + 1);
|
|
67
|
+
safe(name);
|
|
68
|
+
if (!commit.test(object)) throw Error('Invalid Base Git tree entry');
|
|
69
|
+
if (type === 'blob' && ['100644', '100755'].includes(mode)) entries.set(name, {object, mode});
|
|
70
|
+
}
|
|
71
|
+
trees.set(pin, new Map([...entries].sort(([a], [b]) => Buffer.compare(Buffer.from(a), Buffer.from(b)))));
|
|
72
|
+
}
|
|
73
|
+
return trees.get(pin);
|
|
74
|
+
},
|
|
75
|
+
blobs(ids) {
|
|
76
|
+
const unique = [...new Set(ids)], missing = unique.filter(id => !objects.has(id));
|
|
77
|
+
if (unique.some(id => !commit.test(id))) throw Error('Invalid Base API blob identity');
|
|
78
|
+
if (missing.length) {
|
|
79
|
+
const absent = run(['cat-file', '--batch-check'], missing.join('\n') + '\n', true).toString().trim().split('\n')
|
|
80
|
+
.filter(line => line.endsWith(' missing')).map(line => line.split(' ')[0]);
|
|
81
|
+
if (absent.length) run(['-c', 'fetch.fsckObjects=true', 'fetch', '--no-tags', '--no-recurse-submodules', '--stdin', '--', remote], absent.join('\n') + '\n');
|
|
82
|
+
}
|
|
83
|
+
for (let i = 0; i < missing.length; i += 100) {
|
|
84
|
+
const chunk = missing.slice(i, i + 100), output = run(['cat-file', '--batch'], chunk.join('\n') + '\n', true);
|
|
85
|
+
let offset = 0;
|
|
86
|
+
for (const object of chunk) {
|
|
87
|
+
const newline = output.indexOf(10, offset), [identity, type, size] = output.subarray(offset, newline).toString().split(' ');
|
|
88
|
+
const bytes = Buffer.from(output.subarray(newline + 1, newline + 1 + Number(size)));
|
|
89
|
+
if (identity !== object || type !== 'blob' || bytes.length !== Number(size) || objectId(bytes) !== object) throw Error('Base API blob integrity mismatch');
|
|
90
|
+
objects.set(object, bytes);
|
|
91
|
+
offset = newline + 1 + bytes.length + 1;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
const result = new Map();
|
|
95
|
+
let size = 0;
|
|
96
|
+
for (const object of unique) {
|
|
97
|
+
const bytes = objects.get(object);
|
|
98
|
+
size += bytes.length;
|
|
99
|
+
if (size > limit) throw Error('Base API source output exceeds the 64 MiB acquisition limit');
|
|
100
|
+
result.set(object, bytes);
|
|
101
|
+
}
|
|
102
|
+
return result;
|
|
103
|
+
},
|
|
104
|
+
digests(ids) { return new Map([...this.blobs(ids)].map(([object, bytes]) => [object, hash(bytes)])); },
|
|
105
|
+
contains(pin, introduced) {
|
|
106
|
+
ensure(pin); ensure(introduced);
|
|
107
|
+
const key = introduced + '...' + pin;
|
|
108
|
+
if (!ancestry.has(key)) {
|
|
109
|
+
// rev-list handles disconnected histories as a valid negative proof;
|
|
110
|
+
// missing or corrupt objects still fail explicitly.
|
|
111
|
+
const absent = run(['rev-list', '--max-count=1', introduced, '--not', pin]).length;
|
|
112
|
+
ancestry.set(key, absent === 0);
|
|
113
|
+
}
|
|
114
|
+
return ancestry.get(key);
|
|
115
|
+
},
|
|
116
|
+
history(pin, name) {
|
|
117
|
+
const entry = this.tree(pin).get(safe(name));
|
|
118
|
+
return entry ? [{revision: pin, ...entry}] : [];
|
|
119
|
+
},
|
|
120
|
+
};
|
|
121
|
+
}
|
|
@@ -1,96 +1,11 @@
|
|
|
1
|
-
// Directory archives supply one snapshot
|
|
2
|
-
// supply older immutable trees without requiring a local Git object store.
|
|
1
|
+
// Directory archives supply one immutable snapshot without Git history.
|
|
3
2
|
import fs from 'node:fs';
|
|
4
3
|
import path from 'node:path';
|
|
5
4
|
import crypto from 'node:crypto';
|
|
6
|
-
import {execFileSync} from 'node:child_process';
|
|
7
5
|
import {hash, safe} from './files.mjs';
|
|
8
6
|
|
|
9
7
|
const limit = 64 * 1024 * 1024;
|
|
10
8
|
const objectId = bytes => crypto.createHash('sha1').update(`blob ${bytes.length}\0`).update(bytes).digest('hex');
|
|
11
|
-
const commit = /^[a-f0-9]{40}$/;
|
|
12
|
-
|
|
13
|
-
export function apiReader(repository, revision) {
|
|
14
|
-
if (!commit.test(revision)) throw Error('Base API requires an immutable full 40-character commit');
|
|
15
|
-
const request = endpoint => {
|
|
16
|
-
try {
|
|
17
|
-
return JSON.parse(execFileSync('gh', ['api', `repos/${repository}/${endpoint}`], {
|
|
18
|
-
encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: 60_000, maxBuffer: limit,
|
|
19
|
-
}));
|
|
20
|
-
} catch (error) {
|
|
21
|
-
// Keep provider failures explicit without echoing arbitrary gh stderr,
|
|
22
|
-
// authentication diagnostics or credential-bearing transport URLs.
|
|
23
|
-
const status = /\bHTTP (\d{3})\b/.exec(error.stderr?.toString() ?? '')?.[1];
|
|
24
|
-
throw Error(`Cannot read Base ${revision} from the GitHub API${status ? ` (HTTP ${status})` : ''} (${endpoint}); no files were refreshed or copy record changed.`);
|
|
25
|
-
}
|
|
26
|
-
};
|
|
27
|
-
const trees = new Map(), objects = new Map(), ancestry = new Map();
|
|
28
|
-
return {
|
|
29
|
-
// Workflow-template discovery remains snapshot-only; no path history is
|
|
30
|
-
// invented from the API tree or the archive's version.
|
|
31
|
-
historyAvailable: false,
|
|
32
|
-
objectId,
|
|
33
|
-
tree(pin) {
|
|
34
|
-
if (!commit.test(pin)) throw Error('Base API requires an immutable full 40-character commit');
|
|
35
|
-
if (!trees.has(pin)) {
|
|
36
|
-
const pinned = request(`git/commits/${pin}`);
|
|
37
|
-
if (pinned.sha !== pin || !commit.test(pinned.tree?.sha)) throw Error('Base API did not resolve the immutable commit');
|
|
38
|
-
const entries = new Map();
|
|
39
|
-
const walk = (identity, prefix = '', recursive = true) => {
|
|
40
|
-
const tree = request(`git/trees/${identity}${recursive ? '?recursive=1' : ''}`);
|
|
41
|
-
if (recursive && tree.sha === identity && tree.truncated === true) return walk(identity, prefix, false);
|
|
42
|
-
if (tree.sha !== identity || tree.truncated !== false || !Array.isArray(tree.tree)) throw Error('Incomplete Base API tree');
|
|
43
|
-
for (const entry of tree.tree) {
|
|
44
|
-
safe(entry.path);
|
|
45
|
-
if ((!recursive && entry.path.includes('/')) || !commit.test(entry.sha)) throw Error('Invalid Base API tree entry');
|
|
46
|
-
const name = prefix + entry.path;
|
|
47
|
-
if (!recursive && entry.type === 'tree' && entry.mode === '040000') walk(entry.sha, name + '/');
|
|
48
|
-
else if (entry.type === 'blob' && ['100644', '100755'].includes(entry.mode)) entries.set(name, {object: entry.sha, mode: entry.mode});
|
|
49
|
-
}
|
|
50
|
-
};
|
|
51
|
-
walk(pinned.tree.sha);
|
|
52
|
-
trees.set(pin, new Map([...entries].sort(([a], [b]) => Buffer.compare(Buffer.from(a), Buffer.from(b)))));
|
|
53
|
-
}
|
|
54
|
-
return trees.get(pin);
|
|
55
|
-
},
|
|
56
|
-
blobs(ids) {
|
|
57
|
-
const result = new Map();
|
|
58
|
-
let size = 0;
|
|
59
|
-
for (const object of new Set(ids)) {
|
|
60
|
-
if (!commit.test(object)) throw Error('Invalid Base API blob identity');
|
|
61
|
-
if (!objects.has(object)) {
|
|
62
|
-
const blob = request(`git/blobs/${object}`);
|
|
63
|
-
if (blob.sha !== object || blob.encoding !== 'base64' || typeof blob.content !== 'string') throw Error('Invalid Base API blob');
|
|
64
|
-
const bytes = Buffer.from(blob.content, 'base64');
|
|
65
|
-
if (blob.size !== bytes.length || objectId(bytes) !== object) throw Error('Base API blob integrity mismatch');
|
|
66
|
-
objects.set(object, bytes);
|
|
67
|
-
}
|
|
68
|
-
const bytes = objects.get(object);
|
|
69
|
-
size += bytes.length;
|
|
70
|
-
if (size > limit) throw Error('Base API source output exceeds the 64 MiB acquisition limit');
|
|
71
|
-
result.set(object, bytes);
|
|
72
|
-
}
|
|
73
|
-
return result;
|
|
74
|
-
},
|
|
75
|
-
digests(ids) { return new Map([...this.blobs(ids)].map(([object, bytes]) => [object, hash(bytes)])); },
|
|
76
|
-
contains(pin, introduced) {
|
|
77
|
-
if (!commit.test(pin) || !commit.test(introduced)) throw Error('Base API ancestry requires immutable full commits');
|
|
78
|
-
const key = introduced + '...' + pin;
|
|
79
|
-
if (!ancestry.has(key)) {
|
|
80
|
-
const comparison = request(`compare/${key}?per_page=1`);
|
|
81
|
-
if (comparison.base_commit?.sha !== introduced || !commit.test(comparison.merge_base_commit?.sha) ||
|
|
82
|
-
!['ahead', 'identical', 'behind', 'diverged'].includes(comparison.status)) throw Error('Invalid Base API ancestry comparison');
|
|
83
|
-
if (['ahead', 'identical'].includes(comparison.status) && comparison.merge_base_commit.sha !== introduced) throw Error('Invalid Base API ancestry proof');
|
|
84
|
-
ancestry.set(key, ['ahead', 'identical'].includes(comparison.status));
|
|
85
|
-
}
|
|
86
|
-
return ancestry.get(key);
|
|
87
|
-
},
|
|
88
|
-
history(pin, name) {
|
|
89
|
-
const entry = this.tree(pin).get(safe(name));
|
|
90
|
-
return entry ? [{revision: pin, ...entry}] : [];
|
|
91
|
-
},
|
|
92
|
-
};
|
|
93
|
-
}
|
|
94
9
|
|
|
95
10
|
export function archiveReader(directory, revision) {
|
|
96
11
|
if (!/^[a-f0-9]{40}$/.test(revision)) throw Error('A Base archive requires its immutable full 40-character Base commit in --ref');
|
|
@@ -17,7 +17,8 @@ import {requireMaterializedCopies, preflightRefresh} from './copy-checkout.mjs';
|
|
|
17
17
|
import {completeModuleCopies} from './module-closure.mjs';
|
|
18
18
|
import {editionMigrations} from './edition-migrations.mjs';
|
|
19
19
|
import {adoptWorkflowTemplates, completeWorkflowHelpers} from './workflow-copies.mjs';
|
|
20
|
-
import {archiveReader
|
|
20
|
+
import {archiveReader} from './archive-source.mjs';
|
|
21
|
+
import {apiReader} from './api-source.mjs';
|
|
21
22
|
|
|
22
23
|
export const RECORD = 'base-copies.json';
|
|
23
24
|
const commit = /^[a-f0-9]{40}$/, sha256 = /^[a-f0-9]{64}$/;
|
|
@@ -101,12 +102,13 @@ export function options(args, count) {
|
|
|
101
102
|
return result;
|
|
102
103
|
}
|
|
103
104
|
|
|
104
|
-
// Share
|
|
105
|
+
// Share immutable GitHub acquisition for recording and refreshing.
|
|
105
106
|
function apiSource(record, root, revision) {
|
|
106
107
|
const declared = record.repository ?? baseRepository(root);
|
|
107
108
|
const repository = /^(?:https:\/\/github\.com\/)?([\w.-]+\/[\w.-]+?)(?:\.git)?$/.exec(declared)?.[1];
|
|
108
109
|
if (!repository) throw Error('--from-api requires a GitHub Base repository');
|
|
109
|
-
|
|
110
|
+
const read = apiReader(repository, revision);
|
|
111
|
+
return {read, head: revision, close: read.close};
|
|
110
112
|
}
|
|
111
113
|
|
|
112
114
|
export function validate(record) {
|
package/global/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,52 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.122
|
|
4
|
+
|
|
5
|
+
Signed: Run Edit Run fleet, 2026-11-17.
|
|
6
|
+
|
|
7
|
+
### Owner entry and local prerequisites
|
|
8
|
+
|
|
9
|
+
- Managed dev, preview and demo verify the declared owner entry through its public origin before announcing `RER_READY`, `RER_OPEN` or JSON readiness. The headless browser follows the entry exchange and redirects to a same-origin 2xx destination with visible rendered content, including read-only owner pages. Busy, loading and refresh interstitials do not qualify. Native single-use entries are checked before issuing a fresh link for the owner; startup visits stay attached to the server already starting.
|
|
10
|
+
- Readiness failures name the destination status and unmet exchange, navigation or content conditions without printing credential fragments or query values. `rer dev` names the failed local prerequisite, its safe found/expected values and the setup command, including missing migrations, owner state and local authentication/mail settings.
|
|
11
|
+
- Setup and the local installer repair stored hosted mail choices to local `MAIL_PROVIDER=development` before build isolation, suppressing local mail while keeping stored installer choices separate. Fresh local answers that request a hosted mail provider are refused with repair guidance.
|
|
12
|
+
|
|
13
|
+
### Commands in a new terminal
|
|
14
|
+
|
|
15
|
+
- Printed restart, stop and recovery commands use `~/.local/bin/rer`, including direct CLI, browser and adapter sign-in guidance, so the command works before PATH is configured.
|
|
16
|
+
- `rer cli path` prints the shell command to add `~/.local/bin` to PATH. For zsh and bash, executing that command adds the exact PATH line to `~/.zshrc` or `~/.bashrc` only if absent and updates the current terminal. The installer prints this step and new-terminal guidance; it does not edit shell files itself. Fish receives `fish_add_path`; other shells receive a current-terminal export.
|
|
17
|
+
|
|
18
|
+
### Granted deployments and recovery
|
|
19
|
+
|
|
20
|
+
- Business command grants report the scoped credential's expiry and distinguish an expiry stop from the child's result. A refused exchange can print Business's gap sentence, pending state and permission-catalogue counts while keeping other response fields private. Sealed launchers can select `RER_BUSINESS_CREDENTIAL_DIR` for owned 0700 directory/0600 file storage instead of OS credential storage, with device credentials masked in command and agent output.
|
|
21
|
+
- Deploy recovery follows the recorded Worker name, including native uploaders with a custom prefix, and refuses mismatched account/project/environment or provider identity. A dead writer's lock can be recovered; live writers stay protected. An authenticated matching interrupted upload completes without creating another code version; partial asset uploads restart in a new session. Unconfirmed resource creates retain their ownership uncertainty.
|
|
22
|
+
- An ambient Cloudflare token cannot be replaced by provider keys from `--env-file`. Cancellation reaches provider requests, response reads, health waits and owned Git processes, preserves deploy state and releases the lock. Resume uses the same checkout, account and environment under a fresh grant.
|
|
23
|
+
|
|
24
|
+
### Source refresh, archives and test isolation
|
|
25
|
+
|
|
26
|
+
- `rer refresh-base --from-api` acquires immutable Git objects in packs over HTTPS without spending GitHub REST core allowance, retaining full-commit selection and snapshot semantics.
|
|
27
|
+
- Installation archive adapters use the selected CLI's portability runtime even when the checkout pins another rer. Failed export/import commands retain their redacted capture-log path. The archive format and identity are unchanged.
|
|
28
|
+
- CLI fixtures scope their test ports and journey processes to each run and keep fixture ownership separate from top-level CLI context.
|
|
29
|
+
|
|
30
|
+
ChargeDesk checkouts pin rer 0.2.118 (and other seeds have older pins) and need a re-pin to receive deploy-kit, export and PATH fixes.
|
|
31
|
+
|
|
32
|
+
These changes require adoption through the seed's pinned package or refreshed source. This preparation establishes no seed adoption, provider delivery, deployment or production result. The source range changes no import-kit or portability module, product migration or archive format identity.
|
|
33
|
+
|
|
34
|
+
## 0.2.121
|
|
35
|
+
|
|
36
|
+
Signed: Run Edit Run fleet, 2026-11-16.
|
|
37
|
+
|
|
38
|
+
### Browser prerequisites by declared use
|
|
39
|
+
|
|
40
|
+
- `rer doctor` and `rer describe` inspect the checkout's Playwright registry without downloading or launching a browser. Missing executables include their purpose and a browser-only install command using that checkout's resolved CLI.
|
|
41
|
+
- Headless verification provisions only `chromium-headless-shell` when the Playwright pin supplies it, otherwise Chromium. An adapter declaring `browser: { headless: false }` also requires full Chromium; `rer run` honors `--headed` and `--debug` in Playwright scripts and forwarded arguments. `rer install` installs dependencies without browsers; verification and declared Playwright runs acquire the required browser on first use. The installed launcher also provisions missing browsers for older checkout pins.
|
|
42
|
+
|
|
43
|
+
### Switchable public deployment settings
|
|
44
|
+
|
|
45
|
+
- Seeds can opt a public selector such as `MAIL_PROVIDER` into in-place changes by declaring it in `publicSettings`, giving it a public default in `vars`, and retaining an optional secret transport with its environment mapping. Wrangler defaults must agree. `rer check` accepts this combination and reports conflicting defaults; `rer doctor` explains a refused overlap. Managed specs retain the selector as public, outside secret names.
|
|
46
|
+
- `rer deploy --set-secret NAME=VALUE` accepts assignments only for opted-in public settings. Name-only inputs still use the declared environment mapping; credentials come from the environment or an owned 0600 `--env-file` and remain masked. Unsetting the selector restores its declared public default in the grouped Worker version, and a plain deploy preserves a held override. Existing ownership, grouped-version and recovery handling remains in use.
|
|
47
|
+
|
|
48
|
+
These changes require seed adoption and the explicit deployment declaration where applicable. This preparation establishes no provider delivery, deployment, seed adoption or production result. The source diff changes no portability, import-kit, product migrations or archive format identity.
|
|
49
|
+
|
|
3
50
|
## 0.2.120
|
|
4
51
|
|
|
5
52
|
### Commands under an approved Business grant
|
|
@@ -1,14 +1,18 @@
|
|
|
1
1
|
// An older checkout pin still runs its own verbs. The installed launcher
|
|
2
2
|
// supplies the browser prerequisite those pins did not yet provision.
|
|
3
|
-
import { browserDoctor, ensureChromium } from '../cli/browser-runtime.mjs';
|
|
3
|
+
import { browserDoctor, browsersPresent, ensureChromium } from '../cli/browser-runtime.mjs';
|
|
4
|
+
import { resolveProject } from '../cli/project.mjs';
|
|
4
5
|
import { output } from '../cli/output.mjs';
|
|
5
6
|
import { RerError } from '../cli/errors.mjs';
|
|
6
7
|
import { shared } from '../cli/shared.mjs';
|
|
7
8
|
|
|
8
9
|
export async function browserPreflight(root, argv) {
|
|
9
10
|
const verb = argv[0], out = output({ verb, json: argv.includes('--json') });
|
|
11
|
+
let use;
|
|
12
|
+
try { use = (await resolveProject(root)).adapter?.browser; } catch { /* The checkout's command reports invalid declarations. */ }
|
|
13
|
+
if (argv.includes('--headed') || argv.includes('--debug')) use = { ...use, headless: false };
|
|
10
14
|
if (verb === 'doctor') {
|
|
11
|
-
const browser = await browserDoctor(root);
|
|
15
|
+
const browser = await browserDoctor(root, use);
|
|
12
16
|
if (browser.ok) return;
|
|
13
17
|
const diagnostics = { browser, ok: false, scope: 'browser-prerequisite' };
|
|
14
18
|
if (!argv.includes('--json')) out.human(JSON.stringify(diagnostics, null, 2));
|
|
@@ -16,7 +20,7 @@ export async function browserPreflight(root, argv) {
|
|
|
16
20
|
return 3;
|
|
17
21
|
}
|
|
18
22
|
// Installed browsers need no download, and no log.
|
|
19
|
-
if (
|
|
23
|
+
if (await browsersPresent(root, use)) return;
|
|
20
24
|
const cancellation = new AbortController();
|
|
21
25
|
const state = { logs: [], step: 'Checking the checkout’s Playwright browsers' };
|
|
22
26
|
let store, termination;
|
|
@@ -30,7 +34,7 @@ export async function browserPreflight(root, argv) {
|
|
|
30
34
|
store.setCommandSignal(cancellation.signal);
|
|
31
35
|
// A fresh vendored pin installs its own dependencies; verify will acquire
|
|
32
36
|
// their browser on first need. Package pins have already been bootstrapped.
|
|
33
|
-
await ensureChromium(root, store, cancellation.signal, { required: verb === 'verify' });
|
|
37
|
+
await ensureChromium(root, store, cancellation.signal, { ...use, required: verb === 'verify' });
|
|
34
38
|
} catch (error) {
|
|
35
39
|
const failure = termination ? new RerError('cancelled', `Stopped by ${termination} after owned children were stopped.`, termination === 'SIGINT' ? 130 : 143) : await browserStepError(error, store, state, root);
|
|
36
40
|
out.error(failure); out.result(false, failure.exitCode);
|
|
@@ -47,5 +51,5 @@ async function browserStepError(error, store, state, root) {
|
|
|
47
51
|
const { checkoutPath, stepDiagnostic, stepFailureText } = await shared('step-failure.mjs');
|
|
48
52
|
const step = approvedFailure(error)?.step ?? stepDiagnostic({ name: state.step, output: state.logs, log: store ? store.redact(checkoutPath(root, store.logPath)) : null });
|
|
49
53
|
const cause = error instanceof RerError ? `\n${error.message}` : /^[A-Z][A-Z0-9_]{1,63}$/.test(error?.code ?? '') ? `\nCause: ${error.code}` : '';
|
|
50
|
-
return new RerError(error instanceof RerError ? error.code : 'browser_install_failed', `${stepFailureText(step)}${cause}\
|
|
54
|
+
return new RerError(error instanceof RerError ? error.code : 'browser_install_failed', `${stepFailureText(step)}${cause}\nRetry the browser-only install command shown above.`, error instanceof RerError ? error.exitCode : 1, { step });
|
|
51
55
|
}
|
package/global/cli/command.mjs
CHANGED
|
@@ -1,17 +1,18 @@
|
|
|
1
|
+
import { withCommandHelp } from '../../cli/command-guidance.mjs';
|
|
1
2
|
// rer cli status|install|uninstall
|
|
2
|
-
const usage = 'Usage: rer cli status [--json] | rer cli install | rer cli uninstall | rer cli path\n';
|
|
3
|
+
const usage = 'Usage: ~/.local/bin/rer cli status [--json] | ~/.local/bin/rer cli install | ~/.local/bin/rer cli uninstall | ~/.local/bin/rer cli path\n';
|
|
3
4
|
|
|
4
5
|
export async function cliCommand(args) {
|
|
5
6
|
const [action, ...flags] = args;
|
|
6
|
-
if (!action || ['--help', '-h'].includes(action)) { process.stdout.write(usage); return 0; }
|
|
7
|
+
if (!action || ['--help', '-h'].includes(action)) { process.stdout.write(withCommandHelp(usage) + '\n'); return 0; }
|
|
7
8
|
const allowed = action === 'status' ? ['--json'] : [];
|
|
8
9
|
const unknown = flags.find(flag => !allowed.includes(flag));
|
|
9
|
-
if (!['status', 'install', 'uninstall', 'path'].includes(action) || unknown !== undefined) { process.stderr.write(`Unsupported: rer cli ${args.join(' ')}\n${usage}`); return 2; }
|
|
10
|
+
if (!['status', 'install', 'uninstall', 'path'].includes(action) || unknown !== undefined) { process.stderr.write(withCommandHelp(`Unsupported: ~/.local/bin/rer cli ${args.join(' ')}\n${usage}`) + '\n'); return 2; }
|
|
10
11
|
if (action === 'status') return (await import('./status.mjs')).status({ json: flags.includes('--json') });
|
|
11
12
|
if (action === 'path') {
|
|
12
|
-
const {
|
|
13
|
+
const { shellStartup } = await import('./path-link.mjs');
|
|
13
14
|
const { layout } = await import('./layout.mjs');
|
|
14
|
-
process.stdout.write((await
|
|
15
|
+
process.stdout.write((await shellStartup(layout().home)).line + '\n');
|
|
15
16
|
return 0;
|
|
16
17
|
}
|
|
17
18
|
if (action === 'install') return (await import('./install.mjs')).install();
|
package/global/cli/install.mjs
CHANGED
|
@@ -7,6 +7,7 @@ import { basename, join, resolve } from 'node:path';
|
|
|
7
7
|
import { ownManifest, ownRoot, packageDigest, packageFileList } from '../package-info.mjs';
|
|
8
8
|
import { installRecord, launcherOwner, launcherScript, layout } from './layout.mjs';
|
|
9
9
|
import { pathAdvice } from './path-link.mjs';
|
|
10
|
+
import { commandNotFoundHelp } from '../../cli/command-guidance.mjs';
|
|
10
11
|
import { runningDoor } from '../../cli/door.mjs';
|
|
11
12
|
import { channelOf } from './status.mjs';
|
|
12
13
|
|
|
@@ -41,10 +42,12 @@ async function writeLauncher(paths) {
|
|
|
41
42
|
}
|
|
42
43
|
|
|
43
44
|
// The absolute launcher works immediately, without editing shell files.
|
|
44
|
-
const shellQuote = value => "'" + value.replaceAll("'", "'\"'\"'") + "'";
|
|
45
45
|
async function closing(paths) {
|
|
46
46
|
const notices = await pathAdvice(paths, process.env, { includeShellStep: false });
|
|
47
|
-
return
|
|
47
|
+
if (process.env.RER_INSTALL_NO_NEXT) return notices ? notices + '\n' : '';
|
|
48
|
+
const advice = await pathAdvice(paths);
|
|
49
|
+
const terminal = !advice && ['zsh', 'bash'].includes(basename(process.env.SHELL ?? '')) ? 'Open a new Terminal window, then `rer` works by name.\n' : '';
|
|
50
|
+
return `Run a downloaded JavaScript tool with the installed runtime: ~/.local/bin/rer run --script ./tool.mjs [ARGS...]\nNext, start an app: ~/.local/bin/rer dev <owner>/<repo>\n${commandNotFoundHelp}\n${advice ? advice + '\n' : terminal}`;
|
|
48
51
|
}
|
|
49
52
|
|
|
50
53
|
export async function install({ quiet = false } = {}) {
|
|
@@ -53,7 +56,7 @@ export async function install({ quiet = false } = {}) {
|
|
|
53
56
|
const channel = (process.env.RER_INSTALL_CHANNEL ?? (await channelOf(paths)).channel) === 'script' ? 'script' : 'npx';
|
|
54
57
|
const launcher = await launcherOwner(paths.launcher);
|
|
55
58
|
if (launcher.state === 'foreign') {
|
|
56
|
-
process.stderr.write(
|
|
59
|
+
process.stderr.write(`~/.local/bin/rer cli install: ${paths.launcher} already exists and was not written by ~/.local/bin/rer cli install (it may be the unrelated npm package "rer"). Nothing was changed. Remove or rename it, then run the install again.\n`);
|
|
57
60
|
return 4;
|
|
58
61
|
}
|
|
59
62
|
const record = await installRecord(paths), current = await readLink(paths.current);
|
package/global/cli/path-link.mjs
CHANGED
|
@@ -9,28 +9,15 @@ export async function ownedPathLink(path, launcher) {
|
|
|
9
9
|
catch (error) { if (error.code === 'ENOENT' || error.code === 'EINVAL') return false; throw error; }
|
|
10
10
|
}
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
// ~/.local/bin on PATH in this terminal and, through the startup file, in new
|
|
16
|
-
// ones. rer never runs it: the person does.
|
|
17
|
-
export async function shellStartup(home, env = process.env, platform = process.platform) {
|
|
12
|
+
// Only the person executing the printed command edits their shell file.
|
|
13
|
+
// Match the complete PATH line before appending so repeated execution is safe.
|
|
14
|
+
export async function shellStartup(home, env = process.env) {
|
|
18
15
|
const shell = basename(env.SHELL ?? ''), add = 'export PATH="$HOME/.local/bin:$PATH"';
|
|
19
|
-
if (shell === 'fish') return { files: ['.config/fish/config.fish', '.config/fish/fish_variables'].map(file => join(home, file)), line: 'fish_add_path ~/.local/bin' };
|
|
20
|
-
if (
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
}
|
|
24
|
-
const files = shell === 'bash' ? ['.bash_profile', '.bash_login', '.profile', '.bashrc'] : ['.profile'];
|
|
25
|
-
// macOS terminals start bash as a login shell, which reads only the first of
|
|
26
|
-
// its profiles that exists; elsewhere a terminal's bash reads ~/.bashrc.
|
|
27
|
-
let file = '.profile';
|
|
28
|
-
if (shell === 'bash' && platform !== 'darwin') file = '.bashrc';
|
|
29
|
-
else if (shell === 'bash') {
|
|
30
|
-
file = '.bash_profile';
|
|
31
|
-
for (const candidate of files.slice(0, 3)) if (await exists(join(home, candidate))) { file = candidate; break; }
|
|
32
|
-
}
|
|
33
|
-
return { files: files.map(name => join(home, name)), line: `echo '${add}' >> ~/${file} && ${add}` };
|
|
16
|
+
if (shell === 'fish') return { files: ['.config/fish/config.fish', '.config/fish/fish_variables'].map(file => join(home, file)), target: '~/.config/fish', line: 'fish_add_path ~/.local/bin' };
|
|
17
|
+
if (!['zsh', 'bash'].includes(shell)) return { files: [], line: add };
|
|
18
|
+
const file = shell === 'zsh' ? '.zshrc' : '.bashrc';
|
|
19
|
+
const target = `~/${file}`;
|
|
20
|
+
return { files: [join(home, file)], target, line: `(grep -Fqx '${add}' ${target} 2>/dev/null || printf '\\n%s\\n' '${add}' >> ${target}) && ${add}` };
|
|
34
21
|
}
|
|
35
22
|
|
|
36
23
|
// Whether a startup file already puts ~/.local/bin on PATH for new terminals.
|
|
@@ -63,6 +50,8 @@ export async function pathAdvice(paths, env = process.env, { includeShellStep =
|
|
|
63
50
|
const first = entries.includes(bin) && firstCommand === paths.launcher;
|
|
64
51
|
if (first && await persistent(startup.files)) return lines.join('\n');
|
|
65
52
|
const why = first ? 'New terminals will not find rer yet.' : firstCommand ? `Another rer (${firstCommand}) comes first on your PATH.` : 'rer is not on your PATH yet.';
|
|
66
|
-
|
|
53
|
+
const effect = basename(env.SHELL ?? '') === 'fish' ? 'fish saves ~/.local/bin in its user path configuration' : startup.target ? `you add ~/.local/bin to PATH in ${startup.target} and this terminal` : 'you add ~/.local/bin to PATH for this terminal only';
|
|
54
|
+
lines.push(`Next step: ${why} Run this line; ${effect}. The installer changes no shell file:`, ` ${startup.line}`);
|
|
55
|
+
if (['zsh', 'bash'].includes(basename(env.SHELL ?? ''))) lines.push('Open a new Terminal window, then `rer` works by name.');
|
|
67
56
|
return lines.join('\n');
|
|
68
57
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { withCommandHelp } from '../../cli/command-guidance.mjs';
|
|
1
2
|
import { realpath } from 'node:fs/promises';
|
|
2
3
|
import { join } from 'node:path';
|
|
3
4
|
import { parse } from '../../cli/parse.mjs';
|
|
@@ -18,7 +19,7 @@ export async function repoCommand(request) {
|
|
|
18
19
|
if (installed !== 0) return installed;
|
|
19
20
|
await checkoutRepository(request);
|
|
20
21
|
const root = await realpath(request.root);
|
|
21
|
-
const next = command => `cd ${shellQuote(directory)} && rer ${command}`;
|
|
22
|
+
const next = command => `cd ${shellQuote(directory)} && ~/.local/bin/rer ${command}`;
|
|
22
23
|
if (verb === 'setup') {
|
|
23
24
|
await (await import('../../cli/business/carry.mjs')).refreshCheckout(root);
|
|
24
25
|
const state = await launchDirectory(root), children = new Set(), controller = new AbortController();
|
|
@@ -34,7 +35,7 @@ export async function repoCommand(request) {
|
|
|
34
35
|
await log.close();
|
|
35
36
|
}
|
|
36
37
|
} else {
|
|
37
|
-
if (verb === 'dev' && !args.includes('--json')) process.stdout.write(`Restart: ${next('dev')}\n
|
|
38
|
+
if (verb === 'dev' && !args.includes('--json')) process.stdout.write(withCommandHelp(`Restart: ${next('dev')}`) + '\n');
|
|
38
39
|
const entry = join(ownRoot, 'global/rer.mjs');
|
|
39
40
|
const code = await runCommand(process.execPath, [entry, verb, ...args], { cwd: root,
|
|
40
41
|
...(verb === 'dev' ? { onInterrupt: () => runCommand(process.execPath, [entry, 'dev', '--stop'], { cwd: root }) } : {}),
|
|
@@ -43,7 +44,7 @@ export async function repoCommand(request) {
|
|
|
43
44
|
}
|
|
44
45
|
if (verb !== 'dev') {
|
|
45
46
|
const command = next(verb === 'install' ? 'setup' : 'dev');
|
|
46
|
-
process.stdout.write(args.includes('--json') ? JSON.stringify({ version: 1, verb, event: 'next', command }) + '\n' : `Next: ${command}\n
|
|
47
|
+
process.stdout.write(args.includes('--json') ? JSON.stringify({ version: 1, verb, event: 'next', command }) + '\n' : withCommandHelp(`Next: ${command}`) + '\n');
|
|
47
48
|
}
|
|
48
49
|
return 0;
|
|
49
50
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// Repository acquisition belongs to the global CLI, before checkout dispatch.
|
|
2
2
|
export const repositoryCommands = Object.freeze({
|
|
3
|
-
install: { usage: 'rer install <repo> [--dir DIR] [FLAGS]', effects: 'Install rer for this user, clone or reuse the repository, install its dependencies, then stop.' },
|
|
4
|
-
setup: { usage: 'rer setup <repo> [--dir DIR] [FLAGS]', effects: 'Install rer, clone or reuse the repository, install dependencies and set up a local owner, then print the dev command.' },
|
|
5
|
-
dev: { usage: 'rer dev <repo> [--dir DIR] [FLAGS]', effects: 'Install rer, clone or reuse the repository, install and set up as needed, then start dev and print RER_READY and RER_OPEN.' },
|
|
3
|
+
install: { usage: '~/.local/bin/rer install <repo> [--dir DIR] [FLAGS]', effects: 'Install rer for this user, clone or reuse the repository, install its dependencies, then stop.' },
|
|
4
|
+
setup: { usage: '~/.local/bin/rer setup <repo> [--dir DIR] [FLAGS]', effects: 'Install rer, clone or reuse the repository, install dependencies and set up a local owner, then print the dev command.' },
|
|
5
|
+
dev: { usage: '~/.local/bin/rer dev <repo> [--dir DIR] [FLAGS]', effects: 'Install rer, clone or reuse the repository, install and set up as needed, then start dev and print RER_READY and RER_OPEN.' },
|
|
6
6
|
});
|
|
7
7
|
export const repositoryHelp = 'Repository: <owner>/<repo>, a GitHub HTTPS URL (with or without .git), or a git URL.\nClones into ./<repo-name>; --dir overrides. Reuses a clone with the same origin; refuses any other non-empty folder.\n';
|