From 35c69bc1ebb3d35a9a631c07bab0320a7e92e0c2 Mon Sep 17 00:00:00 2001 From: stateofshit Date: Wed, 29 Jul 2026 15:07:36 +0000 Subject: [PATCH] reorg: move tpl/bin under 000-configs, files->assets, add bump-version.sh + plugins doc --- .obsidian/daily-notes.json | 2 +- {bin => 000-configs/bin}/.gitkeep | 0 {bin => 000-configs/bin}/README.md | 0 000-configs/bin/bump-version.sh | 63 ++++++++++++++++++++ {bin => 000-configs/bin}/daily.sh | 0 000-configs/skills/plugins-recommended.md | 69 ++++++++++++++++++++++ {files => 000-configs/templates}/.gitkeep | 0 {tpl => 000-configs/templates}/daily.md | 0 {tpl => 000-configs/templates}/handoff.md | 0 {tpl => 000-configs/templates}/research.md | 0 {tpl => 000-configs/templates}/task.md | 0 02-notes/task-vault-setup-test.md | 2 +- 04-models/Vault-Rules.md | 7 ++- README.md | 31 ++++++---- {tpl => assets}/.gitkeep | 0 15 files changed, 158 insertions(+), 16 deletions(-) rename {bin => 000-configs/bin}/.gitkeep (100%) rename {bin => 000-configs/bin}/README.md (100%) create mode 100755 000-configs/bin/bump-version.sh rename {bin => 000-configs/bin}/daily.sh (100%) create mode 100644 000-configs/skills/plugins-recommended.md rename {files => 000-configs/templates}/.gitkeep (100%) rename {tpl => 000-configs/templates}/daily.md (100%) rename {tpl => 000-configs/templates}/handoff.md (100%) rename {tpl => 000-configs/templates}/research.md (100%) rename {tpl => 000-configs/templates}/task.md (100%) rename {tpl => assets}/.gitkeep (100%) diff --git a/.obsidian/daily-notes.json b/.obsidian/daily-notes.json index 913c1c1..9f02bf8 100644 --- a/.obsidian/daily-notes.json +++ b/.obsidian/daily-notes.json @@ -1,7 +1,7 @@ { "folder": "01-logs/daily", "format": "YYYY-MM-DD", - "template": "tpl/daily.md", + "template": "000-configs/templates/daily.md", "autorun": false, "autorunOnlyIfToday": false } diff --git a/bin/.gitkeep b/000-configs/bin/.gitkeep similarity index 100% rename from bin/.gitkeep rename to 000-configs/bin/.gitkeep diff --git a/bin/README.md b/000-configs/bin/README.md similarity index 100% rename from bin/README.md rename to 000-configs/bin/README.md diff --git a/000-configs/bin/bump-version.sh b/000-configs/bin/bump-version.sh new file mode 100755 index 0000000..bd5c2a6 --- /dev/null +++ b/000-configs/bin/bump-version.sh @@ -0,0 +1,63 @@ +#!/bin/bash +# bin/bump-version.sh — auto-increment version in YAML frontmatter +# Usage: +# bin/bump-version.sh # bump patch (default) +# bin/bump-version.sh --patch # bump patch +# bin/bump-version.sh --minor # bump minor, reset patch +# bin/bump-version.sh --major # bump major, reset minor+patch +# +# Reads YAML frontmatter, increments version, updates `updated` field. +# Writes back in-place. + +set -e + +FILE="$1" +BUMP="${2:---patch}" + +if [ -z "$FILE" ]; then + echo "Usage: $0 [--patch|--minor|--major]" >&2 + exit 1 +fi + +if [ ! -f "$FILE" ]; then + echo "File not found: $FILE" >&2 + exit 1 +fi + +# Extract version +CURRENT=$(head -20 "$FILE" | grep -E '^version:' | head -1 | sed 's/version: *//; s/"//g') +if [ -z "$CURRENT" ]; then + echo "No version field in frontmatter" >&2 + exit 1 +fi + +# Parse semver +IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT" + +case "$BUMP" in + --major) + MAJOR=$((MAJOR + 1)) + MINOR=0 + PATCH=0 + ;; + --minor) + MINOR=$((MINOR + 1)) + PATCH=0 + ;; + --patch|*) + PATCH=$((PATCH + 1)) + ;; +esac + +NEW_VERSION="$MAJOR.$MINOR.$PATCH" +TODAY=$(date +%Y-%m-%d) + +# Replace in file (in-place) +sed -i.bak \ + -e "s|^version:.*|version: \"$NEW_VERSION\"|" \ + -e "s|^updated:.*|updated: \"$TODAY\"|" \ + "$FILE" + +rm -f "$FILE.bak" + +echo "$FILE: $CURRENT -> $NEW_VERSION (updated: $TODAY)" diff --git a/bin/daily.sh b/000-configs/bin/daily.sh similarity index 100% rename from bin/daily.sh rename to 000-configs/bin/daily.sh diff --git a/000-configs/skills/plugins-recommended.md b/000-configs/skills/plugins-recommended.md new file mode 100644 index 0000000..b84c85a --- /dev/null +++ b/000-configs/skills/plugins-recommended.md @@ -0,0 +1,69 @@ +--- +title: "Recommended Obsidian Plugins" +status: "active" +folder: "000-configs/skills" +tags: [plugin, obsidian, skill] +created: "2026-07-29" +updated: "2026-07-29" +version: "1.0.0" +--- + +# Recommended Obsidian Plugins + +Plugin suggestions for this vault. Install in Obsidian → Settings → Community plugins. + +## Tier 1 — Install First + +| Plugin | Why | +|---|---| +| **Dataview** | Powers the dashboard (`000-shit_admin/dashboard.md`). Auto-lists tasks, recent notes, etc. | +| **Templater** | Dynamic templates with `{{date}}` injection. Used by Daily Notes. | +| **Daily Notes** | Built-in. Auto-creates `01-logs/daily/YYYY-MM-DD.md` on open. Pre-configured in this vault. | +| **Obsidian Git** | Sync from inside Obsidian. No terminal needed for pull/push/commit. | + +## Tier 2 — Quality of Life + +| Plugin | Why | +|---|---| +| **Calendar** | Click any date → jump to that daily note. Visual daily note nav. | +| **Tasks** | Better than Dataview for task tracking. Supports due dates, recurring tasks, query syntax. | +| **Tag Wrangler** | Rename/merge tags as vault grows. | +| **Various Complements** | Auto-complete text in notes (faster writing). | +| **Recent Files** | Quick jump to recent notes. | +| **Quick Switcher++** | Enhanced `Ctrl+O` file switcher. | + +## Tier 3 — Power User + +| Plugin | Why | +|---|---| +| **Excalidraw** | Hand-drawn diagrams and sketches. | +| **Mind Map** | Auto-generate mind maps from headings. | +| **Paste image rename** | Auto-rename pasted images to descriptive names. | +| **Editing Toolbar** | WYSIWYG-style toolbar for tables, math, etc. | +| **Outliner** | Better list/outline UX with indent guides. | +| **Buttons** | Add buttons to notes that run commands. | + +## Already Enabled (via `.obsidian/core-plugins.json`) + +- Daily Notes +- Templates + +## Not Needed on This Server + +Models on the openwebui server work via shell + git. No Obsidian plugins needed server-side. + +## Sync Compatibility + +`.gitignore` is set up to ignore: +- Plugin binaries (`.obsidian/plugins/*/main.js`) +- Plugin state (`.obsidian/plugins/*/data.json`) +- Theme state (`.obsidian/themes/*/data.json`) +- Workspace layout (`.obsidian/workspace.json`) + +Tracked (syncs across machines): +- Plugin manifests (`.obsidian/plugins/*/manifest.json`) +- Plugin styles (`.obsidian/plugins/*/styles.css`) +- Theme manifests + CSS +- All `.json` config files in `.obsidian/` + +This means installing a new plugin on your PC will sync its config to the server (and any other machine), but the binary still needs to be installed per machine. diff --git a/files/.gitkeep b/000-configs/templates/.gitkeep similarity index 100% rename from files/.gitkeep rename to 000-configs/templates/.gitkeep diff --git a/tpl/daily.md b/000-configs/templates/daily.md similarity index 100% rename from tpl/daily.md rename to 000-configs/templates/daily.md diff --git a/tpl/handoff.md b/000-configs/templates/handoff.md similarity index 100% rename from tpl/handoff.md rename to 000-configs/templates/handoff.md diff --git a/tpl/research.md b/000-configs/templates/research.md similarity index 100% rename from tpl/research.md rename to 000-configs/templates/research.md diff --git a/tpl/task.md b/000-configs/templates/task.md similarity index 100% rename from tpl/task.md rename to 000-configs/templates/task.md diff --git a/02-notes/task-vault-setup-test.md b/02-notes/task-vault-setup-test.md index 7de5dac..a89ef08 100644 --- a/02-notes/task-vault-setup-test.md +++ b/02-notes/task-vault-setup-test.md @@ -5,7 +5,7 @@ folder: "02-notes" tags: [task, vault, test] created: "2026-07-29" updated: "2026-07-29" -version: "1.0.0" +version: "1.0.1" priority: "high" due: "2026-07-30" owner: "stateofshit" diff --git a/04-models/Vault-Rules.md b/04-models/Vault-Rules.md index 3d8c46b..af8e12e 100644 --- a/04-models/Vault-Rules.md +++ b/04-models/Vault-Rules.md @@ -6,7 +6,7 @@ model_owner: "none" tags: [rules, model] created: "2026-07-28" updated: "2026-07-29" -version: "1.1.0" +version: "1.2.0" --- # Vault Rules @@ -73,9 +73,12 @@ draft -> active -> archive | Folder | What Goes There | |---|---| | `000-shit_admin` | Your zone. Models read-only. | -| `000-configs` | Server/model config docs (mirror of /home/user/000-configs/) | +| `000-configs` | Server/model config docs, scripts, templates | +| `000-configs/templates` | Markdown templates | +| `000-configs/bin` | Helper shell scripts | | `00-inbox` | Raw dumps, new ideas, unorganized stuff | | `01-logs/daily` | Auto daily notes (Obsidian Daily Notes plugin) | +| `assets` | Attachments | | `01-logs` | Session logs, daily notes, timestamps | | `02-notes` | Research notes, findings, reference material | | `03-archive` | Done / superseded files | diff --git a/README.md b/README.md index 0ac3dfe..25433a8 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ folder: "" tags: [readme, home] created: "2026-07-28" updated: "2026-07-29" -version: "1.1.0" +version: "1.2.0" --- # shit_in_a_vault @@ -17,7 +17,16 @@ Obsidian vault for openwebui models + research. Private repo. | Folder | Purpose | |---|---| | [[000-shit_admin/]] | Your zone — models read-only | -| [[000-configs/]] | Server/model config docs | +| [[000-configs/]] | Server/model config, scripts, templates | +| [[000-configs/templates/]] | Markdown templates (daily, research, task, handoff) | +| [[000-configs/bin/]] | Helper shell scripts (cron, version bump) | +| [[000-configs/tools/]] | Tool docs (gh, playwright, vite) | +| [[000-configs/skills/]] | Skill definitions, plugin recommendations | +| [[000-configs/modes/]] | Model mode presets | +| [[000-configs/workspace/]] | Workspace layouts | +| [[000-configs/settings/]] | Server settings docs | +| [[000-configs/prompts/]] | Reusable system prompts | +| [[000-configs/archive/]] | Old/deprecated configs | | [[00-inbox/]] | Raw dumps, unprocessed | | [[01-logs/]] | Session logs | | [[01-logs/daily/]] | Auto daily notes (Obsidian Daily Notes plugin) | @@ -25,34 +34,32 @@ Obsidian vault for openwebui models + research. Private repo. | [[03-archive/]] | Superseded | | [[04-models/]] | Rules, memory, boot prompt, model identity | | [[05-handoffs/]] | Model-to-model handoffs | -| [[files/]] | Attachments | -| [[tpl/]] | Templates | -| [[bin/]] | Helper scripts | +| [[assets/]] | Attachments (images, PDFs) | ## For Models Boot: read [[04-models/model-boot]] Rules: read [[04-models/Vault-Rules]] Identity: append to [[04-models/model-identity]] +Version bump: `000-configs/bin/bump-version.sh ` ## For You (Obsidian PC) **Required plugins:** - Daily Notes (built-in, auto-enabled by `.obsidian/core-plugins.json`) -- Templates (built-in) -- Dataview (community) -- Templater (community) +- Dataview +- Templater -**Daily note auto-create** — Daily Notes plugin uses: +**Daily note config:** - Folder: `01-logs/daily` - Format: `YYYY-MM-DD` -- Template: `tpl/daily.md` +- Template: `000-configs/templates/daily.md` -Already pre-configured in `.obsidian/daily-notes.json`. +See [[000-configs/skills/plugins-recommended]] for more. ## Dashboard -[[000-shit_admin/dashboard]] — Dataview-driven home screen. +[[000-shit_admin/dashboard]] — Dataview home screen. ## Git diff --git a/tpl/.gitkeep b/assets/.gitkeep similarity index 100% rename from tpl/.gitkeep rename to assets/.gitkeep