@floh-solutions/pharos-cli 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +27 -3
- package/dist/cli.js.map +1 -1
- package/dist/commands/setup.d.ts +14 -0
- package/dist/commands/setup.d.ts.map +1 -0
- package/dist/commands/setup.js +291 -0
- package/dist/commands/setup.js.map +1 -0
- package/package.json +11 -11
package/dist/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAQ1D,OAAO,EAKL,KAAK,QAAQ,EAEd,MAAM,aAAa,CAAC;AAuGrB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAChD,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAOhE"}
|
package/dist/cli.js
CHANGED
|
@@ -4,6 +4,7 @@ import { parseArgs } from "node:util";
|
|
|
4
4
|
import { run as runPlanToBoard } from "@floh-solutions/plan-to-board";
|
|
5
5
|
import { DEFAULT_WRITE_BUDGET, WriteBudget } from "./budget.js";
|
|
6
6
|
import { runComment } from "./commands/comment.js";
|
|
7
|
+
import { runSetup } from "./commands/setup.js";
|
|
7
8
|
import { runTask } from "./commands/task.js";
|
|
8
9
|
import { runWiki } from "./commands/wiki.js";
|
|
9
10
|
import { EXIT_OK, emitText, reportError, usageError, } from "./output.js";
|
|
@@ -37,6 +38,17 @@ const USAGE = `pharos — Azure DevOps from a headless shell, for an agent.
|
|
|
37
38
|
|
|
38
39
|
pharos <command> [options]
|
|
39
40
|
|
|
41
|
+
START HERE
|
|
42
|
+
|
|
43
|
+
setup Ask for your organisation, project and token,
|
|
44
|
+
put the token in your OS keychain (never a
|
|
45
|
+
file), write the right shell profile, then
|
|
46
|
+
PROVE it by reading the board and the wiki —
|
|
47
|
+
the two are separate permissions and a missing
|
|
48
|
+
wiki scope otherwise fails days later.
|
|
49
|
+
--print show the shell block and change nothing
|
|
50
|
+
--stdin read the token from a pipe, for scripted setup
|
|
51
|
+
|
|
40
52
|
COMMANDS
|
|
41
53
|
|
|
42
54
|
task <id> Everything about one work item in a single call:
|
|
@@ -115,12 +127,24 @@ async function dispatch(io, options) {
|
|
|
115
127
|
"no-wiki-comments": { type: "boolean" },
|
|
116
128
|
"no-related-titles": { type: "boolean" },
|
|
117
129
|
}
|
|
118
|
-
:
|
|
130
|
+
: command === "setup"
|
|
131
|
+
? { print: { type: "boolean" }, stdin: { type: "boolean" } }
|
|
132
|
+
: CONTENT_OPTIONS;
|
|
119
133
|
const { values, positionals } = parse(options.argv, { ...GLOBAL_OPTIONS, ...extras });
|
|
120
134
|
if (values["version"] === true)
|
|
121
135
|
return emitText(io, await version(options.cwd));
|
|
122
136
|
if (values["help"] === true || command === undefined)
|
|
123
137
|
return emitText(io, USAGE);
|
|
138
|
+
// Before the Session: setup is what you run when there is no configuration
|
|
139
|
+
// yet, so it must not be behind the thing that requires configuration.
|
|
140
|
+
if (command === "setup") {
|
|
141
|
+
return runSetup(io, options.env, {
|
|
142
|
+
org: asString(values["org"]),
|
|
143
|
+
project: asString(values["project"]),
|
|
144
|
+
print: values["print"] === true,
|
|
145
|
+
stdin: values["stdin"] === true,
|
|
146
|
+
}, options.readStdin ?? readAllStdin, options.client);
|
|
147
|
+
}
|
|
124
148
|
const session = new Session({
|
|
125
149
|
env: options.env,
|
|
126
150
|
organization: asString(values["org"]),
|
|
@@ -151,8 +175,8 @@ async function dispatch(io, options) {
|
|
|
151
175
|
text: await content(options, values),
|
|
152
176
|
});
|
|
153
177
|
default:
|
|
154
|
-
throw usageError(`Unknown command "${command}". Try task, wiki, comment or plan.`, {
|
|
155
|
-
commands: ["task", "wiki", "comment", "plan"],
|
|
178
|
+
throw usageError(`Unknown command "${command}". Try setup, task, wiki, comment or plan.`, {
|
|
179
|
+
commands: ["setup", "task", "wiki", "comment", "plan"],
|
|
156
180
|
});
|
|
157
181
|
}
|
|
158
182
|
}
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAwB,MAAM,WAAW,CAAC;AAG5D,OAAO,EAAE,GAAG,IAAI,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,UAAU,GAGX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIvC;;;;;;GAMG;AACH,MAAM,cAAc,GAAkB;IACpC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IACzB,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACpC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC9B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACvB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAC7B,CAAC;AAEF,gEAAgE;AAChE,MAAM,eAAe,GAAkB;IACrC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;CAC3B,CAAC;AAEF,MAAM,KAAK,GAAG
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { AdoClient } from "@floh-solutions/ado-core";
|
|
2
|
+
import { type ExitCode, type Io } from "../output.js";
|
|
3
|
+
export interface SetupOptions {
|
|
4
|
+
org?: string | undefined;
|
|
5
|
+
project?: string | undefined;
|
|
6
|
+
/** Print the shell block and change nothing. For people who manage dotfiles themselves. */
|
|
7
|
+
print: boolean;
|
|
8
|
+
/** Read the token from stdin instead of prompting — for scripted setup. */
|
|
9
|
+
stdin: boolean;
|
|
10
|
+
}
|
|
11
|
+
export declare function runSetup(io: Io, env: NodeJS.ProcessEnv, options: SetupOptions, readStdin: () => Promise<string>,
|
|
12
|
+
/** Injected so the verification can be driven against a mock transport. */
|
|
13
|
+
verifyWith?: AdoClient): Promise<ExitCode>;
|
|
14
|
+
//# sourceMappingURL=setup.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,SAAS,EAAW,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAA8B,KAAK,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,cAAc,CAAC;AA4ClF,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2FAA2F;IAC3F,KAAK,EAAE,OAAO,CAAC;IACf,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,EAAE,EACN,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC;AAChC,2EAA2E;AAC3E,UAAU,CAAC,EAAE,SAAS,GACrB,OAAO,CAAC,QAAQ,CAAC,CAmDnB"}
|
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
import { spawn } from "node:child_process";
|
|
2
|
+
import { chmod, mkdir, readFile, writeFile } from "node:fs/promises";
|
|
3
|
+
import { homedir, platform } from "node:os";
|
|
4
|
+
import { dirname, join } from "node:path";
|
|
5
|
+
import { createInterface } from "node:readline";
|
|
6
|
+
import { Writable } from "node:stream";
|
|
7
|
+
import { AdoClient, WikiApi } from "@floh-solutions/ado-core";
|
|
8
|
+
import { emit, emitText, usageError } from "../output.js";
|
|
9
|
+
/**
|
|
10
|
+
* `pharos setup` — get somebody from "installed" to "working" in one command.
|
|
11
|
+
*
|
|
12
|
+
* ## Why this exists at all, when the tool reads three environment variables
|
|
13
|
+
*
|
|
14
|
+
* Because "set three environment variables" is where people actually fail, and
|
|
15
|
+
* they fail *silently and late*. The three ways it goes wrong, all seen:
|
|
16
|
+
*
|
|
17
|
+
* 1. **The token ends up in a file.** Told to `export ADO_PAT=…`, the obvious
|
|
18
|
+
* move is to paste it into a dotfile, where it lives in plaintext,
|
|
19
|
+
* backs itself up, and gets committed by somebody eventually.
|
|
20
|
+
* 2. **The wrong dotfile.** zsh reads `.zshrc` only for INTERACTIVE shells,
|
|
21
|
+
* so the variables work when you type in Terminal and are invisible to
|
|
22
|
+
* anything scripted — a hook, CI, an agent shelling out. The failure is a
|
|
23
|
+
* config error that reads as a broken tool.
|
|
24
|
+
* 3. **A scope is missing.** Work Items and Wiki are separate Azure DevOps
|
|
25
|
+
* permissions. A token with only the first works perfectly until the first
|
|
26
|
+
* wiki write, days later, and then fails with a 401 that looks like a bad
|
|
27
|
+
* token rather than a narrow one.
|
|
28
|
+
*
|
|
29
|
+
* This does all three correctly, then **proves it** by making real calls.
|
|
30
|
+
*
|
|
31
|
+
* ## The boundary this does NOT cross
|
|
32
|
+
*
|
|
33
|
+
* The tool's RUNTIME still reads `ADO_PAT` from the environment and nothing
|
|
34
|
+
* else — no keychain, no config file, no credential helper. That is what keeps
|
|
35
|
+
* the same binary working in CI and under an unattended agent, and it is not
|
|
36
|
+
* negotiable.
|
|
37
|
+
*
|
|
38
|
+
* This command is a **bootstrapper**, not a credential path: run once,
|
|
39
|
+
* explicitly, interactively. It puts the token in the OS keychain and writes a
|
|
40
|
+
* shell snippet that reads it back out. So the *shell* resolves the secret and
|
|
41
|
+
* the *tool* still just inherits an environment variable — which is why running
|
|
42
|
+
* `pharos` under CI with `ADO_PAT` set works identically and never calls any of
|
|
43
|
+
* this.
|
|
44
|
+
*/
|
|
45
|
+
const BEGIN = "# >>> pharos cli >>>";
|
|
46
|
+
const END = "# <<< pharos cli <<<";
|
|
47
|
+
/** Keychain service name. Deliberately not the Pharos app's — separate tools, separate secrets. */
|
|
48
|
+
const KEYCHAIN_SERVICE = "pharos-cli-ado-pat";
|
|
49
|
+
export async function runSetup(io, env, options, readStdin,
|
|
50
|
+
/** Injected so the verification can be driven against a mock transport. */
|
|
51
|
+
verifyWith) {
|
|
52
|
+
const interactive = process.stdin.isTTY === true && !options.stdin;
|
|
53
|
+
const org = options.org ?? env["ADO_ORG"] ?? (interactive ? await ask(ORG_PROMPT) : "");
|
|
54
|
+
if (org === "")
|
|
55
|
+
throw usageError("No organisation. Pass --org, or run this in a terminal.");
|
|
56
|
+
const project = options.project ?? env["ADO_PROJECT"] ?? (interactive ? await ask(PROJECT_PROMPT) : "");
|
|
57
|
+
if (project === "")
|
|
58
|
+
throw usageError("No project. Pass --project, or run this in a terminal.");
|
|
59
|
+
const target = profileTarget(env);
|
|
60
|
+
if (options.print) {
|
|
61
|
+
return emitText(io, shellBlock(org, project, target.secret));
|
|
62
|
+
}
|
|
63
|
+
const token = options.stdin
|
|
64
|
+
? (await readStdin()).trim()
|
|
65
|
+
: interactive
|
|
66
|
+
? await askSecret(TOKEN_PROMPT)
|
|
67
|
+
: "";
|
|
68
|
+
if (token === "") {
|
|
69
|
+
throw usageError("No token. Run this in a terminal to be prompted, or pipe it in with --stdin.");
|
|
70
|
+
}
|
|
71
|
+
// Store the secret BEFORE touching the profile: a profile that references a
|
|
72
|
+
// secret which is not there yet is worse than no profile change at all.
|
|
73
|
+
await storeSecret(token, target.secret);
|
|
74
|
+
const wrote = await updateProfile(target.profile, shellBlock(org, project, target.secret));
|
|
75
|
+
// Prove it, rather than declaring success and letting them find out later.
|
|
76
|
+
const checks = await verify(org, project, token, verifyWith);
|
|
77
|
+
return emit(io, {
|
|
78
|
+
applied: true,
|
|
79
|
+
organization: org,
|
|
80
|
+
project,
|
|
81
|
+
tokenStoredIn: describeSecret(target.secret),
|
|
82
|
+
profile: target.profile,
|
|
83
|
+
profileAction: wrote,
|
|
84
|
+
checks,
|
|
85
|
+
// The variables are exported by a file that this shell already read, so
|
|
86
|
+
// they are not in it. Saying so beats somebody concluding it failed.
|
|
87
|
+
hint: checks.workItems.ok && checks.wiki.ok
|
|
88
|
+
? `Open a new terminal, then run: pharos task <id>`
|
|
89
|
+
: "Setup wrote everything, but a scope check failed — see `checks`. Fix the token's "
|
|
90
|
+
+ "scopes in Azure DevOps and run `pharos setup` again.",
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* Which file to write, and where the token lives.
|
|
95
|
+
*
|
|
96
|
+
* **zsh gets `.zshenv`, not `.zshrc`, and that is the single most important
|
|
97
|
+
* decision here.** `.zshrc` is read only by interactive shells, so a setup that
|
|
98
|
+
* lands there works in Terminal and is invisible to every scripted or agent-run
|
|
99
|
+
* invocation — which is the exact case this tool exists to serve.
|
|
100
|
+
*
|
|
101
|
+
* bash has no true equivalent. `.bashrc` is skipped by non-interactive shells
|
|
102
|
+
* too, but it is the least-bad option and the summary says so rather than
|
|
103
|
+
* implying a guarantee that is not there.
|
|
104
|
+
*/
|
|
105
|
+
function profileTarget(env) {
|
|
106
|
+
const shell = env["SHELL"] ?? "";
|
|
107
|
+
// `HOME` rather than `homedir()`: on every platform we support they agree,
|
|
108
|
+
// and reading the variable is what lets this be exercised against a scratch
|
|
109
|
+
// directory instead of somebody's actual dotfiles.
|
|
110
|
+
const home = env["HOME"] ?? homedir();
|
|
111
|
+
// `PHAROS_TOKEN_FILE` puts the token in a mode-600 file instead of the OS
|
|
112
|
+
// keychain. Not a test hook — a container, a CI image and a headless Linux
|
|
113
|
+
// box all have no keychain to speak of, and forcing one on macOS is a
|
|
114
|
+
// reasonable preference to hold.
|
|
115
|
+
const override = env["PHAROS_TOKEN_FILE"];
|
|
116
|
+
const secret = override !== undefined && override !== ""
|
|
117
|
+
? { kind: "file", path: override }
|
|
118
|
+
: platform() === "darwin"
|
|
119
|
+
? { kind: "keychain" }
|
|
120
|
+
: { kind: "file", path: join(home, ".config", "pharos", "token") };
|
|
121
|
+
if (shell.endsWith("zsh"))
|
|
122
|
+
return { profile: join(home, ".zshenv"), secret };
|
|
123
|
+
if (shell.endsWith("bash")) {
|
|
124
|
+
return {
|
|
125
|
+
profile: join(home, platform() === "darwin" ? ".bash_profile" : ".bashrc"),
|
|
126
|
+
secret,
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
// Unknown shell: still write something sensible, and `--print` exists for
|
|
130
|
+
// anyone who would rather paste it themselves.
|
|
131
|
+
return { profile: join(home, ".profile"), secret };
|
|
132
|
+
}
|
|
133
|
+
function shellBlock(org, project, secret) {
|
|
134
|
+
const read = secret.kind === "keychain"
|
|
135
|
+
? `"$(security find-generic-password -s ${KEYCHAIN_SERVICE} -w 2>/dev/null)"`
|
|
136
|
+
: `"$(cat ${secret.path} 2>/dev/null)"`;
|
|
137
|
+
return [
|
|
138
|
+
BEGIN,
|
|
139
|
+
"# Written by `pharos setup`. Safe to edit; re-running setup replaces this block.",
|
|
140
|
+
"#",
|
|
141
|
+
"# The token is NOT stored here — it is read out of "
|
|
142
|
+
+ (secret.kind === "keychain" ? "your login keychain." : `${secret.path} (mode 600).`),
|
|
143
|
+
"# pharos itself only ever reads these environment variables, which is what",
|
|
144
|
+
"# lets the same command work in CI and under an unattended agent.",
|
|
145
|
+
`export ADO_ORG=${shellQuote(org)}`,
|
|
146
|
+
`export ADO_PROJECT=${shellQuote(project)}`,
|
|
147
|
+
`export ADO_PAT=${read}`,
|
|
148
|
+
END,
|
|
149
|
+
].join("\n");
|
|
150
|
+
}
|
|
151
|
+
// MARK: - Doing it
|
|
152
|
+
async function storeSecret(token, secret) {
|
|
153
|
+
if (secret.kind === "keychain") {
|
|
154
|
+
// `-U` updates an existing entry rather than failing, so re-running after a
|
|
155
|
+
// token rotation is the same command.
|
|
156
|
+
await run("security", [
|
|
157
|
+
"add-generic-password",
|
|
158
|
+
"-U",
|
|
159
|
+
"-a",
|
|
160
|
+
process.env["USER"] ?? "pharos",
|
|
161
|
+
"-s",
|
|
162
|
+
KEYCHAIN_SERVICE,
|
|
163
|
+
"-w",
|
|
164
|
+
token,
|
|
165
|
+
]);
|
|
166
|
+
return;
|
|
167
|
+
}
|
|
168
|
+
const path = secret.path;
|
|
169
|
+
await mkdir(dirname(path), { recursive: true, mode: 0o700 });
|
|
170
|
+
await writeFile(path, `${token}\n`, { mode: 0o600 });
|
|
171
|
+
// Explicit, because an existing file keeps its old mode through writeFile.
|
|
172
|
+
await chmod(path, 0o600);
|
|
173
|
+
}
|
|
174
|
+
/** Replace the block if it is there, append it if it is not. Never duplicate. */
|
|
175
|
+
async function updateProfile(path, block) {
|
|
176
|
+
let existing = "";
|
|
177
|
+
try {
|
|
178
|
+
existing = await readFile(path, "utf8");
|
|
179
|
+
}
|
|
180
|
+
catch {
|
|
181
|
+
await writeFile(path, `${block}\n`, { mode: 0o600 });
|
|
182
|
+
return "created";
|
|
183
|
+
}
|
|
184
|
+
const start = existing.indexOf(BEGIN);
|
|
185
|
+
const end = existing.indexOf(END);
|
|
186
|
+
if (start !== -1 && end > start) {
|
|
187
|
+
const updated = existing.slice(0, start) + block + existing.slice(end + END.length);
|
|
188
|
+
await writeFile(path, updated, "utf8");
|
|
189
|
+
return "replaced";
|
|
190
|
+
}
|
|
191
|
+
const separator = existing.endsWith("\n") ? "\n" : "\n\n";
|
|
192
|
+
await writeFile(path, `${existing}${separator}${block}\n`, "utf8");
|
|
193
|
+
return "appended";
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* Check the two scopes SEPARATELY, because Azure DevOps grants them separately.
|
|
197
|
+
*
|
|
198
|
+
* A token with Work Items but not Wiki behaves perfectly until the first wiki
|
|
199
|
+
* write — possibly days later — and then fails with a 401 that looks like a bad
|
|
200
|
+
* token rather than a narrow one. Finding that out now costs one request.
|
|
201
|
+
*/
|
|
202
|
+
async function verify(org, project, pat, injected) {
|
|
203
|
+
const client = injected ?? new AdoClient({ organization: org, project, pat });
|
|
204
|
+
const workItems = await client.wiql
|
|
205
|
+
.query("SELECT [System.Id] FROM WorkItems", { top: 1 })
|
|
206
|
+
.then(() => ({ ok: true, detail: "work item read works" }))
|
|
207
|
+
.catch((error) => ({
|
|
208
|
+
ok: false,
|
|
209
|
+
detail: `work items unreadable — check the org, the project, and the token's `
|
|
210
|
+
+ `"Work Items (Read, write, & manage)" scope. ${messageOf(error)}`,
|
|
211
|
+
}));
|
|
212
|
+
const wiki = await new WikiApi(client.http)
|
|
213
|
+
.listWikis()
|
|
214
|
+
.then((wikis) => ({ ok: true, detail: `wiki read works (${wikis.length} found)` }))
|
|
215
|
+
.catch((error) => ({
|
|
216
|
+
ok: false,
|
|
217
|
+
detail: `wiki unreadable — this is a SEPARATE permission from work items; check the `
|
|
218
|
+
+ `token's "Wiki (Read & write)" scope. ${messageOf(error)}`,
|
|
219
|
+
}));
|
|
220
|
+
return { workItems, wiki };
|
|
221
|
+
}
|
|
222
|
+
// MARK: - Prompts
|
|
223
|
+
const ORG_PROMPT = "Azure DevOps organisation\n"
|
|
224
|
+
+ " (from your board's URL: https://dev.azure.com/THIS/project)\n> ";
|
|
225
|
+
const PROJECT_PROMPT = "Project\n (the next part of that URL: https://dev.azure.com/org/THIS)\n> ";
|
|
226
|
+
const TOKEN_PROMPT = "Personal access token\n"
|
|
227
|
+
+ " User settings → Personal access tokens → New Token.\n"
|
|
228
|
+
+ " Scopes, both of them: Work Items (Read, write, & manage) AND Wiki (Read & write).\n"
|
|
229
|
+
+ " It will not be echoed, and it is stored in your keychain rather than a file.\n> ";
|
|
230
|
+
async function ask(question) {
|
|
231
|
+
const rl = createInterface({ input: process.stdin, output: process.stdout });
|
|
232
|
+
try {
|
|
233
|
+
return (await new Promise((resolve) => rl.question(question, resolve))).trim();
|
|
234
|
+
}
|
|
235
|
+
finally {
|
|
236
|
+
rl.close();
|
|
237
|
+
}
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* Prompt without echoing.
|
|
241
|
+
*
|
|
242
|
+
* Readline is given a sink for its output rather than stdout, so the keystrokes
|
|
243
|
+
* it would normally echo go nowhere; the prompt is written directly instead.
|
|
244
|
+
* That avoids overriding readline's private `_writeToOutput`, which is the
|
|
245
|
+
* usual trick for this and breaks whenever Node tidies its internals.
|
|
246
|
+
*/
|
|
247
|
+
async function askSecret(question) {
|
|
248
|
+
process.stdout.write(question);
|
|
249
|
+
const sink = new Writable({
|
|
250
|
+
write(_chunk, _encoding, done) {
|
|
251
|
+
done();
|
|
252
|
+
},
|
|
253
|
+
});
|
|
254
|
+
const rl = createInterface({ input: process.stdin, output: sink, terminal: true });
|
|
255
|
+
try {
|
|
256
|
+
const answer = await new Promise((resolve) => rl.question("", resolve));
|
|
257
|
+
process.stdout.write("\n");
|
|
258
|
+
return answer.trim();
|
|
259
|
+
}
|
|
260
|
+
finally {
|
|
261
|
+
rl.close();
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
// MARK: - Small helpers
|
|
265
|
+
function run(command, args) {
|
|
266
|
+
return new Promise((resolve, reject) => {
|
|
267
|
+
// No shell, and the token is an argv entry rather than part of a command
|
|
268
|
+
// string — nothing to quote, nothing to interpolate, and it never reaches a
|
|
269
|
+
// shell history.
|
|
270
|
+
const child = spawn(command, args, { stdio: "ignore" });
|
|
271
|
+
child.on("error", reject);
|
|
272
|
+
child.on("close", (code) => {
|
|
273
|
+
if (code === 0)
|
|
274
|
+
resolve();
|
|
275
|
+
else
|
|
276
|
+
reject(new Error(`${command} exited ${String(code)}`));
|
|
277
|
+
});
|
|
278
|
+
});
|
|
279
|
+
}
|
|
280
|
+
function describeSecret(secret) {
|
|
281
|
+
return secret.kind === "keychain"
|
|
282
|
+
? `login keychain (service "${KEYCHAIN_SERVICE}")`
|
|
283
|
+
: `${secret.path} (mode 600)`;
|
|
284
|
+
}
|
|
285
|
+
function shellQuote(value) {
|
|
286
|
+
return `'${value.replace(/'/g, `'\\''`)}'`;
|
|
287
|
+
}
|
|
288
|
+
function messageOf(error) {
|
|
289
|
+
return error instanceof Error ? error.message : String(error);
|
|
290
|
+
}
|
|
291
|
+
//# sourceMappingURL=setup.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@floh-solutions/pharos-cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Azure DevOps from a headless shell, for an agent: the whole context of a task in one call, and the wiki/comment verbs Microsoft's MCP server does not ship.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"author": "FLOH Solutions",
|
|
@@ -22,6 +22,15 @@
|
|
|
22
22
|
"engines": {
|
|
23
23
|
"node": ">=22"
|
|
24
24
|
},
|
|
25
|
+
"dependencies": {
|
|
26
|
+
"@floh-solutions/ado-core": "0.1.0",
|
|
27
|
+
"@floh-solutions/plan-to-board": "0.1.1"
|
|
28
|
+
},
|
|
29
|
+
"devDependencies": {
|
|
30
|
+
"@types/node": "^22.10.2",
|
|
31
|
+
"typescript": "^5.7.2",
|
|
32
|
+
"vitest": "^3.0.5"
|
|
33
|
+
},
|
|
25
34
|
"scripts": {
|
|
26
35
|
"build": "tsc -p tsconfig.build.json",
|
|
27
36
|
"typecheck": "tsc -p tsconfig.json --noEmit",
|
|
@@ -29,14 +38,5 @@
|
|
|
29
38
|
"test:watch": "vitest",
|
|
30
39
|
"test:live": "ADO_LIVE=1 vitest run",
|
|
31
40
|
"start": "node dist/bin.js"
|
|
32
|
-
},
|
|
33
|
-
"dependencies": {
|
|
34
|
-
"@floh-solutions/ado-core": "workspace:*",
|
|
35
|
-
"@floh-solutions/plan-to-board": "workspace:*"
|
|
36
|
-
},
|
|
37
|
-
"devDependencies": {
|
|
38
|
-
"@types/node": "^22.10.2",
|
|
39
|
-
"typescript": "^5.7.2",
|
|
40
|
-
"vitest": "^3.0.5"
|
|
41
41
|
}
|
|
42
|
-
}
|
|
42
|
+
}
|