@soleri/forge 9.14.4 → 9.16.7

package/dist/skills/soleri-agent-persona/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-agent-persona
+tier: default
 description: >
   Use when the user says "activate persona", "be yourself",
   "stay in character", or "hello [agent name]". Reinforces character

package/dist/skills/soleri-brain-debrief/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-brain-debrief
+tier: default
 description: >
   Use when the user says "brain stats", "pattern strengths",
   "intelligence report", "show brain data", or "what patterns are strongest".

package/dist/skills/soleri-brainstorming/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-brainstorming
+tier: default
 description: >
   Use when the user says "I want to build something", "let's think about",
   "what if we", "creative exploration", or "ideate". For open-ended creative

package/dist/skills/soleri-build-skill/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-build-skill
+tier: default
 description: >
   Use when creating a new skill, updating an existing skill, or scaffolding a skill
   template for a Soleri agent. Triggers on "create a skill", "new skill", "build skill",
@@ -24,6 +25,7 @@ Skills live in two places:
 ```yaml
 ---
 name: soleri-{skill-name}
+tier: default
 description: >
   Use when the user says "trigger1", "trigger2", "trigger3",
   or wants to [brief purpose]. [One sentence about what the skill does].

package/dist/skills/soleri-code-patrol/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-code-patrol
+tier: default
 description: >
   Use when the user says "check against patterns", "pattern compliance",
   "convention check", "review against vault", or "institutional review".

package/dist/skills/soleri-context-resume/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-context-resume
+tier: default
 description: >
   Use when the user says "where did I leave off", "what was I working on",
   "catch me up", "resume session", or "continue where we stopped".

package/dist/skills/soleri-curator/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: soleri-curator
+tier: default
+description: >
+  Use when the user says "curator status", "vault health", "how is the vault",
+  "curator health", "check vault quality", or "what needs grooming".
+  Quick vault health check with targeted grooming recommendations.
+  For full maintenance (dedup, archive, consolidate), use vault-curate.
+---
+
+# Curator — Vault Health and Quick Grooming
+
+Get a rapid health snapshot of the vault and run targeted grooming on specific entries. Use this for regular check-ins and spot fixes. For deep maintenance (dedup, archive stale, full consolidation) use the `vault-curate` skill.
+
+## When to Use
+
+- Quick "how is the vault doing?" check
+- After a few capture sessions to verify entry quality
+- Spot-grooming specific entries or domains
+- Before starting a big research session
+
+## Orchestration
+
+### Step 1: Health Snapshot
+
+```
+YOUR_AGENT_curator op:curator_health
+```
+
+Present results as a status table:
+
+| Metric                  | Value              | Status        |
+| ----------------------- | ------------------ | ------------- |
+| **Total entries**       | {totalEntries}     | —             |
+| **Quality score**       | {qualityScore}/100 | {ok/warn/bad} |
+| **Stale entries**       | {staleCount}       | —             |
+| **Duplicates detected** | {duplicateCount}   | —             |
+| **Grooming needed**     | {needsGrooming}    | —             |
+
+If health score < 70 or duplicates > 10, recommend running `vault-curate`.
+
+### Step 2: Curator Status
+
+```
+YOUR_AGENT_curator op:curator_status
+```
+
+Show last grooming date, entries processed, and any pending actions.
+
+### Step 3: Targeted Grooming (optional)
+
+If specific entries need attention:
+
+```
+YOUR_AGENT_curator op:curator_groom
+  params: {
+    entryIds: ["<id1>", "<id2>"],
+    tags: ["<suggested-tag>"]
+  }
+```
+
+Report how many entries were updated.
+
+## Exit Criteria
+
+Health snapshot presented. If issues found, user is informed with a clear recommendation to run `vault-curate` for full maintenance or `curator_groom` for spot fixes.

package/dist/skills/soleri-deep-review/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-deep-review
+tier: default
 description: >
   Use when the user says "deep review", "code smells", "architecture review",
   "is this well architected", or "optimization review". Multi-pass code review

package/dist/skills/soleri-deliver-and-ship/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-deliver-and-ship
+tier: default
 description: >
   Use when the user says "ship it", "pre-PR check", "delivery checklist", "is this ready",
   "final review", or "ready to deploy". Runs pre-delivery quality gates

package/dist/skills/soleri-discovery-phase/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-discovery-phase
+tier: default
 description: >
   Use when the user says "I don't know where to start", "investigate",
   "research this", "explore the problem", or "discovery". Structured exploration

package/dist/skills/soleri-dream/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-dream
+tier: default
 description: >
   Use when the user says "dream", "consolidate memory", "clean up memory",
   "memory cleanup", or "dream status". Runs automatic memory consolidation
@@ -78,7 +79,18 @@ YOUR_AGENT_core op:brain_build_intelligence
 
 Rebuild brain intelligence with the freshly consolidated vault data.
 
-### Step 5: Capture to Memory
+### Step 5: Normalize Relative Dates
+
+If the dream report includes entries with relative date references ("today", "yesterday", "last week"), normalize them. Search for entries containing relative dates and update to absolute ISO dates:
+
+```
+YOUR_AGENT_vault op:search_intelligent
+  params: { query: "today OR yesterday OR last week OR last month", limit: 20 }
+```
+
+For each entry with relative dates, update `content` to replace relative references with absolute dates based on the entry's `capturedAt` timestamp.
+
+### Step 6: Capture to Memory
 
 ```
 YOUR_AGENT_memory op:session_capture
@@ -96,6 +108,24 @@ Auto-dream triggers automatically on session start when BOTH conditions are met:
 
 Manual `/dream` always runs immediately (force=true).
 
+## Auto-Dream Scheduling
+
+To enable periodic auto-dream (runs every 24h after 5+ sessions):
+
+```
+YOUR_AGENT_core op:curator_schedule_start
+  params: {
+    intervalHours: 24,
+    minSessions: 5
+  }
+```
+
+To disable:
+
+```
+YOUR_AGENT_core op:curator_schedule_stop
+```
+
 ## Background
 
 Inspired by Claude Code's AutoDream feature and the neuroscience of REM sleep.

package/dist/skills/soleri-env-setup/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-env-setup
+tier: default
 description: >
   Use when the user says "setup environment", "post-clone setup", "broken build",
   "missing dependencies", or "MODULE_NOT_FOUND". Detects what a project needs,

package/dist/skills/soleri-executing-plans/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-executing-plans
+tier: default
 description: >
   Use when the user says "execute my plan", "run the plan", "start executing",
   or "implement the plan". Executes tasks sequentially with review checkpoints.

package/dist/skills/soleri-finishing-a-development-branch/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-finishing-a-development-branch
+tier: default
 description: >
   Use when the user says "finish branch", "ready to merge", "PR ready",
   "submit PR", or "close branch". Handles pre-merge checks, PR creation,

package/dist/skills/soleri-fix-and-learn/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-fix-and-learn
+tier: default
 description: >
   Use when the user says "fix it", "apply the fix", "patch this and remember",
   or "fix and capture". Executes a fix AFTER root cause is identified and

package/dist/skills/soleri-health-check/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-health-check
+tier: default
 description: >
   Use when the user says "system health", "agent health", "run diagnostics",
   "system status", or "check health". Read-only health assessment of the

package/dist/skills/soleri-intake/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: soleri-intake
+tier: default
+description: >
+  Use when the user says "ingest this", "add this URL", "import this book",
+  "read and capture", "ingest batch", or when processing external content
+  into the vault. Handles URLs, text, books, and batch imports with
+  automatic knowledge extraction.
+---
+
+# Intake — Ingest External Content
+
+Import external content (URLs, books, text, batch files) into the vault with automatic knowledge extraction. The intake skill handles chunking, entity extraction, and vault persistence so you don't have to do it manually.
+
+## When to Use
+
+- User pastes a URL ("save this article to vault")
+- User shares a book or long document ("ingest this book into your knowledge base")
+- User wants to capture raw text from an external source
+- Batch importing multiple sources at once
+
+## Orchestration
+
+### Step 1: Identify Content Type
+
+Determine what the user is providing:
+
+| Type             | Use Op         | When                             |
+| ---------------- | -------------- | -------------------------------- |
+| URL              | `ingest_url`   | User pastes a web link           |
+| Book / long doc  | `ingest_book`  | PDF, long markdown, or file path |
+| Raw text         | `ingest_text`  | User pastes text directly        |
+| Multiple sources | `ingest_batch` | List of URLs or file paths       |
+
+### Step 2: Ingest
+
+**URL:**
+
+```
+YOUR_AGENT_intake op:ingest_url
+  params: {
+    url: "<url>",
+    domain: "<inferred domain>",
+    tags: ["<tag1>", "<tag2>"]
+  }
+```
+
+**Book / Long Document:**
+
+```
+YOUR_AGENT_intake op:ingest_book
+  params: {
+    path: "<file path or url>",
+    title: "<document title>",
+    domain: "<domain>",
+    chunkStrategy: "chapter"
+  }
+```
+
+**Raw Text:**
+
+```
+YOUR_AGENT_intake op:ingest_text
+  params: {
+    text: "<content>",
+    title: "<descriptive title>",
+    domain: "<domain>",
+    tags: ["<tag>"]
+  }
+```
+
+**Batch:**
+
+```
+YOUR_AGENT_intake op:ingest_batch
+  params: {
+    sources: [
+      { type: "url", value: "<url1>" },
+      { type: "url", value: "<url2>" }
+    ],
+    domain: "<domain>"
+  }
+```
+
+### Step 3: Report Results
+
+Present a summary table:
+
+| Field               | Value             |
+| ------------------- | ----------------- |
+| **Entries created** | {count}           |
+| **Domain**          | {domain}          |
+| **Tags**            | {tags.join(', ')} |
+| **Status**          | {status}          |
+
+If any sources failed, list them with reasons so the user can retry.
+
+## Exit Criteria
+
+All content ingested, entry IDs confirmed, results reported to user.

package/dist/skills/soleri-knowledge-harvest/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-knowledge-harvest
+tier: default
 description: >
   Use when the user says "learn from this", "harvest knowledge", "ingest this",
   or "extract patterns from". Extracts multiple patterns from a source like

package/dist/skills/soleri-loop/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: soleri-loop
+tier: default
+description: >
+  Use when the user says "start a loop", "run until done", "iterate until X",
+  "loop status", or "cancel loop". Manages iterative execution loops that
+  repeat a task until a condition is met or a grade threshold is reached.
+---
+
+# Loop — Iterative Execution
+
+Run a task in a loop until a condition is met — grade threshold, promise fulfilled, or explicit cancellation. Useful for plan refinement, quality iteration, and autonomous improvement cycles.
+
+## When to Use
+
+- Improving a plan until it reaches grade A
+- Running validation until all tests pass
+- Any task that needs to repeat with self-correction until done
+
+## Orchestration
+
+### Step 1: Start Loop
+
+```
+YOUR_AGENT_loop op:loop_start
+  params: {
+    prompt: "<task description>",
+    mode: "<plan-iteration | custom>",
+    maxIterations: <number, default 10>
+  }
+```
+
+**Modes:**
+
+- `plan-iteration` — repeats `create_plan` until grade >= A (target-based)
+- `custom` — user-defined stop condition; loop continues until promise satisfied
+
+Note the `loopId` from the response — needed for status and cancel.
+
+### Step 2: Monitor
+
+At each iteration, check status:
+
+```
+YOUR_AGENT_loop op:loop_status
+  params: { loopId: "<loopId>" }
+```
+
+Report progress to user:
+
+| Field              | Value                                |
+| ------------------ | ------------------------------------ |
+| **Iteration**      | {currentIteration} / {maxIterations} |
+| **Status**         | {status}                             |
+| **Last result**    | {lastResult}                         |
+| **Stop condition** | {stopCondition}                      |
+
+### Step 3: Cancel (if needed)
+
+If the user wants to stop early:
+
+```
+YOUR_AGENT_loop op:loop_cancel
+  params: { loopId: "<loopId>", reason: "<why stopping>" }
+```
+
+## Exit Criteria
+
+Loop completes when: stop condition is met, max iterations reached, or user explicitly cancels. Report final outcome and iteration count.

package/dist/skills/soleri-mcp-doctor/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-mcp-doctor
+tier: default
 description: >
   Use when the user says "MCP not working", "tools missing", "fix MCP",
   "mcp doctor", or "server not connecting". Diagnoses and repairs MCP server

package/dist/skills/soleri-onboard-me/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-onboard-me
+tier: default
 description: >
   Use when the user says "onboard me", "I'm new here", "project overview",
   or "what should I know about this codebase". Provides a structured tour

package/dist/skills/soleri-orchestrate/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: soleri-orchestrate
+tier: default
+description: >
+  Use when the user gives a work task: "implement X", "build Y", "fix Z",
+  "add feature", or any request that requires planning and execution.
+  Runs the full orchestration loop: plan → execute → complete with vault
+  context and brain recommendations built in.
+---
+
+# Orchestrate — Full Work Loop
+
+Run the full work loop with vault intelligence: plan the task, execute it step by step, and close with knowledge capture. Use this for any non-trivial task where missing context or skipping steps would cost time.
+
+## When to Use
+
+- User gives a concrete work task ("implement auth", "refactor the parser", "fix the flaky test")
+- Task spans multiple files or has cross-cutting concerns
+- You want vault patterns and brain recommendations surfaced automatically
+
+## Orchestration
+
+### Step 1: Plan
+
+```
+YOUR_AGENT_orchestrate op:orchestrate_plan
+  params: {
+    prompt: "<user task description>",
+    context: { domain: "<inferred domain>" }
+  }
+```
+
+Present the plan to the user. If grade < A-, ask for approval before proceeding.
+
+### Step 2: Execute
+
+Once approved, begin execution. For each task in the plan:
+
+```
+YOUR_AGENT_orchestrate op:orchestrate_execute
+  params: {
+    planId: "<planId from step 1>",
+    taskId: "<current task id>",
+    output: "<what you did>"
+  }
+```
+
+Log progress after each task: show completed count / total and current task title.
+
+### Step 3: Complete
+
+After all tasks are done:
+
+```
+YOUR_AGENT_orchestrate op:orchestrate_complete
+  params: {
+    planId: "<planId>",
+    summary: "<one-line outcome>",
+    operatorSignals: {
+      qualityNotes: "<any quality observations>",
+      unexpectedComplexity: <true|false>
+    }
+  }
+```
+
+Report the completion summary and any knowledge captured.
+
+## Exit Criteria
+
+All plan tasks executed, `orchestrate_complete` called with outcome, knowledge persisted to vault.

package/dist/skills/soleri-parallel-execute/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-parallel-execute
+tier: default
 description: >
   Use when the user says "run in parallel", "fan out", "concurrent execution",
   "batch execute", or "dispatch subagents". Executes independent plan tasks

package/dist/skills/soleri-research-scout/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-research-scout
+tier: default
 description: >
   Use when the user says "scout", "research scout", "find new info",
   "what's new", or "scan the web". Discovers new information that challenges

package/dist/skills/soleri-retrospective/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-retrospective
+tier: default
 description: >
   Use when the user says "sprint retro", "weekly summary", "what went well",
   "end of sprint", or "monthly report". Time-bound reflection on recent work

package/dist/skills/soleri-second-opinion/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-second-opinion
+tier: default
 description: >
   Use when the user says "second opinion", "technical decision",
   "comparing approaches", or "which approach". Provides informed recommendations

package/dist/skills/soleri-subagent-driven-development/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-subagent-driven-development
+tier: default
 description: >
   Use when the user says "use subagents", "parallel agents",
   "subagent driven", or "isolated execution". Decomposes work into isolated

package/dist/skills/soleri-systematic-debugging/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-systematic-debugging
+tier: default
 description: >
   Use as the FIRST response when something is broken — "bug", "failing test",
   "not working", "debug this", "error", "crash", or "weird issue". Diagnoses

package/dist/skills/soleri-test-driven-development/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-test-driven-development
+tier: default
 description: >
   Use when the user says "TDD", "write tests first", "red green refactor",
   or "test driven". Write failing tests before implementation code for any

package/dist/skills/soleri-using-git-worktrees/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-using-git-worktrees
+tier: default
 description: >
   Use when the user says "worktree", "parallel branch", "safe branch",
   or "isolated branch". Provides the protocol for creating, working in,

package/dist/skills/soleri-vault-capture/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: soleri-vault-capture
+tier: default
 description: >
-  Use when the user says "save this", "capture this", "remember this pattern",
-  "add to vault", "vault capture", or when persisting learnings from a work
-  session. Validated capture with tier scoping, duplicate detection, and
-  abstraction review. For bulk extraction from documents, code, or PRs, use
-  knowledge-harvest instead.
+  Use when the user says "save this to vault", "capture this", "remember this pattern",
+  "add to vault", "vault capture", or when persisting learnings from a work session.
+  Priority over memory_capture for durable knowledge (patterns, decisions, anti-patterns).
+  For quick session notes say "save this as a memory" to use memory_capture instead.
+  For bulk extraction from documents, code, or PRs, use knowledge-harvest.
 ---
 
 # Vault Capture — Validated Knowledge Persistence

package/dist/skills/soleri-vault-curate/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-vault-curate
+tier: default
 description: >
   Use when the user says "clean vault", "deduplicate vault", "groom knowledge",
   "merge patterns", or "vault maintenance". Maintains vault quality through

package/dist/skills/soleri-vault-navigator/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-vault-navigator
+tier: default
 description: >
   Use when the user says "search the vault", "find patterns for",
   "have we seen this before", "vault search", or "best practice for".

package/dist/skills/soleri-vault-smells/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-vault-smells
+tier: default
 description: >
   Use when the user says "vault quality", "vault analysis", "knowledge quality",
   "knowledge debt", "stale patterns", or "find contradictions". Deep knowledge

package/dist/skills/soleri-verification-before-completion/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-verification-before-completion
+tier: default
 description: >
   Use when the user says "verify this works", "check output", "quality gate",
   or "run tests before done". Internal quality gate before claiming any task

package/dist/skills/soleri-writing-plans/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: soleri-writing-plans
+tier: default
 description: >
-  Use when the user says "create a plan", "break this down", or
-  "plan the implementation". Creates structured implementation plans when
-  requirements are already known. For exploration, use brainstorming.
+  Use when the user says "create a plan", "write up a plan", "break this down",
+  or "plan the implementation". Produces a human-readable markdown plan file.
+  Takes priority over orchestrate_plan MCP op for explicit plan-writing requests.
+  For exploration or ideation, use brainstorming. For automated task orchestration,
+  the engine uses orchestrate_plan directly without this skill.
 ---
 
 # Writing Plans

package/dist/skills/soleri-yolo-mode/SKILL.md

@@ -1,5 +1,6 @@
 ---
 name: soleri-yolo-mode
+tier: default
 description: >
   Use when the user says "yolo", "autonomous", "skip approvals",
   "full auto", or "hands off". Activates autonomous execution mode