CLI Tooling, Scaffolding & Automation Manual

A. tasleemat init (Workspace Scaffolding)

Scaffolds an isolated project repository pre-tailored to your governance tier (1, 2, or 3) and delivery archetype pack. For every required deliverable, the CLI generates the complete 5-asset bundle: Template (Markdown), Practitioner Guide (Markdown), Realistic Example (Markdown), Companion Schema (JSON Draft 2020-12), and Data Dictionary (CSV).

# Interactive wizard mode (prompts for project metadata)
tasleemat init

# Full headless automation flags (e.g. Tier 2 Agile Project in Arabic)
tasleemat init \
  --tier 2 \
  --pack agile \
  --lang ar \
  --code "PRJ-2026-CLOUD" \
  --name "منصة التحول الرقمي السحابي" \
  --pm "سارة الأحمد" \
  --sponsor "د. خالد المنصور" \
  --out ./projects/PRJ-2026-CLOUD \
  --force

# Enterprise Tier 1 Hybrid Project with Bilingual (both) Deliverables
tasleemat init \
  --tier 1 \
  --pack hybrid \
  --lang both \
  --code "PRJ-CORE-MIGRATE" \
  --name "Core Banking Replacement Program" \
  --pm "Fahad Al-Harbi" \
  --sponsor "Chief Operating Officer" \
  --out ./enterprise_workspace

B. tasleemat list & search (Catalog Exploration)

Inspect the 114 canonical deliverables directly from your terminal. Supports phase filtering, tier filtering, and JSON output formatting for piping into jq.

# List all 114 deliverables in English or Arabic
tasleemat list --lang en
tasleemat list --lang ar

# Filter by project lifecycle phase code (00 to 07)
tasleemat list --phase 04 --lang en

# Filter by tier and pack
tasleemat list --tier 3 --pack agile

# Output catalog as machine-readable JSON array
tasleemat list --json | jq '.[0]'

# Full-text fuzzy search across deliverable titles, keywords, and IDs
tasleemat search "Charter"
tasleemat search "ميثاق" --lang ar
tasleemat search "PMO-04.08.02"

C. tasleemat config (AI Model Credentials Management)

Securely configure LLM provider API credentials and default models for automated document synthesis. All tokens are stored locally in ~/.tasleemat/config.json with POSIX permissions 0600.

# Configure Google Gemini
tasleemat config set --provider gemini --model gemini-2.5-flash --key "AIzaSy..."

# Configure OpenAI
tasleemat config set --provider openai --model gpt-4o --key "sk-proj-..."

# Configure Anthropic Claude
tasleemat config set --provider anthropic --model claude-3-5-sonnet-20241022 --key "sk-ant-..."

# Configure Local Ollama Endpoint (Air-Gapped / High-Security Setup)
tasleemat config set --provider ollama --model llama3.2 --endpoint "http://localhost:11434"

# Display configured providers (keys are automatically masked with asterisks)
tasleemat config show

# Reset credentials for a specific provider
tasleemat config reset --provider openai

D. tasleemat generate (Automated Document Synthesis)

Synthesize compliant markdown deliverables from raw meeting notes or text requirements using your configured LLM provider. Also features an offline --mock mode for test environments.

# Generate Project Charter (PMO-03.01) from kick-off notes file
tasleemat generate \
  --form PMO-03.01 \
  --notes ./kickoff_notes.txt \
  --lang en \
  --out ./Project_Charter.md

# Pipe notes directly from stdin (ideal for shell automation)
cat << 'EOF' | tasleemat generate --form PMO-04.08.02 --lang ar --out ./Risk_Register.md -
المشروع يواجه احتمالية تأخر وصول الخوادم بنسبة 40%، مما قد يعطل الإطلاق أسبوعين.
المسؤول عن المتابعة هو مهندس البنية التحتية.
EOF

# Offline mock mode for CI/CD test runs (zero tokens consumed, runs in 50ms)
tasleemat generate \
  --form PMO-03.01 \
  --notes "Mock input data" \
  --mock \
  --out ./mock_charter.md

E. tasleemat test & tasleemat mcp

Execute internal verification suites or launch the stdio Model Context Protocol (MCP) server for IDE integration:

# Run complete automated test suite (140+ unit and integration checks)
tasleemat test -v

# Run tests with fail-fast mode
tasleemat test -v --failfast

# Start the Model Context Protocol stdio server for Claude Desktop / Cursor
tasleemat mcp

F. tasleemat tui (Interactive Bilingual Terminal Workstation)

Launch the full-featured, mouse-aware, keyboard-driven Terminal User Interface built on Textual. Features true bilingual Arabic BiDi cursor & shaping, live Markdown and JSON schema preview, interactive project scaffolding, Stage-Gate exit checklists, AI synthesis playground, and 1-click workspace setup for 8 AI agent tools.

# Install with TUI dependencies (Textual, arabic-reshaper, python-bidi)
pip install "tasleemat[tui]"

# Launch the interactive terminal workstation
tasleemat tui

# Launch directly in Arabic mode
tasleemat tui --lang ar

# Command alias
tasleemat ui

G. tasleemat audit (Project Governance & Structural Verification)

Deterministic compliance auditing for any scaffolded PMO workspace. Analyzes deliverable presence against governance tiers (1, 2, or 3) and delivery packs, computes completion percentages, validates JSON payloads against companion schemas (Draft 2020-12), and produces structured JSON for CI/CD gates.

# Audit the current project directory with auto-detected Tier & Pack
tasleemat audit

# Audit a specific directory with explicit rules and strict CI/CD exit code
tasleemat audit ./projects/PRJ-2026-CLOUD --tier 2 --pack agile --strict

# Generate machine-readable JSON report for automated pipelines
tasleemat audit ./my_workspace --json --out audit_report.json

Tutorial 1: Zero-to-Production Enterprise Workspace Scaffolding

Follow this end-to-end walkthrough to create an audited project directory for a strategic healthcare transformation initiative:

1. Discover Required Deliverables: Run tasleemat list --tier 1 --pack hybrid to inspect the required 42 deliverables.
2. Scaffold the Workspace: Execute the headless initialization command:

   tasleemat init \
     --tier 1 \
     --pack hybrid \
     --lang en \
     --code "PRJ-2026-MED" \
     --name "National Health EHR Integration" \
     --pm "Dr. Mariam Al-Ghamdi" \
     --sponsor "Ministerial Steering Committee" \
     --out ./PRJ-2026-MED

3. Inspect Directory Structure: Navigate into ./PRJ-2026-MED. You will find:

   PRJ-2026-MED/
   ├── manifest.json                  # Machine-readable workspace catalog & SHA-256 hashes
   ├── 01_Initiation/
   │   ├── PMO-03.01_Project_Charter/
   │   │   ├── template.md            # Pure Markdown template with placeholder brackets
   │   │   ├── guide.md               # Practitioner authoring instructions & RACI tips
   │   │   ├── example.md             # Fully filled realistic enterprise example
   │   │   ├── schema.json            # Companion JSON Schema Draft 2020-12
   │   │   └── dictionary.csv         # Standardized field dictionary & data types
   │   └── PMO-03.02_Stakeholder_Register/
   └── ...

4. Synthesize Charter from Raw Notes: Feed your kickoff meeting notes directly into the synthesizer:

   tasleemat generate \
     --form PMO-03.01 \
     --notes ./meeting_minutes.txt \
     --out ./PRJ-2026-MED/01_Initiation/PMO-03.01_Project_Charter/template.md

Tutorial 2: Air-Gapped High-Security Enterprise Setup

For defense, banking, and government environments with zero outbound internet connectivity:

1. Transfer Wheel Package: Copy the pre-built tasleemat-2.5.0.post1-py3-none-any.whl to your air-gapped bastion host via verified removable media.
2. Offline Installation:

   pip install --no-index --find-links . tasleemat-2.5.0.post1-py3-none-any.whl

3. Configure Local Ollama Instance: Point Tasleemat to an on-premises air-gapped LLM instance:

   tasleemat config set --provider ollama --model llama3.2 --endpoint "http://10.0.50.12:11434"

4. Verify Zero Telemetry: Run tasleemat test -v. All 146 internal tests execute in memory without emitting any outbound HTTP requests.

Tutorial 3: Multi-Project Enterprise Portfolio Batch Provisioning

Use this bash automation recipe to batch-scaffold multiple project workspaces from a centralized portfolio CSV registry:

#!/usr/bin/env bash
# provision_portfolio.sh - Batch PMO Workspace Initializer
set -euo pipefail

CSV_FILE="portfolio_registry.csv"
OUTPUT_ROOT="./enterprise_pmo_workspaces"

mkdir -p "$OUTPUT_ROOT"

echo "Reading projects from $CSV_FILE..."
# CSV Format: code,name,tier,pack,lang,pm,sponsor
tail -n +2 "$CSV_FILE" | while IFS=',' read -r code name tier pack lang pm sponsor; do
    echo "=========================================================="
    echo "Scaffolding: [$code] $name (Tier $tier, Pack $pack)..."
    
    tasleemat init \
      --code "$code" \
      --name "$name" \
      --tier "$tier" \
      --pack "$pack" \
      --lang "$lang" \
      --pm "$pm" \
      --sponsor "$sponsor" \
      --out "$OUTPUT_ROOT/$code" \
      --force
      
    echo "Successfully created: $OUTPUT_ROOT/$code"
done

echo "Portfolio provisioning complete! All workspaces verified."