memd-cli 1.0.4 → 1.1.1

package/README.md

@@ -2,15 +2,36 @@
 
 > View mermaid-ed markdown in terminal
 
-## Install/Update
+## Install
 
 ```bash
 npm install -g memd-cli
 ```
 
-
 ## Usage
 
+
+```
+Usage: memd [options] [files...]
+
+Render markdown with mermaid diagrams to terminal output
+
+Arguments:
+  files             markdown file(s) to render
+
+Options:
+  -v, --version     output the version number
+  --no-pager        disable pager (less)
+  --no-color        disable colored output
+  --no-highlight    disable syntax highlighting
+  --width <number>  terminal width override
+  --ascii           use pure ASCII mode for diagrams (default: unicode)
+  -h, --help        display help for command
+```
+
+
+## Example
+
 ### File input
 
 ```
@@ -289,7 +310,7 @@ npm remove -g memd-cli
 
 ```bash
 # tag
-npm install -g git+https://github.com/ktrysmt/memd.git#v1.0.4
+npm install -g git+https://github.com/ktrysmt/memd.git#v1.1.0
 # branch
 npm install -g git+https://github.com/ktrysmt/memd.git#master
 npm install -g git+https://github.com/ktrysmt/memd.git#feature

package/main.js

@@ -43,6 +43,9 @@ function convertMermaidToAscii(markdown, options = {}) {
       if (options.width) {
         mermaidOptions.maxWidth = options.width;
       }
+      if (options.ascii) {
+        mermaidOptions.useAscii = true;
+      }
       const asciiArt = renderMermaidAscii(code.trim(), mermaidOptions);
       return '```text\n' + asciiArt + '\n```';
     } catch (error) {
@@ -126,13 +129,14 @@ function spawnPager(text, options) {
 async function main() {
   program
     .name('memd')
-    .version(packageJson.version)
+    .version(packageJson.version, '-v, --version', 'output the version number')
     .description('Render markdown with mermaid diagrams to terminal output')
     .argument('[files...]', 'markdown file(s) to render')
     .option('--no-pager', 'disable pager (less)')
     .option('--no-color', 'disable colored output')
     .option('--no-highlight', 'disable syntax highlighting')
-    .option('--width <number>', 'terminal width override', Number, process.stdout.columns ?? 80)
+    .option('--width <number>', 'terminal width override', Number)
+    .option('--ascii', 'use pure ASCII mode for diagrams (default: unicode)')
     .action(async (files, options) => {
       // Check if color should be disabled (--no-color or NO_COLOR env var)
       const useColor = options.color !== false && !process.env.NO_COLOR;
@@ -145,7 +149,7 @@ async function main() {
 
       marked.use(markedTerminal({
         reflowText: true,
-        width: options.width,
+        width: options.width ?? process.stdout.columns ?? 80,
       }, highlightOptions));
 
       // Override link renderer to avoid OSC 8 escape sequences (fixes tmux display issues)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memd-cli",
-  "version": "1.0.4",
+  "version": "1.1.1",
   "type": "module",
   "main": "main.js",
   "bin": {
@@ -10,7 +10,7 @@
     "beautiful-mermaid": "^0.1.3",
     "cli-highlight": "^2.1.11",
     "commander": "^14.0.3",
-    "marked": "^15.0.12",
+    "marked": "^17.0.3",
     "marked-terminal": "^7.3.0"
   },
   "repository": {

package/.claude/settings.json

@@ -1,7 +0,0 @@
-{
-  "permissions": {
-    "deny": [
-      "Read(./.entire/metadata/**)"
-    ]
-  }
-}

package/.claude/settings.local.json

@@ -1,12 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx:*)",
-      "Bash(npmwhoami)",
-      "Bash(LINES=20 node main.js:*)",
-      "Bash(LINES=10 node:*)",
-      "Bash(1)",
-      "Bash(DEBUG=1 node main.js:*)"
-    ]
-  }
-}

package/.serena/memories/project_overview.md

@@ -1,31 +0,0 @@
-# termaid Project Overview
-
-## Purpose
-termaid is a CLI tool that renders Mermaid diagrams in markdown files to ASCII art for terminal display. It converts ```mermaid code blocks to terminal-friendly ASCII diagrams.
-
-## Tech Stack
-- Runtime: Node.js (ES modules)
-- Markdown parser: marked + marked-terminal
-- Mermaid rendering: beautiful-mermaid
-
-## Key Files
-- main.js - Entry point (ESM module)
-- package.json - Project metadata and dependencies
-- test/ - Test markdown files
-
-## Project Structure
-```
-├── main.js           # Main CLI entry point
-├── package.json
-├── test/
-│   ├── test1.md      # Basic flowchart test
-│   ├── test2.md      # Decision flowchart test
-│   └── test3.md      # Complex diagrams (sequence, class, state)
-├── README.md
-└── .gitignore
-```
-
-## Code Style
-- ES modules (`import`/`export`)
-- No TypeScript types (has `// @ts-nocheck`)
-- Simple, functional approach

package/.serena/memories/publishing_to_npm.md

@@ -1,111 +0,0 @@
-# Publishing to npm
-
-## Current Status
-- Package name: `@ktrysmt/termaid` (Scoped package under ktrysmt org)
-- Version: 1.0.3 (from package.json)
-- Status: NOT YET published (E404 when checking registry)
-
-## Prerequisites
-
-### 1. npm Account
-- Create an account at https://www.npmjs.com/
-- Login with: `npm login`
-
-### 2. Package Name Considerations
-- `@ktrysmt/termaid` requires write access to the `ktrysmt` scope
-- If you don't have access, you can:
-  - Use a different scope: `@yourname/termaid`
-  - Use an unscoped package: `termaid` (check availability first)
-
-## Publish Steps
-
-### Step 1: Verify package.json
-Check these fields:
-```json
-{
-  "name": "@ktrysmt/termaid",
-  "version": "1.0.3",
-  "main": "main.js",
-  "bin": {
-    "termaid": "main.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ktrysmt/termaid.git"
-  }
-}
-```
-
-### Step 2: Login to npm
-```bash
-npm login
-# Follow prompts for username, password, email
-```
-
-### Step 3: Check Package Access
-```bash
-npm access ls-collaborators @ktrysmt/termaid
-```
-
-### Step 4: Publish
-```bash
-npm publish
-```
-
-### Step 5: Verify
-```bash
-npm view @ktrysmt/termaid
-npm install -g @ktrysmt/termaid
-```
-
-## Version Management
-
-### Bump version before publish:
-```bash
-# Patch (bug fixes): 1.0.2 -> 1.0.3
-npm version patch
-
-# Minor (new features): 1.0.2 -> 1.1.0
-npm version minor
-
-# Major (breaking changes): 1.0.2 -> 2.0.0
-npm version major
-```
-
-### Or manually edit package.json, then:
-```bash
-git add .
-git commit -m "chore: bump version"
-git tag v1.0.3  # or new version
-git push && git push --tags
-npm publish
-```
-
-## Private vs Public
-
-### Public (default):
-```bash
-npm publish
-# Accessible to everyone
-```
-
-### Private (requires paid plan):
-```bash
-npm publish --access restricted
-# Only accessible to collaborators
-```
-
-### Public with scoped package (free):
-```bash
-npm publish --access public
-# Works for scoped packages under free plan
-```
-
-## Common Issues
-
-| Issue | Solution |
-|-------|----------|
-| E403 Forbidden | You don't have access to this scope |
-| E409 Conflict | Version already exists, bump version |
-| ENEEDAUTH | Run `npm login` first |
-| EMISSINGARG | Missing name/version in package.json |

package/.serena/memories/suggested_commands.md

@@ -1,19 +0,0 @@
-# Suggested Commands for termaid
-
-## Testing
-- `node main.js test/test1.md` - Test with test1.md
-- `node main.js test/test2.md` - Test with test2.md
-- `echo '# Hello\n\n```mermaid\nflowchart LR\n    A --> B\n```' | node main.js` - Test with stdin
-
-## Version Management
-- Check current version: `node main.js -v`
-
-## Development
-- Install dependencies: `npm install`
-- Run with a markdown file: `node main.js <file.md>`
-
-## Publishing (to npm)
-1. Check current version in package.json
-2. Update version (e.g., `npm version patch` or `npm version minor`)
-3. Login: `npm login`
-4. Publish: `npm publish`

package/.serena/project.yml

@@ -1,115 +0,0 @@
-
-# whether to use the project's gitignore file to ignore files
-# Added on 2025-04-07
-ignore_all_files_in_gitignore: true
-# list of additional paths to ignore
-# same syntax as gitignore, so you can use * and **
-# Was previously called `ignored_dirs`, please update your config if you are using that.
-# Added (renamed) on 2025-04-07
-ignored_paths: []
-
-# whether the project is in read-only mode
-# If set to true, all editing tools will be disabled and attempts to use them will result in an error
-# Added on 2025-04-18
-read_only: false
-
-
-# list of tool names to exclude. We recommend not excluding any tools, see the readme for more details.
-# Below is the complete list of tools for convenience.
-# To make sure you have the latest list of tools, and to view their descriptions, 
-# execute `uv run scripts/print_tool_overview.py`.
-#
-#  * `activate_project`: Activates a project by name.
-#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
-#  * `create_text_file`: Creates/overwrites a file in the project directory.
-#  * `delete_lines`: Deletes a range of lines within a file.
-#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
-#  * `execute_shell_command`: Executes a shell command.
-#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
-#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
-#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
-#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
-#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
-#  * `initial_instructions`: Gets the initial instructions for the current project.
-#     Should only be used in settings where the system prompt cannot be set,
-#     e.g. in clients you have no control over, like Claude Desktop.
-#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
-#  * `insert_at_line`: Inserts content at a given line in a file.
-#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
-#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
-#  * `list_memories`: Lists memories in Serena's project-specific memory store.
-#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
-#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
-#  * `read_file`: Reads a file within the project directory.
-#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
-#  * `remove_project`: Removes a project from the Serena configuration.
-#  * `replace_lines`: Replaces a range of lines within a file with new content.
-#  * `replace_symbol_body`: Replaces the full definition of a symbol.
-#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
-#  * `search_for_pattern`: Performs a search for a pattern in the project.
-#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
-#  * `switch_modes`: Activates modes by providing a list of their names
-#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
-#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
-#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
-#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
-excluded_tools: []
-
-# initial prompt for the project. It will always be given to the LLM upon activating the project
-# (contrary to the memories, which are loaded on demand).
-initial_prompt: ""
-# the name by which the project can be referenced within Serena
-project_name: "termaid"
-
-# list of mode names to that are always to be included in the set of active modes
-# The full set of modes to be activated is base_modes + default_modes.
-# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
-# Otherwise, this setting overrides the global configuration.
-# Set this to [] to disable base modes for this project.
-# Set this to a list of mode names to always include the respective modes for this project.
-base_modes:
-
-# list of mode names that are to be activated by default.
-# The full set of modes to be activated is base_modes + default_modes.
-# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
-# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
-# This setting can, in turn, be overridden by CLI parameters (--mode).
-default_modes:
-
-# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default)
-included_optional_tools: []
-
-# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
-# This cannot be combined with non-empty excluded_tools or included_optional_tools.
-fixed_tools: []
-
-# the encoding used by text files in the project
-# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
-encoding: utf-8
-
-
-# list of languages for which language servers are started; choose from:
-#   al                  bash                clojure             cpp                 csharp
-#   csharp_omnisharp    dart                elixir              elm                 erlang
-#   fortran             fsharp              go                  groovy              haskell
-#   java                julia               kotlin              lua                 markdown
-#   matlab              nix                 pascal              perl                php
-#   php_phpactor        powershell          python              python_jedi         r
-#   rego                ruby                ruby_solargraph     rust                scala
-#   swift               terraform           toml                typescript          typescript_vts
-#   vue                 yaml                zig
-#   (This list may be outdated. For the current list, see values of Language enum here:
-#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
-#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
-# Note:
-#   - For C, use cpp
-#   - For JavaScript, use typescript
-#   - For Free Pascal/Lazarus, use pascal
-# Special requirements:
-#   Some languages require additional setup/installations.
-#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
-# When using multiple languages, the first language server that supports a given file will be used for that file.
-# The first language is the default language and the respective language server will be used as a fallback.
-# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
-languages:
-- typescript