markdown_exec 3.5.1 → 3.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6becba5a0ff94fb60399da0fc99248fff83905def9c65e4a8e1ae9c597652036
-  data.tar.gz: 98f0d4ad3764fec26b4ed8f1bce1904af1f350853b3e2678847f0557b381e8bf
+  metadata.gz: 70772e4552a37222c8f9655c19d0c4938ef57a2abc786987d4b8220608aeb3b5
+  data.tar.gz: 7afe1c005a8d079e0d55ba36ccfd83e669665d038182c2d465e027ba5e7f46f7
 SHA512:
-  metadata.gz: b2d1d60bcf1fe258a8be76893b070ab418563e27923c9e8a4370cd04fa5e0d421732c3c51e76e596a5d492885170270437916035530f64ba2e99a98d215bd908
-  data.tar.gz: 306d802cfcfc5bfa9460e2d58a69ac4f9ac0c058a28859243a237682d2622549277ff6f8515f84c51b2a2ede229c3f95eaa9a0ce5b9dbde98bfc2ad862c9aa8f
+  metadata.gz: b5ce74d1d56a732a6877d6dca7fd188e33b87fdbeccc6f3762281edfef9d53c525bcefb293931ec1cefa0e9176e45ef83d9a0c285589051169c15c8f2305a07d
+  data.tar.gz: 3798f4dfb87aeabb8e450bbb8790a72903a181f1171028042725f6231b90cc59605a88445c59a9e5178789a6b7d456060407ace48639f8b11b2b1ec385b8c23b

data/.ai-agent-instructions

@@ -0,0 +1,54 @@
+# AI Agent Instructions - Read First!
+
+## ⚠️ CRITICAL: Mandatory Acknowledgment
+
+**YOU MUST** preface EVERY response with:
+
+**"Observing AI principles!"**
+
+This confirms you have read and will follow the AI-First Principles.
+
+## 📋 Required Actions at Start of Each Session
+
+1. **Acknowledge**: Preface response with "Observing AI principles!"
+2. **Read**: `ai-principles.md` - Complete principles and process guide
+3. **Review**: `semantic-tokens.md` - Token registry
+4. **Check**: `tasks.md` - Active task tracking
+5. **Understand**: Priority levels (P0 > P1 > P2 > P3)
+
+## 🎯 Core Requirements
+
+- Use semantic tokens `[REQ:*]`, `[ARCH:*]`, `[IMPL:*]` throughout
+- Expand requirements into pseudo-code BEFORE coding
+- Break work into trackable tasks with priorities
+- Cross-reference everything using semantic tokens
+- Follow priority order: Tests > Code > Basic Functions > Infrastructure
+
+## 📚 Key Files
+
+- `ai-principles.md` - **READ THIS FIRST**
+- `requirements.md` - Requirements with `[REQ:*]` tokens
+- `architecture-decisions.md` - **Semantic-token-linked architecture decisions dependent on requirements**
+  - Records all `[ARCH:*]` tokens
+  - Cross-references `[REQ:*]` tokens
+- `implementation-decisions.md` - **Semantic-token-linked implementation decisions dependent on architecture and requirements**
+  - Records all `[IMPL:*]` tokens
+  - Cross-references both `[ARCH:*]` and `[REQ:*]` tokens
+- `semantic-tokens.md` - Token registry
+- `tasks.md` - Task tracking
+- `.cursorrules` - Cursor IDE rules (auto-loaded)
+
+## ✅ Example Response Format
+
+```
+Observing AI principles!
+
+I have read ai-principles.md and will follow all documented processes.
+
+[Your response here using semantic tokens and following the process]
+```
+
+---
+
+**This file is a reminder. The complete rules are in `ai-principles.md` and `.cursorrules`.**
+

data/.cursorrules

@@ -0,0 +1,198 @@
+# Cursor AI Agent Rules for STDD Projects
+
+**STDD Methodology Version**: 1.0.0
+
+## 🎯 Semantic Token-Driven Development (STDD)
+
+This project follows **Semantic Token-Driven Development (STDD)**, where semantic tokens (`[REQ:*]`, `[ARCH:*]`, `[IMPL:*]`) are the central mechanism for preserving intent throughout the development lifecycle. Semantic tokens create a traceable chain of intent from requirements → architecture → implementation → tests → code, ensuring the original purpose and reasoning are never lost.
+
+## ⚠️ MANDATORY: AI Principles Acknowledgment
+
+**YOU MUST** acknowledge that you have read and will follow the AI principles at the start of EVERY response by prefacing with:
+
+**"Observing AI principles!"**
+
+Then proceed to:
+1. Read `ai-principles.md` if not already read in this session
+2. Check `semantic-tokens.md` for existing tokens
+3. Review `tasks.md` for active tasks
+4. Follow all principles throughout your response
+
+## 🎯 Core Principles
+
+1. **Always Reference ai-principles.md**
+   - Read `ai-principles.md` at the start of each session
+   - Acknowledge with "Observing AI principles!" at the start of every response
+   - Follow the documented development process
+   - Use semantic tokens consistently
+
+2. **Semantic Token System** (Core to STDD)
+   - Semantic tokens are the mechanism that preserves intent throughout the development lifecycle
+   - Use semantic tokens for all cross-referencing
+   - Format: `[TYPE:IDENTIFIER]` (e.g., `[REQ:MONITOR]`, `[IMPL:ASYNC_EXECUTION]`)
+   - Reference tokens in code comments, test names, and documentation
+   - Update `semantic-tokens.md` when creating new tokens
+   - Maintain traceability: Requirements → Architecture → Implementation → Tests → Code
+
+3. **Development Process**
+   - **Phase 1**: Expand requirements into pseudo-code and decisions (NO code changes)
+   - **Phase 2**: Break down into trackable tasks with priorities
+   - **Phase 3**: Implement tasks, starting with highest priority
+   - Always cross-reference using semantic tokens
+
+4. **Task Management**
+   - Break work into trackable tasks in `tasks.md`
+   - Assign priorities: P0 (Critical) > P1 (Important) > P2 (Nice-to-have) > P3 (Future)
+   - Remove subtasks when parent task completes
+   - Always include semantic token references
+
+5. **Priority Order**
+   - **Most Important**: Tests, Code, Basic Functions
+   - **Least Important**: Environment Orchestration, Enhanced Security, Automated Deployment
+
+## 📝 Documentation Requirements
+
+### ⚠️ CRITICAL: Documentation is MANDATORY, Not Optional
+
+**Documentation updates are REQUIRED at every stage of development. They are not optional or deferrable.**
+
+### Required Sections in All Documentation
+
+1. **Requirements** - with `[REQ:*]` tokens (in `requirements.md`)
+2. **Architecture Decisions** - with `[ARCH:*]` tokens (in `architecture-decisions.md`)
+   - **MUST** be recorded in `architecture-decisions.md` IMMEDIATELY when made
+   - **MUST** cross-reference `[REQ:*]` tokens
+   - Architecture decisions are dependent on requirements
+   - **DO NOT** defer architecture documentation - record it as you make decisions
+3. **Implementation Decisions** - with `[IMPL:*]` tokens (in `implementation-decisions.md`)
+   - **MUST** be recorded in `implementation-decisions.md` IMMEDIATELY when made
+   - **MUST** cross-reference both `[ARCH:*]` and `[REQ:*]` tokens
+   - Implementation decisions are dependent on both architecture and requirements
+   - **DO NOT** defer implementation documentation - record it as you make decisions
+4. **Semantic Token Registry** - maintained in `semantic-tokens.md`
+   - **MUST** be updated immediately when creating new tokens
+5. **Task Planning** - maintained in `tasks.md`
+   - **MUST** be updated when planning new work
+   - **MUST** be updated when completing tasks
+   - **MUST** include semantic token references
+6. **Code References** - semantic tokens in code comments
+7. **Test References** - semantic tokens in test names/comments
+
+### Documentation Update Checklist (MANDATORY)
+
+**When making ANY architectural decision:**
+- [ ] Record in `architecture-decisions.md` with `[ARCH:*]` token
+- [ ] Cross-reference relevant `[REQ:*]` tokens
+- [ ] Update `semantic-tokens.md` if new token created
+
+**When making ANY implementation decision:**
+- [ ] Record in `implementation-decisions.md` with `[IMPL:*]` token
+- [ ] Cross-reference relevant `[ARCH:*]` and `[REQ:*]` tokens
+- [ ] Update `semantic-tokens.md` if new token created
+
+**When planning new work:**
+- [ ] Create tasks in `tasks.md` BEFORE starting implementation
+- [ ] Assign priorities to all tasks
+- [ ] Include semantic token references in task descriptions
+- [ ] Break down into subtasks if needed
+
+**When completing work:**
+- [ ] Mark tasks complete in `tasks.md`
+- [ ] Remove completed subtasks
+- [ ] Verify all documentation is up-to-date
+- [ ] Ensure all semantic tokens are documented
+
+### Cross-Reference Format
+
+When referencing tokens:
+```go
+// [REQ:DUPLICATE_PREVENTION] Skip if text matches lastText
+// [IMPL:DUPLICATE_PREVENTION] [REQ:DUPLICATE_PREVENTION]
+```
+
+Test names:
+```go
+func TestDuplicatePrevention_REQ_DUPLICATE_PREVENTION(t *testing.T)
+```
+
+## 🔄 Before Starting Work
+
+1. **MANDATORY**: Read `ai-principles.md`
+2. **MANDATORY**: Check `semantic-tokens.md` for existing tokens
+3. **MANDATORY**: Review `tasks.md` for active tasks
+4. **MANDATORY**: Review `architecture-decisions.md` for existing architecture decisions
+5. **MANDATORY**: Review `implementation-decisions.md` for existing implementation decisions
+6. Understand priority levels
+7. **MANDATORY**: Plan work in `tasks.md` BEFORE writing any code
+
+## ⚙️ During Work
+
+1. Use semantic tokens in all code comments
+2. Use semantic tokens in test names/comments
+3. Cross-reference: Requirements → Architecture → Implementation → Tests
+4. **MANDATORY**: Break work into trackable tasks in `tasks.md` BEFORE starting implementation
+5. **MANDATORY**: Assign appropriate priorities to all tasks
+6. **MANDATORY**: Update documentation AS YOU WORK:
+   - Record architecture decisions in `architecture-decisions.md` immediately when made
+   - Record implementation decisions in `implementation-decisions.md` immediately when made
+   - Update `tasks.md` when planning new work or completing tasks
+   - Update `semantic-tokens.md` when creating new tokens
+   - **DO NOT** defer documentation updates until the end
+
+## ✅ After Completing Work
+
+1. **MANDATORY**: All semantic tokens documented in `semantic-tokens.md`
+2. **MANDATORY**: Documentation updated with implementation status:
+   - `architecture-decisions.md` updated with any new `[ARCH:*]` decisions
+   - `implementation-decisions.md` updated with any new `[IMPL:*]` decisions
+   - Both must cross-reference `[REQ:*]` tokens
+3. **MANDATORY**: Tests reference semantic tokens
+4. **MANDATORY**: Tasks marked complete in `tasks.md`
+5. **MANDATORY**: Subtasks removed from completed tasks
+6. **MANDATORY**: All documentation reflects current state (no stale information)
+
+## 🚫 What NOT to Do
+
+- Don't write code before expanding requirements into pseudo-code
+- Don't skip semantic token cross-referencing
+- Don't create tasks without priorities
+- Don't leave subtasks after parent task completes
+- Don't implement P2/P3 features before P0/P1 are complete
+
+## 📚 Key Files
+
+**Note**: These file names refer to your project's files. Copy the corresponding `.template.md` files from the STDD repository to your project.
+
+- `ai-principles.md` - Complete principles and process guide (reference from STDD repository)
+- `requirements.md` - Requirements with `[REQ:*]` tokens (copy from `requirements.template.md`)
+- `architecture-decisions.md` - **Semantic-token-linked record of architecture decisions dependent on requirements** (copy from `architecture-decisions.template.md`)
+  - All `[ARCH:*]` tokens must be documented here
+  - Must cross-reference `[REQ:*]` tokens
+- `implementation-decisions.md` - **Semantic-token-linked record of implementation decisions dependent on architecture and requirements** (copy from `implementation-decisions.template.md`)
+  - All `[IMPL:*]` tokens must be documented here
+  - Must cross-reference both `[ARCH:*]` and `[REQ:*]` tokens
+- `semantic-tokens.md` - Central registry of all tokens (copy from `semantic-tokens.template.md`)
+- `tasks.md` - Active task tracking (copy from `tasks.template.md`)
+
+## 🎯 Example Workflow
+
+1. **User Request**: "Add disk space checking"
+2. **AI Response (Planning Phase - NO CODE YET)**: 
+   - Creates `[REQ:DISK_SPACE_CHECK]` token in `requirements.md`
+   - Expands into pseudo-code and decisions
+   - **IMMEDIATELY** documents architecture decisions in `architecture-decisions.md` with `[ARCH:*]` tokens cross-referencing `[REQ:DISK_SPACE_CHECK]`
+   - **IMMEDIATELY** documents implementation decisions in `implementation-decisions.md` with `[IMPL:*]` tokens cross-referencing both `[ARCH:*]` and `[REQ:*]` tokens
+   - **IMMEDIATELY** updates `semantic-tokens.md` with all new tokens
+   - **IMMEDIATELY** creates tasks in `tasks.md` with P1 priority and semantic token references
+   - **NO code changes yet**
+3. **User Approval**: User reviews and approves planning documents
+4. **Implementation Phase**: 
+   - AI implements tasks, starting with highest priority
+   - **DURING implementation**: Updates documentation as decisions are made or refined
+   - **DURING implementation**: Updates `tasks.md` as subtasks are completed
+5. **Completion Phase**: 
+   - **MANDATORY**: Verifies all documentation is up-to-date
+   - **MANDATORY**: Marks tasks complete in `tasks.md`
+   - **MANDATORY**: Removes completed subtasks
+   - **MANDATORY**: Ensures all semantic tokens are documented
+

data/.rubocop.wide.yml

@@ -0,0 +1,5 @@
+inherit_from:
+  - .rubocop.yml
+
+Layout/LineLength:
+  Max: 200

data/.rubocop.yml

@@ -14,10 +14,15 @@ Layout/LineContinuationLeadingSpace:
   Enabled: false
 
 Layout/LineLength:
+  AllowHeredoc: true          # optional
+  AllowURI: true              # optional
+  AllowedPatterns:
+    - '^\s*#'
+    - '^[^#]*#'
   # Enabled: false
+  # IgnoreComments: true        # ← THIS is what you want
+  IgnoreCopDirectives: true   # optional, but useful
   Max: 80
-  # Max: 96
-  # Max: 120
 
 Lint/Debugger:
   Enabled: false

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [3.5.2]
+
+### Added
+
+- Option for hiding shebang lines.
+
+### Changed
+
+- Fix inherited code from activated UX blocks.
+- Improve BATS test names.
+
 ## [3.5.1] - 2025-11-14
 
 ### Added
@@ -983,7 +994,7 @@ e.g. `MDE_OUTPUT_VIEWER_OPTIONS="-a '/Applications/Sublime Text.app'" mde --sele
 
 | YAML Name | Environment Variable | Default |
 | :--- | :--- | :--- |
-| block_name_hidden_match | MDE_BLOCK_NAME_HIDDEN_MATCH  | `^\(.+\)$` |
+| block_name_hide_custom_match | MDE_BLOCK_NAME_HIDE_CUSTOM_MATCH  | `^\(.+\)$` |
 | block_name_match | MDE_BLOCK_NAME_MATCH  | `:(?<title>\S+)( \|$)` |
 | block_required_scan | MDE_BLOCK_REQUIRED_SCAN  | `\+\S+` |
 | fenced_start_and_end_regex | MDE_FENCED_START_AND_END_REGEX  | ``^`{3,}`` |

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    markdown_exec (3.5.1)
+    markdown_exec (3.5.2)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)

data/Rakefile

@@ -138,6 +138,7 @@ task :minitest do
     './lib/collapser.rb --verbose',
     './lib/directory_searcher.rb --verbose',
     './lib/evaluate_shell_expressions.rb --verbose',
+    './lib/executed_shell_command.rb --verbose',
     './lib/fcb.rb --verbose',
     './lib/filter.rb --verbose',
     './lib/find_files.rb',
@@ -155,6 +156,7 @@ task :minitest do
     './lib/saved_files_matcher.rb --verbose',
     './lib/table_extractor.rb --verbose',
     './lib/text_analyzer.rb --verbose',
+    './lib/transformed_shell_command.rb --verbose',
     './lib/ww.rb --verbose'
   ]