@matizze/prumo-cli 0.5.0 → 0.5.1
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 +1 -0
- package/dist/commands/doctor.js +1 -18
- package/dist/commands/new.d.ts +1 -1
- package/dist/commands/new.js +7 -2
- package/dist/doctor/ranges.d.ts +1 -1
- package/dist/doctor/ranges.js +1 -1
- package/dist/generate/app.d.ts +3 -1
- package/dist/generate/app.js +2 -1
- package/dist/new/versions.js +2 -2
- package/dist/pnpm.d.ts +14 -0
- package/dist/pnpm.js +37 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -25,6 +25,7 @@ O comando `prumo`: `new`, `make:page`, `make:domain`, `make:component`, `check`
|
|
|
25
25
|
- os provedores (`src/providers/app.tsx`: query, i18n e repositórios) e o `src/main.tsx`;
|
|
26
26
|
- uma tela inicial, `src/pages/home` na rota `/`, gerada pelo mesmo modelo do `make:page` (com o teste e as mensagens nos dois idiomas);
|
|
27
27
|
- o eslint com o plugin do Prumo, o vitest com jsdom, o `AGENTS.md` (as camadas e os comandos, curto) e o `.mcp.json` com o servidor `prumo` (`pnpm exec prumo-mcp`);
|
|
28
|
+
- o `packageManager` no `package.json`, com o pnpm fixado (`pnpm@<versão>`): a versão vem do `npm_config_user_agent` (o pnpm o põe no ambiente em `pnpm dlx`, `pnpm exec` e `pnpm create`) ou, sem ele, de `pnpm --version`; sem nenhuma das duas, o campo fica de fora. Assim o `prumo doctor` do app novo não avisa que falta o `packageManager` (`src/pnpm.ts`);
|
|
28
29
|
- os scripts `dev`, `build`, `typecheck`, `lint`, `check`, `test` e `verify` (typecheck, lint, check e test, sem navegador).
|
|
29
30
|
|
|
30
31
|
As bibliotecas de terceiros têm as versões fixadas nos modelos (`templates/app`), e os cinco pacotes do Prumo entram como `^<versão>` (a versão de cada um está em `src/new/versions.ts`, que o `versions.test.ts` confere contra os `package.json` de `packages/*`: ao subir uma versão, atualize o arquivo). Com `--packages <pasta>` (os tarballs do `pnpm pack:all`), o `package.json` ganha `pnpm.overrides` com `file:` para os tarballs, e o app instala sem registry. Roda `git init` (sem commit) e `pnpm install`, a não ser com `--no-install`; sob o servidor MCP (ou qualquer Runtime sem `inheritStdio`), a saída do `pnpm install` é capturada e volta pelo `runtime.out`/`runtime.err` (`process.ts`), nunca direto no stdout do processo.
|
package/dist/commands/doctor.js
CHANGED
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
import { defineCommand } from 'citty';
|
|
2
|
-
import { spawnSync } from 'node:child_process';
|
|
3
2
|
import { readFileSync, statSync } from 'node:fs';
|
|
4
|
-
import { tmpdir } from 'node:os';
|
|
5
3
|
import path from 'node:path';
|
|
6
4
|
import { runChecks } from "../doctor/checks.js";
|
|
7
5
|
import { ExitError, UsageError } from "../errors.js";
|
|
6
|
+
import { pnpmVersion } from "../pnpm.js";
|
|
8
7
|
const STATUS_TEXT = { ok: 'ok ', warn: 'aviso', error: 'erro ' };
|
|
9
8
|
/** Uma linha do relatório: o resultado, o que foi conferido e a explicação. */
|
|
10
9
|
export function formatFinding({ status, label, message }) {
|
|
@@ -23,22 +22,6 @@ export function formatSummary(findings) {
|
|
|
23
22
|
].filter(Boolean);
|
|
24
23
|
return `prumo doctor: ${parts.join(' e ')}.`;
|
|
25
24
|
}
|
|
26
|
-
/** O pnpm que a pessoa usa. Roda fora do projeto e sem baixar versões, porque o doctor não usa a rede. */
|
|
27
|
-
function pnpmVersion() {
|
|
28
|
-
const result = spawnSync('pnpm', ['--version'], {
|
|
29
|
-
cwd: tmpdir(),
|
|
30
|
-
encoding: 'utf8',
|
|
31
|
-
timeout: 20_000,
|
|
32
|
-
env: {
|
|
33
|
-
...process.env,
|
|
34
|
-
COREPACK_ENABLE_NETWORK: '0',
|
|
35
|
-
COREPACK_ENABLE_AUTO_PIN: '0',
|
|
36
|
-
npm_config_manage_package_manager_versions: 'false',
|
|
37
|
-
},
|
|
38
|
-
});
|
|
39
|
-
const version = result.stdout?.trim();
|
|
40
|
-
return result.status === 0 && version ? version : undefined;
|
|
41
|
-
}
|
|
42
25
|
function readText(file) {
|
|
43
26
|
try {
|
|
44
27
|
return statSync(file).isFile() ? readFileSync(file, 'utf8') : undefined;
|
package/dist/commands/new.d.ts
CHANGED
|
@@ -5,7 +5,7 @@ import type { Runtime } from '../runtime.js';
|
|
|
5
5
|
* leva para `<dir>/<nome>`: um erro não deixa pasta pela metade. Depois roda `git init` (sem commit)
|
|
6
6
|
* e `pnpm install`, a não ser com `--no-install`.
|
|
7
7
|
*/
|
|
8
|
-
export declare function createNewCommand(runtime: Runtime): import("citty").CommandDef<{
|
|
8
|
+
export declare function createNewCommand(runtime: Runtime, askPnpm?: () => string | undefined): import("citty").CommandDef<{
|
|
9
9
|
readonly nome: {
|
|
10
10
|
readonly type: "positional";
|
|
11
11
|
readonly required: true;
|
package/dist/commands/new.js
CHANGED
|
@@ -7,6 +7,7 @@ import { ExitError, UsageError } from "../errors.js";
|
|
|
7
7
|
import { generateApp } from "../generate/app.js";
|
|
8
8
|
import { appNameProblem } from "../new/name.js";
|
|
9
9
|
import { readTarballs } from "../new/packages.js";
|
|
10
|
+
import { detectPnpmVersion } from "../pnpm.js";
|
|
10
11
|
import { childEnv, runChild } from "../process.js";
|
|
11
12
|
import { shellQuote } from "./shared.js";
|
|
12
13
|
/**
|
|
@@ -35,7 +36,7 @@ function resolveDestination(runtime, dir, name) {
|
|
|
35
36
|
* leva para `<dir>/<nome>`: um erro não deixa pasta pela metade. Depois roda `git init` (sem commit)
|
|
36
37
|
* e `pnpm install`, a não ser com `--no-install`.
|
|
37
38
|
*/
|
|
38
|
-
export function createNewCommand(runtime) {
|
|
39
|
+
export function createNewCommand(runtime, askPnpm) {
|
|
39
40
|
return defineCommand({
|
|
40
41
|
meta: {
|
|
41
42
|
name: 'new',
|
|
@@ -48,6 +49,10 @@ provedores (query, i18n e repositórios), uma tela inicial (a mesma que o prumo
|
|
|
48
49
|
rota /), o eslint com o plugin do Prumo, o vitest com jsdom, o AGENTS.md e o .mcp.json com o servidor
|
|
49
50
|
prumo, que dá a um agente os comandos da CLI.
|
|
50
51
|
|
|
52
|
+
O package.json do app fixa o pnpm em packageManager (pnpm@<versão>): a versão vem do pnpm que
|
|
53
|
+
rodou o comando (npm_config_user_agent) ou, na falta dela, de pnpm --version; sem nenhuma das duas,
|
|
54
|
+
o campo fica de fora. Assim o prumo doctor do app não avisa que falta o packageManager.
|
|
55
|
+
|
|
51
56
|
Os scripts do app são dev, build, typecheck, lint, check, test e verify (typecheck, lint, check e
|
|
52
57
|
test, sem navegador). Os pacotes do Prumo entram como ^<versão>; com --packages, o app instala os
|
|
53
58
|
tarballs da pasta (pnpm.overrides com file:), o que serve a quem ainda não tem os pacotes num
|
|
@@ -100,7 +105,7 @@ escreve nada. Os tarballs de --packages saem do pnpm pack:all, no monorepo do Pr
|
|
|
100
105
|
let files;
|
|
101
106
|
try {
|
|
102
107
|
const root = path.join(scratch, name);
|
|
103
|
-
files = generateApp(root, { name, overrides });
|
|
108
|
+
files = generateApp(root, { name, overrides, pnpm: detectPnpmVersion(runtime, askPnpm) });
|
|
104
109
|
if (!dryRun) {
|
|
105
110
|
mkdirSync(path.dirname(destination), { recursive: true });
|
|
106
111
|
const createdFolder = !existsSync(destination);
|
package/dist/doctor/ranges.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* As faixas de versão dos pacotes do Prumo que esta CLI espera num projeto, para o `prumo doctor`.
|
|
3
3
|
*
|
|
4
|
-
* Os pacotes versionam separados (o cli está na 0.5.
|
|
4
|
+
* Os pacotes versionam separados (o cli está na 0.5.1, o core na 0.1.3), então a comparação é por
|
|
5
5
|
* faixa compatível, não por igualdade: `>=mínimo <limite`. O Changesets não mantém um campo
|
|
6
6
|
* próprio do `package.json` (ele só atualiza `dependencies`, `devDependencies` e
|
|
7
7
|
* `peerDependencies`, e o cli não depende do core nem do testing), então a tabela mora aqui e o
|
package/dist/doctor/ranges.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* As faixas de versão dos pacotes do Prumo que esta CLI espera num projeto, para o `prumo doctor`.
|
|
3
3
|
*
|
|
4
|
-
* Os pacotes versionam separados (o cli está na 0.5.
|
|
4
|
+
* Os pacotes versionam separados (o cli está na 0.5.1, o core na 0.1.3), então a comparação é por
|
|
5
5
|
* faixa compatível, não por igualdade: `>=mínimo <limite`. O Changesets não mantém um campo
|
|
6
6
|
* próprio do `package.json` (ele só atualiza `dependencies`, `devDependencies` e
|
|
7
7
|
* `peerDependencies`, e o cli não depende do core nem do testing), então a tabela mora aqui e o
|
package/dist/generate/app.d.ts
CHANGED
|
@@ -12,9 +12,11 @@ export interface AppRequest {
|
|
|
12
12
|
name: string;
|
|
13
13
|
/** Os tarballs do Prumo (nome do pacote -> `file:<caminho>`), que viram `pnpm.overrides`. */
|
|
14
14
|
overrides?: Readonly<Record<string, string>> | undefined;
|
|
15
|
+
/** A versão do pnpm (x.y.z) que vira `packageManager`. Ausente, o campo fica de fora. */
|
|
16
|
+
pnpm?: string | undefined;
|
|
15
17
|
}
|
|
16
18
|
/** O `package.json` do app: os scripts, as dependências e, com tarballs, os `pnpm.overrides`. */
|
|
17
|
-
export declare function appPackageJson({ name, overrides }: AppRequest): string;
|
|
19
|
+
export declare function appPackageJson({ name, overrides, pnpm }: AppRequest): string;
|
|
18
20
|
/** Todos os arquivos de uma pasta, relativos a ela e com `/`, em ordem. */
|
|
19
21
|
export declare function listFiles(dir: string, base?: string): string[];
|
|
20
22
|
/**
|
package/dist/generate/app.js
CHANGED
|
@@ -72,7 +72,7 @@ const DEV_DEPENDENCIES = {
|
|
|
72
72
|
const RUNTIME_PRUMO = '@matizze/prumo-core';
|
|
73
73
|
const sorted = (map) => Object.fromEntries(Object.entries(map).sort(([a], [b]) => a.localeCompare(b)));
|
|
74
74
|
/** O `package.json` do app: os scripts, as dependências e, com tarballs, os `pnpm.overrides`. */
|
|
75
|
-
export function appPackageJson({ name, overrides }) {
|
|
75
|
+
export function appPackageJson({ name, overrides, pnpm }) {
|
|
76
76
|
const prumo = Object.entries(PRUMO_VERSIONS).map(([pkg, version]) => [pkg, `^${version}`]);
|
|
77
77
|
const runtime = Object.fromEntries(prumo.filter(([pkg]) => pkg === RUNTIME_PRUMO));
|
|
78
78
|
const tools = Object.fromEntries(prumo.filter(([pkg]) => pkg !== RUNTIME_PRUMO));
|
|
@@ -81,6 +81,7 @@ export function appPackageJson({ name, overrides }) {
|
|
|
81
81
|
private: true,
|
|
82
82
|
version: '0.0.0',
|
|
83
83
|
type: 'module',
|
|
84
|
+
...(pnpm ? { packageManager: `pnpm@${pnpm}` } : {}),
|
|
84
85
|
engines: { node: '>=24' },
|
|
85
86
|
scripts: {
|
|
86
87
|
dev: 'vite',
|
package/dist/new/versions.js
CHANGED
|
@@ -8,6 +8,6 @@ export const PRUMO_VERSIONS = {
|
|
|
8
8
|
'@matizze/prumo-rules': '0.2.1',
|
|
9
9
|
'@matizze/prumo-core': '0.1.3',
|
|
10
10
|
'@matizze/prumo-testing': '0.2.1',
|
|
11
|
-
'@matizze/prumo-cli': '0.5.
|
|
12
|
-
'@matizze/prumo-mcp': '0.1.
|
|
11
|
+
'@matizze/prumo-cli': '0.5.1',
|
|
12
|
+
'@matizze/prumo-mcp': '0.1.2',
|
|
13
13
|
};
|
package/dist/pnpm.d.ts
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { Runtime } from './runtime.js';
|
|
2
|
+
/** A versão, se for um semver simples; senão `undefined`. Nada que venha de fora passa sem isto. */
|
|
3
|
+
export declare function validPnpmVersion(text: string | undefined): string | undefined;
|
|
4
|
+
/**
|
|
5
|
+
* O pnpm que a pessoa usa, perguntando a ele (`pnpm --version`). Roda fora do projeto e sem baixar
|
|
6
|
+
* versões, porque nem o doctor nem o new usam a rede para isto. `undefined` se o pnpm não existe.
|
|
7
|
+
*/
|
|
8
|
+
export declare function pnpmVersion(): string | undefined;
|
|
9
|
+
/**
|
|
10
|
+
* A versão do pnpm que o `new` fixa em `packageManager`: a do `npm_config_user_agent` do runtime
|
|
11
|
+
* quando começa com `pnpm/<versão>` (o que o pnpm põe no ambiente em `dlx`, `exec` e `create`) e,
|
|
12
|
+
* senão, a que o próprio pnpm informa. Só vale um semver simples; sem versão válida, `undefined`.
|
|
13
|
+
*/
|
|
14
|
+
export declare function detectPnpmVersion(runtime: Runtime, ask?: () => string | undefined): string | undefined;
|
package/dist/pnpm.js
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { spawnSync } from 'node:child_process';
|
|
2
|
+
import { tmpdir } from 'node:os';
|
|
3
|
+
/** Uma versão simples do pnpm: x.y.z, com pré-lançamento opcional (10.5.0, 11.0.0-rc.1). */
|
|
4
|
+
const SIMPLE_SEMVER = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z]+(?:\.[0-9A-Za-z]+)*)?$/;
|
|
5
|
+
/** A versão, se for um semver simples; senão `undefined`. Nada que venha de fora passa sem isto. */
|
|
6
|
+
export function validPnpmVersion(text) {
|
|
7
|
+
const version = text?.trim();
|
|
8
|
+
return version && SIMPLE_SEMVER.test(version) ? version : undefined;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* O pnpm que a pessoa usa, perguntando a ele (`pnpm --version`). Roda fora do projeto e sem baixar
|
|
12
|
+
* versões, porque nem o doctor nem o new usam a rede para isto. `undefined` se o pnpm não existe.
|
|
13
|
+
*/
|
|
14
|
+
export function pnpmVersion() {
|
|
15
|
+
const result = spawnSync('pnpm', ['--version'], {
|
|
16
|
+
cwd: tmpdir(),
|
|
17
|
+
encoding: 'utf8',
|
|
18
|
+
timeout: 20_000,
|
|
19
|
+
env: {
|
|
20
|
+
...process.env,
|
|
21
|
+
COREPACK_ENABLE_NETWORK: '0',
|
|
22
|
+
COREPACK_ENABLE_AUTO_PIN: '0',
|
|
23
|
+
npm_config_manage_package_manager_versions: 'false',
|
|
24
|
+
},
|
|
25
|
+
});
|
|
26
|
+
const version = result.stdout?.trim();
|
|
27
|
+
return result.status === 0 && version ? version : undefined;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* A versão do pnpm que o `new` fixa em `packageManager`: a do `npm_config_user_agent` do runtime
|
|
31
|
+
* quando começa com `pnpm/<versão>` (o que o pnpm põe no ambiente em `dlx`, `exec` e `create`) e,
|
|
32
|
+
* senão, a que o próprio pnpm informa. Só vale um semver simples; sem versão válida, `undefined`.
|
|
33
|
+
*/
|
|
34
|
+
export function detectPnpmVersion(runtime, ask = pnpmVersion) {
|
|
35
|
+
const agent = /^pnpm\/(\S+)/.exec(runtime.env.npm_config_user_agent ?? '');
|
|
36
|
+
return validPnpmVersion(agent?.[1]) ?? validPnpmVersion(ask());
|
|
37
|
+
}
|