loop-engineer 0.7.0__tar.gz

loop_engineer-0.7.0/.claude-plugin/marketplace.json

@@ -0,0 +1,7 @@
+{
+  "name": "loop-engineer",
+  "owner": { "name": "SollanSystems", "url": "https://github.com/SollanSystems" },
+  "plugins": [
+    { "name": "loop-engineer", "source": "./", "description": "Agent-loop architect+operator skill suite — design, run, verify, repair, and improve agentic coding loops." }
+  ]
+}

loop_engineer-0.7.0/.claude-plugin/plugin.json

@@ -0,0 +1,24 @@
+{
+  "name": "loop-engineer",
+  "version": "0.7.0",
+  "description": "Design, launch, verify, repair, and improve agent loops. A Claude-Code-native architect+operator for long-running, verifiable, self-improving agentic-coding systems.",
+  "author": { "name": "Sollan Systems", "url": "https://github.com/SollanSystems" },
+  "homepage": "https://github.com/SollanSystems/loop-engineer",
+  "repository": "https://github.com/SollanSystems/loop-engineer",
+  "keywords": ["agent", "loop", "agentic", "verification", "harness", "orchestration", "self-improvement", "claude-code", "eval", "repair"],
+  "license": "MIT",
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 ${CLAUDE_PLUGIN_ROOT}/hooks/stop_firewall.py",
+            "timeout": 90
+          }
+        ]
+      }
+    ]
+  }
+}

loop_engineer-0.7.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug report
+about: A skill, the portable CLI, or a gate behaves incorrectly
+title: "bug: "
+labels: bug
+---
+
+## What happened
+
+<!-- The incorrect behavior. If a skill misbehaved, name it (e.g. loop-run). -->
+
+## Expected
+
+<!-- What you expected instead. -->
+
+## Reproduction
+
+<!-- Minimal steps. For the portable core, include the command, e.g.:
+     python3 -m loop doctor path/to/workspace -->
+
+## Environment
+
+- Loop Engineer version (`plugin.json` / git tag):
+- Claude Code version (if the plugin path):
+- Python version (`python3 --version`):
+- OS:
+
+## Gate output (if relevant)
+
+<!-- Paste output of the failing gate:
+     python3 scripts/self_eval.py  /  python3 -m pytest -q scripts -->

loop_engineer-0.7.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/SollanSystems/loop-engineer/security/advisories/new
+    about: Report security issues privately — please do not open a public issue.
+  - name: Question / discussion
+    url: https://github.com/SollanSystems/loop-engineer/discussions
+    about: Ask a question or discuss an idea before filing an issue.

loop_engineer-0.7.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,24 @@
+---
+name: Feature request
+about: Propose a new capability, skill, or contract element
+title: "feat: "
+labels: enhancement
+---
+
+## Problem
+
+<!-- The loop-engineering problem this would solve. What fails or is awkward today? -->
+
+## Proposed change
+
+<!-- Which spoke, reference doc, schema, or gate it touches. -->
+
+## Does it preserve the invariants?
+
+<!-- Loop Engineer keeps a few load-bearing properties. Note how your idea fits:
+     - typed termination (the 7 terminal states)
+     - deterministic gate before advisory rubric
+     - bring-your-own-verifier default (no hard dependency on unbundled tools)
+     - bounded, recorded repair -->
+
+## Alternatives considered

loop_engineer-0.7.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,20 @@
+<!-- Conventional-commit title, e.g. "fix(loop-run): ..." -->
+
+## What & why
+
+<!-- The change and the problem it solves. Link any issue (Closes #N). -->
+
+## Gates (must be green)
+
+- [ ] `python3 scripts/validate_frontmatter.py`
+- [ ] `python3 scripts/self_eval.py` (13/13)
+- [ ] `python3 -m pytest -q scripts`
+- [ ] `python3 -m py_compile loop/*.py scripts/*.py`
+- [ ] `python3 -m loop doctor examples/coverage-repair` still passes
+
+## Checklist
+
+- [ ] If a skill mentions an optional integration, it also names the bundled default path (BYO-default)
+- [ ] Any agent-dispatch code fence names an explicit `model:`
+- [ ] Added a test/eval case for any fixed bug
+- [ ] Updated `CHANGELOG.md` under `## Unreleased`

loop_engineer-0.7.0/.github/workflows/ci.yml

@@ -0,0 +1,82 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  gates:
+    name: gates (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install gate dependencies
+        run: python -m pip install --upgrade pip pyyaml pytest jsonschema
+
+      - name: Frontmatter gate
+        run: python -B scripts/validate_frontmatter.py
+
+      - name: Structural self-eval gate
+        run: python -B scripts/self_eval.py
+
+      - name: Test suite
+        run: python -B -m pytest -q -p no:cacheprovider scripts
+
+      - name: Compile portable core
+        run: python -B -m py_compile loop/*.py scripts/*.py
+
+      - name: Manifests and schemas are valid JSON
+        run: |
+          python -B -c "import json, glob; \
+          files = ['.claude-plugin/plugin.json', '.claude-plugin/marketplace.json'] \
+          + glob.glob('schemas/*.json') + glob.glob('evals/**/*.json', recursive=True); \
+          [json.load(open(f)) for f in files]; \
+          print(f'valid JSON: {len(files)} files')"
+
+      - name: Quickstart smoke test
+        run: |
+          python -B -m loop doctor examples/coverage-repair
+          python -B -m loop inspect examples/coverage-repair
+
+  recipe-langgraph:
+    name: recipe (langgraph)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install recipe dependencies
+        run: python -m pip install --upgrade pip pyyaml pytest jsonschema langgraph
+      - name: LangGraph recipe end-to-end
+        run: python -B -m pytest -q -p no:cacheprovider scripts/test_langgraph_recipe.py
+
+  action-dogfood:
+    name: action (dogfood on flagship example)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      # The repo root's live .loop/ is gitignored, so it does not exist in a fresh
+      # CI checkout — the tracked flagship example is the contract the action gates
+      # (doctor-clean, inspect 90/strong in the action's dependency-free install).
+      - uses: ./
+        with:
+          path: "examples/coverage-repair"
+          fail-under-score: "90"
+
+      - name: pre-commit consumer fixture
+        # bare `python` is on PATH here because the preceding `uses: ./` composite step ran setup-python
+        # (persisted via GITHUB_PATH) — keep the action step before this one.
+        run: |
+          python -m pip install --quiet pre-commit pytest pyyaml
+          python -B -m pytest -q -p no:cacheprovider scripts/test_precommit_hook.py

loop_engineer-0.7.0/.github/workflows/publish.yml

@@ -0,0 +1,58 @@
+name: publish
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Tag matches pyproject version
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          version="$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          if [ "$tag" != "$version" ]; then
+            echo "tag v$tag != pyproject version $version" >&2
+            exit 1
+          fi
+
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+
+      - name: Smoke-test the wheel from a temp dir
+        run: |
+          python -m venv /tmp/smoke
+          /tmp/smoke/bin/pip install --no-index dist/*.whl
+          cd /tmp
+          /tmp/smoke/bin/loop-engineer --version
+          /tmp/smoke/bin/loop scaffold /tmp/smoke-loop
+          /tmp/smoke/bin/loop doctor /tmp/smoke-loop
+          /tmp/smoke/bin/loop inspect /tmp/smoke-loop || true
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

loop_engineer-0.7.0/.gitignore

@@ -0,0 +1,35 @@
+# Ephemeral workbench
+.tmp/
+
+# Loop run telemetry (operating-contract state for the self-improvement run; not plugin content)
+.loop/
+
+# Machine-local Claude Code config + GSD audit telemetry (not plugin content)
+.claude/
+.gsd/
+
+# Local session memory / private build narrative (not plugin content)
+memory/
+
+# Workbench dirs (review scratch + roadmap drafts; not plugin content)
+review/
+roadmap/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+.pytest_cache/
+# uv resolution lock — the core declares no required runtime deps; CI uses pip, not `uv sync`
+uv.lock
+
+# Node
+node_modules/
+
+# OS / editor
+.DS_Store
+Thumbs.db
+
+# Secrets — never commit
+.env
+*.local

loop_engineer-0.7.0/.pre-commit-hooks.yaml

@@ -0,0 +1,11 @@
+- id: loop-doctor
+  name: loop doctor (loop-contract validity gate)
+  description: "Validate the repo's .loop/ contract objects; fails on a dishonest or malformed contract."
+  entry: loop doctor .
+  language: python
+  # The CLI default is pure-stdlib structural validation; the gate surface runs
+  # the strict path. pre-commit installs these into the hook's isolated env so
+  # loop/contract.py takes the jsonschema branch and PyYAML parses the manifest.
+  additional_dependencies: ["jsonschema>=4", "pyyaml>=6"]
+  pass_filenames: false
+  always_run: true