# 📐 LAR Project Command Philosophy
The `lar` toolset is built around a core principle of **clarity through consistency**. Each tool follows a common command-line structure that helps users easily remember, predict, and script interactions across the suite.
Inspired by the ISO 8601 date format (`YYYY-MM-DD`), the CLI design uses a "largest to smallest" structure:
---
## 🧭 General Command Format
```
<tool> [scope] [targets] [modifiers]
```
### 🆕 Interactive Guidance System
All AFN tools feature an Excel-like command guidance system:
```bash
$ smv -snake . pdf
[smv] [-snake] [. pdf] [preview|recursive|force]
cmd scope targets modifiers (optional)
```
- **F1**: Context-sensitive help for current position
- **Tab**: Cycle through valid options
- **Backspace**: Navigate to previous position
- Real-time validation and option preview
### 🔄 Segments Explained
| **Scope** | Primary operation (single flag) | `-template`, `-sort`, `-scan`, `-snake` |
| **Targets** | What to operate on | `src/`, `main.rs`, `~/projects`, `. pdf txt` |
| **Modifiers** | How to execute (optional) | `preview`, `force`, `recursive` |
This structure ensures your commands flow logically from intent ➜ customization ➜ subject.
---
## 🧩 Tool-by-Tool Consistency
### `mkr` – File/Folder Creation
```sh
mkr -template rust-cli mytool git readme
```
* Scope: `-template`
* Target: `rust-cli mytool`
* Modifiers: `git readme`
### `smv` – Move, Rename, Organize
```sh
smv -sort downloads/ preview
smv -snake . pdf txt recursive
smv -move *.pdf ~/backup/
```
* Scope: `-sort`, `-snake`, `-move`
* Targets: `downloads/`, `. pdf txt`, `*.pdf ~/backup/`
* Modifiers: `preview`, `recursive`
### `xfd` – Search and Filter
```sh
xfd -name ~/vault "*.md" limit 10
```
* Scope: `-name`
* Targets: `~/vault "*.md"`
* Modifier: `limit 10`
### `inx` – Indexing and Metadata
```sh
inx -scan ~/projects depth 3
```
* Scope: `-scan`
* Target: `~/projects`
* Modifier: `depth 3`
---
## ✅ Universal Behaviors
* **AFN REPL Integration**: All tools work within AFN REPL environment
* **Interactive Guidance**: Excel-like command preview with F1 help and Tab completion
* **Position-based Parsing**: Sequence and quantity constraints eliminate ambiguity
* **No `--` Clutter**: After scope, flags are simple words (`preview`, `recursive`)
* **Inference**: Smart detection of intent (e.g., file vs. folder in `mkr`)
* **Parent Directory Creation**: Default on (like `mkdir -p`)
* **Preview / Dry-run Mode**: Available as `preview` modifier in most tools
* **Undo**: Built-in where destructive actions may occur (e.g., `-undo` scope)
* **Fallback to TUI**: If run with no arguments, tools may launch TUI or interactive mode
---
## 🔁 AFN REPL Workflow
AFN serves as the unified entry point for all tools:
```bash
$ afn
AFN> smv -snake . pdf preview
AFN> mkr -template rust-cli mytool
AFN> xfd -name ~/vault "*.md"
AFN> exit
$
```
* **Persistent context**: REPL remembers project state
* **Tool discovery**: Tab completion shows all available AFN tools
* **Cross-tool workflows**: Chain operations without re-prefixing
* **Consistent guidance**: Same interactive help system across all tools
---
This command philosophy helps every `lar` tool feel familiar while remaining powerful and focused. Write once, remember forever.