akademia 0.1.0 → 0.1.1

package/README.md

@@ -1,34 +1,42 @@
 # Akademia CLI
 
-CLI do publicznego API Akademia.pl.
+Prosty dostęp do publicznych promptów i checklist Akademia.pl z terminala.
 
 ## Instalacja
 
 ```bash
 npm install -g akademia
-akademia --help
+akademia
 ```
 
-## Komendy
+Po instalacji wpisz:
 
 ```bash
-akademia doctor
-akademia search "landing page"
-akademia show wywiad-przed-startem-projektu
+akademia pomoc
 ```
 
-## Konfiguracja
+## Podstawowe użycie
 
-Domyślne API:
+```bash
+akademia szukaj "landing page"
+akademia pokaz wywiad-przed-startem-projektu
+akademia status
+```
+
+## Prywatność
+
+CLI V1 pobiera tylko publiczne pliki JSON. Nie wysyła kodu projektu, plików, maili ani danych klientów do Akademii.
+
+## API
+
+Domyślnie CLI łączy się z:
 
 ```bash
 https://akademia.pl
 ```
 
-Możesz podmienić endpoint:
+Technicznie możesz podmienić endpoint:
 
 ```bash
-AKADEMIA_API_BASE=http://127.0.0.1:8898 akademia doctor
+AKADEMIA_API_BASE=http://127.0.0.1:8898 akademia status
 ```
-
-CLI V1 pobiera tylko publiczne pliki JSON. Nie wysyła kodu projektu, plików, maili ani danych klientów do Akademii.

package/bin/akademia.js

@@ -5,7 +5,7 @@ import { scanProject } from "../src/scan.js";
 import { searchResources } from "../src/search.js";
 import { printDoctor, printResource, printScanResults, printSearchResults } from "../src/format.js";
 
-const VERSION = "0.1.0";
+const VERSION = "0.1.1";
 
 async function main(argv) {
   const { command, args, flags } = parseArgs(argv);
@@ -16,20 +16,27 @@ async function main(argv) {
     return;
   }
 
-  if (!command || flags.help) {
+  if (flags.help || isHelpCommand(command)) {
     printHelp();
     return;
   }
 
-  if (command === "doctor") {
+  if (!command) {
+    await printStart(client);
+    return;
+  }
+
+  const action = normalizeCommand(command);
+
+  if (action === "doctor") {
     const catalog = await client.catalog();
     printDoctor(catalog, client.baseUrl);
     return;
   }
 
-  if (command === "search") {
+  if (action === "search") {
     const query = args.join(" ").trim();
-    if (!query) throw new Error("Podaj frazę, np. akademia search \"landing page\".");
+    if (!query) throw new Error("Podaj frazę, np. akademia szukaj \"landing page\".");
     const index = await client.searchIndex();
     const results = searchResources(index, query, {
       limit: flags.limit || 10,
@@ -39,15 +46,15 @@ async function main(argv) {
     return;
   }
 
-  if (command === "show") {
+  if (action === "show") {
     const id = args[0];
-    if (!id) throw new Error("Podaj ID zasobu, np. akademia show wywiad-przed-startem-projektu.");
+    if (!id) throw new Error("Podaj ID zasobu, np. akademia pokaz wywiad-przed-startem-projektu.");
     const resource = await client.resource(id);
     printResource(resource, { full: flags.full });
     return;
   }
 
-  if (command === "scan") {
+  if (action === "scan") {
     const target = args[0] || ".";
     const index = await client.searchIndex();
     const result = await scanProject(target, index, {
@@ -62,7 +69,7 @@ async function main(argv) {
     return;
   }
 
-  if (command === "report") {
+  if (action === "report") {
     const target = args[0] || ".";
     const index = await client.searchIndex();
     const result = await scanProject(target, index, {
@@ -75,7 +82,7 @@ async function main(argv) {
     return;
   }
 
-  throw new Error(`Nieznana komenda: ${command}`);
+  throw new Error(`Nie znam tej komendy. Wpisz: akademia pomoc`);
 }
 
 function parseArgs(argv) {
@@ -136,28 +143,72 @@ function parseArgs(argv) {
   return { command, args, flags };
 }
 
+function normalizeCommand(command) {
+  const commands = new Map([
+    ["doctor", "doctor"],
+    ["status", "doctor"],
+    ["search", "search"],
+    ["szukaj", "search"],
+    ["show", "show"],
+    ["pokaz", "show"],
+    ["pokaż", "show"],
+    ["scan", "scan"],
+    ["report", "report"]
+  ]);
+
+  return commands.get(command) || command;
+}
+
+function isHelpCommand(command) {
+  return command === "help" || command === "pomoc";
+}
+
+async function printStart(client) {
+  try {
+    const catalog = await client.catalog();
+    const resources = catalog?.resources || [];
+    const total = resources.length;
+    const prompts = resources.filter((item) => item.type === "prompt").length;
+    const checklists = resources.filter((item) => item.type === "checklist").length;
+
+    console.log(`Akademia.pl CLI ${VERSION}
+
+Łączy terminal z publicznymi promptami i checklistami Akademii.
+
+Status: działa
+Zasoby: ${total} publicznych materiałów, ${prompts} promptów, ${checklists} checklist
+
+Następny krok:
+  akademia pomoc
+`);
+    return;
+  } catch (error) {
+    console.log(`Akademia.pl CLI ${VERSION}
+
+CLI jest zainstalowane, ale nie udało się połączyć z Akademia.pl.
+
+Następny krok:
+  akademia pomoc
+
+Szczegół techniczny: ${error.message}
+`);
+  }
+}
+
 function printHelp() {
-  console.log(`Akademia CLI ${VERSION}
-
-Użycie:
-  akademia doctor
-  akademia search "landing page"
-  akademia search "umowa" --type prompt --limit 5
-  akademia show wywiad-przed-startem-projektu
-  akademia show wywiad-przed-startem-projektu --full
-  akademia scan .
-  akademia scan . --limit 5 --max-files 120
-  akademia report .
-  akademia report . --out raport-akademii.md
-
-Flagi:
-  --base-url URL   Nadpisuje API, domyślnie https://akademia.pl
-  --type TYPE      Filtruje search po typie: prompt albo checklist
-  --limit N        Limit wyników search
-  --max-files N    Limit plików czytanych przez scan
-  --out PATH       Ścieżka raportu Markdown dla report
-  --full           Pokazuje pełną treść w show
-  --json           Zwraca wynik scan jako JSON
+  console.log(`Akademia.pl CLI ${VERSION}
+
+Najprościej:
+  akademia
+
+Szukaj promptu albo checklisty:
+  akademia szukaj "landing page"
+
+Pokaż konkretny materiał:
+  akademia pokaz wywiad-przed-startem-projektu
+
+Sprawdź połączenie:
+  akademia status
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akademia",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI Akademia.pl do lokalnego dostępu do promptów i checklist.",
   "type": "module",
   "bin": {

package/src/format.js

@@ -4,14 +4,15 @@ export function printDoctor(catalog, baseUrl) {
   const prompts = resources.filter((item) => item.type === "prompt").length;
   const checklists = resources.filter((item) => item.type === "checklist").length;
   const security = meta.security || {};
+  const connection = resources.length ? "działa" : "brak publicznych zasobów";
 
-  console.log("Akademia CLI");
+  console.log("Akademia.pl CLI");
+  console.log(`Status: ${connection}`);
   console.log(`API: ${baseUrl}`);
-  console.log(`Wersja API: ${meta.version || "brak"}`);
-  console.log(`Zasoby: ${resources.length}, prompty: ${prompts}, checklisty: ${checklists}`);
-  console.log(`Tryb: ${security.mode || "brak"}`);
-  console.log(`Przyjmuje dane projektu: ${security.acceptsProjectFiles ? "tak" : "nie"}`);
-  console.log(`LLM po stronie serwera: ${security.serverSideLlm ? "tak" : "nie"}`);
+  console.log(`Zasoby: ${resources.length} publicznych materiałów`);
+  console.log(`Prompty: ${prompts}`);
+  console.log(`Checklisty: ${checklists}`);
+  console.log(`Pliki z Twojego komputera: ${security.acceptsProjectFiles ? "wysyłane" : "nie są wysyłane"}`);
 }
 
 export function printSearchResults(results) {