@memoring/cli 0.5.0 → 0.6.0

package/README.md

@@ -54,7 +54,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 + seus limites por tipo) / caps (mostra/grava os limites — valem para o app e para os agentes) / create (envia o lote, `--file` ou stdin, `--replace` esvazia a caixa antes; `--max-*` vence a preferência por lote) |
+| `memoring stage` | schema (o contrato + seus limites por tipo + as regras de qualidade e suas instruções custom — tudo que o agente deve seguir) / caps (mostra/grava os limites — valem para o app e para os agentes) / create (envia o lote, `--file` ou stdin, `--replace` esvazia a caixa antes; `--max-*` vence a preferência por lote) |
 | `memoring inbox` | list / accept `<id>` / accept-all / discard `<id>` |
 | `memoring update` | atualiza a CLI para a última versão (via npm) |
 | `memoring skill` | imprime o guia completo da CLI para agentes de IA (o SKILL.md empacotado) |

package/dist/commands/stage.js

@@ -9,6 +9,21 @@ const LEGACY_TYPE_ALIASES = { NORMAL: 'NOTE' };
 const MAX_ITEMS = 50;
 const DEFAULT_SOURCE = 'Importação assistida (CLI)';
 const UNLIMITED = -1;
+/**
+ * GET /notes/import/agent-guidance, fail-open como o fetchStoredCaps: sem sessão/rede
+ * devolve null e o schema sai só com o contrato.
+ */
+async function fetchAgentGuidance() {
+    if (!hasSession()) {
+        return null;
+    }
+    try {
+        return (await apiFetch('/notes/import/agent-guidance'));
+    }
+    catch {
+        return null;
+    }
+}
 /** Rótulo de exibição de um teto: -1 → "à vontade". */
 function capLabel(max) {
     return max === UNLIMITED ? 'à vontade' : `até ${max}`;
@@ -206,18 +221,21 @@ export async function stageCommand(parsed) {
     const [sub] = parsed._;
     switch (sub) {
         case 'schema': {
-            const caps = await fetchStoredCaps();
+            const [caps, guidance] = await Promise.all([fetchStoredCaps(), fetchAgentGuidance()]);
             if (parsed.flags.json) {
-                printJson(caps
-                    ? {
-                        ...SCHEMA_JSON,
-                        userCaps: {
-                            maxNotes: caps.maxNotes,
-                            maxFlashcards: caps.maxFlashcards,
-                            maxOneShots: caps.maxOneShots,
-                        },
-                    }
-                    : SCHEMA_JSON);
+                printJson({
+                    ...SCHEMA_JSON,
+                    ...(caps
+                        ? {
+                            userCaps: {
+                                maxNotes: caps.maxNotes,
+                                maxFlashcards: caps.maxFlashcards,
+                                maxOneShots: caps.maxOneShots,
+                            },
+                        }
+                        : {}),
+                    ...(guidance ?? {}),
+                });
             }
             else {
                 process.stdout.write(SCHEMA_TEXT + '\n');
@@ -229,6 +247,16 @@ export async function stageCommand(parsed) {
                 else {
                     process.stdout.write(dim('\n(limites por tipo indisponíveis — faça `memoring auth login` ou verifique a conexão)\n'));
                 }
+                if (guidance) {
+                    process.stdout.write('\nRegras de qualidade — SEMPRE aplicadas ao gerar (as mesmas que o app envia à LLM):\n' +
+                        guidance.qualityRules.trim() +
+                        '\n');
+                    if (guidance.customInstructions) {
+                        process.stdout.write('\nInstruções adicionais do usuário — também SEMPRE aplicadas:\n' +
+                            guidance.customInstructions.trim() +
+                            '\n');
+                    }
+                }
             }
             return;
         }

package/dist/main.js

@@ -8,7 +8,7 @@ import { updateCommand } from './commands/update.js';
 import { skillCommand } from './commands/skill.js';
 import { fail, parseArgs as parse } from './commands/shared.js';
 import { newerVersionAvailable, scheduleUpdateCheck } from './update.js';
-const VERSION = '0.5.0';
+const VERSION = '0.6.0';
 const HELP = `Memoring CLI — flashcards e notas por IA, direto do terminal.
 
 Uso: memoring <comando> [subcomando] [flags]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoring/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "CLI do Memoring — envie flashcards/notas gerados por IA para a sua caixa de revisão, direto do terminal.",
   "repository": {
     "type": "git",

package/skills/memoring-cli/SKILL.md

@@ -31,7 +31,7 @@ Flags globais: `--json` (saída legível por máquina), `--no-color`, `--api-bas
 ## Fluxo padrão
 
 1. **Entenda o pedido** — qual pasta/arquivo/material vira flashcards/notas e se o usuário pediu quantidades.
-2. **Leia o contrato e os limites**: `memoring stage schema --json`. Além do contrato, a saída traz `userCaps` — os limites por tipo DO USUÁRIO (`-1` = à vontade, `0` = não gerar o tipo, `N` = teto). Respeite-os SEMPRE, mesmo sem pedido explícito no chat.
+2. **Leia o contrato, os limites e as regras**: `memoring stage schema --json`. Além do contrato, a saída traz: `userCaps` — os limites por tipo DO USUÁRIO (`-1` = à vontade, `0` = não gerar o tipo, `N` = teto), respeite-os SEMPRE; `qualityRules` — as regras de qualidade INTEGRAIS (as mesmas que o app envia à LLM), aplique-as em TODOS os itens; `customInstructions` — instruções adicionais do usuário (quando não-nulas), também sempre aplicadas. Tudo isso vale mesmo sem pedido explícito no chat.
 3. **Leia os materiais** e gere os itens no contrato, num arquivo JSON (array ou `{ "items": [...] }`).
 4. **Envie**: `memoring stage create --file <arquivo> --json`. Se o lote for rejeitado por limite de tipo, ajuste o LOTE — não relaxe o limite do usuário.
 5. **Avise o usuário**: quantos itens foram para a caixa de revisão e onde aceitar — no app em `/cards/inbox` ou `memoring inbox list` / `memoring inbox accept-all`.