@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 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.
@@ -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;
@@ -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;
@@ -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);
@@ -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.0, o core na 0.1.3), então a comparação é por
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
@@ -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.0, o core na 0.1.3), então a comparação é por
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
@@ -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
  /**
@@ -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',
@@ -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.0',
12
- '@matizze/prumo-mcp': '0.1.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
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@matizze/prumo-cli",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "O comando prumo: make:domain, check e doctor, e a API para rodar comandos em processo.",
5
5
  "repository": {
6
6
  "type": "git",