Add T01 vault structure tests with Bats framework

src/vault.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# Vault Structure & Scaffolding Functions
+#
+# Implements F01: Vault Structure & Scaffolding
+# See requirements/F01-vault-structure.md for specifications.
+
+# Enable strict mode only when executed directly, not when sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    set -euo pipefail
+fi
+
+# =============================================================================
+# Constants
+# =============================================================================
+
+# Expected top-level folders
+readonly VAULT_FOLDERS=(
+    ".claude"
+    "0_Inbox"
+    "1_Fleeting"
+    "2_Drafts"
+    "3_Projects"
+    "4_Areas"
+    "5_Resources"
+    "6_Archive"
+    "7_Assets"
+    "8_People"
+    "9_Meta"
+)
+
+# Expected meta files
+readonly META_FILES=(
+    "config.yaml"
+    "memory.md"
+    "pending.json"
+    "state.json"
+)
+
+# =============================================================================
+# scaffold_vault
+# =============================================================================
+# Creates the complete vault folder structure at the given path.
+# Idempotent: safe to run multiple times without affecting existing files.
+#
+# Arguments:
+#   $1 - Path to the vault root directory
+#
+# Returns:
+#   0 on success
+#   1 on failure
+# =============================================================================
+scaffold_vault() {
+    local vault_path="$1"
+
+    # TODO: Implement vault scaffolding
+    # 1. Create all top-level folders from VAULT_FOLDERS
+    # 2. Create 6_Archive/Daily-Notes/ subfolder
+    # 3. Create 9_Meta/prompts/ subfolder
+    # 4. Create meta files (config.yaml, memory.md, pending.json, state.json)
+    # 5. Must be idempotent - don't overwrite existing files
+
+    echo "scaffold_vault: Not yet implemented" >&2
+    return 1
+}
+
+# =============================================================================
+# validate_vault_structure
+# =============================================================================
+# Validates that a vault has the correct structure.
+#
+# Arguments:
+#   $1 - Path to the vault root directory
+#
+# Returns:
+#   0 if valid, outputs "Vault structure valid"
+#   1 if invalid, outputs list of issues
+# =============================================================================
+validate_vault_structure() {
+    local vault_path="$1"
+
+    # TODO: Implement vault validation
+    # 1. Check all expected folders exist
+    # 2. Check folder naming convention (N_Name pattern)
+    # 3. Check meta files exist
+    # 4. Report all missing or invalid items
+
+    echo "validate_vault_structure: Not yet implemented" >&2
+    return 1
+}

tests/fixtures/test-vault-populated/0_Inbox/2025-01-31 Friday.md

@@ -0,0 +1,22 @@
+---
+type: daily
+date: 2025-01-31
+day_of_week: Friday
+status: active
+morning_brief_done: false
+evening_review_done: false
+---
+
+# 2025-01-31 Friday
+
+## Morning Brief
+
+
+## Captures
+
+
+## Notes
+
+
+## Evening Review
+

tests/fixtures/test-vault-populated/1_Fleeting/sample-fleeting.md

@@ -0,0 +1,10 @@
+---
+type: fleeting
+created: 2025-01-31T10:00:00-05:00
+source: manual
+status: unprocessed
+---
+
+# Sample Fleeting Note
+
+This is a sample fleeting note for testing purposes.

tests/fixtures/test-vault-populated/3_Projects/test-project/test-project.md

@@ -0,0 +1,21 @@
+---
+type: project
+title: Test Project
+status: active
+created: 2025-01-15T09:00:00-05:00
+area: "[[test-area]]"
+---
+
+# Test Project
+
+## Overview
+
+A sample project for testing vault structure.
+
+## Tasks
+
+- [ ] Sample task 1
+- [ ] Sample task 2
+
+## Notes
+

tests/fixtures/test-vault-populated/4_Areas/test-area.md

@@ -0,0 +1,10 @@
+---
+type: area
+title: Test Area
+status: active
+created: 2025-01-01T00:00:00-05:00
+---
+
+# Test Area
+
+An area of responsibility for testing purposes.

tests/fixtures/test-vault-populated/6_Archive/Daily-Notes/2025/01/2025-01-30 Thursday.md

@@ -0,0 +1,27 @@
+---
+type: daily
+date: 2025-01-30
+day_of_week: Thursday
+status: archived
+morning_brief_done: true
+evening_review_done: true
+archived_at: 2025-01-31T06:00:00-05:00
+---
+
+# 2025-01-30 Thursday
+
+## Morning Brief
+
+Completed morning brief.
+
+## Captures
+
+- Sample capture from yesterday
+
+## Notes
+
+- Notes from the day
+
+## Evening Review
+
+Day completed and reviewed.

tests/fixtures/test-vault-populated/8_People/jane-smith.md

@@ -0,0 +1,23 @@
+---
+type: person
+name: Jane Smith
+email: jane.smith@example.com
+company: Example Corp
+last_contact: 2025-01-28
+created: 2025-01-15T00:00:00-05:00
+---
+
+# Jane Smith
+
+## Contact Info
+
+- Email: jane.smith@example.com
+- Company: Example Corp
+
+## Notes
+
+Met at conference in January 2025.
+
+## Interactions
+
+- 2025-01-28: Email exchange about project collaboration

tests/fixtures/test-vault-populated/9_Meta/config.yaml

@@ -0,0 +1,28 @@
+# Digital Cortex Configuration
+
+vault:
+  name: "Test Vault"
+  timezone: "America/New_York"
+
+sources:
+  gmail:
+    enabled: false
+  calendar:
+    enabled: false
+  slack:
+    enabled: false
+  p2:
+    enabled: false
+  linear:
+    enabled: false
+  reminders:
+    enabled: false
+
+features:
+  morning_brief:
+    enabled: true
+    auto_run: false
+  evening_review:
+    enabled: true
+  weekly_review:
+    enabled: true

tests/fixtures/test-vault-populated/9_Meta/memory.md

@@ -0,0 +1,12 @@
+# Memory
+
+User preferences and learned patterns.
+
+## Preferences
+
+- Preferred working hours: 9am - 5pm
+- Focus time preference: mornings
+
+## Patterns
+
+(Learned patterns will be recorded here)

tests/fixtures/test-vault-populated/9_Meta/pending.json

@@ -0,0 +1,4 @@
+{
+  "version": 1,
+  "pending_operations": []
+}

tests/fixtures/test-vault-populated/9_Meta/prompts/evening-review.md

@@ -0,0 +1,9 @@
+# Evening Review Template
+
+Guide the evening review:
+
+1. What was accomplished today?
+2. What remains incomplete?
+3. Process inbox items
+4. Preview tomorrow's calendar
+5. Set intentions for tomorrow

tests/fixtures/test-vault-populated/9_Meta/prompts/morning-brief.md

@@ -0,0 +1,9 @@
+# Morning Brief Template
+
+Generate a morning brief with:
+
+1. Today's calendar events
+2. Priority tasks
+3. Emails needing attention
+4. Slack/P2 messages to review
+5. Reminders for today

tests/fixtures/test-vault-populated/9_Meta/prompts/process-inbox.md

@@ -0,0 +1,8 @@
+# Process Inbox Template
+
+Guide inbox processing:
+
+1. Identify items to process
+2. For each item, decide: delete, delegate, defer, do, or file
+3. Move processed items to appropriate locations
+4. Update any related projects or areas

tests/fixtures/test-vault-populated/9_Meta/prompts/weekly-review.md

@@ -0,0 +1,9 @@
+# Weekly Review Template
+
+Guide the weekly review:
+
+1. Review the past week
+2. Check project statuses
+3. Process fleeting notes
+4. Review upcoming week
+5. Set weekly intentions

tests/fixtures/test-vault-populated/9_Meta/state.json

@@ -0,0 +1,14 @@
+{
+  "version": 1,
+  "last_sync": {
+    "gmail": null,
+    "calendar": null,
+    "slack": null,
+    "p2": null,
+    "linear": null,
+    "reminders": null
+  },
+  "last_morning_brief": null,
+  "last_evening_review": null,
+  "last_weekly_review": null
+}