mirror of
https://github.com/prdlk/dotfiles.git
synced 2026-11-05 20:17:42 +00:00
shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents
- 16 cross-shell utilities converted to sh/bash chezmoi executables: ai c2p cp-appid extract_agents fab gdc gh-sonr-org-migrate ghg-clone ghn gho git-summary launch_omp_livediff_overlay lc-elir mdcp mdp pj (ghg-clone not named ghg: unrelated cargo binary owns that name) - cwd/history helpers stay per-shell: yy c cd clip-last + ghg/ghn/gho cd-wrappers in bash/functions/ and zsh/functions/, loaded by rc files - fish keeps only shell-state functions; converted ones now hit PATH - cp-appid ignore gating moved to .local/bin path - dot_agents/skills: 82 skills materialized from dotstate storage so dot_claude skill symlinks resolve on fresh bootstrap; dotstate profile/symlinks.json released .agents/skills .bashrc .zshrc
This commit is contained in:
1 parent
6776366ce6
commit
6406208b35
637 files changed
+100297
-497
No files matched your search
@@ -0,0 +1,88 @@
|
||||
# Vectorize Configuration
|
||||
|
||||
## Create Index
|
||||
|
||||
```bash
|
||||
npx wrangler vectorize create my-index --dimensions=768 --metric=cosine
|
||||
```
|
||||
|
||||
**⚠️ Dimensions and metric are immutable** - cannot change after creation.
|
||||
|
||||
## Worker Binding
|
||||
|
||||
```jsonc
|
||||
// wrangler.jsonc
|
||||
{
|
||||
"vectorize": [
|
||||
{ "binding": "VECTORIZE", "index_name": "my-index" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
```typescript
|
||||
interface Env {
|
||||
VECTORIZE: Vectorize;
|
||||
}
|
||||
```
|
||||
|
||||
## Metadata Indexes
|
||||
|
||||
**Must create BEFORE inserting vectors** - existing vectors not retroactively indexed.
|
||||
|
||||
```bash
|
||||
wrangler vectorize create-metadata-index my-index --property-name=category --type=string
|
||||
wrangler vectorize create-metadata-index my-index --property-name=price --type=number
|
||||
```
|
||||
|
||||
| Type | Use For |
|
||||
|------|---------|
|
||||
| `string` | Categories, tags (first 64 bytes indexed) |
|
||||
| `number` | Prices, timestamps |
|
||||
| `boolean` | Flags |
|
||||
|
||||
## CLI Commands
|
||||
|
||||
```bash
|
||||
# Index management
|
||||
wrangler vectorize list
|
||||
wrangler vectorize info <index-name>
|
||||
wrangler vectorize delete <index-name>
|
||||
|
||||
# Vector operations
|
||||
wrangler vectorize insert <index-name> --file=embeddings.ndjson
|
||||
wrangler vectorize get <index-name> --ids=id1,id2
|
||||
wrangler vectorize delete-by-ids <index-name> --ids=id1,id2
|
||||
|
||||
# Metadata indexes
|
||||
wrangler vectorize list-metadata-index <index-name>
|
||||
wrangler vectorize delete-metadata-index <index-name> --property-name=field
|
||||
```
|
||||
|
||||
## Bulk Upload (NDJSON)
|
||||
|
||||
```json
|
||||
{"id": "1", "values": [0.1, 0.2, ...], "metadata": {"category": "docs"}}
|
||||
{"id": "2", "values": [0.4, 0.5, ...], "namespace": "tenant-abc"}
|
||||
```
|
||||
|
||||
**Limits:** 5000 vectors per file, 100 MB max
|
||||
|
||||
## Cardinality Best Practice
|
||||
|
||||
Bucket high-cardinality data:
|
||||
```typescript
|
||||
// ❌ Millisecond timestamps
|
||||
metadata: { timestamp: Date.now() }
|
||||
|
||||
// ✅ 5-minute buckets
|
||||
metadata: { timestamp_bucket: Math.floor(Date.now() / 300000) * 300000 }
|
||||
```
|
||||
|
||||
## Production Checklist
|
||||
|
||||
1. Create index with correct dimensions
|
||||
2. Create metadata indexes FIRST
|
||||
3. Test bulk upload
|
||||
4. Configure bindings
|
||||
5. Deploy Worker
|
||||
6. Verify queries
|
||||
Reference in new issue
Block a user