@amsterdamdatalabs/enact-extensions 0.1.37 → 0.1.47

package/extensions/enact-context/skills/enact-context/scripts/install.sh

@@ -1,69 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-INSTALL_DIR="${HOME}/.local/bin"
-
-already_installed() {
-    command -v enact-context >/dev/null 2>&1
-}
-
-detect_platform() {
-    local os arch
-    os="$(uname -s)"
-    arch="$(uname -m)"
-
-    case "$os" in
-        Darwin) os="apple-darwin" ;;
-        Linux)  os="unknown-linux-musl" ;;
-        *)      echo "ERROR: unsupported OS: $os" >&2; exit 1 ;;
-    esac
-
-    case "$arch" in
-        x86_64|amd64)   arch="x86_64" ;;
-        arm64|aarch64)  arch="aarch64" ;;
-        *)              echo "ERROR: unsupported arch: $arch" >&2; exit 1 ;;
-    esac
-
-    echo "${arch}-${os}"
-}
-
-install_binary() {
-    local platform="$1"
-    echo "Installing enact-context for ${platform} via the Amsterdam Data Labs installer..."
-    curl -fsSL "https://amsterdamdatalabs.com/install.sh" | sh
-}
-
-ensure_path() {
-    case ":${PATH}:" in
-        *":${INSTALL_DIR}:"*) ;;
-        *) export PATH="${INSTALL_DIR}:${PATH}"
-           echo "Added ${INSTALL_DIR} to PATH for this session."
-           echo "Add to your shell profile: export PATH=\"${INSTALL_DIR}:\$PATH\""
-           ;;
-    esac
-}
-
-print_registration_note() {
-    echo "Runtime install complete."
-    echo "Register hosts through the plugin system, for example:"
-    echo "  enact-extensions install enact-context --platform codex"
-    echo "Do not use 'enact-context setup' or 'doctor --fix' for Codex registration."
-}
-
-main() {
-    if already_installed; then
-        local current
-        current="$(enact-context --version 2>/dev/null | head -1 || echo 'unknown')"
-        echo "enact-context already installed: ${current}"
-        print_registration_note
-        exit 0
-    fi
-
-    local platform
-    platform="$(detect_platform)"
-    install_binary "$platform"
-    ensure_path
-    print_registration_note
-}
-
-main "$@"

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

@@ -1,40 +0,0 @@
-{
-  "name": "enact-core",
-  "version": "0.1.0",
-  "description": "Core first-party plugin for enact-extensions: ships the generic UserPromptSubmit keyword-router hook that routes user prompts to relevant skills discovered across all installed plugins.",
-  "author": {
-    "name": "amsterdamdatalabs"
-  },
-  "homepage": "https://amsterdamdatalabs.com",
-  "repository": "https://dev.azure.com/amsterdamdatalabs/Enact/_git/enact-extensions",
-  "license": "UNLICENSED",
-  "keywords": [
-    "enact",
-    "core",
-    "keyword-router",
-    "ups-router",
-    "hooks"
-  ],
-  "targets": [
-    "claude",
-    "codex",
-    "cursor",
-    "enact"
-  ],
-  "hooks": "./hooks/hooks.json",
-  "interface": {
-    "displayName": "Enact Core",
-    "shortDescription": "Generic keyword-router hook: routes user prompts to relevant skills.",
-    "developerName": "Amsterdam Data Labs",
-    "category": "Developer Tools",
-    "capabilities": [
-      "UserPromptSubmit keyword routing",
-      "plugin-agnostic skill discovery",
-      "additionalContext injection"
-    ]
-  },
-  "factory": {
-    "firstParty": true,
-    "operatorScope": "global"
-  }
-}

package/extensions/enact-core/OPERATING-PRINCIPLES.md

@@ -1,7 +0,0 @@
-<!-- enact-core:operating-principles START -->
-1. No fallback / no silent degrade — if the real path fails, fail loud and stop.
-2. No silent drops — no `|| true`, no swallowed errors, no skipped gates.
-3. No fakes — no stubs, placeholders, or TODOs passed off as done.
-4. Truthful or stop — report status honestly; a stopped task beats a fake-green one.
-5. Out-of-scope work → a new WorkItem, never silent scope-creep.
-<!-- enact-core:operating-principles END -->

package/extensions/enact-core/hooks/hooks.json

@@ -1,26 +0,0 @@
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "startup|resume",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "enact-extensions hook session-start",
-            "statusMessage": "Checking plugin freshness"
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "enact-extensions hook user-prompt-submit"
-          }
-        ]
-      }
-    ]
-  }
-}

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

@@ -1,47 +0,0 @@
-{
-  "name": "enact-evolve",
-  "version": "0.1.0",
-  "description": "Session evidence analysis plugin for enact-evolve ingestion, evaluation, and synthesis workflows.",
-  "author": {
-    "name": "Amsterdam Data Labs"
-  },
-  "homepage": "https://amsterdamdatalabs.com",
-  "repository": "https://dev.azure.com/amsterdamdatalabs/Enact/_git/enact-extensions",
-  "license": "UNLICENSED",
-  "keywords": [
-    "enact-evolve",
-    "session-analysis",
-    "transcripts",
-    "evidence",
-    "evaluation",
-    "synthesis"
-  ],
-  "targets": [
-    "claude",
-    "codex",
-    "cursor",
-    "enact"
-  ],
-  "skills": "./skills/",
-  "agents": "./agents/",
-  "interface": {
-    "displayName": "Enact Evolve",
-    "shortDescription": "CLI-backed session evidence ingestion, evaluation, and synthesis workflows.",
-    "longDescription": "Install this plugin to make enact-evolve the default path for Codex, Claude, and Factory session forensics: ingest transcripts, evaluate normalized evidence, and synthesize human-readable findings without running promotion.",
-    "developerName": "Amsterdam Data Labs",
-    "category": "Developer Tools",
-    "composerIcon": "./assets/icon.png",
-    "logo": "./assets/logo.png",
-    "capabilities": [
-      "session transcript ingestion",
-      "evidence evaluation",
-      "forensics synthesis",
-      "candidate improvement review",
-      "context usage analysis"
-    ]
-  },
-  "factory": {
-    "firstParty": true,
-    "operatorScope": "global"
-  }
-}

package/extensions/enact-evolve/agents/evolve-session-analyst.toml

@@ -1,37 +0,0 @@
-name = "evolve-session-analyst"
-desc = "Session forensics agent that must run enact-evolve ingest/evaluate before synthesis"
-model = "gpt-5.5"
-claude_model = "opus"
-cursor_model = "default"
-model_reasoning_effort = "medium"
-sandbox_mode = "danger-full-access"
-developer_instructions = """
-Agent definition: enact-evolve session forensics analyst.
-
-Use this agent when a user asks to analyze a Codex, Claude, or Factory session transcript, rollout JSONL, hook/tool behavior, context injection, token/context burn, or why an agent did not use the expected evolve workflow.
-
-Core rules:
-- Use enact-evolve artifacts as primary truth.
-- Start with the session-analysis skill workflow and run the bundled run-evolve-analysis.sh helper unless the user explicitly provides already-generated evidence and eval artifacts.
-- Run enact-evolve ingest and enact-evolve evaluate before synthesizing findings.
-- Never run enact-evolve promote.
-- Do not create downstream Dream, wiki, extension, package patch, or promotion handoff artifacts.
-- Treat the current working directory as the project/workspace storage anchor, matching Enact plugin and MCP `mcp .` conventions.
-- Use raw transcript JSONL only as a clearly labeled cross-check for details not yet normalized by enact-evolve, such as exact MCP server/tool pairs or hook execution gaps.
-- If normalized evidence has an empty hook_summary or hook_timeline, report that as an evidence limitation instead of claiming hooks did not fire.
-- Prefer absolute artifact paths in the final report.
-
-Analysis process:
-1. Identify surface and session source.
-2. Produce or locate session-specific evidence output.
-3. Read session-evidence.jsonl, eval/metrics.jsonl, eval/candidate-improvements.jsonl, eval/trace-events.jsonl, and the transcript markdown.
-4. Cross-check raw transcript only for missing normalized fields requested by the user.
-5. Synthesize a concise report covering identity, pipeline proof, tool/MCP behavior, hook evidence, context injection, token/context usage, candidates, and actionable findings.
-
-Output contract:
-- evidence_artifacts
-- normalized_findings
-- raw_cross_checks
-- synthesis
-- follow_up_recommendations
-"""

package/extensions/enact-evolve/skills/mined-investigate-loop/SKILL.md

@@ -1,68 +0,0 @@
----
-name: mined-investigate-loop
-description: >-
-  Auto-mined procedure (enact-evolve P4 procedural tier). Before editing
-  unfamiliar code, run an investigate loop: read a file, grep to locate the
-  related symbol/usage, then read the located target — read → grep → read —
-  before making changes. Mined from 251 real Claude+Codex sessions; sessions
-  that ran this loop succeeded at 58.3% vs a 43.0% baseline (+15pp). Use when
-  navigating unfamiliar code, locating a definition/usage, or scoping a change
-  before editing. Trigger keywords: investigate, locate, find usages, where is,
-  scope a change, read before edit, navigate code.
----
-
-# mined-investigate-loop (read → grep → read)
-
-> **Provenance — machine-mined, pending human graduation (Track B G2).** This
-> skill was produced by the enact-evolve procedural tier's execution-mining →
-> graduation path over real session history. It is under review; do not treat it
-> as hand-authored guidance until merged.
-
-## The procedure
-
-When you are about to change code you don't already hold in context, **investigate
-before you act**:
-
-1. **read** — open the entry file you were handed (the symbol, the failing test,
-   the reported file).
-2. **grep** — search the repo for the related symbol / call site / definition you
-   now know to look for (don't guess the path; locate it).
-3. **read** — open the located target and confirm the real shape before editing.
-
-Only then edit. The loop may repeat (read → grep → read → grep → …) until the
-change is fully scoped.
-
-## When to use
-
-- Navigating unfamiliar code or a new package.
-- Locating a definition, its usages, or the blast radius of a change.
-- Scoping an edit before making it (especially across files).
-
-## When NOT to use
-
-- You already have the target file and its dependencies in context — skip
-  straight to the edit.
-- Pure debugging-thrash (grep → stream-edit → grep with no reads) is an
-  **anti-pattern** the miner explicitly rejected (see Evidence) — investigate by
-  reading, don't blind-edit-and-re-grep.
-
-## Evidence (why this graduated)
-
-Mined by `enact-evolve/eval/mine-procedures.mjs` over real session transcripts
-(the existing Claude + Codex adapters → `SessionEvidence.tool_timeline`):
-
-| field | value |
-|---|---|
-| corpus | 251 sessions (205 Claude + 46 Codex) |
-| baseline zero-failure rate | 0.430 |
-| this procedure (read → grep → read) | **60 sessions, 35 success → 0.583** |
-| lift over baseline | **+0.153 (×1.36)** |
-| graduation policy | rate ≥ 1.25× baseline, support ≥ 8, success ≥ 4 |
-
-Reward signal: a session "succeeds" when it records zero failed tool/hook/watchdog
-events (`SessionEvidence.failures` empty). Graduation is **lift-based** because the
-absolute zero-failure base rate is low; frequency alone is rejected — the
-highest-frequency pattern `rg → sed → rg` (debugging thrash) scored 2/13 (0.15)
-and did **not** graduate.
-
-Full artifact: `enact-evolve/eval/P4-mined-procedures.json`.

package/extensions/enact-evolve/skills/session-analysis/SKILL.md

@@ -1,98 +0,0 @@
----
-name: session-analysis
-description: This skill should be used when the user asks to analyze, audit, evaluate, or synthesize Codex, Claude, or Factory session transcripts, rollout JSONL files, tool/MCP call behavior, hook evidence, context injection, token usage, or candidate improvements with enact-evolve. It must run enact-evolve ingest and evaluate before drawing conclusions and must not run promotion.
-argument-hint: "--surface <codex|claude|factory> --session <path-or-id> [--watchdog <path>] [--out <dir>]"
----
-
-# Enact Evolve Session Analysis
-
-Use this workflow for session forensics. The purpose is to force the product path first: `enact-evolve ingest` then `enact-evolve evaluate`, then synthesis from generated artifacts.
-
-## Non-Negotiables
-
-- Use `enact-evolve` CLI artifacts as primary truth.
-- Never run `enact-evolve promote`.
-- Do not create Dream, wiki, extension, package patch, or promotion handoff artifacts.
-- Do not rely on raw JSONL parsing until after ingest/evaluate has run.
-- Label every raw transcript lookup as a cross-check, not primary evidence.
-- If `hook_summary` or `hook_timeline` is empty, say the normalized evidence did not capture hook firings; do not infer that hooks did not fire.
-
-## Inputs
-
-Accept the same arguments as the helper script:
-
-```bash
-${CLAUDE_PLUGIN_ROOT}/skills/session-analysis/scripts/run-evolve-analysis.sh \
-  --surface codex \
-  --session /path/to/session.jsonl
-```
-
-Required:
-- `--surface codex|claude|factory`
-- `--session <path-or-id>`
-
-Optional:
-- `--watchdog <path>`
-- `--out <dir>`
-
-Default output:
-`~/.enact/evolve/projects/<workspace-id>/analysis/<surface>-<safe-session-id>/`
-
-The helper resolves `<workspace-id>` from the current working directory by calling `enact-evolve storage --json`, matching the cwd-bound `mcp .` pattern used by other Enact plugins. Pass `--out` only when an explicit non-default location is required.
-
-## Workflow
-
-1. Resolve the session source and surface.
-   - Use `codex` for files under `.codex/sessions` or rollout JSONL.
-   - Use `claude` for Claude transcript JSONL.
-   - Use `factory` only for supported factory scenarios.
-   - Treat the current working directory as the owning workspace for storage.
-
-2. Run the helper script.
-   - Prefer the bundled script over handwritten CLI command sequences.
-   - The script verifies `enact-evolve`, resolves project-scoped analysis storage from cwd, writes session-specific artifacts, and refuses to continue if promotion artifacts are produced.
-
-3. Read these generated artifacts:
-   - `session-evidence.jsonl`
-   - `metrics.jsonl`
-   - `candidate-improvements.jsonl`
-   - `trace-events.jsonl`
-   - `eval/session-evidence.jsonl`
-   - `eval/metrics.jsonl`
-   - `eval/candidate-improvements.jsonl`
-   - `eval/trace-events.jsonl`
-   - `<session-id>.md`
-   - `synthesis.md`
-
-4. Synthesize from normalized evidence first.
-   - Use `tool_summary`, `tool_timeline`, `hook_summary`, `hook_timeline`, `context_summary`, `system_prompts`, `quality_metrics`, and `candidate_improvements`.
-   - Prefer the transcript markdown for readable chronology and context.
-   - Use raw JSONL only for fields that are not yet represented in normalized evidence, such as exact MCP `server/tool` pairs.
-
-5. Report limitations.
-   - Empty hook summaries mean "not normalized/captured as hook events in evidence", not "did not happen."
-   - Missing prompt counts or context entries should be called out as evidence-shape limitations.
-   - If the helper fails because `enact-evolve` is missing, report the install/runtime issue before attempting manual analysis.
-
-## Required Synthesis Shape
-
-Return or update `synthesis.md` with these sections:
-
-- `Session Identity`: surface, session id, source path, evidence id, output paths.
-- `Pipeline Proof`: exact ingest/evaluate commands and generated artifact list.
-- `Tool And MCP Analysis`: normalized tool summary first; raw MCP cross-check only if needed.
-- `Hook Evidence`: hook timeline/summary and any explicit evidence limitation.
-- `Context Injection`: system/developer/context entries, token usage, duplicate context, largest context blocks.
-- `Candidate Summary`: counts by target family, notable source signals, extension-skill/rule/tool-description implications.
-- `Findings`: what happened, what went wrong, and what the assistant should have done.
-- `Follow-Up Recommendations`: implementation or workflow changes, explicitly excluding promotion unless the user separately requests it.
-
-## Verification
-
-After running the helper, verify:
-- `session-evidence.jsonl` exists and has at least one record.
-- `eval/metrics.jsonl` exists.
-- `eval/candidate-improvements.jsonl` exists, even if empty.
-- Transcript markdown exists.
-- `synthesis.md` exists.
-- No `promote/` directory exists under the output directory.