@memoring/cli 0.1.0 → 0.2.0

package/README.md

@@ -44,7 +44,7 @@ Os itens enviados nascem **PENDING_REVIEW** — nada entra nas suas listagens ne
 | Command | Purpose |
 | --- | --- |
 | `memoring auth` | login / logout / status |
-| `memoring stage` | schema (o contrato) / create (envia o lote, `--file` ou stdin, `--replace` esvazia a caixa antes) |
+| `memoring stage` | schema (o contrato) / create (envia o lote, `--file` ou stdin, `--replace` esvazia a caixa antes, `--max-notes\|--max-flashcards\|--max-one-shots` limitam cada tipo) |
 | `memoring inbox` | list / accept `<id>` / accept-all / discard `<id>` |
 | `memoring version` | versão da CLI |
 
@@ -79,7 +79,7 @@ Cada item do lote (1 a 50, all-or-nothing):
 }
 ```
 
-- `type`: `NORMAL` (nota, exige `content` em markdown), `FLASHCARD` ou `ONE_SHOT` (exigem `front` + `back`).
+- `type`: `NOTE` (nota, exige `content` em markdown; `NORMAL` legado é aceito e mapeado para `NOTE`), `FLASHCARD` ou `ONE_SHOT` (exigem `front` + `back`).
 - `source`: origem do material — default `"Importação assistida (CLI)"`.
 
 ## Para agentes de IA

package/dist/commands/stage.js

@@ -1,15 +1,53 @@
 import { readFileSync } from 'node:fs';
 import { apiFetch, ApiError } from '../api.js';
 import { dim, fail, green, printJson, stringFlag } from './shared.js';
-const TYPES = ['NORMAL', 'FLASHCARD', 'ONE_SHOT'];
+const TYPES = ['NOTE', 'FLASHCARD', 'ONE_SHOT'];
+// Retrocompat: itens.json antigos com "type": "NORMAL" são normalizados para "NOTE".
+const LEGACY_TYPE_ALIASES = { NORMAL: 'NOTE' };
 const MAX_ITEMS = 50;
 const DEFAULT_SOURCE = 'Importação assistida (CLI)';
+/** Flags --max-<tipo> do `stage create`: teto por tipo no lote (validação local). */
+const MAX_FLAG_BY_TYPE = {
+    NOTE: 'max-notes',
+    FLASHCARD: 'max-flashcards',
+    ONE_SHOT: 'max-one-shots',
+};
+const TYPE_LABEL = {
+    NOTE: 'notas',
+    FLASHCARD: 'flashcards',
+    ONE_SHOT: '1-shots',
+};
+function enforceTypeCaps(items, flags) {
+    const caps = Object.entries(MAX_FLAG_BY_TYPE)
+        .map(([type, flag]) => {
+        const raw = stringFlag(flags, flag);
+        if (raw === undefined) {
+            return null;
+        }
+        const max = Number(raw);
+        if (!Number.isInteger(max) || max < 0) {
+            fail(`--${flag} inválido: use um inteiro >= 0 (veio ${JSON.stringify(raw)}).`);
+        }
+        return { type, flag, max };
+    })
+        .filter((cap) => cap !== null);
+    if (caps.length === 0) {
+        return;
+    }
+    for (const cap of caps) {
+        const count = items.filter((item) => item.type === cap.type).length;
+        if (count > cap.max) {
+            fail(`lote tem ${count} ${TYPE_LABEL[cap.type]} e --${cap.flag}=${cap.max}: ajuste o lote ou o limite. ` +
+                'Se um agente gerou este lote, peça a ele para respeitar os limites por tipo.');
+        }
+    }
+}
 const SCHEMA_JSON = {
     description: 'Lote de 1..50 itens para POST /api/notes/review-inbox. All-or-nothing: qualquer item inválido rejeita o lote. Os itens nascem PENDING_REVIEW — o usuário aceita/edita/recusa em /cards/inbox.',
     item: {
-        type: 'NORMAL | FLASHCARD | ONE_SHOT (obrigatório)',
+        type: 'NOTE | FLASHCARD | ONE_SHOT (obrigatório; NORMAL legado é aceito e mapeado para NOTE)',
         title: 'string (obrigatório)',
-        content: 'string — corpo da nota em markdown (obrigatório quando type=NORMAL)',
+        content: 'string — corpo da nota em markdown (obrigatório quando type=NOTE)',
         front: 'string — pergunta (obrigatório quando type=FLASHCARD|ONE_SHOT)',
         back: 'string — resposta (obrigatório quando type=FLASHCARD|ONE_SHOT)',
         subjectName: 'string? — matéria (ex.: "Direito Constitucional")',
@@ -28,12 +66,13 @@ const SCHEMA_JSON = {
             source: 'Apostila constitucional.pdf',
         },
     ],
+    typeCaps: 'flags opcionais do stage create: --max-notes N | --max-flashcards N | --max-one-shots N — o lote é rejeitado se algum tipo exceder o limite.',
 };
 const SCHEMA_TEXT = `Contrato dos itens da caixa de revisão (POST /api/notes/review-inbox):
 
-  type          NORMAL | FLASHCARD | ONE_SHOT      (obrigatório)
+  type          NOTE | FLASHCARD | ONE_SHOT      (obrigatório; NORMAL legado é mapeado para NOTE)
   title         string                            (obrigatório)
-  content       string — corpo da nota (markdown) (obrigatório quando type=NORMAL)
+  content       string — corpo da nota (markdown) (obrigatório quando type=NOTE)
   front, back   string — pergunta e resposta      (obrigatório quando type=FLASHCARD|ONE_SHOT)
   subjectName?  string — matéria (ex.: "Direito Constitucional")
   subtopicName? string — subtópico
@@ -42,7 +81,8 @@ const SCHEMA_TEXT = `Contrato dos itens da caixa de revisão (POST /api/notes/re
 
 Lote: 1 a ${MAX_ITEMS} itens, all-or-nothing — qualquer item inválido rejeita o lote inteiro.
 Os itens nascem PENDING_REVIEW: o usuário aceita, edita ou recusa em /cards/inbox.
-Dica: FLASHCARD entra na fila de revisão espaçada (FSRS); ONE_SHOT é pergunta de resposta única.`;
+Dica: FLASHCARD entra na fila de revisão espaçada (FSRS); ONE_SHOT é pergunta de resposta única.
+Limites por tipo: --max-notes N | --max-flashcards N | --max-one-shots N (o lote é rejeitado se exceder).`;
 async function readStdin() {
     const chunks = [];
     for await (const chunk of process.stdin) {
@@ -64,14 +104,17 @@ function validateItems(raw) {
             fail(`${where}: esperado objeto, veio ${typeof item}.`);
         }
         const it = item;
+        if (typeof it.type === 'string' && LEGACY_TYPE_ALIASES[it.type] !== undefined) {
+            it.type = LEGACY_TYPE_ALIASES[it.type];
+        }
         if (typeof it.type !== 'string' || !TYPES.includes(it.type)) {
             fail(`${where}: type deve ser ${TYPES.join(' | ')} (veio ${JSON.stringify(it.type)}).`);
         }
         if (typeof it.title !== 'string' || it.title.trim() === '') {
             fail(`${where}: title é obrigatório.`);
         }
-        if (it.type === 'NORMAL' && (typeof it.content !== 'string' || it.content.trim() === '')) {
-            fail(`${where} (${it.title}): type=NORMAL exige content.`);
+        if (it.type === 'NOTE' && (typeof it.content !== 'string' || it.content.trim() === '')) {
+            fail(`${where} (${it.title}): type=NOTE exige content.`);
         }
         if ((it.type === 'FLASHCARD' || it.type === 'ONE_SHOT') &&
             (typeof it.front !== 'string' || it.front.trim() === '' || typeof it.back !== 'string' || it.back.trim() === '')) {
@@ -122,6 +165,7 @@ export async function stageCommand(parsed) {
                 fail(`JSON inválido: ${e.message}`);
             }
             const items = validateItems(parsedJson);
+            enforceTypeCaps(items, parsed.flags);
             if (parsed.flags.replace) {
                 const removed = await emptyInbox();
                 if (!parsed.flags.json) {
@@ -153,7 +197,9 @@ export async function stageCommand(parsed) {
             process.stdout.write('Uso: memoring stage <schema|create> [--file itens.json] [--replace] [--json]\n' +
                 '  schema   imprime o contrato JSON dos itens (para humanos e agentes)\n' +
                 '  create   envia o lote para a caixa de revisão (arquivo ou stdin)\n' +
-                '           --replace esvazia a caixa antes de enviar\n');
+                '           --replace esvazia a caixa antes de enviar\n' +
+                '           --max-notes N | --max-flashcards N | --max-one-shots N\n' +
+                '           limitam a quantidade de cada tipo no lote (validação local)\n');
             if (sub) {
                 process.exitCode = 1;
             }

package/dist/main.js

@@ -5,7 +5,7 @@ import { authCommand } from './commands/auth.js';
 import { inboxCommand } from './commands/inbox.js';
 import { stageCommand } from './commands/stage.js';
 import { fail, parseArgs as parse } from './commands/shared.js';
-const VERSION = '0.1.0';
+const VERSION = '0.2.0';
 const HELP = `Memoring CLI — flashcards e notas por IA, direto do terminal.
 
 Uso: memoring <comando> [subcomando] [flags]

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@memoring/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI do Memoring — envie flashcards/notas gerados por IA para a sua caixa de revisão, direto do terminal.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caiomestres/memoring.git",
+    "directory": "cli"
+  },
   "type": "module",
   "bin": {
     "memoring": "dist/main.js"

package/skills/memoring-cli/SKILL.md

@@ -22,8 +22,9 @@ O Memoring é um app de estudos com revisão espaçada (FSRS). A CLI `memoring`
 
 ## Regras do contrato (resumo — a fonte da verdade é `stage schema`)
 
-- `type`: `NORMAL` (nota, exige `content` markdown), `FLASHCARD` ou `ONE_SHOT` (exigem `front` + `back`).
+- `type`: `NOTE` (nota, exige `content` markdown; `NORMAL` legado é aceito e mapeado para `NOTE`), `FLASHCARD` ou `ONE_SHOT` (exigem `front` + `back`).
 - `title` sempre obrigatório; lote de 1 a 50 itens, all-or-nothing.
+- Se o usuário pedir limites por tipo (ex.: "no máximo 20 flashcards e 5 notas"), respeite-os ao gerar e valide com `--max-notes N --max-flashcards N --max-one-shots N` no `stage create` — o lote é rejeitado se exceder.
 - `ONE_SHOT` = pergunta de resposta única; prefira `FLASHCARD` para memorização.
 - Preencha `source` com a origem real do material (nome do arquivo/pasta) — não use o default quando souber a origem.
 - `subjectName`/`subtopicName` quando o material tiver matéria/subtópico claros; `tags` curtas e em minúsculas.