@muhkoo/cli 0.15.0-alpha.13 → 0.15.0-alpha.15
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/README.md +37 -7
- package/bin/muhkoo.js +7 -1
- package/package.json +9 -5
- package/src/commands/deploy.js +192 -9
- package/src/commands/kv.js +0 -2
- package/src/commands/login.js +49 -3
- package/src/commands/logout.js +4 -2
- package/src/commands/mcp.js +28 -0
- package/src/commands/promote.js +0 -1
- package/src/commands/provision.js +17 -1
- package/src/commands/vfs.js +110 -98
- package/src/index.js +7 -3
- package/src/lib/auth.js +7 -2
- package/src/lib/bases.js +8 -0
- package/src/lib/mount.js +3 -0
- package/src/lib/ui.js +30 -5
- package/src/lib/vfs.js +46 -44
- package/src/lib/webLogin.js +85 -20
- package/src/mcp/node.js +90 -0
- package/src/mcp/run.js +125 -0
- package/src/mcp/secrets.js +130 -0
- package/src/mcp/server.js +87 -0
- package/src/mcp/tools.js +782 -0
package/src/commands/vfs.js
CHANGED
|
@@ -9,10 +9,11 @@
|
|
|
9
9
|
|
|
10
10
|
import { lstat, readFile, stat, writeFile } from "node:fs/promises";
|
|
11
11
|
import { basename, dirname, isAbsolute, resolve } from "node:path";
|
|
12
|
-
import { openClient
|
|
12
|
+
import { openClient } from "../lib/vfs.js";
|
|
13
13
|
import { mount as mountDir, importOnce, previewMount, heldBack, acceptIgnores, diskIgnoreTexts, assertMountable, mountTarget } from "../lib/mount.js";
|
|
14
14
|
import { draftIgnores, ignoreFileProblem } from "../lib/ignore.js";
|
|
15
|
-
import { loadConfig, saveConfig } from "../lib/config.js";
|
|
15
|
+
import { loadConfig, saveConfig, resolveBase } from "../lib/config.js";
|
|
16
|
+
import { devCall } from "../lib/http.js";
|
|
16
17
|
import { table, json, ok, info, warn, die, writeText, prompt } from "../lib/ui.js";
|
|
17
18
|
|
|
18
19
|
export const help = `muhkoo vfs — your encrypted filesystem
|
|
@@ -62,8 +63,17 @@ Usage:
|
|
|
62
63
|
Ctrl-C or closing the terminal stops it after
|
|
63
64
|
the current file; a second Ctrl-C quits now)
|
|
64
65
|
muhkoo vfs sweep [--force] reclaim orphaned records
|
|
65
|
-
muhkoo vfs use-app <domain>
|
|
66
|
-
|
|
66
|
+
muhkoo vfs use-app <domain> no longer needed: your filesystem is billed
|
|
67
|
+
to your account (prints a notice)
|
|
68
|
+
muhkoo vfs app likewise
|
|
69
|
+
muhkoo vfs rehome [--dry-run] [--json] move files stored under an app to your account
|
|
70
|
+
(what older versions of the IDE and
|
|
71
|
+
Cloud Drive wrote); run it once. It
|
|
72
|
+
moves only what your own files point
|
|
73
|
+
at, skips what is already moved, and is
|
|
74
|
+
safe to repeat. --dry-run lists the
|
|
75
|
+
candidates and calls nothing. Exits 1
|
|
76
|
+
if any file failed, so a script can retry
|
|
67
77
|
|
|
68
78
|
What gets synced is decided by .vcsignore if there is one. Otherwise git's
|
|
69
79
|
rules apply: every .gitignore, each scoped to its own directory, and
|
|
@@ -90,22 +100,21 @@ rules is left alone — neither synced nor deleted — and named.
|
|
|
90
100
|
|
|
91
101
|
Some paths never sync in either direction, whatever the rules say: .git,
|
|
92
102
|
.ssh, node_modules, .muhkoo, editor and agent config (.vscode, .idea, .claude,
|
|
93
|
-
.cursor, .zed, .fleet), .husky, and shell and credential files
|
|
94
|
-
.netrc, .zshrc, .zshenv, …). Neither import nor
|
|
95
|
-
directory, or on anything that contains it. One
|
|
96
|
-
2 GiB or 10,000 files, and reads at most as much
|
|
97
|
-
once in another pass; what it has read before it
|
|
98
|
-
leaves the disk 5% of its space free, at least
|
|
99
|
-
judged by the bytes that arrive, not the sizes
|
|
100
|
-
Ignore files are held to these limits like any other
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
103
|
+
.cursor, .zed, .fleet), .husky, and shell and credential files
|
|
104
|
+
(.muhkoo-app.json, .npmrc, .netrc, .zshrc, .zshenv, …). Neither import nor
|
|
105
|
+
mount will run on your home directory, or on anything that contains it. One
|
|
106
|
+
pass of mount pulls at most 2 GiB or 10,000 files, and reads at most as much
|
|
107
|
+
to compare, carrying on at once in another pass; what it has read before it
|
|
108
|
+
does not read again. A pull leaves the disk 5% of its space free, at least
|
|
109
|
+
1 GiB and at most 10 GiB — judged by the bytes that arrive, not the sizes
|
|
110
|
+
your filesystem reports. Ignore files are held to these limits like any other
|
|
111
|
+
file.
|
|
112
|
+
|
|
113
|
+
Your filesystem is billed to your account, not to an app: nothing to sign in
|
|
114
|
+
to first, and no app key. (\`vfs use-app\`, \`--app\` and \`--key\` are
|
|
115
|
+
accepted and ignored.)
|
|
104
116
|
|
|
105
117
|
Options:
|
|
106
|
-
--app <name> write as this app for one command
|
|
107
|
-
--key <k> supply the app key yourself (apps that publish their public
|
|
108
|
-
config at /.well-known/muhkoo.json need no key)
|
|
109
118
|
--allow-delete propagate deletions (import: only to your filesystem). OFF by
|
|
110
119
|
default: a delete removes the file's history too, so unlike an
|
|
111
120
|
overwrite it cannot be undone. It trusts the remote side. A pass
|
|
@@ -121,6 +130,22 @@ Options:
|
|
|
121
130
|
machine (it signs in for the one command if it must)
|
|
122
131
|
--no-pair unlock for this command only; pair nothing to this machine`;
|
|
123
132
|
|
|
133
|
+
const NOT_NEEDED = "Not needed any more: your filesystem is billed to your account.";
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* The apps older versions of the IDE and Cloud Drive wrote files under, by id,
|
|
137
|
+
* per API base. A local base has none. Ids, not slugs: slugs are per account,
|
|
138
|
+
* these are the two shared apps.
|
|
139
|
+
*/
|
|
140
|
+
export const IDE_APP_IDS = {
|
|
141
|
+
"https://api.muhkoo.dev": "36bfe1582aaf98e95157e8f80d519d10",
|
|
142
|
+
"https://api.staging.muhkoo.dev": "7dacbbf0634278f46bc8e6d3ade9199b",
|
|
143
|
+
};
|
|
144
|
+
export const CLOUD_DRIVE_APP_IDS = {
|
|
145
|
+
"https://api.muhkoo.dev": "53f8d3d5fb6faa9dcefa9df5aba1ae04",
|
|
146
|
+
"https://api.staging.muhkoo.dev": "999bed2ba01b168d4f70932777392da4",
|
|
147
|
+
};
|
|
148
|
+
|
|
124
149
|
export default async function vfs(args) {
|
|
125
150
|
const sub = args._[1];
|
|
126
151
|
if (sub === undefined) return die("Missing subcommand. See `muhkoo vfs --help`.");
|
|
@@ -131,6 +156,11 @@ export default async function vfs(args) {
|
|
|
131
156
|
// limiter long before it finishes.
|
|
132
157
|
if (sub === "ignore") return ignoreCommand(args);
|
|
133
158
|
|
|
159
|
+
// The app key is gone: the filesystem is billed to your account. Say so for
|
|
160
|
+
// the old spellings, and ignore them — `use-app` and `app` never needed a
|
|
161
|
+
// session, so they do not open one.
|
|
162
|
+
if (sub === "use-app" || sub === "app") return info(NOT_NEEDED);
|
|
163
|
+
|
|
134
164
|
// Where to sync is checked before the session opens, which can ask for a
|
|
135
165
|
// password: `vfs mount /apps/x --path ./`, the two swapped, unlocked the
|
|
136
166
|
// vault and then set about creating /apps at the top of this disk.
|
|
@@ -140,22 +170,22 @@ export default async function vfs(args) {
|
|
|
140
170
|
if (problem) return die(pathError("import into", problem));
|
|
141
171
|
}
|
|
142
172
|
|
|
173
|
+
if (args.key !== undefined || args.app !== undefined) {
|
|
174
|
+
info(NOT_NEEDED);
|
|
175
|
+
const { key: _key, app: _app, ...rest } = args;
|
|
176
|
+
args = rest;
|
|
177
|
+
}
|
|
178
|
+
|
|
143
179
|
// A dry run writes nothing, and that includes ~/.muhkoo: unlocking would
|
|
144
180
|
// otherwise pair a machine not paired yet (a device enrolled on the server,
|
|
145
181
|
// its key saved) and reset a stale working directory. It unlocks for this
|
|
146
182
|
// command only. A swallowed directory (`--dry-run <dir>`) still counts.
|
|
147
|
-
const dryRun = (sub === "import" || sub === "push" || sub === "mount") && Boolean(args["dry-run"]);
|
|
183
|
+
const dryRun = (sub === "import" || sub === "push" || sub === "mount" || sub === "rehome") && Boolean(args["dry-run"]);
|
|
148
184
|
const client = await openClient(dryRun ? { ...args, pair: false, readOnly: true } : args);
|
|
149
185
|
const fs = client.vfs;
|
|
150
186
|
const a = (n, dflt) => args._[n] ?? dflt;
|
|
151
187
|
|
|
152
|
-
|
|
153
|
-
return await run();
|
|
154
|
-
} catch (err) {
|
|
155
|
-
const explained = explainWriteFailure(err, await loadConfig());
|
|
156
|
-
if (explained) die(...explained);
|
|
157
|
-
throw err;
|
|
158
|
-
}
|
|
188
|
+
return await run();
|
|
159
189
|
|
|
160
190
|
async function run() {
|
|
161
191
|
switch (sub) {
|
|
@@ -277,27 +307,8 @@ export default async function vfs(args) {
|
|
|
277
307
|
return ok(`Restored ${path} to version ${index} (${humanSize(stat.size)})`);
|
|
278
308
|
}
|
|
279
309
|
|
|
280
|
-
case "
|
|
281
|
-
|
|
282
|
-
if (!slug) die("Missing app. Usage: muhkoo vfs use-app <slug> [--key <appKey>]");
|
|
283
|
-
const saved = await useApp(slug, args.key);
|
|
284
|
-
return ok(
|
|
285
|
-
`Writing as "${saved.slug}". Reads never needed this; writes are now metered to that app.`,
|
|
286
|
-
);
|
|
287
|
-
}
|
|
288
|
-
|
|
289
|
-
case "app": {
|
|
290
|
-
const current = await loadConfig();
|
|
291
|
-
const slug = current.vfsApp;
|
|
292
|
-
if (args.json) return json({ app: slug ?? null, known: Object.keys(current.vfsApps ?? {}) });
|
|
293
|
-
if (!slug) {
|
|
294
|
-
return info(
|
|
295
|
-
"Not writing as any app — reads work, writes will not.",
|
|
296
|
-
"Sign one in with: muhkoo vfs use-app <slug> --key <appKey>",
|
|
297
|
-
);
|
|
298
|
-
}
|
|
299
|
-
return info(`Writing as "${slug}".`);
|
|
300
|
-
}
|
|
310
|
+
case "rehome":
|
|
311
|
+
return rehomeCommand(args, fs);
|
|
301
312
|
|
|
302
313
|
case "import":
|
|
303
314
|
case "push": {
|
|
@@ -653,65 +664,66 @@ function humanSize(bytes) {
|
|
|
653
664
|
}
|
|
654
665
|
|
|
655
666
|
/**
|
|
656
|
-
*
|
|
657
|
-
*
|
|
658
|
-
*
|
|
659
|
-
*
|
|
660
|
-
*
|
|
661
|
-
*
|
|
662
|
-
* It has to come from the app rather than the platform: key plaintexts are
|
|
663
|
-
* never stored server-side (only `keyHashPrefix`), so no API can answer "what
|
|
664
|
-
* is the key for this domain". A publishable key is public by design — it ships
|
|
665
|
-
* in the app's own bundle — so the app serving it at a well-known path gives
|
|
666
|
-
* away nothing that loading the app in a browser does not.
|
|
667
|
-
*
|
|
668
|
-
* A bare slug still works for an app you own and have a key for.
|
|
667
|
+
* `muhkoo vfs rehome`: move files an older app stored under its own billing to
|
|
668
|
+
* this account. Candidates are the built-in IDE and Cloud Drive ids for this
|
|
669
|
+
* base plus the ids of the apps named in `vfsApps` (resolved through the apps
|
|
670
|
+
* list). Moving what is not ours is the server's to refuse, so over-asking is
|
|
671
|
+
* harmless.
|
|
669
672
|
*/
|
|
670
|
-
async function
|
|
673
|
+
async function rehomeCommand(args, fs) {
|
|
671
674
|
const cfg = await loadConfig();
|
|
672
|
-
const
|
|
673
|
-
const
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
675
|
+
const baseUrl = String(await resolveBase(args, cfg)).replace(/\/+$/, "");
|
|
676
|
+
const ids = new Set([IDE_APP_IDS[baseUrl], CLOUD_DRIVE_APP_IDS[baseUrl]].filter(Boolean));
|
|
677
|
+
|
|
678
|
+
const slugs = Object.keys(cfg.vfsApps ?? {});
|
|
679
|
+
if (slugs.length) {
|
|
680
|
+
const token = args.token || process.env.MUHKOO_DEV_TOKEN || cfg.token;
|
|
681
|
+
const listed = await devCall({ baseUrl, token }, "GET", "/api/apps").catch(() => null);
|
|
682
|
+
const apps = listed?.ok ? (listed.body?.apps || listed.body || []) : null;
|
|
683
|
+
if (!Array.isArray(apps)) {
|
|
684
|
+
info("The CLI's own app list couldn't be read, so only the built-in candidates are used.");
|
|
685
|
+
} else {
|
|
686
|
+
for (const app of apps) if (!app.deletedAt && slugs.includes(app.slug) && app.appId) ids.add(app.appId);
|
|
687
|
+
}
|
|
677
688
|
}
|
|
689
|
+
const fromAppIds = [...ids];
|
|
678
690
|
|
|
679
|
-
if (
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
:
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
]),
|
|
691
|
+
if (args["dry-run"]) {
|
|
692
|
+
const files = (await fs.walk("/")).length;
|
|
693
|
+
return info(
|
|
694
|
+
`${files} file${files === 1 ? "" : "s"} in your filesystem.`,
|
|
695
|
+
fromAppIds.length
|
|
696
|
+
? `Would move anything stored under: ${fromAppIds.join(", ")}`
|
|
697
|
+
: "No candidate apps for this API base, so nothing would be moved.",
|
|
698
|
+
"Dry run: nothing was changed.",
|
|
688
699
|
);
|
|
689
700
|
}
|
|
690
|
-
const next = key ? { ...known, [nameOrDomain]: key } : known;
|
|
691
|
-
await saveConfig({ ...cfg, vfsApps: next, vfsApp: nameOrDomain });
|
|
692
|
-
return { slug: nameOrDomain, key: next[nameOrDomain] };
|
|
693
|
-
}
|
|
694
|
-
|
|
695
|
-
const WELL_KNOWN = "/.well-known/muhkoo.json";
|
|
696
701
|
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
702
|
+
let progressShown = false;
|
|
703
|
+
const result = await fs.rehome({
|
|
704
|
+
fromAppIds,
|
|
705
|
+
onProgress: args.json ? undefined : (done, total) => {
|
|
706
|
+
if (process.stderr.isTTY) {
|
|
707
|
+
process.stderr.write(`\r ${done}/${total}`);
|
|
708
|
+
progressShown = true;
|
|
709
|
+
}
|
|
710
|
+
},
|
|
711
|
+
});
|
|
712
|
+
// End the `\r n/m` line, so the summary does not print over it.
|
|
713
|
+
if (progressShown) process.stderr.write("\n");
|
|
714
|
+
if (args.json) {
|
|
715
|
+
json(result);
|
|
716
|
+
} else {
|
|
717
|
+
ok("Rehome finished.");
|
|
718
|
+
info(
|
|
719
|
+
` moved: ${result.moved}`,
|
|
720
|
+
` already moved: ${result.alreadyMoved}`,
|
|
721
|
+
` not held: ${result.notHeld}`,
|
|
722
|
+
` failed: ${result.failed}`,
|
|
723
|
+
);
|
|
714
724
|
}
|
|
725
|
+
// `die`, not `process.exitCode`: the launcher exits 0 once a command returns.
|
|
726
|
+
if (result.failed > 0) return die(`${result.failed} file${result.failed === 1 ? "" : "s"} could not be moved. Run \`muhkoo vfs rehome\` again to retry.`);
|
|
715
727
|
}
|
|
716
728
|
|
|
717
729
|
/**
|
package/src/index.js
CHANGED
|
@@ -8,7 +8,7 @@ import { readFile } from "node:fs/promises";
|
|
|
8
8
|
import { fileURLToPath } from "node:url";
|
|
9
9
|
import { dirname, join } from "node:path";
|
|
10
10
|
import { parseArgs } from "./lib/args.js";
|
|
11
|
-
import { c, die, info } from "./lib/ui.js";
|
|
11
|
+
import { c, die, info, setJsonMode } from "./lib/ui.js";
|
|
12
12
|
|
|
13
13
|
const COMMANDS = {
|
|
14
14
|
login: () => import("./commands/login.js"),
|
|
@@ -32,6 +32,7 @@ const COMMANDS = {
|
|
|
32
32
|
functions: () => import("./commands/functions.js"),
|
|
33
33
|
logs: () => import("./commands/logs.js"),
|
|
34
34
|
eject: () => import("./commands/eject.js"),
|
|
35
|
+
mcp: () => import("./commands/mcp.js"),
|
|
35
36
|
};
|
|
36
37
|
|
|
37
38
|
const TOP_HELP = `${c.bold("muhkoo")} — command-line interface for the Muhkoo platform
|
|
@@ -63,13 +64,14 @@ Files
|
|
|
63
64
|
vfs import|mount|ignore
|
|
64
65
|
upload a project, keep a directory in sync, and
|
|
65
66
|
choose what syncs
|
|
66
|
-
vfs sweep|
|
|
67
|
+
vfs sweep|rehome reclaim records; move files an app stored to your account
|
|
68
|
+
vfs use-app|app no longer needed (filesystem storage is billed to you)
|
|
67
69
|
vcs status|commit|log|show|diff|branch|switch|checkout|merge|restore
|
|
68
70
|
version control over it
|
|
69
71
|
kv ls [prefix] keys in your personal key/value store
|
|
70
72
|
|
|
71
73
|
Hosting
|
|
72
|
-
deploy deploy a built client to
|
|
74
|
+
deploy deploy a built client to the test env (--prod: production)
|
|
73
75
|
promote promote an app's test hosting → production
|
|
74
76
|
hosting status|rollback|rm-release|unpublish
|
|
75
77
|
domains ls|add|rm manage custom domains
|
|
@@ -77,6 +79,7 @@ Hosting
|
|
|
77
79
|
Tools
|
|
78
80
|
logs <appId> inspect an app's server-log Space
|
|
79
81
|
eject <agentApp.ts> preview an agent's compiled prompt + tools
|
|
82
|
+
mcp run as an MCP server for Claude (stdio)
|
|
80
83
|
|
|
81
84
|
Global options
|
|
82
85
|
--base <env|url> prod (default) | staging | local | a literal URL
|
|
@@ -99,6 +102,7 @@ export async function run(argv) {
|
|
|
99
102
|
const wantsHelp = argv.includes("--help") || argv.includes("-h");
|
|
100
103
|
const args = parseArgs(argv.map((a) => (a === "-h" ? "--help" : a === "-v" ? "--version" : a)));
|
|
101
104
|
const name = args._[0];
|
|
105
|
+
if (args.json) setJsonMode(true);
|
|
102
106
|
|
|
103
107
|
if (wantsVersion) return info(await version());
|
|
104
108
|
if (!name || name === "help") return info(...TOP_HELP.split("\n"));
|
package/src/lib/auth.js
CHANGED
|
@@ -46,7 +46,7 @@ export async function loadClient() {
|
|
|
46
46
|
}
|
|
47
47
|
|
|
48
48
|
/**
|
|
49
|
-
* Run a zero-knowledge login and return `{ token, commitment, username }`.
|
|
49
|
+
* Run a zero-knowledge login and return `{ token, commitment, username, seed }`.
|
|
50
50
|
* Throws (via `die`) on failure.
|
|
51
51
|
*/
|
|
52
52
|
export async function zkLogin({ baseUrl, username, password }) {
|
|
@@ -58,5 +58,10 @@ export async function zkLogin({ baseUrl, username, password }) {
|
|
|
58
58
|
const user = await client.auth.zk.login(username, password);
|
|
59
59
|
const token = client.auth.zk.token;
|
|
60
60
|
if (!token) die("Login succeeded but no session token was issued.");
|
|
61
|
-
return {
|
|
61
|
+
return {
|
|
62
|
+
token,
|
|
63
|
+
commitment: user?.commitment,
|
|
64
|
+
username: user?.username ?? username,
|
|
65
|
+
seed: client.auth.zk.seedBase64 ?? null,
|
|
66
|
+
};
|
|
62
67
|
}
|
package/src/lib/bases.js
CHANGED
|
@@ -15,6 +15,14 @@ export function resolveBaseUrl(value) {
|
|
|
15
15
|
return BASES[value] || value;
|
|
16
16
|
}
|
|
17
17
|
|
|
18
|
+
/** A plain name for an API base: "production", "staging", "local", or "custom". */
|
|
19
|
+
export function platformFor(baseUrl) {
|
|
20
|
+
if (baseUrl === BASES.prod) return "production";
|
|
21
|
+
if (baseUrl === BASES.staging) return "staging";
|
|
22
|
+
if (/^https?:\/\/(localhost|127\.0\.0\.1)(:|\/|$)/.test(baseUrl)) return "local";
|
|
23
|
+
return "custom";
|
|
24
|
+
}
|
|
25
|
+
|
|
18
26
|
/** The public hosting host suffix for an API base (apps.* / apps.staging.*). */
|
|
19
27
|
export function appsSuffixFor(baseUrl) {
|
|
20
28
|
return baseUrl.includes("staging") ? "apps.staging.muhkoo.dev" : "apps.muhkoo.dev";
|
package/src/lib/mount.js
CHANGED
|
@@ -323,6 +323,9 @@ const REFUSED_DIRS = new Set([
|
|
|
323
323
|
".husky", ".claude", ".cursor", ".zed", ".fleet",
|
|
324
324
|
]);
|
|
325
325
|
const REFUSED_FILES = new Set([
|
|
326
|
+
// `.muhkoo-app.json` is what `muhkoo provision` writes: the app id and its
|
|
327
|
+
// secret keys. `muhkoo deploy` imports the folder holding it.
|
|
328
|
+
".muhkoo-app.json",
|
|
326
329
|
".envrc", ".npmrc", ".netrc", ".gitconfig", ".pam_environment", ".xprofile",
|
|
327
330
|
".profile", ".bashrc", ".bash_profile", ".bash_login", ".bash_logout",
|
|
328
331
|
".zshrc", ".zshenv", ".zprofile", ".zlogin", ".zlogout", ".kshrc",
|
package/src/lib/ui.js
CHANGED
|
@@ -62,21 +62,39 @@ export const c = {
|
|
|
62
62
|
// Each argument is one line: a newline INSIDE an argument is escaped like
|
|
63
63
|
// any other control character, so a message that runs to several lines
|
|
64
64
|
// passes them as separate arguments.
|
|
65
|
+
//
|
|
66
|
+
// Under `--json` (see setJsonMode) stdout belongs to the one result object a
|
|
67
|
+
// program reads, so these progress lines go to stderr instead.
|
|
68
|
+
let jsonMode = false;
|
|
69
|
+
|
|
70
|
+
/** Turn JSON mode on for this process: progress → stderr, `die()` → `{"error"}` on stdout. */
|
|
71
|
+
export function setJsonMode(on) {
|
|
72
|
+
jsonMode = Boolean(on);
|
|
73
|
+
}
|
|
74
|
+
export function isJsonMode() {
|
|
75
|
+
return jsonMode;
|
|
76
|
+
}
|
|
77
|
+
const say = (text) => (jsonMode ? console.error(text) : console.log(text));
|
|
78
|
+
|
|
65
79
|
export function info(...all) {
|
|
66
|
-
|
|
80
|
+
say(lines(all));
|
|
67
81
|
}
|
|
68
82
|
export function ok(first, ...more) {
|
|
69
|
-
|
|
83
|
+
say(lines([`${c.green("✓")} ${first}`, ...more]));
|
|
70
84
|
}
|
|
71
85
|
export function warn(first, ...more) {
|
|
72
|
-
|
|
86
|
+
say(lines([`${c.yellow("⚠")} ${first}`, ...more]));
|
|
73
87
|
}
|
|
74
88
|
export function step(first, ...more) {
|
|
75
|
-
|
|
89
|
+
say(lines([`${c.dim("→")} ${first}`, ...more]));
|
|
76
90
|
}
|
|
77
91
|
|
|
78
|
-
/** Print an error and exit non-zero. */
|
|
92
|
+
/** Print an error and exit non-zero. Under `--json`, as `{"error": "…"}` on stdout. */
|
|
79
93
|
export function die(first, ...more) {
|
|
94
|
+
if (jsonMode) {
|
|
95
|
+
json({ error: [first, ...more].map((l) => printable(l).replace(MARKS, "")).join("\n") });
|
|
96
|
+
process.exit(1);
|
|
97
|
+
}
|
|
80
98
|
console.error(lines(["", `${c.red("✗")} ${first}`, ...more, ""]));
|
|
81
99
|
process.exit(1);
|
|
82
100
|
}
|
|
@@ -132,8 +150,14 @@ export function table(headers, rows) {
|
|
|
132
150
|
for (const r of body) console.log(out(line(r)));
|
|
133
151
|
}
|
|
134
152
|
|
|
153
|
+
// Set by the MCP server's runner, where there is no one at stdin to answer:
|
|
154
|
+
// fail at once rather than wait for the tool's timeout.
|
|
155
|
+
const NOT_INTERACTIVE = "not signed in on this machine — use the login tool (or run `muhkoo login` in a terminal)";
|
|
156
|
+
const interactive = () => process.env.MUHKOO_NONINTERACTIVE !== "1";
|
|
157
|
+
|
|
135
158
|
/** Prompt for a line of input on stdin. */
|
|
136
159
|
export async function prompt(question) {
|
|
160
|
+
if (!interactive()) throw new Error(NOT_INTERACTIVE);
|
|
137
161
|
const rl = (await import("node:readline/promises")).createInterface({
|
|
138
162
|
input: process.stdin,
|
|
139
163
|
output: process.stdout,
|
|
@@ -150,6 +174,7 @@ export async function prompt(question) {
|
|
|
150
174
|
* non-TTY (piped) it just reads a line.
|
|
151
175
|
*/
|
|
152
176
|
export function promptHidden(question) {
|
|
177
|
+
if (!interactive()) return Promise.reject(new Error(NOT_INTERACTIVE));
|
|
153
178
|
const stdin = process.stdin;
|
|
154
179
|
const stdout = process.stdout;
|
|
155
180
|
if (!stdin.isTTY) return prompt(question);
|
package/src/lib/vfs.js
CHANGED
|
@@ -31,6 +31,7 @@ import { die, info, step, prompt, promptHidden } from "./ui.js";
|
|
|
31
31
|
*/
|
|
32
32
|
export async function openClient(args) {
|
|
33
33
|
const { cfg, baseUrl, client } = await restoreSession(args);
|
|
34
|
+
requireFilesystemSdk(client);
|
|
34
35
|
|
|
35
36
|
await unlock({ args, cfg, baseUrl, client });
|
|
36
37
|
|
|
@@ -47,6 +48,18 @@ export async function openClient(args) {
|
|
|
47
48
|
return client;
|
|
48
49
|
}
|
|
49
50
|
|
|
51
|
+
/**
|
|
52
|
+
* The VFS commands open a Client with no app key, which only an SDK that bills
|
|
53
|
+
* the filesystem to the signed-in account supports (`@muhkoo/connect`
|
|
54
|
+
* 0.15.0-alpha.15, the release that added `vfs.rehome`). An older SDK would
|
|
55
|
+
* fail on the first write with a confusing "API key required", so stop here.
|
|
56
|
+
*/
|
|
57
|
+
function requireFilesystemSdk(client) {
|
|
58
|
+
if (typeof client?.vfs?.rehome !== "function") {
|
|
59
|
+
die("This CLI needs @muhkoo/connect 0.15.0-alpha.15 or newer — reinstall the CLI.");
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
50
63
|
/**
|
|
51
64
|
* A Client with the session restored and NOTHING unlocked, for commands that
|
|
52
65
|
* only name things (`kv ls`) and never decrypt a value. Unlocking would ask for
|
|
@@ -63,15 +76,11 @@ async function restoreSession(args) {
|
|
|
63
76
|
const token = args.token || process.env.MUHKOO_DEV_TOKEN || cfg.token;
|
|
64
77
|
if (!token) die("Not signed in. Run `muhkoo login` first.");
|
|
65
78
|
|
|
66
|
-
//
|
|
67
|
-
//
|
|
68
|
-
// Reads do not, which is why ls and cat work with no app signed in at all.
|
|
69
|
-
const apiKey = resolveAppKey(args, cfg);
|
|
70
|
-
|
|
79
|
+
// No app key: the filesystem is the signed-in user's own, and its storage is
|
|
80
|
+
// billed to their account. The session below is all a read or a write needs.
|
|
71
81
|
const Client = await loadClient();
|
|
72
82
|
const client = new Client({
|
|
73
83
|
baseUrl,
|
|
74
|
-
apiKey,
|
|
75
84
|
// Hand the SDK the session we already hold instead of logging in again.
|
|
76
85
|
sessionStore: {
|
|
77
86
|
load: () => ({ token, username: cfg.username ?? "", commitment: cfg.commitment ?? "" }),
|
|
@@ -160,13 +169,41 @@ async function pairThisMachine({ args, cfg, baseUrl, client }) {
|
|
|
160
169
|
return;
|
|
161
170
|
}
|
|
162
171
|
|
|
172
|
+
const { factorId, label } = await pairWithSeed({ cfg, baseUrl, username, seed, client: authed });
|
|
173
|
+
client.auth.zk.unlockWithSeed(seed);
|
|
174
|
+
info(`Paired this machine as "${label}". Revoke it any time: muhkoo devices rm ${factorId}`);
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/**
|
|
178
|
+
* Pair this machine from a seed already in hand (the browser login hands one
|
|
179
|
+
* over): enrol a device factor and save its key, so no later command asks for a
|
|
180
|
+
* password. Needs only the session and the seed — `enrollDevice` wraps the seed
|
|
181
|
+
* under a fresh local key and puts it in the vault, with no ZK proof.
|
|
182
|
+
*
|
|
183
|
+
* `client` is for a caller that already holds a signed-in Client; otherwise one
|
|
184
|
+
* is built over the stored session.
|
|
185
|
+
*/
|
|
186
|
+
export async function pairWithSeed({ cfg, baseUrl, token, username, commitment, seed, client }) {
|
|
187
|
+
if (!client) {
|
|
188
|
+
const Client = await loadClient();
|
|
189
|
+
client = new Client({
|
|
190
|
+
baseUrl,
|
|
191
|
+
sessionStore: {
|
|
192
|
+
load: () => ({ token, username: username ?? "", commitment: commitment ?? "" }),
|
|
193
|
+
save: () => {},
|
|
194
|
+
clear: () => {},
|
|
195
|
+
},
|
|
196
|
+
});
|
|
197
|
+
const user = await client.auth.zk.restore();
|
|
198
|
+
if (!user) throw new Error("Your session has expired. Run `muhkoo login` and try again.");
|
|
199
|
+
client.auth.zk.unlockWithSeed(seed);
|
|
200
|
+
}
|
|
163
201
|
const label = deviceLabel();
|
|
164
|
-
const { factorId, deviceKey } = await
|
|
202
|
+
const { factorId, deviceKey } = await client.auth.zk.enrollDevice(label);
|
|
165
203
|
// `seed: undefined` clears a seed left by an older CLI — the whole point is
|
|
166
204
|
// that it stops living on this disk.
|
|
167
205
|
await saveConfig({ ...cfg, username, deviceFactorId: factorId, deviceKey, seed: undefined });
|
|
168
|
-
|
|
169
|
-
info(`Paired this machine as "${label}". Revoke it any time: muhkoo devices rm ${factorId}`);
|
|
206
|
+
return { factorId, label };
|
|
170
207
|
}
|
|
171
208
|
|
|
172
209
|
/**
|
|
@@ -183,38 +220,3 @@ function pairs(args) {
|
|
|
183
220
|
function deviceLabel() {
|
|
184
221
|
return `${userInfo().username}@${hostname()}`;
|
|
185
222
|
}
|
|
186
|
-
|
|
187
|
-
/**
|
|
188
|
-
* The key to write as, from `--key`, the environment, or the app signed in with
|
|
189
|
-
* `muhkoo vfs use-app`.
|
|
190
|
-
*
|
|
191
|
-
* Absent is a legitimate state, not an error: reads work without one, so this
|
|
192
|
-
* returns undefined and lets the write itself fail with an explanation.
|
|
193
|
-
*/
|
|
194
|
-
function resolveAppKey(args, cfg) {
|
|
195
|
-
if (args.key) return args.key;
|
|
196
|
-
if (process.env.MUHKOO_APP_KEY) return process.env.MUHKOO_APP_KEY;
|
|
197
|
-
const slug = args.app || cfg.vfsApp;
|
|
198
|
-
if (!slug) return undefined;
|
|
199
|
-
return (cfg.vfsApps ?? {})[slug];
|
|
200
|
-
}
|
|
201
|
-
|
|
202
|
-
/**
|
|
203
|
-
* Turn the shard store's 401 into an instruction: the lines to print, or null
|
|
204
|
-
* when `err` is some other failure.
|
|
205
|
-
*
|
|
206
|
-
* "API key required to store shards" is accurate and useless — it names a
|
|
207
|
-
* concept the person at the terminal has no reason to know, and says nothing
|
|
208
|
-
* about what to do next.
|
|
209
|
-
*/
|
|
210
|
-
export function explainWriteFailure(err, cfg) {
|
|
211
|
-
const msg = err?.message ?? String(err);
|
|
212
|
-
if (!/API key required|store shards|401/.test(msg)) return null;
|
|
213
|
-
const known = Object.keys(cfg?.vfsApps ?? {});
|
|
214
|
-
return [
|
|
215
|
-
"Writing stores bytes, which are metered to an app — so a write needs one signed in.",
|
|
216
|
-
...(known.length
|
|
217
|
-
? [`Try: muhkoo vfs use-app ${known[0]}`]
|
|
218
|
-
: ["Sign one in with: muhkoo vfs use-app <slug> --key <appKey>", "App keys are shown when an app is created (muhkoo apps create)."]),
|
|
219
|
-
];
|
|
220
|
-
}
|