@burakboduroglu/penote 3.0.1

package/README.md

@@ -0,0 +1,179 @@
+<div align="center">
+
+<img src="assets/penote-logo.svg" alt="penote logo" width="140">
+
+# penote
+
+**Agentic learning docs — programming notes agents and humans can both read, search, and open.**
+
+[**Install from npm →**](#install)
+
+[![CI](https://img.shields.io/github/actions/workflow/status/burakboduroglu/penote/ci.yml?branch=main&label=ci&style=flat-square)](https://github.com/burakboduroglu/penote/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/%40burakboduroglu%2Fpenote?style=flat-square&logo=npm&label=npm)](https://www.npmjs.com/package/@burakboduroglu/penote)
+[![Release](https://img.shields.io/github/v/release/burakboduroglu/penote?style=flat-square)](https://github.com/burakboduroglu/penote/releases)
+[![License](https://img.shields.io/github/license/burakboduroglu/penote?style=flat-square)](LICENSE)
+[![Last commit](https://img.shields.io/github/last-commit/burakboduroglu/penote?style=flat-square)](https://github.com/burakboduroglu/penote/commits)
+
+![Node.js](https://img.shields.io/badge/Node.js-18+-000?style=flat-square&logo=node.js)
+![Markdown](https://img.shields.io/badge/Markdown-notes-000?style=flat-square&logo=markdown)
+![Zero deps](https://img.shields.io/badge/runtime-zero_deps-000?style=flat-square)
+![CLI](https://img.shields.io/badge/CLI_+_TUI_+_Web-000?style=flat-square)
+
+</div>
+
+---
+
+Learning material that sits in plain Markdown, organised by topic, and stays usable from a terminal, a TUI, or a browser. The same files are what AI agents read through `AGENTS.md` and what you open when you need a concept again — no CMS, no build step, no dependency tree for the notes themselves.
+
+> The npm package is **`@burakboduroglu/penote`**. The CLI binary is **`penote`**.  
+> Previously published as `devnotetr` / `devnote` — that name is retired.
+
+## What it is
+
+A small library of programming notes (Java, JavaScript, Python, SQL, MongoDB) plus a zero-dependency Node.js CLI that lists, searches, and opens them. Content lives in category folders; the tooling only discovers and presents it.
+
+Notes are written in Turkish with technical terms left in English where that is clearer. The repository surface — README, contributing docs, issue forms — is English so the project sits alongside the rest of the open-source set.
+
+## Highlights
+
+|     | Feature | How it works |
+| --- | ------- | ------------ |
+| 📚 | **Topic folders** | One category per language/domain; CLI derives names from the path. |
+| 🔍 | **Search** | Filter by category and keyword from the terminal. |
+| 🖥️ | **Three surfaces** | Editor, interactive TUI, or local Web UI — same Markdown source. |
+| 🤖 | **Agent-ready** | `AGENTS.md` tells coding agents how to add notes and leave the CLI intact. |
+| 🪶 | **Zero runtime deps** | Node.js 18+ built-ins only for the CLI and a single-file Web UI. |
+| 📦 | **npm package** | `penote` on your PATH after installing `@burakboduroglu/penote`. |
+
+## Topics
+
+| Category | Covers |
+| -------- | ------ |
+| Java | Lombok, JPA / Hibernate, Spring Boot |
+| JavaScript | Array methods, closures, currying, async, regex |
+| Python | Basics, advanced topics, database operations |
+| SQL | Basic queries, advanced SQL, `psql` on the terminal |
+| MongoDB | Basic CRUD and querying |
+
+## Install
+
+**npm** — [@burakboduroglu/penote](https://www.npmjs.com/package/@burakboduroglu/penote)
+
+```bash
+bun add -g @burakboduroglu/penote
+penote help
+```
+
+**From source** — no install step required beyond [bun](https://bun.sh):
+
+```bash
+git clone https://github.com/burakboduroglu/penote.git
+cd penote
+bun library/cli.js help
+```
+
+## Quick start
+
+<img src="assets/demo.png" alt="penote list filtered to the Java category" width="820">
+
+```bash
+penote list
+penote list --cat java
+penote search hibernate
+penote open --tui
+penote open --editor
+```
+
+## CLI reference
+
+| Command | What it does |
+| ------- | ------------ |
+| `penote help` | Show commands |
+| `penote list` | List every note |
+| `penote list --cat java` | List notes in a category |
+| `penote list --cat py --search temel` | Category + keyword filter |
+| `penote search hibernate` | Search all notes |
+| `penote open 3` | Open note `#3` in the editor |
+| `penote open --tui` | Interactive TUI |
+| `penote open --editor` | Open the Web UI in a browser |
+| `penote open --browser 6` | Open note `#6` in the browser |
+
+### TUI keys
+
+`penote open --tui` is three steps: pick a category, pick a note, pick how to open it.
+
+| Key | Action |
+| --- | ------ |
+| ↑ / ↓ | Move |
+| Enter | Confirm the current step |
+| `p` | Markdown preview |
+| `e` | Open in editor |
+| `b` | Open in browser |
+| Backspace | Go back |
+| `q` | Quit |
+
+## Web UI
+
+`library/index.html` is a single-file vanilla UI: category filters, instant search, and a detail view for each note. Start it with:
+
+```bash
+penote open --editor
+# or from a clone
+bun library/cli.js open --editor
+```
+
+## Requirements
+
+- [Node.js](https://nodejs.org) 18 or newer to run the published CLI
+- [bun](https://bun.sh) for local development
+- No runtime dependencies for the CLI or Web UI
+
+## Project layout
+
+```text
+penote/                     # GitHub repo name (local folder)
+├── Java-Notes/             # Topic notes (Turkish Markdown)
+├── Javascript-Notes/
+├── Python-Notes/
+├── SQL-Notes/
+├── MongoDB-Notes/
+├── library/
+│   ├── cli.js              # CLI / TUI entry (`penote`)
+│   └── index.html          # Web UI
+├── assets/
+│   └── penote-logo.svg
+├── AGENTS.md
+├── CHANGELOG.md
+├── CODE_OF_CONDUCT.md
+├── CONTRIBUTING.md
+├── LICENSE
+├── README.md
+└── SECURITY.md
+```
+
+## Development
+
+```bash
+git clone https://github.com/burakboduroglu/penote.git
+cd penote
+bun library/cli.js list
+bun library/cli.js search hibernate
+```
+
+| Command | What it does |
+| ------- | ------------ |
+| `bun library/cli.js list` | Smoke-test note discovery |
+| `bun library/cli.js search <kw>` | Smoke-test search |
+| `bun library/cli.js open --editor` | Local Web UI |
+| `bun run start` | Same as `bun library/cli.js` |
+| `bun run dev` | Open the Web UI |
+
+CI runs the list/search smoke checks on Node 18, 20, and 22.
+
+## Contributing
+
+Bugs, note fixes, and small CLI/Web improvements are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) and the [Code of Conduct](CODE_OF_CONDUCT.md) first. Security reports go through [SECURITY.md](SECURITY.md), not the public tracker.
+
+## License
+
+[MIT](LICENSE) © Burak Boduroğlu

package/SQL-Notes/psql_on_terminal.md

@@ -0,0 +1,26 @@
+## PSQL ON TERMINAL 🚀👩‍🚀
+
+### `\l :`
+- List all databases
+
+### `\l+ :` 
+- List all databases with more details
+
+### `\c <database_name> :`
+- Connect to a database
+
+### `\dt :`
+- List all tables
+
+### `\d <table_name> :`
+- List all columns of a table
+
+### `\du :`
+- List all users
+
+### `\du+ :`
+- List all users with more details
+
+### `\q :`
+- Quit
+

package/SQL-Notes/readme.md

@@ -0,0 +1,16 @@
+### About SQL-Notes 🚀
+
+Kişisel SQL notları — Markdown formatında düzenlenmiştir.
+
+### Table of Contents 📚
+
+| File Name | Topics |
+| --------- | ------ |
+| [sql_basic_1.md](sql_basic_1.md) | Basic SQL |
+| [sql_basic_2.md](sql_basic_2.md) | WHERE clause |
+| [sql_advanced_1.md](sql_advanced_1.md) | Advanced SQL |
+| [psql_on_terminal.md](psql_on_terminal.md) | psql in the terminal |
+
+---
+
+[← README](../README.md)

package/SQL-Notes/sql_advanced_1.md

@@ -0,0 +1,92 @@
+## SQL Advanced - 1 🚀👩‍🚀
+
+### 1. SQL - Data Types
+
+- **Numeric** - `INT`, `FLOAT`, `DECIMAL`
+- **String** - `CHAR`, `VARCHAR`, `TEXT`
+- **Date/Time** - `DATE`, `DATETIME`, `TIMESTAMP`
+- **Boolean** - `BOOLEAN`
+
+### 2. SQL - Operators
+
+- **Arithmetic** - `+`, `-`, `*`, `/`, `MOD`
+- **Comparison** - `=`, `!=`, `<>`, `>`, `<`, `>=`, `<=`
+- **Logical** - `AND`, `OR`, `NOT`
+
+### 3. SQL - Functions
+
+- **Aggregate** - `COUNT`, `SUM`, `AVG`, `MIN`, `MAX`
+- **String** - `CONCAT`, `LENGTH`, `LOWER`, `UPPER`, `SUBSTRING`
+- **Date/Time** - `CURDATE`, `CURTIME`, `NOW`, `YEAR`, `MONTH`, `DAY`
+
+### 4. SQL - Constraints
+
+- **NOT NULL** - Ensures that a column cannot have a NULL value
+- **UNIQUE** - Ensures that all values in a column are different
+- **PRIMARY KEY** - A combination of a NOT NULL and UNIQUE. Uniquely identifies each row in a table
+- **FOREIGN KEY** - Uniquely identifies a row/record in another table
+- **CHECK** - Ensures that all values in a column satisfies a specific condition
+- **DEFAULT** - Sets a default value for a column when no value is specified
+- **CREATE INDEX** - Used to create and retrieve data from the database very quickly
+
+### 5. SQL - Joins
+
+- **INNER JOIN** - Returns records that have matching values in both tables
+- **LEFT JOIN** - Returns all records from the left table, and the matched records from the right table
+- **RIGHT JOIN** - Returns all records from the right table, and the matched records from the left table
+- **FULL JOIN** - Returns all records when there is a match in either left or right table
+
+### 6. SQL - Distinct
+
+- **DISTINCT** - Returns only distinct (different) values
+
+### 7. SQL - Wildcards
+
+- **%** - The percent sign represents zero, one, or multiple characters
+- **\_** - The underscore represents a single character
+- **[charlist]** - The bracket represents any single character within the brackets
+- **[!charlist]** - The exclamation mark represents any single character not in the brackets
+
+### 8. SQL - Aliases
+
+- **AS** - Used to give a table, or a column in a table, a temporary name
+
+### 9. SQL - Comments
+
+- **--** - Single line comment
+- **/\* \*/** - Multi-line comment
+
+### 10. SQL - Order By
+
+- **ORDER BY** - Used to sort the result-set in ascending or descending order
+
+### 11. SQL - Group By
+
+- **GROUP BY** - Used in conjunction with the aggregate functions to group the result-set by one or more columns
+- example: `SELECT COUNT(*), country FROM customers GROUP BY country;`
+
+### 12. SQL - Having
+
+- **HAVING** - Used with the GROUP BY clause to filter groups of rows that have a common column value
+- example: `SELECT COUNT(*), country FROM customers GROUP BY country HAVING COUNT(*) > 5;`
+
+### 13. SQL - Top
+
+- **TOP** - Used to specify the number of records to return
+- example: `SELECT TOP 3 * FROM customers;`
+
+### 14. SQL - Subqueries
+
+- **Subquery** - A query within another query and embedded within the WHERE clause
+- example: `SELECT * FROM customers WHERE country = 'USA' AND city IN (SELECT city FROM customers WHERE country = 'UK');`
+
+### 15. SQL - Check 
+
+- **CHECK** - Ensures that all values in a column satisfies a specific condition
+- example: `CREATE TABLE Persons (ID int NOT NULL, LastName varchar(255) NOT NULL, FirstName varchar(255), Age int, CHECK (Age>=18));`
+
+### 16. SQL - Unique
+
+- **UNIQUE** - Ensures that all values in a column are different
+- example: `CREATE TABLE Persons (ID int NOT NULL, LastName varchar(255) NOT NULL, FirstName varchar(255), Age int, UNIQUE (ID));`
+

package/SQL-Notes/sql_basic_1.md

@@ -0,0 +1,114 @@
+## SQL Basics - 1 🚀👩‍🚀
+
+### - Data Manipulation Commands
+
+- `SELECT` - used to retrieve data from a database
+  example:
+
+```sql
+SELECT column1, column2, ...
+FROM table_name;
+```
+
+- `UPDATE` - used to update existing data within a database
+  example:
+
+```sql
+UPDATE table_name
+SET column1 = value1, column2 = value2, ...
+WHERE condition;
+```
+
+- `DELETE` - used to delete records from a database
+  example:
+
+```sql
+DELETE FROM table_name
+WHERE condition;
+```
+
+- `INSERT INTO` - used to insert new data into a database
+  example:
+
+```sql
+INSERT INTO table_name (column1, column2, column3, ...)
+VALUES (value1, value2, value3, ...);
+```
+
+- `TRUNCATE TABLE` - used to remove all records from a table, including all spaces allocated for the records are removed
+  example:
+
+```sql
+TRUNCATE TABLE table_name;
+```
+
+---
+
+### - Database Manipulation Commands
+
+- `CREATE DATABASE` - used to create a new database
+  example:
+
+```sql
+CREATE DATABASE database_name;
+```
+
+- `ALTER DATABASE` - used to modify a database
+  example:
+
+```sql
+ALTER DATABASE database_name
+MODIFY COLUMN column_name datatype;
+```
+
+- `DROP DATABASE` - used to delete a database
+  example:
+
+```sql
+DROP DATABASE database_name;
+```
+
+- `CREATE TABLE` - used to create a new table
+  example:
+
+```sql
+CREATE TABLE table_name (
+    column1 datatype,
+    column2 datatype,
+    column3 datatype,
+     ....
+    );
+```
+
+- `ALTER TABLE` - used to modify a table
+  example:
+
+```sql
+ALTER TABLE table_name
+ADD column_name datatype;
+```
+
+- `DROP TABLE` - used to delete a table
+  example:
+
+```sql
+DROP TABLE table_name;
+```
+
+- `CREATE INDEX` - used to create an index (search key)
+  example:
+
+```sql
+CREATE INDEX index_name
+ON table_name (column_name);
+```
+
+- `DROP INDEX` - used to delete an index
+  example:
+
+```sql
+DROP INDEX index_name
+ON table_name;
+```
+
+---

package/SQL-Notes/sql_basic_2.md

@@ -0,0 +1,92 @@
+## SQL Basics - 2 🚀👩‍🚀
+
+### - "WHERE" clause
+
+- "WHERE" clause is used to filter the records based on some condition.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name = value;
+```
+
+- "WHERE" clause can be used with "AND" and "OR" operators.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name = value AND column_name = value;
+SELECT * FROM table_name WHERE column_name = value OR column_name = value;
+```
+
+- "WHERE" clause can be used with "IN" operator.
+- "IN" operator is used to specify multiple values in a "WHERE" clause.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name IN (value1, value2, value3);
+```
+
+- "WHERE" clause can be used with "BETWEEN" operator.
+- "BETWEEN" operator is used to specify a range of values in a "WHERE" clause.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name BETWEEN value1 AND value2;
+```
+
+- "WHERE" clause can be used with "LIKE" operator.
+- "LIKE" operator is used to search for a pattern in a "WHERE" clause.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name LIKE 'value%';
+```
+
+- "WHERE" clause can be used with "NOT" operator.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE NOT column_name = value;
+```
+
+- "WHERE" clause can be used with "IS NULL" operator.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name IS NULL;
+```
+
+- "WHERE" clause can be used with "IS NOT NULL" operator.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name IS NOT NULL;
+```
+
+- "WHERE" clause can be used with "ORDER BY" clause.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name = value ORDER BY column_name;
+```
+
+- "WHERE" clause can be used with "GROUP BY" clause.
+- "GROUP BY" clause is used to group the result-set by one or more columns.
+  example:
+
+```sql
+SELECT * FROM table_name WHERE column_name = value GROUP BY column_name;
+```
+
+### Table of Where Clause Operators
+
+| Operator | Description                                                                 |
+| -------- | --------------------------------------------------------------------------- |
+| =        | Equal                                                                       |
+| >        | Greater than                                                                |
+| <        | Less than                                                                   |
+| >=       | Greater than or equal                                                       |
+| <=       | Less than or equal                                                          |
+| <>       | Not equal. Note: In some versions of SQL this operator may be written as != |
+| BETWEEN  | Between a certain range                                                     |
+| LIKE     | Search for a pattern                                                        |
+| IN       | To specify multiple possible values for a column                            |

package/assets/penote-logo.svg

@@ -0,0 +1,34 @@
+<!--
+  penote mark: a geometric "pn" monogram with an AI sparkle, on a rounded
+  indigo tile. Quiet app-icon language — same family as portkill / macshelf.
+  The monogram is drawn on a 512 grid and scaled to 0.9 so the sparkle keeps
+  a clear top-right corner.
+-->
+<svg width="512" height="512" viewBox="0 0 512 512" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc">
+  <title id="title">penote logo</title>
+  <desc id="desc">Indigo rounded tile with a lowercase pn monogram and a sparkle.</desc>
+  <defs>
+    <linearGradient id="plate" x1="72" y1="40" x2="440" y2="472" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#A5B4FC"/>
+      <stop offset="0.45" stop-color="#6366F1"/>
+      <stop offset="1" stop-color="#3730A3"/>
+    </linearGradient>
+  </defs>
+
+  <rect width="512" height="512" rx="139" fill="url(#plate)"/>
+
+  <!-- pn monogram: p = stem + descender + bowl, n = stem + shoulder -->
+  <g transform="translate(25.6, 30) scale(0.9)"
+     fill="none" stroke="#0B1026" stroke-width="44" stroke-linecap="round">
+    <path d="M108 144 V368"/>
+    <path d="M108 144 A98 78 0 0 1 108 300"/>
+    <path d="M280 300 V206"/>
+    <path d="M280 206 A62 62 0 0 1 404 206 V300"/>
+  </g>
+
+  <!-- AI sparkle -->
+  <path
+    d="M412 62 C412 95 419 102 452 102 C419 102 412 109 412 142
+       C412 109 405 102 372 102 C405 102 412 95 412 62 Z"
+    fill="#F8FAFF"/>
+</svg>