akademia 0.1.0 → 0.1.2

package/README.md

@@ -1,34 +1,54 @@
 # 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
 ```
 
-## Konfiguracja
+Program zostanie otwarty w terminalu. Wpisz frazę, której szukasz:
 
-Domyślne API:
+```bash
+landing page
+```
+
+Po wynikach wpisz numer, żeby otworzyć materiał:
 
 ```bash
-https://akademia.pl
+1
 ```
 
-Możesz podmienić endpoint:
+W każdej chwili możesz wpisać:
 
 ```bash
-AKADEMIA_API_BASE=http://127.0.0.1:8898 akademia doctor
+pomoc
+status
+wyjdz
 ```
 
-CLI V1 pobiera tylko publiczne pliki JSON. Nie wysyła kodu projektu, plików, maili ani danych klientów do Akademii.
+## Prywatność
+
+CLI V1 pobiera tylko publiczne pliki JSON. Samo otwarcie programu i wyszukiwanie 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
+```
+
+Technicznie możesz podmienić endpoint:
+
+```bash
+AKADEMIA_API_BASE=http://127.0.0.1:8898 akademia status
+```

package/bin/akademia.js

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
 import { AkademiaClient } from "../src/client.js";
 import { writeReport } from "../src/report.js";
 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.2";
 
 async function main(argv) {
   const { command, args, flags } = parseArgs(argv);
@@ -16,20 +18,27 @@ async function main(argv) {
     return;
   }
 
-  if (!command || flags.help) {
+  if (flags.help || isHelpCommand(command)) {
     printHelp();
     return;
   }
 
-  if (command === "doctor") {
+  if (!command) {
+    await startInteractive(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 +48,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 +71,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 +84,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 +145,218 @@ 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}
+`);
+  }
+}
+
+async function startInteractive(client) {
+  let catalog;
+  try {
+    catalog = await client.catalog();
+  } catch (error) {
+    printOfflineStart(error);
+    return;
+  }
+
+  printInteractiveStart(catalog);
+
+  const rl = readline.createInterface({ input, output });
+  let lastResults = [];
+
+  try {
+    rl.setPrompt("> ");
+    promptAgain(rl);
+
+    for await (const line of rl) {
+      const answer = line.trim();
+      const normalized = answer.toLowerCase();
+
+      if (!answer) {
+        promptAgain(rl);
+        continue;
+      }
+
+      if (["wyjdz", "wyjdź", "exit", "quit", "q"].includes(normalized)) {
+        console.log("Do zobaczenia.");
+        return;
+      }
+
+      if (isHelpCommand(normalized)) {
+        printInteractiveHelp();
+        promptAgain(rl);
+        continue;
+      }
+
+      if (normalizeCommand(normalized) === "doctor") {
+        const freshCatalog = await client.catalog();
+        printDoctor(freshCatalog, client.baseUrl);
+        console.log("");
+        promptAgain(rl);
+        continue;
+      }
+
+      const resourceId = parseShowInput(answer);
+      if (resourceId) {
+        const resource = await client.resource(resourceId);
+        printResource(resource, { full: false });
+        console.log("");
+        promptAgain(rl);
+        continue;
+      }
+
+      if (/^\d+$/.test(answer) && lastResults[Number(answer) - 1]) {
+        const resource = await client.resource(lastResults[Number(answer) - 1].id);
+        printResource(resource, { full: false });
+        console.log("");
+        promptAgain(rl);
+        continue;
+      }
+
+      const index = await client.searchIndex();
+      lastResults = searchResources(index, stripSearchPrefix(answer), { limit: 5 });
+      printInteractiveSearchResults(lastResults);
+      promptAgain(rl);
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+function promptAgain(rl) {
+  if (input.isTTY) rl.prompt();
+}
+
+function printInteractiveStart(catalog) {
+  const resources = catalog?.resources || [];
+  const prompts = resources.filter((item) => item.type === "prompt").length;
+  const checklists = resources.filter((item) => item.type === "checklist").length;
+
+  console.log(`Akademia.pl CLI ${VERSION}
+
+Działa. Masz dostęp do ${resources.length} publicznych materiałów.
+Prompty: ${prompts}. Checklisty: ${checklists}.
+
+Wpisz, czego szukasz, np. landing page.
+Możesz też wpisać: pomoc, status, wyjdz.
+`);
+}
+
+function printOfflineStart(error) {
+  console.log(`Akademia.pl CLI ${VERSION}
+
+CLI jest zainstalowane, ale nie udało się połączyć z Akademia.pl.
+
+Wpisz:
+  akademia pomoc
+
+Szczegół techniczny: ${error.message}
+`);
+}
+
+function printInteractiveHelp() {
+  console.log(`
+Wpisz frazę, której szukasz:
+  landing page
+  umowa
+  oferta
+
+Po wynikach wpisz numer, żeby otworzyć materiał:
+  1
+
+Inne komendy:
+  status
+  wyjdz
+`);
+}
+
+function parseShowInput(value) {
+  const match = value.match(/^(pokaz|pokaż|show)\s+(.+)$/i);
+  return match ? match[2].trim() : "";
+}
+
+function stripSearchPrefix(value) {
+  return value.replace(/^(szukaj|search)\s+/i, "").trim();
+}
+
+function printInteractiveSearchResults(results) {
+  if (!results.length) {
+    console.log("Nie znalazłem pasujących materiałów. Spróbuj inną frazę.");
+    console.log("");
+    return;
+  }
+
+  console.log("Znalazłem:");
+  for (const [index, item] of results.entries()) {
+    console.log(`${index + 1}. ${item.title}`);
+    console.log(`   ${item.type === "prompt" ? "prompt" : "checklista"}, ${item.application || item.applicationSlug || "Akademia"}`);
+  }
+  console.log("");
+  console.log("Wpisz numer, żeby otworzyć materiał, albo wpisz kolejną frazę.");
+  console.log("");
+}
+
 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.2",
   "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) {