ultimate-pi 0.12.0 → 0.13.1

package/.agents/skills/ck-search/SKILL.md

@@ -1,99 +0,0 @@
----
-name: ck-search
-description: "Semantic code search using ck. Use when exploring codebases, finding related code, or searching by concept rather than exact text. Triggers on: search for, find code that, where is, look for patterns, find all files related to, find similar code, explore codebase, semantic search."
----
-
-# ck-search: Semantic Code Search
-
-## When to Use
-
-Use `ck` instead of `grep`/`find` for **any codebase exploration**. Reserve raw grep for only: exact literal string match (specific error message, exact function name).
-
-## Quick Reference
-
-```bash
-# Hybrid (best default — lexical + semantic fused via RRF)
-ck --hybrid "query" .
-
-# Semantic only (conceptual — finds by meaning)
-ck --sem "concept" src/
-
-# Lexical BM25 (phrase-based, better than grep for multi-word)
-ck --lex "phrase" .
-
-# Grep-compatible (exact match, same flags as grep)
-ck "exact string" -rn src/
-```
-
-## Search Decision Tree
-
-```
-Agent needs to find code
-  ├─ Exact literal string (error msg, function name) → grep/rg
-  ├─ Conceptual / multi-word → ck --hybrid
-  ├─ Find similar patterns → ck --sem
-  └─ Unsure → ck --hybrid (safe default)
-```
-
-## Key Flags
-
-| Flag | Purpose | When |
-|------|---------|------|
-| `--hybrid` | BM25 + semantic RRF fusion | **Default for exploration** |
-| `--sem` | Semantic only (embedding similarity) | Conceptual: "error handling", "auth flow" |
-| `--lex` | BM25 lexical only | Phrase search without regex |
-| `--limit N` | Top N results | Keep output lean (default 10) |
-| `--threshold 0.7` | Min similarity score | Filter low-confidence results |
-| `--json` | Machine-readable output | When piping to other tools |
-| `-n` | Line numbers | Same as grep |
-| `-C N` | Context lines | Same as grep |
-| `-r` | Recursive | Same as grep |
-| `-l` | Files with matches | List matching files only |
-
-## Index Management
-
-```bash
-ck --status .              # Check if index exists
-ck index .                 # Build/rebuild full index
-ck --add file.ts           # Add single file to index
-ck --clean .               # Remove index (rebuild from scratch)
-ck --switch-model MODEL    # Rebuild with different embedding model
-```
-
-## Usage Patterns
-
-### Find related code
-```bash
-ck --hybrid "retry logic with exponential backoff" .
-```
-
-### Find authentication code
-```bash
-ck --sem "authentication middleware" src/ --limit 20
-```
-
-### Find error handling patterns
-```bash
-ck --hybrid "error handling and recovery" src/ --limit 15
-```
-
-### Find database code
-```bash
-ck --sem "database connection pool" src/
-```
-
-### Exact function name (still use grep)
-```bash
-grep -rn "processPayment" src/
-```
-
-## Integration Notes
-
-- **Index location**: `.ck/index/` in project root (gitignored)
-- **First search auto-indexes**: `ck --sem` builds index on first run if missing
-- **Fully offline**: No API keys, no network, embeddings run locally
-- **MCP mode**: `ck --serve` exposes ck_search/ck_get/ck_info/ck_reindex as MCP tools (future integration)
-
-## Token Efficiency
-
-ck results are ranked and scored. Use `--limit` to cap output. A typical ck --hybrid call returns 10 results (~500-1000 tokens) vs raw grep which can return hundreds of unranked matches (~5000-20000 tokens).

package/.agents/skills/obsidian-bases/SKILL.md

@@ -1,299 +0,0 @@
----
-name: obsidian-bases
-description: "Create and edit Obsidian Bases (.base files): Obsidian's native database layer for dynamic tables, card views, list views, filters, formulas, and summaries over vault notes. Triggers on: create a base, add a base file, obsidian bases, base view, filter notes, formula, database view, dynamic table, task tracker base, reading list base."
-allowed-tools: Read Write
----
-
-# obsidian-bases: Obsidian's Database Layer
-
-Obsidian Bases (launched 2025) turns vault notes into queryable, dynamic views. Tables, cards, lists, maps. Defined in `.base` files. No plugin required; it is a core Obsidian feature.
-
-**Authoritative reference**: If the kepano/obsidian-skills plugin is installed, prefer its canonical obsidian-bases skill. Otherwise, use the reference below. Official docs: https://help.obsidian.md/bases/syntax
-
----
-
-## Wiki Path Resolution
-
-All `wiki/` paths in this skill (in `.base` filter expressions like `file.inFolder("wiki/")`) are relative to the wiki directory inside the Obsidian vault. Obsidian Bases operate on the vault directly; the `wiki/` prefix in filter expressions reflects the folder name within the vault. If your wiki folder has a different name, adjust filter paths accordingly.
-
----
-
-## File Format
-
-`.base` files contain valid YAML. The root keys are `filters`, `formulas`, `properties`, `summaries`, and `views`.
-
-```yaml
-# Global filters: apply to ALL views
-filters:
-  and:
-    - file.hasTag("wiki")
-    - 'status != "archived"'
-
-# Computed properties
-formulas:
-  age_days: '(now() - file.ctime).days.round(0)'
-  status_icon: 'if(status == "mature", "✅", "🔄")'
-
-# Display name overrides for properties panel
-properties:
-  status:
-    displayName: "Status"
-  formula.age_days:
-    displayName: "Age (days)"
-
-# One or more views
-views:
-  - type: table
-    name: "All Pages"
-    order:
-      - file.name
-      - type
-      - status
-      - updated
-      - formula.age_days
-```
-
----
-
-## Filters
-
-Filters select which notes appear. Applied globally or per-view.
-
-```yaml
-# Single string filter
-filters: 'status == "current"'
-
-# AND: all must be true
-filters:
-  and:
-    - 'status != "archived"'
-    - file.hasTag("wiki")
-
-# OR: any can be true
-filters:
-  or:
-    - file.hasTag("concept")
-    - file.hasTag("entity")
-
-# NOT: exclude matches
-filters:
-  not:
-    - file.inFolder("wiki/meta")
-
-# Nested
-filters:
-  and:
-    - file.inFolder("wiki/")
-    - or:
-        - 'type == "concept"'
-        - 'type == "entity"'
-```
-
-### Filter operators
-
-`==` `!=` `>` `<` `>=` `<=`
-
-### Useful filter functions
-
-| Function | Example |
-|----------|---------|
-| `file.hasTag("x")` | Notes with tag `x` |
-| `file.inFolder("path/")` | Notes in folder |
-| `file.hasLink("Note")` | Notes linking to Note |
-
----
-
-## Properties
-
-Three types:
-- **Note properties**: from frontmatter: `status`, `type`, `updated`
-- **File properties**: metadata: `file.name`, `file.mtime`, `file.size`, `file.ctime`, `file.tags`, `file.folder`
-- **Formula properties**: computed: `formula.age_days`
-
----
-
-## Formulas
-
-Defined in `formulas:`. Referenced as `formula.name` in `order:` and `properties:`.
-
-```yaml
-formulas:
-  # Days since created
-  age_days: '(now() - file.ctime).days.round(0)'
-
-  # Days until a date property
-  days_until: 'if(due_date, (date(due_date) - today()).days, "")'
-
-  # Conditional label
-  status_icon: 'if(status == "mature", "✅", if(status == "developing", "🔄", "🌱"))'
-
-  # Word count estimate
-  word_est: '(file.size / 5).round(0)'
-```
-
-**Key rule**: Subtracting two dates returns a `Duration`. Not a number. Always access `.days` first:
-```yaml
-# CORRECT
-age: '(now() - file.ctime).days'
-
-# WRONG: crashes
-age: '(now() - file.ctime).round(0)'
-```
-
-**Always guard nullable properties with `if()`**:
-```yaml
-# CORRECT
-days_left: 'if(due_date, (date(due_date) - today()).days, "")'
-```
-
----
-
-## View Types
-
-### Table
-```yaml
-views:
-  - type: table
-    name: "Wiki Index"
-    limit: 100
-    order:
-      - file.name
-      - type
-      - status
-      - updated
-    groupBy:
-      property: type
-      direction: ASC
-```
-
-### Cards
-```yaml
-views:
-  - type: cards
-    name: "Gallery"
-    order:
-      - file.name
-      - tags
-      - status
-```
-
-### List
-```yaml
-views:
-  - type: list
-    name: "Quick List"
-    order:
-      - file.name
-      - status
-```
-
----
-
-## Wiki Vault Templates
-
-### Wiki content dashboard (all non-meta pages)
-
-```yaml
-filters:
-  and:
-    - file.inFolder("wiki/")
-    - not:
-        - file.inFolder("wiki/meta")
-
-formulas:
-  age: '(now() - file.ctime).days.round(0)'
-
-properties:
-  formula.age:
-    displayName: "Age (days)"
-
-views:
-  - type: table
-    name: "All Wiki Pages"
-    order:
-      - file.name
-      - type
-      - status
-      - updated
-      - formula.age
-    groupBy:
-      property: type
-      direction: ASC
-```
-
-### Entity index (people, orgs, repos)
-
-```yaml
-filters:
-  and:
-    - file.inFolder("wiki/entities/")
-    - 'file.ext == "md"'
-
-views:
-  - type: table
-    name: "Entities"
-    order:
-      - file.name
-      - entity_type
-      - status
-      - updated
-    groupBy:
-      property: entity_type
-      direction: ASC
-```
-
-### Recent ingests
-
-```yaml
-filters:
-  and:
-    - file.inFolder("wiki/sources/")
-
-views:
-  - type: table
-    name: "Sources"
-    order:
-      - file.name
-      - source_type
-      - created
-      - status
-    groupBy:
-      property: source_type
-      direction: ASC
-```
-
----
-
-## Embedding in Notes
-
-```markdown
-![[MyBase.base]]
-
-![[MyBase.base#View Name]]
-```
-
----
-
-## Where to Save
-
-Store `.base` files in `wiki/meta/` for vault dashboards:
-- `wiki/meta/dashboard.base`: main content view
-- `wiki/meta/entities.base`: entity tracker
-- `wiki/meta/sources.base`: ingestion log
-
----
-
-## YAML Quoting Rules
-
-- Formulas with double quotes → wrap in single quotes: `'if(done, "Yes", "No")'`
-- Strings with colons or special chars → wrap in double quotes: `"Status: Active"`
-- Unquoted strings with `:` break YAML parsing
-
----
-
-## What Not to Do
-
-- Do not use `from:` or `where:`: those are Dataview syntax, not Obsidian Bases
-- Do not use `sort:` at the root level: sorting is per-view via `order:` and `groupBy:`
-- Do not put `.base` files outside the vault: they only render inside Obsidian
-- Do not reference `formula.X` in `order:` without defining `X` in `formulas:`

package/.agents/skills/obsidian-markdown/SKILL.md

@@ -1,237 +0,0 @@
----
-name: obsidian-markdown
-description: "Write correct Obsidian Flavored Markdown: wikilinks, embeds, callouts, properties, tags, highlights, math, and canvas syntax. Reference this when creating or editing any wiki page. Triggers on: write obsidian note, obsidian syntax, wikilink, callout, embed, obsidian markdown, wikilink format, callout syntax, embed syntax, obsidian formatting, how to write obsidian markdown."
-allowed-tools: Read Write Edit
----
-
-# obsidian-markdown: Obsidian Flavored Markdown
-
-Reference this skill when writing any wiki page. Obsidian extends standard Markdown with wikilinks, embeds, callouts, and properties. Getting syntax wrong causes broken links, invisible callouts, or malformed frontmatter.
-
-**Cross-reference**: If the kepano/obsidian-skills plugin is installed, prefer its canonical obsidian-markdown skill for authoritative Obsidian syntax reference. Otherwise, use the reference below. See also [github.com/kepano/obsidian-skills](https://github.com/kepano/obsidian-skills).
-
----
-
-## Wiki Path Resolution
-
-This skill provides Obsidian syntax reference. It does NOT perform file operations itself. When invoked by other skills (wiki-ingest, wiki-save, etc.), those skills handle wiki path resolution via `VAULT_WIKI_PATH`.
-
----
-
-## Wikilinks
-
-Internal links use double brackets. The filename without extension.
-
-| Syntax | What it does |
-|---|---|
-| `[[Note Name]]` | Basic link |
-| `[[Note Name\|Display Text]]` | Aliased link (shows "Display Text") |
-| `[[Note Name#Heading]]` | Link to a specific heading |
-| `[[Note Name#^block-id]]` | Link to a specific block |
-
-Rules:
-- Case-sensitive on some systems. Match the exact filename.
-- No path needed: Obsidian resolves by filename uniqueness.
-- If two files have the same name, use `[[Folder/Note Name]]` to disambiguate.
-
----
-
-## Embeds
-
-Embeds use `!` before the wikilink. They display the content inline.
-
-| Syntax | What it does |
-|---|---|
-| `![[Note Name]]` | Embed a full note |
-| `![[Note Name#Heading]]` | Embed a section |
-| `![[image.png]]` | Embed an image |
-| `![[image.png\|300]]` | Embed image with width 300px |
-| `![[document.pdf]]` | Embed a PDF (Obsidian renders natively) |
-| `![[audio.mp3]]` | Embed audio |
-
----
-
-## Callouts
-
-Callouts are blockquotes with a type keyword. They render as styled alert boxes.
-
-```markdown
-> [!note]
-> Default informational callout.
-
-> [!note] Custom Title
-> Callout with a custom title.
-
-> [!note]- Collapsible (closed by default)
-> Click to expand.
-
-> [!note]+ Collapsible (open by default)
-> Click to collapse.
-```
-
-### All callout types
-
-| Type | Aliases | Use for |
-|------|---------|---------|
-| `note` |: | General notes |
-| `abstract` | `summary`, `tldr` | Summaries |
-| `info` |: | Information |
-| `todo` |: | Action items |
-| `tip` | `hint`, `important` | Tips and highlights |
-| `success` | `check`, `done` | Positive outcomes |
-| `question` | `help`, `faq` | Open questions |
-| `warning` | `caution`, `attention` | Warnings |
-| `failure` | `fail`, `missing` | Errors or failures |
-| `danger` | `error` | Critical issues |
-| `bug` |: | Known bugs |
-| `example` |: | Examples |
-| `quote` | `cite` | Quotations |
-| `contradiction` |: | Conflicting information (wiki convention) |
-
----
-
-## Properties (Frontmatter)
-
-Obsidian renders YAML frontmatter as a Properties panel. Rules:
-
-```yaml
----
-type: concept                    # plain string
-title: "Note Title"              # quoted if it contains special chars
-created: 2026-04-08              # date as YYYY-MM-DD (not ISO datetime)
-updated: 2026-04-08
-tags:
-  - tag-one                      # list items use - format
-  - tag-two
-status: developing
-related:
-  - "[[Other Note]]"             # wikilinks must be quoted in YAML
-sources:
-  - "[[source-page]]"
----
-```
-
-Rules:
-- Flat YAML only. Never nest objects.
-- Dates as `YYYY-MM-DD`, not `2026-04-08T00:00:00`.
-- Lists as `- item`, not inline `[a, b, c]`.
-- Wikilinks in YAML must be quoted: `"[[Page]]"`.
-- `tags` field: Obsidian reads this as the tag list, searchable in vault.
-
----
-
-## Tags
-
-Two valid forms:
-
-```markdown
-#tag-name             : inline tag anywhere in the body
-#parent/child-tag     : nested tag (shows hierarchy in tag pane)
-```
-
-In frontmatter:
-```yaml
-tags:
-  - research
-  - ai/obsidian
-```
-
-Do not use `#` inside frontmatter tag lists. Just the tag name.
-
----
-
-## Text Formatting
-
-Standard Markdown plus Obsidian extensions:
-
-| Syntax | Result |
-|---|---|
-| `**bold**` | Bold |
-| `*italic*` | Italic |
-| `~~strikethrough~~` | Strikethrough |
-| `==highlight==` | Highlighted text (yellow in Obsidian) |
-| `` `inline code` `` | Inline code |
-
----
-
-## Math
-
-Obsidian uses MathJax/KaTeX:
-
-Inline math:
-```markdown
-$E = mc^2$
-```
-
-Block math:
-```markdown
-$$
-\int_0^\infty e^{-x} dx = 1
-$$
-```
-
----
-
-## Code Blocks
-
-Standard fenced code blocks. Obsidian highlights all common languages:
-
-````markdown
-```python
-def hello():
-    return "world"
-```
-````
-
----
-
-## Tables
-
-Standard Markdown tables:
-
-```markdown
-| Column A | Column B | Column C |
-|----------|----------|----------|
-| Value    | Value    | Value    |
-| Value    | Value    | Value    |
-```
-
-Obsidian renders tables natively. No plugin needed.
-
----
-
-## Mermaid Diagrams
-
-Obsidian renders Mermaid natively:
-
-````markdown
-```mermaid
-graph TD
-    A[Start] --> B{Decision}
-    B -->|Yes| C[End]
-    B -->|No| D[Loop]
-    D --> A
-```
-````
-
-Supported: `graph`, `sequenceDiagram`, `gantt`, `classDiagram`, `pie`, `flowchart`.
-
----
-
-## Footnotes
-
-```markdown
-This sentence has a footnote.[^1]
-
-[^1]: The footnote text goes here.
-```
-
----
-
-## What NOT to Do
-
-- Do not use `[link text](path/to/note.md)` for internal links: use `[[Note Name]]` instead.
-- Do not use HTML inside callouts: stick to Markdown.
-- Do not use `##` inside a callout body: headings don't render inside callouts.
-- Do not write `tags: [a, b, c]` inline in frontmatter: Obsidian prefers the list format.
-- Do not write ISO datetimes in frontmatter (`2026-04-08T00:00:00Z`): use `2026-04-08`.