@goodtek/vibeops 0.7.22 → 1.1.1

package/dist/lib/task.js

@@ -34,9 +34,6 @@ export function statusDisplay(status) {
 }
 function extractIdFromFilename(file) {
     const name = basename(file);
-    const mvp = /^TASK-mvp/i.exec(name);
-    if (mvp)
-        return "TASK-mvp";
     const m = /^(TASK-\d+)/i.exec(name);
     return m ? m[1].toUpperCase() : basename(file, ".md");
 }
@@ -103,7 +100,7 @@ export async function scanTasks(tasksDir) {
         return [];
     const entries = await readdir(tasksDir, { withFileTypes: true });
     const files = entries
-        .filter((e) => e.isFile() && e.name.endsWith(".md") && /^TASK-(?:\d+|mvp)/i.test(e.name))
+        .filter((e) => e.isFile() && e.name.endsWith(".md") && /^TASK-\d+/i.test(e.name))
         .map((e) => join(tasksDir, e.name))
         .sort();
     const out = [];
@@ -141,19 +138,13 @@ export function pickNextTask(tasks) {
     if (review)
         return review;
     const planned = tasks.filter((t) => t.status === "planned");
-    const mvp = planned.find((t) => t.id.toUpperCase() === "TASK-MVP");
-    return mvp ?? planned[0] ?? null;
+    return planned[0] ?? null;
 }
 const TEMPLATE_TASK_ID = "TASK-000";
 export function filterActionableTasks(tasks) {
     return tasks.filter((t) => t.id.toUpperCase() !== TEMPLATE_TASK_ID);
 }
-export function isMvpTaskId(id) {
-    return id.toUpperCase() === "TASK-MVP";
-}
 function taskSortKey(id) {
-    if (isMvpTaskId(id))
-        return 1_000_000;
     const m = /^TASK-(\d+)$/i.exec(id.trim());
     return m ? Number.parseInt(m[1], 10) : 0;
 }
@@ -191,26 +182,20 @@ export async function pickActiveTask(tasksDir, cwd) {
 }
 export async function findTaskFile(tasksDir, taskId) {
     const all = await scanTasks(tasksDir);
-    const normalized = taskId.trim();
-    const target = /^mvp$/i.test(normalized) || /^task-mvp$/i.test(normalized)
-        ? "TASK-MVP"
-        : normalized.toUpperCase();
+    const target = normalizeTaskRef(taskId);
     for (const t of all) {
         if (t.id.toUpperCase() === target)
             return t.filePath;
     }
     return null;
 }
+function normalizeTaskRef(ref) {
+    const t = ref.trim().toUpperCase();
+    return t.startsWith("TASK-") ? t : `TASK-${t}`;
+}
 const TASK_FILENAME_RE = /^TASK-(\d+)(?:-(.+))?$/i;
-const TASK_MVP_FILENAME_RE = /^TASK-mvp(?:-(.+))?$/i;
 export function parseTaskFilename(filePath) {
     const stem = basename(filePath, extname(filePath));
-    const mvp = TASK_MVP_FILENAME_RE.exec(stem);
-    if (mvp) {
-        const tail = (mvp[1] ?? "").trim().toLowerCase();
-        const slug = tail.length > 0 ? `mvp-${tail}` : "mvp";
-        return { id: "TASK-mvp", number: "mvp", slug };
-    }
     const m = TASK_FILENAME_RE.exec(stem);
     if (!m) {
         return { id: stem.toUpperCase(), number: "000", slug: stem.toLowerCase() };
@@ -368,6 +353,12 @@ function renderGitContextBlock(ctx) {
     if (typeof ctx.doneAt === "string" && ctx.doneAt.length > 0) {
         lines.push(`- Done At: \`${ctx.doneAt}\``);
     }
+    if (typeof ctx.mergeRequestUrl === "string" && ctx.mergeRequestUrl.length > 0) {
+        lines.push(`- Merge Request: ${ctx.mergeRequestUrl}`);
+    }
+    if (typeof ctx.pushedAt === "string" && ctx.pushedAt.length > 0) {
+        lines.push(`- Pushed At: \`${ctx.pushedAt}\``);
+    }
     return lines.join("\n");
 }
 export async function upsertGitContext(filePath, ctx) {
@@ -377,8 +368,8 @@ export async function upsertGitContext(filePath, ctx) {
     if (locateSection(raw, "Git Context")) {
         updated = replaceSectionContent(raw, "Git Context", block);
     }
-    else if (locateSection(raw, "MVP Phase")) {
-        updated = insertSectionAfter(raw, "MVP Phase", "Git Context", block);
+    else if (locateSection(raw, "Test Plan")) {
+        updated = insertSectionAfter(raw, "Test Plan", "Git Context", block);
     }
     else if (locateSection(raw, "Status")) {
         updated = insertSectionAfter(raw, "Status", "Git Context", block);
@@ -396,7 +387,15 @@ const GIT_CTX_RE = {
     taskBranch: /^-\s+Task Branch:\s*`([^`]+)`/m,
     startedAt: /^-\s+Started At:\s*`([^`]+)`/m,
     doneAt: /^-\s+Done At:\s*`([^`]+)`/m,
+    mergeRequestUrl: /^-\s+Merge Request:\s*(.+)$/m,
+    pushedAt: /^-\s+Pushed At:\s*`([^`]+)`/m,
 };
+export async function markGitContextDone(filePath) {
+    const ctx = await readGitContext(filePath);
+    if (ctx === null)
+        return;
+    await upsertGitContext(filePath, { ...ctx, doneAt: new Date().toISOString() });
+}
 export async function readGitContext(filePath) {
     const raw = await readText(filePath);
     const content = readSection(raw, "Git Context");
@@ -409,8 +408,15 @@ export async function readGitContext(filePath) {
     if (!baseBranch || !baseCommit || !taskBranch || !startedAt)
         return null;
     const doneAt = content.match(GIT_CTX_RE.doneAt)?.[1];
+    const mergeRequestUrl = content.match(GIT_CTX_RE.mergeRequestUrl)?.[1]?.trim();
+    const pushedAt = content.match(GIT_CTX_RE.pushedAt)?.[1];
     const ctx = { baseBranch, baseCommit, taskBranch, startedAt };
     if (typeof doneAt === "string" && doneAt.length > 0)
         ctx.doneAt = doneAt;
+    if (typeof mergeRequestUrl === "string" && mergeRequestUrl.length > 0) {
+        ctx.mergeRequestUrl = mergeRequestUrl;
+    }
+    if (typeof pushedAt === "string" && pushedAt.length > 0)
+        ctx.pushedAt = pushedAt;
     return ctx;
 }

package/dist/types/config.js

@@ -1,17 +1 @@
 export const VIBEOPS_CONFIG_SCHEMA_VERSION = 1;
-export const DEFAULT_NOTION_CONFIG = {
-    enabled: false,
-    projectsTargetId: "",
-    tasksTargetId: "",
-    projectsDatabaseId: "",
-    tasksDatabaseId: "",
-};
-export const DEFAULT_GITHUB_CONFIG = {
-    enabled: false,
-    mode: "gh-cli",
-    owner: "",
-    repo: "",
-    remote: "origin",
-    visibility: "",
-    url: "",
-};

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@goodtek/vibeops",
-  "version": "0.7.22",
-  "description": "Workflow rails for Cursor-based vibe coding projects.",
+  "version": "1.1.1",
+  "description": "Minimal CLI rails for Cursor-based TASK-driven vibe coding.",
   "type": "module",
+  "packageManager": "pnpm@9.15.9",
   "author": "VibeOps contributors",
   "license": "MIT",
   "repository": {
@@ -29,20 +30,27 @@
   "engines": {
     "node": ">=20"
   },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/cli.js",
+    "smoke": "pnpm typecheck && pnpm build && node scripts/smoke.mjs",
+    "clean": "rm -rf dist",
+    "prepack": "pnpm clean && pnpm build",
+    "publish:dry": "pnpm publish --dry-run --no-git-checks"
+  },
   "keywords": [
     "cursor",
     "ai",
     "coding",
     "cli",
     "task",
-    "notion",
     "vibeops",
     "workflow"
   ],
   "dependencies": {
-    "@goodtek/vibeops": "^0.3.0",
     "@inquirer/prompts": "^8.4.3",
-    "@notionhq/client": "^5.20.0",
     "commander": "^12.1.0",
     "gray-matter": "^4.0.3"
   },
@@ -50,13 +58,5 @@
     "@types/node": "^20.14.0",
     "tsx": "^4.19.0",
     "typescript": "^5.5.4"
-  },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "start": "node dist/cli.js",
-    "smoke": "pnpm typecheck && pnpm build && node scripts/smoke.mjs",
-    "publish:dry": "pnpm publish --dry-run --no-git-checks"
   }
-}
+}

package/templates/.cursor/rules/02-git-safety.mdc

@@ -0,0 +1,12 @@
+---
+description: Git safety for task branches and merge requests
+alwaysApply: true
+---
+
+# Git safety
+
+- Branch policy lives in `.vibeops.json` (`integrationBranch`, `productionBranch`).
+- `vibeops task add` creates `task/*` from the **integration** branch (e.g. `develop`).
+- Include the TASK id in commit messages, e.g. `feat(task-015): short title`.
+- **`vibeops task done`** pushes the branch and opens an MR/PR — it does **not** merge locally.
+- Merge on GitHub/GitLab; CI deploys after merge. No force-push to shared branches.

package/templates/AGENTS.md

@@ -1,98 +1,38 @@
-# {{PROJECT_NAME}} — AI agent operating guide
+# {{PROJECT_NAME}} — AI agent guide
 
-> This file was installed by **VibeOps**. Every AI agent on this project (including Cursor) reads it before touching code.
-
-## Purpose
-
-This project runs **Cursor-based vibe coding** on rails. The execution input is **`docs/tasks/TASK-*.md`**, not chat history.
-
-## Required reading before you code
-
-Read the docs below **before you start implementing**. Order top to bottom.
-
-| Document                                   | Why                                                       |
-| ------------------------------------------ | --------------------------------------------------------- |
-| `docs/project/05-current-state.md`         | Where the project is today and what comes next             |
-| `docs/project/00-overview.md`              | Vision, terminology, MVP boundaries                       |
-| `docs/project/02-mvp-scope.md`             | What is in / out of MVP                                   |
-| `docs/project/03-architecture.md`          | System, folders, data flow                                |
-| `docs/project/04-tech-stack.md`            | Tools used to build the project                            |
-| `docs/project/06-decisions.md`             | Decisions already made (avoid conflicts)                   |
-| `docs/project/07-backlog.md`               | TASK order and definition of done                          |
-| **Current TASK file** `docs/tasks/TASK-NNN-*` | Scope and Acceptance Criteria for the current TASK     |
-
-`docs/project/01-requirements.md`, `08-env.md`, `09-deployment.md` are referenced as needed. **Always read the entire current TASK file.**
+> Installed by **VibeOps**. Cursor reads this repo, not chat history.
 
 ## Source of truth
 
-| What                       | Where                              |
-| -------------------------- | ---------------------------------- |
-| AI execution input         | Git `docs/tasks/*.md`              |
-| Project design and status  | Git `docs/project/*.md`            |
-| Change history and rollback | Git commits / branches            |
-| Human dashboard            | Notion (metadata only, never body) |
-| **Not** a source of truth  | Chat (Cursor history, Slack)       |
-
-## TASK-driven development rules
-
-1. Implement **one TASK at a time**.
-2. Stay inside the TASK's **Scope / Acceptance Criteria**.
-3. Before adding new code, **search** for existing implementations or patterns and avoid duplication.
-4. **Every mutating command** should support **`--dry-run`** (or an equivalent) so the plan can be previewed without side effects.
-5. **Large refactors** happen only when a dedicated TASK calls for them.
-6. **Notion / Git integrations** are only added when an explicit TASK assigns that responsibility.
-7. When the work is finished, update docs per [Completion report](#completion-report) and `.cursor/rules/04-docs-update.mdc`.
-
-Details live in `.cursor/rules/`.
-
-## Agent roles
-
-`.vibeops/agents/*.md` defines 8 agents for this project.
-
-- `orchestrator` — picks the next TASK and delegates to other agents.
-- `planner` — expands an idea into `docs/project/{00,01,02,07}`.
-- `architect` — fills in `docs/project/{03,04}` (architecture, tech stack).
-- `builder` — takes one TASK and edits code.
-- `reviewer` — compares the diff against the Acceptance Criteria.
-- `tester` — runs the Test Plan and fills in Test Result.
-- `docs` — updates `05-current-state.md`, the TASK Result, and `docs/logs/`.
-- `recovery` — diagnoses rollback options (destructive actions require `--confirm`).
-
-## Forbidden
-
-- Changing requirements or implementing things "loosely" based on chat alone.
-- Editing code or config **without reading the current TASK file**.
-- Mixing **multiple TASKs** in one session, or adding a large structure (e.g. `src/`) without a TASK.
-- Features **outside the TASK Scope** or **outside the MVP**.
-- Creating similar modules **without searching first**.
-- Performing **large refactors** without a dedicated TASK.
-- Adding **Notion / Git integration** that the TASK does not authorize.
-- Calling the TASK done without updating **`05-current-state.md` / the TASK file / `docs/logs/YYYY-MM-DD.md`**.
-
-## Cursor rule files
+| What | Where |
+|------|--------|
+| Current work | `docs/tasks/TASK-NNN-*.md` |
+| Project memory | `docs/project/05-current-state.md`, `03-architecture.md`, `06-decisions.md` |
+| Change history | Git commits on task branches |
+| **Not** trusted | Cursor chat, Slack |
 
-| File                                                  | Contents                                                  |
-| ----------------------------------------------------- | --------------------------------------------------------- |
-| `.cursor/rules/00-project-governance.mdc`             | Source of truth, one-TASK rule, MVP scope                  |
-| `.cursor/rules/01-agent-orchestration.mdc`            | Roles of the 8 agents and how they collaborate            |
-| `.cursor/rules/02-task-workflow.mdc`                  | How to start / run / finish a TASK, dry-run first         |
-| `.cursor/rules/03-git-safety.mdc`                     | Branch / rollback safety, no force-push                    |
-| `.cursor/rules/04-docs-update.mdc`                    | Mandatory doc updates after implementation                 |
+## Before you code
 
-## Completion report
+1. `docs/project/05-current-state.md`
+2. `docs/project/03-architecture.md` and `06-decisions.md` when relevant
+3. **The full current TASK file** under `docs/tasks/`
 
-When you finish a TASK, include at least the following in your chat response:
+## Workflow (human + CLI)
 
-1. **TASK ID** (for example `TASK-001`).
-2. **Summary** — 2 to 4 sentences on what was achieved.
-3. **Changed files** — list of the main paths.
-4. **Verification** — the commands you ran and their results.
-5. **Doc updates** — confirm you updated `05-current-state.md`, the TASK's Result / Test Result, and `docs/logs/YYYY-MM-DD.md`.
+```bash
+vibeops init              # once
+vibeops task add          # new TASK + branch
+# Plan in Cursor Ask: @docs/tasks/TASK-NNN-….md
+# Build in Cursor Agent: same file + Scope / Acceptance Criteria
+vibeops task done         # close TASK, update project docs, push + open MR/PR
+vibeops status            # briefing
+vibeops llm connect       # set up LLM providers and pick default
+```
 
-Do not end the report with just "done".
+## Rules
 
-## VibeOps metadata
+- **One TASK at a time** — stay inside Scope and Acceptance Criteria.
+- **Search** before adding files; reuse existing patterns.
+- When the TASK is finished, **Result** and **Test Result** must be filled before `vibeops task done`.
 
-- Project name: `{{PROJECT_NAME}}`
-- Bootstrapped by: VibeOps `{{VIBEOPS_VERSION}}`
-- Created at: `{{CREATED_AT}}`
+Details: `.cursor/rules/`.

package/templates/clients/claude/CLAUDE.md

@@ -0,0 +1,28 @@
+# {{PROJECT_NAME}} — Claude Code
+
+Read **`AGENTS.md`** first (VibeOps workflow and source of truth).
+
+## Skills (project)
+
+| Skill | When |
+|-------|------|
+| `/plan-task` | Refine `docs/tasks/TASK-NNN-*.md` before coding |
+| `/implement-task` | Build per TASK Scope and Acceptance Criteria |
+
+Skills live in `.claude/skills/`.
+
+## Session start
+
+1. `docs/project/05-current-state.md`
+2. The **full** current `docs/tasks/TASK-NNN-*.md` file
+3. `docs/project/03-architecture.md` and `06-decisions.md` when relevant
+
+## Git
+
+- Branch: `task/*` from `vibeops task add`
+- Commit messages include the TASK id, e.g. `feat(task-015): short title`
+- Do not merge to main unless the human runs `vibeops task done` or asks
+
+## Finishing
+
+Fill **Result** and **Test Result** in the TASK file, then tell the human to run `vibeops task done TASK-NNN`.

package/templates/clients/cursor/.cursor/rules/01-task-source-of-truth.mdc

@@ -0,0 +1,12 @@
+---
+description: TASK markdown is the execution source of truth; one TASK at a time
+alwaysApply: true
+---
+
+# TASK-driven work
+
+- Implement **one TASK** only (`docs/tasks/TASK-NNN-*.md`).
+- Read the **entire** current TASK file before changing code or docs.
+- Work only inside **Scope** and **Acceptance Criteria**.
+- Do not start another TASK id unless the human asks.
+- If chat and TASK docs disagree, **fix the docs first**, then implement.

package/templates/clients/cursor/.cursor/rules/02-git-safety.mdc

@@ -0,0 +1,11 @@
+---
+description: Git safety for task branches and commits
+alwaysApply: true
+---
+
+# Git safety
+
+- Use branch pattern `task/*` created by `vibeops task add`.
+- Include the TASK id in commit messages, e.g. `feat(task-015): short title`.
+- **No force-push** to shared branches (`main`, `master`).
+- Do not merge or push unless the human runs `vibeops task done` or asks explicitly.

package/templates/clients/cursor/.cursor/rules/03-docs-on-done.mdc

@@ -0,0 +1,13 @@
+---
+description: Update TASK Result and project memory when finishing work
+alwaysApply: true
+---
+
+# Docs when finishing a TASK
+
+Before `vibeops task done`:
+
+1. Fill **Result** and **Test Result** in the TASK file (paths, commands, outcomes — facts only).
+2. If architecture or decisions changed, note them in the TASK; `task done` updates `docs/project/*`.
+
+Do not mark a TASK complete with placeholder `(not yet)` sections.

package/templates/core/AGENTS.md

@@ -0,0 +1,44 @@
+# {{PROJECT_NAME}} — AI agent guide
+
+> Installed by **VibeOps**. Agents read this repo and `docs/tasks/`, not chat history.
+
+## Source of truth
+
+| What | Where |
+|------|--------|
+| Current work | `docs/tasks/TASK-NNN-*.md` |
+| Project memory | `docs/project/05-current-state.md`, `03-architecture.md`, `06-decisions.md` |
+| Change history | Git commits on task branches |
+| **Not** trusted | Chat history, Slack |
+
+## Before you code
+
+1. `docs/project/05-current-state.md`
+2. `docs/project/03-architecture.md` and `06-decisions.md` when relevant
+3. **The full current TASK file** under `docs/tasks/`
+
+## Workflow (human + CLI)
+
+```bash
+vibeops init              # once (pick Cursor / Claude Code / Codex packs)
+vibeops task add          # new TASK + branch
+# Plan: refine TASK file with your agent (see client skills below)
+# Build: implement per TASK Scope / Acceptance Criteria
+vibeops task done         # close TASK, update project docs, merge
+vibeops status            # briefing
+vibeops llm connect       # LLM for task add / task done
+```
+
+## Client packs (installed at init)
+
+| Tool | Rules / guide | Skills |
+|------|----------------|--------|
+| **Cursor** | `.cursor/rules/` | `.cursor/skills/` (`plan-task`, `implement-task`) |
+| **Claude Code** | `CLAUDE.md` | `.claude/skills/` |
+| **Codex CLI** | `AGENTS.md` (this file) | `.agents/skills/` |
+
+## Rules (all agents)
+
+- **One TASK at a time** — stay inside Scope and Acceptance Criteria.
+- **Search** before adding files; reuse existing patterns.
+- Fill **Result** and **Test Result** before `vibeops task done`.

package/templates/core/docs/logs/README.md

@@ -0,0 +1,7 @@
+# Daily logs
+
+Append-only files: `docs/logs/YYYY-MM-DD.md`.
+
+`vibeops task done` may append a short entry when a TASK closes.
+
+Keep entries factual: TASK id, paths touched, commands run.

package/templates/core/docs/project/03-architecture.md

@@ -0,0 +1,15 @@
+# Architecture
+
+> Living overview. Update when structure or major paths change (often via `vibeops task done`).
+
+## System
+
+(describe stack and main folders as the project grows)
+
+## Key paths
+
+| Area | Path |
+|------|------|
+| Application | (TBD) |
+| TASK docs | `docs/tasks/` |
+| Project memory | `docs/project/` |

package/templates/core/docs/project/05-current-state.md

@@ -0,0 +1,15 @@
+# Current state
+
+> Facts only. Updated by `vibeops task done` and humans.
+
+## Stage
+
+- Bootstrapped with VibeOps. No TASK started yet.
+
+## Active TASK
+
+(none)
+
+## Next step
+
+Run `vibeops task add` to create the first TASK.

package/templates/core/docs/project/06-decisions.md

@@ -0,0 +1,9 @@
+# Decisions
+
+> Append-only log. Add bullets when a TASK locks a choice — do not rewrite history.
+
+## D-001 · VibeOps workflow
+
+- **Date:** {{CREATED_AT}}
+- **Decision:** TASK-driven development with `vibeops task add` / `task done` and Cursor for plan/build.
+- **Why:** Git `docs/tasks` beats chat as source of truth.

package/templates/core/docs/tasks/TASK-000-template.md

@@ -0,0 +1,37 @@
+# TASK-NNN · title
+
+## Status
+
+Planned
+
+## Goal
+
+(what becomes possible when this TASK ships)
+
+## Scope
+
+- 
+
+## Out of Scope
+
+- 
+
+## Acceptance Criteria
+
+1. 
+
+## Test Plan
+
+- 
+
+## Git Context
+
+(populated by `vibeops task add`)
+
+## Result
+
+(not yet)
+
+## Test Result
+
+(not yet)

package/templates/skills-shared/implement-task/SKILL.md

@@ -0,0 +1,22 @@
+---
+name: implement-task
+description: Implements the current VibeOps TASK per Scope and Acceptance Criteria. Use when building features for docs/tasks/TASK-NNN.md.
+disable-model-invocation: true
+---
+
+# Implement a TASK
+
+## Read first
+
+1. `AGENTS.md` and your agent rules (e.g. `.cursor/rules/`, `CLAUDE.md`)
+2. `docs/project/05-current-state.md`, `03-architecture.md`, `06-decisions.md`
+3. The TASK file referenced by the human
+
+## Instructions
+
+1. Work **only** within Scope and Acceptance Criteria.
+2. Search the repo before adding files; match existing patterns.
+3. Fill **Result** and **Test Result** with facts when done.
+4. Do not run `vibeops task done` or merge — the human closes the TASK.
+
+Tell the human to run `vibeops task done TASK-NNN` when ready.

package/templates/skills-shared/plan-task/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: plan-task
+description: Refines a VibeOps TASK file (Goal, Scope, AC, Test Plan) via dialogue. Use when planning or editing docs/tasks/TASK-NNN.md before implementation.
+disable-model-invocation: true
+---
+
+# Plan a TASK
+
+The human opened a TASK file (e.g. `docs/tasks/TASK-015-….md`).
+
+## Instructions
+
+1. Read `AGENTS.md`, your agent rules, and the TASK file; read `docs/project/05-current-state.md`.
+2. Ask only what is missing to make **Scope**, **Acceptance Criteria**, and **Test Plan** verifiable.
+3. Edit the TASK file in place — do not create a second TASK id.
+4. Keep **Out of Scope** explicit.
+5. Do not write application code in this step unless the human asks.
+
+When planning is enough, tell the human to implement per the TASK (Agent mode / Codex / Claude Code as they prefer).

package/dist/agent/loader.js

@@ -1,71 +0,0 @@
-import { readdir } from "node:fs/promises";
-import { basename, extname, join } from "node:path";
-import matter from "gray-matter";
-import { isDirectory, readText } from "../lib/filesystem.js";
-function metaFromFile(filePath, data, body) {
-    const fallbackName = basename(filePath, extname(filePath));
-    const name = typeof data["name"] === "string" ? data["name"] : fallbackName;
-    const role = typeof data["role"] === "string" ? data["role"] : extractFirstHeading(body);
-    const description = typeof data["description"] === "string" ? data["description"] : undefined;
-    return { name, role, description, filePath };
-}
-function extractFirstHeading(body) {
-    for (const line of body.split("\n")) {
-        const m = /^#\s+(.*)$/.exec(line.trim());
-        if (m)
-            return m[1].trim();
-    }
-    return "(no role)";
-}
-function frontmatterSlice(raw) {
-    if (!raw.startsWith("---"))
-        return "";
-    const end = raw.indexOf("\n---", 3);
-    if (end < 0)
-        return "";
-    return raw.slice(0, end + 4);
-}
-export async function loadAgent(filePath) {
-    const raw = await readText(filePath);
-    const parsed = matter(raw);
-    const meta = metaFromFile(filePath, parsed.data, parsed.content);
-    return {
-        meta,
-        body: parsed.content.trimStart(),
-        rawFrontmatter: frontmatterSlice(raw),
-        raw,
-    };
-}
-export async function listAgents(agentsDir) {
-    if (!(await isDirectory(agentsDir)))
-        return [];
-    const entries = await readdir(agentsDir, { withFileTypes: true });
-    const files = entries
-        .filter((e) => e.isFile() && e.name.endsWith(".md"))
-        .map((e) => join(agentsDir, e.name))
-        .sort();
-    const records = [];
-    for (const f of files) {
-        try {
-            records.push(await loadAgent(f));
-        }
-        catch {
-            // skip malformed agent files
-        }
-    }
-    return records;
-}
-export async function findAgent(agentsDir, name) {
-    const all = await listAgents(agentsDir);
-    const target = name.toLowerCase();
-    for (const a of all) {
-        if (a.meta.name.toLowerCase() === target)
-            return a;
-    }
-    for (const a of all) {
-        const filenameKey = basename(a.meta.filePath, extname(a.meta.filePath)).toLowerCase();
-        if (filenameKey === target)
-            return a;
-    }
-    return null;
-}