@ritualai/cli 0.8.1 → 0.8.2
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/index.js +38 -9
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/skills/claude-code/ritual/.ritual-bundle.json +2 -2
- package/skills/codex/ritual/.ritual-bundle.json +2 -2
- package/skills/cursor/ritual/.ritual-bundle.json +2 -2
- package/skills/gemini/ritual/.ritual-bundle.json +2 -2
- package/skills/kiro/ritual/.ritual-bundle.json +2 -2
- package/skills/vscode/ritual/.ritual-bundle.json +2 -2
package/dist/index.js
CHANGED
|
@@ -32,33 +32,62 @@ program
|
|
|
32
32
|
.description('Ritual CLI — connect AI coding agents to Ritual Cloud. ' +
|
|
33
33
|
'Scaffold skills, register MCP servers, manage sessions.')
|
|
34
34
|
.version((0, package_info_1.readPackageVersionSafe)());
|
|
35
|
+
/**
|
|
36
|
+
* Maintainer-only flags only register when RITUAL_INTERNAL=1 is set in
|
|
37
|
+
* the environment. The public npm install never sets it, so end users:
|
|
38
|
+
*
|
|
39
|
+
* - Don't see internal flags in `ritual <cmd> --help`
|
|
40
|
+
* - Get `error: unknown option '--<flag>'` if they discover them another way
|
|
41
|
+
*
|
|
42
|
+
* Why this exists: pre-0.8.2, internal flags carried an `[internal]` text
|
|
43
|
+
* marker in their description but were still discoverable in --help. The
|
|
44
|
+
* marker was advisory; this is enforcement. Caught by the user 2026-05-21
|
|
45
|
+
* after the v0.8.0 release notes inadvertently advertised `--re-onboard`
|
|
46
|
+
* (a demo-iteration helper) as if it were a public feature. Same fix
|
|
47
|
+
* shape covers `--dev` (which had the marker but was still in --help).
|
|
48
|
+
*
|
|
49
|
+
* Maintainer use: `RITUAL_INTERNAL=1 ritual init --re-onboard --dev`.
|
|
50
|
+
* The demo-loop helper `scripts/dev/start-ritual-mock-mcp.sh` exports
|
|
51
|
+
* RITUAL_INTERNAL=1 so maintainers running the local mock-mode loop
|
|
52
|
+
* don't have to remember the env var. Same for `apps/cli/CONTRIBUTING.md`
|
|
53
|
+
* dev-iteration setup.
|
|
54
|
+
*/
|
|
55
|
+
const IS_INTERNAL_BUILD = process.env.RITUAL_INTERNAL === '1';
|
|
56
|
+
function internalOption(cmd, flag, desc) {
|
|
57
|
+
if (IS_INTERNAL_BUILD) {
|
|
58
|
+
return cmd.option(flag, desc);
|
|
59
|
+
}
|
|
60
|
+
return cmd;
|
|
61
|
+
}
|
|
35
62
|
// `init` is the headline command: scaffold + register against every
|
|
36
63
|
// detected agent. Listed first so `ritual --help` surfaces it.
|
|
37
|
-
program
|
|
64
|
+
const initCmd = program
|
|
38
65
|
.command('init')
|
|
39
66
|
.description('Scaffold Ritual skills + register MCP server with every detected AI coding agent')
|
|
40
67
|
.option('--agent <id>', 'Restrict to one agent (e.g. claude-code, cursor, kiro)')
|
|
41
68
|
.option('--list', 'List known agents and exit')
|
|
42
69
|
.option('--issuer <url>', 'OIDC issuer for the lazy-auth flow (defaults to prod or RITUAL_KEYCLOAK_URL env)')
|
|
43
70
|
.option('--client-id <id>', 'OIDC client id (defaults to "ritual-cli")')
|
|
44
|
-
.option('--dev', '[internal] shortcut for --issuer https://auth.dev.ritualapp.cloud/realms/ritual')
|
|
45
71
|
.option('--no-workspace', 'Skip the "create a workspace for this repo?" prompt. Useful for CI or when you want to bind a workspace by hand later.')
|
|
46
72
|
.option('--switch-account', 'Force a fresh sign-in even if you already have valid local credentials. Uses OIDC prompt=login so Keycloak ignores its SSO cookie. Atomic — your previous session is restored if anything fails.')
|
|
47
73
|
.option('--yes', 'Skip interactive confirmation prompts (required for --switch-account in non-TTY mode).')
|
|
48
74
|
.option('--skills-only', 'Refresh ONLY the bundled skill files in this project; skip auth, PAT minting, workspace binding, and MCP registration. Use after `npm i -g @ritualai/cli@latest` to pull the newest SKILL bundle into an already-initialized repo.')
|
|
49
75
|
.option('--persona <slug>', 'Persona for /ritual build defaults (e.g. backend-services, frontend-web). Skips the interactive picker in the onboarding flow.')
|
|
50
|
-
.option('--
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
76
|
+
.option('-v, --verbose', 'Verbose post-setup output: PAT details, per-agent status table, skill install paths, and the detailed verify-then-restart next-steps block. Default is a compact "Ready to ship" CTA box.');
|
|
77
|
+
// Maintainer-only — registered only when RITUAL_INTERNAL=1.
|
|
78
|
+
internalOption(initCmd, '--dev', 'Shortcut for --issuer https://auth.dev.ritualapp.cloud/realms/ritual (maintainer testing against the Ritual dev environment).');
|
|
79
|
+
internalOption(initCmd, '--re-onboard', 'Re-run the FTUE onboarding screens (persona picker + workspace + build-flow explainer) even if they\'ve been shown on this machine. Used by maintainers iterating on screen designs.');
|
|
80
|
+
initCmd.action(init_1.initCommand);
|
|
81
|
+
const loginCmd = program
|
|
54
82
|
.command('login')
|
|
55
83
|
.description('Authenticate with Ritual via your browser')
|
|
56
84
|
.option('--issuer <url>', 'OIDC issuer (defaults to https://auth.ritualapp.cloud/realms/ritual or RITUAL_KEYCLOAK_URL env)')
|
|
57
85
|
.option('--client-id <id>', 'OIDC client id (defaults to "ritual-cli" or RITUAL_KEYCLOAK_CLIENT_ID env)')
|
|
58
|
-
.option('--dev', '[internal] shortcut for --issuer https://auth.dev.ritualapp.cloud/realms/ritual')
|
|
59
86
|
.option('--switch-account', 'Force a fresh sign-in even if you already have valid local credentials. Uses OIDC prompt=login so Keycloak ignores its SSO cookie.')
|
|
60
|
-
.option('--yes', 'Skip interactive confirmation prompts (required for --switch-account in non-TTY mode).')
|
|
61
|
-
|
|
87
|
+
.option('--yes', 'Skip interactive confirmation prompts (required for --switch-account in non-TTY mode).');
|
|
88
|
+
// Maintainer-only — registered only when RITUAL_INTERNAL=1.
|
|
89
|
+
internalOption(loginCmd, '--dev', 'Shortcut for --issuer https://auth.dev.ritualapp.cloud/realms/ritual (maintainer testing against the Ritual dev environment).');
|
|
90
|
+
loginCmd.action(login_1.loginCommand);
|
|
62
91
|
program
|
|
63
92
|
.command('logout')
|
|
64
93
|
.description('Clear local credentials. With --all, also end the Keycloak browser SSO session.')
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,4CAAgD;AAChD,8CAAkD;AAClD,8CAAkD;AAClD,gDAAoD;AACpD,0CAA8C;AAC9C,8CAAkD;AAClD,oEAAoE;AACpE,kEAAkE;AAClE,kEAAkE;AAClE,oEAAoE;AACpE,iEAAiE;AACjE,iEAAiE;AACjE,6BAA6B;AAC7B,8CAAkD;AAClD,4CAAsD;AACtD,qDAA4D;AAC5D,kEAAkE;AAClE,oEAAoE;AACpE,+DAA+D;AAC/D,iEAAiE;AACjE,oEAAoE;AACpE,oEAAoE;AACpE,oCAAoC;AACpC,qEAAqE;AAErE,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACL,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CACX,yDAAyD;IACxD,yDAAyD,CAC1D;KACA,OAAO,CAAC,IAAA,qCAAsB,GAAE,CAAC,CAAC;AAEpC,oEAAoE;AACpE,+DAA+D;AAC/D,OAAO;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ritualai/cli",
|
|
3
|
-
"version": "0.8.
|
|
3
|
+
"version": "0.8.2",
|
|
4
4
|
"description": "Ritual CLI — scaffold AI coding agent skills + register MCP servers. Connects Claude Code, Cursor, Windsurf, Kiro, Gemini CLI, VS Code/Copilot, and Codex to Ritual Cloud.",
|
|
5
5
|
"private": false,
|
|
6
6
|
"license": "Apache-2.0",
|