@debian777/kairos-mcp 3.3.3 → 3.4.0

package/dist/cli/commands/mint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mint.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyDpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmHlD"}
+{"version":3,"file":"mint.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmHlD"}

package/dist/cli/commands/mint.js

@@ -2,13 +2,17 @@
  * kairos mint command
  */
 import { closeSync, fstatSync, openSync, readFileSync, readdirSync } from 'fs';
-import { join, relative, resolve } from 'path';
+import { basename, join, relative, resolve } from 'path';
 import { ApiClient } from '../api-client.js';
 import { handleApiError } from '../auth-error.js';
 import { writeError, writeJson } from '../output.js';
 function isMdFileName(name) {
     return name.endsWith('.md');
 }
+/** Directory batches skip README.md (human docs in bundles); single-file mint is unchanged. */
+function isBatchSkippedMd(relOrName) {
+    return basename(relOrName.replace(/\\/g, '/')) === 'README.md';
+}
 /**
  * Open path read-only, require regular file, read UTF-8 from the same fd
  * (avoids path-based stat-then-read races; CodeQL js/file-system-race).
@@ -33,6 +37,8 @@ function collectMdFiles(absRoot, recursive) {
         for (const d of dirents) {
             if (!isMdFileName(d.name))
                 continue;
+            if (isBatchSkippedMd(d.name))
+                continue;
             paths.push(join(absRoot, d.name));
         }
         return paths.sort((a, b) => a.localeCompare(b));
@@ -42,6 +48,8 @@ function collectMdFiles(absRoot, recursive) {
     for (const rel of relEntries) {
         if (!rel || !isMdFileName(rel))
             continue;
+        if (isBatchSkippedMd(rel))
+            continue;
         paths.push(join(absRoot, rel));
     }
     return paths.sort((a, b) => a.localeCompare(b));

package/dist/cli/commands/mint.js.map

@@ -1 +1 @@
-{"version":3,"file":"mint.js","sourceRoot":"","sources":["../../../src/cli/commands/mint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mint.js","sourceRoot":"","sources":["../../../src/cli/commands/mint.ts"],"names":[],"mappings":"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"}

package/dist/embed-docs/mem/00000000-0000-0000-0000-000000002001.md

@@ -1,13 +1,13 @@
 ---
-version: "3.3.3"
+version: "3.4.0"
 slug: create-new-protocol
 title: Create New KAIROS Protocol Chain
 ---
 
 # Create New KAIROS Protocol Chain
 
-Guide an AI agent through creating a new executable protocol chain in KAIROS.
-This protocol is offered when kairos_search finds no match.
+Guide an AI agent through authoring a new executable protocol chain in KAIROS.
+This protocol is offered when kairos_search finds no match. Review and publishing continue in Chain 2 (`create-new-protocol-review`).
 
 ## Natural Language Triggers
 
@@ -27,7 +27,8 @@ This protocol is offered when kairos_search finds no match.
 - Confirm with the user that they want to create a new protocol when search found no match.
 - Include Natural Language Triggers as the first H2 and Completion Rule as the last H2.
 - Apply DRY: no duplicated H2s, no boilerplate sections — fold shared content into steps or extract to a reference.
-- Enforce 350-line max per file. If content exceeds this, split into linked chains (via `mcp` challenge with `kairos_search`) or extract a type extension / reference.
+- Enforce 350-line max per file. If content exceeds this, split into linked chains or extract a type extension / reference.
+- Load `challenge-type-guide` policy via `kairos_begin(key: "challenge-type-guide")` when choosing challenge types for steps. `comment` is the last resort — use `shell` or `mcp` whenever the step produces an observable artifact.
 
 **Good trigger examples:**
 - "Create a new KAIROS protocol for code review" → run this protocol
@@ -37,227 +38,188 @@ This protocol is offered when kairos_search finds no match.
 - "Run the standardize project protocol" → use search/begin, not this
 - "Search for deployment protocol" → use kairos_search, not this
 
-## Confirm Intent
-
-Ask: "No existing protocol matched your query. Create a new one, or refine your search?"
+---
 
-```json
-{
-  "challenge": {
-    "type": "user_input",
-    "user_input": { "prompt": "Confirm you want to create a new protocol chain" },
-    "required": true
-  }
-}
-```
+## Prerequisites
 
-## Gather Requirements
+This protocol requires context from the triggering search:
 
-Collect the key details for the new protocol.
+- `{search_query}` — the original user query that yielded no match
+- `{search_results}` — kairos_search results (empty or weak matches)
+- `{trigger_source}` — `user-explicit` (user asked to create) or `agent-offered` (search returned no match)
 
-**1. Determine the pattern:**
+**Work directory:** `$KAIROS_WORK_DIR` is provided by the engine (created at `kairos_begin`, cleaned at `kairos_attest`). All draft files go here.
 
-| Signal | Pattern |
-|---|---|
-| One workflow, no variants | **Standalone** — one protocol, all steps inline |
-| Multiple issue types / output formats / media | **Router + Extensions** — router classifies, routes via `kairos_search` |
-| Domain has a decision tree (which type? which format?) | **Router + Extensions** |
-| Reference material needed by steps | Extract to a separate file, not a protocol |
+**Security:** Do NOT write credentials, tokens, or secrets into draft files. Use placeholder references (`${SECRET_NAME}`) for sensitive values.
 
-Real examples: Compose (writing router → 5 extensions), BNX/BIB (Jira routers → type-specific creation protocols).
+---
 
-**2. Collect per protocol:**
+## Confirm Intent [SUBAGENT]
 
-- **Title**: clear, descriptive (becomes H1)
-- **Steps**: what the protocol does (each becomes H2 with a challenge)
-- **Challenge type per step**: comment (agent output), user_input (human gate), mcp (tool call), shell (command)
-- **Domain reference**: guides/docs the protocol should load?
-- **Existing protocols**: `kairos_search` for related — reuse, compose, or extract shared content?
-- **DRY check**: what content would be duplicated across extensions? Extract to a shared reference or the router body.
-- **Size check**: will any single file exceed 350 lines? If yes, split into chains or extract a reference now — do not plan to "trim later".
+Gate applies only when the **agent** decides to offer protocol creation (kairos_search returned no strong match). Skip when the **user** explicitly requested creation (trigger phrase matched).
 
-**3. If Router pattern:**
+**Input:** `{search_query}`, `{search_results}`, `{trigger_source}`.
 
-- What are the variants? (each becomes an extension protocol)
-- What decision questions classify the variant?
-- What types are forbidden?
+**Actions:**
+1. **If `{trigger_source}` = user-explicit:** Set `{intent}` = confirmed. Skip to next step.
+2. **If `{trigger_source}` = agent-offered:**
+   - Present the search results (or lack thereof) to the user.
+   - Ask: "No existing protocol matched your query. Create a new one, or refine your search?"
+   - Wait for explicit confirmation before proceeding.
 
-Summarize all gathered requirements.
+**Output:** `{intent}` = confirmed | refined-search | cancelled, plus any user clarifications on scope.
 
 ```json
-{
-  "challenge": {
-    "type": "comment",
-    "comment": { "min_length": 50 },
-    "required": true
-  }
-}
+{"challenge":{"type":"user_input","user_input":{"prompt":"Confirm you want to create a new protocol chain (auto-confirmed when user explicitly requested creation)"},"required":true}}
 ```
 
-## Draft Markdown
+## Gather Requirements [SUBAGENT]
 
-Using the requirements, draft the full markdown for `kairos_mint`.
+Collect all inputs needed to draft the protocol. Write the requirements summary to `$KAIROS_WORK_DIR/requirements.md`.
 
-**DRY — Don't Repeat Yourself:**
+**Input:** `{search_query}`, `{intent}` = confirmed, `$KAIROS_WORK_DIR`, any user clarifications on scope.
 
-Every piece of knowledge must live in exactly one place in the protocol family. Before writing any content, ask: "Does this already exist in another protocol, a shared reference, or CLAUDE.md?"
+**Actions:**
 
-- Boilerplate (auth handling, assignment workflow, error tables, validation checklists) belongs **inside the step that needs it** — one sentence, not a section. If it's identical across a protocol family, extract it to a shared reference file and load it via `kairos_begin(key:...)`.
-- If two protocols share >50% of their body, extract the shared logic into a base protocol or reference.
-- Every H2 must earn its place: if it has no challenge, it's not a step — fold its content into a step that does.
-- Never duplicate an H2 heading within a file. KAIROS treats each H2 as a step — duplicates create phantom steps.
+1. **Determine the pattern:**
 
-**350-line maximum per file:**
-
-No protocol file may exceed 350 lines. Both humans and AI lose coherence on longer documents.
-
-- If a protocol grows beyond 350 lines, **split it** — use an `mcp` challenge with `kairos_begin(key:...)` to link the continuation chain, or extract domain-specific content into a reference/checklist file.
-- Router protocols are naturally short (~50–80 lines). Extension protocols should target 100–200 lines.
-- Type extensions and reference files (not full protocols) should stay under 150 lines.
-- Measure after drafting: `wc -l <file>`. If over 350, refactor before minting.
+| Signal | Pattern |
+|---|---|
+| One workflow, no variants | **Standalone** — one protocol, all steps inline |
+| Multiple issue types / output formats / media | **Router + Extensions** — router classifies, routes via `kairos_search` |
+| Domain has a decision tree (which type? which format?) | **Router + Extensions** |
+| Reference material needed by steps | Extract to a separate file, not a protocol |
 
-**Generic-first — create generic, link from detailed:**
+Real examples: Compose (writing router → 5 extensions), BNX/BIB (Jira routers → type-specific creation protocols).
 
-Create protocols from generic to detailed. The generic chain comes first and must stand alone — it works even with zero extensions. Specializations (type checklists, domain extensions) are created second and link *back* to the generic via `kairos_begin(key:...)`.
+2. **Collect per protocol:**
+   - **Title**: clear, descriptive (becomes H1)
+   - **Steps**: what the protocol does (each becomes H2 with a challenge)
+   - **Challenge type per step**: pick using the decision tree from `kairos_begin(key: "challenge-type-guide")` — `shell` or `mcp` first, `comment` only for pure reasoning
+   - **Domain reference**: guides/docs the protocol should load?
+   - **Existing protocols**: `kairos_search` for related — reuse, compose, or extract shared content?
+   - **DRY check**: what content would be duplicated across extensions? Extract to a shared reference or the router body.
+   - **Size check**: will any single file exceed 350 lines? If yes, split into chains or extract a reference now — do not plan to "trim later".
 
-- The generic protocol defines the workflow scaffold. The extension defines only what's different.
-- Teaching is showing the difference: an extension that only contains the delta is easier to read, write, and maintain than a full copy with scattered overrides.
-- Expansion is cheap — adding a new type means one new extension file. The generic chains don't change. Zero regression risk on existing paths.
+3. **If Router pattern:**
+   - What are the variants? (each becomes an extension protocol)
+   - What decision questions classify the variant?
+   - What types are forbidden?
 
-**Slug convention — deterministic protocol linking:**
+4. **Write requirements to file:** Summarize all gathered requirements as structured markdown and write to `$KAIROS_WORK_DIR/requirements.md`.
 
-Every protocol gets a `slug` — a short, unique, lowercase-hyphenated key for deterministic linking via `kairos_begin(key: "slug")`. The engine auto-generates it from the H1 title. Add explicit `slug:` frontmatter only when the auto-generated value is too long or ambiguous.
+**Output:** `$KAIROS_WORK_DIR/requirements.md` containing: pattern (standalone/router), title(s), step list with challenge types, slug(s), domain references, DRY assessment, size estimate.
 
-```yaml
----
-slug: jira-markdown-formatting
----
-# Jira Description Markdown Formatting via MCP
+```json
+{"challenge":{"type":"shell","shell":{"cmd":"test -f \"$KAIROS_WORK_DIR/requirements.md\" && wc -l < \"$KAIROS_WORK_DIR/requirements.md\" | awk '$1 >= 5'","timeout_seconds":5},"required":true}}
 ```
 
-**When to use slugs vs. search:**
+## Author Protocol Structure [SUBAGENT]
 
-- `kairos_begin(key: "slug")` — protocol-to-protocol routing (deterministic, exact match). Use when the author knows the target at write time.
-- `kairos_search` — user discovery (Natural Language Triggers) and runtime type-dispatch where the target depends on a runtime variable (e.g., `kairos_search("Standardize {project_type}")`).
+Write the protocol markdown — content, flow, step definitions, NLT, Completion Rule — but leave challenge blocks empty. This step is pure protocol design, not verification engineering.
 
-**Slug naming rules:**
+**Input:** `$KAIROS_WORK_DIR/requirements.md`.
 
-1. **Families (router + extensions):** hierarchical. The router slug is the family prefix. Each child expands the parent by one hyphenated segment per routing level:
-   - `jira` → `jira-bib` → `jira-bib-bug`
-   - `compose` → `compose-email`
-   - `standardize` → `standardize-analyze`
-   - An agent can derive the parent slug by stripping the last segment. This enables mechanical traversal without search.
+**Actions:**
 
-2. **Standalone protocols (no family):** action-oriented. Describe what the protocol does, not where it lives. The bundle directory is the namespace — the slug does not repeat it.
-   - Good: `create-merge-request`, `makefile-setup`, `migrate-tf-to-git-sha`
-   - Bad: `gitlab-create-merge-request` (redundant — it's already in `gitlab/`)
+1. **Apply protocol structure rules:**
+   - H1: protocol title (one H1 = one chain)
+   - First H2: Natural Language Triggers
+   - Middle H2s: one per step, with a placeholder `<!-- challenge -->` where the challenge block will go
+   - Last H2: Completion Rule
 
-3. **Shared utilities:** prefix with the family they serve, at the family root level:
-   - `jira-markdown-formatting` (used by all `jira-*` children)
-   - `jira-alternative-mcp-unavailable`
+2. **Apply Natural Language Triggers structure (required, exact order):**
+   - Trigger phrases — 3–6 quoted phrases
+   - Trigger pattern — verb + noun formula
+   - Must Never — 1–3 cases (imperative, no "should")
+   - Must Always — 1–3 mandatory behaviours
+   - Good trigger examples — 2–3 with `→ run this protocol`
+   - Bad trigger examples — 2–3 with `→ use X instead`
 
-4. **General rules:**
-   - Lowercase, hyphen-separated. No underscores, no camelCase.
-   - Short as possible while remaining unambiguous. Target 2–4 segments.
-   - The slug is a technical address — Natural Language Triggers handle discoverability. The slug does not need to sound like a sentence.
+3. **Apply DRY — Don't Repeat Yourself:**
+   - Every piece of knowledge lives in exactly one place.
+   - Boilerplate belongs **inside the step that needs it** — one sentence, not a section.
+   - If two protocols share >50% body, extract shared logic into a base protocol or reference.
+   - Every H2 earns its place. Never duplicate an H2 heading — KAIROS treats each H2 as a step.
 
-**Protocol structure rules:**
+4. **Enforce 350-line maximum per file:**
+   - Over 350 → split via `mcp` challenge with `kairos_begin(key:...)` or extract to reference.
+   - Router protocols: ~50–80 lines. Extension protocols: 100–200 lines.
 
-- H1: protocol title (one H1 = one chain)
-- First H2: Natural Language Triggers
-- Middle H2s: one per step, each ending with a ```json challenge block
-- Last H2: Completion Rule
+5. **Apply slug convention:**
+   - Families: hierarchical. Router slug = prefix. Children expand by one segment.
+   - Standalone: action-oriented. Bundle directory is the namespace — slug does not repeat it.
 
-**Natural Language Triggers structure (required, exact order):**
+6. **Apply generic-first principle:**
+   - Generic chains first; they stand alone with zero extensions.
+   - Extensions define only the delta. New type = one new file.
 
-1. Trigger phrases — 3–6 quoted phrases
-2. Trigger pattern — verb + noun formula
-3. Must Never — 1–3 cases (imperative, no "should")
-4. Must Always — 1–3 mandatory behaviours
-5. Good trigger examples — 2–3 with `→ run this protocol`
-6. Bad trigger examples — 2–3 with `→ use X instead`
+7. **Make every step SUBAGENT-ELIGIBLE:**
+   - `[SUBAGENT]` tag on each H2 step title.
+   - Explicit `**Input:**`, numbered `**Actions:**`, and `**Output:**` sections.
+   - Enough context that a subagent with no prior conversation can execute the step.
 
-**Challenge types:**
+8. **If Router pattern:** Draft the router AND each extension as separate markdown files.
+   - Classify step: decision tree table, forbidden types, common misclassifications.
+   - Route step: `kairos_begin(key: "slug")` per type, fallback.
 
-| Type | Use for | Engine validates |
-|---|---|---|
-| `comment` | Agent extracts, analyzes, drafts, summarizes | min_length |
-| `user_input` | Human confirms, approves, chooses | Non-empty response |
-| `mcp` | Agent must call a specific tool | Tool called successfully |
-| `shell` | Agent must run a command | Exit code 0 |
+9. **Write draft to file:** Write the protocol markdown to `$KAIROS_WORK_DIR/draft-protocol.md`. Every middle H2 has a `<!-- challenge -->` placeholder where the verification block will be added in the next step.
 
-**Challenge JSON format** (place at end of each step). Use a **single** concrete `type` per step (`comment`, `user_input`, `mcp`, or `shell`). Do not use pipe-separated placeholders inside `type` — each ` ```json ` block with `{"challenge":...}` becomes its own chain step when minted.
+**Output:** `$KAIROS_WORK_DIR/draft-protocol.md` with complete structure but no challenge blocks.
 
-```text
-{
-  "challenge": {
-    "type": "comment",
-    "comment": { "min_length": 50 },
-    "required": true
-  }
-}
+```json
+{"challenge":{"type":"shell","shell":{"cmd":"D=\"$KAIROS_WORK_DIR/draft-protocol.md\" && test -f \"$D\" && grep -c '^## ' \"$D\" | awk '$1 >= 3' && wc -l < \"$D\" | awk '$1 <= 350' && grep -q '^## Natural Language Triggers' \"$D\" && grep -q '^## Completion Rule' \"$D\"","timeout_seconds":5},"required":true}}
 ```
 
-**Router-specific steps:**
+## Author Challenge Blocks [SUBAGENT]
 
-- Classify step: decision tree table, forbidden types, common misclassifications. Challenge: `user_input`.
-- Route step: `kairos_begin(key: "slug")` per type, fallback field reference. Challenge: `mcp` with `tool_name: "kairos_begin"`.
+Replace every `<!-- challenge -->` placeholder in the draft with a verifiable challenge block by running the challenge-type-guide protocol.
 
-**If Router pattern:** draft the router AND each extension as separate markdown files.
+**Input:** `$KAIROS_WORK_DIR/draft-protocol.md` (from previous step).
 
-Post the full drafted markdown.
+**Actions:**
 
-```json
-{
-  "challenge": {
-    "type": "comment",
-    "comment": { "min_length": 100 },
-    "required": true
-  }
-}
-```
+1. **Run challenge type guide:** `kairos_begin(key: "challenge-type-guide")` — execute the full protocol to internalize decision tree, formats, interpreter rules, and anti-patterns.
+
+2. **Apply to each H2 step:** For every `<!-- challenge -->` placeholder, read the step's Actions and Output, apply the decision tree, select the challenge type and interpreter, write the JSON block in place.
 
-## User Review
+3. **Favour creativity over formality:** Look for non-obvious verification opportunities — a step that "analyses" might produce a file (verify line count), a step that "selects" might set a variable (verify with `test -n`). The best challenges prove work was done.
 
-Present the drafted protocol(s) to the user. Ask to approve, request changes, or cancel.
+4. **Write challenge summary:** Append `$KAIROS_WORK_DIR/challenge-summary.md` listing each step, the challenge type chosen, the interpreter (if shell), and a one-line rationale.
 
-If Router pattern, present all files (router + extensions).
+5. **Overwrite draft:** Save the fully challenged version to `$KAIROS_WORK_DIR/draft-protocol.md`.
+
+**Output:** Updated `$KAIROS_WORK_DIR/draft-protocol.md` (no placeholders remain, all JSON valid) and `$KAIROS_WORK_DIR/challenge-summary.md`.
 
 ```json
-{
-  "challenge": {
-    "type": "user_input",
-    "user_input": { "prompt": "Approve the protocol draft for minting" },
-    "required": true
-  }
-}
+{"challenge":{"type":"shell","shell":{"cmd":"D=\"$KAIROS_WORK_DIR/draft-protocol.md\" && S=\"$KAIROS_WORK_DIR/challenge-summary.md\" && test -f \"$D\" && test -f \"$S\" && ! grep -q '<!-- challenge -->' \"$D\" && perl -MJSON -0777 -ne '@b=/```json\\s*\\n(\\{.*?\\})\\s*\\n```/gs; die \"No challenge blocks\" unless @b; eval{decode_json($_)} or die \"Bad JSON: $@\" for @b; print scalar(@b).\" valid challenge blocks\\n\"' \"$D\"","timeout_seconds":5},"required":true}}
 ```
 
-## Mint Protocol
+## Chain to Review [SUBAGENT]
+
+Hand off the drafted protocol to Chain 2 for format review, stranger review, user approval, and minting.
 
-Call `kairos_mint` with the approved markdown. Use `force_update: false`
-unless the user explicitly asks to overwrite.
+**Input:** `$KAIROS_WORK_DIR` (containing `requirements.md` and `draft-protocol.md`).
 
-If Router pattern: mint the router first, then each extension.
+**Actions:**
+1. Verify both files exist in `$KAIROS_WORK_DIR`.
+2. Call `kairos_begin(key: "create-new-protocol-review")` to continue in Chain 2.
 
-Report the chain head URI(s) back to the user.
+**Output:** Chain 2 execution begins with `$KAIROS_WORK_DIR` available in the shell session.
 
 ```json
-{
-  "challenge": {
-    "type": "mcp",
-    "mcp": { "tool_name": "kairos_mint" },
-    "required": true
-  }
-}
+{"challenge":{"type":"mcp","mcp":{"tool_name":"kairos_begin","arguments":{"key":"create-new-protocol-review"}},"required":true}}
 ```
 
 ## Completion Rule
 
 Only reachable after all prior steps are solved.
 
-The user now has a minted KAIROS protocol that:
-- Is discoverable via `kairos_search` (Natural Language Triggers)
-- Uses appropriate challenge types per step
-- If Router pattern: routes to extensions via `mcp` challenge with `kairos_begin(key:...)`
-- Has validated structure (triggers, steps, challenges, completion rule)
+Chain 1 is complete when:
+1. User intent confirmed (or auto-confirmed from explicit trigger).
+2. Requirements written to `$KAIROS_WORK_DIR/requirements.md` (≥5 lines).
+3. Protocol structure drafted to `$KAIROS_WORK_DIR/draft-protocol.md` (≥3 H2 steps, ≤350 lines, NLT + Completion Rule present, `<!-- challenge -->` placeholders).
+4. All `<!-- challenge -->` placeholders replaced with valid challenge JSON blocks.
+5. Chain 2 (`create-new-protocol-review`) invoked via `kairos_begin`.
+
+Execution continues in Chain 2 for review, approval, and minting. `$KAIROS_WORK_DIR` is cleaned up by the engine at `kairos_attest`.

package/dist/embed-docs/mem/00000000-0000-0000-0000-000000002002.md

@@ -1,5 +1,6 @@
 ---
-version: "3.3.3"
+version: "3.4.0"
+slug: refine-search
 title: Get help refining your search
 ---
 
@@ -11,19 +12,20 @@ title: Get help refining your search
 
 **Run this protocol when:**
 
-- `kairos_search` returned no match, or only choices with low score (e.g. all < 0.5).
+- `kairos_search` returned no match, or only choices with low score (e.g. all < 0.5).
 - The response included a **refine** (or equivalent) choice directing you to improve the query.
 
 **Trigger pattern:** After **kairos_search** when result is no strong match / refine suggested.
 
 **Must Never:**
 
-- Run when a strong match (score ≥ 0.5) already exists — use that choice and `kairos_begin` instead.
+- Run when a strong match (score >= 0.5) already exists — use that choice and `kairos_begin` instead.
 - Run when the user has not yet asked for anything (no prior search context).
+- Loop more than once per user request — if two searches fail, the protocol likely does not exist yet.
 
 **Must Always:**
 
-- Run at most once per user request — if refining twice still yields no match, stop and offer to create a new protocol or ask the user to clarify.
+- Run at most once, then either begin the matched protocol, offer to create a new one, or ask the user to clarify.
 
 **Good trigger examples:**
 
@@ -35,51 +37,51 @@ title: Get help refining your search
 - Search returned a strong match → use that match, not this protocol
 - User asked "what protocols exist?" → use search/list, not this protocol
 
-## Step 1: Extract what the user actually wants
+## Analyse Intent [SUBAGENT]
 
-From the user's original message, identify:
-- **Goal:** What outcome do they want? (e.g. "run tests", "write docs", "create a Jira ticket")
-- **Context:** Any project, tool, domain, or proper noun they mentioned?
-- **Gaps:** What is missing or ambiguous? (e.g. "which repo?", "which doc type?", "which project key?")
+Extract what the user actually wants from their original message.
 
-If the request was a slash-command or shorthand (e.g. "/ai-docs", "do the thing"), expand it: what would a concrete version of that command look like?
+**Input:** User's original message and the failed `kairos_search` results.
 
-Write your analysis as your solution (goal + context + gaps, minimum 30 characters).
+**Actions:**
+
+1. Identify **Goal** — what outcome does the user want? (e.g. "run tests", "write docs", "create a Jira ticket")
+2. Identify **Context** — any project, tool, domain, or proper noun mentioned.
+3. Identify **Gaps** — what is missing or ambiguous? (e.g. "which repo?", "which doc type?", "which project key?")
+4. If the request was a slash-command or shorthand (e.g. "/ai-docs"), expand it to a concrete description.
+
+**Output:** Analysis with goal, context, and gaps (minimum 50 characters).
 
 ```json
-{
-  "challenge": {
-    "type": "comment",
-    "comment": { "min_length": 30 },
-    "required": true
-  }
-}
+{"challenge":{"type":"comment","comment":{"min_length":50},"required":true}}
 ```
 
-## Step 2: Build and run a refined kairos_search query
+## Refine and Re-search [SUBAGENT]
 
-Using your Step 1 analysis, construct a single search query:
-- Use 3–8 specific words (nouns and verbs, no filler). Examples: "write ai instructions zero-drift template", "jira create story BIB", "npm test lint deploy".
-- Include domain or tool names if known (e.g. "jira", "gitlab", "coding standards").
-- Do not reuse the user's exact vague phrase — that already failed.
+Construct and execute a better `kairos_search` query based on the intent analysis.
 
-Write your refined query as your solution, then call `kairos_search` with it.
+**Input:** Goal, context, and gaps from previous step.
 
-- **Strong match (score >= 0.5):** Pick that choice and call `kairos_begin` with its URI.
-- **Weak matches only (all scores < 0.5):** Ask the user to clarify, or pick the create choice to build a new protocol.
+**Actions:**
 
-Do not loop this refining protocol more than once — if two searches fail, the protocol likely does not exist yet.
+1. Build a query of 3–8 specific words (nouns and verbs, no filler). Include domain/tool names if known.
+2. Do **not** reuse the user's exact vague phrase — that already failed.
+3. Call `kairos_search` with the refined query.
+4. Evaluate results:
+   - **Strong match (score >= 0.5):** Pick that choice and call `kairos_begin` with its URI.
+   - **Weak matches only:** Ask the user to clarify, or pick the "create" choice to build a new protocol.
+
+**Output:** Either a `kairos_begin` call for the matched protocol, or a clear message to the user explaining why no match was found and what to do next.
 
 ```json
-{
-  "challenge": {
-    "type": "mcp",
-    "mcp": { "tool_name": "kairos_search" },
-    "required": true
-  }
-}
+{"challenge":{"type":"mcp","mcp":{"tool_name":"kairos_search"},"required":true}}
 ```
 
 ## Completion Rule
 
 Only reachable after all prior steps are solved.
+
+This protocol is complete when:
+1. User intent analysed (goal + context + gaps, >= 50 characters).
+2. Refined `kairos_search` executed with an improved query.
+3. One of: matched protocol begun via `kairos_begin`, new protocol creation offered, or user asked to clarify.