@amsterdamdatalabs/enact-extensions 0.1.1 → 0.1.3

package/extensions/enact-operator/skills/wiki/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: wiki
+description: "Wiki-style reference lookup delegated to the enact-wiki provider. Use when the operator wants durable project documentation or knowledge retrieval."
+---
+
+# Wiki
+
+## Purpose
+Provides access to the project's durable wiki and knowledge base by delegating to the enact-wiki provider. Operator orchestrates the request and receives the result; it does not re-implement wiki storage or retrieval. Operator-side artifacts produced by research or analysis can be persisted to the wiki via this skill.
+
+## Use When
+- The operator wants to look up a documented decision, design, or reference
+- Research findings from `$autoresearch-goal` should be persisted as a durable wiki entry
+- The operator asks "does the wiki have anything on X?"
+
+## Workflow
+1. Identify the query or document to persist.
+2. Delegate the operation to the enact-wiki provider using its wiki MCP tools.
+   - For a lookup: invoke the enact-wiki wiki query tool with the search term.
+   - For a write: invoke the enact-wiki wiki add tool with the content and title.
+   - For a list: invoke the enact-wiki wiki list tool.
+   - For a read of a specific entry: invoke the enact-wiki wiki read tool with the entry identifier.
+3. If the operation returns content, present it directly to the operator without reformatting.
+4. If persisting a Operator research artifact (e.g., `.enact/operator/research/<goalId>.md`), read the file first, then pass the content to the enact-wiki wiki add tool.
+5. Operator does not store wiki state locally. The enact-wiki provider is the canonical store.
+
+## State Contract
+- Reads: enact-wiki wiki store (via MCP tool calls), `.enact/operator/research/` files when persisting
+- Writes: enact-wiki wiki store (via MCP tool calls); no local `.enact/operator/` files written by this skill
+
+## Dependencies
+- Requires enact-wiki MCP server to be connected. If it is not available, report that to the operator and stop.
+
+## Activation
+
+When a prompt contains `$enact-operator:<skill-name>` or `$<skill-name>`, Operator's UserPromptSubmit hook records the invocation in `.enact/operator/state/skill-active.json` and adds an MCP-first context note for the agent. That note tells the agent to load/search the Enact Operator MCP namespace immediately if `operator_*` tools are not visible yet, then prefer `operator_*` tools over the `enact-operator` CLI. This skill is operator-driven — there is no durable workflow state to start automatically. The activation log gives operators and the HUD a trace of which skills were explicitly invoked.
+## Final Check
+- The query returned a result or a clear "not found" from enact-wiki
+- For writes, the enact-wiki tool confirmed the entry was saved
+- No wiki content was stored locally in `.enact/operator/` as a substitute for the enact-wiki store
+- If enact-wiki was unavailable, the operator was notified explicitly

package/extensions/enact-operator/skills/work-with-workitem/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: work-with-workitem
+description: "Lightweight Azure DevOps work-item delivery lane: implement and hand off; factory owns tracking and closure."
+---
+
+# Work With Workitem
+
+## Purpose
+
+Use `$work-with-workitem` for operator-domain delivery tied to a single Azure DevOps work item.
+
+## Domain Boundary
+
+- operator scope is intentionally lightweight: load, isolate, implement, PR, handoff, cleanup
+- enact-factory owns CI heartbeat tracking, branch policy waits, auto-merge, and lifecycle advance to `Closed`
+- this skill must not add CI polling loops or unbounded branch-policy waiting
+
+## Azure DevOps-Only Contract
+
+- use `factory_workitem_get` and `factory_assignment_record` for work-item reads and closing notes
+- use `az repos pr create --work-items <id>` to link the PR to the work item
+- do not assume or reference GitHub APIs, GitHub Actions, GitHub checks, or GitHub branch protection primitives
+
+## Required Sequence
+
+1. `factory_workitem_get` loads the target work item and confirms readiness.
+2. `EnterWorktree` isolates the implementation workspace.
+3. Execute implementation with `$ultrawork` (or `$ralph` for simple tasks).
+4. Create atomic commits with clear work-item-linked intent.
+5. Run `az repos pr create --work-items <id>` and capture the PR URL.
+6. Call `factory_assignment_record` with a closing note that includes PR URL and commit SHA.
+7. `ExitWorktree` cleans up the isolated workspace.
+
+## Behavioral Constraints
+
+- no CI poll loop in this skill; CI heartbeat belongs to `factory_watchdog_status`
+- no merge waiting or policy-wait ownership in this skill
+- no lifecycle mutation to `Closed` from this skill
+- if PR creation fails, record failure context and exit through normal cleanup
+
+## Verification Expectations
+
+- integration target is a work item tagged `test-fixture`
+- verify PR link uses `--work-items <id>`
+- verify `factory_assignment_record` includes PR URL and commit SHA
+- verify `ExitWorktree` cleanup is executed
+- do not verify CI completion or merge here
+
+## Activation
+
+When a prompt contains `$enact-operator:<skill-name>` or `$<skill-name>`, Operator's UserPromptSubmit hook records the invocation in `.enact/operator/state/skill-active.json` and adds an MCP-first context note for the agent. That note tells the agent to load/search the Enact Operator MCP namespace immediately if `operator_*` tools are not visible yet, then prefer `operator_*` tools over the `enact-operator` CLI. This skill is operator-driven — there is no durable workflow state to start automatically. The activation log gives operators and the HUD a trace of which skills were explicitly invoked.

package/extensions/enact-wiki/.agents/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "enact-wiki",
+  "version": "0.1.0",
+  "description": "Vault-backed knowledge base with semantic search, dream consolidation, and MCP tools for agent memory workflows.",
+  "license": "UNLICENSED",
+  "keywords": [
+    "enact-wiki",
+    "wiki",
+    "vault",
+    "memory",
+    "knowledge-base",
+    "qdrant",
+    "semantic-search"
+  ],
+  "targets": [
+    "claude",
+    "codex",
+    "cursor"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Enact Wiki",
+    "shortDescription": "Vault skills, MCP tools, and runtime bootstrap via `enact-wiki bootstrap`.",
+    "longDescription": "Install this plugin to expose enact-wiki MCP tools in Claude, Codex, and Cursor and enable semantic search over the workspace Qdrant collection, dream consolidation, and vault-backed knowledge workflows.",
+    "developerName": "enact-wiki",
+    "category": "Developer Tools",
+    "composerIcon": "./assets/icon.png",
+    "logo": "./assets/logo.png",
+    "capabilities": [
+      "semantic search",
+      "vault knowledge base",
+      "dream consolidation",
+      "mcp tools",
+      "qdrant vector search"
+    ]
+  },
+  "factory": {
+    "firstParty": true,
+    "operatorScope": "global"
+  }
+}

package/extensions/enact-wiki/.mcp.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "enact-wiki": {
+      "command": "enact-wiki",
+      "args": ["mcp", "."],
+      "env_vars": [
+        "ENACT_WIKI_EMBEDDING_API_KEY",
+        "AZURE_OPENAI_API_KEY",
+        "ENACT_GATEWAY_API_KEY",
+        "ENACT_WIKI_LINT_API_KEY",
+        "ENACT_WIKI_QUERY_API_KEY"
+      ]
+    }
+  }
+}

package/extensions/enact-wiki/README.md

@@ -0,0 +1,44 @@
+# enact-wiki plugin
+
+Plugin manifests for Claude Code and Codex. The Codex plugin is self-contained:
+it carries plugin-local `skills/`, `.mcp.json`, and branding assets so Codex can
+discover all capabilities from the installed plugin root.
+
+## Layout
+
+| Path | Role |
+|------|------|
+| `.claude-plugin/plugin.json` | Claude Code plugin manifest |
+| `.codex-plugin/plugin.json` | Codex plugin manifest |
+| `.mcp.json` | MCP server entry (`enact-wiki mcp .`) |
+| `skills/` | Codex-visible Enact Wiki skills |
+| `assets/` | Branding icons |
+
+## Bootstrap a vault
+
+Use `enact-wiki bootstrap <runtime>` to scaffold any directory for a
+specific provider. This copies the canonical surfaces from `vault-bootstrap/`
+into the target:
+
+```bash
+enact-wiki bootstrap claude          # .claude/commands/, .claude/settings.json, .mcp.json
+enact-wiki bootstrap opencode        # .opencode/commands/, .mcp.json, opencode.json
+enact-wiki bootstrap all             # every provider surface
+```
+
+See `enact-wiki bootstrap --help` for all supported runtimes.
+
+## Claude Code plugin registration
+
+Installing the npm package auto-registers this plugin in `~/.claude/settings.json`
+via the postinstall script. To register manually:
+
+```bash
+claude plugin add /path/to/enact-wiki/extensions
+```
+
+## Marketplace (Codex)
+
+`.agents/plugins/marketplace.json` at the repo root registers this plugin
+for local dev. For global use, point `~/.agents/plugins/marketplace.json`
+to the absolute path of this directory.

package/extensions/enact-wiki/skills/document-parser/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: document-parser
+description: Parse documents with the Kreuzberg v4 CLI via the repo-local `scripts/parse.sh` wrapper.
+---
+
+# document-parser
+
+Use when you need consistent text + metadata extraction from supported files: PDF, DOCX, PPTX, XLSX, HTML, EML, and images.
+
+## Entry point
+
+```bash
+./.codex/skills/document-parser/scripts/parse.sh <path>
+./.codex/skills/document-parser/scripts/parse.sh <path> --json
+```
+
+This wrapper is the canonical local interface and keeps parsing behavior aligned between direct skill use and repo runtime.

package/extensions/enact-wiki/skills/document-parser/scripts/parse.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# parse.sh - Extract text or JSON from a document using Kreuzberg CLI
+# Usage: parse.sh <file> [--json]
+
+set -euo pipefail
+
+export PATH="${HOME}/.kreuzberg/bin:${PATH:-}"
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: parse.sh <file> [--json]" >&2
+  exit 1
+fi
+
+FILE="$1"
+FORMAT="text"
+if [[ "${2:-}" == "--json" ]]; then
+  FORMAT="json"
+fi
+
+if [[ ! -f "$FILE" ]]; then
+  echo "File not found: $FILE" >&2
+  exit 1
+fi
+
+file_size() {
+  if stat -f%z "$1" >/dev/null 2>&1; then
+    stat -f%z "$1"
+  else
+    stat -c%s "$1"
+  fi
+}
+
+run_with_timeout() {
+  if command -v gtimeout >/dev/null 2>&1; then
+    gtimeout 60 "$@"
+    return
+  fi
+  if command -v timeout >/dev/null 2>&1; then
+    timeout 60 "$@"
+    return
+  fi
+  "$@"
+}
+
+if [[ "$(file_size "$FILE")" -gt 100000000 ]]; then
+  echo "File exceeds 100MB limit" >&2
+  exit 1
+fi
+
+if ! command -v kreuzberg >/dev/null 2>&1; then
+  echo "kreuzberg not found on PATH. Install it into \$HOME/.kreuzberg/bin or PATH first." >&2
+  exit 1
+fi
+
+CMD=(kreuzberg extract "$FILE")
+if [[ "$FORMAT" == "json" ]]; then
+  CMD+=(--format json)
+fi
+
+run_with_timeout "${CMD[@]}"

package/extensions/enact-wiki/skills/document-parser/skill.json

@@ -0,0 +1,9 @@
+{
+  "name": "document-parser",
+  "version": "1.0.0",
+  "description": "Parse and extract text + metadata from PDF, DOCX, PPTX, XLSX, HTML, EML, images using Kreuzberg v4 CLI.",
+  "commands": {
+    "parse": "Extract text or JSON from a document via Kreuzberg (scripts/parse.sh <file> [--json])"
+  },
+  "requires": ["kreuzberg"]
+}

package/extensions/enact-wiki/skills/enact-wiki/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: enact-wiki
+description: "Enact Wiki vault workflows: query and search, ingest and sync, and CLI management. Use the reference files under references/ for the slice you need."
+---
+
+# enact-wiki
+
+Codex entry for the same workflows Claude exposes as `/wiki-*` commands. This skill is an **umbrella**: open the right reference for the task.
+
+## References (read the matching file)
+
+| Topic | File |
+|------|------|
+| Query / search / read | `references/query.md` |
+| Ingest, sync, dream | `references/ingest.md` |
+| Lint, build, export, init, MCP, etc. | `references/manage.md` |
+
+## Invariants
+
+- Vault root: run `enact-wiki` from the vault directory.
+- Keep **`raw/`** immutable except through prescribed sync / ingest flows.
+- Prefer the **CLI** for mechanical steps; use the model only where a reference file says to.
+
+## Full pipeline (lint → build → links)
+
+When the user wants the end-to-end quality pass, follow `.claude/commands/wiki-all.md` or run:
+
+```bash
+enact-wiki all
+```

package/extensions/enact-wiki/skills/enact-wiki/references/ingest.md

@@ -0,0 +1,62 @@
+---
+last_update: 2026-04-30T00:00:00+00:00
+---
+
+# Ingest — Add content to the wiki
+
+## Ingest
+
+Ingest one source file. Two raw layers, two destinations:
+
+| Source | Destination |
+|---|---|
+| `raw/sources/` (PDF, documents) | `wiki/sources/<slug>.md` — one summary page |
+| `raw/sessions/` (AI transcripts) | `wiki/entities/`, `wiki/concepts/`, `wiki/syntheses/`, `wiki/comparisons/`, `wiki/questions/` — never `wiki/sources/` |
+
+CLI shortcut (raw/sources/ only):
+```bash
+enact-wiki ingest <path>
+```
+Agent workflow (all sources): follow the **Ingest Workflow** in `CLAUDE.md`.
+
+Session rules: trust frontmatter · summarise, don't copy verbatim · extract entities, decisions, questions, comparisons, syntheses · transcript stays on `sessions.html`
+
+## Sync
+
+Import agent transcripts into the wiki. Full pipeline:
+
+```text
+~/.codex/sessions → raw/sessions/ → Ingest Workflow → enact-wiki dream run → enact-wiki build
+```
+
+```bash
+enact-wiki sync [vault-root]
+```
+Flags: `--dry-run` · `--all-workspaces` · `--workspace <slug>` · `--adapter <name>` · `--strict` · `--build`
+
+If 0 new sessions: report "wiki is already up to date" and stop.
+If 1+ new sessions: ingest each, then run `enact-wiki dream run`.
+Append: `## [YYYY-MM-DD] sync | <N> sessions ingested`
+
+Hook: `scripts/hooks/session-start.sh` auto-triggers `/wiki-sync` when `raw/sessions/` changes.
+
+## Update
+
+Surgical single-page edit without full re-ingest:
+
+```bash
+/wiki-update <page-path> [reason]
+```
+
+Use when: source changed · stale claim · bump `last_update` · add contradiction.
+Do NOT use for bulk changes — use `/wiki-ingest` or `/wiki-sync`.
+
+Hard rules: never overwrite contradictions (add `## Contradictions` instead) · keep frontmatter intact · stop and re-run ingest if you need to rewrite >30% of the page.
+
+## Shared rules
+
+1. `raw/` is immutable — never modify files there.
+2. No silent overwrites — conflicting claims → `## Contradictions`.
+3. Every page has `## Connections` with at least one `[[wikilink]]`.
+4. Frontmatter is authoritative — always populate `title`, `type`, `last_update`, `confidence`, `status`.
+5. `wiki/sources/` is for `raw/sources/` only. Session content → `comparisons|concepts|entities|questions|syntheses`.

package/extensions/enact-wiki/skills/enact-wiki/references/manage.md

@@ -0,0 +1,34 @@
+---
+last_update: 2026-04-30T00:00:00+00:00
+---
+
+# Manage — CLI commands and operations
+
+## Command surface
+
+| Command | Usage | Notes |
+|---|---|---|
+| `init` | `enact-wiki init [target-dir] [vault-name] --only claude,codex,cursor,gemini,opencode,pi,hooks,docs` | `--only` required; surfaces: `claude`,`codex`,`cursor`,`gemini`,`opencode`,`pi`,`hooks`,`docs`; include `codex` whenever `opencode` is present; flags: `--list-surfaces`, `--skip <csv>`, `--workspace nested|independent`; `schema.md` is always written |
+| `build` | `enact-wiki build [--strict]` | Compiles `raw/` + `wiki/` → `site/`: `index.html`, `sessions.html`, `graph.html`, `graph-explorer.json`, `graph.jsonld`, `llms.txt`, `llms-full.txt`, `search-index.json`, `sitemap.xml`, `rss.xml`, `robots.txt`, `ai-readme.md`, `manifest.json`, per-page `wiki/<dir>/<slug>.html|txt|json` |
+| `serve` | `enact-wiki serve` | Starts local HTTP server for `site/`; binds to `127.0.0.1` by default |
+| `lint` | `enact-wiki lint [--strict]` | Finds orphans, broken `[[wikilinks]]`, contradictions, stale pages; must pass before `build` or `export` |
+| `check-links` | `enact-wiki check-links` | Verifies every `[[wikilink]]` and external link resolves |
+| `all` | `enact-wiki all [--strict]` | Full pipeline: `lint` → `build` → `check-links` → `export`; canonical ready-to-publish command after `/wiki-sync` |
+| `export` | `enact-wiki export` | Writes `llms.txt`, `llms-full.txt`, `search-index.json`, `sitemap.xml`, `rss.xml`, `robots.txt`, `ai-readme.md`, `manifest.json` |
+| `export-marp` | `enact-wiki export-marp . <topic> [--out ./marp/<deck>.md]` | Exports a Marp-compatible slide deck |
+| `export-obsidian` | `enact-wiki export-obsidian . --vault <ABSOLUTE_OBSIDIAN_VAULT_PATH> [--subfolder "Enact Wiki"]` | Recreates export subfolder on each run; exported pages include `## Source`; see `../../../../../enact-docs/05-operations/memory/obsidian-integration.md` |
+| `export-qmd` | `enact-wiki export-qmd . [--out ./qmd]` | Flat filenames: `<wikiDir>__<slug>.qmd`; rewrites target cleanly; see `../../../../../enact-docs/05-operations/memory/qmd-export.md` |
+| `doctor` | `enact-wiki doctor` | Health-checks the installation |
+| `adapters` | `enact-wiki adapters` | Shows which agent stores are wired and configured |
+| `mcp` | `enact-wiki mcp .` | Starts the MCP server on stdio; parity reference: `../../../../../enact-docs/04-contracts/memory/agent-surface-parity.md` |
+| `link-obsidian` | `enact-wiki link-obsidian . --vault <ABSOLUTE_OBSIDIAN_VAULT_PATH> [--subfolder "Enact Wiki"]` | Sets up Obsidian vault linking |
+| `watch` | `enact-wiki watch` | File-system watcher for auto-triggering sync/ingest |
+
+## Operational notes
+
+- `build --strict`, `lint --strict`, and `all --strict` treat info-severity lint findings as blocking or fatal depending on the command.
+- If `build` fails, run `enact-wiki lint` first, then `enact-wiki check-links`.
+- `lint` workflow: run `lint` → `check-links` → inspect `^## Contradictions` → check stale summaries → check missing entity pages → output grouped report → optionally save `wiki/lint-report.md`.
+- `serve` exposes `site/`; for LAN sharing, explicitly bind to `0.0.0.0` via `enact-wiki serve --help`.
+- Global flag: `--vault <path>` runs vault-aware commands against a specific vault root instead of cwd.
+- Sync-specific cross-reference: adapter filtering and workspace flags are documented in `references/ingest.md`.

package/extensions/enact-wiki/skills/enact-wiki/references/query.md

@@ -0,0 +1,59 @@
+---
+last_update: 2026-04-30T00:00:00+00:00
+---
+
+# Query — Retrieve and synthesise answers from the wiki
+
+## Query
+
+Answer a question by querying the wiki. Use when the user asks about their own past work or vaulted knowledge.
+
+```bash
+enact-wiki query --mode=search --top-k=8 --quiet "<question>"
+enact-wiki query --mode=answer --top-k=8 --quiet "<question>"
+```
+
+Workflow: read `wiki/index.md` + root `overview.md` → run CLI query for shortlist → read candidates → synthesise answer with `[[wikilink]]` citations → offer to save substantial answers to `wiki/syntheses/<slug>.md` → append `## [YYYY-MM-DD] query | <short question>`.
+
+Fallback: "I don't see anything about this in your wiki yet." → suggest `/wiki-sync` → offer general knowledge explicitly marked as such.
+
+Two modes:
+- `--mode=search` → ranked retrieval hits (paths). Use for debugging and bulk lookups.
+- `--mode=answer` → synthesised answer with citations. Use when the user expects a response.
+
+JSON for integrations: `enact-wiki query --mode=search --json "<question>"`
+
+Don't do: invent wiki pages · conflate general knowledge with wiki content · over-cite · write walls of text.
+
+## Search
+
+Simple BM25 keyword search:
+```bash
+enact-wiki search <term>
+```
+Use for quick ad-hoc lookups. For research with synthesis and citations, use `query --mode=answer`.
+
+## Read
+
+Read a wiki page directly:
+```bash
+enact-wiki read <slug-or-path>
+```
+
+## Graph
+
+Show wikilink neighbourhood for one page:
+```bash
+enact-wiki graph <slug>
+```
+Reports inbound links (which pages reference this page) and outbound links (what this page references). Broken edges → cross-check with `/wiki-lint`. Orphan (zero inbound) → suggest `/wiki-lint` for a wider report.
+
+## Reflect
+
+Read-only meta-pass over the whole wiki — look for patterns, gaps, and improvement opportunities:
+```bash
+/wiki-reflect [focus-area]
+```
+Optional focus: `patterns` · `gaps` · `quality` · `contradictions` · or omit for a general pass.
+
+Hard rules: don't edit pages during reflection (propose changes, get approval) · cite `[[wikilinks]]` for what the wiki says vs. your own interpretation · be specific ("47 Callebaut recipes, strong on ganache, zero on tempering" not "chocolate coverage is fine").

package/extensions/enact-wiki/skills/search-lab/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: search-lab
+description: Analyze search-lab benchmark artifacts and propose reviewable improvements to search quality, query expansion, wiki content, and configuration.
+---
+
+# search-lab
+
+Use when you have search-lab outputs to review: `agent-summary.md`, `analysis-report.json`, `proposals.json`, `benchmark.json`, or `.dossier.json` files.
+
+## Typical flow
+
+```bash
+enact-wiki search-lab benchmark
+enact-wiki search-lab export .enact/wiki/search-lab/runs/<timestamp>/
+enact-wiki search-lab analyze .enact/wiki/search-lab/runs/<timestamp>/
+```
+
+## Inputs
+
+- `agent-summary.md`
+- `analysis-report.json`
+- `proposals.json`
+- `benchmark.json`
+- one or more `.dossier.json` files
+
+## Outputs
+
+Produce concise, ranked proposals for:
+1. config tuning (`memory.toml` changes)
+2. query expansion improvements
+3. benchmark additions
+4. wiki/content/link improvements
+
+## Review frame
+
+For each issue, identify likely cause, then propose:
+- `type`: `config` | `expansion` | `benchmark` | `wiki`
+- `confidence`: 0-1
+- `effort`: `quick` | `medium` | `large`
+- `impact`: `high` | `medium` | `low`
+- `implementation`: concrete diff, TOML snippet, file path, or link suggestion
+
+Prioritize by: impact ↓, effort ↑, confidence ↓.
+
+## Agent rules
+
+- Prefer existing CLI-generated proposal artifacts when present; refine them instead of starting from scratch.
+- Read the benchmark/dossier artifacts first, then inspect current `memory.toml`.
+- Propose minimal, reviewable changes.
+- Do not auto-apply broad changes without review.
+
+## References
+
+- `src/lib/search-lab-types.ts`
+- `src/lib/search-lab.ts`
+- `src/cli/commands/search-lab.ts`
+- `../../../README.md`

package/extensions/enact-wiki/skills/search-lab/scripts/analyze.ts

@@ -0,0 +1,23 @@
+export interface SearchLabQuickSummary {
+  topIssues: string[]
+  recommendationCount: number
+}
+
+/**
+ * Minimal helper for future skill-side analysis wrappers.
+ * Kept intentionally small so the bootstrap skill can evolve
+ * without coupling itself tightly to engine internals.
+ */
+export function summarizeSearchLabIssues(issues: string[]): SearchLabQuickSummary {
+  const counts = new Map<string, number>()
+  for (const issue of issues) counts.set(issue, (counts.get(issue) ?? 0) + 1)
+  const topIssues = [...counts.entries()]
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, 5)
+    .map(([issue]) => issue)
+
+  return {
+    topIssues,
+    recommendationCount: topIssues.length,
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amsterdamdatalabs/enact-extensions",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Create and validate Enact multi-platform plugin manifests",
   "license": "UNLICENSED",
   "type": "module",