feat: added JSON format support in Nitrodigest

Projects/Nitrodigest/Docs/Guides/Understanding the Output Format.md

@@ -11,19 +11,30 @@ Output includes both metadata and the actual summary content. Here's what a typi
 
 ```yaml
 ---
-title: example.txt
-source: file:///home/user/documents/example.txt
-date: '2025-05-16 07:50:22'
-id: example.txt
-summary_date: '2025-05-26 07:55:46'
+date: '2025-09-19 19:25:20'
+id: README.md
 model: mistral
-tokens: 189
+source: file:///home/frodigo/Work/garage/README.md
+summary_date: '2025-09-29 07:51:03'
+title: README.md
+tokens: 262
 ---
 
-- Project kickoff meeting scheduled for June 3rd with stakeholders from engineering and design teams
-- New authentication system implementation 70% complete, requiring final testing phase next week
-- Database performance optimization needed to reduce query response time from 3 seconds to under 1 second
-- Updated design system documentation deadline set for Wednesday, including new accessibility compliance features
+# Summary
+
+1. The text discusses a programming space, referred to as 'the garage', that values traditional programming and independence. It expresses concern over the role of programmers in the AI era being reduced to editors, arguing for the importance of 'vibe coding' and human creativity. The text also introduces a list of principles inspired by the Zen of Python. It provides details about the structure and content available on the site, including blog posts, projects, testimonials, and licensing information.
+2. The text also mentions options for staying updated with the author's content such as RSS feed subscription, newsletter subscription, and following the author on GitHub. It emphasizes that all content is open-source and available online or in a GitHub repository.
+3. Lastly, it provides instructions for contributing to the open-source projects through reporting bugs, suggesting ideas, and submitting pull requests.
+
+# Tags
+
+1. programming
+2. traditional programming
+3. AI
+4. garage
+5. Zen of Python
+6. open source
+7. contributing
 ```
 
 ## Output Format Components
@@ -58,41 +69,31 @@ tokens: 189
 
 After the YAML frontmatter, the actual summary content follows. The format depends on your prompt template:
 
-**Default Format (Bullet Points):**
+**Default Format (Numbered lists):**
 
 ```bash
-- Key point 1 with relevant details and context
-- Key point 2 highlighting important information
-- Key point 3 including any action items or deadlines
+1. Key point 1 with relevant details and context
+2. Key point 2 highlighting important information
+3. Key point 3 including any action items or deadlines
 ```
 
-## Output Variations by Content Type
+### Tags
 
-### Single File Processing
+Nitrodigest extracts tags from text and return them as list. Thanks to tags you can see what topics are described in the provided text:
 
 ```bash
-nitrodigest document.txt
+# Tags
+
+1. programming
+2. traditional programming
+3. AI
+4. garage
+5. Zen of Python
+6. open source
+7. contributing
 ```
 
-**Output:**
-
-```yaml
----
-title: document.txt
-source: file:///home/user/document.txt
-date: '2025-05-16 08:30:15'
-id: document.txt
-summary_date: '2025-05-29 14:22:33'
-model: mistral
-tokens: 156
----
-
-- Document contains quarterly sales report showing 23% increase in revenue
-- Key performance indicators exceeded targets in Q2 with customer satisfaction at 4.8/5
-- Recommendations include expanding sales team and investing in customer support tools
-```
-
-### Directory Processing
+## Directory Processing
 
 When processing multiple files, each file gets its own complete output block:
 
@@ -113,9 +114,7 @@ model: mistral
 tokens: 142
 ---
 
-- Team meeting covered sprint planning and resource allocation for Q3 projects
-- Decision made to prioritize authentication feature over reporting dashboard
-- Next meeting scheduled for June 5th to review progress and address blockers
+<text 1 summary content>
 
 ---
 title: project-report.md
@@ -127,9 +126,7 @@ model: mistral
 tokens: 287
 ---
 
-- Project status shows 75% completion with June 15th target deadline on track
-- Technical challenges resolved in authentication system, testing phase begins next week
-- Budget utilization at 85% with remaining funds allocated for final testing and deployment
+<text 2 summary content>
 ```
 
 ## Working with Output
@@ -186,27 +183,68 @@ Create a summary table for this document:
 | Timeline | Important dates or deadlines |
 ```
 
-### JSON-like Structured Output
+### JSON Structured Output
 
-**Custom Prompt for JSON-style Output:**
+You can use the `--format` flag to change output format to JSON:
 
 ```bash
-Summarize this document in the following structured format:
-
-TOPIC: [Main subject]
-PRIORITY: [High/Medium/Low]
-SUMMARY: [2-3 sentence overview]
-DETAILS: [Key points as numbered list]
-ACTIONS: [Required actions if any]
-DEADLINE: [Important dates]
+$ nitrodigest README.md --format json
+
+{
+  "summary": [
+    "The text discusses a programming space that values traditional coding, expressing concern over the increasing reliance on AI in modern programming, which they believe is reducing the creativity and problem-solving skills of programmers. The authors argue for maintaining a balance between AI and traditional coding.",
+    "The text provides information about what can be found on the author's GitHub repository, including README, About, Now, Contact, Blog, Projects, Testimonials, Privacy policy, AI usage, Contributing, and Licensing files. It also mentions an RSS newsletter for staying updated.",
+    "The text concludes by stating that all content on the GitHub repository is open-source and provides details about how to contribute."
+  ],
+  "tags": [
+    "programming",
+    "AI",
+    "traditional coding",
+    "garage",
+    "balance",
+    "open-source"
+  ],
+  "metadata": {
+    "title": "README.md",
+    "source": "file:///home/frodigo/Work/garage/README.md",
+    "date": "2025-09-19 19:25:20",
+    "id": "README.md"
+  }
+}
 ```
 
-### Formatting Problems
+### Default JSON schema
+
+At the moment JSON schema used by NiutroDigest is hardcoded and looks like this:
+
+```json
+ "format": {
+	"type": "object",
+	"properties": {
+		"summary": {
+			"title": "Summary",
+			"description": "Summarize content into simple and short sentences",
+			"type": "array",
+			"items": {
+				"type": "string"
+			}
+		},
+		"tags": {
+			"title": "Tags",
+			"description": "Extract specific technical tags: programming languages, frameworks, design patterns, algorithms, and domain areas. Prioritize concrete technologies over abstract concepts.",
+			"type": "array",
+			"items": {
+				"type": "string"
+			}
+		}
+	},
+	"required": [
+		"summary",
+		"tags"
+	]
+}
 
-**Inconsistent bullet points or structure:**
-
-- Use custom prompt templates for better control
-- Consider two-pass processing for format refinement
+```
 
 ## Next Steps
 

Projects/Nitrodigest/Docs/Guides/Using a Custom Configuration.md

@@ -84,6 +84,17 @@ nitrodigest  document.txt --prompt-file my-template.txt --prompt "Quick summary
 ```
 
 More about prompt configuration: [Overriding Prompt Templates](Overriding%20Prompt%20Templates.md)
+
+### Output format
+
+**Default:** `text`
+
+Change output format to `json`:
+
+```bash
+nitrodigest  document.txt --format json
+```
+
 ## Setting Up Default Configurations
 
 ### Environment Variables

Projects/Nitrodigest/Docs/NitroDigest – Documentation.md

@@ -9,6 +9,7 @@ permalink: projects/nitrodigest/docs
 
 - **Local AI Summarization:** Uses Ollama to run LLMs on your machine, preserving privacy and working offline.
 - **Multiple Input Formats:** Supports plain text, Markdown, HTML, CSV, JSON, and other text-based files.
+- **Multiple Output Formats: By default NitroDigest returns Text, but for advanced processing it can return JSON.
 - **Batch Processing:** Summarize a single file or all files in a directory in one command.
 - **Configurable Prompts:** Uses prompt templates that you can customize to change the style or content of summaries.
 - **Extensible:** Easily switch to different models (e.g., use a larger or domain-specific Ollama model) and adjust token budgets or segmentation for large inputs.

Projects/Nitrodigest/README.md

@@ -8,19 +8,10 @@ This project is in alpha phase.
 
 ## Features
 
-- Runs 100 % on‑device with Ollama – your mail never leaves localhost
+- Runs 100 % on‑device with Ollama – your private data never leaves localhost
 - Command-line interface with various options
 - Completely free (open source, MIT license)
 
-## Ideas for next steps
-
-- Add Terminal UI and/or simple web app
-- More summary personalization options
-- Explore ML models for summarization
-- API & Authorization
-- Show use cases for various data sources: Github (Issues/PRs), Jira, Slack, Discord
-- Extract valuable code snippets, new terms and trends from data sources
-
 ---
 
 ## Usage
@@ -72,6 +63,7 @@ Available arguments:
 - `--prompt`: Direct prompt content (overrides prompt-file)
 - `--model`: Model that will be used for summarization (default: mistral)
 - `--ollama_api_url`: URL of Ollama API (default: <http://localhost:11434>)
+- `--format`: Output format. Can be `text` or `json` (default: text)"
 
 ### Custom Prompt Configuration
 

Projects/Nitrodigest/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = nitrodigest-cli
-version = 0.1.9
+version = 0.2.0
 author = Marcin Kwiatkowski
 author_email = marcin@frodigo.com
 description = The privacy‑first, local‑LLM text‑summariser for developers.

Projects/Nitrodigest/src/cli/__init__.py

@@ -1,6 +1,6 @@
 """nitrodigest CLI package"""
 
-__version__ = "0.1.9"
+__version__ = "0.2.0"
 
 from .main import main
 from .config import Config